@routstr/sdk 0.2.4 → 0.2.5

package/README.md

@@ -25,10 +25,19 @@ This SDK lives under `sdk/` and exposes a framework-agnostic surface for Routstr
 - `sdk/storage/index.ts` exposes:
   - `getDefaultSdkDriver()` (localStorage -> sqlite -> memory)
   - `getDefaultSdkStore()`
+  - `getDefaultUsageTrackingDriver()`
   - `getDefaultDiscoveryAdapter()`
   - `getDefaultStorageAdapter()`
   - `getDefaultProviderRegistry()`
 
+Usage tracking is now stored separately from the Zustand-backed SDK state:
+
+- browser: IndexedDB usage-tracking object store
+- node: SQLite usage-tracking table
+- bun/ephemeral: in-memory usage-tracking driver
+
+The usage tracking driver also exposes `migrate()` so apps can proactively move legacy blob data into the new backend during startup instead of waiting for the first append/read operation.
+
 ## Minimal Usage
 
 ```ts

package/dist/client/index.d.mts

@@ -1,6 +1,8 @@
-import { M as Model, a as Message, T as TransactionHistory, l as StreamingResult } from '../types-BlHjmWRK.mjs';
-import { P as ProviderRegistry, W as WalletAdapter, S as StorageAdapter, a as StreamingCallbacks } from '../interfaces-B85Wx7ni.mjs';
+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 { ServerResponse } from 'http';
 import { CashuSpender, BalanceManager } from '../wallet/index.mjs';
+import { Transform } from 'stream';
 
 /**
  * ProviderManager - Handles provider selection and failover logic
@@ -172,6 +174,9 @@ interface RouteRequestParams {
     mintUrl: string;
     modelId?: string;
 }
+interface RouteRequestToNodeResponseParams extends RouteRequestParams {
+    res: ServerResponse;
+}
 declare class RoutstrClient {
     private walletAdapter;
     private storageAdapter;
@@ -216,6 +221,8 @@ declare class RoutstrClient {
      * requests and get responses back.
      */
     routeRequest(params: RouteRequestParams): Promise<Response>;
+    routeRequestToNodeResponse(params: RouteRequestToNodeResponseParams): Promise<void>;
+    private _prepareRoutedRequest;
     /**
      * Fetch AI response with streaming
      */
@@ -232,6 +239,7 @@ declare class RoutstrClient {
      * Handle post-response balance update for all modes
      */
     private _handlePostResponseBalanceUpdate;
+    private _trackResponseUsage;
     /**
      * Convert messages for API format
      */
@@ -240,11 +248,6 @@ declare class RoutstrClient {
      * Create assistant message from streaming result
      */
     private _createAssistantMessage;
-    /**
-     * Create a child key for a parent API key via the provider's API
-     * POST /v1/balance/child-key
-     */
-    private _createChildKey;
     /**
      * Calculate estimated costs from usage
      */
@@ -333,4 +336,14 @@ declare class StreamProcessor {
     private _mergeImages;
 }
 
-export { type AlertLevel, type DebugLevel, type FetchOptions, type ModelProviderPrice, ProviderManager, type RouteRequestParams, RoutstrClient, type RoutstrClientMode, type StreamCallbacks, StreamProcessor };
+interface UsageTrackingData {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+    cost: number;
+    satsCost: number;
+}
+
+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 };

package/dist/client/index.d.ts

@@ -1,6 +1,8 @@
-import { M as Model, a as Message, T as TransactionHistory, l as StreamingResult } from '../types-BlHjmWRK.js';
-import { P as ProviderRegistry, W as WalletAdapter, S as StorageAdapter, a as StreamingCallbacks } from '../interfaces-BVNyAmKu.js';
+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 { ServerResponse } from 'http';
 import { CashuSpender, BalanceManager } from '../wallet/index.js';
+import { Transform } from 'stream';
 
 /**
  * ProviderManager - Handles provider selection and failover logic
@@ -172,6 +174,9 @@ interface RouteRequestParams {
     mintUrl: string;
     modelId?: string;
 }
+interface RouteRequestToNodeResponseParams extends RouteRequestParams {
+    res: ServerResponse;
+}
 declare class RoutstrClient {
     private walletAdapter;
     private storageAdapter;
@@ -216,6 +221,8 @@ declare class RoutstrClient {
      * requests and get responses back.
      */
     routeRequest(params: RouteRequestParams): Promise<Response>;
+    routeRequestToNodeResponse(params: RouteRequestToNodeResponseParams): Promise<void>;
+    private _prepareRoutedRequest;
     /**
      * Fetch AI response with streaming
      */
@@ -232,6 +239,7 @@ declare class RoutstrClient {
      * Handle post-response balance update for all modes
      */
     private _handlePostResponseBalanceUpdate;
+    private _trackResponseUsage;
     /**
      * Convert messages for API format
      */
@@ -240,11 +248,6 @@ declare class RoutstrClient {
      * Create assistant message from streaming result
      */
     private _createAssistantMessage;
-    /**
-     * Create a child key for a parent API key via the provider's API
-     * POST /v1/balance/child-key
-     */
-    private _createChildKey;
     /**
      * Calculate estimated costs from usage
      */
@@ -333,4 +336,14 @@ declare class StreamProcessor {
     private _mergeImages;
 }
 
-export { type AlertLevel, type DebugLevel, type FetchOptions, type ModelProviderPrice, ProviderManager, type RouteRequestParams, RoutstrClient, type RoutstrClientMode, type StreamCallbacks, StreamProcessor };
+interface UsageTrackingData {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+    cost: number;
+    satsCost: number;
+}
+
+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 };