tempest-react-sdk 0.8.0 → 0.9.0

package/bin/tempest.mjs

@@ -8,8 +8,11 @@
 //   tempest --help | --version
 import { spawnSync } from "node:child_process";
 import { existsSync, readFileSync } from "node:fs";
-import { join, resolve } from "node:path";
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
+import { generate } from "./lib/openapi/generate.mjs";
+import { loadSpec } from "./lib/openapi/load.mjs";
 
 const ROOT = process.cwd();
 const SELF_DIR = resolve(fileURLToPath(import.meta.url), "..");
@@ -234,6 +237,70 @@ function format(paths) {
     return run(requireBin("prettier"), ["--write", ...(paths.length ? paths : ["."])]);
 }
 
+// -------------------------------------------------------------- gen api ----
+
+/** Parse `--out <dir>` from the argv tail. */
+function parseOut(args, fallback) {
+    const i = args.indexOf("--out");
+    return i >= 0 && args[i + 1] ? args[i + 1] : fallback;
+}
+
+/**
+ * `tempest gen api <url|file> [--out src/api]` — generate Zod schemas, TS types
+ * and a service class per route-group from an OpenAPI spec.
+ */
+async function genApi(args) {
+    const source = args.find((a) => !a.startsWith("--") && a !== "api");
+    if (!source) {
+        console.error(
+            `${c.red}✗ Missing OpenAPI source.${c.reset} Usage: tempest gen api <url|file> [--out src/api]`,
+        );
+        return 1;
+    }
+    const outDir = resolve(ROOT, parseOut(args, "src/api"));
+    console.log(`${c.dim}→ loading ${source}${c.reset}`);
+    const doc = await loadSpec(source);
+    const { files, tags } = generate(doc);
+
+    for (const [rel, contents] of Object.entries(files)) {
+        const dest = join(outDir, rel);
+        await mkdir(dirname(dest), { recursive: true });
+        await writeFile(dest, contents);
+    }
+
+    console.log(
+        `\n${c.green}✓ Generated${c.reset} ${Object.keys(files).length} files for ${tags.length} route group(s): ${c.bold}${tags.join(", ")}${c.reset}`,
+    );
+    console.log(`  ${c.dim}out: ${outDir}${c.reset}`);
+    const prettier = localBin("prettier");
+    if (prettier) {
+        console.log(`${c.dim}→ prettier --write ${parseOut(args, "src/api")}${c.reset}`);
+        run(prettier, ["--write", parseOut(args, "src/api")]);
+    }
+    console.log(`\n${c.dim}Inject an ApiClient into a service:${c.reset}`);
+    console.log(`  import { createApiClient } from "tempest-react-sdk";`);
+    if (tags[0]) {
+        const cls = tags[0].replace(/[^a-zA-Z0-9]+(.)?/g, (_, ch) => (ch ? ch.toUpperCase() : ""));
+        const Cls = cls.charAt(0).toUpperCase() + cls.slice(1) + "Service";
+        console.log(`  import { ${Cls} } from "@/api/${tags[0].toLowerCase()}";`);
+        console.log(
+            `  const svc = new ${Cls}(createApiClient({ baseURL: import.meta.env.VITE_API_URL }));`,
+        );
+    }
+    return 0;
+}
+
+function gen(args) {
+    const what = args[0];
+    if (what !== "api") {
+        console.error(
+            `${c.red}✗ Unknown gen target: ${what ?? "(none)"}${c.reset} — only \`gen api\` is supported.`,
+        );
+        return 1;
+    }
+    return genApi(args.slice(1));
+}
+
 // ------------------------------------------------------------------ main ----
 
 function usage() {
@@ -248,6 +315,8 @@ ${c.bold}Commands${c.reset}
   ${c.bold}lint${c.reset} [paths]      Run ESLint (report only)
   ${c.bold}fix${c.reset} [paths]       ESLint --fix (sort imports, remove unused, tidy whitespace) + Prettier
   ${c.bold}format${c.reset} [paths]    Prettier --write
+  ${c.bold}gen api${c.reset} <src>    Generate Zod schemas + types + service classes from an OpenAPI spec
+                    (e.g. tempest gen api http://127.0.0.1:8000/openapi.json --out src/api)
 
 ${c.bold}Options${c.reset}
   -h, --help        Show this help
@@ -271,6 +340,7 @@ const commands = {
     lint: () => lint(rest),
     fix: () => fix(rest),
     format: () => format(rest),
+    gen: () => gen(rest),
 };
 
 if (!commands[cmd]) {
@@ -279,4 +349,16 @@ if (!commands[cmd]) {
     process.exit(1);
 }
 
-process.exit(commands[cmd]());
+const result = commands[cmd]();
+if (result instanceof Promise) {
+    result
+        .then((code) => process.exit(code))
+        .catch((err) => {
+            console.error(
+                `${c.red}✗ ${err instanceof Error ? err.message : String(err)}${c.reset}`,
+            );
+            process.exit(1);
+        });
+} else {
+    process.exit(result);
+}

package/dist/sw.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});async function d(i){if(typeof navigator>"u"||!("serviceWorker"in navigator))return null;try{const t=await navigator.serviceWorker.register(i.url,{scope:i.scope});return t.active&&i.onReady?.(t),t.addEventListener("updatefound",()=>{const n=t.installing;n&&n.addEventListener("statechange",()=>{n.state==="installed"&&navigator.serviceWorker.controller&&i.onUpdate?.(n,t)})}),t}catch(t){return i.onError?.(t),null}}function g(i){i.postMessage({type:"SKIP_WAITING"})}async function v(){if(typeof navigator>"u"||!("serviceWorker"in navigator))return 0;const i=await navigator.serviceWorker.getRegistrations();let t=0;for(const n of i)await n.unregister()&&(t+=1);return t}function c(){return globalThis}function y(i={}){const t=c(),{defaultTitle:n="Notificação",defaultIcon:e,defaultBadge:o,transform:s}=i;t.addEventListener("push",a=>{if(!a.data)return;let l;try{l=a.data.json()}catch{l={title:n,body:a.data.text()}}const r=s?s(l):l;if(!r)return;const u=r.title??n,f={body:r.body,icon:r.icon??e,badge:r.badge??o,image:r.image,tag:r.tag,data:{url:r.url??"/",...r.data??{}}};a.waitUntil(t.registration.showNotification(u,f))})}function p(i={}){const t=c(),n=i.resolveUrl??(e=>{if(typeof e=="string")return e;if(e&&typeof e=="object"&&"url"in e){const o=e.url;return typeof o=="string"?o:"/"}return"/"});t.addEventListener("notificationclick",e=>{e.notification.close();const o=n(e.notification.data);e.waitUntil((async()=>{const s=await t.clients.matchAll({type:"window",includeUncontrolled:!0});for(const a of s)if(a.url.includes(o))return a.focus();return t.clients.openWindow(o)})())})}function k(){const i=c();i.addEventListener("message",t=>{t.data?.type==="SKIP_WAITING"&&i.skipWaiting()})}exports.installNotificationClickHandler=p;exports.installPushHandler=y;exports.installSkipWaitingListener=k;exports.registerServiceWorker=d;exports.skipWaiting=g;exports.unregisterAllServiceWorkers=v;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});async function W(t){if(typeof navigator>"u"||!("serviceWorker"in navigator))return null;try{const e=await navigator.serviceWorker.register(t.url,{scope:t.scope});return e.active&&t.onReady?.(e),e.addEventListener("updatefound",()=>{const a=e.installing;a&&a.addEventListener("statechange",()=>{a.state==="installed"&&navigator.serviceWorker.controller&&t.onUpdate?.(a,e)})}),e}catch(e){return t.onError?.(e),null}}function L(t){t.postMessage({type:"SKIP_WAITING"})}async function N(){if(typeof navigator>"u"||!("serviceWorker"in navigator))return 0;const t=await navigator.serviceWorker.getRegistrations();let e=0;for(const a of t)await a.unregister()&&(e+=1);return e}function w(){return globalThis}function P(t={}){const e=w(),{defaultTitle:a="Notificação",defaultIcon:n,defaultBadge:c,transform:i}=t;e.addEventListener("push",r=>{if(!r.data)return;let s;try{s=r.data.json()}catch{s={title:a,body:r.data.text()}}const o=i?i(s):s;if(!o)return;const l=o.title??a,u={body:o.body,icon:o.icon??n,badge:o.badge??c,image:o.image,tag:o.tag,data:{url:o.url??"/",...o.data??{}}};r.waitUntil(e.registration.showNotification(l,u))})}function T(t={}){const e=w(),a=t.resolveUrl??(n=>{if(typeof n=="string")return n;if(n&&typeof n=="object"&&"url"in n){const c=n.url;return typeof c=="string"?c:"/"}return"/"});e.addEventListener("notificationclick",n=>{n.notification.close();const c=a(n.notification.data);n.waitUntil((async()=>{const i=await e.clients.matchAll({type:"window",includeUncontrolled:!0});for(const r of i)if(r.url.includes(c))return r.focus();return e.clients.openWindow(c)})())})}function U(){const t=w();t.addEventListener("message",e=>{e.data?.type==="SKIP_WAITING"&&t.skipWaiting()})}function v(){return globalThis}let h="";const p=new Set;function R(t,e){if(!e)return!1;const a=t.headers.get("date");return a?(Date.now()-new Date(a).getTime())/1e3>e:!1}async function g(t,e){if(!e)return;const a=await caches.open(t),n=await a.keys();if(!(n.length<=e))for(const c of n.slice(0,n.length-e))await a.delete(c)}async function x(t,e){const a=await caches.open(e.cacheName),n=await a.match(t);if(n&&!R(n,e.maxAgeSeconds))return n;const c=await fetch(t);return c.ok&&(await a.put(t,c.clone()),await g(e.cacheName,e.maxEntries)),c}async function A(t,e){const a=await caches.open(e.cacheName),n=(async()=>{const i=await fetch(t);return i.ok&&(await a.put(t,i.clone()),await g(e.cacheName,e.maxEntries)),i})(),c=(e.networkTimeoutSeconds??0)*1e3;try{if(c>0){const i=new Promise((r,s)=>setTimeout(()=>s(new Error("network-timeout")),c));return await Promise.race([n,i])}return await n}catch{const i=await a.match(t);if(i)return i;throw new Error("network-first: no network and no cache")}}async function $(t,e){const a=await caches.open(e.cacheName),n=await a.match(t),c=fetch(t).then(async r=>(r.ok&&(await a.put(t,r.clone()),await g(e.cacheName,e.maxEntries)),r)).catch(()=>{});if(n&&!R(n,e.maxAgeSeconds))return n;const i=await c;if(i)return i;if(n)return n;throw new Error("stale-while-revalidate: no network and no cache")}function y(t,e){switch(e.strategy){case"cache-first":return x(t,e);case"network-first":return A(t,e);case"stale-while-revalidate":return $(t,e)}}function D(t,e,a){return typeof t.match=="function"?t.match(e,a):t.match.test(e.href)}async function S(t,e){const a=t.headers.get("range");if(!a)return e;const n=/^bytes=(\d*)-(\d*)$/.exec(a.trim());if(!n||n[1]===""&&n[2]==="")return new Response(null,{status:416,statusText:"Range Not Satisfiable"});const c=await e.clone().arrayBuffer(),i=c.byteLength;let r,s;if(n[1]===""){const u=Number(n[2]);r=Math.max(0,i-u),s=i-1}else r=Number(n[1]),s=n[2]===""?i-1:Math.min(Number(n[2]),i-1);if(r>s||r>=i)return new Response(null,{status:416,statusText:"Range Not Satisfiable",headers:{"Content-Range":`bytes */${i}`}});const o=c.slice(r,s+1),l=new Headers(e.headers);return l.set("Content-Range",`bytes ${r}-${s}/${i}`),l.set("Content-Length",String(o.byteLength)),l.set("Accept-Ranges","bytes"),new Response(o,{status:206,statusText:"Partial Content",headers:l})}function C(t){v().addEventListener("fetch",a=>{const n=a.request;if(n.method!=="GET")return;const c=new URL(n.url),i=t.find(r=>D(r,c,n));if(i){if(i.rangeRequests&&n.headers.has("range")){const r=new Request(n.url,{headers:H(n.headers),credentials:n.credentials,mode:n.mode==="navigate"?"same-origin":n.mode});a.respondWith(y(r,i).then(s=>S(n,s)));return}a.respondWith(y(n,i))}})}function H(t){const e=new Headers(t);return e.delete("range"),e}function j(t={}){const e=v(),{manifestUrl:a="/precache-manifest.json",cacheName:n="tempest-precache",navigateFallback:c="/index.html",navigateFallbackDenylist:i=[],skipWaiting:r=!0}=t;e.addEventListener("install",s=>{s.waitUntil((async()=>{const l=await(await fetch(a,{cache:"no-cache"})).json();h=`${n}-${l.version}`,await(await caches.open(h)).addAll(l.urls);for(const f of l.urls)p.add(new URL(f,e.location.origin).pathname);r&&await e.skipWaiting()})())}),e.addEventListener("activate",s=>{s.waitUntil((async()=>{const o=await caches.keys();await Promise.all(o.filter(l=>l.startsWith(`${n}-`)&&l!==h).map(l=>caches.delete(l))),await e.clients.claim()})())}),e.addEventListener("fetch",s=>{const o=s.request;if(o.method!=="GET")return;const l=new URL(o.url);if(l.origin===e.location.origin){if(o.mode==="navigate"){if(i.some(u=>u.test(l.pathname)))return;s.respondWith((async()=>{try{return await fetch(o)}catch{const f=await(await caches.open(h)).match(c);if(f)return f;throw new Error("offline and no cached app shell")}})());return}p.has(l.pathname)&&s.respondWith((async()=>await(await caches.open(h)).match(o)??fetch(o))())}})}function I(){return globalThis}const d="requests";function m(t){return new Promise((e,a)=>{const n=indexedDB.open(t,1);n.onupgradeneeded=()=>{n.result.createObjectStore(d,{keyPath:"id",autoIncrement:!0})},n.onsuccess=()=>e(n.result),n.onerror=()=>a(n.error)})}function E(t){return new Promise((e,a)=>{t.oncomplete=()=>e(),t.onerror=()=>a(t.error),t.onabort=()=>a(t.error)})}async function M(t,e){const a=await m(t),n=a.transaction(d,"readwrite");n.objectStore(d).add(e),await E(n),a.close()}async function q(t){const e=await m(t),a=e.transaction(d,"readonly"),n=await new Promise((c,i)=>{const r=a.objectStore(d).getAll();r.onsuccess=()=>c(r.result),r.onerror=()=>i(r.error)});return e.close(),n}async function k(t,e){const a=await m(t),n=a.transaction(d,"readwrite");n.objectStore(d).delete(e),await E(n),a.close()}async function B(t,e){const a=await t.clone().arrayBuffer();return{url:t.url,method:t.method,headers:[...t.headers.entries()],body:a.byteLength>0?a:null,timestamp:e}}function G(t){return new Request(t.url,{method:t.method,headers:t.headers,body:t.body??void 0})}async function b(t,e,a){const n=await q(t);let c=0;for(const i of n)if(i.id!==void 0){if(a-i.timestamp>e){await k(t,i.id);continue}try{const r=await fetch(G(i));r.ok||r.status>=400&&r.status<500?await k(t,i.id):c+=1}catch{c+=1}}if(c>0)throw new Error(`background-sync: ${c} request(s) still pending`)}function F(t,e,a){return t?typeof t=="function"?t(e,a):t.test(e.href):!0}function O(t={}){const e=I(),{match:a,queueName:n="tempest-bg-sync",maxRetentionMinutes:c=1440}=t,i=c*60*1e3;e.addEventListener("fetch",r=>{const s=r.request;if(s.method==="GET"||s.method==="HEAD")return;const o=new URL(s.url);F(a,o,s)&&r.respondWith(fetch(s.clone()).catch(async l=>{const u=await B(s,Date.now());await M(n,u);try{await e.registration.sync?.register(n)}catch{}throw l}))}),e.addEventListener("sync",r=>{r.tag===n&&r.waitUntil(b(n,i,Date.now()))}),e.addEventListener("fetch",r=>{e.registration.sync||r.request.method==="GET"&&r.waitUntil(b(n,i,Date.now()).catch(()=>{}))})}exports.createPartialResponse=S;exports.installBackgroundSync=O;exports.installNotificationClickHandler=T;exports.installPrecache=j;exports.installPushHandler=P;exports.installRuntimeCache=C;exports.installSkipWaitingListener=U;exports.registerServiceWorker=W;exports.skipWaiting=L;exports.unregisterAllServiceWorkers=N;
 //# sourceMappingURL=sw.cjs.map

package/dist/sw.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"sw.cjs","sources":["../src/sw/register-service-worker.ts","../src/sw/create-push-handler.ts"],"sourcesContent":["export interface RegisterServiceWorkerOptions {\n    /** Public URL of the compiled service worker file (e.g. `/sw.js`). */\n    url: string;\n    /** SW scope (default: SW directory). */\n    scope?: string;\n    /** Called once the registration is active. */\n    onReady?: (registration: ServiceWorkerRegistration) => void;\n    /**\n     * Called when a new worker has finished installing while another worker\n     * still controls the page. The host app typically prompts the user to\n     * reload and then calls {@link skipWaiting} on the returned worker.\n     */\n    onUpdate?: (waiting: ServiceWorker, registration: ServiceWorkerRegistration) => void;\n    /** Called on registration failure. */\n    onError?: (error: unknown) => void;\n}\n\n/**\n * Register a service worker with consistent update-detection wiring.\n *\n * Skips silently when the runtime has no `serviceWorker` support. The host\n * app keeps full control over the SW file — this helper only handles the\n * boilerplate around `register()` and `updatefound`.\n *\n * @returns The registration when it succeeds, or `null` when unsupported.\n */\nexport async function registerServiceWorker(\n    options: RegisterServiceWorkerOptions,\n): Promise<ServiceWorkerRegistration | null> {\n    if (typeof navigator === \"undefined\" || !(\"serviceWorker\" in navigator)) {\n        return null;\n    }\n\n    try {\n        const registration = await navigator.serviceWorker.register(options.url, {\n            scope: options.scope,\n        });\n\n        if (registration.active) options.onReady?.(registration);\n\n        registration.addEventListener(\"updatefound\", () => {\n            const installing = registration.installing;\n            if (!installing) return;\n            installing.addEventListener(\"statechange\", () => {\n                if (installing.state === \"installed\" && navigator.serviceWorker.controller) {\n                    options.onUpdate?.(installing, registration);\n                }\n            });\n        });\n\n        return registration;\n    } catch (error) {\n        options.onError?.(error);\n        return null;\n    }\n}\n\n/**\n * Tell a waiting worker to activate immediately. Pair with `onUpdate` to roll\n * out updates after the user confirms a reload prompt.\n */\nexport function skipWaiting(worker: ServiceWorker): void {\n    worker.postMessage({ type: \"SKIP_WAITING\" });\n}\n\n/**\n * Unregister all registered service workers for this origin.\n *\n * @returns Number of workers that were unregistered.\n */\nexport async function unregisterAllServiceWorkers(): Promise<number> {\n    if (typeof navigator === \"undefined\" || !(\"serviceWorker\" in navigator)) return 0;\n    const registrations = await navigator.serviceWorker.getRegistrations();\n    let count = 0;\n    for (const registration of registrations) {\n        const result = await registration.unregister();\n        if (result) count += 1;\n    }\n    return count;\n}\n","/**\n * Service-worker context helpers for handling `push` and `notificationclick`\n * events. Import these inside your own `sw.ts` — they expect to run in the\n * service-worker global scope, not in the main thread.\n *\n * @example\n *   /// <reference lib=\"webworker\" />\n *   import { installPushHandler, installNotificationClickHandler } from \"tempest-react-sdk\";\n *\n *   installPushHandler({ defaultIcon: \"/icons/Logo.png\" });\n *   installNotificationClickHandler();\n */\n\ninterface SwGlobal {\n    registration: {\n        showNotification(title: string, options?: NotificationOptions): Promise<void>;\n    };\n    clients: {\n        matchAll(options: { type: \"window\"; includeUncontrolled?: boolean }): Promise<\n            {\n                url: string;\n                focused: boolean;\n                focus(): Promise<unknown>;\n                navigate(url: string): Promise<unknown>;\n            }[]\n        >;\n        openWindow(url: string): Promise<unknown>;\n    };\n    addEventListener(\n        type: \"push\",\n        listener: (event: {\n            data: { json(): unknown; text(): string } | null;\n            waitUntil(promise: Promise<unknown>): void;\n        }) => void,\n    ): void;\n    addEventListener(\n        type: \"notificationclick\",\n        listener: (event: {\n            notification: { close(): void; data?: unknown };\n            waitUntil(promise: Promise<unknown>): void;\n        }) => void,\n    ): void;\n    skipWaiting(): Promise<void>;\n}\n\nfunction getSwScope(): SwGlobal {\n    return globalThis as unknown as SwGlobal;\n}\n\nexport interface PushPayload {\n    title?: string;\n    body?: string;\n    icon?: string;\n    badge?: string;\n    image?: string;\n    tag?: string;\n    url?: string;\n    /** Arbitrary extra data forwarded to `event.notification.data`. */\n    data?: Record<string, unknown>;\n}\n\nexport interface InstallPushHandlerOptions {\n    /** Title used when the payload omits one. */\n    defaultTitle?: string;\n    /** Icon used when the payload omits one. */\n    defaultIcon?: string;\n    /** Badge image (mobile). */\n    defaultBadge?: string;\n    /**\n     * Transform the raw payload before showing the notification. Return `null`\n     * to suppress the notification entirely (e.g. silent pings).\n     */\n    transform?: (payload: PushPayload) => PushPayload | null;\n}\n\n/**\n * Install a `push` event listener that parses the payload as JSON (with a\n * plain-text fallback) and shows a notification.\n */\nexport function installPushHandler(options: InstallPushHandlerOptions = {}): void {\n    const sw = getSwScope();\n    const { defaultTitle = \"Notificação\", defaultIcon, defaultBadge, transform } = options;\n\n    sw.addEventListener(\"push\", (event) => {\n        if (!event.data) return;\n\n        let raw: PushPayload;\n        try {\n            raw = event.data.json() as PushPayload;\n        } catch {\n            raw = { title: defaultTitle, body: event.data.text() };\n        }\n\n        const payload = transform ? transform(raw) : raw;\n        if (!payload) return;\n\n        const title = payload.title ?? defaultTitle;\n        const notification: NotificationOptions & { image?: string } = {\n            body: payload.body,\n            icon: payload.icon ?? defaultIcon,\n            badge: payload.badge ?? defaultBadge,\n            image: payload.image,\n            tag: payload.tag,\n            data: { url: payload.url ?? \"/\", ...(payload.data ?? {}) },\n        };\n\n        event.waitUntil(sw.registration.showNotification(title, notification));\n    });\n}\n\nexport interface InstallNotificationClickHandlerOptions {\n    /** Resolve the destination URL from the notification data. Default: `data.url`. */\n    resolveUrl?: (data: unknown) => string;\n}\n\n/**\n * Install a `notificationclick` handler that focuses an existing client when\n * possible and falls back to opening a new window.\n */\nexport function installNotificationClickHandler(\n    options: InstallNotificationClickHandlerOptions = {},\n): void {\n    const sw = getSwScope();\n    const resolveUrl =\n        options.resolveUrl ??\n        ((data: unknown) => {\n            if (typeof data === \"string\") return data;\n            if (data && typeof data === \"object\" && \"url\" in data) {\n                const url = (data as Record<string, unknown>).url;\n                return typeof url === \"string\" ? url : \"/\";\n            }\n            return \"/\";\n        });\n\n    sw.addEventListener(\"notificationclick\", (event) => {\n        event.notification.close();\n        const target = resolveUrl(event.notification.data);\n\n        event.waitUntil(\n            (async () => {\n                const clients = await sw.clients.matchAll({\n                    type: \"window\",\n                    includeUncontrolled: true,\n                });\n                for (const client of clients) {\n                    if (client.url.includes(target)) {\n                        return client.focus();\n                    }\n                }\n                return sw.clients.openWindow(target);\n            })(),\n        );\n    });\n}\n\n/**\n * Install a `message` listener that activates a waiting worker when the host\n * app sends `{ type: \"SKIP_WAITING\" }`.\n */\nexport function installSkipWaitingListener(): void {\n    const sw = getSwScope() as SwGlobal & {\n        addEventListener(\n            type: \"message\",\n            listener: (event: { data?: { type?: string } }) => void,\n        ): void;\n    };\n    sw.addEventListener(\"message\", (event) => {\n        if (event.data?.type === \"SKIP_WAITING\") {\n            void sw.skipWaiting();\n        }\n    });\n}\n"],"names":["registerServiceWorker","options","registration","installing","error","skipWaiting","worker","unregisterAllServiceWorkers","registrations","count","getSwScope","installPushHandler","sw","defaultTitle","defaultIcon","defaultBadge","transform","event","raw","payload","title","notification","installNotificationClickHandler","resolveUrl","data","url","target","clients","client","installSkipWaitingListener"],"mappings":"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"}
+{"version":3,"file":"sw.cjs","sources":["../src/sw/register-service-worker.ts","../src/sw/create-push-handler.ts","../src/sw/cache.ts","../src/sw/background-sync.ts"],"sourcesContent":["export interface RegisterServiceWorkerOptions {\n    /** Public URL of the compiled service worker file (e.g. `/sw.js`). */\n    url: string;\n    /** SW scope (default: SW directory). */\n    scope?: string;\n    /** Called once the registration is active. */\n    onReady?: (registration: ServiceWorkerRegistration) => void;\n    /**\n     * Called when a new worker has finished installing while another worker\n     * still controls the page. The host app typically prompts the user to\n     * reload and then calls {@link skipWaiting} on the returned worker.\n     */\n    onUpdate?: (waiting: ServiceWorker, registration: ServiceWorkerRegistration) => void;\n    /** Called on registration failure. */\n    onError?: (error: unknown) => void;\n}\n\n/**\n * Register a service worker with consistent update-detection wiring.\n *\n * Skips silently when the runtime has no `serviceWorker` support. The host\n * app keeps full control over the SW file — this helper only handles the\n * boilerplate around `register()` and `updatefound`.\n *\n * @returns The registration when it succeeds, or `null` when unsupported.\n */\nexport async function registerServiceWorker(\n    options: RegisterServiceWorkerOptions,\n): Promise<ServiceWorkerRegistration | null> {\n    if (typeof navigator === \"undefined\" || !(\"serviceWorker\" in navigator)) {\n        return null;\n    }\n\n    try {\n        const registration = await navigator.serviceWorker.register(options.url, {\n            scope: options.scope,\n        });\n\n        if (registration.active) options.onReady?.(registration);\n\n        registration.addEventListener(\"updatefound\", () => {\n            const installing = registration.installing;\n            if (!installing) return;\n            installing.addEventListener(\"statechange\", () => {\n                if (installing.state === \"installed\" && navigator.serviceWorker.controller) {\n                    options.onUpdate?.(installing, registration);\n                }\n            });\n        });\n\n        return registration;\n    } catch (error) {\n        options.onError?.(error);\n        return null;\n    }\n}\n\n/**\n * Tell a waiting worker to activate immediately. Pair with `onUpdate` to roll\n * out updates after the user confirms a reload prompt.\n */\nexport function skipWaiting(worker: ServiceWorker): void {\n    worker.postMessage({ type: \"SKIP_WAITING\" });\n}\n\n/**\n * Unregister all registered service workers for this origin.\n *\n * @returns Number of workers that were unregistered.\n */\nexport async function unregisterAllServiceWorkers(): Promise<number> {\n    if (typeof navigator === \"undefined\" || !(\"serviceWorker\" in navigator)) return 0;\n    const registrations = await navigator.serviceWorker.getRegistrations();\n    let count = 0;\n    for (const registration of registrations) {\n        const result = await registration.unregister();\n        if (result) count += 1;\n    }\n    return count;\n}\n","/**\n * Service-worker context helpers for handling `push` and `notificationclick`\n * events. Import these inside your own `sw.ts` — they expect to run in the\n * service-worker global scope, not in the main thread.\n *\n * @example\n *   /// <reference lib=\"webworker\" />\n *   import { installPushHandler, installNotificationClickHandler } from \"tempest-react-sdk\";\n *\n *   installPushHandler({ defaultIcon: \"/icons/Logo.png\" });\n *   installNotificationClickHandler();\n */\n\ninterface SwGlobal {\n    registration: {\n        showNotification(title: string, options?: NotificationOptions): Promise<void>;\n    };\n    clients: {\n        matchAll(options: { type: \"window\"; includeUncontrolled?: boolean }): Promise<\n            {\n                url: string;\n                focused: boolean;\n                focus(): Promise<unknown>;\n                navigate(url: string): Promise<unknown>;\n            }[]\n        >;\n        openWindow(url: string): Promise<unknown>;\n    };\n    addEventListener(\n        type: \"push\",\n        listener: (event: {\n            data: { json(): unknown; text(): string } | null;\n            waitUntil(promise: Promise<unknown>): void;\n        }) => void,\n    ): void;\n    addEventListener(\n        type: \"notificationclick\",\n        listener: (event: {\n            notification: { close(): void; data?: unknown };\n            waitUntil(promise: Promise<unknown>): void;\n        }) => void,\n    ): void;\n    skipWaiting(): Promise<void>;\n}\n\nfunction getSwScope(): SwGlobal {\n    return globalThis as unknown as SwGlobal;\n}\n\nexport interface PushPayload {\n    title?: string;\n    body?: string;\n    icon?: string;\n    badge?: string;\n    image?: string;\n    tag?: string;\n    url?: string;\n    /** Arbitrary extra data forwarded to `event.notification.data`. */\n    data?: Record<string, unknown>;\n}\n\nexport interface InstallPushHandlerOptions {\n    /** Title used when the payload omits one. */\n    defaultTitle?: string;\n    /** Icon used when the payload omits one. */\n    defaultIcon?: string;\n    /** Badge image (mobile). */\n    defaultBadge?: string;\n    /**\n     * Transform the raw payload before showing the notification. Return `null`\n     * to suppress the notification entirely (e.g. silent pings).\n     */\n    transform?: (payload: PushPayload) => PushPayload | null;\n}\n\n/**\n * Install a `push` event listener that parses the payload as JSON (with a\n * plain-text fallback) and shows a notification.\n */\nexport function installPushHandler(options: InstallPushHandlerOptions = {}): void {\n    const sw = getSwScope();\n    const { defaultTitle = \"Notificação\", defaultIcon, defaultBadge, transform } = options;\n\n    sw.addEventListener(\"push\", (event) => {\n        if (!event.data) return;\n\n        let raw: PushPayload;\n        try {\n            raw = event.data.json() as PushPayload;\n        } catch {\n            raw = { title: defaultTitle, body: event.data.text() };\n        }\n\n        const payload = transform ? transform(raw) : raw;\n        if (!payload) return;\n\n        const title = payload.title ?? defaultTitle;\n        const notification: NotificationOptions & { image?: string } = {\n            body: payload.body,\n            icon: payload.icon ?? defaultIcon,\n            badge: payload.badge ?? defaultBadge,\n            image: payload.image,\n            tag: payload.tag,\n            data: { url: payload.url ?? \"/\", ...(payload.data ?? {}) },\n        };\n\n        event.waitUntil(sw.registration.showNotification(title, notification));\n    });\n}\n\nexport interface InstallNotificationClickHandlerOptions {\n    /** Resolve the destination URL from the notification data. Default: `data.url`. */\n    resolveUrl?: (data: unknown) => string;\n}\n\n/**\n * Install a `notificationclick` handler that focuses an existing client when\n * possible and falls back to opening a new window.\n */\nexport function installNotificationClickHandler(\n    options: InstallNotificationClickHandlerOptions = {},\n): void {\n    const sw = getSwScope();\n    const resolveUrl =\n        options.resolveUrl ??\n        ((data: unknown) => {\n            if (typeof data === \"string\") return data;\n            if (data && typeof data === \"object\" && \"url\" in data) {\n                const url = (data as Record<string, unknown>).url;\n                return typeof url === \"string\" ? url : \"/\";\n            }\n            return \"/\";\n        });\n\n    sw.addEventListener(\"notificationclick\", (event) => {\n        event.notification.close();\n        const target = resolveUrl(event.notification.data);\n\n        event.waitUntil(\n            (async () => {\n                const clients = await sw.clients.matchAll({\n                    type: \"window\",\n                    includeUncontrolled: true,\n                });\n                for (const client of clients) {\n                    if (client.url.includes(target)) {\n                        return client.focus();\n                    }\n                }\n                return sw.clients.openWindow(target);\n            })(),\n        );\n    });\n}\n\n/**\n * Install a `message` listener that activates a waiting worker when the host\n * app sends `{ type: \"SKIP_WAITING\" }`.\n */\nexport function installSkipWaitingListener(): void {\n    const sw = getSwScope() as SwGlobal & {\n        addEventListener(\n            type: \"message\",\n            listener: (event: { data?: { type?: string } }) => void,\n        ): void;\n    };\n    sw.addEventListener(\"message\", (event) => {\n        if (event.data?.type === \"SKIP_WAITING\") {\n            void sw.skipWaiting();\n        }\n    });\n}\n","/**\n * Service-worker caching helpers — a small, dependency-free subset of what\n * Workbox provides: precaching of the build's app shell (so the app launches\n * offline) plus runtime caching strategies for fonts, APIs and images.\n *\n * Import these inside your own `sw.ts`. They run in the service-worker global\n * scope, not the main thread. Pair `installPrecache` with the\n * `tempestPwaManifest()` Vite plugin (from `tempest-react-sdk/vite`), which\n * emits the `precache-manifest.json` this reads at install time.\n *\n * @example\n *   /// <reference lib=\"webworker\" />\n *   import { installRuntimeCache, installPrecache } from \"tempest-react-sdk/sw\";\n *\n *   // Register specific routes FIRST so they win over the precache catch-all.\n *   installRuntimeCache([\n *     { match: /\\/api\\//, strategy: \"network-first\", cacheName: \"api\", maxAgeSeconds: 300 },\n *   ]);\n *   installPrecache();\n */\n\n/** Minimal shape of the events we touch, to avoid pulling in `lib.webworker`. */\ninterface ExtendableEventLike {\n    waitUntil(promise: Promise<unknown>): void;\n}\n\ninterface FetchEventLike extends ExtendableEventLike {\n    request: Request;\n    respondWith(response: Response | Promise<Response>): void;\n}\n\ninterface CacheSwGlobal {\n    addEventListener(type: \"install\", listener: (event: ExtendableEventLike) => void): void;\n    addEventListener(type: \"activate\", listener: (event: ExtendableEventLike) => void): void;\n    addEventListener(type: \"fetch\", listener: (event: FetchEventLike) => void): void;\n    clients: { claim(): Promise<void> };\n    skipWaiting(): Promise<void>;\n    location: { origin: string };\n}\n\nfunction getSwScope(): CacheSwGlobal {\n    return globalThis as unknown as CacheSwGlobal;\n}\n\n/** Caching strategy for a runtime route. Mirrors the common Workbox trio. */\nexport type RuntimeStrategy = \"cache-first\" | \"network-first\" | \"stale-while-revalidate\";\n\n/** A single runtime-caching rule, matched against each `GET` request. */\nexport interface RuntimeRoute {\n    /** A `RegExp` tested against the full URL, or a predicate over the parsed URL. */\n    match: RegExp | ((url: URL, request: Request) => boolean);\n    /** How to resolve a match. */\n    strategy: RuntimeStrategy;\n    /** Cache bucket name for this route. */\n    cacheName: string;\n    /** Trim the cache to at most this many entries (FIFO) after each write. */\n    maxEntries?: number;\n    /** Treat a cached response older than this (seconds) as a miss. */\n    maxAgeSeconds?: number;\n    /** For `network-first`: fall back to cache after this timeout (seconds). */\n    networkTimeoutSeconds?: number;\n    /**\n     * Serve HTTP `Range` requests (206 Partial Content) by slicing the cached\n     * full response. Enable for audio/video so seeking works offline. The full\n     * resource is cached once (the `Range` header is stripped before caching).\n     */\n    rangeRequests?: boolean;\n}\n\n/** Options for {@link installPrecache}. */\nexport interface InstallPrecacheOptions {\n    /** URL of the manifest emitted by `tempestPwaManifest()`. Default `/precache-manifest.json`. */\n    manifestUrl?: string;\n    /** Cache name prefix; the manifest `version` is appended. Default `tempest-precache`. */\n    cacheName?: string;\n    /** App-shell document served for navigation requests offline. Default `/index.html`. */\n    navigateFallback?: string;\n    /** Navigation paths that should NOT use the fallback (e.g. `[/^\\/api\\//]`). */\n    navigateFallbackDenylist?: RegExp[];\n    /** Activate the new worker immediately after precaching. Default `true`. */\n    skipWaiting?: boolean;\n}\n\ninterface PrecacheManifest {\n    version: string;\n    urls: string[];\n}\n\nlet precacheName = \"\";\nconst precachedPaths = new Set<string>();\n\n/** Whether a cached response has aged past `maxAgeSeconds` (best-effort, via `Date`). */\nfunction isExpired(response: Response, maxAgeSeconds?: number): boolean {\n    if (!maxAgeSeconds) return false;\n    const dateHeader = response.headers.get(\"date\");\n    if (!dateHeader) return false;\n    const age = (Date.now() - new Date(dateHeader).getTime()) / 1000;\n    return age > maxAgeSeconds;\n}\n\n/** Drop oldest entries until the cache holds at most `maxEntries`. */\nasync function trimCache(cacheName: string, maxEntries?: number): Promise<void> {\n    if (!maxEntries) return;\n    const cache = await caches.open(cacheName);\n    const keys = await cache.keys();\n    if (keys.length <= maxEntries) return;\n    for (const key of keys.slice(0, keys.length - maxEntries)) {\n        await cache.delete(key);\n    }\n}\n\nasync function cacheFirst(request: Request, route: RuntimeRoute): Promise<Response> {\n    const cache = await caches.open(route.cacheName);\n    const cached = await cache.match(request);\n    if (cached && !isExpired(cached, route.maxAgeSeconds)) return cached;\n\n    const response = await fetch(request);\n    if (response.ok) {\n        await cache.put(request, response.clone());\n        await trimCache(route.cacheName, route.maxEntries);\n    }\n    return response;\n}\n\nasync function networkFirst(request: Request, route: RuntimeRoute): Promise<Response> {\n    const cache = await caches.open(route.cacheName);\n\n    const network = (async (): Promise<Response> => {\n        const response = await fetch(request);\n        if (response.ok) {\n            await cache.put(request, response.clone());\n            await trimCache(route.cacheName, route.maxEntries);\n        }\n        return response;\n    })();\n\n    const timeoutMs = (route.networkTimeoutSeconds ?? 0) * 1000;\n    try {\n        if (timeoutMs > 0) {\n            const timeout = new Promise<never>((_, reject) =>\n                setTimeout(() => reject(new Error(\"network-timeout\")), timeoutMs),\n            );\n            return await Promise.race([network, timeout]);\n        }\n        return await network;\n    } catch {\n        const cached = await cache.match(request);\n        if (cached) return cached;\n        throw new Error(\"network-first: no network and no cache\");\n    }\n}\n\nasync function staleWhileRevalidate(request: Request, route: RuntimeRoute): Promise<Response> {\n    const cache = await caches.open(route.cacheName);\n    const cached = await cache.match(request);\n\n    const network = fetch(request)\n        .then(async (response) => {\n            if (response.ok) {\n                await cache.put(request, response.clone());\n                await trimCache(route.cacheName, route.maxEntries);\n            }\n            return response;\n        })\n        .catch(() => undefined);\n\n    if (cached && !isExpired(cached, route.maxAgeSeconds)) return cached;\n    const response = await network;\n    if (response) return response;\n    if (cached) return cached;\n    throw new Error(\"stale-while-revalidate: no network and no cache\");\n}\n\nfunction runRoute(request: Request, route: RuntimeRoute): Promise<Response> {\n    switch (route.strategy) {\n        case \"cache-first\":\n            return cacheFirst(request, route);\n        case \"network-first\":\n            return networkFirst(request, route);\n        case \"stale-while-revalidate\":\n            return staleWhileRevalidate(request, route);\n    }\n}\n\nfunction routeMatches(route: RuntimeRoute, url: URL, request: Request): boolean {\n    return typeof route.match === \"function\"\n        ? route.match(url, request)\n        : route.match.test(url.href);\n}\n\n/**\n * Build a `206 Partial Content` response from a full one for an HTTP `Range`\n * request. Supports `bytes=start-end`, open-ended `bytes=start-` and suffix\n * `bytes=-suffixLength`. Returns the original response when there is no usable\n * `Range` header, or a `416` when the range is unsatisfiable.\n *\n * @param request The incoming request (its `Range` header drives the slice).\n * @param response The full (200) response to slice.\n */\nexport async function createPartialResponse(\n    request: Request,\n    response: Response,\n): Promise<Response> {\n    const rangeHeader = request.headers.get(\"range\");\n    if (!rangeHeader) return response;\n\n    const match = /^bytes=(\\d*)-(\\d*)$/.exec(rangeHeader.trim());\n    if (!match || (match[1] === \"\" && match[2] === \"\")) {\n        return new Response(null, { status: 416, statusText: \"Range Not Satisfiable\" });\n    }\n\n    const buffer = await response.clone().arrayBuffer();\n    const total = buffer.byteLength;\n\n    let start: number;\n    let end: number;\n    if (match[1] === \"\") {\n        // Suffix range: last N bytes.\n        const suffix = Number(match[2]);\n        start = Math.max(0, total - suffix);\n        end = total - 1;\n    } else {\n        start = Number(match[1]);\n        end = match[2] === \"\" ? total - 1 : Math.min(Number(match[2]), total - 1);\n    }\n\n    if (start > end || start >= total) {\n        return new Response(null, {\n            status: 416,\n            statusText: \"Range Not Satisfiable\",\n            headers: { \"Content-Range\": `bytes */${total}` },\n        });\n    }\n\n    const slice = buffer.slice(start, end + 1);\n    const headers = new Headers(response.headers);\n    headers.set(\"Content-Range\", `bytes ${start}-${end}/${total}`);\n    headers.set(\"Content-Length\", String(slice.byteLength));\n    headers.set(\"Accept-Ranges\", \"bytes\");\n\n    return new Response(slice, {\n        status: 206,\n        statusText: \"Partial Content\",\n        headers,\n    });\n}\n\n/**\n * Install a `fetch` handler that resolves matching `GET` requests with the\n * given runtime strategies. Non-matching requests are left untouched (no\n * `respondWith`), so a later {@link installPrecache} can handle them.\n *\n * Register this BEFORE `installPrecache` so specific routes win over the\n * precache catch-all.\n *\n * @param routes Ordered rules; the first whose `match` passes handles the request.\n */\nexport function installRuntimeCache(routes: RuntimeRoute[]): void {\n    const sw = getSwScope();\n    sw.addEventListener(\"fetch\", (event) => {\n        const request = event.request;\n        if (request.method !== \"GET\") return;\n\n        const url = new URL(request.url);\n        const route = routes.find((candidate) => routeMatches(candidate, url, request));\n        if (!route) return;\n\n        if (route.rangeRequests && request.headers.has(\"range\")) {\n            // Cache/serve the FULL resource once (no Range), then slice it.\n            const full = new Request(request.url, {\n                headers: stripRange(request.headers),\n                credentials: request.credentials,\n                mode: request.mode === \"navigate\" ? \"same-origin\" : request.mode,\n            });\n            event.respondWith(\n                runRoute(full, route).then((response) => createPartialResponse(request, response)),\n            );\n            return;\n        }\n\n        event.respondWith(runRoute(request, route));\n    });\n}\n\n/** Copy headers without the `Range` header (so the cached entry is the full file). */\nfunction stripRange(headers: Headers): Headers {\n    const out = new Headers(headers);\n    out.delete(\"range\");\n    return out;\n}\n\n/**\n * Precache the app shell at `install` and serve it offline:\n *  - reads `precache-manifest.json` (emitted by `tempestPwaManifest()`),\n *  - caches every listed URL under a versioned cache,\n *  - on `activate`, deletes stale precache versions and claims open clients,\n *  - on `fetch`, serves precached assets cache-first and falls back to the\n *    `navigateFallback` document for offline navigations (SPA routing).\n *\n * Same-origin only. Register this LAST, after any {@link installRuntimeCache}.\n */\nexport function installPrecache(options: InstallPrecacheOptions = {}): void {\n    const sw = getSwScope();\n    const {\n        manifestUrl = \"/precache-manifest.json\",\n        cacheName = \"tempest-precache\",\n        navigateFallback = \"/index.html\",\n        navigateFallbackDenylist = [],\n        skipWaiting = true,\n    } = options;\n\n    sw.addEventListener(\"install\", (event) => {\n        event.waitUntil(\n            (async () => {\n                const response = await fetch(manifestUrl, { cache: \"no-cache\" });\n                const manifest = (await response.json()) as PrecacheManifest;\n                precacheName = `${cacheName}-${manifest.version}`;\n\n                const cache = await caches.open(precacheName);\n                await cache.addAll(manifest.urls);\n                for (const url of manifest.urls) {\n                    precachedPaths.add(new URL(url, sw.location.origin).pathname);\n                }\n                if (skipWaiting) await sw.skipWaiting();\n            })(),\n        );\n    });\n\n    sw.addEventListener(\"activate\", (event) => {\n        event.waitUntil(\n            (async () => {\n                const keys = await caches.keys();\n                await Promise.all(\n                    keys\n                        .filter((key) => key.startsWith(`${cacheName}-`) && key !== precacheName)\n                        .map((key) => caches.delete(key)),\n                );\n                await sw.clients.claim();\n            })(),\n        );\n    });\n\n    sw.addEventListener(\"fetch\", (event) => {\n        const request = event.request;\n        if (request.method !== \"GET\") return;\n\n        const url = new URL(request.url);\n        if (url.origin !== sw.location.origin) return;\n\n        // SPA navigations: serve the cached app shell when offline.\n        if (request.mode === \"navigate\") {\n            if (navigateFallbackDenylist.some((re) => re.test(url.pathname))) return;\n            event.respondWith(\n                (async () => {\n                    try {\n                        return await fetch(request);\n                    } catch {\n                        const cache = await caches.open(precacheName);\n                        const shell = await cache.match(navigateFallback);\n                        if (shell) return shell;\n                        throw new Error(\"offline and no cached app shell\");\n                    }\n                })(),\n            );\n            return;\n        }\n\n        // Precached static assets: cache-first.\n        if (precachedPaths.has(url.pathname)) {\n            event.respondWith(\n                (async () => {\n                    const cache = await caches.open(precacheName);\n                    const cached = await cache.match(request);\n                    return cached ?? fetch(request);\n                })(),\n            );\n        }\n    });\n}\n","/**\n * Background-sync helper: queue failed mutating requests (POST/PUT/PATCH/DELETE)\n * while offline and replay them when connectivity returns. A dependency-free\n * take on Workbox's `BackgroundSyncPlugin`, backed by a tiny IndexedDB queue.\n *\n * Import inside your `sw.ts`. Uses the Background Sync API (`registration.sync`)\n * when available, and also replays opportunistically on the next request as a\n * fallback for browsers without it (e.g. Safari).\n *\n * @example\n *   import { installBackgroundSync } from \"tempest-react-sdk/sw\";\n *\n *   installBackgroundSync({ match: (url) => url.pathname.startsWith(\"/api/\") });\n */\n\ninterface SyncEventLike {\n    tag: string;\n    waitUntil(promise: Promise<unknown>): void;\n}\n\ninterface BgFetchEventLike {\n    request: Request;\n    respondWith(response: Response | Promise<Response>): void;\n    waitUntil(promise: Promise<unknown>): void;\n}\n\ninterface BgSwGlobal {\n    registration: { sync?: { register(tag: string): Promise<void> } };\n    addEventListener(type: \"sync\", listener: (event: SyncEventLike) => void): void;\n    addEventListener(type: \"fetch\", listener: (event: BgFetchEventLike) => void): void;\n}\n\nfunction getSwScope(): BgSwGlobal {\n    return globalThis as unknown as BgSwGlobal;\n}\n\n/** A serialized request stored in the queue. */\ninterface QueuedRequest {\n    id?: number;\n    url: string;\n    method: string;\n    headers: [string, string][];\n    body: ArrayBuffer | null;\n    timestamp: number;\n}\n\n/** Options for {@link installBackgroundSync}. */\nexport interface InstallBackgroundSyncOptions {\n    /**\n     * Which requests to queue on failure. A `RegExp` against the URL or a\n     * predicate. Only non-`GET` requests are ever considered. Default: all\n     * non-`GET` requests.\n     */\n    match?: RegExp | ((url: URL, request: Request) => boolean);\n    /** IndexedDB database name, also used as the sync tag. Default `tempest-bg-sync`. */\n    queueName?: string;\n    /** Drop queued requests older than this (minutes) on replay. Default `1440` (24h). */\n    maxRetentionMinutes?: number;\n}\n\nconst STORE = \"requests\";\n\nfunction openQueueDb(name: string): Promise<IDBDatabase> {\n    return new Promise((resolve, reject) => {\n        const request = indexedDB.open(name, 1);\n        request.onupgradeneeded = () => {\n            request.result.createObjectStore(STORE, { keyPath: \"id\", autoIncrement: true });\n        };\n        request.onsuccess = () => resolve(request.result);\n        request.onerror = () => reject(request.error);\n    });\n}\n\nfunction txDone(tx: IDBTransaction): Promise<void> {\n    return new Promise((resolve, reject) => {\n        tx.oncomplete = () => resolve();\n        tx.onerror = () => reject(tx.error);\n        tx.onabort = () => reject(tx.error);\n    });\n}\n\nasync function enqueue(name: string, entry: QueuedRequest): Promise<void> {\n    const db = await openQueueDb(name);\n    const tx = db.transaction(STORE, \"readwrite\");\n    tx.objectStore(STORE).add(entry);\n    await txDone(tx);\n    db.close();\n}\n\nasync function readAll(name: string): Promise<QueuedRequest[]> {\n    const db = await openQueueDb(name);\n    const tx = db.transaction(STORE, \"readonly\");\n    const all = await new Promise<QueuedRequest[]>((resolve, reject) => {\n        const req = tx.objectStore(STORE).getAll();\n        req.onsuccess = () => resolve(req.result as QueuedRequest[]);\n        req.onerror = () => reject(req.error);\n    });\n    db.close();\n    return all;\n}\n\nasync function remove(name: string, id: number): Promise<void> {\n    const db = await openQueueDb(name);\n    const tx = db.transaction(STORE, \"readwrite\");\n    tx.objectStore(STORE).delete(id);\n    await txDone(tx);\n    db.close();\n}\n\nasync function serializeRequest(request: Request, timestamp: number): Promise<QueuedRequest> {\n    const buffer = await request.clone().arrayBuffer();\n    return {\n        url: request.url,\n        method: request.method,\n        headers: [...request.headers.entries()],\n        body: buffer.byteLength > 0 ? buffer : null,\n        timestamp,\n    };\n}\n\nfunction deserializeRequest(entry: QueuedRequest): Request {\n    return new Request(entry.url, {\n        method: entry.method,\n        headers: entry.headers,\n        body: entry.body ?? undefined,\n    });\n}\n\n/**\n * Replay every queued request once. Successful (or stale) entries are removed;\n * entries that fail again are kept for the next attempt. Throws if any entry\n * still fails, so a `sync` handler keeps the sync pending.\n */\nasync function replayQueue(name: string, maxRetentionMs: number, now: number): Promise<void> {\n    const entries = await readAll(name);\n    let pending = 0;\n\n    for (const entry of entries) {\n        if (entry.id === undefined) continue;\n        if (now - entry.timestamp > maxRetentionMs) {\n            await remove(name, entry.id);\n            continue;\n        }\n        try {\n            const response = await fetch(deserializeRequest(entry));\n            if (response.ok || (response.status >= 400 && response.status < 500)) {\n                // 2xx = done; 4xx = client error that won't fix itself → drop it.\n                await remove(name, entry.id);\n            } else {\n                pending += 1;\n            }\n        } catch {\n            pending += 1;\n        }\n    }\n\n    if (pending > 0) throw new Error(`background-sync: ${pending} request(s) still pending`);\n}\n\nfunction matches(\n    match: InstallBackgroundSyncOptions[\"match\"],\n    url: URL,\n    request: Request,\n): boolean {\n    if (!match) return true;\n    return typeof match === \"function\" ? match(url, request) : match.test(url.href);\n}\n\n/**\n * Install the background-sync queue: on a failed mutating request, the request\n * is serialized to IndexedDB and a sync is registered; the original fetch still\n * rejects (so your app can show an offline state), and the request is replayed\n * later when the network returns.\n */\nexport function installBackgroundSync(options: InstallBackgroundSyncOptions = {}): void {\n    const sw = getSwScope();\n    const { match, queueName = \"tempest-bg-sync\", maxRetentionMinutes = 1440 } = options;\n    const maxRetentionMs = maxRetentionMinutes * 60 * 1000;\n\n    sw.addEventListener(\"fetch\", (event) => {\n        const request = event.request;\n        if (request.method === \"GET\" || request.method === \"HEAD\") return;\n\n        const url = new URL(request.url);\n        if (!matches(match, url, request)) return;\n\n        event.respondWith(\n            fetch(request.clone()).catch(async (error) => {\n                const entry = await serializeRequest(request, Date.now());\n                await enqueue(queueName, entry);\n                try {\n                    await sw.registration.sync?.register(queueName);\n                } catch {\n                    // Background Sync API unavailable — opportunistic replay covers it.\n                }\n                throw error;\n            }),\n        );\n    });\n\n    sw.addEventListener(\"sync\", (event) => {\n        if (event.tag !== queueName) return;\n        event.waitUntil(replayQueue(queueName, maxRetentionMs, Date.now()));\n    });\n\n    // Fallback for browsers without the Background Sync API: whenever a GET\n    // succeeds (a sign we're online), drain the queue opportunistically.\n    sw.addEventListener(\"fetch\", (event) => {\n        if (sw.registration.sync) return; // native sync will handle it\n        if (event.request.method !== \"GET\") return;\n        event.waitUntil(replayQueue(queueName, maxRetentionMs, Date.now()).catch(() => undefined));\n    });\n}\n"],"names":["registerServiceWorker","options","registration","installing","error","skipWaiting","worker","unregisterAllServiceWorkers","registrations","count","getSwScope","installPushHandler","sw","defaultTitle","defaultIcon","defaultBadge","transform","event","raw","payload","title","notification","installNotificationClickHandler","resolveUrl","data","url","target","clients","client","installSkipWaitingListener","precacheName","precachedPaths","isExpired","response","maxAgeSeconds","dateHeader","trimCache","cacheName","maxEntries","cache","keys","key","cacheFirst","request","route","cached","networkFirst","network","timeoutMs","timeout","_","reject","staleWhileRevalidate","runRoute","routeMatches","createPartialResponse","rangeHeader","match","buffer","total","start","end","suffix","slice","headers","installRuntimeCache","routes","candidate","full","stripRange","out","installPrecache","manifestUrl","navigateFallback","navigateFallbackDenylist","manifest","re","shell","STORE","openQueueDb","name","resolve","txDone","tx","enqueue","entry","db","readAll","all","req","remove","id","serializeRequest","timestamp","deserializeRequest","replayQueue","maxRetentionMs","now","entries","pending","matches","installBackgroundSync","queueName","maxRetentionMinutes"],"mappings":"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"}

package/dist/sw.d.ts

@@ -1,3 +1,50 @@
+/**
+ * Build a `206 Partial Content` response from a full one for an HTTP `Range`
+ * request. Supports `bytes=start-end`, open-ended `bytes=start-` and suffix
+ * `bytes=-suffixLength`. Returns the original response when there is no usable
+ * `Range` header, or a `416` when the range is unsatisfiable.
+ *
+ * @param request The incoming request (its `Range` header drives the slice).
+ * @param response The full (200) response to slice.
+ */
+export declare function createPartialResponse(request: Request, response: Response): Promise<Response>;
+
+/**
+ * Install the background-sync queue: on a failed mutating request, the request
+ * is serialized to IndexedDB and a sync is registered; the original fetch still
+ * rejects (so your app can show an offline state), and the request is replayed
+ * later when the network returns.
+ */
+export declare function installBackgroundSync(options?: InstallBackgroundSyncOptions): void;
+
+/**
+ * Background-sync helper: queue failed mutating requests (POST/PUT/PATCH/DELETE)
+ * while offline and replay them when connectivity returns. A dependency-free
+ * take on Workbox's `BackgroundSyncPlugin`, backed by a tiny IndexedDB queue.
+ *
+ * Import inside your `sw.ts`. Uses the Background Sync API (`registration.sync`)
+ * when available, and also replays opportunistically on the next request as a
+ * fallback for browsers without it (e.g. Safari).
+ *
+ * @example
+ *   import { installBackgroundSync } from "tempest-react-sdk/sw";
+ *
+ *   installBackgroundSync({ match: (url) => url.pathname.startsWith("/api/") });
+ */
+/** Options for {@link installBackgroundSync}. */
+export declare interface InstallBackgroundSyncOptions {
+    /**
+     * Which requests to queue on failure. A `RegExp` against the URL or a
+     * predicate. Only non-`GET` requests are ever considered. Default: all
+     * non-`GET` requests.
+     */
+    match?: RegExp | ((url: URL, request: Request) => boolean);
+    /** IndexedDB database name, also used as the sync tag. Default `tempest-bg-sync`. */
+    queueName?: string;
+    /** Drop queued requests older than this (minutes) on replay. Default `1440` (24h). */
+    maxRetentionMinutes?: number;
+}
+
 /**
  * Install a `notificationclick` handler that focuses an existing client when
  * possible and falls back to opening a new window.
@@ -9,6 +56,32 @@ export declare interface InstallNotificationClickHandlerOptions {
     resolveUrl?: (data: unknown) => string;
 }
 
+/**
+ * Precache the app shell at `install` and serve it offline:
+ *  - reads `precache-manifest.json` (emitted by `tempestPwaManifest()`),
+ *  - caches every listed URL under a versioned cache,
+ *  - on `activate`, deletes stale precache versions and claims open clients,
+ *  - on `fetch`, serves precached assets cache-first and falls back to the
+ *    `navigateFallback` document for offline navigations (SPA routing).
+ *
+ * Same-origin only. Register this LAST, after any {@link installRuntimeCache}.
+ */
+export declare function installPrecache(options?: InstallPrecacheOptions): void;
+
+/** Options for {@link installPrecache}. */
+export declare interface InstallPrecacheOptions {
+    /** URL of the manifest emitted by `tempestPwaManifest()`. Default `/precache-manifest.json`. */
+    manifestUrl?: string;
+    /** Cache name prefix; the manifest `version` is appended. Default `tempest-precache`. */
+    cacheName?: string;
+    /** App-shell document served for navigation requests offline. Default `/index.html`. */
+    navigateFallback?: string;
+    /** Navigation paths that should NOT use the fallback (e.g. `[/^\/api\//]`). */
+    navigateFallbackDenylist?: RegExp[];
+    /** Activate the new worker immediately after precaching. Default `true`. */
+    skipWaiting?: boolean;
+}
+
 /**
  * Install a `push` event listener that parses the payload as JSON (with a
  * plain-text fallback) and shows a notification.
@@ -29,6 +102,18 @@ export declare interface InstallPushHandlerOptions {
     transform?: (payload: PushPayload) => PushPayload | null;
 }
 
+/**
+ * Install a `fetch` handler that resolves matching `GET` requests with the
+ * given runtime strategies. Non-matching requests are left untouched (no
+ * `respondWith`), so a later {@link installPrecache} can handle them.
+ *
+ * Register this BEFORE `installPrecache` so specific routes win over the
+ * precache catch-all.
+ *
+ * @param routes Ordered rules; the first whose `match` passes handles the request.
+ */
+export declare function installRuntimeCache(routes: RuntimeRoute[]): void;
+
 /**
  * Install a `message` listener that activates a waiting worker when the host
  * app sends `{ type: "SKIP_WAITING" }`.
@@ -87,6 +172,51 @@ export declare interface RegisterServiceWorkerOptions {
     onError?: (error: unknown) => void;
 }
 
+/** A single runtime-caching rule, matched against each `GET` request. */
+export declare interface RuntimeRoute {
+    /** A `RegExp` tested against the full URL, or a predicate over the parsed URL. */
+    match: RegExp | ((url: URL, request: Request) => boolean);
+    /** How to resolve a match. */
+    strategy: RuntimeStrategy;
+    /** Cache bucket name for this route. */
+    cacheName: string;
+    /** Trim the cache to at most this many entries (FIFO) after each write. */
+    maxEntries?: number;
+    /** Treat a cached response older than this (seconds) as a miss. */
+    maxAgeSeconds?: number;
+    /** For `network-first`: fall back to cache after this timeout (seconds). */
+    networkTimeoutSeconds?: number;
+    /**
+     * Serve HTTP `Range` requests (206 Partial Content) by slicing the cached
+     * full response. Enable for audio/video so seeking works offline. The full
+     * resource is cached once (the `Range` header is stripped before caching).
+     */
+    rangeRequests?: boolean;
+}
+
+/**
+ * Service-worker caching helpers — a small, dependency-free subset of what
+ * Workbox provides: precaching of the build's app shell (so the app launches
+ * offline) plus runtime caching strategies for fonts, APIs and images.
+ *
+ * Import these inside your own `sw.ts`. They run in the service-worker global
+ * scope, not the main thread. Pair `installPrecache` with the
+ * `tempestPwaManifest()` Vite plugin (from `tempest-react-sdk/vite`), which
+ * emits the `precache-manifest.json` this reads at install time.
+ *
+ * @example
+ *   /// <reference lib="webworker" />
+ *   import { installRuntimeCache, installPrecache } from "tempest-react-sdk/sw";
+ *
+ *   // Register specific routes FIRST so they win over the precache catch-all.
+ *   installRuntimeCache([
+ *     { match: /\/api\//, strategy: "network-first", cacheName: "api", maxAgeSeconds: 300 },
+ *   ]);
+ *   installPrecache();
+ */
+/** Caching strategy for a runtime route. Mirrors the common Workbox trio. */
+export declare type RuntimeStrategy = "cache-first" | "network-first" | "stale-while-revalidate";
+
 /**
  * Tell a waiting worker to activate immediately. Pair with `onUpdate` to roll
  * out updates after the user confirms a reload prompt.