@routstr/sdk 0.2.5 → 0.2.6

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 { U as UsageTrackingDriver, S as SdkStore } from '../store-C5lnyX8k.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
@@ -163,7 +166,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 +176,15 @@ interface RouteRequestParams {
     baseUrl: string;
     mintUrl: string;
     modelId?: string;
+    clientApiKey?: string;
 }
 interface RouteRequestToNodeResponseParams extends RouteRequestParams {
     res: ServerResponse;
 }
+interface RoutstrClientConfig {
+    usageTrackingDriver?: UsageTrackingDriver;
+    sdkStore?: SdkStore;
+}
 declare class RoutstrClient {
     private walletAdapter;
     private storageAdapter;
@@ -188,7 +196,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 +233,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 +267,7 @@ declare class RoutstrClient {
      */
     private _getEstimatedCosts;
     /**
-     * Get pending cashu token amount
+     * Get pending API key amount
      */
     private _getPendingCashuTokenAmount;
     /**
@@ -346,4 +360,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 { U as UsageTrackingDriver, S as SdkStore } from '../store-BJlwiDX5.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
@@ -163,7 +166,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 +176,15 @@ interface RouteRequestParams {
     baseUrl: string;
     mintUrl: string;
     modelId?: string;
+    clientApiKey?: string;
 }
 interface RouteRequestToNodeResponseParams extends RouteRequestParams {
     res: ServerResponse;
 }
+interface RoutstrClientConfig {
+    usageTrackingDriver?: UsageTrackingDriver;
+    sdkStore?: SdkStore;
+}
 declare class RoutstrClient {
     private walletAdapter;
     private storageAdapter;
@@ -188,7 +196,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 +233,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 +267,7 @@ declare class RoutstrClient {
      */
     private _getEstimatedCosts;
     /**
-     * Get pending cashu token amount
+     * Get pending API key amount
      */
     private _getPendingCashuTokenAmount;
     /**
@@ -346,4 +360,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 };