@teamscala/service-boot 0.23.413 → 0.23.415

package/src/register-registry-page-route/warn-uncovered-blocks.ts

@@ -0,0 +1,64 @@
+/**
+ * @system ui-service-boot
+ * @status handwritten
+ * @edit edit directly
+ *
+ * Block-coverage guard (protective-layers-fail-explicitly) for registered
+ * page routes.
+ *
+ * Split out of register-registry-page-route.ts (924 lines) — byte-for-byte
+ * move; only the import paths adjusted.
+ */
+
+import { getAppLogger } from "@teamscala/logger/app-loggers";
+import type { RendererComponentEntry } from "../types.ts";
+
+/**
+ * A page that renders a block whose component is NOT registered — because
+ * its package is missing from service_install.config.block_packages —
+ * silently renders BLANK. That is the exact failure behind the 2026-06-04
+ * scala-sign regression (sign-in-block dropped from block_packages → the
+ * gate + signature fields vanished) which left only a benign boot WARN.
+ * This turns that silent blank into a loud, GlitchTip-visible ERROR naming
+ * the page + block, throttled to once per (service, block type) so a hot
+ * path can never spam it.
+ */
+const uncoveredBlocksLogged = new Set<string>();
+
+function collectBlockTypes(node: unknown, out: Set<string>): void {
+	if (Array.isArray(node)) {
+		for (const child of node) collectBlockTypes(child, out);
+		return;
+	}
+	if (node && typeof node === "object") {
+		const obj = node as Record<string, unknown>;
+		if (
+			typeof obj.type === "string" &&
+			obj.props &&
+			typeof obj.props === "object"
+		) {
+			out.add(obj.type);
+		}
+		for (const value of Object.values(obj)) collectBlockTypes(value, out);
+	}
+}
+
+export function warnUncoveredBlocks(
+	pageData: unknown,
+	components: Record<string, RendererComponentEntry>,
+	serviceSlug: string,
+	path: unknown,
+	log: ReturnType<typeof getAppLogger>,
+): void {
+	const used = new Set<string>();
+	collectBlockTypes(pageData, used);
+	for (const type of used) {
+		if (type in components) continue;
+		const key = `${serviceSlug}:${type}`;
+		if (uncoveredBlocksLogged.has(key)) continue;
+		uncoveredBlocksLogged.add(key);
+		log.error(
+			`[scala-install:${serviceSlug}] page "${String(path)}" renders block "${type}" but NO component is registered for it — its package is almost certainly missing from service_install.config.block_packages, so it renders BLANK. Add the owning @teamscala/* package to block_packages and restart. (block-coverage guard)`,
+		);
+	}
+}