@routstr/sdk 0.3.6 → 0.3.8

package/dist/client/index.mjs

@@ -28,6 +28,10 @@ var InsufficientBalanceError = class extends Error {
     this.maxMintUrl = maxMintUrl;
     this.name = "InsufficientBalanceError";
   }
+  required;
+  available;
+  maxMintBalance;
+  maxMintUrl;
 };
 var ProviderError = class extends Error {
   constructor(baseUrl, statusCode, message, requestId) {
@@ -39,6 +43,9 @@ var ProviderError = class extends Error {
     this.requestId = requestId;
     this.name = "ProviderError";
   }
+  baseUrl;
+  statusCode;
+  requestId;
 };
 var FailoverError = class extends Error {
   constructor(originalProvider, failedProviders, message) {
@@ -49,6 +56,8 @@ var FailoverError = class extends Error {
     this.failedProviders = failedProviders;
     this.name = "FailoverError";
   }
+  originalProvider;
+  failedProviders;
 };
 
 // wallet/AuditLogger.ts
@@ -122,6 +131,10 @@ var CashuSpender = class {
     this.balanceManager = balanceManager;
     this.logger = (logger ?? consoleLogger).child("CashuSpender");
   }
+  walletAdapter;
+  storageAdapter;
+  _providerRegistry;
+  balanceManager;
   _isBusy = false;
   debugLevel = "WARN";
   logger;
@@ -580,6 +593,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,
@@ -593,13 +609,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,
@@ -612,6 +638,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,
@@ -624,6 +653,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
@@ -696,10 +728,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();
@@ -793,6 +829,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) {
@@ -800,7 +837,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"
@@ -811,7 +850,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",
@@ -819,22 +866,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,
@@ -881,6 +929,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,
@@ -1783,6 +1835,7 @@ var ProviderManager = class _ProviderManager {
       this.hydrateFromStore();
     }
   }
+  providerRegistry;
   failedProviders = /* @__PURE__ */ new Set();
   /** Track when each provider last failed (provider URL -> timestamp) */
   lastFailed = /* @__PURE__ */ new Map();
@@ -3673,13 +3726,16 @@ var RoutstrClient = class {
     this.balanceManager = new BalanceManager(
       walletAdapter,
       storageAdapter,
-      providerRegistry
+      providerRegistry,
+      void 0,
+      this.logger
     );
     this.cashuSpender = new CashuSpender(
       walletAdapter,
       storageAdapter,
       providerRegistry,
-      this.balanceManager
+      this.balanceManager,
+      this.logger
     );
     this.streamProcessor = new StreamProcessor();
     this.alertLevel = alertLevel;
@@ -3688,6 +3744,9 @@ var RoutstrClient = class {
     this.sdkStore = options.sdkStore;
     this.providerManager = options.providerManager ?? new ProviderManager(providerRegistry, this.sdkStore, this.logger);
   }
+  walletAdapter;
+  storageAdapter;
+  providerRegistry;
   cashuSpender;
   balanceManager;
   streamProcessor;