@vercel/kv2 0.0.1

package/dist/disk-cache.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export { KV2 } from "./cached-kv.js";
+export { TypedKV } from "./typed-kv.js";
+export { VercelBlobStore } from "./blob-store.js";
+export { KVVersionConflictError, KVIndexConflictError } from "./types.js";
+export { createKV } from "./create-kv.js";
+export { UpstreamKV } from "./upstream-kv.js";
+export { ManifestLog } from "./manifest-log.js";
+export { noopTracer, consoleTracer, createOtelTracer, createStatsTracer, } from "./tracing.js";
+export type { OtelTracerLike, OtelSpanLike, TimingStats } from "./tracing.js";
+export { defineSchema, createSchemaKV } from "./schema/index.js";
+export type { SchemaNodeDef, SchemaDef, TreeNode, TreeNodeIterator, TreeNodePage, TreeNodeWithChildren, KeyBuilders, SchemaKV, } from "./schema/index.js";
+export type { BlobStore, KV2Options, EntriesIterable, EntriesPage, KeysIterable, KeysPage, KVEntry, KVEntryNotFound, KVGetResult, KVLike, KVSetResult, PrefixString, PutBody, SetOptions, Span, Tracer, } from "./types.js";
+export type { CreateKVOptions, UpstreamConfig } from "./create-kv.js";
+export type { KeyMeta } from "./manifest-log.js";
+export type { IndexDef, IndexQuery } from "./typed-kv.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAG1E,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,EACN,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,iBAAiB,GACjB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG9E,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACjE,YAAY,EACX,aAAa,EACb,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACpB,WAAW,EACX,QAAQ,GACR,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACX,SAAS,EACT,UAAU,EACV,eAAe,EACf,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,eAAe,EACf,WAAW,EACX,MAAM,EACN,WAAW,EACX,YAAY,EACZ,OAAO,EACP,UAAU,EACV,IAAI,EACJ,MAAM,GACN,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACtE,YAAY,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+export { KV2 } from "./cached-kv.js";
+export { TypedKV } from "./typed-kv.js";
+export { VercelBlobStore } from "./blob-store.js";
+export { KVVersionConflictError, KVIndexConflictError } from "./types.js";
+// CoW / Environment-aware KV
+export { createKV } from "./create-kv.js";
+export { UpstreamKV } from "./upstream-kv.js";
+export { ManifestLog } from "./manifest-log.js";
+// Tracing
+export { noopTracer, consoleTracer, createOtelTracer, createStatsTracer, } from "./tracing.js";
+// Schema-based API
+export { defineSchema, createSchemaKV } from "./schema/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE1E,6BAA6B;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,UAAU;AACV,OAAO,EACN,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,iBAAiB,GACjB,MAAM,cAAc,CAAC;AAGtB,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/indexed-kv.d.ts

@@ -0,0 +1,44 @@
+import { TypedKV } from "./typed-kv.js";
+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;
+}
+/**
+ * A KV store wrapper that automatically maintains secondary indexes.
+ *
+ * Wraps any KVLike parent and adds index management on top of a prefixed data store.
+ * Index entries are stored as siblings under `__idx/` to avoid polluting `keys()` scans.
+ *
+ * Orphan detection: stale index entries are detected and cleaned up on read.
+ */
+export declare class IndexedKV<V, M = undefined> {
+    private parent;
+    private store;
+    private indexes;
+    private prefix;
+    private indexStores;
+    constructor(parent: KVLike<M>, prefix: string, indexes: Record<string, IndexDef<V>>);
+    get(key: string): Promise<KVGetResult<V, M>>;
+    set(key: string, value: V, ...[metadata, options]: undefined extends M ? [M?, SetOptions?] : [M, SetOptions?]): Promise<KVSetResult>;
+    delete(key: string): Promise<void>;
+    keys(prefix?: string): KeysIterable;
+    entries(prefix?: string): EntriesIterable<V, M>;
+    getMany(keys: string[], concurrency?: number): Promise<Map<string, KVEntry<V, M>>>;
+    /**
+     * Point lookup on a unique index. Validates and cleans orphans.
+     */
+    getByIndex(indexName: string, indexKey: string): Promise<KVGetResult<V, M>>;
+    /**
+     * Prefix scan on a non-unique index. Returns primary keys.
+     */
+    keysByIndex(indexName: string, indexKey: string): KeysIterable;
+    /**
+     * Prefix scan returning full entries. Validates each result.
+     */
+    entriesByIndex(indexName: string, indexKey: string): EntriesIterable<V, M>;
+    getStore(): TypedKV<V, M>;
+}
+//# sourceMappingURL=indexed-kv.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"indexed-kv.d.ts","sourceRoot":"","sources":["../src/indexed-kv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,EACX,eAAe,EAEf,OAAO,EACP,WAAW,EACX,MAAM,EACN,WAAW,EACX,YAAY,EAEZ,UAAU,EACV,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,QAAQ,CAAC,CAAC;IAC1B,iGAAiG;IACjG,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,EAAE,CAAC;IACzD,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAQD;;;;;;;GAOG;AACH,qBAAa,SAAS,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS;IACtC,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAA6C;gBAG/D,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAmB/B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAI5C,GAAG,CACR,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,EACR,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,SAAS,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,GAChF,OAAO,CAAC,WAAW,CAAC;IAsEjB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BxC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY;IAInC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC;IAIzC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAMxF;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAgDjF;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY;IAoF9D;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC;IAqG1E,QAAQ,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;CAGzB"}

package/dist/indexed-kv.js

@@ -0,0 +1,373 @@
+import { TypedKV } from "./typed-kv.js";
+import { KVIndexConflictError } from "./types.js";
+const INDEX_PREFIX = "__idx/";
+function normalizeIndexKeys(raw) {
+    return Array.isArray(raw) ? raw : [raw];
+}
+/**
+ * A KV store wrapper that automatically maintains secondary indexes.
+ *
+ * Wraps any KVLike parent and adds index management on top of a prefixed data store.
+ * Index entries are stored as siblings under `__idx/` to avoid polluting `keys()` scans.
+ *
+ * Orphan detection: stale index entries are detected and cleaned up on read.
+ */
+export class IndexedKV {
+    parent;
+    store;
+    indexes;
+    prefix;
+    indexStores;
+    constructor(parent, prefix, indexes) {
+        this.parent = parent;
+        this.prefix = prefix;
+        this.store = new TypedKV(parent, prefix);
+        this.indexes = indexes;
+        // Create a TypedKV for each index, storing plain primary-key strings with no metadata
+        this.indexStores = {};
+        for (const name of Object.keys(indexes)) {
+            this.indexStores[name] = new TypedKV(parent, `${INDEX_PREFIX}${prefix}${name}/`);
+        }
+    }
+    // --- Standard KVLike methods ---
+    async get(key) {
+        return this.store.get(key);
+    }
+    async set(key, value, ...[metadata, options]) {
+        // 1. Read old entry to determine old index keys
+        const oldResult = await this.store.get(key);
+        const oldValue = oldResult.exists ? await oldResult.value : undefined;
+        // 2. Check unique constraints for new index keys that changed
+        for (const [name, def] of Object.entries(this.indexes)) {
+            if (!def.unique)
+                continue;
+            const newKeys = normalizeIndexKeys(def.key(value, key));
+            const oldKeys = oldValue
+                ? normalizeIndexKeys(def.key(oldValue, key))
+                : [];
+            const oldSet = new Set(oldKeys);
+            for (const newKey of newKeys) {
+                if (oldSet.has(newKey))
+                    continue; // unchanged, skip check
+                const existing = await this.indexStores[name].get(newKey);
+                if (existing.exists) {
+                    const existingPK = await existing.value;
+                    if (existingPK !== key) {
+                        throw new KVIndexConflictError(name, newKey);
+                    }
+                }
+            }
+        }
+        // 3. Write all index entries concurrently (throw on failure — before
+        // main entry is written, so a failed index write means clean state).
+        // If main write later fails, orphan indexes self-heal on read.
+        const indexOps = [];
+        for (const [name, def] of Object.entries(this.indexes)) {
+            const newKeys = normalizeIndexKeys(def.key(value, key));
+            const oldKeys = oldValue
+                ? normalizeIndexKeys(def.key(oldValue, key))
+                : [];
+            const newSet = new Set(newKeys);
+            const oldSet = new Set(oldKeys);
+            const indexStore = this.indexStores[name];
+            const isUnique = def.unique ?? false;
+            // Delete old index entries that are no longer needed
+            for (const oldKey of oldKeys) {
+                if (!newSet.has(oldKey)) {
+                    if (isUnique) {
+                        indexOps.push(indexStore.delete(oldKey));
+                    }
+                    else {
+                        indexOps.push(indexStore.delete(`${oldKey}/${key}`));
+                    }
+                }
+            }
+            // Write new index entries
+            for (const newKey of newKeys) {
+                if (!oldSet.has(newKey)) {
+                    if (isUnique) {
+                        indexOps.push(indexStore.set(newKey, key));
+                    }
+                    else {
+                        indexOps.push(indexStore.set(`${newKey}/${key}`, key));
+                    }
+                }
+            }
+        }
+        await Promise.all(indexOps);
+        // 4. Write main entry last
+        return this.store.set(key, value, ...[metadata, options]);
+    }
+    async delete(key) {
+        // 1. Read entry to determine current index keys
+        const result = await this.store.get(key);
+        if (!result.exists)
+            return;
+        const value = await result.value;
+        // 2. Delete main entry
+        await this.store.delete(key);
+        // 3. Delete all index entries concurrently
+        const deleteOps = [];
+        for (const [name, def] of Object.entries(this.indexes)) {
+            const keys = normalizeIndexKeys(def.key(value, key));
+            const indexStore = this.indexStores[name];
+            const isUnique = def.unique ?? false;
+            for (const indexKey of keys) {
+                if (isUnique) {
+                    deleteOps.push(indexStore.delete(indexKey).catch(() => { }));
+                }
+                else {
+                    deleteOps.push(indexStore.delete(`${indexKey}/${key}`).catch(() => { }));
+                }
+            }
+        }
+        await Promise.all(deleteOps);
+    }
+    keys(prefix) {
+        return this.store.keys(prefix);
+    }
+    entries(prefix) {
+        return this.store.entries(prefix);
+    }
+    async getMany(keys, concurrency) {
+        return this.store.getMany(keys, concurrency);
+    }
+    // --- Index query methods ---
+    /**
+     * Point lookup on a unique index. Validates and cleans orphans.
+     */
+    async getByIndex(indexName, indexKey) {
+        const def = this.indexes[indexName];
+        if (!def) {
+            throw new Error(`Unknown index: "${indexName}"`);
+        }
+        if (!def.unique) {
+            throw new Error(`getByIndex requires a unique index, "${indexName}" is non-unique. Use keysByIndex or entriesByIndex instead.`);
+        }
+        const indexStore = this.indexStores[indexName];
+        // 1. Look up index entry
+        const indexResult = await indexStore.get(indexKey);
+        if (!indexResult.exists) {
+            return { exists: false, metadata: undefined, value: undefined, stream: undefined };
+        }
+        // 2. Get primary key from index
+        const primaryKey = await indexResult.value;
+        // 3. Look up main entry
+        const entry = await this.store.get(primaryKey);
+        // 4. Orphan type 1: main entry doesn't exist
+        if (!entry.exists) {
+            indexStore.delete(indexKey).catch(() => { });
+            return { exists: false, metadata: undefined, value: undefined, stream: undefined };
+        }
+        // 5. Orphan type 2: index points to value with different index key
+        const value = await entry.value;
+        const currentKeys = normalizeIndexKeys(def.key(value, primaryKey));
+        if (!currentKeys.includes(indexKey)) {
+            indexStore.delete(indexKey).catch(() => { });
+            return { exists: false, metadata: undefined, value: undefined, stream: undefined };
+        }
+        // 6. Valid — return the entry (re-wrap value since we already awaited it)
+        return {
+            exists: true,
+            metadata: entry.metadata,
+            value: Promise.resolve(value),
+            stream: entry.stream,
+            version: entry.version,
+            update: entry.update,
+        };
+    }
+    /**
+     * Prefix scan on a non-unique index. Returns primary keys.
+     */
+    keysByIndex(indexName, indexKey) {
+        const def = this.indexes[indexName];
+        if (!def) {
+            throw new Error(`Unknown index: "${indexName}"`);
+        }
+        const indexStore = this.indexStores[indexName];
+        const store = this.store;
+        const isUnique = def.unique ?? false;
+        if (isUnique) {
+            // For unique indexes, just do a point lookup
+            const self = this;
+            return {
+                async *[Symbol.asyncIterator]() {
+                    const result = await self.getByIndex(indexName, indexKey);
+                    if (result.exists) {
+                        const indexResult = await indexStore.get(indexKey);
+                        if (indexResult.exists) {
+                            yield await indexResult.value;
+                        }
+                    }
+                },
+                async page(limit, cursor) {
+                    if (cursor)
+                        return { keys: [] };
+                    const result = await self.getByIndex(indexName, indexKey);
+                    if (result.exists) {
+                        const indexResult = await indexStore.get(indexKey);
+                        if (indexResult.exists) {
+                            return { keys: [await indexResult.value] };
+                        }
+                    }
+                    return { keys: [] };
+                },
+            };
+        }
+        // Non-unique: scan prefix {indexKey}/
+        const scanPrefix = `${indexKey}/`;
+        return {
+            async *[Symbol.asyncIterator]() {
+                for await (const [, entry] of indexStore.entries(scanPrefix)) {
+                    const primaryKey = await entry.value;
+                    // Validate: main entry must exist
+                    const mainEntry = await store.get(primaryKey);
+                    if (mainEntry.exists) {
+                        const value = await mainEntry.value;
+                        const currentKeys = normalizeIndexKeys(def.key(value, primaryKey));
+                        if (currentKeys.includes(indexKey)) {
+                            yield primaryKey;
+                        }
+                        else {
+                            // Orphan type 2
+                            indexStore.delete(`${indexKey}/${primaryKey}`).catch(() => { });
+                        }
+                    }
+                    else {
+                        // Orphan type 1
+                        indexStore.delete(`${indexKey}/${primaryKey}`).catch(() => { });
+                    }
+                }
+            },
+            async page(limit, cursor) {
+                const { entries, cursor: nextCursor } = await indexStore.entries(scanPrefix).page(limit, cursor);
+                const keys = [];
+                for (const [, entry] of entries) {
+                    const primaryKey = await entry.value;
+                    const mainEntry = await store.get(primaryKey);
+                    if (mainEntry.exists) {
+                        const value = await mainEntry.value;
+                        const currentKeys = normalizeIndexKeys(def.key(value, primaryKey));
+                        if (currentKeys.includes(indexKey)) {
+                            keys.push(primaryKey);
+                        }
+                        else {
+                            indexStore.delete(`${indexKey}/${primaryKey}`).catch(() => { });
+                        }
+                    }
+                    else {
+                        indexStore.delete(`${indexKey}/${primaryKey}`).catch(() => { });
+                    }
+                }
+                return { keys, cursor: nextCursor };
+            },
+        };
+    }
+    /**
+     * Prefix scan returning full entries. Validates each result.
+     */
+    entriesByIndex(indexName, indexKey) {
+        const def = this.indexes[indexName];
+        if (!def) {
+            throw new Error(`Unknown index: "${indexName}"`);
+        }
+        const indexStore = this.indexStores[indexName];
+        const store = this.store;
+        const isUnique = def.unique ?? false;
+        if (isUnique) {
+            const self = this;
+            return {
+                async *[Symbol.asyncIterator]() {
+                    const result = await self.getByIndex(indexName, indexKey);
+                    if (result.exists) {
+                        const indexResult = await indexStore.get(indexKey);
+                        if (indexResult.exists) {
+                            const pk = await indexResult.value;
+                            yield [pk, result];
+                        }
+                    }
+                },
+                async page(limit, cursor) {
+                    if (cursor)
+                        return { entries: [] };
+                    const result = await self.getByIndex(indexName, indexKey);
+                    if (result.exists) {
+                        const indexResult = await indexStore.get(indexKey);
+                        if (indexResult.exists) {
+                            const pk = await indexResult.value;
+                            return { entries: [[pk, result]] };
+                        }
+                    }
+                    return { entries: [] };
+                },
+            };
+        }
+        // Non-unique: scan prefix {indexKey}/
+        const scanPrefix = `${indexKey}/`;
+        return {
+            async *[Symbol.asyncIterator]() {
+                for await (const [, indexEntry] of indexStore.entries(scanPrefix)) {
+                    const primaryKey = await indexEntry.value;
+                    const mainEntry = await store.get(primaryKey);
+                    if (mainEntry.exists) {
+                        const value = await mainEntry.value;
+                        const currentKeys = normalizeIndexKeys(def.key(value, primaryKey));
+                        if (currentKeys.includes(indexKey)) {
+                            // Re-wrap value since we already awaited it
+                            const wrappedEntry = {
+                                exists: true,
+                                metadata: mainEntry.metadata,
+                                value: Promise.resolve(value),
+                                stream: mainEntry.stream,
+                                version: mainEntry.version,
+                                update: mainEntry.update,
+                            };
+                            yield [primaryKey, wrappedEntry];
+                        }
+                        else {
+                            indexStore.delete(`${indexKey}/${primaryKey}`).catch(() => { });
+                        }
+                    }
+                    else {
+                        indexStore.delete(`${indexKey}/${primaryKey}`).catch(() => { });
+                    }
+                }
+            },
+            async page(limit, cursor) {
+                const { entries: indexEntries, cursor: nextCursor } = await indexStore.entries(scanPrefix).page(limit, cursor);
+                const entries = [];
+                for (const [, indexEntry] of indexEntries) {
+                    const primaryKey = await indexEntry.value;
+                    const mainEntry = await store.get(primaryKey);
+                    if (mainEntry.exists) {
+                        const value = await mainEntry.value;
+                        const currentKeys = normalizeIndexKeys(def.key(value, primaryKey));
+                        if (currentKeys.includes(indexKey)) {
+                            const wrappedEntry = {
+                                exists: true,
+                                metadata: mainEntry.metadata,
+                                value: Promise.resolve(value),
+                                stream: mainEntry.stream,
+                                version: mainEntry.version,
+                                update: mainEntry.update,
+                            };
+                            entries.push([primaryKey, wrappedEntry]);
+                        }
+                        else {
+                            indexStore.delete(`${indexKey}/${primaryKey}`).catch(() => { });
+                        }
+                    }
+                    else {
+                        indexStore.delete(`${indexKey}/${primaryKey}`).catch(() => { });
+                    }
+                }
+                return { entries, cursor: nextCursor };
+            },
+        };
+    }
+    // --- Access to underlying stores ---
+    getStore() {
+        return this.store;
+    }
+}
+//# sourceMappingURL=indexed-kv.js.map

package/dist/indexed-kv.js.map

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

package/dist/manifest-log.d.ts

@@ -0,0 +1,57 @@
+import type { BlobStore, CacheLike } from "./types.js";
+export interface KeyMeta {
+    source: "local" | "upstream" | "tombstone";
+}
+/**
+ * Manifest for tracking key sources (local vs upstream vs tombstone).
+ *
+ * Individual entries stored in blob for persistence.
+ * Aggregated manifest cached as single entry for fast cross-instance reads.
+ */
+export declare class ManifestLog {
+    private kv;
+    private cache;
+    private cacheKey;
+    constructor(blobStore: BlobStore, manifestPrefix: string, cache?: CacheLike);
+    /**
+     * Get the source for a specific key.
+     * Returns null if key is not in manifest (unknown).
+     */
+    getKeySource(key: string): Promise<KeyMeta | null>;
+    /**
+     * Record a key as local or upstream.
+     */
+    recordAdd(key: string, source: "local" | "upstream"): Promise<void>;
+    /**
+     * Record a key deletion (tombstone).
+     */
+    recordDelete(key: string): Promise<void>;
+    /**
+     * Delete a manifest entry (for cleanup).
+     */
+    remove(key: string): Promise<void>;
+    /**
+     * Delete all manifest entries.
+     */
+    destroy(): Promise<void>;
+    /**
+     * Get all manifest entries.
+     */
+    getAll(): Promise<Map<string, KeyMeta>>;
+    /**
+     * Get manifest state with keys map.
+     */
+    getManifest(): Promise<{
+        keys: Map<string, KeyMeta>;
+    }>;
+    /**
+     * Load manifest from cache or blob.
+     * Caches aggregated result for fast repeated reads.
+     */
+    private loadManifest;
+    /**
+     * Invalidate the cached manifest.
+     */
+    private invalidateCache;
+}
+//# sourceMappingURL=manifest-log.d.ts.map

package/dist/manifest-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-log.d.ts","sourceRoot":"","sources":["../src/manifest-log.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,WAAW,OAAO;IACvB,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,WAAW,CAAC;CAC3C;AASD;;;;;GAKG;AACH,qBAAa,WAAW;IACvB,OAAO,CAAC,EAAE,CAAiB;IAC3B,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,QAAQ,CAAS;gBAEb,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS;IAY3E;;;OAGG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAKxD;;OAEG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzE;;OAEG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9C;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI7C;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAI5D;;;OAGG;YACW,YAAY;IAuC1B;;OAEG;YACW,eAAe;CAU7B"}