@routstr/sdk 0.2.5 → 0.2.7

package/README.md

@@ -70,10 +70,9 @@ await client.fetchAIResponse(fetchOptions, streamingCallbacks);
 
 ## Client Modes
 
-The `RoutstrClient` supports three modes via the constructor `mode` parameter (defaults to `"xcashu"` if unspecified):
+The `RoutstrClient` supports two modes via the constructor `mode` parameter (defaults to `"xcashu"` if unspecified):
 
 - `"xcashu"` — Default mode. Uses standard Cashu token spending with refunds.
-- `"lazyrefund"` — Defers refund processing to reduce mint load; may retain tokens longer before refunding.
 - `"apikeys"` — Uses API key authentication instead of Cashu tokens; no token spending or refund flow.
 
 ```ts

package/dist/client/index.d.mts

@@ -1,8 +1,11 @@
 import { M as Model, a as Message, T as TransactionHistory, l as StreamingResult } from '../types-BYj_8c5c.mjs';
-import { P as ProviderRegistry, W as WalletAdapter, S as StorageAdapter, a as StreamingCallbacks } from '../interfaces-C6Dr6hKy.mjs';
+import { P as ProviderRegistry, W as WalletAdapter, S as StorageAdapter, a as StreamingCallbacks } from '../interfaces-C5fLD3jB.mjs';
+import { S as SdkStore, U as UsageTrackingDriver } from '../store-DGeLPv9E.mjs';
 import { ServerResponse } from 'http';
 import { CashuSpender, BalanceManager } from '../wallet/index.mjs';
 import { Transform } from 'stream';
+import 'zustand/vanilla';
+import '../interfaces-BWJJTCXO.mjs';
 
 /**
  * ProviderManager - Handles provider selection and failover logic
@@ -32,7 +35,19 @@ declare class ProviderManager {
     private providersOnCoolDown;
     /** Cooldown duration in milliseconds (5 minutes) */
     private static readonly COOLDOWN_DURATION_MS;
-    constructor(providerRegistry: ProviderRegistry);
+    /** Optional persistent store for failure tracking */
+    private store;
+    /** Instance ID for debugging */
+    private readonly instanceId;
+    constructor(providerRegistry: ProviderRegistry, store?: SdkStore);
+    /**
+     * Hydrate in-memory state from persistent store
+     */
+    private hydrateFromStore;
+    /**
+     * Get instance ID for debugging
+     */
+    getInstanceId(): string;
     /**
      * Clean up expired cooldown entries
      */
@@ -163,7 +178,7 @@ interface FetchOptions {
  * RoutstrClient is the main SDK entry point
  */
 type AlertLevel = "max" | "min";
-type RoutstrClientMode = "xcashu" | "lazyrefund" | "apikeys";
+type RoutstrClientMode = "xcashu" | "apikeys";
 type DebugLevel = "DEBUG" | "WARN" | "ERROR";
 interface RouteRequestParams {
     path: string;
@@ -173,10 +188,17 @@ interface RouteRequestParams {
     baseUrl: string;
     mintUrl: string;
     modelId?: string;
+    clientApiKey?: string;
 }
 interface RouteRequestToNodeResponseParams extends RouteRequestParams {
     res: ServerResponse;
 }
+interface RoutstrClientConfig {
+    usageTrackingDriver?: UsageTrackingDriver;
+    sdkStore?: SdkStore;
+    /** Optional: shared ProviderManager instance for consistent failure tracking across requests */
+    providerManager?: ProviderManager;
+}
 declare class RoutstrClient {
     private walletAdapter;
     private storageAdapter;
@@ -188,7 +210,9 @@ declare class RoutstrClient {
     private alertLevel;
     private mode;
     private debugLevel;
-    constructor(walletAdapter: WalletAdapter, storageAdapter: StorageAdapter, providerRegistry: ProviderRegistry, alertLevel: AlertLevel, mode?: RoutstrClientMode);
+    private usageTrackingDriver?;
+    private sdkStore?;
+    constructor(walletAdapter: WalletAdapter, storageAdapter: StorageAdapter, providerRegistry: ProviderRegistry, alertLevel: AlertLevel, mode?: RoutstrClientMode, options?: RoutstrClientConfig);
     /**
      * Get the current client mode
      */
@@ -223,6 +247,10 @@ declare class RoutstrClient {
     routeRequest(params: RouteRequestParams): Promise<Response>;
     routeRequestToNodeResponse(params: RouteRequestToNodeResponseParams): Promise<void>;
     private _prepareRoutedRequest;
+    /**
+     * Extract clientApiKey from Authorization Bearer token if present
+     */
+    private _extractClientApiKey;
     /**
      * Fetch AI response with streaming
      */
@@ -253,7 +281,7 @@ declare class RoutstrClient {
      */
     private _getEstimatedCosts;
     /**
-     * Get pending cashu token amount
+     * Get pending API key amount
      */
     private _getPendingCashuTokenAmount;
     /**
@@ -346,4 +374,4 @@ interface UsageTrackingData {
 
 declare function createSSEParserTransform(onUsage: (usage: UsageTrackingData) => void, onResponseId?: (responseId: string) => void): Transform;
 
-export { type AlertLevel, type DebugLevel, type FetchOptions, type ModelProviderPrice, ProviderManager, type RouteRequestParams, type RouteRequestToNodeResponseParams, RoutstrClient, type RoutstrClientMode, type StreamCallbacks, StreamProcessor, createSSEParserTransform };
+export { type AlertLevel, type DebugLevel, type FetchOptions, type ModelProviderPrice, ProviderManager, type RouteRequestParams, type RouteRequestToNodeResponseParams, RoutstrClient, type RoutstrClientConfig, type RoutstrClientMode, type StreamCallbacks, StreamProcessor, createSSEParserTransform };

package/dist/client/index.d.ts

@@ -1,8 +1,11 @@
 import { M as Model, a as Message, T as TransactionHistory, l as StreamingResult } from '../types-BYj_8c5c.js';
-import { P as ProviderRegistry, W as WalletAdapter, S as StorageAdapter, a as StreamingCallbacks } from '../interfaces-CluftN4z.js';
+import { P as ProviderRegistry, W as WalletAdapter, S as StorageAdapter, a as StreamingCallbacks } from '../interfaces-B62Rw-dd.js';
+import { S as SdkStore, U as UsageTrackingDriver } from '../store-h7m23ffq.js';
 import { ServerResponse } from 'http';
 import { CashuSpender, BalanceManager } from '../wallet/index.js';
 import { Transform } from 'stream';
+import 'zustand/vanilla';
+import '../interfaces-BxDEka72.js';
 
 /**
  * ProviderManager - Handles provider selection and failover logic
@@ -32,7 +35,19 @@ declare class ProviderManager {
     private providersOnCoolDown;
     /** Cooldown duration in milliseconds (5 minutes) */
     private static readonly COOLDOWN_DURATION_MS;
-    constructor(providerRegistry: ProviderRegistry);
+    /** Optional persistent store for failure tracking */
+    private store;
+    /** Instance ID for debugging */
+    private readonly instanceId;
+    constructor(providerRegistry: ProviderRegistry, store?: SdkStore);
+    /**
+     * Hydrate in-memory state from persistent store
+     */
+    private hydrateFromStore;
+    /**
+     * Get instance ID for debugging
+     */
+    getInstanceId(): string;
     /**
      * Clean up expired cooldown entries
      */
@@ -163,7 +178,7 @@ interface FetchOptions {
  * RoutstrClient is the main SDK entry point
  */
 type AlertLevel = "max" | "min";
-type RoutstrClientMode = "xcashu" | "lazyrefund" | "apikeys";
+type RoutstrClientMode = "xcashu" | "apikeys";
 type DebugLevel = "DEBUG" | "WARN" | "ERROR";
 interface RouteRequestParams {
     path: string;
@@ -173,10 +188,17 @@ interface RouteRequestParams {
     baseUrl: string;
     mintUrl: string;
     modelId?: string;
+    clientApiKey?: string;
 }
 interface RouteRequestToNodeResponseParams extends RouteRequestParams {
     res: ServerResponse;
 }
+interface RoutstrClientConfig {
+    usageTrackingDriver?: UsageTrackingDriver;
+    sdkStore?: SdkStore;
+    /** Optional: shared ProviderManager instance for consistent failure tracking across requests */
+    providerManager?: ProviderManager;
+}
 declare class RoutstrClient {
     private walletAdapter;
     private storageAdapter;
@@ -188,7 +210,9 @@ declare class RoutstrClient {
     private alertLevel;
     private mode;
     private debugLevel;
-    constructor(walletAdapter: WalletAdapter, storageAdapter: StorageAdapter, providerRegistry: ProviderRegistry, alertLevel: AlertLevel, mode?: RoutstrClientMode);
+    private usageTrackingDriver?;
+    private sdkStore?;
+    constructor(walletAdapter: WalletAdapter, storageAdapter: StorageAdapter, providerRegistry: ProviderRegistry, alertLevel: AlertLevel, mode?: RoutstrClientMode, options?: RoutstrClientConfig);
     /**
      * Get the current client mode
      */
@@ -223,6 +247,10 @@ declare class RoutstrClient {
     routeRequest(params: RouteRequestParams): Promise<Response>;
     routeRequestToNodeResponse(params: RouteRequestToNodeResponseParams): Promise<void>;
     private _prepareRoutedRequest;
+    /**
+     * Extract clientApiKey from Authorization Bearer token if present
+     */
+    private _extractClientApiKey;
     /**
      * Fetch AI response with streaming
      */
@@ -253,7 +281,7 @@ declare class RoutstrClient {
      */
     private _getEstimatedCosts;
     /**
-     * Get pending cashu token amount
+     * Get pending API key amount
      */
     private _getPendingCashuTokenAmount;
     /**
@@ -346,4 +374,4 @@ interface UsageTrackingData {
 
 declare function createSSEParserTransform(onUsage: (usage: UsageTrackingData) => void, onResponseId?: (responseId: string) => void): Transform;
 
-export { type AlertLevel, type DebugLevel, type FetchOptions, type ModelProviderPrice, ProviderManager, type RouteRequestParams, type RouteRequestToNodeResponseParams, RoutstrClient, type RoutstrClientMode, type StreamCallbacks, StreamProcessor, createSSEParserTransform };
+export { type AlertLevel, type DebugLevel, type FetchOptions, type ModelProviderPrice, ProviderManager, type RouteRequestParams, type RouteRequestToNodeResponseParams, RoutstrClient, type RoutstrClientConfig, type RoutstrClientMode, type StreamCallbacks, StreamProcessor, createSSEParserTransform };