@routstr/sdk 0.3.6 → 0.3.8

package/dist/index.mjs

@@ -42,6 +42,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) {
@@ -53,6 +57,9 @@ var ProviderError = class extends Error {
     this.requestId = requestId;
     this.name = "ProviderError";
   }
+  baseUrl;
+  statusCode;
+  requestId;
 };
 var MintUnreachableError = class extends Error {
   constructor(mintUrl) {
@@ -62,6 +69,7 @@ var MintUnreachableError = class extends Error {
     this.mintUrl = mintUrl;
     this.name = "MintUnreachableError";
   }
+  mintUrl;
 };
 var TokenOperationError = class extends Error {
   constructor(message, operation, mintUrl) {
@@ -70,6 +78,8 @@ var TokenOperationError = class extends Error {
     this.mintUrl = mintUrl;
     this.name = "TokenOperationError";
   }
+  operation;
+  mintUrl;
 };
 var FailoverError = class extends Error {
   constructor(originalProvider, failedProviders, message) {
@@ -80,6 +90,8 @@ var FailoverError = class extends Error {
     this.failedProviders = failedProviders;
     this.name = "FailoverError";
   }
+  originalProvider;
+  failedProviders;
 };
 var StreamingError = class extends Error {
   constructor(message, finishReason, accumulatedContent) {
@@ -88,6 +100,8 @@ var StreamingError = class extends Error {
     this.accumulatedContent = accumulatedContent;
     this.name = "StreamingError";
   }
+  finishReason;
+  accumulatedContent;
 };
 var ModelNotFoundError = class extends Error {
   constructor(modelId, baseUrl) {
@@ -96,6 +110,8 @@ var ModelNotFoundError = class extends Error {
     this.baseUrl = baseUrl;
     this.name = "ModelNotFoundError";
   }
+  modelId;
+  baseUrl;
 };
 var ProviderBootstrapError = class extends Error {
   constructor(failedProviders, message) {
@@ -105,6 +121,7 @@ var ProviderBootstrapError = class extends Error {
     this.failedProviders = failedProviders;
     this.name = "ProviderBootstrapError";
   }
+  failedProviders;
 };
 var NoProvidersAvailableError = class extends Error {
   constructor() {
@@ -118,6 +135,7 @@ var MintDiscoveryError = class extends Error {
     this.baseUrl = baseUrl;
     this.name = "MintDiscoveryError";
   }
+  baseUrl;
 };
 var ModelManager = class _ModelManager {
   constructor(adapter, config = {}) {
@@ -129,6 +147,7 @@ var ModelManager = class _ModelManager {
     this.routstrPubkey = config.routstrPubkey || "4ad6fa2d16e2a9b576c863b4cf7404a70d4dc320c0c447d10ad6ff58993eacc8";
     this.logger = (config.logger ?? consoleLogger).child("ModelManager");
   }
+  adapter;
   cacheTTL;
   providerDirectoryUrl;
   includeProviderUrls;
@@ -665,6 +684,7 @@ var MintDiscovery = class {
     this.cacheTTL = config.cacheTTL || 21 * 60 * 1e3;
     this.logger = (config.logger ?? consoleLogger).child("MintDiscovery");
   }
+  adapter;
   cacheTTL;
   logger;
   /**
@@ -886,6 +906,10 @@ var CashuSpender = class {
     this.balanceManager = balanceManager;
     this.logger = (logger ?? consoleLogger).child("CashuSpender");
   }
+  walletAdapter;
+  storageAdapter;
+  _providerRegistry;
+  balanceManager;
   _isBusy = false;
   debugLevel = "WARN";
   logger;
@@ -1344,6 +1368,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,
@@ -1357,13 +1384,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,
@@ -1376,6 +1413,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,
@@ -1388,6 +1428,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
@@ -1460,10 +1503,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();
@@ -1557,6 +1604,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) {
@@ -1564,7 +1612,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"
@@ -1575,7 +1625,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",
@@ -1583,22 +1641,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,
@@ -1645,6 +1704,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,
@@ -2603,6 +2666,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();
@@ -4893,13 +4957,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;
@@ -4908,6 +4975,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;
@@ -6115,7 +6185,7 @@ async function resolveRouteRequestContext(options) {
   if (!mintUrl) {
     throw new Error("No mint configured in wallet");
   }
-  const client = new RoutstrClient(
+  const client = options.client ?? new RoutstrClient(
     walletAdapter,
     storageAdapter,
     providerRegistry,
@@ -6123,9 +6193,6 @@ async function resolveRouteRequestContext(options) {
     mode,
     { usageTrackingDriver, sdkStore, providerManager, logger }
   );
-  if (debugLevel) {
-    client.setDebugLevel(debugLevel);
-  }
   const maxTokens = extractMaxTokens(requestBody);
   const stream = extractStream(requestBody);
   const proxiedBody = requestBody && typeof requestBody === "object" ? { ...requestBody } : {};