@bsv/wallet-toolbox-client 2.1.24 → 3.0.0-alpha.0

package/out/src/storage/schema/v7MonitorLease.d.ts

@@ -0,0 +1,57 @@
+import { Knex } from 'knex';
+import { TableMonitorLease } from './tables';
+/**
+ * V7 monitor lease primitive.
+ *
+ * A `monitor_lease` row records the owner that may currently execute a named
+ * task. Acquisition is opportunistic: a Monitor calls `tryClaimLease()` to
+ * insert or take over a stale row; if it succeeds it owns the task until
+ * `expiresAt`. While running it calls `renewLease()` to extend the deadline.
+ * On clean shutdown it calls `releaseLease()`.
+ *
+ * The Knex driver expresses claim + takeover as a single conditional UPDATE
+ * so that two contending Monitors cannot both believe they own the task — at
+ * most one row write will succeed per (task, expiry) pair.
+ */
+export interface MonitorLeaseClaim {
+    taskName: string;
+    ownerId: string;
+    ttlMs: number;
+    note?: string;
+}
+export interface MonitorLeaseRenew {
+    taskName: string;
+    ownerId: string;
+    ttlMs: number;
+    note?: string;
+}
+export interface MonitorLeaseRelease {
+    taskName: string;
+    ownerId: string;
+}
+export interface MonitorLeaseResult {
+    acquired: boolean;
+    lease?: TableMonitorLease;
+}
+/**
+ * Try to claim a lease on `taskName`. Succeeds iff:
+ *   - no row exists for the task, OR
+ *   - the existing row has `expiresAt <= now`, OR
+ *   - the existing row's `ownerId` already equals the requested owner.
+ *
+ * On success the row is upserted with `expiresAt = now + ttlMs` and
+ * `renewCount = renewCount + 1` (0 for fresh rows).
+ */
+export declare function tryClaimLease(knex: Knex, claim: MonitorLeaseClaim, now?: Date): Promise<MonitorLeaseResult>;
+/**
+ * Extend the current owner's lease. Fails (returns `acquired: false`) when the
+ * row does not exist, is owned by someone else, or has already expired.
+ */
+export declare function renewLease(knex: Knex, renew: MonitorLeaseRenew, now?: Date): Promise<MonitorLeaseResult>;
+/**
+ * Release the lease (no-op when not owned by the caller).
+ * The row is deleted so subsequent claimants do not see an inherited
+ * `renew_count`.
+ */
+export declare function releaseLease(knex: Knex, release: MonitorLeaseRelease): Promise<boolean>;
+//# sourceMappingURL=v7MonitorLease.d.ts.map

package/out/src/storage/schema/v7MonitorLease.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v7MonitorLease.d.ts","sourceRoot":"","sources":["../../../../../src/storage/schema/v7MonitorLease.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAE5C;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,iBAAiB,CAAA;CAC1B;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,iBAAiB,EACxB,GAAG,GAAE,IAAiB,GACrB,OAAO,CAAC,kBAAkB,CAAC,CAmC7B;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,iBAAiB,EACxB,GAAG,GAAE,IAAiB,GACrB,OAAO,CAAC,kBAAkB,CAAC,CAkB7B;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAK9F"}

package/out/src/storage/schema/v7MonitorLease.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tryClaimLease = tryClaimLease;
+exports.renewLease = renewLease;
+exports.releaseLease = releaseLease;
+/**
+ * Try to claim a lease on `taskName`. Succeeds iff:
+ *   - no row exists for the task, OR
+ *   - the existing row has `expiresAt <= now`, OR
+ *   - the existing row's `ownerId` already equals the requested owner.
+ *
+ * On success the row is upserted with `expiresAt = now + ttlMs` and
+ * `renewCount = renewCount + 1` (0 for fresh rows).
+ */
+async function tryClaimLease(knex, claim, now = new Date()) {
+    const expiresAt = new Date(now.getTime() + claim.ttlMs);
+    return await knex.transaction(async (trx) => {
+        var _a, _b;
+        const existing = await trx('monitor_lease').where({ task_name: claim.taskName }).forUpdate().first();
+        const canClaim = existing == null ||
+            new Date(existing.expires_at).getTime() <= now.getTime() ||
+            existing.owner_id === claim.ownerId;
+        if (!canClaim)
+            return { acquired: false };
+        if (existing == null) {
+            await trx('monitor_lease').insert({
+                task_name: claim.taskName,
+                owner_id: claim.ownerId,
+                expires_at: expiresAt,
+                renew_count: 0,
+                note: (_a = claim.note) !== null && _a !== void 0 ? _a : null,
+                created_at: now,
+                updated_at: now
+            });
+        }
+        else {
+            await trx('monitor_lease')
+                .where({ task_name: claim.taskName })
+                .update({
+                owner_id: claim.ownerId,
+                expires_at: expiresAt,
+                renew_count: existing.owner_id === claim.ownerId ? existing.renew_count + 1 : 0,
+                note: (_b = claim.note) !== null && _b !== void 0 ? _b : existing.note,
+                updated_at: now
+            });
+        }
+        const row = await trx('monitor_lease').where({ task_name: claim.taskName }).first();
+        return { acquired: true, lease: mapRow(row) };
+    });
+}
+/**
+ * Extend the current owner's lease. Fails (returns `acquired: false`) when the
+ * row does not exist, is owned by someone else, or has already expired.
+ */
+async function renewLease(knex, renew, now = new Date()) {
+    const expiresAt = new Date(now.getTime() + renew.ttlMs);
+    return await knex.transaction(async (trx) => {
+        var _a;
+        const existing = await trx('monitor_lease').where({ task_name: renew.taskName }).forUpdate().first();
+        if (existing == null)
+            return { acquired: false };
+        if (existing.owner_id !== renew.ownerId)
+            return { acquired: false };
+        if (new Date(existing.expires_at).getTime() <= now.getTime())
+            return { acquired: false };
+        await trx('monitor_lease')
+            .where({ task_name: renew.taskName })
+            .update({
+            expires_at: expiresAt,
+            renew_count: existing.renew_count + 1,
+            note: (_a = renew.note) !== null && _a !== void 0 ? _a : existing.note,
+            updated_at: now
+        });
+        const row = await trx('monitor_lease').where({ task_name: renew.taskName }).first();
+        return { acquired: true, lease: mapRow(row) };
+    });
+}
+/**
+ * Release the lease (no-op when not owned by the caller).
+ * The row is deleted so subsequent claimants do not see an inherited
+ * `renew_count`.
+ */
+async function releaseLease(knex, release) {
+    const deleted = await knex('monitor_lease')
+        .where({ task_name: release.taskName, owner_id: release.ownerId })
+        .delete();
+    return deleted > 0;
+}
+function mapRow(row) {
+    var _a;
+    return {
+        created_at: new Date(row.created_at),
+        updated_at: new Date(row.updated_at),
+        taskName: row.task_name,
+        ownerId: row.owner_id,
+        expiresAt: new Date(row.expires_at),
+        renewCount: row.renew_count,
+        note: (_a = row.note) !== null && _a !== void 0 ? _a : undefined
+    };
+}
+//# sourceMappingURL=v7MonitorLease.js.map

package/out/src/storage/schema/v7MonitorLease.js.map

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

package/out/src/storage/schema/v7Service.d.ts

@@ -0,0 +1,305 @@
+import { Beef } from '@bsv/sdk';
+import { Knex } from 'knex';
+import * as sdk from '../../sdk';
+import { TableAction, TableOutput, TableTransactionV7 } from './tables';
+import { MonitorLeaseClaim, MonitorLeaseRelease, MonitorLeaseRenew, MonitorLeaseResult } from './v7MonitorLease';
+/**
+ * High-level service over the V7 storage primitives.
+ *
+ * Storage methods and the Monitor call into this surface rather than the
+ * lower-level CRUD/FSM/audit/lease modules so that:
+ *  - Every processing transition is audited.
+ *  - Optimistic concurrency is uniformly enforced.
+ *  - Chain tip + monitor lease access have one canonical entry point.
+ *
+ * Construction takes a Knex handle; instances are stateless and cheap to
+ * create — typically one per request or per Monitor task tick.
+ */
+export declare class V7TransactionService {
+    private readonly knex;
+    constructor(knex: Knex);
+    findByTxid(txid: string): Promise<TableTransactionV7 | undefined>;
+    findById(transactionId: number): Promise<TableTransactionV7 | undefined>;
+    /**
+     * Insert a new V7 transaction row. The row is created in `queued` state
+     * unless the caller overrides `processing`.
+     */
+    create(args: {
+        txid: string;
+        processing?: sdk.ProcessingStatus;
+        rawTx?: number[];
+        inputBeef?: number[];
+        batch?: string;
+        idempotencyKey?: string;
+        isCoinbase?: boolean;
+        now?: Date;
+    }): Promise<TableTransactionV7>;
+    /**
+     * Transition processing state with optimistic concurrency. Returns
+     * `undefined` when the FSM rejects the move OR the row's current state no
+     * longer matches `expectedFrom`.
+     */
+    transition(args: {
+        transactionId: number;
+        expectedFrom: sdk.ProcessingStatus;
+        to: sdk.ProcessingStatus;
+        provider?: string;
+        providerStatus?: string;
+        details?: Record<string, unknown>;
+        now?: Date;
+    }): Promise<TableTransactionV7 | undefined>;
+    /**
+     * Record acquisition of a Merkle proof for a transaction. Atomically:
+     *  - Updates proof columns (height, index, merkle_path, merkle_root, block_hash)
+     *  - Transitions processing to `proven` from any spendable-class state.
+     *  - Writes a `proof.acquired` audit row.
+     */
+    recordProof(args: {
+        transactionId: number;
+        height: number;
+        merkleIndex: number;
+        merklePath: number[];
+        merkleRoot: string;
+        blockHash: string;
+        expectedFrom: sdk.ProcessingStatus;
+        now?: Date;
+    }): Promise<TableTransactionV7 | undefined>;
+    findActionForUser(userId: number, transactionId: number): Promise<TableAction | undefined>;
+    createAction(args: {
+        userId: number;
+        transactionId: number;
+        reference: string;
+        description: string;
+        isOutgoing: boolean;
+        satoshisDelta: number;
+        userNosend?: boolean;
+        notifyJson?: string;
+        now?: Date;
+    }): Promise<number>;
+    getChainTip(): Promise<{
+        height: number;
+        blockHash: string;
+    } | undefined>;
+    setChainTip(args: {
+        height: number;
+        blockHash: string;
+        merkleRoot?: string;
+        now?: Date;
+    }): Promise<void>;
+    tryClaimLease(claim: MonitorLeaseClaim, now?: Date): Promise<MonitorLeaseResult>;
+    renewLease(renew: MonitorLeaseRenew, now?: Date): Promise<MonitorLeaseResult>;
+    releaseLease(release: MonitorLeaseRelease): Promise<boolean>;
+    /**
+     * #1 — Look up an action + its backing transaction by (userId, reference).
+     */
+    findActionByReference(userId: number, reference: string): Promise<{
+        action: TableAction;
+        transaction: TableTransactionV7;
+    } | undefined>;
+    /**
+     * #2 — Look up an action + its backing transaction by (userId, txid).
+     */
+    findActionByUserTxid(userId: number, txid: string): Promise<{
+        action: TableAction;
+        transaction: TableTransactionV7;
+    } | undefined>;
+    /**
+     * #3 — Upsert: find existing action for (userId, txid) or create both the V7
+     * transaction row and the action row.
+     */
+    findOrCreateActionForTxid(args: {
+        userId: number;
+        txid: string;
+        isOutgoing: boolean;
+        description: string;
+        satoshisDelta: number;
+        reference: string;
+        rawTx?: number[];
+        inputBeef?: number[];
+        processing?: sdk.ProcessingStatus;
+        now?: Date;
+    }): Promise<{
+        action: TableAction;
+        transaction: TableTransactionV7;
+        isNew: boolean;
+    }>;
+    /**
+     * #4 — Atomically update the satoshisDelta column on an action row.
+     */
+    updateActionSatoshisDelta(actionId: number, delta: number, now?: Date): Promise<void>;
+    /**
+     * #5 — Create a V7 transaction row already in `proven` state with all proof
+     * columns populated. Useful for internalised transactions that arrive with a
+     * Merkle proof (bump) already attached.
+     */
+    createWithProof(args: {
+        txid: string;
+        rawTx?: number[];
+        inputBeef?: number[];
+        height: number;
+        merkleIndex: number;
+        merklePath: number[];
+        merkleRoot: string;
+        blockHash: string;
+        isCoinbase?: boolean;
+        now?: Date;
+    }): Promise<TableTransactionV7>;
+    /**
+     * #6 — Find an existing V7 transaction row for the given txid (suitable for
+     * the broadcast queue) or create a new one in `queued` state.
+     */
+    findOrCreateForBroadcast(args: {
+        txid: string;
+        rawTx: number[];
+        inputBeef?: number[];
+        batch?: string;
+        processing?: sdk.ProcessingStatus;
+        now?: Date;
+    }): Promise<{
+        transaction: TableTransactionV7;
+        isNew: boolean;
+    }>;
+    /**
+     * #7 — Bulk transition: attempt `transition` for each id; collect results.
+     * When `expectedFrom` is omitted the current state of each row is used as
+     * the expected source (lenient mode — only the FSM is checked).
+     */
+    transitionMany(args: {
+        transactionIds: number[];
+        expectedFrom?: sdk.ProcessingStatus;
+        to: sdk.ProcessingStatus;
+        provider?: string;
+        providerStatus?: string;
+        details?: Record<string, unknown>;
+        now?: Date;
+    }): Promise<{
+        updated: number[];
+        skipped: number[];
+    }>;
+    /**
+     * #8 — Bulk-set the `batch` column for a list of transaction ids.
+     * Pass `undefined` to clear the batch tag.
+     */
+    setBatch(transactionIds: number[], batch: string | undefined, now?: Date): Promise<void>;
+    /**
+     * #9 — Atomically increment the `attempts` counter for one transaction and
+     * write an `attempts.incremented` audit entry.
+     */
+    incrementAttempts(transactionId: number, now?: Date): Promise<TableTransactionV7 | undefined>;
+    /**
+     * #10 — Record the outcome of a broadcast attempt. Transitions processing
+     * state, updates `wasBroadcast` and `lastProvider*` columns, and writes an
+     * audit row.
+     */
+    recordBroadcastResult(args: {
+        transactionId: number;
+        txid: string;
+        status: sdk.ProcessingStatus;
+        provider: string;
+        providerStatus?: string;
+        wasBroadcast?: boolean;
+        details?: Record<string, unknown>;
+        now?: Date;
+    }): Promise<TableTransactionV7 | undefined>;
+    /**
+     * #11 — Append a free-form history note to the audit log for a transaction.
+     */
+    recordHistoryNote(transactionId: number, note: {
+        what: string;
+        [k: string]: unknown;
+    }, now?: Date): Promise<void>;
+    /**
+     * #12 — For each txid that exists in the V7 transactions table, merge the
+     * raw transaction bytes and (where available) the Merkle path into `beef`.
+     * Txids not present in V7 are silently skipped.
+     */
+    mergeBeefForTxids(beef: Beef, txids: string[]): Promise<void>;
+    /**
+     * #13 — Collect broadcast-readiness info and a populated Beef for a list of
+     * txids. Each entry is classified as:
+     *  - `readyToSend`  — queued/sending → still needs broadcast
+     *  - `alreadySent`  — sent/seen/seen_multi/unconfirmed/proven → already on network
+     *  - `error`        — invalid/doubleSpend → terminal failure
+     *  - `unknown`      — not found in V7
+     */
+    collectReqsAndBeef(txids: string[], extraTxids?: string[]): Promise<{
+        beef: Beef;
+        details: Array<{
+            txid: string;
+            status: 'readyToSend' | 'alreadySent' | 'error' | 'unknown';
+            reason?: string;
+        }>;
+    }>;
+    /**
+     * #14 — Paginated list of actions (per-user transaction views) with optional
+     * status and label filters.
+     *
+     * After the V7 cutover `tx_labels_map.transactionId` references `actions.actionId`
+     * (not `transactions.transactionId`).
+     */
+    listActionsForUser(args: {
+        userId: number;
+        statusFilter?: sdk.ProcessingStatus[];
+        labelIds?: number[];
+        labelQueryMode?: 'all' | 'any';
+        createdAtFrom?: Date;
+        createdAtTo?: Date;
+        limit: number;
+        offset: number;
+    }): Promise<{
+        rows: Array<TableAction & {
+            txid: string;
+            processing: sdk.ProcessingStatus;
+            height?: number;
+        }>;
+        total?: number;
+    }>;
+    /**
+     * #15 — Paginated list of outputs with their backing transaction processing
+     * state. Optional filters: basket, tag set, processing state, spent flag.
+     */
+    listOutputsForUser(args: {
+        userId: number;
+        basketId?: number;
+        tagIds?: number[];
+        tagQueryMode?: 'all' | 'any';
+        processingFilter: sdk.ProcessingStatus[];
+        includeSpent: boolean;
+        limit: number;
+        offset: number;
+        includeLockingScripts?: boolean;
+    }): Promise<{
+        rows: Array<TableOutput & {
+            processing: sdk.ProcessingStatus;
+        }>;
+        total?: number;
+    }>;
+    /**
+     * Post-cutover helper: rewrite `tx_labels_map.transactionId` rows that were
+     * written with the legacy transactionId (before the real txid + actionId were
+     * known) so that they now point at the V7 `actions.actionId`.
+     *
+     * Call this once per new outgoing transaction immediately after
+     * `findOrCreateActionForTxid` resolves the actionId.
+     *
+     * This is a no-op when:
+     *  - `legacyTransactionId` has no rows in `tx_labels_map` (no labels on the tx)
+     *  - `legacyTransactionId === actionId` (should not happen in practice but
+     *    is safe to call anyway)
+     */
+    repointLabelsToActionId(legacyTransactionId: number, actionId: number, now?: Date): Promise<void>;
+    /**
+     * After `processAction` creates the V7 `transactions` row, remap
+     * `outputs.transactionId` and `outputs.spentBy` from the bridge-period
+     * `transactions_legacy.transactionId` to the real V7 `transactions.transactionId`.
+     *
+     * During `createAction`, new outputs are inserted with `transactionId =
+     * legacyTransactionId` (bypassing FK constraints). `listActionsKnex` queries
+     * outputs by V7 transactionId, so without this remap the outputs would be
+     * invisible to `listActions`.
+     *
+     * This is a no-op when `legacyTransactionId === v7TransactionId`.
+     */
+    repointOutputsToV7TransactionId(legacyTransactionId: number, v7TransactionId: number, now?: Date): Promise<void>;
+}
+//# sourceMappingURL=v7Service.d.ts.map

package/out/src/storage/schema/v7Service.d.ts.map

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