tempest-react-sdk 0.22.0 → 0.24.0

package/dist/push/use-push-subscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-push-subscription.js","names":[],"sources":["../../src/push/use-push-subscription.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport { WebPushClient, type WebPushClientConfig } from \"./web-push-client\";\nimport { isPushSupported } from \"./utils\";\n\nexport interface UsePushSubscriptionResult {\n    /** True when the browser exposes the Push + Notification APIs. */\n    supported: boolean;\n    /** Current `Notification.permission` value, or `\"unsupported\"`. */\n    permission: NotificationPermission | \"unsupported\";\n    /** True when a subscription is active on this device. */\n    subscribed: boolean;\n    /** True while a subscribe/unsubscribe call is in-flight. */\n    loading: boolean;\n    /** Last error thrown by subscribe/unsubscribe, if any. */\n    error: Error | null;\n    subscribe: () => Promise<void>;\n    unsubscribe: () => Promise<void>;\n    /** Re-read the current subscription/permission state from the browser. */\n    refresh: () => Promise<void>;\n}\n\n/**\n * React hook around {@link WebPushClient}. Tracks subscription, permission and\n * loading state; exposes imperative `subscribe`/`unsubscribe` actions.\n *\n * The hook does NOT register the service worker — the host app must do that\n * (e.g. via `vite-plugin-pwa` or a manual `navigator.serviceWorker.register`).\n *\n * @example\n * const push = usePushSubscription({\n *     vapidPublicKey: import.meta.env.VITE_VAPID_PUBLIC_KEY,\n *     onSubscribe: (sub) => api.post(\"/webpush/subscribe\", { body: sub }),\n *     onUnsubscribe: () => api.delete(\"/webpush/my\"),\n * });\n */\nexport function usePushSubscription(config: WebPushClientConfig): UsePushSubscriptionResult {\n    const configRef = useRef(config);\n    configRef.current = config;\n\n    const client = useMemo(\n        () =>\n            new WebPushClient({\n                vapidPublicKey: config.vapidPublicKey,\n                onSubscribe: (sub) => configRef.current.onSubscribe(sub),\n                onUnsubscribe: (sub) => configRef.current.onUnsubscribe?.(sub),\n                getRegistration: config.getRegistration,\n            }),\n        [config.vapidPublicKey, config.getRegistration],\n    );\n\n    const [supported] = useState<boolean>(() => isPushSupported());\n    const [permission, setPermission] = useState<NotificationPermission | \"unsupported\">(() =>\n        client.permission(),\n    );\n    const [subscribed, setSubscribed] = useState<boolean>(false);\n    const [loading, setLoading] = useState<boolean>(false);\n    const [error, setError] = useState<Error | null>(null);\n\n    const refresh = useCallback(async () => {\n        if (!supported) return;\n        setPermission(client.permission());\n        try {\n            const active = await client.isSubscribed();\n            setSubscribed(active);\n        } catch (err) {\n            setError(err instanceof Error ? err : new Error(String(err)));\n        }\n    }, [client, supported]);\n\n    useEffect(() => {\n        void refresh();\n    }, [refresh]);\n\n    const subscribe = useCallback(async () => {\n        if (!supported) return;\n        setLoading(true);\n        setError(null);\n        try {\n            await client.subscribe();\n            setSubscribed(true);\n            setPermission(client.permission());\n        } catch (err) {\n            setError(err instanceof Error ? err : new Error(String(err)));\n            throw err;\n        } finally {\n            setLoading(false);\n        }\n    }, [client, supported]);\n\n    const unsubscribe = useCallback(async () => {\n        if (!supported) return;\n        setLoading(true);\n        setError(null);\n        try {\n            await client.unsubscribe();\n            setSubscribed(false);\n        } catch (err) {\n            setError(err instanceof Error ? err : new Error(String(err)));\n            throw err;\n        } finally {\n            setLoading(false);\n        }\n    }, [client, supported]);\n\n    return {\n        supported,\n        permission,\n        subscribed,\n        loading,\n        error,\n        subscribe,\n        unsubscribe,\n        refresh,\n    };\n}\n"],"mappings":";;;;AAmCA,SAAgB,EAAoB,GAAwD;CACxF,IAAM,IAAY,EAAO,CAAM;CAC/B,EAAU,UAAU;CAEpB,IAAM,IAAS,QAEP,IAAI,EAAc;EACd,gBAAgB,EAAO;EACvB,cAAc,MAAQ,EAAU,QAAQ,YAAY,CAAG;EACvD,gBAAgB,MAAQ,EAAU,QAAQ,gBAAgB,CAAG;EAC7D,iBAAiB,EAAO;CAC5B,CAAC,GACL,CAAC,EAAO,gBAAgB,EAAO,eAAe,CAClD,GAEM,CAAC,KAAa,QAAwB,EAAgB,CAAC,GACvD,CAAC,GAAY,KAAiB,QAChC,EAAO,WAAW,CACtB,GACM,CAAC,GAAY,KAAiB,EAAkB,EAAK,GACrD,CAAC,GAAS,KAAc,EAAkB,EAAK,GAC/C,CAAC,GAAO,KAAY,EAAuB,IAAI,GAE/C,IAAU,EAAY,YAAY;EAC/B,OACL;KAAc,EAAO,WAAW,CAAC;GACjC,IAAI;IACA,IAAM,IAAS,MAAM,EAAO,aAAa;IACzC,EAAc,CAAM;GACxB,SAAS,GAAK;IACV,EAAS,aAAe,QAAQ,IAAU,MAAM,OAAO,CAAG,CAAC,CAAC;GAChE;EANiC;CAOrC,GAAG,CAAC,GAAQ,CAAS,CAAC;CAqCtB,OAnCA,QAAgB;EACZ,EAAa;CACjB,GAAG,CAAC,CAAO,CAAC,GAiCL;EACH;EACA;EACA;EACA;EACA;EACA,WArCc,EAAY,YAAY;GACjC,OAEL;IADA,EAAW,EAAI,GACf,EAAS,IAAI;IACb,IAAI;KAGA,AAFA,MAAM,EAAO,UAAU,GACvB,EAAc,EAAI,GAClB,EAAc,EAAO,WAAW,CAAC;IACrC,SAAS,GAAK;KAEV,MADA,EAAS,aAAe,QAAQ,IAAU,MAAM,OAAO,CAAG,CAAC,CAAC,GACtD;IACV,UAAU;KACN,EAAW,EAAK;IACpB;GAVa;EAWjB,GAAG,CAAC,GAAQ,CAAS,CAuBjB;EACA,aAtBgB,EAAY,YAAY;GACnC,OAEL;IADA,EAAW,EAAI,GACf,EAAS,IAAI;IACb,IAAI;KAEA,AADA,MAAM,EAAO,YAAY,GACzB,EAAc,EAAK;IACvB,SAAS,GAAK;KAEV,MADA,EAAS,aAAe,QAAQ,IAAU,MAAM,OAAO,CAAG,CAAC,CAAC,GACtD;IACV,UAAU;KACN,EAAW,EAAK;IACpB;GATa;EAUjB,GAAG,CAAC,GAAQ,CAAS,CASjB;EACA;CACJ;AACJ"}

package/dist/push/utils.cjs

@@ -0,0 +1,2 @@
+function e(e){let t=(e+`=`.repeat((4-e.length%4)%4)).replace(/-/g,`+`).replace(/_/g,`/`),n=window.atob(t),r=new ArrayBuffer(n.length),i=new Uint8Array(r);for(let e=0;e<n.length;e++)i[e]=n.charCodeAt(e);return i}function t(){return typeof window<`u`&&`serviceWorker`in navigator&&`PushManager`in window&&`Notification`in window}exports.isPushSupported=t,exports.urlBase64ToUint8Array=e;
+//# sourceMappingURL=utils.cjs.map

package/dist/push/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.cjs","names":[],"sources":["../../src/push/utils.ts"],"sourcesContent":["/**\n * Convert a base64url-encoded VAPID public key into the `Uint8Array` format\n * required by `PushManager.subscribe({ applicationServerKey })`.\n *\n * @param base64String - VAPID public key (URL-safe base64).\n * @returns The decoded key as bytes.\n */\nexport function urlBase64ToUint8Array(base64String: string): Uint8Array<ArrayBuffer> {\n    const padding = \"=\".repeat((4 - (base64String.length % 4)) % 4);\n    const base64 = (base64String + padding).replace(/-/g, \"+\").replace(/_/g, \"/\");\n    const rawData = window.atob(base64);\n    const buffer = new ArrayBuffer(rawData.length);\n    const output = new Uint8Array(buffer);\n    for (let i = 0; i < rawData.length; i++) {\n        output[i] = rawData.charCodeAt(i);\n    }\n    return output;\n}\n\n/**\n * Convenience check for environments where the Push API is unavailable\n * (Safari iOS without PWA install, older browsers, SSR, etc.).\n */\nexport function isPushSupported(): boolean {\n    return (\n        typeof window !== \"undefined\" &&\n        \"serviceWorker\" in navigator &&\n        \"PushManager\" in window &&\n        \"Notification\" in window\n    );\n}\n"],"mappings":"AAOA,SAAgB,EAAsB,EAA+C,CAEjF,IAAM,GAAU,EADA,IAAI,QAAQ,EAAK,EAAa,OAAS,GAAM,CAC9B,EAAA,CAAS,QAAQ,KAAM,GAAG,CAAC,CAAC,QAAQ,KAAM,GAAG,EACtE,EAAU,OAAO,KAAK,CAAM,EAC5B,EAAS,IAAI,YAAY,EAAQ,MAAM,EACvC,EAAS,IAAI,WAAW,CAAM,EACpC,IAAK,IAAI,EAAI,EAAG,EAAI,EAAQ,OAAQ,IAChC,EAAO,GAAK,EAAQ,WAAW,CAAC,EAEpC,OAAO,CACX,CAMA,SAAgB,GAA2B,CACvC,OACI,OAAO,OAAW,KAClB,kBAAmB,WACnB,gBAAiB,QACjB,iBAAkB,MAE1B"}

package/dist/push/utils.js

@@ -0,0 +1,13 @@
+//#region src/push/utils.ts
+function e(e) {
+	let t = (e + "=".repeat((4 - e.length % 4) % 4)).replace(/-/g, "+").replace(/_/g, "/"), n = window.atob(t), r = new ArrayBuffer(n.length), i = new Uint8Array(r);
+	for (let e = 0; e < n.length; e++) i[e] = n.charCodeAt(e);
+	return i;
+}
+function t() {
+	return typeof window < "u" && "serviceWorker" in navigator && "PushManager" in window && "Notification" in window;
+}
+//#endregion
+export { t as isPushSupported, e as urlBase64ToUint8Array };
+
+//# sourceMappingURL=utils.js.map

package/dist/push/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","names":[],"sources":["../../src/push/utils.ts"],"sourcesContent":["/**\n * Convert a base64url-encoded VAPID public key into the `Uint8Array` format\n * required by `PushManager.subscribe({ applicationServerKey })`.\n *\n * @param base64String - VAPID public key (URL-safe base64).\n * @returns The decoded key as bytes.\n */\nexport function urlBase64ToUint8Array(base64String: string): Uint8Array<ArrayBuffer> {\n    const padding = \"=\".repeat((4 - (base64String.length % 4)) % 4);\n    const base64 = (base64String + padding).replace(/-/g, \"+\").replace(/_/g, \"/\");\n    const rawData = window.atob(base64);\n    const buffer = new ArrayBuffer(rawData.length);\n    const output = new Uint8Array(buffer);\n    for (let i = 0; i < rawData.length; i++) {\n        output[i] = rawData.charCodeAt(i);\n    }\n    return output;\n}\n\n/**\n * Convenience check for environments where the Push API is unavailable\n * (Safari iOS without PWA install, older browsers, SSR, etc.).\n */\nexport function isPushSupported(): boolean {\n    return (\n        typeof window !== \"undefined\" &&\n        \"serviceWorker\" in navigator &&\n        \"PushManager\" in window &&\n        \"Notification\" in window\n    );\n}\n"],"mappings":";AAOA,SAAgB,EAAsB,GAA+C;CAEjF,IAAM,KAAU,IADA,IAAI,QAAQ,IAAK,EAAa,SAAS,KAAM,CAC9B,EAAA,CAAS,QAAQ,MAAM,GAAG,CAAC,CAAC,QAAQ,MAAM,GAAG,GACtE,IAAU,OAAO,KAAK,CAAM,GAC5B,IAAS,IAAI,YAAY,EAAQ,MAAM,GACvC,IAAS,IAAI,WAAW,CAAM;CACpC,KAAK,IAAI,IAAI,GAAG,IAAI,EAAQ,QAAQ,KAChC,EAAO,KAAK,EAAQ,WAAW,CAAC;CAEpC,OAAO;AACX;AAMA,SAAgB,IAA2B;CACvC,OACI,OAAO,SAAW,OAClB,mBAAmB,aACnB,iBAAiB,UACjB,kBAAkB;AAE1B"}

package/dist/push/web-push-client.cjs

@@ -0,0 +1,2 @@
+const e=require("./utils.cjs");var t=class extends Error{constructor(){super(`Web Push não suportado neste navegador.`),this.name=`WebPushUnsupportedError`}},n=class extends Error{constructor(){super(`Permissão de notificação negada pelo usuário.`),this.name=`WebPushPermissionDeniedError`}},r=class{config;constructor(e){this.config=e}static isSupported(){return e.isPushSupported()}async registration(){if(!e.isPushSupported())throw new t;return this.config.getRegistration?await this.config.getRegistration():await navigator.serviceWorker.ready}permission(){return typeof Notification>`u`?`unsupported`:Notification.permission}async requestPermission(){if(typeof Notification>`u`)throw new t;return Notification.requestPermission()}async getSubscription(){return(await this.registration()).pushManager.getSubscription()}async isSubscribed(){return e.isPushSupported()?await this.getSubscription()!==null:!1}async subscribe(){if(await this.requestPermission()!==`granted`)throw new n;let t=await this.registration(),r=await t.pushManager.getSubscription();if(r)return await this.config.onSubscribe(r.toJSON()),r;let i=await t.pushManager.subscribe({userVisibleOnly:!0,applicationServerKey:e.urlBase64ToUint8Array(this.config.vapidPublicKey)});return await this.config.onSubscribe(i.toJSON()),i}async unsubscribe(){let e=await this.getSubscription();return e?(this.config.onUnsubscribe&&await this.config.onUnsubscribe(e.toJSON()),e.unsubscribe()):!1}};exports.WebPushClient=r,exports.WebPushPermissionDeniedError=n,exports.WebPushUnsupportedError=t;
+//# sourceMappingURL=web-push-client.cjs.map

package/dist/push/web-push-client.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-push-client.cjs","names":[],"sources":["../../src/push/web-push-client.ts"],"sourcesContent":["import { isPushSupported, urlBase64ToUint8Array } from \"./utils\";\n\nexport interface WebPushClientConfig {\n    /** VAPID public key (URL-safe base64). */\n    vapidPublicKey: string;\n    /**\n     * Persist the subscription on the backend. The SDK does not own this call —\n     * the host app decides the endpoint and how the payload is serialized.\n     */\n    onSubscribe: (subscription: PushSubscriptionJSON) => Promise<void> | void;\n    /** Remove the subscription from the backend. Called before `subscription.unsubscribe()`. */\n    onUnsubscribe?: (subscription: PushSubscriptionJSON) => Promise<void> | void;\n    /**\n     * Override how the service worker registration is obtained.\n     * Defaults to `navigator.serviceWorker.ready` — provide this only when you\n     * register the SW yourself and want to reuse the registration.\n     */\n    getRegistration?: () => Promise<ServiceWorkerRegistration>;\n}\n\nexport class WebPushUnsupportedError extends Error {\n    constructor() {\n        super(\"Web Push não suportado neste navegador.\");\n        this.name = \"WebPushUnsupportedError\";\n    }\n}\n\nexport class WebPushPermissionDeniedError extends Error {\n    constructor() {\n        super(\"Permissão de notificação negada pelo usuário.\");\n        this.name = \"WebPushPermissionDeniedError\";\n    }\n}\n\n/**\n * Browser-side Web Push helper. Wraps `Notification.requestPermission`,\n * `pushManager.subscribe`, and the corresponding teardown. Transport is up to\n * the caller via `onSubscribe` / `onUnsubscribe` callbacks.\n */\nexport class WebPushClient {\n    private readonly config: WebPushClientConfig;\n\n    constructor(config: WebPushClientConfig) {\n        this.config = config;\n    }\n\n    /** Whether the runtime supports the Push API. */\n    static isSupported(): boolean {\n        return isPushSupported();\n    }\n\n    private async registration(): Promise<ServiceWorkerRegistration> {\n        if (!isPushSupported()) throw new WebPushUnsupportedError();\n        return this.config.getRegistration\n            ? await this.config.getRegistration()\n            : await navigator.serviceWorker.ready;\n    }\n\n    /** Current `Notification.permission` value, or `\"unsupported\"`. */\n    permission(): NotificationPermission | \"unsupported\" {\n        if (typeof Notification === \"undefined\") return \"unsupported\";\n        return Notification.permission;\n    }\n\n    /**\n     * Ask the user for notification permission.\n     *\n     * @throws {WebPushUnsupportedError} If the runtime lacks the Notification API.\n     * @returns The resulting `NotificationPermission` value.\n     */\n    async requestPermission(): Promise<NotificationPermission> {\n        if (typeof Notification === \"undefined\") throw new WebPushUnsupportedError();\n        return Notification.requestPermission();\n    }\n\n    /** Return the active push subscription, if any. */\n    async getSubscription(): Promise<PushSubscription | null> {\n        const registration = await this.registration();\n        return registration.pushManager.getSubscription();\n    }\n\n    /** True when a subscription already exists for this browser. */\n    async isSubscribed(): Promise<boolean> {\n        if (!isPushSupported()) return false;\n        const existing = await this.getSubscription();\n        return existing !== null;\n    }\n\n    /**\n     * Subscribe the current device. Requests permission, creates a push\n     * subscription if none exists, and forwards the JSON payload to\n     * `onSubscribe` for backend persistence.\n     *\n     * @returns The active `PushSubscription`.\n     * @throws {WebPushUnsupportedError} If Web Push is unavailable.\n     * @throws {WebPushPermissionDeniedError} If the user denies the prompt.\n     */\n    async subscribe(): Promise<PushSubscription> {\n        const permission = await this.requestPermission();\n        if (permission !== \"granted\") throw new WebPushPermissionDeniedError();\n\n        const registration = await this.registration();\n        const existing = await registration.pushManager.getSubscription();\n        if (existing) {\n            await this.config.onSubscribe(existing.toJSON());\n            return existing;\n        }\n\n        const subscription = await registration.pushManager.subscribe({\n            userVisibleOnly: true,\n            applicationServerKey: urlBase64ToUint8Array(this.config.vapidPublicKey),\n        });\n        await this.config.onSubscribe(subscription.toJSON());\n        return subscription;\n    }\n\n    /**\n     * Cancel the current subscription. Calls `onUnsubscribe` first (so the\n     * backend can purge the record) and then `subscription.unsubscribe()`.\n     *\n     * @returns True when an active subscription was removed, false otherwise.\n     */\n    async unsubscribe(): Promise<boolean> {\n        const subscription = await this.getSubscription();\n        if (!subscription) return false;\n        if (this.config.onUnsubscribe) {\n            await this.config.onUnsubscribe(subscription.toJSON());\n        }\n        return subscription.unsubscribe();\n    }\n}\n"],"mappings":"+BAoBA,IAAa,EAAb,cAA6C,KAAM,CAC/C,aAAc,CACV,MAAM,yCAAyC,EAC/C,KAAK,KAAO,yBAChB,CACJ,EAEa,EAAb,cAAkD,KAAM,CACpD,aAAc,CACV,MAAM,+CAA+C,EACrD,KAAK,KAAO,8BAChB,CACJ,EAOa,EAAb,KAA2B,CACvB,OAEA,YAAY,EAA6B,CACrC,KAAK,OAAS,CAClB,CAGA,OAAO,aAAuB,CAC1B,OAAO,EAAA,gBAAgB,CAC3B,CAEA,MAAc,cAAmD,CAC7D,GAAI,CAAC,EAAA,gBAAgB,EAAG,MAAM,IAAI,EAClC,OAAO,KAAK,OAAO,gBACb,MAAM,KAAK,OAAO,gBAAgB,EAClC,MAAM,UAAU,cAAc,KACxC,CAGA,YAAqD,CAEjD,OADI,OAAO,aAAiB,IAAoB,cACzC,aAAa,UACxB,CAQA,MAAM,mBAAqD,CACvD,GAAI,OAAO,aAAiB,IAAa,MAAM,IAAI,EACnD,OAAO,aAAa,kBAAkB,CAC1C,CAGA,MAAM,iBAAoD,CAEtD,OAAO,MADoB,KAAK,aAAa,EAAA,CACzB,YAAY,gBAAgB,CACpD,CAGA,MAAM,cAAiC,CAGnC,OAFK,EAAA,gBAAgB,EAEd,MADgB,KAAK,gBAAgB,IACxB,KAFW,EAGnC,CAWA,MAAM,WAAuC,CAEzC,GAAI,MADqB,KAAK,kBAAkB,IAC7B,UAAW,MAAM,IAAI,EAExC,IAAM,EAAe,MAAM,KAAK,aAAa,EACvC,EAAW,MAAM,EAAa,YAAY,gBAAgB,EAChE,GAAI,EAEA,OADA,MAAM,KAAK,OAAO,YAAY,EAAS,OAAO,CAAC,EACxC,EAGX,IAAM,EAAe,MAAM,EAAa,YAAY,UAAU,CAC1D,gBAAiB,GACjB,qBAAsB,EAAA,sBAAsB,KAAK,OAAO,cAAc,CAC1E,CAAC,EAED,OADA,MAAM,KAAK,OAAO,YAAY,EAAa,OAAO,CAAC,EAC5C,CACX,CAQA,MAAM,aAAgC,CAClC,IAAM,EAAe,MAAM,KAAK,gBAAgB,EAKhD,OAJK,GACD,KAAK,OAAO,eACZ,MAAM,KAAK,OAAO,cAAc,EAAa,OAAO,CAAC,EAElD,EAAa,YAAY,GAJN,EAK9B,CACJ"}

package/dist/push/web-push-client.js

@@ -0,0 +1,54 @@
+import { isPushSupported as e, urlBase64ToUint8Array as t } from "./utils.js";
+//#region src/push/web-push-client.ts
+var n = class extends Error {
+	constructor() {
+		super("Web Push não suportado neste navegador."), this.name = "WebPushUnsupportedError";
+	}
+}, r = class extends Error {
+	constructor() {
+		super("Permissão de notificação negada pelo usuário."), this.name = "WebPushPermissionDeniedError";
+	}
+}, i = class {
+	config;
+	constructor(e) {
+		this.config = e;
+	}
+	static isSupported() {
+		return e();
+	}
+	async registration() {
+		if (!e()) throw new n();
+		return this.config.getRegistration ? await this.config.getRegistration() : await navigator.serviceWorker.ready;
+	}
+	permission() {
+		return typeof Notification > "u" ? "unsupported" : Notification.permission;
+	}
+	async requestPermission() {
+		if (typeof Notification > "u") throw new n();
+		return Notification.requestPermission();
+	}
+	async getSubscription() {
+		return (await this.registration()).pushManager.getSubscription();
+	}
+	async isSubscribed() {
+		return e() ? await this.getSubscription() !== null : !1;
+	}
+	async subscribe() {
+		if (await this.requestPermission() !== "granted") throw new r();
+		let e = await this.registration(), n = await e.pushManager.getSubscription();
+		if (n) return await this.config.onSubscribe(n.toJSON()), n;
+		let i = await e.pushManager.subscribe({
+			userVisibleOnly: !0,
+			applicationServerKey: t(this.config.vapidPublicKey)
+		});
+		return await this.config.onSubscribe(i.toJSON()), i;
+	}
+	async unsubscribe() {
+		let e = await this.getSubscription();
+		return e ? (this.config.onUnsubscribe && await this.config.onUnsubscribe(e.toJSON()), e.unsubscribe()) : !1;
+	}
+};
+//#endregion
+export { i as WebPushClient, r as WebPushPermissionDeniedError, n as WebPushUnsupportedError };
+
+//# sourceMappingURL=web-push-client.js.map

package/dist/push/web-push-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-push-client.js","names":[],"sources":["../../src/push/web-push-client.ts"],"sourcesContent":["import { isPushSupported, urlBase64ToUint8Array } from \"./utils\";\n\nexport interface WebPushClientConfig {\n    /** VAPID public key (URL-safe base64). */\n    vapidPublicKey: string;\n    /**\n     * Persist the subscription on the backend. The SDK does not own this call —\n     * the host app decides the endpoint and how the payload is serialized.\n     */\n    onSubscribe: (subscription: PushSubscriptionJSON) => Promise<void> | void;\n    /** Remove the subscription from the backend. Called before `subscription.unsubscribe()`. */\n    onUnsubscribe?: (subscription: PushSubscriptionJSON) => Promise<void> | void;\n    /**\n     * Override how the service worker registration is obtained.\n     * Defaults to `navigator.serviceWorker.ready` — provide this only when you\n     * register the SW yourself and want to reuse the registration.\n     */\n    getRegistration?: () => Promise<ServiceWorkerRegistration>;\n}\n\nexport class WebPushUnsupportedError extends Error {\n    constructor() {\n        super(\"Web Push não suportado neste navegador.\");\n        this.name = \"WebPushUnsupportedError\";\n    }\n}\n\nexport class WebPushPermissionDeniedError extends Error {\n    constructor() {\n        super(\"Permissão de notificação negada pelo usuário.\");\n        this.name = \"WebPushPermissionDeniedError\";\n    }\n}\n\n/**\n * Browser-side Web Push helper. Wraps `Notification.requestPermission`,\n * `pushManager.subscribe`, and the corresponding teardown. Transport is up to\n * the caller via `onSubscribe` / `onUnsubscribe` callbacks.\n */\nexport class WebPushClient {\n    private readonly config: WebPushClientConfig;\n\n    constructor(config: WebPushClientConfig) {\n        this.config = config;\n    }\n\n    /** Whether the runtime supports the Push API. */\n    static isSupported(): boolean {\n        return isPushSupported();\n    }\n\n    private async registration(): Promise<ServiceWorkerRegistration> {\n        if (!isPushSupported()) throw new WebPushUnsupportedError();\n        return this.config.getRegistration\n            ? await this.config.getRegistration()\n            : await navigator.serviceWorker.ready;\n    }\n\n    /** Current `Notification.permission` value, or `\"unsupported\"`. */\n    permission(): NotificationPermission | \"unsupported\" {\n        if (typeof Notification === \"undefined\") return \"unsupported\";\n        return Notification.permission;\n    }\n\n    /**\n     * Ask the user for notification permission.\n     *\n     * @throws {WebPushUnsupportedError} If the runtime lacks the Notification API.\n     * @returns The resulting `NotificationPermission` value.\n     */\n    async requestPermission(): Promise<NotificationPermission> {\n        if (typeof Notification === \"undefined\") throw new WebPushUnsupportedError();\n        return Notification.requestPermission();\n    }\n\n    /** Return the active push subscription, if any. */\n    async getSubscription(): Promise<PushSubscription | null> {\n        const registration = await this.registration();\n        return registration.pushManager.getSubscription();\n    }\n\n    /** True when a subscription already exists for this browser. */\n    async isSubscribed(): Promise<boolean> {\n        if (!isPushSupported()) return false;\n        const existing = await this.getSubscription();\n        return existing !== null;\n    }\n\n    /**\n     * Subscribe the current device. Requests permission, creates a push\n     * subscription if none exists, and forwards the JSON payload to\n     * `onSubscribe` for backend persistence.\n     *\n     * @returns The active `PushSubscription`.\n     * @throws {WebPushUnsupportedError} If Web Push is unavailable.\n     * @throws {WebPushPermissionDeniedError} If the user denies the prompt.\n     */\n    async subscribe(): Promise<PushSubscription> {\n        const permission = await this.requestPermission();\n        if (permission !== \"granted\") throw new WebPushPermissionDeniedError();\n\n        const registration = await this.registration();\n        const existing = await registration.pushManager.getSubscription();\n        if (existing) {\n            await this.config.onSubscribe(existing.toJSON());\n            return existing;\n        }\n\n        const subscription = await registration.pushManager.subscribe({\n            userVisibleOnly: true,\n            applicationServerKey: urlBase64ToUint8Array(this.config.vapidPublicKey),\n        });\n        await this.config.onSubscribe(subscription.toJSON());\n        return subscription;\n    }\n\n    /**\n     * Cancel the current subscription. Calls `onUnsubscribe` first (so the\n     * backend can purge the record) and then `subscription.unsubscribe()`.\n     *\n     * @returns True when an active subscription was removed, false otherwise.\n     */\n    async unsubscribe(): Promise<boolean> {\n        const subscription = await this.getSubscription();\n        if (!subscription) return false;\n        if (this.config.onUnsubscribe) {\n            await this.config.onUnsubscribe(subscription.toJSON());\n        }\n        return subscription.unsubscribe();\n    }\n}\n"],"mappings":";;AAoBA,IAAa,IAAb,cAA6C,MAAM;CAC/C,cAAc;EAEV,AADA,MAAM,yCAAyC,GAC/C,KAAK,OAAO;CAChB;AACJ,GAEa,IAAb,cAAkD,MAAM;CACpD,cAAc;EAEV,AADA,MAAM,+CAA+C,GACrD,KAAK,OAAO;CAChB;AACJ,GAOa,IAAb,MAA2B;CACvB;CAEA,YAAY,GAA6B;EACrC,KAAK,SAAS;CAClB;CAGA,OAAO,cAAuB;EAC1B,OAAO,EAAgB;CAC3B;CAEA,MAAc,eAAmD;EAC7D,IAAI,CAAC,EAAgB,GAAG,MAAM,IAAI,EAAwB;EAC1D,OAAO,KAAK,OAAO,kBACb,MAAM,KAAK,OAAO,gBAAgB,IAClC,MAAM,UAAU,cAAc;CACxC;CAGA,aAAqD;EAEjD,OADI,OAAO,eAAiB,MAAoB,gBACzC,aAAa;CACxB;CAQA,MAAM,oBAAqD;EACvD,IAAI,OAAO,eAAiB,KAAa,MAAM,IAAI,EAAwB;EAC3E,OAAO,aAAa,kBAAkB;CAC1C;CAGA,MAAM,kBAAoD;EAEtD,QAAO,MADoB,KAAK,aAAa,EAAA,CACzB,YAAY,gBAAgB;CACpD;CAGA,MAAM,eAAiC;EAGnC,OAFK,EAAgB,IAEd,MADgB,KAAK,gBAAgB,MACxB,OAFW;CAGnC;CAWA,MAAM,YAAuC;EAEzC,IAAI,MADqB,KAAK,kBAAkB,MAC7B,WAAW,MAAM,IAAI,EAA6B;EAErE,IAAM,IAAe,MAAM,KAAK,aAAa,GACvC,IAAW,MAAM,EAAa,YAAY,gBAAgB;EAChE,IAAI,GAEA,OADA,MAAM,KAAK,OAAO,YAAY,EAAS,OAAO,CAAC,GACxC;EAGX,IAAM,IAAe,MAAM,EAAa,YAAY,UAAU;GAC1D,iBAAiB;GACjB,sBAAsB,EAAsB,KAAK,OAAO,cAAc;EAC1E,CAAC;EAED,OADA,MAAM,KAAK,OAAO,YAAY,EAAa,OAAO,CAAC,GAC5C;CACX;CAQA,MAAM,cAAgC;EAClC,IAAM,IAAe,MAAM,KAAK,gBAAgB;EAKhD,OAJK,KACD,KAAK,OAAO,iBACZ,MAAM,KAAK,OAAO,cAAc,EAAa,OAAO,CAAC,GAElD,EAAa,YAAY,KAJN;CAK9B;AACJ"}

package/dist/query/QueryProvider.cjs

@@ -0,0 +1,2 @@
+const e=require("./constants.cjs");let t=require("react"),n=require("react/jsx-runtime"),r=require("@tanstack/react-query");function i({children:i,client:a,defaultOptions:o}){let[s]=(0,t.useState)(()=>a??new r.QueryClient({defaultOptions:{queries:{staleTime:e.STALE_TIME.DEFAULT,gcTime:e.CACHE_TIME.DEFAULT,retry:1,refetchOnWindowFocus:!1,...o?.queries??{}},mutations:{retry:0,...o?.mutations??{}}}}));return(0,n.jsx)(r.QueryClientProvider,{client:s,children:i})}exports.QueryProvider=i;
+//# sourceMappingURL=QueryProvider.cjs.map

package/dist/query/QueryProvider.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryProvider.cjs","names":[],"sources":["../../src/query/QueryProvider.tsx"],"sourcesContent":["import { useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { QueryClient, QueryClientProvider } from \"@tanstack/react-query\";\nimport type { DefaultOptions } from \"@tanstack/react-query\";\nimport { STALE_TIME, CACHE_TIME } from \"./constants\";\n\nexport interface QueryProviderProps {\n    children: ReactNode;\n    /** Pass an existing client to share it across roots. */\n    client?: QueryClient;\n    /** Overrides for the default options applied when no `client` is provided. */\n    defaultOptions?: DefaultOptions;\n}\n\n/**\n * Wrapper around `QueryClientProvider` that bootstraps a `QueryClient` with\n * sane SDK defaults (5-minute stale time, 30-minute gc time, 1 retry).\n */\nexport function QueryProvider({ children, client, defaultOptions }: QueryProviderProps) {\n    const [internalClient] = useState<QueryClient>(\n        () =>\n            client ??\n            new QueryClient({\n                defaultOptions: {\n                    queries: {\n                        staleTime: STALE_TIME.DEFAULT,\n                        gcTime: CACHE_TIME.DEFAULT,\n                        retry: 1,\n                        refetchOnWindowFocus: false,\n                        ...(defaultOptions?.queries ?? {}),\n                    },\n                    mutations: {\n                        retry: 0,\n                        ...(defaultOptions?.mutations ?? {}),\n                    },\n                },\n            }),\n    );\n\n    return <QueryClientProvider client={internalClient}>{children}</QueryClientProvider>;\n}\n"],"mappings":"4HAkBA,SAAgB,EAAc,CAAE,WAAU,SAAQ,kBAAsC,CACpF,GAAM,CAAC,IAAA,EAAA,EAAA,SAAA,KAEC,GACA,IAAI,EAAA,YAAY,CACZ,eAAgB,CACZ,QAAS,CACL,UAAW,EAAA,WAAW,QACtB,OAAQ,EAAA,WAAW,QACnB,MAAO,EACP,qBAAsB,GACtB,GAAI,GAAgB,SAAW,CAAC,CACpC,EACA,UAAW,CACP,MAAO,EACP,GAAI,GAAgB,WAAa,CAAC,CACtC,CACJ,CACJ,CAAC,CACT,EAEA,OAAO,EAAA,EAAA,IAAA,CAAC,EAAA,oBAAD,CAAqB,OAAQ,EAAiB,UAA8B,CAAA,CACvF"}

package/dist/query/QueryProvider.js

@@ -0,0 +1,28 @@
+import { CACHE_TIME as e, STALE_TIME as t } from "./constants.js";
+import { useState as n } from "react";
+import { jsx as r } from "react/jsx-runtime";
+import { QueryClient as i, QueryClientProvider as a } from "@tanstack/react-query";
+//#region src/query/QueryProvider.tsx
+function o({ children: o, client: s, defaultOptions: c }) {
+	let [l] = n(() => s ?? new i({ defaultOptions: {
+		queries: {
+			staleTime: t.DEFAULT,
+			gcTime: e.DEFAULT,
+			retry: 1,
+			refetchOnWindowFocus: !1,
+			...c?.queries ?? {}
+		},
+		mutations: {
+			retry: 0,
+			...c?.mutations ?? {}
+		}
+	} }));
+	return /* @__PURE__ */ r(a, {
+		client: l,
+		children: o
+	});
+}
+//#endregion
+export { o as QueryProvider };
+
+//# sourceMappingURL=QueryProvider.js.map

package/dist/query/QueryProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryProvider.js","names":[],"sources":["../../src/query/QueryProvider.tsx"],"sourcesContent":["import { useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { QueryClient, QueryClientProvider } from \"@tanstack/react-query\";\nimport type { DefaultOptions } from \"@tanstack/react-query\";\nimport { STALE_TIME, CACHE_TIME } from \"./constants\";\n\nexport interface QueryProviderProps {\n    children: ReactNode;\n    /** Pass an existing client to share it across roots. */\n    client?: QueryClient;\n    /** Overrides for the default options applied when no `client` is provided. */\n    defaultOptions?: DefaultOptions;\n}\n\n/**\n * Wrapper around `QueryClientProvider` that bootstraps a `QueryClient` with\n * sane SDK defaults (5-minute stale time, 30-minute gc time, 1 retry).\n */\nexport function QueryProvider({ children, client, defaultOptions }: QueryProviderProps) {\n    const [internalClient] = useState<QueryClient>(\n        () =>\n            client ??\n            new QueryClient({\n                defaultOptions: {\n                    queries: {\n                        staleTime: STALE_TIME.DEFAULT,\n                        gcTime: CACHE_TIME.DEFAULT,\n                        retry: 1,\n                        refetchOnWindowFocus: false,\n                        ...(defaultOptions?.queries ?? {}),\n                    },\n                    mutations: {\n                        retry: 0,\n                        ...(defaultOptions?.mutations ?? {}),\n                    },\n                },\n            }),\n    );\n\n    return <QueryClientProvider client={internalClient}>{children}</QueryClientProvider>;\n}\n"],"mappings":";;;;;AAkBA,SAAgB,EAAc,EAAE,aAAU,WAAQ,qBAAsC;CACpF,IAAM,CAAC,KAAkB,QAEjB,KACA,IAAI,EAAY,EACZ,gBAAgB;EACZ,SAAS;GACL,WAAW,EAAW;GACtB,QAAQ,EAAW;GACnB,OAAO;GACP,sBAAsB;GACtB,GAAI,GAAgB,WAAW,CAAC;EACpC;EACA,WAAW;GACP,OAAO;GACP,GAAI,GAAgB,aAAa,CAAC;EACtC;CACJ,EACJ,CAAC,CACT;CAEA,OAAO,kBAAC,GAAD;EAAqB,QAAQ;EAAiB;CAA8B,CAAA;AACvF"}

package/dist/query/constants.cjs

@@ -0,0 +1,2 @@
+var e={SHORT:30*1e3,DEFAULT:300*1e3,LONG:1800*1e3,INFINITE:1/0},t={SHORT:300*1e3,DEFAULT:1800*1e3,LONG:3600*1e3},n={REALTIME:5*1e3,FAST:30*1e3,DEFAULT:60*1e3,SLOW:300*1e3};exports.CACHE_TIME=t,exports.REFETCH_TIME=n,exports.STALE_TIME=e;
+//# sourceMappingURL=constants.cjs.map

package/dist/query/constants.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.cjs","names":[],"sources":["../../src/query/constants.ts"],"sourcesContent":["/** Recommended `staleTime` presets (milliseconds). */\nexport const STALE_TIME = {\n    SHORT: 30 * 1000,\n    DEFAULT: 5 * 60 * 1000,\n    LONG: 30 * 60 * 1000,\n    INFINITE: Infinity,\n} as const;\n\n/** Recommended `gcTime` presets (milliseconds). */\nexport const CACHE_TIME = {\n    SHORT: 5 * 60 * 1000,\n    DEFAULT: 30 * 60 * 1000,\n    LONG: 60 * 60 * 1000,\n} as const;\n\n/** Recommended refetch intervals (milliseconds). */\nexport const REFETCH_TIME = {\n    REALTIME: 5 * 1000,\n    FAST: 30 * 1000,\n    DEFAULT: 60 * 1000,\n    SLOW: 5 * 60 * 1000,\n} as const;\n"],"mappings":"AACA,IAAa,EAAa,CACtB,MAAO,GAAK,IACZ,QAAS,IAAS,IAClB,KAAM,KAAU,IAChB,SAAU,GACd,EAGa,EAAa,CACtB,MAAO,IAAS,IAChB,QAAS,KAAU,IACnB,KAAM,KAAU,GACpB,EAGa,EAAe,CACxB,SAAU,EAAI,IACd,KAAM,GAAK,IACX,QAAS,GAAK,IACd,KAAM,IAAS,GACnB"}

package/dist/query/constants.js

@@ -0,0 +1,20 @@
+//#region src/query/constants.ts
+var e = {
+	SHORT: 30 * 1e3,
+	DEFAULT: 300 * 1e3,
+	LONG: 1800 * 1e3,
+	INFINITE: Infinity
+}, t = {
+	SHORT: 300 * 1e3,
+	DEFAULT: 1800 * 1e3,
+	LONG: 3600 * 1e3
+}, n = {
+	REALTIME: 5 * 1e3,
+	FAST: 30 * 1e3,
+	DEFAULT: 60 * 1e3,
+	SLOW: 300 * 1e3
+};
+//#endregion
+export { t as CACHE_TIME, n as REFETCH_TIME, e as STALE_TIME };
+
+//# sourceMappingURL=constants.js.map

package/dist/query/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","names":[],"sources":["../../src/query/constants.ts"],"sourcesContent":["/** Recommended `staleTime` presets (milliseconds). */\nexport const STALE_TIME = {\n    SHORT: 30 * 1000,\n    DEFAULT: 5 * 60 * 1000,\n    LONG: 30 * 60 * 1000,\n    INFINITE: Infinity,\n} as const;\n\n/** Recommended `gcTime` presets (milliseconds). */\nexport const CACHE_TIME = {\n    SHORT: 5 * 60 * 1000,\n    DEFAULT: 30 * 60 * 1000,\n    LONG: 60 * 60 * 1000,\n} as const;\n\n/** Recommended refetch intervals (milliseconds). */\nexport const REFETCH_TIME = {\n    REALTIME: 5 * 1000,\n    FAST: 30 * 1000,\n    DEFAULT: 60 * 1000,\n    SLOW: 5 * 60 * 1000,\n} as const;\n"],"mappings":";AACA,IAAa,IAAa;CACtB,OAAO,KAAK;CACZ,SAAS,MAAS;CAClB,MAAM,OAAU;CAChB,UAAU;AACd,GAGa,IAAa;CACtB,OAAO,MAAS;CAChB,SAAS,OAAU;CACnB,MAAM,OAAU;AACpB,GAGa,IAAe;CACxB,UAAU,IAAI;CACd,MAAM,KAAK;CACX,SAAS,KAAK;CACd,MAAM,MAAS;AACnB"}

package/dist/query/create-query-keys.cjs

@@ -0,0 +1,2 @@
+function e(e,t){let n={all:[e]};for(let[r,i]of Object.entries(t))typeof i==`function`?n[r]=(...t)=>[e,...i(...t)]:n[r]=[e,...i];return n}exports.createQueryKeys=e;
+//# sourceMappingURL=create-query-keys.cjs.map

package/dist/query/create-query-keys.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-query-keys.cjs","names":[],"sources":["../../src/query/create-query-keys.ts"],"sourcesContent":["// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype KeyBuilder = (...args: any[]) => readonly unknown[];\n\n/**\n * Build a typed query-key factory for a domain. Each entry can be a static\n * tuple or a function returning a tuple. The returned object is `as const`\n * so TanStack Query infers literal keys.\n *\n * @example\n * const userKeys = createQueryKeys(\"user\", {\n *     me: () => [\"me\"] as const,\n *     byId: (id: string) => [id] as const,\n *     list: (filters: { page: number }) => [\"list\", filters] as const,\n * });\n * // userKeys.byId(\"42\") === [\"user\", \"42\"]\n */\nexport function createQueryKeys<\n    TKey extends string,\n    TEntries extends Record<string, KeyBuilder | readonly unknown[]>,\n>(scope: TKey, entries: TEntries) {\n    const output = { all: [scope] as const } as { all: readonly [TKey] } & {\n        [K in keyof TEntries]: TEntries[K] extends KeyBuilder\n            ? (...args: Parameters<TEntries[K]>) => readonly [TKey, ...ReturnType<TEntries[K]>]\n            : TEntries[K] extends readonly unknown[]\n              ? readonly [TKey, ...TEntries[K]]\n              : never;\n    };\n\n    for (const [name, entry] of Object.entries(entries) as [\n        keyof TEntries,\n        KeyBuilder | readonly unknown[],\n    ][]) {\n        if (typeof entry === \"function\") {\n            (output as Record<string, unknown>)[name as string] = (...args: unknown[]) =>\n                [scope, ...entry(...args)] as const;\n        } else {\n            (output as Record<string, unknown>)[name as string] = [scope, ...entry] as const;\n        }\n    }\n\n    return output;\n}\n"],"mappings":"AAgBA,SAAgB,EAGd,EAAa,EAAmB,CAC9B,IAAM,EAAS,CAAE,IAAK,CAAC,CAAK,CAAW,EAQvC,IAAK,GAAM,CAAC,EAAM,KAAU,OAAO,QAAQ,CAAO,EAI1C,OAAO,GAAU,WACjB,EAAoC,IAAmB,GAAG,IACtD,CAAC,EAAO,GAAG,EAAM,GAAG,CAAI,CAAC,EAE7B,EAAoC,GAAkB,CAAC,EAAO,GAAG,CAAK,EAI9E,OAAO,CACX"}

package/dist/query/create-query-keys.js

@@ -0,0 +1,10 @@
+//#region src/query/create-query-keys.ts
+function e(e, t) {
+	let n = { all: [e] };
+	for (let [r, i] of Object.entries(t)) typeof i == "function" ? n[r] = (...t) => [e, ...i(...t)] : n[r] = [e, ...i];
+	return n;
+}
+//#endregion
+export { e as createQueryKeys };
+
+//# sourceMappingURL=create-query-keys.js.map

package/dist/query/create-query-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-query-keys.js","names":[],"sources":["../../src/query/create-query-keys.ts"],"sourcesContent":["// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype KeyBuilder = (...args: any[]) => readonly unknown[];\n\n/**\n * Build a typed query-key factory for a domain. Each entry can be a static\n * tuple or a function returning a tuple. The returned object is `as const`\n * so TanStack Query infers literal keys.\n *\n * @example\n * const userKeys = createQueryKeys(\"user\", {\n *     me: () => [\"me\"] as const,\n *     byId: (id: string) => [id] as const,\n *     list: (filters: { page: number }) => [\"list\", filters] as const,\n * });\n * // userKeys.byId(\"42\") === [\"user\", \"42\"]\n */\nexport function createQueryKeys<\n    TKey extends string,\n    TEntries extends Record<string, KeyBuilder | readonly unknown[]>,\n>(scope: TKey, entries: TEntries) {\n    const output = { all: [scope] as const } as { all: readonly [TKey] } & {\n        [K in keyof TEntries]: TEntries[K] extends KeyBuilder\n            ? (...args: Parameters<TEntries[K]>) => readonly [TKey, ...ReturnType<TEntries[K]>]\n            : TEntries[K] extends readonly unknown[]\n              ? readonly [TKey, ...TEntries[K]]\n              : never;\n    };\n\n    for (const [name, entry] of Object.entries(entries) as [\n        keyof TEntries,\n        KeyBuilder | readonly unknown[],\n    ][]) {\n        if (typeof entry === \"function\") {\n            (output as Record<string, unknown>)[name as string] = (...args: unknown[]) =>\n                [scope, ...entry(...args)] as const;\n        } else {\n            (output as Record<string, unknown>)[name as string] = [scope, ...entry] as const;\n        }\n    }\n\n    return output;\n}\n"],"mappings":";AAgBA,SAAgB,EAGd,GAAa,GAAmB;CAC9B,IAAM,IAAS,EAAE,KAAK,CAAC,CAAK,EAAW;CAQvC,KAAK,IAAM,CAAC,GAAM,MAAU,OAAO,QAAQ,CAAO,GAI9C,AAAI,OAAO,KAAU,aACjB,EAAoC,MAAmB,GAAG,MACtD,CAAC,GAAO,GAAG,EAAM,GAAG,CAAI,CAAC,IAE7B,EAAoC,KAAkB,CAAC,GAAO,GAAG,CAAK;CAI9E,OAAO;AACX"}

package/dist/query/offline-persistence.cjs

@@ -0,0 +1,2 @@
+const e=require("../offline/create-offline-store.cjs");let t=require("@tanstack/react-query");function n(n){let{queryClient:r,throttleMs:i=1e3}=n,a=n.key??`tanstack-query`,o=e.createOfflineStore({databaseName:n.databaseName??`TempestQueryCache`,version:1,tableName:`cache`,indexes:`&id`,keyPath:`id`});async function s(){await o.put({id:a,state:(0,t.dehydrate)(r)})}let c=null;function l(){c||=setTimeout(()=>{c=null,s()},i)}let u=r.getQueryCache().subscribe(l);return{async restore(){let e=await o.get(a);e&&(0,t.hydrate)(r,e.state)},async flush(){c&&=(clearTimeout(c),null),await s()},unsubscribe(){c&&=(clearTimeout(c),null),u()},async clear(){await o.delete(a)}}}exports.persistQueryClientOffline=n;
+//# sourceMappingURL=offline-persistence.cjs.map

package/dist/query/offline-persistence.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-persistence.cjs","names":[],"sources":["../../src/query/offline-persistence.ts"],"sourcesContent":["import { dehydrate, hydrate, type QueryClient } from \"@tanstack/react-query\";\nimport { createOfflineStore } from \"../offline/create-offline-store\";\n\n/** Options for {@link persistQueryClientOffline}. */\nexport interface OfflineQueryPersistenceOptions {\n    /** The `QueryClient` to snapshot and restore. */\n    queryClient: QueryClient;\n    /** IndexedDB database name for the snapshot. Default `\"TempestQueryCache\"`. */\n    databaseName?: string;\n    /** Row key under which the snapshot is stored. Default `\"tanstack-query\"`. */\n    key?: string;\n    /**\n     * Minimum gap between snapshot writes, in ms — cache churn is coalesced into\n     * one trailing write per window. Default `1000`.\n     */\n    throttleMs?: number;\n}\n\n/** Handle returned by {@link persistQueryClientOffline}. */\nexport interface OfflineQueryPersistence {\n    /**\n     * Load the persisted snapshot into the `QueryClient`. Call once on boot,\n     * before rendering queries, so cached data is available offline.\n     */\n    restore: () => Promise<void>;\n    /** Write the current cache snapshot immediately (bypassing the throttle). */\n    flush: () => Promise<void>;\n    /** Stop persisting and drop the pending write. */\n    unsubscribe: () => void;\n    /** Delete the persisted snapshot (e.g. on logout). */\n    clear: () => Promise<void>;\n}\n\ninterface Snapshot {\n    id: string;\n    state: ReturnType<typeof dehydrate>;\n}\n\n/**\n * Persist a TanStack `QueryClient` cache to IndexedDB (via\n * {@link createOfflineStore}) and restore it on boot — so a reload or a cold\n * offline start shows the last-known data instead of empty screens.\n *\n * Self-contained: uses `dehydrate`/`hydrate` from `@tanstack/react-query`\n * directly, so no `@tanstack/react-query-persist-client` dependency is needed.\n * Writes are throttled and subscribe to the query cache; call `unsubscribe` on\n * teardown. Dexie is a peer dependency of the offline store — install it.\n *\n * @param options - The client plus storage/throttle configuration.\n * @returns A handle with `restore`, `flush`, `clear` and `unsubscribe`.\n *\n * @example\n * const persistence = persistQueryClientOffline({ queryClient });\n * await persistence.restore(); // before first render\n * // ... later, on logout:\n * await persistence.clear();\n */\nexport function persistQueryClientOffline(\n    options: OfflineQueryPersistenceOptions,\n): OfflineQueryPersistence {\n    const { queryClient, throttleMs = 1000 } = options;\n    const key = options.key ?? \"tanstack-query\";\n    const store = createOfflineStore<Snapshot, string>({\n        databaseName: options.databaseName ?? \"TempestQueryCache\",\n        version: 1,\n        tableName: \"cache\",\n        indexes: \"&id\",\n        keyPath: \"id\",\n    });\n\n    async function save(): Promise<void> {\n        await store.put({ id: key, state: dehydrate(queryClient) });\n    }\n\n    let timer: ReturnType<typeof setTimeout> | null = null;\n    function schedule(): void {\n        if (timer) return;\n        timer = setTimeout(() => {\n            timer = null;\n            void save();\n        }, throttleMs);\n    }\n\n    const unsubscribeCache = queryClient.getQueryCache().subscribe(schedule);\n\n    return {\n        async restore() {\n            const snapshot = await store.get(key);\n            if (snapshot) hydrate(queryClient, snapshot.state);\n        },\n        async flush() {\n            if (timer) {\n                clearTimeout(timer);\n                timer = null;\n            }\n            await save();\n        },\n        unsubscribe() {\n            if (timer) {\n                clearTimeout(timer);\n                timer = null;\n            }\n            unsubscribeCache();\n        },\n        async clear() {\n            await store.delete(key);\n        },\n    };\n}\n"],"mappings":"8FAyDA,SAAgB,EACZ,EACuB,CACvB,GAAM,CAAE,cAAa,aAAa,KAAS,EACrC,EAAM,EAAQ,KAAO,iBACrB,EAAQ,EAAA,mBAAqC,CAC/C,aAAc,EAAQ,cAAgB,oBACtC,QAAS,EACT,UAAW,QACX,QAAS,MACT,QAAS,IACb,CAAC,EAED,eAAe,GAAsB,CACjC,MAAM,EAAM,IAAI,CAAE,GAAI,EAAK,OAAA,EAAA,EAAA,UAAA,CAAiB,CAAW,CAAE,CAAC,CAC9D,CAEA,IAAI,EAA8C,KAClD,SAAS,GAAiB,CAClB,AACJ,IAAQ,eAAiB,CACrB,EAAQ,KACR,EAAU,CACd,EAAG,CAAU,CACjB,CAEA,IAAM,EAAmB,EAAY,cAAc,CAAC,CAAC,UAAU,CAAQ,EAEvE,MAAO,CACH,MAAM,SAAU,CACZ,IAAM,EAAW,MAAM,EAAM,IAAI,CAAG,EAChC,IAAU,EAAA,EAAA,QAAA,CAAQ,EAAa,EAAS,KAAK,CACrD,EACA,MAAM,OAAQ,CACV,AAEI,KADA,aAAa,CAAK,EACV,MAEZ,MAAM,EAAK,CACf,EACA,aAAc,CACV,AAEI,KADA,aAAa,CAAK,EACV,MAEZ,EAAiB,CACrB,EACA,MAAM,OAAQ,CACV,MAAM,EAAM,OAAO,CAAG,CAC1B,CACJ,CACJ"}

package/dist/query/offline-persistence.js

@@ -0,0 +1,44 @@
+import { createOfflineStore as e } from "../offline/create-offline-store.js";
+import { dehydrate as t, hydrate as n } from "@tanstack/react-query";
+//#region src/query/offline-persistence.ts
+function r(r) {
+	let { queryClient: i, throttleMs: a = 1e3 } = r, o = r.key ?? "tanstack-query", s = e({
+		databaseName: r.databaseName ?? "TempestQueryCache",
+		version: 1,
+		tableName: "cache",
+		indexes: "&id",
+		keyPath: "id"
+	});
+	async function c() {
+		await s.put({
+			id: o,
+			state: t(i)
+		});
+	}
+	let l = null;
+	function u() {
+		l ||= setTimeout(() => {
+			l = null, c();
+		}, a);
+	}
+	let d = i.getQueryCache().subscribe(u);
+	return {
+		async restore() {
+			let e = await s.get(o);
+			e && n(i, e.state);
+		},
+		async flush() {
+			l &&= (clearTimeout(l), null), await c();
+		},
+		unsubscribe() {
+			l &&= (clearTimeout(l), null), d();
+		},
+		async clear() {
+			await s.delete(o);
+		}
+	};
+}
+//#endregion
+export { r as persistQueryClientOffline };
+
+//# sourceMappingURL=offline-persistence.js.map

package/dist/query/offline-persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-persistence.js","names":[],"sources":["../../src/query/offline-persistence.ts"],"sourcesContent":["import { dehydrate, hydrate, type QueryClient } from \"@tanstack/react-query\";\nimport { createOfflineStore } from \"../offline/create-offline-store\";\n\n/** Options for {@link persistQueryClientOffline}. */\nexport interface OfflineQueryPersistenceOptions {\n    /** The `QueryClient` to snapshot and restore. */\n    queryClient: QueryClient;\n    /** IndexedDB database name for the snapshot. Default `\"TempestQueryCache\"`. */\n    databaseName?: string;\n    /** Row key under which the snapshot is stored. Default `\"tanstack-query\"`. */\n    key?: string;\n    /**\n     * Minimum gap between snapshot writes, in ms — cache churn is coalesced into\n     * one trailing write per window. Default `1000`.\n     */\n    throttleMs?: number;\n}\n\n/** Handle returned by {@link persistQueryClientOffline}. */\nexport interface OfflineQueryPersistence {\n    /**\n     * Load the persisted snapshot into the `QueryClient`. Call once on boot,\n     * before rendering queries, so cached data is available offline.\n     */\n    restore: () => Promise<void>;\n    /** Write the current cache snapshot immediately (bypassing the throttle). */\n    flush: () => Promise<void>;\n    /** Stop persisting and drop the pending write. */\n    unsubscribe: () => void;\n    /** Delete the persisted snapshot (e.g. on logout). */\n    clear: () => Promise<void>;\n}\n\ninterface Snapshot {\n    id: string;\n    state: ReturnType<typeof dehydrate>;\n}\n\n/**\n * Persist a TanStack `QueryClient` cache to IndexedDB (via\n * {@link createOfflineStore}) and restore it on boot — so a reload or a cold\n * offline start shows the last-known data instead of empty screens.\n *\n * Self-contained: uses `dehydrate`/`hydrate` from `@tanstack/react-query`\n * directly, so no `@tanstack/react-query-persist-client` dependency is needed.\n * Writes are throttled and subscribe to the query cache; call `unsubscribe` on\n * teardown. Dexie is a peer dependency of the offline store — install it.\n *\n * @param options - The client plus storage/throttle configuration.\n * @returns A handle with `restore`, `flush`, `clear` and `unsubscribe`.\n *\n * @example\n * const persistence = persistQueryClientOffline({ queryClient });\n * await persistence.restore(); // before first render\n * // ... later, on logout:\n * await persistence.clear();\n */\nexport function persistQueryClientOffline(\n    options: OfflineQueryPersistenceOptions,\n): OfflineQueryPersistence {\n    const { queryClient, throttleMs = 1000 } = options;\n    const key = options.key ?? \"tanstack-query\";\n    const store = createOfflineStore<Snapshot, string>({\n        databaseName: options.databaseName ?? \"TempestQueryCache\",\n        version: 1,\n        tableName: \"cache\",\n        indexes: \"&id\",\n        keyPath: \"id\",\n    });\n\n    async function save(): Promise<void> {\n        await store.put({ id: key, state: dehydrate(queryClient) });\n    }\n\n    let timer: ReturnType<typeof setTimeout> | null = null;\n    function schedule(): void {\n        if (timer) return;\n        timer = setTimeout(() => {\n            timer = null;\n            void save();\n        }, throttleMs);\n    }\n\n    const unsubscribeCache = queryClient.getQueryCache().subscribe(schedule);\n\n    return {\n        async restore() {\n            const snapshot = await store.get(key);\n            if (snapshot) hydrate(queryClient, snapshot.state);\n        },\n        async flush() {\n            if (timer) {\n                clearTimeout(timer);\n                timer = null;\n            }\n            await save();\n        },\n        unsubscribe() {\n            if (timer) {\n                clearTimeout(timer);\n                timer = null;\n            }\n            unsubscribeCache();\n        },\n        async clear() {\n            await store.delete(key);\n        },\n    };\n}\n"],"mappings":";;;AAyDA,SAAgB,EACZ,GACuB;CACvB,IAAM,EAAE,gBAAa,gBAAa,QAAS,GACrC,IAAM,EAAQ,OAAO,kBACrB,IAAQ,EAAqC;EAC/C,cAAc,EAAQ,gBAAgB;EACtC,SAAS;EACT,WAAW;EACX,SAAS;EACT,SAAS;CACb,CAAC;CAED,eAAe,IAAsB;EACjC,MAAM,EAAM,IAAI;GAAE,IAAI;GAAK,OAAO,EAAU,CAAW;EAAE,CAAC;CAC9D;CAEA,IAAI,IAA8C;CAClD,SAAS,IAAiB;EAClB,AACJ,MAAQ,iBAAiB;GAErB,AADA,IAAQ,MACR,EAAU;EACd,GAAG,CAAU;CACjB;CAEA,IAAM,IAAmB,EAAY,cAAc,CAAC,CAAC,UAAU,CAAQ;CAEvE,OAAO;EACH,MAAM,UAAU;GACZ,IAAM,IAAW,MAAM,EAAM,IAAI,CAAG;GACpC,AAAI,KAAU,EAAQ,GAAa,EAAS,KAAK;EACrD;EACA,MAAM,QAAQ;GAKV,AAJA,AAEI,OADA,aAAa,CAAK,GACV,OAEZ,MAAM,EAAK;EACf;EACA,cAAc;GAKV,AAJA,AAEI,OADA,aAAa,CAAK,GACV,OAEZ,EAAiB;EACrB;EACA,MAAM,QAAQ;GACV,MAAM,EAAM,OAAO,CAAG;EAC1B;CACJ;AACJ"}

package/dist/query/optimistic.cjs

@@ -0,0 +1,2 @@
+function e(e=`id`){return(t=[],n)=>{let r=t.findIndex(t=>t[e]===n[e]);if(r===-1)return[...t,n];let i=t.slice();return i[r]={...t[r],...n},i}}function t(e=`id`){return(t=[],n)=>{let r=n[e];return t.filter(t=>t[e]!==r)}}exports.removeById=t,exports.upsertById=e;
+//# sourceMappingURL=optimistic.cjs.map

package/dist/query/optimistic.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimistic.cjs","names":[],"sources":["../../src/query/optimistic.ts"],"sourcesContent":["/**\n * Ready-made `applyOptimistic` builders for {@link useOfflineMutation} over a\n * list-shaped query cache (`TData = T[]`). They cover the two most common\n * optimistic edits — insert-or-update and remove — so callers stop hand-writing\n * the array spread. Both compare records by an id field (`\"id\"` by default) and\n * treat the mutation variables as the record itself.\n */\n\n/**\n * Build an `applyOptimistic` that inserts the item when absent or shallow-merges\n * it into the existing entry (matched by `idField`). New items append to the end.\n *\n * @typeParam T - The list item shape.\n * @param idField - The identity field. Default `\"id\"`.\n * @returns An `(current, item) => T[]` patcher for a list cache.\n *\n * @example\n * useOfflineMutation<Note, Note[], Note>({\n *     sync, queryKey: [\"notes\"],\n *     toEntry: (n) => ({ op: \"update\", recordId: n.id, payload: n }),\n *     applyOptimistic: upsertById(),\n * });\n */\nexport function upsertById<T>(\n    idField: keyof T = \"id\" as keyof T,\n): (current: T[] | undefined, item: T) => T[] {\n    return (current = [], item) => {\n        const index = current.findIndex((entry) => entry[idField] === item[idField]);\n        if (index === -1) return [...current, item];\n        const next = current.slice();\n        next[index] = { ...current[index], ...item };\n        return next;\n    };\n}\n\n/**\n * Build an `applyOptimistic` that removes the entry matching the item's id\n * (by `idField`) from the list. For `delete` mutations, pass variables carrying\n * at least the id field.\n *\n * @typeParam T - The list item shape.\n * @param idField - The identity field. Default `\"id\"`.\n * @returns An `(current, item) => T[]` patcher for a list cache.\n *\n * @example\n * useOfflineMutation<{ id: string }, Note[], Note>({\n *     sync, queryKey: [\"notes\"],\n *     toEntry: ({ id }) => ({ op: \"delete\", recordId: id }),\n *     applyOptimistic: removeById(),\n * });\n */\nexport function removeById<T, V extends Partial<Record<keyof T, unknown>> = T>(\n    idField: keyof T = \"id\" as keyof T,\n): (current: T[] | undefined, item: V) => T[] {\n    return (current = [], item) => {\n        const targetId = (item as Record<keyof T, unknown>)[idField];\n        return current.filter((entry) => entry[idField] !== targetId);\n    };\n}\n"],"mappings":"AAuBA,SAAgB,EACZ,EAAmB,KACuB,CAC1C,OAAQ,EAAU,CAAC,EAAG,IAAS,CAC3B,IAAM,EAAQ,EAAQ,UAAW,GAAU,EAAM,KAAa,EAAK,EAAQ,EAC3E,GAAI,IAAU,GAAI,MAAO,CAAC,GAAG,EAAS,CAAI,EAC1C,IAAM,EAAO,EAAQ,MAAM,EAE3B,MADA,GAAK,GAAS,CAAE,GAAG,EAAQ,GAAQ,GAAG,CAAK,EACpC,CACX,CACJ,CAkBA,SAAgB,EACZ,EAAmB,KACuB,CAC1C,OAAQ,EAAU,CAAC,EAAG,IAAS,CAC3B,IAAM,EAAY,EAAkC,GACpD,OAAO,EAAQ,OAAQ,GAAU,EAAM,KAAa,CAAQ,CAChE,CACJ"}

package/dist/query/optimistic.js

@@ -0,0 +1,22 @@
+//#region src/query/optimistic.ts
+function e(e = "id") {
+	return (t = [], n) => {
+		let r = t.findIndex((t) => t[e] === n[e]);
+		if (r === -1) return [...t, n];
+		let i = t.slice();
+		return i[r] = {
+			...t[r],
+			...n
+		}, i;
+	};
+}
+function t(e = "id") {
+	return (t = [], n) => {
+		let r = n[e];
+		return t.filter((t) => t[e] !== r);
+	};
+}
+//#endregion
+export { t as removeById, e as upsertById };
+
+//# sourceMappingURL=optimistic.js.map

package/dist/query/optimistic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimistic.js","names":[],"sources":["../../src/query/optimistic.ts"],"sourcesContent":["/**\n * Ready-made `applyOptimistic` builders for {@link useOfflineMutation} over a\n * list-shaped query cache (`TData = T[]`). They cover the two most common\n * optimistic edits — insert-or-update and remove — so callers stop hand-writing\n * the array spread. Both compare records by an id field (`\"id\"` by default) and\n * treat the mutation variables as the record itself.\n */\n\n/**\n * Build an `applyOptimistic` that inserts the item when absent or shallow-merges\n * it into the existing entry (matched by `idField`). New items append to the end.\n *\n * @typeParam T - The list item shape.\n * @param idField - The identity field. Default `\"id\"`.\n * @returns An `(current, item) => T[]` patcher for a list cache.\n *\n * @example\n * useOfflineMutation<Note, Note[], Note>({\n *     sync, queryKey: [\"notes\"],\n *     toEntry: (n) => ({ op: \"update\", recordId: n.id, payload: n }),\n *     applyOptimistic: upsertById(),\n * });\n */\nexport function upsertById<T>(\n    idField: keyof T = \"id\" as keyof T,\n): (current: T[] | undefined, item: T) => T[] {\n    return (current = [], item) => {\n        const index = current.findIndex((entry) => entry[idField] === item[idField]);\n        if (index === -1) return [...current, item];\n        const next = current.slice();\n        next[index] = { ...current[index], ...item };\n        return next;\n    };\n}\n\n/**\n * Build an `applyOptimistic` that removes the entry matching the item's id\n * (by `idField`) from the list. For `delete` mutations, pass variables carrying\n * at least the id field.\n *\n * @typeParam T - The list item shape.\n * @param idField - The identity field. Default `\"id\"`.\n * @returns An `(current, item) => T[]` patcher for a list cache.\n *\n * @example\n * useOfflineMutation<{ id: string }, Note[], Note>({\n *     sync, queryKey: [\"notes\"],\n *     toEntry: ({ id }) => ({ op: \"delete\", recordId: id }),\n *     applyOptimistic: removeById(),\n * });\n */\nexport function removeById<T, V extends Partial<Record<keyof T, unknown>> = T>(\n    idField: keyof T = \"id\" as keyof T,\n): (current: T[] | undefined, item: V) => T[] {\n    return (current = [], item) => {\n        const targetId = (item as Record<keyof T, unknown>)[idField];\n        return current.filter((entry) => entry[idField] !== targetId);\n    };\n}\n"],"mappings":";AAuBA,SAAgB,EACZ,IAAmB,MACuB;CAC1C,QAAQ,IAAU,CAAC,GAAG,MAAS;EAC3B,IAAM,IAAQ,EAAQ,WAAW,MAAU,EAAM,OAAa,EAAK,EAAQ;EAC3E,IAAI,MAAU,IAAI,OAAO,CAAC,GAAG,GAAS,CAAI;EAC1C,IAAM,IAAO,EAAQ,MAAM;EAE3B,OADA,EAAK,KAAS;GAAE,GAAG,EAAQ;GAAQ,GAAG;EAAK,GACpC;CACX;AACJ;AAkBA,SAAgB,EACZ,IAAmB,MACuB;CAC1C,QAAQ,IAAU,CAAC,GAAG,MAAS;EAC3B,IAAM,IAAY,EAAkC;EACpD,OAAO,EAAQ,QAAQ,MAAU,EAAM,OAAa,CAAQ;CAChE;AACJ"}

package/dist/query/pagination.cjs

@@ -0,0 +1,2 @@
+function e(e){if(typeof e!=`object`||!e)return!1;let t=e;return Array.isArray(t.items)&&typeof t.total==`number`&&typeof t.pages==`number`}function t(e){if(typeof e!=`object`||!e)return!1;let t=e;return Array.isArray(t.items)&&typeof t.has_more==`boolean`&&`next_cursor`in t}function n(e=20){return{items:[],total:0,page:1,size:e,pages:0}}exports.emptyOffsetPage=n,exports.isCursorPage=t,exports.isOffsetPage=e;
+//# sourceMappingURL=pagination.cjs.map

package/dist/query/pagination.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.cjs","names":[],"sources":["../../src/query/pagination.ts"],"sourcesContent":["// Contracts mirroring the Tempest FastAPI SDK pagination envelopes, so a\n// React frontend consumes them with no manual mapping.\n//\n// Offset (fastapi-pagination `Page` / BasePaginationSchema):\n//   { items, total, page, size, pages }   (some configs name the size `page_size`)\n// Cursor (CursorPaginationSchema):\n//   { items, next_cursor, has_more, limit }\n\n/** Offset-paginated response envelope (fastapi-pagination `Page[T]`). */\nexport interface OffsetPage<T> {\n    /** The rows for the current page. */\n    items: T[];\n    /** Total number of matching rows across all pages. */\n    total: number;\n    /** Current 1-based page number. */\n    page: number;\n    /** Total number of pages. */\n    pages: number;\n    /** Page size — fastapi-pagination emits `size`. */\n    size?: number;\n    /** Page size — some backends name it `page_size` instead. */\n    page_size?: number;\n}\n\n/** Cursor-paginated response envelope (`CursorPaginationSchema[T]`). */\nexport interface CursorPage<T> {\n    /** The rows for this batch. */\n    items: T[];\n    /** Opaque cursor for the next batch, or null when exhausted. Pass it back verbatim. */\n    next_cursor: string | null;\n    /** Whether another batch exists. */\n    has_more: boolean;\n    /** Batch size used for this query. */\n    limit: number;\n}\n\n/** Offset filter query params (fastapi-pagination / `BasePaginationFilterSchema`). */\nexport interface OffsetParams {\n    page?: number;\n    /** Page size — fastapi-pagination convention. */\n    size?: number;\n    /** Page size — `page_size` convention. */\n    page_size?: number;\n    order_by?: string;\n    ascending?: boolean;\n}\n\n/** Cursor filter query params (`CursorPaginationFilterSchema`). */\nexport interface CursorParams {\n    cursor?: string | null;\n    limit?: number;\n    order_by?: string;\n    ascending?: boolean;\n}\n\n/**\n * Type guard for an {@link OffsetPage} envelope.\n *\n * @param value - The unknown value to test.\n * @returns Whether it carries `items` + `total` + `page` + `pages`.\n */\nexport function isOffsetPage<T = unknown>(value: unknown): value is OffsetPage<T> {\n    if (typeof value !== \"object\" || value === null) return false;\n    const v = value as Record<string, unknown>;\n    return Array.isArray(v.items) && typeof v.total === \"number\" && typeof v.pages === \"number\";\n}\n\n/**\n * Type guard for a {@link CursorPage} envelope.\n *\n * @param value - The unknown value to test.\n * @returns Whether it carries `items` + `has_more` + a `next_cursor` key.\n */\nexport function isCursorPage<T = unknown>(value: unknown): value is CursorPage<T> {\n    if (typeof value !== \"object\" || value === null) return false;\n    const v = value as Record<string, unknown>;\n    return Array.isArray(v.items) && typeof v.has_more === \"boolean\" && \"next_cursor\" in v;\n}\n\n/**\n * Build an empty {@link OffsetPage} — handy as `placeholderData`/`initialData`.\n *\n * @param pageSize - The page size to report (default 20).\n * @returns An empty offset page on page 1.\n */\nexport function emptyOffsetPage<T>(pageSize = 20): OffsetPage<T> {\n    return { items: [], total: 0, page: 1, size: pageSize, pages: 0 };\n}\n"],"mappings":"AA6DA,SAAgB,EAA0B,EAAwC,CAC9E,GAAI,OAAO,GAAU,WAAY,EAAgB,MAAO,GACxD,IAAM,EAAI,EACV,OAAO,MAAM,QAAQ,EAAE,KAAK,GAAK,OAAO,EAAE,OAAU,UAAY,OAAO,EAAE,OAAU,QACvF,CAQA,SAAgB,EAA0B,EAAwC,CAC9E,GAAI,OAAO,GAAU,WAAY,EAAgB,MAAO,GACxD,IAAM,EAAI,EACV,OAAO,MAAM,QAAQ,EAAE,KAAK,GAAK,OAAO,EAAE,UAAa,WAAa,gBAAiB,CACzF,CAQA,SAAgB,EAAmB,EAAW,GAAmB,CAC7D,MAAO,CAAE,MAAO,CAAC,EAAG,MAAO,EAAG,KAAM,EAAG,KAAM,EAAU,MAAO,CAAE,CACpE"}

package/dist/query/pagination.js

@@ -0,0 +1,24 @@
+//#region src/query/pagination.ts
+function e(e) {
+	if (typeof e != "object" || !e) return !1;
+	let t = e;
+	return Array.isArray(t.items) && typeof t.total == "number" && typeof t.pages == "number";
+}
+function t(e) {
+	if (typeof e != "object" || !e) return !1;
+	let t = e;
+	return Array.isArray(t.items) && typeof t.has_more == "boolean" && "next_cursor" in t;
+}
+function n(e = 20) {
+	return {
+		items: [],
+		total: 0,
+		page: 1,
+		size: e,
+		pages: 0
+	};
+}
+//#endregion
+export { n as emptyOffsetPage, t as isCursorPage, e as isOffsetPage };
+
+//# sourceMappingURL=pagination.js.map

package/dist/query/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","names":[],"sources":["../../src/query/pagination.ts"],"sourcesContent":["// Contracts mirroring the Tempest FastAPI SDK pagination envelopes, so a\n// React frontend consumes them with no manual mapping.\n//\n// Offset (fastapi-pagination `Page` / BasePaginationSchema):\n//   { items, total, page, size, pages }   (some configs name the size `page_size`)\n// Cursor (CursorPaginationSchema):\n//   { items, next_cursor, has_more, limit }\n\n/** Offset-paginated response envelope (fastapi-pagination `Page[T]`). */\nexport interface OffsetPage<T> {\n    /** The rows for the current page. */\n    items: T[];\n    /** Total number of matching rows across all pages. */\n    total: number;\n    /** Current 1-based page number. */\n    page: number;\n    /** Total number of pages. */\n    pages: number;\n    /** Page size — fastapi-pagination emits `size`. */\n    size?: number;\n    /** Page size — some backends name it `page_size` instead. */\n    page_size?: number;\n}\n\n/** Cursor-paginated response envelope (`CursorPaginationSchema[T]`). */\nexport interface CursorPage<T> {\n    /** The rows for this batch. */\n    items: T[];\n    /** Opaque cursor for the next batch, or null when exhausted. Pass it back verbatim. */\n    next_cursor: string | null;\n    /** Whether another batch exists. */\n    has_more: boolean;\n    /** Batch size used for this query. */\n    limit: number;\n}\n\n/** Offset filter query params (fastapi-pagination / `BasePaginationFilterSchema`). */\nexport interface OffsetParams {\n    page?: number;\n    /** Page size — fastapi-pagination convention. */\n    size?: number;\n    /** Page size — `page_size` convention. */\n    page_size?: number;\n    order_by?: string;\n    ascending?: boolean;\n}\n\n/** Cursor filter query params (`CursorPaginationFilterSchema`). */\nexport interface CursorParams {\n    cursor?: string | null;\n    limit?: number;\n    order_by?: string;\n    ascending?: boolean;\n}\n\n/**\n * Type guard for an {@link OffsetPage} envelope.\n *\n * @param value - The unknown value to test.\n * @returns Whether it carries `items` + `total` + `page` + `pages`.\n */\nexport function isOffsetPage<T = unknown>(value: unknown): value is OffsetPage<T> {\n    if (typeof value !== \"object\" || value === null) return false;\n    const v = value as Record<string, unknown>;\n    return Array.isArray(v.items) && typeof v.total === \"number\" && typeof v.pages === \"number\";\n}\n\n/**\n * Type guard for a {@link CursorPage} envelope.\n *\n * @param value - The unknown value to test.\n * @returns Whether it carries `items` + `has_more` + a `next_cursor` key.\n */\nexport function isCursorPage<T = unknown>(value: unknown): value is CursorPage<T> {\n    if (typeof value !== \"object\" || value === null) return false;\n    const v = value as Record<string, unknown>;\n    return Array.isArray(v.items) && typeof v.has_more === \"boolean\" && \"next_cursor\" in v;\n}\n\n/**\n * Build an empty {@link OffsetPage} — handy as `placeholderData`/`initialData`.\n *\n * @param pageSize - The page size to report (default 20).\n * @returns An empty offset page on page 1.\n */\nexport function emptyOffsetPage<T>(pageSize = 20): OffsetPage<T> {\n    return { items: [], total: 0, page: 1, size: pageSize, pages: 0 };\n}\n"],"mappings":";AA6DA,SAAgB,EAA0B,GAAwC;CAC9E,IAAI,OAAO,KAAU,aAAY,GAAgB,OAAO;CACxD,IAAM,IAAI;CACV,OAAO,MAAM,QAAQ,EAAE,KAAK,KAAK,OAAO,EAAE,SAAU,YAAY,OAAO,EAAE,SAAU;AACvF;AAQA,SAAgB,EAA0B,GAAwC;CAC9E,IAAI,OAAO,KAAU,aAAY,GAAgB,OAAO;CACxD,IAAM,IAAI;CACV,OAAO,MAAM,QAAQ,EAAE,KAAK,KAAK,OAAO,EAAE,YAAa,aAAa,iBAAiB;AACzF;AAQA,SAAgB,EAAmB,IAAW,IAAmB;CAC7D,OAAO;EAAE,OAAO,CAAC;EAAG,OAAO;EAAG,MAAM;EAAG,MAAM;EAAU,OAAO;CAAE;AACpE"}

package/dist/query/use-cursor-query.cjs

@@ -0,0 +1,2 @@
+let e=require("@tanstack/react-query");function t(t){let{queryKey:n,queryFn:r,limit:i=20,orderBy:a,ascending:o=!1,...s}=t,c=(0,e.useInfiniteQuery)({...s,queryKey:[...n,{limit:i,orderBy:a,ascending:o}],initialPageParam:null,queryFn:({pageParam:e})=>r({cursor:e,limit:i,order_by:a,ascending:o}),getNextPageParam:e=>e.has_more?e.next_cursor:void 0}),l=c.data?.pages??[];return{items:l.flatMap(e=>e.items),pages:l,hasNextPage:c.hasNextPage,isLoading:c.isLoading,isFetchingNextPage:c.isFetchingNextPage,error:c.error,fetchNextPage:()=>void c.fetchNextPage(),refetch:()=>void c.refetch()}}exports.useCursorQuery=t;
+//# sourceMappingURL=use-cursor-query.cjs.map

package/dist/query/use-cursor-query.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-cursor-query.cjs","names":[],"sources":["../../src/query/use-cursor-query.ts"],"sourcesContent":["import { useInfiniteQuery } from \"@tanstack/react-query\";\nimport type { InfiniteData, QueryKey, UseInfiniteQueryOptions } from \"@tanstack/react-query\";\n\nimport type { CursorPage, CursorParams } from \"./pagination\";\n\nexport interface UseCursorQueryOptions<T> extends Omit<\n    UseInfiniteQueryOptions<\n        CursorPage<T>,\n        Error,\n        InfiniteData<CursorPage<T>, string | null>,\n        QueryKey,\n        string | null\n    >,\n    \"queryKey\" | \"queryFn\" | \"initialPageParam\" | \"getNextPageParam\"\n> {\n    /** Base query key — `limit`/sort is appended for cache isolation. */\n    queryKey: QueryKey;\n    /** Fetcher receiving the cursor params; return the backend envelope. */\n    queryFn: (params: CursorParams) => Promise<CursorPage<T>> | CursorPage<T>;\n    /** Batch size sent as `limit`. Default: 20. */\n    limit?: number;\n    /** Initial `order_by`. */\n    orderBy?: string;\n    /** Initial `ascending`. Default: false. */\n    ascending?: boolean;\n}\n\nexport interface UseCursorQueryResult<T> {\n    /** All rows fetched so far, flattened across batches. */\n    items: T[];\n    /** The raw batches, in fetch order. */\n    pages: CursorPage<T>[];\n    hasNextPage: boolean;\n    isLoading: boolean;\n    isFetchingNextPage: boolean;\n    error: Error | null;\n    /** Fetch the next batch (no-op when exhausted). */\n    fetchNextPage: () => void;\n    /** Refetch from the first batch. */\n    refetch: () => void;\n}\n\n/**\n * Cursor-pagination hook over TanStack Query's `useInfiniteQuery` for the\n * Tempest `CursorPaginationSchema` envelope\n * (`{ items, next_cursor, has_more, limit }`).\n *\n * The opaque `next_cursor` is fed straight back as the next page param; the\n * loop stops when `has_more` is false (or `next_cursor` is null).\n *\n * @example\n * const feed = useCursorQuery<Post>({\n *     queryKey: [\"feed\"],\n *     limit: 30,\n *     queryFn: (params) => postsService.listPosts(params),\n * });\n * // feed.items, feed.fetchNextPage(), feed.hasNextPage\n */\nexport function useCursorQuery<T>(options: UseCursorQueryOptions<T>): UseCursorQueryResult<T> {\n    const { queryKey, queryFn, limit = 20, orderBy, ascending = false, ...queryOptions } = options;\n\n    const query = useInfiniteQuery<\n        CursorPage<T>,\n        Error,\n        InfiniteData<CursorPage<T>, string | null>,\n        QueryKey,\n        string | null\n    >({\n        ...queryOptions,\n        queryKey: [...queryKey, { limit, orderBy, ascending }],\n        initialPageParam: null,\n        queryFn: ({ pageParam }) =>\n            queryFn({ cursor: pageParam, limit, order_by: orderBy, ascending }),\n        getNextPageParam: (last) => (last.has_more ? last.next_cursor : undefined),\n    });\n\n    const pages = query.data?.pages ?? [];\n\n    return {\n        items: pages.flatMap((p) => p.items),\n        pages,\n        hasNextPage: query.hasNextPage,\n        isLoading: query.isLoading,\n        isFetchingNextPage: query.isFetchingNextPage,\n        error: query.error,\n        fetchNextPage: () => void query.fetchNextPage(),\n        refetch: () => void query.refetch(),\n    };\n}\n"],"mappings":"uCA0DA,SAAgB,EAAkB,EAA4D,CAC1F,GAAM,CAAE,WAAU,UAAS,QAAQ,GAAI,UAAS,YAAY,GAAO,GAAG,GAAiB,EAEjF,GAAA,EAAA,EAAA,iBAAA,CAMJ,CACE,GAAG,EACH,SAAU,CAAC,GAAG,EAAU,CAAE,QAAO,UAAS,WAAU,CAAC,EACrD,iBAAkB,KAClB,SAAU,CAAE,eACR,EAAQ,CAAE,OAAQ,EAAW,QAAO,SAAU,EAAS,WAAU,CAAC,EACtE,iBAAmB,GAAU,EAAK,SAAW,EAAK,YAAc,IAAA,EACpE,CAAC,EAEK,EAAQ,EAAM,MAAM,OAAS,CAAC,EAEpC,MAAO,CACH,MAAO,EAAM,QAAS,GAAM,EAAE,KAAK,EACnC,QACA,YAAa,EAAM,YACnB,UAAW,EAAM,UACjB,mBAAoB,EAAM,mBAC1B,MAAO,EAAM,MACb,kBAAqB,KAAK,EAAM,cAAc,EAC9C,YAAe,KAAK,EAAM,QAAQ,CACtC,CACJ"}

package/dist/query/use-cursor-query.js

@@ -0,0 +1,34 @@
+import { useInfiniteQuery as e } from "@tanstack/react-query";
+//#region src/query/use-cursor-query.ts
+function t(t) {
+	let { queryKey: n, queryFn: r, limit: i = 20, orderBy: a, ascending: o = !1, ...s } = t, c = e({
+		...s,
+		queryKey: [...n, {
+			limit: i,
+			orderBy: a,
+			ascending: o
+		}],
+		initialPageParam: null,
+		queryFn: ({ pageParam: e }) => r({
+			cursor: e,
+			limit: i,
+			order_by: a,
+			ascending: o
+		}),
+		getNextPageParam: (e) => e.has_more ? e.next_cursor : void 0
+	}), l = c.data?.pages ?? [];
+	return {
+		items: l.flatMap((e) => e.items),
+		pages: l,
+		hasNextPage: c.hasNextPage,
+		isLoading: c.isLoading,
+		isFetchingNextPage: c.isFetchingNextPage,
+		error: c.error,
+		fetchNextPage: () => void c.fetchNextPage(),
+		refetch: () => void c.refetch()
+	};
+}
+//#endregion
+export { t as useCursorQuery };
+
+//# sourceMappingURL=use-cursor-query.js.map

package/dist/query/use-cursor-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-cursor-query.js","names":[],"sources":["../../src/query/use-cursor-query.ts"],"sourcesContent":["import { useInfiniteQuery } from \"@tanstack/react-query\";\nimport type { InfiniteData, QueryKey, UseInfiniteQueryOptions } from \"@tanstack/react-query\";\n\nimport type { CursorPage, CursorParams } from \"./pagination\";\n\nexport interface UseCursorQueryOptions<T> extends Omit<\n    UseInfiniteQueryOptions<\n        CursorPage<T>,\n        Error,\n        InfiniteData<CursorPage<T>, string | null>,\n        QueryKey,\n        string | null\n    >,\n    \"queryKey\" | \"queryFn\" | \"initialPageParam\" | \"getNextPageParam\"\n> {\n    /** Base query key — `limit`/sort is appended for cache isolation. */\n    queryKey: QueryKey;\n    /** Fetcher receiving the cursor params; return the backend envelope. */\n    queryFn: (params: CursorParams) => Promise<CursorPage<T>> | CursorPage<T>;\n    /** Batch size sent as `limit`. Default: 20. */\n    limit?: number;\n    /** Initial `order_by`. */\n    orderBy?: string;\n    /** Initial `ascending`. Default: false. */\n    ascending?: boolean;\n}\n\nexport interface UseCursorQueryResult<T> {\n    /** All rows fetched so far, flattened across batches. */\n    items: T[];\n    /** The raw batches, in fetch order. */\n    pages: CursorPage<T>[];\n    hasNextPage: boolean;\n    isLoading: boolean;\n    isFetchingNextPage: boolean;\n    error: Error | null;\n    /** Fetch the next batch (no-op when exhausted). */\n    fetchNextPage: () => void;\n    /** Refetch from the first batch. */\n    refetch: () => void;\n}\n\n/**\n * Cursor-pagination hook over TanStack Query's `useInfiniteQuery` for the\n * Tempest `CursorPaginationSchema` envelope\n * (`{ items, next_cursor, has_more, limit }`).\n *\n * The opaque `next_cursor` is fed straight back as the next page param; the\n * loop stops when `has_more` is false (or `next_cursor` is null).\n *\n * @example\n * const feed = useCursorQuery<Post>({\n *     queryKey: [\"feed\"],\n *     limit: 30,\n *     queryFn: (params) => postsService.listPosts(params),\n * });\n * // feed.items, feed.fetchNextPage(), feed.hasNextPage\n */\nexport function useCursorQuery<T>(options: UseCursorQueryOptions<T>): UseCursorQueryResult<T> {\n    const { queryKey, queryFn, limit = 20, orderBy, ascending = false, ...queryOptions } = options;\n\n    const query = useInfiniteQuery<\n        CursorPage<T>,\n        Error,\n        InfiniteData<CursorPage<T>, string | null>,\n        QueryKey,\n        string | null\n    >({\n        ...queryOptions,\n        queryKey: [...queryKey, { limit, orderBy, ascending }],\n        initialPageParam: null,\n        queryFn: ({ pageParam }) =>\n            queryFn({ cursor: pageParam, limit, order_by: orderBy, ascending }),\n        getNextPageParam: (last) => (last.has_more ? last.next_cursor : undefined),\n    });\n\n    const pages = query.data?.pages ?? [];\n\n    return {\n        items: pages.flatMap((p) => p.items),\n        pages,\n        hasNextPage: query.hasNextPage,\n        isLoading: query.isLoading,\n        isFetchingNextPage: query.isFetchingNextPage,\n        error: query.error,\n        fetchNextPage: () => void query.fetchNextPage(),\n        refetch: () => void query.refetch(),\n    };\n}\n"],"mappings":";;AA0DA,SAAgB,EAAkB,GAA4D;CAC1F,IAAM,EAAE,aAAU,YAAS,WAAQ,IAAI,YAAS,eAAY,IAAO,GAAG,MAAiB,GAEjF,IAAQ,EAMZ;EACE,GAAG;EACH,UAAU,CAAC,GAAG,GAAU;GAAE;GAAO;GAAS;EAAU,CAAC;EACrD,kBAAkB;EAClB,UAAU,EAAE,mBACR,EAAQ;GAAE,QAAQ;GAAW;GAAO,UAAU;GAAS;EAAU,CAAC;EACtE,mBAAmB,MAAU,EAAK,WAAW,EAAK,cAAc,KAAA;CACpE,CAAC,GAEK,IAAQ,EAAM,MAAM,SAAS,CAAC;CAEpC,OAAO;EACH,OAAO,EAAM,SAAS,MAAM,EAAE,KAAK;EACnC;EACA,aAAa,EAAM;EACnB,WAAW,EAAM;EACjB,oBAAoB,EAAM;EAC1B,OAAO,EAAM;EACb,qBAAqB,KAAK,EAAM,cAAc;EAC9C,eAAe,KAAK,EAAM,QAAQ;CACtC;AACJ"}

package/dist/query/use-offline-mutation.cjs

@@ -0,0 +1,2 @@
+let e=require("@tanstack/react-query");function t(t){let{sync:n,toEntry:r,queryKey:i,applyOptimistic:a,flush:o=!0,invalidate:s=!1}=t,c=(0,e.useQueryClient)();return(0,e.useMutation)({mutationFn:async e=>{let t=r(e),i=await n.enqueue(t.op,t.recordId,t.payload);if(o!==!1){let e=o===!0?`after-mutation`:o;n.flush(e)}return i},onMutate:async e=>{if(!i||!a)return{previous:void 0};await c.cancelQueries({queryKey:i});let t=c.getQueryData(i);return c.setQueryData(i,t=>a(t,e)),{previous:t}},onError:(e,t,n)=>{i&&n&&c.setQueryData(i,n.previous)},onSettled:()=>{s&&i&&c.invalidateQueries({queryKey:i})}})}exports.useOfflineMutation=t;
+//# sourceMappingURL=use-offline-mutation.cjs.map

package/dist/query/use-offline-mutation.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-offline-mutation.cjs","names":[],"sources":["../../src/query/use-offline-mutation.ts"],"sourcesContent":["import { useMutation, useQueryClient } from \"@tanstack/react-query\";\nimport type { QueryKey, UseMutationResult } from \"@tanstack/react-query\";\nimport type { OfflineSync, OutboxOp, SyncTrigger } from \"../offline\";\n\n/** The outbox entry a mutation's variables map to. */\nexport interface OutboxDraft<TPayload> {\n    /** The mutation kind. */\n    op: OutboxOp;\n    /** Primary key of the affected record. */\n    recordId: string;\n    /** Record snapshot for `create`/`update` (omit for `delete`). */\n    payload?: TPayload;\n}\n\n/**\n * Configuration for {@link useOfflineMutation}.\n *\n * @typeParam TVariables - The `mutate(variables)` input shape.\n * @typeParam TData - The cached query data optimistically patched.\n * @typeParam TPayload - Record snapshot carried by outbox entries.\n */\nexport interface UseOfflineMutationOptions<TVariables, TData, TPayload> {\n    /** The engine the mutation enqueues into. */\n    sync: OfflineSync<TPayload>;\n    /** Map `mutate` variables into an outbox entry. */\n    toEntry: (variables: TVariables) => OutboxDraft<TPayload>;\n    /**\n     * Query key to optimistically patch and (optionally) invalidate. Omit to\n     * only enqueue without touching the React Query cache.\n     */\n    queryKey?: QueryKey;\n    /**\n     * Produce the next cached value from the current one and the variables.\n     * Runs in `onMutate`; the previous value is restored automatically if the\n     * enqueue throws. Requires `queryKey`.\n     */\n    applyOptimistic?: (current: TData | undefined, variables: TVariables) => TData;\n    /**\n     * Trigger a flush after enqueueing. `true` (default) uses\n     * `\"after-mutation\"`; pass a custom {@link SyncTrigger} string, or `false`\n     * to leave flushing to the caller / auto-flush hooks.\n     */\n    flush?: boolean | SyncTrigger;\n    /** Invalidate `queryKey` in `onSettled` so a later read refetches. Default `false`. */\n    invalidate?: boolean;\n}\n\ninterface MutationContext<TData> {\n    previous: TData | undefined;\n}\n\n/**\n * Optimistic mutation that writes to an {@link OfflineSync} outbox instead of\n * hitting the network directly, bridging the sync engine and TanStack Query.\n *\n * On `mutate` it enqueues the entry, optimistically patches the given query\n * cache key and kicks a flush; if the enqueue itself throws, the cache is\n * rolled back to its previous value. Server delivery happens later inside the\n * engine's flush loop, so the UI updates instantly and survives reloads and\n * offline periods.\n *\n * @typeParam TVariables - The `mutate(variables)` input shape.\n * @typeParam TData - The cached query data optimistically patched.\n * @typeParam TPayload - Record snapshot carried by outbox entries.\n * @param options - Engine, variables→entry mapping and cache wiring.\n * @returns The TanStack {@link UseMutationResult}; the mutation resolves to the\n *   generated outbox entry id.\n *\n * @example\n * const addNote = useOfflineMutation({\n *     sync: notesSync,\n *     queryKey: [\"notes\"],\n *     toEntry: (note: Note) => ({ op: \"create\", recordId: note.id, payload: note }),\n *     applyOptimistic: (current: Note[] = [], note) => [...current, note],\n * });\n * addNote.mutate(newNote);\n */\nexport function useOfflineMutation<TVariables, TData = unknown, TPayload = unknown>(\n    options: UseOfflineMutationOptions<TVariables, TData, TPayload>,\n): UseMutationResult<string, Error, TVariables, MutationContext<TData>> {\n    const { sync, toEntry, queryKey, applyOptimistic, flush = true, invalidate = false } = options;\n    const client = useQueryClient();\n\n    return useMutation<string, Error, TVariables, MutationContext<TData>>({\n        mutationFn: async (variables) => {\n            const draft = toEntry(variables);\n            const id = await sync.enqueue(draft.op, draft.recordId, draft.payload);\n            if (flush !== false) {\n                const trigger: SyncTrigger = flush === true ? \"after-mutation\" : flush;\n                void sync.flush(trigger);\n            }\n            return id;\n        },\n        onMutate: async (variables) => {\n            if (!queryKey || !applyOptimistic) return { previous: undefined };\n            await client.cancelQueries({ queryKey });\n            const previous = client.getQueryData<TData>(queryKey);\n            client.setQueryData<TData>(queryKey, (current) => applyOptimistic(current, variables));\n            return { previous };\n        },\n        onError: (_error, _variables, context) => {\n            if (queryKey && context) client.setQueryData(queryKey, context.previous);\n        },\n        onSettled: () => {\n            if (invalidate && queryKey) void client.invalidateQueries({ queryKey });\n        },\n    });\n}\n"],"mappings":"uCA6EA,SAAgB,EACZ,EACoE,CACpE,GAAM,CAAE,OAAM,UAAS,WAAU,kBAAiB,QAAQ,GAAM,aAAa,IAAU,EACjF,GAAA,EAAA,EAAA,eAAA,CAAwB,EAE9B,OAAA,EAAA,EAAA,YAAA,CAAsE,CAClE,WAAY,KAAO,IAAc,CAC7B,IAAM,EAAQ,EAAQ,CAAS,EACzB,EAAK,MAAM,EAAK,QAAQ,EAAM,GAAI,EAAM,SAAU,EAAM,OAAO,EACrE,GAAI,IAAU,GAAO,CACjB,IAAM,EAAuB,IAAU,GAAO,iBAAmB,EACjE,EAAU,MAAM,CAAO,CAC3B,CACA,OAAO,CACX,EACA,SAAU,KAAO,IAAc,CAC3B,GAAI,CAAC,GAAY,CAAC,EAAiB,MAAO,CAAE,SAAU,IAAA,EAAU,EAChE,MAAM,EAAO,cAAc,CAAE,UAAS,CAAC,EACvC,IAAM,EAAW,EAAO,aAAoB,CAAQ,EAEpD,OADA,EAAO,aAAoB,EAAW,GAAY,EAAgB,EAAS,CAAS,CAAC,EAC9E,CAAE,UAAS,CACtB,EACA,SAAU,EAAQ,EAAY,IAAY,CAClC,GAAY,GAAS,EAAO,aAAa,EAAU,EAAQ,QAAQ,CAC3E,EACA,cAAiB,CACT,GAAc,GAAU,EAAY,kBAAkB,CAAE,UAAS,CAAC,CAC1E,CACJ,CAAC,CACL"}

package/dist/query/use-offline-mutation.js

@@ -0,0 +1,31 @@
+import { useMutation as e, useQueryClient as t } from "@tanstack/react-query";
+//#region src/query/use-offline-mutation.ts
+function n(n) {
+	let { sync: r, toEntry: i, queryKey: a, applyOptimistic: o, flush: s = !0, invalidate: c = !1 } = n, l = t();
+	return e({
+		mutationFn: async (e) => {
+			let t = i(e), n = await r.enqueue(t.op, t.recordId, t.payload);
+			if (s !== !1) {
+				let e = s === !0 ? "after-mutation" : s;
+				r.flush(e);
+			}
+			return n;
+		},
+		onMutate: async (e) => {
+			if (!a || !o) return { previous: void 0 };
+			await l.cancelQueries({ queryKey: a });
+			let t = l.getQueryData(a);
+			return l.setQueryData(a, (t) => o(t, e)), { previous: t };
+		},
+		onError: (e, t, n) => {
+			a && n && l.setQueryData(a, n.previous);
+		},
+		onSettled: () => {
+			c && a && l.invalidateQueries({ queryKey: a });
+		}
+	});
+}
+//#endregion
+export { n as useOfflineMutation };
+
+//# sourceMappingURL=use-offline-mutation.js.map

package/dist/query/use-offline-mutation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-offline-mutation.js","names":[],"sources":["../../src/query/use-offline-mutation.ts"],"sourcesContent":["import { useMutation, useQueryClient } from \"@tanstack/react-query\";\nimport type { QueryKey, UseMutationResult } from \"@tanstack/react-query\";\nimport type { OfflineSync, OutboxOp, SyncTrigger } from \"../offline\";\n\n/** The outbox entry a mutation's variables map to. */\nexport interface OutboxDraft<TPayload> {\n    /** The mutation kind. */\n    op: OutboxOp;\n    /** Primary key of the affected record. */\n    recordId: string;\n    /** Record snapshot for `create`/`update` (omit for `delete`). */\n    payload?: TPayload;\n}\n\n/**\n * Configuration for {@link useOfflineMutation}.\n *\n * @typeParam TVariables - The `mutate(variables)` input shape.\n * @typeParam TData - The cached query data optimistically patched.\n * @typeParam TPayload - Record snapshot carried by outbox entries.\n */\nexport interface UseOfflineMutationOptions<TVariables, TData, TPayload> {\n    /** The engine the mutation enqueues into. */\n    sync: OfflineSync<TPayload>;\n    /** Map `mutate` variables into an outbox entry. */\n    toEntry: (variables: TVariables) => OutboxDraft<TPayload>;\n    /**\n     * Query key to optimistically patch and (optionally) invalidate. Omit to\n     * only enqueue without touching the React Query cache.\n     */\n    queryKey?: QueryKey;\n    /**\n     * Produce the next cached value from the current one and the variables.\n     * Runs in `onMutate`; the previous value is restored automatically if the\n     * enqueue throws. Requires `queryKey`.\n     */\n    applyOptimistic?: (current: TData | undefined, variables: TVariables) => TData;\n    /**\n     * Trigger a flush after enqueueing. `true` (default) uses\n     * `\"after-mutation\"`; pass a custom {@link SyncTrigger} string, or `false`\n     * to leave flushing to the caller / auto-flush hooks.\n     */\n    flush?: boolean | SyncTrigger;\n    /** Invalidate `queryKey` in `onSettled` so a later read refetches. Default `false`. */\n    invalidate?: boolean;\n}\n\ninterface MutationContext<TData> {\n    previous: TData | undefined;\n}\n\n/**\n * Optimistic mutation that writes to an {@link OfflineSync} outbox instead of\n * hitting the network directly, bridging the sync engine and TanStack Query.\n *\n * On `mutate` it enqueues the entry, optimistically patches the given query\n * cache key and kicks a flush; if the enqueue itself throws, the cache is\n * rolled back to its previous value. Server delivery happens later inside the\n * engine's flush loop, so the UI updates instantly and survives reloads and\n * offline periods.\n *\n * @typeParam TVariables - The `mutate(variables)` input shape.\n * @typeParam TData - The cached query data optimistically patched.\n * @typeParam TPayload - Record snapshot carried by outbox entries.\n * @param options - Engine, variables→entry mapping and cache wiring.\n * @returns The TanStack {@link UseMutationResult}; the mutation resolves to the\n *   generated outbox entry id.\n *\n * @example\n * const addNote = useOfflineMutation({\n *     sync: notesSync,\n *     queryKey: [\"notes\"],\n *     toEntry: (note: Note) => ({ op: \"create\", recordId: note.id, payload: note }),\n *     applyOptimistic: (current: Note[] = [], note) => [...current, note],\n * });\n * addNote.mutate(newNote);\n */\nexport function useOfflineMutation<TVariables, TData = unknown, TPayload = unknown>(\n    options: UseOfflineMutationOptions<TVariables, TData, TPayload>,\n): UseMutationResult<string, Error, TVariables, MutationContext<TData>> {\n    const { sync, toEntry, queryKey, applyOptimistic, flush = true, invalidate = false } = options;\n    const client = useQueryClient();\n\n    return useMutation<string, Error, TVariables, MutationContext<TData>>({\n        mutationFn: async (variables) => {\n            const draft = toEntry(variables);\n            const id = await sync.enqueue(draft.op, draft.recordId, draft.payload);\n            if (flush !== false) {\n                const trigger: SyncTrigger = flush === true ? \"after-mutation\" : flush;\n                void sync.flush(trigger);\n            }\n            return id;\n        },\n        onMutate: async (variables) => {\n            if (!queryKey || !applyOptimistic) return { previous: undefined };\n            await client.cancelQueries({ queryKey });\n            const previous = client.getQueryData<TData>(queryKey);\n            client.setQueryData<TData>(queryKey, (current) => applyOptimistic(current, variables));\n            return { previous };\n        },\n        onError: (_error, _variables, context) => {\n            if (queryKey && context) client.setQueryData(queryKey, context.previous);\n        },\n        onSettled: () => {\n            if (invalidate && queryKey) void client.invalidateQueries({ queryKey });\n        },\n    });\n}\n"],"mappings":";;AA6EA,SAAgB,EACZ,GACoE;CACpE,IAAM,EAAE,SAAM,YAAS,aAAU,oBAAiB,WAAQ,IAAM,gBAAa,OAAU,GACjF,IAAS,EAAe;CAE9B,OAAO,EAA+D;EAClE,YAAY,OAAO,MAAc;GAC7B,IAAM,IAAQ,EAAQ,CAAS,GACzB,IAAK,MAAM,EAAK,QAAQ,EAAM,IAAI,EAAM,UAAU,EAAM,OAAO;GACrE,IAAI,MAAU,IAAO;IACjB,IAAM,IAAuB,MAAU,KAAO,mBAAmB;IACjE,EAAU,MAAM,CAAO;GAC3B;GACA,OAAO;EACX;EACA,UAAU,OAAO,MAAc;GAC3B,IAAI,CAAC,KAAY,CAAC,GAAiB,OAAO,EAAE,UAAU,KAAA,EAAU;GAChE,MAAM,EAAO,cAAc,EAAE,YAAS,CAAC;GACvC,IAAM,IAAW,EAAO,aAAoB,CAAQ;GAEpD,OADA,EAAO,aAAoB,IAAW,MAAY,EAAgB,GAAS,CAAS,CAAC,GAC9E,EAAE,YAAS;EACtB;EACA,UAAU,GAAQ,GAAY,MAAY;GACtC,AAAI,KAAY,KAAS,EAAO,aAAa,GAAU,EAAQ,QAAQ;EAC3E;EACA,iBAAiB;GACb,AAAI,KAAc,KAAU,EAAY,kBAAkB,EAAE,YAAS,CAAC;EAC1E;CACJ,CAAC;AACL"}

package/dist/query/use-paginated-query.cjs

@@ -0,0 +1,2 @@
+let e=require("react"),t=require("@tanstack/react-query");function n(n){let{queryKey:r,queryFn:i,initialPage:a=1,pageSize:o=20,sizeParam:s=`size`,orderBy:c,ascending:l=!1,...u}=n,[d,f]=(0,e.useState)(a),p=(0,t.useQuery)({...u,queryKey:[...r,{page:d,pageSize:o,sizeParam:s,orderBy:c,ascending:l}],queryFn:()=>{let e={page:d,[s]:o};return c&&(e.order_by=c,e.ascending=l),i(e)},placeholderData:t.keepPreviousData}),m=p.data,h=m?.pages??0,g=d<h,_=d>1,v=(0,e.useCallback)(e=>f(Math.max(1,e)),[]),y=(0,e.useCallback)(()=>f(e=>e<h?e+1:e),[h]),b=(0,e.useCallback)(()=>f(e=>e>1?e-1:e),[]);return{page:m,items:m?.items??[],pageNumber:d,pageCount:h,total:m?.total??0,hasNext:g,hasPrev:_,isLoading:p.isLoading,isFetching:p.isFetching,error:p.error,setPage:v,next:y,prev:b,refetch:()=>void p.refetch()}}exports.usePaginatedQuery=n;
+//# sourceMappingURL=use-paginated-query.cjs.map

package/dist/query/use-paginated-query.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-paginated-query.cjs","names":[],"sources":["../../src/query/use-paginated-query.ts"],"sourcesContent":["import { useCallback, useState } from \"react\";\nimport { keepPreviousData, useQuery } from \"@tanstack/react-query\";\nimport type { QueryKey, UseQueryOptions } from \"@tanstack/react-query\";\n\nimport type { OffsetPage, OffsetParams } from \"./pagination\";\n\nexport interface UsePaginatedQueryOptions<T> extends Omit<\n    UseQueryOptions<OffsetPage<T>, Error, OffsetPage<T>, QueryKey>,\n    \"queryKey\" | \"queryFn\"\n> {\n    /** Base query key — the current page/sort is appended for cache isolation. */\n    queryKey: QueryKey;\n    /** Fetcher receiving the offset params; return the backend envelope. */\n    queryFn: (params: OffsetParams) => Promise<OffsetPage<T>> | OffsetPage<T>;\n    /** Initial 1-based page. Default: 1. */\n    initialPage?: number;\n    /** Page size. Default: 20. */\n    pageSize?: number;\n    /**\n     * Query-param name for the page size. fastapi-pagination uses `\"size\"`\n     * (default); SDK `BasePaginationFilterSchema` configs may use `\"page_size\"`.\n     */\n    sizeParam?: \"size\" | \"page_size\";\n    /** Initial `order_by` (only sent when set). */\n    orderBy?: string;\n    /** Initial `ascending` (only sent when `orderBy` is set). Default: false. */\n    ascending?: boolean;\n}\n\nexport interface UsePaginatedQueryResult<T> {\n    /** The current page envelope, or undefined while the first load is pending. */\n    page: OffsetPage<T> | undefined;\n    /** The rows of the current page (empty array while pending). */\n    items: T[];\n    /** Current 1-based page number (controlled by the hook). */\n    pageNumber: number;\n    /** Total page count from the last successful response. */\n    pageCount: number;\n    /** Total row count from the last successful response. */\n    total: number;\n    hasNext: boolean;\n    hasPrev: boolean;\n    isLoading: boolean;\n    isFetching: boolean;\n    error: Error | null;\n    /** Jump to a specific 1-based page (clamped to >= 1). */\n    setPage: (page: number) => void;\n    /** Go to the next page when available. */\n    next: () => void;\n    /** Go to the previous page when available. */\n    prev: () => void;\n    /** Refetch the current page. */\n    refetch: () => void;\n}\n\n/**\n * Offset-pagination hook over TanStack Query for the fastapi-pagination /\n * Tempest envelope (`{ items, total, page, size, pages }`).\n *\n * It owns the page state, sends `page` + the size param (`size` by default,\n * or `page_size` via `sizeParam`) plus optional `order_by`/`ascending` to your\n * fetcher, keeps the previous page visible while the next loads, and derives\n * `hasNext`/`hasPrev`/`pageCount`.\n *\n * @example\n * const users = usePaginatedQuery<User>({\n *     queryKey: [\"users\"],\n *     pageSize: 25,\n *     queryFn: (params) => usersService.listUsers(params),\n * });\n * // users.items, users.next(), users.hasNext, users.pageCount\n */\nexport function usePaginatedQuery<T>(\n    options: UsePaginatedQueryOptions<T>,\n): UsePaginatedQueryResult<T> {\n    const {\n        queryKey,\n        queryFn,\n        initialPage = 1,\n        pageSize = 20,\n        sizeParam = \"size\",\n        orderBy,\n        ascending = false,\n        ...queryOptions\n    } = options;\n\n    const [pageNumber, setPageNumber] = useState(initialPage);\n\n    const query = useQuery<OffsetPage<T>, Error>({\n        ...queryOptions,\n        queryKey: [...queryKey, { page: pageNumber, pageSize, sizeParam, orderBy, ascending }],\n        queryFn: () => {\n            const params: OffsetParams = { page: pageNumber, [sizeParam]: pageSize };\n            if (orderBy) {\n                params.order_by = orderBy;\n                params.ascending = ascending;\n            }\n            return queryFn(params);\n        },\n        placeholderData: keepPreviousData,\n    });\n\n    const page = query.data;\n    const pageCount = page?.pages ?? 0;\n    const hasNext = pageNumber < pageCount;\n    const hasPrev = pageNumber > 1;\n\n    const setPage = useCallback((next: number) => setPageNumber(Math.max(1, next)), []);\n    const next = useCallback(() => setPageNumber((p) => (p < pageCount ? p + 1 : p)), [pageCount]);\n    const prev = useCallback(() => setPageNumber((p) => (p > 1 ? p - 1 : p)), []);\n\n    return {\n        page,\n        items: page?.items ?? [],\n        pageNumber,\n        pageCount,\n        total: page?.total ?? 0,\n        hasNext,\n        hasPrev,\n        isLoading: query.isLoading,\n        isFetching: query.isFetching,\n        error: query.error,\n        setPage,\n        next,\n        prev,\n        refetch: () => void query.refetch(),\n    };\n}\n"],"mappings":"0DAwEA,SAAgB,EACZ,EAC0B,CAC1B,GAAM,CACF,WACA,UACA,cAAc,EACd,WAAW,GACX,YAAY,OACZ,UACA,YAAY,GACZ,GAAG,GACH,EAEE,CAAC,EAAY,IAAA,EAAA,EAAA,SAAA,CAA0B,CAAW,EAElD,GAAA,EAAA,EAAA,SAAA,CAAuC,CACzC,GAAG,EACH,SAAU,CAAC,GAAG,EAAU,CAAE,KAAM,EAAY,WAAU,YAAW,UAAS,WAAU,CAAC,EACrF,YAAe,CACX,IAAM,EAAuB,CAAE,KAAM,GAAa,GAAY,CAAS,EAKvE,OAJI,IACA,EAAO,SAAW,EAClB,EAAO,UAAY,GAEhB,EAAQ,CAAM,CACzB,EACA,gBAAiB,EAAA,gBACrB,CAAC,EAEK,EAAO,EAAM,KACb,EAAY,GAAM,OAAS,EAC3B,EAAU,EAAa,EACvB,EAAU,EAAa,EAEvB,GAAA,EAAA,EAAA,YAAA,CAAuB,GAAiB,EAAc,KAAK,IAAI,EAAG,CAAI,CAAC,EAAG,CAAC,CAAC,EAC5E,GAAA,EAAA,EAAA,YAAA,KAAyB,EAAe,GAAO,EAAI,EAAY,EAAI,EAAI,CAAE,EAAG,CAAC,CAAS,CAAC,EACvF,GAAA,EAAA,EAAA,YAAA,KAAyB,EAAe,GAAO,EAAI,EAAI,EAAI,EAAI,CAAE,EAAG,CAAC,CAAC,EAE5E,MAAO,CACH,OACA,MAAO,GAAM,OAAS,CAAC,EACvB,aACA,YACA,MAAO,GAAM,OAAS,EACtB,UACA,UACA,UAAW,EAAM,UACjB,WAAY,EAAM,WAClB,MAAO,EAAM,MACb,UACA,OACA,OACA,YAAe,KAAK,EAAM,QAAQ,CACtC,CACJ"}