@cosmicdrift/kumiko-bundled-features 0.174.1 → 0.176.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-bundled-features",
-  "version": "0.174.1",
+  "version": "0.176.0",
   "description": "Built-in features — tenant, user, auth, delivery. The stuff you'd rewrite anyway, already typed.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -104,12 +104,10 @@
     "./personal-access-tokens/web": "./src/personal-access-tokens/web/index.ts",
     "./feature-toggles": "./src/feature-toggles/index.ts",
     "./feature-toggles/web": "./src/feature-toggles/web/index.ts",
-    "./text-content": "./src/text-content/index.ts",
-    "./text-content/seeding": "./src/text-content/seeding.ts",
-    "./text-content/web": "./src/text-content/web/index.ts",
     "./template-resolver": "./src/template-resolver/index.ts",
     "./template-resolver/seeding": "./src/template-resolver/seeding.ts",
     "./template-resolver/testing": "./src/template-resolver/testing.ts",
+    "./template-resolver/web": "./src/template-resolver/web/index.ts",
     "./renderer-foundation": "./src/renderer-foundation/index.ts",
     "./legal-pages": "./src/legal-pages/index.ts",
     "./legal-pages/web": "./src/legal-pages/web/index.ts",
@@ -122,12 +120,12 @@
     "./step-dispatcher": "./src/step-dispatcher/index.ts"
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-dispatcher-live": "0.174.1",
-    "@cosmicdrift/kumiko-framework": "0.174.1",
-    "@cosmicdrift/kumiko-headless": "0.174.1",
-    "@cosmicdrift/kumiko-renderer": "0.174.1",
-    "@cosmicdrift/kumiko-renderer-web": "0.174.1",
-    "@cosmicdrift/kumiko-types": "0.174.1",
+    "@cosmicdrift/kumiko-dispatcher-live": "0.176.0",
+    "@cosmicdrift/kumiko-framework": "0.176.0",
+    "@cosmicdrift/kumiko-headless": "0.176.0",
+    "@cosmicdrift/kumiko-renderer": "0.176.0",
+    "@cosmicdrift/kumiko-renderer-web": "0.176.0",
+    "@cosmicdrift/kumiko-types": "0.176.0",
     "@mollie/api-client": "^4.5.0",
     "imapflow": "^1.3.3",
     "mailparser": "^3.9.8",

package/src/__tests__/boot-seed-contract.integration.test.ts

@@ -17,17 +17,21 @@ import {
   tenantComplianceProfileTable,
 } from "../compliance-profiles/schema/profile-selection";
 import { seedComplianceProfile } from "../compliance-profiles/seeding";
-import { createTextContentFeature } from "../text-content/feature";
-import { seedTextBlock } from "../text-content/seeding";
-import { type TextBlockRow, textBlockEntity, textBlocksTable } from "../text-content/table";
+import { createTemplateResolverFeature } from "../template-resolver/feature";
+import { seedTextBlock } from "../template-resolver/seeding";
+import {
+  type TemplateResourceRow,
+  templateResourceEntity,
+  templateResourcesTable,
+} from "../template-resolver/table";
 
 let stack: TestStack;
 
 beforeAll(async () => {
   stack = await setupTestStack({
-    features: [createTextContentFeature(), createComplianceProfilesFeature()],
+    features: [createTemplateResolverFeature(), createComplianceProfilesFeature()],
   });
-  await unsafeCreateEntityTable(stack.db, textBlockEntity);
+  await unsafeCreateEntityTable(stack.db, templateResourceEntity);
   await unsafeCreateEntityTable(stack.db, tenantComplianceProfileEntity);
   await createEventsTable(stack.db);
 });
@@ -43,32 +47,32 @@ describe("boot-seed contract", () => {
     await seedTextBlock(stack.db, {
       tenantId,
       slug: "imprint",
-      lang: "de",
+      locale: "de",
       title: "Impressum",
-      body: "seed body",
+      content: "seed body",
     });
     await seedTextBlock(stack.db, {
       tenantId,
       slug: "imprint",
-      lang: "de",
+      locale: "de",
       title: "Impressum (edited)",
-      body: "admin body",
+      content: "admin body",
       ifExists: "update",
     });
     await seedTextBlock(stack.db, {
       tenantId,
       slug: "imprint",
-      lang: "de",
+      locale: "de",
       title: "Impressum",
-      body: "seed body",
+      content: "seed body",
     });
 
-    const row = await fetchOne<TextBlockRow>(stack.db, textBlocksTable, {
+    const row = await fetchOne<TemplateResourceRow>(stack.db, templateResourcesTable, {
       tenantId,
       slug: "imprint",
-      lang: "de",
+      locale: "de",
     });
-    expect(row).toMatchObject({ title: "Impressum (edited)", body: "admin body", version: 2 });
+    expect(row).toMatchObject({ title: "Impressum (edited)", content: "admin body", version: 2 });
 
     const events = await selectMany(stack.db, eventsTable, { aggregateId: String(row!.id) });
     expect(events).toHaveLength(2);

package/src/legal-pages/README.md

@@ -1,6 +1,6 @@
 # legal-pages
 
-Opt-in wrapper around [`text-content`](../text-content/) for
+Opt-in wrapper around [`template-resolver`](../template-resolver/) text-blocks for
 DACH compliance. Ships four fixed public HTML routes
 (`/legal/impressum`, `/legal/datenschutz`, `/legal/imprint`,
 `/legal/privacy`) with Markdown→HTML rendering and a boot check that
@@ -17,25 +17,25 @@ feature.
 ```typescript
 import { createLegalPagesFeature } from "@cosmicdrift/kumiko-bundled-features/legal-pages";
 import {
-  createTextContentApi,
-  createTextContentFeature,
-} from "@cosmicdrift/kumiko-bundled-features/text-content";
+  createTemplateResolverApi,
+  createTemplateResolverFeature,
+} from "@cosmicdrift/kumiko-bundled-features/template-resolver";
 import { SYSTEM_TENANT_ID } from "@cosmicdrift/kumiko-framework/engine";
 
 runProdApp({
   features: [
-    createTextContentFeature(),  // legal-pages requires text-content
+    createTemplateResolverFeature(),  // legal-pages requires template-resolver
     createLegalPagesFeature(),
     /* ... */
   ],
   // Two wirings are required:
   //   1. anonymousAccess for /legal/* routes (run without a JWT)
-  //   2. extraContext.textContent for the boot check (cross-feature
-  //      decoupling — legal-pages imports no code from text-content,
+  //   2. extraContext.templateResolver for the boot check (cross-feature
+  //      decoupling — legal-pages imports no code from template-resolver,
   //      only uses the API via ctx)
   anonymousAccess: { defaultTenantId: SYSTEM_TENANT_ID },
   extraContext: ({ db }) => ({
-    textContent: createTextContentApi(db),
+    templateResolver: createTemplateResolverApi(db),
   }),
 });
 ```
@@ -44,19 +44,20 @@ runProdApp({
 
 ### Production table setup
 
-legal-pages doesn't have its own table — it uses text-content's
-`read_text_blocks`. Table setup therefore goes through text-content:
+legal-pages doesn't have its own table — it stores its blocks as
+`kind: "text-block"` rows in template-resolver's `read_template_resources`.
+Table setup therefore goes through template-resolver:
 
 ```bash
-bun kumiko migrate generate    # text-block entity is detected
-bun kumiko migrate apply
+bun kumiko schema generate <name>   # template-resource entity is detected
+bun kumiko schema apply
 ```
 
-See [text-content/README.md](../text-content/README.md#production-table-setup).
+See [template-resolver/README.md](../template-resolver/README.md).
 
 ## Routes
 
-| Path | Slug + lang | Title fallback (when block empty) |
+| Path | Slug + locale | Title fallback (when block empty) |
 |---|---|---|
 | `GET /legal/impressum` | `imprint` / `de` | "Impressum" |
 | `GET /legal/datenschutz` | `privacy` / `de` | "Datenschutzerklärung" |
@@ -64,12 +65,12 @@ See [text-content/README.md](../text-content/README.md#production-table-setup).
 | `GET /legal/privacy` | `privacy` / `en` | "Privacy Policy" |
 
 Response:
-- `200 text/html` — block exists + has body. Cache header `public, max-age=300`.
+- `200 text/html` — block exists + has content. Cache header `public, max-age=300`.
 - `404 text/plain` — block missing. Hint: "Tenant admin must set this text block".
 - `503 text/plain` — `app.fetch` to `/api/query` failed (anonymousAccess missing?).
 
 Layout: a minimal HTML5 skeleton with inline CSS — apps that want to
-integrate into their own layout use `text-content:query:by-slug`
+integrate into their own layout use `template-resolver:query:by-slug`
 directly and render themselves.
 
 ---
@@ -79,7 +80,7 @@ directly and render themselves.
 `r.job` with `runOnBoot: true` checks at app start whether the DE
 required blocks exist in SYSTEM_TENANT:
 
-| Slug + lang | What happens when missing |
+| Slug + locale | What happens when missing |
 |---|---|
 | `imprint` / `de` | **Production:** `throw new Error(...)` blocks app start. **Dev:** `ctx.log.warn(...)` |
 | `privacy` / `de` | as above |
@@ -104,18 +105,18 @@ await fetch("/api/write", {
   method: "POST",
   headers: { "Content-Type": "application/json", Authorization: `Bearer ${jwt}` },
   body: JSON.stringify({
-    type: "text-content:write:set",
+    type: "template-resolver:write:set",
     payload: {
       slug: "imprint",
-      lang: "de",
+      locale: "de",
       title: "Impressum",
-      body: "## Angaben gemäß § 5 TMG\n\n...",
+      content: "## Angaben gemäß § 5 TMG\n\n...",
     },
   }),
 });
 ```
 
-→ Idempotent: a second call with the same `(slug, lang)` updates the block.
+→ Idempotent: a second call with the same `(slug, locale)` updates the block.
 ACL: `roles: ["TenantAdmin", "SystemAdmin"]` — SystemAdmin (a global
 role) may set SYSTEM_TENANT texts, TenantAdmin only tenant-owned ones.
 
@@ -128,15 +129,15 @@ instant visibility, you can help things along with a CDN purge.
 On first app boot or via migration:
 
 ```typescript
-import { seedTextBlock } from "@cosmicdrift/kumiko-bundled-features/text-content/seeding";
+import { seedTextBlock } from "@cosmicdrift/kumiko-bundled-features/template-resolver/seeding";
 import { SYSTEM_TENANT_ID } from "@cosmicdrift/kumiko-framework/engine";
 
 await seedTextBlock(db, {
   tenantId: SYSTEM_TENANT_ID,
   slug: "imprint",
-  lang: "de",
+  locale: "de",
   title: "Impressum",
-  body: `## Angaben gemäß § 5 TMG
+  content: `## Angaben gemäß § 5 TMG
 
 **Marc Frost**
 
@@ -181,7 +182,7 @@ no DOMPurify dependency needed:
 Kumiko app share the SYSTEM_TENANT version of the legal pages. If you
 need per-tenant imprints (rare — typical case: the platform operator
 is the responsible party, not the tenant customer), call
-text-content's by-slug query directly with a tenant-specific TenantId
+the by-slug query directly with a tenant-specific TenantId
 and put your own routes in front.
 
 ---

package/src/legal-pages/__tests__/legal-pages.integration.test.ts

@@ -1,11 +1,16 @@
 import { afterAll, beforeAll, describe, expect, test } from "bun:test";
-import type { TextContentApi } from "@cosmicdrift/kumiko-bundled-features/text-content";
+import type {
+  TemplateResolverApi,
+  TemplateResource,
+} from "@cosmicdrift/kumiko-bundled-features/template-resolver";
 import {
-  createTextContentApi,
-  createTextContentFeature,
-  textBlockEntity,
-} from "@cosmicdrift/kumiko-bundled-features/text-content";
-import { seedTextBlock } from "@cosmicdrift/kumiko-bundled-features/text-content/seeding";
+  createTemplateResolverApi,
+  createTemplateResolverFeature,
+  TEXT_BLOCK_KIND,
+  TemplateNotFoundError,
+  templateResourceEntity,
+} from "@cosmicdrift/kumiko-bundled-features/template-resolver";
+import { seedTextBlock } from "@cosmicdrift/kumiko-bundled-features/template-resolver/seeding";
 import type { DbConnection } from "@cosmicdrift/kumiko-framework/db";
 import { SYSTEM_TENANT_ID } from "@cosmicdrift/kumiko-framework/engine";
 import { createEventsTable } from "@cosmicdrift/kumiko-framework/event-store";
@@ -20,46 +25,46 @@ import { renderMarkdownToHtml, wrapInLayout } from "../markdown";
 let stack: TestStack;
 let db: DbConnection;
 
-const textFeature = createTextContentFeature();
+const textFeature = createTemplateResolverFeature();
 const legalFeature = createLegalPagesFeature();
 
 beforeAll(async () => {
   // legal-pages braucht zwei wirings:
   //   1. anonymousAccess für die /legal/*-Routes (laufen ohne JWT)
-  //   2. extraContext.textContent damit der Boot-Check + interner
+  //   2. extraContext.templateResolver damit der Boot-Check + interner
   //      Cross-Feature-Lookup ohne direct DB-Coupling funktioniert
   stack = await setupTestStack({
     features: [textFeature, legalFeature],
     anonymousAccess: { defaultTenantId: SYSTEM_TENANT_ID },
     extraContext: ({ db }) => ({
-      textContent: createTextContentApi(db),
+      templateResolver: createTemplateResolverApi(db),
     }),
   });
   db = stack.db;
-  await unsafeCreateEntityTable(db, textBlockEntity);
+  await unsafeCreateEntityTable(db, templateResourceEntity);
   await createEventsTable(db);
 
   // Seed legal blocks für SYSTEM_TENANT in DE
   await seedTextBlock(db, {
     tenantId: SYSTEM_TENANT_ID,
     slug: "imprint",
-    lang: "de",
+    locale: "de",
     title: "Impressum",
-    body: "## Angaben gemäß § 5 TMG\n\n**Marc Frost**\n\nSlevogtstr. 10, Leipzig",
+    content: "## Angaben gemäß § 5 TMG\n\n**Marc Frost**\n\nSlevogtstr. 10, Leipzig",
   });
   await seedTextBlock(db, {
     tenantId: SYSTEM_TENANT_ID,
     slug: "privacy",
-    lang: "de",
+    locale: "de",
     title: "Datenschutzerklärung",
-    body: "## 1. Überblick\n\nWir verarbeiten **keine Tracking-Cookies**.",
+    content: "## 1. Überblick\n\nWir verarbeiten **keine Tracking-Cookies**.",
   });
   await seedTextBlock(db, {
     tenantId: SYSTEM_TENANT_ID,
     slug: "imprint",
-    lang: "en",
+    locale: "en",
     title: "Imprint",
-    body: "## Provider\n\n**Marc Frost**\n\nLeipzig, Germany",
+    content: "## Provider\n\n**Marc Frost**\n\nLeipzig, Germany",
   });
 });
 
@@ -120,9 +125,9 @@ describe("legal-pages :: edge-cases", () => {
     await seedTextBlock(db, {
       tenantId: SYSTEM_TENANT_ID,
       slug: "imprint",
-      lang: "fr",
+      locale: "fr",
       title: "Mentions légales",
-      body: null,
+      content: null,
     });
     // Keine /legal/imprint-fr-Route registriert (LEGAL_ROUTES ist
     // de+en) — wir adden nicht extra. Stattdessen testen wir das
@@ -131,9 +136,9 @@ describe("legal-pages :: edge-cases", () => {
     await seedTextBlock(db, {
       tenantId: SYSTEM_TENANT_ID,
       slug: "privacy",
-      lang: "en",
+      locale: "en",
       title: "Privacy Policy",
-      body: null,
+      content: null,
     });
     const res = await stack.app.request("/legal/privacy");
     expect(res.status).toBe(404);
@@ -147,9 +152,9 @@ describe("legal-pages :: edge-cases", () => {
     await seedTextBlock(db, {
       tenantId: SYSTEM_TENANT_ID,
       slug: "imprint",
-      lang: "de",
+      locale: "de",
       title: "Impressum",
-      body: "## XSS-Test\n\n<script>window.x=1</script>\n\nDanach.",
+      content: "## XSS-Test\n\n<script>window.x=1</script>\n\nDanach.",
       ifExists: "update",
     });
     const res = await stack.app.request("/legal/impressum");
@@ -233,7 +238,7 @@ describe("legal-pages :: SYSTEM_TENANT-routing (production-bug-regression)", ()
     // (leeren) imprint-Block abfragen → 404. Mit Fix immer SYSTEM_TENANT.
     const otherTenantId = "22222222-2222-4222-8222-222222222222";
     const hostScopedStack = await setupTestStack({
-      features: [createTextContentFeature(), createLegalPagesFeature()],
+      features: [createTemplateResolverFeature(), createLegalPagesFeature()],
       anonymousAccess: {
         // Resolver gibt IMMER einen anderen Tenant zurück — wenn legal-
         // pages den respektieren würde, wäre der DB-Lookup leer.
@@ -245,20 +250,20 @@ describe("legal-pages :: SYSTEM_TENANT-routing (production-bug-regression)", ()
         tenantExists: async (id) => id === otherTenantId || id === SYSTEM_TENANT_ID,
       },
       extraContext: ({ db }) => ({
-        textContent: createTextContentApi(db),
+        templateResolver: createTemplateResolverApi(db),
       }),
     });
     try {
-      await unsafeCreateEntityTable(hostScopedStack.db, textBlockEntity);
+      await unsafeCreateEntityTable(hostScopedStack.db, templateResourceEntity);
       await createEventsTable(hostScopedStack.db);
 
       // Block NUR im SYSTEM_TENANT seeden — NICHT im otherTenantId
       await seedTextBlock(hostScopedStack.db, {
         tenantId: SYSTEM_TENANT_ID,
         slug: "imprint",
-        lang: "de",
+        locale: "de",
         title: "System-Impressum",
-        body: "## Plattform\n\nMarc Frost",
+        content: "## Plattform\n\nMarc Frost",
       });
 
       const res = await hostScopedStack.app.request("/legal/impressum");
@@ -277,7 +282,7 @@ describe("legal-pages :: wrapLayout erhält route.slug (alt-lang-switch-regressi
     const seenSlugs: (string | undefined)[] = [];
     const customStack = await setupTestStack({
       features: [
-        createTextContentFeature(),
+        createTemplateResolverFeature(),
         createLegalPagesFeature({
           wrapLayout: (opts) => {
             seenSlugs.push(opts.slug);
@@ -287,25 +292,25 @@ describe("legal-pages :: wrapLayout erhält route.slug (alt-lang-switch-regressi
       ],
       anonymousAccess: { defaultTenantId: SYSTEM_TENANT_ID },
       extraContext: ({ db }) => ({
-        textContent: createTextContentApi(db),
+        templateResolver: createTemplateResolverApi(db),
       }),
     });
     try {
-      await unsafeCreateEntityTable(customStack.db, textBlockEntity);
+      await unsafeCreateEntityTable(customStack.db, templateResourceEntity);
       await createEventsTable(customStack.db);
       await seedTextBlock(customStack.db, {
         tenantId: SYSTEM_TENANT_ID,
         slug: "imprint",
-        lang: "de",
+        locale: "de",
         title: "Impressum",
-        body: "Body",
+        content: "Body",
       });
       await seedTextBlock(customStack.db, {
         tenantId: SYSTEM_TENANT_ID,
         slug: "privacy",
-        lang: "de",
+        locale: "de",
         title: "Datenschutzerklärung",
-        body: "Body",
+        content: "Body",
       });
 
       const imprintRes = await customStack.app.request("/legal/impressum");
@@ -328,36 +333,61 @@ describe("legal-pages :: runLegalPagesBootCheck (direct unit-tests)", () => {
   // keine JobRunner-Coupling, keine Test-Stacks. Das ist die echte
   // Verhalten-Test-Surface; r.job() ist nur thin shell darum.
 
-  type Block = { slug: string; lang: string; title: string; body: string | null };
+  type Block = { slug: string; lang: string; title: string; content: string | null };
 
-  function fakeTextContent(blocks: readonly Block[]): {
-    api: TextContentApi;
+  function fakeTemplateResolver(blocks: readonly Block[]): {
+    api: TemplateResolverApi;
     calls: { tenantId: string; slug: string; lang: string }[];
   } {
     const calls: { tenantId: string; slug: string; lang: string }[] = [];
+    const find = (slug: string, locale: string): TemplateResource | null => {
+      const block = blocks.find((b) => b.slug === slug && b.lang === locale);
+      if (!block) return null;
+      return {
+        id: `${block.slug}-${block.lang}`,
+        version: 1,
+        tenantId: SYSTEM_TENANT_ID,
+        slug: block.slug,
+        kind: TEXT_BLOCK_KIND,
+        locale: block.lang,
+        title: block.title,
+        folder: null,
+        content: block.content ?? "",
+        contentFormat: "markdown",
+        variableSchema: {},
+        linkedResources: {},
+        scope: "system",
+        parentTemplateId: null,
+        status: "active",
+        updatedAt: new Date(),
+      };
+    };
     return {
       calls,
       api: {
-        getBlock: async ({ tenantId, slug, lang }) => {
-          calls.push({ tenantId, slug, lang });
-          const block = blocks.find((b) => b.slug === slug && b.lang === lang);
-          if (!block) return null;
-          return { ...block, updatedAt: new Date() };
+        findExact: async ({ tenantId, slug, locale }) => {
+          calls.push({ tenantId, slug, lang: locale });
+          return find(slug, locale);
+        },
+        resolveTemplate: async ({ slug, kind, locale }) => {
+          const found = find(slug, locale);
+          if (!found) throw new TemplateNotFoundError({ slug, kind, locale });
+          return found;
         },
       },
     };
   }
 
   test("alle Pflicht-Blocks vorhanden → log.info, kein throw", async () => {
-    const { api } = fakeTextContent([
-      { slug: "imprint", lang: "de", title: "I", body: "body" },
-      { slug: "privacy", lang: "de", title: "P", body: "body" },
+    const { api } = fakeTemplateResolver([
+      { slug: "imprint", lang: "de", title: "I", content: "body" },
+      { slug: "privacy", lang: "de", title: "P", content: "body" },
     ]);
     const infos: string[] = [];
     const warns: string[] = [];
     await expect(
       runLegalPagesBootCheck({
-        textContent: api,
+        templateResolver: api,
         log: { info: (m) => infos.push(m), warn: (m) => warns.push(m) },
       }),
     ).resolves.toBeUndefined();
@@ -367,11 +397,11 @@ describe("legal-pages :: runLegalPagesBootCheck (direct unit-tests)", () => {
   });
 
   test("missing blocks + NODE_ENV=production → throws mit slug-Liste", async () => {
-    const { api } = fakeTextContent([]);
+    const { api } = fakeTemplateResolver([]);
     const originalEnv = process.env["NODE_ENV"];
     process.env["NODE_ENV"] = "production";
     try {
-      await expect(runLegalPagesBootCheck({ textContent: api })).rejects.toThrow(
+      await expect(runLegalPagesBootCheck({ templateResolver: api })).rejects.toThrow(
         /Boot-Validation failed.*imprint\/de.*privacy\/de/s,
       );
     } finally {
@@ -381,14 +411,14 @@ describe("legal-pages :: runLegalPagesBootCheck (direct unit-tests)", () => {
   });
 
   test("missing blocks + NODE_ENV!=production → log.warn, kein throw", async () => {
-    const { api } = fakeTextContent([]);
+    const { api } = fakeTemplateResolver([]);
     const warns: string[] = [];
     const originalEnv = process.env["NODE_ENV"];
     process.env["NODE_ENV"] = "development";
     try {
       await expect(
         runLegalPagesBootCheck({
-          textContent: api,
+          templateResolver: api,
           log: { warn: (m) => warns.push(m) },
         }),
       ).resolves.toBeUndefined();
@@ -402,21 +432,23 @@ describe("legal-pages :: runLegalPagesBootCheck (direct unit-tests)", () => {
     }
   });
 
-  test("ctx ohne textContent → InternalError mit Wiring-Hinweis", async () => {
-    await expect(runLegalPagesBootCheck({})).rejects.toThrow(/textContent missing.*extraContext/s);
+  test("ctx ohne templateResolver → InternalError mit Wiring-Hinweis", async () => {
+    await expect(runLegalPagesBootCheck({})).rejects.toThrow(
+      /templateResolver missing.*extraContext/s,
+    );
   });
 
-  test("Block existiert aber body ist null → wird als missing gezählt", async () => {
-    const { api } = fakeTextContent([
-      { slug: "imprint", lang: "de", title: "I", body: null },
-      { slug: "privacy", lang: "de", title: "P", body: "body" },
+  test("Block existiert aber content ist null → wird als missing gezählt", async () => {
+    const { api } = fakeTemplateResolver([
+      { slug: "imprint", lang: "de", title: "I", content: null },
+      { slug: "privacy", lang: "de", title: "P", content: "body" },
     ]);
     const warns: string[] = [];
     const originalEnv = process.env["NODE_ENV"];
     process.env["NODE_ENV"] = "development";
     try {
       await runLegalPagesBootCheck({
-        textContent: api,
+        templateResolver: api,
         log: { warn: (m) => warns.push(m) },
       });
       expect(warns[0]).toContain("missing 1 required text-block(s)");
@@ -429,11 +461,11 @@ describe("legal-pages :: runLegalPagesBootCheck (direct unit-tests)", () => {
   });
 
   test("alle Lookups erfolgen gegen SYSTEM_TENANT_ID (nie tenant-scoped)", async () => {
-    const { api, calls } = fakeTextContent([
-      { slug: "imprint", lang: "de", title: "I", body: "x" },
-      { slug: "privacy", lang: "de", title: "P", body: "x" },
+    const { api, calls } = fakeTemplateResolver([
+      { slug: "imprint", lang: "de", title: "I", content: "x" },
+      { slug: "privacy", lang: "de", title: "P", content: "x" },
     ]);
-    await runLegalPagesBootCheck({ textContent: api });
+    await runLegalPagesBootCheck({ templateResolver: api });
     expect(calls).toHaveLength(2);
     for (const call of calls) {
       expect(call.tenantId).toBe(SYSTEM_TENANT_ID);