@aztec/kv-store 0.0.0-test.0

package/dest/lmdb-v2/map.js

@@ -0,0 +1,193 @@
+import { Encoder } from 'msgpackr';
+import { execInReadTx, execInWriteTx } from './store.js';
+import { deserializeKey, maxKey, minKey, serializeKey } from './utils.js';
+export class LMDBMap {
+    store;
+    prefix;
+    encoder;
+    constructor(store, name){
+        this.store = store;
+        this.encoder = new Encoder();
+        this.prefix = `map:${name}`;
+    }
+    /**
+   * Sets the value at the given key.
+   * @param key - The key to set the value at
+   * @param val - The value to set
+   */ set(key, val) {
+        return execInWriteTx(this.store, (tx)=>tx.set(serializeKey(this.prefix, key), this.encoder.pack(val)));
+    }
+    /**
+   * Sets the value at the given key if it does not already exist.
+   * @param key - The key to set the value at
+   * @param val - The value to set
+   */ setIfNotExists(key, val) {
+        return execInWriteTx(this.store, async (tx)=>{
+            const strKey = serializeKey(this.prefix, key);
+            const exists = !!await tx.get(strKey);
+            if (!exists) {
+                await tx.set(strKey, this.encoder.pack(val));
+                return true;
+            }
+            return false;
+        });
+    }
+    /**
+   * Deletes the value at the given key.
+   * @param key - The key to delete the value at
+   */ delete(key) {
+        return execInWriteTx(this.store, (tx)=>tx.remove(serializeKey(this.prefix, key)));
+    }
+    getAsync(key) {
+        return execInReadTx(this.store, async (tx)=>{
+            const val = await tx.get(serializeKey(this.prefix, key));
+            return val ? this.encoder.unpack(val) : undefined;
+        });
+    }
+    hasAsync(key) {
+        return execInReadTx(this.store, async (tx)=>!!await tx.get(serializeKey(this.prefix, key)));
+    }
+    /**
+   * Iterates over the map's key-value entries in the key's natural order
+   * @param range - The range of keys to iterate over
+   */ async *entriesAsync(range) {
+        const reverse = range?.reverse ?? false;
+        const startKey = range?.start ? serializeKey(this.prefix, range.start) : minKey(this.prefix);
+        const endKey = range?.end ? serializeKey(this.prefix, range.end) : reverse ? maxKey(this.prefix) : undefined;
+        let tx = this.store.getCurrentWriteTx();
+        const shouldClose = !tx;
+        tx ??= this.store.getReadTx();
+        try {
+            for await (const [key, val] of tx.iterate(reverse ? endKey : startKey, reverse ? startKey : endKey, reverse, range?.limit)){
+                const deserializedKey = deserializeKey(this.prefix, key);
+                if (!deserializedKey) {
+                    break;
+                }
+                yield [
+                    deserializedKey,
+                    this.encoder.unpack(val)
+                ];
+            }
+        } finally{
+            if (shouldClose) {
+                tx.close();
+            }
+        }
+    }
+    /**
+   * Iterates over the map's values in the key's natural order
+   * @param range - The range of keys to iterate over
+   */ async *valuesAsync(range) {
+        for await (const [_, value] of this.entriesAsync(range)){
+            yield value;
+        }
+    }
+    /**
+   * Iterates over the map's keys in the key's natural order
+   * @param range - The range of keys to iterate over
+   */ async *keysAsync(range) {
+        for await (const [key, _] of this.entriesAsync(range)){
+            yield key;
+        }
+    }
+}
+export class LMDBMultiMap {
+    store;
+    prefix;
+    encoder;
+    constructor(store, name){
+        this.store = store;
+        this.encoder = new Encoder();
+        this.prefix = `multimap:${name}`;
+    }
+    /**
+   * Sets the value at the given key.
+   * @param key - The key to set the value at
+   * @param val - The value to set
+   */ set(key, val) {
+        return execInWriteTx(this.store, (tx)=>tx.setIndex(serializeKey(this.prefix, key), this.encoder.pack(val)));
+    }
+    /**
+   * Sets the value at the given key if it does not already exist.
+   * @param key - The key to set the value at
+   * @param val - The value to set
+   */ setIfNotExists(key, val) {
+        return execInWriteTx(this.store, async (tx)=>{
+            const exists = !!await this.getAsync(key);
+            if (!exists) {
+                await tx.setIndex(serializeKey(this.prefix, key), this.encoder.pack(val));
+                return true;
+            }
+            return false;
+        });
+    }
+    /**
+   * Deletes the value at the given key.
+   * @param key - The key to delete the value at
+   */ delete(key) {
+        return execInWriteTx(this.store, (tx)=>tx.removeIndex(serializeKey(this.prefix, key)));
+    }
+    getAsync(key) {
+        return execInReadTx(this.store, async (tx)=>{
+            const val = await tx.getIndex(serializeKey(this.prefix, key));
+            return val.length > 0 ? this.encoder.unpack(val[0]) : undefined;
+        });
+    }
+    hasAsync(key) {
+        return execInReadTx(this.store, async (tx)=>(await tx.getIndex(serializeKey(this.prefix, key))).length > 0);
+    }
+    /**
+   * Iterates over the map's key-value entries in the key's natural order
+   * @param range - The range of keys to iterate over
+   */ async *entriesAsync(range) {
+        const reverse = range?.reverse ?? false;
+        const startKey = range?.start ? serializeKey(this.prefix, range.start) : minKey(this.prefix);
+        const endKey = range?.end ? serializeKey(this.prefix, range.end) : reverse ? maxKey(this.prefix) : undefined;
+        let tx = this.store.getCurrentWriteTx();
+        const shouldClose = !tx;
+        tx ??= this.store.getReadTx();
+        try {
+            for await (const [key, vals] of tx.iterateIndex(reverse ? endKey : startKey, reverse ? startKey : endKey, reverse, range?.limit)){
+                const deserializedKey = deserializeKey(this.prefix, key);
+                if (!deserializedKey) {
+                    break;
+                }
+                for (const val of vals){
+                    yield [
+                        deserializedKey,
+                        this.encoder.unpack(val)
+                    ];
+                }
+            }
+        } finally{
+            if (shouldClose) {
+                tx.close();
+            }
+        }
+    }
+    /**
+   * Iterates over the map's values in the key's natural order
+   * @param range - The range of keys to iterate over
+   */ async *valuesAsync(range) {
+        for await (const [_, value] of this.entriesAsync(range)){
+            yield value;
+        }
+    }
+    /**
+   * Iterates over the map's keys in the key's natural order
+   * @param range - The range of keys to iterate over
+   */ async *keysAsync(range) {
+        for await (const [key, _] of this.entriesAsync(range)){
+            yield key;
+        }
+    }
+    deleteValue(key, val) {
+        return execInWriteTx(this.store, (tx)=>tx.removeIndex(serializeKey(this.prefix, key), this.encoder.pack(val)));
+    }
+    async *getValuesAsync(key) {
+        const values = await execInReadTx(this.store, (tx)=>tx.getIndex(serializeKey(this.prefix, key)));
+        for (const value of values){
+            yield this.encoder.unpack(value);
+        }
+    }
+}

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

@@ -0,0 +1,112 @@
+export declare enum Database {
+    DATA = "data",
+    INDEX = "index"
+}
+export declare const CURSOR_PAGE_SIZE = 10;
+export declare enum LMDBMessageType {
+    OPEN_DATABASE = 100,
+    GET = 101,
+    HAS = 102,
+    START_CURSOR = 103,
+    ADVANCE_CURSOR = 104,
+    CLOSE_CURSOR = 105,
+    BATCH = 106,
+    STATS = 107,
+    CLOSE = 108
+}
+type Key = Uint8Array;
+type Value = Uint8Array;
+type OptionalValues = Array<Value[] | null>;
+type KeyOptionalValues = [Key, null | Array<Value>];
+type KeyValues = [Key, Value[]];
+interface OpenDatabaseRequest {
+    db: string;
+    uniqueKeys?: boolean;
+}
+interface GetRequest {
+    keys: Key[];
+    db: string;
+}
+interface GetResponse {
+    values: OptionalValues;
+}
+interface HasRequest {
+    entries: KeyOptionalValues[];
+    db: string;
+}
+interface StartCursorRequest {
+    key: Key;
+    reverse: boolean;
+    count: number | null;
+    onePage: boolean | null;
+    db: string;
+}
+interface AdvanceCursorRequest {
+    cursor: number;
+    count: number | null;
+}
+interface CloseCursorRequest {
+    cursor: number;
+}
+export interface Batch {
+    addEntries: Array<KeyValues>;
+    removeEntries: Array<KeyOptionalValues>;
+}
+interface BatchRequest {
+    batches: Map<string, Batch>;
+}
+export type LMDBRequestBody = {
+    [LMDBMessageType.OPEN_DATABASE]: OpenDatabaseRequest;
+    [LMDBMessageType.GET]: GetRequest;
+    [LMDBMessageType.HAS]: HasRequest;
+    [LMDBMessageType.START_CURSOR]: StartCursorRequest;
+    [LMDBMessageType.ADVANCE_CURSOR]: AdvanceCursorRequest;
+    [LMDBMessageType.CLOSE_CURSOR]: CloseCursorRequest;
+    [LMDBMessageType.BATCH]: BatchRequest;
+    [LMDBMessageType.STATS]: void;
+    [LMDBMessageType.CLOSE]: void;
+};
+interface GetResponse {
+    values: OptionalValues;
+}
+interface HasResponse {
+    exists: boolean[];
+}
+interface StartCursorResponse {
+    cursor: number | null;
+    entries: Array<KeyValues>;
+}
+interface AdvanceCursorResponse {
+    entries: Array<KeyValues>;
+    done: boolean;
+}
+interface BatchResponse {
+    durationNs: number;
+}
+interface BoolResponse {
+    ok: true;
+}
+interface StatsResponse {
+    stats: Array<{
+        name: string;
+        numDataItems: bigint | number;
+        totalUsedSize: bigint | number;
+    }>;
+    dbMapSizeBytes: bigint | number;
+}
+export type LMDBResponseBody = {
+    [LMDBMessageType.OPEN_DATABASE]: BoolResponse;
+    [LMDBMessageType.GET]: GetResponse;
+    [LMDBMessageType.HAS]: HasResponse;
+    [LMDBMessageType.START_CURSOR]: StartCursorResponse;
+    [LMDBMessageType.ADVANCE_CURSOR]: AdvanceCursorResponse;
+    [LMDBMessageType.CLOSE_CURSOR]: BoolResponse;
+    [LMDBMessageType.BATCH]: BatchResponse;
+    [LMDBMessageType.STATS]: StatsResponse;
+    [LMDBMessageType.CLOSE]: BoolResponse;
+};
+export interface LMDBMessageChannel {
+    sendMessage<T extends LMDBMessageType>(msgType: T, body: LMDBRequestBody[T]): Promise<LMDBResponseBody[T]>;
+}
+export {};
+//# sourceMappingURL=message.d.ts.map

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

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

package/dest/lmdb-v2/message.js

@@ -0,0 +1,18 @@
+export var Database = /*#__PURE__*/ function(Database) {
+    Database["DATA"] = "data";
+    Database["INDEX"] = "index";
+    return Database;
+}({});
+export const CURSOR_PAGE_SIZE = 10;
+export var LMDBMessageType = /*#__PURE__*/ function(LMDBMessageType) {
+    LMDBMessageType[LMDBMessageType["OPEN_DATABASE"] = 100] = "OPEN_DATABASE";
+    LMDBMessageType[LMDBMessageType["GET"] = 101] = "GET";
+    LMDBMessageType[LMDBMessageType["HAS"] = 102] = "HAS";
+    LMDBMessageType[LMDBMessageType["START_CURSOR"] = 103] = "START_CURSOR";
+    LMDBMessageType[LMDBMessageType["ADVANCE_CURSOR"] = 104] = "ADVANCE_CURSOR";
+    LMDBMessageType[LMDBMessageType["CLOSE_CURSOR"] = 105] = "CLOSE_CURSOR";
+    LMDBMessageType[LMDBMessageType["BATCH"] = 106] = "BATCH";
+    LMDBMessageType[LMDBMessageType["STATS"] = 107] = "STATS";
+    LMDBMessageType[LMDBMessageType["CLOSE"] = 108] = "CLOSE";
+    return LMDBMessageType;
+}({});

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

@@ -0,0 +1,14 @@
+import { type LMDBMessageChannel } from './message.js';
+export declare class ReadTransaction {
+    #private;
+    protected channel: LMDBMessageChannel;
+    protected open: boolean;
+    constructor(channel: LMDBMessageChannel);
+    close(): void;
+    protected assertIsOpen(): void;
+    get(key: Uint8Array): Promise<Uint8Array | undefined>;
+    getIndex(key: Uint8Array): Promise<Uint8Array[]>;
+    iterate(startKey: Uint8Array, endKey?: Uint8Array, reverse?: boolean, limit?: number): AsyncIterable<[Uint8Array, Uint8Array]>;
+    iterateIndex(startKey: Uint8Array, endKey?: Uint8Array, reverse?: boolean, limit?: number): AsyncIterable<[Uint8Array, Uint8Array[]]>;
+}
+//# sourceMappingURL=read_transaction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read_transaction.d.ts","sourceRoot":"","sources":["../../src/lmdb-v2/read_transaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,kBAAkB,EAAmB,MAAM,cAAc,CAAC;AAEpG,qBAAa,eAAe;;IAGd,SAAS,CAAC,OAAO,EAAE,kBAAkB;IAFjD,SAAS,CAAC,IAAI,UAAQ;gBAEA,OAAO,EAAE,kBAAkB;IAE1C,KAAK,IAAI,IAAI;IAOpB,SAAS,CAAC,YAAY;IAMT,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAMrD,QAAQ,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAM/C,OAAO,CACnB,QAAQ,EAAE,UAAU,EACpB,MAAM,CAAC,EAAE,UAAU,EACnB,OAAO,UAAQ,EACf,KAAK,CAAC,EAAE,MAAM,GACb,aAAa,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAI5B,YAAY,CACxB,QAAQ,EAAE,UAAU,EACpB,MAAM,CAAC,EAAE,UAAU,EACnB,OAAO,UAAQ,EACf,KAAK,CAAC,EAAE,MAAM,GACb,aAAa,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;CAqE7C"}

package/dest/lmdb-v2/read_transaction.js

@@ -0,0 +1,101 @@
+import { CURSOR_PAGE_SIZE, Database, LMDBMessageType } from './message.js';
+export class ReadTransaction {
+    channel;
+    open;
+    constructor(channel){
+        this.channel = channel;
+        this.open = true;
+    }
+    close() {
+        if (!this.open) {
+            return;
+        }
+        this.open = false;
+    }
+    assertIsOpen() {
+        if (!this.open) {
+            throw new Error('Transaction is closed');
+        }
+    }
+    async get(key) {
+        this.assertIsOpen();
+        const response = await this.channel.sendMessage(LMDBMessageType.GET, {
+            keys: [
+                key
+            ],
+            db: Database.DATA
+        });
+        return response.values[0]?.[0] ?? undefined;
+    }
+    async getIndex(key) {
+        this.assertIsOpen();
+        const response = await this.channel.sendMessage(LMDBMessageType.GET, {
+            keys: [
+                key
+            ],
+            db: Database.INDEX
+        });
+        return response.values[0] ?? [];
+    }
+    async *iterate(startKey, endKey, reverse = false, limit) {
+        yield* this.#iterate(Database.DATA, startKey, endKey, reverse, limit, (vals)=>vals[0]);
+    }
+    async *iterateIndex(startKey, endKey, reverse = false, limit) {
+        yield* this.#iterate(Database.INDEX, startKey, endKey, reverse, limit, (vals)=>vals);
+    }
+    async *#iterate(db, startKey, endKey, reverse, limit, map) {
+        this.assertIsOpen();
+        const response = await this.channel.sendMessage(LMDBMessageType.START_CURSOR, {
+            key: startKey,
+            reverse,
+            count: typeof limit === 'number' ? Math.min(limit, CURSOR_PAGE_SIZE) : CURSOR_PAGE_SIZE,
+            onePage: typeof limit === 'number' && limit < CURSOR_PAGE_SIZE,
+            db
+        });
+        const cursor = response.cursor;
+        let entries = response.entries;
+        let done = typeof cursor !== 'number';
+        let count = 0;
+        try {
+            // emit the first page and any subsequent pages in a while loop
+            // NB: end contition is in the middle of the while loop
+            while(entries.length > 0){
+                for (const [key, values] of entries){
+                    if (typeof limit === 'number' && count >= limit) {
+                        done = true;
+                        break;
+                    }
+                    if (endKey) {
+                        const cmp = Buffer.compare(key, endKey);
+                        if (!reverse && cmp >= 0 || reverse && cmp <= 0) {
+                            done = true;
+                            break;
+                        }
+                    }
+                    count++;
+                    yield [
+                        key,
+                        map(values)
+                    ];
+                }
+                // cursor is null if DB returned everything in the first page
+                if (typeof cursor !== 'number' || done) {
+                    break;
+                }
+                const response = await this.channel.sendMessage(LMDBMessageType.ADVANCE_CURSOR, {
+                    cursor,
+                    count: CURSOR_PAGE_SIZE
+                });
+                done = response.done;
+                entries = response.entries;
+            }
+        } finally{
+            // we might not have anything to close
+            if (typeof cursor === 'number') {
+                await this.channel.sendMessage(LMDBMessageType.CLOSE_CURSOR, {
+                    cursor
+                });
+            }
+        }
+    }
+}

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

@@ -0,0 +1,12 @@
+import type { AztecAsyncSingleton } from '../interfaces/singleton.js';
+import { type AztecLMDBStoreV2 } from './store.js';
+export declare class LMDBSingleValue<T> implements AztecAsyncSingleton<T> {
+    private store;
+    private key;
+    private encoder;
+    constructor(store: AztecLMDBStoreV2, name: string);
+    getAsync(): Promise<T | undefined>;
+    set(val: T): Promise<boolean>;
+    delete(): Promise<boolean>;
+}
+//# sourceMappingURL=singleton.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"singleton.d.ts","sourceRoot":"","sources":["../../src/lmdb-v2/singleton.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,KAAK,gBAAgB,EAA+B,MAAM,YAAY,CAAC;AAGhF,qBAAa,eAAe,CAAC,CAAC,CAAE,YAAW,mBAAmB,CAAC,CAAC,CAAC;IAGnD,OAAO,CAAC,KAAK;IAFzB,OAAO,CAAC,GAAG,CAAa;IACxB,OAAO,CAAC,OAAO,CAAiB;gBACZ,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM;IAIzD,QAAQ,IAAI,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAOlC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAO7B,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;CAM3B"}

package/dest/lmdb-v2/singleton.js

@@ -0,0 +1,31 @@
+import { Encoder } from 'msgpackr';
+import { execInReadTx, execInWriteTx } from './store.js';
+import { serializeKey } from './utils.js';
+export class LMDBSingleValue {
+    store;
+    key;
+    encoder;
+    constructor(store, name){
+        this.store = store;
+        this.encoder = new Encoder();
+        this.key = serializeKey(`singleton:${name}`, 'value');
+    }
+    getAsync() {
+        return execInReadTx(this.store, async (tx)=>{
+            const val = await tx.get(this.key);
+            return val ? this.encoder.unpack(val) : undefined;
+        });
+    }
+    set(val) {
+        return execInWriteTx(this.store, async (tx)=>{
+            await tx.set(this.key, this.encoder.pack(val));
+            return true;
+        });
+    }
+    delete() {
+        return execInWriteTx(this.store, async (tx)=>{
+            await tx.remove(this.key);
+            return true;
+        });
+    }
+}

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

@@ -0,0 +1,43 @@
+import { type Logger } from '@aztec/foundation/log';
+import type { AztecAsyncArray } from '../interfaces/array.js';
+import type { Key, StoreSize } from '../interfaces/common.js';
+import type { AztecAsyncCounter } from '../interfaces/counter.js';
+import type { AztecAsyncMap, AztecAsyncMultiMap } from '../interfaces/map.js';
+import type { AztecAsyncSet } from '../interfaces/set.js';
+import type { AztecAsyncSingleton } from '../interfaces/singleton.js';
+import type { AztecAsyncKVStore } from '../interfaces/store.js';
+import { type LMDBMessageChannel, LMDBMessageType, type LMDBRequestBody, type LMDBResponseBody } from './message.js';
+import { ReadTransaction } from './read_transaction.js';
+import { WriteTransaction } from './write_transaction.js';
+export declare class AztecLMDBStoreV2 implements AztecAsyncKVStore, LMDBMessageChannel {
+    private dataDir;
+    private log;
+    private cleanup?;
+    private open;
+    private channel;
+    private writerCtx;
+    private writerQueue;
+    private availableCursors;
+    private constructor();
+    get dataDirectory(): string;
+    private start;
+    static new(dataDir: string, dbMapSizeKb?: number, maxReaders?: number, cleanup?: () => Promise<void>, log?: Logger): Promise<AztecLMDBStoreV2>;
+    getReadTx(): ReadTransaction;
+    getCurrentWriteTx(): WriteTransaction | undefined;
+    openMap<K extends Key, V>(name: string): AztecAsyncMap<K, V>;
+    openMultiMap<K extends Key, V>(name: string): AztecAsyncMultiMap<K, V>;
+    openSingleton<T>(name: string): AztecAsyncSingleton<T>;
+    openArray<T>(name: string): AztecAsyncArray<T>;
+    openSet<K extends Key>(_name: string): AztecAsyncSet<K>;
+    openCounter<K extends Key>(_name: string): AztecAsyncCounter<K>;
+    transactionAsync<T extends Exclude<any, Promise<any>>>(callback: (tx: WriteTransaction) => Promise<T>): Promise<T>;
+    clear(): Promise<void>;
+    fork(): Promise<AztecAsyncKVStore>;
+    delete(): Promise<void>;
+    close(): Promise<void>;
+    sendMessage<T extends LMDBMessageType>(msgType: T, body: LMDBRequestBody[T]): Promise<LMDBResponseBody[T]>;
+    estimateSize(): Promise<StoreSize>;
+}
+export declare function execInWriteTx<T>(store: AztecLMDBStoreV2, fn: (tx: WriteTransaction) => Promise<T>): Promise<T>;
+export declare function execInReadTx<T>(store: AztecLMDBStoreV2, fn: (tx: ReadTransaction) => T | Promise<T>): Promise<T>;
+//# sourceMappingURL=store.d.ts.map

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

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