@cogenta/schema 0.1.2 → 0.2.0

package/dist/links/check.d.ts

@@ -0,0 +1,76 @@
+import type { ContentStore } from '../store/store.js';
+import type { CollectionDefinition } from '../types.js';
+import { type ContentLink } from './extract.js';
+/**
+ * The internal crawl the lot asks for (L14 task 3): walk every published
+ * entry, follow every link it holds, and report the ones that lead nowhere.
+ *
+ * Two deliberate limits, both about not surprising a site:
+ *
+ *  - **External URLs are opt-in.** A CMS that reaches out to the whole web
+ *    every time somebody asks it a question is a CMS that gets its host
+ *    rate-limited. `checkExternal` turns it on; without it, only links that
+ *    point back at this site are followed.
+ *  - **Nothing here schedules itself.** Rule R1 guarantees no durable worker,
+ *    so a "periodic" crawl that pretended to run on its own would be a promise
+ *    the deployment cannot keep. This is a function; `cogenta links check`
+ *    calls it, and an operator's cron calls that.
+ */
+export type BrokenLinkReason = 
+/** The referenced collection is not part of this site's schema. */
+'unknown_collection'
+/** The reference resolves to nothing at all — deleted, or never existed. */
+ | 'target_missing'
+/** The target exists but is not published, so a visitor gets a 404. */
+ | 'target_unpublished'
+/** A site-relative path that matches no route of any collection. */
+ | 'unroutable_path'
+/** An external URL that answered with an error status. */
+ | 'http_error'
+/** An external URL that could not be reached at all. */
+ | 'unreachable';
+export interface BrokenLink {
+    /** Where the broken link *is*, not where it points. */
+    readonly collection: string;
+    readonly entryId: string;
+    readonly locale: string;
+    /** Dotted path inside the entry — the field an editor has to open. */
+    readonly at: string;
+    readonly link: ContentLink;
+    readonly reason: BrokenLinkReason;
+    /** Present only for `http_error`. */
+    readonly status?: number;
+}
+export interface LinkCheckReport {
+    readonly checkedEntries: number;
+    readonly checkedLinks: number;
+    /** External URLs skipped because `checkExternal` was off. */
+    readonly skippedExternal: number;
+    readonly broken: readonly BrokenLink[];
+}
+export type LinkFetch = (url: string, init: {
+    method: 'HEAD' | 'GET';
+    redirect: 'follow';
+    signal: AbortSignal;
+}) => Promise<{
+    readonly ok: boolean;
+    readonly status: number;
+}>;
+export interface LinkCheckOptions {
+    readonly collections: readonly CollectionDefinition[];
+    /** The same accessor `serve.ts` builds; the crawl reads through the real store. */
+    readonly storeFor: (collection: CollectionDefinition) => ContentStore;
+    /** Locale routing, so a site-relative path with a locale prefix resolves. */
+    readonly locales?: readonly string[];
+    readonly defaultLocale?: string;
+    /** Follow `http(s)` URLs that leave the site. Off by default. */
+    readonly checkExternal?: boolean;
+    /** Defaults to the global `fetch`; overridable for tests. */
+    readonly fetchImpl?: LinkFetch;
+    /** Per-request budget for an external URL. */
+    readonly timeoutMs?: number;
+    /** How many entries are read at a time. Small: shared hosting has little memory. */
+    readonly pageSize?: number;
+}
+export declare function checkLinks(options: LinkCheckOptions): Promise<LinkCheckReport>;
+//# sourceMappingURL=check.d.ts.map

package/dist/links/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/links/check.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,EAAE,KAAK,WAAW,EAAgB,MAAM,cAAc,CAAA;AAE7D;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,gBAAgB;AAC1B,mEAAmE;AACjE,oBAAoB;AACtB,4EAA4E;GAC1E,gBAAgB;AAClB,uEAAuE;GACrE,oBAAoB;AACtB,oEAAoE;GAClE,iBAAiB;AACnB,0DAA0D;GACxD,YAAY;AACd,wDAAwD;GACtD,aAAa,CAAA;AAEjB,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;IACjC,qCAAqC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,6DAA6D;IAC7D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAA;CACvC;AAED,MAAM,MAAM,SAAS,GAAG,CACtB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,KACtE,OAAO,CAAC;IAAE,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAE/D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,SAAS,oBAAoB,EAAE,CAAA;IACrD,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,oBAAoB,KAAK,YAAY,CAAA;IACrE,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,iEAAiE;IACjE,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;IAChC,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAA;IAC9B,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAgCD,wBAAsB,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CA8JpF"}

package/dist/links/check.js

@@ -0,0 +1,169 @@
+import { matchPath } from '../routing/router.js';
+import { extractLinks } from './extract.js';
+/** Schemes that are not web links and have nothing to check. */
+const IGNORED_SCHEMES = ['mailto:', 'tel:', 'sms:', 'data:', 'javascript:', 'blob:'];
+function classify(href) {
+    const trimmed = href.trim();
+    if (trimmed === '' || trimmed.startsWith('#'))
+        return { kind: 'ignore' };
+    const lower = trimmed.toLowerCase();
+    if (IGNORED_SCHEMES.some((scheme) => lower.startsWith(scheme)))
+        return { kind: 'ignore' };
+    if (lower.startsWith('http://') || lower.startsWith('https://')) {
+        return { kind: 'external', url: trimmed };
+    }
+    // Protocol-relative (`//host/path`) is external too, and is not a path.
+    if (trimmed.startsWith('//'))
+        return { kind: 'external', url: `https:${trimmed}` };
+    if (trimmed.startsWith('/')) {
+        // The query string and fragment are not part of a route.
+        const pathname = trimmed.split(/[?#]/u)[0] ?? trimmed;
+        return { kind: 'path', pathname };
+    }
+    // A bare relative reference (`about`, `../x`) has no base to resolve against
+    // here — an entry's own URL depends on the route it is reached by. Ignored
+    // rather than guessed at.
+    return { kind: 'ignore' };
+}
+export async function checkLinks(options) {
+    const { collections, storeFor, checkExternal = false, timeoutMs = 10_000, pageSize = 50, } = options;
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const byName = new Map(collections.map((collection) => [collection.name, collection]));
+    const routingOptions = {
+        locales: options.locales ?? [],
+        defaultLocale: options.defaultLocale ?? 'en',
+    };
+    const broken = [];
+    let checkedEntries = 0;
+    let checkedLinks = 0;
+    let skippedExternal = 0;
+    /**
+     * One answer per distinct target, whatever how many entries point at it: a
+     * navigation link repeated on eighty pages is one lookup, and one HTTP
+     * request. Without this, checking a site is quadratic in its own menu.
+     */
+    const verdicts = new Map();
+    async function entryVerdict(collectionName, id) {
+        const target = byName.get(collectionName);
+        if (target === undefined)
+            return 'unknown_collection';
+        const store = storeFor(target);
+        if ((await store.read(id, { state: 'published' })) !== null)
+            return null;
+        // Not published — is it a draft, or gone entirely? The two are different
+        // problems for the person who has to fix it.
+        return (await store.read(id, { state: 'working' })) === null
+            ? 'target_missing'
+            : 'target_unpublished';
+    }
+    async function pathVerdict(pathname) {
+        const match = matchPath(collections, pathname, routingOptions);
+        if (match === null)
+            return 'unroutable_path';
+        const target = byName.get(match.collection);
+        if (target === undefined)
+            return 'unknown_collection';
+        const where = { ...match.params };
+        const page = await storeFor(target).list({
+            state: 'published',
+            where,
+            ...(match.locale === null ? {} : { locale: match.locale }),
+            limit: 1,
+        });
+        return page.items.length > 0 ? null : 'target_missing';
+    }
+    async function externalVerdict(url) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            // HEAD first, GET only if the server refuses HEAD: plenty of hosts answer
+            // 403/405 to a HEAD they would serve happily, and reporting those as
+            // broken would make the whole report untrustworthy.
+            let response = await fetchImpl(url, {
+                method: 'HEAD',
+                redirect: 'follow',
+                signal: controller.signal,
+            });
+            if (!response.ok && (response.status === 403 || response.status === 405)) {
+                response = await fetchImpl(url, {
+                    method: 'GET',
+                    redirect: 'follow',
+                    signal: controller.signal,
+                });
+            }
+            return response.ok ? { reason: null } : { reason: 'http_error', status: response.status };
+        }
+        catch {
+            return { reason: 'unreachable' };
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async function verdictFor(link) {
+        if (link.kind === 'entry') {
+            const key = `entry:${link.collection}/${link.id}`;
+            const cached = verdicts.get(key);
+            if (cached !== undefined)
+                return { reason: cached };
+            const reason = await entryVerdict(link.collection, link.id);
+            verdicts.set(key, reason);
+            return { reason };
+        }
+        const classified = classify(link.href);
+        if (classified.kind === 'ignore')
+            return { reason: null };
+        if (classified.kind === 'path') {
+            const key = `path:${classified.pathname}`;
+            const cached = verdicts.get(key);
+            if (cached !== undefined)
+                return { reason: cached };
+            const reason = await pathVerdict(classified.pathname);
+            verdicts.set(key, reason);
+            return { reason };
+        }
+        if (!checkExternal) {
+            skippedExternal += 1;
+            return { reason: null };
+        }
+        const key = `url:${classified.url}`;
+        const cached = verdicts.get(key);
+        if (cached !== undefined)
+            return { reason: cached };
+        const outcome = await externalVerdict(classified.url);
+        verdicts.set(key, outcome.reason);
+        return outcome;
+    }
+    for (const collection of collections) {
+        const store = storeFor(collection);
+        let cursor = null;
+        do {
+            const page = await store.list({
+                state: 'published',
+                limit: pageSize,
+                ...(cursor === null ? {} : { cursor }),
+            });
+            for (const entry of page.items) {
+                checkedEntries += 1;
+                for (const link of extractLinks(entry)) {
+                    checkedLinks += 1;
+                    const { reason, status } = await verdictFor(link);
+                    if (reason === null)
+                        continue;
+                    broken.push({
+                        collection: collection.name,
+                        entryId: entry.id,
+                        locale: entry.locale,
+                        at: link.at,
+                        link,
+                        reason,
+                        ...(status === undefined ? {} : { status }),
+                    });
+                }
+            }
+            cursor = page.hasMore ? page.nextCursor : null;
+        } while (cursor !== null);
+    }
+    return { checkedEntries, checkedLinks, skippedExternal, broken };
+}
+//# sourceMappingURL=check.js.map

package/dist/links/check.js.map

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

package/dist/links/extract.d.ts

@@ -0,0 +1,36 @@
+import type { ContentEntry } from '../store/types.js';
+/**
+ * Every link an entry holds, wherever it holds it (L14 task 3).
+ *
+ * **Why not the search index.** The lot suggests reusing what full-text search
+ * already indexed. It cannot be: `search/extract.ts` deliberately drops
+ * `href`, `url`, `src` and `markDefs` from what it stores — indexing them would
+ * make `https` a searchable term and rank a page by how many links it has. The
+ * index therefore contains no URL at all, so link checking crawls the entries
+ * themselves, which is the lot's own stated fallback.
+ *
+ * **Why a generic walk rather than a per-block reader.** Contract B has three
+ * different link shapes — a rich-text `markDefs` entry, an action `target`, a
+ * plain `url` field — and blocks are added to the vocabulary over time. A walk
+ * that recognises the *shapes* keeps working when a block is added; a switch
+ * over block types would silently stop checking the new one.
+ */
+/** A link to somewhere outside this entry. */
+export type ContentLink = {
+    readonly kind: 'url';
+    readonly href: string;
+    /** Dotted path inside the entry, so a report names where to go and fix it. */
+    readonly at: string;
+} | {
+    readonly kind: 'entry';
+    readonly collection: string;
+    readonly id: string;
+    readonly at: string;
+};
+/**
+ * Every link in an entry's values and blocks, deduplicated by target — a menu
+ * repeated in four blocks is one link to check, reported at the first place it
+ * was found.
+ */
+export declare function extractLinks(entry: ContentEntry): readonly ContentLink[];
+//# sourceMappingURL=extract.d.ts.map

package/dist/links/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/links/extract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD;;;;;;;;;;;;;;;GAeG;AAEH,8CAA8C;AAC9C,MAAM,MAAM,WAAW,GACnB;IACE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CACpB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CACpB,CAAA;AAuDL;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,WAAW,EAAE,CAgBxE"}

package/dist/links/extract.js

@@ -0,0 +1,69 @@
+/** Values that hold a URL wherever they appear. `src` is media, checked elsewhere. */
+const URL_KEYS = new Set(['href', 'url']);
+/** Deeper than any real block nests; a bound, not a guess about content. */
+const MAX_DEPTH = 12;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * An entity reference: `{ collection, id }`, the shape both `linkTargetSchema`
+ * (contract B actions) and an `internalLink` mark definition use. Matched
+ * structurally so that a future block reusing the same shape is checked too.
+ */
+function entityReferenceOf(value) {
+    const collection = value['collection'];
+    const id = value['id'];
+    if (typeof collection !== 'string' || typeof id !== 'string')
+        return null;
+    if (collection === '' || id === '')
+        return null;
+    return { collection, id };
+}
+function walk(value, at, into, depth) {
+    if (depth > MAX_DEPTH)
+        return;
+    if (Array.isArray(value)) {
+        value.forEach((item, index) => {
+            walk(item, `${at}[${index}]`, into, depth + 1);
+        });
+        return;
+    }
+    if (!isRecord(value))
+        return;
+    const reference = entityReferenceOf(value);
+    if (reference !== null) {
+        into.push({ kind: 'entry', collection: reference.collection, id: reference.id, at });
+        // Still descend: a block may carry a target *and* nested children.
+    }
+    for (const [key, nested] of Object.entries(value)) {
+        const path = at === '' ? key : `${at}.${key}`;
+        if (URL_KEYS.has(key) && typeof nested === 'string' && nested !== '') {
+            into.push({ kind: 'url', href: nested, at: path });
+            continue;
+        }
+        walk(nested, path, into, depth + 1);
+    }
+}
+/**
+ * Every link in an entry's values and blocks, deduplicated by target — a menu
+ * repeated in four blocks is one link to check, reported at the first place it
+ * was found.
+ */
+export function extractLinks(entry) {
+    const found = [];
+    walk(entry.values, '', found, 0);
+    for (const [zone, blocks] of Object.entries(entry.blocks)) {
+        walk(blocks, `blocks.${zone}`, found, 1);
+    }
+    const seen = new Set();
+    const unique = [];
+    for (const link of found) {
+        const key = link.kind === 'url' ? `url:${link.href}` : `entry:${link.collection}/${link.id}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        unique.push(link);
+    }
+    return unique;
+}
+//# sourceMappingURL=extract.js.map

package/dist/links/extract.js.map

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

package/dist/links/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Broken link detection (L14 task 3) — see `check.ts` for why it crawls the
+ * entries rather than the full-text index, and why nothing here schedules
+ * itself.
+ */
+export type { BrokenLink, BrokenLinkReason, LinkCheckOptions, LinkCheckReport, LinkFetch, } from './check.js';
+export { checkLinks } from './check.js';
+export type { ContentLink } from './extract.js';
+export { extractLinks } from './extract.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/links/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/links/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,SAAS,GACV,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACvC,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA"}

package/dist/links/index.js

@@ -0,0 +1,8 @@
+/**
+ * Broken link detection (L14 task 3) — see `check.ts` for why it crawls the
+ * entries rather than the full-text index, and why nothing here schedules
+ * itself.
+ */
+export { checkLinks } from './check.js';
+export { extractLinks } from './extract.js';
+//# sourceMappingURL=index.js.map

package/dist/links/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/links/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA"}

package/dist/store/columns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"columns.d.ts","sourceRoot":"","sources":["../../src/store/columns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,eAAe,EAAE,KAAK,WAAW,EAAa,MAAM,eAAe,CAAA;AAC/F,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE5D;;;;;;;;;;;;;;;;;GAiBG;AAEH,wBAAgB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,WAAW,CAIhE;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAEhF;AAED,wBAAgB,UAAU,IAAI,WAAW,CAIxC;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,WAAW,CAErE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,WAAW,CAGnE;AAED,wBAAgB,aAAa,IAAI,WAAW,CAE3C;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAK5D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,eAAe,GAAG,WAAW,CA+C3F;AAED,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,CAK1E"}
+{"version":3,"file":"columns.d.ts","sourceRoot":"","sources":["../../src/store/columns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,eAAe,EAAE,KAAK,WAAW,EAAa,MAAM,eAAe,CAAA;AAC/F,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE5D;;;;;;;;;;;;;;;;;GAiBG;AAEH,wBAAgB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,WAAW,CAIhE;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAEhF;AAED,wBAAgB,UAAU,IAAI,WAAW,CAIxC;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,WAAW,CAErE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,WAAW,CAGnE;AAED,wBAAgB,aAAa,IAAI,WAAW,CAE3C;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAO5D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,eAAe,GAAG,WAAW,CAgD3F;AAED,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,CAK1E"}

package/dist/store/columns.js

@@ -49,8 +49,10 @@ export function isColumnless(field) {
     if (field.kind === 'blocks')
         return true;
     // A to-many relation lives in a join table, with a real foreign key on both
-    // sides (contract A). Only a to-one relation is a column.
-    return field.kind === 'relation' && field.options['many'] === true;
+    // sides (contract A). Only a to-one relation is a column. A taxonomy field
+    // works the same way, its join table pointing at the terms table instead.
+    const joined = field.kind === 'relation' || field.kind === 'taxonomy';
+    return joined && field.options['many'] === true;
 }
 export function columnTypeFor(field, dialect) {
     switch (field.kind) {
@@ -81,6 +83,7 @@ export function columnTypeFor(field, dialect) {
             // table must not refuse to be created because it is not installed yet.
             return textColumn(dialect, 36);
         case 'relation':
+        case 'taxonomy':
             return uuidColumn(dialect);
         case 'richText':
         case 'json':

package/dist/store/columns.js.map

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

package/dist/store/index.d.ts

@@ -10,13 +10,22 @@ export type { Cursor } from './cursor.js';
 export { decodeCursor, encodeCursor } from './cursor.js';
 export type { BlockChange, ChangeKind, ContentDiff, FieldChange } from './diff.js';
 export { deepEqual, diffBlocks, diffBlockZones, diffContent, diffValues } from './diff.js';
-export { blocksTable, columnFor, entriesTable, isSystemColumn, relationTable, SYSTEM_COLUMNS, toSnakeCase, versionsTable, } from './naming.js';
+export type { ContentLifecycleEvent, ContentLifecycleEventName, LifecycleEventsOptions, } from './lifecycle-events.js';
+export { withLifecycleEvents } from './lifecycle-events.js';
+export { blocksTable, columnFor, entriesTable, isSystemColumn, relationTable, SYSTEM_COLUMNS, taxonomyTable, toSnakeCase, versionsTable, } from './naming.js';
 export { withReadOnlyStore } from './read-only.js';
+export type { Schema2MigrationOptions } from './schema-2-migration.js';
+export { schema2Migration } from './schema-2-migration.js';
+export type { SearchIndexingOptions } from './search-indexing.js';
+export { withSearchIndexing } from './search-indexing.js';
 export type { ContentStore, ContentStoreOptions } from './store.js';
 export { createContentStore } from './store.js';
 export type { RelationTarget } from './tables.js';
 export { assertUsableFields, createSchemaTables, dropSchemaTables, orderByDependency, relationsOf, } from './tables.js';
-export type { BlockZones, ContentBlock, ContentEntry, ContentValues, CreateInput, EntryState, ListOptions, LocaleFallback, LocaleResolution, Page, PublishInput, ResolveLocaleOptions, SortField, SortOrder, UpdateInput, VersionSummary, } from './types.js';
+export { assertDepth, childPath, depthOf, isBelow, isWithin, MAX_TAXONOMY_DEPTH, rebasedPath, TAXONOMY_PATH_LENGTH, } from './taxonomy-path.js';
+export type { CreateTermInput, ListTermsOptions, TaxonomyStore, TaxonomyStoreOptions, UpdateTermInput, } from './taxonomy-store.js';
+export { createTaxonomyStore } from './taxonomy-store.js';
+export type { BlockZones, ContentBlock, ContentEntry, ContentValues, CreateInput, DuplicateInput, EntryState, ListOptions, LocaleFallback, LocaleResolution, Page, PublishInput, PurgeReport, ReadOptions, ResolveLocaleOptions, SortField, SortOrder, TrashFilter, TrashOptions, UpdateInput, VersionSummary, } from './types.js';
 export type { NormalisedValues, NormaliseOptions } from './values.js';
 export { decodeFieldValue, encodeFieldValue, normaliseBlocks, normaliseValues } from './values.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/store/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,aAAa,EACb,aAAa,EACb,aAAa,EACb,YAAY,EACZ,UAAU,EACV,cAAc,EACd,UAAU,EACV,eAAe,EACf,UAAU,GACX,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACxD,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAClF,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC1F,OAAO,EACL,WAAW,EACX,SAAS,EACT,YAAY,EACZ,cAAc,EACd,aAAa,EACb,cAAc,EACd,WAAW,EACX,aAAa,GACd,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAClD,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAC/C,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,GACZ,MAAM,aAAa,CAAA;AACpB,YAAY,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,IAAI,EACJ,YAAY,EACZ,oBAAoB,EACpB,SAAS,EACT,SAAS,EACT,WAAW,EACX,cAAc,GACf,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACrE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,aAAa,EACb,aAAa,EACb,aAAa,EACb,YAAY,EACZ,UAAU,EACV,cAAc,EACd,UAAU,EACV,eAAe,EACf,UAAU,GACX,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACxD,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAClF,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC1F,YAAY,EACV,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,EACL,WAAW,EACX,SAAS,EACT,YAAY,EACZ,cAAc,EACd,aAAa,EACb,cAAc,EACd,aAAa,EACb,WAAW,EACX,aAAa,GACd,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAClD,YAAY,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACzD,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAC/C,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,GACZ,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,WAAW,EACX,SAAS,EACT,OAAO,EACP,OAAO,EACP,QAAQ,EACR,kBAAkB,EAClB,WAAW,EACX,oBAAoB,GACrB,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,oBAAoB,EACpB,eAAe,GAChB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AACzD,YAAY,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,WAAW,EACX,cAAc,EACd,UAAU,EACV,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,IAAI,EACJ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,oBAAoB,EACpB,SAAS,EACT,SAAS,EACT,WAAW,EACX,YAAY,EACZ,WAAW,EACX,cAAc,GACf,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACrE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA"}

package/dist/store/index.js

@@ -8,9 +8,14 @@
 export { booleanColumn, columnTypeFor, integerColumn, isColumnless, jsonColumn, onDeleteClause, textColumn, timestampColumn, uuidColumn, } from './columns.js';
 export { decodeCursor, encodeCursor } from './cursor.js';
 export { deepEqual, diffBlocks, diffBlockZones, diffContent, diffValues } from './diff.js';
-export { blocksTable, columnFor, entriesTable, isSystemColumn, relationTable, SYSTEM_COLUMNS, toSnakeCase, versionsTable, } from './naming.js';
+export { withLifecycleEvents } from './lifecycle-events.js';
+export { blocksTable, columnFor, entriesTable, isSystemColumn, relationTable, SYSTEM_COLUMNS, taxonomyTable, toSnakeCase, versionsTable, } from './naming.js';
 export { withReadOnlyStore } from './read-only.js';
+export { schema2Migration } from './schema-2-migration.js';
+export { withSearchIndexing } from './search-indexing.js';
 export { createContentStore } from './store.js';
 export { assertUsableFields, createSchemaTables, dropSchemaTables, orderByDependency, relationsOf, } from './tables.js';
+export { assertDepth, childPath, depthOf, isBelow, isWithin, MAX_TAXONOMY_DEPTH, rebasedPath, TAXONOMY_PATH_LENGTH, } from './taxonomy-path.js';
+export { createTaxonomyStore } from './taxonomy-store.js';
 export { decodeFieldValue, encodeFieldValue, normaliseBlocks, normaliseValues } from './values.js';
 //# sourceMappingURL=index.js.map

package/dist/store/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,aAAa,EACb,aAAa,EACb,aAAa,EACb,YAAY,EACZ,UAAU,EACV,cAAc,EACd,UAAU,EACV,eAAe,EACf,UAAU,GACX,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAExD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC1F,OAAO,EACL,WAAW,EACX,SAAS,EACT,YAAY,EACZ,cAAc,EACd,aAAa,EACb,cAAc,EACd,WAAW,EACX,aAAa,GACd,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAElD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAE/C,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,GACZ,MAAM,aAAa,CAAA;AAoBpB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,aAAa,EACb,aAAa,EACb,aAAa,EACb,YAAY,EACZ,UAAU,EACV,cAAc,EACd,UAAU,EACV,eAAe,EACf,UAAU,GACX,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAExD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAM1F,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,EACL,WAAW,EACX,SAAS,EACT,YAAY,EACZ,cAAc,EACd,aAAa,EACb,cAAc,EACd,aAAa,EACb,WAAW,EACX,aAAa,GACd,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAE1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAEzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAE/C,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,GACZ,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,WAAW,EACX,SAAS,EACT,OAAO,EACP,OAAO,EACP,QAAQ,EACR,kBAAkB,EAClB,WAAW,EACX,oBAAoB,GACrB,MAAM,oBAAoB,CAAA;AAQ3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAyBzD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA"}

package/dist/store/lifecycle-events.d.ts

@@ -0,0 +1,72 @@
+import type { CollectionDefinition, ContentStatus } from '../types.js';
+import type { ContentStore } from './store.js';
+import type { ContentValues } from './types.js';
+/**
+ * Emits a content lifecycle event when — and only when — the store really
+ * changed what the public can see (L14 task 1).
+ *
+ * Wrapping the *store* rather than hooking a route is the same choice
+ * `withSearchIndexing` and `withReadOnlyStore` already make, for the same
+ * reason: REST's `ContentService` and GraphQL's `ContentGateway` are handed
+ * the very same store instances by `serve.ts`, so one wrap covers both
+ * transports and neither can bypass it. A hook on `/api/content` would have
+ * left a GraphQL mutation publishing silently.
+ *
+ * This module knows nothing about HTTP, signatures or channels: it produces a
+ * plain value and hands it to `emit`. What carries it (today, a signed
+ * outbound webhook — `@cogenta/channels`) is the caller's decision, and
+ * `@cogenta/schema` gains no dependency for it.
+ */
+/**
+ * The closed set of events. Each one exists because a headless consumer that
+ * missed it would serve a page that is wrong, not merely stale:
+ *
+ *  - `content.publish` — something is public that was not. The event the lot
+ *    names, and the reason this module exists.
+ *  - `content.unpublish` — something is no longer public. Without it a cached
+ *    frontend keeps serving withdrawn content for ever.
+ *  - `content.delete` — same, permanently. `delete` is a hard delete in this
+ *    schema version, so nothing is left to poll for.
+ *
+ * Draft edits are deliberately *not* events: with `versioning.drafts` on they
+ * change nothing a visitor can see, and a consumer that rebuilt on each
+ * keystroke would rebuild for nothing.
+ */
+export type ContentLifecycleEventName = 'content.publish' | 'content.unpublish' | 'content.delete';
+/**
+ * What a receiver is told. Deliberately *identity and location, never the
+ * content body*: the body may be large, may be about to change again, and is
+ * already available — with permissions checked — from the API the receiver
+ * already talks to. Sending it here would push content into a third party's
+ * logs on every save, which is not something publishing a page ought to mean.
+ */
+export interface ContentLifecycleEvent {
+    readonly event: ContentLifecycleEventName;
+    readonly collection: string;
+    readonly id: string;
+    readonly locale: string;
+    readonly status: ContentStatus;
+    readonly publishedAt: string | null;
+    readonly updatedAt: string;
+    readonly version: number;
+    /**
+     * The site-relative path the entry is reachable at, or `null` when the
+     * collection has no route (or its route cannot be built from the values it
+     * currently holds). Computed with `buildPath`, the same function the router
+     * and the sitemap use — never a second URL convention.
+     */
+    readonly path: string | null;
+}
+export interface LifecycleEventsOptions {
+    readonly collection: CollectionDefinition;
+    /**
+     * Receives every event. Awaited, so a caller may batch or await delivery —
+     * but a rejection is caught and routed to `onError`, never propagated: an
+     * editor's publish must not fail because a webhook receiver is down.
+     */
+    readonly emit: (event: ContentLifecycleEvent) => Promise<void> | void;
+    /** Called when `emit` throws or rejects. Defaults to swallowing it; `serve.ts` logs. */
+    readonly onError?: (error: unknown) => void;
+}
+export declare function withLifecycleEvents<TValues extends ContentValues = ContentValues>(store: ContentStore<TValues>, options: LifecycleEventsOptions): ContentStore<TValues>;
+//# sourceMappingURL=lifecycle-events.d.ts.map

package/dist/store/lifecycle-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-events.d.ts","sourceRoot":"","sources":["../../src/store/lifecycle-events.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAgB,aAAa,EAAE,MAAM,YAAY,CAAA;AAE7D;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,yBAAyB,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,gBAAgB,CAAA;AAElG;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,yBAAyB,CAAA;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAA;IACzC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IACrE,wFAAwF;IACxF,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CAC5C;AAiBD,wBAAgB,mBAAmB,CAAC,OAAO,SAAS,aAAa,GAAG,aAAa,EAC/E,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,EAC5B,OAAO,EAAE,sBAAsB,GAC9B,YAAY,CAAC,OAAO,CAAC,CAuDvB"}