102 lines
3.3 KiB
TypeScript
102 lines
3.3 KiB
TypeScript
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;
|
|
runtimeConfig: unknown;
|
|
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);
|
|
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,
|
|
});
|
|
}
|
|
|
|
function parseAssets(value: unknown): StaticAssetManifestV1 {
|
|
const candidate = record(value);
|
|
if (
|
|
candidate?.schemaVersion !== 1 ||
|
|
typeof candidate.buildId !== "string" ||
|
|
typeof candidate.releaseId !== "string" ||
|
|
typeof candidate.setDigest !== "string" ||
|
|
!DIGEST.test(candidate.setDigest) ||
|
|
!Array.isArray(candidate.assets)
|
|
) {
|
|
throw new TypeError("Generated Service Worker asset manifest is invalid.");
|
|
}
|
|
return candidate 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;
|
|
}
|