@vercel/kv2 0.0.1

package/dist/testing/fake-blob-store.js

@@ -0,0 +1,158 @@
+import { BlobPreconditionFailedError, } from "@vercel/blob";
+let etagCounter = 0;
+function generateEtag() {
+    return `"fake-etag-${++etagCounter}-${Date.now()}"`;
+}
+async function toBuffer(body) {
+    if (typeof body === "string") {
+        return Buffer.from(body, "utf-8");
+    }
+    if (body instanceof Buffer) {
+        return body;
+    }
+    if (body instanceof Blob) {
+        const arrayBuffer = await body.arrayBuffer();
+        return Buffer.from(arrayBuffer);
+    }
+    if (body instanceof ArrayBuffer) {
+        return Buffer.from(body);
+    }
+    if (ArrayBuffer.isView(body)) {
+        return Buffer.from(body.buffer, body.byteOffset, body.byteLength);
+    }
+    if (body instanceof ReadableStream) {
+        const chunks = [];
+        const reader = body.getReader();
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            chunks.push(value);
+        }
+        return Buffer.concat(chunks);
+    }
+    throw new Error("Unsupported body type");
+}
+export class FakeBlobStore {
+    blobs = new Map();
+    async get(pathname, _options) {
+        const blob = this.blobs.get(pathname);
+        if (!blob) {
+            return null;
+        }
+        const content = blob.content;
+        const stream = new ReadableStream({
+            start(controller) {
+                controller.enqueue(new Uint8Array(content));
+                controller.close();
+            },
+        });
+        return {
+            stream,
+            blob: {
+                url: `fake://${pathname}`,
+                downloadUrl: `fake://${pathname}?download=1`,
+                pathname,
+                contentType: blob.contentType,
+                contentDisposition: `attachment; filename="${pathname.split("/").pop()}"`,
+                cacheControl: "public, max-age=31536000, immutable",
+                size: blob.size,
+                uploadedAt: blob.uploadedAt,
+                etag: blob.etag,
+            },
+            headers: new Headers({
+                "content-type": blob.contentType,
+                "content-length": String(blob.size),
+                etag: blob.etag,
+            }),
+        };
+    }
+    async put(pathname, body, options) {
+        const existingBlob = this.blobs.get(pathname);
+        // Check allowOverwrite option (default: true based on @vercel/blob behavior)
+        const allowOverwrite = options.allowOverwrite ?? true;
+        if (!allowOverwrite && existingBlob) {
+            throw new BlobPreconditionFailedError();
+        }
+        // Check ifMatch (optimistic locking)
+        if (options.ifMatch !== undefined) {
+            if (!existingBlob) {
+                // Real @vercel/blob throws "The specified key does not exist"
+                throw new BlobPreconditionFailedError();
+            }
+            if (existingBlob.etag !== options.ifMatch) {
+                throw new BlobPreconditionFailedError();
+            }
+        }
+        const content = await toBuffer(body);
+        const etag = generateEtag();
+        this.blobs.set(pathname, {
+            pathname,
+            content,
+            contentType: options.contentType ?? "application/octet-stream",
+            uploadedAt: new Date(),
+            size: content.length,
+            etag,
+        });
+        return {
+            url: `fake://${pathname}`,
+            downloadUrl: `fake://${pathname}?download=1`,
+            pathname,
+            contentType: options.contentType ?? "application/octet-stream",
+            contentDisposition: `attachment; filename="${pathname.split("/").pop()}"`,
+            etag,
+        };
+    }
+    async del(urlOrPathname) {
+        const paths = Array.isArray(urlOrPathname)
+            ? urlOrPathname
+            : [urlOrPathname];
+        for (const p of paths) {
+            // Handle both URLs and pathnames
+            const pathname = p.startsWith("fake://") ? p.slice(7) : p;
+            this.blobs.delete(pathname);
+        }
+    }
+    async list(options) {
+        let entries = [...this.blobs.values()];
+        // Filter by prefix
+        if (options?.prefix) {
+            entries = entries.filter((b) => b.pathname.startsWith(options.prefix));
+        }
+        // Sort by pathname for consistent ordering
+        entries.sort((a, b) => a.pathname.localeCompare(b.pathname));
+        // Handle pagination
+        const limit = options?.limit ?? 1000;
+        const cursorIndex = options?.cursor
+            ? Number.parseInt(options.cursor, 10)
+            : 0;
+        const slice = entries.slice(cursorIndex, cursorIndex + limit);
+        const hasMore = cursorIndex + limit < entries.length;
+        return {
+            blobs: slice.map((b) => ({
+                url: `fake://${b.pathname}`,
+                downloadUrl: `fake://${b.pathname}?download=1`,
+                pathname: b.pathname,
+                size: b.size,
+                uploadedAt: b.uploadedAt,
+                etag: b.etag,
+            })),
+            hasMore,
+            cursor: hasMore ? String(cursorIndex + limit) : undefined,
+        };
+    }
+    // Test helpers
+    clear() {
+        this.blobs.clear();
+    }
+    has(pathname) {
+        return this.blobs.has(pathname);
+    }
+    getContent(pathname) {
+        return this.blobs.get(pathname)?.content;
+    }
+    getAll() {
+        return new Map(this.blobs);
+    }
+}
+//# sourceMappingURL=fake-blob-store.js.map

package/dist/testing/fake-blob-store.js.map

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

package/dist/testing/fake-cache.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Fake cache implementation for testing KVCache without @vercel/functions.
+ * Supports programmatic control over success/failure and inspection of calls.
+ */
+import type { CacheLike } from "../types.js";
+export interface CacheCall {
+    method: "get" | "set" | "expireTag";
+    args: unknown[];
+    timestamp: number;
+}
+export declare class FakeCache implements CacheLike {
+    private data;
+    private tags;
+    private calls;
+    private getError;
+    private setError;
+    private expireTagError;
+    private getErrorOnce;
+    private setErrorOnce;
+    private expireTagErrorOnce;
+    get(key: string): Promise<unknown>;
+    set(key: string, value: unknown, options?: {
+        tags?: string[];
+        ttl?: number;
+    }): Promise<void>;
+    expireTag(tag: string): Promise<void>;
+    /** Set a value directly (bypassing set() tracking) */
+    inject(key: string, value: unknown): void;
+    /** Clear all data and call history */
+    clear(): void;
+    /** Get all recorded calls */
+    getCalls(): CacheCall[];
+    /** Get calls for a specific method */
+    getCallsFor(method: "get" | "set" | "expireTag"): CacheCall[];
+    /** Clear call history only */
+    clearCalls(): void;
+    /** Make get() always throw */
+    failGet(error: Error): void;
+    /** Make set() always throw */
+    failSet(error: Error): void;
+    /** Make expireTag() always throw */
+    failExpireTag(error: Error): void;
+    /** Make get() throw once, then succeed */
+    failGetOnce(error: Error): void;
+    /** Make set() throw once, then succeed */
+    failSetOnce(error: Error): void;
+    /** Make expireTag() throw once, then succeed */
+    failExpireTagOnce(error: Error): void;
+    /** Check if a key exists */
+    has(key: string): boolean;
+    /** Get raw data (for inspection) */
+    getData(key: string): unknown;
+}
+//# sourceMappingURL=fake-cache.d.ts.map

package/dist/testing/fake-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-cache.d.ts","sourceRoot":"","sources":["../../src/testing/fake-cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,SAAS;IACzB,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,WAAW,CAAC;IACpC,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,SAAU,YAAW,SAAS;IAC1C,OAAO,CAAC,IAAI,CAA8B;IAC1C,OAAO,CAAC,IAAI,CAAkC;IAC9C,OAAO,CAAC,KAAK,CAAmB;IAGhC,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,kBAAkB,CAAe;IAEnC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAelC,GAAG,CACR,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GACzC,OAAO,CAAC,IAAI,CAAC;IA6BV,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B3C,sDAAsD;IACtD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAIzC,sCAAsC;IACtC,KAAK,IAAI,IAAI;IAYb,6BAA6B;IAC7B,QAAQ,IAAI,SAAS,EAAE;IAIvB,sCAAsC;IACtC,WAAW,CAAC,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,WAAW,GAAG,SAAS,EAAE;IAI7D,8BAA8B;IAC9B,UAAU,IAAI,IAAI;IAIlB,8BAA8B;IAC9B,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAI3B,8BAA8B;IAC9B,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAI3B,oCAAoC;IACpC,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAIjC,0CAA0C;IAC1C,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAI/B,0CAA0C;IAC1C,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAI/B,gDAAgD;IAChD,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAIrC,4BAA4B;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,oCAAoC;IACpC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAG7B"}

package/dist/testing/fake-cache.js

@@ -0,0 +1,137 @@
+/**
+ * Fake cache implementation for testing KVCache without @vercel/functions.
+ * Supports programmatic control over success/failure and inspection of calls.
+ */
+export class FakeCache {
+    data = new Map();
+    tags = new Map(); // tag -> keys
+    calls = [];
+    // Control behavior
+    getError = null;
+    setError = null;
+    expireTagError = null;
+    getErrorOnce = [];
+    setErrorOnce = [];
+    expireTagErrorOnce = [];
+    async get(key) {
+        this.calls.push({ method: "get", args: [key], timestamp: Date.now() });
+        if (this.getErrorOnce.length > 0) {
+            const error = this.getErrorOnce[0];
+            this.getErrorOnce.shift();
+            throw error;
+        }
+        if (this.getError) {
+            throw this.getError;
+        }
+        return this.data.get(key) ?? null;
+    }
+    async set(key, value, options) {
+        this.calls.push({
+            method: "set",
+            args: [key, value, options],
+            timestamp: Date.now(),
+        });
+        if (this.setErrorOnce.length > 0) {
+            const error = this.setErrorOnce[0];
+            this.setErrorOnce.shift();
+            throw error;
+        }
+        if (this.setError) {
+            throw this.setError;
+        }
+        this.data.set(key, value);
+        // Track tags
+        if (options?.tags) {
+            for (const tag of options.tags) {
+                if (!this.tags.has(tag)) {
+                    this.tags.set(tag, new Set());
+                }
+                this.tags.get(tag)?.add(key);
+            }
+        }
+    }
+    async expireTag(tag) {
+        this.calls.push({
+            method: "expireTag",
+            args: [tag],
+            timestamp: Date.now(),
+        });
+        if (this.expireTagErrorOnce.length > 0) {
+            const error = this.expireTagErrorOnce[0];
+            this.expireTagErrorOnce.shift();
+            throw error;
+        }
+        if (this.expireTagError) {
+            throw this.expireTagError;
+        }
+        const keys = this.tags.get(tag);
+        if (keys) {
+            for (const key of keys) {
+                this.data.delete(key);
+            }
+            this.tags.delete(tag);
+        }
+    }
+    // Test helpers
+    /** Set a value directly (bypassing set() tracking) */
+    inject(key, value) {
+        this.data.set(key, value);
+    }
+    /** Clear all data and call history */
+    clear() {
+        this.data.clear();
+        this.tags.clear();
+        this.calls = [];
+        this.getError = null;
+        this.setError = null;
+        this.expireTagError = null;
+        this.getErrorOnce = [];
+        this.setErrorOnce = [];
+        this.expireTagErrorOnce = [];
+    }
+    /** Get all recorded calls */
+    getCalls() {
+        return [...this.calls];
+    }
+    /** Get calls for a specific method */
+    getCallsFor(method) {
+        return this.calls.filter((c) => c.method === method);
+    }
+    /** Clear call history only */
+    clearCalls() {
+        this.calls = [];
+    }
+    /** Make get() always throw */
+    failGet(error) {
+        this.getError = error;
+    }
+    /** Make set() always throw */
+    failSet(error) {
+        this.setError = error;
+    }
+    /** Make expireTag() always throw */
+    failExpireTag(error) {
+        this.expireTagError = error;
+    }
+    /** Make get() throw once, then succeed */
+    failGetOnce(error) {
+        this.getErrorOnce.push(error);
+    }
+    /** Make set() throw once, then succeed */
+    failSetOnce(error) {
+        this.setErrorOnce.push(error);
+    }
+    /** Make expireTag() throw once, then succeed */
+    failExpireTagOnce(error) {
+        this.expireTagErrorOnce.push(error);
+    }
+    /** Check if a key exists */
+    has(key) {
+        return this.data.has(key);
+    }
+    /** Get raw data (for inspection) */
+    getData(key) {
+        return this.data.get(key);
+    }
+}
+//# sourceMappingURL=fake-cache.js.map

package/dist/testing/fake-cache.js.map

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

package/dist/testing/index.d.ts

@@ -0,0 +1,34 @@
+import { KV2 } from "../cached-kv.js";
+import type { BlobStore, KV2Options, PrefixString, Tracer } from "../types.js";
+export { FakeBlobStore } from "./fake-blob-store.js";
+export { FakeCache } from "./fake-cache.js";
+export { runTests, resetTestState, getRegisteredTests, type TestResult, type RunResult, type RunTestsOptions, } from "./vitest-compat.js";
+/** Get the shared stats tracer for integration tests */
+export declare function getStatsTracer(): Tracer;
+/** Print timing statistics summary */
+export declare function printTimingStats(): void;
+/** Clear timing statistics */
+export declare function clearTimingStats(): void;
+/** Get timing statistics for a specific operation or overall */
+export declare function getTimingStats(operation?: string): import("../tracing.js").TimingStats | null;
+/** Whether to use real blob store (set INTEGRATION_TEST=1) */
+export declare function useRealBlobStore(): boolean;
+/**
+ * Validate environment for integration tests.
+ * Throws if required env vars are missing.
+ */
+export declare function validateIntegrationTestEnv(): void;
+export interface TestKVResult<M> {
+    kv: KV2<M>;
+    blobStore: BlobStore;
+    isReal: boolean;
+    cleanup: () => Promise<void>;
+}
+/**
+ * Creates a KV2 for testing.
+ * Uses fake blob store by default, or real blob store if INTEGRATION_TEST=1.
+ */
+export declare function createTestKV<M = Record<string, unknown>>(options?: Partial<KV2Options>): TestKVResult<M>;
+export declare function uniqueTestPrefix(): PrefixString;
+export declare function cleanupTestBlobs(prefix: string, blobStore?: BlobStore): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAEtC,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG/E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EACN,QAAQ,EACR,cAAc,EACd,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,eAAe,GACpB,MAAM,oBAAoB,CAAC;AAK5B,wDAAwD;AACxD,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,sCAAsC;AACtC,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED,8BAA8B;AAC9B,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,8CAEhD;AAED,8DAA8D;AAC9D,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAoBjD;AACD,MAAM,WAAW,YAAY,CAAC,CAAC;IAC9B,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACX,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvD,OAAO,GAAE,OAAO,CAAC,UAAU,CAAM,GAC/B,YAAY,CAAC,CAAC,CAAC,CAgCjB;AAED,wBAAgB,gBAAgB,IAAI,YAAY,CAI/C;AAED,wBAAsB,gBAAgB,CACrC,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,SAAS,GACnB,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/testing/index.js

@@ -0,0 +1,101 @@
+import { VercelBlobStore } from "../blob-store.js";
+import { KV2 } from "../cached-kv.js";
+import { createStatsTracer } from "../tracing.js";
+import { FakeBlobStore } from "./fake-blob-store.js";
+export { FakeBlobStore } from "./fake-blob-store.js";
+export { FakeCache } from "./fake-cache.js";
+// Test runner exports
+export { runTests, resetTestState, getRegisteredTests, } from "./vitest-compat.js";
+// Shared stats tracer for integration tests
+const statsTracer = createStatsTracer();
+/** Get the shared stats tracer for integration tests */
+export function getStatsTracer() {
+    return statsTracer.tracer;
+}
+/** Print timing statistics summary */
+export function printTimingStats() {
+    statsTracer.printStats();
+}
+/** Clear timing statistics */
+export function clearTimingStats() {
+    statsTracer.clear();
+}
+/** Get timing statistics for a specific operation or overall */
+export function getTimingStats(operation) {
+    return statsTracer.getStats(operation);
+}
+/** Whether to use real blob store (set INTEGRATION_TEST=1) */
+export function useRealBlobStore() {
+    return process.env.INTEGRATION_TEST === "1";
+}
+/**
+ * Validate environment for integration tests.
+ * Throws if required env vars are missing.
+ */
+export function validateIntegrationTestEnv() {
+    if (process.env.INTEGRATION_TEST !== "1") {
+        return; // Not running integration tests, no validation needed
+    }
+    const missing = [];
+    if (!process.env.BLOB_READ_WRITE_TOKEN) {
+        missing.push("BLOB_READ_WRITE_TOKEN");
+    }
+    if (!process.env.PROTECTION_BYPASS) {
+        missing.push("PROTECTION_BYPASS");
+    }
+    if (missing.length > 0) {
+        throw new Error(`Integration tests require these environment variables: ${missing.join(", ")}\nSet them in .env.local or export them before running tests.`);
+    }
+}
+/**
+ * Creates a KV2 for testing.
+ * Uses fake blob store by default, or real blob store if INTEGRATION_TEST=1.
+ */
+export function createTestKV(options = {}) {
+    const prefix = options.prefix ?? uniqueTestPrefix();
+    if (useRealBlobStore()) {
+        // Env validation happens at test startup via validateIntegrationTestEnv()
+        const blobStore = new VercelBlobStore();
+        const kv = new KV2({
+            ...options,
+            prefix,
+            blobStore,
+            tracer: statsTracer.tracer,
+        });
+        return {
+            kv,
+            blobStore,
+            isReal: true,
+            cleanup: () => cleanupTestBlobs(prefix, blobStore),
+        };
+    }
+    const blobStore = new FakeBlobStore();
+    const kv = new KV2({
+        ...options,
+        prefix,
+        blobStore,
+    });
+    return {
+        kv,
+        blobStore,
+        isReal: false,
+        cleanup: async () => blobStore.clear(),
+    };
+}
+export function uniqueTestPrefix() {
+    const timestamp = Date.now();
+    const random = Math.random().toString(36).slice(2, 8);
+    return `test-${timestamp}-${random}/`;
+}
+export async function cleanupTestBlobs(prefix, blobStore) {
+    const store = blobStore ?? new VercelBlobStore();
+    let cursor;
+    do {
+        const result = await store.list({ prefix: `cached-kv/${prefix}`, cursor });
+        if (result.blobs.length > 0) {
+            await store.del(result.blobs.map((b) => b.pathname));
+        }
+        cursor = result.cursor;
+    } while (cursor);
+}
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

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

package/dist/testing/manifest-test-setup.d.ts

@@ -0,0 +1,22 @@
+import { ManifestLog } from "../manifest-log.js";
+import type { BlobStore } from "../types.js";
+import { type TestContext as BaseTestContext } from "./vitest-compat.js";
+/** Context available to each ManifestLog test */
+export interface ManifestTestContext extends BaseTestContext {
+    blobStore: BlobStore;
+    manifest: ManifestLog;
+    manifestPrefix: string;
+    cleanup?: () => Promise<void>;
+}
+/**
+ * Sets up a ManifestLog test context.
+ * Each test gets its own isolated FakeBlobStore and ManifestLog.
+ * Uses real blob store if INTEGRATION_TEST=1.
+ */
+export declare function setupManifestTestContext(): void;
+/** Typed test function that receives ManifestTestContext */
+type TypedTestFn = (ctx: ManifestTestContext) => Promise<void> | void;
+/** Typed `it` that provides ManifestTestContext to tests */
+export declare const it: (name: string, fn: TypedTestFn) => void;
+export {};
+//# sourceMappingURL=manifest-test-setup.d.ts.map

package/dist/testing/manifest-test-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-test-setup.d.ts","sourceRoot":"","sources":["../../src/testing/manifest-test-setup.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,aAAa,CAAC;AASxD,OAAO,EACN,KAAK,WAAW,IAAI,eAAe,EAInC,MAAM,oBAAoB,CAAC;AAE5B,iDAAiD;AACjD,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC3D,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,WAAW,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAkC/C;AAED,4DAA4D;AAC5D,KAAK,WAAW,GAAG,CAAC,GAAG,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEtE,4DAA4D;AAC5D,eAAO,MAAM,EAAE,GAAI,MAAM,MAAM,EAAE,IAAI,WAAW,KAAG,IAElD,CAAC"}

package/dist/testing/manifest-test-setup.js

@@ -0,0 +1,43 @@
+import { VercelBlobStore } from "../blob-store.js";
+import { ManifestLog } from "../manifest-log.js";
+import { FakeBlobStore } from "./fake-blob-store.js";
+import { FakeCache } from "./fake-cache.js";
+import { cleanupTestBlobs, uniqueTestPrefix, useRealBlobStore, } from "./index.js";
+import { afterEach, it as baseIt, beforeEach, } from "./vitest-compat.js";
+/**
+ * Sets up a ManifestLog test context.
+ * Each test gets its own isolated FakeBlobStore and ManifestLog.
+ * Uses real blob store if INTEGRATION_TEST=1.
+ */
+export function setupManifestTestContext() {
+    beforeEach((ctx) => {
+        const testCtx = ctx;
+        if (useRealBlobStore()) {
+            // Integration test: use real blob store with unique prefix
+            const prefix = uniqueTestPrefix();
+            testCtx.blobStore = new VercelBlobStore();
+            testCtx.manifestPrefix = `${prefix}_manifest/`;
+            // No FakeCache in integration - uses real Vercel cache via proxy
+            testCtx.manifest = new ManifestLog(testCtx.blobStore, testCtx.manifestPrefix);
+            testCtx.cleanup = () => cleanupTestBlobs(prefix, testCtx.blobStore);
+        }
+        else {
+            // Unit test: use fakes
+            testCtx.blobStore = new FakeBlobStore();
+            testCtx.manifestPrefix = "test/_manifest/";
+            const cache = new FakeCache();
+            testCtx.manifest = new ManifestLog(testCtx.blobStore, testCtx.manifestPrefix, cache);
+        }
+    });
+    afterEach(async (ctx) => {
+        const testCtx = ctx;
+        if (testCtx.cleanup) {
+            await testCtx.cleanup();
+        }
+    });
+}
+/** Typed `it` that provides ManifestTestContext to tests */
+export const it = (name, fn) => {
+    baseIt(name, fn);
+};
+//# sourceMappingURL=manifest-test-setup.js.map

package/dist/testing/manifest-test-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-test-setup.js","sourceRoot":"","sources":["../../src/testing/manifest-test-setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EACN,gBAAgB,EAEhB,gBAAgB,EAChB,gBAAgB,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAEN,SAAS,EACT,EAAE,IAAI,MAAM,EACZ,UAAU,GACV,MAAM,oBAAoB,CAAC;AAU5B;;;;GAIG;AACH,MAAM,UAAU,wBAAwB;IACvC,UAAU,CAAC,CAAC,GAAG,EAAE,EAAE;QAClB,MAAM,OAAO,GAAG,GAA0B,CAAC;QAE3C,IAAI,gBAAgB,EAAE,EAAE,CAAC;YACxB,2DAA2D;YAC3D,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;YAClC,OAAO,CAAC,SAAS,GAAG,IAAI,eAAe,EAAE,CAAC;YAC1C,OAAO,CAAC,cAAc,GAAG,GAAG,MAAM,YAAY,CAAC;YAC/C,iEAAiE;YACjE,OAAO,CAAC,QAAQ,GAAG,IAAI,WAAW,CACjC,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,cAAc,CACtB,CAAC;YACF,OAAO,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACrE,CAAC;aAAM,CAAC;YACP,uBAAuB;YACvB,OAAO,CAAC,SAAS,GAAG,IAAI,aAAa,EAAE,CAAC;YACxC,OAAO,CAAC,cAAc,GAAG,iBAAiB,CAAC;YAC3C,MAAM,KAAK,GAAG,IAAI,SAAS,EAAE,CAAC;YAC9B,OAAO,CAAC,QAAQ,GAAG,IAAI,WAAW,CACjC,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,cAAc,EACtB,KAAK,CACL,CAAC;QACH,CAAC;IACF,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACvB,MAAM,OAAO,GAAG,GAA0B,CAAC;QAC3C,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACrB,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QACzB,CAAC;IACF,CAAC,CAAC,CAAC;AACJ,CAAC;AAKD,4DAA4D;AAC5D,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAY,EAAE,EAAe,EAAQ,EAAE;IACzD,MAAM,CAAC,IAAI,EAAE,EAAoD,CAAC,CAAC;AACpE,CAAC,CAAC"}

package/dist/testing/perf-test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Performance comparison test: raw blob access vs cached reads
+ */
+export interface PerfResult {
+    rawBlobReads: number[];
+    cachedReads: number[];
+    rawBlobAvg: number;
+    cachedAvg: number;
+    speedup: number;
+    summary: string;
+}
+export declare function runPerfTest(iterations?: number): Promise<PerfResult>;
+//# sourceMappingURL=perf-test.d.ts.map

package/dist/testing/perf-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"perf-test.d.ts","sourceRoot":"","sources":["../../src/testing/perf-test.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,WAAW,UAAU;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CAChB;AAmBD,wBAAsB,WAAW,CAAC,UAAU,SAAK,GAAG,OAAO,CAAC,UAAU,CAAC,CAwFtE"}