@vercel/kv2 0.0.1

package/README.md

@@ -0,0 +1,87 @@
+# @vercel/kv2
+
+A type-safe key-value store backed by Vercel Blob with edge caching and copy-on-write branch isolation.
+
+## Installation
+
+```bash
+npm install @vercel/kv2
+# or
+pnpm add @vercel/kv2
+```
+
+## Quick Start
+
+```typescript
+import { createKV } from "@vercel/kv2";
+
+const kv = createKV({ prefix: "myapp/" });
+
+interface User {
+  name: string;
+  email: string;
+}
+
+const users = kv.getStore<User>("users/");
+
+await users.set("alice", { name: "Alice", email: "alice@example.com" });
+
+const result = await users.get("alice");
+if (result.exists) {
+  console.log((await result.value).name); // "Alice"
+}
+
+// Delete, iterate keys, entries, getMany — see docs
+await users.delete("alice");
+```
+
+## Features
+
+| Feature | Description | Docs |
+|---------|-------------|------|
+| **Typed Stores** | Type-safe sub-stores with automatic key prefixing | [Typed Stores](docs/typed-stores.md) |
+| **Iteration** | `entries()` and `getMany()` with bounded concurrency | [Iterating and Pagination](docs/iterating-and-pagination.md) |
+| **Pagination** | Cursor-based pagination for HTTP APIs | [Iterating and Pagination](docs/iterating-and-pagination.md) |
+| **Optimistic Locking** | Version-based conflict detection and retry | [Optimistic Locking](docs/optimistic-locking.md) |
+| **Metadata** | Typed per-entry metadata, available without loading values | [Metadata](docs/metadata.md) |
+| **Schema & Trees** | Hierarchical data with batched tree loading | [Schema and Trees](docs/schema-and-trees.md) |
+| **Indexes** | Secondary indexes with unique constraints | [Indexes](docs/indexes.md) |
+| **Edge Caching** | Write-through cache with tag invalidation | [Caching](docs/caching.md) |
+| **Streaming** | Large values streamed without buffering | [Streaming](docs/streaming.md) |
+| **Copy-on-Write** | Preview branches inherit from production | [Copy-on-Write Branches](docs/copy-on-write-branches.md) |
+| **CLI Explorer** | Interactive KV store explorer for debugging | [CLI](docs/cli.md) |
+
+## Documentation
+
+1. [Getting Started](docs/getting-started.md) — installation, quick start, environment setup
+2. [Iterating and Pagination](docs/iterating-and-pagination.md) — keys, entries, getMany, cursor pagination
+3. [Typed Stores](docs/typed-stores.md) — getStore, key prefixing, nested stores
+4. [Optimistic Locking](docs/optimistic-locking.md) — versions, conflict detection, retry patterns
+5. [Metadata](docs/metadata.md) — typed metadata, filtering without loading values
+6. [Schema and Trees](docs/schema-and-trees.md) — defineSchema, tree loading, key builders
+7. [Indexes](docs/indexes.md) — secondary indexes, unique constraints, reindexing
+8. [Caching](docs/caching.md) — cache hierarchy, TTL, custom cache
+9. [Streaming](docs/streaming.md) — binary format, large values, streaming reads/writes
+10. [Copy-on-Write Branches](docs/copy-on-write-branches.md) — branch isolation, upstream config
+11. [Testing and Tracing](docs/testing-and-tracing.md) — FakeBlobStore, tracers, stats
+12. [CLI](docs/cli.md) — interactive KV store explorer
+13. [API Reference](docs/api-reference.md) — full interface and options documentation
+
+## Environment Variables
+
+```
+BLOB_READ_WRITE_TOKEN=vercel_blob_...
+```
+
+See [Getting Started](docs/getting-started.md) for full environment setup.
+
+## Testing
+
+```bash
+pnpm test              # Unit tests (fake blob store)
+pnpm test:integration  # Integration tests (real Vercel Blob)
+```
+
+## License
+
+ISC

package/SKILL.md

@@ -0,0 +1,65 @@
+# Using @vercel/kv2
+
+## Getting started
+
+Read the README for a quick overview and code examples:
+
+```
+node_modules/@vercel/kv2/README.md
+```
+
+## Docs
+
+Detailed documentation is available in the package's `docs/` directory. Read files as needed from `node_modules/@vercel/kv2/docs/`:
+
+| File | Topic |
+|------|-------|
+| `getting-started.md` | Installation, quick start, environment setup |
+| `typed-stores.md` | Type-safe sub-stores, key prefixing, nesting |
+| `iterating-and-pagination.md` | keys, entries, getMany, cursor pagination |
+| `optimistic-locking.md` | Versions, conflict detection, retry patterns |
+| `metadata.md` | Typed per-entry metadata |
+| `schema-and-trees.md` | defineSchema, tree loading, key builders |
+| `indexes.md` | Secondary indexes, unique constraints, reindexing |
+| `caching.md` | Cache hierarchy, TTL, custom cache |
+| `streaming.md` | Binary format, large values, streaming reads/writes |
+| `copy-on-write-branches.md` | Branch isolation, upstream config |
+| `testing-and-tracing.md` | FakeBlobStore, tracers, stats |
+| `cli.md` | CLI explorer reference |
+| `api-reference.md` | Full interface and options documentation |
+
+## Types
+
+All public types and interfaces are exported from the main entry point. To look up type signatures, read:
+
+```
+node_modules/@vercel/kv2/dist/index.d.ts
+```
+
+Key type definition files in `node_modules/@vercel/kv2/dist/`:
+
+| File | Types |
+|------|-------|
+| `types.d.ts` | `KVLike`, `KVEntry`, `KVGetResult`, `KVSetResult`, `KeysIterable`, `KeysPage`, `EntriesIterable`, `SetOptions`, `BlobStore`, `Tracer` |
+| `cached-kv.d.ts` | `KV2` class |
+| `typed-kv.d.ts` | `TypedKV` class, `IndexDef`, `IndexQuery` |
+| `create-kv.d.ts` | `createKV()`, `CreateKVOptions`, `UpstreamConfig` |
+| `upstream-kv.d.ts` | `UpstreamKV` class |
+| `manifest-log.d.ts` | `ManifestLog`, `KeyMeta` |
+| `tracing.d.ts` | Tracer factories, `TimingStats` |
+| `schema/index.d.ts` | `defineSchema`, `createSchemaKV`, `SchemaKV`, `TreeNode` |
+
+## Verifying KV state
+
+The package ships a `kv2` CLI for inspecting and debugging the KV store:
+
+```bash
+npx kv2 keys                          # List keys (first 100)
+npx kv2 --all keys                    # List all keys
+npx kv2 get <key>                     # Print a value as JSON
+npx kv2 --verbose get <key>           # Also show version and metadata
+npx kv2 --allow-writes set <key> <json>  # Write a value
+npx kv2 --allow-writes del <key>      # Delete a key
+```
+
+Use `--prefix <prefix>` if your app uses `createKV({ prefix: "myapp/" })`.

package/dist/blob-format.d.ts

@@ -0,0 +1,35 @@
+import type { StoredEntry } from "./types.js";
+export interface ParsedBlob<M> {
+    header: StoredEntry<M>;
+    payload: Buffer | null;
+}
+/**
+ * Detects whether a blob uses pure JSON format or binary format.
+ * Pure JSON starts with '{' (0x7B), binary format starts with uint32 length.
+ */
+export declare function isPureJsonFormat(buffer: Buffer): boolean;
+/**
+ * Parses a blob buffer into header and optional payload.
+ * Automatically detects format based on first byte.
+ *
+ * @throws {SyntaxError} If JSON parsing fails
+ * @throws {RangeError} If header length exceeds buffer size
+ */
+export declare function parseBlob<M>(buffer: Buffer): ParsedBlob<M>;
+/**
+ * Creates a blob buffer from header and optional payload.
+ * Uses pure JSON format when no payload, binary format otherwise.
+ *
+ * @throws {Error} If header exceeds MAX_HEADER_SIZE in binary format
+ */
+export declare function createBlob<M>(header: StoredEntry<M>, payload?: Buffer): Buffer;
+/**
+ * Extracts just the header from a blob without fully parsing the payload.
+ * Useful for metadata-only reads.
+ */
+export declare function parseHeader<M>(buffer: Buffer): StoredEntry<M>;
+/**
+ * Checks if a blob has a payload (large value stored after header).
+ */
+export declare function hasPayload<M>(header: StoredEntry<M>): boolean;
+//# sourceMappingURL=blob-format.d.ts.map

package/dist/blob-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob-format.d.ts","sourceRoot":"","sources":["../src/blob-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAS9C,MAAM,WAAW,UAAU,CAAC,CAAC;IAC5B,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAuC1D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC3B,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EACtB,OAAO,CAAC,EAAE,MAAM,GACd,MAAM,CA8BR;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAE7D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAE7D"}

package/dist/blob-format.js

@@ -0,0 +1,91 @@
+const HEADER_LENGTH_BYTES = 4;
+// Max header size ensures uint32 BE first byte < 0x7B ('{'), preventing format ambiguity
+// 0x7B000000 = 2,063,597,568 bytes; we use 100MB as a practical limit
+const MAX_HEADER_SIZE = 100 * 1024 * 1024;
+// ASCII code for '{'
+const OPEN_BRACE = 0x7b;
+/**
+ * Detects whether a blob uses pure JSON format or binary format.
+ * Pure JSON starts with '{' (0x7B), binary format starts with uint32 length.
+ */
+export function isPureJsonFormat(buffer) {
+    return buffer.length > 0 && buffer[0] === OPEN_BRACE;
+}
+/**
+ * Parses a blob buffer into header and optional payload.
+ * Automatically detects format based on first byte.
+ *
+ * @throws {SyntaxError} If JSON parsing fails
+ * @throws {RangeError} If header length exceeds buffer size
+ */
+export function parseBlob(buffer) {
+    if (buffer.length === 0) {
+        throw new Error("Cannot parse empty buffer");
+    }
+    if (isPureJsonFormat(buffer)) {
+        // Pure JSON format: entire buffer is the header
+        const header = JSON.parse(buffer.toString("utf-8"));
+        return { header, payload: null };
+    }
+    // Binary format: length-prefixed header + optional payload
+    if (buffer.length < HEADER_LENGTH_BYTES) {
+        throw new Error(`Buffer too small for binary format: ${buffer.length} bytes`);
+    }
+    const headerLength = buffer.readUInt32BE(0);
+    const headerEnd = HEADER_LENGTH_BYTES + headerLength;
+    if (headerEnd > buffer.length) {
+        throw new RangeError(`Header length ${headerLength} exceeds buffer size ${buffer.length}`);
+    }
+    // Parse header JSON
+    const headerJson = buffer
+        .subarray(HEADER_LENGTH_BYTES, headerEnd)
+        .toString("utf-8");
+    const header = JSON.parse(headerJson);
+    // Extract payload if present (for "raw-*" encodings)
+    const hasPayload = header.encoding === "raw-json" || header.encoding === "raw-binary";
+    const payload = hasPayload ? buffer.subarray(headerEnd) : null;
+    return { header, payload };
+}
+/**
+ * Creates a blob buffer from header and optional payload.
+ * Uses pure JSON format when no payload, binary format otherwise.
+ *
+ * @throws {Error} If header exceeds MAX_HEADER_SIZE in binary format
+ */
+export function createBlob(header, payload) {
+    const headerJson = JSON.stringify(header);
+    const headerBuffer = Buffer.from(headerJson, "utf-8");
+    // Use binary format if payload exists OR if encoding indicates payload follows
+    const hasPayload = payload ||
+        header.encoding === "raw-json" ||
+        header.encoding === "raw-binary";
+    if (hasPayload) {
+        // Safety: header size must be < MAX_HEADER_SIZE to ensure first byte < 0x7B
+        if (headerBuffer.length >= MAX_HEADER_SIZE) {
+            throw new Error(`Header too large: ${headerBuffer.length} bytes (max ${MAX_HEADER_SIZE})`);
+        }
+        // Binary format: length-prefixed header + payload
+        const lengthBuffer = Buffer.alloc(HEADER_LENGTH_BYTES);
+        lengthBuffer.writeUInt32BE(headerBuffer.length, 0);
+        if (payload) {
+            return Buffer.concat([lengthBuffer, headerBuffer, payload]);
+        }
+        return Buffer.concat([lengthBuffer, headerBuffer]);
+    }
+    // Pure JSON format: just the header (no length prefix)
+    return headerBuffer;
+}
+/**
+ * Extracts just the header from a blob without fully parsing the payload.
+ * Useful for metadata-only reads.
+ */
+export function parseHeader(buffer) {
+    return parseBlob(buffer).header;
+}
+/**
+ * Checks if a blob has a payload (large value stored after header).
+ */
+export function hasPayload(header) {
+    return header.encoding === "raw-json" || header.encoding === "raw-binary";
+}
+//# sourceMappingURL=blob-format.js.map

package/dist/blob-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob-format.js","sourceRoot":"","sources":["../src/blob-format.ts"],"names":[],"mappings":"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"}

package/dist/blob-store.d.ts

@@ -0,0 +1,11 @@
+import { type GetBlobResult, type GetCommandOptions, type ListBlobResult, type ListCommandOptions, type PutBlobResult, type PutCommandOptions } from "@vercel/blob";
+import type { BlobStore, PutBody } from "./types.js";
+export declare class VercelBlobStore implements BlobStore {
+    private token?;
+    constructor(token?: string);
+    get(pathname: string, options: GetCommandOptions): Promise<GetBlobResult | null>;
+    put(pathname: string, body: PutBody, options: PutCommandOptions): Promise<PutBlobResult>;
+    del(urlOrPathname: string | string[]): Promise<void>;
+    list(options?: ListCommandOptions): Promise<ListBlobResult>;
+}
+//# sourceMappingURL=blob-store.d.ts.map

package/dist/blob-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob-store.d.ts","sourceRoot":"","sources":["../src/blob-store.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EAKtB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErD,qBAAa,eAAgB,YAAW,SAAS;IAChD,OAAO,CAAC,KAAK,CAAC,CAAS;gBAEX,KAAK,CAAC,EAAE,MAAM;IAIpB,GAAG,CACR,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,iBAAiB,GACxB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAQ1B,GAAG,CACR,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,iBAAiB,GACxB,OAAO,CAAC,aAAa,CAAC;IAOnB,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpD,IAAI,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC;CAMjE"}

package/dist/blob-store.js

@@ -0,0 +1,32 @@
+import { del, get, list, put, } from "@vercel/blob";
+export class VercelBlobStore {
+    token;
+    constructor(token) {
+        this.token = token;
+    }
+    async get(pathname, options) {
+        return get(pathname, {
+            useCache: false,
+            ...options,
+            token: this.token,
+        });
+    }
+    async put(pathname, body, options) {
+        return put(pathname, body, {
+            ...options,
+            token: this.token,
+        });
+    }
+    async del(urlOrPathname) {
+        return del(urlOrPathname, {
+            token: this.token,
+        });
+    }
+    async list(options) {
+        return list({
+            ...options,
+            token: this.token,
+        });
+    }
+}
+//# sourceMappingURL=blob-store.js.map

package/dist/blob-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob-store.js","sourceRoot":"","sources":["../src/blob-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAON,GAAG,EACH,GAAG,EACH,IAAI,EACJ,GAAG,GACH,MAAM,cAAc,CAAC;AAGtB,MAAM,OAAO,eAAe;IACnB,KAAK,CAAU;IAEvB,YAAY,KAAc;QACzB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,GAAG,CACR,QAAgB,EAChB,OAA0B;QAE1B,OAAO,GAAG,CAAC,QAAQ,EAAE;YACpB,QAAQ,EAAE,KAAK;YACf,GAAG,OAAO;YACV,KAAK,EAAE,IAAI,CAAC,KAAK;SACjB,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,GAAG,CACR,QAAgB,EAChB,IAAa,EACb,OAA0B;QAE1B,OAAO,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE;YAC1B,GAAG,OAAO;YACV,KAAK,EAAE,IAAI,CAAC,KAAK;SACjB,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,aAAgC;QACzC,OAAO,GAAG,CAAC,aAAa,EAAE;YACzB,KAAK,EAAE,IAAI,CAAC,KAAK;SACjB,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAA4B;QACtC,OAAO,IAAI,CAAC;YACX,GAAG,OAAO;YACV,KAAK,EAAE,IAAI,CAAC,KAAK;SACjB,CAAC,CAAC;IACJ,CAAC;CACD"}

package/dist/cache.d.ts

@@ -0,0 +1,33 @@
+import type { CacheLike, CachedEntry } from "./types.js";
+/**
+ * Encode cache keys/tags to be safe for HTTP headers (used by Vercel cache tags).
+ * HTTP headers only allow ASCII printable characters (0x20-0x7E), excluding certain chars.
+ * We use percent-encoding for non-ASCII and problematic characters, keeping ASCII readable.
+ * @internal Exported for testing
+ */
+export declare function encodeCacheKey(path: string): string;
+/** Error handler function type for KVCache error logging */
+export type ErrorHandler = (message: string, error: unknown) => void;
+export interface KVCacheOptions {
+    ttl: number;
+    /** Optional cache implementation for testing */
+    cache?: CacheLike;
+    /** Optional error handler for testing (defaults to console.error) */
+    onError?: ErrorHandler;
+}
+export declare class KVCache {
+    private ttl;
+    private useProxy;
+    private useMemory;
+    private injectedCache;
+    private errorHandler;
+    constructor(options: KVCacheOptions | number);
+    private getCache;
+    private getCacheKey;
+    private getCacheTag;
+    private sleep;
+    get<M>(path: string): Promise<CachedEntry<M> | null>;
+    set<M>(path: string, entry: CachedEntry<M>): Promise<void>;
+    invalidate(path: string): Promise<void>;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAOzD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAwBnD;AAcD,4DAA4D;AAC5D,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;AAErE,MAAM,WAAW,cAAc;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,qEAAqE;IACrE,OAAO,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,qBAAa,OAAO;IACnB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,aAAa,CAAmB;IACxC,OAAO,CAAC,YAAY,CAAe;gBAEvB,OAAO,EAAE,cAAc,GAAG,MAAM;YAgB9B,QAAQ;IAiBtB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,KAAK;IAIP,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAYpD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB1D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA2B7C"}

package/dist/cache.js

@@ -0,0 +1,146 @@
+import { getMemoryCache, shouldUseMemoryCache } from "./memory-cache.js";
+import { getProxyCache, shouldUseProxyCache } from "./proxy-cache.js";
+const CACHE_KEY_PREFIX = "cached-kv:";
+const MAX_CACHE_SIZE = 1 * 1024 * 1024; // 1MB - keep cache lightweight
+const INVALIDATE_RETRIES = 3;
+const INVALIDATE_BACKOFF_MS = [100, 500, 1000];
+/**
+ * Encode cache keys/tags to be safe for HTTP headers (used by Vercel cache tags).
+ * HTTP headers only allow ASCII printable characters (0x20-0x7E), excluding certain chars.
+ * We use percent-encoding for non-ASCII and problematic characters, keeping ASCII readable.
+ * @internal Exported for testing
+ */
+export function encodeCacheKey(path) {
+    let result = "";
+    for (const char of path) {
+        const code = char.charCodeAt(0);
+        // Keep ASCII printable chars except %, ", and + (which we use for space encoding)
+        if (code >= 0x21 &&
+            code <= 0x7e &&
+            char !== "%" &&
+            char !== '"' &&
+            char !== "+") {
+            result += char;
+        }
+        else if (char === " ") {
+            result += "+"; // Space as + for readability
+        }
+        else if (char === "+") {
+            result += "%2B"; // Encode + to avoid collision with space
+        }
+        else {
+            // Percent-encode everything else (unicode, control chars, etc.)
+            const encoded = encodeURIComponent(char);
+            result += encoded;
+        }
+    }
+    return result;
+}
+// Lazy import to avoid @vercel/functions initialization message when using proxy
+let vercelCache = null;
+async function getVercelCache() {
+    if (!vercelCache) {
+        const { getCache } = await import("@vercel/functions");
+        vercelCache = getCache();
+    }
+    return vercelCache;
+}
+let loggedProxyUsage = false;
+export class KVCache {
+    ttl;
+    useProxy;
+    useMemory;
+    injectedCache;
+    errorHandler;
+    constructor(options) {
+        if (typeof options === "number") {
+            // Legacy: just TTL
+            this.ttl = options;
+            this.injectedCache = null;
+            this.errorHandler = (msg, err) => console.error(msg, err);
+        }
+        else {
+            this.ttl = options.ttl;
+            this.injectedCache = options.cache ?? null;
+            this.errorHandler =
+                options.onError ?? ((msg, err) => console.error(msg, err));
+        }
+        this.useProxy = shouldUseProxyCache();
+        this.useMemory = shouldUseMemoryCache();
+    }
+    async getCache() {
+        if (this.injectedCache) {
+            return this.injectedCache;
+        }
+        if (this.useProxy) {
+            if (!loggedProxyUsage) {
+                console.log("[KVCache] Using proxy cache for integration tests");
+                loggedProxyUsage = true;
+            }
+            return getProxyCache();
+        }
+        if (this.useMemory) {
+            return getMemoryCache();
+        }
+        return getVercelCache();
+    }
+    getCacheKey(path) {
+        return `${CACHE_KEY_PREFIX}${encodeCacheKey(path)}`;
+    }
+    getCacheTag(path) {
+        return `${CACHE_KEY_PREFIX}${encodeCacheKey(path)}`;
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    async get(path) {
+        try {
+            const cache = await this.getCache();
+            const key = this.getCacheKey(path);
+            const result = await cache.get(key);
+            return result;
+        }
+        catch (err) {
+            this.errorHandler("[KVCache] cache read failed:", err);
+            return null;
+        }
+    }
+    async set(path, entry) {
+        // Don't cache entries larger than max size
+        if (entry.size > MAX_CACHE_SIZE) {
+            return;
+        }
+        try {
+            const cache = await this.getCache();
+            const key = this.getCacheKey(path);
+            const tag = this.getCacheTag(path);
+            await cache.set(key, entry, {
+                tags: [tag],
+                ttl: this.ttl,
+            });
+        }
+        catch (err) {
+            this.errorHandler("[KVCache] cache write failed:", err);
+        }
+    }
+    async invalidate(path) {
+        const tag = this.getCacheTag(path);
+        let lastError;
+        for (let attempt = 0; attempt < INVALIDATE_RETRIES; attempt++) {
+            try {
+                const cache = await this.getCache();
+                await cache.expireTag(tag);
+                return;
+            }
+            catch (err) {
+                lastError = err;
+                this.errorHandler(`[KVCache] invalidation failed (attempt ${attempt + 1}/${INVALIDATE_RETRIES}):`, err);
+                if (attempt < INVALIDATE_RETRIES - 1) {
+                    await this.sleep(INVALIDATE_BACKOFF_MS[attempt]);
+                }
+            }
+        }
+        this.errorHandler(`[KVCache] invalidation failed after ${INVALIDATE_RETRIES} retries, giving up:`, lastError);
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"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"}

package/dist/cached-kv.d.ts

@@ -0,0 +1,63 @@
+import { TypedKV } from "./typed-kv.js";
+import type { EntriesIterable, KV2Options, KVEntry, KVGetResult, KVLike, KVSetResult, KeysIterable, SetOptions } from "./types.js";
+export declare class KV2<M = undefined> implements KVLike<M> {
+    private prefix;
+    private blobStore;
+    private cache;
+    private largeValueThreshold;
+    private tracer;
+    constructor(options?: KV2Options);
+    private getFullPath;
+    private getListPrefix;
+    private stripPrefix;
+    private readBlob;
+    /**
+     * Reads blob header without buffering the entire payload.
+     * For binary format (large values), returns a reader positioned at the payload.
+     * For pure JSON format (small values), returns the complete buffer.
+     */
+    private readBlobStreaming;
+    private readBlobWithConsistencyCheck;
+    /**
+     * Streaming version of readBlobWithConsistencyCheck.
+     * Returns header and a reader for the payload without buffering.
+     */
+    private readBlobStreamingWithConsistencyCheck;
+    private sleep;
+    private serializeValue;
+    private deserializeValue;
+    get<V = unknown>(key: string): Promise<KVGetResult<V, M>>;
+    /**
+     * Creates a result from a fully-buffered blob (pure JSON format or cached).
+     */
+    private createResultFromBuffer;
+    /**
+     * Creates a result with true streaming for binary format (large values).
+     * The payload is streamed directly from the blob store without buffering.
+     */
+    private createStreamingResult;
+    private resolveValue;
+    private getPayloadBytes;
+    set<V = unknown>(key: string, value: V | ReadableStream<Uint8Array>, ...[metadata, options]: undefined extends M ? [M?, SetOptions?] : [M, SetOptions?]): Promise<KVSetResult>;
+    private concatStreams;
+    delete(key: string): Promise<void>;
+    keys(prefix?: string): KeysIterable;
+    /**
+     * Fetch multiple keys concurrently with bounded concurrency.
+     * Returns a Map of key -> entry for all existing keys.
+     *
+     * @param keys - Array of keys to fetch
+     * @param concurrency - Number of concurrent get operations (default: 10)
+     */
+    getMany<V = unknown>(keys: string[], concurrency?: number): Promise<Map<string, KVEntry<V, M>>>;
+    /**
+     * Iterate over key-value entries with concurrent fetching.
+     * Yields [key, entry] pairs as soon as each fetch completes.
+     *
+     * @param prefix - Optional prefix to filter keys
+     * @param concurrency - Number of concurrent get operations (default: 20)
+     */
+    entries<V = unknown>(prefix?: string, concurrency?: number): EntriesIterable<V, M>;
+    getStore<V, SubM = M, I extends string = never>(subPrefix: string, indexes?: Record<I, import("./typed-kv.js").IndexDef<V>>): TypedKV<V, SubM, I>;
+}
+//# sourceMappingURL=cached-kv.d.ts.map

package/dist/cached-kv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cached-kv.d.ts","sourceRoot":"","sources":["../src/cached-kv.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAGX,eAAe,EAEf,UAAU,EACV,OAAO,EACP,WAAW,EACX,MAAM,EACN,WAAW,EACX,YAAY,EAEZ,UAAU,EAGV,MAAM,YAAY,CAAC;AA4BpB,qBAAa,GAAG,CAAC,CAAC,GAAG,SAAS,CAAE,YAAW,MAAM,CAAC,CAAC,CAAC;IACnD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,GAAE,UAAe;IAgBpC,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,WAAW;YASL,QAAQ;IAkBtB;;;;OAIG;YACW,iBAAiB;YA6EjB,4BAA4B;IA0C1C;;;OAGG;YACW,qCAAqC;IAgDnD,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,cAAc;IA0BtB,OAAO,CAAC,gBAAgB;IAUlB,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAqH/D;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAwE9B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;YAoJf,YAAY;IA4C1B,OAAO,CAAC,eAAe;IAUjB,GAAG,CAAC,CAAC,GAAG,OAAO,EACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,GAAG,cAAc,CAAC,UAAU,CAAC,EACrC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,SAAS,SAAS,CAAC,GACxC,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,GACjB,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,GACjB,OAAO,CAAC,WAAW,CAAC;IAoIvB,OAAO,CAAC,aAAa;IAiCf,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBxC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY;IA+EnC;;;;;;OAMG;IACG,OAAO,CAAC,CAAC,GAAG,OAAO,EACxB,IAAI,EAAE,MAAM,EAAE,EACd,WAAW,SAAK,GACd,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAoCtC;;;;;;OAMG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,SAAK,GACd,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC;IA6GxB,QAAQ,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,KAAK,EAC7C,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,OAAO,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,GACtD,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;CAOtB"}