tempest-react-sdk 0.48.0 → 0.50.0

package/dist/hooks/use-online.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-online.cjs","names":[],"sources":["../../src/hooks/use-online.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\n\n/**\n * Options for {@link useOnline}. Omit them for the cheap `navigator.onLine`\n * behaviour; pass `pingUrl` to add a real-reachability probe on top.\n */\nexport interface UseOnlineOptions {\n    /**\n     * URL to probe for real connectivity. `navigator.onLine` reports `true`\n     * behind a captive portal or when the machine has a link but no internet;\n     * a periodic `HEAD` to this URL catches those cases. When set, the result\n     * is `navigator.onLine && lastProbeSucceeded`.\n     */\n    pingUrl?: string;\n    /** How often to probe, in ms. Default `30000`. */\n    intervalMs?: number;\n    /** Abort a probe after this many ms and treat it as offline. Default `5000`. */\n    timeoutMs?: number;\n}\n\n/**\n * Track connectivity and re-render on changes.\n *\n * With no options it mirrors `navigator.onLine` (assuming online during SSR and\n * before the first event). Pass `pingUrl` to additionally probe real\n * reachability — the browser's `onLine` flag lies behind captive portals and\n * dead links, so the probe downgrades the result to `false` when the network is\n * unusable even though `navigator.onLine` is `true`.\n *\n * @param options - Optional reachability-probe configuration.\n * @returns `true` when the device is online (and reachable, when probing).\n *\n * @example\n * const online = useOnline(); // navigator.onLine only\n * const reallyOnline = useOnline({ pingUrl: \"/health\", intervalMs: 15_000 });\n */\nexport function useOnline(options: UseOnlineOptions = {}): boolean {\n    const { pingUrl, intervalMs = 30_000, timeoutMs = 5_000 } = options;\n\n    const [navOnline, setNavOnline] = useState<boolean>(() =>\n        typeof navigator === \"undefined\" ? true : navigator.onLine,\n    );\n    const [reachable, setReachable] = useState<boolean>(true);\n\n    const optionsRef = useRef({ pingUrl, timeoutMs });\n    useEffect(() => {\n        optionsRef.current = { pingUrl, timeoutMs };\n    }, [pingUrl, timeoutMs]);\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const handleOnline = (): void => setNavOnline(true);\n        const handleOffline = (): void => setNavOnline(false);\n        window.addEventListener(\"online\", handleOnline);\n        window.addEventListener(\"offline\", handleOffline);\n        return () => {\n            window.removeEventListener(\"online\", handleOnline);\n            window.removeEventListener(\"offline\", handleOffline);\n        };\n    }, []);\n\n    useEffect(() => {\n        if (!pingUrl || typeof window === \"undefined\") return;\n\n        let cancelled = false;\n        const probe = async (): Promise<void> => {\n            if (typeof navigator !== \"undefined\" && !navigator.onLine) {\n                if (!cancelled) setReachable(false);\n                return;\n            }\n            const controller = new AbortController();\n            const timer = window.setTimeout(() => controller.abort(), optionsRef.current.timeoutMs);\n            try {\n                await fetch(optionsRef.current.pingUrl!, {\n                    method: \"HEAD\",\n                    cache: \"no-store\",\n                    signal: controller.signal,\n                });\n                if (!cancelled) setReachable(true);\n            } catch {\n                if (!cancelled) setReachable(false);\n            } finally {\n                window.clearTimeout(timer);\n            }\n        };\n\n        void probe();\n        const id = window.setInterval(() => void probe(), intervalMs);\n        const onWake = (): void => void probe();\n        window.addEventListener(\"online\", onWake);\n        document.addEventListener(\"visibilitychange\", onWake);\n        return () => {\n            cancelled = true;\n            window.clearInterval(id);\n            window.removeEventListener(\"online\", onWake);\n            document.removeEventListener(\"visibilitychange\", onWake);\n        };\n    }, [pingUrl, intervalMs]);\n\n    return pingUrl ? navOnline && reachable : navOnline;\n}\n"],"mappings":"uBAoCA,SAAgB,EAAU,EAA4B,CAAC,EAAY,CAC/D,GAAM,CAAE,UAAS,aAAa,IAAQ,YAAY,KAAU,EAEtD,CAAC,EAAW,IAAA,EAAgB,EAAA,SAAA,KAC9B,OAAO,UAAc,KAAqB,UAAU,MACxD,EACM,CAAC,EAAW,IAAA,EAAgB,EAAA,SAAA,CAAkB,EAAI,EAElD,GAAA,EAAa,EAAA,OAAA,CAAO,CAAE,UAAS,WAAU,CAAC,EAuDhD,OAtDA,EAAA,EAAA,UAAA,KAAgB,CACZ,EAAW,QAAU,CAAE,UAAS,WAAU,CAC9C,EAAG,CAAC,EAAS,CAAS,CAAC,GAEvB,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,OAAO,OAAW,IAAa,OACnC,IAAM,MAA2B,EAAa,EAAI,EAC5C,MAA4B,EAAa,EAAK,EAGpD,OAFA,OAAO,iBAAiB,SAAU,CAAY,EAC9C,OAAO,iBAAiB,UAAW,CAAa,MACnC,CACT,OAAO,oBAAoB,SAAU,CAAY,EACjD,OAAO,oBAAoB,UAAW,CAAa,CACvD,CACJ,EAAG,CAAC,CAAC,GAEL,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,CAAC,GAAW,OAAO,OAAW,IAAa,OAE/C,IAAI,EAAY,GACV,EAAQ,SAA2B,CACrC,GAAI,OAAO,UAAc,KAAe,CAAC,UAAU,OAAQ,CAClD,GAAW,EAAa,EAAK,EAClC,MACJ,CACA,IAAM,EAAa,IAAI,gBACjB,EAAQ,OAAO,eAAiB,EAAW,MAAM,EAAG,EAAW,QAAQ,SAAS,EACtF,GAAI,CACA,MAAM,MAAM,EAAW,QAAQ,QAAU,CACrC,OAAQ,OACR,MAAO,WACP,OAAQ,EAAW,MACvB,CAAC,EACI,GAAW,EAAa,EAAI,CACrC,MAAQ,CACC,GAAW,EAAa,EAAK,CACtC,QAAU,CACN,OAAO,aAAa,CAAK,CAC7B,CACJ,EAEA,EAAW,EACX,IAAM,EAAK,OAAO,gBAAkB,KAAK,EAAM,EAAG,CAAU,EACtD,MAAqB,KAAK,EAAM,EAGtC,OAFA,OAAO,iBAAiB,SAAU,CAAM,EACxC,SAAS,iBAAiB,mBAAoB,CAAM,MACvC,CACT,EAAY,GACZ,OAAO,cAAc,CAAE,EACvB,OAAO,oBAAoB,SAAU,CAAM,EAC3C,SAAS,oBAAoB,mBAAoB,CAAM,CAC3D,CACJ,EAAG,CAAC,EAAS,CAAU,CAAC,EAEjB,EAAU,GAAa,EAAY,CAC9C"}
+{"version":3,"file":"use-online.cjs","names":[],"sources":["../../src/hooks/use-online.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\n\n/**\n * Options for {@link useOnline}. Omit them for the cheap `navigator.onLine`\n * behaviour; pass `pingUrl` to add a real-reachability probe on top.\n */\nexport interface UseOnlineOptions {\n    /**\n     * URL to probe for real connectivity. `navigator.onLine` reports `true`\n     * behind a captive portal or when the machine has a link but no internet;\n     * a periodic `HEAD` to this URL catches those cases. When set, the result\n     * is `navigator.onLine && lastProbeSucceeded`.\n     */\n    pingUrl?: string;\n    /** How often to probe, in ms. Default `30000`. */\n    intervalMs?: number;\n    /** Abort a probe after this many ms and treat it as offline. Default `5000`. */\n    timeoutMs?: number;\n}\n\n/**\n * Track connectivity and re-render on changes.\n *\n * With no options it mirrors `navigator.onLine` (assuming online during SSR and\n * before the first event). Pass `pingUrl` to additionally probe real\n * reachability — the browser's `onLine` flag lies behind captive portals and\n * dead links, so the probe downgrades the result to `false` when the network is\n * unusable even though `navigator.onLine` is `true`.\n *\n * @param options - Optional reachability-probe configuration.\n * @returns `true` when the device is online (and reachable, when probing).\n *\n * @example\n * const online = useOnline(); // navigator.onLine only\n * const reallyOnline = useOnline({ pingUrl: \"/health\", intervalMs: 15_000 });\n */\nexport function useOnline(options: UseOnlineOptions = {}): boolean {\n    const { pingUrl, intervalMs = 30_000, timeoutMs = 5_000 } = options;\n\n    const [navOnline, setNavOnline] = useState<boolean>(() =>\n        typeof navigator === \"undefined\" ? true : navigator.onLine,\n    );\n    const [reachable, setReachable] = useState<boolean>(true);\n\n    const optionsRef = useLatestRef({ pingUrl, timeoutMs });\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const handleOnline = (): void => setNavOnline(true);\n        const handleOffline = (): void => setNavOnline(false);\n        window.addEventListener(\"online\", handleOnline);\n        window.addEventListener(\"offline\", handleOffline);\n        return () => {\n            window.removeEventListener(\"online\", handleOnline);\n            window.removeEventListener(\"offline\", handleOffline);\n        };\n    }, []);\n\n    useEffect(() => {\n        if (!pingUrl || typeof window === \"undefined\") return;\n\n        let cancelled = false;\n        const probe = async (): Promise<void> => {\n            if (typeof navigator !== \"undefined\" && !navigator.onLine) {\n                if (!cancelled) setReachable(false);\n                return;\n            }\n            const controller = new AbortController();\n            const timer = window.setTimeout(() => controller.abort(), optionsRef.current.timeoutMs);\n            try {\n                await fetch(optionsRef.current.pingUrl!, {\n                    method: \"HEAD\",\n                    cache: \"no-store\",\n                    signal: controller.signal,\n                });\n                if (!cancelled) setReachable(true);\n            } catch {\n                if (!cancelled) setReachable(false);\n            } finally {\n                window.clearTimeout(timer);\n            }\n        };\n\n        void probe();\n        const id = window.setInterval(() => void probe(), intervalMs);\n        const onWake = (): void => void probe();\n        window.addEventListener(\"online\", onWake);\n        document.addEventListener(\"visibilitychange\", onWake);\n        return () => {\n            cancelled = true;\n            window.clearInterval(id);\n            window.removeEventListener(\"online\", onWake);\n            document.removeEventListener(\"visibilitychange\", onWake);\n        };\n    }, [pingUrl, intervalMs, optionsRef]);\n\n    return pingUrl ? navOnline && reachable : navOnline;\n}\n"],"mappings":"+DAqCA,SAAgB,EAAU,EAA4B,CAAC,EAAY,CAC/D,GAAM,CAAE,UAAS,aAAa,IAAQ,YAAY,KAAU,EAEtD,CAAC,EAAW,IAAA,EAAgB,EAAA,SAAA,KAC9B,OAAO,UAAc,KAAqB,UAAU,MACxD,EACM,CAAC,EAAW,IAAA,EAAgB,EAAA,SAAA,CAAkB,EAAI,EAElD,EAAa,EAAA,aAAa,CAAE,UAAS,WAAU,CAAC,EAoDtD,OAlDA,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,OAAO,OAAW,IAAa,OACnC,IAAM,MAA2B,EAAa,EAAI,EAC5C,MAA4B,EAAa,EAAK,EAGpD,OAFA,OAAO,iBAAiB,SAAU,CAAY,EAC9C,OAAO,iBAAiB,UAAW,CAAa,MACnC,CACT,OAAO,oBAAoB,SAAU,CAAY,EACjD,OAAO,oBAAoB,UAAW,CAAa,CACvD,CACJ,EAAG,CAAC,CAAC,GAEL,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,CAAC,GAAW,OAAO,OAAW,IAAa,OAE/C,IAAI,EAAY,GACV,EAAQ,SAA2B,CACrC,GAAI,OAAO,UAAc,KAAe,CAAC,UAAU,OAAQ,CAClD,GAAW,EAAa,EAAK,EAClC,MACJ,CACA,IAAM,EAAa,IAAI,gBACjB,EAAQ,OAAO,eAAiB,EAAW,MAAM,EAAG,EAAW,QAAQ,SAAS,EACtF,GAAI,CACA,MAAM,MAAM,EAAW,QAAQ,QAAU,CACrC,OAAQ,OACR,MAAO,WACP,OAAQ,EAAW,MACvB,CAAC,EACI,GAAW,EAAa,EAAI,CACrC,MAAQ,CACC,GAAW,EAAa,EAAK,CACtC,QAAU,CACN,OAAO,aAAa,CAAK,CAC7B,CACJ,EAEA,EAAW,EACX,IAAM,EAAK,OAAO,gBAAkB,KAAK,EAAM,EAAG,CAAU,EACtD,MAAqB,KAAK,EAAM,EAGtC,OAFA,OAAO,iBAAiB,SAAU,CAAM,EACxC,SAAS,iBAAiB,mBAAoB,CAAM,MACvC,CACT,EAAY,GACZ,OAAO,cAAc,CAAE,EACvB,OAAO,oBAAoB,SAAU,CAAM,EAC3C,SAAS,oBAAoB,mBAAoB,CAAM,CAC3D,CACJ,EAAG,CAAC,EAAS,EAAY,CAAU,CAAC,EAE7B,EAAU,GAAa,EAAY,CAC9C"}

package/dist/hooks/use-online.js

@@ -1,22 +1,18 @@
-import { useEffect as e, useRef as t, useState as n } from "react";
+import { useLatestRef as e } from "./use-latest-ref.js";
+import { useEffect as t, useState as n } from "react";
 //#region src/hooks/use-online.ts
 function r(r = {}) {
-	let { pingUrl: i, intervalMs: a = 3e4, timeoutMs: o = 5e3 } = r, [s, c] = n(() => typeof navigator > "u" || navigator.onLine), [l, u] = n(!0), d = t({
+	let { pingUrl: i, intervalMs: a = 3e4, timeoutMs: o = 5e3 } = r, [s, c] = n(() => typeof navigator > "u" || navigator.onLine), [l, u] = n(!0), d = e({
 		pingUrl: i,
 		timeoutMs: o
 	});
-	return e(() => {
-		d.current = {
-			pingUrl: i,
-			timeoutMs: o
-		};
-	}, [i, o]), e(() => {
+	return t(() => {
 		if (typeof window > "u") return;
 		let e = () => c(!0), t = () => c(!1);
 		return window.addEventListener("online", e), window.addEventListener("offline", t), () => {
 			window.removeEventListener("online", e), window.removeEventListener("offline", t);
 		};
-	}, []), e(() => {
+	}, []), t(() => {
 		if (!i || typeof window > "u") return;
 		let e = !1, t = async () => {
 			if (typeof navigator < "u" && !navigator.onLine) {
@@ -41,7 +37,11 @@ function r(r = {}) {
 		return window.addEventListener("online", r), document.addEventListener("visibilitychange", r), () => {
 			e = !0, window.clearInterval(n), window.removeEventListener("online", r), document.removeEventListener("visibilitychange", r);
 		};
-	}, [i, a]), i ? s && l : s;
+	}, [
+		i,
+		a,
+		d
+	]), i ? s && l : s;
 }
 //#endregion
 export { r as useOnline };

package/dist/hooks/use-online.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-online.js","names":[],"sources":["../../src/hooks/use-online.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\n\n/**\n * Options for {@link useOnline}. Omit them for the cheap `navigator.onLine`\n * behaviour; pass `pingUrl` to add a real-reachability probe on top.\n */\nexport interface UseOnlineOptions {\n    /**\n     * URL to probe for real connectivity. `navigator.onLine` reports `true`\n     * behind a captive portal or when the machine has a link but no internet;\n     * a periodic `HEAD` to this URL catches those cases. When set, the result\n     * is `navigator.onLine && lastProbeSucceeded`.\n     */\n    pingUrl?: string;\n    /** How often to probe, in ms. Default `30000`. */\n    intervalMs?: number;\n    /** Abort a probe after this many ms and treat it as offline. Default `5000`. */\n    timeoutMs?: number;\n}\n\n/**\n * Track connectivity and re-render on changes.\n *\n * With no options it mirrors `navigator.onLine` (assuming online during SSR and\n * before the first event). Pass `pingUrl` to additionally probe real\n * reachability — the browser's `onLine` flag lies behind captive portals and\n * dead links, so the probe downgrades the result to `false` when the network is\n * unusable even though `navigator.onLine` is `true`.\n *\n * @param options - Optional reachability-probe configuration.\n * @returns `true` when the device is online (and reachable, when probing).\n *\n * @example\n * const online = useOnline(); // navigator.onLine only\n * const reallyOnline = useOnline({ pingUrl: \"/health\", intervalMs: 15_000 });\n */\nexport function useOnline(options: UseOnlineOptions = {}): boolean {\n    const { pingUrl, intervalMs = 30_000, timeoutMs = 5_000 } = options;\n\n    const [navOnline, setNavOnline] = useState<boolean>(() =>\n        typeof navigator === \"undefined\" ? true : navigator.onLine,\n    );\n    const [reachable, setReachable] = useState<boolean>(true);\n\n    const optionsRef = useRef({ pingUrl, timeoutMs });\n    useEffect(() => {\n        optionsRef.current = { pingUrl, timeoutMs };\n    }, [pingUrl, timeoutMs]);\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const handleOnline = (): void => setNavOnline(true);\n        const handleOffline = (): void => setNavOnline(false);\n        window.addEventListener(\"online\", handleOnline);\n        window.addEventListener(\"offline\", handleOffline);\n        return () => {\n            window.removeEventListener(\"online\", handleOnline);\n            window.removeEventListener(\"offline\", handleOffline);\n        };\n    }, []);\n\n    useEffect(() => {\n        if (!pingUrl || typeof window === \"undefined\") return;\n\n        let cancelled = false;\n        const probe = async (): Promise<void> => {\n            if (typeof navigator !== \"undefined\" && !navigator.onLine) {\n                if (!cancelled) setReachable(false);\n                return;\n            }\n            const controller = new AbortController();\n            const timer = window.setTimeout(() => controller.abort(), optionsRef.current.timeoutMs);\n            try {\n                await fetch(optionsRef.current.pingUrl!, {\n                    method: \"HEAD\",\n                    cache: \"no-store\",\n                    signal: controller.signal,\n                });\n                if (!cancelled) setReachable(true);\n            } catch {\n                if (!cancelled) setReachable(false);\n            } finally {\n                window.clearTimeout(timer);\n            }\n        };\n\n        void probe();\n        const id = window.setInterval(() => void probe(), intervalMs);\n        const onWake = (): void => void probe();\n        window.addEventListener(\"online\", onWake);\n        document.addEventListener(\"visibilitychange\", onWake);\n        return () => {\n            cancelled = true;\n            window.clearInterval(id);\n            window.removeEventListener(\"online\", onWake);\n            document.removeEventListener(\"visibilitychange\", onWake);\n        };\n    }, [pingUrl, intervalMs]);\n\n    return pingUrl ? navOnline && reachable : navOnline;\n}\n"],"mappings":";;AAoCA,SAAgB,EAAU,IAA4B,CAAC,GAAY;CAC/D,IAAM,EAAE,YAAS,gBAAa,KAAQ,eAAY,QAAU,GAEtD,CAAC,GAAW,KAAgB,QAC9B,OAAO,YAAc,OAAqB,UAAU,MACxD,GACM,CAAC,GAAW,KAAgB,EAAkB,EAAI,GAElD,IAAa,EAAO;EAAE;EAAS;CAAU,CAAC;CAuDhD,OAtDA,QAAgB;EACZ,EAAW,UAAU;GAAE;GAAS;EAAU;CAC9C,GAAG,CAAC,GAAS,CAAS,CAAC,GAEvB,QAAgB;EACZ,IAAI,OAAO,SAAW,KAAa;EACnC,IAAM,UAA2B,EAAa,EAAI,GAC5C,UAA4B,EAAa,EAAK;EAGpD,OAFA,OAAO,iBAAiB,UAAU,CAAY,GAC9C,OAAO,iBAAiB,WAAW,CAAa,SACnC;GAET,AADA,OAAO,oBAAoB,UAAU,CAAY,GACjD,OAAO,oBAAoB,WAAW,CAAa;EACvD;CACJ,GAAG,CAAC,CAAC,GAEL,QAAgB;EACZ,IAAI,CAAC,KAAW,OAAO,SAAW,KAAa;EAE/C,IAAI,IAAY,IACV,IAAQ,YAA2B;GACrC,IAAI,OAAO,YAAc,OAAe,CAAC,UAAU,QAAQ;IACvD,AAAK,KAAW,EAAa,EAAK;IAClC;GACJ;GACA,IAAM,IAAa,IAAI,gBAAgB,GACjC,IAAQ,OAAO,iBAAiB,EAAW,MAAM,GAAG,EAAW,QAAQ,SAAS;GACtF,IAAI;IAMA,AALA,MAAM,MAAM,EAAW,QAAQ,SAAU;KACrC,QAAQ;KACR,OAAO;KACP,QAAQ,EAAW;IACvB,CAAC,GACI,KAAW,EAAa,EAAI;GACrC,QAAQ;IACJ,AAAK,KAAW,EAAa,EAAK;GACtC,UAAU;IACN,OAAO,aAAa,CAAK;GAC7B;EACJ;EAEA,EAAW;EACX,IAAM,IAAK,OAAO,kBAAkB,KAAK,EAAM,GAAG,CAAU,GACtD,UAAqB,KAAK,EAAM;EAGtC,OAFA,OAAO,iBAAiB,UAAU,CAAM,GACxC,SAAS,iBAAiB,oBAAoB,CAAM,SACvC;GAIT,AAHA,IAAY,IACZ,OAAO,cAAc,CAAE,GACvB,OAAO,oBAAoB,UAAU,CAAM,GAC3C,SAAS,oBAAoB,oBAAoB,CAAM;EAC3D;CACJ,GAAG,CAAC,GAAS,CAAU,CAAC,GAEjB,IAAU,KAAa,IAAY;AAC9C"}
+{"version":3,"file":"use-online.js","names":[],"sources":["../../src/hooks/use-online.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\n\n/**\n * Options for {@link useOnline}. Omit them for the cheap `navigator.onLine`\n * behaviour; pass `pingUrl` to add a real-reachability probe on top.\n */\nexport interface UseOnlineOptions {\n    /**\n     * URL to probe for real connectivity. `navigator.onLine` reports `true`\n     * behind a captive portal or when the machine has a link but no internet;\n     * a periodic `HEAD` to this URL catches those cases. When set, the result\n     * is `navigator.onLine && lastProbeSucceeded`.\n     */\n    pingUrl?: string;\n    /** How often to probe, in ms. Default `30000`. */\n    intervalMs?: number;\n    /** Abort a probe after this many ms and treat it as offline. Default `5000`. */\n    timeoutMs?: number;\n}\n\n/**\n * Track connectivity and re-render on changes.\n *\n * With no options it mirrors `navigator.onLine` (assuming online during SSR and\n * before the first event). Pass `pingUrl` to additionally probe real\n * reachability — the browser's `onLine` flag lies behind captive portals and\n * dead links, so the probe downgrades the result to `false` when the network is\n * unusable even though `navigator.onLine` is `true`.\n *\n * @param options - Optional reachability-probe configuration.\n * @returns `true` when the device is online (and reachable, when probing).\n *\n * @example\n * const online = useOnline(); // navigator.onLine only\n * const reallyOnline = useOnline({ pingUrl: \"/health\", intervalMs: 15_000 });\n */\nexport function useOnline(options: UseOnlineOptions = {}): boolean {\n    const { pingUrl, intervalMs = 30_000, timeoutMs = 5_000 } = options;\n\n    const [navOnline, setNavOnline] = useState<boolean>(() =>\n        typeof navigator === \"undefined\" ? true : navigator.onLine,\n    );\n    const [reachable, setReachable] = useState<boolean>(true);\n\n    const optionsRef = useLatestRef({ pingUrl, timeoutMs });\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const handleOnline = (): void => setNavOnline(true);\n        const handleOffline = (): void => setNavOnline(false);\n        window.addEventListener(\"online\", handleOnline);\n        window.addEventListener(\"offline\", handleOffline);\n        return () => {\n            window.removeEventListener(\"online\", handleOnline);\n            window.removeEventListener(\"offline\", handleOffline);\n        };\n    }, []);\n\n    useEffect(() => {\n        if (!pingUrl || typeof window === \"undefined\") return;\n\n        let cancelled = false;\n        const probe = async (): Promise<void> => {\n            if (typeof navigator !== \"undefined\" && !navigator.onLine) {\n                if (!cancelled) setReachable(false);\n                return;\n            }\n            const controller = new AbortController();\n            const timer = window.setTimeout(() => controller.abort(), optionsRef.current.timeoutMs);\n            try {\n                await fetch(optionsRef.current.pingUrl!, {\n                    method: \"HEAD\",\n                    cache: \"no-store\",\n                    signal: controller.signal,\n                });\n                if (!cancelled) setReachable(true);\n            } catch {\n                if (!cancelled) setReachable(false);\n            } finally {\n                window.clearTimeout(timer);\n            }\n        };\n\n        void probe();\n        const id = window.setInterval(() => void probe(), intervalMs);\n        const onWake = (): void => void probe();\n        window.addEventListener(\"online\", onWake);\n        document.addEventListener(\"visibilitychange\", onWake);\n        return () => {\n            cancelled = true;\n            window.clearInterval(id);\n            window.removeEventListener(\"online\", onWake);\n            document.removeEventListener(\"visibilitychange\", onWake);\n        };\n    }, [pingUrl, intervalMs, optionsRef]);\n\n    return pingUrl ? navOnline && reachable : navOnline;\n}\n"],"mappings":";;;AAqCA,SAAgB,EAAU,IAA4B,CAAC,GAAY;CAC/D,IAAM,EAAE,YAAS,gBAAa,KAAQ,eAAY,QAAU,GAEtD,CAAC,GAAW,KAAgB,QAC9B,OAAO,YAAc,OAAqB,UAAU,MACxD,GACM,CAAC,GAAW,KAAgB,EAAkB,EAAI,GAElD,IAAa,EAAa;EAAE;EAAS;CAAU,CAAC;CAoDtD,OAlDA,QAAgB;EACZ,IAAI,OAAO,SAAW,KAAa;EACnC,IAAM,UAA2B,EAAa,EAAI,GAC5C,UAA4B,EAAa,EAAK;EAGpD,OAFA,OAAO,iBAAiB,UAAU,CAAY,GAC9C,OAAO,iBAAiB,WAAW,CAAa,SACnC;GAET,AADA,OAAO,oBAAoB,UAAU,CAAY,GACjD,OAAO,oBAAoB,WAAW,CAAa;EACvD;CACJ,GAAG,CAAC,CAAC,GAEL,QAAgB;EACZ,IAAI,CAAC,KAAW,OAAO,SAAW,KAAa;EAE/C,IAAI,IAAY,IACV,IAAQ,YAA2B;GACrC,IAAI,OAAO,YAAc,OAAe,CAAC,UAAU,QAAQ;IACvD,AAAK,KAAW,EAAa,EAAK;IAClC;GACJ;GACA,IAAM,IAAa,IAAI,gBAAgB,GACjC,IAAQ,OAAO,iBAAiB,EAAW,MAAM,GAAG,EAAW,QAAQ,SAAS;GACtF,IAAI;IAMA,AALA,MAAM,MAAM,EAAW,QAAQ,SAAU;KACrC,QAAQ;KACR,OAAO;KACP,QAAQ,EAAW;IACvB,CAAC,GACI,KAAW,EAAa,EAAI;GACrC,QAAQ;IACJ,AAAK,KAAW,EAAa,EAAK;GACtC,UAAU;IACN,OAAO,aAAa,CAAK;GAC7B;EACJ;EAEA,EAAW;EACX,IAAM,IAAK,OAAO,kBAAkB,KAAK,EAAM,GAAG,CAAU,GACtD,UAAqB,KAAK,EAAM;EAGtC,OAFA,OAAO,iBAAiB,UAAU,CAAM,GACxC,SAAS,iBAAiB,oBAAoB,CAAM,SACvC;GAIT,AAHA,IAAY,IACZ,OAAO,cAAc,CAAE,GACvB,OAAO,oBAAoB,UAAU,CAAM,GAC3C,SAAS,oBAAoB,oBAAoB,CAAM;EAC3D;CACJ,GAAG;EAAC;EAAS;EAAY;CAAU,CAAC,GAE7B,IAAU,KAAa,IAAY;AAC9C"}

package/dist/hooks/use-service-worker-update.cjs

@@ -1,2 +1,2 @@
-const e=require("../sw/register-service-worker.cjs");let t=require("react");function n(n){let[r,i]=(0,t.useState)(!1),[a,o]=(0,t.useState)(null),s=(0,t.useRef)(null),c=(0,t.useRef)(n);return(0,t.useEffect)(()=>{c.current=n},[n]),(0,t.useEffect)(()=>{let t=!1;return e.registerServiceWorker({...c.current,onUpdate:(e,t)=>{s.current=e,o(t),i(!0)},onReady:e=>{t||(o(e),e.waiting&&navigator.serviceWorker.controller&&(s.current=e.waiting,i(!0)),c.current.onReady?.(e))}}).then(e=>{!t&&e&&o(e)}),()=>{t=!0}},[n.url]),{updateAvailable:r,applyUpdate:(0,t.useCallback)(()=>{let t=s.current;if(!t||typeof navigator>`u`)return;let n=!1;navigator.serviceWorker.addEventListener(`controllerchange`,()=>{n||(n=!0,window.location.reload())}),e.skipWaiting(t)},[]),registration:a}}exports.useServiceWorkerUpdate=n;
+const e=require("./use-latest-ref.cjs"),t=require("../sw/register-service-worker.cjs");let n=require("react");function r(r){let[i,a]=(0,n.useState)(!1),[o,s]=(0,n.useState)(null),c=(0,n.useRef)(null),l=e.useLatestRef(r);return(0,n.useEffect)(()=>{let e=!1;return t.registerServiceWorker({...l.current,onUpdate:(e,t)=>{c.current=e,s(t),a(!0)},onReady:t=>{e||(s(t),t.waiting&&navigator.serviceWorker.controller&&(c.current=t.waiting,a(!0)),l.current.onReady?.(t))}}).then(t=>{!e&&t&&s(t)}),()=>{e=!0}},[r.url,l]),{updateAvailable:i,applyUpdate:(0,n.useCallback)(()=>{let e=c.current;if(!e||typeof navigator>`u`)return;let n=!1;navigator.serviceWorker.addEventListener(`controllerchange`,()=>{n||(n=!0,window.location.reload())}),t.skipWaiting(e)},[]),registration:o}}exports.useServiceWorkerUpdate=r;
 //# sourceMappingURL=use-service-worker-update.cjs.map

package/dist/hooks/use-service-worker-update.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-service-worker-update.cjs","names":[],"sources":["../../src/hooks/use-service-worker-update.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport {\n    registerServiceWorker,\n    skipWaiting,\n    type RegisterServiceWorkerOptions,\n} from \"../sw/register-service-worker\";\n\n/**\n * Options for {@link useServiceWorkerUpdate}. Mirrors the registration options\n * minus the callbacks the hook owns internally (`onUpdate`); `onReady` and\n * `onError` still pass through for host-side logging.\n *\n * Leave `autoUpdate` off (the default): this hook exists to hand the reload\n * decision to the user, so a silent auto-reload would defeat the prompt.\n */\nexport type UseServiceWorkerUpdateOptions = Omit<RegisterServiceWorkerOptions, \"onUpdate\">;\n\n/** Reactive service-worker update state plus the apply action. */\nexport interface UseServiceWorkerUpdateResult {\n    /** `true` once a new worker has installed and is waiting to activate. */\n    updateAvailable: boolean;\n    /**\n     * Activate the waiting worker and reload the page once it takes control.\n     * No-op when no update is waiting.\n     */\n    applyUpdate: () => void;\n    /** The active registration, or `null` before it resolves / when unsupported. */\n    registration: ServiceWorkerRegistration | null;\n}\n\n/**\n * Register a service worker and expose a user-driven update flow.\n *\n * Wraps {@link registerServiceWorker}: when a fresh worker finishes installing\n * while the page is still controlled by the old one, `updateAvailable` flips to\n * `true`. Call `applyUpdate` — typically from an \"atualizar\" toast — to tell the\n * waiting worker to activate and reload the page once it takes control.\n *\n * Skips cleanly when the runtime has no service-worker support (`registration`\n * stays `null`, `updateAvailable` stays `false`).\n *\n * @param options - Registration options (`url` required); `autoUpdate` should\n *   stay off so the reload is user-confirmed.\n * @returns The update state and `applyUpdate` action.\n *\n * @example\n * const { updateAvailable, applyUpdate } = useServiceWorkerUpdate({ url: \"/sw.js\" });\n * return (\n *     <UpdatePrompt open={updateAvailable} onUpdate={applyUpdate} />\n * );\n */\nexport function useServiceWorkerUpdate(\n    options: UseServiceWorkerUpdateOptions,\n): UseServiceWorkerUpdateResult {\n    const [updateAvailable, setUpdateAvailable] = useState<boolean>(false);\n    const [registration, setRegistration] = useState<ServiceWorkerRegistration | null>(null);\n    const waitingRef = useRef<ServiceWorker | null>(null);\n\n    const optionsRef = useRef(options);\n    useEffect(() => {\n        optionsRef.current = options;\n    }, [options]);\n\n    useEffect(() => {\n        let cancelled = false;\n        void registerServiceWorker({\n            ...optionsRef.current,\n            onUpdate: (waiting, reg) => {\n                waitingRef.current = waiting;\n                setRegistration(reg);\n                setUpdateAvailable(true);\n            },\n            onReady: (reg) => {\n                if (cancelled) return;\n                setRegistration(reg);\n                if (reg.waiting && navigator.serviceWorker.controller) {\n                    waitingRef.current = reg.waiting;\n                    setUpdateAvailable(true);\n                }\n                optionsRef.current.onReady?.(reg);\n            },\n        }).then((reg) => {\n            if (!cancelled && reg) setRegistration(reg);\n        });\n        return () => {\n            cancelled = true;\n        };\n    }, [options.url]);\n\n    const applyUpdate = useCallback(() => {\n        const waiting = waitingRef.current;\n        if (!waiting || typeof navigator === \"undefined\") return;\n        let reloading = false;\n        navigator.serviceWorker.addEventListener(\"controllerchange\", () => {\n            if (reloading) return;\n            reloading = true;\n            window.location.reload();\n        });\n        skipWaiting(waiting);\n    }, []);\n\n    return { updateAvailable, applyUpdate, registration };\n}\n"],"mappings":"4EAmDA,SAAgB,EACZ,EAC4B,CAC5B,GAAM,CAAC,EAAiB,IAAA,EAAsB,EAAA,SAAA,CAAkB,EAAK,EAC/D,CAAC,EAAc,IAAA,EAAmB,EAAA,SAAA,CAA2C,IAAI,EACjF,GAAA,EAAa,EAAA,OAAA,CAA6B,IAAI,EAE9C,GAAA,EAAa,EAAA,OAAA,CAAO,CAAO,EA2CjC,OA1CA,EAAA,EAAA,UAAA,KAAgB,CACZ,EAAW,QAAU,CACzB,EAAG,CAAC,CAAO,CAAC,GAEZ,EAAA,EAAA,UAAA,KAAgB,CACZ,IAAI,EAAY,GAoBhB,OAnBA,EAAK,sBAAsB,CACvB,GAAG,EAAW,QACd,UAAW,EAAS,IAAQ,CACxB,EAAW,QAAU,EACrB,EAAgB,CAAG,EACnB,EAAmB,EAAI,CAC3B,EACA,QAAU,GAAQ,CACV,IACJ,EAAgB,CAAG,EACf,EAAI,SAAW,UAAU,cAAc,aACvC,EAAW,QAAU,EAAI,QACzB,EAAmB,EAAI,GAE3B,EAAW,QAAQ,UAAU,CAAG,EACpC,CACJ,CAAC,CAAC,CAAC,KAAM,GAAQ,CACT,CAAC,GAAa,GAAK,EAAgB,CAAG,CAC9C,CAAC,MACY,CACT,EAAY,EAChB,CACJ,EAAG,CAAC,EAAQ,GAAG,CAAC,EAcT,CAAE,kBAAiB,aAAA,EAZN,EAAA,YAAA,KAAkB,CAClC,IAAM,EAAU,EAAW,QAC3B,GAAI,CAAC,GAAW,OAAO,UAAc,IAAa,OAClD,IAAI,EAAY,GAChB,UAAU,cAAc,iBAAiB,uBAA0B,CAC3D,IACJ,EAAY,GACZ,OAAO,SAAS,OAAO,EAC3B,CAAC,EACD,EAAA,YAAY,CAAO,CACvB,EAAG,CAAC,CAEsB,EAAa,cAAa,CACxD"}
+{"version":3,"file":"use-service-worker-update.cjs","names":[],"sources":["../../src/hooks/use-service-worker-update.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\nimport {\n    registerServiceWorker,\n    skipWaiting,\n    type RegisterServiceWorkerOptions,\n} from \"../sw/register-service-worker\";\n\n/**\n * Options for {@link useServiceWorkerUpdate}. Mirrors the registration options\n * minus the callbacks the hook owns internally (`onUpdate`); `onReady` and\n * `onError` still pass through for host-side logging.\n *\n * Leave `autoUpdate` off (the default): this hook exists to hand the reload\n * decision to the user, so a silent auto-reload would defeat the prompt.\n */\nexport type UseServiceWorkerUpdateOptions = Omit<RegisterServiceWorkerOptions, \"onUpdate\">;\n\n/** Reactive service-worker update state plus the apply action. */\nexport interface UseServiceWorkerUpdateResult {\n    /** `true` once a new worker has installed and is waiting to activate. */\n    updateAvailable: boolean;\n    /**\n     * Activate the waiting worker and reload the page once it takes control.\n     * No-op when no update is waiting.\n     */\n    applyUpdate: () => void;\n    /** The active registration, or `null` before it resolves / when unsupported. */\n    registration: ServiceWorkerRegistration | null;\n}\n\n/**\n * Register a service worker and expose a user-driven update flow.\n *\n * Wraps {@link registerServiceWorker}: when a fresh worker finishes installing\n * while the page is still controlled by the old one, `updateAvailable` flips to\n * `true`. Call `applyUpdate` — typically from an \"atualizar\" toast — to tell the\n * waiting worker to activate and reload the page once it takes control.\n *\n * Skips cleanly when the runtime has no service-worker support (`registration`\n * stays `null`, `updateAvailable` stays `false`).\n *\n * @param options - Registration options (`url` required); `autoUpdate` should\n *   stay off so the reload is user-confirmed.\n * @returns The update state and `applyUpdate` action.\n *\n * @example\n * const { updateAvailable, applyUpdate } = useServiceWorkerUpdate({ url: \"/sw.js\" });\n * return (\n *     <UpdatePrompt open={updateAvailable} onUpdate={applyUpdate} />\n * );\n */\nexport function useServiceWorkerUpdate(\n    options: UseServiceWorkerUpdateOptions,\n): UseServiceWorkerUpdateResult {\n    const [updateAvailable, setUpdateAvailable] = useState<boolean>(false);\n    const [registration, setRegistration] = useState<ServiceWorkerRegistration | null>(null);\n    const waitingRef = useRef<ServiceWorker | null>(null);\n\n    const optionsRef = useLatestRef(options);\n\n    useEffect(() => {\n        let cancelled = false;\n        void registerServiceWorker({\n            ...optionsRef.current,\n            onUpdate: (waiting, reg) => {\n                waitingRef.current = waiting;\n                setRegistration(reg);\n                setUpdateAvailable(true);\n            },\n            onReady: (reg) => {\n                if (cancelled) return;\n                setRegistration(reg);\n                if (reg.waiting && navigator.serviceWorker.controller) {\n                    waitingRef.current = reg.waiting;\n                    setUpdateAvailable(true);\n                }\n                optionsRef.current.onReady?.(reg);\n            },\n        }).then((reg) => {\n            if (!cancelled && reg) setRegistration(reg);\n        });\n        return () => {\n            cancelled = true;\n        };\n    }, [options.url, optionsRef]);\n\n    const applyUpdate = useCallback(() => {\n        const waiting = waitingRef.current;\n        if (!waiting || typeof navigator === \"undefined\") return;\n        let reloading = false;\n        navigator.serviceWorker.addEventListener(\"controllerchange\", () => {\n            if (reloading) return;\n            reloading = true;\n            window.location.reload();\n        });\n        skipWaiting(waiting);\n    }, []);\n\n    return { updateAvailable, applyUpdate, registration };\n}\n"],"mappings":"8GAoDA,SAAgB,EACZ,EAC4B,CAC5B,GAAM,CAAC,EAAiB,IAAA,EAAsB,EAAA,SAAA,CAAkB,EAAK,EAC/D,CAAC,EAAc,IAAA,EAAmB,EAAA,SAAA,CAA2C,IAAI,EACjF,GAAA,EAAa,EAAA,OAAA,CAA6B,IAAI,EAE9C,EAAa,EAAA,aAAa,CAAO,EAwCvC,OAtCA,EAAA,EAAA,UAAA,KAAgB,CACZ,IAAI,EAAY,GAoBhB,OAnBA,EAAK,sBAAsB,CACvB,GAAG,EAAW,QACd,UAAW,EAAS,IAAQ,CACxB,EAAW,QAAU,EACrB,EAAgB,CAAG,EACnB,EAAmB,EAAI,CAC3B,EACA,QAAU,GAAQ,CACV,IACJ,EAAgB,CAAG,EACf,EAAI,SAAW,UAAU,cAAc,aACvC,EAAW,QAAU,EAAI,QACzB,EAAmB,EAAI,GAE3B,EAAW,QAAQ,UAAU,CAAG,EACpC,CACJ,CAAC,CAAC,CAAC,KAAM,GAAQ,CACT,CAAC,GAAa,GAAK,EAAgB,CAAG,CAC9C,CAAC,MACY,CACT,EAAY,EAChB,CACJ,EAAG,CAAC,EAAQ,IAAK,CAAU,CAAC,EAcrB,CAAE,kBAAiB,aAAA,EAZN,EAAA,YAAA,KAAkB,CAClC,IAAM,EAAU,EAAW,QAC3B,GAAI,CAAC,GAAW,OAAO,UAAc,IAAa,OAClD,IAAI,EAAY,GAChB,UAAU,cAAc,iBAAiB,uBAA0B,CAC3D,IACJ,EAAY,GACZ,OAAO,SAAS,OAAO,EAC3B,CAAC,EACD,EAAA,YAAY,CAAO,CACvB,EAAG,CAAC,CAEsB,EAAa,cAAa,CACxD"}

package/dist/hooks/use-service-worker-update.js

@@ -1,39 +1,38 @@
-import { registerServiceWorker as e, skipWaiting as t } from "../sw/register-service-worker.js";
-import { useCallback as n, useEffect as r, useRef as i, useState as a } from "react";
+import { useLatestRef as e } from "./use-latest-ref.js";
+import { registerServiceWorker as t, skipWaiting as n } from "../sw/register-service-worker.js";
+import { useCallback as r, useEffect as i, useRef as a, useState as o } from "react";
 //#region src/hooks/use-service-worker-update.ts
-function o(o) {
-	let [s, c] = a(!1), [l, u] = a(null), d = i(null), f = i(o);
-	return r(() => {
-		f.current = o;
-	}, [o]), r(() => {
-		let t = !1;
-		return e({
-			...f.current,
+function s(s) {
+	let [c, l] = o(!1), [u, d] = o(null), f = a(null), p = e(s);
+	return i(() => {
+		let e = !1;
+		return t({
+			...p.current,
 			onUpdate: (e, t) => {
-				d.current = e, u(t), c(!0);
+				f.current = e, d(t), l(!0);
 			},
-			onReady: (e) => {
-				t || (u(e), e.waiting && navigator.serviceWorker.controller && (d.current = e.waiting, c(!0)), f.current.onReady?.(e));
+			onReady: (t) => {
+				e || (d(t), t.waiting && navigator.serviceWorker.controller && (f.current = t.waiting, l(!0)), p.current.onReady?.(t));
 			}
-		}).then((e) => {
-			!t && e && u(e);
+		}).then((t) => {
+			!e && t && d(t);
 		}), () => {
-			t = !0;
+			e = !0;
 		};
-	}, [o.url]), {
-		updateAvailable: s,
-		applyUpdate: n(() => {
-			let e = d.current;
+	}, [s.url, p]), {
+		updateAvailable: c,
+		applyUpdate: r(() => {
+			let e = f.current;
 			if (!e || typeof navigator > "u") return;
-			let n = !1;
+			let t = !1;
 			navigator.serviceWorker.addEventListener("controllerchange", () => {
-				n || (n = !0, window.location.reload());
-			}), t(e);
+				t || (t = !0, window.location.reload());
+			}), n(e);
 		}, []),
-		registration: l
+		registration: u
 	};
 }
 //#endregion
-export { o as useServiceWorkerUpdate };
+export { s as useServiceWorkerUpdate };
 
 //# sourceMappingURL=use-service-worker-update.js.map

package/dist/hooks/use-service-worker-update.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-service-worker-update.js","names":[],"sources":["../../src/hooks/use-service-worker-update.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport {\n    registerServiceWorker,\n    skipWaiting,\n    type RegisterServiceWorkerOptions,\n} from \"../sw/register-service-worker\";\n\n/**\n * Options for {@link useServiceWorkerUpdate}. Mirrors the registration options\n * minus the callbacks the hook owns internally (`onUpdate`); `onReady` and\n * `onError` still pass through for host-side logging.\n *\n * Leave `autoUpdate` off (the default): this hook exists to hand the reload\n * decision to the user, so a silent auto-reload would defeat the prompt.\n */\nexport type UseServiceWorkerUpdateOptions = Omit<RegisterServiceWorkerOptions, \"onUpdate\">;\n\n/** Reactive service-worker update state plus the apply action. */\nexport interface UseServiceWorkerUpdateResult {\n    /** `true` once a new worker has installed and is waiting to activate. */\n    updateAvailable: boolean;\n    /**\n     * Activate the waiting worker and reload the page once it takes control.\n     * No-op when no update is waiting.\n     */\n    applyUpdate: () => void;\n    /** The active registration, or `null` before it resolves / when unsupported. */\n    registration: ServiceWorkerRegistration | null;\n}\n\n/**\n * Register a service worker and expose a user-driven update flow.\n *\n * Wraps {@link registerServiceWorker}: when a fresh worker finishes installing\n * while the page is still controlled by the old one, `updateAvailable` flips to\n * `true`. Call `applyUpdate` — typically from an \"atualizar\" toast — to tell the\n * waiting worker to activate and reload the page once it takes control.\n *\n * Skips cleanly when the runtime has no service-worker support (`registration`\n * stays `null`, `updateAvailable` stays `false`).\n *\n * @param options - Registration options (`url` required); `autoUpdate` should\n *   stay off so the reload is user-confirmed.\n * @returns The update state and `applyUpdate` action.\n *\n * @example\n * const { updateAvailable, applyUpdate } = useServiceWorkerUpdate({ url: \"/sw.js\" });\n * return (\n *     <UpdatePrompt open={updateAvailable} onUpdate={applyUpdate} />\n * );\n */\nexport function useServiceWorkerUpdate(\n    options: UseServiceWorkerUpdateOptions,\n): UseServiceWorkerUpdateResult {\n    const [updateAvailable, setUpdateAvailable] = useState<boolean>(false);\n    const [registration, setRegistration] = useState<ServiceWorkerRegistration | null>(null);\n    const waitingRef = useRef<ServiceWorker | null>(null);\n\n    const optionsRef = useRef(options);\n    useEffect(() => {\n        optionsRef.current = options;\n    }, [options]);\n\n    useEffect(() => {\n        let cancelled = false;\n        void registerServiceWorker({\n            ...optionsRef.current,\n            onUpdate: (waiting, reg) => {\n                waitingRef.current = waiting;\n                setRegistration(reg);\n                setUpdateAvailable(true);\n            },\n            onReady: (reg) => {\n                if (cancelled) return;\n                setRegistration(reg);\n                if (reg.waiting && navigator.serviceWorker.controller) {\n                    waitingRef.current = reg.waiting;\n                    setUpdateAvailable(true);\n                }\n                optionsRef.current.onReady?.(reg);\n            },\n        }).then((reg) => {\n            if (!cancelled && reg) setRegistration(reg);\n        });\n        return () => {\n            cancelled = true;\n        };\n    }, [options.url]);\n\n    const applyUpdate = useCallback(() => {\n        const waiting = waitingRef.current;\n        if (!waiting || typeof navigator === \"undefined\") return;\n        let reloading = false;\n        navigator.serviceWorker.addEventListener(\"controllerchange\", () => {\n            if (reloading) return;\n            reloading = true;\n            window.location.reload();\n        });\n        skipWaiting(waiting);\n    }, []);\n\n    return { updateAvailable, applyUpdate, registration };\n}\n"],"mappings":";;;AAmDA,SAAgB,EACZ,GAC4B;CAC5B,IAAM,CAAC,GAAiB,KAAsB,EAAkB,EAAK,GAC/D,CAAC,GAAc,KAAmB,EAA2C,IAAI,GACjF,IAAa,EAA6B,IAAI,GAE9C,IAAa,EAAO,CAAO;CA2CjC,OA1CA,QAAgB;EACZ,EAAW,UAAU;CACzB,GAAG,CAAC,CAAO,CAAC,GAEZ,QAAgB;EACZ,IAAI,IAAY;EAoBhB,OAnBA,EAA2B;GACvB,GAAG,EAAW;GACd,WAAW,GAAS,MAAQ;IAGxB,AAFA,EAAW,UAAU,GACrB,EAAgB,CAAG,GACnB,EAAmB,EAAI;GAC3B;GACA,UAAU,MAAQ;IACV,MACJ,EAAgB,CAAG,GACf,EAAI,WAAW,UAAU,cAAc,eACvC,EAAW,UAAU,EAAI,SACzB,EAAmB,EAAI,IAE3B,EAAW,QAAQ,UAAU,CAAG;GACpC;EACJ,CAAC,CAAC,CAAC,MAAM,MAAQ;GACb,AAAI,CAAC,KAAa,KAAK,EAAgB,CAAG;EAC9C,CAAC,SACY;GACT,IAAY;EAChB;CACJ,GAAG,CAAC,EAAQ,GAAG,CAAC,GAcT;EAAE;EAAiB,aAZN,QAAkB;GAClC,IAAM,IAAU,EAAW;GAC3B,IAAI,CAAC,KAAW,OAAO,YAAc,KAAa;GAClD,IAAI,IAAY;GAMhB,AALA,UAAU,cAAc,iBAAiB,0BAA0B;IAC3D,MACJ,IAAY,IACZ,OAAO,SAAS,OAAO;GAC3B,CAAC,GACD,EAAY,CAAO;EACvB,GAAG,CAAC,CAEsB;EAAa;CAAa;AACxD"}
+{"version":3,"file":"use-service-worker-update.js","names":[],"sources":["../../src/hooks/use-service-worker-update.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\nimport {\n    registerServiceWorker,\n    skipWaiting,\n    type RegisterServiceWorkerOptions,\n} from \"../sw/register-service-worker\";\n\n/**\n * Options for {@link useServiceWorkerUpdate}. Mirrors the registration options\n * minus the callbacks the hook owns internally (`onUpdate`); `onReady` and\n * `onError` still pass through for host-side logging.\n *\n * Leave `autoUpdate` off (the default): this hook exists to hand the reload\n * decision to the user, so a silent auto-reload would defeat the prompt.\n */\nexport type UseServiceWorkerUpdateOptions = Omit<RegisterServiceWorkerOptions, \"onUpdate\">;\n\n/** Reactive service-worker update state plus the apply action. */\nexport interface UseServiceWorkerUpdateResult {\n    /** `true` once a new worker has installed and is waiting to activate. */\n    updateAvailable: boolean;\n    /**\n     * Activate the waiting worker and reload the page once it takes control.\n     * No-op when no update is waiting.\n     */\n    applyUpdate: () => void;\n    /** The active registration, or `null` before it resolves / when unsupported. */\n    registration: ServiceWorkerRegistration | null;\n}\n\n/**\n * Register a service worker and expose a user-driven update flow.\n *\n * Wraps {@link registerServiceWorker}: when a fresh worker finishes installing\n * while the page is still controlled by the old one, `updateAvailable` flips to\n * `true`. Call `applyUpdate` — typically from an \"atualizar\" toast — to tell the\n * waiting worker to activate and reload the page once it takes control.\n *\n * Skips cleanly when the runtime has no service-worker support (`registration`\n * stays `null`, `updateAvailable` stays `false`).\n *\n * @param options - Registration options (`url` required); `autoUpdate` should\n *   stay off so the reload is user-confirmed.\n * @returns The update state and `applyUpdate` action.\n *\n * @example\n * const { updateAvailable, applyUpdate } = useServiceWorkerUpdate({ url: \"/sw.js\" });\n * return (\n *     <UpdatePrompt open={updateAvailable} onUpdate={applyUpdate} />\n * );\n */\nexport function useServiceWorkerUpdate(\n    options: UseServiceWorkerUpdateOptions,\n): UseServiceWorkerUpdateResult {\n    const [updateAvailable, setUpdateAvailable] = useState<boolean>(false);\n    const [registration, setRegistration] = useState<ServiceWorkerRegistration | null>(null);\n    const waitingRef = useRef<ServiceWorker | null>(null);\n\n    const optionsRef = useLatestRef(options);\n\n    useEffect(() => {\n        let cancelled = false;\n        void registerServiceWorker({\n            ...optionsRef.current,\n            onUpdate: (waiting, reg) => {\n                waitingRef.current = waiting;\n                setRegistration(reg);\n                setUpdateAvailable(true);\n            },\n            onReady: (reg) => {\n                if (cancelled) return;\n                setRegistration(reg);\n                if (reg.waiting && navigator.serviceWorker.controller) {\n                    waitingRef.current = reg.waiting;\n                    setUpdateAvailable(true);\n                }\n                optionsRef.current.onReady?.(reg);\n            },\n        }).then((reg) => {\n            if (!cancelled && reg) setRegistration(reg);\n        });\n        return () => {\n            cancelled = true;\n        };\n    }, [options.url, optionsRef]);\n\n    const applyUpdate = useCallback(() => {\n        const waiting = waitingRef.current;\n        if (!waiting || typeof navigator === \"undefined\") return;\n        let reloading = false;\n        navigator.serviceWorker.addEventListener(\"controllerchange\", () => {\n            if (reloading) return;\n            reloading = true;\n            window.location.reload();\n        });\n        skipWaiting(waiting);\n    }, []);\n\n    return { updateAvailable, applyUpdate, registration };\n}\n"],"mappings":";;;;AAoDA,SAAgB,EACZ,GAC4B;CAC5B,IAAM,CAAC,GAAiB,KAAsB,EAAkB,EAAK,GAC/D,CAAC,GAAc,KAAmB,EAA2C,IAAI,GACjF,IAAa,EAA6B,IAAI,GAE9C,IAAa,EAAa,CAAO;CAwCvC,OAtCA,QAAgB;EACZ,IAAI,IAAY;EAoBhB,OAnBA,EAA2B;GACvB,GAAG,EAAW;GACd,WAAW,GAAS,MAAQ;IAGxB,AAFA,EAAW,UAAU,GACrB,EAAgB,CAAG,GACnB,EAAmB,EAAI;GAC3B;GACA,UAAU,MAAQ;IACV,MACJ,EAAgB,CAAG,GACf,EAAI,WAAW,UAAU,cAAc,eACvC,EAAW,UAAU,EAAI,SACzB,EAAmB,EAAI,IAE3B,EAAW,QAAQ,UAAU,CAAG;GACpC;EACJ,CAAC,CAAC,CAAC,MAAM,MAAQ;GACb,AAAI,CAAC,KAAa,KAAK,EAAgB,CAAG;EAC9C,CAAC,SACY;GACT,IAAY;EAChB;CACJ,GAAG,CAAC,EAAQ,KAAK,CAAU,CAAC,GAcrB;EAAE;EAAiB,aAZN,QAAkB;GAClC,IAAM,IAAU,EAAW;GAC3B,IAAI,CAAC,KAAW,OAAO,YAAc,KAAa;GAClD,IAAI,IAAY;GAMhB,AALA,UAAU,cAAc,iBAAiB,0BAA0B;IAC3D,MACJ,IAAY,IACZ,OAAO,SAAS,OAAO;GAC3B,CAAC,GACD,EAAY,CAAO;EACvB,GAAG,CAAC,CAEsB;EAAa;CAAa;AACxD"}

package/dist/hooks/use-stable-callback.cjs

@@ -1,2 +1,2 @@
-let e=require("react");function t(t){let n=(0,e.useRef)(t);return n.current=t,(0,e.useCallback)((...e)=>n.current(...e),[])}exports.useStableCallback=t;
+const e=require("./use-latest-ref.cjs");let t=require("react");function n(n){let r=e.useLatestRef(n);return(0,t.useCallback)((...e)=>r.current(...e),[r])}exports.useStableCallback=n;
 //# sourceMappingURL=use-stable-callback.cjs.map

package/dist/hooks/use-stable-callback.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-stable-callback.cjs","names":[],"sources":["../../src/hooks/use-stable-callback.ts"],"sourcesContent":["/* eslint-disable react-hooks/refs -- writing at render time is deliberate; an effect would add a staleness window (see the docstring) */\nimport { useCallback, useRef } from \"react\";\n\n/**\n * Returns a stable function reference that always invokes the latest\n * `callback` argument. Use to break dependency cycles in effects without\n * triggering re-runs when the callback identity changes.\n *\n * The assignment happens **during render** on purpose. Moving it into an effect\n * would satisfy the React Compiler rules but open a one-commit staleness window:\n * an effect declared before this hook's own effect, in the same commit, would call\n * the previous render's callback. This is a primitive other hooks build on, so a\n * subtle staleness here is worse than the rule violation. Prefer React's\n * `useEffectEvent` once it ships as stable.\n */\nexport function useStableCallback<TArgs extends unknown[], TReturn>(\n    callback: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n    const ref = useRef(callback);\n    ref.current = callback;\n    return useCallback((...args: TArgs) => ref.current(...args), []);\n}\n"],"mappings":"uBAeA,SAAgB,EACZ,EAC2B,CAC3B,IAAM,GAAA,EAAM,EAAA,OAAA,CAAO,CAAQ,EAE3B,MADA,GAAI,QAAU,GACd,EAAO,EAAA,YAAA,EAAa,GAAG,IAAgB,EAAI,QAAQ,GAAG,CAAI,EAAG,CAAC,CAAC,CACnE"}
+{"version":3,"file":"use-stable-callback.cjs","names":[],"sources":["../../src/hooks/use-stable-callback.ts"],"sourcesContent":["import { useCallback } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\n\n/**\n * Returns a stable function reference that always invokes the latest\n * `callback` argument. Use to break dependency cycles in effects without\n * triggering re-runs when the callback identity changes.\n *\n * Built on {@link useLatestRef}, which owns the render-time assignment and the\n * reason it is not an effect: an effect would satisfy the React Compiler rules\n * but open a one-commit staleness window. What this adds is the callable with a\n * stable identity, so callers do not reach through `.current`. Prefer React's\n * `useEffectEvent` once it ships as stable.\n *\n * The ref is listed as a dependency because it is one — a stable object across\n * renders, so the returned identity never changes. Listing it is what lets the\n * exhaustive-deps rule verify that instead of taking an empty array on trust.\n */\nexport function useStableCallback<TArgs extends unknown[], TReturn>(\n    callback: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n    const ref = useLatestRef(callback);\n    return useCallback((...args: TArgs) => ref.current(...args), [ref]);\n}\n"],"mappings":"+DAkBA,SAAgB,EACZ,EAC2B,CAC3B,IAAM,EAAM,EAAA,aAAa,CAAQ,EACjC,OAAA,EAAO,EAAA,YAAA,EAAa,GAAG,IAAgB,EAAI,QAAQ,GAAG,CAAI,EAAG,CAAC,CAAG,CAAC,CACtE"}

package/dist/hooks/use-stable-callback.js

@@ -1,8 +1,9 @@
-import { useCallback as e, useRef as t } from "react";
+import { useLatestRef as e } from "./use-latest-ref.js";
+import { useCallback as t } from "react";
 //#region src/hooks/use-stable-callback.ts
 function n(n) {
-	let r = t(n);
-	return r.current = n, e((...e) => r.current(...e), []);
+	let r = e(n);
+	return t((...e) => r.current(...e), [r]);
 }
 //#endregion
 export { n as useStableCallback };

package/dist/hooks/use-stable-callback.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-stable-callback.js","names":[],"sources":["../../src/hooks/use-stable-callback.ts"],"sourcesContent":["/* eslint-disable react-hooks/refs -- writing at render time is deliberate; an effect would add a staleness window (see the docstring) */\nimport { useCallback, useRef } from \"react\";\n\n/**\n * Returns a stable function reference that always invokes the latest\n * `callback` argument. Use to break dependency cycles in effects without\n * triggering re-runs when the callback identity changes.\n *\n * The assignment happens **during render** on purpose. Moving it into an effect\n * would satisfy the React Compiler rules but open a one-commit staleness window:\n * an effect declared before this hook's own effect, in the same commit, would call\n * the previous render's callback. This is a primitive other hooks build on, so a\n * subtle staleness here is worse than the rule violation. Prefer React's\n * `useEffectEvent` once it ships as stable.\n */\nexport function useStableCallback<TArgs extends unknown[], TReturn>(\n    callback: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n    const ref = useRef(callback);\n    ref.current = callback;\n    return useCallback((...args: TArgs) => ref.current(...args), []);\n}\n"],"mappings":";;AAeA,SAAgB,EACZ,GAC2B;CAC3B,IAAM,IAAM,EAAO,CAAQ;CAE3B,OADA,EAAI,UAAU,GACP,GAAa,GAAG,MAAgB,EAAI,QAAQ,GAAG,CAAI,GAAG,CAAC,CAAC;AACnE"}
+{"version":3,"file":"use-stable-callback.js","names":[],"sources":["../../src/hooks/use-stable-callback.ts"],"sourcesContent":["import { useCallback } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\n\n/**\n * Returns a stable function reference that always invokes the latest\n * `callback` argument. Use to break dependency cycles in effects without\n * triggering re-runs when the callback identity changes.\n *\n * Built on {@link useLatestRef}, which owns the render-time assignment and the\n * reason it is not an effect: an effect would satisfy the React Compiler rules\n * but open a one-commit staleness window. What this adds is the callable with a\n * stable identity, so callers do not reach through `.current`. Prefer React's\n * `useEffectEvent` once it ships as stable.\n *\n * The ref is listed as a dependency because it is one — a stable object across\n * renders, so the returned identity never changes. Listing it is what lets the\n * exhaustive-deps rule verify that instead of taking an empty array on trust.\n */\nexport function useStableCallback<TArgs extends unknown[], TReturn>(\n    callback: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n    const ref = useLatestRef(callback);\n    return useCallback((...args: TArgs) => ref.current(...args), [ref]);\n}\n"],"mappings":";;;AAkBA,SAAgB,EACZ,GAC2B;CAC3B,IAAM,IAAM,EAAa,CAAQ;CACjC,OAAO,GAAa,GAAG,MAAgB,EAAI,QAAQ,GAAG,CAAI,GAAG,CAAC,CAAG,CAAC;AACtE"}

package/dist/hooks/use-timeout.cjs

@@ -1,2 +1,2 @@
-let e=require("react");function t(t,n){let r=(0,e.useRef)(t);(0,e.useEffect)(()=>{r.current=t},[t]),(0,e.useEffect)(()=>{if(n===null)return;let e=setTimeout(()=>r.current(),n);return()=>clearTimeout(e)},[n])}exports.useTimeout=t;
+const e=require("./use-latest-ref.cjs");let t=require("react");function n(n,r){let i=e.useLatestRef(n);(0,t.useEffect)(()=>{if(r===null)return;let e=setTimeout(()=>i.current(),r);return()=>clearTimeout(e)},[r,i])}exports.useTimeout=n;
 //# sourceMappingURL=use-timeout.cjs.map

package/dist/hooks/use-timeout.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-timeout.cjs","names":[],"sources":["../../src/hooks/use-timeout.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\n\n/**\n * Run a callback after `delay` ms. Pass `null` to disable. Resets when\n * `delay` changes; the callback ref always points at the latest closure.\n *\n * @example\n * useTimeout(() => setShow(false), show ? 3000 : null);\n */\nexport function useTimeout(fn: () => void, delay: number | null): void {\n    const fnRef = useRef(fn);\n    useEffect(() => {\n        fnRef.current = fn;\n    }, [fn]);\n\n    useEffect(() => {\n        if (delay === null) return;\n        const id = setTimeout(() => fnRef.current(), delay);\n        return () => clearTimeout(id);\n    }, [delay]);\n}\n"],"mappings":"uBASA,SAAgB,EAAW,EAAgB,EAA4B,CACnE,IAAM,GAAA,EAAQ,EAAA,OAAA,CAAO,CAAE,GACvB,EAAA,EAAA,UAAA,KAAgB,CACZ,EAAM,QAAU,CACpB,EAAG,CAAC,CAAE,CAAC,GAEP,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,IAAU,KAAM,OACpB,IAAM,EAAK,eAAiB,EAAM,QAAQ,EAAG,CAAK,EAClD,UAAa,aAAa,CAAE,CAChC,EAAG,CAAC,CAAK,CAAC,CACd"}
+{"version":3,"file":"use-timeout.cjs","names":[],"sources":["../../src/hooks/use-timeout.ts"],"sourcesContent":["import { useEffect } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\n\n/**\n * Run a callback after `delay` ms. Pass `null` to disable. Resets when\n * `delay` changes; the callback ref always points at the latest closure.\n *\n * @example\n * useTimeout(() => setShow(false), show ? 3000 : null);\n */\nexport function useTimeout(fn: () => void, delay: number | null): void {\n    const fnRef = useLatestRef(fn);\n\n    useEffect(() => {\n        if (delay === null) return;\n        const id = setTimeout(() => fnRef.current(), delay);\n        return () => clearTimeout(id);\n    }, [delay, fnRef]);\n}\n"],"mappings":"+DAUA,SAAgB,EAAW,EAAgB,EAA4B,CACnE,IAAM,EAAQ,EAAA,aAAa,CAAE,GAE7B,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,IAAU,KAAM,OACpB,IAAM,EAAK,eAAiB,EAAM,QAAQ,EAAG,CAAK,EAClD,UAAa,aAAa,CAAE,CAChC,EAAG,CAAC,EAAO,CAAK,CAAC,CACrB"}

package/dist/hooks/use-timeout.js

@@ -1,14 +1,13 @@
-import { useEffect as e, useRef as t } from "react";
+import { useLatestRef as e } from "./use-latest-ref.js";
+import { useEffect as t } from "react";
 //#region src/hooks/use-timeout.ts
 function n(n, r) {
-	let i = t(n);
-	e(() => {
-		i.current = n;
-	}, [n]), e(() => {
+	let i = e(n);
+	t(() => {
 		if (r === null) return;
 		let e = setTimeout(() => i.current(), r);
 		return () => clearTimeout(e);
-	}, [r]);
+	}, [r, i]);
 }
 //#endregion
 export { n as useTimeout };

package/dist/hooks/use-timeout.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-timeout.js","names":[],"sources":["../../src/hooks/use-timeout.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\n\n/**\n * Run a callback after `delay` ms. Pass `null` to disable. Resets when\n * `delay` changes; the callback ref always points at the latest closure.\n *\n * @example\n * useTimeout(() => setShow(false), show ? 3000 : null);\n */\nexport function useTimeout(fn: () => void, delay: number | null): void {\n    const fnRef = useRef(fn);\n    useEffect(() => {\n        fnRef.current = fn;\n    }, [fn]);\n\n    useEffect(() => {\n        if (delay === null) return;\n        const id = setTimeout(() => fnRef.current(), delay);\n        return () => clearTimeout(id);\n    }, [delay]);\n}\n"],"mappings":";;AASA,SAAgB,EAAW,GAAgB,GAA4B;CACnE,IAAM,IAAQ,EAAO,CAAE;CAKvB,AAJA,QAAgB;EACZ,EAAM,UAAU;CACpB,GAAG,CAAC,CAAE,CAAC,GAEP,QAAgB;EACZ,IAAI,MAAU,MAAM;EACpB,IAAM,IAAK,iBAAiB,EAAM,QAAQ,GAAG,CAAK;EAClD,aAAa,aAAa,CAAE;CAChC,GAAG,CAAC,CAAK,CAAC;AACd"}
+{"version":3,"file":"use-timeout.js","names":[],"sources":["../../src/hooks/use-timeout.ts"],"sourcesContent":["import { useEffect } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\n\n/**\n * Run a callback after `delay` ms. Pass `null` to disable. Resets when\n * `delay` changes; the callback ref always points at the latest closure.\n *\n * @example\n * useTimeout(() => setShow(false), show ? 3000 : null);\n */\nexport function useTimeout(fn: () => void, delay: number | null): void {\n    const fnRef = useLatestRef(fn);\n\n    useEffect(() => {\n        if (delay === null) return;\n        const id = setTimeout(() => fnRef.current(), delay);\n        return () => clearTimeout(id);\n    }, [delay, fnRef]);\n}\n"],"mappings":";;;AAUA,SAAgB,EAAW,GAAgB,GAA4B;CACnE,IAAM,IAAQ,EAAa,CAAE;CAE7B,QAAgB;EACZ,IAAI,MAAU,MAAM;EACpB,IAAM,IAAK,iBAAiB,EAAM,QAAQ,GAAG,CAAK;EAClD,aAAa,aAAa,CAAE;CAChC,GAAG,CAAC,GAAO,CAAK,CAAC;AACrB"}

package/dist/hooks/use-typewriter.cjs

@@ -1,2 +1,2 @@
-let e=require("react");function t(t,n){let r=t??``,i=n>0?0:r.length,[a,o]=(0,e.useState)(r),[s,c]=(0,e.useState)(i);a!==r&&(o(r),c(i)),(0,e.useEffect)(()=>{if(n<=0||r.length===0){c(r.length);return}let e=setInterval(()=>{c(t=>{let n=t+1;return n>=r.length?(clearInterval(e),r.length):n})},n);return()=>clearInterval(e)},[r,n]);let l=(0,e.useCallback)(()=>c(r.length),[r.length]);return{displayedText:r.slice(0,s),isComplete:s>=r.length,skip:l}}exports.useTypewriter=t;
+const e=require("./use-interval.cjs");let t=require("react");function n(n,r){let i=n??``,a=r>0?0:i.length,[o,s]=(0,t.useState)(i),[c,l]=(0,t.useState)(a);o!==i&&(s(i),l(a));let u=r>0?Math.min(c,i.length):i.length;e.useInterval(()=>l(e=>e+1),r>0&&u<i.length?r:null);let d=(0,t.useCallback)(()=>l(i.length),[i.length]);return{displayedText:i.slice(0,u),isComplete:u>=i.length,skip:d}}exports.useTypewriter=n;
 //# sourceMappingURL=use-typewriter.cjs.map

package/dist/hooks/use-typewriter.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-typewriter.cjs","names":[],"sources":["../../src/hooks/use-typewriter.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\n/** State returned by {@link useTypewriter}. */\nexport interface UseTypewriterResult {\n    /** The prefix of `text` revealed so far. */\n    displayedText: string;\n    /** `true` once the whole string is on screen. */\n    isComplete: boolean;\n    /** Reveal the rest immediately — wire it to a tap or a key press. */\n    skip: () => void;\n}\n\n/**\n * Reveals a string one character at a time.\n *\n * Changing `text` restarts the reveal. The reset happens during render rather\n * than in an effect, so the new string never flashes in full for one frame\n * before the animation takes over.\n *\n * Always give the reader a way out: an animation that cannot be skipped is a\n * tax on anyone re-reading or moving fast, which is what `skip` is for.\n *\n * @param text - The full string to reveal. Nullish is treated as empty.\n * @param speedMs - Delay between characters. `0` or less renders instantly,\n *   which is the hook-safe way to honour `prefers-reduced-motion`.\n * @returns The revealed prefix, whether it finished, and a `skip` action.\n *\n * @example\n * const reduced = useMediaQuery(\"(prefers-reduced-motion: reduce)\");\n * const { displayedText, isComplete, skip } = useTypewriter(line, reduced ? 0 : 30);\n *\n * return <p onClick={skip}>{displayedText}{isComplete ? \"\" : \"▌\"}</p>;\n */\nexport function useTypewriter(text: string, speedMs: number): UseTypewriterResult {\n    const safeText = text ?? \"\";\n    const initialCount = speedMs > 0 ? 0 : safeText.length;\n\n    const [renderedText, setRenderedText] = useState(safeText);\n    const [count, setCount] = useState(initialCount);\n\n    if (renderedText !== safeText) {\n        setRenderedText(safeText);\n        setCount(initialCount);\n    }\n\n    useEffect(() => {\n        if (speedMs <= 0 || safeText.length === 0) {\n            setCount(safeText.length);\n            return;\n        }\n\n        const id = setInterval(() => {\n            setCount((current) => {\n                const next = current + 1;\n                if (next >= safeText.length) {\n                    clearInterval(id);\n                    return safeText.length;\n                }\n                return next;\n            });\n        }, speedMs);\n\n        return () => clearInterval(id);\n    }, [safeText, speedMs]);\n\n    const skip = useCallback(() => setCount(safeText.length), [safeText.length]);\n\n    return {\n        displayedText: safeText.slice(0, count),\n        isComplete: count >= safeText.length,\n        skip,\n    };\n}\n"],"mappings":"uBAiCA,SAAgB,EAAc,EAAc,EAAsC,CAC9E,IAAM,EAAW,GAAQ,GACnB,EAAe,EAAU,EAAI,EAAI,EAAS,OAE1C,CAAC,EAAc,IAAA,EAAmB,EAAA,SAAA,CAAS,CAAQ,EACnD,CAAC,EAAO,IAAA,EAAY,EAAA,SAAA,CAAS,CAAY,EAE3C,IAAiB,IACjB,EAAgB,CAAQ,EACxB,EAAS,CAAY,IAGzB,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,GAAW,GAAK,EAAS,SAAW,EAAG,CACvC,EAAS,EAAS,MAAM,EACxB,MACJ,CAEA,IAAM,EAAK,gBAAkB,CACzB,EAAU,GAAY,CAClB,IAAM,EAAO,EAAU,EAKvB,OAJI,GAAQ,EAAS,QACjB,cAAc,CAAE,EACT,EAAS,QAEb,CACX,CAAC,CACL,EAAG,CAAO,EAEV,UAAa,cAAc,CAAE,CACjC,EAAG,CAAC,EAAU,CAAO,CAAC,EAEtB,IAAM,GAAA,EAAO,EAAA,YAAA,KAAkB,EAAS,EAAS,MAAM,EAAG,CAAC,EAAS,MAAM,CAAC,EAE3E,MAAO,CACH,cAAe,EAAS,MAAM,EAAG,CAAK,EACtC,WAAY,GAAS,EAAS,OAC9B,MACJ,CACJ"}
+{"version":3,"file":"use-typewriter.cjs","names":[],"sources":["../../src/hooks/use-typewriter.ts"],"sourcesContent":["import { useCallback, useState } from \"react\";\nimport { useInterval } from \"./use-interval\";\n\n/** State returned by {@link useTypewriter}. */\nexport interface UseTypewriterResult {\n    /** The prefix of `text` revealed so far. */\n    displayedText: string;\n    /** `true` once the whole string is on screen. */\n    isComplete: boolean;\n    /** Reveal the rest immediately — wire it to a tap or a key press. */\n    skip: () => void;\n}\n\n/**\n * Reveals a string one character at a time.\n *\n * Changing `text` restarts the reveal. The reset happens during render rather\n * than in an effect, so the new string never flashes in full for one frame\n * before the animation takes over.\n *\n * Always give the reader a way out: an animation that cannot be skipped is a\n * tax on anyone re-reading or moving fast, which is what `skip` is for.\n *\n * How far the reveal got is derived rather than stored: a `speedMs` of `0` reads\n * as \"all of it\" without a state write, and `useInterval` pausing on a `null`\n * delay is what stops the timer at the end. Both used to need an effect that\n * cleared its own interval from inside a state updater.\n *\n * @param text - The full string to reveal. Nullish is treated as empty.\n * @param speedMs - Delay between characters. `0` or less renders instantly,\n *   which is the hook-safe way to honour `prefers-reduced-motion`.\n * @returns The revealed prefix, whether it finished, and a `skip` action.\n *\n * @example\n * const reduced = useMediaQuery(\"(prefers-reduced-motion: reduce)\");\n * const { displayedText, isComplete, skip } = useTypewriter(line, reduced ? 0 : 30);\n *\n * return <p onClick={skip}>{displayedText}{isComplete ? \"\" : \"▌\"}</p>;\n */\nexport function useTypewriter(text: string, speedMs: number): UseTypewriterResult {\n    const safeText = text ?? \"\";\n    const initialCount = speedMs > 0 ? 0 : safeText.length;\n\n    const [renderedText, setRenderedText] = useState(safeText);\n    const [count, setCount] = useState(initialCount);\n\n    if (renderedText !== safeText) {\n        setRenderedText(safeText);\n        setCount(initialCount);\n    }\n\n    const revealed = speedMs > 0 ? Math.min(count, safeText.length) : safeText.length;\n\n    useInterval(\n        () => setCount((current) => current + 1),\n        speedMs > 0 && revealed < safeText.length ? speedMs : null,\n    );\n\n    const skip = useCallback(() => setCount(safeText.length), [safeText.length]);\n\n    return {\n        displayedText: safeText.slice(0, revealed),\n        isComplete: revealed >= safeText.length,\n        skip,\n    };\n}\n"],"mappings":"6DAuCA,SAAgB,EAAc,EAAc,EAAsC,CAC9E,IAAM,EAAW,GAAQ,GACnB,EAAe,EAAU,EAAI,EAAI,EAAS,OAE1C,CAAC,EAAc,IAAA,EAAmB,EAAA,SAAA,CAAS,CAAQ,EACnD,CAAC,EAAO,IAAA,EAAY,EAAA,SAAA,CAAS,CAAY,EAE3C,IAAiB,IACjB,EAAgB,CAAQ,EACxB,EAAS,CAAY,GAGzB,IAAM,EAAW,EAAU,EAAI,KAAK,IAAI,EAAO,EAAS,MAAM,EAAI,EAAS,OAE3E,EAAA,gBACU,EAAU,GAAY,EAAU,CAAC,EACvC,EAAU,GAAK,EAAW,EAAS,OAAS,EAAU,IAC1D,EAEA,IAAM,GAAA,EAAO,EAAA,YAAA,KAAkB,EAAS,EAAS,MAAM,EAAG,CAAC,EAAS,MAAM,CAAC,EAE3E,MAAO,CACH,cAAe,EAAS,MAAM,EAAG,CAAQ,EACzC,WAAY,GAAY,EAAS,OACjC,MACJ,CACJ"}

package/dist/hooks/use-typewriter.js

@@ -1,25 +1,16 @@
-import { useCallback as e, useEffect as t, useState as n } from "react";
+import { useInterval as e } from "./use-interval.js";
+import { useCallback as t, useState as n } from "react";
 //#region src/hooks/use-typewriter.ts
 function r(r, i) {
 	let a = r ?? "", o = i > 0 ? 0 : a.length, [s, c] = n(a), [l, u] = n(o);
-	s !== a && (c(a), u(o)), t(() => {
-		if (i <= 0 || a.length === 0) {
-			u(a.length);
-			return;
-		}
-		let e = setInterval(() => {
-			u((t) => {
-				let n = t + 1;
-				return n >= a.length ? (clearInterval(e), a.length) : n;
-			});
-		}, i);
-		return () => clearInterval(e);
-	}, [a, i]);
-	let d = e(() => u(a.length), [a.length]);
+	s !== a && (c(a), u(o));
+	let d = i > 0 ? Math.min(l, a.length) : a.length;
+	e(() => u((e) => e + 1), i > 0 && d < a.length ? i : null);
+	let f = t(() => u(a.length), [a.length]);
 	return {
-		displayedText: a.slice(0, l),
-		isComplete: l >= a.length,
-		skip: d
+		displayedText: a.slice(0, d),
+		isComplete: d >= a.length,
+		skip: f
 	};
 }
 //#endregion

package/dist/hooks/use-typewriter.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-typewriter.js","names":[],"sources":["../../src/hooks/use-typewriter.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\n/** State returned by {@link useTypewriter}. */\nexport interface UseTypewriterResult {\n    /** The prefix of `text` revealed so far. */\n    displayedText: string;\n    /** `true` once the whole string is on screen. */\n    isComplete: boolean;\n    /** Reveal the rest immediately — wire it to a tap or a key press. */\n    skip: () => void;\n}\n\n/**\n * Reveals a string one character at a time.\n *\n * Changing `text` restarts the reveal. The reset happens during render rather\n * than in an effect, so the new string never flashes in full for one frame\n * before the animation takes over.\n *\n * Always give the reader a way out: an animation that cannot be skipped is a\n * tax on anyone re-reading or moving fast, which is what `skip` is for.\n *\n * @param text - The full string to reveal. Nullish is treated as empty.\n * @param speedMs - Delay between characters. `0` or less renders instantly,\n *   which is the hook-safe way to honour `prefers-reduced-motion`.\n * @returns The revealed prefix, whether it finished, and a `skip` action.\n *\n * @example\n * const reduced = useMediaQuery(\"(prefers-reduced-motion: reduce)\");\n * const { displayedText, isComplete, skip } = useTypewriter(line, reduced ? 0 : 30);\n *\n * return <p onClick={skip}>{displayedText}{isComplete ? \"\" : \"▌\"}</p>;\n */\nexport function useTypewriter(text: string, speedMs: number): UseTypewriterResult {\n    const safeText = text ?? \"\";\n    const initialCount = speedMs > 0 ? 0 : safeText.length;\n\n    const [renderedText, setRenderedText] = useState(safeText);\n    const [count, setCount] = useState(initialCount);\n\n    if (renderedText !== safeText) {\n        setRenderedText(safeText);\n        setCount(initialCount);\n    }\n\n    useEffect(() => {\n        if (speedMs <= 0 || safeText.length === 0) {\n            setCount(safeText.length);\n            return;\n        }\n\n        const id = setInterval(() => {\n            setCount((current) => {\n                const next = current + 1;\n                if (next >= safeText.length) {\n                    clearInterval(id);\n                    return safeText.length;\n                }\n                return next;\n            });\n        }, speedMs);\n\n        return () => clearInterval(id);\n    }, [safeText, speedMs]);\n\n    const skip = useCallback(() => setCount(safeText.length), [safeText.length]);\n\n    return {\n        displayedText: safeText.slice(0, count),\n        isComplete: count >= safeText.length,\n        skip,\n    };\n}\n"],"mappings":";;AAiCA,SAAgB,EAAc,GAAc,GAAsC;CAC9E,IAAM,IAAW,KAAQ,IACnB,IAAe,IAAU,IAAI,IAAI,EAAS,QAE1C,CAAC,GAAc,KAAmB,EAAS,CAAQ,GACnD,CAAC,GAAO,KAAY,EAAS,CAAY;CAO/C,AALI,MAAiB,MACjB,EAAgB,CAAQ,GACxB,EAAS,CAAY,IAGzB,QAAgB;EACZ,IAAI,KAAW,KAAK,EAAS,WAAW,GAAG;GACvC,EAAS,EAAS,MAAM;GACxB;EACJ;EAEA,IAAM,IAAK,kBAAkB;GACzB,GAAU,MAAY;IAClB,IAAM,IAAO,IAAU;IAKvB,OAJI,KAAQ,EAAS,UACjB,cAAc,CAAE,GACT,EAAS,UAEb;GACX,CAAC;EACL,GAAG,CAAO;EAEV,aAAa,cAAc,CAAE;CACjC,GAAG,CAAC,GAAU,CAAO,CAAC;CAEtB,IAAM,IAAO,QAAkB,EAAS,EAAS,MAAM,GAAG,CAAC,EAAS,MAAM,CAAC;CAE3E,OAAO;EACH,eAAe,EAAS,MAAM,GAAG,CAAK;EACtC,YAAY,KAAS,EAAS;EAC9B;CACJ;AACJ"}
+{"version":3,"file":"use-typewriter.js","names":[],"sources":["../../src/hooks/use-typewriter.ts"],"sourcesContent":["import { useCallback, useState } from \"react\";\nimport { useInterval } from \"./use-interval\";\n\n/** State returned by {@link useTypewriter}. */\nexport interface UseTypewriterResult {\n    /** The prefix of `text` revealed so far. */\n    displayedText: string;\n    /** `true` once the whole string is on screen. */\n    isComplete: boolean;\n    /** Reveal the rest immediately — wire it to a tap or a key press. */\n    skip: () => void;\n}\n\n/**\n * Reveals a string one character at a time.\n *\n * Changing `text` restarts the reveal. The reset happens during render rather\n * than in an effect, so the new string never flashes in full for one frame\n * before the animation takes over.\n *\n * Always give the reader a way out: an animation that cannot be skipped is a\n * tax on anyone re-reading or moving fast, which is what `skip` is for.\n *\n * How far the reveal got is derived rather than stored: a `speedMs` of `0` reads\n * as \"all of it\" without a state write, and `useInterval` pausing on a `null`\n * delay is what stops the timer at the end. Both used to need an effect that\n * cleared its own interval from inside a state updater.\n *\n * @param text - The full string to reveal. Nullish is treated as empty.\n * @param speedMs - Delay between characters. `0` or less renders instantly,\n *   which is the hook-safe way to honour `prefers-reduced-motion`.\n * @returns The revealed prefix, whether it finished, and a `skip` action.\n *\n * @example\n * const reduced = useMediaQuery(\"(prefers-reduced-motion: reduce)\");\n * const { displayedText, isComplete, skip } = useTypewriter(line, reduced ? 0 : 30);\n *\n * return <p onClick={skip}>{displayedText}{isComplete ? \"\" : \"▌\"}</p>;\n */\nexport function useTypewriter(text: string, speedMs: number): UseTypewriterResult {\n    const safeText = text ?? \"\";\n    const initialCount = speedMs > 0 ? 0 : safeText.length;\n\n    const [renderedText, setRenderedText] = useState(safeText);\n    const [count, setCount] = useState(initialCount);\n\n    if (renderedText !== safeText) {\n        setRenderedText(safeText);\n        setCount(initialCount);\n    }\n\n    const revealed = speedMs > 0 ? Math.min(count, safeText.length) : safeText.length;\n\n    useInterval(\n        () => setCount((current) => current + 1),\n        speedMs > 0 && revealed < safeText.length ? speedMs : null,\n    );\n\n    const skip = useCallback(() => setCount(safeText.length), [safeText.length]);\n\n    return {\n        displayedText: safeText.slice(0, revealed),\n        isComplete: revealed >= safeText.length,\n        skip,\n    };\n}\n"],"mappings":";;;AAuCA,SAAgB,EAAc,GAAc,GAAsC;CAC9E,IAAM,IAAW,KAAQ,IACnB,IAAe,IAAU,IAAI,IAAI,EAAS,QAE1C,CAAC,GAAc,KAAmB,EAAS,CAAQ,GACnD,CAAC,GAAO,KAAY,EAAS,CAAY;CAE/C,AAAI,MAAiB,MACjB,EAAgB,CAAQ,GACxB,EAAS,CAAY;CAGzB,IAAM,IAAW,IAAU,IAAI,KAAK,IAAI,GAAO,EAAS,MAAM,IAAI,EAAS;CAE3E,QACU,GAAU,MAAY,IAAU,CAAC,GACvC,IAAU,KAAK,IAAW,EAAS,SAAS,IAAU,IAC1D;CAEA,IAAM,IAAO,QAAkB,EAAS,EAAS,MAAM,GAAG,CAAC,EAAS,MAAM,CAAC;CAE3E,OAAO;EACH,eAAe,EAAS,MAAM,GAAG,CAAQ;EACzC,YAAY,KAAY,EAAS;EACjC;CACJ;AACJ"}

package/dist/http/api-client.cjs

@@ -1,2 +1,2 @@
-const e=require("../utils/ids.cjs"),t=require("./build-url.cjs"),n=require("./errors.cjs"),r=require("./retry.cjs");var i=new Set([`GET`,`HEAD`,`OPTIONS`]),a=new Set([0,408,425,429]);function o(e,t){return!i.has(t)||!(e instanceof n.TempestApiError)?!1:a.has(e.status)||e.status>=500}function s(e){return e?e===!0?{}:e:null}function c(e){return typeof FormData<`u`&&e instanceof FormData}function l(e){return Math.round(performance.now()-e)}async function u(e,t){let r;try{r=await e.clone().json()}catch{try{r=await e.text()}catch{r=null}}return new n.TempestApiError(n.buildApiError(e.status,r,e.headers,t))}function d(n){let i=n.fetcher??globalThis.fetch.bind(globalThis);function a(){let e=n.getToken?.();return e?{Authorization:`Bearer ${e}`}:{}}async function d(e,r,o){let{body:s,params:l,headers:u,...d}=r,f=c(s),p={...f?{}:{"Content-Type":`application/json`},...o?{"X-Request-ID":o}:{},...n.headers,...a(),...u},m={...d,headers:p,credentials:n.withCredentials?`include`:d.credentials,body:s==null?void 0:f?s:JSON.stringify(s)};return i(t.buildApiUrl(n.baseURL,e,{prefix:n.prefix,params:l}),m)}async function f(e,t,r,i){let a=n.logger;if(!a)return d(e,t,r);let o=performance.now();try{let n=await d(e,t,r),s={requestId:r,status:n.status,ms:l(o)},c=`${i} ${e} → ${n.status}`;return n.status>=400?a.warn(c,s):a.debug(c,s),n}catch(t){throw a.warn(`${i} ${e} → no response`,{requestId:r,ms:l(o),error:t}),t}}async function p(e,t){if(n.onUnauthorized){n.logger?.warn(`unauthorized — calling onUnauthorized`,{requestId:t,status:e.status});try{await n.onUnauthorized(e)}catch(r){n.logger?.warn(`onUnauthorized threw — keeping the original response error`,{requestId:t,status:e.status,error:r})}}}async function m(t,r){let i=n.requestId?n.requestId():e.randomId(),a=(r.method??`GET`).toUpperCase(),o=await f(t,r,i,a);if(o.status===401){if(n.refresh){try{await n.refresh(),o=await f(t,r,i,a)}catch{throw await p(o,i),await u(o,i)}o.status===401&&await p(o,i)}else await p(o,i)}if(!o.ok)throw await u(o,i);if(o.status!==204)return(o.headers.get(`content-type`)??``).includes(`application/json`)?await o.json():await o.text()}async function h(e,t={}){let i=s(n.retry);if(!i)return m(e,t);let a=(t.method??`GET`).toUpperCase();return r.retry(()=>m(e,t),{...i,shouldRetry:i.shouldRetry??(e=>o(e,a))})}async function g(e,t,n=`POST`){return h(e,{method:n,body:t})}return{request:h,get:(e,t)=>h(e,{...t,method:`GET`}),post:(e,t)=>h(e,{...t,method:`POST`}),put:(e,t)=>h(e,{...t,method:`PUT`}),patch:(e,t)=>h(e,{...t,method:`PATCH`}),delete:(e,t)=>h(e,{...t,method:`DELETE`}),upload:g}}exports.createApiClient=d;
+const e=require("../utils/ids.cjs"),t=require("./build-url.cjs"),n=require("./errors.cjs"),r=require("./retry.cjs");var i=new Set([`GET`,`HEAD`,`OPTIONS`]);function a(e,t){return!i.has(t)||!(e instanceof n.TempestApiError)?!1:n.isRetriableStatus(e.status)}function o(e){return e?e===!0?{}:e:null}function s(e){return typeof FormData<`u`&&e instanceof FormData}function c(e){return Math.round(performance.now()-e)}async function l(e,t){let r;try{r=await e.clone().json()}catch{try{r=await e.text()}catch{r=null}}return new n.TempestApiError(n.buildApiError(e.status,r,e.headers,t))}function u(n){let i=n.fetcher??globalThis.fetch.bind(globalThis);function u(){let e=n.getToken?.();return e?{Authorization:`Bearer ${e}`}:{}}async function d(e,r,a){let{body:o,params:c,headers:l,...d}=r,f=s(o),p={...f?{}:{"Content-Type":`application/json`},...a?{"X-Request-ID":a}:{},...n.headers,...u(),...l},m={...d,headers:p,credentials:n.withCredentials?`include`:d.credentials,body:o==null?void 0:f?o:JSON.stringify(o)};return i(t.buildApiUrl(n.baseURL,e,{prefix:n.prefix,params:c}),m)}async function f(e,t,r,i){let a=n.logger;if(!a)return d(e,t,r);let o=performance.now();try{let n=await d(e,t,r),s={requestId:r,status:n.status,ms:c(o)},l=`${i} ${e} → ${n.status}`;return n.status>=400?a.warn(l,s):a.debug(l,s),n}catch(t){throw a.warn(`${i} ${e} → no response`,{requestId:r,ms:c(o),error:t}),t}}async function p(e,t){if(n.onUnauthorized){n.logger?.warn(`unauthorized — calling onUnauthorized`,{requestId:t,status:e.status});try{await n.onUnauthorized(e)}catch(r){n.logger?.warn(`onUnauthorized threw — keeping the original response error`,{requestId:t,status:e.status,error:r})}}}async function m(t,r){let i=n.requestId?n.requestId():e.randomId(),a=(r.method??`GET`).toUpperCase(),o=await f(t,r,i,a);if(o.status===401){if(n.refresh){try{await n.refresh(),o=await f(t,r,i,a)}catch{throw await p(o,i),await l(o,i)}o.status===401&&await p(o,i)}else await p(o,i)}if(!o.ok)throw await l(o,i);if(o.status!==204)return(o.headers.get(`content-type`)??``).includes(`application/json`)?await o.json():await o.text()}async function h(e,t={}){let i=o(n.retry);if(!i)return m(e,t);let s=(t.method??`GET`).toUpperCase();return r.retry(()=>m(e,t),{...i,shouldRetry:i.shouldRetry??(e=>a(e,s))})}async function g(e,t,n=`POST`){return h(e,{method:n,body:t})}return{request:h,get:(e,t)=>h(e,{...t,method:`GET`}),post:(e,t)=>h(e,{...t,method:`POST`}),put:(e,t)=>h(e,{...t,method:`PUT`}),patch:(e,t)=>h(e,{...t,method:`PATCH`}),delete:(e,t)=>h(e,{...t,method:`DELETE`}),upload:g}}exports.createApiClient=u;
 //# sourceMappingURL=api-client.cjs.map

package/dist/http/api-client.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"api-client.cjs","names":[],"sources":["../../src/http/api-client.ts"],"sourcesContent":["/**\n * @tempest-limits function-lines — createApiClient is over the limit and every line\n * is a request-lifecycle concern the client cannot delegate: base URL joining, the\n * auth header, the 401 refresh-and-replay, the opt-in retry wrapper and the response\n * parsing that turns a failure into a typed error.\n */\nimport { randomId } from \"../utils\";\nimport { buildApiUrl } from \"./build-url\";\nimport { buildApiError, TempestApiError } from \"./errors\";\nimport { retry as retryWithBackoff } from \"./retry\";\nimport type { RetryOptions } from \"./retry\";\nimport type { ApiClient, ApiClientConfig, RequestOptions } from \"./types\";\n\n/**\n * Methods the built-in retry policy will replay.\n *\n * `PUT` and `DELETE` are idempotent on paper but stay out: a backend that logs,\n * bills, or fires a webhook per call still sees two, so replaying them is a\n * decision the caller makes through `shouldRetry`, not a default.\n */\nconst IDEMPOTENT_METHODS: ReadonlySet<string> = new Set([\"GET\", \"HEAD\", \"OPTIONS\"]);\n\n/**\n * Sub-500 statuses worth a second attempt: a network failure (status `0`), a\n * request timeout, a too-early replay, and a rate limit — which usually carries\n * the `Retry-After` the backoff already honours.\n */\nconst RETRIABLE_STATUSES: ReadonlySet<number> = new Set([0, 408, 425, 429]);\n\n/**\n * The built-in retry policy, used when `retry` is `true` or is options carrying\n * no `shouldRetry` of their own.\n *\n * Conservative on purpose. Replaying a write can duplicate it, and replaying a\n * `400` or a `403` cannot fix a bad payload or a permission the caller does not\n * have — it only spends the user's time before showing the same error.\n *\n * @param error - Whatever the attempt threw.\n * @param method - The upper-cased HTTP method of the request.\n * @returns Whether the client should try again.\n */\nfunction isRetriableFailure(error: unknown, method: string): boolean {\n    if (!IDEMPOTENT_METHODS.has(method)) return false;\n    if (!(error instanceof TempestApiError)) return false;\n    return RETRIABLE_STATUSES.has(error.status) || error.status >= 500;\n}\n\n/**\n * Normalize the `retry` config into options, or `null` when retrying is off.\n *\n * @param config - The `retry` field as the caller wrote it.\n * @returns Retry options to use, or `null` to run a single attempt.\n */\nfunction resolveRetry(config: boolean | RetryOptions | undefined): RetryOptions | null {\n    if (!config) return null;\n    return config === true ? {} : config;\n}\n\nfunction isFormData(body: unknown): body is FormData {\n    return typeof FormData !== \"undefined\" && body instanceof FormData;\n}\n\n/**\n * Milliseconds since a `performance.now()` reading, rounded.\n *\n * `performance.now()` rather than `Date.now()` because this measures a\n * duration: the wall clock can step sideways mid-request (an NTP correction, a\n * VM resuming, the user changing the clock) and turn a 40 ms call into a\n * negative number. The monotonic clock cannot.\n *\n * @param startedAt - The reading taken before the work started.\n * @returns Whole milliseconds elapsed.\n */\nfunction elapsedMs(startedAt: number): number {\n    return Math.round(performance.now() - startedAt);\n}\n\nasync function parseError(response: Response, sentRequestId?: string): Promise<TempestApiError> {\n    let body: unknown;\n    try {\n        body = await response.clone().json();\n    } catch {\n        try {\n            body = await response.text();\n        } catch {\n            body = null;\n        }\n    }\n    return new TempestApiError(\n        buildApiError(response.status, body, response.headers, sentRequestId),\n    );\n}\n\n/**\n * Create a typed HTTP client backed by `fetch`.\n *\n * Handles JSON serialization, query params, bearer auth via `getToken`, uploads\n * via `FormData`, and throws a typed `ApiError` on any non-2xx response.\n *\n * **Expired sessions.** A `401` with `refresh` configured awaits the refresh and\n * replays the request once. `onUnauthorized` fires whenever that path ends\n * unauthorized anyway — the refresh threw, or the replay came back `401` — which\n * is the signal to clear the session. Without `refresh`, the first `401` calls\n * it directly.\n *\n * **Retries** are off unless you set `retry`. See {@link ApiClientConfig.retry}\n * for the built-in policy; it never replays a write.\n *\n * **Logging** is off unless you pass a `logger`. With one, every finished attempt\n * writes a line — `debug` under 400, `warn` from 400 up, plus a `warn` when\n * `onUnauthorized` fires — carrying `requestId`, `status` and elapsed `ms`, and\n * never a body, header or query string. The level and the destination belong to\n * the logger, not to a boolean here.\n *\n * @example\n * const api = createApiClient({\n *     baseURL: import.meta.env.VITE_API_URL,\n *     getToken: () => useAuthStore.getState().token,\n *     refresh,\n *     onUnauthorized: () => useAuthStore.getState().logout(),\n *     logger: createLogger({ level: import.meta.env.DEV ? \"debug\" : \"warn\" }).child(\"http\"),\n *     retry: true,\n * });\n *\n * @param config - Base URL plus the optional auth, retry and fetch hooks.\n * @returns A client with `request`/`get`/`post`/`put`/`patch`/`delete`/`upload`.\n */\nexport function createApiClient(config: ApiClientConfig): ApiClient {\n    const fetcher = config.fetcher ?? globalThis.fetch.bind(globalThis);\n\n    function authHeaders(): Record<string, string> {\n        const token = config.getToken?.();\n        return token ? { Authorization: `Bearer ${token}` } : {};\n    }\n\n    async function rawRequest(\n        path: string,\n        options: RequestOptions,\n        requestId?: string,\n    ): Promise<Response> {\n        const { body, params, headers, ...rest } = options;\n        const isForm = isFormData(body);\n\n        const finalHeaders: Record<string, string> = {\n            ...(isForm ? {} : { \"Content-Type\": \"application/json\" }),\n            ...(requestId ? { \"X-Request-ID\": requestId } : {}),\n            ...config.headers,\n            ...authHeaders(),\n            ...(headers as Record<string, string> | undefined),\n        };\n\n        const init: RequestInit = {\n            ...rest,\n            headers: finalHeaders,\n            credentials: config.withCredentials ? \"include\" : rest.credentials,\n            body:\n                body === undefined || body === null\n                    ? undefined\n                    : isForm\n                      ? (body as FormData)\n                      : JSON.stringify(body),\n        };\n\n        return fetcher(buildApiUrl(config.baseURL, path, { prefix: config.prefix, params }), init);\n    }\n\n    async function send(\n        path: string,\n        options: RequestOptions,\n        requestId: string,\n        method: string,\n    ): Promise<Response> {\n        const log = config.logger;\n        if (!log) return rawRequest(path, options, requestId);\n\n        const startedAt = performance.now();\n        try {\n            const response = await rawRequest(path, options, requestId);\n            const entry = { requestId, status: response.status, ms: elapsedMs(startedAt) };\n            const line = `${method} ${path} → ${response.status}`;\n            if (response.status >= 400) log.warn(line, entry);\n            else log.debug(line, entry);\n            return response;\n        } catch (error) {\n            log.warn(`${method} ${path} → no response`, {\n                requestId,\n                ms: elapsedMs(startedAt),\n                error,\n            });\n            throw error;\n        }\n    }\n\n    async function notifyUnauthorized(response: Response, requestId: string): Promise<void> {\n        if (!config.onUnauthorized) return;\n        config.logger?.warn(`unauthorized — calling onUnauthorized`, {\n            requestId,\n            status: response.status,\n        });\n        try {\n            await config.onUnauthorized(response);\n        } catch (error) {\n            config.logger?.warn(`onUnauthorized threw — keeping the original response error`, {\n                requestId,\n                status: response.status,\n                error,\n            });\n        }\n    }\n\n    async function attempt<T>(path: string, options: RequestOptions): Promise<T> {\n        const requestId = config.requestId ? config.requestId() : randomId();\n        const method = (options.method ?? \"GET\").toUpperCase();\n        let response = await send(path, options, requestId, method);\n\n        if (response.status === 401) {\n            if (config.refresh) {\n                try {\n                    await config.refresh();\n                    response = await send(path, options, requestId, method);\n                } catch {\n                    await notifyUnauthorized(response, requestId);\n                    throw await parseError(response, requestId);\n                }\n                if (response.status === 401) {\n                    await notifyUnauthorized(response, requestId);\n                }\n            } else {\n                await notifyUnauthorized(response, requestId);\n            }\n        }\n\n        if (!response.ok) {\n            throw await parseError(response, requestId);\n        }\n\n        if (response.status === 204) {\n            return undefined as T;\n        }\n\n        const contentType = response.headers.get(\"content-type\") ?? \"\";\n        if (contentType.includes(\"application/json\")) {\n            return (await response.json()) as T;\n        }\n        return (await response.text()) as unknown as T;\n    }\n\n    async function request<T>(path: string, options: RequestOptions = {}): Promise<T> {\n        const retryOptions = resolveRetry(config.retry);\n        if (!retryOptions) return attempt<T>(path, options);\n\n        const method = (options.method ?? \"GET\").toUpperCase();\n        return retryWithBackoff(() => attempt<T>(path, options), {\n            ...retryOptions,\n            shouldRetry:\n                retryOptions.shouldRetry ?? ((error: unknown) => isRetriableFailure(error, method)),\n        });\n    }\n\n    async function upload<T>(\n        path: string,\n        formData: FormData,\n        method: \"POST\" | \"PUT\" | \"PATCH\" = \"POST\",\n    ): Promise<T> {\n        return request<T>(path, { method, body: formData });\n    }\n\n    return {\n        request,\n        get: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"GET\" }),\n        post: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"POST\" }),\n        put: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"PUT\" }),\n        patch: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"PATCH\" }),\n        delete: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"DELETE\" }),\n        upload,\n    };\n}\n"],"mappings":"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"}
+{"version":3,"file":"api-client.cjs","names":[],"sources":["../../src/http/api-client.ts"],"sourcesContent":["/**\n * @tempest-limits function-lines — createApiClient is over the limit and every line\n * is a request-lifecycle concern the client cannot delegate: base URL joining, the\n * auth header, the 401 refresh-and-replay, the opt-in retry wrapper and the response\n * parsing that turns a failure into a typed error.\n */\nimport { randomId } from \"../utils\";\nimport { buildApiUrl } from \"./build-url\";\nimport { buildApiError, TempestApiError, isRetriableStatus } from \"./errors\";\nimport { retry as retryWithBackoff } from \"./retry\";\nimport type { RetryOptions } from \"./retry\";\nimport type { ApiClient, ApiClientConfig, RequestOptions } from \"./types\";\n\n/**\n * Methods the built-in retry policy will replay.\n *\n * `PUT` and `DELETE` are idempotent on paper but stay out: a backend that logs,\n * bills, or fires a webhook per call still sees two, so replaying them is a\n * decision the caller makes through `shouldRetry`, not a default.\n */\nconst IDEMPOTENT_METHODS: ReadonlySet<string> = new Set([\"GET\", \"HEAD\", \"OPTIONS\"]);\n\n/**\n * Sub-500 statuses worth a second attempt: a network failure (status `0`), a\n * request timeout, a too-early replay, and a rate limit — which usually carries\n * the `Retry-After` the backoff already honours.\n */\n\n/**\n * The built-in retry policy, used when `retry` is `true` or is options carrying\n * no `shouldRetry` of their own.\n *\n * Conservative on purpose. Replaying a write can duplicate it, and replaying a\n * `400` or a `403` cannot fix a bad payload or a permission the caller does not\n * have — it only spends the user's time before showing the same error.\n *\n * @param error - Whatever the attempt threw.\n * @param method - The upper-cased HTTP method of the request.\n * @returns Whether the client should try again.\n */\nfunction isRetriableFailure(error: unknown, method: string): boolean {\n    if (!IDEMPOTENT_METHODS.has(method)) return false;\n    if (!(error instanceof TempestApiError)) return false;\n    return isRetriableStatus(error.status);\n}\n\n/**\n * Normalize the `retry` config into options, or `null` when retrying is off.\n *\n * @param config - The `retry` field as the caller wrote it.\n * @returns Retry options to use, or `null` to run a single attempt.\n */\nfunction resolveRetry(config: boolean | RetryOptions | undefined): RetryOptions | null {\n    if (!config) return null;\n    return config === true ? {} : config;\n}\n\nfunction isFormData(body: unknown): body is FormData {\n    return typeof FormData !== \"undefined\" && body instanceof FormData;\n}\n\n/**\n * Milliseconds since a `performance.now()` reading, rounded.\n *\n * `performance.now()` rather than `Date.now()` because this measures a\n * duration: the wall clock can step sideways mid-request (an NTP correction, a\n * VM resuming, the user changing the clock) and turn a 40 ms call into a\n * negative number. The monotonic clock cannot.\n *\n * @param startedAt - The reading taken before the work started.\n * @returns Whole milliseconds elapsed.\n */\nfunction elapsedMs(startedAt: number): number {\n    return Math.round(performance.now() - startedAt);\n}\n\nasync function parseError(response: Response, sentRequestId?: string): Promise<TempestApiError> {\n    let body: unknown;\n    try {\n        body = await response.clone().json();\n    } catch {\n        try {\n            body = await response.text();\n        } catch {\n            body = null;\n        }\n    }\n    return new TempestApiError(\n        buildApiError(response.status, body, response.headers, sentRequestId),\n    );\n}\n\n/**\n * Create a typed HTTP client backed by `fetch`.\n *\n * Handles JSON serialization, query params, bearer auth via `getToken`, uploads\n * via `FormData`, and throws a typed `ApiError` on any non-2xx response.\n *\n * **Expired sessions.** A `401` with `refresh` configured awaits the refresh and\n * replays the request once. `onUnauthorized` fires whenever that path ends\n * unauthorized anyway — the refresh threw, or the replay came back `401` — which\n * is the signal to clear the session. Without `refresh`, the first `401` calls\n * it directly.\n *\n * **Retries** are off unless you set `retry`. See {@link ApiClientConfig.retry}\n * for the built-in policy; it never replays a write.\n *\n * **Logging** is off unless you pass a `logger`. With one, every finished attempt\n * writes a line — `debug` under 400, `warn` from 400 up, plus a `warn` when\n * `onUnauthorized` fires — carrying `requestId`, `status` and elapsed `ms`, and\n * never a body, header or query string. The level and the destination belong to\n * the logger, not to a boolean here.\n *\n * @example\n * const api = createApiClient({\n *     baseURL: import.meta.env.VITE_API_URL,\n *     getToken: () => useAuthStore.getState().token,\n *     refresh,\n *     onUnauthorized: () => useAuthStore.getState().logout(),\n *     logger: createLogger({ level: import.meta.env.DEV ? \"debug\" : \"warn\" }).child(\"http\"),\n *     retry: true,\n * });\n *\n * @param config - Base URL plus the optional auth, retry and fetch hooks.\n * @returns A client with `request`/`get`/`post`/`put`/`patch`/`delete`/`upload`.\n */\nexport function createApiClient(config: ApiClientConfig): ApiClient {\n    const fetcher = config.fetcher ?? globalThis.fetch.bind(globalThis);\n\n    function authHeaders(): Record<string, string> {\n        const token = config.getToken?.();\n        return token ? { Authorization: `Bearer ${token}` } : {};\n    }\n\n    async function rawRequest(\n        path: string,\n        options: RequestOptions,\n        requestId?: string,\n    ): Promise<Response> {\n        const { body, params, headers, ...rest } = options;\n        const isForm = isFormData(body);\n\n        const finalHeaders: Record<string, string> = {\n            ...(isForm ? {} : { \"Content-Type\": \"application/json\" }),\n            ...(requestId ? { \"X-Request-ID\": requestId } : {}),\n            ...config.headers,\n            ...authHeaders(),\n            ...(headers as Record<string, string> | undefined),\n        };\n\n        const init: RequestInit = {\n            ...rest,\n            headers: finalHeaders,\n            credentials: config.withCredentials ? \"include\" : rest.credentials,\n            body:\n                body === undefined || body === null\n                    ? undefined\n                    : isForm\n                      ? (body as FormData)\n                      : JSON.stringify(body),\n        };\n\n        return fetcher(buildApiUrl(config.baseURL, path, { prefix: config.prefix, params }), init);\n    }\n\n    async function send(\n        path: string,\n        options: RequestOptions,\n        requestId: string,\n        method: string,\n    ): Promise<Response> {\n        const log = config.logger;\n        if (!log) return rawRequest(path, options, requestId);\n\n        const startedAt = performance.now();\n        try {\n            const response = await rawRequest(path, options, requestId);\n            const entry = { requestId, status: response.status, ms: elapsedMs(startedAt) };\n            const line = `${method} ${path} → ${response.status}`;\n            if (response.status >= 400) log.warn(line, entry);\n            else log.debug(line, entry);\n            return response;\n        } catch (error) {\n            log.warn(`${method} ${path} → no response`, {\n                requestId,\n                ms: elapsedMs(startedAt),\n                error,\n            });\n            throw error;\n        }\n    }\n\n    async function notifyUnauthorized(response: Response, requestId: string): Promise<void> {\n        if (!config.onUnauthorized) return;\n        config.logger?.warn(`unauthorized — calling onUnauthorized`, {\n            requestId,\n            status: response.status,\n        });\n        try {\n            await config.onUnauthorized(response);\n        } catch (error) {\n            config.logger?.warn(`onUnauthorized threw — keeping the original response error`, {\n                requestId,\n                status: response.status,\n                error,\n            });\n        }\n    }\n\n    async function attempt<T>(path: string, options: RequestOptions): Promise<T> {\n        const requestId = config.requestId ? config.requestId() : randomId();\n        const method = (options.method ?? \"GET\").toUpperCase();\n        let response = await send(path, options, requestId, method);\n\n        if (response.status === 401) {\n            if (config.refresh) {\n                try {\n                    await config.refresh();\n                    response = await send(path, options, requestId, method);\n                } catch {\n                    await notifyUnauthorized(response, requestId);\n                    throw await parseError(response, requestId);\n                }\n                if (response.status === 401) {\n                    await notifyUnauthorized(response, requestId);\n                }\n            } else {\n                await notifyUnauthorized(response, requestId);\n            }\n        }\n\n        if (!response.ok) {\n            throw await parseError(response, requestId);\n        }\n\n        if (response.status === 204) {\n            return undefined as T;\n        }\n\n        const contentType = response.headers.get(\"content-type\") ?? \"\";\n        if (contentType.includes(\"application/json\")) {\n            return (await response.json()) as T;\n        }\n        return (await response.text()) as unknown as T;\n    }\n\n    async function request<T>(path: string, options: RequestOptions = {}): Promise<T> {\n        const retryOptions = resolveRetry(config.retry);\n        if (!retryOptions) return attempt<T>(path, options);\n\n        const method = (options.method ?? \"GET\").toUpperCase();\n        return retryWithBackoff(() => attempt<T>(path, options), {\n            ...retryOptions,\n            shouldRetry:\n                retryOptions.shouldRetry ?? ((error: unknown) => isRetriableFailure(error, method)),\n        });\n    }\n\n    async function upload<T>(\n        path: string,\n        formData: FormData,\n        method: \"POST\" | \"PUT\" | \"PATCH\" = \"POST\",\n    ): Promise<T> {\n        return request<T>(path, { method, body: formData });\n    }\n\n    return {\n        request,\n        get: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"GET\" }),\n        post: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"POST\" }),\n        put: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"PUT\" }),\n        patch: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"PATCH\" }),\n        delete: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"DELETE\" }),\n        upload,\n    };\n}\n"],"mappings":"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"}

package/dist/http/api-client.js

@@ -1,20 +1,15 @@
 import { randomId as e } from "../utils/ids.js";
 import { buildApiUrl as t } from "./build-url.js";
-import { TempestApiError as n, buildApiError as r } from "./errors.js";
-import { retry as i } from "./retry.js";
+import { TempestApiError as n, buildApiError as r, isRetriableStatus as i } from "./errors.js";
+import { retry as a } from "./retry.js";
 //#region src/http/api-client.ts
-var a = /* @__PURE__ */ new Set([
+var o = /* @__PURE__ */ new Set([
 	"GET",
 	"HEAD",
 	"OPTIONS"
-]), o = /* @__PURE__ */ new Set([
-	0,
-	408,
-	425,
-	429
 ]);
 function s(e, t) {
-	return !a.has(t) || !(e instanceof n) ? !1 : o.has(e.status) || e.status >= 500;
+	return !o.has(t) || !(e instanceof n) ? !1 : i(e.status);
 }
 function c(e) {
 	return e ? e === !0 ? {} : e : null;
@@ -40,16 +35,16 @@ async function d(e, t) {
 }
 function f(n) {
 	let r = n.fetcher ?? globalThis.fetch.bind(globalThis);
-	function a() {
+	function i() {
 		let e = n.getToken?.();
 		return e ? { Authorization: `Bearer ${e}` } : {};
 	}
-	async function o(e, i, o) {
-		let { body: s, params: c, headers: u, ...d } = i, f = l(s), p = {
+	async function o(e, a, o) {
+		let { body: s, params: c, headers: u, ...d } = a, f = l(s), p = {
 			...f ? {} : { "Content-Type": "application/json" },
 			...o ? { "X-Request-ID": o } : {},
 			...n.headers,
-			...a(),
+			...i(),
 			...u
 		}, m = {
 			...d,
@@ -116,10 +111,10 @@ function f(n) {
 	async function h(e, t = {}) {
 		let r = c(n.retry);
 		if (!r) return m(e, t);
-		let a = (t.method ?? "GET").toUpperCase();
-		return i(() => m(e, t), {
+		let i = (t.method ?? "GET").toUpperCase();
+		return a(() => m(e, t), {
 			...r,
-			shouldRetry: r.shouldRetry ?? ((e) => s(e, a))
+			shouldRetry: r.shouldRetry ?? ((e) => s(e, i))
 		});
 	}
 	async function g(e, t, n = "POST") {