@joystyk/pwa 0.0.0 → 0.2.0

package/dist/offline/offline.css

@@ -0,0 +1,94 @@
+/* The offline page stands alone: it can't count on the site's inlined stylesheets, so it
+   carries the few Joystyk colors it needs. */
+:root {
+  color-scheme: light dark;
+  --surface: light-dark(oklch(98.5% 0.006 285), oklch(17% 0.02 285));
+  --text: light-dark(oklch(22% 0.03 285), oklch(94% 0.012 285));
+  --muted: color-mix(in oklch, var(--text) 68%, var(--surface));
+  --accent: light-dark(oklch(50% 0.2 285), oklch(76% 0.13 285));
+  --on-accent: light-dark(oklch(99% 0.005 285), oklch(18% 0.03 285));
+  --magenta: oklch(68% 0.25 350);
+}
+
+body {
+  margin: 0;
+  background: var(--surface);
+  color: var(--text);
+  font-family: system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif;
+  font-size: 1.0625rem;
+  line-height: 1.5;
+}
+
+main {
+  max-inline-size: 40rem;
+  margin-inline: auto;
+  padding: 2rem 1rem 3rem;
+}
+
+.kicker {
+  margin: 0;
+  font-weight: 800;
+  letter-spacing: 0.14em;
+  text-transform: uppercase;
+  color: var(--magenta);
+}
+
+h1 {
+  margin-block: 0.25rem 0.5rem;
+  font-size: clamp(1.9rem, 1.5rem + 2vw, 2.8rem);
+  line-height: 1.1;
+}
+
+h2 {
+  font-size: 1.25rem;
+  margin-block: 2rem 0.5rem;
+}
+
+.lede,
+#none {
+  color: var(--muted);
+}
+
+a {
+  color: var(--accent);
+}
+
+#games {
+  padding-inline-start: 1.25rem;
+}
+
+#games a {
+  display: inline-block;
+  min-block-size: 2.75rem;
+  padding-block: 0.6rem;
+  font-weight: 600;
+}
+
+.actions {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 1rem;
+  margin-block-start: 2rem;
+}
+
+button {
+  min-block-size: 2.75rem;
+  padding: 0.25rem 1.25rem;
+  border: 0;
+  border-radius: 999px;
+  background: var(--accent);
+  color: var(--on-accent);
+  font: inherit;
+  font-weight: 600;
+  cursor: pointer;
+}
+
+:focus-visible {
+  outline: 3px solid var(--accent);
+  outline-offset: 2px;
+}
+
+[hidden] {
+  display: none !important;
+}

package/dist/offline/offline.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/offline/offline.js

@@ -0,0 +1,26 @@
+import "../names.js";
+import { pinnedGames } from "../client/pinned.js";
+//#region src/offline/offline.ts
+var where = document.getElementById("where");
+var list = document.getElementById("games");
+var none = document.getElementById("none");
+if (where !== null && location.pathname !== "/offline") where.textContent = `This page (${decodeURI(location.pathname)}) isn't available offline. It needs an internet connection.`;
+document.getElementById("retry")?.addEventListener("click", () => location.reload());
+(async () => {
+	if (list === null || none === null || !("caches" in window)) return;
+	const games = await pinnedGames().catch(() => []);
+	for (const game of games) {
+		const item = document.createElement("li");
+		const link = document.createElement("a");
+		link.href = game.page;
+		link.textContent = game.name;
+		item.append(link);
+		list.append(item);
+	}
+	list.hidden = games.length === 0;
+	none.hidden = games.length > 0;
+})();
+//#endregion
+export {};
+
+//# sourceMappingURL=offline.js.map

package/dist/offline/offline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline.js","names":[],"sources":["../../src/offline/offline.ts"],"sourcesContent":["// The offline page's script: lists the games this device can play offline, read from the\n// pinned caches' own records. The worker serves this page, precached, for any page that\n// failed to load, so it also names the page that wasn't available.\nimport { OFFLINE_URL } from '../names.ts';\nimport { pinnedGames } from '../client/pinned.ts';\n\nconst where = document.getElementById('where');\nconst list = document.getElementById('games');\nconst none = document.getElementById('none');\n\nif (where !== null && location.pathname !== OFFLINE_URL) {\n  where.textContent = `This page (${decodeURI(location.pathname)}) isn't available offline. It needs an internet connection.`;\n}\n\ndocument.getElementById('retry')?.addEventListener('click', () => location.reload());\n\nvoid (async () => {\n  if (list === null || none === null || !('caches' in window)) return;\n  const games = await pinnedGames().catch(() => []);\n  for (const game of games) {\n    const item = document.createElement('li');\n    const link = document.createElement('a');\n    link.href = game.page;\n    link.textContent = game.name;\n    item.append(link);\n    list.append(item);\n  }\n  list.hidden = games.length === 0;\n  none.hidden = games.length > 0;\n})();\n"],"mappings":";;;AAMA,IAAM,QAAQ,SAAS,eAAe,OAAO;AAC7C,IAAM,OAAO,SAAS,eAAe,OAAO;AAC5C,IAAM,OAAO,SAAS,eAAe,MAAM;AAE3C,IAAI,UAAU,QAAQ,SAAS,aAAA,YAC7B,MAAM,cAAc,cAAc,UAAU,SAAS,QAAQ,EAAE;AAGjE,SAAS,eAAe,OAAO,CAAC,EAAE,iBAAiB,eAAe,SAAS,OAAO,CAAC;CAE7E,YAAY;CAChB,IAAI,SAAS,QAAQ,SAAS,QAAQ,EAAE,YAAY,SAAS;CAC7D,MAAM,QAAQ,MAAM,YAAY,CAAC,CAAC,YAAY,CAAC,CAAC;CAChD,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,OAAO,SAAS,cAAc,IAAI;EACxC,MAAM,OAAO,SAAS,cAAc,GAAG;EACvC,KAAK,OAAO,KAAK;EACjB,KAAK,cAAc,KAAK;EACxB,KAAK,OAAO,IAAI;EAChB,KAAK,OAAO,IAAI;CAClB;CACA,KAAK,SAAS,MAAM,WAAW;CAC/B,KAAK,SAAS,MAAM,SAAS;AAC/B,EAAA,CAAG"}

package/dist/offline-mark.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `html` with `data-offline` on its <html> tag. A document without an <html> tag, or already
+ * marked, comes back unchanged. Only the tag changes: no script or style is added, so the
+ * page's Content-Security-Policy hashes still hold.
+ */
+export declare const markOfflineHtml: (html: string) => string;
+/** Render pin-derived labels before first paint, so hydration need not grow every
+ * catalog card and lineup row. Raw text and executable content keep their bytes. */
+export declare const markOfflineAvailability: (html: string, pinned: readonly string[]) => string;
+/**
+ * A cached page, marked as served offline. Status and headers carry over, except
+ * Content-Length, which no longer fits the body; anything that isn't an HTML document comes
+ * back as it is.
+ */
+export declare const markOfflineResponse: (response: Response, pinned?: readonly string[]) => Promise<Response>;

package/dist/offline-mark.js

@@ -0,0 +1,51 @@
+import { OFFLINE_ATTRIBUTE } from "./names.js";
+import { isGameId } from "@joystyk/contracts";
+//#region src/offline-mark.ts
+/** The <html> start tag: `<html` followed by whitespace, `>` or `/`. Never `<!doctype html>`. */
+var HTML_TAG = /<html(?=[\s/>])[^>]*>/i;
+var MARKED = new RegExp(`\\s${OFFLINE_ATTRIBUTE}(?=[\\s=/>])`, "i");
+/**
+* `html` with `data-offline` on its <html> tag. A document without an <html> tag, or already
+* marked, comes back unchanged. Only the tag changes: no script or style is added, so the
+* page's Content-Security-Policy hashes still hold.
+*/
+var markOfflineHtml = (html) => {
+	const match = HTML_TAG.exec(html);
+	if (match === null || MARKED.test(match[0])) return html;
+	const at = match.index + 5;
+	return `${html.slice(0, at)} ${OFFLINE_ATTRIBUTE}${html.slice(at)}`;
+};
+/** Render pin-derived labels before first paint, so hydration need not grow every
+* catalog card and lineup row. Raw text and executable content keep their bytes. */
+var markOfflineAvailability = (html, pinned) => {
+	const ids = new Set(pinned);
+	return html.replace(/<!--[\s\S]*?-->|<(script|style|textarea|title|xmp)\b[^>]*>[\s\S]*?<\/\1\s*>|<jy-offline-availability\b[^>]*>[\s\S]*?<\/jy-offline-availability\s*>/gi, (element) => {
+		if (!/^<jy-offline-availability\b/i.test(element)) return element;
+		const id = /\s+game-id\s*=\s*(?:"([^"]*)"|'([^']*)')/i.exec(element);
+		const game = id?.[1] ?? id?.[2];
+		if (!isGameId(game)) return element;
+		const available = ids.has(game);
+		return `<jy-offline-availability game-id="${game}" data-available="${String(available)}">${available ? "Available offline" : "Unavailable offline"}</jy-offline-availability>`;
+	});
+};
+/** Whether a response is an HTML document, by its Content-Type. */
+var isHtml = (response) => /^\s*text\/html\b/i.test(response.headers.get("content-type") ?? "");
+/**
+* A cached page, marked as served offline. Status and headers carry over, except
+* Content-Length, which no longer fits the body; anything that isn't an HTML document comes
+* back as it is.
+*/
+var markOfflineResponse = async (response, pinned = []) => {
+	if (!isHtml(response) || response.body === null) return response;
+	const headers = new Headers(response.headers);
+	headers.delete("content-length");
+	return new Response(markOfflineAvailability(markOfflineHtml(await response.text()), pinned), {
+		status: response.status,
+		statusText: response.statusText,
+		headers
+	});
+};
+//#endregion
+export { markOfflineAvailability, markOfflineHtml, markOfflineResponse };
+
+//# sourceMappingURL=offline-mark.js.map

package/dist/offline-mark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-mark.js","names":[],"sources":["../src/offline-mark.ts"],"sourcesContent":["// Marking pages served offline (offline-and-updates.md, \"Pages served offline\"). When the\n// network fails and the worker answers a page from a cache, it adds `data-offline` to the\n// page's <html> tag, so the document's own CSS can lay the page out for offline from the first\n// paint: @joystyk/ui's tokens.css collapses every <ad-slot> under `:root[data-offline]` until\n// the slot hears the browser is online. Pure, so it is tested in Node; sw/sw.ts applies it.\nimport { OFFLINE_ATTRIBUTE } from './names.ts';\nimport { isGameId } from '@joystyk/contracts';\n\n/** The <html> start tag: `<html` followed by whitespace, `>` or `/`. Never `<!doctype html>`. */\nconst HTML_TAG = /<html(?=[\\s/>])[^>]*>/i;\nconst MARKED = new RegExp(`\\\\s${OFFLINE_ATTRIBUTE}(?=[\\\\s=/>])`, 'i');\n\n/**\n * `html` with `data-offline` on its <html> tag. A document without an <html> tag, or already\n * marked, comes back unchanged. Only the tag changes: no script or style is added, so the\n * page's Content-Security-Policy hashes still hold.\n */\nexport const markOfflineHtml = (html: string): string => {\n  const match = HTML_TAG.exec(html);\n  if (match === null || MARKED.test(match[0])) return html;\n  const at = match.index + '<html'.length;\n  return `${html.slice(0, at)} ${OFFLINE_ATTRIBUTE}${html.slice(at)}`;\n};\n\n/** Render pin-derived labels before first paint, so hydration need not grow every\n * catalog card and lineup row. Raw text and executable content keep their bytes. */\nexport const markOfflineAvailability = (html: string, pinned: readonly string[]): string => {\n  const ids = new Set(pinned);\n  return html.replace(\n    /<!--[\\s\\S]*?-->|<(script|style|textarea|title|xmp)\\b[^>]*>[\\s\\S]*?<\\/\\1\\s*>|<jy-offline-availability\\b[^>]*>[\\s\\S]*?<\\/jy-offline-availability\\s*>/gi,\n    (element) => {\n      if (!/^<jy-offline-availability\\b/i.test(element)) return element;\n      const id = /\\s+game-id\\s*=\\s*(?:\"([^\"]*)\"|'([^']*)')/i.exec(element);\n      const game = id?.[1] ?? id?.[2];\n      if (!isGameId(game)) return element;\n      const available = ids.has(game);\n      return `<jy-offline-availability game-id=\"${game}\" data-available=\"${String(available)}\">${available ? 'Available offline' : 'Unavailable offline'}</jy-offline-availability>`;\n    },\n  );\n};\n\n/** Whether a response is an HTML document, by its Content-Type. */\nconst isHtml = (response: Response): boolean => /^\\s*text\\/html\\b/i.test(response.headers.get('content-type') ?? '');\n\n/**\n * A cached page, marked as served offline. Status and headers carry over, except\n * Content-Length, which no longer fits the body; anything that isn't an HTML document comes\n * back as it is.\n */\nexport const markOfflineResponse = async (response: Response, pinned: readonly string[] = []): Promise<Response> => {\n  if (!isHtml(response) || response.body === null) return response;\n  const headers = new Headers(response.headers);\n  headers.delete('content-length');\n  return new Response(markOfflineAvailability(markOfflineHtml(await response.text()), pinned), {\n    status: response.status,\n    statusText: response.statusText,\n    headers,\n  });\n};\n"],"mappings":";;;;AASA,IAAM,WAAW;AACjB,IAAM,SAAS,IAAI,OAAO,MAAM,kBAAkB,eAAe,GAAG;;;;;;AAOpE,IAAa,mBAAmB,SAAyB;CACvD,MAAM,QAAQ,SAAS,KAAK,IAAI;CAChC,IAAI,UAAU,QAAQ,OAAO,KAAK,MAAM,EAAE,GAAG,OAAO;CACpD,MAAM,KAAK,MAAM,QAAQ;CACzB,OAAO,GAAG,KAAK,MAAM,GAAG,EAAE,EAAE,GAAG,oBAAoB,KAAK,MAAM,EAAE;AAClE;;;AAIA,IAAa,2BAA2B,MAAc,WAAsC;CAC1F,MAAM,MAAM,IAAI,IAAI,MAAM;CAC1B,OAAO,KAAK,QACV,yJACC,YAAY;EACX,IAAI,CAAC,+BAA+B,KAAK,OAAO,GAAG,OAAO;EAC1D,MAAM,KAAK,4CAA4C,KAAK,OAAO;EACnE,MAAM,OAAO,KAAK,MAAM,KAAK;EAC7B,IAAI,CAAC,SAAS,IAAI,GAAG,OAAO;EAC5B,MAAM,YAAY,IAAI,IAAI,IAAI;EAC9B,OAAO,qCAAqC,KAAK,oBAAoB,OAAO,SAAS,EAAE,IAAI,YAAY,sBAAsB,sBAAsB;CACrJ,CACF;AACF;;AAGA,IAAM,UAAU,aAAgC,oBAAoB,KAAK,SAAS,QAAQ,IAAI,cAAc,KAAK,EAAE;;;;;;AAOnH,IAAa,sBAAsB,OAAO,UAAoB,SAA4B,CAAC,MAAyB;CAClH,IAAI,CAAC,OAAO,QAAQ,KAAK,SAAS,SAAS,MAAM,OAAO;CACxD,MAAM,UAAU,IAAI,QAAQ,SAAS,OAAO;CAC5C,QAAQ,OAAO,gBAAgB;CAC/B,OAAO,IAAI,SAAS,wBAAwB,gBAAgB,MAAM,SAAS,KAAK,CAAC,GAAG,MAAM,GAAG;EAC3F,QAAQ,SAAS;EACjB,YAAY,SAAS;EACrB;CACF,CAAC;AACH"}

package/dist/pin-record.d.ts

@@ -0,0 +1,14 @@
+export type PinRecord = {
+    readonly id: string;
+    readonly name: string;
+    /** The game build the cache holds. */
+    readonly version: string;
+    /** The platform release that built it. */
+    readonly release: string;
+    readonly page: string;
+    /** Where the asset manifest came from (the game manifest's `assets`). */
+    readonly assets: string;
+    readonly totalBytes: number;
+};
+export declare const PinRecordSchema: import("@joystyk/contracts").Validator<PinRecord>;
+export declare const parsePinRecord: (value: unknown) => PinRecord | null;

package/dist/pin-record.js

@@ -0,0 +1,36 @@
+import { decodeSync, isPath, isRecord, validator } from "./validate.js";
+import { isGameId } from "@joystyk/contracts";
+//#region src/pin-record.ts
+var PinRecordSchema = validator((value, issues) => {
+	if (!isRecord(value)) {
+		issues.push("Expected an object");
+		return;
+	}
+	const { id, name, version, release, page, assets, totalBytes } = value;
+	if (!isGameId(id)) issues.push("id: expected a kebab-case game id");
+	for (const [key, field] of [
+		["name", name],
+		["version", version],
+		["release", release]
+	]) if (typeof field !== "string" || field === "") issues.push(`${key}: expected text`);
+	if (!isPath(page)) issues.push("page: expected a site path");
+	if (!isPath(assets)) issues.push("assets: expected a site path");
+	if (typeof totalBytes !== "number" || !Number.isInteger(totalBytes) || totalBytes < 0) issues.push("totalBytes: expected a whole number");
+	return issues.length === 0 ? value : void 0;
+});
+var parsePinRecord = (value) => {
+	const record = decodeSync(PinRecordSchema, value);
+	return record === null ? null : {
+		id: record.id,
+		name: record.name,
+		version: record.version,
+		release: record.release,
+		page: record.page,
+		assets: record.assets,
+		totalBytes: record.totalBytes
+	};
+};
+//#endregion
+export { PinRecordSchema, parsePinRecord };
+
+//# sourceMappingURL=pin-record.js.map

package/dist/pin-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pin-record.js","names":[],"sources":["../src/pin-record.ts"],"sourcesContent":["// What a pinned cache keeps beside the files, at PIN_RECORD_PATH: enough to list the pin on\n// the offline page, refresh it and remove it. Read back from Cache Storage, so decoded.\nimport { isGameId } from '@joystyk/contracts';\nimport { decodeSync, isPath, isRecord, validator } from './validate.ts';\n\nexport type PinRecord = {\n  readonly id: string;\n  readonly name: string;\n  /** The game build the cache holds. */\n  readonly version: string;\n  /** The platform release that built it. */\n  readonly release: string;\n  readonly page: string;\n  /** Where the asset manifest came from (the game manifest's `assets`). */\n  readonly assets: string;\n  readonly totalBytes: number;\n};\n\nexport const PinRecordSchema = validator<PinRecord>((value, issues) => {\n  if (!isRecord(value)) {\n    issues.push('Expected an object');\n    return undefined;\n  }\n  const { id, name, version, release, page, assets, totalBytes } = value;\n  if (!isGameId(id)) issues.push('id: expected a kebab-case game id');\n  for (const [key, field] of [\n    ['name', name],\n    ['version', version],\n    ['release', release],\n  ] as const) {\n    if (typeof field !== 'string' || field === '') issues.push(`${key}: expected text`);\n  }\n  if (!isPath(page)) issues.push('page: expected a site path');\n  if (!isPath(assets)) issues.push('assets: expected a site path');\n  if (typeof totalBytes !== 'number' || !Number.isInteger(totalBytes) || totalBytes < 0)\n    issues.push('totalBytes: expected a whole number');\n  return issues.length === 0 ? (value as PinRecord) : undefined;\n});\n\nexport const parsePinRecord = (value: unknown): PinRecord | null => {\n  const record = decodeSync(PinRecordSchema, value);\n  return record === null\n    ? null\n    : {\n        id: record.id,\n        name: record.name,\n        version: record.version,\n        release: record.release,\n        page: record.page,\n        assets: record.assets,\n        totalBytes: record.totalBytes,\n      };\n};\n"],"mappings":";;;AAkBA,IAAa,kBAAkB,WAAsB,OAAO,WAAW;CACrE,IAAI,CAAC,SAAS,KAAK,GAAG;EACpB,OAAO,KAAK,oBAAoB;EAChC;CACF;CACA,MAAM,EAAE,IAAI,MAAM,SAAS,SAAS,MAAM,QAAQ,eAAe;CACjE,IAAI,CAAC,SAAS,EAAE,GAAG,OAAO,KAAK,mCAAmC;CAClE,KAAK,MAAM,CAAC,KAAK,UAAU;EACzB,CAAC,QAAQ,IAAI;EACb,CAAC,WAAW,OAAO;EACnB,CAAC,WAAW,OAAO;CACrB,GACE,IAAI,OAAO,UAAU,YAAY,UAAU,IAAI,OAAO,KAAK,GAAG,IAAI,gBAAgB;CAEpF,IAAI,CAAC,OAAO,IAAI,GAAG,OAAO,KAAK,4BAA4B;CAC3D,IAAI,CAAC,OAAO,MAAM,GAAG,OAAO,KAAK,8BAA8B;CAC/D,IAAI,OAAO,eAAe,YAAY,CAAC,OAAO,UAAU,UAAU,KAAK,aAAa,GAClF,OAAO,KAAK,qCAAqC;CACnD,OAAO,OAAO,WAAW,IAAK,QAAsB,KAAA;AACtD,CAAC;AAED,IAAa,kBAAkB,UAAqC;CAClE,MAAM,SAAS,WAAW,iBAAiB,KAAK;CAChD,OAAO,WAAW,OACd,OACA;EACE,IAAI,OAAO;EACX,MAAM,OAAO;EACb,SAAS,OAAO;EAChB,SAAS,OAAO;EAChB,MAAM,OAAO;EACb,QAAQ,OAAO;EACf,YAAY,OAAO;CACrB;AACN"}

package/dist/preloads.d.ts

@@ -0,0 +1,2 @@
+export declare const withoutModulePreloads: (html: string) => string;
+export declare const withoutPreloadResponse: (response: Response) => Promise<Response>;

package/dist/preloads.js

@@ -0,0 +1,26 @@
+//#region src/preloads.ts
+/** Remove document preloads before a service-worker response reaches the HTML parser.
+* A controlled page imports through its worker; cross-world preload hints can fetch the
+* same modules twice. Scripts, stylesheet links and CSP-hashed inline content stay intact.
+*/
+var modulePreloadLink = (tag) => {
+	if (!/^<link\b/i.test(tag)) return false;
+	const attributes = tag.matchAll(/\s+([^\s="'<>/]+)(?:\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s"'=<>`]+)))?/g);
+	for (const attribute of attributes) if (attribute[1]?.toLowerCase() === "rel") return (attribute[2] ?? attribute[3] ?? attribute[4] ?? "").toLowerCase().split(/\s+/).includes("modulepreload");
+	return false;
+};
+var withoutModulePreloads = (html) => html.replace(/<!--[\s\S]*?-->|<(script|style|textarea|title|xmp)\b[^>]*>[\s\S]*?<\/\1\s*>|<link\b[^>]*>/gi, (tag) => modulePreloadLink(tag) ? "" : tag);
+var withoutPreloadResponse = async (response) => {
+	if (response.body === null || !/^\s*text\/html\b/i.test(response.headers.get("content-type") ?? "")) return response;
+	const headers = new Headers(response.headers);
+	headers.delete("content-length");
+	return new Response(withoutModulePreloads(await response.text()), {
+		status: response.status,
+		statusText: response.statusText,
+		headers
+	});
+};
+//#endregion
+export { withoutModulePreloads, withoutPreloadResponse };
+
+//# sourceMappingURL=preloads.js.map

package/dist/preloads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preloads.js","names":[],"sources":["../src/preloads.ts"],"sourcesContent":["/** Remove document preloads before a service-worker response reaches the HTML parser.\n * A controlled page imports through its worker; cross-world preload hints can fetch the\n * same modules twice. Scripts, stylesheet links and CSP-hashed inline content stay intact.\n */\nconst modulePreloadLink = (tag: string): boolean => {\n  if (!/^<link\\b/i.test(tag)) return false;\n  const attributes = tag.matchAll(/\\s+([^\\s=\"'<>/]+)(?:\\s*=\\s*(?:\"([^\"]*)\"|'([^']*)'|([^\\s\"'=<>`]+)))?/g);\n  for (const attribute of attributes) {\n    if (attribute[1]?.toLowerCase() === 'rel') {\n      return (attribute[2] ?? attribute[3] ?? attribute[4] ?? '').toLowerCase().split(/\\s+/).includes('modulepreload');\n    }\n  }\n  return false;\n};\n\nexport const withoutModulePreloads = (html: string): string =>\n  html.replace(/<!--[\\s\\S]*?-->|<(script|style|textarea|title|xmp)\\b[^>]*>[\\s\\S]*?<\\/\\1\\s*>|<link\\b[^>]*>/gi, (tag) =>\n    modulePreloadLink(tag) ? '' : tag,\n  );\n\nexport const withoutPreloadResponse = async (response: Response): Promise<Response> => {\n  if (response.body === null || !/^\\s*text\\/html\\b/i.test(response.headers.get('content-type') ?? '')) return response;\n  const headers = new Headers(response.headers);\n  headers.delete('content-length');\n  return new Response(withoutModulePreloads(await response.text()), {\n    status: response.status,\n    statusText: response.statusText,\n    headers,\n  });\n};\n"],"mappings":";;;;;AAIA,IAAM,qBAAqB,QAAyB;CAClD,IAAI,CAAC,YAAY,KAAK,GAAG,GAAG,OAAO;CACnC,MAAM,aAAa,IAAI,SAAS,sEAAsE;CACtG,KAAK,MAAM,aAAa,YACtB,IAAI,UAAU,EAAE,EAAE,YAAY,MAAM,OAClC,QAAQ,UAAU,MAAM,UAAU,MAAM,UAAU,MAAM,GAAA,CAAI,YAAY,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,SAAS,eAAe;CAGnH,OAAO;AACT;AAEA,IAAa,yBAAyB,SACpC,KAAK,QAAQ,gGAAgG,QAC3G,kBAAkB,GAAG,IAAI,KAAK,GAChC;AAEF,IAAa,yBAAyB,OAAO,aAA0C;CACrF,IAAI,SAAS,SAAS,QAAQ,CAAC,oBAAoB,KAAK,SAAS,QAAQ,IAAI,cAAc,KAAK,EAAE,GAAG,OAAO;CAC5G,MAAM,UAAU,IAAI,QAAQ,SAAS,OAAO;CAC5C,QAAQ,OAAO,gBAAgB;CAC/B,OAAO,IAAI,SAAS,sBAAsB,MAAM,SAAS,KAAK,CAAC,GAAG;EAChE,QAAQ,SAAS;EACjB,YAAY,SAAS;EACrB;CACF,CAAC;AACH"}

package/dist/routing.d.ts

@@ -0,0 +1,57 @@
+import type { RecentKind } from './names.js';
+/** The hashed, immutable files the site serves (apps/site's assets volume). */
+export declare const ASSETS_PREFIX = "/assets/";
+/** The kind of a file by its extension: a Tier 2 kind, `font`, or null for anything else. */
+export declare const fileKind: (pathname: string) => RecentKind | "font" | null;
+/** Tier 2 budgets: entries per kind and their age limit. Least recently used goes first. */
+export declare const RECENT_LIMITS: Readonly<Record<RecentKind, {
+    readonly maxEntries: number;
+    readonly maxAgeSeconds: number;
+}>>;
+/** How the worker answers one request. */
+export type Route = 
+/** Not ours: cross-origin, not a GET, the worker's own files or the flag file. The network answers. */
+{
+    readonly _tag: 'Network';
+}
+/** A page. Network first, then a pinned copy, then the precached shell, then the offline page. */
+ | {
+    readonly _tag: 'Document';
+}
+/** Catalog data for client-side navigation. Network first, then a pinned copy. */
+ | {
+    readonly _tag: 'Api';
+}
+/** A hashed file. The precache, then the pinned caches, then this kind's Tier 2 cache. */
+ | {
+    readonly _tag: 'Asset';
+    readonly kind: RecentKind;
+}
+/** A hashed font or another file with no Tier 2 cache: the precache or a pin, else the network. */
+ | {
+    readonly _tag: 'Pinned';
+};
+export type RouteInput = {
+    readonly method: string;
+    /** Explicit revalidation (pin refreshes) must reach the network, bypassing Cache Storage. */
+    readonly cache?: RequestCache;
+    readonly pinRefresh?: boolean;
+    /** `Request.destination`: 'document' for navigations. */
+    readonly destination: string;
+    /** `Request.mode`: 'navigate' for navigations. */
+    readonly mode: string;
+    readonly url: URL;
+    /** The worker's origin. */
+    readonly origin: string;
+};
+export declare const routeFor: (request: RouteInput) => Route;
+/** Whether a page's updates may be offered now (Rule 2): only at a safe point, never in play. */
+export type PromptInput = {
+    /** A new worker is installed and waiting, or another tab already switched workers. */
+    readonly ready: boolean;
+    /** The launcher's last safe-point report; true on pages without a launcher. */
+    readonly safe: boolean;
+    /** The player chose "Later" for this update. */
+    readonly dismissed: boolean;
+};
+export declare const shouldOfferUpdate: (input: PromptInput) => boolean;

package/dist/routing.js

@@ -0,0 +1,81 @@
+//#region src/routing.ts
+/** The hashed, immutable files the site serves (apps/site's assets volume). */
+var ASSETS_PREFIX = "/assets/";
+var EXTENSION_KINDS = {
+	js: "code",
+	mjs: "code",
+	css: "code",
+	json: "code",
+	map: "code",
+	png: "art",
+	jpg: "art",
+	jpeg: "art",
+	webp: "art",
+	avif: "art",
+	gif: "art",
+	svg: "art",
+	ktx2: "art",
+	glb: "art",
+	gltf: "art",
+	mp3: "audio",
+	ogg: "audio",
+	opus: "audio",
+	wav: "audio",
+	m4a: "audio",
+	flac: "audio",
+	wasm: "wasm",
+	woff2: "font",
+	woff: "font"
+};
+/** The kind of a file by its extension: a Tier 2 kind, `font`, or null for anything else. */
+var fileKind = (pathname) => {
+	const dot = pathname.lastIndexOf(".");
+	if (dot === -1 || dot < pathname.lastIndexOf("/")) return null;
+	return EXTENSION_KINDS[pathname.slice(dot + 1).toLowerCase()] ?? null;
+};
+/** Tier 2 budgets: entries per kind and their age limit. Least recently used goes first. */
+var RECENT_LIMITS = {
+	code: {
+		maxEntries: 120,
+		maxAgeSeconds: 2592e3
+	},
+	art: {
+		maxEntries: 80,
+		maxAgeSeconds: 2592e3
+	},
+	audio: {
+		maxEntries: 40,
+		maxAgeSeconds: 2592e3
+	},
+	wasm: {
+		maxEntries: 6,
+		maxAgeSeconds: 2592e3
+	}
+};
+var NEVER_CACHED = /* @__PURE__ */ new Set([
+	"/sw.js",
+	"/pwa-control.json",
+	"/healthz"
+]);
+var routeFor = (request) => {
+	const { url } = request;
+	if (request.pinRefresh === true || request.mode !== "navigate" && request.cache === "no-cache") return { _tag: "Network" };
+	if (request.method !== "GET" || url.origin !== request.origin || NEVER_CACHED.has(url.pathname)) return { _tag: "Network" };
+	if (url.pathname === "/ws" || url.pathname === "/api/rooms" || url.pathname.startsWith("/api/rooms/")) return { _tag: "Network" };
+	if (url.pathname.startsWith("/api/ads/") || url.pathname.startsWith("/ads/")) return { _tag: "Network" };
+	if (request.mode === "navigate" || request.destination === "document") return { _tag: "Document" };
+	if (url.pathname === "/api/games" || url.pathname.startsWith("/api/games/")) return { _tag: "Api" };
+	if (url.pathname.startsWith("/assets/")) {
+		const kind = fileKind(url.pathname);
+		return kind === null || kind === "font" ? { _tag: "Pinned" } : {
+			_tag: "Asset",
+			kind
+		};
+	}
+	return { _tag: "Pinned" };
+};
+var shouldOfferUpdate = (input) => input.ready && input.safe && !input.dismissed;
+//#endregion
+export { ASSETS_PREFIX, RECENT_LIMITS, fileKind, routeFor, shouldOfferUpdate };
+
+//# sourceMappingURL=routing.js.map

package/dist/routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.js","names":[],"sources":["../src/routing.ts"],"sourcesContent":["// Which tier answers a request. Pure, so the service worker's routing decisions are tested\n// in Node; sw/sw.ts wires each answer to a Workbox strategy.\nimport type { RecentKind } from './names.ts';\n\n/** The hashed, immutable files the site serves (apps/site's assets volume). */\nexport const ASSETS_PREFIX = '/assets/';\n\nconst EXTENSION_KINDS: Readonly<Record<string, RecentKind | 'font'>> = {\n  js: 'code',\n  mjs: 'code',\n  css: 'code',\n  json: 'code',\n  map: 'code',\n  png: 'art',\n  jpg: 'art',\n  jpeg: 'art',\n  webp: 'art',\n  avif: 'art',\n  gif: 'art',\n  svg: 'art',\n  ktx2: 'art',\n  glb: 'art',\n  gltf: 'art',\n  mp3: 'audio',\n  ogg: 'audio',\n  opus: 'audio',\n  wav: 'audio',\n  m4a: 'audio',\n  flac: 'audio',\n  wasm: 'wasm',\n  woff2: 'font',\n  woff: 'font',\n};\n\n/** The kind of a file by its extension: a Tier 2 kind, `font`, or null for anything else. */\nexport const fileKind = (pathname: string): RecentKind | 'font' | null => {\n  const dot = pathname.lastIndexOf('.');\n  if (dot === -1 || dot < pathname.lastIndexOf('/')) return null;\n  return EXTENSION_KINDS[pathname.slice(dot + 1).toLowerCase()] ?? null;\n};\n\n/** Tier 2 budgets: entries per kind and their age limit. Least recently used goes first. */\nexport const RECENT_LIMITS: Readonly<\n  Record<RecentKind, { readonly maxEntries: number; readonly maxAgeSeconds: number }>\n> = {\n  code: { maxEntries: 120, maxAgeSeconds: 30 * 24 * 60 * 60 },\n  art: { maxEntries: 80, maxAgeSeconds: 30 * 24 * 60 * 60 },\n  audio: { maxEntries: 40, maxAgeSeconds: 30 * 24 * 60 * 60 },\n  wasm: { maxEntries: 6, maxAgeSeconds: 30 * 24 * 60 * 60 },\n};\n\n/** How the worker answers one request. */\nexport type Route =\n  /** Not ours: cross-origin, not a GET, the worker's own files or the flag file. The network answers. */\n  | { readonly _tag: 'Network' }\n  /** A page. Network first, then a pinned copy, then the precached shell, then the offline page. */\n  | { readonly _tag: 'Document' }\n  /** Catalog data for client-side navigation. Network first, then a pinned copy. */\n  | { readonly _tag: 'Api' }\n  /** A hashed file. The precache, then the pinned caches, then this kind's Tier 2 cache. */\n  | { readonly _tag: 'Asset'; readonly kind: RecentKind }\n  /** A hashed font or another file with no Tier 2 cache: the precache or a pin, else the network. */\n  | { readonly _tag: 'Pinned' };\n\nexport type RouteInput = {\n  readonly method: string;\n  /** Explicit revalidation (pin refreshes) must reach the network, bypassing Cache Storage. */\n  readonly cache?: RequestCache;\n  readonly pinRefresh?: boolean;\n  /** `Request.destination`: 'document' for navigations. */\n  readonly destination: string;\n  /** `Request.mode`: 'navigate' for navigations. */\n  readonly mode: string;\n  readonly url: URL;\n  /** The worker's origin. */\n  readonly origin: string;\n};\n\nconst NEVER_CACHED = new Set(['/sw.js', '/pwa-control.json', '/healthz']);\n\nexport const routeFor = (request: RouteInput): Route => {\n  const { url } = request;\n  if (request.pinRefresh === true || (request.mode !== 'navigate' && request.cache === 'no-cache'))\n    return { _tag: 'Network' };\n  if (request.method !== 'GET' || url.origin !== request.origin || NEVER_CACHED.has(url.pathname))\n    return { _tag: 'Network' };\n  // The room server (same host, routed by Traefik) answers live: never from a cache.\n  if (url.pathname === '/ws' || url.pathname === '/api/rooms' || url.pathname.startsWith('/api/rooms/'))\n    return { _tag: 'Network' };\n  // Ads (monetization.md): the slot answer stays fresh by its own short Cache-Control, the click\n  // notice and the beacon must reach the server to count, and a creative is only worth\n  // showing online (slots collapse offline). The worker keeps none of them.\n  if (url.pathname.startsWith('/api/ads/') || url.pathname.startsWith('/ads/')) return { _tag: 'Network' };\n  if (request.mode === 'navigate' || request.destination === 'document') return { _tag: 'Document' };\n  if (url.pathname === '/api/games' || url.pathname.startsWith('/api/games/')) return { _tag: 'Api' };\n  if (url.pathname.startsWith(ASSETS_PREFIX)) {\n    const kind = fileKind(url.pathname);\n    return kind === null || kind === 'font' ? { _tag: 'Pinned' } : { _tag: 'Asset', kind };\n  }\n  // Per-game asset lists, the web manifest, the favicon: whatever a pin or the precache holds.\n  return { _tag: 'Pinned' };\n};\n\n/** Whether a page's updates may be offered now (Rule 2): only at a safe point, never in play. */\nexport type PromptInput = {\n  /** A new worker is installed and waiting, or another tab already switched workers. */\n  readonly ready: boolean;\n  /** The launcher's last safe-point report; true on pages without a launcher. */\n  readonly safe: boolean;\n  /** The player chose \"Later\" for this update. */\n  readonly dismissed: boolean;\n};\n\nexport const shouldOfferUpdate = (input: PromptInput): boolean => input.ready && input.safe && !input.dismissed;\n"],"mappings":";;AAKA,IAAa,gBAAgB;AAE7B,IAAM,kBAAiE;CACrE,IAAI;CACJ,KAAK;CACL,KAAK;CACL,MAAM;CACN,KAAK;CACL,KAAK;CACL,KAAK;CACL,MAAM;CACN,MAAM;CACN,MAAM;CACN,KAAK;CACL,KAAK;CACL,MAAM;CACN,KAAK;CACL,MAAM;CACN,KAAK;CACL,KAAK;CACL,MAAM;CACN,KAAK;CACL,KAAK;CACL,MAAM;CACN,MAAM;CACN,OAAO;CACP,MAAM;AACR;;AAGA,IAAa,YAAY,aAAiD;CACxE,MAAM,MAAM,SAAS,YAAY,GAAG;CACpC,IAAI,QAAQ,MAAM,MAAM,SAAS,YAAY,GAAG,GAAG,OAAO;CAC1D,OAAO,gBAAgB,SAAS,MAAM,MAAM,CAAC,CAAC,CAAC,YAAY,MAAM;AACnE;;AAGA,IAAa,gBAET;CACF,MAAM;EAAE,YAAY;EAAK,eAAe;CAAkB;CAC1D,KAAK;EAAE,YAAY;EAAI,eAAe;CAAkB;CACxD,OAAO;EAAE,YAAY;EAAI,eAAe;CAAkB;CAC1D,MAAM;EAAE,YAAY;EAAG,eAAe;CAAkB;AAC1D;AA6BA,IAAM,+BAAe,IAAI,IAAI;CAAC;CAAU;CAAqB;AAAU,CAAC;AAExE,IAAa,YAAY,YAA+B;CACtD,MAAM,EAAE,QAAQ;CAChB,IAAI,QAAQ,eAAe,QAAS,QAAQ,SAAS,cAAc,QAAQ,UAAU,YACnF,OAAO,EAAE,MAAM,UAAU;CAC3B,IAAI,QAAQ,WAAW,SAAS,IAAI,WAAW,QAAQ,UAAU,aAAa,IAAI,IAAI,QAAQ,GAC5F,OAAO,EAAE,MAAM,UAAU;CAE3B,IAAI,IAAI,aAAa,SAAS,IAAI,aAAa,gBAAgB,IAAI,SAAS,WAAW,aAAa,GAClG,OAAO,EAAE,MAAM,UAAU;CAI3B,IAAI,IAAI,SAAS,WAAW,WAAW,KAAK,IAAI,SAAS,WAAW,OAAO,GAAG,OAAO,EAAE,MAAM,UAAU;CACvG,IAAI,QAAQ,SAAS,cAAc,QAAQ,gBAAgB,YAAY,OAAO,EAAE,MAAM,WAAW;CACjG,IAAI,IAAI,aAAa,gBAAgB,IAAI,SAAS,WAAW,aAAa,GAAG,OAAO,EAAE,MAAM,MAAM;CAClG,IAAI,IAAI,SAAS,WAAA,UAAwB,GAAG;EAC1C,MAAM,OAAO,SAAS,IAAI,QAAQ;EAClC,OAAO,SAAS,QAAQ,SAAS,SAAS,EAAE,MAAM,SAAS,IAAI;GAAE,MAAM;GAAS;EAAK;CACvF;CAEA,OAAO,EAAE,MAAM,SAAS;AAC1B;AAYA,IAAa,qBAAqB,UAAgC,MAAM,SAAS,MAAM,QAAQ,CAAC,MAAM"}

package/dist/sw/remove-sw.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/sw/remove-sw.js

@@ -0,0 +1,16 @@
+import { isPwaCache } from "../names.js";
+//#region src/sw/remove-sw.ts
+self.addEventListener("install", () => {
+	self.skipWaiting();
+});
+self.addEventListener("activate", (event) => {
+	event.waitUntil((async () => {
+		const names = (await caches.keys()).filter(isPwaCache);
+		await Promise.all(names.map((name) => caches.delete(name)));
+		await self.registration.unregister();
+	})());
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=remove-sw.js.map

package/dist/sw/remove-sw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-sw.js","names":[],"sources":["../../src/sw/remove-sw.ts"],"sourcesContent":["// The emergency worker (offline-and-updates.md, Rule 5). The build writes it as\n// `sw-remove.js` beside sw.js, and the site serves it as /sw.js while the kill switch is on.\n// The browser's own update check then replaces a broken worker on every device, even one too\n// broken to read the flag file: it activates at once, deletes the PWA's caches and\n// unregisters itself. Open pages keep running (a game in progress is never reloaded,\n// Rule 2); their next load comes straight from the network. Saves in IndexedDB are untouched.\nimport { isPwaCache } from '../names.ts';\n\ndeclare const self: ServiceWorkerGlobalScope;\n\nself.addEventListener('install', () => {\n  void self.skipWaiting();\n});\n\nself.addEventListener('activate', (event) => {\n  event.waitUntil(\n    (async () => {\n      const names = (await caches.keys()).filter(isPwaCache);\n      await Promise.all(names.map((name) => caches.delete(name)));\n      await self.registration.unregister();\n    })(),\n  );\n});\n"],"mappings":";;AAUA,KAAK,iBAAiB,iBAAiB;CACrC,KAAU,YAAY;AACxB,CAAC;AAED,KAAK,iBAAiB,aAAa,UAAU;CAC3C,MAAM,WACH,YAAY;EACX,MAAM,SAAS,MAAM,OAAO,KAAK,EAAA,CAAG,OAAO,UAAU;EACrD,MAAM,QAAQ,IAAI,MAAM,KAAK,SAAS,OAAO,OAAO,IAAI,CAAC,CAAC;EAC1D,MAAM,KAAK,aAAa,WAAW;CACrC,EAAA,CAAG,CACL;AACF,CAAC"}

package/dist/sw/sw.d.ts

@@ -0,0 +1 @@
+export {};