@vercel/kv2 0.0.1

package/dist/testing/vitest-compat.js.map

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

package/dist/tracing.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Pluggable tracing system for KV2.
+ *
+ * Provides a simple span-based API that can be backed by:
+ * - Console logging (default for debugging)
+ * - No-op (production default)
+ * - OpenTelemetry (plug in your own tracer)
+ */
+import type { Span, Tracer } from "./types.js";
+export type { Span, Tracer };
+export declare const noopTracer: Tracer;
+export declare const consoleTracer: Tracer;
+/**
+ * Create an OTEL-compatible tracer adapter.
+ *
+ * Usage with OpenTelemetry:
+ * ```ts
+ * import { trace } from '@opentelemetry/api';
+ *
+ * const otelTracer = createOtelTracer(trace.getTracer('kv2'));
+ * const kv = new KV2({ tracer: otelTracer });
+ * ```
+ */
+export interface OtelTracerLike {
+    startSpan(name: string, options?: {
+        attributes?: Record<string, unknown>;
+    }): OtelSpanLike;
+}
+export interface OtelSpanLike {
+    setAttribute(key: string, value: unknown): void;
+    setStatus(status: {
+        code: number;
+        message?: string;
+    }): void;
+    recordException(error: Error): void;
+    end(): void;
+}
+export declare function createOtelTracer(otelTracer: OtelTracerLike): Tracer;
+/**
+ * Statistics tracer for collecting timing data.
+ * Use in integration tests to measure real-world performance.
+ */
+export interface TimingStats {
+    count: number;
+    avg: number;
+    p50: number;
+    p95: number;
+    p99: number;
+    min: number;
+    max: number;
+}
+/**
+ * Create a stats tracer for collecting timing data.
+ *
+ * Usage:
+ * ```ts
+ * const { tracer, printStats, clear } = createStatsTracer();
+ * const kv = new KV2({ tracer });
+ *
+ * // ... run operations ...
+ *
+ * printStats(); // Print timing summary
+ * ```
+ */
+export declare function createStatsTracer(): {
+    tracer: Tracer;
+    printStats: () => void;
+    clear: () => void;
+    getStats: (operation?: string) => TimingStats | null;
+};
+//# sourceMappingURL=tracing.d.ts.map

package/dist/tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../src/tracing.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAE/C,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAa7B,eAAO,MAAM,UAAU,EAAE,MAIxB,CAAC;AA6CF,eAAO,MAAM,aAAa,EAAE,MAO3B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc;IAC9B,SAAS,CACR,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAChD,YAAY,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC5B,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAChD,SAAS,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5D,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpC,GAAG,IAAI,IAAI,CAAC;CACZ;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,CAuBnE;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACZ;AA+JD;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,IAAI;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,QAAQ,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,WAAW,GAAG,IAAI,CAAC;CACrD,CAgBA"}

package/dist/tracing.js

@@ -0,0 +1,232 @@
+/**
+ * Pluggable tracing system for KV2.
+ *
+ * Provides a simple span-based API that can be backed by:
+ * - Console logging (default for debugging)
+ * - No-op (production default)
+ * - OpenTelemetry (plug in your own tracer)
+ */
+/**
+ * No-op tracer for production (zero overhead).
+ */
+class NoopSpan {
+    setAttributes() { }
+    setError() { }
+    end() { }
+}
+const noopSpan = new NoopSpan();
+export const noopTracer = {
+    startSpan() {
+        return noopSpan;
+    },
+};
+/**
+ * Console logging tracer for debugging.
+ * Logs span start, attributes, errors, and duration.
+ */
+class ConsoleSpan {
+    name;
+    startTime;
+    attrs;
+    error;
+    constructor(name, attributes) {
+        this.name = name;
+        this.startTime = performance.now();
+        this.attrs = attributes ?? {};
+    }
+    setAttributes(attrs) {
+        Object.assign(this.attrs, attrs);
+    }
+    setError(error) {
+        this.error = error;
+    }
+    end() {
+        const duration = performance.now() - this.startTime;
+        const attrs = Object.entries(this.attrs)
+            .map(([k, v]) => `${k}=${v}`)
+            .join(" ");
+        if (this.error) {
+            console.log(`[KV] ${this.name} FAILED ${duration.toFixed(1)}ms ${attrs} error=${this.error.message}`);
+        }
+        else {
+            console.log(`[KV] ${this.name} ${duration.toFixed(1)}ms ${attrs}`);
+        }
+    }
+}
+export const consoleTracer = {
+    startSpan(name, attributes) {
+        return new ConsoleSpan(name, attributes);
+    },
+};
+export function createOtelTracer(otelTracer) {
+    return {
+        startSpan(name, attributes) {
+            const span = otelTracer.startSpan(name, { attributes });
+            return {
+                setAttributes(attrs) {
+                    for (const [key, value] of Object.entries(attrs)) {
+                        span.setAttribute(key, value);
+                    }
+                },
+                setError(error) {
+                    span.setStatus({ code: 2, message: error.message }); // OTEL SpanStatusCode.ERROR = 2
+                    span.recordException(error);
+                },
+                end() {
+                    span.end();
+                },
+            };
+        },
+    };
+}
+class StatsSpan {
+    name;
+    startTime;
+    attrs;
+    error;
+    collector;
+    constructor(name, collector, attributes) {
+        this.name = name;
+        this.startTime = performance.now();
+        this.attrs = attributes ?? {};
+        this.collector = collector;
+    }
+    setAttributes(attrs) {
+        Object.assign(this.attrs, attrs);
+    }
+    setError(error) {
+        this.error = error;
+    }
+    end() {
+        const durationMs = performance.now() - this.startTime;
+        this.collector.record({
+            name: this.name,
+            durationMs,
+            attributes: this.attrs,
+            error: this.error?.message,
+        });
+    }
+}
+class StatsCollector {
+    entries = [];
+    record(entry) {
+        this.entries.push(entry);
+    }
+    clear() {
+        this.entries = [];
+    }
+    /** Get unique operation keys (name + source) */
+    getOperationKeys() {
+        const keys = new Set();
+        for (const e of this.entries) {
+            const source = e.attributes.source;
+            const key = source ? `${e.name}:${source}` : e.name;
+            keys.add(key);
+        }
+        return [...keys].sort();
+    }
+    getStats(operationKey) {
+        let filtered;
+        if (operationKey) {
+            const [name, source] = operationKey.includes(":")
+                ? operationKey.split(":")
+                : [operationKey, undefined];
+            filtered = this.entries.filter((e) => {
+                if (e.name !== name)
+                    return false;
+                if (source && e.attributes.source !== source)
+                    return false;
+                return true;
+            });
+        }
+        else {
+            filtered = this.entries;
+        }
+        if (filtered.length === 0)
+            return null;
+        const durations = filtered.map((e) => e.durationMs).sort((a, b) => a - b);
+        const sum = durations.reduce((a, b) => a + b, 0);
+        return {
+            count: durations.length,
+            avg: Math.round((sum / durations.length) * 100) / 100,
+            p50: this.percentile(durations, 50),
+            p95: this.percentile(durations, 95),
+            p99: this.percentile(durations, 99),
+            min: Math.round(durations[0] * 100) / 100,
+            max: Math.round(durations[durations.length - 1] * 100) / 100,
+        };
+    }
+    percentile(sorted, p) {
+        const index = Math.ceil((p / 100) * sorted.length) - 1;
+        return Math.round(sorted[Math.max(0, index)] * 100) / 100;
+    }
+    printSummary() {
+        const keys = this.getOperationKeys();
+        if (keys.length === 0) {
+            return;
+        }
+        console.log("\n=== Timing Statistics ===\n");
+        console.log("Operation".padEnd(25) +
+            "Count".padStart(8) +
+            "Avg".padStart(10) +
+            "p50".padStart(10) +
+            "p95".padStart(10) +
+            "p99".padStart(10) +
+            "Min".padStart(10) +
+            "Max".padStart(10));
+        console.log("-".repeat(93));
+        for (const key of keys) {
+            const stats = this.getStats(key);
+            if (!stats)
+                continue;
+            console.log(key.padEnd(25) +
+                String(stats.count).padStart(8) +
+                `${stats.avg}ms`.padStart(10) +
+                `${stats.p50}ms`.padStart(10) +
+                `${stats.p95}ms`.padStart(10) +
+                `${stats.p99}ms`.padStart(10) +
+                `${stats.min}ms`.padStart(10) +
+                `${stats.max}ms`.padStart(10));
+        }
+        const overall = this.getStats();
+        if (overall) {
+            console.log("-".repeat(93));
+            console.log("TOTAL".padEnd(25) +
+                String(overall.count).padStart(8) +
+                `${overall.avg}ms`.padStart(10) +
+                `${overall.p50}ms`.padStart(10) +
+                `${overall.p95}ms`.padStart(10) +
+                `${overall.p99}ms`.padStart(10) +
+                `${overall.min}ms`.padStart(10) +
+                `${overall.max}ms`.padStart(10));
+        }
+        console.log();
+    }
+}
+/**
+ * Create a stats tracer for collecting timing data.
+ *
+ * Usage:
+ * ```ts
+ * const { tracer, printStats, clear } = createStatsTracer();
+ * const kv = new KV2({ tracer });
+ *
+ * // ... run operations ...
+ *
+ * printStats(); // Print timing summary
+ * ```
+ */
+export function createStatsTracer() {
+    const collector = new StatsCollector();
+    return {
+        tracer: {
+            startSpan(name, attributes) {
+                return new StatsSpan(name, collector, attributes);
+            },
+        },
+        printStats: () => collector.printSummary(),
+        clear: () => collector.clear(),
+        getStats: (op) => collector.getStats(op),
+    };
+}
+//# sourceMappingURL=tracing.js.map

package/dist/tracing.js.map

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

package/dist/typed-kv.d.ts

@@ -0,0 +1,120 @@
+import type { EntriesIterable, KVEntry, KVGetResult, KVLike, KVSetResult, KeysIterable, SetOptions } from "./types.js";
+export interface IndexDef<V> {
+    /** Extract index key(s) from value. Return string for single-value, string[] for multi-value. */
+    key: (value: V, primaryKey: string) => string | string[];
+    /** Unique constraint. Default: false */
+    unique?: boolean;
+}
+/**
+ * When I = never (no indexes), resolves to never — so `string | never` = `string`.
+ * When I has values, resolves to a record of optional index keys.
+ */
+export type IndexQuery<I extends string> = [I] extends [never] ? never : {
+    [K in I]?: string;
+};
+/**
+ * A typed sub-store that wraps any KVLike (KV2 or UpstreamKV) with a prefix.
+ *
+ * TypedKV implements KVLike, so it can be nested via getStore() to create
+ * hierarchical key structures.
+ *
+ * Optionally supports secondary indexes: pass an `indexes` record to
+ * `getStore()` or the constructor to auto-maintain index entries on set/delete.
+ *
+ * @typeParam V - Value type
+ * @typeParam M - Metadata type (undefined = no metadata)
+ * @typeParam I - Union of index names (never = no indexes)
+ *
+ * @example
+ * ```ts
+ * const kv = createKV({ prefix: "app/" });
+ *
+ * // Sub-store with indexes
+ * const usersKV = kv.getStore<User>("users/", {
+ *   byEmail: { key: (u) => u.email, unique: true },
+ *   byRole:  { key: (u) => u.role },
+ * });
+ *
+ * await usersKV.set("alice", { email: "a@b.com", role: "admin" });
+ * const user = await usersKV.get({ byEmail: "a@b.com" });
+ * for await (const key of usersKV.keys({ byRole: "admin" })) { ... }
+ * ```
+ */
+export declare class TypedKV<V, M = undefined, I extends string = never> implements KVLike<M> {
+    private parent;
+    private prefix;
+    private indexes?;
+    private indexStores?;
+    constructor(parent: KVLike<M>, prefix: string, indexes?: Record<string, IndexDef<V>>);
+    private prefixKey;
+    /**
+     * Get by primary key or by unique index.
+     *
+     * @example
+     * ```ts
+     * // By primary key
+     * const result = await store.get("page/123");
+     *
+     * // By unique index
+     * const result = await store.get({ bySlug: "hello-world" });
+     * ```
+     */
+    get<T = V>(keyOrFilter: string | IndexQuery<I>): Promise<KVGetResult<T, M>>;
+    set<T = V>(key: string, value: T | ReadableStream<Uint8Array>, ...[metadata, options]: undefined extends M ? [M?, SetOptions?] : [M, SetOptions?]): Promise<KVSetResult>;
+    delete(key: string): Promise<void>;
+    /**
+     * List keys by prefix or by index.
+     *
+     * @example
+     * ```ts
+     * // All keys
+     * for await (const key of store.keys()) { ... }
+     *
+     * // By prefix
+     * for await (const key of store.keys("page/")) { ... }
+     *
+     * // By index
+     * for await (const key of store.keys({ byStatus: "draft" })) { ... }
+     * ```
+     */
+    keys(filter?: string | IndexQuery<I>): KeysIterable;
+    /**
+     * List entries by prefix or by index.
+     *
+     * @example
+     * ```ts
+     * // All entries
+     * for await (const [key, entry] of store.entries()) { ... }
+     *
+     * // By index
+     * const { entries } = await store.entries({ byStatus: "draft" }).page(20);
+     * ```
+     */
+    entries<T = V>(filter?: string | IndexQuery<I>): EntriesIterable<T, M>;
+    getMany<T = V>(keys: string[], concurrency?: number): Promise<Map<string, KVEntry<T, M>>>;
+    /**
+     * List only direct children (keys without "/" after the optional prefix).
+     */
+    keysShallow(prefix?: string): AsyncIterable<string>;
+    /**
+     * Create a nested sub-store with an accumulated prefix.
+     * Pass `indexes` to enable secondary index maintenance.
+     */
+    getStore<ChildV, ChildM = M, ChildI extends string = never>(subPrefix: string, indexes?: Record<ChildI, IndexDef<ChildV>>): TypedKV<ChildV, ChildM, ChildI>;
+    /**
+     * Rebuild index entries by scanning all data. Idempotent.
+     * Use after adding a new index to an existing store.
+     *
+     * @param indexName - Specific index to rebuild, or omit for all indexes.
+     * @returns Number of entries indexed.
+     */
+    reindex(indexName?: I extends never ? never : I): Promise<{
+        indexed: number;
+    }>;
+    private keysByPrefix;
+    private entriesByPrefix;
+    private getByIndex;
+    private keysByIndex;
+    private entriesByIndex;
+}
+//# sourceMappingURL=typed-kv.d.ts.map

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

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