@routstr/sdk 0.3.6 → 0.3.8

package/dist/wallet/index.mjs

@@ -25,6 +25,10 @@ var InsufficientBalanceError = class extends Error {
     this.maxMintUrl = maxMintUrl;
     this.name = "InsufficientBalanceError";
   }
+  required;
+  available;
+  maxMintBalance;
+  maxMintUrl;
 };
 
 // wallet/AuditLogger.ts
@@ -98,6 +102,10 @@ var CashuSpender = class {
     this.balanceManager = balanceManager;
     this.logger = (logger ?? consoleLogger).child("CashuSpender");
   }
+  walletAdapter;
+  storageAdapter;
+  _providerRegistry;
+  balanceManager;
   _isBusy = false;
   debugLevel = "WARN";
   logger;
@@ -556,6 +564,9 @@ var CashuSpender = class {
             apiKeyEntry.baseUrl
           );
           if (balanceResult.isInvalidApiKey) {
+            this.logger.warn(
+              `refundProviders: ${apiKeyEntry.baseUrl} returned invalid API key; removing local key and treating as success`
+            );
             this.storageAdapter.removeApiKey(apiKeyEntry.baseUrl);
             results.push({
               baseUrl: apiKeyEntry.baseUrl,
@@ -569,13 +580,23 @@ var CashuSpender = class {
               apiKeyEntry.baseUrl,
               balanceSat
             );
+          } else {
+            this.logger.warn(
+              `refundProviders: balance refresh for ${apiKeyEntry.baseUrl} returned negative amount; keeping stale local balance=${apiKeyEntryFull.balance}`
+            );
           }
-        } catch {
+        } catch (error) {
+          this.logger.warn(
+            `refundProviders: balance refresh threw for ${apiKeyEntry.baseUrl}; proceeding with stale local balance`,
+            error
+          );
         }
         const refreshedEntry = this.storageAdapter.getApiKey(
           apiKeyEntry.baseUrl
         );
-        if (!refreshedEntry) continue;
+        if (!refreshedEntry) {
+          continue;
+        }
         const refundResult = await this.balanceManager.refundApiKey({
           mintUrl,
           baseUrl: apiKeyEntry.baseUrl,
@@ -588,6 +609,9 @@ var CashuSpender = class {
           const currentEntry = this.storageAdapter.getApiKey(
             apiKeyEntry.baseUrl
           );
+          this.logger.warn(
+            `refundProviders: refund failed for ${apiKeyEntry.baseUrl}; currentEntry=${Boolean(currentEntry)} balance=${currentEntry?.balance ?? "none"}. Touching lastUsed to rate-limit retries.`
+          );
           if (currentEntry) {
             this.storageAdapter.updateApiKeyBalance(
               apiKeyEntry.baseUrl,
@@ -600,6 +624,9 @@ var CashuSpender = class {
           success: refundResult.success
         });
       } else {
+        this.logger.warn(
+          `refundProviders: cannot refund ${apiKeyEntry.baseUrl}; apiKeyEntryFull=${Boolean(apiKeyEntryFull)} balanceManager=${Boolean(this.balanceManager)}`
+        );
         results.push({
           baseUrl: apiKeyEntry.baseUrl,
           success: false
@@ -672,10 +699,14 @@ var BalanceManager = class _BalanceManager {
         walletAdapter,
         storageAdapter,
         providerRegistry,
-        this
+        this,
+        this.logger
       );
     }
   }
+  walletAdapter;
+  storageAdapter;
+  providerRegistry;
   cashuSpender;
   /** In-memory guard for per-provider wallet mutations (topup / refund) */
   providerWalletOps = /* @__PURE__ */ new Map();
@@ -769,6 +800,7 @@ var BalanceManager = class _BalanceManager {
   async _refundApiKeyImpl(options) {
     const { mintUrl, baseUrl, apiKey, forceRefund } = options;
     if (!apiKey) {
+      this.logger.warn(`refundApiKey: aborting for ${baseUrl} - no API key`);
       return { success: false, message: "No API key to refund" };
     }
     if (!forceRefund) {
@@ -776,7 +808,9 @@ var BalanceManager = class _BalanceManager {
       if (apiKeyEntry?.lastUsed) {
         const fiveMinutesAgo = Date.now() - 5 * 60 * 1e3;
         if (apiKeyEntry.lastUsed > fiveMinutesAgo) {
-          this.logger.log(`Skipping refund for ${baseUrl} - used ${Math.round((Date.now() - apiKeyEntry.lastUsed) / 1e3)}s ago`);
+          this.logger.log(
+            `refundApiKey: skipping ${baseUrl} - used ${Math.round((Date.now() - apiKeyEntry.lastUsed) / 1e3)}s ago`
+          );
           return {
             success: false,
             message: "API key was used recently, skipping refund"
@@ -787,7 +821,15 @@ var BalanceManager = class _BalanceManager {
     let fetchResult;
     try {
       fetchResult = await this.fetchRefundToken(baseUrl, apiKey);
+      if (fetchResult.error === "No balance to refund") {
+        this.logger.log(`refundApiKey: provider says no balance for ${baseUrl}; removing API key`);
+        this.storageAdapter.removeApiKey(baseUrl);
+        return { success: true, message: "No balance to refund, key cleaned up" };
+      }
       if (!fetchResult.success) {
+        this.logger.warn(
+          `refundApiKey: fetch failed for ${baseUrl}: ${fetchResult.error || "API key refund failed"}`
+        );
         return {
           success: false,
           message: fetchResult.error || "API key refund failed",
@@ -795,22 +837,23 @@ var BalanceManager = class _BalanceManager {
         };
       }
       if (!fetchResult.token) {
+        this.logger.warn(`refundApiKey: no token received for ${baseUrl}`);
         return {
           success: false,
           message: "No token received from API key refund",
           requestId: fetchResult.requestId
         };
       }
-      if (fetchResult.error === "No balance to refund") {
-        this.storageAdapter.removeApiKey(baseUrl);
-        return { success: true, message: "No balance to refund, key cleaned up" };
-      }
       const receiveResult = await this.cashuSpender.receiveToken(
         fetchResult.token
       );
       const totalAmountMsat = receiveResult.unit === "msat" ? receiveResult.amount : receiveResult.amount * 1e3;
       if (receiveResult.success) {
         this.storageAdapter.removeApiKey(baseUrl);
+      } else {
+        this.logger.warn(
+          `refundApiKey: receive failed for ${baseUrl}; keeping API key. message=${receiveResult.message ?? "none"}`
+        );
       }
       return {
         success: receiveResult.success,
@@ -857,6 +900,10 @@ var BalanceManager = class _BalanceManager {
       const requestId = response.headers.get("x-routstr-request-id") || void 0;
       if (!response.ok) {
         const errorData = await response.json().catch(() => ({}));
+        this.logger.warn(
+          `fetchRefundToken: non-ok response for ${url} status=${response.status} statusText=${response.statusText}`,
+          errorData
+        );
         return {
           success: false,
           requestId,