Skip to content

feat(cloudflare): add KV Instant namespaces with local emulation - #2027

Draft
BlankParticle wants to merge 1 commit into
mainfrom
blank/add-kv-instant-namespace
Draft

BlankParticle wants to merge 1 commit into
mainfrom
blank/add-kv-instant-namespace

Conversation

@BlankParticle

Copy link
Copy Markdown
Member

Adds Cloudflare.KV.InstantNamespace for Workers KV Instant, including lifecycle management, existing KV capabilities, Worker bindings, and persistent local emulation. Classic and Instant namespaces are kept separate during discovery and adoption; switching modes replaces the namespace, with delete-first replacement when reusing a title.

Instant clients omit metadata and pagination APIs. Local emulation enforces the 300-byte UTF-8 key limit, rejects metadata, and returns matching keys in one page. Storage quotas, key-count limits, throttling, and global replication are intentionally not emulated.

Draft pending private beta verification. Live lifecycle, adoption, mode-switch, and remote-binding tests remain TODO until the testing account has beta access. API response mode fields and live REST behavior still need verification.

Validation:

  • 5 local integration tests passed, including mode switches in both directions, Action restrictions, and classic KV regressions.
  • 48 runtime KV tests passed.
  • Alchemy source and focused test type-checks passed, including classic/Instant/union capability assertions.
  • Runtime build/type-check, lint, formatting, docs generation, and JSDoc checks passed.

Reference: https://blog.cloudflare.com/workers-kv-instant/

@alchemy-version-bot

Copy link
Copy Markdown
Contributor

Install the packages built from this commit:

alchemy

pnpm install https://pkg.alchemy.run/alchemy/pr:2027:f5c21c0
@alchemy.run (6)
pnpm install https://pkg.alchemy.run/@alchemy.run/better-auth/pr:2027:f5c21c0
pnpm install https://pkg.alchemy.run/@alchemy.run/cloudflare-runtime/pr:2027:f5c21c0
pnpm install https://pkg.alchemy.run/@alchemy.run/frontend-frameworks/pr:2027:f5c21c0
pnpm install https://pkg.alchemy.run/@alchemy.run/node-utils/pr:2027:f5c21c0
pnpm install https://pkg.alchemy.run/@alchemy.run/floci/pr:2027:f5c21c0
pnpm install https://pkg.alchemy.run/@alchemy.run/pkg/pr:2027:f5c21c0
@distilled.cloud (16)
pnpm install https://pkg.alchemy.run/@distilled.cloud/core/pr:2027:f5c21c0
pnpm install https://pkg.alchemy.run/@distilled.cloud/acme/pr:2027:f5c21c0
pnpm install https://pkg.alchemy.run/@distilled.cloud/aws/pr:2027:f5c21c0
pnpm install https://pkg.alchemy.run/@distilled.cloud/axiom/pr:2027:f5c21c0
pnpm install https://pkg.alchemy.run/@distilled.cloud/cloudflare/pr:2027:f5c21c0
pnpm install https://pkg.alchemy.run/@distilled.cloud/doppler/pr:2027:f5c21c0
pnpm install https://pkg.alchemy.run/@distilled.cloud/fly-io/pr:2027:f5c21c0
pnpm install https://pkg.alchemy.run/@distilled.cloud/github/pr:2027:f5c21c0
pnpm install https://pkg.alchemy.run/@distilled.cloud/hetzner/pr:2027:f5c21c0
pnpm install https://pkg.alchemy.run/@distilled.cloud/infisical/pr:2027:f5c21c0
pnpm install https://pkg.alchemy.run/@distilled.cloud/neon/pr:2027:f5c21c0
pnpm install https://pkg.alchemy.run/@distilled.cloud/prisma/pr:2027:f5c21c0
pnpm install https://pkg.alchemy.run/@distilled.cloud/planetscale/pr:2027:f5c21c0
pnpm install https://pkg.alchemy.run/@distilled.cloud/railway/pr:2027:f5c21c0
pnpm install https://pkg.alchemy.run/@distilled.cloud/stripe/pr:2027:f5c21c0
pnpm install https://pkg.alchemy.run/@distilled.cloud/zerossl/pr:2027:f5c21c0

Published Oct 6, 2026, 10:22 AM UTC. Expires Oct 13, 2026, 10:22 AM UTC, extended while this pull request is open.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant