@cogenta/schema 0.3.0 → 0.5.0

package/dist/store/pattern-store.d.ts

@@ -0,0 +1,75 @@
+import { type DatabaseHandle } from '@cogenta/core';
+import type { Provenance } from '../types.js';
+import type { PatternKind } from './pattern-tables.js';
+/**
+ * The persistence layer of the page builder's pattern/template library
+ * (fiche 43 sub-chantier A; fiche 05 task 1).
+ *
+ * Deliberately **not** content (contract A): a pattern carries no `status`,
+ * no `version`, no trash, no `translationOf` — it is a shape an editor
+ * composes from existing blocks, not a published thing of its own. It does
+ * carry `provenance`/`provenanceDetail`, in the same two-value/detail shape
+ * contract A uses for an entry, because the same question applies just as
+ * much here: a pattern an agent generated must never read back
+ * indistinguishable from one a person built by hand (the EU AI Act
+ * disclosure obligation `docs/03-decisions.md` already tracks for content).
+ */
+export type { PatternKind } from './pattern-tables.js';
+/** Same shape contract A's `provenanceDetail` carries, kept local rather than imported: a pattern is not an entry, and this table has no dependency on `store/types.ts`. */
+export interface PatternProvenanceDetail {
+    readonly agent?: string;
+    readonly model?: string;
+    readonly at?: string;
+    readonly prompt?: string;
+}
+/** The wire shape of one block — identical to contract A's `ContentBlock`, kept local for the same reason as `PatternProvenanceDetail`. */
+export interface PatternBlock {
+    readonly key: string;
+    readonly type: string;
+    readonly data: Readonly<Record<string, unknown>>;
+}
+export interface Pattern {
+    readonly id: string;
+    readonly name: string;
+    /** An admin-only, free-form grouping label — never validated against a fixed set (unlike contract B's own vocabulary). */
+    readonly category: string | null;
+    readonly kind: PatternKind;
+    readonly blocks: readonly PatternBlock[];
+    readonly provenance: Provenance;
+    readonly provenanceDetail: PatternProvenanceDetail | null;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+export interface CreatePatternInput {
+    readonly id?: string;
+    readonly name: string;
+    readonly category?: string | null;
+    readonly kind: PatternKind;
+    readonly blocks: readonly PatternBlock[];
+    /** Defaults to `'human'` — the same default contract A's own store uses. */
+    readonly provenance?: Provenance;
+    readonly provenanceDetail?: PatternProvenanceDetail | null;
+}
+export interface UpdatePatternInput {
+    readonly name?: string;
+    /** Absent leaves it untouched; `null` clears it; a string reassigns it. */
+    readonly category?: string | null;
+}
+export interface ListPatternsOptions {
+    readonly kind?: PatternKind;
+}
+export interface PatternStoreOptions {
+    readonly db: DatabaseHandle;
+    /** Injectable so tests can pin time; nothing else should pass it. */
+    readonly now?: () => Date;
+    readonly newId?: () => string;
+}
+export interface PatternStore {
+    create(input: CreatePatternInput): Promise<Pattern>;
+    read(id: string): Promise<Pattern | null>;
+    update(id: string, input: UpdatePatternInput): Promise<Pattern>;
+    delete(id: string): Promise<boolean>;
+    list(options?: ListPatternsOptions): Promise<readonly Pattern[]>;
+}
+export declare function createPatternStore(options: PatternStoreOptions): PatternStore;
+//# sourceMappingURL=pattern-store.d.ts.map

package/dist/store/pattern-store.d.ts.map

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

package/dist/store/pattern-store.js

@@ -0,0 +1,118 @@
+import { CogentaError, identifier, sql, } from '@cogenta/core';
+import { newId as uuidv7 } from '../id.js';
+import { joinFragments } from './fragments.js';
+import { PATTERN_TABLE } from './pattern-tables.js';
+function text(value) {
+    return typeof value === 'string' ? value : String(value);
+}
+function nullableText(value) {
+    return value === null || value === undefined ? null : text(value);
+}
+function parseBlocks(raw) {
+    const parsed = typeof raw === 'string' ? JSON.parse(raw) : raw;
+    if (!Array.isArray(parsed))
+        return [];
+    return parsed;
+}
+function parseProvenanceDetail(raw) {
+    if (raw === null || raw === undefined)
+        return null;
+    const parsed = typeof raw === 'string' ? JSON.parse(raw) : raw;
+    return (parsed ?? null);
+}
+function patternNotFound(id) {
+    return new CogentaError({
+        code: 'PATTERN_UNKNOWN',
+        message: `No pattern "${id}".`,
+        hint: 'Check the identifier — list the patterns of this site to find the right one.',
+        details: { id },
+    });
+}
+export function createPatternStore(options) {
+    const { db } = options;
+    const dialect = db.dialect;
+    const now = options.now ?? (() => new Date());
+    const newId = options.newId ?? uuidv7;
+    const patterns = identifier(PATTERN_TABLE, dialect);
+    const idColumn = identifier('id', dialect);
+    const kindColumn = identifier('kind', dialect);
+    const createdAtColumn = identifier('created_at', dialect);
+    const updatedAtColumn = identifier('updated_at', dialect);
+    const stamp = () => now().toISOString();
+    function toPattern(row) {
+        return {
+            id: text(row.id),
+            name: text(row.name),
+            category: nullableText(row.category),
+            kind: text(row.kind),
+            blocks: parseBlocks(row.blocks),
+            provenance: text(row.provenance),
+            provenanceDetail: parseProvenanceDetail(row.provenance_detail),
+            createdAt: text(row.created_at),
+            updatedAt: text(row.updated_at),
+        };
+    }
+    async function rowOf(tx, id) {
+        const found = await tx.query(sql `select * from ${patterns} where ${idColumn} = ${id}`);
+        return found.rows[0] ?? null;
+    }
+    return {
+        create: async (input) => {
+            const id = input.id ?? newId();
+            const at = stamp();
+            await db.query(sql `insert into ${patterns} (${joinFragments([
+                idColumn,
+                identifier('name', dialect),
+                identifier('category', dialect),
+                kindColumn,
+                identifier('blocks', dialect),
+                identifier('provenance', dialect),
+                identifier('provenance_detail', dialect),
+                createdAtColumn,
+                updatedAtColumn,
+            ], ', ')}) values (
+          ${id}, ${input.name}, ${input.category ?? null}, ${input.kind},
+          ${JSON.stringify(input.blocks)},
+          ${input.provenance ?? 'human'},
+          ${input.provenanceDetail === undefined || input.provenanceDetail === null ? null : JSON.stringify(input.provenanceDetail)},
+          ${at}, ${at}
+        )`);
+            const row = await rowOf(db, id);
+            if (row === null)
+                throw patternNotFound(id);
+            return toPattern(row);
+        },
+        read: async (id) => {
+            const row = await rowOf(db, id);
+            return row === null ? null : toPattern(row);
+        },
+        update: async (id, input) => db.transaction(async (tx) => {
+            const row = await rowOf(tx, id);
+            if (row === null)
+                throw patternNotFound(id);
+            const assignments = [sql `${updatedAtColumn} = ${stamp()}`];
+            if (input.name !== undefined) {
+                assignments.push(sql `${identifier('name', dialect)} = ${input.name}`);
+            }
+            if (input.category !== undefined) {
+                assignments.push(sql `${identifier('category', dialect)} = ${input.category}`);
+            }
+            await tx.query(sql `update ${patterns} set ${joinFragments(assignments, ', ')} where ${idColumn} = ${id}`);
+            const after = await rowOf(tx, id);
+            if (after === null)
+                throw patternNotFound(id);
+            return toPattern(after);
+        }, { immediate: true }),
+        delete: async (id) => {
+            const removed = await db.query(sql `delete from ${patterns} where ${idColumn} = ${id}`);
+            return removed.rowsAffected > 0;
+        },
+        list: async (listOptions = {}) => {
+            const found = await db.query(listOptions.kind === undefined
+                ? sql `select * from ${patterns} order by ${createdAtColumn} desc`
+                : sql `select * from ${patterns} where ${kindColumn} = ${listOptions.kind} order by ${createdAtColumn} desc`);
+            return found.rows.map(toPattern);
+        },
+    };
+}
+//# sourceMappingURL=pattern-store.js.map

package/dist/store/pattern-store.js.map

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

package/dist/store/pattern-tables.d.ts

@@ -0,0 +1,29 @@
+import { type DatabaseHandle } from '@cogenta/core';
+/**
+ * The page builder's motif/model library (fiche 43, sub-chantier A; fiche 05
+ * task 1).
+ *
+ * A pattern is not schema-declared content — it is a reusable *shape*, an
+ * editor's own composition saved from the builder — so it gets the same
+ * one-fixed-table treatment as a menu (`menu-tables.ts`) rather than a table
+ * per collection. `blocks` stores exactly the contract-B block list the
+ * builder already sends to `POST /api/builder/render` (`key`/`type`/`data`),
+ * never HTML or CSS (R3): inserting a pattern is indistinguishable from
+ * placing the same blocks by hand.
+ *
+ * `kind` distinguishes a **motif** (a handful of blocks dropped into an
+ * existing page, added to whatever is already there) from a **modèle de page
+ * complet** (fiche 43 sub-chantier A's "second niveau" — replaces the whole
+ * block zone, and only after the admin asks for explicit confirmation; that
+ * confirmation is a UI concern, not something this table enforces). Both
+ * shapes are "a list of blocks"; nothing about the stored row differs.
+ */
+export declare const PATTERN_TABLE = "cogenta_patterns";
+export declare const PATTERN_KINDS: readonly ['pattern', 'template'];
+export type PatternKind = (typeof PATTERN_KINDS)[number];
+/** How long a pattern's `name` may be. */
+export declare const PATTERN_NAME_LENGTH = 255;
+/** How long a pattern's `category` (an admin-only, free-form grouping label) may be. */
+export declare const PATTERN_CATEGORY_LENGTH = 64;
+export declare function ensurePatternTables(db: DatabaseHandle): Promise<void>;
+//# sourceMappingURL=pattern-tables.d.ts.map

package/dist/store/pattern-tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-tables.d.ts","sourceRoot":"","sources":["../../src/store/pattern-tables.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAqC,MAAM,eAAe,CAAA;AAItF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,aAAa,qBAAqB,CAAA;AAE/C,eAAO,MAAM,aAAa,YAAI,SAAS,EAAE,UAAU,CAAU,CAAA;AAC7D,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AAExD,0CAA0C;AAC1C,eAAO,MAAM,mBAAmB,MAAM,CAAA;AACtC,wFAAwF;AACxF,eAAO,MAAM,uBAAuB,KAAK,CAAA;AAEzC,wBAAsB,mBAAmB,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB3E"}

package/dist/store/pattern-tables.js

@@ -0,0 +1,53 @@
+import { identifier, sql } from '@cogenta/core';
+import { jsonColumn, textColumn, timestampColumn, uuidColumn } from './columns.js';
+import { indexName } from './naming.js';
+/**
+ * The page builder's motif/model library (fiche 43, sub-chantier A; fiche 05
+ * task 1).
+ *
+ * A pattern is not schema-declared content — it is a reusable *shape*, an
+ * editor's own composition saved from the builder — so it gets the same
+ * one-fixed-table treatment as a menu (`menu-tables.ts`) rather than a table
+ * per collection. `blocks` stores exactly the contract-B block list the
+ * builder already sends to `POST /api/builder/render` (`key`/`type`/`data`),
+ * never HTML or CSS (R3): inserting a pattern is indistinguishable from
+ * placing the same blocks by hand.
+ *
+ * `kind` distinguishes a **motif** (a handful of blocks dropped into an
+ * existing page, added to whatever is already there) from a **modèle de page
+ * complet** (fiche 43 sub-chantier A's "second niveau" — replaces the whole
+ * block zone, and only after the admin asks for explicit confirmation; that
+ * confirmation is a UI concern, not something this table enforces). Both
+ * shapes are "a list of blocks"; nothing about the stored row differs.
+ */
+export const PATTERN_TABLE = 'cogenta_patterns';
+export const PATTERN_KINDS = ['pattern', 'template'];
+/** How long a pattern's `name` may be. */
+export const PATTERN_NAME_LENGTH = 255;
+/** How long a pattern's `category` (an admin-only, free-form grouping label) may be. */
+export const PATTERN_CATEGORY_LENGTH = 64;
+export async function ensurePatternTables(db) {
+    const dialect = db.dialect;
+    const patterns = identifier(PATTERN_TABLE, dialect);
+    await db.query(sql `create table if not exists ${patterns} (
+    ${identifier('id', dialect)} ${uuidColumn(dialect)} not null primary key,
+    ${identifier('name', dialect)} ${textColumn(dialect, PATTERN_NAME_LENGTH)} not null,
+    ${identifier('category', dialect)} ${textColumn(dialect, PATTERN_CATEGORY_LENGTH)},
+    ${identifier('kind', dialect)} ${textColumn(dialect, 16)} not null,
+    ${identifier('blocks', dialect)} ${jsonColumn()} not null,
+    ${identifier('provenance', dialect)} ${textColumn(dialect, 16)} not null,
+    ${identifier('provenance_detail', dialect)} ${jsonColumn()},
+    ${identifier('created_at', dialect)} ${timestampColumn(dialect)} not null,
+    ${identifier('updated_at', dialect)} ${timestampColumn(dialect)} not null
+  )`);
+    const indexStatements = [
+        // Listing is always "every pattern of this kind, most recent first" — the
+        // only query the picker and the library screen ever make.
+        sql `create index ${identifier(indexName(PATTERN_TABLE, 'kind_created'), dialect)}
+        on ${patterns} (${identifier('kind', dialect)}, ${identifier('created_at', dialect)})`,
+    ];
+    for (const statement of indexStatements) {
+        await db.query(statement).catch(() => undefined);
+    }
+}
+//# sourceMappingURL=pattern-tables.js.map

package/dist/store/pattern-tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-tables.js","sourceRoot":"","sources":["../../src/store/pattern-tables.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,UAAU,EAAoB,GAAG,EAAE,MAAM,eAAe,CAAA;AACtF,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAClF,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,kBAAkB,CAAA;AAE/C,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,UAAU,CAAU,CAAA;AAG7D,0CAA0C;AAC1C,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAA;AACtC,wFAAwF;AACxF,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAA;AAEzC,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,EAAkB;IAC1D,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAA;IAC1B,MAAM,QAAQ,GAAG,UAAU,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;IAEnD,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAA,8BAA8B,QAAQ;MACpD,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC;MAChD,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,mBAAmB,CAAC;MACvE,UAAU,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,uBAAuB,CAAC;MAC/E,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;MACtD,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,UAAU,EAAE;MAC7C,UAAU,CAAC,YAAY,EAAE,OAAO,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;MAC5D,UAAU,CAAC,mBAAmB,EAAE,OAAO,CAAC,IAAI,UAAU,EAAE;MACxD,UAAU,CAAC,YAAY,EAAE,OAAO,CAAC,IAAI,eAAe,CAAC,OAAO,CAAC;MAC7D,UAAU,CAAC,YAAY,EAAE,OAAO,CAAC,IAAI,eAAe,CAAC,OAAO,CAAC;IAC/D,CAAC,CAAA;IAEH,MAAM,eAAe,GAAkB;QACrC,0EAA0E;QAC1E,0DAA0D;QAC1D,GAAG,CAAA,gBAAgB,UAAU,CAAC,SAAS,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC;aACvE,QAAQ,KAAK,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,UAAU,CAAC,YAAY,EAAE,OAAO,CAAC,GAAG;KAC3F,CAAA;IACD,KAAK,MAAM,SAAS,IAAI,eAAe,EAAE,CAAC;QACxC,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IAClD,CAAC;AACH,CAAC"}

package/dist/store/read-only.d.ts

@@ -4,9 +4,9 @@ import type { ContentValues } from './types.js';
  * "Commencer par une démo en lecture seule" (L9 tâche 12, playground). Wraps
  * any `ContentStore` so every mutating method refuses instead of writing —
  * `create`/`duplicate`/`update`/`delete`/`untrash`/`purge`/`purgeExpired`/
- * `publish`/`unpublish`/`restore` — while every read (`read`/`list`/`history`/
- * `readVersion`/`diff`/`translations`/`resolveLocale`) passes straight
- * through, unchanged.
+ * `publish`/`unpublish`/`restore`/`claimForScheduledPublish` — while every
+ * read (`read`/`list`/`history`/`readVersion`/`diff`/`translations`/
+ * `resolveLocale`) passes straight through, unchanged.
  *
  * The three trash methods are refused for the reason `delete` always was, and
  * `purge` most of all: a read-only demo that let a visitor empty the trash

package/dist/store/read-only.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read-only.d.ts","sourceRoot":"","sources":["../../src/store/read-only.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,SAAS,aAAa,GAAG,aAAa,EAC7E,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,GAC3B,YAAY,CAAC,OAAO,CAAC,CA0BvB"}
+{"version":3,"file":"read-only.d.ts","sourceRoot":"","sources":["../../src/store/read-only.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,SAAS,aAAa,GAAG,aAAa,EAC7E,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,GAC3B,YAAY,CAAC,OAAO,CAAC,CA2BvB"}

package/dist/store/read-only.js

@@ -3,9 +3,9 @@ import { CogentaError } from '@cogenta/core';
  * "Commencer par une démo en lecture seule" (L9 tâche 12, playground). Wraps
  * any `ContentStore` so every mutating method refuses instead of writing —
  * `create`/`duplicate`/`update`/`delete`/`untrash`/`purge`/`purgeExpired`/
- * `publish`/`unpublish`/`restore` — while every read (`read`/`list`/`history`/
- * `readVersion`/`diff`/`translations`/`resolveLocale`) passes straight
- * through, unchanged.
+ * `publish`/`unpublish`/`restore`/`claimForScheduledPublish` — while every
+ * read (`read`/`list`/`history`/`readVersion`/`diff`/`translations`/
+ * `resolveLocale`) passes straight through, unchanged.
  *
  * The three trash methods are refused for the reason `delete` always was, and
  * `purge` most of all: a read-only demo that let a visitor empty the trash
@@ -41,6 +41,7 @@ export function withReadOnlyStore(store) {
         publish: () => refuse(),
         unpublish: () => refuse(),
         restore: () => refuse(),
+        claimForScheduledPublish: () => refuse(),
     };
 }
 //# sourceMappingURL=read-only.js.map

package/dist/store/read-only.js.map

@@ -1 +1 @@
-{"version":3,"file":"read-only.js","sourceRoot":"","sources":["../../src/store/read-only.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAI5C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAA4B;IAE5B,0EAA0E;IAC1E,wEAAwE;IACxE,wEAAwE;IACxE,8BAA8B;IAC9B,KAAK,UAAU,MAAM;QACnB,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,iEAAiE;YAC1E,IAAI,EAAE,uHAAuH;SAC9H,CAAC,CAAA;IACJ,CAAC;IAED,OAAO;QACL,GAAG,KAAK;QACR,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE;QACtB,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE;QACzB,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE;QACtB,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE;QACtB,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE;QACvB,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE;QACrB,YAAY,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE;QAC5B,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE;QACvB,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE;QACzB,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE;KACxB,CAAA;AACH,CAAC"}
+{"version":3,"file":"read-only.js","sourceRoot":"","sources":["../../src/store/read-only.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAI5C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAA4B;IAE5B,0EAA0E;IAC1E,wEAAwE;IACxE,wEAAwE;IACxE,8BAA8B;IAC9B,KAAK,UAAU,MAAM;QACnB,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,iEAAiE;YAC1E,IAAI,EAAE,uHAAuH;SAC9H,CAAC,CAAA;IACJ,CAAC;IAED,OAAO;QACL,GAAG,KAAK;QACR,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE;QACtB,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE;QACzB,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE;QACtB,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE;QACtB,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE;QACvB,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE;QACrB,YAAY,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE;QAC5B,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE;QACvB,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE;QACzB,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE;QACvB,wBAAwB,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE;KACzC,CAAA;AACH,CAAC"}

package/dist/store/redirect-tracking.d.ts

@@ -0,0 +1,50 @@
+import { type RedirectStore } from '../routing/index.js';
+import type { CollectionDefinition } from '../types.js';
+import type { ContentStore } from './store.js';
+import type { ContentValues } from './types.js';
+/**
+ * Writes the redirect a slug rename owes, by wrapping the store.
+ *
+ * `recordSlugChange` (`../routing/slug-change.ts`) has existed since before
+ * this file and is fully tested on its own — chain flattening, loop refusal,
+ * reversibility — but nothing in `store/` ever called it (fiche 12, task 3
+ * audit: "rien dans `packages/schema/src/store/` ne touche la table de
+ * redirections"). This is that missing call, made the same way
+ * `withSearchIndexing` wires the search index: by wrapping the store rather
+ * than hooking a transport, so REST, GraphQL and the theme renderer — all
+ * handed the same store instance by `serve.ts` — get it for free.
+ *
+ * **Why the published face is re-read, not the value `update`/`publish`
+ * return.** With drafts enabled, `update()` on an already-published entry only
+ * *stages* a change — contract A's own rule, reused rather than
+ * reimplemented: the live row does not move until `publish()`. The value
+ * `update()` returns is always the *working* face (`state: 'working'`), which
+ * would carry the new slug immediately and fire a redirect for a URL that is
+ * not public yet. Reading `state: 'published'` before and after the call,
+ * exactly as `search-indexing.ts`'s `reindex` already does for the same
+ * reason, makes "was this ever actually served" a fact the store answers
+ * rather than something this wrapper has to guess at.
+ */
+export interface RedirectTrackingOptions {
+    readonly collection: CollectionDefinition;
+    readonly redirects: RedirectStore;
+    /**
+     * Called when recording the redirect fails. Defaults to swallowing it.
+     *
+     * A failed redirect write must never fail the content save that triggered
+     * it — a slow or locked redirects table is not a reason to lose an editor's
+     * rename. Callers with a logger pass one so the failure stays visible.
+     */
+    readonly onError?: (error: unknown) => void;
+}
+/**
+ * Wraps a `ContentStore` so that renaming the slug of a **published** entry
+ * writes a 301 from the old path to the new one, with no caller having to
+ * remember to.
+ *
+ * A collection with no `f.slug(...)` field is returned unwrapped — there is
+ * nothing this decorator could ever do for it, and wrapping it anyway would
+ * only cost two extra reads per write for nothing.
+ */
+export declare function withRedirectTracking<TValues extends ContentValues = ContentValues>(store: ContentStore<TValues>, options: RedirectTrackingOptions): ContentStore<TValues>;
+//# sourceMappingURL=redirect-tracking.d.ts.map

package/dist/store/redirect-tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirect-tracking.d.ts","sourceRoot":"","sources":["../../src/store/redirect-tracking.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAoB,MAAM,qBAAqB,CAAA;AAC1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAA;IACzC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAA;IACjC;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CAC5C;AA2DD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,SAAS,aAAa,GAAG,aAAa,EAChF,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,EAC5B,OAAO,EAAE,uBAAuB,GAC/B,YAAY,CAAC,OAAO,CAAC,CA+BvB"}

package/dist/store/redirect-tracking.js

@@ -0,0 +1,91 @@
+import { recordSlugChange } from '../routing/index.js';
+/** The name of the collection's `f.slug(...)` field, or null when it has none. */
+function slugFieldOf(collection) {
+    const found = Object.entries(collection.fields).find(([, field]) => field.kind === 'slug');
+    return found === undefined ? null : found[0];
+}
+/** The `:name` segments of a route pattern, in order. */
+function routeParamNames(pattern) {
+    return pattern
+        .split('/')
+        .filter((segment) => segment.startsWith(':'))
+        .map((segment) => segment.slice(1));
+}
+async function trackRename(store, options, slugField, id, before) {
+    if (before === null)
+        return;
+    try {
+        const after = await store.read(id, { state: 'published' });
+        if (after === null)
+            return;
+        const previousSlug = before.values[slugField];
+        const nextSlug = after.values[slugField];
+        if (typeof previousSlug !== 'string' || typeof nextSlug !== 'string')
+            return;
+        if (previousSlug === nextSlug)
+            return;
+        const pattern = options.collection.routing?.pattern;
+        const otherParams = {};
+        if (pattern !== undefined) {
+            for (const name of routeParamNames(pattern)) {
+                if (name === slugField)
+                    continue;
+                const value = after.values[name];
+                if (typeof value === 'string')
+                    otherParams[name] = value;
+            }
+        }
+        await recordSlugChange(options.redirects, {
+            collection: options.collection,
+            entryId: id,
+            status: 'published',
+            previousSlug,
+            nextSlug,
+            slugParam: slugField,
+            locale: after.locale,
+            ...(Object.keys(otherParams).length === 0 ? {} : { params: otherParams }),
+        });
+    }
+    catch (error) {
+        options.onError?.(error);
+    }
+}
+/**
+ * Wraps a `ContentStore` so that renaming the slug of a **published** entry
+ * writes a 301 from the old path to the new one, with no caller having to
+ * remember to.
+ *
+ * A collection with no `f.slug(...)` field is returned unwrapped — there is
+ * nothing this decorator could ever do for it, and wrapping it anyway would
+ * only cost two extra reads per write for nothing.
+ */
+export function withRedirectTracking(store, options) {
+    const slugField = slugFieldOf(options.collection);
+    if (slugField === null)
+        return store;
+    async function before(id) {
+        return store.read(id, { state: 'published' });
+    }
+    return {
+        ...store,
+        update: async (id, input) => {
+            const previous = await before(id);
+            const result = await store.update(id, input);
+            await trackRename(store, options, slugField, id, previous);
+            return result;
+        },
+        publish: async (id, input) => {
+            const previous = await before(id);
+            const result = await store.publish(id, input);
+            await trackRename(store, options, slugField, id, previous);
+            return result;
+        },
+        restore: async (id, version, input) => {
+            const previous = await before(id);
+            const result = await store.restore(id, version, input);
+            await trackRename(store, options, slugField, id, previous);
+            return result;
+        },
+    };
+}
+//# sourceMappingURL=redirect-tracking.js.map

package/dist/store/redirect-tracking.js.map

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

package/dist/store/review-transitions.d.ts

@@ -0,0 +1,34 @@
+import type { ContentAction, ReviewState, ReviewTransition } from '../types.js';
+/**
+ * The editorial workflow's transition table (`schema@2.1`, ADR-0027).
+ *
+ * A closed set of three transitions, each with the `from` states it accepts,
+ * the `to` state it produces, and the contract A action a caller needs to
+ * make it — the same shape the contract E order state machine already
+ * proved out. It lives on the server and nowhere else: an admin screen reads
+ * it to grey out a button, it never re-derives what is legal.
+ *
+ * `approve` does **not** produce `status: 'published'`. Approving and
+ * publishing stay two different actions, guarded by two different
+ * permissions (`publish` either way) — conflating them would publish by
+ * surprise the moment an editor clicks "Approve".
+ */
+export interface ReviewTransitionRule {
+    readonly from: readonly ReviewState[];
+    readonly to: ReviewState;
+    /** The contract A action a caller needs, checked by the caller — never by this table. */
+    readonly action: ContentAction;
+}
+export declare const REVIEW_TRANSITION_TABLE: Readonly<Record<ReviewTransition, ReviewTransitionRule>>;
+/**
+ * Checks a transition against the table, throwing `CONTENT_REVIEW_TRANSITION_INVALID`
+ * for an illegal jump. Returns the state the entry should move to.
+ *
+ * Permission is not this function's business: the caller already asserted
+ * `REVIEW_TRANSITION_TABLE[transition].action` before reaching here.
+ */
+export declare function nextReviewState(transition: ReviewTransition, current: ReviewState, context: {
+    readonly collection: string;
+    readonly id: string;
+}): ReviewState;
+//# sourceMappingURL=review-transitions.d.ts.map

package/dist/store/review-transitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-transitions.d.ts","sourceRoot":"","sources":["../../src/store/review-transitions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE/E;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,CAAA;IACrC,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAA;IACxB,yFAAyF;IACzF,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;CAC/B;AAED,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,gBAAgB,EAAE,oBAAoB,CAAC,CAS5F,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,gBAAgB,EAC5B,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC5D,WAAW,CAWb"}

package/dist/store/review-transitions.js

@@ -0,0 +1,51 @@
+import { CogentaError } from '@cogenta/core';
+export const REVIEW_TRANSITION_TABLE = {
+    // A contributor sends a fresh draft — or one sent back for changes — into
+    // the queue. Re-submitting after `changes-requested` is expected, not an
+    // error: that is the whole point of asking for changes.
+    submit: { from: ['none', 'changes-requested'], to: 'pending', action: 'update' },
+    // Only a pending entry can be approved or sent back — an entry nobody
+    // submitted has nothing for a reviewer to have looked at yet.
+    approve: { from: ['pending'], to: 'approved', action: 'publish' },
+    requestChanges: { from: ['pending'], to: 'changes-requested', action: 'publish' },
+};
+/**
+ * Checks a transition against the table, throwing `CONTENT_REVIEW_TRANSITION_INVALID`
+ * for an illegal jump. Returns the state the entry should move to.
+ *
+ * Permission is not this function's business: the caller already asserted
+ * `REVIEW_TRANSITION_TABLE[transition].action` before reaching here.
+ */
+export function nextReviewState(transition, current, context) {
+    const rule = REVIEW_TRANSITION_TABLE[transition];
+    if (!rule.from.includes(current)) {
+        throw new CogentaError({
+            code: 'CONTENT_REVIEW_TRANSITION_INVALID',
+            message: `"${context.id}" of "${context.collection}" cannot ${transitionVerb(transition)}: its review state is "${current}", not ${rule.from.map((state) => `"${state}"`).join(' or ')}.`,
+            hint: transitionHint(transition, current),
+            details: { collection: context.collection, id: context.id, transition, from: current },
+        });
+    }
+    return rule.to;
+}
+function transitionVerb(transition) {
+    switch (transition) {
+        case 'submit':
+            return 'be submitted for review';
+        case 'approve':
+            return 'be approved';
+        case 'requestChanges':
+            return 'have changes requested';
+    }
+}
+function transitionHint(transition, current) {
+    if (transition === 'submit') {
+        return current === 'pending'
+            ? 'It is already waiting for a reviewer.'
+            : 'Only a fresh entry or one sent back with requested changes can be submitted.';
+    }
+    return current === 'none'
+        ? 'Nobody submitted this entry yet — ask its author to submit it first.'
+        : 'Only an entry waiting for review (pending) can be approved or sent back.';
+}
+//# sourceMappingURL=review-transitions.js.map

package/dist/store/review-transitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-transitions.js","sourceRoot":"","sources":["../../src/store/review-transitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAwB5C,MAAM,CAAC,MAAM,uBAAuB,GAA6D;IAC/F,0EAA0E;IAC1E,yEAAyE;IACzE,wDAAwD;IACxD,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE;IAChF,sEAAsE;IACtE,8DAA8D;IAC9D,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE;IACjE,cAAc,EAAE,EAAE,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,mBAAmB,EAAE,MAAM,EAAE,SAAS,EAAE;CAClF,CAAA;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,UAA4B,EAC5B,OAAoB,EACpB,OAA6D;IAE7D,MAAM,IAAI,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAA;IAChD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,mCAAmC;YACzC,OAAO,EAAE,IAAI,OAAO,CAAC,EAAE,SAAS,OAAO,CAAC,UAAU,YAAY,cAAc,CAAC,UAAU,CAAC,0BAA0B,OAAO,UAAU,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG;YACzL,IAAI,EAAE,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC;YACzC,OAAO,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE;SACvF,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,IAAI,CAAC,EAAE,CAAA;AAChB,CAAC;AAED,SAAS,cAAc,CAAC,UAA4B;IAClD,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO,yBAAyB,CAAA;QAClC,KAAK,SAAS;YACZ,OAAO,aAAa,CAAA;QACtB,KAAK,gBAAgB;YACnB,OAAO,wBAAwB,CAAA;IACnC,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,UAA4B,EAAE,OAAoB;IACxE,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,OAAO,KAAK,SAAS;YAC1B,CAAC,CAAC,uCAAuC;YACzC,CAAC,CAAC,8EAA8E,CAAA;IACpF,CAAC;IACD,OAAO,OAAO,KAAK,MAAM;QACvB,CAAC,CAAC,sEAAsE;QACxE,CAAC,CAAC,0EAA0E,CAAA;AAChF,CAAC"}

package/dist/store/role-permission-export.d.ts

@@ -0,0 +1,22 @@
+import { type ContentAction } from '../types.js';
+import type { RolePermissionOverrideRecord, RolePermissionTargetType } from './role-permission-store.js';
+export declare const ROLE_PERMISSION_EXPORT_VERSION = 1;
+export interface RolePermissionExportRow {
+    readonly targetType: RolePermissionTargetType;
+    readonly targetName: string;
+    readonly action: ContentAction;
+    readonly roles: readonly string[];
+    readonly own: boolean;
+    readonly updatedAt: string;
+    readonly updatedBy: string | null;
+}
+export interface RolePermissionExportFile {
+    readonly version: typeof ROLE_PERMISSION_EXPORT_VERSION;
+    readonly exportedAt: string;
+    readonly overrides: readonly RolePermissionExportRow[];
+}
+/** Sorted for a clean, stable git diff between two exports — never insertion order. */
+export declare function serialiseRolePermissionExport(records: readonly RolePermissionOverrideRecord[], now?: () => Date): RolePermissionExportFile;
+/** The round trip's other half: `JSON.parse` a file `serialiseRolePermissionExport` wrote, checked shape by shape. */
+export declare function parseRolePermissionExport(value: unknown): RolePermissionExportFile;
+//# sourceMappingURL=role-permission-export.d.ts.map

package/dist/store/role-permission-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-permission-export.d.ts","sourceRoot":"","sources":["../../src/store/role-permission-export.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AACjE,OAAO,KAAK,EACV,4BAA4B,EAC5B,wBAAwB,EACzB,MAAM,4BAA4B,CAAA;AAmBnC,eAAO,MAAM,8BAA8B,IAAI,CAAA;AAE/C,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,wBAAwB,CAAA;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAClC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,8BAA8B,CAAA;IACvD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,uBAAuB,EAAE,CAAA;CACvD;AAMD,uFAAuF;AACvF,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,SAAS,4BAA4B,EAAE,EAChD,GAAG,GAAE,MAAM,IAAuB,GACjC,wBAAwB,CAG1B;AAyDD,sHAAsH;AACtH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB,CAqBlF"}