@soulcraft/brainy 0.48.0 → 0.50.0

package/dist/utils/metadataIndexCache.d.ts

@@ -0,0 +1,60 @@
+/**
+ * MetadataIndexCache - Caches metadata index data for improved performance
+ * Reuses the same pattern as SearchCache for consistency
+ */
+export interface MetadataCacheEntry {
+    data: any;
+    timestamp: number;
+    hits: number;
+}
+export interface MetadataIndexCacheConfig {
+    maxAge?: number;
+    maxSize?: number;
+    enabled?: boolean;
+    hitCountWeight?: number;
+}
+export declare class MetadataIndexCache {
+    private cache;
+    private maxAge;
+    private maxSize;
+    private enabled;
+    private hitCountWeight;
+    private hits;
+    private misses;
+    private evictions;
+    constructor(config?: MetadataIndexCacheConfig);
+    /**
+     * Get cached entry
+     */
+    get(key: string): any | undefined;
+    /**
+     * Set cache entry
+     */
+    set(key: string, data: any): void;
+    /**
+     * Evict least valuable entry based on age and hit count
+     */
+    private evictLeastValuable;
+    /**
+     * Invalidate cache entries matching a pattern
+     */
+    invalidatePattern(pattern: string): void;
+    /**
+     * Clear all cache entries
+     */
+    clear(): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        size: number;
+        hits: number;
+        misses: number;
+        hitRate: number;
+        evictions: number;
+    };
+    /**
+     * Get estimated memory usage
+     */
+    getMemoryUsage(): number;
+}

package/dist/utils/metadataIndexCache.js

@@ -0,0 +1,119 @@
+/**
+ * MetadataIndexCache - Caches metadata index data for improved performance
+ * Reuses the same pattern as SearchCache for consistency
+ */
+export class MetadataIndexCache {
+    constructor(config = {}) {
+        this.cache = new Map();
+        // Cache statistics
+        this.hits = 0;
+        this.misses = 0;
+        this.evictions = 0;
+        this.maxAge = config.maxAge ?? 5 * 60 * 1000; // 5 minutes
+        this.maxSize = config.maxSize ?? 500; // More entries than SearchCache since indexes are smaller
+        this.enabled = config.enabled ?? true;
+        this.hitCountWeight = config.hitCountWeight ?? 0.3;
+    }
+    /**
+     * Get cached entry
+     */
+    get(key) {
+        if (!this.enabled)
+            return undefined;
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.misses++;
+            return undefined;
+        }
+        // Check if entry is expired
+        if (Date.now() - entry.timestamp > this.maxAge) {
+            this.cache.delete(key);
+            this.misses++;
+            return undefined;
+        }
+        // Update hit count
+        entry.hits++;
+        this.hits++;
+        return entry.data;
+    }
+    /**
+     * Set cache entry
+     */
+    set(key, data) {
+        if (!this.enabled)
+            return;
+        // Evict entries if at max size
+        if (this.cache.size >= this.maxSize) {
+            this.evictLeastValuable();
+        }
+        this.cache.set(key, {
+            data,
+            timestamp: Date.now(),
+            hits: 0
+        });
+    }
+    /**
+     * Evict least valuable entry based on age and hit count
+     */
+    evictLeastValuable() {
+        let leastValuableKey = null;
+        let lowestScore = Infinity;
+        for (const [key, entry] of this.cache.entries()) {
+            const age = Date.now() - entry.timestamp;
+            const ageScore = age / this.maxAge;
+            const hitScore = entry.hits * this.hitCountWeight;
+            const score = hitScore - ageScore;
+            if (score < lowestScore) {
+                lowestScore = score;
+                leastValuableKey = key;
+            }
+        }
+        if (leastValuableKey) {
+            this.cache.delete(leastValuableKey);
+            this.evictions++;
+        }
+    }
+    /**
+     * Invalidate cache entries matching a pattern
+     */
+    invalidatePattern(pattern) {
+        const keysToDelete = [];
+        for (const key of this.cache.keys()) {
+            if (key.includes(pattern)) {
+                keysToDelete.push(key);
+            }
+        }
+        keysToDelete.forEach(key => this.cache.delete(key));
+    }
+    /**
+     * Clear all cache entries
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        return {
+            size: this.cache.size,
+            hits: this.hits,
+            misses: this.misses,
+            hitRate: this.hits / (this.hits + this.misses) || 0,
+            evictions: this.evictions
+        };
+    }
+    /**
+     * Get estimated memory usage
+     */
+    getMemoryUsage() {
+        // Rough estimate: 100 bytes per entry + data size
+        let totalSize = 0;
+        for (const entry of this.cache.values()) {
+            totalSize += 100; // Base overhead
+            totalSize += JSON.stringify(entry.data).length * 2; // Unicode chars
+        }
+        return totalSize;
+    }
+}
+//# sourceMappingURL=metadataIndexCache.js.map

package/dist/utils/metadataIndexCache.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/brainy",
-  "version": "0.48.0",
+  "version": "0.50.0",
   "description": "A vector graph database using HNSW indexing with Origin Private File System storage",
   "main": "dist/index.js",
   "module": "dist/index.js",