smart-cache

smart-cache is a tiny, dependency-free in-memory cache with TTL expiration and LRU eviction.

Install

npm install smart-cache

Usage

const TinyCache = require('smart-cache');

const cache = new TinyCache({ maxSize: 100, ttl: 60_000 });
cache.set('user:42', { name: 'Ada' });

cache.get('user:42'); // { name: 'Ada' }
cache.has('user:42'); // true
cache.delete('user:42');

maxSize limits the number of entries. The least recently used entry is evicted when the limit is exceeded. ttl is measured in milliseconds; 0 disables expiration. Expired entries are removed lazily during cache access, writes, and metadata reads. The optional now function can provide a custom millisecond clock for deterministic tests.

API

• new TinyCache(options?)
• set(key, value) returns the cache for chaining
• get(key) returns the value or undefined
• has(key) checks whether a non-expired value exists
• delete(key) removes one entry
• clear() removes all entries
• size returns the number of non-expired entries
• keys() returns keys from least to most recently used