@orthacms/content-server 0.0.0-reserve.0

package/dist/lib/revisions/types/revision-view.d.ts

@@ -0,0 +1,74 @@
+import type { RevisionStatus } from '../domain/revision-status';
+import type { MediaRef, RelationRef } from '../../entries/types/entry-list-view';
+/**
+ * The immutable document a revision captures — everything the editor submits,
+ * plus the link sets that don't travel in the values bag. Reconstructs a version
+ * independently of the live row.
+ */
+export interface RevisionSnapshot {
+    /**
+     * Every field value keyed by field name: scalars, localized + shared fields,
+     * and single-relation FK ids (which the editor carries in `values`).
+     */
+    values: Record<string, unknown>;
+    /**
+     * The ordered target-id list of each **join-backed** relation field (owning
+     * many-to-many and the inverse of one) keyed by field name — the links that
+     * never travel in {@link values}.
+     */
+    relations: Record<string, string[]>;
+}
+/**
+ * One revision as served to the admin timeline — the metadata, without the
+ * (potentially large) snapshot body. `author` is resolved from `created_by`.
+ */
+export interface RevisionSummary {
+    /** Revision id. */
+    id: string;
+    /** Monotonic version number within the entry (1-based). */
+    number: number;
+    /** Lifecycle state. */
+    status: RevisionStatus;
+    /** Whether this is the entry's current live version. */
+    isPublished: boolean;
+    /** Whether this is the newest revision (the only one publishable). */
+    isLatest: boolean;
+    /** ISO capture timestamp. */
+    createdAt: string;
+    /** ISO publish timestamp, when published. */
+    publishedAt?: string;
+    /** The acting user's id, when known. */
+    authorId?: string;
+}
+/** One revision with its full snapshot body — for preview / restore. */
+export interface RevisionDetail extends RevisionSummary {
+    /** The captured document. */
+    snapshot: RevisionSnapshot;
+    /**
+     * Each relation field's snapshot ids resolved to display refs (title / slug /
+     * status), keyed by field name — so the preview shows the actual linked
+     * records, not raw uuids. Owning-single fields resolve their FK id from
+     * `snapshot.values`; join-backed fields resolve their id list from
+     * `snapshot.relations`. **Capped per field** (`relationTotals` carries the
+     * true count for a "+N more"), and present only on this detail read — the
+     * timeline summaries stay lean.
+     */
+    relationRefs?: Record<string, RelationRef[]>;
+    /** The true link count per relation field (may exceed the capped refs). */
+    relationTotals?: Record<string, number>;
+    /**
+     * Each media field's snapshot asset ids resolved to display refs (name /
+     * thumbnail url / kind), keyed by field name — so the preview shows the
+     * actual assets, not raw uuids. A single field resolves its id from
+     * `snapshot.values`; a `multiple` field its ordered id list. An asset that
+     * can't be resolved (deleted / out of workspace) is an id-only `missing` ref.
+     * Present only when a media resolver is bound.
+     */
+    mediaRefs?: Record<string, MediaRef[]>;
+}
+/** The paginated timeline envelope, matching the list-page convention. */
+export interface RevisionListView {
+    items: RevisionSummary[];
+    total: number;
+}
+//# sourceMappingURL=revision-view.d.ts.map

package/dist/lib/revisions/types/revision-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revision-view.d.ts","sourceRoot":"","sources":["../../../../src/lib/revisions/types/revision-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EACR,QAAQ,EACR,WAAW,EACd,MAAM,qCAAqC,CAAC;AAE7C;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACvC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC5B,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,wDAAwD;IACxD,WAAW,EAAE,OAAO,CAAC;IACrB,sEAAsE;IACtE,QAAQ,EAAE,OAAO,CAAC;IAClB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wEAAwE;AACxE,MAAM,WAAW,cAAe,SAAQ,eAAe;IACnD,6BAA6B;IAC7B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IAC7C,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;CAC1C;AAED,0EAA0E;AAC1E,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACjB"}

package/dist/lib/revisions/types/revision-view.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/lib/types/content-type.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Content-type contracts: a code-defined collection (multi-entry) or
+ * single (standalone page). Definitions live in the HOST app (it owns
+ * their migrations, like any schema owner); this plugin owns the
+ * registry, serialization, and validation machinery around them.
+ */
+import type { PgTable } from 'drizzle-orm/pg-core';
+import type { AnyFieldSpec, FieldValue } from './fields';
+/**
+ * Multi-entry collection vs. standalone page — mirrors the established
+ * `ContentTypeDescriptor` contract. The runtime object is the source of truth;
+ * the {@link ContentTypeKind} union is derived from it.
+ */
+export declare const CONTENT_TYPE_KIND: {
+    readonly Collection: "collection";
+    readonly Single: "single";
+};
+/** Multi-entry collection vs. standalone page. */
+export type ContentTypeKind = (typeof CONTENT_TYPE_KIND)[keyof typeof CONTENT_TYPE_KIND];
+/**
+ * Publish-state values carried by the `status` envelope column of a
+ * `publishable` type. The runtime object is the source of truth for the
+ * generated column enum, the filter schema, and the admin — so the set can't
+ * drift across them.
+ */
+export declare const ENTRY_STATUS: {
+    readonly Draft: "draft";
+    readonly Published: "published";
+};
+/** Publish state of an entry on a publishable type. */
+export type EntryStatus = (typeof ENTRY_STATUS)[keyof typeof ENTRY_STATUS];
+/** Options accepted by `collection()` / `single()`. */
+export interface ContentTypeOptions<TFields extends Record<string, AnyFieldSpec>> {
+    /** Human label; falls back to the name. */
+    label?: string;
+    /** Short description shown in pickers (workspace wizard, admin). */
+    description?: string;
+    /**
+     * Track when an entry was published: adds a reserved, nullable
+     * `published_at` envelope column the platform owns. Authors cannot define
+     * it as a field, and clients cannot set it directly.
+     */
+    publishable?: boolean;
+    /**
+     * Soft-delete: adds a reserved, nullable `deleted_at` envelope column. A
+     * deleted entry is tombstoned (its `deleted_at` set) rather than removed.
+     * Authors cannot define it as a field, and clients cannot set it directly.
+     */
+    paranoid?: boolean;
+    /**
+     * Row-per-locale localization: adds reserved `locale` + `locale_group_id`
+     * envelope columns the platform owns. Each locale of an entry is a full
+     * row; sibling rows share a `locale_group_id`. What a locale *means*
+     * (available slugs, the default, scoping, sync) is owned by the bound
+     * localization plugin via the `CONTENT_ENTRY_EXTENSION` port — this
+     * package only provides the storage shape.
+     */
+    i18n?: boolean;
+    /** The field map — keys become column names (snake_cased). */
+    fields: TFields;
+}
+/** Extra options for `single()` (pages). */
+export interface SingleOptions<TFields extends Record<string, AnyFieldSpec>> extends ContentTypeOptions<TFields> {
+    /** Route path the page renders at, e.g. '/about'. */
+    path: string;
+}
+/**
+ * A defined content type: the serializable spec plus the physical
+ * Drizzle tables generated from it. `table` (and any `joinTables`) are
+ * what the host re-exports for drizzle-kit to diff into migrations.
+ */
+export interface ContentType<TFields extends Record<string, AnyFieldSpec> = Record<string, AnyFieldSpec>> {
+    /** Stable machine name / slug (snake_case). */
+    readonly name: string;
+    readonly kind: ContentTypeKind;
+    readonly label: string;
+    readonly description?: string;
+    /** Route path — singles only. */
+    readonly path?: string;
+    /** Tracks publish time via a `published_at` envelope column. */
+    readonly publishable: boolean;
+    /** Soft-deletes via a `deleted_at` envelope column. */
+    readonly paranoid: boolean;
+    /** Row-per-locale via `locale` + `locale_group_id` envelope columns. */
+    readonly i18n: boolean;
+    readonly fields: TFields;
+    /** The generated Postgres table (`content_<name>`). */
+    readonly table: PgTable;
+    /** Generated join tables, keyed by the many-relation field name. */
+    readonly joinTables: Record<string, PgTable>;
+}
+/** Any content type, regardless of its field map. */
+export type AnyContentType = ContentType<Record<string, AnyFieldSpec>>;
+/**
+ * Envelope columns an entry row carries. `id`/`workspaceId`/`createdAt`/
+ * `updatedAt` are always present; `status`/`publishedAt` exist only on
+ * `publishable` types, `deletedAt` only on `paranoid` types — hence optional.
+ * A fully type-level guarantee ("`status` ⟺ `publishable`") would require the
+ * flags to be literal-typed generics on the content type, a larger refactor.
+ */
+export interface EntryEnvelope {
+    /** Primary key. */
+    id: string;
+    /** Owning workspace (plain uuid until workspace scoping lands). */
+    workspaceId: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+    /** Publish state — present only on `publishable` types. */
+    status?: 'draft' | 'published';
+    /** Publish timestamp — present (nullable) only on `publishable` types. */
+    publishedAt?: Date | null;
+    /** Soft-delete tombstone — present (nullable) only on `paranoid` types. */
+    deletedAt?: Date | null;
+    /** Locale slug of this row — present only on `i18n` types. */
+    locale?: string;
+    /** Shared id across a translation group — present only on `i18n` types. */
+    localeGroupId?: string;
+}
+/** The field values of a content type, null-aware via each field's `required`. */
+export type InferValues<C extends AnyContentType> = {
+    [K in keyof C['fields']]: FieldValue<C['fields'][K]>;
+};
+/**
+ * The full row type of a content type — envelope plus typed values.
+ *
+ * @example
+ *   export const post = collection('post', { fields: { … } });
+ *   type Post = InferEntry<typeof post>;   // { id, status, …, title: string, … }
+ */
+export type InferEntry<C extends AnyContentType> = EntryEnvelope & InferValues<C>;
+//# sourceMappingURL=content-type.d.ts.map

package/dist/lib/types/content-type.d.ts.map

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

package/dist/lib/types/content-type.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Content-type contracts: a code-defined collection (multi-entry) or
+ * single (standalone page). Definitions live in the HOST app (it owns
+ * their migrations, like any schema owner); this plugin owns the
+ * registry, serialization, and validation machinery around them.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ENTRY_STATUS = exports.CONTENT_TYPE_KIND = void 0;
+/**
+ * Multi-entry collection vs. standalone page — mirrors the established
+ * `ContentTypeDescriptor` contract. The runtime object is the source of truth;
+ * the {@link ContentTypeKind} union is derived from it.
+ */
+exports.CONTENT_TYPE_KIND = {
+    Collection: 'collection',
+    Single: 'single'
+};
+/**
+ * Publish-state values carried by the `status` envelope column of a
+ * `publishable` type. The runtime object is the source of truth for the
+ * generated column enum, the filter schema, and the admin — so the set can't
+ * drift across them.
+ */
+exports.ENTRY_STATUS = {
+    Draft: 'draft',
+    Published: 'published'
+};

package/dist/lib/types/fields.d.ts

@@ -0,0 +1,303 @@
+/**
+ * Field-spec contracts for code-defined content types. A field spec is a
+ * plain, JSON-serializable description (plus a lazy relation thunk) that
+ * drives three things at once: the generated Postgres column, server-side
+ * validation, and the admin's dynamic form rendering.
+ */
+import type { RichTextStructureMode } from '@orthacms/content-domain';
+import type { AnyContentType } from './content-type';
+/**
+ * Built-in field type identifiers. The runtime object is the single source of
+ * truth; the {@link FieldType} union is derived from it so the two can never
+ * drift, and every `switch`/comparison references `CONTENT_FIELD_TYPE.*`
+ * instead of a bare string literal.
+ */
+export declare const CONTENT_FIELD_TYPE: {
+    readonly Text: "text";
+    readonly RichText: "richtext";
+    readonly Number: "number";
+    readonly Money: "money";
+    readonly Boolean: "boolean";
+    readonly Date: "date";
+    readonly Datetime: "datetime";
+    readonly Select: "select";
+    readonly Multiselect: "multiselect";
+    readonly Json: "json";
+    readonly Relation: "relation";
+    readonly Media: "media";
+};
+/** Built-in field type identifiers. */
+export type FieldType = (typeof CONTENT_FIELD_TYPE)[keyof typeof CONTENT_FIELD_TYPE];
+/**
+ * The canonical "no value" test for a field value — null/undefined, a blank
+ * (whitespace-only) string, or an empty array. The single definition shared by
+ * the validation service (where an empty value either trips `required` or is
+ * skipped) and the row mappers (where the admin seeds every untouched field with
+ * `''`/`[]`, which storage must collapse to `null` rather than coerce, e.g.
+ * `new Date('')` → Invalid Date). One authority so the two can't drift.
+ */
+export declare function isEmptyFieldValue(value: unknown): boolean;
+/**
+ * Presentation props forwarded verbatim to the admin (and any other
+ * frontend) via `GET /api/content-schema`. The known keys are what the
+ * stock admin reads; everything else passes through untouched, so a
+ * project can attach its own hints. Must stay JSON-serializable.
+ */
+export interface AdminProps {
+    /** Human label; falls back to the field name. */
+    label?: string;
+    /** Help text rendered under the input. */
+    description?: string;
+    /** Input placeholder. */
+    placeholder?: string;
+    /** Render hint, e.g. 'textarea', 'slug', 'color'. */
+    widget?: string;
+    /** Hide from the default form (still served by the API). */
+    hidden?: boolean;
+    /** Project-specific extras — passed through untouched. */
+    [key: string]: unknown;
+}
+/**
+ * Validation rules, serialized to the admin so the same constraints
+ * render client-side. The server's EntryValidationService is the
+ * authority; the admin copy is a courtesy.
+ */
+export interface FieldValidation {
+    /**
+     * Minimum length (text/richtext). On a `richtext` field this counts the
+     * body's **text**, not its markup.
+     */
+    minLength?: number;
+    /**
+     * Maximum length (text/richtext). On a `richtext` field this counts the
+     * body's **text**, not its markup.
+     */
+    maxLength?: number;
+    /** ECMAScript regex source the value must match (text/richtext). */
+    pattern?: string;
+    /**
+     * Structural checking of a `richtext` body — heading order, table headers,
+     * link text, language markers. Defaults to `'on'`; `'off'` is the opt-out
+     * for a body that is not a document.
+     * @see RichTextStructureMode
+     */
+    structure?: RichTextStructureMode;
+    /** Minimum numeric value (number/money). */
+    min?: number;
+    /** Maximum numeric value (number/money). */
+    max?: number;
+    /** Restrict to whole numbers (number). */
+    integer?: boolean;
+}
+/** Referential action when a related row is deleted. */
+export type RelationOnDelete = 'cascade' | 'set null' | 'restrict';
+/**
+ * Marks a relation field as the **inverse** (back-reference) of a
+ * storage-backed relation owned by another type — the read/write "other side"
+ * of a two-way relation. An inverse field generates **no storage of its own**:
+ * it reuses the owning relation's FK column / join table, so editing either side
+ * mutates the same links and the two can never drift.
+ */
+export interface RelationInverseSpec {
+    /** The field name on the owning type ({@link RelationSpec.to}) that backs the link. */
+    field: string;
+}
+/** Runtime relation config carried by a relation field spec. */
+export interface RelationSpec {
+    /** Lazy target — a thunk so mutually-referencing files can import each other. */
+    to: () => AnyContentType;
+    /** Many-to-many (via a generated join table) vs a single FK column. */
+    many: boolean;
+    /** FK referential action; ignored for `many` (join rows just disappear). */
+    onDelete: RelationOnDelete;
+    /**
+     * Enforce a one-to-one relation: a `UNIQUE` constraint on the single FK
+     * column so at most one owner can point at a given target. Nullable-unique,
+     * so any number of owners may have no relation (Postgres permits many NULLs
+     * in a UNIQUE column). Meaningless — and rejected at define time — for a
+     * `many` relation, whose links live in a join table.
+     */
+    unique: boolean;
+    /**
+     * Whether an edit in one locale propagates this link to the record's other
+     * locale rows. Inert unless the **owner** is `i18n` (a type with no locale
+     * siblings has nothing to propagate to) and on an inverse field (which owns
+     * no storage of its own — it reuses the owning side's).
+     *
+     * `true` (the default) says the link belongs to the **record**, not to the
+     * language, which is what most relations mean: tagging the English article
+     * tags the German one too. *How* that is stored depends on the target — see
+     * `relationLocaleSync` in `extension/relation-locale-sync.ts`, which is the
+     * one place the rule lives.
+     *
+     * `false` gives each locale its own independent links. `localized: true` on
+     * a relation field is an alias for it; setting both in contradiction is
+     * rejected at define time.
+     */
+    syncAcrossLocales: boolean;
+    /**
+     * Present only on an **inverse** field: it owns no column/table and reads the
+     * link from {@link to}'s `field` (with source/target swapped). `to` is the
+     * owning type; `onDelete`/`unique`/`syncAcrossLocales` are inert.
+     */
+    inverse?: RelationInverseSpec;
+}
+/** Options shared by every field builder. */
+export interface BaseFieldOptions {
+    /** Reject empty values; the column becomes NOT NULL. */
+    required?: boolean;
+    /**
+     * BCP-47 tag naming the language this field's content is written in, when
+     * it is not the entry's own (WCAG 3.1.2 — language of parts). For the case
+     * where the *whole* field is in another language: an `originalTitle`, a
+     * `motto`. Inside a `richtext` body a passage carries its own `lang`, so
+     * this is not how a quotation is marked.
+     *
+     * Checked for well-formedness at define time — a POSIX locale (`en_US`) or
+     * a language name (`english`… well, that one is merely unregistered) is
+     * ignored outright by assistive tech, so it is caught at boot rather than
+     * shipped.
+     */
+    lang?: string;
+    /**
+     * The value differs per locale (valid only on an `i18n` content type —
+     * rejected at define time otherwise). A field without the flag is
+     * **shared** across a translation group: the bound localization plugin
+     * syncs its value to every sibling row on update and copies it when a
+     * translation is created.
+     */
+    localized?: boolean;
+    /** Presentation props forwarded to the admin. */
+    admin?: AdminProps;
+}
+export interface TextFieldOptions extends BaseFieldOptions {
+    minLength?: number;
+    maxLength?: number;
+    /** Regex source the value must match. */
+    pattern?: string;
+}
+/** Options for `field.richtext()` — a structured long-form body. */
+export interface RichTextFieldOptions extends BaseFieldOptions {
+    /** Minimum length, counted over the body's text (not its markup). */
+    minLength?: number;
+    /** Maximum length, counted over the body's text (not its markup). */
+    maxLength?: number;
+    /**
+     * Structural checking — heading order, table headers, link text, language
+     * markers. Defaults to `'on'`. Turn it `'off'` for a body that is not a
+     * document (a hand-maintained fragment, an email template), where the rules
+     * would be measuring the wrong thing.
+     */
+    structure?: RichTextStructureMode;
+}
+export interface NumberFieldOptions extends BaseFieldOptions {
+    min?: number;
+    max?: number;
+    /** Restrict to whole numbers. */
+    integer?: boolean;
+}
+/** Money is stored as integer minor units (cents) — exact, no float drift. */
+export interface MoneyFieldOptions extends BaseFieldOptions {
+    /** Minimum amount in minor units. */
+    min?: number;
+    /** Maximum amount in minor units. */
+    max?: number;
+}
+export interface SelectFieldOptions<TOptions extends readonly string[] = readonly string[]> extends BaseFieldOptions {
+    /** Allowed values. */
+    options: TOptions;
+}
+/** The coarse media categories the library groups assets by. */
+export type MediaKindValue = 'image' | 'video' | 'audio' | 'document' | 'archive';
+/** The valid {@link MediaKindValue}s, for define-time validation of `accept`. */
+export declare const MEDIA_KIND_VALUES: readonly MediaKindValue[];
+/**
+ * Restricts which assets a media field accepts. Both filters are optional and
+ * combine as OR within each list; an asset passes when it matches **any** listed
+ * kind **or** any listed MIME pattern (an absent `accept`, or one with neither
+ * list, accepts anything). A MIME pattern is either exact (`image/png`) or a
+ * `type/*` wildcard (`image/*`). Enforced server-side on save.
+ */
+export interface MediaAccept {
+    /** Allowed coarse kinds (image/video/audio/document/archive). */
+    kinds?: readonly MediaKindValue[];
+    /** Allowed MIME types — exact (`application/pdf`) or wildcard (`image/*`). */
+    mimeTypes?: readonly string[];
+}
+/** Options for `field.media()` — attach one or more Media Library assets. */
+export interface MediaFieldOptions extends BaseFieldOptions {
+    /** Hold an ordered list of assets rather than a single one. Defaults false. */
+    multiple?: boolean;
+    /** Restrict the accepted assets by kind and/or MIME. Defaults to any asset. */
+    accept?: MediaAccept;
+}
+export interface RelationFieldOptions extends BaseFieldOptions {
+    /** Lazy target content type. */
+    to: () => AnyContentType;
+    /** Many-to-many via a generated join table. Defaults to false. */
+    many?: boolean;
+    /** FK referential action. Defaults to 'set null' (or 'cascade' when required). */
+    onDelete?: RelationOnDelete;
+    /**
+     * One-to-one: add a `UNIQUE` constraint to the single FK column. Defaults
+     * to false. Invalid with `many: true` (rejected at define time).
+     */
+    unique?: boolean;
+    /**
+     * Propagate this link to the record's other locale rows when it is edited
+     * in one of them. Defaults to `true` (to `false` when `localized: true`).
+     * Meaningful only on an `i18n` type — rejected at define time otherwise.
+     * @see RelationSpec.syncAcrossLocales
+     */
+    syncAcrossLocales?: boolean;
+}
+/**
+ * Options for `field.relationInverse()` — the back-reference side of a two-way
+ * relation. It stores nothing: it mirrors the link owned by `of`'s `field`.
+ */
+export interface RelationInverseFieldOptions extends BaseFieldOptions {
+    /** Lazy owning content type — the side that declares the storage-backed relation. */
+    of: () => AnyContentType;
+    /** The relation field name on `of` whose link this side mirrors. */
+    field: string;
+    /**
+     * Whether this side is to-many. Defaults to `true` (the common inverse — the
+     * "one"/"far" side of a to-many or many-to-many owns many back-references).
+     */
+    many?: boolean;
+}
+/**
+ * The normalized field description every builder returns.
+ *
+ * `TValue` is a phantom type — it exists only so `InferEntry` can derive
+ * the row type of a collection; nothing is stored in it at runtime.
+ */
+export interface FieldSpec<TType extends FieldType = FieldType, TValue = unknown> {
+    readonly type: TType;
+    readonly required: boolean;
+    /** Value differs per locale — set only on fields of `i18n` types. */
+    readonly localized?: boolean;
+    /** BCP-47 language of this field's content, when it has its own. */
+    readonly lang?: string;
+    readonly validation: FieldValidation;
+    readonly admin: AdminProps;
+    /** Allowed values — select fields only. */
+    readonly options?: readonly string[];
+    /** Relation config — relation fields only. */
+    readonly relation?: RelationSpec;
+    /** Holds an ordered list of asset ids — media fields only. */
+    readonly multiple?: boolean;
+    /** Accepted-asset restriction — media fields only. */
+    readonly accept?: MediaAccept;
+    /** Phantom compile-time value type. Never assigned. */
+    readonly _value?: TValue;
+}
+/** Any field spec, regardless of type/value. */
+export type AnyFieldSpec = FieldSpec<FieldType, unknown>;
+/** Value type of a field spec (null-aware via `required`). */
+export type FieldValue<F> = F extends FieldSpec<FieldType, infer V> ? V : never;
+/** Maps an options object to `V` when `required: true`, else `V | null`. */
+export type WithRequired<O, V> = O extends {
+    required: true;
+} ? V : V | null;
+//# sourceMappingURL=fields.d.ts.map

package/dist/lib/types/fields.d.ts.map

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

package/dist/lib/types/fields.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * Field-spec contracts for code-defined content types. A field spec is a
+ * plain, JSON-serializable description (plus a lazy relation thunk) that
+ * drives three things at once: the generated Postgres column, server-side
+ * validation, and the admin's dynamic form rendering.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MEDIA_KIND_VALUES = exports.CONTENT_FIELD_TYPE = void 0;
+exports.isEmptyFieldValue = isEmptyFieldValue;
+/**
+ * Built-in field type identifiers. The runtime object is the single source of
+ * truth; the {@link FieldType} union is derived from it so the two can never
+ * drift, and every `switch`/comparison references `CONTENT_FIELD_TYPE.*`
+ * instead of a bare string literal.
+ */
+exports.CONTENT_FIELD_TYPE = {
+    Text: 'text',
+    RichText: 'richtext',
+    Number: 'number',
+    Money: 'money',
+    Boolean: 'boolean',
+    Date: 'date',
+    Datetime: 'datetime',
+    Select: 'select',
+    Multiselect: 'multiselect',
+    Json: 'json',
+    Relation: 'relation',
+    Media: 'media'
+};
+/**
+ * The canonical "no value" test for a field value — null/undefined, a blank
+ * (whitespace-only) string, or an empty array. The single definition shared by
+ * the validation service (where an empty value either trips `required` or is
+ * skipped) and the row mappers (where the admin seeds every untouched field with
+ * `''`/`[]`, which storage must collapse to `null` rather than coerce, e.g.
+ * `new Date('')` → Invalid Date). One authority so the two can't drift.
+ */
+function isEmptyFieldValue(value) {
+    return (value === undefined ||
+        value === null ||
+        (typeof value === 'string' && value.trim() === '') ||
+        (Array.isArray(value) && value.length === 0));
+}
+/** The valid {@link MediaKindValue}s, for define-time validation of `accept`. */
+exports.MEDIA_KIND_VALUES = [
+    'image',
+    'video',
+    'audio',
+    'document',
+    'archive'
+];

package/dist/lib/utils/content-plugin.d.ts

@@ -0,0 +1,35 @@
+import type { ServerPlugin } from '@orthacms/bootstrap-server';
+import { ContentTypeRegistry } from '../registry/content-type-registry';
+import type { AnyContentType } from '../types/content-type';
+/** Options for {@link ContentPlugin}. */
+export interface ContentPluginOptions {
+    /** Every code-defined content type (collections and singles). */
+    types: readonly AnyContentType[];
+    /**
+     * The HOST's migrations for the generated collection tables. The host
+     * owns this schema (its drizzle.config.ts diffs the re-exported
+     * tables), but routing the descriptor through the plugin lets the
+     * standard `db:migrate` machinery apply it with everything else.
+     */
+    migrations?: ServerPlugin['migrations'];
+}
+/** The content plugin's `ServerPlugin`, exposing its registry. */
+export interface ContentServerPlugin extends ServerPlugin {
+    registry: ContentTypeRegistry;
+}
+/**
+ * Content plugin factory. Builds the registry eagerly — duplicate names
+ * or unresolvable relation targets throw here, failing boot rather than
+ * the first request.
+ *
+ * @example
+ *   ContentPlugin({
+ *       types: [post, author, home],
+ *       migrations: {
+ *           dir: () => join(__dirname, '../migrations'),
+ *           table: '__drizzle_migrations_content'
+ *       }
+ *   })
+ */
+export declare function ContentPlugin(options: ContentPluginOptions): ContentServerPlugin;
+//# sourceMappingURL=content-plugin.d.ts.map

package/dist/lib/utils/content-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-plugin.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/content-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,yCAAyC;AACzC,MAAM,WAAW,oBAAoB;IACjC,iEAAiE;IACjE,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IACjC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,YAAY,CAAC,YAAY,CAAC,CAAC;CAC3C;AAED,kEAAkE;AAClE,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACrD,QAAQ,EAAE,mBAAmB,CAAC;CACjC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CACzB,OAAO,EAAE,oBAAoB,GAC9B,mBAAmB,CAerB"}