canopycms 0.0.0

package/dist/config/types.d.ts

@@ -0,0 +1,272 @@
+/**
+ * Type definitions for CanopyCMS configuration.
+ * These are pure TypeScript types - Zod schemas are in ./schemas/
+ */
+import type { CanopyGroupId, CanopyUserId } from '../types';
+import type { OperatingMode } from '../operating-mode';
+import type { AuthPlugin } from '../auth/plugin';
+import type { LogicalPath, ContentId } from '../paths/types';
+import type { PermissionPath } from '../authorization/types';
+export declare const primitiveFieldTypes: readonly ["string", "number", "boolean", "datetime", "rich-text", "markdown", "mdx", "image", "code"];
+export declare const fieldTypes: readonly ["string", "number", "boolean", "datetime", "rich-text", "markdown", "mdx", "image", "code", "select", "reference", "object", "block"];
+export type PrimitiveFieldType = (typeof primitiveFieldTypes)[number];
+export type FieldType = (typeof fieldTypes)[number];
+export type ContentFormat = 'md' | 'mdx' | 'json';
+export type MediaAdapterKind = 'local' | 's3' | 'lfs' | (string & {});
+export type PermissionLevel = 'read' | 'edit' | 'review';
+export interface PermissionTarget {
+    allowedUsers?: CanopyUserId[];
+    allowedGroups?: CanopyGroupId[];
+}
+export interface PathPermission {
+    path: PermissionPath;
+    read?: PermissionTarget;
+    edit?: PermissionTarget;
+    review?: PermissionTarget;
+}
+export type SelectOption = string | {
+    label: string;
+    value: string;
+};
+export type ReferenceOption = string | {
+    label: string;
+    value: string;
+};
+export interface BaseFieldConfig {
+    name: string;
+    label?: string;
+    description?: string;
+    required?: boolean;
+    list?: boolean;
+}
+export interface PrimitiveFieldConfig extends BaseFieldConfig {
+    type: PrimitiveFieldType;
+}
+export interface SelectFieldConfig extends BaseFieldConfig {
+    type: 'select';
+    options: SelectOption[];
+}
+export interface ReferenceFieldConfig extends BaseFieldConfig {
+    type: 'reference';
+    collections: string[];
+    displayField?: string;
+    options?: ReferenceOption[];
+}
+export interface BlockConfig {
+    name: string;
+    label?: string;
+    description?: string;
+    fields: FieldConfig[];
+}
+export interface BlockFieldConfig extends BaseFieldConfig {
+    type: 'block';
+    templates: BlockConfig[];
+}
+export interface ObjectFieldConfig extends BaseFieldConfig {
+    type: 'object';
+    fields: FieldConfig[];
+}
+/**
+ * Custom field config for user-defined field types.
+ * The type must not conflict with built-in types.
+ * Note: We use a branded type approach to avoid index signature issues.
+ */
+export type CustomFieldConfig = BaseFieldConfig & {
+    type: Exclude<string, FieldType>;
+};
+export type FieldConfig = PrimitiveFieldConfig | SelectFieldConfig | ReferenceFieldConfig | BlockFieldConfig | ObjectFieldConfig | CustomFieldConfig;
+export type MediaConfig = {
+    adapter: 'local';
+    publicBaseUrl?: string;
+} | {
+    adapter: 's3';
+    bucket: string;
+    region: string;
+    publicBaseUrl?: string;
+} | {
+    adapter: 'lfs';
+    publicBaseUrl?: string;
+} | {
+    adapter: string;
+    publicBaseUrl?: string;
+};
+/**
+ * Field definitions for one entry type — the array of FieldConfig that
+ * describes which fields an entry of this type contains.
+ *
+ * Contrast with BranchSchema, which is the full collection tree for a branch.
+ */
+export type EntrySchema = readonly FieldConfig[];
+/**
+ * Entry type config: defines a type of content within a collection.
+ * Each type has its own entry schema (fields) and can have cardinality constraints.
+ *
+ * Examples:
+ * - { name: 'post', format: 'mdx', schema: postSchema } - unlimited posts
+ * - { name: 'settings', format: 'json', schema: settingsSchema, maxItems: 1 } - restricted to one instance
+ */
+export type EntryTypeConfig = {
+    readonly name: string;
+    readonly format: ContentFormat;
+    readonly schema: EntrySchema;
+    /** Entry schema registry key (e.g., "postSchema"). Set during schema resolution. */
+    readonly schemaRef?: string;
+    readonly label?: string;
+    readonly description?: string;
+    readonly default?: boolean;
+    readonly maxItems?: number;
+};
+/**
+ * Collection: contains nested collections and typed entries.
+ * The entries array defines the types of content allowed in this collection.
+ */
+export type CollectionConfig = {
+    readonly name: string;
+    readonly path: string;
+    readonly label?: string;
+    readonly description?: string;
+    /** 12-char content ID from the collection's directory name. Optional: absent in static configs. */
+    readonly contentId?: ContentId;
+    /** Array of entry types allowed in this collection */
+    readonly entries?: readonly EntryTypeConfig[];
+    readonly collections?: readonly CollectionConfig[];
+    /** Ordering of items by embedded ID. Items not in order appear at end alphabetically. */
+    readonly order?: readonly string[];
+};
+/**
+ * Root schema configuration for CanopyCMS.
+ * Contains top-level collections and entries (typed content at the root level).
+ */
+export type RootCollectionConfig = {
+    /** Optional label for the root collection (e.g., "All Files", "Content") */
+    readonly label?: string;
+    /** Entry types at the root level */
+    readonly entries?: readonly EntryTypeConfig[];
+    readonly collections?: readonly CollectionConfig[];
+    /** Ordering of root items by embedded ID. Items not in order appear at end alphabetically. */
+    readonly order?: readonly string[];
+};
+/**
+ * The full collection structure tree for one branch — the resolved schema
+ * describing all collections, entry types, and their fields.
+ *
+ * Contrast with EntrySchema, which is the field definitions for a single entry type.
+ */
+export type BranchSchema = RootCollectionConfig;
+export interface CanopyEditorConfig {
+    title?: string;
+    subtitle?: string;
+    theme?: unknown;
+    previewBase?: Record<string, string>;
+    onAccountClick?: () => void;
+    onLogoutClick?: () => void;
+    AccountComponent?: React.ComponentType;
+}
+export type DefaultBranchAccess = 'allow' | 'deny';
+export type DefaultPathAccess = 'allow' | 'deny';
+export type DefaultBaseBranch = string;
+export type DefaultRemoteName = string;
+export type DefaultRemoteUrl = string;
+export type GitBotAuthorName = string;
+export type GitBotAuthorEmail = string;
+export type GithubTokenEnvVar = string;
+export type CanopyOperatingMode = OperatingMode;
+export type ContentRoot = string;
+export type SourceRoot = string | undefined;
+/**
+ * Validated CanopyConfig - the runtime configuration object.
+ */
+export interface CanopyConfig {
+    media?: MediaConfig;
+    defaultBranchAccess?: DefaultBranchAccess;
+    defaultPathAccess?: DefaultPathAccess;
+    defaultBaseBranch?: DefaultBaseBranch;
+    defaultRemoteName?: DefaultRemoteName;
+    defaultRemoteUrl?: DefaultRemoteUrl;
+    gitBotAuthorName: GitBotAuthorName;
+    gitBotAuthorEmail: GitBotAuthorEmail;
+    githubTokenEnvVar?: GithubTokenEnvVar;
+    mode: CanopyOperatingMode;
+    settingsBranch?: string;
+    autoCreateSettingsPR?: boolean;
+    deploymentName?: string;
+    contentRoot: ContentRoot;
+    sourceRoot?: SourceRoot;
+    editor?: CanopyEditorConfig;
+    authPlugin?: AuthPlugin;
+}
+/**
+ * Input type for config authoring (allows looser types before validation)
+ */
+export interface CanopyConfigInput {
+    media?: MediaConfig;
+    defaultBranchAccess?: DefaultBranchAccess;
+    defaultPathAccess?: DefaultPathAccess;
+    defaultBaseBranch?: string;
+    defaultRemoteName?: string;
+    defaultRemoteUrl?: string;
+    gitBotAuthorName: string;
+    gitBotAuthorEmail: string;
+    githubTokenEnvVar?: string;
+    mode?: OperatingMode;
+    settingsBranch?: string;
+    autoCreateSettingsPR?: boolean;
+    deploymentName?: string;
+    contentRoot?: string;
+    sourceRoot?: string;
+    editor?: CanopyEditorConfig;
+    authPlugin?: AuthPlugin;
+}
+export type CanopyConfigFragment = Partial<CanopyConfigInput>;
+/**
+ * Flattened schema item for efficient lookups.
+ * Discriminated union of collection or entry type with logical path resolved.
+ * Used for O(1) schema lookups via Map<logicalPath, FlatSchemaItem>.
+ */
+export type FlatSchemaItem = {
+    type: 'collection';
+    logicalPath: LogicalPath;
+    name: string;
+    label?: string;
+    description?: string;
+    /** 12-char content ID from the collection's directory name. Optional: absent in static configs. */
+    contentId?: ContentId;
+    parentPath?: LogicalPath;
+    /** Array of entry types in this collection */
+    entries?: readonly EntryTypeConfig[];
+    collections?: readonly CollectionConfig[];
+    /** Ordering of items by embedded ID. Items not in order appear at end alphabetically. */
+    order?: readonly string[];
+} | {
+    /** An entry type within a collection */
+    type: 'entry-type';
+    logicalPath: LogicalPath;
+    /** The entry type name (e.g., 'post', 'doc') */
+    name: string;
+    label?: string;
+    description?: string;
+    /** Path of the parent collection */
+    parentPath: LogicalPath;
+    format: ContentFormat;
+    schema: EntrySchema;
+    /** Entry schema registry key (e.g., "postSchema"). Set during schema resolution. */
+    schemaRef?: string;
+    default?: boolean;
+    maxItems?: number;
+};
+/**
+ * Client config - subset safe for browser (DRY - derived from CanopyConfig)
+ * Use flatSchema for O(1) cached access to the flattened schema structure.
+ * Schema is loaded from .collection.json files on the server and provided as flatSchema.
+ */
+export type CanopyClientConfig = Pick<CanopyConfig, 'defaultBaseBranch' | 'contentRoot' | 'editor' | 'mode'> & {
+    flatSchema: FlatSchemaItem[];
+};
+export interface ClientOnlyFields {
+    editor?: {
+        onAccountClick?: () => void;
+        onLogoutClick?: () => void | Promise<void>;
+        AccountComponent?: React.ComponentType;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/config/types.js

@@ -0,0 +1,24 @@
+/**
+ * Type definitions for CanopyCMS configuration.
+ * These are pure TypeScript types - Zod schemas are in ./schemas/
+ */
+// Field types
+export const primitiveFieldTypes = [
+    'string',
+    'number',
+    'boolean',
+    'datetime',
+    'rich-text',
+    'markdown',
+    'mdx',
+    'image',
+    'code',
+];
+export const fieldTypes = [
+    ...primitiveFieldTypes,
+    'select',
+    'reference',
+    'object',
+    'block',
+];
+//# sourceMappingURL=types.js.map

package/dist/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,cAAc;AACd,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,UAAU;IACV,WAAW;IACX,UAAU;IACV,KAAK;IACL,OAAO;IACP,MAAM;CACE,CAAA;AAEV,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,GAAG,mBAAmB;IACtB,QAAQ;IACR,WAAW;IACX,QAAQ;IACR,OAAO;CACC,CAAA"}

package/dist/config/validation.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Configuration validation utilities.
+ */
+import type { CanopyConfig } from './types';
+/**
+ * Recursively check that all select fields have options defined.
+ * Throws an error if a select field is missing options.
+ */
+export declare const ensureSelectFieldsHaveOptions: (config: unknown) => void;
+/**
+ * Validate and normalize a CanopyConfig object.
+ * Performs Zod validation, checks select field options, and normalizes paths.
+ *
+ * @param config - Raw configuration input
+ * @returns Validated and normalized CanopyConfig
+ * @throws Error if validation fails
+ */
+export declare const validateCanopyConfig: (config: unknown) => CanopyConfig;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/config/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C;;;GAGG;AACH,eAAO,MAAM,6BAA6B,GAAI,QAAQ,OAAO,KAAG,IAqC/D,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,QAAQ,OAAO,KAAG,YAUtD,CAAA"}

package/dist/config/validation.js

@@ -0,0 +1,66 @@
+/**
+ * Configuration validation utilities.
+ */
+import { CanopyConfigSchema } from './schemas/config';
+import { normalizePathValue, normalizeSchemaPathsRoot } from './flatten';
+/**
+ * Recursively check that all select fields have options defined.
+ * Throws an error if a select field is missing options.
+ */
+export const ensureSelectFieldsHaveOptions = (config) => {
+    const checkFields = (fields) => {
+        if (!Array.isArray(fields))
+            return;
+        for (const field of fields) {
+            const f = field;
+            if (f?.type === 'select' && (!Array.isArray(f.options) || f.options.length === 0)) {
+                const fieldName = f?.name ?? 'unknown';
+                throw new Error(`Select field "${fieldName}" requires options`);
+            }
+            if (f?.type === 'object') {
+                checkFields(f.fields);
+            }
+            if (f?.type === 'block' && Array.isArray(f.templates)) {
+                for (const template of f.templates) {
+                    checkFields(template.fields);
+                }
+            }
+        }
+    };
+    const walkSchema = (root) => {
+        if (!root)
+            return;
+        // Check entries fields (now an array of entry types)
+        if (Array.isArray(root.entries)) {
+            for (const entryType of root.entries) {
+                checkFields(entryType?.schema);
+            }
+        }
+        // Recursively check nested collections
+        if (Array.isArray(root.collections)) {
+            for (const collection of root.collections) {
+                walkSchema(collection);
+            }
+        }
+    };
+    walkSchema(config?.schema);
+};
+/**
+ * Validate and normalize a CanopyConfig object.
+ * Performs Zod validation, checks select field options, and normalizes paths.
+ *
+ * @param config - Raw configuration input
+ * @returns Validated and normalized CanopyConfig
+ * @throws Error if validation fails
+ */
+export const validateCanopyConfig = (config) => {
+    ensureSelectFieldsHaveOptions(config);
+    const parsed = CanopyConfigSchema.parse(config);
+    const normalized = {
+        ...parsed,
+        contentRoot: normalizePathValue(parsed.contentRoot ?? 'content'),
+        schema: parsed.schema ? normalizeSchemaPathsRoot(parsed.schema) : undefined,
+    };
+    return normalized;
+};
+//# sourceMappingURL=validation.js.map

package/dist/config/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/config/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAA;AAGxE;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,MAAe,EAAQ,EAAE;IACrE,MAAM,WAAW,GAAG,CAAC,MAA6B,EAAE,EAAE;QACpD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAM;QAClC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,KAAgC,CAAA;YAC1C,IAAI,CAAC,EAAE,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;gBAClF,MAAM,SAAS,GAAI,CAAC,EAAE,IAAe,IAAI,SAAS,CAAA;gBAClD,MAAM,IAAI,KAAK,CAAC,iBAAiB,SAAS,oBAAoB,CAAC,CAAA;YACjE,CAAC;YACD,IAAI,CAAC,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACzB,WAAW,CAAC,CAAC,CAAC,MAAmB,CAAC,CAAA;YACpC,CAAC;YACD,IAAI,CAAC,EAAE,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;gBACtD,KAAK,MAAM,QAAQ,IAAI,CAAC,CAAC,SAA0C,EAAE,CAAC;oBACpE,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;gBAC9B,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAA;IAED,MAAM,UAAU,GAAG,CAAC,IAAyC,EAAE,EAAE;QAC/D,IAAI,CAAC,IAAI;YAAE,OAAM;QACjB,qDAAqD;QACrD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAChC,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,OAAwC,EAAE,CAAC;gBACtE,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;YAChC,CAAC;QACH,CAAC;QACD,uCAAuC;QACvC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YACpC,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,WAA6C,EAAE,CAAC;gBAC5E,UAAU,CAAC,UAAU,CAAC,CAAA;YACxB,CAAC;QACH,CAAC;IACH,CAAC,CAAA;IAED,UAAU,CAAE,MAAkC,EAAE,MAAiC,CAAC,CAAA;AACpF,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAe,EAAgB,EAAE;IACpE,6BAA6B,CAAC,MAAM,CAAC,CAAA;IACrC,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/C,MAAM,UAAU,GAAG;QACjB,GAAG,MAAM;QACT,WAAW,EAAE,kBAAkB,CAAC,MAAM,CAAC,WAAW,IAAI,SAAS,CAAC;QAChE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,wBAAwB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;KAC5E,CAAA;IAED,OAAO,UAA0B,CAAA;AACnC,CAAC,CAAA"}

package/dist/config-test.d.ts

@@ -0,0 +1,18 @@
+import type { CanopyConfig, CanopyConfigInput, RootCollectionConfig } from './config';
+import { type CanopyServices, type CreateCanopyServicesOptions } from './services';
+type TestConfigInput = Omit<CanopyConfigInput, 'gitBotAuthorName' | 'gitBotAuthorEmail' | 'schema'> & {
+    schema: RootCollectionConfig;
+} & Partial<Pick<CanopyConfigInput, 'gitBotAuthorName' | 'gitBotAuthorEmail'>>;
+/**
+ * Test-only helper that fills required author fields for convenience.
+ * Do not use in production code; prefer defineCanopyConfig.
+ */
+export declare const defineCanopyTestConfig: (config: TestConfigInput, overrides?: Partial<CanopyConfigInput>) => CanopyConfig;
+/**
+ * Test-only helper that creates CanopyServices with inline schema.
+ * Creates a mock branchSchemaCache that returns the test schema without requiring .collection.json files.
+ * Do not use in production code; use createCanopyServices with entrySchemaRegistry.
+ */
+export declare const createTestServices: (config: TestConfigInput, options?: CreateCanopyServicesOptions) => Promise<CanopyServices>;
+export {};
+//# sourceMappingURL=config-test.d.ts.map

package/dist/config-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-test.d.ts","sourceRoot":"","sources":["../src/config-test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAErF,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,2BAA2B,EACjC,MAAM,YAAY,CAAA;AAOnB,KAAK,eAAe,GAAG,IAAI,CACzB,iBAAiB,EACjB,kBAAkB,GAAG,mBAAmB,GAAG,QAAQ,CACpD,GAAG;IACF,MAAM,EAAE,oBAAoB,CAAA;CAC7B,GAAG,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,kBAAkB,GAAG,mBAAmB,CAAC,CAAC,CAAA;AAE9E;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GACjC,QAAQ,eAAe,EACvB,YAAY,OAAO,CAAC,iBAAiB,CAAC,KACrC,YAQF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,eAAe,EACvB,UAAU,2BAA2B,KACpC,OAAO,CAAC,cAAc,CAmBxB,CAAA"}

package/dist/config-test.js

@@ -0,0 +1,42 @@
+import { defineCanopyConfig, flattenSchema } from './config';
+import { createTestCanopyServices, } from './services';
+const FALLBACK_AUTHOR = {
+    gitBotAuthorName: 'CanopyCMS Test Bot',
+    gitBotAuthorEmail: 'canopycms-test@example.com',
+};
+/**
+ * Test-only helper that fills required author fields for convenience.
+ * Do not use in production code; prefer defineCanopyConfig.
+ */
+export const defineCanopyTestConfig = (config, overrides) => {
+    // Destructure to exclude schema from being spread into defineCanopyConfig
+    const { schema: _schema, ...configWithoutSchema } = config;
+    return defineCanopyConfig({
+        ...FALLBACK_AUTHOR,
+        ...configWithoutSchema,
+        ...(overrides ?? {}),
+    }).server;
+};
+/**
+ * Test-only helper that creates CanopyServices with inline schema.
+ * Creates a mock branchSchemaCache that returns the test schema without requiring .collection.json files.
+ * Do not use in production code; use createCanopyServices with entrySchemaRegistry.
+ */
+export const createTestServices = async (config, options) => {
+    const canopyConfig = defineCanopyTestConfig(config);
+    const flatSchema = flattenSchema(config.schema, canopyConfig.contentRoot);
+    // Create a mock branchSchemaCache that returns the test schema
+    const mockBranchSchemaCache = {
+        getSchema: async () => ({
+            schema: config.schema,
+            flatSchema,
+        }),
+        invalidate: async () => { },
+        clearAll: async () => { },
+    };
+    return createTestCanopyServices(canopyConfig, {
+        ...options,
+        branchSchemaCache: mockBranchSchemaCache,
+    });
+};
+//# sourceMappingURL=config-test.js.map

package/dist/config-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-test.js","sourceRoot":"","sources":["../src/config-test.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC5D,OAAO,EACL,wBAAwB,GAGzB,MAAM,YAAY,CAAA;AAEnB,MAAM,eAAe,GAAG;IACtB,gBAAgB,EAAE,oBAAoB;IACtC,iBAAiB,EAAE,4BAA4B;CAChD,CAAA;AASD;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,MAAuB,EACvB,SAAsC,EACxB,EAAE;IAChB,0EAA0E;IAC1E,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,mBAAmB,EAAE,GAAG,MAAM,CAAA;IAC1D,OAAO,kBAAkB,CAAC;QACxB,GAAG,eAAe;QAClB,GAAG,mBAAmB;QACtB,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC;KACrB,CAAC,CAAC,MAAM,CAAA;AACX,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EACrC,MAAuB,EACvB,OAAqC,EACZ,EAAE;IAC3B,MAAM,YAAY,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAA;IACnD,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,WAAW,CAAC,CAAA;IAEzE,+DAA+D;IAC/D,MAAM,qBAAqB,GAAG;QAC5B,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YACtB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,UAAU;SACX,CAAC;QACF,UAAU,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAC1B,QAAQ,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;KACzB,CAAA;IAED,OAAO,wBAAwB,CAAC,YAAY,EAAE;QAC5C,GAAG,OAAO;QACV,iBAAiB,EACf,qBAAoF;KACvF,CAAC,CAAA;AACJ,CAAC,CAAA"}

package/dist/config.d.ts

@@ -0,0 +1,10 @@
+/**
+ * CanopyCMS Configuration
+ *
+ * This file re-exports from the config module for backward compatibility.
+ * New code should import directly from './config/index' or './config'.
+ *
+ * @module config
+ */
+export * from './config/index';
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,gBAAgB,CAAA"}

package/dist/config.js

@@ -0,0 +1,11 @@
+/**
+ * CanopyCMS Configuration
+ *
+ * This file re-exports from the config module for backward compatibility.
+ * New code should import directly from './config/index' or './config'.
+ *
+ * @module config
+ */
+// Re-export everything from the config module
+export * from './config/index';
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,8CAA8C;AAC9C,cAAc,gBAAgB,CAAA"}

package/dist/content-id-index.d.ts

@@ -0,0 +1,152 @@
+import { type LogicalPath, type PhysicalPath, type EntrySlug, type ContentId } from './paths';
+export interface IdLocation {
+    id: ContentId;
+    type: 'entry' | 'collection';
+    relativePath: PhysicalPath;
+    collection?: LogicalPath;
+    slug?: EntrySlug;
+}
+/**
+ * ContentIdIndex manages the bidirectional mapping between content IDs and file paths.
+ *
+ * IDs are embedded in filenames using the patterns:
+ * - Entries: `{type}.{slug}.{12-char-id}.{ext}` (e.g., `post.dune.a1b2c3d4e5f6.json`)
+ * - Collection directories: `{slug}.{12-char-id}/` (e.g., `posts.a1b2c3d4e5f6/`)
+ *
+ * This class builds an in-memory index by scanning filenames recursively, providing O(1) lookups
+ * in both directions (ID→path and path→ID).
+ *
+ * The index is built lazily on first access to optimize Lambda cold starts.
+ *
+ * ## Multi-Process Consistency
+ *
+ * This class is NOT thread-safe. In multi-process environments (e.g., multiple Lambda
+ * instances or server processes), each process maintains its own in-memory index.
+ *
+ * **Consistency guarantees:**
+ * - Filenames on the filesystem are the source of truth
+ * - Each process discovers the same filenames when building its index
+ * - Write operations that change filenames are atomic (rename is atomic)
+ * - Read operations always reflect current filesystem state after index rebuild
+ *
+ * **Race condition handling:**
+ * - Multiple processes creating entries simultaneously: Each generates a unique ID,
+ *   collisions detected during index build (fail fast)
+ * - One process writes, another reads: Reader's stale index might miss new IDs until
+ *   next rebuild. This is acceptable - eventual consistency.
+ * - Index drift: Rare, but processes can rebuild index if they detect missing IDs
+ *
+ * For most use cases (CMS with human editors), race conditions are unlikely and
+ * eventual consistency is sufficient.
+ */
+export declare class ContentIdIndex {
+    private idToLocation;
+    private pathToId;
+    private byCollection;
+    private root;
+    constructor(root: string);
+    /**
+     * Build index by scanning filenames recursively.
+     * Throws if duplicate IDs found (collision detection).
+     */
+    buildFromFilenames(startPath?: string): Promise<void>;
+    private scanDirectory;
+    /**
+     * Forward lookup: ID → location (O(1))
+     */
+    findById(id: string): IdLocation | null;
+    /**
+     * Reverse lookup: path → ID (O(1))
+     */
+    findByPath(relativePath: PhysicalPath): ContentId | null;
+    /**
+     * Get all ID locations in the index.
+     * Useful for validation and checking references.
+     */
+    getAllLocations(): IdLocation[];
+    /**
+     * Get all entries in a collection by collection path.
+     *
+     * Performance: O(1) + O(m) where m is the number of entries in the collection.
+     *
+     * @param collectionPath - The collection path (e.g., "content/posts")
+     * @returns Array of IdLocation objects for entries in the collection
+     */
+    getEntriesInCollection(collectionPath: LogicalPath): IdLocation[];
+    /**
+     * Add a new entry or collection to the index.
+     * Note: This only updates the in-memory index. The file with embedded ID
+     * must already exist on disk (created by ContentStore).
+     */
+    add(location: Omit<IdLocation, 'id'>): void;
+    /**
+     * Remove an entry or collection from the index by ID.
+     * Note: This only updates the in-memory index. The file must be deleted separately.
+     */
+    remove(id: ContentId): void;
+    /**
+     * Update the path for an existing ID (e.g., after file rename/move).
+     * This is used to keep the index in sync when files are renamed.
+     */
+    updatePath(id: ContentId, newRelativePath: PhysicalPath): void;
+}
+/**
+ * Extract ID from filename.
+ * Returns null if filename doesn't contain an ID or is a metadata file.
+ *
+ * Pattern:
+ * - Collection entry files: type.slug.id.ext → ID is parts[parts.length - 2] (e.g., "post.dune.a1b2c3d4e5f6.json")
+ * - Collection directories: slug.id → ID is parts[1] (e.g., "posts.a1b2c3d4e5f6")
+ * - Metadata files: .collection.json, .gitignore, etc. → null
+ *
+ * Edge cases:
+ * - Slugs with dots: "post.my.page.a1b2c3d4e5f6.json" → extracts "a1b2c3d4e5f6"
+ * - Hidden files with IDs: ".hidden.a1b2c3d4e5f6.json" → returns null (metadata)
+ * - No ID present: "file.json" → returns null
+ */
+export declare function extractIdFromFilename(filename: string): ContentId | null;
+/**
+ * Resolve a logical collection path to its actual filesystem path with embedded IDs.
+ * Recursively resolves each path segment to handle nested collections.
+ *
+ * Example:
+ *   Input: resolveCollectionPath(root, "content/docs/api")
+ *   Output: "/abs/path/to/content/docs.bChqT78gcaLd/api.meiuwxTSo7UN"
+ *
+ * @param root - Absolute path to the workspace root
+ * @param logicalPath - Logical path from schema (e.g., "content/docs/api")
+ * @returns Absolute filesystem path with embedded IDs, or null if path doesn't exist
+ */
+export declare function resolveCollectionPath(root: string, logicalPath: LogicalPath): Promise<string | null>;
+/**
+ * Extract entry type name from filename.
+ * For collection entry files with pattern type.slug.id.ext, returns the type (first part).
+ *
+ * Examples:
+ * - "post.my-slug.a1b2c3d4e5f6.json" → "post"
+ * - "article.test.a1b2c3d4e5f6.md" → "article"
+ * - "posts.a1b2c3d4e5f6" → null (directory, not an entry file)
+ *
+ * @param filename - The filename to parse
+ * @returns Entry type name or null if not a valid entry file
+ */
+export declare function extractEntryTypeFromFilename(filename: string): string | null;
+/**
+ * Extract slug from filename.
+ *
+ * Collection entries: type.slug.id.ext → slug is parts[1...-2] (between type and ID)
+ * Directories: slug.id → slug is parts[0] (before ID)
+ *
+ * For collection entry files (4+ parts), automatically strips the first part (type) to extract just the slug.
+ *
+ * Examples:
+ * - "post.my-slug.a1b2c3d4e5f6.json" → "my-slug" (4 parts)
+ * - "post.my.page.a1b2c3d4e5f6.json" → "my.page" (dotted slug, 5 parts)
+ * - "posts.a1b2c3d4e5f6" → "posts" (directory, 2 parts)
+ *
+ * @param filename - The filename to parse
+ * @param entryTypeName - Optional entry type name for explicit type matching (e.g., "post")
+ *                        If provided and matches first part, strips it from slug
+ */
+export declare function extractSlugFromFilename(filename: string, entryTypeName?: string): string;
+//# sourceMappingURL=content-id-index.d.ts.map