pi-kiosk-shared 2.1.86 → 2.1.87

package/dist/hooks/databaseHealthCoordinator.js

@@ -0,0 +1,371 @@
+/**
+ * Singleton /health poller — one schedule per endpoint per browser profile.
+ *
+ * Best practices:
+ * - Cross-tab leader via Web Locks (fallback: in-process mutex only)
+ * - Pause automatic polls while document is hidden
+ * - 429 = rate-limited (keep last known DB state; backoff via Retry-After)
+ * - Real outages (5xx / unhealthy JSON / network) use exponential backoff
+ * - No overlapping in-flight requests
+ */
+import { createCrossTabBus } from '../crossTab/CrossTabBus.js';
+const DEFAULT_HEALTHY_POLL_MS = 120_000;
+const MIN_AUTO_INTERVAL_MS = 60_000;
+const UNHEALTHY_BACKOFF_START_MS = 60_000;
+const UNHEALTHY_BACKOFF_MAX_MS = 300_000;
+const LOCK_STALE_MS = 15_000;
+const endpoints = new Map();
+const healthBus = createCrossTabBus({
+    channelName: 'rpapp-database-health',
+});
+healthBus.subscribe((message) => {
+    if (message.type === 'health-update') {
+        applyRemoteResult(message.endpoint, message.available, message.errorMessage, message.checkedAt);
+    }
+});
+function emptySnapshot() {
+    return {
+        isDatabaseAvailable: true,
+        isChecking: false,
+        retryCount: 0,
+        nextRetryDelay: 0,
+        error: null,
+    };
+}
+function getOrCreateState(endpoint) {
+    const existing = endpoints.get(endpoint);
+    if (existing) {
+        return existing;
+    }
+    const created = {
+        endpoint,
+        subscribers: new Set(),
+        snapshot: emptySnapshot(),
+        enabled: false,
+        pollIntervalMs: DEFAULT_HEALTHY_POLL_MS,
+        maxRetries: 5,
+        pollTimer: null,
+        leaderAbort: null,
+        inFlight: false,
+        lastCheckAt: 0,
+        unhealthyBackoffMs: UNHEALTHY_BACKOFF_START_MS,
+        retryCount: 0,
+    };
+    endpoints.set(endpoint, created);
+    return created;
+}
+function notify(state) {
+    for (const listener of state.subscribers) {
+        listener(state.snapshot);
+    }
+}
+function patchSnapshot(state, patch) {
+    state.snapshot = { ...state.snapshot, ...patch };
+    notify(state);
+}
+function applyRemoteResult(endpoint, available, errorMessage, checkedAt) {
+    const state = endpoints.get(endpoint);
+    if (!state) {
+        return;
+    }
+    state.lastCheckAt = checkedAt;
+    patchSnapshot(state, {
+        isDatabaseAvailable: available,
+        isChecking: false,
+        error: errorMessage ? new Error(errorMessage) : null,
+        retryCount: available ? 0 : state.retryCount,
+        nextRetryDelay: available ? 0 : state.snapshot.nextRetryDelay,
+    });
+    if (available) {
+        state.retryCount = 0;
+        state.unhealthyBackoffMs = UNHEALTHY_BACKOFF_START_MS;
+    }
+}
+function parseRetryAfterMs(response) {
+    const retryAfter = response.headers.get('retry-after');
+    if (retryAfter) {
+        const seconds = Number(retryAfter);
+        if (Number.isFinite(seconds) && seconds >= 0) {
+            return Math.max(seconds * 1000, MIN_AUTO_INTERVAL_MS);
+        }
+        const dateMs = Date.parse(retryAfter);
+        if (!Number.isNaN(dateMs)) {
+            return Math.max(dateMs - Date.now(), MIN_AUTO_INTERVAL_MS);
+        }
+    }
+    const reset = response.headers.get('ratelimit-reset');
+    if (reset) {
+        const resetSeconds = Number(reset);
+        if (Number.isFinite(resetSeconds) && resetSeconds >= 0) {
+            return Math.max(resetSeconds * 1000, MIN_AUTO_INTERVAL_MS);
+        }
+    }
+    return null;
+}
+function isDocumentHidden() {
+    return typeof document !== 'undefined' && document.visibilityState === 'hidden';
+}
+function clearPollTimer(state) {
+    if (state.pollTimer !== null) {
+        clearTimeout(state.pollTimer);
+        state.pollTimer = null;
+    }
+}
+function scheduleNextPoll(state, delayMs) {
+    clearPollTimer(state);
+    if (!state.enabled || state.subscribers.size === 0) {
+        return;
+    }
+    const delay = Math.max(delayMs, MIN_AUTO_INTERVAL_MS);
+    patchSnapshot(state, { nextRetryDelay: delay });
+    state.pollTimer = setTimeout(() => {
+        void performHealthFetch(state);
+    }, delay);
+}
+async function performHealthFetch(state) {
+    if (state.inFlight) {
+        return;
+    }
+    const now = Date.now();
+    if (now - state.lastCheckAt < MIN_AUTO_INTERVAL_MS) {
+        return;
+    }
+    if (isDocumentHidden()) {
+        scheduleNextPoll(state, state.pollIntervalMs);
+        return;
+    }
+    state.inFlight = true;
+    patchSnapshot(state, { isChecking: true, error: null });
+    healthBus.publish({ type: 'health-checking', endpoint: state.endpoint });
+    try {
+        const response = await fetch(state.endpoint, {
+            method: 'GET',
+            headers: { Accept: 'application/json' },
+            cache: 'no-store',
+        });
+        if (response.status === 429) {
+            const retryMs = parseRetryAfterMs(response) ?? state.pollIntervalMs;
+            state.lastCheckAt = Date.now();
+            patchSnapshot(state, {
+                isChecking: false,
+                error: new Error('Health check rate-limited; backing off'),
+            });
+            scheduleNextPoll(state, retryMs);
+            return;
+        }
+        if (!response.ok) {
+            throw new Error(`Health check failed: ${response.status} ${response.statusText}`);
+        }
+        const contentType = response.headers.get('content-type');
+        if (!contentType?.includes('application/json')) {
+            throw new Error(`Invalid response: expected JSON, got ${contentType ?? 'unknown'}`);
+        }
+        const data = (await response.json());
+        if (data.success !== true) {
+            throw new Error('Database reported unhealthy status');
+        }
+        state.lastCheckAt = Date.now();
+        state.retryCount = 0;
+        state.unhealthyBackoffMs = UNHEALTHY_BACKOFF_START_MS;
+        patchSnapshot(state, {
+            isDatabaseAvailable: true,
+            isChecking: false,
+            retryCount: 0,
+            nextRetryDelay: 0,
+            error: null,
+        });
+        healthBus.publish({
+            type: 'health-update',
+            endpoint: state.endpoint,
+            available: true,
+            checkedAt: state.lastCheckAt,
+            errorMessage: null,
+        });
+        scheduleNextPoll(state, state.pollIntervalMs);
+    }
+    catch (err) {
+        const error = err instanceof Error ? err : new Error('Health check failed');
+        state.lastCheckAt = Date.now();
+        state.retryCount += 1;
+        const nextBackoff = Math.min(state.unhealthyBackoffMs * 2, UNHEALTHY_BACKOFF_MAX_MS);
+        state.unhealthyBackoffMs = nextBackoff;
+        const delayMs = state.retryCount >= state.maxRetries
+            ? Math.max(state.pollIntervalMs, nextBackoff)
+            : Math.max(nextBackoff, MIN_AUTO_INTERVAL_MS);
+        patchSnapshot(state, {
+            isDatabaseAvailable: false,
+            isChecking: false,
+            retryCount: state.retryCount,
+            nextRetryDelay: delayMs,
+            error,
+        });
+        healthBus.publish({
+            type: 'health-update',
+            endpoint: state.endpoint,
+            available: false,
+            checkedAt: state.lastCheckAt,
+            errorMessage: error.message,
+        });
+        scheduleNextPoll(state, delayMs);
+    }
+    finally {
+        state.inFlight = false;
+    }
+}
+async function leaderLoop(state, signal) {
+    while (!signal.aborted && state.enabled && state.subscribers.size > 0) {
+        if (!isDocumentHidden()) {
+            await performHealthFetch(state);
+        }
+        else {
+            scheduleNextPoll(state, state.pollIntervalMs);
+        }
+        await new Promise((resolve) => {
+            const onAbort = () => {
+                signal.removeEventListener('abort', onAbort);
+                resolve();
+            };
+            signal.addEventListener('abort', onAbort);
+            if (signal.aborted) {
+                onAbort();
+            }
+        });
+        if (state.pollTimer !== null) {
+            await new Promise((resolve) => {
+                const timer = state.pollTimer;
+                if (timer === null) {
+                    resolve();
+                    return;
+                }
+                const check = () => {
+                    if (state.pollTimer !== timer) {
+                        resolve();
+                    }
+                };
+                const interval = setInterval(check, 250);
+                const timeout = setTimeout(() => {
+                    clearInterval(interval);
+                    resolve();
+                }, state.snapshot.nextRetryDelay + LOCK_STALE_MS);
+                void timeout;
+            });
+        }
+    }
+}
+function stopLeader(state) {
+    clearPollTimer(state);
+    state.leaderAbort?.abort();
+    state.leaderAbort = null;
+}
+function startLeader(state) {
+    if (state.leaderAbort) {
+        return;
+    }
+    const abort = new AbortController();
+    state.leaderAbort = abort;
+    const run = async () => {
+        if (typeof navigator !== 'undefined' && 'locks' in navigator && navigator.locks) {
+            try {
+                await navigator.locks.request(`rpapp-database-health:${state.endpoint}`, { signal: abort.signal }, async () => {
+                    await leaderLoop(state, abort.signal);
+                });
+            }
+            catch {
+                if (!abort.signal.aborted) {
+                    await leaderLoop(state, abort.signal);
+                }
+            }
+        }
+        else {
+            await leaderLoop(state, abort.signal);
+        }
+        state.leaderAbort = null;
+    };
+    void run();
+}
+function onVisibilityChange(endpoint) {
+    const state = endpoints.get(endpoint);
+    if (!state || !state.enabled) {
+        return;
+    }
+    if (!isDocumentHidden()) {
+        void performHealthFetch(state);
+    }
+}
+const visibilityHandlers = new Map();
+function ensureVisibilityListener(endpoint) {
+    if (typeof document === 'undefined' || visibilityHandlers.has(endpoint)) {
+        return;
+    }
+    const handler = () => {
+        onVisibilityChange(endpoint);
+    };
+    visibilityHandlers.set(endpoint, handler);
+    document.addEventListener('visibilitychange', handler);
+}
+function removeVisibilityListener(endpoint) {
+    const handler = visibilityHandlers.get(endpoint);
+    if (!handler || typeof document === 'undefined') {
+        return;
+    }
+    document.removeEventListener('visibilitychange', handler);
+    visibilityHandlers.delete(endpoint);
+}
+export function subscribeDatabaseHealth(input, listener) {
+    const state = getOrCreateState(input.endpoint);
+    state.enabled = input.enabled ?? true;
+    state.pollIntervalMs = input.pollInterval ?? DEFAULT_HEALTHY_POLL_MS;
+    state.maxRetries = input.maxRetries ?? 5;
+    state.subscribers.add(listener);
+    listener(state.snapshot);
+    ensureVisibilityListener(input.endpoint);
+    if (state.subscribers.size === 1 && state.enabled) {
+        startLeader(state);
+        void performHealthFetch(state);
+    }
+    return () => {
+        state.subscribers.delete(listener);
+        if (state.subscribers.size === 0) {
+            state.enabled = false;
+            stopLeader(state);
+            endpoints.delete(input.endpoint);
+            removeVisibilityListener(input.endpoint);
+        }
+    };
+}
+export async function requestDatabaseHealthCheck(endpoint, options) {
+    const state = endpoints.get(endpoint);
+    if (!state) {
+        return;
+    }
+    if (!options?.force && Date.now() - state.lastCheckAt < MIN_AUTO_INTERVAL_MS) {
+        return;
+    }
+    await performHealthFetch(state);
+}
+export function resolveDatabaseHealthEndpoint() {
+    if (typeof window === 'undefined') {
+        return 'http://localhost:3015/health';
+    }
+    const windowConfig = window.__RUNTIME_CONFIG__;
+    const apiUrl = windowConfig?.apiUrl?.trim();
+    if (apiUrl) {
+        try {
+            return `${new URL(apiUrl).origin}/health`;
+        }
+        catch {
+            return `${apiUrl.replace(/\/+$/, '')}/health`;
+        }
+    }
+    return `${window.location.origin}/health`;
+}
+/** Test-only reset */
+export function resetDatabaseHealthCoordinatorForTests() {
+    for (const state of endpoints.values()) {
+        stopLeader(state);
+        removeVisibilityListener(state.endpoint);
+    }
+    endpoints.clear();
+    healthBus.close();
+}
+//# sourceMappingURL=databaseHealthCoordinator.js.map

package/dist/hooks/databaseHealthCoordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"databaseHealthCoordinator.js","sourceRoot":"","sources":["../../src/hooks/databaseHealthCoordinator.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useDatabaseHealth.d.ts

@@ -1,12 +1,8 @@
 /**
  * Database Health Check Hook
  *
- * Polls backend health endpoint to determine database availability.
- * Features:
- * - At most one request in flight at a time (prevents duplicate/burst requests)
- * - Minimum 15s between automatic checks when unhealthy (prevents rapid retry storm)
- * - Poll interval when healthy: 60s default (1 request/min)
- * - User-triggered retry is not throttled (only automatic checks use the 15s minimum interval)
+ * Delegates to a singleton coordinator (one poll schedule per /health endpoint).
+ * See databaseHealthCoordinator.ts for cross-tab, visibility, and 429 handling.
  */
 interface UseDatabaseHealthOptions {
     pollInterval?: number;

package/dist/hooks/useDatabaseHealth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useDatabaseHealth.d.ts","sourceRoot":"","sources":["../../src/hooks/useDatabaseHealth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAWH,UAAU,wBAAwB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,uBAAuB;IAC/B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,wBAA6B,GACrC,uBAAuB,CAwKzB"}
+{"version":3,"file":"useDatabaseHealth.d.ts","sourceRoot":"","sources":["../../src/hooks/useDatabaseHealth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,UAAU,wBAAwB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,uBAAuB;IAC/B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,wBAA6B,GACrC,uBAAuB,CAoCzB"}

package/dist/hooks/useDatabaseHealth.js

@@ -1,156 +1,35 @@
 /**
  * Database Health Check Hook
  *
- * Polls backend health endpoint to determine database availability.
- * Features:
- * - At most one request in flight at a time (prevents duplicate/burst requests)
- * - Minimum 15s between automatic checks when unhealthy (prevents rapid retry storm)
- * - Poll interval when healthy: 60s default (1 request/min)
- * - User-triggered retry is not throttled (only automatic checks use the 15s minimum interval)
+ * Delegates to a singleton coordinator (one poll schedule per /health endpoint).
+ * See databaseHealthCoordinator.ts for cross-tab, visibility, and 429 handling.
  */
 import { useState, useEffect, useCallback, useRef } from 'react';
-const MIN_AUTO_INTERVAL_MS = 15000; // Minimum 15s between automatic checks to avoid hammering /health
+import { requestDatabaseHealthCheck, resolveDatabaseHealthEndpoint, subscribeDatabaseHealth, } from './databaseHealthCoordinator.js';
 export function useDatabaseHealth(options = {}) {
-    const { pollInterval = 60000, maxRetries = 5, retryDelay = 1000, enabled = true, } = options;
-    const [isDatabaseAvailable, setIsDatabaseAvailable] = useState(true);
-    const [isChecking, setIsChecking] = useState(false);
-    const [retryCount, setRetryCount] = useState(0);
-    const [nextRetryDelay, setNextRetryDelay] = useState(0);
-    const [error, setError] = useState(null);
-    const [healthEndpoint] = useState(() => {
-        if (typeof window === 'undefined') {
-            return 'http://localhost:3015/health';
-        }
-        const pageOrigin = window.location.origin;
-        const windowConfig = window.__RUNTIME_CONFIG__;
-        const apiUrl = windowConfig?.apiUrl?.trim();
-        if (apiUrl) {
-            try {
-                return `${new URL(apiUrl).origin}/health`;
-            }
-            catch {
-                return `${apiUrl.replace(/\/+$/, '')}/health`;
-            }
-        }
-        return `${pageOrigin}/health`;
+    const { pollInterval = 120_000, maxRetries = 5, enabled = true, } = options;
+    const endpointRef = useRef(resolveDatabaseHealthEndpoint());
+    const [snapshot, setSnapshot] = useState({
+        isDatabaseAvailable: true,
+        isChecking: false,
+        retryCount: 0,
+        nextRetryDelay: 0,
+        error: null,
     });
-    const retryCountRef = useRef(0);
-    const currentDelayRef = useRef(retryDelay);
-    const pollTimeoutRef = useRef(null);
-    const retryTimeoutRef = useRef(null);
-    const checkHealthRef = useRef(null);
-    const isCheckingRef = useRef(false);
-    const lastCheckTimeRef = useRef(0);
-    const checkHealth = useCallback(async () => {
-        if (!enabled) {
-            return;
-        }
-        // Prevent overlapping requests (e.g. Strict Mode double-mount or poll + retry at once)
-        if (isCheckingRef.current) {
-            return;
-        }
-        isCheckingRef.current = true;
-        setIsChecking(true);
-        setError(null);
-        try {
-            const response = await fetch(healthEndpoint, {
-                method: 'GET',
-                headers: { 'Content-Type': 'application/json' },
-                cache: 'no-cache',
-            });
-            if (!response.ok) {
-                throw new Error(`Health check failed: ${response.status} ${response.statusText}`);
-            }
-            const contentType = response.headers.get('content-type');
-            if (!contentType?.includes('application/json')) {
-                throw new Error(`Invalid response: expected JSON, got ${contentType}`);
-            }
-            const data = (await response.json());
-            if (data.success === true) {
-                setIsDatabaseAvailable(true);
-                setRetryCount(0);
-                setNextRetryDelay(0);
-                retryCountRef.current = 0;
-                currentDelayRef.current = retryDelay;
-            }
-            else {
-                throw new Error('Database reported unhealthy status');
-            }
-        }
-        catch (err) {
-            const e = err instanceof Error ? err : new Error('Health check failed');
-            setError(e);
-            setIsDatabaseAvailable(false);
-            const newRetryCount = retryCountRef.current + 1;
-            retryCountRef.current = newRetryCount;
-            setRetryCount(newRetryCount);
-            const nextDelay = Math.min(currentDelayRef.current * 2, retryDelay * 30);
-            currentDelayRef.current = nextDelay;
-            const delayMs = Math.max(nextDelay, MIN_AUTO_INTERVAL_MS);
-            setNextRetryDelay(delayMs);
-            if (newRetryCount < maxRetries) {
-                retryTimeoutRef.current = setTimeout(() => {
-                    void checkHealthRef.current?.();
-                }, delayMs);
-            }
-            else {
-                retryTimeoutRef.current = setTimeout(() => {
-                    void checkHealthRef.current?.();
-                }, Math.max(pollInterval, MIN_AUTO_INTERVAL_MS));
-            }
-        }
-        finally {
-            lastCheckTimeRef.current = Date.now();
-            isCheckingRef.current = false;
-            setIsChecking(false);
-        }
-    }, [enabled, healthEndpoint, maxRetries, retryDelay, pollInterval]);
-    checkHealthRef.current = checkHealth;
     useEffect(() => {
-        if (!enabled) {
-            return;
-        }
-        const doCheck = () => {
-            const now = Date.now();
-            if (now - lastCheckTimeRef.current < MIN_AUTO_INTERVAL_MS) {
-                return;
-            }
-            if (checkHealthRef.current) {
-                void checkHealthRef.current();
-            }
-        };
-        const startPolling = () => {
-            if (pollTimeoutRef.current) {
-                clearTimeout(pollTimeoutRef.current);
-            }
-            pollTimeoutRef.current = setTimeout(() => {
-                doCheck();
-                startPolling();
-            }, pollInterval);
-        };
-        doCheck();
-        startPolling();
-        return () => {
-            if (pollTimeoutRef.current) {
-                clearTimeout(pollTimeoutRef.current);
-                pollTimeoutRef.current = null;
-            }
-            if (retryTimeoutRef.current) {
-                clearTimeout(retryTimeoutRef.current);
-                retryTimeoutRef.current = null;
-            }
-        };
-    }, [enabled, healthEndpoint, pollInterval]);
-    const checkHealthPublic = useCallback(() => {
-        return checkHealthRef.current?.() ?? Promise.resolve();
+        const endpoint = endpointRef.current;
+        return subscribeDatabaseHealth({ endpoint, enabled, pollInterval, maxRetries }, setSnapshot);
+    }, [enabled, pollInterval, maxRetries]);
+    const checkHealth = useCallback(async () => {
+        await requestDatabaseHealthCheck(endpointRef.current, { force: true });
     }, []);
     return {
-        isDatabaseAvailable,
-        isChecking,
-        retryCount,
-        nextRetryDelay,
-        error,
-        checkHealth: checkHealthPublic,
+        isDatabaseAvailable: snapshot.isDatabaseAvailable,
+        isChecking: snapshot.isChecking,
+        retryCount: snapshot.retryCount,
+        nextRetryDelay: snapshot.nextRetryDelay,
+        error: snapshot.error,
+        checkHealth,
     };
 }
 //# sourceMappingURL=useDatabaseHealth.js.map

package/dist/hooks/useDatabaseHealth.js.map

@@ -1 +1 @@
-{"version":3,"file":"useDatabaseHealth.js","sourceRoot":"","sources":["../../src/hooks/useDatabaseHealth.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useDatabaseHealth.js","sourceRoot":"","sources":["../../src/hooks/useDatabaseHealth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,EAEL,0BAA0B,EAC1B,6BAA6B,EAC7B,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AAkBxC,MAAM,UAAU,iBAAiB,CAC/B,UAAoC,EAAE;IAEtC,MAAM,EACJ,YAAY,GAAG,OAAO,EACtB,UAAU,GAAG,CAAC,EACd,OAAO,GAAG,IAAI,GACf,GAAG,OAAO,CAAC;IAEZ,MAAM,WAAW,GAAG,MAAM,CAAC,6BAA6B,EAAE,CAAC,CAAC;IAC5D,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAA4B;QAClE,mBAAmB,EAAE,IAAI;QACzB,UAAU,EAAE,KAAK;QACjB,UAAU,EAAE,CAAC;QACb,cAAc,EAAE,CAAC;QACjB,KAAK,EAAE,IAAI;KACZ,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC;QACrC,OAAO,uBAAuB,CAC5B,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,EAC/C,WAAW,CACZ,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;IAExC,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,IAAmB,EAAE;QACxD,MAAM,0BAA0B,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzE,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO;QACL,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB;QACjD,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,cAAc,EAAE,QAAQ,CAAC,cAAc;QACvC,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/hooks/useSubmitCooldown.d.ts

@@ -0,0 +1,11 @@
+export interface UseSubmitCooldownResult {
+    readonly isCoolingDown: boolean;
+    readonly remainingSeconds: number;
+    readonly startCooldown: (durationMs: number) => void;
+    readonly clearCooldown: () => void;
+}
+/**
+ * Prevents double-tab / rapid repeat submits after rate-limit or mutation errors.
+ */
+export declare function useSubmitCooldown(): UseSubmitCooldownResult;
+//# sourceMappingURL=useSubmitCooldown.d.ts.map

package/dist/hooks/useSubmitCooldown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSubmitCooldown.d.ts","sourceRoot":"","sources":["../../src/hooks/useSubmitCooldown.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,QAAQ,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,uBAAuB,CA8C3D"}