@routstr/sdk 0.1.1 → 0.1.2

package/dist/client/index.js

@@ -108,6 +108,26 @@ var CashuSpender = class {
     this.balanceManager = balanceManager;
   }
   _isBusy = false;
+  debugLevel = "WARN";
+  async receiveToken(token) {
+    const result = await this.walletAdapter.receiveToken(token);
+    if (!result.success && result.message?.includes("Failed to fetch mint")) {
+      const cachedTokens = this.storageAdapter.getCachedReceiveTokens();
+      const existingIndex = cachedTokens.findIndex((t) => t.token === token);
+      if (existingIndex === -1) {
+        this.storageAdapter.setCachedReceiveTokens([
+          ...cachedTokens,
+          {
+            token,
+            amount: result.amount,
+            unit: result.unit,
+            createdAt: Date.now()
+          }
+        ]);
+      }
+    }
+    return result;
+  }
   async _getBalanceState() {
     const mintBalances = await this.walletAdapter.getBalances();
     const units = this.walletAdapter.getMintUnits();
@@ -150,6 +170,32 @@ var CashuSpender = class {
   get isBusy() {
     return this._isBusy;
   }
+  getDebugLevel() {
+    return this.debugLevel;
+  }
+  setDebugLevel(level) {
+    this.debugLevel = level;
+  }
+  _log(level, ...args) {
+    const levelPriority = {
+      DEBUG: 0,
+      WARN: 1,
+      ERROR: 2
+    };
+    if (levelPriority[level] >= levelPriority[this.debugLevel]) {
+      switch (level) {
+        case "DEBUG":
+          console.log(...args);
+          break;
+        case "WARN":
+          console.warn(...args);
+          break;
+        case "ERROR":
+          console.error(...args);
+          break;
+      }
+    }
+  }
   /**
    * Spend Cashu tokens with automatic mint selection and retry logic
    * Throws errors on failure instead of returning failed SpendResult
@@ -216,12 +262,16 @@ var CashuSpender = class {
       excludeMints,
       retryCount
     } = options;
-    console.log(
+    this._log(
+      "DEBUG",
       `[CashuSpender] _spendInternal: amount=${amount}, mintUrl=${mintUrl}, baseUrl=${baseUrl}, reuseToken=${reuseToken}`
     );
     let adjustedAmount = Math.ceil(amount);
     if (!adjustedAmount || isNaN(adjustedAmount)) {
-      console.error(`[CashuSpender] _spendInternal: Invalid amount: ${amount}`);
+      this._log(
+        "ERROR",
+        `[CashuSpender] _spendInternal: Invalid amount: ${amount}`
+      );
       return {
         token: null,
         status: "failed",
@@ -230,7 +280,8 @@ var CashuSpender = class {
       };
     }
     if (reuseToken && baseUrl) {
-      console.log(
+      this._log(
+        "DEBUG",
         `[CashuSpender] _spendInternal: Attempting to reuse token for ${baseUrl}`
       );
       const existingResult = await this._tryReuseToken(
@@ -239,12 +290,14 @@ var CashuSpender = class {
         mintUrl
       );
       if (existingResult) {
-        console.log(
+        this._log(
+          "DEBUG",
           `[CashuSpender] _spendInternal: Successfully reused token, balance: ${existingResult.balance}`
         );
         return existingResult;
       }
-      console.log(
+      this._log(
+        "DEBUG",
         `[CashuSpender] _spendInternal: Could not reuse token, will create new token`
       );
     }
@@ -262,12 +315,14 @@ var CashuSpender = class {
       (sum, item) => sum + item.amount,
       0
     );
-    console.log(
+    this._log(
+      "DEBUG",
       `[CashuSpender] _spendInternal: totalBalance=${totalBalance}, totalPending=${totalPending}, adjustedAmount=${adjustedAmount}`
     );
     const totalAvailableBalance = totalBalance + totalPending;
     if (totalAvailableBalance < adjustedAmount) {
-      console.error(
+      this._log(
+        "ERROR",
         `[CashuSpender] _spendInternal: Insufficient balance, have=${totalAvailableBalance}, need=${adjustedAmount}`
       );
       return this._createInsufficientBalanceError(
@@ -335,7 +390,8 @@ var CashuSpender = class {
       baseUrl,
       status: "success"
     });
-    console.log(
+    this._log(
+      "DEBUG",
       `[CashuSpender] _spendInternal: Successfully spent ${spentAmount}, returning token with balance=${spentAmount}`
     );
     return {
@@ -353,7 +409,7 @@ var CashuSpender = class {
     if (!storedToken) return null;
     const pendingDistribution = this.storageAdapter.getCachedTokenDistribution();
     const balanceForBaseUrl = pendingDistribution.find((b) => b.baseUrl === baseUrl)?.amount || 0;
-    console.log("RESUINGDSR GSODGNSD", balanceForBaseUrl, amount);
+    this._log("DEBUG", "RESUINGDSR GSODGNSD", balanceForBaseUrl, amount);
     if (balanceForBaseUrl > amount) {
       const units = this.walletAdapter.getMintUnits();
       const unit = units[mintUrl] || "sat";
@@ -371,7 +427,7 @@ var CashuSpender = class {
         baseUrl,
         amount: topUpAmount
       });
-      console.log("TOPUP ", topUpResult);
+      this._log("DEBUG", "TOPUP ", topUpResult);
       if (topUpResult.success && topUpResult.toppedUpAmount) {
         const newBalance = balanceForBaseUrl + topUpResult.toppedUpAmount;
         const units = this.walletAdapter.getMintUnits();
@@ -393,7 +449,7 @@ var CashuSpender = class {
         baseUrl,
         storedToken
       );
-      console.log(providerBalance);
+      this._log("DEBUG", providerBalance);
       if (providerBalance <= 0) {
         this.storageAdapter.removeToken(baseUrl);
       }
@@ -412,7 +468,7 @@ var CashuSpender = class {
     const refundResults = await Promise.allSettled(
       toRefund.map(async (pending) => {
         const token = this.storageAdapter.getToken(pending.baseUrl);
-        console.log(token, this.balanceManager);
+        this._log("DEBUG", token, this.balanceManager);
         if (!token || !this.balanceManager) {
           return { baseUrl: pending.baseUrl, success: false };
         }
@@ -428,7 +484,7 @@ var CashuSpender = class {
           baseUrl: pending.baseUrl,
           token
         });
-        console.log(result);
+        this._log("DEBUG", result);
         if (result.success) {
           this.storageAdapter.removeToken(pending.baseUrl);
         }
@@ -526,11 +582,22 @@ var CashuSpender = class {
 
 // wallet/BalanceManager.ts
 var BalanceManager = class {
-  constructor(walletAdapter, storageAdapter, providerRegistry) {
+  constructor(walletAdapter, storageAdapter, providerRegistry, cashuSpender) {
     this.walletAdapter = walletAdapter;
     this.storageAdapter = storageAdapter;
     this.providerRegistry = providerRegistry;
+    if (cashuSpender) {
+      this.cashuSpender = cashuSpender;
+    } else {
+      this.cashuSpender = new CashuSpender(
+        walletAdapter,
+        storageAdapter,
+        providerRegistry,
+        this
+      );
+    }
   }
+  cashuSpender;
   /**
    * Unified refund - handles both NIP-60 and legacy wallet refunds
    */
@@ -565,7 +632,7 @@ var BalanceManager = class {
         this.storageAdapter.removeToken(baseUrl);
         return { success: true, message: "No balance to refund" };
       }
-      const receiveResult = await this.walletAdapter.receiveToken(
+      const receiveResult = await this.cashuSpender.receiveToken(
         fetchResult.token
       );
       const totalAmountMsat = receiveResult.unit === "msat" ? receiveResult.amount : receiveResult.amount * 1e3;
@@ -610,7 +677,7 @@ var BalanceManager = class {
       if (fetchResult.error === "No balance to refund") {
         return { success: false, message: "No balance to refund" };
       }
-      const receiveResult = await this.walletAdapter.receiveToken(
+      const receiveResult = await this.cashuSpender.receiveToken(
         fetchResult.token
       );
       const totalAmountMsat = receiveResult.unit === "msat" ? receiveResult.amount : receiveResult.amount * 1e3;
@@ -1051,7 +1118,7 @@ var BalanceManager = class {
    */
   async _recoverFailedTopUp(cashuToken) {
     try {
-      await this.walletAdapter.receiveToken(cashuToken);
+      await this.cashuSpender.receiveToken(cashuToken);
     } catch (error) {
       console.error(
         "[BalanceManager._recoverFailedTopUp] Failed to recover token",
@@ -1722,12 +1789,39 @@ var RoutstrClient = class {
   providerManager;
   alertLevel;
   mode;
+  debugLevel = "WARN";
   /**
    * Get the current client mode
    */
   getMode() {
     return this.mode;
   }
+  getDebugLevel() {
+    return this.debugLevel;
+  }
+  setDebugLevel(level) {
+    this.debugLevel = level;
+  }
+  _log(level, ...args) {
+    const levelPriority = {
+      DEBUG: 0,
+      WARN: 1,
+      ERROR: 2
+    };
+    if (levelPriority[level] >= levelPriority[this.debugLevel]) {
+      switch (level) {
+        case "DEBUG":
+          console.log(...args);
+          break;
+        case "WARN":
+          console.warn(...args);
+          break;
+        case "ERROR":
+          console.error(...args);
+          break;
+      }
+    }
+  }
   /**
    * Get the CashuSpender instance
    */
@@ -1791,7 +1885,7 @@ var RoutstrClient = class {
       amount: requiredSats,
       baseUrl
     });
-    console.log(token, baseUrl);
+    this._log("DEBUG", token, baseUrl);
     let requestBody = body;
     if (body && typeof body === "object") {
       const bodyObj = body;
@@ -1815,8 +1909,9 @@ var RoutstrClient = class {
     });
     const tokenBalanceInSats = tokenBalanceUnit === "msat" ? tokenBalance / 1e3 : tokenBalance;
     const baseUrlUsed = response.baseUrl || baseUrl;
+    const tokenUsed = response.token || token;
     await this._handlePostResponseBalanceUpdate({
-      token,
+      token: tokenUsed,
       baseUrl: baseUrlUsed,
       initialTokenBalance: tokenBalanceInSats,
       response
@@ -1952,14 +2047,15 @@ var RoutstrClient = class {
     const { path, method, body, baseUrl, token, headers } = params;
     try {
       const url = `${baseUrl.replace(/\/$/, "")}${path}`;
-      if (this.mode === "xcashu") console.log("HEADERS,", headers);
+      if (this.mode === "xcashu") this._log("DEBUG", "HEADERS,", headers);
       const response = await fetch(url, {
         method,
         headers,
         body: body === void 0 || method === "GET" ? void 0 : JSON.stringify(body)
       });
-      if (this.mode === "xcashu") console.log("response,", response);
+      if (this.mode === "xcashu") this._log("DEBUG", "response,", response);
       response.baseUrl = baseUrl;
+      response.token = token;
       if (!response.ok) {
         const requestId = response.headers.get("x-routstr-request-id") || void 0;
         return await this._handleErrorResponse(
@@ -1989,38 +2085,44 @@ var RoutstrClient = class {
   async _handleErrorResponse(params, token, status, requestId, xCashuRefundToken) {
     const { path, method, body, selectedModel, baseUrl, mintUrl } = params;
     let tryNextProvider = false;
-    console.log(
+    this._log(
+      "DEBUG",
       `[RoutstrClient] _handleErrorResponse: status=${status}, baseUrl=${baseUrl}, mode=${this.mode}, token preview=${token}, requestId=${requestId}`
     );
-    console.log(
+    this._log(
+      "DEBUG",
       `[RoutstrClient] _handleErrorResponse: Attempting to receive/restore token for ${baseUrl}`
     );
     if (params.token.startsWith("cashu")) {
-      const tryReceiveTokenResult = await this.walletAdapter.receiveToken(
+      const tryReceiveTokenResult = await this.cashuSpender.receiveToken(
         params.token
       );
       if (tryReceiveTokenResult.success) {
-        console.log(
+        this._log(
+          "DEBUG",
           `[RoutstrClient] _handleErrorResponse: Token restored successfully, amount=${tryReceiveTokenResult.amount}`
         );
         tryNextProvider = true;
         if (this.mode === "lazyrefund")
           this.storageAdapter.removeToken(baseUrl);
       } else {
-        console.log(
-          `[RoutstrClient] _handleErrorResponse: Token restore failed or not needed`
+        this._log(
+          "DEBUG",
+          `[RoutstrClient] _handleErrorResponse: Failed to receive token. `
         );
       }
     }
     if (this.mode === "xcashu") {
       if (xCashuRefundToken) {
-        console.log(
+        this._log(
+          "DEBUG",
           `[RoutstrClient] _handleErrorResponse: Attempting to receive xcashu refund token, preview=${xCashuRefundToken.substring(0, 20)}...`
         );
         try {
-          const receiveResult = await this.walletAdapter.receiveToken(xCashuRefundToken);
+          const receiveResult = await this.cashuSpender.receiveToken(xCashuRefundToken);
           if (receiveResult.success) {
-            console.log(
+            this._log(
+              "DEBUG",
               `[RoutstrClient] _handleErrorResponse: xcashu refund received, amount=${receiveResult.amount}`
             );
             tryNextProvider = true;
@@ -2032,7 +2134,7 @@ var RoutstrClient = class {
               requestId
             );
         } catch (error) {
-          console.error("[xcashu] Failed to receive refund token:", error);
+          this._log("ERROR", "[xcashu] Failed to receive refund token:", error);
           throw new ProviderError(
             baseUrl,
             status,
@@ -2057,7 +2159,8 @@ var RoutstrClient = class {
         amount: params.requiredSats * TOPUP_MARGIN,
         token: params.token
       });
-      console.log(
+      this._log(
+        "DEBUG",
         `[RoutstrClient] _handleErrorResponse: Topup result for ${baseUrl}: success=${topupResult.success}, message=${topupResult.message}`
       );
       if (!topupResult.success) {
@@ -2067,18 +2170,21 @@ var RoutstrClient = class {
           const haveMatch = message.match(/have (\d+)/);
           const required = needMatch ? parseInt(needMatch[1], 10) : params.requiredSats;
           const available = haveMatch ? parseInt(haveMatch[1], 10) : 0;
-          console.log(
+          this._log(
+            "DEBUG",
             `[RoutstrClient] _handleErrorResponse: Insufficient balance, need=${required}, have=${available}`
           );
           throw new InsufficientBalanceError(required, available);
         } else {
-          console.log(
+          this._log(
+            "DEBUG",
             `[RoutstrClient] _handleErrorResponse: Topup failed with non-insufficient-balance error, will try next provider`
           );
           tryNextProvider = true;
         }
       } else {
-        console.log(
+        this._log(
+          "DEBUG",
           `[RoutstrClient] _handleErrorResponse: Topup successful, will retry with new token`
         );
       }
@@ -2089,8 +2195,9 @@ var RoutstrClient = class {
           headers: this._withAuthHeader(params.baseHeaders, params.token)
         });
     }
-    if ((status === 401 || status === 403 || status === 413 || status === 400 || status === 500 || status === 502 || status === 503 || status === 521) && !tryNextProvider) {
-      console.log(
+    if ((status === 401 || status === 403 || status === 413 || status === 400 || status === 500 || status === 502 || status === 503 || status === 504 || status === 521) && !tryNextProvider) {
+      this._log(
+        "DEBUG",
         `[RoutstrClient] _handleErrorResponse: Status ${status} (auth/server error), attempting refund for ${baseUrl}, mode=${this.mode}`
       );
       if (this.mode === "lazyrefund") {
@@ -2100,7 +2207,8 @@ var RoutstrClient = class {
             baseUrl,
             token: params.token
           });
-          console.log(
+          this._log(
+            "DEBUG",
             `[RoutstrClient] _handleErrorResponse: Lazyrefund result: success=${refundResult.success}`
           );
           if (refundResult.success) this.storageAdapter.removeToken(baseUrl);
@@ -2120,14 +2228,16 @@ var RoutstrClient = class {
           );
         }
       } else if (this.mode === "apikeys") {
-        console.log(
+        this._log(
+          "DEBUG",
           `[RoutstrClient] _handleErrorResponse: Attempting API key refund for ${baseUrl}, key preview=${token}`
         );
         const initialBalance = await this.balanceManager.getTokenBalance(
           token,
           baseUrl
         );
-        console.log(
+        this._log(
+          "DEBUG",
           `[RoutstrClient] _handleErrorResponse: Initial API key balance: ${initialBalance.amount}`
         );
         const refundResult = await this.balanceManager.refundApiKey({
@@ -2135,7 +2245,8 @@ var RoutstrClient = class {
           baseUrl,
           apiKey: token
         });
-        console.log(
+        this._log(
+          "DEBUG",
           `[RoutstrClient] _handleErrorResponse: API key refund result: success=${refundResult.success}, message=${refundResult.message}`
         );
         if (!refundResult.success && initialBalance.amount > 0) {
@@ -2150,7 +2261,8 @@ var RoutstrClient = class {
       }
     }
     this.providerManager.markFailed(baseUrl);
-    console.log(
+    this._log(
+      "DEBUG",
       `[RoutstrClient] _handleErrorResponse: Marked provider ${baseUrl} as failed`
     );
     if (!selectedModel) {
@@ -2165,7 +2277,8 @@ var RoutstrClient = class {
       baseUrl
     );
     if (nextProvider) {
-      console.log(
+      this._log(
+        "DEBUG",
         `[RoutstrClient] _handleErrorResponse: Failing over to next provider: ${nextProvider}, model: ${selectedModel.id}`
       );
       const newModel = await this.providerManager.getModelForProvider(
@@ -2180,7 +2293,8 @@ var RoutstrClient = class {
         messagesForPricing,
         params.maxTokens
       );
-      console.log(
+      this._log(
+        "DEBUG",
         `[RoutstrClient] _handleErrorResponse: Creating new token for failover provider ${nextProvider}, required sats: ${newRequiredSats}`
       );
       const spendResult = await this._spendToken({
@@ -2212,10 +2326,10 @@ var RoutstrClient = class {
       const refundToken = response.headers.get("x-cashu") ?? void 0;
       if (refundToken) {
         try {
-          const receiveResult = await this.walletAdapter.receiveToken(refundToken);
+          const receiveResult = await this.cashuSpender.receiveToken(refundToken);
           satsSpent = initialTokenBalance - receiveResult.amount * (receiveResult.unit == "sat" ? 1 : 1e3);
         } catch (error) {
-          console.error("[xcashu] Failed to receive refund token:", error);
+          this._log("ERROR", "[xcashu] Failed to receive refund token:", error);
         }
       }
     } else if (this.mode === "lazyrefund") {
@@ -2232,7 +2346,8 @@ var RoutstrClient = class {
           token,
           baseUrl
         );
-        console.log(
+        this._log(
+          "DEBUG",
           "LATEST Balance",
           latestBalanceInfo.amount,
           latestBalanceInfo.reserved,
@@ -2244,7 +2359,7 @@ var RoutstrClient = class {
         this.storageAdapter.updateApiKeyBalance(baseUrl, latestTokenBalance);
         satsSpent = initialTokenBalance - latestTokenBalance;
       } catch (e) {
-        console.warn("Could not get updated API key balance:", e);
+        this._log("WARN", "Could not get updated API key balance:", e);
         satsSpent = fallbackSatsSpent ?? initialTokenBalance;
       }
     }
@@ -2355,11 +2470,12 @@ var RoutstrClient = class {
    * Handle errors and notify callbacks
    */
   _handleError(error, callbacks) {
-    console.error("[RoutstrClient] _handleError: Error occurred", error);
+    this._log("ERROR", "[RoutstrClient] _handleError: Error occurred", error);
     if (error instanceof Error) {
       const isStreamError = error.message.includes("Error in input stream") || error.message.includes("Load failed");
       const modifiedErrorMsg = isStreamError ? "AI stream was cut off, turn on Keep Active or please try again" : error.message;
-      console.error(
+      this._log(
+        "ERROR",
         `[RoutstrClient] _handleError: Error type=${error.constructor.name}, message=${modifiedErrorMsg}, isStreamError=${isStreamError}`
       );
       callbacks.onMessageAppend({
@@ -2388,13 +2504,15 @@ var RoutstrClient = class {
    */
   async _spendToken(params) {
     const { mintUrl, amount, baseUrl } = params;
-    console.log(
+    this._log(
+      "DEBUG",
       `[RoutstrClient] _spendToken: mode=${this.mode}, amount=${amount}, baseUrl=${baseUrl}, mintUrl=${mintUrl}`
     );
     if (this.mode === "apikeys") {
       let parentApiKey = this.storageAdapter.getApiKey(baseUrl);
       if (!parentApiKey) {
-        console.log(
+        this._log(
+          "DEBUG",
           `[RoutstrClient] _spendToken: No existing API key for ${baseUrl}, creating new one via Cashu`
         );
         const spendResult2 = await this.cashuSpender.spend({
@@ -2404,7 +2522,8 @@ var RoutstrClient = class {
           reuseToken: false
         });
         if (!spendResult2.token) {
-          console.error(
+          this._log(
+            "ERROR",
             `[RoutstrClient] _spendToken: Failed to create Cashu token for API key creation, error:`,
             spendResult2.error
           );
@@ -2412,30 +2531,35 @@ var RoutstrClient = class {
             `[RoutstrClient] _spendToken: Failed to create Cashu token for API key creation, error: ${spendResult2.error}`
           );
         } else {
-          console.log(
+          this._log(
+            "DEBUG",
             `[RoutstrClient] _spendToken: Cashu token created, token preview: ${spendResult2.token}`
           );
         }
-        console.log(
+        this._log(
+          "DEBUG",
           `[RoutstrClient] _spendToken: Created API key for ${baseUrl}, key preview: ${spendResult2.token}, balance: ${spendResult2.balance}`
         );
         try {
           this.storageAdapter.setApiKey(baseUrl, spendResult2.token);
         } catch (error) {
           if (error instanceof Error && error.message.includes("ApiKey already exists")) {
-            const tryReceiveTokenResult = await this.walletAdapter.receiveToken(
+            const tryReceiveTokenResult = await this.cashuSpender.receiveToken(
               spendResult2.token
             );
             if (tryReceiveTokenResult.success) {
-              console.log(
+              this._log(
+                "DEBUG",
                 `[RoutstrClient] _handleErrorResponse: Token restored successfully, amount=${tryReceiveTokenResult.amount}`
               );
             } else {
-              console.log(
+              this._log(
+                "DEBUG",
                 `[RoutstrClient] _handleErrorResponse: Token restore failed or not needed`
               );
             }
-            console.log(
+            this._log(
+              "DEBUG",
               `[RoutstrClient] _spendToken: API key already exists for ${baseUrl}, using existing key`
             );
           } else {
@@ -2444,7 +2568,8 @@ var RoutstrClient = class {
         }
         parentApiKey = this.storageAdapter.getApiKey(baseUrl);
       } else {
-        console.log(
+        this._log(
+          "DEBUG",
           `[RoutstrClient] _spendToken: Using existing API key for ${baseUrl}, key preview: ${parentApiKey.key}`
         );
       }
@@ -2466,10 +2591,11 @@ var RoutstrClient = class {
           tokenBalance = balanceInfo.amount;
           tokenBalanceUnit = balanceInfo.unit;
         } catch (e) {
-          console.warn("Could not get initial API key balance:", e);
+          this._log("WARN", "Could not get initial API key balance:", e);
         }
       }
-      console.log(
+      this._log(
+        "DEBUG",
         `[RoutstrClient] _spendToken: Returning token with balance=${tokenBalance} ${tokenBalanceUnit}`
       );
       return {
@@ -2478,7 +2604,8 @@ var RoutstrClient = class {
         tokenBalanceUnit
       };
     }
-    console.log(
+    this._log(
+      "DEBUG",
       `[RoutstrClient] _spendToken: Calling CashuSpender.spend for amount=${amount}, mintUrl=${mintUrl}, mode=${this.mode}`
     );
     const spendResult = await this.cashuSpender.spend({
@@ -2488,12 +2615,14 @@ var RoutstrClient = class {
       reuseToken: this.mode === "lazyrefund"
     });
     if (!spendResult.token) {
-      console.error(
+      this._log(
+        "ERROR",
         `[RoutstrClient] _spendToken: CashuSpender.spend failed, error:`,
         spendResult.error
       );
     } else {
-      console.log(
+      this._log(
+        "DEBUG",
         `[RoutstrClient] _spendToken: Cashu token created, token preview: ${spendResult.token}, balance: ${spendResult.balance} ${spendResult.unit ?? "sat"}`
       );
     }