rag-lite-ts 1.0.1

package/dist/embedder.js

@@ -0,0 +1,323 @@
+import { pipeline } from '@huggingface/transformers';
+import { createHash } from 'crypto';
+import { config } from './config.js';
+import { handleError, ErrorCategory, ErrorSeverity, safeExecute } from './error-handler.js';
+/**
+ * List of supported embedding models
+ */
+const SUPPORTED_MODELS = [
+    'sentence-transformers/all-MiniLM-L6-v2',
+    'Xenova/all-mpnet-base-v2'
+];
+/**
+ * Embedding engine using transformers.js for generating embeddings
+ */
+export class EmbeddingEngine {
+    model = null;
+    modelVersion = null;
+    modelName;
+    batchSize;
+    constructor(modelName, batchSize) {
+        this.modelName = modelName || config.embedding_model;
+        this.batchSize = batchSize || config.batch_size;
+        // Validate that the model is supported
+        if (!SUPPORTED_MODELS.includes(this.modelName)) {
+            throw new Error(`Unsupported model: ${this.modelName}\n` +
+                `Supported models: ${SUPPORTED_MODELS.join(', ')}`);
+        }
+        console.log(`🤖 EmbeddingEngine initialized with model: ${this.modelName}, batchSize: ${this.batchSize}`);
+    }
+    /**
+     * Load the embedding model
+     * @throws {Error} If model loading fails
+     */
+    async loadModel() {
+        await safeExecute(async () => {
+            console.log(`Loading embedding model: ${this.modelName}`);
+            // Initialize the feature extraction pipeline
+            // Let transformers.js handle model caching automatically
+            try {
+                this.model = await pipeline('feature-extraction', this.modelName, {
+                    cache_dir: config.model_cache_path,
+                    local_files_only: false,
+                    dtype: 'fp32' // Explicitly specify dtype to suppress warning
+                });
+            }
+            catch (error) {
+                // Enhanced error handling for model download failures
+                if (error instanceof Error && (error.message.includes('network') ||
+                    error.message.includes('download') ||
+                    error.message.includes('fetch') ||
+                    error.message.includes('ENOTFOUND') ||
+                    error.message.includes('ECONNREFUSED') ||
+                    error.message.includes('timeout'))) {
+                    throw new Error(`Failed to download model '${this.modelName}'. ` +
+                        `Check your internet connection or see models/README.md for offline setup instructions.`);
+                }
+                throw error;
+            }
+            // Generate model version hash
+            this.modelVersion = this.generateModelVersion();
+            console.log(`Model loaded successfully. Version: ${this.modelVersion}`);
+        }, 'Model Loading', {
+            category: ErrorCategory.MODEL,
+            severity: ErrorSeverity.FATAL,
+            exitCode: 6
+        });
+    }
+    /**
+     * Generate embeddings for a batch of texts
+     * @param texts - Array of text strings to embed
+     * @returns Promise resolving to array of embedding results
+     */
+    async embedBatch(texts) {
+        if (!this.model) {
+            throw new Error('Model not loaded. Call loadModel() first.');
+        }
+        if (texts.length === 0) {
+            return [];
+        }
+        // Split into smaller batches based on configured batch size
+        const results = [];
+        for (let i = 0; i < texts.length; i += this.batchSize) {
+            const batch = texts.slice(i, i + this.batchSize);
+            const batchResults = await this.processBatchWithErrorHandling(batch, i);
+            results.push(...batchResults);
+        }
+        return results;
+    }
+    /**
+     * Process a single batch with error handling for individual chunks
+     * @param batch - Array of text strings in this batch
+     * @param startIndex - Starting index for this batch in the original array
+     * @returns Promise resolving to array of embedding results
+     */
+    async processBatchWithErrorHandling(batch, startIndex) {
+        return await safeExecute(async () => {
+            // Try to process the entire batch first
+            const embeddings = await this.model(batch, {
+                pooling: 'mean',
+                normalize: true
+            });
+            // Convert to EmbeddingResult format
+            const results = [];
+            const embeddingData = embeddings.tolist();
+            for (let i = 0; i < batch.length; i++) {
+                const embedding_id = this.generateEmbeddingId(batch[i], startIndex + i);
+                const vector = new Float32Array(embeddingData[i]);
+                results.push({
+                    embedding_id,
+                    vector
+                });
+            }
+            return results;
+        }, `Batch Embedding (${batch.length} chunks)`, {
+            category: ErrorCategory.EMBEDDING,
+            severity: ErrorSeverity.ERROR,
+            skipError: true,
+            fallbackValue: []
+        }) || await this.fallbackToIndividualProcessing(batch, startIndex);
+    }
+    /**
+     * Fallback to individual chunk processing when batch fails
+     */
+    async fallbackToIndividualProcessing(batch, startIndex) {
+        handleError(`Batch processing failed for ${batch.length} chunks, falling back to individual processing`, 'Embedding Batch Processing', {
+            category: ErrorCategory.EMBEDDING,
+            severity: ErrorSeverity.WARNING,
+            skipError: true
+        });
+        const results = [];
+        for (let i = 0; i < batch.length; i++) {
+            const singleResult = await safeExecute(() => this.processSingleChunk(batch[i], startIndex + i), `Individual Chunk Embedding (${startIndex + i})`, {
+                category: ErrorCategory.EMBEDDING,
+                severity: ErrorSeverity.WARNING,
+                skipError: true
+            });
+            if (singleResult) {
+                results.push(singleResult);
+            }
+        }
+        return results;
+    }
+    /**
+     * Process a single chunk with error handling
+     * @param text - Text to embed
+     * @param index - Index of this chunk
+     * @returns Promise resolving to embedding result or null if failed
+     */
+    async processSingleChunk(text, index) {
+        try {
+            const embeddings = await this.model([text], {
+                pooling: 'mean',
+                normalize: true
+            });
+            const embeddingData = embeddings.tolist();
+            const embedding_id = this.generateEmbeddingId(text, index);
+            const vector = new Float32Array(embeddingData[0]);
+            return {
+                embedding_id,
+                vector
+            };
+        }
+        catch (error) {
+            // Return null to indicate failure
+            throw error;
+        }
+    }
+    /**
+     * Generate embedding for a single text
+     * @param text - Text string to embed
+     * @returns Promise resolving to embedding result
+     */
+    async embedSingle(text) {
+        const results = await this.embedBatch([text]);
+        if (results.length === 0) {
+            throw new Error('Failed to generate embedding for single text');
+        }
+        return results[0];
+    }
+    /**
+     * Generate embeddings for document chunks with progress logging
+     * Optimized for large document ingestion with batch processing
+     * @param chunks - Array of text chunks from documents
+     * @returns Promise resolving to array of embedding results
+     */
+    async embedDocumentBatch(chunks) {
+        if (!this.model) {
+            throw new Error('Model not loaded. Call loadModel() first.');
+        }
+        if (chunks.length === 0) {
+            return [];
+        }
+        console.log(`Processing ${chunks.length} chunk${chunks.length === 1 ? '' : 's'} in batches of ${this.batchSize}...`);
+        const results = [];
+        const totalBatches = Math.ceil(chunks.length / this.batchSize);
+        let processedChunks = 0;
+        let skippedChunks = 0;
+        for (let batchIndex = 0; batchIndex < totalBatches; batchIndex++) {
+            const startIdx = batchIndex * this.batchSize;
+            const endIdx = Math.min(startIdx + this.batchSize, chunks.length);
+            const batch = chunks.slice(startIdx, endIdx);
+            try {
+                const batchResults = await this.processBatchWithErrorHandling(batch, startIdx);
+                results.push(...batchResults);
+                processedChunks += batchResults.length;
+                skippedChunks += (batch.length - batchResults.length);
+                // Progress logging - more frequent updates for better user experience
+                const progressInterval = Math.max(1, Math.floor(totalBatches / 20)); // Show progress every 5%
+                if ((batchIndex + 1) % progressInterval === 0 || batchIndex === totalBatches - 1) {
+                    const percentage = Math.round(((batchIndex + 1) / totalBatches) * 100);
+                    console.log(`Processed ${processedChunks} of ${chunks.length} chunks (${percentage}%)${skippedChunks > 0 ? ` - ${skippedChunks} skipped` : ''}`);
+                }
+            }
+            catch (error) {
+                console.error(`Failed to process batch ${batchIndex + 1}/${totalBatches}:`, error instanceof Error ? error.message : String(error));
+                skippedChunks += batch.length;
+            }
+        }
+        if (skippedChunks > 0) {
+            console.log(`✓ Embedding complete: ${processedChunks} successful, ${skippedChunks} skipped due to errors`);
+        }
+        else {
+            console.log(`✓ Embedding complete: ${processedChunks} chunks processed successfully`);
+        }
+        return results;
+    }
+    /**
+     * Get the current model version identifier
+     * @returns Model version string
+     */
+    getModelVersion() {
+        if (!this.modelVersion) {
+            throw new Error('Model not loaded. Call loadModel() first.');
+        }
+        return this.modelVersion;
+    }
+    /**
+     * Check if the model is loaded
+     * @returns True if model is loaded
+     */
+    isLoaded() {
+        return this.model !== null;
+    }
+    /**
+     * Get the model name
+     * @returns Model name string
+     */
+    getModelName() {
+        return this.modelName;
+    }
+    /**
+     * Get the batch size
+     * @returns Batch size number
+     */
+    getBatchSize() {
+        return this.batchSize;
+    }
+    /**
+     * Generate a deterministic model version identifier
+     * Uses model name and configuration for consistent versioning
+     * @returns Model version string
+     */
+    generateModelVersion() {
+        // Create a deterministic hash based on model name and configuration
+        // This ensures the same model configuration always produces the same version
+        const configData = JSON.stringify({
+            model: this.modelName,
+            // Add other relevant config that affects embeddings
+            quantized: false,
+            revision: 'main'
+        });
+        const hash = createHash('sha256').update(configData).digest('hex').substring(0, 16);
+        return `${this.modelName.replace('/', '_')}_${hash}`;
+    }
+    /**
+     * Generate a deterministic embedding ID for a text chunk
+     * @param text - The text content
+     * @param index - Index in the batch
+     * @returns Deterministic embedding ID
+     */
+    generateEmbeddingId(text, index) {
+        // Create deterministic ID based on content hash only
+        // This ensures the same text always gets the same ID regardless of processing order
+        const contentHash = createHash('sha256').update(text.trim()).digest('hex');
+        return contentHash.substring(0, 32);
+    }
+}
+/**
+ * Singleton instance for the embedding engine
+ * Ensures model is loaded only once across the application
+ */
+let embeddingEngineInstance = null;
+/**
+ * Get the singleton embedding engine instance
+ * @param modelName - Optional model name override
+ * @param batchSize - Optional batch size override
+ * @returns EmbeddingEngine instance
+ */
+export function getEmbeddingEngine(modelName, batchSize) {
+    // Always create a new instance if specific parameters are provided
+    // This ensures we don't use cached instances with wrong configuration
+    if (modelName || batchSize) {
+        embeddingEngineInstance = new EmbeddingEngine(modelName, batchSize);
+    }
+    else if (!embeddingEngineInstance) {
+        embeddingEngineInstance = new EmbeddingEngine();
+    }
+    return embeddingEngineInstance;
+}
+/**
+ * Initialize the embedding engine and load the model
+ * @param modelName - Optional model name override
+ * @param batchSize - Optional batch size override
+ * @returns Promise resolving to the loaded embedding engine
+ */
+export async function initializeEmbeddingEngine(modelName, batchSize) {
+    const engine = getEmbeddingEngine(modelName, batchSize);
+    if (!engine.isLoaded()) {
+        await engine.loadModel();
+    }
+    return engine;
+}
+//# sourceMappingURL=embedder.js.map

package/dist/embedder.js.map

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

package/dist/error-handler.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Centralized error handling utilities for RAG-lite TS
+ * Provides consistent error handling patterns across the application
+ */
+/**
+ * Error categories for different types of failures
+ */
+export declare enum ErrorCategory {
+    CONFIGURATION = "Configuration",
+    DATABASE = "Database",
+    MODEL = "Model",
+    INDEX = "Index",
+    FILE_SYSTEM = "File System",
+    EMBEDDING = "Embedding",
+    NETWORK = "Network",
+    VALIDATION = "Validation",
+    GENERAL = "General"
+}
+/**
+ * Error severity levels
+ */
+export declare enum ErrorSeverity {
+    FATAL = "FATAL",// System must exit immediately
+    ERROR = "ERROR",// Operation failed but system can continue
+    WARNING = "WARNING",// Potential issue but operation can continue
+    INFO = "INFO"
+}
+/**
+ * Enhanced error class with category and severity
+ */
+export declare class CategorizedError extends Error {
+    category: ErrorCategory;
+    severity: ErrorSeverity;
+    exitCode: number;
+    originalError?: Error | undefined;
+    constructor(message: string, category: ErrorCategory, severity?: ErrorSeverity, exitCode?: number, originalError?: Error | undefined);
+}
+/**
+ * Handle errors with appropriate logging and exit behavior
+ * @param error - Error to handle
+ * @param context - Context where error occurred
+ * @param options - Handling options
+ */
+export declare function handleError(error: Error | string, context: string, options?: {
+    category?: ErrorCategory;
+    severity?: ErrorSeverity;
+    exitCode?: number;
+    skipError?: boolean;
+    showStack?: boolean;
+}): void;
+/**
+ * Wrapper for try-catch blocks with consistent error handling
+ * @param operation - Function to execute
+ * @param context - Context description
+ * @param options - Error handling options
+ */
+export declare function safeExecute<T>(operation: () => Promise<T> | T, context: string, options?: {
+    category?: ErrorCategory;
+    severity?: ErrorSeverity;
+    exitCode?: number;
+    skipError?: boolean;
+    fallbackValue?: T;
+}): Promise<T | undefined>;
+/**
+ * Validate that a condition is true, throw categorized error if not
+ * @param condition - Condition to check
+ * @param message - Error message if condition fails
+ * @param category - Error category
+ * @param exitCode - Exit code for fatal errors
+ */
+export declare function assert(condition: boolean, message: string, category?: ErrorCategory, exitCode?: number): asserts condition;
+/**
+ * Log progress with error context
+ * @param message - Progress message
+ * @param current - Current progress value
+ * @param total - Total progress value
+ */
+export declare function logProgress(message: string, current?: number, total?: number): void;
+/**
+ * Create a categorized error for common scenarios
+ */
+export declare const createError: {
+    configuration: (message: string, exitCode?: 3) => CategorizedError;
+    database: (message: string, exitCode?: 5) => CategorizedError;
+    model: (message: string, exitCode?: 6) => CategorizedError;
+    index: (message: string, exitCode?: 7) => CategorizedError;
+    fileSystem: (message: string, exitCode?: 4) => CategorizedError;
+    embedding: (message: string, severity?: ErrorSeverity) => CategorizedError;
+    validation: (message: string, exitCode?: 2) => CategorizedError;
+};
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../src/error-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,oBAAY,aAAa;IACvB,aAAa,kBAAkB;IAC/B,QAAQ,aAAa;IACrB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,WAAW,gBAAgB;IAC3B,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,oBAAY,aAAa;IACvB,KAAK,UAAU,CAAO,+BAA+B;IACrD,KAAK,UAAU,CAAO,2CAA2C;IACjE,OAAO,YAAY,CAAG,6CAA6C;IACnE,IAAI,SAAS;CACd;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IAGhC,QAAQ,EAAE,aAAa;IACvB,QAAQ,EAAE,aAAa;IACvB,QAAQ,EAAE,MAAM;IAChB,aAAa,CAAC,EAAE,KAAK;gBAJ5B,OAAO,EAAE,MAAM,EACR,QAAQ,EAAE,aAAa,EACvB,QAAQ,GAAE,aAAmC,EAC7C,QAAQ,GAAE,MAAiC,EAC3C,aAAa,CAAC,EAAE,KAAK,YAAA;CAK/B;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,KAAK,GAAG,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CAChB,GACL,IAAI,CAsCN;AA4DD;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAC/B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,CAAC,CAAC;CACd,GACL,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAqBxB;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CACpB,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,aAAwC,EAClD,QAAQ,GAAE,MAAiC,GAC1C,OAAO,CAAC,SAAS,CAInB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAUnF;AAED;;GAEG;AACH,eAAO,MAAM,WAAW;6BACG,MAAM;wBAGX,MAAM;qBAGT,MAAM;qBAGN,MAAM;0BAGD,MAAM;yBAGP,MAAM;0BAGL,MAAM;CAE7B,CAAC"}

package/dist/error-handler.js

@@ -0,0 +1,196 @@
+/**
+ * Centralized error handling utilities for RAG-lite TS
+ * Provides consistent error handling patterns across the application
+ */
+import { EXIT_CODES } from './config.js';
+/**
+ * Error categories for different types of failures
+ */
+export var ErrorCategory;
+(function (ErrorCategory) {
+    ErrorCategory["CONFIGURATION"] = "Configuration";
+    ErrorCategory["DATABASE"] = "Database";
+    ErrorCategory["MODEL"] = "Model";
+    ErrorCategory["INDEX"] = "Index";
+    ErrorCategory["FILE_SYSTEM"] = "File System";
+    ErrorCategory["EMBEDDING"] = "Embedding";
+    ErrorCategory["NETWORK"] = "Network";
+    ErrorCategory["VALIDATION"] = "Validation";
+    ErrorCategory["GENERAL"] = "General";
+})(ErrorCategory || (ErrorCategory = {}));
+/**
+ * Error severity levels
+ */
+export var ErrorSeverity;
+(function (ErrorSeverity) {
+    ErrorSeverity["FATAL"] = "FATAL";
+    ErrorSeverity["ERROR"] = "ERROR";
+    ErrorSeverity["WARNING"] = "WARNING";
+    ErrorSeverity["INFO"] = "INFO"; // Informational message
+})(ErrorSeverity || (ErrorSeverity = {}));
+/**
+ * Enhanced error class with category and severity
+ */
+export class CategorizedError extends Error {
+    category;
+    severity;
+    exitCode;
+    originalError;
+    constructor(message, category, severity = ErrorSeverity.ERROR, exitCode = EXIT_CODES.GENERAL_ERROR, originalError) {
+        super(message);
+        this.category = category;
+        this.severity = severity;
+        this.exitCode = exitCode;
+        this.originalError = originalError;
+        this.name = 'CategorizedError';
+    }
+}
+/**
+ * Handle errors with appropriate logging and exit behavior
+ * @param error - Error to handle
+ * @param context - Context where error occurred
+ * @param options - Handling options
+ */
+export function handleError(error, context, options = {}) {
+    const { category = ErrorCategory.GENERAL, severity = ErrorSeverity.ERROR, exitCode = EXIT_CODES.GENERAL_ERROR, skipError = false, showStack = false } = options;
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    const timestamp = new Date().toISOString();
+    // Format error message based on severity
+    const severityPrefix = severity === ErrorSeverity.FATAL ? '🚨' :
+        severity === ErrorSeverity.ERROR ? '❌' :
+            severity === ErrorSeverity.WARNING ? '⚠️' : 'ℹ️';
+    const logMessage = `${severityPrefix} [${timestamp}] ${severity} in ${context} (${category}): ${errorMessage}`;
+    if (severity === ErrorSeverity.FATAL || severity === ErrorSeverity.ERROR) {
+        console.error(logMessage);
+    }
+    else {
+        console.log(logMessage);
+    }
+    // Show stack trace for debugging if requested
+    if (showStack && error instanceof Error && error.stack) {
+        console.error('Stack trace:', error.stack);
+    }
+    // Handle based on severity
+    if (severity === ErrorSeverity.FATAL) {
+        console.error('\nThe system cannot continue and will exit immediately.');
+        provideContextualGuidance(category, exitCode);
+        process.exit(exitCode);
+    }
+    else if (severity === ErrorSeverity.ERROR && !skipError) {
+        console.error('Operation failed. See error details above.');
+    }
+}
+/**
+ * Provide contextual guidance based on error category and exit code
+ */
+function provideContextualGuidance(category, exitCode) {
+    console.error('\nTroubleshooting guidance:');
+    switch (category) {
+        case ErrorCategory.CONFIGURATION:
+            console.error('- Check your configuration file for syntax errors');
+            console.error('- Ensure all required fields are present and valid');
+            console.error('- Verify numeric values are positive numbers');
+            break;
+        case ErrorCategory.DATABASE:
+            console.error('- Try running "raglite rebuild" to fix database issues');
+            console.error('- Check that the database file is not locked by another process');
+            console.error('- Ensure you have write permissions in the current directory');
+            console.error('- Verify sufficient disk space is available');
+            break;
+        case ErrorCategory.MODEL:
+            console.error('- Ensure you have internet connection for model download');
+            console.error('- Check available disk space in the models directory');
+            console.error('- Try clearing the model cache and downloading again');
+            console.error('- Verify your system has sufficient memory (2GB+ recommended)');
+            break;
+        case ErrorCategory.INDEX:
+            console.error('- Try running "raglite rebuild" to recreate the vector index');
+            console.error('- Check available disk space for index files');
+            console.error('- Ensure the index file is not corrupted or locked');
+            break;
+        case ErrorCategory.FILE_SYSTEM:
+            console.error('- Check that files and directories exist and are accessible');
+            console.error('- Verify you have read/write permissions');
+            console.error('- Ensure paths are spelled correctly');
+            break;
+        case ErrorCategory.EMBEDDING:
+            console.error('- Check that the embedding model is properly loaded');
+            console.error('- Verify input text is not empty or malformed');
+            console.error('- Ensure sufficient memory for batch processing');
+            break;
+        case ErrorCategory.NETWORK:
+            console.error('- Check your internet connection');
+            console.error('- Verify firewall settings allow model downloads');
+            console.error('- Try again later if servers are temporarily unavailable');
+            break;
+        default:
+            console.error('- Check the error message above for specific details');
+            console.error('- Try running the command again');
+            console.error('- If the problem persists, please report it as a bug');
+    }
+}
+/**
+ * Wrapper for try-catch blocks with consistent error handling
+ * @param operation - Function to execute
+ * @param context - Context description
+ * @param options - Error handling options
+ */
+export async function safeExecute(operation, context, options = {}) {
+    try {
+        return await operation();
+    }
+    catch (error) {
+        handleError(error, context, options);
+        if (options.fallbackValue !== undefined) {
+            return options.fallbackValue;
+        }
+        if (options.skipError) {
+            return undefined;
+        }
+        // Re-throw if not skipping and no fallback
+        if (options.severity !== ErrorSeverity.FATAL) {
+            throw error;
+        }
+        return undefined; // This won't be reached due to process.exit in FATAL
+    }
+}
+/**
+ * Validate that a condition is true, throw categorized error if not
+ * @param condition - Condition to check
+ * @param message - Error message if condition fails
+ * @param category - Error category
+ * @param exitCode - Exit code for fatal errors
+ */
+export function assert(condition, message, category = ErrorCategory.VALIDATION, exitCode = EXIT_CODES.GENERAL_ERROR) {
+    if (!condition) {
+        throw new CategorizedError(message, category, ErrorSeverity.FATAL, exitCode);
+    }
+}
+/**
+ * Log progress with error context
+ * @param message - Progress message
+ * @param current - Current progress value
+ * @param total - Total progress value
+ */
+export function logProgress(message, current, total) {
+    const timestamp = new Date().toISOString();
+    let progressMsg = `ℹ️ [${timestamp}] ${message}`;
+    if (current !== undefined && total !== undefined) {
+        const percentage = Math.round((current / total) * 100);
+        progressMsg += ` (${current}/${total} - ${percentage}%)`;
+    }
+    console.log(progressMsg);
+}
+/**
+ * Create a categorized error for common scenarios
+ */
+export const createError = {
+    configuration: (message, exitCode = EXIT_CODES.CONFIGURATION_ERROR) => new CategorizedError(message, ErrorCategory.CONFIGURATION, ErrorSeverity.FATAL, exitCode),
+    database: (message, exitCode = EXIT_CODES.DATABASE_ERROR) => new CategorizedError(message, ErrorCategory.DATABASE, ErrorSeverity.FATAL, exitCode),
+    model: (message, exitCode = EXIT_CODES.MODEL_ERROR) => new CategorizedError(message, ErrorCategory.MODEL, ErrorSeverity.FATAL, exitCode),
+    index: (message, exitCode = EXIT_CODES.INDEX_ERROR) => new CategorizedError(message, ErrorCategory.INDEX, ErrorSeverity.FATAL, exitCode),
+    fileSystem: (message, exitCode = EXIT_CODES.FILE_NOT_FOUND) => new CategorizedError(message, ErrorCategory.FILE_SYSTEM, ErrorSeverity.FATAL, exitCode),
+    embedding: (message, severity = ErrorSeverity.ERROR) => new CategorizedError(message, ErrorCategory.EMBEDDING, severity),
+    validation: (message, exitCode = EXIT_CODES.INVALID_ARGUMENTS) => new CategorizedError(message, ErrorCategory.VALIDATION, ErrorSeverity.FATAL, exitCode)
+};
+//# sourceMappingURL=error-handler.js.map

package/dist/error-handler.js.map

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