@broberg/pwa 0.1.0

package/README.md

@@ -0,0 +1,116 @@
+# @broberg/pwa
+
+The fleet's **PWA primitive**. Today it ships the piece four repos hand-rolled
+independently — the *"a new version is available, tap to reload"* lifecycle —
+as one small, framework- and bundler-agnostic package instead of a fifth copy.
+
+```bash
+npm i @broberg/pwa
+```
+
+- **`@broberg/pwa`** — `createPwaUpdater()`, a zero-dependency controller for the
+  service-worker update lifecycle (works with Serwist, Workbox or a hand-rolled SW).
+- **`@broberg/pwa/react`** — `usePwaUpdate()` hook + an **unstyled** `<PwaUpdateBanner>`
+  skeleton (you style it with your own tokens).
+- **`@broberg/pwa/sw`** — `listenForSkipWaiting()`, the service-worker side of the handshake.
+
+> Web **push** notifications are a separate concern — use
+> [`@broberg/webpush`](https://discovery.broberg.ai). This package never touches push.
+
+## The update lifecycle
+
+A service worker that finds a new version installs it and then **waits** so it
+doesn't yank the page out from under the user. `@broberg/pwa` detects that
+waiting worker, lets the user choose when to take it, then reloads once it's active:
+
+```
+new deploy → SW installs → SW waiting → banner → user taps Update
+  → applyUpdate() posts SKIP_WAITING → SW skipWaiting() → controllerchange → reload
+```
+
+## React usage
+
+```tsx
+"use client";
+import { usePwaUpdate, PwaUpdateBanner } from "@broberg/pwa/react";
+
+export function PwaUpdater() {
+  // Guards are YOUR policy — pass `disabled` for native shells / dev.
+  const isNative = document.documentElement.classList.contains("native");
+  const { updateReady, applyUpdate } = usePwaUpdate({
+    disabled: isNative || process.env.NODE_ENV !== "production",
+  });
+
+  return (
+    <PwaUpdateBanner
+      updateReady={updateReady}
+      onUpdate={applyUpdate}
+      onDismiss={() => {/* hide for this session; it returns on next load */}}
+      className="my-banner"                       // ← you own the styling
+      labels={{ title: "Ny version klar", update: "Opdatér", dismiss: "Senere" }}
+    />
+  );
+}
+```
+
+Prefer to build your own UI? Use the hook alone — `usePwaUpdate()` gives you
+`{ updateReady, applyUpdate }` and nothing else. The banner is only a convenience
+skeleton: it renders `role="status"` + `aria-live="polite"`, carries the stable
+testids `pwa-update-confirm` / `pwa-update-dismiss` / `pwa-update-close`, and
+ships **no** colours or design-system classes.
+
+## Framework-agnostic core
+
+No React? Drive the controller directly (Preact, Svelte, vanilla):
+
+```ts
+import { createPwaUpdater } from "@broberg/pwa";
+
+const updater = createPwaUpdater({ swUrl: "/sw.js", disabled: isNative });
+updater.subscribe(({ updateReady }) => renderBanner(updateReady));
+// on the user's "Update" click:
+updater.applyUpdate();
+// later: updater.destroy();
+```
+
+### `createPwaUpdater(options)`
+
+| option | default | meaning |
+|---|---|---|
+| `swUrl` | `/sw.js` | service-worker script to register |
+| `pollIntervalMs` | `3_600_000` | how often to check for a new SW; `0` disables |
+| `reloadOnControllerChange` | `true` | reload the page once the new SW takes control |
+| `disabled` | `false` | inert no-op — pass your own guard (native shell, dev) |
+
+Returns `{ subscribe, getState, applyUpdate, destroy }`. With no service-worker
+support (or `disabled`), it's an inert no-op that never throws.
+
+## Service-worker side
+
+Answer the client's activation request in your service worker:
+
+```ts
+// sw.ts
+import { listenForSkipWaiting } from "@broberg/pwa/sw";
+listenForSkipWaiting(); // defaults to the worker's own global scope
+```
+
+With **Serwist**/**Workbox**, keep activation user-gated:
+
+```ts
+new Serwist({ /* … */, skipWaiting: false, clientsClaim: true });
+```
+
+## Gotchas (baked into this package so you don't rediscover them)
+
+- **First install is suppressed.** A worker reaching `installed` with no existing
+  controller is the *first* install — there's nothing to update, so no banner.
+- **No reload-loop.** `controllerchange` reloads exactly once.
+- **Serwist + Next.js needs the webpack builder** — `next build` with **Turbopack**
+  breaks the serwist SW build. Use `next build` (webpack).
+- **Guards belong to you.** This package doesn't sniff `NODE_ENV` or a `.native`
+  class — pass `disabled` so the policy lives in one place in your app.
+
+## License
+
+MIT · part of the [`@broberg/*`](https://discovery.broberg.ai) shared inventory.

package/dist/chunk-ERNF6MZL.js

@@ -0,0 +1,7 @@
+// src/message.ts
+var SKIP_WAITING = "SKIP_WAITING";
+var SKIP_WAITING_MESSAGE = { type: SKIP_WAITING };
+
+export { SKIP_WAITING, SKIP_WAITING_MESSAGE };
+//# sourceMappingURL=chunk-ERNF6MZL.js.map
+//# sourceMappingURL=chunk-ERNF6MZL.js.map

package/dist/chunk-ERNF6MZL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/message.ts"],"names":[],"mappings":";AAKO,IAAM,YAAA,GAAe;AAErB,IAAM,oBAAA,GAAuB,EAAE,IAAA,EAAM,YAAA","file":"chunk-ERNF6MZL.js","sourcesContent":["/**\n * The single source of the client↔service-worker \"activate the waiting worker\"\n * message. Both the client controller (`applyUpdate`) and the SW helper\n * (`listenForSkipWaiting`) import it so the contract can never drift.\n */\nexport const SKIP_WAITING = \"SKIP_WAITING\" as const;\n\nexport const SKIP_WAITING_MESSAGE = { type: SKIP_WAITING } as const;\n\nexport type SkipWaitingMessage = typeof SKIP_WAITING_MESSAGE;\n"]}

package/dist/index.cjs

@@ -0,0 +1,126 @@
+'use strict';
+
+// src/message.ts
+var SKIP_WAITING = "SKIP_WAITING";
+var SKIP_WAITING_MESSAGE = { type: SKIP_WAITING };
+
+// src/index.ts
+var DEFAULT_POLL_MS = 60 * 60 * 1e3;
+function createPwaUpdater(options = {}) {
+  const {
+    swUrl = "/sw.js",
+    register = true,
+    pollIntervalMs = DEFAULT_POLL_MS,
+    updateOnFocus = true,
+    reloadOnControllerChange = true,
+    disabled = false
+  } = options;
+  const listeners = /* @__PURE__ */ new Set();
+  let updateReady = false;
+  let waitingWorker = null;
+  const getState = () => ({ updateReady });
+  const emit = () => {
+    const state = getState();
+    for (const listener of listeners) listener(state);
+  };
+  const subscribe = (listener) => {
+    listeners.add(listener);
+    return () => listeners.delete(listener);
+  };
+  const supported = typeof navigator !== "undefined" && "serviceWorker" in navigator;
+  if (disabled || !supported) {
+    return {
+      subscribe,
+      getState,
+      applyUpdate() {
+      },
+      destroy() {
+        listeners.clear();
+      }
+    };
+  }
+  const container = navigator.serviceWorker;
+  let pollId = null;
+  let removeFocusListeners = null;
+  let reloading = false;
+  let destroyed = false;
+  const markReady = (worker) => {
+    waitingWorker = worker;
+    if (!updateReady) {
+      updateReady = true;
+      emit();
+    }
+  };
+  const onControllerChange = () => {
+    if (!reloadOnControllerChange || reloading) return;
+    reloading = true;
+    if (typeof location !== "undefined") location.reload();
+  };
+  container.addEventListener("controllerchange", onControllerChange);
+  const watchInstalling = (registration) => {
+    const installing = registration.installing;
+    if (!installing) return;
+    installing.addEventListener("statechange", () => {
+      if (installing.state === "installed" && container.controller) {
+        markReady(installing);
+      }
+    });
+  };
+  const wireFocusChecks = (registration) => {
+    if (!updateOnFocus) return;
+    const check = () => {
+      registration.update().catch(() => {
+      });
+    };
+    const onFocus = () => check();
+    const onVisibility = () => {
+      if (typeof document !== "undefined" && document.visibilityState === "visible") {
+        check();
+      }
+    };
+    if (typeof window !== "undefined") window.addEventListener("focus", onFocus);
+    if (typeof document !== "undefined") {
+      document.addEventListener("visibilitychange", onVisibility);
+    }
+    removeFocusListeners = () => {
+      if (typeof window !== "undefined") window.removeEventListener("focus", onFocus);
+      if (typeof document !== "undefined") {
+        document.removeEventListener("visibilitychange", onVisibility);
+      }
+    };
+  };
+  const registrationPromise = register ? container.register(swUrl) : container.ready;
+  registrationPromise.then((registration) => {
+    if (destroyed) return;
+    if (registration.waiting) markReady(registration.waiting);
+    registration.addEventListener("updatefound", () => watchInstalling(registration));
+    if (pollIntervalMs > 0) {
+      pollId = setInterval(() => {
+        registration.update().catch(() => {
+        });
+      }, pollIntervalMs);
+    }
+    wireFocusChecks(registration);
+  }).catch(() => {
+  });
+  return {
+    subscribe,
+    getState,
+    applyUpdate() {
+      if (waitingWorker) waitingWorker.postMessage(SKIP_WAITING_MESSAGE);
+    },
+    destroy() {
+      destroyed = true;
+      if (pollId !== null) clearInterval(pollId);
+      removeFocusListeners?.();
+      container.removeEventListener("controllerchange", onControllerChange);
+      listeners.clear();
+    }
+  };
+}
+
+exports.SKIP_WAITING = SKIP_WAITING;
+exports.SKIP_WAITING_MESSAGE = SKIP_WAITING_MESSAGE;
+exports.createPwaUpdater = createPwaUpdater;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/message.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * The single source of the client↔service-worker \"activate the waiting worker\"\n * message. Both the client controller (`applyUpdate`) and the SW helper\n * (`listenForSkipWaiting`) import it so the contract can never drift.\n */\nexport const SKIP_WAITING = \"SKIP_WAITING\" as const;\n\nexport const SKIP_WAITING_MESSAGE = { type: SKIP_WAITING } as const;\n\nexport type SkipWaitingMessage = typeof SKIP_WAITING_MESSAGE;\n","import { SKIP_WAITING_MESSAGE } from \"./message.js\";\n\nexport { SKIP_WAITING, SKIP_WAITING_MESSAGE } from \"./message.js\";\nexport type { SkipWaitingMessage } from \"./message.js\";\n\nexport interface PwaUpdaterOptions {\n  /** Service-worker script URL to register. Default `/sw.js`. */\n  swUrl?: string;\n  /**\n   * Register `swUrl` ourselves (manual `sw.js` style). Set `false` when the\n   * app already registers the SW (e.g. Serwist's `registerSW` / `@serwist/next`)\n   * — the updater then attaches to the existing registration via\n   * `navigator.serviceWorker.ready` instead of registering again. Default `true`.\n   */\n  register?: boolean;\n  /** How often to poll `registration.update()` (ms). `0` disables. Default 60 min. */\n  pollIntervalMs?: number;\n  /**\n   * Also check for an update when the tab regains focus / becomes visible.\n   * A constantly-focused tab never fires `visibilitychange`, so `focus` is the\n   * one that catches \"user came back to the app\". Default `true`.\n   */\n  updateOnFocus?: boolean;\n  /** Reload the page once the new worker takes control. Default `true`. */\n  reloadOnControllerChange?: boolean;\n  /**\n   * Consumer guard. When `true` the updater is an inert no-op (registers\n   * nothing). Pass your own policy, e.g. `disabled: isNativeCapacitor || isDev`\n   * — the package never hardcodes an environment or a `.native` check.\n   */\n  disabled?: boolean;\n}\n\nexport interface PwaUpdaterState {\n  /** A new service worker is installed and waiting to activate. */\n  updateReady: boolean;\n}\n\nexport interface PwaUpdater {\n  /** Subscribe to state changes. Returns an unsubscribe fn. */\n  subscribe(listener: (state: PwaUpdaterState) => void): () => void;\n  getState(): PwaUpdaterState;\n  /** Tell the waiting worker to activate (posts SKIP_WAITING). No-op if none waits. */\n  applyUpdate(): void;\n  /** Stop polling + remove all listeners. */\n  destroy(): void;\n}\n\nconst DEFAULT_POLL_MS = 60 * 60 * 1000;\n\n/**\n * Framework- and bundler-agnostic controller for the PWA \"new version\n * available\" lifecycle: register (or attach) → detect a waiting worker\n * (suppressing the first install) → let the consumer activate it → reload on\n * takeover, re-checking on interval + focus/visibility.\n *\n * Distilled from the pattern hand-rolled across the fleet (fds, cardmem,\n * pitch-vault). Works with any service worker (Serwist, Workbox, hand-rolled)\n * as long as the SW answers a `SKIP_WAITING` message — see `@broberg/pwa/sw`.\n */\nexport function createPwaUpdater(options: PwaUpdaterOptions = {}): PwaUpdater {\n  const {\n    swUrl = \"/sw.js\",\n    register = true,\n    pollIntervalMs = DEFAULT_POLL_MS,\n    updateOnFocus = true,\n    reloadOnControllerChange = true,\n    disabled = false,\n  } = options;\n\n  const listeners = new Set<(state: PwaUpdaterState) => void>();\n  let updateReady = false;\n  let waitingWorker: ServiceWorker | null = null;\n\n  const getState = (): PwaUpdaterState => ({ updateReady });\n  const emit = (): void => {\n    const state = getState();\n    for (const listener of listeners) listener(state);\n  };\n  const subscribe = (listener: (state: PwaUpdaterState) => void): (() => void) => {\n    listeners.add(listener);\n    return () => listeners.delete(listener);\n  };\n\n  const supported =\n    typeof navigator !== \"undefined\" && \"serviceWorker\" in navigator;\n\n  // Inert no-op: disabled by the consumer, or no service-worker support at all.\n  if (disabled || !supported) {\n    return {\n      subscribe,\n      getState,\n      applyUpdate() {},\n      destroy() {\n        listeners.clear();\n      },\n    };\n  }\n\n  const container = navigator.serviceWorker;\n  let pollId: ReturnType<typeof setInterval> | null = null;\n  let removeFocusListeners: (() => void) | null = null;\n  let reloading = false;\n  let destroyed = false;\n\n  const markReady = (worker: ServiceWorker): void => {\n    waitingWorker = worker;\n    if (!updateReady) {\n      updateReady = true;\n      emit();\n    }\n  };\n\n  const onControllerChange = (): void => {\n    if (!reloadOnControllerChange || reloading) return;\n    reloading = true; // guard against a reload-loop\n    if (typeof location !== \"undefined\") location.reload();\n  };\n  container.addEventListener(\"controllerchange\", onControllerChange);\n\n  const watchInstalling = (registration: ServiceWorkerRegistration): void => {\n    const installing = registration.installing;\n    if (!installing) return;\n    installing.addEventListener(\"statechange\", () => {\n      // A new worker reaching `installed` WHILE a controller already exists is\n      // an update. Reaching `installed` with no controller is the FIRST install\n      // — nothing to update, so we stay quiet.\n      if (installing.state === \"installed\" && container.controller) {\n        markReady(installing);\n      }\n    });\n  };\n\n  const wireFocusChecks = (registration: ServiceWorkerRegistration): void => {\n    if (!updateOnFocus) return;\n    const check = (): void => {\n      registration.update().catch(() => {});\n    };\n    const onFocus = (): void => check();\n    const onVisibility = (): void => {\n      if (typeof document !== \"undefined\" && document.visibilityState === \"visible\") {\n        check();\n      }\n    };\n    if (typeof window !== \"undefined\") window.addEventListener(\"focus\", onFocus);\n    if (typeof document !== \"undefined\") {\n      document.addEventListener(\"visibilitychange\", onVisibility);\n    }\n    removeFocusListeners = () => {\n      if (typeof window !== \"undefined\") window.removeEventListener(\"focus\", onFocus);\n      if (typeof document !== \"undefined\") {\n        document.removeEventListener(\"visibilitychange\", onVisibility);\n      }\n    };\n  };\n\n  // Manual style registers swUrl; serwist/registerSW style attaches to the\n  // registration the app already made via `.ready`.\n  const registrationPromise = register ? container.register(swUrl) : container.ready;\n\n  registrationPromise\n    .then((registration) => {\n      if (destroyed) return;\n      if (registration.waiting) markReady(registration.waiting);\n      registration.addEventListener(\"updatefound\", () => watchInstalling(registration));\n      if (pollIntervalMs > 0) {\n        pollId = setInterval(() => {\n          registration.update().catch(() => {\n            // ignore transient update-check network errors\n          });\n        }, pollIntervalMs);\n      }\n      wireFocusChecks(registration);\n    })\n    .catch(() => {\n      // registration failed — stay inert rather than throw into the app\n    });\n\n  return {\n    subscribe,\n    getState,\n    applyUpdate() {\n      if (waitingWorker) waitingWorker.postMessage(SKIP_WAITING_MESSAGE);\n    },\n    destroy() {\n      destroyed = true;\n      if (pollId !== null) clearInterval(pollId);\n      removeFocusListeners?.();\n      container.removeEventListener(\"controllerchange\", onControllerChange);\n      listeners.clear();\n    },\n  };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,55 @@
+export { S as SKIP_WAITING, a as SKIP_WAITING_MESSAGE, b as SkipWaitingMessage } from './message-CBBmtYuB.cjs';
+
+interface PwaUpdaterOptions {
+    /** Service-worker script URL to register. Default `/sw.js`. */
+    swUrl?: string;
+    /**
+     * Register `swUrl` ourselves (manual `sw.js` style). Set `false` when the
+     * app already registers the SW (e.g. Serwist's `registerSW` / `@serwist/next`)
+     * — the updater then attaches to the existing registration via
+     * `navigator.serviceWorker.ready` instead of registering again. Default `true`.
+     */
+    register?: boolean;
+    /** How often to poll `registration.update()` (ms). `0` disables. Default 60 min. */
+    pollIntervalMs?: number;
+    /**
+     * Also check for an update when the tab regains focus / becomes visible.
+     * A constantly-focused tab never fires `visibilitychange`, so `focus` is the
+     * one that catches "user came back to the app". Default `true`.
+     */
+    updateOnFocus?: boolean;
+    /** Reload the page once the new worker takes control. Default `true`. */
+    reloadOnControllerChange?: boolean;
+    /**
+     * Consumer guard. When `true` the updater is an inert no-op (registers
+     * nothing). Pass your own policy, e.g. `disabled: isNativeCapacitor || isDev`
+     * — the package never hardcodes an environment or a `.native` check.
+     */
+    disabled?: boolean;
+}
+interface PwaUpdaterState {
+    /** A new service worker is installed and waiting to activate. */
+    updateReady: boolean;
+}
+interface PwaUpdater {
+    /** Subscribe to state changes. Returns an unsubscribe fn. */
+    subscribe(listener: (state: PwaUpdaterState) => void): () => void;
+    getState(): PwaUpdaterState;
+    /** Tell the waiting worker to activate (posts SKIP_WAITING). No-op if none waits. */
+    applyUpdate(): void;
+    /** Stop polling + remove all listeners. */
+    destroy(): void;
+}
+/**
+ * Framework- and bundler-agnostic controller for the PWA "new version
+ * available" lifecycle: register (or attach) → detect a waiting worker
+ * (suppressing the first install) → let the consumer activate it → reload on
+ * takeover, re-checking on interval + focus/visibility.
+ *
+ * Distilled from the pattern hand-rolled across the fleet (fds, cardmem,
+ * pitch-vault). Works with any service worker (Serwist, Workbox, hand-rolled)
+ * as long as the SW answers a `SKIP_WAITING` message — see `@broberg/pwa/sw`.
+ */
+declare function createPwaUpdater(options?: PwaUpdaterOptions): PwaUpdater;
+
+export { type PwaUpdater, type PwaUpdaterOptions, type PwaUpdaterState, createPwaUpdater };

package/dist/index.d.ts

@@ -0,0 +1,55 @@
+export { S as SKIP_WAITING, a as SKIP_WAITING_MESSAGE, b as SkipWaitingMessage } from './message-CBBmtYuB.js';
+
+interface PwaUpdaterOptions {
+    /** Service-worker script URL to register. Default `/sw.js`. */
+    swUrl?: string;
+    /**
+     * Register `swUrl` ourselves (manual `sw.js` style). Set `false` when the
+     * app already registers the SW (e.g. Serwist's `registerSW` / `@serwist/next`)
+     * — the updater then attaches to the existing registration via
+     * `navigator.serviceWorker.ready` instead of registering again. Default `true`.
+     */
+    register?: boolean;
+    /** How often to poll `registration.update()` (ms). `0` disables. Default 60 min. */
+    pollIntervalMs?: number;
+    /**
+     * Also check for an update when the tab regains focus / becomes visible.
+     * A constantly-focused tab never fires `visibilitychange`, so `focus` is the
+     * one that catches "user came back to the app". Default `true`.
+     */
+    updateOnFocus?: boolean;
+    /** Reload the page once the new worker takes control. Default `true`. */
+    reloadOnControllerChange?: boolean;
+    /**
+     * Consumer guard. When `true` the updater is an inert no-op (registers
+     * nothing). Pass your own policy, e.g. `disabled: isNativeCapacitor || isDev`
+     * — the package never hardcodes an environment or a `.native` check.
+     */
+    disabled?: boolean;
+}
+interface PwaUpdaterState {
+    /** A new service worker is installed and waiting to activate. */
+    updateReady: boolean;
+}
+interface PwaUpdater {
+    /** Subscribe to state changes. Returns an unsubscribe fn. */
+    subscribe(listener: (state: PwaUpdaterState) => void): () => void;
+    getState(): PwaUpdaterState;
+    /** Tell the waiting worker to activate (posts SKIP_WAITING). No-op if none waits. */
+    applyUpdate(): void;
+    /** Stop polling + remove all listeners. */
+    destroy(): void;
+}
+/**
+ * Framework- and bundler-agnostic controller for the PWA "new version
+ * available" lifecycle: register (or attach) → detect a waiting worker
+ * (suppressing the first install) → let the consumer activate it → reload on
+ * takeover, re-checking on interval + focus/visibility.
+ *
+ * Distilled from the pattern hand-rolled across the fleet (fds, cardmem,
+ * pitch-vault). Works with any service worker (Serwist, Workbox, hand-rolled)
+ * as long as the SW answers a `SKIP_WAITING` message — see `@broberg/pwa/sw`.
+ */
+declare function createPwaUpdater(options?: PwaUpdaterOptions): PwaUpdater;
+
+export { type PwaUpdater, type PwaUpdaterOptions, type PwaUpdaterState, createPwaUpdater };

package/dist/index.js

@@ -0,0 +1,121 @@
+import { SKIP_WAITING_MESSAGE } from './chunk-ERNF6MZL.js';
+export { SKIP_WAITING, SKIP_WAITING_MESSAGE } from './chunk-ERNF6MZL.js';
+
+// src/index.ts
+var DEFAULT_POLL_MS = 60 * 60 * 1e3;
+function createPwaUpdater(options = {}) {
+  const {
+    swUrl = "/sw.js",
+    register = true,
+    pollIntervalMs = DEFAULT_POLL_MS,
+    updateOnFocus = true,
+    reloadOnControllerChange = true,
+    disabled = false
+  } = options;
+  const listeners = /* @__PURE__ */ new Set();
+  let updateReady = false;
+  let waitingWorker = null;
+  const getState = () => ({ updateReady });
+  const emit = () => {
+    const state = getState();
+    for (const listener of listeners) listener(state);
+  };
+  const subscribe = (listener) => {
+    listeners.add(listener);
+    return () => listeners.delete(listener);
+  };
+  const supported = typeof navigator !== "undefined" && "serviceWorker" in navigator;
+  if (disabled || !supported) {
+    return {
+      subscribe,
+      getState,
+      applyUpdate() {
+      },
+      destroy() {
+        listeners.clear();
+      }
+    };
+  }
+  const container = navigator.serviceWorker;
+  let pollId = null;
+  let removeFocusListeners = null;
+  let reloading = false;
+  let destroyed = false;
+  const markReady = (worker) => {
+    waitingWorker = worker;
+    if (!updateReady) {
+      updateReady = true;
+      emit();
+    }
+  };
+  const onControllerChange = () => {
+    if (!reloadOnControllerChange || reloading) return;
+    reloading = true;
+    if (typeof location !== "undefined") location.reload();
+  };
+  container.addEventListener("controllerchange", onControllerChange);
+  const watchInstalling = (registration) => {
+    const installing = registration.installing;
+    if (!installing) return;
+    installing.addEventListener("statechange", () => {
+      if (installing.state === "installed" && container.controller) {
+        markReady(installing);
+      }
+    });
+  };
+  const wireFocusChecks = (registration) => {
+    if (!updateOnFocus) return;
+    const check = () => {
+      registration.update().catch(() => {
+      });
+    };
+    const onFocus = () => check();
+    const onVisibility = () => {
+      if (typeof document !== "undefined" && document.visibilityState === "visible") {
+        check();
+      }
+    };
+    if (typeof window !== "undefined") window.addEventListener("focus", onFocus);
+    if (typeof document !== "undefined") {
+      document.addEventListener("visibilitychange", onVisibility);
+    }
+    removeFocusListeners = () => {
+      if (typeof window !== "undefined") window.removeEventListener("focus", onFocus);
+      if (typeof document !== "undefined") {
+        document.removeEventListener("visibilitychange", onVisibility);
+      }
+    };
+  };
+  const registrationPromise = register ? container.register(swUrl) : container.ready;
+  registrationPromise.then((registration) => {
+    if (destroyed) return;
+    if (registration.waiting) markReady(registration.waiting);
+    registration.addEventListener("updatefound", () => watchInstalling(registration));
+    if (pollIntervalMs > 0) {
+      pollId = setInterval(() => {
+        registration.update().catch(() => {
+        });
+      }, pollIntervalMs);
+    }
+    wireFocusChecks(registration);
+  }).catch(() => {
+  });
+  return {
+    subscribe,
+    getState,
+    applyUpdate() {
+      if (waitingWorker) waitingWorker.postMessage(SKIP_WAITING_MESSAGE);
+    },
+    destroy() {
+      destroyed = true;
+      if (pollId !== null) clearInterval(pollId);
+      removeFocusListeners?.();
+      container.removeEventListener("controllerchange", onControllerChange);
+      listeners.clear();
+    }
+  };
+}
+
+export { createPwaUpdater };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { SKIP_WAITING_MESSAGE } from \"./message.js\";\n\nexport { SKIP_WAITING, SKIP_WAITING_MESSAGE } from \"./message.js\";\nexport type { SkipWaitingMessage } from \"./message.js\";\n\nexport interface PwaUpdaterOptions {\n  /** Service-worker script URL to register. Default `/sw.js`. */\n  swUrl?: string;\n  /**\n   * Register `swUrl` ourselves (manual `sw.js` style). Set `false` when the\n   * app already registers the SW (e.g. Serwist's `registerSW` / `@serwist/next`)\n   * — the updater then attaches to the existing registration via\n   * `navigator.serviceWorker.ready` instead of registering again. Default `true`.\n   */\n  register?: boolean;\n  /** How often to poll `registration.update()` (ms). `0` disables. Default 60 min. */\n  pollIntervalMs?: number;\n  /**\n   * Also check for an update when the tab regains focus / becomes visible.\n   * A constantly-focused tab never fires `visibilitychange`, so `focus` is the\n   * one that catches \"user came back to the app\". Default `true`.\n   */\n  updateOnFocus?: boolean;\n  /** Reload the page once the new worker takes control. Default `true`. */\n  reloadOnControllerChange?: boolean;\n  /**\n   * Consumer guard. When `true` the updater is an inert no-op (registers\n   * nothing). Pass your own policy, e.g. `disabled: isNativeCapacitor || isDev`\n   * — the package never hardcodes an environment or a `.native` check.\n   */\n  disabled?: boolean;\n}\n\nexport interface PwaUpdaterState {\n  /** A new service worker is installed and waiting to activate. */\n  updateReady: boolean;\n}\n\nexport interface PwaUpdater {\n  /** Subscribe to state changes. Returns an unsubscribe fn. */\n  subscribe(listener: (state: PwaUpdaterState) => void): () => void;\n  getState(): PwaUpdaterState;\n  /** Tell the waiting worker to activate (posts SKIP_WAITING). No-op if none waits. */\n  applyUpdate(): void;\n  /** Stop polling + remove all listeners. */\n  destroy(): void;\n}\n\nconst DEFAULT_POLL_MS = 60 * 60 * 1000;\n\n/**\n * Framework- and bundler-agnostic controller for the PWA \"new version\n * available\" lifecycle: register (or attach) → detect a waiting worker\n * (suppressing the first install) → let the consumer activate it → reload on\n * takeover, re-checking on interval + focus/visibility.\n *\n * Distilled from the pattern hand-rolled across the fleet (fds, cardmem,\n * pitch-vault). Works with any service worker (Serwist, Workbox, hand-rolled)\n * as long as the SW answers a `SKIP_WAITING` message — see `@broberg/pwa/sw`.\n */\nexport function createPwaUpdater(options: PwaUpdaterOptions = {}): PwaUpdater {\n  const {\n    swUrl = \"/sw.js\",\n    register = true,\n    pollIntervalMs = DEFAULT_POLL_MS,\n    updateOnFocus = true,\n    reloadOnControllerChange = true,\n    disabled = false,\n  } = options;\n\n  const listeners = new Set<(state: PwaUpdaterState) => void>();\n  let updateReady = false;\n  let waitingWorker: ServiceWorker | null = null;\n\n  const getState = (): PwaUpdaterState => ({ updateReady });\n  const emit = (): void => {\n    const state = getState();\n    for (const listener of listeners) listener(state);\n  };\n  const subscribe = (listener: (state: PwaUpdaterState) => void): (() => void) => {\n    listeners.add(listener);\n    return () => listeners.delete(listener);\n  };\n\n  const supported =\n    typeof navigator !== \"undefined\" && \"serviceWorker\" in navigator;\n\n  // Inert no-op: disabled by the consumer, or no service-worker support at all.\n  if (disabled || !supported) {\n    return {\n      subscribe,\n      getState,\n      applyUpdate() {},\n      destroy() {\n        listeners.clear();\n      },\n    };\n  }\n\n  const container = navigator.serviceWorker;\n  let pollId: ReturnType<typeof setInterval> | null = null;\n  let removeFocusListeners: (() => void) | null = null;\n  let reloading = false;\n  let destroyed = false;\n\n  const markReady = (worker: ServiceWorker): void => {\n    waitingWorker = worker;\n    if (!updateReady) {\n      updateReady = true;\n      emit();\n    }\n  };\n\n  const onControllerChange = (): void => {\n    if (!reloadOnControllerChange || reloading) return;\n    reloading = true; // guard against a reload-loop\n    if (typeof location !== \"undefined\") location.reload();\n  };\n  container.addEventListener(\"controllerchange\", onControllerChange);\n\n  const watchInstalling = (registration: ServiceWorkerRegistration): void => {\n    const installing = registration.installing;\n    if (!installing) return;\n    installing.addEventListener(\"statechange\", () => {\n      // A new worker reaching `installed` WHILE a controller already exists is\n      // an update. Reaching `installed` with no controller is the FIRST install\n      // — nothing to update, so we stay quiet.\n      if (installing.state === \"installed\" && container.controller) {\n        markReady(installing);\n      }\n    });\n  };\n\n  const wireFocusChecks = (registration: ServiceWorkerRegistration): void => {\n    if (!updateOnFocus) return;\n    const check = (): void => {\n      registration.update().catch(() => {});\n    };\n    const onFocus = (): void => check();\n    const onVisibility = (): void => {\n      if (typeof document !== \"undefined\" && document.visibilityState === \"visible\") {\n        check();\n      }\n    };\n    if (typeof window !== \"undefined\") window.addEventListener(\"focus\", onFocus);\n    if (typeof document !== \"undefined\") {\n      document.addEventListener(\"visibilitychange\", onVisibility);\n    }\n    removeFocusListeners = () => {\n      if (typeof window !== \"undefined\") window.removeEventListener(\"focus\", onFocus);\n      if (typeof document !== \"undefined\") {\n        document.removeEventListener(\"visibilitychange\", onVisibility);\n      }\n    };\n  };\n\n  // Manual style registers swUrl; serwist/registerSW style attaches to the\n  // registration the app already made via `.ready`.\n  const registrationPromise = register ? container.register(swUrl) : container.ready;\n\n  registrationPromise\n    .then((registration) => {\n      if (destroyed) return;\n      if (registration.waiting) markReady(registration.waiting);\n      registration.addEventListener(\"updatefound\", () => watchInstalling(registration));\n      if (pollIntervalMs > 0) {\n        pollId = setInterval(() => {\n          registration.update().catch(() => {\n            // ignore transient update-check network errors\n          });\n        }, pollIntervalMs);\n      }\n      wireFocusChecks(registration);\n    })\n    .catch(() => {\n      // registration failed — stay inert rather than throw into the app\n    });\n\n  return {\n    subscribe,\n    getState,\n    applyUpdate() {\n      if (waitingWorker) waitingWorker.postMessage(SKIP_WAITING_MESSAGE);\n    },\n    destroy() {\n      destroyed = true;\n      if (pollId !== null) clearInterval(pollId);\n      removeFocusListeners?.();\n      container.removeEventListener(\"controllerchange\", onControllerChange);\n      listeners.clear();\n    },\n  };\n}\n"]}

package/dist/message-CBBmtYuB.d.cts

@@ -0,0 +1,12 @@
+/**
+ * The single source of the client↔service-worker "activate the waiting worker"
+ * message. Both the client controller (`applyUpdate`) and the SW helper
+ * (`listenForSkipWaiting`) import it so the contract can never drift.
+ */
+declare const SKIP_WAITING: "SKIP_WAITING";
+declare const SKIP_WAITING_MESSAGE: {
+    readonly type: "SKIP_WAITING";
+};
+type SkipWaitingMessage = typeof SKIP_WAITING_MESSAGE;
+
+export { SKIP_WAITING as S, SKIP_WAITING_MESSAGE as a, type SkipWaitingMessage as b };

package/dist/message-CBBmtYuB.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The single source of the client↔service-worker "activate the waiting worker"
+ * message. Both the client controller (`applyUpdate`) and the SW helper
+ * (`listenForSkipWaiting`) import it so the contract can never drift.
+ */
+declare const SKIP_WAITING: "SKIP_WAITING";
+declare const SKIP_WAITING_MESSAGE: {
+    readonly type: "SKIP_WAITING";
+};
+type SkipWaitingMessage = typeof SKIP_WAITING_MESSAGE;
+
+export { SKIP_WAITING as S, SKIP_WAITING_MESSAGE as a, type SkipWaitingMessage as b };