@breeztech/breez-sdk-spark 0.16.1-dev1 → 0.17.1

package/nodejs/mysql-storage/index.cjs

@@ -105,6 +105,21 @@ function toBool(value) {
   return value === 1 || value === "1" || value === true;
 }
 
+/**
+ * Maps a brz_cross_chain_swaps row to the camelCase StoredCrossChainSwap shape
+ * the SDK expects, coercing TINYINT(1) to a boolean.
+ */
+function crossChainSwapFromRow(row) {
+  return {
+    provider: row.provider,
+    id: row.id,
+    isTerminal: toBool(row.is_terminal),
+    updatedAt: Number(row.updated_at),
+    data: row.data,
+    secrets: row.secrets,
+  };
+}
+
 class MysqlStorage {
   /**
    * @param {import('mysql2/promise').Pool} pool - Connection pool (may be shared with other tenants).
@@ -260,6 +275,17 @@ class MysqlStorage {
         for (const paymentDetailsFilter of request.paymentDetailsFilter) {
           const paymentDetailsClauses = [];
 
+          // Base type check: ensure payment type matches the filter type.
+          // Token payments are identified by spark = NULL AND a token row
+          // joined in via t.tx_hash.
+          if (paymentDetailsFilter.type === "spark") {
+            paymentDetailsClauses.push("p.spark = 1");
+          } else if (paymentDetailsFilter.type === "token") {
+            paymentDetailsClauses.push("p.spark IS NULL AND t.tx_hash IS NOT NULL");
+          } else if (paymentDetailsFilter.type === "lightning") {
+            paymentDetailsClauses.push("l.htlc_status IS NOT NULL");
+          }
+
           const htlcAlias =
             paymentDetailsFilter.type === "spark"
               ? "s"
@@ -284,23 +310,40 @@ class MysqlStorage {
             params.push(...paymentDetailsFilter.htlcStatus);
           }
 
+          // Conversion filter — same enum shape as the Rust storage backend:
+          //   "ammRefundNeeded"   → AMM conversion that needs a clawback
+          //   "orchestraPending"  → Orchestra order not yet terminal
+          //   "boltzPending"      → Boltz reverse swap not yet terminal
+          //                         (lives on the Lightning hold-invoice leg)
           if (
             (paymentDetailsFilter.type === "spark" ||
-              paymentDetailsFilter.type === "token") &&
-            paymentDetailsFilter.conversionRefundNeeded !== undefined
+              paymentDetailsFilter.type === "token" ||
+              paymentDetailsFilter.type === "lightning") &&
+            paymentDetailsFilter.conversionFilter !== undefined
           ) {
-            const typeCheck =
-              paymentDetailsFilter.type === "spark"
-                ? "p.spark = 1"
-                : "p.spark IS NULL";
-            const refundNeeded =
-              paymentDetailsFilter.conversionRefundNeeded === true
-                ? "= 'refundNeeded'"
-                : "!= 'refundNeeded'";
-            paymentDetailsClauses.push(
-              `${typeCheck} AND pm.conversion_info IS NOT NULL AND
-               JSON_UNQUOTE(JSON_EXTRACT(pm.conversion_info, '$.status')) ${refundNeeded}`
-            );
+            let statusClause;
+            if (paymentDetailsFilter.conversionFilter === "ammRefundNeeded") {
+              statusClause =
+                "JSON_UNQUOTE(JSON_EXTRACT(pm.conversion_info, '$.type')) = 'amm' AND \
+                 JSON_UNQUOTE(JSON_EXTRACT(pm.conversion_info, '$.status')) = 'refundNeeded'";
+            } else if (
+              paymentDetailsFilter.conversionFilter === "orchestraPending"
+            ) {
+              statusClause =
+                "JSON_UNQUOTE(JSON_EXTRACT(pm.conversion_info, '$.type')) = 'orchestra' AND \
+                 JSON_UNQUOTE(JSON_EXTRACT(pm.conversion_info, '$.status')) NOT IN ('completed', 'failed', 'refunded')";
+            } else if (
+              paymentDetailsFilter.conversionFilter === "boltzPending"
+            ) {
+              statusClause =
+                "JSON_UNQUOTE(JSON_EXTRACT(pm.conversion_info, '$.type')) = 'boltz' AND \
+                 JSON_UNQUOTE(JSON_EXTRACT(pm.conversion_info, '$.status')) NOT IN ('completed', 'failed', 'refunded')";
+            }
+            if (statusClause) {
+              paymentDetailsClauses.push(
+                `pm.conversion_info IS NOT NULL AND ${statusClause}`
+              );
+            }
           }
 
           if (
@@ -877,6 +920,10 @@ class MysqlStorage {
           senderComment: row.lnurl_sender_comment || null,
         };
       }
+
+      if (row.conversion_info) {
+        details.conversionInfo = parseJson(row.conversion_info);
+      }
     } else if (row.withdraw_tx_id) {
       details = {
         type: "withdraw",
@@ -1030,6 +1077,74 @@ class MysqlStorage {
     }
   }
 
+  // ===== Cross-Chain Swap Operations =====
+
+  async setCrossChainSwap(swap) {
+    try {
+      await this.pool.query(
+        `INSERT INTO brz_cross_chain_swaps
+           (user_id, provider, id, is_terminal, updated_at, data, secrets)
+         VALUES (?, ?, ?, ?, ?, ?, ?)
+         ON DUPLICATE KEY UPDATE
+           is_terminal = VALUES(is_terminal),
+           updated_at = VALUES(updated_at),
+           data = VALUES(data),
+           secrets = VALUES(secrets)`,
+        [
+          this.identity,
+          swap.provider,
+          swap.id,
+          swap.isTerminal ? 1 : 0,
+          swap.updatedAt,
+          swap.data,
+          swap.secrets,
+        ]
+      );
+    } catch (error) {
+      throw new StorageError(
+        `Failed to set cross-chain swap: ${error.message}`,
+        error
+      );
+    }
+  }
+
+  async getCrossChainSwap(provider, id) {
+    try {
+      const [rows] = await this.pool.query(
+        `SELECT provider, id, is_terminal, updated_at, data, secrets
+         FROM brz_cross_chain_swaps
+         WHERE user_id = ? AND provider = ? AND id = ?`,
+        [this.identity, provider, id]
+      );
+      if (rows.length === 0) {
+        return null;
+      }
+      return crossChainSwapFromRow(rows[0]);
+    } catch (error) {
+      throw new StorageError(
+        `Failed to get cross-chain swap: ${error.message}`,
+        error
+      );
+    }
+  }
+
+  async listActiveCrossChainSwaps(provider) {
+    try {
+      const [rows] = await this.pool.query(
+        `SELECT provider, id, is_terminal, updated_at, data, secrets
+         FROM brz_cross_chain_swaps
+         WHERE user_id = ? AND provider = ? AND is_terminal = FALSE`,
+        [this.identity, provider]
+      );
+      return rows.map(crossChainSwapFromRow);
+    } catch (error) {
+      throw new StorageError(
+        `Failed to list active cross-chain swaps: ${error.message}`,
+        error
+      );
+    }
+  }
+
   // ===== Sync Operations =====
 
   async syncAddOutgoingChange(record) {

package/nodejs/mysql-storage/migrations.cjs

@@ -513,7 +513,7 @@ class MysqlMigrationManager {
         // the schema matches brz_payment_details_lightning / _token / _spark. We
         // can't safely backfill the new table from the dropped deposit_tx_id
         // column: we never stored the original SSP output_index, and vout=0 is a
-        // valid output index — defaulting would silently mislabel. Drop the
+        // valid output index, so defaulting would silently mislabel. Drop the
         // column and leave the brz_payments row in place. The read path sees an
         // unjoined deposit row as `details: None` until the resync re-fetches the
         // SSP user_request and the upsert inserts the new details row.
@@ -532,6 +532,36 @@ class MysqlMigrationManager {
            WHERE \`key\` = 'sync_offset' AND value IS NOT NULL`,
         ],
       },
+      {
+        // Backfill the conversion_info `type` discriminator for the
+        // ConversionInfo enum refactor. All existing rows are AMM.
+        // Mirrors the Rust mysql migration of the same name.
+        name: "Backfill conversion_info type discriminator",
+        sql: [
+          `UPDATE brz_payment_metadata SET conversion_info = JSON_SET(conversion_info, '$.type', 'amm') WHERE conversion_info IS NOT NULL AND JSON_EXTRACT(conversion_info, '$.type') IS NULL`,
+        ],
+      },
+      {
+        // Cross-chain swap rows, synced for cross-instance recovery. Shared
+        // across providers, discriminated by `provider`. Born multi-tenant
+        // (user_id in the PK). `data` is provider-opaque JSON; `secrets` is
+        // provider-opaque ciphertext (empty when the provider has none).
+        name: "Create brz_cross_chain_swaps table",
+        sql: [
+          `CREATE TABLE IF NOT EXISTS brz_cross_chain_swaps (
+              user_id VARBINARY(33) NOT NULL,
+              provider VARCHAR(64) NOT NULL,
+              id VARCHAR(255) NOT NULL,
+              is_terminal TINYINT(1) NOT NULL,
+              updated_at BIGINT NOT NULL,
+              data LONGTEXT NOT NULL,
+              secrets LONGTEXT NOT NULL,
+              PRIMARY KEY (user_id, provider, id),
+              INDEX brz_idx_cross_chain_swaps_user_provider_is_terminal
+                  (user_id, provider, is_terminal)
+          )`,
+        ],
+      },
     ];
   }
 }

package/nodejs/postgres-storage/index.cjs

@@ -239,6 +239,15 @@ class PostgresStorage {
         for (const paymentDetailsFilter of request.paymentDetailsFilter) {
           const paymentDetailsClauses = [];
 
+          // Base type check: ensure payment type matches the filter type
+          if (paymentDetailsFilter.type === "spark") {
+            paymentDetailsClauses.push("p.spark = true");
+          } else if (paymentDetailsFilter.type === "token") {
+            paymentDetailsClauses.push("p.spark IS NULL AND t.tx_hash IS NOT NULL");
+          } else if (paymentDetailsFilter.type === "lightning") {
+            paymentDetailsClauses.push("l.htlc_status IS NOT NULL");
+          }
+
           // Filter by HTLC status (Spark or Lightning)
           const htlcAlias =
             paymentDetailsFilter.type === "spark"
@@ -266,24 +275,35 @@ class PostgresStorage {
             params.push(...paymentDetailsFilter.htlcStatus);
           }
 
-          // Filter by conversion refund needed
+          // Filter by conversion type + status
           if (
             (paymentDetailsFilter.type === "spark" ||
-              paymentDetailsFilter.type === "token") &&
-            paymentDetailsFilter.conversionRefundNeeded !== undefined
+              paymentDetailsFilter.type === "token" ||
+              paymentDetailsFilter.type === "lightning") &&
+            paymentDetailsFilter.conversionFilter !== undefined
           ) {
+            // Lightning carries the Boltz conversion; its `conversion_info.type`
+            // is the authoritative discriminator, so no payment-type column check.
             const typeCheck =
               paymentDetailsFilter.type === "spark"
                 ? "p.spark = true"
-                : "p.spark IS NULL";
-            const refundNeeded =
-              paymentDetailsFilter.conversionRefundNeeded === true
-                ? "= 'refundNeeded'"
-                : "!= 'refundNeeded'";
-            paymentDetailsClauses.push(
-              `${typeCheck} AND pm.conversion_info IS NOT NULL AND
-               pm.conversion_info::jsonb->>'status' ${refundNeeded}`
-            );
+                : paymentDetailsFilter.type === "token"
+                  ? "p.spark IS NULL"
+                  : null;
+            let statusClause;
+            if (paymentDetailsFilter.conversionFilter === "ammRefundNeeded") {
+              statusClause = "pm.conversion_info::jsonb->>'type' = 'amm' AND pm.conversion_info::jsonb->>'status' = 'refundNeeded'";
+            } else if (paymentDetailsFilter.conversionFilter === "orchestraPending") {
+              statusClause = "pm.conversion_info::jsonb->>'type' = 'orchestra' AND pm.conversion_info::jsonb->>'status' NOT IN ('completed', 'failed', 'refunded')";
+            } else if (paymentDetailsFilter.conversionFilter === "boltzPending") {
+              statusClause = "pm.conversion_info::jsonb->>'type' = 'boltz' AND pm.conversion_info::jsonb->>'status' NOT IN ('completed', 'failed', 'refunded')";
+            }
+            if (statusClause) {
+              const prefix = typeCheck ? `${typeCheck} AND ` : "";
+              paymentDetailsClauses.push(
+                `${prefix}pm.conversion_info IS NOT NULL AND ${statusClause}`
+              );
+            }
           }
 
           // Filter by token transaction hash
@@ -835,6 +855,13 @@ class PostgresStorage {
           senderComment: row.lnurl_sender_comment || null,
         };
       }
+
+      if (row.conversion_info) {
+        details.conversionInfo =
+          typeof row.conversion_info === "string"
+            ? JSON.parse(row.conversion_info)
+            : row.conversion_info;
+      }
     } else if (row.withdraw_tx_id) {
       details = {
         type: "withdraw",
@@ -1017,6 +1044,74 @@ class PostgresStorage {
     }
   }
 
+  // ===== Cross-Chain Swap Operations =====
+
+  async setCrossChainSwap(swap) {
+    try {
+      await this.pool.query(
+        `INSERT INTO brz_cross_chain_swaps
+           (user_id, provider, id, is_terminal, updated_at, data, secrets)
+         VALUES ($1, $2, $3, $4, $5, $6, $7)
+         ON CONFLICT(user_id, provider, id) DO UPDATE SET
+           is_terminal = EXCLUDED.is_terminal,
+           updated_at = EXCLUDED.updated_at,
+           data = EXCLUDED.data,
+           secrets = EXCLUDED.secrets`,
+        [
+          this.identity,
+          swap.provider,
+          swap.id,
+          swap.isTerminal,
+          swap.updatedAt,
+          swap.data,
+          swap.secrets,
+        ]
+      );
+    } catch (error) {
+      throw new StorageError(
+        `Failed to set cross-chain swap: ${error.message}`,
+        error
+      );
+    }
+  }
+
+  async getCrossChainSwap(provider, id) {
+    try {
+      const result = await this.pool.query(
+        `SELECT provider, id, is_terminal, updated_at, data, secrets
+         FROM brz_cross_chain_swaps
+         WHERE user_id = $1 AND provider = $2 AND id = $3`,
+        [this.identity, provider, id]
+      );
+      if (result.rows.length === 0) {
+        return null;
+      }
+      return crossChainSwapFromRow(result.rows[0]);
+    } catch (error) {
+      throw new StorageError(
+        `Failed to get cross-chain swap: ${error.message}`,
+        error
+      );
+    }
+  }
+
+  async listActiveCrossChainSwaps(provider) {
+    try {
+      const result = await this.pool.query(
+        `SELECT provider, id, is_terminal, updated_at, data, secrets
+         FROM brz_cross_chain_swaps
+         WHERE user_id = $1 AND provider = $2 AND is_terminal = FALSE`,
+        [this.identity, provider]
+      );
+      return result.rows.map(crossChainSwapFromRow);
+    } catch (error) {
+      throw new StorageError(
+        `Failed to list active cross-chain swaps: ${error.message}`,
+        error
+      );
+    }
+  }
+
   // ===== Sync Operations =====
 
   async syncAddOutgoingChange(record) {
@@ -1443,6 +1538,21 @@ class PostgresStorage {
   }
 }
 
+/**
+ * Maps a brz_cross_chain_swaps row to the camelCase StoredCrossChainSwap shape
+ * the SDK expects.
+ */
+function crossChainSwapFromRow(row) {
+  return {
+    provider: row.provider,
+    id: row.id,
+    isTerminal: row.is_terminal,
+    updatedAt: Number(row.updated_at),
+    data: row.data,
+    secrets: row.secrets,
+  };
+}
+
 /**
  * Creates a PostgresStorageConfig with the given connection string and default pool settings.
  *

package/nodejs/postgres-storage/migrations.cjs

@@ -472,7 +472,7 @@ class PostgresMigrationManager {
         // the schema matches brz_payment_details_lightning / _token / _spark. We
         // can't safely backfill the new table from the dropped deposit_tx_id
         // column: we never stored the original SSP output_index, and vout=0 is a
-        // valid output index — defaulting would silently mislabel. Drop the
+        // valid output index, so defaulting would silently mislabel. Drop the
         // column and leave the brz_payments row in place. The read path sees an
         // unjoined deposit row as `details: None` until the resync re-fetches the
         // SSP user_request and the upsert inserts the new details row.
@@ -491,6 +491,33 @@ class PostgresMigrationManager {
            WHERE key = 'sync_offset' AND value IS NOT NULL`,
         ],
       },
+      {
+        name: "Backfill conversion_info type discriminator",
+        sql: [
+          `UPDATE brz_payment_metadata SET conversion_info = conversion_info::jsonb || '{"type": "amm"}'::jsonb WHERE conversion_info IS NOT NULL AND conversion_info::jsonb->>'type' IS NULL`,
+        ],
+      },
+      {
+        // Cross-chain swap rows, synced for cross-instance recovery. Shared
+        // across providers, discriminated by `provider`. Born multi-tenant
+        // (user_id in the PK). `data` is provider-opaque JSON; `secrets` is
+        // provider-opaque ciphertext (empty when the provider has none).
+        name: "Create brz_cross_chain_swaps table",
+        sql: [
+          `CREATE TABLE IF NOT EXISTS brz_cross_chain_swaps (
+              user_id BYTEA NOT NULL,
+              provider TEXT NOT NULL,
+              id TEXT NOT NULL,
+              is_terminal BOOLEAN NOT NULL,
+              updated_at BIGINT NOT NULL,
+              data TEXT NOT NULL,
+              secrets TEXT NOT NULL,
+              PRIMARY KEY (user_id, provider, id)
+          )`,
+          `CREATE INDEX brz_idx_cross_chain_swaps_user_provider_is_terminal
+             ON brz_cross_chain_swaps(user_id, provider, is_terminal)`,
+        ],
+      },
     ];
   }
 }

package/nodejs/storage/index.cjs

@@ -206,6 +206,14 @@ class SqliteStorage {
         const allPaymentDetailsClauses = [];
         for (const paymentDetailsFilter of request.paymentDetailsFilter) {
           const paymentDetailsClauses = [];
+          // Base type check: ensure payment type matches the filter type
+          if (paymentDetailsFilter.type === "spark") {
+            paymentDetailsClauses.push("p.spark = 1");
+          } else if (paymentDetailsFilter.type === "token") {
+            paymentDetailsClauses.push("p.spark IS NULL AND t.tx_hash IS NOT NULL");
+          } else if (paymentDetailsFilter.type === "lightning") {
+            paymentDetailsClauses.push("l.htlc_status IS NOT NULL");
+          }
           // Filter by HTLC status (Spark or Lightning)
           const htlcAlias =
             paymentDetailsFilter.type === "spark" ? "s"
@@ -232,20 +240,35 @@ class SqliteStorage {
             }
             params.push(...paymentDetailsFilter.htlcStatus);
           }
-          // Filter by token conversion info presence
+          // Filter by conversion type + status
           if (
-            (paymentDetailsFilter.type === "spark" || paymentDetailsFilter.type === "token") &&
-              paymentDetailsFilter.conversionRefundNeeded !== undefined
+            (paymentDetailsFilter.type === "spark" ||
+              paymentDetailsFilter.type === "token" ||
+              paymentDetailsFilter.type === "lightning") &&
+              paymentDetailsFilter.conversionFilter !== undefined
           ) {
-            const typeCheck = paymentDetailsFilter.type === "spark" ? "p.spark = 1" : "p.spark IS NULL";
-            const refundNeeded =
-              paymentDetailsFilter.conversionRefundNeeded === true
-                ? "= 'refundNeeded'"
-                : "!= 'refundNeeded'";
-            paymentDetailsClauses.push(
-              `${typeCheck} AND pm.conversion_info IS NOT NULL AND
-              json_extract(pm.conversion_info, '$.status') ${refundNeeded}`
-            );
+            // Lightning carries the Boltz conversion; its `conversion_info.type`
+            // is the authoritative discriminator, so no payment-type column check.
+            const typeCheck =
+              paymentDetailsFilter.type === "spark"
+                ? "p.spark = 1"
+                : paymentDetailsFilter.type === "token"
+                  ? "p.spark IS NULL"
+                  : null;
+            let statusClause;
+            if (paymentDetailsFilter.conversionFilter === "ammRefundNeeded") {
+              statusClause = "json_extract(pm.conversion_info, '$.type') = 'amm' AND json_extract(pm.conversion_info, '$.status') = 'refundNeeded'";
+            } else if (paymentDetailsFilter.conversionFilter === "orchestraPending") {
+              statusClause = "json_extract(pm.conversion_info, '$.type') = 'orchestra' AND json_extract(pm.conversion_info, '$.status') NOT IN ('completed', 'failed', 'refunded')";
+            } else if (paymentDetailsFilter.conversionFilter === "boltzPending") {
+              statusClause = "json_extract(pm.conversion_info, '$.type') = 'boltz' AND json_extract(pm.conversion_info, '$.status') NOT IN ('completed', 'failed', 'refunded')";
+            }
+            if (statusClause) {
+              const prefix = typeCheck ? `${typeCheck} AND ` : "";
+              paymentDetailsClauses.push(
+                `${prefix}pm.conversion_info IS NOT NULL AND ${statusClause}`
+              );
+            }
           }
           // Filter by token transaction hash
           if (
@@ -813,6 +836,17 @@ class SqliteStorage {
           senderComment: row.lnurl_sender_comment || null,
         };
       }
+
+      if (row.conversion_info) {
+        try {
+          details.conversionInfo = JSON.parse(row.conversion_info);
+        } catch (e) {
+          throw new StorageError(
+            `Failed to parse conversion_info JSON for payment ${row.id}: ${e.message}`,
+            e
+          );
+        }
+      }
     } else if (row.withdraw_tx_id) {
       details = {
         type: "withdraw",
@@ -1378,6 +1412,78 @@ class SqliteStorage {
       );
     }
   }
+
+  // ===== Cross-Chain Swap Operations =====
+
+  setCrossChainSwap(swap) {
+    try {
+      const stmt = this.db.prepare(`
+        INSERT INTO cross_chain_swaps (provider, id, is_terminal, updated_at, data, secrets)
+        VALUES (?, ?, ?, ?, ?, ?)
+        ON CONFLICT(provider, id) DO UPDATE SET
+          is_terminal = excluded.is_terminal,
+          updated_at = excluded.updated_at,
+          data = excluded.data,
+          secrets = excluded.secrets
+      `);
+      stmt.run(
+        swap.provider,
+        swap.id,
+        swap.isTerminal ? 1 : 0,
+        swap.updatedAt,
+        swap.data,
+        swap.secrets
+      );
+      return Promise.resolve();
+    } catch (error) {
+      return Promise.reject(
+        new StorageError(`Failed to set cross-chain swap: ${error.message}`, error)
+      );
+    }
+  }
+
+  getCrossChainSwap(provider, id) {
+    try {
+      const stmt = this.db.prepare(
+        `SELECT provider, id, is_terminal, updated_at, data, secrets
+         FROM cross_chain_swaps WHERE provider = ? AND id = ?`
+      );
+      const row = stmt.get(provider, id);
+      return Promise.resolve(row ? crossChainSwapFromRow(row) : null);
+    } catch (error) {
+      return Promise.reject(
+        new StorageError(`Failed to get cross-chain swap: ${error.message}`, error)
+      );
+    }
+  }
+
+  listActiveCrossChainSwaps(provider) {
+    try {
+      const stmt = this.db.prepare(
+        `SELECT provider, id, is_terminal, updated_at, data, secrets
+         FROM cross_chain_swaps WHERE provider = ? AND is_terminal = 0`
+      );
+      const rows = stmt.all(provider);
+      return Promise.resolve(rows.map(crossChainSwapFromRow));
+    } catch (error) {
+      return Promise.reject(
+        new StorageError(`Failed to list active cross-chain swaps: ${error.message}`, error)
+      );
+    }
+  }
+}
+
+/// Maps a `cross_chain_swaps` row to a StoredCrossChainSwap, parsing `data` and
+/// the is_terminal flag back into the camelCase shape the SDK expects.
+function crossChainSwapFromRow(row) {
+  return {
+    provider: row.provider,
+    id: row.id,
+    isTerminal: row.is_terminal !== 0,
+    updatedAt: Number(row.updated_at),
+    data: row.data,
+    secrets: row.secrets,
+  };
 }
 
 async function createDefaultStorage(dataDir, logger = null) {

package/nodejs/storage/migrations.cjs

@@ -438,7 +438,7 @@ class MigrationManager {
         // the schema matches payment_details_lightning / _token / _spark. We can't
         // safely backfill the new table from the dropped deposit_tx_id column: we
         // never stored the original SSP output_index, and vout=0 is a valid output
-        // index — defaulting would silently mislabel. Drop the column and leave
+        // index, so defaulting would silently mislabel. Drop the column and leave
         // the payments row in place. The read path sees an unjoined deposit row
         // as `details: None` until the resync re-fetches the SSP user_request and
         // the upsert inserts the new details row.
@@ -456,6 +456,30 @@ class MigrationManager {
            WHERE key = 'sync_offset' AND json_valid(value)`,
         ],
       },
+      {
+        name: "Backfill conversion_info type discriminator",
+        sql: `UPDATE payment_metadata SET conversion_info = json_set(conversion_info, '$.type', 'amm') WHERE conversion_info IS NOT NULL AND json_extract(conversion_info, '$.type') IS NULL`,
+      },
+      {
+        // Cross-chain swap rows, synced for cross-instance recovery. Shared
+        // across providers, discriminated by `provider`. `data` is
+        // provider-opaque JSON; `secrets` is provider-opaque ciphertext (empty
+        // when the provider has none).
+        name: "Create cross_chain_swaps table",
+        sql: [
+          `CREATE TABLE cross_chain_swaps (
+              provider TEXT NOT NULL,
+              id TEXT NOT NULL,
+              is_terminal INTEGER NOT NULL,
+              updated_at INTEGER NOT NULL,
+              data TEXT NOT NULL,
+              secrets TEXT NOT NULL,
+              PRIMARY KEY (provider, id)
+          )`,
+          `CREATE INDEX idx_cross_chain_swaps_provider_is_terminal
+            ON cross_chain_swaps(provider, is_terminal)`,
+        ],
+      },
     ];
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@breeztech/breez-sdk-spark",
-    "version": "0.16.1-dev1",
+    "version": "0.17.1",
     "description": "Breez Spark SDK",
     "repository": "https://github.com/breez/spark-sdk",
     "author": "Breez <contact@breez.technology> (https://github.com/breez)",

package/ssr/index.js

@@ -98,6 +98,11 @@ export function postgresStorage(...args) {
   return _module.postgresStorage(...args);
 }
 
+export function start(...args) {
+  if (!_module) _notInitialized('start');
+  return _module.start(...args);
+}
+
 export function task_worker_entry_point(...args) {
   if (!_module) _notInitialized('task_worker_entry_point');
   return _module.task_worker_entry_point(...args);