@forge-cms/runtime 0.4.0 → 0.6.0

package/dist/system-fields.js

@@ -0,0 +1,74 @@
+import { InvalidInputError } from './errors.js';
+/**
+ * Forge-owned document metadata (spec 063): never content, never written through the CMS mutation
+ * pipeline by a caller or a hook. `_status` is deliberately absent — on a `drafts: true` collection it
+ * is lifecycle input and stays writable. Raw `DatabaseAdapter` writes are outside this boundary.
+ */
+export const FORGE_OWNED_KEYS = [
+    'id',
+    'created_at',
+    'updated_at',
+    '_storageKey'
+];
+/** `null` and absent are the same stored value — echoing a missing key back as `null` is a no-op. */
+function sameValue(a, b) {
+    return (a ?? null) === (b ?? null);
+}
+/**
+ * Returns `data` without the Forge-owned keys that merely echo `stored` (the document as it is — `{}`
+ * for a document that does not exist yet), calling `reject(key)` for any other value. An echo is a
+ * no-op, so a client round-tripping the document it read keeps working; a changed value is a write
+ * attempt and is refused rather than silently stripped.
+ */
+function screen(data, stored, reject) {
+    let screened = data;
+    for (const key of FORGE_OWNED_KEYS) {
+        if (!Object.hasOwn(data, key))
+            continue;
+        if (!sameValue(data[key], stored[key]))
+            throw reject(key);
+        if (screened === data)
+            screened = { ...data };
+        delete screened[key];
+    }
+    return screened;
+}
+function callerRejection(key) {
+    return new InvalidInputError(`Field '${key}' is managed by Forge and cannot be written`);
+}
+/**
+ * The caller-input screen for an update (or an update-mode preview / an existing global): echoes of
+ * `existing` are dropped, any other Forge-owned value is a `400`.
+ */
+export function screenUpdateInput(data, existing) {
+    return screen(data, existing, callerRejection);
+}
+/**
+ * The caller-input screen for a create. A trusted caller (`overrideAccess` not `false`) may choose the
+ * new document's `id` — a non-empty string, returned separately so hooks never see or change it; every
+ * other Forge-owned key (and an untrusted caller's `id`) is a `400`.
+ */
+export function screenCreateInput(data, trusted) {
+    const { id, ...rest } = data;
+    if (id !== undefined && id !== null) {
+        if (!trusted)
+            throw callerRejection('id');
+        if (typeof id !== 'string' || id === '') {
+            throw new InvalidInputError(`Field 'id' must be a non-empty string`);
+        }
+    }
+    return {
+        content: screen(rest, {}, callerRejection),
+        id: typeof id === 'string' ? id : undefined
+    };
+}
+/**
+ * Screens what a hook stage returned: hooks may change content and `_status`, never Forge-owned
+ * metadata. Echoes of `stored` (e.g. a hook returning `{ ...previousData, ...data }`) are dropped; any
+ * other value is a server-code bug, reported as a plain `Error` (500) rather than the caller's `400`.
+ */
+export function screenHookOutput(data, stored, stage, target) {
+    return screen(data, stored, (key) => new Error(`${stage} hook on '${target}' set the Forge-owned field '${key}'; hooks may only change ` +
+        `content fields and _status (spec 063)`));
+}
+//# 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":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAsB;IACjD,IAAI;IACJ,YAAY;IACZ,YAAY;IACZ,aAAa;CACd,CAAC;AAEF,qGAAqG;AACrG,SAAS,SAAS,CAAC,CAAU,EAAE,CAAU;IACvC,OAAO,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;AACrC,CAAC;AAED;;;;;GAKG;AACH,SAAS,MAAM,CACb,IAA6B,EAC7B,MAA+B,EAC/B,MAA8B;IAE9B,IAAI,QAAQ,GAAG,IAAI,CAAC;IACpB,KAAK,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC;YAAE,SAAS;QACxC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;YAAE,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1D,IAAI,QAAQ,KAAK,IAAI;YAAE,QAAQ,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;QAC9C,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,eAAe,CAAC,GAAW;IAClC,OAAO,IAAI,iBAAiB,CAAC,UAAU,GAAG,6CAA6C,CAAC,CAAC;AAC3F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAA6B,EAC7B,QAAiC;IAEjC,OAAO,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAA6B,EAC7B,OAAgB;IAEhB,MAAM,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;QACpC,IAAI,CAAC,OAAO;YAAE,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACxC,MAAM,IAAI,iBAAiB,CAAC,uCAAuC,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IACD,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,eAAe,CAAC;QAC1C,EAAE,EAAE,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;KAC5C,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAA6B,EAC7B,MAA+B,EAC/B,KAAa,EACb,MAAc;IAEd,OAAO,MAAM,CACX,IAAI,EACJ,MAAM,EACN,CAAC,GAAG,EAAE,EAAE,CACN,IAAI,KAAK,CACP,GAAG,KAAK,aAAa,MAAM,gCAAgC,GAAG,2BAA2B;QACvF,uCAAuC,CAC1C,CACJ,CAAC;AACJ,CAAC"}

package/dist/typed-api.d.ts

@@ -1,6 +1,6 @@
 import type { CollectionBySlug, CollectionDefinition, CollectionDocument, CollectionInput, CollectionRegistry, CollectionSlug } from '@forge-cms/core';
 import type { WhereCondition } from '@forge-cms/db';
-import type { CountArgs, CreateArgs, DeleteArgs, FindArgs, FindByIDArgs, FindOneArgs, PaginatedDocs, UpdateArgs } from './operations.js';
+import type { BaseOperationArgs, CountArgs, CreateArgs, DeleteArgs, FindArgs, FindByIDArgs, FindOneArgs, PaginatedDocs, UpdateArgs } from './operations.js';
 /**
  * The Local API generic arg/result wiring for the typed collection surface (`runtime.ts`). Kept in
  * one file, isolated from `operations.ts` (untyped, unchanged) and from the method bodies in
@@ -51,7 +51,7 @@ export type TypedUpdateArgs<TCollections extends CollectionRegistry, TSlug exten
 export type TypedDeleteArgs<TCollections extends CollectionRegistry, TSlug extends CollectionSlug<TCollections>> = Omit<DeleteArgs, 'collection'> & {
     collection: TSlug;
 };
-export type TypedPreviewArgs<TCollections extends CollectionRegistry, TSlug extends CollectionSlug<TCollections>> = {
+export type TypedPreviewArgs<TCollections extends CollectionRegistry, TSlug extends CollectionSlug<TCollections>> = Omit<BaseOperationArgs, 'collection' | 'depth' | 'locale'> & {
     collection: TSlug;
     data: CollectionInput<CollectionBySlug<TCollections, TSlug>>;
     id?: string;

package/dist/typed-api.d.ts.map

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

package/dist/versions.d.ts

@@ -1,5 +1,5 @@
 import type { CmsUser, CollectionDefinition, Version } from '@forge-cms/core';
-import type { DatabaseRecord } from '@forge-cms/db';
+import type { DatabaseAdapter, DatabaseRecord } from '@forge-cms/db';
 import type { OperationContext } from './context.js';
 export interface ListVersionsArgs {
     collection: string;
@@ -30,22 +30,92 @@ export interface CreateVersionArgs {
     label?: string;
 }
 declare function versionsEnabled(collection: CollectionDefinition): boolean;
+/**
+ * Whether `versions: { autosave: true }` is set. Nothing in the runtime acts on it today (spec 062 §11):
+ * automatic snapshots are always `autosave: false`; only a manual `createVersion({ autosave: true })`
+ * sets the flag.
+ */
 declare function autosaveEnabled(collection: CollectionDefinition): boolean;
 /**
  * Lists all versions of a document, newest first.
  */
 export declare function listVersions(ctx: OperationContext, args: ListVersionsArgs): Promise<Version[]>;
 /**
- * Gets a specific version by id.
+ * Gets a specific version by id. `overrideAccess: true` (the default, matching every other Local API
+ * method) returns the raw, unfiltered snapshot with no owner-visibility check — used internally by
+ * {@link import('./operations.js').restoreVersion}, where the authoritative access gate is the
+ * subsequent `update()` call, not this read.
  */
 export declare function getVersion(ctx: OperationContext, args: GetVersionArgs): Promise<Version>;
 /**
- * Restores a document to a specific version. Creates a new version with the restored data.
+ * Creates a version of a document by hand (trusted Local API only — there is no HTTP route). Stores
+ * `data` verbatim: no hooks, no access check, no check that the owner document still exists, and — since
+ * nothing guarantees the caller passed full content — the row is not marked as a full snapshot, so a
+ * restore of it only applies the fields it contains (spec 062 §7).
+ *
+ * The version number is `latest + 1`, made safe by the unique `(documentId, versionNumber)` index: when
+ * another writer takes that number first, the latest is re-read and the insert retried, at most
+ * {@link MAX_MANUAL_VERSION_ATTEMPTS} times in total, then {@link ConcurrentModificationError}. Retrying
+ * is safe here — and only here — because nothing but the number changes between attempts: no document
+ * write, no consumer code. Automatic snapshots are not created through this function; see
+ * `operations.ts`, which writes them in the same atomic batch as the document.
  */
-export declare function restoreVersion(ctx: OperationContext, args: RestoreVersionArgs): Promise<DatabaseRecord>;
+export declare function createVersion(ctx: OperationContext, args: CreateVersionArgs): Promise<Version>;
+export declare function versionsCollectionSlug(collectionSlug: string): string;
 /**
- * Creates a new version of a document. Called automatically on updates when versions are enabled.
+ * The internal collection that stores a versioned collection's history. The compound unique
+ * `(documentId, versionNumber)` index is the version-identity invariant every automatic write relies
+ * on for serialization (spec 062 §1/§3); `snapshotFormat` tells a full snapshot from a pre-062 patch.
  */
-export declare function createVersion(ctx: OperationContext, args: CreateVersionArgs): Promise<Version>;
+export declare function versionCollectionDefinition(collectionSlug: string): CollectionDefinition;
+/** Whether `err` is the version table's `(documentId, versionNumber)` unique index rejecting a write. */
+export declare function isVersionIdentityConflict(err: unknown, collection: CollectionDefinition): boolean;
+/** The highest committed version number of a document, `0` when it has none. */
+export declare function readLatestVersionNumber(database: DatabaseAdapter, collection: CollectionDefinition, documentId: string): Promise<number>;
+/**
+ * The restorable content of a document (spec 062 §5): every field the collection declares — `null`
+ * when unset, so restoring can clear it — plus `_status` on a drafts collection. Never `id`,
+ * timestamps, `_storageKey` or undeclared keys.
+ */
+export declare function buildSnapshot(collection: CollectionDefinition, content: Record<string, unknown>): Record<string, unknown>;
+export declare function buildVersionRecord(input: {
+    documentId: string;
+    versionNumber: number;
+    data: Record<string, unknown>;
+    user: CmsUser | null;
+    /** `true` for automatic snapshots built with {@link buildSnapshot}. */
+    full: boolean;
+    autosave?: boolean;
+    label?: string;
+}): DatabaseRecord;
+/** A version as restore needs it: the public shape plus whether its data is a full snapshot. */
+export interface RestorableVersion {
+    version: Version;
+    full: boolean;
+}
+/** Raw (trusted, unfiltered) version read for restore — `getVersion` does not expose the format marker. */
+export declare function readVersionForRestore(ctx: OperationContext, collection: CollectionDefinition, versionId: string): Promise<RestorableVersion>;
+/**
+ * What a restore sets (spec 062 §6). A full snapshot sets every *currently* declared field — a field the
+ * snapshot lacks did not exist then, so it becomes `null` (and fails current validation if it is now
+ * required). A legacy/manual snapshot may be a patch, so only the declared fields it contains are set.
+ * System metadata and undeclared keys are dropped either way.
+ */
+export declare function restoreTarget(collection: CollectionDefinition, restorable: RestorableVersion): Record<string, unknown>;
+/** Only the target fields whose value differs from the current document. */
+export declare function diffAgainst(target: Record<string, unknown>, current: Record<string, unknown>): Record<string, unknown>;
+/** One duplicated version identity found by {@link findDuplicateVersionIdentities}. */
+export interface DuplicateVersionIdentity {
+    documentId: string;
+    versionNumber: number;
+    rows: number;
+}
+/**
+ * Scans a version table for `(documentId, versionNumber)` pairs held by more than one row — history the
+ * pre-062 read-then-insert race could produce, and which blocks the unique index (spec 062 §8). Reads
+ * only; never repairs. Pages through the table in identity order with the ordinary adapter API, so it
+ * works on every adapter (an upgrade/diagnostic path, not a hot path).
+ */
+export declare function findDuplicateVersionIdentities(database: DatabaseAdapter, versionsCollection: string): Promise<DuplicateVersionIdentity[]>;
 export { versionsEnabled, autosaveEnabled };
 //# sourceMappingURL=versions.d.ts.map

package/dist/versions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../src/versions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGrD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAQD,iBAAS,eAAe,CAAC,UAAU,EAAE,oBAAoB,GAAG,OAAO,CAKlE;AAED,iBAAS,eAAe,CAAC,UAAU,EAAE,oBAAoB,GAAG,OAAO,CAKlE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,OAAO,EAAE,CAAC,CAiBpB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAW9F;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,cAAc,CAAC,CA8BzB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,OAAO,CAAC,CAiClB;AAiBD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../src/versions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAY,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACxF,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAErE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAOrD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAQD,iBAAS,eAAe,CAAC,UAAU,EAAE,oBAAoB,GAAG,OAAO,CAKlE;AAED;;;;GAIG;AACH,iBAAS,eAAe,CAAC,UAAU,EAAE,oBAAoB,GAAG,OAAO,CAKlE;AAuCD;;GAEG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,OAAO,EAAE,CAAC,CA+BpB;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAiB9F;AAKD;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,OAAO,CAAC,CAmClB;AAOD,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,cAAc,EAAE,MAAM,GAAG,oBAAoB,CAgBxF;AAED,yGAAyG;AACzG,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,oBAAoB,GAAG,OAAO,CAIjG;AAED,gFAAgF;AAChF,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,eAAe,EACzB,UAAU,EAAE,oBAAoB,EAChC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAUjB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,oBAAoB,EAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IACrB,uEAAuE;IACvE,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,cAAc,CAYjB;AAED,gGAAgG;AAChG,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,2GAA2G;AAC3G,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,gBAAgB,EACrB,UAAU,EAAE,oBAAoB,EAChC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,CAAC,CAO5B;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,oBAAoB,EAChC,UAAU,EAAE,iBAAiB,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzB;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB;AAoBD,uFAAuF;AACvF,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAID;;;;;GAKG;AACH,wBAAsB,8BAA8B,CAClD,QAAQ,EAAE,eAAe,EACzB,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAgCrC;AAiBD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,CAAC"}

package/dist/versions.js

@@ -1,4 +1,10 @@
-import { NotFoundError } from './errors.js';
+import { defineField } from '@forge-cms/core';
+import { isUniqueConstraintError as isDbUniqueConstraintError } from '@forge-cms/db';
+import { ConcurrentModificationError, NotFoundError } from './errors.js';
+import { documentMatches } from './access.js';
+import { checkAccess, statusConstraint } from './read-policy.js';
+import { filterReadableFields } from './field-access.js';
+import { FORGE_OWNED_KEYS } from './system-fields.js';
 function getCollectionOrThrow(ctx, slug) {
     const collection = ctx.getCollection(slug);
     if (!collection)
@@ -9,12 +15,47 @@ function versionsEnabled(collection) {
     return (collection.versions === true ||
         (typeof collection.versions === 'object' && collection.versions !== null));
 }
+/**
+ * Whether `versions: { autosave: true }` is set. Nothing in the runtime acts on it today (spec 062 §11):
+ * automatic snapshots are always `autosave: false`; only a manual `createVersion({ autosave: true })`
+ * sets the flag.
+ */
 function autosaveEnabled(collection) {
     if (typeof collection.versions === 'object' && collection.versions !== null) {
         return collection.versions.autosave === true;
     }
     return false;
 }
+/**
+ * A version's history must not tell an untrusted caller anything about its owning document that the
+ * document's own read policy wouldn't already tell them (spec 058 §2 / maintainer brief §2). This
+ * mirrors `findByID`'s own owner-lookup: collection-level denial surfaces as `403` (matching a normal
+ * denied read), a missing owner or a row/draft mismatch surfaces as `404` (never confirms whether a
+ * hidden document exists), exactly like `findByID` already behaves for a single document by id.
+ *
+ * Only called when `overrideAccess === false` — a trusted Local API call skips this entirely, same as
+ * every other operation's `overrideAccess: true` default.
+ */
+async function assertOwnerReadable(ctx, collection, documentId, user) {
+    const owner = await ctx.adapters.database.findById(collection.slug, documentId);
+    if (!owner)
+        throw new NotFoundError(`Document '${documentId}' not found`);
+    const decision = await checkAccess(collection, 'read', {
+        user,
+        overrideAccess: false,
+        id: documentId,
+        doc: owner
+    });
+    if (decision.where && !documentMatches(owner, decision.where)) {
+        throw new NotFoundError(`Document '${documentId}' not found`);
+    }
+    // Matches `findByID`'s own default: a single document known by id is visible to any authenticated
+    // caller regardless of draft status; anonymous callers only ever see published documents.
+    const status = statusConstraint(collection, undefined, user, false, 'all');
+    if (status && !documentMatches(owner, status)) {
+        throw new NotFoundError(`Document '${documentId}' not found`);
+    }
+}
 /**
  * Lists all versions of a document, newest first.
  */
@@ -23,6 +64,11 @@ export async function listVersions(ctx, args) {
     if (!versionsEnabled(collection)) {
         throw new Error(`Collection '${args.collection}' does not have versions enabled`);
     }
+    const user = args.user ?? null;
+    const overrideAccess = args.overrideAccess !== false;
+    if (!overrideAccess) {
+        await assertOwnerReadable(ctx, collection, args.documentId, user);
+    }
     const versionsCollection = `_versions_${args.collection}`;
     const records = await ctx.adapters.database.findMany({
         collection: versionsCollection,
@@ -32,10 +78,19 @@ export async function listVersions(ctx, args) {
         ...(args.limit !== undefined && { limit: args.limit }),
         ...(args.offset !== undefined && { offset: args.offset })
     });
-    return records.map(toVersion);
+    const versions = records.map(toVersion);
+    if (overrideAccess)
+        return versions;
+    return Promise.all(versions.map(async (version) => ({
+        ...version,
+        data: await filterReadableFields(version.data, collection, user)
+    })));
 }
 /**
- * Gets a specific version by id.
+ * Gets a specific version by id. `overrideAccess: true` (the default, matching every other Local API
+ * method) returns the raw, unfiltered snapshot with no owner-visibility check — used internally by
+ * {@link import('./operations.js').restoreVersion}, where the authoritative access gate is the
+ * subsequent `update()` call, not this read.
  */
 export async function getVersion(ctx, args) {
     const collection = getCollectionOrThrow(ctx, args.collection);
@@ -46,64 +101,223 @@ export async function getVersion(ctx, args) {
     const record = await ctx.adapters.database.findById(versionsCollection, args.versionId);
     if (!record)
         throw new NotFoundError(`Version '${args.versionId}' not found`);
-    return toVersion(record);
+    const version = toVersion(record);
+    const user = args.user ?? null;
+    const overrideAccess = args.overrideAccess !== false;
+    if (overrideAccess)
+        return version;
+    await assertOwnerReadable(ctx, collection, version.documentId, user);
+    return { ...version, data: await filterReadableFields(version.data, collection, user) };
 }
+/** Attempts (in total) manual {@link createVersion} makes to allocate a version number under contention. */
+const MAX_MANUAL_VERSION_ATTEMPTS = 3;
 /**
- * Restores a document to a specific version. Creates a new version with the restored data.
+ * Creates a version of a document by hand (trusted Local API only — there is no HTTP route). Stores
+ * `data` verbatim: no hooks, no access check, no check that the owner document still exists, and — since
+ * nothing guarantees the caller passed full content — the row is not marked as a full snapshot, so a
+ * restore of it only applies the fields it contains (spec 062 §7).
+ *
+ * The version number is `latest + 1`, made safe by the unique `(documentId, versionNumber)` index: when
+ * another writer takes that number first, the latest is re-read and the insert retried, at most
+ * {@link MAX_MANUAL_VERSION_ATTEMPTS} times in total, then {@link ConcurrentModificationError}. Retrying
+ * is safe here — and only here — because nothing but the number changes between attempts: no document
+ * write, no consumer code. Automatic snapshots are not created through this function; see
+ * `operations.ts`, which writes them in the same atomic batch as the document.
  */
-export async function restoreVersion(ctx, args) {
+export async function createVersion(ctx, args) {
     const collection = getCollectionOrThrow(ctx, args.collection);
     if (!versionsEnabled(collection)) {
         throw new Error(`Collection '${args.collection}' does not have versions enabled`);
     }
-    const version = await getVersion(ctx, {
-        collection: args.collection,
-        versionId: args.versionId,
-        ...(args.user !== undefined && { user: args.user }),
-        ...(args.overrideAccess !== undefined && { overrideAccess: args.overrideAccess })
-    });
-    // Update the document with the version data
-    const record = await ctx.adapters.database.update(args.collection, version.documentId, version.data);
-    // Create a new version for the restore
-    await createVersion(ctx, {
-        collection: args.collection,
-        documentId: version.documentId,
-        data: version.data,
-        ...(args.user !== undefined && { user: args.user }),
-        label: `Restored from version ${version.versionNumber}`
-    });
-    return record;
+    for (let attempt = 1;; attempt++) {
+        const latest = await readLatestVersionNumber(ctx.adapters.database, collection, args.documentId);
+        const record = buildVersionRecord({
+            documentId: args.documentId,
+            versionNumber: latest + 1,
+            data: args.data,
+            user: args.user ?? null,
+            full: false,
+            ...(args.autosave !== undefined && { autosave: args.autosave }),
+            ...(args.label !== undefined && { label: args.label })
+        });
+        try {
+            const created = await ctx.adapters.database.create(versionsCollectionSlug(collection.slug), record);
+            return toVersion(created);
+        }
+        catch (err) {
+            if (!isVersionIdentityConflict(err, collection))
+                throw err;
+            if (attempt >= MAX_MANUAL_VERSION_ATTEMPTS) {
+                throw new ConcurrentModificationError(collection.slug, args.documentId);
+            }
+        }
+    }
+}
+// --- spec 062: version table, full snapshots, restore diff ---------------------------------------
+/** Marker stored in `snapshotFormat` on every automatic snapshot written since spec 062. */
+const FULL_SNAPSHOT = 'full';
+export function versionsCollectionSlug(collectionSlug) {
+    return `_versions_${collectionSlug}`;
 }
 /**
- * Creates a new version of a document. Called automatically on updates when versions are enabled.
+ * The internal collection that stores a versioned collection's history. The compound unique
+ * `(documentId, versionNumber)` index is the version-identity invariant every automatic write relies
+ * on for serialization (spec 062 §1/§3); `snapshotFormat` tells a full snapshot from a pre-062 patch.
  */
-export async function createVersion(ctx, args) {
-    const collection = getCollectionOrThrow(ctx, args.collection);
-    if (!versionsEnabled(collection)) {
-        throw new Error(`Collection '${args.collection}' does not have versions enabled`);
-    }
-    const versionsCollection = `_versions_${args.collection}`;
-    // Get the latest version number for this document
-    const existingVersions = await ctx.adapters.database.findMany({
-        collection: versionsCollection,
-        where: { documentId: args.documentId },
+export function versionCollectionDefinition(collectionSlug) {
+    const fields = {
+        documentId: defineField.text({ required: true }),
+        versionNumber: defineField.number({ required: true }),
+        data: defineField.json({ required: true }),
+        createdAt: defineField.date({ required: true }),
+        createdBy: defineField.text(),
+        autosave: defineField.boolean(),
+        label: defineField.text(),
+        snapshotFormat: defineField.text()
+    };
+    return {
+        slug: versionsCollectionSlug(collectionSlug),
+        fields,
+        indexes: [{ fields: ['documentId', 'versionNumber'], unique: true }]
+    };
+}
+/** Whether `err` is the version table's `(documentId, versionNumber)` unique index rejecting a write. */
+export function isVersionIdentityConflict(err, collection) {
+    return (isDbUniqueConstraintError(err) && err.collection === versionsCollectionSlug(collection.slug));
+}
+/** The highest committed version number of a document, `0` when it has none. */
+export async function readLatestVersionNumber(database, collection, documentId) {
+    const [latest] = await database.findMany({
+        collection: versionsCollectionSlug(collection.slug),
+        where: { documentId },
         sort: 'versionNumber',
         order: 'desc',
         limit: 1
     });
-    const lastVersionNumber = existingVersions.length > 0 ? (existingVersions[0]?.versionNumber ?? 0) : 0;
-    const versionRecord = {
+    const value = latest?.versionNumber;
+    return typeof value === 'number' ? value : 0;
+}
+/**
+ * The restorable content of a document (spec 062 §5): every field the collection declares — `null`
+ * when unset, so restoring can clear it — plus `_status` on a drafts collection. Never `id`,
+ * timestamps, `_storageKey` or undeclared keys.
+ */
+export function buildSnapshot(collection, content) {
+    const snapshot = {};
+    for (const name of Object.keys(collection.fields)) {
+        snapshot[name] = content[name] ?? null;
+    }
+    if (collection.drafts === true && content._status !== undefined) {
+        snapshot._status = content._status;
+    }
+    return snapshot;
+}
+export function buildVersionRecord(input) {
+    return {
         id: crypto.randomUUID(),
-        documentId: args.documentId,
-        versionNumber: lastVersionNumber + 1,
-        data: JSON.stringify(args.data),
+        documentId: input.documentId,
+        versionNumber: input.versionNumber,
+        data: JSON.stringify(input.data),
         createdAt: new Date().toISOString(),
-        createdBy: args.user?.id ?? null,
-        autosave: args.autosave ?? false,
-        ...(args.label !== undefined && { label: args.label })
+        createdBy: input.user?.id ?? null,
+        autosave: input.autosave ?? false,
+        ...(input.full && { snapshotFormat: FULL_SNAPSHOT }),
+        ...(input.label !== undefined && { label: input.label })
     };
-    const created = await ctx.adapters.database.create(versionsCollection, versionRecord);
-    return toVersion(created);
+}
+/** Raw (trusted, unfiltered) version read for restore — `getVersion` does not expose the format marker. */
+export async function readVersionForRestore(ctx, collection, versionId) {
+    const record = await ctx.adapters.database.findById(versionsCollectionSlug(collection.slug), versionId);
+    if (!record)
+        throw new NotFoundError(`Version '${versionId}' not found`);
+    return { version: toVersion(record), full: record.snapshotFormat === FULL_SNAPSHOT };
+}
+/**
+ * What a restore sets (spec 062 §6). A full snapshot sets every *currently* declared field — a field the
+ * snapshot lacks did not exist then, so it becomes `null` (and fails current validation if it is now
+ * required). A legacy/manual snapshot may be a patch, so only the declared fields it contains are set.
+ * System metadata and undeclared keys are dropped either way.
+ */
+export function restoreTarget(collection, restorable) {
+    const data = restorable.version.data;
+    const target = {};
+    for (const name of Object.keys(collection.fields)) {
+        if (name in data)
+            target[name] = data[name];
+        else if (restorable.full)
+            target[name] = null;
+    }
+    if (collection.drafts === true && data._status !== undefined)
+        target._status = data._status;
+    // Adapter/system metadata is never restorable content (spec 062 §5, spec 063).
+    for (const key of FORGE_OWNED_KEYS)
+        delete target[key];
+    return target;
+}
+/** Only the target fields whose value differs from the current document. */
+export function diffAgainst(target, current) {
+    const patch = {};
+    for (const [key, value] of Object.entries(target)) {
+        if (!sameValue(value, current[key]))
+            patch[key] = value;
+    }
+    return patch;
+}
+function comparable(value) {
+    if (value === undefined || value === null)
+        return null;
+    if (value instanceof Date)
+        return value.toISOString();
+    if (Array.isArray(value))
+        return value.map(comparable);
+    if (typeof value === 'object') {
+        return Object.fromEntries(Object.keys(value)
+            .sort()
+            .map((key) => [key, comparable(value[key])]));
+    }
+    return value;
+}
+function sameValue(a, b) {
+    return JSON.stringify(comparable(a)) === JSON.stringify(comparable(b));
+}
+const DUPLICATE_SCAN_PAGE = 500;
+/**
+ * Scans a version table for `(documentId, versionNumber)` pairs held by more than one row — history the
+ * pre-062 read-then-insert race could produce, and which blocks the unique index (spec 062 §8). Reads
+ * only; never repairs. Pages through the table in identity order with the ordinary adapter API, so it
+ * works on every adapter (an upgrade/diagnostic path, not a hot path).
+ */
+export async function findDuplicateVersionIdentities(database, versionsCollection) {
+    const duplicates = [];
+    let previous;
+    for (let offset = 0;; offset += DUPLICATE_SCAN_PAGE) {
+        const page = await database.findMany({
+            collection: versionsCollection,
+            sort: [
+                { field: 'documentId', order: 'asc' },
+                { field: 'versionNumber', order: 'asc' },
+                { field: 'id', order: 'asc' }
+            ],
+            limit: DUPLICATE_SCAN_PAGE,
+            offset
+        });
+        for (const row of page) {
+            const documentId = String(row.documentId);
+            const versionNumber = Number(row.versionNumber);
+            if (previous &&
+                previous.documentId === documentId &&
+                previous.versionNumber === versionNumber) {
+                previous.rows++;
+                if (previous.rows === 2)
+                    duplicates.push(previous);
+            }
+            else {
+                previous = { documentId, versionNumber, rows: 1 };
+            }
+        }
+        if (page.length < DUPLICATE_SCAN_PAGE)
+            return duplicates;
+    }
 }
 function toVersion(record) {
     const data = typeof record.data === 'string' ? JSON.parse(record.data) : record.data;

package/dist/versions.js.map

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