refactor: 리펙토링

scripts/lib/service-worker-build-input.ts

@@ -0,0 +1,101 @@
+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;
+}