@routedock/routedock 0.1.1 → 0.2.0

package/dist/client.d.cts

@@ -1,83 +1,15 @@
-import { P as PaymentMode, c as RouteDockManifest, a as PaymentResult, h as SessionHandle } from './SessionStore-CCVO0PHM.cjs';
-export { b as PricingConfig, R as RouteDockError, d as RouteDockManifestError, e as RouteDockNoSupportedModeError, f as RouteDockPolicyRejectedError, g as RouteDockSessionError, S as SessionCloseResult, i as SessionPricingConfig, j as SessionState, k as SessionStore, l as SupabaseSessionStore } from './SessionStore-CCVO0PHM.cjs';
+import { R as RouteDockManifest, k as SessionOptions, j as SessionHandle } from './types-DmhmfLzP.cjs';
+export { D as DEFAULT_MAX_SESSION_DURATION_MS, a as DisputeStatus, E as EndpointDescriptor, b as EstimateCostResult, P as PaymentMode, c as PaymentResult, d as PreflightResult, e as PricingConfig, S as SLAConfig, f as SessionCloseFailedPayload, g as SessionCloseResult, h as SessionEvent, i as SessionEventPayloadMap, l as SessionPricingConfig, m as SessionState, n as SessionStats, o as SessionTimeoutPayload, p as StreamOptions, V as VaultMode } from './types-DmhmfLzP.cjs';
+export { R as RouteDockChannelStateError, a as RouteDockClientVersionError, b as RouteDockDisputeError, c as RouteDockError, d as RouteDockErrorCode, e as RouteDockErrorOptions, f as RouteDockFacilitatorError, g as RouteDockManifestError, h as RouteDockManifestSunsetError, i as RouteDockManifestTimeoutError, j as RouteDockNetworkError, k as RouteDockNoSupportedModeError, l as RouteDockPolicyRejectError, m as RouteDockPolicyRejectedError, n as RouteDockRefundWindowError, o as RouteDockSessionError, p as RouteDockSignatureError, q as RouteDockTrustlineError, r as RouteDockVoucherMonotonicityError, S as SessionStore, s as SupabaseSessionStore, t as httpStatusToError, u as parseRetryAfterMs, w as wrapFetchError } from './SessionStore-BpK8vv0L.cjs';
+import { R as RetryPolicy } from './RouteDockClient-B1roCa8h.cjs';
+export { D as DEFAULT_RETRY_POLICY, a as DailySpend, I as InMemorySpendStore, b as InMemorySpendStoreOptions, M as ModeSelectOptions, N as NulthAuthSignature, c as NulthClientConfig, d as NulthPolicyError, e as NulthPolicyState, f as NulthProof, g as NulthSignerConfig, h as NulthStellarSigner, i as NulthVaultConfig, P as PaymentAuthContext, j as RouteDockClient, k as RouteDockClientConfig, l as RouteDockLogger, S as SpendCap, m as SpendStore, V as VaultConfig, n as assertEndpointActive, o as assertManifestValid, p as assertNulthVaultManifest, q as backoffDelayMs, r as configureManifestCache, s as createNulthSigner, t as createPolicyState, u as decodeAuthSignature, v as fetchLedgerSequence, w as fetchManifest, x as invalidateManifest, y as paymentContextFromManifest, z as prepareNulthSigner, A as rankProvidersByLatency, B as selectMode, C as setNulthPaymentContext, E as usdcToMicros, F as withRetry } from './RouteDockClient-B1roCa8h.cjs';
+export { F as FileSpendStore, M as MppChargeClient, O as OnChainProviderInfo, a as OnChainRegistry, P as ProviderRecord, b as ProviderRegistry, c as ProviderRegistryConfig, X as X402Client, u as usdcToUnits } from './ProviderRegistry-BJ9oJLVz.cjs';
 import { Keypair } from '@stellar/stellar-sdk';
+export { USDC_DECIMALS, usdcToStroops } from '@routedock/nulth-sdk';
+import 'mppx';
 import '@supabase/supabase-js';
-
-interface ModeSelectOptions {
-    /** Force mpp-session if the provider supports it */
-    sustained?: boolean;
-    session?: boolean;
-    /**
-     * Override mode selection and use this specific mode.
-     * Throws RouteDockNoSupportedModeError if the provider does not support it.
-     */
-    forceMode?: PaymentMode;
-}
-/** Fetch, validate, and cache a RouteDock manifest from `baseUrl`. */
-declare function fetchManifest(baseUrl: string): Promise<RouteDockManifest>;
-/**
- * Deterministic mode selection per Section 6.3 of ROUTEDOCK_MASTER.md:
- * 1. If { sustained | session } AND manifest supports mpp-session → mpp-session
- * 2. Else if manifest supports mpp-charge AND network is Stellar → mpp-charge
- * 3. Else if manifest supports x402 → x402
- * 4. Else throw RouteDockNoSupportedModeError
- */
-declare function selectMode(manifest: RouteDockManifest, options?: ModeSelectOptions): PaymentMode;
-
-interface SpendCap {
-    /** Maximum total USDC spend per day (decimal string, e.g. "1.00") */
-    daily: string;
-    asset: 'USDC';
-}
-interface RouteDockClientConfig {
-    /** Stellar keypair or raw secret key (S...) */
-    wallet: Keypair | string;
-    network: 'testnet' | 'mainnet';
-    /** Optional local daily spend cap — checked before every payment */
-    spendCap?: SpendCap;
-    /** Ed25519 secret key (S...) for signing channel commitments. Required for mpp-session. */
-    commitmentSecret?: string | undefined;
-}
-declare class RouteDockClient {
-    private readonly keypair;
-    private readonly network;
-    private readonly spendCap;
-    private readonly commitmentSecret;
-    /** Local daily accumulator keyed by YYYY-MM-DD */
-    private dailySpend;
-    private readonly x402;
-    private readonly charge;
-    private readonly session;
-    constructor(config: RouteDockClientConfig);
-    /**
-     * Pay for one request at `url`. Fetches manifest, selects payment mode,
-     * checks local spend cap, executes payment, returns result.
-     */
-    pay(url: string, options?: ModeSelectOptions): Promise<PaymentResult>;
-    /**
-     * Open a sustained MPP session at `url`. Verifies mpp-session is supported
-     * before opening a channel. Returns a SessionHandle for streaming + closing.
-     */
-    openSession(url: string): Promise<SessionHandle>;
-    /** Check local daily cap and record the spend. Throws if cap exceeded. */
-    private _checkAndRecordSpend;
-}
-
-type Network = 'testnet' | 'mainnet';
-declare class X402Client {
-    private readonly secretKey;
-    private readonly network;
-    private readonly httpClient;
-    constructor(secretKey: string, network: Network);
-    pay(url: string, manifest: RouteDockManifest): Promise<PaymentResult>;
-}
-
-declare class MppChargeClient {
-    private readonly keypair;
-    private readonly network;
-    constructor(keypair: Keypair, network: 'testnet' | 'mainnet');
-    pay(url: string, manifest: RouteDockManifest): Promise<PaymentResult>;
-}
+import '@x402/stellar';
+import '@stellar/stellar-sdk/contract';
 
 /**
  * MppSessionClient — uses @stellar/mpp channel/client for off-chain
@@ -88,11 +20,48 @@ declare class MppChargeClient {
  * @stellar/mpp library handles the 402 challenge-response cycle.
  */
 
+/** A WebSocket socket as consumed by the mpp-session-ws stream. */
+interface WebSocketLike {
+    readyState: number;
+    close(code?: number, reason?: string): void;
+}
+/** Callbacks a WebSocket factory must wire to the underlying socket. */
+interface WebSocketHandlers {
+    onOpen(): void;
+    onMessage(data: string): void;
+    onClose(code: number, reason: string): void;
+    onError(): void;
+}
+/**
+ * Creates a WebSocket connection with the given handshake headers.
+ * Injected for testability; defaults to the runtime WebSocket global
+ * (undici in Node ≥ 22 supports handshake headers via its options object).
+ */
+type WebSocketFactory = (url: string, init: {
+    headers: Record<string, string>;
+}, handlers: WebSocketHandlers) => WebSocketLike;
 declare class MppSessionClient {
     private readonly keypair;
     private readonly network;
-    constructor(keypair: Keypair, network: 'testnet' | 'mainnet');
-    openSession(url: string, manifest: RouteDockManifest, commitmentSecret: string): Promise<SessionHandle>;
+    private readonly retryPolicy?;
+    private readonly webSocketFactory;
+    constructor(keypair: Keypair, network: 'testnet' | 'mainnet', retryPolicy?: RetryPolicy | undefined, webSocketFactory?: WebSocketFactory);
+    openSession(url: string, manifest: RouteDockManifest, commitmentSecret: string, options?: SessionOptions, onSpend?: (amount: string) => Promise<void>): Promise<SessionHandle>;
+    /**
+     * mpp-session-ws streaming transport.
+     *
+     * Mirrors the issue's three-step sequence:
+     *   1. open the channel — probe the provider URL over HTTP;
+     *   2. negotiate the voucher — sign the mppx 402 challenge into a credential;
+     *   3. upgrade the HTTP connection to WebSocket — hand the signed voucher to
+     *      the provider as the Authorization header of the WebSocket handshake.
+     *
+     * Each server frame is yielded (JSON frames parsed; raw strings yielded
+     * as-is). The stream ends when the server closes the socket with a normal
+     * close code (1000/1001); abnormal closes and connection failures surface as
+     * RouteDockChannelStateError.
+     */
+    private streamWebSocket;
 }
 
-export { type ModeSelectOptions, MppChargeClient, MppSessionClient, PaymentMode, PaymentResult, RouteDockClient, type RouteDockClientConfig, RouteDockManifest, SessionHandle, type SpendCap, X402Client, fetchManifest, selectMode };
+export { MppSessionClient, RetryPolicy, RouteDockManifest, SessionHandle, SessionOptions, type WebSocketFactory, type WebSocketHandlers, type WebSocketLike };

package/dist/client.d.ts

@@ -1,83 +1,15 @@
-import { P as PaymentMode, c as RouteDockManifest, a as PaymentResult, h as SessionHandle } from './SessionStore-CCVO0PHM.js';
-export { b as PricingConfig, R as RouteDockError, d as RouteDockManifestError, e as RouteDockNoSupportedModeError, f as RouteDockPolicyRejectedError, g as RouteDockSessionError, S as SessionCloseResult, i as SessionPricingConfig, j as SessionState, k as SessionStore, l as SupabaseSessionStore } from './SessionStore-CCVO0PHM.js';
+import { R as RouteDockManifest, k as SessionOptions, j as SessionHandle } from './types-DmhmfLzP.js';
+export { D as DEFAULT_MAX_SESSION_DURATION_MS, a as DisputeStatus, E as EndpointDescriptor, b as EstimateCostResult, P as PaymentMode, c as PaymentResult, d as PreflightResult, e as PricingConfig, S as SLAConfig, f as SessionCloseFailedPayload, g as SessionCloseResult, h as SessionEvent, i as SessionEventPayloadMap, l as SessionPricingConfig, m as SessionState, n as SessionStats, o as SessionTimeoutPayload, p as StreamOptions, V as VaultMode } from './types-DmhmfLzP.js';
+export { R as RouteDockChannelStateError, a as RouteDockClientVersionError, b as RouteDockDisputeError, c as RouteDockError, d as RouteDockErrorCode, e as RouteDockErrorOptions, f as RouteDockFacilitatorError, g as RouteDockManifestError, h as RouteDockManifestSunsetError, i as RouteDockManifestTimeoutError, j as RouteDockNetworkError, k as RouteDockNoSupportedModeError, l as RouteDockPolicyRejectError, m as RouteDockPolicyRejectedError, n as RouteDockRefundWindowError, o as RouteDockSessionError, p as RouteDockSignatureError, q as RouteDockTrustlineError, r as RouteDockVoucherMonotonicityError, S as SessionStore, s as SupabaseSessionStore, t as httpStatusToError, u as parseRetryAfterMs, w as wrapFetchError } from './SessionStore-DvkZv8-E.js';
+import { R as RetryPolicy } from './RouteDockClient-BbkqjhMG.js';
+export { D as DEFAULT_RETRY_POLICY, a as DailySpend, I as InMemorySpendStore, b as InMemorySpendStoreOptions, M as ModeSelectOptions, N as NulthAuthSignature, c as NulthClientConfig, d as NulthPolicyError, e as NulthPolicyState, f as NulthProof, g as NulthSignerConfig, h as NulthStellarSigner, i as NulthVaultConfig, P as PaymentAuthContext, j as RouteDockClient, k as RouteDockClientConfig, l as RouteDockLogger, S as SpendCap, m as SpendStore, V as VaultConfig, n as assertEndpointActive, o as assertManifestValid, p as assertNulthVaultManifest, q as backoffDelayMs, r as configureManifestCache, s as createNulthSigner, t as createPolicyState, u as decodeAuthSignature, v as fetchLedgerSequence, w as fetchManifest, x as invalidateManifest, y as paymentContextFromManifest, z as prepareNulthSigner, A as rankProvidersByLatency, B as selectMode, C as setNulthPaymentContext, E as usdcToMicros, F as withRetry } from './RouteDockClient-BbkqjhMG.js';
+export { F as FileSpendStore, M as MppChargeClient, O as OnChainProviderInfo, a as OnChainRegistry, P as ProviderRecord, b as ProviderRegistry, c as ProviderRegistryConfig, X as X402Client, u as usdcToUnits } from './ProviderRegistry-C50nyhaF.js';
 import { Keypair } from '@stellar/stellar-sdk';
+export { USDC_DECIMALS, usdcToStroops } from '@routedock/nulth-sdk';
+import 'mppx';
 import '@supabase/supabase-js';
-
-interface ModeSelectOptions {
-    /** Force mpp-session if the provider supports it */
-    sustained?: boolean;
-    session?: boolean;
-    /**
-     * Override mode selection and use this specific mode.
-     * Throws RouteDockNoSupportedModeError if the provider does not support it.
-     */
-    forceMode?: PaymentMode;
-}
-/** Fetch, validate, and cache a RouteDock manifest from `baseUrl`. */
-declare function fetchManifest(baseUrl: string): Promise<RouteDockManifest>;
-/**
- * Deterministic mode selection per Section 6.3 of ROUTEDOCK_MASTER.md:
- * 1. If { sustained | session } AND manifest supports mpp-session → mpp-session
- * 2. Else if manifest supports mpp-charge AND network is Stellar → mpp-charge
- * 3. Else if manifest supports x402 → x402
- * 4. Else throw RouteDockNoSupportedModeError
- */
-declare function selectMode(manifest: RouteDockManifest, options?: ModeSelectOptions): PaymentMode;
-
-interface SpendCap {
-    /** Maximum total USDC spend per day (decimal string, e.g. "1.00") */
-    daily: string;
-    asset: 'USDC';
-}
-interface RouteDockClientConfig {
-    /** Stellar keypair or raw secret key (S...) */
-    wallet: Keypair | string;
-    network: 'testnet' | 'mainnet';
-    /** Optional local daily spend cap — checked before every payment */
-    spendCap?: SpendCap;
-    /** Ed25519 secret key (S...) for signing channel commitments. Required for mpp-session. */
-    commitmentSecret?: string | undefined;
-}
-declare class RouteDockClient {
-    private readonly keypair;
-    private readonly network;
-    private readonly spendCap;
-    private readonly commitmentSecret;
-    /** Local daily accumulator keyed by YYYY-MM-DD */
-    private dailySpend;
-    private readonly x402;
-    private readonly charge;
-    private readonly session;
-    constructor(config: RouteDockClientConfig);
-    /**
-     * Pay for one request at `url`. Fetches manifest, selects payment mode,
-     * checks local spend cap, executes payment, returns result.
-     */
-    pay(url: string, options?: ModeSelectOptions): Promise<PaymentResult>;
-    /**
-     * Open a sustained MPP session at `url`. Verifies mpp-session is supported
-     * before opening a channel. Returns a SessionHandle for streaming + closing.
-     */
-    openSession(url: string): Promise<SessionHandle>;
-    /** Check local daily cap and record the spend. Throws if cap exceeded. */
-    private _checkAndRecordSpend;
-}
-
-type Network = 'testnet' | 'mainnet';
-declare class X402Client {
-    private readonly secretKey;
-    private readonly network;
-    private readonly httpClient;
-    constructor(secretKey: string, network: Network);
-    pay(url: string, manifest: RouteDockManifest): Promise<PaymentResult>;
-}
-
-declare class MppChargeClient {
-    private readonly keypair;
-    private readonly network;
-    constructor(keypair: Keypair, network: 'testnet' | 'mainnet');
-    pay(url: string, manifest: RouteDockManifest): Promise<PaymentResult>;
-}
+import '@x402/stellar';
+import '@stellar/stellar-sdk/contract';
 
 /**
  * MppSessionClient — uses @stellar/mpp channel/client for off-chain
@@ -88,11 +20,48 @@ declare class MppChargeClient {
  * @stellar/mpp library handles the 402 challenge-response cycle.
  */
 
+/** A WebSocket socket as consumed by the mpp-session-ws stream. */
+interface WebSocketLike {
+    readyState: number;
+    close(code?: number, reason?: string): void;
+}
+/** Callbacks a WebSocket factory must wire to the underlying socket. */
+interface WebSocketHandlers {
+    onOpen(): void;
+    onMessage(data: string): void;
+    onClose(code: number, reason: string): void;
+    onError(): void;
+}
+/**
+ * Creates a WebSocket connection with the given handshake headers.
+ * Injected for testability; defaults to the runtime WebSocket global
+ * (undici in Node ≥ 22 supports handshake headers via its options object).
+ */
+type WebSocketFactory = (url: string, init: {
+    headers: Record<string, string>;
+}, handlers: WebSocketHandlers) => WebSocketLike;
 declare class MppSessionClient {
     private readonly keypair;
     private readonly network;
-    constructor(keypair: Keypair, network: 'testnet' | 'mainnet');
-    openSession(url: string, manifest: RouteDockManifest, commitmentSecret: string): Promise<SessionHandle>;
+    private readonly retryPolicy?;
+    private readonly webSocketFactory;
+    constructor(keypair: Keypair, network: 'testnet' | 'mainnet', retryPolicy?: RetryPolicy | undefined, webSocketFactory?: WebSocketFactory);
+    openSession(url: string, manifest: RouteDockManifest, commitmentSecret: string, options?: SessionOptions, onSpend?: (amount: string) => Promise<void>): Promise<SessionHandle>;
+    /**
+     * mpp-session-ws streaming transport.
+     *
+     * Mirrors the issue's three-step sequence:
+     *   1. open the channel — probe the provider URL over HTTP;
+     *   2. negotiate the voucher — sign the mppx 402 challenge into a credential;
+     *   3. upgrade the HTTP connection to WebSocket — hand the signed voucher to
+     *      the provider as the Authorization header of the WebSocket handshake.
+     *
+     * Each server frame is yielded (JSON frames parsed; raw strings yielded
+     * as-is). The stream ends when the server closes the socket with a normal
+     * close code (1000/1001); abnormal closes and connection failures surface as
+     * RouteDockChannelStateError.
+     */
+    private streamWebSocket;
 }
 
-export { type ModeSelectOptions, MppChargeClient, MppSessionClient, PaymentMode, PaymentResult, RouteDockClient, type RouteDockClientConfig, RouteDockManifest, SessionHandle, type SpendCap, X402Client, fetchManifest, selectMode };
+export { MppSessionClient, RetryPolicy, RouteDockManifest, SessionHandle, SessionOptions, type WebSocketFactory, type WebSocketHandlers, type WebSocketLike };