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>
128 lines
4.4 KiB
TypeScript
128 lines
4.4 KiB
TypeScript
import { createHash } from "node:crypto";
|
|
|
|
import {
|
|
canonicalStaticManifestBytes,
|
|
decodeStaticAssetManifest,
|
|
} from "../../src/contracts/service-worker-static-manifest.ts";
|
|
|
|
import type {
|
|
InstalledServiceWorkerSelection,
|
|
ServiceWorkerHandlerId,
|
|
StaticAssetManifestV1,
|
|
} from "../../src/contracts/service-worker.ts";
|
|
|
|
const DIGEST = /^sha256:[0-9a-f]{64}$/u;
|
|
|
|
export type ServiceWorkerBuildInput = Readonly<{
|
|
assets: StaticAssetManifestV1;
|
|
handlers: readonly ServiceWorkerHandlerId[];
|
|
contractSetDigest: string;
|
|
releaseManifestUrl: string;
|
|
}>;
|
|
|
|
/**
|
|
* ACTIVE worker compilation is a release-integrity boundary. Missing generated
|
|
* modules, stale identities and placeholder digests are fatal build defects;
|
|
* they must never be converted into a worker that merely degrades at runtime.
|
|
*/
|
|
export function resolveServiceWorkerBuildInput(input: Readonly<{
|
|
selection: InstalledServiceWorkerSelection | null;
|
|
assets: unknown;
|
|
contractSet: unknown;
|
|
/** `dist/config.json`, materialized from the build's profile (06-10). */
|
|
runtimeConfig: unknown;
|
|
/** The build's `APP_PROFILE`; the runtime document must be for it. */
|
|
appProfile: string;
|
|
buildId: string;
|
|
releaseId: string;
|
|
}>): ServiceWorkerBuildInput {
|
|
if (input.selection?.mode !== "ACTIVE") {
|
|
throw new TypeError(
|
|
"Service Worker build requires an ACTIVE static selection.",
|
|
);
|
|
}
|
|
if (!Array.isArray(input.selection.handlers)) {
|
|
throw new TypeError("Service Worker handlers must be an array.");
|
|
}
|
|
const handlers = new Set<ServiceWorkerHandlerId>();
|
|
for (const handler of input.selection.handlers) {
|
|
if (
|
|
handler !== "PWA_STATIC_ASSETS" &&
|
|
handler !== "OFFLINE_SYNC_WAKEUP" &&
|
|
handler !== "WEB_PUSH"
|
|
) {
|
|
throw new TypeError(`Unknown Service Worker handler: ${String(handler)}.`);
|
|
}
|
|
if (handlers.has(handler)) {
|
|
throw new TypeError(`Duplicate Service Worker handler: ${handler}.`);
|
|
}
|
|
handlers.add(handler);
|
|
}
|
|
if (handlers.has("WEB_PUSH")) {
|
|
throw new TypeError(
|
|
"WEB_PUSH requires an installed product-owned worker contribution.",
|
|
);
|
|
}
|
|
const assets = parseAssets(input.assets);
|
|
if (assets.buildId !== input.buildId || assets.releaseId !== input.releaseId) {
|
|
throw new TypeError("Generated Service Worker asset identity is stale.");
|
|
}
|
|
const contractSet = record(input.contractSet);
|
|
const contractSetDigest = contractSet?.setDigest;
|
|
if (typeof contractSetDigest !== "string" || !DIGEST.test(contractSetDigest)) {
|
|
throw new TypeError("Generated contract set digest is invalid.");
|
|
}
|
|
const runtimeConfig = record(input.runtimeConfig);
|
|
// 06-10 / F-8. `public/config.json` is the local profile; a worker built from
|
|
// it for another profile would carry that profile's URLs.
|
|
if (runtimeConfig?.APP_ENV !== input.appProfile) {
|
|
throw new TypeError(
|
|
`Service Worker runtime config APP_ENV ${String(runtimeConfig?.APP_ENV)} does not match APP_PROFILE ${input.appProfile}.`,
|
|
);
|
|
}
|
|
const releaseManifestUrl = runtimeConfig.RELEASE_MANIFEST_URL;
|
|
if (
|
|
typeof releaseManifestUrl !== "string" ||
|
|
releaseManifestUrl.length === 0 ||
|
|
releaseManifestUrl.length > 2_048
|
|
) {
|
|
throw new TypeError("Runtime release manifest URL is invalid.");
|
|
}
|
|
return Object.freeze({
|
|
assets,
|
|
handlers: Object.freeze([...handlers]),
|
|
contractSetDigest,
|
|
releaseManifestUrl,
|
|
});
|
|
}
|
|
|
|
/**
|
|
* SW-05. The build gate no longer type-casts the manifest. It decodes every row
|
|
* through the shared runtime-neutral codec and recomputes the set digest from
|
|
* the same canonical bytes the generator hashed, so a tampered row, a reordered
|
|
* set or a stale digest fails admission instead of shipping.
|
|
*/
|
|
function parseAssets(value: unknown): StaticAssetManifestV1 {
|
|
const decoded = decodeStaticAssetManifest(value);
|
|
if (!decoded.ok) {
|
|
throw new TypeError(
|
|
`Generated Service Worker asset manifest is invalid: ${decoded.error.reason}`,
|
|
);
|
|
}
|
|
const expected = `sha256:${createHash("sha256")
|
|
.update(canonicalStaticManifestBytes(decoded.manifest.assets))
|
|
.digest("hex")}`;
|
|
if (expected !== decoded.manifest.setDigest) {
|
|
throw new TypeError(
|
|
"Generated Service Worker asset manifest set digest does not match its assets.",
|
|
);
|
|
}
|
|
return decoded.manifest as unknown as StaticAssetManifestV1;
|
|
}
|
|
|
|
function record(value: unknown): Record<string, unknown> | null {
|
|
return value && typeof value === "object" && !Array.isArray(value)
|
|
? (value as Record<string, unknown>)
|
|
: null;
|
|
}
|