@bsv/wallet-toolbox 1.3.21 → 1.3.22

package/mobile/out/src/storage/schema/entities/EntityProvenTxReq.d.ts

@@ -0,0 +1,135 @@
+import { sdk, StorageProvider, TableProvenTxReq, WalletStorageManager } from '../../../index.client';
+import { EntityBase, EntityStorage, SyncMap } from '.';
+export declare class EntityProvenTxReq extends EntityBase<TableProvenTxReq> {
+    static fromStorageTxid(storage: EntityStorage, txid: string, trx?: sdk.TrxToken): Promise<EntityProvenTxReq | undefined>;
+    static fromStorageId(storage: EntityStorage, id: number, trx?: sdk.TrxToken): Promise<EntityProvenTxReq>;
+    static fromTxid(txid: string, rawTx: number[], inputBEEF?: number[]): EntityProvenTxReq;
+    history: ProvenTxReqHistory;
+    notify: ProvenTxReqNotify;
+    packApiHistory(): void;
+    packApiNotify(): void;
+    unpackApiHistory(): void;
+    unpackApiNotify(): void;
+    get apiHistory(): string;
+    get apiNotify(): string;
+    set apiHistory(v: string);
+    set apiNotify(v: string);
+    updateApi(): void;
+    unpackApi(): void;
+    refreshFromStorage(storage: EntityStorage | WalletStorageManager, trx?: sdk.TrxToken): Promise<void>;
+    constructor(api?: TableProvenTxReq);
+    /**
+     * Returns history to only what followed since date.
+     */
+    historySince(since: Date): ProvenTxReqHistory;
+    historyPretty(since?: Date, indent?: number): string;
+    prettyNote(note: sdk.ReqHistoryNote): string;
+    getHistorySummary(): ProvenTxReqHistorySummaryApi;
+    parseHistoryNote(note: sdk.ReqHistoryNote, summary?: ProvenTxReqHistorySummaryApi): string;
+    addNotifyTransactionId(id: number): void;
+    /**
+     * Adds a note to history.
+     * Notes with identical property values to an existing note are ignored.
+     * @param note Note to add
+     * @param noDupes if true, only newest note with same `what` value is retained.
+     */
+    addHistoryNote(note: sdk.ReqHistoryNote, noDupes?: boolean): void;
+    /**
+       * Updates database record with current state of this EntityUser
+  
+       * @param storage
+       * @param trx
+       */
+    updateStorage(storage: EntityStorage, trx?: sdk.TrxToken): Promise<void>;
+    /**
+     * Update storage with changes to non-static properties:
+     *   updated_at
+     *   provenTxId
+     *   status
+     *   history
+     *   notify
+     *   notified
+     *   attempts
+     *   batch
+     *
+     * @param storage
+     * @param trx
+     */
+    updateStorageDynamicProperties(storage: WalletStorageManager | StorageProvider, trx?: sdk.TrxToken): Promise<void>;
+    insertOrMerge(storage: EntityStorage, trx?: sdk.TrxToken): Promise<EntityProvenTxReq>;
+    /**
+     * See `ProvenTxReqStatusApi`
+     */
+    get status(): sdk.ProvenTxReqStatus;
+    set status(v: sdk.ProvenTxReqStatus);
+    get provenTxReqId(): number;
+    set provenTxReqId(v: number);
+    get created_at(): Date;
+    set created_at(v: Date);
+    get updated_at(): Date;
+    set updated_at(v: Date);
+    get txid(): string;
+    set txid(v: string);
+    get inputBEEF(): number[] | undefined;
+    set inputBEEF(v: number[] | undefined);
+    get rawTx(): number[];
+    set rawTx(v: number[]);
+    get attempts(): number;
+    set attempts(v: number);
+    get provenTxId(): number | undefined;
+    set provenTxId(v: number | undefined);
+    get notified(): boolean;
+    set notified(v: boolean);
+    get batch(): string | undefined;
+    set batch(v: string | undefined);
+    get id(): number;
+    set id(v: number);
+    get entityName(): string;
+    get entityTable(): string;
+    /**
+     * 'convergent' equality must satisfy (A sync B) equals (B sync A)
+     */
+    equals(ei: TableProvenTxReq, syncMap?: SyncMap | undefined): boolean;
+    static mergeFind(storage: EntityStorage, userId: number, ei: TableProvenTxReq, syncMap: SyncMap, trx?: sdk.TrxToken): Promise<{
+        found: boolean;
+        eo: EntityProvenTxReq;
+        eiId: number;
+    }>;
+    mapNotifyTransactionIds(syncMap: SyncMap): void;
+    mergeNotifyTransactionIds(ei: TableProvenTxReq, syncMap?: SyncMap): void;
+    mergeHistory(ei: TableProvenTxReq, syncMap?: SyncMap, noDupes?: boolean): void;
+    static isTerminalStatus(status: sdk.ProvenTxReqStatus): boolean;
+    mergeNew(storage: EntityStorage, userId: number, syncMap: SyncMap, trx?: sdk.TrxToken): Promise<void>;
+    /**
+     * When merging `ProvenTxReq`, care is taken to avoid short-cirtuiting notification: `status` must not transition to `completed` without
+     * passing through `notifying`. Thus a full convergent merge passes through these sequence steps:
+     * 1. Remote storage completes before local storage.
+     * 2. The remotely completed req and ProvenTx sync to local storage.
+     * 3. The local storage transitions to `notifying`, after merging the remote attempts and history.
+     * 4. The local storage notifies, transitioning to `completed`.
+     * 5. Having been updated, the local req, but not ProvenTx sync to remote storage, but do not merge because the earlier `completed` wins.
+     * 6. Convergent equality is achieved (completing work - history and attempts are equal)
+     *
+     * On terminal failure: `doubleSpend` trumps `invalid` as it contains more data.
+     */
+    mergeExisting(storage: EntityStorage, since: Date | undefined, ei: TableProvenTxReq, syncMap: SyncMap, trx?: sdk.TrxToken): Promise<boolean>;
+}
+export interface ProvenTxReqHistorySummaryApi {
+    setToCompleted: boolean;
+    setToCallback: boolean;
+    setToUnmined: boolean;
+    setToDoubleSpend: boolean;
+    setToSending: boolean;
+    setToUnconfirmed: boolean;
+}
+export interface ProvenTxReqHistory {
+    /**
+     * Keys are Date().toISOString()
+     * Values are a description of what happened.
+     */
+    notes?: sdk.ReqHistoryNote[];
+}
+export interface ProvenTxReqNotify {
+    transactionIds?: number[];
+}
+//# sourceMappingURL=EntityProvenTxReq.d.ts.map

package/mobile/out/src/storage/schema/entities/EntityProvenTxReq.d.ts.map

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

package/mobile/out/src/storage/schema/entities/EntityProvenTxReq.js

@@ -0,0 +1,522 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntityProvenTxReq = void 0;
+const index_client_1 = require("../../../index.client");
+const _1 = require(".");
+class EntityProvenTxReq extends _1.EntityBase {
+    static async fromStorageTxid(storage, txid, trx) {
+        const reqApi = (0, index_client_1.verifyOneOrNone)(await storage.findProvenTxReqs({ partial: { txid }, trx }));
+        if (!reqApi)
+            return undefined;
+        return new EntityProvenTxReq(reqApi);
+    }
+    static async fromStorageId(storage, id, trx) {
+        const reqApi = (0, index_client_1.verifyOneOrNone)(await storage.findProvenTxReqs({ partial: { provenTxReqId: id }, trx }));
+        if (!reqApi)
+            throw new index_client_1.sdk.WERR_INTERNAL(`proven_tx_reqs with id ${id} is missing.`);
+        return new EntityProvenTxReq(reqApi);
+    }
+    static fromTxid(txid, rawTx, inputBEEF) {
+        const now = new Date();
+        return new EntityProvenTxReq({
+            provenTxReqId: 0,
+            created_at: now,
+            updated_at: now,
+            txid,
+            inputBEEF,
+            rawTx,
+            status: 'unknown',
+            history: '{}',
+            notify: '{}',
+            attempts: 0,
+            notified: false
+        });
+    }
+    packApiHistory() {
+        this.api.history = JSON.stringify(this.history);
+    }
+    packApiNotify() {
+        this.api.notify = JSON.stringify(this.notify);
+    }
+    unpackApiHistory() {
+        this.history = JSON.parse(this.api.history);
+    }
+    unpackApiNotify() {
+        this.notify = JSON.parse(this.api.notify);
+    }
+    get apiHistory() {
+        this.packApiHistory();
+        return this.api.history;
+    }
+    get apiNotify() {
+        this.packApiNotify();
+        return this.api.notify;
+    }
+    set apiHistory(v) {
+        this.api.history = v;
+        this.unpackApiHistory();
+    }
+    set apiNotify(v) {
+        this.api.notify = v;
+        this.unpackApiNotify();
+    }
+    updateApi() {
+        this.packApiHistory();
+        this.packApiNotify();
+    }
+    unpackApi() {
+        this.unpackApiHistory();
+        this.unpackApiNotify();
+        if (this.notify.transactionIds) {
+            // Cleanup null values and duplicates.
+            const transactionIds = [];
+            for (const id of this.notify.transactionIds) {
+                if (Number.isInteger(id) && !transactionIds.some(txid => txid === id))
+                    transactionIds.push(id);
+            }
+            this.notify.transactionIds = transactionIds;
+        }
+    }
+    async refreshFromStorage(storage, trx) {
+        const newApi = (0, index_client_1.verifyOne)(await storage.findProvenTxReqs({ partial: { provenTxReqId: this.id }, trx }));
+        this.api = newApi;
+        this.unpackApi();
+    }
+    constructor(api) {
+        const now = new Date();
+        super(api || {
+            provenTxReqId: 0,
+            created_at: now,
+            updated_at: now,
+            txid: '',
+            rawTx: [],
+            history: '',
+            notify: '',
+            attempts: 0,
+            status: 'unknown',
+            notified: false
+        });
+        this.history = {};
+        this.notify = {};
+        this.unpackApi();
+    }
+    /**
+     * Returns history to only what followed since date.
+     */
+    historySince(since) {
+        const fh = { notes: [] };
+        const filter = since.toISOString();
+        const notes = this.history.notes;
+        if (notes && fh.notes) {
+            for (const note of notes)
+                if (note.when && note.when > filter)
+                    fh.notes.push(note);
+        }
+        return fh;
+    }
+    historyPretty(since, indent = 0) {
+        const h = since ? this.historySince(since) : { ...this.history };
+        if (!h.notes)
+            return '';
+        const whenLimit = since ? since.toISOString() : undefined;
+        let log = '';
+        for (const note of h.notes) {
+            if (whenLimit && note.when && note.when < whenLimit)
+                continue;
+            log += this.prettyNote(note) + '\n';
+        }
+        return log;
+    }
+    prettyNote(note) {
+        let log = `${note.when}: ${note.what}`;
+        for (const [key, val] of Object.entries(note)) {
+            if (key !== 'when' && key !== 'what') {
+                if (typeof val === 'string')
+                    log += ' ' + key + ':`' + val + '`';
+                else
+                    log += ' ' + key + ':' + val;
+            }
+        }
+        return log;
+    }
+    getHistorySummary() {
+        const summary = {
+            setToCompleted: false,
+            setToUnmined: false,
+            setToCallback: false,
+            setToDoubleSpend: false,
+            setToSending: false,
+            setToUnconfirmed: false
+        };
+        const h = this.history;
+        if (h.notes) {
+            for (const note of h.notes) {
+                this.parseHistoryNote(note, summary);
+            }
+        }
+        return summary;
+    }
+    parseHistoryNote(note, summary) {
+        const c = summary || {
+            setToCompleted: false,
+            setToUnmined: false,
+            setToCallback: false,
+            setToDoubleSpend: false,
+            setToSending: false,
+            setToUnconfirmed: false
+        };
+        let n = this.prettyNote(note);
+        try {
+            switch (note.what) {
+                case 'status':
+                    {
+                        const status = note.status_now;
+                        switch (status) {
+                            case 'completed':
+                                c.setToCompleted = true;
+                                break;
+                            case 'unmined':
+                                c.setToUnmined = true;
+                                break;
+                            case 'callback':
+                                c.setToCallback = true;
+                                break;
+                            case 'doubleSpend':
+                                c.setToDoubleSpend = true;
+                                break;
+                            case 'sending':
+                                c.setToSending = true;
+                                break;
+                            case 'unconfirmed':
+                                c.setToUnconfirmed = true;
+                                break;
+                            default:
+                                break;
+                        }
+                    }
+                    break;
+                default:
+                    break;
+            }
+        }
+        catch (_a) {
+            /** */
+        }
+        return n;
+    }
+    addNotifyTransactionId(id) {
+        if (!Number.isInteger(id))
+            throw new index_client_1.sdk.WERR_INVALID_PARAMETER('id', 'integer');
+        const s = new Set(this.notify.transactionIds || []);
+        s.add(id);
+        this.notify.transactionIds = [...s].sort((a, b) => (a > b ? 1 : a < b ? -1 : 0));
+        this.notified = false;
+    }
+    /**
+     * Adds a note to history.
+     * Notes with identical property values to an existing note are ignored.
+     * @param note Note to add
+     * @param noDupes if true, only newest note with same `what` value is retained.
+     */
+    addHistoryNote(note, noDupes) {
+        if (!this.history.notes)
+            this.history.notes = [];
+        if (!note.when)
+            note.when = new Date().toISOString();
+        if (noDupes) {
+            // Remove any existing notes with same 'what' value and either no 'when' or an earlier 'when'
+            this.history.notes = this.history.notes.filter(n => n.what !== note.what || (n.when && n.when > note.when));
+        }
+        let addNote = true;
+        for (const n of this.history.notes) {
+            let isEqual = true;
+            for (const [k, v] of Object.entries(n)) {
+                if (v !== note[k]) {
+                    isEqual = false;
+                    break;
+                }
+            }
+            if (isEqual)
+                addNote = false;
+            if (!addNote)
+                break;
+        }
+        if (addNote) {
+            this.history.notes.push(note);
+            const k = (n) => {
+                return `${n.when} ${n.what}`;
+            };
+            this.history.notes.sort((a, b) => (k(a) < k(b) ? -1 : k(a) > k(b) ? 1 : 0));
+        }
+    }
+    /**
+       * Updates database record with current state of this EntityUser
+  
+       * @param storage
+       * @param trx
+       */
+    async updateStorage(storage, trx) {
+        this.updated_at = new Date();
+        this.updateApi();
+        if (this.id === 0) {
+            await storage.insertProvenTxReq(this.api);
+        }
+        const update = { ...this.api };
+        await storage.updateProvenTxReq(this.id, update, trx);
+    }
+    /**
+     * Update storage with changes to non-static properties:
+     *   updated_at
+     *   provenTxId
+     *   status
+     *   history
+     *   notify
+     *   notified
+     *   attempts
+     *   batch
+     *
+     * @param storage
+     * @param trx
+     */
+    async updateStorageDynamicProperties(storage, trx) {
+        this.updated_at = new Date();
+        this.updateApi();
+        const update = {
+            updated_at: this.api.updated_at,
+            provenTxId: this.api.provenTxId,
+            status: this.api.status,
+            history: this.api.history,
+            notify: this.api.notify,
+            notified: this.api.notified,
+            attempts: this.api.attempts,
+            batch: this.api.batch
+        };
+        if (storage.isStorageProvider()) {
+            const sp = storage;
+            await sp.updateProvenTxReqDynamics(this.id, update, trx);
+        }
+        else {
+            const wsm = storage;
+            await wsm.runAsStorageProvider(async (sp) => {
+                await sp.updateProvenTxReqDynamics(this.id, update, trx);
+            });
+        }
+    }
+    async insertOrMerge(storage, trx) {
+        const req = await storage.transaction(async (trx) => {
+            let reqApi0 = this.toApi();
+            const { req: reqApi1, isNew } = await storage.findOrInsertProvenTxReq(reqApi0, trx);
+            if (isNew) {
+                return new EntityProvenTxReq(reqApi1);
+            }
+            else {
+                const req = new EntityProvenTxReq(reqApi1);
+                req.mergeNotifyTransactionIds(reqApi0);
+                req.mergeHistory(reqApi0, undefined, true);
+                await req.updateStorage(storage, trx);
+                return req;
+            }
+        }, trx);
+        return req;
+    }
+    /**
+     * See `ProvenTxReqStatusApi`
+     */
+    get status() {
+        return this.api.status;
+    }
+    set status(v) {
+        if (v !== this.api.status) {
+            this.addHistoryNote({ what: 'status', status_was: this.api.status, status_now: v });
+            this.api.status = v;
+        }
+    }
+    get provenTxReqId() {
+        return this.api.provenTxReqId;
+    }
+    set provenTxReqId(v) {
+        this.api.provenTxReqId = v;
+    }
+    get created_at() {
+        return this.api.created_at;
+    }
+    set created_at(v) {
+        this.api.created_at = v;
+    }
+    get updated_at() {
+        return this.api.updated_at;
+    }
+    set updated_at(v) {
+        this.api.updated_at = v;
+    }
+    get txid() {
+        return this.api.txid;
+    }
+    set txid(v) {
+        this.api.txid = v;
+    }
+    get inputBEEF() {
+        return this.api.inputBEEF;
+    }
+    set inputBEEF(v) {
+        this.api.inputBEEF = v;
+    }
+    get rawTx() {
+        return this.api.rawTx;
+    }
+    set rawTx(v) {
+        this.api.rawTx = v;
+    }
+    get attempts() {
+        return this.api.attempts;
+    }
+    set attempts(v) {
+        this.api.attempts = v;
+    }
+    get provenTxId() {
+        return this.api.provenTxId;
+    }
+    set provenTxId(v) {
+        this.api.provenTxId = v;
+    }
+    get notified() {
+        return this.api.notified;
+    }
+    set notified(v) {
+        this.api.notified = v;
+    }
+    get batch() {
+        return this.api.batch;
+    }
+    set batch(v) {
+        this.api.batch = v;
+    }
+    get id() {
+        return this.api.provenTxReqId;
+    }
+    set id(v) {
+        this.api.provenTxReqId = v;
+    }
+    get entityName() {
+        return 'provenTxReq';
+    }
+    get entityTable() {
+        return 'proven_tx_reqs';
+    }
+    /**
+     * 'convergent' equality must satisfy (A sync B) equals (B sync A)
+     */
+    equals(ei, syncMap) {
+        const eo = this.toApi();
+        if (eo.txid != ei.txid ||
+            !(0, index_client_1.arraysEqual)(eo.rawTx, ei.rawTx) ||
+            (!eo.inputBEEF && ei.inputBEEF) ||
+            (eo.inputBEEF && !ei.inputBEEF) ||
+            (eo.inputBEEF && ei.inputBEEF && !(0, index_client_1.arraysEqual)(eo.inputBEEF, ei.inputBEEF)) ||
+            eo.batch != ei.batch)
+            return false;
+        if (syncMap) {
+            if (
+            // attempts doesn't matter for convergent equality
+            // history doesn't matter for convergent equality
+            // only local transactionIds matter, that cared about this txid in sorted order
+            eo.provenTxReqId !== syncMap.provenTxReq.idMap[(0, index_client_1.verifyId)(ei.provenTxReqId)] ||
+                (!eo.provenTxId && ei.provenTxId) ||
+                (eo.provenTxId && !ei.provenTxId) ||
+                (ei.provenTxId && eo.provenTxId !== syncMap.provenTx.idMap[ei.provenTxId])
+            // || eo.created_at !== minDate(ei.created_at, eo.created_at)
+            // || eo.updated_at !== maxDate(ei.updated_at, eo.updated_at)
+            )
+                return false;
+        }
+        else {
+            if (eo.attempts != ei.attempts ||
+                eo.history != ei.history ||
+                eo.notify != ei.notify ||
+                eo.provenTxReqId !== ei.provenTxReqId ||
+                eo.provenTxId !== ei.provenTxId
+            // || eo.created_at !== ei.created_at
+            // || eo.updated_at !== ei.updated_at
+            )
+                return false;
+        }
+        return true;
+    }
+    static async mergeFind(storage, userId, ei, syncMap, trx) {
+        const ef = (0, index_client_1.verifyOneOrNone)(await storage.findProvenTxReqs({ partial: { txid: ei.txid }, trx }));
+        return {
+            found: !!ef,
+            eo: new EntityProvenTxReq(ef || { ...ei }),
+            eiId: (0, index_client_1.verifyId)(ei.provenTxReqId)
+        };
+    }
+    mapNotifyTransactionIds(syncMap) {
+        // Map external notification transaction ids to local ids
+        const externalIds = this.notify.transactionIds || [];
+        this.notify.transactionIds = [];
+        for (const transactionId of externalIds) {
+            const localTxId = syncMap.transaction.idMap[transactionId];
+            if (localTxId) {
+                this.addNotifyTransactionId(localTxId);
+            }
+        }
+    }
+    mergeNotifyTransactionIds(ei, syncMap) {
+        var _a;
+        // Map external notification transaction ids to local ids and merge them if they exist.
+        const eie = new EntityProvenTxReq(ei);
+        if (eie.notify.transactionIds) {
+            (_a = this.notify).transactionIds || (_a.transactionIds = []);
+            for (const transactionId of eie.notify.transactionIds) {
+                const localTxId = syncMap ? syncMap.transaction.idMap[transactionId] : transactionId;
+                if (localTxId) {
+                    this.addNotifyTransactionId(localTxId);
+                }
+            }
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    mergeHistory(ei, syncMap, noDupes) {
+        const eie = new EntityProvenTxReq(ei);
+        if (eie.history.notes) {
+            for (const note of eie.history.notes) {
+                this.addHistoryNote(note);
+            }
+        }
+    }
+    static isTerminalStatus(status) {
+        return index_client_1.sdk.ProvenTxReqTerminalStatus.some(s => s === status);
+    }
+    async mergeNew(storage, userId, syncMap, trx) {
+        if (this.provenTxId)
+            this.provenTxId = syncMap.provenTx.idMap[this.provenTxId];
+        this.mapNotifyTransactionIds(syncMap);
+        this.provenTxReqId = 0;
+        this.provenTxReqId = await storage.insertProvenTxReq(this.toApi(), trx);
+    }
+    /**
+     * When merging `ProvenTxReq`, care is taken to avoid short-cirtuiting notification: `status` must not transition to `completed` without
+     * passing through `notifying`. Thus a full convergent merge passes through these sequence steps:
+     * 1. Remote storage completes before local storage.
+     * 2. The remotely completed req and ProvenTx sync to local storage.
+     * 3. The local storage transitions to `notifying`, after merging the remote attempts and history.
+     * 4. The local storage notifies, transitioning to `completed`.
+     * 5. Having been updated, the local req, but not ProvenTx sync to remote storage, but do not merge because the earlier `completed` wins.
+     * 6. Convergent equality is achieved (completing work - history and attempts are equal)
+     *
+     * On terminal failure: `doubleSpend` trumps `invalid` as it contains more data.
+     */
+    async mergeExisting(storage, since, ei, syncMap, trx) {
+        if (!this.batch && ei.batch)
+            this.batch = ei.batch;
+        else if (this.batch && ei.batch && this.batch !== ei.batch)
+            throw new index_client_1.sdk.WERR_INTERNAL('ProvenTxReq merge batch not equal.');
+        this.mergeHistory(ei, syncMap, true);
+        this.mergeNotifyTransactionIds(ei, syncMap);
+        this.updated_at = new Date(Math.max(ei.updated_at.getTime(), this.updated_at.getTime()));
+        await storage.updateProvenTxReq(this.id, this.toApi(), trx);
+        return false;
+    }
+}
+exports.EntityProvenTxReq = EntityProvenTxReq;
+//# sourceMappingURL=EntityProvenTxReq.js.map