Files
clean-architecture-frontend…/tests/unit/service-worker-build-input.test.ts
donghyeon-kaandClaude Opus 5.5 cefb0b2975 fix(service-worker): build the worker from the profile config (06-10)
The worker build read public/config.json, the local profile, even in a
production build (F-8). It now reads dist/config.json and fails when that
document's APP_ENV is not the build's APP_PROFILE.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-27 12:57:41 +09:00

266 lines
7.9 KiB
TypeScript

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<string, (event: unknown) => 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<unknown>[] = [];
const event = { waitUntil: (task: Promise<unknown>) => 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();
});
});