@openwallet-foundation/askar-nodejs 0.3.0

package/build/askar-shared/src/store/KeyEntry.d.ts

@@ -0,0 +1,23 @@
+import type { KeyEntryListHandle } from '../crypto';
+import { Key } from '../crypto';
+export type KeyEntryObject = {
+    algorithm: string;
+    name: string;
+    metadata: string | null;
+    tags: Record<string, unknown>;
+    key: Key;
+};
+export declare class KeyEntry {
+    private _list;
+    private _pos;
+    constructor({ list, pos }: {
+        list: KeyEntryListHandle;
+        pos: number;
+    });
+    get algorithm(): string;
+    get name(): string;
+    get metadata(): string | null;
+    get tags(): Record<string, unknown>;
+    get key(): Key;
+    toJson(): KeyEntryObject;
+}

package/build/askar-shared/src/store/KeyEntry.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KeyEntry = void 0;
+const crypto_1 = require("../crypto");
+class KeyEntry {
+    constructor({ list, pos }) {
+        this._list = list;
+        this._pos = pos;
+    }
+    get algorithm() {
+        return this._list.getAlgorithm(this._pos);
+    }
+    get name() {
+        return this._list.getName(this._pos);
+    }
+    get metadata() {
+        const metadata = this._list.getMetadata(this._pos);
+        return metadata;
+    }
+    get tags() {
+        const tags = this._list.getTags(this._pos);
+        if (!tags)
+            return {};
+        return JSON.parse(tags);
+    }
+    get key() {
+        return new crypto_1.Key(this._list.loadKey(this._pos));
+    }
+    toJson() {
+        return {
+            algorithm: this.algorithm,
+            name: this.name,
+            metadata: this.metadata,
+            tags: this.tags,
+            key: this.key,
+        };
+    }
+}
+exports.KeyEntry = KeyEntry;
+//# sourceMappingURL=KeyEntry.js.map

package/build/askar-shared/src/store/KeyEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeyEntry.js","sourceRoot":"","sources":["../../../../../askar-shared/src/store/KeyEntry.ts"],"names":[],"mappings":";;;AAEA,sCAA+B;AAU/B,MAAa,QAAQ;IAInB,YAAmB,EAAE,IAAI,EAAE,GAAG,EAA6C;QACzE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACjB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAA;IACjB,CAAC;IAED,IAAW,SAAS;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3C,CAAC;IAED,IAAW,IAAI;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACtC,CAAC;IAED,IAAW,QAAQ;QACjB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAElD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,IAAW,IAAI;QACb,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAE1C,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,CAAA;QACpB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4B,CAAA;IACpD,CAAC;IAED,IAAW,GAAG;QACZ,OAAO,IAAI,YAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IAC/C,CAAC;IAEM,MAAM;QACX,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAA;IACH,CAAC;CACF;AA3CD,4BA2CC"}

package/build/askar-shared/src/store/KeyEntryList.d.ts

@@ -0,0 +1,15 @@
+import type { KeyEntryObject } from '.';
+import type { KeyEntryListHandle } from '../crypto';
+import { KeyEntry } from './KeyEntry';
+export declare class KeyEntryList {
+    private _handle;
+    private _len;
+    constructor({ handle }: {
+        handle: KeyEntryListHandle;
+    });
+    get handle(): KeyEntryListHandle;
+    get length(): number;
+    getEntryByIndex(index: number): KeyEntry;
+    forEachKeyEntry(cb: (entry: KeyEntry, index?: number) => unknown): void;
+    toArray(): KeyEntryObject[];
+}

package/build/askar-shared/src/store/KeyEntryList.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KeyEntryList = void 0;
+const askar_1 = require("../askar");
+const KeyEntry_1 = require("./KeyEntry");
+class KeyEntryList {
+    constructor({ handle }) {
+        this._len = 0;
+        this._handle = handle;
+        this._len = askar_1.askar.keyEntryListCount({ keyEntryListHandle: handle });
+    }
+    get handle() {
+        return this._handle;
+    }
+    get length() {
+        return this._len;
+    }
+    getEntryByIndex(index) {
+        return new KeyEntry_1.KeyEntry({ list: this.handle, pos: index });
+    }
+    forEachKeyEntry(cb) {
+        for (let i = 0; i < this.length; i++) {
+            cb(this.getEntryByIndex(i), i);
+        }
+    }
+    toArray() {
+        const list = [];
+        this.forEachKeyEntry((key) => list.push(key.toJson()));
+        return list;
+    }
+}
+exports.KeyEntryList = KeyEntryList;
+//# sourceMappingURL=KeyEntryList.js.map

package/build/askar-shared/src/store/KeyEntryList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeyEntryList.js","sourceRoot":"","sources":["../../../../../askar-shared/src/store/KeyEntryList.ts"],"names":[],"mappings":";;;AAGA,oCAAgC;AAEhC,yCAAqC;AAErC,MAAa,YAAY;IAIvB,YAAmB,EAAE,MAAM,EAAkC;QAFrD,SAAI,GAAG,CAAC,CAAA;QAGd,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;QACrB,IAAI,CAAC,IAAI,GAAG,aAAK,CAAC,iBAAiB,CAAC,EAAE,kBAAkB,EAAE,MAAM,EAAE,CAAC,CAAA;IACrE,CAAC;IAED,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;IAED,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,IAAI,CAAA;IAClB,CAAC;IAEM,eAAe,CAAC,KAAa;QAClC,OAAO,IAAI,mBAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAA;IACxD,CAAC;IAEM,eAAe,CAAC,EAAgD;QACrE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAChC,CAAC;IACH,CAAC;IAEM,OAAO;QACZ,MAAM,IAAI,GAAqB,EAAE,CAAA;QACjC,IAAI,CAAC,eAAe,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;QACtD,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAhCD,oCAgCC"}

package/build/askar-shared/src/store/OpenSession.d.ts

@@ -0,0 +1,14 @@
+import type { StoreHandle } from '../crypto';
+import { Session } from './Session';
+export declare class OpenSession {
+    private store;
+    private profile?;
+    private isTxn;
+    private session?;
+    constructor({ store, isTxn, profile }: {
+        store: StoreHandle;
+        profile?: string;
+        isTxn: boolean;
+    });
+    open(): Promise<Session>;
+}

package/build/askar-shared/src/store/OpenSession.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenSession = void 0;
+const askar_1 = require("../askar");
+const error_1 = require("../error");
+const Session_1 = require("./Session");
+class OpenSession {
+    constructor({ store, isTxn, profile }) {
+        this.store = store;
+        this.isTxn = isTxn;
+        this.profile = profile;
+    }
+    async open() {
+        if (!this.store)
+            throw error_1.AskarError.customError({ message: 'Cannot start session from closed store' });
+        if (this.session)
+            throw error_1.AskarError.customError({ message: 'Session already opened' });
+        const sessionHandle = await askar_1.askar.sessionStart({
+            profile: this.profile,
+            asTransaction: this.isTxn,
+            storeHandle: this.store,
+        });
+        return new Session_1.Session({ isTxn: this.isTxn, handle: sessionHandle });
+    }
+}
+exports.OpenSession = OpenSession;
+//# sourceMappingURL=OpenSession.js.map

package/build/askar-shared/src/store/OpenSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenSession.js","sourceRoot":"","sources":["../../../../../askar-shared/src/store/OpenSession.ts"],"names":[],"mappings":";;;AAEA,oCAAgC;AAChC,oCAAqC;AAErC,uCAAmC;AAEnC,MAAa,WAAW;IAOtB,YAAmB,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAA4D;QACpG,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAEM,KAAK,CAAC,IAAI;QACf,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,MAAM,kBAAU,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,wCAAwC,EAAE,CAAC,CAAA;QACpG,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,kBAAU,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC,CAAA;QACrF,MAAM,aAAa,GAAG,MAAM,aAAK,CAAC,YAAY,CAAC;YAC7C,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,aAAa,EAAE,IAAI,CAAC,KAAK;YACzB,WAAW,EAAE,IAAI,CAAC,KAAK;SACxB,CAAC,CAAA;QACF,OAAO,IAAI,iBAAO,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAA;IAClE,CAAC;CACF;AAvBD,kCAuBC"}

package/build/askar-shared/src/store/Scan.d.ts

@@ -0,0 +1,28 @@
+import type { ScanHandle } from '../crypto';
+import type { EntryObject } from './Entry';
+import type { Store } from './Store';
+export declare class Scan {
+    private _handle?;
+    private _listHandle?;
+    private store;
+    private profile?;
+    private category;
+    private tagFilter?;
+    private offset?;
+    private limit?;
+    private orderBy?;
+    private descending?;
+    constructor({ store, category, limit, offset, profile, tagFilter, orderBy, descending, }: {
+        store: Store;
+        profile?: string;
+        category: string;
+        tagFilter?: Record<string, unknown>;
+        offset?: number;
+        limit?: number;
+        orderBy?: string;
+        descending?: boolean;
+    });
+    get handle(): ScanHandle | undefined;
+    private forEachRow;
+    fetchAll(): Promise<EntryObject[]>;
+}

package/build/askar-shared/src/store/Scan.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Scan = void 0;
+const askar_1 = require("../askar");
+const error_1 = require("../error");
+const EntryList_1 = require("./EntryList");
+class Scan {
+    constructor({ store, category, limit, offset, profile, tagFilter, orderBy, descending, }) {
+        this.category = category;
+        this.profile = profile;
+        this.tagFilter = tagFilter;
+        this.offset = offset;
+        this.limit = limit;
+        this.orderBy = orderBy;
+        this.descending = descending;
+        this.store = store;
+    }
+    get handle() {
+        return this._handle;
+    }
+    async forEachRow(cb) {
+        var _a;
+        if (!this.handle) {
+            if (!((_a = this.store) === null || _a === void 0 ? void 0 : _a.handle))
+                throw error_1.AskarError.customError({ message: 'Cannot scan from closed store' });
+            this._handle = await askar_1.askar.scanStart({
+                storeHandle: this.store.handle,
+                profile: this.profile,
+                category: this.category,
+                tagFilter: this.tagFilter,
+                limit: this.limit,
+                offset: this.offset,
+                orderBy: this.orderBy,
+                descending: this.descending,
+            });
+        }
+        if (!this._handle) {
+            throw error_1.AskarError.customError({ message: 'Handle is not set. Invalid state reached.' });
+        }
+        try {
+            let recordCount = 0;
+            // Loop while limit not reached (or no limit specified)
+            while (!this.limit || recordCount < this.limit) {
+                const listHandle = await askar_1.askar.scanNext({ scanHandle: this._handle });
+                if (!listHandle)
+                    break;
+                this._listHandle = listHandle;
+                const list = new EntryList_1.EntryList({ handle: this._listHandle });
+                recordCount = recordCount + list.length;
+                for (let index = 0; index < list.length; index++) {
+                    const entry = list.getEntryByIndex(index);
+                    cb(entry);
+                }
+            }
+        }
+        finally {
+            askar_1.askar.scanFree({ scanHandle: this._handle });
+        }
+    }
+    async fetchAll() {
+        const rows = [];
+        await this.forEachRow((row) => rows.push(row.toJson()));
+        return rows;
+    }
+}
+exports.Scan = Scan;
+//# sourceMappingURL=Scan.js.map

package/build/askar-shared/src/store/Scan.js.map

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

package/build/askar-shared/src/store/Session.d.ts

@@ -0,0 +1,86 @@
+import type { Key, SessionHandle } from '../crypto';
+import type { KeyAlgorithm } from '../enums';
+export declare class Session {
+    private _handle?;
+    private isTxn;
+    constructor({ handle, isTxn }: {
+        handle?: SessionHandle;
+        isTxn: boolean;
+    });
+    get isTransaction(): boolean;
+    get handle(): SessionHandle | undefined;
+    count({ category, tagFilter }: {
+        category: string;
+        tagFilter?: Record<string, unknown>;
+    }): Promise<number>;
+    fetch({ category, name, forUpdate, isJson, }: {
+        category: string;
+        name: string;
+        forUpdate?: boolean;
+        isJson?: boolean;
+    }): Promise<import("./Entry").EntryObject | null>;
+    fetchAll({ category, forUpdate, limit, tagFilter, isJson, orderBy, descending, }: {
+        category: string;
+        tagFilter?: Record<string, unknown>;
+        limit?: number;
+        forUpdate?: boolean;
+        orderBy?: string;
+        descending?: boolean;
+        isJson?: boolean;
+    }): Promise<import("./Entry").EntryObject[]>;
+    insert({ category, name, expiryMs, tags, value, }: {
+        category: string;
+        name: string;
+        value: string | Record<string, unknown>;
+        tags?: Record<string, unknown>;
+        expiryMs?: number;
+    }): Promise<void>;
+    replace({ category, name, expiryMs, tags, value, }: {
+        category: string;
+        name: string;
+        value: string | Record<string, unknown>;
+        tags?: Record<string, unknown>;
+        expiryMs?: number;
+    }): Promise<void>;
+    remove({ category, name }: {
+        category: string;
+        name: string;
+    }): Promise<void>;
+    removeAll({ category, tagFilter }: {
+        category: string;
+        tagFilter?: Record<string, unknown>;
+    }): Promise<void>;
+    insertKey({ name, key, expiryMs, metadata, tags, }: {
+        name: string;
+        key: Key;
+        metadata?: string;
+        tags?: Record<string, unknown>;
+        expiryMs?: number;
+    }): Promise<void>;
+    fetchKey({ name, forUpdate }: {
+        name: string;
+        forUpdate?: boolean;
+    }): Promise<import("@openwallet-foundation/askar-nodejs").KeyEntryObject | null>;
+    fetchAllKeys({ forUpdate, algorithm, limit, tagFilter, thumbprint, }: {
+        algorithm?: KeyAlgorithm;
+        thumbprint?: string;
+        tagFilter?: Record<string, unknown>;
+        limit?: number;
+        forUpdate?: boolean;
+    }): Promise<import("@openwallet-foundation/askar-nodejs").KeyEntryObject[]>;
+    updateKey({ name, expiryMs, metadata, tags, }: {
+        name: string;
+        metadata?: string;
+        tags?: Record<string, unknown>;
+        expiryMs?: number;
+    }): Promise<void>;
+    removeKey({ name }: {
+        name: string;
+    }): Promise<void>;
+    /**
+     * @note also closes the session
+     */
+    commit(): Promise<void>;
+    rollback(): Promise<void>;
+    close(): Promise<void>;
+}

package/build/askar-shared/src/store/Session.js

@@ -0,0 +1,182 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Session = void 0;
+const buffer_1 = require("buffer");
+const askar_1 = require("../askar");
+const EntryOperation_1 = require("../enums/EntryOperation");
+const error_1 = require("../error");
+const Entry_1 = require("./Entry");
+const EntryList_1 = require("./EntryList");
+const KeyEntryList_1 = require("./KeyEntryList");
+class Session {
+    constructor({ handle, isTxn }) {
+        this._handle = handle;
+        this.isTxn = isTxn;
+    }
+    get isTransaction() {
+        return this.isTxn;
+    }
+    get handle() {
+        return this._handle;
+    }
+    async count({ category, tagFilter }) {
+        if (!this.handle)
+            throw error_1.AskarError.customError({ message: 'Cannot count from closed session' });
+        return await askar_1.askar.sessionCount({ tagFilter, category, sessionHandle: this.handle });
+    }
+    async fetch({ category, name, forUpdate = false, isJson, }) {
+        if (!this.handle)
+            throw error_1.AskarError.customError({ message: 'Cannot fetch from a closed session' });
+        const handle = await askar_1.askar.sessionFetch({ forUpdate, name, category, sessionHandle: this.handle });
+        if (!handle)
+            return null;
+        const entry = new Entry_1.Entry({ list: handle, position: 0 });
+        const entryObject = entry.toJson(isJson);
+        handle.free();
+        return entryObject;
+    }
+    async fetchAll({ category, forUpdate = false, limit, tagFilter, isJson, orderBy, descending, }) {
+        if (!this.handle)
+            throw error_1.AskarError.customError({ message: 'Cannot fetch all from a closed session' });
+        const handle = await askar_1.askar.sessionFetchAll({
+            forUpdate,
+            limit,
+            tagFilter,
+            sessionHandle: this.handle,
+            category,
+            orderBy,
+            descending,
+        });
+        if (!handle)
+            return [];
+        const entryList = new EntryList_1.EntryList({ handle });
+        const entryObjects = entryList.toArray(isJson);
+        entryList.handle.free();
+        return entryObjects;
+    }
+    async insert({ category, name, expiryMs, tags, value, }) {
+        if (!this.handle)
+            throw error_1.AskarError.customError({ message: 'Cannot insert with a closed session' });
+        const serializedValue = typeof value === 'string' ? value : JSON.stringify(value);
+        await askar_1.askar.sessionUpdate({
+            value: Uint8Array.from(buffer_1.Buffer.from(serializedValue)),
+            expiryMs,
+            tags,
+            name,
+            category,
+            sessionHandle: this.handle,
+            operation: EntryOperation_1.EntryOperation.Insert,
+        });
+    }
+    async replace({ category, name, expiryMs, tags, value, }) {
+        if (!this.handle)
+            throw error_1.AskarError.customError({ message: 'Cannot replace with a closed session' });
+        const serializedValue = typeof value === 'string' ? value : JSON.stringify(value);
+        await askar_1.askar.sessionUpdate({
+            value: Uint8Array.from(buffer_1.Buffer.from(serializedValue)),
+            expiryMs,
+            tags,
+            name,
+            category,
+            sessionHandle: this.handle,
+            operation: EntryOperation_1.EntryOperation.Replace,
+        });
+    }
+    async remove({ category, name }) {
+        if (!this.handle)
+            throw error_1.AskarError.customError({ message: 'Cannot remove with a closed session' });
+        await askar_1.askar.sessionUpdate({
+            name,
+            category,
+            sessionHandle: this.handle,
+            operation: EntryOperation_1.EntryOperation.Remove,
+        });
+    }
+    async removeAll({ category, tagFilter }) {
+        if (!this.handle)
+            throw error_1.AskarError.customError({ message: 'Cannot remove all with a closed session' });
+        await askar_1.askar.sessionRemoveAll({
+            category,
+            sessionHandle: this.handle,
+            tagFilter,
+        });
+    }
+    async insertKey({ name, key, expiryMs, metadata, tags, }) {
+        if (!this.handle)
+            throw error_1.AskarError.customError({ message: 'Cannot insert a key with a closed session' });
+        await askar_1.askar.sessionInsertKey({
+            expiryMs,
+            tags,
+            metadata,
+            name,
+            sessionHandle: this.handle,
+            localKeyHandle: key.handle,
+        });
+    }
+    async fetchKey({ name, forUpdate = false }) {
+        if (!this.handle)
+            throw error_1.AskarError.customError({ message: 'Cannot fetch a key with a closed session' });
+        const handle = await askar_1.askar.sessionFetchKey({ forUpdate, name, sessionHandle: this.handle });
+        if (!handle)
+            return null;
+        const keyEntryList = new KeyEntryList_1.KeyEntryList({ handle });
+        const keyEntryObject = keyEntryList.getEntryByIndex(0).toJson();
+        keyEntryList.handle.free();
+        return keyEntryObject;
+    }
+    async fetchAllKeys({ forUpdate = false, algorithm, limit, tagFilter, thumbprint, }) {
+        if (!this.handle)
+            throw error_1.AskarError.customError({ message: 'Cannot fetch all keys with a closed session' });
+        const handle = await askar_1.askar.sessionFetchAllKeys({
+            forUpdate,
+            limit,
+            tagFilter,
+            thumbprint,
+            algorithm,
+            sessionHandle: this.handle,
+        });
+        if (!handle)
+            return [];
+        const keyEntryList = new KeyEntryList_1.KeyEntryList({ handle });
+        const keyEntryObjects = keyEntryList.toArray();
+        keyEntryList.handle.free();
+        return keyEntryObjects;
+    }
+    async updateKey({ name, expiryMs, metadata, tags, }) {
+        if (!this.handle)
+            throw error_1.AskarError.customError({ message: 'Cannot update a key with a closed session' });
+        await askar_1.askar.sessionUpdateKey({ expiryMs, tags, metadata, name, sessionHandle: this.handle });
+    }
+    async removeKey({ name }) {
+        if (!this.handle)
+            throw error_1.AskarError.customError({ message: 'Cannot remove a key with a closed session' });
+        await askar_1.askar.sessionRemoveKey({ name, sessionHandle: this.handle });
+    }
+    /**
+     * @note also closes the session
+     */
+    async commit() {
+        if (!this.isTxn)
+            throw error_1.AskarError.customError({ message: 'Session is not a transaction' });
+        if (!this.handle)
+            throw error_1.AskarError.customError({ message: 'Cannot commit a closed session' });
+        await this.handle.close(true);
+        this._handle = undefined;
+    }
+    async rollback() {
+        if (!this.isTxn)
+            throw error_1.AskarError.customError({ message: 'Session is not a transaction' });
+        if (!this.handle)
+            throw error_1.AskarError.customError({ message: 'Cannot rollback a closed session' });
+        await this.handle.close(false);
+        this._handle = undefined;
+    }
+    async close() {
+        if (!this.handle)
+            throw error_1.AskarError.customError({ message: 'Cannot close a closed session' });
+        await this.handle.close(false);
+        this._handle = undefined;
+    }
+}
+exports.Session = Session;
+//# sourceMappingURL=Session.js.map

package/build/askar-shared/src/store/Session.js.map

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

package/build/askar-shared/src/store/Store.d.ts

@@ -0,0 +1,58 @@
+import type { StoreHandle } from '../crypto';
+import type { StoreKeyMethod } from './StoreKeyMethod';
+import { OpenSession } from './OpenSession';
+import { Scan } from './Scan';
+export declare class Store {
+    private _handle;
+    private _opener?;
+    private _uri;
+    constructor({ handle, uri }: {
+        handle: StoreHandle;
+        uri: string;
+    });
+    get handle(): StoreHandle;
+    static generateRawKey(seed?: Uint8Array): string;
+    get uri(): string;
+    createProfile(name?: string): Promise<string>;
+    getDefaultProfile(): Promise<string>;
+    setDefaultProfile(name: string): Promise<void>;
+    listProfiles(): Promise<string[]>;
+    removeProfile(name: string): Promise<number>;
+    rekey({ keyMethod, passKey }: {
+        keyMethod?: StoreKeyMethod;
+        passKey: string;
+    }): Promise<void>;
+    static provision({ uri, recreate, keyMethod, passKey, profile, }: {
+        uri: string;
+        keyMethod?: StoreKeyMethod;
+        passKey?: string;
+        profile?: string;
+        recreate: boolean;
+    }): Promise<Store>;
+    static open({ uri, keyMethod, passKey, profile, }: {
+        uri: string;
+        keyMethod?: StoreKeyMethod;
+        passKey?: string;
+        profile?: string;
+    }): Promise<Store>;
+    close(remove?: boolean): Promise<number | false>;
+    static remove(uri: string): Promise<number>;
+    session(profile?: string): OpenSession;
+    transaction(profile?: string): OpenSession;
+    openSession(isTransaction?: boolean): Promise<import("@openwallet-foundation/askar-nodejs").Session>;
+    scan(options: {
+        category: string;
+        tagFilter?: Record<string, unknown>;
+        offset?: number;
+        limit?: number;
+        profile?: string;
+        orderBy?: string;
+        descending?: boolean;
+    }): Scan;
+    copyTo({ uri, keyMethod, passKey, recreate, }: {
+        uri: string;
+        keyMethod?: StoreKeyMethod;
+        passKey?: string;
+        recreate: boolean;
+    }): Promise<void>;
+}