@t402/core 2.3.0 → 2.4.0

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

@@ -1,5 +1,6 @@
-export { A as AfterPaymentCreationHook, B as BeforePaymentCreationHook, O as OnPaymentCreationFailureHook, a as PaymentCreatedContext, P as PaymentCreationContext, b as PaymentCreationFailureContext, c as PaymentPolicy, d as SchemeRegistration, S as SelectPaymentRequirements, e as t402Client, t as t402ClientConfig, f as t402HTTPClient } from '../t402HTTPClient-GIweW6nh.js';
-import { P as PaymentRequirements } from '../mechanisms-B-vz5yOj.js';
+export { A as AfterPaymentCreationHook, B as BeforePaymentCreationHook, O as OnPaymentCreationFailureHook, a as PaymentCreatedContext, P as PaymentCreationContext, b as PaymentCreationFailureContext, c as PaymentPolicy, d as SchemeRegistration, S as SelectPaymentRequirements, e as t402Client, t as t402ClientConfig, f as t402HTTPClient } from '../t402HTTPClient-DmkFydNG.js';
+import { P as PaymentRequirements } from '../mechanisms-C7yK91d4.js';
+import 'zod';
 
 /**
  * Token Selector Utility for T402 Clients

package/dist/cjs/client/index.js

@@ -314,6 +314,70 @@ var t402Client = class _t402Client {
   }
 };
 
+// src/types/schemas.ts
+var import_zod = require("zod");
+var NetworkSchema = import_zod.z.string().regex(/^[a-z0-9-]+:[a-zA-Z0-9-]+$/, {
+  message: "Network must be in CAIP-2 format (e.g., 'eip155:1', 'solana:mainnet')"
+});
+var ResourceInfoSchema = import_zod.z.object({
+  url: import_zod.z.string().url({ message: "Resource URL must be a valid URL" }),
+  description: import_zod.z.string().optional(),
+  mimeType: import_zod.z.string().optional()
+});
+var PaymentRequirementsSchema = import_zod.z.object({
+  scheme: import_zod.z.string().min(1, { message: "Scheme is required" }),
+  network: NetworkSchema,
+  asset: import_zod.z.string().min(1, { message: "Asset address is required" }),
+  amount: import_zod.z.string().regex(/^\d+$/, { message: "Amount must be a non-negative integer string" }),
+  payTo: import_zod.z.string().min(1, { message: "PayTo address is required" }),
+  maxTimeoutSeconds: import_zod.z.number().int().positive({ message: "maxTimeoutSeconds must be a positive integer" }),
+  extra: import_zod.z.record(import_zod.z.unknown())
+});
+var PaymentRequiredSchema = import_zod.z.object({
+  t402Version: import_zod.z.literal(2, {
+    errorMap: () => ({ message: "t402Version must be 2 for V2 protocol" })
+  }),
+  error: import_zod.z.string().optional(),
+  resource: ResourceInfoSchema,
+  accepts: import_zod.z.array(PaymentRequirementsSchema).min(1, { message: "At least one payment option is required" }),
+  extensions: import_zod.z.record(import_zod.z.unknown()).optional()
+});
+var PaymentPayloadSchema = import_zod.z.object({
+  t402Version: import_zod.z.literal(2, {
+    errorMap: () => ({ message: "t402Version must be 2 for V2 protocol" })
+  }),
+  resource: ResourceInfoSchema.optional(),
+  accepted: PaymentRequirementsSchema,
+  payload: import_zod.z.record(import_zod.z.unknown()),
+  extensions: import_zod.z.record(import_zod.z.unknown()).optional()
+});
+var VerifyResponseSchema = import_zod.z.object({
+  isValid: import_zod.z.boolean(),
+  invalidReason: import_zod.z.string().optional(),
+  payer: import_zod.z.string().optional()
+});
+var SettleResponseSchema = import_zod.z.object({
+  success: import_zod.z.boolean(),
+  transaction: import_zod.z.string(),
+  network: NetworkSchema,
+  errorReason: import_zod.z.string().optional(),
+  payer: import_zod.z.string().optional()
+});
+var PaymentRequirementsV1Schema = import_zod.z.object({
+  scheme: import_zod.z.string().min(1),
+  network: import_zod.z.string().min(1),
+  asset: import_zod.z.string().min(1),
+  amount: import_zod.z.string().regex(/^\d+$/),
+  payTo: import_zod.z.string().min(1),
+  maxTimeoutSeconds: import_zod.z.number().int().positive(),
+  extra: import_zod.z.record(import_zod.z.unknown()).optional()
+});
+var PaymentPayloadV1Schema = import_zod.z.object({
+  t402Version: import_zod.z.literal(1).optional(),
+  accepted: PaymentRequirementsV1Schema,
+  payload: import_zod.z.record(import_zod.z.unknown())
+});
+
 // src/http/index.ts
 function encodePaymentSignatureHeader(paymentPayload) {
   return safeBase64Encode(JSON.stringify(paymentPayload));
@@ -322,13 +386,17 @@ function decodePaymentRequiredHeader(paymentRequiredHeader) {
   if (!Base64EncodedRegex.test(paymentRequiredHeader)) {
     throw new Error("Invalid payment required header");
   }
-  return JSON.parse(safeBase64Decode(paymentRequiredHeader));
+  const parsed = JSON.parse(safeBase64Decode(paymentRequiredHeader));
+  PaymentRequiredSchema.parse(parsed);
+  return parsed;
 }
 function decodePaymentResponseHeader(paymentResponseHeader) {
   if (!Base64EncodedRegex.test(paymentResponseHeader)) {
     throw new Error("Invalid payment response header");
   }
-  return JSON.parse(safeBase64Decode(paymentResponseHeader));
+  const parsed = JSON.parse(safeBase64Decode(paymentResponseHeader));
+  SettleResponseSchema.parse(parsed);
+  return parsed;
 }
 
 // src/http/t402HTTPClient.ts

package/dist/cjs/client/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/client/index.ts","../../../src/index.ts","../../../src/utils/index.ts","../../../src/client/t402Client.ts","../../../src/http/index.ts","../../../src/http/t402HTTPClient.ts","../../../src/client/tokenSelector.ts"],"sourcesContent":["export * from \"./t402Client\";\nexport * from \"../http/t402HTTPClient\";\nexport * from \"./tokenSelector\";","export const t402Version = 2;\n","import { Network } from \"../types\";\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 { SettleResponse } from \"../types\";\nimport { PaymentPayload, PaymentRequired, PaymentRequirements } from \"../types/payments\";\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 *\n * @param paymentSignatureHeader - The base64 encoded payment signature header\n * @returns The decoded payment payload\n */\nexport function decodePaymentSignatureHeader(paymentSignatureHeader: string): PaymentPayload {\n  if (!Base64EncodedRegex.test(paymentSignatureHeader)) {\n    throw new Error(\"Invalid payment signature header\");\n  }\n  return JSON.parse(safeBase64Decode(paymentSignatureHeader)) 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 *\n * @param paymentRequiredHeader - The base64 encoded payment required header\n * @returns The decoded payment required object\n */\nexport function decodePaymentRequiredHeader(paymentRequiredHeader: string): PaymentRequired {\n  if (!Base64EncodedRegex.test(paymentRequiredHeader)) {\n    throw new Error(\"Invalid payment required header\");\n  }\n  return JSON.parse(safeBase64Decode(paymentRequiredHeader)) 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 *\n * @param paymentResponseHeader - The base64 encoded payment response header\n * @returns The decoded settle response\n */\nexport function decodePaymentResponseHeader(paymentResponseHeader: string): SettleResponse {\n  if (!Base64EncodedRegex.test(paymentResponseHeader)) {\n    throw new Error(\"Invalid payment response header\");\n  }\n  return JSON.parse(safeBase64Decode(paymentResponseHeader)) 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 { 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 Error(\n          `Unsupported t402 version: ${(paymentPayload as PaymentPayload).t402Version}`,\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 Error(\"Invalid payment required response\");\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 Error(\"Payment response header not found\");\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":";;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAO,IAAM,cAAc;;;ACWpB,IAAM,uBAAuB,CAClC,KACA,YAC+B;AAE/B,MAAI,0BAA0B,IAAI,IAAI,OAAO;AAE7C,MAAI,CAAC,yBAAyB;AAE5B,eAAW,CAAC,0BAA0B,eAAe,KAAK,IAAI,QAAQ,GAAG;AAGvE,YAAM,UAAU,yBACb,QAAQ,uBAAuB,MAAM,EACrC,QAAQ,SAAS,IAAI;AAExB,YAAM,QAAQ,IAAI,OAAO,IAAI,OAAO,GAAG;AAEvC,UAAI,MAAM,KAAK,OAAO,GAAG;AACvB,kCAA0B;AAC1B;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAEO,IAAM,yBAAyB,CACpC,KACA,QACA,YACkB;AAClB,SAAO,qBAAqB,KAAK,OAAO,GAAG,IAAI,MAAM;AACvD;AAiCO,IAAM,qBAAqB;AAQ3B,SAAS,iBAAiB,MAAsB;AACrD,MAAI,OAAO,eAAe,eAAe,OAAO,WAAW,SAAS,YAAY;AAC9E,WAAO,WAAW,KAAK,IAAI;AAAA,EAC7B;AACA,SAAO,OAAO,KAAK,IAAI,EAAE,SAAS,QAAQ;AAC5C;AAQO,SAAS,iBAAiB,MAAsB;AACrD,MAAI,OAAO,eAAe,eAAe,OAAO,WAAW,SAAS,YAAY;AAC9E,WAAO,WAAW,KAAK,IAAI;AAAA,EAC7B;AACA,SAAO,OAAO,KAAK,MAAM,QAAQ,EAAE,SAAS,OAAO;AACrD;;;ACLO,IAAM,aAAN,MAAM,YAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EActB,YAAY,6BAAyD;AAbrE,wBAAiB;AACjB,wBAAiB,2BAAsF,oBAAI,IAAI;AAC/G,wBAAiB,YAA4B,CAAC;AAE9C,wBAAQ,8BAA0D,CAAC;AACnE,wBAAQ,6BAAwD,CAAC;AACjE,wBAAQ,iCAAgE,CAAC;AAQvE,SAAK,8BAA8B,gCAAgC,CAAC,cAAc,YAAY,QAAQ,CAAC;AAAA,EACzG;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,WAAW,QAAsC;AACtD,UAAM,SAAS,IAAI,YAAW,OAAO,2BAA2B;AAChE,WAAO,QAAQ,QAAQ,YAAU;AAC/B,UAAI,OAAO,gBAAgB,GAAG;AAC5B,eAAO,WAAW,OAAO,SAAS,OAAO,MAAM;AAAA,MACjD,OAAO;AACL,eAAO,SAAS,OAAO,SAAS,OAAO,MAAM;AAAA,MAC/C;AAAA,IACF,CAAC;AACD,WAAO,UAAU,QAAQ,YAAU;AACjC,aAAO,eAAe,MAAM;AAAA,IAC9B,CAAC;AACD,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,SAAS,SAAkB,QAAyC;AAClE,WAAO,KAAK,gBAAgB,aAAa,SAAS,MAAM;AAAA,EAC1D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,WAAW,SAAiB,QAAyC;AACnE,WAAO,KAAK,gBAAgB,GAAG,SAAoB,MAAM;AAAA,EAC3D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAwBA,eAAe,QAAmC;AAChD,SAAK,SAAS,KAAK,MAAM;AACzB,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,wBAAwB,MAA6C;AACnE,SAAK,2BAA2B,KAAK,IAAI;AACzC,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,uBAAuB,MAA4C;AACjE,SAAK,0BAA0B,KAAK,IAAI;AACxC,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,yBAAyB,MAAgD;AACvE,SAAK,8BAA8B,KAAK,IAAI;AAC5C,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,qBACJ,iBACyB;AACzB,UAAM,yBAAyB,KAAK,wBAAwB,IAAI,gBAAgB,WAAW;AAC3F,QAAI,CAAC,wBAAwB;AAC3B,YAAM,IAAI,MAAM,0CAA0C,gBAAgB,WAAW,EAAE;AAAA,IACzF;AAEA,UAAM,eAAe,KAAK,0BAA0B,gBAAgB,aAAa,gBAAgB,OAAO;AAExG,UAAM,UAAkC;AAAA,MACtC;AAAA,MACA,sBAAsB;AAAA,IACxB;AAGA,eAAW,QAAQ,KAAK,4BAA4B;AAClD,YAAM,SAAS,MAAM,KAAK,OAAO;AACjC,UAAI,UAAU,WAAW,UAAU,OAAO,OAAO;AAC/C,cAAM,IAAI,MAAM,6BAA6B,OAAO,MAAM,EAAE;AAAA,MAC9D;AAAA,IACF;AAEA,QAAI;AACF,YAAM,sBAAsB,uBAAuB,wBAAwB,aAAa,QAAQ,aAAa,OAAO;AACpH,UAAI,CAAC,qBAAqB;AACxB,cAAM,IAAI,MAAM,oCAAoC,aAAa,MAAM,iBAAiB,aAAa,OAAO,EAAE;AAAA,MAChH;AAEA,YAAM,iBAAiB,MAAM,oBAAoB,qBAAqB,gBAAgB,aAAa,YAAY;AAE/G,UAAI;AACJ,UAAI,eAAe,eAAe,GAAG;AACnC,yBAAiB;AAAA,MACnB,OAAO;AACL,yBAAiB;AAAA,UACf,GAAG;AAAA,UACH,YAAY,gBAAgB;AAAA,UAC5B,UAAU,gBAAgB;AAAA,UAC1B,UAAU;AAAA,QACZ;AAAA,MACF;AAGA,YAAM,iBAAwC;AAAA,QAC5C,GAAG;AAAA,QACH;AAAA,MACF;AAEA,iBAAW,QAAQ,KAAK,2BAA2B;AACjD,cAAM,KAAK,cAAc;AAAA,MAC3B;AAEA,aAAO;AAAA,IACT,SAAS,OAAO;AACd,YAAM,iBAAgD;AAAA,QACpD,GAAG;AAAA,QACH;AAAA,MACF;AAGA,iBAAW,QAAQ,KAAK,+BAA+B;AACrD,cAAM,SAAS,MAAM,KAAK,cAAc;AACxC,YAAI,UAAU,eAAe,UAAU,OAAO,WAAW;AACvD,iBAAO,OAAO;AAAA,QAChB;AAAA,MACF;AAEA,YAAM;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBQ,0BAA0BA,cAAqB,qBAAiE;AACtH,UAAM,yBAAyB,KAAK,wBAAwB,IAAIA,YAAW;AAC3E,QAAI,CAAC,wBAAwB;AAC3B,YAAM,IAAI,MAAM,0CAA0CA,YAAW,EAAE;AAAA,IACzE;AAGA,UAAM,+BAA+B,oBAAoB,OAAO,iBAAe;AAC7E,UAAI,gBAAgB,qBAAqB,wBAAwB,YAAY,OAAO;AACpF,UAAI,CAAC,eAAe;AAClB,eAAO;AAAA,MACT;AAEA,aAAO,cAAc,IAAI,YAAY,MAAM;AAAA,IAC7C,CAAC;AAED,QAAI,6BAA6B,WAAW,GAAG;AAC7C,YAAM,IAAI,MAAM,kDAAkDA,YAAW,gDAAgD,KAAK,UAAU;AAAA,QAC1I,aAAAA;AAAA,QACA;AAAA,QACA,cAAc,MAAM,KAAK,KAAK,wBAAwB,KAAK,CAAC;AAAA,QAC5D,UAAU,MAAM,KAAK,uBAAuB,KAAK,CAAC;AAAA,QAClD,SAAS,MAAM,KAAK,uBAAuB,OAAO,CAAC,EAAE,IAAI,aAAW,MAAM,KAAK,QAAQ,KAAK,CAAC,CAAC,EAAE,KAAK;AAAA,MACvG,CAAC,CAAC,EAAE;AAAA,IACN;AAGA,QAAI,uBAAuB;AAC3B,eAAW,UAAU,KAAK,UAAU;AAClC,6BAAuB,OAAOA,cAAa,oBAAoB;AAE/D,UAAI,qBAAqB,WAAW,GAAG;AACrC,cAAM,IAAI,MAAM,4EAA4EA,YAAW,EAAE;AAAA,MAC3G;AAAA,IACF;AAGA,WAAO,KAAK,4BAA4BA,cAAa,oBAAoB;AAAA,EAC3E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUQ,gBAAgBA,cAAqB,SAAkB,QAAyC;AACtG,QAAI,CAAC,KAAK,wBAAwB,IAAIA,YAAW,GAAG;AAClD,WAAK,wBAAwB,IAAIA,cAAa,oBAAI,IAAI,CAAC;AAAA,IACzD;AACA,UAAM,yBAAyB,KAAK,wBAAwB,IAAIA,YAAW;AAC3E,QAAI,CAAC,uBAAuB,IAAI,OAAO,GAAG;AACxC,6BAAuB,IAAI,SAAS,oBAAI,IAAI,CAAC;AAAA,IAC/C;AAEA,UAAM,iBAAiB,uBAAuB,IAAI,OAAO;AACzD,QAAI,CAAC,eAAe,IAAI,OAAO,MAAM,GAAG;AACtC,qBAAe,IAAI,OAAO,QAAQ,MAAM;AAAA,IAC1C;AAEA,WAAO;AAAA,EACT;AACF;;;AC7WO,SAAS,6BAA6B,gBAAwC;AACnF,SAAO,iBAAiB,KAAK,UAAU,cAAc,CAAC;AACxD;AA+BO,SAAS,4BAA4B,uBAAgD;AAC1F,MAAI,CAAC,mBAAmB,KAAK,qBAAqB,GAAG;AACnD,UAAM,IAAI,MAAM,iCAAiC;AAAA,EACnD;AACA,SAAO,KAAK,MAAM,iBAAiB,qBAAqB,CAAC;AAC3D;AAoBO,SAAS,4BAA4B,uBAA+C;AACzF,MAAI,CAAC,mBAAmB,KAAK,qBAAqB,GAAG;AACnD,UAAM,IAAI,MAAM,iCAAiC;AAAA,EACnD;AACA,SAAO,KAAK,MAAM,iBAAiB,qBAAqB,CAAC;AAC3D;;;AChEO,IAAM,iBAAN,MAAqB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAM1B,YAA6B,QAAoB;AAApB;AAAA,EAAqB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQlD,6BAA6B,gBAAwD;AACnF,YAAQ,eAAe,aAAa;AAAA,MAClC,KAAK;AACH,eAAO;AAAA,UACL,qBAAqB,6BAA6B,cAAc;AAAA,QAClE;AAAA,MACF,KAAK;AACH,eAAO;AAAA,UACL,aAAa,6BAA6B,cAAc;AAAA,QAC1D;AAAA,MACF;AACE,cAAM,IAAI;AAAA,UACR,6BAA8B,eAAkC,WAAW;AAAA,QAC7E;AAAA,IACJ;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,2BACE,WACA,MACiB;AAEjB,UAAM,kBAAkB,UAAU,kBAAkB;AACpD,QAAI,iBAAiB;AACnB,aAAO,4BAA4B,eAAe;AAAA,IACpD;AAGA,QACE,QACA,gBAAgB,UAChB,iBAAiB,QAChB,KAAyB,gBAAgB,GAC1C;AACA,aAAO;AAAA,IACT;AAEA,UAAM,IAAI,MAAM,mCAAmC;AAAA,EACrD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,yBAAyB,WAAwE;AAE/F,UAAM,kBAAkB,UAAU,kBAAkB;AACpD,QAAI,iBAAiB;AACnB,aAAO,4BAA4B,eAAe;AAAA,IACpD;AAGA,UAAM,mBAAmB,UAAU,oBAAoB;AACvD,QAAI,kBAAkB;AACpB,aAAO,4BAA4B,gBAAgB;AAAA,IACrD;AAEA,UAAM,IAAI,MAAM,mCAAmC;AAAA,EACrD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,qBAAqB,iBAA2D;AACpF,WAAO,KAAK,OAAO,qBAAqB,eAAe;AAAA,EACzD;AACF;;;AC9EO,IAAM,yBAAiD;AAAA,EAC5D,OAAO;AAAA;AAAA,EACP,MAAM;AAAA;AAAA,EACN,MAAM;AAAA;AAAA,EACN,KAAK;AAAA;AAAA,EACL,MAAM;AAAA;AACR;AAiDO,SAAS,wBACd,cACA,cACA,UAAiC,CAAC,GACZ;AACtB,QAAM,EAAE,gBAAgB,wBAAwB,oBAAoB,CAAC,GAAG,2BAA2B,KAAK,IAAI;AAE5G,MAAI,aAAa,WAAW,GAAG;AAC7B,WAAO;AAAA,MACL,UAAU;AAAA,MACV,cAAc,CAAC;AAAA,MACf,QAAQ;AAAA,IACV;AAAA,EACF;AAGA,QAAM,aAAa,oBAAI,IAAoB;AAC3C,aAAW,WAAW,cAAc;AAClC,UAAM,MAAM,GAAG,QAAQ,OAAO,IAAI,QAAQ,MAAM,YAAY,CAAC;AAC7D,eAAW,IAAI,KAAK,OAAO,QAAQ,MAAM,CAAC;AAAA,EAC5C;AAGA,QAAM,SAAS,aACZ,IAAI,CAAC,QAAQ;AACZ,UAAM,MAAM,GAAG,IAAI,OAAO,IAAI,IAAI,MAAM,YAAY,CAAC;AACrD,UAAM,cAAc,WAAW,IAAI,GAAG,KAAK;AAC3C,UAAM,iBAAiB,OAAO,IAAI,MAAM;AACxC,UAAM,uBAAuB,eAAe;AAG5C,UAAM,SAAU,IAAI,OAAO,UAAsB,IAAI,OAAO,QAAmB;AAG/E,QAAI,gBAAgB,cAAc,OAAO,YAAY,CAAC,KAAK;AAG3D,QAAI,kBAAkB,SAAS,IAAI,OAAO,GAAG;AAC3C,uBAAiB;AAAA,IACnB;AAGA,QAAI,CAAC,sBAAsB;AACzB,uBAAiB;AAAA,IACnB;AAEA,WAAO;AAAA,MACL,aAAa;AAAA,MACb;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF,CAAC,EACA,KAAK,CAAC,GAAG,MAAM,EAAE,gBAAgB,EAAE,aAAa;AAGnD,QAAM,eAAe,2BAA2B,OAAO,OAAO,CAAC,MAAM,EAAE,oBAAoB,IAAI;AAE/F,MAAI,aAAa,WAAW,GAAG;AAC7B,WAAO;AAAA,MACL,UAAU;AAAA,MACV,cAAc,OAAO,IAAI,CAAC,MAAM,EAAE,WAAW;AAAA,MAC7C,QAAQ,2BACJ,8CACA;AAAA,IACN;AAAA,EACF;AAEA,SAAO;AAAA,IACL,UAAU,aAAa,CAAC,EAAE;AAAA,IAC1B,cAAc,aAAa,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,WAAW;AAAA,EAC9D;AACF;AAQO,SAAS,iBAAiB,aAA2C;AAC1E,QAAM,YAAY,YAAY,OAAO;AACrC,SAAO,cAAc;AACvB;AAQO,SAAS,eAAe,aAA2C;AACxE,QAAM,SAAS,YAAY,OAAO;AAClC,SAAO,WAAW;AACpB;AASO,SAAS,cAAc,cAAqC,QAAuC;AACxG,SAAO,aAAa,OAAO,CAAC,QAAQ;AAClC,UAAM,YAAa,IAAI,OAAO,UAAqB;AACnD,WAAO,UAAU,YAAY,MAAM,OAAO,YAAY;AAAA,EACxD,CAAC;AACH;AASO,SAAS,gBAAgB,cAAqC,SAAwC;AAC3G,SAAO,aAAa,OAAO,CAAC,QAAQ,IAAI,YAAY,OAAO;AAC7D;AAQO,SAAS,qBAAqB,cAA+C;AAClF,SAAO,CAAC,GAAG,IAAI,IAAI,aAAa,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,CAAC;AAC5D;AAQO,SAAS,mBAAmB,cAA+C;AAChF,SAAO;AAAA,IACL,GAAG,IAAI;AAAA,MACL,aAAa,IAAI,CAAC,QAAS,IAAI,OAAO,UAAsB,IAAI,OAAO,QAAmB,SAAS;AAAA,IACrG;AAAA,EACF;AACF;","names":["t402Version"]}
+{"version":3,"sources":["../../../src/client/index.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\";","export const t402Version = 2;\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});\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 { 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 Error(\n          `Unsupported t402 version: ${(paymentPayload as PaymentPayload).t402Version}`,\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 Error(\"Invalid payment required response\");\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 Error(\"Payment response header not found\");\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/facilitator/index.d.ts

@@ -1,4 +1,5 @@
-import { a as PaymentPayload, P as PaymentRequirements, V as VerifyResponse, S as SettleResponse, N as Network, b as SchemeNetworkFacilitator } from '../mechanisms-B-vz5yOj.js';
+import { a as PaymentPayload, P as PaymentRequirements, V as VerifyResponse, S as SettleResponse, N as Network, b as SchemeNetworkFacilitator } from '../mechanisms-C7yK91d4.js';
+import 'zod';
 
 /**
  * Facilitator Hook Context Interfaces

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

@@ -1,6 +1,7 @@
-import { a as PaymentPayload, c as PaymentRequired, S as SettleResponse, P as PaymentRequirements } from '../mechanisms-B-vz5yOj.js';
-export { C as CompiledRoute, D as DynamicPayTo, i as DynamicPrice, F as FacilitatorClient, o as FacilitatorConfig, a as HTTPAdapter, H as HTTPFacilitatorClient, d as HTTPProcessResult, b as HTTPRequestContext, c as HTTPResponseInstructions, f as PaymentOption, P as PaywallConfig, e as PaywallProvider, m as ProcessSettleFailureResponse, k as ProcessSettleResultResponse, l as ProcessSettleSuccessResponse, g as RouteConfig, R as RouteConfigurationError, n as RouteValidationError, h as RoutesConfig, U as UnpaidResponseBody, j as UnpaidResponseResult, t as t402HTTPResourceServer } from '../t402HTTPResourceServer-CcpZF3af.js';
-export { f as t402HTTPClient } from '../t402HTTPClient-GIweW6nh.js';
+import { a as PaymentPayload, c as PaymentRequired, S as SettleResponse, P as PaymentRequirements } from '../mechanisms-C7yK91d4.js';
+export { C as CompiledRoute, D as DynamicPayTo, i as DynamicPrice, F as FacilitatorClient, o as FacilitatorConfig, a as HTTPAdapter, H as HTTPFacilitatorClient, d as HTTPProcessResult, b as HTTPRequestContext, c as HTTPResponseInstructions, f as PaymentOption, P as PaywallConfig, e as PaywallProvider, m as ProcessSettleFailureResponse, k as ProcessSettleResultResponse, l as ProcessSettleSuccessResponse, g as RouteConfig, R as RouteConfigurationError, n as RouteValidationError, h as RoutesConfig, U as UnpaidResponseBody, j as UnpaidResponseResult, t as t402HTTPResourceServer } from '../t402HTTPResourceServer-CybruqCk.js';
+export { f as t402HTTPClient } from '../t402HTTPClient-DmkFydNG.js';
+import 'zod';
 
 type QueryParamMethods = "GET" | "HEAD" | "DELETE";
 type BodyMethods = "POST" | "PUT" | "PATCH";
@@ -13,9 +14,11 @@ type BodyMethods = "POST" | "PUT" | "PATCH";
 declare function encodePaymentSignatureHeader(paymentPayload: PaymentPayload): string;
 /**
  * Decodes a base64 payment signature header into a payment payload.
+ * Validates the payload structure using Zod schema.
  *
  * @param paymentSignatureHeader - The base64 encoded payment signature header
- * @returns The decoded payment payload
+ * @returns The decoded and validated payment payload
+ * @throws Error if the header is invalid or fails schema validation
  */
 declare function decodePaymentSignatureHeader(paymentSignatureHeader: string): PaymentPayload;
 /**
@@ -27,9 +30,11 @@ declare function decodePaymentSignatureHeader(paymentSignatureHeader: string): P
 declare function encodePaymentRequiredHeader(paymentRequired: PaymentRequired): string;
 /**
  * Decodes a base64 payment required header into a payment required object.
+ * Validates the structure using Zod schema.
  *
  * @param paymentRequiredHeader - The base64 encoded payment required header
- * @returns The decoded payment required object
+ * @returns The decoded and validated payment required object
+ * @throws Error if the header is invalid or fails schema validation
  */
 declare function decodePaymentRequiredHeader(paymentRequiredHeader: string): PaymentRequired;
 /**
@@ -43,9 +48,11 @@ declare function encodePaymentResponseHeader(paymentResponse: SettleResponse & {
 }): string;
 /**
  * Decodes a base64 payment response header into a settle response.
+ * Validates the structure using Zod schema.
  *
  * @param paymentResponseHeader - The base64 encoded payment response header
- * @returns The decoded settle response
+ * @returns The decoded and validated settle response
+ * @throws Error if the header is invalid or fails schema validation
  */
 declare function decodePaymentResponseHeader(paymentResponseHeader: string): SettleResponse;
 

package/dist/cjs/http/index.js

@@ -35,6 +35,70 @@ __export(http_exports, {
 });
 module.exports = __toCommonJS(http_exports);
 
+// src/types/schemas.ts
+var import_zod = require("zod");
+var NetworkSchema = import_zod.z.string().regex(/^[a-z0-9-]+:[a-zA-Z0-9-]+$/, {
+  message: "Network must be in CAIP-2 format (e.g., 'eip155:1', 'solana:mainnet')"
+});
+var ResourceInfoSchema = import_zod.z.object({
+  url: import_zod.z.string().url({ message: "Resource URL must be a valid URL" }),
+  description: import_zod.z.string().optional(),
+  mimeType: import_zod.z.string().optional()
+});
+var PaymentRequirementsSchema = import_zod.z.object({
+  scheme: import_zod.z.string().min(1, { message: "Scheme is required" }),
+  network: NetworkSchema,
+  asset: import_zod.z.string().min(1, { message: "Asset address is required" }),
+  amount: import_zod.z.string().regex(/^\d+$/, { message: "Amount must be a non-negative integer string" }),
+  payTo: import_zod.z.string().min(1, { message: "PayTo address is required" }),
+  maxTimeoutSeconds: import_zod.z.number().int().positive({ message: "maxTimeoutSeconds must be a positive integer" }),
+  extra: import_zod.z.record(import_zod.z.unknown())
+});
+var PaymentRequiredSchema = import_zod.z.object({
+  t402Version: import_zod.z.literal(2, {
+    errorMap: () => ({ message: "t402Version must be 2 for V2 protocol" })
+  }),
+  error: import_zod.z.string().optional(),
+  resource: ResourceInfoSchema,
+  accepts: import_zod.z.array(PaymentRequirementsSchema).min(1, { message: "At least one payment option is required" }),
+  extensions: import_zod.z.record(import_zod.z.unknown()).optional()
+});
+var PaymentPayloadSchema = import_zod.z.object({
+  t402Version: import_zod.z.literal(2, {
+    errorMap: () => ({ message: "t402Version must be 2 for V2 protocol" })
+  }),
+  resource: ResourceInfoSchema.optional(),
+  accepted: PaymentRequirementsSchema,
+  payload: import_zod.z.record(import_zod.z.unknown()),
+  extensions: import_zod.z.record(import_zod.z.unknown()).optional()
+});
+var VerifyResponseSchema = import_zod.z.object({
+  isValid: import_zod.z.boolean(),
+  invalidReason: import_zod.z.string().optional(),
+  payer: import_zod.z.string().optional()
+});
+var SettleResponseSchema = import_zod.z.object({
+  success: import_zod.z.boolean(),
+  transaction: import_zod.z.string(),
+  network: NetworkSchema,
+  errorReason: import_zod.z.string().optional(),
+  payer: import_zod.z.string().optional()
+});
+var PaymentRequirementsV1Schema = import_zod.z.object({
+  scheme: import_zod.z.string().min(1),
+  network: import_zod.z.string().min(1),
+  asset: import_zod.z.string().min(1),
+  amount: import_zod.z.string().regex(/^\d+$/),
+  payTo: import_zod.z.string().min(1),
+  maxTimeoutSeconds: import_zod.z.number().int().positive(),
+  extra: import_zod.z.record(import_zod.z.unknown()).optional()
+});
+var PaymentPayloadV1Schema = import_zod.z.object({
+  t402Version: import_zod.z.literal(1).optional(),
+  accepted: PaymentRequirementsV1Schema,
+  payload: import_zod.z.record(import_zod.z.unknown())
+});
+
 // src/utils/index.ts
 var Base64EncodedRegex = /^[A-Za-z0-9+/]*={0,2}$/;
 function safeBase64Encode(data) {
@@ -736,7 +800,9 @@ function decodePaymentSignatureHeader(paymentSignatureHeader) {
   if (!Base64EncodedRegex.test(paymentSignatureHeader)) {
     throw new Error("Invalid payment signature header");
   }
-  return JSON.parse(safeBase64Decode(paymentSignatureHeader));
+  const parsed = JSON.parse(safeBase64Decode(paymentSignatureHeader));
+  PaymentPayloadSchema.parse(parsed);
+  return parsed;
 }
 function encodePaymentRequiredHeader(paymentRequired) {
   return safeBase64Encode(JSON.stringify(paymentRequired));
@@ -745,7 +811,9 @@ function decodePaymentRequiredHeader(paymentRequiredHeader) {
   if (!Base64EncodedRegex.test(paymentRequiredHeader)) {
     throw new Error("Invalid payment required header");
   }
-  return JSON.parse(safeBase64Decode(paymentRequiredHeader));
+  const parsed = JSON.parse(safeBase64Decode(paymentRequiredHeader));
+  PaymentRequiredSchema.parse(parsed);
+  return parsed;
 }
 function encodePaymentResponseHeader(paymentResponse) {
   return safeBase64Encode(JSON.stringify(paymentResponse));
@@ -754,7 +822,9 @@ function decodePaymentResponseHeader(paymentResponseHeader) {
   if (!Base64EncodedRegex.test(paymentResponseHeader)) {
     throw new Error("Invalid payment response header");
   }
-  return JSON.parse(safeBase64Decode(paymentResponseHeader));
+  const parsed = JSON.parse(safeBase64Decode(paymentResponseHeader));
+  SettleResponseSchema.parse(parsed);
+  return parsed;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {