@aztec-labs/kv-store 6.0.0-nightly.20260829

package/dest/deprecated/indexeddb/singleton.d.ts

@@ -0,0 +1,17 @@
+import type { IDBPDatabase, IDBPObjectStore } from 'idb';
+import type { Value } from '../../interfaces/common.js';
+import type { AztecAsyncSingleton } from '../../interfaces/singleton.js';
+import type { AztecIDBSchema } from './store.js';
+/**
+ * Stores a single value in IndexedDB.
+ */
+export declare class IndexedDBAztecSingleton<T extends Value> implements AztecAsyncSingleton<T> {
+    #private;
+    constructor(rootDB: IDBPDatabase<AztecIDBSchema>, name: string);
+    set db(db: IDBPObjectStore<AztecIDBSchema, ['data'], 'data', 'readwrite'> | undefined);
+    get db(): IDBPObjectStore<AztecIDBSchema, ['data'], 'data', 'readwrite'>;
+    getAsync(): Promise<T | undefined>;
+    set(val: T): Promise<boolean>;
+    delete(): Promise<boolean>;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2luZ2xldG9uLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvZGVwcmVjYXRlZC9pbmRleGVkZGIvc2luZ2xldG9uLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLFlBQVksRUFBRSxlQUFlLEVBQUUsTUFBTSxLQUFLLENBQUM7QUFHekQsT0FBTyxLQUFLLEVBQUUsS0FBSyxFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUFDeEQsT0FBTyxLQUFLLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSwrQkFBK0IsQ0FBQztBQUN6RSxPQUFPLEtBQUssRUFBRSxjQUFjLEVBQUUsTUFBTSxZQUFZLENBQUM7QUFFakQ7O0dBRUc7QUFDSCxxQkFBYSx1QkFBdUIsQ0FBQyxDQUFDLFNBQVMsS0FBSyxDQUFFLFlBQVcsbUJBQW1CLENBQUMsQ0FBQyxDQUFDOztJQU1yRixZQUFZLE1BQU0sRUFBRSxZQUFZLENBQUMsY0FBYyxDQUFDLEVBQUUsSUFBSSxFQUFFLE1BQU0sRUFJN0Q7SUFFRCxJQUFJLEVBQUUsQ0FBQyxFQUFFLEVBQUUsZUFBZSxDQUFDLGNBQWMsRUFBRSxDQUFDLE1BQU0sQ0FBQyxFQUFFLE1BQU0sRUFBRSxXQUFXLENBQUMsR0FBRyxTQUFTLEVBRXBGO0lBRUQsSUFBSSxFQUFFLElBQUksZUFBZSxDQUFDLGNBQWMsRUFBRSxDQUFDLE1BQU0sQ0FBQyxFQUFFLE1BQU0sRUFBRSxXQUFXLENBQUMsQ0FFdkU7SUFFSyxRQUFRLElBQUksT0FBTyxDQUFDLENBQUMsR0FBRyxTQUFTLENBQUMsQ0FHdkM7SUFFSyxHQUFHLENBQUMsR0FBRyxFQUFFLENBQUMsR0FBRyxPQUFPLENBQUMsT0FBTyxDQUFDLENBVWxDO0lBRUssTUFBTSxJQUFJLE9BQU8sQ0FBQyxPQUFPLENBQUMsQ0FHL0I7Q0FDRiJ9

package/dest/deprecated/indexeddb/singleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleton.d.ts","sourceRoot":"","sources":["../../../src/deprecated/indexeddb/singleton.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,KAAK,CAAC;AAGzD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,qBAAa,uBAAuB,CAAC,CAAC,SAAS,KAAK,CAAE,YAAW,mBAAmB,CAAC,CAAC,CAAC;;IAMrF,YAAY,MAAM,EAAE,YAAY,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,MAAM,EAI7D;IAED,IAAI,EAAE,CAAC,EAAE,EAAE,eAAe,CAAC,cAAc,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,GAAG,SAAS,EAEpF;IAED,IAAI,EAAE,IAAI,eAAe,CAAC,cAAc,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAEvE;IAEK,QAAQ,IAAI,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAGvC;IAEK,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAUlC;IAEK,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAG/B;CACF"}

package/dest/deprecated/indexeddb/singleton.js

@@ -0,0 +1,41 @@
+import { hash } from 'ohash';
+/**
+ * Stores a single value in IndexedDB.
+ */ export class IndexedDBAztecSingleton {
+    #_db;
+    #rootDB;
+    #container;
+    #slot;
+    constructor(rootDB, name){
+        this.#rootDB = rootDB;
+        this.#container = `singleton:${name}`;
+        this.#slot = `singleton:${name}:value`;
+    }
+    set db(db) {
+        this.#_db = db;
+    }
+    get db() {
+        return this.#_db ? this.#_db : this.#rootDB.transaction('data', 'readwrite').store;
+    }
+    async getAsync() {
+        const data = await this.db.get(this.#slot);
+        return data?.value;
+    }
+    async set(val) {
+        const result = await this.db.put({
+            container: this.#container,
+            slot: this.#slot,
+            key: [
+                this.#slot
+            ],
+            keyCount: 1,
+            value: val,
+            hash: hash(val)
+        });
+        return result !== undefined;
+    }
+    async delete() {
+        await this.db.delete(this.#slot);
+        return true;
+    }
+}

package/dest/deprecated/indexeddb/store.d.ts

@@ -0,0 +1,98 @@
+import type { Logger } from '@aztec-labs/foundation/log';
+import { type DBSchema, type IDBPDatabase } from 'idb';
+import type { AztecAsyncArray } from '../../interfaces/array.js';
+import type { Key, StoreSize, Value } from '../../interfaces/common.js';
+import type { AztecAsyncCounter } from '../../interfaces/counter.js';
+import type { AztecAsyncMap } from '../../interfaces/map.js';
+import type { AztecAsyncMultiMap } from '../../interfaces/multi_map.js';
+import type { AztecAsyncSet } from '../../interfaces/set.js';
+import type { AztecAsyncSingleton } from '../../interfaces/singleton.js';
+import type { AztecAsyncKVStore } from '../../interfaces/store.js';
+export type StoredData<V extends Value> = {
+    value: V;
+    container: string;
+    key: (string | number | Uint8Array)[];
+    keyCount: number;
+    slot: string;
+    hash: string;
+};
+export interface AztecIDBSchema extends DBSchema {
+    data: {
+        value: StoredData<any>;
+        key: string;
+        indexes: {
+            container: string;
+            key: any;
+            keyCount: number;
+            hash: string;
+        };
+    };
+}
+/**
+ * A key-value store backed by IndexedDB.
+ *
+ * @deprecated The IndexedDB backend is being retired. Use `@aztec-labs/kv-store/sqlite-opfs` instead.
+ */
+export declare class AztecIndexedDBStore implements AztecAsyncKVStore {
+    #private;
+    readonly isEphemeral: boolean;
+    constructor(rootDB: IDBPDatabase<AztecIDBSchema>, isEphemeral: boolean, name: string);
+    /**
+     * 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 open(log: Logger, name?: string, ephemeral?: boolean): Promise<AztecIndexedDBStore>;
+    /**
+     * Creates a new AztecMap in the store.
+     * @param name - Name of the map
+     * @returns A new AztecMap
+     */
+    openMap<K extends Key, V extends Value>(name: string): AztecAsyncMap<K, V>;
+    /**
+     * Creates a new AztecSet in the store.
+     * @param name - Name of the set
+     * @returns A new AztecSet
+     */
+    openSet<K extends Key>(name: string): AztecAsyncSet<K>;
+    /**
+     * 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<K extends Key, V extends Value>(name: string): AztecAsyncMultiMap<K, V>;
+    openCounter<K extends Key>(_name: string): AztecAsyncCounter<K>;
+    /**
+     * Creates a new AztecArray in the store.
+     * @param name - Name of the array
+     * @returns A new AztecArray
+     */
+    openArray<T extends Value>(name: string): AztecAsyncArray<T>;
+    /**
+     * Creates a new AztecSingleton in the store.
+     * @param name - Name of the singleton
+     * @returns A new AztecSingleton
+     */
+    openSingleton<T extends Value>(name: string): AztecAsyncSingleton<T>;
+    /**
+     * 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
+     */
+    transactionAsync<T>(callback: () => Promise<T>): Promise<T>;
+    /**
+     * Clears all entries in the store & sub DBs.
+     */
+    clear(): Promise<void>;
+    /** Deletes this store and removes the database */
+    delete(): Promise<void>;
+    estimateSize(): Promise<StoreSize>;
+    close(): Promise<void>;
+    backupTo(_dstPath: string, _compact?: boolean): Promise<void>;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RvcmUuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9kZXByZWNhdGVkL2luZGV4ZWRkYi9zdG9yZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSw0QkFBNEIsQ0FBQztBQUV6RCxPQUFPLEVBQUUsS0FBSyxRQUFRLEVBQUUsS0FBSyxZQUFZLEVBQW9CLE1BQU0sS0FBSyxDQUFDO0FBRXpFLE9BQU8sS0FBSyxFQUFFLGVBQWUsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBQ2pFLE9BQU8sS0FBSyxFQUFFLEdBQUcsRUFBRSxTQUFTLEVBQUUsS0FBSyxFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUFDeEUsT0FBTyxLQUFLLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUNyRSxPQUFPLEtBQUssRUFBRSxhQUFhLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUM3RCxPQUFPLEtBQUssRUFBRSxrQkFBa0IsRUFBRSxNQUFNLCtCQUErQixDQUFDO0FBQ3hFLE9BQU8sS0FBSyxFQUFFLGFBQWEsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBQzdELE9BQU8sS0FBSyxFQUFFLG1CQUFtQixFQUFFLE1BQU0sK0JBQStCLENBQUM7QUFDekUsT0FBTyxLQUFLLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSwyQkFBMkIsQ0FBQztBQU9uRSxNQUFNLE1BQU0sVUFBVSxDQUFDLENBQUMsU0FBUyxLQUFLLElBQUk7SUFDeEMsS0FBSyxFQUFFLENBQUMsQ0FBQztJQUNULFNBQVMsRUFBRSxNQUFNLENBQUM7SUFDbEIsR0FBRyxFQUFFLENBQUMsTUFBTSxHQUFHLE1BQU0sR0FBRyxVQUFVLENBQUMsRUFBRSxDQUFDO0lBQ3RDLFFBQVEsRUFBRSxNQUFNLENBQUM7SUFDakIsSUFBSSxFQUFFLE1BQU0sQ0FBQztJQUNiLElBQUksRUFBRSxNQUFNLENBQUM7Q0FDZCxDQUFDO0FBRUYsTUFBTSxXQUFXLGNBQWUsU0FBUSxRQUFRO0lBQzlDLElBQUksRUFBRTtRQUNKLEtBQUssRUFBRSxVQUFVLENBQUMsR0FBRyxDQUFDLENBQUM7UUFDdkIsR0FBRyxFQUFFLE1BQU0sQ0FBQztRQUNaLE9BQU8sRUFBRTtZQUNQLFNBQVMsRUFBRSxNQUFNLENBQUM7WUFDbEIsR0FBRyxFQUFFLEdBQUcsQ0FBQztZQUNULFFBQVEsRUFBRSxNQUFNLENBQUM7WUFDakIsSUFBSSxFQUFFLE1BQU0sQ0FBQztTQUNkLENBQUM7S0FDSCxDQUFDO0NBQ0g7QUFFRDs7OztHQUlHO0FBQ0gscUJBQWEsbUJBQW9CLFlBQVcsaUJBQWlCOzthQWV6QyxXQUFXLEVBQUUsT0FBTztJQUZ0QyxZQUNFLE1BQU0sRUFBRSxZQUFZLENBQUMsY0FBYyxDQUFDLEVBQ3BCLFdBQVcsRUFBRSxPQUFPLEVBQ3BDLElBQUksRUFBRSxNQUFNLEVBTWI7SUFDRDs7Ozs7Ozs7O09BU0c7SUFDSCxPQUFhLElBQUksQ0FBQyxHQUFHLEVBQUUsTUFBTSxFQUFFLElBQUksQ0FBQyxFQUFFLE1BQU0sRUFBRSxTQUFTLEdBQUUsT0FBZSxHQUFHLE9BQU8sQ0FBQyxtQkFBbUIsQ0FBQyxDQW1CdEc7SUFFRDs7OztPQUlHO0lBQ0gsT0FBTyxDQUFDLENBQUMsU0FBUyxHQUFHLEVBQUUsQ0FBQyxTQUFTLEtBQUssRUFBRSxJQUFJLEVBQUUsTUFBTSxHQUFHLGFBQWEsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBSXpFO0lBRUQ7Ozs7T0FJRztJQUNILE9BQU8sQ0FBQyxDQUFDLFNBQVMsR0FBRyxFQUFFLElBQUksRUFBRSxNQUFNLEdBQUcsYUFBYSxDQUFDLENBQUMsQ0FBQyxDQUlyRDtJQUVEOzs7O09BSUc7SUFDSCxZQUFZLENBQUMsQ0FBQyxTQUFTLEdBQUcsRUFBRSxDQUFDLFNBQVMsS0FBSyxFQUFFLElBQUksRUFBRSxNQUFNLEdBQUcsa0JBQWtCLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUluRjtJQUVELFdBQVcsQ0FBQyxDQUFDLFNBQVMsR0FBRyxFQUFFLEtBQUssRUFBRSxNQUFNLEdBQUcsaUJBQWlCLENBQUMsQ0FBQyxDQUFDLENBRTlEO0lBRUQ7Ozs7T0FJRztJQUNILFNBQVMsQ0FBQyxDQUFDLFNBQVMsS0FBSyxFQUFFLElBQUksRUFBRSxNQUFNLEdBQUcsZUFBZSxDQUFDLENBQUMsQ0FBQyxDQUkzRDtJQUVEOzs7O09BSUc7SUFDSCxhQUFhLENBQUMsQ0FBQyxTQUFTLEtBQUssRUFBRSxJQUFJLEVBQUUsTUFBTSxHQUFHLG1CQUFtQixDQUFDLENBQUMsQ0FBQyxDQUluRTtJQUVEOzs7O09BSUc7SUFDSCxnQkFBZ0IsQ0FBQyxDQUFDLEVBQUUsUUFBUSxFQUFFLE1BQU0sT0FBTyxDQUFDLENBQUMsQ0FBQyxHQUFHLE9BQU8sQ0FBQyxDQUFDLENBQUMsQ0FxQjFEO0lBRUQ7O09BRUc7SUFDRyxLQUFLLGtCQUVWO0lBRUQsa0RBQWtEO0lBQzVDLE1BQU0sa0JBS1g7SUFFRCxZQUFZLElBQUksT0FBTyxDQUFDLFNBQVMsQ0FBQyxDQUVqQztJQUVLLEtBQUssSUFBSSxPQUFPLENBQUMsSUFBSSxDQUFDLENBRzNCO0lBRUQsUUFBUSxDQUFDLFFBQVEsRUFBRSxNQUFNLEVBQUUsUUFBUSxDQUFDLEVBQUUsT0FBTyxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FFNUQ7Q0FDRiJ9

package/dest/deprecated/indexeddb/store.d.ts.map

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

package/dest/deprecated/indexeddb/store.js

@@ -0,0 +1,171 @@
+import { SerialQueue } from '@aztec-labs/foundation/queue';
+import { deleteDB, openDB } from 'idb';
+import { IndexedDBAztecArray } from './array.js';
+import { IndexedDBAztecMap } from './map.js';
+import { IndexedDBAztecMultiMap } from './multi_map.js';
+import { IndexedDBAztecSet } from './set.js';
+import { IndexedDBAztecSingleton } from './singleton.js';
+/**
+ * A key-value store backed by IndexedDB.
+ *
+ * @deprecated The IndexedDB backend is being retired. Use `@aztec-labs/kv-store/sqlite-opfs` instead.
+ */ export class AztecIndexedDBStore {
+    isEphemeral;
+    #rootDB;
+    #name;
+    #txQueue;
+    #containers;
+    constructor(rootDB, isEphemeral, name){
+        this.isEphemeral = isEphemeral;
+        this.#containers = new Set();
+        this.#rootDB = rootDB;
+        this.#name = name;
+        this.#txQueue = new SerialQueue();
+        this.#txQueue.start();
+    }
+    /**
+   * 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 : globalThis.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
+                });
+                // Keep count of the maximum number of keys ever inserted in the container
+                // This allows unique slots for repeated keys, which is useful for multi-maps
+                objectStore.createIndex('keyCount', [
+                    'container',
+                    'key',
+                    'keyCount'
+                ], {
+                    unique: true
+                });
+                // Keep an index on the pair key-hash for a given container, allowing us to efficiently
+                // delete unique values from multi-maps
+                objectStore.createIndex('hash', [
+                    'container',
+                    'key',
+                    'hash'
+                ], {
+                    unique: true
+                });
+            }
+        });
+        const kvStore = new AztecIndexedDBStore(rootDB, ephemeral, name);
+        return kvStore;
+    }
+    /**
+   * Creates a new AztecMap in the store.
+   * @param name - Name of the map
+   * @returns A new AztecMap
+   */ openMap(name) {
+        const map = new IndexedDBAztecMap(this.#rootDB, name);
+        this.#containers.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(this.#rootDB, name);
+        this.#containers.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 IndexedDBAztecMultiMap(this.#rootDB, name);
+        this.#containers.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(this.#rootDB, name);
+        this.#containers.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(this.#rootDB, name);
+        this.#containers.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
+   */ transactionAsync(callback) {
+        // We can only have one transaction at a time for the same store
+        // So we need to wait for the current one to finish
+        return this.#txQueue.put(async ()=>{
+            const tx = this.#rootDB.transaction('data', 'readwrite');
+            for (const container of this.#containers){
+                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 this.#containers){
+                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 this.#rootDB.transaction('data', 'readwrite').store.clear();
+    }
+    /** Deletes this store and removes the database */ async delete() {
+        this.#containers.clear();
+        await this.#txQueue.end();
+        this.#rootDB.close();
+        await deleteDB(this.#name);
+    }
+    estimateSize() {
+        return Promise.resolve({
+            mappingSize: 0,
+            physicalFileSize: 0,
+            actualSize: 0,
+            numItems: 0
+        });
+    }
+    async close() {
+        await this.#txQueue.end();
+        this.#rootDB.close();
+    }
+    backupTo(_dstPath, _compact) {
+        throw new Error('Method not implemented.');
+    }
+}

package/dest/interfaces/array.d.ts

@@ -0,0 +1,81 @@
+import type { Value } from './common.js';
+/**
+ * An array backed by a persistent store. Can not have any holes in it.
+ */
+interface BaseAztecArray<T extends Value> {
+    /**
+     * Pushes values to the end of the array
+     * @param vals - The values to push to the end of the array
+     * @returns The new length of the array
+     */
+    push(...vals: T[]): Promise<number>;
+    /**
+     * Pops a value from the end of the array.
+     * @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 Value> 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.
+     *
+     * @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
+     */
+    atAsync(index: number): Promise<T | undefined>;
+    /**
+     * Iterates over the array with indexes.
+     */
+    entriesAsync(): AsyncIterableIterator<[number, T]>;
+    /**
+     * Iterates over the array.
+     */
+    valuesAsync(): AsyncIterableIterator<T>;
+    /**
+     * Iterates over the array.
+     */
+    [Symbol.asyncIterator](): AsyncIterableIterator<T>;
+}
+export interface AztecArray<T extends Value> 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.
+     */
+    entries(): IterableIterator<[number, T]>;
+    /**
+     * Iterates over the array.
+     */
+    values(): IterableIterator<T>;
+    /**
+     * Iterates over the array.
+     */
+    [Symbol.iterator](): IterableIterator<T>;
+}
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXJyYXkuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9pbnRlcmZhY2VzL2FycmF5LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLEtBQUssRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUV6Qzs7R0FFRztBQUNILFVBQVUsY0FBYyxDQUFDLENBQUMsU0FBUyxLQUFLO0lBQ3RDOzs7O09BSUc7SUFDSCxJQUFJLENBQUMsR0FBRyxJQUFJLEVBQUUsQ0FBQyxFQUFFLEdBQUcsT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQUFDO0lBRXBDOzs7T0FHRztJQUNILEdBQUcsSUFBSSxPQUFPLENBQUMsQ0FBQyxHQUFHLFNBQVMsQ0FBQyxDQUFDO0lBRTlCOzs7OztPQUtHO0lBQ0gsS0FBSyxDQUFDLEtBQUssRUFBRSxNQUFNLEVBQUUsR0FBRyxFQUFFLENBQUMsR0FBRyxPQUFPLENBQUMsT0FBTyxDQUFDLENBQUM7Q0FDaEQ7QUFFRDs7R0FFRztBQUNILE1BQU0sV0FBVyxlQUFlLENBQUMsQ0FBQyxTQUFTLEtBQUssQ0FBRSxTQUFRLGNBQWMsQ0FBQyxDQUFDLENBQUM7SUFDekU7O09BRUc7SUFDSCxXQUFXLElBQUksT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQUFDO0lBRS9COzs7Ozs7T0FNRztJQUNILE9BQU8sQ0FBQyxLQUFLLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0FBQyxDQUFDLEdBQUcsU0FBUyxDQUFDLENBQUM7SUFFL0M7O09BRUc7SUFDSCxZQUFZLElBQUkscUJBQXFCLENBQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQztJQUVuRDs7T0FFRztJQUNILFdBQVcsSUFBSSxxQkFBcUIsQ0FBQyxDQUFDLENBQUMsQ0FBQztJQUV4Qzs7T0FFRztJQUNILENBQUMsTUFBTSxDQUFDLGFBQWEsQ0FBQyxJQUFJLHFCQUFxQixDQUFDLENBQUMsQ0FBQyxDQUFDO0NBQ3BEO0FBRUQsTUFBTSxXQUFXLFVBQVUsQ0FBQyxDQUFDLFNBQVMsS0FBSyxDQUFFLFNBQVEsY0FBYyxDQUFDLENBQUMsQ0FBQztJQUNwRTs7T0FFRztJQUNILE1BQU0sRUFBRSxNQUFNLENBQUM7SUFFZjs7Ozs7O09BTUc7SUFDSCxFQUFFLENBQUMsS0FBSyxFQUFFLE1BQU0sR0FBRyxDQUFDLEdBQUcsU0FBUyxDQUFDO0lBRWpDOztPQUVHO0lBQ0gsT0FBTyxJQUFJLGdCQUFnQixDQUFDLENBQUMsTUFBTSxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFFekM7O09BRUc7SUFDSCxNQUFNLElBQUksZ0JBQWdCLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFFOUI7O09BRUc7SUFDSCxDQUFDLE1BQU0sQ0FBQyxRQUFRLENBQUMsSUFBSSxnQkFBZ0IsQ0FBQyxDQUFDLENBQUMsQ0FBQztDQUMxQyJ9

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

@@ -0,0 +1 @@
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../src/interfaces/array.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC;;GAEG;AACH,UAAU,cAAc,CAAC,CAAC,SAAS,KAAK;IACtC;;;;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,SAAS,KAAK,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IACzE;;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,SAAS,KAAK,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IACpE;;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.js

@@ -0,0 +1 @@
+export { };

package/dest/interfaces/array_test_suite.d.ts

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

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":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGlE,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,103 @@
+import { toArray } from '@aztec-labs/foundation/iterable';
+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()).toBe(3);
+            expect(await arr.pop()).toBe(3);
+            expect(await arr.pop()).toBe(2);
+            expect(await arr.pop()).toBe(1);
+            expect(await arr.pop()).toBe(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)).toBe(1);
+            expect(await at(1)).toBe(2);
+            expect(await at(2)).toBe(3);
+            expect(await at(3)).toBe(undefined);
+            expect(await at(-1)).toBe(3);
+            expect(await at(-2)).toBe(2);
+            expect(await at(-3)).toBe(1);
+            expect(await at(-4)).toBe(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)).toBe(true);
+            expect(await arr.setAt(1, 5)).toBe(true);
+            expect(await arr.setAt(2, 6)).toBe(true);
+            expect(await arr.setAt(3, 7)).toBe(false);
+            expect(await at(0)).toBe(4);
+            expect(await at(1)).toBe(5);
+            expect(await at(2)).toBe(6);
+            expect(await at(3)).toBe(undefined);
+            expect(await arr.setAt(-1, 8)).toBe(true);
+            expect(await arr.setAt(-2, 9)).toBe(true);
+            expect(await arr.setAt(-3, 10)).toBe(true);
+            expect(await arr.setAt(-4, 11)).toBe(false);
+            expect(await at(-1)).toBe(8);
+            expect(await at(-2)).toBe(9);
+            expect(await at(-3)).toBe(10);
+            expect(await at(-4)).toBe(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()).toEqual([
+                1,
+                2,
+                3
+            ]);
+            expect(await entries()).toEqual([
+                [
+                    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)).toBe(3);
+            expect(await values(arr2)).toEqual(await values());
+        });
+    });
+}

package/dest/interfaces/common.d.ts

@@ -0,0 +1,25 @@
+/** The key type for use with the kv-store */
+export type Key = string | number | Uint8Array | Array<string | number>;
+export type Value = NonNullable<any>;
+/** A range of keys of arbitrary type. */
+export type CustomRange<K> = {
+    /** The key of the first item to include */
+    start?: K;
+    /** The key of the last item to include */
+    end?: K;
+    /** Whether to iterate in reverse */
+    reverse?: boolean;
+    /** The maximum number of items to iterate over */
+    limit?: number;
+};
+/** Maps a custom range into a range of valid key types to iterate over. */
+export declare function mapRange<CK, K extends Key = Key>(range: CustomRange<CK>, mapFn: (key: CK) => K): Range<K>;
+/** A range of keys to iterate over. */
+export type Range<K extends Key = Key> = CustomRange<K>;
+export type StoreSize = {
+    mappingSize: number;
+    physicalFileSize: number;
+    actualSize: number;
+    numItems: number;
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29tbW9uLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW50ZXJmYWNlcy9jb21tb24udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsNkNBQTZDO0FBQzdDLE1BQU0sTUFBTSxHQUFHLEdBQUcsTUFBTSxHQUFHLE1BQU0sR0FBRyxVQUFVLEdBQUcsS0FBSyxDQUFDLE1BQU0sR0FBRyxNQUFNLENBQUMsQ0FBQztBQUV4RSxNQUFNLE1BQU0sS0FBSyxHQUFHLFdBQVcsQ0FBQyxHQUFHLENBQUMsQ0FBQztBQUVyQyx5Q0FBeUM7QUFDekMsTUFBTSxNQUFNLFdBQVcsQ0FBQyxDQUFDLElBQUk7SUFDM0IsMkNBQTJDO0lBQzNDLEtBQUssQ0FBQyxFQUFFLENBQUMsQ0FBQztJQUNWLDBDQUEwQztJQUMxQyxHQUFHLENBQUMsRUFBRSxDQUFDLENBQUM7SUFDUixvQ0FBb0M7SUFDcEMsT0FBTyxDQUFDLEVBQUUsT0FBTyxDQUFDO0lBQ2xCLGtEQUFrRDtJQUNsRCxLQUFLLENBQUMsRUFBRSxNQUFNLENBQUM7Q0FDaEIsQ0FBQztBQUVGLDJFQUEyRTtBQUMzRSx3QkFBZ0IsUUFBUSxDQUFDLEVBQUUsRUFBRSxDQUFDLFNBQVMsR0FBRyxHQUFHLEdBQUcsRUFBRSxLQUFLLEVBQUUsV0FBVyxDQUFDLEVBQUUsQ0FBQyxFQUFFLEtBQUssRUFBRSxDQUFDLEdBQUcsRUFBRSxFQUFFLEtBQUssQ0FBQyxHQUFHLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FPekc7QUFFRCx1Q0FBdUM7QUFDdkMsTUFBTSxNQUFNLEtBQUssQ0FBQyxDQUFDLFNBQVMsR0FBRyxHQUFHLEdBQUcsSUFBSSxXQUFXLENBQUMsQ0FBQyxDQUFDLENBQUM7QUFFeEQsTUFBTSxNQUFNLFNBQVMsR0FBRztJQUFFLFdBQVcsRUFBRSxNQUFNLENBQUM7SUFBQyxnQkFBZ0IsRUFBRSxNQUFNLENBQUM7SUFBQyxVQUFVLEVBQUUsTUFBTSxDQUFDO0lBQUMsUUFBUSxFQUFFLE1BQU0sQ0FBQTtDQUFFLENBQUMifQ==

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

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/interfaces/common.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,MAAM,MAAM,GAAG,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;AAExE,MAAM,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;AAErC,yCAAyC;AACzC,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAC3B,2CAA2C;IAC3C,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,0CAA0C;IAC1C,GAAG,CAAC,EAAE,CAAC,CAAC;IACR,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,2EAA2E;AAC3E,wBAAgB,QAAQ,CAAC,EAAE,EAAE,CAAC,SAAS,GAAG,GAAG,GAAG,EAAE,KAAK,EAAE,WAAW,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAOzG;AAED,uCAAuC;AACvC,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;AAExD,MAAM,MAAM,SAAS,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dest/interfaces/common.js

@@ -0,0 +1,8 @@
+/** The key type for use with the kv-store */ /** Maps a custom range into a range of valid key types to iterate over. */ export function mapRange(range, mapFn) {
+    return {
+        start: range.start ? mapFn(range.start) : undefined,
+        end: range.end ? mapFn(range.end) : undefined,
+        reverse: range.reverse,
+        limit: range.limit
+    };
+}

package/dest/interfaces/counter.d.ts

@@ -0,0 +1,59 @@
+import type { Key, Range } from './common.js';
+/**
+ * A map that counts how many times it sees a key. Once 0 is reached,  that key is removed from the map.
+ * Iterating over the map will only return keys that have a count over 0.
+ *
+ * Keys are stored in sorted order
+ */
+interface AztecBaseCounter<K extends Key = Key> {
+    /**
+     * Resets the count of the given key to the given value.
+     * @param key - The key to reset
+     * @param value - The value to reset the key to
+     */
+    set(key: K, value: number): Promise<void>;
+    /**
+     * Updates the count of the given key by the given delta. This can be used to increment or decrement the count.
+     * Once a key's count reaches 0, it is removed from the map.
+     *
+     * @param key - The key to update
+     * @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
+     */
+    get(key: K): 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
+     */
+    keys(range: Range<K>): IterableIterator<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
+     */
+    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=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY291bnRlci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2ludGVyZmFjZXMvY291bnRlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxHQUFHLEVBQUUsS0FBSyxFQUFFLE1BQU0sYUFBYSxDQUFDO0FBRTlDOzs7OztHQUtHO0FBQ0gsVUFBVSxnQkFBZ0IsQ0FBQyxDQUFDLFNBQVMsR0FBRyxHQUFHLEdBQUc7SUFDNUM7Ozs7T0FJRztJQUNILEdBQUcsQ0FBQyxHQUFHLEVBQUUsQ0FBQyxFQUFFLEtBQUssRUFBRSxNQUFNLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBRTFDOzs7Ozs7T0FNRztJQUNILE1BQU0sQ0FBQyxHQUFHLEVBQUUsQ0FBQyxFQUFFLEtBQUssRUFBRSxNQUFNLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO0NBQzlDO0FBRUQsTUFBTSxXQUFXLFlBQVksQ0FBQyxDQUFDLFNBQVMsR0FBRyxHQUFHLEdBQUcsQ0FBRSxTQUFRLGdCQUFnQixDQUFDLENBQUMsQ0FBQztJQUM1RTs7O09BR0c7SUFDSCxHQUFHLENBQUMsR0FBRyxFQUFFLENBQUMsR0FBRyxNQUFNLENBQUM7SUFFcEI7OztPQUdHO0lBQ0gsSUFBSSxDQUFDLEtBQUssRUFBRSxLQUFLLENBQUMsQ0FBQyxDQUFDLEdBQUcsZ0JBQWdCLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFFM0M7OztPQUdHO0lBQ0gsT0FBTyxDQUFDLEtBQUssRUFBRSxLQUFLLENBQUMsQ0FBQyxDQUFDLEdBQUcsZ0JBQWdCLENBQUMsQ0FBQyxDQUFDLEVBQUUsTUFBTSxDQUFDLENBQUMsQ0FBQztDQUN6RDtBQUVELE1BQU0sV0FBVyxpQkFBaUIsQ0FBQyxDQUFDLFNBQVMsR0FBRyxHQUFHLEdBQUcsQ0FBRSxTQUFRLGdCQUFnQixDQUFDLENBQUMsQ0FBQztJQUNqRjs7O09BR0c7SUFDSCxRQUFRLENBQUMsR0FBRyxFQUFFLENBQUMsR0FBRyxPQUFPLENBQUMsTUFBTSxDQUFDLENBQUM7SUFFbEM7OztPQUdHO0lBQ0gsU0FBUyxDQUFDLEtBQUssRUFBRSxLQUFLLENBQUMsQ0FBQyxDQUFDLEdBQUcscUJBQXFCLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFFckQ7OztPQUdHO0lBQ0gsWUFBWSxDQUFDLEtBQUssRUFBRSxLQUFLLENBQUMsQ0FBQyxDQUFDLEdBQUcscUJBQXFCLENBQUMsQ0FBQyxDQUFDLEVBQUUsTUFBTSxDQUFDLENBQUMsQ0FBQztDQUNuRSJ9

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

@@ -0,0 +1 @@
+{"version":3,"file":"counter.d.ts","sourceRoot":"","sources":["../../src/interfaces/counter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;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"}