@lov3kaizen/agentsea-cache 0.5.1

package/dist/invalidation/index.d.ts

@@ -0,0 +1,113 @@
+import EventEmitter from 'eventemitter3';
+import { B as BaseCacheStore } from '../store.types-BQy5Yyz9.js';
+import '../cache.types-DMuyQseO.js';
+
+type InvalidationStrategyType = 'ttl' | 'lru' | 'event' | 'smart' | 'manual';
+interface BaseInvalidationConfig {
+    type: InvalidationStrategyType;
+    autoRun?: boolean;
+    checkIntervalMs?: number;
+}
+interface TTLInvalidationConfig extends BaseInvalidationConfig {
+    type: 'ttl';
+    defaultTtl: number;
+    modelTtls?: Record<string, number>;
+    namespaceTtls?: Record<string, number>;
+    softTtl?: boolean;
+    gracePeriod?: number;
+}
+interface LRUInvalidationConfig extends BaseInvalidationConfig {
+    type: 'lru';
+    maxEntries: number;
+    maxSizeBytes?: number;
+    evictionBatchSize?: number;
+    minAge?: number;
+}
+interface EventInvalidationConfig extends BaseInvalidationConfig {
+    type: 'event';
+    events: string[];
+    patterns?: InvalidationPattern[];
+    propagate?: boolean;
+}
+interface InvalidationPattern {
+    event: string | RegExp;
+    keyPattern: string | RegExp;
+    namespace?: string;
+    model?: string;
+}
+interface SmartInvalidationConfig extends BaseInvalidationConfig {
+    type: 'smart';
+    detectStaleness?: boolean;
+    analyzeHitRate?: boolean;
+    minHitRate?: number;
+    learnAccessPatterns?: boolean;
+    historicalWindowHours?: number;
+}
+interface InvalidationEvent {
+    timestamp: number;
+    keys: string[];
+    reason: 'ttl' | 'lru' | 'event' | 'smart' | 'manual';
+    entriesRemoved: number;
+    bytesFreed: number;
+    metadata?: Record<string, unknown>;
+}
+interface InvalidationResult {
+    invalidatedKeys: string[];
+    entriesRemoved: number;
+    bytesFreed: number;
+    durationMs: number;
+    errors?: string[];
+}
+interface InvalidationManagerConfig {
+    strategy: InvalidationStrategyType;
+    ttl?: Omit<TTLInvalidationConfig, 'type'>;
+    lru?: Omit<LRUInvalidationConfig, 'type'>;
+    event?: Omit<EventInvalidationConfig, 'type'>;
+    smart?: Omit<SmartInvalidationConfig, 'type'>;
+    emitEvents?: boolean;
+    onInvalidate?: (event: InvalidationEvent) => void;
+}
+interface InvalidationStats {
+    totalInvalidations: number;
+    ttlRemovals: number;
+    lruRemovals: number;
+    eventRemovals: number;
+    smartRemovals: number;
+    manualRemovals: number;
+    totalBytesFreed: number;
+    lastInvalidationAt?: number;
+}
+
+interface InvalidationManagerEvents {
+    invalidate: (event: InvalidationEvent) => void;
+    error: (error: Error) => void;
+}
+declare class InvalidationManager extends EventEmitter<InvalidationManagerEvents> {
+    private store;
+    private config;
+    private autoInterval;
+    private stats;
+    private accessTimes;
+    constructor(store: BaseCacheStore, config?: InvalidationManagerConfig);
+    run(): Promise<InvalidationResult>;
+    runTTLInvalidation(): Promise<InvalidationResult>;
+    runLRUInvalidation(): Promise<InvalidationResult>;
+    runSmartInvalidation(): Promise<InvalidationResult>;
+    invalidateKeys(keys: string[]): Promise<InvalidationResult>;
+    invalidateByPattern(options: {
+        namespace?: string;
+        model?: string;
+        olderThan?: number;
+    }): Promise<InvalidationResult>;
+    startAuto(intervalMs?: number): void;
+    stopAuto(): void;
+    getStats(): InvalidationStats;
+    resetStats(): void;
+    destroy(): void;
+    private getTTL;
+    private estimateEntrySize;
+    private emitEvent;
+}
+declare function createInvalidationManager(store: BaseCacheStore, config?: InvalidationManagerConfig): InvalidationManager;
+
+export { type BaseInvalidationConfig, type EventInvalidationConfig, type InvalidationEvent, InvalidationManager, type InvalidationManagerConfig, type InvalidationManagerEvents, type InvalidationPattern, type InvalidationResult, type InvalidationStats, type InvalidationStrategyType, type LRUInvalidationConfig, type SmartInvalidationConfig, type TTLInvalidationConfig, createInvalidationManager };

package/dist/invalidation/index.js

@@ -0,0 +1,360 @@
+import EventEmitter from 'eventemitter3';
+import 'nanoid';
+
+// src/invalidation/InvalidationManager.ts
+function now() {
+  return Date.now();
+}
+
+// src/invalidation/InvalidationManager.ts
+var DEFAULT_CONFIG = {
+  strategy: "ttl",
+  ttl: {
+    defaultTtl: 3600,
+    softTtl: false
+  },
+  emitEvents: true
+};
+var InvalidationManager = class extends EventEmitter {
+  store;
+  config;
+  autoInterval = null;
+  stats = {
+    totalInvalidations: 0,
+    ttlRemovals: 0,
+    lruRemovals: 0,
+    eventRemovals: 0,
+    smartRemovals: 0,
+    manualRemovals: 0,
+    totalBytesFreed: 0
+  };
+  accessTimes = /* @__PURE__ */ new Map();
+  constructor(store, config) {
+    super();
+    this.store = store;
+    this.config = { ...DEFAULT_CONFIG, ...config };
+  }
+  /**
+   * Run invalidation based on configured strategy
+   */
+  async run() {
+    switch (this.config.strategy) {
+      case "ttl":
+        return this.runTTLInvalidation();
+      case "lru":
+        return this.runLRUInvalidation();
+      case "smart":
+        return this.runSmartInvalidation();
+      default:
+        return this.runTTLInvalidation();
+    }
+  }
+  /**
+   * Run TTL-based invalidation
+   */
+  async runTTLInvalidation() {
+    const startTime = performance.now();
+    const invalidatedKeys = [];
+    let bytesFreed = 0;
+    const currentTime = now();
+    const keys = await this.store.keys();
+    for (const key of keys) {
+      const entry = await this.store.get(key);
+      if (!entry) continue;
+      const ttl = entry.metadata.ttl ?? this.getTTL(entry.request.model, entry.metadata.namespace);
+      const age = (currentTime - entry.metadata.createdAt) / 1e3;
+      if (age >= ttl) {
+        if (this.config.ttl?.softTtl && this.config.ttl?.gracePeriod) {
+          if (age < ttl + this.config.ttl.gracePeriod) {
+            continue;
+          }
+        }
+        const deleted = await this.store.delete(key);
+        if (deleted) {
+          invalidatedKeys.push(key);
+          bytesFreed += this.estimateEntrySize(entry);
+        }
+      }
+    }
+    this.stats.totalInvalidations++;
+    this.stats.ttlRemovals += invalidatedKeys.length;
+    this.stats.totalBytesFreed += bytesFreed;
+    this.stats.lastInvalidationAt = now();
+    const result = {
+      invalidatedKeys,
+      entriesRemoved: invalidatedKeys.length,
+      bytesFreed,
+      durationMs: performance.now() - startTime
+    };
+    this.emitEvent("ttl", invalidatedKeys, bytesFreed);
+    return result;
+  }
+  /**
+   * Run LRU-based invalidation
+   */
+  async runLRUInvalidation() {
+    const startTime = performance.now();
+    const invalidatedKeys = [];
+    let bytesFreed = 0;
+    const maxEntries = this.config.lru?.maxEntries ?? 1e3;
+    this.config.lru?.maxSizeBytes ?? Infinity;
+    const batchSize = this.config.lru?.evictionBatchSize ?? 10;
+    const minAge = this.config.lru?.minAge ?? 0;
+    const currentSize = await this.store.size();
+    if (currentSize <= maxEntries) {
+      return {
+        invalidatedKeys: [],
+        entriesRemoved: 0,
+        bytesFreed: 0,
+        durationMs: performance.now() - startTime
+      };
+    }
+    const keys = await this.store.keys();
+    const entriesWithAccess = [];
+    for (const key of keys) {
+      const entry = await this.store.get(key);
+      if (entry) {
+        entriesWithAccess.push({
+          key,
+          accessedAt: entry.metadata.accessedAt,
+          size: this.estimateEntrySize(entry)
+        });
+      }
+    }
+    entriesWithAccess.sort((a, b) => a.accessedAt - b.accessedAt);
+    const toRemove = Math.min(currentSize - maxEntries, batchSize);
+    const currentTime = now();
+    for (let i = 0; i < toRemove && i < entriesWithAccess.length; i++) {
+      const { key, accessedAt, size } = entriesWithAccess[i];
+      const age = (currentTime - accessedAt) / 1e3;
+      if (age < minAge) continue;
+      const deleted = await this.store.delete(key);
+      if (deleted) {
+        invalidatedKeys.push(key);
+        bytesFreed += size;
+      }
+    }
+    this.stats.totalInvalidations++;
+    this.stats.lruRemovals += invalidatedKeys.length;
+    this.stats.totalBytesFreed += bytesFreed;
+    this.stats.lastInvalidationAt = now();
+    const result = {
+      invalidatedKeys,
+      entriesRemoved: invalidatedKeys.length,
+      bytesFreed,
+      durationMs: performance.now() - startTime
+    };
+    this.emitEvent("lru", invalidatedKeys, bytesFreed);
+    return result;
+  }
+  /**
+   * Run smart invalidation (combines TTL + LRU + hit rate analysis)
+   */
+  async runSmartInvalidation() {
+    const startTime = performance.now();
+    const invalidatedKeys = [];
+    let bytesFreed = 0;
+    const minHitRate = this.config.smart?.minHitRate ?? 0.1;
+    const currentTime = now();
+    const keys = await this.store.keys();
+    for (const key of keys) {
+      const entry = await this.store.get(key);
+      if (!entry) continue;
+      let shouldInvalidate = false;
+      const ttl = entry.metadata.ttl ?? this.getTTL(entry.request.model, entry.metadata.namespace);
+      const age = (currentTime - entry.metadata.createdAt) / 1e3;
+      if (age >= ttl) {
+        shouldInvalidate = true;
+      }
+      if (this.config.smart?.analyzeHitRate && entry.metadata.accessCount > 0) {
+        const accessRate = entry.metadata.accessCount / Math.max(age / 3600, 1);
+        if (accessRate < minHitRate) {
+          shouldInvalidate = true;
+        }
+      }
+      if (shouldInvalidate) {
+        const deleted = await this.store.delete(key);
+        if (deleted) {
+          invalidatedKeys.push(key);
+          bytesFreed += this.estimateEntrySize(entry);
+        }
+      }
+    }
+    this.stats.totalInvalidations++;
+    this.stats.smartRemovals += invalidatedKeys.length;
+    this.stats.totalBytesFreed += bytesFreed;
+    this.stats.lastInvalidationAt = now();
+    const result = {
+      invalidatedKeys,
+      entriesRemoved: invalidatedKeys.length,
+      bytesFreed,
+      durationMs: performance.now() - startTime
+    };
+    this.emitEvent("smart", invalidatedKeys, bytesFreed);
+    return result;
+  }
+  /**
+   * Manually invalidate specific keys
+   */
+  async invalidateKeys(keys) {
+    const startTime = performance.now();
+    const invalidatedKeys = [];
+    let bytesFreed = 0;
+    for (const key of keys) {
+      const entry = await this.store.get(key);
+      if (entry) {
+        const size = this.estimateEntrySize(entry);
+        const deleted = await this.store.delete(key);
+        if (deleted) {
+          invalidatedKeys.push(key);
+          bytesFreed += size;
+        }
+      }
+    }
+    this.stats.totalInvalidations++;
+    this.stats.manualRemovals += invalidatedKeys.length;
+    this.stats.totalBytesFreed += bytesFreed;
+    this.stats.lastInvalidationAt = now();
+    const result = {
+      invalidatedKeys,
+      entriesRemoved: invalidatedKeys.length,
+      bytesFreed,
+      durationMs: performance.now() - startTime
+    };
+    this.emitEvent("manual", invalidatedKeys, bytesFreed);
+    return result;
+  }
+  /**
+   * Invalidate by pattern (e.g., namespace or model)
+   */
+  async invalidateByPattern(options) {
+    const startTime = performance.now();
+    const invalidatedKeys = [];
+    let bytesFreed = 0;
+    const currentTime = now();
+    const keys = await this.store.keys();
+    for (const key of keys) {
+      const entry = await this.store.get(key);
+      if (!entry) continue;
+      let matches = true;
+      if (options.namespace && entry.metadata.namespace !== options.namespace) {
+        matches = false;
+      }
+      if (options.model && entry.request.model !== options.model) {
+        matches = false;
+      }
+      if (options.olderThan) {
+        const age = (currentTime - entry.metadata.createdAt) / 1e3;
+        if (age < options.olderThan) {
+          matches = false;
+        }
+      }
+      if (matches) {
+        const size = this.estimateEntrySize(entry);
+        const deleted = await this.store.delete(key);
+        if (deleted) {
+          invalidatedKeys.push(key);
+          bytesFreed += size;
+        }
+      }
+    }
+    this.stats.totalInvalidations++;
+    this.stats.manualRemovals += invalidatedKeys.length;
+    this.stats.totalBytesFreed += bytesFreed;
+    this.stats.lastInvalidationAt = now();
+    const result = {
+      invalidatedKeys,
+      entriesRemoved: invalidatedKeys.length,
+      bytesFreed,
+      durationMs: performance.now() - startTime
+    };
+    this.emitEvent("manual", invalidatedKeys, bytesFreed);
+    return result;
+  }
+  /**
+   * Start automatic invalidation
+   */
+  startAuto(intervalMs = 6e4) {
+    if (this.autoInterval) {
+      this.stopAuto();
+    }
+    this.autoInterval = setInterval(() => {
+      void (async () => {
+        try {
+          await this.run();
+        } catch (error) {
+          this.emit("error", error);
+        }
+      })();
+    }, intervalMs);
+  }
+  /**
+   * Stop automatic invalidation
+   */
+  stopAuto() {
+    if (this.autoInterval) {
+      clearInterval(this.autoInterval);
+      this.autoInterval = null;
+    }
+  }
+  /**
+   * Get invalidation statistics
+   */
+  getStats() {
+    return { ...this.stats };
+  }
+  /**
+   * Reset statistics
+   */
+  resetStats() {
+    this.stats = {
+      totalInvalidations: 0,
+      ttlRemovals: 0,
+      lruRemovals: 0,
+      eventRemovals: 0,
+      smartRemovals: 0,
+      manualRemovals: 0,
+      totalBytesFreed: 0
+    };
+  }
+  /**
+   * Destroy the manager
+   */
+  destroy() {
+    this.stopAuto();
+    this.removeAllListeners();
+    this.accessTimes.clear();
+  }
+  getTTL(model, namespace) {
+    if (this.config.ttl?.modelTtls?.[model]) {
+      return this.config.ttl.modelTtls[model];
+    }
+    if (namespace && this.config.ttl?.namespaceTtls?.[namespace]) {
+      return this.config.ttl.namespaceTtls[namespace];
+    }
+    return this.config.ttl?.defaultTtl ?? 3600;
+  }
+  estimateEntrySize(entry) {
+    return entry.response.content.length * 2 + 200;
+  }
+  emitEvent(reason, keys, bytesFreed) {
+    if (this.config.emitEvents && keys.length > 0) {
+      const event = {
+        timestamp: now(),
+        keys,
+        reason,
+        entriesRemoved: keys.length,
+        bytesFreed
+      };
+      this.emit("invalidate", event);
+      this.config.onInvalidate?.(event);
+    }
+  }
+};
+function createInvalidationManager(store, config) {
+  return new InvalidationManager(store, config);
+}
+
+export { InvalidationManager, createInvalidationManager };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/invalidation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/utils.ts","../../src/invalidation/InvalidationManager.ts"],"names":[],"mappings":";;;;AAmBO,SAAS,GAAA,GAAc;AAC5B,EAAA,OAAO,KAAK,GAAA,EAAI;AAClB;;;ACMA,IAAM,cAAA,GAA4C;AAAA,EAChD,QAAA,EAAU,KAAA;AAAA,EACV,GAAA,EAAK;AAAA,IACH,UAAA,EAAY,IAAA;AAAA,IACZ,OAAA,EAAS;AAAA,GACX;AAAA,EACA,UAAA,EAAY;AACd,CAAA;AAqBO,IAAM,mBAAA,GAAN,cAAkC,YAAA,CAAwC;AAAA,EACvE,KAAA;AAAA,EACA,MAAA;AAAA,EACA,YAAA,GAAsD,IAAA;AAAA,EACtD,KAAA,GAA2B;AAAA,IACjC,kBAAA,EAAoB,CAAA;AAAA,IACpB,WAAA,EAAa,CAAA;AAAA,IACb,WAAA,EAAa,CAAA;AAAA,IACb,aAAA,EAAe,CAAA;AAAA,IACf,aAAA,EAAe,CAAA;AAAA,IACf,cAAA,EAAgB,CAAA;AAAA,IAChB,eAAA,EAAiB;AAAA,GACnB;AAAA,EACQ,WAAA,uBAAuC,GAAA,EAAI;AAAA,EAEnD,WAAA,CAAY,OAAuB,MAAA,EAAoC;AACrE,IAAA,KAAA,EAAM;AACN,IAAA,IAAA,CAAK,KAAA,GAAQ,KAAA;AACb,IAAA,IAAA,CAAK,MAAA,GAAS,EAAE,GAAG,cAAA,EAAgB,GAAG,MAAA,EAAO;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,GAAA,GAAmC;AACvC,IAAA,QAAQ,IAAA,CAAK,OAAO,QAAA;AAAU,MAC5B,KAAK,KAAA;AACH,QAAA,OAAO,KAAK,kBAAA,EAAmB;AAAA,MACjC,KAAK,KAAA;AACH,QAAA,OAAO,KAAK,kBAAA,EAAmB;AAAA,MACjC,KAAK,OAAA;AACH,QAAA,OAAO,KAAK,oBAAA,EAAqB;AAAA,MACnC;AACE,QAAA,OAAO,KAAK,kBAAA,EAAmB;AAAA;AACnC,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,kBAAA,GAAkD;AACtD,IAAA,MAAM,SAAA,GAAY,YAAY,GAAA,EAAI;AAClC,IAAA,MAAM,kBAA4B,EAAC;AACnC,IAAA,IAAI,UAAA,GAAa,CAAA;AACjB,IAAA,MAAM,cAAc,GAAA,EAAI;AAExB,IAAA,MAAM,IAAA,GAAO,MAAM,IAAA,CAAK,KAAA,CAAM,IAAA,EAAK;AAEnC,IAAA,KAAA,MAAW,OAAO,IAAA,EAAM;AACtB,MAAA,MAAM,KAAA,GAAQ,MAAM,IAAA,CAAK,KAAA,CAAM,IAAI,GAAG,CAAA;AACtC,MAAA,IAAI,CAAC,KAAA,EAAO;AAGZ,MAAA,MAAM,GAAA,GACJ,KAAA,CAAM,QAAA,CAAS,GAAA,IACf,IAAA,CAAK,MAAA,CAAO,KAAA,CAAM,OAAA,CAAQ,KAAA,EAAO,KAAA,CAAM,QAAA,CAAS,SAAS,CAAA;AAC3D,MAAA,MAAM,GAAA,GAAA,CAAO,WAAA,GAAc,KAAA,CAAM,QAAA,CAAS,SAAA,IAAa,GAAA;AAEvD,MAAA,IAAI,OAAO,GAAA,EAAK;AAEd,QAAA,IAAI,KAAK,MAAA,CAAO,GAAA,EAAK,WAAW,IAAA,CAAK,MAAA,CAAO,KAAK,WAAA,EAAa;AAC5D,UAAA,IAAI,GAAA,GAAM,GAAA,GAAM,IAAA,CAAK,MAAA,CAAO,IAAI,WAAA,EAAa;AAE3C,YAAA;AAAA,UACF;AAAA,QACF;AAEA,QAAA,MAAM,OAAA,GAAU,MAAM,IAAA,CAAK,KAAA,CAAM,OAAO,GAAG,CAAA;AAC3C,QAAA,IAAI,OAAA,EAAS;AACX,UAAA,eAAA,CAAgB,KAAK,GAAG,CAAA;AACxB,UAAA,UAAA,IAAc,IAAA,CAAK,kBAAkB,KAAK,CAAA;AAAA,QAC5C;AAAA,MACF;AAAA,IACF;AAEA,IAAA,IAAA,CAAK,KAAA,CAAM,kBAAA,EAAA;AACX,IAAA,IAAA,CAAK,KAAA,CAAM,eAAe,eAAA,CAAgB,MAAA;AAC1C,IAAA,IAAA,CAAK,MAAM,eAAA,IAAmB,UAAA;AAC9B,IAAA,IAAA,CAAK,KAAA,CAAM,qBAAqB,GAAA,EAAI;AAEpC,IAAA,MAAM,MAAA,GAA6B;AAAA,MACjC,eAAA;AAAA,MACA,gBAAgB,eAAA,CAAgB,MAAA;AAAA,MAChC,UAAA;AAAA,MACA,UAAA,EAAY,WAAA,CAAY,GAAA,EAAI,GAAI;AAAA,KAClC;AAEA,IAAA,IAAA,CAAK,SAAA,CAAU,KAAA,EAAO,eAAA,EAAiB,UAAU,CAAA;AACjD,IAAA,OAAO,MAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,kBAAA,GAAkD;AACtD,IAAA,MAAM,SAAA,GAAY,YAAY,GAAA,EAAI;AAClC,IAAA,MAAM,kBAA4B,EAAC;AACnC,IAAA,IAAI,UAAA,GAAa,CAAA;AAEjB,IAAA,MAAM,UAAA,GAAa,IAAA,CAAK,MAAA,CAAO,GAAA,EAAK,UAAA,IAAc,GAAA;AAClD,IAAsB,IAAA,CAAK,MAAA,CAAO,GAAA,EAAK,YAAA,IAAgB;AACvD,IAAA,MAAM,SAAA,GAAY,IAAA,CAAK,MAAA,CAAO,GAAA,EAAK,iBAAA,IAAqB,EAAA;AACxD,IAAA,MAAM,MAAA,GAAS,IAAA,CAAK,MAAA,CAAO,GAAA,EAAK,MAAA,IAAU,CAAA;AAE1C,IAAA,MAAM,WAAA,GAAc,MAAM,IAAA,CAAK,KAAA,CAAM,IAAA,EAAK;AAC1C,IAAA,IAAI,eAAe,UAAA,EAAY;AAC7B,MAAA,OAAO;AAAA,QACL,iBAAiB,EAAC;AAAA,QAClB,cAAA,EAAgB,CAAA;AAAA,QAChB,UAAA,EAAY,CAAA;AAAA,QACZ,UAAA,EAAY,WAAA,CAAY,GAAA,EAAI,GAAI;AAAA,OAClC;AAAA,IACF;AAGA,IAAA,MAAM,IAAA,GAAO,MAAM,IAAA,CAAK,KAAA,CAAM,IAAA,EAAK;AACnC,IAAA,MAAM,oBAID,EAAC;AAEN,IAAA,KAAA,MAAW,OAAO,IAAA,EAAM;AACtB,MAAA,MAAM,KAAA,GAAQ,MAAM,IAAA,CAAK,KAAA,CAAM,IAAI,GAAG,CAAA;AACtC,MAAA,IAAI,KAAA,EAAO;AACT,QAAA,iBAAA,CAAkB,IAAA,CAAK;AAAA,UACrB,GAAA;AAAA,UACA,UAAA,EAAY,MAAM,QAAA,CAAS,UAAA;AAAA,UAC3B,IAAA,EAAM,IAAA,CAAK,iBAAA,CAAkB,KAAK;AAAA,SACnC,CAAA;AAAA,MACH;AAAA,IACF;AAGA,IAAA,iBAAA,CAAkB,KAAK,CAAC,CAAA,EAAG,MAAM,CAAA,CAAE,UAAA,GAAa,EAAE,UAAU,CAAA;AAG5D,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,GAAA,CAAI,WAAA,GAAc,YAAY,SAAS,CAAA;AAC7D,IAAA,MAAM,cAAc,GAAA,EAAI;AAExB,IAAA,KAAA,IAAS,IAAI,CAAA,EAAG,CAAA,GAAI,YAAY,CAAA,GAAI,iBAAA,CAAkB,QAAQ,CAAA,EAAA,EAAK;AACjE,MAAA,MAAM,EAAE,GAAA,EAAK,UAAA,EAAY,IAAA,EAAK,GAAI,kBAAkB,CAAC,CAAA;AAGrD,MAAA,MAAM,GAAA,GAAA,CAAO,cAAc,UAAA,IAAc,GAAA;AACzC,MAAA,IAAI,MAAM,MAAA,EAAQ;AAElB,MAAA,MAAM,OAAA,GAAU,MAAM,IAAA,CAAK,KAAA,CAAM,OAAO,GAAG,CAAA;AAC3C,MAAA,IAAI,OAAA,EAAS;AACX,QAAA,eAAA,CAAgB,KAAK,GAAG,CAAA;AACxB,QAAA,UAAA,IAAc,IAAA;AAAA,MAChB;AAAA,IACF;AAEA,IAAA,IAAA,CAAK,KAAA,CAAM,kBAAA,EAAA;AACX,IAAA,IAAA,CAAK,KAAA,CAAM,eAAe,eAAA,CAAgB,MAAA;AAC1C,IAAA,IAAA,CAAK,MAAM,eAAA,IAAmB,UAAA;AAC9B,IAAA,IAAA,CAAK,KAAA,CAAM,qBAAqB,GAAA,EAAI;AAEpC,IAAA,MAAM,MAAA,GAA6B;AAAA,MACjC,eAAA;AAAA,MACA,gBAAgB,eAAA,CAAgB,MAAA;AAAA,MAChC,UAAA;AAAA,MACA,UAAA,EAAY,WAAA,CAAY,GAAA,EAAI,GAAI;AAAA,KAClC;AAEA,IAAA,IAAA,CAAK,SAAA,CAAU,KAAA,EAAO,eAAA,EAAiB,UAAU,CAAA;AACjD,IAAA,OAAO,MAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,oBAAA,GAAoD;AACxD,IAAA,MAAM,SAAA,GAAY,YAAY,GAAA,EAAI;AAClC,IAAA,MAAM,kBAA4B,EAAC;AACnC,IAAA,IAAI,UAAA,GAAa,CAAA;AAEjB,IAAA,MAAM,UAAA,GAAa,IAAA,CAAK,MAAA,CAAO,KAAA,EAAO,UAAA,IAAc,GAAA;AACpD,IAAA,MAAM,cAAc,GAAA,EAAI;AAExB,IAAA,MAAM,IAAA,GAAO,MAAM,IAAA,CAAK,KAAA,CAAM,IAAA,EAAK;AAEnC,IAAA,KAAA,MAAW,OAAO,IAAA,EAAM;AACtB,MAAA,MAAM,KAAA,GAAQ,MAAM,IAAA,CAAK,KAAA,CAAM,IAAI,GAAG,CAAA;AACtC,MAAA,IAAI,CAAC,KAAA,EAAO;AAEZ,MAAA,IAAI,gBAAA,GAAmB,KAAA;AAIvB,MAAA,MAAM,GAAA,GACJ,KAAA,CAAM,QAAA,CAAS,GAAA,IACf,IAAA,CAAK,MAAA,CAAO,KAAA,CAAM,OAAA,CAAQ,KAAA,EAAO,KAAA,CAAM,QAAA,CAAS,SAAS,CAAA;AAC3D,MAAA,MAAM,GAAA,GAAA,CAAO,WAAA,GAAc,KAAA,CAAM,QAAA,CAAS,SAAA,IAAa,GAAA;AACvD,MAAA,IAAI,OAAO,GAAA,EAAK;AACd,QAAA,gBAAA,GAAmB,IAAA;AAAA,MACrB;AAGA,MAAA,IAAI,KAAK,MAAA,CAAO,KAAA,EAAO,kBAAkB,KAAA,CAAM,QAAA,CAAS,cAAc,CAAA,EAAG;AACvE,QAAA,MAAM,UAAA,GAAa,MAAM,QAAA,CAAS,WAAA,GAAc,KAAK,GAAA,CAAI,GAAA,GAAM,MAAM,CAAC,CAAA;AACtE,QAAA,IAAI,aAAa,UAAA,EAAY;AAC3B,UAAA,gBAAA,GAAmB,IAAA;AAAA,QACrB;AAAA,MACF;AAEA,MAAA,IAAI,gBAAA,EAAkB;AACpB,QAAA,MAAM,OAAA,GAAU,MAAM,IAAA,CAAK,KAAA,CAAM,OAAO,GAAG,CAAA;AAC3C,QAAA,IAAI,OAAA,EAAS;AACX,UAAA,eAAA,CAAgB,KAAK,GAAG,CAAA;AACxB,UAAA,UAAA,IAAc,IAAA,CAAK,kBAAkB,KAAK,CAAA;AAAA,QAC5C;AAAA,MACF;AAAA,IACF;AAEA,IAAA,IAAA,CAAK,KAAA,CAAM,kBAAA,EAAA;AACX,IAAA,IAAA,CAAK,KAAA,CAAM,iBAAiB,eAAA,CAAgB,MAAA;AAC5C,IAAA,IAAA,CAAK,MAAM,eAAA,IAAmB,UAAA;AAC9B,IAAA,IAAA,CAAK,KAAA,CAAM,qBAAqB,GAAA,EAAI;AAEpC,IAAA,MAAM,MAAA,GAA6B;AAAA,MACjC,eAAA;AAAA,MACA,gBAAgB,eAAA,CAAgB,MAAA;AAAA,MAChC,UAAA;AAAA,MACA,UAAA,EAAY,WAAA,CAAY,GAAA,EAAI,GAAI;AAAA,KAClC;AAEA,IAAA,IAAA,CAAK,SAAA,CAAU,OAAA,EAAS,eAAA,EAAiB,UAAU,CAAA;AACnD,IAAA,OAAO,MAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,eAAe,IAAA,EAA6C;AAChE,IAAA,MAAM,SAAA,GAAY,YAAY,GAAA,EAAI;AAClC,IAAA,MAAM,kBAA4B,EAAC;AACnC,IAAA,IAAI,UAAA,GAAa,CAAA;AAEjB,IAAA,KAAA,MAAW,OAAO,IAAA,EAAM;AACtB,MAAA,MAAM,KAAA,GAAQ,MAAM,IAAA,CAAK,KAAA,CAAM,IAAI,GAAG,CAAA;AACtC,MAAA,IAAI,KAAA,EAAO;AACT,QAAA,MAAM,IAAA,GAAO,IAAA,CAAK,iBAAA,CAAkB,KAAK,CAAA;AACzC,QAAA,MAAM,OAAA,GAAU,MAAM,IAAA,CAAK,KAAA,CAAM,OAAO,GAAG,CAAA;AAC3C,QAAA,IAAI,OAAA,EAAS;AACX,UAAA,eAAA,CAAgB,KAAK,GAAG,CAAA;AACxB,UAAA,UAAA,IAAc,IAAA;AAAA,QAChB;AAAA,MACF;AAAA,IACF;AAEA,IAAA,IAAA,CAAK,KAAA,CAAM,kBAAA,EAAA;AACX,IAAA,IAAA,CAAK,KAAA,CAAM,kBAAkB,eAAA,CAAgB,MAAA;AAC7C,IAAA,IAAA,CAAK,MAAM,eAAA,IAAmB,UAAA;AAC9B,IAAA,IAAA,CAAK,KAAA,CAAM,qBAAqB,GAAA,EAAI;AAEpC,IAAA,MAAM,MAAA,GAA6B;AAAA,MACjC,eAAA;AAAA,MACA,gBAAgB,eAAA,CAAgB,MAAA;AAAA,MAChC,UAAA;AAAA,MACA,UAAA,EAAY,WAAA,CAAY,GAAA,EAAI,GAAI;AAAA,KAClC;AAEA,IAAA,IAAA,CAAK,SAAA,CAAU,QAAA,EAAU,eAAA,EAAiB,UAAU,CAAA;AACpD,IAAA,OAAO,MAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,oBAAoB,OAAA,EAIM;AAC9B,IAAA,MAAM,SAAA,GAAY,YAAY,GAAA,EAAI;AAClC,IAAA,MAAM,kBAA4B,EAAC;AACnC,IAAA,IAAI,UAAA,GAAa,CAAA;AACjB,IAAA,MAAM,cAAc,GAAA,EAAI;AAExB,IAAA,MAAM,IAAA,GAAO,MAAM,IAAA,CAAK,KAAA,CAAM,IAAA,EAAK;AAEnC,IAAA,KAAA,MAAW,OAAO,IAAA,EAAM;AACtB,MAAA,MAAM,KAAA,GAAQ,MAAM,IAAA,CAAK,KAAA,CAAM,IAAI,GAAG,CAAA;AACtC,MAAA,IAAI,CAAC,KAAA,EAAO;AAEZ,MAAA,IAAI,OAAA,GAAU,IAAA;AAEd,MAAA,IAAI,QAAQ,SAAA,IAAa,KAAA,CAAM,QAAA,CAAS,SAAA,KAAc,QAAQ,SAAA,EAAW;AACvE,QAAA,OAAA,GAAU,KAAA;AAAA,MACZ;AAEA,MAAA,IAAI,QAAQ,KAAA,IAAS,KAAA,CAAM,OAAA,CAAQ,KAAA,KAAU,QAAQ,KAAA,EAAO;AAC1D,QAAA,OAAA,GAAU,KAAA;AAAA,MACZ;AAEA,MAAA,IAAI,QAAQ,SAAA,EAAW;AACrB,QAAA,MAAM,GAAA,GAAA,CAAO,WAAA,GAAc,KAAA,CAAM,QAAA,CAAS,SAAA,IAAa,GAAA;AACvD,QAAA,IAAI,GAAA,GAAM,QAAQ,SAAA,EAAW;AAC3B,UAAA,OAAA,GAAU,KAAA;AAAA,QACZ;AAAA,MACF;AAEA,MAAA,IAAI,OAAA,EAAS;AACX,QAAA,MAAM,IAAA,GAAO,IAAA,CAAK,iBAAA,CAAkB,KAAK,CAAA;AACzC,QAAA,MAAM,OAAA,GAAU,MAAM,IAAA,CAAK,KAAA,CAAM,OAAO,GAAG,CAAA;AAC3C,QAAA,IAAI,OAAA,EAAS;AACX,UAAA,eAAA,CAAgB,KAAK,GAAG,CAAA;AACxB,UAAA,UAAA,IAAc,IAAA;AAAA,QAChB;AAAA,MACF;AAAA,IACF;AAEA,IAAA,IAAA,CAAK,KAAA,CAAM,kBAAA,EAAA;AACX,IAAA,IAAA,CAAK,KAAA,CAAM,kBAAkB,eAAA,CAAgB,MAAA;AAC7C,IAAA,IAAA,CAAK,MAAM,eAAA,IAAmB,UAAA;AAC9B,IAAA,IAAA,CAAK,KAAA,CAAM,qBAAqB,GAAA,EAAI;AAEpC,IAAA,MAAM,MAAA,GAA6B;AAAA,MACjC,eAAA;AAAA,MACA,gBAAgB,eAAA,CAAgB,MAAA;AAAA,MAChC,UAAA;AAAA,MACA,UAAA,EAAY,WAAA,CAAY,GAAA,EAAI,GAAI;AAAA,KAClC;AAEA,IAAA,IAAA,CAAK,SAAA,CAAU,QAAA,EAAU,eAAA,EAAiB,UAAU,CAAA;AACpD,IAAA,OAAO,MAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,SAAA,CAAU,aAAa,GAAA,EAAa;AAClC,IAAA,IAAI,KAAK,YAAA,EAAc;AACrB,MAAA,IAAA,CAAK,QAAA,EAAS;AAAA,IAChB;AAEA,IAAA,IAAA,CAAK,YAAA,GAAe,YAAY,MAAM;AACpC,MAAA,KAAA,CAAM,YAAY;AAChB,QAAA,IAAI;AACF,UAAA,MAAM,KAAK,GAAA,EAAI;AAAA,QACjB,SAAS,KAAA,EAAO;AACd,UAAA,IAAA,CAAK,IAAA,CAAK,SAAS,KAAc,CAAA;AAAA,QACnC;AAAA,MACF,CAAA,GAAG;AAAA,IACL,GAAG,UAAU,CAAA;AAAA,EACf;AAAA;AAAA;AAAA;AAAA,EAKA,QAAA,GAAiB;AACf,IAAA,IAAI,KAAK,YAAA,EAAc;AACrB,MAAA,aAAA,CAAc,KAAK,YAAY,CAAA;AAC/B,MAAA,IAAA,CAAK,YAAA,GAAe,IAAA;AAAA,IACtB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,QAAA,GAA8B;AAC5B,IAAA,OAAO,EAAE,GAAG,IAAA,CAAK,KAAA,EAAM;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA,EAKA,UAAA,GAAmB;AACjB,IAAA,IAAA,CAAK,KAAA,GAAQ;AAAA,MACX,kBAAA,EAAoB,CAAA;AAAA,MACpB,WAAA,EAAa,CAAA;AAAA,MACb,WAAA,EAAa,CAAA;AAAA,MACb,aAAA,EAAe,CAAA;AAAA,MACf,aAAA,EAAe,CAAA;AAAA,MACf,cAAA,EAAgB,CAAA;AAAA,MAChB,eAAA,EAAiB;AAAA,KACnB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,OAAA,GAAgB;AACd,IAAA,IAAA,CAAK,QAAA,EAAS;AACd,IAAA,IAAA,CAAK,kBAAA,EAAmB;AACxB,IAAA,IAAA,CAAK,YAAY,KAAA,EAAM;AAAA,EACzB;AAAA,EAEQ,MAAA,CAAO,OAAe,SAAA,EAA4B;AAExD,IAAA,IAAI,IAAA,CAAK,MAAA,CAAO,GAAA,EAAK,SAAA,GAAY,KAAK,CAAA,EAAG;AACvC,MAAA,OAAO,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,SAAA,CAAU,KAAK,CAAA;AAAA,IACxC;AAGA,IAAA,IAAI,aAAa,IAAA,CAAK,MAAA,CAAO,GAAA,EAAK,aAAA,GAAgB,SAAS,CAAA,EAAG;AAC5D,MAAA,OAAO,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,aAAA,CAAc,SAAS,CAAA;AAAA,IAChD;AAGA,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,GAAA,EAAK,UAAA,IAAc,IAAA;AAAA,EACxC;AAAA,EAEQ,kBAAkB,KAAA,EAAkD;AAC1E,IAAA,OAAO,KAAA,CAAM,QAAA,CAAS,OAAA,CAAQ,MAAA,GAAS,CAAA,GAAI,GAAA;AAAA,EAC7C;AAAA,EAEQ,SAAA,CACN,MAAA,EACA,IAAA,EACA,UAAA,EACM;AACN,IAAA,IAAI,IAAA,CAAK,MAAA,CAAO,UAAA,IAAc,IAAA,CAAK,SAAS,CAAA,EAAG;AAC7C,MAAA,MAAM,KAAA,GAA2B;AAAA,QAC/B,WAAW,GAAA,EAAI;AAAA,QACf,IAAA;AAAA,QACA,MAAA;AAAA,QACA,gBAAgB,IAAA,CAAK,MAAA;AAAA,QACrB;AAAA,OACF;AACA,MAAA,IAAA,CAAK,IAAA,CAAK,cAAc,KAAK,CAAA;AAC7B,MAAA,IAAA,CAAK,MAAA,CAAO,eAAe,KAAK,CAAA;AAAA,IAClC;AAAA,EACF;AACF;AAKO,SAAS,yBAAA,CACd,OACA,MAAA,EACqB;AACrB,EAAA,OAAO,IAAI,mBAAA,CAAoB,KAAA,EAAO,MAAM,CAAA;AAC9C","file":"index.js","sourcesContent":["/**\n * Core Utilities\n *\n * Helper functions for the semantic cache.\n */\n\nimport { nanoid } from 'nanoid';\n\n/**\n * Generate a unique ID with optional prefix\n */\nexport function generateId(prefix?: string): string {\n  const id = nanoid(16);\n  return prefix ? `${prefix}_${id}` : id;\n}\n\n/**\n * Get current timestamp in milliseconds\n */\nexport function now(): number {\n  return Date.now();\n}\n\n/**\n * Check if an entry has expired based on TTL\n */\nexport function isExpired(createdAt: number, ttlSeconds: number): boolean {\n  if (ttlSeconds <= 0) return false;\n  return now() > createdAt + ttlSeconds * 1000;\n}\n\n/**\n * Estimate the size of an object in bytes\n */\nexport function estimateSize(obj: unknown): number {\n  const str = JSON.stringify(obj);\n  // Rough estimate: 2 bytes per character for UTF-16\n  return str.length * 2;\n}\n\n/**\n * Estimate size of a cache entry\n */\nexport function estimateEntrySize(entry: {\n  embedding?: number[];\n  request: { messages: Array<{ content: string }> };\n  response: { content: string };\n}): number {\n  // Vector: 4 bytes per float32\n  const vectorSize = (entry.embedding?.length ?? 0) * 4;\n\n  // Content: roughly 2 bytes per character\n  const messageSize = entry.request.messages.reduce(\n    (acc, m) => acc + (m.content?.length ?? 0) * 2,\n    0,\n  );\n  const responseSize = (entry.response.content?.length ?? 0) * 2;\n\n  // Metadata overhead\n  const overheadSize = 500;\n\n  return vectorSize + messageSize + responseSize + overheadSize;\n}\n\n/**\n * Sleep for a specified duration\n */\nexport function sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/**\n * Retry a function with exponential backoff\n */\nexport async function retry<T>(\n  fn: () => Promise<T>,\n  options: {\n    maxAttempts?: number;\n    initialDelayMs?: number;\n    maxDelayMs?: number;\n    backoffMultiplier?: number;\n  } = {},\n): Promise<T> {\n  const {\n    maxAttempts = 3,\n    initialDelayMs = 100,\n    maxDelayMs = 5000,\n    backoffMultiplier = 2,\n  } = options;\n\n  let lastError: Error | undefined;\n  let delay = initialDelayMs;\n\n  for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n    try {\n      return await fn();\n    } catch (error) {\n      lastError = error as Error;\n\n      if (attempt < maxAttempts) {\n        await sleep(delay);\n        delay = Math.min(delay * backoffMultiplier, maxDelayMs);\n      }\n    }\n  }\n\n  throw lastError;\n}\n\n/**\n * Chunk an array into smaller arrays\n */\nexport function chunk<T>(array: T[], size: number): T[][] {\n  const chunks: T[][] = [];\n  for (let i = 0; i < array.length; i += size) {\n    chunks.push(array.slice(i, i + size));\n  }\n  return chunks;\n}\n\n/**\n * Deep clone an object\n */\nexport function deepClone<T>(obj: T): T {\n  return JSON.parse(JSON.stringify(obj));\n}\n\n/**\n * Calculate percentile from an array of numbers\n */\nexport function percentile(values: number[], p: number): number {\n  if (values.length === 0) return 0;\n  const sorted = [...values].sort((a, b) => a - b);\n  const index = Math.ceil((p / 100) * sorted.length) - 1;\n  return sorted[Math.max(0, index)];\n}\n\n/**\n * Calculate mean of an array of numbers\n */\nexport function mean(values: number[]): number {\n  if (values.length === 0) return 0;\n  return values.reduce((a, b) => a + b, 0) / values.length;\n}\n","/**\n * InvalidationManager\n *\n * Manages cache invalidation strategies.\n */\n\nimport EventEmitter from 'eventemitter3';\nimport type {\n  InvalidationManagerConfig,\n  InvalidationEvent,\n  InvalidationResult,\n  InvalidationStats,\n} from '../types/index.js';\nimport type { BaseCacheStore } from '../stores/BaseCacheStore.js';\nimport { now } from '../core/utils.js';\n\n/**\n * InvalidationManager events\n */\nexport interface InvalidationManagerEvents {\n  invalidate: (event: InvalidationEvent) => void;\n  error: (error: Error) => void;\n}\n\n/**\n * Default configuration\n */\nconst DEFAULT_CONFIG: InvalidationManagerConfig = {\n  strategy: 'ttl',\n  ttl: {\n    defaultTtl: 3600,\n    softTtl: false,\n  },\n  emitEvents: true,\n};\n\n/**\n * InvalidationManager\n *\n * Manages cache invalidation across different strategies.\n *\n * @example\n * ```typescript\n * const invalidation = new InvalidationManager(store, {\n *   strategy: 'ttl',\n *   ttl: { defaultTtl: 3600 }\n * });\n *\n * // Run invalidation\n * const result = await invalidation.run();\n *\n * // Or start automatic invalidation\n * invalidation.startAuto(60000); // Run every minute\n * ```\n */\nexport class InvalidationManager extends EventEmitter<InvalidationManagerEvents> {\n  private store: BaseCacheStore;\n  private config: InvalidationManagerConfig;\n  private autoInterval: ReturnType<typeof setInterval> | null = null;\n  private stats: InvalidationStats = {\n    totalInvalidations: 0,\n    ttlRemovals: 0,\n    lruRemovals: 0,\n    eventRemovals: 0,\n    smartRemovals: 0,\n    manualRemovals: 0,\n    totalBytesFreed: 0,\n  };\n  private accessTimes: Map<string, number> = new Map();\n\n  constructor(store: BaseCacheStore, config?: InvalidationManagerConfig) {\n    super();\n    this.store = store;\n    this.config = { ...DEFAULT_CONFIG, ...config };\n  }\n\n  /**\n   * Run invalidation based on configured strategy\n   */\n  async run(): Promise<InvalidationResult> {\n    switch (this.config.strategy) {\n      case 'ttl':\n        return this.runTTLInvalidation();\n      case 'lru':\n        return this.runLRUInvalidation();\n      case 'smart':\n        return this.runSmartInvalidation();\n      default:\n        return this.runTTLInvalidation();\n    }\n  }\n\n  /**\n   * Run TTL-based invalidation\n   */\n  async runTTLInvalidation(): Promise<InvalidationResult> {\n    const startTime = performance.now();\n    const invalidatedKeys: string[] = [];\n    let bytesFreed = 0;\n    const currentTime = now();\n\n    const keys = await this.store.keys();\n\n    for (const key of keys) {\n      const entry = await this.store.get(key);\n      if (!entry) continue;\n\n      // Use entry's TTL if set, otherwise fall back to config-based TTL\n      const ttl =\n        entry.metadata.ttl ??\n        this.getTTL(entry.request.model, entry.metadata.namespace);\n      const age = (currentTime - entry.metadata.createdAt) / 1000; // Convert to seconds\n\n      if (age >= ttl) {\n        // Check soft TTL grace period\n        if (this.config.ttl?.softTtl && this.config.ttl?.gracePeriod) {\n          if (age < ttl + this.config.ttl.gracePeriod) {\n            // In grace period, skip\n            continue;\n          }\n        }\n\n        const deleted = await this.store.delete(key);\n        if (deleted) {\n          invalidatedKeys.push(key);\n          bytesFreed += this.estimateEntrySize(entry);\n        }\n      }\n    }\n\n    this.stats.totalInvalidations++;\n    this.stats.ttlRemovals += invalidatedKeys.length;\n    this.stats.totalBytesFreed += bytesFreed;\n    this.stats.lastInvalidationAt = now();\n\n    const result: InvalidationResult = {\n      invalidatedKeys,\n      entriesRemoved: invalidatedKeys.length,\n      bytesFreed,\n      durationMs: performance.now() - startTime,\n    };\n\n    this.emitEvent('ttl', invalidatedKeys, bytesFreed);\n    return result;\n  }\n\n  /**\n   * Run LRU-based invalidation\n   */\n  async runLRUInvalidation(): Promise<InvalidationResult> {\n    const startTime = performance.now();\n    const invalidatedKeys: string[] = [];\n    let bytesFreed = 0;\n\n    const maxEntries = this.config.lru?.maxEntries ?? 1000;\n    const _maxSizeBytes = this.config.lru?.maxSizeBytes ?? Infinity;\n    const batchSize = this.config.lru?.evictionBatchSize ?? 10;\n    const minAge = this.config.lru?.minAge ?? 0;\n\n    const currentSize = await this.store.size();\n    if (currentSize <= maxEntries) {\n      return {\n        invalidatedKeys: [],\n        entriesRemoved: 0,\n        bytesFreed: 0,\n        durationMs: performance.now() - startTime,\n      };\n    }\n\n    // Get all entries and sort by last access time\n    const keys = await this.store.keys();\n    const entriesWithAccess: Array<{\n      key: string;\n      accessedAt: number;\n      size: number;\n    }> = [];\n\n    for (const key of keys) {\n      const entry = await this.store.get(key);\n      if (entry) {\n        entriesWithAccess.push({\n          key,\n          accessedAt: entry.metadata.accessedAt,\n          size: this.estimateEntrySize(entry),\n        });\n      }\n    }\n\n    // Sort by least recently accessed\n    entriesWithAccess.sort((a, b) => a.accessedAt - b.accessedAt);\n\n    // Remove until under limit\n    const toRemove = Math.min(currentSize - maxEntries, batchSize);\n    const currentTime = now();\n\n    for (let i = 0; i < toRemove && i < entriesWithAccess.length; i++) {\n      const { key, accessedAt, size } = entriesWithAccess[i];\n\n      // Check minimum age\n      const age = (currentTime - accessedAt) / 1000;\n      if (age < minAge) continue;\n\n      const deleted = await this.store.delete(key);\n      if (deleted) {\n        invalidatedKeys.push(key);\n        bytesFreed += size;\n      }\n    }\n\n    this.stats.totalInvalidations++;\n    this.stats.lruRemovals += invalidatedKeys.length;\n    this.stats.totalBytesFreed += bytesFreed;\n    this.stats.lastInvalidationAt = now();\n\n    const result: InvalidationResult = {\n      invalidatedKeys,\n      entriesRemoved: invalidatedKeys.length,\n      bytesFreed,\n      durationMs: performance.now() - startTime,\n    };\n\n    this.emitEvent('lru', invalidatedKeys, bytesFreed);\n    return result;\n  }\n\n  /**\n   * Run smart invalidation (combines TTL + LRU + hit rate analysis)\n   */\n  async runSmartInvalidation(): Promise<InvalidationResult> {\n    const startTime = performance.now();\n    const invalidatedKeys: string[] = [];\n    let bytesFreed = 0;\n\n    const minHitRate = this.config.smart?.minHitRate ?? 0.1;\n    const currentTime = now();\n\n    const keys = await this.store.keys();\n\n    for (const key of keys) {\n      const entry = await this.store.get(key);\n      if (!entry) continue;\n\n      let shouldInvalidate = false;\n\n      // Check TTL\n      // Use entry's TTL if set, otherwise fall back to config-based TTL\n      const ttl =\n        entry.metadata.ttl ??\n        this.getTTL(entry.request.model, entry.metadata.namespace);\n      const age = (currentTime - entry.metadata.createdAt) / 1000;\n      if (age >= ttl) {\n        shouldInvalidate = true;\n      }\n\n      // Check hit rate\n      if (this.config.smart?.analyzeHitRate && entry.metadata.accessCount > 0) {\n        const accessRate = entry.metadata.accessCount / Math.max(age / 3600, 1); // Per hour\n        if (accessRate < minHitRate) {\n          shouldInvalidate = true;\n        }\n      }\n\n      if (shouldInvalidate) {\n        const deleted = await this.store.delete(key);\n        if (deleted) {\n          invalidatedKeys.push(key);\n          bytesFreed += this.estimateEntrySize(entry);\n        }\n      }\n    }\n\n    this.stats.totalInvalidations++;\n    this.stats.smartRemovals += invalidatedKeys.length;\n    this.stats.totalBytesFreed += bytesFreed;\n    this.stats.lastInvalidationAt = now();\n\n    const result: InvalidationResult = {\n      invalidatedKeys,\n      entriesRemoved: invalidatedKeys.length,\n      bytesFreed,\n      durationMs: performance.now() - startTime,\n    };\n\n    this.emitEvent('smart', invalidatedKeys, bytesFreed);\n    return result;\n  }\n\n  /**\n   * Manually invalidate specific keys\n   */\n  async invalidateKeys(keys: string[]): Promise<InvalidationResult> {\n    const startTime = performance.now();\n    const invalidatedKeys: string[] = [];\n    let bytesFreed = 0;\n\n    for (const key of keys) {\n      const entry = await this.store.get(key);\n      if (entry) {\n        const size = this.estimateEntrySize(entry);\n        const deleted = await this.store.delete(key);\n        if (deleted) {\n          invalidatedKeys.push(key);\n          bytesFreed += size;\n        }\n      }\n    }\n\n    this.stats.totalInvalidations++;\n    this.stats.manualRemovals += invalidatedKeys.length;\n    this.stats.totalBytesFreed += bytesFreed;\n    this.stats.lastInvalidationAt = now();\n\n    const result: InvalidationResult = {\n      invalidatedKeys,\n      entriesRemoved: invalidatedKeys.length,\n      bytesFreed,\n      durationMs: performance.now() - startTime,\n    };\n\n    this.emitEvent('manual', invalidatedKeys, bytesFreed);\n    return result;\n  }\n\n  /**\n   * Invalidate by pattern (e.g., namespace or model)\n   */\n  async invalidateByPattern(options: {\n    namespace?: string;\n    model?: string;\n    olderThan?: number;\n  }): Promise<InvalidationResult> {\n    const startTime = performance.now();\n    const invalidatedKeys: string[] = [];\n    let bytesFreed = 0;\n    const currentTime = now();\n\n    const keys = await this.store.keys();\n\n    for (const key of keys) {\n      const entry = await this.store.get(key);\n      if (!entry) continue;\n\n      let matches = true;\n\n      if (options.namespace && entry.metadata.namespace !== options.namespace) {\n        matches = false;\n      }\n\n      if (options.model && entry.request.model !== options.model) {\n        matches = false;\n      }\n\n      if (options.olderThan) {\n        const age = (currentTime - entry.metadata.createdAt) / 1000;\n        if (age < options.olderThan) {\n          matches = false;\n        }\n      }\n\n      if (matches) {\n        const size = this.estimateEntrySize(entry);\n        const deleted = await this.store.delete(key);\n        if (deleted) {\n          invalidatedKeys.push(key);\n          bytesFreed += size;\n        }\n      }\n    }\n\n    this.stats.totalInvalidations++;\n    this.stats.manualRemovals += invalidatedKeys.length;\n    this.stats.totalBytesFreed += bytesFreed;\n    this.stats.lastInvalidationAt = now();\n\n    const result: InvalidationResult = {\n      invalidatedKeys,\n      entriesRemoved: invalidatedKeys.length,\n      bytesFreed,\n      durationMs: performance.now() - startTime,\n    };\n\n    this.emitEvent('manual', invalidatedKeys, bytesFreed);\n    return result;\n  }\n\n  /**\n   * Start automatic invalidation\n   */\n  startAuto(intervalMs = 60000): void {\n    if (this.autoInterval) {\n      this.stopAuto();\n    }\n\n    this.autoInterval = setInterval(() => {\n      void (async () => {\n        try {\n          await this.run();\n        } catch (error) {\n          this.emit('error', error as Error);\n        }\n      })();\n    }, intervalMs);\n  }\n\n  /**\n   * Stop automatic invalidation\n   */\n  stopAuto(): void {\n    if (this.autoInterval) {\n      clearInterval(this.autoInterval);\n      this.autoInterval = null;\n    }\n  }\n\n  /**\n   * Get invalidation statistics\n   */\n  getStats(): InvalidationStats {\n    return { ...this.stats };\n  }\n\n  /**\n   * Reset statistics\n   */\n  resetStats(): void {\n    this.stats = {\n      totalInvalidations: 0,\n      ttlRemovals: 0,\n      lruRemovals: 0,\n      eventRemovals: 0,\n      smartRemovals: 0,\n      manualRemovals: 0,\n      totalBytesFreed: 0,\n    };\n  }\n\n  /**\n   * Destroy the manager\n   */\n  destroy(): void {\n    this.stopAuto();\n    this.removeAllListeners();\n    this.accessTimes.clear();\n  }\n\n  private getTTL(model: string, namespace?: string): number {\n    // Check model-specific TTL\n    if (this.config.ttl?.modelTtls?.[model]) {\n      return this.config.ttl.modelTtls[model];\n    }\n\n    // Check namespace-specific TTL\n    if (namespace && this.config.ttl?.namespaceTtls?.[namespace]) {\n      return this.config.ttl.namespaceTtls[namespace];\n    }\n\n    // Return default TTL\n    return this.config.ttl?.defaultTtl ?? 3600;\n  }\n\n  private estimateEntrySize(entry: { response: { content: string } }): number {\n    return entry.response.content.length * 2 + 200; // Rough estimate\n  }\n\n  private emitEvent(\n    reason: 'ttl' | 'lru' | 'event' | 'smart' | 'manual',\n    keys: string[],\n    bytesFreed: number,\n  ): void {\n    if (this.config.emitEvents && keys.length > 0) {\n      const event: InvalidationEvent = {\n        timestamp: now(),\n        keys,\n        reason,\n        entriesRemoved: keys.length,\n        bytesFreed,\n      };\n      this.emit('invalidate', event);\n      this.config.onInvalidate?.(event);\n    }\n  }\n}\n\n/**\n * Create an InvalidationManager instance\n */\nexport function createInvalidationManager(\n  store: BaseCacheStore,\n  config?: InvalidationManagerConfig,\n): InvalidationManager {\n  return new InvalidationManager(store, config);\n}\n"]}

package/dist/store.types-BQy5Yyz9.d.ts

@@ -0,0 +1,111 @@
+import { d as CacheBackendType, b as CacheEntry } from './cache.types-DMuyQseO.js';
+
+declare abstract class BaseCacheStore {
+    abstract readonly storeType: CacheBackendType;
+    protected config: StoreConfig;
+    protected metrics: StoreMetrics;
+    constructor(config: StoreConfig);
+    abstract get(key: string): Promise<CacheEntry | undefined>;
+    abstract set(key: string, entry: CacheEntry): Promise<UpsertResult>;
+    abstract has(key: string): Promise<boolean>;
+    abstract delete(key: string): Promise<boolean>;
+    abstract clear(): Promise<void>;
+    abstract size(): Promise<number>;
+    abstract keys(): Promise<string[]>;
+    abstract query(vector: number[], options?: StoreQueryOptions): Promise<StoreQueryResult>;
+    abstract checkHealth(): Promise<StoreHealth>;
+    abstract close(): Promise<void>;
+    get namespace(): string;
+    getMetrics(): StoreMetrics;
+    resetMetrics(): void;
+    protected incrementMetric(metric: keyof StoreMetrics, amount?: number): void;
+}
+
+interface StoreConfig {
+    type: CacheBackendType;
+    namespace?: string;
+}
+interface MemoryStoreConfig extends StoreConfig {
+    type: 'memory';
+    maxEntries?: number;
+    maxSizeBytes?: number;
+    evictionPolicy?: 'lru' | 'lfu' | 'fifo';
+}
+interface RedisStoreConfig extends StoreConfig {
+    type: 'redis';
+    url?: string;
+    host?: string;
+    port?: number;
+    password?: string;
+    db?: number;
+    keyPrefix?: string;
+    connectTimeout?: number;
+    tls?: boolean;
+}
+interface SQLiteStoreConfig extends StoreConfig {
+    type: 'sqlite';
+    dbPath?: string;
+    inMemory?: boolean;
+    enableVector?: boolean;
+}
+interface PineconeStoreConfig extends StoreConfig {
+    type: 'pinecone';
+    apiKey: string;
+    index: string;
+    namespace?: string;
+    host?: string;
+}
+interface TieredStoreConfig extends StoreConfig {
+    type: 'tiered';
+    tiers: TierConfig[];
+    writeThrough?: boolean;
+    promoteOnHit?: boolean;
+    promotionThreshold?: number;
+}
+interface TierConfig {
+    name: string;
+    type?: CacheBackendType;
+    config?: StoreConfig;
+    priority: number;
+    ttl?: number;
+    maxSize?: number;
+    promotionThreshold?: number;
+    demotionTarget?: number;
+    store?: BaseCacheStore;
+}
+interface StoreHealth {
+    healthy: boolean;
+    latencyMs: number;
+    lastCheck: number;
+    error?: string;
+}
+interface UpsertResult {
+    success: boolean;
+    id: string;
+    durationMs: number;
+}
+interface StoreQueryOptions {
+    topK?: number;
+    minSimilarity?: number;
+    namespace?: string;
+    filter?: Record<string, unknown>;
+    includeMetadata?: boolean;
+    includeEmbedding?: boolean;
+}
+interface StoreQueryResult {
+    entries: Array<CacheEntry & {
+        score: number;
+    }>;
+    durationMs: number;
+}
+interface StoreMetrics {
+    gets: number;
+    sets: number;
+    deletes: number;
+    hits: number;
+    misses: number;
+    avgGetLatencyMs?: number;
+    avgSetLatencyMs?: number;
+}
+
+export { BaseCacheStore as B, type MemoryStoreConfig as M, type PineconeStoreConfig as P, type RedisStoreConfig as R, type StoreHealth as S, type TieredStoreConfig as T, type UpsertResult as U, type StoreConfig as a, type SQLiteStoreConfig as b, type TierConfig as c, type StoreQueryOptions as d, type StoreQueryResult as e, type StoreMetrics as f };