@t402/core 2.5.0 → 2.6.1

package/dist/esm/http/index.d.mts

@@ -1,8 +1,337 @@
 import { c as PaymentRequired, S as SettleResponse, a as PaymentPayload, P as PaymentRequirements } from '../mechanisms-dYCiYgko.mjs';
-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-CstWZOsH.mjs';
+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-Jmmvy9kc.mjs';
 export { f as t402HTTPClient } from '../t402HTTPClient-DbIXpGXL.mjs';
 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 };

package/dist/esm/http/index.mjs

@@ -1,6 +1,8 @@
 import {
   HTTPFacilitatorClient,
+  IntentClient,
   RouteConfigurationError,
+  StreamingClient,
   decodePaymentRequiredHeader,
   decodePaymentResponseHeader,
   decodePaymentSignatureHeader,
@@ -9,14 +11,16 @@ import {
   encodePaymentSignatureHeader,
   t402HTTPClient,
   t402HTTPResourceServer
-} from "../chunk-7RHSIMQL.mjs";
-import "../chunk-3VTYR43U.mjs";
+} from "../chunk-4DIIUML6.mjs";
+import "../chunk-YM7W5RG3.mjs";
 import "../chunk-STKQDKUH.mjs";
 import "../chunk-LJ4M5Z5U.mjs";
 import "../chunk-4W2Y3RJM.mjs";
 export {
   HTTPFacilitatorClient,
+  IntentClient,
   RouteConfigurationError,
+  StreamingClient,
   decodePaymentRequiredHeader,
   decodePaymentResponseHeader,
   decodePaymentSignatureHeader,

package/dist/esm/index.d.mts

@@ -1,3 +1,25 @@
+/**
+ * T402PaymentError - Structured error class for the T402 payment protocol.
+ *
+ * Wraps upstream errors with payment-specific context: phase, retryability,
+ * and optional HTTP status code.
+ */
+type PaymentPhase = "signing" | "submission" | "verification" | "settlement" | "unknown";
+declare class T402PaymentError extends Error {
+    readonly cause?: Error;
+    readonly phase: PaymentPhase;
+    readonly retryable: boolean;
+    readonly code?: number;
+    constructor(message: string, options?: {
+        cause?: Error;
+        phase?: PaymentPhase;
+        retryable?: boolean;
+        code?: number;
+    });
+    isRetryable(): boolean;
+    toJSON(): Record<string, unknown>;
+}
+
 declare const t402Version = 2;
 
-export { t402Version };
+export { type PaymentPhase, T402PaymentError, t402Version };

package/dist/esm/index.mjs

@@ -1,8 +1,10 @@
 import {
+  T402PaymentError,
   t402Version
-} from "./chunk-3VTYR43U.mjs";
+} from "./chunk-YM7W5RG3.mjs";
 import "./chunk-4W2Y3RJM.mjs";
 export {
+  T402PaymentError,
   t402Version
 };
 //# sourceMappingURL=index.mjs.map

package/dist/esm/server/index.d.mts

@@ -1,3 +1,3 @@
-export { C as CompiledRoute, F as FacilitatorClient, b as FacilitatorConfig, H as HTTPAdapter, c as HTTPFacilitatorClient, d as HTTPProcessResult, e as HTTPRequestContext, f as HTTPResponseInstructions, g as PaywallConfig, h as PaywallProvider, i as ProcessSettleFailureResponse, j as ProcessSettleResultResponse, k as ProcessSettleSuccessResponse, p as ResourceConfig, q as ResourceInfo, R as RouteConfig, l as RouteConfigurationError, m as RouteValidationError, n as RoutesConfig, U as UnpaidResponseBody, o as UnpaidResponseResult, t as t402HTTPResourceServer, r as t402ResourceServer } from '../t402HTTPResourceServer-CstWZOsH.mjs';
+export { C as CompiledRoute, F as FacilitatorClient, b as FacilitatorConfig, H as HTTPAdapter, c as HTTPFacilitatorClient, d as HTTPProcessResult, e as HTTPRequestContext, f as HTTPResponseInstructions, g as PaywallConfig, h as PaywallProvider, i as ProcessSettleFailureResponse, j as ProcessSettleResultResponse, k as ProcessSettleSuccessResponse, p as ResourceConfig, q as ResourceInfo, R as RouteConfig, l as RouteConfigurationError, m as RouteValidationError, n as RoutesConfig, S as SettleOptions, U as UnpaidResponseBody, o as UnpaidResponseResult, t as t402HTTPResourceServer, r as t402ResourceServer } from '../t402HTTPResourceServer-Jmmvy9kc.mjs';
 import '../mechanisms-dYCiYgko.mjs';
 import 'zod';

package/dist/esm/server/index.mjs

@@ -2,10 +2,10 @@ import {
   HTTPFacilitatorClient,
   RouteConfigurationError,
   t402HTTPResourceServer
-} from "../chunk-7RHSIMQL.mjs";
+} from "../chunk-4DIIUML6.mjs";
 import {
   t402Version
-} from "../chunk-3VTYR43U.mjs";
+} from "../chunk-YM7W5RG3.mjs";
 import "../chunk-STKQDKUH.mjs";
 import {
   deepEqual,

package/dist/esm/{t402HTTPResourceServer-CstWZOsH.d.mts → t402HTTPResourceServer-Jmmvy9kc.d.mts}

@@ -1,5 +1,9 @@
 import { a as PaymentPayload, P as PaymentRequirements, V as VerifyResponse, S as SettleResponse, e as SupportedResponse, N as Network, f as SchemeNetworkServer, R as ResourceServerExtension, g as SupportedKind, h as Price, c as PaymentRequired } from './mechanisms-dYCiYgko.mjs';
 
+interface SettleOptions {
+    /** Optional idempotency key for replay protection */
+    idempotencyKey?: string;
+}
 interface FacilitatorConfig {
     url?: string;
     createAuthHeaders?: () => Promise<{
@@ -26,9 +30,10 @@ interface FacilitatorClient {
      *
      * @param paymentPayload - The payment to settle
      * @param paymentRequirements - The requirements for settlement
+     * @param options - Optional settings including idempotency key
      * @returns Settlement response
      */
-    settle(paymentPayload: PaymentPayload, paymentRequirements: PaymentRequirements): Promise<SettleResponse>;
+    settle(paymentPayload: PaymentPayload, paymentRequirements: PaymentRequirements, options?: SettleOptions): Promise<SettleResponse>;
     /**
      * Get supported payment kinds and extensions from the facilitator
      *
@@ -62,9 +67,10 @@ declare class HTTPFacilitatorClient implements FacilitatorClient {
      *
      * @param paymentPayload - The payment to settle
      * @param paymentRequirements - The requirements for settlement
+     * @param options - Optional settings including idempotency key
      * @returns Settlement response
      */
-    settle(paymentPayload: PaymentPayload, paymentRequirements: PaymentRequirements): Promise<SettleResponse>;
+    settle(paymentPayload: PaymentPayload, paymentRequirements: PaymentRequirements, options?: SettleOptions): Promise<SettleResponse>;
     /**
      * Get supported payment kinds and extensions from the facilitator
      *
@@ -467,7 +473,6 @@ interface RouteConfig {
      *
      * If not provided, defaults to { contentType: 'application/json', body: {} }.
      *
-     * @param context - The HTTP request context
      * @returns An object containing both contentType and body for the 402 response
      */
     unpaidResponseBody?: UnpaidResponseBody;
@@ -716,4 +721,4 @@ declare class t402HTTPResourceServer {
     private getDisplayAmount;
 }
 
-export { type CompiledRoute as C, type DynamicPayTo as D, type FacilitatorClient as F, type HTTPAdapter as H, type PaymentOption as P, type RouteConfig as R, type UnpaidResponseBody as U, type DynamicPrice as a, type FacilitatorConfig as b, HTTPFacilitatorClient as c, type HTTPProcessResult as d, type HTTPRequestContext as e, type HTTPResponseInstructions as f, type PaywallConfig as g, type PaywallProvider as h, type ProcessSettleFailureResponse as i, type ProcessSettleResultResponse as j, type ProcessSettleSuccessResponse as k, RouteConfigurationError as l, type RouteValidationError as m, type RoutesConfig as n, type UnpaidResponseResult as o, type ResourceConfig as p, type ResourceInfo as q, t402ResourceServer as r, t402HTTPResourceServer as t };
+export { type CompiledRoute as C, type DynamicPayTo as D, type FacilitatorClient as F, type HTTPAdapter as H, type PaymentOption as P, type RouteConfig as R, type SettleOptions as S, type UnpaidResponseBody as U, type DynamicPrice as a, type FacilitatorConfig as b, HTTPFacilitatorClient as c, type HTTPProcessResult as d, type HTTPRequestContext as e, type HTTPResponseInstructions as f, type PaywallConfig as g, type PaywallProvider as h, type ProcessSettleFailureResponse as i, type ProcessSettleResultResponse as j, type ProcessSettleSuccessResponse as k, RouteConfigurationError as l, type RouteValidationError as m, type RoutesConfig as n, type UnpaidResponseResult as o, type ResourceConfig as p, type ResourceInfo as q, t402ResourceServer as r, t402HTTPResourceServer as t };

package/package.json

@@ -1,30 +1,42 @@
 {
   "name": "@t402/core",
-  "version": "2.5.0",
+  "version": "2.6.1",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
   "types": "./dist/cjs/index.d.ts",
-  "keywords": [],
+  "keywords": [
+    "t402",
+    "payment",
+    "protocol",
+    "types",
+    "http-402",
+    "stablecoin",
+    "usdt"
+  ],
   "license": "Apache-2.0",
   "author": "T402 Team",
-  "repository": "https://github.com/t402-io/t402",
-  "description": "t402 Payment Protocol",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/t402-io/t402.git",
+    "directory": "sdks/typescript/packages/core"
+  },
+  "description": "Core types, schemas, and constants for the T402 payment protocol",
   "devDependencies": {
     "@eslint/js": "^9.39.2",
-    "@types/node": "^25.2.2",
-    "@typescript-eslint/eslint-plugin": "^8.55.0",
-    "@typescript-eslint/parser": "^8.55.0",
+    "@types/node": "^25.2.3",
+    "@typescript-eslint/eslint-plugin": "^8.56.0",
+    "@typescript-eslint/parser": "^8.56.0",
     "eslint": "^9.24.0",
     "eslint-plugin-import": "^2.31.0",
-    "eslint-plugin-jsdoc": "^62.5.4",
+    "eslint-plugin-jsdoc": "^62.6.0",
     "eslint-plugin-prettier": "^5.5.5",
-    "glob": "^13.0.0",
+    "glob": "^13.0.5",
     "prettier": "3.8.1",
     "tsup": "^8.5.1",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vite": "^7.3.1",
-    "vite-tsconfig-paths": "^6.1.0",
+    "vite-tsconfig-paths": "^6.1.1",
     "vitest": "^3.2.4"
   },
   "dependencies": {
@@ -115,6 +127,10 @@
   "files": [
     "dist"
   ],
+  "homepage": "https://t402.io",
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "start": "tsx --env-file=.env index.ts",
     "build": "tsup",

package/dist/esm/chunk-3VTYR43U.mjs

@@ -1,7 +0,0 @@
-// src/index.ts
-var t402Version = 2;
-
-export {
-  t402Version
-};
-//# sourceMappingURL=chunk-3VTYR43U.mjs.map

package/dist/esm/chunk-3VTYR43U.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/index.ts"],"sourcesContent":["export const t402Version = 2;\n"],"mappings":";AAAO,IAAM,cAAc;","names":[]}