@t402/core 2.5.0 → 2.6.1

package/dist/cjs/http/index.d.ts

@@ -1,8 +1,337 @@
 import { c as PaymentRequired, S as SettleResponse, a as PaymentPayload, P as PaymentRequirements } from '../mechanisms-dYCiYgko.js';
-export { C as CompiledRoute, D as DynamicPayTo, a as DynamicPrice, F as FacilitatorClient, b as FacilitatorConfig, H as HTTPAdapter, c as HTTPFacilitatorClient, d as HTTPProcessResult, e as HTTPRequestContext, f as HTTPResponseInstructions, P as PaymentOption, g as PaywallConfig, h as PaywallProvider, i as ProcessSettleFailureResponse, j as ProcessSettleResultResponse, k as ProcessSettleSuccessResponse, R as RouteConfig, l as RouteConfigurationError, m as RouteValidationError, n as RoutesConfig, U as UnpaidResponseBody, o as UnpaidResponseResult, t as t402HTTPResourceServer } from '../t402HTTPResourceServer-B-aOi0BZ.js';
+export { C as CompiledRoute, D as DynamicPayTo, a as DynamicPrice, F as FacilitatorClient, b as FacilitatorConfig, H as HTTPAdapter, c as HTTPFacilitatorClient, d as HTTPProcessResult, e as HTTPRequestContext, f as HTTPResponseInstructions, P as PaymentOption, g as PaywallConfig, h as PaywallProvider, i as ProcessSettleFailureResponse, j as ProcessSettleResultResponse, k as ProcessSettleSuccessResponse, R as RouteConfig, l as RouteConfigurationError, m as RouteValidationError, n as RoutesConfig, S as SettleOptions, U as UnpaidResponseBody, o as UnpaidResponseResult, t as t402HTTPResourceServer } from '../t402HTTPResourceServer-BIEvnbwL.js';
 export { f as t402HTTPClient } from '../t402HTTPClient-CHaMMGBY.js';
 import 'zod';
 
+type StreamStatus = "pending" | "active" | "paused" | "closing" | "closed" | "cancelled" | "expired";
+interface StreamMetadata {
+    resourceId?: string;
+    description?: string;
+    tags?: string[];
+    extra?: Record<string, string>;
+}
+interface Stream {
+    id: string;
+    network: string;
+    scheme: string;
+    payer: string;
+    payee: string;
+    asset: string;
+    maxAmount: string;
+    currentAmount: string;
+    settledAmount: string;
+    ratePerSecond: string;
+    status: StreamStatus;
+    createdAt: string;
+    activatedAt?: string;
+    lastUpdatedAt: string;
+    expiresAt?: string;
+    closedAt?: string;
+    depositTxHash: string;
+    settlementTxHash: string;
+    metadata: StreamMetadata;
+}
+interface StreamUpdate {
+    id: string;
+    streamId: string;
+    amount: string;
+    signature: string;
+    timestamp: string;
+    sequenceNum: number;
+    resourceUnits: number;
+}
+interface StreamStats {
+    totalUpdates: number;
+    averageRate: string;
+    duration: number;
+    resourcesUsed: number;
+    efficiencyScore: number;
+}
+interface OpenStreamRequest {
+    network: string;
+    scheme: string;
+    payer: string;
+    payee: string;
+    asset: string;
+    maxAmount: string;
+    ratePerSecond?: string;
+    expiresAt?: string;
+    signature: string;
+    metadata?: StreamMetadata;
+}
+interface UpdateStreamRequest {
+    streamId: string;
+    amount: string;
+    signature: string;
+    resourceUnits?: number;
+}
+interface CloseStreamRequest {
+    streamId: string;
+    finalAmount: string;
+    payerSignature: string;
+    payeeSignature?: string;
+    reason?: string;
+}
+interface ListStreamsParams {
+    network?: string;
+    payer?: string;
+    payee?: string;
+    status?: StreamStatus[];
+    limit?: number;
+    offset?: number;
+    orderBy?: string;
+    orderDesc?: boolean;
+}
+interface OpenStreamResponse {
+    stream: Stream;
+    depositAmount?: string;
+    depositTo?: string;
+}
+interface UpdateStreamResponse {
+    stream: Stream;
+    update: StreamUpdate;
+    remaining: string;
+    canContinue: boolean;
+}
+interface CloseStreamResponse {
+    stream: Stream;
+    settledAmount: string;
+    txHash: string;
+    refundAmount: string;
+}
+interface GetStreamResponse {
+    stream: Stream;
+    updates?: StreamUpdate[];
+    stats?: StreamStats;
+}
+interface ListStreamsResponse {
+    streams: Stream[];
+    total: number;
+    limit: number;
+    offset: number;
+    hasMore: boolean;
+}
+interface PauseResumeResponse {
+    status: string;
+    message: string;
+}
+interface StreamingClientConfig {
+    url?: string;
+    apiKey?: string;
+    requesterAddress?: string;
+}
+/**
+ * HTTP client for the t402 facilitator streaming API.
+ * Provides methods for managing payment streams.
+ */
+declare class StreamingClient {
+    readonly url: string;
+    private readonly apiKey?;
+    private readonly requesterAddress?;
+    constructor(config?: StreamingClientConfig);
+    /**
+     * Open a new payment stream
+     */
+    openStream(params: OpenStreamRequest): Promise<OpenStreamResponse>;
+    /**
+     * Update a stream with a new cumulative amount
+     */
+    updateStream(params: UpdateStreamRequest): Promise<UpdateStreamResponse>;
+    /**
+     * Close a stream and settle the final amount
+     */
+    closeStream(params: CloseStreamRequest): Promise<CloseStreamResponse>;
+    /**
+     * Get stream details by ID
+     */
+    getStream(id: string, options?: {
+        includeUpdates?: boolean;
+        includeStats?: boolean;
+    }): Promise<GetStreamResponse>;
+    /**
+     * Pause an active stream
+     */
+    pauseStream(id: string): Promise<PauseResumeResponse>;
+    /**
+     * Resume a paused stream
+     */
+    resumeStream(id: string): Promise<PauseResumeResponse>;
+    /**
+     * List streams with optional filters
+     */
+    listStreams(filters?: ListStreamsParams): Promise<ListStreamsResponse>;
+    private buildHeaders;
+    private post;
+    private get;
+}
+
+type IntentStatus = "pending" | "routed" | "executing" | "completed" | "failed" | "cancelled" | "expired";
+type IntentPriority = "low" | "normal" | "high" | "urgent";
+type RouteStepType = "transfer" | "swap" | "bridge" | "approve" | "wrap" | "unwrap";
+interface RouteStep {
+    order: number;
+    type: RouteStepType;
+    network: string;
+    protocol?: string;
+    fromAsset: string;
+    toAsset: string;
+    fromAmount: string;
+    toAmount: string;
+    gasEstimate?: string;
+    data?: string;
+}
+interface Route {
+    id: string;
+    sourceNetwork: string;
+    targetNetwork: string;
+    sourceAsset: string;
+    targetAsset: string;
+    inputAmount: string;
+    outputAmount: string;
+    estimatedGas: string;
+    estimatedTime: number;
+    slippage: number;
+    score: number;
+    steps: RouteStep[];
+    requiresBridge: boolean;
+    bridgeProtocol?: string;
+    validUntil: string;
+}
+interface Intent {
+    id: string;
+    payer: string;
+    payee: string;
+    amount: string;
+    asset: string;
+    sourceNetworks?: string[];
+    targetNetwork?: string;
+    maxSlippage: number;
+    maxGasCost?: string;
+    priority: IntentPriority;
+    status: IntentStatus;
+    selectedRoute?: Route;
+    availableRoutes?: Route[];
+    createdAt: string;
+    expiresAt: string;
+    executedAt?: string;
+    txHashes?: string[];
+    errorMessage?: string;
+    metadata?: Record<string, string>;
+}
+interface CreateIntentRequest {
+    payer: string;
+    payee: string;
+    amount: string;
+    asset: string;
+    sourceNetworks?: string[];
+    targetNetwork?: string;
+    maxSlippage?: number;
+    maxGasCost?: string;
+    priority?: IntentPriority;
+    expiresIn?: number;
+    metadata?: Record<string, string>;
+}
+interface SelectRouteRequest {
+    routeId: string;
+}
+interface ExecuteIntentRequest {
+    signature: string;
+    routeId?: string;
+}
+interface CancelIntentRequest {
+    reason?: string;
+}
+interface ListIntentsParams {
+    payer?: string;
+    payee?: string;
+    status?: IntentStatus[];
+    limit?: number;
+    offset?: number;
+}
+interface CreateIntentResponse {
+    intent: Intent;
+    availableRoutes: Route[];
+    recommendedRoute?: Route;
+}
+interface SelectRouteResponse {
+    intent: Intent;
+    selectedRoute: Route;
+}
+interface ExecuteIntentResponse {
+    intent: Intent;
+    txHashes: string[];
+    status: string;
+    message?: string;
+}
+interface GetIntentResponse {
+    intent: Intent;
+}
+interface ListIntentsResponse {
+    intents: Intent[];
+    total: number;
+    limit: number;
+    offset: number;
+    hasMore: boolean;
+}
+interface CancelIntentResponse {
+    status: string;
+    message: string;
+}
+interface RefreshRoutesResponse {
+    intent: Intent;
+    availableRoutes: Route[];
+    recommendedRoute?: Route;
+}
+type IntentStats = Record<string, number>;
+interface IntentClientConfig {
+    url?: string;
+    apiKey?: string;
+}
+/**
+ * HTTP client for the t402 facilitator intent API.
+ * Provides methods for creating and managing cross-chain payment intents.
+ */
+declare class IntentClient {
+    readonly url: string;
+    private readonly apiKey?;
+    constructor(config?: IntentClientConfig);
+    /**
+     * Create a new payment intent and get available routes
+     */
+    createIntent(params: CreateIntentRequest): Promise<CreateIntentResponse>;
+    /**
+     * Get intent details by ID
+     */
+    getIntent(id: string): Promise<GetIntentResponse>;
+    /**
+     * Select a route for an intent
+     */
+    selectRoute(id: string, params: SelectRouteRequest): Promise<SelectRouteResponse>;
+    /**
+     * Execute an intent with a signed authorization
+     */
+    executeIntent(id: string, params: ExecuteIntentRequest): Promise<ExecuteIntentResponse>;
+    /**
+     * Cancel a pending intent
+     */
+    cancelIntent(id: string, params?: CancelIntentRequest): Promise<CancelIntentResponse>;
+    /**
+     * Refresh available routes for an intent
+     */
+    refreshRoutes(id: string): Promise<RefreshRoutesResponse>;
+    /**
+     * List intents with optional filters
+     */
+    listIntents(filters?: ListIntentsParams): Promise<ListIntentsResponse>;
+    /**
+     * Get intent statistics (counts by status)
+     */
+    getIntentStats(): Promise<IntentStats>;
+    private buildHeaders;
+    private post;
+    private get;
+}
+
 type QueryParamMethods = "GET" | "HEAD" | "DELETE";
 type BodyMethods = "POST" | "PUT" | "PATCH";
 /**
@@ -56,4 +385,4 @@ declare function encodePaymentResponseHeader(paymentResponse: SettleResponse & {
  */
 declare function decodePaymentResponseHeader(paymentResponseHeader: string): SettleResponse;
 
-export { type BodyMethods, type QueryParamMethods, decodePaymentRequiredHeader, decodePaymentResponseHeader, decodePaymentSignatureHeader, encodePaymentRequiredHeader, encodePaymentResponseHeader, encodePaymentSignatureHeader };
+export { type BodyMethods, type CancelIntentRequest, type CancelIntentResponse, type CloseStreamRequest, type CloseStreamResponse, type CreateIntentRequest, type CreateIntentResponse, type ExecuteIntentRequest, type ExecuteIntentResponse, type GetIntentResponse, type GetStreamResponse, type Intent, IntentClient, type IntentClientConfig, type IntentPriority, type IntentStats, type IntentStatus, type ListIntentsParams, type ListIntentsResponse, type ListStreamsParams, type ListStreamsResponse, type OpenStreamRequest, type OpenStreamResponse, type PauseResumeResponse, type QueryParamMethods, type RefreshRoutesResponse, type Route, type RouteStep, type RouteStepType, type SelectRouteRequest, type SelectRouteResponse, type Stream, type StreamMetadata, type StreamStats, type StreamStatus, type StreamUpdate, StreamingClient, type StreamingClientConfig, type UpdateStreamRequest, type UpdateStreamResponse, decodePaymentRequiredHeader, decodePaymentResponseHeader, decodePaymentSignatureHeader, encodePaymentRequiredHeader, encodePaymentResponseHeader, encodePaymentSignatureHeader };