@aztec/kv-store 0.0.0-test.0

package/dest/interfaces/map_test_suite.js

@@ -0,0 +1,151 @@
+import { toArray } from '@aztec/foundation/iterable';
+import { expect } from 'chai';
+import { isSyncStore } from './utils.js';
+export function describeAztecMap(testName, getStore, forceAsync = false) {
+    describe(testName, ()=>{
+        let store;
+        let map;
+        beforeEach(async ()=>{
+            store = await getStore();
+            map = store.openMultiMap('test');
+        });
+        afterEach(async ()=>{
+            await store.delete();
+        });
+        async function get(key, sut = map) {
+            return isSyncStore(store) && !forceAsync ? sut.get(key) : await sut.getAsync(key);
+        }
+        async function entries() {
+            return isSyncStore(store) && !forceAsync ? await toArray(map.entries()) : await toArray(map.entriesAsync());
+        }
+        async function values() {
+            return isSyncStore(store) && !forceAsync ? await toArray(map.values()) : await toArray(map.valuesAsync());
+        }
+        async function keys(range, sut = map) {
+            return isSyncStore(store) && !forceAsync ? await toArray(sut.keys(range)) : await toArray(sut.keysAsync(range));
+        }
+        async function getValues(key) {
+            return isSyncStore(store) && !forceAsync ? await toArray(map.getValues(key)) : await toArray(map.getValuesAsync(key));
+        }
+        it('should be able to set and get values', async ()=>{
+            await map.set('foo', 'bar');
+            await map.set('baz', 'qux');
+            expect(await get('foo')).to.equal('bar');
+            expect(await get('baz')).to.equal('qux');
+            expect(await get('quux')).to.equal(undefined);
+        });
+        it('should be able to set values if they do not exist', async ()=>{
+            expect(await map.setIfNotExists('foo', 'bar')).to.equal(true);
+            expect(await map.setIfNotExists('foo', 'baz')).to.equal(false);
+            expect(await get('foo')).to.equal('bar');
+        });
+        it('should be able to delete values', async ()=>{
+            await map.set('foo', 'bar');
+            await map.set('baz', 'qux');
+            await map.delete('foo');
+            expect(await get('foo')).to.equal(undefined);
+            expect(await get('baz')).to.equal('qux');
+        });
+        it('should be able to iterate over entries when there are no keys', async ()=>{
+            expect(await entries()).to.deep.equal([]);
+        });
+        it('should be able to iterate over entries', async ()=>{
+            await map.set('foo', 'bar');
+            await map.set('baz', 'qux');
+            expect(await entries()).to.deep.equal([
+                [
+                    'baz',
+                    'qux'
+                ],
+                [
+                    'foo',
+                    'bar'
+                ]
+            ]);
+        });
+        it('should be able to iterate over values', async ()=>{
+            await map.set('foo', 'bar');
+            await map.set('baz', 'quux');
+            expect(await values()).to.deep.equal([
+                'quux',
+                'bar'
+            ]);
+        });
+        it('should be able to iterate over keys', async ()=>{
+            await map.set('foo', 'bar');
+            await map.set('baz', 'qux');
+            expect(await keys()).to.deep.equal([
+                'baz',
+                'foo'
+            ]);
+        });
+        it('should be able to get multiple values for a single key', async ()=>{
+            await map.set('foo', 'bar');
+            await map.set('foo', 'baz');
+            expect(await getValues('foo')).to.deep.equal([
+                'bar',
+                'baz'
+            ]);
+        });
+        it('should be able to delete individual values for a single key', async ()=>{
+            await map.set('foo', 'bar');
+            await map.set('foo', 'baz');
+            await map.deleteValue('foo', 'bar');
+            expect(await getValues('foo')).to.deep.equal([
+                'baz'
+            ]);
+        });
+        it('supports range queries', async ()=>{
+            await map.set('a', 'a');
+            await map.set('b', 'b');
+            await map.set('c', 'c');
+            await map.set('d', 'd');
+            expect(await keys({
+                start: 'b',
+                end: 'c'
+            })).to.deep.equal([
+                'b'
+            ]);
+            expect(await keys({
+                start: 'b'
+            })).to.deep.equal([
+                'b',
+                'c',
+                'd'
+            ]);
+            expect(await keys({
+                end: 'c'
+            })).to.deep.equal([
+                'a',
+                'b'
+            ]);
+            expect(await keys({
+                start: 'b',
+                end: 'c',
+                reverse: true
+            })).to.deep.equal([
+                'c'
+            ]);
+            expect(await keys({
+                start: 'b',
+                limit: 1
+            })).to.deep.equal([
+                'b'
+            ]);
+            expect(await keys({
+                start: 'b',
+                reverse: true
+            })).to.deep.equal([
+                'd',
+                'c'
+            ]);
+            expect(await keys({
+                end: 'b',
+                reverse: true
+            })).to.deep.equal([
+                'b',
+                'a'
+            ]);
+        });
+    });
+}

package/dest/interfaces/set.d.ts

@@ -0,0 +1,44 @@
+import type { Key, Range } from './common.js';
+/**
+ * A set backed by a persistent store.
+ */
+interface AztecBaseSet<K extends Key> {
+    /**
+     * Adds the given value.
+     * @param key - The key to add.
+     */
+    add(key: K): Promise<void>;
+    /**
+     * Deletes the given key.
+     * @param key - The key to delete.
+     */
+    delete(key: K): Promise<void>;
+}
+export interface AztecSet<K extends Key> extends AztecBaseSet<K> {
+    /**
+     * Checks if a key exists in the set.
+     * @param key - The key to check
+     * @returns True if the key exists, false otherwise
+     */
+    has(key: K): boolean;
+    /**
+     * Iterates over the sets's keys entries in the key's natural order
+     * @param range - The range of keys to iterate over
+     */
+    entries(range?: Range<K>): IterableIterator<K>;
+}
+export interface AztecAsyncSet<K extends Key> extends AztecBaseSet<K> {
+    /**
+     * Checks if a key exists in the set.
+     * @param key - The key to check
+     * @returns True if the key exists, false otherwise
+     */
+    hasAsync(key: K): Promise<boolean>;
+    /**
+     * Iterates over the sets's keys entries in the key's natural order
+     * @param range - The range of keys to iterate over
+     */
+    entriesAsync(range?: Range<K>): AsyncIterableIterator<K>;
+}
+export {};
+//# sourceMappingURL=set.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../src/interfaces/set.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAE9C;;GAEG;AACH,UAAU,YAAY,CAAC,CAAC,SAAS,GAAG;IAClC;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3B;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,GAAG,CAAE,SAAQ,YAAY,CAAC,CAAC,CAAC;IAC9D;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC;IAErB;;;OAGG;IACH,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,GAAG,CAAE,SAAQ,YAAY,CAAC,CAAC,CAAC;IACnE;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnC;;;OAGG;IACH,YAAY,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAC;CAC1D"}

package/dest/interfaces/set.js

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

package/dest/interfaces/set_test_suite.d.ts

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

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

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

package/dest/interfaces/set_test_suite.js

@@ -0,0 +1,96 @@
+import { toArray } from '@aztec/foundation/iterable';
+import { expect } from 'chai';
+import { isSyncStore } from './utils.js';
+export function describeAztecSet(testName, getStore, forceAsync = false) {
+    describe(testName, ()=>{
+        let store;
+        let set;
+        beforeEach(async ()=>{
+            store = await getStore();
+            set = store.openSet('test');
+        });
+        afterEach(async ()=>{
+            await store.delete();
+        });
+        async function has(key) {
+            return isSyncStore(store) && !forceAsync ? set.has(key) : await set.hasAsync(key);
+        }
+        async function entries(range) {
+            return isSyncStore(store) && !forceAsync ? await toArray(set.entries(range)) : await toArray(set.entriesAsync(range));
+        }
+        it('should be able to set and get values', async ()=>{
+            await set.add('foo');
+            await set.add('baz');
+            expect(await has('foo')).to.equal(true);
+            expect(await has('baz')).to.equal(true);
+            expect(await has('bar')).to.equal(false);
+        });
+        it('should be able to delete values', async ()=>{
+            await set.add('foo');
+            await set.add('baz');
+            await set.delete('foo');
+            expect(await has('foo')).to.equal(false);
+            expect(await has('baz')).to.equal(true);
+        });
+        it('should be able to iterate over entries', async ()=>{
+            await set.add('baz');
+            await set.add('foo');
+            expect(await entries()).to.deep.equal([
+                'baz',
+                'foo'
+            ]);
+        });
+        it('supports range queries', async ()=>{
+            await set.add('a');
+            await set.add('b');
+            await set.add('c');
+            await set.add('d');
+            expect(await entries({
+                start: 'b',
+                end: 'c'
+            })).to.deep.equal([
+                'b'
+            ]);
+            expect(await entries({
+                start: 'b'
+            })).to.deep.equal([
+                'b',
+                'c',
+                'd'
+            ]);
+            expect(await entries({
+                end: 'c'
+            })).to.deep.equal([
+                'a',
+                'b'
+            ]);
+            expect(await entries({
+                start: 'b',
+                end: 'c',
+                reverse: true
+            })).to.deep.equal([
+                'c'
+            ]);
+            expect(await entries({
+                start: 'b',
+                limit: 1
+            })).to.deep.equal([
+                'b'
+            ]);
+            expect(await entries({
+                start: 'b',
+                reverse: true
+            })).to.deep.equal([
+                'd',
+                'c'
+            ]);
+            expect(await entries({
+                end: 'b',
+                reverse: true
+            })).to.deep.equal([
+                'b',
+                'a'
+            ]);
+        });
+    });
+}

package/dest/interfaces/singleton.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Represents a singleton value in the database.
+ * Note: The singleton loses type info so it's recommended to serialize to buffer when storing it.
+ */
+interface AztecBaseSingleton<T> {
+    /**
+     * Sets the value.
+     * @param val - The new value
+     */
+    set(val: T): Promise<boolean>;
+    /**
+     * Deletes the value.
+     */
+    delete(): Promise<boolean>;
+}
+export interface AztecSingleton<T> extends AztecBaseSingleton<T> {
+    /**
+     * Gets the value.
+     */
+    get(): T | undefined;
+}
+export interface AztecAsyncSingleton<T> extends AztecBaseSingleton<T> {
+    /**
+     * Gets the value.
+     */
+    getAsync(): Promise<T | undefined>;
+}
+export {};
+//# sourceMappingURL=singleton.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"singleton.d.ts","sourceRoot":"","sources":["../../src/interfaces/singleton.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,UAAU,kBAAkB,CAAC,CAAC;IAC5B;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9B;;OAEG;IACH,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5B;AACD,MAAM,WAAW,cAAc,CAAC,CAAC,CAAE,SAAQ,kBAAkB,CAAC,CAAC,CAAC;IAC9D;;OAEG;IACH,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC,CAAE,SAAQ,kBAAkB,CAAC,CAAC,CAAC;IACnE;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;CACpC"}

package/dest/interfaces/singleton.js

@@ -0,0 +1,4 @@
+/**
+ * Represents a singleton value in the database.
+ * Note: The singleton loses type info so it's recommended to serialize to buffer when storing it.
+ */ export { };

package/dest/interfaces/singleton_test_suite.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"singleton_test_suite.d.ts","sourceRoot":"","sources":["../../src/interfaces/singleton_test_suite.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGlE,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,YAAY,GAAG,OAAO,CAAC,iBAAiB,CAAC,EACzD,UAAU,GAAE,OAAe,QAoC5B"}

package/dest/interfaces/singleton_test_suite.js

@@ -0,0 +1,30 @@
+import { expect } from 'chai';
+import { isSyncStore } from './utils.js';
+export function describeAztecSingleton(testName, getStore, forceAsync = false) {
+    describe(testName, ()=>{
+        let store;
+        let singleton;
+        beforeEach(async ()=>{
+            store = await getStore();
+            singleton = store.openSingleton('test');
+        });
+        afterEach(async ()=>{
+            await store.delete();
+        });
+        async function get() {
+            return isSyncStore(store) && !forceAsync ? singleton.get() : await singleton.getAsync();
+        }
+        it('returns undefined if the value is not set', async ()=>{
+            expect(await get()).to.equal(undefined);
+        });
+        it('should be able to set and get values', async ()=>{
+            expect(await singleton.set('foo')).to.equal(true);
+            expect(await get()).to.equal('foo');
+        });
+        it('overwrites the value if it is set again', async ()=>{
+            expect(await singleton.set('foo')).to.equal(true);
+            expect(await singleton.set('bar')).to.equal(true);
+            expect(await get()).to.equal('bar');
+        });
+    });
+}

package/dest/interfaces/store.d.ts

@@ -0,0 +1,145 @@
+import type { AztecArray, AztecAsyncArray } from './array.js';
+import type { Key, StoreSize } from './common.js';
+import type { AztecAsyncCounter, AztecCounter } from './counter.js';
+import type { AztecAsyncMap, AztecAsyncMultiMap, AztecMap, AztecMapWithSize, AztecMultiMap, AztecMultiMapWithSize } from './map.js';
+import type { AztecAsyncSet, AztecSet } from './set.js';
+import type { AztecAsyncSingleton, AztecSingleton } from './singleton.js';
+/** A key-value store */
+export interface AztecKVStore {
+    syncGetters: true;
+    /**
+     * Creates a new map.
+     * @param name - The name of the map
+     * @returns The map
+     */
+    openMap<K extends Key, V>(name: string): AztecMap<K, V>;
+    /**
+     * Creates a new set.
+     * @param name - The name of the set
+     * @returns The set
+     */
+    openSet<K extends Key>(name: string): AztecSet<K>;
+    /**
+     * Creates a new multi-map.
+     * @param name - The name of the multi-map
+     * @returns The multi-map
+     */
+    openMultiMap<K extends Key, V>(name: string): AztecMultiMap<K, V>;
+    /**
+     * Creates a new multi-map with size.
+     * @param name - The name of the multi-map
+     * @returns The multi-map
+     */
+    openMultiMapWithSize<K extends Key, V>(name: string): AztecMultiMapWithSize<K, V>;
+    /**
+     * Creates a new map with size.
+     * @param name - The name of the map
+     * @returns The map
+     */
+    openMapWithSize<K extends Key, V>(name: string): AztecMapWithSize<K, V>;
+    /**
+     * Creates a new array.
+     * @param name - The name of the array
+     * @returns The array
+     */
+    openArray<T>(name: string): AztecArray<T>;
+    /**
+     * Creates a new singleton.
+     * @param name - The name of the singleton
+     * @returns The singleton
+     */
+    openSingleton<T>(name: string): AztecSingleton<T>;
+    /**
+     * Creates a new count map.
+     * @param name - name of the counter
+     */
+    openCounter<K extends Key>(name: string): AztecCounter<K>;
+    /**
+     * Starts a transaction. All calls to read/write data while in a transaction are queued and executed atomically.
+     * @param callback - The callback to execute in a transaction
+     */
+    transaction<T extends Exclude<any, Promise<any>>>(callback: () => T): Promise<T>;
+    /**
+     * Clears all entries in the store
+     */
+    clear(): Promise<void>;
+    /**
+     * Forks the store.
+     */
+    fork(): Promise<AztecKVStore>;
+    /**
+     * Deletes the store
+     */
+    delete(): Promise<void>;
+    /**
+     * Estimates the size of the store in bytes.
+     */
+    estimateSize(): Promise<StoreSize>;
+    /**
+     * Closes the store
+     */
+    close(): Promise<void>;
+}
+export interface AztecAsyncKVStore {
+    /**
+     * Creates a new map.
+     * @param name - The name of the map
+     * @returns The map
+     */
+    openMap<K extends Key, V>(name: string): AztecAsyncMap<K, V>;
+    /**
+     * Creates a new set.
+     * @param name - The name of the set
+     * @returns The set
+     */
+    openSet<K extends Key>(name: string): AztecAsyncSet<K>;
+    /**
+     * Creates a new multi-map.
+     * @param name - The name of the multi-map
+     * @returns The multi-map
+     */
+    openMultiMap<K extends Key, V>(name: string): AztecAsyncMultiMap<K, V>;
+    /**
+     * Creates a new array.
+     * @param name - The name of the array
+     * @returns The array
+     */
+    openArray<T>(name: string): AztecAsyncArray<T>;
+    /**
+     * Creates a new singleton.
+     * @param name - The name of the singleton
+     * @returns The singleton
+     */
+    openSingleton<T>(name: string): AztecAsyncSingleton<T>;
+    /**
+     * Creates a new count map.
+     * @param name - name of the counter
+     */
+    openCounter<K extends Key>(name: string): AztecAsyncCounter<K>;
+    /**
+     * Starts a transaction. All calls to read/write data while in a transaction are queued and executed atomically.
+     * @param callback - The callback to execute in a transaction
+     */
+    transactionAsync<T extends Exclude<any, Promise<any>>>(callback: () => Promise<T>): Promise<T>;
+    /**
+     * Clears all entries in the store
+     */
+    clear(): Promise<void>;
+    /**
+     * Forks the store.
+     */
+    fork(): Promise<AztecAsyncKVStore>;
+    /**
+     * Deletes the store
+     */
+    delete(): Promise<void>;
+    /**
+     * Estimates the size of the store in bytes.
+     */
+    estimateSize(): Promise<StoreSize>;
+    /**
+     * Closes the store
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=store.d.ts.map

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

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

package/dest/interfaces/store.js

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

package/dest/interfaces/store_test_suite.d.ts

@@ -0,0 +1,3 @@
+import type { AztecAsyncKVStore, AztecKVStore } from './store.js';
+export declare function describeAztecStore(testName: string, getPersistentStore: () => Promise<AztecKVStore | AztecAsyncKVStore>, getPersistentNoPathStore: () => Promise<AztecKVStore | AztecAsyncKVStore>, getEphemeralStore: () => Promise<AztecKVStore | AztecAsyncKVStore>): void;
+//# sourceMappingURL=store_test_suite.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store_test_suite.d.ts","sourceRoot":"","sources":["../../src/interfaces/store_test_suite.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGlE,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,kBAAkB,EAAE,MAAM,OAAO,CAAC,YAAY,GAAG,iBAAiB,CAAC,EACnE,wBAAwB,EAAE,MAAM,OAAO,CAAC,YAAY,GAAG,iBAAiB,CAAC,EACzE,iBAAiB,EAAE,MAAM,OAAO,CAAC,YAAY,GAAG,iBAAiB,CAAC,QA6CnE"}

package/dest/interfaces/store_test_suite.js

@@ -0,0 +1,37 @@
+import { expect } from 'chai';
+import { isSyncStore } from './utils.js';
+export function describeAztecStore(testName, getPersistentStore, getPersistentNoPathStore, getEphemeralStore) {
+    describe(testName, ()=>{
+        async function get(store, singleton) {
+            return isSyncStore(store) ? singleton.get() : await singleton.getAsync();
+        }
+        const itForks = async (store)=>{
+            const singleton = store.openSingleton('singleton');
+            await singleton.set('foo');
+            const forkedStore = await store.fork();
+            const forkedSingleton = forkedStore.openSingleton('singleton');
+            expect(await get(store, singleton)).to.equal('foo');
+            await forkedSingleton.set('bar');
+            expect(await get(store, singleton)).to.equal('foo');
+            expect(await get(forkedStore, forkedSingleton)).to.equal('bar');
+            await forkedSingleton.delete();
+            expect(await get(store, singleton)).to.equal('foo');
+            await forkedStore.delete();
+        };
+        it('forks a persistent store', async ()=>{
+            const store = await getPersistentStore();
+            await itForks(store);
+            await store.delete();
+        });
+        it('forks a persistent store with no path', async ()=>{
+            const store = await getPersistentNoPathStore();
+            await itForks(store);
+            await store.delete();
+        });
+        it('forks an ephemeral store', async ()=>{
+            const store = await getEphemeralStore();
+            await itForks(store);
+            await store.delete();
+        });
+    });
+}

package/dest/interfaces/utils.d.ts

@@ -0,0 +1,16 @@
+import type { AztecAsyncKVStore, AztecKVStore } from './store.js';
+export declare const mockLogger: {
+    debug: (msg: string, data: any) => void;
+    info: (msg: string, data: any) => void;
+    warn: (msg: string, data: any) => void;
+    error: (msg: string, data: any) => void;
+    fatal: (msg: string, data: any) => void;
+    silent: (_msg: string, _data: any) => void;
+    verbose: (msg: string, data: any) => void;
+    trace: (msg: string, data: any) => void;
+    level: "trace";
+    isLevelEnabled: (_level: string) => boolean;
+    module: string;
+};
+export declare function isSyncStore(store: AztecKVStore | AztecAsyncKVStore): store is AztecAsyncKVStore;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/interfaces/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGlE,eAAO,MAAM,UAAU;iBACR,MAAM,QAAQ,GAAG;gBAClB,MAAM,QAAQ,GAAG;gBACjB,MAAM,QAAQ,GAAG;iBAChB,MAAM,QAAQ,GAAG;iBACjB,MAAM,QAAQ,GAAG;mBACf,MAAM,SAAS,GAAG;mBAClB,MAAM,QAAQ,GAAG;iBACnB,MAAM,QAAQ,GAAG;;6BAEL,MAAM;;CAEhC,CAAC;AAGF,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,iBAAiB,GAAG,KAAK,IAAI,iBAAiB,CAE/F"}

package/dest/interfaces/utils.js

@@ -0,0 +1,16 @@
+/* eslint-disable no-console */ export const mockLogger = {
+    debug: (msg, data)=>console.log(msg, data),
+    info: (msg, data)=>console.log(msg, data),
+    warn: (msg, data)=>console.log(msg, data),
+    error: (msg, data)=>console.error(msg, data),
+    fatal: (msg, data)=>console.error(msg, data),
+    silent: (_msg, _data)=>{},
+    verbose: (msg, data)=>console.log(msg, data),
+    trace: (msg, data)=>console.log(msg, data),
+    level: 'trace',
+    isLevelEnabled: (_level)=>true,
+    module: 'kv-store:mock-logger'
+};
+/* eslint-enable no-console */ export function isSyncStore(store) {
+    return store.syncGetters === true;
+}

package/dest/lmdb/array.d.ts

@@ -0,0 +1,23 @@
+import type { Database, Key } from 'lmdb';
+import type { AztecArray, AztecAsyncArray } from '../interfaces/array.js';
+/**
+ * An persistent array backed by LMDB.
+ */
+export declare class LmdbAztecArray<T> implements AztecArray<T>, AztecAsyncArray<T> {
+    #private;
+    constructor(db: Database<unknown, Key>, arrName: string);
+    get length(): number;
+    lengthAsync(): Promise<number>;
+    push(...vals: T[]): Promise<number>;
+    pop(): Promise<T | undefined>;
+    at(index: number): T | undefined;
+    atAsync(index: number): Promise<T | undefined>;
+    setAt(index: number, val: T): Promise<boolean>;
+    entries(): IterableIterator<[number, T]>;
+    entriesAsync(): AsyncIterableIterator<[number, T]>;
+    values(): IterableIterator<T>;
+    valuesAsync(): AsyncIterableIterator<T>;
+    [Symbol.iterator](): IterableIterator<T>;
+    [Symbol.asyncIterator](): AsyncIterableIterator<T>;
+}
+//# sourceMappingURL=array.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../src/lmdb/array.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAE1C,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAM1E;;GAEG;AACH,qBAAa,cAAc,CAAC,CAAC,CAAE,YAAW,UAAU,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC;;gBAK7D,EAAE,EAAE,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,MAAM;IAMvD,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAI9B,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAcnC,GAAG,IAAI,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAiB7B,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAchC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAI9C,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAY7C,OAAO,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAkBlC,YAAY,IAAI,qBAAqB,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAMxD,MAAM,IAAI,gBAAgB,CAAC,CAAC,CAAC;IAMvB,WAAW,IAAI,qBAAqB,CAAC,CAAC,CAAC;IAM9C,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,CAAC,CAAC;IAIxC,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,CAAC,CAAC;CAOnD"}