@aztec/kv-store 0.66.0 → 0.67.1-devnet

package/dest/indexeddb/store.js

@@ -0,0 +1,157 @@
+var _AztecIndexedDBStore_log, _AztecIndexedDBStore_rootDB, _AztecIndexedDBStore_name, _AztecIndexedDBStore_containers;
+import { __classPrivateFieldGet, __classPrivateFieldSet } from "tslib";
+import { deleteDB, openDB } from 'idb';
+import { IndexedDBAztecArray } from './array.js';
+import { IndexedDBAztecMap } from './map.js';
+import { IndexedDBAztecSet } from './set.js';
+import { IndexedDBAztecSingleton } from './singleton.js';
+/**
+ * A key-value store backed by IndexedDB.
+ */
+export class AztecIndexedDBStore {
+    constructor(rootDB, isEphemeral, log, name) {
+        this.isEphemeral = isEphemeral;
+        _AztecIndexedDBStore_log.set(this, void 0);
+        _AztecIndexedDBStore_rootDB.set(this, void 0);
+        _AztecIndexedDBStore_name.set(this, void 0);
+        _AztecIndexedDBStore_containers.set(this, new Set());
+        __classPrivateFieldSet(this, _AztecIndexedDBStore_rootDB, rootDB, "f");
+        __classPrivateFieldSet(this, _AztecIndexedDBStore_log, log, "f");
+        __classPrivateFieldSet(this, _AztecIndexedDBStore_name, name, "f");
+    }
+    /**
+     * Creates a new AztecKVStore backed by IndexedDB. The path to the database is optional. If not provided,
+     * the database will be stored in a temporary location and be deleted when the process exists.
+     *
+     *
+     * @param path - A path on the disk to store the database. Optional
+     * @param ephemeral - true if the store should only exist in memory and not automatically be flushed to disk. Optional
+     * @param log - A logger to use. Optional
+     * @returns The store
+     */
+    static async open(log, name, ephemeral = false) {
+        name = name && !ephemeral ? name : self.crypto.getRandomValues(new Uint8Array(16)).join('');
+        log.debug(`Opening IndexedDB ${ephemeral ? 'temp ' : ''}database with name ${name}`);
+        const rootDB = await openDB(name, 1, {
+            upgrade(db) {
+                const objectStore = db.createObjectStore('data', { keyPath: 'slot' });
+                objectStore.createIndex('key', ['container', 'key'], { unique: false });
+                objectStore.createIndex('keyCount', ['container', 'key', 'keyCount'], { unique: false });
+            },
+        });
+        const kvStore = new AztecIndexedDBStore(rootDB, ephemeral, log, name);
+        return kvStore;
+    }
+    /**
+     * Forks the current DB into a new DB by backing it up to a temporary location and opening a new indexedb.
+     * @returns A new AztecIndexedDBStore.
+     */
+    async fork() {
+        const forkedStore = await AztecIndexedDBStore.open(__classPrivateFieldGet(this, _AztecIndexedDBStore_log, "f"), undefined, true);
+        __classPrivateFieldGet(this, _AztecIndexedDBStore_log, "f").verbose(`Forking store to ${__classPrivateFieldGet(forkedStore, _AztecIndexedDBStore_name, "f")}`);
+        // Copy old data to new store
+        const oldData = __classPrivateFieldGet(this, _AztecIndexedDBStore_rootDB, "f").transaction('data').store;
+        const dataToWrite = [];
+        for await (const cursor of oldData.iterate()) {
+            dataToWrite.push(cursor.value);
+        }
+        const tx = __classPrivateFieldGet(forkedStore, _AztecIndexedDBStore_rootDB, "f").transaction('data', 'readwrite').store;
+        for (const data of dataToWrite) {
+            await tx.add(data);
+        }
+        __classPrivateFieldGet(this, _AztecIndexedDBStore_log, "f").debug(`Forked store at ${__classPrivateFieldGet(forkedStore, _AztecIndexedDBStore_name, "f")} opened successfully`);
+        return forkedStore;
+    }
+    /**
+     * Creates a new AztecMap in the store.
+     * @param name - Name of the map
+     * @returns A new AztecMap
+     */
+    openMap(name) {
+        const map = new IndexedDBAztecMap(__classPrivateFieldGet(this, _AztecIndexedDBStore_rootDB, "f"), name);
+        __classPrivateFieldGet(this, _AztecIndexedDBStore_containers, "f").add(map);
+        return map;
+    }
+    /**
+     * Creates a new AztecSet in the store.
+     * @param name - Name of the set
+     * @returns A new AztecSet
+     */
+    openSet(name) {
+        const set = new IndexedDBAztecSet(__classPrivateFieldGet(this, _AztecIndexedDBStore_rootDB, "f"), name);
+        __classPrivateFieldGet(this, _AztecIndexedDBStore_containers, "f").add(set);
+        return set;
+    }
+    /**
+     * Creates a new AztecMultiMap in the store. A multi-map stores multiple values for a single key automatically.
+     * @param name - Name of the map
+     * @returns A new AztecMultiMap
+     */
+    openMultiMap(name) {
+        const multimap = new IndexedDBAztecMap(__classPrivateFieldGet(this, _AztecIndexedDBStore_rootDB, "f"), name);
+        __classPrivateFieldGet(this, _AztecIndexedDBStore_containers, "f").add(multimap);
+        return multimap;
+    }
+    openCounter(_name) {
+        throw new Error('Method not implemented.');
+    }
+    /**
+     * Creates a new AztecArray in the store.
+     * @param name - Name of the array
+     * @returns A new AztecArray
+     */
+    openArray(name) {
+        const array = new IndexedDBAztecArray(__classPrivateFieldGet(this, _AztecIndexedDBStore_rootDB, "f"), name);
+        __classPrivateFieldGet(this, _AztecIndexedDBStore_containers, "f").add(array);
+        return array;
+    }
+    /**
+     * Creates a new AztecSingleton in the store.
+     * @param name - Name of the singleton
+     * @returns A new AztecSingleton
+     */
+    openSingleton(name) {
+        const singleton = new IndexedDBAztecSingleton(__classPrivateFieldGet(this, _AztecIndexedDBStore_rootDB, "f"), name);
+        __classPrivateFieldGet(this, _AztecIndexedDBStore_containers, "f").add(singleton);
+        return singleton;
+    }
+    /**
+     * Runs a callback in a transaction.
+     * @param callback - Function to execute in a transaction
+     * @returns A promise that resolves to the return value of the callback
+     */
+    async transactionAsync(callback) {
+        const tx = __classPrivateFieldGet(this, _AztecIndexedDBStore_rootDB, "f").transaction('data', 'readwrite');
+        for (const container of __classPrivateFieldGet(this, _AztecIndexedDBStore_containers, "f")) {
+            container.db = tx.store;
+        }
+        // Avoid awaiting this promise so it doesn't get scheduled in the next microtask
+        // By then, the tx would be closed
+        const runningPromise = callback();
+        // Wait for the transaction to finish
+        await tx.done;
+        for (const container of __classPrivateFieldGet(this, _AztecIndexedDBStore_containers, "f")) {
+            container.db = undefined;
+        }
+        // Return the result of the callback.
+        // Tx is guaranteed to already be closed, so the await doesn't hurt anything here
+        return await runningPromise;
+    }
+    /**
+     * Clears all entries in the store & sub DBs.
+     */
+    async clear() {
+        await __classPrivateFieldGet(this, _AztecIndexedDBStore_rootDB, "f").transaction('data', 'readwrite').store.clear();
+    }
+    /** Deletes this store and removes the database */
+    delete() {
+        __classPrivateFieldGet(this, _AztecIndexedDBStore_containers, "f").clear();
+        __classPrivateFieldGet(this, _AztecIndexedDBStore_rootDB, "f").close();
+        return deleteDB(__classPrivateFieldGet(this, _AztecIndexedDBStore_name, "f"));
+    }
+    estimateSize() {
+        return { mappingSize: 0, actualSize: 0, numItems: 0 };
+    }
+}
+_AztecIndexedDBStore_log = new WeakMap(), _AztecIndexedDBStore_rootDB = new WeakMap(), _AztecIndexedDBStore_name = new WeakMap(), _AztecIndexedDBStore_containers = new WeakMap();
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RvcmUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXhlZGRiL3N0b3JlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBRUEsT0FBTyxFQUFvQyxRQUFRLEVBQUUsTUFBTSxFQUFFLE1BQU0sS0FBSyxDQUFDO0FBU3pFLE9BQU8sRUFBRSxtQkFBbUIsRUFBRSxNQUFNLFlBQVksQ0FBQztBQUNqRCxPQUFPLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSxVQUFVLENBQUM7QUFDN0MsT0FBTyxFQUFFLGlCQUFpQixFQUFFLE1BQU0sVUFBVSxDQUFDO0FBQzdDLE9BQU8sRUFBRSx1QkFBdUIsRUFBRSxNQUFNLGdCQUFnQixDQUFDO0FBWXpEOztHQUVHO0FBRUgsTUFBTSxPQUFPLG1CQUFtQjtJQVM5QixZQUFZLE1BQW9DLEVBQWtCLFdBQW9CLEVBQUUsR0FBVyxFQUFFLElBQVk7UUFBL0MsZ0JBQVcsR0FBWCxXQUFXLENBQVM7UUFSdEYsMkNBQWE7UUFDYiw4Q0FBc0M7UUFDdEMsNENBQWM7UUFFZCwwQ0FBYyxJQUFJLEdBQUcsRUFFbEIsRUFBQztRQUdGLHVCQUFBLElBQUksK0JBQVcsTUFBTSxNQUFBLENBQUM7UUFDdEIsdUJBQUEsSUFBSSw0QkFBUSxHQUFHLE1BQUEsQ0FBQztRQUNoQix1QkFBQSxJQUFJLDZCQUFTLElBQUksTUFBQSxDQUFDO0lBQ3BCLENBQUM7SUFDRDs7Ozs7Ozs7O09BU0c7SUFDSCxNQUFNLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxHQUFXLEVBQUUsSUFBYSxFQUFFLFlBQXFCLEtBQUs7UUFDdEUsSUFBSSxHQUFHLElBQUksSUFBSSxDQUFDLFNBQVMsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUMsTUFBTSxDQUFDLGVBQWUsQ0FBQyxJQUFJLFVBQVUsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxFQUFFLENBQUMsQ0FBQztRQUM1RixHQUFHLENBQUMsS0FBSyxDQUFDLHFCQUFxQixTQUFTLENBQUMsQ0FBQyxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUMsRUFBRSxzQkFBc0IsSUFBSSxFQUFFLENBQUMsQ0FBQztRQUNyRixNQUFNLE1BQU0sR0FBRyxNQUFNLE1BQU0sQ0FBaUIsSUFBSSxFQUFFLENBQUMsRUFBRTtZQUNuRCxPQUFPLENBQUMsRUFBRTtnQkFDUixNQUFNLFdBQVcsR0FBRyxFQUFFLENBQUMsaUJBQWlCLENBQUMsTUFBTSxFQUFFLEVBQUUsT0FBTyxFQUFFLE1BQU0sRUFBRSxDQUFDLENBQUM7Z0JBRXRFLFdBQVcsQ0FBQyxXQUFXLENBQUMsS0FBSyxFQUFFLENBQUMsV0FBVyxFQUFFLEtBQUssQ0FBQyxFQUFFLEVBQUUsTUFBTSxFQUFFLEtBQUssRUFBRSxDQUFDLENBQUM7Z0JBQ3hFLFdBQVcsQ0FBQyxXQUFXLENBQUMsVUFBVSxFQUFFLENBQUMsV0FBVyxFQUFFLEtBQUssRUFBRSxVQUFVLENBQUMsRUFBRSxFQUFFLE1BQU0sRUFBRSxLQUFLLEVBQUUsQ0FBQyxDQUFDO1lBQzNGLENBQUM7U0FDRixDQUFDLENBQUM7UUFFSCxNQUFNLE9BQU8sR0FBRyxJQUFJLG1CQUFtQixDQUFDLE1BQU0sRUFBRSxTQUFTLEVBQUUsR0FBRyxFQUFFLElBQUksQ0FBQyxDQUFDO1FBQ3RFLE9BQU8sT0FBTyxDQUFDO0lBQ2pCLENBQUM7SUFFRDs7O09BR0c7SUFDSCxLQUFLLENBQUMsSUFBSTtRQUNSLE1BQU0sV0FBVyxHQUFHLE1BQU0sbUJBQW1CLENBQUMsSUFBSSxDQUFDLHVCQUFBLElBQUksZ0NBQUssRUFBRSxTQUFTLEVBQUUsSUFBSSxDQUFDLENBQUM7UUFDL0UsdUJBQUEsSUFBSSxnQ0FBSyxDQUFDLE9BQU8sQ0FBQyxvQkFBb0IsdUJBQUEsV0FBVyxpQ0FBTSxFQUFFLENBQUMsQ0FBQztRQUUzRCw2QkFBNkI7UUFDN0IsTUFBTSxPQUFPLEdBQUcsdUJBQUEsSUFBSSxtQ0FBUSxDQUFDLFdBQVcsQ0FBQyxNQUFNLENBQUMsQ0FBQyxLQUFLLENBQUM7UUFDdkQsTUFBTSxXQUFXLEdBQUcsRUFBRSxDQUFDO1FBQ3ZCLElBQUksS0FBSyxFQUFFLE1BQU0sTUFBTSxJQUFJLE9BQU8sQ0FBQyxPQUFPLEVBQUUsRUFBRSxDQUFDO1lBQzdDLFdBQVcsQ0FBQyxJQUFJLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyxDQUFDO1FBQ2pDLENBQUM7UUFDRCxNQUFNLEVBQUUsR0FBRyx1QkFBQSxXQUFXLG1DQUFRLENBQUMsV0FBVyxDQUFDLE1BQU0sRUFBRSxXQUFXLENBQUMsQ0FBQyxLQUFLLENBQUM7UUFDdEUsS0FBSyxNQUFNLElBQUksSUFBSSxXQUFXLEVBQUUsQ0FBQztZQUMvQixNQUFNLEVBQUUsQ0FBQyxHQUFHLENBQUMsSUFBSSxDQUFDLENBQUM7UUFDckIsQ0FBQztRQUVELHVCQUFBLElBQUksZ0NBQUssQ0FBQyxLQUFLLENBQUMsbUJBQW1CLHVCQUFBLFdBQVcsaUNBQU0sc0JBQXNCLENBQUMsQ0FBQztRQUM1RSxPQUFPLFdBQVcsQ0FBQztJQUNyQixDQUFDO0lBRUQ7Ozs7T0FJRztJQUNILE9BQU8sQ0FBbUIsSUFBWTtRQUNwQyxNQUFNLEdBQUcsR0FBRyxJQUFJLGlCQUFpQixDQUFPLHVCQUFBLElBQUksbUNBQVEsRUFBRSxJQUFJLENBQUMsQ0FBQztRQUM1RCx1QkFBQSxJQUFJLHVDQUFZLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBQzFCLE9BQU8sR0FBRyxDQUFDO0lBQ2IsQ0FBQztJQUVEOzs7O09BSUc7SUFDSCxPQUFPLENBQWdCLElBQVk7UUFDakMsTUFBTSxHQUFHLEdBQUcsSUFBSSxpQkFBaUIsQ0FBSSx1QkFBQSxJQUFJLG1DQUFRLEVBQUUsSUFBSSxDQUFDLENBQUM7UUFDekQsdUJBQUEsSUFBSSx1Q0FBWSxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsQ0FBQztRQUMxQixPQUFPLEdBQUcsQ0FBQztJQUNiLENBQUM7SUFFRDs7OztPQUlHO0lBQ0gsWUFBWSxDQUFtQixJQUFZO1FBQ3pDLE1BQU0sUUFBUSxHQUFHLElBQUksaUJBQWlCLENBQU8sdUJBQUEsSUFBSSxtQ0FBUSxFQUFFLElBQUksQ0FBQyxDQUFDO1FBQ2pFLHVCQUFBLElBQUksdUNBQVksQ0FBQyxHQUFHLENBQUMsUUFBUSxDQUFDLENBQUM7UUFDL0IsT0FBTyxRQUFRLENBQUM7SUFDbEIsQ0FBQztJQUVELFdBQVcsQ0FBeUMsS0FBYTtRQUMvRCxNQUFNLElBQUksS0FBSyxDQUFDLHlCQUF5QixDQUFDLENBQUM7SUFDN0MsQ0FBQztJQUVEOzs7O09BSUc7SUFDSCxTQUFTLENBQUksSUFBWTtRQUN2QixNQUFNLEtBQUssR0FBRyxJQUFJLG1CQUFtQixDQUFJLHVCQUFBLElBQUksbUNBQVEsRUFBRSxJQUFJLENBQUMsQ0FBQztRQUM3RCx1QkFBQSxJQUFJLHVDQUFZLENBQUMsR0FBRyxDQUFDLEtBQUssQ0FBQyxDQUFDO1FBQzVCLE9BQU8sS0FBSyxDQUFDO0lBQ2YsQ0FBQztJQUVEOzs7O09BSUc7SUFDSCxhQUFhLENBQUksSUFBWTtRQUMzQixNQUFNLFNBQVMsR0FBRyxJQUFJLHVCQUF1QixDQUFJLHVCQUFBLElBQUksbUNBQVEsRUFBRSxJQUFJLENBQUMsQ0FBQztRQUNyRSx1QkFBQSxJQUFJLHVDQUFZLENBQUMsR0FBRyxDQUFDLFNBQVMsQ0FBQyxDQUFDO1FBQ2hDLE9BQU8sU0FBUyxDQUFDO0lBQ25CLENBQUM7SUFFRDs7OztPQUlHO0lBQ0gsS0FBSyxDQUFDLGdCQUFnQixDQUFJLFFBQTBCO1FBQ2xELE1BQU0sRUFBRSxHQUFHLHVCQUFBLElBQUksbUNBQVEsQ0FBQyxXQUFXLENBQUMsTUFBTSxFQUFFLFdBQVcsQ0FBQyxDQUFDO1FBQ3pELEtBQUssTUFBTSxTQUFTLElBQUksdUJBQUEsSUFBSSx1Q0FBWSxFQUFFLENBQUM7WUFDekMsU0FBUyxDQUFDLEVBQUUsR0FBRyxFQUFFLENBQUMsS0FBSyxDQUFDO1FBQzFCLENBQUM7UUFDRCxnRkFBZ0Y7UUFDaEYsa0NBQWtDO1FBQ2xDLE1BQU0sY0FBYyxHQUFHLFFBQVEsRUFBRSxDQUFDO1FBQ2xDLHFDQUFxQztRQUNyQyxNQUFNLEVBQUUsQ0FBQyxJQUFJLENBQUM7UUFDZCxLQUFLLE1BQU0sU0FBUyxJQUFJLHVCQUFBLElBQUksdUNBQVksRUFBRSxDQUFDO1lBQ3pDLFNBQVMsQ0FBQyxFQUFFLEdBQUcsU0FBUyxDQUFDO1FBQzNCLENBQUM7UUFDRCxxQ0FBcUM7UUFDckMsaUZBQWlGO1FBQ2pGLE9BQU8sTUFBTSxjQUFjLENBQUM7SUFDOUIsQ0FBQztJQUVEOztPQUVHO0lBQ0gsS0FBSyxDQUFDLEtBQUs7UUFDVCxNQUFNLHVCQUFBLElBQUksbUNBQVEsQ0FBQyxXQUFXLENBQUMsTUFBTSxFQUFFLFdBQVcsQ0FBQyxDQUFDLEtBQUssQ0FBQyxLQUFLLEVBQUUsQ0FBQztJQUNwRSxDQUFDO0lBRUQsa0RBQWtEO0lBQ2xELE1BQU07UUFDSix1QkFBQSxJQUFJLHVDQUFZLENBQUMsS0FBSyxFQUFFLENBQUM7UUFDekIsdUJBQUEsSUFBSSxtQ0FBUSxDQUFDLEtBQUssRUFBRSxDQUFDO1FBQ3JCLE9BQU8sUUFBUSxDQUFDLHVCQUFBLElBQUksaUNBQU0sQ0FBQyxDQUFDO0lBQzlCLENBQUM7SUFFRCxZQUFZO1FBQ1YsT0FBTyxFQUFFLFdBQVcsRUFBRSxDQUFDLEVBQUUsVUFBVSxFQUFFLENBQUMsRUFBRSxRQUFRLEVBQUUsQ0FBQyxFQUFFLENBQUM7SUFDeEQsQ0FBQztDQUNGIn0=

package/dest/interfaces/array.d.ts

@@ -1,11 +1,7 @@
 /**
  * An array backed by a persistent store. Can not have any holes in it.
  */
-export interface AztecArray<T> {
-    /**
-     * The size of the array
-     */
-    length: number;
+interface BaseAztecArray<T> {
     /**
      * Pushes values to the end of the array
      * @param vals - The values to push to the end of the array
@@ -17,6 +13,22 @@ export interface AztecArray<T> {
      * @returns The value that was popped, or undefined if the array was empty
      */
     pop(): Promise<T | undefined>;
+    /**
+     * Updates the value at the given index. Index can be in the range [-length, length - 1).
+     * @param index - The index to set the value at
+     * @param val - The value to set
+     * @returns Whether the value was set
+     */
+    setAt(index: number, val: T): Promise<boolean>;
+}
+/**
+ * An array backed by a persistent store. Can not have any holes in it.
+ */
+export interface AztecAsyncArray<T> extends BaseAztecArray<T> {
+    /**
+     * The size of the array
+     */
+    lengthAsync(): Promise<number>;
     /**
      * Gets the value at the given index. Index can be in the range [-length, length - 1).
      * If the index is negative, it will be treated as an offset from the end of the array.
@@ -24,14 +36,33 @@ export interface AztecArray<T> {
      * @param index - The index to get the value from
      * @returns The value at the given index or undefined if the index is out of bounds
      */
-    at(index: number): T | undefined;
+    atAsync(index: number): Promise<T | undefined>;
     /**
-     * Updates the value at the given index. Index can be in the range [-length, length - 1).
-     * @param index - The index to set the value at
-     * @param val - The value to set
-     * @returns Whether the value was set
+     * Iterates over the array with indexes.
      */
-    setAt(index: number, val: T): Promise<boolean>;
+    entriesAsync(): AsyncIterableIterator<[number, T]>;
+    /**
+     * Iterates over the array.
+     */
+    valuesAsync(): AsyncIterableIterator<T>;
+    /**
+     * Iterates over the array.
+     */
+    [Symbol.asyncIterator](): AsyncIterableIterator<T>;
+}
+export interface AztecArray<T> extends BaseAztecArray<T> {
+    /**
+     * The size of the array
+     */
+    length: number;
+    /**
+     * Gets the value at the given index. Index can be in the range [-length, length - 1).
+     * If the index is negative, it will be treated as an offset from the end of the array.
+     *
+     * @param index - The index to get the value from
+     * @returns The value at the given index or undefined if the index is out of bounds
+     */
+    at(index: number): T | undefined;
     /**
      * Iterates over the array with indexes.
      */
@@ -45,4 +76,5 @@ export interface AztecArray<T> {
      */
     [Symbol.iterator](): IterableIterator<T>;
 }
+export {};
 //# sourceMappingURL=array.d.ts.map

package/dest/interfaces/array.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../src/interfaces/array.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEpC;;;OAGG;IACH,GAAG,IAAI,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAE9B;;;;;;OAMG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAEjC;;;;;OAKG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE/C;;OAEG;IACH,OAAO,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;IAEzC;;OAEG;IACH,MAAM,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAE9B;;OAEG;IACH,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC;CAC1C"}
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../src/interfaces/array.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,UAAU,cAAc,CAAC,CAAC;IACxB;;;;OAIG;IACH,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEpC;;;OAGG;IACH,GAAG,IAAI,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAE9B;;;;;OAKG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IAC3D;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/B;;;;;;OAMG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAE/C;;OAEG;IACH,YAAY,IAAI,qBAAqB,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;IAEnD;;OAEG;IACH,WAAW,IAAI,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAExC;;OAEG;IACH,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,CAAC,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IACtD;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;;;OAMG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAEjC;;OAEG;IACH,OAAO,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;IAEzC;;OAEG;IACH,MAAM,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAE9B;;OAEG;IACH,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC;CAC1C"}

package/dest/interfaces/array_test_suite.d.ts

@@ -0,0 +1,3 @@
+import { type AztecAsyncKVStore, type AztecKVStore } from './store.js';
+export declare function describeAztecArray(testName: string, getStore: () => AztecKVStore | Promise<AztecAsyncKVStore>, forceAsync?: boolean): void;
+//# sourceMappingURL=array_test_suite.d.ts.map

package/dest/interfaces/array_test_suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array_test_suite.d.ts","sourceRoot":"","sources":["../../src/interfaces/array_test_suite.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAGvE,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,YAAY,GAAG,OAAO,CAAC,iBAAiB,CAAC,EACzD,UAAU,GAAE,OAAe,QAsH5B"}

package/dest/interfaces/array_test_suite.js

@@ -0,0 +1,100 @@
+import { toArray } from '@aztec/foundation/iterable';
+import { expect } from 'chai';
+import { isSyncStore } from './utils.js';
+export function describeAztecArray(testName, getStore, forceAsync = false) {
+    describe(testName, () => {
+        let store;
+        let arr;
+        beforeEach(async () => {
+            store = await getStore();
+            arr = store.openArray('test');
+        });
+        afterEach(async () => {
+            await store.delete();
+        });
+        async function length(sut = arr) {
+            return isSyncStore(store) && !forceAsync
+                ? sut.length
+                : await sut.lengthAsync();
+        }
+        async function at(index) {
+            return isSyncStore(store) && !forceAsync
+                ? arr.at(index)
+                : await arr.atAsync(index);
+        }
+        async function entries() {
+            return isSyncStore(store) && !forceAsync
+                ? await toArray(arr.entries())
+                : await toArray(arr.entriesAsync());
+        }
+        async function values(sut = arr) {
+            return isSyncStore(store) && !forceAsync
+                ? await toArray(sut.values())
+                : await toArray(sut.valuesAsync());
+        }
+        it('should be able to push and pop values', async () => {
+            await arr.push(1);
+            await arr.push(2);
+            await arr.push(3);
+            expect(await length()).to.equal(3);
+            expect(await arr.pop()).to.equal(3);
+            expect(await arr.pop()).to.equal(2);
+            expect(await arr.pop()).to.equal(1);
+            expect(await arr.pop()).to.equal(undefined);
+        });
+        it('should be able to get values by index', async () => {
+            await arr.push(1);
+            await arr.push(2);
+            await arr.push(3);
+            expect(await at(0)).to.equal(1);
+            expect(await at(1)).to.equal(2);
+            expect(await at(2)).to.equal(3);
+            expect(await at(3)).to.equal(undefined);
+            expect(await at(-1)).to.equal(3);
+            expect(await at(-2)).to.equal(2);
+            expect(await at(-3)).to.equal(1);
+            expect(await at(-4)).to.equal(undefined);
+        });
+        it('should be able to set values by index', async () => {
+            await arr.push(1);
+            await arr.push(2);
+            await arr.push(3);
+            expect(await arr.setAt(0, 4)).to.equal(true);
+            expect(await arr.setAt(1, 5)).to.equal(true);
+            expect(await arr.setAt(2, 6)).to.equal(true);
+            expect(await arr.setAt(3, 7)).to.equal(false);
+            expect(await at(0)).to.equal(4);
+            expect(await at(1)).to.equal(5);
+            expect(await at(2)).to.equal(6);
+            expect(await at(3)).to.equal(undefined);
+            expect(await arr.setAt(-1, 8)).to.equal(true);
+            expect(await arr.setAt(-2, 9)).to.equal(true);
+            expect(await arr.setAt(-3, 10)).to.equal(true);
+            expect(await arr.setAt(-4, 11)).to.equal(false);
+            expect(await at(-1)).to.equal(8);
+            expect(await at(-2)).to.equal(9);
+            expect(await at(-3)).to.equal(10);
+            expect(await at(-4)).to.equal(undefined);
+        });
+        it('should be able to iterate over values', async () => {
+            await arr.push(1);
+            await arr.push(2);
+            await arr.push(3);
+            expect(await values()).to.deep.equal([1, 2, 3]);
+            expect(await entries()).to.deep.equal([
+                [0, 1],
+                [1, 2],
+                [2, 3],
+            ]);
+        });
+        it('should be able to restore state', async () => {
+            await arr.push(1);
+            await arr.push(2);
+            await arr.push(3);
+            const arr2 = store.openArray('test');
+            expect(await length(arr2)).to.equal(3);
+            expect(await values(arr2)).to.deep.equal(await values());
+        });
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXJyYXlfdGVzdF9zdWl0ZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9pbnRlcmZhY2VzL2FycmF5X3Rlc3Rfc3VpdGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLE9BQU8sRUFBRSxNQUFNLDRCQUE0QixDQUFDO0FBRXJELE9BQU8sRUFBRSxNQUFNLEVBQUUsTUFBTSxNQUFNLENBQUM7QUFJOUIsT0FBTyxFQUFFLFdBQVcsRUFBRSxNQUFNLFlBQVksQ0FBQztBQUV6QyxNQUFNLFVBQVUsa0JBQWtCLENBQ2hDLFFBQWdCLEVBQ2hCLFFBQXlELEVBQ3pELGFBQXNCLEtBQUs7SUFFM0IsUUFBUSxDQUFDLFFBQVEsRUFBRSxHQUFHLEVBQUU7UUFDdEIsSUFBSSxLQUF1QyxDQUFDO1FBQzVDLElBQUksR0FBaUQsQ0FBQztRQUV0RCxVQUFVLENBQUMsS0FBSyxJQUFJLEVBQUU7WUFDcEIsS0FBSyxHQUFHLE1BQU0sUUFBUSxFQUFFLENBQUM7WUFDekIsR0FBRyxHQUFHLEtBQUssQ0FBQyxTQUFTLENBQVMsTUFBTSxDQUFDLENBQUM7UUFDeEMsQ0FBQyxDQUFDLENBQUM7UUFFSCxTQUFTLENBQUMsS0FBSyxJQUFJLEVBQUU7WUFDbkIsTUFBTSxLQUFLLENBQUMsTUFBTSxFQUFFLENBQUM7UUFDdkIsQ0FBQyxDQUFDLENBQUM7UUFFSCxLQUFLLFVBQVUsTUFBTSxDQUFDLE1BQW9ELEdBQUc7WUFDM0UsT0FBTyxXQUFXLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxVQUFVO2dCQUN0QyxDQUFDLENBQUUsR0FBMEIsQ0FBQyxNQUFNO2dCQUNwQyxDQUFDLENBQUMsTUFBTyxHQUErQixDQUFDLFdBQVcsRUFBRSxDQUFDO1FBQzNELENBQUM7UUFFRCxLQUFLLFVBQVUsRUFBRSxDQUFDLEtBQWE7WUFDN0IsT0FBTyxXQUFXLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxVQUFVO2dCQUN0QyxDQUFDLENBQUUsR0FB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LEVBQUUsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUM7WUFDakMsTUFBTSxDQUFDLE1BQU0sRUFBRSxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDO1lBQ2pDLE1BQU0sQ0FBQyxNQUFNLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLEtBQUssQ0FBQyxTQUFTLENBQUMsQ0FBQztRQUMzQyxDQUFDLENBQUMsQ0FBQztRQUVILEVBQUUsQ0FBQyx1Q0FBdUMsRUFBRSxLQUFLLElBQUksRUFBRTtZQUNyRCxNQUFNLEdBQUcsQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUM7WUFDbEIsTUFBTSxHQUFHLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxDQUFDO1lBQ2xCLE1BQU0sR0FBRyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsQ0FBQztZQUVsQixNQUFNLENBQUMsTUFBTSxHQUFHLENBQUMsS0FBSyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLENBQUM7WUFDN0MsTUFBTSxDQUFDLE1BQU0sR0FBRyxDQUFDLEtBQUssQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxDQUFDO1lBQzdDLE1BQU0sQ0FBQyxNQUFNLEdBQUcsQ0FBQyxLQUFLLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsQ0FBQztZQUU3QyxNQUFNLENBQUMsTUFBTSxHQUFHLENBQUMsS0FBSyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxLQUFLLENBQUMsS0FBSyxDQUFDLENBQUM7WUFFOUMsTUFBTSxDQUFDLE1BQU0sRUFBRSxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQztZQUNoQyxNQUFNLENBQUMsTUFBTSxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDO1lBQ2hDLE1BQU0sQ0FBQyxNQUFNLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUM7WUFDaEMsTUFBTSxDQUFDLE1BQU0sRUFBRSxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLEtBQUssQ0FBQyxTQUFTLENBQUMsQ0FBQztZQUV4QyxNQUFNLENBQUMsTUFBTSxHQUFHLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsQ0FBQztZQUM5QyxNQUFNLENBQUMsTUFBTSxHQUFHLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsQ0FBQztZQUM5QyxNQUFNLENBQUMsTUFBTSxHQUFHLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsQ0FBQztZQUUvQyxNQUFNLENBQUMsTUFBTSxHQUFHLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLEtBQUssQ0FBQyxLQUFLLENBQUMsQ0FBQztZQUVoRCxNQUFNLENBQUMsTUFBTSxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUM7WUFDakMsTUFBTSxDQUFDLE1BQU0sRUFBRSxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDO1lBQ2pDLE1BQU0sQ0FBQyxNQUFNLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLEtBQUssQ0FBQyxFQUFFLENBQUMsQ0FBQztZQUNsQyxNQUFNLENBQUMsTUFBTSxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxLQUFLLENBQUMsU0FBUyxDQUFDLENBQUM7UUFDM0MsQ0FBQyxDQUFDLENBQUM7UUFFSCxFQUFFLENBQUMsdUNBQXVDLEVBQUUsS0FBSyxJQUFJLEVBQUU7WUFDckQsTUFBTSxHQUFHLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxDQUFDO1lBQ2xCLE1BQU0sR0FBRyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsQ0FBQztZQUNsQixNQUFNLEdBQUcsQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUM7WUFFbEIsTUFBTSxDQUFDLE1BQU0sTUFBTSxFQUFFLENBQUMsQ0FBQyxFQUFFLENBQUMsSUFBSSxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQztZQUNoRCxNQUFNLENBQUMsTUFBTSxPQUFPLEVBQUUsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDO2dCQUNwQyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUM7Z0JBQ04sQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDO2dCQUNOLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQzthQUNQLENBQUMsQ0FBQztRQUNMLENBQUMsQ0FBQyxDQUFDO1FBRUgsRUFBRSxDQUFDLGlDQUFpQyxFQUFFLEtBQUssSUFBSSxFQUFFO1lBQy9DLE1BQU0sR0FBRyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsQ0FBQztZQUNsQixNQUFNLEdBQUcsQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUM7WUFDbEIsTUFBTSxHQUFHLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxDQUFDO1lBRWxCLE1BQU0sSUFBSSxHQUFHLEtBQUssQ0FBQyxTQUFTLENBQVMsTUFBTSxDQUFDLENBQUM7WUFDN0MsTUFBTSxDQUFDLE1BQU0sTUFBTSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQztZQUN2QyxNQUFNLENBQUMsTUFBTSxNQUFNLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsSUFBSSxDQUFDLEtBQUssQ0FBQyxNQUFNLE1BQU0sRUFBRSxDQUFDLENBQUM7UUFDM0QsQ0FBQyxDQUFDLENBQUM7SUFDTCxDQUFDLENBQUMsQ0FBQztBQUNMLENBQUMifQ==

package/dest/interfaces/counter.d.ts

@@ -5,7 +5,7 @@ import { type Key, type Range } from './common.js';
  *
  * Keys are stored in sorted order
  */
-export interface AztecCounter<K extends Key = Key> {
+interface AztecBaseCounter<K extends Key = Key> {
     /**
      * Resets the count of the given key to the given value.
      * @param key - The key to reset
@@ -20,6 +20,8 @@ export interface AztecCounter<K extends Key = Key> {
      * @param delta - The amount to modify the key by
      */
     update(key: K, delta: number): Promise<void>;
+}
+export interface AztecCounter<K extends Key = Key> extends AztecBaseCounter<K> {
     /**
      * Gets the current count.
      * @param key - The key to get the count of
@@ -36,4 +38,22 @@ export interface AztecCounter<K extends Key = Key> {
      */
     entries(range: Range<K>): IterableIterator<[K, number]>;
 }
+export interface AztecAsyncCounter<K extends Key = Key> extends AztecBaseCounter<K> {
+    /**
+     * Gets the current count.
+     * @param key - The key to get the count of
+     */
+    getAsync(key: K): Promise<number>;
+    /**
+     * Returns keys in the map in sorted order. Only returns keys that have been seen at least once.
+     * @param range - The range of keys to iterate over
+     */
+    keysAsync(range: Range<K>): AsyncIterableIterator<K>;
+    /**
+     * Returns keys and their counts in the map sorted by the key. Only returns keys that have been seen at least once.
+     * @param range - The range of keys to iterate over
+     */
+    entriesAsync(range: Range<K>): AsyncIterableIterator<[K, number]>;
+}
+export {};
 //# sourceMappingURL=counter.d.ts.map

package/dest/interfaces/counter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"counter.d.ts","sourceRoot":"","sources":["../../src/interfaces/counter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG;IAC/C;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC;IAEpB;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAE3C;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;CACzD"}
+{"version":3,"file":"counter.d.ts","sourceRoot":"","sources":["../../src/interfaces/counter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;GAKG;AACH,UAAU,gBAAgB,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG;IAC5C;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;IAC5E;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC;IAEpB;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAE3C;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;IACjF;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAElC;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAErD;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;CACnE"}

package/dest/interfaces/map.d.ts

@@ -2,18 +2,7 @@ import { type Key, type Range } from './common.js';
 /**
  * A map backed by a persistent store.
  */
-export interface AztecMap<K extends Key, V> {
-    /**
-     * Gets the value at the given key.
-     * @param key - The key to get the value from
-     */
-    get(key: K): V | undefined;
-    /**
-     * Checks if a key exists in the map.
-     * @param key - The key to check
-     * @returns True if the key exists, false otherwise
-     */
-    has(key: K): boolean;
+interface AztecBaseMap<K extends Key, V> {
     /**
      * Sets the value at the given key.
      * @param key - The key to set the value at
@@ -37,6 +26,19 @@ export interface AztecMap<K extends Key, V> {
      * @param key - The key to delete the value at
      */
     delete(key: K): Promise<void>;
+}
+export interface AztecMap<K extends Key, V> extends AztecBaseMap<K, V> {
+    /**
+     * Gets the value at the given key.
+     * @param key - The key to get the value from
+     */
+    get(key: K): V | undefined;
+    /**
+     * Checks if a key exists in the map.
+     * @param key - The key to check
+     * @returns True if the key exists, false otherwise
+     */
+    has(key: K): boolean;
     /**
      * Iterates over the map's key-value entries in the key's natural order
      * @param range - The range of keys to iterate over
@@ -52,6 +54,17 @@ export interface AztecMap<K extends Key, V> {
      * @param range - The range of keys to iterate over
      */
     keys(range?: Range<K>): IterableIterator<K>;
+    /**
+     * Clears the map.
+     */
+    clear(): Promise<void>;
+}
+export interface AztecMapWithSize<K extends Key, V> extends AztecMap<K, V> {
+    /**
+     * Gets the size of the map.
+     * @returns The size of the map
+     */
+    size(): number;
 }
 /**
  * A map backed by a persistent store that can have multiple values for a single key.
@@ -69,4 +82,59 @@ export interface AztecMultiMap<K extends Key, V> extends AztecMap<K, V> {
      */
     deleteValue(key: K, val: V): Promise<void>;
 }
+export interface AztecMultiMapWithSize<K extends Key, V> extends AztecMultiMap<K, V> {
+    /**
+     * Gets the size of the map.
+     * @returns The size of the map
+     */
+    size(): number;
+}
+/**
+ * A map backed by a persistent store.
+ */
+export interface AztecAsyncMap<K extends Key, V> extends AztecBaseMap<K, V> {
+    /**
+     * Gets the value at the given key.
+     * @param key - The key to get the value from
+     */
+    getAsync(key: K): Promise<V | undefined>;
+    /**
+     * Checks if a key exists in the map.
+     * @param key - The key to check
+     * @returns True if the key exists, false otherwise
+     */
+    hasAsync(key: K): Promise<boolean>;
+    /**
+     * Iterates over the map's key-value entries in the key's natural order
+     * @param range - The range of keys to iterate over
+     */
+    entriesAsync(range?: Range<K>): AsyncIterableIterator<[K, V]>;
+    /**
+     * Iterates over the map's values in the key's natural order
+     * @param range - The range of keys to iterate over
+     */
+    valuesAsync(range?: Range<K>): AsyncIterableIterator<V>;
+    /**
+     * Iterates over the map's keys in the key's natural order
+     * @param range - The range of keys to iterate over
+     */
+    keysAsync(range?: Range<K>): AsyncIterableIterator<K>;
+}
+/**
+ * A map backed by a persistent store that can have multiple values for a single key.
+ */
+export interface AztecAsyncMultiMap<K extends Key, V> extends AztecAsyncMap<K, V> {
+    /**
+     * Gets all the values at the given key.
+     * @param key - The key to get the values from
+     */
+    getValuesAsync(key: K): AsyncIterableIterator<V>;
+    /**
+     * Deletes a specific value at the given key.
+     * @param key - The key to delete the value at
+     * @param val - The value to delete
+     */
+    deleteValue(key: K, val: V): Promise<void>;
+}
+export {};
 //# sourceMappingURL=map.d.ts.map

package/dest/interfaces/map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../src/interfaces/map.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC;IACxC;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAE3B;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC;IAErB;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;;;OAIG;IACH,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,SAAS,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D;;;;OAIG;IACH,cAAc,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjD;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B;;;OAGG;IACH,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAEpD;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAE9C;;;OAGG;IACH,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,CAAE,SAAQ,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IACrE;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAEvC;;;;OAIG;IACH,WAAW,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C"}
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../src/interfaces/map.ts"],"names":[],"mappings":"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"}

package/dest/interfaces/map_test_suite.d.ts

@@ -0,0 +1,3 @@
+import { type AztecAsyncKVStore, type AztecKVStore } from './store.js';
+export declare function describeAztecMap(testName: string, getStore: () => AztecKVStore | Promise<AztecAsyncKVStore>, forceAsync?: boolean): void;
+//# sourceMappingURL=map_test_suite.d.ts.map

package/dest/interfaces/map_test_suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map_test_suite.d.ts","sourceRoot":"","sources":["../../src/interfaces/map_test_suite.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAGvE,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,YAAY,GAAG,OAAO,CAAC,iBAAiB,CAAC,EACzD,UAAU,GAAE,OAAe,QAiJ5B"}