@routstr/sdk 0.1.7 → 0.2.0

package/dist/storage/index.d.mts

@@ -45,6 +45,29 @@ interface SdkStorageState {
         unit: "sat" | "msat";
         createdAt: number;
     }>;
+    usageTracking: Array<{
+        id: string;
+        timestamp: number;
+        modelId: string;
+        baseUrl: string;
+        requestId: string;
+        cost: number;
+        satsCost: number;
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+        client?: string;
+        sessionId?: string;
+        tags?: string[];
+    }>;
+    clientIds: Array<{
+        clientId: string;
+        name: string;
+        apiKey: string;
+        baseUrl: string;
+        createdAt: number;
+        lastUsed?: number | null;
+    }>;
 }
 
 declare const localStorageDriver: StorageDriver;
@@ -103,10 +126,36 @@ interface SdkStorageStore extends SdkStorageState {
         unit: "sat" | "msat";
         createdAt?: number;
     }>) => void;
+    setUsageTracking: (value: Array<{
+        id: string;
+        timestamp: number;
+        modelId: string;
+        baseUrl: string;
+        requestId: string;
+        cost: number;
+        satsCost: number;
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+        client?: string;
+        sessionId?: string;
+        tags?: string[];
+    }>) => void;
+    setClientIds: (value: Array<{
+        clientId: string;
+        name: string;
+        apiKey: string;
+        baseUrl: string;
+        createdAt?: number;
+        lastUsed?: number | null;
+    }> | ((current: SdkStorageStore["clientIds"]) => SdkStorageStore["clientIds"])) => void;
 }
 /** Store type returned after async initialization */
 type SdkStore = StoreApi<SdkStorageStore>;
-declare const createSdkStore: ({ driver, }: SdkStoreOptions) => Promise<SdkStore>;
+declare const createSdkStore: ({ driver, }: SdkStoreOptions) => {
+    store: SdkStore;
+    hydrate: Promise<void>;
+};
 declare const createDiscoveryAdapterFromStore: (store: SdkStore) => DiscoveryAdapter;
 declare const createStorageAdapterFromStore: (store: SdkStore) => StorageAdapter;
 declare const createProviderRegistryFromStore: (store: SdkStore) => ProviderRegistry;
@@ -126,6 +175,8 @@ declare const SDK_STORAGE_KEYS: {
     readonly ROUTSTR21_MODELS: "routstr21Models";
     readonly LAST_ROUTSTR21_MODELS_UPDATE: "lastRoutstr21ModelsUpdate";
     readonly CACHED_RECEIVE_TOKENS: "cached_receive_tokens";
+    readonly USAGE_TRACKING: "usage_tracking";
+    readonly CLIENT_IDS: "client_ids";
 };
 
 declare const getDefaultSdkDriver: () => StorageDriver;

package/dist/storage/index.d.ts

@@ -45,6 +45,29 @@ interface SdkStorageState {
         unit: "sat" | "msat";
         createdAt: number;
     }>;
+    usageTracking: Array<{
+        id: string;
+        timestamp: number;
+        modelId: string;
+        baseUrl: string;
+        requestId: string;
+        cost: number;
+        satsCost: number;
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+        client?: string;
+        sessionId?: string;
+        tags?: string[];
+    }>;
+    clientIds: Array<{
+        clientId: string;
+        name: string;
+        apiKey: string;
+        baseUrl: string;
+        createdAt: number;
+        lastUsed?: number | null;
+    }>;
 }
 
 declare const localStorageDriver: StorageDriver;
@@ -103,10 +126,36 @@ interface SdkStorageStore extends SdkStorageState {
         unit: "sat" | "msat";
         createdAt?: number;
     }>) => void;
+    setUsageTracking: (value: Array<{
+        id: string;
+        timestamp: number;
+        modelId: string;
+        baseUrl: string;
+        requestId: string;
+        cost: number;
+        satsCost: number;
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+        client?: string;
+        sessionId?: string;
+        tags?: string[];
+    }>) => void;
+    setClientIds: (value: Array<{
+        clientId: string;
+        name: string;
+        apiKey: string;
+        baseUrl: string;
+        createdAt?: number;
+        lastUsed?: number | null;
+    }> | ((current: SdkStorageStore["clientIds"]) => SdkStorageStore["clientIds"])) => void;
 }
 /** Store type returned after async initialization */
 type SdkStore = StoreApi<SdkStorageStore>;
-declare const createSdkStore: ({ driver, }: SdkStoreOptions) => Promise<SdkStore>;
+declare const createSdkStore: ({ driver, }: SdkStoreOptions) => {
+    store: SdkStore;
+    hydrate: Promise<void>;
+};
 declare const createDiscoveryAdapterFromStore: (store: SdkStore) => DiscoveryAdapter;
 declare const createStorageAdapterFromStore: (store: SdkStore) => StorageAdapter;
 declare const createProviderRegistryFromStore: (store: SdkStore) => ProviderRegistry;
@@ -126,6 +175,8 @@ declare const SDK_STORAGE_KEYS: {
     readonly ROUTSTR21_MODELS: "routstr21Models";
     readonly LAST_ROUTSTR21_MODELS_UPDATE: "lastRoutstr21ModelsUpdate";
     readonly CACHED_RECEIVE_TOKENS: "cached_receive_tokens";
+    readonly USAGE_TRACKING: "usage_tracking";
+    readonly CLIENT_IDS: "client_ids";
 };
 
 declare const getDefaultSdkDriver: () => StorageDriver;

package/dist/storage/index.js

@@ -187,7 +187,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 = () => {
@@ -291,7 +295,9 @@ var SDK_STORAGE_KEYS = {
   CHILD_KEYS: "child_keys",
   ROUTSTR21_MODELS: "routstr21Models",
   LAST_ROUTSTR21_MODELS_UPDATE: "lastRoutstr21ModelsUpdate",
-  CACHED_RECEIVE_TOKENS: "cached_receive_tokens"
+  CACHED_RECEIVE_TOKENS: "cached_receive_tokens",
+  USAGE_TRACKING: "usage_tracking",
+  CLIENT_IDS: "client_ids"
 };
 
 // storage/store.ts
@@ -309,9 +315,159 @@ var getCashuTokenBalance = (token) => {
     return 0;
   }
 };
-var createSdkStore = async ({
-  driver
-}) => {
+var createEmptyStore = (driver) => vanilla.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,
@@ -326,7 +482,9 @@ var createSdkStore = async ({
     rawChildKeys,
     rawRoutstr21Models,
     rawLastRoutstr21ModelsUpdate,
-    rawCachedReceiveTokens
+    rawCachedReceiveTokens,
+    rawUsageTracking,
+    rawClientIds
   ] = await Promise.all([
     driver.getItem(
       SDK_STORAGE_KEYS.MODELS_FROM_ALL_PROVIDERS,
@@ -356,7 +514,9 @@ var createSdkStore = async ({
       SDK_STORAGE_KEYS.LAST_ROUTSTR21_MODELS_UPDATE,
       null
     ),
-    driver.getItem(SDK_STORAGE_KEYS.CACHED_RECEIVE_TOKENS, [])
+    driver.getItem(SDK_STORAGE_KEYS.CACHED_RECEIVE_TOKENS, []),
+    driver.getItem(SDK_STORAGE_KEYS.USAGE_TRACKING, []),
+    driver.getItem(SDK_STORAGE_KEYS.CLIENT_IDS, [])
   ]);
   const modelsFromAllProviders = Object.fromEntries(
     Object.entries(rawModels).map(([baseUrl, models]) => [
@@ -414,7 +574,14 @@ var createSdkStore = async ({
     unit: entry.unit || "sat",
     createdAt: entry.createdAt ?? Date.now()
   }));
-  return vanilla.createStore((set, get) => ({
+  const usageTracking = rawUsageTracking;
+  const clientIds = rawClientIds.map((entry) => ({
+    ...entry,
+    baseUrl: normalizeBaseUrl(entry.baseUrl),
+    createdAt: entry.createdAt ?? Date.now(),
+    lastUsed: entry.lastUsed ?? null
+  }));
+  store.setState({
     modelsFromAllProviders,
     lastUsedModel,
     baseUrlsList,
@@ -429,124 +596,18 @@ var createSdkStore = async ({
     routstr21Models,
     lastRoutstr21ModelsUpdate,
     cachedReceiveTokens,
-    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 });
-    }
-  }));
+    usageTracking,
+    clientIds
+  });
+};
+var createSdkStore = ({
+  driver
+}) => {
+  const store = createEmptyStore(driver);
+  return {
+    store,
+    hydrate: hydrateStoreFromDriver(store, driver)
+  };
 };
 var createDiscoveryAdapterFromStore = (store) => ({
   getCachedModels: () => store.getState().modelsFromAllProviders,
@@ -811,7 +872,7 @@ var createProviderRegistryFromStore = (store) => ({
 });
 
 // storage/index.ts
-var isBrowser = () => {
+var isBrowser2 = () => {
   try {
     return typeof window !== "undefined" && typeof window.localStorage !== "undefined";
   } catch {
@@ -831,7 +892,7 @@ var isBun2 = () => {
 };
 var getDefaultSdkDriver = () => {
   if (defaultDriver) return defaultDriver;
-  if (isBrowser()) {
+  if (isBrowser2()) {
     defaultDriver = localStorageDriver;
     return defaultDriver;
   }
@@ -846,12 +907,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());