contentbase 0.4.0 → 0.4.1

package/dist/relationships/belongs-to.js

@@ -0,0 +1,34 @@
+import { matchPatterns } from "../utils/match-pattern";
+export class BelongsToRelationship {
+    #document;
+    #collection;
+    #definition;
+    #factory;
+    #sourceDef;
+    constructor(document, collection, definition, factory, sourceDef) {
+        this.#document = document;
+        this.#collection = collection;
+        this.#definition = definition;
+        this.#factory = factory;
+        this.#sourceDef = sourceDef;
+    }
+    fetch() {
+        const targetDef = this.#definition.target();
+        // Merge pattern-inferred meta with raw frontmatter, same as createModelInstance does
+        const patternMeta = this.#sourceDef.pattern
+            ? matchPatterns(this.#sourceDef.pattern, this.#document.id) ?? {}
+            : {};
+        const mergedMeta = { ...(this.#sourceDef.defaults ?? {}), ...patternMeta, ...this.#document.meta };
+        const foreignKeyValue = this.#definition.foreignKey({
+            id: this.#document.id,
+            meta: mergedMeta,
+        });
+        const relatedId = `${targetDef.prefix}/${foreignKeyValue}`;
+        if (!this.#collection.items.has(relatedId)) {
+            throw new Error(`Could not find ${targetDef.name} with id "${relatedId}"`);
+        }
+        const doc = this.#collection.document(relatedId);
+        return this.#factory(doc, targetDef, this.#collection);
+    }
+}
+//# sourceMappingURL=belongs-to.js.map

package/dist/relationships/belongs-to.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"belongs-to.js","sourceRoot":"","sources":["../../src/relationships/belongs-to.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAWvD,MAAM,OAAO,qBAAqB;IAIhC,SAAS,CAAW;IACpB,WAAW,CAAa;IACxB,WAAW,CAA+B;IAC1C,QAAQ,CAAuB;IAC/B,UAAU,CAA2C;IAErD,YACE,QAAkB,EAClB,UAAsB,EACtB,UAAwC,EACxC,OAA6B,EAC7B,SAAmD;QAEnD,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED,KAAK;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;QAC5C,qFAAqF;QACrF,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO;YACzC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE;YACjE,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,UAAU,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,WAAW,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACnG,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC;YAClD,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE;YACrB,IAAI,EAAE,UAAU;SACjB,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,GAAG,SAAS,CAAC,MAAM,IAAI,eAAe,EAAE,CAAC;QAE3D,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CACb,kBAAkB,SAAS,CAAC,IAAI,aAAa,SAAS,GAAG,CAC1D,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACzD,CAAC;CACF"}

package/dist/relationships/has-many.d.ts

@@ -0,0 +1,23 @@
+import type { Document } from "../document";
+import type { Collection } from "../collection";
+import type { HasManyDefinition, ModelDefinition, InferModelInstance, HasManyAccessor, ModelInstanceFactory } from "../types";
+export declare class HasManyRelationship<TTarget extends ModelDefinition<any, any, any, any, any>> implements HasManyAccessor<TTarget> {
+    #private;
+    constructor(document: Document, collection: Collection, definition: HasManyDefinition<TTarget>, factory: ModelInstanceFactory);
+    /**
+     * Extract child nodes from the document AST.
+     *
+     * Algorithm (matching the original):
+     * 1. Find the parent heading by text (e.g., "Stories")
+     * 2. Extract the section under that heading
+     * 3. Filter for child headings at depth = parentHeading.depth + 1
+     * 4. For each child heading, extract its sub-section
+     * 5. Compute an ID from the parent title and child slug
+     */
+    private extractChildNodes;
+    fetchAll(): InferModelInstance<TTarget>[];
+    first(): InferModelInstance<TTarget> | undefined;
+    last(): InferModelInstance<TTarget> | undefined;
+    create(): Promise<InferModelInstance<TTarget>[]>;
+}
+//# sourceMappingURL=has-many.d.ts.map

package/dist/relationships/has-many.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"has-many.d.ts","sourceRoot":"","sources":["../../src/relationships/has-many.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAUlB,qBAAa,mBAAmB,CAC9B,OAAO,SAAS,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CACxD,YAAW,eAAe,CAAC,OAAO,CAAC;;gBAQjC,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,iBAAiB,CAAC,OAAO,CAAC,EACtC,OAAO,EAAE,oBAAoB;IAQ/B;;;;;;;;;OASG;IACH,OAAO,CAAC,iBAAiB;IAkDzB,QAAQ,IAAI,kBAAkB,CAAC,OAAO,CAAC,EAAE;IAmEzC,KAAK,IAAI,kBAAkB,CAAC,OAAO,CAAC,GAAG,SAAS;IAIhD,IAAI,IAAI,kBAAkB,CAAC,OAAO,CAAC,GAAG,SAAS;IAKzC,MAAM,IAAI,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;CAKvD"}

package/dist/relationships/has-many.js

@@ -0,0 +1,136 @@
+import { toString } from "mdast-util-to-string";
+import { kebabCase } from "../utils/inflect";
+import { matchPatterns } from "../utils/match-pattern";
+export class HasManyRelationship {
+    #document;
+    #collection;
+    #definition;
+    #factory;
+    constructor(document, collection, definition, factory) {
+        this.#document = document;
+        this.#collection = collection;
+        this.#definition = definition;
+        this.#factory = factory;
+    }
+    /**
+     * Extract child nodes from the document AST.
+     *
+     * Algorithm (matching the original):
+     * 1. Find the parent heading by text (e.g., "Stories")
+     * 2. Extract the section under that heading
+     * 3. Filter for child headings at depth = parentHeading.depth + 1
+     * 4. For each child heading, extract its sub-section
+     * 5. Compute an ID from the parent title and child slug
+     */
+    extractChildNodes() {
+        const { astQuery } = this.#document;
+        if (!this.#definition.heading)
+            return [];
+        const parentHeading = astQuery.findHeadingByText(this.#definition.heading);
+        if (!parentHeading)
+            return [];
+        const sectionNodes = this.#document
+            .extractSection(parentHeading)
+            .slice(1);
+        const childDepth = parentHeading.depth + 1;
+        // Get all child headings at the expected depth
+        const childHeadings = sectionNodes.filter((n) => n.type === "heading" && n.depth === childDepth);
+        return childHeadings.map((heading) => {
+            // For each child heading, find its sub-section
+            // (from this heading to the next heading at the same depth, or end of parent section)
+            const headingIdx = sectionNodes.indexOf(heading);
+            const nextIdx = sectionNodes.findIndex((n, i) => i > headingIdx && n.type === "heading" && n.depth === childDepth);
+            const section = nextIdx === -1
+                ? sectionNodes.slice(headingIdx)
+                : sectionNodes.slice(headingIdx, nextIdx);
+            const title = toString(heading);
+            const slug = kebabCase(title.toLowerCase());
+            const targetDef = this.#definition.target();
+            const id = this.#definition.id
+                ? this.#definition.id(slug)
+                : `${targetDef.prefix}/${kebabCase(this.#document.title.toLowerCase())}/${slug}`;
+            return {
+                title,
+                id,
+                section,
+                ast: {
+                    type: "root",
+                    children: section,
+                },
+            };
+        });
+    }
+    fetchAll() {
+        const targetDef = this.#definition.target();
+        // Foreign key mode: query for target documents where meta[foreignKey] matches this document's slug
+        // Used when foreignKey is explicitly set, or when no heading is specified (convention-based)
+        if (this.#definition.foreignKey || !this.#definition.heading) {
+            return this.#fetchByForeignKey(targetDef);
+        }
+        // Heading mode: extract child nodes from parent document AST
+        const childNodes = this.extractChildNodes();
+        return childNodes.map(({ id, ast }) => {
+            // If the document already exists in the collection, use it
+            if (this.#collection.items.has(id)) {
+                const doc = this.#collection.document(id);
+                return this.#factory(doc, targetDef, this.#collection);
+            }
+            // Otherwise create an in-memory document from the extracted AST
+            const doc = this.#collection.createDocument({
+                id,
+                meta: this.#definition.meta ? this.#definition.meta({}) : {},
+                ast: ast,
+            });
+            return this.#factory(doc, targetDef, this.#collection);
+        });
+    }
+    #fetchByForeignKey(targetDef) {
+        // If foreignKey is explicitly set, use it. Otherwise infer from the parent document's model.
+        // Convention: look for meta[lowercase(parentModelName)] on target documents.
+        // e.g. Project hasMany Plans → looks for meta.project on Plan documents.
+        const fk = this.#definition.foreignKey || this.#inferForeignKey();
+        const slug = this.#document.slug;
+        const parentPrefix = this.#document.id.split("/")[0];
+        const idSegment = this.#document.id.slice(parentPrefix.length + 1);
+        const prefix = targetDef.prefix;
+        const results = [];
+        for (const pathId of this.#collection.available) {
+            if (!pathId.startsWith(prefix + "/"))
+                continue;
+            const doc = this.#collection.document(pathId);
+            // Check raw frontmatter first, then fall back to pattern-inferred meta
+            let fkValue = doc.meta[fk];
+            if (fkValue === undefined && targetDef.pattern) {
+                const patternMeta = matchPatterns(targetDef.pattern, pathId);
+                if (patternMeta)
+                    fkValue = patternMeta[fk];
+            }
+            if (fkValue === slug || fkValue === idSegment) {
+                results.push(this.#factory(doc, targetDef, this.#collection));
+            }
+        }
+        return results;
+    }
+    /**
+     * Infer the foreign key name from the parent document's prefix.
+     * e.g. if the parent is in "projects/", the FK is "project" (singularized, lowercased).
+     */
+    #inferForeignKey() {
+        const parentPrefix = this.#document.id.split("/")[0];
+        // Simple singularize: strip trailing "s"
+        return parentPrefix.replace(/s$/, "");
+    }
+    first() {
+        return this.fetchAll()[0];
+    }
+    last() {
+        const all = this.fetchAll();
+        return all[all.length - 1];
+    }
+    async create() {
+        const models = this.fetchAll();
+        await Promise.all(models.map((m) => m.save()));
+        return models;
+    }
+}
+//# sourceMappingURL=has-many.js.map

package/dist/relationships/has-many.js.map

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

package/dist/relationships/index.d.ts

@@ -0,0 +1,26 @@
+import type { HasManyDefinition, BelongsToDefinition, ModelDefinition, DocumentRef } from "../types";
+/**
+ * Declare a hasMany relationship.
+ *
+ * Two modes:
+ * - `heading`: Children are extracted from sub-headings under a parent heading in the document.
+ * - `foreignKey`: Children are found by querying target documents where meta[foreignKey] matches this document's slug.
+ *
+ * The target parameter is a thunk (() => ModelDef) to allow circular references.
+ */
+export declare function hasMany<TTarget extends ModelDefinition<any, any, any, any, any>>(target: () => TTarget, options: {
+    heading?: string;
+    foreignKey?: string;
+    meta?: (self: any) => Record<string, unknown>;
+    id?: (slug: string) => string;
+}): HasManyDefinition<TTarget>;
+/**
+ * Declare a belongsTo relationship.
+ * The foreign key function receives a DocumentRef (with id and meta)
+ * and returns the id fragment of the parent.
+ */
+export declare function belongsTo<TTarget extends ModelDefinition<any, any, any, any, any>>(target: () => TTarget, options: {
+    foreignKey: (doc: DocumentRef) => string;
+}): BelongsToDefinition<TTarget>;
+export type { HasManyDefinition, BelongsToDefinition, RelationshipDefinition, } from "../types";
+//# sourceMappingURL=index.d.ts.map

package/dist/relationships/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/relationships/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,WAAW,EACZ,MAAM,UAAU,CAAC;AAElB;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CACrB,OAAO,SAAS,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAExD,MAAM,EAAE,MAAM,OAAO,EACrB,OAAO,EAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAC/B,GACA,iBAAiB,CAAC,OAAO,CAAC,CAS5B;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,OAAO,SAAS,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAExD,MAAM,EAAE,MAAM,OAAO,EACrB,OAAO,EAAE;IACP,UAAU,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,MAAM,CAAC;CAC1C,GACA,mBAAmB,CAAC,OAAO,CAAC,CAM9B;AAED,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,UAAU,CAAC"}

package/dist/relationships/index.js

@@ -0,0 +1,32 @@
+/**
+ * Declare a hasMany relationship.
+ *
+ * Two modes:
+ * - `heading`: Children are extracted from sub-headings under a parent heading in the document.
+ * - `foreignKey`: Children are found by querying target documents where meta[foreignKey] matches this document's slug.
+ *
+ * The target parameter is a thunk (() => ModelDef) to allow circular references.
+ */
+export function hasMany(target, options) {
+    return {
+        type: "hasMany",
+        target,
+        heading: options.heading,
+        foreignKey: options.foreignKey,
+        meta: options.meta,
+        id: options.id,
+    };
+}
+/**
+ * Declare a belongsTo relationship.
+ * The foreign key function receives a DocumentRef (with id and meta)
+ * and returns the id fragment of the parent.
+ */
+export function belongsTo(target, options) {
+    return {
+        type: "belongsTo",
+        target,
+        foreignKey: options.foreignKey,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/relationships/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/relationships/index.ts"],"names":[],"mappings":"AAOA;;;;;;;;GAQG;AACH,MAAM,UAAU,OAAO,CAGrB,MAAqB,EACrB,OAKC;IAED,OAAO;QACL,IAAI,EAAE,SAAS;QACf,MAAM;QACN,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,EAAE,EAAE,OAAO,CAAC,EAAE;KACf,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAGvB,MAAqB,EACrB,OAEC;IAED,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,MAAM;QACN,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC;AACJ,CAAC"}

package/dist/relationships/types.d.ts

@@ -0,0 +1,2 @@
+export type { HasManyDefinition, BelongsToDefinition, RelationshipDefinition, HasManyAccessor, BelongsToAccessor, } from "../types";
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/relationships/types.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EACf,iBAAiB,GAClB,MAAM,UAAU,CAAC"}

package/dist/relationships/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/relationships/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/relationships/types.ts"],"names":[],"mappings":""}

package/dist/search/document-inputs.d.ts

@@ -0,0 +1,30 @@
+export interface SearchDocumentSection {
+    heading: string;
+    headingPath: string;
+    content: string;
+    level: number;
+}
+export interface SearchDocumentInput {
+    pathId: string;
+    model?: string;
+    title?: string;
+    slug?: string;
+    meta?: Record<string, unknown>;
+    content: string;
+    sections?: SearchDocumentSection[];
+}
+export interface SearchCollectionLike {
+    available: string[];
+    document(pathId: string): {
+        title?: string;
+        slug?: string;
+        meta?: Record<string, unknown>;
+        content: string;
+    };
+    findModelDefinition?(pathId: string): {
+        name?: string;
+    } | undefined;
+}
+export declare function collectDocumentInputs(collection: SearchCollectionLike): SearchDocumentInput[];
+export declare function collectH2Sections(content: string): SearchDocumentSection[];
+//# sourceMappingURL=document-inputs.d.ts.map

package/dist/search/document-inputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-inputs.d.ts","sourceRoot":"","sources":["../../src/search/document-inputs.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,qBAAqB,EAAE,CAAA;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG;QACxB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC9B,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;IACD,mBAAmB,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;CACpE;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,oBAAoB,GAAG,mBAAmB,EAAE,CAoB7F;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,EAAE,CAkC1E"}

package/dist/search/document-inputs.js

@@ -0,0 +1,52 @@
+export function collectDocumentInputs(collection) {
+    const inputs = [];
+    for (const pathId of collection.available) {
+        const doc = collection.document(pathId);
+        const modelDef = collection.findModelDefinition?.(pathId);
+        const sections = collectH2Sections(doc.content);
+        inputs.push({
+            pathId,
+            model: modelDef?.name ?? undefined,
+            title: doc.title,
+            slug: doc.slug,
+            meta: doc.meta,
+            content: doc.content,
+            sections: sections.length > 0 ? sections : undefined,
+        });
+    }
+    return inputs;
+}
+export function collectH2Sections(content) {
+    const sections = [];
+    const lines = content.split('\n');
+    let currentHeading = null;
+    let currentContent = [];
+    for (const line of lines) {
+        const h2Match = line.match(/^## (.+)/);
+        if (h2Match) {
+            if (currentHeading) {
+                sections.push({
+                    heading: currentHeading,
+                    headingPath: currentHeading,
+                    content: currentContent.join('\n').trim(),
+                    level: 2,
+                });
+            }
+            currentHeading = h2Match[1].trim();
+            currentContent = [];
+        }
+        else if (currentHeading) {
+            currentContent.push(line);
+        }
+    }
+    if (currentHeading) {
+        sections.push({
+            heading: currentHeading,
+            headingPath: currentHeading,
+            content: currentContent.join('\n').trim(),
+            level: 2,
+        });
+    }
+    return sections;
+}
+//# sourceMappingURL=document-inputs.js.map

package/dist/search/document-inputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-inputs.js","sourceRoot":"","sources":["../../src/search/document-inputs.ts"],"names":[],"mappings":"AA4BA,MAAM,UAAU,qBAAqB,CAAC,UAAgC;IACpE,MAAM,MAAM,GAA0B,EAAE,CAAA;IAExC,KAAK,MAAM,MAAM,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;QACvC,MAAM,QAAQ,GAAG,UAAU,CAAC,mBAAmB,EAAE,CAAC,MAAM,CAAC,CAAA;QACzD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QAE/C,MAAM,CAAC,IAAI,CAAC;YACV,MAAM;YACN,KAAK,EAAE,QAAQ,EAAE,IAAI,IAAI,SAAS;YAClC,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;SACrD,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,MAAM,QAAQ,GAA4B,EAAE,CAAA;IAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACjC,IAAI,cAAc,GAAkB,IAAI,CAAA;IACxC,IAAI,cAAc,GAAa,EAAE,CAAA;IAEjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;QACtC,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,cAAc,EAAE,CAAC;gBACnB,QAAQ,CAAC,IAAI,CAAC;oBACZ,OAAO,EAAE,cAAc;oBACvB,WAAW,EAAE,cAAc;oBAC3B,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;oBACzC,KAAK,EAAE,CAAC;iBACT,CAAC,CAAA;YACJ,CAAC;YACD,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;YAClC,cAAc,GAAG,EAAE,CAAA;QACrB,CAAC;aAAM,IAAI,cAAc,EAAE,CAAC;YAC1B,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC3B,CAAC;IACH,CAAC;IAED,IAAI,cAAc,EAAE,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC;YACZ,OAAO,EAAE,cAAc;YACvB,WAAW,EAAE,cAAc;YAC3B,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;YACzC,KAAK,EAAE,CAAC;SACT,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/search/luca-semantic-search.d.ts

@@ -0,0 +1,27 @@
+export type EmbeddingProvider = 'local' | 'openai';
+export type ChunkStrategy = 'section' | 'fixed' | 'document';
+export interface SemanticSearchConfig {
+    dbPath: string;
+    embeddingProvider: EmbeddingProvider;
+    embeddingModel: string;
+    chunkStrategy: ChunkStrategy;
+    chunkSize: number;
+    chunkOverlap: number;
+}
+export interface SemanticSearchOptions extends Partial<SemanticSearchConfig> {
+}
+export declare const DEFAULT_SEMANTIC_SEARCH_OPTIONS: {
+    embeddingProvider: EmbeddingProvider;
+    embeddingModel: string;
+    chunkStrategy: ChunkStrategy;
+    chunkSize: number;
+    chunkOverlap: number;
+};
+export declare function getSearchDbPath(rootPath: string): string;
+export declare function hasSearchIndex(rootPath: string): boolean;
+export declare function buildSemanticSearchConfig(rootPath: string, options?: SemanticSearchOptions): SemanticSearchConfig;
+export declare function loadSemanticSearchClass(): Promise<any>;
+export declare function ensureSemanticSearchAttached(container: any, SemanticSearchClass?: any): Promise<any>;
+export declare function createSemanticSearch(container: any, rootPath: string, options?: SemanticSearchOptions): Promise<any>;
+export declare function getInitializedSemanticSearch(container: any, rootPath: string, options?: SemanticSearchOptions): Promise<any>;
+//# sourceMappingURL=luca-semantic-search.d.ts.map

package/dist/search/luca-semantic-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"luca-semantic-search.d.ts","sourceRoot":"","sources":["../../src/search/luca-semantic-search.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,QAAQ,CAAA;AAClD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAA;AAE5D,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,iBAAiB,EAAE,iBAAiB,CAAA;IACpC,cAAc,EAAE,MAAM,CAAA;IACtB,aAAa,EAAE,aAAa,CAAA;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,qBAAsB,SAAQ,OAAO,CAAC,oBAAoB,CAAC;CAAG;AAE/E,eAAO,MAAM,+BAA+B;uBACX,iBAAiB;;mBAEpB,aAAa;;;CAG1C,CAAA;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAUxD;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,oBAAoB,CASrH;AAED,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,GAAG,CAAC,CAG5D;AAED,wBAAsB,4BAA4B,CAAC,SAAS,EAAE,GAAG,EAAE,mBAAmB,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAM1G;AAED,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,GAAG,CAAC,CAG9H;AAED,wBAAsB,4BAA4B,CAAC,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,GAAG,CAAC,CAItI"}

package/dist/search/luca-semantic-search.js

@@ -0,0 +1,56 @@
+import { existsSync, readdirSync } from 'node:fs';
+import path from 'node:path';
+export const DEFAULT_SEMANTIC_SEARCH_OPTIONS = {
+    embeddingProvider: 'openai',
+    embeddingModel: 'text-embedding-3-small',
+    chunkStrategy: 'section',
+    chunkSize: 900,
+    chunkOverlap: 0.15,
+};
+export function getSearchDbPath(rootPath) {
+    return path.join(rootPath, '.contentbase/search.sqlite');
+}
+export function hasSearchIndex(rootPath) {
+    const dbDir = path.join(rootPath, '.contentbase');
+    if (!existsSync(dbDir))
+        return false;
+    try {
+        const files = readdirSync(dbDir);
+        return files.some((file) => file.startsWith('search.') && file.endsWith('.sqlite'));
+    }
+    catch {
+        return false;
+    }
+}
+export function buildSemanticSearchConfig(rootPath, options = {}) {
+    return {
+        dbPath: options.dbPath ?? getSearchDbPath(rootPath),
+        embeddingProvider: options.embeddingProvider ?? DEFAULT_SEMANTIC_SEARCH_OPTIONS.embeddingProvider,
+        embeddingModel: options.embeddingModel ?? DEFAULT_SEMANTIC_SEARCH_OPTIONS.embeddingModel,
+        chunkStrategy: options.chunkStrategy ?? DEFAULT_SEMANTIC_SEARCH_OPTIONS.chunkStrategy,
+        chunkSize: options.chunkSize ?? DEFAULT_SEMANTIC_SEARCH_OPTIONS.chunkSize,
+        chunkOverlap: options.chunkOverlap ?? DEFAULT_SEMANTIC_SEARCH_OPTIONS.chunkOverlap,
+    };
+}
+export async function loadSemanticSearchClass() {
+    const { SemanticSearch } = await import('luca/agi');
+    return SemanticSearch;
+}
+export async function ensureSemanticSearchAttached(container, SemanticSearchClass) {
+    const SemanticSearch = SemanticSearchClass ?? await loadSemanticSearchClass();
+    if (!container.features.available.includes('semanticSearch')) {
+        ;
+        SemanticSearch.attach(container);
+    }
+    return SemanticSearch;
+}
+export async function createSemanticSearch(container, rootPath, options = {}) {
+    await ensureSemanticSearchAttached(container);
+    return container.feature('semanticSearch', buildSemanticSearchConfig(rootPath, options));
+}
+export async function getInitializedSemanticSearch(container, rootPath, options = {}) {
+    const semanticSearch = await createSemanticSearch(container, rootPath, options);
+    await semanticSearch.initDb();
+    return semanticSearch;
+}
+//# sourceMappingURL=luca-semantic-search.js.map

package/dist/search/luca-semantic-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"luca-semantic-search.js","sourceRoot":"","sources":["../../src/search/luca-semantic-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACjD,OAAO,IAAI,MAAM,WAAW,CAAA;AAgB5B,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC7C,iBAAiB,EAAE,QAA6B;IAChD,cAAc,EAAE,wBAAwB;IACxC,aAAa,EAAE,SAA0B;IACzC,SAAS,EAAE,GAAG;IACd,YAAY,EAAE,IAAI;CACnB,CAAA;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,4BAA4B,CAAC,CAAA;AAC1D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAA;IACjD,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAEpC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAa,CAAA;QAC5C,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAA;IACrF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,QAAgB,EAAE,UAAiC,EAAE;IAC7F,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,eAAe,CAAC,QAAQ,CAAC;QACnD,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,IAAI,+BAA+B,CAAC,iBAAiB;QACjG,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,+BAA+B,CAAC,cAAc;QACxF,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,+BAA+B,CAAC,aAAa;QACrF,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,+BAA+B,CAAC,SAAS;QACzE,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,+BAA+B,CAAC,YAAY;KACnF,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB;IAC3C,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAA;IACnD,OAAO,cAAc,CAAA;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,SAAc,EAAE,mBAAyB;IAC1F,MAAM,cAAc,GAAG,mBAAmB,IAAI,MAAM,uBAAuB,EAAE,CAAA;IAC7E,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC7D,CAAC;QAAC,cAAsB,CAAC,MAAM,CAAC,SAAgB,CAAC,CAAA;IACnD,CAAC;IACD,OAAO,cAAc,CAAA;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,SAAc,EAAE,QAAgB,EAAE,UAAiC,EAAE;IAC9G,MAAM,4BAA4B,CAAC,SAAS,CAAC,CAAA;IAC7C,OAAO,SAAS,CAAC,OAAO,CAAC,gBAAgB,EAAE,yBAAyB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAA;AAC1F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,SAAc,EAAE,QAAgB,EAAE,UAAiC,EAAE;IACtH,MAAM,cAAc,GAAG,MAAM,oBAAoB,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC/E,MAAM,cAAc,CAAC,MAAM,EAAE,CAAA;IAC7B,OAAO,cAAc,CAAA;AACvB,CAAC"}

package/dist/section.d.ts

@@ -0,0 +1,21 @@
+import type { z } from "zod";
+import type { AstQuery } from "./ast-query";
+import type { SectionDefinition } from "./types";
+/**
+ * Helper function to create a SectionDefinition with proper type inference.
+ * The generic T is inferred from the extract function's return type.
+ *
+ * Without this helper, TypeScript would widen the return type of extract to `unknown`.
+ *
+ * Usage:
+ *   section("Acceptance Criteria", {
+ *     extract: (query) => query.selectAll("listItem").map(toString),
+ *     schema: z.array(z.string()).min(1),
+ *   })
+ */
+export declare function section<T>(heading: string, options: {
+    extract: (query: AstQuery) => T;
+    schema?: z.ZodType<T>;
+    alternatives?: string[];
+}): SectionDefinition<T>;
+//# sourceMappingURL=section.d.ts.map

package/dist/section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section.d.ts","sourceRoot":"","sources":["../src/section.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;IACP,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,GACA,iBAAiB,CAAC,CAAC,CAAC,CAOtB"}

package/dist/section.js

@@ -0,0 +1,21 @@
+/**
+ * Helper function to create a SectionDefinition with proper type inference.
+ * The generic T is inferred from the extract function's return type.
+ *
+ * Without this helper, TypeScript would widen the return type of extract to `unknown`.
+ *
+ * Usage:
+ *   section("Acceptance Criteria", {
+ *     extract: (query) => query.selectAll("listItem").map(toString),
+ *     schema: z.array(z.string()).min(1),
+ *   })
+ */
+export function section(heading, options) {
+    return {
+        heading,
+        alternatives: options.alternatives,
+        extract: options.extract,
+        schema: options.schema,
+    };
+}
+//# sourceMappingURL=section.js.map

package/dist/section.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"section.js","sourceRoot":"","sources":["../src/section.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,OAAO,CACrB,OAAe,EACf,OAIC;IAED,OAAO;QACL,OAAO;QACP,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC;AACJ,CAAC"}