@forge-cms/runtime 0.0.1

package/dist/relation-integrity.js

@@ -0,0 +1,150 @@
+import { InvalidInputError } from './errors.js';
+/**
+ * Relation integrity utilities for handling cascade, restrict, and set-null on delete.
+ */
+/**
+ * Finds all relation fields in a collection that reference a target collection.
+ */
+export function findRelationFields(collection, targetCollection) {
+    const relations = [];
+    for (const [fieldName, field] of Object.entries(collection.fields)) {
+        if (field.kind === 'relation') {
+            const options = field.options;
+            if (options.collection === targetCollection) {
+                relations.push({ fieldName, options });
+            }
+        }
+    }
+    return relations;
+}
+/**
+ * Finds all documents in a collection that reference a specific document ID.
+ */
+export async function findReferencingDocuments(ctx, collection, fieldName, documentId, many) {
+    if (many) {
+        // For many relations, we need to check if the ID is in the array
+        const allDocs = await ctx.adapters.database.findMany({ collection: collection.slug });
+        return allDocs.filter((doc) => {
+            const value = doc[fieldName];
+            return Array.isArray(value) && value.includes(documentId);
+        });
+    }
+    else {
+        // For single relations, use where clause
+        return ctx.adapters.database.findMany({
+            collection: collection.slug,
+            where: { [fieldName]: documentId }
+        });
+    }
+}
+/**
+ * Checks if a document can be deleted based on relation constraints.
+ * Throws InvalidInputError if deletion is restricted.
+ */
+export async function checkDeleteRestrictions(ctx, targetCollection, documentId) {
+    // Check all collections for relations to this collection
+    for (const collection of ctx.getCollections()) {
+        if (collection.slug === targetCollection.slug)
+            continue;
+        const relations = findRelationFields(collection, targetCollection.slug);
+        for (const { fieldName, options } of relations) {
+            const onDelete = options.onDelete ?? 'restrict';
+            if (onDelete === 'restrict') {
+                const referencing = await findReferencingDocuments(ctx, collection, fieldName, documentId, options.many ?? false);
+                if (referencing.length > 0) {
+                    throw new InvalidInputError(`Cannot delete document '${documentId}' from '${targetCollection.slug}': ` +
+                        `referenced by ${referencing.length} document(s) in '${collection.slug}'`);
+                }
+            }
+        }
+    }
+}
+/**
+ * Handles cascade delete: deletes all documents that reference the deleted document.
+ */
+export async function handleCascadeDelete(ctx, targetCollection, documentId) {
+    for (const collection of ctx.getCollections()) {
+        if (collection.slug === targetCollection.slug)
+            continue;
+        const relations = findRelationFields(collection, targetCollection.slug);
+        for (const { fieldName, options } of relations) {
+            const onDelete = options.onDelete ?? 'restrict';
+            if (onDelete === 'cascade') {
+                const referencing = await findReferencingDocuments(ctx, collection, fieldName, documentId, options.many ?? false);
+                // Delete all referencing documents
+                for (const doc of referencing) {
+                    await ctx.adapters.database.delete(collection.slug, doc.id);
+                }
+            }
+        }
+    }
+}
+/**
+ * Handles set-null: sets relation fields to null in all referencing documents.
+ */
+export async function handleSetNullOnDelete(ctx, targetCollection, documentId) {
+    for (const collection of ctx.getCollections()) {
+        if (collection.slug === targetCollection.slug)
+            continue;
+        const relations = findRelationFields(collection, targetCollection.slug);
+        for (const { fieldName, options } of relations) {
+            const onDelete = options.onDelete ?? 'restrict';
+            if (onDelete === 'set-null') {
+                const referencing = await findReferencingDocuments(ctx, collection, fieldName, documentId, options.many ?? false);
+                // Update each referencing document
+                for (const doc of referencing) {
+                    if (options.many) {
+                        // Remove the ID from the array
+                        const currentValue = doc[fieldName];
+                        const newValue = currentValue.filter((id) => id !== documentId);
+                        await ctx.adapters.database.update(collection.slug, doc.id, {
+                            [fieldName]: newValue
+                        });
+                    }
+                    else {
+                        // Set to null
+                        await ctx.adapters.database.update(collection.slug, doc.id, {
+                            [fieldName]: null
+                        });
+                    }
+                }
+            }
+        }
+    }
+}
+/**
+ * Finds orphaned documents: documents with relation fields pointing to non-existent documents.
+ */
+export async function findOrphanedDocuments(ctx, collection) {
+    const orphans = [];
+    const allDocs = await ctx.adapters.database.findMany({ collection: collection.slug });
+    for (const [fieldName, field] of Object.entries(collection.fields)) {
+        if (field.kind !== 'relation')
+            continue;
+        const options = field.options;
+        const targetCollection = options.collection;
+        for (const doc of allDocs) {
+            const value = doc[fieldName];
+            if (options.many && Array.isArray(value)) {
+                // Check each ID in the array
+                for (const id of value) {
+                    if (typeof id === 'string') {
+                        const target = await ctx.adapters.database.findById(targetCollection, id);
+                        if (!target) {
+                            orphans.push({ document: doc, fieldName, missingId: id });
+                        }
+                    }
+                }
+            }
+            else if (typeof value === 'string') {
+                // Check single relation
+                const target = await ctx.adapters.database.findById(targetCollection, value);
+                if (!target) {
+                    orphans.push({ document: doc, fieldName, missingId: value });
+                }
+            }
+        }
+    }
+    return orphans;
+}
+//# sourceMappingURL=relation-integrity.js.map

package/dist/relation-integrity.js.map

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

package/dist/runtime.d.ts

@@ -0,0 +1,61 @@
+import type { ForgeCmsConfig, AdapterSet } from './config.js';
+import type { CollectionDefinition, GlobalDefinition } from '@forge-cms/core';
+import type { DatabaseRecord } from '@forge-cms/db';
+import type { OperationContext } from './context.js';
+import type { CountArgs, CreateArgs, DeleteArgs, FindArgs, FindByIDArgs, PaginatedDocs, UpdateArgs } from './operations.js';
+import type { GetGlobalArgs, UpdateGlobalArgs } from './globals.js';
+import type { ListVersionsArgs, GetVersionArgs, RestoreVersionArgs, CreateVersionArgs } from './versions.js';
+import type { Version } from '@forge-cms/core';
+/**
+ * The CMS instance: collections bound to adapters, plus the **Local API** — `find`, `findByID`,
+ * `create`, `update`, `delete`, `count`, `getGlobal`, `updateGlobal`.
+ *
+ * The Local API is the primary way to use ForgeCMS from server code (an Analog.js `.server.ts`
+ * route, a Nitro handler, a seed script). It runs the full pipeline — hooks, access, drafts,
+ * relation population, validation — with no HTTP hop and no `Request` to fabricate. The HTTP
+ * handlers in `handlers.ts` are a thin transport layer over these same methods.
+ *
+ * Access control is **skipped by default** here (`overrideAccess` defaults to `true`), because a
+ * direct call comes from trusted server code. Pass `overrideAccess: false` together with a `user` to
+ * run an operation as that user — which is exactly what the HTTP layer does.
+ */
+export declare class ForgeCmsRuntime<TEnv = unknown> implements OperationContext {
+    readonly config: ForgeCmsConfig<TEnv>;
+    readonly adapters: AdapterSet;
+    constructor(config: ForgeCmsConfig<TEnv>);
+    /** Initialise all adapters with the runtime environment */
+    init(): this;
+    /** Sync database schema for all registered collections and globals */
+    syncSchema(): Promise<void>;
+    /** Find a collection definition by slug */
+    getCollection(slug: string): CollectionDefinition | undefined;
+    /** Get all registered collection definitions */
+    getCollections(): readonly CollectionDefinition[];
+    /** Find a global definition by slug */
+    getGlobal(slug: string): GlobalDefinition | undefined;
+    /** Get all registered global definitions */
+    getGlobals(): readonly GlobalDefinition[];
+    find(args: FindArgs): Promise<PaginatedDocs>;
+    findByID(args: FindByIDArgs): Promise<DatabaseRecord>;
+    count(args: CountArgs): Promise<number>;
+    create(args: CreateArgs): Promise<DatabaseRecord>;
+    update(args: UpdateArgs): Promise<DatabaseRecord>;
+    delete(args: DeleteArgs): Promise<DatabaseRecord>;
+    getGlobalDocument(args: GetGlobalArgs): Promise<DatabaseRecord | null>;
+    updateGlobalDocument(args: UpdateGlobalArgs): Promise<DatabaseRecord>;
+    listVersions(args: ListVersionsArgs): Promise<Version[]>;
+    getVersion(args: GetVersionArgs): Promise<Version>;
+    restoreVersion(args: RestoreVersionArgs): Promise<DatabaseRecord>;
+    createVersion(args: CreateVersionArgs): Promise<Version>;
+    /**
+     * Generates a preview of a document by merging stored data with unsaved changes.
+     * If id is provided, merges changes with existing document. Otherwise, previews new document.
+     */
+    preview(args: {
+        collection: string;
+        data: Record<string, unknown>;
+        id?: string;
+        depth?: 0 | 1;
+    }): Promise<DatabaseRecord>;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAY,MAAM,iBAAiB,CAAC;AAExF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,UAAU,EACX,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEpE,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAe,CAAC,IAAI,GAAG,OAAO,CAAE,YAAW,gBAAgB;IACtE,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;gBAElB,MAAM,EAAE,cAAc,CAAC,IAAI,CAAC;IAKxC,2DAA2D;IAC3D,IAAI,IAAI,IAAI;IAQZ,sEAAsE;IAChE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAuCjC,2CAA2C;IAC3C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAI7D,gDAAgD;IAChD,cAAc,IAAI,SAAS,oBAAoB,EAAE;IAIjD,uCAAuC;IACvC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAIrD,4CAA4C;IAC5C,UAAU,IAAI,SAAS,gBAAgB,EAAE;IAMzC,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC;IAI5C,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;IAIrD,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAIvC,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC;IAIjD,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC;IAIjD,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC;IAMjD,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAItE,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC;IAMrE,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAIxD,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlD,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC;IAIjE,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAMxD;;;OAGG;IACG,OAAO,CAAC,IAAI,EAAE;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9B,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;KACf,GAAG,OAAO,CAAC,cAAc,CAAC;CAqC5B"}

package/dist/runtime.js

@@ -0,0 +1,155 @@
+import { defineField } from '@forge-cms/core';
+import * as operations from './operations.js';
+import * as globalOps from './globals.js';
+import * as versionOps from './versions.js';
+/**
+ * The CMS instance: collections bound to adapters, plus the **Local API** — `find`, `findByID`,
+ * `create`, `update`, `delete`, `count`, `getGlobal`, `updateGlobal`.
+ *
+ * The Local API is the primary way to use ForgeCMS from server code (an Analog.js `.server.ts`
+ * route, a Nitro handler, a seed script). It runs the full pipeline — hooks, access, drafts,
+ * relation population, validation — with no HTTP hop and no `Request` to fabricate. The HTTP
+ * handlers in `handlers.ts` are a thin transport layer over these same methods.
+ *
+ * Access control is **skipped by default** here (`overrideAccess` defaults to `true`), because a
+ * direct call comes from trusted server code. Pass `overrideAccess: false` together with a `user` to
+ * run an operation as that user — which is exactly what the HTTP layer does.
+ */
+export class ForgeCmsRuntime {
+    config;
+    adapters;
+    constructor(config) {
+        this.config = config;
+        this.adapters = config.adapters;
+    }
+    /** Initialise all adapters with the runtime environment */
+    init() {
+        const env = this.config.env;
+        this.adapters.database.init(env);
+        this.adapters.auth.init(env);
+        this.adapters.storage.init(env);
+        return this;
+    }
+    /** Sync database schema for all registered collections and globals */
+    async syncSchema() {
+        await this.adapters.database.syncSchema(this.config.collections);
+        for (const global of this.config.globals ?? []) {
+            await this.adapters.database.syncSchema([
+                {
+                    slug: `_global_${global.slug}`,
+                    fields: global.fields,
+                    ...(global.drafts === true && { drafts: true })
+                }
+            ]);
+        }
+        // Create version tables for collections with versions enabled
+        for (const collection of this.config.collections) {
+            if (collection.versions === true ||
+                (typeof collection.versions === 'object' && collection.versions !== null)) {
+                const versionFields = {
+                    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()
+                };
+                await this.adapters.database.syncSchema([
+                    {
+                        slug: `_versions_${collection.slug}`,
+                        fields: versionFields
+                    }
+                ]);
+            }
+        }
+    }
+    /** Find a collection definition by slug */
+    getCollection(slug) {
+        return this.config.collections.find((c) => c.slug === slug);
+    }
+    /** Get all registered collection definitions */
+    getCollections() {
+        return this.config.collections;
+    }
+    /** Find a global definition by slug */
+    getGlobal(slug) {
+        return this.config.globals?.find((g) => g.slug === slug);
+    }
+    /** Get all registered global definitions */
+    getGlobals() {
+        return this.config.globals ?? [];
+    }
+    // --- Local API ---------------------------------------------------------------------------
+    find(args) {
+        return operations.find(this, args);
+    }
+    findByID(args) {
+        return operations.findByID(this, args);
+    }
+    count(args) {
+        return operations.count(this, args);
+    }
+    create(args) {
+        return operations.create(this, args);
+    }
+    update(args) {
+        return operations.update(this, args);
+    }
+    delete(args) {
+        return operations.deleteDocument(this, args);
+    }
+    // --- Globals -----------------------------------------------------------------------------
+    getGlobalDocument(args) {
+        return globalOps.getGlobal(this, args);
+    }
+    updateGlobalDocument(args) {
+        return globalOps.updateGlobal(this, args);
+    }
+    // --- Versions ---------------------------------------------------------------------------
+    listVersions(args) {
+        return versionOps.listVersions(this, args);
+    }
+    getVersion(args) {
+        return versionOps.getVersion(this, args);
+    }
+    restoreVersion(args) {
+        return versionOps.restoreVersion(this, args);
+    }
+    createVersion(args) {
+        return versionOps.createVersion(this, args);
+    }
+    // --- Preview ----------------------------------------------------------------------------
+    /**
+     * Generates a preview of a document by merging stored data with unsaved changes.
+     * If id is provided, merges changes with existing document. Otherwise, previews new document.
+     */
+    async preview(args) {
+        const collection = this.getCollection(args.collection);
+        if (!collection) {
+            throw new (await import('./errors.js')).NotFoundError(`Collection '${args.collection}' not found`);
+        }
+        let previewData;
+        let existing = null;
+        if (args.id) {
+            existing = await this.adapters.database.findById(args.collection, args.id);
+            if (!existing) {
+                throw new (await import('./errors.js')).NotFoundError(`Document '${args.id}' not found`);
+            }
+            previewData = { ...existing, ...args.data };
+        }
+        else {
+            previewData = args.data;
+        }
+        // Apply field defaults and auto-slugs
+        const { applyFieldDefaults, applyAutoSlugs } = await import('./defaults.js');
+        previewData = applyAutoSlugs(collection, applyFieldDefaults(collection, previewData), existing ?? undefined);
+        // Populate relations if depth > 0
+        if (args.depth && args.depth > 0) {
+            const { populateRecord } = await import('./populate.js');
+            previewData = await populateRecord(previewData, collection, this);
+        }
+        return previewData;
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/versions.d.ts

@@ -0,0 +1,51 @@
+import type { CmsUser, CollectionDefinition, Version } from '@forge-cms/core';
+import type { DatabaseRecord } from '@forge-cms/db';
+import type { OperationContext } from './context.js';
+export interface ListVersionsArgs {
+    collection: string;
+    documentId: string;
+    user?: CmsUser | null;
+    overrideAccess?: boolean;
+    limit?: number;
+    offset?: number;
+}
+export interface GetVersionArgs {
+    collection: string;
+    versionId: string;
+    user?: CmsUser | null;
+    overrideAccess?: boolean;
+}
+export interface RestoreVersionArgs {
+    collection: string;
+    versionId: string;
+    user?: CmsUser | null;
+    overrideAccess?: boolean;
+}
+export interface CreateVersionArgs {
+    collection: string;
+    documentId: string;
+    data: Record<string, unknown>;
+    user?: CmsUser | null;
+    autosave?: boolean;
+    label?: string;
+}
+declare function versionsEnabled(collection: CollectionDefinition): boolean;
+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.
+ */
+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.
+ */
+export declare function restoreVersion(ctx: OperationContext, args: RestoreVersionArgs): Promise<DatabaseRecord>;
+/**
+ * Creates a new version of a document. Called automatically on updates when versions are enabled.
+ */
+export declare function createVersion(ctx: OperationContext, args: CreateVersionArgs): Promise<Version>;
+export { versionsEnabled, autosaveEnabled };
+//# sourceMappingURL=versions.d.ts.map

package/dist/versions.d.ts.map

@@ -0,0 +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"}

package/dist/versions.js

@@ -0,0 +1,122 @@
+import { NotFoundError } from './errors.js';
+function getCollectionOrThrow(ctx, slug) {
+    const collection = ctx.getCollection(slug);
+    if (!collection)
+        throw new NotFoundError(`Collection '${slug}' not found`);
+    return collection;
+}
+function versionsEnabled(collection) {
+    return (collection.versions === true ||
+        (typeof collection.versions === 'object' && collection.versions !== null));
+}
+function autosaveEnabled(collection) {
+    if (typeof collection.versions === 'object' && collection.versions !== null) {
+        return collection.versions.autosave === true;
+    }
+    return false;
+}
+/**
+ * Lists all versions of a document, newest first.
+ */
+export async function listVersions(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}`;
+    const records = await ctx.adapters.database.findMany({
+        collection: versionsCollection,
+        where: { documentId: args.documentId },
+        sort: 'versionNumber',
+        order: 'desc',
+        ...(args.limit !== undefined && { limit: args.limit }),
+        ...(args.offset !== undefined && { offset: args.offset })
+    });
+    return records.map(toVersion);
+}
+/**
+ * Gets a specific version by id.
+ */
+export async function getVersion(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}`;
+    const record = await ctx.adapters.database.findById(versionsCollection, args.versionId);
+    if (!record)
+        throw new NotFoundError(`Version '${args.versionId}' not found`);
+    return toVersion(record);
+}
+/**
+ * Restores a document to a specific version. Creates a new version with the restored data.
+ */
+export async function restoreVersion(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;
+}
+/**
+ * Creates a new version of a document. Called automatically on updates when versions are enabled.
+ */
+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 },
+        sort: 'versionNumber',
+        order: 'desc',
+        limit: 1
+    });
+    const lastVersionNumber = existingVersions.length > 0 ? (existingVersions[0]?.versionNumber ?? 0) : 0;
+    const versionRecord = {
+        id: crypto.randomUUID(),
+        documentId: args.documentId,
+        versionNumber: lastVersionNumber + 1,
+        data: JSON.stringify(args.data),
+        createdAt: new Date().toISOString(),
+        createdBy: args.user?.id ?? null,
+        autosave: args.autosave ?? false,
+        ...(args.label !== undefined && { label: args.label })
+    };
+    const created = await ctx.adapters.database.create(versionsCollection, versionRecord);
+    return toVersion(created);
+}
+function toVersion(record) {
+    const data = typeof record.data === 'string' ? JSON.parse(record.data) : record.data;
+    return {
+        id: record.id,
+        documentId: record.documentId,
+        versionNumber: record.versionNumber,
+        data: data,
+        createdAt: record.createdAt,
+        createdBy: record.createdBy ?? null,
+        autosave: record.autosave ?? false,
+        ...(record.label !== undefined && { label: record.label })
+    };
+}
+export { versionsEnabled, autosaveEnabled };
+//# sourceMappingURL=versions.js.map

package/dist/versions.js.map

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

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@forge-cms/runtime",
+  "version": "0.0.1",
+  "description": "Runtime orchestrator for ForgeCMS — binds schema, adapters, and handlers.",
+  "author": "ForgeCMS contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Andersseen/ForgeCMS.git",
+    "directory": "packages/runtime"
+  },
+  "bugs": {
+    "url": "https://github.com/Andersseen/ForgeCMS/issues"
+  },
+  "homepage": "https://github.com/Andersseen/ForgeCMS/tree/main/packages/runtime#readme",
+  "keywords": [
+    "cms",
+    "runtime",
+    "orchestrator",
+    "typescript"
+  ],
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@forge-cms/api": "0.0.1",
+    "@forge-cms/db": "0.0.1",
+    "@forge-cms/auth": "0.0.1",
+    "@forge-cms/core": "0.0.1",
+    "@forge-cms/storage": "0.0.1"
+  },
+  "devDependencies": {
+    "typescript": "5.9.2",
+    "vitest": "^4.1.6"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run --dir .",
+    "test:watch": "vitest --dir .",
+    "lint": "eslint .",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist coverage"
+  }
+}