import { createHash } from "node:crypto"; import { runInNewContext } from "node:vm"; import { describe, expect, it, vi } from "vitest"; import { SELF_UNREGISTERING_SERVICE_WORKER } from "../../scripts/lib/self-unregistering-service-worker.ts"; import { resolveServiceWorkerBuildInput } from "../../scripts/lib/service-worker-build-input.ts"; import { canonicalStaticManifestBytes, type StaticAssetRow, } from "../../src/contracts/service-worker-static-manifest.ts"; const digest = (character: string) => `sha256:${character.repeat(64)}`; /** SW-05. The gate recomputes this from the shared canonical bytes. */ function setDigestFor(rows: readonly StaticAssetRow[]): string { return `sha256:${createHash("sha256") .update(canonicalStaticManifestBytes(rows)) .digest("hex")}`; } const ASSET_ROWS: readonly StaticAssetRow[] = Object.freeze([ Object.freeze({ url: "/assets/app.0123456789abcdef.js", sha256: digest("c"), bytes: 128, contentType: "text/javascript", }), ]); /** The shape `scripts/generate-runtime-config.ts` writes to `dist/config.json`. */ const LOCAL_RUNTIME_CONFIG = Object.freeze({ APP_ENV: "local", RELEASE_MANIFEST_URL: "/release-manifest.json", }); describe("service worker build input", () => { const selection = { mode: "ACTIVE" as const, scriptPath: "service-worker.js" as const, handlers: ["PWA_STATIC_ASSETS" as const], }; const assets = { schemaVersion: 1 as const, buildId: "build-1", releaseId: "release-1", setDigest: setDigestFor(ASSET_ROWS), assets: [...ASSET_ROWS], }; it("rejects a direct worker build when ACTIVE selection or generated inputs are absent", () => { expect(() => resolveServiceWorkerBuildInput({ selection: null, assets, contractSet: { setDigest: digest("b") }, runtimeConfig: LOCAL_RUNTIME_CONFIG, appProfile: "local", buildId: "build-1", releaseId: "release-1", }), ).toThrow(/ACTIVE/u); expect(() => resolveServiceWorkerBuildInput({ selection, assets: null, contractSet: { setDigest: digest("b") }, runtimeConfig: LOCAL_RUNTIME_CONFIG, appProfile: "local", buildId: "build-1", releaseId: "release-1", }), ).toThrow(/asset manifest/u); }); it("rejects stale generated identity instead of compiling a mismatched worker", () => { expect(() => resolveServiceWorkerBuildInput({ selection, assets: { ...assets, buildId: "old-build" }, contractSet: { setDigest: digest("b") }, runtimeConfig: LOCAL_RUNTIME_CONFIG, appProfile: "local", buildId: "build-1", releaseId: "release-1", }), ).toThrow(/identity/u); }); it("rejects WEB_PUSH selection until its product-owned worker contribution exists", () => { expect(() => resolveServiceWorkerBuildInput({ selection: { ...selection, handlers: ["WEB_PUSH"] }, assets, contractSet: { setDigest: digest("b") }, runtimeConfig: LOCAL_RUNTIME_CONFIG, appProfile: "local", buildId: "build-1", releaseId: "release-1", }), ).toThrow(/WEB_PUSH.*contribution/u); }); it("returns only fully matched, digest-bearing generated inputs", () => { expect( resolveServiceWorkerBuildInput({ selection, assets, contractSet: { setDigest: digest("b") }, runtimeConfig: LOCAL_RUNTIME_CONFIG, appProfile: "local", buildId: "build-1", releaseId: "release-1", }), ).toMatchObject({ assets, handlers: ["PWA_STATIC_ASSETS"], contractSetDigest: digest("b"), releaseManifestUrl: "/release-manifest.json", }); }); it("rejects asset row or canonical set-digest tampering at build input", () => { const base = { selection, contractSet: { setDigest: digest("b") }, runtimeConfig: LOCAL_RUNTIME_CONFIG, appProfile: "local", buildId: "build-1", releaseId: "release-1", }; const tampered: readonly Readonly<{ label: string; assets: unknown; }>[] = [ { label: "stale set digest", assets: { ...assets, setDigest: digest("a") }, }, { label: "tampered byte length", assets: { ...assets, assets: [{ ...ASSET_ROWS[0]!, bytes: 129 }], }, }, { label: "cross-origin url", assets: { ...assets, assets: [ { ...ASSET_ROWS[0]!, url: "https://evil.example/a.js" }, ], }, }, { label: "dot segment", assets: { ...assets, assets: [{ ...ASSET_ROWS[0]!, url: "/assets/../a.js" }], }, }, { label: "extension and content type mismatch", assets: { ...assets, assets: [{ ...ASSET_ROWS[0]!, contentType: "text/css" }], }, }, { label: "unknown row field", assets: { ...assets, assets: [{ ...ASSET_ROWS[0]!, extra: "smuggled" }], }, }, { label: "duplicate url", assets: { ...assets, assets: [ASSET_ROWS[0]!, ASSET_ROWS[0]!], }, }, ]; for (const entry of tampered) { expect( () => resolveServiceWorkerBuildInput({ ...base, assets: entry.assets as never, }), entry.label, ).toThrow(TypeError); } }); // 06-10 / F-8. The worker build read `public/config.json`, the local // profile, for every build. It now reads the profile document the build // materialized, and a document for another profile fails the build. it("rejects a runtime document for a profile other than the build's", () => { const build = (appProfile: string) => resolveServiceWorkerBuildInput({ selection, assets, contractSet: { setDigest: digest("b") }, runtimeConfig: LOCAL_RUNTIME_CONFIG, appProfile, buildId: "build-1", releaseId: "release-1", }); expect(() => build("production")).toThrow( /APP_ENV local does not match APP_PROFILE production/u, ); expect(build("local").releaseManifestUrl).toBe("/release-manifest.json"); }); it("accepts generator-shaped output unchanged", () => { expect(() => resolveServiceWorkerBuildInput({ selection, assets, contractSet: { setDigest: digest("b") }, runtimeConfig: LOCAL_RUNTIME_CONFIG, appProfile: "local", buildId: "build-1", releaseId: "release-1", }), ).not.toThrow(); }); }); /** * 06-03 (D-5). A REMOVE_REGISTRATION release ships this as * `service-worker.js`, so a browser update check replaces even a worker that * stops the page from booting. The context has no `caches` and no `fetch`: a * reference to either throws. */ describe("self-unregistering service worker", () => { it("takes over at once, unregisters itself and handles no fetch", async () => { const listeners = new Map void>(); const skipWaiting = vi.fn(async () => {}); const unregister = vi.fn(async () => true); runInNewContext(SELF_UNREGISTERING_SERVICE_WORKER, { self: { addEventListener(type: string, listener: (event: unknown) => void) { listeners.set(type, listener); }, skipWaiting, registration: { unregister }, }, }); expect([...listeners.keys()].sort()).toEqual(["activate", "install"]); const pending: Promise[] = []; const event = { waitUntil: (task: Promise) => pending.push(task) }; listeners.get("install")!(event); expect(skipWaiting).toHaveBeenCalledOnce(); expect(unregister).not.toHaveBeenCalled(); listeners.get("activate")!(event); await Promise.all(pending); expect(pending).toHaveLength(2); expect(unregister).toHaveBeenCalledOnce(); }); });