Class MapCacheAdapter<T>

Map-based cache adapter with LRU eviction and background cleanup.

Provides cache operations using a Map with:

LRU eviction when maxSize is reached
Background cleanup of expired entries
Access statistics tracking

All methods are async to conform to CacheAdapter interface, but operations are synchronous internally for performance.

Example

const adapter = new MapCacheAdapter({ maxSize: 500, cleanupInterval: 30000 });
await adapter.set('key', item, Date.now() + 60000);
const cached = await adapter.get('key');

Type Parameters

Implements

CacheAdapter<T>

Index

Constructors

constructor

new MapCacheAdapter<T>(opts?: MapCacheAdapterOptions): MapCacheAdapter<T>
Type Parameters
- T
Parameters
- opts: MapCacheAdapterOptions = {}
Returns MapCacheAdapter<T>
- Defined in packages/utils/src/flow-control/memo/adapter.ts:31

Accessors

size

get size(): number
Current number of cached items (may include expired items).

Returns number
Implementation of CacheAdapter.size
- Defined in packages/utils/src/flow-control/memo/adapter.ts:137

Methods

cleanupExpired

cleanupExpired(): void
Manually trigger cleanup of expired entries.

Returns void
- Defined in packages/utils/src/flow-control/memo/adapter.ts:158

clear

clear(): Promise<void>
Remove all cached items.

Returns Promise<void>
Implementation of CacheAdapter.clear
- Defined in packages/utils/src/flow-control/memo/adapter.ts:84

delete

delete(key: string): Promise<boolean>
Remove specific key. Returns true if existed.
Parameters
- key: string
Returns Promise<boolean>
Implementation of CacheAdapter.delete
- Defined in packages/utils/src/flow-control/memo/adapter.ts:79

entries

entries(): IterableIterator<[string, CacheItem<T>]>
Sync iterator over all cache entries. Kept for memoize compatibility.

Returns IterableIterator<[string, CacheItem<T>]>
- Defined in packages/utils/src/flow-control/memo/adapter.ts:129

get

get(key: string): Promise<CacheItem<T> | null>
Retrieve cache item by key. Returns undefined if missing.
Parameters
- key: string
Returns Promise<CacheItem<T> | null>
Implementation of CacheAdapter.get
- Defined in packages/utils/src/flow-control/memo/adapter.ts:50

getStats

getStats(): { evictions: number; size: number }
Gets eviction statistics.

Returns { evictions: number; size: number }
Object with eviction count
- Defined in packages/utils/src/flow-control/memo/adapter.ts:147

has

has(key: string): Promise<boolean>
Check if key exists (may still be expired - adapter handles expiration).
Parameters
- key: string
Returns Promise<boolean>
Implementation of CacheAdapter.has
- Defined in packages/utils/src/flow-control/memo/adapter.ts:95

keys

keys(): IterableIterator<string>
Sync iterator over all cache keys. Kept for memoize compatibility.

Returns IterableIterator<string>
- Defined in packages/utils/src/flow-control/memo/adapter.ts:117

set

set(key: string, value: CacheItem<T>, _expiresAt?: number): Promise<void>
Store cache item with given key.
Parameters
- key: string
  Cache key
- value: CacheItem<T>
  Cache item with value and metadata
- Optional_expiresAt: number
  Optional expiration timestamp for backends like Redis
Returns Promise<void>
Implementation of CacheAdapter.set
- Defined in packages/utils/src/flow-control/memo/adapter.ts:68

Class MapCacheAdapter<T>

Example

Type Parameters

Implements

Index

Constructors

Accessors

Methods

Constructors

constructor

Type Parameters

Parameters

Returns MapCacheAdapter<T>

Accessors

size

Returns number

Methods

cleanupExpired

Returns void

clear

Returns Promise<void>

delete

Parameters

Returns Promise<boolean>

entries

Returns IterableIterator<[string, CacheItem<T>]>

get

Parameters

Returns Promise<CacheItem<T> | null>

getStats

Returns { evictions: number; size: number }

has

Parameters

Returns Promise<boolean>

keys

Returns IterableIterator<string>

set

Parameters

Returns Promise<void>

Settings

On This Page