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

package/out/src/storage/schema/monitorLease.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=monitorLease.js.map

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

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

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

@@ -0,0 +1,27 @@
+import * as sdk from '../../sdk';
+export interface FsmTransitionResult {
+    ok: boolean;
+    reason?: string;
+}
+/**
+ * Returns true when `from -> to` is a permitted processing transition.
+ * Identity transitions (`from === to`) are always allowed — they represent a
+ * status refresh without state change.
+ */
+export declare function isValidProcessingTransition(from: sdk.ProcessingStatus, to: sdk.ProcessingStatus): boolean;
+/**
+ * As `isValidProcessingTransition` but returns a structured result with a
+ * human-readable reason for any rejection. Useful for `tx_audit` payloads.
+ */
+export declare function validateProcessingTransition(from: sdk.ProcessingStatus, to: sdk.ProcessingStatus): FsmTransitionResult;
+/** Snapshot of the transition table for documentation + tests. */
+export declare function processingTransitionMap(): Readonly<Record<sdk.ProcessingStatus, readonly sdk.ProcessingStatus[]>>;
+/**
+ * True when the given state implies the transaction has been seen / accepted
+ * by at least one network provider — the precondition for output spendability
+ * in §4.
+ */
+export declare function isProcessingSpendable(s: sdk.ProcessingStatus): boolean;
+/** True when the state is terminal (no further automatic transitions). */
+export declare function isProcessingTerminal(s: sdk.ProcessingStatus): boolean;
+//# sourceMappingURL=processingFsm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"processingFsm.d.ts","sourceRoot":"","sources":["../../../../src/storage/schema/processingFsm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,WAAW,CAAA;AAuDhC,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,GAAG,CAAC,gBAAgB,EAC1B,EAAE,EAAE,GAAG,CAAC,gBAAgB,GACvB,OAAO,CAGT;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,GAAG,CAAC,gBAAgB,EAC1B,EAAE,EAAE,GAAG,CAAC,gBAAgB,GACvB,mBAAmB,CAMrB;AAED,kEAAkE;AAClE,wBAAgB,uBAAuB,IAAK,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE,SAAS,GAAG,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAElH;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAE,CAAC,EAAE,GAAG,CAAC,gBAAgB,GAAG,OAAO,CAEvE;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAE,CAAC,EAAE,GAAG,CAAC,gBAAgB,GAAG,OAAO,CAEtE"}

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

@@ -0,0 +1,132 @@
+"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.isValidProcessingTransition = isValidProcessingTransition;
+exports.validateProcessingTransition = validateProcessingTransition;
+exports.processingTransitionMap = processingTransitionMap;
+exports.isProcessingSpendable = isProcessingSpendable;
+exports.isProcessingTerminal = isProcessingTerminal;
+const sdk = __importStar(require("../../sdk"));
+/**
+ * processing-state machine.
+ *
+ * Maps each `ProcessingStatus` to the set of states it may legally transition
+ * to. Terminal states (`confirmed`, `invalid`, `doubleSpend`) have no outgoing
+ * transitions except via the `unfail` operator override.
+ *
+ * The transition table is intentionally permissive — the goal is to *reject
+ * impossible* moves (e.g. `queued -> confirmed` without ever broadcasting) rather
+ * than to enumerate the happy path. Stateful preconditions (proof present,
+ * provider acknowledged) are enforced at the call site.
+ */
+const TRANSITIONS = {
+    // `queued -> doubleSpend`: a tx queued locally may be reported as a
+    // double-spend by the network before our first send attempt (e.g. another
+    // wallet broadcast the same outpoint first). See STORAGE_METHOD_WIRING §4
+    // legacy mapping `* -> doubleSpend (rejection)`.
+    queued: ['sending', 'sent', 'nosend', 'frozen', 'nonfinal', 'invalid', 'doubleSpend'],
+    sending: ['sent', 'seen', 'seen_multi', 'invalid', 'doubleSpend', 'frozen', 'queued'],
+    sent: ['seen', 'seen_multi', 'unconfirmed', 'confirmed', 'invalid', 'doubleSpend', 'frozen', 'sending'],
+    // `seen -> sending`: provider re-acknowledgment lost; legacy mapping
+    // `* -> sending (serviceError retry)` from STORAGE_METHOD_WIRING §4.
+    seen: ['seen_multi', 'unconfirmed', 'confirmed', 'invalid', 'doubleSpend', 'reorging', 'frozen', 'sending'],
+    // `seen_multi -> sending`: same retry semantics as `seen -> sending`.
+    seen_multi: ['unconfirmed', 'confirmed', 'invalid', 'doubleSpend', 'reorging', 'frozen', 'sending'],
+    // `unconfirmed -> doubleSpend`: a provider's proof candidate may be retracted
+    // when a competing tx is mined. `unconfirmed -> sending`: candidate failed
+    // chaintracks validation, restart broadcast attempts. Both per §4.
+    unconfirmed: ['confirmed', 'invalid', 'reorging', 'frozen', 'seen', 'seen_multi', 'doubleSpend', 'sending'],
+    confirmed: ['reorging'],
+    // Reorg rule (bsv_wallet_transaction_requirements v1.0 §5):
+    // "A reorg SHALL never cause a transaction to be marked Invalid or
+    // DoubleSpend." The reorging state is therefore restricted to recovery
+    // edges only — back to a confirmation-class state or to frozen for
+    // operator review. Callers that later determine the tx is genuinely
+    // invalid or a doubleSpend must first transition through `unconfirmed`
+    // (where the standard FSM edges to `invalid`/`doubleSpend` apply) so the
+    // rejection is recorded against a non-reorg cause in `tx_audit`.
+    reorging: ['confirmed', 'seen', 'seen_multi', 'unconfirmed', 'frozen'],
+    invalid: ['unfail'],
+    doubleSpend: ['unfail'],
+    unfail: ['queued', 'sending', 'sent', 'seen', 'seen_multi', 'unconfirmed', 'confirmed', 'invalid', 'doubleSpend'],
+    frozen: ['queued', 'sending', 'sent', 'seen', 'seen_multi', 'unconfirmed', 'invalid', 'doubleSpend'],
+    // `nosend -> sending`: operator (or processAction promotion) moves a
+    // never-broadcast tx into the active broadcast pipeline. `nosend ->
+    // doubleSpend`: an externally-broadcast nosend tx may be reported as a
+    // double-spend. Both per §4 legacy mapping.
+    nosend: ['queued', 'sending', 'sent', 'seen', 'invalid', 'doubleSpend', 'frozen'],
+    // `nonfinal -> doubleSpend`: a live-nLockTime tx may be replaced by a
+    // confirmed competing tx and reported as a double-spend.
+    nonfinal: ['queued', 'sending', 'sent', 'invalid', 'doubleSpend', 'frozen']
+};
+/**
+ * Returns true when `from -> to` is a permitted processing transition.
+ * Identity transitions (`from === to`) are always allowed — they represent a
+ * status refresh without state change.
+ */
+function isValidProcessingTransition(from, to) {
+    if (from === to)
+        return true;
+    return TRANSITIONS[from].includes(to);
+}
+/**
+ * As `isValidProcessingTransition` but returns a structured result with a
+ * human-readable reason for any rejection. Useful for `tx_audit` payloads.
+ */
+function validateProcessingTransition(from, to) {
+    if (isValidProcessingTransition(from, to))
+        return { ok: true };
+    return {
+        ok: false,
+        reason: `illegal transition ${from} -> ${to}; legal next: ${TRANSITIONS[from].join(', ')}`
+    };
+}
+/** Snapshot of the transition table for documentation + tests. */
+function processingTransitionMap() {
+    return TRANSITIONS;
+}
+/**
+ * True when the given state implies the transaction has been seen / accepted
+ * by at least one network provider — the precondition for output spendability
+ * in §4.
+ */
+function isProcessingSpendable(s) {
+    return sdk.ProcessingSpendableStatus.includes(s);
+}
+/** True when the state is terminal (no further automatic transitions). */
+function isProcessingTerminal(s) {
+    return sdk.ProcessingTerminalStatus.includes(s);
+}
+//# sourceMappingURL=processingFsm.js.map

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

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

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

@@ -0,0 +1,34 @@
+import { Knex } from 'knex';
+/**
+ * §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`.
+ */
+export declare function runSchemaCutover(knex: Knex): Promise<void>;
+/**
+ * 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.
+ */
+export declare function rollbackSchemaCutover(knex: Knex): Promise<void>;
+//# sourceMappingURL=schemaCutover.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemaCutover.d.ts","sourceRoot":"","sources":["../../../../src/storage/schema/schemaCutover.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAK3B;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,gBAAgB,CAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAyFjE;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBtE"}

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"}