captify 0.1.17 → 0.1.19

package/dist/search/services/embedding.service.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Embedding Service
+ *
+ * Generates vector embeddings using Amazon Bedrock Titan Embeddings
+ * for semantic search capabilities.
+ */
+import { BaseAwsService } from "../../shared/services/base-aws-service";
+import type { UserAwsCredentials } from "../../shared/services/services.interfaces";
+import type { EmbeddingCacheStats, EmbeddingServiceDeps } from "../search.interfaces";
+/**
+ * Service for generating text embeddings using Amazon Bedrock
+ */
+export declare class EmbeddingService extends BaseAwsService {
+    private readonly region;
+    /** Default client for service account (no user credentials) */
+    private defaultClient;
+    /** LRU cache for embeddings */
+    private readonly embeddingCache;
+    /** Cache statistics */
+    private cacheHits;
+    private cacheMisses;
+    /** Metrics logging interval */
+    private metricsInterval;
+    constructor(deps?: EmbeddingServiceDeps);
+    /**
+     * Get Bedrock client for operation
+     * Creates new client with user credentials when provided
+     */
+    private getClient;
+    /**
+     * Normalize cache key: lowercase, trim, and truncate to max length
+     */
+    private normalizeCacheKey;
+    /**
+     * Get cached embedding if available and not expired
+     */
+    private getCachedEmbedding;
+    /**
+     * Store embedding in cache with LRU eviction
+     */
+    private setCachedEmbedding;
+    /**
+     * Generate embedding for a single text
+     * @throws EmptyTextError if text is empty or whitespace-only
+     */
+    generateEmbedding(text: string, userCredentials?: UserAwsCredentials): Promise<number[]>;
+    /**
+     * Generate embeddings for multiple texts (batched)
+     * Uses Promise.allSettled for resilience - partial results are returned if some fail
+     * @returns Array of embeddings (null for failed texts)
+     */
+    generateEmbeddings(texts: string[], userCredentials?: UserAwsCredentials): Promise<(number[] | null)[]>;
+    /**
+     * Create searchable text from document fields
+     * Combines relevant fields for embedding generation
+     */
+    static createSearchableText(doc: {
+        title?: string;
+        name?: string;
+        description?: string;
+        content?: string;
+        instructions?: string;
+    }): string;
+    /**
+     * Get embedding dimensions (for index mapping)
+     */
+    static getDimensions(): number;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): EmbeddingCacheStats;
+    /**
+     * Start periodic metrics logging for cache performance monitoring
+     */
+    private startMetricsLogging;
+    /**
+     * Log cache performance metrics
+     */
+    private logCacheMetrics;
+    /**
+     * Clear the embedding cache.
+     * Useful for manual cache invalidation.
+     */
+    clearCache(): void;
+    /**
+     * Close the service and clean up default client
+     */
+    close(): void;
+}
+export declare function getEmbeddingService(): EmbeddingService;
+export declare function clearEmbeddingService(): void;
+//# sourceMappingURL=embedding.service.d.ts.map

package/dist/search/services/embedding.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding.service.d.ts","sourceRoot":"","sources":["../../../lib/search/services/embedding.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAQpF,OAAO,KAAK,EAEV,mBAAmB,EACnB,oBAAoB,EAErB,MAAM,gCAAgC,CAAC;AAExC;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,+DAA+D;IAC/D,OAAO,CAAC,aAAa,CAAqC;IAE1D,+BAA+B;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA+C;IAE9E,uBAAuB;IACvB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,WAAW,CAAK;IAExB,+BAA+B;IAC/B,OAAO,CAAC,eAAe,CAA+C;gBAE1D,IAAI,GAAE,oBAAyB;IAa3C;;;OAGG;IACH,OAAO,CAAC,SAAS;IAiBjB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAsB1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyB1B;;;OAGG;IACG,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA2E9F;;;;OAIG;IACG,kBAAkB,CACtB,KAAK,EAAE,MAAM,EAAE,EACf,eAAe,CAAC,EAAE,kBAAkB,GACnC,OAAO,CAAC,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;IA2B/B;;;OAGG;IACH,MAAM,CAAC,oBAAoB,CAAC,GAAG,EAAE;QAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,MAAM;IAQV;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,MAAM;IAI9B;;OAEG;IACH,aAAa,IAAI,mBAAmB;IAYpC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAcvB;;;OAGG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,KAAK,IAAI,IAAI;CAed;AAKD,wBAAgB,mBAAmB,IAAI,gBAAgB,CAKtD;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAK5C"}

package/dist/search/services/embedding.service.js

@@ -0,0 +1,284 @@
+/**
+ * Embedding Service
+ *
+ * Generates vector embeddings using Amazon Bedrock Titan Embeddings
+ * for semantic search capabilities.
+ */
+import { BedrockRuntimeClient, InvokeModelCommand } from "@aws-sdk/client-bedrock-runtime";
+import { BaseAwsService } from "../../shared/services/base-aws-service";
+import { EMBEDDING_CACHE_CONFIG, EMBEDDING_CONFIG, SEARCH_METRICS_CONFIG, } from "../search.constants";
+import { EmptyTextError, MissingRegionError } from "../search.errors";
+/**
+ * Service for generating text embeddings using Amazon Bedrock
+ */
+export class EmbeddingService extends BaseAwsService {
+    constructor(deps = {}) {
+        var _a;
+        super({ logger: deps.logger, serviceName: "EmbeddingService" });
+        /** Default client for service account (no user credentials) */
+        this.defaultClient = null;
+        /** LRU cache for embeddings */
+        this.embeddingCache = new Map();
+        /** Cache statistics */
+        this.cacheHits = 0;
+        this.cacheMisses = 0;
+        /** Metrics logging interval */
+        this.metricsInterval = null;
+        const region = (_a = deps.region) !== null && _a !== void 0 ? _a : process.env.AWS_REGION;
+        if (!region) {
+            throw new MissingRegionError();
+        }
+        this.region = region;
+        // Start periodic metrics logging
+        this.startMetricsLogging();
+    }
+    /**
+     * Get Bedrock client for operation
+     * Creates new client with user credentials when provided
+     */
+    getClient(userCredentials) {
+        const credentials = this.getAwsCredentials(userCredentials);
+        if (!credentials) {
+            if (!this.defaultClient) {
+                this.defaultClient = new BedrockRuntimeClient({ region: this.region });
+            }
+            return this.defaultClient;
+        }
+        // Create a new client with user's temporary credentials
+        return new BedrockRuntimeClient({
+            region: this.region,
+            credentials,
+        });
+    }
+    /**
+     * Normalize cache key: lowercase, trim, and truncate to max length
+     */
+    normalizeCacheKey(text) {
+        return text.toLowerCase().trim().slice(0, EMBEDDING_CACHE_CONFIG.CACHE_KEY_MAX_LENGTH);
+    }
+    /**
+     * Get cached embedding if available and not expired
+     */
+    getCachedEmbedding(cacheKey) {
+        const cached = this.embeddingCache.get(cacheKey);
+        if (!cached) {
+            return null;
+        }
+        const now = Date.now();
+        const age = now - cached.cachedAt;
+        // Check if cache entry is expired
+        if (age >= EMBEDDING_CACHE_CONFIG.TTL_MS) {
+            this.embeddingCache.delete(cacheKey);
+            return null;
+        }
+        // Update access order for LRU (re-insert at end)
+        this.embeddingCache.delete(cacheKey);
+        this.embeddingCache.set(cacheKey, cached);
+        return cached.embedding;
+    }
+    /**
+     * Store embedding in cache with LRU eviction
+     */
+    setCachedEmbedding(cacheKey, embedding) {
+        const now = Date.now();
+        // Add to cache
+        this.embeddingCache.set(cacheKey, {
+            embedding,
+            cachedAt: now,
+        });
+        // Evict oldest entries if cache exceeds max size
+        if (this.embeddingCache.size > EMBEDDING_CACHE_CONFIG.MAX_CACHE_SIZE) {
+            const entriesToEvict = this.embeddingCache.size - EMBEDDING_CACHE_CONFIG.MAX_CACHE_SIZE;
+            const keys = Array.from(this.embeddingCache.keys());
+            for (let i = 0; i < entriesToEvict; i++) {
+                this.embeddingCache.delete(keys[i]);
+            }
+            this.logger.debug("Evicted LRU cache entries", {
+                evictedCount: entriesToEvict,
+                remainingCount: this.embeddingCache.size,
+            });
+        }
+    }
+    /**
+     * Generate embedding for a single text
+     * @throws EmptyTextError if text is empty or whitespace-only
+     */
+    async generateEmbedding(text, userCredentials) {
+        if (!(text === null || text === void 0 ? void 0 : text.trim())) {
+            const receivedValue = text === null
+                ? "null"
+                : text === undefined
+                    ? "undefined"
+                    : `empty string (length: ${text.length})`;
+            this.logger.error("Empty text provided for embedding - this indicates a caller bug", {
+                receivedText: receivedValue,
+            });
+            throw new EmptyTextError();
+        }
+        // Truncate text if too long (Titan has 8k token limit)
+        const truncatedText = text.slice(0, EMBEDDING_CONFIG.MAX_TEXT_LENGTH);
+        if (text.length > EMBEDDING_CONFIG.MAX_TEXT_LENGTH) {
+            this.logger.warn("Text truncated for embedding generation", {
+                originalLength: text.length,
+                truncatedLength: truncatedText.length,
+                maxLength: EMBEDDING_CONFIG.MAX_TEXT_LENGTH,
+            });
+        }
+        // Check cache first
+        const cacheKey = this.normalizeCacheKey(truncatedText);
+        const cachedEmbedding = this.getCachedEmbedding(cacheKey);
+        if (cachedEmbedding) {
+            this.cacheHits++;
+            this.logger.debug("Embedding cache hit", {
+                textLength: truncatedText.length,
+                cacheKey: cacheKey.slice(0, 50),
+            });
+            return cachedEmbedding;
+        }
+        // Cache miss - generate new embedding
+        this.cacheMisses++;
+        const client = this.getClient(userCredentials);
+        const embedding = await this.executeWithRetry(async () => {
+            const response = await client.send(new InvokeModelCommand({
+                modelId: EMBEDDING_CONFIG.MODEL_ID,
+                contentType: "application/json",
+                accept: "application/json",
+                body: JSON.stringify({
+                    inputText: truncatedText,
+                    dimensions: EMBEDDING_CONFIG.DIMENSIONS,
+                    normalize: true,
+                }),
+            }));
+            const responseBody = JSON.parse(new globalThis.TextDecoder().decode(response.body));
+            this.logger.debug("Generated embedding", {
+                textLength: truncatedText.length,
+                tokenCount: responseBody.inputTextTokenCount,
+                embeddingDimensions: responseBody.embedding.length,
+            });
+            return responseBody.embedding;
+        });
+        // Store in cache
+        this.setCachedEmbedding(cacheKey, embedding);
+        return embedding;
+    }
+    /**
+     * Generate embeddings for multiple texts (batched)
+     * Uses Promise.allSettled for resilience - partial results are returned if some fail
+     * @returns Array of embeddings (null for failed texts)
+     */
+    async generateEmbeddings(texts, userCredentials) {
+        // Process in parallel with concurrency limit
+        const results = [];
+        for (let i = 0; i < texts.length; i += EMBEDDING_CONFIG.BATCH_CONCURRENCY) {
+            const batch = texts.slice(i, i + EMBEDDING_CONFIG.BATCH_CONCURRENCY);
+            const batchResults = await Promise.allSettled(batch.map((text) => this.generateEmbedding(text, userCredentials)));
+            for (let j = 0; j < batchResults.length; j++) {
+                const result = batchResults[j];
+                if (result.status === "fulfilled") {
+                    results.push(result.value);
+                }
+                else {
+                    this.logger.warn("Failed to generate embedding for text", {
+                        batchIndex: i + j,
+                        error: result.reason instanceof Error ? result.reason.message : String(result.reason),
+                    });
+                    results.push(null);
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Create searchable text from document fields
+     * Combines relevant fields for embedding generation
+     */
+    static createSearchableText(doc) {
+        const parts = [doc.title, doc.name, doc.description, doc.content, doc.instructions].filter(Boolean);
+        return parts.join(" ").trim();
+    }
+    /**
+     * Get embedding dimensions (for index mapping)
+     */
+    static getDimensions() {
+        return EMBEDDING_CONFIG.DIMENSIONS;
+    }
+    /**
+     * Get cache statistics
+     */
+    getCacheStats() {
+        const totalRequests = this.cacheHits + this.cacheMisses;
+        const hitRate = totalRequests > 0 ? this.cacheHits / totalRequests : 0;
+        return {
+            hits: this.cacheHits,
+            misses: this.cacheMisses,
+            size: this.embeddingCache.size,
+            hitRate,
+        };
+    }
+    /**
+     * Start periodic metrics logging for cache performance monitoring
+     */
+    startMetricsLogging() {
+        this.metricsInterval = setInterval(() => {
+            this.logCacheMetrics();
+        }, SEARCH_METRICS_CONFIG.LOG_INTERVAL_MS);
+        // Ensure interval doesn't prevent process exit
+        this.metricsInterval.unref();
+    }
+    /**
+     * Log cache performance metrics
+     */
+    logCacheMetrics() {
+        const stats = this.getCacheStats();
+        const memoryEstimateBytes = stats.size * SEARCH_METRICS_CONFIG.EMBEDDING_CACHE_ENTRY_SIZE_BYTES;
+        const memoryEstimateMB = Math.round((memoryEstimateBytes / (1024 * 1024)) * 100) / 100;
+        this.logger.info("Embedding cache metrics", {
+            cacheSize: stats.size,
+            cacheHits: stats.hits,
+            cacheMisses: stats.misses,
+            hitRatePercent: Math.round(stats.hitRate * 10000) / 100,
+            memoryEstimateMB,
+        });
+    }
+    /**
+     * Clear the embedding cache.
+     * Useful for manual cache invalidation.
+     */
+    clearCache() {
+        this.embeddingCache.clear();
+        this.logger.info("Cleared embedding cache");
+    }
+    /**
+     * Close the service and clean up default client
+     */
+    close() {
+        if (this.defaultClient) {
+            this.defaultClient.destroy();
+            this.defaultClient = null;
+        }
+        // Stop metrics logging
+        if (this.metricsInterval) {
+            clearInterval(this.metricsInterval);
+            this.metricsInterval = null;
+        }
+        // Clear cache on close
+        this.embeddingCache.clear();
+        this.cacheHits = 0;
+        this.cacheMisses = 0;
+    }
+}
+// Singleton instance
+let embeddingServiceInstance = null;
+export function getEmbeddingService() {
+    if (!embeddingServiceInstance) {
+        embeddingServiceInstance = new EmbeddingService();
+    }
+    return embeddingServiceInstance;
+}
+export function clearEmbeddingService() {
+    if (embeddingServiceInstance) {
+        embeddingServiceInstance.close();
+        embeddingServiceInstance = null;
+    }
+}
+//# sourceMappingURL=embedding.service.js.map

package/dist/search/services/embedding.service.js.map

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

package/dist/search/services/index-lock.service.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Index Lock Service
+ *
+ * Manages locks for index operations (sync, delete) using in-memory storage.
+ * Prevents concurrent operations on the same index by any user (including same user in multiple tabs).
+ *
+ * Note: This is an in-memory implementation suitable for single-instance deployments.
+ * For multi-instance deployments, consider using Redis or a database.
+ */
+import type { AcquireLockResult, IndexLock, LockEvent, LockOperation } from "../search.interfaces";
+export type { AcquireLockResult, IndexLock, LockEvent, LockOperation };
+/** Subscriber callback type */
+type LockSubscriber = (event: LockEvent) => void;
+/**
+ * Subscribe to lock changes
+ */
+export declare function subscribeLockChanges(callback: LockSubscriber): () => void;
+/**
+ * Attempt to acquire a lock for an index operation
+ */
+export declare function acquireLock(indexName: string, operation: LockOperation, user: {
+    userId: string;
+    userName: string;
+    userEmail?: string;
+    tenantId: string;
+}): AcquireLockResult;
+/**
+ * Release a lock for an index
+ */
+export declare function releaseLock(indexName: string, userId?: string): boolean;
+/**
+ * Update progress for an active lock
+ */
+export declare function updateLockProgress(indexName: string, progress: {
+    current: number;
+    total: number;
+    message: string;
+    phase?: string;
+}): boolean;
+/**
+ * Get the current lock for an index
+ */
+export declare function getLock(indexName: string): IndexLock | null;
+/**
+ * Get all active (non-expired) locks
+ */
+export declare function getActiveLocks(): IndexLock[];
+/**
+ * Check if an index is locked
+ */
+export declare function isIndexLocked(indexName: string): boolean;
+/**
+ * Get lock count (for monitoring)
+ */
+export declare function getLockCount(): number;
+/**
+ * Get the index lock service instance
+ *
+ * Returns an object with all lock service methods for use in handlers.
+ */
+export declare function getIndexLockService(): {
+    acquireLock: typeof acquireLock;
+    releaseLock: typeof releaseLock;
+    updateLockProgress: typeof updateLockProgress;
+    getLock: typeof getLock;
+    getActiveLocks: typeof getActiveLocks;
+    isIndexLocked: typeof isIndexLocked;
+    getLockCount: typeof getLockCount;
+};
+//# sourceMappingURL=index-lock.service.d.ts.map

package/dist/search/services/index-lock.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-lock.service.d.ts","sourceRoot":"","sources":["../../../lib/search/services/index-lock.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EACV,iBAAiB,EACjB,SAAS,EACT,SAAS,EACT,aAAa,EACd,MAAM,gCAAgC,CAAC;AAGxC,YAAY,EAAE,iBAAiB,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;AAyBvE,+BAA+B;AAC/B,KAAK,cAAc,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;AA8BjD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,IAAI,CAGzE;AAkDD;;GAEG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,aAAa,EACxB,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC/E,iBAAiB,CA+DnB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CA8BvE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5E,OAAO,CAoBT;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAY3D;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,SAAS,EAAE,CAc5C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB;;;;;;;;EAUlC"}