@routstr/sdk 0.3.6 → 0.3.8

package/dist/client/index.d.mts

@@ -1,10 +1,10 @@
-import { M as Model, S as SdkLogger, a as Message, T as TransactionHistory, m as StreamingResult } from '../types-DPQM6tIG.mjs';
-import { P as ProviderRegistry, W as WalletAdapter, S as StorageAdapter, a as StreamingCallbacks } from '../interfaces-Bp0Ngmqv.mjs';
-import { S as SdkStore, U as UsageTrackingDriver } from '../store-C4FyyOnO.mjs';
+import { e as Model, S as SdkLogger, M as Message, n as TransactionHistory, m as StreamingResult } from '../types-_21yYFZG.mjs';
+import { P as ProviderRegistry, W as WalletAdapter, S as StorageAdapter, a as StreamingCallbacks } from '../interfaces-Csn8Uq04.mjs';
+import { S as SdkStore, U as UsageTrackingDriver } from '../store-C6dfj1cc.mjs';
 import { CashuSpender, BalanceManager } from '../wallet/index.mjs';
 import { Transform } from 'stream';
 import 'zustand/vanilla';
-import '../interfaces-Cqkt41QR.mjs';
+import '../interfaces-Cv1k2EUK.mjs';
 
 /**
  * ProviderManager - Handles provider selection and failover logic

package/dist/client/index.d.ts

@@ -1,10 +1,10 @@
-import { M as Model, S as SdkLogger, a as Message, T as TransactionHistory, m as StreamingResult } from '../types-DPQM6tIG.js';
-import { P as ProviderRegistry, W as WalletAdapter, S as StorageAdapter, a as StreamingCallbacks } from '../interfaces-D2FDCLyP.js';
-import { S as SdkStore, U as UsageTrackingDriver } from '../store-BFUGGr_v.js';
+import { e as Model, S as SdkLogger, M as Message, n as TransactionHistory, m as StreamingResult } from '../types-_21yYFZG.js';
+import { P as ProviderRegistry, W as WalletAdapter, S as StorageAdapter, a as StreamingCallbacks } from '../interfaces-C-DYd9Jy.js';
+import { S as SdkStore, U as UsageTrackingDriver } from '../store-58VcEUoA.js';
 import { CashuSpender, BalanceManager } from '../wallet/index.js';
 import { Transform } from 'stream';
 import 'zustand/vanilla';
-import '../interfaces-D9qI1ym6.js';
+import '../interfaces-iL7CWeG5.js';
 
 /**
  * ProviderManager - Handles provider selection and failover logic

package/dist/client/index.js

@@ -30,6 +30,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) {
@@ -41,6 +45,9 @@ var ProviderError = class extends Error {
     this.requestId = requestId;
     this.name = "ProviderError";
   }
+  baseUrl;
+  statusCode;
+  requestId;
 };
 var FailoverError = class extends Error {
   constructor(originalProvider, failedProviders, message) {
@@ -51,6 +58,8 @@ var FailoverError = class extends Error {
     this.failedProviders = failedProviders;
     this.name = "FailoverError";
   }
+  originalProvider;
+  failedProviders;
 };
 
 // wallet/AuditLogger.ts
@@ -124,6 +133,10 @@ var CashuSpender = class {
     this.balanceManager = balanceManager;
     this.logger = (logger ?? consoleLogger).child("CashuSpender");
   }
+  walletAdapter;
+  storageAdapter;
+  _providerRegistry;
+  balanceManager;
   _isBusy = false;
   debugLevel = "WARN";
   logger;
@@ -582,6 +595,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,
@@ -595,13 +611,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,
@@ -614,6 +640,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,
@@ -626,6 +655,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
@@ -698,10 +730,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();
@@ -795,6 +831,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) {
@@ -802,7 +839,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"
@@ -813,7 +852,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",
@@ -821,22 +868,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,
@@ -883,6 +931,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,
@@ -1785,6 +1837,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();
@@ -3675,13 +3728,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;
@@ -3690,6 +3746,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;