canopycms 0.0.0

package/dist/comment-store.js

@@ -0,0 +1,234 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { randomUUID } from 'node:crypto';
+/**
+ * Error thrown when a concurrent modification is detected.
+ * Operations that encounter this error will automatically retry.
+ */
+export class CommentStoreConflictError extends Error {
+    constructor() {
+        super('Concurrent modification detected');
+        this.name = 'CommentStoreConflictError';
+    }
+}
+/**
+ * Manages comment storage for a branch workspace.
+ * Comments are stored in .canopy-meta/comments.json and are NOT committed to git.
+ *
+ * Uses optimistic locking with retry to handle concurrent modifications safely.
+ * This is non-blocking - conflicts are detected via version mismatch and retried.
+ */
+export class CommentStore {
+    constructor(branchRoot) {
+        this.loadedVersion = null;
+        this.filePath = path.join(branchRoot, '.canopy-meta', 'comments.json');
+    }
+    /**
+     * Load comments file. Tracks version for optimistic locking.
+     */
+    async load() {
+        try {
+            const content = await fs.readFile(this.filePath, 'utf-8');
+            const data = JSON.parse(content);
+            // Backward compat: treat missing version as 0
+            this.loadedVersion = data.version ?? 0;
+            return { ...data, version: this.loadedVersion };
+        }
+        catch {
+            // File doesn't exist yet, return empty structure
+            this.loadedVersion = null;
+            return {
+                schemaVersion: 1,
+                version: 0,
+                threads: {},
+            };
+        }
+    }
+    /**
+     * Save comments file with optimistic locking.
+     * Uses atomic temp-file write to prevent corruption.
+     *
+     * For new files (expectedVersion === null): uses exclusive create to prevent races
+     * For existing files: uses atomic rename with post-write verification
+     *
+     * @throws CommentStoreConflictError if version has changed since load
+     */
+    async save(data, expectedVersion) {
+        await fs.mkdir(path.dirname(this.filePath), { recursive: true });
+        // Increment version and generate unique write ID for ownership verification
+        // New files start at version 1, existing files increment by 1
+        const newVersion = expectedVersion === null ? 1 : expectedVersion + 1;
+        const writeId = randomUUID();
+        const newData = { ...data, version: newVersion, writeId };
+        const content = JSON.stringify(newData, null, 2);
+        const tempPath = `${this.filePath}.${Date.now()}.${Math.random().toString(36).slice(2)}.tmp`;
+        if (expectedVersion === null) {
+            // New file case: use exclusive create flag to prevent race
+            // If file already exists, this will throw EEXIST
+            try {
+                await fs.writeFile(this.filePath, content, { flag: 'wx' });
+                return;
+            }
+            catch (err) {
+                if (err.code === 'EEXIST') {
+                    // File was created by another process, conflict
+                    throw new CommentStoreConflictError();
+                }
+                throw err;
+            }
+        }
+        // Existing file case: write to temp, atomic rename, then verify we won
+        await fs.writeFile(tempPath, content, 'utf-8');
+        try {
+            // First check: verify expected version before rename
+            let currentVersion = null;
+            try {
+                const current = JSON.parse(await fs.readFile(this.filePath, 'utf-8'));
+                currentVersion = current.version ?? 0;
+            }
+            catch {
+                currentVersion = null;
+            }
+            if (currentVersion !== expectedVersion) {
+                throw new CommentStoreConflictError();
+            }
+            // Atomic rename
+            await fs.rename(tempPath, this.filePath);
+            // Post-write verification with settling delay
+            // Wait to let concurrent renames complete on shared filesystems (EFS/NFS), then verify our writeId
+            await new Promise((resolve) => setTimeout(resolve, 50));
+            const afterWrite = JSON.parse(await fs.readFile(this.filePath, 'utf-8'));
+            if (afterWrite.writeId !== writeId) {
+                // Another process won the race - our write was overwritten
+                throw new CommentStoreConflictError();
+            }
+        }
+        catch (err) {
+            // Clean up temp file on any error (may already be renamed away)
+            await fs.unlink(tempPath).catch(() => { });
+            throw err;
+        }
+    }
+    /**
+     * Retry an operation that may fail due to concurrent modification.
+     * Non-blocking - reloads and retries on conflict with exponential backoff.
+     */
+    async withRetry(operation, maxAttempts = 10) {
+        for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+            try {
+                return await operation();
+            }
+            catch (err) {
+                if (err instanceof CommentStoreConflictError && attempt < maxAttempts) {
+                    // Reset loaded version and retry with exponential backoff + jitter
+                    this.loadedVersion = null;
+                    const baseDelay = Math.min(10 * Math.pow(2, attempt - 1), 100); // 10, 20, 40, 80, 100ms cap
+                    const jitter = Math.random() * baseDelay;
+                    await new Promise((resolve) => setTimeout(resolve, baseDelay + jitter));
+                    continue;
+                }
+                throw err;
+            }
+        }
+        throw new Error('Unreachable');
+    }
+    async addComment(options) {
+        // Generate IDs outside retry so they stay stable across retries
+        const threadId = options.threadId || randomUUID();
+        const commentId = randomUUID();
+        return this.withRetry(async () => {
+            const data = await this.load();
+            const timestamp = new Date().toISOString();
+            const comment = {
+                id: commentId,
+                threadId,
+                userId: options.userId,
+                timestamp,
+                text: options.text,
+            };
+            if (!data.threads[threadId]) {
+                // Create new thread
+                data.threads[threadId] = {
+                    id: threadId,
+                    comments: [comment],
+                    resolved: false,
+                    createdAt: timestamp,
+                    type: options.type,
+                    authorId: options.userId,
+                    entryPath: options.entryPath,
+                    canopyPath: options.canopyPath,
+                };
+            }
+            else {
+                // Add to existing thread
+                data.threads[threadId].comments.push(comment);
+            }
+            await this.save(data, this.loadedVersion);
+            return { threadId, commentId };
+        });
+    }
+    async resolveThread(threadId, userId) {
+        return this.withRetry(async () => {
+            const data = await this.load();
+            if (!data.threads[threadId]) {
+                return false;
+            }
+            data.threads[threadId].resolved = true;
+            data.threads[threadId].resolvedBy = userId;
+            data.threads[threadId].resolvedAt = new Date().toISOString();
+            await this.save(data, this.loadedVersion);
+            return true;
+        });
+    }
+    async listThreads(options) {
+        const data = await this.load();
+        const threads = Object.values(data.threads);
+        if (options?.includeResolved === false) {
+            return threads.filter((t) => !t.resolved);
+        }
+        return threads;
+    }
+    async getThread(threadId) {
+        const data = await this.load();
+        return data.threads[threadId] || null;
+    }
+    async deleteThread(threadId) {
+        return this.withRetry(async () => {
+            const data = await this.load();
+            if (!data.threads[threadId]) {
+                return false;
+            }
+            delete data.threads[threadId];
+            await this.save(data, this.loadedVersion);
+            return true;
+        });
+    }
+    /**
+     * Get all threads for a specific field
+     */
+    async getThreadsForField(entryPath, canopyPath) {
+        const data = await this.load();
+        return Object.values(data.threads)
+            .filter((t) => t.type === 'field' && t.entryPath === entryPath && t.canopyPath === canopyPath)
+            .sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+    }
+    /**
+     * Get all threads for a specific entry (not field-specific)
+     */
+    async getThreadsForEntry(entryPath) {
+        const data = await this.load();
+        return Object.values(data.threads)
+            .filter((t) => t.type === 'entry' && t.entryPath === entryPath)
+            .sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+    }
+    /**
+     * Get all branch-level threads
+     */
+    async getBranchThreads() {
+        const data = await this.load();
+        return Object.values(data.threads)
+            .filter((t) => t.type === 'branch')
+            .sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+    }
+}
+//# sourceMappingURL=comment-store.js.map

package/dist/comment-store.js.map

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

package/dist/config/flatten.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Schema flattening utilities for O(1) lookups.
+ */
+import type { FlatSchemaItem, RootCollectionConfig } from './types';
+/**
+ * Normalize a path value by splitting, filtering empty segments, and rejoining.
+ */
+export declare const normalizePathValue: (val: string) => string;
+/**
+ * Normalize all paths in the root collection schema.
+ * Recursively processes nested collections.
+ */
+export declare const normalizeSchemaPathsRoot: (root: RootCollectionConfig) => RootCollectionConfig;
+/**
+ * Flatten the root collection schema into a flat array for O(1) lookups.
+ * Traverses the nested schema structure and returns all collections and entry types
+ * with their full paths resolved.
+ *
+ * @param root - The root collection configuration
+ * @param basePath - Optional base path to prepend (e.g., 'content')
+ * @returns Array of flattened schema items with full paths
+ *
+ * @example
+ * const flat = flattenSchema(config.schema, 'content')
+ * const map = new Map(flat.map(item => [item.logicalPath, item]))
+ * const item = map.get('content/posts') // O(1) lookup
+ */
+export declare const flattenSchema: (root: RootCollectionConfig, basePath?: string) => FlatSchemaItem[];
+//# sourceMappingURL=flatten.d.ts.map

package/dist/config/flatten.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten.d.ts","sourceRoot":"","sources":["../../src/config/flatten.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAGV,cAAc,EACd,oBAAoB,EACrB,MAAM,SAAS,CAAA;AAIhB;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,KAAG,MACI,CAAA;AAErD;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GAAI,MAAM,oBAAoB,KAAG,oBAqBrE,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,oBAAoB,EAAE,iBAAa,KAAG,cAAc,EA+GvF,CAAA"}

package/dist/config/flatten.js

@@ -0,0 +1,153 @@
+/**
+ * Schema flattening utilities for O(1) lookups.
+ */
+import { join, normalize } from 'pathe';
+import { createLogicalPath } from '../paths/normalize';
+import { ROOT_COLLECTION_ID } from '../paths/types';
+/**
+ * Normalize a path value by splitting, filtering empty segments, and rejoining.
+ */
+export const normalizePathValue = (val) => normalize(val).split('/').filter(Boolean).join('/');
+/**
+ * Normalize all paths in the root collection schema.
+ * Recursively processes nested collections.
+ */
+export const normalizeSchemaPathsRoot = (root) => {
+    const normalizeCollection = (collection, parentPath = '') => {
+        const logicalPath = parentPath ? join(parentPath, collection.path) : collection.path;
+        const normalizedFull = normalizePathValue(logicalPath);
+        if (!normalizedFull || normalizedFull.includes('..')) {
+            throw new Error(`Invalid path for collection "${collection.name}"`);
+        }
+        return {
+            ...collection,
+            path: normalizePathValue(collection.path),
+            collections: collection.collections?.map((c) => normalizeCollection(c, normalizedFull)),
+        };
+    };
+    return {
+        ...root,
+        collections: root.collections?.map((c) => normalizeCollection(c)),
+    };
+};
+/**
+ * Flatten the root collection schema into a flat array for O(1) lookups.
+ * Traverses the nested schema structure and returns all collections and entry types
+ * with their full paths resolved.
+ *
+ * @param root - The root collection configuration
+ * @param basePath - Optional base path to prepend (e.g., 'content')
+ * @returns Array of flattened schema items with full paths
+ *
+ * @example
+ * const flat = flattenSchema(config.schema, 'content')
+ * const map = new Map(flat.map(item => [item.logicalPath, item]))
+ * const item = map.get('content/posts') // O(1) lookup
+ */
+export const flattenSchema = (root, basePath = '') => {
+    const flat = [];
+    const base = normalizePathValue(basePath || '');
+    const walkCollection = (collection, parentPath) => {
+        const normalizedPath = normalizePathValue(collection.path);
+        // Build logical path: if we have a parent, join with parent; otherwise use collection path
+        let logicalPath;
+        if (parentPath && parentPath !== base) {
+            // Nested child collection: use only the collection name (leaf segment), not the full path
+            // The full path from collection.path includes parent path segments that are already in parentPath
+            logicalPath = join(parentPath, collection.name);
+        }
+        else if (parentPath === base) {
+            // Root-level collection (direct child of content root): use collection path
+            logicalPath = join(base, normalizedPath);
+        }
+        else {
+            // No parent and no base: use collection path as-is
+            logicalPath = normalizedPath;
+        }
+        const normalizedFull = normalizePathValue(logicalPath);
+        // Add the collection itself
+        flat.push({
+            type: 'collection',
+            logicalPath: createLogicalPath(normalizedFull),
+            name: collection.name,
+            label: collection.label,
+            description: collection.description,
+            contentId: collection.contentId,
+            parentPath: parentPath ? createLogicalPath(parentPath) : undefined,
+            entries: collection.entries,
+            collections: collection.collections,
+            order: collection.order,
+        });
+        // Add entry types in this collection
+        if (collection.entries) {
+            for (const entryType of collection.entries) {
+                // Entry type path is collection path + entry type name
+                const entryTypePath = join(normalizedFull, entryType.name);
+                flat.push({
+                    type: 'entry-type',
+                    logicalPath: createLogicalPath(normalizePathValue(entryTypePath)),
+                    name: entryType.name,
+                    label: entryType.label,
+                    description: entryType.description,
+                    parentPath: createLogicalPath(normalizedFull),
+                    format: entryType.format,
+                    schema: entryType.schema,
+                    schemaRef: entryType.schemaRef,
+                    default: entryType.default,
+                    maxItems: entryType.maxItems,
+                });
+            }
+        }
+        // Recursively process nested collections
+        if (collection.collections) {
+            for (const child of collection.collections) {
+                walkCollection(child, normalizedFull);
+            }
+        }
+    };
+    // Add the root collection itself as a normal collection (if we have a base path)
+    // This makes content root behave exactly like any other collection, just without a parent
+    if (base) {
+        flat.push({
+            type: 'collection',
+            logicalPath: createLogicalPath(base),
+            name: base, // Use base path as the name (e.g., 'content')
+            label: undefined, // Root collection has no label
+            contentId: ROOT_COLLECTION_ID, // Sentinel — root dir has no embedded ID
+            parentPath: undefined, // No parent - this is the root
+            entries: root.entries,
+            collections: root.collections,
+            order: root.order,
+        });
+    }
+    // Add root-level entry types
+    // Now their parentPath will reference the root collection we just added above
+    if (root.entries) {
+        for (const entryType of root.entries) {
+            // Root entry type path is base + entry type name
+            const entryTypePath = base ? join(base, entryType.name) : entryType.name;
+            flat.push({
+                type: 'entry-type',
+                logicalPath: createLogicalPath(normalizePathValue(entryTypePath)),
+                name: entryType.name,
+                label: entryType.label,
+                description: entryType.description,
+                parentPath: base ? createLogicalPath(base) : createLogicalPath(''), // Now references the root collection (e.g., 'content')
+                format: entryType.format,
+                schema: entryType.schema,
+                schemaRef: entryType.schemaRef,
+                default: entryType.default,
+                maxItems: entryType.maxItems,
+            });
+        }
+    }
+    // Process root-level collections
+    // Pass base as parentPath so they are children of the content root collection
+    if (root.collections) {
+        for (const collection of root.collections) {
+            walkCollection(collection, base || '');
+        }
+    }
+    return flat;
+};
+//# sourceMappingURL=flatten.js.map

package/dist/config/flatten.js.map

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

package/dist/config/helpers.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Helper functions for authoring CanopyCMS configuration files.
+ */
+import type { CanopyConfig, CanopyConfigFragment, CanopyConfigInput, CanopyClientConfig, ClientOnlyFields } from './types';
+export type CanopyConfigAuthoring = CanopyConfigInput;
+/**
+ * Helper for authoring typed config files (canopycms.config.ts).
+ * Performs runtime validation using the CanopyConfig schema.
+ * Returns a bundle with `server` (full config) and `client(overrides)` (safe subset).
+ *
+ * @example
+ * ```ts
+ * // canopycms.config.ts
+ * import { defineCanopyConfig } from 'canopycms'
+ *
+ * export const canopyConfig = defineCanopyConfig({
+ *   gitBotAuthorName: 'Bot',
+ *   gitBotAuthorEmail: 'bot@example.com',
+ *   schema: {
+ *     collections: [...]
+ *   }
+ * })
+ * ```
+ */
+export declare function defineCanopyConfig(config: CanopyConfigInput | CanopyConfigAuthoring): {
+    server: CanopyConfig;
+    client: (clientOverrides?: ClientOnlyFields) => CanopyClientConfig;
+};
+/**
+ * Helper to compose config fragments defined across multiple files.
+ * Useful for splitting large configurations into domain-specific modules.
+ * Later fragments can override media.
+ *
+ * @example
+ * ```ts
+ * // posts.config.ts
+ * export const postsConfig = { media: {...}, contentRoot: 'content/posts' }
+ *
+ * // canopycms.config.ts
+ * import { composeCanopyConfig } from 'canopycms'
+ * import { postsConfig } from './posts.config'
+ * import { pagesConfig } from './pages.config'
+ *
+ * export const config = composeCanopyConfig(postsConfig, pagesConfig)
+ * ```
+ */
+export declare const composeCanopyConfig: (...fragments: CanopyConfigFragment[]) => CanopyConfig;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/config/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/config/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAYjB,MAAM,SAAS,CAAA;AAEhB,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,CAAA;AAErD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,qBAAqB;;+BASrD,gBAAgB,KAAG,kBAAkB;EAqBnE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,mBAAmB,GAAI,GAAG,WAAW,oBAAoB,EAAE,KAAG,YAuE1E,CAAA"}

package/dist/config/helpers.js

@@ -0,0 +1,138 @@
+/**
+ * Helper functions for authoring CanopyCMS configuration files.
+ */
+import { validateCanopyConfig } from './validation';
+/**
+ * Helper for authoring typed config files (canopycms.config.ts).
+ * Performs runtime validation using the CanopyConfig schema.
+ * Returns a bundle with `server` (full config) and `client(overrides)` (safe subset).
+ *
+ * @example
+ * ```ts
+ * // canopycms.config.ts
+ * import { defineCanopyConfig } from 'canopycms'
+ *
+ * export const canopyConfig = defineCanopyConfig({
+ *   gitBotAuthorName: 'Bot',
+ *   gitBotAuthorEmail: 'bot@example.com',
+ *   schema: {
+ *     collections: [...]
+ *   }
+ * })
+ * ```
+ */
+export function defineCanopyConfig(config) {
+    const validated = validateCanopyConfig(config);
+    return {
+        // Full server config - all fields including sensitive data
+        server: validated,
+        // Client config helper - extracts safe subset and merges overrides
+        // Note: flatSchema is loaded dynamically by the editor via API (from .collection.json files)
+        client: (clientOverrides) => {
+            const { defaultBaseBranch, contentRoot, editor, mode } = validated;
+            const clientConfig = {
+                defaultBaseBranch,
+                contentRoot,
+                editor,
+                mode,
+                flatSchema: [], // Loaded dynamically by editor via API
+            };
+            // Merge client overrides (e.g., auth handlers from useClerkAuthConfig)
+            if (clientOverrides?.editor) {
+                clientConfig.editor = {
+                    ...clientConfig.editor,
+                    ...clientOverrides.editor,
+                };
+            }
+            return clientConfig;
+        },
+    };
+}
+/**
+ * Helper to compose config fragments defined across multiple files.
+ * Useful for splitting large configurations into domain-specific modules.
+ * Later fragments can override media.
+ *
+ * @example
+ * ```ts
+ * // posts.config.ts
+ * export const postsConfig = { media: {...}, contentRoot: 'content/posts' }
+ *
+ * // canopycms.config.ts
+ * import { composeCanopyConfig } from 'canopycms'
+ * import { postsConfig } from './posts.config'
+ * import { pagesConfig } from './pages.config'
+ *
+ * export const config = composeCanopyConfig(postsConfig, pagesConfig)
+ * ```
+ */
+export const composeCanopyConfig = (...fragments) => {
+    let media;
+    let contentRoot;
+    let sourceRoot;
+    let defaultBranchAccess;
+    let defaultPathAccess;
+    let defaultBaseBranch;
+    let defaultRemoteName;
+    let defaultRemoteUrl;
+    let gitBotAuthorName;
+    let gitBotAuthorEmail;
+    let mode;
+    let deploymentName;
+    for (const fragment of fragments) {
+        if (fragment.media) {
+            media = fragment.media;
+        }
+        if (fragment.contentRoot) {
+            contentRoot = fragment.contentRoot;
+        }
+        if (fragment.sourceRoot) {
+            sourceRoot = fragment.sourceRoot;
+        }
+        if (fragment.defaultBranchAccess) {
+            defaultBranchAccess = fragment.defaultBranchAccess;
+        }
+        if (fragment.defaultPathAccess) {
+            defaultPathAccess = fragment.defaultPathAccess;
+        }
+        if (fragment.defaultBaseBranch) {
+            defaultBaseBranch = fragment.defaultBaseBranch;
+        }
+        if (fragment.defaultRemoteName) {
+            defaultRemoteName = fragment.defaultRemoteName;
+        }
+        if (fragment.defaultRemoteUrl) {
+            defaultRemoteUrl = fragment.defaultRemoteUrl;
+        }
+        if (fragment.gitBotAuthorName) {
+            gitBotAuthorName = fragment.gitBotAuthorName;
+        }
+        if (fragment.gitBotAuthorEmail) {
+            gitBotAuthorEmail = fragment.gitBotAuthorEmail;
+        }
+        if (fragment.mode) {
+            mode = fragment.mode;
+        }
+        if (fragment.deploymentName) {
+            deploymentName = fragment.deploymentName;
+        }
+    }
+    const merged = {
+        gitBotAuthorName: gitBotAuthorName ?? '',
+        gitBotAuthorEmail: gitBotAuthorEmail ?? '',
+        ...(media ? { media } : {}),
+        ...(contentRoot ? { contentRoot } : {}),
+        ...(sourceRoot ? { sourceRoot } : {}),
+        ...(defaultBranchAccess ? { defaultBranchAccess } : {}),
+        ...(defaultPathAccess ? { defaultPathAccess } : {}),
+        ...(defaultBaseBranch ? { defaultBaseBranch } : {}),
+        ...(defaultRemoteName ? { defaultRemoteName } : {}),
+        ...(defaultRemoteUrl ? { defaultRemoteUrl } : {}),
+        ...(gitBotAuthorName ? { gitBotAuthorName } : {}),
+        ...(gitBotAuthorEmail ? { gitBotAuthorEmail } : {}),
+        ...(mode ? { mode } : {}),
+        ...(deploymentName ? { deploymentName } : {}),
+    };
+    return validateCanopyConfig(merged);
+};
+//# sourceMappingURL=helpers.js.map

package/dist/config/helpers.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * CanopyCMS Configuration Module
+ *
+ * This module provides types, schemas, and utilities for configuring CanopyCMS.
+ *
+ * @example
+ * ```ts
+ * import { defineCanopyConfig, type FieldConfig } from 'canopycms/config'
+ * ```
+ */
+export type { PrimitiveFieldType, FieldType, ContentFormat, MediaAdapterKind, PermissionLevel, PermissionTarget, PathPermission, SelectOption, ReferenceOption, FieldConfig, BlockConfig, BlockFieldConfig, SelectFieldConfig, ReferenceFieldConfig, ObjectFieldConfig, CustomFieldConfig, EntrySchema, BranchSchema, EntryTypeConfig, CollectionConfig, RootCollectionConfig, MediaConfig, CanopyEditorConfig, DefaultBranchAccess, DefaultPathAccess, DefaultBaseBranch, DefaultRemoteName, DefaultRemoteUrl, GitBotAuthorName, GitBotAuthorEmail, GithubTokenEnvVar, CanopyOperatingMode, ContentRoot, SourceRoot, CanopyConfig, CanopyConfigInput, CanopyConfigFragment, FlatSchemaItem, CanopyClientConfig, ClientOnlyFields, } from './types';
+export { primitiveFieldTypes, fieldTypes } from './types';
+export { CanopyConfigSchema, getConfigDefaults, DEFAULT_PROD_WORKSPACE } from './schemas/config';
+export { fieldSchema, blockSchema, selectOptionSchema, referenceOptionSchema, } from './schemas/field';
+export { collectionSchema, rootCollectionSchema, entryTypeSchema, relativePathSchema, } from './schemas/collection';
+export { permissionTargetSchema, pathPermissionSchema } from './schemas/permissions';
+export { mediaSchema } from './schemas/media';
+export { flattenSchema, normalizePathValue, normalizeSchemaPathsRoot } from './flatten';
+export { validateCanopyConfig, ensureSelectFieldsHaveOptions } from './validation';
+export { defineCanopyConfig, composeCanopyConfig, type CanopyConfigAuthoring } from './helpers';
+//# sourceMappingURL=index.d.ts.map