@t402/core 2.6.0 → 2.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (18) hide show
  1. package/dist/cjs/client/index.js.map +1 -1
  2. package/dist/cjs/http/index.d.ts +331 -2
  3. package/dist/cjs/http/index.js +250 -1
  4. package/dist/cjs/http/index.js.map +1 -1
  5. package/dist/cjs/server/index.d.ts +1 -1
  6. package/dist/cjs/server/index.js +5 -1
  7. package/dist/cjs/server/index.js.map +1 -1
  8. package/dist/cjs/{t402HTTPResourceServer-CGZh_p2c.d.ts → t402HTTPResourceServer-BIEvnbwL.d.ts} +9 -3
  9. package/dist/esm/{chunk-Z5HFSNZZ.mjs → chunk-4DIIUML6.mjs} +249 -2
  10. package/dist/esm/chunk-4DIIUML6.mjs.map +1 -0
  11. package/dist/esm/client/index.mjs +1 -1
  12. package/dist/esm/http/index.d.mts +331 -2
  13. package/dist/esm/http/index.mjs +5 -1
  14. package/dist/esm/server/index.d.mts +1 -1
  15. package/dist/esm/server/index.mjs +1 -1
  16. package/dist/esm/{t402HTTPResourceServer-DDxVMmS2.d.mts → t402HTTPResourceServer-Jmmvy9kc.d.mts} +9 -3
  17. package/package.json +1 -1
  18. package/dist/esm/chunk-Z5HFSNZZ.mjs.map +0 -1
package/dist/cjs/client/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../src/client/index.ts","../../../src/errors.ts","../../../src/index.ts","../../../src/utils/index.ts","../../../src/client/t402Client.ts","../../../src/types/schemas.ts","../../../src/http/index.ts","../../../src/http/t402HTTPClient.ts","../../../src/client/tokenSelector.ts"],"sourcesContent":["export * from \"./t402Client\";\nexport * from \"../http/t402HTTPClient\";\nexport * from \"./tokenSelector\";","/**\n * T402PaymentError - Structured error class for the T402 payment protocol.\n *\n * Wraps upstream errors with payment-specific context: phase, retryability,\n * and optional HTTP status code.\n */\n\nexport type PaymentPhase = \"signing\" | \"submission\" | \"verification\" | \"settlement\" | \"unknown\";\n\nexport class T402PaymentError extends Error {\n readonly cause?: Error;\n readonly phase: PaymentPhase;\n readonly retryable: boolean;\n readonly code?: number;\n\n constructor(\n message: string,\n options?: {\n cause?: Error;\n phase?: PaymentPhase;\n retryable?: boolean;\n code?: number;\n },\n ) {\n super(message);\n this.name = \"T402PaymentError\";\n this.cause = options?.cause;\n this.phase = options?.phase ?? \"unknown\";\n this.retryable = options?.retryable ?? false;\n this.code = options?.code;\n\n if (Error.captureStackTrace) {\n Error.captureStackTrace(this, T402PaymentError);\n }\n }\n\n isRetryable(): boolean {\n return this.retryable;\n }\n\n toJSON(): Record<string, unknown> {\n return {\n name: this.name,\n message: this.message,\n phase: this.phase,\n retryable: this.retryable,\n code: this.code,\n cause: this.cause?.message,\n };\n }\n}\n","export const t402Version = 2;\n\n// Payment error\nexport { T402PaymentError } from \"./errors\";\nexport type { PaymentPhase } from \"./errors\";\n","import { Network } from \"../types\";\n\n// ============================================================================\n// Cryptographically Secure Random Utilities\n// ============================================================================\n\n/**\n * Get the crypto object, works in both browser and Node.js (19+)\n *\n * @returns The crypto object\n * @throws Error if crypto API is not available\n */\nfunction getCrypto(): Crypto {\n const cryptoObj = globalThis.crypto;\n\n if (!cryptoObj || typeof cryptoObj.getRandomValues !== \"function\") {\n throw new Error(\n \"Crypto API not available. \" + \"Node.js 19+ or a browser with Web Crypto API is required.\",\n );\n }\n\n return cryptoObj;\n}\n\n/**\n * Generate a cryptographically secure random integer in range [0, max)\n *\n * Uses rejection sampling to ensure uniform distribution.\n *\n * @param max - Exclusive upper bound (must be > 0 and <= 2^32)\n * @returns Random integer in [0, max)\n * @throws Error if max is invalid or crypto unavailable\n */\nexport function cryptoRandomInt(max: number): number {\n if (max <= 0 || max > 0xffffffff || !Number.isInteger(max)) {\n throw new Error(`Invalid max value: ${max}. Must be positive integer <= 2^32`);\n }\n\n const crypto = getCrypto();\n const array = new Uint32Array(1);\n\n // Rejection sampling to avoid modulo bias\n const limit = Math.floor(0xffffffff / max) * max;\n let value: number;\n\n do {\n crypto.getRandomValues(array);\n value = array[0];\n } while (value >= limit);\n\n return value % max;\n}\n\n/**\n * Generate a cryptographically secure random BigInt\n *\n * @param bits - Number of bits (default 64, max 256)\n * @returns Random BigInt with specified number of bits\n * @throws Error if bits is invalid or crypto unavailable\n */\nexport function cryptoRandomBigInt(bits: number = 64): bigint {\n if (bits <= 0 || bits > 256) {\n throw new Error(`Invalid bits value: ${bits}. Must be 1-256`);\n }\n\n const crypto = getCrypto();\n const bytes = Math.ceil(bits / 8);\n const array = new Uint8Array(bytes);\n crypto.getRandomValues(array);\n\n // Convert bytes to BigInt\n let result = 0n;\n for (let i = 0; i < bytes; i++) {\n result = (result << 8n) | BigInt(array[i]);\n }\n\n // Mask to exact bit count\n const mask = (1n << BigInt(bits)) - 1n;\n return result & mask;\n}\n\n/**\n * Generate a cryptographically secure random hex string\n *\n * @param bytes - Number of random bytes (default 16)\n * @returns Hex-encoded random string\n * @throws Error if bytes is invalid or crypto unavailable\n */\nexport function cryptoRandomHex(bytes: number = 16): string {\n if (bytes <= 0 || bytes > 128) {\n throw new Error(`Invalid bytes value: ${bytes}. Must be 1-128`);\n }\n\n const crypto = getCrypto();\n const array = new Uint8Array(bytes);\n crypto.getRandomValues(array);\n\n return Array.from(array)\n .map(b => b.toString(16).padStart(2, \"0\"))\n .join(\"\");\n}\n\n// ============================================================================\n// Network and Scheme Utilities\n// ============================================================================\n\n/**\n * Scheme data structure for facilitator storage\n */\nexport interface SchemeData<T> {\n facilitator: T;\n networks: Set<Network>;\n pattern: Network;\n}\n\nexport const findSchemesByNetwork = <T>(\n map: Map<string, Map<string, T>>,\n network: Network,\n): Map<string, T> | undefined => {\n // Direct match first\n let implementationsByScheme = map.get(network);\n\n if (!implementationsByScheme) {\n // Try pattern matching for registered network patterns\n for (const [registeredNetworkPattern, implementations] of map.entries()) {\n // Convert the registered network pattern to a regex\n // e.g., \"eip155:*\" becomes /^eip155:.*$/\n const pattern = registeredNetworkPattern\n .replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\") // Escape special regex chars except *\n .replace(/\\\\\\*/g, \".*\"); // Replace escaped * with .*\n\n const regex = new RegExp(`^${pattern}$`);\n\n if (regex.test(network)) {\n implementationsByScheme = implementations;\n break;\n }\n }\n }\n\n return implementationsByScheme;\n};\n\nexport const findByNetworkAndScheme = <T>(\n map: Map<string, Map<string, T>>,\n scheme: string,\n network: Network,\n): T | undefined => {\n return findSchemesByNetwork(map, network)?.get(scheme);\n};\n\n/**\n * Finds a facilitator by scheme and network using pattern matching.\n * Works with new SchemeData storage structure.\n *\n * @param schemeMap - Map of scheme names to SchemeData\n * @param scheme - The scheme to find\n * @param network - The network to match against\n * @returns The facilitator if found, undefined otherwise\n */\nexport const findFacilitatorBySchemeAndNetwork = <T>(\n schemeMap: Map<string, SchemeData<T>>,\n scheme: string,\n network: Network,\n): T | undefined => {\n const schemeData = schemeMap.get(scheme);\n if (!schemeData) return undefined;\n\n // Check if network is in the stored networks set\n if (schemeData.networks.has(network)) {\n return schemeData.facilitator;\n }\n\n // Try pattern matching\n const patternRegex = new RegExp(\"^\" + schemeData.pattern.replace(\"*\", \".*\") + \"$\");\n if (patternRegex.test(network)) {\n return schemeData.facilitator;\n }\n\n return undefined;\n};\n\nexport const Base64EncodedRegex = /^[A-Za-z0-9+/]*={0,2}$/;\n\n/**\n * Encodes a string to base64 format\n *\n * @param data - The string to be encoded to base64\n * @returns The base64 encoded string\n */\nexport function safeBase64Encode(data: string): string {\n if (typeof globalThis !== \"undefined\" && typeof globalThis.btoa === \"function\") {\n return globalThis.btoa(data);\n }\n return Buffer.from(data).toString(\"base64\");\n}\n\n/**\n * Decodes a base64 string back to its original format\n *\n * @param data - The base64 encoded string to be decoded\n * @returns The decoded string in UTF-8 format\n */\nexport function safeBase64Decode(data: string): string {\n if (typeof globalThis !== \"undefined\" && typeof globalThis.atob === \"function\") {\n return globalThis.atob(data);\n }\n return Buffer.from(data, \"base64\").toString(\"utf-8\");\n}\n\n/**\n * Deep equality comparison for payment requirements\n * Uses a normalized JSON.stringify for consistent comparison\n *\n * @param obj1 - First object to compare\n * @param obj2 - Second object to compare\n * @returns True if objects are deeply equal\n */\nexport function deepEqual(obj1: unknown, obj2: unknown): boolean {\n // Normalize and stringify both objects for comparison\n // This handles nested objects, arrays, and different property orders\n const normalize = (obj: unknown): string => {\n // Handle primitives and null/undefined\n if (obj === null || obj === undefined) return JSON.stringify(obj);\n if (typeof obj !== \"object\") return JSON.stringify(obj);\n\n // Handle arrays\n if (Array.isArray(obj)) {\n return JSON.stringify(\n obj.map(item =>\n typeof item === \"object\" && item !== null ? JSON.parse(normalize(item)) : item,\n ),\n );\n }\n\n // Handle objects - sort keys and recursively normalize values\n const sorted: Record<string, unknown> = {};\n Object.keys(obj as Record<string, unknown>)\n .sort()\n .forEach(key => {\n const value = (obj as Record<string, unknown>)[key];\n sorted[key] =\n typeof value === \"object\" && value !== null ? JSON.parse(normalize(value)) : value;\n });\n return JSON.stringify(sorted);\n };\n\n try {\n return normalize(obj1) === normalize(obj2);\n } catch {\n // Fallback to simple comparison if normalization fails\n return JSON.stringify(obj1) === JSON.stringify(obj2);\n }\n}\n","import { t402Version } from \"..\";\nimport { SchemeNetworkClient } from \"../types/mechanisms\";\nimport { PaymentPayload, PaymentRequirements } from \"../types/payments\";\nimport { Network, PaymentRequired } from \"../types\";\nimport { findByNetworkAndScheme, findSchemesByNetwork } from \"../utils\";\n\n/**\n * Client Hook Context Interfaces\n */\n\nexport interface PaymentCreationContext {\n paymentRequired: PaymentRequired;\n selectedRequirements: PaymentRequirements;\n}\n\nexport interface PaymentCreatedContext extends PaymentCreationContext {\n paymentPayload: PaymentPayload;\n}\n\nexport interface PaymentCreationFailureContext extends PaymentCreationContext {\n error: Error;\n}\n\n/**\n * Client Hook Type Definitions\n */\n\nexport type BeforePaymentCreationHook = (\n context: PaymentCreationContext,\n) => Promise<void | { abort: true; reason: string }>;\n\nexport type AfterPaymentCreationHook = (context: PaymentCreatedContext) => Promise<void>;\n\nexport type OnPaymentCreationFailureHook = (\n context: PaymentCreationFailureContext,\n) => Promise<void | { recovered: true; payload: PaymentPayload }>;\n\nexport type SelectPaymentRequirements = (t402Version: number, paymentRequirements: PaymentRequirements[]) => PaymentRequirements;\n\n/**\n * A policy function that filters or transforms payment requirements.\n * Policies are applied in order before the selector chooses the final option.\n *\n * @param t402Version - The t402 protocol version\n * @param paymentRequirements - Array of payment requirements to filter/transform\n * @returns Filtered array of payment requirements\n */\nexport type PaymentPolicy = (t402Version: number, paymentRequirements: PaymentRequirements[]) => PaymentRequirements[];\n\n\n/**\n * Configuration for registering a payment scheme with a specific network\n */\nexport interface SchemeRegistration {\n /**\n * The network identifier (e.g., 'eip155:8453', 'solana:mainnet')\n */\n network: Network;\n\n /**\n * The scheme client implementation for this network\n */\n client: SchemeNetworkClient;\n\n /**\n * The t402 protocol version to use for this scheme\n *\n * @default 2\n */\n t402Version?: number;\n}\n\n/**\n * Configuration options for the fetch wrapper\n */\nexport interface t402ClientConfig {\n /**\n * Array of scheme registrations defining which payment methods are supported\n */\n schemes: SchemeRegistration[];\n\n /**\n * Policies to apply to the client\n */\n policies?: PaymentPolicy[];\n\n /**\n * Custom payment requirements selector function\n * If not provided, uses the default selector (first available option)\n */\n paymentRequirementsSelector?: SelectPaymentRequirements;\n}\n\n/**\n * Core client for managing t402 payment schemes and creating payment payloads.\n *\n * Handles registration of payment schemes, policy-based filtering of payment requirements,\n * and creation of payment payloads based on server requirements.\n */\nexport class t402Client {\n private readonly paymentRequirementsSelector: SelectPaymentRequirements;\n private readonly registeredClientSchemes: Map<number, Map<string, Map<string, SchemeNetworkClient>>> = new Map();\n private readonly policies: PaymentPolicy[] = [];\n\n private beforePaymentCreationHooks: BeforePaymentCreationHook[] = [];\n private afterPaymentCreationHooks: AfterPaymentCreationHook[] = [];\n private onPaymentCreationFailureHooks: OnPaymentCreationFailureHook[] = [];\n\n /**\n * Creates a new t402Client instance.\n *\n * @param paymentRequirementsSelector - Function to select payment requirements from available options\n */\n constructor(paymentRequirementsSelector?: SelectPaymentRequirements) {\n this.paymentRequirementsSelector = paymentRequirementsSelector || ((_t402Version, accepts) => accepts[0]);\n }\n\n /**\n * Creates a new t402Client instance from a configuration object.\n *\n * @param config - The client configuration including schemes, policies, and payment requirements selector\n * @returns A configured t402Client instance\n */\n static fromConfig(config: t402ClientConfig): t402Client {\n const client = new t402Client(config.paymentRequirementsSelector);\n config.schemes.forEach(scheme => {\n if (scheme.t402Version === 1) {\n client.registerV1(scheme.network, scheme.client);\n } else {\n client.register(scheme.network, scheme.client);\n }\n });\n config.policies?.forEach(policy => {\n client.registerPolicy(policy);\n });\n return client;\n }\n\n /**\n * Registers a scheme client for the current t402 version.\n *\n * @param network - The network to register the client for\n * @param client - The scheme network client to register\n * @returns The t402Client instance for chaining\n */\n register(network: Network, client: SchemeNetworkClient): t402Client {\n return this._registerScheme(t402Version, network, client);\n }\n\n /**\n * Registers a scheme client for t402 version 1.\n *\n * @param network - The v1 network identifier (e.g., 'base-sepolia', 'solana-devnet')\n * @param client - The scheme network client to register\n * @returns The t402Client instance for chaining\n */\n registerV1(network: string, client: SchemeNetworkClient): t402Client {\n return this._registerScheme(1, network as Network, client);\n }\n\n /**\n * Registers a policy to filter or transform payment requirements.\n *\n * Policies are applied in order after filtering by registered schemes\n * and before the selector chooses the final payment requirement.\n *\n * @param policy - Function to filter/transform payment requirements\n * @returns The t402Client instance for chaining\n *\n * @example\n * ```typescript\n * // Prefer cheaper options\n * client.registerPolicy((version, reqs) =>\n * reqs.filter(r => BigInt(r.value) < BigInt('1000000'))\n * );\n *\n * // Prefer specific networks\n * client.registerPolicy((version, reqs) =>\n * reqs.filter(r => r.network.startsWith('eip155:'))\n * );\n * ```\n */\n registerPolicy(policy: PaymentPolicy): t402Client {\n this.policies.push(policy);\n return this;\n }\n\n /**\n * Register a hook to execute before payment payload creation.\n * Can abort creation by returning { abort: true, reason: string }\n *\n * @param hook - The hook function to register\n * @returns The t402Client instance for chaining\n */\n onBeforePaymentCreation(hook: BeforePaymentCreationHook): t402Client {\n this.beforePaymentCreationHooks.push(hook);\n return this;\n }\n\n /**\n * Register a hook to execute after successful payment payload creation.\n *\n * @param hook - The hook function to register\n * @returns The t402Client instance for chaining\n */\n onAfterPaymentCreation(hook: AfterPaymentCreationHook): t402Client {\n this.afterPaymentCreationHooks.push(hook);\n return this;\n }\n\n /**\n * Register a hook to execute when payment payload creation fails.\n * Can recover from failure by returning { recovered: true, payload: PaymentPayload }\n *\n * @param hook - The hook function to register\n * @returns The t402Client instance for chaining\n */\n onPaymentCreationFailure(hook: OnPaymentCreationFailureHook): t402Client {\n this.onPaymentCreationFailureHooks.push(hook);\n return this;\n }\n\n /**\n * Creates a payment payload based on a PaymentRequired response.\n *\n * Automatically extracts t402Version, resource, and extensions from the PaymentRequired\n * response and constructs a complete PaymentPayload with the accepted requirements.\n *\n * @param paymentRequired - The PaymentRequired response from the server\n * @returns Promise resolving to the complete payment payload\n */\n async createPaymentPayload(\n paymentRequired: PaymentRequired,\n ): Promise<PaymentPayload> {\n const clientSchemesByNetwork = this.registeredClientSchemes.get(paymentRequired.t402Version);\n if (!clientSchemesByNetwork) {\n throw new Error(`No client registered for t402 version: ${paymentRequired.t402Version}`);\n }\n\n const requirements = this.selectPaymentRequirements(paymentRequired.t402Version, paymentRequired.accepts);\n\n const context: PaymentCreationContext = {\n paymentRequired,\n selectedRequirements: requirements,\n };\n\n // Execute beforePaymentCreation hooks\n for (const hook of this.beforePaymentCreationHooks) {\n const result = await hook(context);\n if (result && \"abort\" in result && result.abort) {\n throw new Error(`Payment creation aborted: ${result.reason}`);\n }\n }\n\n try {\n const schemeNetworkClient = findByNetworkAndScheme(clientSchemesByNetwork, requirements.scheme, requirements.network);\n if (!schemeNetworkClient) {\n throw new Error(`No client registered for scheme: ${requirements.scheme} and network: ${requirements.network}`);\n }\n\n const partialPayload = await schemeNetworkClient.createPaymentPayload(paymentRequired.t402Version, requirements);\n\n let paymentPayload: PaymentPayload;\n if (partialPayload.t402Version == 1) {\n paymentPayload = partialPayload as PaymentPayload;\n } else {\n paymentPayload = {\n ...partialPayload,\n extensions: paymentRequired.extensions,\n resource: paymentRequired.resource,\n accepted: requirements,\n };\n }\n\n // Execute afterPaymentCreation hooks\n const createdContext: PaymentCreatedContext = {\n ...context,\n paymentPayload,\n };\n\n for (const hook of this.afterPaymentCreationHooks) {\n await hook(createdContext);\n }\n\n return paymentPayload;\n } catch (error) {\n const failureContext: PaymentCreationFailureContext = {\n ...context,\n error: error as Error,\n };\n\n // Execute onPaymentCreationFailure hooks\n for (const hook of this.onPaymentCreationFailureHooks) {\n const result = await hook(failureContext);\n if (result && \"recovered\" in result && result.recovered) {\n return result.payload;\n }\n }\n\n throw error;\n }\n }\n\n\n\n /**\n * Selects appropriate payment requirements based on registered clients and policies.\n *\n * Selection process:\n * 1. Filter by registered schemes (network + scheme support)\n * 2. Apply all registered policies in order\n * 3. Use selector to choose final requirement\n *\n * @param t402Version - The t402 protocol version\n * @param paymentRequirements - Array of available payment requirements\n * @returns The selected payment requirements\n */\n private selectPaymentRequirements(t402Version: number, paymentRequirements: PaymentRequirements[]): PaymentRequirements {\n const clientSchemesByNetwork = this.registeredClientSchemes.get(t402Version);\n if (!clientSchemesByNetwork) {\n throw new Error(`No client registered for t402 version: ${t402Version}`);\n }\n\n // Step 1: Filter by registered schemes\n const supportedPaymentRequirements = paymentRequirements.filter(requirement => {\n let clientSchemes = findSchemesByNetwork(clientSchemesByNetwork, requirement.network);\n if (!clientSchemes) {\n return false;\n }\n\n return clientSchemes.has(requirement.scheme);\n })\n\n if (supportedPaymentRequirements.length === 0) {\n throw new Error(`No network/scheme registered for t402 version: ${t402Version} which comply with the payment requirements. ${JSON.stringify({\n t402Version,\n paymentRequirements,\n t402Versions: Array.from(this.registeredClientSchemes.keys()),\n networks: Array.from(clientSchemesByNetwork.keys()),\n schemes: Array.from(clientSchemesByNetwork.values()).map(schemes => Array.from(schemes.keys())).flat(),\n })}`);\n }\n\n // Step 2: Apply all policies in order\n let filteredRequirements = supportedPaymentRequirements;\n for (const policy of this.policies) {\n filteredRequirements = policy(t402Version, filteredRequirements);\n\n if (filteredRequirements.length === 0) {\n throw new Error(`All payment requirements were filtered out by policies for t402 version: ${t402Version}`);\n }\n }\n\n // Step 3: Use selector to choose final requirement\n return this.paymentRequirementsSelector(t402Version, filteredRequirements);\n }\n\n /**\n * Internal method to register a scheme client.\n *\n * @param t402Version - The t402 protocol version\n * @param network - The network to register the client for\n * @param client - The scheme network client to register\n * @returns The t402Client instance for chaining\n */\n private _registerScheme(t402Version: number, network: Network, client: SchemeNetworkClient): t402Client {\n if (!this.registeredClientSchemes.has(t402Version)) {\n this.registeredClientSchemes.set(t402Version, new Map());\n }\n const clientSchemesByNetwork = this.registeredClientSchemes.get(t402Version)!;\n if (!clientSchemesByNetwork.has(network)) {\n clientSchemesByNetwork.set(network, new Map());\n }\n\n const clientByScheme = clientSchemesByNetwork.get(network)!;\n if (!clientByScheme.has(client.scheme)) {\n clientByScheme.set(client.scheme, client);\n }\n\n return this;\n }\n}\n","import { z } from \"zod\";\n\n/**\n * Zod schemas for T402 protocol types.\n * Used for runtime validation of incoming data.\n */\n\n// Network format: \"namespace:reference\" (CAIP-2)\nexport const NetworkSchema = z.string().regex(/^[a-z0-9-]+:[a-zA-Z0-9-]+$/, {\n message: \"Network must be in CAIP-2 format (e.g., 'eip155:1', 'solana:mainnet')\",\n});\n\n// Resource info for V2 protocol\nexport const ResourceInfoSchema = z.object({\n url: z.string().url({ message: \"Resource URL must be a valid URL\" }),\n description: z.string().optional(),\n mimeType: z.string().optional(),\n});\n\n// Payment requirements (what the server needs)\nexport const PaymentRequirementsSchema = z.object({\n scheme: z.string().min(1, { message: \"Scheme is required\" }),\n network: NetworkSchema,\n asset: z.string().min(1, { message: \"Asset address is required\" }),\n amount: z.string().regex(/^\\d+$/, { message: \"Amount must be a non-negative integer string\" }),\n payTo: z.string().min(1, { message: \"PayTo address is required\" }),\n maxTimeoutSeconds: z\n .number()\n .int()\n .positive({ message: \"maxTimeoutSeconds must be a positive integer\" }),\n extra: z.record(z.unknown()),\n});\n\n// Payment required response (402 response)\nexport const PaymentRequiredSchema = z.object({\n t402Version: z.literal(2, {\n errorMap: () => ({ message: \"t402Version must be 2 for V2 protocol\" }),\n }),\n error: z.string().optional(),\n resource: ResourceInfoSchema,\n accepts: z\n .array(PaymentRequirementsSchema)\n .min(1, { message: \"At least one payment option is required\" }),\n extensions: z.record(z.unknown()).optional(),\n});\n\n// Payment payload (client's signed payment)\nexport const PaymentPayloadSchema = z.object({\n t402Version: z.literal(2, {\n errorMap: () => ({ message: \"t402Version must be 2 for V2 protocol\" }),\n }),\n resource: ResourceInfoSchema.optional(),\n accepted: PaymentRequirementsSchema,\n payload: z.record(z.unknown()),\n extensions: z.record(z.unknown()).optional(),\n});\n\n// Verify response from facilitator\nexport const VerifyResponseSchema = z.object({\n isValid: z.boolean(),\n invalidReason: z.string().optional(),\n payer: z.string().optional(),\n});\n\n// Settle response from facilitator\nexport const SettleResponseSchema = z.object({\n success: z.boolean(),\n transaction: z.string(),\n network: NetworkSchema,\n errorReason: z.string().optional(),\n payer: z.string().optional(),\n confirmations: z.string().optional(),\n});\n\n// V1 schemas for backward compatibility\nexport const PaymentRequirementsV1Schema = z.object({\n scheme: z.string().min(1),\n network: z.string().min(1),\n asset: z.string().min(1),\n amount: z.string().regex(/^\\d+$/),\n payTo: z.string().min(1),\n maxTimeoutSeconds: z.number().int().positive(),\n extra: z.record(z.unknown()).optional(),\n});\n\nexport const PaymentPayloadV1Schema = z.object({\n t402Version: z.literal(1).optional(),\n accepted: PaymentRequirementsV1Schema,\n payload: z.record(z.unknown()),\n});\n\n// Type inference helpers\nexport type ValidatedPaymentPayload = z.infer<typeof PaymentPayloadSchema>;\nexport type ValidatedPaymentRequired = z.infer<typeof PaymentRequiredSchema>;\nexport type ValidatedPaymentRequirements = z.infer<typeof PaymentRequirementsSchema>;\nexport type ValidatedVerifyResponse = z.infer<typeof VerifyResponseSchema>;\nexport type ValidatedSettleResponse = z.infer<typeof SettleResponseSchema>;\n\n/**\n * Parse and validate a PaymentPayload.\n *\n * @param data - The data to parse\n * @returns The validated payment payload\n * @throws ZodError if validation fails\n */\nexport function parsePaymentPayload(data: unknown): ValidatedPaymentPayload {\n return PaymentPayloadSchema.parse(data);\n}\n\n/**\n * Parse and validate a PaymentRequired response.\n *\n * @param data - The data to parse\n * @returns The validated payment required response\n * @throws ZodError if validation fails\n */\nexport function parsePaymentRequired(data: unknown): ValidatedPaymentRequired {\n return PaymentRequiredSchema.parse(data);\n}\n\n/**\n * Parse and validate PaymentRequirements.\n *\n * @param data - The data to parse\n * @returns The validated payment requirements\n * @throws ZodError if validation fails\n */\nexport function parsePaymentRequirements(data: unknown): ValidatedPaymentRequirements {\n return PaymentRequirementsSchema.parse(data);\n}\n\n/**\n * Safely parse a PaymentPayload, returning a result object.\n *\n * @param data - The data to parse\n * @returns The safe parse result\n */\nexport function safeParsePaymentPayload(\n data: unknown,\n): z.SafeParseReturnType<unknown, ValidatedPaymentPayload> {\n return PaymentPayloadSchema.safeParse(data);\n}\n\n/**\n * Safely parse a PaymentRequired response, returning a result object.\n *\n * @param data - The data to parse\n * @returns The safe parse result\n */\nexport function safeParsePaymentRequired(\n data: unknown,\n): z.SafeParseReturnType<unknown, ValidatedPaymentRequired> {\n return PaymentRequiredSchema.safeParse(data);\n}\n\n/**\n * Safely parse PaymentRequirements, returning a result object.\n *\n * @param data - The data to parse\n * @returns The safe parse result\n */\nexport function safeParsePaymentRequirements(\n data: unknown,\n): z.SafeParseReturnType<unknown, ValidatedPaymentRequirements> {\n return PaymentRequirementsSchema.safeParse(data);\n}\n","import { SettleResponse } from \"../types\";\nimport { PaymentPayload, PaymentRequired, PaymentRequirements } from \"../types/payments\";\nimport {\n PaymentPayloadSchema,\n PaymentRequiredSchema,\n SettleResponseSchema,\n} from \"../types/schemas\";\nimport { Base64EncodedRegex, safeBase64Decode, safeBase64Encode } from \"../utils\";\n\n// HTTP Methods that typically use query parameters\nexport type QueryParamMethods = \"GET\" | \"HEAD\" | \"DELETE\";\n\n// HTTP Methods that typically use request body\nexport type BodyMethods = \"POST\" | \"PUT\" | \"PATCH\";\n\n/**\n * Encodes a payment payload as a base64 header value.\n *\n * @param paymentPayload - The payment payload to encode\n * @returns Base64 encoded string representation of the payment payload\n */\nexport function encodePaymentSignatureHeader(paymentPayload: PaymentPayload): string {\n return safeBase64Encode(JSON.stringify(paymentPayload));\n}\n\n/**\n * Decodes a base64 payment signature header into a payment payload.\n * Validates the payload structure using Zod schema.\n *\n * @param paymentSignatureHeader - The base64 encoded payment signature header\n * @returns The decoded and validated payment payload\n * @throws Error if the header is invalid or fails schema validation\n */\nexport function decodePaymentSignatureHeader(paymentSignatureHeader: string): PaymentPayload {\n if (!Base64EncodedRegex.test(paymentSignatureHeader)) {\n throw new Error(\"Invalid payment signature header\");\n }\n const parsed = JSON.parse(safeBase64Decode(paymentSignatureHeader));\n // Validate structure with Zod, then cast to TypeScript type\n // (Zod validates the structure; TypeScript types add template literal constraints)\n PaymentPayloadSchema.parse(parsed);\n return parsed as PaymentPayload;\n}\n\n/**\n * Encodes a payment required object as a base64 header value.\n *\n * @param paymentRequired - The payment required object to encode\n * @returns Base64 encoded string representation of the payment required object\n */\nexport function encodePaymentRequiredHeader(paymentRequired: PaymentRequired): string {\n return safeBase64Encode(JSON.stringify(paymentRequired));\n}\n\n/**\n * Decodes a base64 payment required header into a payment required object.\n * Validates the structure using Zod schema.\n *\n * @param paymentRequiredHeader - The base64 encoded payment required header\n * @returns The decoded and validated payment required object\n * @throws Error if the header is invalid or fails schema validation\n */\nexport function decodePaymentRequiredHeader(paymentRequiredHeader: string): PaymentRequired {\n if (!Base64EncodedRegex.test(paymentRequiredHeader)) {\n throw new Error(\"Invalid payment required header\");\n }\n const parsed = JSON.parse(safeBase64Decode(paymentRequiredHeader));\n // Validate structure with Zod, then cast to TypeScript type\n PaymentRequiredSchema.parse(parsed);\n return parsed as PaymentRequired;\n}\n\n/**\n * Encodes a payment response as a base64 header value.\n *\n * @param paymentResponse - The payment response to encode\n * @returns Base64 encoded string representation of the payment response\n */\nexport function encodePaymentResponseHeader(\n paymentResponse: SettleResponse & { requirements: PaymentRequirements },\n): string {\n return safeBase64Encode(JSON.stringify(paymentResponse));\n}\n\n/**\n * Decodes a base64 payment response header into a settle response.\n * Validates the structure using Zod schema.\n *\n * @param paymentResponseHeader - The base64 encoded payment response header\n * @returns The decoded and validated settle response\n * @throws Error if the header is invalid or fails schema validation\n */\nexport function decodePaymentResponseHeader(paymentResponseHeader: string): SettleResponse {\n if (!Base64EncodedRegex.test(paymentResponseHeader)) {\n throw new Error(\"Invalid payment response header\");\n }\n const parsed = JSON.parse(safeBase64Decode(paymentResponseHeader));\n // Validate structure with Zod, then cast to TypeScript type\n SettleResponseSchema.parse(parsed);\n return parsed as SettleResponse;\n}\n\n// Export HTTP service classes (values)\nexport { t402HTTPResourceServer, RouteConfigurationError } from \"./t402HTTPResourceServer\";\nexport { HTTPFacilitatorClient } from \"./httpFacilitatorClient\";\nexport { t402HTTPClient } from \"./t402HTTPClient\";\n\n// Export HTTP types (type-only exports for isolatedModules compatibility)\nexport type {\n HTTPAdapter,\n HTTPRequestContext,\n HTTPResponseInstructions,\n HTTPProcessResult,\n PaywallConfig,\n PaywallProvider,\n PaymentOption,\n RouteConfig,\n RoutesConfig,\n CompiledRoute,\n DynamicPayTo,\n DynamicPrice,\n UnpaidResponseBody,\n UnpaidResponseResult,\n ProcessSettleResultResponse,\n ProcessSettleSuccessResponse,\n ProcessSettleFailureResponse,\n RouteValidationError,\n} from \"./t402HTTPResourceServer\";\nexport type { FacilitatorClient, FacilitatorConfig } from \"./httpFacilitatorClient\";\n","import {\n decodePaymentRequiredHeader,\n decodePaymentResponseHeader,\n encodePaymentSignatureHeader,\n} from \".\";\nimport { T402PaymentError } from \"../errors\";\nimport { SettleResponse } from \"../types\";\nimport { PaymentPayload, PaymentRequired } from \"../types/payments\";\nimport { t402Client } from \"../client/t402Client\";\n\n/**\n * HTTP-specific client for handling t402 payment protocol over HTTP.\n *\n * Wraps a t402Client to provide HTTP-specific encoding/decoding functionality\n * for payment headers and responses while maintaining the builder pattern.\n */\nexport class t402HTTPClient {\n /**\n * Creates a new t402HTTPClient instance.\n *\n * @param client - The underlying t402Client for payment logic\n */\n constructor(private readonly client: t402Client) {}\n\n /**\n * Encodes a payment payload into appropriate HTTP headers based on version.\n *\n * @param paymentPayload - The payment payload to encode\n * @returns HTTP headers containing the encoded payment signature\n */\n encodePaymentSignatureHeader(paymentPayload: PaymentPayload): Record<string, string> {\n switch (paymentPayload.t402Version) {\n case 2:\n return {\n \"PAYMENT-SIGNATURE\": encodePaymentSignatureHeader(paymentPayload),\n };\n case 1:\n return {\n \"X-PAYMENT\": encodePaymentSignatureHeader(paymentPayload),\n };\n default:\n throw new T402PaymentError(\n `Unsupported t402 version: ${(paymentPayload as PaymentPayload).t402Version}`,\n { phase: \"submission\" },\n );\n }\n }\n\n /**\n * Extracts payment required information from HTTP response.\n *\n * @param getHeader - Function to retrieve header value by name (case-insensitive)\n * @param body - Optional response body for v1 compatibility\n * @returns The payment required object\n */\n getPaymentRequiredResponse(\n getHeader: (name: string) => string | null | undefined,\n body?: unknown,\n ): PaymentRequired {\n // v2\n const paymentRequired = getHeader(\"PAYMENT-REQUIRED\");\n if (paymentRequired) {\n return decodePaymentRequiredHeader(paymentRequired);\n }\n\n // v1\n if (\n body &&\n body instanceof Object &&\n \"t402Version\" in body &&\n (body as PaymentRequired).t402Version === 1\n ) {\n return body as PaymentRequired;\n }\n\n throw new T402PaymentError(\"Invalid payment required response\", {\n phase: \"submission\",\n });\n }\n\n /**\n * Extracts payment settlement response from HTTP headers.\n *\n * @param getHeader - Function to retrieve header value by name (case-insensitive)\n * @returns The settlement response object\n */\n getPaymentSettleResponse(getHeader: (name: string) => string | null | undefined): SettleResponse {\n // v2\n const paymentResponse = getHeader(\"PAYMENT-RESPONSE\");\n if (paymentResponse) {\n return decodePaymentResponseHeader(paymentResponse);\n }\n\n // v1\n const xPaymentResponse = getHeader(\"X-PAYMENT-RESPONSE\");\n if (xPaymentResponse) {\n return decodePaymentResponseHeader(xPaymentResponse);\n }\n\n throw new T402PaymentError(\"Payment response header not found\", {\n phase: \"settlement\",\n });\n }\n\n /**\n * Creates a payment payload for the given payment requirements.\n * Delegates to the underlying t402Client.\n *\n * @param paymentRequired - The payment required response from the server\n * @returns Promise resolving to the payment payload\n */\n async createPaymentPayload(paymentRequired: PaymentRequired): Promise<PaymentPayload> {\n return this.client.createPaymentPayload(paymentRequired);\n }\n}\n","/**\n * Token Selector Utility for T402 Clients\n *\n * Helps clients select the best payment method from available payment requirements.\n * Prioritizes tokens based on:\n * 1. User token balances\n * 2. Token priority (USDT0 > USDC > legacy tokens)\n * 3. Network gas costs\n */\n\nimport type { PaymentRequirements } from \"../types\";\n\n/**\n * User token balance information\n */\nexport interface UserTokenBalance {\n /** Token contract address */\n asset: string;\n /** Network in CAIP-2 format (e.g., \"eip155:42161\") */\n network: string;\n /** Token balance in smallest units */\n amount: string;\n /** Token symbol (optional, for display) */\n symbol?: string;\n}\n\n/**\n * Token priority configuration\n * Lower number = higher priority\n */\nexport const DEFAULT_TOKEN_PRIORITY: Record<string, number> = {\n USDT0: 1, // Highest priority - gasless, cross-chain native\n USDC: 2, // Second - wide support, EIP-3009\n EURC: 3, // Euro stablecoin\n DAI: 4, // Decentralized stablecoin\n USDT: 10, // Lower priority - requires approval transaction (legacy)\n};\n\n/**\n * Options for token selection\n */\nexport interface TokenSelectionOptions {\n /** Custom token priorities (overrides defaults) */\n tokenPriority?: Record<string, number>;\n /** Preferred networks (will be prioritized) */\n preferredNetworks?: string[];\n /** Only consider tokens the user has sufficient balance for */\n requireSufficientBalance?: boolean;\n}\n\n/**\n * Result of token selection\n */\nexport interface TokenSelectionResult {\n /** The selected payment requirements */\n selected: PaymentRequirements | null;\n /** All valid payment options sorted by priority */\n alternatives: PaymentRequirements[];\n /** Reason if no payment method was selected */\n reason?: string;\n}\n\n/**\n * Select the best payment method from available requirements\n *\n * @param requirements - Array of payment requirements from the server\n * @param userBalances - Array of user's token balances\n * @param options - Selection options\n * @returns The best payment requirement and alternatives\n *\n * @example\n * ```typescript\n * const result = selectBestPaymentMethod(\n * paymentRequirements,\n * [\n * { asset: \"0x...\", network: \"eip155:42161\", amount: \"1000000000\" },\n * ],\n * { requireSufficientBalance: true }\n * );\n *\n * if (result.selected) {\n * // Use result.selected for payment\n * }\n * ```\n */\nexport function selectBestPaymentMethod(\n requirements: PaymentRequirements[],\n userBalances: UserTokenBalance[],\n options: TokenSelectionOptions = {},\n): TokenSelectionResult {\n const { tokenPriority = DEFAULT_TOKEN_PRIORITY, preferredNetworks = [], requireSufficientBalance = true } = options;\n\n if (requirements.length === 0) {\n return {\n selected: null,\n alternatives: [],\n reason: \"No payment requirements provided\",\n };\n }\n\n // Create a map for quick balance lookup\n const balanceMap = new Map<string, bigint>();\n for (const balance of userBalances) {\n const key = `${balance.network}:${balance.asset.toLowerCase()}`;\n balanceMap.set(key, BigInt(balance.amount));\n }\n\n // Filter and score requirements\n const scored = requirements\n .map((req) => {\n const key = `${req.network}:${req.asset.toLowerCase()}`;\n const userBalance = balanceMap.get(key) ?? 0n;\n const requiredAmount = BigInt(req.amount);\n const hasSufficientBalance = userBalance >= requiredAmount;\n\n // Get token symbol from extra or default\n const symbol = (req.extra?.symbol as string) || (req.extra?.name as string) || \"UNKNOWN\";\n\n // Calculate priority score\n let priorityScore = tokenPriority[symbol.toUpperCase()] ?? 100;\n\n // Boost preferred networks\n if (preferredNetworks.includes(req.network)) {\n priorityScore -= 0.5;\n }\n\n // Penalize if insufficient balance\n if (!hasSufficientBalance) {\n priorityScore += 1000;\n }\n\n return {\n requirement: req,\n priorityScore,\n hasSufficientBalance,\n userBalance,\n symbol,\n };\n })\n .sort((a, b) => a.priorityScore - b.priorityScore);\n\n // Filter based on balance requirement\n const validOptions = requireSufficientBalance ? scored.filter((s) => s.hasSufficientBalance) : scored;\n\n if (validOptions.length === 0) {\n return {\n selected: null,\n alternatives: scored.map((s) => s.requirement),\n reason: requireSufficientBalance\n ? \"No payment method with sufficient balance\"\n : \"No valid payment methods available\",\n };\n }\n\n return {\n selected: validOptions[0].requirement,\n alternatives: validOptions.slice(1).map((s) => s.requirement),\n };\n}\n\n/**\n * Check if a payment requirement uses a gasless token (EIP-3009)\n *\n * @param requirement - The payment requirement to check\n * @returns True if the payment is gasless\n */\nexport function isGaslessPayment(requirement: PaymentRequirements): boolean {\n const tokenType = requirement.extra?.tokenType;\n return tokenType === \"eip3009\";\n}\n\n/**\n * Check if a payment requirement is for USDT0\n *\n * @param requirement - The payment requirement to check\n * @returns True if the payment is for USDT0\n */\nexport function isUsdt0Payment(requirement: PaymentRequirements): boolean {\n const symbol = requirement.extra?.symbol;\n return symbol === \"USDT0\";\n}\n\n/**\n * Get payment requirements for a specific token\n *\n * @param requirements - The payment requirements to filter\n * @param symbol - The token symbol to filter by\n * @returns Filtered payment requirements matching the token\n */\nexport function filterByToken(requirements: PaymentRequirements[], symbol: string): PaymentRequirements[] {\n return requirements.filter((req) => {\n const reqSymbol = (req.extra?.symbol as string) || \"\";\n return reqSymbol.toUpperCase() === symbol.toUpperCase();\n });\n}\n\n/**\n * Get payment requirements for a specific network\n *\n * @param requirements - The payment requirements to filter\n * @param network - The network to filter by\n * @returns Filtered payment requirements matching the network\n */\nexport function filterByNetwork(requirements: PaymentRequirements[], network: string): PaymentRequirements[] {\n return requirements.filter((req) => req.network === network);\n}\n\n/**\n * Get all unique networks from payment requirements\n *\n * @param requirements - The payment requirements to extract networks from\n * @returns Array of unique network identifiers\n */\nexport function getAvailableNetworks(requirements: PaymentRequirements[]): string[] {\n return [...new Set(requirements.map((req) => req.network))];\n}\n\n/**\n * Get all unique tokens from payment requirements\n *\n * @param requirements - The payment requirements to extract tokens from\n * @returns Array of unique token symbols\n */\nexport function getAvailableTokens(requirements: PaymentRequirements[]): string[] {\n return [\n ...new Set(\n requirements.map((req) => (req.extra?.symbol as string) || (req.extra?.name as string) || \"UNKNOWN\"),\n ),\n ];\n}\n"],"mappings":"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","names":["t402Version"]}
1
+ {"version":3,"sources":["../../../src/client/index.ts","../../../src/errors.ts","../../../src/index.ts","../../../src/utils/index.ts","../../../src/client/t402Client.ts","../../../src/types/schemas.ts","../../../src/http/index.ts","../../../src/http/t402HTTPClient.ts","../../../src/client/tokenSelector.ts"],"sourcesContent":["export * from \"./t402Client\";\nexport * from \"../http/t402HTTPClient\";\nexport * from \"./tokenSelector\";","/**\n * T402PaymentError - Structured error class for the T402 payment protocol.\n *\n * Wraps upstream errors with payment-specific context: phase, retryability,\n * and optional HTTP status code.\n */\n\nexport type PaymentPhase = \"signing\" | \"submission\" | \"verification\" | \"settlement\" | \"unknown\";\n\nexport class T402PaymentError extends Error {\n readonly cause?: Error;\n readonly phase: PaymentPhase;\n readonly retryable: boolean;\n readonly code?: number;\n\n constructor(\n message: string,\n options?: {\n cause?: Error;\n phase?: PaymentPhase;\n retryable?: boolean;\n code?: number;\n },\n ) {\n super(message);\n this.name = \"T402PaymentError\";\n this.cause = options?.cause;\n this.phase = options?.phase ?? \"unknown\";\n this.retryable = options?.retryable ?? false;\n this.code = options?.code;\n\n if (Error.captureStackTrace) {\n Error.captureStackTrace(this, T402PaymentError);\n }\n }\n\n isRetryable(): boolean {\n return this.retryable;\n }\n\n toJSON(): Record<string, unknown> {\n return {\n name: this.name,\n message: this.message,\n phase: this.phase,\n retryable: this.retryable,\n code: this.code,\n cause: this.cause?.message,\n };\n }\n}\n","export const t402Version = 2;\n\n// Payment error\nexport { T402PaymentError } from \"./errors\";\nexport type { PaymentPhase } from \"./errors\";\n","import { Network } from \"../types\";\n\n// ============================================================================\n// Cryptographically Secure Random Utilities\n// ============================================================================\n\n/**\n * Get the crypto object, works in both browser and Node.js (19+)\n *\n * @returns The crypto object\n * @throws Error if crypto API is not available\n */\nfunction getCrypto(): Crypto {\n const cryptoObj = globalThis.crypto;\n\n if (!cryptoObj || typeof cryptoObj.getRandomValues !== \"function\") {\n throw new Error(\n \"Crypto API not available. \" + \"Node.js 19+ or a browser with Web Crypto API is required.\",\n );\n }\n\n return cryptoObj;\n}\n\n/**\n * Generate a cryptographically secure random integer in range [0, max)\n *\n * Uses rejection sampling to ensure uniform distribution.\n *\n * @param max - Exclusive upper bound (must be > 0 and <= 2^32)\n * @returns Random integer in [0, max)\n * @throws Error if max is invalid or crypto unavailable\n */\nexport function cryptoRandomInt(max: number): number {\n if (max <= 0 || max > 0xffffffff || !Number.isInteger(max)) {\n throw new Error(`Invalid max value: ${max}. Must be positive integer <= 2^32`);\n }\n\n const crypto = getCrypto();\n const array = new Uint32Array(1);\n\n // Rejection sampling to avoid modulo bias\n const limit = Math.floor(0xffffffff / max) * max;\n let value: number;\n\n do {\n crypto.getRandomValues(array);\n value = array[0];\n } while (value >= limit);\n\n return value % max;\n}\n\n/**\n * Generate a cryptographically secure random BigInt\n *\n * @param bits - Number of bits (default 64, max 256)\n * @returns Random BigInt with specified number of bits\n * @throws Error if bits is invalid or crypto unavailable\n */\nexport function cryptoRandomBigInt(bits: number = 64): bigint {\n if (bits <= 0 || bits > 256) {\n throw new Error(`Invalid bits value: ${bits}. Must be 1-256`);\n }\n\n const crypto = getCrypto();\n const bytes = Math.ceil(bits / 8);\n const array = new Uint8Array(bytes);\n crypto.getRandomValues(array);\n\n // Convert bytes to BigInt\n let result = 0n;\n for (let i = 0; i < bytes; i++) {\n result = (result << 8n) | BigInt(array[i]);\n }\n\n // Mask to exact bit count\n const mask = (1n << BigInt(bits)) - 1n;\n return result & mask;\n}\n\n/**\n * Generate a cryptographically secure random hex string\n *\n * @param bytes - Number of random bytes (default 16)\n * @returns Hex-encoded random string\n * @throws Error if bytes is invalid or crypto unavailable\n */\nexport function cryptoRandomHex(bytes: number = 16): string {\n if (bytes <= 0 || bytes > 128) {\n throw new Error(`Invalid bytes value: ${bytes}. Must be 1-128`);\n }\n\n const crypto = getCrypto();\n const array = new Uint8Array(bytes);\n crypto.getRandomValues(array);\n\n return Array.from(array)\n .map(b => b.toString(16).padStart(2, \"0\"))\n .join(\"\");\n}\n\n// ============================================================================\n// Network and Scheme Utilities\n// ============================================================================\n\n/**\n * Scheme data structure for facilitator storage\n */\nexport interface SchemeData<T> {\n facilitator: T;\n networks: Set<Network>;\n pattern: Network;\n}\n\nexport const findSchemesByNetwork = <T>(\n map: Map<string, Map<string, T>>,\n network: Network,\n): Map<string, T> | undefined => {\n // Direct match first\n let implementationsByScheme = map.get(network);\n\n if (!implementationsByScheme) {\n // Try pattern matching for registered network patterns\n for (const [registeredNetworkPattern, implementations] of map.entries()) {\n // Convert the registered network pattern to a regex\n // e.g., \"eip155:*\" becomes /^eip155:.*$/\n const pattern = registeredNetworkPattern\n .replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\") // Escape special regex chars except *\n .replace(/\\\\\\*/g, \".*\"); // Replace escaped * with .*\n\n const regex = new RegExp(`^${pattern}$`);\n\n if (regex.test(network)) {\n implementationsByScheme = implementations;\n break;\n }\n }\n }\n\n return implementationsByScheme;\n};\n\nexport const findByNetworkAndScheme = <T>(\n map: Map<string, Map<string, T>>,\n scheme: string,\n network: Network,\n): T | undefined => {\n return findSchemesByNetwork(map, network)?.get(scheme);\n};\n\n/**\n * Finds a facilitator by scheme and network using pattern matching.\n * Works with new SchemeData storage structure.\n *\n * @param schemeMap - Map of scheme names to SchemeData\n * @param scheme - The scheme to find\n * @param network - The network to match against\n * @returns The facilitator if found, undefined otherwise\n */\nexport const findFacilitatorBySchemeAndNetwork = <T>(\n schemeMap: Map<string, SchemeData<T>>,\n scheme: string,\n network: Network,\n): T | undefined => {\n const schemeData = schemeMap.get(scheme);\n if (!schemeData) return undefined;\n\n // Check if network is in the stored networks set\n if (schemeData.networks.has(network)) {\n return schemeData.facilitator;\n }\n\n // Try pattern matching\n const patternRegex = new RegExp(\"^\" + schemeData.pattern.replace(\"*\", \".*\") + \"$\");\n if (patternRegex.test(network)) {\n return schemeData.facilitator;\n }\n\n return undefined;\n};\n\nexport const Base64EncodedRegex = /^[A-Za-z0-9+/]*={0,2}$/;\n\n/**\n * Encodes a string to base64 format\n *\n * @param data - The string to be encoded to base64\n * @returns The base64 encoded string\n */\nexport function safeBase64Encode(data: string): string {\n if (typeof globalThis !== \"undefined\" && typeof globalThis.btoa === \"function\") {\n return globalThis.btoa(data);\n }\n return Buffer.from(data).toString(\"base64\");\n}\n\n/**\n * Decodes a base64 string back to its original format\n *\n * @param data - The base64 encoded string to be decoded\n * @returns The decoded string in UTF-8 format\n */\nexport function safeBase64Decode(data: string): string {\n if (typeof globalThis !== \"undefined\" && typeof globalThis.atob === \"function\") {\n return globalThis.atob(data);\n }\n return Buffer.from(data, \"base64\").toString(\"utf-8\");\n}\n\n/**\n * Deep equality comparison for payment requirements\n * Uses a normalized JSON.stringify for consistent comparison\n *\n * @param obj1 - First object to compare\n * @param obj2 - Second object to compare\n * @returns True if objects are deeply equal\n */\nexport function deepEqual(obj1: unknown, obj2: unknown): boolean {\n // Normalize and stringify both objects for comparison\n // This handles nested objects, arrays, and different property orders\n const normalize = (obj: unknown): string => {\n // Handle primitives and null/undefined\n if (obj === null || obj === undefined) return JSON.stringify(obj);\n if (typeof obj !== \"object\") return JSON.stringify(obj);\n\n // Handle arrays\n if (Array.isArray(obj)) {\n return JSON.stringify(\n obj.map(item =>\n typeof item === \"object\" && item !== null ? JSON.parse(normalize(item)) : item,\n ),\n );\n }\n\n // Handle objects - sort keys and recursively normalize values\n const sorted: Record<string, unknown> = {};\n Object.keys(obj as Record<string, unknown>)\n .sort()\n .forEach(key => {\n const value = (obj as Record<string, unknown>)[key];\n sorted[key] =\n typeof value === \"object\" && value !== null ? JSON.parse(normalize(value)) : value;\n });\n return JSON.stringify(sorted);\n };\n\n try {\n return normalize(obj1) === normalize(obj2);\n } catch {\n // Fallback to simple comparison if normalization fails\n return JSON.stringify(obj1) === JSON.stringify(obj2);\n }\n}\n","import { t402Version } from \"..\";\nimport { SchemeNetworkClient } from \"../types/mechanisms\";\nimport { PaymentPayload, PaymentRequirements } from \"../types/payments\";\nimport { Network, PaymentRequired } from \"../types\";\nimport { findByNetworkAndScheme, findSchemesByNetwork } from \"../utils\";\n\n/**\n * Client Hook Context Interfaces\n */\n\nexport interface PaymentCreationContext {\n paymentRequired: PaymentRequired;\n selectedRequirements: PaymentRequirements;\n}\n\nexport interface PaymentCreatedContext extends PaymentCreationContext {\n paymentPayload: PaymentPayload;\n}\n\nexport interface PaymentCreationFailureContext extends PaymentCreationContext {\n error: Error;\n}\n\n/**\n * Client Hook Type Definitions\n */\n\nexport type BeforePaymentCreationHook = (\n context: PaymentCreationContext,\n) => Promise<void | { abort: true; reason: string }>;\n\nexport type AfterPaymentCreationHook = (context: PaymentCreatedContext) => Promise<void>;\n\nexport type OnPaymentCreationFailureHook = (\n context: PaymentCreationFailureContext,\n) => Promise<void | { recovered: true; payload: PaymentPayload }>;\n\nexport type SelectPaymentRequirements = (t402Version: number, paymentRequirements: PaymentRequirements[]) => PaymentRequirements;\n\n/**\n * A policy function that filters or transforms payment requirements.\n * Policies are applied in order before the selector chooses the final option.\n *\n * @param t402Version - The t402 protocol version\n * @param paymentRequirements - Array of payment requirements to filter/transform\n * @returns Filtered array of payment requirements\n */\nexport type PaymentPolicy = (t402Version: number, paymentRequirements: PaymentRequirements[]) => PaymentRequirements[];\n\n\n/**\n * Configuration for registering a payment scheme with a specific network\n */\nexport interface SchemeRegistration {\n /**\n * The network identifier (e.g., 'eip155:8453', 'solana:mainnet')\n */\n network: Network;\n\n /**\n * The scheme client implementation for this network\n */\n client: SchemeNetworkClient;\n\n /**\n * The t402 protocol version to use for this scheme\n *\n * @default 2\n */\n t402Version?: number;\n}\n\n/**\n * Configuration options for the fetch wrapper\n */\nexport interface t402ClientConfig {\n /**\n * Array of scheme registrations defining which payment methods are supported\n */\n schemes: SchemeRegistration[];\n\n /**\n * Policies to apply to the client\n */\n policies?: PaymentPolicy[];\n\n /**\n * Custom payment requirements selector function\n * If not provided, uses the default selector (first available option)\n */\n paymentRequirementsSelector?: SelectPaymentRequirements;\n}\n\n/**\n * Core client for managing t402 payment schemes and creating payment payloads.\n *\n * Handles registration of payment schemes, policy-based filtering of payment requirements,\n * and creation of payment payloads based on server requirements.\n */\nexport class t402Client {\n private readonly paymentRequirementsSelector: SelectPaymentRequirements;\n private readonly registeredClientSchemes: Map<number, Map<string, Map<string, SchemeNetworkClient>>> = new Map();\n private readonly policies: PaymentPolicy[] = [];\n\n private beforePaymentCreationHooks: BeforePaymentCreationHook[] = [];\n private afterPaymentCreationHooks: AfterPaymentCreationHook[] = [];\n private onPaymentCreationFailureHooks: OnPaymentCreationFailureHook[] = [];\n\n /**\n * Creates a new t402Client instance.\n *\n * @param paymentRequirementsSelector - Function to select payment requirements from available options\n */\n constructor(paymentRequirementsSelector?: SelectPaymentRequirements) {\n this.paymentRequirementsSelector = paymentRequirementsSelector || ((_t402Version, accepts) => accepts[0]);\n }\n\n /**\n * Creates a new t402Client instance from a configuration object.\n *\n * @param config - The client configuration including schemes, policies, and payment requirements selector\n * @returns A configured t402Client instance\n */\n static fromConfig(config: t402ClientConfig): t402Client {\n const client = new t402Client(config.paymentRequirementsSelector);\n config.schemes.forEach(scheme => {\n if (scheme.t402Version === 1) {\n client.registerV1(scheme.network, scheme.client);\n } else {\n client.register(scheme.network, scheme.client);\n }\n });\n config.policies?.forEach(policy => {\n client.registerPolicy(policy);\n });\n return client;\n }\n\n /**\n * Registers a scheme client for the current t402 version.\n *\n * @param network - The network to register the client for\n * @param client - The scheme network client to register\n * @returns The t402Client instance for chaining\n */\n register(network: Network, client: SchemeNetworkClient): t402Client {\n return this._registerScheme(t402Version, network, client);\n }\n\n /**\n * Registers a scheme client for t402 version 1.\n *\n * @param network - The v1 network identifier (e.g., 'base-sepolia', 'solana-devnet')\n * @param client - The scheme network client to register\n * @returns The t402Client instance for chaining\n */\n registerV1(network: string, client: SchemeNetworkClient): t402Client {\n return this._registerScheme(1, network as Network, client);\n }\n\n /**\n * Registers a policy to filter or transform payment requirements.\n *\n * Policies are applied in order after filtering by registered schemes\n * and before the selector chooses the final payment requirement.\n *\n * @param policy - Function to filter/transform payment requirements\n * @returns The t402Client instance for chaining\n *\n * @example\n * ```typescript\n * // Prefer cheaper options\n * client.registerPolicy((version, reqs) =>\n * reqs.filter(r => BigInt(r.value) < BigInt('1000000'))\n * );\n *\n * // Prefer specific networks\n * client.registerPolicy((version, reqs) =>\n * reqs.filter(r => r.network.startsWith('eip155:'))\n * );\n * ```\n */\n registerPolicy(policy: PaymentPolicy): t402Client {\n this.policies.push(policy);\n return this;\n }\n\n /**\n * Register a hook to execute before payment payload creation.\n * Can abort creation by returning { abort: true, reason: string }\n *\n * @param hook - The hook function to register\n * @returns The t402Client instance for chaining\n */\n onBeforePaymentCreation(hook: BeforePaymentCreationHook): t402Client {\n this.beforePaymentCreationHooks.push(hook);\n return this;\n }\n\n /**\n * Register a hook to execute after successful payment payload creation.\n *\n * @param hook - The hook function to register\n * @returns The t402Client instance for chaining\n */\n onAfterPaymentCreation(hook: AfterPaymentCreationHook): t402Client {\n this.afterPaymentCreationHooks.push(hook);\n return this;\n }\n\n /**\n * Register a hook to execute when payment payload creation fails.\n * Can recover from failure by returning { recovered: true, payload: PaymentPayload }\n *\n * @param hook - The hook function to register\n * @returns The t402Client instance for chaining\n */\n onPaymentCreationFailure(hook: OnPaymentCreationFailureHook): t402Client {\n this.onPaymentCreationFailureHooks.push(hook);\n return this;\n }\n\n /**\n * Creates a payment payload based on a PaymentRequired response.\n *\n * Automatically extracts t402Version, resource, and extensions from the PaymentRequired\n * response and constructs a complete PaymentPayload with the accepted requirements.\n *\n * @param paymentRequired - The PaymentRequired response from the server\n * @returns Promise resolving to the complete payment payload\n */\n async createPaymentPayload(\n paymentRequired: PaymentRequired,\n ): Promise<PaymentPayload> {\n const clientSchemesByNetwork = this.registeredClientSchemes.get(paymentRequired.t402Version);\n if (!clientSchemesByNetwork) {\n throw new Error(`No client registered for t402 version: ${paymentRequired.t402Version}`);\n }\n\n const requirements = this.selectPaymentRequirements(paymentRequired.t402Version, paymentRequired.accepts);\n\n const context: PaymentCreationContext = {\n paymentRequired,\n selectedRequirements: requirements,\n };\n\n // Execute beforePaymentCreation hooks\n for (const hook of this.beforePaymentCreationHooks) {\n const result = await hook(context);\n if (result && \"abort\" in result && result.abort) {\n throw new Error(`Payment creation aborted: ${result.reason}`);\n }\n }\n\n try {\n const schemeNetworkClient = findByNetworkAndScheme(clientSchemesByNetwork, requirements.scheme, requirements.network);\n if (!schemeNetworkClient) {\n throw new Error(`No client registered for scheme: ${requirements.scheme} and network: ${requirements.network}`);\n }\n\n const partialPayload = await schemeNetworkClient.createPaymentPayload(paymentRequired.t402Version, requirements);\n\n let paymentPayload: PaymentPayload;\n if (partialPayload.t402Version == 1) {\n paymentPayload = partialPayload as PaymentPayload;\n } else {\n paymentPayload = {\n ...partialPayload,\n extensions: paymentRequired.extensions,\n resource: paymentRequired.resource,\n accepted: requirements,\n };\n }\n\n // Execute afterPaymentCreation hooks\n const createdContext: PaymentCreatedContext = {\n ...context,\n paymentPayload,\n };\n\n for (const hook of this.afterPaymentCreationHooks) {\n await hook(createdContext);\n }\n\n return paymentPayload;\n } catch (error) {\n const failureContext: PaymentCreationFailureContext = {\n ...context,\n error: error as Error,\n };\n\n // Execute onPaymentCreationFailure hooks\n for (const hook of this.onPaymentCreationFailureHooks) {\n const result = await hook(failureContext);\n if (result && \"recovered\" in result && result.recovered) {\n return result.payload;\n }\n }\n\n throw error;\n }\n }\n\n\n\n /**\n * Selects appropriate payment requirements based on registered clients and policies.\n *\n * Selection process:\n * 1. Filter by registered schemes (network + scheme support)\n * 2. Apply all registered policies in order\n * 3. Use selector to choose final requirement\n *\n * @param t402Version - The t402 protocol version\n * @param paymentRequirements - Array of available payment requirements\n * @returns The selected payment requirements\n */\n private selectPaymentRequirements(t402Version: number, paymentRequirements: PaymentRequirements[]): PaymentRequirements {\n const clientSchemesByNetwork = this.registeredClientSchemes.get(t402Version);\n if (!clientSchemesByNetwork) {\n throw new Error(`No client registered for t402 version: ${t402Version}`);\n }\n\n // Step 1: Filter by registered schemes\n const supportedPaymentRequirements = paymentRequirements.filter(requirement => {\n let clientSchemes = findSchemesByNetwork(clientSchemesByNetwork, requirement.network);\n if (!clientSchemes) {\n return false;\n }\n\n return clientSchemes.has(requirement.scheme);\n })\n\n if (supportedPaymentRequirements.length === 0) {\n throw new Error(`No network/scheme registered for t402 version: ${t402Version} which comply with the payment requirements. ${JSON.stringify({\n t402Version,\n paymentRequirements,\n t402Versions: Array.from(this.registeredClientSchemes.keys()),\n networks: Array.from(clientSchemesByNetwork.keys()),\n schemes: Array.from(clientSchemesByNetwork.values()).map(schemes => Array.from(schemes.keys())).flat(),\n })}`);\n }\n\n // Step 2: Apply all policies in order\n let filteredRequirements = supportedPaymentRequirements;\n for (const policy of this.policies) {\n filteredRequirements = policy(t402Version, filteredRequirements);\n\n if (filteredRequirements.length === 0) {\n throw new Error(`All payment requirements were filtered out by policies for t402 version: ${t402Version}`);\n }\n }\n\n // Step 3: Use selector to choose final requirement\n return this.paymentRequirementsSelector(t402Version, filteredRequirements);\n }\n\n /**\n * Internal method to register a scheme client.\n *\n * @param t402Version - The t402 protocol version\n * @param network - The network to register the client for\n * @param client - The scheme network client to register\n * @returns The t402Client instance for chaining\n */\n private _registerScheme(t402Version: number, network: Network, client: SchemeNetworkClient): t402Client {\n if (!this.registeredClientSchemes.has(t402Version)) {\n this.registeredClientSchemes.set(t402Version, new Map());\n }\n const clientSchemesByNetwork = this.registeredClientSchemes.get(t402Version)!;\n if (!clientSchemesByNetwork.has(network)) {\n clientSchemesByNetwork.set(network, new Map());\n }\n\n const clientByScheme = clientSchemesByNetwork.get(network)!;\n if (!clientByScheme.has(client.scheme)) {\n clientByScheme.set(client.scheme, client);\n }\n\n return this;\n }\n}\n","import { z } from \"zod\";\n\n/**\n * Zod schemas for T402 protocol types.\n * Used for runtime validation of incoming data.\n */\n\n// Network format: \"namespace:reference\" (CAIP-2)\nexport const NetworkSchema = z.string().regex(/^[a-z0-9-]+:[a-zA-Z0-9-]+$/, {\n message: \"Network must be in CAIP-2 format (e.g., 'eip155:1', 'solana:mainnet')\",\n});\n\n// Resource info for V2 protocol\nexport const ResourceInfoSchema = z.object({\n url: z.string().url({ message: \"Resource URL must be a valid URL\" }),\n description: z.string().optional(),\n mimeType: z.string().optional(),\n});\n\n// Payment requirements (what the server needs)\nexport const PaymentRequirementsSchema = z.object({\n scheme: z.string().min(1, { message: \"Scheme is required\" }),\n network: NetworkSchema,\n asset: z.string().min(1, { message: \"Asset address is required\" }),\n amount: z.string().regex(/^\\d+$/, { message: \"Amount must be a non-negative integer string\" }),\n payTo: z.string().min(1, { message: \"PayTo address is required\" }),\n maxTimeoutSeconds: z\n .number()\n .int()\n .positive({ message: \"maxTimeoutSeconds must be a positive integer\" }),\n extra: z.record(z.unknown()),\n});\n\n// Payment required response (402 response)\nexport const PaymentRequiredSchema = z.object({\n t402Version: z.literal(2, {\n errorMap: () => ({ message: \"t402Version must be 2 for V2 protocol\" }),\n }),\n error: z.string().optional(),\n resource: ResourceInfoSchema,\n accepts: z\n .array(PaymentRequirementsSchema)\n .min(1, { message: \"At least one payment option is required\" }),\n extensions: z.record(z.unknown()).optional(),\n});\n\n// Payment payload (client's signed payment)\nexport const PaymentPayloadSchema = z.object({\n t402Version: z.literal(2, {\n errorMap: () => ({ message: \"t402Version must be 2 for V2 protocol\" }),\n }),\n resource: ResourceInfoSchema.optional(),\n accepted: PaymentRequirementsSchema,\n payload: z.record(z.unknown()),\n extensions: z.record(z.unknown()).optional(),\n});\n\n// Verify response from facilitator\nexport const VerifyResponseSchema = z.object({\n isValid: z.boolean(),\n invalidReason: z.string().optional(),\n payer: z.string().optional(),\n});\n\n// Settle response from facilitator\nexport const SettleResponseSchema = z.object({\n success: z.boolean(),\n transaction: z.string(),\n network: NetworkSchema,\n errorReason: z.string().optional(),\n payer: z.string().optional(),\n confirmations: z.string().optional(),\n});\n\n// V1 schemas for backward compatibility\nexport const PaymentRequirementsV1Schema = z.object({\n scheme: z.string().min(1),\n network: z.string().min(1),\n asset: z.string().min(1),\n amount: z.string().regex(/^\\d+$/),\n payTo: z.string().min(1),\n maxTimeoutSeconds: z.number().int().positive(),\n extra: z.record(z.unknown()).optional(),\n});\n\nexport const PaymentPayloadV1Schema = z.object({\n t402Version: z.literal(1).optional(),\n accepted: PaymentRequirementsV1Schema,\n payload: z.record(z.unknown()),\n});\n\n// Type inference helpers\nexport type ValidatedPaymentPayload = z.infer<typeof PaymentPayloadSchema>;\nexport type ValidatedPaymentRequired = z.infer<typeof PaymentRequiredSchema>;\nexport type ValidatedPaymentRequirements = z.infer<typeof PaymentRequirementsSchema>;\nexport type ValidatedVerifyResponse = z.infer<typeof VerifyResponseSchema>;\nexport type ValidatedSettleResponse = z.infer<typeof SettleResponseSchema>;\n\n/**\n * Parse and validate a PaymentPayload.\n *\n * @param data - The data to parse\n * @returns The validated payment payload\n * @throws ZodError if validation fails\n */\nexport function parsePaymentPayload(data: unknown): ValidatedPaymentPayload {\n return PaymentPayloadSchema.parse(data);\n}\n\n/**\n * Parse and validate a PaymentRequired response.\n *\n * @param data - The data to parse\n * @returns The validated payment required response\n * @throws ZodError if validation fails\n */\nexport function parsePaymentRequired(data: unknown): ValidatedPaymentRequired {\n return PaymentRequiredSchema.parse(data);\n}\n\n/**\n * Parse and validate PaymentRequirements.\n *\n * @param data - The data to parse\n * @returns The validated payment requirements\n * @throws ZodError if validation fails\n */\nexport function parsePaymentRequirements(data: unknown): ValidatedPaymentRequirements {\n return PaymentRequirementsSchema.parse(data);\n}\n\n/**\n * Safely parse a PaymentPayload, returning a result object.\n *\n * @param data - The data to parse\n * @returns The safe parse result\n */\nexport function safeParsePaymentPayload(\n data: unknown,\n): z.SafeParseReturnType<unknown, ValidatedPaymentPayload> {\n return PaymentPayloadSchema.safeParse(data);\n}\n\n/**\n * Safely parse a PaymentRequired response, returning a result object.\n *\n * @param data - The data to parse\n * @returns The safe parse result\n */\nexport function safeParsePaymentRequired(\n data: unknown,\n): z.SafeParseReturnType<unknown, ValidatedPaymentRequired> {\n return PaymentRequiredSchema.safeParse(data);\n}\n\n/**\n * Safely parse PaymentRequirements, returning a result object.\n *\n * @param data - The data to parse\n * @returns The safe parse result\n */\nexport function safeParsePaymentRequirements(\n data: unknown,\n): z.SafeParseReturnType<unknown, ValidatedPaymentRequirements> {\n return PaymentRequirementsSchema.safeParse(data);\n}\n","import { SettleResponse } from \"../types\";\nimport { PaymentPayload, PaymentRequired, PaymentRequirements } from \"../types/payments\";\nimport {\n PaymentPayloadSchema,\n PaymentRequiredSchema,\n SettleResponseSchema,\n} from \"../types/schemas\";\nimport { Base64EncodedRegex, safeBase64Decode, safeBase64Encode } from \"../utils\";\n\n// HTTP Methods that typically use query parameters\nexport type QueryParamMethods = \"GET\" | \"HEAD\" | \"DELETE\";\n\n// HTTP Methods that typically use request body\nexport type BodyMethods = \"POST\" | \"PUT\" | \"PATCH\";\n\n/**\n * Encodes a payment payload as a base64 header value.\n *\n * @param paymentPayload - The payment payload to encode\n * @returns Base64 encoded string representation of the payment payload\n */\nexport function encodePaymentSignatureHeader(paymentPayload: PaymentPayload): string {\n return safeBase64Encode(JSON.stringify(paymentPayload));\n}\n\n/**\n * Decodes a base64 payment signature header into a payment payload.\n * Validates the payload structure using Zod schema.\n *\n * @param paymentSignatureHeader - The base64 encoded payment signature header\n * @returns The decoded and validated payment payload\n * @throws Error if the header is invalid or fails schema validation\n */\nexport function decodePaymentSignatureHeader(paymentSignatureHeader: string): PaymentPayload {\n if (!Base64EncodedRegex.test(paymentSignatureHeader)) {\n throw new Error(\"Invalid payment signature header\");\n }\n const parsed = JSON.parse(safeBase64Decode(paymentSignatureHeader));\n // Validate structure with Zod, then cast to TypeScript type\n // (Zod validates the structure; TypeScript types add template literal constraints)\n PaymentPayloadSchema.parse(parsed);\n return parsed as PaymentPayload;\n}\n\n/**\n * Encodes a payment required object as a base64 header value.\n *\n * @param paymentRequired - The payment required object to encode\n * @returns Base64 encoded string representation of the payment required object\n */\nexport function encodePaymentRequiredHeader(paymentRequired: PaymentRequired): string {\n return safeBase64Encode(JSON.stringify(paymentRequired));\n}\n\n/**\n * Decodes a base64 payment required header into a payment required object.\n * Validates the structure using Zod schema.\n *\n * @param paymentRequiredHeader - The base64 encoded payment required header\n * @returns The decoded and validated payment required object\n * @throws Error if the header is invalid or fails schema validation\n */\nexport function decodePaymentRequiredHeader(paymentRequiredHeader: string): PaymentRequired {\n if (!Base64EncodedRegex.test(paymentRequiredHeader)) {\n throw new Error(\"Invalid payment required header\");\n }\n const parsed = JSON.parse(safeBase64Decode(paymentRequiredHeader));\n // Validate structure with Zod, then cast to TypeScript type\n PaymentRequiredSchema.parse(parsed);\n return parsed as PaymentRequired;\n}\n\n/**\n * Encodes a payment response as a base64 header value.\n *\n * @param paymentResponse - The payment response to encode\n * @returns Base64 encoded string representation of the payment response\n */\nexport function encodePaymentResponseHeader(\n paymentResponse: SettleResponse & { requirements: PaymentRequirements },\n): string {\n return safeBase64Encode(JSON.stringify(paymentResponse));\n}\n\n/**\n * Decodes a base64 payment response header into a settle response.\n * Validates the structure using Zod schema.\n *\n * @param paymentResponseHeader - The base64 encoded payment response header\n * @returns The decoded and validated settle response\n * @throws Error if the header is invalid or fails schema validation\n */\nexport function decodePaymentResponseHeader(paymentResponseHeader: string): SettleResponse {\n if (!Base64EncodedRegex.test(paymentResponseHeader)) {\n throw new Error(\"Invalid payment response header\");\n }\n const parsed = JSON.parse(safeBase64Decode(paymentResponseHeader));\n // Validate structure with Zod, then cast to TypeScript type\n SettleResponseSchema.parse(parsed);\n return parsed as SettleResponse;\n}\n\n// Export HTTP service classes (values)\nexport { t402HTTPResourceServer, RouteConfigurationError } from \"./t402HTTPResourceServer\";\nexport { HTTPFacilitatorClient } from \"./httpFacilitatorClient\";\nexport { t402HTTPClient } from \"./t402HTTPClient\";\nexport { StreamingClient } from \"./streamingClient\";\nexport { IntentClient } from \"./intentClient\";\n\n// Export HTTP types (type-only exports for isolatedModules compatibility)\nexport type {\n HTTPAdapter,\n HTTPRequestContext,\n HTTPResponseInstructions,\n HTTPProcessResult,\n PaywallConfig,\n PaywallProvider,\n PaymentOption,\n RouteConfig,\n RoutesConfig,\n CompiledRoute,\n DynamicPayTo,\n DynamicPrice,\n UnpaidResponseBody,\n UnpaidResponseResult,\n ProcessSettleResultResponse,\n ProcessSettleSuccessResponse,\n ProcessSettleFailureResponse,\n RouteValidationError,\n} from \"./t402HTTPResourceServer\";\nexport type { FacilitatorClient, FacilitatorConfig, SettleOptions } from \"./httpFacilitatorClient\";\n\n// Streaming types\nexport type {\n StreamStatus,\n StreamMetadata,\n Stream,\n StreamUpdate,\n StreamStats,\n OpenStreamRequest,\n UpdateStreamRequest,\n CloseStreamRequest,\n ListStreamsParams,\n OpenStreamResponse,\n UpdateStreamResponse,\n CloseStreamResponse,\n GetStreamResponse,\n ListStreamsResponse,\n PauseResumeResponse,\n StreamingClientConfig,\n} from \"./streamingClient\";\n\n// Intent types\nexport type {\n IntentStatus,\n IntentPriority,\n RouteStepType,\n RouteStep,\n Route,\n Intent,\n CreateIntentRequest,\n SelectRouteRequest,\n ExecuteIntentRequest,\n CancelIntentRequest,\n ListIntentsParams,\n CreateIntentResponse,\n SelectRouteResponse,\n ExecuteIntentResponse,\n GetIntentResponse,\n ListIntentsResponse,\n CancelIntentResponse,\n RefreshRoutesResponse,\n IntentStats,\n IntentClientConfig,\n} from \"./intentClient\";\n","import {\n decodePaymentRequiredHeader,\n decodePaymentResponseHeader,\n encodePaymentSignatureHeader,\n} from \".\";\nimport { T402PaymentError } from \"../errors\";\nimport { SettleResponse } from \"../types\";\nimport { PaymentPayload, PaymentRequired } from \"../types/payments\";\nimport { t402Client } from \"../client/t402Client\";\n\n/**\n * HTTP-specific client for handling t402 payment protocol over HTTP.\n *\n * Wraps a t402Client to provide HTTP-specific encoding/decoding functionality\n * for payment headers and responses while maintaining the builder pattern.\n */\nexport class t402HTTPClient {\n /**\n * Creates a new t402HTTPClient instance.\n *\n * @param client - The underlying t402Client for payment logic\n */\n constructor(private readonly client: t402Client) {}\n\n /**\n * Encodes a payment payload into appropriate HTTP headers based on version.\n *\n * @param paymentPayload - The payment payload to encode\n * @returns HTTP headers containing the encoded payment signature\n */\n encodePaymentSignatureHeader(paymentPayload: PaymentPayload): Record<string, string> {\n switch (paymentPayload.t402Version) {\n case 2:\n return {\n \"PAYMENT-SIGNATURE\": encodePaymentSignatureHeader(paymentPayload),\n };\n case 1:\n return {\n \"X-PAYMENT\": encodePaymentSignatureHeader(paymentPayload),\n };\n default:\n throw new T402PaymentError(\n `Unsupported t402 version: ${(paymentPayload as PaymentPayload).t402Version}`,\n { phase: \"submission\" },\n );\n }\n }\n\n /**\n * Extracts payment required information from HTTP response.\n *\n * @param getHeader - Function to retrieve header value by name (case-insensitive)\n * @param body - Optional response body for v1 compatibility\n * @returns The payment required object\n */\n getPaymentRequiredResponse(\n getHeader: (name: string) => string | null | undefined,\n body?: unknown,\n ): PaymentRequired {\n // v2\n const paymentRequired = getHeader(\"PAYMENT-REQUIRED\");\n if (paymentRequired) {\n return decodePaymentRequiredHeader(paymentRequired);\n }\n\n // v1\n if (\n body &&\n body instanceof Object &&\n \"t402Version\" in body &&\n (body as PaymentRequired).t402Version === 1\n ) {\n return body as PaymentRequired;\n }\n\n throw new T402PaymentError(\"Invalid payment required response\", {\n phase: \"submission\",\n });\n }\n\n /**\n * Extracts payment settlement response from HTTP headers.\n *\n * @param getHeader - Function to retrieve header value by name (case-insensitive)\n * @returns The settlement response object\n */\n getPaymentSettleResponse(getHeader: (name: string) => string | null | undefined): SettleResponse {\n // v2\n const paymentResponse = getHeader(\"PAYMENT-RESPONSE\");\n if (paymentResponse) {\n return decodePaymentResponseHeader(paymentResponse);\n }\n\n // v1\n const xPaymentResponse = getHeader(\"X-PAYMENT-RESPONSE\");\n if (xPaymentResponse) {\n return decodePaymentResponseHeader(xPaymentResponse);\n }\n\n throw new T402PaymentError(\"Payment response header not found\", {\n phase: \"settlement\",\n });\n }\n\n /**\n * Creates a payment payload for the given payment requirements.\n * Delegates to the underlying t402Client.\n *\n * @param paymentRequired - The payment required response from the server\n * @returns Promise resolving to the payment payload\n */\n async createPaymentPayload(paymentRequired: PaymentRequired): Promise<PaymentPayload> {\n return this.client.createPaymentPayload(paymentRequired);\n }\n}\n","/**\n * Token Selector Utility for T402 Clients\n *\n * Helps clients select the best payment method from available payment requirements.\n * Prioritizes tokens based on:\n * 1. User token balances\n * 2. Token priority (USDT0 > USDC > legacy tokens)\n * 3. Network gas costs\n */\n\nimport type { PaymentRequirements } from \"../types\";\n\n/**\n * User token balance information\n */\nexport interface UserTokenBalance {\n /** Token contract address */\n asset: string;\n /** Network in CAIP-2 format (e.g., \"eip155:42161\") */\n network: string;\n /** Token balance in smallest units */\n amount: string;\n /** Token symbol (optional, for display) */\n symbol?: string;\n}\n\n/**\n * Token priority configuration\n * Lower number = higher priority\n */\nexport const DEFAULT_TOKEN_PRIORITY: Record<string, number> = {\n USDT0: 1, // Highest priority - gasless, cross-chain native\n USDC: 2, // Second - wide support, EIP-3009\n EURC: 3, // Euro stablecoin\n DAI: 4, // Decentralized stablecoin\n USDT: 10, // Lower priority - requires approval transaction (legacy)\n};\n\n/**\n * Options for token selection\n */\nexport interface TokenSelectionOptions {\n /** Custom token priorities (overrides defaults) */\n tokenPriority?: Record<string, number>;\n /** Preferred networks (will be prioritized) */\n preferredNetworks?: string[];\n /** Only consider tokens the user has sufficient balance for */\n requireSufficientBalance?: boolean;\n}\n\n/**\n * Result of token selection\n */\nexport interface TokenSelectionResult {\n /** The selected payment requirements */\n selected: PaymentRequirements | null;\n /** All valid payment options sorted by priority */\n alternatives: PaymentRequirements[];\n /** Reason if no payment method was selected */\n reason?: string;\n}\n\n/**\n * Select the best payment method from available requirements\n *\n * @param requirements - Array of payment requirements from the server\n * @param userBalances - Array of user's token balances\n * @param options - Selection options\n * @returns The best payment requirement and alternatives\n *\n * @example\n * ```typescript\n * const result = selectBestPaymentMethod(\n * paymentRequirements,\n * [\n * { asset: \"0x...\", network: \"eip155:42161\", amount: \"1000000000\" },\n * ],\n * { requireSufficientBalance: true }\n * );\n *\n * if (result.selected) {\n * // Use result.selected for payment\n * }\n * ```\n */\nexport function selectBestPaymentMethod(\n requirements: PaymentRequirements[],\n userBalances: UserTokenBalance[],\n options: TokenSelectionOptions = {},\n): TokenSelectionResult {\n const { tokenPriority = DEFAULT_TOKEN_PRIORITY, preferredNetworks = [], requireSufficientBalance = true } = options;\n\n if (requirements.length === 0) {\n return {\n selected: null,\n alternatives: [],\n reason: \"No payment requirements provided\",\n };\n }\n\n // Create a map for quick balance lookup\n const balanceMap = new Map<string, bigint>();\n for (const balance of userBalances) {\n const key = `${balance.network}:${balance.asset.toLowerCase()}`;\n balanceMap.set(key, BigInt(balance.amount));\n }\n\n // Filter and score requirements\n const scored = requirements\n .map((req) => {\n const key = `${req.network}:${req.asset.toLowerCase()}`;\n const userBalance = balanceMap.get(key) ?? 0n;\n const requiredAmount = BigInt(req.amount);\n const hasSufficientBalance = userBalance >= requiredAmount;\n\n // Get token symbol from extra or default\n const symbol = (req.extra?.symbol as string) || (req.extra?.name as string) || \"UNKNOWN\";\n\n // Calculate priority score\n let priorityScore = tokenPriority[symbol.toUpperCase()] ?? 100;\n\n // Boost preferred networks\n if (preferredNetworks.includes(req.network)) {\n priorityScore -= 0.5;\n }\n\n // Penalize if insufficient balance\n if (!hasSufficientBalance) {\n priorityScore += 1000;\n }\n\n return {\n requirement: req,\n priorityScore,\n hasSufficientBalance,\n userBalance,\n symbol,\n };\n })\n .sort((a, b) => a.priorityScore - b.priorityScore);\n\n // Filter based on balance requirement\n const validOptions = requireSufficientBalance ? scored.filter((s) => s.hasSufficientBalance) : scored;\n\n if (validOptions.length === 0) {\n return {\n selected: null,\n alternatives: scored.map((s) => s.requirement),\n reason: requireSufficientBalance\n ? \"No payment method with sufficient balance\"\n : \"No valid payment methods available\",\n };\n }\n\n return {\n selected: validOptions[0].requirement,\n alternatives: validOptions.slice(1).map((s) => s.requirement),\n };\n}\n\n/**\n * Check if a payment requirement uses a gasless token (EIP-3009)\n *\n * @param requirement - The payment requirement to check\n * @returns True if the payment is gasless\n */\nexport function isGaslessPayment(requirement: PaymentRequirements): boolean {\n const tokenType = requirement.extra?.tokenType;\n return tokenType === \"eip3009\";\n}\n\n/**\n * Check if a payment requirement is for USDT0\n *\n * @param requirement - The payment requirement to check\n * @returns True if the payment is for USDT0\n */\nexport function isUsdt0Payment(requirement: PaymentRequirements): boolean {\n const symbol = requirement.extra?.symbol;\n return symbol === \"USDT0\";\n}\n\n/**\n * Get payment requirements for a specific token\n *\n * @param requirements - The payment requirements to filter\n * @param symbol - The token symbol to filter by\n * @returns Filtered payment requirements matching the token\n */\nexport function filterByToken(requirements: PaymentRequirements[], symbol: string): PaymentRequirements[] {\n return requirements.filter((req) => {\n const reqSymbol = (req.extra?.symbol as string) || \"\";\n return reqSymbol.toUpperCase() === symbol.toUpperCase();\n });\n}\n\n/**\n * Get payment requirements for a specific network\n *\n * @param requirements - The payment requirements to filter\n * @param network - The network to filter by\n * @returns Filtered payment requirements matching the network\n */\nexport function filterByNetwork(requirements: PaymentRequirements[], network: string): PaymentRequirements[] {\n return requirements.filter((req) => req.network === network);\n}\n\n/**\n * Get all unique networks from payment requirements\n *\n * @param requirements - The payment requirements to extract networks from\n * @returns Array of unique network identifiers\n */\nexport function getAvailableNetworks(requirements: PaymentRequirements[]): string[] {\n return [...new Set(requirements.map((req) => req.network))];\n}\n\n/**\n * Get all unique tokens from payment requirements\n *\n * @param requirements - The payment requirements to extract tokens from\n * @returns Array of unique token symbols\n */\nexport function getAvailableTokens(requirements: PaymentRequirements[]): string[] {\n return [\n ...new Set(\n requirements.map((req) => (req.extra?.symbol as string) || (req.extra?.name as string) || \"UNKNOWN\"),\n ),\n ];\n}\n"],"mappings":"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","names":["t402Version"]}
package/dist/cjs/http/index.d.ts CHANGED
@@ -1,8 +1,337 @@
1
1
  import { c as PaymentRequired, S as SettleResponse, a as PaymentPayload, P as PaymentRequirements } from '../mechanisms-dYCiYgko.js';
2
- 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-CGZh_p2c.js';
2
+ 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';
3
3
  export { f as t402HTTPClient } from '../t402HTTPClient-CHaMMGBY.js';
4
4
  import 'zod';
5
5
 
6
+ type StreamStatus = "pending" | "active" | "paused" | "closing" | "closed" | "cancelled" | "expired";
7
+ interface StreamMetadata {
8
+ resourceId?: string;
9
+ description?: string;
10
+ tags?: string[];
11
+ extra?: Record<string, string>;
12
+ }
13
+ interface Stream {
14
+ id: string;
15
+ network: string;
16
+ scheme: string;
17
+ payer: string;
18
+ payee: string;
19
+ asset: string;
20
+ maxAmount: string;
21
+ currentAmount: string;
22
+ settledAmount: string;
23
+ ratePerSecond: string;
24
+ status: StreamStatus;
25
+ createdAt: string;
26
+ activatedAt?: string;
27
+ lastUpdatedAt: string;
28
+ expiresAt?: string;
29
+ closedAt?: string;
30
+ depositTxHash: string;
31
+ settlementTxHash: string;
32
+ metadata: StreamMetadata;
33
+ }
34
+ interface StreamUpdate {
35
+ id: string;
36
+ streamId: string;
37
+ amount: string;
38
+ signature: string;
39
+ timestamp: string;
40
+ sequenceNum: number;
41
+ resourceUnits: number;
42
+ }
43
+ interface StreamStats {
44
+ totalUpdates: number;
45
+ averageRate: string;
46
+ duration: number;
47
+ resourcesUsed: number;
48
+ efficiencyScore: number;
49
+ }
50
+ interface OpenStreamRequest {
51
+ network: string;
52
+ scheme: string;
53
+ payer: string;
54
+ payee: string;
55
+ asset: string;
56
+ maxAmount: string;
57
+ ratePerSecond?: string;
58
+ expiresAt?: string;
59
+ signature: string;
60
+ metadata?: StreamMetadata;
61
+ }
62
+ interface UpdateStreamRequest {
63
+ streamId: string;
64
+ amount: string;
65
+ signature: string;
66
+ resourceUnits?: number;
67
+ }
68
+ interface CloseStreamRequest {
69
+ streamId: string;
70
+ finalAmount: string;
71
+ payerSignature: string;
72
+ payeeSignature?: string;
73
+ reason?: string;
74
+ }
75
+ interface ListStreamsParams {
76
+ network?: string;
77
+ payer?: string;
78
+ payee?: string;
79
+ status?: StreamStatus[];
80
+ limit?: number;
81
+ offset?: number;
82
+ orderBy?: string;
83
+ orderDesc?: boolean;
84
+ }
85
+ interface OpenStreamResponse {
86
+ stream: Stream;
87
+ depositAmount?: string;
88
+ depositTo?: string;
89
+ }
90
+ interface UpdateStreamResponse {
91
+ stream: Stream;
92
+ update: StreamUpdate;
93
+ remaining: string;
94
+ canContinue: boolean;
95
+ }
96
+ interface CloseStreamResponse {
97
+ stream: Stream;
98
+ settledAmount: string;
99
+ txHash: string;
100
+ refundAmount: string;
101
+ }
102
+ interface GetStreamResponse {
103
+ stream: Stream;
104
+ updates?: StreamUpdate[];
105
+ stats?: StreamStats;
106
+ }
107
+ interface ListStreamsResponse {
108
+ streams: Stream[];
109
+ total: number;
110
+ limit: number;
111
+ offset: number;
112
+ hasMore: boolean;
113
+ }
114
+ interface PauseResumeResponse {
115
+ status: string;
116
+ message: string;
117
+ }
118
+ interface StreamingClientConfig {
119
+ url?: string;
120
+ apiKey?: string;
121
+ requesterAddress?: string;
122
+ }
123
+ /**
124
+ * HTTP client for the t402 facilitator streaming API.
125
+ * Provides methods for managing payment streams.
126
+ */
127
+ declare class StreamingClient {
128
+ readonly url: string;
129
+ private readonly apiKey?;
130
+ private readonly requesterAddress?;
131
+ constructor(config?: StreamingClientConfig);
132
+ /**
133
+ * Open a new payment stream
134
+ */
135
+ openStream(params: OpenStreamRequest): Promise<OpenStreamResponse>;
136
+ /**
137
+ * Update a stream with a new cumulative amount
138
+ */
139
+ updateStream(params: UpdateStreamRequest): Promise<UpdateStreamResponse>;
140
+ /**
141
+ * Close a stream and settle the final amount
142
+ */
143
+ closeStream(params: CloseStreamRequest): Promise<CloseStreamResponse>;
144
+ /**
145
+ * Get stream details by ID
146
+ */
147
+ getStream(id: string, options?: {
148
+ includeUpdates?: boolean;
149
+ includeStats?: boolean;
150
+ }): Promise<GetStreamResponse>;
151
+ /**
152
+ * Pause an active stream
153
+ */
154
+ pauseStream(id: string): Promise<PauseResumeResponse>;
155
+ /**
156
+ * Resume a paused stream
157
+ */
158
+ resumeStream(id: string): Promise<PauseResumeResponse>;
159
+ /**
160
+ * List streams with optional filters
161
+ */
162
+ listStreams(filters?: ListStreamsParams): Promise<ListStreamsResponse>;
163
+ private buildHeaders;
164
+ private post;
165
+ private get;
166
+ }
167
+
168
+ type IntentStatus = "pending" | "routed" | "executing" | "completed" | "failed" | "cancelled" | "expired";
169
+ type IntentPriority = "low" | "normal" | "high" | "urgent";
170
+ type RouteStepType = "transfer" | "swap" | "bridge" | "approve" | "wrap" | "unwrap";
171
+ interface RouteStep {
172
+ order: number;
173
+ type: RouteStepType;
174
+ network: string;
175
+ protocol?: string;
176
+ fromAsset: string;
177
+ toAsset: string;
178
+ fromAmount: string;
179
+ toAmount: string;
180
+ gasEstimate?: string;
181
+ data?: string;
182
+ }
183
+ interface Route {
184
+ id: string;
185
+ sourceNetwork: string;
186
+ targetNetwork: string;
187
+ sourceAsset: string;
188
+ targetAsset: string;
189
+ inputAmount: string;
190
+ outputAmount: string;
191
+ estimatedGas: string;
192
+ estimatedTime: number;
193
+ slippage: number;
194
+ score: number;
195
+ steps: RouteStep[];
196
+ requiresBridge: boolean;
197
+ bridgeProtocol?: string;
198
+ validUntil: string;
199
+ }
200
+ interface Intent {
201
+ id: string;
202
+ payer: string;
203
+ payee: string;
204
+ amount: string;
205
+ asset: string;
206
+ sourceNetworks?: string[];
207
+ targetNetwork?: string;
208
+ maxSlippage: number;
209
+ maxGasCost?: string;
210
+ priority: IntentPriority;
211
+ status: IntentStatus;
212
+ selectedRoute?: Route;
213
+ availableRoutes?: Route[];
214
+ createdAt: string;
215
+ expiresAt: string;
216
+ executedAt?: string;
217
+ txHashes?: string[];
218
+ errorMessage?: string;
219
+ metadata?: Record<string, string>;
220
+ }
221
+ interface CreateIntentRequest {
222
+ payer: string;
223
+ payee: string;
224
+ amount: string;
225
+ asset: string;
226
+ sourceNetworks?: string[];
227
+ targetNetwork?: string;
228
+ maxSlippage?: number;
229
+ maxGasCost?: string;
230
+ priority?: IntentPriority;
231
+ expiresIn?: number;
232
+ metadata?: Record<string, string>;
233
+ }
234
+ interface SelectRouteRequest {
235
+ routeId: string;
236
+ }
237
+ interface ExecuteIntentRequest {
238
+ signature: string;
239
+ routeId?: string;
240
+ }
241
+ interface CancelIntentRequest {
242
+ reason?: string;
243
+ }
244
+ interface ListIntentsParams {
245
+ payer?: string;
246
+ payee?: string;
247
+ status?: IntentStatus[];
248
+ limit?: number;
249
+ offset?: number;
250
+ }
251
+ interface CreateIntentResponse {
252
+ intent: Intent;
253
+ availableRoutes: Route[];
254
+ recommendedRoute?: Route;
255
+ }
256
+ interface SelectRouteResponse {
257
+ intent: Intent;
258
+ selectedRoute: Route;
259
+ }
260
+ interface ExecuteIntentResponse {
261
+ intent: Intent;
262
+ txHashes: string[];
263
+ status: string;
264
+ message?: string;
265
+ }
266
+ interface GetIntentResponse {
267
+ intent: Intent;
268
+ }
269
+ interface ListIntentsResponse {
270
+ intents: Intent[];
271
+ total: number;
272
+ limit: number;
273
+ offset: number;
274
+ hasMore: boolean;
275
+ }
276
+ interface CancelIntentResponse {
277
+ status: string;
278
+ message: string;
279
+ }
280
+ interface RefreshRoutesResponse {
281
+ intent: Intent;
282
+ availableRoutes: Route[];
283
+ recommendedRoute?: Route;
284
+ }
285
+ type IntentStats = Record<string, number>;
286
+ interface IntentClientConfig {
287
+ url?: string;
288
+ apiKey?: string;
289
+ }
290
+ /**
291
+ * HTTP client for the t402 facilitator intent API.
292
+ * Provides methods for creating and managing cross-chain payment intents.
293
+ */
294
+ declare class IntentClient {
295
+ readonly url: string;
296
+ private readonly apiKey?;
297
+ constructor(config?: IntentClientConfig);
298
+ /**
299
+ * Create a new payment intent and get available routes
300
+ */
301
+ createIntent(params: CreateIntentRequest): Promise<CreateIntentResponse>;
302
+ /**
303
+ * Get intent details by ID
304
+ */
305
+ getIntent(id: string): Promise<GetIntentResponse>;
306
+ /**
307
+ * Select a route for an intent
308
+ */
309
+ selectRoute(id: string, params: SelectRouteRequest): Promise<SelectRouteResponse>;
310
+ /**
311
+ * Execute an intent with a signed authorization
312
+ */
313
+ executeIntent(id: string, params: ExecuteIntentRequest): Promise<ExecuteIntentResponse>;
314
+ /**
315
+ * Cancel a pending intent
316
+ */
317
+ cancelIntent(id: string, params?: CancelIntentRequest): Promise<CancelIntentResponse>;
318
+ /**
319
+ * Refresh available routes for an intent
320
+ */
321
+ refreshRoutes(id: string): Promise<RefreshRoutesResponse>;
322
+ /**
323
+ * List intents with optional filters
324
+ */
325
+ listIntents(filters?: ListIntentsParams): Promise<ListIntentsResponse>;
326
+ /**
327
+ * Get intent statistics (counts by status)
328
+ */
329
+ getIntentStats(): Promise<IntentStats>;
330
+ private buildHeaders;
331
+ private post;
332
+ private get;
333
+ }
334
+
6
335
  type QueryParamMethods = "GET" | "HEAD" | "DELETE";
7
336
  type BodyMethods = "POST" | "PUT" | "PATCH";
8
337
  /**
@@ -56,4 +385,4 @@ declare function encodePaymentResponseHeader(paymentResponse: SettleResponse & {
56
385
  */
57
386
  declare function decodePaymentResponseHeader(paymentResponseHeader: string): SettleResponse;
58
387
 
59
- export { type BodyMethods, type QueryParamMethods, decodePaymentRequiredHeader, decodePaymentResponseHeader, decodePaymentSignatureHeader, encodePaymentRequiredHeader, encodePaymentResponseHeader, encodePaymentSignatureHeader };
388
+ 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 };