@forge-cms/runtime 0.4.0 → 0.6.0

package/dist/relation-integrity.js

@@ -1,9 +1,38 @@
+import { assertNotAuthManaged, isAuthManagedCollection } from './auth-managed.js';
 import { InvalidInputError } from './errors.js';
+import { versionsEnabled } from './versions.js';
 /**
- * Relation integrity utilities for handling cascade, restrict, and set-null on delete.
+ * The raw-adapter fallback used when a caller invokes `handleCascadeDelete`/`handleSetNullOnDelete`
+ * directly, without a `mutator` — a low-level primitive, but still a `@forge-cms/runtime` public export,
+ * not the raw `DatabaseAdapter` escape hatch itself. The boundary (spec 061) applies here too: it would
+ * otherwise be a second, undocumented generic-write path into a managed collection, reachable without
+ * ever going through `operations.ts`. `operations.ts`'s own `deleteDocumentInternal` always supplies a
+ * real mutator (backed by its own `deleteDocumentInternal`/`update`, already guarded), so this only
+ * changes behavior for a caller using the raw fallback on purpose.
  */
+function defaultMutator(ctx) {
+    return {
+        deleteDocument: (args) => {
+            assertNotAuthManaged(ctx, args.collection);
+            return ctx.adapters.database.delete(args.collection, args.id);
+        },
+        update: (args) => {
+            assertNotAuthManaged(ctx, args.collection);
+            // A raw write to a versioned document would commit a change with no version row, silently
+            // breaking the version-number serialization every versioned update relies on (spec 062 §3).
+            const target = ctx.getCollection(args.collection);
+            if (target && versionsEnabled(target)) {
+                throw new Error(`Collection '${args.collection}' has versions enabled; pass a mutator backed by the runtime's ` +
+                    `update() so the change and its version snapshot are written together (spec 062).`);
+            }
+            return ctx.adapters.database.update(args.collection, args.id, args.data);
+        }
+    };
+}
 /**
- * Finds all relation fields in a collection that reference a target collection.
+ * Finds all relation fields in a collection that reference a target collection. Includes
+ * self-relations (`collection === targetCollection`) — spec 058 §5 removed the previous same-collection
+ * skip, which silently let a self-relation's `onDelete` go unenforced entirely.
  */
 export function findRelationFields(collection, targetCollection) {
     const relations = [];
@@ -18,114 +47,170 @@ export function findRelationFields(collection, targetCollection) {
     return relations;
 }
 /**
- * Finds all documents in a collection that reference a specific document ID.
+ * Finds all documents in a collection that reference a specific document ID. The many-relation branch
+ * uses the `containsValue` operator (spec 050, every adapter) for a real database-side membership
+ * query instead of an unconditional full-table scan filtered in JavaScript (spec 058 §5).
  */
 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 }
+            where: { [fieldName]: { containsValue: documentId } }
         });
     }
+    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.
+ * @deprecated Since spec 064 `runtime.delete()` checks restrictions against the final state of its
+ * whole plan, inside one atomic batch; this one-level, read-only pre-check remains for direct callers.
+ *
+ * Checks if a document can be deleted based on relation constraints. Throws {@link InvalidInputError}
+ * — before any mutation happens — if deletion is restricted, or if a `set-null` relation targets a
+ * `required: true` field that has live references: a null value can never satisfy a required field, so
+ * this is treated the same as `restrict` rather than failing deep inside a partially-completed cascade
+ * with a generic validation error (spec 058 §5's required-field-on-set-null guard).
+ *
+ * The same applies to a `cascade`/`set-null` relation whose dependent collection is managed by the
+ * auth adapter (spec 061): the cascade would be a generic write into that collection, which the runtime
+ * refuses for everyone, so it is rejected here — before any mutation, with a message about the document
+ * being deleted rather than about the managed collection — instead of failing part-way through.
+ *
+ * There is deliberately no supported way to clear the reference and retry: the auth adapter's own
+ * `updateUser` only accepts email/name/role/password, not an arbitrary custom field, so this rejection
+ * is not "remove the reference, then delete" advice — see the error message, and spec 061 §7/Non-goals.
+ * The only way past it is the documented raw `DatabaseAdapter` escape hatch (outside runtime guarantees).
  */
 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}'`);
-                }
+            const unsafeRequiredSetNull = onDelete === 'set-null' && options.required === true;
+            const authManagedDependent = onDelete !== 'restrict' && isAuthManagedCollection(ctx, collection.slug);
+            if (onDelete !== 'restrict' && !unsafeRequiredSetNull && !authManagedDependent)
+                continue;
+            const referencing = await findReferencingDocuments(ctx, collection, fieldName, documentId, options.many ?? false);
+            if (referencing.length === 0)
+                continue;
+            if (authManagedDependent) {
+                throw new InvalidInputError(`Cannot delete document '${documentId}' from '${targetCollection.slug}': ` +
+                    `${referencing.length} document(s) in '${collection.slug}' reference it with ` +
+                    `onDelete '${onDelete}', but '${collection.slug}' is managed by the configured auth adapter, ` +
+                    `so a relation cascade cannot change it. Clearing the reference on those document(s) is not ` +
+                    `possible through generic collection CRUD or the auth adapter's user-management operations; ` +
+                    `it requires direct database access, which is outside runtime guarantees`);
             }
+            if (unsafeRequiredSetNull) {
+                throw new InvalidInputError(`Cannot delete document '${documentId}' from '${targetCollection.slug}': field '${fieldName}' ` +
+                    `on '${collection.slug}' is required and configured 'onDelete: set-null', which cannot ` +
+                    `satisfy ${referencing.length} referencing document(s) without violating that requirement`);
+            }
+            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.
+ * @deprecated Not atomic — each dependent delete commits on its own. `runtime.delete()` (spec 064)
+ * commits the whole cascade graph in one batch and no longer calls this.
+ *
+ * Handles cascade delete: deletes all documents that reference the deleted document. With a real
+ * mutator supplied, each dependent delete recurses through the full delete pipeline (its own
+ * `checkDeleteRestrictions`/cascade/set-null included) — so a cascade chain several levels deep is
+ * fully processed, not just one level. Not transactional: if a later step fails (a second-level
+ * `restrict`, a hook throwing, a DB error), documents already deleted by earlier steps stay deleted —
+ * the current `DatabaseAdapter` contract has no cross-document transaction to roll back with, and this
+ * matches the pre-058 code's identical (if previously undocumented) property.
  */
-export async function handleCascadeDelete(ctx, targetCollection, documentId) {
+export async function handleCascadeDelete(ctx, targetCollection, documentId, integrityOptions = {}) {
+    const mutator = integrityOptions.mutator ?? defaultMutator(ctx);
+    const visited = integrityOptions.visited ?? new Set();
+    const user = integrityOptions.user ?? null;
     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);
-                }
+            if (onDelete !== 'cascade')
+                continue;
+            const referencing = await findReferencingDocuments(ctx, collection, fieldName, documentId, options.many ?? false);
+            for (const doc of referencing) {
+                const key = `${collection.slug}:${doc.id}`;
+                // Already deleted (or in progress) via another cascade path, or a reference cycle — do not
+                // reprocess or recurse forever.
+                if (visited.has(key))
+                    continue;
+                visited.add(key);
+                await mutator.deleteDocument({
+                    collection: collection.slug,
+                    id: doc.id,
+                    overrideAccess: true,
+                    ...(user !== null && { user })
+                });
             }
         }
     }
 }
 /**
- * Handles set-null: sets relation fields to null in all referencing documents.
+ * @deprecated Not atomic — each update commits on its own. `runtime.delete()` (spec 064) commits its
+ * set-null updates in the same batch as the delete and no longer calls this.
+ *
+ * Handles set-null: sets relation fields to null (or removes the id from a many-relation array) in
+ * all referencing documents. Skips a document already processed elsewhere in this same delete
+ * operation (cascade-deleted, or already set-null'd via another field/path) via the shared `visited`
+ * set — including the case of a self-relation pointing a document at itself, which would otherwise try
+ * to update a row that is itself mid-deletion.
  */
-export async function handleSetNullOnDelete(ctx, targetCollection, documentId) {
+export async function handleSetNullOnDelete(ctx, targetCollection, documentId, integrityOptions = {}) {
+    const mutator = integrityOptions.mutator ?? defaultMutator(ctx);
+    const visited = integrityOptions.visited ?? new Set();
+    const user = integrityOptions.user ?? null;
     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
-                        });
-                    }
-                }
+            if (onDelete !== 'set-null')
+                continue;
+            const referencing = await findReferencingDocuments(ctx, collection, fieldName, documentId, options.many ?? false);
+            for (const doc of referencing) {
+                const key = `${collection.slug}:${doc.id}`;
+                if (visited.has(key))
+                    continue;
+                visited.add(key);
+                const newValue = options.many
+                    ? (doc[fieldName] ?? []).filter((id) => id !== documentId)
+                    : null;
+                await mutator.update({
+                    collection: collection.slug,
+                    id: doc.id,
+                    data: { [fieldName]: newValue },
+                    overrideAccess: true,
+                    ...(user !== null && { user })
+                });
             }
         }
     }
 }
 /**
- * Finds orphaned documents: documents with relation fields pointing to non-existent documents.
+ * Finds orphaned documents: documents whose top-level `relation` or `upload` field points at a document
+ * that does not exist. Diagnostic only — nothing is repaired. Since spec 064 a successfully committed
+ * supported write or delete cannot create one; orphans found here predate it, or were written through
+ * the raw `DatabaseAdapter` or the auth adapter's user lifecycle.
  */
 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')
+        if (field.kind !== 'relation' && field.kind !== 'upload')
             continue;
         const options = field.options;
         const targetCollection = options.collection;
+        const many = field.kind === 'relation' && options.many === true;
         for (const doc of allDocs) {
             const value = doc[fieldName];
-            if (options.many && Array.isArray(value)) {
+            if (many && Array.isArray(value)) {
                 // Check each ID in the array
                 for (const id of value) {
                     if (typeof id === 'string') {

package/dist/relation-integrity.js.map

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

package/dist/relation-lifecycle.d.ts

@@ -0,0 +1,95 @@
+import type { CollectionDefinition, FieldMap, GlobalDefinition } from '@forge-cms/core';
+import type { AtomicWriteOperation, DatabaseRecord, DatabaseWhere } from '@forge-cms/db';
+import type { OperationContext } from './context.js';
+/**
+ * The reference shapes relation integrity cannot enforce (spec 064 §2), found at startup so they are
+ * refused instead of silently ignored. Returns one message per problem (empty = supported). Reads the
+ * schema only — never persisted data.
+ *
+ * `isAuthManaged` answers `AuthAdapter.managesCollection` (spec 061); `onDelete: 'cascade' | 'set-null'`
+ * onto such a collection could never run, because its documents are only ever deleted by the auth
+ * adapter's own user lifecycle.
+ */
+export declare function validateRelationSchema(collections: readonly CollectionDefinition[], globals?: readonly GlobalDefinition[], isAuthManaged?: (slug: string) => boolean): string[];
+/**
+ * "No row references any of `ids` in `target` any more" — one `assertCount(…, 0)` per referring field of
+ * a collection or global. The single definition of the final-state reference guard, shared by a content
+ * delete's plan and by the guard an auth adapter commits with its own user delete (spec 065).
+ */
+export declare function noReferenceAssertions(ctx: OperationContext, target: string, ids: readonly string[]): AtomicWriteOperation[];
+/** Whether any supported relation/upload field of a collection or global references `target`. */
+export declare function isReferenced(ctx: OperationContext, target: string): boolean;
+/** Target collection → the unique ids a write references there, plus the fields that wrote them. */
+export type WrittenTargets = Map<string, {
+    ids: Set<string>;
+    fields: Set<string>;
+}>;
+/**
+ * The relation targets a write introduces. On update (`existing` given) only values that change count:
+ * a single reference different from the stored one, and for `many` only ids not already stored — so a
+ * partial update that leaves a (possibly historically orphaned) reference alone validates nothing.
+ */
+export declare function collectWrittenTargets(fields: FieldMap, data: Record<string, unknown>, existing?: Record<string, unknown>): WrittenTargets;
+/**
+ * The references an update **re-sends unchanged** (spec 064 §4): single values equal to the stored one,
+ * and ids of a `many` value already stored. They are not target-checked (a historical orphan must stay
+ * saveable), so instead the write only commits while the row **still holds them**. Otherwise a relation
+ * delete that cleared them after this update read the row (set-null) would be silently undone, leaving a
+ * reference to the deleted document. `undefined` when nothing is re-sent.
+ */
+export declare function echoedReferenceGuard(fields: FieldMap, data: Record<string, unknown>, existing: Record<string, unknown>): DatabaseWhere | undefined;
+/**
+ * The deterministic answer for a write naming a target that does not exist: one `count` per target
+ * collection (an `in` over the unique ids, not a read per id), then a `400` naming the field and the
+ * missing ids. This is the only place "missing" is reported as bad input — a target that disappears
+ * after this read fails the write's own `assertCount` instead (a `409`, see {@link targetAssertions}).
+ */
+export declare function verifyTargetsExist(ctx: OperationContext, targets: WrittenTargets): Promise<void>;
+/**
+ * `assertCount`s proving every written target still exists when the write commits: one per target
+ * collection, or one per 90 ids of a very large `many` write (each counts against the batch cap).
+ */
+export declare function targetAssertions(targets: WrittenTargets): AtomicWriteOperation[];
+export interface PlannedDelete {
+    collection: CollectionDefinition;
+    /** The document as read while planning; its `updated_at` guards the batch and its `_storageKey` is cleaned up. */
+    doc: DatabaseRecord;
+}
+export interface PlannedSetNull {
+    collection: CollectionDefinition;
+    id: string;
+    /** Field → the deleted ids to clear from it (single → `null`, many → removed from the array). */
+    removals: Map<string, {
+        many: boolean;
+        ids: Set<string>;
+    }>;
+}
+export interface RelationDeletePlan {
+    /** Root first, then dependents in discovery order. */
+    deletes: PlannedDelete[];
+    setNulls: PlannedSetNull[];
+    /** "No surviving row references a deleted document", checked last in the batch (final state). */
+    assertions: AtomicWriteOperation[];
+}
+/**
+ * Plans a delete's complete relation consequences **with reads only** — nothing is written and no hook
+ * runs here. Breadth-first over `collection:id` keys, each scheduled at most once, so self references,
+ * cycles and diamonds terminate. Every referencing-row query is bounded (`limit: MAX + 1`): a plan that
+ * could not fit in one batch is refused, never truncated or chunked.
+ *
+ * Restrict and required set-null are judged against the **final** state: a reference only blocks the
+ * delete if the document holding it survives (a restrict referrer that is itself cascade-deleted in the
+ * same plan does not block). Throws `InvalidInputError` for a blocking restrict, a surviving required
+ * set-null, a cascade/set-null into an auth-managed collection (spec 061), or an oversized plan.
+ */
+export declare function planRelationDelete(ctx: OperationContext, root: {
+    collection: CollectionDefinition;
+    doc: DatabaseRecord;
+}): Promise<RelationDeletePlan>;
+/**
+ * The set-null patch for `doc` as it is now: single references to a deleted id become `null`, deleted
+ * ids are removed from `many` arrays. `null` when the document no longer references any of them (it
+ * changed since planning) — then there is nothing to write.
+ */
+export declare function setNullPatch(planned: PlannedSetNull, doc: DatabaseRecord): Record<string, unknown> | null;
+//# sourceMappingURL=relation-lifecycle.d.ts.map

package/dist/relation-lifecycle.d.ts.map

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