@cogenta/schema 0.1.0

package/dist/store/naming.d.ts

@@ -0,0 +1,25 @@
+/** `publishedAt` becomes `published_at`. Digits stay attached to what precedes them. */
+export declare function toSnakeCase(name: string): string;
+export declare function entriesTable(collection: string): string;
+/**
+ * One row per block, never a JSON array in the content row (contract A).
+ *
+ * Three features depend on blocks being rows: answering "which pages use this
+ * medium" for the media library, invalidating cache tags on publication, and
+ * chunking content per block for RAG. None of them survive a JSON column.
+ */
+export declare function blocksTable(collection: string): string;
+export declare function versionsTable(collection: string): string;
+/** The join table of a `many: true` relation. */
+export declare function relationTable(collection: string, field: string): string;
+export declare function indexName(table: string, suffix: string): string;
+export declare function columnFor(field: string): string;
+/**
+ * Columns the engine owns. A user field that lands on one of these is refused
+ * rather than silently shadowed — `updated_at` written by an editor would break
+ * every ordering and every cache decision in the product.
+ */
+export declare const SYSTEM_COLUMNS: readonly ['id', 'created_at', 'updated_at', 'created_by', 'updated_by', 'status', 'locale', 'translation_of', 'version', 'provenance', 'provenance_detail'];
+export type SystemColumn = (typeof SYSTEM_COLUMNS)[number];
+export declare function isSystemColumn(column: string): column is SystemColumn;
+//# sourceMappingURL=naming.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../../src/store/naming.ts"],"names":[],"mappings":"AAiCA,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,iDAAiD;AACjD,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,YACzB,IAAI,EACJ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,mBAAmB,CACX,CAAA;AAEV,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AAE1D,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,YAAY,CAErE"}

package/dist/store/naming.js

@@ -0,0 +1,80 @@
+import { CogentaError } from '@cogenta/core';
+/**
+ * Physical names, derived from the schema in exactly one place.
+ *
+ * The rule is that nothing outside this file ever builds a table or column name
+ * by concatenation: the migration generator, the store and the tests must agree
+ * on the same string, and a second spelling of it is a silent data loss waiting
+ * for the day someone renames a collection.
+ */
+const PREFIX = 'cogenta_';
+/**
+ * MySQL refuses an identifier longer than 64 characters, and truncating one
+ * would make two collections collide on the same table. Failing at schema load
+ * with a name in the message costs a rename; failing at migration time on the
+ * one dialect nobody develops against costs a day.
+ */
+const MAX_IDENTIFIER_LENGTH = 64;
+function checked(name) {
+    if (name.length > MAX_IDENTIFIER_LENGTH) {
+        throw new CogentaError({
+            code: 'CONFIG_INVALID',
+            message: `The generated SQL identifier "${name}" is ${name.length} characters long.`,
+            hint: `MySQL allows at most ${MAX_IDENTIFIER_LENGTH}. Shorten the collection or field name.`,
+            details: { name },
+        });
+    }
+    return name;
+}
+/** `publishedAt` becomes `published_at`. Digits stay attached to what precedes them. */
+export function toSnakeCase(name) {
+    return name.replace(/([a-z0-9])([A-Z])/g, '$1_$2').toLowerCase();
+}
+export function entriesTable(collection) {
+    return checked(`${PREFIX}${toSnakeCase(collection)}`);
+}
+/**
+ * One row per block, never a JSON array in the content row (contract A).
+ *
+ * Three features depend on blocks being rows: answering "which pages use this
+ * medium" for the media library, invalidating cache tags on publication, and
+ * chunking content per block for RAG. None of them survive a JSON column.
+ */
+export function blocksTable(collection) {
+    return checked(`${entriesTable(collection)}_blocks`);
+}
+export function versionsTable(collection) {
+    return checked(`${entriesTable(collection)}_versions`);
+}
+/** The join table of a `many: true` relation. */
+export function relationTable(collection, field) {
+    return checked(`${entriesTable(collection)}_${toSnakeCase(field)}`);
+}
+export function indexName(table, suffix) {
+    return checked(`${table}_${suffix}`);
+}
+export function columnFor(field) {
+    return checked(toSnakeCase(field));
+}
+/**
+ * Columns the engine owns. A user field that lands on one of these is refused
+ * rather than silently shadowed — `updated_at` written by an editor would break
+ * every ordering and every cache decision in the product.
+ */
+export const SYSTEM_COLUMNS = [
+    'id',
+    'created_at',
+    'updated_at',
+    'created_by',
+    'updated_by',
+    'status',
+    'locale',
+    'translation_of',
+    'version',
+    'provenance',
+    'provenance_detail',
+];
+export function isSystemColumn(column) {
+    return SYSTEM_COLUMNS.includes(column);
+}
+//# sourceMappingURL=naming.js.map

package/dist/store/naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.js","sourceRoot":"","sources":["../../src/store/naming.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAE5C;;;;;;;GAOG;AAEH,MAAM,MAAM,GAAG,UAAU,CAAA;AAEzB;;;;;GAKG;AACH,MAAM,qBAAqB,GAAG,EAAE,CAAA;AAEhC,SAAS,OAAO,CAAC,IAAY;IAC3B,IAAI,IAAI,CAAC,MAAM,GAAG,qBAAqB,EAAE,CAAC;QACxC,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,iCAAiC,IAAI,QAAQ,IAAI,CAAC,MAAM,mBAAmB;YACpF,IAAI,EAAE,wBAAwB,qBAAqB,yCAAyC;YAC5F,OAAO,EAAE,EAAE,IAAI,EAAE;SAClB,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,CAAA;AAClE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,UAAkB;IAC7C,OAAO,OAAO,CAAC,GAAG,MAAM,GAAG,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;AACvD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,UAAkB;IAC5C,OAAO,OAAO,CAAC,GAAG,YAAY,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;AACtD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,UAAkB;IAC9C,OAAO,OAAO,CAAC,GAAG,YAAY,CAAC,UAAU,CAAC,WAAW,CAAC,CAAA;AACxD,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,aAAa,CAAC,UAAkB,EAAE,KAAa;IAC7D,OAAO,OAAO,CAAC,GAAG,YAAY,CAAC,UAAU,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;AACrE,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,MAAc;IACrD,OAAO,OAAO,CAAC,GAAG,KAAK,IAAI,MAAM,EAAE,CAAC,CAAA;AACtC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAA;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI;IACJ,YAAY;IACZ,YAAY;IACZ,YAAY;IACZ,YAAY;IACZ,QAAQ;IACR,QAAQ;IACR,gBAAgB;IAChB,SAAS;IACT,YAAY;IACZ,mBAAmB;CACX,CAAA;AAIV,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAQ,cAAoC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;AAC/D,CAAC"}

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

@@ -0,0 +1,16 @@
+import type { ContentStore } from './store.js';
+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`/`update`/`delete`/`publish`/`unpublish`/`restore` — while every
+ * read (`read`/`list`/`history`/`readVersion`/`diff`/`translations`/
+ * `resolveLocale`) passes straight through, unchanged.
+ *
+ * A single wrap at the store level protects every consumer built on top of
+ * it — REST's `ContentService` and GraphQL's gateway both construct their
+ * stores from the same `storeFor` closure in `serve.ts`, so wrapping there
+ * covers both transports with one guard, not two.
+ */
+export declare function withReadOnlyStore<TValues extends ContentValues = ContentValues>(store: ContentStore<TValues>): ContentStore<TValues>;
+//# sourceMappingURL=read-only.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,SAAS,aAAa,GAAG,aAAa,EAC7E,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,GAC3B,YAAY,CAAC,OAAO,CAAC,CAsBvB"}

package/dist/store/read-only.js

@@ -0,0 +1,36 @@
+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`/`update`/`delete`/`publish`/`unpublish`/`restore` — while every
+ * read (`read`/`list`/`history`/`readVersion`/`diff`/`translations`/
+ * `resolveLocale`) passes straight through, unchanged.
+ *
+ * A single wrap at the store level protects every consumer built on top of
+ * it — REST's `ContentService` and GraphQL's gateway both construct their
+ * stores from the same `storeFor` closure in `serve.ts`, so wrapping there
+ * covers both transports with one guard, not two.
+ */
+export function withReadOnlyStore(store) {
+    // `async` so a synchronous refusal still surfaces as a rejected promise —
+    // every `ContentStore` method is `Promise`-returning, and a caller that
+    // awaits it (every real caller does) must see a rejection, not a thrown
+    // exception at the call site.
+    async function refuse() {
+        throw new CogentaError({
+            code: 'CONTENT_READ_ONLY',
+            message: 'This instance is read-only; the requested change was not saved.',
+            hint: 'This is a read-only demo instance (e.g. a playground). Reads work normally; writes are refused, not silently dropped.',
+        });
+    }
+    return {
+        ...store,
+        create: () => refuse(),
+        update: () => refuse(),
+        delete: () => refuse(),
+        publish: () => refuse(),
+        unpublish: () => refuse(),
+        restore: () => refuse(),
+    };
+}
+//# sourceMappingURL=read-only.js.map

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

@@ -0,0 +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;;;;;;;;;;;GAWG;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,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE;QACtB,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE;QACtB,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"}

package/dist/store/store.d.ts

@@ -0,0 +1,52 @@
+import { type DatabaseHandle } from '@cogenta/core';
+import type { CollectionDefinition } from '../types.js';
+import { type ContentDiff } from './diff.js';
+import type { ContentEntry, ContentValues, CreateInput, EntryState, ListOptions, LocaleResolution, Page, ResolveLocaleOptions, UpdateInput, VersionSummary } from './types.js';
+/**
+ * The persistence layer of a collection.
+ *
+ * Three ideas hold it together, and everything else follows from them:
+ *
+ * 1. **The entry table holds the live state** — what the public renderer reads.
+ *    A draft of an already-published entry is a row in the versions table, not a
+ *    mutation of the live row. That is what makes "the public role can never
+ *    reach a draft" a property of the storage rather than of a filter someone
+ *    has to remember to write.
+ * 2. **Blocks are rows, keyed by `(entry, version, zone, key)`** (contract A).
+ *    The live blocks are those at the entry's own version, so publishing a draft
+ *    is a version number moving, not a block rewrite.
+ * 3. **One row per locale** (ADR-0014), so `status`, `version` and publication
+ *    are per language by construction, not by convention.
+ */
+export interface ContentStoreOptions {
+    readonly db: DatabaseHandle;
+    readonly collection: CollectionDefinition;
+    /** The locale an entry gets when the caller does not say. */
+    readonly defaultLocale?: string;
+    /** Injectable so tests can pin time; nothing else should pass it. */
+    readonly now?: () => Date;
+    readonly newId?: () => string;
+}
+export interface ContentStore<TValues extends ContentValues = ContentValues> {
+    create(input: CreateInput<TValues>): Promise<ContentEntry<TValues>>;
+    read(id: string, options?: {
+        readonly state?: EntryState;
+    }): Promise<ContentEntry<TValues> | null>;
+    update(id: string, input: UpdateInput<TValues>): Promise<ContentEntry<TValues>>;
+    delete(id: string): Promise<boolean>;
+    list(options?: ListOptions): Promise<Page<ContentEntry<TValues>>>;
+    publish(id: string, input?: {
+        readonly publishedBy?: string | null;
+    }): Promise<ContentEntry<TValues>>;
+    unpublish(id: string, input?: {
+        readonly status?: 'draft' | 'archived';
+    }): Promise<ContentEntry<TValues>>;
+    history(id: string): Promise<readonly VersionSummary[]>;
+    readVersion(id: string, version: number): Promise<ContentEntry<TValues> | null>;
+    restore(id: string, version: number, input?: UpdateInput<TValues>): Promise<ContentEntry<TValues>>;
+    diff(id: string, from: number, to: number): Promise<ContentDiff>;
+    translations(id: string): Promise<readonly ContentEntry<TValues>[]>;
+    resolveLocale(id: string, locale: string, options: ResolveLocaleOptions): Promise<LocaleResolution<TValues>>;
+}
+export declare function createContentStore<TValues extends ContentValues = ContentValues>(options: ContentStoreOptions): ContentStore<TValues>;
+//# sourceMappingURL=store.d.ts.map

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

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