@teamscala/service-boot 0.23.523 → 0.23.525

package/src/is-react-element-type.test.ts

@@ -1,45 +0,0 @@
-// @system codegen
-// @status generated
-// @edit change the suite in the owned-suites band, then re-run codegen. Hand-edits are overwritten.
-//
-// This suite's assertions are OWNED by the codegen band: the band module
-// carries them verbatim, this file is the emission, and hand edits here are
-// overwritten on the next run. The rationale each assertion carries moved
-// with it into the band.
-
-import { expect, test } from "bun:test";
-import { forwardRef, lazy, memo } from "react";
-import { isReactElementType } from "./is-react-element-type.ts";
-
-function Plain() {
-	return null;
-}
-
-test("accepts a plain function component", () => {
-	expect(isReactElementType(Plain)).toBe(true);
-});
-
-test("accepts memo() — the PresenceAvatars shape that rendered blank", () => {
-	expect(isReactElementType(memo(Plain))).toBe(true);
-});
-
-test("accepts forwardRef()", () => {
-	expect(isReactElementType(forwardRef(() => null))).toBe(true);
-});
-
-test("accepts lazy()", () => {
-	expect(isReactElementType(lazy(async () => ({ default: Plain })))).toBe(true);
-});
-
-test("still rejects what genuinely cannot render", () => {
-	expect(isReactElementType(undefined)).toBe(false);
-	expect(isReactElementType(null)).toBe(false);
-	expect(isReactElementType({})).toBe(false);
-	expect(isReactElementType("PresenceAvatarsBlock")).toBe(false);
-	expect(isReactElementType(42)).toBe(false);
-});
-
-test("rejects a plain object wearing a non-symbol $$typeof", () => {
-	// A data blob with the key but not the symbol must not pass as renderable.
-	expect(isReactElementType({ $$typeof: "react.memo" })).toBe(false);
-});

package/src/is-react-element-type.ts

@@ -1,20 +0,0 @@
-/**
- * @system ui-service-boot
- * @status handwritten
- * @edit edit directly
- *
- * Is a resolved module export something React can render?
- *
- * `typeof x === "function"` is NOT that question. memo(), forwardRef() and
- * lazy() all return OBJECTS carrying a `$$typeof` symbol, so a shape check on
- * `function` rejects three of React's own idioms as "not a component".
- * Measured 2026-09-01: scala-projects skipped PresenceAvatars for exactly this
- * reason — the block is `memo(function PresenceAvatarsBlock(...))` — and every
- * page rendering it came out blank with no error beyond one boot WARN.
- */
-
-export function isReactElementType(value: unknown): boolean {
-	if (typeof value === "function") return true;
-	if (typeof value !== "object" || value === null) return false;
-	return typeof (value as { $$typeof?: unknown }).$$typeof === "symbol";
-}

package/src/page-server-orpc/hub-mcp-client.ts

@@ -1,20 +0,0 @@
-/**
- * @system page-server
- * @status handwritten
- * @edit edit directly
- *
- * Module-level singleton for the hub MCP client. setHubMcpClient(client)
- * is called once at boot by the host service after creating the multi-
- * tenant MCP client; createPageHandler's resolve-page-state reads it via
- * getHubMcpClient to pass through to data loaders.
- */
-
-let _hubMcpClient: unknown | null = null;
-
-export function setHubMcpClient(client: unknown): void {
-	_hubMcpClient = client;
-}
-
-export function getHubMcpClient(): unknown | undefined {
-	return _hubMcpClient ?? undefined;
-}

package/src/pg-boss-mount.test.ts

@@ -1,101 +0,0 @@
-/**
- * @system server-boot
- * @status handwritten
- * @edit edit directly
- *
- * The mount's poll-only contract: pg-boss v12 dispatches by polling, so the
- * mount dials the INJECTED transaction-pooler URL unchanged (no endpoint
- * derivation of its own — the session-port mapping died with the door,
- * 2026-09-14) and constructs with useListenNotify false spelled explicitly
- * rather than inherited from the supplier default, so a pg-boss bump cannot
- * silently re-introduce a LISTEN dependency. The mock captures the opts
- * PgBoss is constructed with — the claim is about what the mount DIALS and
- * how it dispatches, so the assertions are on the captured opts.
- */
-
-import { afterEach, describe, expect, it, mock } from "bun:test";
-
-interface CapturedOpts {
-	connectionString?: string;
-	max?: number;
-	useListenNotify?: boolean;
-}
-
-const POOLED_URL =
-	"postgresql://scala_container_gbg.gbg:s3cret@10.205.50.1:6543/scala_container_gbg?sslmode=require";
-
-function seedScheduledJob() {
-	return {
-		id: "test-job-1",
-		type: "scheduled_job",
-		slug: "scheduled_job:test-sync",
-		label: "Test Sync Job",
-		description: null,
-		config: {
-			handler_slug: "@teamscala/sync-worker:processSyncQueue",
-			cron: "*/5 * * * *",
-			queue_name: "sync-worker",
-		},
-		is_active: true,
-		sort_order: 0,
-		created_at: new Date(),
-		updated_at: new Date(),
-		noun: "scheduled_job",
-		kind: "scheduled_job",
-	};
-}
-
-describe("mountPgBoss poll-only contract", () => {
-	afterEach(() => {
-		mock.restore();
-	});
-
-	it("dials the injected transaction pooler unchanged and dispatches poll-only", async () => {
-		let captured: CapturedOpts | null = null;
-
-		mock.module("pg-boss", () => ({
-			PgBoss: mock((opts: CapturedOpts) => {
-				captured = opts;
-				return {
-					start: mock(() => Promise.resolve()),
-					stop: mock(() => Promise.resolve()),
-					on: mock(() => undefined),
-					createQueue: mock(() => Promise.resolve()),
-					work: mock(() => Promise.resolve("worker-id")),
-					schedule: mock(() => Promise.resolve()),
-					getSchedules: mock(() => Promise.resolve([])),
-					unschedule: mock(() => Promise.resolve()),
-				};
-			}),
-		}));
-		mock.module("@teamscala/db/registry/accessors", () => ({
-			getAllEntries: () => [seedScheduledJob()],
-		}));
-		mock.module("@teamscala/event-log/record-event", () => ({
-			recordEvent: () => undefined,
-		}));
-
-		const { mountPgBoss } = await import("./pg-boss-mount.ts");
-		await mountPgBoss({
-			databaseUrl: POOLED_URL,
-			serviceSlug: "scala-sync-worker",
-			packages: ["@teamscala/sync-worker"],
-		});
-
-		const capturedOpts = captured as unknown as CapturedOpts | undefined;
-		const connectionString = capturedOpts?.connectionString ?? "";
-		// The transaction pooler, exactly as injected — the mount adds no
-		// endpoint derivation.
-		expect(connectionString).toContain(":6543");
-		// NEVER the session port: the door is closing, not widening.
-		expect(connectionString).not.toContain(":5999");
-		// The tenant suffix the pooler routes by is kept.
-		expect(connectionString).toContain("scala_container_gbg.gbg:");
-		// The pg sslmode dialect rewrite still applies.
-		expect(connectionString).toContain("sslmode=no-verify");
-		// Poll-only, spelled: no LISTEN dependency, now and after a bump.
-		expect(capturedOpts?.useListenNotify).toBe(false);
-		// pg-boss stays a single sibling connection (pool sizing doctrine).
-		expect(capturedOpts?.max).toBe(1);
-	});
-});

package/src/resource-chat-inject.page-assistant.test.ts

@@ -1,145 +0,0 @@
-// @system codegen
-// @status generated
-// @edit change the suite in the owned-suites band, then re-run codegen. Hand-edits are overwritten.
-//
-// This suite's assertions are OWNED by the codegen band: the band module
-// carries them verbatim, this file is the emission, and hand edits here are
-// overwritten on the next run. The rationale each assertion carries moved
-// with it into the band.
-
-import { describe, expect, mock, test } from "bun:test";
-
-/** The ONE active launcher block_schema slug — the Puck registry key. */
-const REGISTERED_LAUNCHER_SLUG = "ResourceLauncher";
-
-mock.module("@teamscala/db/registry/load-config", () => ({
-	loadRegistryConfig: async () => ({ agentId: "agent-1" }),
-}));
-mock.module("./page-server-orpc/server-client.ts", () => ({
-	getServerClient: () => ({
-		ai_agents: {
-			findFirst: async () => ({
-				name: "Results Assistant",
-				welcome_message: "Hi! Ask me anything about your results.",
-				conversation_starters: ["What are my strengths?"],
-				primary_color: "#6366f1",
-			}),
-		},
-	}),
-}));
-mock.module("@teamscala/logger/app-loggers", () => ({
-	getAppLogger: () => ({ error: (...args: unknown[]) => void args }),
-}));
-
-const { injectResourceChatLauncher } = await import("./resource-chat-inject.ts");
-
-const ORG = "org-1";
-const AGENT_OPTS = {
-	agentConfigSlug: "assessment-assistant-agent" as never,
-	launchLabel: "Ask about your results",
-	placeholder: "Ask about your results…",
-	regionSlots: ["header", "body", "footer"] as readonly string[],
-};
-
-/** A resolved response row as the loader's response source selects it. */
-const RESPONSE_ROW = {
-	id: "resp-1",
-	assessment_id: "asm-1",
-	organisation_id: ORG,
-	total_score: 64,
-	first_name: "Anna",
-};
-
-/** The paired key as resolveReportHalves returns it — present on EVERY link
- *  shape, carrying the anchor half's organisation. */
-const PAIRED = {
-	response: RESPONSE_ROW,
-	research: { id: "research-live", assessment_id: "asm-1", organisation_id: ORG },
-	assessment_id: "asm-1",
-	organisation_id: ORG,
-};
-
-function pageGraph(
-	responseSource: unknown,
-	pairSource: Record<string, unknown>,
-): Record<string, unknown> {
-	return {
-		response: responseSource,
-		pair: pairSource,
-		quiz: { id: "asm-1", organisation_id: ORG, title: "Authority Index" },
-		brand: { primaryColor: "#123456" },
-		body: { puck_data: { root: { props: {} }, zones: {}, content: [] } },
-		header: { puck_data: { root: { props: {} }, zones: {}, content: [] } },
-		footer: { puck_data: { root: { props: {} }, zones: {}, content: [] } },
-	};
-}
-
-/** The launcher renders `position: fixed`, so it may land in whichever
- *  region slot is declared first — count across EVERY slot, not one. */
-function launcherBlocks(
-	resolved: Record<string, unknown>,
-): Array<{ type: string; props?: Record<string, unknown> }> {
-	const out: Array<{ type: string; props?: Record<string, unknown> }> = [];
-	for (const slot of AGENT_OPTS.regionSlots) {
-		const content = (
-			resolved[slot] as {
-				puck_data?: { content?: Array<{ type: string; props?: Record<string, unknown> }> };
-			}
-		).puck_data?.content;
-		for (const block of content ?? []) {
-			if (block.type === REGISTERED_LAUNCHER_SLUG) out.push(block);
-		}
-	}
-	return out;
-}
-
-async function launcherCount(
-	responseSource: unknown,
-	pairSource: Record<string, unknown>,
-	resourceKey: string,
-): Promise<number> {
-	const resolved = pageGraph(responseSource, pairSource);
-	await injectResourceChatLauncher(resolved, "", { ...AGENT_OPTS, resourceKey });
-	return launcherBlocks(resolved).length;
-}
-
-describe("page assistant renders on every link shape", () => {
-	test("response-id link: raw hit exists, launcher renders", async () => {
-		expect(await launcherCount(RESPONSE_ROW, PAIRED, "pair")).toBe(1);
-	});
-
-	test("live research-anchor link: raw hit is null, launcher still renders", async () => {
-		expect(await launcherCount(null, PAIRED, "pair")).toBe(1);
-	});
-
-	test("superseded research-anchor link: raw hit is null, launcher still renders", async () => {
-		// identical graph shape to the live anchor — resolution to the live
-		// pass happens upstream in the pair resolver, so the injection surface
-		// is the same and is exercised identically
-		expect(await launcherCount(null, PAIRED, "pair")).toBe(1);
-	});
-
-	test("the launcher block carries the agent, org scope and context", async () => {
-		const resolved = pageGraph(null, PAIRED);
-		await injectResourceChatLauncher(resolved, "viewer@example.com", {
-			...AGENT_OPTS,
-			resourceKey: "pair",
-		});
-		const launchers = launcherBlocks(resolved);
-		expect(launchers.length).toBe(1);
-		const launcher = launchers[0];
-		expect(launcher.props.agentId).toBe("agent-1");
-		expect(launcher.props.organisationId).toBe(ORG);
-		expect(typeof launcher.props.runtimeContext).toBe("string");
-		expect((launcher.props.runtimeContext as string).length).toBeGreaterThan(0);
-	});
-
-	test("the DEFECT SHAPE: keying the raw response hit on an anchor link silently renders none", async () => {
-		// resource_key "response" + a null raw hit is the 2026-09-08 regression.
-		// The injector contract is fail-soft for the render, so the absence is
-		// quiet — this pins the shape with the reason spelled out, so the row
-		// can never go back to a key that is null on anchor links without the
-		// next reader finding this.
-		expect(await launcherCount(null, PAIRED, "response")).toBe(0);
-	});
-});

package/src/resource-chat-inject.test.ts

@@ -1,240 +0,0 @@
-// @system codegen
-// @status generated
-// @edit change the suite in the owned-suites band, then re-run codegen. Hand-edits are overwritten.
-//
-// This suite's assertions are OWNED by the codegen band: the band module
-// carries them verbatim, this file is the emission, and hand edits here are
-// overwritten on the next run. The rationale each assertion carries moved
-// with it into the band.
-
-import { describe, expect, mock, test } from "bun:test";
-
-/** The ONE active launcher block_schema slug — the Puck registry key. */
-const REGISTERED_LAUNCHER_SLUG = "ResourceLauncher";
-
-mock.module("@teamscala/db/registry/load-config", () => ({
-	loadRegistryConfig: async () => ({ agentId: "agent-1" }),
-}));
-mock.module("./page-server-orpc/server-client.ts", () => ({
-	getServerClient: () => ({
-		ai_agents: {
-			findFirst: async () => ({
-				name: "Agreement Assistant",
-				welcome_message: "Hi! Ask me anything about this agreement.",
-				conversation_starters: ["What are the key terms?", "How do I sign this?"],
-				primary_color: "#6366f1",
-			}),
-		},
-	}),
-}));
-mock.module("@teamscala/logger/app-loggers", () => ({
-	getAppLogger: () => ({ error: () => {} }),
-}));
-
-const { injectResourceChatLauncher } = await import("./resource-chat-inject.ts");
-
-function makeResolved(resourceKey: string): Record<string, unknown> {
-	return {
-		[resourceKey]: { organisation_id: "org-1", name: "Demo" },
-		brand: { primaryColor: "#123456" },
-		page: { puck_data: { root: { props: {} }, zones: {}, content: [] } },
-	};
-}
-
-function pushedBlocks(resolved: Record<string, unknown>) {
-	const pd = (
-		resolved.page as {
-			puck_data: { content: Array<{ type: string; props?: Record<string, unknown> }> };
-		}
-	).puck_data;
-	return pd.content;
-}
-
-describe("chat injectors — pushed block name resolves to a registered block", () => {
-	test("the generic resource injector pushes the registered launcher slug", async () => {
-		const resolved = makeResolved("agreement");
-		await injectResourceChatLauncher(resolved, "viewer@example.com", {
-			resourceKey: "agreement",
-			agentConfigSlug: "agreement-assistant-agent",
-			launchLabel: "Ask about this agreement",
-		});
-		const blocks = pushedBlocks(resolved);
-		expect(blocks).toHaveLength(1);
-		expect(blocks[0].type).toBe(REGISTERED_LAUNCHER_SLUG);
-	});
-
-	test("neither injector pushes a pre-consolidation launcher name", async () => {
-		const a = makeResolved("agreement");
-		await injectResourceChatLauncher(a, "viewer@example.com", {
-			resourceKey: "agreement",
-			agentConfigSlug: "agreement-assistant-agent",
-			launchLabel: "Ask about this agreement",
-		});
-		const p = makeResolved("proposal");
-		await injectResourceChatLauncher(p, "viewer@example.com", {
-			resourceKey: "proposal",
-			agentConfigSlug: "proposal-assistant-agent",
-			launchLabel: "Ask about this proposal",
-		});
-
-		const dead = ["ResourceChatLauncher", "ChatLauncherBlock"];
-		for (const blocks of [pushedBlocks(a), pushedBlocks(p)]) {
-			for (const block of blocks) {
-				expect(dead).not.toContain(block.type);
-			}
-		}
-	});
-
-	test("the assistant's words come from the agent row, not the caller", async () => {
-		// THE REGRESSION THIS PINS: title, welcome message and starters used to
-		// be string literals in the injectors while ai_agents held a blank
-		// column for each. Whoever changed the row saw no change on the page.
-		const resolved = makeResolved("agreement");
-		await injectResourceChatLauncher(resolved, "viewer@example.com", {
-			resourceKey: "agreement",
-			agentConfigSlug: "agreement-assistant-agent",
-			launchLabel: "Ask about this agreement",
-		});
-		const props = pushedBlocks(resolved)[0].props ?? {};
-		expect(props.title).toBe("Agreement Assistant");
-		expect(props.welcomeMessage).toBe("Hi! Ask me anything about this agreement.");
-		expect(props.conversationStarters).toEqual([
-			"What are the key terms?",
-			"How do I sign this?",
-		]);
-		// launchLabel has no column yet, so it is still the caller's.
-		expect(props.launchLabel).toBe("Ask about this agreement");
-	});
-});
-
-/** A region-slot page — the shape a quiz report resolves (no `page` source). */
-function makeAssessmentResolved(): Record<string, unknown> {
-	return {
-		response: {
-			organisation_id: "org-1",
-			email: "reader@example.com",
-			total_score: 95,
-			category_scores: { "Be Seen": 100, "Be Chosen": 83 },
-		},
-		quiz: { id: "quiz-1", report_title: "The Launcha Authority Index" },
-		reportData: { narrative: "You are strongest at being seen." },
-		brand: { primaryColor: "#123456" },
-		header: { puck_data: { content: [{ type: "SiteHeader" }] } },
-		body: { puck_data: { root: { props: {} }, zones: {}, content: [] } },
-		footer: { puck_data: { content: [{ type: "SiteFooter" }] } },
-	};
-}
-
-/** The launcher's props, wherever in the graph it was attached. */
-function launcherProps(resolved: Record<string, unknown>): Record<string, unknown> {
-	for (const value of Object.values(resolved)) {
-		const content = (value as { puck_data?: { content?: unknown } } | null)?.puck_data
-			?.content;
-		if (!Array.isArray(content)) continue;
-		const launcher = (content as Array<{ type: string; props?: Record<string, unknown> }>).find(
-			(block) => block.type === REGISTERED_LAUNCHER_SLUG,
-		);
-		if (launcher) return launcher.props ?? {};
-	}
-	throw new Error("no launcher block was attached to any region");
-}
-
-function bodyBlocks(resolved: Record<string, unknown>) {
-	return (
-		resolved.body as {
-			puck_data: { content: Array<{ type: string; props?: Record<string, unknown> }> };
-		}
-	).puck_data.content;
-}
-
-/**
- * REGION SLOTS COME FROM THE LOADER ROW, exactly as the caller reads them —
- * the injector is never allowed to guess which resolved keys hold content.
- */
-const assessmentOpts = {
-	resourceKey: "response",
-	agentConfigSlug: "assessment-assistant-agent" as never,
-	launchLabel: "Ask about your results",
-	regionSlots: ["header", "body", "footer"],
-};
-
-describe("region-slot pages (a generated report, not an authored document)", () => {
-	test("attaches to a declared region when there is no `page` source", async () => {
-		// THE DEFECT THIS PINS: the injector read resolved.page.puck_data.content
-		// and returned early when absent. A generated report resolves region
-		// slots instead, so the early return fired and the assistant was
-		// silently missing — fail-soft, so nothing was logged.
-		const resolved = makeAssessmentResolved();
-		await injectResourceChatLauncher(resolved, "reader@example.com", assessmentOpts);
-		// The first declared slot holding a content tree. The launcher is
-		// position:fixed, so any rendered region shows it identically.
-		const header = (
-			resolved.header as { puck_data: { content: Array<{ type: string }> } }
-		).puck_data.content;
-		expect(header.map((block) => block.type)).toContain(REGISTERED_LAUNCHER_SLUG);
-	});
-
-	test("follows the loader's slot order rather than a hardcoded key", async () => {
-		// Reordering the row must move the launcher. If this passes while the
-		// code names "body", the derivation is a literal wearing a costume.
-		const resolved = makeAssessmentResolved();
-		await injectResourceChatLauncher(resolved, "reader@example.com", {
-			...assessmentOpts,
-			regionSlots: ["body", "header", "footer"],
-		});
-		expect(bodyBlocks(resolved).map((block) => block.type)).toContain(
-			REGISTERED_LAUNCHER_SLUG,
-		);
-	});
-
-	test("sends the assessment RESULT, not just the rendered page", async () => {
-		// A report's body page is a shared template — one builda_pages row serves
-		// every respondent — so the content tree holds zero personal facts. An
-		// assistant given only the page would know nothing about this reader.
-		const resolved = makeAssessmentResolved();
-		await injectResourceChatLauncher(resolved, "reader@example.com", assessmentOpts);
-		const context = String(launcherProps(resolved).runtimeContext ?? "");
-		expect(context).toContain("total_score");
-		expect(context).toContain("95");
-		expect(context).toContain("Be Chosen");
-		expect(context).toContain("You are strongest at being seen.");
-		expect(context).toContain("The Launcha Authority Index");
-	});
-
-	test("sends the rendered document too, not just the result", async () => {
-		// The mirror of the test above: the reader is asking about what is on
-		// screen, so the assistant needs the document as well as the data.
-		const resolved = makeAssessmentResolved();
-		(
-			resolved.body as { puck_data: { content: unknown[] } }
-		).puck_data.content.push({ type: "ScoreDial", props: { label: "Authority" } });
-		await injectResourceChatLauncher(resolved, "reader@example.com", assessmentOpts);
-		const context = String(launcherProps(resolved).runtimeContext ?? "");
-		expect(context).toContain("ScoreDial");
-		expect(context).toContain("Authority");
-	});
-
-	test("names no resolved key — it sends whatever the loader produced", async () => {
-		// THE REGRESSION THIS PINS: a draft excluded brand/website/header/footer
-		// by name, which is a loader row copied into TypeScript. Those keys are
-		// database facts, so the serialiser must not have opinions about them —
-		// it walks the graph and a loader edit propagates with no code change.
-		const resolved = makeAssessmentResolved();
-		await injectResourceChatLauncher(resolved, "reader@example.com", assessmentOpts);
-		const context = String(launcherProps(resolved).runtimeContext ?? "");
-		for (const key of Object.keys(resolved)) {
-			expect(context).toContain(key);
-		}
-	});
-
-	test("carries a source a future loader adds, with no edit here", async () => {
-		// The serialiser walks the graph rather than naming keys, so a loader
-		// resolving a new source reaches the assistant for free.
-		const resolved = makeAssessmentResolved();
-		resolved.benchmarks = { industryMedian: 62 };
-		await injectResourceChatLauncher(resolved, "reader@example.com", assessmentOpts);
-		const context = String(launcherProps(resolved).runtimeContext ?? "");
-		expect(context).toContain("industryMedian");
-		expect(context).toContain("62");
-	});
-});