@cogenta/render 0.1.0

package/dist/cache/tags.d.ts

@@ -0,0 +1,55 @@
+/**
+ * The tag vocabulary of the render cache.
+ *
+ * Four kinds of tag, and no more, because every tag is a promise the publish
+ * side has to keep: a tag nobody can emit on publication is a page that never
+ * gets invalidated.
+ *
+ * - `entry:<id>`   — this exact entry was read.
+ * - `collection:<name>` — a *list* of this collection was read. Carried by list
+ *   pages only, never by a detail page, which is precisely what makes
+ *   "publishing one entry invalidates its page and the lists, and nothing
+ *   else" true.
+ * - `media:<id>`   — an image variant of this media was built.
+ * - `path:<path>`  — a URL was resolved to an entry, or to nothing. The `path`
+ *   tag is what invalidates a cached 404: there is no entry id to tag when the
+ *   lookup came back empty.
+ *
+ * Entry ids are UUIDv7 and unique across every collection (`@cogenta/schema`
+ * `newId`), so an entry tag needs no collection segment — which is what lets
+ * `byPath`, which never learns the collection, tag the same entry as `entry()`.
+ */
+export declare function entryTag(id: string): string;
+export declare function collectionTag(collection: string): string;
+export declare function mediaTag(id: string): string;
+export declare function pathTag(path: string): string;
+/**
+ * Trailing slashes and a missing leading slash are the same route to a reader
+ * and two different strings to a cache. Normalising here rather than at every
+ * call site is what stops `/blog/x` and `/blog/x/` from becoming two tags, one
+ * of which is never invalidated.
+ */
+export declare function normalisePath(path: string): string;
+/**
+ * A content change, as the publish side knows it.
+ *
+ * Publication, unpublication and deletion produce the same tags: all three
+ * change what a visitor sees, and all three must drop the same pages. There is
+ * deliberately no `kind` field — a cache that invalidates differently depending
+ * on the verb is a cache with three ways to be wrong instead of one.
+ */
+export interface ContentChange {
+    readonly collection: string;
+    readonly id: string;
+    /**
+     * Routes the entry occupied, or occupies now. Both are needed on a move:
+     * the old URL must stop resolving and the new one must stop 404-ing.
+     */
+    readonly paths?: readonly string[] | undefined;
+    /** Media whose bytes changed. Rare — a re-crop, not a re-upload. */
+    readonly media?: readonly string[] | undefined;
+}
+/** Every tag a change invalidates. Deduplicated, order not significant. */
+export declare function tagsForChange(change: ContentChange): readonly string[];
+export declare function tagsForChanges(changes: readonly ContentChange[]): readonly string[];
+//# sourceMappingURL=tags.d.ts.map

package/dist/cache/tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../src/cache/tags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IAC9C,oEAAoE;IACpE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;CAC/C;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,MAAM,EAAE,CAKtE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,SAAS,MAAM,EAAE,CAInF"}

package/dist/cache/tags.js

@@ -0,0 +1,62 @@
+/**
+ * The tag vocabulary of the render cache.
+ *
+ * Four kinds of tag, and no more, because every tag is a promise the publish
+ * side has to keep: a tag nobody can emit on publication is a page that never
+ * gets invalidated.
+ *
+ * - `entry:<id>`   — this exact entry was read.
+ * - `collection:<name>` — a *list* of this collection was read. Carried by list
+ *   pages only, never by a detail page, which is precisely what makes
+ *   "publishing one entry invalidates its page and the lists, and nothing
+ *   else" true.
+ * - `media:<id>`   — an image variant of this media was built.
+ * - `path:<path>`  — a URL was resolved to an entry, or to nothing. The `path`
+ *   tag is what invalidates a cached 404: there is no entry id to tag when the
+ *   lookup came back empty.
+ *
+ * Entry ids are UUIDv7 and unique across every collection (`@cogenta/schema`
+ * `newId`), so an entry tag needs no collection segment — which is what lets
+ * `byPath`, which never learns the collection, tag the same entry as `entry()`.
+ */
+const SEPARATOR = ':';
+export function entryTag(id) {
+    return `entry${SEPARATOR}${id}`;
+}
+export function collectionTag(collection) {
+    return `collection${SEPARATOR}${collection}`;
+}
+export function mediaTag(id) {
+    return `media${SEPARATOR}${id}`;
+}
+export function pathTag(path) {
+    return `path${SEPARATOR}${normalisePath(path)}`;
+}
+/**
+ * Trailing slashes and a missing leading slash are the same route to a reader
+ * and two different strings to a cache. Normalising here rather than at every
+ * call site is what stops `/blog/x` and `/blog/x/` from becoming two tags, one
+ * of which is never invalidated.
+ */
+export function normalisePath(path) {
+    const withLeading = path.startsWith('/') ? path : `/${path}`;
+    const trimmed = withLeading.replace(/\/+$/u, '');
+    return trimmed.length === 0 ? '/' : trimmed;
+}
+/** Every tag a change invalidates. Deduplicated, order not significant. */
+export function tagsForChange(change) {
+    const tags = new Set([entryTag(change.id), collectionTag(change.collection)]);
+    for (const path of change.paths ?? [])
+        tags.add(pathTag(path));
+    for (const id of change.media ?? [])
+        tags.add(mediaTag(id));
+    return [...tags];
+}
+export function tagsForChanges(changes) {
+    const tags = new Set();
+    for (const change of changes)
+        for (const tag of tagsForChange(change))
+            tags.add(tag);
+    return [...tags];
+}
+//# sourceMappingURL=tags.js.map

package/dist/cache/tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.js","sourceRoot":"","sources":["../../src/cache/tags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,SAAS,GAAG,GAAG,CAAA;AAErB,MAAM,UAAU,QAAQ,CAAC,EAAU;IACjC,OAAO,QAAQ,SAAS,GAAG,EAAE,EAAE,CAAA;AACjC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,UAAkB;IAC9C,OAAO,aAAa,SAAS,GAAG,UAAU,EAAE,CAAA;AAC9C,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,EAAU;IACjC,OAAO,QAAQ,SAAS,GAAG,EAAE,EAAE,CAAA;AACjC,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,OAAO,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,EAAE,CAAA;AACjD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAA;IAC5D,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;IAChD,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAA;AAC7C,CAAC;AAsBD,2EAA2E;AAC3E,MAAM,UAAU,aAAa,CAAC,MAAqB;IACjD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;IACrF,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE;QAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;IAC9D,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE;QAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAA;IAC3D,OAAO,CAAC,GAAG,IAAI,CAAC,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAiC;IAC9D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,KAAK,MAAM,MAAM,IAAI,OAAO;QAAE,KAAK,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACpF,OAAO,CAAC,GAAG,IAAI,CAAC,CAAA;AAClB,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,48 @@
+/**
+ * What the delivery plane needs to know, and deliberately nothing else.
+ *
+ * `site` is structurally the `site` block of `CogentaConfig`, so a resolved
+ * Cogenta configuration is assignable here without an import: the render
+ * package must not pull the control-plane configuration loader — and with it
+ * the database URL and every secret — into the process that runs theme code
+ * (ADR-0004).
+ */
+export interface SiteConfig {
+    readonly name: string;
+    readonly url: string;
+    readonly locales: readonly string[];
+    readonly defaultLocale: string;
+}
+export interface ThemeConfig {
+    /** Package name or directory name of the active theme. */
+    readonly name: string;
+    /**
+     * Where the theme lives. Absolute, or relative to the working directory.
+     * Absent means "resolve `name` as a package from the working directory".
+     */
+    readonly root?: string | undefined;
+}
+/**
+ * How the renderer reaches the content API (ADR-0016).
+ *
+ * `token` is a read-only token carrying the rights of the `public` role. It is
+ * the *only* credential the delivery plane holds, and it can read nothing a
+ * visitor could not read anyway.
+ */
+export interface ContentApiConfig {
+    readonly url: string;
+    readonly token: string;
+    /** Mount point of the content routes under `url`. */
+    readonly basePath?: string | undefined;
+}
+export interface RenderConfig {
+    readonly site: SiteConfig;
+    readonly theme: ThemeConfig;
+    readonly content: ContentApiConfig;
+}
+/**
+ * Validates a render configuration, and fails loudly rather than rendering a
+ * site against half a configuration.
+ */
+export declare function parseRenderConfig(input: unknown): RenderConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACnC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACvC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;CACnC;AAmBD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAuB9D"}

package/dist/config.js

@@ -0,0 +1,44 @@
+import { CogentaError } from '@cogenta/core';
+import { z } from 'zod';
+const siteSchema = z.object({
+    name: z.string().min(1),
+    url: z.url(),
+    locales: z.array(z.string().min(1)).min(1),
+    defaultLocale: z.string().min(1),
+});
+const renderConfigSchema = z.object({
+    site: siteSchema,
+    theme: z.object({ name: z.string().min(1), root: z.string().min(1).optional() }),
+    content: z.object({
+        url: z.url(),
+        token: z.string().min(1),
+        basePath: z.string().min(1).optional(),
+    }),
+});
+/**
+ * Validates a render configuration, and fails loudly rather than rendering a
+ * site against half a configuration.
+ */
+export function parseRenderConfig(input) {
+    const result = renderConfigSchema.safeParse(input);
+    if (!result.success) {
+        const problems = result.error.issues.map((issue) => `${issue.path.join('.')}: ${issue.message}`);
+        throw new CogentaError({
+            code: 'CONFIG_INVALID',
+            message: `The render configuration is not usable: ${problems.join('; ')}.`,
+            hint: 'A render configuration needs site.name, site.url, site.locales, site.defaultLocale, theme.name and a content API url plus read token.',
+            details: { problems },
+        });
+    }
+    const config = result.data;
+    if (!config.site.locales.includes(config.site.defaultLocale)) {
+        throw new CogentaError({
+            code: 'CONFIG_INVALID',
+            message: `The default locale "${config.site.defaultLocale}" is not in the site locales.`,
+            hint: `Add it to site.locales, or pick one of: ${config.site.locales.join(', ')}.`,
+            details: { defaultLocale: config.site.defaultLocale, locales: config.site.locales },
+        });
+    }
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAgDvB,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE;IACZ,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACjC,CAAC,CAAA;AAEF,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC;IAChF,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE;QACZ,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACxB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;KACvC,CAAC;CACH,CAAC,CAAA;AAEF;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAClD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;QAChG,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,2CAA2C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YAC1E,IAAI,EAAE,uIAAuI;YAC7I,OAAO,EAAE,EAAE,QAAQ,EAAE;SACtB,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAA;IAC1B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,uBAAuB,MAAM,CAAC,IAAI,CAAC,aAAa,+BAA+B;YACxF,IAAI,EAAE,2CAA2C,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YAClF,OAAO,EAAE,EAAE,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE;SACpF,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/content/client.d.ts

@@ -0,0 +1,35 @@
+import type { ContentApiConfig } from '../config.js';
+import type { ContentClient, ResponseDependencies } from './types.js';
+/**
+ * The content client of contract D, and it is HTTP on purpose (ADR-0016).
+ *
+ * It holds one credential — a read-only token carrying the rights of the
+ * `public` role — and it speaks to `@cogenta/api` over the network. It imports
+ * neither `@cogenta/schema` nor a database driver, and it could not use one:
+ * there is no connection in this process to use.
+ *
+ * A theme therefore cannot reach a draft even by asking for one. The refusal
+ * happens in the permission layer on the other side of the wire, where it can
+ * be enforced rather than promised.
+ */
+export type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
+export interface ContentClientOptions extends ContentApiConfig {
+    /** Locale sent when a request does not name one. */
+    readonly locale?: string | undefined;
+    /** Injected in tests and by hosts with their own instrumentation. */
+    readonly fetch?: FetchLike | undefined;
+    /** Milliseconds before a request is abandoned. A slow API must not hang a build. */
+    readonly timeoutMs?: number | undefined;
+    /**
+     * Fired with what a response was actually built from, on every successful
+     * read — not only what the call asked for.
+     *
+     * This is the hook a render cache wires into. Without it, a page that embeds
+     * a related entry through server-side expansion tags only the entry it named
+     * directly, and stays stale forever after the related one changes: nothing in
+     * a direct request-response wrapping can see what the server inlined.
+     */
+    readonly onDependencies?: ((dependencies: ResponseDependencies) => void) | undefined;
+}
+export declare function createContentClient(options: ContentClientOptions): ContentClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/content/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/content/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACpD,OAAO,KAAK,EACV,aAAa,EAIb,oBAAoB,EACrB,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAEhF,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,oDAAoD;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,qEAAqE;IACrE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;IACtC,oFAAoF;IACpF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC;;;;;;;;OAQG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,YAAY,EAAE,oBAAoB,KAAK,IAAI,CAAC,GAAG,SAAS,CAAA;CACrF;AAiBD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAuIhF"}

package/dist/content/client.js

@@ -0,0 +1,155 @@
+import { CogentaError } from '@cogenta/core';
+const DEFAULT_BASE_PATH = '/api/content';
+const DEFAULT_TIMEOUT_MS = 10_000;
+export function createContentClient(options) {
+    const basePath = (options.basePath ?? DEFAULT_BASE_PATH).replace(/\/+$/u, '');
+    const origin = options.url.replace(/\/+$/u, '');
+    const doFetch = options.fetch ?? globalThis.fetch;
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    async function request(path, query) {
+        const url = new URL(`${origin}${basePath}${path}`);
+        for (const [key, value] of Object.entries(query))
+            url.searchParams.set(key, value);
+        const signal = AbortSignal.timeout(timeoutMs);
+        let response;
+        try {
+            response = await doFetch(url.toString(), {
+                method: 'GET',
+                signal,
+                headers: {
+                    accept: 'application/json',
+                    // The one credential of the delivery plane. Never logged, never put
+                    // in an error, never handed to a theme (rule R7).
+                    authorization: `Bearer ${options.token}`,
+                },
+            });
+        }
+        catch (error) {
+            throw new CogentaError({
+                code: 'CONTENT_API_FAILED',
+                message: `The content API could not be reached at ${url.pathname}.`,
+                hint: 'Check that the API is running and that content.url points at it. The renderer reads content over HTTP and has no other way in (ADR-0016).',
+                cause: error,
+                details: { path: url.pathname },
+            });
+        }
+        if (response.status === 404)
+            return null;
+        if (!response.ok)
+            throw await failure(response, url);
+        try {
+            return await response.json();
+        }
+        catch (error) {
+            throw new CogentaError({
+                code: 'CONTENT_API_FAILED',
+                message: `The content API returned a body that is not JSON for ${url.pathname}.`,
+                hint: 'Check that content.url points at the Cogenta API and not at a proxy or an error page.',
+                cause: error,
+                details: { path: url.pathname, status: response.status },
+            });
+        }
+    }
+    async function failure(response, url) {
+        const body = await response
+            .text()
+            .then(parseJson)
+            .catch(() => undefined);
+        const api = errorFrom(body);
+        const forbidden = response.status === 401 || response.status === 403;
+        return new CogentaError({
+            code: 'CONTENT_API_FAILED',
+            message: `The content API refused ${url.pathname} with ${response.status}${api === undefined ? '' : `: ${api}`}.`,
+            hint: forbidden
+                ? 'The render token carries the rights of the `public` role only. A theme never sees a draft, by design — ask for published content, or render this page through a preview token.'
+                : 'Check the request the theme made against the query vocabulary of the content API.',
+            details: { path: url.pathname, status: response.status },
+        });
+    }
+    function entryFrom(payload) {
+        if (payload === null)
+            return null;
+        const envelope = payload;
+        reportDependencies(envelope);
+        return envelope.data ?? null;
+    }
+    // The API qualifies an entry dependency as `<collection>:<id>` so two
+    // collections can never collide in the same set; the render side only ever
+    // tags by id, because ids are UUIDv7 and unique across every collection
+    // (`@cogenta/schema` `newId`) — the qualifier has already done its job by the
+    // time it gets here.
+    function bareId(qualified) {
+        const separator = qualified.indexOf(':');
+        return separator === -1 ? qualified : qualified.slice(separator + 1);
+    }
+    function reportDependencies(envelope) {
+        if (options.onDependencies === undefined)
+            return;
+        const wire = envelope.meta?.dependencies;
+        if (wire === undefined)
+            return;
+        options.onDependencies({
+            entries: (wire.entries ?? []).map(bareId),
+            media: wire.media ?? [],
+            collections: wire.collections ?? [],
+        });
+    }
+    return {
+        entry: async (collection, id) => entryFrom(await request(`/${encodeURIComponent(collection)}/${encodeURIComponent(id)}`, {})),
+        // Path resolution is a route lookup, not an entry lookup: the renderer
+        // knows a URL and nothing else. The API exposes it beside the collection
+        // routes, under a segment no collection can be named.
+        byPath: async (path) => entryFrom(await request('/-/by-path', { path })),
+        list: async (query) => {
+            const payload = await request(`/${encodeURIComponent(query.collection)}`, listQuery(query));
+            const envelope = payload;
+            if (envelope === null || !Array.isArray(envelope.data)) {
+                return { items: [], nextCursor: null, hasMore: false };
+            }
+            reportDependencies(envelope);
+            return {
+                items: envelope.data,
+                nextCursor: envelope.page?.nextCursor ?? null,
+                hasMore: envelope.page?.hasMore ?? false,
+            };
+        },
+    };
+    function listQuery(query) {
+        const parameters = {};
+        const locale = query.locale ?? options.locale;
+        if (locale !== undefined)
+            parameters.locale = locale;
+        if (query.filter !== undefined)
+            parameters.filter = JSON.stringify(query.filter);
+        if (query.sort !== undefined && query.sort.length > 0) {
+            parameters.sort = query.sort
+                .map((entry) => (entry.direction === 'desc' ? `-${entry.field}` : entry.field))
+                .join(',');
+        }
+        if (query.after !== undefined)
+            parameters.after = query.after;
+        if (query.limit !== undefined)
+            parameters.limit = String(query.limit);
+        if (query.depth !== undefined)
+            parameters.depth = String(query.depth);
+        return parameters;
+    }
+}
+function parseJson(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+}
+function errorFrom(body) {
+    if (typeof body !== 'object' || body === null)
+        return undefined;
+    const error = body.error;
+    if (typeof error !== 'object' || error === null)
+        return undefined;
+    const message = error.message;
+    return typeof message === 'string' ? message : undefined;
+}
+//# sourceMappingURL=client.js.map

package/dist/content/client.js.map

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

package/dist/content/types.d.ts

@@ -0,0 +1,104 @@
+/**
+ * The shapes a theme sees on the wire.
+ *
+ * Declared here rather than imported from `@cogenta/schema`, and that is the
+ * whole point of ADR-0016: the delivery plane must not link against the
+ * content engine, because a type import is one refactor away from a value
+ * import, and a value import puts the database in the process that runs
+ * third-party theme code. What crosses the boundary is JSON over HTTP, so what
+ * is declared here is JSON — structurally the same as the engine's entries,
+ * deliberately not the same declaration.
+ *
+ * `MediaAsset` is the one exception, and it stays inside the delivery plane:
+ * the image pipeline lives here too, so this is not a link to the engine.
+ */
+import type { MediaAsset } from '../images/types.js';
+export type ContentValues = Readonly<Record<string, unknown>>;
+export interface ContentBlock {
+    /** Contract B's `_key`: stable across edits, reorders and translations. */
+    readonly key: string;
+    readonly type: string;
+    readonly data: Readonly<Record<string, unknown>>;
+}
+export type BlockZones = Readonly<Record<string, readonly ContentBlock[]>>;
+export interface ContentEntry<TValues extends ContentValues = ContentValues> {
+    readonly id: string;
+    readonly locale: string;
+    readonly status: string;
+    readonly publishedAt: string | null;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly translationOf: string | null;
+    readonly version: number;
+    readonly values: TValues;
+    readonly blocks: BlockZones;
+}
+export type FilterOperator = 'eq' | 'ne' | 'lt' | 'lte' | 'gt' | 'gte' | 'in' | 'contains' | 'exists';
+export interface FieldCondition {
+    readonly field: string;
+    readonly operator: FilterOperator;
+    readonly value: unknown;
+}
+export type Filter = FieldCondition | {
+    readonly and: readonly Filter[];
+} | {
+    readonly or: readonly Filter[];
+};
+/**
+ * The query vocabulary a theme has, and the whole of it (ADR-0016's assumed
+ * renunciation): no joins, no hand-tuned queries. A theme that needs more needs
+ * a plugin, which is exactly the boundary the decision wanted.
+ */
+export interface QueryRequest {
+    readonly collection: string;
+    readonly locale?: string | undefined;
+    readonly filter?: Filter | undefined;
+    readonly sort?: readonly {
+        readonly field: string;
+        readonly direction: 'asc' | 'desc';
+    }[];
+    readonly after?: string | undefined;
+    readonly limit?: number | undefined;
+    readonly depth?: number | undefined;
+}
+export interface Page<T> {
+    readonly items: readonly T[];
+    readonly nextCursor: string | null;
+    readonly hasMore: boolean;
+}
+/** Contract D's `ctx.content`: the only door to data a theme has. */
+export interface ContentClient {
+    entry(collection: string, id: string): Promise<ContentEntry | null>;
+    byPath(path: string): Promise<ContentEntry | null>;
+    list(request: QueryRequest): Promise<Page<ContentEntry>>;
+}
+/**
+ * What a response was actually built from, entries a server-side relation
+ * expansion inlined included.
+ *
+ * A render cache keyed on tags can only invalidate what it knows a page read,
+ * and a page only asks for the entry it names directly — an article's response
+ * carries its author inlined by `depth`, and the author's id never crosses this
+ * client as a request of its own. Without this, publishing a new author name
+ * leaves the article page stale with no symptom at all. `@cogenta/api` derives
+ * this from the serialised payload and sends it back on every read; declared
+ * again here, structurally, for the same reason every other wire type is
+ * (ADR-0016) — not imported from the package that computed it.
+ */
+export interface ResponseDependencies {
+    readonly entries: readonly string[];
+    readonly media: readonly string[];
+    readonly collections: readonly string[];
+}
+/**
+ * A media entity as a theme receives it.
+ *
+ * `kind` and `poster` are not decoration: `hero.media` and
+ * `mediaFigure.media` accept an image **or** a video (contract B), and without
+ * them `ctx.image()` cannot say which it returned — every video renders as a
+ * broken `<img>`. Contract D names `MediaReference` without defining it; this
+ * is the definition, and it is the same shape the image pipeline consumes so
+ * that one concept has one type.
+ */
+export type MediaReference = MediaAsset;
+//# sourceMappingURL=types.d.ts.map

package/dist/content/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/content/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAEpD,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAE7D,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CACjD;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC,CAAC,CAAA;AAE1E,MAAM,WAAW,YAAY,CAAC,OAAO,SAAS,aAAa,GAAG,aAAa;IACzE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAC5B;AAED,MAAM,MAAM,cAAc,GACtB,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,UAAU,GACV,QAAQ,CAAA;AAEZ,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAA;IACjC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,MAAM,MAAM,GACd,cAAc,GACd;IAAE,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GACnC;IAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAA;AAEtC;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,EAAE,CAAA;IACzF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACpC;AAED,MAAM,WAAW,IAAI,CAAC,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAA;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B;AAED,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAA;IACnE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAA;IAClD,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAA;CACzD;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;CACxC;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,CAAA"}

package/dist/content/types.js

@@ -0,0 +1,16 @@
+/**
+ * The shapes a theme sees on the wire.
+ *
+ * Declared here rather than imported from `@cogenta/schema`, and that is the
+ * whole point of ADR-0016: the delivery plane must not link against the
+ * content engine, because a type import is one refactor away from a value
+ * import, and a value import puts the database in the process that runs
+ * third-party theme code. What crosses the boundary is JSON over HTTP, so what
+ * is declared here is JSON — structurally the same as the engine's entries,
+ * deliberately not the same declaration.
+ *
+ * `MediaAsset` is the one exception, and it stays inside the delivery plane:
+ * the image pipeline lives here too, so this is not a link to the engine.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/content/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/content/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/context/render-context.d.ts

@@ -0,0 +1,31 @@
+import type { SiteConfig } from '../config.js';
+import type { ContentClient } from '../content/types.js';
+import type { RenderContext } from './types.js';
+/**
+ * Builds the object a theme receives, and nothing the theme did not ask for.
+ *
+ * Every capability is a function the host supplies. That is what keeps the
+ * context honest: `link` cannot read the routing table because it is handed a
+ * resolver, and `image` cannot open a file because it only ever builds a URL.
+ */
+/** Messages per locale, then per key. Flat keys: `nav.home`, not nested objects. */
+export type Messages = Readonly<Record<string, Readonly<Record<string, string>>>>;
+export interface RenderContextOptions {
+    readonly site: SiteConfig;
+    readonly locale: string;
+    readonly url: URL | string;
+    readonly content: ContentClient;
+    readonly messages?: Messages | undefined;
+    /**
+     * Path of an entry, without the locale prefix, or null when the entry has no
+     * route. Supplied by the routing layer; the theme never sees it.
+     */
+    readonly resolveEntryPath?: ((target: {
+        collection: string;
+        id: string;
+    }) => string | null) | undefined;
+    /** Where image variants are served from. */
+    readonly imageEndpoint?: string | undefined;
+}
+export declare function createRenderContext(options: RenderContextOptions): RenderContext;
+//# sourceMappingURL=render-context.d.ts.map

package/dist/context/render-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-context.d.ts","sourceRoot":"","sources":["../../src/context/render-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,qBAAqB,CAAA;AACxE,OAAO,KAAK,EAAyC,aAAa,EAAE,MAAM,YAAY,CAAA;AAEtF;;;;;;GAMG;AAEH,oFAAoF;AACpF,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;AAEjF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;IACxC;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EACtB,CAAC,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,GAAG,IAAI,CAAC,GAC/D,SAAS,CAAA;IACb,4CAA4C;IAC5C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC5C;AAMD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CA4ChF"}