@teamscala/service-boot 0.23.540 → 0.23.541

package/package.json

@@ -103,6 +103,8 @@
 		"./auth/sign-out.ts": "./src/auth/sign-out.ts",
 		"./bind-page-handler": "./src/bind-page-handler.ts",
 		"./bind-page-handler.ts": "./src/bind-page-handler.ts",
+		"./boot-shell": "./src/boot-shell.ts",
+		"./boot-shell.ts": "./src/boot-shell.ts",
 		"./build-client-assets": "./src/build-client-assets.ts",
 		"./build-client-assets.ts": "./src/build-client-assets.ts",
 		"./build-client-assets/build-lock": "./src/build-client-assets/build-lock.ts",
@@ -305,5 +307,5 @@
 	"repository": "https://github.com/teamgbg/service-boot",
 	"sideEffects": false,
 	"type": "module",
-	"version": "0.23.540"
+	"version": "0.23.541"
 }

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

@@ -1,15 +1,15 @@
 /**
  * @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.
- * ./apply-logger-config declares 1 runtime export(s) and 3 declared behaviour vector(s);
+ * templates/ts_api_smoke.pkl @1.5.0) over the exports map of @teamscala/service-boot.
+ * ./apply-logger-config 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/server-service-boot-ts/api_smoke.json (scala-test-suites) — hand edits are
+ * inputs/bun-server-service-boot/api_smoke.json (scala-test-suites) — hand edits are
  * overwritten.
  */
 
 import { describe, expect, it } from "bun:test";
-import { mock } from "bun:test";
+const { mock } = await import("bun:test");
 const __setMinLevel: string[] = [];
 const __fileSinks: Record<string, unknown>[] = [];
 mock.module("@teamscala/logger/creator", () => ({ setMinLevel: (level: string) => { __setMinLevel.push(level); } }));
@@ -30,17 +30,22 @@ describe("apply-logger-config exports-map smoke", () => {
 	});
 	it("a declared min level reaches the logger creator", async () => {
 		__setMinLevel.length = 0;
-		applyLoggerConfig({ minLevel: "debug" });
+		applyLoggerConfig({ minLevel: "debug" })
 		expect(__setMinLevel).toEqual(["debug"]);
 	});
 	it("an undeclared min level leaves the creator untouched", async () => {
 		__setMinLevel.length = 0;
-		applyLoggerConfig({});
+		applyLoggerConfig({})
 		expect(__setMinLevel).toEqual([]);
 	});
 	it("the file sink is configured from the boot row's own values", async () => {
 		__fileSinks.length = 0;
-		applyLoggerConfig({ logDir: "/var/log/scala", maxFileSize: 10, maxFiles: 3 });
-		expect(__fileSinks).toEqual([{ logDir: "/var/log/scala", maxFileSize: 10, maxFiles: 3 }]);
+		applyLoggerConfig({ logDir: "/var/log/scala", maxFileSize: 10, maxFiles: 3 })
+		expect(__fileSinks).toEqual([{"logDir": "/var/log/scala", "maxFileSize": 10, "maxFiles": 3}]);
+	});
+	it("a row logDir carrying a host placeholder is resolved before it reaches the file sink", async () => {
+		__fileSinks.length = 0;
+		applyLoggerConfig({ logDir: "${HOME}/.local/share/oxmgr/logs" })
+		expect(__fileSinks).toEqual([{ logDir: `${process.env.HOME}/.local/share/oxmgr/logs`, maxFileSize: undefined, maxFiles: undefined }]);
 	});
 });

package/src/boot-shell.test.ts

@@ -0,0 +1,57 @@
+/**
+ * @status generated — ts-api-smoke template (scala-test-suites
+ * templates/ts_api_smoke.pkl @1.5.0) over the exports map of @teamscala/service-boot.
+ * ./boot-shell 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
+ * overwritten.
+ */
+
+import { describe, expect, it } from "bun:test";
+const { Hono } = await import("hono");
+const { swapApp } = await import("./mutable-app-ref");
+const { __resetReadinessGateForTest, setReady } = await import("./readiness-gate");
+const { __resetPhase2StateForTest, markFullAppDegraded } = await import("./two-phase-readiness");
+
+const mod = await import("./boot-shell");
+
+const { createBootShellApp } = mod;
+
+describe("boot-shell exports-map smoke", () => {
+	it("the runtime export set is exactly the declared surface", () => {
+		expect(Object.keys(mod).sort()).toEqual([
+			"createBootShellApp",
+		]);
+	});
+	it("createBootShellApp is a function", () => {
+		expect(typeof mod["createBootShellApp"]).toBe("function");
+	});
+	it("answers 503 starting on every path while the mount chain runs", async () => {
+		__resetReadinessGateForTest();
+		__resetPhase2StateForTest();
+		const shell = createBootShellApp("boot-shell-test"); const health = await shell.request("/health"); const page = await shell.request("/any/unmounted/path")
+		expect(health.status).toBe(503);
+		expect(await health.json()).toEqual({ status: "starting" });
+		expect(page.status).toBe(503);
+		expect(await page.json()).toEqual({ status: "starting" });
+	});
+	it("delegates to the swapped-in minimal app once ready", async () => {
+		__resetReadinessGateForTest();
+		__resetPhase2StateForTest();
+		swapApp(new Hono().get("/delegated", () => new Response("mounted")), "minimal");
+		setReady();
+		const res = await createBootShellApp("boot-shell-test").request("/delegated")
+		expect(res.status).toBe(200);
+		expect(await res.text()).toBe("mounted");
+	});
+	it("health reports degraded once the boot finished with a failed client build", async () => {
+		__resetReadinessGateForTest();
+		__resetPhase2StateForTest();
+		setReady();
+		markFullAppDegraded("client build is not servable: boot-shell-test");
+		const res = await createBootShellApp("boot-shell-test").request("/health")
+		expect(res.status).toBe(200);
+		expect(await res.json()).toEqual({ status: "degraded", reason: "client build is not servable: boot-shell-test" });
+	});
+});

package/src/boot-shell.ts

@@ -0,0 +1,20 @@
+/**
+ * @system service-boot
+ * @status handwritten
+ */
+
+import type { Hono } from "hono";
+import { Hono } from "hono";
+import { createRequestErrorHandler } from "./hono-error-handler.ts";
+import { getApp } from "./mutable-app-ref.ts";
+import { readinessGate } from "./readiness-gate.ts";
+import { healthHandler } from "./two-phase-readiness.ts";
+
+export function createBootShellApp(serviceSlug: string): Hono {
+	const app = new Hono();
+	app.onError(createRequestErrorHandler(`service-boot:boot-shell:${serviceSlug}`));
+	app.use("*", readinessGate);
+	app.get("/health", healthHandler);
+	app.all("*", (c) => getApp().fetch(c.req.raw, c.env));
+	return app;
+}

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

@@ -1,10 +1,10 @@
 /**
  * @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);
+ * templates/ts_api_smoke.pkl @1.5.0) over the exports map of @teamscala/service-boot.
+ * ./error-page-logo declares 2 runtime export(s) and 10 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
+ * inputs/bun-server-service-boot/api_smoke.json (scala-test-suites) — hand edits are
  * overwritten.
  */
 
@@ -29,36 +29,56 @@ describe("error-page-logo exports-map smoke", () => {
 	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 () => {
+	it("inlines a stored logo as a data URI, fetching the bucket key after the /api/assets/ prefix [toBeTrue]", 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();
+		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).toEqual(true);
+	});
+	it("inlines a stored logo as a data URI, fetching the bucket key after the /api/assets/ prefix [toEqual]", 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(__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 () => {
+	it("inlines a stored logo as a data URI, fetching the bucket key after the /api/assets/ prefix [toBe]", 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(got).toEqual("data:image/png;base64,iVBORw==");
+	});
+	it("a stored value without the /api/assets/ prefix is refused before storage is touched [toBeFalse]", async () => {
 		__requested.length = 0;
 		__storageReached = false;
-		const got = await inlineLogoAsDataUri("https://cdn.example.com/logo.png", async () => { __storageReached = true; return null; });
-		expect(__storageReached).toBeFalse();
+		const got = await inlineLogoAsDataUri("https://cdn.example.com/logo.png", async () => { __storageReached = true; return null; })
+		expect(__storageReached).toEqual(false);
+	});
+	it("a stored value without the /api/assets/ prefix is refused before storage is touched [toEqual]", async () => {
+		__requested.length = 0;
+		__storageReached = false;
+		const got = await inlineLogoAsDataUri("https://cdn.example.com/logo.png", async () => { __storageReached = true; return null; })
 		expect(__requested).toEqual([]);
+	});
+	it("a stored value without the /api/assets/ prefix is refused before storage is touched [toBeNull]", async () => {
+		__requested.length = 0;
+		__storageReached = false;
+		const got = await inlineLogoAsDataUri("https://cdn.example.com/logo.png", async () => { __storageReached = true; return null; })
 		expect(got).toBeNull();
 	});
 	it("an unavailable storage client returns null", async () => {
-		const got = await inlineLogoAsDataUri("/api/assets/org/logos/cropped.png", async () => null);
+		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) }; } }));
+		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) }; } }));
+		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/");
+		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).toEqual("data:image/jpeg;base64,/9j/");
 	});
 });

package/src/orpc-contract-rows.test.ts

@@ -1,6 +1,6 @@
 /**
  * @status generated — ts_function_contract_runner template (scala-test-suites
- * templates/ts_function_contract_runner.pkl @1.16.0) over @teamscala/service-boot's
+ * templates/ts_function_contract_runner.pkl @1.16.1) over @teamscala/service-boot's
  * test_vector rows: one `it` per function_call row (args -> value or
  * expect_error) and one per fs_flow row (ordered steps in a temp
  * workspace). This runner carries NO facts: every case is the registry
@@ -8,6 +8,7 @@
  * test-vector-rows projection row (scala-tools codegen run --repo
  * <consumer>); hand edits are overwritten.
  */
+
 function arithmetic(source: string, value: unknown, slug: string): number {
 	let pos = 0;
 	const text = source;
@@ -955,13 +956,13 @@ function assertRenderSpec(slug: string, container: HTMLElement, spec: Record<str
 }
 
 async function renderRow(row: Vector): Promise<void> {
+	if (!globalThis.document) {
+		const { GlobalRegistrator } = await import("@happy-dom/global-registrator");
+		await GlobalRegistrator.register({ url: "http://localhost" });
+	}
 	const restore = applyEnv(row.env);
 	try {
 		await withStubs(row, async () => {
-			if (!globalThis.document) {
-				const { GlobalRegistrator } = await import("@happy-dom/global-registrator");
-				await GlobalRegistrator.register({ url: "http://localhost" });
-			}
 			(globalThis as Record<string, unknown>).IS_REACT_ACT_ENVIRONMENT = true;
 			const React = await import("react");
 			const { createRoot } = await import("react-dom/client");
@@ -1010,13 +1011,13 @@ async function renderRow(row: Vector): Promise<void> {
 	}
 }
 async function hookRow(row: Vector): Promise<void> {
+	if (!globalThis.document) {
+		const { GlobalRegistrator } = await import("@happy-dom/global-registrator");
+		await GlobalRegistrator.register({ url: "http://localhost" });
+	}
 	const restore = applyEnv(row.env);
 	try {
 		await withStubs(row, async () => {
-			if (!globalThis.document) {
-				const { GlobalRegistrator } = await import("@happy-dom/global-registrator");
-				await GlobalRegistrator.register({ url: "http://localhost" });
-			}
 			(globalThis as Record<string, unknown>).IS_REACT_ACT_ENVIRONMENT = true;
 			const React = await import("react");
 			const { createRoot } = await import("react-dom/client");

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

@@ -1,10 +1,10 @@
 /**
  * @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.
- * ./page-server-loader-graph declares 1 runtime export(s) and 1 declared behaviour vector(s);
+ * templates/ts_api_smoke.pkl @1.5.0) over the exports map of @teamscala/service-boot.
+ * ./page-server-loader-graph 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/server-service-boot-ts/api_smoke.json (scala-test-suites) — hand edits are
+ * inputs/bun-server-service-boot/api_smoke.json (scala-test-suites) — hand edits are
  * overwritten.
  */
 
@@ -23,9 +23,13 @@ describe("page-server-loader-graph exports-map smoke", () => {
 	it("resolveFromLoaderConfig is a function", () => {
 		expect(typeof mod["resolveFromLoaderConfig"]).toBe("function");
 	});
-	it("the SSR binding is a resolver PRODUCT of the engine factory applied to the page-server client — never the factory itself", async () => {
-		const { createLoaderConfigResolver } = await import("@teamscala/loader-config/loader-config/resolve-from-loader-config");
-		expect(typeof createLoaderConfigResolver).toBe("function");
+	it("the SSR binding is a resolver PRODUCT of the engine factory applied to the page-server client — never the factory itself [toBe]", async () => {
+		const { createLoaderConfigResolver } = await import("@teamscala/loader-config/loader-config/resolve-from-loader-config")
+const got = (typeof createLoaderConfigResolver);
+		expect(got).toEqual("function");
+	});
+	it("the SSR binding is a resolver PRODUCT of the engine factory applied to the page-server client — never the factory itself [toBe]", async () => {
+		const { createLoaderConfigResolver } = await import("@teamscala/loader-config/loader-config/resolve-from-loader-config")
 		expect(resolveFromLoaderConfig).not.toBe(createLoaderConfigResolver);
 	});
 });

package/src/readiness-gate.ts

@@ -12,6 +12,10 @@ export function setReady(): void {
 	_ready = true;
 }
 
+export function __resetReadinessGateForTest(): void {
+	_ready = false;
+}
+
 export async function readinessGate(c: Context, next: Next): Promise<Response | void> {
 	try {
 		if (_ready) return next();

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

@@ -1,10 +1,10 @@
 /**
  * @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.
+ * templates/ts_api_smoke.pkl @1.5.0) over the exports map of @teamscala/service-boot.
  * ./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/server-service-boot-ts/api_smoke.json (scala-test-suites) — hand edits are
+ * inputs/bun-server-service-boot/api_smoke.json (scala-test-suites) — hand edits are
  * overwritten.
  */
 
@@ -32,19 +32,19 @@ describe("meta-title exports-map smoke", () => {
 		expect(typeof mod["resolveEntityTitle"]).toBe("function");
 	});
 	it("an absent meta context resolves no meta at all", async () => {
-		const got = buildMetaFromContext(undefined, { page: { name: "Quiz" } });
+		const got = buildMetaFromContext(undefined, { page: { name: "Quiz" } })
 		expect(got).toEqual({});
 	});
 	it("the page's own meta_title wins, from loaderData first", async () => {
-		const got = resolvePageMetaTitle({ loaderData: { page: { meta_title: "Sign in" } }, page: { meta_title: "Landing" } });
-		expect(got).toBe("Sign in");
+		const got = resolvePageMetaTitle({ loaderData: { page: { meta_title: "Sign in" } }, page: { meta_title: "Landing" } })
+		expect(got).toEqual("Sign in");
 	});
 	it("with no loaderData page, the resolved page's meta_title answers", async () => {
-		const got = resolvePageMetaTitle({ loaderData: {}, page: { meta_title: "Landing" } });
-		expect(got).toBe("Landing");
+		const got = resolvePageMetaTitle({ loaderData: {}, page: { meta_title: "Landing" } })
+		expect(got).toEqual("Landing");
 	});
 	it("neither page carries a title, so no title resolves", async () => {
-		const got = resolvePageMetaTitle({ loaderData: {} });
+		const got = resolvePageMetaTitle({ loaderData: {} })
 		expect(got).toBeUndefined();
 	});
 });

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

@@ -1,15 +1,15 @@
 /**
  * @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.
+ * templates/ts_api_smoke.pkl @1.5.0) over the exports map of @teamscala/service-boot.
  * ./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/server-service-boot-ts/api_smoke.json (scala-test-suites) — hand edits are
+ * inputs/bun-server-service-boot/api_smoke.json (scala-test-suites) — hand edits are
  * overwritten.
  */
 
 import { describe, expect, it } from "bun:test";
-import { mock } from "bun:test";
+const { mock } = await import("bun:test");
 const __realAssetProxy = await import("./asset-proxy");
 let __probeCalls = 0;
 let __probeBehaviour: "ok" | "notok" | "throw" = "ok";
@@ -34,30 +34,32 @@ describe("resolve-brand-favicon exports-map smoke", () => {
 	});
 	it("no brand org resolves null without probing the asset store", async () => {
 		__probeCalls = 0;
-		const got = await resolveBrandFaviconPath(undefined);
+		const got = await resolveBrandFaviconPath(undefined)
 		expect(got).toBeNull();
 		expect(__probeCalls).toBe(0);
 	});
-	it("a reachable favicon resolves the encoded convention path and caches it", async () => {
+	it("a reachable favicon resolves the encoded convention path and probes the asset store once", async () => {
 		__probeBehaviour = "ok"; __probeCalls = 0;
-		const got = await resolveBrandFaviconPath("brand-org-probe-1");
+		const got = await resolveBrandFaviconPath("brand-org-probe-1")
 		expect(got).toBe("/api/assets/brand-org-probe-1%2Flogos%2Ffavicon.png");
 		expect(__probeCalls).toBe(1);
 	});
-	it("the second resolution for the same org serves from cache", async () => {
+	it("the second resolution for the same org serves from cache without probing again", async () => {
+		__probeBehaviour = "ok"; __probeCalls = 0;
+		await resolveBrandFaviconPath("brand-org-probe-4");
 		__probeCalls = 0;
-		const got = await resolveBrandFaviconPath("brand-org-probe-1");
-		expect(got).toBe("/api/assets/brand-org-probe-1%2Flogos%2Ffavicon.png");
+		const got = await resolveBrandFaviconPath("brand-org-probe-4")
+		expect(got).toBe("/api/assets/brand-org-probe-4%2Flogos%2Ffavicon.png");
 		expect(__probeCalls).toBe(0);
 	});
 	it("a missing favicon at the convention key resolves null", async () => {
 		__probeBehaviour = "notok"; __probeCalls = 0;
-		const got = await resolveBrandFaviconPath("brand-org-probe-2");
+		const got = await resolveBrandFaviconPath("brand-org-probe-2")
 		expect(got).toBeNull();
 	});
 	it("an asset-store failure degrades to the generic fallback (null), never a throw", async () => {
 		__probeBehaviour = "throw"; __probeCalls = 0;
-		const got = await resolveBrandFaviconPath("brand-org-probe-3");
+		const got = await resolveBrandFaviconPath("brand-org-probe-3")
 		expect(got).toBeNull();
 	});
 });

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

@@ -1,10 +1,10 @@
 /**
  * @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.
- * ./resolve-theme-mode declares 1 runtime export(s) + 1 type(s) and 5 declared behaviour vector(s);
+ * templates/ts_api_smoke.pkl @1.5.0) over the exports map of @teamscala/service-boot.
+ * ./resolve-theme-mode declares 1 runtime export(s) + 1 type(s) and 10 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
+ * inputs/bun-server-service-boot/api_smoke.json (scala-test-suites) — hand edits are
  * overwritten.
  */
 
@@ -23,29 +23,54 @@ describe("resolve-theme-mode exports-map smoke", () => {
 	it("resolveThemeMode is a function", () => {
 		expect(typeof mod["resolveThemeMode"]).toBe("function");
 	});
-	it("the ?theme= URL override wins and marks the render embedded", async () => {
-		const got = resolveThemeMode({ url: "https://x.local/p?theme=dark" });
-		expect(got.theme).toBe("dark");
-		expect(got.embedded).toBe(true);
-	});
-	it("an explicit override behaves exactly like the URL form", async () => {
-		const got = resolveThemeMode({ override: "dark" });
-		expect(got.theme).toBe("dark");
-		expect(got.embedded).toBe(true);
-	});
-	it("a non-light/dark override is not an override", async () => {
-		const got = resolveThemeMode({ override: "purple", candidates: ["dark"] });
-		expect(got.theme).toBe("dark");
-		expect(got.embedded).toBe(false);
-	});
-	it("candidates are consulted in priority order", async () => {
-		const got = resolveThemeMode({ candidates: [null, "light", "dark"] });
-		expect(got.theme).toBe("light");
-		expect(got.embedded).toBe(false);
-	});
-	it("nothing resolvable lands on light, never a crash", async () => {
-		const got = resolveThemeMode({});
-		expect(got.theme).toBe("light");
-		expect(got.embedded).toBe(false);
+	it("the ?theme= URL override wins and marks the render embedded [toBe]", async () => {
+		const got = resolveThemeMode({ url: "https://x.local/p?theme=dark" })
+const got2 = (got.theme);
+		expect(got2).toEqual("dark");
+	});
+	it("the ?theme= URL override wins and marks the render embedded [toBe]", async () => {
+		const got = resolveThemeMode({ url: "https://x.local/p?theme=dark" })
+const got2 = (got.embedded);
+		expect(got2).toEqual(true);
+	});
+	it("an explicit override behaves exactly like the URL form [toBe]", async () => {
+		const got = resolveThemeMode({ override: "dark" })
+const got2 = (got.theme);
+		expect(got2).toEqual("dark");
+	});
+	it("an explicit override behaves exactly like the URL form [toBe]", async () => {
+		const got = resolveThemeMode({ override: "dark" })
+const got2 = (got.embedded);
+		expect(got2).toEqual(true);
+	});
+	it("a non-light/dark override is not an override [toBe]", async () => {
+		const got = resolveThemeMode({ override: "purple", candidates: ["dark"] })
+const got2 = (got.theme);
+		expect(got2).toEqual("dark");
+	});
+	it("a non-light/dark override is not an override [toBe]", async () => {
+		const got = resolveThemeMode({ override: "purple", candidates: ["dark"] })
+const got2 = (got.embedded);
+		expect(got2).toEqual(false);
+	});
+	it("candidates are consulted in priority order [toBe]", async () => {
+		const got = resolveThemeMode({ candidates: [null, "light", "dark"] })
+const got2 = (got.theme);
+		expect(got2).toEqual("light");
+	});
+	it("candidates are consulted in priority order [toBe]", async () => {
+		const got = resolveThemeMode({ candidates: [null, "light", "dark"] })
+const got2 = (got.embedded);
+		expect(got2).toEqual(false);
+	});
+	it("nothing resolvable lands on light, never a crash [toBe]", async () => {
+		const got = resolveThemeMode({})
+const got2 = (got.theme);
+		expect(got2).toEqual("light");
+	});
+	it("nothing resolvable lands on light, never a crash [toBe]", async () => {
+		const got = resolveThemeMode({})
+const got2 = (got.embedded);
+		expect(got2).toEqual(false);
 	});
 });

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

@@ -1,10 +1,10 @@
 /**
  * @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.
- * ./fetch-org-brand declares 1 runtime export(s) and 4 declared behaviour vector(s);
+ * templates/ts_api_smoke.pkl @1.5.0) over the exports map of @teamscala/service-boot.
+ * ./fetch-org-brand declares 1 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
+ * inputs/bun-server-service-boot/api_smoke.json (scala-test-suites) — hand edits are
  * overwritten.
  */
 
@@ -23,26 +23,37 @@ describe("fetch-org-brand (page-org-first wrapper) exports-map smoke", () => {
 	it("fetchOrgBrandWithFallback is a function", () => {
 		expect(typeof mod["fetchOrgBrandWithFallback"]).toBe("function");
 	});
-	it("a page org with a brand row renders THAT brand, no fallback consulted", async () => {
+	it("a page org with a brand row renders THAT brand, no fallback consulted [toBeNull]", async () => {
 		const client = { organisation_profile: { findFirst: async ({ select, where }) => (where.id === "org-branded" ? { company_name: "Launcha", brand_primary_color: "#123456" } : null) } };
-		const got = await fetchOrgBrandWithFallback({ input: { orgId: "org-branded" }, client, params: {} } as never);
+		const got = await fetchOrgBrandWithFallback({ input: { orgId: "org-branded" }, client, params: {} } as never)
 		expect(got).not.toBeNull();
-		expect((got as { companyName: string }).companyName).toBe("Launcha");
+		expect(got).not.toBeUndefined();
+	});
+	it("a page org with a brand row renders THAT brand, no fallback consulted [toBe]", async () => {
+		const client = { organisation_profile: { findFirst: async ({ select, where }) => (where.id === "org-branded" ? { company_name: "Launcha", brand_primary_color: "#123456" } : null) } };
+		const got = await fetchOrgBrandWithFallback({ input: { orgId: "org-branded" }, client, params: {} } as never)
+const got2 = ((got as { companyName: string }).companyName);
+		expect(got2).toEqual("Launcha");
 	});
 	it("a page org with no brand falls back to the website owning-org", async () => {
 		const client = { organisation_profile: { findFirst: async ({ where }) => (where.id === "org-fallback" ? { company_name: "Website Owner" } : null) } };
-		const got = await fetchOrgBrandWithFallback({ input: { orgId: "org-page", fallbackOrgId: "org-fallback" }, client, params: {} } as never);
-		expect((got as { companyName: string }).companyName).toBe("Website Owner");
+		const got = await fetchOrgBrandWithFallback({ input: { orgId: "org-page", fallbackOrgId: "org-fallback" }, client, params: {} } as never)
+const got2 = ((got as { companyName: string }).companyName);
+		expect(got2).toEqual("Website Owner");
 	});
-	it("a fallback identical to the page org is not consulted twice", async () => {
+	it("a fallback identical to the page org is not consulted twice [toBeNull]", async () => {
 		let calls = 0; const client = { organisation_profile: { findFirst: async () => { calls++; return null; } } };
-		const got = await fetchOrgBrandWithFallback({ input: { orgId: "org-x", fallbackOrgId: "org-x" }, client, params: {} } as never);
+		const got = await fetchOrgBrandWithFallback({ input: { orgId: "org-x", fallbackOrgId: "org-x" }, client, params: {} } as never)
 		expect(got).toBeNull();
-		expect(calls).toBe(2);
+	});
+	it("a fallback identical to the page org is not consulted twice [toBe]", async () => {
+		let calls = 0; const client = { organisation_profile: { findFirst: async () => { calls++; return null; } } };
+		const got = await fetchOrgBrandWithFallback({ input: { orgId: "org-x", fallbackOrgId: "org-x" }, client, params: {} } as never)
+		expect(calls).toEqual(2);
 	});
 	it("no orgId anywhere resolves null and names it", async () => {
 		const client = { organisation_profile: { findFirst: async () => { throw new Error("must not be called"); } } };
-		const got = await fetchOrgBrandWithFallback({ input: {}, client, params: {} } as never);
+		const got = await fetchOrgBrandWithFallback({ input: {}, client, params: {} } as never)
 		expect(got).toBeNull();
 	});
 });