@routstr/sdk 0.3.6 → 0.3.8

package/dist/{interfaces-D2FDCLyP.d.ts → interfaces-C-DYd9Jy.d.ts}

@@ -1,4 +1,4 @@
-import { P as ProviderInfo, M as Model, a as Message, T as TransactionHistory } from './types-DPQM6tIG.js';
+import { k as ProviderInfo, e as Model, M as Message, n as TransactionHistory } from './types-_21yYFZG.js';
 
 /**
  * Interfaces for the Routstr SDK wallet abstraction layer

package/dist/{interfaces-Bp0Ngmqv.d.mts → interfaces-Csn8Uq04.d.mts}

@@ -1,4 +1,4 @@
-import { P as ProviderInfo, M as Model, a as Message, T as TransactionHistory } from './types-DPQM6tIG.mjs';
+import { k as ProviderInfo, e as Model, M as Message, n as TransactionHistory } from './types-_21yYFZG.mjs';
 
 /**
  * Interfaces for the Routstr SDK wallet abstraction layer

package/dist/{interfaces-Cqkt41QR.d.mts → interfaces-Cv1k2EUK.d.mts}

@@ -1,4 +1,4 @@
-import { M as Model, P as ProviderInfo } from './types-DPQM6tIG.mjs';
+import { e as Model, k as ProviderInfo } from './types-_21yYFZG.mjs';
 
 /**
  * Interfaces for the model and provider discovery system

package/dist/{interfaces-D9qI1ym6.d.ts → interfaces-iL7CWeG5.d.ts}

@@ -1,4 +1,4 @@
-import { M as Model, P as ProviderInfo } from './types-DPQM6tIG.js';
+import { e as Model, k as ProviderInfo } from './types-_21yYFZG.js';
 
 /**
  * Interfaces for the model and provider discovery system

package/dist/storage/index.d.mts

@@ -1,9 +1,9 @@
-import { a as StorageDriver, U as UsageTrackingDriver, b as UsageTrackingEntry, S as SdkStore } from '../store-C4FyyOnO.mjs';
-export { L as ListUsageTrackingOptions, c as createDiscoveryAdapterFromStore, d as createProviderRegistryFromStore, e as createSdkStore, f as createStorageAdapterFromStore } from '../store-C4FyyOnO.mjs';
-import { S as SdkLogger } from '../types-DPQM6tIG.mjs';
-import { D as DiscoveryAdapter } from '../interfaces-Cqkt41QR.mjs';
-import { P as ProviderRegistry, S as StorageAdapter } from '../interfaces-Bp0Ngmqv.mjs';
-export { X as XCashuTokenEntry } from '../interfaces-Bp0Ngmqv.mjs';
+import { a as StorageDriver, U as UsageTrackingDriver, b as UsageTrackingEntry, S as SdkStore } from '../store-C6dfj1cc.mjs';
+export { L as ListUsageTrackingOptions, c as createDiscoveryAdapterFromStore, d as createProviderRegistryFromStore, e as createSdkStore, f as createStorageAdapterFromStore } from '../store-C6dfj1cc.mjs';
+import { S as SdkLogger } from '../types-_21yYFZG.mjs';
+import { D as DiscoveryAdapter } from '../interfaces-Cv1k2EUK.mjs';
+import { P as ProviderRegistry, S as StorageAdapter } from '../interfaces-Csn8Uq04.mjs';
+export { X as XCashuTokenEntry } from '../interfaces-Csn8Uq04.mjs';
 import 'zustand/vanilla';
 
 interface IndexedDBUsageTrackingDriverOptions {

package/dist/storage/index.d.ts

@@ -1,9 +1,9 @@
-import { a as StorageDriver, U as UsageTrackingDriver, b as UsageTrackingEntry, S as SdkStore } from '../store-BFUGGr_v.js';
-export { L as ListUsageTrackingOptions, c as createDiscoveryAdapterFromStore, d as createProviderRegistryFromStore, e as createSdkStore, f as createStorageAdapterFromStore } from '../store-BFUGGr_v.js';
-import { S as SdkLogger } from '../types-DPQM6tIG.js';
-import { D as DiscoveryAdapter } from '../interfaces-D9qI1ym6.js';
-import { P as ProviderRegistry, S as StorageAdapter } from '../interfaces-D2FDCLyP.js';
-export { X as XCashuTokenEntry } from '../interfaces-D2FDCLyP.js';
+import { a as StorageDriver, U as UsageTrackingDriver, b as UsageTrackingEntry, S as SdkStore } from '../store-58VcEUoA.js';
+export { L as ListUsageTrackingOptions, c as createDiscoveryAdapterFromStore, d as createProviderRegistryFromStore, e as createSdkStore, f as createStorageAdapterFromStore } from '../store-58VcEUoA.js';
+import { S as SdkLogger } from '../types-_21yYFZG.js';
+import { D as DiscoveryAdapter } from '../interfaces-iL7CWeG5.js';
+import { P as ProviderRegistry, S as StorageAdapter } from '../interfaces-C-DYd9Jy.js';
+export { X as XCashuTokenEntry } from '../interfaces-C-DYd9Jy.js';
 import 'zustand/vanilla';
 
 interface IndexedDBUsageTrackingDriverOptions {

package/dist/{store-BFUGGr_v.d.ts → store-58VcEUoA.d.ts}

@@ -1,7 +1,7 @@
 import { StoreApi } from 'zustand/vanilla';
-import { D as DiscoveryAdapter } from './interfaces-D9qI1ym6.js';
-import { P as ProviderRegistry, S as StorageAdapter } from './interfaces-D2FDCLyP.js';
-import { M as Model, P as ProviderInfo, S as SdkLogger } from './types-DPQM6tIG.js';
+import { D as DiscoveryAdapter } from './interfaces-iL7CWeG5.js';
+import { P as ProviderRegistry, S as StorageAdapter } from './interfaces-C-DYd9Jy.js';
+import { e as Model, k as ProviderInfo, S as SdkLogger } from './types-_21yYFZG.js';
 
 interface UsageTrackingEntry {
     id: string;

package/dist/{store-C4FyyOnO.d.mts → store-C6dfj1cc.d.mts}

@@ -1,7 +1,7 @@
 import { StoreApi } from 'zustand/vanilla';
-import { D as DiscoveryAdapter } from './interfaces-Cqkt41QR.mjs';
-import { P as ProviderRegistry, S as StorageAdapter } from './interfaces-Bp0Ngmqv.mjs';
-import { M as Model, P as ProviderInfo, S as SdkLogger } from './types-DPQM6tIG.mjs';
+import { D as DiscoveryAdapter } from './interfaces-Cv1k2EUK.mjs';
+import { P as ProviderRegistry, S as StorageAdapter } from './interfaces-Csn8Uq04.mjs';
+import { e as Model, k as ProviderInfo, S as SdkLogger } from './types-_21yYFZG.mjs';
 
 interface UsageTrackingEntry {
     id: string;

package/dist/{types-DPQM6tIG.d.mts → types-_21yYFZG.d.mts}

@@ -231,4 +231,4 @@ interface MintDiscoveryResult {
     infoFromProviders: Record<string, ProviderInfo>;
 }
 
-export { type APIErrorVerdict as A, type CandidateProvider as C, type FetchAIResponseParams as F, type ImageData as I, type Model as M, type ProviderInfo as P, type RefundResult as R, type SdkLogger as S, type TransactionHistory as T, type UsageStats as U, type Message as a, type AnnotationData as b, type MessageContentType as c, type MintDiscoveryResult as d, type MintSelection as e, type ModelArchitecture as f, type ModelDiscoveryResult as g, type ModelPricing as h, type ModelSatsPricing as i, type PendingTokenEntry as j, type PerRequestLimits as k, type SpendResult as l, type StreamingResult as m, type TopUpResult as n, consoleLogger as o, noopLogger as p };
+export { type APIErrorVerdict as A, type CandidateProvider as C, type FetchAIResponseParams as F, type ImageData as I, type Message as M, type PendingTokenEntry as P, type RefundResult as R, type SdkLogger as S, type TopUpResult as T, type UsageStats as U, type AnnotationData as a, type MessageContentType as b, type MintDiscoveryResult as c, type MintSelection as d, type Model as e, type ModelArchitecture as f, type ModelDiscoveryResult as g, type ModelPricing as h, type ModelSatsPricing as i, type PerRequestLimits as j, type ProviderInfo as k, type SpendResult as l, type StreamingResult as m, type TransactionHistory as n, consoleLogger as o, noopLogger as p };

package/dist/{types-DPQM6tIG.d.ts → types-_21yYFZG.d.ts}

@@ -231,4 +231,4 @@ interface MintDiscoveryResult {
     infoFromProviders: Record<string, ProviderInfo>;
 }
 
-export { type APIErrorVerdict as A, type CandidateProvider as C, type FetchAIResponseParams as F, type ImageData as I, type Model as M, type ProviderInfo as P, type RefundResult as R, type SdkLogger as S, type TransactionHistory as T, type UsageStats as U, type Message as a, type AnnotationData as b, type MessageContentType as c, type MintDiscoveryResult as d, type MintSelection as e, type ModelArchitecture as f, type ModelDiscoveryResult as g, type ModelPricing as h, type ModelSatsPricing as i, type PendingTokenEntry as j, type PerRequestLimits as k, type SpendResult as l, type StreamingResult as m, type TopUpResult as n, consoleLogger as o, noopLogger as p };
+export { type APIErrorVerdict as A, type CandidateProvider as C, type FetchAIResponseParams as F, type ImageData as I, type Message as M, type PendingTokenEntry as P, type RefundResult as R, type SdkLogger as S, type TopUpResult as T, type UsageStats as U, type AnnotationData as a, type MessageContentType as b, type MintDiscoveryResult as c, type MintSelection as d, type Model as e, type ModelArchitecture as f, type ModelDiscoveryResult as g, type ModelPricing as h, type ModelSatsPricing as i, type PerRequestLimits as j, type ProviderInfo as k, type SpendResult as l, type StreamingResult as m, type TransactionHistory as n, consoleLogger as o, noopLogger as p };

package/dist/wallet/index.d.mts

@@ -1,7 +1,7 @@
-import { W as WalletAdapter, S as StorageAdapter, P as ProviderRegistry } from '../interfaces-Bp0Ngmqv.mjs';
-export { A as ApiKeyEntry, C as ChildKeyEntry, R as RoutstrClientOptions, a as StreamingCallbacks, X as XCashuTokenEntry } from '../interfaces-Bp0Ngmqv.mjs';
-import { S as SdkLogger, R as RefundResult, n as TopUpResult, l as SpendResult } from '../types-DPQM6tIG.mjs';
-export { P as ProviderInfo } from '../types-DPQM6tIG.mjs';
+import { W as WalletAdapter, S as StorageAdapter, P as ProviderRegistry } from '../interfaces-Csn8Uq04.mjs';
+export { A as ApiKeyEntry, C as ChildKeyEntry, R as RoutstrClientOptions, a as StreamingCallbacks, X as XCashuTokenEntry } from '../interfaces-Csn8Uq04.mjs';
+import { S as SdkLogger, R as RefundResult, T as TopUpResult, l as SpendResult } from '../types-_21yYFZG.mjs';
+export { k as ProviderInfo } from '../types-_21yYFZG.mjs';
 
 /**
  * BalanceManager - Handles refunding and topping up tokens from providers

package/dist/wallet/index.d.ts

@@ -1,7 +1,7 @@
-import { W as WalletAdapter, S as StorageAdapter, P as ProviderRegistry } from '../interfaces-D2FDCLyP.js';
-export { A as ApiKeyEntry, C as ChildKeyEntry, R as RoutstrClientOptions, a as StreamingCallbacks, X as XCashuTokenEntry } from '../interfaces-D2FDCLyP.js';
-import { S as SdkLogger, R as RefundResult, n as TopUpResult, l as SpendResult } from '../types-DPQM6tIG.js';
-export { P as ProviderInfo } from '../types-DPQM6tIG.js';
+import { W as WalletAdapter, S as StorageAdapter, P as ProviderRegistry } from '../interfaces-C-DYd9Jy.js';
+export { A as ApiKeyEntry, C as ChildKeyEntry, R as RoutstrClientOptions, a as StreamingCallbacks, X as XCashuTokenEntry } from '../interfaces-C-DYd9Jy.js';
+import { S as SdkLogger, R as RefundResult, T as TopUpResult, l as SpendResult } from '../types-_21yYFZG.js';
+export { k as ProviderInfo } from '../types-_21yYFZG.js';
 
 /**
  * BalanceManager - Handles refunding and topping up tokens from providers

package/dist/wallet/index.js

@@ -27,6 +27,10 @@ var InsufficientBalanceError = class extends Error {
     this.maxMintUrl = maxMintUrl;
     this.name = "InsufficientBalanceError";
   }
+  required;
+  available;
+  maxMintBalance;
+  maxMintUrl;
 };
 
 // wallet/AuditLogger.ts
@@ -100,6 +104,10 @@ var CashuSpender = class {
     this.balanceManager = balanceManager;
     this.logger = (logger ?? consoleLogger).child("CashuSpender");
   }
+  walletAdapter;
+  storageAdapter;
+  _providerRegistry;
+  balanceManager;
   _isBusy = false;
   debugLevel = "WARN";
   logger;
@@ -558,6 +566,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,
@@ -571,13 +582,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,
@@ -590,6 +611,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,
@@ -602,6 +626,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
@@ -674,10 +701,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();
@@ -771,6 +802,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) {
@@ -778,7 +810,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"
@@ -789,7 +823,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",
@@ -797,22 +839,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,
@@ -859,6 +902,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,