@vercel/kv2 0.0.5 → 0.0.6

package/README.md

@@ -63,7 +63,7 @@ await users.delete("alice");
 8. [Caching](https://github.com/vercel-labs/KV2/blob/main/docs/caching.md) — cache hierarchy, TTL, custom cache
 9. [Streaming](https://github.com/vercel-labs/KV2/blob/main/docs/streaming.md) — binary format, large values, streaming reads/writes
 10. [Copy-on-Write Branches](https://github.com/vercel-labs/KV2/blob/main/docs/copy-on-write-branches.md) — branch isolation, upstream config
-11. [Testing and Tracing](https://github.com/vercel-labs/KV2/blob/main/docs/testing-and-tracing.md) — FakeBlobStore, tracers, stats
+11. [Testing and Tracing](https://github.com/vercel-labs/KV2/blob/main/docs/testing-and-tracing.md) — unit testing, tracers, stats
 12. [CLI](https://github.com/vercel-labs/KV2/blob/main/docs/cli.md) — interactive KV store explorer
 13. [API Reference](https://github.com/vercel-labs/KV2/blob/main/docs/api-reference.md) — full interface and options documentation
 

package/SKILL.md

@@ -24,7 +24,7 @@ Detailed documentation is available in the package's `docs/` directory. Read fil
 | `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 |
+| `testing-and-tracing.md` | Unit testing, tracers, stats |
 | `cli.md` | CLI explorer reference |
 | `api-reference.md` | Full interface and options documentation |
 

package/docs/testing-and-tracing.md

@@ -4,9 +4,13 @@
 
 ## Testing
 
-### FakeBlobStore
+### Local development
 
-An in-memory blob store for unit tests. No network calls, no tokens needed:
+For local development, use a real Vercel Blob store. This ensures your app behaves the same locally as it does in production. See [Getting Started](getting-started.md) for setup instructions — `vercel env pull .env.local` gives you a `BLOB_READ_WRITE_TOKEN` that works locally.
+
+### Unit tests
+
+For unit tests, use `FakeBlobStore` — an in-memory blob store that requires no network calls or tokens:
 
 ```typescript
 import { FakeBlobStore } from "@vercel/kv2/testing";
@@ -19,22 +23,18 @@ await kv.set("key", { hello: "world" });
 const result = await kv.get("key");
 ```
 
-### FakeCache
-
-An in-memory cache with call tracking and programmable error injection:
+`FakeCache` provides an in-memory cache with call tracking:
 
 ```typescript
-import { FakeCache } from "@vercel/kv2/testing";
+import { FakeBlobStore, FakeCache } from "@vercel/kv2/testing";
 import { KV2 } from "@vercel/kv2";
 
-const cache = new FakeCache();
 const blobStore = new FakeBlobStore();
+const cache = new FakeCache();
 const kv = new KV2({ prefix: "test/", blobStore, cache });
 ```
 
-### createTestKV
-
-A convenience factory that creates a KV2 backed by `FakeBlobStore` (or real Vercel Blob when `INTEGRATION_TEST=1`):
+Or use `createTestKV` for a one-liner:
 
 ```typescript
 import { createTestKV } from "@vercel/kv2/testing";
@@ -47,17 +47,15 @@ await kv.set("key", { hello: "world" });
 await cleanup();
 ```
 
-### Integration Tests
+### Integration tests
 
-Set environment variables and run:
+To run tests against a real Vercel Blob store, set the environment variables and run:
 
 ```bash
-INTEGRATION_TEST=1 pnpm test
+INTEGRATION_TEST=1 BLOB_READ_WRITE_TOKEN=vercel_blob_... pnpm test
 ```
 
-Required env vars for integration tests:
-- `BLOB_READ_WRITE_TOKEN` — Vercel Blob access token
-- `PROTECTION_BYPASS` — Protection bypass token
+`createTestKV` automatically switches to a real blob store when `INTEGRATION_TEST=1` is set.
 
 ## Tracing
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/kv2",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "description": "KV2 - A type-safe KV store backed by Vercel private blobs with regional caching",
   "type": "module",
   "files": [