@ngao/search 0.1.0 → 0.1.2

package/dist/backend/repositories/repository.interface.d.ts

@@ -0,0 +1,334 @@
+/**
+ * Repository Pattern Interfaces
+ * Abstracts data access layer for flexibility and testability
+ */
+import { Block } from '../core/models';
+import { FilePath, SearchTerm, FileContent, FileHash } from '../core/types';
+/**
+ * Generic repository interface
+ * All repositories should implement this contract
+ */
+export interface IRepository<T, ID> {
+    /**
+     * Find entity by ID
+     *
+     * @param id - Entity identifier
+     * @returns Entity or null if not found
+     */
+    findById(id: ID): Promise<T | null>;
+    /**
+     * Find all entities
+     *
+     * @returns Array of all entities
+     */
+    findAll(): Promise<T[]>;
+    /**
+     * Save entity (create or update)
+     *
+     * @param entity - Entity to save
+     * @returns Saved entity
+     */
+    save(entity: T): Promise<T>;
+    /**
+     * Delete entity by ID
+     *
+     * @param id - Entity identifier
+     * @returns true if deleted, false if not found
+     */
+    delete(id: ID): Promise<boolean>;
+    /**
+     * Check if entity exists
+     *
+     * @param id - Entity identifier
+     * @returns true if exists
+     */
+    exists(id: ID): Promise<boolean>;
+    /**
+     * Delete all entities
+     *
+     * @returns Promise that resolves when clear is complete
+     */
+    clear(): Promise<void>;
+}
+/**
+ * Search criteria for block queries
+ */
+export interface BlockSearchCriteria {
+    /** Filter by file path */
+    filePath?: FilePath;
+    /** Filter by item type */
+    itemType?: string;
+    /** Filter by scope hierarchy */
+    scope?: string[];
+    /** Filter by keyword */
+    keyword?: SearchTerm;
+    /** Filter by public status */
+    isPublic?: boolean;
+}
+/**
+ * Block repository interface
+ * Extends generic repository with block-specific queries
+ */
+export interface IBlockRepository extends IRepository<Block, string> {
+    /**
+     * Save multiple blocks in batch (optimized for indexing)
+     *
+     * @param blocks - Array of blocks to save
+     * @returns Array of saved blocks
+     */
+    saveMany(blocks: Block[]): Promise<Block[]>;
+    /**
+     * Find blocks by file path
+     *
+     * @param filePath - File path to search
+     * @returns Array of blocks from file
+     */
+    findByFilePath(filePath: FilePath): Promise<Block[]>;
+    /**
+     * Find blocks by scope hierarchy
+     *
+     * @param scope - Scope path (e.g., ['ClassName', 'methodName'])
+     * @returns Array of blocks in scope
+     */
+    findByScope(scope: string[]): Promise<Block[]>;
+    /**
+     * Search blocks by keyword
+     *
+     * @param keyword - Search keyword
+     * @returns Array of matching blocks
+     */
+    searchByKeyword(keyword: SearchTerm): Promise<Block[]>;
+    /**
+     * Search blocks by content
+     *
+     * @param content - Content to search
+     * @returns Array of matching blocks
+     */
+    searchByContent(content: FileContent): Promise<Block[]>;
+    /**
+     * Get blocks matching multiple criteria
+     *
+     * @param criteria - Search criteria
+     * @returns Array of matching blocks
+     */
+    findByCriteria(criteria: BlockSearchCriteria): Promise<Block[]>;
+    /**
+     * Delete all blocks from file
+     *
+     * @param filePath - File path
+     * @returns Number of deleted blocks
+     */
+    deleteByFilePath(filePath: FilePath): Promise<number>;
+    /**
+     * Get total block count
+     *
+     * @returns Total number of blocks
+     */
+    count(): Promise<number>;
+    /**
+     * Find blocks with pagination
+     *
+     * @param offset - Number of results to skip
+     * @param limit - Maximum results to return
+     * @returns Array of blocks
+     */
+    findPaginated(offset: number, limit: number): Promise<Block[]>;
+}
+/**
+ * Inverted index entry
+ */
+export interface InvertedIndexEntry {
+    /** The search term */
+    term: string;
+    /** Block IDs containing this term */
+    blockIds: string[];
+    /** Total occurrences */
+    occurrenceCount: number;
+}
+/**
+ * Index repository interface
+ */
+export interface IIndexRepository {
+    /**
+     * Save inverted index
+     *
+     * @param index - Index data as map
+     * @returns Promise that resolves when save is complete
+     */
+    saveInvertedIndex(index: Map<string, InvertedIndexEntry[]>): Promise<void>;
+    /**
+     * Load inverted index
+     *
+     * @returns Inverted index map
+     */
+    loadInvertedIndex(): Promise<Map<string, InvertedIndexEntry[]>>;
+    /**
+     * Update a single index entry
+     *
+     * @param term - Search term
+     * @param entries - Index entries for this term
+     * @returns Promise that resolves when update is complete
+     */
+    updateIndexEntry(term: string, entries: InvertedIndexEntry[]): Promise<void>;
+    /**
+     * Get index size in bytes
+     *
+     * @returns Size estimation
+     */
+    getIndexSize(): Promise<number>;
+    /**
+     * Clear all index data
+     *
+     * @returns Promise that resolves when clear is complete
+     */
+    clear(): Promise<void>;
+}
+/**
+ * File metadata for change detection
+ */
+export interface FileMetadata {
+    /** File path */
+    filePath: FilePath;
+    /** SHA256 hash of file content */
+    fileHash: FileHash;
+    /** Last indexed timestamp */
+    lastIndexedAt: number;
+}
+/**
+ * Metadata repository interface
+ */
+export interface IMetadataRepository {
+    /**
+     * Get file hash
+     *
+     * @param filePath - File path
+     * @returns File hash or null if not found
+     */
+    getFileHash(filePath: FilePath): Promise<FileHash | null>;
+    /**
+     * Update file hash
+     *
+     * @param filePath - File path
+     * @param hash - New file hash
+     * @returns Promise that resolves when update is complete
+     */
+    updateFileHash(filePath: FilePath, hash: FileHash): Promise<void>;
+    /**
+     * Get last indexed time for file
+     *
+     * @param filePath - File path
+     * @returns Timestamp or null if not indexed
+     */
+    getLastIndexedTime(filePath: FilePath): Promise<number | null>;
+    /**
+     * Update last indexed time
+     *
+     * @param filePath - File path
+     * @param timestamp - Timestamp
+     * @returns Promise that resolves when update is complete
+     */
+    updateLastIndexedTime(filePath: FilePath, timestamp: number): Promise<void>;
+    /**
+     * Get all indexed files
+     *
+     * @returns Array of file paths
+     */
+    getIndexedFiles(): Promise<FilePath[]>;
+    /**
+     * Get all indexed directories
+     *
+     * @returns Array of directory paths
+     */
+    getIndexedDirectories(): Promise<string[]>;
+    /**
+     * Get file metadata for a specific file
+     *
+     * @param filePath - File path
+     * @returns File metadata or null if not found
+     */
+    getFileMetadata(filePath: FilePath): Promise<{
+        filePath: FilePath;
+        fileType: string;
+        fileHash: FileHash;
+        fileSizeBytes: number;
+        indexedAt: number;
+        blockCount: number;
+        blocksByType: Record<string, number>;
+        embeddingPresent: boolean;
+    } | null>;
+    /**
+     * Get all file metadata
+     *
+     * @returns Array of file metadata
+     */
+    getAllFileMetadata(): Promise<Array<{
+        filePath: FilePath;
+        fileType: string;
+        fileHash: FileHash;
+        fileSizeBytes: number;
+        indexedAt: number;
+        blockCount: number;
+        blocksByType: Record<string, number>;
+        embeddingPresent: boolean;
+    }>>;
+    /**
+     * Update reindex metadata
+     *
+     * @param dirPath - Directory path
+     * @param stats - Reindex statistics
+     * @returns Promise that resolves when update is complete
+     */
+    updateReindexMetadata(dirPath: string, stats: {
+        lastReindexedAt: number;
+        reindexCount: number;
+        averageReindexTimeMs: number;
+    }): Promise<void>;
+    /**
+     * Clear all metadata
+     *
+     * @returns Promise that resolves when clear is complete
+     */
+    clear(): Promise<void>;
+}
+/**
+ * Generic cache interface
+ */
+export interface ICache {
+    /**
+     * Get value from cache
+     *
+     * @param key - Cache key
+     * @returns Cached value or null if not found or expired
+     */
+    get<T>(key: string): Promise<T | null>;
+    /**
+     * Set value in cache
+     *
+     * @param key - Cache key
+     * @param value - Value to cache
+     * @param ttlSeconds - Time to live in seconds
+     * @returns Promise that resolves when set is complete
+     */
+    set<T>(key: string, value: T, ttlSeconds?: number): Promise<void>;
+    /**
+     * Check if key exists in cache
+     *
+     * @param key - Cache key
+     * @returns true if exists and not expired
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * Delete value from cache
+     *
+     * @param key - Cache key
+     * @returns true if deleted, false if not found
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * Clear entire cache
+     *
+     * @returns Promise that resolves when clear is complete
+     */
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=repository.interface.d.ts.map

package/dist/backend/repositories/repository.interface.d.ts.map

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

package/dist/backend/repositories/repository.interface.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Repository Pattern Interfaces
+ * Abstracts data access layer for flexibility and testability
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=repository.interface.js.map

package/dist/backend/repositories/repository.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.interface.js","sourceRoot":"","sources":["../../../src/backend/repositories/repository.interface.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/backend/search/context-extractor.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Context Extractor
+ * Extracts surrounding context for search results
+ */
+import { Block } from '../core/models';
+import { ILogger } from '../core/types';
+/**
+ * Extracts context snippets around matching blocks
+ */
+export declare class ContextExtractor {
+    private _contextLines;
+    private _logger;
+    constructor(logger?: ILogger, contextLines?: number);
+    /**
+     * Extract context snippet for a block
+     *
+     * @param block - Block to extract context for
+     * @returns Context snippet with surrounding lines
+     */
+    extractContext(block: Block): Promise<string>;
+    /**
+     * Extract and format context with line numbers
+     *
+     * @param block - Block to extract context for
+     * @returns Formatted context with line numbers
+     */
+    extractFormattedContext(block: Block): Promise<string>;
+}
+//# sourceMappingURL=context-extractor.d.ts.map

package/dist/backend/search/context-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-extractor.d.ts","sourceRoot":"","sources":["../../../src/backend/search/context-extractor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEvC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAGxC;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,OAAO,CAAU;gBAEN,MAAM,CAAC,EAAE,OAAO,EAAE,YAAY,GAAE,MAA8B;IAKjF;;;;;OAKG;IACU,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAsC1D;;;;;OAKG;IACU,uBAAuB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;CAyBpE"}

package/dist/backend/search/context-extractor.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * Context Extractor
+ * Extracts surrounding context for search results
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextExtractor = void 0;
+const fs = __importStar(require("fs"));
+const constants_1 = require("../core/constants");
+const logger_1 = require("../core/logger");
+/**
+ * Extracts context snippets around matching blocks
+ */
+class ContextExtractor {
+    constructor(logger, contextLines = constants_1.DEFAULT_CONTEXT_LINES) {
+        this._contextLines = contextLines;
+        this._logger = logger || new logger_1.NoOpLogger();
+    }
+    /**
+     * Extract context snippet for a block
+     *
+     * @param block - Block to extract context for
+     * @returns Context snippet with surrounding lines
+     */
+    async extractContext(block) {
+        try {
+            this._logger.debug('Extracting context', {
+                filePath: block.filePath,
+                blockName: block.name,
+                startLine: block.location.startLine,
+                endLine: block.location.endLine
+            });
+            const content = await fs.promises.readFile(block.filePath, 'utf-8');
+            const lines = content.split('\n');
+            // Calculate context window
+            const startLine = Math.max(0, block.location.startLine - 1 - this._contextLines);
+            const endLine = Math.min(lines.length, block.location.endLine + this._contextLines);
+            // Extract lines
+            const contextLines = lines.slice(startLine, endLine);
+            const snippet = contextLines.join('\n');
+            this._logger.debug('Context extracted successfully', {
+                contextLinesCount: contextLines.length
+            });
+            return snippet;
+        }
+        catch (error) {
+            // If file can't be read, return block content
+            this._logger.warn('Failed to read file for context', {
+                filePath: block.filePath,
+                error: String(error)
+            });
+            return block.content;
+        }
+    }
+    /**
+     * Extract and format context with line numbers
+     *
+     * @param block - Block to extract context for
+     * @returns Formatted context with line numbers
+     */
+    async extractFormattedContext(block) {
+        try {
+            const content = await fs.promises.readFile(block.filePath, 'utf-8');
+            const lines = content.split('\n');
+            const startLine = Math.max(0, block.location.startLine - 1 - this._contextLines);
+            const endLine = Math.min(lines.length, block.location.endLine + this._contextLines);
+            // Extract lines with line numbers
+            const contextLines = [];
+            for (let i = startLine; i < endLine; i++) {
+                const lineNum = i + 1;
+                const marker = lineNum >= block.location.startLine && lineNum <= block.location.endLine ? '>' : ' ';
+                contextLines.push(`${marker} ${String(lineNum).padStart(4)} | ${lines[i]}`);
+            }
+            return contextLines.join('\n');
+        }
+        catch {
+            // If file can't be read, return block content
+            return block.content;
+        }
+    }
+}
+exports.ContextExtractor = ContextExtractor;
+//# sourceMappingURL=context-extractor.js.map

package/dist/backend/search/context-extractor.js.map

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

package/dist/backend/search/multi-index-searcher.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Multi-Index Searcher
+ * Searches across inverted index and block repository
+ */
+import { Block } from '../core/models';
+import { IBlockRepository } from '../repositories/repository.interface';
+import { Query } from '../core/models';
+import { ILogger } from '../core/types';
+/**
+ * Searches blocks using inverted index
+ */
+export declare class MultiIndexSearcher {
+    private _blockRepository;
+    private _logger;
+    constructor(_blockRepository: IBlockRepository, logger?: ILogger);
+    /**
+     * Search blocks by query
+     *
+     * @param query - Parsed search query
+     * @returns Matching blocks
+     */
+    search(query: Query): Promise<Block[]>;
+    /**
+     * Check if block matches query criteria
+     */
+    private _blockMatches;
+}
+//# sourceMappingURL=multi-index-searcher.d.ts.map

package/dist/backend/search/multi-index-searcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-index-searcher.d.ts","sourceRoot":"","sources":["../../../src/backend/search/multi-index-searcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAGxC;;GAEG;AACH,qBAAa,kBAAkB;IAGV,OAAO,CAAC,gBAAgB;IAF3C,OAAO,CAAC,OAAO,CAAU;gBAEE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,OAAO;IAI/E;;;;;OAKG;IACU,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAoCnD;;OAEG;IACH,OAAO,CAAC,aAAa;CA4BtB"}

package/dist/backend/search/multi-index-searcher.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * Multi-Index Searcher
+ * Searches across inverted index and block repository
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultiIndexSearcher = void 0;
+const logger_1 = require("../core/logger");
+/**
+ * Searches blocks using inverted index
+ */
+class MultiIndexSearcher {
+    constructor(_blockRepository, logger) {
+        this._blockRepository = _blockRepository;
+        this._logger = logger || new logger_1.NoOpLogger();
+    }
+    /**
+     * Search blocks by query
+     *
+     * @param query - Parsed search query
+     * @returns Matching blocks
+     */
+    async search(query) {
+        this._logger.debug('Starting block search', {
+            terms: query.terms.length,
+            hasFileTypeFilter: (query.fileTypeFilters?.length ?? 0) > 0,
+            hasScopeFilter: (query.scopeFilters?.length ?? 0) > 0,
+            hasItemTypeFilter: (query.itemTypeFilters?.length ?? 0) > 0
+        });
+        const matchingBlocks = new Map();
+        if (query.terms.length === 0) {
+            this._logger.warn('Search performed with no terms');
+            return [];
+        }
+        // Get all blocks
+        const allBlocks = await this._blockRepository.findAll();
+        this._logger.debug('Retrieved blocks from repository', { blockCount: allBlocks.length });
+        // Filter blocks based on query
+        for (const block of allBlocks) {
+            if (this._blockMatches(block, query)) {
+                matchingBlocks.set(block.id, block);
+            }
+        }
+        const result = Array.from(matchingBlocks.values());
+        this._logger.debug('Block search completed', {
+            matchCount: result.length,
+            totalBlocks: allBlocks.length,
+            matchPercentage: allBlocks.length > 0 ? ((result.length / allBlocks.length) * 100).toFixed(2) : '0'
+        });
+        return result;
+    }
+    /**
+     * Check if block matches query criteria
+     */
+    _blockMatches(block, query) {
+        // Check file type filters
+        if (query.fileTypeFilters && query.fileTypeFilters.length > 0) {
+            // Would need file type in block - skipping for now
+        }
+        // Check item type filters
+        if (query.itemTypeFilters && query.itemTypeFilters.length > 0) {
+            if (!query.itemTypeFilters.includes(block.itemType)) {
+                return false;
+            }
+        }
+        // Check scope filters
+        if (query.scopeFilters && query.scopeFilters.length > 0) {
+            const blockScopeStr = block.scopeHierarchy.join('.');
+            const matchesScope = query.scopeFilters.some((scope) => blockScopeStr.includes(scope));
+            if (!matchesScope) {
+                return false;
+            }
+        }
+        // Check if block contains any query terms
+        const blockText = `${block.name} ${block.content} ${block.docstring || ''}`.toLowerCase();
+        const hasMatch = query.terms.some((term) => blockText.includes(term));
+        return hasMatch;
+    }
+}
+exports.MultiIndexSearcher = MultiIndexSearcher;
+//# sourceMappingURL=multi-index-searcher.js.map

package/dist/backend/search/multi-index-searcher.js.map

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

package/dist/backend/search/query-parser.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Query Parser
+ * Parses search queries into structured format
+ */
+import { Query } from '../core/models';
+import { ILogger } from '../core/types';
+/**
+ * Parses search queries and extracts structured information
+ */
+export declare class QueryParser {
+    private _logger;
+    constructor(logger?: ILogger);
+    /**
+     * Parse raw query string into structured Query object
+     *
+     * @param rawQuery - Raw query string from user
+     * @returns Parsed query object
+     * @throws Error if query fails validation
+     */
+    parse(rawQuery: string): Query;
+    /**
+     * Tokenize query string into terms
+     *
+     * @param query - Query string
+     * @returns Array of tokens
+     */
+    tokenize(query: string): string[];
+    /**
+     * Validate query length to prevent ReDoS and DoS attacks
+     *
+     * @param query - Query string to validate
+     * @throws Error if query violates constraints
+     */
+    private _validateQueryLength;
+    private _splitQuery;
+}
+//# sourceMappingURL=query-parser.d.ts.map

package/dist/backend/search/query-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-parser.d.ts","sourceRoot":"","sources":["../../../src/backend/search/query-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEvC,OAAO,EAAE,OAAO,EAAoB,MAAM,eAAe,CAAC;AAY1D;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAU;gBAEN,MAAM,CAAC,EAAE,OAAO;IAInC;;;;;;OAMG;IACI,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK;IA8DrC;;;;;OAKG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAOxC;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,WAAW;CA0BpB"}