@bsv/wallet-toolbox 2.1.23 → 2.1.25

package/out/src/storage/schema/v7Backfill.idb.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.V7IdbBackfillDriver = void 0;
+exports.runV7IdbBackfill = runV7IdbBackfill;
+const v7Backfill_runner_1 = require("./v7Backfill.runner");
+const BACKFILL_STORES = [
+    'proven_tx_reqs',
+    'proven_txs',
+    'transactions',
+    'transactions_v7',
+    'actions',
+    'tx_labels_map'
+];
+/**
+ * IndexedDB driver for the V7 backfill.
+ *
+ * The orchestrator is driven entirely from this driver inside a single
+ * `readwrite` transaction across the legacy + V7 stores. The streams cache
+ * the keys up-front (`getAllKeys`) and then walk them one at a time so the
+ * idb cursor lifetime does not span an external `await`.
+ */
+class V7IdbBackfillDriver {
+    constructor(trx) {
+        this.trx = trx;
+    }
+    async *streamLegacyReqs() {
+        const reqStore = this.trx.objectStore('proven_tx_reqs');
+        const provenStore = this.trx.objectStore('proven_txs');
+        const reqKeys = await reqStore.getAllKeys();
+        for (const key of reqKeys) {
+            const req = await reqStore.get(key);
+            let proven;
+            if (req.provenTxId != null)
+                proven = await provenStore.get(req.provenTxId);
+            yield { req, proven };
+        }
+    }
+    async *streamLegacyTransactions() {
+        const store = this.trx.objectStore('transactions');
+        const keys = await store.getAllKeys();
+        for (const key of keys) {
+            const row = await store.get(key);
+            yield row;
+        }
+    }
+    async upsertTransactionV7(row) {
+        const store = this.trx.objectStore('transactions_v7');
+        const txidIndex = store.index('txid');
+        const existing = await txidIndex.get(row.txid);
+        if (existing != null) {
+            const merged = { ...existing, ...row, transactionId: existing.transactionId };
+            await store.put(merged);
+            return existing.transactionId;
+        }
+        const newId = await store.add(row);
+        return newId;
+    }
+    async upsertAction(row) {
+        const store = this.trx.objectStore('actions');
+        const idx = store.index('userId_transactionId');
+        const existing = await idx.get([row.userId, row.transactionId]);
+        if (existing != null) {
+            const merged = { ...existing, ...row, actionId: existing.actionId };
+            await store.put(merged);
+            return existing.actionId;
+        }
+        const newId = await store.add(row);
+        return newId;
+    }
+    async repointTxLabelMap(legacyTransactionId, actionId) {
+        if (legacyTransactionId === actionId)
+            return;
+        const store = this.trx.objectStore('tx_labels_map');
+        const idx = store.index('transactionId');
+        const matches = await idx.getAll(legacyTransactionId);
+        for (const m of matches) {
+            const updated = { ...m, transactionId: actionId };
+            await store.delete([m.txLabelId, legacyTransactionId]);
+            await store.add(updated);
+        }
+    }
+}
+exports.V7IdbBackfillDriver = V7IdbBackfillDriver;
+/**
+ * Convenience entry point that opens the required readwrite transaction and
+ * runs the orchestrator against it.
+ */
+async function runV7IdbBackfill(db, now = new Date()) {
+    const trx = db.transaction(BACKFILL_STORES, 'readwrite');
+    const driver = new V7IdbBackfillDriver(trx);
+    const stats = await (0, v7Backfill_runner_1.runV7Backfill)(driver, now);
+    await trx.done;
+    return stats;
+}
+//# sourceMappingURL=v7Backfill.idb.js.map

package/out/src/storage/schema/v7Backfill.idb.js.map

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

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

@@ -0,0 +1,147 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTransactionV7Row = buildTransactionV7Row;
+exports.buildTransactionV7RowFromLegacyTx = buildTransactionV7RowFromLegacyTx;
+exports.buildActionRow = buildActionRow;
+const sdk = __importStar(require("../../sdk"));
+/**
+ * Pure transformation helpers for the V7 schema backfill.
+ *
+ * These functions are deliberately storage-agnostic — they accept the legacy
+ * rows and return the new shapes. A storage driver (Knex or IDB) is responsible
+ * for reading the source rows and inserting the returned objects.
+ *
+ * No row in this module ever talks to the database; this keeps the
+ * transformation under unit-test control and lets us run dry-run migrations.
+ */
+/**
+ * Merge a legacy `proven_tx_reqs` row together with an optional `proven_txs`
+ * row into a single V7 `transactions` (transactions_v7) row.
+ *
+ * The proof fields come from `proven_txs` when present; otherwise they are
+ * left undefined. Processing state is derived from the request's legacy status.
+ */
+function buildTransactionV7Row(req, proven, now = new Date()) {
+    var _a, _b, _c;
+    const processing = sdk.provenTxReqStatusToProcessing(req.status);
+    return {
+        created_at: req.created_at,
+        updated_at: now,
+        txid: req.txid,
+        processing,
+        processingChangedAt: (_a = req.updated_at) !== null && _a !== void 0 ? _a : now,
+        nextActionAt: undefined,
+        attempts: (_b = req.attempts) !== null && _b !== void 0 ? _b : 0,
+        rebroadcastCycles: (_c = req.rebroadcastAttempts) !== null && _c !== void 0 ? _c : 0,
+        wasBroadcast: req.wasBroadcast === true,
+        idempotencyKey: undefined,
+        batch: req.batch,
+        rawTx: req.rawTx,
+        inputBeef: req.inputBEEF,
+        height: proven === null || proven === void 0 ? void 0 : proven.height,
+        merkleIndex: proven === null || proven === void 0 ? void 0 : proven.index,
+        merklePath: proven === null || proven === void 0 ? void 0 : proven.merklePath,
+        merkleRoot: proven === null || proven === void 0 ? void 0 : proven.merkleRoot,
+        blockHash: proven === null || proven === void 0 ? void 0 : proven.blockHash,
+        isCoinbase: false,
+        lastProvider: undefined,
+        lastProviderStatus: undefined,
+        frozenReason: undefined,
+        rowVersion: 0
+    };
+}
+/**
+ * Build a V7 `transactions` row from a legacy per-user `transactions` row when
+ * no `proven_tx_reqs` entry exists (e.g. locally-created actions that never
+ * reached the broadcast queue).
+ *
+ * Returns `undefined` when the legacy row has no txid — such rows belong to
+ * incomplete actions and have no canonical V7 representation yet.
+ */
+function buildTransactionV7RowFromLegacyTx(tx, now = new Date()) {
+    var _a;
+    if (tx.txid == null)
+        return undefined;
+    return {
+        created_at: tx.created_at,
+        updated_at: now,
+        txid: tx.txid,
+        processing: sdk.transactionStatusToProcessing(tx.status),
+        processingChangedAt: (_a = tx.updated_at) !== null && _a !== void 0 ? _a : now,
+        nextActionAt: undefined,
+        attempts: 0,
+        rebroadcastCycles: 0,
+        wasBroadcast: false,
+        idempotencyKey: undefined,
+        batch: undefined,
+        rawTx: tx.rawTx,
+        inputBeef: tx.inputBEEF,
+        height: undefined,
+        merkleIndex: undefined,
+        merklePath: undefined,
+        merkleRoot: undefined,
+        blockHash: undefined,
+        isCoinbase: false,
+        lastProvider: undefined,
+        lastProviderStatus: undefined,
+        frozenReason: undefined,
+        rowVersion: 0
+    };
+}
+/**
+ * Build a V7 `actions` row from a legacy per-user `transactions` row.
+ * The caller is responsible for resolving `transactionId` to the
+ * newly-inserted `transactions_v7.transactionId`.
+ */
+function buildActionRow(legacy, v7TransactionId, now = new Date()) {
+    var _a;
+    return {
+        created_at: legacy.created_at,
+        updated_at: now,
+        userId: legacy.userId,
+        transactionId: v7TransactionId,
+        reference: legacy.reference,
+        description: legacy.description,
+        isOutgoing: legacy.isOutgoing,
+        satoshisDelta: (_a = legacy.satoshis) !== null && _a !== void 0 ? _a : 0,
+        userNosend: legacy.status === 'nosend',
+        hidden: false,
+        userAborted: legacy.status === 'failed',
+        notifyJson: undefined,
+        rowVersion: 0
+    };
+}
+//# sourceMappingURL=v7Backfill.js.map

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

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

package/out/src/storage/schema/v7Backfill.knex.d.ts

@@ -0,0 +1,32 @@
+import { Knex } from 'knex';
+import { TableAction, TableProvenTx, TableProvenTxReq, TableTransaction, TableTransactionV7 } from './tables';
+import { V7BackfillDriver, V7BackfillStats } from './v7Backfill.runner';
+/**
+ * Knex driver for the V7 backfill.
+ *
+ * Reads from the legacy `proven_tx_reqs`, `proven_txs`, and `transactions`
+ * tables, writes into the new `transactions_v7` and `actions` tables, and
+ * re-points `tx_labels_map` rows to the new `actionId`.
+ *
+ * All work is performed against the `knex` (or transaction) handle passed in.
+ * The caller is responsible for opening a transaction around the orchestrator
+ * call when atomicity is desired.
+ */
+export declare class V7KnexBackfillDriver implements V7BackfillDriver {
+    private readonly knex;
+    constructor(knex: Knex);
+    streamLegacyReqs(): AsyncIterable<{
+        req: TableProvenTxReq;
+        proven?: TableProvenTx;
+    }>;
+    streamLegacyTransactions(): AsyncIterable<TableTransaction>;
+    upsertTransactionV7(row: Omit<TableTransactionV7, 'transactionId'>): Promise<number>;
+    upsertAction(row: Omit<TableAction, 'actionId'>): Promise<number>;
+    repointTxLabelMap(legacyTransactionId: number, actionId: number): Promise<void>;
+}
+/**
+ * Convenience entry point. Opens a Knex transaction and runs the orchestrator
+ * inside it so that the entire backfill either succeeds or rolls back.
+ */
+export declare function runV7KnexBackfill(knex: Knex, now?: Date): Promise<V7BackfillStats>;
+//# sourceMappingURL=v7Backfill.knex.d.ts.map

package/out/src/storage/schema/v7Backfill.knex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v7Backfill.knex.d.ts","sourceRoot":"","sources":["../../../../src/storage/schema/v7Backfill.knex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,EACL,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAiB,gBAAgB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAItF;;;;;;;;;;GAUG;AACH,qBAAa,oBAAqB,YAAW,gBAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,IAAI;IAEhC,gBAAgB,IAAK,aAAa,CAAC;QAAE,GAAG,EAAE,gBAAgB,CAAC;QAAC,MAAM,CAAC,EAAE,aAAa,CAAA;KAAE,CAAC;IA6DrF,wBAAwB,IAAK,aAAa,CAAC,gBAAgB,CAAC;IAiC9D,mBAAmB,CAAE,GAAG,EAAE,IAAI,CAAC,kBAAkB,EAAE,eAAe,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAuDrF,YAAY,CAAE,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IA0ClE,iBAAiB,CAAE,mBAAmB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMvF;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAE,IAAI,EAAE,IAAI,EAAE,GAAG,GAAE,IAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CAKrG"}

package/out/src/storage/schema/v7Backfill.knex.js

@@ -0,0 +1,240 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.V7KnexBackfillDriver = void 0;
+exports.runV7KnexBackfill = runV7KnexBackfill;
+const v7Backfill_runner_1 = require("./v7Backfill.runner");
+const STREAM_BATCH = 500;
+/**
+ * Knex driver for the V7 backfill.
+ *
+ * Reads from the legacy `proven_tx_reqs`, `proven_txs`, and `transactions`
+ * tables, writes into the new `transactions_v7` and `actions` tables, and
+ * re-points `tx_labels_map` rows to the new `actionId`.
+ *
+ * All work is performed against the `knex` (or transaction) handle passed in.
+ * The caller is responsible for opening a transaction around the orchestrator
+ * call when atomicity is desired.
+ */
+class V7KnexBackfillDriver {
+    constructor(knex) {
+        this.knex = knex;
+    }
+    async *streamLegacyReqs() {
+        var _a, _b, _c;
+        let lastId = 0;
+        /* eslint-disable-next-line no-constant-condition */
+        while (true) {
+            const rows = await this.knex('proven_tx_reqs as r')
+                .leftJoin('proven_txs as p', 'r.provenTxId', 'p.provenTxId')
+                .select('r.*', this.knex.ref('p.height').as('p_height'), this.knex.ref('p.index').as('p_index'), this.knex.ref('p.merklePath').as('p_merklePath'), this.knex.ref('p.blockHash').as('p_blockHash'), this.knex.ref('p.merkleRoot').as('p_merkleRoot'), this.knex.ref('p.rawTx').as('p_rawTx'), this.knex.ref('p.created_at').as('p_created_at'), this.knex.ref('p.updated_at').as('p_updated_at'), this.knex.ref('p.txid').as('p_txid'))
+                .where('r.provenTxReqId', '>', lastId)
+                .orderBy('r.provenTxReqId')
+                .limit(STREAM_BATCH);
+            if (rows.length === 0)
+                return;
+            for (const row of rows) {
+                lastId = row.provenTxReqId;
+                const req = {
+                    created_at: row.created_at,
+                    updated_at: row.updated_at,
+                    provenTxReqId: row.provenTxReqId,
+                    provenTxId: row.provenTxId,
+                    status: row.status,
+                    attempts: row.attempts,
+                    notified: row.notified,
+                    txid: row.txid,
+                    batch: row.batch,
+                    history: row.history,
+                    notify: row.notify,
+                    rawTx: (_a = toBytes(row.rawTx)) !== null && _a !== void 0 ? _a : [],
+                    inputBEEF: toBytes(row.inputBEEF),
+                    wasBroadcast: row.wasBroadcast,
+                    rebroadcastAttempts: row.rebroadcastAttempts
+                };
+                let proven;
+                if (row.p_txid != null) {
+                    proven = {
+                        created_at: row.p_created_at,
+                        updated_at: row.p_updated_at,
+                        provenTxId: row.provenTxId,
+                        txid: row.p_txid,
+                        height: row.p_height,
+                        index: row.p_index,
+                        merklePath: (_b = toBytes(row.p_merklePath)) !== null && _b !== void 0 ? _b : [],
+                        rawTx: (_c = toBytes(row.p_rawTx)) !== null && _c !== void 0 ? _c : [],
+                        blockHash: row.p_blockHash,
+                        merkleRoot: row.p_merkleRoot
+                    };
+                }
+                yield { req, proven };
+            }
+        }
+    }
+    async *streamLegacyTransactions() {
+        let lastId = 0;
+        /* eslint-disable-next-line no-constant-condition */
+        while (true) {
+            const rows = await this.knex('transactions')
+                .where('transactionId', '>', lastId)
+                .orderBy('transactionId')
+                .limit(STREAM_BATCH)
+                .select('*');
+            if (rows.length === 0)
+                return;
+            for (const row of rows) {
+                lastId = row.transactionId;
+                yield {
+                    created_at: row.created_at,
+                    updated_at: row.updated_at,
+                    transactionId: row.transactionId,
+                    userId: row.userId,
+                    provenTxId: row.provenTxId,
+                    status: row.status,
+                    reference: row.reference,
+                    isOutgoing: !!row.isOutgoing,
+                    satoshis: row.satoshis,
+                    description: row.description,
+                    version: row.version,
+                    lockTime: row.lockTime,
+                    txid: row.txid,
+                    inputBEEF: toBytes(row.inputBEEF),
+                    rawTx: toBytes(row.rawTx)
+                };
+            }
+        }
+    }
+    async upsertTransactionV7(row) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
+        const existing = await this.knex('transactions_v7').where({ txid: row.txid }).first('transactionId');
+        if (existing != null) {
+            await this.knex('transactions_v7')
+                .where({ transactionId: existing.transactionId })
+                .update({
+                processing: row.processing,
+                processing_changed_at: row.processingChangedAt,
+                next_action_at: (_a = row.nextActionAt) !== null && _a !== void 0 ? _a : null,
+                attempts: row.attempts,
+                rebroadcast_cycles: row.rebroadcastCycles,
+                was_broadcast: row.wasBroadcast,
+                batch: (_b = row.batch) !== null && _b !== void 0 ? _b : null,
+                raw_tx: toBuf(row.rawTx),
+                input_beef: toBuf(row.inputBeef),
+                height: (_c = row.height) !== null && _c !== void 0 ? _c : null,
+                merkle_index: (_d = row.merkleIndex) !== null && _d !== void 0 ? _d : null,
+                merkle_path: toBuf(row.merklePath),
+                merkle_root: (_e = row.merkleRoot) !== null && _e !== void 0 ? _e : null,
+                block_hash: (_f = row.blockHash) !== null && _f !== void 0 ? _f : null,
+                is_coinbase: row.isCoinbase,
+                updated_at: row.updated_at
+            });
+            return existing.transactionId;
+        }
+        const [insertedId] = await this.knex('transactions_v7').insert({
+            txid: row.txid,
+            processing: row.processing,
+            processing_changed_at: row.processingChangedAt,
+            next_action_at: (_g = row.nextActionAt) !== null && _g !== void 0 ? _g : null,
+            attempts: row.attempts,
+            rebroadcast_cycles: row.rebroadcastCycles,
+            was_broadcast: row.wasBroadcast,
+            idempotency_key: (_h = row.idempotencyKey) !== null && _h !== void 0 ? _h : null,
+            batch: (_j = row.batch) !== null && _j !== void 0 ? _j : null,
+            raw_tx: toBuf(row.rawTx),
+            input_beef: toBuf(row.inputBeef),
+            height: (_k = row.height) !== null && _k !== void 0 ? _k : null,
+            merkle_index: (_l = row.merkleIndex) !== null && _l !== void 0 ? _l : null,
+            merkle_path: toBuf(row.merklePath),
+            merkle_root: (_m = row.merkleRoot) !== null && _m !== void 0 ? _m : null,
+            block_hash: (_o = row.blockHash) !== null && _o !== void 0 ? _o : null,
+            is_coinbase: row.isCoinbase,
+            last_provider: (_p = row.lastProvider) !== null && _p !== void 0 ? _p : null,
+            last_provider_status: (_q = row.lastProviderStatus) !== null && _q !== void 0 ? _q : null,
+            frozen_reason: (_r = row.frozenReason) !== null && _r !== void 0 ? _r : null,
+            row_version: row.rowVersion,
+            created_at: row.created_at,
+            updated_at: row.updated_at
+        });
+        if (typeof insertedId === 'number' && insertedId > 0)
+            return insertedId;
+        const row2 = await this.knex('transactions_v7').where({ txid: row.txid }).first('transactionId');
+        return row2.transactionId;
+    }
+    async upsertAction(row) {
+        var _a, _b;
+        const existing = await this.knex('actions')
+            .where({ userId: row.userId, transactionId: row.transactionId })
+            .first('actionId');
+        if (existing != null) {
+            await this.knex('actions')
+                .where({ actionId: existing.actionId })
+                .update({
+                reference: row.reference,
+                description: row.description,
+                isOutgoing: row.isOutgoing,
+                satoshis_delta: row.satoshisDelta,
+                user_nosend: row.userNosend,
+                hidden: row.hidden,
+                user_aborted: row.userAborted,
+                notify_json: (_a = row.notifyJson) !== null && _a !== void 0 ? _a : null,
+                updated_at: row.updated_at
+            });
+            return existing.actionId;
+        }
+        const [insertedId] = await this.knex('actions').insert({
+            userId: row.userId,
+            transactionId: row.transactionId,
+            reference: row.reference,
+            description: row.description,
+            isOutgoing: row.isOutgoing,
+            satoshis_delta: row.satoshisDelta,
+            user_nosend: row.userNosend,
+            hidden: row.hidden,
+            user_aborted: row.userAborted,
+            notify_json: (_b = row.notifyJson) !== null && _b !== void 0 ? _b : null,
+            row_version: row.rowVersion,
+            created_at: row.created_at,
+            updated_at: row.updated_at
+        });
+        if (typeof insertedId === 'number' && insertedId > 0)
+            return insertedId;
+        const row2 = await this.knex('actions')
+            .where({ userId: row.userId, transactionId: row.transactionId })
+            .first('actionId');
+        return row2.actionId;
+    }
+    async repointTxLabelMap(legacyTransactionId, actionId) {
+        if (legacyTransactionId === actionId)
+            return;
+        await this.knex('tx_labels_map')
+            .where({ transactionId: legacyTransactionId })
+            .update({ transactionId: actionId });
+    }
+}
+exports.V7KnexBackfillDriver = V7KnexBackfillDriver;
+/**
+ * Convenience entry point. Opens a Knex transaction and runs the orchestrator
+ * inside it so that the entire backfill either succeeds or rolls back.
+ */
+async function runV7KnexBackfill(knex, now = new Date()) {
+    return await knex.transaction(async (trx) => {
+        const driver = new V7KnexBackfillDriver(trx);
+        return await (0, v7Backfill_runner_1.runV7Backfill)(driver, now);
+    });
+}
+function toBytes(v) {
+    if (v == null)
+        return undefined;
+    if (Array.isArray(v))
+        return v;
+    if (Buffer.isBuffer(v))
+        return Array.from(v.values());
+    if (v instanceof Uint8Array)
+        return Array.from(v.values());
+    return undefined;
+}
+function toBuf(v) {
+    if (v == null)
+        return null;
+    return Buffer.from(v);
+}
+//# sourceMappingURL=v7Backfill.knex.js.map

package/out/src/storage/schema/v7Backfill.knex.js.map

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

package/out/src/storage/schema/v7Backfill.runner.d.ts

@@ -0,0 +1,63 @@
+import { TableAction, TableProvenTx, TableProvenTxReq, TableTransaction, TableTransactionV7 } from './tables';
+/**
+ * Storage-agnostic driver used by the V7 backfill orchestrator.
+ *
+ * Implementations must be idempotent — calling each method twice with the same
+ * input must not produce duplicate rows. The orchestrator is responsible for
+ * iteration order and chunking; the driver only performs writes.
+ */
+export interface V7BackfillDriver {
+    /** Stream legacy `proven_tx_reqs` rows joined with their `proven_txs` row when available. */
+    streamLegacyReqs: () => AsyncIterable<{
+        req: TableProvenTxReq;
+        proven?: TableProvenTx;
+    }>;
+    /** Stream legacy `transactions` rows ordered by transactionId ascending. */
+    streamLegacyTransactions: () => AsyncIterable<TableTransaction>;
+    /**
+     * Upsert a V7 `transactions` row by `txid`. Returns the resolved
+     * `transactionId` (PK of `transactions_v7`).
+     */
+    upsertTransactionV7: (row: Omit<TableTransactionV7, 'transactionId'>) => Promise<number>;
+    /**
+     * Upsert a V7 `actions` row by `(userId, transactionId)`. Returns the
+     * resolved `actionId`.
+     */
+    upsertAction: (row: Omit<TableAction, 'actionId'>) => Promise<number>;
+    /**
+     * Re-point a single legacy `tx_labels_map` row whose `transactionId` refers
+     * to the old `transactions` PK so that it points to the new `actions.actionId`.
+     *
+     * Implementations may choose to rewrite the entire mapping in bulk and treat
+     * this method as a no-op; the orchestrator will still call it once per pair.
+     */
+    repointTxLabelMap: (legacyTransactionId: number, actionId: number) => Promise<void>;
+}
+export interface V7BackfillStats {
+    reqsBackfilled: number;
+    legacyTxOnlyBackfilled: number;
+    actionsBackfilled: number;
+    labelMapsRepointed: number;
+}
+/**
+ * Orchestrates §3 Steps 2-5 of PROD_REQ_V7_TS.md.
+ *
+ * Strategy:
+ *  1. Walk every `proven_tx_reqs` row (joined with its proof) and upsert a row
+ *     in `transactions_v7`. Build a `txid -> transactionId` map.
+ *  2. Walk every legacy `transactions` row.
+ *     - If the row has a txid AND it is not in the map, upsert a tx-only V7
+ *       row (locally-created actions that never reached the broadcast queue).
+ *     - Compute the V7 `transactionId` for this legacy row. Rows without a
+ *       txid (unsigned, unprocessed) are skipped — they have no canonical V7
+ *       representation yet and are surfaced as gaps in the stats.
+ *  3. Upsert an `actions` row per legacy `transactions` row that has a V7
+ *     transactionId.
+ *  4. Re-point `tx_labels_map.transactionId` from legacy PK to new `actionId`.
+ *
+ * The driver is invoked one row at a time so that the entire pass can run as
+ * a single Knex transaction or a single IDB readwrite transaction without
+ * holding the full row set in memory.
+ */
+export declare function runV7Backfill(driver: V7BackfillDriver, now?: Date): Promise<V7BackfillStats>;
+//# sourceMappingURL=v7Backfill.runner.d.ts.map

package/out/src/storage/schema/v7Backfill.runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v7Backfill.runner.d.ts","sourceRoot":"","sources":["../../../../src/storage/schema/v7Backfill.runner.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,UAAU,CAAA;AAEjB;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6FAA6F;IAC7F,gBAAgB,EAAE,MAAM,aAAa,CAAC;QAAE,GAAG,EAAE,gBAAgB,CAAC;QAAC,MAAM,CAAC,EAAE,aAAa,CAAA;KAAE,CAAC,CAAA;IACxF,4EAA4E;IAC5E,wBAAwB,EAAE,MAAM,aAAa,CAAC,gBAAgB,CAAC,CAAA;IAC/D;;;OAGG;IACH,mBAAmB,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,kBAAkB,EAAE,eAAe,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IACxF;;;OAGG;IACH,YAAY,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IACrE;;;;;;OAMG;IACH,iBAAiB,EAAE,CAAC,mBAAmB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACpF;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAA;IACtB,sBAAsB,EAAE,MAAM,CAAA;IAC9B,iBAAiB,EAAE,MAAM,CAAA;IACzB,kBAAkB,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,aAAa,CAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,GAAE,IAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CAyC/G"}