@aotter/mantle-runtime 0.0.11-alpha.11

package/dist/infrastructure/persistence/DatabaseSiteConfigRepository.js

@@ -0,0 +1,101 @@
+import { assertSiteDefaultsCanonical, } from "@aotter/mantle-spec";
+/**
+ * `site_config` row read/write. Ships the seed declared by
+ * `clam.config.ts > siteDefaults` on first deploy via INSERT … ON
+ * CONFLICT DO NOTHING so operator edits are never overwritten on
+ * subsequent deploys.
+ *
+ * The runtime calls `seed` once during bootInit; the result of `load`
+ * is what every render path and template sees.
+ *
+ * Lives in `infrastructure/persistence/` because it talks to the DB
+ * directly. Pure-domain validation (`assertSiteDefaultsCanonical`)
+ * comes from spec.
+ */
+const KEYS = {
+    brand: "brand",
+    title: "title",
+    description: "description",
+    origin: "origin",
+    locales: "locales",
+    faviconUrl: "faviconUrl",
+    mediaPurposes: "mediaPurposes",
+};
+function splitCsv(raw) {
+    if (!raw)
+        return [];
+    return raw.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+}
+export class DatabaseSiteConfigRepository {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    async seed(defaults) {
+        if (!defaults)
+            return;
+        assertSiteDefaultsCanonical(defaults);
+        const stmts = [];
+        const insert = (key, value) => this.db
+            .prepare(`INSERT INTO site_config (key, value) VALUES (?, ?) ON CONFLICT(key) DO NOTHING`)
+            .bind(key, value);
+        if (defaults.brand && defaults.brand.length > 0) {
+            stmts.push(insert(KEYS.brand, defaults.brand));
+        }
+        if (defaults.title && defaults.title.length > 0) {
+            stmts.push(insert(KEYS.title, defaults.title));
+        }
+        if (defaults.description && defaults.description.length > 0) {
+            stmts.push(insert(KEYS.description, defaults.description));
+        }
+        if (defaults.origin && defaults.origin.length > 0) {
+            stmts.push(insert(KEYS.origin, defaults.origin));
+        }
+        if (defaults.faviconUrl && defaults.faviconUrl.length > 0) {
+            stmts.push(insert(KEYS.faviconUrl, defaults.faviconUrl));
+        }
+        if (defaults.locales && defaults.locales.length > 0) {
+            stmts.push(insert(KEYS.locales, defaults.locales.join(",")));
+        }
+        const purposes = defaults.media?.purposes;
+        if (purposes && purposes.length > 0) {
+            stmts.push(insert(KEYS.mediaPurposes, purposes.join(",")));
+        }
+        if (stmts.length > 0) {
+            await this.db.batch(stmts);
+        }
+    }
+    async load() {
+        const rows = await this.db
+            .prepare(`SELECT key, value FROM site_config`)
+            .all();
+        const m = new Map(rows.map((r) => [r.key, r.value]));
+        const locales = splitCsv(m.get(KEYS.locales));
+        const purposes = splitCsv(m.get(KEYS.mediaPurposes));
+        return {
+            title: m.get(KEYS.title) ?? "CMS",
+            description: m.get(KEYS.description) ?? "",
+            origin: m.get(KEYS.origin) ?? "",
+            locales,
+            canonicalLocale: locales[0] ?? null,
+            brand: m.get(KEYS.brand) ?? "AotterMantle",
+            faviconUrl: m.get(KEYS.faviconUrl) || undefined,
+            media: { purposes },
+        };
+    }
+    async readLocales() {
+        const row = await this.db
+            .prepare(`SELECT value FROM site_config WHERE key = ?`)
+            .bind(KEYS.locales)
+            .first();
+        return splitCsv(row?.value);
+    }
+    async readMediaPurposes() {
+        const row = await this.db
+            .prepare(`SELECT value FROM site_config WHERE key = ?`)
+            .bind(KEYS.mediaPurposes)
+            .first();
+        return splitCsv(row?.value);
+    }
+}
+//# sourceMappingURL=DatabaseSiteConfigRepository.js.map

package/dist/infrastructure/persistence/DatabaseSiteConfigRepository.js.map

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

package/dist/infrastructure/persistence/LifecycleHookingEntryRepository.d.ts

@@ -0,0 +1,74 @@
+import type { EntryRow } from "../../domain/model/EntryRow.js";
+import { type DeferredHookDispatcher } from "../../domain/port/DeferredHookDispatcher.js";
+import type { ArchiveEntryArgs, CreateEntryArgs, DeleteEntryArgs, EntryRepository, FindEntryByDataFieldArgs, FindEntryByDataFieldsArgs, ListEntriesArgs, ListEntriesResult, TransitionStatusArgs, UpdateEntryArgs } from "../../domain/port/EntryRepository.js";
+import type { LifecycleHookRunner } from "../../domain/port/LifecycleHookRunner.js";
+import type { TriggerIndex } from "../../domain/service/TriggerIndex.js";
+/**
+ * Decorator that wraps any `EntryRepository` and fires lifecycle
+ * Triggers around every mutation (POC ADR-0014).
+ *
+ * Symmetry rule: MCP, admin, and builtin write paths all hit the same
+ * chokepoint, so all three pay (and gain) the same hook semantics —
+ * authors don't need to remember "hooks fire on path X but not Y."
+ *
+ * Hook → mutation mapping:
+ *   - `create` → `before_create` / `after_create`
+ *   - `update` → `before_update` / `after_update`
+ *   - `delete` → `before_delete` / `after_delete`
+ *   - `archive` → `before_update` / `after_update` (status flip is
+ *      a kind of update; explicit archive hooks are v0.2 if needed)
+ *   - `transitionStatus({ to: 'published' })` → `before_publish` /
+ *      `after_publish`; other targets fire `before_update` /
+ *      `after_update`
+ *
+ * Short-circuits when no Trigger watches the row's collection — no
+ * hook runner call, no per-mutation overhead.
+ *
+ * `before_*` runs synchronously: a thrown `DiagnosticError` from the
+ * runner cancels the mutation. `after_*` runs after the inner write
+ * succeeds — fire-and-forget via `ctx.waitUntil` if the adapter
+ * populated it; otherwise inline-await.
+ */
+export declare class LifecycleHookingEntryRepository implements EntryRepository {
+    private readonly inner;
+    private readonly triggers;
+    private readonly hooks;
+    private readonly deferred?;
+    constructor(inner: EntryRepository, triggers: TriggerIndex, hooks: LifecycleHookRunner, deferred?: DeferredHookDispatcher | undefined);
+    create(args: CreateEntryArgs): Promise<EntryRow>;
+    get(id: string): Promise<EntryRow | null>;
+    update(args: UpdateEntryArgs): Promise<EntryRow>;
+    delete(args: DeleteEntryArgs): Promise<{
+        readonly removed: boolean;
+    }>;
+    archive(args: ArchiveEntryArgs): Promise<EntryRow>;
+    transitionStatus(args: TransitionStatusArgs): Promise<EntryRow>;
+    list(args: ListEntriesArgs): Promise<ListEntriesResult>;
+    findByDataField(args: FindEntryByDataFieldArgs): Promise<EntryRow | null>;
+    findByDataFields(args: FindEntryByDataFieldsArgs): Promise<EntryRow | null>;
+    /**
+     * After-hook execution. Tries delivery rungs in order:
+     *
+     *   1. `deferred.enqueue(envelope)` — adapter-backed deferred path
+     *      (CF Workers Queues, Inngest, pg-boss, …). Survives isolate
+     *      death; consume invocation rehydrates the envelope and re-fires
+     *      via `CmsRuntime.runDeferredHook`. A rejection downgrades to
+     *      the next rung rather than dropping the hook silently.
+     *   2. `ctx.waitUntil(promise)` — adapter-populated fire-and-forget
+     *      bridge (CF Workers `ExecutionContext`). Fast but non-durable:
+     *      isolate death between response and resolution loses the work.
+     *   3. inline `await promise` — non-Workers runtimes (Bun / Node /
+     *      tests) where detached promises get cancelled with the request.
+     *      Trades response latency for hook-fire reliability.
+     *
+     * Hook throws are surfaced via `RunLifecycleHooksUseCase`'s
+     * `errorPolicy` semantics; for `continue` the runner already
+     * `console.error`s and swallows. Anything that escapes the inline
+     * branch here is an abort-policy throw on a before_* (impossible —
+     * the parser rejects `errorPolicy: abort` on after_* hooks) or an
+     * unexpected internal error; we log and swallow so the mutation
+     * result still reaches the caller.
+     */
+    private fireAfter;
+}
+//# sourceMappingURL=LifecycleHookingEntryRepository.d.ts.map

package/dist/infrastructure/persistence/LifecycleHookingEntryRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LifecycleHookingEntryRepository.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/persistence/LifecycleHookingEntryRepository.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAE/D,OAAO,EAEL,KAAK,sBAAsB,EAE5B,MAAM,6CAA6C,CAAC;AACrD,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,eAAe,EACf,wBAAwB,EACxB,yBAAyB,EACzB,eAAe,EACf,iBAAiB,EAEjB,oBAAoB,EACpB,eAAe,EAChB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AACpF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAIzE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,+BAAgC,YAAW,eAAe;IAEnE,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAHT,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,CAAC,EAAE,sBAAsB,YAAA;IAG9C,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC;IAiBtD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAInC,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC;IAmBhD,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAqBrE,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAmBlD,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAsBrE,IAAI,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIvD,eAAe,CAAC,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAIzE,gBAAgB,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAI3E;;;;;;;;;;;;;;;;;;;;;;OAsBG;YACW,SAAS;CAuCxB"}

package/dist/infrastructure/persistence/LifecycleHookingEntryRepository.js

@@ -0,0 +1,208 @@
+import { ctxSnapshotFrom, } from "../../domain/port/DeferredHookDispatcher.js";
+const ANON_CTX = { user: null, staff: null, env: {} };
+/**
+ * Decorator that wraps any `EntryRepository` and fires lifecycle
+ * Triggers around every mutation (POC ADR-0014).
+ *
+ * Symmetry rule: MCP, admin, and builtin write paths all hit the same
+ * chokepoint, so all three pay (and gain) the same hook semantics —
+ * authors don't need to remember "hooks fire on path X but not Y."
+ *
+ * Hook → mutation mapping:
+ *   - `create` → `before_create` / `after_create`
+ *   - `update` → `before_update` / `after_update`
+ *   - `delete` → `before_delete` / `after_delete`
+ *   - `archive` → `before_update` / `after_update` (status flip is
+ *      a kind of update; explicit archive hooks are v0.2 if needed)
+ *   - `transitionStatus({ to: 'published' })` → `before_publish` /
+ *      `after_publish`; other targets fire `before_update` /
+ *      `after_update`
+ *
+ * Short-circuits when no Trigger watches the row's collection — no
+ * hook runner call, no per-mutation overhead.
+ *
+ * `before_*` runs synchronously: a thrown `DiagnosticError` from the
+ * runner cancels the mutation. `after_*` runs after the inner write
+ * succeeds — fire-and-forget via `ctx.waitUntil` if the adapter
+ * populated it; otherwise inline-await.
+ */
+export class LifecycleHookingEntryRepository {
+    inner;
+    triggers;
+    hooks;
+    deferred;
+    constructor(inner, triggers, hooks, deferred) {
+        this.inner = inner;
+        this.triggers = triggers;
+        this.hooks = hooks;
+        this.deferred = deferred;
+    }
+    async create(args) {
+        const ctx = ctxOf(args);
+        if (!this.triggers.hasAny(args.collection)) {
+            return this.inner.create(args);
+        }
+        await this.hooks.run({
+            hook: "before_create",
+            schema: args.collection,
+            entry: null,
+            ctx,
+            originalInput: args.originalInput,
+        });
+        const row = await this.inner.create(args);
+        await this.fireAfter("after_create", row, ctx, args);
+        return row;
+    }
+    get(id) {
+        return this.inner.get(id);
+    }
+    async update(args) {
+        if (!this.triggers.hasAny(args.collection)) {
+            return this.inner.update(args);
+        }
+        const existing = await this.inner.get(args.id);
+        if (!existing)
+            return this.inner.update(args);
+        const ctx = ctxOf(args);
+        await this.hooks.run({
+            hook: "before_update",
+            schema: args.collection,
+            entry: existing,
+            ctx,
+            originalInput: args.originalInput,
+        });
+        const row = await this.inner.update(args);
+        await this.fireAfter("after_update", row, ctx, args);
+        return row;
+    }
+    async delete(args) {
+        if (!this.triggers.hasAny(args.collection)) {
+            return this.inner.delete(args);
+        }
+        const existing = await this.inner.get(args.id);
+        if (!existing)
+            return this.inner.delete(args);
+        const ctx = ctxOf(args);
+        await this.hooks.run({
+            hook: "before_delete",
+            schema: args.collection,
+            entry: existing,
+            ctx,
+            originalInput: args.originalInput,
+        });
+        const result = await this.inner.delete(args);
+        if (result.removed) {
+            await this.fireAfter("after_delete", existing, ctx, args);
+        }
+        return result;
+    }
+    async archive(args) {
+        if (!this.triggers.hasAny(args.collection)) {
+            return this.inner.archive(args);
+        }
+        const existing = await this.inner.get(args.id);
+        if (!existing)
+            return this.inner.archive(args);
+        const ctx = ctxOf(args);
+        await this.hooks.run({
+            hook: "before_update",
+            schema: args.collection,
+            entry: existing,
+            ctx,
+            originalInput: args.originalInput,
+        });
+        const row = await this.inner.archive(args);
+        await this.fireAfter("after_update", row, ctx, args);
+        return row;
+    }
+    async transitionStatus(args) {
+        if (!this.triggers.hasAny(args.collection)) {
+            return this.inner.transitionStatus(args);
+        }
+        const isPublish = args.to === "published";
+        const beforeHook = isPublish ? "before_publish" : "before_update";
+        const afterHook = isPublish ? "after_publish" : "after_update";
+        const existing = await this.inner.get(args.id);
+        if (!existing)
+            return this.inner.transitionStatus(args);
+        const ctx = ctxOf(args);
+        await this.hooks.run({
+            hook: beforeHook,
+            schema: args.collection,
+            entry: existing,
+            ctx,
+            originalInput: args.originalInput,
+        });
+        const row = await this.inner.transitionStatus(args);
+        await this.fireAfter(afterHook, row, ctx, args);
+        return row;
+    }
+    list(args) {
+        return this.inner.list(args);
+    }
+    findByDataField(args) {
+        return this.inner.findByDataField(args);
+    }
+    findByDataFields(args) {
+        return this.inner.findByDataFields(args);
+    }
+    /**
+     * After-hook execution. Tries delivery rungs in order:
+     *
+     *   1. `deferred.enqueue(envelope)` — adapter-backed deferred path
+     *      (CF Workers Queues, Inngest, pg-boss, …). Survives isolate
+     *      death; consume invocation rehydrates the envelope and re-fires
+     *      via `CmsRuntime.runDeferredHook`. A rejection downgrades to
+     *      the next rung rather than dropping the hook silently.
+     *   2. `ctx.waitUntil(promise)` — adapter-populated fire-and-forget
+     *      bridge (CF Workers `ExecutionContext`). Fast but non-durable:
+     *      isolate death between response and resolution loses the work.
+     *   3. inline `await promise` — non-Workers runtimes (Bun / Node /
+     *      tests) where detached promises get cancelled with the request.
+     *      Trades response latency for hook-fire reliability.
+     *
+     * Hook throws are surfaced via `RunLifecycleHooksUseCase`'s
+     * `errorPolicy` semantics; for `continue` the runner already
+     * `console.error`s and swallows. Anything that escapes the inline
+     * branch here is an abort-policy throw on a before_* (impossible —
+     * the parser rejects `errorPolicy: abort` on after_* hooks) or an
+     * unexpected internal error; we log and swallow so the mutation
+     * result still reaches the caller.
+     */
+    async fireAfter(hook, entry, ctx, args) {
+        if (this.deferred && this.triggers.forHook(entry.collection, hook).length > 0) {
+            const envelope = {
+                hook,
+                schema: entry.collection,
+                entry,
+                originalInput: args.originalInput,
+                ctxSnapshot: ctxSnapshotFrom(ctx),
+            };
+            try {
+                await this.deferred.enqueue(envelope);
+                return;
+            }
+            catch (err) {
+                console.error(`[lifecycle] deferred enqueue for ${hook} on ${entry.collection}/${entry.id} failed; falling back`, err);
+            }
+        }
+        const promise = this.hooks.run({
+            hook,
+            schema: entry.collection,
+            entry,
+            ctx,
+            originalInput: args.originalInput,
+        }).catch((err) => {
+            console.error(`[lifecycle] ${hook} on ${entry.collection}/${entry.id} failed`, err);
+        });
+        if (ctx.waitUntil) {
+            ctx.waitUntil(promise);
+            return;
+        }
+        await promise;
+    }
+}
+function ctxOf(args) {
+    return args.hookContext ?? ANON_CTX;
+}
+//# sourceMappingURL=LifecycleHookingEntryRepository.js.map

package/dist/infrastructure/persistence/LifecycleHookingEntryRepository.js.map

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

package/dist/infrastructure/persistence/index.d.ts

@@ -0,0 +1,4 @@
+export { DatabaseEntryRepository } from "./DatabaseEntryRepository.js";
+export { DatabaseSiteConfigRepository } from "./DatabaseSiteConfigRepository.js";
+export { LifecycleHookingEntryRepository } from "./LifecycleHookingEntryRepository.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/persistence/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/persistence/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/infrastructure/persistence/index.js

@@ -0,0 +1,4 @@
+export { DatabaseEntryRepository } from "./DatabaseEntryRepository.js";
+export { DatabaseSiteConfigRepository } from "./DatabaseSiteConfigRepository.js";
+export { LifecycleHookingEntryRepository } from "./LifecycleHookingEntryRepository.js";
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/persistence/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/infrastructure/persistence/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/infrastructure/render/HtmlPublishOrchestrator.d.ts

@@ -0,0 +1,34 @@
+import { type SchemaManifest, type SiteConfig } from "@aotter/mantle-spec";
+import type { DatabaseDriver } from "../../domain/port/DatabaseDriver.js";
+import type { KvCache } from "../../domain/port/KvCache.js";
+import type { PublishEntryRequest, PublishOrchestrator } from "../../domain/port/PublishOrchestrator.js";
+import type { PublicPathResolver } from "../../domain/service/PublicPathResolver.js";
+import { type SeoComposer } from "../../domain/service/EntrySeoSupport.js";
+/**
+ * Structural contract of the llms.txt composer the orchestrator
+ * accepts. Kept here (vs. importing the concrete use-case class) so
+ * infrastructure doesn't cross the `infrastructure→usecase` boundary
+ * — the runtime assembly root wires in `ComposeLlmsTxtUseCase`,
+ * which satisfies this shape.
+ */
+export interface LlmsTxtComposer {
+    execute(args: {
+        readonly site: SiteConfig;
+        readonly locale: string | null;
+    }): Promise<string>;
+}
+export declare class HtmlPublishOrchestrator implements PublishOrchestrator {
+    private readonly db;
+    private readonly kv;
+    private readonly paths;
+    private readonly composeSeo;
+    private readonly composeLlmsTxt;
+    private readonly schemas;
+    constructor(db: DatabaseDriver, kv: KvCache, paths: PublicPathResolver | null, composeSeo: SeoComposer, composeLlmsTxt: LlmsTxtComposer, schemas: ReadonlyMap<string, SchemaManifest>);
+    publish(request: PublishEntryRequest): Promise<void>;
+    unpublish(request: PublishEntryRequest): Promise<void>;
+    private renderEntry;
+    private renderList;
+    private renderLlmsTxt;
+}
+//# sourceMappingURL=HtmlPublishOrchestrator.d.ts.map

package/dist/infrastructure/render/HtmlPublishOrchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HtmlPublishOrchestrator.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/render/HtmlPublishOrchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,0CAA0C,CAAC;AAoBlD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AACrF,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,yCAAyC,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,IAAI,EAAE;QACZ,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;QAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;KAChC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACrB;AAgBD,qBAAa,uBAAwB,YAAW,mBAAmB;IAE/D,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBALP,EAAE,EAAE,cAAc,EAClB,EAAE,EAAE,OAAO,EACX,KAAK,EAAE,kBAAkB,GAAG,IAAI,EAChC,UAAU,EAAE,WAAW,EACvB,cAAc,EAAE,eAAe,EAC/B,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC;IAGzD,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BpD,SAAS,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;YAyB9C,WAAW;YAiBX,UAAU;YAwBV,aAAa;CAI5B"}

package/dist/infrastructure/render/HtmlPublishOrchestrator.js

@@ -0,0 +1,116 @@
+import { DiagnosticError, runtimeDiagnostic, } from "@aotter/mantle-spec";
+import { entryHtmlKey, entryMarkdownKey, listHtmlKey, llmsTxtKey, } from "../../domain/service/PublishKeys.js";
+import { readEntryById, readPublishedEntries, } from "../../domain/service/io/PublishedEntries.js";
+import { joinParentForList, joinParentIfTranslation, } from "../../domain/service/io/JoinedEntryReader.js";
+import { serializeEntryAsMarkdown } from "../../domain/service/MarkdownSerializer.js";
+import { renderEntryHtml, renderListHtml, } from "../../domain/service/HtmlRenderer.js";
+import { composeSeoIfPathed, } from "../../domain/service/EntrySeoSupport.js";
+/**
+ * `HtmlPublishOrchestrator` — the publish pipeline. Renders + writes
+ * to `KvCache`:
+ *   1. Entry HTML (if a template is registered for the collection)
+ *   2. Entry `.md` mirror (if the entry has a `content` field)
+ *   3. Collection list HTML for the entry's locale
+ *   4. `/llms.txt` for the entry's locale (composed by ComposeLlmsTxtUseCase)
+ *
+ * Idempotent — invoking twice with the same entry id is safe; KV
+ * writes overwrite. Non-localized entries publish under empty-string
+ * locale.
+ */
+const DEFAULT_DOCTYPE = "<!DOCTYPE html>\n";
+export class HtmlPublishOrchestrator {
+    db;
+    kv;
+    paths;
+    composeSeo;
+    composeLlmsTxt;
+    schemas;
+    constructor(db, kv, paths, composeSeo, composeLlmsTxt, schemas) {
+        this.db = db;
+        this.kv = kv;
+        this.paths = paths;
+        this.composeSeo = composeSeo;
+        this.composeLlmsTxt = composeLlmsTxt;
+        this.schemas = schemas;
+    }
+    async publish(request) {
+        const raw = await readEntryById(this.db, request.entryId);
+        if (!raw) {
+            throw new DiagnosticError(runtimeDiagnostic({
+                code: "NOT_FOUND",
+                severity: "error",
+                path: `usecase/PublishEntry/${request.entryId}`,
+                value: request.entryId,
+                expected: "id of an existing entry",
+                message: `Entry not found: ${request.entryId}.`,
+            }));
+        }
+        // Materialize parent fields into the translation's data before
+        // rendering (ADR-0010). RequestPublishUseCase has already asserted
+        // the parent is published, so a status filter is safe here.
+        const entry = await joinParentIfTranslation(this.db, this.schemas, raw, {
+            parentStatus: "published",
+        });
+        const indexLocale = entry.locale ?? null;
+        const doctype = request.htmlDoctype ?? DEFAULT_DOCTYPE;
+        await Promise.all([
+            this.renderEntry(entry, request.site, request.templates, doctype),
+            this.renderList(entry.collection, indexLocale, request.site, request.templates, doctype),
+            this.renderLlmsTxt(indexLocale, request.site),
+        ]);
+    }
+    async unpublish(request) {
+        const entry = await readEntryById(this.db, request.entryId);
+        if (!entry) {
+            throw new DiagnosticError(runtimeDiagnostic({
+                code: "NOT_FOUND",
+                severity: "error",
+                path: `usecase/UnpublishEntryCache/${request.entryId}`,
+                value: request.entryId,
+                expected: "id of an existing entry",
+                message: `Entry not found: ${request.entryId}.`,
+            }));
+        }
+        const indexLocale = entry.locale ?? null;
+        const doctype = request.htmlDoctype ?? DEFAULT_DOCTYPE;
+        await Promise.all([
+            this.kv.delete(entryHtmlKey(entry)),
+            this.kv.delete(entryMarkdownKey(entry)),
+            this.renderList(entry.collection, indexLocale, request.site, request.templates, doctype),
+            this.renderLlmsTxt(indexLocale, request.site),
+        ]);
+    }
+    async renderEntry(entry, site, templates, doctype) {
+        const seo = await composeSeoIfPathed(this.composeSeo, this.paths, entry, site);
+        const html = renderEntryHtml({ entry, site, templates, doctype, seo });
+        if (html !== null) {
+            await this.kv.put(entryHtmlKey(entry), html);
+        }
+        const md = serializeEntryAsMarkdown(entry);
+        if (md) {
+            await this.kv.put(entryMarkdownKey(entry), md);
+        }
+    }
+    async renderList(collection, locale, site, templates, doctype) {
+        const raw = await readPublishedEntries(this.db, { locale, collection });
+        const entries = await joinParentForList(this.db, this.schemas, raw, {
+            parentStatus: "published",
+        });
+        const html = renderListHtml({
+            collection,
+            locale: locale ?? "",
+            entries,
+            site,
+            templates,
+            doctype,
+        });
+        if (html !== null) {
+            await this.kv.put(listHtmlKey(collection, locale ?? ""), html);
+        }
+    }
+    async renderLlmsTxt(locale, site) {
+        const body = await this.composeLlmsTxt.execute({ site, locale });
+        await this.kv.put(llmsTxtKey(locale ?? ""), body);
+    }
+}
+//# sourceMappingURL=HtmlPublishOrchestrator.js.map

package/dist/infrastructure/render/HtmlPublishOrchestrator.js.map

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

package/dist/infrastructure/render/index.d.ts

@@ -0,0 +1,2 @@
+export { HtmlPublishOrchestrator } from "./HtmlPublishOrchestrator.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/render/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/render/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/infrastructure/render/index.js

@@ -0,0 +1,2 @@
+export { HtmlPublishOrchestrator } from "./HtmlPublishOrchestrator.js";
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/render/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/infrastructure/render/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC"}