@routstr/sdk 0.1.8 → 0.2.0

package/dist/index.mjs

@@ -13,9 +13,9 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 
 // core/errors.ts
 var InsufficientBalanceError = class extends Error {
-  constructor(required, available, maxMintBalance = 0, maxMintUrl = "") {
+  constructor(required, available, maxMintBalance = 0, maxMintUrl = "", customMessage) {
     super(
-      `Insufficient balance: need ${required} sats, have ${available} sats available. ` + (maxMintBalance > 0 ? `Largest mint balance: ${maxMintBalance} sats from ${maxMintUrl}` : "")
+      customMessage ?? `Insufficient balance: need ${required} sats, have ${available} sats available. ` + (maxMintBalance > 0 ? `Largest mint balance: ${maxMintBalance} sats from ${maxMintUrl}` : "")
     );
     this.required = required;
     this.available = available;
@@ -299,9 +299,10 @@ var ModelManager = class _ModelManager {
    * Uses cache if available and not expired
    * @param baseUrls List of provider base URLs to fetch from
    * @param forceRefresh Ignore cache and fetch fresh data
+   * @param onProgress Callback fired after each provider completes with current combined models
    * @returns Array of unique models with best prices selected
    */
-  async fetchModels(baseUrls, forceRefresh = false) {
+  async fetchModels(baseUrls, forceRefresh = false, onProgress) {
     if (baseUrls.length === 0) {
       throw new NoProvidersAvailableError();
     }
@@ -311,6 +312,12 @@ var ModelManager = class _ModelManager {
     const estimateMinCost = (m) => {
       return m?.sats_pricing?.completion ?? 0;
     };
+    const emitProgress = () => {
+      if (onProgress) {
+        const currentModels = Array.from(bestById.values()).map((v) => v.model);
+        onProgress(currentModels);
+      }
+    };
     const fetchPromises = baseUrls.map(async (url) => {
       const base = url.endsWith("/") ? url : `${url}/`;
       try {
@@ -345,6 +352,7 @@ var ModelManager = class _ModelManager {
             }
           }
         }
+        emitProgress();
         return { success: true, base, list };
       } catch (error) {
         if (this.isProviderDownError(error)) {
@@ -1466,6 +1474,10 @@ var BalanceManager = class {
         requestId
       };
     } catch (error) {
+      console.log(
+        "DEBUG",
+        `[TopuPU] topup: Topup result for ${baseUrl}: error=${error}`
+      );
       if (cashuToken) {
         await this._recoverFailedTopUp(cashuToken);
       }
@@ -1492,16 +1504,35 @@ var BalanceManager = class {
       (sum, value) => sum + value,
       0
     );
+    const targetProviderBalance = balanceState.providerBalances[baseUrl] || 0;
     const refundableProviderBalance = Object.entries(
       balanceState.providerBalances
     ).filter(([providerBaseUrl]) => providerBaseUrl !== baseUrl).reduce((sum, [, value]) => sum + value, 0);
-    if (totalMintBalance < adjustedAmount && totalMintBalance + refundableProviderBalance >= adjustedAmount && retryCount < 1) {
+    if (totalMintBalance + targetProviderBalance < adjustedAmount && totalMintBalance + targetProviderBalance + refundableProviderBalance >= adjustedAmount && retryCount < 1) {
       await this._refundOtherProvidersForTopUp(baseUrl, mintUrl);
       return this.createProviderToken({
         ...options,
         retryCount: retryCount + 1
       });
     }
+    if (totalMintBalance + targetProviderBalance < adjustedAmount) {
+      const error = new InsufficientBalanceError(
+        adjustedAmount,
+        totalMintBalance + targetProviderBalance,
+        totalMintBalance,
+        Object.entries(balanceState.mintBalances).reduce(
+          (max, [url, balance]) => balance > max.balance ? { url, balance } : max,
+          { url: "", balance: 0 }
+        ).url
+      );
+      return { success: false, error: error.message };
+    }
+    if (targetProviderBalance >= adjustedAmount) {
+      return {
+        success: true,
+        amountSpent: 0
+      };
+    }
     const providerMints = baseUrl && this.providerRegistry ? this.providerRegistry.getProviderMints(baseUrl) : [];
     let requiredAmount = adjustedAmount;
     const supportedMintsOnly = providerMints.length > 0;
@@ -2963,7 +2994,7 @@ var RoutstrClient = class {
             "DEBUG",
             `[RoutstrClient] _handleErrorResponse: Insufficient balance, need=${required}, have=${available}`
           );
-          throw new InsufficientBalanceError(required, available);
+          throw new InsufficientBalanceError(required, available, 0, "", message);
         } else {
           this._log(
             "DEBUG",
@@ -3699,7 +3730,11 @@ var createSqliteDriver = (options = {}) => {
 };
 
 // storage/drivers/indexedDB.ts
+var isBrowser = typeof indexedDB !== "undefined";
 var openDatabase = (dbName, storeName) => {
+  if (!isBrowser) {
+    return Promise.reject(new Error("IndexedDB is not available"));
+  }
   return new Promise((resolve, reject) => {
     const request = indexedDB.open(dbName, 1);
     request.onupgradeneeded = () => {
@@ -3804,7 +3839,8 @@ var SDK_STORAGE_KEYS = {
   ROUTSTR21_MODELS: "routstr21Models",
   LAST_ROUTSTR21_MODELS_UPDATE: "lastRoutstr21ModelsUpdate",
   CACHED_RECEIVE_TOKENS: "cached_receive_tokens",
-  USAGE_TRACKING: "usage_tracking"
+  USAGE_TRACKING: "usage_tracking",
+  CLIENT_IDS: "client_ids"
 };
 
 // storage/store.ts
@@ -3822,9 +3858,159 @@ var getCashuTokenBalance = (token) => {
     return 0;
   }
 };
-var createSdkStore = async ({
-  driver
-}) => {
+var createEmptyStore = (driver) => createStore((set, get) => ({
+  modelsFromAllProviders: {},
+  lastUsedModel: null,
+  baseUrlsList: [],
+  lastBaseUrlsUpdate: null,
+  disabledProviders: [],
+  mintsFromAllProviders: {},
+  infoFromAllProviders: {},
+  lastModelsUpdate: {},
+  cachedTokens: [],
+  apiKeys: [],
+  childKeys: [],
+  routstr21Models: [],
+  lastRoutstr21ModelsUpdate: null,
+  cachedReceiveTokens: [],
+  usageTracking: [],
+  clientIds: [],
+  setModelsFromAllProviders: (value) => {
+    const normalized = {};
+    for (const [baseUrl, models] of Object.entries(value)) {
+      normalized[normalizeBaseUrl(baseUrl)] = models;
+    }
+    void driver.setItem(
+      SDK_STORAGE_KEYS.MODELS_FROM_ALL_PROVIDERS,
+      normalized
+    );
+    set({ modelsFromAllProviders: normalized });
+  },
+  setLastUsedModel: (value) => {
+    void driver.setItem(SDK_STORAGE_KEYS.LAST_USED_MODEL, value);
+    set({ lastUsedModel: value });
+  },
+  setBaseUrlsList: (value) => {
+    const normalized = value.map((url) => normalizeBaseUrl(url));
+    void driver.setItem(SDK_STORAGE_KEYS.BASE_URLS_LIST, normalized);
+    set({ baseUrlsList: normalized });
+  },
+  setBaseUrlsLastUpdate: (value) => {
+    void driver.setItem(SDK_STORAGE_KEYS.LAST_BASE_URLS_UPDATE, value);
+    set({ lastBaseUrlsUpdate: value });
+  },
+  setDisabledProviders: (value) => {
+    const normalized = value.map((url) => normalizeBaseUrl(url));
+    void driver.setItem(SDK_STORAGE_KEYS.DISABLED_PROVIDERS, normalized);
+    set({ disabledProviders: normalized });
+  },
+  setMintsFromAllProviders: (value) => {
+    const normalized = {};
+    for (const [baseUrl, mints] of Object.entries(value)) {
+      normalized[normalizeBaseUrl(baseUrl)] = mints.map(
+        (mint) => mint.endsWith("/") ? mint.slice(0, -1) : mint
+      );
+    }
+    void driver.setItem(
+      SDK_STORAGE_KEYS.MINTS_FROM_ALL_PROVIDERS,
+      normalized
+    );
+    set({ mintsFromAllProviders: normalized });
+  },
+  setInfoFromAllProviders: (value) => {
+    const normalized = {};
+    for (const [baseUrl, info] of Object.entries(value)) {
+      normalized[normalizeBaseUrl(baseUrl)] = info;
+    }
+    void driver.setItem(SDK_STORAGE_KEYS.INFO_FROM_ALL_PROVIDERS, normalized);
+    set({ infoFromAllProviders: normalized });
+  },
+  setLastModelsUpdate: (value) => {
+    const normalized = {};
+    for (const [baseUrl, timestamp] of Object.entries(value)) {
+      normalized[normalizeBaseUrl(baseUrl)] = timestamp;
+    }
+    void driver.setItem(SDK_STORAGE_KEYS.LAST_MODELS_UPDATE, normalized);
+    set({ lastModelsUpdate: normalized });
+  },
+  setCachedTokens: (value) => {
+    set((state) => {
+      const updates = typeof value === "function" ? value(state.cachedTokens) : value;
+      const normalized = updates.map((entry) => ({
+        ...entry,
+        baseUrl: normalizeBaseUrl(entry.baseUrl),
+        balance: typeof entry.balance === "number" ? entry.balance : getCashuTokenBalance(entry.token),
+        lastUsed: entry.lastUsed ?? null
+      }));
+      void driver.setItem(SDK_STORAGE_KEYS.LOCAL_CASHU_TOKENS, normalized);
+      return { cachedTokens: normalized };
+    });
+  },
+  setApiKeys: (value) => {
+    set((state) => {
+      const updates = typeof value === "function" ? value(state.apiKeys) : value;
+      const normalized = updates.map((entry) => ({
+        ...entry,
+        baseUrl: normalizeBaseUrl(entry.baseUrl),
+        balance: entry.balance ?? 0,
+        lastUsed: entry.lastUsed ?? null
+      }));
+      void driver.setItem(SDK_STORAGE_KEYS.API_KEYS, normalized);
+      return { apiKeys: normalized };
+    });
+  },
+  setChildKeys: (value) => {
+    set((state) => {
+      const updates = typeof value === "function" ? value(state.childKeys) : value;
+      const normalized = updates.map((entry) => ({
+        parentBaseUrl: normalizeBaseUrl(entry.parentBaseUrl),
+        childKey: entry.childKey,
+        balance: entry.balance ?? 0,
+        balanceLimit: entry.balanceLimit,
+        validityDate: entry.validityDate,
+        createdAt: entry.createdAt ?? Date.now()
+      }));
+      void driver.setItem(SDK_STORAGE_KEYS.CHILD_KEYS, normalized);
+      return { childKeys: normalized };
+    });
+  },
+  setRoutstr21Models: (value) => {
+    void driver.setItem(SDK_STORAGE_KEYS.ROUTSTR21_MODELS, value);
+    set({ routstr21Models: value });
+  },
+  setRoutstr21ModelsLastUpdate: (value) => {
+    void driver.setItem(SDK_STORAGE_KEYS.LAST_ROUTSTR21_MODELS_UPDATE, value);
+    set({ lastRoutstr21ModelsUpdate: value });
+  },
+  setCachedReceiveTokens: (value) => {
+    const normalized = value.map((entry) => ({
+      token: entry.token,
+      amount: entry.amount,
+      unit: entry.unit || "sat",
+      createdAt: entry.createdAt ?? Date.now()
+    }));
+    void driver.setItem(SDK_STORAGE_KEYS.CACHED_RECEIVE_TOKENS, normalized);
+    set({ cachedReceiveTokens: normalized });
+  },
+  setUsageTracking: (value) => {
+    void driver.setItem(SDK_STORAGE_KEYS.USAGE_TRACKING, value);
+    set({ usageTracking: value });
+  },
+  setClientIds: (value) => {
+    set((state) => {
+      const updates = typeof value === "function" ? value(state.clientIds) : value;
+      const normalized = updates.map((entry) => ({
+        ...entry,
+        baseUrl: normalizeBaseUrl(entry.baseUrl),
+        createdAt: entry.createdAt ?? Date.now(),
+        lastUsed: entry.lastUsed ?? null
+      }));
+      void driver.setItem(SDK_STORAGE_KEYS.CLIENT_IDS, normalized);
+      return { clientIds: normalized };
+    });
+  }
+}));
+var hydrateStoreFromDriver = async (store, driver) => {
   const [
     rawModels,
     lastUsedModel,
@@ -3840,7 +4026,8 @@ var createSdkStore = async ({
     rawRoutstr21Models,
     rawLastRoutstr21ModelsUpdate,
     rawCachedReceiveTokens,
-    rawUsageTracking
+    rawUsageTracking,
+    rawClientIds
   ] = await Promise.all([
     driver.getItem(
       SDK_STORAGE_KEYS.MODELS_FROM_ALL_PROVIDERS,
@@ -3871,7 +4058,8 @@ var createSdkStore = async ({
       null
     ),
     driver.getItem(SDK_STORAGE_KEYS.CACHED_RECEIVE_TOKENS, []),
-    driver.getItem(SDK_STORAGE_KEYS.USAGE_TRACKING, [])
+    driver.getItem(SDK_STORAGE_KEYS.USAGE_TRACKING, []),
+    driver.getItem(SDK_STORAGE_KEYS.CLIENT_IDS, [])
   ]);
   const modelsFromAllProviders = Object.fromEntries(
     Object.entries(rawModels).map(([baseUrl, models]) => [
@@ -3930,7 +4118,13 @@ var createSdkStore = async ({
     createdAt: entry.createdAt ?? Date.now()
   }));
   const usageTracking = rawUsageTracking;
-  return createStore((set, get) => ({
+  const clientIds = rawClientIds.map((entry) => ({
+    ...entry,
+    baseUrl: normalizeBaseUrl(entry.baseUrl),
+    createdAt: entry.createdAt ?? Date.now(),
+    lastUsed: entry.lastUsed ?? null
+  }));
+  store.setState({
     modelsFromAllProviders,
     lastUsedModel,
     baseUrlsList,
@@ -3946,128 +4140,17 @@ var createSdkStore = async ({
     lastRoutstr21ModelsUpdate,
     cachedReceiveTokens,
     usageTracking,
-    setModelsFromAllProviders: (value) => {
-      const normalized = {};
-      for (const [baseUrl, models] of Object.entries(value)) {
-        normalized[normalizeBaseUrl(baseUrl)] = models;
-      }
-      void driver.setItem(
-        SDK_STORAGE_KEYS.MODELS_FROM_ALL_PROVIDERS,
-        normalized
-      );
-      set({ modelsFromAllProviders: normalized });
-    },
-    setLastUsedModel: (value) => {
-      void driver.setItem(SDK_STORAGE_KEYS.LAST_USED_MODEL, value);
-      set({ lastUsedModel: value });
-    },
-    setBaseUrlsList: (value) => {
-      const normalized = value.map((url) => normalizeBaseUrl(url));
-      void driver.setItem(SDK_STORAGE_KEYS.BASE_URLS_LIST, normalized);
-      set({ baseUrlsList: normalized });
-    },
-    setBaseUrlsLastUpdate: (value) => {
-      void driver.setItem(SDK_STORAGE_KEYS.LAST_BASE_URLS_UPDATE, value);
-      set({ lastBaseUrlsUpdate: value });
-    },
-    setDisabledProviders: (value) => {
-      const normalized = value.map((url) => normalizeBaseUrl(url));
-      void driver.setItem(SDK_STORAGE_KEYS.DISABLED_PROVIDERS, normalized);
-      set({ disabledProviders: normalized });
-    },
-    setMintsFromAllProviders: (value) => {
-      const normalized = {};
-      for (const [baseUrl, mints] of Object.entries(value)) {
-        normalized[normalizeBaseUrl(baseUrl)] = mints.map(
-          (mint) => mint.endsWith("/") ? mint.slice(0, -1) : mint
-        );
-      }
-      void driver.setItem(
-        SDK_STORAGE_KEYS.MINTS_FROM_ALL_PROVIDERS,
-        normalized
-      );
-      set({ mintsFromAllProviders: normalized });
-    },
-    setInfoFromAllProviders: (value) => {
-      const normalized = {};
-      for (const [baseUrl, info] of Object.entries(value)) {
-        normalized[normalizeBaseUrl(baseUrl)] = info;
-      }
-      void driver.setItem(SDK_STORAGE_KEYS.INFO_FROM_ALL_PROVIDERS, normalized);
-      set({ infoFromAllProviders: normalized });
-    },
-    setLastModelsUpdate: (value) => {
-      const normalized = {};
-      for (const [baseUrl, timestamp] of Object.entries(value)) {
-        normalized[normalizeBaseUrl(baseUrl)] = timestamp;
-      }
-      void driver.setItem(SDK_STORAGE_KEYS.LAST_MODELS_UPDATE, normalized);
-      set({ lastModelsUpdate: normalized });
-    },
-    setCachedTokens: (value) => {
-      set((state) => {
-        const updates = typeof value === "function" ? value(state.cachedTokens) : value;
-        const normalized = updates.map((entry) => ({
-          ...entry,
-          baseUrl: normalizeBaseUrl(entry.baseUrl),
-          balance: typeof entry.balance === "number" ? entry.balance : getCashuTokenBalance(entry.token),
-          lastUsed: entry.lastUsed ?? null
-        }));
-        void driver.setItem(SDK_STORAGE_KEYS.LOCAL_CASHU_TOKENS, normalized);
-        return { cachedTokens: normalized };
-      });
-    },
-    setApiKeys: (value) => {
-      set((state) => {
-        const updates = typeof value === "function" ? value(state.apiKeys) : value;
-        const normalized = updates.map((entry) => ({
-          ...entry,
-          baseUrl: normalizeBaseUrl(entry.baseUrl),
-          balance: entry.balance ?? 0,
-          lastUsed: entry.lastUsed ?? null
-        }));
-        void driver.setItem(SDK_STORAGE_KEYS.API_KEYS, normalized);
-        return { apiKeys: normalized };
-      });
-    },
-    setChildKeys: (value) => {
-      set((state) => {
-        const updates = typeof value === "function" ? value(state.childKeys) : value;
-        const normalized = updates.map((entry) => ({
-          parentBaseUrl: normalizeBaseUrl(entry.parentBaseUrl),
-          childKey: entry.childKey,
-          balance: entry.balance ?? 0,
-          balanceLimit: entry.balanceLimit,
-          validityDate: entry.validityDate,
-          createdAt: entry.createdAt ?? Date.now()
-        }));
-        void driver.setItem(SDK_STORAGE_KEYS.CHILD_KEYS, normalized);
-        return { childKeys: normalized };
-      });
-    },
-    setRoutstr21Models: (value) => {
-      void driver.setItem(SDK_STORAGE_KEYS.ROUTSTR21_MODELS, value);
-      set({ routstr21Models: value });
-    },
-    setRoutstr21ModelsLastUpdate: (value) => {
-      void driver.setItem(SDK_STORAGE_KEYS.LAST_ROUTSTR21_MODELS_UPDATE, value);
-      set({ lastRoutstr21ModelsUpdate: value });
-    },
-    setCachedReceiveTokens: (value) => {
-      const normalized = value.map((entry) => ({
-        token: entry.token,
-        amount: entry.amount,
-        unit: entry.unit || "sat",
-        createdAt: entry.createdAt ?? Date.now()
-      }));
-      void driver.setItem(SDK_STORAGE_KEYS.CACHED_RECEIVE_TOKENS, normalized);
-      set({ cachedReceiveTokens: normalized });
-    },
-    setUsageTracking: (value) => {
-      void driver.setItem(SDK_STORAGE_KEYS.USAGE_TRACKING, value);
-      set({ usageTracking: value });
-    }
-  }));
+    clientIds
+  });
+};
+var createSdkStore = ({
+  driver
+}) => {
+  const store = createEmptyStore(driver);
+  return {
+    store,
+    hydrate: hydrateStoreFromDriver(store, driver)
+  };
 };
 var createDiscoveryAdapterFromStore = (store) => ({
   getCachedModels: () => store.getState().modelsFromAllProviders,
@@ -4332,7 +4415,7 @@ var createProviderRegistryFromStore = (store) => ({
 });
 
 // storage/index.ts
-var isBrowser = () => {
+var isBrowser2 = () => {
   try {
     return typeof window !== "undefined" && typeof window.localStorage !== "undefined";
   } catch {
@@ -4352,7 +4435,7 @@ var isBun2 = () => {
 };
 var getDefaultSdkDriver = () => {
   if (defaultDriver) return defaultDriver;
-  if (isBrowser()) {
+  if (isBrowser2()) {
     defaultDriver = localStorageDriver;
     return defaultDriver;
   }
@@ -4367,12 +4450,12 @@ var getDefaultSdkDriver = () => {
   defaultDriver = createMemoryDriver();
   return defaultDriver;
 };
-var defaultStorePromise = null;
+var defaultStore = null;
 var getDefaultSdkStore = () => {
-  if (!defaultStorePromise) {
-    defaultStorePromise = createSdkStore({ driver: getDefaultSdkDriver() });
+  if (!defaultStore) {
+    defaultStore = createSdkStore({ driver: getDefaultSdkDriver() });
   }
-  return defaultStorePromise;
+  return defaultStore.hydrate.then(() => defaultStore.store);
 };
 var getDefaultDiscoveryAdapter = async () => createDiscoveryAdapterFromStore(await getDefaultSdkStore());
 var getDefaultStorageAdapter = async () => createStorageAdapterFromStore(await getDefaultSdkStore());
@@ -4393,7 +4476,8 @@ async function routeRequests(options) {
     torMode = false,
     forceRefresh = false,
     modelManager: providedModelManager,
-    debugLevel
+    debugLevel,
+    mode = "apikeys"
   } = options;
   let modelManager;
   let providers;
@@ -4458,7 +4542,7 @@ async function routeRequests(options) {
     storageAdapter,
     providerRegistry,
     alertLevel,
-    "apikeys"
+    mode
   );
   if (debugLevel) {
     client.setDebugLevel(debugLevel);