Runtime Memory Cache

set(key: string, value: any, ttl?: number): void

Store a value with optional TTL override.

cache.set('key', 'value');                // Uses default TTL
cache.set('key', 'value', 30000);          // 30 second TTL
cache.set('key', 'value', undefined);      // No expiration

get(key: string): any

Retrieve a value. Returns undefined if key doesn't exist or has expired.

const value = cache.get('key');
if (value !== undefined) {
  console.log('Found:', value);
}

has(key: string, skipTouch?: boolean): boolean

Check if key exists and is not expired. Optionally skip updating access time.

// Normal check - updates access time for LRU
if (cache.has('key')) {
  console.log('Key exists');
}

// Skip touch - doesn't affect LRU order
if (cache.has('key', true)) {
  console.log('Key exists, LRU order unchanged');
}

del(key: string): boolean

Delete a specific key. Returns true if key existed.

const wasDeleted = cache.del('key');
if (wasDeleted) {
  console.log('Key was deleted');
}

size(): number

Get current number of entries in cache.

console.log(`Cache has ${cache.size()} entries`);

clear(): void

Remove all entries from cache.

cache.clear();
console.log(cache.size()); // 0

keys(): string[]

Get array of all keys in cache.

const allKeys = cache.keys();
console.log('All keys:', allKeys);

cleanup(): number

Manually remove expired entries. Returns number of entries removed.

const removedCount = cache.cleanup();
console.log(`Removed ${removedCount} expired entries`);

getStats(): CacheStats | null

Get cache statistics (if enabled).

interface CacheStats {
  hits: number;        // Cache hits
  misses: number;      // Cache misses  
  size: number;        // Current cache size
  maxSize: number;     // Maximum allowed size
  evictions: number;   // Number of evicted entries
}

const stats = cache.getStats();
if (stats) {
  console.log(`Hits: ${stats.hits}, Misses: ${stats.misses}`);
  console.log(`Hit Rate: ${(stats.hits / (stats.hits + stats.misses) * 100).toFixed(2)}%`);
}

resetStats(): void

Reset statistics counters (if enabled).

cache.resetStats();
console.log(cache.getStats()); // All counters reset to 0

getEvictionPolicy(): 'FIFO' | 'LRU'

Get the current eviction policy being used.

console.log(cache.getEvictionPolicy()); // 'FIFO' or 'LRU'

getMemoryUsage(): MemoryUsage

Get estimated memory usage of the cache.

interface MemoryUsage {
  estimatedBytes: number;        // Total estimated bytes
  averageBytesPerEntry: number;  // Average bytes per entry
}

const memInfo = cache.getMemoryUsage();
console.log(`Cache uses ~${memInfo.estimatedBytes} bytes`);
console.log(`Average: ${memInfo.averageBytesPerEntry} bytes per entry`);