@cogenta/schema 0.1.0

package/dist/store/values.d.ts

@@ -0,0 +1,40 @@
+import type { CollectionDefinition, FieldDefinition } from '../types.js';
+import type { BlockZones, ContentBlock, ContentValues } from './types.js';
+export declare function encodeFieldValue(field: string, definition: FieldDefinition, value: unknown): unknown;
+export declare function decodeFieldValue(definition: FieldDefinition, raw: unknown): unknown;
+export interface NormalisedValues {
+    /** Column-backed fields, already encoded for the driver. */
+    readonly columns: Record<string, unknown>;
+    /** To-many relations: field name to the ordered list of target ids. */
+    readonly relations: Record<string, readonly string[]>;
+    /** The decoded values, as the caller will read them back. */
+    readonly values: Record<string, unknown>;
+}
+export interface NormaliseOptions {
+    /** A partial update only looks at the keys it was given. */
+    readonly partial: boolean;
+    /**
+     * Whether a missing `required` field is an error.
+     *
+     * False while writing a draft — a piece being written is incomplete by
+     * definition, and refusing to save it loses work. True at publication, which
+     * is the moment the rule actually means something.
+     */
+    readonly enforceRequired: boolean;
+}
+/**
+ * Validates an input against the collection and splits it into what goes where.
+ *
+ * `required` is checked here rather than by the column, so that a draft can be
+ * saved half-written and only publication has to be complete.
+ */
+export declare function normaliseValues(collection: CollectionDefinition, input: ContentValues, options: NormaliseOptions): NormalisedValues;
+/**
+ * Checks a block zone and gives every block a `_key`.
+ *
+ * A key supplied by the caller is kept, always: it is what ties a block to its
+ * previous self across a diff, a comment and a RAG chunk. One is only minted for
+ * a block that has never been stored.
+ */
+export declare function normaliseBlocks(collection: CollectionDefinition, zones: BlockZones, newKey?: () => string): Record<string, readonly ContentBlock[]>;
+//# sourceMappingURL=values.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../src/store/values.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAiBzE,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,eAAe,EAC3B,KAAK,EAAE,OAAO,GACb,OAAO,CAsCT;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,eAAe,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAmBnF;AAED,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAA;IACrD,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACzC;AAED,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB;;;;;;OAMG;IACH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAClC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,oBAAoB,EAChC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,gBAAgB,GACxB,gBAAgB,CAiFlB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,oBAAoB,EAChC,KAAK,EAAE,UAAU,EACjB,MAAM,GAAE,MAAM,MAAe,GAC5B,MAAM,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC,CAsCzC"}

package/dist/store/values.js

@@ -0,0 +1,160 @@
+import { CogentaError } from '@cogenta/core';
+import { newId as uuidv7 } from '../id.js';
+/**
+ * Turning declared values into column values and back.
+ *
+ * The whole point is that a caller never learns which database it is talking
+ * to: a `richText` document goes in as an array and comes back as an array on
+ * all four servers, even though one of them stores it as text it would happily
+ * have parsed for us and another would not.
+ */
+const JSON_KINDS = new Set(['richText', 'json', 'geo']);
+function invalid(message, hint, details) {
+    return new CogentaError({ code: 'CONTENT_INVALID', message, hint, details });
+}
+export function encodeFieldValue(field, definition, value) {
+    if (value === undefined || value === null)
+        return null;
+    if (JSON_KINDS.has(definition.kind))
+        return JSON.stringify(value);
+    if (definition.kind === 'boolean')
+        return Boolean(value);
+    if (definition.kind === 'number') {
+        if (typeof value !== 'number' || !Number.isFinite(value)) {
+            throw invalid(`"${field}" expects a number.`, 'Pass a finite number, or null to clear the field.', { field, received: typeof value });
+        }
+        return value;
+    }
+    if (definition.kind === 'date' || definition.kind === 'datetime') {
+        // Stored as an ISO-8601 string in UTC on every dialect: see `columns.ts`.
+        const date = value instanceof Date ? value : new Date(String(value));
+        if (Number.isNaN(date.getTime())) {
+            throw invalid(`"${field}" is not a usable date.`, 'Pass a Date or an ISO-8601 string.', {
+                field,
+            });
+        }
+        return definition.kind === 'date' ? date.toISOString().slice(0, 10) : date.toISOString();
+    }
+    if (typeof value !== 'string') {
+        throw invalid(`"${field}" expects a string, not ${typeof value}.`, 'Text, slug, select, colour, media and to-one relation fields hold a string.', { field, kind: definition.kind });
+    }
+    return value;
+}
+export function decodeFieldValue(definition, raw) {
+    if (raw === undefined || raw === null)
+        return null;
+    if (JSON_KINDS.has(definition.kind)) {
+        if (typeof raw !== 'string')
+            return raw;
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            // Never throw while reading: a document stored by an older version, or by
+            // hand, must still be recoverable through the admin.
+            return null;
+        }
+    }
+    // MySQL returns 0/1, Postgres a real boolean, SQLite an integer.
+    if (definition.kind === 'boolean')
+        return Boolean(Number(raw));
+    if (definition.kind === 'number')
+        return Number(raw);
+    return typeof raw === 'string' ? raw : String(raw);
+}
+/**
+ * Validates an input against the collection and splits it into what goes where.
+ *
+ * `required` is checked here rather than by the column, so that a draft can be
+ * saved half-written and only publication has to be complete.
+ */
+export function normaliseValues(collection, input, options) {
+    const columns = {};
+    const relations = {};
+    const values = {};
+    for (const key of Object.keys(input)) {
+        if (collection.fields[key] === undefined) {
+            throw invalid(`"${key}" is not a field of the "${collection.name}" collection.`, 'Check the field name against the schema, or add it and generate a migration.', { collection: collection.name, field: key });
+        }
+    }
+    for (const [name, definition] of Object.entries(collection.fields)) {
+        if (definition.kind === 'blocks')
+            continue;
+        const provided = Object.hasOwn(input, name);
+        if (!provided && options.partial)
+            continue;
+        const raw = provided ? input[name] : definition.default;
+        const many = definition.kind === 'relation' && definition.options['many'] === true;
+        if (raw === undefined || raw === null) {
+            if (definition.required === true && options.enforceRequired) {
+                throw invalid(`"${name}" is required on "${collection.name}".`, 'Give the field a value, or make it optional in the schema.', { collection: collection.name, field: name });
+            }
+            if (many) {
+                relations[name] = [];
+                values[name] = [];
+            }
+            else {
+                columns[name] = null;
+                values[name] = null;
+            }
+            continue;
+        }
+        if (definition.validate !== undefined) {
+            const verdict = definition.validate(raw);
+            if (verdict !== true) {
+                throw invalid(`"${name}" is not valid: ${verdict}`, 'Correct the value and try again.', {
+                    collection: collection.name,
+                    field: name,
+                });
+            }
+        }
+        if (many) {
+            if (!Array.isArray(raw)) {
+                throw invalid(`"${name}" is a to-many relation, so it expects an array of ids.`, 'Pass the ids of the related entries, in the order they should appear.', { collection: collection.name, field: name });
+            }
+            const ids = raw.map((item) => {
+                if (typeof item !== 'string') {
+                    throw invalid(`"${name}" expects entry ids, and one of them is not a string.`, 'A relation holds identifiers, never whole entries.', { collection: collection.name, field: name });
+                }
+                return item;
+            });
+            // Duplicates would break the join table's primary key, and mean nothing.
+            relations[name] = [...new Set(ids)];
+            values[name] = relations[name];
+            continue;
+        }
+        columns[name] = encodeFieldValue(name, definition, raw);
+        values[name] = decodeFieldValue(definition, columns[name]);
+    }
+    return { columns, relations, values };
+}
+/**
+ * Checks a block zone and gives every block a `_key`.
+ *
+ * A key supplied by the caller is kept, always: it is what ties a block to its
+ * previous self across a diff, a comment and a RAG chunk. One is only minted for
+ * a block that has never been stored.
+ */
+export function normaliseBlocks(collection, zones, newKey = uuidv7) {
+    const normalised = {};
+    for (const [zone, blocks] of Object.entries(zones)) {
+        const definition = collection.fields[zone];
+        if (definition === undefined || definition.kind !== 'blocks') {
+            throw invalid(`"${zone}" is not a block zone of "${collection.name}".`, 'A block zone is a field declared with f.blocks().', { collection: collection.name, field: zone });
+        }
+        const seen = new Set();
+        normalised[zone] = blocks.map((block) => {
+            if (typeof block.type !== 'string' || block.type.length === 0) {
+                throw invalid(`A block in "${zone}" has no type.`, 'Every block declares which block of the vocabulary it is.', { collection: collection.name, field: zone });
+            }
+            const key = block.key !== undefined && block.key !== '' ? block.key : newKey();
+            if (seen.has(key)) {
+                throw invalid(`Two blocks in "${zone}" share the key "${key}".`, 'A block key is unique inside its zone: it is how a block is followed across versions.', { collection: collection.name, field: zone, key });
+            }
+            seen.add(key);
+            return { key, type: block.type, data: block.data ?? {} };
+        });
+    }
+    return normalised;
+}
+//# sourceMappingURL=values.js.map

package/dist/store/values.js.map

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

package/dist/system-fields.d.ts

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+/**
+ * Contract A § "Champs système". Present on every entry of every collection,
+ * never declared by the author, never optional.
+ *
+ * `provenance` least of all: the European AI framework requires knowing whether
+ * a piece of content was written, assisted or generated, so it exists from the
+ * first migration rather than being retrofitted once there is content.
+ *
+ * These are not `FieldDefinition`s. They are not authored, not translated, not
+ * validated against user options — describing them as ordinary fields would let
+ * a collection redeclare one, which is exactly what `defineCollection` refuses.
+ */
+export declare const SYSTEM_FIELD_NAMES: readonly ['id', 'createdAt', 'updatedAt', 'createdBy', 'updatedBy', 'status', 'locale', 'translationOf', 'version', 'provenance', 'provenanceDetail'];
+export type SystemFieldName = (typeof SYSTEM_FIELD_NAMES)[number];
+export declare function isSystemFieldName(name: string): name is SystemFieldName;
+export declare const provenanceDetailSchema: z.ZodObject<{
+    agent: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    at: z.ZodOptional<z.ZodISODateTime>;
+    prompt: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const systemFieldsSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodISODateTime;
+    updatedAt: z.ZodISODateTime;
+    createdBy: z.ZodNullable<z.ZodString>;
+    updatedBy: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<{
+        archived: "archived";
+        draft: "draft";
+        published: "published";
+        scheduled: "scheduled";
+    }>;
+    locale: z.ZodString;
+    translationOf: z.ZodNullable<z.ZodString>;
+    version: z.ZodNumber;
+    provenance: z.ZodEnum<{
+        assisted: "assisted";
+        generated: "generated";
+        human: "human";
+    }>;
+    provenanceDetail: z.ZodNullable<z.ZodObject<{
+        agent: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+        at: z.ZodOptional<z.ZodISODateTime>;
+        prompt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strip>;
+/** How the admin renders a system column. Mirrors `systemFieldsSchema`. */
+export interface SystemFieldDescriptor {
+    readonly name: SystemFieldName;
+    readonly type: 'id' | 'datetime' | 'enum' | 'string' | 'number' | 'json';
+    readonly nullable: boolean;
+    /** Never writable by an editor: the runtime owns every one of these. */
+    readonly readOnly: true;
+    readonly values?: readonly string[];
+}
+export declare const SYSTEM_FIELD_DESCRIPTORS: readonly SystemFieldDescriptor[];
+//# sourceMappingURL=system-fields.d.ts.map

package/dist/system-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-fields.d.ts","sourceRoot":"","sources":["../src/system-fields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,kBAAkB,YAC7B,IAAI,EACJ,WAAW,EACX,WAAW,EACX,WAAW,EACX,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,eAAe,EACf,SAAS,EACT,YAAY,EACZ,kBAAkB,CACV,CAAA;AAEV,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAA;AAIjE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,eAAe,CAEvE;AAED,eAAO,MAAM,sBAAsB;;;;;kBAMjC,CAAA;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;iBAc7B,CAAA;AAEF,2EAA2E;AAC3E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;IAC9B,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAA;IACxE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACpC;AAED,eAAO,MAAM,wBAAwB,EAAE,SAAS,qBAAqB,EAkBpE,CAAA"}

package/dist/system-fields.js

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+import { CONTENT_STATUSES, PROVENANCE_KINDS } from './types.js';
+/**
+ * Contract A § "Champs système". Present on every entry of every collection,
+ * never declared by the author, never optional.
+ *
+ * `provenance` least of all: the European AI framework requires knowing whether
+ * a piece of content was written, assisted or generated, so it exists from the
+ * first migration rather than being retrofitted once there is content.
+ *
+ * These are not `FieldDefinition`s. They are not authored, not translated, not
+ * validated against user options — describing them as ordinary fields would let
+ * a collection redeclare one, which is exactly what `defineCollection` refuses.
+ */
+export const SYSTEM_FIELD_NAMES = [
+    'id',
+    'createdAt',
+    'updatedAt',
+    'createdBy',
+    'updatedBy',
+    'status',
+    'locale',
+    'translationOf',
+    'version',
+    'provenance',
+    'provenanceDetail',
+];
+const SYSTEM_FIELD_NAME_SET = new Set(SYSTEM_FIELD_NAMES);
+export function isSystemFieldName(name) {
+    return SYSTEM_FIELD_NAME_SET.has(name);
+}
+export const provenanceDetailSchema = z.strictObject({
+    agent: z.string().optional(),
+    model: z.string().optional(),
+    at: z.iso.datetime({ offset: true }).optional(),
+    /** Kept for audit. Never rendered, never handed back to a model (rule R7). */
+    prompt: z.string().optional(),
+});
+export const systemFieldsSchema = z.object({
+    id: z.string().min(1),
+    createdAt: z.iso.datetime({ offset: true }),
+    updatedAt: z.iso.datetime({ offset: true }),
+    createdBy: z.string().min(1).nullable(),
+    updatedBy: z.string().min(1).nullable(),
+    status: z.enum(CONTENT_STATUSES),
+    /** Contract A § i18n: one entry per locale (ADR-0014). */
+    locale: z.string().min(1),
+    /** The source entry of a translation family, or `null` on the source itself. */
+    translationOf: z.string().min(1).nullable(),
+    version: z.number().int().min(1),
+    provenance: z.enum(PROVENANCE_KINDS),
+    provenanceDetail: provenanceDetailSchema.nullable(),
+});
+export const SYSTEM_FIELD_DESCRIPTORS = [
+    { name: 'id', type: 'id', nullable: false, readOnly: true },
+    { name: 'createdAt', type: 'datetime', nullable: false, readOnly: true },
+    { name: 'updatedAt', type: 'datetime', nullable: false, readOnly: true },
+    { name: 'createdBy', type: 'id', nullable: true, readOnly: true },
+    { name: 'updatedBy', type: 'id', nullable: true, readOnly: true },
+    { name: 'status', type: 'enum', nullable: false, readOnly: true, values: CONTENT_STATUSES },
+    { name: 'locale', type: 'string', nullable: false, readOnly: true },
+    { name: 'translationOf', type: 'id', nullable: true, readOnly: true },
+    { name: 'version', type: 'number', nullable: false, readOnly: true },
+    {
+        name: 'provenance',
+        type: 'enum',
+        nullable: false,
+        readOnly: true,
+        values: PROVENANCE_KINDS,
+    },
+    { name: 'provenanceDetail', type: 'json', nullable: true, readOnly: true },
+];
+//# sourceMappingURL=system-fields.js.map

package/dist/system-fields.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,101 @@
+/**
+ * The shapes the content engine is built on.
+ *
+ * This file is the seam between `@cogenta/schema`, `@cogenta/blocks` and
+ * `@cogenta/api`: it declares what a field and a collection *are*, so the three
+ * packages can be built against the same shapes rather than against each other.
+ *
+ * It implements contract A, frozen at `schema@1.0` on 2026-08-13. Every
+ * departure from the contract text is a bug in this file, not a liberty.
+ */
+/** Contract A, "Types de champ (v1)". Closed set: adding one is a minor version. */
+export declare const FIELD_KINDS: readonly ['text', 'richText', 'slug', 'number', 'boolean', 'date', 'datetime', 'media', 'relation', 'select', 'json', 'geo', 'color', 'blocks'];
+export type FieldKind = (typeof FIELD_KINDS)[number];
+/** Contract A, "Permissions". Actions are fixed; role names are an open set. */
+export declare const CONTENT_ACTIONS: readonly ['read', 'create', 'update', 'delete', 'publish'];
+export type ContentAction = (typeof CONTENT_ACTIONS)[number];
+export declare const CONTENT_STATUSES: readonly ['draft', 'scheduled', 'published', 'archived'];
+export type ContentStatus = (typeof CONTENT_STATUSES)[number];
+export declare const PROVENANCE_KINDS: readonly ['human', 'assisted', 'generated'];
+export type Provenance = (typeof PROVENANCE_KINDS)[number];
+/** What the admin needs to render a field, and nothing the engine needs. */
+export interface FieldAdminOptions {
+    readonly label?: string;
+    readonly help?: string;
+    readonly group?: string;
+    /** Show this field only when another field holds a given value. */
+    readonly showWhen?: {
+        readonly field: string;
+        readonly equals: unknown;
+    };
+}
+export interface BaseFieldOptions {
+    readonly required?: boolean;
+    readonly default?: unknown;
+    /**
+     * Declares that this field is translated.
+     *
+     * **Not a storage directive** (ADR-0014): content is stored one entry per
+     * locale. This tells the admin the field is worth translating, so it can
+     * offer to copy it from the source entry.
+     */
+    readonly localized?: boolean;
+    readonly unique?: boolean;
+    readonly validate?: (value: unknown) => true | string;
+    readonly admin?: FieldAdminOptions;
+}
+/** What happens to a referencing row when the target is deleted. */
+export type OnDelete = 'restrict' | 'cascade' | 'setNull';
+export interface FieldDefinition extends BaseFieldOptions {
+    readonly kind: FieldKind;
+    /** Kind-specific settings: `max`, `to`, `many`, `accept`, `options`, `from`… */
+    readonly options: Readonly<Record<string, unknown>>;
+}
+export interface CollectionRouting {
+    readonly pattern: string;
+    /** Prefix the route with the locale. */
+    readonly locale?: boolean;
+}
+export interface CollectionVersioning {
+    readonly drafts?: boolean;
+    readonly history?: boolean;
+    /** Versions kept per entry. Unlimited history is a slow leak, not a feature. */
+    readonly keep?: number;
+}
+export type CollectionPermissions = Readonly<Partial<Record<ContentAction, readonly string[]>>>;
+export interface CollectionDefinition {
+    readonly name: string;
+    readonly labels: {
+        readonly singular: string;
+        readonly plural: string;
+    };
+    readonly routing?: CollectionRouting;
+    readonly versioning?: CollectionVersioning;
+    readonly fields: Readonly<Record<string, FieldDefinition>>;
+    readonly indexes?: readonly (readonly string[])[];
+    readonly permissions: CollectionPermissions;
+}
+/**
+ * Contract A, "Champs système". Present on every entry, never declared by the
+ * user, never optional — `provenance` least of all: the European AI framework
+ * requires it, so it exists from the first migration.
+ */
+export interface SystemFields {
+    readonly id: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly createdBy: string | null;
+    readonly updatedBy: string | null;
+    readonly status: ContentStatus;
+    readonly locale: string;
+    readonly translationOf: string | null;
+    readonly version: number;
+    readonly provenance: Provenance;
+    readonly provenanceDetail: {
+        readonly agent?: string;
+        readonly model?: string;
+        readonly at?: string;
+        readonly prompt?: string;
+    } | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,32 @@
+/**
+ * The shapes the content engine is built on.
+ *
+ * This file is the seam between `@cogenta/schema`, `@cogenta/blocks` and
+ * `@cogenta/api`: it declares what a field and a collection *are*, so the three
+ * packages can be built against the same shapes rather than against each other.
+ *
+ * It implements contract A, frozen at `schema@1.0` on 2026-08-13. Every
+ * departure from the contract text is a bug in this file, not a liberty.
+ */
+/** Contract A, "Types de champ (v1)". Closed set: adding one is a minor version. */
+export const FIELD_KINDS = [
+    'text',
+    'richText',
+    'slug',
+    'number',
+    'boolean',
+    'date',
+    'datetime',
+    'media',
+    'relation',
+    'select',
+    'json',
+    'geo',
+    'color',
+    'blocks',
+];
+/** Contract A, "Permissions". Actions are fixed; role names are an open set. */
+export const CONTENT_ACTIONS = ['read', 'create', 'update', 'delete', 'publish'];
+export const CONTENT_STATUSES = ['draft', 'scheduled', 'published', 'archived'];
+export const PROVENANCE_KINDS = ['human', 'assisted', 'generated'];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,oFAAoF;AACpF,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM;IACN,UAAU;IACV,MAAM;IACN,QAAQ;IACR,SAAS;IACT,MAAM;IACN,UAAU;IACV,OAAO;IACP,UAAU;IACV,QAAQ;IACR,MAAM;IACN,KAAK;IACL,OAAO;IACP,QAAQ;CACA,CAAA;AAIV,gFAAgF;AAChF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAA;AAIzF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,CAAU,CAAA;AAIxF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,WAAW,CAAU,CAAA"}

package/dist/validation.d.ts

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+import type { CollectionDefinition, FieldDefinition } from './types.js';
+/**
+ * Turns a field definition into the validator that guards every write.
+ *
+ * One validator derived from the schema, never a second hand-written one: the
+ * schema is the single source of truth (L1 § "Génération"), and a validator
+ * that drifts from it is worse than no validator at all.
+ */
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/**
+ * Written out rather than taken from Zod's helper: a `json` column must hold
+ * what `JSON.parse` can return and nothing else — no `undefined`, no `Date`,
+ * no class instance that would come back as `{}` after a round-trip.
+ */
+export declare const jsonValueSchema: z.ZodType<JsonValue>;
+export declare const geoPointSchema: z.ZodObject<{
+    lat: z.ZodNumber;
+    lng: z.ZodNumber;
+    label: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type GeoPoint = z.infer<typeof geoPointSchema>;
+/** Lowercase words joined by single hyphens: what a URL segment may contain. */
+export declare const SLUG_PATTERN: RegExp;
+/** `#rgb`, `#rrggbb` or `#rrggbbaa`. A colour is data, never a CSS value (R3). */
+export declare const COLOR_PATTERN: RegExp;
+export declare const contentBlockSchema: z.ZodObject<{
+    _key: z.ZodString;
+    _type: z.ZodString;
+}, z.core.$loose>;
+/**
+ * The raw `_key`/`_type` wire envelope a `blocks` field accepts on write —
+ * distinct from the store's `ContentBlock` (`store/types.ts`, the normalised
+ * `key`/`type`/`data` shape `BlockZones` holds after `values.ts` unwraps
+ * this). Two types sharing the name `ContentBlock` used to collide in this
+ * package's public exports, with this one silently winning over the store's
+ * via `export *` — renamed so both are reachable under their own name.
+ */
+export type RawBlockInput = z.infer<typeof contentBlockSchema>;
+export declare function isCollectionValued(field: FieldDefinition): boolean;
+/**
+ * The validator for one field, custom rule and optionality included.
+ *
+ * An optional field accepts `null` and an absent key alike: a form that never
+ * showed the field and a form that cleared it mean the same thing to storage.
+ */
+export declare function fieldSchema(field: FieldDefinition): z.ZodType;
+/** What an author may send: the declared fields, and nothing else. */
+export declare function collectionInputSchema(collection: CollectionDefinition): z.ZodType;
+/** A stored entry: system fields plus the declared ones. */
+export declare function collectionEntrySchema(collection: CollectionDefinition): z.ZodType;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEvE;;;;;;GAMG;AAEH,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAA;AAEhC;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAShD,CAAA;AAED,eAAO,MAAM,cAAc;;;;kBAIzB,CAAA;AAEF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAErD,gFAAgF;AAChF,eAAO,MAAM,YAAY,QAA+B,CAAA;AAExD,kFAAkF;AAClF,eAAO,MAAM,aAAa,QAAwD,CAAA;AAElF,eAAO,MAAM,kBAAkB;;;iBAI7B,CAAA;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAiC9D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAIlE;AAyED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,CAAC,CAAC,OAAO,CAoB7D;AAED,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,oBAAoB,GAAG,CAAC,CAAC,OAAO,CAQjF;AAED,4DAA4D;AAC5D,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,oBAAoB,GAAG,CAAC,CAAC,OAAO,CAMjF"}