tempest-react-sdk 0.22.0 → 0.24.0

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

@@ -0,0 +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    optionsRef.current = 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;CAyCjC,OAxCA,EAAW,UAAU,GAErB,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"}

package/dist/hooks/use-set.cjs

@@ -0,0 +1,2 @@
+let e=require("react");function t(t){let[n,r]=(0,e.useState)(()=>new Set(t)),i=(0,e.useCallback)(e=>{r(t=>{if(t.has(e))return t;let n=new Set(t);return n.add(e),n})},[]),a=(0,e.useCallback)(e=>{r(t=>{if(!t.has(e))return t;let n=new Set(t);return n.delete(e),n})},[]),o=(0,e.useCallback)(()=>{r(e=>e.size===0?e:new Set)},[]),s=(0,e.useCallback)(e=>n.has(e),[n]),c=(0,e.useCallback)(e=>{r(t=>{let n=new Set(t);return n.has(e)?n.delete(e):n.add(e),n})},[]);return(0,e.useMemo)(()=>({set:n,add:i,delete:a,clear:o,has:s,toggle:c,size:n.size}),[n,i,a,o,s,c])}exports.useSet=t;
+//# sourceMappingURL=use-set.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-set.cjs","names":[],"sources":["../../src/hooks/use-set.ts"],"sourcesContent":["import { useCallback, useMemo, useState } from \"react\";\n\nexport interface UseSetResult<T> {\n    set: ReadonlySet<T>;\n    add: (value: T) => void;\n    delete: (value: T) => void;\n    clear: () => void;\n    has: (value: T) => boolean;\n    toggle: (value: T) => void;\n    size: number;\n}\n\n/**\n * Reactive `Set` wrapper. Mutating via `add` / `delete` / `clear` / `toggle`\n * triggers a re-render and yields a fresh `set` reference each time.\n *\n * @typeParam T - element type.\n * @param initial - initial values.\n * @returns `{ set, add, delete, clear, has, toggle, size }`.\n */\nexport function useSet<T>(initial?: Iterable<T>): UseSetResult<T> {\n    const [set, setSet] = useState<Set<T>>(() => new Set(initial));\n\n    const add = useCallback((value: T): void => {\n        setSet((current) => {\n            if (current.has(value)) return current;\n            const next = new Set(current);\n            next.add(value);\n            return next;\n        });\n    }, []);\n\n    const remove = useCallback((value: T): void => {\n        setSet((current) => {\n            if (!current.has(value)) return current;\n            const next = new Set(current);\n            next.delete(value);\n            return next;\n        });\n    }, []);\n\n    const clear = useCallback((): void => {\n        setSet((current) => (current.size === 0 ? current : new Set<T>()));\n    }, []);\n\n    const has = useCallback((value: T): boolean => set.has(value), [set]);\n\n    const toggle = useCallback((value: T): void => {\n        setSet((current) => {\n            const next = new Set(current);\n            if (next.has(value)) next.delete(value);\n            else next.add(value);\n            return next;\n        });\n    }, []);\n\n    return useMemo<UseSetResult<T>>(\n        () => ({\n            set,\n            add,\n            delete: remove,\n            clear,\n            has,\n            toggle,\n            size: set.size,\n        }),\n        [set, add, remove, clear, has, toggle],\n    );\n}\n"],"mappings":"uBAoBA,SAAgB,EAAU,EAAwC,CAC9D,GAAM,CAAC,EAAK,IAAA,EAAA,EAAA,SAAA,KAAiC,IAAI,IAAI,CAAO,CAAC,EAEvD,GAAA,EAAA,EAAA,YAAA,CAAmB,GAAmB,CACxC,EAAQ,GAAY,CAChB,GAAI,EAAQ,IAAI,CAAK,EAAG,OAAO,EAC/B,IAAM,EAAO,IAAI,IAAI,CAAO,EAE5B,OADA,EAAK,IAAI,CAAK,EACP,CACX,CAAC,CACL,EAAG,CAAC,CAAC,EAEC,GAAA,EAAA,EAAA,YAAA,CAAsB,GAAmB,CAC3C,EAAQ,GAAY,CAChB,GAAI,CAAC,EAAQ,IAAI,CAAK,EAAG,OAAO,EAChC,IAAM,EAAO,IAAI,IAAI,CAAO,EAE5B,OADA,EAAK,OAAO,CAAK,EACV,CACX,CAAC,CACL,EAAG,CAAC,CAAC,EAEC,GAAA,EAAA,EAAA,YAAA,KAAgC,CAClC,EAAQ,GAAa,EAAQ,OAAS,EAAI,EAAU,IAAI,GAAS,CACrE,EAAG,CAAC,CAAC,EAEC,GAAA,EAAA,EAAA,YAAA,CAAmB,GAAsB,EAAI,IAAI,CAAK,EAAG,CAAC,CAAG,CAAC,EAE9D,GAAA,EAAA,EAAA,YAAA,CAAsB,GAAmB,CAC3C,EAAQ,GAAY,CAChB,IAAM,EAAO,IAAI,IAAI,CAAO,EAG5B,OAFI,EAAK,IAAI,CAAK,EAAG,EAAK,OAAO,CAAK,EACjC,EAAK,IAAI,CAAK,EACZ,CACX,CAAC,CACL,EAAG,CAAC,CAAC,EAEL,OAAA,EAAA,EAAA,QAAA,MACW,CACH,MACA,MACA,OAAQ,EACR,QACA,MACA,SACA,KAAM,EAAI,IACd,GACA,CAAC,EAAK,EAAK,EAAQ,EAAO,EAAK,CAAM,CACzC,CACJ"}

package/dist/hooks/use-set.js

@@ -0,0 +1,44 @@
+import { useCallback as e, useMemo as t, useState as n } from "react";
+//#region src/hooks/use-set.ts
+function r(r) {
+	let [i, a] = n(() => new Set(r)), o = e((e) => {
+		a((t) => {
+			if (t.has(e)) return t;
+			let n = new Set(t);
+			return n.add(e), n;
+		});
+	}, []), s = e((e) => {
+		a((t) => {
+			if (!t.has(e)) return t;
+			let n = new Set(t);
+			return n.delete(e), n;
+		});
+	}, []), c = e(() => {
+		a((e) => e.size === 0 ? e : /* @__PURE__ */ new Set());
+	}, []), l = e((e) => i.has(e), [i]), u = e((e) => {
+		a((t) => {
+			let n = new Set(t);
+			return n.has(e) ? n.delete(e) : n.add(e), n;
+		});
+	}, []);
+	return t(() => ({
+		set: i,
+		add: o,
+		delete: s,
+		clear: c,
+		has: l,
+		toggle: u,
+		size: i.size
+	}), [
+		i,
+		o,
+		s,
+		c,
+		l,
+		u
+	]);
+}
+//#endregion
+export { r as useSet };
+
+//# sourceMappingURL=use-set.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-set.js","names":[],"sources":["../../src/hooks/use-set.ts"],"sourcesContent":["import { useCallback, useMemo, useState } from \"react\";\n\nexport interface UseSetResult<T> {\n    set: ReadonlySet<T>;\n    add: (value: T) => void;\n    delete: (value: T) => void;\n    clear: () => void;\n    has: (value: T) => boolean;\n    toggle: (value: T) => void;\n    size: number;\n}\n\n/**\n * Reactive `Set` wrapper. Mutating via `add` / `delete` / `clear` / `toggle`\n * triggers a re-render and yields a fresh `set` reference each time.\n *\n * @typeParam T - element type.\n * @param initial - initial values.\n * @returns `{ set, add, delete, clear, has, toggle, size }`.\n */\nexport function useSet<T>(initial?: Iterable<T>): UseSetResult<T> {\n    const [set, setSet] = useState<Set<T>>(() => new Set(initial));\n\n    const add = useCallback((value: T): void => {\n        setSet((current) => {\n            if (current.has(value)) return current;\n            const next = new Set(current);\n            next.add(value);\n            return next;\n        });\n    }, []);\n\n    const remove = useCallback((value: T): void => {\n        setSet((current) => {\n            if (!current.has(value)) return current;\n            const next = new Set(current);\n            next.delete(value);\n            return next;\n        });\n    }, []);\n\n    const clear = useCallback((): void => {\n        setSet((current) => (current.size === 0 ? current : new Set<T>()));\n    }, []);\n\n    const has = useCallback((value: T): boolean => set.has(value), [set]);\n\n    const toggle = useCallback((value: T): void => {\n        setSet((current) => {\n            const next = new Set(current);\n            if (next.has(value)) next.delete(value);\n            else next.add(value);\n            return next;\n        });\n    }, []);\n\n    return useMemo<UseSetResult<T>>(\n        () => ({\n            set,\n            add,\n            delete: remove,\n            clear,\n            has,\n            toggle,\n            size: set.size,\n        }),\n        [set, add, remove, clear, has, toggle],\n    );\n}\n"],"mappings":";;AAoBA,SAAgB,EAAU,GAAwC;CAC9D,IAAM,CAAC,GAAK,KAAU,QAAuB,IAAI,IAAI,CAAO,CAAC,GAEvD,IAAM,GAAa,MAAmB;EACxC,GAAQ,MAAY;GAChB,IAAI,EAAQ,IAAI,CAAK,GAAG,OAAO;GAC/B,IAAM,IAAO,IAAI,IAAI,CAAO;GAE5B,OADA,EAAK,IAAI,CAAK,GACP;EACX,CAAC;CACL,GAAG,CAAC,CAAC,GAEC,IAAS,GAAa,MAAmB;EAC3C,GAAQ,MAAY;GAChB,IAAI,CAAC,EAAQ,IAAI,CAAK,GAAG,OAAO;GAChC,IAAM,IAAO,IAAI,IAAI,CAAO;GAE5B,OADA,EAAK,OAAO,CAAK,GACV;EACX,CAAC;CACL,GAAG,CAAC,CAAC,GAEC,IAAQ,QAAwB;EAClC,GAAQ,MAAa,EAAQ,SAAS,IAAI,oBAAU,IAAI,IAAO,CAAE;CACrE,GAAG,CAAC,CAAC,GAEC,IAAM,GAAa,MAAsB,EAAI,IAAI,CAAK,GAAG,CAAC,CAAG,CAAC,GAE9D,IAAS,GAAa,MAAmB;EAC3C,GAAQ,MAAY;GAChB,IAAM,IAAO,IAAI,IAAI,CAAO;GAG5B,OAFI,EAAK,IAAI,CAAK,IAAG,EAAK,OAAO,CAAK,IACjC,EAAK,IAAI,CAAK,GACZ;EACX,CAAC;CACL,GAAG,CAAC,CAAC;CAEL,OAAO,SACI;EACH;EACA;EACA,QAAQ;EACR;EACA;EACA;EACA,MAAM,EAAI;CACd,IACA;EAAC;EAAK;EAAK;EAAQ;EAAO;EAAK;CAAM,CACzC;AACJ"}

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

@@ -0,0 +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;
+//# sourceMappingURL=use-stable-callback.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-stable-callback.cjs","names":[],"sources":["../../src/hooks/use-stable-callback.ts"],"sourcesContent":["import { 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 */\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":"uBAOA,SAAgB,EACZ,EAC2B,CAC3B,IAAM,GAAA,EAAA,EAAA,OAAA,CAAa,CAAQ,EAE3B,MADA,GAAI,QAAU,GACd,EAAA,EAAA,YAAA,EAAoB,GAAG,IAAgB,EAAI,QAAQ,GAAG,CAAI,EAAG,CAAC,CAAC,CACnE"}

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

@@ -0,0 +1,10 @@
+import { useCallback as e, useRef 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), []);
+}
+//#endregion
+export { n as useStableCallback };
+
+//# sourceMappingURL=use-stable-callback.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-stable-callback.js","names":[],"sources":["../../src/hooks/use-stable-callback.ts"],"sourcesContent":["import { 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 */\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":";;AAOA,SAAgB,EACZ,GAC2B;CAC3B,IAAM,IAAM,EAAO,CAAQ;CAE3B,OADA,EAAI,UAAU,GACP,GAAa,GAAG,MAAgB,EAAI,QAAQ,GAAG,CAAI,GAAG,CAAC,CAAC;AACnE"}

package/dist/hooks/use-storage-estimate.cjs

@@ -0,0 +1,2 @@
+let e=require("react");function t(){return typeof navigator<`u`&&`storage`in navigator&&typeof navigator.storage?.estimate==`function`}async function n(){if(!t())return{usage:null,quota:null};let e=await navigator.storage.estimate();return{usage:e.usage??null,quota:e.quota??null}}async function r(){return typeof navigator>`u`||!(`storage`in navigator)||typeof navigator.storage?.persist!=`function`?!1:typeof navigator.storage.persisted==`function`&&await navigator.storage.persisted()?!0:navigator.storage.persist()}function i(i={}){let{pollMs:a=0}=i,[o]=(0,e.useState)(()=>t()),[s,c]=(0,e.useState)(null),[l,u]=(0,e.useState)(null),[d,f]=(0,e.useState)(null),[p,m]=(0,e.useState)(o),h=(0,e.useCallback)(async()=>{if(o){m(!0);try{let e=await n();c(e.usage),u(e.quota),typeof navigator.storage?.persisted==`function`&&f(await navigator.storage.persisted())}finally{m(!1)}}},[o]),g=(0,e.useCallback)(async()=>{let e=await r();return await h(),f(e),e},[h]);return(0,e.useEffect)(()=>{h()},[h]),(0,e.useEffect)(()=>{if(a<=0||!o||typeof window>`u`)return;let e=window.setInterval(()=>{h()},a);return()=>window.clearInterval(e)},[a,o,h]),{supported:o,usage:s,quota:l,ratio:s!==null&&l!==null&&l>0?s/l:null,persisted:d,loading:p,refresh:h,requestPersist:g}}exports.estimateStorage=n,exports.requestPersistentStorage=r,exports.useStorageEstimate=i;
+//# sourceMappingURL=use-storage-estimate.cjs.map

package/dist/hooks/use-storage-estimate.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-storage-estimate.cjs","names":[],"sources":["../../src/hooks/use-storage-estimate.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\n/** Raw usage/quota reading from the Storage API, in bytes. */\nexport interface StorageEstimate {\n    /** Bytes currently used by this origin, or `null` when unknown. */\n    usage: number | null;\n    /** Total bytes available to this origin, or `null` when unknown. */\n    quota: number | null;\n}\n\n/**\n * `true` when `navigator.storage` exposes the estimate/persist APIs. Guards\n * every call so the helpers stay safe under SSR and older browsers.\n */\nfunction storageManagerAvailable(): boolean {\n    return (\n        typeof navigator !== \"undefined\" &&\n        \"storage\" in navigator &&\n        typeof navigator.storage?.estimate === \"function\"\n    );\n}\n\n/**\n * Read the origin's current storage usage and quota.\n *\n * @returns The estimate, or `{ usage: null, quota: null }` when unsupported.\n */\nexport async function estimateStorage(): Promise<StorageEstimate> {\n    if (!storageManagerAvailable()) return { usage: null, quota: null };\n    const estimate = await navigator.storage.estimate();\n    return { usage: estimate.usage ?? null, quota: estimate.quota ?? null };\n}\n\n/**\n * Ask the browser to make this origin's storage persistent, so IndexedDB and\n * the Cache Storage are not silently evicted under disk pressure — essential\n * for durable offline-first data.\n *\n * The browser may grant silently, prompt, or deny based on engagement heuristics.\n *\n * @returns `true` when storage is (now or already) persisted, else `false`.\n */\nexport async function requestPersistentStorage(): Promise<boolean> {\n    if (\n        typeof navigator === \"undefined\" ||\n        !(\"storage\" in navigator) ||\n        typeof navigator.storage?.persist !== \"function\"\n    ) {\n        return false;\n    }\n    if (typeof navigator.storage.persisted === \"function\") {\n        const already = await navigator.storage.persisted();\n        if (already) return true;\n    }\n    return navigator.storage.persist();\n}\n\n/** Reactive storage-quota state exposed by {@link useStorageEstimate}. */\nexport interface UseStorageEstimateResult extends StorageEstimate {\n    /** `true` when the Storage API is available. */\n    supported: boolean;\n    /** `usage / quota` in `[0, 1]`, or `null` when either value is unknown. */\n    ratio: number | null;\n    /** Whether storage is persisted, `null` before the first read / unsupported. */\n    persisted: boolean | null;\n    /** `true` during the initial read or a `refresh`. */\n    loading: boolean;\n    /** Re-read usage/quota and the persisted flag from the browser. */\n    refresh: () => Promise<void>;\n    /** Request persistent storage; refreshes state and returns the outcome. */\n    requestPersist: () => Promise<boolean>;\n}\n\n/**\n * Track the origin's storage usage, quota and persistence flag, refreshing on\n * demand. Pair with {@link requestPersistentStorage} to surface a \"usando X de\n * Y MB\" meter and a \"tornar armazenamento permanente\" action.\n *\n * @param options - `pollMs` re-reads the estimate on an interval (`0` = off,\n *   the default).\n * @returns The reactive storage state and actions.\n *\n * @example\n * const { usage, quota, ratio, persisted, requestPersist } = useStorageEstimate();\n * return <Meter value={ratio ?? 0} onClick={requestPersist} />;\n */\nexport function useStorageEstimate(options: { pollMs?: number } = {}): UseStorageEstimateResult {\n    const { pollMs = 0 } = options;\n    const [supported] = useState<boolean>(() => storageManagerAvailable());\n    const [usage, setUsage] = useState<number | null>(null);\n    const [quota, setQuota] = useState<number | null>(null);\n    const [persisted, setPersisted] = useState<boolean | null>(null);\n    const [loading, setLoading] = useState<boolean>(supported);\n\n    const refresh = useCallback(async () => {\n        if (!supported) return;\n        setLoading(true);\n        try {\n            const estimate = await estimateStorage();\n            setUsage(estimate.usage);\n            setQuota(estimate.quota);\n            if (typeof navigator.storage?.persisted === \"function\") {\n                setPersisted(await navigator.storage.persisted());\n            }\n        } finally {\n            setLoading(false);\n        }\n    }, [supported]);\n\n    const requestPersist = useCallback(async () => {\n        const granted = await requestPersistentStorage();\n        await refresh();\n        setPersisted(granted);\n        return granted;\n    }, [refresh]);\n\n    useEffect(() => {\n        void refresh();\n    }, [refresh]);\n\n    useEffect(() => {\n        if (pollMs <= 0 || !supported || typeof window === \"undefined\") return;\n        const id = window.setInterval(() => {\n            void refresh();\n        }, pollMs);\n        return () => window.clearInterval(id);\n    }, [pollMs, supported, refresh]);\n\n    const ratio = usage !== null && quota !== null && quota > 0 ? usage / quota : null;\n\n    return {\n        supported,\n        usage,\n        quota,\n        ratio,\n        persisted,\n        loading,\n        refresh,\n        requestPersist,\n    };\n}\n"],"mappings":"uBAcA,SAAS,GAAmC,CACxC,OACI,OAAO,UAAc,KACrB,YAAa,WACb,OAAO,UAAU,SAAS,UAAa,UAE/C,CAOA,eAAsB,GAA4C,CAC9D,GAAI,CAAC,EAAwB,EAAG,MAAO,CAAE,MAAO,KAAM,MAAO,IAAK,EAClE,IAAM,EAAW,MAAM,UAAU,QAAQ,SAAS,EAClD,MAAO,CAAE,MAAO,EAAS,OAAS,KAAM,MAAO,EAAS,OAAS,IAAK,CAC1E,CAWA,eAAsB,GAA6C,CAY/D,OAVI,OAAO,UAAc,KACrB,EAAE,YAAa,YACf,OAAO,UAAU,SAAS,SAAY,WAE/B,GAEP,OAAO,UAAU,QAAQ,WAAc,YAEnC,MADkB,UAAU,QAAQ,UAAU,EAC9B,GAEjB,UAAU,QAAQ,QAAQ,CACrC,CA+BA,SAAgB,EAAmB,EAA+B,CAAC,EAA6B,CAC5F,GAAM,CAAE,SAAS,GAAM,EACjB,CAAC,IAAA,EAAA,EAAA,SAAA,KAAqC,EAAwB,CAAC,EAC/D,CAAC,EAAO,IAAA,EAAA,EAAA,SAAA,CAAoC,IAAI,EAChD,CAAC,EAAO,IAAA,EAAA,EAAA,SAAA,CAAoC,IAAI,EAChD,CAAC,EAAW,IAAA,EAAA,EAAA,SAAA,CAAyC,IAAI,EACzD,CAAC,EAAS,IAAA,EAAA,EAAA,SAAA,CAAgC,CAAS,EAEnD,GAAA,EAAA,EAAA,YAAA,CAAsB,SAAY,CAC/B,KACL,GAAW,EAAI,EACf,GAAI,CACA,IAAM,EAAW,MAAM,EAAgB,EACvC,EAAS,EAAS,KAAK,EACvB,EAAS,EAAS,KAAK,EACnB,OAAO,UAAU,SAAS,WAAc,YACxC,EAAa,MAAM,UAAU,QAAQ,UAAU,CAAC,CAExD,QAAU,CACN,EAAW,EAAK,CACpB,CAVe,CAWnB,EAAG,CAAC,CAAS,CAAC,EAER,GAAA,EAAA,EAAA,YAAA,CAA6B,SAAY,CAC3C,IAAM,EAAU,MAAM,EAAyB,EAG/C,OAFA,MAAM,EAAQ,EACd,EAAa,CAAO,EACb,CACX,EAAG,CAAC,CAAO,CAAC,EAgBZ,OAdA,EAAA,EAAA,UAAA,KAAgB,CACZ,EAAa,CACjB,EAAG,CAAC,CAAO,CAAC,GAEZ,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,GAAU,GAAK,CAAC,GAAa,OAAO,OAAW,IAAa,OAChE,IAAM,EAAK,OAAO,gBAAkB,CAChC,EAAa,CACjB,EAAG,CAAM,EACT,UAAa,OAAO,cAAc,CAAE,CACxC,EAAG,CAAC,EAAQ,EAAW,CAAO,CAAC,EAIxB,CACH,YACA,QACA,QACA,MANU,IAAU,MAAQ,IAAU,MAAQ,EAAQ,EAAI,EAAQ,EAAQ,KAO1E,YACA,UACA,UACA,gBACJ,CACJ"}

package/dist/hooks/use-storage-estimate.js

@@ -0,0 +1,61 @@
+import { useCallback as e, useEffect as t, useState as n } from "react";
+//#region src/hooks/use-storage-estimate.ts
+function r() {
+	return typeof navigator < "u" && "storage" in navigator && typeof navigator.storage?.estimate == "function";
+}
+async function i() {
+	if (!r()) return {
+		usage: null,
+		quota: null
+	};
+	let e = await navigator.storage.estimate();
+	return {
+		usage: e.usage ?? null,
+		quota: e.quota ?? null
+	};
+}
+async function a() {
+	return typeof navigator > "u" || !("storage" in navigator) || typeof navigator.storage?.persist != "function" ? !1 : typeof navigator.storage.persisted == "function" && await navigator.storage.persisted() ? !0 : navigator.storage.persist();
+}
+function o(o = {}) {
+	let { pollMs: s = 0 } = o, [c] = n(() => r()), [l, u] = n(null), [d, f] = n(null), [p, m] = n(null), [h, g] = n(c), _ = e(async () => {
+		if (c) {
+			g(!0);
+			try {
+				let e = await i();
+				u(e.usage), f(e.quota), typeof navigator.storage?.persisted == "function" && m(await navigator.storage.persisted());
+			} finally {
+				g(!1);
+			}
+		}
+	}, [c]), v = e(async () => {
+		let e = await a();
+		return await _(), m(e), e;
+	}, [_]);
+	return t(() => {
+		_();
+	}, [_]), t(() => {
+		if (s <= 0 || !c || typeof window > "u") return;
+		let e = window.setInterval(() => {
+			_();
+		}, s);
+		return () => window.clearInterval(e);
+	}, [
+		s,
+		c,
+		_
+	]), {
+		supported: c,
+		usage: l,
+		quota: d,
+		ratio: l !== null && d !== null && d > 0 ? l / d : null,
+		persisted: p,
+		loading: h,
+		refresh: _,
+		requestPersist: v
+	};
+}
+//#endregion
+export { i as estimateStorage, a as requestPersistentStorage, o as useStorageEstimate };
+
+//# sourceMappingURL=use-storage-estimate.js.map

package/dist/hooks/use-storage-estimate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-storage-estimate.js","names":[],"sources":["../../src/hooks/use-storage-estimate.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\n/** Raw usage/quota reading from the Storage API, in bytes. */\nexport interface StorageEstimate {\n    /** Bytes currently used by this origin, or `null` when unknown. */\n    usage: number | null;\n    /** Total bytes available to this origin, or `null` when unknown. */\n    quota: number | null;\n}\n\n/**\n * `true` when `navigator.storage` exposes the estimate/persist APIs. Guards\n * every call so the helpers stay safe under SSR and older browsers.\n */\nfunction storageManagerAvailable(): boolean {\n    return (\n        typeof navigator !== \"undefined\" &&\n        \"storage\" in navigator &&\n        typeof navigator.storage?.estimate === \"function\"\n    );\n}\n\n/**\n * Read the origin's current storage usage and quota.\n *\n * @returns The estimate, or `{ usage: null, quota: null }` when unsupported.\n */\nexport async function estimateStorage(): Promise<StorageEstimate> {\n    if (!storageManagerAvailable()) return { usage: null, quota: null };\n    const estimate = await navigator.storage.estimate();\n    return { usage: estimate.usage ?? null, quota: estimate.quota ?? null };\n}\n\n/**\n * Ask the browser to make this origin's storage persistent, so IndexedDB and\n * the Cache Storage are not silently evicted under disk pressure — essential\n * for durable offline-first data.\n *\n * The browser may grant silently, prompt, or deny based on engagement heuristics.\n *\n * @returns `true` when storage is (now or already) persisted, else `false`.\n */\nexport async function requestPersistentStorage(): Promise<boolean> {\n    if (\n        typeof navigator === \"undefined\" ||\n        !(\"storage\" in navigator) ||\n        typeof navigator.storage?.persist !== \"function\"\n    ) {\n        return false;\n    }\n    if (typeof navigator.storage.persisted === \"function\") {\n        const already = await navigator.storage.persisted();\n        if (already) return true;\n    }\n    return navigator.storage.persist();\n}\n\n/** Reactive storage-quota state exposed by {@link useStorageEstimate}. */\nexport interface UseStorageEstimateResult extends StorageEstimate {\n    /** `true` when the Storage API is available. */\n    supported: boolean;\n    /** `usage / quota` in `[0, 1]`, or `null` when either value is unknown. */\n    ratio: number | null;\n    /** Whether storage is persisted, `null` before the first read / unsupported. */\n    persisted: boolean | null;\n    /** `true` during the initial read or a `refresh`. */\n    loading: boolean;\n    /** Re-read usage/quota and the persisted flag from the browser. */\n    refresh: () => Promise<void>;\n    /** Request persistent storage; refreshes state and returns the outcome. */\n    requestPersist: () => Promise<boolean>;\n}\n\n/**\n * Track the origin's storage usage, quota and persistence flag, refreshing on\n * demand. Pair with {@link requestPersistentStorage} to surface a \"usando X de\n * Y MB\" meter and a \"tornar armazenamento permanente\" action.\n *\n * @param options - `pollMs` re-reads the estimate on an interval (`0` = off,\n *   the default).\n * @returns The reactive storage state and actions.\n *\n * @example\n * const { usage, quota, ratio, persisted, requestPersist } = useStorageEstimate();\n * return <Meter value={ratio ?? 0} onClick={requestPersist} />;\n */\nexport function useStorageEstimate(options: { pollMs?: number } = {}): UseStorageEstimateResult {\n    const { pollMs = 0 } = options;\n    const [supported] = useState<boolean>(() => storageManagerAvailable());\n    const [usage, setUsage] = useState<number | null>(null);\n    const [quota, setQuota] = useState<number | null>(null);\n    const [persisted, setPersisted] = useState<boolean | null>(null);\n    const [loading, setLoading] = useState<boolean>(supported);\n\n    const refresh = useCallback(async () => {\n        if (!supported) return;\n        setLoading(true);\n        try {\n            const estimate = await estimateStorage();\n            setUsage(estimate.usage);\n            setQuota(estimate.quota);\n            if (typeof navigator.storage?.persisted === \"function\") {\n                setPersisted(await navigator.storage.persisted());\n            }\n        } finally {\n            setLoading(false);\n        }\n    }, [supported]);\n\n    const requestPersist = useCallback(async () => {\n        const granted = await requestPersistentStorage();\n        await refresh();\n        setPersisted(granted);\n        return granted;\n    }, [refresh]);\n\n    useEffect(() => {\n        void refresh();\n    }, [refresh]);\n\n    useEffect(() => {\n        if (pollMs <= 0 || !supported || typeof window === \"undefined\") return;\n        const id = window.setInterval(() => {\n            void refresh();\n        }, pollMs);\n        return () => window.clearInterval(id);\n    }, [pollMs, supported, refresh]);\n\n    const ratio = usage !== null && quota !== null && quota > 0 ? usage / quota : null;\n\n    return {\n        supported,\n        usage,\n        quota,\n        ratio,\n        persisted,\n        loading,\n        refresh,\n        requestPersist,\n    };\n}\n"],"mappings":";;AAcA,SAAS,IAAmC;CACxC,OACI,OAAO,YAAc,OACrB,aAAa,aACb,OAAO,UAAU,SAAS,YAAa;AAE/C;AAOA,eAAsB,IAA4C;CAC9D,IAAI,CAAC,EAAwB,GAAG,OAAO;EAAE,OAAO;EAAM,OAAO;CAAK;CAClE,IAAM,IAAW,MAAM,UAAU,QAAQ,SAAS;CAClD,OAAO;EAAE,OAAO,EAAS,SAAS;EAAM,OAAO,EAAS,SAAS;CAAK;AAC1E;AAWA,eAAsB,IAA6C;CAY/D,OAVI,OAAO,YAAc,OACrB,EAAE,aAAa,cACf,OAAO,UAAU,SAAS,WAAY,aAE/B,KAEP,OAAO,UAAU,QAAQ,aAAc,cAEnC,MADkB,UAAU,QAAQ,UAAU,IAC9B,KAEjB,UAAU,QAAQ,QAAQ;AACrC;AA+BA,SAAgB,EAAmB,IAA+B,CAAC,GAA6B;CAC5F,IAAM,EAAE,YAAS,MAAM,GACjB,CAAC,KAAa,QAAwB,EAAwB,CAAC,GAC/D,CAAC,GAAO,KAAY,EAAwB,IAAI,GAChD,CAAC,GAAO,KAAY,EAAwB,IAAI,GAChD,CAAC,GAAW,KAAgB,EAAyB,IAAI,GACzD,CAAC,GAAS,KAAc,EAAkB,CAAS,GAEnD,IAAU,EAAY,YAAY;EAC/B,OACL;KAAW,EAAI;GACf,IAAI;IACA,IAAM,IAAW,MAAM,EAAgB;IAGvC,AAFA,EAAS,EAAS,KAAK,GACvB,EAAS,EAAS,KAAK,GACnB,OAAO,UAAU,SAAS,aAAc,cACxC,EAAa,MAAM,UAAU,QAAQ,UAAU,CAAC;GAExD,UAAU;IACN,EAAW,EAAK;GACpB;EAVe;CAWnB,GAAG,CAAC,CAAS,CAAC,GAER,IAAiB,EAAY,YAAY;EAC3C,IAAM,IAAU,MAAM,EAAyB;EAG/C,OAFA,MAAM,EAAQ,GACd,EAAa,CAAO,GACb;CACX,GAAG,CAAC,CAAO,CAAC;CAgBZ,OAdA,QAAgB;EACZ,EAAa;CACjB,GAAG,CAAC,CAAO,CAAC,GAEZ,QAAgB;EACZ,IAAI,KAAU,KAAK,CAAC,KAAa,OAAO,SAAW,KAAa;EAChE,IAAM,IAAK,OAAO,kBAAkB;GAChC,EAAa;EACjB,GAAG,CAAM;EACT,aAAa,OAAO,cAAc,CAAE;CACxC,GAAG;EAAC;EAAQ;EAAW;CAAO,CAAC,GAIxB;EACH;EACA;EACA;EACA,OANU,MAAU,QAAQ,MAAU,QAAQ,IAAQ,IAAI,IAAQ,IAAQ;EAO1E;EACA;EACA;EACA;CACJ;AACJ"}

package/dist/hooks/use-throttle.cjs

@@ -0,0 +1,2 @@
+let e=require("react");function t(t,n){let[r,i]=(0,e.useState)(t),a=(0,e.useRef)(0),o=(0,e.useRef)(null);return(0,e.useEffect)(()=>{let e=Date.now(),r=e-a.current;return r>=n?(a.current=e,i(t)):(o.current&&clearTimeout(o.current),o.current=setTimeout(()=>{a.current=Date.now(),i(t)},n-r)),()=>{o.current&&clearTimeout(o.current)}},[t,n]),r}exports.useThrottle=t;
+//# sourceMappingURL=use-throttle.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-throttle.cjs","names":[],"sources":["../../src/hooks/use-throttle.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\n\n/**\n * Return a value that updates at most once every `delay` ms. Complements\n * `useDebounce` — throttle emits on the leading edge and again after the\n * interval; debounce only emits after a period of stillness.\n *\n * @example\n * const throttledScroll = useThrottle(scrollY, 100);\n */\nexport function useThrottle<T>(value: T, delay: number): T {\n    const [throttled, setThrottled] = useState<T>(value);\n    const lastEmitRef = useRef<number>(0);\n    const pendingRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n    useEffect(() => {\n        const now = Date.now();\n        const elapsed = now - lastEmitRef.current;\n        if (elapsed >= delay) {\n            lastEmitRef.current = now;\n            setThrottled(value);\n        } else {\n            if (pendingRef.current) clearTimeout(pendingRef.current);\n            pendingRef.current = setTimeout(() => {\n                lastEmitRef.current = Date.now();\n                setThrottled(value);\n            }, delay - elapsed);\n        }\n        return () => {\n            if (pendingRef.current) clearTimeout(pendingRef.current);\n        };\n    }, [value, delay]);\n\n    return throttled;\n}\n"],"mappings":"uBAUA,SAAgB,EAAe,EAAU,EAAkB,CACvD,GAAM,CAAC,EAAW,IAAA,EAAA,EAAA,SAAA,CAA4B,CAAK,EAC7C,GAAA,EAAA,EAAA,OAAA,CAA6B,CAAC,EAC9B,GAAA,EAAA,EAAA,OAAA,CAA0D,IAAI,EAoBpE,OAlBA,EAAA,EAAA,UAAA,KAAgB,CACZ,IAAM,EAAM,KAAK,IAAI,EACf,EAAU,EAAM,EAAY,QAWlC,OAVI,GAAW,GACX,EAAY,QAAU,EACtB,EAAa,CAAK,IAEd,EAAW,SAAS,aAAa,EAAW,OAAO,EACvD,EAAW,QAAU,eAAiB,CAClC,EAAY,QAAU,KAAK,IAAI,EAC/B,EAAa,CAAK,CACtB,EAAG,EAAQ,CAAO,OAET,CACL,EAAW,SAAS,aAAa,EAAW,OAAO,CAC3D,CACJ,EAAG,CAAC,EAAO,CAAK,CAAC,EAEV,CACX"}

package/dist/hooks/use-throttle.js

@@ -0,0 +1,17 @@
+import { useEffect as e, useRef as t, useState as n } from "react";
+//#region src/hooks/use-throttle.ts
+function r(r, i) {
+	let [a, o] = n(r), s = t(0), c = t(null);
+	return e(() => {
+		let e = Date.now(), t = e - s.current;
+		return t >= i ? (s.current = e, o(r)) : (c.current && clearTimeout(c.current), c.current = setTimeout(() => {
+			s.current = Date.now(), o(r);
+		}, i - t)), () => {
+			c.current && clearTimeout(c.current);
+		};
+	}, [r, i]), a;
+}
+//#endregion
+export { r as useThrottle };
+
+//# sourceMappingURL=use-throttle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-throttle.js","names":[],"sources":["../../src/hooks/use-throttle.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\n\n/**\n * Return a value that updates at most once every `delay` ms. Complements\n * `useDebounce` — throttle emits on the leading edge and again after the\n * interval; debounce only emits after a period of stillness.\n *\n * @example\n * const throttledScroll = useThrottle(scrollY, 100);\n */\nexport function useThrottle<T>(value: T, delay: number): T {\n    const [throttled, setThrottled] = useState<T>(value);\n    const lastEmitRef = useRef<number>(0);\n    const pendingRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n    useEffect(() => {\n        const now = Date.now();\n        const elapsed = now - lastEmitRef.current;\n        if (elapsed >= delay) {\n            lastEmitRef.current = now;\n            setThrottled(value);\n        } else {\n            if (pendingRef.current) clearTimeout(pendingRef.current);\n            pendingRef.current = setTimeout(() => {\n                lastEmitRef.current = Date.now();\n                setThrottled(value);\n            }, delay - elapsed);\n        }\n        return () => {\n            if (pendingRef.current) clearTimeout(pendingRef.current);\n        };\n    }, [value, delay]);\n\n    return throttled;\n}\n"],"mappings":";;AAUA,SAAgB,EAAe,GAAU,GAAkB;CACvD,IAAM,CAAC,GAAW,KAAgB,EAAY,CAAK,GAC7C,IAAc,EAAe,CAAC,GAC9B,IAAa,EAA6C,IAAI;CAoBpE,OAlBA,QAAgB;EACZ,IAAM,IAAM,KAAK,IAAI,GACf,IAAU,IAAM,EAAY;EAWlC,OAVI,KAAW,KACX,EAAY,UAAU,GACtB,EAAa,CAAK,MAEd,EAAW,WAAS,aAAa,EAAW,OAAO,GACvD,EAAW,UAAU,iBAAiB;GAElC,AADA,EAAY,UAAU,KAAK,IAAI,GAC/B,EAAa,CAAK;EACtB,GAAG,IAAQ,CAAO,UAET;GACT,AAAI,EAAW,WAAS,aAAa,EAAW,OAAO;EAC3D;CACJ,GAAG,CAAC,GAAO,CAAK,CAAC,GAEV;AACX"}

package/dist/hooks/use-timeout.cjs

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

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

@@ -0,0 +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    fnRef.current = 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,EAAA,EAAA,OAAA,CAAe,CAAE,EACvB,EAAM,QAAU,GAEhB,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"}

package/dist/hooks/use-timeout.js

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

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

@@ -0,0 +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    fnRef.current = 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;CAGvB,AAFA,EAAM,UAAU,GAEhB,QAAgB;EACZ,IAAI,MAAU,MAAM;EACpB,IAAM,IAAK,iBAAiB,EAAM,QAAQ,GAAG,CAAK;EAClD,aAAa,aAAa,CAAE;CAChC,GAAG,CAAC,CAAK,CAAC;AACd"}

package/dist/hooks/use-toggle.cjs

@@ -0,0 +1,2 @@
+let e=require("react");function t(t=!1){let[n,r]=(0,e.useState)(t);return[n,{toggle:(0,e.useCallback)(()=>r(e=>!e),[]),setTrue:(0,e.useCallback)(()=>r(!0),[]),setFalse:(0,e.useCallback)(()=>r(!1),[]),set:(0,e.useCallback)(e=>r(e),[])}]}exports.useToggle=t;
+//# sourceMappingURL=use-toggle.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-toggle.cjs","names":[],"sources":["../../src/hooks/use-toggle.ts"],"sourcesContent":["import { useCallback, useState } from \"react\";\n\nexport interface ToggleHelpers {\n    toggle: () => void;\n    setTrue: () => void;\n    setFalse: () => void;\n    set: (next: boolean) => void;\n}\n\n/**\n * Boolean state with `toggle`/`setTrue`/`setFalse` helpers.\n *\n * @param initial - initial value (default `false`).\n * @returns Tuple `[value, helpers]`.\n */\nexport function useToggle(initial = false): [boolean, ToggleHelpers] {\n    const [value, setValue] = useState<boolean>(initial);\n\n    const toggle = useCallback((): void => setValue((current) => !current), []);\n    const setTrue = useCallback((): void => setValue(true), []);\n    const setFalse = useCallback((): void => setValue(false), []);\n    const set = useCallback((next: boolean): void => setValue(next), []);\n\n    return [value, { toggle, setTrue, setFalse, set }];\n}\n"],"mappings":"uBAeA,SAAgB,EAAU,EAAU,GAAiC,CACjE,GAAM,CAAC,EAAO,IAAA,EAAA,EAAA,SAAA,CAA8B,CAAO,EAOnD,MAAO,CAAC,EAAO,CAAE,QAAA,EAAA,EAAA,YAAA,KALsB,EAAU,GAAY,CAAC,CAAO,EAAG,CAAC,CAKxD,EAAQ,SAAA,EAAA,EAAA,YAAA,KAJe,EAAS,EAAI,EAAG,CAAC,CAIhC,EAAS,UAAA,EAAA,EAAA,YAAA,KAHO,EAAS,EAAK,EAAG,CAAC,CAGzB,EAAU,KAAA,EAAA,EAAA,YAAA,CAFnB,GAAwB,EAAS,CAAI,EAAG,CAAC,CAEtB,CAAI,CAAC,CACrD"}

package/dist/hooks/use-toggle.js

@@ -0,0 +1,15 @@
+import { useCallback as e, useState as t } from "react";
+//#region src/hooks/use-toggle.ts
+function n(n = !1) {
+	let [r, i] = t(n);
+	return [r, {
+		toggle: e(() => i((e) => !e), []),
+		setTrue: e(() => i(!0), []),
+		setFalse: e(() => i(!1), []),
+		set: e((e) => i(e), [])
+	}];
+}
+//#endregion
+export { n as useToggle };
+
+//# sourceMappingURL=use-toggle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-toggle.js","names":[],"sources":["../../src/hooks/use-toggle.ts"],"sourcesContent":["import { useCallback, useState } from \"react\";\n\nexport interface ToggleHelpers {\n    toggle: () => void;\n    setTrue: () => void;\n    setFalse: () => void;\n    set: (next: boolean) => void;\n}\n\n/**\n * Boolean state with `toggle`/`setTrue`/`setFalse` helpers.\n *\n * @param initial - initial value (default `false`).\n * @returns Tuple `[value, helpers]`.\n */\nexport function useToggle(initial = false): [boolean, ToggleHelpers] {\n    const [value, setValue] = useState<boolean>(initial);\n\n    const toggle = useCallback((): void => setValue((current) => !current), []);\n    const setTrue = useCallback((): void => setValue(true), []);\n    const setFalse = useCallback((): void => setValue(false), []);\n    const set = useCallback((next: boolean): void => setValue(next), []);\n\n    return [value, { toggle, setTrue, setFalse, set }];\n}\n"],"mappings":";;AAeA,SAAgB,EAAU,IAAU,IAAiC;CACjE,IAAM,CAAC,GAAO,KAAY,EAAkB,CAAO;CAOnD,OAAO,CAAC,GAAO;EAAE,QALF,QAAwB,GAAU,MAAY,CAAC,CAAO,GAAG,CAAC,CAKxD;EAAQ,SAJT,QAAwB,EAAS,EAAI,GAAG,CAAC,CAIhC;EAAS,UAHjB,QAAwB,EAAS,EAAK,GAAG,CAAC,CAGzB;EAAU,KAFhC,GAAa,MAAwB,EAAS,CAAI,GAAG,CAAC,CAEtB;CAAI,CAAC;AACrD"}

package/dist/hooks/use-window-size.cjs

@@ -0,0 +1,2 @@
+let e=require("react");function t(){let[t,n]=(0,e.useState)(()=>typeof window>`u`?{width:0,height:0}:{width:window.innerWidth,height:window.innerHeight});return(0,e.useEffect)(()=>{if(typeof window>`u`)return;let e=()=>n({width:window.innerWidth,height:window.innerHeight});return e(),window.addEventListener(`resize`,e,{passive:!0}),()=>window.removeEventListener(`resize`,e)},[]),t}exports.useWindowSize=t;
+//# sourceMappingURL=use-window-size.cjs.map

package/dist/hooks/use-window-size.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-window-size.cjs","names":[],"sources":["../../src/hooks/use-window-size.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\nexport interface WindowSize {\n    width: number;\n    height: number;\n}\n\n/**\n * Reactive window dimensions. SSR-safe — returns `{ width: 0, height: 0 }`\n * until the first client render.\n *\n * @example\n * const { width, height } = useWindowSize();\n * const columns = width < 640 ? 1 : width < 1024 ? 2 : 3;\n */\nexport function useWindowSize(): WindowSize {\n    const [size, setSize] = useState<WindowSize>(() =>\n        typeof window === \"undefined\"\n            ? { width: 0, height: 0 }\n            : { width: window.innerWidth, height: window.innerHeight },\n    );\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const onResize = (): void =>\n            setSize({ width: window.innerWidth, height: window.innerHeight });\n        onResize();\n        window.addEventListener(\"resize\", onResize, { passive: true });\n        return () => window.removeEventListener(\"resize\", onResize);\n    }, []);\n\n    return size;\n}\n"],"mappings":"uBAeA,SAAgB,GAA4B,CACxC,GAAM,CAAC,EAAM,IAAA,EAAA,EAAA,SAAA,KACT,OAAO,OAAW,IACZ,CAAE,MAAO,EAAG,OAAQ,CAAE,EACtB,CAAE,MAAO,OAAO,WAAY,OAAQ,OAAO,WAAY,CACjE,EAWA,OATA,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,OAAO,OAAW,IAAa,OACnC,IAAM,MACF,EAAQ,CAAE,MAAO,OAAO,WAAY,OAAQ,OAAO,WAAY,CAAC,EAGpE,OAFA,EAAS,EACT,OAAO,iBAAiB,SAAU,EAAU,CAAE,QAAS,EAAK,CAAC,MAChD,OAAO,oBAAoB,SAAU,CAAQ,CAC9D,EAAG,CAAC,CAAC,EAEE,CACX"}

package/dist/hooks/use-window-size.js

@@ -0,0 +1,23 @@
+import { useEffect as e, useState as t } from "react";
+//#region src/hooks/use-window-size.ts
+function n() {
+	let [n, r] = t(() => typeof window > "u" ? {
+		width: 0,
+		height: 0
+	} : {
+		width: window.innerWidth,
+		height: window.innerHeight
+	});
+	return e(() => {
+		if (typeof window > "u") return;
+		let e = () => r({
+			width: window.innerWidth,
+			height: window.innerHeight
+		});
+		return e(), window.addEventListener("resize", e, { passive: !0 }), () => window.removeEventListener("resize", e);
+	}, []), n;
+}
+//#endregion
+export { n as useWindowSize };
+
+//# sourceMappingURL=use-window-size.js.map

package/dist/hooks/use-window-size.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-window-size.js","names":[],"sources":["../../src/hooks/use-window-size.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\nexport interface WindowSize {\n    width: number;\n    height: number;\n}\n\n/**\n * Reactive window dimensions. SSR-safe — returns `{ width: 0, height: 0 }`\n * until the first client render.\n *\n * @example\n * const { width, height } = useWindowSize();\n * const columns = width < 640 ? 1 : width < 1024 ? 2 : 3;\n */\nexport function useWindowSize(): WindowSize {\n    const [size, setSize] = useState<WindowSize>(() =>\n        typeof window === \"undefined\"\n            ? { width: 0, height: 0 }\n            : { width: window.innerWidth, height: window.innerHeight },\n    );\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const onResize = (): void =>\n            setSize({ width: window.innerWidth, height: window.innerHeight });\n        onResize();\n        window.addEventListener(\"resize\", onResize, { passive: true });\n        return () => window.removeEventListener(\"resize\", onResize);\n    }, []);\n\n    return size;\n}\n"],"mappings":";;AAeA,SAAgB,IAA4B;CACxC,IAAM,CAAC,GAAM,KAAW,QACpB,OAAO,SAAW,MACZ;EAAE,OAAO;EAAG,QAAQ;CAAE,IACtB;EAAE,OAAO,OAAO;EAAY,QAAQ,OAAO;CAAY,CACjE;CAWA,OATA,QAAgB;EACZ,IAAI,OAAO,SAAW,KAAa;EACnC,IAAM,UACF,EAAQ;GAAE,OAAO,OAAO;GAAY,QAAQ,OAAO;EAAY,CAAC;EAGpE,OAFA,EAAS,GACT,OAAO,iBAAiB,UAAU,GAAU,EAAE,SAAS,GAAK,CAAC,SAChD,OAAO,oBAAoB,UAAU,CAAQ;CAC9D,GAAG,CAAC,CAAC,GAEE;AACX"}

package/dist/http/api-client.cjs

@@ -0,0 +1,2 @@
+const e=require("../utils/ids.cjs"),t=require("./errors.cjs");function n(e,t,n){let r=new URL(t,e.endsWith(`/`)?e:`${e}/`);if(n)for(let[e,t]of Object.entries(n))t!=null&&r.searchParams.set(e,String(t));return r.toString()}function r(e){return typeof FormData<`u`&&e instanceof FormData}async function i(e,n){let r;try{r=await e.clone().json()}catch{try{r=await e.text()}catch{r=null}}return new t.TempestApiError(t.buildApiError(e.status,r,e.headers,n))}function a(t){let a=t.fetcher??globalThis.fetch.bind(globalThis);function o(){let e=t.getToken?.();return e?{Authorization:`Bearer ${e}`}:{}}async function s(e,i,s){let{body:c,params:l,headers:u,...d}=i,f=r(c),p={...f?{}:{"Content-Type":`application/json`},...s?{"X-Request-ID":s}:{},...t.headers,...o(),...u},m={...d,headers:p,credentials:t.withCredentials?`include`:d.credentials,body:c==null?void 0:f?c:JSON.stringify(c)};return a(n(t.baseURL,e,l),m)}async function c(n,r={}){let a=t.requestId?t.requestId():e.randomId(),o=await s(n,r,a);if(o.status===401)if(t.refresh)try{await t.refresh(),o=await s(n,r,a)}catch{throw await t.onUnauthorized?.(o),await i(o,a)}else await t.onUnauthorized?.(o);if(!o.ok)throw await i(o,a);if(o.status!==204)return(o.headers.get(`content-type`)??``).includes(`application/json`)?await o.json():await o.text()}async function l(e,t,n=`POST`){return c(e,{method:n,body:t})}return{request:c,get:(e,t)=>c(e,{...t,method:`GET`}),post:(e,t)=>c(e,{...t,method:`POST`}),put:(e,t)=>c(e,{...t,method:`PUT`}),patch:(e,t)=>c(e,{...t,method:`PATCH`}),delete:(e,t)=>c(e,{...t,method:`DELETE`}),upload:l}}exports.createApiClient=a;
+//# sourceMappingURL=api-client.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.cjs","names":[],"sources":["../../src/http/api-client.ts"],"sourcesContent":["import { randomId } from \"../utils\";\nimport { buildApiError, TempestApiError } from \"./errors\";\nimport type { ApiClient, ApiClientConfig, RequestOptions } from \"./types\";\n\nfunction buildUrl(baseURL: string, path: string, params?: RequestOptions[\"params\"]): string {\n    const url = new URL(path, baseURL.endsWith(\"/\") ? baseURL : `${baseURL}/`);\n    if (params) {\n        for (const [key, value] of Object.entries(params)) {\n            if (value !== undefined && value !== null) {\n                url.searchParams.set(key, String(value));\n            }\n        }\n    }\n    return url.toString();\n}\n\nfunction isFormData(body: unknown): body is FormData {\n    return typeof FormData !== \"undefined\" && body instanceof FormData;\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`,\n * automatic refresh + retry on 401 when `refresh` is supplied, and uploads\n * via `FormData`. Throws an `ApiError` on non-2xx responses.\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(buildUrl(config.baseURL, path, params), init);\n    }\n\n    async function request<T>(path: string, options: RequestOptions = {}): Promise<T> {\n        const requestId = config.requestId ? config.requestId() : randomId();\n        let response = await rawRequest(path, options, requestId);\n\n        if (response.status === 401) {\n            if (config.refresh) {\n                try {\n                    await config.refresh();\n                    response = await rawRequest(path, options, requestId);\n                } catch {\n                    await config.onUnauthorized?.(response);\n                    throw await parseError(response, requestId);\n                }\n            } else {\n                await config.onUnauthorized?.(response);\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 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":"8DAIA,SAAS,EAAS,EAAiB,EAAc,EAA2C,CACxF,IAAM,EAAM,IAAI,IAAI,EAAM,EAAQ,SAAS,GAAG,EAAI,EAAU,GAAG,EAAQ,EAAE,EACzE,GAAI,MACK,GAAM,CAAC,EAAK,KAAU,OAAO,QAAQ,CAAM,EACxC,GAAiC,MACjC,EAAI,aAAa,IAAI,EAAK,OAAO,CAAK,CAAC,EAInD,OAAO,EAAI,SAAS,CACxB,CAEA,SAAS,EAAW,EAAiC,CACjD,OAAO,OAAO,SAAa,KAAe,aAAgB,QAC9D,CAEA,eAAe,EAAW,EAAoB,EAAkD,CAC5F,IAAI,EACJ,GAAI,CACA,EAAO,MAAM,EAAS,MAAM,CAAC,CAAC,KAAK,CACvC,MAAQ,CACJ,GAAI,CACA,EAAO,MAAM,EAAS,KAAK,CAC/B,MAAQ,CACJ,EAAO,IACX,CACJ,CACA,OAAO,IAAI,EAAA,gBACP,EAAA,cAAc,EAAS,OAAQ,EAAM,EAAS,QAAS,CAAa,CACxE,CACJ,CASA,SAAgB,EAAgB,EAAoC,CAChE,IAAM,EAAU,EAAO,SAAW,WAAW,MAAM,KAAK,UAAU,EAElE,SAAS,GAAsC,CAC3C,IAAM,EAAQ,EAAO,WAAW,EAChC,OAAO,EAAQ,CAAE,cAAe,UAAU,GAAQ,EAAI,CAAC,CAC3D,CAEA,eAAe,EACX,EACA,EACA,EACiB,CACjB,GAAM,CAAE,OAAM,SAAQ,UAAS,GAAG,GAAS,EACrC,EAAS,EAAW,CAAI,EAExB,EAAuC,CACzC,GAAI,EAAS,CAAC,EAAI,CAAE,eAAgB,kBAAmB,EACvD,GAAI,EAAY,CAAE,eAAgB,CAAU,EAAI,CAAC,EACjD,GAAG,EAAO,QACV,GAAG,EAAY,EACf,GAAI,CACR,EAEM,EAAoB,CACtB,GAAG,EACH,QAAS,EACT,YAAa,EAAO,gBAAkB,UAAY,EAAK,YACvD,KACI,GAA+B,KACzB,IAAA,GACA,EACG,EACD,KAAK,UAAU,CAAI,CACnC,EAEA,OAAO,EAAQ,EAAS,EAAO,QAAS,EAAM,CAAM,EAAG,CAAI,CAC/D,CAEA,eAAe,EAAW,EAAc,EAA0B,CAAC,EAAe,CAC9E,IAAM,EAAY,EAAO,UAAY,EAAO,UAAU,EAAI,EAAA,SAAS,EAC/D,EAAW,MAAM,EAAW,EAAM,EAAS,CAAS,EAExD,GAAI,EAAS,SAAW,IACpB,GAAI,EAAO,QACP,GAAI,CACA,MAAM,EAAO,QAAQ,EACrB,EAAW,MAAM,EAAW,EAAM,EAAS,CAAS,CACxD,MAAQ,CAEJ,MADA,MAAM,EAAO,iBAAiB,CAAQ,EAChC,MAAM,EAAW,EAAU,CAAS,CAC9C,MAEA,MAAM,EAAO,iBAAiB,CAAQ,EAI9C,GAAI,CAAC,EAAS,GACV,MAAM,MAAM,EAAW,EAAU,CAAS,EAG1C,KAAS,SAAW,IAQxB,OAJoB,EAAS,QAAQ,IAAI,cAAc,GAAK,GAAA,CAC5C,SAAS,kBAAkB,EAC/B,MAAM,EAAS,KAAK,EAExB,MAAM,EAAS,KAAK,CAChC,CAEA,eAAe,EACX,EACA,EACA,EAAmC,OACzB,CACV,OAAO,EAAW,EAAM,CAAE,SAAQ,KAAM,CAAS,CAAC,CACtD,CAEA,MAAO,CACH,UACA,KAAS,EAAc,IACnB,EAAW,EAAM,CAAE,GAAG,EAAS,OAAQ,KAAM,CAAC,EAClD,MAAU,EAAc,IACpB,EAAW,EAAM,CAAE,GAAG,EAAS,OAAQ,MAAO,CAAC,EACnD,KAAS,EAAc,IACnB,EAAW,EAAM,CAAE,GAAG,EAAS,OAAQ,KAAM,CAAC,EAClD,OAAW,EAAc,IACrB,EAAW,EAAM,CAAE,GAAG,EAAS,OAAQ,OAAQ,CAAC,EACpD,QAAY,EAAc,IACtB,EAAW,EAAM,CAAE,GAAG,EAAS,OAAQ,QAAS,CAAC,EACrD,QACJ,CACJ"}

package/dist/http/api-client.js

@@ -0,0 +1,91 @@
+import { randomId as e } from "../utils/ids.js";
+import { TempestApiError as t, buildApiError as n } from "./errors.js";
+//#region src/http/api-client.ts
+function r(e, t, n) {
+	let r = new URL(t, e.endsWith("/") ? e : `${e}/`);
+	if (n) for (let [e, t] of Object.entries(n)) t != null && r.searchParams.set(e, String(t));
+	return r.toString();
+}
+function i(e) {
+	return typeof FormData < "u" && e instanceof FormData;
+}
+async function a(e, r) {
+	let i;
+	try {
+		i = await e.clone().json();
+	} catch {
+		try {
+			i = await e.text();
+		} catch {
+			i = null;
+		}
+	}
+	return new t(n(e.status, i, e.headers, r));
+}
+function o(t) {
+	let n = t.fetcher ?? globalThis.fetch.bind(globalThis);
+	function o() {
+		let e = t.getToken?.();
+		return e ? { Authorization: `Bearer ${e}` } : {};
+	}
+	async function s(e, a, s) {
+		let { body: c, params: l, headers: u, ...d } = a, f = i(c), p = {
+			...f ? {} : { "Content-Type": "application/json" },
+			...s ? { "X-Request-ID": s } : {},
+			...t.headers,
+			...o(),
+			...u
+		}, m = {
+			...d,
+			headers: p,
+			credentials: t.withCredentials ? "include" : d.credentials,
+			body: c == null ? void 0 : f ? c : JSON.stringify(c)
+		};
+		return n(r(t.baseURL, e, l), m);
+	}
+	async function c(n, r = {}) {
+		let i = t.requestId ? t.requestId() : e(), o = await s(n, r, i);
+		if (o.status === 401) if (t.refresh) try {
+			await t.refresh(), o = await s(n, r, i);
+		} catch {
+			throw await t.onUnauthorized?.(o), await a(o, i);
+		}
+		else await t.onUnauthorized?.(o);
+		if (!o.ok) throw await a(o, i);
+		if (o.status !== 204) return (o.headers.get("content-type") ?? "").includes("application/json") ? await o.json() : await o.text();
+	}
+	async function l(e, t, n = "POST") {
+		return c(e, {
+			method: n,
+			body: t
+		});
+	}
+	return {
+		request: c,
+		get: (e, t) => c(e, {
+			...t,
+			method: "GET"
+		}),
+		post: (e, t) => c(e, {
+			...t,
+			method: "POST"
+		}),
+		put: (e, t) => c(e, {
+			...t,
+			method: "PUT"
+		}),
+		patch: (e, t) => c(e, {
+			...t,
+			method: "PATCH"
+		}),
+		delete: (e, t) => c(e, {
+			...t,
+			method: "DELETE"
+		}),
+		upload: l
+	};
+}
+//#endregion
+export { o as createApiClient };
+
+//# sourceMappingURL=api-client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","names":[],"sources":["../../src/http/api-client.ts"],"sourcesContent":["import { randomId } from \"../utils\";\nimport { buildApiError, TempestApiError } from \"./errors\";\nimport type { ApiClient, ApiClientConfig, RequestOptions } from \"./types\";\n\nfunction buildUrl(baseURL: string, path: string, params?: RequestOptions[\"params\"]): string {\n    const url = new URL(path, baseURL.endsWith(\"/\") ? baseURL : `${baseURL}/`);\n    if (params) {\n        for (const [key, value] of Object.entries(params)) {\n            if (value !== undefined && value !== null) {\n                url.searchParams.set(key, String(value));\n            }\n        }\n    }\n    return url.toString();\n}\n\nfunction isFormData(body: unknown): body is FormData {\n    return typeof FormData !== \"undefined\" && body instanceof FormData;\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`,\n * automatic refresh + retry on 401 when `refresh` is supplied, and uploads\n * via `FormData`. Throws an `ApiError` on non-2xx responses.\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(buildUrl(config.baseURL, path, params), init);\n    }\n\n    async function request<T>(path: string, options: RequestOptions = {}): Promise<T> {\n        const requestId = config.requestId ? config.requestId() : randomId();\n        let response = await rawRequest(path, options, requestId);\n\n        if (response.status === 401) {\n            if (config.refresh) {\n                try {\n                    await config.refresh();\n                    response = await rawRequest(path, options, requestId);\n                } catch {\n                    await config.onUnauthorized?.(response);\n                    throw await parseError(response, requestId);\n                }\n            } else {\n                await config.onUnauthorized?.(response);\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 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/errors.cjs

@@ -0,0 +1,2 @@
+var e=class extends Error{status;detail;code;requestId;body;constructor(e){super(e.detail),this.name=`TempestApiError`,this.status=e.status,this.detail=e.detail,this.code=e.code,this.requestId=e.requestId,this.body=e.body}};function t(e){return typeof e==`object`&&!!e&&typeof e.status==`number`&&typeof e.detail==`string`}function n(e,t,n,i){let a=typeof t==`object`&&t?t:null,o=a?.detail??a?.message??`Erro ${e}`,s=typeof a?.code==`string`?a.code:void 0,c=typeof a?.details==`object`&&a.details!==null?a.details:null,l=(typeof c?.request_id==`string`?c.request_id:void 0)??n?.get(`X-Request-ID`)??i??void 0;return{status:e,detail:String(o),code:s,requestId:l??void 0,retryAfter:r(n?.get(`Retry-After`)),body:t}}function r(e){if(!e)return;let t=e.trim();if(/^\d+$/.test(t))return Number(t);let n=Date.parse(t);if(!Number.isNaN(n))return Math.max(0,Math.round((n-Date.now())/1e3))}exports.TempestApiError=e,exports.buildApiError=n,exports.isApiError=t,exports.parseRetryAfter=r;
+//# sourceMappingURL=errors.cjs.map

package/dist/http/errors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.cjs","names":[],"sources":["../../src/http/errors.ts"],"sourcesContent":["import type { ApiError } from \"./types\";\n\n/**\n * Error thrown by {@link createApiClient} / {@link uploadWithProgress} on a\n * non-2xx response. Mirrors the Tempest FastAPI SDK error envelope\n * (`{ detail, code, details.request_id }`) so callers get a typed `code` and a\n * `requestId` for log correlation, while still being a real `Error` (stack\n * trace, `instanceof Error`).\n *\n * @example\n * try {\n *     await api.post(\"/users\", { body });\n * } catch (err) {\n *     if (isApiError(err) && err.code === \"EMAIL_TAKEN\") {\n *         showFieldError(\"email\", err.detail);\n *     }\n * }\n */\nexport class TempestApiError extends Error implements ApiError {\n    readonly status: number;\n    readonly detail: string;\n    readonly code?: string;\n    readonly requestId?: string;\n    readonly body?: unknown;\n\n    constructor(init: ApiError) {\n        super(init.detail);\n        this.name = \"TempestApiError\";\n        this.status = init.status;\n        this.detail = init.detail;\n        this.code = init.code;\n        this.requestId = init.requestId;\n        this.body = init.body;\n    }\n}\n\n/**\n * Type guard for the {@link ApiError} shape. Matches both {@link TempestApiError}\n * instances and plain objects carrying `status` + `detail`.\n *\n * @param error - The unknown value (typically a caught error).\n * @returns Whether `error` conforms to the `ApiError` contract.\n */\nexport function isApiError(error: unknown): error is ApiError {\n    return (\n        typeof error === \"object\" &&\n        error !== null &&\n        typeof (error as ApiError).status === \"number\" &&\n        typeof (error as ApiError).detail === \"string\"\n    );\n}\n\n/**\n * Parse an error body + response into the Tempest {@link ApiError} envelope.\n *\n * Reads `detail`/`message`, the programmatic `code`, and the correlation id\n * from `details.request_id` (falling back to the `X-Request-ID` header, then\n * the id the client sent).\n *\n * @param status - HTTP status code.\n * @param body - The parsed error body (object, string, or null).\n * @param headers - The response headers (for the `X-Request-ID` fallback).\n * @param sentRequestId - The id the client sent on the request, if any.\n * @returns A fully-populated `ApiError`.\n */\nexport function buildApiError(\n    status: number,\n    body: unknown,\n    headers?: Headers | { get(name: string): string | null },\n    sentRequestId?: string,\n): ApiError {\n    const obj =\n        typeof body === \"object\" && body !== null ? (body as Record<string, unknown>) : null;\n    const detail = obj?.detail ?? obj?.message ?? `Erro ${status}`;\n    const code = typeof obj?.code === \"string\" ? obj.code : undefined;\n    const details =\n        typeof obj?.details === \"object\" && obj.details !== null\n            ? (obj.details as Record<string, unknown>)\n            : null;\n    const requestId =\n        (typeof details?.request_id === \"string\" ? details.request_id : undefined) ??\n        headers?.get(\"X-Request-ID\") ??\n        sentRequestId ??\n        undefined;\n\n    return {\n        status,\n        detail: String(detail),\n        code,\n        requestId: requestId ?? undefined,\n        retryAfter: parseRetryAfter(headers?.get(\"Retry-After\")),\n        body,\n    };\n}\n\n/**\n * Parse a `Retry-After` header into seconds. Accepts a delta-seconds integer\n * (`\"120\"`) or an HTTP-date (`\"Wed, 21 Oct 2015 07:28:00 GMT\"`).\n *\n * @param value - The raw header value, or null.\n * @returns The delay in seconds (>= 0), or undefined when absent/unparseable.\n */\nexport function parseRetryAfter(value: string | null | undefined): number | undefined {\n    if (!value) return undefined;\n    const trimmed = value.trim();\n    if (/^\\d+$/.test(trimmed)) return Number(trimmed);\n    const when = Date.parse(trimmed);\n    if (Number.isNaN(when)) return undefined;\n    return Math.max(0, Math.round((when - Date.now()) / 1000));\n}\n"],"mappings":"AAkBA,IAAa,EAAb,cAAqC,KAA0B,CAC3D,OACA,OACA,KACA,UACA,KAEA,YAAY,EAAgB,CACxB,MAAM,EAAK,MAAM,EACjB,KAAK,KAAO,kBACZ,KAAK,OAAS,EAAK,OACnB,KAAK,OAAS,EAAK,OACnB,KAAK,KAAO,EAAK,KACjB,KAAK,UAAY,EAAK,UACtB,KAAK,KAAO,EAAK,IACrB,CACJ,EASA,SAAgB,EAAW,EAAmC,CAC1D,OACI,OAAO,GAAU,YACjB,GACA,OAAQ,EAAmB,QAAW,UACtC,OAAQ,EAAmB,QAAW,QAE9C,CAeA,SAAgB,EACZ,EACA,EACA,EACA,EACQ,CACR,IAAM,EACF,OAAO,GAAS,UAAY,EAAiB,EAAmC,KAC9E,EAAS,GAAK,QAAU,GAAK,SAAW,QAAQ,IAChD,EAAO,OAAO,GAAK,MAAS,SAAW,EAAI,KAAO,IAAA,GAClD,EACF,OAAO,GAAK,SAAY,UAAY,EAAI,UAAY,KAC7C,EAAI,QACL,KACJ,GACD,OAAO,GAAS,YAAe,SAAW,EAAQ,WAAa,IAAA,KAChE,GAAS,IAAI,cAAc,GAC3B,GACA,IAAA,GAEJ,MAAO,CACH,SACA,OAAQ,OAAO,CAAM,EACrB,OACA,UAAW,GAAa,IAAA,GACxB,WAAY,EAAgB,GAAS,IAAI,aAAa,CAAC,EACvD,MACJ,CACJ,CASA,SAAgB,EAAgB,EAAsD,CAClF,GAAI,CAAC,EAAO,OACZ,IAAM,EAAU,EAAM,KAAK,EAC3B,GAAI,QAAQ,KAAK,CAAO,EAAG,OAAO,OAAO,CAAO,EAChD,IAAM,EAAO,KAAK,MAAM,CAAO,EAC3B,WAAO,MAAM,CAAI,EACrB,OAAO,KAAK,IAAI,EAAG,KAAK,OAAO,EAAO,KAAK,IAAI,GAAK,GAAI,CAAC,CAC7D"}

package/dist/http/errors.js

@@ -0,0 +1,36 @@
+//#region src/http/errors.ts
+var e = class extends Error {
+	status;
+	detail;
+	code;
+	requestId;
+	body;
+	constructor(e) {
+		super(e.detail), this.name = "TempestApiError", this.status = e.status, this.detail = e.detail, this.code = e.code, this.requestId = e.requestId, this.body = e.body;
+	}
+};
+function t(e) {
+	return typeof e == "object" && !!e && typeof e.status == "number" && typeof e.detail == "string";
+}
+function n(e, t, n, i) {
+	let a = typeof t == "object" && t ? t : null, o = a?.detail ?? a?.message ?? `Erro ${e}`, s = typeof a?.code == "string" ? a.code : void 0, c = typeof a?.details == "object" && a.details !== null ? a.details : null, l = (typeof c?.request_id == "string" ? c.request_id : void 0) ?? n?.get("X-Request-ID") ?? i ?? void 0;
+	return {
+		status: e,
+		detail: String(o),
+		code: s,
+		requestId: l ?? void 0,
+		retryAfter: r(n?.get("Retry-After")),
+		body: t
+	};
+}
+function r(e) {
+	if (!e) return;
+	let t = e.trim();
+	if (/^\d+$/.test(t)) return Number(t);
+	let n = Date.parse(t);
+	if (!Number.isNaN(n)) return Math.max(0, Math.round((n - Date.now()) / 1e3));
+}
+//#endregion
+export { e as TempestApiError, n as buildApiError, t as isApiError, r as parseRetryAfter };
+
+//# sourceMappingURL=errors.js.map

package/dist/http/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","names":[],"sources":["../../src/http/errors.ts"],"sourcesContent":["import type { ApiError } from \"./types\";\n\n/**\n * Error thrown by {@link createApiClient} / {@link uploadWithProgress} on a\n * non-2xx response. Mirrors the Tempest FastAPI SDK error envelope\n * (`{ detail, code, details.request_id }`) so callers get a typed `code` and a\n * `requestId` for log correlation, while still being a real `Error` (stack\n * trace, `instanceof Error`).\n *\n * @example\n * try {\n *     await api.post(\"/users\", { body });\n * } catch (err) {\n *     if (isApiError(err) && err.code === \"EMAIL_TAKEN\") {\n *         showFieldError(\"email\", err.detail);\n *     }\n * }\n */\nexport class TempestApiError extends Error implements ApiError {\n    readonly status: number;\n    readonly detail: string;\n    readonly code?: string;\n    readonly requestId?: string;\n    readonly body?: unknown;\n\n    constructor(init: ApiError) {\n        super(init.detail);\n        this.name = \"TempestApiError\";\n        this.status = init.status;\n        this.detail = init.detail;\n        this.code = init.code;\n        this.requestId = init.requestId;\n        this.body = init.body;\n    }\n}\n\n/**\n * Type guard for the {@link ApiError} shape. Matches both {@link TempestApiError}\n * instances and plain objects carrying `status` + `detail`.\n *\n * @param error - The unknown value (typically a caught error).\n * @returns Whether `error` conforms to the `ApiError` contract.\n */\nexport function isApiError(error: unknown): error is ApiError {\n    return (\n        typeof error === \"object\" &&\n        error !== null &&\n        typeof (error as ApiError).status === \"number\" &&\n        typeof (error as ApiError).detail === \"string\"\n    );\n}\n\n/**\n * Parse an error body + response into the Tempest {@link ApiError} envelope.\n *\n * Reads `detail`/`message`, the programmatic `code`, and the correlation id\n * from `details.request_id` (falling back to the `X-Request-ID` header, then\n * the id the client sent).\n *\n * @param status - HTTP status code.\n * @param body - The parsed error body (object, string, or null).\n * @param headers - The response headers (for the `X-Request-ID` fallback).\n * @param sentRequestId - The id the client sent on the request, if any.\n * @returns A fully-populated `ApiError`.\n */\nexport function buildApiError(\n    status: number,\n    body: unknown,\n    headers?: Headers | { get(name: string): string | null },\n    sentRequestId?: string,\n): ApiError {\n    const obj =\n        typeof body === \"object\" && body !== null ? (body as Record<string, unknown>) : null;\n    const detail = obj?.detail ?? obj?.message ?? `Erro ${status}`;\n    const code = typeof obj?.code === \"string\" ? obj.code : undefined;\n    const details =\n        typeof obj?.details === \"object\" && obj.details !== null\n            ? (obj.details as Record<string, unknown>)\n            : null;\n    const requestId =\n        (typeof details?.request_id === \"string\" ? details.request_id : undefined) ??\n        headers?.get(\"X-Request-ID\") ??\n        sentRequestId ??\n        undefined;\n\n    return {\n        status,\n        detail: String(detail),\n        code,\n        requestId: requestId ?? undefined,\n        retryAfter: parseRetryAfter(headers?.get(\"Retry-After\")),\n        body,\n    };\n}\n\n/**\n * Parse a `Retry-After` header into seconds. Accepts a delta-seconds integer\n * (`\"120\"`) or an HTTP-date (`\"Wed, 21 Oct 2015 07:28:00 GMT\"`).\n *\n * @param value - The raw header value, or null.\n * @returns The delay in seconds (>= 0), or undefined when absent/unparseable.\n */\nexport function parseRetryAfter(value: string | null | undefined): number | undefined {\n    if (!value) return undefined;\n    const trimmed = value.trim();\n    if (/^\\d+$/.test(trimmed)) return Number(trimmed);\n    const when = Date.parse(trimmed);\n    if (Number.isNaN(when)) return undefined;\n    return Math.max(0, Math.round((when - Date.now()) / 1000));\n}\n"],"mappings":";AAkBA,IAAa,IAAb,cAAqC,MAA0B;CAC3D;CACA;CACA;CACA;CACA;CAEA,YAAY,GAAgB;EAOxB,AANA,MAAM,EAAK,MAAM,GACjB,KAAK,OAAO,mBACZ,KAAK,SAAS,EAAK,QACnB,KAAK,SAAS,EAAK,QACnB,KAAK,OAAO,EAAK,MACjB,KAAK,YAAY,EAAK,WACtB,KAAK,OAAO,EAAK;CACrB;AACJ;AASA,SAAgB,EAAW,GAAmC;CAC1D,OACI,OAAO,KAAU,cACjB,KACA,OAAQ,EAAmB,UAAW,YACtC,OAAQ,EAAmB,UAAW;AAE9C;AAeA,SAAgB,EACZ,GACA,GACA,GACA,GACQ;CACR,IAAM,IACF,OAAO,KAAS,YAAY,IAAiB,IAAmC,MAC9E,IAAS,GAAK,UAAU,GAAK,WAAW,QAAQ,KAChD,IAAO,OAAO,GAAK,QAAS,WAAW,EAAI,OAAO,KAAA,GAClD,IACF,OAAO,GAAK,WAAY,YAAY,EAAI,YAAY,OAC7C,EAAI,UACL,MACJ,KACD,OAAO,GAAS,cAAe,WAAW,EAAQ,aAAa,KAAA,MAChE,GAAS,IAAI,cAAc,KAC3B,KACA,KAAA;CAEJ,OAAO;EACH;EACA,QAAQ,OAAO,CAAM;EACrB;EACA,WAAW,KAAa,KAAA;EACxB,YAAY,EAAgB,GAAS,IAAI,aAAa,CAAC;EACvD;CACJ;AACJ;AASA,SAAgB,EAAgB,GAAsD;CAClF,IAAI,CAAC,GAAO;CACZ,IAAM,IAAU,EAAM,KAAK;CAC3B,IAAI,QAAQ,KAAK,CAAO,GAAG,OAAO,OAAO,CAAO;CAChD,IAAM,IAAO,KAAK,MAAM,CAAO;CAC3B,YAAO,MAAM,CAAI,GACrB,OAAO,KAAK,IAAI,GAAG,KAAK,OAAO,IAAO,KAAK,IAAI,KAAK,GAAI,CAAC;AAC7D"}

package/dist/http/idempotency.cjs

@@ -0,0 +1,2 @@
+function e(){return typeof crypto<`u`&&`randomUUID`in crypto?crypto.randomUUID():`xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx`.replace(/[xy]/g,e=>{let t=Math.random()*16;return(e===`x`?Math.floor(t):Math.floor(t)&3|8).toString(16)})}exports.generateIdempotencyKey=e;
+//# sourceMappingURL=idempotency.cjs.map

package/dist/http/idempotency.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.cjs","names":[],"sources":["../../src/http/idempotency.ts"],"sourcesContent":["/**\n * Generate an RFC4122 v4 idempotency key (UUID). Use as the value for an\n * `Idempotency-Key` header on POST/PATCH requests that must not run twice.\n */\nexport function generateIdempotencyKey(): string {\n    if (typeof crypto !== \"undefined\" && \"randomUUID\" in crypto) {\n        return crypto.randomUUID();\n    }\n    return \"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\".replace(/[xy]/g, (c) => {\n        const r = Math.random() * 16;\n        const value = c === \"x\" ? Math.floor(r) : (Math.floor(r) & 0x3) | 0x8;\n        return value.toString(16);\n    });\n}\n"],"mappings":"AAIA,SAAgB,GAAiC,CAI7C,OAHI,OAAO,OAAW,KAAe,eAAgB,OAC1C,OAAO,WAAW,EAEtB,uCAAuC,QAAQ,QAAU,GAAM,CAClE,IAAM,EAAI,KAAK,OAAO,EAAI,GAE1B,OADc,IAAM,IAAM,KAAK,MAAM,CAAC,EAAK,KAAK,MAAM,CAAC,EAAI,EAAO,EAAA,CACrD,SAAS,EAAE,CAC5B,CAAC,CACL"}

package/dist/http/idempotency.js

@@ -0,0 +1,11 @@
+//#region src/http/idempotency.ts
+function e() {
+	return typeof crypto < "u" && "randomUUID" in crypto ? crypto.randomUUID() : "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (e) => {
+		let t = Math.random() * 16;
+		return (e === "x" ? Math.floor(t) : Math.floor(t) & 3 | 8).toString(16);
+	});
+}
+//#endregion
+export { e as generateIdempotencyKey };
+
+//# sourceMappingURL=idempotency.js.map

package/dist/http/idempotency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.js","names":[],"sources":["../../src/http/idempotency.ts"],"sourcesContent":["/**\n * Generate an RFC4122 v4 idempotency key (UUID). Use as the value for an\n * `Idempotency-Key` header on POST/PATCH requests that must not run twice.\n */\nexport function generateIdempotencyKey(): string {\n    if (typeof crypto !== \"undefined\" && \"randomUUID\" in crypto) {\n        return crypto.randomUUID();\n    }\n    return \"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\".replace(/[xy]/g, (c) => {\n        const r = Math.random() * 16;\n        const value = c === \"x\" ? Math.floor(r) : (Math.floor(r) & 0x3) | 0x8;\n        return value.toString(16);\n    });\n}\n"],"mappings":";AAIA,SAAgB,IAAiC;CAI7C,OAHI,OAAO,SAAW,OAAe,gBAAgB,SAC1C,OAAO,WAAW,IAEtB,uCAAuC,QAAQ,UAAU,MAAM;EAClE,IAAM,IAAI,KAAK,OAAO,IAAI;EAE1B,QADc,MAAM,MAAM,KAAK,MAAM,CAAC,IAAK,KAAK,MAAM,CAAC,IAAI,IAAO,EAAA,CACrD,SAAS,EAAE;CAC5B,CAAC;AACL"}

package/dist/http/parse-response.cjs

@@ -0,0 +1,3 @@
+function e(e,t,n){let r=e.safeParse(t);if(r.success)return r.data;if(typeof process<`u`&&(process.env.NODE_ENV===`development`||process.env.NODE_ENV===`test`)){let e=r.error.issues.map(e=>`  - ${e.path.join(`.`)||`<root>`}: ${e.message}`).join(`
+`);throw Error(`[parseResponse] Contract drift on ${n}:\n${e}\n\nRaw payload: ${JSON.stringify(t,null,2)}`)}throw Error(`Resposta inválida do servidor (${n}).`)}exports.parseResponse=e;
+//# sourceMappingURL=parse-response.cjs.map

package/dist/http/parse-response.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-response.cjs","names":[],"sources":["../../src/http/parse-response.ts"],"sourcesContent":["import type { z } from \"zod\";\n\n/**\n * Validate an unknown response payload against a zod schema.\n *\n * In development, throws a detailed error pointing at the divergent field.\n * In production, throws a generic error so internals do not leak to users.\n *\n * @param schema - The zod schema to parse against.\n * @param raw - The raw response payload.\n * @param context - A label used in error messages, e.g. \"POST /auth/login\".\n * @returns The parsed, typed payload.\n */\nexport function parseResponse<TSchema extends z.ZodTypeAny>(\n    schema: TSchema,\n    raw: unknown,\n    context: string,\n): z.infer<TSchema> {\n    const result = schema.safeParse(raw);\n    if (result.success) {\n        return result.data;\n    }\n\n    const isDev =\n        typeof process !== \"undefined\" &&\n        (process.env?.NODE_ENV === \"development\" || process.env?.NODE_ENV === \"test\");\n\n    if (isDev) {\n        const issues = result.error.issues\n            .map((i) => `  - ${i.path.join(\".\") || \"<root>\"}: ${i.message}`)\n            .join(\"\\n\");\n        throw new Error(\n            `[parseResponse] Contract drift on ${context}:\\n${issues}\\n\\nRaw payload: ${JSON.stringify(raw, null, 2)}`,\n        );\n    }\n    throw new Error(`Resposta inválida do servidor (${context}).`);\n}\n"],"mappings":"AAaA,SAAgB,EACZ,EACA,EACA,EACgB,CAChB,IAAM,EAAS,EAAO,UAAU,CAAG,EACnC,GAAI,EAAO,QACP,OAAO,EAAO,KAOlB,GAHI,OAAO,QAAY,MAAA,QAAA,IAAA,WACQ,eAAA,QAAA,IAAA,WAA2C,QAE/D,CACP,IAAM,EAAS,EAAO,MAAM,OACvB,IAAK,GAAM,OAAO,EAAE,KAAK,KAAK,GAAG,GAAK,SAAS,IAAI,EAAE,SAAS,CAAC,CAC/D,KAAK;CAAI,EACd,MAAU,MACN,qCAAqC,EAAQ,KAAK,EAAO,mBAAmB,KAAK,UAAU,EAAK,KAAM,CAAC,GAC3G,CACJ,CACA,MAAU,MAAM,kCAAkC,EAAQ,GAAG,CACjE"}