@broberg/pwa 0.1.0

package/dist/sw.d.ts

@@ -0,0 +1,30 @@
+export { S as SKIP_WAITING, a as SKIP_WAITING_MESSAGE, b as SkipWaitingMessage } from './message-CBBmtYuB.js';
+
+/**
+ * The minimal slice of a service-worker global scope this helper needs.
+ * Kept as a local interface so the package doesn't pull in the `webworker`
+ * TS lib (which clashes with `dom`) and stays trivially testable.
+ */
+interface SkipWaitingScope {
+    addEventListener(type: "message", listener: (event: {
+        data?: unknown;
+    }) => void): void;
+    skipWaiting(): Promise<void> | void;
+}
+/**
+ * Wire the service-worker side of the update handshake: when the client calls
+ * `applyUpdate()` (posts `SKIP_WAITING`), the worker activates immediately.
+ *
+ * Call it once inside your service worker, before other setup:
+ *
+ * ```ts
+ * import { listenForSkipWaiting } from "@broberg/pwa/sw";
+ * listenForSkipWaiting();
+ * ```
+ *
+ * Serwist/Workbox users: keep `skipWaiting: false` (so activation is
+ * user-gated by the banner, not automatic) and `clientsClaim: true`.
+ */
+declare function listenForSkipWaiting(scope?: SkipWaitingScope): void;
+
+export { type SkipWaitingScope, listenForSkipWaiting };

package/dist/sw.js

@@ -0,0 +1,16 @@
+import { SKIP_WAITING } from './chunk-ERNF6MZL.js';
+export { SKIP_WAITING, SKIP_WAITING_MESSAGE } from './chunk-ERNF6MZL.js';
+
+// src/sw.ts
+function listenForSkipWaiting(scope) {
+  const target = scope ?? globalThis;
+  target.addEventListener("message", (event) => {
+    if (event.data?.type === SKIP_WAITING) {
+      void target.skipWaiting();
+    }
+  });
+}
+
+export { listenForSkipWaiting };
+//# sourceMappingURL=sw.js.map
+//# sourceMappingURL=sw.js.map

package/dist/sw.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sw.ts"],"names":[],"mappings":";;;;AAgCO,SAAS,qBAAqB,KAAA,EAAgC;AACnE,EAAA,MAAM,SACJ,KAAA,IAAU,UAAA;AACZ,EAAA,MAAA,CAAO,gBAAA,CAAiB,SAAA,EAAW,CAAC,KAAA,KAAU;AAC5C,IAAA,IAAK,KAAA,CAAM,IAAA,EAA4B,IAAA,KAAS,YAAA,EAAc;AAC5D,MAAA,KAAK,OAAO,WAAA,EAAY;AAAA,IAC1B;AAAA,EACF,CAAC,CAAA;AACH","file":"sw.js","sourcesContent":["import { SKIP_WAITING } from \"./message.js\";\n\nexport { SKIP_WAITING, SKIP_WAITING_MESSAGE } from \"./message.js\";\nexport type { SkipWaitingMessage } from \"./message.js\";\n\n/**\n * The minimal slice of a service-worker global scope this helper needs.\n * Kept as a local interface so the package doesn't pull in the `webworker`\n * TS lib (which clashes with `dom`) and stays trivially testable.\n */\nexport interface SkipWaitingScope {\n  addEventListener(\n    type: \"message\",\n    listener: (event: { data?: unknown }) => void,\n  ): void;\n  skipWaiting(): Promise<void> | void;\n}\n\n/**\n * Wire the service-worker side of the update handshake: when the client calls\n * `applyUpdate()` (posts `SKIP_WAITING`), the worker activates immediately.\n *\n * Call it once inside your service worker, before other setup:\n *\n * ```ts\n * import { listenForSkipWaiting } from \"@broberg/pwa/sw\";\n * listenForSkipWaiting();\n * ```\n *\n * Serwist/Workbox users: keep `skipWaiting: false` (so activation is\n * user-gated by the banner, not automatic) and `clientsClaim: true`.\n */\nexport function listenForSkipWaiting(scope?: SkipWaitingScope): void {\n  const target =\n    scope ?? (globalThis as unknown as SkipWaitingScope);\n  target.addEventListener(\"message\", (event) => {\n    if ((event.data as { type?: string })?.type === SKIP_WAITING) {\n      void target.skipWaiting();\n    }\n  });\n}\n"]}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@broberg/pwa",
+  "version": "0.1.0",
+  "description": "Fleet PWA primitive: a framework-agnostic service-worker update-detection controller (new-version-available lifecycle) + a React hook and unstyled banner skeleton + a service-worker skip-waiting helper. Zero runtime deps; ship-dark.",
+  "type": "module",
+  "license": "MIT",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js",
+      "require": "./dist/react.cjs"
+    },
+    "./sw": {
+      "types": "./dist/sw.d.ts",
+      "import": "./dist/sw.js",
+      "require": "./dist/sw.cjs"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.0.0",
+    "@types/react": "^19.0.0",
+    "happy-dom": "^15.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "keywords": [
+    "pwa",
+    "progressive-web-app",
+    "service-worker",
+    "update",
+    "skipwaiting",
+    "new-version",
+    "add-to-home-screen",
+    "install",
+    "offline",
+    "serwist",
+    "workbox",
+    "react",
+    "broberg"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/broberg-ai/components.git",
+    "directory": "packages/pwa"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}