Class MemoryStorage<T>

In-memory storage implementation with TTL support

This is the default storage used when no external storage is configured. Features:

TTL support with automatic cleanup
Pattern matching
Batch operations
Memory-efficient (garbage collection of expired items)

Example

const storage = new MemoryStorage<string>();
await storage.set('key', 'value', 60); // TTL of 60 seconds
const value = await storage.get('key');

Type Parameters

Implements

Index

Constructors

constructor

Methods

get set delete has clear keys size mget mset mdel scan deletePattern cleanupExpired getStats destroy

Constructors

constructor

new MemoryStorage<T>(
    options?: {
        cleanupIntervalMs?: number;
        maxItems?: number;
        autoCleanup?: boolean;
    },
): MemoryStorage<T>
Type Parameters
- T
Parameters
- options: { cleanupIntervalMs?: number; maxItems?: number; autoCleanup?: boolean } = {}
  - OptionalcleanupIntervalMs?: number
    How often to clean up expired items (ms), default 5 minutes
  - OptionalmaxItems?: number
    Maximum items to store before forcing cleanup, default 10000
  - OptionalautoCleanup?: boolean
    Whether to enable automatic cleanup, default true
Returns MemoryStorage<T>
- Defined in src/lib/storage/MemoryStorage.ts:37

Methods

get

get(key: string): Promise<undefined | T>
Get a value by key
Parameters
- key: string
  Storage key
Returns Promise<undefined | T>
Value or undefined if not found
Implementation of PatternStorage.get
- Defined in src/lib/storage/MemoryStorage.ts:59

set

set(key: string, value: T, ttl?: number): Promise<void>
Set a value with optional TTL
Parameters
- key: string
  Storage key
- value: T
  Value to store
- Optionalttl: number
  Time to live in seconds (optional)
Returns Promise<void>
Implementation of PatternStorage.set
- Defined in src/lib/storage/MemoryStorage.ts:75

delete

delete(key: string): Promise<void>
Delete a value by key
Parameters
- key: string
  Storage key
Returns Promise<void>
Implementation of PatternStorage.delete
- Defined in src/lib/storage/MemoryStorage.ts:92

has

has(key: string): Promise<boolean>
Check if a key exists
Parameters
- key: string
  Storage key
Returns Promise<boolean>
Implementation of PatternStorage.has
- Defined in src/lib/storage/MemoryStorage.ts:96

clear

clear(): Promise<void>
Clear all stored values (optional)

Returns Promise<void>
Implementation of PatternStorage.clear
- Defined in src/lib/storage/MemoryStorage.ts:101

keys

keys(): Promise<string[]>
Get all keys (optional, for debugging)

Returns Promise<string[]>
Implementation of PatternStorage.keys
- Defined in src/lib/storage/MemoryStorage.ts:105

size

size(): Promise<number>
Get storage size/count (optional, for monitoring)

Returns Promise<number>
Implementation of PatternStorage.size
- Defined in src/lib/storage/MemoryStorage.ts:119

mget

mget(keys: string[]): Promise<(undefined | T)[]>
Get multiple values at once
Parameters
- keys: string[]
Returns Promise<(undefined | T)[]>
Implementation of BatchStorage.mget
- Defined in src/lib/storage/MemoryStorage.ts:127

mset

mset(entries: { key: string; value: T; ttl?: number }[]): Promise<void>
Set multiple values at once
Parameters
- entries: { key: string; value: T; ttl?: number }[]
Returns Promise<void>
Implementation of BatchStorage.mset
- Defined in src/lib/storage/MemoryStorage.ts:132

mdel

mdel(keys: string[]): Promise<number>
Delete multiple keys at once
Parameters
- keys: string[]
Returns Promise<number>
Implementation of BatchStorage.mdel
- Defined in src/lib/storage/MemoryStorage.ts:137

scan

scan(pattern: string): Promise<string[]>
Get keys matching a pattern
Parameters
- pattern: string
Returns Promise<string[]>
Implementation of PatternStorage.scan
- Defined in src/lib/storage/MemoryStorage.ts:150

deletePattern

deletePattern(pattern: string): Promise<number>
Delete keys matching a pattern
Parameters
- pattern: string
Returns Promise<number>
Implementation of PatternStorage.deletePattern
- Defined in src/lib/storage/MemoryStorage.ts:156

cleanupExpired

cleanupExpired(): number
Manually trigger cleanup of expired items

Returns number
- Defined in src/lib/storage/MemoryStorage.ts:166

getStats

getStats(): {
    totalItems: number;
    expiredItems: number;
    memoryUsage: number;
    lastCleanup: number;
    oldestItem?: number;
    newestItem?: number;
}
Get storage statistics

Returns {
    totalItems: number;
    expiredItems: number;
    memoryUsage: number;
    lastCleanup: number;
    oldestItem?: number;
    newestItem?: number;
}
- Defined in src/lib/storage/MemoryStorage.ts:184

destroy

destroy(): void
Destroy the storage and cleanup resources

Returns void
- Defined in src/lib/storage/MemoryStorage.ts:255

Class MemoryStorage<T>

Example

Type Parameters

Implements

Index

Constructors

Methods

Constructors

constructor

Type Parameters

Parameters

OptionalcleanupIntervalMs?: number

OptionalmaxItems?: number

OptionalautoCleanup?: boolean

Returns MemoryStorage<T>

Methods

get

Parameters

Returns Promise<undefined | T>

set

Parameters

Returns Promise<void>

delete

Parameters

Returns Promise<void>

has

Parameters

Returns Promise<boolean>

clear

Returns Promise<void>

keys

Returns Promise<string[]>

size

Returns Promise<number>

mget

Parameters

Returns Promise<(undefined | T)[]>

mset

Parameters

Returns Promise<void>

mdel

Parameters

Returns Promise<number>

scan

Parameters

Returns Promise<string[]>

deletePattern

Parameters

Returns Promise<number>

cleanupExpired

Returns number

getStats

Returns { totalItems: number; expiredItems: number; memoryUsage: number; lastCleanup: number; oldestItem?: number; newestItem?: number;}

destroy

Returns void

Settings

On This Page

`Optional`cleanupIntervalMs?: number

`Optional`maxItems?: number

`Optional`autoCleanup?: boolean

Returns {
totalItems: number;
expiredItems: number;
memoryUsage: number;
lastCleanup: number;
oldestItem?: number;
newestItem?: number;
}