@routstr/sdk 0.3.9 → 0.3.11

package/dist/bunSqlite-BmXWNc25.d.ts

@@ -0,0 +1,18 @@
+import { a as StorageDriver, c as UsageTrackingDriver } from './store-CAQLSbEj.js';
+import { S as SdkLogger } from './types-_21yYFZG.js';
+
+declare function createBunSqliteDriver(dbPath: string, options?: {
+    logger?: SdkLogger;
+}): Promise<StorageDriver>;
+
+interface BunSqliteUsageTrackingDriverOptions {
+    dbPath?: string;
+    tableName?: string;
+    legacyStorageDriver?: StorageDriver;
+    sqlite?: {
+        Database: any;
+    };
+}
+declare const createBunSqliteUsageTrackingDriver: (options?: BunSqliteUsageTrackingDriverOptions) => UsageTrackingDriver;
+
+export { type BunSqliteUsageTrackingDriverOptions as B, createBunSqliteUsageTrackingDriver as a, createBunSqliteDriver as c };

package/dist/bunSqlite-Bro9efsl.d.mts

@@ -0,0 +1,18 @@
+import { a as StorageDriver, c as UsageTrackingDriver } from './store-CuXwe5Rg.mjs';
+import { S as SdkLogger } from './types-_21yYFZG.mjs';
+
+declare function createBunSqliteDriver(dbPath: string, options?: {
+    logger?: SdkLogger;
+}): Promise<StorageDriver>;
+
+interface BunSqliteUsageTrackingDriverOptions {
+    dbPath?: string;
+    tableName?: string;
+    legacyStorageDriver?: StorageDriver;
+    sqlite?: {
+        Database: any;
+    };
+}
+declare const createBunSqliteUsageTrackingDriver: (options?: BunSqliteUsageTrackingDriverOptions) => UsageTrackingDriver;
+
+export { type BunSqliteUsageTrackingDriverOptions as B, createBunSqliteUsageTrackingDriver as a, createBunSqliteDriver as c };

package/dist/client/index.d.mts

@@ -1,6 +1,6 @@
-import { e as Model, S as SdkLogger, M as Message, n as TransactionHistory, m as StreamingResult } from '../types-_21yYFZG.mjs';
+import { e as Model, S as SdkLogger, m as StreamingResult, U as UsageStats, M as Message, n as TransactionHistory } from '../types-_21yYFZG.mjs';
 import { P as ProviderRegistry, W as WalletAdapter, S as StorageAdapter, a as StreamingCallbacks } from '../interfaces-Csn8Uq04.mjs';
-import { S as SdkStore, U as UsageTrackingDriver } from '../store-C6dfj1cc.mjs';
+import { S as SdkStore, c as UsageTrackingDriver } from '../store-CuXwe5Rg.mjs';
 import { CashuSpender, BalanceManager } from '../wallet/index.mjs';
 import { Transform } from 'stream';
 import 'zustand/vanilla';
@@ -25,6 +25,9 @@ interface ModelProviderPrice {
     completionPerMillion: number;
     totalPerMillion: number;
 }
+/**
+ * ProviderManager handles provider selection and failover
+ */
 declare class ProviderManager {
     private providerRegistry;
     private failedProviders;
@@ -162,19 +165,6 @@ declare class ProviderManager {
  * Extracted from utils/apiUtils.ts
  */
 
-/**
- * Options for fetching AI response
- */
-interface FetchOptions {
-    messageHistory: Message[];
-    selectedModel: Model;
-    baseUrl: string;
-    mintUrl: string;
-    balance: number;
-    transactionHistory: TransactionHistory[];
-    maxTokens?: number;
-    headers?: Record<string, string>;
-}
 /**
  * RoutstrClient is the main SDK entry point
  */
@@ -191,6 +181,23 @@ interface RouteRequestParams {
     modelId?: string;
     clientApiKey?: string;
 }
+interface RequestResponseLogRequestInput {
+    method: string;
+    url: string;
+    path: string;
+    baseUrl: string;
+    headers: Record<string, string>;
+    body?: unknown;
+    rawBody?: string;
+}
+interface RequestResponseLogSink {
+    logRequest?(input: RequestResponseLogRequestInput): string | undefined | Promise<string | undefined>;
+    logResponseStart?(id: string | undefined, response: Response): void | Promise<void>;
+    logResponseChunk?(id: string | undefined, sequence: number, text: string): void | Promise<void>;
+    logResponseEnd?(id: string | undefined): void | Promise<void>;
+    logResponseError?(id: string | undefined, error: unknown): void | Promise<void>;
+    logResponseBody?(id: string | undefined, response: Response): void | Promise<void>;
+}
 interface RoutstrClientConfig {
     usageTrackingDriver?: UsageTrackingDriver;
     sdkStore?: SdkStore;
@@ -198,6 +205,8 @@ interface RoutstrClientConfig {
     providerManager?: ProviderManager;
     /** Optional: injectable logger (defaults to consoleLogger) */
     logger?: SdkLogger;
+    /** Optional: raw request/response logging callbacks supplied by the runtime/app. */
+    requestResponseLogSink?: RequestResponseLogSink;
 }
 declare class RoutstrClient {
     private walletAdapter;
@@ -205,7 +214,6 @@ declare class RoutstrClient {
     private providerRegistry;
     private cashuSpender;
     private balanceManager;
-    private streamProcessor;
     private providerManager;
     private alertLevel;
     private mode;
@@ -213,6 +221,7 @@ declare class RoutstrClient {
     private usageTrackingDriver?;
     private sdkStore?;
     private logger;
+    private requestResponseLogSink?;
     constructor(walletAdapter: WalletAdapter, storageAdapter: StorageAdapter, providerRegistry: ProviderRegistry, alertLevel: AlertLevel, mode?: RoutstrClientMode, options?: RoutstrClientConfig);
     /**
      * Get the current client mode
@@ -251,10 +260,6 @@ declare class RoutstrClient {
      * Extract clientApiKey from Authorization Bearer token if present
      */
     private _extractClientApiKey;
-    /**
-     * Fetch AI response with streaming
-     */
-    fetchAIResponse(options: FetchOptions, callbacks: StreamingCallbacks): Promise<void>;
     /**
      * Make the API request with failover support
      */
@@ -268,26 +273,6 @@ declare class RoutstrClient {
      */
     private _handlePostResponseBalanceUpdate;
     private _trackResponseUsage;
-    /**
-     * Convert messages for API format
-     */
-    private _convertMessages;
-    /**
-     * Create assistant message from streaming result
-     */
-    private _createAssistantMessage;
-    /**
-     * Calculate estimated costs from usage
-     */
-    private _getEstimatedCosts;
-    /**
-     * Get pending API key amount
-     */
-    private _getPendingCashuTokenAmount;
-    /**
-     * Handle errors and notify callbacks
-     */
-    private _handleError;
     /**
      * Check wallet balance and throw if insufficient
      */
@@ -370,7 +355,24 @@ interface UsageTrackingData {
     totalTokens: number;
     cost: number;
     satsCost: number;
+    /** Upstream provider/route that handled the request (e.g. "openrouter:openrouter:Anthropic"). */
+    provider?: string;
+    /** Full cost breakdown emitted by the upstream `cost` object. */
+    baseMsats?: number;
+    inputMsats?: number;
+    outputMsats?: number;
+    totalMsats?: number;
+    totalUsd?: number;
+    cacheReadInputTokens?: number;
+    cacheCreationInputTokens?: number;
+    cacheReadMsats?: number;
+    cacheCreationMsats?: number;
+    remainingBalanceMsats?: number;
 }
+declare function extractUsageFromResponseBody(body: unknown, fallbackSatsCost?: number): UsageTrackingData | null;
+declare function extractResponseId(body: unknown): string | undefined;
+declare function extractUsageFromSSEJson(parsed: any, fallbackSatsCost?: number): UsageTrackingData | null;
+declare function toUsageStats(usage: UsageTrackingData | null | undefined): UsageStats | undefined;
 
 /**
  * Inspect a Web `ReadableStream<Uint8Array>` of SSE bytes for `usage` and
@@ -385,7 +387,10 @@ interface UsageTrackingData {
  * The returned Promise resolves with the final captured values once the
  * stream ends (or is cancelled / errors out).
  */
-declare function inspectSSEWebStream(stream: ReadableStream<Uint8Array>, onUsage: (usage: UsageTrackingData) => void, onResponseId?: (responseId: string) => void): Promise<{
+declare function inspectSSEWebStream(stream: ReadableStream<Uint8Array>, onUsage: (usage: UsageTrackingData) => void, onResponseId?: (responseId: string) => void, options?: {
+    /** Called with each raw chunk read from the tee'd inspection branch. */
+    onRawChunk?: (chunk: Uint8Array, sequence: number, text: string) => void | Promise<void>;
+}): Promise<{
     capturedUsage?: UsageTrackingData;
     capturedResponseId?: string;
 }>;
@@ -408,4 +413,42 @@ declare function inspectSSEWebStream(stream: ReadableStream<Uint8Array>, onUsage
  */
 declare function createSSEParserTransform(onUsage: (usage: UsageTrackingData) => void, onResponseId?: (responseId: string) => void): Transform;
 
-export { type AlertLevel, type DebugLevel, type FetchOptions, type ModelProviderPrice, ProviderManager, type RouteRequestParams, RoutstrClient, type RoutstrClientConfig, type RoutstrClientMode, type StreamCallbacks, StreamProcessor, createSSEParserTransform, inspectSSEWebStream };
+/**
+ * Options for fetching AI response
+ */
+interface FetchOptions {
+    messageHistory: Message[];
+    selectedModel: Model;
+    baseUrl: string;
+    mintUrl: string;
+    balance: number;
+    transactionHistory: TransactionHistory[];
+    maxTokens?: number;
+    headers?: Record<string, string>;
+}
+interface FetchAIResponseClient {
+    routeRequest(params: {
+        path: string;
+        method: string;
+        body?: unknown;
+        headers?: Record<string, string>;
+        baseUrl: string;
+        mintUrl: string;
+        modelId?: string;
+    }): Promise<Response>;
+    getMode(): RoutstrClientMode;
+}
+interface FetchAIResponseDeps {
+    client: FetchAIResponseClient;
+    alertLevel: AlertLevel;
+    logger: SdkLogger;
+    getPendingCashuTokenAmount?: () => number;
+}
+/**
+ * Fetch an AI chat/completions response using RoutstrClient.routeRequest for
+ * payment/auth/failover/accounting, then consume the returned SSE stream and
+ * drive the legacy streaming callbacks.
+ */
+declare function fetchAIResponse(options: FetchOptions, callbacks: StreamingCallbacks, deps: FetchAIResponseDeps): Promise<void>;
+
+export { type AlertLevel, type DebugLevel, type FetchAIResponseDeps, type ModelProviderPrice, ProviderManager, type RequestResponseLogRequestInput, type RequestResponseLogSink, type RouteRequestParams, RoutstrClient, type RoutstrClientConfig, type RoutstrClientMode, type StreamCallbacks, StreamProcessor, type UsageTrackingData, createSSEParserTransform, extractResponseId, extractUsageFromResponseBody, extractUsageFromSSEJson, fetchAIResponse, inspectSSEWebStream, toUsageStats };

package/dist/client/index.d.ts

@@ -1,6 +1,6 @@
-import { e as Model, S as SdkLogger, M as Message, n as TransactionHistory, m as StreamingResult } from '../types-_21yYFZG.js';
+import { e as Model, S as SdkLogger, m as StreamingResult, U as UsageStats, M as Message, n as TransactionHistory } from '../types-_21yYFZG.js';
 import { P as ProviderRegistry, W as WalletAdapter, S as StorageAdapter, a as StreamingCallbacks } from '../interfaces-C-DYd9Jy.js';
-import { S as SdkStore, U as UsageTrackingDriver } from '../store-58VcEUoA.js';
+import { S as SdkStore, c as UsageTrackingDriver } from '../store-CAQLSbEj.js';
 import { CashuSpender, BalanceManager } from '../wallet/index.js';
 import { Transform } from 'stream';
 import 'zustand/vanilla';
@@ -25,6 +25,9 @@ interface ModelProviderPrice {
     completionPerMillion: number;
     totalPerMillion: number;
 }
+/**
+ * ProviderManager handles provider selection and failover
+ */
 declare class ProviderManager {
     private providerRegistry;
     private failedProviders;
@@ -162,19 +165,6 @@ declare class ProviderManager {
  * Extracted from utils/apiUtils.ts
  */
 
-/**
- * Options for fetching AI response
- */
-interface FetchOptions {
-    messageHistory: Message[];
-    selectedModel: Model;
-    baseUrl: string;
-    mintUrl: string;
-    balance: number;
-    transactionHistory: TransactionHistory[];
-    maxTokens?: number;
-    headers?: Record<string, string>;
-}
 /**
  * RoutstrClient is the main SDK entry point
  */
@@ -191,6 +181,23 @@ interface RouteRequestParams {
     modelId?: string;
     clientApiKey?: string;
 }
+interface RequestResponseLogRequestInput {
+    method: string;
+    url: string;
+    path: string;
+    baseUrl: string;
+    headers: Record<string, string>;
+    body?: unknown;
+    rawBody?: string;
+}
+interface RequestResponseLogSink {
+    logRequest?(input: RequestResponseLogRequestInput): string | undefined | Promise<string | undefined>;
+    logResponseStart?(id: string | undefined, response: Response): void | Promise<void>;
+    logResponseChunk?(id: string | undefined, sequence: number, text: string): void | Promise<void>;
+    logResponseEnd?(id: string | undefined): void | Promise<void>;
+    logResponseError?(id: string | undefined, error: unknown): void | Promise<void>;
+    logResponseBody?(id: string | undefined, response: Response): void | Promise<void>;
+}
 interface RoutstrClientConfig {
     usageTrackingDriver?: UsageTrackingDriver;
     sdkStore?: SdkStore;
@@ -198,6 +205,8 @@ interface RoutstrClientConfig {
     providerManager?: ProviderManager;
     /** Optional: injectable logger (defaults to consoleLogger) */
     logger?: SdkLogger;
+    /** Optional: raw request/response logging callbacks supplied by the runtime/app. */
+    requestResponseLogSink?: RequestResponseLogSink;
 }
 declare class RoutstrClient {
     private walletAdapter;
@@ -205,7 +214,6 @@ declare class RoutstrClient {
     private providerRegistry;
     private cashuSpender;
     private balanceManager;
-    private streamProcessor;
     private providerManager;
     private alertLevel;
     private mode;
@@ -213,6 +221,7 @@ declare class RoutstrClient {
     private usageTrackingDriver?;
     private sdkStore?;
     private logger;
+    private requestResponseLogSink?;
     constructor(walletAdapter: WalletAdapter, storageAdapter: StorageAdapter, providerRegistry: ProviderRegistry, alertLevel: AlertLevel, mode?: RoutstrClientMode, options?: RoutstrClientConfig);
     /**
      * Get the current client mode
@@ -251,10 +260,6 @@ declare class RoutstrClient {
      * Extract clientApiKey from Authorization Bearer token if present
      */
     private _extractClientApiKey;
-    /**
-     * Fetch AI response with streaming
-     */
-    fetchAIResponse(options: FetchOptions, callbacks: StreamingCallbacks): Promise<void>;
     /**
      * Make the API request with failover support
      */
@@ -268,26 +273,6 @@ declare class RoutstrClient {
      */
     private _handlePostResponseBalanceUpdate;
     private _trackResponseUsage;
-    /**
-     * Convert messages for API format
-     */
-    private _convertMessages;
-    /**
-     * Create assistant message from streaming result
-     */
-    private _createAssistantMessage;
-    /**
-     * Calculate estimated costs from usage
-     */
-    private _getEstimatedCosts;
-    /**
-     * Get pending API key amount
-     */
-    private _getPendingCashuTokenAmount;
-    /**
-     * Handle errors and notify callbacks
-     */
-    private _handleError;
     /**
      * Check wallet balance and throw if insufficient
      */
@@ -370,7 +355,24 @@ interface UsageTrackingData {
     totalTokens: number;
     cost: number;
     satsCost: number;
+    /** Upstream provider/route that handled the request (e.g. "openrouter:openrouter:Anthropic"). */
+    provider?: string;
+    /** Full cost breakdown emitted by the upstream `cost` object. */
+    baseMsats?: number;
+    inputMsats?: number;
+    outputMsats?: number;
+    totalMsats?: number;
+    totalUsd?: number;
+    cacheReadInputTokens?: number;
+    cacheCreationInputTokens?: number;
+    cacheReadMsats?: number;
+    cacheCreationMsats?: number;
+    remainingBalanceMsats?: number;
 }
+declare function extractUsageFromResponseBody(body: unknown, fallbackSatsCost?: number): UsageTrackingData | null;
+declare function extractResponseId(body: unknown): string | undefined;
+declare function extractUsageFromSSEJson(parsed: any, fallbackSatsCost?: number): UsageTrackingData | null;
+declare function toUsageStats(usage: UsageTrackingData | null | undefined): UsageStats | undefined;
 
 /**
  * Inspect a Web `ReadableStream<Uint8Array>` of SSE bytes for `usage` and
@@ -385,7 +387,10 @@ interface UsageTrackingData {
  * The returned Promise resolves with the final captured values once the
  * stream ends (or is cancelled / errors out).
  */
-declare function inspectSSEWebStream(stream: ReadableStream<Uint8Array>, onUsage: (usage: UsageTrackingData) => void, onResponseId?: (responseId: string) => void): Promise<{
+declare function inspectSSEWebStream(stream: ReadableStream<Uint8Array>, onUsage: (usage: UsageTrackingData) => void, onResponseId?: (responseId: string) => void, options?: {
+    /** Called with each raw chunk read from the tee'd inspection branch. */
+    onRawChunk?: (chunk: Uint8Array, sequence: number, text: string) => void | Promise<void>;
+}): Promise<{
     capturedUsage?: UsageTrackingData;
     capturedResponseId?: string;
 }>;
@@ -408,4 +413,42 @@ declare function inspectSSEWebStream(stream: ReadableStream<Uint8Array>, onUsage
  */
 declare function createSSEParserTransform(onUsage: (usage: UsageTrackingData) => void, onResponseId?: (responseId: string) => void): Transform;
 
-export { type AlertLevel, type DebugLevel, type FetchOptions, type ModelProviderPrice, ProviderManager, type RouteRequestParams, RoutstrClient, type RoutstrClientConfig, type RoutstrClientMode, type StreamCallbacks, StreamProcessor, createSSEParserTransform, inspectSSEWebStream };
+/**
+ * Options for fetching AI response
+ */
+interface FetchOptions {
+    messageHistory: Message[];
+    selectedModel: Model;
+    baseUrl: string;
+    mintUrl: string;
+    balance: number;
+    transactionHistory: TransactionHistory[];
+    maxTokens?: number;
+    headers?: Record<string, string>;
+}
+interface FetchAIResponseClient {
+    routeRequest(params: {
+        path: string;
+        method: string;
+        body?: unknown;
+        headers?: Record<string, string>;
+        baseUrl: string;
+        mintUrl: string;
+        modelId?: string;
+    }): Promise<Response>;
+    getMode(): RoutstrClientMode;
+}
+interface FetchAIResponseDeps {
+    client: FetchAIResponseClient;
+    alertLevel: AlertLevel;
+    logger: SdkLogger;
+    getPendingCashuTokenAmount?: () => number;
+}
+/**
+ * Fetch an AI chat/completions response using RoutstrClient.routeRequest for
+ * payment/auth/failover/accounting, then consume the returned SSE stream and
+ * drive the legacy streaming callbacks.
+ */
+declare function fetchAIResponse(options: FetchOptions, callbacks: StreamingCallbacks, deps: FetchAIResponseDeps): Promise<void>;
+
+export { type AlertLevel, type DebugLevel, type FetchAIResponseDeps, type ModelProviderPrice, ProviderManager, type RequestResponseLogRequestInput, type RequestResponseLogSink, type RouteRequestParams, RoutstrClient, type RoutstrClientConfig, type RoutstrClientMode, type StreamCallbacks, StreamProcessor, type UsageTrackingData, createSSEParserTransform, extractResponseId, extractUsageFromResponseBody, extractUsageFromSSEJson, fetchAIResponse, inspectSSEWebStream, toUsageStats };