@teamscala/service-boot 0.23.520 → 0.23.522

package/package.json

@@ -37,9 +37,9 @@
     "valibot": "*"
   },
   "devDependencies": {
-    "@happy-dom/global-registrator": "20.14.5",
-    "@testing-library/react": "16.3.3",
-    "bun-types": "1.4.2"
+    "@happy-dom/global-registrator": "*",
+    "@testing-library/react": "*",
+    "bun-types": "*"
   },
   "exports": {
     "./agreement-gate": "./src/agreement-gate.ts",
@@ -124,6 +124,8 @@
     "./content-page-floor.ts": "./src/content-page-floor.ts",
     "./csrf-protection": "./src/csrf-protection.ts",
     "./csrf-protection.ts": "./src/csrf-protection.ts",
+    "./error-page-logo": "./src/error-page-logo.ts",
+    "./error-page-logo.ts": "./src/error-page-logo.ts",
     "./expand-roster": "./src/expand-roster.ts",
     "./expand-roster.ts": "./src/expand-roster.ts",
     "./gate-ttls": "./src/gate-ttls.ts",
@@ -300,5 +302,5 @@
   "repository": "https://github.com/teamgbg/service-boot",
   "sideEffects": false,
   "type": "module",
-  "version": "0.23.520"
+  "version": "0.23.522"
 }

package/src/agreement-gate/resolution-caches.ts

@@ -11,7 +11,7 @@
 import { getAppLogger } from "@teamscala/logger/app-loggers";
 import { queryRows } from "@teamscala/db/query-rows";
 import { createCache } from "@teamscala/cache/create-cache";
-import { registerCacheInvalidation } from "@teamscala/db/notify-listener/index";
+import { registerCacheInvalidation } from "@teamscala/db/notify-listener/cache-invalidation";
 
 /**
  * Cache for the page→agreement association (new-flow pages that have no

package/src/apply-logger-config.test.ts

@@ -4,7 +4,7 @@
  * ./apply-logger-config declares 1 runtime export(s) and 3 declared behaviour vector(s);
  * this suite asserts the import resolves, the runtime surface matches
  * exactly, and every export carries its declared kind. Regenerate from
- * inputs/bun-server-service-boot/api_smoke.json (scala-test-suites) — hand edits are
+ * inputs/server-service-boot-ts/api_smoke.json (scala-test-suites) — hand edits are
  * overwritten.
  */
 

package/src/bind-page-handler.ts

@@ -25,11 +25,8 @@ import { getAppLogger } from "@teamscala/logger/app-loggers";
 import { withGateEntryClears } from "./content-gate/gate-entry-clears.ts";
 import type { Context } from "hono";
 import { readHtmlTemplate } from "./read-html-template.ts";
-import {
-	PrimaryResourceMissingError,
-	buildResourceNotFoundResponse,
-	resolveErrorPageLogo,
-} from "./resource-not-found.ts";
+import { resolveErrorPageLogo } from "./error-page-logo.ts";
+import { PrimaryResourceMissingError, buildResourceNotFoundResponse } from "./resource-not-found.ts";
 import { extractOrgIdFromCallbackPath } from "./resolvers/portal-route-paths.ts";
 
 type PageHandler = (

package/src/error-page-logo.test.ts

@@ -0,0 +1,64 @@
+/**
+ * @status generated — ts-api-smoke template (scala-test-suites
+ * templates/ts_api_smoke.pkl @1.3.0) over the exports map of @teamscala/service-boot.
+ * ./error-page-logo declares 2 runtime export(s) and 6 declared behaviour vector(s);
+ * this suite asserts the import resolves, the runtime surface matches
+ * exactly, and every export carries its declared kind. Regenerate from
+ * inputs/server-service-boot-ts/api_smoke.json (scala-test-suites) — hand edits are
+ * overwritten.
+ */
+
+import { describe, expect, it } from "bun:test";
+
+const mod = await import("./error-page-logo");
+
+const { resolveErrorPageLogo, inlineLogoAsDataUri } = mod;
+const __requested: string[] = [];
+let __storageReached = false;
+
+describe("error-page-logo exports-map smoke", () => {
+	it("the runtime export set is exactly the declared surface", () => {
+		expect(Object.keys(mod).sort()).toEqual([
+			"inlineLogoAsDataUri",
+			"resolveErrorPageLogo",
+		]);
+	});
+	it("resolveErrorPageLogo is a function", () => {
+		expect(typeof mod["resolveErrorPageLogo"]).toBe("function");
+	});
+	it("inlineLogoAsDataUri is a function", () => {
+		expect(typeof mod["inlineLogoAsDataUri"]).toBe("function");
+	});
+	it("inlines a stored logo as a data URI, fetching the bucket key after the /api/assets/ prefix", async () => {
+		__requested.length = 0;
+		__storageReached = false;
+		const got = await inlineLogoAsDataUri("/api/assets/c503629a/logos/cropped.png", async () => ({ file(key) { __storageReached = true; __requested.push(key); return { stat: async () => ({}), arrayBuffer: async () => new Uint8Array([137, 80, 78, 71]).buffer }; } }));
+		expect(__storageReached).toBeTrue();
+		expect(__requested).toEqual(["c503629a/logos/cropped.png"]);
+		expect(got).toBe("data:image/png;base64,iVBORw==");
+	});
+	it("a stored value without the /api/assets/ prefix is refused before storage is touched", async () => {
+		__requested.length = 0;
+		__storageReached = false;
+		const got = await inlineLogoAsDataUri("https://cdn.example.com/logo.png", async () => { __storageReached = true; return null; });
+		expect(__storageReached).toBeFalse();
+		expect(__requested).toEqual([]);
+		expect(got).toBeNull();
+	});
+	it("an unavailable storage client returns null", async () => {
+		const got = await inlineLogoAsDataUri("/api/assets/org/logos/cropped.png", async () => null);
+		expect(got).toBeNull();
+	});
+	it("an oversized logo falls back to null instead of bloating the HTML", async () => {
+		const got = await inlineLogoAsDataUri("/api/assets/org/logos/huge.png", async () => ({ file() { return { stat: async () => ({}), arrayBuffer: async () => new ArrayBuffer(100 * 1024 + 1) }; } }));
+		expect(got).toBeNull();
+	});
+	it("an empty logo file falls back to null", async () => {
+		const got = await inlineLogoAsDataUri("/api/assets/org/logos/empty.png", async () => ({ file() { return { stat: async () => ({}), arrayBuffer: async () => new ArrayBuffer(0) }; } }));
+		expect(got).toBeNull();
+	});
+	it("the stored mime survives inlining — a .jpg key inlines as image/jpeg", async () => {
+		const got = await inlineLogoAsDataUri("/api/assets/org/logos/wordmark.jpg", async () => ({ file() { return { stat: async () => ({}), arrayBuffer: async () => new Uint8Array([255, 216, 255]).buffer }; } }));
+		expect(got).toBe("data:image/jpeg;base64,/9j/");
+	});
+});

package/src/error-page-logo.ts

@@ -0,0 +1,168 @@
+/**
+ * @system service-boot
+ * @status handwritten
+ * @edit edit directly
+ *
+ * The error/holding page's brand logo: resolve the host org's dark-theme
+ * wordmark from its install row and inline it as a data URI. Split from
+ * resource-not-found.ts under single-purpose-file (the builder consumes a
+ * logoUrl argument; only these resolvers touch storage and the registry).
+ *
+ * The host org's LOGO (wordmark) for the dark error page — the favicon is a
+ * tab glyph, the wrong asset at page scale (operator-observed: a lone "h"
+ * where the launcha wordmark belonged). Resolution: the service's own
+ * install row names its owner (brand_org); the org's dark-theme logo (a
+ * light-coloured mark, correct on the dark page) is preferred, light-theme
+ * second. Every step skew-tolerant: any miss → null → the builder renders a
+ * logo-less dark page.
+ *
+ * Returns the logo as an INLINE data URI (not a `/api/assets/` proxy URL) so
+ * the branded holding/error page ships the logo IN the initial HTML bytes —
+ * no second fetch, no post-paint pop-in, no dependency on the asset proxy the
+ * degraded service is failing to serve (incident 2026-07-27: the logo on a
+ * DEGRADED render-layer holding page appeared after the page painted). The
+ * logo sibling of icons-render-ssr-inline. Size-capped: a pathological
+ * (>MAX_INLINE_LOGO_BYTES) logo falls back to null rather than bloating the
+ * HTML; the page renders logo-less, never broken.
+ */
+
+import { getClient } from "@teamscala/object-storage/create/client/get-client";
+import { createCache } from "@teamscala/cache/create-cache";
+import { registerCacheInvalidation } from "@teamscala/db/notify-listener/cache-invalidation";
+import { getServerClient } from "@teamscala/orpc/server-client-registry";
+import { loadRegistryConfig } from "@teamscala/db/registry/load-config";
+import { getAppLogger } from "@teamscala/logger/app-loggers";
+import { ServiceInstallConfigSchema } from "./load-service-install-row.ts";
+
+const logoCache = createCache<string | null>("service-boot:error-page-logo", {
+	ttlMs: 5 * 60_000,
+	maxSize: 8,
+});
+
+export async function resolveErrorPageLogo(
+	serviceSlug: string,
+): Promise<string | null> {
+	return logoCache.fetchOrCompute(serviceSlug, async () => {
+		const log = getAppLogger();
+		try {
+			const cfg = await loadRegistryConfig(
+				"service_install",
+				serviceSlug,
+				ServiceInstallConfigSchema,
+			);
+			const org = (cfg as { brand_org?: string }).brand_org;
+			if (!org) {
+				log.warn(`[brand-logo:${serviceSlug}] no brand_org configured`);
+				return null;
+			}
+			const prisma = (await getServerClient()) as {
+				organisation_profile?: {
+					findFirst?: (a: unknown) => Promise<unknown>;
+				};
+			};
+			const row = (await prisma.organisation_profile?.findFirst?.({
+				where: { id: org },
+				select: {
+					company_logo_for_dark_theme: true,
+					company_logo_for_light_theme: true,
+				},
+			})) as {
+				company_logo_for_dark_theme?: string | null;
+				company_logo_for_light_theme?: string | null;
+			} | null;
+			const stored =
+				row?.company_logo_for_dark_theme ||
+				row?.company_logo_for_light_theme ||
+				null;
+			if (!stored) {
+				log.error(`[brand-logo:${serviceSlug}] organization ${org} has no logo configured`);
+				return null;
+			}
+			const logo = await inlineLogoAsDataUri(stored);
+			if (!logo) {
+				log.error(`[brand-logo:${serviceSlug}] failed to load logo`, {
+					organizationId: org,
+					storedPath: stored,
+				});
+			}
+			return logo;
+		} catch (error) {
+			log.error(`[brand-logo:${serviceSlug}] failed to resolve organization logo`, {
+				error: error instanceof Error ? error.message : String(error),
+			});
+			return null;
+		}
+	});
+}
+
+/** Above this byte size, inlining bloats the HTML more than it helps — fall
+ * back to a logo-less page. Typical org logos are 5–30 KB, so this only
+ * catches a genuinely oversized upload. */
+const MAX_INLINE_LOGO_BYTES = 100 * 1024;
+
+const ASSETS_PREFIX = "/api/assets/";
+
+/**
+ * Inline a stored logo value as a `data:<mime>;base64,…` URI by fetching its
+ * bytes from S3 (the same store `/api/assets/` proxies to). The stored value
+ * IS the servable form — `/api/assets/<key>` — so the bucket key is the path
+ * segment after that prefix (single-logo-pathway). Skew-tolerant: any miss →
+ * null.
+ */
+type LogoStorage = {
+	file(key: string): {
+		stat(): Promise<unknown>;
+		arrayBuffer(): Promise<ArrayBuffer>;
+	};
+};
+
+export async function inlineLogoAsDataUri(
+	stored: string,
+	getStorage: () => Promise<LogoStorage | null> = getClient as unknown as () => Promise<LogoStorage | null>,
+): Promise<string | null> {
+	try {
+		if (!stored.startsWith(ASSETS_PREFIX)) return null;
+		const key = decodeURIComponent(stored.slice(ASSETS_PREFIX.length));
+		const s3 = await getStorage();
+		if (!s3) return null;
+		const file = s3.file(key);
+		await file.stat();
+		const bytes = await file.arrayBuffer();
+		if (bytes.byteLength === 0 || bytes.byteLength > MAX_INLINE_LOGO_BYTES) {
+			return null;
+		}
+		const mime = mimeFromKey(key) ?? "image/png";
+		const base64 = Buffer.from(bytes).toString("base64");
+		return `data:${mime};base64,${base64}`;
+	} catch {
+		return null;
+	}
+}
+
+function mimeFromKey(key: string): string | null {
+	const ext = key.split(".").pop()?.toLowerCase();
+	switch (ext) {
+		case "png":
+			return "image/png";
+		case "jpg":
+		case "jpeg":
+			return "image/jpeg";
+		case "webp":
+			return "image/webp";
+		case "gif":
+			return "image/gif";
+		case "svg":
+			return "image/svg+xml";
+		case "avif":
+			return "image/avif";
+		default:
+			return null;
+	}
+}
+
+// Shares the one process-wide LISTEN connection rather than opening its own:
+// `createNotifyListener` is a factory, so a module-scope call holds a
+// connection for the process lifetime (see resolution-caches.ts).
+registerCacheInvalidation(() => {
+	logoCache.clear();
+});

package/src/page-server-loader-graph.test.ts

@@ -4,7 +4,7 @@
  * ./page-server-loader-graph declares 1 runtime export(s) and 1 declared behaviour vector(s);
  * this suite asserts the import resolves, the runtime surface matches
  * exactly, and every export carries its declared kind. Regenerate from
- * inputs/bun-server-service-boot/api_smoke.json (scala-test-suites) — hand edits are
+ * inputs/server-service-boot-ts/api_smoke.json (scala-test-suites) — hand edits are
  * overwritten.
  */
 

package/src/register-registry-page-route/meta-title.test.ts

@@ -4,7 +4,7 @@
  * ./meta-title declares 3 runtime export(s) and 4 declared behaviour vector(s);
  * this suite asserts the import resolves, the runtime surface matches
  * exactly, and every export carries its declared kind. Regenerate from
- * inputs/bun-server-service-boot/api_smoke.json (scala-test-suites) — hand edits are
+ * inputs/server-service-boot-ts/api_smoke.json (scala-test-suites) — hand edits are
  * overwritten.
  */
 

package/src/resolve-brand-favicon.test.ts

@@ -4,7 +4,7 @@
  * ./resolve-brand-favicon declares 2 runtime export(s) and 5 declared behaviour vector(s);
  * this suite asserts the import resolves, the runtime surface matches
  * exactly, and every export carries its declared kind. Regenerate from
- * inputs/bun-server-service-boot/api_smoke.json (scala-test-suites) — hand edits are
+ * inputs/server-service-boot-ts/api_smoke.json (scala-test-suites) — hand edits are
  * overwritten.
  */
 

package/src/resolve-theme-mode.test.ts

@@ -4,7 +4,7 @@
  * ./resolve-theme-mode declares 1 runtime export(s) + 1 type(s) and 5 declared behaviour vector(s);
  * this suite asserts the import resolves, the runtime surface matches
  * exactly, and every export carries its declared kind. Regenerate from
- * inputs/bun-server-service-boot/api_smoke.json (scala-test-suites) — hand edits are
+ * inputs/server-service-boot-ts/api_smoke.json (scala-test-suites) — hand edits are
  * overwritten.
  */
 

package/src/resolvers/fetch-org-brand.test.ts

@@ -4,7 +4,7 @@
  * ./fetch-org-brand declares 1 runtime export(s) and 4 declared behaviour vector(s);
  * this suite asserts the import resolves, the runtime surface matches
  * exactly, and every export carries its declared kind. Regenerate from
- * inputs/bun-server-service-boot/api_smoke.json (scala-test-suites) — hand edits are
+ * inputs/server-service-boot-ts/api_smoke.json (scala-test-suites) — hand edits are
  * overwritten.
  */
 

package/src/resolvers/website-by-host-map.test.ts

@@ -4,7 +4,7 @@
  * ./website-by-host-map declares 1 runtime export(s) and 7 declared behaviour vector(s);
  * this suite asserts the import resolves, the runtime surface matches
  * exactly, and every export carries its declared kind. Regenerate from
- * inputs/bun-server-service-boot/api_smoke.json (scala-test-suites) — hand edits are
+ * inputs/server-service-boot-ts/api_smoke.json (scala-test-suites) — hand edits are
  * overwritten.
  */
 

package/src/resource-not-found.test.ts

@@ -8,11 +8,8 @@
 // with it into the band.
 
 import { describe, expect, it } from "bun:test";
-import {
-	PrimaryResourceMissingError,
-	buildResourceNotFoundResponse,
-	inlineLogoAsDataUri,
-} from "./resource-not-found.ts";
+import { inlineLogoAsDataUri } from "./error-page-logo.ts";
+import { PrimaryResourceMissingError, buildResourceNotFoundResponse } from "./resource-not-found.ts";
 import { buildWakingPageHtml } from "@teamscala/os/brand/waking-page-html";
 
 describe("PrimaryResourceMissingError", () => {
@@ -54,24 +51,6 @@ describe("buildResourceNotFoundResponse", () => {
 		expect(logo).toBe("data:image/png;base64,iVBORw==");
 	});
 
-	it("passes the resolved logo to the waking page instead of its placeholder", async () => {
-		const logo = await inlineLogoAsDataUri(
-			"/api/assets/c503629a/logos/cropped.png",
-			async () => ({
-				file() {
-					return {
-						stat: async () => ({}),
-						arrayBuffer: async () => new Uint8Array([137, 80, 78, 71]).buffer,
-					};
-				},
-			}),
-		);
-		const html = buildWakingPageHtml({ logoUrl: logo });
-		expect(logo).toStartWith("data:image/png;base64,");
-		expect(html).toContain('<img src="data:image/png;base64,iVBORw=="');
-		expect(html).not.toContain('class="uif-logo-loading-pulse" aria-hidden="true"');
-	});
-
 	it("returns a 404 Response for a dead link", () => {
 		const res = buildResourceNotFoundResponse("project");
 		expect(res).toBeInstanceOf(Response);

package/src/resource-not-found.ts

@@ -3,10 +3,10 @@
  * @status handwritten
  * @edit edit directly
  *
- * One cohesive unit — the branded resource-not-found / holding page: the
- * PrimaryResourceMissingError trigger, the org-logo resolver the page
- * renders, and the HTML builder are tightly coupled (the builder consumes
- * the logo; the error drives the page) and cannot be split without churn.
+ * One cohesive unit — the branded resource-not-found / holding page FLOOR:
+ * the PrimaryResourceMissingError trigger and the HTML builder (the builder
+ * consumes a logoUrl argument; the org-logo resolvers live in
+ * error-page-logo.ts).
  *
  * Branded 404 for registry page routes whose PRIMARY resource is missing.
  *
@@ -27,33 +27,7 @@
  * floor that must always exist.
  */
 
-/**
- * The host org's LOGO (wordmark) for the dark error page — the favicon is a
- * tab glyph, the wrong asset at page scale (operator-observed: a lone "h"
- * where the launcha wordmark belonged). Resolution: the service's own
- * install row names its owner (brand_org); the org's dark-theme logo (a
- * light-coloured mark, correct on the dark page) is preferred, light-theme
- * second. Every step skew-tolerant: any miss → null → the builder renders a
- * logo-less dark page.
- *
- * Returns the logo as an INLINE data URI (not a `/api/assets/` proxy URL) so
- * the branded holding/error page ships the logo IN the initial HTML bytes —
- * no second fetch, no post-paint pop-in, no dependency on the asset proxy the
- * degraded service is failing to serve (incident 2026-07-27: the logo on a
- * DEGRADED render-layer holding page appeared after the page painted). The
- * logo sibling of icons-render-ssr-inline. Size-capped: a pathological
- * (>MAX_INLINE_LOGO_BYTES) logo falls back to null rather than bloating the
- * HTML; the page renders logo-less, never broken.
- */
-
-import { getClient } from "@teamscala/object-storage/create/client/get-client";
-import { createCache } from "@teamscala/cache/create-cache";
-import { registerCacheInvalidation } from "@teamscala/db/notify-listener/index";
-import { getServerClient } from "@teamscala/orpc/server-client-registry";
-import { loadRegistryConfig } from "@teamscala/db/registry/load-config";
-import { getAppLogger } from "@teamscala/logger/app-loggers";
 import { brandLogoImgTag } from "@teamscala/os/brand/brand-logo-img-tag";
-import { ServiceInstallConfigSchema } from "./load-service-install-row.ts";
 
 const RESOURCE_LABELS: Record<string, string> = {
 	proposal: "proposal",
@@ -63,132 +37,6 @@ const RESOURCE_LABELS: Record<string, string> = {
 	agent: "assistant",
 };
 
-const logoCache = createCache<string | null>("service-boot:error-page-logo", {
-	ttlMs: 5 * 60_000,
-	maxSize: 8,
-});
-
-export async function resolveErrorPageLogo(
-	serviceSlug: string,
-): Promise<string | null> {
-	return logoCache.fetchOrCompute(serviceSlug, async () => {
-		const log = getAppLogger();
-		try {
-			const cfg = await loadRegistryConfig(
-				"service_install",
-				serviceSlug,
-				ServiceInstallConfigSchema,
-			);
-			const org = (cfg as { brand_org?: string }).brand_org;
-			if (!org) {
-				log.warn(`[brand-logo:${serviceSlug}] no brand_org configured`);
-				return null;
-			}
-			const prisma = (await getServerClient()) as {
-				organisation_profile?: {
-					findFirst?: (a: unknown) => Promise<unknown>;
-				};
-			};
-			const row = (await prisma.organisation_profile?.findFirst?.({
-				where: { id: org },
-				select: {
-					company_logo_for_dark_theme: true,
-					company_logo_for_light_theme: true,
-				},
-			})) as {
-				company_logo_for_dark_theme?: string | null;
-				company_logo_for_light_theme?: string | null;
-			} | null;
-			const stored =
-				row?.company_logo_for_dark_theme ||
-				row?.company_logo_for_light_theme ||
-				null;
-			if (!stored) {
-				log.error(`[brand-logo:${serviceSlug}] organization ${org} has no logo configured`);
-				return null;
-			}
-			const logo = await inlineLogoAsDataUri(stored);
-			if (!logo) {
-				log.error(`[brand-logo:${serviceSlug}] failed to load logo`, {
-					organizationId: org,
-					storedPath: stored,
-				});
-			}
-			return logo;
-		} catch (error) {
-			log.error(`[brand-logo:${serviceSlug}] failed to resolve organization logo`, {
-				error: error instanceof Error ? error.message : String(error),
-			});
-			return null;
-		}
-	});
-}
-
-/** Above this byte size, inlining bloats the HTML more than it helps — fall
- * back to a logo-less page. Typical org logos are 5–30 KB, so this only
- * catches a genuinely oversized upload. */
-const MAX_INLINE_LOGO_BYTES = 100 * 1024;
-
-const ASSETS_PREFIX = "/api/assets/";
-
-/**
- * Inline a stored logo value as a `data:<mime>;base64,…` URI by fetching its
- * bytes from S3 (the same store `/api/assets/` proxies to). The stored value
- * IS the servable form — `/api/assets/<key>` — so the bucket key is the path
- * segment after that prefix (single-logo-pathway). Skew-tolerant: any miss →
- * null.
- */
-type LogoStorage = {
-	file(key: string): {
-		stat(): Promise<unknown>;
-		arrayBuffer(): Promise<ArrayBuffer>;
-	};
-};
-
-export async function inlineLogoAsDataUri(
-	stored: string,
-	getStorage: () => Promise<LogoStorage | null> = getClient as unknown as () => Promise<LogoStorage | null>,
-): Promise<string | null> {
-	try {
-		if (!stored.startsWith(ASSETS_PREFIX)) return null;
-		const key = decodeURIComponent(stored.slice(ASSETS_PREFIX.length));
-		const s3 = await getStorage();
-		if (!s3) return null;
-		const file = s3.file(key);
-		await file.stat();
-		const bytes = await file.arrayBuffer();
-		if (bytes.byteLength === 0 || bytes.byteLength > MAX_INLINE_LOGO_BYTES) {
-			return null;
-		}
-		const mime = mimeFromKey(key) ?? "image/png";
-		const base64 = Buffer.from(bytes).toString("base64");
-		return `data:${mime};base64,${base64}`;
-	} catch {
-		return null;
-	}
-}
-
-function mimeFromKey(key: string): string | null {
-	const ext = key.split(".").pop()?.toLowerCase();
-	switch (ext) {
-		case "png":
-			return "image/png";
-		case "jpg":
-		case "jpeg":
-			return "image/jpeg";
-		case "webp":
-			return "image/webp";
-		case "gif":
-			return "image/gif";
-		case "svg":
-			return "image/svg+xml";
-		case "avif":
-			return "image/avif";
-		default:
-			return null;
-	}
-}
-
 export class PrimaryResourceMissingError extends Error {
 	readonly resourceType: string;
 	// HTTP status for the holding page. 404 for a genuinely missing/invalid
@@ -289,10 +137,3 @@ export function buildResourceNotFoundResponse(
 		},
 	});
 }
-
-// Shares the one process-wide LISTEN connection rather than opening its own:
-// `createNotifyListener` is a factory, so a module-scope call holds a
-// connection for the process lifetime (see resolution-caches.ts).
-registerCacheInvalidation(() => {
-	logoCache.clear();
-});

package/src/run-boot-hook-list.test.ts

@@ -4,7 +4,7 @@
  * ./run-boot-hook-list declares 1 runtime export(s) and 4 declared behaviour vector(s);
  * this suite asserts the import resolves, the runtime surface matches
  * exactly, and every export carries its declared kind. Regenerate from
- * inputs/bun-server-service-boot/api_smoke.json (scala-test-suites) — hand edits are
+ * inputs/server-service-boot-ts/api_smoke.json (scala-test-suites) — hand edits are
  * overwritten.
  */
 

package/src/run-boot-hooks.test.ts

@@ -4,7 +4,7 @@
  * ./run-boot-hooks declares 1 runtime export(s) + 2 type(s) and 5 declared behaviour vector(s);
  * this suite asserts the import resolves, the runtime surface matches
  * exactly, and every export carries its declared kind. Regenerate from
- * inputs/bun-server-service-boot/api_smoke.json (scala-test-suites) — hand edits are
+ * inputs/server-service-boot-ts/api_smoke.json (scala-test-suites) — hand edits are
  * overwritten.
  */
 

package/src/scala-tools-currency-watchdog.test.ts

@@ -4,7 +4,7 @@
  * ./scala-tools-currency-watchdog declares 1 runtime export(s) and 2 declared behaviour vector(s);
  * this suite asserts the import resolves, the runtime surface matches
  * exactly, and every export carries its declared kind. Regenerate from
- * inputs/bun-server-service-boot/api_smoke.json (scala-test-suites) — hand edits are
+ * inputs/server-service-boot-ts/api_smoke.json (scala-test-suites) — hand edits are
  * overwritten.
  */
 

package/src/two-phase-minimal-app.test.ts

@@ -4,7 +4,7 @@
  * ./two-phase-minimal-app declares 1 runtime export(s) + 1 type(s);
  * this suite asserts the import resolves, the runtime surface matches
  * exactly, and every export carries its declared kind. Regenerate from
- * inputs/bun-server-service-boot/api_smoke.json (scala-test-suites) — hand edits are
+ * inputs/server-service-boot-ts/api_smoke.json (scala-test-suites) — hand edits are
  * overwritten.
  */
 

package/src/two-phase-minimal-app.ts

@@ -70,10 +70,8 @@ import { readinessGate } from "./readiness-gate.ts";
 import { registerStaticAssets } from "./register-static-assets";
 import { registerWsRoutes } from "./register-ws-routes.ts";
 import { createRequestErrorHandler } from "./hono-error-handler.ts";
-import {
-	buildResourceNotFoundResponse,
-	resolveErrorPageLogo,
-} from "./resource-not-found.ts";
+import { resolveErrorPageLogo } from "./error-page-logo.ts";
+import { buildResourceNotFoundResponse } from "./resource-not-found.ts";
 import { injectSecurityHeaders } from "./security-headers.ts";
 import { registerPageRoutes } from "./register-page-routes.ts";
 import { runBootHookList } from "./run-boot-hook-list.ts";

package/src/two-phase-readiness.test.ts

@@ -4,7 +4,7 @@
  * ./two-phase-readiness declares 6 runtime export(s) and 8 declared behaviour vector(s);
  * this suite asserts the import resolves, the runtime surface matches
  * exactly, and every export carries its declared kind. Regenerate from
- * inputs/bun-server-service-boot/api_smoke.json (scala-test-suites) — hand edits are
+ * inputs/server-service-boot-ts/api_smoke.json (scala-test-suites) — hand edits are
  * overwritten.
  */
 
@@ -13,8 +13,8 @@ import { mock } from "bun:test";
 const __realServerClient = await import("./page-server-orpc/server-client.ts");
 const __capabilityFault: { value: string | null } = { value: null };
 mock.module("./page-server-orpc/server-client.ts", () => ({ ...__realServerClient, getServerClientCapabilityFault: () => __capabilityFault.value }));
-const __realNotFound = await import("./resource-not-found.ts");
-mock.module("./resource-not-found.ts", () => ({ ...__realNotFound, resolveErrorPageLogo: async () => "https://logo.local/light.png" }));
+const __realLogo = await import("./error-page-logo.ts");
+mock.module("./error-page-logo.ts", () => ({ ...__realLogo, resolveErrorPageLogo: async () => "https://logo.local/light.png" }));
 const __ctx = { json: (body: unknown, status?: number, headers?: Record<string, string>) => new Response(JSON.stringify(body), { status: status ?? 200, headers }) };
 
 const mod = await import("./two-phase-readiness");

package/src/two-phase-readiness.ts

@@ -92,7 +92,7 @@ import { buildWakingPageHtml } from "@teamscala/os/brand/waking-page-html";
 import { WAKING_RETRY_SECONDS } from "@teamscala/os/brand/waking-page-budget.generated";
 import type { Context } from "hono";
 import { getServerClientCapabilityFault } from "./page-server-orpc/server-client.ts";
-import { resolveErrorPageLogo } from "./resource-not-found.ts";
+import { resolveErrorPageLogo } from "./error-page-logo.ts";
 import type { CreatePageHandler } from "./types.ts";
 
 // Module-level storage for the real page handler, updated when Phase 2 completes.

package/src/types.test.ts

@@ -4,7 +4,7 @@
  * ./types declares 0 runtime export(s) + 5 type(s);
  * this suite asserts the import resolves, the runtime surface matches
  * exactly, and every export carries its declared kind. Regenerate from
- * inputs/bun-server-service-boot/api_smoke.json (scala-test-suites) — hand edits are
+ * inputs/server-service-boot-ts/api_smoke.json (scala-test-suites) — hand edits are
  * overwritten.
  */
 

package/src/ui-service.test.ts

@@ -4,7 +4,7 @@
  * ./ui-service declares 1 runtime export(s) + 3 type(s);
  * this suite asserts the import resolves, the runtime surface matches
  * exactly, and every export carries its declared kind. Regenerate from
- * inputs/bun-server-service-boot/api_smoke.json (scala-test-suites) — hand edits are
+ * inputs/server-service-boot-ts/api_smoke.json (scala-test-suites) — hand edits are
  * overwritten.
  */
 

package/src/ws-boot-self-test.test.ts

@@ -4,7 +4,7 @@
  * ./ws-boot-self-test declares 1 runtime export(s) and 3 declared behaviour vector(s);
  * this suite asserts the import resolves, the runtime surface matches
  * exactly, and every export carries its declared kind. Regenerate from
- * inputs/bun-server-service-boot/api_smoke.json (scala-test-suites) — hand edits are
+ * inputs/server-service-boot-ts/api_smoke.json (scala-test-suites) — hand edits are
  * overwritten.
  */