contentbase 0.4.0 → 0.4.2

package/dist/cli/load-collection.js

@@ -0,0 +1,201 @@
+import fs from "fs/promises";
+import path from "path";
+import { existsSync } from "fs";
+import { Collection } from "../collection";
+import { defineModel } from "../define-model";
+import { singularize, upperFirst } from "../utils/inflect";
+import * as contentbaseExports from "../index";
+/**
+ * Search for a file with the given basename and common extensions.
+ */
+async function findFile(dir, basename) {
+    for (const ext of ["ts", "js", "mjs"]) {
+        const candidate = path.resolve(dir, `${basename}.${ext}`);
+        try {
+            await fs.stat(candidate);
+            return candidate;
+        }
+        catch {
+            // Not found, try next
+        }
+    }
+    return undefined;
+}
+/**
+ * Duck-type check: does this value look like a ModelDefinition?
+ */
+function isModelDefinition(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        typeof value.name === "string" &&
+        typeof value.prefix === "string" &&
+        "meta" in value);
+}
+/**
+ * Check if a directory (up to 2 levels deep) contains .md or .mdx files.
+ */
+async function directoryContainsMarkdown(dirPath) {
+    try {
+        const entries = await fs.readdir(dirPath, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isFile() &&
+                (entry.name.endsWith(".md") || entry.name.endsWith(".mdx"))) {
+                return true;
+            }
+            if (entry.isDirectory()) {
+                const subEntries = await fs.readdir(path.join(dirPath, entry.name), { withFileTypes: true });
+                for (const sub of subEntries) {
+                    if (sub.isFile() &&
+                        (sub.name.endsWith(".md") || sub.name.endsWith(".mdx"))) {
+                        return true;
+                    }
+                }
+            }
+        }
+    }
+    catch {
+        // Directory unreadable
+    }
+    return false;
+}
+/**
+ * Tier 3: Auto-discover models from top-level subdirectories containing markdown.
+ */
+async function autoDiscoverModels(collection) {
+    const rootPath = collection.rootPath;
+    let registered = 0;
+    try {
+        const entries = await fs.readdir(rootPath, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const dirPath = path.join(rootPath, entry.name);
+            if (await directoryContainsMarkdown(dirPath)) {
+                const folderName = entry.name;
+                const modelName = upperFirst(singularize(folderName));
+                const model = defineModel(modelName, { prefix: folderName });
+                collection.register(model);
+                registered++;
+            }
+        }
+    }
+    catch {
+        // Root path unreadable
+    }
+    return registered;
+}
+/** Seed the luca VM with contentbase and common deps so models.ts can resolve imports */
+function seedContentbaseModules(container) {
+    const vm = container.feature('vm');
+    // Seed luca modules first
+    const helpers = container.feature('helpers');
+    if (helpers?.seedVirtualModules) {
+        helpers.seedVirtualModules();
+    }
+    vm.defineModule('contentbase', contentbaseExports);
+    try {
+        vm.defineModule('js-yaml', require('js-yaml'));
+    }
+    catch { }
+    try {
+        vm.defineModule('mdast-util-to-string', require('mdast-util-to-string'));
+    }
+    catch { }
+}
+/** Build a VM-backed module loader using the luca container */
+function createVmModuleLoader(container) {
+    let seeded = false;
+    return (filePath) => {
+        if (!seeded) {
+            seedContentbaseModules(container);
+            seeded = true;
+        }
+        return container.feature('vm').loadModule(filePath);
+    };
+}
+export async function loadCollection(options) {
+    let { contentFolder, modulePath } = options;
+    let container = options.container;
+    let rootPath;
+    const cwd = process.cwd();
+    // If no container was passed, try to grab the luca singleton.
+    // This works when running inside the cnotes CLI (which imports luca/node).
+    if (!container) {
+        try {
+            const luca = await import('luca/node');
+            container = luca.default;
+        }
+        catch {
+            // Not running in a luca context — that's fine, native imports will be used
+        }
+    }
+    if (contentFolder) {
+        // Resolve relative to cwd
+        rootPath = path.resolve(cwd, contentFolder);
+    }
+    else {
+        // Check package.json for configured content folder
+        const pkgPath = path.resolve(cwd, "package.json");
+        try {
+            const manifest = JSON.parse(await fs.readFile(pkgPath, "utf8"));
+            if (manifest.contentbase?.contentFolder) {
+                rootPath = path.resolve(cwd, manifest.contentbase.contentFolder);
+            }
+        }
+        catch {
+            // No package.json found
+        }
+        // Default to ./docs
+        rootPath = rootPath ?? path.resolve(cwd, "docs");
+    }
+    // Determine if we need a VM-based loader (no contentbase in node_modules)
+    const needsVmLoader = container?.feature && !existsSync(path.resolve(cwd, "node_modules", "contentbase"));
+    const moduleLoader = needsVmLoader ? createVmModuleLoader(container) : undefined;
+    // Helper to import a module file, falling back to VM when needed
+    const importModule = async (filePath) => {
+        if (moduleLoader) {
+            return moduleLoader(filePath);
+        }
+        return import(filePath);
+    };
+    // Tier 1: index.ts — full collection with models already registered
+    if (!modulePath) {
+        modulePath = await findFile(rootPath, "index");
+    }
+    if (modulePath) {
+        const mod = await importModule(modulePath);
+        const collection = mod.collection ?? mod.default;
+        if (!(collection instanceof Collection)) {
+            throw new Error("Module must export a Collection as 'collection' or default export.");
+        }
+        await collection.load();
+        return collection;
+    }
+    // Tier 2: models.ts — import model definitions and auto-register
+    const modelsPath = await findFile(rootPath, "models");
+    if (modelsPath) {
+        const mod = await importModule(modelsPath);
+        const collection = new Collection({ rootPath, moduleLoader });
+        let registered = 0;
+        for (const [, value] of Object.entries(mod)) {
+            if (isModelDefinition(value)) {
+                collection.register(value);
+                registered++;
+            }
+        }
+        await collection.load();
+        return collection;
+    }
+    // Tier 3: Auto-discover models from folder structure
+    const collection = new Collection({ rootPath, moduleLoader });
+    const discovered = await autoDiscoverModels(collection);
+    if (discovered > 0) {
+        console.warn(`[contentbase] Auto-discovered ${discovered} model(s) from folder structure. These models have no schema validation. Create a models.ts or index.ts for proper type definitions.`);
+    }
+    else {
+        console.warn(`[contentbase] No models or markdown files found in ${rootPath}. Run 'cnotes init' to set up a project.`);
+    }
+    await collection.load();
+    return collection;
+}
+//# sourceMappingURL=load-collection.js.map

package/dist/cli/load-collection.js.map

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

package/dist/cli/registry.d.ts

@@ -0,0 +1,17 @@
+import type { z } from 'zod';
+export interface CommandDefinition {
+    description: string;
+    usage?: string;
+    help?: string;
+    argsSchema?: z.ZodType<any>;
+    handler: (options: any, context: {
+        container: any;
+    }) => Promise<void>;
+}
+export declare const commands: {
+    register(name: string, definition: CommandDefinition): void;
+    has(name: string): boolean;
+    get(name: string): CommandDefinition | undefined;
+    readonly available: string[];
+};
+//# sourceMappingURL=registry.d.ts.map

package/dist/cli/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/cli/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAE5B,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAC3B,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE;QAAE,SAAS,EAAE,GAAG,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACtE;AAID,eAAO,MAAM,QAAQ;mBACJ,MAAM,cAAc,iBAAiB;cAI1C,MAAM,GAAG,OAAO;cAIhB,MAAM,GAAG,iBAAiB,GAAG,SAAS;wBAI/B,MAAM,EAAE;CAG1B,CAAA"}

package/dist/cli/registry.js

@@ -0,0 +1,16 @@
+const registry = new Map();
+export const commands = {
+    register(name, definition) {
+        registry.set(name, definition);
+    },
+    has(name) {
+        return registry.has(name);
+    },
+    get(name) {
+        return registry.get(name);
+    },
+    get available() {
+        return Array.from(registry.keys());
+    },
+};
+//# sourceMappingURL=registry.js.map

package/dist/cli/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/cli/registry.ts"],"names":[],"mappings":"AAUA,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAA;AAErD,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,QAAQ,CAAC,IAAY,EAAE,UAA6B;QAClD,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;IAChC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC3B,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC3B,CAAC;IAED,IAAI,SAAS;QACX,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;IACpC,CAAC;CACF,CAAA"}

package/dist/collection.d.ts

@@ -0,0 +1,145 @@
+import { Document } from "./document";
+import { CollectionQuery } from "./query/collection-query";
+import type { ModelDefinition, CollectionItem, CollectionOptions, InferModelInstance } from "./types";
+export interface FieldInfo {
+    name: string;
+    type: string;
+    required: boolean;
+    defaultValue?: unknown;
+    description?: string;
+}
+export declare function introspectMetaSchema(schema: any): FieldInfo[];
+export declare class Collection {
+    #private;
+    readonly rootPath: string;
+    readonly name: string;
+    readonly extensions: string[];
+    constructor(options: CollectionOptions);
+    /**
+     * Register a model definition with this collection.
+     * Accepts the output of defineModel().
+     */
+    register<TDef extends ModelDefinition<any, any, any, any, any>>(definition: TDef): this;
+    /** Get a model definition by name */
+    getModelDefinition(name: string): ModelDefinition<any, any, any, any, any> | undefined;
+    get modelDefinitions(): ModelDefinition<any, any, any, any, any>[];
+    get loaded(): boolean;
+    get items(): Map<string, CollectionItem>;
+    get documents(): Map<string, Document>;
+    get available(): string[];
+    /**
+     * Match available pathIds against one or more glob patterns.
+     */
+    matchPaths(patterns: string | string[]): string[];
+    /**
+     * Recursively load all markdown files from rootPath.
+     * Parses frontmatter with gray-matter, stores content and metadata.
+     */
+    load(options?: {
+        refresh?: boolean;
+    }): Promise<this>;
+    /**
+     * Get or create a Document for the given pathId.
+     * Documents are cached: calling document("foo") twice returns the same instance.
+     */
+    document(pathId: string): Document;
+    /**
+     * Creates a new Document tied to this collection without it
+     * existing in the items map. Used for in-memory documents
+     * (e.g., extracted from hasMany relationships).
+     */
+    createDocument(attrs: {
+        id: string;
+        content?: string;
+        meta?: Record<string, unknown>;
+        ast?: import("mdast").Root;
+    }): Document;
+    /**
+     * Get a typed model instance for a document.
+     * The definition parameter carries the type information.
+     */
+    getModel<TDef extends ModelDefinition<any, any, any, any, any>>(pathId: string, definition: TDef): InferModelInstance<TDef>;
+    /**
+     * Determine which model definition matches a document,
+     * using match functions or prefix matching.
+     */
+    findModelDefinition(pathId: string): ModelDefinition<any, any, any, any, any> | undefined;
+    /**
+     * Create a typed query for model instances.
+     */
+    query<TDef extends ModelDefinition<any, any, any, any, any>>(definition: TDef): CollectionQuery<TDef>;
+    saveItem(pathId: string, options: {
+        content: string;
+        extension?: string;
+    }): Promise<CollectionItem>;
+    deleteItem(pathId: string): Promise<this>;
+    readItem(pathId: string, extension?: string): Promise<CollectionItem>;
+    action(name: string, fn: (collection: Collection, ...args: any[]) => any): this;
+    get actions(): Map<string, Function>;
+    get availableActions(): string[];
+    runAction(name: string, ...args: any[]): Promise<any>;
+    use(plugin: (collection: Collection, options?: any) => void, options?: any): this;
+    resolve(...args: string[]): string;
+    getPathId(key: string): string;
+    /**
+     * Generate a markdown table of contents with links to each document.
+     * Links use relative paths that work for GitHub navigation.
+     *
+     * If models are registered, items are grouped under model name headings.
+     * Items that don't match any model appear under an "Other" group.
+     *
+     * @example
+     * ```ts
+     * const toc = collection.tableOfContents({ title: "Project Docs" });
+     * // # Project Docs
+     * //
+     * // ## Epics
+     * //
+     * // - [Authentication](./epics/authentication.mdx)
+     * // - [Searching And Browsing](./epics/searching-and-browsing.mdx)
+     * //
+     * // ## Stories
+     * //
+     * // - [A User should be able to register.](./stories/authentication/a-user-should-be-able-to-register.mdx)
+     * ```
+     */
+    tableOfContents(options?: {
+        title?: string;
+        basePath?: string;
+    }): string;
+    /**
+     * Renders an ASCII file tree of all documents in the collection.
+     *
+     * @example
+     * ```
+     * const tree = collection.renderFileTree();
+     * // epics/
+     * //   authentication.mdx
+     * //   searching-and-browsing.mdx
+     * // stories/
+     * //   authentication/
+     * //     a-user-should-be-able-to-register.mdx
+     * ```
+     */
+    renderFileTree(): string;
+    /**
+     * Generate a plain-text summary of the collection and its models.
+     * Returns the same output as `cnotes inspect`.
+     */
+    generateModelSummary(options?: {
+        includeIds?: boolean;
+    }): string;
+    /**
+     * Write README.md to the collection root.
+     * Preserves the `## Overview` section if it already exists.
+     * The generated summary is placed in the `## Summary` section.
+     */
+    saveModelSummary(options?: {
+        includeIds?: boolean;
+    }): Promise<string>;
+    toJSON(options?: {
+        content?: boolean;
+    }): Record<string, unknown>;
+    export(options?: Record<string, unknown>): Promise<Record<string, unknown>>;
+}
+//# sourceMappingURL=collection.d.ts.map

package/dist/collection.d.ts.map

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