@archlast/server 0.0.1

package/dist/cache/manager.js

@@ -0,0 +1,423 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheManager = void 0;
+const logger_js_1 = require("../logging/logger.js");
+/**
+ * Advanced Cache Manager with multiple strategies and invalidation patterns
+ * Now uses centralized CacheClient instead of LRU cache
+ */
+class CacheManager {
+    cacheClient;
+    name;
+    config;
+    stats;
+    writeBackQueue;
+    writeBackTimer;
+    metadataCache;
+    partition;
+    constructor(name, config, cacheClient) {
+        this.name = name;
+        this.cacheClient = cacheClient || null;
+        this.config = config;
+        this.partition = config.partition || (name.includes("query") ? "query" : "function");
+        this.stats = {
+            hits: 0,
+            misses: 0,
+            evictions: 0,
+            writes: 0,
+            deletes: 0,
+            size: 0,
+            hitRate: 0,
+        };
+        this.writeBackQueue = new Map();
+        this.metadataCache = new Map();
+        // Initialize write-back timer if needed
+        if (config.strategy === "write-back" && config.writeBackDelay) {
+            this.startWriteBackTimer();
+        }
+        // Subscribe to invalidation events
+        if (this.cacheClient) {
+            this.cacheClient.onInvalidate((keys) => {
+                // Update stats for invalidated keys
+                this.stats.evictions += keys.length;
+            });
+        }
+    }
+    /**
+     * Get value from cache with strategy-specific logic
+     */
+    async get(key, fetchFn) {
+        if (!this.cacheClient || !this.cacheClient.isConnected()) {
+            // Fallback: if no cache client, execute fetch function
+            if (fetchFn) {
+                this.stats.misses++;
+                this.updateHitRate();
+                return await fetchFn();
+            }
+            return null;
+        }
+        const cached = await this.cacheClient.get(key, this.partition);
+        // Treat null/undefined cached values as cache miss
+        if (cached !== undefined && cached !== null) {
+            this.stats.hits++;
+            this.updateMetadata(key, { lastAccessed: Date.now(), hits: 1 });
+            this.updateHitRate();
+            return cached;
+        }
+        this.stats.misses++;
+        this.updateHitRate();
+        // Strategy-specific behavior for cache miss
+        if (fetchFn) {
+            switch (this.config.strategy) {
+                case "cache-aside":
+                case "write-around":
+                    // Application manages loading data
+                    const data = await fetchFn();
+                    if (data !== null) {
+                        this.set(key, data);
+                    }
+                    return data;
+                case "read-through":
+                case "write-through":
+                case "write-back":
+                    // Cache is responsible for fetching from DB
+                    const fetchedData = await fetchFn();
+                    if (fetchedData !== null) {
+                        this.set(key, fetchedData);
+                    }
+                    return fetchedData;
+                default:
+                    return null;
+            }
+        }
+        return null;
+    }
+    /**
+     * Set value in cache with strategy-specific logic
+     */
+    set(key, value, options) {
+        // NEVER cache null or undefined values
+        if (value === null || value === undefined) {
+            queueMicrotask(() => logger_js_1.logger.log({
+                timestamp: Date.now(),
+                level: "warn",
+                kind: "cache",
+                message: "Refusing to cache null/undefined",
+                context: { key },
+            }));
+            return;
+        }
+        if (!this.cacheClient || !this.cacheClient.isConnected()) {
+            return; // Graceful degradation
+        }
+        const ttl = options?.ttl || this.config.ttl;
+        // Send to centralized cache
+        this.cacheClient.set(key, value, this.partition, ttl).catch((err) => {
+            logger_js_1.logger.log({
+                timestamp: Date.now(),
+                level: "error",
+                kind: "cache",
+                message: `[CacheManager] Failed to set cache:`,
+                context: err,
+            });
+        });
+        this.stats.writes++;
+        // Create metadata
+        const metadata = {
+            key,
+            createdAt: Date.now(),
+            lastAccessed: Date.now(),
+            hits: 0,
+            ttl,
+        };
+        this.metadataCache.set(key, metadata);
+        // Strategy-specific behavior
+        if (this.config.strategy === "write-back") {
+            // Mark as dirty for write-back
+            metadata.dirty = true;
+            this.writeBackQueue.set(key, { data: value, timestamp: Date.now() });
+        }
+    }
+    /**
+     * Delete from cache
+     */
+    delete(key) {
+        // Always clean up metadata and write-back queue to prevent orphans
+        this.metadataCache.delete(key);
+        this.writeBackQueue.delete(key);
+        if (!this.cacheClient || !this.cacheClient.isConnected()) {
+            return false;
+        }
+        this.cacheClient
+            .delete(key, this.partition)
+            .then((deleted) => {
+            if (deleted) {
+                this.stats.deletes++;
+            }
+        })
+            .catch((err) => {
+            logger_js_1.logger.log({
+                timestamp: Date.now(),
+                level: "error",
+                kind: "cache",
+                message: `[CacheManager] Failed to delete cache:`,
+                context: err,
+            });
+        });
+        return true;
+    }
+    /**
+     * Check if key exists in cache
+     */
+    async has(key) {
+        if (!this.cacheClient || !this.cacheClient.isConnected()) {
+            return false;
+        }
+        const value = await this.cacheClient.get(key, this.partition);
+        return value !== null;
+    }
+    /**
+     * Clear entire cache
+     */
+    clear() {
+        this.metadataCache.clear();
+        this.writeBackQueue.clear();
+        this.stats.size = 0;
+        this.stats.evictions = 0;
+        if (this.cacheClient && this.cacheClient.isConnected()) {
+            this.cacheClient.clear(this.partition).catch((err) => {
+                logger_js_1.logger.log({
+                    timestamp: Date.now(),
+                    level: "error",
+                    kind: "cache",
+                    message: `[CacheManager] Failed to clear cache:`,
+                    context: err,
+                });
+            });
+        }
+    }
+    /**
+     * Invalidate cache entries based on pattern
+     */
+    invalidatePattern(pattern) {
+        if (!this.cacheClient || !this.cacheClient.isConnected()) {
+            return 0;
+        }
+        this.cacheClient
+            .invalidatePattern(pattern, this.partition)
+            .then((invalidated) => {
+            this.stats.evictions += invalidated.length;
+            return invalidated.length;
+        })
+            .catch((err) => {
+            logger_js_1.logger.log({
+                timestamp: Date.now(),
+                level: "error",
+                kind: "cache",
+                message: `[CacheManager] Failed to invalidate pattern:`,
+                context: err,
+            });
+        });
+        return 0; // Returns immediately, actual count updates async
+    }
+    /**
+     * Invalidate cache entries based on a predicate
+     */
+    invalidate(predicate) {
+        if (!this.cacheClient || !this.cacheClient.isConnected()) {
+            return 0;
+        }
+        // Create a copy of keys to avoid modification during iteration issues
+        const keys = Array.from(this.metadataCache.keys());
+        const keysToInvalidate = [];
+        for (const key of keys) {
+            if (predicate(key)) {
+                keysToInvalidate.push(key);
+            }
+        }
+        if (keysToInvalidate.length > 0) {
+            this.cacheClient.invalidate(keysToInvalidate).catch((err) => {
+                logger_js_1.logger.log({
+                    timestamp: Date.now(),
+                    level: "error",
+                    kind: "cache",
+                    message: `[CacheManager] Failed to invalidate keys:`,
+                    context: err,
+                });
+            });
+        }
+        return keysToInvalidate.length;
+    }
+    /**
+     * Eviction strategy - handled by centralized cache
+     */
+    evict() {
+        // Centralized cache handles eviction automatically
+        this.stats.evictions++;
+    }
+    /**
+     * Update metadata for cache entry
+     */
+    updateMetadata(key, updates) {
+        const metadata = this.metadataCache.get(key);
+        if (metadata) {
+            if (updates.hits !== undefined) {
+                metadata.hits += updates.hits;
+            }
+            if (updates.lastAccessed !== undefined) {
+                metadata.lastAccessed = updates.lastAccessed;
+            }
+            this.metadataCache.set(key, metadata);
+        }
+    }
+    /**
+     * Update hit rate statistic
+     */
+    updateHitRate() {
+        const total = this.stats.hits + this.stats.misses;
+        this.stats.hitRate = total > 0 ? this.stats.hits / total : 0;
+    }
+    /**
+     * Write-back strategy: Flush dirty entries to database
+     */
+    async flushWriteBack(persistFn) {
+        const entries = Array.from(this.writeBackQueue.entries());
+        for (const [key, { data }] of entries) {
+            try {
+                await persistFn(key, data);
+                const metadata = this.metadataCache.get(key);
+                if (metadata) {
+                    metadata.dirty = false;
+                }
+                this.writeBackQueue.delete(key);
+            }
+            catch (error) {
+                queueMicrotask(() => logger_js_1.logger.log({
+                    timestamp: Date.now(),
+                    level: "error",
+                    kind: "cache",
+                    message: "Failed to flush write-back",
+                    context: {
+                        key,
+                        error: error instanceof Error ? error.message : String(error),
+                    },
+                }));
+            }
+        }
+    }
+    /**
+     * Start write-back timer
+     */
+    startWriteBackTimer() {
+        const delay = this.config.writeBackDelay || 5000;
+        this.writeBackTimer = setInterval(() => {
+            if (this.writeBackQueue.size > 0) {
+                queueMicrotask(() => logger_js_1.logger.log({
+                    timestamp: Date.now(),
+                    level: "info",
+                    kind: "cache",
+                    message: "Flushing dirty cache entries",
+                    context: { count: this.writeBackQueue.size },
+                }));
+                // This would need a persistFn injected - for now just log
+                // In real implementation, pass DB write function
+            }
+        }, delay);
+    }
+    /**
+     * Stop write-back timer
+     */
+    stopWriteBackTimer() {
+        if (this.writeBackTimer) {
+            clearInterval(this.writeBackTimer);
+        }
+    }
+    /**
+     * Get cache statistics
+     */
+    async getStats() {
+        if (this.cacheClient && this.cacheClient.isConnected()) {
+            try {
+                // Fetch real stats from sidecar
+                // Note: Sidecar returns global stats, not partition-specific
+                return await this.cacheClient.getStats();
+            }
+            catch (err) {
+                logger_js_1.logger.log({
+                    timestamp: Date.now(),
+                    level: "warn",
+                    kind: "cache",
+                    message: `[CacheManager] Failed to get sidecar stats:`,
+                    context: { err },
+                });
+            }
+        }
+        return { ...this.stats };
+    }
+    /**
+     * Get all cache keys
+     */
+    keys() {
+        // Not supported with sidecar architecture
+        return [];
+    }
+    /**
+     * Get cache size
+     */
+    size() {
+        return this.stats.size;
+    }
+    /**
+     * TTL-based cleanup
+     * Note: LRU cache handles TTL automatically
+     */
+    async cleanup() {
+        // LRU cache handles TTL-based expiration automatically
+        // Clean up orphaned metadata
+        let cleaned = 0;
+        if (!this.cacheClient || !this.cacheClient.isConnected()) {
+            // If cache client is not available, clear all metadata
+            cleaned = this.metadataCache.size;
+            this.metadataCache.clear();
+            return cleaned;
+        }
+        for (const [key] of this.metadataCache) {
+            const exists = await this.cacheClient.get(key, this.partition);
+            if (exists === null || exists === undefined) {
+                this.metadataCache.delete(key);
+                cleaned++;
+            }
+        }
+        return cleaned;
+    }
+    /**
+     * Register periodic cleanup
+     */
+    startCleanup(interval = 60000) {
+        setInterval(async () => {
+            const cleaned = await this.cleanup();
+            if (cleaned > 0) {
+                queueMicrotask(() => logger_js_1.logger.log({
+                    timestamp: Date.now(),
+                    level: "info",
+                    kind: "cache",
+                    message: "Cleaned up orphaned metadata entries",
+                    context: { cleaned },
+                }));
+            }
+        }, interval);
+    }
+    /**
+     * Export cache snapshot for debugging
+     */
+    snapshot() {
+        const snapshot = [];
+        for (const [key, metadata] of this.metadataCache) {
+            // Snapshot not supported with sidecar
+            snapshot.push({ key, data: null, metadata });
+        }
+        return snapshot;
+    }
+}
+exports.CacheManager = CacheManager;
+//# sourceMappingURL=manager.js.map

package/dist/cache/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/cache/manager.ts"],"names":[],"mappings":";;;AACA,oDAA8C;AAU9C;;;GAGG;AACH,MAAa,YAAY;IACb,WAAW,CAAqB;IAChC,IAAI,CAAS;IACb,MAAM,CAAc;IACpB,KAAK,CAAa;IAClB,cAAc,CAAgD;IAC9D,cAAc,CAAM;IACpB,aAAa,CAA6B;IAC1C,SAAS,CAAkD;IAEnE,YAAY,IAAY,EAAE,MAAmB,EAAE,WAAgC;QAC3E,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,WAAW,GAAG,WAAW,IAAI,IAAI,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QACrF,IAAI,CAAC,KAAK,GAAG;YACT,IAAI,EAAE,CAAC;YACP,MAAM,EAAE,CAAC;YACT,SAAS,EAAE,CAAC;YACZ,MAAM,EAAE,CAAC;YACT,OAAO,EAAE,CAAC;YACV,IAAI,EAAE,CAAC;YACP,OAAO,EAAE,CAAC;SACb,CAAC;QACF,IAAI,CAAC,cAAc,GAAG,IAAI,GAAG,EAAE,CAAC;QAChC,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC;QAE/B,wCAAwC;QACxC,IAAI,MAAM,CAAC,QAAQ,KAAK,YAAY,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;YAC5D,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC/B,CAAC;QAED,mCAAmC;QACnC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,EAAE;gBACnC,oCAAoC;gBACpC,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC;YACxC,CAAC,CAAC,CAAC;QACP,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,OAA0B;QAChD,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC;YACvD,uDAAuD;YACvD,IAAI,OAAO,EAAE,CAAC;gBACV,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBACpB,IAAI,CAAC,aAAa,EAAE,CAAC;gBACrB,OAAO,MAAM,OAAO,EAAE,CAAC;YAC3B,CAAC;YACD,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAI,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAElE,mDAAmD;QACnD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YAC1C,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAClB,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YAChE,IAAI,CAAC,aAAa,EAAE,CAAC;YACrB,OAAO,MAAW,CAAC;QACvB,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACpB,IAAI,CAAC,aAAa,EAAE,CAAC;QAErB,4CAA4C;QAC5C,IAAI,OAAO,EAAE,CAAC;YACV,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAC3B,KAAK,aAAa,CAAC;gBACnB,KAAK,cAAc;oBACf,mCAAmC;oBACnC,MAAM,IAAI,GAAG,MAAM,OAAO,EAAE,CAAC;oBAE7B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;wBAChB,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;oBACxB,CAAC;oBACD,OAAO,IAAI,CAAC;gBAEhB,KAAK,cAAc,CAAC;gBACpB,KAAK,eAAe,CAAC;gBACrB,KAAK,YAAY;oBACb,4CAA4C;oBAC5C,MAAM,WAAW,GAAG,MAAM,OAAO,EAAE,CAAC;oBAEpC,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;wBACvB,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;oBAC/B,CAAC;oBACD,OAAO,WAAW,CAAC;gBAEvB;oBACI,OAAO,IAAI,CAAC;YACpB,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,GAAG,CAAI,GAAW,EAAE,KAAQ,EAAE,OAA0B;QACpD,uCAAuC;QACvC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxC,cAAc,CAAC,GAAG,EAAE,CAChB,kBAAM,CAAC,GAAG,CAAC;gBACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,KAAK,EAAE,MAAM;gBACb,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,kCAAkC;gBAC3C,OAAO,EAAE,EAAE,GAAG,EAAE;aACnB,CAAC,CACL,CAAC;YACF,OAAO;QACX,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC;YACvD,OAAO,CAAC,uBAAuB;QACnC,CAAC;QAED,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;QAE5C,4BAA4B;QAC5B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YAChE,kBAAM,CAAC,GAAG,CAAC;gBACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,KAAK,EAAE,OAAO;gBACd,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,qCAAqC;gBAC9C,OAAO,EAAE,GAAG;aACf,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAEpB,kBAAkB;QAClB,MAAM,QAAQ,GAAkB;YAC5B,GAAG;YACH,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;YACxB,IAAI,EAAE,CAAC;YACP,GAAG;SACN,CAAC;QAEF,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAEtC,6BAA6B;QAC7B,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YACxC,+BAA+B;YAC/B,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC;YACtB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACzE,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAW;QACd,mEAAmE;QACnE,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAEhC,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC;YACvD,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,IAAI,CAAC,WAAW;aACX,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC;aAC3B,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;YACd,IAAI,OAAO,EAAE,CAAC;gBACV,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACzB,CAAC;QACL,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACX,kBAAM,CAAC,GAAG,CAAC;gBACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,KAAK,EAAE,OAAO;gBACd,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,wCAAwC;gBACjD,OAAO,EAAE,GAAG;aACf,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;QAEP,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,GAAW;QACjB,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC;YACvD,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC9D,OAAO,KAAK,KAAK,IAAI,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK;QACD,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;QAEzB,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC;YACrD,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBACjD,kBAAM,CAAC,GAAG,CAAC;oBACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;oBACrB,KAAK,EAAE,OAAO;oBACd,IAAI,EAAE,OAAO;oBACb,OAAO,EAAE,uCAAuC;oBAChD,OAAO,EAAE,GAAG;iBACf,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;QACP,CAAC;IACL,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,OAAe;QAC7B,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC;YACvD,OAAO,CAAC,CAAC;QACb,CAAC;QAED,IAAI,CAAC,WAAW;aACX,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;aAC1C,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE;YAClB,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,WAAW,CAAC,MAAM,CAAC;YAC3C,OAAO,WAAW,CAAC,MAAM,CAAC;QAC9B,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACX,kBAAM,CAAC,GAAG,CAAC;gBACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,KAAK,EAAE,OAAO;gBACd,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,8CAA8C;gBACvD,OAAO,EAAE,GAAG;aACf,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;QAEP,OAAO,CAAC,CAAC,CAAC,kDAAkD;IAChE,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,SAAmC;QAC1C,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC;YACvD,OAAO,CAAC,CAAC;QACb,CAAC;QAED,sEAAsE;QACtE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC;QACnD,MAAM,gBAAgB,GAAa,EAAE,CAAC;QAEtC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACrB,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;gBACjB,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC/B,CAAC;QACL,CAAC;QAED,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBACxD,kBAAM,CAAC,GAAG,CAAC;oBACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;oBACrB,KAAK,EAAE,OAAO;oBACd,IAAI,EAAE,OAAO;oBACb,OAAO,EAAE,2CAA2C;oBACpD,OAAO,EAAE,GAAG;iBACf,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;QACP,CAAC;QAED,OAAO,gBAAgB,CAAC,MAAM,CAAC;IACnC,CAAC;IAED;;OAEG;IACK,KAAK;QACT,mDAAmD;QACnD,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,GAAW,EAAE,OAA+B;QAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC7C,IAAI,QAAQ,EAAE,CAAC;YACX,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC7B,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAClC,CAAC;YACD,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;gBACrC,QAAQ,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;YACjD,CAAC;YACD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC1C,CAAC;IACL,CAAC;IAED;;OAEG;IACK,aAAa;QACjB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;QAClD,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc,CACxB,SAAoD;QAEpD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC;QAE1D,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC;YACpC,IAAI,CAAC;gBACD,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAC7C,IAAI,QAAQ,EAAE,CAAC;oBACX,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;gBAC3B,CAAC;gBACD,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACpC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,cAAc,CAAC,GAAG,EAAE,CAChB,kBAAM,CAAC,GAAG,CAAC;oBACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;oBACrB,KAAK,EAAE,OAAO;oBACd,IAAI,EAAE,OAAO;oBACb,OAAO,EAAE,4BAA4B;oBACrC,OAAO,EAAE;wBACL,GAAG;wBACH,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;qBAChE;iBACJ,CAAC,CACL,CAAC;YACN,CAAC;QACL,CAAC;IACL,CAAC;IAED;;OAEG;IACK,mBAAmB;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,IAAI,CAAC;QAEjD,IAAI,CAAC,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE;YACnC,IAAI,IAAI,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBAC/B,cAAc,CAAC,GAAG,EAAE,CAChB,kBAAM,CAAC,GAAG,CAAC;oBACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;oBACrB,KAAK,EAAE,MAAM;oBACb,IAAI,EAAE,OAAO;oBACb,OAAO,EAAE,8BAA8B;oBACvC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE;iBAC/C,CAAC,CACL,CAAC;gBACF,0DAA0D;gBAC1D,iDAAiD;YACrD,CAAC;QACL,CAAC,EAAE,KAAK,CAAC,CAAC;IACd,CAAC;IAED;;OAEG;IACH,kBAAkB;QACd,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACvC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACV,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC;YACrD,IAAI,CAAC;gBACD,gCAAgC;gBAChC,6DAA6D;gBAC7D,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;YAC7C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACX,kBAAM,CAAC,GAAG,CAAC;oBACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;oBACrB,KAAK,EAAE,MAAM;oBACb,IAAI,EAAE,OAAO;oBACb,OAAO,EAAE,6CAA6C;oBACtD,OAAO,EAAE,EAAE,GAAG,EAAE;iBACnB,CAAC,CAAC;YACP,CAAC;QACL,CAAC;QACD,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,IAAI;QACA,0CAA0C;QAC1C,OAAO,EAAE,CAAC;IACd,CAAC;IAED;;OAEG;IACH,IAAI;QACA,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO;QACT,uDAAuD;QACvD,6BAA6B;QAC7B,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC;YACvD,uDAAuD;YACvD,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;YAClC,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;YAC3B,OAAO,OAAO,CAAC;QACnB,CAAC;QAED,KAAK,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAC/D,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC1C,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC/B,OAAO,EAAE,CAAC;YACd,CAAC;QACL,CAAC;QACD,OAAO,OAAO,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,WAAmB,KAAK;QACjC,WAAW,CAAC,KAAK,IAAI,EAAE;YACnB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YACrC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBACd,cAAc,CAAC,GAAG,EAAE,CAChB,kBAAM,CAAC,GAAG,CAAC;oBACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;oBACrB,KAAK,EAAE,MAAM;oBACb,IAAI,EAAE,OAAO;oBACb,OAAO,EAAE,sCAAsC;oBAC/C,OAAO,EAAE,EAAE,OAAO,EAAE;iBACvB,CAAC,CACL,CAAC;YACN,CAAC;QACL,CAAC,EAAE,QAAQ,CAAC,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,QAAQ;QACJ,MAAM,QAAQ,GAAG,EAAE,CAAC;QAEpB,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YAC/C,sCAAsC;YACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACjD,CAAC;QAED,OAAO,QAAQ,CAAC;IACpB,CAAC;CACJ;AA3dD,oCA2dC"}

package/dist/cache/protocol.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Cache Sidecar IPC Protocol
+ *
+ * Fast, JSON-line protocol for Unix Domain Socket communication.
+ */
+export type CacheCommand = {
+    type: "GET";
+    key: string;
+    partition: "query" | "function";
+} | {
+    type: "SET";
+    key: string;
+    value: any;
+    partition: "query" | "function";
+    ttl?: number;
+    size: number;
+} | {
+    type: "DELETE";
+    key: string;
+    partition: "query" | "function";
+} | {
+    type: "INVALIDATE";
+    keys: string[];
+} | {
+    type: "INVALIDATE_PATTERN";
+    pattern: string;
+    partition: "query" | "function";
+} | {
+    type: "DEP_ADD";
+    dependencyKey: string;
+    cacheKey: string;
+} | {
+    type: "SUBSCRIBE";
+    channel: "invalidation";
+} | {
+    type: "STATS";
+} | {
+    type: "CLEAR";
+    partition?: "query" | "function";
+} | {
+    type: "PING";
+};
+export type CacheResponse = {
+    type: "VALUE";
+    value: any;
+    hit: boolean;
+} | {
+    type: "OK";
+} | {
+    type: "ERROR";
+    message: string;
+} | {
+    type: "STATS";
+    stats: CacheStats;
+} | {
+    type: "EVENT_INVALIDATE";
+    keys: string[];
+} | {
+    type: "PONG";
+};
+export interface CacheStats {
+    query: {
+        size: number;
+        maxSize: number;
+        entries: number;
+        hits: number;
+        misses: number;
+        hitRate: number;
+    };
+    document: {
+        size: number;
+        maxSize: number;
+        entries: number;
+        hits: number;
+        misses: number;
+        hitRate: number;
+    };
+    aggregate: {
+        size: number;
+        maxSize: number;
+        entries: number;
+        hits: number;
+        misses: number;
+        hitRate: number;
+    };
+    function: {
+        size: number;
+        maxSize: number;
+        entries: number;
+        hits: number;
+        misses: number;
+        hitRate: number;
+    };
+    dependencies: {
+        entries: number;
+    };
+    uptime: number;
+}
+/**
+ * Serialize command to JSON line
+ */
+export declare function serializeCommand(cmd: CacheCommand): string;
+/**
+ * Serialize response to JSON line
+ */
+export declare function serializeResponse(res: CacheResponse): string;
+/**
+ * Parse JSON line to command
+ */
+export declare function parseCommand(line: string): CacheCommand;
+/**
+ * Parse JSON line to response
+ */
+export declare function parseResponse(line: string): CacheResponse;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/cache/protocol.d.ts.map

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

package/dist/cache/protocol.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * Cache Sidecar IPC Protocol
+ *
+ * Fast, JSON-line protocol for Unix Domain Socket communication.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeCommand = serializeCommand;
+exports.serializeResponse = serializeResponse;
+exports.parseCommand = parseCommand;
+exports.parseResponse = parseResponse;
+/**
+ * Serialize command to JSON line
+ */
+function serializeCommand(cmd) {
+    return JSON.stringify(cmd) + "\n";
+}
+/**
+ * Serialize response to JSON line
+ */
+function serializeResponse(res) {
+    return JSON.stringify(res) + "\n";
+}
+/**
+ * Parse JSON line to command
+ */
+function parseCommand(line) {
+    return JSON.parse(line.trim());
+}
+/**
+ * Parse JSON line to response
+ */
+function parseResponse(line) {
+    return JSON.parse(line.trim());
+}
+//# sourceMappingURL=protocol.js.map

package/dist/cache/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/cache/protocol.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAuEH,4CAEC;AAKD,8CAEC;AAKD,oCAEC;AAKD,sCAEC;AA1BD;;GAEG;AACH,SAAgB,gBAAgB,CAAC,GAAiB;IAC9C,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,GAAkB;IAChD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;AACnC,CAAC"}

package/dist/cache/run-sidecar.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Cache Sidecar Process Runner
+ *
+ * Standalone process that runs the cache sidecar server.
+ * Launched by the main server on startup.
+ */
+export {};
+//# sourceMappingURL=run-sidecar.d.ts.map

package/dist/cache/run-sidecar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-sidecar.d.ts","sourceRoot":"","sources":["../../src/cache/run-sidecar.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/cache/run-sidecar.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * Cache Sidecar Process Runner
+ *
+ * Standalone process that runs the cache sidecar server.
+ * Launched by the main server on startup.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const sidecar_server_js_1 = require("./sidecar-server.js");
+const logger_js_1 = require("../logging/logger.js");
+const path_1 = require("path");
+const SOCKET_PATH = process.env.CACHE_SOCKET_PATH || (0, path_1.join)(process.cwd(), "data", "cache.sock");
+async function main() {
+    logger_js_1.logger.log({
+        timestamp: Date.now(),
+        level: "info",
+        kind: "cache",
+        message: "[CacheSidecar] Starting cache sidecar server...",
+    });
+    logger_js_1.logger.log({
+        timestamp: Date.now(),
+        level: "info",
+        kind: "cache",
+        message: `[CacheSidecar] Socket path: ${SOCKET_PATH}`,
+    });
+    const server = new sidecar_server_js_1.CacheSidecarServer(SOCKET_PATH);
+    // Handle graceful shutdown
+    const shutdown = async () => {
+        logger_js_1.logger.log({
+            timestamp: Date.now(),
+            level: "info",
+            kind: "cache",
+            message: "[CacheSidecar] Shutting down...",
+        });
+        await server.stop();
+        process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    // Start server
+    try {
+        await server.start();
+        logger_js_1.logger.log({
+            timestamp: Date.now(),
+            level: "info",
+            kind: "cache",
+            message: "[CacheSidecar] Server started successfully",
+        });
+    }
+    catch (err) {
+        logger_js_1.logger.log({
+            timestamp: Date.now(),
+            level: "error",
+            kind: "cache",
+            message: "[CacheSidecar] Failed to start server:",
+            context: { err },
+        });
+        process.exit(1);
+    }
+}
+main().catch((err) => {
+    logger_js_1.logger.log({
+        timestamp: Date.now(),
+        level: "error",
+        kind: "cache",
+        message: "[CacheSidecar] Fatal error:",
+        context: err,
+    });
+    process.exit(1);
+});
+//# sourceMappingURL=run-sidecar.js.map