@matperez/coderag 0.1.24

package/dist/embeddings.test.js

@@ -0,0 +1,255 @@
+/**
+ * Tests for Embedding utilities
+ */
+import { beforeEach, describe, expect, it } from 'vitest';
+import { chunkText, composeProviders, cosineSimilarity, createDefaultConfig, createMockProvider, generateMockEmbedding, normalizeVector, } from './embeddings.js';
+describe('generateMockEmbedding', () => {
+    it('should generate embedding of correct dimensions', () => {
+        const embedding = generateMockEmbedding('test text', 128);
+        expect(embedding).toHaveLength(128);
+    });
+    it('should generate normalized vectors (magnitude = 1)', () => {
+        const embedding = generateMockEmbedding('test', 512);
+        const magnitude = Math.sqrt(embedding.reduce((sum, val) => sum + val * val, 0));
+        expect(magnitude).toBeCloseTo(1, 10);
+    });
+    it('should be deterministic for same input', () => {
+        const embedding1 = generateMockEmbedding('hello world', 256);
+        const embedding2 = generateMockEmbedding('hello world', 256);
+        for (let i = 0; i < embedding1.length; i++) {
+            expect(embedding1[i]).toBe(embedding2[i]);
+        }
+    });
+    it('should generate different embeddings for different text', () => {
+        const embedding1 = generateMockEmbedding('hello', 256);
+        const embedding2 = generateMockEmbedding('world', 256);
+        // Embeddings should be different
+        let different = false;
+        for (let i = 0; i < embedding1.length; i++) {
+            if (embedding1[i] !== embedding2[i]) {
+                different = true;
+                break;
+            }
+        }
+        expect(different).toBe(true);
+    });
+});
+describe('createMockProvider', () => {
+    let provider;
+    beforeEach(() => {
+        provider = createMockProvider(128);
+    });
+    it('should create provider with correct config', () => {
+        expect(provider.name).toBe('mock');
+        expect(provider.model).toBe('mock');
+        expect(provider.dimensions).toBe(128);
+    });
+    it('should generate single embedding', async () => {
+        const embedding = await provider.generateEmbedding('test text');
+        expect(embedding).toHaveLength(128);
+    });
+    it('should generate multiple embeddings', async () => {
+        const embeddings = await provider.generateEmbeddings(['text1', 'text2', 'text3']);
+        expect(embeddings).toHaveLength(3);
+        expect(embeddings[0]).toHaveLength(128);
+        expect(embeddings[1]).toHaveLength(128);
+        expect(embeddings[2]).toHaveLength(128);
+    });
+    it('should generate consistent embeddings', async () => {
+        const embedding1 = await provider.generateEmbedding('hello');
+        const embedding2 = await provider.generateEmbedding('hello');
+        for (let i = 0; i < embedding1.length; i++) {
+            expect(embedding1[i]).toBe(embedding2[i]);
+        }
+    });
+});
+describe('createDefaultConfig', () => {
+    it('should create config with mock provider when no API key', () => {
+        // Save original env
+        const originalKey = process.env.OPENAI_API_KEY;
+        delete process.env.OPENAI_API_KEY;
+        const config = createDefaultConfig();
+        expect(config.provider).toBe('mock');
+        expect(config.dimensions).toBeGreaterThan(0);
+        // Restore env
+        if (originalKey) {
+            process.env.OPENAI_API_KEY = originalKey;
+        }
+    });
+    it('should use default model and dimensions', () => {
+        const config = createDefaultConfig();
+        expect(config.model).toBe('text-embedding-3-small');
+        expect(config.dimensions).toBe(1536); // Default for text-embedding-3-small
+        expect(config.batchSize).toBe(10);
+    });
+});
+describe('chunkText', () => {
+    it('should chunk text into pieces', () => {
+        const text = 'a'.repeat(2500);
+        const chunks = chunkText(text, { maxChunkSize: 1000, overlap: 0 });
+        expect(chunks.length).toBe(3);
+        expect(chunks[0].length).toBe(1000);
+        expect(chunks[1].length).toBe(1000);
+        expect(chunks[2].length).toBe(500);
+    });
+    it('should handle text shorter than chunk size', () => {
+        const text = 'short text';
+        const chunks = chunkText(text, { maxChunkSize: 1000 });
+        expect(chunks.length).toBe(1);
+        expect(chunks[0]).toBe(text);
+    });
+    it('should use default chunk size', () => {
+        const text = 'a'.repeat(1500);
+        const chunks = chunkText(text);
+        expect(chunks.length).toBeGreaterThan(1);
+    });
+    it('should create overlapping chunks', () => {
+        const text = 'a'.repeat(250);
+        const chunks = chunkText(text, { maxChunkSize: 100, overlap: 20 });
+        expect(chunks.length).toBeGreaterThan(2);
+        // Check overlap (last 20 chars of chunk[0] should match first 20 of chunk[1])
+        const chunk0End = chunks[0].slice(-20);
+        const chunk1Start = chunks[1].slice(0, 20);
+        expect(chunk0End).toBe(chunk1Start);
+    });
+    it('should handle empty text', () => {
+        const chunks = chunkText('');
+        expect(chunks.length).toBe(0);
+    });
+});
+describe('cosineSimilarity', () => {
+    it('should calculate similarity of identical vectors as 1', () => {
+        const vec = [1, 2, 3, 4];
+        const similarity = cosineSimilarity(vec, vec);
+        expect(similarity).toBeCloseTo(1, 10);
+    });
+    it('should calculate similarity of orthogonal vectors as 0', () => {
+        const vec1 = [1, 0];
+        const vec2 = [0, 1];
+        const similarity = cosineSimilarity(vec1, vec2);
+        expect(similarity).toBeCloseTo(0, 10);
+    });
+    it('should calculate similarity of opposite vectors as -1', () => {
+        const vec1 = [1, 2, 3];
+        const vec2 = [-1, -2, -3];
+        const similarity = cosineSimilarity(vec1, vec2);
+        expect(similarity).toBeCloseTo(-1, 10);
+    });
+    it('should handle similar vectors', () => {
+        const vec1 = [1, 2, 3];
+        const vec2 = [1, 2, 4];
+        const similarity = cosineSimilarity(vec1, vec2);
+        expect(similarity).toBeGreaterThan(0.9);
+        expect(similarity).toBeLessThan(1);
+    });
+    it('should handle zero vectors', () => {
+        const vec1 = [0, 0, 0];
+        const vec2 = [1, 2, 3];
+        const similarity = cosineSimilarity(vec1, vec2);
+        expect(similarity).toBe(0);
+    });
+    it('should throw error for mismatched dimensions', () => {
+        const vec1 = [1, 2, 3];
+        const vec2 = [1, 2];
+        expect(() => cosineSimilarity(vec1, vec2)).toThrow();
+    });
+    it('should be symmetric', () => {
+        const vec1 = [1, 2, 3];
+        const vec2 = [4, 5, 6];
+        const sim1 = cosineSimilarity(vec1, vec2);
+        const sim2 = cosineSimilarity(vec2, vec1);
+        expect(sim1).toBeCloseTo(sim2, 10);
+    });
+});
+describe('normalizeVector', () => {
+    it('should normalize vector to unit length', () => {
+        const vec = [3, 4]; // Length 5
+        const normalized = normalizeVector(vec);
+        const magnitude = Math.sqrt(normalized.reduce((sum, val) => sum + val * val, 0));
+        expect(magnitude).toBeCloseTo(1, 10);
+    });
+    it('should maintain direction', () => {
+        const vec = [3, 4];
+        const normalized = normalizeVector(vec);
+        // Direction should be maintained (ratios should be same)
+        expect(normalized[0] / normalized[1]).toBeCloseTo(vec[0] / vec[1], 10);
+    });
+    it('should handle zero vector', () => {
+        const vec = [0, 0, 0];
+        const normalized = normalizeVector(vec);
+        expect(normalized).toEqual(vec);
+    });
+    it('should handle already normalized vector', () => {
+        const vec = [0.6, 0.8]; // Already unit length
+        const normalized = normalizeVector(vec);
+        expect(normalized[0]).toBeCloseTo(0.6, 10);
+        expect(normalized[1]).toBeCloseTo(0.8, 10);
+    });
+});
+describe('composeProviders', () => {
+    it('should use primary provider when available', async () => {
+        const primary = createMockProvider(128);
+        const fallback = createMockProvider(256);
+        const composed = composeProviders(primary, fallback);
+        const embedding = await composed.generateEmbedding('test');
+        expect(embedding).toHaveLength(128); // Should use primary dimensions
+    });
+    it('should have combined name', () => {
+        const primary = createMockProvider(128);
+        const fallback = createMockProvider(256);
+        const composed = composeProviders(primary, fallback);
+        expect(composed.name).toBe('mock+mock');
+    });
+    it('should fallback when primary fails', async () => {
+        const failingProvider = {
+            name: 'failing',
+            model: 'test',
+            dimensions: 128,
+            generateEmbedding: async () => {
+                throw new Error('Provider failed');
+            },
+            generateEmbeddings: async () => {
+                throw new Error('Provider failed');
+            },
+        };
+        const fallback = createMockProvider(256);
+        const composed = composeProviders(failingProvider, fallback);
+        const embedding = await composed.generateEmbedding('test');
+        expect(embedding).toHaveLength(256); // Should use fallback dimensions
+    });
+    it('should fallback for batch generation', async () => {
+        const failingProvider = {
+            name: 'failing',
+            model: 'test',
+            dimensions: 128,
+            generateEmbedding: async () => {
+                throw new Error('Provider failed');
+            },
+            generateEmbeddings: async () => {
+                throw new Error('Provider failed');
+            },
+        };
+        const fallback = createMockProvider(256);
+        const composed = composeProviders(failingProvider, fallback);
+        const embeddings = await composed.generateEmbeddings(['test1', 'test2']);
+        expect(embeddings).toHaveLength(2);
+        expect(embeddings[0]).toHaveLength(256);
+    });
+});
+describe('integration: similarity search', () => {
+    it('should find similar texts', async () => {
+        const provider = createMockProvider(256);
+        const texts = ['apple fruit', 'banana fruit', 'car vehicle', 'truck vehicle'];
+        const embeddings = await provider.generateEmbeddings(texts);
+        // Similarity between fruits
+        const fruitSim = cosineSimilarity(embeddings[0], embeddings[1]);
+        // Similarity between vehicles
+        const vehicleSim = cosineSimilarity(embeddings[2], embeddings[3]);
+        // Similarity between fruit and vehicle
+        const crossSim = cosineSimilarity(embeddings[0], embeddings[2]);
+        // Fruits should be more similar to each other than to vehicles
+        expect(fruitSim).toBeGreaterThan(crossSim);
+        expect(vehicleSim).toBeGreaterThan(crossSim);
+    });
+});
+//# sourceMappingURL=embeddings.test.js.map

package/dist/embeddings.test.js.map

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

package/dist/hybrid-search.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Hybrid Search - Combines Vector and TF-IDF Search
+ */
+import type { CodebaseIndexer } from './indexer.js';
+/**
+ * Hybrid Search Options
+ */
+export interface HybridSearchOptions {
+    readonly limit?: number;
+    readonly minScore?: number;
+    readonly vectorWeight?: number;
+    readonly includeContent?: boolean;
+    readonly fileExtensions?: string[];
+    readonly pathFilter?: string;
+    readonly excludePaths?: string[];
+}
+/**
+ * Hybrid Search Result
+ */
+export interface HybridSearchResult {
+    readonly path: string;
+    readonly score: number;
+    readonly method: 'vector' | 'tfidf' | 'hybrid';
+    readonly matchedTerms?: string[];
+    readonly similarity?: number;
+    readonly content?: string;
+    readonly chunkType?: string;
+    readonly startLine?: number;
+    readonly endLine?: number;
+    readonly language?: string;
+}
+/**
+ * Hybrid search combining vector and TF-IDF
+ * Returns weighted combination of both approaches
+ */
+export declare function hybridSearch(query: string, indexer: CodebaseIndexer, options?: HybridSearchOptions): Promise<HybridSearchResult[]>;
+/**
+ * Semantic search (vector only)
+ * Convenience method for pure semantic search
+ */
+export declare function semanticSearch(query: string, indexer: CodebaseIndexer, options?: Omit<HybridSearchOptions, 'vectorWeight'>): Promise<HybridSearchResult[]>;
+/**
+ * Keyword search (TF-IDF only)
+ * Convenience method for pure keyword search
+ */
+export declare function keywordSearch(query: string, indexer: CodebaseIndexer, options?: Omit<HybridSearchOptions, 'vectorWeight'>): Promise<HybridSearchResult[]>;
+//# sourceMappingURL=hybrid-search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid-search.d.ts","sourceRoot":"","sources":["../src/hybrid-search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAgB,MAAM,cAAc,CAAA;AAGjE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAA;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAA;IAC9C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IAEzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;;GAGG;AACH,wBAAsB,YAAY,CACjC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE,mBAAwB,GAC/B,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAqH/B;AAsGD;;;GAGG;AACH,wBAAsB,cAAc,CACnC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,cAAc,CAAM,GACrD,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAE/B;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAClC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,cAAc,CAAM,GACrD,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAE/B"}

package/dist/hybrid-search.js

@@ -0,0 +1,215 @@
+/**
+ * Hybrid Search - Combines Vector and TF-IDF Search
+ */
+/**
+ * Hybrid search combining vector and TF-IDF
+ * Returns weighted combination of both approaches
+ */
+export async function hybridSearch(query, indexer, options = {}) {
+    const { limit = 10, minScore = 0.01, vectorWeight = 0.7, includeContent = false } = options;
+    const vectorStorage = indexer.getVectorStorage();
+    const embeddingProvider = indexer.getEmbeddingProvider();
+    // Try hybrid search if vector search is available
+    if (vectorStorage && embeddingProvider) {
+        try {
+            // Pure vector search (skip TF-IDF)
+            if (vectorWeight >= 0.99) {
+                console.error('[INFO] Using vector search only');
+                const queryEmbedding = await embeddingProvider.generateEmbedding(query);
+                const vectorResults = await vectorStorage.search(queryEmbedding, {
+                    k: limit,
+                    minScore: minScore,
+                });
+                return vectorResults.map((r) => {
+                    // Handle both chunk:// and file:// formats
+                    const id = r.doc.id;
+                    let path;
+                    let startLine;
+                    let endLine;
+                    if (id.startsWith('chunk://')) {
+                        // chunk://path:startLine-endLine
+                        const match = id.match(/^chunk:\/\/(.+):(\d+)-(\d+)$/);
+                        if (match) {
+                            path = match[1];
+                            startLine = parseInt(match[2], 10);
+                            endLine = parseInt(match[3], 10);
+                        }
+                        else {
+                            path = id.replace('chunk://', '');
+                        }
+                    }
+                    else {
+                        path = id.replace('file://', '');
+                    }
+                    // Extract metadata with type safety
+                    const meta = r.doc.metadata;
+                    const metaStartLine = typeof meta.startLine === 'number' ? meta.startLine : undefined;
+                    const metaEndLine = typeof meta.endLine === 'number' ? meta.endLine : undefined;
+                    return {
+                        path,
+                        score: r.similarity,
+                        method: 'vector',
+                        similarity: r.similarity,
+                        content: meta.content,
+                        language: meta.language,
+                        chunkType: typeof meta.chunkType === 'string' ? meta.chunkType : undefined,
+                        startLine: startLine ?? metaStartLine,
+                        endLine: endLine ?? metaEndLine,
+                    };
+                });
+            }
+            // Pure TF-IDF search (skip vector)
+            if (vectorWeight <= 0.01) {
+                console.error('[INFO] Using TF-IDF search only');
+                const results = await indexer.search(query, { limit, includeContent });
+                return results.map((r) => ({
+                    path: r.path,
+                    score: r.score,
+                    method: 'tfidf',
+                    matchedTerms: r.matchedTerms,
+                    content: r.snippet,
+                    language: r.language,
+                    chunkType: r.chunkType,
+                    startLine: r.startLine,
+                    endLine: r.endLine,
+                }));
+            }
+            // Hybrid search
+            console.error('[INFO] Using hybrid search (vector + TF-IDF)');
+            // 1. Vector search
+            const queryEmbedding = await embeddingProvider.generateEmbedding(query);
+            const vectorResults = await vectorStorage.search(queryEmbedding, {
+                k: limit * 2, // Get more for merging
+                minScore: 0, // Get all results for merging
+            });
+            // 2. TF-IDF search
+            const tfidfResults = await indexer.search(query, {
+                limit: limit * 2,
+                includeContent,
+            });
+            // 3. Merge results
+            const merged = mergeSearchResults(vectorResults, tfidfResults, vectorWeight);
+            // 4. Filter and limit
+            return merged.filter((r) => r.score >= minScore).slice(0, limit);
+        }
+        catch (error) {
+            console.error('[WARN] Hybrid search failed, falling back to TF-IDF:', error);
+        }
+    }
+    // Fallback to TF-IDF only
+    console.error('[INFO] Using TF-IDF search only');
+    const results = await indexer.search(query, { limit, includeContent });
+    return results.map((r) => ({
+        path: r.path,
+        score: r.score,
+        method: 'tfidf',
+        matchedTerms: r.matchedTerms,
+        content: r.snippet,
+        language: r.language,
+        chunkType: r.chunkType,
+        startLine: r.startLine,
+        endLine: r.endLine,
+    }));
+}
+/**
+ * Merge vector and TF-IDF results with weighted scoring
+ * Now handles chunk-level results
+ */
+function mergeSearchResults(vectorResults, tfidfResults, vectorWeight) {
+    const resultMap = new Map();
+    // Normalize scores to 0-1 range
+    const maxVectorScore = Math.max(...vectorResults.map((r) => r.similarity), 0.01);
+    const maxTfidfScore = Math.max(...tfidfResults.map((r) => r.score), 0.01);
+    // Helper to create a unique key for chunks
+    const getChunkKey = (path, startLine, endLine) => startLine && endLine ? `${path}:${startLine}-${endLine}` : path;
+    // Add vector results
+    for (const result of vectorResults) {
+        // Handle both chunk:// and file:// formats
+        const id = result.doc.id;
+        let path;
+        let startLine;
+        let endLine;
+        if (id.startsWith('chunk://')) {
+            const match = id.match(/^chunk:\/\/(.+):(\d+)-(\d+)$/);
+            if (match) {
+                path = match[1];
+                startLine = parseInt(match[2], 10);
+                endLine = parseInt(match[3], 10);
+            }
+            else {
+                path = id.replace('chunk://', '');
+            }
+        }
+        else {
+            path = id.replace('file://', '');
+        }
+        // Extract metadata with type safety
+        const meta = result.doc.metadata;
+        const metaStartLine = typeof meta.startLine === 'number' ? meta.startLine : undefined;
+        const metaEndLine = typeof meta.endLine === 'number' ? meta.endLine : undefined;
+        const normalizedScore = result.similarity / maxVectorScore;
+        const key = getChunkKey(path, startLine, endLine);
+        resultMap.set(key, {
+            path,
+            score: normalizedScore * vectorWeight,
+            method: 'vector',
+            similarity: result.similarity,
+            content: meta.content,
+            language: meta.language,
+            chunkType: typeof meta.chunkType === 'string' ? meta.chunkType : undefined,
+            startLine: startLine ?? metaStartLine,
+            endLine: endLine ?? metaEndLine,
+        });
+    }
+    // Add/merge TF-IDF results
+    for (const result of tfidfResults) {
+        const normalizedScore = result.score / maxTfidfScore;
+        const key = getChunkKey(result.path, result.startLine, result.endLine);
+        const existing = resultMap.get(key);
+        if (existing) {
+            // Combine scores (weighted sum) - create new object
+            resultMap.set(key, {
+                path: result.path,
+                score: existing.score + normalizedScore * (1 - vectorWeight),
+                method: 'hybrid',
+                matchedTerms: result.matchedTerms,
+                similarity: existing.similarity,
+                content: result.snippet || existing.content,
+                language: result.language || existing.language,
+                chunkType: result.chunkType || existing.chunkType,
+                startLine: result.startLine ?? existing.startLine,
+                endLine: result.endLine ?? existing.endLine,
+            });
+        }
+        else {
+            resultMap.set(key, {
+                path: result.path,
+                score: normalizedScore * (1 - vectorWeight),
+                method: 'tfidf',
+                matchedTerms: result.matchedTerms,
+                content: result.snippet,
+                language: result.language,
+                chunkType: result.chunkType,
+                startLine: result.startLine,
+                endLine: result.endLine,
+            });
+        }
+    }
+    // Sort by combined score
+    return Array.from(resultMap.values()).sort((a, b) => b.score - a.score);
+}
+/**
+ * Semantic search (vector only)
+ * Convenience method for pure semantic search
+ */
+export async function semanticSearch(query, indexer, options = {}) {
+    return hybridSearch(query, indexer, { ...options, vectorWeight: 1.0 });
+}
+/**
+ * Keyword search (TF-IDF only)
+ * Convenience method for pure keyword search
+ */
+export async function keywordSearch(query, indexer, options = {}) {
+    return hybridSearch(query, indexer, { ...options, vectorWeight: 0.0 });
+}
+//# sourceMappingURL=hybrid-search.js.map

package/dist/hybrid-search.js.map

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

package/dist/hybrid-search.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Hybrid Search Tests
+ */
+export {};
+//# sourceMappingURL=hybrid-search.test.d.ts.map

package/dist/hybrid-search.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid-search.test.d.ts","sourceRoot":"","sources":["../src/hybrid-search.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}