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

package/nodejs/storage/index.cjs

@@ -41,7 +41,8 @@ const SELECT_PAYMENT_SQL = `
            p.timestamp,
            p.method,
            p.withdraw_tx_id,
-           p.deposit_tx_id,
+           pd.tx_id AS deposit_tx_id,
+           pd.vout AS deposit_vout,
            p.spark,
            l.invoice AS lightning_invoice,
            l.payment_hash AS lightning_payment_hash,
@@ -69,6 +70,7 @@ const SELECT_PAYMENT_SQL = `
       LEFT JOIN payment_details_lightning l ON p.id = l.payment_id
       LEFT JOIN payment_details_token t ON p.id = t.payment_id
       LEFT JOIN payment_details_spark s ON p.id = s.payment_id
+      LEFT JOIN payment_details_deposit pd ON p.id = pd.payment_id
       LEFT JOIN payment_metadata pm ON p.id = pm.payment_id
       LEFT JOIN lnurl_receive_metadata lrm ON l.payment_hash = lrm.payment_hash`;
 
@@ -313,129 +315,180 @@ class SqliteStorage {
     }
   }
 
-  insertPayment(payment) {
-    try {
-      if (!payment) {
-        return Promise.reject(
-          new StorageError("Payment cannot be null or undefined")
-        );
-      }
+  async applyPaymentUpdate(payment) {
+    if (!payment) {
+      throw new StorageError("Payment cannot be null or undefined");
+    }
 
-      const paymentInsert = this.db.prepare(
-        `INSERT INTO payments (id, payment_type, status, amount, fees, timestamp, method, withdraw_tx_id, deposit_tx_id, spark) 
-         VALUES (@id, @paymentType, @status, @amount, @fees, @timestamp, @method, @withdrawTxId, @depositTxId, @spark)
-         ON CONFLICT(id) DO UPDATE SET
-           payment_type=excluded.payment_type,
-           status=excluded.status,
-           amount=excluded.amount,
-           fees=excluded.fees,
-           timestamp=excluded.timestamp,
-           method=excluded.method,
-           withdraw_tx_id=excluded.withdraw_tx_id,
-           deposit_tx_id=excluded.deposit_tx_id,
-           spark=excluded.spark`
-      );
-      const lightningInsert = this.db.prepare(
-        `INSERT INTO payment_details_lightning
-          (payment_id, invoice, payment_hash, destination_pubkey, description, preimage, htlc_status, htlc_expiry_time)
-          VALUES (@id, @invoice, @paymentHash, @destinationPubkey, @description, @preimage, @htlcStatus, @htlcExpiryTime)
-          ON CONFLICT(payment_id) DO UPDATE SET
-            invoice=excluded.invoice,
-            payment_hash=excluded.payment_hash,
-            destination_pubkey=excluded.destination_pubkey,
-            description=excluded.description,
-            preimage=COALESCE(excluded.preimage, payment_details_lightning.preimage),
-            htlc_status=COALESCE(excluded.htlc_status, payment_details_lightning.htlc_status),
-            htlc_expiry_time=COALESCE(excluded.htlc_expiry_time, payment_details_lightning.htlc_expiry_time)`
-      );
-      const tokenInsert = this.db.prepare(
-        `INSERT INTO payment_details_token 
-          (payment_id, metadata, tx_hash, tx_type, invoice_details) 
-          VALUES (@id, @metadata, @txHash, @txType, @invoiceDetails)
-          ON CONFLICT(payment_id) DO UPDATE SET
-            metadata=excluded.metadata,
-            tx_hash=excluded.tx_hash,
-            tx_type=excluded.tx_type,
-            invoice_details=COALESCE(excluded.invoice_details, payment_details_token.invoice_details)`
-      );
-      const sparkInsert = this.db.prepare(
-        `INSERT INTO payment_details_spark 
-          (payment_id, invoice_details, htlc_details) 
-          VALUES (@id, @invoiceDetails, @htlcDetails)
-          ON CONFLICT(payment_id) DO UPDATE SET
-            invoice_details=COALESCE(excluded.invoice_details, payment_details_spark.invoice_details),
-            htlc_details=COALESCE(excluded.htlc_details, payment_details_spark.htlc_details)`
+    try {
+      const selectStatus = this.db.prepare(
+        "SELECT status FROM payments WHERE id = ?"
       );
+      let shouldEmit = false;
       const transaction = this.db.transaction(() => {
-        paymentInsert.run({
-          id: payment.id,
-          paymentType: payment.paymentType,
-          status: payment.status,
-          amount: payment.amount.toString(),
-          fees: payment.fees.toString(),
-          timestamp: payment.timestamp,
-          method: payment.method ? JSON.stringify(payment.method) : null,
-          withdrawTxId:
-            payment.details?.type === "withdraw" ? payment.details.txId : null,
-          depositTxId:
-            payment.details?.type === "deposit" ? payment.details.txId : null,
-          spark: payment.details?.type === "spark" ? 1 : null,
-        });
-
-        if (
-          payment.details?.type === "spark" &&
-          (payment.details.invoiceDetails != null ||
-            payment.details.htlcDetails != null)
-        ) {
-          sparkInsert.run({
-            id: payment.id,
-            invoiceDetails: payment.details.invoiceDetails
-              ? JSON.stringify(payment.details.invoiceDetails)
-              : null,
-            htlcDetails: payment.details.htlcDetails
-              ? JSON.stringify(payment.details.htlcDetails)
-              : null,
-          });
-        }
-
-        if (payment.details?.type === "lightning") {
-          lightningInsert.run({
-            id: payment.id,
-            invoice: payment.details.invoice,
-            paymentHash: payment.details.htlcDetails.paymentHash,
-            destinationPubkey: payment.details.destinationPubkey,
-            description: payment.details.description,
-            preimage: payment.details.htlcDetails?.preimage,
-            htlcStatus: payment.details.htlcDetails?.status ?? null,
-            htlcExpiryTime: payment.details.htlcDetails?.expiryTime ?? 0,
-          });
-        }
-
-        if (payment.details?.type === "token") {
-          tokenInsert.run({
-            id: payment.id,
-            metadata: JSON.stringify(payment.details.metadata),
-            txHash: payment.details.txHash,
-            txType: payment.details.txType,
-            invoiceDetails: payment.details.invoiceDetails
-              ? JSON.stringify(payment.details.invoiceDetails)
-              : null,
-          });
+        const row = selectStatus.get(payment.id);
+        const stored = row
+          ? this._normalizePaymentStatus(row.status)
+          : null;
+        const next = this._normalizePaymentStatus(payment.status);
+
+        if (stored == null) {
+          this._runPaymentUpsert(payment);
+          shouldEmit = true;
+        } else if (stored === next) {
+          console.debug(
+            `Skipping redundant payment event: id=${payment.id} status=${next}`
+          );
+          this._runPaymentUpsert(payment);
+          shouldEmit = false;
+        } else if (this._isFinalPaymentStatus(stored)) {
+          console.warn(
+            `Skipping payment update (would replace terminal status): id=${payment.id} stored=${stored} new=${next}`
+          );
+          shouldEmit = false;
+        } else {
+          this._runPaymentUpsert(payment);
+          shouldEmit = true;
         }
       });
 
-      transaction();
-      return Promise.resolve();
+      transaction.immediate();
+      return shouldEmit;
     } catch (error) {
-      return Promise.reject(
-        new StorageError(
-          `Failed to insert payment '${payment.id}': ${error.message}`,
-          error
-        )
+      throw new StorageError(
+        `Failed to apply payment update '${payment.id}': ${error.message}`,
+        error
       );
     }
   }
 
+  _runPaymentUpsert(payment) {
+    const paymentInsert = this.db.prepare(
+      `INSERT INTO payments (id, payment_type, status, amount, fees, timestamp, method, withdraw_tx_id, spark)
+       VALUES (@id, @paymentType, @status, @amount, @fees, @timestamp, @method, @withdrawTxId, @spark)
+       ON CONFLICT(id) DO UPDATE SET
+         payment_type=excluded.payment_type,
+         status=excluded.status,
+         amount=excluded.amount,
+         fees=excluded.fees,
+         timestamp=excluded.timestamp,
+         method=excluded.method,
+         withdraw_tx_id=excluded.withdraw_tx_id,
+         spark=excluded.spark`
+    );
+    const depositInsert = this.db.prepare(
+      `INSERT INTO payment_details_deposit
+        (payment_id, tx_id, vout)
+        VALUES (@id, @txId, @vout)
+        ON CONFLICT(payment_id) DO UPDATE SET
+          tx_id=excluded.tx_id,
+          vout=excluded.vout`
+    );
+    const lightningInsert = this.db.prepare(
+      `INSERT INTO payment_details_lightning
+        (payment_id, invoice, payment_hash, destination_pubkey, description, preimage, htlc_status, htlc_expiry_time)
+        VALUES (@id, @invoice, @paymentHash, @destinationPubkey, @description, @preimage, @htlcStatus, @htlcExpiryTime)
+        ON CONFLICT(payment_id) DO UPDATE SET
+          invoice=excluded.invoice,
+          payment_hash=excluded.payment_hash,
+          destination_pubkey=excluded.destination_pubkey,
+          description=excluded.description,
+          preimage=COALESCE(excluded.preimage, payment_details_lightning.preimage),
+          htlc_status=COALESCE(excluded.htlc_status, payment_details_lightning.htlc_status),
+          htlc_expiry_time=COALESCE(excluded.htlc_expiry_time, payment_details_lightning.htlc_expiry_time)`
+    );
+    const tokenInsert = this.db.prepare(
+      `INSERT INTO payment_details_token
+        (payment_id, metadata, tx_hash, tx_type, invoice_details)
+        VALUES (@id, @metadata, @txHash, @txType, @invoiceDetails)
+        ON CONFLICT(payment_id) DO UPDATE SET
+          metadata=excluded.metadata,
+          tx_hash=excluded.tx_hash,
+          tx_type=excluded.tx_type,
+          invoice_details=COALESCE(excluded.invoice_details, payment_details_token.invoice_details)`
+    );
+    const sparkInsert = this.db.prepare(
+      `INSERT INTO payment_details_spark
+        (payment_id, invoice_details, htlc_details)
+        VALUES (@id, @invoiceDetails, @htlcDetails)
+        ON CONFLICT(payment_id) DO UPDATE SET
+          invoice_details=COALESCE(excluded.invoice_details, payment_details_spark.invoice_details),
+          htlc_details=COALESCE(excluded.htlc_details, payment_details_spark.htlc_details)`
+    );
+
+    paymentInsert.run({
+      id: payment.id,
+      paymentType: payment.paymentType,
+      status: payment.status,
+      amount: payment.amount.toString(),
+      fees: payment.fees.toString(),
+      timestamp: payment.timestamp,
+      method: payment.method ? JSON.stringify(payment.method) : null,
+      withdrawTxId:
+        payment.details?.type === "withdraw" ? payment.details.txId : null,
+      spark: payment.details?.type === "spark" ? 1 : null,
+    });
+
+    if (payment.details?.type === "deposit") {
+      depositInsert.run({
+        id: payment.id,
+        txId: payment.details.txId,
+        vout: payment.details.vout,
+      });
+    }
+
+    if (
+      payment.details?.type === "spark" &&
+      (payment.details.invoiceDetails != null ||
+        payment.details.htlcDetails != null)
+    ) {
+      sparkInsert.run({
+        id: payment.id,
+        invoiceDetails: payment.details.invoiceDetails
+          ? JSON.stringify(payment.details.invoiceDetails)
+          : null,
+        htlcDetails: payment.details.htlcDetails
+          ? JSON.stringify(payment.details.htlcDetails)
+          : null,
+      });
+    }
+
+    if (payment.details?.type === "lightning") {
+      lightningInsert.run({
+        id: payment.id,
+        invoice: payment.details.invoice,
+        paymentHash: payment.details.htlcDetails.paymentHash,
+        destinationPubkey: payment.details.destinationPubkey,
+        description: payment.details.description,
+        preimage: payment.details.htlcDetails?.preimage,
+        htlcStatus: payment.details.htlcDetails?.status ?? null,
+        htlcExpiryTime: payment.details.htlcDetails?.expiryTime ?? 0,
+      });
+    }
+
+    if (payment.details?.type === "token") {
+      tokenInsert.run({
+        id: payment.id,
+        metadata: JSON.stringify(payment.details.metadata),
+        txHash: payment.details.txHash,
+        txType: payment.details.txType,
+        invoiceDetails: payment.details.invoiceDetails
+          ? JSON.stringify(payment.details.invoiceDetails)
+          : null,
+      });
+    }
+  }
+
+  _normalizePaymentStatus(status) {
+    return typeof status === "string" ? status.toLowerCase() : status;
+  }
+
+  _isFinalPaymentStatus(status) {
+    const normalized = this._normalizePaymentStatus(status);
+    return normalized === "completed" || normalized === "failed";
+  }
+
+
   getPaymentById(id) {
     try {
       if (!id) {
@@ -769,6 +822,7 @@ class SqliteStorage {
       details = {
         type: "deposit",
         txId: row.deposit_tx_id,
+        vout: row.deposit_vout,
       };
     } else if (row.spark) {
       details = {

package/nodejs/storage/migrations.cjs

@@ -433,6 +433,29 @@ class MigrationManager {
           `CREATE INDEX idx_payment_metadata_payment_id ON payment_metadata(payment_id)`,
         ],
       },
+      {
+        // Move deposit details into their own table so vout can be NOT NULL and
+        // 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
+        // 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.
+        name: "Move deposit details into payment_details_deposit table",
+        sql: [
+          `CREATE TABLE payment_details_deposit (
+              payment_id TEXT PRIMARY KEY,
+              tx_id TEXT NOT NULL,
+              vout INTEGER NOT NULL,
+              FOREIGN KEY (payment_id) REFERENCES payments(id) ON DELETE CASCADE
+          )`,
+          `ALTER TABLE payments DROP COLUMN deposit_tx_id`,
+          `UPDATE settings
+           SET value = json_set(value, '$.offset', 0)
+           WHERE key = 'sync_offset' AND json_valid(value)`,
+        ],
+      },
     ];
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@breeztech/breez-sdk-spark",
-    "version": "0.15.1",
+    "version": "0.16.1-dev1",
     "description": "Breez Spark SDK",
     "repository": "https://github.com/breez/spark-sdk",
     "author": "Breez <contact@breez.technology> (https://github.com/breez)",
@@ -23,6 +23,11 @@
         "./nodejs": "./nodejs/index.js",
         "./web": "./web/index.js",
         "./ssr": "./ssr/index.js",
+        "./passkey-prf-provider": {
+            "types": "./web/passkey-prf-provider/index.d.ts",
+            "import": "./web/passkey-prf-provider/index.js",
+            "default": "./web/passkey-prf-provider/index.js"
+        },
         ".": {
             "node": {
                 "import": "./nodejs/index.mjs",

package/ssr/index.js

@@ -1,5 +1,5 @@
 // SSR-safe entry point for Breez SDK
-// Safe to import during server-side rendering — no WASM, no browser APIs, no Node.js APIs.
+// Safe to import during server-side rendering: no WASM, no browser APIs, no Node.js APIs.
 // Call init() on the client before using any SDK functions.
 
 let _module = null;
@@ -33,14 +33,9 @@ export function connectWithSigner(...args) {
   return _module.connectWithSigner(...args);
 }
 
-export function createMysqlConnectionPool(...args) {
-  if (!_module) _notInitialized('createMysqlConnectionPool');
-  return _module.createMysqlConnectionPool(...args);
-}
-
-export function createPostgresConnectionPool(...args) {
-  if (!_module) _notInitialized('createPostgresConnectionPool');
-  return _module.createPostgresConnectionPool(...args);
+export function createTurnkeySigner(...args) {
+  if (!_module) _notInitialized('createTurnkeySigner');
+  return _module.createTurnkeySigner(...args);
 }
 
 export function defaultConfig(...args) {
@@ -48,9 +43,9 @@ export function defaultConfig(...args) {
   return _module.defaultConfig(...args);
 }
 
-export function defaultExternalSigner(...args) {
-  if (!_module) _notInitialized('defaultExternalSigner');
-  return _module.defaultExternalSigner(...args);
+export function defaultExternalSigners(...args) {
+  if (!_module) _notInitialized('defaultExternalSigners');
+  return _module.defaultExternalSigners(...args);
 }
 
 export function defaultMysqlStorageConfig(...args) {
@@ -68,6 +63,11 @@ export function defaultServerConfig(...args) {
   return _module.defaultServerConfig(...args);
 }
 
+export function defaultStorage(...args) {
+  if (!_module) _notInitialized('defaultStorage');
+  return _module.defaultStorage(...args);
+}
+
 export function getSparkStatus(...args) {
   if (!_module) _notInitialized('getSparkStatus');
   return _module.getSparkStatus(...args);
@@ -78,6 +78,11 @@ export function initLogging(...args) {
   return _module.initLogging(...args);
 }
 
+export function mysqlStorage(...args) {
+  if (!_module) _notInitialized('mysqlStorage');
+  return _module.mysqlStorage(...args);
+}
+
 export function newRestChainService(...args) {
   if (!_module) _notInitialized('newRestChainService');
   return _module.newRestChainService(...args);
@@ -88,6 +93,11 @@ export function newSharedSdkContext(...args) {
   return _module.newSharedSdkContext(...args);
 }
 
+export function postgresStorage(...args) {
+  if (!_module) _notInitialized('postgresStorage');
+  return _module.postgresStorage(...args);
+}
+
 export function task_worker_entry_point(...args) {
   if (!_module) _notInitialized('task_worker_entry_point');
   return _module.task_worker_entry_point(...args);
@@ -112,10 +122,24 @@ export class BreezSdk {
   }
 }
 
-export class DefaultSigner {
+export class ExternalBreezSignerHandle {
+  constructor(...args) {
+    if (!_module) _notInitialized('new ExternalBreezSignerHandle');
+    return new _module.ExternalBreezSignerHandle(...args);
+  }
+}
+
+export class ExternalSigners {
   constructor(...args) {
-    if (!_module) _notInitialized('new DefaultSigner');
-    return new _module.DefaultSigner(...args);
+    if (!_module) _notInitialized('new ExternalSigners');
+    return new _module.ExternalSigners(...args);
+  }
+}
+
+export class ExternalSparkSignerHandle {
+  constructor(...args) {
+    if (!_module) _notInitialized('new ExternalSparkSignerHandle');
+    return new _module.ExternalSparkSignerHandle(...args);
   }
 }
 
@@ -140,24 +164,17 @@ export class IntoUnderlyingSource {
   }
 }
 
-export class MysqlConnectionPool {
-  constructor(...args) {
-    if (!_module) _notInitialized('new MysqlConnectionPool');
-    return new _module.MysqlConnectionPool(...args);
-  }
-}
-
-export class Passkey {
+export class PasskeyClient {
   constructor(...args) {
-    if (!_module) _notInitialized('new Passkey');
-    return new _module.Passkey(...args);
+    if (!_module) _notInitialized('new PasskeyClient');
+    return new _module.PasskeyClient(...args);
   }
 }
 
-export class PostgresConnectionPool {
+export class PasskeyLabels {
   constructor(...args) {
-    if (!_module) _notInitialized('new PostgresConnectionPool');
-    return new _module.PostgresConnectionPool(...args);
+    if (!_module) _notInitialized('new PasskeyLabels');
+    return new _module.PasskeyLabels(...args);
   }
 }
 
@@ -182,3 +199,10 @@ export class WasmSdkContext {
   }
 }
 
+export class WasmStorageConfig {
+  constructor(...args) {
+    if (!_module) _notInitialized('new WasmStorageConfig');
+    return new _module.WasmStorageConfig(...args);
+  }
+}
+