@cogenta/schema 0.1.0

package/dist/search/types.d.ts

@@ -0,0 +1,98 @@
+import type { DatabaseDialect, HealthReport } from '@cogenta/core';
+import type { ContentStatus } from '../types.js';
+/**
+ * One indexable unit: an entry, in one locale, in one state.
+ *
+ * The index holds *extracted text*, never the stored JSON. A `richText`
+ * document indexed raw would make `_type`, `span` and `markDefs` searchable
+ * terms, and would rank a page by how many spans it happens to be split into.
+ */
+export interface SearchDocument {
+    readonly id: string;
+    readonly collection: string;
+    readonly locale: string;
+    readonly status: ContentStatus;
+    /** Short label, returned with the hit so a caller can render a result list. */
+    readonly title: string;
+    /** Everything else worth matching, already flattened to plain text. */
+    readonly body: string;
+}
+/** What identifies a document in the index. Entry ids are unique, but the
+ * collection is part of the key so that clearing one collection is possible. */
+export interface SearchReference {
+    readonly id: string;
+    readonly collection: string;
+}
+/**
+ * A query.
+ *
+ * `locale` and `status` are **not optional filters**: they are the query.
+ * Section 5 of the architecture makes permission filtering at query time
+ * non-negotiable, and the way to honour that is to make it impossible to ask
+ * for "everything" — there is no value of `SearchQuery` that reaches a draft
+ * unless the caller names `draft`, and no value that crosses a locale.
+ */
+export interface SearchQuery {
+    readonly text: string;
+    readonly locale: string;
+    /** Defaults to `published`: the safe answer when a caller says nothing. */
+    readonly status?: ContentStatus;
+    /** Restricts to these collections. Absent means every indexed collection. */
+    readonly collections?: readonly string[];
+    readonly limit?: number;
+    readonly offset?: number;
+}
+export interface SearchHit {
+    readonly id: string;
+    readonly collection: string;
+    readonly locale: string;
+    readonly status: ContentStatus;
+    readonly title: string;
+    /**
+     * Relevance, higher is better. Comparable **within one result set only**:
+     * a `ts_rank`, an InnoDB fulltext score and a BM25 are three different
+     * numbers, and the L1 spec accepts that rather than reimplementing an engine.
+     */
+    readonly score: number;
+}
+export interface SearchResults {
+    readonly hits: readonly SearchHit[];
+    readonly hasMore: boolean;
+    /**
+     * Offset of the next page, or null.
+     *
+     * Search is the one place the project pages by offset rather than by cursor.
+     * A keyset cursor needs a total order over stable column values; a relevance
+     * score is neither stable across an edit nor comparable between two runs of
+     * the query, so a cursor built on it would silently skip and repeat rows.
+     * The offset is capped instead, which is what a search UI needs anyway.
+     */
+    readonly nextOffset: number | null;
+}
+/**
+ * Full-text search, one interface over three engines that agree on very little.
+ *
+ * Postgres has `tsvector` and GIN, MySQL has `FULLTEXT` in boolean mode, SQLite
+ * has FTS5 — and, when the runtime was built without it, nothing at all. The
+ * L1 spec asks for exactly this: a common interface, and unequal result quality
+ * accepted rather than a search engine written from scratch. What every
+ * implementation *does* guarantee is the part that is not about ranking:
+ *
+ * - a document whose text contains every term of the query is found;
+ * - accents and case never change whether it is found;
+ * - a document in another locale, or in another state, is never returned.
+ */
+export interface SearchDriver {
+    readonly dialect: DatabaseDialect;
+    /** Adds or replaces a document. Indexing the same reference twice is a
+     * rewrite, so re-indexing after an edit needs no prior delete. */
+    index(document: SearchDocument): Promise<void>;
+    remove(reference: SearchReference): Promise<void>;
+    search(query: SearchQuery): Promise<SearchResults>;
+    /** Empties the index, or only one collection's share of it. */
+    clear(scope?: {
+        readonly collection?: string;
+    }): Promise<void>;
+    health(): Promise<HealthReport>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/search/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED;gFACgF;AAChF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAA;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,CAAA;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB;;;;;;;;OAQG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CACnC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC;sEACkE;IAClE,KAAK,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,MAAM,CAAC,SAAS,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;IAClD,+DAA+D;IAC/D,KAAK,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9D,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC,CAAA;CAChC"}

package/dist/search/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/search/types.js.map

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

package/dist/store/columns.d.ts

@@ -0,0 +1,33 @@
+import { type DatabaseDialect, type SqlFragment } from '@cogenta/core';
+import type { FieldDefinition, OnDelete } from '../types.js';
+/**
+ * The physical type of every field, per dialect.
+ *
+ * Two choices here are deliberate and worth stating, because both look wrong to
+ * someone who knows only one database:
+ *
+ * 1. **Identifiers are `uuid` on Postgres, `char(36)` on MySQL, `text` on
+ *    SQLite** (ADR-0015). The application mints the value, so nothing depends on
+ *    `RETURNING` or on `insertId`.
+ *
+ * 2. **Timestamps and JSON are stored as text on every dialect.** A `timestamptz`
+ *    comes back from `pg` as a `Date` while SQLite returns a string, and a
+ *    `jsonb` comes back parsed while MySQL returns a string — so a column typed
+ *    "natively" would make a row mean something different per dialect, which is
+ *    exactly the leak the db layer exists to prevent. Contract A already
+ *    declares `createdAt` as a string; ISO-8601 in UTC also sorts
+ *    lexicographically, which is what keyset pagination needs.
+ */
+export declare function uuidColumn(dialect: DatabaseDialect): SqlFragment;
+/** `varchar(n)` where it exists; SQLite has one string type and ignores the length. */
+export declare function textColumn(dialect: DatabaseDialect, length: number): SqlFragment;
+export declare function jsonColumn(): SqlFragment;
+export declare function timestampColumn(dialect: DatabaseDialect): SqlFragment;
+export declare function booleanColumn(dialect: DatabaseDialect): SqlFragment;
+export declare function integerColumn(): SqlFragment;
+/** Field kinds that get no column of their own on the entry table. */
+export declare function isColumnless(field: FieldDefinition): boolean;
+export declare function columnTypeFor(field: FieldDefinition, dialect: DatabaseDialect): SqlFragment;
+/** `restrict` is the default on purpose: deleting an author must not erase articles. */
+export declare function onDeleteClause(onDelete: OnDelete | undefined): SqlFragment;
+//# sourceMappingURL=columns.d.ts.map

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

@@ -0,0 +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"}

package/dist/store/columns.js

@@ -0,0 +1,113 @@
+import { CogentaError, unsafeRaw } from '@cogenta/core';
+/**
+ * The physical type of every field, per dialect.
+ *
+ * Two choices here are deliberate and worth stating, because both look wrong to
+ * someone who knows only one database:
+ *
+ * 1. **Identifiers are `uuid` on Postgres, `char(36)` on MySQL, `text` on
+ *    SQLite** (ADR-0015). The application mints the value, so nothing depends on
+ *    `RETURNING` or on `insertId`.
+ *
+ * 2. **Timestamps and JSON are stored as text on every dialect.** A `timestamptz`
+ *    comes back from `pg` as a `Date` while SQLite returns a string, and a
+ *    `jsonb` comes back parsed while MySQL returns a string — so a column typed
+ *    "natively" would make a row mean something different per dialect, which is
+ *    exactly the leak the db layer exists to prevent. Contract A already
+ *    declares `createdAt` as a string; ISO-8601 in UTC also sorts
+ *    lexicographically, which is what keyset pagination needs.
+ */
+export function uuidColumn(dialect) {
+    if (dialect === 'postgres')
+        return unsafeRaw('uuid');
+    if (dialect === 'mysql')
+        return unsafeRaw('char(36)');
+    return unsafeRaw('text');
+}
+/** `varchar(n)` where it exists; SQLite has one string type and ignores the length. */
+export function textColumn(dialect, length) {
+    return unsafeRaw(dialect === 'sqlite' ? 'text' : `varchar(${length})`);
+}
+export function jsonColumn() {
+    // Text on every dialect, not `jsonb`/`json`: see the note above about drivers
+    // parsing one and not the other. Nothing in L1 queries inside the document.
+    return unsafeRaw('text');
+}
+export function timestampColumn(dialect) {
+    return textColumn(dialect, 32);
+}
+export function booleanColumn(dialect) {
+    if (dialect === 'postgres')
+        return unsafeRaw('boolean');
+    return unsafeRaw(dialect === 'mysql' ? 'tinyint' : 'integer');
+}
+export function integerColumn() {
+    return unsafeRaw('integer');
+}
+/** Field kinds that get no column of their own on the entry table. */
+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;
+}
+export function columnTypeFor(field, dialect) {
+    switch (field.kind) {
+        case 'text': {
+            const max = field.options['max'];
+            return typeof max === 'number' && max > 0 && max <= 65_535
+                ? textColumn(dialect, max)
+                : unsafeRaw('text');
+        }
+        case 'slug':
+            return textColumn(dialect, 255);
+        case 'select':
+            return textColumn(dialect, 255);
+        case 'color':
+            return textColumn(dialect, 32);
+        case 'number':
+            if (dialect === 'postgres')
+                return unsafeRaw('double precision');
+            return unsafeRaw(dialect === 'mysql' ? 'double' : 'real');
+        case 'boolean':
+            return booleanColumn(dialect);
+        case 'date':
+            return textColumn(dialect, 10);
+        case 'datetime':
+            return timestampColumn(dialect);
+        case 'media':
+            // No foreign key: the media library is its own subsystem and a content
+            // table must not refuse to be created because it is not installed yet.
+            return textColumn(dialect, 36);
+        case 'relation':
+            return uuidColumn(dialect);
+        case 'richText':
+        case 'json':
+        case 'geo':
+            return jsonColumn();
+        case 'blocks':
+            throw new CogentaError({
+                code: 'CONTENT_INVALID',
+                message: 'A blocks field has no column: each block is a row of its own.',
+                hint: 'This is a bug in the caller — blocks are stored in the <collection>_blocks table.',
+            });
+        default:
+            throw new CogentaError({
+                code: 'CONFIG_INVALID',
+                message: `Unknown field kind "${String(field.kind)}".`,
+                hint: 'Field kinds are the closed set declared by contract A.',
+                details: { kind: field.kind },
+            });
+    }
+}
+/** `restrict` is the default on purpose: deleting an author must not erase articles. */
+export function onDeleteClause(onDelete) {
+    const action = onDelete ?? 'restrict';
+    if (action === 'cascade')
+        return unsafeRaw('on delete cascade');
+    if (action === 'setNull')
+        return unsafeRaw('on delete set null');
+    return unsafeRaw('on delete restrict');
+}
+//# sourceMappingURL=columns.js.map

package/dist/store/columns.js.map

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

package/dist/store/cursor.d.ts

@@ -0,0 +1,23 @@
+import type { SortField, SortOrder } from './types.js';
+/**
+ * Keyset pagination. Never an offset.
+ *
+ * `offset` counts rows from the start of the result on every request, so an
+ * insertion or a deletion anywhere before the window shifts everything after it:
+ * a reader paging through a live collection sees an entry twice, or never. The
+ * L1 spec calls this out and the acceptance criterion is explicit — "the cursor
+ * is stable during concurrent insertions".
+ *
+ * A cursor is therefore a *position in the ordering*, not a count: the sort
+ * value and the id of the last row handed out. The next page asks for rows
+ * strictly after that point, which no concurrent write can move.
+ */
+export interface Cursor {
+    readonly field: SortField;
+    readonly direction: 'asc' | 'desc';
+    readonly value: string;
+    readonly id: string;
+}
+export declare function encodeCursor(cursor: Cursor): string;
+export declare function decodeCursor(raw: string, expected: SortOrder): Cursor;
+//# sourceMappingURL=cursor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/store/cursor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEtD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CACpB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,GAAG,MAAM,CAkCrE"}

package/dist/store/cursor.js

@@ -0,0 +1,36 @@
+import { CogentaError } from '@cogenta/core';
+export function encodeCursor(cursor) {
+    return Buffer.from(JSON.stringify(cursor), 'utf8').toString('base64url');
+}
+export function decodeCursor(raw, expected) {
+    const invalid = (reason) => new CogentaError({
+        code: 'CONTENT_INVALID',
+        message: `This pagination cursor cannot be used: ${reason}.`,
+        hint: 'Pass the `nextCursor` of the previous page unchanged, with the same sort.',
+    });
+    let parsed;
+    try {
+        parsed = JSON.parse(Buffer.from(raw, 'base64url').toString('utf8'));
+    }
+    catch {
+        throw invalid('it is not a cursor this API produced');
+    }
+    if (typeof parsed !== 'object' || parsed === null)
+        throw invalid('it is not a cursor');
+    const candidate = parsed;
+    if (typeof candidate.value !== 'string' || typeof candidate.id !== 'string') {
+        throw invalid('it is missing its position');
+    }
+    // A cursor taken under one ordering means nothing under another: the same
+    // position would skip rows or repeat them. Refusing is the only safe answer.
+    if (candidate.field !== expected.field || candidate.direction !== expected.direction) {
+        throw invalid('it was produced with a different sort order');
+    }
+    return {
+        field: candidate.field,
+        direction: candidate.direction,
+        value: candidate.value,
+        id: candidate.id,
+    };
+}
+//# sourceMappingURL=cursor.js.map

package/dist/store/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/store/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAuB5C,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;AAC1E,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,QAAmB;IAC3D,MAAM,OAAO,GAAG,CAAC,MAAc,EAAgB,EAAE,CAC/C,IAAI,YAAY,CAAC;QACf,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,0CAA0C,MAAM,GAAG;QAC5D,IAAI,EAAE,2EAA2E;KAClF,CAAC,CAAA;IAEJ,IAAI,MAAe,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAA;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,OAAO,CAAC,sCAAsC,CAAC,CAAA;IACvD,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;QAAE,MAAM,OAAO,CAAC,oBAAoB,CAAC,CAAA;IACtF,MAAM,SAAS,GAAG,MAAyB,CAAA;IAE3C,IAAI,OAAO,SAAS,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,SAAS,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC5E,MAAM,OAAO,CAAC,4BAA4B,CAAC,CAAA;IAC7C,CAAC;IAED,0EAA0E;IAC1E,6EAA6E;IAC7E,IAAI,SAAS,CAAC,KAAK,KAAK,QAAQ,CAAC,KAAK,IAAI,SAAS,CAAC,SAAS,KAAK,QAAQ,CAAC,SAAS,EAAE,CAAC;QACrF,MAAM,OAAO,CAAC,6CAA6C,CAAC,CAAA;IAC9D,CAAC;IAED,OAAO;QACL,KAAK,EAAE,SAAS,CAAC,KAAK;QACtB,SAAS,EAAE,SAAS,CAAC,SAAS;QAC9B,KAAK,EAAE,SAAS,CAAC,KAAK;QACtB,EAAE,EAAE,SAAS,CAAC,EAAE;KACjB,CAAA;AACH,CAAC"}

package/dist/store/diff.d.ts

@@ -0,0 +1,59 @@
+import type { BlockZones, ContentBlock, ContentValues } from './types.js';
+/**
+ * Field-by-field and block-by-block. Never a diff of a serialisation.
+ *
+ * The L1 spec is blunt about why: a diff computed on the JSON text of an entry
+ * is unreadable, and unreadable is the same as absent — nobody approves a change
+ * they cannot see. An editor wants "the subtitle changed" and "the third block
+ * moved to second", not a wall of braces.
+ */
+export type ChangeKind = 'added' | 'removed' | 'changed';
+export interface FieldChange {
+    readonly field: string;
+    readonly change: ChangeKind;
+    readonly before: unknown;
+    readonly after: unknown;
+}
+export interface BlockChange {
+    /** The block zone this block belongs to. */
+    readonly zone: string;
+    /** The stable `_key` of the block; how a block is followed across versions. */
+    readonly key: string;
+    readonly type: string;
+    readonly change: ChangeKind | 'moved';
+    readonly fromIndex: number | null;
+    readonly toIndex: number | null;
+    /** Populated for `changed`: what changed inside the block. */
+    readonly fields: readonly FieldChange[];
+}
+export interface ContentDiff {
+    readonly fields: readonly FieldChange[];
+    readonly blocks: readonly BlockChange[];
+    readonly changed: boolean;
+}
+/**
+ * Structural equality, without a dependency (rule R9).
+ *
+ * Values here are JSON-shaped: what a field holds after decoding. Key order is
+ * not significant, so `{a,b}` and `{b,a}` compare equal — a diff that reported
+ * a change because the driver returned keys in another order would be noise.
+ */
+export declare function deepEqual(left: unknown, right: unknown): boolean;
+export declare function diffValues(before: ContentValues, after: ContentValues): FieldChange[];
+/**
+ * Blocks are matched by `_key`, never by position.
+ *
+ * Matching by position would report an insertion at the top as "every block
+ * changed". Matching by key reports one addition and a set of moves, which is
+ * what actually happened.
+ */
+export declare function diffBlocks(zone: string, before: readonly ContentBlock[], after: readonly ContentBlock[]): BlockChange[];
+export declare function diffBlockZones(before: BlockZones, after: BlockZones): BlockChange[];
+export declare function diffContent(before: {
+    readonly values: ContentValues;
+    readonly blocks: BlockZones;
+}, after: {
+    readonly values: ContentValues;
+    readonly blocks: BlockZones;
+}): ContentDiff;
+//# sourceMappingURL=diff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/store/diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAEzE;;;;;;;GAOG;AAEH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAA;AAExD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,+EAA+E;IAC/E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAA;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAA;CACxC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAA;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAA;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAoBhE;AAOD,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,WAAW,EAAE,CAcrF;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,KAAK,EAAE,SAAS,YAAY,EAAE,GAC7B,WAAW,EAAE,CAgEf;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,GAAG,WAAW,EAAE,CAGnF;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAAE,EACvE,KAAK,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GACrE,WAAW,CAIb"}

package/dist/store/diff.js

@@ -0,0 +1,124 @@
+/**
+ * Structural equality, without a dependency (rule R9).
+ *
+ * Values here are JSON-shaped: what a field holds after decoding. Key order is
+ * not significant, so `{a,b}` and `{b,a}` compare equal — a diff that reported
+ * a change because the driver returned keys in another order would be noise.
+ */
+export function deepEqual(left, right) {
+    if (Object.is(left, right))
+        return true;
+    if (typeof left !== typeof right)
+        return false;
+    if (left === null || right === null)
+        return false;
+    if (typeof left !== 'object' || typeof right !== 'object')
+        return false;
+    if (Array.isArray(left) || Array.isArray(right)) {
+        if (!Array.isArray(left) || !Array.isArray(right))
+            return false;
+        if (left.length !== right.length)
+            return false;
+        return left.every((item, index) => deepEqual(item, right[index]));
+    }
+    const leftRecord = left;
+    const rightRecord = right;
+    const keys = new Set([...Object.keys(leftRecord), ...Object.keys(rightRecord)]);
+    for (const key of keys) {
+        if (!deepEqual(leftRecord[key], rightRecord[key]))
+            return false;
+    }
+    return true;
+}
+/** Undefined and null both mean "no value"; only one of them is ever stored. */
+function isAbsent(value) {
+    return value === undefined || value === null;
+}
+export function diffValues(before, after) {
+    const fields = [...new Set([...Object.keys(before), ...Object.keys(after)])].sort();
+    const changes = [];
+    for (const field of fields) {
+        const from = before[field];
+        const to = after[field];
+        if (deepEqual(from, to))
+            continue;
+        const change = isAbsent(from) ? 'added' : isAbsent(to) ? 'removed' : 'changed';
+        changes.push({ field, change, before: from ?? null, after: to ?? null });
+    }
+    return changes;
+}
+/**
+ * Blocks are matched by `_key`, never by position.
+ *
+ * Matching by position would report an insertion at the top as "every block
+ * changed". Matching by key reports one addition and a set of moves, which is
+ * what actually happened.
+ */
+export function diffBlocks(zone, before, after) {
+    const beforeIndex = new Map(before.map((block, index) => [block.key, { block, index }]));
+    const afterIndex = new Map(after.map((block, index) => [block.key, { block, index }]));
+    const changes = [];
+    for (const [key, { block, index }] of beforeIndex) {
+        if (afterIndex.has(key))
+            continue;
+        changes.push({
+            zone,
+            key,
+            type: block.type,
+            change: 'removed',
+            fromIndex: index,
+            toIndex: null,
+            fields: [],
+        });
+    }
+    for (const [key, { block, index }] of afterIndex) {
+        const previous = beforeIndex.get(key);
+        if (previous === undefined) {
+            changes.push({
+                zone,
+                key,
+                type: block.type,
+                change: 'added',
+                fromIndex: null,
+                toIndex: index,
+                fields: [],
+            });
+            continue;
+        }
+        const fields = diffValues(previous.block.data, block.data);
+        const retyped = previous.block.type !== block.type;
+        if (fields.length > 0 || retyped) {
+            changes.push({
+                zone,
+                key,
+                type: block.type,
+                change: 'changed',
+                fromIndex: previous.index,
+                toIndex: index,
+                fields,
+            });
+        }
+        else if (previous.index !== index) {
+            changes.push({
+                zone,
+                key,
+                type: block.type,
+                change: 'moved',
+                fromIndex: previous.index,
+                toIndex: index,
+                fields: [],
+            });
+        }
+    }
+    return changes.sort((left, right) => (left.toIndex ?? left.fromIndex ?? 0) - (right.toIndex ?? right.fromIndex ?? 0));
+}
+export function diffBlockZones(before, after) {
+    const zones = [...new Set([...Object.keys(before), ...Object.keys(after)])].sort();
+    return zones.flatMap((zone) => diffBlocks(zone, before[zone] ?? [], after[zone] ?? []));
+}
+export function diffContent(before, after) {
+    const fields = diffValues(before.values, after.values);
+    const blocks = diffBlockZones(before.blocks, after.blocks);
+    return { fields, blocks, changed: fields.length > 0 || blocks.length > 0 };
+}
+//# sourceMappingURL=diff.js.map

package/dist/store/diff.js.map

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

package/dist/store/fragments.d.ts

@@ -0,0 +1,13 @@
+import { type SqlFragment } from '@cogenta/core';
+/**
+ * Composition helpers over the `sql` tag of `@cogenta/core`.
+ *
+ * Everything dynamic in this package — a column list, a set clause, an `in` list
+ * — is built from bound fragments here. No call site ever writes a placeholder:
+ * Postgres wants `$1` and the others want `?`, and a hand-written one is both a
+ * dialect leak and the shortest path to an injection.
+ */
+export declare function joinFragments(items: readonly SqlFragment[], separator: string): SqlFragment;
+/** `(a, b, c)` from bound values, for an `in` predicate or an `insert`. */
+export declare function valueList(values: readonly unknown[]): SqlFragment;
+//# sourceMappingURL=fragments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fragments.d.ts","sourceRoot":"","sources":["../../src/store/fragments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,WAAW,EAAkB,MAAM,eAAe,CAAA;AAE9E;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,CAW3F;AAED,2EAA2E;AAC3E,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,WAAW,CAKjE"}

package/dist/store/fragments.js

@@ -0,0 +1,25 @@
+import { CogentaError, sql, unsafeRaw } from '@cogenta/core';
+/**
+ * Composition helpers over the `sql` tag of `@cogenta/core`.
+ *
+ * Everything dynamic in this package — a column list, a set clause, an `in` list
+ * — is built from bound fragments here. No call site ever writes a placeholder:
+ * Postgres wants `$1` and the others want `?`, and a hand-written one is both a
+ * dialect leak and the shortest path to an injection.
+ */
+export function joinFragments(items, separator) {
+    if (items.length === 0) {
+        throw new CogentaError({
+            code: 'INTERNAL',
+            message: 'Tried to build an empty SQL list.',
+            hint: 'This is a bug: the caller should have skipped the statement entirely.',
+        });
+    }
+    const glue = unsafeRaw(separator);
+    return items.reduce((left, right) => sql `${left}${glue}${right}`);
+}
+/** `(a, b, c)` from bound values, for an `in` predicate or an `insert`. */
+export function valueList(values) {
+    return joinFragments(values.map((value) => sql `${value}`), ', ');
+}
+//# sourceMappingURL=fragments.js.map

package/dist/store/fragments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragments.js","sourceRoot":"","sources":["../../src/store/fragments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAoB,GAAG,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9E;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,KAA6B,EAAE,SAAiB;IAC5E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,mCAAmC;YAC5C,IAAI,EAAE,uEAAuE;SAC9E,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,CAAA;IACjC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,CAAA,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC,CAAA;AACnE,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,SAAS,CAAC,MAA0B;IAClD,OAAO,aAAa,CAClB,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAA,GAAG,KAAK,EAAE,CAAC,EACpC,IAAI,CACL,CAAA;AACH,CAAC"}

package/dist/store/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The content persistence layer: CRUD, drafts, versions, diff and i18n.
+ *
+ * Everything here is portable across Postgres, MySQL, MariaDB and SQLite by
+ * going through `DatabaseHandle` from `@cogenta/core`. No dialect difference
+ * leaks past this folder, and no SQL is written outside it.
+ */
+export { booleanColumn, columnTypeFor, integerColumn, isColumnless, jsonColumn, onDeleteClause, textColumn, timestampColumn, uuidColumn, } from './columns.js';
+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 { withReadOnlyStore } from './read-only.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 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

@@ -0,0 +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"}

package/dist/store/index.js

@@ -0,0 +1,16 @@
+/**
+ * The content persistence layer: CRUD, drafts, versions, diff and i18n.
+ *
+ * Everything here is portable across Postgres, MySQL, MariaDB and SQLite by
+ * going through `DatabaseHandle` from `@cogenta/core`. No dialect difference
+ * leaks past this folder, and no SQL is written outside it.
+ */
+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 { withReadOnlyStore } from './read-only.js';
+export { createContentStore } from './store.js';
+export { assertUsableFields, createSchemaTables, dropSchemaTables, orderByDependency, relationsOf, } from './tables.js';
+export { decodeFieldValue, encodeFieldValue, normaliseBlocks, normaliseValues } from './values.js';
+//# sourceMappingURL=index.js.map

package/dist/store/index.js.map

@@ -0,0 +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"}