@vercel/kv2 0.0.1

package/dist/types.d.ts

@@ -0,0 +1,199 @@
+import type { Readable } from "node:stream";
+import type { GetBlobResult, GetCommandOptions, ListBlobResult, ListCommandOptions, PutBlobResult, PutCommandOptions } from "@vercel/blob";
+/**
+ * Result of a set operation.
+ */
+export interface KVSetResult {
+    /** Version (etag) of the written blob, for use with optimistic locking */
+    version: string;
+}
+/**
+ * Options for set operations.
+ */
+export interface SetOptions {
+    /** Only succeed if current version matches (optimistic locking) */
+    expectedVersion?: string;
+    /** Allow overwriting existing values. Default: true */
+    override?: boolean;
+}
+/**
+ * Error thrown when a conditional update fails due to version mismatch.
+ */
+export declare class KVVersionConflictError extends Error {
+    constructor(key: string);
+}
+/**
+ * Error thrown when a unique index constraint is violated.
+ */
+export declare class KVIndexConflictError extends Error {
+    indexName: string;
+    indexKey: string;
+    constructor(indexName: string, indexKey: string);
+}
+export interface KVEntry<V, M> {
+    exists: true;
+    metadata: M;
+    /** Lazily buffers and parses the value on first access */
+    value: Promise<V>;
+    /** Lazily returns a stream of the raw payload bytes */
+    stream: Promise<ReadableStream<Uint8Array>>;
+    /** Version (etag) of this entry, for use with optimistic locking */
+    version: string;
+    /** Conditionally update using the version from when this entry was read */
+    update(value: V | ReadableStream<Uint8Array>, metadata?: M): Promise<KVSetResult>;
+}
+export interface KVEntryNotFound {
+    exists: false;
+    metadata: undefined;
+    value: undefined;
+    stream: undefined;
+}
+export type KVGetResult<V, M> = KVEntry<V, M> | KVEntryNotFound;
+/**
+ * Result of a paginated keys query.
+ */
+export interface KeysPage {
+    keys: string[];
+    cursor?: string;
+}
+/**
+ * Result of a paginated entries query.
+ */
+export interface EntriesPage<V, M> {
+    entries: [string, KVEntry<V, M>][];
+    cursor?: string;
+}
+/**
+ * AsyncIterable for keys with pagination support.
+ */
+export interface KeysIterable extends AsyncIterable<string> {
+    /**
+     * Fetch a page of keys.
+     * @param limit - Maximum number of keys to return
+     * @param cursor - Cursor from previous page (undefined for first page)
+     */
+    page(limit: number, cursor?: string): Promise<KeysPage>;
+}
+/**
+ * AsyncIterable for entries with pagination support.
+ */
+export interface EntriesIterable<V, M> extends AsyncIterable<[string, KVEntry<V, M>]> {
+    /**
+     * Fetch a page of entries.
+     * @param limit - Maximum number of entries to return
+     * @param cursor - Cursor from previous page (undefined for first page)
+     */
+    page(limit: number, cursor?: string): Promise<EntriesPage<V, M>>;
+}
+/**
+ * Common interface for KV stores (KV2 and UpstreamKV).
+ * Used by TypedKV to support both as parents.
+ */
+export interface KVLike<M> {
+    get<V = unknown>(key: string): Promise<KVGetResult<V, M>>;
+    set<V = unknown>(key: string, value: V | ReadableStream<Uint8Array>, metadata?: M, options?: SetOptions): Promise<KVSetResult>;
+    delete(key: string): Promise<void>;
+    keys(prefix?: string): KeysIterable;
+    entries<V = unknown>(prefix?: string): EntriesIterable<V, M>;
+    getMany<V = unknown>(keys: string[], concurrency?: number): Promise<Map<string, KVEntry<V, M>>>;
+}
+/** A string that ends with a forward slash */
+export type PrefixString = `${string}/`;
+/** Cache interface for KVCache dependency injection */
+export interface CacheLike {
+    get(key: string): Promise<unknown>;
+    set(key: string, value: unknown, options?: {
+        tags?: string[];
+        ttl?: number;
+    }): Promise<void>;
+    expireTag(tag: string): Promise<void>;
+}
+export interface KV2Options {
+    /** Global prefix for all keys (must end with /) */
+    prefix?: PrefixString;
+    /** Blob access token (defaults to BLOB_READ_WRITE_TOKEN) */
+    token?: string;
+    /** Byte threshold for large value separation (default: 1MB) */
+    largeValueThreshold?: number;
+    /** Cache TTL in seconds (default: 3600) */
+    cacheTtl?: number;
+    /** Blob store implementation (defaults to VercelBlobStore) */
+    blobStore?: BlobStore;
+    /** Cache implementation for testing (defaults to Vercel Runtime Cache) */
+    cache?: CacheLike;
+    /** Tracer for performance monitoring (defaults to no-op) */
+    tracer?: Tracer;
+}
+/** Tracer interface for pluggable tracing (OTEL compatible) */
+export interface Tracer {
+    startSpan(name: string, attributes?: Record<string, string | number | boolean>): Span;
+}
+/** Span interface for tracing */
+export interface Span {
+    setAttributes(attrs: Record<string, string | number | boolean>): void;
+    setError(error: Error): void;
+    end(): void;
+}
+/**
+ * Blob Storage Format (v1)
+ *
+ * Two formats based on whether payload exists:
+ *
+ * 1. Pure JSON (small values, no payload):
+ *    If first byte is '{' (0x7B), entire blob is JSON header.
+ *
+ *    {"metadata":{"v":1},"value":{"name":"Alice"},"encoding":"json"}
+ *    {"metadata":{"v":1},"value":"SGVsbG8=","encoding":"base64"}
+ *
+ * 2. Binary format (large values with payload after header):
+ *    [4 bytes: header length (uint32 BE)][header JSON][payload bytes]
+ *
+ *    00 00 00 28 {"metadata":{"v":1},"encoding":"raw-json"}{"name":"Alice",...}
+ *    00 00 00 2A {"metadata":{"v":1},"encoding":"raw-binary"}<raw bytes>
+ *
+ * Detection: check if buffer[0] === 0x7B ('{')
+ *   - Yes: pure JSON, parse entire buffer
+ *   - No: binary format, read 4-byte length prefix first
+ *
+ * Safety: Header size capped at 100MB ensures uint32 BE first byte < 0x7B,
+ * preventing ambiguity (0x7B000000 = ~2GB would be needed for conflict).
+ *
+ * Small values (< largeValueThreshold) use pure JSON with inlined "value".
+ * Large values use binary format with "raw-json" or "raw-binary" encoding.
+ */
+export type StoredEntryEncoding = "json" | "base64" | "raw-json" | "raw-binary";
+export interface StoredEntry<M> {
+    metadata: M;
+    /** Inline value for small entries (when encoding is "json" or "base64") */
+    value?: unknown;
+    /**
+     * Encoding type:
+     * - "json": inline JSON value
+     * - "base64": inline base64-encoded binary
+     * - "raw-json": raw JSON payload after header (large JSON values)
+     * - "raw-binary": raw binary payload after header (large binary values)
+     */
+    encoding: StoredEntryEncoding;
+    /** Timestamp of the write (for consistency checking) */
+    writeTime?: number;
+}
+export type PutBody = string | Readable | Buffer | Blob | ArrayBuffer | ReadableStream | File;
+export interface BlobStore {
+    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>;
+}
+export interface CachedEntry<M> {
+    metadata: M;
+    /** Value - binary data is stored as base64 string */
+    value: unknown;
+    size: number;
+    /** Whether the value is binary (stored as base64) */
+    isBinary?: boolean;
+    /** Timestamp of the write (for stream consistency checking) */
+    writeTime?: number;
+    /** Etag for optimistic locking */
+    etag?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,23 @@
+/**
+ * Error thrown when a conditional update fails due to version mismatch.
+ */
+export class KVVersionConflictError extends Error {
+    constructor(key) {
+        super(`Version conflict: "${key}" was modified by another process`);
+        this.name = "KVVersionConflictError";
+    }
+}
+/**
+ * Error thrown when a unique index constraint is violated.
+ */
+export class KVIndexConflictError extends Error {
+    indexName;
+    indexKey;
+    constructor(indexName, indexKey) {
+        super(`Unique index "${indexName}" conflict: key "${indexKey}" already exists`);
+        this.name = "KVIndexConflictError";
+        this.indexName = indexName;
+        this.indexKey = indexKey;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAgCA;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAChD,YAAY,GAAW;QACtB,KAAK,CAAC,sBAAsB,GAAG,mCAAmC,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACtC,CAAC;CACD;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC9C,SAAS,CAAS;IAClB,QAAQ,CAAS;IACjB,YAAY,SAAiB,EAAE,QAAgB;QAC9C,KAAK,CACJ,iBAAiB,SAAS,oBAAoB,QAAQ,kBAAkB,CACxE,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC1B,CAAC;CACD"}

package/dist/upstream-kv.d.ts

@@ -0,0 +1,84 @@
+import type { KV2 } from "./cached-kv.js";
+import type { ManifestLog } from "./manifest-log.js";
+import { TypedKV } from "./typed-kv.js";
+import type { EntriesIterable, KVEntry, KVGetResult, KVLike, KVSetResult, KeysIterable, SetOptions } from "./types.js";
+/**
+ * Wrapper that adds copy-on-write (CoW) behavior to KV2.
+ *
+ * - Reads check manifest to route to local or upstream (avoids unnecessary blob lookups)
+ * - Writes go to local only
+ * - Deletes create tombstones to prevent upstream fallthrough
+ * - keys() returns keys from the manifest (discovered + local)
+ */
+export declare class UpstreamKV<M = undefined> implements KVLike<M> {
+    private local;
+    private upstream;
+    private manifest;
+    constructor(local: KV2<M>, upstream: KV2<M>, manifest: ManifestLog);
+    /**
+     * Wrap an upstream entry to redirect update() calls through UpstreamKV.set().
+     * This ensures updates write to local storage, not upstream.
+     *
+     * Note: We don't use expectedVersion here because we're creating a new local
+     * shadow of the upstream entry, not updating an existing local entry.
+     */
+    private wrapUpstreamEntry;
+    /**
+     * Get a value. Uses manifest to route efficiently:
+     * - Keys marked "local" → check local only
+     * - Keys marked "upstream" → check upstream only (skip local blob lookup)
+     * - Keys marked "tombstone" → return not found
+     * - Unknown keys → check local, then upstream
+     */
+    get<V = unknown>(key: string): Promise<KVGetResult<V, M>>;
+    /**
+     * Set a value. Writes to local only.
+     */
+    set<V = unknown>(key: string, value: V | ReadableStream<Uint8Array>, ...[metadata, options]: undefined extends M ? [M?, SetOptions?] : [M, SetOptions?]): Promise<KVSetResult>;
+    /**
+     * Delete a key. Creates a tombstone to prevent upstream fallthrough.
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Iterate over keys. Returns merged keys from local, manifest, and upstream,
+     * excluding tombstones.
+     */
+    keys(prefix?: string): KeysIterable;
+    /**
+     * Fetch multiple keys concurrently with bounded concurrency.
+     * Returns a Map of key -> entry for all existing keys.
+     * Uses this.get() which handles local/upstream routing and tombstones.
+     *
+     * @param keys - Array of keys to fetch
+     * @param concurrency - Number of concurrent get operations (default: 20)
+     */
+    getMany<V = unknown>(keys: string[], concurrency?: number): Promise<Map<string, KVEntry<V, M>>>;
+    /**
+     * Iterate over key-value entries with concurrent fetching.
+     * Yields entries as soon as each fetch completes.
+     * Returns merged entries from local and upstream, excluding tombstones.
+     *
+     * @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>;
+    /**
+     * Discover all keys from upstream and add to manifest.
+     * Use when you need complete keys() immediately.
+     */
+    discoverAllKeys(): Promise<number>;
+    /**
+     * Delete all local data and manifest (for environment cleanup).
+     */
+    destroy(): Promise<void>;
+    /**
+     * Get the underlying local KV (for advanced use cases).
+     */
+    getLocalKV(): KV2<M>;
+    /**
+     * Get a typed sub-store with CoW behavior.
+     * Reads fall back to upstream, writes go to local.
+     */
+    getStore<V, SubM = M, I extends string = never>(subPrefix: string, indexes?: Record<I, import("./typed-kv.js").IndexDef<V>>): TypedKV<V, SubM, I>;
+}
+//# sourceMappingURL=upstream-kv.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upstream-kv.d.ts","sourceRoot":"","sources":["../src/upstream-kv.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EACX,eAAe,EAEf,OAAO,EACP,WAAW,EACX,MAAM,EACN,WAAW,EACX,YAAY,EAEZ,UAAU,EACV,MAAM,YAAY,CAAC;AAEpB;;;;;;;GAOG;AACH,qBAAa,UAAU,CAAC,CAAC,GAAG,SAAS,CAAE,YAAW,MAAM,CAAC,CAAC,CAAC;IAEzD,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,QAAQ;gBAFR,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,EACb,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,EAChB,QAAQ,EAAE,WAAW;IAG9B;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;;;;;OAMG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAkD/D;;OAEG;IACG,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;IAiBvB;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxC;;;OAGG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY;IA4InC;;;;;;;OAOG;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;IAwBtC;;;;;;;OAOG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,SAAK,GACd,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC;IAyExB;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IAexC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAU9B;;OAEG;IACH,UAAU,IAAI,GAAG,CAAC,CAAC,CAAC;IAIpB;;;OAGG;IACH,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"}