@aotter/mantle-runtime 0.0.11-alpha.11

package/dist/usecase/procedure/InvokeProcedureUseCase.js

@@ -0,0 +1,191 @@
+import { DiagnosticError, firstZodIssueAsJsonPointer, jsonSchemaToZod, makeDiagnostic, readJsonPointer, } from "@aotter/mantle-spec";
+import { evaluateAuthAll } from "../../domain/service/AuthPredicateEvaluator.js";
+/**
+ * `InvokeProcedureUseCase` — in-process invocation of a Procedure.
+ * HTTP-agnostic — the adapter's mount layer wraps this to map to/from
+ * `Request` / `Response`. The test harness exercises the same entry
+ * point.
+ *
+ * Order of operations:
+ *   1. Evaluate `requires.auth.all` predicates against `ctx`. Deny ⇒
+ *      `AUTH_DENIED`.
+ *   2. Validate `input` against the Procedure's `input` JSON Schema.
+ *      Fail ⇒ `INPUT_VALIDATION_FAILED` (first zod issue).
+ *   3. Dispatch by `handler.kind`:
+ *      - `ref`: resolve in registry, call (`InvokeFailure` → unwrap;
+ *        other throws → `INTERNAL_ERROR`).
+ *      - `builtin`: delegate to `InvokeBuiltinUseCase` (project +
+ *        stamp + chokepoint write per POC ADR-0014). When no builtin
+ *        collaborator was injected (test paths, ref-only runtimes) the
+ *        use case returns `HANDLER_BUILTIN_NOT_IN_V010`.
+ *   4. Validate the result against the `output` schema. Fail ⇒
+ *      `OUTPUT_VALIDATION_FAILED` (handler / builtin bug).
+ */
+/**
+ * Throwable carrier for handlers that want to surface a structured
+ * Diagnostic without going through the generic `INTERNAL_ERROR`
+ * envelope. The use case catches it and converts to an
+ * `{ ok: false, diagnostic }` return. Lives here (not in
+ * `usecase/dto/`) because it's a runtime value, not a DTO type.
+ */
+export class InvokeFailure extends Error {
+    diagnostic;
+    constructor(diagnostic) {
+        super(diagnostic.message);
+        this.diagnostic = diagnostic;
+        this.name = "InvokeFailure";
+    }
+}
+export class InvokeProcedureUseCase {
+    registry;
+    builtin;
+    // Per-Procedure compiled zod schemas. zod composition is pure
+    // object-tree assembly (no `new Function`) — Workers-CSP-safe.
+    // Cached per use-case instance because `jsonSchemaToZod` walks the
+    // JSON Schema once per call. Two runtimes with manifests sharing a
+    // procedure name + different schemas will get separate caches
+    // because the runtime owns the use case instance.
+    inputCache = new Map();
+    outputCache = new Map();
+    constructor(registry, builtin) {
+        this.registry = registry;
+        this.builtin = builtin;
+    }
+    async execute(request) {
+        const { procedure, input, ctx } = request;
+        const phase = request.phase ?? "runtime";
+        const procPath = request.pathPrefix ?? `manifest:Procedure/${procedure.metadata.name}`;
+        // 1. Auth.
+        const denial = evaluateAuthAll(procedure.spec.requires, ctx, procPath, phase);
+        if (denial)
+            return { ok: false, diagnostic: denial };
+        // 2. Input validation.
+        const inputValidator = this.compileInput(procedure);
+        const inputResult = inputValidator.safeParse(input);
+        if (!inputResult.success) {
+            const { instancePath, message } = firstZodIssueAsJsonPointer(inputResult.error);
+            return {
+                ok: false,
+                diagnostic: makeDiagnostic({
+                    code: "INPUT_VALIDATION_FAILED",
+                    phase,
+                    severity: "error",
+                    path: `${procPath}#/input${instancePath}`,
+                    value: readJsonPointer(input, instancePath),
+                    expected: message,
+                }),
+            };
+        }
+        // 3. Dispatch by handler kind.
+        const handlerBinding = procedure.spec.handler;
+        const handlerLabel = handlerBinding.kind === "builtin"
+            ? `builtin/${handlerBinding.op}`
+            : handlerBinding.ref;
+        let result;
+        try {
+            if (handlerBinding.kind === "builtin") {
+                if (!this.builtin) {
+                    return {
+                        ok: false,
+                        diagnostic: makeDiagnostic({
+                            code: "HANDLER_BUILTIN_NOT_IN_V010",
+                            phase,
+                            severity: "error",
+                            path: `${procPath}#/handler/kind`,
+                            value: handlerBinding.kind,
+                            expected: "InvokeBuiltinUseCase wired into the runtime",
+                            message: `Procedure '${procedure.metadata.name}' uses handler.kind: 'builtin' but the runtime was constructed without an InvokeBuiltinUseCase.`,
+                        }),
+                    };
+                }
+                result = await this.builtin.run({
+                    procedure,
+                    validatedInput: inputResult.data,
+                    ctx,
+                });
+            }
+            else {
+                const handler = this.registry.get(handlerBinding.ref);
+                if (!handler) {
+                    return {
+                        ok: false,
+                        diagnostic: makeDiagnostic({
+                            code: "HANDLER_NOT_REGISTERED",
+                            phase,
+                            severity: "error",
+                            path: `${procPath}#/handler/ref`,
+                            value: handlerBinding.ref,
+                            expected: "a ref registered via the handlers option / sdk.registerHandler",
+                            candidates: this.registry.list(),
+                        }),
+                    };
+                }
+                result = await handler(inputResult.data, ctx);
+            }
+        }
+        catch (err) {
+            if (err instanceof InvokeFailure) {
+                return { ok: false, diagnostic: err.diagnostic };
+            }
+            if (err instanceof DiagnosticError) {
+                return { ok: false, diagnostic: err.diagnostic };
+            }
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                ok: false,
+                diagnostic: makeDiagnostic({
+                    code: "INTERNAL_ERROR",
+                    phase,
+                    severity: "error",
+                    path: procPath,
+                    expected: "handler completes without throwing",
+                    message: `Handler '${handlerLabel}' threw: ${msg}`,
+                }),
+            };
+        }
+        // 4. Output validation.
+        const outputValidator = this.compileOutput(procedure);
+        const outputResult = outputValidator.safeParse(result);
+        if (!outputResult.success) {
+            const { instancePath, message } = firstZodIssueAsJsonPointer(outputResult.error);
+            return {
+                ok: false,
+                diagnostic: makeDiagnostic({
+                    code: "OUTPUT_VALIDATION_FAILED",
+                    phase,
+                    severity: "error",
+                    path: `${procPath}#/output${instancePath}`,
+                    value: readJsonPointer(result, instancePath),
+                    expected: message,
+                    message: `Handler '${handlerLabel}' returned a value that does not match its declared output schema. This is a handler bug.`,
+                }),
+            };
+        }
+        return { ok: true, data: result };
+    }
+    /** Test seam — clear validator caches between tests when manifests
+     *  change between runs. Production paths never call this. */
+    _clearValidatorCaches() {
+        this.inputCache.clear();
+        this.outputCache.clear();
+    }
+    compileInput(p) {
+        const k = p.metadata.name;
+        let v = this.inputCache.get(k);
+        if (!v) {
+            v = jsonSchemaToZod(p.spec.input);
+            this.inputCache.set(k, v);
+        }
+        return v;
+    }
+    compileOutput(p) {
+        const k = p.metadata.name;
+        let v = this.outputCache.get(k);
+        if (!v) {
+            v = jsonSchemaToZod(p.spec.output);
+            this.outputCache.set(k, v);
+        }
+        return v;
+    }
+}
+//# sourceMappingURL=InvokeProcedureUseCase.js.map

package/dist/usecase/procedure/InvokeProcedureUseCase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvokeProcedureUseCase.js","sourceRoot":"","sources":["../../../src/usecase/procedure/InvokeProcedureUseCase.ts"],"names":[],"mappings":"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"}

package/dist/usecase/procedure/index.d.ts

@@ -0,0 +1,3 @@
+export { InvokeProcedureUseCase, InvokeFailure } from "./InvokeProcedureUseCase.js";
+export { InvokeBuiltinUseCase } from "./InvokeBuiltinUseCase.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/usecase/procedure/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/usecase/procedure/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACpF,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/usecase/procedure/index.js

@@ -0,0 +1,3 @@
+export { InvokeProcedureUseCase, InvokeFailure } from "./InvokeProcedureUseCase.js";
+export { InvokeBuiltinUseCase } from "./InvokeBuiltinUseCase.js";
+//# sourceMappingURL=index.js.map

package/dist/usecase/procedure/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/usecase/procedure/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACpF,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/usecase/render/ComposeEntrySeoMetaUseCase.d.ts

@@ -0,0 +1,25 @@
+import type { DatabaseDriver } from "../../domain/port/DatabaseDriver.js";
+import { type SeoMeta } from "../../domain/service/SeoMetaComposer.js";
+import type { ComposeEntrySeoMetaRequest } from "../dto/render/ComposeEntrySeoMetaRequest.js";
+/**
+ * Compose the SEO/AEO meta block for an entry. Reads sibling
+ * translations from the DB (same collection, same slug, other
+ * locales) so hreflang links are accurate; calls the pure composer
+ * for the rest.
+ *
+ * "Same collection" is a deliberate simplification — works correctly
+ * for `post-translations`-style design where each locale has its own
+ * row in the same collection. Sites that split locales across
+ * collections (`posts-en`, `posts-zh`) need a custom resolver — out
+ * of scope for v0.1.
+ *
+ * Sibling lookup is one indexed `readEntryBySlug` per non-current
+ * locale — O(locales), not O(collection). Runs in parallel via
+ * `Promise.all`.
+ */
+export declare class ComposeEntrySeoMetaUseCase {
+    private readonly db;
+    constructor(db: DatabaseDriver);
+    execute(request: ComposeEntrySeoMetaRequest): Promise<SeoMeta>;
+}
+//# sourceMappingURL=ComposeEntrySeoMetaUseCase.d.ts.map

package/dist/usecase/render/ComposeEntrySeoMetaUseCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComposeEntrySeoMetaUseCase.d.ts","sourceRoot":"","sources":["../../../src/usecase/render/ComposeEntrySeoMetaUseCase.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAEL,KAAK,OAAO,EAEb,MAAM,yCAAyC,CAAC;AAGjD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6CAA6C,CAAC;AAE9F;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,0BAA0B;IACzB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,cAAc;IAEzC,OAAO,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,OAAO,CAAC;CAMrE"}

package/dist/usecase/render/ComposeEntrySeoMetaUseCase.js

@@ -0,0 +1,55 @@
+import { composeEntrySeoMeta, } from "../../domain/service/SeoMetaComposer.js";
+import { readEntryBySlug } from "../../domain/service/io/PublishedEntries.js";
+/**
+ * Compose the SEO/AEO meta block for an entry. Reads sibling
+ * translations from the DB (same collection, same slug, other
+ * locales) so hreflang links are accurate; calls the pure composer
+ * for the rest.
+ *
+ * "Same collection" is a deliberate simplification — works correctly
+ * for `post-translations`-style design where each locale has its own
+ * row in the same collection. Sites that split locales across
+ * collections (`posts-en`, `posts-zh`) need a custom resolver — out
+ * of scope for v0.1.
+ *
+ * Sibling lookup is one indexed `readEntryBySlug` per non-current
+ * locale — O(locales), not O(collection). Runs in parallel via
+ * `Promise.all`.
+ */
+export class ComposeEntrySeoMetaUseCase {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    async execute(request) {
+        const { entry, site, paths, type } = request;
+        const publicPath = paths.forEntry(entry) ?? "";
+        const siblings = await readSiblings(this.db, entry, site, paths);
+        return composeEntrySeoMeta({ entry, site, publicPath, siblings, type });
+    }
+}
+async function readSiblings(db, current, site, paths) {
+    const slug = current.data["slug"];
+    if (typeof slug !== "string" || slug.length === 0)
+        return [];
+    if (site.locales.length <= 1)
+        return [];
+    const currentKey = current.locale?.toLowerCase();
+    const targetLocales = site.locales.filter((l) => l.toLowerCase() !== currentKey);
+    const lookups = await Promise.all(targetLocales.map((locale) => readEntryBySlug(db, {
+        collection: current.collection,
+        slug,
+        locale,
+        status: "published",
+    }).then((e) => ({ locale, entry: e }))));
+    const out = [];
+    for (const { locale, entry } of lookups) {
+        if (!entry)
+            continue;
+        const path = paths.forEntry(entry);
+        if (path)
+            out.push({ locale, publicPath: path });
+    }
+    return out;
+}
+//# sourceMappingURL=ComposeEntrySeoMetaUseCase.js.map

package/dist/usecase/render/ComposeEntrySeoMetaUseCase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComposeEntrySeoMetaUseCase.js","sourceRoot":"","sources":["../../../src/usecase/render/ComposeEntrySeoMetaUseCase.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,mBAAmB,GAGpB,MAAM,yCAAyC,CAAC;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAG9E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,0BAA0B;IACR;IAA7B,YAA6B,EAAkB;QAAlB,OAAE,GAAF,EAAE,CAAgB;IAAG,CAAC;IAEnD,KAAK,CAAC,OAAO,CAAC,OAAmC;QAC/C,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;QAC7C,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC/C,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QACjE,OAAO,mBAAmB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1E,CAAC;CACF;AAED,KAAK,UAAU,YAAY,CACzB,EAAkB,EAClB,OAAc,EACd,IAAgB,EAChB,KAAyB;IAEzB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7D,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACxC,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC;IACjD,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,CAAC;IACjF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAC3B,eAAe,CAAC,EAAE,EAAE;QAClB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,IAAI;QACJ,MAAM;QACN,MAAM,EAAE,WAAW;KACpB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CACvC,CACF,CAAC;IACF,MAAM,GAAG,GAAyB,EAAE,CAAC;IACrC,KAAK,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,OAAO,EAAE,CAAC;QACxC,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,IAAI;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/usecase/render/ComposeLlmsTxtUseCase.d.ts

@@ -0,0 +1,19 @@
+import type { DatabaseDriver } from "../../domain/port/DatabaseDriver.js";
+import type { ComposeLlmsTxtRequest } from "../dto/render/ComposeLlmsTxtRequest.js";
+/**
+ * Compose a `/llms.txt` body from currently-published entries.
+ *
+ *   - locale: string  → entries with `data.locale === locale`
+ *   - locale: null    → non-localized entries only (publish-pipeline
+ *                       semantic; matches what HtmlPublishOrchestrator
+ *                       writes to `llms:root` on a non-localized
+ *                       publish). Consumers that want a cross-locale
+ *                       aggregate at the root URL should iterate
+ *                       site.locales themselves and concat.
+ */
+export declare class ComposeLlmsTxtUseCase {
+    private readonly db;
+    constructor(db: DatabaseDriver);
+    execute(request: ComposeLlmsTxtRequest): Promise<string>;
+}
+//# sourceMappingURL=ComposeLlmsTxtUseCase.d.ts.map

package/dist/usecase/render/ComposeLlmsTxtUseCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComposeLlmsTxtUseCase.d.ts","sourceRoot":"","sources":["../../../src/usecase/render/ComposeLlmsTxtUseCase.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAG1E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAEpF;;;;;;;;;;GAUG;AACH,qBAAa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,cAAc;IAEzC,OAAO,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;CAS/D"}

package/dist/usecase/render/ComposeLlmsTxtUseCase.js

@@ -0,0 +1,40 @@
+import { readPublishedEntries } from "../../domain/service/io/PublishedEntries.js";
+import { serializeLlmsTxt } from "../../domain/service/MarkdownSerializer.js";
+/**
+ * Compose a `/llms.txt` body from currently-published entries.
+ *
+ *   - locale: string  → entries with `data.locale === locale`
+ *   - locale: null    → non-localized entries only (publish-pipeline
+ *                       semantic; matches what HtmlPublishOrchestrator
+ *                       writes to `llms:root` on a non-localized
+ *                       publish). Consumers that want a cross-locale
+ *                       aggregate at the root URL should iterate
+ *                       site.locales themselves and concat.
+ */
+export class ComposeLlmsTxtUseCase {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    async execute(request) {
+        const entries = await readPublishedEntries(this.db, { locale: request.locale });
+        const grouped = groupByCollection(entries);
+        return serializeLlmsTxt({
+            site: request.site,
+            locale: request.locale ?? "",
+            entriesByCollection: grouped,
+        });
+    }
+}
+function groupByCollection(entries) {
+    const out = new Map();
+    for (const e of entries) {
+        const arr = out.get(e.collection);
+        if (arr)
+            arr.push(e);
+        else
+            out.set(e.collection, [e]);
+    }
+    return out;
+}
+//# sourceMappingURL=ComposeLlmsTxtUseCase.js.map

package/dist/usecase/render/ComposeLlmsTxtUseCase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComposeLlmsTxtUseCase.js","sourceRoot":"","sources":["../../../src/usecase/render/ComposeLlmsTxtUseCase.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAG9E;;;;;;;;;;GAUG;AACH,MAAM,OAAO,qBAAqB;IACH;IAA7B,YAA6B,EAAkB;QAAlB,OAAE,GAAF,EAAE,CAAgB;IAAG,CAAC;IAEnD,KAAK,CAAC,OAAO,CAAC,OAA8B;QAC1C,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAChF,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAC3C,OAAO,gBAAgB,CAAC;YACtB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;YAC5B,mBAAmB,EAAE,OAAO;SAC7B,CAAC,CAAC;IACL,CAAC;CACF;AAED,SAAS,iBAAiB,CAAC,OAAyB;IAClD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAmB,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QAClC,IAAI,GAAG;YAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;;YAChB,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/usecase/render/ComposeSitemapUseCase.d.ts

@@ -0,0 +1,15 @@
+import type { DatabaseDriver } from "../../domain/port/DatabaseDriver.js";
+import type { ComposeSitemapRequest } from "../dto/render/ComposeSitemapRequest.js";
+/**
+ * Compose `sitemap.xml` from every published entry across all
+ * collections + locales. Result is XML text; consumer routes it as
+ * `application/xml`. See ComposeSitemapRequest for the pathFor +
+ * maxUrls knobs.
+ */
+export declare const SITEMAP_MAX_URLS_DEFAULT = 50000;
+export declare class ComposeSitemapUseCase {
+    private readonly db;
+    constructor(db: DatabaseDriver);
+    execute(request: ComposeSitemapRequest): Promise<string>;
+}
+//# sourceMappingURL=ComposeSitemapUseCase.d.ts.map

package/dist/usecase/render/ComposeSitemapUseCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComposeSitemapUseCase.d.ts","sourceRoot":"","sources":["../../../src/usecase/render/ComposeSitemapUseCase.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAI1E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAEpF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,QAAQ,CAAC;AAE9C,qBAAa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,cAAc;IAEzC,OAAO,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;CAW/D"}

package/dist/usecase/render/ComposeSitemapUseCase.js

@@ -0,0 +1,29 @@
+import { readPublishedEntries } from "../../domain/service/io/PublishedEntries.js";
+import { entryPublicPath } from "../../domain/service/PublishKeys.js";
+import { serializeSitemap } from "../../domain/service/SitemapSerializer.js";
+/**
+ * Compose `sitemap.xml` from every published entry across all
+ * collections + locales. Result is XML text; consumer routes it as
+ * `application/xml`. See ComposeSitemapRequest for the pathFor +
+ * maxUrls knobs.
+ */
+export const SITEMAP_MAX_URLS_DEFAULT = 50000;
+export class ComposeSitemapUseCase {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    async execute(request) {
+        const cap = request.maxUrls ?? SITEMAP_MAX_URLS_DEFAULT;
+        const all = await readPublishedEntries(this.db, { limit: cap });
+        const mapper = request.pathFor ?? entryPublicPath;
+        const entries = [];
+        for (const e of all) {
+            const path = mapper(e);
+            if (path !== null)
+                entries.push({ entry: e, path });
+        }
+        return serializeSitemap({ site: request.site, entries });
+    }
+}
+//# sourceMappingURL=ComposeSitemapUseCase.js.map

package/dist/usecase/render/ComposeSitemapUseCase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComposeSitemapUseCase.js","sourceRoot":"","sources":["../../../src/usecase/render/ComposeSitemapUseCase.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAG7E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,CAAC;AAE9C,MAAM,OAAO,qBAAqB;IACH;IAA7B,YAA6B,EAAkB;QAAlB,OAAE,GAAF,EAAE,CAAgB;IAAG,CAAC;IAEnD,KAAK,CAAC,OAAO,CAAC,OAA8B;QAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,IAAI,wBAAwB,CAAC;QACxD,MAAM,GAAG,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,IAAI,eAAe,CAAC;QAClD,MAAM,OAAO,GAAqC,EAAE,CAAC;QACrD,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACvB,IAAI,IAAI,KAAK,IAAI;gBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,gBAAgB,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3D,CAAC;CACF"}

package/dist/usecase/render/PreviewEntryUseCase.d.ts

@@ -0,0 +1,26 @@
+import type { SchemaManifest } from "@aotter/mantle-spec";
+import type { DatabaseDriver } from "../../domain/port/DatabaseDriver.js";
+import type { TemplateRegistry } from "../../domain/model/TemplateRegistry.js";
+import type { PublicPathResolver } from "../../domain/service/PublicPathResolver.js";
+import type { PreviewEntryRequest } from "../dto/render/PreviewEntryRequest.js";
+import { type SeoComposer } from "../../domain/service/EntrySeoSupport.js";
+/**
+ * Render an entry with a preview banner. Walks `statusOrder` until a
+ * matching row is found, renders via the registered template, then
+ * injects the banner just inside `<body>`. Returns `null` when no
+ * matching row exists or no template is registered.
+ *
+ * Composes SEO/AEO meta when the runtime was built with a
+ * `publicPathResolver` — preview pages match the meta the published
+ * version would carry, so authors see real shape during review.
+ */
+export declare class PreviewEntryUseCase {
+    private readonly db;
+    private readonly templates;
+    private readonly paths;
+    private readonly composeSeo;
+    private readonly schemas;
+    constructor(db: DatabaseDriver, templates: TemplateRegistry, paths: PublicPathResolver | null, composeSeo: SeoComposer, schemas: ReadonlyMap<string, SchemaManifest>);
+    execute(request: PreviewEntryRequest): Promise<string | null>;
+}
+//# sourceMappingURL=PreviewEntryUseCase.d.ts.map

package/dist/usecase/render/PreviewEntryUseCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PreviewEntryUseCase.d.ts","sourceRoot":"","sources":["../../../src/usecase/render/PreviewEntryUseCase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAuB,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAQrF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,yCAAyC,CAAC;AAUjD;;;;;;;;;GASG;AACH,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAJP,EAAE,EAAE,cAAc,EAClB,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,kBAAkB,GAAG,IAAI,EAChC,UAAU,EAAE,WAAW,EACvB,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC;IAGzD,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CA6BpE"}

package/dist/usecase/render/PreviewEntryUseCase.js

@@ -0,0 +1,69 @@
+import { readEntryBySlug } from "../../domain/service/io/PublishedEntries.js";
+import { joinParentIfTranslation } from "../../domain/service/io/JoinedEntryReader.js";
+import { renderEntryHtml } from "../../domain/service/HtmlRenderer.js";
+import { defaultPreviewBanner, injectPreviewBanner, } from "../../domain/service/PreviewBanner.js";
+import { composeSeoIfPathed, } from "../../domain/service/EntrySeoSupport.js";
+/** Default fallback: prefer drafts, fall back to published, then
+ *  archived. Authors typically open `?preview=1` to see WIP. */
+const DEFAULT_PREVIEW_STATUS_ORDER = [
+    "draft",
+    "published",
+    "archived",
+];
+/**
+ * Render an entry with a preview banner. Walks `statusOrder` until a
+ * matching row is found, renders via the registered template, then
+ * injects the banner just inside `<body>`. Returns `null` when no
+ * matching row exists or no template is registered.
+ *
+ * Composes SEO/AEO meta when the runtime was built with a
+ * `publicPathResolver` — preview pages match the meta the published
+ * version would carry, so authors see real shape during review.
+ */
+export class PreviewEntryUseCase {
+    db;
+    templates;
+    paths;
+    composeSeo;
+    schemas;
+    constructor(db, templates, paths, composeSeo, schemas) {
+        this.db = db;
+        this.templates = templates;
+        this.paths = paths;
+        this.composeSeo = composeSeo;
+        this.schemas = schemas;
+    }
+    async execute(request) {
+        const order = request.statusOrder ?? DEFAULT_PREVIEW_STATUS_ORDER;
+        let raw = null;
+        for (const status of order) {
+            raw = await readEntryBySlug(this.db, {
+                collection: request.collection,
+                slug: request.slug,
+                locale: request.locale,
+                status,
+            });
+            if (raw)
+                break;
+        }
+        if (!raw)
+            return null;
+        // Preview can show drafts; parent lookup intentionally omits status
+        // filter so a draft translation can still preview against its
+        // already-published parent. RequestPublishUseCase enforces the
+        // published-parent invariant at publish time.
+        const entry = await joinParentIfTranslation(this.db, this.schemas, raw);
+        const seo = await composeSeoIfPathed(this.composeSeo, this.paths, entry, request.site);
+        const html = renderEntryHtml({
+            entry,
+            site: request.site,
+            templates: this.templates,
+            seo,
+        });
+        if (html === null)
+            return null;
+        const banner = request.banner ?? defaultPreviewBanner(entry.status, request.slug);
+        return injectPreviewBanner(html, banner);
+    }
+}
+//# sourceMappingURL=PreviewEntryUseCase.js.map

package/dist/usecase/render/PreviewEntryUseCase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PreviewEntryUseCase.js","sourceRoot":"","sources":["../../../src/usecase/render/PreviewEntryUseCase.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EACL,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,uCAAuC,CAAC;AAE/C,OAAO,EACL,kBAAkB,GAEnB,MAAM,yCAAyC,CAAC;AAEjD;gEACgE;AAChE,MAAM,4BAA4B,GAAgC;IAChE,OAAO;IACP,WAAW;IACX,UAAU;CACX,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,OAAO,mBAAmB;IAEX;IACA;IACA;IACA;IACA;IALnB,YACmB,EAAkB,EAClB,SAA2B,EAC3B,KAAgC,EAChC,UAAuB,EACvB,OAA4C;QAJ5C,OAAE,GAAF,EAAE,CAAgB;QAClB,cAAS,GAAT,SAAS,CAAkB;QAC3B,UAAK,GAAL,KAAK,CAA2B;QAChC,eAAU,GAAV,UAAU,CAAa;QACvB,YAAO,GAAP,OAAO,CAAqC;IAC5D,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,OAA4B;QACxC,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,IAAI,4BAA4B,CAAC;QAClE,IAAI,GAAG,GAAiB,IAAI,CAAC;QAC7B,KAAK,MAAM,MAAM,IAAI,KAAK,EAAE,CAAC;YAC3B,GAAG,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,EAAE,EAAE;gBACnC,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,MAAM;aACP,CAAC,CAAC;YACH,IAAI,GAAG;gBAAE,MAAM;QACjB,CAAC;QACD,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,oEAAoE;QACpE,8DAA8D;QAC9D,+DAA+D;QAC/D,8CAA8C;QAC9C,MAAM,KAAK,GAAG,MAAM,uBAAuB,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACxE,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACvF,MAAM,IAAI,GAAG,eAAe,CAAC;YAC3B,KAAK;YACL,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,GAAG;SACJ,CAAC,CAAC;QACH,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,oBAAoB,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAClF,OAAO,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/dist/usecase/render/RenderEntryLiveUseCase.d.ts

@@ -0,0 +1,35 @@
+import type { SchemaManifest } from "@aotter/mantle-spec";
+import type { DatabaseDriver } from "../../domain/port/DatabaseDriver.js";
+import type { TemplateRegistry } from "../../domain/model/TemplateRegistry.js";
+import type { PublicPathResolver } from "../../domain/service/PublicPathResolver.js";
+import type { RenderEntryLiveRequest } from "../dto/render/RenderEntryLiveRequest.js";
+import { type SeoComposer } from "../../domain/service/EntrySeoSupport.js";
+/**
+ * Render a single entry from current DB state. Used by adapter live-
+ * dev routes (`CLAM_LOCAL_DEV=1`) to bypass the KV cache and pick up
+ * template / chrome edits without re-running the publish pipeline.
+ *
+ * When the runtime was built with a `publicPathResolver`, the SEO/AEO
+ * meta block is composed and threaded into `EntryContext.seo` — so
+ * live-rendered HTML carries the same meta KV-cached HTML does.
+ *
+ * When the entry belongs to a collection with `translates.parent`,
+ * the parent's data is merged into the translation's data (ADR-0010)
+ * before rendering, so template fields living on the parent
+ * (`coverUrl`, `authorId`, `publishedAt`) reach the template.
+ *
+ * Returns the full HTML document, or `null` when:
+ *   - no entry matches `(collection, slug, locale, status)`
+ *   - the collection has no registered entry template
+ * Adapters map `null` to a 404 response.
+ */
+export declare class RenderEntryLiveUseCase {
+    private readonly db;
+    private readonly templates;
+    private readonly paths;
+    private readonly composeSeo;
+    private readonly schemas;
+    constructor(db: DatabaseDriver, templates: TemplateRegistry, paths: PublicPathResolver | null, composeSeo: SeoComposer, schemas: ReadonlyMap<string, SchemaManifest>);
+    execute(request: RenderEntryLiveRequest): Promise<string | null>;
+}
+//# sourceMappingURL=RenderEntryLiveUseCase.d.ts.map

package/dist/usecase/render/RenderEntryLiveUseCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderEntryLiveUseCase.d.ts","sourceRoot":"","sources":["../../../src/usecase/render/RenderEntryLiveUseCase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAIrF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,yCAAyC,CAAC;AAEjD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,sBAAsB;IAE/B,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAJP,EAAE,EAAE,cAAc,EAClB,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,kBAAkB,GAAG,IAAI,EAChC,UAAU,EAAE,WAAW,EACvB,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC;IAGzD,OAAO,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAoBvE"}

package/dist/usecase/render/RenderEntryLiveUseCase.js

@@ -0,0 +1,59 @@
+import { readEntryBySlug } from "../../domain/service/io/PublishedEntries.js";
+import { joinParentIfTranslation } from "../../domain/service/io/JoinedEntryReader.js";
+import { renderEntryHtml } from "../../domain/service/HtmlRenderer.js";
+import { composeSeoIfPathed, } from "../../domain/service/EntrySeoSupport.js";
+/**
+ * Render a single entry from current DB state. Used by adapter live-
+ * dev routes (`CLAM_LOCAL_DEV=1`) to bypass the KV cache and pick up
+ * template / chrome edits without re-running the publish pipeline.
+ *
+ * When the runtime was built with a `publicPathResolver`, the SEO/AEO
+ * meta block is composed and threaded into `EntryContext.seo` — so
+ * live-rendered HTML carries the same meta KV-cached HTML does.
+ *
+ * When the entry belongs to a collection with `translates.parent`,
+ * the parent's data is merged into the translation's data (ADR-0010)
+ * before rendering, so template fields living on the parent
+ * (`coverUrl`, `authorId`, `publishedAt`) reach the template.
+ *
+ * Returns the full HTML document, or `null` when:
+ *   - no entry matches `(collection, slug, locale, status)`
+ *   - the collection has no registered entry template
+ * Adapters map `null` to a 404 response.
+ */
+export class RenderEntryLiveUseCase {
+    db;
+    templates;
+    paths;
+    composeSeo;
+    schemas;
+    constructor(db, templates, paths, composeSeo, schemas) {
+        this.db = db;
+        this.templates = templates;
+        this.paths = paths;
+        this.composeSeo = composeSeo;
+        this.schemas = schemas;
+    }
+    async execute(request) {
+        const status = request.status ?? "published";
+        const raw = await readEntryBySlug(this.db, {
+            collection: request.collection,
+            slug: request.slug,
+            locale: request.locale,
+            status,
+        });
+        if (!raw)
+            return null;
+        const entry = await joinParentIfTranslation(this.db, this.schemas, raw, {
+            parentStatus: status,
+        });
+        const seo = await composeSeoIfPathed(this.composeSeo, this.paths, entry, request.site);
+        return renderEntryHtml({
+            entry,
+            site: request.site,
+            templates: this.templates,
+            seo,
+        });
+    }
+}
+//# sourceMappingURL=RenderEntryLiveUseCase.js.map