@bsv/wallet-toolbox-client 2.4.3 → 2.4.20

package/out/src/storage/StorageIdb.js

@@ -1,1701 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.StorageIdb = void 0;
-const idb_1 = require("idb");
-const idbHelpers_1 = require("./idbHelpers");
-const utilityHelpers_1 = require("../utility/utilityHelpers");
-const StorageProvider_1 = require("./StorageProvider");
-const listActionsIdb_1 = require("./methods/listActionsIdb");
-const listOutputsIdb_1 = require("./methods/listOutputsIdb");
-const reviewStatusIdb_1 = require("./methods/reviewStatusIdb");
-const purgeDataIdb_1 = require("./methods/purgeDataIdb");
-const WERR_errors_1 = require("../sdk/WERR_errors");
-const managedChange_1 = require("./methods/managedChange");
-/**
- * Shared cursor-scan loop used by all `filterXxx` methods of StorageIdb.
- *
- * Walks `cursor` forward, applying `since`, a caller-supplied `matches`
- * predicate, paging (offset / limit), and an async `accept` callback for
- * records that pass all filters.  Returns the number of accepted records.
- *
- * Implemented as a module-level helper (not a class method) so that
- * profiling/instrumentation that wraps class-prototype methods cannot
- * intercept or mutate its `matches` / `accept` callbacks.
- */
-async function scanCursor(
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-cursor, since, offset, limit, matches, accept) {
-    let skipped = 0;
-    let count = 0;
-    for (; cursor != null; cursor = await cursor.continue()) {
-        const r = cursor.value;
-        if (since != null && since > r.updated_at)
-            continue;
-        if (!await matches(r))
-            continue;
-        if (skipped < offset) {
-            skipped++;
-            continue;
-        }
-        accept(r);
-        count++;
-        if ((limit ?? 0) > 0 && count >= limit)
-            break;
-    }
-    return count;
-}
-/**
- * This class implements the `StorageProvider` interface using IndexedDB,
- * via the promises wrapper package `idb`.
- */
-class StorageIdb extends StorageProvider_1.StorageProvider {
-    dbName;
-    db;
-    constructor(options) {
-        super(options);
-        this.dbName = `wallet-toolbox-${this.chain}net`;
-    }
-    /**
-     * This method must be called at least once before any other method accesses the database,
-     * and each time the schema may have updated.
-     *
-     * If the database has already been created in this context, `storageName` and `storageIdentityKey`
-     * are ignored.
-     *
-     * @param storageName
-     * @param storageIdentityKey
-     * @returns
-     */
-    async migrate(storageName, storageIdentityKey) {
-        const db = await this.verifyDB(storageName, storageIdentityKey);
-        return db.version.toString();
-    }
-    /**
-     * Following initial database initialization, this method verfies that db is ready for use.
-     *
-     * @throws `WERR_INVALID_OPERATION` if the database has not been initialized by a call to `migrate`.
-     *
-     * @param storageName
-     * @param storageIdentityKey
-     *
-     * @returns
-     */
-    async verifyDB(storageName, storageIdentityKey) {
-        if (this.db != null)
-            return this.db;
-        this.db = await this.initDB(storageName, storageIdentityKey);
-        this._settings = (await this.db.getAll('settings'))[0];
-        this.whenLastAccess = new Date();
-        return this.db;
-    }
-    /**
-     * Convert the standard optional `TrxToken` parameter into either a direct knex database instance,
-     * or a Knex.Transaction as appropriate.
-     */
-    toDbTrx(stores, mode, trx) {
-        if (trx != null) {
-            const t = trx;
-            return t;
-        }
-        else {
-            if (this.db == null)
-                throw new Error('not initialized');
-            const db = this.db;
-            const trx = db.transaction(stores.length > 0 ? stores : this.allStores, mode);
-            this.whenLastAccess = new Date();
-            return trx;
-        }
-    }
-    /**
-     * Called by `makeAvailable` to return storage `TableSettings`.
-     * Since this is the first async method that must be called by all clients,
-     * it is where async initialization occurs.
-     *
-     * After initialization, cached settings are returned.
-     *
-     * @param trx
-     */
-    async readSettings(trx) {
-        await this.verifyDB();
-        return this._settings;
-    }
-    async initDB(storageName, storageIdentityKey) {
-        const chain = this.chain;
-        const maxOutputScript = 1024;
-        const db = await (0, idb_1.openDB)(this.dbName, 1, {
-            upgrade(db) {
-                (0, idbHelpers_1.upgradeAllStoresV1)(db);
-                if (!db.objectStoreNames.contains('settings')) {
-                    if (storageName == null || storageName === '' || storageIdentityKey == null || storageIdentityKey === '') {
-                        throw new WERR_errors_1.WERR_INVALID_OPERATION('migrate must be called before first access');
-                    }
-                    const settings = db.createObjectStore('settings', { keyPath: 'storageIdentityKey' });
-                    const s = {
-                        created_at: new Date(),
-                        updated_at: new Date(),
-                        storageIdentityKey,
-                        storageName,
-                        chain,
-                        dbtype: 'IndexedDB',
-                        maxOutputScript
-                    };
-                    void settings.put(s);
-                }
-            }
-        });
-        return db;
-    }
-    //
-    // StorageProvider abstract methods
-    //
-    async reviewStatus(args) {
-        return await (0, reviewStatusIdb_1.reviewStatusIdb)(this, args);
-    }
-    async purgeData(params, trx) {
-        return await (0, purgeDataIdb_1.purgeDataIdb)(this, params, trx);
-    }
-    /**
-     * Proceeds in three stages:
-     * 1. Find an output that exactly funds the transaction (if exactSatoshis is not undefined).
-     * 2. Find an output that overfunds by the least amount (targetSatoshis).
-     * 3. Find an output that comes as close to funding as possible (targetSatoshis).
-     * 4. Return undefined if no output is found.
-     *
-     * Outputs must belong to userId and basketId and satisfy the wallet-managed
-     * BRC-29 change policy.
-     * Their corresponding transaction must have status of 'completed', 'unproven', or 'sending' (if excludeSending is false).
-     *
-     * @param userId
-     * @param basketId
-     * @param targetSatoshis
-     * @param exactSatoshis
-     * @param excludeSending
-     * @param transactionId
-     * @returns next funding output to add to transaction or undefined if there are none.
-     */
-    async allocateChangeInput(userId, basketId, targetSatoshis, exactSatoshis, excludeSending, transactionId) {
-        const dbTrx = this.toDbTrx(['outputs', 'transactions', 'proven_txs', 'proven_tx_reqs'], 'readwrite');
-        try {
-            const txStatus = ['completed', 'unproven'];
-            if (!excludeSending)
-                txStatus.push('sending');
-            const args = {
-                partial: { userId, basketId, spendable: true, ...managedChange_1.managedChangeOutputFields },
-                txStatus,
-                // Skip per-output script hydration during the candidate scan — we only need
-                // the locking script for the one we actually pick below. Matches Knex's
-                // pattern: SELECT candidates cheaply, hydrate the chosen output explicitly.
-                noScript: true,
-                trx: dbTrx
-            };
-            const outputs = (await this.findOutputs(args)).filter(managedChange_1.isAutoSpendableChangeOutput);
-            let output;
-            let scores = [];
-            for (const o of outputs) {
-                if (exactSatoshis != null && exactSatoshis !== 0 && o.satoshis === exactSatoshis) {
-                    output = o;
-                    break;
-                }
-                const score = o.satoshis - targetSatoshis;
-                scores.push({ output: o, score });
-            }
-            if (output == null) {
-                // sort scores increasing by score property
-                scores = scores.sort((a, b) => a.score - b.score);
-                // find the first score that is greater than or equal to 0
-                const o = scores.find(s => s.score >= 0);
-                if (o != null) {
-                    // stage 2 satisfied (minimally funded)
-                    output = o.output;
-                }
-                else if (scores.length > 0) {
-                    // stage 3 satisfied (minimally under-funded)
-                    output = scores.at(-1).output;
-                }
-                else {
-                    // no available funding outputs
-                    output = undefined;
-                }
-            }
-            if (output != null) {
-                // mark output as spent by transactionId
-                await this.updateOutput(output.outputId, { spendable: false, spentBy: transactionId }, dbTrx);
-                // Hydrate the locking script for the chosen output. Identical to Knex canon at
-                // StorageKnex.allocateChangeInput: required when the script was offloaded into
-                // rawTx storage due to exceeding maxOutputScript.
-                await this.validateOutputScript(output, dbTrx);
-            }
-            return output;
-        }
-        finally {
-            await dbTrx.done;
-        }
-    }
-    async getProvenOrRawTx(txid, trx) {
-        const r = {
-            proven: undefined,
-            rawTx: undefined,
-            inputBEEF: undefined
-        };
-        r.proven = (0, utilityHelpers_1.verifyOneOrNone)(await this.findProvenTxs({ partial: { txid }, trx }));
-        if (r.proven == null) {
-            const req = (0, utilityHelpers_1.verifyOneOrNone)(await this.findProvenTxReqs({ partial: { txid }, trx }));
-            if ((req != null) && ['unsent', 'unmined', 'unconfirmed', 'sending', 'nosend', 'completed'].includes(req.status)) {
-                r.rawTx = req.rawTx;
-                r.inputBEEF = req.inputBEEF;
-            }
-        }
-        return r;
-    }
-    async getRawTxOfKnownValidTransaction(txid, offset, length, trx) {
-        if (txid == null || txid === '')
-            return undefined;
-        if (!this.isAvailable())
-            await this.makeAvailable();
-        const sliceRequested = offset !== undefined && length !== undefined && Number.isInteger(offset) && Number.isInteger(length);
-        // Slice path uses an extended status set that includes 'unfail' — matches Knex
-        // canon at StorageKnex.ts:131. The non-slice path continues to delegate to
-        // getProvenOrRawTx which uses the narrower set.
-        const rawTx = sliceRequested
-            ? await this.getRawTxForSlice(txid, trx)
-            : await this.getRawTxFull(txid, trx);
-        if (rawTx != null && sliceRequested) {
-            return rawTx.slice(offset, offset + length);
-        }
-        return rawTx;
-    }
-    async getRawTxForSlice(txid, trx) {
-        const proven = (0, utilityHelpers_1.verifyOneOrNone)(await this.findProvenTxs({ partial: { txid }, trx }));
-        if (proven != null)
-            return proven.rawTx;
-        const req = (0, utilityHelpers_1.verifyOneOrNone)(await this.findProvenTxReqs({ partial: { txid }, trx }));
-        const validStatuses = ['unsent', 'nosend', 'sending', 'unmined', 'completed', 'unfail'];
-        if (req != null && validStatuses.includes(req.status))
-            return req.rawTx;
-        return undefined;
-    }
-    async getRawTxFull(txid, trx) {
-        const r = await this.getProvenOrRawTx(txid, trx);
-        return r.proven != null ? r.proven.rawTx : r.rawTx;
-    }
-    async getLabelsForTransactionId(transactionId, trx) {
-        const maps = await this.findTxLabelMaps({ partial: { transactionId, isDeleted: false }, trx });
-        const labelIds = maps.map(m => m.txLabelId);
-        const labels = [];
-        for (const txLabelId of labelIds) {
-            // verifyOneOrNone: a map row may reference a label that was later soft-deleted.
-            // Knex/Bun drop it via JOIN; we must do the same silently or we'd break the whole
-            // listActions response. Skip + log so persistent orphans still produce a signal.
-            const label = (0, utilityHelpers_1.verifyOneOrNone)(await this.findTxLabels({ partial: { txLabelId, isDeleted: false }, trx }));
-            if (label != null) {
-                labels.push(label);
-            }
-            else {
-                console.debug(`[StorageIdb] orphan tx_labels_map row skipped: transactionId=${String(transactionId)} txLabelId=${txLabelId}`);
-            }
-        }
-        return labels;
-    }
-    async getTagsForOutputId(outputId, trx) {
-        const maps = await this.findOutputTagMaps({ partial: { outputId, isDeleted: false }, trx });
-        const tagIds = maps.map(m => m.outputTagId);
-        const tags = [];
-        for (const outputTagId of tagIds) {
-            const tag = (0, utilityHelpers_1.verifyOneOrNone)(await this.findOutputTags({ partial: { outputTagId, isDeleted: false }, trx }));
-            if (tag != null) {
-                tags.push(tag);
-            }
-            else {
-                console.debug(`[StorageIdb] orphan output_tags_map row skipped: outputId=${outputId} outputTagId=${outputTagId}`);
-            }
-        }
-        return tags;
-    }
-    async listActions(auth, vargs) {
-        if (auth.userId == null)
-            throw new WERR_errors_1.WERR_UNAUTHORIZED();
-        return await (0, listActionsIdb_1.listActionsIdb)(this, auth, vargs);
-    }
-    async listOutputs(auth, vargs) {
-        if (auth.userId == null)
-            throw new WERR_errors_1.WERR_UNAUTHORIZED();
-        return await (0, listOutputsIdb_1.listOutputsIdb)(this, auth, vargs);
-    }
-    async countChangeInputs(userId, basketId, excludeSending) {
-        const txStatus = ['completed', 'unproven'];
-        if (!excludeSending)
-            txStatus.push('sending');
-        const args = {
-            partial: { userId, basketId, spendable: true, ...managedChange_1.managedChangeOutputFields },
-            txStatus,
-            noScript: true
-        };
-        let count = 0;
-        await this.filterOutputs(args, r => {
-            if ((0, managedChange_1.isAutoSpendableChangeOutput)(r))
-                count++;
-        });
-        return count;
-    }
-    async findCertificatesAuth(auth, args) {
-        if (auth.userId == null || (args.partial.userId != null && args.partial.userId !== 0 && args.partial.userId !== auth.userId))
-            throw new WERR_errors_1.WERR_UNAUTHORIZED();
-        args.partial.userId = auth.userId;
-        return await this.findCertificates(args);
-    }
-    async findOutputBasketsAuth(auth, args) {
-        if (auth.userId == null || (args.partial.userId != null && args.partial.userId !== 0 && args.partial.userId !== auth.userId))
-            throw new WERR_errors_1.WERR_UNAUTHORIZED();
-        args.partial.userId = auth.userId;
-        return await this.findOutputBaskets(args);
-    }
-    async findOutputsAuth(auth, args) {
-        if (auth.userId == null || (args.partial.userId != null && args.partial.userId !== 0 && args.partial.userId !== auth.userId))
-            throw new WERR_errors_1.WERR_UNAUTHORIZED();
-        args.partial.userId = auth.userId;
-        return await this.findOutputs(args);
-    }
-    async insertCertificateAuth(auth, certificate) {
-        if (auth.userId == null || (certificate.userId != null && certificate.userId !== 0 && certificate.userId !== auth.userId))
-            throw new WERR_errors_1.WERR_UNAUTHORIZED();
-        certificate.userId = auth.userId;
-        return await this.insertCertificate(certificate);
-    }
-    //
-    // StorageReaderWriter abstract methods
-    //
-    async dropAllData() {
-        await (0, idb_1.deleteDB)(this.dbName);
-    }
-    /**
-     * Reject undefined values in a `partial` filter argument. Matches
-     * Knex behavior (which throws `Undefined binding(s) detected`) so that
-     * callers can't pass an unmapped idMap lookup through as a silent
-     * match-anything. Omit the key to skip filtering on it; pass null if
-     * you need IS NULL semantics (only meaningful for nullable columns).
-     */
-    assertNoUndefinedInPartial(partial) {
-        if (partial == null)
-            return;
-        for (const k of Object.keys(partial)) {
-            if (partial[k] === undefined) {
-                throw new WERR_errors_1.WERR_INVALID_PARAMETER(`args.partial.${k}`, 'not undefined. Passing undefined as a filter value is not supported — omit the key to skip filtering. Matches Knex semantics.');
-            }
-        }
-    }
-    async filterOutputTagMaps(args, filtered, userId) {
-        this.assertNoUndefinedInPartial(args.partial);
-        const dbTrx = this.toDbTrx(['output_tags_map', 'output_tags'], 'readonly', args.trx);
-        const store = dbTrx.objectStore('output_tags_map');
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        let cursor;
-        if (args.partial?.outputTagId !== undefined) {
-            cursor = await store.index('outputTagId').openCursor(args.partial.outputTagId);
-        }
-        else if (args.partial?.outputId !== undefined) {
-            cursor = await store.index('outputId').openCursor(args.partial.outputId);
-        }
-        else {
-            cursor = await store.openCursor();
-        }
-        await scanCursor(cursor, args.since, args.paged?.offset ?? 0, args.paged?.limit, async (r) => {
-            if (args.tagIds != null && !args.tagIds.includes(r.outputTagId))
-                return false;
-            if (!(0, idbHelpers_1.matchesOutputTagMapPartial)(r, args.partial))
-                return false;
-            if (userId !== undefined) {
-                const tagsForUser = await this.countOutputTags({ partial: { userId, outputTagId: r.outputTagId }, trx: dbTrx });
-                if (tagsForUser === 0)
-                    return false;
-            }
-            return true;
-        }, filtered);
-        if (args.trx == null)
-            await dbTrx.done;
-    }
-    async findOutputTagMaps(args) {
-        const results = [];
-        await this.filterOutputTagMaps(args, r => {
-            results.push(this.validateEntity(r));
-        });
-        return results;
-    }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    async openProvenTxReqsCursor(
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    store, 
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    partial, direction
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    ) {
-        if (partial?.provenTxReqId != null && partial.provenTxReqId !== 0)
-            return store.openCursor(partial.provenTxReqId, direction);
-        if (partial?.provenTxId !== undefined)
-            return store.index('provenTxId').openCursor(partial.provenTxId, direction);
-        if (partial?.txid !== undefined)
-            return store.index('txid').openCursor(partial.txid, direction);
-        if (partial?.status !== undefined)
-            return store.index('status').openCursor(partial.status, direction);
-        if (partial?.batch !== undefined)
-            return store.index('batch').openCursor(partial.batch, direction);
-        return store.openCursor(null, direction);
-    }
-    async filterProvenTxReqs(args, filtered, userId) {
-        this.assertNoUndefinedInPartial(args.partial);
-        if (args.partial.rawTx != null) {
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER('args.partial.rawTx', 'undefined. ProvenTxReqs may not be found by rawTx value.');
-        }
-        if (args.partial.inputBEEF != null) {
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER('args.partial.inputBEEF', 'undefined. ProvenTxReqs may not be found by inputBEEF value.');
-        }
-        const dbTrx = this.toDbTrx(['proven_tx_reqs', 'transactions'], 'readonly', args.trx);
-        const direction = args.orderDescending === true ? 'prev' : 'next';
-        const store = dbTrx.objectStore('proven_tx_reqs');
-        const cursor = await this.openProvenTxReqsCursor(store, args.partial, direction);
-        await scanCursor(cursor, args.since, args.paged?.offset ?? 0, args.paged?.limit, async (r) => {
-            if (!(0, idbHelpers_1.matchesProvenTxReqPartial)(r, args.partial))
-                return false;
-            if (args.status != null && args.status.length > 0 && !args.status.includes(r.status))
-                return false;
-            if (args.txids != null && args.txids.length > 0 && !args.txids.includes(r.txid))
-                return false;
-            if (userId !== undefined) {
-                const txsForUser = await this.countTransactions({ partial: { userId, txid: r.txid }, trx: dbTrx });
-                if (txsForUser === 0)
-                    return false;
-            }
-            return true;
-        }, filtered);
-        if (args.trx == null)
-            await dbTrx.done;
-    }
-    async findProvenTxReqs(args) {
-        const results = [];
-        await this.filterProvenTxReqs(args, r => {
-            results.push(this.validateEntity(r));
-        });
-        return results;
-    }
-    async filterProvenTxs(args, filtered, userId) {
-        this.assertNoUndefinedInPartial(args.partial);
-        if (args.partial.rawTx != null) {
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER('args.partial.rawTx', 'undefined. ProvenTxs may not be found by rawTx value.');
-        }
-        if (args.partial.merklePath != null) {
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER('args.partial.merklePath', 'undefined. ProvenTxs may not be found by merklePath value.');
-        }
-        const dbTrx = this.toDbTrx(['proven_txs', 'transactions'], 'readonly', args.trx);
-        const direction = args.orderDescending === true ? 'prev' : 'next';
-        const store = dbTrx.objectStore('proven_txs');
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        let cursor;
-        if (args.partial?.provenTxId != null && args.partial.provenTxId > 0) {
-            cursor = await store.openCursor(args.partial.provenTxId, direction);
-        }
-        else if (args.partial?.txid !== undefined) {
-            cursor = await store.index('txid').openCursor(args.partial.txid, direction);
-        }
-        else {
-            cursor = await store.openCursor(null, direction);
-        }
-        await scanCursor(cursor, args.since, args.paged?.offset ?? 0, args.paged?.limit, async (r) => {
-            if (!(0, idbHelpers_1.matchesProvenTxPartial)(r, args.partial))
-                return false;
-            if (userId !== undefined) {
-                const txCount = await this.countTransactions({ partial: { userId, provenTxId: r.provenTxId }, trx: dbTrx });
-                if (txCount === 0)
-                    return false;
-            }
-            return true;
-        }, filtered);
-        if (args.trx == null)
-            await dbTrx.done;
-    }
-    async findProvenTxs(args) {
-        const results = [];
-        await this.filterProvenTxs(args, r => {
-            results.push(this.validateEntity(r));
-        });
-        return results;
-    }
-    async filterTxLabelMaps(args, filtered, userId) {
-        this.assertNoUndefinedInPartial(args.partial);
-        const dbTrx = this.toDbTrx(['tx_labels_map', 'tx_labels'], 'readonly', args.trx);
-        const store = dbTrx.objectStore('tx_labels_map');
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        let cursor;
-        if (args.partial?.transactionId !== undefined) {
-            cursor = await store.index('transactionId').openCursor(args.partial.transactionId);
-        }
-        else if (args.partial?.txLabelId !== undefined) {
-            cursor = await store.index('txLabelId').openCursor(args.partial.txLabelId);
-        }
-        else {
-            cursor = await store.openCursor();
-        }
-        await scanCursor(cursor, args.since, args.paged?.offset ?? 0, args.paged?.limit, async (r) => {
-            if (!(0, idbHelpers_1.matchesTxLabelMapPartial)(r, args.partial))
-                return false;
-            if (userId !== undefined) {
-                const labelCount = await this.countTxLabels({ partial: { userId, txLabelId: r.txLabelId }, trx: dbTrx });
-                if (labelCount === 0)
-                    return false;
-            }
-            return true;
-        }, filtered);
-        if (args.trx == null)
-            await dbTrx.done;
-    }
-    async findTxLabelMaps(args) {
-        const results = [];
-        await this.filterTxLabelMaps(args, r => {
-            results.push(this.validateEntity(r));
-        });
-        return results;
-    }
-    async countOutputTagMaps(args) {
-        let count = 0;
-        await this.filterOutputTagMaps(args, () => {
-            count++;
-        });
-        return count;
-    }
-    async countProvenTxReqs(args) {
-        let count = 0;
-        await this.filterProvenTxReqs(args, () => {
-            count++;
-        });
-        return count;
-    }
-    async countProvenTxs(args) {
-        let count = 0;
-        await this.filterProvenTxs(args, () => {
-            count++;
-        });
-        return count;
-    }
-    async countTxLabelMaps(args) {
-        let count = 0;
-        await this.filterTxLabelMaps(args, () => {
-            count++;
-        });
-        return count;
-    }
-    async insertCertificate(certificate, trx) {
-        const e = await this.validateEntityForInsert(certificate, trx, undefined, ['isDeleted']);
-        // Strip non-schema runtime fields before insert. Matches Knex canon.
-        if (e.logger != null)
-            delete e.logger;
-        const fields = e.fields;
-        if (e.fields != null)
-            delete e.fields;
-        if (e.certificateId === 0)
-            delete e.certificateId;
-        const dbTrx = this.toDbTrx(['certificates', 'certificate_fields'], 'readwrite', trx);
-        const store = dbTrx.objectStore('certificates');
-        try {
-            const id = Number(await store.add(e));
-            certificate.certificateId = id;
-            if (fields != null) {
-                for (const field of fields) {
-                    field.certificateId = certificate.certificateId;
-                    field.userId = certificate.userId;
-                    await this.insertCertificateField(field, dbTrx);
-                }
-            }
-        }
-        finally {
-            if (trx == null)
-                await dbTrx.done;
-        }
-        return certificate.certificateId;
-    }
-    async insertCertificateField(certificateField, trx) {
-        const e = await this.validateEntityForInsert(certificateField, trx);
-        const dbTrx = this.toDbTrx(['certificate_fields'], 'readwrite', trx);
-        const store = dbTrx.objectStore('certificate_fields');
-        try {
-            await store.add(e);
-        }
-        finally {
-            if (trx == null)
-                await dbTrx.done;
-        }
-    }
-    async insertCommission(commission, trx) {
-        const e = await this.validateEntityForInsert(commission, trx);
-        if (e.commissionId === 0)
-            delete e.commissionId;
-        const dbTrx = this.toDbTrx(['commissions'], 'readwrite', trx);
-        const store = dbTrx.objectStore('commissions');
-        try {
-            const id = Number(await store.add(e));
-            commission.commissionId = id;
-        }
-        finally {
-            if (trx == null)
-                await dbTrx.done;
-        }
-        return commission.commissionId;
-    }
-    async insertMonitorEvent(event, trx) {
-        const e = await this.validateEntityForInsert(event, trx);
-        if (e.id === 0)
-            delete e.id;
-        const dbTrx = this.toDbTrx(['monitor_events'], 'readwrite', trx);
-        const store = dbTrx.objectStore('monitor_events');
-        try {
-            const id = Number(await store.add(e));
-            event.id = id;
-        }
-        finally {
-            if (trx == null)
-                await dbTrx.done;
-        }
-        return event.id;
-    }
-    async insertOutput(output, trx) {
-        const e = await this.validateEntityForInsert(output, trx);
-        if (e.outputId === 0)
-            delete e.outputId;
-        const dbTrx = this.toDbTrx(['outputs'], 'readwrite', trx);
-        const store = dbTrx.objectStore('outputs');
-        try {
-            const id = Number(await store.add(e));
-            output.outputId = id;
-        }
-        finally {
-            if (trx == null)
-                await dbTrx.done;
-        }
-        return output.outputId;
-    }
-    async insertOutputBasket(basket, trx) {
-        const e = await this.validateEntityForInsert(basket, trx, undefined, ['isDeleted']);
-        if (e.basketId === 0)
-            delete e.basketId;
-        const dbTrx = this.toDbTrx(['output_baskets'], 'readwrite', trx);
-        const store = dbTrx.objectStore('output_baskets');
-        try {
-            const id = Number(await store.add(e));
-            basket.basketId = id;
-        }
-        finally {
-            if (trx == null)
-                await dbTrx.done;
-        }
-        return basket.basketId;
-    }
-    async insertOutputTag(tag, trx) {
-        const e = await this.validateEntityForInsert(tag, trx, undefined, ['isDeleted']);
-        if (e.outputTagId === 0)
-            delete e.outputTagId;
-        const dbTrx = this.toDbTrx(['output_tags'], 'readwrite', trx);
-        const store = dbTrx.objectStore('output_tags');
-        try {
-            const id = Number(await store.add(e));
-            tag.outputTagId = id;
-        }
-        finally {
-            if (trx == null)
-                await dbTrx.done;
-        }
-        return tag.outputTagId;
-    }
-    async insertOutputTagMap(tagMap, trx) {
-        const e = await this.validateEntityForInsert(tagMap, trx, undefined, ['isDeleted']);
-        const dbTrx = this.toDbTrx(['output_tags_map'], 'readwrite', trx);
-        const store = dbTrx.objectStore('output_tags_map');
-        try {
-            await store.add(e);
-        }
-        finally {
-            if (trx == null)
-                await dbTrx.done;
-        }
-    }
-    async insertProvenTx(tx, trx) {
-        const e = await this.validateEntityForInsert(tx, trx);
-        if (e.provenTxId === 0)
-            delete e.provenTxId;
-        const dbTrx = this.toDbTrx(['proven_txs'], 'readwrite', trx);
-        const store = dbTrx.objectStore('proven_txs');
-        try {
-            const id = Number(await store.add(e));
-            tx.provenTxId = id;
-        }
-        finally {
-            if (trx == null)
-                await dbTrx.done;
-        }
-        return tx.provenTxId;
-    }
-    async insertProvenTxReq(tx, trx) {
-        const e = await this.validateEntityForInsert(tx, trx);
-        if (e.provenTxReqId === 0)
-            delete e.provenTxReqId;
-        const dbTrx = this.toDbTrx(['proven_tx_reqs'], 'readwrite', trx);
-        const store = dbTrx.objectStore('proven_tx_reqs');
-        try {
-            const id = Number(await store.add(e));
-            tx.provenTxReqId = id;
-        }
-        finally {
-            if (trx == null)
-                await dbTrx.done;
-        }
-        return tx.provenTxReqId;
-    }
-    async insertSyncState(syncState, trx) {
-        const e = await this.validateEntityForInsert(syncState, trx, ['when'], ['init']);
-        if (e.syncStateId === 0)
-            delete e.syncStateId;
-        const dbTrx = this.toDbTrx(['sync_states'], 'readwrite', trx);
-        const store = dbTrx.objectStore('sync_states');
-        try {
-            const id = Number(await store.add(e));
-            syncState.syncStateId = id;
-        }
-        finally {
-            if (trx == null)
-                await dbTrx.done;
-        }
-        return syncState.syncStateId;
-    }
-    async insertTransaction(tx, trx) {
-        const e = await this.validateEntityForInsert(tx, trx);
-        if (e.transactionId === 0)
-            delete e.transactionId;
-        const dbTrx = this.toDbTrx(['transactions'], 'readwrite', trx);
-        const store = dbTrx.objectStore('transactions');
-        try {
-            const id = Number(await store.add(e));
-            tx.transactionId = id;
-        }
-        finally {
-            if (trx == null)
-                await dbTrx.done;
-        }
-        return tx.transactionId;
-    }
-    async insertTxLabel(label, trx) {
-        const e = await this.validateEntityForInsert(label, trx, undefined, ['isDeleted']);
-        if (e.txLabelId === 0)
-            delete e.txLabelId;
-        const dbTrx = this.toDbTrx(['tx_labels'], 'readwrite', trx);
-        const store = dbTrx.objectStore('tx_labels');
-        try {
-            const id = Number(await store.add(e));
-            label.txLabelId = id;
-        }
-        finally {
-            if (trx == null)
-                await dbTrx.done;
-        }
-        return label.txLabelId;
-    }
-    async insertTxLabelMap(labelMap, trx) {
-        const e = await this.validateEntityForInsert(labelMap, trx, undefined, ['isDeleted']);
-        const dbTrx = this.toDbTrx(['tx_labels_map'], 'readwrite', trx);
-        const store = dbTrx.objectStore('tx_labels_map');
-        try {
-            await store.add(e);
-        }
-        finally {
-            if (trx == null)
-                await dbTrx.done;
-        }
-    }
-    async insertUser(user, trx) {
-        const e = await this.validateEntityForInsert(user, trx);
-        if (e.userId === 0)
-            delete e.userId;
-        const dbTrx = this.toDbTrx(['users'], 'readwrite', trx);
-        const store = dbTrx.objectStore('users');
-        try {
-            const id = Number(await store.add(e));
-            user.userId = id;
-        }
-        finally {
-            if (trx == null)
-                await dbTrx.done;
-        }
-        return user.userId;
-    }
-    async updateIdb(id, update, keyProp, storeName, trx) {
-        if (update[keyProp] !== undefined && (Array.isArray(id) || update[keyProp] !== id)) {
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER(`update.${keyProp}`, 'undefined');
-        }
-        const u = this.validatePartialForUpdate(update);
-        const dbTrx = this.toDbTrx([storeName], 'readwrite', trx);
-        const store = dbTrx.objectStore(storeName);
-        const ids = Array.isArray(id) ? id : [id];
-        let updated = 0;
-        try {
-            for (const i of ids) {
-                const e = await store.get(i);
-                // Match Knex/Bun semantics: missing rows produce a 0-row result, not an error.
-                // Caller receives the true updated count and can decide how to react.
-                if (e == null)
-                    continue;
-                const v = {
-                    ...e,
-                    ...u
-                };
-                const uid = await store.put(v);
-                if (uid !== i)
-                    throw new WERR_errors_1.WERR_INTERNAL(`updated id ${String(uid)} does not match original ${String(id)}`);
-                updated++;
-            }
-        }
-        finally {
-            if (trx == null)
-                await dbTrx.done;
-        }
-        return updated;
-    }
-    async updateIdbKey(key, update, keyProps, storeName, trx) {
-        if (key.length !== keyProps.length) {
-            throw new WERR_errors_1.WERR_INTERNAL(`key.length ${key.length} !== keyProps.length ${keyProps.length}`);
-        }
-        for (let i = 0; i < key.length; i++) {
-            if (update[keyProps[i]] !== undefined && update[keyProps[i]] !== key[i]) {
-                throw new WERR_errors_1.WERR_INVALID_PARAMETER(`update.${keyProps[i]}`, 'undefined');
-            }
-        }
-        const u = this.validatePartialForUpdate(update);
-        const dbTrx = this.toDbTrx([storeName], 'readwrite', trx);
-        const store = dbTrx.objectStore(storeName);
-        try {
-            const e = await store.get(key);
-            if (e == null) {
-                throw new WERR_errors_1.WERR_INVALID_PARAMETER('key', `an existing record to update ${keyProps.join(',')} ${key.join(',')} not found`);
-            }
-            const v = {
-                ...e,
-                ...u
-            };
-            const uid = await store.put(v);
-            for (let i = 0; i < key.length; i++) {
-                if (uid[i] !== key[i])
-                    throw new WERR_errors_1.WERR_INTERNAL(`updated key ${String(uid[i])} does not match original ${String(key[i])}`);
-            }
-        }
-        finally {
-            if (trx == null)
-                await dbTrx.done;
-        }
-        return 1;
-    }
-    async updateCertificate(id, update, trx) {
-        return await this.updateIdb(id, update, 'certificateId', 'certificates', trx);
-    }
-    async updateCertificateField(certificateId, fieldName, update, trx) {
-        return await this.updateIdbKey([certificateId, fieldName], update, ['certificateId', 'fieldName'], 'certificate_fields', trx);
-    }
-    async updateCommission(id, update, trx) {
-        return await this.updateIdb(id, update, 'commissionId', 'commissions', trx);
-    }
-    async updateMonitorEvent(id, update, trx) {
-        return await this.updateIdb(id, update, 'id', 'monitor_events', trx);
-    }
-    async updateOutput(id, update, trx) {
-        return await this.updateIdb(id, update, 'outputId', 'outputs', trx);
-    }
-    async updateOutputBasket(id, update, trx) {
-        return await this.updateIdb(id, update, 'basketId', 'output_baskets', trx);
-    }
-    async updateOutputTag(id, update, trx) {
-        return await this.updateIdb(id, update, 'outputTagId', 'output_tags', trx);
-    }
-    async updateProvenTx(id, update, trx) {
-        return await this.updateIdb(id, update, 'provenTxId', 'proven_txs', trx);
-    }
-    async updateProvenTxReq(id, update, trx) {
-        return await this.updateIdb(id, update, 'provenTxReqId', 'proven_tx_reqs', trx);
-    }
-    async updateSyncState(id, update, trx) {
-        return await this.updateIdb(id, update, 'syncStateId', 'sync_states', trx);
-    }
-    async updateTransaction(id, update, trx) {
-        return await this.updateIdb(id, update, 'transactionId', 'transactions', trx);
-    }
-    async updateTxLabel(id, update, trx) {
-        return await this.updateIdb(id, update, 'txLabelId', 'tx_labels', trx);
-    }
-    async updateUser(id, update, trx) {
-        return await this.updateIdb(id, update, 'userId', 'users', trx);
-    }
-    async updateOutputTagMap(outputId, tagId, update, trx) {
-        return await this.updateIdbKey([tagId, outputId], update, ['outputTagId', 'outputId'], 'output_tags_map', trx);
-    }
-    async updateTxLabelMap(transactionId, txLabelId, update, trx) {
-        return await this.updateIdbKey([txLabelId, transactionId], update, ['txLabelId', 'transactionId'], 'tx_labels_map', trx);
-    }
-    //
-    // StorageReader abstract methods
-    //
-    async destroy() {
-        if (this.db != null) {
-            this.db.close();
-        }
-        this.db = undefined;
-        this._settings = undefined;
-    }
-    allStores = [
-        'certificates',
-        'certificate_fields',
-        'commissions',
-        'monitor_events',
-        'outputs',
-        'output_baskets',
-        'output_tags',
-        'output_tags_map',
-        'proven_txs',
-        'proven_tx_reqs',
-        'sync_states',
-        'transactions',
-        'tx_labels',
-        'tx_labels_map',
-        'users'
-    ];
-    /**
-     * @param scope
-     * @param trx
-     * @returns
-     */
-    async transaction(scope, trx) {
-        if (trx != null)
-            return await scope(trx);
-        const stores = this.allStores;
-        const db = await this.verifyDB();
-        const tx = db.transaction(stores, 'readwrite');
-        try {
-            const r = await scope(tx);
-            await tx.done;
-            return r;
-        }
-        catch (err) {
-            tx.abort();
-            await tx.done;
-            throw err;
-        }
-    }
-    async filterCertificateFields(args, filtered) {
-        this.assertNoUndefinedInPartial(args.partial);
-        const dbTrx = this.toDbTrx(['certificate_fields'], 'readonly', args.trx);
-        const store = dbTrx.objectStore('certificate_fields');
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        let cursor;
-        if (args.partial?.certificateId !== undefined) {
-            cursor = await store.index('certificateId').openCursor(args.partial.certificateId);
-        }
-        else if (args.partial?.userId !== undefined) {
-            cursor = await store.index('userId').openCursor(args.partial.userId);
-        }
-        else {
-            cursor = await store.openCursor();
-        }
-        await scanCursor(cursor, args.since, args.paged?.offset ?? 0, args.paged?.limit, r => (0, idbHelpers_1.matchesCertificateFieldPartial)(r, args.partial), filtered);
-        if (args.trx == null)
-            await dbTrx.done;
-    }
-    async findCertificateFields(args) {
-        const result = [];
-        await this.filterCertificateFields(args, r => {
-            result.push(this.validateEntity(r));
-        });
-        return result;
-    }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    async openCertificatesCursor(
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    store, 
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    partial
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    ) {
-        if (partial?.certificateId != null && partial.certificateId !== 0)
-            return store.openCursor(partial.certificateId);
-        if (partial?.userId !== undefined) {
-            if (partial?.type != null && partial?.certifier != null && partial?.serialNumber != null) {
-                return store
-                    .index('userId_type_certifier_serialNumber')
-                    .openCursor([partial.userId, partial.type, partial.certifier, partial.serialNumber]);
-            }
-            return store.index('userId').openCursor(partial.userId);
-        }
-        return store.openCursor();
-    }
-    async filterCertificates(args, filtered) {
-        this.assertNoUndefinedInPartial(args.partial);
-        const dbTrx = this.toDbTrx(['certificates'], 'readonly', args.trx);
-        const store = dbTrx.objectStore('certificates');
-        const cursor = await this.openCertificatesCursor(store, args.partial);
-        await scanCursor(cursor, args.since, args.paged?.offset ?? 0, args.paged?.limit, r => {
-            if (args.certifiers != null && !args.certifiers.includes(r.certifier))
-                return false;
-            if (args.types != null && !args.types.includes(r.type))
-                return false;
-            return (0, idbHelpers_1.matchesCertificatePartial)(r, args.partial);
-        }, filtered);
-        if (args.trx == null)
-            await dbTrx.done;
-    }
-    async findCertificates(args) {
-        const result = [];
-        await this.filterCertificates(args, r => {
-            result.push(this.validateEntity(r));
-        });
-        if (args.includeFields === true) {
-            for (const c of result) {
-                const fields = await this.findCertificateFields({ partial: { certificateId: c.certificateId }, trx: args.trx });
-                c.fields = fields;
-            }
-        }
-        return result;
-    }
-    async filterCommissions(args, filtered) {
-        this.assertNoUndefinedInPartial(args.partial);
-        if (args.partial.lockingScript != null) {
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER('partial.lockingScript', 'undefined. Commissions may not be found by lockingScript value.');
-        }
-        const dbTrx = this.toDbTrx(['commissions'], 'readonly', args.trx);
-        const store = dbTrx.objectStore('commissions');
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        let cursor;
-        if (args.partial?.commissionId != null && args.partial.commissionId !== 0) {
-            cursor = await store.openCursor(args.partial.commissionId);
-        }
-        else if (args.partial?.userId !== undefined) {
-            cursor = await store.index('userId').openCursor(args.partial.userId);
-        }
-        else if (args.partial?.transactionId !== undefined) {
-            cursor = await store.index('transactionId').openCursor(args.partial.transactionId);
-        }
-        else {
-            cursor = await store.openCursor();
-        }
-        await scanCursor(cursor, args.since, args.paged?.offset ?? 0, args.paged?.limit, r => (0, idbHelpers_1.matchesCommissionPartial)(r, args.partial), filtered);
-        if (args.trx == null)
-            await dbTrx.done;
-    }
-    async findCommissions(args) {
-        const result = [];
-        await this.filterCommissions(args, r => {
-            result.push(this.validateEntity(r));
-        });
-        return result;
-    }
-    async filterMonitorEvents(args, filtered) {
-        this.assertNoUndefinedInPartial(args.partial);
-        const dbTrx = this.toDbTrx(['monitor_events'], 'readonly', args.trx);
-        const store = dbTrx.objectStore('monitor_events');
-        const cursor = (args.partial?.id != null && args.partial.id !== 0) ? await store.openCursor(args.partial.id) : await store.openCursor();
-        await scanCursor(cursor, args.since, args.paged?.offset ?? 0, args.paged?.limit, r => (0, idbHelpers_1.matchesMonitorEventPartial)(r, args.partial), filtered);
-        if (args.trx == null)
-            await dbTrx.done;
-    }
-    async findMonitorEvents(args) {
-        const result = [];
-        await this.filterMonitorEvents(args, r => {
-            result.push(this.validateEntity(r));
-        });
-        return result;
-    }
-    async filterOutputBaskets(args, filtered) {
-        this.assertNoUndefinedInPartial(args.partial);
-        const dbTrx = this.toDbTrx(['output_baskets'], 'readonly', args.trx);
-        const store = dbTrx.objectStore('output_baskets');
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        let cursor;
-        if (args.partial?.basketId != null && args.partial.basketId !== 0) {
-            cursor = await store.openCursor(args.partial.basketId);
-        }
-        else if (args.partial?.userId !== undefined && args.partial?.name !== undefined) {
-            cursor = await store.index('name_userId').openCursor([args.partial.name, args.partial.userId]);
-        }
-        else if (args.partial?.userId !== undefined) {
-            cursor = await store.index('userId').openCursor(args.partial.userId);
-        }
-        else {
-            cursor = await store.openCursor();
-        }
-        await scanCursor(cursor, args.since, args.paged?.offset ?? 0, args.paged?.limit, r => (0, idbHelpers_1.matchesOutputBasketPartial)(r, args.partial), filtered);
-        if (args.trx == null)
-            await dbTrx.done;
-    }
-    async findOutputBaskets(args) {
-        const result = [];
-        await this.filterOutputBaskets(args, r => {
-            result.push(this.validateEntity(r));
-        });
-        return result;
-    }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    async openOutputsCursor(
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    store, 
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    partial, direction
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    ) {
-        if (partial?.outputId != null && partial.outputId !== 0)
-            return store.openCursor(partial.outputId, direction);
-        if (partial?.userId !== undefined) {
-            if (partial?.transactionId != null && partial.transactionId !== 0 && partial?.vout !== undefined) {
-                return store.index('transactionId_vout_userId').openCursor([partial.transactionId, partial.vout, partial.userId], direction);
-            }
-            return store.index('userId').openCursor(partial.userId, direction);
-        }
-        if (partial?.transactionId !== undefined)
-            return store.index('transactionId').openCursor(partial.transactionId, direction);
-        if (partial?.basketId !== undefined)
-            return store.index('basketId').openCursor(partial.basketId, direction);
-        if (partial?.spentBy !== undefined)
-            return store.index('spentBy').openCursor(partial.spentBy, direction);
-        return store.openCursor(null, direction);
-    }
-    async filterOutputs(args, filtered, tagIds, isQueryModeAll) {
-        this.assertNoUndefinedInPartial(args.partial);
-        if (args.partial.lockingScript != null) {
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER('args.partial.lockingScript', 'undefined. Outputs may not be found by lockingScript value.');
-        }
-        const stores = ['outputs'];
-        if (tagIds != null && tagIds.length > 0)
-            stores.push('output_tags_map');
-        if (args.txStatus != null)
-            stores.push('transactions');
-        const dbTrx = this.toDbTrx(stores, 'readonly', args.trx);
-        const direction = args.orderDescending === true ? 'prev' : 'next';
-        const store = dbTrx.objectStore('outputs');
-        const cursor = await this.openOutputsCursor(store, args.partial, direction);
-        await scanCursor(cursor, args.since, args.paged?.offset ?? 0, args.paged?.limit, async (r) => {
-            if (!(0, idbHelpers_1.matchesOutputPartial)(r, args.partial))
-                return false;
-            if (args.txStatus !== undefined) {
-                const txCount = await this.countTransactions({
-                    partial: { transactionId: r.transactionId },
-                    status: args.txStatus,
-                    trx: dbTrx
-                });
-                if (txCount === 0)
-                    return false;
-            }
-            if (tagIds != null && tagIds.length > 0 && !await this.outputMatchesTags(r.outputId, tagIds, isQueryModeAll, dbTrx))
-                return false;
-            return true;
-        }, r => {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            if (args.noScript === true)
-                r.script = undefined;
-            filtered(r);
-        });
-        if (args.trx == null)
-            await dbTrx.done;
-    }
-    async outputMatchesTags(outputId, tagIds, isQueryModeAll, dbTrx) {
-        let ids = [...tagIds];
-        await this.filterOutputTagMaps({ partial: { outputId }, trx: dbTrx }, tm => {
-            if (ids.length > 0) {
-                const i = ids.indexOf(tm.outputTagId);
-                if (i >= 0) {
-                    if (isQueryModeAll === true) {
-                        ids.splice(i, 1);
-                    }
-                    else {
-                        ids = [];
-                    }
-                }
-            }
-        });
-        return ids.length === 0;
-    }
-    async findOutputs(args, tagIds, isQueryModeAll) {
-        const results = [];
-        await this.filterOutputs(args, r => {
-            results.push(this.validateEntity(r));
-        }, tagIds, isQueryModeAll);
-        for (const o of results) {
-            if (args.noScript === true) {
-                o.lockingScript = undefined;
-            }
-            else {
-                await this.validateOutputScript(o, args.trx);
-            }
-        }
-        return results;
-    }
-    async filterOutputTags(args, filtered) {
-        const dbTrx = this.toDbTrx(['output_tags'], 'readonly', args.trx);
-        const store = dbTrx.objectStore('output_tags');
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        let cursor;
-        if (args.partial?.outputTagId != null && args.partial.outputTagId !== 0) {
-            cursor = await store.openCursor(args.partial.outputTagId);
-        }
-        else if (args.partial?.userId !== undefined && args.partial?.tag !== undefined) {
-            cursor = await store.index('tag_userId').openCursor([args.partial.tag, args.partial.userId]);
-        }
-        else if (args.partial?.userId !== undefined) {
-            cursor = await store.index('userId').openCursor(args.partial.userId);
-        }
-        else {
-            cursor = await store.openCursor();
-        }
-        await scanCursor(cursor, args.since, args.paged?.offset ?? 0, args.paged?.limit, r => (0, idbHelpers_1.matchesOutputTagPartial)(r, args.partial), filtered);
-        if (args.trx == null)
-            await dbTrx.done;
-    }
-    async findOutputTags(args) {
-        const result = [];
-        await this.filterOutputTags(args, r => {
-            result.push(this.validateEntity(r));
-        });
-        return result;
-    }
-    async filterSyncStates(args, filtered) {
-        if (args.partial.syncMap != null && args.partial.syncMap !== '') {
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER('args.partial.syncMap', 'undefined. SyncStates may not be found by syncMap value.');
-        }
-        const dbTrx = this.toDbTrx(['sync_states'], 'readonly', args.trx);
-        const store = dbTrx.objectStore('sync_states');
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        let cursor;
-        if (args.partial?.syncStateId != null && args.partial.syncStateId !== 0) {
-            cursor = await store.openCursor(args.partial.syncStateId);
-        }
-        else if (args.partial?.userId !== undefined) {
-            cursor = await store.index('userId').openCursor(args.partial.userId);
-        }
-        else if (args.partial?.refNum !== undefined) {
-            cursor = await store.index('refNum').openCursor(args.partial.refNum);
-        }
-        else if (args.partial?.status !== undefined) {
-            cursor = await store.index('status').openCursor(args.partial.status);
-        }
-        else {
-            cursor = await store.openCursor();
-        }
-        await scanCursor(cursor, args.since, args.paged?.offset ?? 0, args.paged?.limit, r => (0, idbHelpers_1.matchesSyncStatePartial)(r, args.partial), filtered);
-        if (args.trx == null)
-            await dbTrx.done;
-    }
-    async findSyncStates(args) {
-        const result = [];
-        await this.filterSyncStates(args, r => {
-            result.push(this.validateEntity(r));
-        });
-        return result;
-    }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    async openTransactionsCursor(
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    store, 
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    partial, direction
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    ) {
-        if (partial?.transactionId != null && partial.transactionId !== 0)
-            return store.openCursor(partial.transactionId, direction);
-        if (partial?.userId !== undefined) {
-            if (partial?.status !== undefined) {
-                return store.index('status_userId').openCursor([partial.status, partial.userId], direction);
-            }
-            return store.index('userId').openCursor(partial.userId, direction);
-        }
-        if (partial?.status !== undefined)
-            return store.index('status').openCursor(partial.status, direction);
-        if (partial?.provenTxId !== undefined)
-            return store.index('provenTxId').openCursor(partial.provenTxId, direction);
-        if (partial?.reference !== undefined)
-            return store.index('reference').openCursor(partial.reference, direction);
-        return store.openCursor(null, direction);
-    }
-    async filterTransactions(args, filtered, labelIds, isQueryModeAll) {
-        if (args.partial.rawTx != null) {
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER('args.partial.rawTx', 'undefined. Transactions may not be found by rawTx value.');
-        }
-        if (args.partial.inputBEEF != null) {
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER('args.partial.inputBEEF', 'undefined. Transactions may not be found by inputBEEF value.');
-        }
-        const stores = ['transactions'];
-        if (labelIds != null && labelIds.length > 0)
-            stores.push('tx_labels_map');
-        const dbTrx = this.toDbTrx(stores, 'readonly', args.trx);
-        const direction = args.orderDescending === true ? 'prev' : 'next';
-        const store = dbTrx.objectStore('transactions');
-        const cursor = await this.openTransactionsCursor(store, args.partial, direction);
-        await scanCursor(cursor, args.since, args.paged?.offset ?? 0, args.paged?.limit, async (r) => {
-            if (args.from != null && r.created_at.getTime() < args.from.getTime())
-                return false;
-            if (args.to != null && r.created_at.getTime() >= args.to.getTime())
-                return false;
-            if (args.status != null && !args.status.includes(r.status))
-                return false;
-            if (!(0, idbHelpers_1.matchesTransactionPartial)(r, args.partial))
-                return false;
-            if (labelIds != null && labelIds.length > 0 && !await this.transactionMatchesLabels(r.transactionId, labelIds, isQueryModeAll, dbTrx))
-                return false;
-            return true;
-        }, filtered);
-        if (args.trx == null)
-            await dbTrx.done;
-    }
-    async transactionMatchesLabels(transactionId, labelIds, isQueryModeAll, dbTrx) {
-        let ids = [...labelIds];
-        await this.filterTxLabelMaps({ partial: { transactionId }, trx: dbTrx }, lm => {
-            if (ids.length > 0) {
-                const i = ids.indexOf(lm.txLabelId);
-                if (i >= 0) {
-                    if (isQueryModeAll === true) {
-                        ids.splice(i, 1);
-                    }
-                    else {
-                        ids = [];
-                    }
-                }
-            }
-        });
-        return ids.length === 0;
-    }
-    async findTransactions(args, labelIds, isQueryModeAll) {
-        const results = [];
-        await this.filterTransactions(args, r => {
-            results.push(this.validateEntity(r));
-        }, labelIds, isQueryModeAll);
-        for (const t of results) {
-            if (args.noRawTx === true) {
-                t.rawTx = undefined;
-                t.inputBEEF = undefined;
-            }
-            else {
-                await this.validateRawTransaction(t, args.trx);
-            }
-        }
-        return results;
-    }
-    async filterTxLabels(args, filtered) {
-        const dbTrx = this.toDbTrx(['tx_labels'], 'readonly', args.trx);
-        const store = dbTrx.objectStore('tx_labels');
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        let cursor;
-        if (args.partial?.txLabelId != null && args.partial.txLabelId !== 0) {
-            cursor = await store.openCursor(args.partial.txLabelId);
-        }
-        else if (args.partial?.userId !== undefined && args.partial?.label !== undefined) {
-            cursor = await store.index('label_userId').openCursor([args.partial.label, args.partial.userId]);
-        }
-        else if (args.partial?.userId !== undefined) {
-            cursor = await store.index('userId').openCursor(args.partial.userId);
-        }
-        else {
-            cursor = await store.openCursor();
-        }
-        await scanCursor(cursor, args.since, args.paged?.offset ?? 0, args.paged?.limit, r => (0, idbHelpers_1.matchesTxLabelPartial)(r, args.partial), filtered);
-        if (args.trx == null)
-            await dbTrx.done;
-    }
-    async findTxLabels(args) {
-        const result = [];
-        await this.filterTxLabels(args, r => {
-            result.push(this.validateEntity(r));
-        });
-        return result;
-    }
-    matchesUserPartial(r, partial) {
-        if (partial == null)
-            return true;
-        if (partial.userId != null && partial.userId !== 0 && r.userId !== partial.userId)
-            return false;
-        if ((partial.created_at != null) && r.created_at.getTime() !== partial.created_at.getTime())
-            return false;
-        if ((partial.updated_at != null) && r.updated_at.getTime() !== partial.updated_at.getTime())
-            return false;
-        if (partial.identityKey != null && partial.identityKey !== '' && r.identityKey !== partial.identityKey)
-            return false;
-        if (partial.activeStorage != null && partial.activeStorage !== '' && r.activeStorage !== partial.activeStorage)
-            return false;
-        return true;
-    }
-    async filterUsers(args, filtered) {
-        const dbTrx = this.toDbTrx(['users'], 'readonly', args.trx);
-        const cursor = await dbTrx.objectStore('users').openCursor();
-        await scanCursor(cursor, args.since, args.paged?.offset ?? 0, args.paged?.limit, r => this.matchesUserPartial(r, args.partial), filtered);
-        if (args.trx == null)
-            await dbTrx.done;
-    }
-    async findUsers(args) {
-        const result = [];
-        await this.filterUsers(args, r => {
-            result.push(this.validateEntity(r));
-        });
-        return result;
-    }
-    async countCertificateFields(args) {
-        let count = 0;
-        await this.filterCertificateFields(args, () => {
-            count++;
-        });
-        return count;
-    }
-    async countCertificates(args) {
-        let count = 0;
-        await this.filterCertificates(args, () => {
-            count++;
-        });
-        return count;
-    }
-    async countCommissions(args) {
-        let count = 0;
-        await this.filterCommissions(args, () => {
-            count++;
-        });
-        return count;
-    }
-    async countMonitorEvents(args) {
-        let count = 0;
-        await this.filterMonitorEvents(args, () => {
-            count++;
-        });
-        return count;
-    }
-    async countOutputBaskets(args) {
-        let count = 0;
-        await this.filterOutputBaskets(args, () => {
-            count++;
-        });
-        return count;
-    }
-    async countOutputs(args, tagIds, isQueryModeAll) {
-        let count = 0;
-        await this.filterOutputs({ ...args, noScript: true }, () => {
-            count++;
-        }, tagIds, isQueryModeAll);
-        return count;
-    }
-    async countOutputTags(args) {
-        let count = 0;
-        await this.filterOutputTags(args, () => {
-            count++;
-        });
-        return count;
-    }
-    async countSyncStates(args) {
-        let count = 0;
-        await this.filterSyncStates(args, () => {
-            count++;
-        });
-        return count;
-    }
-    async countTransactions(args, labelIds, isQueryModeAll) {
-        let count = 0;
-        await this.filterTransactions({ ...args, noRawTx: true }, () => {
-            count++;
-        }, labelIds, isQueryModeAll);
-        return count;
-    }
-    async countTxLabels(args) {
-        let count = 0;
-        await this.filterTxLabels(args, () => {
-            count++;
-        });
-        return count;
-    }
-    async countUsers(args) {
-        let count = 0;
-        await this.filterUsers(args, () => {
-            count++;
-        });
-        return count;
-    }
-    async getProvenTxsForUser(args) {
-        const results = [];
-        const fargs = {
-            partial: {},
-            since: args.since,
-            paged: args.paged,
-            trx: args.trx
-        };
-        await this.filterProvenTxs(fargs, r => {
-            results.push(this.validateEntity(r));
-        }, args.userId);
-        return results;
-    }
-    async getProvenTxReqsForUser(args) {
-        const results = [];
-        const fargs = {
-            partial: {},
-            since: args.since,
-            paged: args.paged,
-            trx: args.trx
-        };
-        await this.filterProvenTxReqs(fargs, r => {
-            results.push(this.validateEntity(r));
-        }, args.userId);
-        return results;
-    }
-    async getTxLabelMapsForUser(args) {
-        const results = [];
-        const fargs = {
-            partial: {},
-            since: args.since,
-            paged: args.paged,
-            trx: args.trx
-        };
-        await this.filterTxLabelMaps(fargs, r => {
-            results.push(this.validateEntity(r));
-        }, args.userId);
-        return results;
-    }
-    async getOutputTagMapsForUser(args) {
-        const results = [];
-        const fargs = {
-            partial: {},
-            since: args.since,
-            paged: args.paged,
-            trx: args.trx
-        };
-        await this.filterOutputTagMaps(fargs, r => {
-            results.push(this.validateEntity(r));
-        }, args.userId);
-        return results;
-    }
-    async verifyReadyForDatabaseAccess(trx) {
-        this._settings ??= await this.readSettings();
-        return this._settings.dbtype;
-    }
-    /**
-     * Helper to force uniform behavior across database engines.
-     * Use to process all individual records with time stamps or number[] retreived from database.
-     */
-    validateEntity(entity, dateFields, booleanFields) {
-        entity.created_at = this.validateDate(entity.created_at);
-        entity.updated_at = this.validateDate(entity.updated_at);
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const e = entity;
-        this.applyDateFields(e, dateFields);
-        this.applyBooleanFields(e, booleanFields);
-        this.normalizeEntityValues(e);
-        return entity;
-    }
-    applyDateFields(entity, dateFields) {
-        if (dateFields == null)
-            return;
-        for (const df of dateFields) {
-            if (entity[df] != null)
-                entity[df] = this.validateDate(entity[df]);
-        }
-    }
-    applyBooleanFields(entity, booleanFields) {
-        if (booleanFields == null)
-            return;
-        for (const df of booleanFields) {
-            if (entity[df] !== undefined)
-                entity[df] = entity[df] !== 0 && entity[df] != null && entity[df] !== false;
-        }
-    }
-    normalizeEntityValues(entity) {
-        for (const key of Object.keys(entity)) {
-            const val = entity[key];
-            if (val === null) {
-                entity[key] = undefined;
-            }
-            else if (val instanceof Uint8Array) {
-                entity[key] = Array.from(val);
-            }
-        }
-    }
-    /**
-     * Helper to force uniform behavior across database engines.
-     * Use to process all arrays of records with time stamps retreived from database.
-     * @returns input `entities` array with contained values validated.
-     */
-    validateEntities(entities, dateFields, booleanFields) {
-        for (let i = 0; i < entities.length; i++) {
-            entities[i] = this.validateEntity(entities[i], dateFields, booleanFields);
-        }
-        return entities;
-    }
-    /**
-     * Helper to force uniform behavior across database engines.
-     * Use to process the update template for entities being updated.
-     */
-    validatePartialForUpdate(update, dateFields, booleanFields) {
-        if (this.dbtype == null)
-            throw new WERR_errors_1.WERR_INTERNAL('must call verifyReadyForDatabaseAccess first');
-        const v = { ...update };
-        v.created_at = v.created_at != null ? this.validateEntityDate(v.created_at) : undefined;
-        if (v.created_at == null)
-            delete v.created_at;
-        v.updated_at = v.updated_at != null ? this.validateEntityDate(v.updated_at) : this.validateEntityDate(new Date());
-        this.applyOptionalDateFields(v, dateFields);
-        this.applyIntegerBooleanFields(update, booleanFields);
-        this.normalizeForStorage(v);
-        this.isDirty = true;
-        return v;
-    }
-    applyOptionalDateFields(v, dateFields) {
-        if (dateFields == null)
-            return;
-        for (const df of dateFields) {
-            if (v[df] != null)
-                v[df] = this.validateOptionalEntityDate(v[df]);
-        }
-    }
-    applyIntegerBooleanFields(update, booleanFields) {
-        if (booleanFields == null)
-            return;
-        for (const df of booleanFields) {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            const u = update;
-            if (u[df] !== undefined)
-                u[df] = u[df] != null && u[df] !== false ? 1 : 0;
-        }
-    }
-    normalizeForStorage(v) {
-        for (const key of Object.keys(v)) {
-            const val = v[key];
-            if (Array.isArray(val) && (val.length === 0 || Number.isInteger(val[0]))) {
-                v[key] = Uint8Array.from(val);
-            }
-            else if (val === null) {
-                v[key] = undefined;
-            }
-        }
-    }
-    /**
-     * Helper to force uniform behavior across database engines.
-     * Use to process new entities being inserted into the database.
-     */
-    async validateEntityForInsert(entity, trx, dateFields, booleanFields) {
-        await this.verifyReadyForDatabaseAccess(trx);
-        const v = { ...entity };
-        v.created_at = this.validateOptionalEntityDate(v.created_at, true) ?? new Date();
-        v.updated_at = this.validateOptionalEntityDate(v.updated_at, true) ?? new Date();
-        if (v.created_at == null)
-            delete v.created_at;
-        if (v.updated_at == null)
-            delete v.updated_at;
-        this.applyOptionalDateFields(v, dateFields);
-        this.applyIntegerBooleanFields(entity, booleanFields);
-        this.normalizeForStorage(v);
-        this.isDirty = true;
-        return v;
-    }
-    async validateRawTransaction(t, trx) {
-        // if there is no txid or there is a rawTransaction return what we have.
-        if (t.rawTx != null || t.txid == null || t.txid === '')
-            return;
-        // rawTransaction is missing, see if we moved it ...
-        const rawTx = await this.getRawTxOfKnownValidTransaction(t.txid, undefined, undefined, trx);
-        if (rawTx == null)
-            return;
-        t.rawTx = rawTx;
-    }
-    async adminStats(adminIdentityKey) {
-        throw new Error('Method intentionally not implemented for personal storage.');
-    }
-}
-exports.StorageIdb = StorageIdb;
-//# sourceMappingURL=StorageIdb.js.map