tempest-react-sdk 0.7.0 → 0.8.0

package/bin/tempest.mjs

@@ -0,0 +1,282 @@
+#!/usr/bin/env node
+// tempest — project CLI shipped inside tempest-react-sdk.
+//
+//   tempest doctor          health-check the current project (à la flutter doctor)
+//   tempest lint [paths…]    run ESLint (report only)
+//   tempest fix [paths…]     ESLint --fix (sort imports, drop unused, tidy whitespace) + Prettier
+//   tempest format [paths…]  Prettier --write
+//   tempest --help | --version
+import { spawnSync } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const ROOT = process.cwd();
+const SELF_DIR = resolve(fileURLToPath(import.meta.url), "..");
+
+const c = {
+    reset: "\x1b[0m",
+    bold: "\x1b[1m",
+    dim: "\x1b[2m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    red: "\x1b[31m",
+    cyan: "\x1b[36m",
+};
+
+function selfVersion() {
+    try {
+        return (
+            JSON.parse(readFileSync(join(SELF_DIR, "..", "package.json"), "utf8")).version ?? "?"
+        );
+    } catch {
+        return "?";
+    }
+}
+
+/** Resolve a project-local CLI binary (e.g. eslint, prettier). */
+function localBin(name) {
+    const p = join(ROOT, "node_modules", ".bin", name);
+    return existsSync(p) ? p : null;
+}
+
+function run(bin, args) {
+    const res = spawnSync(bin, args, { stdio: "inherit", cwd: ROOT });
+    return res.status ?? 1;
+}
+
+function readJSON(path) {
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    } catch {
+        return null;
+    }
+}
+
+// ---------------------------------------------------------------- doctor ----
+
+function fmt(status, label, detail) {
+    const mark =
+        status === "ok"
+            ? `${c.green}✓${c.reset}`
+            : status === "warn"
+              ? `${c.yellow}!${c.reset}`
+              : `${c.red}✗${c.reset}`;
+    const tail = detail ? ` ${c.dim}— ${detail}${c.reset}` : "";
+    return `  [${mark}] ${label}${tail}`;
+}
+
+function fileIncludes(path, needle) {
+    try {
+        return readFileSync(path, "utf8").includes(needle);
+    } catch {
+        return false;
+    }
+}
+
+function firstExisting(paths) {
+    return paths.find((p) => existsSync(join(ROOT, p))) ?? null;
+}
+
+function doctor() {
+    const checks = [];
+    const pkg = readJSON(join(ROOT, "package.json"));
+
+    // Node
+    const [maj, min] = process.versions.node.split(".").map(Number);
+    const nodeOk = maj > 20 || (maj === 20 && min >= 19);
+    checks.push([
+        nodeOk ? "ok" : "fail",
+        `Node ${process.versions.node}`,
+        nodeOk ? "" : "requires >= 20.19",
+    ]);
+
+    // package.json
+    if (!pkg) {
+        checks.push(["fail", "package.json", "not found — run inside your project root"]);
+        return report(checks);
+    }
+    checks.push(["ok", "package.json found"]);
+
+    // SDK dependency + installed
+    const deps = { ...(pkg.dependencies ?? {}), ...(pkg.devDependencies ?? {}) };
+    checks.push(
+        deps["tempest-react-sdk"]
+            ? ["ok", "tempest-react-sdk in dependencies", deps["tempest-react-sdk"]]
+            : [
+                  "fail",
+                  "tempest-react-sdk in dependencies",
+                  "add it: npm install tempest-react-sdk",
+              ],
+    );
+    checks.push(
+        existsSync(join(ROOT, "node_modules", "tempest-react-sdk"))
+            ? ["ok", "tempest-react-sdk installed"]
+            : ["fail", "tempest-react-sdk installed", "run npm install"],
+    );
+
+    // React peers
+    const hasReact = deps.react && deps["react-dom"];
+    checks.push(
+        hasReact
+            ? ["ok", "react + react-dom present"]
+            : ["fail", "react + react-dom present", "install react react-dom"],
+    );
+
+    // Vite config + createViteConfig
+    const viteCfg = firstExisting(["vite.config.ts", "vite.config.js", "vite.config.mjs"]);
+    if (!viteCfg) {
+        checks.push(["warn", "vite config", "no vite.config.* found"]);
+    } else {
+        checks.push(
+            fileIncludes(join(ROOT, viteCfg), "createViteConfig")
+                ? ["ok", `${viteCfg} uses createViteConfig`]
+                : ["warn", `${viteCfg}`, "not using createViteConfig from tempest-react-sdk/vite"],
+        );
+    }
+
+    // tsconfig @ alias
+    const tsc = readJSON(join(ROOT, "tsconfig.json"));
+    const paths = tsc?.compilerOptions?.paths ?? {};
+    checks.push(
+        paths["@/*"]
+            ? ["ok", 'tsconfig "@/*" alias']
+            : ["warn", 'tsconfig "@/*" alias', 'add "paths": { "@/*": ["./src/*"] }'],
+    );
+
+    // styles.css imported at entry
+    const entry = firstExisting(["src/main.tsx", "src/main.ts", "src/index.tsx", "src/index.ts"]);
+    if (entry) {
+        checks.push(
+            fileIncludes(join(ROOT, entry), "tempest-react-sdk/styles.css")
+                ? ["ok", `${entry} imports styles.css`]
+                : ["warn", `${entry}`, 'add import "tempest-react-sdk/styles.css"'],
+        );
+    } else {
+        checks.push(["warn", "app entry", "no src/main.tsx found"]);
+    }
+
+    // tooling
+    checks.push(
+        firstExisting(["eslint.config.js", "eslint.config.mjs", ".eslintrc.cjs", ".eslintrc.json"])
+            ? ["ok", "ESLint config present"]
+            : ["warn", "ESLint config", "no eslint config — `tempest fix` needs it"],
+    );
+    checks.push(
+        localBin("eslint")
+            ? ["ok", "eslint installed"]
+            : ["warn", "eslint installed", "npm i -D eslint"],
+    );
+    checks.push(
+        localBin("prettier")
+            ? ["ok", "prettier installed"]
+            : ["warn", "prettier installed", "npm i -D prettier"],
+    );
+
+    // .env
+    if (existsSync(join(ROOT, ".env"))) checks.push(["ok", ".env present"]);
+    else if (existsSync(join(ROOT, ".env.example")))
+        checks.push(["warn", ".env", "only .env.example — copy it: cp .env.example .env"]);
+
+    return report(checks);
+}
+
+function report(checks) {
+    console.log(`\n${c.bold}${c.cyan}tempest doctor${c.reset} ${c.dim}(${ROOT})${c.reset}\n`);
+    for (const [status, label, detail] of checks) console.log(fmt(status, label, detail));
+    const fails = checks.filter((x) => x[0] === "fail").length;
+    const warns = checks.filter((x) => x[0] === "warn").length;
+    console.log("");
+    if (fails)
+        console.log(
+            `${c.red}✗ ${fails} problem(s)${c.reset}${warns ? `, ${c.yellow}${warns} warning(s)${c.reset}` : ""}.`,
+        );
+    else if (warns)
+        console.log(`${c.yellow}! ${warns} warning(s)${c.reset} — usable, but worth fixing.`);
+    else console.log(`${c.green}✓ No issues found.${c.reset}`);
+    console.log("");
+    return fails ? 1 : 0;
+}
+
+// ------------------------------------------------------- lint / fix / fmt ----
+
+function requireBin(name) {
+    const bin = localBin(name);
+    if (!bin) {
+        console.error(
+            `${c.red}✗ ${name} not found in node_modules.${c.reset} Install it: ${c.bold}npm i -D ${name}${c.reset}`,
+        );
+        process.exit(1);
+    }
+    return bin;
+}
+
+function lint(paths) {
+    return run(requireBin("eslint"), paths.length ? paths : ["."]);
+}
+
+function fix(paths) {
+    const targets = paths.length ? paths : ["."];
+    console.log(`${c.dim}→ eslint --fix (sort imports · drop unused · tidy whitespace)${c.reset}`);
+    const eslintStatus = run(requireBin("eslint"), [...targets, "--fix"]);
+    const prettier = localBin("prettier");
+    let prettierStatus = 0;
+    if (prettier) {
+        console.log(`${c.dim}→ prettier --write${c.reset}`);
+        prettierStatus = run(prettier, ["--write", ...targets]);
+    } else {
+        console.log(`${c.yellow}! prettier not installed — skipping format pass${c.reset}`);
+    }
+    return eslintStatus || prettierStatus;
+}
+
+function format(paths) {
+    return run(requireBin("prettier"), ["--write", ...(paths.length ? paths : ["."])]);
+}
+
+// ------------------------------------------------------------------ main ----
+
+function usage() {
+    console.log(`
+${c.bold}${c.cyan}tempest${c.reset} ${c.dim}v${selfVersion()}${c.reset} — project CLI for tempest-react-sdk apps
+
+${c.bold}Usage${c.reset}
+  tempest <command> [paths…]
+
+${c.bold}Commands${c.reset}
+  ${c.bold}doctor${c.reset}            Health-check the current project
+  ${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}Options${c.reset}
+  -h, --help        Show this help
+  -v, --version     Show version
+`);
+}
+
+const [cmd, ...rest] = process.argv.slice(2);
+
+if (cmd === "-v" || cmd === "--version") {
+    console.log(selfVersion());
+    process.exit(0);
+}
+if (!cmd || cmd === "-h" || cmd === "--help" || cmd === "help") {
+    usage();
+    process.exit(0);
+}
+
+const commands = {
+    doctor: () => doctor(),
+    lint: () => lint(rest),
+    fix: () => fix(rest),
+    format: () => format(rest),
+};
+
+if (!commands[cmd]) {
+    console.error(`${c.red}✗ Unknown command: ${cmd}${c.reset}`);
+    usage();
+    process.exit(1);
+}
+
+process.exit(commands[cmd]());

package/dist/sw.cjs

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

package/dist/sw.cjs.map

@@ -0,0 +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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"}

package/dist/sw.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Install a `notificationclick` handler that focuses an existing client when
+ * possible and falls back to opening a new window.
+ */
+export declare function installNotificationClickHandler(options?: InstallNotificationClickHandlerOptions): void;
+
+export declare interface InstallNotificationClickHandlerOptions {
+    /** Resolve the destination URL from the notification data. Default: `data.url`. */
+    resolveUrl?: (data: unknown) => string;
+}
+
+/**
+ * Install a `push` event listener that parses the payload as JSON (with a
+ * plain-text fallback) and shows a notification.
+ */
+export declare function installPushHandler(options?: InstallPushHandlerOptions): void;
+
+export declare interface InstallPushHandlerOptions {
+    /** Title used when the payload omits one. */
+    defaultTitle?: string;
+    /** Icon used when the payload omits one. */
+    defaultIcon?: string;
+    /** Badge image (mobile). */
+    defaultBadge?: string;
+    /**
+     * Transform the raw payload before showing the notification. Return `null`
+     * to suppress the notification entirely (e.g. silent pings).
+     */
+    transform?: (payload: PushPayload) => PushPayload | null;
+}
+
+/**
+ * Install a `message` listener that activates a waiting worker when the host
+ * app sends `{ type: "SKIP_WAITING" }`.
+ */
+export declare function installSkipWaitingListener(): void;
+
+/**
+ * Service-worker context helpers for handling `push` and `notificationclick`
+ * events. Import these inside your own `sw.ts` — they expect to run in the
+ * service-worker global scope, not in the main thread.
+ *
+ * @example
+ *   /// <reference lib="webworker" />
+ *   import { installPushHandler, installNotificationClickHandler } from "tempest-react-sdk";
+ *
+ *   installPushHandler({ defaultIcon: "/icons/Logo.png" });
+ *   installNotificationClickHandler();
+ */
+export declare interface PushPayload {
+    title?: string;
+    body?: string;
+    icon?: string;
+    badge?: string;
+    image?: string;
+    tag?: string;
+    url?: string;
+    /** Arbitrary extra data forwarded to `event.notification.data`. */
+    data?: Record<string, unknown>;
+}
+
+/**
+ * Register a service worker with consistent update-detection wiring.
+ *
+ * Skips silently when the runtime has no `serviceWorker` support. The host
+ * app keeps full control over the SW file — this helper only handles the
+ * boilerplate around `register()` and `updatefound`.
+ *
+ * @returns The registration when it succeeds, or `null` when unsupported.
+ */
+export declare function registerServiceWorker(options: RegisterServiceWorkerOptions): Promise<ServiceWorkerRegistration | null>;
+
+export declare interface RegisterServiceWorkerOptions {
+    /** Public URL of the compiled service worker file (e.g. `/sw.js`). */
+    url: string;
+    /** SW scope (default: SW directory). */
+    scope?: string;
+    /** Called once the registration is active. */
+    onReady?: (registration: ServiceWorkerRegistration) => void;
+    /**
+     * Called when a new worker has finished installing while another worker
+     * still controls the page. The host app typically prompts the user to
+     * reload and then calls {@link skipWaiting} on the returned worker.
+     */
+    onUpdate?: (waiting: ServiceWorker, registration: ServiceWorkerRegistration) => void;
+    /** Called on registration failure. */
+    onError?: (error: unknown) => void;
+}
+
+/**
+ * Tell a waiting worker to activate immediately. Pair with `onUpdate` to roll
+ * out updates after the user confirms a reload prompt.
+ */
+export declare function skipWaiting(worker: ServiceWorker): void;
+
+/**
+ * Unregister all registered service workers for this origin.
+ *
+ * @returns Number of workers that were unregistered.
+ */
+export declare function unregisterAllServiceWorkers(): Promise<number>;
+
+export { }

package/dist/sw.js

@@ -0,0 +1,95 @@
+async function d(n) {
+  if (typeof navigator > "u" || !("serviceWorker" in navigator))
+    return null;
+  try {
+    const t = await navigator.serviceWorker.register(n.url, {
+      scope: n.scope
+    });
+    return t.active && n.onReady?.(t), t.addEventListener("updatefound", () => {
+      const i = t.installing;
+      i && i.addEventListener("statechange", () => {
+        i.state === "installed" && navigator.serviceWorker.controller && n.onUpdate?.(i, t);
+      });
+    }), t;
+  } catch (t) {
+    return n.onError?.(t), null;
+  }
+}
+function g(n) {
+  n.postMessage({ type: "SKIP_WAITING" });
+}
+async function v() {
+  if (typeof navigator > "u" || !("serviceWorker" in navigator)) return 0;
+  const n = await navigator.serviceWorker.getRegistrations();
+  let t = 0;
+  for (const i of n)
+    await i.unregister() && (t += 1);
+  return t;
+}
+function l() {
+  return globalThis;
+}
+function y(n = {}) {
+  const t = l(), { defaultTitle: i = "Notificação", defaultIcon: e, defaultBadge: o, transform: s } = n;
+  t.addEventListener("push", (a) => {
+    if (!a.data) return;
+    let c;
+    try {
+      c = a.data.json();
+    } catch {
+      c = { title: i, body: a.data.text() };
+    }
+    const r = s ? s(c) : c;
+    if (!r) return;
+    const u = r.title ?? i, 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(n = {}) {
+  const t = l(), i = n.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 = i(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 w() {
+  const n = l();
+  n.addEventListener("message", (t) => {
+    t.data?.type === "SKIP_WAITING" && n.skipWaiting();
+  });
+}
+export {
+  p as installNotificationClickHandler,
+  y as installPushHandler,
+  w as installSkipWaitingListener,
+  d as registerServiceWorker,
+  g as skipWaiting,
+  v as unregisterAllServiceWorkers
+};
+//# sourceMappingURL=sw.js.map

package/dist/sw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sw.js","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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"}