rag-lite-ts 2.0.3 → 2.0.5

package/dist/index-manager.js

@@ -1,5 +1,5 @@
 import { VectorIndex } from './core/vector-index.js';
-import { openDatabase, getModelVersion, setModelVersion, getStoredModelInfo, setStoredModelInfo } from './core/db.js';
+import { openDatabase, getSystemInfo, setSystemInfo } from './core/db.js';
 import { config, getModelDefaults } from './core/config.js';
 export class IndexManager {
     modelName;
@@ -71,15 +71,15 @@ export class IndexManager {
         }
         try {
             // Get stored model information
-            const storedModel = await getStoredModelInfo(this.db);
+            const systemInfo = await getSystemInfo(this.db);
             const currentModel = this.modelName || config.embedding_model;
             const currentDefaults = getModelDefaults(currentModel);
-            if (storedModel) {
+            if (systemInfo && systemInfo.modelName && systemInfo.modelDimensions) {
                 // Check if models match
-                if (storedModel.modelName !== currentModel) {
+                if (systemInfo.modelName !== currentModel) {
                     throw new Error(`Model mismatch detected!\n` +
                         `Current model: ${currentModel} (${currentDefaults.dimensions} dimensions)\n` +
-                        `Index model: ${storedModel.modelName} (${storedModel.dimensions} dimensions)\n` +
+                        `Index model: ${systemInfo.modelName} (${systemInfo.modelDimensions} dimensions)\n` +
                         `\n` +
                         `The embedding model has changed since the index was created.\n` +
                         `This requires a full index rebuild to maintain consistency.\n` +
@@ -91,10 +91,10 @@ export class IndexManager {
                         `This will regenerate all embeddings with the new model.`);
                 }
                 // Check if dimensions match (additional safety check)
-                if (storedModel.dimensions !== currentDefaults.dimensions) {
+                if (systemInfo.modelDimensions !== currentDefaults.dimensions) {
                     throw new Error(`Model dimension mismatch detected!\n` +
                         `Current model dimensions: ${currentDefaults.dimensions}\n` +
-                        `Index model dimensions: ${storedModel.dimensions}\n` +
+                        `Index model dimensions: ${systemInfo.modelDimensions}\n` +
                         `\n` +
                         `This indicates a configuration inconsistency.\n` +
                         `Please run: npm run rebuild`);
@@ -104,7 +104,10 @@ export class IndexManager {
             else {
                 // First run - store the model info
                 console.log(`No model info stored yet - storing current model info: ${currentModel}`);
-                await setStoredModelInfo(this.db, currentModel, currentDefaults.dimensions);
+                await setSystemInfo(this.db, {
+                    modelName: currentModel,
+                    modelDimensions: currentDefaults.dimensions
+                });
             }
         }
         catch (error) {
@@ -228,7 +231,10 @@ export class IndexManager {
                 // Store model info for the new model
                 const currentModel = this.modelName || config.embedding_model;
                 const currentDefaults = getModelDefaults(currentModel);
-                await setStoredModelInfo(this.db, currentModel, currentDefaults.dimensions);
+                await setSystemInfo(this.db, {
+                    modelName: currentModel,
+                    modelDimensions: currentDefaults.dimensions
+                });
                 await this.saveIndex();
                 return;
             }
@@ -260,7 +266,10 @@ export class IndexManager {
             // Store model info for the new model
             const currentModel = this.modelName || config.embedding_model;
             const currentDefaults = getModelDefaults(currentModel);
-            await setStoredModelInfo(this.db, currentModel, currentDefaults.dimensions);
+            await setSystemInfo(this.db, {
+                modelName: currentModel,
+                modelDimensions: currentDefaults.dimensions
+            });
             // Save the rebuilt index
             await this.saveIndex();
             console.log(`Index rebuild complete: ${vectors.length} vectors with new model version`);
@@ -278,10 +287,11 @@ export class IndexManager {
             throw new Error('Database not initialized');
         }
         try {
-            const storedVersion = await getModelVersion(this.db);
+            const systemInfo = await getSystemInfo(this.db);
+            const storedVersion = systemInfo?.modelVersion;
             if (!storedVersion || storedVersion === "") {
                 // No version stored yet, this is first run - store current version
-                await setModelVersion(this.db, currentVersion);
+                await setSystemInfo(this.db, { modelVersion: currentVersion });
                 console.log(`Stored initial model version: ${currentVersion}`);
                 return true;
             }
@@ -307,7 +317,7 @@ export class IndexManager {
             throw new Error('Database not initialized');
         }
         try {
-            await setModelVersion(this.db, version);
+            await setSystemInfo(this.db, { modelVersion: version });
             console.log(`Updated model version to: ${version}`);
         }
         catch (error) {
@@ -365,7 +375,8 @@ export class IndexManager {
         }
         const totalVectors = this.vectorIndex.getCurrentCount();
         try {
-            const modelVersion = await getModelVersion(this.db);
+            const systemInfo = await getSystemInfo(this.db);
+            const modelVersion = systemInfo?.modelVersion || null;
             return {
                 totalVectors,
                 modelVersion: modelVersion || 'unknown',

package/dist/index.d.ts

@@ -40,33 +40,8 @@
  * const search = new CoreSearchEngine(embedFn, indexManager, db);
  * ```
  */
-export { TextSearchFactory, TextIngestionFactory, TextRAGFactory, TextFactoryHelpers } from './factories/index.js';
-/**
- * @deprecated PolymorphicSearchFactory is no longer needed - SearchEngine now automatically
- * detects mode from database and adapts accordingly (Chameleon Architecture).
- *
- * Migration Guide:
- * ```typescript
- * // Old way (deprecated):
- * const search = await PolymorphicSearchFactory.create('./index.bin', './db.sqlite');
- *
- * // New way (recommended):
- * const search = new SearchEngine('./index.bin', './db.sqlite');
- * await search.search('query'); // Mode automatically detected
- * ```
- *
- * The SearchEngine constructor now uses the polymorphic factory internally,
- * providing the same automatic mode detection without requiring explicit factory usage.
- */
-export { PolymorphicSearchFactory } from './factories/index.js';
-export { TextSearchFactory as SearchFactory, TextIngestionFactory as IngestionFactory, TextRAGFactory as RAGFactory } from './factories/index.js';
-export type { TextSearchOptions, TextIngestionOptions } from './factories/index.js';
-/**
- * @deprecated PolymorphicSearchOptions is no longer needed - use SearchEngineOptions instead.
- * SearchEngine now automatically detects mode and adapts (Chameleon Architecture).
- */
-export type { PolymorphicSearchOptions } from './factories/index.js';
-export type { TextSearchOptions as SearchEngineOptions, TextIngestionOptions as IngestionPipelineOptions } from './factories/index.js';
+export { IngestionFactory, SearchFactory } from './factories/index.js';
+export type { IngestionFactoryOptions } from './factories/index.js';
 export { SearchEngine as CoreSearchEngine } from './core/search.js';
 export { IngestionPipeline as CoreIngestionPipeline } from './core/ingestion.js';
 export { SearchEngine } from './search.js';
@@ -76,15 +51,15 @@ export type { EmbedFunction, RerankFunction, EmbeddingQueryInterface, RerankingI
 export { InterfaceValidator } from './core/interfaces.js';
 export { validateModeModelCompatibility, validateModeModelCompatibilityOrThrow, getRecommendedModelsForMode, isModeModelCompatible, getCompatibleModelsForMode, type ModeModelValidationResult } from './core/mode-model-validator.js';
 export { createMissingFileError, createInvalidPathError, createModelLoadingError, createDimensionMismatchError, createModeMismatchError, createInvalidContentError, createMissingDependencyError, createFactoryCreationError, enhanceError, createContextualError, type ActionableErrorConfig } from './core/actionable-error-messages.js';
-export { EmbeddingEngine, getEmbeddingEngine, initializeEmbeddingEngine, createTextEmbedFunction, createTextEmbedder } from './text/embedder.js';
+export { EmbeddingEngine, getEmbeddingEngine, initializeEmbeddingEngine, createTextEmbedFunction } from './text/embedder.js';
 export type { UniversalEmbedder } from './core/universal-embedder.js';
 export { CLIPEmbedder } from './multimodal/clip-embedder.js';
 export { createEmbedder } from './core/embedder-factory.js';
-export { CrossEncoderReranker, createTextRerankFunction, createTextReranker } from './text/reranker.js';
+export { CrossEncoderReranker, createTextRerankFunction } from './text/reranker.js';
 export { countTokens } from './text/tokenizer.js';
 export type { RerankingStrategyType, RerankingConfig } from './core/reranking-config.js';
 export { validateRerankingStrategy, validateRerankingConfig, getDefaultRerankingConfig, isStrategySupported, getSupportedStrategies, RerankingConfigBuilder, DEFAULT_TEXT_RERANKING_CONFIG, DEFAULT_MULTIMODAL_RERANKING_CONFIG } from './core/reranking-config.js';
-export { openDatabase, initializeSchema, insertDocument, insertChunk, upsertDocument, getChunksByEmbeddingIds, getModelVersion, setModelVersion, getStoredModelInfo, setStoredModelInfo, type DatabaseConnection } from './core/db.js';
+export { openDatabase, initializeSchema, insertDocument, insertChunk, upsertDocument, getChunksByEmbeddingIds, type DatabaseConnection } from './core/db.js';
 export { IndexManager } from './index-manager.js';
 export { VectorIndex } from './core/vector-index.js';
 export { config, getModelDefaults, type CoreConfig, type ExtensibleConfig, type ModelDefaults, EXIT_CODES, ConfigurationError, getDefaultModelCachePath, handleUnrecoverableError, logError } from './core/config.js';

package/dist/index.js

@@ -44,27 +44,12 @@
 // PRIMARY API (FACTORY PATTERN)
 // =============================================================================
 // Main factory classes for simple usage
-export { TextSearchFactory, TextIngestionFactory, TextRAGFactory, TextFactoryHelpers } from './factories/index.js';
-/**
- * @deprecated PolymorphicSearchFactory is no longer needed - SearchEngine now automatically
- * detects mode from database and adapts accordingly (Chameleon Architecture).
- *
- * Migration Guide:
- * ```typescript
- * // Old way (deprecated):
- * const search = await PolymorphicSearchFactory.create('./index.bin', './db.sqlite');
- *
- * // New way (recommended):
- * const search = new SearchEngine('./index.bin', './db.sqlite');
- * await search.search('query'); // Mode automatically detected
- * ```
- *
- * The SearchEngine constructor now uses the polymorphic factory internally,
- * providing the same automatic mode detection without requiring explicit factory usage.
- */
-export { PolymorphicSearchFactory } from './factories/index.js';
-// Convenience aliases for common usage
-export { TextSearchFactory as SearchFactory, TextIngestionFactory as IngestionFactory, TextRAGFactory as RAGFactory } from './factories/index.js';
+export { IngestionFactory, SearchFactory } from './factories/index.js';
+// =============================================================================
+// REMOVED IN v3.0.0: Type aliases
+// =============================================================================
+// IngestionPipelineOptions has been removed. Use IngestionFactoryOptions directly.
+// Migration: Replace IngestionPipelineOptions with IngestionFactoryOptions
 // =============================================================================
 // CORE ARCHITECTURE (FOR LIBRARY AUTHORS)
 // =============================================================================
@@ -86,11 +71,11 @@ export { createMissingFileError, createInvalidPathError, createModelLoadingError
 // TEXT IMPLEMENTATIONS (FOR CUSTOM DEPENDENCY INJECTION)
 // =============================================================================
 // Text-specific embedding implementations
-export { EmbeddingEngine, getEmbeddingEngine, initializeEmbeddingEngine, createTextEmbedFunction, createTextEmbedder } from './text/embedder.js';
+export { EmbeddingEngine, getEmbeddingEngine, initializeEmbeddingEngine, createTextEmbedFunction } from './text/embedder.js';
 export { CLIPEmbedder } from './multimodal/clip-embedder.js';
 export { createEmbedder } from './core/embedder-factory.js';
 // Text-specific reranking implementations
-export { CrossEncoderReranker, createTextRerankFunction, createTextReranker } from './text/reranker.js';
+export { CrossEncoderReranker, createTextRerankFunction } from './text/reranker.js';
 // Text tokenization utilities
 export { countTokens } from './text/tokenizer.js';
 export { validateRerankingStrategy, validateRerankingConfig, getDefaultRerankingConfig, isStrategySupported, getSupportedStrategies, RerankingConfigBuilder, DEFAULT_TEXT_RERANKING_CONFIG, DEFAULT_MULTIMODAL_RERANKING_CONFIG } from './core/reranking-config.js';
@@ -98,7 +83,7 @@ export { validateRerankingStrategy, validateRerankingConfig, getDefaultReranking
 // CORE INFRASTRUCTURE (FOR ADVANCED USERS)
 // =============================================================================
 // Database operations
-export { openDatabase, initializeSchema, insertDocument, insertChunk, upsertDocument, getChunksByEmbeddingIds, getModelVersion, setModelVersion, getStoredModelInfo, setStoredModelInfo } from './core/db.js';
+export { openDatabase, initializeSchema, insertDocument, insertChunk, upsertDocument, getChunksByEmbeddingIds } from './core/db.js';
 // Vector index management
 export { IndexManager } from './index-manager.js';
 export { VectorIndex } from './core/vector-index.js';

package/dist/ingestion.d.ts

@@ -17,11 +17,9 @@
  * });
  * ```
  */
-import { type TextIngestionOptions } from './factories/index.js';
+import { type IngestionFactoryOptions } from './factories/index.js';
 import type { IngestionOptions, IngestionResult } from './core/ingestion.js';
 import type { MemoryContentMetadata } from './core/content-manager.js';
-export interface IngestionPipelineOptions extends TextIngestionOptions {
-}
 export declare class IngestionPipeline {
     private dbPath;
     private indexPath;
@@ -29,7 +27,7 @@ export declare class IngestionPipeline {
     private corePipeline;
     private initPromise;
     private defaultChunkConfig;
-    constructor(dbPath: string, indexPath: string, options?: IngestionPipelineOptions);
+    constructor(dbPath: string, indexPath: string, options?: IngestionFactoryOptions);
     /**
      * Initialize the ingestion pipeline using the factory
      */

package/dist/ingestion.js

@@ -17,7 +17,7 @@
  * });
  * ```
  */
-import { TextIngestionFactory } from './factories/index.js';
+import { IngestionFactory } from './factories/index.js';
 export class IngestionPipeline {
     dbPath;
     indexPath;
@@ -52,7 +52,7 @@ export class IngestionPipeline {
             return this.initPromise; // Initialization in progress
         }
         this.initPromise = (async () => {
-            this.corePipeline = await TextIngestionFactory.create(this.dbPath, this.indexPath, this.options);
+            this.corePipeline = await IngestionFactory.create(this.dbPath, this.indexPath, this.options);
         })();
         return this.initPromise;
     }

package/dist/mcp-server.js

@@ -24,11 +24,11 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
-import { existsSync, statSync } from 'fs';
+import { existsSync, statSync, createWriteStream } from 'fs';
 import { resolve } from 'path';
-import { PolymorphicSearchFactory } from './core/polymorphic-search-factory.js';
-import { TextIngestionFactory } from './factories/text-factory.js';
-import { openDatabase } from './core/db.js';
+import { SearchFactory } from './factories/search-factory.js';
+import { IngestionFactory } from './factories/ingestion-factory.js';
+import { getSystemInfo } from './core/db.js';
 import { DatabaseConnectionManager } from './core/database-connection-manager.js';
 import { config, validateCoreConfig, ConfigurationError } from './core/config.js';
 /**
@@ -568,8 +568,8 @@ class RagLiteMCPServer {
                 factoryOptions.forceRebuild = true;
             }
             // Create and run ingestion pipeline using text factory
-            // The TextIngestionFactory already supports mode and reranking strategy parameters
-            const pipeline = await TextIngestionFactory.create(config.db_file, config.index_file, factoryOptions);
+            // The IngestionFactory already supports mode and reranking strategy parameters
+            const pipeline = await IngestionFactory.create(config.db_file, config.index_file, factoryOptions);
             try {
                 const result = await pipeline.ingestPath(resolvedPath);
                 // Reset search engine initialization flag since index may have changed
@@ -746,7 +746,7 @@ class RagLiteMCPServer {
                                             reject(new Error(`Failed to download image: HTTP ${redirectResponse.statusCode}`));
                                             return;
                                         }
-                                        const fileStream = require('fs').createWriteStream(tempFilePath);
+                                        const fileStream = createWriteStream(tempFilePath);
                                         redirectResponse.pipe(fileStream);
                                         fileStream.on('finish', () => {
                                             fileStream.close();
@@ -761,7 +761,7 @@ class RagLiteMCPServer {
                                 return;
                             }
                             else {
-                                const fileStream = require('fs').createWriteStream(tempFilePath);
+                                const fileStream = createWriteStream(tempFilePath);
                                 response.pipe(fileStream);
                                 fileStream.on('finish', () => {
                                     fileStream.close();
@@ -827,7 +827,7 @@ class RagLiteMCPServer {
                 factoryOptions.rerankingStrategy = 'text-derived'; // Default for multimodal
             }
             // Create and run ingestion pipeline
-            const pipeline = await TextIngestionFactory.create(config.db_file, config.index_file, factoryOptions);
+            const pipeline = await IngestionFactory.create(config.db_file, config.index_file, factoryOptions);
             try {
                 const result = await pipeline.ingestFile(resolvedPath);
                 // Reset search engine initialization flag since index may have changed
@@ -914,10 +914,10 @@ class RagLiteMCPServer {
     async handleRebuildIndex(_args) {
         try {
             // Create ingestion pipeline with force rebuild using factory
-            const pipeline = await TextIngestionFactory.create(config.db_file, config.index_file, { forceRebuild: true });
+            const pipeline = await IngestionFactory.create(config.db_file, config.index_file, { forceRebuild: true });
             try {
-                // Get all documents from database and re-ingest them
-                const db = await openDatabase(config.db_file);
+                // Get all documents from database and re-ingest them - use shared connection
+                const db = await DatabaseConnectionManager.getConnection(config.db_file);
                 try {
                     const documents = await db.all('SELECT DISTINCT source FROM documents ORDER BY source');
                     if (documents.length === 0) {
@@ -971,7 +971,8 @@ class RagLiteMCPServer {
                     };
                 }
                 finally {
-                    await db.close();
+                    // Release instead of close - keeps connection alive for reuse
+                    await DatabaseConnectionManager.releaseConnection(config.db_file);
                 }
             }
             finally {
@@ -995,7 +996,6 @@ class RagLiteMCPServer {
             };
             // Get model information and compatibility status
             const { getModelDefaults } = await import('./config.js');
-            const { getStoredModelInfo } = await import('./core/db.js');
             const currentModel = config.embedding_model;
             const currentDefaults = getModelDefaults(currentModel);
             stats.model_info = {
@@ -1010,15 +1010,15 @@ class RagLiteMCPServer {
             // Check model compatibility if database exists
             if (stats.database_exists) {
                 try {
-                    const db = await openDatabase(config.db_file);
+                    const db = await DatabaseConnectionManager.getConnection(config.db_file);
                     try {
-                        const storedModel = await getStoredModelInfo(db);
-                        if (storedModel) {
-                            stats.model_info.stored_model = storedModel.modelName;
-                            stats.model_info.stored_dimensions = storedModel.dimensions;
+                        const systemInfo = await getSystemInfo(db);
+                        if (systemInfo && systemInfo.modelName && systemInfo.modelDimensions) {
+                            stats.model_info.stored_model = systemInfo.modelName;
+                            stats.model_info.stored_dimensions = systemInfo.modelDimensions;
                             // Check for compatibility issues
-                            const modelMatch = storedModel.modelName === currentModel;
-                            const dimensionMatch = storedModel.dimensions === currentDefaults.dimensions;
+                            const modelMatch = systemInfo.modelName === currentModel;
+                            const dimensionMatch = systemInfo.modelDimensions === currentDefaults.dimensions;
                             stats.model_info.compatibility = {
                                 model_matches: modelMatch,
                                 dimensions_match: dimensionMatch,
@@ -1041,7 +1041,8 @@ class RagLiteMCPServer {
                         stats.total_chunks = chunkCount?.count || 0;
                     }
                     finally {
-                        await db.close();
+                        // Release instead of close - keeps connection alive for reuse
+                        await DatabaseConnectionManager.releaseConnection(config.db_file);
                     }
                 }
                 catch (error) {
@@ -1501,7 +1502,7 @@ class RagLiteMCPServer {
                     };
                     // Add content breakdown if requested
                     if (args.include_content_breakdown) {
-                        const db = await openDatabase(config.db_file);
+                        const db = await DatabaseConnectionManager.getConnection(config.db_file);
                         try {
                             // Get document count by content type
                             const docsByType = await db.all(`
@@ -1527,7 +1528,8 @@ class RagLiteMCPServer {
                             };
                         }
                         finally {
-                            await db.close();
+                            // Release instead of close - keeps connection alive for reuse
+                            await DatabaseConnectionManager.releaseConnection(config.db_file);
                         }
                     }
                     // Add performance metrics if requested
@@ -1572,10 +1574,10 @@ class RagLiteMCPServer {
         try {
             // Validate configuration
             validateCoreConfig(config);
-            // Create search engine using PolymorphicSearchFactory (auto-detects mode)
+            // Create search engine using SearchFactory (auto-detects mode)
             // This will automatically detect the mode from the database and create the appropriate engine
             console.error('🎭 MCP Server: Initializing search engine with automatic mode detection...');
-            this.searchEngine = await PolymorphicSearchFactory.create(config.index_file, config.db_file);
+            this.searchEngine = await SearchFactory.create(config.index_file, config.db_file);
             // Log successful initialization with mode information
             const stats = await this.searchEngine.getStats();
             // Try to get mode information for enhanced logging
@@ -1601,6 +1603,8 @@ class RagLiteMCPServer {
             this.isSearchEngineInitialized = true;
         }
         catch (error) {
+            console.error('❌ MCP Server: Search engine initialization failed');
+            console.error(`❌ Error: ${error instanceof Error ? error.message : String(error)}`);
             // Check if this is a mode detection error
             if (error instanceof Error && error.message.includes('mode detection')) {
                 console.error('⚠️  MCP Server: Mode detection failed, falling back to text mode');
@@ -1613,7 +1617,6 @@ class RagLiteMCPServer {
                 throw error;
             }
             // For other initialization errors, provide a generic wrapper
-            console.error('❌ MCP Server: Search engine initialization failed');
             throw new Error(`Failed to initialize search engine: ${error instanceof Error ? error.message : 'Unknown error'}`);
         }
     }
@@ -1636,8 +1639,8 @@ class RagLiteMCPServer {
             const { ModeDetectionService } = await import('./core/mode-detection-service.js');
             const modeService = new ModeDetectionService(config.db_file);
             const systemInfo = await modeService.detectMode();
-            // Check if database has any images
-            const db = await openDatabase(config.db_file);
+            // Check if database has any images - use shared connection
+            const db = await DatabaseConnectionManager.getConnection(config.db_file);
             let hasImages = false;
             let documentCount = 0;
             try {
@@ -1647,7 +1650,8 @@ class RagLiteMCPServer {
                 documentCount = docCount?.count || 0;
             }
             finally {
-                await db.close();
+                // Release instead of close - keeps connection alive for reuse
+                await DatabaseConnectionManager.releaseConnection(config.db_file);
             }
             return {
                 mode: systemInfo.mode,

package/dist/search.js

@@ -99,8 +99,8 @@ export class SearchEngine {
                 // Use core polymorphic factory for automatic mode detection (Chameleon Architecture)
                 // This enables SearchEngine to automatically adapt to text or multimodal mode
                 // based on the configuration stored in the database during ingestion
-                const { PolymorphicSearchFactory } = await import('./core/polymorphic-search-factory.js');
-                this.coreEngine = await PolymorphicSearchFactory.create(this.indexPath, this.dbPath);
+                const { SearchFactory } = await import('./factories/search-factory.js');
+                this.coreEngine = await SearchFactory.create(this.indexPath, this.dbPath);
             }
         })();
         return this.initPromise;

package/dist/text/embedder.d.ts

@@ -108,15 +108,4 @@ export declare function initializeEmbeddingEngine(modelName?: string, batchSize?
  * @returns EmbedFunction that can be injected into core components
  */
 export declare function createTextEmbedFunction(modelName?: string, batchSize?: number): EmbedFunction;
-/**
- * Create a text embedding engine factory function
- * @param modelName - Optional model name override
- * @param batchSize - Optional batch size override
- * @returns Factory function that creates initialized embedding engines
- */
-export declare function createTextEmbedder(modelName?: string, batchSize?: number): {
-    embedSingle(text: string): Promise<EmbeddingResult>;
-    embedBatch(texts: string[]): Promise<EmbeddingResult[]>;
-    embedDocumentBatch(chunks: string[]): Promise<EmbeddingResult[]>;
-};
 //# sourceMappingURL=embedder.d.ts.map

package/dist/text/embedder.js

@@ -372,26 +372,15 @@ export function createTextEmbedFunction(modelName, batchSize) {
     };
     return embedFunction;
 }
-/**
- * Create a text embedding engine factory function
- * @param modelName - Optional model name override
- * @param batchSize - Optional batch size override
- * @returns Factory function that creates initialized embedding engines
- */
-export function createTextEmbedder(modelName, batchSize) {
-    return {
-        async embedSingle(text) {
-            const engine = await initializeEmbeddingEngine(modelName, batchSize);
-            return engine.embedSingle(text);
-        },
-        async embedBatch(texts) {
-            const engine = await initializeEmbeddingEngine(modelName, batchSize);
-            return engine.embedBatch(texts);
-        },
-        async embedDocumentBatch(chunks) {
-            const engine = await initializeEmbeddingEngine(modelName, batchSize);
-            return engine.embedDocumentBatch(chunks);
-        }
-    };
-}
+// =============================================================================
+// REMOVED: createTextEmbedder() factory object
+// =============================================================================
+// The createTextEmbedder() function has been removed as it was redundant.
+// It was just a wrapper around initializeEmbeddingEngine() that provided no
+// additional value over using the engine directly or using createEmbedder().
+//
+// Migration guide:
+// - For public API: Use createEmbedder() from core/embedder-factory.ts
+// - For dependency injection: Use createTextEmbedFunction()
+// - For direct access: Use initializeEmbeddingEngine() or new EmbeddingEngine()
 //# sourceMappingURL=embedder.js.map

package/dist/text/index.d.ts

@@ -1,5 +1,5 @@
-export { EmbeddingEngine, getEmbeddingEngine, initializeEmbeddingEngine, createTextEmbedFunction, createTextEmbedder } from './embedder.js';
-export { CrossEncoderReranker, createTextRerankFunction, createTextReranker } from './reranker.js';
+export { EmbeddingEngine, getEmbeddingEngine, initializeEmbeddingEngine, createTextEmbedFunction } from './embedder.js';
+export { CrossEncoderReranker, createTextRerankFunction } from './reranker.js';
 export { countTokens, getTokenizer, resetTokenizer } from './tokenizer.js';
 export { chunkDocument, type Chunk, type Document } from '../core/chunker.js';
 export { type ChunkConfig } from '../core/chunker.js';

package/dist/text/index.js

@@ -1,6 +1,6 @@
 // Text implementation layer exports
-export { EmbeddingEngine, getEmbeddingEngine, initializeEmbeddingEngine, createTextEmbedFunction, createTextEmbedder } from './embedder.js';
-export { CrossEncoderReranker, createTextRerankFunction, createTextReranker } from './reranker.js';
+export { EmbeddingEngine, getEmbeddingEngine, initializeEmbeddingEngine, createTextEmbedFunction } from './embedder.js';
+export { CrossEncoderReranker, createTextRerankFunction } from './reranker.js';
 export { countTokens, getTokenizer, resetTokenizer } from './tokenizer.js';
 export { chunkDocument } from '../core/chunker.js';
 export { SentenceTransformerEmbedder } from './sentence-transformer-embedder.js';

package/dist/text/reranker.d.ts

@@ -46,14 +46,4 @@ export declare class CrossEncoderReranker {
     private simpleTextReranking;
 }
 export declare function createTextRerankFunction(modelName?: string): RerankFunction;
-/**
- * Create a text reranker factory function
- * @param modelName - Optional model name override
- * @returns Factory function that creates initialized rerankers
- */
-export declare function createTextReranker(modelName?: string): {
-    rerank(query: string, results: SearchResult[]): Promise<SearchResult[]>;
-    loadModel(): Promise<void>;
-    isLoaded(): boolean;
-};
 //# sourceMappingURL=reranker.d.ts.map

package/dist/text/reranker.js

@@ -261,37 +261,14 @@ export function createTextRerankFunction(modelName) {
     };
     return rerankFunction;
 }
-/**
- * Create a text reranker factory function
- * @param modelName - Optional model name override
- * @returns Factory function that creates initialized rerankers
- */
-export function createTextReranker(modelName) {
-    return {
-        async rerank(query, results) {
-            const reranker = new CrossEncoderReranker();
-            if (modelName) {
-                reranker.modelName = modelName;
-            }
-            await reranker.loadModel();
-            if (!reranker.isLoaded()) {
-                console.warn('Text reranker not loaded, returning results unchanged');
-                return results;
-            }
-            return reranker.rerank(query, results);
-        },
-        async loadModel() {
-            const reranker = new CrossEncoderReranker();
-            if (modelName) {
-                reranker.modelName = modelName;
-            }
-            await reranker.loadModel();
-        },
-        isLoaded() {
-            // For the factory version, we create new instances each time
-            // so we can't track loaded state
-            return true;
-        }
-    };
-}
+// =============================================================================
+// REMOVED IN v3.0.0: createTextReranker() factory object
+// =============================================================================
+// The createTextReranker() function has been removed as it was redundant.
+// It was just a wrapper that created new CrossEncoderReranker instances.
+//
+// Migration guide:
+// - For public API: Use createReranker() from core/reranking-factory.ts
+// - For dependency injection: Use createTextRerankFunction()
+// - For direct access: Use new CrossEncoderReranker() directly
 //# sourceMappingURL=reranker.js.map