canopycms 0.0.0

package/dist/reference-resolver.js

@@ -0,0 +1,118 @@
+import path from 'node:path';
+import { extractSlugFromFilename } from './content-id-index';
+/**
+ * ReferenceResolver resolves content IDs to display values for reference fields.
+ *
+ * This class provides utilities for:
+ * - Resolving a single ID to its display value (e.g., title)
+ * - Loading all available options for a reference field
+ * - Filtering options by collection constraints
+ * - Searching options by display value
+ */
+export class ReferenceResolver {
+    constructor(store, idIndex) {
+        this.store = store;
+        this.idIndex = idIndex;
+    }
+    /**
+     * Resolve a content ID to a display value.
+     * Returns null if the ID doesn't exist or points to a collection.
+     *
+     * @param id - The content ID to resolve
+     * @param displayField - The field to use for display value (default: 'title')
+     */
+    async resolve(id, displayField = 'title') {
+        const location = this.idIndex.findById(id);
+        if (!location || location.type !== 'entry') {
+            return {
+                id,
+                exists: false,
+                displayValue: id, // Fallback to showing the ID itself
+            };
+        }
+        try {
+            const doc = await this.store.read(location.collection, location.slug);
+            const displayValue = String(doc.data[displayField] || doc.data.title || location.slug);
+            return {
+                id,
+                exists: true,
+                displayValue,
+                collection: location.collection,
+                slug: location.slug,
+            };
+        }
+        catch (error) {
+            console.error('Failed to resolve reference:', { id, error });
+            return {
+                id,
+                exists: false,
+                displayValue: id,
+            };
+        }
+    }
+    /**
+     * Load all available reference options for a reference field.
+     *
+     * This method scans the specified collections and returns options
+     * suitable for a dropdown/select field.
+     *
+     * @param collections - Collection paths to search (e.g., ['posts', 'docs'])
+     * @param displayField - Field to use for option labels (default: 'title')
+     * @param search - Optional search string to filter options
+     */
+    async loadReferenceOptions(collections, displayField = 'title', search) {
+        const options = [];
+        for (const collectionPath of collections) {
+            // Get all entries in this collection
+            const entries = await this.listEntriesInCollection(collectionPath);
+            for (const entry of entries) {
+                const id = this.idIndex.findByPath(entry.relativePath);
+                if (!id)
+                    continue;
+                try {
+                    // The slug from the index may include the entry type prefix for new-format files
+                    // (e.g., "author.alice" instead of just "alice"). We need to strip the type prefix
+                    // before passing to store.read() to avoid double-prefixing.
+                    // Use extractSlugFromFilename to properly extract just the slug part.
+                    const filename = path.basename(entry.relativePath);
+                    const normalizedSlug = extractSlugFromFilename(filename);
+                    const doc = await this.store.read(entry.collection, normalizedSlug);
+                    const label = String(doc.data[displayField] || doc.data.title || normalizedSlug);
+                    // Apply search filter if provided
+                    if (search && !label.toLowerCase().includes(search.toLowerCase())) {
+                        continue;
+                    }
+                    options.push({
+                        id,
+                        label,
+                        collection: entry.collection,
+                    });
+                }
+                catch (error) {
+                    // Skip entries that can't be read
+                    console.error('Failed to read entry for reference options:', {
+                        collection: entry.collection,
+                        slug: entry.slug,
+                        error,
+                    });
+                    continue;
+                }
+            }
+        }
+        return options.sort((a, b) => a.label.localeCompare(b.label));
+    }
+    /**
+     * Helper to list all entries in a collection.
+     */
+    async listEntriesInCollection(collectionPath) {
+        return this.store.listCollectionEntries(collectionPath);
+    }
+    /**
+     * Resolve multiple IDs at once.
+     * Useful for displaying lists of referenced items.
+     */
+    async resolveMany(ids, displayField = 'title') {
+        return Promise.all(ids.map((id) => this.resolve(id, displayField)));
+    }
+}
+//# sourceMappingURL=reference-resolver.js.map

package/dist/reference-resolver.js.map

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

package/dist/schema/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Schema Module
+ *
+ * This module provides schema loading and resolution for CanopyCMS.
+ * Schema structure is defined in .collection.json files (single source of truth)
+ * while field schemas are defined in an entry schema registry for reusability.
+ *
+ * @example
+ * ```ts
+ * import { resolveSchema } from 'canopycms/schema'
+ *
+ * const { schema, sources } = await resolveSchema(contentRoot, entrySchemaRegistry)
+ * ```
+ */
+export type { EntrySchemaRegistry, SchemaSourceInfo, SchemaResolutionResult } from './types';
+export { loadCollectionMetaFiles, resolveCollectionReferences, watchCollectionMetaFiles, type CollectionMeta, type RootCollectionMeta, } from './meta-loader';
+export { resolveSchema, hasSchemaFiles, isValidSchema } from './resolver';
+//# sourceMappingURL=index.d.ts.map

package/dist/schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAG5F,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,wBAAwB,EACxB,KAAK,cAAc,EACnB,KAAK,kBAAkB,GACxB,MAAM,eAAe,CAAA;AAGtB,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA"}

package/dist/schema/index.js

@@ -0,0 +1,19 @@
+/**
+ * Schema Module
+ *
+ * This module provides schema loading and resolution for CanopyCMS.
+ * Schema structure is defined in .collection.json files (single source of truth)
+ * while field schemas are defined in an entry schema registry for reusability.
+ *
+ * @example
+ * ```ts
+ * import { resolveSchema } from 'canopycms/schema'
+ *
+ * const { schema, sources } = await resolveSchema(contentRoot, entrySchemaRegistry)
+ * ```
+ */
+// Meta loader (low-level API)
+export { loadCollectionMetaFiles, resolveCollectionReferences, watchCollectionMetaFiles, } from './meta-loader';
+// Resolver (high-level API)
+export { resolveSchema, hasSchemaFiles, isValidSchema } from './resolver';
+//# sourceMappingURL=index.js.map

package/dist/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,8BAA8B;AAC9B,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,wBAAwB,GAGzB,MAAM,eAAe,CAAA;AAEtB,4BAA4B;AAC5B,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA"}

package/dist/schema/meta-loader.d.ts

@@ -0,0 +1,73 @@
+import type { RootCollectionConfig } from '../config';
+import type { ContentId } from '../paths/types';
+import type { EntrySchemaRegistry } from './types';
+export type EntryTypeMeta = {
+    name: string;
+    format: 'md' | 'mdx' | 'json';
+    schema: string;
+    label?: string;
+    default?: boolean;
+    maxItems?: number;
+};
+export type CollectionMeta = {
+    name: string;
+    label?: string;
+    entries?: EntryTypeMeta[];
+    order: string[];
+};
+export type RootCollectionMeta = {
+    label?: string;
+    entries?: EntryTypeMeta[];
+    order?: string[];
+};
+/**
+ * Loads all .collection.json meta files from contentRoot, including root.
+ *
+ * This function orchestrates the complete discovery process:
+ * 1. Attempts to load the root .collection.json (contentRoot/.collection.json) - optional
+ * 2. Recursively scans all subdirectories for .collection.json files
+ * 3. Returns both root configuration and nested collections
+ *
+ * Meta File Structure:
+ * - Root: contentRoot/.collection.json (optional, defines root-level entry types)
+ * - Collections: contentRoot/[path]/.collection.json (defines collection in that directory)
+ *
+ * @param contentRoot - Absolute path to the content directory
+ * @returns Object containing root meta (if exists) and array of collection metas with paths
+ * @throws Error if any .collection.json file is malformed or invalid
+ */
+export declare function loadCollectionMetaFiles(contentRoot: string): Promise<{
+    root: RootCollectionMeta | null;
+    collections: Array<CollectionMeta & {
+        path: string;
+        contentId?: ContentId;
+    }>;
+}>;
+/**
+ * Resolve schema references for root collection and all collections.
+ *
+ * This function takes the loaded meta files (which contain string references like "postSchema")
+ * and resolves them to actual EntrySchema arrays from the entry schema registry.
+ *
+ * Resolution Process:
+ * 1. Root entry types: Resolve "schema" string to entry schema registry lookup
+ * 2. Top-level collections: Resolve recursively, building nested tree structure
+ * 3. Nested collections: Automatically grouped under their parent collections
+ *
+ * @param metaFiles - Loaded meta files from loadCollectionMetaFiles()
+ * @param entrySchemaRegistry - Map of schema names to EntrySchema arrays
+ * @returns Fully resolved root collection config ready for use by CanopyCMS
+ * @throws Error if any schema reference doesn't exist in registry (with helpful suggestions)
+ */
+export declare function resolveCollectionReferences(metaFiles: {
+    root: RootCollectionMeta | null;
+    collections: Array<CollectionMeta & {
+        path: string;
+        contentId?: ContentId;
+    }>;
+}, entrySchemaRegistry: EntrySchemaRegistry): RootCollectionConfig;
+/**
+ * Watch for changes to .collection.json files
+ */
+export declare function watchCollectionMetaFiles(contentRoot: string, onChange: () => void): () => void;
+//# sourceMappingURL=meta-loader.d.ts.map

package/dist/schema/meta-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-loader.d.ts","sourceRoot":"","sources":["../../src/schema/meta-loader.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAGV,oBAAoB,EAErB,MAAM,WAAW,CAAA;AAClB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAkDlD,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,IAAI,GAAG,KAAK,GAAG,MAAM,CAAA;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,aAAa,EAAE,CAAA;IACzB,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,aAAa,EAAE,CAAA;IACzB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CACjB,CAAA;AAyFD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1E,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAAA;IAC/B,WAAW,EAAE,KAAK,CAAC,cAAc,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC,CAAA;CAC7E,CAAC,CAiCD;AAuED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE;IACT,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAAA;IAC/B,WAAW,EAAE,KAAK,CAAC,cAAc,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC,CAAA;CAC7E,EACD,mBAAmB,EAAE,mBAAmB,GACvC,oBAAoB,CAiCtB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAW9F"}

package/dist/schema/meta-loader.js

@@ -0,0 +1,273 @@
+import { promises as fs } from 'fs';
+import { join } from 'pathe';
+import { z } from 'zod';
+import chokidar from 'chokidar';
+import { extractSlugFromFilename, extractIdFromFilename } from '../content-id-index';
+/**
+ * Zod schema for entry type metadata in .collection.json files.
+ * Each entry type has a name, format, and schema reference to the entry schema registry.
+ */
+const entryTypeMetaSchema = z.object({
+    name: z.string().min(1),
+    format: z.enum(['md', 'mdx', 'json']),
+    schema: z.string().min(1), // Entry schema registry key (validated at resolution time)
+    label: z.string().optional(),
+    default: z.boolean().optional(),
+    maxItems: z.number().int().positive().optional(),
+});
+/**
+ * Zod schema for .collection.json files
+ *
+ * A collection folder can contain:
+ * - entries: Array of entry types with their own schemas
+ * - collections: Nested collections (discovered via their own .collection.json files)
+ *
+ * Note: We can't validate `schema` against entry schema registry keys at parse time because:
+ * 1. Entry schema registry is passed at runtime (not available during Zod schema definition)
+ * 2. Would create circular dependency (loader → services → config → loader)
+ *
+ * Validation of schema references happens in resolution functions with clear error messages.
+ */
+const collectionMetaSchema = z
+    .object({
+    name: z.string().min(1),
+    label: z.string().optional(),
+    entries: z.array(entryTypeMetaSchema).optional(),
+    order: z.array(z.string()), // Embedded IDs for ordering items (required)
+})
+    .refine((data) => data.entries && data.entries.length > 0, {
+    message: 'Collection must have at least one entry type',
+});
+/**
+ * Zod schema for root .collection.json file (content/.collection.json)
+ * Like other collections but no name/path (derived from contentRoot)
+ */
+const rootCollectionMetaSchema = z.object({
+    label: z.string().optional(),
+    entries: z.array(entryTypeMetaSchema).optional(),
+    order: z.array(z.string()).optional(), // Embedded IDs for ordering items
+});
+/**
+ * Recursively scans a directory for .collection.json files.
+ *
+ * Discovery Rules:
+ * - Scans recursively from the base directory (content root)
+ * - Each directory can have at most ONE .collection.json file
+ * - Collection path is derived from the directory structure (e.g., "docs/api" for content/docs/api/)
+ * - Collection name comes from the "name" field in .collection.json, NOT the directory name
+ * - Directories without .collection.json are still scanned for nested collections
+ * - Invalid .collection.json files cause the entire scan to fail with a descriptive error
+ *
+ * @param baseDir - The directory to scan (absolute path)
+ * @param relativePath - Current path relative to content root (used for recursion)
+ * @returns Array of collection metadata with resolved paths
+ */
+/**
+ * Strip embedded ID from a directory or file name.
+ * e.g., "docs.bChqT78gcaLd" -> "docs"
+ * e.g., "home.home.agfzDt2RLpSn.json" -> "home"
+ */
+function stripEmbeddedIdFromName(name) {
+    // Use extractSlugFromFilename which handles the ID extraction logic
+    return extractSlugFromFilename(name);
+}
+async function scanForCollectionMeta(baseDir, relativePath = '') {
+    const collections = [];
+    try {
+        const entries = await fs.readdir(baseDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const folderName = entry.name;
+            // Strip embedded ID from folder name for logical path
+            // e.g., "docs.bChqT78gcaLd" -> "docs"
+            const logicalName = stripEmbeddedIdFromName(folderName);
+            // Extract embedded ContentId from directory name (e.g., "posts.a1b2c3d4e5f6" → "a1b2c3d4e5f6")
+            const collectionContentId = extractIdFromFilename(folderName) ?? undefined;
+            const folderPath = relativePath ? `${relativePath}/${logicalName}` : logicalName;
+            const absolutePath = join(baseDir, folderName);
+            const metaPath = join(absolutePath, '.collection.json');
+            // Try to load collection meta file
+            try {
+                await fs.access(metaPath);
+                const content = await fs.readFile(metaPath, 'utf-8');
+                const parsed = JSON.parse(content);
+                // Validate with Zod
+                const meta = collectionMetaSchema.parse(parsed);
+                collections.push({
+                    ...meta,
+                    path: folderPath, // Path derived from folder name
+                    contentId: collectionContentId,
+                });
+                // Recursively scan for nested collection folders (they'll have their own .collection.json files)
+                const nestedCollections = await scanForCollectionMeta(absolutePath, folderPath);
+                collections.push(...nestedCollections);
+            }
+            catch (err) {
+                if (err.code !== 'ENOENT') {
+                    // File exists but is invalid
+                    console.error(`Error loading ${metaPath}:`, err);
+                    throw new Error(`Invalid .collection.json in ${folderPath}: ${err.message}`);
+                }
+                // No .collection.json - still scan subfolders in case they have collections
+                const nestedCollections = await scanForCollectionMeta(absolutePath, folderPath);
+                collections.push(...nestedCollections);
+            }
+        }
+        return collections;
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            return [];
+        }
+        throw err;
+    }
+}
+/**
+ * Loads all .collection.json meta files from contentRoot, including root.
+ *
+ * This function orchestrates the complete discovery process:
+ * 1. Attempts to load the root .collection.json (contentRoot/.collection.json) - optional
+ * 2. Recursively scans all subdirectories for .collection.json files
+ * 3. Returns both root configuration and nested collections
+ *
+ * Meta File Structure:
+ * - Root: contentRoot/.collection.json (optional, defines root-level entry types)
+ * - Collections: contentRoot/[path]/.collection.json (defines collection in that directory)
+ *
+ * @param contentRoot - Absolute path to the content directory
+ * @returns Object containing root meta (if exists) and array of collection metas with paths
+ * @throws Error if any .collection.json file is malformed or invalid
+ */
+export async function loadCollectionMetaFiles(contentRoot) {
+    // Load root .collection.json (optional)
+    let root = null;
+    const rootMetaPath = join(contentRoot, '.collection.json');
+    try {
+        await fs.access(rootMetaPath);
+    }
+    catch (err) {
+        // No root .collection.json - that's okay
+        if (err.code === 'ENOENT') {
+            // File doesn't exist, that's fine
+        }
+        else {
+            throw err;
+        }
+    }
+    // If file exists, try to read and parse it
+    try {
+        const content = await fs.readFile(rootMetaPath, 'utf-8');
+        const parsed = JSON.parse(content);
+        root = rootCollectionMetaSchema.parse(parsed);
+    }
+    catch (err) {
+        // Only handle errors if the file exists (not ENOENT)
+        const errno = err.code;
+        if (errno !== 'ENOENT') {
+            throw new Error(`Invalid root .collection.json`);
+        }
+    }
+    // Scan for collection folders
+    const collections = await scanForCollectionMeta(contentRoot);
+    return { root, collections };
+}
+/**
+ * Resolve schema references for entry types
+ */
+function resolveEntryTypes(entryTypes, entrySchemaRegistry, contextName) {
+    return entryTypes.map((entryType) => {
+        const resolvedSchema = entrySchemaRegistry[entryType.schema];
+        if (!resolvedSchema) {
+            throw new Error(`Schema reference "${entryType.schema}" in entry type "${entryType.name}" (${contextName}) not found in registry. ` +
+                `Available schemas: ${Object.keys(entrySchemaRegistry).join(', ')}`);
+        }
+        return {
+            name: entryType.name,
+            label: entryType.label,
+            format: entryType.format,
+            schema: resolvedSchema,
+            schemaRef: entryType.schema,
+            default: entryType.default,
+            maxItems: entryType.maxItems,
+        };
+    });
+}
+/**
+ * Resolve schema references for a single collection
+ */
+function resolveCollectionMeta(meta, entrySchemaRegistry, allCollections) {
+    // Resolve entry types
+    const entries = meta.entries && meta.entries.length > 0
+        ? resolveEntryTypes(meta.entries, entrySchemaRegistry, `collection "${meta.name}"`)
+        : undefined;
+    // Find nested collections (subfolders with .collection.json)
+    const nestedCollections = allCollections.filter((col) => {
+        return (col.path.startsWith(`${meta.path}/`) &&
+            col.path.split('/').length === meta.path.split('/').length + 1);
+    });
+    const collections = nestedCollections.length > 0
+        ? nestedCollections.map((nestedMeta) => resolveCollectionMeta(nestedMeta, entrySchemaRegistry, allCollections))
+        : undefined;
+    return {
+        name: meta.name,
+        label: meta.label,
+        path: meta.path,
+        contentId: meta.contentId,
+        ...(entries && { entries }),
+        ...(meta.order && { order: meta.order }),
+        ...(collections && { collections }),
+    };
+}
+/**
+ * Resolve schema references for root collection and all collections.
+ *
+ * This function takes the loaded meta files (which contain string references like "postSchema")
+ * and resolves them to actual EntrySchema arrays from the entry schema registry.
+ *
+ * Resolution Process:
+ * 1. Root entry types: Resolve "schema" string to entry schema registry lookup
+ * 2. Top-level collections: Resolve recursively, building nested tree structure
+ * 3. Nested collections: Automatically grouped under their parent collections
+ *
+ * @param metaFiles - Loaded meta files from loadCollectionMetaFiles()
+ * @param entrySchemaRegistry - Map of schema names to EntrySchema arrays
+ * @returns Fully resolved root collection config ready for use by CanopyCMS
+ * @throws Error if any schema reference doesn't exist in registry (with helpful suggestions)
+ */
+export function resolveCollectionReferences(metaFiles, entrySchemaRegistry) {
+    // Build result object dynamically to avoid readonly conflicts
+    const result = {};
+    // Pass through root label if present
+    if (metaFiles.root?.label) {
+        result.label = metaFiles.root.label;
+    }
+    // Resolve root entry types
+    if (metaFiles.root?.entries && metaFiles.root.entries.length > 0) {
+        result.entries = resolveEntryTypes(metaFiles.root.entries, entrySchemaRegistry, 'root collection');
+    }
+    // Pass through root order array (embedded IDs for sorting)
+    if (metaFiles.root?.order) {
+        result.order = metaFiles.root.order;
+    }
+    // Resolve top-level collections (no slashes in path)
+    const topLevelCollections = metaFiles.collections.filter((meta) => !meta.path.includes('/'));
+    if (topLevelCollections.length > 0) {
+        result.collections = topLevelCollections.map((meta) => resolveCollectionMeta(meta, entrySchemaRegistry, metaFiles.collections));
+    }
+    return result;
+}
+/**
+ * Watch for changes to .collection.json files
+ */
+export function watchCollectionMetaFiles(contentRoot, onChange) {
+    const watcher = chokidar.watch(`${contentRoot}/**/.collection.json`, {
+        ignoreInitial: true,
+    });
+    watcher.on('add', onChange);
+    watcher.on('change', onChange);
+    watcher.on('unlink', onChange);
+    // Return cleanup function
+    return () => watcher.close();
+}
+//# sourceMappingURL=meta-loader.js.map

package/dist/schema/meta-loader.js.map

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

package/dist/schema/resolver.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Schema resolver for CanopyCMS.
+ *
+ * Loads and resolves schema from .collection.json files in the content directory.
+ * This is the single source of truth for collection structure.
+ *
+ * Field schemas are defined in the entry schema registry and referenced by name
+ * in .collection.json files for reusability and type safety.
+ */
+import type { RootCollectionConfig } from '../config';
+import type { EntrySchemaRegistry, SchemaResolutionResult } from './types';
+/**
+ * Resolve schema from .collection.json files.
+ *
+ * This is the primary entry point for loading schema configuration.
+ * It discovers all .collection.json files in the content directory
+ * and resolves schema references using the provided registry.
+ *
+ * @param contentRoot - Path to the content directory
+ * @param entrySchemaRegistry - Map of entry schema names to field definitions
+ * @returns Resolved schema configuration
+ * @throws Error if schema references cannot be resolved
+ */
+export declare function resolveSchema(contentRoot: string, entrySchemaRegistry: EntrySchemaRegistry): Promise<SchemaResolutionResult>;
+/**
+ * Check if content root has any .collection.json files.
+ *
+ * @param contentRoot - Path to the content directory
+ * @returns true if at least one .collection.json file exists
+ */
+export declare function hasSchemaFiles(contentRoot: string): Promise<boolean>;
+/**
+ * Validate schema completeness.
+ *
+ * Checks that the resolved schema has at least one collection or
+ * root entries definition.
+ *
+ * @param schema - Resolved schema to validate
+ * @returns true if schema is valid
+ */
+export declare function isValidSchema(schema: RootCollectionConfig): boolean;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/schema/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/schema/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAoB,MAAM,SAAS,CAAA;AAG5F;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,mBAAmB,EAAE,mBAAmB,GACvC,OAAO,CAAC,sBAAsB,CAAC,CA2BjC;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAInE"}

package/dist/schema/resolver.js

@@ -0,0 +1,70 @@
+/**
+ * Schema resolver for CanopyCMS.
+ *
+ * Loads and resolves schema from .collection.json files in the content directory.
+ * This is the single source of truth for collection structure.
+ *
+ * Field schemas are defined in the entry schema registry and referenced by name
+ * in .collection.json files for reusability and type safety.
+ */
+import { loadCollectionMetaFiles, resolveCollectionReferences } from './meta-loader';
+/**
+ * Resolve schema from .collection.json files.
+ *
+ * This is the primary entry point for loading schema configuration.
+ * It discovers all .collection.json files in the content directory
+ * and resolves schema references using the provided registry.
+ *
+ * @param contentRoot - Path to the content directory
+ * @param entrySchemaRegistry - Map of entry schema names to field definitions
+ * @returns Resolved schema configuration
+ * @throws Error if schema references cannot be resolved
+ */
+export async function resolveSchema(contentRoot, entrySchemaRegistry) {
+    // Load all .collection.json meta files
+    const metaFiles = await loadCollectionMetaFiles(contentRoot);
+    // Build source info for debugging
+    const sources = [];
+    if (metaFiles.root) {
+        sources.push({
+            path: '.collection.json',
+            type: 'root',
+            collections: [],
+        });
+    }
+    for (const collection of metaFiles.collections) {
+        sources.push({
+            path: `${collection.path}/.collection.json`,
+            type: 'collection',
+            collections: [collection.name],
+        });
+    }
+    // Resolve schema references to actual field definitions
+    const schema = resolveCollectionReferences(metaFiles, entrySchemaRegistry);
+    return { schema, sources };
+}
+/**
+ * Check if content root has any .collection.json files.
+ *
+ * @param contentRoot - Path to the content directory
+ * @returns true if at least one .collection.json file exists
+ */
+export async function hasSchemaFiles(contentRoot) {
+    const metaFiles = await loadCollectionMetaFiles(contentRoot);
+    return metaFiles.root !== null || metaFiles.collections.length > 0;
+}
+/**
+ * Validate schema completeness.
+ *
+ * Checks that the resolved schema has at least one collection or
+ * root entries definition.
+ *
+ * @param schema - Resolved schema to validate
+ * @returns true if schema is valid
+ */
+export function isValidSchema(schema) {
+    const hasEntries = !!(schema.entries && schema.entries.length > 0);
+    const hasCollections = !!(schema.collections && schema.collections.length > 0);
+    return hasEntries || hasCollections;
+}
+//# sourceMappingURL=resolver.js.map

package/dist/schema/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/schema/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAA;AAEpF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,WAAmB,EACnB,mBAAwC;IAExC,uCAAuC;IACvC,MAAM,SAAS,GAAG,MAAM,uBAAuB,CAAC,WAAW,CAAC,CAAA;IAE5D,kCAAkC;IAClC,MAAM,OAAO,GAAuB,EAAE,CAAA;IAEtC,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,kBAAkB;YACxB,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,EAAE;SAChB,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,MAAM,UAAU,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,GAAG,UAAU,CAAC,IAAI,mBAAmB;YAC3C,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;SAC/B,CAAC,CAAA;IACJ,CAAC;IAED,wDAAwD;IACxD,MAAM,MAAM,GAAG,2BAA2B,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAA;IAE1E,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;AAC5B,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,WAAmB;IACtD,MAAM,SAAS,GAAG,MAAM,uBAAuB,CAAC,WAAW,CAAC,CAAA;IAC5D,OAAO,SAAS,CAAC,IAAI,KAAK,IAAI,IAAI,SAAS,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAA;AACpE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,MAA4B;IACxD,MAAM,UAAU,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAClE,MAAM,cAAc,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAC9E,OAAO,UAAU,IAAI,cAAc,CAAA;AACrC,CAAC"}