@nahisaho/yata-scale 1.8.5

package/dist/cache/CacheManager.js

@@ -0,0 +1,286 @@
+/**
+ * @nahisaho/yata-scale - Cache Manager
+ *
+ * Coordinates multi-tier caching (L1/L2/L3)
+ */
+import { ok, err } from 'neverthrow';
+import { CacheMissError } from '../errors.js';
+import { L1Cache } from './L1Cache.js';
+import { L2Cache } from './L2Cache.js';
+import { L3Cache } from './L3Cache.js';
+import { InvalidationManager } from './InvalidationManager.js';
+/**
+ * Cache manager for multi-tier caching
+ */
+export class CacheManager {
+    l1;
+    l2;
+    l3;
+    invalidation;
+    config;
+    constructor(config) {
+        this.config = config;
+        // Initialize tiers
+        this.l1 = new L1Cache(config.l1MaxEntries);
+        this.l2 = new L2Cache(config.l2MaxSize);
+        this.l3 = new L3Cache(config.l3MaxEntries);
+        // Setup invalidation
+        this.invalidation = new InvalidationManager(100, 10);
+        this.invalidation.addListener((event) => this.handleInvalidation(event));
+    }
+    /**
+     * Get entity with cache hierarchy
+     */
+    async getEntity(id) {
+        // Try L1 (hot)
+        const l1Result = this.l1.getEntity(id);
+        if (l1Result) {
+            return ok(l1Result);
+        }
+        // Try L2 (warm)
+        const l2Result = this.l2.getEntity(id);
+        if (l2Result) {
+            // Promote to L1
+            this.l1.setEntity(l2Result);
+            return ok(l2Result);
+        }
+        // Try L3 (cold)
+        const l3Result = await this.l3.getEntity(id);
+        if (l3Result) {
+            // Promote to L2 and L1
+            this.l2.setEntity(l3Result);
+            this.l1.setEntity(l3Result);
+            return ok(l3Result);
+        }
+        return err(new CacheMissError(id));
+    }
+    /**
+     * Set entity in cache
+     */
+    async setEntity(entity) {
+        // Always add to L1 (hot tier)
+        this.l1.setEntity(entity);
+        // Also add to L3 for persistence
+        await this.l3.setEntity(entity);
+    }
+    /**
+     * Delete entity from all tiers
+     */
+    async deleteEntity(id) {
+        this.l1.deleteEntity(id);
+        this.l2.deleteEntity(id);
+        await this.l3.deleteEntity(id);
+        this.invalidation.invalidateEntity(id, 'delete');
+    }
+    /**
+     * Get relationship with cache hierarchy
+     */
+    async getRelationship(id) {
+        // Try L1
+        const l1Result = this.l1.getRelationship(id);
+        if (l1Result) {
+            return ok(l1Result);
+        }
+        // Try L2
+        const l2Result = this.l2.getRelationship(id);
+        if (l2Result) {
+            this.l1.setRelationship(l2Result);
+            return ok(l2Result);
+        }
+        // Try L3
+        const l3Result = await this.l3.getRelationship(id);
+        if (l3Result) {
+            this.l2.setRelationship(l3Result);
+            this.l1.setRelationship(l3Result);
+            return ok(l3Result);
+        }
+        return err(new CacheMissError(id));
+    }
+    /**
+     * Set relationship in cache
+     */
+    async setRelationship(relationship) {
+        this.l1.setRelationship(relationship);
+        await this.l3.setRelationship(relationship);
+    }
+    /**
+     * Delete relationship from all tiers
+     */
+    async deleteRelationship(id) {
+        this.l1.deleteRelationship(id);
+        this.l2.deleteRelationship(id);
+        await this.l3.deleteRelationship(id);
+        this.invalidation.invalidateRelationship(id, 'delete');
+    }
+    /**
+     * Get multiple entities
+     */
+    async getEntities(ids) {
+        const result = new Map();
+        const missingIds = [];
+        // Check L1 first
+        for (const id of ids) {
+            const entity = this.l1.getEntity(id);
+            if (entity) {
+                result.set(id, entity);
+            }
+            else {
+                missingIds.push(id);
+            }
+        }
+        if (missingIds.length === 0) {
+            return result;
+        }
+        // Check L2 for missing
+        const stillMissing = [];
+        for (const id of missingIds) {
+            const entity = this.l2.getEntity(id);
+            if (entity) {
+                result.set(id, entity);
+                this.l1.setEntity(entity); // Promote
+            }
+            else {
+                stillMissing.push(id);
+            }
+        }
+        if (stillMissing.length === 0) {
+            return result;
+        }
+        // Check L3 for still missing
+        const l3Results = await this.l3.getEntities(stillMissing);
+        for (const [id, entity] of l3Results) {
+            result.set(id, entity);
+            this.l2.setEntity(entity);
+            this.l1.setEntity(entity);
+        }
+        return result;
+    }
+    /**
+     * Set multiple entities
+     */
+    async setEntities(entities) {
+        this.l1.setEntities(entities);
+        await this.l3.setEntities(entities);
+    }
+    /**
+     * Handle invalidation event
+     */
+    handleInvalidation(event) {
+        if (event.type === 'entity') {
+            this.l1.deleteEntity(event.id);
+            this.l2.deleteEntity(event.id);
+            // Don't delete from L3 on update, only on explicit delete
+        }
+        else {
+            this.l1.deleteRelationship(event.id);
+            this.l2.deleteRelationship(event.id);
+        }
+    }
+    /**
+     * Invalidate entity across all tiers
+     */
+    invalidateEntity(id) {
+        this.invalidation.invalidateEntity(id);
+    }
+    /**
+     * Invalidate multiple entities
+     */
+    invalidateEntities(ids) {
+        this.invalidation.invalidateEntities(ids);
+    }
+    /**
+     * Flush invalidations
+     */
+    flushInvalidations() {
+        this.invalidation.flushNow();
+    }
+    /**
+     * Prewarm cache with entities
+     */
+    async prewarm(entities) {
+        // Add to all tiers
+        await this.setEntities(entities);
+    }
+    /**
+     * Clear all caches
+     */
+    async clear() {
+        this.l1.clear();
+        this.l2.clear();
+        await this.l3.clear();
+    }
+    /**
+     * Perform tier demotion (move cold data down)
+     */
+    async performDemotion() {
+        // Get hot keys from L1
+        const hotKeys = new Set(this.l1.getHotKeys(100));
+        let demoted = 0;
+        // Demote cold entities from L1 to L2
+        // Note: This is a simplified implementation
+        // In production, would track access patterns more precisely
+        return demoted;
+    }
+    /**
+     * Get statistics for all tiers
+     */
+    getAllStats() {
+        return {
+            l1: this.l1.getStats(),
+            l2: this.l2.getStats(),
+            l3: this.l3.getStats(),
+        };
+    }
+    /**
+     * Get combined statistics
+     */
+    getCombinedStats() {
+        const l1Stats = this.l1.getStats();
+        const l2Stats = this.l2.getStats();
+        const l3Stats = this.l3.getStats();
+        const totalHits = l1Stats.hitCount + l2Stats.hitCount + l3Stats.hitCount;
+        const totalMisses = l1Stats.missCount + l2Stats.missCount + l3Stats.missCount;
+        const total = totalHits + totalMisses;
+        return {
+            tier: 'all',
+            hitCount: totalHits,
+            missCount: totalMisses,
+            hitRate: total > 0 ? totalHits / total : 0,
+            entryCount: l1Stats.entryCount + l2Stats.entryCount + l3Stats.entryCount,
+            sizeBytes: l1Stats.sizeBytes + l2Stats.sizeBytes + l3Stats.sizeBytes,
+            evictionCount: l1Stats.evictionCount + l2Stats.evictionCount + l3Stats.evictionCount,
+        };
+    }
+    /**
+     * Get L1 cache
+     */
+    getL1() {
+        return this.l1;
+    }
+    /**
+     * Get L2 cache
+     */
+    getL2() {
+        return this.l2;
+    }
+    /**
+     * Get L3 cache
+     */
+    getL3() {
+        return this.l3;
+    }
+    /**
+     * Get invalidation manager
+     */
+    getInvalidationManager() {
+        return this.invalidation;
+    }
+    /**
+     * Close the cache manager
+     */
+    async close() {
+        this.invalidation.close();
+        await this.l3.close();
+    }
+}
+//# sourceMappingURL=CacheManager.js.map

package/dist/cache/CacheManager.js.map

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

package/dist/cache/InvalidationManager.d.ts

@@ -0,0 +1,91 @@
+/**
+ * @nahisaho/yata-scale - Cache Invalidation Manager
+ *
+ * Manages cache invalidation across tiers
+ */
+import type { Entity } from '../types.js';
+/**
+ * Invalidation event
+ */
+export interface InvalidationEvent {
+    readonly type: 'entity' | 'relationship';
+    readonly id: string;
+    readonly operation: 'update' | 'delete';
+    readonly timestamp: Date;
+}
+/**
+ * Invalidation listener
+ */
+export type InvalidationListener = (event: InvalidationEvent) => void;
+/**
+ * Invalidation pattern for bulk invalidation
+ */
+export interface InvalidationPattern {
+    readonly type?: string;
+    readonly namespace?: string;
+    readonly idPrefix?: string;
+}
+/**
+ * Cache invalidation manager
+ */
+export declare class InvalidationManager {
+    private listeners;
+    private pendingInvalidations;
+    private batchTimeout;
+    private readonly batchSize;
+    private readonly batchDelayMs;
+    constructor(batchSize?: number, batchDelayMs?: number);
+    /**
+     * Invalidate an entity
+     */
+    invalidateEntity(id: string, operation?: 'update' | 'delete'): void;
+    /**
+     * Invalidate a relationship
+     */
+    invalidateRelationship(id: string, operation?: 'update' | 'delete'): void;
+    /**
+     * Invalidate multiple entities
+     */
+    invalidateEntities(ids: string[], operation?: 'update' | 'delete'): void;
+    /**
+     * Invalidate by pattern
+     */
+    invalidateByPattern(pattern: InvalidationPattern, entities: Entity[]): void;
+    /**
+     * Queue an invalidation event
+     */
+    private queueInvalidation;
+    /**
+     * Flush pending invalidations immediately
+     */
+    flushNow(): void;
+    /**
+     * Notify all listeners
+     */
+    private notifyListeners;
+    /**
+     * Add invalidation listener
+     */
+    addListener(listener: InvalidationListener): void;
+    /**
+     * Remove invalidation listener
+     */
+    removeListener(listener: InvalidationListener): void;
+    /**
+     * Clear all listeners
+     */
+    clearListeners(): void;
+    /**
+     * Get pending invalidation count
+     */
+    get pendingCount(): number;
+    /**
+     * Get listener count
+     */
+    get listenerCount(): number;
+    /**
+     * Close the manager
+     */
+    close(): void;
+}
+//# sourceMappingURL=InvalidationManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"InvalidationManager.d.ts","sourceRoot":"","sources":["../../src/cache/InvalidationManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAgB,MAAM,aAAa,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,CAAC;IACzC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,oBAAoB,CAA2B;IACvD,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,SAAS,GAAE,MAAY,EAAE,YAAY,GAAE,MAAW;IAK9D;;OAEG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,GAAE,QAAQ,GAAG,QAAmB,GAAG,IAAI;IAS7E;;OAEG;IACH,sBAAsB,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,GAAE,QAAQ,GAAG,QAAmB,GAAG,IAAI;IASnF;;OAEG;IACH,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,SAAS,GAAE,QAAQ,GAAG,QAAmB,GAAG,IAAI;IAMlF;;OAEG;IACH,mBAAmB,CACjB,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,EAAE,MAAM,EAAE,GACjB,IAAI;IAsBP;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAyBhB;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAIjD;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAIpD;;OAEG;IACH,cAAc,IAAI,IAAI;IAItB;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}

package/dist/cache/InvalidationManager.js

@@ -0,0 +1,155 @@
+/**
+ * @nahisaho/yata-scale - Cache Invalidation Manager
+ *
+ * Manages cache invalidation across tiers
+ */
+/**
+ * Cache invalidation manager
+ */
+export class InvalidationManager {
+    listeners = new Set();
+    pendingInvalidations = [];
+    batchTimeout = null;
+    batchSize;
+    batchDelayMs;
+    constructor(batchSize = 100, batchDelayMs = 10) {
+        this.batchSize = batchSize;
+        this.batchDelayMs = batchDelayMs;
+    }
+    /**
+     * Invalidate an entity
+     */
+    invalidateEntity(id, operation = 'update') {
+        this.queueInvalidation({
+            type: 'entity',
+            id,
+            operation,
+            timestamp: new Date(),
+        });
+    }
+    /**
+     * Invalidate a relationship
+     */
+    invalidateRelationship(id, operation = 'update') {
+        this.queueInvalidation({
+            type: 'relationship',
+            id,
+            operation,
+            timestamp: new Date(),
+        });
+    }
+    /**
+     * Invalidate multiple entities
+     */
+    invalidateEntities(ids, operation = 'update') {
+        for (const id of ids) {
+            this.invalidateEntity(id, operation);
+        }
+    }
+    /**
+     * Invalidate by pattern
+     */
+    invalidateByPattern(pattern, entities) {
+        for (const entity of entities) {
+            let matches = true;
+            if (pattern.type && entity.type !== pattern.type) {
+                matches = false;
+            }
+            if (pattern.namespace && entity.namespace !== pattern.namespace) {
+                matches = false;
+            }
+            if (pattern.idPrefix && !entity.id.startsWith(pattern.idPrefix)) {
+                matches = false;
+            }
+            if (matches) {
+                this.invalidateEntity(entity.id);
+            }
+        }
+    }
+    /**
+     * Queue an invalidation event
+     */
+    queueInvalidation(event) {
+        this.pendingInvalidations.push(event);
+        if (this.pendingInvalidations.length >= this.batchSize) {
+            this.flushNow();
+        }
+        else if (!this.batchTimeout) {
+            this.batchTimeout = setTimeout(() => this.flushNow(), this.batchDelayMs);
+        }
+    }
+    /**
+     * Flush pending invalidations immediately
+     */
+    flushNow() {
+        if (this.batchTimeout) {
+            clearTimeout(this.batchTimeout);
+            this.batchTimeout = null;
+        }
+        if (this.pendingInvalidations.length === 0) {
+            return;
+        }
+        const events = this.pendingInvalidations;
+        this.pendingInvalidations = [];
+        // Deduplicate by id (keep latest)
+        const deduped = new Map();
+        for (const event of events) {
+            deduped.set(event.id, event);
+        }
+        // Notify listeners
+        for (const event of deduped.values()) {
+            this.notifyListeners(event);
+        }
+    }
+    /**
+     * Notify all listeners
+     */
+    notifyListeners(event) {
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch (error) {
+                console.error('Invalidation listener error:', error);
+            }
+        }
+    }
+    /**
+     * Add invalidation listener
+     */
+    addListener(listener) {
+        this.listeners.add(listener);
+    }
+    /**
+     * Remove invalidation listener
+     */
+    removeListener(listener) {
+        this.listeners.delete(listener);
+    }
+    /**
+     * Clear all listeners
+     */
+    clearListeners() {
+        this.listeners.clear();
+    }
+    /**
+     * Get pending invalidation count
+     */
+    get pendingCount() {
+        return this.pendingInvalidations.length;
+    }
+    /**
+     * Get listener count
+     */
+    get listenerCount() {
+        return this.listeners.size;
+    }
+    /**
+     * Close the manager
+     */
+    close() {
+        this.flushNow();
+        this.clearListeners();
+    }
+}
+//# sourceMappingURL=InvalidationManager.js.map

package/dist/cache/InvalidationManager.js.map

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

package/dist/cache/L1Cache.d.ts

@@ -0,0 +1,97 @@
+/**
+ * @nahisaho/yata-scale - L1 Cache (Hot)
+ *
+ * In-memory LRU cache for frequently accessed data
+ */
+import type { CacheStats, Entity, Relationship } from '../types.js';
+/**
+ * L1 Cache - Hot tier, in-memory LRU
+ */
+export declare class L1Cache {
+    private readonly entityCache;
+    private readonly relationshipCache;
+    private hits;
+    private misses;
+    constructor(maxEntries?: number);
+    /**
+     * Get entity from cache
+     */
+    getEntity(id: string): Entity | undefined;
+    /**
+     * Set entity in cache
+     */
+    setEntity(entity: Entity): void;
+    /**
+     * Delete entity from cache
+     */
+    deleteEntity(id: string): boolean;
+    /**
+     * Get relationship from cache
+     */
+    getRelationship(id: string): Relationship | undefined;
+    /**
+     * Set relationship in cache
+     */
+    setRelationship(relationship: Relationship): void;
+    /**
+     * Delete relationship from cache
+     */
+    deleteRelationship(id: string): boolean;
+    /**
+     * Check if entity exists in cache
+     */
+    hasEntity(id: string): boolean;
+    /**
+     * Check if relationship exists in cache
+     */
+    hasRelationship(id: string): boolean;
+    /**
+     * Get multiple entities
+     */
+    getEntities(ids: string[]): Map<string, Entity>;
+    /**
+     * Set multiple entities
+     */
+    setEntities(entities: Entity[]): void;
+    /**
+     * Clear all caches
+     */
+    clear(): void;
+    /**
+     * Get hot keys (most accessed)
+     */
+    getHotKeys(limit?: number): string[];
+    /**
+     * Prewarm cache with entities
+     */
+    prewarm(entities: Entity[]): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): CacheStats;
+    /**
+     * Estimate memory size
+     */
+    private estimateSize;
+    /**
+     * Estimate entity size in bytes
+     */
+    private estimateEntitySize;
+    /**
+     * Estimate relationship size in bytes
+     */
+    private estimateRelationshipSize;
+    /**
+     * Get entity count
+     */
+    get entityCount(): number;
+    /**
+     * Get relationship count
+     */
+    get relationshipCount(): number;
+    /**
+     * Get total entry count
+     */
+    get size(): number;
+}
+//# sourceMappingURL=L1Cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"L1Cache.d.ts","sourceRoot":"","sources":["../../src/cache/L1Cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAWpE;;GAEG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuC;IACnE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA6C;IAC/E,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,MAAM,CAAa;gBAEf,UAAU,GAAE,MAAc;IAWtC;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAYzC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ/B;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACH,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAYrD;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI;IAQjD;;OAEG;IACH,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIvC;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI9B;;OAEG;IACH,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIpC;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAW/C;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAMrC;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,UAAU,CAAC,KAAK,GAAE,MAAW,GAAG,MAAM,EAAE;IAiBxC;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAMjC;;OAEG;IACH,QAAQ,IAAI,UAAU;IAatB;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAShC;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}