@routstr/sdk 0.3.7 → 0.3.8

package/dist/store-C6dfj1cc.d.mts

@@ -0,0 +1,172 @@
+import { StoreApi } from 'zustand/vanilla';
+import { D as DiscoveryAdapter } from './interfaces-Cv1k2EUK.mjs';
+import { P as ProviderRegistry, S as StorageAdapter } from './interfaces-Csn8Uq04.mjs';
+import { e as Model, k as ProviderInfo, S as SdkLogger } from './types-_21yYFZG.mjs';
+
+interface UsageTrackingEntry {
+    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[];
+}
+
+interface ListUsageTrackingOptions {
+    limit?: number;
+    before?: number;
+    after?: number;
+    modelId?: string;
+    baseUrl?: string;
+    sessionId?: string;
+    client?: string;
+}
+interface UsageTrackingDriver {
+    migrate(): Promise<void>;
+    append(entry: UsageTrackingEntry): Promise<void>;
+    appendMany(entries: UsageTrackingEntry[]): Promise<void>;
+    list(options?: ListUsageTrackingOptions): Promise<UsageTrackingEntry[]>;
+    count(options?: Omit<ListUsageTrackingOptions, "limit">): Promise<number>;
+    deleteOlderThan(timestamp: number): Promise<number>;
+    clear(): Promise<void>;
+}
+
+interface StorageDriver {
+    getItem<T>(key: string, defaultValue: T): Promise<T>;
+    setItem<T>(key: string, value: T): Promise<void>;
+    removeItem(key: string): Promise<void>;
+}
+interface SdkStorageState {
+    modelsFromAllProviders: Record<string, Model[]>;
+    lastUsedModel: string | null;
+    baseUrlsList: string[];
+    disabledProviders: string[];
+    mintsFromAllProviders: Record<string, string[]>;
+    infoFromAllProviders: Record<string, ProviderInfo>;
+    lastModelsUpdate: Record<string, number>;
+    lastBaseUrlsUpdate: number | null;
+    apiKeys: Array<{
+        baseUrl: string;
+        key: string;
+        balance: number;
+        lastUsed: number | null;
+    }>;
+    childKeys: Array<{
+        parentBaseUrl: string;
+        childKey: string;
+        balance: number;
+        balanceLimit?: number;
+        validityDate?: number;
+        createdAt: number;
+    }>;
+    xcashuTokens: Record<string, Array<{
+        baseUrl: string;
+        token: string;
+        createdAt: number;
+        tryCount: number;
+    }>>;
+    routstr21Models: string[];
+    lastRoutstr21ModelsUpdate: number | null;
+    cachedReceiveTokens: Array<{
+        token: string;
+        amount: number;
+        unit: "sat" | "msat";
+        createdAt: number;
+    }>;
+    clientIds: Array<{
+        clientId: string;
+        name: string;
+        apiKey: string;
+        createdAt: number;
+        lastUsed?: number | null;
+    }>;
+    /** Set of failed provider URLs */
+    failedProviders: string[];
+    /** Map of provider URL -> timestamp of last failure */
+    lastFailed: Record<string, number>;
+    /** Providers currently on cooldown: [baseUrl, timestamp][] */
+    providersOnCooldown: Array<{
+        baseUrl: string;
+        timestamp: number;
+    }>;
+}
+
+interface SdkStoreOptions {
+    driver: StorageDriver;
+}
+interface SdkStorageStore extends SdkStorageState {
+    setModelsFromAllProviders: (value: Record<string, Model[]>) => void;
+    setLastUsedModel: (value: string | null) => void;
+    setBaseUrlsList: (value: string[]) => void;
+    setBaseUrlsLastUpdate: (value: number | null) => void;
+    setDisabledProviders: (value: string[]) => void;
+    setMintsFromAllProviders: (value: Record<string, string[]>) => void;
+    setInfoFromAllProviders: (value: Record<string, ProviderInfo>) => void;
+    setLastModelsUpdate: (value: Record<string, number>) => void;
+    setApiKeys: (value: Array<{
+        baseUrl: string;
+        key: string;
+        balance?: number;
+        lastUsed?: number | null;
+    }> | ((current: SdkStorageStore["apiKeys"]) => SdkStorageStore["apiKeys"])) => void;
+    setChildKeys: (value: Array<{
+        parentBaseUrl: string;
+        childKey: string;
+        balance?: number;
+        balanceLimit?: number;
+        validityDate?: number;
+        createdAt?: number;
+    }>) => void;
+    setXcashuTokens: (value: Record<string, Array<{
+        baseUrl: string;
+        token: string;
+        createdAt?: number;
+        tryCount?: number;
+    }>>) => void;
+    updateXcashuTokenTryCount: (token: string, tryCount: number) => void;
+    setRoutstr21Models: (value: string[]) => void;
+    setRoutstr21ModelsLastUpdate: (value: number | null) => void;
+    setCachedReceiveTokens: (value: Array<{
+        token: string;
+        amount: number;
+        unit: "sat" | "msat";
+        createdAt?: number;
+    }>) => void;
+    setClientIds: (value: Array<{
+        clientId: string;
+        name: string;
+        apiKey: string;
+        createdAt?: number;
+        lastUsed?: number | null;
+    }> | ((current: SdkStorageStore["clientIds"]) => SdkStorageStore["clientIds"])) => void;
+    setFailedProviders: (value: string[]) => void;
+    addFailedProvider: (baseUrl: string) => void;
+    removeFailedProvider: (baseUrl: string) => void;
+    setLastFailed: (value: Record<string, number>) => void;
+    setLastFailedTimestamp: (baseUrl: string, timestamp: number) => void;
+    setProvidersOnCooldown: (value: Array<{
+        baseUrl: string;
+        timestamp: number;
+    }>) => void;
+    addProviderOnCooldown: (baseUrl: string, timestamp: number) => void;
+    removeProviderFromCooldown: (baseUrl: string) => void;
+    clearProvidersOnCooldown: () => void;
+}
+/** Store type returned after async initialization */
+type SdkStore = StoreApi<SdkStorageStore>;
+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, logger?: SdkLogger) => ProviderRegistry;
+
+export { type ListUsageTrackingOptions as L, type SdkStore as S, type UsageTrackingDriver as U, type StorageDriver as a, type UsageTrackingEntry as b, createDiscoveryAdapterFromStore as c, createProviderRegistryFromStore as d, createSdkStore as e, createStorageAdapterFromStore as f };

package/dist/types-_21yYFZG.d.mts

@@ -0,0 +1,234 @@
+/**
+ * Core types for the Routstr SDK
+ * These types are shared across wallet and client modules
+ */
+interface SdkLogger {
+    log(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    debug(...args: unknown[]): void;
+    child(prefix: string): SdkLogger;
+}
+declare const consoleLogger: SdkLogger;
+declare const noopLogger: SdkLogger;
+interface MessageContentType {
+    type: "text" | "image_url" | "file";
+    text?: string;
+    image_url?: {
+        url: string;
+        storageId?: string;
+    };
+    file?: {
+        url: string;
+        name?: string;
+        mimeType?: string;
+        size?: number;
+    };
+    hidden?: boolean;
+    thinking?: string;
+    citations?: string[];
+}
+interface Message {
+    role: string;
+    content: string | MessageContentType[];
+    _eventId?: string;
+    _prevId?: string;
+    _createdAt?: number;
+    _modelId?: string;
+    satsSpent?: number;
+}
+interface TransactionHistory {
+    type: "spent" | "mint" | "send" | "import" | "refund";
+    amount: number;
+    timestamp: number;
+    status: "success" | "failed";
+    model?: string;
+    message?: string;
+    balance?: number;
+}
+interface ModelPricing {
+    prompt: number;
+    completion: number;
+    request: number;
+    image: number;
+    web_search: number;
+    internal_reasoning: number;
+}
+interface ModelSatsPricing extends ModelPricing {
+    max_completion_cost: number;
+    max_prompt_cost: number;
+    max_cost: number;
+}
+interface ModelArchitecture {
+    modality: string;
+    input_modalities: readonly string[];
+    output_modalities: readonly string[];
+    tokenizer: string;
+    instruct_type: string | null;
+}
+interface PerRequestLimits {
+    readonly prompt_tokens?: number;
+    readonly completion_tokens?: number;
+    readonly requests_per_minute?: number;
+    readonly images_per_minute?: number;
+    readonly web_searches_per_minute?: number;
+    readonly [key: string]: number | undefined;
+}
+interface Model {
+    id: string;
+    name: string;
+    created?: number;
+    description?: string;
+    context_length?: number;
+    architecture?: ModelArchitecture;
+    pricing?: ModelPricing;
+    sats_pricing: ModelSatsPricing;
+    per_request_limits?: PerRequestLimits;
+}
+/**
+ * Result from spending cashu tokens
+ */
+interface SpendResult {
+    token: string | null;
+    status: "success" | "failed";
+    balance: number;
+    unit?: "sat" | "msat";
+    error?: string;
+    errorDetails?: {
+        required: number;
+        available: number;
+        maxMintBalance: number;
+        maxMintUrl: string;
+    };
+}
+/**
+ * Result from refund operations
+ */
+interface RefundResult {
+    success: boolean;
+    refundedAmount?: number;
+    message?: string;
+    requestId?: string;
+}
+/**
+ * Result from top up operations
+ */
+interface TopUpResult {
+    success: boolean;
+    toppedUpAmount?: number;
+    message?: string;
+    requestId?: string;
+    recoveredToken?: boolean;
+}
+/**
+ * API error verdict for retry logic
+ */
+interface APIErrorVerdict {
+    retry: boolean;
+    reason: string;
+    newBaseUrl?: string;
+}
+/**
+ * Image data from API response
+ */
+interface ImageData {
+    type: "image_url";
+    image_url: {
+        url: string;
+    };
+    index?: number;
+}
+/**
+ * Annotation data from API response
+ */
+interface AnnotationData {
+    type: "url_citation";
+    start_index: number;
+    end_index: number;
+    url: string;
+    title: string;
+}
+/**
+ * Usage statistics from API response
+ */
+interface UsageStats {
+    total_tokens?: number;
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    cost?: number;
+    sats_cost?: number;
+}
+/**
+ * Result from streaming response processing
+ */
+interface StreamingResult {
+    content: string;
+    thinking?: string;
+    images?: ImageData[];
+    usage?: UsageStats;
+    model?: string;
+    responseId?: string;
+    finish_reason?: string;
+    citations?: string[];
+    annotations?: AnnotationData[];
+}
+/**
+ * Parameters for fetching AI response
+ */
+interface FetchAIResponseParams {
+    messageHistory: Message[];
+    selectedModel: Model;
+    baseUrl: string;
+    mintUrl: string;
+    balance: number;
+    transactionHistory: TransactionHistory[];
+}
+/**
+ * Candidate provider for failover
+ */
+interface CandidateProvider {
+    baseUrl: string;
+    model: Model;
+    cost: number;
+}
+/**
+ * Mint selection result
+ */
+interface MintSelection {
+    selectedMintUrl: string | null;
+    selectedMintBalance: number;
+}
+/**
+ * Pending token entry
+ */
+interface PendingTokenEntry {
+    baseUrl: string;
+    amount: number;
+}
+/**
+ * Provider information from /v1/info endpoint
+ */
+interface ProviderInfo {
+    mints?: string[];
+    [key: string]: any;
+}
+/**
+ * Model discovery result
+ */
+interface ModelDiscoveryResult {
+    models: Model[];
+    bestById: Map<string, {
+        model: Model;
+        base: string;
+    }>;
+    totalProcessed: number;
+}
+/**
+ * Mint discovery result
+ */
+interface MintDiscoveryResult {
+    mintsFromProviders: Record<string, string[]>;
+    infoFromProviders: Record<string, ProviderInfo>;
+}
+
+export { type APIErrorVerdict as A, type CandidateProvider as C, type FetchAIResponseParams as F, type ImageData as I, type Message as M, type PendingTokenEntry as P, type RefundResult as R, type SdkLogger as S, type TopUpResult as T, type UsageStats as U, type AnnotationData as a, type MessageContentType as b, type MintDiscoveryResult as c, type MintSelection as d, type Model as e, type ModelArchitecture as f, type ModelDiscoveryResult as g, type ModelPricing as h, type ModelSatsPricing as i, type PerRequestLimits as j, type ProviderInfo as k, type SpendResult as l, type StreamingResult as m, type TransactionHistory as n, consoleLogger as o, noopLogger as p };

package/dist/types-_21yYFZG.d.ts

@@ -0,0 +1,234 @@
+/**
+ * Core types for the Routstr SDK
+ * These types are shared across wallet and client modules
+ */
+interface SdkLogger {
+    log(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    debug(...args: unknown[]): void;
+    child(prefix: string): SdkLogger;
+}
+declare const consoleLogger: SdkLogger;
+declare const noopLogger: SdkLogger;
+interface MessageContentType {
+    type: "text" | "image_url" | "file";
+    text?: string;
+    image_url?: {
+        url: string;
+        storageId?: string;
+    };
+    file?: {
+        url: string;
+        name?: string;
+        mimeType?: string;
+        size?: number;
+    };
+    hidden?: boolean;
+    thinking?: string;
+    citations?: string[];
+}
+interface Message {
+    role: string;
+    content: string | MessageContentType[];
+    _eventId?: string;
+    _prevId?: string;
+    _createdAt?: number;
+    _modelId?: string;
+    satsSpent?: number;
+}
+interface TransactionHistory {
+    type: "spent" | "mint" | "send" | "import" | "refund";
+    amount: number;
+    timestamp: number;
+    status: "success" | "failed";
+    model?: string;
+    message?: string;
+    balance?: number;
+}
+interface ModelPricing {
+    prompt: number;
+    completion: number;
+    request: number;
+    image: number;
+    web_search: number;
+    internal_reasoning: number;
+}
+interface ModelSatsPricing extends ModelPricing {
+    max_completion_cost: number;
+    max_prompt_cost: number;
+    max_cost: number;
+}
+interface ModelArchitecture {
+    modality: string;
+    input_modalities: readonly string[];
+    output_modalities: readonly string[];
+    tokenizer: string;
+    instruct_type: string | null;
+}
+interface PerRequestLimits {
+    readonly prompt_tokens?: number;
+    readonly completion_tokens?: number;
+    readonly requests_per_minute?: number;
+    readonly images_per_minute?: number;
+    readonly web_searches_per_minute?: number;
+    readonly [key: string]: number | undefined;
+}
+interface Model {
+    id: string;
+    name: string;
+    created?: number;
+    description?: string;
+    context_length?: number;
+    architecture?: ModelArchitecture;
+    pricing?: ModelPricing;
+    sats_pricing: ModelSatsPricing;
+    per_request_limits?: PerRequestLimits;
+}
+/**
+ * Result from spending cashu tokens
+ */
+interface SpendResult {
+    token: string | null;
+    status: "success" | "failed";
+    balance: number;
+    unit?: "sat" | "msat";
+    error?: string;
+    errorDetails?: {
+        required: number;
+        available: number;
+        maxMintBalance: number;
+        maxMintUrl: string;
+    };
+}
+/**
+ * Result from refund operations
+ */
+interface RefundResult {
+    success: boolean;
+    refundedAmount?: number;
+    message?: string;
+    requestId?: string;
+}
+/**
+ * Result from top up operations
+ */
+interface TopUpResult {
+    success: boolean;
+    toppedUpAmount?: number;
+    message?: string;
+    requestId?: string;
+    recoveredToken?: boolean;
+}
+/**
+ * API error verdict for retry logic
+ */
+interface APIErrorVerdict {
+    retry: boolean;
+    reason: string;
+    newBaseUrl?: string;
+}
+/**
+ * Image data from API response
+ */
+interface ImageData {
+    type: "image_url";
+    image_url: {
+        url: string;
+    };
+    index?: number;
+}
+/**
+ * Annotation data from API response
+ */
+interface AnnotationData {
+    type: "url_citation";
+    start_index: number;
+    end_index: number;
+    url: string;
+    title: string;
+}
+/**
+ * Usage statistics from API response
+ */
+interface UsageStats {
+    total_tokens?: number;
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    cost?: number;
+    sats_cost?: number;
+}
+/**
+ * Result from streaming response processing
+ */
+interface StreamingResult {
+    content: string;
+    thinking?: string;
+    images?: ImageData[];
+    usage?: UsageStats;
+    model?: string;
+    responseId?: string;
+    finish_reason?: string;
+    citations?: string[];
+    annotations?: AnnotationData[];
+}
+/**
+ * Parameters for fetching AI response
+ */
+interface FetchAIResponseParams {
+    messageHistory: Message[];
+    selectedModel: Model;
+    baseUrl: string;
+    mintUrl: string;
+    balance: number;
+    transactionHistory: TransactionHistory[];
+}
+/**
+ * Candidate provider for failover
+ */
+interface CandidateProvider {
+    baseUrl: string;
+    model: Model;
+    cost: number;
+}
+/**
+ * Mint selection result
+ */
+interface MintSelection {
+    selectedMintUrl: string | null;
+    selectedMintBalance: number;
+}
+/**
+ * Pending token entry
+ */
+interface PendingTokenEntry {
+    baseUrl: string;
+    amount: number;
+}
+/**
+ * Provider information from /v1/info endpoint
+ */
+interface ProviderInfo {
+    mints?: string[];
+    [key: string]: any;
+}
+/**
+ * Model discovery result
+ */
+interface ModelDiscoveryResult {
+    models: Model[];
+    bestById: Map<string, {
+        model: Model;
+        base: string;
+    }>;
+    totalProcessed: number;
+}
+/**
+ * Mint discovery result
+ */
+interface MintDiscoveryResult {
+    mintsFromProviders: Record<string, string[]>;
+    infoFromProviders: Record<string, ProviderInfo>;
+}
+
+export { type APIErrorVerdict as A, type CandidateProvider as C, type FetchAIResponseParams as F, type ImageData as I, type Message as M, type PendingTokenEntry as P, type RefundResult as R, type SdkLogger as S, type TopUpResult as T, type UsageStats as U, type AnnotationData as a, type MessageContentType as b, type MintDiscoveryResult as c, type MintSelection as d, type Model as e, type ModelArchitecture as f, type ModelDiscoveryResult as g, type ModelPricing as h, type ModelSatsPricing as i, type PerRequestLimits as j, type ProviderInfo as k, type SpendResult as l, type StreamingResult as m, type TransactionHistory as n, consoleLogger as o, noopLogger as p };