CloudflareKVProviderclass

new CloudflareKVProvider<I, T>(kv: KVNamespace)

Param	Type
`kv`	`KVNamespace`	The `KVNamespace` binding from the Worker environment. required

Return
`CloudflareKVProvider<I, T>`	Cloudflare Workers KV database provider.

Cloudflare Workers KV database provider.

Items are stored as JSON values under keys formatted as collection:id.
The KVNamespace object is provided by the Cloudflare Workers runtime environment.

Supported

Single item operations: getItem, setItem, addItem, updateItem, deleteItem.
ID generation: addItem() generates a UUID v4 identifier automatically.

Not supported

Realtime subscriptions: getItemSequence() and getQuerySequence() throw UnimplementedError.
KV has no change feed or push notification mechanism.
Updates: updateItem() and updateQuery() throw UnimplementedError.
Collection queries: getQuery(), setQuery(), deleteQuery(), and countQuery() are not supported.
KV does not expose efficient filtering, sorting, or collection scans, so this provider avoids the old "read everything and filter in memory" behavior.

Performance limitations

Single-key store only: This provider is intentionally limited to direct key reads and writes.
If you need collection queries, filtering, sorting, or bulk mutations, use a different backend.
Eventual consistency: KV is eventually consistent, so reads may briefly return stale values shortly after writes.

Examples

// `env.KV` is the KV namespace binding from the Worker environment.
const provider = new CloudflareKVProvider(env.KV);