@orthacms/content-server 0.0.0-reserve.0

package/dist/lib/revisions/application/use-cases/restore-revision.use-case.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RestoreRevisionUseCase = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const fields_1 = require("../../../types/fields");
+const entry_writer_service_1 = require("../../../entries/infrastructure/persistence/entry-writer.service");
+const revision_store_1 = require("../ports/revision-store");
+/**
+ * Restore an entry to an earlier revision. History is **append-only** — a
+ * restore never rewrites or deletes past versions: it applies the chosen
+ * snapshot back onto the live row through the normal save path, which in turn
+ * records the restore as a **new** draft revision (so v5 restoring v2 yields a
+ * fresh v6 equal to v2). The snapshot's `values` (scalars, localized + shared
+ * fields, single-relation FKs) and its owning many-to-many link sets are
+ * re-applied; inverse relations mirror their owning side and aren't written from
+ * here.
+ */
+let RestoreRevisionUseCase = class RestoreRevisionUseCase {
+    writer;
+    store;
+    constructor(writer, store) {
+        this.writer = writer;
+        this.store = store;
+    }
+    async execute(type, id, number, workspaceId, 
+    /**
+     * The acting user — stamped on the new revision and on the
+     * `entry.updated` event the underlying save raises, so a restore is
+     * attributable in the audit log like any other edit.
+     */
+    actor, options) {
+        const detail = await this.store.get(type.name, id, workspaceId, number);
+        if (!detail) {
+            throw new common_1.NotFoundException(`No revision #${number} for entry "${id}" on "${type.name}".`);
+        }
+        // Merge the snapshot's owning many-to-many link sets into the values bag
+        // so the writer's whole-set `writeLinks` re-applies them; single FKs and
+        // scalar/localized values already ride `values`.
+        const values = { ...detail.snapshot.values };
+        for (const [field, ids] of Object.entries(detail.snapshot.relations)) {
+            const spec = type.fields[field];
+            if (spec?.type === fields_1.CONTENT_FIELD_TYPE.Relation &&
+                spec.relation?.many &&
+                !spec.relation.inverse) {
+                values[field] = ids;
+            }
+        }
+        return this.writer.update(type, id, values, workspaceId, undefined, actor, options);
+    }
+};
+exports.RestoreRevisionUseCase = RestoreRevisionUseCase;
+exports.RestoreRevisionUseCase = RestoreRevisionUseCase = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__param(1, (0, revision_store_1.InjectRevisionStore)()),
+    tslib_1.__metadata("design:paramtypes", [entry_writer_service_1.EntryWriterService, Object])
+], RestoreRevisionUseCase);

package/dist/lib/revisions/domain/revision-status.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The lifecycle state of a single revision. Distinct from an entry's
+ * `draft ↔ published` status (`@orthacms/content-domain`): that describes the
+ * live row, this describes one version in its history.
+ *
+ * - `draft` — a saved version that is not (yet) live.
+ * - `published` — the version currently promoted to the live row. At most one
+ *   per `entry_id`.
+ * - `superseded` — a previously-published version that a later publish replaced.
+ */
+export declare const REVISION_STATUS: {
+    readonly Draft: "draft";
+    readonly Published: "published";
+    readonly Superseded: "superseded";
+};
+/** A revision's lifecycle state. */
+export type RevisionStatus = (typeof REVISION_STATUS)[keyof typeof REVISION_STATUS];
+//# sourceMappingURL=revision-status.d.ts.map

package/dist/lib/revisions/domain/revision-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revision-status.d.ts","sourceRoot":"","sources":["../../../../src/lib/revisions/domain/revision-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe;;;;CAIlB,CAAC;AAEX,oCAAoC;AACpC,MAAM,MAAM,cAAc,GACtB,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC"}

package/dist/lib/revisions/domain/revision-status.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REVISION_STATUS = void 0;
+/**
+ * The lifecycle state of a single revision. Distinct from an entry's
+ * `draft ↔ published` status (`@orthacms/content-domain`): that describes the
+ * live row, this describes one version in its history.
+ *
+ * - `draft` — a saved version that is not (yet) live.
+ * - `published` — the version currently promoted to the live row. At most one
+ *   per `entry_id`.
+ * - `superseded` — a previously-published version that a later publish replaced.
+ */
+exports.REVISION_STATUS = {
+    Draft: 'draft',
+    Published: 'published',
+    Superseded: 'superseded'
+};

package/dist/lib/revisions/domain/revision.d.ts

@@ -0,0 +1,80 @@
+import { type RevisionStatus } from './revision-status';
+import type { RevisionSnapshot } from '../types/revision-view';
+/** The data a new revision is minted from — everything but the store-owned id. */
+export interface NewRevisionParams {
+    /** The registry content-type machine name. */
+    contentType: string;
+    /** The live `content_<name>` row (per-locale) the revision belongs to. */
+    entryId: string;
+    /** Owning workspace. */
+    workspaceId: string;
+    /** Translation-group id — null on non-i18n types. */
+    localeGroupId: string | null;
+    /** The row's locale — null on non-i18n types. */
+    locale: string | null;
+    /** Monotonic version number within the entry (allocated by the store). */
+    number: number;
+    /** The captured document. */
+    snapshot: RevisionSnapshot;
+    /** The acting user's id, or null when unknown. */
+    createdBy: string | null;
+}
+/**
+ * The **focused domain model** for a content revision. Like {@link Entry}, the
+ * revision engine is generic and registry-driven — one store backs every content
+ * type — so this models the small piece with real invariants (a new revision is
+ * always born a `draft`, carrying a complete snapshot) and leaves the heavy
+ * persistence to the infrastructure store.
+ *
+ * Framework-free (ADR-0003's one hard rule): imports nothing from `@nestjs/*`,
+ * `drizzle-orm`, `class-validator`, or the infrastructure layer — only sibling
+ * domain types.
+ *
+ * Event emission (`entry.revision.created`) is intentionally deferred: Phase-1
+ * snapshotting runs inside the `EntryWriterService` save transaction, not the
+ * `UnitOfWork`, so there is no atomic outbox to append to yet — the same reason
+ * `entry.created`/`entry.updated` are still unemitted (see content-server
+ * `AGENTS.md`). The model stays event-ready for when those writes move onto the
+ * `UnitOfWork`.
+ */
+export declare class Revision {
+    private readonly _contentType;
+    private readonly _entryId;
+    private readonly _workspaceId;
+    private readonly _localeGroupId;
+    private readonly _locale;
+    private readonly _number;
+    private readonly _status;
+    private readonly _snapshot;
+    private readonly _createdBy;
+    private constructor();
+    /**
+     * Mint a new **draft** revision from a just-saved document. A revision is
+     * never born published: publishing is a separate, deliberate transition that
+     * promotes the entry's latest draft to `published`
+     * (`RevisionStore.markPublished`, driven by the publish use-case), and a
+     * restore appends a fresh draft rather than rewriting history.
+     */
+    static createDraft(params: NewRevisionParams): Revision;
+    /** The version number within the entry. */
+    get number(): number;
+    /** The lifecycle state (always `draft` for a freshly-created revision). */
+    get status(): RevisionStatus;
+    /**
+     * The row to insert — the store adds only the DB-defaulted `id`/`created_at`.
+     * Kept here so the persisted shape and the invariants that produced it stay
+     * in one place.
+     */
+    toPersistence(): {
+        contentType: string;
+        entryId: string;
+        workspaceId: string;
+        localeGroupId: string | null;
+        locale: string | null;
+        revisionNumber: number;
+        status: RevisionStatus;
+        snapshot: RevisionSnapshot;
+        createdBy: string | null;
+    };
+}
+//# sourceMappingURL=revision.d.ts.map

package/dist/lib/revisions/domain/revision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revision.d.ts","sourceRoot":"","sources":["../../../../src/lib/revisions/domain/revision.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,kFAAkF;AAClF,MAAM,WAAW,iBAAiB;IAC9B,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iDAAiD;IACjD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,kDAAkD;IAClD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,QAAQ;IAEb,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAT/B,OAAO;IAYP;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,QAAQ;IAmBvD,2CAA2C;IAC3C,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,2EAA2E;IAC3E,IAAI,MAAM,IAAI,cAAc,CAE3B;IAED;;;;OAIG;IACH,aAAa,IAAI;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,MAAM,EAAE,cAAc,CAAC;QACvB,QAAQ,EAAE,gBAAgB,CAAC;QAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B;CAaJ"}

package/dist/lib/revisions/domain/revision.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Revision = void 0;
+const revision_status_1 = require("./revision-status");
+/**
+ * The **focused domain model** for a content revision. Like {@link Entry}, the
+ * revision engine is generic and registry-driven — one store backs every content
+ * type — so this models the small piece with real invariants (a new revision is
+ * always born a `draft`, carrying a complete snapshot) and leaves the heavy
+ * persistence to the infrastructure store.
+ *
+ * Framework-free (ADR-0003's one hard rule): imports nothing from `@nestjs/*`,
+ * `drizzle-orm`, `class-validator`, or the infrastructure layer — only sibling
+ * domain types.
+ *
+ * Event emission (`entry.revision.created`) is intentionally deferred: Phase-1
+ * snapshotting runs inside the `EntryWriterService` save transaction, not the
+ * `UnitOfWork`, so there is no atomic outbox to append to yet — the same reason
+ * `entry.created`/`entry.updated` are still unemitted (see content-server
+ * `AGENTS.md`). The model stays event-ready for when those writes move onto the
+ * `UnitOfWork`.
+ */
+class Revision {
+    _contentType;
+    _entryId;
+    _workspaceId;
+    _localeGroupId;
+    _locale;
+    _number;
+    _status;
+    _snapshot;
+    _createdBy;
+    constructor(_contentType, _entryId, _workspaceId, _localeGroupId, _locale, _number, _status, _snapshot, _createdBy) {
+        this._contentType = _contentType;
+        this._entryId = _entryId;
+        this._workspaceId = _workspaceId;
+        this._localeGroupId = _localeGroupId;
+        this._locale = _locale;
+        this._number = _number;
+        this._status = _status;
+        this._snapshot = _snapshot;
+        this._createdBy = _createdBy;
+    }
+    /**
+     * Mint a new **draft** revision from a just-saved document. A revision is
+     * never born published: publishing is a separate, deliberate transition that
+     * promotes the entry's latest draft to `published`
+     * (`RevisionStore.markPublished`, driven by the publish use-case), and a
+     * restore appends a fresh draft rather than rewriting history.
+     */
+    static createDraft(params) {
+        if (!Number.isInteger(params.number) || params.number < 1) {
+            throw new Error(`Revision number must be a positive integer, got ${params.number}.`);
+        }
+        return new Revision(params.contentType, params.entryId, params.workspaceId, params.localeGroupId, params.locale, params.number, revision_status_1.REVISION_STATUS.Draft, params.snapshot, params.createdBy);
+    }
+    /** The version number within the entry. */
+    get number() {
+        return this._number;
+    }
+    /** The lifecycle state (always `draft` for a freshly-created revision). */
+    get status() {
+        return this._status;
+    }
+    /**
+     * The row to insert — the store adds only the DB-defaulted `id`/`created_at`.
+     * Kept here so the persisted shape and the invariants that produced it stay
+     * in one place.
+     */
+    toPersistence() {
+        return {
+            contentType: this._contentType,
+            entryId: this._entryId,
+            workspaceId: this._workspaceId,
+            localeGroupId: this._localeGroupId,
+            locale: this._locale,
+            revisionNumber: this._number,
+            status: this._status,
+            snapshot: this._snapshot,
+            createdBy: this._createdBy
+        };
+    }
+}
+exports.Revision = Revision;

package/dist/lib/revisions/http/controllers/publish-revision.controller.d.ts

@@ -0,0 +1,19 @@
+import { type PublicUser } from '@orthacms/identity-server';
+import type { ContentTypeRegistry } from '../../../registry/content-type-registry';
+import type { EntryRecord } from '../../../entries/types/entry-list-view';
+import { PublishRevisionUseCase } from '../../application/use-cases/publish-revision.use-case';
+/**
+ * `POST /api/content/:typeName/:id/revisions/:number/publish` — make a specific
+ * version the entry's **live** one. The newest version publishes in place; an
+ * earlier one is restored (as a new revision) then published, so history stays
+ * append-only. `OriginGuard` defends the write; `WorkspaceGuard` scopes it;
+ * `content:publish` gates it. `400` on a non-publishable type, `404` on an
+ * absent version, `422 { issues }` when the version fails the publish gate.
+ */
+export declare class PublishRevisionController {
+    private readonly registry;
+    private readonly publishRevision;
+    constructor(registry: ContentTypeRegistry, publishRevision: PublishRevisionUseCase);
+    publish(typeName: string, id: string, number: number, workspaceId: string, user?: PublicUser): Promise<EntryRecord>;
+}
+//# sourceMappingURL=publish-revision.controller.d.ts.map

package/dist/lib/revisions/http/controllers/publish-revision.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish-revision.controller.d.ts","sourceRoot":"","sources":["../../../../../src/lib/revisions/http/controllers/publish-revision.controller.ts"],"names":[],"mappings":"AAQA,OAAO,EAKH,KAAK,UAAU,EAElB,MAAM,2BAA2B,CAAC;AAInC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAGnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uDAAuD,CAAC;AAE/F;;;;;;;GAOG;AACH,qBAGa,yBAAyB;IAG9B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,eAAe;gBADf,QAAQ,EAAE,mBAAmB,EAC7B,eAAe,EAAE,sBAAsB;IAI5D,OAAO,CACgB,QAAQ,EAAE,MAAM,EACP,EAAE,EAAE,MAAM,EACP,MAAM,EAAE,MAAM,EACzB,WAAW,EAAE,MAAM,EACxB,IAAI,CAAC,EAAE,UAAU,GACjC,OAAO,CAAC,WAAW,CAAC;CAU1B"}

package/dist/lib/revisions/http/controllers/publish-revision.controller.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PublishRevisionController = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const identity_server_1 = require("@orthacms/identity-server");
+const workspaces_server_1 = require("@orthacms/workspaces-server");
+const content_grant_guard_1 = require("../../../entries/http/guards/content-grant.guard");
+const content_tokens_1 = require("../../../content.tokens");
+const resolve_type_1 = require("../../../entries/http/controllers/resolve-type");
+const to_actor_1 = require("../../../entries/http/controllers/to-actor");
+const publish_revision_use_case_1 = require("../../application/use-cases/publish-revision.use-case");
+/**
+ * `POST /api/content/:typeName/:id/revisions/:number/publish` — make a specific
+ * version the entry's **live** one. The newest version publishes in place; an
+ * earlier one is restored (as a new revision) then published, so history stays
+ * append-only. `OriginGuard` defends the write; `WorkspaceGuard` scopes it;
+ * `content:publish` gates it. `400` on a non-publishable type, `404` on an
+ * absent version, `422 { issues }` when the version fails the publish gate.
+ */
+let PublishRevisionController = class PublishRevisionController {
+    registry;
+    publishRevision;
+    constructor(registry, publishRevision) {
+        this.registry = registry;
+        this.publishRevision = publishRevision;
+    }
+    publish(typeName, id, number, workspaceId, user) {
+        const type = (0, resolve_type_1.resolveType)(this.registry, typeName);
+        return this.publishRevision.execute(type, id, number, workspaceId, (0, to_actor_1.toActor)(user) ?? null);
+    }
+};
+exports.PublishRevisionController = PublishRevisionController;
+tslib_1.__decorate([
+    (0, common_1.Post)(':typeName/:id/revisions/:number/publish'),
+    tslib_1.__param(0, (0, common_1.Param)('typeName')),
+    tslib_1.__param(1, (0, common_1.Param)('id', common_1.ParseUUIDPipe)),
+    tslib_1.__param(2, (0, common_1.Param)('number', common_1.ParseIntPipe)),
+    tslib_1.__param(3, (0, workspaces_server_1.CurrentWorkspace)()),
+    tslib_1.__param(4, (0, identity_server_1.CurrentUser)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String, Number, String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], PublishRevisionController.prototype, "publish", null);
+exports.PublishRevisionController = PublishRevisionController = tslib_1.__decorate([
+    (0, common_1.UseGuards)(identity_server_1.OriginGuard, identity_server_1.PermissionsGuard, workspaces_server_1.WorkspaceGuard, content_grant_guard_1.ContentGrantGuard),
+    (0, identity_server_1.RequirePermissions)(identity_server_1.PERMISSIONS.CONTENT_PUBLISH),
+    (0, common_1.Controller)('content'),
+    tslib_1.__param(0, (0, content_tokens_1.InjectContentRegistry)()),
+    tslib_1.__metadata("design:paramtypes", [Function, publish_revision_use_case_1.PublishRevisionUseCase])
+], PublishRevisionController);

package/dist/lib/revisions/http/controllers/restore-revision.controller.d.ts

@@ -0,0 +1,17 @@
+import { type PublicUser } from '@orthacms/identity-server';
+import type { ContentTypeRegistry } from '../../../registry/content-type-registry';
+import type { EntryRecord } from '../../../entries/types/entry-list-view';
+import { RestoreRevisionUseCase } from '../../application/use-cases/restore-revision.use-case';
+/**
+ * `POST /api/content/:typeName/:id/revisions/:number/restore` — re-apply an
+ * earlier version onto the live entry. History is append-only: the restore is
+ * itself saved as a new revision. `OriginGuard` defends the write;
+ * `WorkspaceGuard` scopes it; `content:update` gates it (restoring is an edit).
+ */
+export declare class RestoreRevisionController {
+    private readonly registry;
+    private readonly restoreRevision;
+    constructor(registry: ContentTypeRegistry, restoreRevision: RestoreRevisionUseCase);
+    restore(typeName: string, id: string, number: number, workspaceId: string, user?: PublicUser): Promise<EntryRecord>;
+}
+//# sourceMappingURL=restore-revision.controller.d.ts.map

package/dist/lib/revisions/http/controllers/restore-revision.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore-revision.controller.d.ts","sourceRoot":"","sources":["../../../../../src/lib/revisions/http/controllers/restore-revision.controller.ts"],"names":[],"mappings":"AAQA,OAAO,EAKH,KAAK,UAAU,EAElB,MAAM,2BAA2B,CAAC;AAInC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAGnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uDAAuD,CAAC;AAE/F;;;;;GAKG;AACH,qBAGa,yBAAyB;IAG9B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,eAAe;gBADf,QAAQ,EAAE,mBAAmB,EAC7B,eAAe,EAAE,sBAAsB;IAI5D,OAAO,CACgB,QAAQ,EAAE,MAAM,EACP,EAAE,EAAE,MAAM,EACP,MAAM,EAAE,MAAM,EACzB,WAAW,EAAE,MAAM,EACxB,IAAI,CAAC,EAAE,UAAU,GACjC,OAAO,CAAC,WAAW,CAAC;CAU1B"}

package/dist/lib/revisions/http/controllers/restore-revision.controller.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RestoreRevisionController = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const identity_server_1 = require("@orthacms/identity-server");
+const workspaces_server_1 = require("@orthacms/workspaces-server");
+const content_grant_guard_1 = require("../../../entries/http/guards/content-grant.guard");
+const content_tokens_1 = require("../../../content.tokens");
+const resolve_type_1 = require("../../../entries/http/controllers/resolve-type");
+const to_actor_1 = require("../../../entries/http/controllers/to-actor");
+const restore_revision_use_case_1 = require("../../application/use-cases/restore-revision.use-case");
+/**
+ * `POST /api/content/:typeName/:id/revisions/:number/restore` — re-apply an
+ * earlier version onto the live entry. History is append-only: the restore is
+ * itself saved as a new revision. `OriginGuard` defends the write;
+ * `WorkspaceGuard` scopes it; `content:update` gates it (restoring is an edit).
+ */
+let RestoreRevisionController = class RestoreRevisionController {
+    registry;
+    restoreRevision;
+    constructor(registry, restoreRevision) {
+        this.registry = registry;
+        this.restoreRevision = restoreRevision;
+    }
+    restore(typeName, id, number, workspaceId, user) {
+        const type = (0, resolve_type_1.resolveType)(this.registry, typeName);
+        return this.restoreRevision.execute(type, id, number, workspaceId, (0, to_actor_1.toActor)(user) ?? null);
+    }
+};
+exports.RestoreRevisionController = RestoreRevisionController;
+tslib_1.__decorate([
+    (0, common_1.Post)(':typeName/:id/revisions/:number/restore'),
+    tslib_1.__param(0, (0, common_1.Param)('typeName')),
+    tslib_1.__param(1, (0, common_1.Param)('id', common_1.ParseUUIDPipe)),
+    tslib_1.__param(2, (0, common_1.Param)('number', common_1.ParseIntPipe)),
+    tslib_1.__param(3, (0, workspaces_server_1.CurrentWorkspace)()),
+    tslib_1.__param(4, (0, identity_server_1.CurrentUser)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String, Number, String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], RestoreRevisionController.prototype, "restore", null);
+exports.RestoreRevisionController = RestoreRevisionController = tslib_1.__decorate([
+    (0, common_1.UseGuards)(identity_server_1.OriginGuard, identity_server_1.PermissionsGuard, workspaces_server_1.WorkspaceGuard, content_grant_guard_1.ContentGrantGuard),
+    (0, identity_server_1.RequirePermissions)(identity_server_1.PERMISSIONS.CONTENT_UPDATE),
+    (0, common_1.Controller)('content'),
+    tslib_1.__param(0, (0, content_tokens_1.InjectContentRegistry)()),
+    tslib_1.__metadata("design:paramtypes", [Function, restore_revision_use_case_1.RestoreRevisionUseCase])
+], RestoreRevisionController);

package/dist/lib/revisions/http/controllers/revisions.controller.d.ts

@@ -0,0 +1,20 @@
+import type { ContentTypeRegistry } from '../../../registry/content-type-registry';
+import { type RevisionStore } from '../../application/ports/revision-store';
+import type { RevisionDetail, RevisionListView } from '../../types/revision-view';
+import { RevisionRefsQuery } from '../../infrastructure/queries/revision-refs.query';
+/**
+ * `GET /api/content/:typeName/:id/revisions` — the version timeline of one entry
+ * (newest first, paginated), and `.../revisions/:number` — one version with its
+ * full snapshot (for preview / restore). Both scoped to a workspace the caller
+ * belongs to and gated on `content:read`; a 404 on an unknown type or an
+ * absent version.
+ */
+export declare class RevisionsController {
+    private readonly registry;
+    private readonly revisions;
+    private readonly refs;
+    constructor(registry: ContentTypeRegistry, revisions: RevisionStore, refs: RevisionRefsQuery);
+    list(typeName: string, id: string, workspaceId: string, page?: string, pageSize?: string): Promise<RevisionListView>;
+    get(typeName: string, id: string, number: number, workspaceId: string): Promise<RevisionDetail>;
+}
+//# sourceMappingURL=revisions.controller.d.ts.map

package/dist/lib/revisions/http/controllers/revisions.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revisions.controller.d.ts","sourceRoot":"","sources":["../../../../../src/lib/revisions/http/controllers/revisions.controller.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAEnF,OAAO,EAEH,KAAK,aAAa,EACrB,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EACR,cAAc,EACd,gBAAgB,EACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AAGrF;;;;;;GAMG;AACH,qBAGa,mBAAmB;IAGxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACF,OAAO,CAAC,QAAQ,CAAC,SAAS;IACjD,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAFJ,QAAQ,EAAE,mBAAmB,EACN,SAAS,EAAE,aAAa,EAC/C,IAAI,EAAE,iBAAiB;IAI5C,IAAI,CACmB,QAAQ,EAAE,MAAM,EACP,EAAE,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACxB,IAAI,CAAC,EAAE,MAAM,EACT,QAAQ,CAAC,EAAE,MAAM,GACrC,OAAO,CAAC,gBAAgB,CAAC;IAYtB,GAAG,CACc,QAAQ,EAAE,MAAM,EACP,EAAE,EAAE,MAAM,EACP,MAAM,EAAE,MAAM,EACzB,WAAW,EAAE,MAAM,GACxC,OAAO,CAAC,cAAc,CAAC;CAiB7B"}

package/dist/lib/revisions/http/controllers/revisions.controller.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RevisionsController = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const identity_server_1 = require("@orthacms/identity-server");
+const workspaces_server_1 = require("@orthacms/workspaces-server");
+const content_grant_guard_1 = require("../../../entries/http/guards/content-grant.guard");
+const utils_server_1 = require("@orthacms/utils-server");
+const entries_constants_1 = require("../../../entries/entries.constants");
+const content_tokens_1 = require("../../../content.tokens");
+const resolve_type_1 = require("../../../entries/http/controllers/resolve-type");
+const revision_store_1 = require("../../application/ports/revision-store");
+const revision_refs_query_1 = require("../../infrastructure/queries/revision-refs.query");
+const revisions_constants_1 = require("../../revisions.constants");
+/**
+ * `GET /api/content/:typeName/:id/revisions` — the version timeline of one entry
+ * (newest first, paginated), and `.../revisions/:number` — one version with its
+ * full snapshot (for preview / restore). Both scoped to a workspace the caller
+ * belongs to and gated on `content:read`; a 404 on an unknown type or an
+ * absent version.
+ */
+let RevisionsController = class RevisionsController {
+    registry;
+    revisions;
+    refs;
+    constructor(registry, revisions, refs) {
+        this.registry = registry;
+        this.revisions = revisions;
+        this.refs = refs;
+    }
+    list(typeName, id, workspaceId, page, pageSize) {
+        const type = (0, resolve_type_1.resolveType)(this.registry, typeName);
+        return this.revisions.list(type.name, id, workspaceId, (0, utils_server_1.clampInt)(page, 1, 1, Number.MAX_SAFE_INTEGER), (0, utils_server_1.clampInt)(pageSize, revisions_constants_1.REVISIONS_PAGE_SIZE, 1, entries_constants_1.MAX_PAGE_SIZE));
+    }
+    async get(typeName, id, number, workspaceId) {
+        const type = (0, resolve_type_1.resolveType)(this.registry, typeName);
+        const detail = await this.revisions.get(type.name, id, workspaceId, number);
+        if (!detail) {
+            throw new common_1.NotFoundException(`No revision #${number} for entry "${id}".`);
+        }
+        // Resolve the snapshot's relation ids to display refs so the preview can
+        // list the actual linked records, not raw uuids.
+        return this.refs.enrich(type, detail, workspaceId);
+    }
+};
+exports.RevisionsController = RevisionsController;
+tslib_1.__decorate([
+    (0, common_1.Get)(':typeName/:id/revisions'),
+    tslib_1.__param(0, (0, common_1.Param)('typeName')),
+    tslib_1.__param(1, (0, common_1.Param)('id', common_1.ParseUUIDPipe)),
+    tslib_1.__param(2, (0, workspaces_server_1.CurrentWorkspace)()),
+    tslib_1.__param(3, (0, common_1.Query)('page')),
+    tslib_1.__param(4, (0, common_1.Query)('pageSize')),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String, String, String, String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], RevisionsController.prototype, "list", null);
+tslib_1.__decorate([
+    (0, common_1.Get)(':typeName/:id/revisions/:number'),
+    tslib_1.__param(0, (0, common_1.Param)('typeName')),
+    tslib_1.__param(1, (0, common_1.Param)('id', common_1.ParseUUIDPipe)),
+    tslib_1.__param(2, (0, common_1.Param)('number', common_1.ParseIntPipe)),
+    tslib_1.__param(3, (0, workspaces_server_1.CurrentWorkspace)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String, Number, String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], RevisionsController.prototype, "get", null);
+exports.RevisionsController = RevisionsController = tslib_1.__decorate([
+    (0, common_1.UseGuards)(identity_server_1.PermissionsGuard, workspaces_server_1.WorkspaceGuard, content_grant_guard_1.ContentGrantGuard),
+    (0, identity_server_1.RequirePermissions)(identity_server_1.PERMISSIONS.CONTENT_READ),
+    (0, common_1.Controller)('content'),
+    tslib_1.__param(0, (0, content_tokens_1.InjectContentRegistry)()),
+    tslib_1.__param(1, (0, revision_store_1.InjectRevisionStore)()),
+    tslib_1.__metadata("design:paramtypes", [Function, Object, revision_refs_query_1.RevisionRefsQuery])
+], RevisionsController);

package/dist/lib/revisions/infrastructure/persistence/drizzle-revision.store.d.ts

@@ -0,0 +1,33 @@
+import { type Database } from '@orthacms/database';
+import type { RevisionExecutor, RevisionStore } from '../../application/ports/revision-store';
+import type { Revision } from '../../domain/revision';
+import type { RevisionDetail, RevisionListView, RevisionSummary } from '../../types/revision-view';
+/**
+ * The Drizzle-backed {@link RevisionStore}. Writes are executor-parameterized so
+ * a snapshot commits atomically with the save it records (via the
+ * `EntryWriterService` transaction); reads run on the base connection.
+ */
+export declare class DrizzleRevisionStore implements RevisionStore {
+    private readonly db;
+    constructor(db: Database);
+    lockEntry(exec: RevisionExecutor, entryId: string): Promise<void>;
+    nextNumber(exec: RevisionExecutor, entryId: string): Promise<number>;
+    append(exec: RevisionExecutor, revision: Revision): Promise<RevisionSummary>;
+    markPublished(exec: RevisionExecutor, entryId: string, workspaceId: string, revisionNumber?: number): Promise<void>;
+    markUnpublished(exec: RevisionExecutor, entryId: string, workspaceId: string): Promise<void>;
+    list(contentType: string, entryId: string, workspaceId: string, page: number, pageSize: number): Promise<RevisionListView>;
+    get(contentType: string, entryId: string, workspaceId: string, number: number): Promise<RevisionDetail | undefined>;
+    /** The highest version number for an entry, or 0 if it has no revisions. */
+    private latestNumber;
+    /**
+     * The read scope every timeline query shares: one entry, in one workspace,
+     * **of one content type**. All types share `content_entry_revisions`, and
+     * the routes address an entry as `:typeName/:id` — so leaving the type out
+     * means the `:typeName` in the URL is never checked against the revision it
+     * returns, and any registered type name serves any entry's history.
+     */
+    private scope;
+    /** Map a row to the metadata view, deriving the `isLatest`/`isPublished` flags. */
+    private toSummary;
+}
+//# sourceMappingURL=drizzle-revision.store.d.ts.map

package/dist/lib/revisions/infrastructure/persistence/drizzle-revision.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle-revision.store.d.ts","sourceRoot":"","sources":["../../../../../src/lib/revisions/infrastructure/persistence/drizzle-revision.store.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,KAAK,EACR,gBAAgB,EAChB,aAAa,EAChB,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD,OAAO,KAAK,EACR,cAAc,EACd,gBAAgB,EAEhB,eAAe,EAClB,MAAM,2BAA2B,CAAC;AAanC;;;;GAIG;AACH,qBACa,oBAAqB,YAAW,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ;IAErD,SAAS,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjE,UAAU,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASpE,MAAM,CACR,IAAI,EAAE,gBAAgB,EACtB,QAAQ,EAAE,QAAQ,GACnB,OAAO,CAAC,eAAe,CAAC;IAuBrB,aAAa,CACf,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,cAAc,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC;IAyCV,eAAe,CACjB,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC;IAaV,IAAI,CACN,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,CAAC;IAsBtB,GAAG,CACL,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAsBtC,4EAA4E;YAC9D,YAAY;IAY1B;;;;;;OAMG;IACH,OAAO,CAAC,KAAK;IAQb,mFAAmF;IACnF,OAAO,CAAC,SAAS;CAkBpB"}