Class CloudflareKVAdapter

Cloudflare Workers KV storage adapter. Uses KV's built-in expirationTtl for automatic TTL-based eviction.

Implements

CacheStorageAdapter

Index

Constructors

Methods

get set delete keys clear

Constructors

constructor

new CloudflareKVAdapter(
kv: CloudflareKVNamespace,
prefix?: string,
): CloudflareKVAdapter
Parameters
- kv: CloudflareKVNamespace
  The Cloudflare KV namespace binding
- prefix: string = "hc:"
  Key prefix to isolate cache entries. Default: "hc:"
Returns CloudflareKVAdapter
- Defined in src/cache.ts:309

Methods

get

get(key: string): Promise<CacheEntry | null>
Retrieve an entry by key from KV. Returns null when missing.
Parameters
- key: string
Returns Promise<CacheEntry | null>
Implementation of CacheStorageAdapter.get
- Defined in src/cache.ts:317

set

set(key: string, entry: CacheEntry): Promise<void>
Store an entry in KV with automatic expirationTtl derived from entry.expiresAt.
Parameters
- key: string
- entry: CacheEntry
Returns Promise<void>
Implementation of CacheStorageAdapter.set
- Defined in src/cache.ts:323

delete

delete(key: string): Promise<void>
Remove an entry by key from KV.
Parameters
- key: string
Returns Promise<void>
Implementation of CacheStorageAdapter.delete
- Defined in src/cache.ts:334

keys

keys(): Promise<string[]>
List all cached keys currently stored in KV.

Returns Promise<string[]>
Implementation of CacheStorageAdapter.keys
- Defined in src/cache.ts:339

clear

clear(): Promise<void>
Remove all cached entries from KV.

Returns Promise<void>
Implementation of CacheStorageAdapter.clear
- Defined in src/cache.ts:345