@prodisco/search-libs 0.1.0

package/dist/search/query-builder.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Fluent query builder for search options
+ */
+import type { SearchOptions } from './search-engine.js';
+/**
+ * Fluent builder for constructing search queries
+ */
+export declare class QueryBuilder {
+    private options;
+    /**
+     * Set the search query term
+     */
+    query(term: string): this;
+    /**
+     * Filter by document type
+     */
+    documentType(type: 'type' | 'method' | 'function' | 'script' | 'all'): this;
+    /**
+     * Filter by category
+     */
+    category(cat: string): this;
+    /**
+     * Filter by library
+     */
+    library(lib: string): this;
+    /**
+     * Exclude categories
+     */
+    excludeCategories(categories: string[]): this;
+    /**
+     * Exclude libraries
+     */
+    excludeLibraries(libraries: string[]): this;
+    /**
+     * Set maximum results
+     */
+    limit(n: number): this;
+    /**
+     * Set pagination offset
+     */
+    offset(n: number): this;
+    /**
+     * Set pagination by page number (1-indexed)
+     */
+    page(pageNum: number, pageSize?: number): this;
+    /**
+     * Set field boost weights
+     */
+    boost(weights: Record<string, number>): this;
+    /**
+     * Build the final search options
+     */
+    build(): SearchOptions;
+    /**
+     * Create a new QueryBuilder
+     */
+    static create(): QueryBuilder;
+}
+//# sourceMappingURL=query-builder.d.ts.map

package/dist/search/query-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder.d.ts","sourceRoot":"","sources":["../../src/search/query-builder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAIb;IAEF;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKzB;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,KAAK,GAAG,IAAI;IAK3E;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK3B;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK1B;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI;IAQ7C;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAQ3C;;OAEG;IACH,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKtB;;OAEG;IACH,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKvB;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAW,GAAG,IAAI;IAMlD;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAK5C;;OAEG;IACH,KAAK,IAAI,aAAa;IAItB;;OAEG;IACH,MAAM,CAAC,MAAM,IAAI,YAAY;CAG9B"}

package/dist/search/query-builder.js

@@ -0,0 +1,103 @@
+/**
+ * Fluent query builder for search options
+ */
+/**
+ * Fluent builder for constructing search queries
+ */
+export class QueryBuilder {
+    options = {
+        query: '',
+        limit: 10,
+        offset: 0,
+    };
+    /**
+     * Set the search query term
+     */
+    query(term) {
+        this.options.query = term;
+        return this;
+    }
+    /**
+     * Filter by document type
+     */
+    documentType(type) {
+        this.options.documentType = type;
+        return this;
+    }
+    /**
+     * Filter by category
+     */
+    category(cat) {
+        this.options.category = cat;
+        return this;
+    }
+    /**
+     * Filter by library
+     */
+    library(lib) {
+        this.options.library = lib;
+        return this;
+    }
+    /**
+     * Exclude categories
+     */
+    excludeCategories(categories) {
+        this.options.exclude = {
+            ...this.options.exclude,
+            categories,
+        };
+        return this;
+    }
+    /**
+     * Exclude libraries
+     */
+    excludeLibraries(libraries) {
+        this.options.exclude = {
+            ...this.options.exclude,
+            libraries,
+        };
+        return this;
+    }
+    /**
+     * Set maximum results
+     */
+    limit(n) {
+        this.options.limit = n;
+        return this;
+    }
+    /**
+     * Set pagination offset
+     */
+    offset(n) {
+        this.options.offset = n;
+        return this;
+    }
+    /**
+     * Set pagination by page number (1-indexed)
+     */
+    page(pageNum, pageSize = 10) {
+        this.options.limit = pageSize;
+        this.options.offset = (pageNum - 1) * pageSize;
+        return this;
+    }
+    /**
+     * Set field boost weights
+     */
+    boost(weights) {
+        this.options.boost = weights;
+        return this;
+    }
+    /**
+     * Build the final search options
+     */
+    build() {
+        return { ...this.options };
+    }
+    /**
+     * Create a new QueryBuilder
+     */
+    static create() {
+        return new QueryBuilder();
+    }
+}
+//# sourceMappingURL=query-builder.js.map

package/dist/search/query-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder.js","sourceRoot":"","sources":["../../src/search/query-builder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,OAAO,YAAY;IACf,OAAO,GAAkB;QAC/B,KAAK,EAAE,EAAE;QACT,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,CAAC;KACV,CAAC;IAEF;;OAEG;IACH,KAAK,CAAC,IAAY;QAChB,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,IAAuD;QAClE,IAAI,CAAC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,GAAW;QAClB,IAAI,CAAC,OAAO,CAAC,QAAQ,GAAG,GAAG,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,GAAW;QACjB,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,GAAG,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,UAAoB;QACpC,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG;YACrB,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO;YACvB,UAAU;SACX,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,SAAmB;QAClC,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG;YACrB,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO;YACvB,SAAS;SACV,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,CAAS;QACb,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,CAAS;QACd,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAe,EAAE,WAAmB,EAAE;QACzC,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC;QAC9B,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAA+B;QACnC,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK;QACH,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,YAAY,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/dist/search/result-formatter.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Format search results for AI consumption
+ */
+import type { BaseDocument } from '../schema/base-schema.js';
+import type { SearchResult } from './search-engine.js';
+import type { PropertyInfo, ParameterInfo } from '../extractor/types.js';
+/**
+ * Formatted result item for display/AI consumption
+ */
+export interface FormattedItem {
+    id: string;
+    type: 'type' | 'method' | 'function' | 'script';
+    name: string;
+    library: string;
+    category: string;
+    description: string;
+    typeKind?: string;
+    properties?: PropertyInfo[];
+    nestedTypes?: string[];
+    typeDefinition?: string;
+    parameters?: ParameterInfo[];
+    returnType?: string;
+    returnTypeDefinition?: string;
+    signature?: string;
+    className?: string;
+    filePath?: string;
+    keywords?: string[];
+}
+/**
+ * Formatted search result
+ */
+export interface FormattedResult {
+    summary: string;
+    items: FormattedItem[];
+    totalMatches: number;
+    facets: Record<string, Record<string, number>>;
+    pagination: {
+        offset: number;
+        limit: number;
+        hasMore: boolean;
+    };
+    searchTime: number;
+}
+/**
+ * Options for formatting results
+ */
+export interface FormatOptions {
+    /** Maximum properties to include for types */
+    maxProperties?: number;
+    /** Include file paths for scripts */
+    includeFilePaths?: boolean;
+}
+/**
+ * Format search results for structured output
+ */
+export declare function formatResults(searchResult: SearchResult<BaseDocument>, options?: FormatOptions): FormattedResult;
+/**
+ * Format results as a string for AI consumption
+ */
+export declare function formatForAI(searchResult: SearchResult<BaseDocument>, options?: FormatOptions): string;
+//# sourceMappingURL=result-formatter.d.ts.map

package/dist/search/result-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-formatter.d.ts","sourceRoot":"","sources":["../../src/search/result-formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IAGpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,UAAU,EAAE;QACV,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,qCAAqC;IACrC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,YAAY,CAAC,YAAY,CAAC,EACxC,OAAO,GAAE,aAAkB,GAC1B,eAAe,CA+BjB;AA6HD;;GAEG;AACH,wBAAgB,WAAW,CACzB,YAAY,EAAE,YAAY,CAAC,YAAY,CAAC,EACxC,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAyCR"}

package/dist/search/result-formatter.js

@@ -0,0 +1,170 @@
+/**
+ * Format search results for AI consumption
+ */
+/**
+ * Format search results for structured output
+ */
+export function formatResults(searchResult, options = {}) {
+    const { maxProperties = 10, includeFilePaths = false } = options;
+    const items = searchResult.results.map((doc) => formatDocument(doc, { maxProperties, includeFilePaths }));
+    const resultCount = searchResult.results.length;
+    const total = searchResult.totalMatches;
+    let summary;
+    if (resultCount === 0) {
+        summary = 'No results found.';
+    }
+    else if (resultCount === total) {
+        summary = `Found ${total} result${total === 1 ? '' : 's'}.`;
+    }
+    else {
+        summary = `Showing ${resultCount} of ${total} results.`;
+    }
+    return {
+        summary,
+        items,
+        totalMatches: searchResult.totalMatches,
+        facets: searchResult.facets,
+        pagination: {
+            offset: 0, // Would need to track this from search options
+            limit: resultCount,
+            hasMore: resultCount < total,
+        },
+        searchTime: searchResult.searchTime,
+    };
+}
+/**
+ * Format a single document
+ */
+function formatDocument(doc, options) {
+    const base = {
+        id: doc.id,
+        type: doc.documentType,
+        name: doc.name,
+        library: doc.library,
+        category: doc.category,
+        description: doc.description,
+    };
+    switch (doc.documentType) {
+        case 'type':
+            return formatTypeDocument(doc, base, options);
+        case 'method':
+            return formatMethodDocument(doc, base);
+        case 'function':
+            return formatFunctionDocument(doc, base);
+        case 'script':
+            return formatScriptDocument(doc, base, options);
+        default:
+            return base;
+    }
+}
+/**
+ * Format a type document
+ */
+function formatTypeDocument(doc, base, options) {
+    let properties = [];
+    try {
+        properties = doc.properties ? JSON.parse(doc.properties) : [];
+    }
+    catch {
+        // Ignore parse errors
+    }
+    const nestedTypes = doc.nestedTypes
+        ? doc.nestedTypes.split(',').map((t) => t.trim()).filter(Boolean)
+        : [];
+    return {
+        ...base,
+        typeKind: doc.typeKind,
+        properties: properties.slice(0, options.maxProperties || 10),
+        nestedTypes,
+        typeDefinition: doc.typeDefinition || undefined,
+    };
+}
+/**
+ * Format a method document
+ */
+function formatMethodDocument(doc, base) {
+    let parameters = [];
+    try {
+        parameters = doc.parameters ? JSON.parse(doc.parameters) : [];
+    }
+    catch {
+        // Ignore parse errors
+    }
+    return {
+        ...base,
+        parameters,
+        returnType: doc.returnType || undefined,
+        returnTypeDefinition: doc.returnTypeDefinition || undefined,
+        signature: doc.signature || undefined,
+        className: doc.className || undefined,
+    };
+}
+/**
+ * Format a function document
+ */
+function formatFunctionDocument(doc, base) {
+    let parameters = [];
+    try {
+        parameters = doc.parameters ? JSON.parse(doc.parameters) : [];
+    }
+    catch {
+        // Ignore parse errors
+    }
+    return {
+        ...base,
+        parameters,
+        returnType: doc.returnType || undefined,
+        signature: doc.signature || undefined,
+    };
+}
+/**
+ * Format a script document
+ */
+function formatScriptDocument(doc, base, options) {
+    const keywords = doc.keywords
+        ? doc.keywords.split(' ').filter(Boolean)
+        : [];
+    return {
+        ...base,
+        filePath: options.includeFilePaths ? doc.filePath : undefined,
+        keywords: keywords.length > 0 ? keywords : undefined,
+    };
+}
+/**
+ * Format results as a string for AI consumption
+ */
+export function formatForAI(searchResult, options = {}) {
+    const formatted = formatResults(searchResult, options);
+    const lines = [formatted.summary, ''];
+    for (const item of formatted.items) {
+        lines.push(`## ${item.name} (${item.type})`);
+        lines.push(`Library: ${item.library}`);
+        lines.push(`Category: ${item.category}`);
+        lines.push(`Description: ${item.description}`);
+        if (item.signature) {
+            lines.push(`Signature: ${item.signature}`);
+        }
+        if (item.parameters && item.parameters.length > 0) {
+            lines.push('Parameters:');
+            for (const param of item.parameters) {
+                const opt = param.optional ? '?' : '';
+                const typeDef = param.typeDefinition ? ` = ${param.typeDefinition}` : '';
+                lines.push(`  - ${param.name}${opt}: ${param.type}${typeDef}`);
+            }
+        }
+        if (item.returnType) {
+            const returnDef = item.returnTypeDefinition ? ` = ${item.returnTypeDefinition}` : '';
+            lines.push(`Returns: ${item.returnType}${returnDef}`);
+        }
+        if (item.properties && item.properties.length > 0) {
+            lines.push('Properties:');
+            for (const prop of item.properties) {
+                const opt = prop.optional ? '?' : '';
+                lines.push(`  - ${prop.name}${opt}: ${prop.type}`);
+            }
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=result-formatter.js.map

package/dist/search/result-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-formatter.js","sourceRoot":"","sources":["../../src/search/result-formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AA8DH;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,YAAwC,EACxC,UAAyB,EAAE;IAE3B,MAAM,EAAE,aAAa,GAAG,EAAE,EAAE,gBAAgB,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAEjE,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAC7C,cAAc,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,gBAAgB,EAAE,CAAC,CACzD,CAAC;IAEF,MAAM,WAAW,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC;IAChD,MAAM,KAAK,GAAG,YAAY,CAAC,YAAY,CAAC;IAExC,IAAI,OAAe,CAAC;IACpB,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,GAAG,mBAAmB,CAAC;IAChC,CAAC;SAAM,IAAI,WAAW,KAAK,KAAK,EAAE,CAAC;QACjC,OAAO,GAAG,SAAS,KAAK,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;IAC9D,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,WAAW,WAAW,OAAO,KAAK,WAAW,CAAC;IAC1D,CAAC;IAED,OAAO;QACL,OAAO;QACP,KAAK;QACL,YAAY,EAAE,YAAY,CAAC,YAAY;QACvC,MAAM,EAAE,YAAY,CAAC,MAAM;QAC3B,UAAU,EAAE;YACV,MAAM,EAAE,CAAC,EAAE,+CAA+C;YAC1D,KAAK,EAAE,WAAW;YAClB,OAAO,EAAE,WAAW,GAAG,KAAK;SAC7B;QACD,UAAU,EAAE,YAAY,CAAC,UAAU;KACpC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CACrB,GAAiB,EACjB,OAAsB;IAEtB,MAAM,IAAI,GAAkB;QAC1B,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,IAAI,EAAE,GAAG,CAAC,YAAqC;QAC/C,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,WAAW,EAAE,GAAG,CAAC,WAAW;KAC7B,CAAC;IAEF,QAAQ,GAAG,CAAC,YAAY,EAAE,CAAC;QACzB,KAAK,MAAM;YACT,OAAO,kBAAkB,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAChD,KAAK,QAAQ;YACX,OAAO,oBAAoB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACzC,KAAK,UAAU;YACb,OAAO,sBAAsB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC3C,KAAK,QAAQ;YACX,OAAO,oBAAoB,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAClD;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CACzB,GAAiB,EACjB,IAAmB,EACnB,OAAsB;IAEtB,IAAI,UAAU,GAAmB,EAAE,CAAC;IACpC,IAAI,CAAC;QACH,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;IAED,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW;QACjC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QACjE,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;QACL,GAAG,IAAI;QACP,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;QAC5D,WAAW;QACX,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,SAAS;KAChD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAC3B,GAAiB,EACjB,IAAmB;IAEnB,IAAI,UAAU,GAAoB,EAAE,CAAC;IACrC,IAAI,CAAC;QACH,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;IAED,OAAO;QACL,GAAG,IAAI;QACP,UAAU;QACV,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,SAAS;QACvC,oBAAoB,EAAE,GAAG,CAAC,oBAAoB,IAAI,SAAS;QAC3D,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,SAAS;QACrC,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,SAAS;KACtC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB,CAC7B,GAAiB,EACjB,IAAmB;IAEnB,IAAI,UAAU,GAAoB,EAAE,CAAC;IACrC,IAAI,CAAC;QACH,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;IAED,OAAO;QACL,GAAG,IAAI;QACP,UAAU;QACV,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,SAAS;QACvC,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,SAAS;KACtC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAC3B,GAAiB,EACjB,IAAmB,EACnB,OAAsB;IAEtB,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ;QAC3B,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QACzC,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;QACL,GAAG,IAAI;QACP,QAAQ,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;QAC7D,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;KACrD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,YAAwC,EACxC,UAAyB,EAAE;IAE3B,MAAM,SAAS,GAAG,aAAa,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAEvD,MAAM,KAAK,GAAa,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAEhD,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAE/C,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC1B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpC,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtC,MAAM,OAAO,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzE,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,GAAG,GAAG,KAAK,KAAK,CAAC,IAAI,GAAG,OAAO,EAAE,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,MAAM,SAAS,GAAG,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrF,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,UAAU,GAAG,SAAS,EAAE,CAAC,CAAC;QACxD,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC1B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACnC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrC,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,GAAG,GAAG,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/search/search-engine.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Orama search engine wrapper with typed search
+ */
+import { type Orama } from '@orama/orama';
+import { type BaseDocument, type OramaSchemaType } from '../schema/base-schema.js';
+/**
+ * Options for initializing the search engine
+ */
+export interface SearchEngineOptions {
+    /** Custom schema (defaults to baseSchema) */
+    schema?: OramaSchemaType;
+    /** Tokenizer options */
+    tokenizerOptions?: {
+        stemming?: boolean;
+        stemmerSkipProperties?: string[];
+    };
+}
+/**
+ * Search query options
+ */
+export interface SearchOptions {
+    /** Full-text search term */
+    query?: string;
+    /** Filter by document type */
+    documentType?: string;
+    /** Filter by category */
+    category?: string;
+    /** Filter by library */
+    library?: string;
+    /** Exclusion filters */
+    exclude?: {
+        categories?: string[];
+        libraries?: string[];
+    };
+    /** Maximum results (default: 10) */
+    limit?: number;
+    /** Pagination offset (default: 0) */
+    offset?: number;
+    /** Field boost weights */
+    boost?: Record<string, number>;
+}
+/**
+ * Search result
+ */
+export interface SearchResult<TDoc = BaseDocument> {
+    /** Matched documents */
+    results: TDoc[];
+    /** Total matches before pagination */
+    totalMatches: number;
+    /** Facet counts */
+    facets: {
+        documentType: Record<string, number>;
+        library: Record<string, number>;
+        category: Record<string, number>;
+    };
+    /** Search execution time in ms */
+    searchTime: number;
+}
+type AnyOrama = Orama<any>;
+/**
+ * Search engine wrapping Orama
+ */
+export declare class SearchEngine<TDoc extends BaseDocument = BaseDocument> {
+    private db;
+    private options;
+    constructor(options?: SearchEngineOptions);
+    /**
+     * Initialize the search engine
+     */
+    initialize(): Promise<void>;
+    /**
+     * Insert a single document (uses update if document already exists)
+     */
+    insert(doc: TDoc): Promise<void>;
+    /**
+     * Insert multiple documents (uses update if documents already exist)
+     */
+    insertBatch(docs: TDoc[]): Promise<void>;
+    /**
+     * Remove a document by ID
+     */
+    remove(id: string): Promise<void>;
+    /**
+     * Search the index
+     */
+    search(options: SearchOptions): Promise<SearchResult<TDoc>>;
+    /**
+     * Get the underlying Orama database
+     */
+    getDb(): AnyOrama | null;
+    /**
+     * Check if the engine is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Shutdown the engine
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Ensure the engine is initialized
+     */
+    private ensureInitialized;
+}
+export {};
+//# sourceMappingURL=search-engine.d.ts.map

package/dist/search/search-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-engine.d.ts","sourceRoot":"","sources":["../../src/search/search-engine.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAQL,KAAK,KAAK,EAGX,MAAM,cAAc,CAAC;AACtB,OAAO,EAAc,KAAK,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAG/F;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,MAAM,CAAC,EAAE,eAAe,CAAC;IAEzB,wBAAwB;IACxB,gBAAgB,CAAC,EAAE;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;KAClC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,wBAAwB;IACxB,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;IAEF,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,IAAI,GAAG,YAAY;IAC/C,wBAAwB;IACxB,OAAO,EAAE,IAAI,EAAE,CAAC;IAEhB,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IAErB,mBAAmB;IACnB,MAAM,EAAE;QACN,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC,CAAC;IAEF,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;CACpB;AAGD,KAAK,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;AAsC3B;;GAEG;AACH,qBAAa,YAAY,CAAC,IAAI,SAAS,YAAY,GAAG,YAAY;IAChE,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,OAAO,CAAsB;gBAEzB,OAAO,GAAE,mBAAwB;IAI7C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBjC;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IActC;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB9C;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvC;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAyIjE;;OAEG;IACH,KAAK,IAAI,QAAQ,GAAG,IAAI;IAIxB;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B;;OAEG;YACW,iBAAiB;CAKhC"}