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

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

@@ -0,0 +1,230 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSchemaCutover = runSchemaCutover;
+exports.rollbackSchemaCutover = rollbackSchemaCutover;
+const backfill_knex_1 = require("./backfill.knex");
+const backfill_runner_1 = require("./backfill.runner");
+/**
+ * §3 Step 6 of PROD_REQ_V7_TS.md — destructive cutover.
+ *
+ * Renames the legacy `transactions`, `proven_tx_reqs`, and `proven_txs` tables
+ * to `*_legacy`, swaps the new-schema `transactions_new` table in as the new
+ * canonical `transactions`, and remaps every FK value in `outputs`,
+ * `commissions`, and `tx_labels_map` so that downstream storage methods
+ * continue to read consistent rows.
+ *
+ * Not registered as a Knex migration because applying it changes the meaning
+ * of table names that legacy storage methods still address. Run it only when
+ * the calling application is ready to use the new-schema storage path.
+ *
+ * Safe to call:
+ *  - on a populated DB that has not yet been cutover (performs full migration)
+ *  - on a fresh DB (renames empty tables to match the post-cutover layout)
+ *  - twice in a row (second call is a no-op via the `transactions_legacy`
+ *    presence guard)
+ *
+ * The function is intentionally not wrapped in a Knex transaction: on SQLite
+ * we need to toggle the per-connection `legacy_alter_table` pragma between
+ * statements, which is incompatible with the deferred-commit semantics
+ * Knex uses inside `knex.transaction`.
+ */
+async function runSchemaCutover(knex) {
+    var _a, _b;
+    const dbtype = await determineDBType(knex);
+    const isSqlite = dbtype === 'SQLite';
+    // Idempotency guard.
+    if (await hasTable(knex, 'transactions_legacy'))
+        return;
+    // Ensure backfill has populated transactions_new / actions before remapping.
+    const txCount = await knex('transactions').count({ c: '*' }).first();
+    const newTxCount = await knex('transactions_new').count({ c: '*' }).first();
+    const hasLegacyData = ((_a = txCount === null || txCount === void 0 ? void 0 : txCount.c) !== null && _a !== void 0 ? _a : 0) > 0;
+    const newTxPopulated = ((_b = newTxCount === null || newTxCount === void 0 ? void 0 : newTxCount.c) !== null && _b !== void 0 ? _b : 0) > 0;
+    if (hasLegacyData && !newTxPopulated) {
+        const driver = new backfill_knex_1.KnexBackfillDriver(knex);
+        await (0, backfill_runner_1.runBackfill)(driver);
+    }
+    // Build mappings legacy.transactionId -> { newTxId, actionId }.
+    const txMapRows = hasLegacyData
+        ? await knex('transactions as t')
+            .join('transactions_new as v', 'v.txid', 't.txid')
+            .select(knex.ref('t.transactionId').as('legacyId'), knex.ref('v.transactionId').as('newTxId'))
+        : [];
+    const actionMapRows = hasLegacyData
+        ? await knex('transactions as t')
+            .join('transactions_new as v', 'v.txid', 't.txid')
+            .join('actions as a', function joinAction() {
+            this.on('a.userId', '=', 't.userId').andOn('a.transactionId', '=', 'v.transactionId');
+        })
+            .select(knex.ref('t.transactionId').as('legacyId'), knex.ref('a.actionId').as('actionId'))
+        : [];
+    const legacyToNew = new Map(txMapRows.map(r => [r.legacyId, r.newTxId]));
+    const legacyToAction = new Map(actionMapRows.map(r => [r.legacyId, r.actionId]));
+    await disableFks(knex, isSqlite);
+    try {
+        // Remap downstream FK values with a temporary offset to dodge collisions
+        // with the existing legacy keyspace during partial updates.
+        const OFFSET = 1000000000;
+        for (const [legacy, newId] of legacyToNew) {
+            const shifted = newId + OFFSET;
+            await knex('outputs').where({ transactionId: legacy }).update({ transactionId: shifted });
+            await knex('outputs').where({ spentBy: legacy }).update({ spentBy: shifted });
+            await knex('commissions').where({ transactionId: legacy }).update({ transactionId: shifted });
+        }
+        await knex('outputs').where('transactionId', '>=', OFFSET).update({
+            transactionId: knex.raw('?? - ?', ['transactionId', OFFSET])
+        });
+        await knex('outputs').where('spentBy', '>=', OFFSET).update({
+            spentBy: knex.raw('?? - ?', ['spentBy', OFFSET])
+        });
+        await knex('commissions').where('transactionId', '>=', OFFSET).update({
+            transactionId: knex.raw('?? - ?', ['transactionId', OFFSET])
+        });
+        for (const [legacy, actionId] of legacyToAction) {
+            const shifted = actionId + OFFSET;
+            await knex('tx_labels_map').where({ transactionId: legacy }).update({ transactionId: shifted });
+        }
+        await knex('tx_labels_map').where('transactionId', '>=', OFFSET).update({
+            transactionId: knex.raw('?? - ?', ['transactionId', OFFSET])
+        });
+        // legacy_alter_table = ON suppresses SQLite's automatic FK rewrite on
+        // RENAME. We want it ON for the `transactions` rename only (so that the
+        // outputs / commissions / tx_labels_map FKs keep pointing at the bare
+        // string "transactions" and resolve to the new table after the swap).
+        // For `proven_tx_reqs` and `proven_txs`, we want OFF so SQLite rewrites
+        // the FK references inside proven_tx_reqs_legacy / transactions_legacy
+        // (which target proven_txs) to follow the rename to proven_txs_legacy.
+        // Without that rewrite, inserts into proven_tx_reqs_legacy fail because
+        // the resolver looks up the bare "proven_txs" string and finds nothing.
+        if (isSqlite)
+            await knex.raw('PRAGMA legacy_alter_table = ON');
+        await knex.schema.renameTable('transactions', 'transactions_legacy');
+        if (isSqlite)
+            await knex.raw('PRAGMA legacy_alter_table = OFF');
+        await knex.schema.renameTable('proven_tx_reqs', 'proven_tx_reqs_legacy');
+        await knex.schema.renameTable('proven_txs', 'proven_txs_legacy');
+        // OFF (the default modern mode) ensures the rename of `transactions_new`
+        // → `transactions` rewrites any FK reference that pointed at the original
+        // new-schema name. tx_audit / actions originally targeted `transactions_new`
+        // and follow the rename to `transactions` automatically.
+        await knex.schema.renameTable('transactions_new', 'transactions');
+        await rebuildTxLabelsMap(knex, dbtype);
+    }
+    finally {
+        await enableFks(knex, isSqlite);
+    }
+}
+/**
+ * Inverse of `runSchemaCutover` for test rollback. Renames `*_legacy` tables back
+ * to their canonical names and swaps `transactions` back to `transactions_new`.
+ * Does not reverse the FK value remap — call this only when the cutover was
+ * applied to seed data that the test no longer needs.
+ */
+async function rollbackSchemaCutover(knex) {
+    const dbtype = await determineDBType(knex);
+    const isSqlite = dbtype === 'SQLite';
+    await disableFks(knex, isSqlite);
+    try {
+        if (isSqlite)
+            await knex.raw('PRAGMA legacy_alter_table = ON');
+        if (await hasTable(knex, 'transactions')) {
+            await knex.schema.renameTable('transactions', 'transactions_new');
+        }
+        if (await hasTable(knex, 'transactions_legacy')) {
+            await knex.schema.renameTable('transactions_legacy', 'transactions');
+        }
+        if (await hasTable(knex, 'proven_tx_reqs_legacy')) {
+            await knex.schema.renameTable('proven_tx_reqs_legacy', 'proven_tx_reqs');
+        }
+        if (await hasTable(knex, 'proven_txs_legacy')) {
+            await knex.schema.renameTable('proven_txs_legacy', 'proven_txs');
+        }
+        if (isSqlite)
+            await knex.raw('PRAGMA legacy_alter_table = OFF');
+    }
+    finally {
+        await enableFks(knex, isSqlite);
+    }
+}
+async function determineDBType(knex) {
+    var _a, _b, _c;
+    // Avoid pulling KnexMigrations' determineDBType to keep this module
+    // free of cyclic imports.
+    try {
+        const r = await knex.raw("SELECT 'MySQL' AS database_type FROM dual");
+        const dbtype = (_c = (Array.isArray(r) ? r[0] : (_b = (_a = r.rows) === null || _a === void 0 ? void 0 : _a[0]) !== null && _b !== void 0 ? _b : r[0])) === null || _c === void 0 ? void 0 : _c.database_type;
+        if (dbtype === 'MySQL')
+            return 'MySQL';
+    }
+    catch (e) {
+        // fallthrough — SQLite has no `dual` table
+    }
+    try {
+        await knex.raw('SELECT 1');
+        return 'SQLite';
+    }
+    catch (e) {
+        throw new Error('Unsupported database engine for schema cutover');
+    }
+}
+async function hasTable(knex, name) {
+    return await knex.schema.hasTable(name);
+}
+async function disableFks(knex, isSqlite) {
+    if (isSqlite) {
+        await knex.raw('PRAGMA foreign_keys = OFF');
+    }
+    else {
+        await knex.raw('SET FOREIGN_KEY_CHECKS=0');
+    }
+}
+async function enableFks(knex, isSqlite) {
+    if (isSqlite) {
+        await knex.raw('PRAGMA foreign_keys = ON');
+    }
+    else {
+        await knex.raw('SET FOREIGN_KEY_CHECKS=1');
+    }
+}
+async function rebuildTxLabelsMap(knex, dbtype) {
+    var _a, _b;
+    if (dbtype === 'SQLite') {
+        await knex.schema.createTable('tx_labels_map_new', table => {
+            table.timestamp('created_at', { precision: 3 }).defaultTo(knex.fn.now()).notNullable();
+            table.timestamp('updated_at', { precision: 3 }).defaultTo(knex.fn.now()).notNullable();
+            table.integer('txLabelId').unsigned().references('txLabelId').inTable('tx_labels').notNullable();
+            table.integer('transactionId').unsigned().references('actionId').inTable('actions').notNullable();
+            table.boolean('isDeleted').notNullable().defaultTo(false);
+            table.unique(['txLabelId', 'transactionId']);
+        });
+        await knex.raw('INSERT INTO tx_labels_map_new (created_at, updated_at, txLabelId, transactionId, isDeleted) ' +
+            'SELECT created_at, updated_at, txLabelId, transactionId, isDeleted FROM tx_labels_map');
+        await knex.schema.dropTable('tx_labels_map');
+        await knex.schema.renameTable('tx_labels_map_new', 'tx_labels_map');
+        await knex.schema.alterTable('tx_labels_map', table => {
+            table.index('transactionId');
+            table.index(['transactionId', 'isDeleted'], 'idx_tx_labels_map_tx_deleted');
+        });
+    }
+    else {
+        const dbRow = (await knex.raw('SELECT DATABASE() AS d'))[0];
+        const dbName = Array.isArray(dbRow) ? (_a = dbRow[0]) === null || _a === void 0 ? void 0 : _a.d : dbRow === null || dbRow === void 0 ? void 0 : dbRow.d;
+        const fkRows = await knex('information_schema.KEY_COLUMN_USAGE')
+            .select('CONSTRAINT_NAME')
+            .where({
+            TABLE_SCHEMA: dbName,
+            TABLE_NAME: 'tx_labels_map',
+            COLUMN_NAME: 'transactionId'
+        })
+            .whereNotNull('REFERENCED_TABLE_NAME');
+        for (const row of fkRows !== null && fkRows !== void 0 ? fkRows : []) {
+            const constraintName = (_b = row.CONSTRAINT_NAME) !== null && _b !== void 0 ? _b : row.constraint_name;
+            if (constraintName != null) {
+                await knex.raw('ALTER TABLE tx_labels_map DROP FOREIGN KEY `' + constraintName + '`');
+            }
+        }
+        await knex.raw('ALTER TABLE tx_labels_map ADD CONSTRAINT fk_tx_labels_map_action ' +
+            'FOREIGN KEY (transactionId) REFERENCES actions(actionId)');
+    }
+}
+//# sourceMappingURL=schemaCutover.js.map

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

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

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

@@ -0,0 +1,26 @@
+import { IDBPDatabase } from 'idb';
+import { StorageIdbSchema } from './StorageIdbSchema';
+/**
+ * IDB-side schema cutover.
+ *
+ * IndexedDB has no `RENAME STORE` primitive, and store creation/deletion is
+ * only permitted during a version-upgrade transaction. The cutover therefore:
+ *
+ *   1. Re-opens the database at a higher version, supplying an `upgrade`
+ *      callback that does the rename via copy-and-delete on the upgrade trx.
+ *   2. For each table that needs renaming:
+ *        a. Read every row from the source store.
+ *        b. Create the destination store with the same indexes.
+ *        c. Write rows into the destination store.
+ *        d. Delete the source store.
+ *   3. Returns the upgraded database handle (caller is responsible for
+ *      closing it).
+ *
+ * Safe to call twice — the second call sees the post-cutover layout, skips
+ * the rename block, and returns without error.
+ *
+ * `targetVersion` defaults to 2; bump it if the caller already operates on a
+ * higher schema version.
+ */
+export declare function runIdbSchemaCutover(dbName: string, targetVersion?: number): Promise<IDBPDatabase<StorageIdbSchema>>;
+//# sourceMappingURL=schemaCutoverIdb.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemaCutoverIdb.d.ts","sourceRoot":"","sources":["../../../../src/storage/schema/schemaCutoverIdb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA2B,MAAM,KAAK,CAAA;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAErD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,aAAa,SAAI,GAChB,OAAO,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAyDzC"}

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

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runIdbSchemaCutover = runIdbSchemaCutover;
+const idb_1 = require("idb");
+/**
+ * IDB-side schema cutover.
+ *
+ * IndexedDB has no `RENAME STORE` primitive, and store creation/deletion is
+ * only permitted during a version-upgrade transaction. The cutover therefore:
+ *
+ *   1. Re-opens the database at a higher version, supplying an `upgrade`
+ *      callback that does the rename via copy-and-delete on the upgrade trx.
+ *   2. For each table that needs renaming:
+ *        a. Read every row from the source store.
+ *        b. Create the destination store with the same indexes.
+ *        c. Write rows into the destination store.
+ *        d. Delete the source store.
+ *   3. Returns the upgraded database handle (caller is responsible for
+ *      closing it).
+ *
+ * Safe to call twice — the second call sees the post-cutover layout, skips
+ * the rename block, and returns without error.
+ *
+ * `targetVersion` defaults to 2; bump it if the caller already operates on a
+ * higher schema version.
+ */
+async function runIdbSchemaCutover(dbName, targetVersion = 2) {
+    return await (0, idb_1.openDB)(dbName, targetVersion, {
+        async upgrade(db, oldVersion, _newVersion, trx) {
+            if (oldVersion >= 2)
+                return;
+            if (!db.objectStoreNames.contains('transactions_new'))
+                return;
+            await renameStore(db, trx, 'transactions', 'transactions_legacy', store => {
+                store.createIndex('userId', 'userId');
+                store.createIndex('status', 'status');
+                store.createIndex('status_userId', ['status', 'userId']);
+                store.createIndex('provenTxId', 'provenTxId');
+                store.createIndex('reference', 'reference', { unique: true });
+            });
+            await renameStore(db, trx, 'proven_tx_reqs', 'proven_tx_reqs_legacy', store => {
+                store.createIndex('provenTxId', 'provenTxId');
+                store.createIndex('txid', 'txid', { unique: true });
+                store.createIndex('status', 'status');
+                store.createIndex('batch', 'batch');
+            });
+            await renameStore(db, trx, 'proven_txs', 'proven_txs_legacy', store => {
+                store.createIndex('txid', 'txid', { unique: true });
+            });
+            await renameStore(db, trx, 'transactions_new', 'transactions', store => {
+                store.createIndex('txid', 'txid', { unique: true });
+                store.createIndex('processing', 'processing');
+                store.createIndex('batch', 'batch');
+                store.createIndex('idempotencyKey', 'idempotencyKey', { unique: true });
+            });
+        }
+    });
+}
+async function renameStore(db, trx, fromName, toName, applyIndexes) {
+    if (!db.objectStoreNames.contains(fromName))
+        return;
+    if (db.objectStoreNames.contains(toName)) {
+        // Target already exists — assume a prior partial cutover. Drop the source
+        // and continue rather than fail; the application is expected to verify
+        // post-cutover state via its own smoke tests before resuming traffic.
+        db.deleteObjectStore(fromName);
+        return;
+    }
+    const sourceStore = trx.objectStore(fromName);
+    const sourceKeyPath = sourceStore.keyPath;
+    const sourceAutoIncrement = sourceStore.autoIncrement;
+    const rows = await sourceStore.getAll();
+    const keys = await sourceStore.getAllKeys();
+    db.deleteObjectStore(fromName);
+    const dest = db.createObjectStore(toName, {
+        keyPath: sourceKeyPath !== null && sourceKeyPath !== void 0 ? sourceKeyPath : undefined,
+        autoIncrement: sourceAutoIncrement
+    });
+    applyIndexes(dest);
+    const destStore = trx.objectStore(toName);
+    for (let i = 0; i < rows.length; i++) {
+        if (sourceAutoIncrement || sourceKeyPath != null) {
+            await destStore.put(rows[i]);
+        }
+        else {
+            await destStore.put(rows[i], keys[i]);
+        }
+    }
+}
+//# sourceMappingURL=schemaCutoverIdb.js.map

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

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

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

@@ -0,0 +1,49 @@
+import { Knex } from 'knex';
+import * as sdk from '../../sdk';
+/**
+ * Recompute and persist `outputs.spendable` for every output whose current
+ * cached value disagrees with the §4 rule.
+ *
+ * The §4 rule depends on three inputs:
+ *   - The owning transaction's `processing` state.
+ *   - Whether the output has been spent.
+ *   - For coinbase outputs, whether maturity height has been reached on the
+ *     current chain tip.
+ *
+ * Strategy: stream outputs joined with their owning transaction's processing
+ * state in batches, evaluate the rule per row in JS, and update only rows
+ * whose persisted `spendable` flag differs from the freshly-computed value.
+ *
+ * Returns counts so callers can detect drift and emit metrics.
+ */
+export interface RefreshSpendabilityStats {
+    examined: number;
+    flipped: number;
+}
+export interface RefreshSpendabilityArgs {
+    /** Limit to outputs owned by this user. Default: refresh all users. */
+    userId?: number;
+    /** Reuse a chain tip already fetched by the caller. */
+    chainTip?: {
+        height: number;
+    };
+}
+export declare function refreshOutputsSpendable(knex: Knex, args?: RefreshSpendabilityArgs): Promise<RefreshSpendabilityStats>;
+/**
+ * Fast-path counter used by the new-schema hot query in §2.3:
+ *
+ *   SELECT * FROM outputs
+ *   WHERE user_id = ? AND spendable = true AND basketId = default
+ *   ORDER BY satoshis DESC LIMIT 100
+ *
+ * Returns the count of spendable outputs visible to the user in a basket
+ * without joining transactions. Used by tests to assert that the cached
+ * `outputs.spendable` column stays in sync with processing state.
+ */
+export declare function countCachedSpendable(knex: Knex, args: {
+    userId: number;
+    basketId?: number;
+}): Promise<number>;
+/** Snapshot of every spendable processing state. Mostly informational. */
+export declare function spendableProcessingStates(): readonly sdk.ProcessingStatus[];
+//# sourceMappingURL=spendabilityRefresh.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spendabilityRefresh.d.ts","sourceRoot":"","sources":["../../../../src/storage/schema/spendabilityRefresh.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,KAAK,GAAG,MAAM,WAAW,CAAA;AAOhC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,uDAAuD;IACvD,QAAQ,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAC9B;AAED,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,IAAI,EACV,IAAI,GAAE,uBAA4B,GACjC,OAAO,CAAC,wBAAwB,CAAC,CAkEnC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,IAAI,EACV,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1C,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED,0EAA0E;AAC1E,wBAAgB,yBAAyB,IAAK,SAAS,GAAG,CAAC,gBAAgB,EAAE,CAE5E"}

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

@@ -0,0 +1,120 @@
+"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.refreshOutputsSpendable = refreshOutputsSpendable;
+exports.countCachedSpendable = countCachedSpendable;
+exports.spendableProcessingStates = spendableProcessingStates;
+const sdk = __importStar(require("../../sdk"));
+const spendabilityRule_1 = require("./spendabilityRule");
+const REFRESH_BATCH = 500;
+const SPENDABLE_STATES = sdk.ProcessingSpendableStatus.slice();
+async function refreshOutputsSpendable(knex, args = {}) {
+    var _a, _b, _c, _d, _e;
+    const stats = { examined: 0, flipped: 0 };
+    const tip = (_a = args.chainTip) !== null && _a !== void 0 ? _a : (await knex('chain_tip').where({ id: 1 }).first('height'));
+    const tipHeight = tip === null || tip === void 0 ? void 0 : tip.height;
+    let lastId = 0;
+    /* eslint-disable-next-line no-constant-condition */
+    while (true) {
+        const baseQuery = knex('outputs as o')
+            .leftJoin('transactions as t', 't.transactionId', 'o.transactionId')
+            .where('o.outputId', '>', lastId)
+            .orderBy('o.outputId')
+            .limit(REFRESH_BATCH)
+            .select(knex.ref('o.outputId').as('outputId'), knex.ref('o.spendable').as('spendable'), knex.ref('o.spentBy').as('spentBy'), knex.ref('o.lockingScript').as('lockingScript'), knex.raw('o.scriptLength as scriptLength'), knex.raw('o.matures_at_height as maturesAtHeight'), knex.ref('t.processing').as('processing'), knex.ref('t.is_coinbase').as('isCoinbase'));
+        const rows = args.userId != null
+            ? await baseQuery.andWhere('o.userId', args.userId)
+            : await baseQuery;
+        if (rows.length === 0)
+            return stats;
+        for (const row of rows) {
+            lastId = row.outputId;
+            stats.examined += 1;
+            // Reorg rule (bsv_wallet_transaction_requirements v1.0 §6):
+            // "Reorg: Revert transaction status; preserve the current spendable
+            // value of outputs (do not flip to false)."
+            // We honor this by skipping refresh while the owning transaction is
+            // in the `reorging` state. Whatever spendable value was cached at
+            // entry into reorg is preserved until the reorg resolves and the
+            // transaction transitions back to a normal state.
+            if (row.processing === 'reorging')
+                continue;
+            const desired = (0, spendabilityRule_1.isOutputSpendable)({
+                spentBy: (_b = row.spentBy) !== null && _b !== void 0 ? _b : null,
+                // Treat presence of scriptLength as equivalent to presence of
+                // locking script — the §4 rule only requires that some locking
+                // script exists, not that it has been fetched into memory.
+                lockingScript: (_d = ((_c = row.lockingScript) !== null && _c !== void 0 ? _c : null)) !== null && _d !== void 0 ? _d : (row.scriptLength != null ? [0] : null),
+                isCoinbase: row.isCoinbase === 1 || row.isCoinbase === true,
+                // Read the persisted maturity height from the new outputs column.
+                // A null value for a coinbase row means maturity has not been
+                // computed yet; the §4 rule treats that as not-yet-mature and
+                // refuses spendability until backfill populates the column.
+                maturesAtHeight: (_e = row.maturesAtHeight) !== null && _e !== void 0 ? _e : null
+            }, { processing: row.processing }, tipHeight != null ? { height: tipHeight } : undefined);
+            const current = row.spendable === 1 || row.spendable === true;
+            if (current !== desired) {
+                await knex('outputs')
+                    .where({ outputId: row.outputId })
+                    .update({ spendable: desired });
+                stats.flipped += 1;
+            }
+        }
+    }
+}
+/**
+ * Fast-path counter used by the new-schema hot query in §2.3:
+ *
+ *   SELECT * FROM outputs
+ *   WHERE user_id = ? AND spendable = true AND basketId = default
+ *   ORDER BY satoshis DESC LIMIT 100
+ *
+ * Returns the count of spendable outputs visible to the user in a basket
+ * without joining transactions. Used by tests to assert that the cached
+ * `outputs.spendable` column stays in sync with processing state.
+ */
+async function countCachedSpendable(knex, args) {
+    var _a;
+    const q = knex('outputs').where({ userId: args.userId, spendable: true });
+    if (args.basketId != null)
+        q.andWhere({ basketId: args.basketId });
+    const row = await q.count({ c: '*' }).first();
+    return (_a = row === null || row === void 0 ? void 0 : row.c) !== null && _a !== void 0 ? _a : 0;
+}
+/** Snapshot of every spendable processing state. Mostly informational. */
+function spendableProcessingStates() {
+    return SPENDABLE_STATES;
+}
+//# sourceMappingURL=spendabilityRefresh.js.map

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

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

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

@@ -0,0 +1,45 @@
+import * as sdk from '../../sdk';
+import { TableChainTip, TableOutput, TableTransactionNew } from './tables';
+/**
+ * Per-output inputs for the new-schema spendability check.
+ *
+ * Only the fields needed by §4 of PROD_REQ_V7_TS.md are required; callers are
+ * free to pass full rows. `spentBy` is the legacy `outputs.spentBy` column;
+ * coinbase fields use the names introduced in §2.3.
+ */
+export interface SpendabilityOutputInput {
+    spentBy?: number | null;
+    lockingScript?: number[] | null;
+    isCoinbase?: boolean;
+    maturesAtHeight?: number | null;
+}
+export interface SpendabilityTxInput {
+    processing: sdk.ProcessingStatus;
+}
+export interface SpendabilityTipInput {
+    height: number;
+}
+/**
+ * Pure implementation of the §4 spendability rule:
+ *
+ * ```
+ * spendable = (transactions.processing IN ('sent','seen','seen_multi','unconfirmed','confirmed'))
+ *           AND outputs.spent_by IS NULL
+ *           AND outputs.locking_script IS NOT NULL
+ *           AND (NOT outputs.is_coinbase OR outputs.matures_at_height <= chain_tip.height)
+ * ```
+ *
+ * The function never reads from storage — call sites are responsible for
+ * loading the matching transaction row and chain tip. This keeps the rule
+ * testable in isolation and lets the refresh helpers batch loads efficiently.
+ */
+export declare function isOutputSpendable(out: SpendabilityOutputInput, tx: SpendabilityTxInput, tip: SpendabilityTipInput | undefined): boolean;
+/**
+ * Convenience wrapper that takes whole table rows and forwards to the pure
+ * predicate. Returns `false` when the matching transaction row is missing.
+ */
+export declare function isTableOutputSpendable(out: TableOutput & {
+    isCoinbase?: boolean;
+    maturesAtHeight?: number | null;
+}, tx: TableTransactionNew | undefined, tip: TableChainTip | undefined): boolean;
+//# sourceMappingURL=spendabilityRule.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spendabilityRule.d.ts","sourceRoot":"","sources":["../../../../src/storage/schema/spendabilityRule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAG1E;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IAC/B,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAChC;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,GAAG,CAAC,gBAAgB,CAAA;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,uBAAuB,EAC5B,EAAE,EAAE,mBAAmB,EACvB,GAAG,EAAE,oBAAoB,GAAG,SAAS,GACpC,OAAO,CAUT;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,WAAW,GAAG;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAC5E,EAAE,EAAE,mBAAmB,GAAG,SAAS,EACnC,GAAG,EAAE,aAAa,GAAG,SAAS,GAC7B,OAAO,CAYT"}