canopycms 0.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"content-id-index.d.ts","sourceRoot":"","sources":["../src/content-id-index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAA;AAmB7F,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,SAAS,CAAA;IACb,IAAI,EAAE,OAAO,GAAG,YAAY,CAAA;IAC5B,YAAY,EAAE,YAAY,CAAA;IAC1B,UAAU,CAAC,EAAE,WAAW,CAAA;IACxB,IAAI,CAAC,EAAE,SAAS,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAAqC;IACzD,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,YAAY,CAAsC;IAC1D,OAAO,CAAC,IAAI,CAAQ;gBAER,IAAI,EAAE,MAAM;IAIxB;;;OAGG;IACG,kBAAkB,CAAC,SAAS,GAAE,MAAW,GAAG,OAAO,CAAC,IAAI,CAAC;YAIjD,aAAa;IAkE3B;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAIvC;;OAEG;IACH,UAAU,CAAC,YAAY,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI;IAIxD;;;OAGG;IACH,eAAe,IAAI,UAAU,EAAE;IAI/B;;;;;;;OAOG;IACH,sBAAsB,CAAC,cAAc,EAAE,WAAW,GAAG,UAAU,EAAE;IAiBjE;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,IAAI;IAgC3C;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI;IAoB3B;;;OAGG;IACH,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,GAAG,IAAI;CA6C/D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAuBxE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA+BxB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAc5E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAsCxF"}

package/dist/content-id-index.js

@@ -0,0 +1,416 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { isValidId } from './id';
+import { isNotFoundError } from './utils/error';
+/** Logical path representing entries stored at the branch root (no parent collection). Rare in practice. */
+const EMPTY_LOGICAL_PATH = '';
+/**
+ * Strips embedded IDs from each physical path segment to produce a logical path.
+ * e.g. "content/posts.a1b2c3d4e5f6" → "content/posts"
+ * This is a module-private helper for internal path conversion only.
+ */
+function toLogicalCollectionPath(physicalPath) {
+    if (physicalPath === '.')
+        return EMPTY_LOGICAL_PATH;
+    // extractSlugFromFilename strips the ID (and extension) from each segment
+    return physicalPath
+        .split('/')
+        .map((seg) => extractSlugFromFilename(seg))
+        .join('/');
+}
+/**
+ * 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 class ContentIdIndex {
+    constructor(root) {
+        this.idToLocation = new Map();
+        this.pathToId = new Map();
+        this.byCollection = new Map();
+        this.root = path.resolve(root);
+    }
+    /**
+     * Build index by scanning filenames recursively.
+     * Throws if duplicate IDs found (collision detection).
+     */
+    async buildFromFilenames(startPath = '') {
+        await this.scanDirectory(startPath);
+    }
+    async scanDirectory(relativePath) {
+        const absoluteDir = path.join(this.root, relativePath);
+        try {
+            const entries = await fs.readdir(absoluteDir, { withFileTypes: true });
+            for (const entry of entries) {
+                // Skip hidden files and directories (including _ids_)
+                if (entry.name.startsWith('.') || entry.name === '_ids_') {
+                    continue;
+                }
+                const fullRelativePath = path.join(relativePath, entry.name);
+                const id = extractIdFromFilename(entry.name);
+                if (id) {
+                    // Collision detection
+                    if (this.idToLocation.has(id)) {
+                        const existing = this.idToLocation.get(id);
+                        throw new Error(`ID collision detected: ${id}\n` +
+                            `  File 1: ${existing.relativePath}\n` +
+                            `  File 2: ${fullRelativePath}`);
+                    }
+                    const location = {
+                        id, // already ContentId from extractIdFromFilename
+                        type: entry.isDirectory() ? 'collection' : 'entry',
+                        relativePath: fullRelativePath, // filesystem path with embedded IDs
+                    };
+                    // Extract slug and collection for entries
+                    if (!entry.isDirectory()) {
+                        const slug = extractSlugFromFilename(entry.name);
+                        // Convert physical collection path to logical by stripping embedded IDs from each segment
+                        // e.g., "content/posts.a1b2c3d4e5f6" → "content/posts"
+                        const physicalCollection = path.dirname(fullRelativePath);
+                        const collectionPath = toLogicalCollectionPath(physicalCollection);
+                        location.slug = slug; // slug extracted from validated filename
+                        location.collection = collectionPath;
+                        // Add to collection index
+                        if (!this.byCollection.has(collectionPath)) {
+                            this.byCollection.set(collectionPath, new Set());
+                        }
+                        this.byCollection.get(collectionPath).add(id);
+                    }
+                    this.idToLocation.set(id, location);
+                    this.pathToId.set(fullRelativePath, id);
+                }
+                // Recurse into directories
+                if (entry.isDirectory()) {
+                    await this.scanDirectory(fullRelativePath);
+                }
+            }
+        }
+        catch (err) {
+            // Directory might not exist yet
+            if (err.code !== 'ENOENT') {
+                throw err;
+            }
+        }
+    }
+    /**
+     * Forward lookup: ID → location (O(1))
+     */
+    findById(id) {
+        return this.idToLocation.get(id) || null;
+    }
+    /**
+     * Reverse lookup: path → ID (O(1))
+     */
+    findByPath(relativePath) {
+        return this.pathToId.get(relativePath) || null;
+    }
+    /**
+     * Get all ID locations in the index.
+     * Useful for validation and checking references.
+     */
+    getAllLocations() {
+        return Array.from(this.idToLocation.values());
+    }
+    /**
+     * 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) {
+        const idSet = this.byCollection.get(collectionPath);
+        if (!idSet) {
+            return [];
+        }
+        const locations = [];
+        for (const id of idSet) {
+            const location = this.idToLocation.get(id);
+            if (location) {
+                locations.push(location);
+            }
+        }
+        return locations;
+    }
+    /**
+     * 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) {
+        const id = extractIdFromFilename(path.basename(location.relativePath));
+        if (!id) {
+            throw new Error(`Cannot add location without ID in filename: ${location.relativePath}`);
+        }
+        // Collision detection
+        if (this.idToLocation.has(id)) {
+            const existing = this.idToLocation.get(id);
+            throw new Error(`ID collision detected: ${id}\n` +
+                `  File 1: ${existing.relativePath}\n` +
+                `  File 2: ${location.relativePath}`);
+        }
+        const fullLocation = {
+            ...location,
+            id, // already ContentId from extractIdFromFilename
+        };
+        this.idToLocation.set(id, fullLocation);
+        this.pathToId.set(location.relativePath, id);
+        // Add to collection index if it's an entry
+        if (fullLocation.type === 'entry' && fullLocation.collection) {
+            if (!this.byCollection.has(fullLocation.collection)) {
+                this.byCollection.set(fullLocation.collection, new Set());
+            }
+            this.byCollection.get(fullLocation.collection).add(id);
+        }
+    }
+    /**
+     * 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) {
+        const location = this.idToLocation.get(id);
+        if (!location)
+            return;
+        // Remove from collection index if it's an entry
+        if (location.type === 'entry' && location.collection) {
+            const idSet = this.byCollection.get(location.collection);
+            if (idSet) {
+                idSet.delete(id);
+                // Clean up empty Sets to prevent memory leaks
+                if (idSet.size === 0) {
+                    this.byCollection.delete(location.collection);
+                }
+            }
+        }
+        this.idToLocation.delete(id);
+        this.pathToId.delete(location.relativePath);
+    }
+    /**
+     * 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, newRelativePath) {
+        const location = this.idToLocation.get(id);
+        if (!location) {
+            throw new Error(`Cannot update path for unknown ID: ${id}`);
+        }
+        // Remove old path mapping
+        this.pathToId.delete(location.relativePath);
+        // Update location
+        location.relativePath = newRelativePath;
+        // Update slug and collection for entries
+        if (location.type === 'entry') {
+            const oldCollection = location.collection;
+            location.slug = extractSlugFromFilename(path.basename(newRelativePath)); // from validated filename
+            const physicalCollection = path.dirname(newRelativePath);
+            location.collection = toLogicalCollectionPath(physicalCollection);
+            // Update collection index if collection changed
+            if (oldCollection !== location.collection) {
+                // Remove from old collection
+                if (oldCollection) {
+                    const oldSet = this.byCollection.get(oldCollection);
+                    if (oldSet) {
+                        oldSet.delete(id);
+                        if (oldSet.size === 0) {
+                            this.byCollection.delete(oldCollection);
+                        }
+                    }
+                }
+                // Add to new collection
+                if (location.collection) {
+                    if (!this.byCollection.has(location.collection)) {
+                        this.byCollection.set(location.collection, new Set());
+                    }
+                    this.byCollection.get(location.collection).add(id);
+                }
+            }
+        }
+        // Add new path mapping
+        this.pathToId.set(newRelativePath, id);
+    }
+}
+/**
+ * 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 function extractIdFromFilename(filename) {
+    // Skip metadata files (no IDs) - anything starting with dot is metadata
+    // This includes .collection.json, .gitignore, and even .hidden.id.json
+    if (filename.startsWith('.')) {
+        return null;
+    }
+    const parts = filename.split('.');
+    // Files: type.slug.id.ext → need at least 3 parts
+    // The ID is always the second-to-last part before the extension
+    if (parts.length >= 3) {
+        const candidate = parts[parts.length - 2];
+        if (isValidId(candidate))
+            return candidate;
+    }
+    // Directories: slug.id → exactly 2 parts (slug and ID, no extension)
+    if (parts.length === 2) {
+        const candidate = parts[parts.length - 1];
+        if (isValidId(candidate))
+            return candidate;
+    }
+    return 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 async function resolveCollectionPath(root, logicalPath) {
+    // Dynamic import: keep Node built-ins out of browser/edge bundles
+    const fs = await import('node:fs/promises');
+    const path = await import('node:path');
+    const segments = logicalPath.split('/').filter(Boolean);
+    let currentPath = root;
+    for (const segment of segments) {
+        try {
+            const entries = await fs.readdir(currentPath, { withFileTypes: true });
+            const matchingDir = entries.find((entry) => {
+                if (!entry.isDirectory())
+                    return false;
+                // Extract logical name from directory (strips embedded ID)
+                const logicalName = extractSlugFromFilename(entry.name);
+                return logicalName === segment;
+            });
+            if (matchingDir) {
+                currentPath = path.join(currentPath, matchingDir.name);
+            }
+            else {
+                // Directory not found - might not exist yet
+                return null;
+            }
+        }
+        catch (err) {
+            if (isNotFoundError(err))
+                return null;
+            throw err;
+        }
+    }
+    return currentPath;
+}
+/**
+ * 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 function extractEntryTypeFromFilename(filename) {
+    if (filename.startsWith('.'))
+        return null;
+    const parts = filename.split('.');
+    // Need at least 4 parts for type.slug.id.ext
+    if (parts.length >= 4) {
+        const possibleId = parts[parts.length - 2];
+        if (isValidId(possibleId)) {
+            return parts[0]; // Entry type is first part
+        }
+    }
+    return 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 function extractSlugFromFilename(filename, entryTypeName) {
+    const parts = filename.split('.');
+    // Files: type.slug.id.ext (at least 3 parts)
+    if (parts.length >= 3) {
+        const possibleId = parts[parts.length - 2];
+        if (isValidId(possibleId)) {
+            // Get all parts before ID (excluding extension)
+            let slugParts = parts.slice(0, parts.length - 2);
+            // If entryTypeName is provided and matches the first part, strip it
+            if (entryTypeName && slugParts.length > 1 && slugParts[0] === entryTypeName) {
+                slugParts = slugParts.slice(1);
+            }
+            // Auto-detect: 4+ parts means type.slug.id.ext format
+            else if (parts.length >= 4 && slugParts.length > 1) {
+                // Strip first part (the type) to get just the slug
+                slugParts = slugParts.slice(1);
+            }
+            return slugParts.join('.');
+        }
+    }
+    // Directories: slug.id (exactly 2 parts)
+    if (parts.length === 2) {
+        const possibleId = parts[parts.length - 1];
+        if (isValidId(possibleId)) {
+            return parts[0];
+        }
+    }
+    // No ID found, remove extension and return filename without extension
+    if (parts.length > 1) {
+        return parts.slice(0, -1).join('.');
+    }
+    return filename;
+}
+//# sourceMappingURL=content-id-index.js.map

package/dist/content-id-index.js.map

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

package/dist/content-reader.d.ts

@@ -0,0 +1,36 @@
+import { BranchWorkspaceManager } from './branch-workspace';
+import { type LogicalPath, type EntrySlug } from './paths';
+import type { CanopyServices } from './services';
+import type { BranchContext } from './types';
+import type { CanopyUser } from './user';
+export interface ContentReaderOptions {
+    services: CanopyServices;
+    workspaceManager?: BranchWorkspaceManager;
+    basePathOverride?: string;
+    defaultBranch?: string;
+    createdBy?: string;
+    allowCreateBranch?: boolean;
+    getBranchContext?: (branch: string) => Promise<BranchContext | null>;
+}
+export interface ReadContentInput {
+    /** Resolved schema path (e.g., content/posts or content/home). */
+    entryPath: LogicalPath;
+    slug?: EntrySlug;
+    branch?: string;
+    /** User making the request. Required - use ANONYMOUS_USER for public access. */
+    user: CanopyUser;
+    /** Whether to automatically resolve reference fields. Defaults to true. */
+    resolveReferences?: boolean;
+}
+export interface ContentReader {
+    read: <T = unknown>(input: ReadContentInput, message?: string) => Promise<{
+        data: T;
+        path: string;
+    }>;
+}
+/**
+ * Server-side helper to read content directly from a branch workspace.
+ * Falls back to creating the branch workspace (metadata + checkout) if missing.
+ */
+export declare const createContentReader: (options: ContentReaderOptions) => ContentReader;
+//# sourceMappingURL=content-reader.d.ts.map

package/dist/content-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-reader.d.ts","sourceRoot":"","sources":["../src/content-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAqB,MAAM,oBAAoB,CAAA;AAE9E,OAAO,EAAsB,KAAK,WAAW,EAAqB,KAAK,SAAS,EAAE,MAAM,SAAS,CAAA;AAEjG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAIxC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,cAAc,CAAA;IACxB,gBAAgB,CAAC,EAAE,sBAAsB,CAAA;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;CACrE;AAED,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,SAAS,EAAE,WAAW,CAAA;IACtB,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gFAAgF;IAChF,IAAI,EAAE,UAAU,CAAA;IAChB,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,CAAC,CAAC,GAAG,OAAO,EAChB,KAAK,EAAE,gBAAgB,EACvB,OAAO,CAAC,EAAE,MAAM,KACb,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACxC;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,oBAAoB,KAAG,aA2KnE,CAAA"}

package/dist/content-reader.js

@@ -0,0 +1,149 @@
+import { BranchWorkspaceManager, loadBranchContext } from './branch-workspace';
+import { ContentStore, ContentStoreError } from './content-store';
+import { resolveBranchPaths } from './paths';
+import { isBuildMode } from './build-mode';
+import { isNotFoundError } from './utils/error';
+/**
+ * Server-side helper to read content directly from a branch workspace.
+ * Falls back to creating the branch workspace (metadata + checkout) if missing.
+ */
+export const createContentReader = (options) => {
+    const services = options.services;
+    const operatingMode = services.config.mode;
+    const basePathOverride = options.basePathOverride;
+    const workspaceManager = options.workspaceManager ?? new BranchWorkspaceManager(services.config);
+    const defaultBranch = options.defaultBranch ?? services.config.defaultBaseBranch ?? 'main';
+    const allowCreateBranch = options.allowCreateBranch ?? true;
+    const createdBy = options.createdBy ?? 'canopycms-content-reader';
+    const resolveBranchContext = async (branchName) => {
+        const existing = options.getBranchContext
+            ? await options.getBranchContext(branchName)
+            : await loadBranchContext({
+                branchName,
+                mode: operatingMode,
+                basePathOverride,
+            });
+        if (existing) {
+            return existing;
+        }
+        if (!allowCreateBranch) {
+            throw new ContentStoreError(`Branch not found: ${branchName}`);
+        }
+        return await workspaceManager.openOrCreateBranch({
+            branchName,
+            mode: operatingMode,
+            basePathOverride,
+            createdBy,
+            remoteUrl: services.config.defaultRemoteUrl,
+        });
+    };
+    const resolveStore = async (branchName) => {
+        const context = await resolveBranchContext(branchName);
+        const { branchRoot } = resolveBranchPaths(context, operatingMode, basePathOverride);
+        // Load per-branch schema dynamically
+        const branchSchemaCache = services.branchSchemaCache;
+        const contentRootName = services.config.contentRoot || 'content';
+        const { flatSchema: branchFlatSchema } = await branchSchemaCache.getSchema(branchRoot, services.entrySchemaRegistry, contentRootName);
+        return {
+            context,
+            branchRoot,
+            store: new ContentStore(branchRoot, branchFlatSchema),
+        };
+    };
+    const resolveTarget = (input) => {
+        const entryPath = input.entryPath;
+        if (!entryPath) {
+            throw new ContentStoreError('entryPath is required');
+        }
+        const branchName = input.branch ?? defaultBranch;
+        return { entryPath, slug: input.slug, branchName, user: input.user };
+    };
+    const encodeSlug = (value) => (value ?? '')
+        .split('/')
+        .filter(Boolean)
+        .map((segment) => encodeURIComponent(segment))
+        .join('/');
+    // Build preview paths using simple path construction
+    const contentRoot = (services.config.contentRoot ?? 'content').replace(/^\/+|\/+$/g, '');
+    const stripRoot = (val) => contentRoot && val.startsWith(`${contentRoot}/`) ? val.slice(contentRoot.length + 1) : val;
+    const buildEntryPath = (opts) => {
+        // Construct preview path from collectionPath
+        const stripped = stripRoot(opts.collectionPath);
+        const base = stripped ? `/${stripped}` : '/';
+        const appendBranch = (url) => opts.branch
+            ? `${url}${url.includes('?') ? '&' : '?'}branch=${encodeURIComponent(opts.branch)}`
+            : url;
+        const trimmed = base.endsWith('/') ? base.slice(0, -1) : base;
+        const encodedSlug = encodeSlug(opts.slug);
+        const url = encodedSlug ? `${trimmed}/${encodedSlug}` : trimmed || '/';
+        return appendBranch(url);
+    };
+    const readDocument = async (input) => {
+        const { entryPath, slug, branchName, user } = resolveTarget(input);
+        const { context, branchRoot, store } = await resolveStore(branchName);
+        // Get the path WITHOUT reading the file
+        let relativePath;
+        try {
+            const resolved = await store.resolveDocumentPath(entryPath, slug ?? '');
+            relativePath = resolved.relativePath;
+        }
+        catch (err) {
+            const message = err instanceof ContentStoreError ? err.message : 'Invalid content request';
+            throw new ContentStoreError(message);
+        }
+        // Check permissions BEFORE reading the file (security)
+        const shouldCheckPermissions = !isBuildMode();
+        if (shouldCheckPermissions) {
+            const access = await services.checkContentAccess(context, branchRoot, relativePath, user, 'read');
+            if (!access.allowed) {
+                if (services.config.mode === 'dev' || services.config.mode === 'prod-sim') {
+                    const reasons = [];
+                    if (!access.branch.allowed) {
+                        reasons.push(`branch access denied (${access.branch.reason})`);
+                    }
+                    if (!access.path.allowed) {
+                        reasons.push(`path access denied (${access.path.reason ?? 'unknown'})`);
+                    }
+                    const detail = reasons.length > 0 ? `: ${reasons.join(', ')}` : '';
+                    const groupsHint = user.groups.length === 0
+                        ? ' (user has no group memberships — is CANOPY_BOOTSTRAP_ADMIN_IDS configured?)'
+                        : '';
+                    throw new ContentStoreError(`Forbidden${detail}${groupsHint}`);
+                }
+                throw new ContentStoreError('Forbidden');
+            }
+        }
+        // ONLY if permissions pass, read the file
+        try {
+            return await store.read(entryPath, slug ?? '', {
+                resolveReferences: input.resolveReferences ?? true,
+            });
+        }
+        catch (err) {
+            if (isNotFoundError(err))
+                return null;
+            throw err;
+        }
+    };
+    const read = async (input, message) => {
+        const { entryPath, slug, branchName } = resolveTarget(input);
+        const doc = await readDocument(input);
+        if (!doc || typeof doc !== 'object' || !('data' in doc)) {
+            const defaultMessage = `Content not found for ${entryPath}${slug ? `/${slug}` : ''} on branch ${branchName}`;
+            throw new ContentStoreError(message ?? defaultMessage);
+        }
+        // For md/mdx format, merge the body into the data so callers get a complete object
+        const docRecord = doc;
+        const rawData = docRecord.data;
+        const body = docRecord.body;
+        const data = (body != null ? { ...rawData, body } : rawData);
+        const path = buildEntryPath({
+            collectionPath: entryPath,
+            slug,
+            branch: branchName,
+        });
+        return { data, path };
+    };
+    return { read };
+};
+//# sourceMappingURL=content-reader.js.map

package/dist/content-reader.js.map

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