@aotter/mantle-runtime 0.0.11-alpha.11

package/dist/domain/service/PublishKeys.js

@@ -0,0 +1,69 @@
+import { toUrlLocale } from "@aotter/mantle-spec";
+/**
+ * KV key derivation. Centralised so the publish pipeline (writer) and
+ * the public router (reader) agree on one shape; changing the layout
+ * is a single-file edit.
+ *
+ *   - `entry:html:{locale}/{collection}/{slug}` — pre-rendered HTML
+ *   - `entry:md:{locale}/{collection}/{slug}`   — markdown mirror
+ *   - `list:html:{locale}/{collection}`         — collection index
+ *   - `llms:{locale}`                            — /{locale}/llms.txt
+ *   - `llms:root`                                — /llms.txt (cross-locale aggregate)
+ *
+ * Non-localized entries use empty-string locale (`entry:html:/posts/abc`).
+ * The root /llms.txt uses the explicit `:root` suffix instead of an
+ * empty one because `wrangler kv bulk put` silently drops keys ending
+ * in `:` (caught in CI on commit 93c10ef).
+ *
+ * Pure path math — no I/O. Lives in `domain/service/` so any layer
+ * can call it without dragging an adapter dep.
+ */
+export function entrySlug(entry) {
+    const fromData = entry.data["slug"];
+    if (typeof fromData === "string" && /^[a-z0-9][a-z0-9-]*$/.test(fromData)) {
+        return fromData;
+    }
+    return entry.id;
+}
+export function entryHtmlKey(entry) {
+    const slug = entrySlug(entry);
+    const locale = entry.locale ? toUrlLocale(entry.locale) : "";
+    return `entry:html:${locale}/${entry.collection}/${slug}`;
+}
+export function entryMarkdownKey(entry) {
+    const slug = entrySlug(entry);
+    const locale = entry.locale ? toUrlLocale(entry.locale) : "";
+    return `entry:md:${locale}/${entry.collection}/${slug}`;
+}
+export function listHtmlKey(collection, locale) {
+    const urlLocale = locale ? locale.toLowerCase() : "";
+    return `list:html:${urlLocale}/${collection}`;
+}
+export function llmsTxtKey(locale) {
+    return `llms:${locale ? locale.toLowerCase() : "root"}`;
+}
+export function entryPublicPath(entry) {
+    const slug = entrySlug(entry);
+    if (entry.locale)
+        return `/${toUrlLocale(entry.locale)}/${entry.collection}/${slug}`;
+    return `/${entry.collection}/${slug}`;
+}
+/**
+ * Build the entry HTML key from URL-side parts. The router has the
+ * (collection, locale, slug) tuple from path params; reconstructing
+ * a partial `Entry` just to call `entryHtmlKey` is bug-bait. Use
+ * this helper instead.
+ *
+ * Pass `locale = ""` for non-localized entries (matches publish
+ * pipeline semantic where non-localized entries write to
+ * `entry:html:/{collection}/{slug}`).
+ */
+export function entryHtmlKeyFromParts(collection, locale, slug) {
+    const urlLocale = locale ? locale.toLowerCase() : "";
+    return `entry:html:${urlLocale}/${collection}/${slug}`;
+}
+export function entryMarkdownKeyFromParts(collection, locale, slug) {
+    const urlLocale = locale ? locale.toLowerCase() : "";
+    return `entry:md:${urlLocale}/${collection}/${slug}`;
+}
+//# sourceMappingURL=PublishKeys.js.map

package/dist/domain/service/PublishKeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PublishKeys.js","sourceRoot":"","sources":["../../../src/domain/service/PublishKeys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,qBAAqB,CAAC;AAE9D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,SAAS,CAAC,KAAoD;IAC5E,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,sBAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1E,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,KAAK,CAAC,EAAE,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAY;IACvC,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,OAAO,cAAc,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAY;IAC3C,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,OAAO,YAAY,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,UAAkB,EAAE,MAAc;IAC5D,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACrD,OAAO,aAAa,SAAS,IAAI,UAAU,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,QAAQ,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAY;IAC1C,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,KAAK,CAAC,MAAM;QAAE,OAAO,IAAI,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;IACrF,OAAO,IAAI,KAAK,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;AACxC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAAkB,EAClB,MAAc,EACd,IAAY;IAEZ,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACrD,OAAO,cAAc,SAAS,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,UAAkB,EAClB,MAAc,EACd,IAAY;IAEZ,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACrD,OAAO,YAAY,SAAS,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;AACvD,CAAC"}

package/dist/domain/service/SeoMetaComposer.d.ts

@@ -0,0 +1,47 @@
+import { type Entry, type SiteConfig } from "@aotter/mantle-spec";
+import type { SeoMeta } from "../model/SeoMeta.js";
+/**
+ * Pure composer for SEO + AEO meta blocks emitted on every public
+ * entry page. Carries the conventions a consumer otherwise re-invents
+ * — canonical, hreflang siblings, the `.md` mirror alternate that
+ * lets LLM crawlers grab clean markdown, og: + twitter card, JSON-LD
+ * structured data.
+ *
+ * The composer is pure — no I/O, no DB. The caller resolves the
+ * sibling translations (for hreflang) and passes them in. See
+ * `ComposeEntrySeoMetaUseCase` for the wired version that does the
+ * sibling-read.
+ *
+ * The shape of the result lives in `domain/model/SeoMeta` so
+ * `TemplateRegistry`'s `EntryContext.seo` can reference it without
+ * pulling service code into model.
+ */
+export type { SeoMeta } from "../model/SeoMeta.js";
+export interface SiblingTranslation {
+    readonly locale: string;
+    readonly publicPath: string;
+}
+export interface ComposeEntrySeoMetaArgs {
+    readonly entry: Entry;
+    readonly site: SiteConfig;
+    /** The current entry's public path (already includes locale prefix).
+     *  Composer prepends `site.origin` to absolutize. */
+    readonly publicPath: string;
+    /** Optional sibling translations for hreflang. The current entry's
+     *  locale entry is added by the composer if not already present. */
+    readonly siblings?: ReadonlyArray<SiblingTranslation>;
+    /** og:type. Defaults to `article` when the entry has a `publishedAt`
+     *  (or `updatedAt`) field, `website` otherwise. */
+    readonly type?: "article" | "website";
+}
+export declare function composeEntrySeoMeta(args: ComposeEntrySeoMetaArgs): SeoMeta;
+/**
+ * Render the SEO meta block as an HTML fragment. Templates embed this
+ * verbatim inside `<head>` via `raw(renderSeoTagsHtml(seo))`.
+ *
+ * Order matters slightly for crawlers — canonical first, alternates
+ * (markdown then hreflang) before og:/twitter so the discoverability
+ * bones land before the rich-preview block.
+ */
+export declare function renderSeoTagsHtml(meta: SeoMeta): string;
+//# sourceMappingURL=SeoMetaComposer.d.ts.map

package/dist/domain/service/SeoMetaComposer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeoMetaComposer.d.ts","sourceRoot":"","sources":["../../../src/domain/service/SeoMetaComposer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAInD;;;;;;;;;;;;;;;GAeG;AACH,YAAY,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B;yDACqD;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;wEACoE;IACpE,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;IACtD;uDACmD;IACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CACvC;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAkD1E;AAmFD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAiDvD"}

package/dist/domain/service/SeoMetaComposer.js

@@ -0,0 +1,174 @@
+import { toUrlLocale } from "@aotter/mantle-spec";
+import { absoluteUrl, appendMarkdownExt } from "./AbsoluteUrl.js";
+import { hasMarkdownBody } from "./MarkdownSerializer.js";
+export function composeEntrySeoMeta(args) {
+    const { entry, site, publicPath, siblings = [], type } = args;
+    const data = entry.data;
+    const canonical = absoluteUrl(site.origin, publicPath);
+    const alternateMarkdown = appendMarkdownExt(canonical);
+    const title = stringField(data, "title") ?? site.title;
+    const description = stringField(data, "description") ?? site.description ?? null;
+    const image = stringField(data, "coverUrl") ?? stringField(data, "ogImage") ?? null;
+    const ogType = type ?? (hasArticleSignal(entry) ? "article" : "website");
+    const entryLocale = entry.locale ?? site.canonicalLocale ?? "en";
+    const hreflangs = buildHreflangs({
+        site,
+        currentLocale: entryLocale,
+        currentPublicPath: publicPath,
+        siblings,
+    });
+    return {
+        canonical,
+        alternateMarkdown,
+        hreflangs,
+        description: description ?? null,
+        robots: null,
+        og: {
+            type: ogType,
+            url: canonical,
+            title,
+            siteName: site.title || site.brand,
+            description: description ?? null,
+            image,
+            locale: entryLocale,
+        },
+        twitter: {
+            card: image ? "summary_large_image" : "summary",
+            title,
+            description: description ?? null,
+            image,
+        },
+        jsonLd: buildJsonLd({
+            ogType,
+            title,
+            description,
+            canonical,
+            image,
+            data,
+            site,
+        }),
+    };
+}
+function buildHreflangs(args) {
+    const { site, currentLocale, currentPublicPath, siblings } = args;
+    if (site.locales.length <= 1)
+        return [];
+    const out = [];
+    const seen = new Set();
+    const push = (locale, path) => {
+        const key = locale.toLowerCase();
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        out.push({ locale, href: absoluteUrl(site.origin, path) });
+    };
+    push(currentLocale, currentPublicPath);
+    for (const s of siblings)
+        push(s.locale, s.publicPath);
+    // x-default points at the canonical-locale variant when known,
+    // falling back to the current entry's URL otherwise. Search engines
+    // expect this row alongside the per-locale ones.
+    const canonicalSibling = siblings.find((s) => site.canonicalLocale && s.locale.toLowerCase() === site.canonicalLocale.toLowerCase());
+    out.push({
+        locale: "x-default",
+        href: absoluteUrl(site.origin, canonicalSibling?.publicPath ?? currentPublicPath),
+    });
+    return out;
+}
+function buildJsonLd(args) {
+    const { ogType, title, description, canonical, image, data, site } = args;
+    const publishedAtMs = numericField(data, "publishedAt");
+    const updatedAtMs = numericField(data, "updatedAt");
+    const base = {
+        "@context": "https://schema.org",
+        "@type": ogType === "article" ? "Article" : "WebPage",
+        headline: title,
+        name: title,
+        url: canonical,
+        description: description ?? undefined,
+        image: image ?? undefined,
+        inLanguage: site.canonicalLocale ?? undefined,
+        publisher: site.title || site.brand
+            ? {
+                "@type": "Organization",
+                name: site.title || site.brand,
+            }
+            : undefined,
+        datePublished: publishedAtMs ? new Date(publishedAtMs).toISOString() : undefined,
+        dateModified: updatedAtMs ? new Date(updatedAtMs).toISOString() : undefined,
+    };
+    // Drop undefined keys so JSON.stringify produces a clean object.
+    return Object.fromEntries(Object.entries(base).filter(([, v]) => v !== undefined));
+}
+function stringField(data, key) {
+    const v = data[key];
+    return typeof v === "string" && v.length > 0 ? v : null;
+}
+function numericField(data, key) {
+    const v = data[key];
+    return typeof v === "number" && Number.isFinite(v) ? v : null;
+}
+function hasArticleSignal(entry) {
+    return typeof entry.data["publishedAt"] === "number" || hasMarkdownBody(entry);
+}
+/**
+ * Render the SEO meta block as an HTML fragment. Templates embed this
+ * verbatim inside `<head>` via `raw(renderSeoTagsHtml(seo))`.
+ *
+ * Order matters slightly for crawlers — canonical first, alternates
+ * (markdown then hreflang) before og:/twitter so the discoverability
+ * bones land before the rich-preview block.
+ */
+export function renderSeoTagsHtml(meta) {
+    const parts = [];
+    parts.push(`<link rel="canonical" href="${escapeAttr(meta.canonical)}">`);
+    parts.push(`<link rel="alternate" type="text/markdown" href="${escapeAttr(meta.alternateMarkdown)}">`);
+    for (const h of meta.hreflangs) {
+        parts.push(`<link rel="alternate" hreflang="${escapeAttr(h.locale)}" href="${escapeAttr(h.href)}">`);
+    }
+    if (meta.description) {
+        parts.push(`<meta name="description" content="${escapeAttr(meta.description)}">`);
+    }
+    if (meta.robots) {
+        parts.push(`<meta name="robots" content="${escapeAttr(meta.robots)}">`);
+    }
+    parts.push(`<meta name="generator" content="mantle">`);
+    parts.push(`<meta property="og:type" content="${escapeAttr(meta.og.type)}">`);
+    parts.push(`<meta property="og:url" content="${escapeAttr(meta.og.url)}">`);
+    parts.push(`<meta property="og:title" content="${escapeAttr(meta.og.title)}">`);
+    if (meta.og.siteName) {
+        parts.push(`<meta property="og:site_name" content="${escapeAttr(meta.og.siteName)}">`);
+    }
+    if (meta.og.description) {
+        parts.push(`<meta property="og:description" content="${escapeAttr(meta.og.description)}">`);
+    }
+    if (meta.og.image) {
+        parts.push(`<meta property="og:image" content="${escapeAttr(meta.og.image)}">`);
+    }
+    parts.push(`<meta property="og:locale" content="${escapeAttr(toUrlLocale(meta.og.locale))}">`);
+    parts.push(`<meta name="twitter:card" content="${escapeAttr(meta.twitter.card)}">`);
+    parts.push(`<meta name="twitter:title" content="${escapeAttr(meta.twitter.title)}">`);
+    if (meta.twitter.description) {
+        parts.push(`<meta name="twitter:description" content="${escapeAttr(meta.twitter.description)}">`);
+    }
+    if (meta.twitter.image) {
+        parts.push(`<meta name="twitter:image" content="${escapeAttr(meta.twitter.image)}">`);
+    }
+    if (meta.jsonLd) {
+        parts.push(`<script type="application/ld+json">${escapeJsonLd(meta.jsonLd)}</script>`);
+    }
+    return parts.join("\n");
+}
+function escapeAttr(s) {
+    return s
+        .replace(/&/g, "&amp;")
+        .replace(/"/g, "&quot;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;");
+}
+function escapeJsonLd(obj) {
+    // `</script>` inside JSON-LD is the only nested-script pitfall;
+    // escaping the closing `</` keeps the embedded JSON strict-parseable.
+    return JSON.stringify(obj).replace(/<\//g, "<\\/");
+}
+//# sourceMappingURL=SeoMetaComposer.js.map

package/dist/domain/service/SeoMetaComposer.js.map

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

package/dist/domain/service/SitemapSerializer.d.ts

@@ -0,0 +1,19 @@
+import type { Entry, SiteConfig } from "@aotter/mantle-spec";
+/**
+ * Hreflang alternates are deferred to v0.1.x (need cross-locale entry
+ * pairing first); only minimal `loc + lastmod` shipped.
+ *
+ * Entries arrive pre-mapped from storage row to public path — the
+ * caller (`ComposeSitemapUseCase`) decides how a (collection, slug,
+ * locale) row surfaces under the consumer's routing.
+ */
+export interface SitemapEntry {
+    readonly entry: Entry;
+    readonly path: string;
+}
+export interface SitemapInput {
+    readonly site: SiteConfig;
+    readonly entries: readonly SitemapEntry[];
+}
+export declare function serializeSitemap(input: SitemapInput): string;
+//# sourceMappingURL=SitemapSerializer.d.ts.map

package/dist/domain/service/SitemapSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SitemapSerializer.d.ts","sourceRoot":"","sources":["../../../src/domain/service/SitemapSerializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAG7D;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;CAC3C;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAgB5D"}

package/dist/domain/service/SitemapSerializer.js

@@ -0,0 +1,27 @@
+import { absoluteUrl } from "./AbsoluteUrl.js";
+export function serializeSitemap(input) {
+    const { site, entries } = input;
+    const out = [];
+    out.push(`<?xml version="1.0" encoding="UTF-8"?>`);
+    out.push(`<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">`);
+    for (const { entry, path } of entries) {
+        const loc = absoluteUrl(site.origin ?? "", path);
+        out.push("  <url>");
+        out.push(`    <loc>${escapeXml(loc)}</loc>`);
+        if (entry.updatedAt) {
+            out.push(`    <lastmod>${new Date(entry.updatedAt).toISOString()}</lastmod>`);
+        }
+        out.push("  </url>");
+    }
+    out.push("</urlset>");
+    return out.join("\n") + "\n";
+}
+function escapeXml(s) {
+    return s
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+//# sourceMappingURL=SitemapSerializer.js.map

package/dist/domain/service/SitemapSerializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SitemapSerializer.js","sourceRoot":"","sources":["../../../src/domain/service/SitemapSerializer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAoB/C,MAAM,UAAU,gBAAgB,CAAC,KAAmB;IAClD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAChC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,GAAG,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACnD,GAAG,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;IACzE,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,OAAO,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;QACjD,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpB,GAAG,CAAC,IAAI,CAAC,YAAY,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,GAAG,CAAC,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QAChF,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtB,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAC/B,CAAC;AAED,SAAS,SAAS,CAAC,CAAS;IAC1B,OAAO,CAAC;SACL,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC"}

package/dist/domain/service/TriggerIndex.d.ts

@@ -0,0 +1,27 @@
+import type { LifecycleHook, TriggerManifest } from "@aotter/mantle-spec";
+/**
+ * Pre-built `(schema, hook) → Trigger[]` index for the lifecycle hook
+ * runner. Built once at boot from the parsed manifest set; the
+ * `LifecycleHookingEntryRepository` decorator queries it on every
+ * mutation.
+ *
+ * Within a `(schema, hook)` group, Triggers fire in **alphabetical
+ * order by `Trigger.metadata.name`** — a `priority: number` key is
+ * reserved for v0.2 (POC ADR-0014). Authors choose names that sort
+ * correctly today (`010-bot-check`, `020-rate-limit`).
+ *
+ * Pure data-structure — no I/O, no manifest validation. Lives in
+ * `domain/service/`.
+ */
+export declare class TriggerIndex {
+    private readonly bySchemaAndHook;
+    constructor(triggers: readonly TriggerManifest[]);
+    /** Triggers bound to (schema, hook), in firing order. Empty array
+     *  when nothing matches — callers don't need a null check. */
+    forHook(schema: string, hook: LifecycleHook): readonly TriggerManifest[];
+    /** True when at least one lifecycle Trigger bound to this Schema
+     *  exists (any hook). Used by the entry-writer decorator to short-
+     *  circuit when no hooks could fire. */
+    hasAny(schema: string): boolean;
+}
+//# sourceMappingURL=TriggerIndex.d.ts.map

package/dist/domain/service/TriggerIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TriggerIndex.d.ts","sourceRoot":"","sources":["../../../src/domain/service/TriggerIndex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE1E;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqD;gBAEzE,QAAQ,EAAE,SAAS,eAAe,EAAE;IAuBhD;kEAC8D;IAC9D,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,SAAS,eAAe,EAAE;IAIxE;;4CAEwC;IACxC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;CAGhC"}

package/dist/domain/service/TriggerIndex.js

@@ -0,0 +1,52 @@
+/**
+ * Pre-built `(schema, hook) → Trigger[]` index for the lifecycle hook
+ * runner. Built once at boot from the parsed manifest set; the
+ * `LifecycleHookingEntryRepository` decorator queries it on every
+ * mutation.
+ *
+ * Within a `(schema, hook)` group, Triggers fire in **alphabetical
+ * order by `Trigger.metadata.name`** — a `priority: number` key is
+ * reserved for v0.2 (POC ADR-0014). Authors choose names that sort
+ * correctly today (`010-bot-check`, `020-rate-limit`).
+ *
+ * Pure data-structure — no I/O, no manifest validation. Lives in
+ * `domain/service/`.
+ */
+export class TriggerIndex {
+    bySchemaAndHook;
+    constructor(triggers) {
+        this.bySchemaAndHook = new Map();
+        for (const t of triggers) {
+            if (t.spec.source.kind !== "lifecycle")
+                continue;
+            const schema = t.spec.source.schema;
+            let inner = this.bySchemaAndHook.get(schema);
+            if (!inner) {
+                inner = new Map();
+                this.bySchemaAndHook.set(schema, inner);
+            }
+            for (const hook of t.spec.source.on) {
+                const list = inner.get(hook) ?? [];
+                list.push(t);
+                inner.set(hook, list);
+            }
+        }
+        for (const inner of this.bySchemaAndHook.values()) {
+            for (const list of inner.values()) {
+                list.sort((a, b) => a.metadata.name.localeCompare(b.metadata.name));
+            }
+        }
+    }
+    /** Triggers bound to (schema, hook), in firing order. Empty array
+     *  when nothing matches — callers don't need a null check. */
+    forHook(schema, hook) {
+        return this.bySchemaAndHook.get(schema)?.get(hook) ?? [];
+    }
+    /** True when at least one lifecycle Trigger bound to this Schema
+     *  exists (any hook). Used by the entry-writer decorator to short-
+     *  circuit when no hooks could fire. */
+    hasAny(schema) {
+        return this.bySchemaAndHook.has(schema);
+    }
+}
+//# sourceMappingURL=TriggerIndex.js.map

package/dist/domain/service/TriggerIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TriggerIndex.js","sourceRoot":"","sources":["../../../src/domain/service/TriggerIndex.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,YAAY;IACN,eAAe,CAAqD;IAErF,YAAY,QAAoC;QAC9C,IAAI,CAAC,eAAe,GAAG,IAAI,GAAG,EAAE,CAAC;QACjC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,WAAW;gBAAE,SAAS;YACjD,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;YACpC,IAAI,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC7C,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;gBAClB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC1C,CAAC;YACD,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;gBACpC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACnC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACb,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC;YAClD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBAClC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;YACtE,CAAC;QACH,CAAC;IACH,CAAC;IAED;kEAC8D;IAC9D,OAAO,CAAC,MAAc,EAAE,IAAmB;QACzC,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC3D,CAAC;IAED;;4CAEwC;IACxC,MAAM,CAAC,MAAc;QACnB,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;CACF"}

package/dist/domain/service/ViewParamCoercer.d.ts

@@ -0,0 +1,20 @@
+import type { ViewManifest } from "@aotter/mantle-spec";
+/**
+ * Coerce a public REST query string into the typed param map declared
+ * by `View.spec.params`. v0.1 grammar covers scalar leaves only —
+ * string / integer / number / boolean / enum. `required` is enforced;
+ * unknown query keys are silently ignored (lenient v0.1.0).
+ *
+ * Lives in `mantle-runtime` (not the CF adapter) so future adapters
+ * — Netlify, Bun, Deno — share one coercion path. Throws a
+ * `ViewParamCoercionError` so the adapter can map the message into its
+ * own diagnostic envelope without parsing prose.
+ */
+export declare class ViewParamCoercionError extends Error {
+    constructor(message: string);
+}
+export interface ViewParamLookup {
+    get(name: string): string | null;
+}
+export declare function coerceViewParams(view: ViewManifest, query: ViewParamLookup): Record<string, unknown>;
+//# sourceMappingURL=ViewParamCoercer.d.ts.map

package/dist/domain/service/ViewParamCoercer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewParamCoercer.d.ts","sourceRoot":"","sources":["../../../src/domain/service/ViewParamCoercer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEpE;;;;;;;;;;GAUG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,eAAe,GACrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBzB"}

package/dist/domain/service/ViewParamCoercer.js

@@ -0,0 +1,82 @@
+/**
+ * Coerce a public REST query string into the typed param map declared
+ * by `View.spec.params`. v0.1 grammar covers scalar leaves only —
+ * string / integer / number / boolean / enum. `required` is enforced;
+ * unknown query keys are silently ignored (lenient v0.1.0).
+ *
+ * Lives in `mantle-runtime` (not the CF adapter) so future adapters
+ * — Netlify, Bun, Deno — share one coercion path. Throws a
+ * `ViewParamCoercionError` so the adapter can map the message into its
+ * own diagnostic envelope without parsing prose.
+ */
+export class ViewParamCoercionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ViewParamCoercionError";
+    }
+}
+export function coerceViewParams(view, query) {
+    const declared = view.spec.params;
+    if (!declared)
+        return {};
+    const props = declared.properties ?? {};
+    const required = declared.required ?? [];
+    const out = {};
+    for (const [name, schema] of Object.entries(props)) {
+        const raw = query.get(name);
+        if (raw == null) {
+            if (required.includes(name)) {
+                throw new ViewParamCoercionError(`View '${view.metadata.name}' requires query param '${name}' (declared in View.spec.params.required).`);
+            }
+            continue;
+        }
+        out[name] = coerceScalar(raw, schema, name);
+    }
+    return out;
+}
+function coerceScalar(raw, schema, name) {
+    // Coerce by `type` first so a co-declared `enum` checks membership
+    // against typed values — `["1","2"].includes(1)` and `[1,2].includes("1")`
+    // are both false, so an enum-first check would throw spuriously (or
+    // worse, return a string value when an integer was declared).
+    const coerced = coerceByType(raw, schema.type, name);
+    if (Array.isArray(schema.enum) && schema.enum.length > 0) {
+        if (!schema.enum.includes(coerced)) {
+            throw new ViewParamCoercionError(`query param '${name}' must be one of ${schema.enum.join(", ")}; got ${JSON.stringify(raw)}.`);
+        }
+    }
+    return coerced;
+}
+function coerceByType(raw, type, name) {
+    switch (type) {
+        case "integer": {
+            const n = Number.parseInt(raw, 10);
+            // Reject partial parses ("1.5", "1abc") and non-numeric ("abc")
+            // — `parseInt` would silently stop at the first non-digit. The
+            // trim() pair allows whitespace-padded canonicals.
+            if (!Number.isFinite(n) || String(n) !== raw.trim()) {
+                throw new ViewParamCoercionError(`query param '${name}' expected integer; got ${JSON.stringify(raw)}.`);
+            }
+            return n;
+        }
+        case "number": {
+            const n = Number(raw);
+            if (!Number.isFinite(n)) {
+                throw new ViewParamCoercionError(`query param '${name}' expected number; got ${JSON.stringify(raw)}.`);
+            }
+            return n;
+        }
+        case "boolean":
+            if (raw === "true")
+                return true;
+            if (raw === "false")
+                return false;
+            throw new ViewParamCoercionError(`query param '${name}' expected boolean (true|false); got ${JSON.stringify(raw)}.`);
+        case "string":
+        case undefined:
+            return raw;
+        default:
+            throw new ViewParamCoercionError(`View param '${name}' declares unsupported type '${String(type)}' for the public REST surface (v0.1 covers string / integer / number / boolean / enum).`);
+    }
+}
+//# sourceMappingURL=ViewParamCoercer.js.map

package/dist/domain/service/ViewParamCoercer.js.map

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

package/dist/domain/service/ViewSqlCompiler.d.ts

@@ -0,0 +1,29 @@
+import { type ViewManifest } from "@aotter/mantle-spec";
+/**
+ * View → SQL compilation. Targets SQLite + JSON1 (D1's dialect).
+ * Reserved metadata fields project as native columns; everything else
+ * goes through `json_extract(data, '$.<field>')`. SQL uses positional
+ * `?` parameters; field-name escapes are defense-in-depth on top of
+ * the Schema validator gate.
+ *
+ * v0.1 filter AST is `eq | and | or`; `eq.value` may be a literal or a
+ * `{ $param: <name> }` sentinel substituted from `options.params` at
+ * compile time. Pagination knobs `page` / `show` come in via
+ * `options`; the runtime owns the LIMIT/OFFSET emission.
+ */
+export interface CompiledView {
+    readonly sql: string;
+    readonly params: readonly unknown[];
+    readonly effectivePage: number;
+    readonly effectiveShow: number;
+}
+export interface CompileViewOptions {
+    /** Resolved query-string params, post-coercion. */
+    readonly params?: Record<string, unknown>;
+    /** 1-indexed; non-positive / non-finite falls back to 1. */
+    readonly page?: number;
+    /** Caller's requested page size; clamped to View.spec.limit. */
+    readonly show?: number;
+}
+export declare function compileView(view: ViewManifest, options?: CompileViewOptions): CompiledView;
+//# sourceMappingURL=ViewSqlCompiler.d.ts.map

package/dist/domain/service/ViewSqlCompiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewSqlCompiler.d.ts","sourceRoot":"","sources":["../../../src/domain/service/ViewSqlCompiler.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAG7B;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAsBD,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,GAAE,kBAAuB,GAAG,YAAY,CAkB9F"}