canopycms 0.0.0

package/dist/utils/error.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Error handling utilities for type-safe error handling.
+ *
+ * These utilities help convert `catch (err: unknown)` to usable error information
+ * without using `any` types.
+ */
+/**
+ * Extract a message string from an unknown error value.
+ *
+ * @param err - The caught error (unknown type)
+ * @returns A string message suitable for logging or user display
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await riskyOperation()
+ * } catch (err: unknown) {
+ *   console.error('Operation failed:', getErrorMessage(err))
+ * }
+ * ```
+ */
+export declare function getErrorMessage(err: unknown): string;
+/**
+ * Type guard to check if an error is a Node.js system error with a code property.
+ *
+ * @param err - The caught error (unknown type)
+ * @returns True if the error has a `code` property (like ENOENT, EACCES, etc.)
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await fs.readFile(path)
+ * } catch (err: unknown) {
+ *   if (isNodeError(err) && err.code === 'ENOENT') {
+ *     return null // File not found is expected
+ *   }
+ *   throw err
+ * }
+ * ```
+ */
+export declare function isNodeError(err: unknown): err is NodeJS.ErrnoException;
+/**
+ * Check if an error indicates a "file not found" condition.
+ *
+ * @param err - The caught error (unknown type)
+ * @returns True if the error is ENOENT (file/directory not found)
+ */
+export declare function isNotFoundError(err: unknown): boolean;
+/**
+ * Check if an error indicates a "permission denied" condition.
+ *
+ * @param err - The caught error (unknown type)
+ * @returns True if the error is EACCES (permission denied)
+ */
+export declare function isPermissionError(err: unknown): boolean;
+/**
+ * Check if an error indicates a "file already exists" condition.
+ *
+ * @param err - The caught error (unknown type)
+ * @returns True if the error is EEXIST (file already exists)
+ */
+export declare function isFileExistsError(err: unknown): boolean;
+//# sourceMappingURL=error.d.ts.map

package/dist/utils/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/utils/error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAQpD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM,CAAC,cAAc,CAEtE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAErD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEvD"}

package/dist/utils/error.js

@@ -0,0 +1,79 @@
+/**
+ * Error handling utilities for type-safe error handling.
+ *
+ * These utilities help convert `catch (err: unknown)` to usable error information
+ * without using `any` types.
+ */
+/**
+ * Extract a message string from an unknown error value.
+ *
+ * @param err - The caught error (unknown type)
+ * @returns A string message suitable for logging or user display
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await riskyOperation()
+ * } catch (err: unknown) {
+ *   console.error('Operation failed:', getErrorMessage(err))
+ * }
+ * ```
+ */
+export function getErrorMessage(err) {
+    if (err instanceof Error) {
+        return err.message;
+    }
+    if (typeof err === 'string') {
+        return err;
+    }
+    return String(err);
+}
+/**
+ * Type guard to check if an error is a Node.js system error with a code property.
+ *
+ * @param err - The caught error (unknown type)
+ * @returns True if the error has a `code` property (like ENOENT, EACCES, etc.)
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await fs.readFile(path)
+ * } catch (err: unknown) {
+ *   if (isNodeError(err) && err.code === 'ENOENT') {
+ *     return null // File not found is expected
+ *   }
+ *   throw err
+ * }
+ * ```
+ */
+export function isNodeError(err) {
+    return err instanceof Error && 'code' in err;
+}
+/**
+ * Check if an error indicates a "file not found" condition.
+ *
+ * @param err - The caught error (unknown type)
+ * @returns True if the error is ENOENT (file/directory not found)
+ */
+export function isNotFoundError(err) {
+    return isNodeError(err) && err.code === 'ENOENT';
+}
+/**
+ * Check if an error indicates a "permission denied" condition.
+ *
+ * @param err - The caught error (unknown type)
+ * @returns True if the error is EACCES (permission denied)
+ */
+export function isPermissionError(err) {
+    return isNodeError(err) && err.code === 'EACCES';
+}
+/**
+ * Check if an error indicates a "file already exists" condition.
+ *
+ * @param err - The caught error (unknown type)
+ * @returns True if the error is EEXIST (file already exists)
+ */
+export function isFileExistsError(err) {
+    return isNodeError(err) && err.code === 'EEXIST';
+}
+//# sourceMappingURL=error.js.map

package/dist/utils/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/utils/error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC,OAAO,CAAA;IACpB,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,GAAG,CAAA;IACZ,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAA;AACpB,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,OAAO,GAAG,YAAY,KAAK,IAAI,MAAM,IAAI,GAAG,CAAA;AAC9C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,OAAO,WAAW,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAA;AAClD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC5C,OAAO,WAAW,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAA;AAClD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC5C,OAAO,WAAW,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAA;AAClD,CAAC"}

package/dist/utils/format.d.ts

@@ -0,0 +1,8 @@
+import type { ContentFormat } from '../config';
+/**
+ * Get the file extension for a content format
+ * @param format - The content format (md, mdx, json)
+ * @returns The file extension including the dot (e.g., '.md', '.json')
+ */
+export declare const getFormatExtension: (format: ContentFormat) => string;
+//# sourceMappingURL=format.d.ts.map

package/dist/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAE9C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,aAAa,KAAG,MAI1D,CAAA"}

package/dist/utils/format.js

@@ -0,0 +1,13 @@
+/**
+ * Get the file extension for a content format
+ * @param format - The content format (md, mdx, json)
+ * @returns The file extension including the dot (e.g., '.md', '.json')
+ */
+export const getFormatExtension = (format) => {
+    if (format === 'md')
+        return '.md';
+    if (format === 'mdx')
+        return '.mdx';
+    return '.json';
+};
+//# sourceMappingURL=format.js.map

package/dist/utils/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAqB,EAAU,EAAE;IAClE,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,KAAK,CAAA;IACjC,IAAI,MAAM,KAAK,KAAK;QAAE,OAAO,MAAM,CAAA;IACnC,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA"}

package/dist/validation/deletion-checker.d.ts

@@ -0,0 +1,66 @@
+import type { ContentStore } from '../content-store';
+import type { ContentIdIndex } from '../content-id-index';
+import type { FieldConfig } from '../config';
+import { type LogicalPath, type EntrySlug } from '../paths';
+export interface ReferenceInfo {
+    entryPath: string;
+    entryTitle?: string;
+    collection: LogicalPath;
+    slug: EntrySlug;
+    fields: string[];
+}
+export interface DeletionCheckResult {
+    canDelete: boolean;
+    referencedBy: ReferenceInfo[];
+}
+/**
+ * DeletionChecker finds all references to an entry before deletion.
+ *
+ * This class provides referential integrity checking by:
+ * - Scanning all entries for references to a target ID
+ * - Identifying which entries and fields reference the target
+ * - Preventing deletion of entries that are still referenced
+ *
+ * Usage:
+ *   const checker = new DeletionChecker(store, idIndex, schema)
+ *   const result = await checker.canDelete(targetId)
+ *   if (!result.canDelete) {
+ *     console.log('Cannot delete:', result.referencedBy)
+ *   }
+ */
+export declare class DeletionChecker {
+    private store;
+    private idIndex;
+    private collections;
+    constructor(store: ContentStore, idIndex: ContentIdIndex, collections: Map<LogicalPath, {
+        fields: FieldConfig[];
+    }>);
+    /**
+     * Check if an entry can be safely deleted.
+     *
+     * @param id - The content ID to check
+     * @returns Result indicating if deletion is safe and what references exist
+     */
+    canDelete(id: string): Promise<DeletionCheckResult>;
+    /**
+     * Find all entries that reference the target ID.
+     *
+     * @param targetId - The content ID to search for
+     * @returns Array of reference info for each referencing entry
+     */
+    findReferences(targetId: string): Promise<ReferenceInfo[]>;
+    /**
+     * Scan a single collection for references to the target ID.
+     */
+    private scanCollection;
+    /**
+     * Find all occurrences of target ID in entry data.
+     * Returns field paths where the ID was found.
+     */
+    private findIdInData;
+    /**
+     * Helper to list all entries in a collection from the ID index.
+     */
+    private listEntriesInCollection;
+}
+//# sourceMappingURL=deletion-checker.d.ts.map

package/dist/validation/deletion-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deletion-checker.d.ts","sourceRoot":"","sources":["../../src/validation/deletion-checker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,WAAW,EAAuC,MAAM,WAAW,CAAA;AACjF,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAqB,MAAM,UAAU,CAAA;AAE9E,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,WAAW,CAAA;IACvB,IAAI,EAAE,SAAS,CAAA;IACf,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,OAAO,CAAA;IAClB,YAAY,EAAE,aAAa,EAAE,CAAA;CAC9B;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,eAAe;IAExB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,WAAW;gBAFX,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE;QAAE,MAAM,EAAE,WAAW,EAAE,CAAA;KAAE,CAAC;IAGlE;;;;;OAKG;IACG,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAQzD;;;;;OAKG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAYhE;;OAEG;YACW,cAAc;IAkC5B;;;OAGG;IACH,OAAO,CAAC,YAAY;IAqFpB;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAgChC"}

package/dist/validation/deletion-checker.js

@@ -0,0 +1,163 @@
+/**
+ * DeletionChecker finds all references to an entry before deletion.
+ *
+ * This class provides referential integrity checking by:
+ * - Scanning all entries for references to a target ID
+ * - Identifying which entries and fields reference the target
+ * - Preventing deletion of entries that are still referenced
+ *
+ * Usage:
+ *   const checker = new DeletionChecker(store, idIndex, schema)
+ *   const result = await checker.canDelete(targetId)
+ *   if (!result.canDelete) {
+ *     console.log('Cannot delete:', result.referencedBy)
+ *   }
+ */
+export class DeletionChecker {
+    constructor(store, idIndex, collections) {
+        this.store = store;
+        this.idIndex = idIndex;
+        this.collections = collections;
+    }
+    /**
+     * Check if an entry can be safely deleted.
+     *
+     * @param id - The content ID to check
+     * @returns Result indicating if deletion is safe and what references exist
+     */
+    async canDelete(id) {
+        const referencedBy = await this.findReferences(id);
+        return {
+            canDelete: referencedBy.length === 0,
+            referencedBy,
+        };
+    }
+    /**
+     * Find all entries that reference the target ID.
+     *
+     * @param targetId - The content ID to search for
+     * @returns Array of reference info for each referencing entry
+     */
+    async findReferences(targetId) {
+        const references = [];
+        // Scan all collections for references
+        for (const [collectionPath, collectionDef] of this.collections.entries()) {
+            const refs = await this.scanCollection(collectionPath, collectionDef.fields, targetId);
+            references.push(...refs);
+        }
+        return references;
+    }
+    /**
+     * Scan a single collection for references to the target ID.
+     */
+    async scanCollection(collectionPath, fields, targetId) {
+        const references = [];
+        // Get all entries in this collection from the ID index
+        const entries = this.listEntriesInCollection(collectionPath);
+        for (const entry of entries) {
+            try {
+                const doc = await this.store.read(entry.collection, entry.slug);
+                const refs = this.findIdInData(doc.data, targetId, fields);
+                if (refs.length > 0) {
+                    const id = this.idIndex.findByPath(entry.relativePath);
+                    references.push({
+                        entryPath: id || '',
+                        entryTitle: doc.data.title,
+                        collection: entry.collection,
+                        slug: entry.slug,
+                        fields: refs,
+                    });
+                }
+            }
+            catch {
+                // Skip entries that can't be read
+                continue;
+            }
+        }
+        return references;
+    }
+    /**
+     * Find all occurrences of target ID in entry data.
+     * Returns field paths where the ID was found.
+     */
+    findIdInData(data, targetId, schema, pathPrefix = '') {
+        const found = [];
+        for (const field of schema) {
+            const fieldPath = pathPrefix ? `${pathPrefix}.${field.name}` : field.name;
+            const value = data[field.name];
+            if (value === undefined || value === null)
+                continue;
+            if (field.type === 'reference') {
+                // Check if this reference field contains the target ID
+                if (Array.isArray(value)) {
+                    if (value.includes(targetId)) {
+                        found.push(fieldPath);
+                    }
+                }
+                else if (value === targetId) {
+                    found.push(fieldPath);
+                }
+            }
+            else if (field.type === 'object') {
+                // Recurse into object fields
+                const objectField = field;
+                if (objectField.fields && typeof value === 'object' && !Array.isArray(value)) {
+                    found.push(...this.findIdInData(value, targetId, objectField.fields, fieldPath));
+                }
+            }
+            else if (field.type === 'block') {
+                // Handle block fields
+                const blockField = field;
+                if (Array.isArray(value)) {
+                    value.forEach((item, index) => {
+                        if (typeof item === 'object' && item !== null) {
+                            const blockType = item._type;
+                            const blockDef = blockField.templates?.find((b) => b.name === blockType);
+                            if (blockDef && blockDef.fields) {
+                                found.push(...this.findIdInData(item, targetId, blockDef.fields, `${fieldPath}[${index}]`));
+                            }
+                        }
+                    });
+                }
+            }
+            else if (field.type === 'array') {
+                // Handle array fields
+                const arrayField = field;
+                if (Array.isArray(value) && arrayField.of) {
+                    const ofFields = arrayField.of.fields;
+                    if (arrayField.of.type === 'object' && ofFields) {
+                        value.forEach((item, index) => {
+                            if (typeof item === 'object' && item !== null) {
+                                found.push(...this.findIdInData(item, targetId, ofFields, `${fieldPath}[${index}]`));
+                            }
+                        });
+                    }
+                }
+            }
+        }
+        return found;
+    }
+    /**
+     * Helper to list all entries in a collection from the ID index.
+     */
+    listEntriesInCollection(collectionPath) {
+        const entries = [];
+        // Get all locations from the index
+        const allLocations = this.idIndex.getAllLocations();
+        for (const location of allLocations) {
+            if (location.type === 'entry') {
+                // Check if this entry is in the target collection
+                if (location.collection === collectionPath ||
+                    location.collection?.startsWith(collectionPath + '/')) {
+                    entries.push({
+                        relativePath: location.relativePath,
+                        collection: location.collection,
+                        slug: location.slug,
+                    });
+                }
+            }
+        }
+        return entries;
+    }
+}
+//# sourceMappingURL=deletion-checker.js.map

package/dist/validation/deletion-checker.js.map

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

package/dist/validation/field-traversal.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Shared field traversal utility for schema-aware data traversal.
+ *
+ * This module provides a generic way to traverse nested data structures
+ * according to a schema, handling objects, blocks, and arrays with their
+ * own schemas.
+ */
+import type { FieldConfig } from '../config';
+/**
+ * Context provided to the visitor function for each field.
+ */
+export interface TraversalContext {
+    /** The field configuration from the schema */
+    field: FieldConfig;
+    /** The value at this field in the data */
+    value: unknown;
+    /** The dot-notation path to this field (e.g., "author.name" or "blocks[0].title") */
+    path: string;
+}
+/**
+ * Visitor function that receives each field and can return results.
+ * Return an empty array to skip this field, or return items to collect.
+ */
+export type FieldVisitor<T> = (context: TraversalContext) => T[];
+/**
+ * Recursively traverse fields in data according to schema.
+ *
+ * This function walks through data following the schema structure, calling
+ * the visitor function for each field. It handles:
+ * - Simple fields (string, number, boolean, reference, etc.)
+ * - Object fields with nested schemas
+ * - Block fields (arrays of typed objects with different schemas)
+ * - Array fields containing objects with schemas
+ *
+ * @param fields - The schema fields to traverse
+ * @param data - The data object to traverse
+ * @param visitor - Function called for each field, returns items to collect
+ * @param pathPrefix - Current path prefix for nested fields
+ * @returns Array of all items returned by the visitor
+ *
+ * @example
+ * ```ts
+ * // Find all reference field values
+ * const refs = traverseFields(schema, data, ({ field, value, path }) => {
+ *   if (field.type === 'reference') {
+ *     return [{ path, ids: Array.isArray(value) ? value : [value] }]
+ *   }
+ *   return []
+ * })
+ * ```
+ */
+export declare function traverseFields<T>(fields: readonly FieldConfig[], data: Record<string, unknown>, visitor: FieldVisitor<T>, pathPrefix?: string): T[];
+/**
+ * Find all fields of a specific type in the data.
+ *
+ * @param fields - The schema fields
+ * @param data - The data to search
+ * @param fieldType - The field type to find (e.g., 'reference', 'string')
+ * @returns Array of { field, value, path } for matching fields
+ */
+export declare function findFieldsByType(fields: readonly FieldConfig[], data: Record<string, unknown>, fieldType: string): TraversalContext[];
+//# sourceMappingURL=field-traversal.d.ts.map

package/dist/validation/field-traversal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-traversal.d.ts","sourceRoot":"","sources":["../../src/validation/field-traversal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAuC,MAAM,WAAW,CAAA;AAEjF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,KAAK,EAAE,WAAW,CAAA;IAClB,0CAA0C;IAC1C,KAAK,EAAE,OAAO,CAAA;IACd,qFAAqF;IACrF,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,gBAAgB,KAAK,CAAC,EAAE,CAAA;AAiBhE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EACxB,UAAU,SAAK,GACd,CAAC,EAAE,CAiDL;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,SAAS,EAAE,MAAM,GAChB,gBAAgB,EAAE,CAOpB"}

package/dist/validation/field-traversal.js

@@ -0,0 +1,95 @@
+/**
+ * Shared field traversal utility for schema-aware data traversal.
+ *
+ * This module provides a generic way to traverse nested data structures
+ * according to a schema, handling objects, blocks, and arrays with their
+ * own schemas.
+ */
+/**
+ * Get the nested fields for a block template by looking up _type.
+ */
+function getBlockTemplateFields(blockField, item) {
+    const blockType = item._type;
+    if (!blockType)
+        return undefined;
+    // Block fields use 'templates' property
+    const template = blockField.templates?.find((t) => t.name === blockType);
+    return template?.fields;
+}
+/**
+ * Recursively traverse fields in data according to schema.
+ *
+ * This function walks through data following the schema structure, calling
+ * the visitor function for each field. It handles:
+ * - Simple fields (string, number, boolean, reference, etc.)
+ * - Object fields with nested schemas
+ * - Block fields (arrays of typed objects with different schemas)
+ * - Array fields containing objects with schemas
+ *
+ * @param fields - The schema fields to traverse
+ * @param data - The data object to traverse
+ * @param visitor - Function called for each field, returns items to collect
+ * @param pathPrefix - Current path prefix for nested fields
+ * @returns Array of all items returned by the visitor
+ *
+ * @example
+ * ```ts
+ * // Find all reference field values
+ * const refs = traverseFields(schema, data, ({ field, value, path }) => {
+ *   if (field.type === 'reference') {
+ *     return [{ path, ids: Array.isArray(value) ? value : [value] }]
+ *   }
+ *   return []
+ * })
+ * ```
+ */
+export function traverseFields(fields, data, visitor, pathPrefix = '') {
+    const results = [];
+    for (const field of fields) {
+        const fieldPath = pathPrefix ? `${pathPrefix}.${field.name}` : field.name;
+        const value = data[field.name];
+        // Skip undefined/null values
+        if (value === undefined || value === null)
+            continue;
+        // Let visitor handle this field first
+        results.push(...visitor({ field, value, path: fieldPath }));
+        // Then recurse into nested structures
+        if (field.type === 'object') {
+            const objectField = field;
+            if (objectField.fields && typeof value === 'object' && !Array.isArray(value)) {
+                results.push(...traverseFields(objectField.fields, value, visitor, fieldPath));
+            }
+        }
+        else if (field.type === 'block') {
+            const blockField = field;
+            if (Array.isArray(value)) {
+                value.forEach((item, index) => {
+                    if (typeof item === 'object' && item !== null) {
+                        const blockFields = getBlockTemplateFields(blockField, item);
+                        if (blockFields) {
+                            results.push(...traverseFields(blockFields, item, visitor, `${fieldPath}[${index}]`));
+                        }
+                    }
+                });
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Find all fields of a specific type in the data.
+ *
+ * @param fields - The schema fields
+ * @param data - The data to search
+ * @param fieldType - The field type to find (e.g., 'reference', 'string')
+ * @returns Array of { field, value, path } for matching fields
+ */
+export function findFieldsByType(fields, data, fieldType) {
+    return traverseFields(fields, data, (ctx) => {
+        if (ctx.field.type === fieldType) {
+            return [ctx];
+        }
+        return [];
+    });
+}
+//# sourceMappingURL=field-traversal.js.map

package/dist/validation/field-traversal.js.map

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

package/dist/validation/reference-validator.d.ts

@@ -0,0 +1,45 @@
+import type { ContentIdIndex } from '../content-id-index';
+import type { FieldConfig, ReferenceFieldConfig } from '../config';
+export interface ValidationError {
+    field: string;
+    fieldPath: string;
+    id: string;
+    error: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+}
+/**
+ * ReferenceValidator validates that referenced content IDs exist and match collection constraints.
+ *
+ * This class provides validation for:
+ * - ID format validation (valid short UUID)
+ * - ID existence validation (entry actually exists)
+ * - Collection constraint validation (entry is in allowed collections)
+ *
+ * Usage:
+ *   const validator = new ReferenceValidator(idIndex, schema)
+ *   const result = await validator.validate(entryData)
+ *   if (!result.valid) {
+ *     console.error('Validation errors:', result.errors)
+ *   }
+ */
+export declare class ReferenceValidator {
+    private idIndex;
+    private schema;
+    constructor(idIndex: ContentIdIndex, schema: readonly FieldConfig[]);
+    /**
+     * Validate all reference fields in the provided data.
+     *
+     * @param data - The entry data to validate
+     * @returns Validation result with any errors found
+     */
+    validate(data: Record<string, unknown>): Promise<ValidationResult>;
+    /**
+     * Validate a single reference ID.
+     * Useful for validating user input in real-time.
+     */
+    validateSingle(id: string, field: ReferenceFieldConfig): Promise<ValidationError | null>;
+}
+//# sourceMappingURL=reference-validator.d.ts.map

package/dist/validation/reference-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-validator.d.ts","sourceRoot":"","sources":["../../src/validation/reference-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAIlE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,eAAe,EAAE,CAAA;CAC1B;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,MAAM;gBADN,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,SAAS,WAAW,EAAE;IAGxC;;;;;OAKG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAyExE;;;OAGG;IACG,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;CA8C/F"}