Files
loto/web/scripts/verify-pwa-build.mjs
T

97 lines
3.3 KiB
JavaScript

#!/usr/bin/env node
/**
* Build-time regression guard for the PWA layer.
*
* `adapter-static` renders page HTML during `adapt()`, which runs AFTER the
* PWA plugin's `closeBundle` — so `@vite-pwa/sveltekit` never gets to inject
* its own registration tag into the built HTML, and a plain grep on
* `build/index.html` proves nothing either way. `+layout.svelte` registers
* the service worker itself via a dynamically-imported `virtual:pwa-register`
* chunk instead; this script asserts that wiring survived the build rather
* than trusting a future refactor not to quietly drop it.
*
* Also asserts the audio precache manifest in `build/sw.js` is prefixed
* with the SAME base path SvelteKit itself resolved for this build — a
* mismatch here 404s every precached clip and fails the SW `install` event
* on that origin (this exact bug shipped once already).
*
* Usage: run AFTER `npm run build` / `npm run build:gh` (see package.json's
* `verify:pwa` script), with the same `BUILD_PROFILE`/`NEXT_BASE_PATH` env
* the build used.
*/
import { readdirSync, readFileSync, statSync } from "node:fs";
import { join } from "node:path";
import { resolveBase } from "../base-path.js";
const BUILD_DIR = "build";
let ok = true;
/** @param {string} msg */
function fail(msg) {
console.error(`✗ ${msg}`);
ok = false;
}
/** @param {string} dir */
function walkJsFiles(dir) {
/** @type {string[]} */
const files = [];
for (const entry of readdirSync(dir)) {
const full = join(dir, entry);
if (statSync(full).isDirectory()) files.push(...walkJsFiles(full));
else if (entry.endsWith(".js")) files.push(full);
}
return files;
}
// --- sw.js was actually generated ---------------------------------------
const swPath = join(BUILD_DIR, "sw.js");
let swSrc = "";
try {
swSrc = readFileSync(swPath, "utf8");
} catch {
fail(`${swPath} not found — did the PWA plugin run?`);
process.exit(1);
}
// --- C1: some built client chunk actually registers it -------------------
const appDir = join(BUILD_DIR, "_app");
const jsFiles = walkJsFiles(appDir);
const registersSW = jsFiles.some((f) => {
const src = readFileSync(f, "utf8");
return src.includes("serviceWorker") && src.includes("sw.js");
});
if (!registersSW) {
fail(
`No built JS chunk under ${appDir} registers the service worker ` +
'(expected a "serviceWorker" + "sw.js" reference reachable from the ' +
"virtual:pwa-register import in +layout.svelte).",
);
}
// --- H1: precached audio entries carry the resolved base path -----------
const base = resolveBase();
const audioUrls = [...swSrc.matchAll(/"([^"]*\/audio\/[^"]*\.mp3)"/g)].map(
(m) => m[1],
);
if (audioUrls.length === 0) {
fail(`${swPath} has no precached audio entries — expected the default voice's clips.`);
} else {
const badUrls = audioUrls.filter((u) => !u.startsWith(`${base}/audio/`));
if (badUrls.length > 0) {
fail(
`${badUrls.length}/${audioUrls.length} precached audio URL(s) don't ` +
`start with "${base}/audio/" (resolved base "${base}") — e.g. "${badUrls[0]}". ` +
"additionalManifestEntries in vite.config.js and svelte.config.js's " +
"paths.base have drifted apart again.",
);
}
}
if (!ok) process.exit(1);
console.log(
`✓ PWA build check passed — base "${base}", ${jsFiles.length} client JS files, ` +
`${audioUrls.length} precached audio entries.`,
);