canopycms 0.0.0

package/dist/entry-schema-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-schema-registry.d.ts","sourceRoot":"","sources":["../src/entry-schema-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAC3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAEzD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAsB/F;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,2BAA2B,CAC/C,mBAAmB,EAAE,mBAAmB,EACxC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAmDf"}

package/dist/entry-schema-registry.js

@@ -0,0 +1,101 @@
+/**
+ * Creates a type-safe entry schema registry with runtime validation.
+ *
+ * Maps entry schema names to their field definitions. These names are
+ * referenced by `.collection.json` files via the `"schema"` property.
+ *
+ * @example
+ * ```typescript
+ * import { createEntrySchemaRegistry } from 'canopycms/server'
+ *
+ * export const entrySchemaRegistry = createEntrySchemaRegistry({
+ *   postSchema: [
+ *     { type: 'string', name: 'title', label: 'Title', required: true },
+ *     { type: 'markdown', name: 'body', label: 'Body' },
+ *   ],
+ *   authorSchema: [
+ *     { type: 'string', name: 'name', label: 'Name', required: true },
+ *   ],
+ * })
+ * ```
+ */
+export function createEntrySchemaRegistry(registry) {
+    // Validate that registry is not empty
+    if (!registry || typeof registry !== 'object') {
+        throw new Error('Entry schema registry must be an object');
+    }
+    const keys = Object.keys(registry);
+    if (keys.length === 0) {
+        throw new Error('Entry schema registry cannot be empty');
+    }
+    // Validate each entry schema
+    for (const [key, schema] of Object.entries(registry)) {
+        if (!Array.isArray(schema)) {
+            throw new Error(`Entry schema registry entry "${key}" must be an array of FieldConfig`);
+        }
+        if (schema.length === 0) {
+            throw new Error(`Entry schema registry entry "${key}" cannot be empty`);
+        }
+    }
+    return registry;
+}
+/**
+ * Validates that entry schema references in .collection.json files exist in the registry.
+ *
+ * Useful for build-time validation to catch schema reference errors early
+ * rather than at runtime on first request.
+ *
+ * @param entrySchemaRegistry - The entry schema registry mapping names to field definitions
+ * @param contentPath - Path to the content directory containing .collection.json files
+ * @returns Promise that resolves if validation passes, rejects with descriptive error if not
+ *
+ * @example
+ * ```typescript
+ * import { validateEntrySchemaRegistry } from 'canopycms/server'
+ * import { entrySchemaRegistry } from './schemas'
+ *
+ * await validateEntrySchemaRegistry(entrySchemaRegistry, './content')
+ * ```
+ */
+export async function validateEntrySchemaRegistry(entrySchemaRegistry, contentPath) {
+    const { loadCollectionMetaFiles } = await import('./schema');
+    const { access } = await import('fs/promises');
+    // Check if content directory exists
+    try {
+        await access(contentPath);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            throw new Error(`Content directory not found: ${contentPath}`);
+        }
+        throw err;
+    }
+    // Load all .collection.json files
+    const metaFiles = await loadCollectionMetaFiles(contentPath);
+    const availableSchemas = Object.keys(entrySchemaRegistry);
+    const errors = [];
+    // Validate root entry type references
+    if (metaFiles.root?.entries) {
+        for (const entryType of metaFiles.root.entries) {
+            if (!entrySchemaRegistry[entryType.schema]) {
+                errors.push(`Root entry type "${entryType.name}" references entry schema "${entryType.schema}" which does not exist in registry. ` +
+                    `Available: ${availableSchemas.join(', ')}`);
+            }
+        }
+    }
+    // Validate collection entry type references
+    for (const collection of metaFiles.collections) {
+        if (collection.entries) {
+            for (const entryType of collection.entries) {
+                if (!entrySchemaRegistry[entryType.schema]) {
+                    errors.push(`Entry type "${entryType.name}" in collection "${collection.name}" (${collection.path}) references entry schema "${entryType.schema}" which does not exist in registry. ` +
+                        `Available: ${availableSchemas.join(', ')}`);
+                }
+            }
+        }
+    }
+    if (errors.length > 0) {
+        throw new Error(`Entry schema registry validation failed:\n${errors.map((e) => `  - ${e}`).join('\n')}`);
+    }
+}
+//# sourceMappingURL=entry-schema-registry.js.map

package/dist/entry-schema-registry.js.map

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

package/dist/entry-schema.d.ts

@@ -0,0 +1,74 @@
+type InferableField = {
+    name: string;
+    type: string;
+    required?: boolean;
+    list?: boolean;
+    fields?: readonly InferableField[];
+    templates?: ReadonlyArray<{
+        name: string;
+        fields: readonly InferableField[];
+    }>;
+};
+type RequiredValue<F extends InferableField, V> = F['required'] extends false ? V | undefined : V;
+type ScalarValue<F extends InferableField, V> = RequiredValue<F, F['list'] extends true ? V[] : V>;
+type ObjectValue<F extends InferableField & {
+    fields: readonly InferableField[];
+}> = RequiredValue<F, F['list'] extends true ? Array<InferContentShape<F['fields']>> : InferContentShape<F['fields']>>;
+type BlockValue<F extends InferableField & {
+    templates: ReadonlyArray<{
+        name: string;
+        fields: readonly InferableField[];
+    }>;
+}> = RequiredValue<F, Array<F['templates'][number] extends {
+    name: infer N;
+    fields: infer Fields;
+} ? {
+    template: N & string;
+    value: InferContentShape<Extract<Fields, readonly InferableField[]>>;
+} : never>>;
+type FieldValue<F extends InferableField> = F extends {
+    type: 'object';
+    fields: infer Fields;
+} ? ObjectValue<F & {
+    fields: Extract<Fields, readonly InferableField[]>;
+}> : F extends {
+    type: 'block';
+    templates: infer Templates;
+} ? BlockValue<F & {
+    templates: NonNullable<Extract<Templates, ReadonlyArray<{
+        name: string;
+        fields: readonly InferableField[];
+    }>>>;
+}> : F extends {
+    type: 'select';
+} ? ScalarValue<F, string | number> : F extends {
+    type: 'reference';
+} ? ScalarValue<F, Record<string, unknown> | null> : F extends {
+    type: 'boolean';
+} ? ScalarValue<F, boolean> : F extends {
+    type: 'number';
+} ? ScalarValue<F, number> : F extends {
+    type: 'date';
+} ? ScalarValue<F, string> : ScalarValue<F, string>;
+/**
+ * Infer a TypeScript data shape from a CanopyCMS FieldConfig-like array.
+ * - Objects become nested objects
+ * - Blocks become arrays of tagged templates with their value shapes
+ * - Lists become arrays of the scalar/object type
+ * - Non-required fields include `undefined`
+ *
+ * Works with any structurally compatible array; importing FieldConfig is not required.
+ */
+type InferContentShape<Fields extends readonly InferableField[]> = {
+    [F in Fields[number] as F['name']]: FieldValue<F>;
+};
+/**
+ * Helper to define entry schema field arrays with literal inference without sprinkling `as const`.
+ */
+export declare const defineEntrySchema: <const T extends readonly InferableField[]>(fields: T) => T;
+/**
+ * Convenience alias to derive the content shape from a `defineEntrySchema` result.
+ */
+export type TypeFromEntrySchema<T extends readonly InferableField[]> = InferContentShape<T>;
+export {};
+//# sourceMappingURL=entry-schema.d.ts.map

package/dist/entry-schema.d.ts.map

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

package/dist/entry-schema.js

@@ -0,0 +1,5 @@
+/**
+ * Helper to define entry schema field arrays with literal inference without sprinkling `as const`.
+ */
+export const defineEntrySchema = (fields) => fields;
+//# sourceMappingURL=entry-schema.js.map

package/dist/entry-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-schema.js","sourceRoot":"","sources":["../src/entry-schema.ts"],"names":[],"mappings":"AA2EA;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAA4C,MAAS,EAAK,EAAE,CAAC,MAAM,CAAA"}

package/dist/git-manager.d.ts

@@ -0,0 +1,144 @@
+import { type SimpleGitOptions, type StatusResult } from 'simple-git';
+import type { OperatingMode } from './operating-mode';
+export interface GitManagerOptions {
+    repoPath: string;
+    baseBranch?: string;
+    remote?: string;
+}
+export type GitStatus = Pick<StatusResult, 'files' | 'ahead' | 'behind' | 'current' | 'tracking'>;
+export interface ResolveRemoteUrlOptions {
+    mode: OperatingMode;
+    remoteUrl?: string;
+    defaultRemoteUrl?: string;
+    baseBranch: string;
+    sourceRoot?: string;
+}
+export interface InitializeWorkspaceOptions {
+    workspacePath: string;
+    branchName: string;
+    mode: OperatingMode;
+    baseBranch?: string;
+    sourceRoot?: string;
+    defaultRemoteUrl?: string;
+    remoteUrl?: string;
+    remoteName?: string;
+    branchType: 'content' | 'orphan';
+}
+export declare class GitManager {
+    private readonly git;
+    private readonly repoPath;
+    private readonly baseBranch;
+    private readonly remote;
+    constructor(options: GitManagerOptions, gitOptions?: Partial<SimpleGitOptions>);
+    static cloneRepo(remoteUrl: string, targetPath: string, baseBranch?: string): Promise<void>;
+    /**
+     * Initializes a local bare git repository to simulate a remote for prod-sim mode.
+     *
+     * This is idempotent - if the remote already exists, it will not be recreated.
+     *
+     * The remote is seeded with the current state of the baseBranch (e.g., 'main').
+     * If you need to change the baseBranch or reset the simulation, delete
+     * `.canopycms/remote.git` and `.canopycms/branches` and restart.
+     *
+     * @throws Error if not a git repo, no commits, or baseBranch doesn't exist
+     */
+    static ensureLocalSimulatedRemote(options: {
+        remotePath: string;
+        sourcePath: string;
+        baseBranch: string;
+        subdirectory?: string;
+    }): Promise<void>;
+    /**
+     * Find the git root directory
+     * @returns Path to git root, or cwd if not in a git repo
+     */
+    static findGitRoot(): Promise<string>;
+    /**
+     * Validate that a git repository exists at the given path
+     * @param repoPath - Path to check for .git directory
+     * @throws Error if git repo doesn't exist
+     */
+    static validateGitRepoExists(repoPath: string): Promise<void>;
+    /**
+     * Resolves the remote URL for git operations following the priority:
+     * 1. Explicit remoteUrl parameter
+     * 2. Config defaultRemoteUrl
+     * 3. Environment variable (mode-specific)
+     * 4. Auto-initialized local remote (for prod-sim mode)
+     * 5. undefined (for dev mode)
+     *
+     * Uses strategy flags to determine behavior, GitManager executes the logic.
+     *
+     * @param options.sourceRoot - Optional source directory for monorepos. When provided,
+     *   this directory (relative to git root) is used as the source for the simulated remote.
+     *   Defaults to process.cwd().
+     *
+     * @returns Remote URL or undefined if no remote is needed
+     */
+    static resolveRemoteUrl(options: ResolveRemoteUrlOptions): Promise<string | undefined>;
+    /**
+     * Ensures a git workspace is initialized and ready for use.
+     * Handles cloning, remote configuration, and branch checkout/creation.
+     *
+     * This centralizes the common initialization sequence used by both BranchWorkspaceManager
+     * and SettingsWorkspaceManager.
+     *
+     * Note: Does NOT configure git author - that should be done before commits, not during init.
+     *
+     * @returns Configured GitManager instance for the workspace
+     */
+    static initializeWorkspace(options: InitializeWorkspaceOptions): Promise<GitManager>;
+    status(): Promise<GitStatus>;
+    checkoutBranch(branch: string): Promise<void>;
+    pullBase(): Promise<void>;
+    pullCurrentBranch(): Promise<void>;
+    rebaseOntoBase(): Promise<void>;
+    add(files: string | string[]): Promise<void>;
+    commit(message: string): Promise<void>;
+    push(branch?: string): Promise<void>;
+    ensureAuthor(author: {
+        name: string;
+        email: string;
+    }): Promise<void>;
+    ensureRemote(remoteUrl: string): Promise<void>;
+    /**
+     * Check if working directory has uncommitted changes
+     */
+    hasUncommittedChanges(): Promise<boolean>;
+    /**
+     * Get list of uncommitted file paths
+     */
+    getUncommittedFiles(): Promise<string[]>;
+    /**
+     * Force push (use with caution - for PR updates only)
+     * Uses --force-with-lease for safer force pushes
+     */
+    forcePush(branch?: string): Promise<void>;
+    /**
+     * Get remote URL for current repo
+     */
+    getRemoteUrl(): Promise<string | undefined>;
+    /**
+     * Add a pattern to .git/info/exclude to prevent it from being committed/pushed.
+     * This is used to exclude .canopy-meta/ from content branch workspaces.
+     *
+     * .git/info/exclude is a per-repository gitignore that never gets committed.
+     * Perfect for runtime metadata that should never leave the workspace.
+     *
+     * This is idempotent - if the pattern already exists, it won't be added again.
+     */
+    ensureGitExclude(pattern: string): Promise<void>;
+    /**
+     * Create an orphan branch for settings (permissions/groups).
+     *
+     * Orphan branches have no shared history with other branches - they start fresh.
+     * This is perfect for deployment-specific settings that shouldn't pollute content history.
+     *
+     * The branch contains only settings files in .canopy-meta/ (groups.json, permissions.json).
+     *
+     * @param branchName - Name of the orphan branch (e.g., 'canopycms-settings-prod')
+     * @param initialFiles - Files to commit to the new branch (e.g., { 'permissions.json': '{}', 'groups.json': '{}' })
+     */
+    createOrphanSettingsBranch(branchName: string, initialFiles: Record<string, string>): Promise<void>;
+}
+//# sourceMappingURL=git-manager.d.ts.map

package/dist/git-manager.d.ts.map

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