From 7bf0984698e43b9aa2dd879f65951318ed410390 Mon Sep 17 00:00:00 2001
From: Maze <167211895+mazeincoding@users.noreply.github.com>
Date: Sat, 31 Jan 2026 00:20:04 +0100
Subject: codebase overhaul (#697)

---
 apps/web/src/hooks/actions/use-action-handler.ts | 52 ++++++++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 apps/web/src/hooks/actions/use-action-handler.ts

(limited to 'apps/web/src/hooks/actions/use-action-handler.ts')

diff --git a/apps/web/src/hooks/actions/use-action-handler.ts b/apps/web/src/hooks/actions/use-action-handler.ts
new file mode 100644
index 00000000..3f6dbd21
--- /dev/null
+++ b/apps/web/src/hooks/actions/use-action-handler.ts
@@ -0,0 +1,52 @@
+import { useCallback, useEffect, useRef } from "react";
+import type {
+	TAction,
+	TActionFunc,
+	TActionHandlerOptions,
+	TArgOfAction,
+	TInvocationTrigger,
+} from "@/lib/actions";
+import { bindAction, unbindAction } from "@/lib/actions";
+
+export function useActionHandler<A extends TAction>(
+	action: A,
+	handler: TActionFunc<A>,
+	isActive: TActionHandlerOptions,
+) {
+	const handlerRef = useRef<TActionFunc<A>>(handler);
+	const isBoundRef = useRef(false);
+
+	useEffect(() => {
+		handlerRef.current = handler;
+	}, [handler]);
+
+	const stableHandler = useCallback(
+		(...parameters: [TArgOfAction<A>, TInvocationTrigger?]) => {
+			(
+				handlerRef.current as (
+					...handlerParameters: [TArgOfAction<A>, TInvocationTrigger?]
+				) => void
+			)(...parameters);
+		},
+		[],
+	) as TActionFunc<A>;
+
+	useEffect(() => {
+		const shouldBind =
+			isActive === undefined ||
+			(typeof isActive === "boolean" ? isActive : isActive.current);
+
+		if (shouldBind && !isBoundRef.current) {
+			bindAction(action, stableHandler);
+			isBoundRef.current = true;
+		} else if (!shouldBind && isBoundRef.current) {
+			unbindAction(action, stableHandler);
+			isBoundRef.current = false;
+		}
+
+		return () => {
+			unbindAction(action, stableHandler);
+			isBoundRef.current = false;
+		};
+	}, [action, stableHandler, isActive]);
+}
-- 
cgit v1.3.1