@memberjunction/react-runtime 5.41.0 → 5.42.0

package/dist/utilities/cache-manager.d.ts

@@ -9,8 +9,9 @@ export interface CacheOptions {
     defaultTTL?: number;
     cleanupInterval?: number;
 }
-export declare class CacheManager<T = any> {
+export declare class CacheManager<T = unknown> {
     private cache;
+    private timers;
     private memoryUsage;
     private cleanupTimer?;
     private readonly options;

package/dist/utilities/cache-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache-manager.d.ts","sourceRoot":"","sources":["../../src/utilities/cache-manager.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAMD,qBAAa,YAAY,CAAC,CAAC,GAAG,GAAG;IAC/B,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;gBAErC,OAAO,GAAE,YAAiB;IAgBtC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAqC9C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAkB/B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAezB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAY5B,KAAK,IAAI,IAAI;IAQb,QAAQ,IAAI;QACV,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB;IAYD,OAAO,IAAI,MAAM;IAiBjB,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,QAAQ;IAmBhB,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,gBAAgB;CAMzB"}
+{"version":3,"file":"cache-manager.d.ts","sourceRoot":"","sources":["../../src/utilities/cache-manager.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAMD,qBAAa,YAAY,CAAC,CAAC,GAAG,OAAO;IACnC,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,MAAM,CAAoD;IAClE,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,YAAY,CAAC,CAAiC;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;gBAErC,OAAO,GAAE,YAAiB;IAgBtC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAiD9C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAkB/B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAezB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAiB5B,KAAK,IAAI,IAAI;IAYb,QAAQ,IAAI;QACV,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB;IAYD,OAAO,IAAI,MAAM;IAiBjB,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,QAAQ;IAmBhB,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,gBAAgB;CAMzB"}

package/dist/utilities/cache-manager.js

@@ -1,6 +1,7 @@
 export class CacheManager {
     constructor(options = {}) {
         this.cache = new Map();
+        this.timers = new Map();
         this.memoryUsage = 0;
         this.options = {
             maxSize: options.maxSize || 1000,
@@ -29,11 +30,20 @@ export class CacheManager {
         if (oldEntry) {
             this.memoryUsage -= oldEntry.size || 0;
         }
+        const oldTimer = this.timers.get(key);
+        if (oldTimer !== undefined) {
+            clearTimeout(oldTimer);
+            this.timers.delete(key);
+        }
         this.cache.set(key, entry);
         this.memoryUsage += size;
         if (ttl || this.options.defaultTTL) {
             const timeout = ttl || this.options.defaultTTL;
-            setTimeout(() => this.delete(key), timeout);
+            const timerId = setTimeout(() => {
+                this.timers.delete(key);
+                this.delete(key);
+            }, timeout);
+            this.timers.set(key, timerId);
         }
     }
     get(key) {
@@ -58,6 +68,11 @@ export class CacheManager {
         return true;
     }
     delete(key) {
+        const timer = this.timers.get(key);
+        if (timer !== undefined) {
+            clearTimeout(timer);
+            this.timers.delete(key);
+        }
         const entry = this.cache.get(key);
         if (entry) {
             this.memoryUsage -= entry.size || 0;
@@ -66,6 +81,10 @@ export class CacheManager {
         return false;
     }
     clear() {
+        for (const timer of this.timers.values()) {
+            clearTimeout(timer);
+        }
+        this.timers.clear();
         this.cache.clear();
         this.memoryUsage = 0;
     }
@@ -139,13 +158,13 @@ export class CacheManager {
         }
     }
     startCleanupTimer() {
-        this.cleanupTimer = window.setInterval(() => {
+        this.cleanupTimer = setInterval(() => {
             this.cleanup();
         }, this.options.cleanupInterval);
     }
     stopCleanupTimer() {
         if (this.cleanupTimer) {
-            window.clearInterval(this.cleanupTimer);
+            clearInterval(this.cleanupTimer);
             this.cleanupTimer = undefined;
         }
     }

package/dist/utilities/cache-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache-manager.js","sourceRoot":"","sources":["../../src/utilities/cache-manager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview Cache management with TTL and size limits\n * @module @memberjunction/react-runtime/utilities\n */\n\nexport interface CacheEntry<T> {\n  value: T;\n  timestamp: number;\n  size?: number;\n}\n\nexport interface CacheOptions {\n  maxSize?: number;          // Maximum number of entries\n  maxMemory?: number;        // Maximum memory in bytes (estimated)\n  defaultTTL?: number;       // Default TTL in milliseconds\n  cleanupInterval?: number;  // Cleanup interval in milliseconds\n}\n\n/**\n * Cache manager with TTL and size limits.\n * Provides automatic cleanup and memory management.\n */\nexport class CacheManager<T = any> {\n  private cache = new Map<string, CacheEntry<T>>();\n  private memoryUsage = 0;\n  private cleanupTimer?: number;\n  private readonly options: Required<CacheOptions>;\n\n  constructor(options: CacheOptions = {}) {\n    this.options = {\n      maxSize: options.maxSize || 1000,\n      maxMemory: options.maxMemory || 50 * 1024 * 1024, // 50MB default\n      defaultTTL: options.defaultTTL || 5 * 60 * 1000,   // 5 minutes default\n      cleanupInterval: options.cleanupInterval || 60 * 1000 // 1 minute default\n    };\n\n    if (this.options.cleanupInterval > 0) {\n      this.startCleanupTimer();\n    }\n  }\n\n  /**\n   * Set a value in the cache\n   */\n  set(key: string, value: T, ttl?: number): void {\n    const size = this.estimateSize(value);\n    const entry: CacheEntry<T> = {\n      value,\n      timestamp: Date.now(),\n      size\n    };\n\n    // Check if we need to evict entries\n    if (this.cache.size >= this.options.maxSize) {\n      this.evictLRU();\n    }\n\n    // Check memory usage\n    if (this.memoryUsage + size > this.options.maxMemory) {\n      this.evictByMemory(size);\n    }\n\n    // Remove old entry if exists\n    const oldEntry = this.cache.get(key);\n    if (oldEntry) {\n      this.memoryUsage -= oldEntry.size || 0;\n    }\n\n    this.cache.set(key, entry);\n    this.memoryUsage += size;\n\n    // Schedule removal if TTL is set\n    if (ttl || this.options.defaultTTL) {\n      const timeout = ttl || this.options.defaultTTL;\n      setTimeout(() => this.delete(key), timeout);\n    }\n  }\n\n  /**\n   * Get a value from the cache\n   */\n  get(key: string): T | undefined {\n    const entry = this.cache.get(key);\n    if (!entry) return undefined;\n\n    // Check if expired\n    if (this.isExpired(entry)) {\n      this.delete(key);\n      return undefined;\n    }\n\n    // Update timestamp for LRU\n    entry.timestamp = Date.now();\n    return entry.value;\n  }\n\n  /**\n   * Check if a key exists and is not expired\n   */\n  has(key: string): boolean {\n    const entry = this.cache.get(key);\n    if (!entry) return false;\n\n    if (this.isExpired(entry)) {\n      this.delete(key);\n      return false;\n    }\n\n    return true;\n  }\n\n  /**\n   * Delete a key from the cache\n   */\n  delete(key: string): boolean {\n    const entry = this.cache.get(key);\n    if (entry) {\n      this.memoryUsage -= entry.size || 0;\n      return this.cache.delete(key);\n    }\n    return false;\n  }\n\n  /**\n   * Clear all entries\n   */\n  clear(): void {\n    this.cache.clear();\n    this.memoryUsage = 0;\n  }\n\n  /**\n   * Get cache statistics\n   */\n  getStats(): {\n    size: number;\n    memoryUsage: number;\n    maxSize: number;\n    maxMemory: number;\n  } {\n    return {\n      size: this.cache.size,\n      memoryUsage: this.memoryUsage,\n      maxSize: this.options.maxSize,\n      maxMemory: this.options.maxMemory\n    };\n  }\n\n  /**\n   * Manually trigger cleanup\n   */\n  cleanup(): number {\n    let removed = 0;\n    const now = Date.now();\n\n    for (const [key, entry] of this.cache) {\n      if (this.isExpired(entry, now)) {\n        this.delete(key);\n        removed++;\n      }\n    }\n\n    return removed;\n  }\n\n  /**\n   * Destroy the cache and stop cleanup timer\n   */\n  destroy(): void {\n    this.stopCleanupTimer();\n    this.clear();\n  }\n\n  /**\n   * Check if an entry is expired\n   */\n  private isExpired(entry: CacheEntry<T>, now?: number): boolean {\n    if (!this.options.defaultTTL) return false;\n    const currentTime = now || Date.now();\n    return currentTime - entry.timestamp > this.options.defaultTTL;\n  }\n\n  /**\n   * Evict least recently used entry\n   */\n  private evictLRU(): void {\n    let lruKey: string | undefined;\n    let lruTime = Infinity;\n\n    for (const [key, entry] of this.cache) {\n      if (entry.timestamp < lruTime) {\n        lruTime = entry.timestamp;\n        lruKey = key;\n      }\n    }\n\n    if (lruKey) {\n      this.delete(lruKey);\n    }\n  }\n\n  /**\n   * Evict entries to make room for new memory\n   */\n  private evictByMemory(requiredSize: number): void {\n    const entries = Array.from(this.cache.entries())\n      .sort((a, b) => a[1].timestamp - b[1].timestamp);\n\n    let freedMemory = 0;\n    for (const [key, entry] of entries) {\n      if (freedMemory >= requiredSize) break;\n      freedMemory += entry.size || 0;\n      this.delete(key);\n    }\n  }\n\n  /**\n   * Estimate size of a value\n   */\n  private estimateSize(value: T): number {\n    if (typeof value === 'string') {\n      return value.length * 2; // 2 bytes per character\n    } else if (typeof value === 'object' && value !== null) {\n      // Rough estimation for objects\n      try {\n        return JSON.stringify(value).length * 2;\n      } catch {\n        return 1024; // Default 1KB for objects that can't be stringified\n      }\n    } else {\n      return 8; // Default for primitives\n    }\n  }\n\n  /**\n   * Start the cleanup timer\n   */\n  private startCleanupTimer(): void {\n    this.cleanupTimer = window.setInterval(() => {\n      this.cleanup();\n    }, this.options.cleanupInterval);\n  }\n\n  /**\n   * Stop the cleanup timer\n   */\n  private stopCleanupTimer(): void {\n    if (this.cleanupTimer) {\n      window.clearInterval(this.cleanupTimer);\n      this.cleanupTimer = undefined;\n    }\n  }\n}"]}
+{"version":3,"file":"cache-manager.js","sourceRoot":"","sources":["../../src/utilities/cache-manager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview Cache management with TTL and size limits\n * @module @memberjunction/react-runtime/utilities\n */\n\nexport interface CacheEntry<T> {\n  value: T;\n  timestamp: number;\n  size?: number;\n}\n\nexport interface CacheOptions {\n  maxSize?: number;          // Maximum number of entries\n  maxMemory?: number;        // Maximum memory in bytes (estimated)\n  defaultTTL?: number;       // Default TTL in milliseconds\n  cleanupInterval?: number;  // Cleanup interval in milliseconds\n}\n\n/**\n * Cache manager with TTL and size limits.\n * Provides automatic cleanup and memory management.\n */\nexport class CacheManager<T = unknown> {\n  private cache = new Map<string, CacheEntry<T>>();\n  private timers = new Map<string, ReturnType<typeof setTimeout>>();\n  private memoryUsage = 0;\n  private cleanupTimer?: ReturnType<typeof setInterval>;\n  private readonly options: Required<CacheOptions>;\n\n  constructor(options: CacheOptions = {}) {\n    this.options = {\n      maxSize: options.maxSize || 1000,\n      maxMemory: options.maxMemory || 50 * 1024 * 1024, // 50MB default\n      defaultTTL: options.defaultTTL || 5 * 60 * 1000,   // 5 minutes default\n      cleanupInterval: options.cleanupInterval || 60 * 1000 // 1 minute default\n    };\n\n    if (this.options.cleanupInterval > 0) {\n      this.startCleanupTimer();\n    }\n  }\n\n  /**\n   * Set a value in the cache\n   */\n  set(key: string, value: T, ttl?: number): void {\n    const size = this.estimateSize(value);\n    const entry: CacheEntry<T> = {\n      value,\n      timestamp: Date.now(),\n      size\n    };\n\n    // Check if we need to evict entries\n    if (this.cache.size >= this.options.maxSize) {\n      this.evictLRU();\n    }\n\n    // Check memory usage\n    if (this.memoryUsage + size > this.options.maxMemory) {\n      this.evictByMemory(size);\n    }\n\n    // Remove old entry if exists\n    const oldEntry = this.cache.get(key);\n    if (oldEntry) {\n      this.memoryUsage -= oldEntry.size || 0;\n    }\n\n    // Cancel any existing TTL timer for this key so overwriting an entry doesn't\n    // leave a dangling timer that deletes the new value when it fires.\n    const oldTimer = this.timers.get(key);\n    if (oldTimer !== undefined) {\n      clearTimeout(oldTimer);\n      this.timers.delete(key);\n    }\n\n    this.cache.set(key, entry);\n    this.memoryUsage += size;\n\n    // Schedule removal if TTL is set\n    if (ttl || this.options.defaultTTL) {\n      const timeout = ttl || this.options.defaultTTL;\n      const timerId = setTimeout(() => {\n        this.timers.delete(key);\n        this.delete(key);\n      }, timeout);\n      this.timers.set(key, timerId);\n    }\n  }\n\n  /**\n   * Get a value from the cache\n   */\n  get(key: string): T | undefined {\n    const entry = this.cache.get(key);\n    if (!entry) return undefined;\n\n    // Check if expired\n    if (this.isExpired(entry)) {\n      this.delete(key);\n      return undefined;\n    }\n\n    // Update timestamp for LRU\n    entry.timestamp = Date.now();\n    return entry.value;\n  }\n\n  /**\n   * Check if a key exists and is not expired\n   */\n  has(key: string): boolean {\n    const entry = this.cache.get(key);\n    if (!entry) return false;\n\n    if (this.isExpired(entry)) {\n      this.delete(key);\n      return false;\n    }\n\n    return true;\n  }\n\n  /**\n   * Delete a key from the cache\n   */\n  delete(key: string): boolean {\n    const timer = this.timers.get(key);\n    if (timer !== undefined) {\n      clearTimeout(timer);\n      this.timers.delete(key);\n    }\n    const entry = this.cache.get(key);\n    if (entry) {\n      this.memoryUsage -= entry.size || 0;\n      return this.cache.delete(key);\n    }\n    return false;\n  }\n\n  /**\n   * Clear all entries\n   */\n  clear(): void {\n    for (const timer of this.timers.values()) {\n      clearTimeout(timer);\n    }\n    this.timers.clear();\n    this.cache.clear();\n    this.memoryUsage = 0;\n  }\n\n  /**\n   * Get cache statistics\n   */\n  getStats(): {\n    size: number;\n    memoryUsage: number;\n    maxSize: number;\n    maxMemory: number;\n  } {\n    return {\n      size: this.cache.size,\n      memoryUsage: this.memoryUsage,\n      maxSize: this.options.maxSize,\n      maxMemory: this.options.maxMemory\n    };\n  }\n\n  /**\n   * Manually trigger cleanup\n   */\n  cleanup(): number {\n    let removed = 0;\n    const now = Date.now();\n\n    for (const [key, entry] of this.cache) {\n      if (this.isExpired(entry, now)) {\n        this.delete(key);\n        removed++;\n      }\n    }\n\n    return removed;\n  }\n\n  /**\n   * Destroy the cache, cancel all entry timers, and stop the cleanup timer.\n   */\n  destroy(): void {\n    this.stopCleanupTimer();\n    this.clear();\n  }\n\n  /**\n   * Check if an entry is expired\n   */\n  private isExpired(entry: CacheEntry<T>, now?: number): boolean {\n    if (!this.options.defaultTTL) return false;\n    const currentTime = now || Date.now();\n    return currentTime - entry.timestamp > this.options.defaultTTL;\n  }\n\n  /**\n   * Evict least recently used entry\n   */\n  private evictLRU(): void {\n    let lruKey: string | undefined;\n    let lruTime = Infinity;\n\n    for (const [key, entry] of this.cache) {\n      if (entry.timestamp < lruTime) {\n        lruTime = entry.timestamp;\n        lruKey = key;\n      }\n    }\n\n    if (lruKey) {\n      this.delete(lruKey);\n    }\n  }\n\n  /**\n   * Evict entries to make room for new memory\n   */\n  private evictByMemory(requiredSize: number): void {\n    const entries = Array.from(this.cache.entries())\n      .sort((a, b) => a[1].timestamp - b[1].timestamp);\n\n    let freedMemory = 0;\n    for (const [key, entry] of entries) {\n      if (freedMemory >= requiredSize) break;\n      freedMemory += entry.size || 0;\n      this.delete(key);\n    }\n  }\n\n  /**\n   * Estimate size of a value\n   */\n  private estimateSize(value: T): number {\n    if (typeof value === 'string') {\n      return value.length * 2; // 2 bytes per character\n    } else if (typeof value === 'object' && value !== null) {\n      // Rough estimation for objects\n      try {\n        return JSON.stringify(value).length * 2;\n      } catch {\n        return 1024; // Default 1KB for objects that can't be stringified\n      }\n    } else {\n      return 8; // Default for primitives\n    }\n  }\n\n  /**\n   * Start the cleanup timer\n   */\n  private startCleanupTimer(): void {\n    this.cleanupTimer = setInterval(() => {\n      this.cleanup();\n    }, this.options.cleanupInterval);\n  }\n\n  /**\n   * Stop the cleanup timer\n   */\n  private stopCleanupTimer(): void {\n    if (this.cleanupTimer) {\n      clearInterval(this.cleanupTimer);\n      this.cleanupTimer = undefined;\n    }\n  }\n}"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memberjunction/react-runtime",
-  "version": "5.41.0",
+  "version": "5.42.0",
   "description": "Platform-agnostic React component runtime for MemberJunction. Provides core compilation, registry, and execution capabilities for React components in any JavaScript environment.",
   "type": "module",
   "main": "dist/index.js",
@@ -29,11 +29,11 @@
   },
   "homepage": "https://github.com/MemberJunction/MJ#readme",
   "dependencies": {
-    "@memberjunction/core": "5.41.0",
-    "@memberjunction/global": "5.41.0",
-    "@memberjunction/interactive-component-types": "5.41.0",
-    "@memberjunction/core-entities": "5.41.0",
-    "@memberjunction/graphql-dataprovider": "5.41.0",
+    "@memberjunction/core": "5.42.0",
+    "@memberjunction/global": "5.42.0",
+    "@memberjunction/interactive-component-types": "5.42.0",
+    "@memberjunction/core-entities": "5.42.0",
+    "@memberjunction/graphql-dataprovider": "5.42.0",
     "@babel/standalone": "^7.29.1",
     "rxjs": "^7.8.2"
   },

package/src/__tests__/cache-manager.test.ts

@@ -159,4 +159,68 @@ describe('CacheManager', () => {
       expect(cache.getStats().size).toBe(0);
     });
   });
+
+  describe('timer cancellation on overwrite', () => {
+    it('should cancel the old TTL timer when a key is overwritten', () => {
+      // Store a value with a short TTL so its timer fires at +5s
+      cache.set('key1', 'originalValue', 5000);
+
+      // Advance 3 seconds — timer not yet fired
+      vi.advanceTimersByTime(3000);
+      expect(cache.get('key1')).toBe('originalValue');
+
+      // Overwrite the key with a fresh 10s TTL
+      cache.set('key1', 'updatedValue', 10000);
+
+      // Advance another 3 seconds — original timer would have fired at +5s (2s into overwrite)
+      // but since it was cancelled, the key should still be present
+      vi.advanceTimersByTime(3000);
+      expect(cache.get('key1')).toBe('updatedValue');
+    });
+
+    it('should not delete new value when the old TTL would have expired', () => {
+      cache.set('key1', 'first', 2000); // expires in 2s
+
+      vi.advanceTimersByTime(1000); // advance 1s
+
+      cache.set('key1', 'second', 10000); // overwrite with 10s TTL
+
+      // Advance 2 more seconds — original timer (now cancelled) would have fired here
+      vi.advanceTimersByTime(2000);
+
+      // Value should still be 'second', not deleted by the cancelled original timer
+      expect(cache.get('key1')).toBe('second');
+    });
+  });
+
+  describe('timer cancellation on delete', () => {
+    it('should cancel TTL timer when entry is explicitly deleted', () => {
+      cache.set('key1', 'value1', 5000);
+      cache.delete('key1');
+
+      // Advance past original TTL — timer fires should be no-ops
+      vi.advanceTimersByTime(6000);
+
+      // Nothing should blow up and the entry stays deleted
+      expect(cache.has('key1')).toBe(false);
+      expect(cache.getStats().size).toBe(0);
+    });
+  });
+
+  describe('timer cancellation on clear', () => {
+    it('should cancel all pending TTL timers when clear() is called', () => {
+      cache.set('key1', 'value1', 2000);
+      cache.set('key2', 'value2', 3000);
+      cache.set('key3', 'value3', 4000);
+
+      cache.clear();
+
+      // Advance past all TTLs — pending timer callbacks should be no-ops
+      vi.advanceTimersByTime(5000);
+
+      // Cache remains empty and memory usage is 0
+      expect(cache.getStats().size).toBe(0);
+      expect(cache.getStats().memoryUsage).toBe(0);
+    });
+  });
 });

package/src/utilities/cache-manager.ts

@@ -20,10 +20,11 @@ export interface CacheOptions {
  * Cache manager with TTL and size limits.
  * Provides automatic cleanup and memory management.
  */
-export class CacheManager<T = any> {
+export class CacheManager<T = unknown> {
   private cache = new Map<string, CacheEntry<T>>();
+  private timers = new Map<string, ReturnType<typeof setTimeout>>();
   private memoryUsage = 0;
-  private cleanupTimer?: number;
+  private cleanupTimer?: ReturnType<typeof setInterval>;
   private readonly options: Required<CacheOptions>;
 
   constructor(options: CacheOptions = {}) {
@@ -66,13 +67,25 @@ export class CacheManager<T = any> {
       this.memoryUsage -= oldEntry.size || 0;
     }
 
+    // Cancel any existing TTL timer for this key so overwriting an entry doesn't
+    // leave a dangling timer that deletes the new value when it fires.
+    const oldTimer = this.timers.get(key);
+    if (oldTimer !== undefined) {
+      clearTimeout(oldTimer);
+      this.timers.delete(key);
+    }
+
     this.cache.set(key, entry);
     this.memoryUsage += size;
 
     // Schedule removal if TTL is set
     if (ttl || this.options.defaultTTL) {
       const timeout = ttl || this.options.defaultTTL;
-      setTimeout(() => this.delete(key), timeout);
+      const timerId = setTimeout(() => {
+        this.timers.delete(key);
+        this.delete(key);
+      }, timeout);
+      this.timers.set(key, timerId);
     }
   }
 
@@ -113,6 +126,11 @@ export class CacheManager<T = any> {
    * Delete a key from the cache
    */
   delete(key: string): boolean {
+    const timer = this.timers.get(key);
+    if (timer !== undefined) {
+      clearTimeout(timer);
+      this.timers.delete(key);
+    }
     const entry = this.cache.get(key);
     if (entry) {
       this.memoryUsage -= entry.size || 0;
@@ -125,6 +143,10 @@ export class CacheManager<T = any> {
    * Clear all entries
    */
   clear(): void {
+    for (const timer of this.timers.values()) {
+      clearTimeout(timer);
+    }
+    this.timers.clear();
     this.cache.clear();
     this.memoryUsage = 0;
   }
@@ -164,7 +186,7 @@ export class CacheManager<T = any> {
   }
 
   /**
-   * Destroy the cache and stop cleanup timer
+   * Destroy the cache, cancel all entry timers, and stop the cleanup timer.
    */
   destroy(): void {
     this.stopCleanupTimer();
@@ -236,7 +258,7 @@ export class CacheManager<T = any> {
    * Start the cleanup timer
    */
   private startCleanupTimer(): void {
-    this.cleanupTimer = window.setInterval(() => {
+    this.cleanupTimer = setInterval(() => {
       this.cleanup();
     }, this.options.cleanupInterval);
   }
@@ -246,7 +268,7 @@ export class CacheManager<T = any> {
    */
   private stopCleanupTimer(): void {
     if (this.cleanupTimer) {
-      window.clearInterval(this.cleanupTimer);
+      clearInterval(this.cleanupTimer);
       this.cleanupTimer = undefined;
     }
   }