@orthacms/content-server 0.4.2 → 0.5.0

package/dist/lib/entries/services/relation-link.service.d.ts

@@ -1,115 +0,0 @@
-import { type Database } from '@ortha-cms/database';
-import type { AnyContentType } from '../../types/content-type';
-import { type AnyFieldSpec } from '../../types/fields';
-import type { RelationDelta, RelationFieldView } from '../types/entry-list-view';
-/** A generated content row seen as a bag of values by property name. */
-type Row = Record<string, unknown>;
-/** Default links per page when the caller doesn't specify one. */
-export declare const RELATION_PAGE_SIZE = 20;
-/**
- * The transaction handle Drizzle hands the `db.transaction(tx => …)` callback —
- * derived from {@link Database} so link writes share the exact query surface of
- * the client without hard-coding the dialect's transaction type.
- */
-export type DbTransaction = Parameters<Parameters<Database['transaction']>[0]>[0];
-/**
- * Reads and writes the relation **links** an entry owns beyond its own columns:
- * many-to-many join rows and the inverse (back-reference) side of a two-way
- * relation. Owning **single** relations are plain `<field>_id` FK columns —
- * written by `toColumns`, read off the row — so they need no join plumbing.
- *
- * Everything is **paginated**: a relation can hold thousands of links, so reads
- * return one ordered page + a `total` (never every id), and writes apply an
- * incremental {@link RelationDelta} (link / unlink / reorder) inside a
- * transaction — so a huge relation never has to be sent or held in full.
- * Order is persisted in the join table's `position` column, owned by the
- * **source** side; the inverse reads by it (stable) but can't reorder it.
- */
-export declare class RelationLinkService {
-    private readonly db;
-    constructor(db: Database);
-    /**
-     * First page (+ total) of **every** relation field of `type` for one entry,
-     * keyed by field name — what the editor loads on open. Each field is read
-     * independently (paginated), so a relation with many links contributes only
-     * its first page, not every id.
-     */
-    readAll(type: AnyContentType, row: Row, workspaceId: string, pageSize?: number): Promise<Record<string, RelationFieldView>>;
-    /**
-     * One page of a single relation field's links, ordered by `position`
-     * (owning) and resolved to display-ready refs (id + title). `row` is the
-     * editing entry (its FK columns back a single relation); pass it to avoid a
-     * re-read. Returns `{ items, total }`.
-     */
-    readField(type: AnyContentType, row: Row, field: string, spec: AnyFieldSpec, page: number, pageSize: number, workspaceId: string): Promise<RelationFieldView>;
-    /**
-     * Apply an incremental {@link RelationDelta} to one many/inverse relation
-     * field inside `tx`: validate the linked targets are in the workspace, unlink
-     * the removed pairs, append the new ones (`position = max+1` for the source,
-     * `ON CONFLICT DO NOTHING`), then renumber to `order` (owning side only).
-     * A single relation or an inverse-of-single owns no delta-writable link, so
-     * it's a no-op. Returns nothing — read the field back for the new state.
-     */
-    applyDelta(tx: DbTransaction, type: AnyContentType, sourceId: string, field: string, delta: RelationDelta, workspaceId: string): Promise<void>;
-    /**
-     * Replace a many-relation's links with exactly `values[field]` (array),
-     * position = array index — the **whole-set** write used only when a caller
-     * genuinely submits a relation **array** in the entry body (legacy / bulk).
-     * The editor uses {@link applyDelta} instead. Runs inside the entry's
-     * transaction. **Only an array counts**: a field that's absent or `null`
-     * (`coerceValues` stamps `null` onto every unset field) is left untouched, so
-     * a save that manages a relation purely through deltas can never have its
-     * links cleared here.
-     */
-    writeLinks(tx: DbTransaction, type: AnyContentType, sourceId: string, values: Record<string, unknown>, workspaceId: string): Promise<void>;
-    /**
-     * Count the links of one join-backed relation field for an entry — the
-     * `total` a read would report, without fetching or resolving any page. Runs
-     * on the passed executor (the write transaction when validating a just-saved
-     * entry, so it sees the delta's uncommitted rows). Returns 0 for a relation
-     * that owns no writable links from this side (single FK / inverse-of-single).
-     */
-    countLinks(exec: Database | DbTransaction, type: AnyContentType, row: Row, field: string, spec: AnyFieldSpec, workspaceId: string): Promise<number>;
-    /**
-     * Take the transaction-scoped advisory lock for one physical source list
-     * (`<join table>:<sourceId>`), serializing every appender to that list so no
-     * two concurrent writes read the same `max(position)`. Auto-releases at
-     * commit/rollback. Keyed on the table name too, so distinct join tables that
-     * happen to share a source id don't falsely contend.
-     */
-    private lockSource;
-    /** Next append position for a source: `max(position) + 1`, else 0. */
-    private nextPosition;
-    /**
-     * Resolve `ids` (in order) to display-ready refs via one lookup on the target
-     * type, scoped to the workspace. Ids with no **live** row drop to an id-only
-     * ref — a soft-deleted (paranoid) target is excluded here just as it is on
-     * the inverse read side, so a trashed record never surfaces its title on the
-     * owning side while it's hidden on the other.
-     */
-    private refsFor;
-    /** Build a display ref from a full target row. */
-    private rowToRef;
-    /**
-     * Verify every id to be linked exists **in the same workspace** (the join FK
-     * has no workspace constraint of its own). A missing or cross-workspace id is
-     * a uniform 422 — indistinguishable from an invalid id, so no enumeration
-     * signal.
-     */
-    private assertTargets;
-    /**
-     * The join-table plan for a relation field, or `null` when it owns no join
-     * table (an owning single relation, or an inverse-of-single). An owning
-     * many-relation uses its own join table (`source→target`); an inverse of a
-     * many-to-many reuses the owning side's join table with the roles swapped.
-     */
-    private joinPlanFor;
-    /**
-     * The inverse-of-single (one-to-many) plan for a relation field, or `null`:
-     * it reads the owner rows whose FK points back at the editing record, and
-     * owns no writable link from this side.
-     */
-    private inversePlanFor;
-}
-export {};
-//# sourceMappingURL=relation-link.service.d.ts.map

package/dist/lib/entries/services/relation-link.service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"relation-link.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/entries/services/relation-link.service.ts"],"names":[],"mappings":"AAeA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,KAAK,EACR,aAAa,EACb,iBAAiB,EAEpB,MAAM,0BAA0B,CAAC;AAMlC,wEAAwE;AACxE,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnC,kEAAkE;AAClE,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAUrC;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,CAClC,UAAU,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CACzC,CAAC,CAAC,CAAC,CAAC;AA0BL;;;;;;;;;;;;GAYG;AACH,qBACa,mBAAmB;IACE,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ;IAI3D;;;;;OAKG;IACG,OAAO,CACT,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,GAAG,EACR,WAAW,EAAE,MAAM,EACnB,QAAQ,SAAqB,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAoB7C;;;;;OAKG;IACG,SAAS,CACX,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,CAAC;IA0E7B;;;;;;;OAOG;IACG,UAAU,CACZ,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC;IA+FhB;;;;;;;;;OASG;IACG,UAAU,CACZ,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,WAAW,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC;IAwChB;;;;;;OAMG;IACG,UAAU,CACZ,IAAI,EAAE,QAAQ,GAAG,aAAa,EAC9B,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,YAAY,EAClB,WAAW,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC;IA8BlB;;;;;;OAMG;YACW,UAAU;IAWxB,sEAAsE;YACxD,YAAY;IAc1B;;;;;;OAMG;YACW,OAAO;IAuBrB,kDAAkD;IAClD,OAAO,CAAC,QAAQ;IAWhB;;;;;OAKG;YACW,aAAa;IAmC3B;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IA8BnB;;;;OAIG;IACH,OAAO,CAAC,cAAc;CAYzB"}

package/dist/lib/extension/per-locale-relation.d.ts

@@ -1,18 +0,0 @@
-import { type AnyFieldSpec } from '../types/fields';
-import type { AnyContentType } from '../types/content-type';
-/**
- * Whether a field is a **per-locale relation** — a *single owning* relation
- * (`!many`, `!inverse`) on an **i18n** owner whose **target type is also i18n**.
- *
- * Such a relation can't be shared across a translation group: a shared FK would
- * point at one specific locale's row, i.e. a cross-locale link. So the platform
- * treats it as `localized` — not synced onto siblings, not copied into a
- * translation draft, and the picker offers only same-locale candidates. Both the
- * schema serializer (which stamps `localized` for the admin) and the i18n
- * sibling-sync consult this, so the rule lives in one place.
- *
- * The target's i18n-ness is read via the resolved thunk `spec.relation.to()` —
- * safe because the registry resolves every relation target at boot.
- */
-export declare function isPerLocaleRelation(owner: AnyContentType, spec: AnyFieldSpec): boolean;
-//# sourceMappingURL=per-locale-relation.d.ts.map

package/dist/lib/extension/per-locale-relation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"per-locale-relation.d.ts","sourceRoot":"","sources":["../../../src/lib/extension/per-locale-relation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAC/B,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,YAAY,GACnB,OAAO,CAQT"}

package/dist/lib/public/controllers/get-public-entry.controller.d.ts

@@ -1,26 +0,0 @@
-import type { ContentTypeRegistry } from '../../registry/content-type-registry';
-import { EntryWriterService } from '../../entries/infrastructure/persistence/entry-writer.service';
-import type { EntryRecord, EntryRelationsView, RelationFieldView } from '../../entries/types/entry-list-view';
-/**
- * `GET /api/v1/content/:typeName/:id[/relations[/:field]]` — the external,
- * bearer-token-authenticated single-entry reads, mirroring the admin's
- * `GetEntryController`. Every route is scoped to the token's workspace
- * (`@CurrentWorkspace()`), so an id outside it reads as 404. Read-only:
- * `content:read`, enforced against the token's scope by {@link ApiTokenGuard}.
- */
-export declare class GetPublicEntryController {
-    private readonly registry;
-    private readonly writer;
-    constructor(registry: ContentTypeRegistry, writer: EntryWriterService);
-    /**
-     * One live entry by id (404 if unknown or soft-deleted in the workspace).
-     * `?fields=title,slug` narrows the returned `values` bag to those fields;
-     * omitted, the whole record is returned. An unknown name is a 400.
-     */
-    getOne(typeName: string, id: string, workspaceId: string, fields?: string): Promise<EntryRecord>;
-    /** First page of every relation field's links for one entry. */
-    getRelations(typeName: string, id: string, workspaceId: string): Promise<EntryRelationsView>;
-    /** One page of a single relation field's links (`{ items, total }`). */
-    getRelationField(typeName: string, id: string, field: string, workspaceId: string, page?: string, pageSize?: string): Promise<RelationFieldView>;
-}
-//# sourceMappingURL=get-public-entry.controller.d.ts.map

package/dist/lib/public/controllers/get-public-entry.controller.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"get-public-entry.controller.d.ts","sourceRoot":"","sources":["../../../../src/lib/public/controllers/get-public-entry.controller.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,+DAA+D,CAAC;AAInG,OAAO,KAAK,EACR,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACpB,MAAM,qCAAqC,CAAC;AAE7C;;;;;;GAMG;AACH,qBAIa,wBAAwB;IAG7B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,QAAQ,EAAE,mBAAmB,EAC7B,MAAM,EAAE,kBAAkB;IAG/C;;;;OAIG;IAEH,MAAM,CACiB,QAAQ,EAAE,MAAM,EACP,EAAE,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,MAAM,GACjC,OAAO,CAAC,WAAW,CAAC;IAKvB,gEAAgE;IAE1D,YAAY,CACK,QAAQ,EAAE,MAAM,EACP,EAAE,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GACxC,OAAO,CAAC,kBAAkB,CAAC;IAO9B,wEAAwE;IAExE,gBAAgB,CACO,QAAQ,EAAE,MAAM,EACP,EAAE,EAAE,MAAM,EACtB,KAAK,EAAE,MAAM,EACT,WAAW,EAAE,MAAM,EACxB,IAAI,CAAC,EAAE,MAAM,EACT,QAAQ,CAAC,EAAE,MAAM,GACrC,OAAO,CAAC,iBAAiB,CAAC;CAWhC"}

package/dist/lib/public/controllers/list-public-entries.controller.d.ts

@@ -1,24 +0,0 @@
-import type { ContentTypeRegistry } from '../../registry/content-type-registry';
-import { EntriesService } from '../../entries/infrastructure/queries/entries.service';
-import { ListEntriesQueryDto } from '../../entries/http/dto/list-entries-query.dto';
-import type { EntryListView } from '../../entries/types/entry-list-view';
-/**
- * `GET /api/v1/content/:typeName` — the external, **bearer-token**-authenticated
- * mirror of the admin's records list. Same generic pipeline
- * (`search`/`filter`/`sort`/pagination + relation filtering), same
- * `{ items, total, page, pageSize }` envelope — the only difference is the
- * caller: an API token instead of a session.
- *
- * `@Public()` opts the route out of the app-wide session `AuthGuard` so
- * {@link ApiTokenGuard} owns authentication; the guard authorizes the token's
- * scope against `content:read` and mirrors the token's workspace onto the
- * request, so `@CurrentWorkspace()` scopes the query exactly as the admin
- * routes do — a token can never read another workspace's entries.
- */
-export declare class ListPublicEntriesController {
-    private readonly registry;
-    private readonly entries;
-    constructor(registry: ContentTypeRegistry, entries: EntriesService);
-    list(typeName: string, query: ListEntriesQueryDto, workspaceId: string): Promise<EntryListView>;
-}
-//# sourceMappingURL=list-public-entries.controller.d.ts.map

package/dist/lib/public/controllers/list-public-entries.controller.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"list-public-entries.controller.d.ts","sourceRoot":"","sources":["../../../../src/lib/public/controllers/list-public-entries.controller.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,sDAAsD,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAC;AAEpF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEzE;;;;;;;;;;;;GAYG;AACH,qBAIa,2BAA2B;IAGhC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,EAAE,cAAc;IAI5C,IAAI,CACmB,QAAQ,EAAE,MAAM,EAC1B,KAAK,EAAE,mBAAmB,EACf,WAAW,EAAE,MAAM,GACxC,OAAO,CAAC,aAAa,CAAC;CAI5B"}

package/dist/lib/public/controllers/public-schema.controller.d.ts

@@ -1,18 +0,0 @@
-import type { ContentTypeRegistry, SerializedContentType, SerializedContentTypeSummary } from '../../registry/content-type-registry';
-/**
- * `GET /api/v1/content-schema[/:name]` — schema discovery for the external API,
- * so a developer can enumerate the available content types (collections +
- * pages) and read one type's full field list before querying it. Same registry
- * projection the admin schema routes serve, behind the bearer-token guard on
- * `content:read`. Schema is not workspace-specific — the types are code-defined
- * — but access still requires a valid token.
- */
-export declare class PublicSchemaController {
-    private readonly registry;
-    constructor(registry: ContentTypeRegistry);
-    /** Summaries of every content type. */
-    list(): SerializedContentTypeSummary[];
-    /** One type's full field schema (404 if unknown). */
-    get(name: string): SerializedContentType;
-}
-//# sourceMappingURL=public-schema.controller.d.ts.map

package/dist/lib/public/controllers/public-schema.controller.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"public-schema.controller.d.ts","sourceRoot":"","sources":["../../../../src/lib/public/controllers/public-schema.controller.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACR,mBAAmB,EACnB,qBAAqB,EACrB,4BAA4B,EAC/B,MAAM,sCAAsC,CAAC;AAE9C;;;;;;;GAOG;AACH,qBAIa,sBAAsB;IAG3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,mBAAmB;IAGlD,uCAAuC;IAEvC,IAAI,IAAI,4BAA4B,EAAE;IAItC,qDAAqD;IAErD,GAAG,CAAgB,IAAI,EAAE,MAAM,GAAG,qBAAqB;CAO1D"}