@pwa-platform/sw-runtime 0.1.0-beta.0

package/dist/worker/handlers.js

@@ -0,0 +1,196 @@
+import { isOfflineWriteMessage, isSkipWaitingMessage } from "../messages/index.js";
+import { validatePushPayload } from "../push-payload/index.js";
+import { createRouter } from "./decide.js";
+import { validateOfflineWriteEnqueue, validateOfflineWriteFlush } from "./offline-write-intent.js";
+import { flushOfflineWrites } from "./offline-write-flush.js";
+import { createOfflineWriteStore } from "./offline-write-store.js";
+import { resolveNotificationTarget } from "./notification-target.js";
+/**
+ * Registers `install`, `activate`, `fetch`, `message`, `push` and `notificationclick`, and nothing else. The worker
+ * never calls `skipWaiting` on its own (updates are prompted) and never claims clients. `push` and
+ * `notificationclick` are always on: see ADR-0021 for why a fixed pair of listeners has no observable effect on an
+ * application that never subscribes to push.
+ */
+export function attachPlatformWorker({ scope, config, engine }) {
+    const origin = new URL(scope.location.href).origin;
+    const router = createRouter({ config, manifestUrls: engine.urls(), origin });
+    const offlineWriteStore = config.offlineWrites.enabled ? createOfflineWriteStore(config.offlineWrites) : undefined;
+    scope.addEventListener("install", (event) => {
+        // The engine passes its work to event.waitUntil, so a failed download fails the install; the rejection is only
+        // silenced here to keep it out of the worker's unhandled-rejection log.
+        void engine.install(event).catch(() => undefined);
+    });
+    scope.addEventListener("activate", (event) => {
+        // The cleanup itself already reached event.waitUntil, so a rejection here carries only the engine's diagnostic
+        // signal — it fails loudly when a Workbox update changes the shape of its result. Let that surface.
+        void engine.activate(event);
+    });
+    scope.addEventListener("fetch", (event) => {
+        const decision = router.decide({
+            method: event.request.method,
+            url: event.request.url,
+            navigation: event.request.mode === "navigate",
+            // Any value counts, including "bytes=0-" (ADR-0023); decide() only acts on it for a manifest-hit request.
+            range: event.request.headers.has("range"),
+        });
+        if (decision.kind === "passthrough")
+            return;
+        if (decision.kind === "precache") {
+            event.respondWith(fromPrecache(scope, engine, decision.manifestUrl, event.request));
+            return;
+        }
+        event.respondWith(navigate(scope, engine, decision.fallbacks, event.request));
+    });
+    scope.addEventListener("message", (event) => {
+        if (!isSameOriginWindow(event.source, origin))
+            return;
+        if (isSkipWaitingMessage(event.data)) {
+            // Prompted updates: the new worker takes over only after a page confirmed it (ADR-0005).
+            event.waitUntil(scope.skipWaiting());
+            return;
+        }
+        if (!isOfflineWriteMessage(event.data))
+            return;
+        const [port, ...rest] = event.ports;
+        if (port === undefined || rest.length !== 0)
+            return;
+        if (event.data.type === "pwa:offline-write:clear") {
+            event.waitUntil(clear(event.data, offlineWriteStore, port));
+            return;
+        }
+        if (offlineWriteStore === undefined)
+            return;
+        if (event.data.type === "pwa:offline-write:enqueue")
+            event.waitUntil(enqueue(event.data, config, origin, offlineWriteStore, port));
+        if (event.data.type === "pwa:offline-write:flush")
+            event.waitUntil(flush(event.data, config, origin, offlineWriteStore, port, scope.fetch));
+    });
+    scope.addEventListener("push", (event) => {
+        const payload = event.data === null ? null : validatePushPayload(event.data.text());
+        // Not the platform's format, empty, or unparsable: show nothing and record nothing (spec "设计 / 2").
+        if (payload === null)
+            return;
+        const options = { data: { url: payload.url ?? null, data: payload.data ?? null } };
+        if (payload.body !== undefined)
+            options.body = payload.body;
+        if (payload.tag !== undefined)
+            options.tag = payload.tag;
+        event.waitUntil(scope.registration.showNotification(payload.title, options));
+    });
+    scope.addEventListener("notificationclick", (event) => {
+        event.notification.close();
+        const target = resolveNotificationTarget(readNotificationUrl(event.notification.data), scope.registration.scope);
+        event.waitUntil(focusOrOpen(scope, target));
+    });
+}
+async function clear(message, store, port) {
+    try {
+        await store?.clear();
+        replyClear(port, message.requestId);
+    }
+    catch {
+        reply(port, message.requestId, "rejected", "offline-write.storage");
+    }
+}
+async function flush(message, config, origin, store, port, send) {
+    const checked = validateOfflineWriteFlush(message, config);
+    if (!checked.ok)
+        return reply(port, message.requestId, "rejected", checked.code);
+    try {
+        const result = await flushOfflineWrites(store, checked.binding, origin, send);
+        replyFlush(port, message.requestId, result);
+    }
+    catch {
+        reply(port, message.requestId, "rejected", "offline-write.storage");
+    }
+}
+async function enqueue(message, config, origin, store, port) {
+    const checked = validateOfflineWriteEnqueue(message, config, origin);
+    if (!checked.ok)
+        return reply(port, message.requestId, "rejected", checked.code);
+    try {
+        reply(port, message.requestId, await store.enqueue(checked.value));
+    }
+    catch {
+        reply(port, message.requestId, "rejected", "offline-write.storage");
+    }
+}
+function reply(port, requestId, status, code) {
+    try {
+        port.postMessage(code === undefined ? { type: "pwa:offline-write:result", version: 1, requestId, status } : { type: "pwa:offline-write:result", version: 1, requestId, status, code });
+    }
+    catch {
+        // The page may have closed its port; queue admission remains authoritative and must not create an unhandled rejection.
+    }
+}
+function replyFlush(port, requestId, result) {
+    try {
+        port.postMessage({ type: "pwa:offline-write:result", version: 1, requestId, status: "flushed", ...result });
+    }
+    catch {
+        // The page may have closed its port after requesting a flush; replay outcomes remain durable in IndexedDB.
+    }
+}
+function replyClear(port, requestId) {
+    try {
+        port.postMessage({ type: "pwa:offline-write:result", version: 1, requestId, status: "cleared" });
+    }
+    catch {
+        // The page may have closed its port; a completed deletion must not surface as an unhandled worker rejection.
+    }
+}
+/** Reads `data.url` without ever invoking an accessor: anything other than a plain object with a string data property is undefined. */
+function readNotificationUrl(data) {
+    if (typeof data !== "object" || data === null || Array.isArray(data))
+        return undefined;
+    const prototype = Object.getPrototypeOf(data);
+    if (prototype !== Object.prototype && prototype !== null)
+        return undefined;
+    const descriptor = Object.getOwnPropertyDescriptor(data, "url");
+    if (descriptor === undefined || !("value" in descriptor) || typeof descriptor.value !== "string")
+        return undefined;
+    return descriptor.value;
+}
+/** Focuses a same-origin, same-scope window already showing `target`, otherwise opens it. Never navigates an existing window. */
+async function focusOrOpen(scope, target) {
+    try {
+        const windows = await scope.clients.matchAll({ type: "window", includeUncontrolled: true });
+        const existing = windows.find((client) => client.url === target);
+        if (existing !== undefined) {
+            await existing.focus();
+            return;
+        }
+        await scope.clients.openWindow(target);
+    }
+    catch {
+        // openWindow (and, in principle, focus) can reject — e.g. without user activation. There is nowhere useful to
+        // surface that, so it is swallowed here rather than left as an unhandled rejection on the waitUntil promise.
+    }
+}
+/** A precached URL: the cache answers; a missing entry falls back to the network rather than failing the request. */
+async function fromPrecache(scope, engine, manifestUrl, request) {
+    return (await engine.match(manifestUrl)) ?? (await scope.fetch(request));
+}
+/** Navigation: the network answers whenever it responds at all, including 4xx and 5xx; offline uses the fallbacks. */
+async function navigate(scope, engine, fallbacks, request) {
+    try {
+        const response = await scope.fetch(request);
+        if (response.type !== "error")
+            return response;
+    }
+    catch {
+        // A rejected fetch is the usual network-failure signal; an error response follows the same fallback path.
+    }
+    for (const candidate of fallbacks) {
+        const response = await engine.match(candidate);
+        if (response !== undefined)
+            return response;
+    }
+    return Response.error();
+}
+function isSameOriginWindow(source, origin) {
+    if (source === null || !("type" in source) || source.type !== "window")
+        return false;
+    return URL.canParse(source.url) && new URL(source.url).origin === origin;
+}
+//# sourceMappingURL=handlers.js.map

package/dist/worker/handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../src/worker/handlers.ts"],"names":[],"mappings":"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"}

package/dist/worker/index.d.ts

@@ -0,0 +1,17 @@
+import { type PwaPrecacheManifestEntry } from "@pwa-platform/engine-workbox/worker";
+import { type PwaPlatformWorkerConfig } from "../shared/config.js";
+export type PwaPlatformWorkerOptions = {
+    readonly scope: ServiceWorkerGlobalScope;
+    /** The injected config; validated before the engine is created or any listener is registered. */
+    readonly config: PwaPlatformWorkerConfig;
+    /** The injected precache manifest (`self.__WB_MANIFEST`). */
+    readonly manifest: readonly PwaPrecacheManifestEntry[];
+};
+/**
+ * Registers the platform worker: it precaches the plan's entries through the engine port, serves exact precache
+ * hits, answers navigations network first with the plan's offline fallbacks, and leaves every other request to the
+ * network. It skips waiting only when a page confirms an update.
+ */
+export declare function registerPlatformWorker({ scope, config, manifest }: PwaPlatformWorkerOptions): void;
+export type { PwaPassthroughReason, PwaRequestDecision, PwaRequestInput } from "./decide.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/worker/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/worker/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,KAAK,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC1G,OAAO,EAAgC,KAAK,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAGjG,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAC;IACzC,iGAAiG;IACjG,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,EAAE,SAAS,wBAAwB,EAAE,CAAC;CACxD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,wBAAwB,GAAG,IAAI,CAIlG;AAED,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/worker/index.js

@@ -0,0 +1,16 @@
+// Platform worker (service worker scope): registers install, activate, fetch and message listeners.
+// It imports only @pwa-platform/engine-workbox/worker.
+import { createPrecacheEngine } from "@pwa-platform/engine-workbox/worker";
+import { validatePlatformWorkerConfig } from "../shared/config.js";
+import { attachPlatformWorker } from "./handlers.js";
+/**
+ * Registers the platform worker: it precaches the plan's entries through the engine port, serves exact precache
+ * hits, answers navigations network first with the plan's offline fallbacks, and leaves every other request to the
+ * network. It skips waiting only when a page confirms an update.
+ */
+export function registerPlatformWorker({ scope, config, manifest }) {
+    const validated = validatePlatformWorkerConfig(config);
+    const engine = createPrecacheEngine({ cacheName: validated.precacheCacheName, entries: manifest });
+    attachPlatformWorker({ scope, config: validated, engine });
+}
+//# sourceMappingURL=index.js.map

package/dist/worker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/worker/index.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,uDAAuD;AACvD,OAAO,EAAE,oBAAoB,EAAiC,MAAM,qCAAqC,CAAC;AAC1G,OAAO,EAAE,4BAA4B,EAAgC,MAAM,qBAAqB,CAAC;AACjG,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAUrD;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAA4B;IAC1F,MAAM,SAAS,GAAG,4BAA4B,CAAC,MAAM,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,oBAAoB,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,iBAAiB,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IACnG,oBAAoB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;AAC7D,CAAC"}

package/dist/worker/notification-target.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Resolves `url` (as read from the notification's `data.url`, of unknown shape) against `scopeUrl`
+ * (`registration.scope`, always absolute and ending in "/"). Falls back to `scopeUrl` whenever `url` is missing,
+ * malformed, cross-origin, carries credentials, or resolves outside the scope — including `..` and percent-encoded
+ * traversal, and a same-origin address that merely shares the scope's prefix (e.g. `/application/` vs `/app/`),
+ * because the WHATWG URL parser normalises the target before this compares its serialized `href` against the scope.
+ */
+export declare function resolveNotificationTarget(url: unknown, scopeUrl: string): string;
+//# sourceMappingURL=notification-target.d.ts.map

package/dist/worker/notification-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-target.d.ts","sourceRoot":"","sources":["../../src/worker/notification-target.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAehF"}

package/dist/worker/notification-target.js

@@ -0,0 +1,28 @@
+// Resolves a `notificationclick` target to an address the platform worker is allowed to open or focus: inside the
+// same origin and scope as the worker itself. Spec: spec/push-module.md "设计 / 2. 平台 worker 的两个新监听"; ADR-0021.
+/**
+ * Resolves `url` (as read from the notification's `data.url`, of unknown shape) against `scopeUrl`
+ * (`registration.scope`, always absolute and ending in "/"). Falls back to `scopeUrl` whenever `url` is missing,
+ * malformed, cross-origin, carries credentials, or resolves outside the scope — including `..` and percent-encoded
+ * traversal, and a same-origin address that merely shares the scope's prefix (e.g. `/application/` vs `/app/`),
+ * because the WHATWG URL parser normalises the target before this compares its serialized `href` against the scope.
+ */
+export function resolveNotificationTarget(url, scopeUrl) {
+    if (typeof url !== "string" || url.length === 0)
+        return scopeUrl;
+    let target;
+    try {
+        target = new URL(url, scopeUrl);
+    }
+    catch {
+        return scopeUrl;
+    }
+    if (target.origin !== new URL(scopeUrl).origin)
+        return scopeUrl;
+    if (target.username.length > 0 || target.password.length > 0)
+        return scopeUrl;
+    if (!target.href.startsWith(scopeUrl))
+        return scopeUrl;
+    return target.href;
+}
+//# sourceMappingURL=notification-target.js.map

package/dist/worker/notification-target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-target.js","sourceRoot":"","sources":["../../src/worker/notification-target.ts"],"names":[],"mappings":"AAAA,kHAAkH;AAClH,8GAA8G;AAE9G;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,GAAY,EAAE,QAAgB;IACtE,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAEjE,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC;IAChE,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC9E,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAEvD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}

package/dist/worker/offline-write-flush.d.ts

@@ -0,0 +1,10 @@
+import type { PwaOfflineWriteStore } from "./offline-write-store.js";
+export type PwaOfflineWriteFlushResult = {
+    readonly sent: number;
+    readonly retained: number;
+    readonly failed: number;
+    readonly purged: number;
+};
+/** Explicit FIFO replay; it is never called by fetch, Sync, Push or worker activation. */
+export declare function flushOfflineWrites(store: PwaOfflineWriteStore, binding: string, origin: string, send: typeof fetch): Promise<PwaOfflineWriteFlushResult>;
+//# sourceMappingURL=offline-write-flush.d.ts.map

package/dist/worker/offline-write-flush.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-write-flush.d.ts","sourceRoot":"","sources":["../../src/worker/offline-write-flush.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE,MAAM,MAAM,0BAA0B,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhJ,0FAA0F;AAC1F,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,KAAK,GACjB,OAAO,CAAC,0BAA0B,CAAC,CA6BrC"}

package/dist/worker/offline-write-flush.js

@@ -0,0 +1,32 @@
+/** Explicit FIFO replay; it is never called by fetch, Sync, Push or worker activation. */
+export async function flushOfflineWrites(store, binding, origin, send) {
+    const prepared = await store.prepareFlush(binding);
+    let sent = 0;
+    let retained = 0;
+    let failed = 0;
+    for (const write of prepared.writes) {
+        try {
+            const response = await send(new URL(write.path, origin), {
+                method: "POST",
+                credentials: "same-origin",
+                headers: { "content-type": "application/json", "idempotency-key": write.idempotencyKey },
+                body: write.bodyJson,
+            });
+            if (response.ok) {
+                await store.remove(write.idempotencyKey);
+                sent += 1;
+            }
+            else if (response.status >= 500)
+                retained += 1;
+            else {
+                await store.markFailed(write.idempotencyKey, response.status === 401 || response.status === 403 ? "authorization-required" : "rejected");
+                failed += 1;
+            }
+        }
+        catch {
+            retained += 1;
+        }
+    }
+    return { sent, retained, failed, purged: prepared.purged };
+}
+//# sourceMappingURL=offline-write-flush.js.map

package/dist/worker/offline-write-flush.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-write-flush.js","sourceRoot":"","sources":["../../src/worker/offline-write-flush.ts"],"names":[],"mappings":"AAIA,0FAA0F;AAC1F,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAA2B,EAC3B,OAAe,EACf,MAAc,EACd,IAAkB;IAElB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IACnD,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE;gBACvD,MAAM,EAAE,MAAM;gBACd,WAAW,EAAE,aAAa;gBAC1B,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,KAAK,CAAC,cAAc,EAAE;gBACxF,IAAI,EAAE,KAAK,CAAC,QAAQ;aACrB,CAAC,CAAC;YACH,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAChB,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;gBACzC,IAAI,IAAI,CAAC,CAAC;YACZ,CAAC;iBAAM,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG;gBAAE,QAAQ,IAAI,CAAC,CAAC;iBAC5C,CAAC;gBACJ,MAAM,KAAK,CAAC,UAAU,CACpB,KAAK,CAAC,cAAc,EACpB,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,UAAU,CAC3F,CAAC;gBACF,MAAM,IAAI,CAAC,CAAC;YACd,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,IAAI,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;AAC7D,CAAC"}

package/dist/worker/offline-write-intent.d.ts

@@ -0,0 +1,36 @@
+import type { PwaOfflineWriteMessage } from "../messages/index.js";
+import type { PwaPlatformWorkerConfig } from "../shared/config.js";
+type EnqueueMessage = Extract<PwaOfflineWriteMessage, {
+    readonly type: "pwa:offline-write:enqueue";
+}>;
+type FlushMessage = Extract<PwaOfflineWriteMessage, {
+    readonly type: "pwa:offline-write:flush";
+}>;
+export type PwaOfflineWriteIntent = {
+    readonly targetId: string;
+    readonly path: string;
+    /** Canonical JSON text; the original object is deliberately not retained beyond this boundary. */
+    readonly bodyJson: string;
+    readonly idempotencyKey: string;
+    readonly sessionBinding: string;
+};
+export type PwaOfflineWriteIntentResult = {
+    readonly ok: true;
+    readonly value: PwaOfflineWriteIntent;
+} | {
+    readonly ok: false;
+    readonly code: string;
+};
+export type PwaOfflineWriteFlushValidationResult = {
+    readonly ok: true;
+    readonly binding: string;
+} | {
+    readonly ok: false;
+    readonly code: string;
+};
+/** Validates and canonicalizes one explicit enqueue request before any persistent storage is opened. */
+export declare function validateOfflineWriteEnqueue(message: EnqueueMessage, config: PwaPlatformWorkerConfig, origin: string): PwaOfflineWriteIntentResult;
+/** Checks the current page's opaque binding before a later flush may inspect stored records. */
+export declare function validateOfflineWriteFlush(message: FlushMessage, config: PwaPlatformWorkerConfig): PwaOfflineWriteFlushValidationResult;
+export {};
+//# sourceMappingURL=offline-write-intent.d.ts.map

package/dist/worker/offline-write-intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-write-intent.d.ts","sourceRoot":"","sources":["../../src/worker/offline-write-intent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAEnE,KAAK,cAAc,GAAG,OAAO,CAAC,sBAAsB,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAA;CAAE,CAAC,CAAC;AACtG,KAAK,YAAY,GAAG,OAAO,CAAC,sBAAsB,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAA;CAAE,CAAC,CAAC;AAElG,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kGAAkG;IAClG,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,2BAA2B,GACnC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAA;CAAE,GAC5D;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAClD,MAAM,MAAM,oCAAoC,GAC5C;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAKlD,wGAAwG;AACxG,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,uBAAuB,EAC/B,MAAM,EAAE,MAAM,GACb,2BAA2B,CAiB7B;AAED,gGAAgG;AAChG,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,uBAAuB,GAAG,oCAAoC,CAItI"}

package/dist/worker/offline-write-intent.js

@@ -0,0 +1,84 @@
+const OPAQUE_ASCII = /^[\x21-\x7e]{1,128}$/;
+const SESSION_BINDING = /^[\x21-\x7e]{16,128}$/;
+/** Validates and canonicalizes one explicit enqueue request before any persistent storage is opened. */
+export function validateOfflineWriteEnqueue(message, config, origin) {
+    if (!config.offlineWrites.enabled)
+        return { ok: false, code: "offline-write.disabled" };
+    const { intent } = message;
+    const target = config.offlineWrites.targets.find((candidate) => candidate.id === intent.targetId);
+    if (target === undefined)
+        return { ok: false, code: "offline-write.target" };
+    if (!OPAQUE_ASCII.test(intent.idempotencyKey))
+        return { ok: false, code: "offline-write.idempotency-key" };
+    if (!SESSION_BINDING.test(intent.sessionBinding))
+        return { ok: false, code: "offline-write.session-binding" };
+    const path = canonicalSameOriginPath(intent.path, origin);
+    if (path === undefined || !isWithin(path, config.scope) || !isWithin(path, target.pathPrefix)) {
+        return { ok: false, code: "offline-write.path" };
+    }
+    const bodyJson = jsonText(intent.body);
+    if (bodyJson === undefined || new TextEncoder().encode(bodyJson).length > target.maxBodyBytes) {
+        return { ok: false, code: "offline-write.body" };
+    }
+    return { ok: true, value: { targetId: target.id, path, bodyJson, idempotencyKey: intent.idempotencyKey, sessionBinding: intent.sessionBinding } };
+}
+/** Checks the current page's opaque binding before a later flush may inspect stored records. */
+export function validateOfflineWriteFlush(message, config) {
+    if (!config.offlineWrites.enabled)
+        return { ok: false, code: "offline-write.disabled" };
+    if (!SESSION_BINDING.test(message.sessionBinding))
+        return { ok: false, code: "offline-write.session-binding" };
+    return { ok: true, binding: message.sessionBinding };
+}
+function canonicalSameOriginPath(value, origin) {
+    if (!value.startsWith("/") || !URL.canParse(value, origin))
+        return undefined;
+    const url = new URL(value, origin);
+    return url.origin === origin && url.search === "" && url.hash === "" && url.pathname === value ? value : undefined;
+}
+function isWithin(path, prefix) {
+    if (prefix === "/")
+        return true;
+    const directory = prefix.endsWith("/") ? prefix : `${prefix}/`;
+    return path === prefix || path === directory.slice(0, -1) || path.startsWith(directory);
+}
+function jsonText(value) {
+    try {
+        if (!isJsonValue(value, new WeakSet()))
+            return undefined;
+        const text = JSON.stringify(value);
+        return text === undefined ? undefined : text;
+    }
+    catch {
+        return undefined;
+    }
+}
+function isJsonValue(value, seen) {
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return true;
+    if (typeof value === "number")
+        return Number.isFinite(value);
+    if (typeof value !== "object" || seen.has(value))
+        return false;
+    seen.add(value);
+    if (Array.isArray(value)) {
+        for (let index = 0; index < value.length; index += 1) {
+            const descriptor = Object.getOwnPropertyDescriptor(value, String(index));
+            if (descriptor === undefined || !("value" in descriptor) || !isJsonValue(descriptor.value, seen))
+                return false;
+        }
+        return true;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype !== Object.prototype && prototype !== null)
+        return false;
+    for (const key of Reflect.ownKeys(value)) {
+        if (typeof key !== "string")
+            return false;
+        const descriptor = Object.getOwnPropertyDescriptor(value, key);
+        if (descriptor === undefined || !("value" in descriptor) || !isJsonValue(descriptor.value, seen))
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=offline-write-intent.js.map

package/dist/worker/offline-write-intent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-write-intent.js","sourceRoot":"","sources":["../../src/worker/offline-write-intent.ts"],"names":[],"mappings":"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"}

package/dist/worker/offline-write-store.d.ts

@@ -0,0 +1,27 @@
+import type { PwaPlatformWorkerConfig } from "../shared/config.js";
+import type { PwaOfflineWriteIntent } from "./offline-write-intent.js";
+export type PwaOfflineWriteState = "pending" | "authorization-required" | "rejected";
+export type PwaStoredOfflineWrite = PwaOfflineWriteIntent & {
+    readonly createdAt: number;
+    readonly bodyBytes: number;
+    readonly deliveryState: PwaOfflineWriteState;
+};
+export type PwaPreparedOfflineWrites = {
+    readonly writes: readonly PwaStoredOfflineWrite[];
+    readonly purged: number;
+};
+export type PwaOfflineWriteStore = {
+    enqueue(intent: PwaOfflineWriteIntent): Promise<"queued" | "existing">;
+    prepareFlush(binding: string): Promise<PwaPreparedOfflineWrites>;
+    remove(idempotencyKey: string): Promise<void>;
+    markFailed(idempotencyKey: string, state: Exclude<PwaOfflineWriteState, "pending">): Promise<void>;
+    clear(): Promise<void>;
+};
+/**
+ * The worker-owned IndexedDB queue. Every admission decision and write shares one readwrite transaction, so a
+ * concurrent enqueue cannot overrun a quota or turn one idempotency key into two different stored intents.
+ */
+export declare function createOfflineWriteStore(config: Extract<PwaPlatformWorkerConfig["offlineWrites"], {
+    readonly enabled: true;
+}>): PwaOfflineWriteStore;
+//# sourceMappingURL=offline-write-store.d.ts.map

package/dist/worker/offline-write-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-write-store.d.ts","sourceRoot":"","sources":["../../src/worker/offline-write-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAIvE,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,wBAAwB,GAAG,UAAU,CAAC;AACrF,MAAM,MAAM,qBAAqB,GAAG,qBAAqB,GAAG;IAC1D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC;CAC9C,CAAC;AACF,MAAM,MAAM,wBAAwB,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtH,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,GAAG,UAAU,CAAC,CAAC;IACvE,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACjE,MAAM,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,oBAAoB,EAAE,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,CAAC,uBAAuB,CAAC,eAAe,CAAC,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAA;CAAE,CAAC,GAAG,oBAAoB,CAkHnJ"}