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

package/dest/lmdb/multi_map.d.ts

@@ -0,0 +1,13 @@
+import type { Key, Value } from '../interfaces/common.js';
+import type { AztecAsyncMultiMap, AztecMultiMap } from '../interfaces/multi_map.js';
+import { LmdbAztecMap } from './map.js';
+/**
+ * A map backed by LMDB.
+ */
+export declare class LmdbAztecMultiMap<K extends Key, V extends Value> extends LmdbAztecMap<K, V> implements AztecMultiMap<K, V>, AztecAsyncMultiMap<K, V> {
+    getValues(key: K): IterableIterator<V>;
+    getValuesAsync(key: K): AsyncIterableIterator<V>;
+    getValueCountAsync(key: K): Promise<number>;
+    deleteValue(key: K, val: V): Promise<void>;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibXVsdGlfbWFwLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbG1kYi9tdWx0aV9tYXAudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsR0FBRyxFQUFFLEtBQUssRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBQzFELE9BQU8sS0FBSyxFQUFFLGtCQUFrQixFQUFFLGFBQWEsRUFBRSxNQUFNLDRCQUE0QixDQUFDO0FBQ3BGLE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSxVQUFVLENBQUM7QUFFeEM7O0dBRUc7QUFDSCxxQkFBYSxpQkFBaUIsQ0FBQyxDQUFDLFNBQVMsR0FBRyxFQUFFLENBQUMsU0FBUyxLQUFLLENBQzNELFNBQVEsWUFBWSxDQUFDLENBQUMsRUFBRSxDQUFDLENBQ3pCLFlBQVcsYUFBYSxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsRUFBRSxrQkFBa0IsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDO0lBRXZELFNBQVMsQ0FBQyxHQUFHLEVBQUUsQ0FBQyxHQUFHLGdCQUFnQixDQUFDLENBQUMsQ0FBQyxDQVl0QztJQUVNLGNBQWMsQ0FBQyxHQUFHLEVBQUUsQ0FBQyxHQUFHLHFCQUFxQixDQUFDLENBQUMsQ0FBQyxDQUl0RDtJQUVELGtCQUFrQixDQUFDLEdBQUcsRUFBRSxDQUFDLEdBQUcsT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQWMxQztJQUVLLFdBQVcsQ0FBQyxHQUFHLEVBQUUsQ0FBQyxFQUFFLEdBQUcsRUFBRSxDQUFDLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUUvQztDQUNGIn0=

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

@@ -0,0 +1 @@
+{"version":3,"file":"multi_map.d.ts","sourceRoot":"","sources":["../../src/lmdb/multi_map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC;;GAEG;AACH,qBAAa,iBAAiB,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,SAAS,KAAK,CAC3D,SAAQ,YAAY,CAAC,CAAC,EAAE,CAAC,CACzB,YAAW,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC;IAEvD,SAAS,CAAC,GAAG,EAAE,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAYtC;IAEM,cAAc,CAAC,GAAG,EAAE,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAItD;IAED,kBAAkB,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAc1C;IAEK,WAAW,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;CACF"}

package/dest/lmdb/multi_map.js

@@ -0,0 +1,44 @@
+import { LmdbAztecMap } from './map.js';
+/**
+ * A map backed by LMDB.
+ */ export class LmdbAztecMultiMap extends LmdbAztecMap {
+    *getValues(key) {
+        const transaction = this.db.useReadTransaction();
+        try {
+            const values = this.db.getValues(this.slot(key), {
+                transaction
+            });
+            for (const value of values){
+                yield value?.[1];
+            }
+        } finally{
+            transaction.done();
+        }
+    }
+    async *getValuesAsync(key) {
+        for (const value of this.getValues(key)){
+            yield value;
+        }
+    }
+    getValueCountAsync(key) {
+        const transaction = this.db.useReadTransaction();
+        try {
+            const values = this.db.getValues(this.slot(key), {
+                transaction
+            });
+            let count = 0;
+            for (const _ of values){
+                count++;
+            }
+            return Promise.resolve(count);
+        } finally{
+            transaction.done();
+        }
+    }
+    async deleteValue(key, val) {
+        await this.db.remove(this.slot(key), [
+            key,
+            val
+        ]);
+    }
+}

package/dest/lmdb/set.d.ts

@@ -0,0 +1,18 @@
+import type { Database } from 'lmdb';
+import type { Key, Range } from '../interfaces/common.js';
+import type { AztecAsyncSet, AztecSet } from '../interfaces/set.js';
+/**
+ * A set backed by LMDB.
+ */
+export declare class LmdbAztecSet<K extends Key> implements AztecSet<K>, AztecAsyncSet<K> {
+    private map;
+    constructor(rootDb: Database, mapName: string);
+    close(): Promise<void>;
+    has(key: K): boolean;
+    hasAsync(key: K): Promise<boolean>;
+    add(key: K): Promise<void>;
+    delete(key: K): Promise<void>;
+    entries(range?: Range<K>): IterableIterator<K>;
+    entriesAsync(range?: Range<K>): AsyncIterableIterator<K>;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2V0LmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbG1kYi9zZXQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsUUFBUSxFQUFFLE1BQU0sTUFBTSxDQUFDO0FBRXJDLE9BQU8sS0FBSyxFQUFFLEdBQUcsRUFBRSxLQUFLLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUMxRCxPQUFPLEtBQUssRUFBRSxhQUFhLEVBQUUsUUFBUSxFQUFFLE1BQU0sc0JBQXNCLENBQUM7QUFHcEU7O0dBRUc7QUFDSCxxQkFBYSxZQUFZLENBQUMsQ0FBQyxTQUFTLEdBQUcsQ0FBRSxZQUFXLFFBQVEsQ0FBQyxDQUFDLENBQUMsRUFBRSxhQUFhLENBQUMsQ0FBQyxDQUFDO0lBQy9FLE9BQU8sQ0FBQyxHQUFHLENBQTJCO0lBQ3RDLFlBQVksTUFBTSxFQUFFLFFBQVEsRUFBRSxPQUFPLEVBQUUsTUFBTSxFQUU1QztJQUVELEtBQUssSUFBSSxPQUFPLENBQUMsSUFBSSxDQUFDLENBRXJCO0lBRUQsR0FBRyxDQUFDLEdBQUcsRUFBRSxDQUFDLEdBQUcsT0FBTyxDQUVuQjtJQUVELFFBQVEsQ0FBQyxHQUFHLEVBQUUsQ0FBQyxHQUFHLE9BQU8sQ0FBQyxPQUFPLENBQUMsQ0FFakM7SUFFRCxHQUFHLENBQUMsR0FBRyxFQUFFLENBQUMsR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLENBRXpCO0lBRUQsTUFBTSxDQUFDLEdBQUcsRUFBRSxDQUFDLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUU1QjtJQUVELE9BQU8sQ0FBQyxLQUFLLEdBQUUsS0FBSyxDQUFDLENBQUMsQ0FBTSxHQUFHLGdCQUFnQixDQUFDLENBQUMsQ0FBQyxDQUVqRDtJQUVNLFlBQVksQ0FBQyxLQUFLLEdBQUUsS0FBSyxDQUFDLENBQUMsQ0FBTSxHQUFHLHFCQUFxQixDQUFDLENBQUMsQ0FBQyxDQUlsRTtDQUNGIn0=

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

@@ -0,0 +1 @@
+{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../src/lmdb/set.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAErC,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGpE;;GAEG;AACH,qBAAa,YAAY,CAAC,CAAC,SAAS,GAAG,CAAE,YAAW,QAAQ,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC;IAC/E,OAAO,CAAC,GAAG,CAA2B;IACtC,YAAY,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAE5C;IAED,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAErB;IAED,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAEnB;IAED,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAEjC;IAED,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzB;IAED,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5B;IAED,OAAO,CAAC,KAAK,GAAE,KAAK,CAAC,CAAC,CAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAEjD;IAEM,YAAY,CAAC,KAAK,GAAE,KAAK,CAAC,CAAC,CAAM,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAIlE;CACF"}

package/dest/lmdb/set.js

@@ -0,0 +1,32 @@
+import { LmdbAztecMap } from './map.js';
+/**
+ * A set backed by LMDB.
+ */ export class LmdbAztecSet {
+    map;
+    constructor(rootDb, mapName){
+        this.map = new LmdbAztecMap(rootDb, mapName);
+    }
+    close() {
+        return this.map.close();
+    }
+    has(key) {
+        return this.map.has(key);
+    }
+    hasAsync(key) {
+        return Promise.resolve(this.has(key));
+    }
+    add(key) {
+        return this.map.set(key, true);
+    }
+    delete(key) {
+        return this.map.delete(key);
+    }
+    entries(range = {}) {
+        return this.map.keys(range);
+    }
+    async *entriesAsync(range = {}) {
+        for await (const key of this.map.keysAsync(range)){
+            yield key;
+        }
+    }
+}

package/dest/lmdb/singleton.d.ts

@@ -0,0 +1,14 @@
+import type { Database, Key } from 'lmdb';
+import type { AztecAsyncSingleton, AztecSingleton } from '../interfaces/singleton.js';
+/**
+ * Stores a single value in LMDB.
+ */
+export declare class LmdbAztecSingleton<T> implements AztecSingleton<T>, AztecAsyncSingleton<T> {
+    #private;
+    constructor(db: Database<unknown, Key>, name: string);
+    get(): T | undefined;
+    getAsync(): Promise<T | undefined>;
+    set(val: T): Promise<boolean>;
+    delete(): Promise<boolean>;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2luZ2xldG9uLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbG1kYi9zaW5nbGV0b24udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsUUFBUSxFQUFFLEdBQUcsRUFBRSxNQUFNLE1BQU0sQ0FBQztBQUUxQyxPQUFPLEtBQUssRUFBRSxtQkFBbUIsRUFBRSxjQUFjLEVBQUUsTUFBTSw0QkFBNEIsQ0FBQztBQUt0Rjs7R0FFRztBQUNILHFCQUFhLGtCQUFrQixDQUFDLENBQUMsQ0FBRSxZQUFXLGNBQWMsQ0FBQyxDQUFDLENBQUMsRUFBRSxtQkFBbUIsQ0FBQyxDQUFDLENBQUM7O0lBSXJGLFlBQVksRUFBRSxFQUFFLFFBQVEsQ0FBQyxPQUFPLEVBQUUsR0FBRyxDQUFDLEVBQUUsSUFBSSxFQUFFLE1BQU0sRUFHbkQ7SUFFRCxHQUFHLElBQUksQ0FBQyxHQUFHLFNBQVMsQ0FFbkI7SUFFRCxRQUFRLElBQUksT0FBTyxDQUFDLENBQUMsR0FBRyxTQUFTLENBQUMsQ0FFakM7SUFFRCxHQUFHLENBQUMsR0FBRyxFQUFFLENBQUMsR0FBRyxPQUFPLENBQUMsT0FBTyxDQUFDLENBRTVCO0lBRUQsTUFBTSxJQUFJLE9BQU8sQ0FBQyxPQUFPLENBQUMsQ0FFekI7Q0FDRiJ9

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

@@ -0,0 +1 @@
+{"version":3,"file":"singleton.d.ts","sourceRoot":"","sources":["../../src/lmdb/singleton.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAE1C,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAKtF;;GAEG;AACH,qBAAa,kBAAkB,CAAC,CAAC,CAAE,YAAW,cAAc,CAAC,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC;;IAIrF,YAAY,EAAE,EAAE,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAGnD;IAED,GAAG,IAAI,CAAC,GAAG,SAAS,CAEnB;IAED,QAAQ,IAAI,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAEjC;IAED,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAE5B;IAED,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAEzB;CACF"}

package/dest/lmdb/singleton.js

@@ -0,0 +1,26 @@
+/**
+ * Stores a single value in LMDB.
+ */ export class LmdbAztecSingleton {
+    #db;
+    #slot;
+    constructor(db, name){
+        this.#db = db;
+        this.#slot = [
+            'singleton',
+            name,
+            'value'
+        ];
+    }
+    get() {
+        return this.#db.get(this.#slot);
+    }
+    getAsync() {
+        return Promise.resolve(this.get());
+    }
+    set(val) {
+        return this.#db.put(this.#slot, val);
+    }
+    delete() {
+        return this.#db.remove(this.#slot);
+    }
+}

package/dest/lmdb/store.d.ts

@@ -0,0 +1,94 @@
+import { type RootDatabase } from 'lmdb';
+import type { AztecArray, AztecAsyncArray } from '../interfaces/array.js';
+import type { Key, StoreSize, Value } from '../interfaces/common.js';
+import type { AztecAsyncCounter, AztecCounter } from '../interfaces/counter.js';
+import type { AztecAsyncMap, AztecMap } from '../interfaces/map.js';
+import type { AztecAsyncMultiMap, AztecMultiMap } from '../interfaces/multi_map.js';
+import type { AztecAsyncSet, AztecSet } from '../interfaces/set.js';
+import type { AztecAsyncSingleton, AztecSingleton } from '../interfaces/singleton.js';
+import type { AztecAsyncKVStore, AztecKVStore } from '../interfaces/store.js';
+/**
+ * A key-value store backed by LMDB.
+ */
+export declare class AztecLmdbStore implements AztecKVStore, AztecAsyncKVStore {
+    #private;
+    readonly isEphemeral: boolean;
+    private path;
+    syncGetters: true;
+    constructor(rootDb: RootDatabase, isEphemeral: boolean, path: string);
+    /**
+     * Creates a new AztecKVStore backed by LMDB. 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.
+     *
+     * The `rollupAddress` passed is checked against what is stored in the database. If they do not match,
+     * the database is cleared before returning the store. This way data is not accidentally shared between
+     * different rollup instances.
+     *
+     * @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(path?: string, mapSizeKb?: number, ephemeral?: boolean, log?: import("@aztec-labs/foundation/log").Logger): AztecLmdbStore;
+    /**
+     * 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): AztecMap<K, V> & 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): AztecSet<K> & 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): AztecMultiMap<K, V> & AztecAsyncMultiMap<K, V>;
+    openCounter<K extends Key>(name: string): AztecCounter<K> & 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): AztecArray<T> & AztecAsyncArray<T>;
+    /**
+     * Creates a new AztecSingleton in the store.
+     * @param name - Name of the singleton
+     * @returns A new AztecSingleton
+     */
+    openSingleton<T>(name: string): AztecSingleton<T> & 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
+     */
+    transaction<T>(callback: () => T): Promise<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 atomically within a single transaction.
+     */
+    clear(): Promise<void>;
+    /**
+     * Drops the database & sub DBs atomically within a single transaction.
+     */
+    drop(): Promise<void>;
+    /**
+     * Close the database. Note, once this is closed we can no longer interact with the DB.
+     */
+    close(): Promise<void>;
+    /** Deletes this store and removes the database files from disk */
+    delete(): Promise<void>;
+    estimateSize(): Promise<StoreSize>;
+    private estimateSubDBSize;
+    backupTo(_dstPath: string, _compact?: boolean): Promise<void>;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RvcmUuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9sbWRiL3N0b3JlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUdBLE9BQU8sRUFBaUIsS0FBSyxZQUFZLEVBQVEsTUFBTSxNQUFNLENBQUM7QUFJOUQsT0FBTyxLQUFLLEVBQUUsVUFBVSxFQUFFLGVBQWUsRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBQzFFLE9BQU8sS0FBSyxFQUFFLEdBQUcsRUFBRSxTQUFTLEVBQUUsS0FBSyxFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFDckUsT0FBTyxLQUFLLEVBQUUsaUJBQWlCLEVBQUUsWUFBWSxFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFDaEYsT0FBTyxLQUFLLEVBQUUsYUFBYSxFQUFFLFFBQVEsRUFBRSxNQUFNLHNCQUFzQixDQUFDO0FBQ3BFLE9BQU8sS0FBSyxFQUFFLGtCQUFrQixFQUFFLGFBQWEsRUFBRSxNQUFNLDRCQUE0QixDQUFDO0FBQ3BGLE9BQU8sS0FBSyxFQUFFLGFBQWEsRUFBRSxRQUFRLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUNwRSxPQUFPLEtBQUssRUFBRSxtQkFBbUIsRUFBRSxjQUFjLEVBQUUsTUFBTSw0QkFBNEIsQ0FBQztBQUN0RixPQUFPLEtBQUssRUFBRSxpQkFBaUIsRUFBRSxZQUFZLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQVE5RTs7R0FFRztBQUNILHFCQUFhLGNBQWUsWUFBVyxZQUFZLEVBQUUsaUJBQWlCOzthQVVsRCxXQUFXLEVBQUUsT0FBTztJQUNwQyxPQUFPLENBQUMsSUFBSTtJQVZkLFdBQVcsT0FBaUI7SUFPNUIsWUFDRSxNQUFNLEVBQUUsWUFBWSxFQUNKLFdBQVcsRUFBRSxPQUFPLEVBQzVCLElBQUksRUFBRSxNQUFNLEVBZXJCO0lBRUQ7Ozs7Ozs7Ozs7OztPQVlHO0lBQ0gsTUFBTSxDQUFDLElBQUksQ0FDVCxJQUFJLENBQUMsRUFBRSxNQUFNLEVBQ2IsU0FBUyxTQUFrQixFQUMzQixTQUFTLEdBQUUsT0FBZSxFQUMxQixHQUFHLDhDQUFnQyxHQUNsQyxjQUFjLENBT2hCO0lBRUQ7Ozs7T0FJRztJQUNILE9BQU8sQ0FBQyxDQUFDLFNBQVMsR0FBRyxFQUFFLENBQUMsU0FBUyxLQUFLLEVBQUUsSUFBSSxFQUFFLE1BQU0sR0FBRyxRQUFRLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxHQUFHLGFBQWEsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBRTFGO0lBRUQ7Ozs7T0FJRztJQUNILE9BQU8sQ0FBQyxDQUFDLFNBQVMsR0FBRyxFQUFFLElBQUksRUFBRSxNQUFNLEdBQUcsUUFBUSxDQUFDLENBQUMsQ0FBQyxHQUFHLGFBQWEsQ0FBQyxDQUFDLENBQUMsQ0FFbkU7SUFFRDs7OztPQUlHO0lBQ0gsWUFBWSxDQUFDLENBQUMsU0FBUyxHQUFHLEVBQUUsQ0FBQyxTQUFTLEtBQUssRUFBRSxJQUFJLEVBQUUsTUFBTSxHQUFHLGFBQWEsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLEdBQUcsa0JBQWtCLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUV6RztJQUVELFdBQVcsQ0FBQyxDQUFDLFNBQVMsR0FBRyxFQUFFLElBQUksRUFBRSxNQUFNLEdBQUcsWUFBWSxDQUFDLENBQUMsQ0FBQyxHQUFHLGlCQUFpQixDQUFDLENBQUMsQ0FBQyxDQUUvRTtJQUVEOzs7O09BSUc7SUFDSCxTQUFTLENBQUMsQ0FBQyxTQUFTLEtBQUssRUFBRSxJQUFJLEVBQUUsTUFBTSxHQUFHLFVBQVUsQ0FBQyxDQUFDLENBQUMsR0FBRyxlQUFlLENBQUMsQ0FBQyxDQUFDLENBRTNFO0lBRUQ7Ozs7T0FJRztJQUNILGFBQWEsQ0FBQyxDQUFDLEVBQUUsSUFBSSxFQUFFLE1BQU0sR0FBRyxjQUFjLENBQUMsQ0FBQyxDQUFDLEdBQUcsbUJBQW1CLENBQUMsQ0FBQyxDQUFDLENBRXpFO0lBRUQ7Ozs7T0FJRztJQUNILFdBQVcsQ0FBQyxDQUFDLEVBQUUsUUFBUSxFQUFFLE1BQU0sQ0FBQyxHQUFHLE9BQU8sQ0FBQyxDQUFDLENBQUMsQ0FFNUM7SUFFRDs7OztPQUlHO0lBQ0csZ0JBQWdCLENBQUMsQ0FBQyxFQUFFLFFBQVEsRUFBRSxNQUFNLE9BQU8sQ0FBQyxDQUFDLENBQUMsR0FBRyxPQUFPLENBQUMsQ0FBQyxDQUFDLENBRWhFO0lBRUQ7O09BRUc7SUFDRyxLQUFLLGtCQU1WO0lBRUQ7O09BRUc7SUFDRyxJQUFJLGtCQU1UO0lBRUQ7O09BRUc7SUFDRyxLQUFLLGtCQUlWO0lBRUQsa0VBQWtFO0lBQzVELE1BQU0sa0JBT1g7SUFFRCxZQUFZLElBQUksT0FBTyxDQUFDLFNBQVMsQ0FBQyxDQW9CakM7SUFFRCxPQUFPLENBQUMsaUJBQWlCO0lBNEJ6QixRQUFRLENBQUMsUUFBUSxFQUFFLE1BQU0sRUFBRSxRQUFRLENBQUMsRUFBRSxPQUFPLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUU1RDtDQUNGIn0=

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

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

package/dest/lmdb/store.js

@@ -0,0 +1,200 @@
+import { randomBytes } from '@aztec-labs/foundation/crypto/random';
+import { createLogger } from '@aztec-labs/foundation/log';
+import { promises as fs, mkdirSync } from 'fs';
+import { open } from 'lmdb';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { LmdbAztecArray } from './array.js';
+import { LmdbAztecCounter } from './counter.js';
+import { LmdbAztecMap } from './map.js';
+import { LmdbAztecMultiMap } from './multi_map.js';
+import { LmdbAztecSet } from './set.js';
+import { LmdbAztecSingleton } from './singleton.js';
+/**
+ * A key-value store backed by LMDB.
+ */ export class AztecLmdbStore {
+    isEphemeral;
+    path;
+    syncGetters;
+    #rootDb;
+    #data;
+    #multiMapData;
+    #log;
+    constructor(rootDb, isEphemeral, path){
+        this.isEphemeral = isEphemeral;
+        this.path = path;
+        this.syncGetters = true;
+        this.#log = createLogger('kv-store:lmdb');
+        this.#rootDb = rootDb;
+        // big bucket to store all the data
+        this.#data = rootDb.openDB('data', {
+            encoding: 'msgpack',
+            keyEncoding: 'ordered-binary'
+        });
+        this.#multiMapData = rootDb.openDB('data_dup_sort', {
+            encoding: 'ordered-binary',
+            keyEncoding: 'ordered-binary',
+            dupSort: true
+        });
+    }
+    /**
+   * Creates a new AztecKVStore backed by LMDB. 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.
+   *
+   * The `rollupAddress` passed is checked against what is stored in the database. If they do not match,
+   * the database is cleared before returning the store. This way data is not accidentally shared between
+   * different rollup instances.
+   *
+   * @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(path, mapSizeKb = 1 * 1024 * 1024, ephemeral = false, log = createLogger('kv-store:lmdb')) {
+        const dbPath = path ?? join(tmpdir(), randomBytes(8).toString('hex'));
+        mkdirSync(dbPath, {
+            recursive: true
+        });
+        const mapSize = 1024 * mapSizeKb;
+        log.debug(`Opening LMDB database at ${path || 'temporary location'} with map size ${mapSize}`);
+        const rootDb = open({
+            path: dbPath,
+            noSync: ephemeral,
+            mapSize
+        });
+        return new AztecLmdbStore(rootDb, ephemeral, dbPath);
+    }
+    /**
+   * Creates a new AztecMap in the store.
+   * @param name - Name of the map
+   * @returns A new AztecMap
+   */ openMap(name) {
+        return new LmdbAztecMap(this.#data, name);
+    }
+    /**
+   * Creates a new AztecSet in the store.
+   * @param name - Name of the set
+   * @returns A new AztecSet
+   */ openSet(name) {
+        return new LmdbAztecSet(this.#data, name);
+    }
+    /**
+   * 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) {
+        return new LmdbAztecMultiMap(this.#multiMapData, name);
+    }
+    openCounter(name) {
+        return new LmdbAztecCounter(this.#data, name);
+    }
+    /**
+   * Creates a new AztecArray in the store.
+   * @param name - Name of the array
+   * @returns A new AztecArray
+   */ openArray(name) {
+        return new LmdbAztecArray(this.#data, name);
+    }
+    /**
+   * Creates a new AztecSingleton in the store.
+   * @param name - Name of the singleton
+   * @returns A new AztecSingleton
+   */ openSingleton(name) {
+        return new LmdbAztecSingleton(this.#data, name);
+    }
+    /**
+   * 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
+   */ transaction(callback) {
+        return this.#rootDb.transaction(callback);
+    }
+    /**
+   * 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) {
+        return await this.#rootDb.transaction(callback);
+    }
+    /**
+   * Clears all entries in the store & sub DBs atomically within a single transaction.
+   */ async clear() {
+        await this.#rootDb.transaction(async ()=>{
+            await this.#data.clearAsync();
+            await this.#multiMapData.clearAsync();
+            await this.#rootDb.clearAsync();
+        });
+    }
+    /**
+   * Drops the database & sub DBs atomically within a single transaction.
+   */ async drop() {
+        await this.#rootDb.transaction(async ()=>{
+            await this.#data.drop();
+            await this.#multiMapData.drop();
+            await this.#rootDb.drop();
+        });
+    }
+    /**
+   * Close the database. Note, once this is closed we can no longer interact with the DB.
+   */ async close() {
+        await this.#data.close();
+        await this.#multiMapData.close();
+        await this.#rootDb.close();
+    }
+    /** Deletes this store and removes the database files from disk */ async delete() {
+        await this.drop();
+        await this.close();
+        if (this.path) {
+            await fs.rm(this.path, {
+                recursive: true,
+                force: true,
+                maxRetries: 3
+            });
+            this.#log.verbose(`Deleted database files at ${this.path}`);
+        }
+    }
+    estimateSize() {
+        const stats = this.#rootDb.getStats();
+        // The 'mapSize' is the total amount of virtual address space allocated to the DB (effectively the maximum possible size)
+        // http://www.lmdb.tech/doc/group__mdb.html#a4bde3c8b676457342cba2fe27aed5fbd
+        let mapSize = 0;
+        if ('mapSize' in stats && typeof stats.mapSize === 'number') {
+            mapSize = stats.mapSize;
+        }
+        let physicalFileSize = 0;
+        if ('physicalFileSize' in stats && typeof stats.physicalFileSize === 'number') {
+            physicalFileSize = stats.physicalFileSize;
+        }
+        const dataResult = this.estimateSubDBSize(this.#data);
+        const multiResult = this.estimateSubDBSize(this.#multiMapData);
+        return Promise.resolve({
+            mappingSize: mapSize,
+            physicalFileSize: physicalFileSize,
+            actualSize: dataResult.actualSize + multiResult.actualSize,
+            numItems: dataResult.numItems + multiResult.numItems
+        });
+    }
+    estimateSubDBSize(db) {
+        const stats = db.getStats();
+        let actualSize = 0;
+        let numItems = 0;
+        // This is the total number of key/value pairs present in the DB
+        if ('entryCount' in stats && typeof stats.entryCount === 'number') {
+            numItems = stats.entryCount;
+        }
+        // The closest value we can get to the actual size of the database is the number of consumed pages * the page size
+        if ('treeBranchPageCount' in stats && typeof stats.treeBranchPageCount === 'number' && 'treeLeafPageCount' in stats && typeof stats.treeLeafPageCount === 'number' && 'overflowPages' in stats && typeof stats.overflowPages === 'number' && 'pageSize' in stats && typeof stats.pageSize === 'number') {
+            const branchPages = stats.treeBranchPageCount;
+            const leafPages = stats.treeLeafPageCount;
+            const overflowPages = stats.overflowPages;
+            const pageSize = stats.pageSize;
+            actualSize = (branchPages + leafPages + overflowPages) * pageSize;
+        }
+        return {
+            actualSize,
+            numItems
+        };
+    }
+    backupTo(_dstPath, _compact) {
+        throw new Error('Method not implemented.');
+    }
+}

package/dest/lmdb-v2/array.d.ts

@@ -0,0 +1,19 @@
+import type { AztecAsyncArray } from '../interfaces/array.js';
+import type { Value } from '../interfaces/common.js';
+import type { AztecLMDBStoreV2 } from './store.js';
+export declare class LMDBArray<T extends Value> implements AztecAsyncArray<T> {
+    private store;
+    private length;
+    private encoder;
+    private prefix;
+    constructor(store: AztecLMDBStoreV2, name: string);
+    pop(): Promise<T | undefined>;
+    push(...vals: T[]): Promise<number>;
+    setAt(index: number, val: T): Promise<boolean>;
+    atAsync(index: number): Promise<T | undefined>;
+    lengthAsync(): Promise<number>;
+    entriesAsync(): AsyncIterableIterator<[number, T]>;
+    valuesAsync(): AsyncIterableIterator<T>;
+    [Symbol.asyncIterator](): AsyncIterableIterator<T>;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXJyYXkuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9sbWRiLXYyL2FycmF5LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUVBLE9BQU8sS0FBSyxFQUFFLGVBQWUsRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBQzlELE9BQU8sS0FBSyxFQUFFLEtBQUssRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBR3JELE9BQU8sS0FBSyxFQUFFLGdCQUFnQixFQUFFLE1BQU0sWUFBWSxDQUFDO0FBSW5ELHFCQUFhLFNBQVMsQ0FBQyxDQUFDLFNBQVMsS0FBSyxDQUFFLFlBQVcsZUFBZSxDQUFDLENBQUMsQ0FBQztJQU1qRSxPQUFPLENBQUMsS0FBSztJQUxmLE9BQU8sQ0FBQyxNQUFNLENBQThCO0lBQzVDLE9BQU8sQ0FBQyxPQUFPLENBQWlCO0lBQ2hDLE9BQU8sQ0FBQyxNQUFNLENBQVM7SUFFdkIsWUFDVSxLQUFLLEVBQUUsZ0JBQWdCLEVBQy9CLElBQUksRUFBRSxNQUFNLEVBSWI7SUFFRCxHQUFHLElBQUksT0FBTyxDQUFDLENBQUMsR0FBRyxTQUFTLENBQUMsQ0FjNUI7SUFFRCxJQUFJLENBQUMsR0FBRyxJQUFJLEVBQUUsQ0FBQyxFQUFFLEdBQUcsT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQVNsQztJQUVELEtBQUssQ0FBQyxLQUFLLEVBQUUsTUFBTSxFQUFFLEdBQUcsRUFBRSxDQUFDLEdBQUcsT0FBTyxDQUFDLE9BQU8sQ0FBQyxDQVk3QztJQUVELE9BQU8sQ0FBQyxLQUFLLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0FBQyxDQUFDLEdBQUcsU0FBUyxDQUFDLENBYTdDO0lBRUssV0FBVyxJQUFJLE9BQU8sQ0FBQyxNQUFNLENBQUMsQ0FFbkM7SUFFTSxZQUFZLElBQUkscUJBQXFCLENBQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0F5QnhEO0lBRU0sV0FBVyxJQUFJLHFCQUFxQixDQUFDLENBQUMsQ0FBQyxDQUk3QztJQUVELENBQUMsTUFBTSxDQUFDLGFBQWEsQ0FBQyxJQUFJLHFCQUFxQixDQUFDLENBQUMsQ0FBQyxDQUVqRDtDQUNGIn0=

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

@@ -0,0 +1 @@
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../src/lmdb-v2/array.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAGrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAInD,qBAAa,SAAS,CAAC,CAAC,SAAS,KAAK,CAAE,YAAW,eAAe,CAAC,CAAC,CAAC;IAMjE,OAAO,CAAC,KAAK;IALf,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,MAAM,CAAS;IAEvB,YACU,KAAK,EAAE,gBAAgB,EAC/B,IAAI,EAAE,MAAM,EAIb;IAED,GAAG,IAAI,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAc5B;IAED,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CASlC;IAED,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAY7C;IAED,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAa7C;IAEK,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAEnC;IAEM,YAAY,IAAI,qBAAqB,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAyBxD;IAEM,WAAW,IAAI,qBAAqB,CAAC,CAAC,CAAC,CAI7C;IAED,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,CAAC,CAAC,CAEjD;CACF"}

package/dest/lmdb-v2/array.js

@@ -0,0 +1,103 @@
+var _computedKey;
+import { Encoder } from 'msgpackr/pack';
+import { execInReadTx, execInWriteTx } from './tx-helpers.js';
+import { deserializeKey, serializeKey } from './utils.js';
+_computedKey = Symbol.asyncIterator;
+export class LMDBArray {
+    store;
+    length;
+    encoder;
+    prefix;
+    constructor(store, name){
+        this.store = store;
+        this.encoder = new Encoder();
+        this.length = store.openSingleton(name + ':length');
+        this.prefix = `array:${name}`;
+    }
+    pop() {
+        return execInWriteTx(this.store, async (tx)=>{
+            const length = await this.lengthAsync();
+            if (length === 0) {
+                return;
+            }
+            const val = await tx.get(serializeKey(this.prefix, length - 1));
+            await tx.remove(serializeKey(this.prefix, length - 1));
+            await this.length.set(length - 1);
+            return val ? this.encoder.unpack(val) : undefined;
+        });
+    }
+    push(...vals) {
+        return execInWriteTx(this.store, async (tx)=>{
+            let length = await this.lengthAsync();
+            for (const val of vals){
+                await tx.set(serializeKey(this.prefix, length++), this.encoder.pack(val));
+            }
+            await this.length.set(length);
+            return length;
+        });
+    }
+    setAt(index, val) {
+        return execInWriteTx(this.store, async (tx)=>{
+            const length = await this.lengthAsync();
+            if (index < 0) {
+                index += length;
+            }
+            if (index < 0 || index >= length) {
+                return false;
+            }
+            await tx.set(serializeKey(this.prefix, index), this.encoder.pack(val));
+            return true;
+        });
+    }
+    atAsync(index) {
+        return execInReadTx(this.store, async (tx)=>{
+            const length = await this.lengthAsync();
+            if (index < 0) {
+                index += length;
+            }
+            if (index < 0 || index >= length) {
+                return undefined;
+            }
+            const val = await tx.get(serializeKey(this.prefix, index));
+            return val ? this.encoder.unpack(val) : undefined;
+        });
+    }
+    async lengthAsync() {
+        return await this.length.getAsync() ?? 0;
+    }
+    async *entriesAsync() {
+        // pin array length so that pushes don't affect iteration
+        const length = await this.lengthAsync();
+        if (length === 0) {
+            return;
+        }
+        let tx = this.store.getCurrentWriteTx();
+        const shouldClose = !tx;
+        tx ??= this.store.getReadTx();
+        try {
+            for await (const [key, val] of tx.iterate(serializeKey(this.prefix, 0), undefined, false, length)){
+                const deserializedKey = deserializeKey(this.prefix, key);
+                // if pops happened while iterating we may have read too much. Terminate early
+                if (deserializedKey === false) {
+                    break;
+                }
+                yield [
+                    deserializedKey,
+                    this.encoder.unpack(val)
+                ];
+            }
+        } finally{
+            if (shouldClose) {
+                tx.close();
+            }
+        }
+    }
+    async *valuesAsync() {
+        for await (const [_, value] of this.entriesAsync()){
+            yield value;
+        }
+    }
+    [_computedKey]() {
+        return this.valuesAsync();
+    }
+}

package/dest/lmdb-v2/factory.d.ts

@@ -0,0 +1,35 @@
+import { EthAddress } from '@aztec-labs/foundation/eth-address';
+import { type LoggerBindings } from '@aztec-labs/foundation/log';
+import { type SchemaVersionMismatchPolicy, type VersionFileReadFailurePolicy } from '@aztec-labs/stdlib/database-version/manager';
+import type { DataStoreConfig } from '@aztec-labs/stdlib/kv-store';
+import { AztecLMDBStoreV2 } from './store.js';
+/** Optional versioning hooks for persistent LMDB stores. */
+export type CreateStoreOptions = {
+    onUpgrade?: (dataDir: string, currentVersion: number, latestVersion: number) => Promise<void>;
+    schemaVersionMismatchPolicy?: SchemaVersionMismatchPolicy;
+    versionFileReadFailurePolicy?: VersionFileReadFailurePolicy;
+};
+export declare function createStore(name: string, schemaVersion: number, config: DataStoreConfig, bindings?: LoggerBindings, options?: CreateStoreOptions): Promise<AztecLMDBStoreV2>;
+/**
+ * Open a persistent on-disk store rooted in OS tmpdir. Caller chooses whether to
+ * auto-remove the directory on close. Uses standard durable LMDB flags (fsync on
+ * every commit) — for full in-memory / NOSYNC semantics use `openEphemeralStore`.
+ */
+export declare function openTmpStore(name: string, cleanupTmpDir?: boolean, dbMapSizeKb?: number, maxReaders?: number, bindings?: LoggerBindings): Promise<AztecLMDBStoreV2>;
+/**
+ * Open a fully-ephemeral store: a fresh tmpdir backing file, LMDB opened with
+ * MDB_NOSYNC | MDB_NOMETASYNC (no fsync, kernel-only writeback), and the directory
+ * unconditionally removed on close. Intended for tests and worker-local scratch
+ * stores where durability is explicitly not desired.
+ */
+export declare function openEphemeralStore(name: string, dbMapSizeKb?: number, maxReaders?: number, bindings?: LoggerBindings): Promise<AztecLMDBStoreV2>;
+export declare function openStoreAt(dataDir: string, dbMapSizeKb?: number, maxReaders?: number, bindings?: LoggerBindings): Promise<AztecLMDBStoreV2>;
+/**
+ * Open a fully-ephemeral store seeded from an existing `data.mdb` file. Creates a fresh tmpdir,
+ * copies `srcDataMdbPath` into it as `data.mdb`, opens with MDB_NOSYNC | MDB_NOMETASYNC, and
+ * removes the tmpdir on close. Intended for worker clones of a main-thread-built store — the
+ * source file is never written to.
+ */
+export declare function cloneEphemeralStoreFrom(srcDataMdbPath: string, name: string, dbMapSizeKb?: number, maxReaders?: number, bindings?: LoggerBindings): Promise<AztecLMDBStoreV2>;
+export declare function openVersionedStoreAt(dataDirectory: string, schemaVersion: number, rollupAddress: EthAddress, dbMapSizeKb?: number, maxReaders?: number, bindings?: LoggerBindings): Promise<AztecLMDBStoreV2>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmFjdG9yeS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2xtZGItdjIvZmFjdG9yeS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0sb0NBQW9DLENBQUM7QUFDaEUsT0FBTyxFQUFFLEtBQUssY0FBYyxFQUFnQixNQUFNLDRCQUE0QixDQUFDO0FBQy9FLE9BQU8sRUFFTCxLQUFLLDJCQUEyQixFQUNoQyxLQUFLLDRCQUE0QixFQUNsQyxNQUFNLDZDQUE2QyxDQUFDO0FBQ3JELE9BQU8sS0FBSyxFQUFFLGVBQWUsRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBS25FLE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLFlBQVksQ0FBQztBQUk5Qyw0REFBNEQ7QUFDNUQsTUFBTSxNQUFNLGtCQUFrQixHQUFHO0lBQy9CLFNBQVMsQ0FBQyxFQUFFLENBQUMsT0FBTyxFQUFFLE1BQU0sRUFBRSxjQUFjLEVBQUUsTUFBTSxFQUFFLGFBQWEsRUFBRSxNQUFNLEtBQUssT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBQzlGLDJCQUEyQixDQUFDLEVBQUUsMkJBQTJCLENBQUM7SUFDMUQsNEJBQTRCLENBQUMsRUFBRSw0QkFBNEIsQ0FBQztDQUM3RCxDQUFDO0FBRUYsd0JBQXNCLFdBQVcsQ0FDL0IsSUFBSSxFQUFFLE1BQU0sRUFDWixhQUFhLEVBQUUsTUFBTSxFQUNyQixNQUFNLEVBQUUsZUFBZSxFQUN2QixRQUFRLENBQUMsRUFBRSxjQUFjLEVBQ3pCLE9BQU8sR0FBRSxrQkFBdUIsR0FDL0IsT0FBTyxDQUFDLGdCQUFnQixDQUFDLENBaUMzQjtBQUVEOzs7O0dBSUc7QUFDSCx3QkFBc0IsWUFBWSxDQUNoQyxJQUFJLEVBQUUsTUFBTSxFQUNaLGFBQWEsR0FBRSxPQUFjLEVBQzdCLFdBQVcsU0FBcUIsRUFDaEMsVUFBVSxTQUFjLEVBQ3hCLFFBQVEsQ0FBQyxFQUFFLGNBQWMsR0FDeEIsT0FBTyxDQUFDLGdCQUFnQixDQUFDLENBb0IzQjtBQUVEOzs7OztHQUtHO0FBQ0gsd0JBQXNCLGtCQUFrQixDQUN0QyxJQUFJLEVBQUUsTUFBTSxFQUNaLFdBQVcsU0FBcUIsRUFDaEMsVUFBVSxTQUFjLEVBQ3hCLFFBQVEsQ0FBQyxFQUFFLGNBQWMsR0FDeEIsT0FBTyxDQUFDLGdCQUFnQixDQUFDLENBZTNCO0FBRUQsd0JBQXNCLFdBQVcsQ0FDL0IsT0FBTyxFQUFFLE1BQU0sRUFDZixXQUFXLFNBQXFCLEVBQ2hDLFVBQVUsU0FBYyxFQUN4QixRQUFRLENBQUMsRUFBRSxjQUFjLEdBQ3hCLE9BQU8sQ0FBQyxnQkFBZ0IsQ0FBQyxDQUkzQjtBQUVEOzs7OztHQUtHO0FBQ0gsd0JBQXNCLHVCQUF1QixDQUMzQyxjQUFjLEVBQUUsTUFBTSxFQUN0QixJQUFJLEVBQUUsTUFBTSxFQUNaLFdBQVcsU0FBcUIsRUFDaEMsVUFBVSxTQUFjLEVBQ3hCLFFBQVEsQ0FBQyxFQUFFLGNBQWMsR0FDeEIsT0FBTyxDQUFDLGdCQUFnQixDQUFDLENBZ0IzQjtBQUVELHdCQUFzQixvQkFBb0IsQ0FDeEMsYUFBYSxFQUFFLE1BQU0sRUFDckIsYUFBYSxFQUFFLE1BQU0sRUFDckIsYUFBYSxFQUFFLFVBQVUsRUFDekIsV0FBVyxTQUFxQixFQUNoQyxVQUFVLFNBQWMsRUFDeEIsUUFBUSxDQUFDLEVBQUUsY0FBYyxHQUN4QixPQUFPLENBQUMsZ0JBQWdCLENBQUMsQ0FVM0IifQ==

package/dest/lmdb-v2/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/lmdb-v2/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,KAAK,cAAc,EAAgB,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAEL,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EAClC,MAAM,6CAA6C,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAKnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAI9C,4DAA4D;AAC5D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9F,2BAA2B,CAAC,EAAE,2BAA2B,CAAC;IAC1D,4BAA4B,CAAC,EAAE,4BAA4B,CAAC;CAC7D,CAAC;AAEF,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,eAAe,EACvB,QAAQ,CAAC,EAAE,cAAc,EACzB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,gBAAgB,CAAC,CAiC3B;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,aAAa,GAAE,OAAc,EAC7B,WAAW,SAAqB,EAChC,UAAU,SAAc,EACxB,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAoB3B;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,WAAW,SAAqB,EAChC,UAAU,SAAc,EACxB,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAe3B;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,WAAW,SAAqB,EAChC,UAAU,SAAc,EACxB,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAI3B;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,EACZ,WAAW,SAAqB,EAChC,UAAU,SAAc,EACxB,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAgB3B;AAED,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,UAAU,EACzB,WAAW,SAAqB,EAChC,UAAU,SAAc,EACxB,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAU3B"}