@routedock/routedock 0.1.0

package/dist/client.d.cts

@@ -0,0 +1,98 @@
+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 { Keypair } from '@stellar/stellar-sdk';
+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>;
+}
+
+/**
+ * MppSessionClient — uses @stellar/mpp channel/client for off-chain
+ * cumulative commitments against a pre-deployed one-way-channel contract.
+ *
+ * The channel is deployed and funded before the agent runs. The client
+ * signs ed25519 commitments per the one-way-channel protocol — the
+ * @stellar/mpp library handles the 402 challenge-response cycle.
+ */
+
+declare class MppSessionClient {
+    private readonly keypair;
+    private readonly network;
+    constructor(keypair: Keypair, network: 'testnet' | 'mainnet');
+    openSession(url: string, manifest: RouteDockManifest, commitmentSecret: string): Promise<SessionHandle>;
+}
+
+export { type ModeSelectOptions, MppChargeClient, MppSessionClient, PaymentMode, PaymentResult, RouteDockClient, type RouteDockClientConfig, RouteDockManifest, SessionHandle, type SpendCap, X402Client, fetchManifest, selectMode };

package/dist/client.d.ts

@@ -0,0 +1,98 @@
+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 { Keypair } from '@stellar/stellar-sdk';
+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>;
+}
+
+/**
+ * MppSessionClient — uses @stellar/mpp channel/client for off-chain
+ * cumulative commitments against a pre-deployed one-way-channel contract.
+ *
+ * The channel is deployed and funded before the agent runs. The client
+ * signs ed25519 commitments per the one-way-channel protocol — the
+ * @stellar/mpp library handles the 402 challenge-response cycle.
+ */
+
+declare class MppSessionClient {
+    private readonly keypair;
+    private readonly network;
+    constructor(keypair: Keypair, network: 'testnet' | 'mainnet');
+    openSession(url: string, manifest: RouteDockManifest, commitmentSecret: string): Promise<SessionHandle>;
+}
+
+export { type ModeSelectOptions, MppChargeClient, MppSessionClient, PaymentMode, PaymentResult, RouteDockClient, type RouteDockClientConfig, RouteDockManifest, SessionHandle, type SpendCap, X402Client, fetchManifest, selectMode };