🚩 (flags) create run once hooks

A custom React hook that ensures a function is executed only once  across the entire application, even in React Strict
Mode or during development hot reloads. Maintains a global registry to track execution status using a unique key.

shared/hooks/useRunOnce.ts

@@ -1,36 +1,18 @@
+"use client";
 import { useEffect, useRef } from "react";
 
-/**
- * @module useRunOnce
- * @description A custom React hook that ensures a callback function is executed only once
- * during the component's lifecycle, even in React Strict Mode or development with hot reloading.
- *
- * @param {() => void | Promise<void>} callback - The function to execute once. Can be synchronous or asynchronous.
- * @returns {void}
- *
- * @example
- * // Synchronous usage
- * useRunOnce(() => {
- *   console.log('This runs only once');
- *   initializeSomething();
- * });
- *
- * @example
- * // Asynchronous usage
- * useRunOnce(async () => {
- *   const data = await fetchData();
- *   setInitialData(data);
- * });
- */
-const useRunOnce = (callback: () => void | Promise<void>) => {
-  const calledRef = useRef(false);
+const registry = new Set<string>();
+
+export function useRunOnce(key: string, fn: () => void) {
+  const hasRun = useRef(false);
 
   useEffect(() => {
-    if (calledRef.current) return;
-    calledRef.current = true;
+    if (hasRun.current) return;
+    hasRun.current = true;
 
-    void callback();
-  }, [callback]);
-};
+    if (registry.has(key)) return;
+    registry.add(key);
 
-export default useRunOnce;
+    fn();
+  }, [key, fn]);
+}