@x402/hono 2.5.0 → 2.7.0

package/dist/cjs/index.d.ts

@@ -1,4 +1,4 @@
-import { HTTPAdapter, RoutesConfig, x402ResourceServer, PaywallConfig, PaywallProvider, FacilitatorClient, x402HTTPResourceServer } from '@x402/core/server';
+import { HTTPAdapter, x402HTTPResourceServer, PaywallConfig, PaywallProvider, RoutesConfig, x402ResourceServer, FacilitatorClient } from '@x402/core/server';
 export { PaywallConfig, PaywallProvider, RouteConfigurationError, RouteValidationError, x402HTTPResourceServer, x402ResourceServer } from '@x402/core/server';
 import { Network, SchemeNetworkServer } from '@x402/core/types';
 export { Network, PaymentPayload, PaymentRequired, PaymentRequirements, SchemeNetworkServer } from '@x402/core/types';

package/dist/cjs/index.js

@@ -211,13 +211,12 @@ function paymentMiddlewareFromHTTPServer(httpServer, paywallConfig, paywall, syn
             { request: context, responseBody }
           );
           if (!settleResult.success) {
-            res = c.json(
-              {
-                error: "Settlement failed",
-                details: settleResult.errorReason
-              },
-              402
-            );
+            const { response: response2 } = settleResult;
+            const body = response2.isHtml ? String(response2.body ?? "") : JSON.stringify(response2.body ?? {});
+            res = new Response(body, {
+              status: response2.status,
+              headers: response2.headers
+            });
           } else {
             Object.entries(settleResult.headers).forEach(([key, value]) => {
               res.headers.set(key, value);
@@ -225,13 +224,7 @@ function paymentMiddlewareFromHTTPServer(httpServer, paywallConfig, paywall, syn
           }
         } catch (error) {
           console.error(error);
-          res = c.json(
-            {
-              error: "Settlement failed",
-              details: error instanceof Error ? error.message : "Unknown error"
-            },
-            402
-          );
+          res = c.json({}, 402);
         }
         c.res = res;
         return;

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts","../../src/adapter.ts"],"sourcesContent":["import {\n  HTTPRequestContext,\n  PaywallConfig,\n  PaywallProvider,\n  x402HTTPResourceServer,\n  x402ResourceServer,\n  RoutesConfig,\n  FacilitatorClient,\n} from \"@x402/core/server\";\nimport { SchemeNetworkServer, Network } from \"@x402/core/types\";\nimport { Context, MiddlewareHandler } from \"hono\";\nimport { HonoAdapter } from \"./adapter\";\n\n/**\n * Check if any routes in the configuration declare bazaar extensions\n *\n * @param routes - Route configuration\n * @returns True if any route has extensions.bazaar defined\n */\nfunction checkIfBazaarNeeded(routes: RoutesConfig): boolean {\n  // Handle single route config\n  if (\"accepts\" in routes) {\n    return !!(routes.extensions && \"bazaar\" in routes.extensions);\n  }\n\n  // Handle multiple routes\n  return Object.values(routes).some(routeConfig => {\n    return !!(routeConfig.extensions && \"bazaar\" in routeConfig.extensions);\n  });\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:84532', 'solana:mainnet')\n   */\n  network: Network;\n\n  /**\n   * The scheme server implementation for this network\n   */\n  server: SchemeNetworkServer;\n}\n\n/**\n * Hono payment middleware for x402 protocol (direct HTTP server instance).\n *\n * Use this when you need to configure HTTP-level hooks.\n *\n * @param httpServer - Pre-configured x402HTTPResourceServer instance\n * @param paywallConfig - Optional configuration for the built-in paywall UI\n * @param paywall - Optional custom paywall provider (overrides default)\n * @param syncFacilitatorOnStart - Whether to sync with the facilitator on startup (defaults to true)\n * @returns Hono middleware handler\n *\n * @example\n * ```typescript\n * import { paymentMiddlewareFromHTTPServer, x402ResourceServer, x402HTTPResourceServer } from \"@x402/hono\";\n *\n * const resourceServer = new x402ResourceServer(facilitatorClient)\n *   .register(NETWORK, new ExactEvmScheme());\n *\n * const httpServer = new x402HTTPResourceServer(resourceServer, routes)\n *   .onProtectedRequest(requestHook);\n *\n * app.use(paymentMiddlewareFromHTTPServer(httpServer));\n * ```\n */\nexport function paymentMiddlewareFromHTTPServer(\n  httpServer: x402HTTPResourceServer,\n  paywallConfig?: PaywallConfig,\n  paywall?: PaywallProvider,\n  syncFacilitatorOnStart: boolean = true,\n): MiddlewareHandler {\n  // Register custom paywall provider if provided\n  if (paywall) {\n    httpServer.registerPaywallProvider(paywall);\n  }\n\n  // Store initialization promise (not the result)\n  // httpServer.initialize() fetches facilitator support and validates routes\n  let initPromise: Promise<void> | null = syncFacilitatorOnStart ? httpServer.initialize() : null;\n\n  // Dynamically register bazaar extension if routes declare it and not already registered\n  // Skip if pre-registered (e.g., in serverless environments where static imports are used)\n  let bazaarPromise: Promise<void> | null = null;\n  if (checkIfBazaarNeeded(httpServer.routes) && !httpServer.server.hasExtension(\"bazaar\")) {\n    bazaarPromise = import(\"@x402/extensions/bazaar\")\n      .then(({ bazaarResourceServerExtension }) => {\n        httpServer.server.registerExtension(bazaarResourceServerExtension);\n      })\n      .catch(err => {\n        console.error(\"Failed to load bazaar extension:\", err);\n      });\n  }\n\n  return async (c: Context, next: () => Promise<void>) => {\n    // Create adapter and context\n    const adapter = new HonoAdapter(c);\n    const context: HTTPRequestContext = {\n      adapter,\n      path: c.req.path,\n      method: c.req.method,\n      paymentHeader: adapter.getHeader(\"payment-signature\") || adapter.getHeader(\"x-payment\"),\n    };\n\n    // Check if route requires payment before initializing facilitator\n    if (!httpServer.requiresPayment(context)) {\n      return next();\n    }\n\n    // Only initialize when processing a protected route\n    if (initPromise) {\n      await initPromise;\n      initPromise = null; // Clear after first await\n    }\n\n    // Await bazaar extension loading if needed\n    if (bazaarPromise) {\n      await bazaarPromise;\n      bazaarPromise = null;\n    }\n\n    // Process payment requirement check\n    const result = await httpServer.processHTTPRequest(context, paywallConfig);\n\n    // Handle the different result types\n    switch (result.type) {\n      case \"no-payment-required\":\n        // No payment needed, proceed directly to the route handler\n        return next();\n\n      case \"payment-error\":\n        // Payment required but not provided or invalid\n        const { response } = result;\n        Object.entries(response.headers).forEach(([key, value]) => {\n          c.header(key, value);\n        });\n        if (response.isHtml) {\n          return c.html(response.body as string, response.status as 402);\n        } else {\n          return c.json(response.body || {}, response.status as 402);\n        }\n\n      case \"payment-verified\":\n        // Payment is valid, need to wrap response for settlement\n        const { paymentPayload, paymentRequirements, declaredExtensions } = result;\n\n        // Proceed to the next middleware or route handler\n        await next();\n\n        // Get the current response\n        let res = c.res;\n\n        // If the response from the protected route is >= 400, do not settle payment\n        if (res.status >= 400) {\n          return;\n        }\n\n        // Get response body for extensions\n        const responseBody = Buffer.from(await res.clone().arrayBuffer());\n\n        // Clear the response so we can modify headers\n        c.res = undefined;\n\n        try {\n          const settleResult = await httpServer.processSettlement(\n            paymentPayload,\n            paymentRequirements,\n            declaredExtensions,\n            { request: context, responseBody },\n          );\n\n          if (!settleResult.success) {\n            // Settlement failed - do not return the protected resource\n            res = c.json(\n              {\n                error: \"Settlement failed\",\n                details: settleResult.errorReason,\n              },\n              402,\n            );\n          } else {\n            // Settlement succeeded - add headers to response\n            Object.entries(settleResult.headers).forEach(([key, value]) => {\n              res.headers.set(key, value);\n            });\n          }\n        } catch (error) {\n          console.error(error);\n          // If settlement fails, return an error response\n          res = c.json(\n            {\n              error: \"Settlement failed\",\n              details: error instanceof Error ? error.message : \"Unknown error\",\n            },\n            402,\n          );\n        }\n\n        // Restore the response (potentially modified with settlement headers)\n        c.res = res;\n        return;\n    }\n  };\n}\n\n/**\n * Hono payment middleware for x402 protocol (direct server instance).\n *\n * Use this when you want to pass a pre-configured x402ResourceServer instance.\n * This provides more flexibility for testing, custom configuration, and reusing\n * server instances across multiple middlewares.\n *\n * @param routes - Route configurations for protected endpoints\n * @param server - Pre-configured x402ResourceServer instance\n * @param paywallConfig - Optional configuration for the built-in paywall UI\n * @param paywall - Optional custom paywall provider (overrides default)\n * @param syncFacilitatorOnStart - Whether to sync with the facilitator on startup (defaults to true)\n * @returns Hono middleware handler\n *\n * @example\n * ```typescript\n * import { paymentMiddleware } from \"@x402/hono\";\n *\n * const server = new x402ResourceServer(myFacilitatorClient)\n *   .register(NETWORK, new ExactEvmScheme());\n *\n * app.use(paymentMiddleware(routes, server, paywallConfig));\n * ```\n */\nexport function paymentMiddleware(\n  routes: RoutesConfig,\n  server: x402ResourceServer,\n  paywallConfig?: PaywallConfig,\n  paywall?: PaywallProvider,\n  syncFacilitatorOnStart: boolean = true,\n): MiddlewareHandler {\n  // Create the x402 HTTP server instance with the resource server\n  const httpServer = new x402HTTPResourceServer(server, routes);\n\n  return paymentMiddlewareFromHTTPServer(\n    httpServer,\n    paywallConfig,\n    paywall,\n    syncFacilitatorOnStart,\n  );\n}\n\n/**\n * Hono payment middleware for x402 protocol (configuration-based).\n *\n * Use this when you want to quickly set up middleware with simple configuration.\n * This function creates and configures the x402ResourceServer internally.\n *\n * @param routes - Route configurations for protected endpoints\n * @param facilitatorClients - Optional facilitator client(s) for payment processing\n * @param schemes - Optional array of scheme registrations for server-side payment processing\n * @param paywallConfig - Optional configuration for the built-in paywall UI\n * @param paywall - Optional custom paywall provider (overrides default)\n * @param syncFacilitatorOnStart - Whether to sync with the facilitator on startup (defaults to true)\n * @returns Hono middleware handler\n *\n * @example\n * ```typescript\n * import { paymentMiddlewareFromConfig } from \"@x402/hono\";\n *\n * app.use(paymentMiddlewareFromConfig(\n *   routes,\n *   myFacilitatorClient,\n *   [{ network: \"eip155:8453\", server: evmSchemeServer }],\n *   paywallConfig\n * ));\n * ```\n */\nexport function paymentMiddlewareFromConfig(\n  routes: RoutesConfig,\n  facilitatorClients?: FacilitatorClient | FacilitatorClient[],\n  schemes?: SchemeRegistration[],\n  paywallConfig?: PaywallConfig,\n  paywall?: PaywallProvider,\n  syncFacilitatorOnStart: boolean = true,\n): MiddlewareHandler {\n  const ResourceServer = new x402ResourceServer(facilitatorClients);\n\n  if (schemes) {\n    schemes.forEach(({ network, server: schemeServer }) => {\n      ResourceServer.register(network, schemeServer);\n    });\n  }\n\n  // Use the direct paymentMiddleware with the configured server\n  // Note: paymentMiddleware handles dynamic bazaar registration\n  return paymentMiddleware(routes, ResourceServer, paywallConfig, paywall, syncFacilitatorOnStart);\n}\n\nexport { x402ResourceServer, x402HTTPResourceServer } from \"@x402/core/server\";\n\nexport type {\n  PaymentRequired,\n  PaymentRequirements,\n  PaymentPayload,\n  Network,\n  SchemeNetworkServer,\n} from \"@x402/core/types\";\n\nexport type { PaywallProvider, PaywallConfig } from \"@x402/core/server\";\n\nexport { RouteConfigurationError } from \"@x402/core/server\";\n\nexport type { RouteValidationError } from \"@x402/core/server\";\n\nexport { HonoAdapter } from \"./adapter\";\n","import { HTTPAdapter } from \"@x402/core/server\";\nimport { Context } from \"hono\";\n\n/**\n * Hono adapter implementation\n */\nexport class HonoAdapter implements HTTPAdapter {\n  /**\n   * Creates a new HonoAdapter instance.\n   *\n   * @param c - The Hono context object\n   */\n  constructor(private c: Context) {}\n\n  /**\n   * Gets a header value from the request.\n   *\n   * @param name - The header name\n   * @returns The header value or undefined\n   */\n  getHeader(name: string): string | undefined {\n    return this.c.req.header(name);\n  }\n\n  /**\n   * Gets the HTTP method of the request.\n   *\n   * @returns The HTTP method\n   */\n  getMethod(): string {\n    return this.c.req.method;\n  }\n\n  /**\n   * Gets the path of the request.\n   *\n   * @returns The request path\n   */\n  getPath(): string {\n    return this.c.req.path;\n  }\n\n  /**\n   * Gets the full URL of the request.\n   *\n   * @returns The full request URL\n   */\n  getUrl(): string {\n    return this.c.req.url;\n  }\n\n  /**\n   * Gets the Accept header from the request.\n   *\n   * @returns The Accept header value or empty string\n   */\n  getAcceptHeader(): string {\n    return this.c.req.header(\"Accept\") || \"\";\n  }\n\n  /**\n   * Gets the User-Agent header from the request.\n   *\n   * @returns The User-Agent header value or empty string\n   */\n  getUserAgent(): string {\n    return this.c.req.header(\"User-Agent\") || \"\";\n  }\n\n  /**\n   * Gets all query parameters from the request URL.\n   *\n   * @returns Record of query parameter key-value pairs\n   */\n  getQueryParams(): Record<string, string | string[]> {\n    const query = this.c.req.query();\n    // Convert single values to match the interface\n    const result: Record<string, string | string[]> = {};\n    for (const [key, value] of Object.entries(query)) {\n      result[key] = value;\n    }\n    return result;\n  }\n\n  /**\n   * Gets a specific query parameter by name.\n   *\n   * @param name - The query parameter name\n   * @returns The query parameter value(s) or undefined\n   */\n  getQueryParam(name: string): string | string[] | undefined {\n    return this.c.req.query(name);\n  }\n\n  /**\n   * Gets the parsed request body.\n   * Requires appropriate body parsing middleware.\n   *\n   * @returns The parsed request body\n   */\n  async getBody(): Promise<unknown> {\n    try {\n      return await this.c.req.json();\n    } catch {\n      return undefined;\n    }\n  }\n}\n"],"mappings":"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","names":["import_server"]}
+{"version":3,"sources":["../../src/index.ts","../../src/adapter.ts"],"sourcesContent":["import {\n  HTTPRequestContext,\n  PaywallConfig,\n  PaywallProvider,\n  x402HTTPResourceServer,\n  x402ResourceServer,\n  RoutesConfig,\n  FacilitatorClient,\n} from \"@x402/core/server\";\nimport { SchemeNetworkServer, Network } from \"@x402/core/types\";\nimport { Context, MiddlewareHandler } from \"hono\";\nimport { HonoAdapter } from \"./adapter\";\n\n/**\n * Check if any routes in the configuration declare bazaar extensions\n *\n * @param routes - Route configuration\n * @returns True if any route has extensions.bazaar defined\n */\nfunction checkIfBazaarNeeded(routes: RoutesConfig): boolean {\n  // Handle single route config\n  if (\"accepts\" in routes) {\n    return !!(routes.extensions && \"bazaar\" in routes.extensions);\n  }\n\n  // Handle multiple routes\n  return Object.values(routes).some(routeConfig => {\n    return !!(routeConfig.extensions && \"bazaar\" in routeConfig.extensions);\n  });\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:84532', 'solana:mainnet')\n   */\n  network: Network;\n\n  /**\n   * The scheme server implementation for this network\n   */\n  server: SchemeNetworkServer;\n}\n\n/**\n * Hono payment middleware for x402 protocol (direct HTTP server instance).\n *\n * Use this when you need to configure HTTP-level hooks.\n *\n * @param httpServer - Pre-configured x402HTTPResourceServer instance\n * @param paywallConfig - Optional configuration for the built-in paywall UI\n * @param paywall - Optional custom paywall provider (overrides default)\n * @param syncFacilitatorOnStart - Whether to sync with the facilitator on startup (defaults to true)\n * @returns Hono middleware handler\n *\n * @example\n * ```typescript\n * import { paymentMiddlewareFromHTTPServer, x402ResourceServer, x402HTTPResourceServer } from \"@x402/hono\";\n *\n * const resourceServer = new x402ResourceServer(facilitatorClient)\n *   .register(NETWORK, new ExactEvmScheme());\n *\n * const httpServer = new x402HTTPResourceServer(resourceServer, routes)\n *   .onProtectedRequest(requestHook);\n *\n * app.use(paymentMiddlewareFromHTTPServer(httpServer));\n * ```\n */\nexport function paymentMiddlewareFromHTTPServer(\n  httpServer: x402HTTPResourceServer,\n  paywallConfig?: PaywallConfig,\n  paywall?: PaywallProvider,\n  syncFacilitatorOnStart: boolean = true,\n): MiddlewareHandler {\n  // Register custom paywall provider if provided\n  if (paywall) {\n    httpServer.registerPaywallProvider(paywall);\n  }\n\n  // Store initialization promise (not the result)\n  // httpServer.initialize() fetches facilitator support and validates routes\n  let initPromise: Promise<void> | null = syncFacilitatorOnStart ? httpServer.initialize() : null;\n\n  // Dynamically register bazaar extension if routes declare it and not already registered\n  // Skip if pre-registered (e.g., in serverless environments where static imports are used)\n  let bazaarPromise: Promise<void> | null = null;\n  if (checkIfBazaarNeeded(httpServer.routes) && !httpServer.server.hasExtension(\"bazaar\")) {\n    bazaarPromise = import(\"@x402/extensions/bazaar\")\n      .then(({ bazaarResourceServerExtension }) => {\n        httpServer.server.registerExtension(bazaarResourceServerExtension);\n      })\n      .catch(err => {\n        console.error(\"Failed to load bazaar extension:\", err);\n      });\n  }\n\n  return async (c: Context, next: () => Promise<void>) => {\n    // Create adapter and context\n    const adapter = new HonoAdapter(c);\n    const context: HTTPRequestContext = {\n      adapter,\n      path: c.req.path,\n      method: c.req.method,\n      paymentHeader: adapter.getHeader(\"payment-signature\") || adapter.getHeader(\"x-payment\"),\n    };\n\n    // Check if route requires payment before initializing facilitator\n    if (!httpServer.requiresPayment(context)) {\n      return next();\n    }\n\n    // Only initialize when processing a protected route\n    if (initPromise) {\n      await initPromise;\n      initPromise = null; // Clear after first await\n    }\n\n    // Await bazaar extension loading if needed\n    if (bazaarPromise) {\n      await bazaarPromise;\n      bazaarPromise = null;\n    }\n\n    // Process payment requirement check\n    const result = await httpServer.processHTTPRequest(context, paywallConfig);\n\n    // Handle the different result types\n    switch (result.type) {\n      case \"no-payment-required\":\n        // No payment needed, proceed directly to the route handler\n        return next();\n\n      case \"payment-error\":\n        // Payment required but not provided or invalid\n        const { response } = result;\n        Object.entries(response.headers).forEach(([key, value]) => {\n          c.header(key, value);\n        });\n        if (response.isHtml) {\n          return c.html(response.body as string, response.status as 402);\n        } else {\n          return c.json(response.body || {}, response.status as 402);\n        }\n\n      case \"payment-verified\":\n        // Payment is valid, need to wrap response for settlement\n        const { paymentPayload, paymentRequirements, declaredExtensions } = result;\n\n        // Proceed to the next middleware or route handler\n        await next();\n\n        // Get the current response\n        let res = c.res;\n\n        // If the response from the protected route is >= 400, do not settle payment\n        if (res.status >= 400) {\n          return;\n        }\n\n        // Get response body for extensions\n        const responseBody = Buffer.from(await res.clone().arrayBuffer());\n\n        // Clear the response so we can modify headers\n        c.res = undefined;\n\n        try {\n          const settleResult = await httpServer.processSettlement(\n            paymentPayload,\n            paymentRequirements,\n            declaredExtensions,\n            { request: context, responseBody },\n          );\n\n          if (!settleResult.success) {\n            // Settlement failed - do not return the protected resource\n            const { response } = settleResult;\n            const body = response.isHtml\n              ? String(response.body ?? \"\")\n              : JSON.stringify(response.body ?? {});\n            res = new Response(body, {\n              status: response.status,\n              headers: response.headers,\n            });\n          } else {\n            // Settlement succeeded - add headers to response\n            Object.entries(settleResult.headers).forEach(([key, value]) => {\n              res.headers.set(key, value);\n            });\n          }\n        } catch (error) {\n          console.error(error);\n          // If settlement fails, return an error response\n          res = c.json({}, 402);\n        }\n\n        // Restore the response (potentially modified with settlement headers)\n        c.res = res;\n        return;\n    }\n  };\n}\n\n/**\n * Hono payment middleware for x402 protocol (direct server instance).\n *\n * Use this when you want to pass a pre-configured x402ResourceServer instance.\n * This provides more flexibility for testing, custom configuration, and reusing\n * server instances across multiple middlewares.\n *\n * @param routes - Route configurations for protected endpoints\n * @param server - Pre-configured x402ResourceServer instance\n * @param paywallConfig - Optional configuration for the built-in paywall UI\n * @param paywall - Optional custom paywall provider (overrides default)\n * @param syncFacilitatorOnStart - Whether to sync with the facilitator on startup (defaults to true)\n * @returns Hono middleware handler\n *\n * @example\n * ```typescript\n * import { paymentMiddleware } from \"@x402/hono\";\n *\n * const server = new x402ResourceServer(myFacilitatorClient)\n *   .register(NETWORK, new ExactEvmScheme());\n *\n * app.use(paymentMiddleware(routes, server, paywallConfig));\n * ```\n */\nexport function paymentMiddleware(\n  routes: RoutesConfig,\n  server: x402ResourceServer,\n  paywallConfig?: PaywallConfig,\n  paywall?: PaywallProvider,\n  syncFacilitatorOnStart: boolean = true,\n): MiddlewareHandler {\n  // Create the x402 HTTP server instance with the resource server\n  const httpServer = new x402HTTPResourceServer(server, routes);\n\n  return paymentMiddlewareFromHTTPServer(\n    httpServer,\n    paywallConfig,\n    paywall,\n    syncFacilitatorOnStart,\n  );\n}\n\n/**\n * Hono payment middleware for x402 protocol (configuration-based).\n *\n * Use this when you want to quickly set up middleware with simple configuration.\n * This function creates and configures the x402ResourceServer internally.\n *\n * @param routes - Route configurations for protected endpoints\n * @param facilitatorClients - Optional facilitator client(s) for payment processing\n * @param schemes - Optional array of scheme registrations for server-side payment processing\n * @param paywallConfig - Optional configuration for the built-in paywall UI\n * @param paywall - Optional custom paywall provider (overrides default)\n * @param syncFacilitatorOnStart - Whether to sync with the facilitator on startup (defaults to true)\n * @returns Hono middleware handler\n *\n * @example\n * ```typescript\n * import { paymentMiddlewareFromConfig } from \"@x402/hono\";\n *\n * app.use(paymentMiddlewareFromConfig(\n *   routes,\n *   myFacilitatorClient,\n *   [{ network: \"eip155:8453\", server: evmSchemeServer }],\n *   paywallConfig\n * ));\n * ```\n */\nexport function paymentMiddlewareFromConfig(\n  routes: RoutesConfig,\n  facilitatorClients?: FacilitatorClient | FacilitatorClient[],\n  schemes?: SchemeRegistration[],\n  paywallConfig?: PaywallConfig,\n  paywall?: PaywallProvider,\n  syncFacilitatorOnStart: boolean = true,\n): MiddlewareHandler {\n  const ResourceServer = new x402ResourceServer(facilitatorClients);\n\n  if (schemes) {\n    schemes.forEach(({ network, server: schemeServer }) => {\n      ResourceServer.register(network, schemeServer);\n    });\n  }\n\n  // Use the direct paymentMiddleware with the configured server\n  // Note: paymentMiddleware handles dynamic bazaar registration\n  return paymentMiddleware(routes, ResourceServer, paywallConfig, paywall, syncFacilitatorOnStart);\n}\n\nexport { x402ResourceServer, x402HTTPResourceServer } from \"@x402/core/server\";\n\nexport type {\n  PaymentRequired,\n  PaymentRequirements,\n  PaymentPayload,\n  Network,\n  SchemeNetworkServer,\n} from \"@x402/core/types\";\n\nexport type { PaywallProvider, PaywallConfig } from \"@x402/core/server\";\n\nexport { RouteConfigurationError } from \"@x402/core/server\";\n\nexport type { RouteValidationError } from \"@x402/core/server\";\n\nexport { HonoAdapter } from \"./adapter\";\n","import { HTTPAdapter } from \"@x402/core/server\";\nimport { Context } from \"hono\";\n\n/**\n * Hono adapter implementation\n */\nexport class HonoAdapter implements HTTPAdapter {\n  /**\n   * Creates a new HonoAdapter instance.\n   *\n   * @param c - The Hono context object\n   */\n  constructor(private c: Context) {}\n\n  /**\n   * Gets a header value from the request.\n   *\n   * @param name - The header name\n   * @returns The header value or undefined\n   */\n  getHeader(name: string): string | undefined {\n    return this.c.req.header(name);\n  }\n\n  /**\n   * Gets the HTTP method of the request.\n   *\n   * @returns The HTTP method\n   */\n  getMethod(): string {\n    return this.c.req.method;\n  }\n\n  /**\n   * Gets the path of the request.\n   *\n   * @returns The request path\n   */\n  getPath(): string {\n    return this.c.req.path;\n  }\n\n  /**\n   * Gets the full URL of the request.\n   *\n   * @returns The full request URL\n   */\n  getUrl(): string {\n    return this.c.req.url;\n  }\n\n  /**\n   * Gets the Accept header from the request.\n   *\n   * @returns The Accept header value or empty string\n   */\n  getAcceptHeader(): string {\n    return this.c.req.header(\"Accept\") || \"\";\n  }\n\n  /**\n   * Gets the User-Agent header from the request.\n   *\n   * @returns The User-Agent header value or empty string\n   */\n  getUserAgent(): string {\n    return this.c.req.header(\"User-Agent\") || \"\";\n  }\n\n  /**\n   * Gets all query parameters from the request URL.\n   *\n   * @returns Record of query parameter key-value pairs\n   */\n  getQueryParams(): Record<string, string | string[]> {\n    const query = this.c.req.query();\n    // Convert single values to match the interface\n    const result: Record<string, string | string[]> = {};\n    for (const [key, value] of Object.entries(query)) {\n      result[key] = value;\n    }\n    return result;\n  }\n\n  /**\n   * Gets a specific query parameter by name.\n   *\n   * @param name - The query parameter name\n   * @returns The query parameter value(s) or undefined\n   */\n  getQueryParam(name: string): string | string[] | undefined {\n    return this.c.req.query(name);\n  }\n\n  /**\n   * Gets the parsed request body.\n   * Requires appropriate body parsing middleware.\n   *\n   * @returns The parsed request body\n   */\n  async getBody(): Promise<unknown> {\n    try {\n      return await this.c.req.json();\n    } catch {\n      return undefined;\n    }\n  }\n}\n"],"mappings":"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","names":["import_server","response"]}

package/dist/esm/index.d.mts

@@ -1,4 +1,4 @@
-import { HTTPAdapter, RoutesConfig, x402ResourceServer, PaywallConfig, PaywallProvider, FacilitatorClient, x402HTTPResourceServer } from '@x402/core/server';
+import { HTTPAdapter, x402HTTPResourceServer, PaywallConfig, PaywallProvider, RoutesConfig, x402ResourceServer, FacilitatorClient } from '@x402/core/server';
 export { PaywallConfig, PaywallProvider, RouteConfigurationError, RouteValidationError, x402HTTPResourceServer, x402ResourceServer } from '@x402/core/server';
 import { Network, SchemeNetworkServer } from '@x402/core/types';
 export { Network, PaymentPayload, PaymentRequired, PaymentRequirements, SchemeNetworkServer } from '@x402/core/types';

package/dist/esm/index.mjs

@@ -174,13 +174,12 @@ function paymentMiddlewareFromHTTPServer(httpServer, paywallConfig, paywall, syn
             { request: context, responseBody }
           );
           if (!settleResult.success) {
-            res = c.json(
-              {
-                error: "Settlement failed",
-                details: settleResult.errorReason
-              },
-              402
-            );
+            const { response: response2 } = settleResult;
+            const body = response2.isHtml ? String(response2.body ?? "") : JSON.stringify(response2.body ?? {});
+            res = new Response(body, {
+              status: response2.status,
+              headers: response2.headers
+            });
           } else {
             Object.entries(settleResult.headers).forEach(([key, value]) => {
               res.headers.set(key, value);
@@ -188,13 +187,7 @@ function paymentMiddlewareFromHTTPServer(httpServer, paywallConfig, paywall, syn
           }
         } catch (error) {
           console.error(error);
-          res = c.json(
-            {
-              error: "Settlement failed",
-              details: error instanceof Error ? error.message : "Unknown error"
-            },
-            402
-          );
+          res = c.json({}, 402);
         }
         c.res = res;
         return;

package/dist/esm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts","../../src/adapter.ts"],"sourcesContent":["import {\n  HTTPRequestContext,\n  PaywallConfig,\n  PaywallProvider,\n  x402HTTPResourceServer,\n  x402ResourceServer,\n  RoutesConfig,\n  FacilitatorClient,\n} from \"@x402/core/server\";\nimport { SchemeNetworkServer, Network } from \"@x402/core/types\";\nimport { Context, MiddlewareHandler } from \"hono\";\nimport { HonoAdapter } from \"./adapter\";\n\n/**\n * Check if any routes in the configuration declare bazaar extensions\n *\n * @param routes - Route configuration\n * @returns True if any route has extensions.bazaar defined\n */\nfunction checkIfBazaarNeeded(routes: RoutesConfig): boolean {\n  // Handle single route config\n  if (\"accepts\" in routes) {\n    return !!(routes.extensions && \"bazaar\" in routes.extensions);\n  }\n\n  // Handle multiple routes\n  return Object.values(routes).some(routeConfig => {\n    return !!(routeConfig.extensions && \"bazaar\" in routeConfig.extensions);\n  });\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:84532', 'solana:mainnet')\n   */\n  network: Network;\n\n  /**\n   * The scheme server implementation for this network\n   */\n  server: SchemeNetworkServer;\n}\n\n/**\n * Hono payment middleware for x402 protocol (direct HTTP server instance).\n *\n * Use this when you need to configure HTTP-level hooks.\n *\n * @param httpServer - Pre-configured x402HTTPResourceServer instance\n * @param paywallConfig - Optional configuration for the built-in paywall UI\n * @param paywall - Optional custom paywall provider (overrides default)\n * @param syncFacilitatorOnStart - Whether to sync with the facilitator on startup (defaults to true)\n * @returns Hono middleware handler\n *\n * @example\n * ```typescript\n * import { paymentMiddlewareFromHTTPServer, x402ResourceServer, x402HTTPResourceServer } from \"@x402/hono\";\n *\n * const resourceServer = new x402ResourceServer(facilitatorClient)\n *   .register(NETWORK, new ExactEvmScheme());\n *\n * const httpServer = new x402HTTPResourceServer(resourceServer, routes)\n *   .onProtectedRequest(requestHook);\n *\n * app.use(paymentMiddlewareFromHTTPServer(httpServer));\n * ```\n */\nexport function paymentMiddlewareFromHTTPServer(\n  httpServer: x402HTTPResourceServer,\n  paywallConfig?: PaywallConfig,\n  paywall?: PaywallProvider,\n  syncFacilitatorOnStart: boolean = true,\n): MiddlewareHandler {\n  // Register custom paywall provider if provided\n  if (paywall) {\n    httpServer.registerPaywallProvider(paywall);\n  }\n\n  // Store initialization promise (not the result)\n  // httpServer.initialize() fetches facilitator support and validates routes\n  let initPromise: Promise<void> | null = syncFacilitatorOnStart ? httpServer.initialize() : null;\n\n  // Dynamically register bazaar extension if routes declare it and not already registered\n  // Skip if pre-registered (e.g., in serverless environments where static imports are used)\n  let bazaarPromise: Promise<void> | null = null;\n  if (checkIfBazaarNeeded(httpServer.routes) && !httpServer.server.hasExtension(\"bazaar\")) {\n    bazaarPromise = import(\"@x402/extensions/bazaar\")\n      .then(({ bazaarResourceServerExtension }) => {\n        httpServer.server.registerExtension(bazaarResourceServerExtension);\n      })\n      .catch(err => {\n        console.error(\"Failed to load bazaar extension:\", err);\n      });\n  }\n\n  return async (c: Context, next: () => Promise<void>) => {\n    // Create adapter and context\n    const adapter = new HonoAdapter(c);\n    const context: HTTPRequestContext = {\n      adapter,\n      path: c.req.path,\n      method: c.req.method,\n      paymentHeader: adapter.getHeader(\"payment-signature\") || adapter.getHeader(\"x-payment\"),\n    };\n\n    // Check if route requires payment before initializing facilitator\n    if (!httpServer.requiresPayment(context)) {\n      return next();\n    }\n\n    // Only initialize when processing a protected route\n    if (initPromise) {\n      await initPromise;\n      initPromise = null; // Clear after first await\n    }\n\n    // Await bazaar extension loading if needed\n    if (bazaarPromise) {\n      await bazaarPromise;\n      bazaarPromise = null;\n    }\n\n    // Process payment requirement check\n    const result = await httpServer.processHTTPRequest(context, paywallConfig);\n\n    // Handle the different result types\n    switch (result.type) {\n      case \"no-payment-required\":\n        // No payment needed, proceed directly to the route handler\n        return next();\n\n      case \"payment-error\":\n        // Payment required but not provided or invalid\n        const { response } = result;\n        Object.entries(response.headers).forEach(([key, value]) => {\n          c.header(key, value);\n        });\n        if (response.isHtml) {\n          return c.html(response.body as string, response.status as 402);\n        } else {\n          return c.json(response.body || {}, response.status as 402);\n        }\n\n      case \"payment-verified\":\n        // Payment is valid, need to wrap response for settlement\n        const { paymentPayload, paymentRequirements, declaredExtensions } = result;\n\n        // Proceed to the next middleware or route handler\n        await next();\n\n        // Get the current response\n        let res = c.res;\n\n        // If the response from the protected route is >= 400, do not settle payment\n        if (res.status >= 400) {\n          return;\n        }\n\n        // Get response body for extensions\n        const responseBody = Buffer.from(await res.clone().arrayBuffer());\n\n        // Clear the response so we can modify headers\n        c.res = undefined;\n\n        try {\n          const settleResult = await httpServer.processSettlement(\n            paymentPayload,\n            paymentRequirements,\n            declaredExtensions,\n            { request: context, responseBody },\n          );\n\n          if (!settleResult.success) {\n            // Settlement failed - do not return the protected resource\n            res = c.json(\n              {\n                error: \"Settlement failed\",\n                details: settleResult.errorReason,\n              },\n              402,\n            );\n          } else {\n            // Settlement succeeded - add headers to response\n            Object.entries(settleResult.headers).forEach(([key, value]) => {\n              res.headers.set(key, value);\n            });\n          }\n        } catch (error) {\n          console.error(error);\n          // If settlement fails, return an error response\n          res = c.json(\n            {\n              error: \"Settlement failed\",\n              details: error instanceof Error ? error.message : \"Unknown error\",\n            },\n            402,\n          );\n        }\n\n        // Restore the response (potentially modified with settlement headers)\n        c.res = res;\n        return;\n    }\n  };\n}\n\n/**\n * Hono payment middleware for x402 protocol (direct server instance).\n *\n * Use this when you want to pass a pre-configured x402ResourceServer instance.\n * This provides more flexibility for testing, custom configuration, and reusing\n * server instances across multiple middlewares.\n *\n * @param routes - Route configurations for protected endpoints\n * @param server - Pre-configured x402ResourceServer instance\n * @param paywallConfig - Optional configuration for the built-in paywall UI\n * @param paywall - Optional custom paywall provider (overrides default)\n * @param syncFacilitatorOnStart - Whether to sync with the facilitator on startup (defaults to true)\n * @returns Hono middleware handler\n *\n * @example\n * ```typescript\n * import { paymentMiddleware } from \"@x402/hono\";\n *\n * const server = new x402ResourceServer(myFacilitatorClient)\n *   .register(NETWORK, new ExactEvmScheme());\n *\n * app.use(paymentMiddleware(routes, server, paywallConfig));\n * ```\n */\nexport function paymentMiddleware(\n  routes: RoutesConfig,\n  server: x402ResourceServer,\n  paywallConfig?: PaywallConfig,\n  paywall?: PaywallProvider,\n  syncFacilitatorOnStart: boolean = true,\n): MiddlewareHandler {\n  // Create the x402 HTTP server instance with the resource server\n  const httpServer = new x402HTTPResourceServer(server, routes);\n\n  return paymentMiddlewareFromHTTPServer(\n    httpServer,\n    paywallConfig,\n    paywall,\n    syncFacilitatorOnStart,\n  );\n}\n\n/**\n * Hono payment middleware for x402 protocol (configuration-based).\n *\n * Use this when you want to quickly set up middleware with simple configuration.\n * This function creates and configures the x402ResourceServer internally.\n *\n * @param routes - Route configurations for protected endpoints\n * @param facilitatorClients - Optional facilitator client(s) for payment processing\n * @param schemes - Optional array of scheme registrations for server-side payment processing\n * @param paywallConfig - Optional configuration for the built-in paywall UI\n * @param paywall - Optional custom paywall provider (overrides default)\n * @param syncFacilitatorOnStart - Whether to sync with the facilitator on startup (defaults to true)\n * @returns Hono middleware handler\n *\n * @example\n * ```typescript\n * import { paymentMiddlewareFromConfig } from \"@x402/hono\";\n *\n * app.use(paymentMiddlewareFromConfig(\n *   routes,\n *   myFacilitatorClient,\n *   [{ network: \"eip155:8453\", server: evmSchemeServer }],\n *   paywallConfig\n * ));\n * ```\n */\nexport function paymentMiddlewareFromConfig(\n  routes: RoutesConfig,\n  facilitatorClients?: FacilitatorClient | FacilitatorClient[],\n  schemes?: SchemeRegistration[],\n  paywallConfig?: PaywallConfig,\n  paywall?: PaywallProvider,\n  syncFacilitatorOnStart: boolean = true,\n): MiddlewareHandler {\n  const ResourceServer = new x402ResourceServer(facilitatorClients);\n\n  if (schemes) {\n    schemes.forEach(({ network, server: schemeServer }) => {\n      ResourceServer.register(network, schemeServer);\n    });\n  }\n\n  // Use the direct paymentMiddleware with the configured server\n  // Note: paymentMiddleware handles dynamic bazaar registration\n  return paymentMiddleware(routes, ResourceServer, paywallConfig, paywall, syncFacilitatorOnStart);\n}\n\nexport { x402ResourceServer, x402HTTPResourceServer } from \"@x402/core/server\";\n\nexport type {\n  PaymentRequired,\n  PaymentRequirements,\n  PaymentPayload,\n  Network,\n  SchemeNetworkServer,\n} from \"@x402/core/types\";\n\nexport type { PaywallProvider, PaywallConfig } from \"@x402/core/server\";\n\nexport { RouteConfigurationError } from \"@x402/core/server\";\n\nexport type { RouteValidationError } from \"@x402/core/server\";\n\nexport { HonoAdapter } from \"./adapter\";\n","import { HTTPAdapter } from \"@x402/core/server\";\nimport { Context } from \"hono\";\n\n/**\n * Hono adapter implementation\n */\nexport class HonoAdapter implements HTTPAdapter {\n  /**\n   * Creates a new HonoAdapter instance.\n   *\n   * @param c - The Hono context object\n   */\n  constructor(private c: Context) {}\n\n  /**\n   * Gets a header value from the request.\n   *\n   * @param name - The header name\n   * @returns The header value or undefined\n   */\n  getHeader(name: string): string | undefined {\n    return this.c.req.header(name);\n  }\n\n  /**\n   * Gets the HTTP method of the request.\n   *\n   * @returns The HTTP method\n   */\n  getMethod(): string {\n    return this.c.req.method;\n  }\n\n  /**\n   * Gets the path of the request.\n   *\n   * @returns The request path\n   */\n  getPath(): string {\n    return this.c.req.path;\n  }\n\n  /**\n   * Gets the full URL of the request.\n   *\n   * @returns The full request URL\n   */\n  getUrl(): string {\n    return this.c.req.url;\n  }\n\n  /**\n   * Gets the Accept header from the request.\n   *\n   * @returns The Accept header value or empty string\n   */\n  getAcceptHeader(): string {\n    return this.c.req.header(\"Accept\") || \"\";\n  }\n\n  /**\n   * Gets the User-Agent header from the request.\n   *\n   * @returns The User-Agent header value or empty string\n   */\n  getUserAgent(): string {\n    return this.c.req.header(\"User-Agent\") || \"\";\n  }\n\n  /**\n   * Gets all query parameters from the request URL.\n   *\n   * @returns Record of query parameter key-value pairs\n   */\n  getQueryParams(): Record<string, string | string[]> {\n    const query = this.c.req.query();\n    // Convert single values to match the interface\n    const result: Record<string, string | string[]> = {};\n    for (const [key, value] of Object.entries(query)) {\n      result[key] = value;\n    }\n    return result;\n  }\n\n  /**\n   * Gets a specific query parameter by name.\n   *\n   * @param name - The query parameter name\n   * @returns The query parameter value(s) or undefined\n   */\n  getQueryParam(name: string): string | string[] | undefined {\n    return this.c.req.query(name);\n  }\n\n  /**\n   * Gets the parsed request body.\n   * Requires appropriate body parsing middleware.\n   *\n   * @returns The parsed request body\n   */\n  async getBody(): Promise<unknown> {\n    try {\n      return await this.c.req.json();\n    } catch {\n      return undefined;\n    }\n  }\n}\n"],"mappings":"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","names":["x402ResourceServer","x402HTTPResourceServer"]}
+{"version":3,"sources":["../../src/index.ts","../../src/adapter.ts"],"sourcesContent":["import {\n  HTTPRequestContext,\n  PaywallConfig,\n  PaywallProvider,\n  x402HTTPResourceServer,\n  x402ResourceServer,\n  RoutesConfig,\n  FacilitatorClient,\n} from \"@x402/core/server\";\nimport { SchemeNetworkServer, Network } from \"@x402/core/types\";\nimport { Context, MiddlewareHandler } from \"hono\";\nimport { HonoAdapter } from \"./adapter\";\n\n/**\n * Check if any routes in the configuration declare bazaar extensions\n *\n * @param routes - Route configuration\n * @returns True if any route has extensions.bazaar defined\n */\nfunction checkIfBazaarNeeded(routes: RoutesConfig): boolean {\n  // Handle single route config\n  if (\"accepts\" in routes) {\n    return !!(routes.extensions && \"bazaar\" in routes.extensions);\n  }\n\n  // Handle multiple routes\n  return Object.values(routes).some(routeConfig => {\n    return !!(routeConfig.extensions && \"bazaar\" in routeConfig.extensions);\n  });\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:84532', 'solana:mainnet')\n   */\n  network: Network;\n\n  /**\n   * The scheme server implementation for this network\n   */\n  server: SchemeNetworkServer;\n}\n\n/**\n * Hono payment middleware for x402 protocol (direct HTTP server instance).\n *\n * Use this when you need to configure HTTP-level hooks.\n *\n * @param httpServer - Pre-configured x402HTTPResourceServer instance\n * @param paywallConfig - Optional configuration for the built-in paywall UI\n * @param paywall - Optional custom paywall provider (overrides default)\n * @param syncFacilitatorOnStart - Whether to sync with the facilitator on startup (defaults to true)\n * @returns Hono middleware handler\n *\n * @example\n * ```typescript\n * import { paymentMiddlewareFromHTTPServer, x402ResourceServer, x402HTTPResourceServer } from \"@x402/hono\";\n *\n * const resourceServer = new x402ResourceServer(facilitatorClient)\n *   .register(NETWORK, new ExactEvmScheme());\n *\n * const httpServer = new x402HTTPResourceServer(resourceServer, routes)\n *   .onProtectedRequest(requestHook);\n *\n * app.use(paymentMiddlewareFromHTTPServer(httpServer));\n * ```\n */\nexport function paymentMiddlewareFromHTTPServer(\n  httpServer: x402HTTPResourceServer,\n  paywallConfig?: PaywallConfig,\n  paywall?: PaywallProvider,\n  syncFacilitatorOnStart: boolean = true,\n): MiddlewareHandler {\n  // Register custom paywall provider if provided\n  if (paywall) {\n    httpServer.registerPaywallProvider(paywall);\n  }\n\n  // Store initialization promise (not the result)\n  // httpServer.initialize() fetches facilitator support and validates routes\n  let initPromise: Promise<void> | null = syncFacilitatorOnStart ? httpServer.initialize() : null;\n\n  // Dynamically register bazaar extension if routes declare it and not already registered\n  // Skip if pre-registered (e.g., in serverless environments where static imports are used)\n  let bazaarPromise: Promise<void> | null = null;\n  if (checkIfBazaarNeeded(httpServer.routes) && !httpServer.server.hasExtension(\"bazaar\")) {\n    bazaarPromise = import(\"@x402/extensions/bazaar\")\n      .then(({ bazaarResourceServerExtension }) => {\n        httpServer.server.registerExtension(bazaarResourceServerExtension);\n      })\n      .catch(err => {\n        console.error(\"Failed to load bazaar extension:\", err);\n      });\n  }\n\n  return async (c: Context, next: () => Promise<void>) => {\n    // Create adapter and context\n    const adapter = new HonoAdapter(c);\n    const context: HTTPRequestContext = {\n      adapter,\n      path: c.req.path,\n      method: c.req.method,\n      paymentHeader: adapter.getHeader(\"payment-signature\") || adapter.getHeader(\"x-payment\"),\n    };\n\n    // Check if route requires payment before initializing facilitator\n    if (!httpServer.requiresPayment(context)) {\n      return next();\n    }\n\n    // Only initialize when processing a protected route\n    if (initPromise) {\n      await initPromise;\n      initPromise = null; // Clear after first await\n    }\n\n    // Await bazaar extension loading if needed\n    if (bazaarPromise) {\n      await bazaarPromise;\n      bazaarPromise = null;\n    }\n\n    // Process payment requirement check\n    const result = await httpServer.processHTTPRequest(context, paywallConfig);\n\n    // Handle the different result types\n    switch (result.type) {\n      case \"no-payment-required\":\n        // No payment needed, proceed directly to the route handler\n        return next();\n\n      case \"payment-error\":\n        // Payment required but not provided or invalid\n        const { response } = result;\n        Object.entries(response.headers).forEach(([key, value]) => {\n          c.header(key, value);\n        });\n        if (response.isHtml) {\n          return c.html(response.body as string, response.status as 402);\n        } else {\n          return c.json(response.body || {}, response.status as 402);\n        }\n\n      case \"payment-verified\":\n        // Payment is valid, need to wrap response for settlement\n        const { paymentPayload, paymentRequirements, declaredExtensions } = result;\n\n        // Proceed to the next middleware or route handler\n        await next();\n\n        // Get the current response\n        let res = c.res;\n\n        // If the response from the protected route is >= 400, do not settle payment\n        if (res.status >= 400) {\n          return;\n        }\n\n        // Get response body for extensions\n        const responseBody = Buffer.from(await res.clone().arrayBuffer());\n\n        // Clear the response so we can modify headers\n        c.res = undefined;\n\n        try {\n          const settleResult = await httpServer.processSettlement(\n            paymentPayload,\n            paymentRequirements,\n            declaredExtensions,\n            { request: context, responseBody },\n          );\n\n          if (!settleResult.success) {\n            // Settlement failed - do not return the protected resource\n            const { response } = settleResult;\n            const body = response.isHtml\n              ? String(response.body ?? \"\")\n              : JSON.stringify(response.body ?? {});\n            res = new Response(body, {\n              status: response.status,\n              headers: response.headers,\n            });\n          } else {\n            // Settlement succeeded - add headers to response\n            Object.entries(settleResult.headers).forEach(([key, value]) => {\n              res.headers.set(key, value);\n            });\n          }\n        } catch (error) {\n          console.error(error);\n          // If settlement fails, return an error response\n          res = c.json({}, 402);\n        }\n\n        // Restore the response (potentially modified with settlement headers)\n        c.res = res;\n        return;\n    }\n  };\n}\n\n/**\n * Hono payment middleware for x402 protocol (direct server instance).\n *\n * Use this when you want to pass a pre-configured x402ResourceServer instance.\n * This provides more flexibility for testing, custom configuration, and reusing\n * server instances across multiple middlewares.\n *\n * @param routes - Route configurations for protected endpoints\n * @param server - Pre-configured x402ResourceServer instance\n * @param paywallConfig - Optional configuration for the built-in paywall UI\n * @param paywall - Optional custom paywall provider (overrides default)\n * @param syncFacilitatorOnStart - Whether to sync with the facilitator on startup (defaults to true)\n * @returns Hono middleware handler\n *\n * @example\n * ```typescript\n * import { paymentMiddleware } from \"@x402/hono\";\n *\n * const server = new x402ResourceServer(myFacilitatorClient)\n *   .register(NETWORK, new ExactEvmScheme());\n *\n * app.use(paymentMiddleware(routes, server, paywallConfig));\n * ```\n */\nexport function paymentMiddleware(\n  routes: RoutesConfig,\n  server: x402ResourceServer,\n  paywallConfig?: PaywallConfig,\n  paywall?: PaywallProvider,\n  syncFacilitatorOnStart: boolean = true,\n): MiddlewareHandler {\n  // Create the x402 HTTP server instance with the resource server\n  const httpServer = new x402HTTPResourceServer(server, routes);\n\n  return paymentMiddlewareFromHTTPServer(\n    httpServer,\n    paywallConfig,\n    paywall,\n    syncFacilitatorOnStart,\n  );\n}\n\n/**\n * Hono payment middleware for x402 protocol (configuration-based).\n *\n * Use this when you want to quickly set up middleware with simple configuration.\n * This function creates and configures the x402ResourceServer internally.\n *\n * @param routes - Route configurations for protected endpoints\n * @param facilitatorClients - Optional facilitator client(s) for payment processing\n * @param schemes - Optional array of scheme registrations for server-side payment processing\n * @param paywallConfig - Optional configuration for the built-in paywall UI\n * @param paywall - Optional custom paywall provider (overrides default)\n * @param syncFacilitatorOnStart - Whether to sync with the facilitator on startup (defaults to true)\n * @returns Hono middleware handler\n *\n * @example\n * ```typescript\n * import { paymentMiddlewareFromConfig } from \"@x402/hono\";\n *\n * app.use(paymentMiddlewareFromConfig(\n *   routes,\n *   myFacilitatorClient,\n *   [{ network: \"eip155:8453\", server: evmSchemeServer }],\n *   paywallConfig\n * ));\n * ```\n */\nexport function paymentMiddlewareFromConfig(\n  routes: RoutesConfig,\n  facilitatorClients?: FacilitatorClient | FacilitatorClient[],\n  schemes?: SchemeRegistration[],\n  paywallConfig?: PaywallConfig,\n  paywall?: PaywallProvider,\n  syncFacilitatorOnStart: boolean = true,\n): MiddlewareHandler {\n  const ResourceServer = new x402ResourceServer(facilitatorClients);\n\n  if (schemes) {\n    schemes.forEach(({ network, server: schemeServer }) => {\n      ResourceServer.register(network, schemeServer);\n    });\n  }\n\n  // Use the direct paymentMiddleware with the configured server\n  // Note: paymentMiddleware handles dynamic bazaar registration\n  return paymentMiddleware(routes, ResourceServer, paywallConfig, paywall, syncFacilitatorOnStart);\n}\n\nexport { x402ResourceServer, x402HTTPResourceServer } from \"@x402/core/server\";\n\nexport type {\n  PaymentRequired,\n  PaymentRequirements,\n  PaymentPayload,\n  Network,\n  SchemeNetworkServer,\n} from \"@x402/core/types\";\n\nexport type { PaywallProvider, PaywallConfig } from \"@x402/core/server\";\n\nexport { RouteConfigurationError } from \"@x402/core/server\";\n\nexport type { RouteValidationError } from \"@x402/core/server\";\n\nexport { HonoAdapter } from \"./adapter\";\n","import { HTTPAdapter } from \"@x402/core/server\";\nimport { Context } from \"hono\";\n\n/**\n * Hono adapter implementation\n */\nexport class HonoAdapter implements HTTPAdapter {\n  /**\n   * Creates a new HonoAdapter instance.\n   *\n   * @param c - The Hono context object\n   */\n  constructor(private c: Context) {}\n\n  /**\n   * Gets a header value from the request.\n   *\n   * @param name - The header name\n   * @returns The header value or undefined\n   */\n  getHeader(name: string): string | undefined {\n    return this.c.req.header(name);\n  }\n\n  /**\n   * Gets the HTTP method of the request.\n   *\n   * @returns The HTTP method\n   */\n  getMethod(): string {\n    return this.c.req.method;\n  }\n\n  /**\n   * Gets the path of the request.\n   *\n   * @returns The request path\n   */\n  getPath(): string {\n    return this.c.req.path;\n  }\n\n  /**\n   * Gets the full URL of the request.\n   *\n   * @returns The full request URL\n   */\n  getUrl(): string {\n    return this.c.req.url;\n  }\n\n  /**\n   * Gets the Accept header from the request.\n   *\n   * @returns The Accept header value or empty string\n   */\n  getAcceptHeader(): string {\n    return this.c.req.header(\"Accept\") || \"\";\n  }\n\n  /**\n   * Gets the User-Agent header from the request.\n   *\n   * @returns The User-Agent header value or empty string\n   */\n  getUserAgent(): string {\n    return this.c.req.header(\"User-Agent\") || \"\";\n  }\n\n  /**\n   * Gets all query parameters from the request URL.\n   *\n   * @returns Record of query parameter key-value pairs\n   */\n  getQueryParams(): Record<string, string | string[]> {\n    const query = this.c.req.query();\n    // Convert single values to match the interface\n    const result: Record<string, string | string[]> = {};\n    for (const [key, value] of Object.entries(query)) {\n      result[key] = value;\n    }\n    return result;\n  }\n\n  /**\n   * Gets a specific query parameter by name.\n   *\n   * @param name - The query parameter name\n   * @returns The query parameter value(s) or undefined\n   */\n  getQueryParam(name: string): string | string[] | undefined {\n    return this.c.req.query(name);\n  }\n\n  /**\n   * Gets the parsed request body.\n   * Requires appropriate body parsing middleware.\n   *\n   * @returns The parsed request body\n   */\n  async getBody(): Promise<unknown> {\n    try {\n      return await this.c.req.json();\n    } catch {\n      return undefined;\n    }\n  }\n}\n"],"mappings":"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","names":["x402ResourceServer","x402HTTPResourceServer","response"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x402/hono",
-  "version": "2.5.0",
+  "version": "2.7.0",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
   "types": "./dist/index.d.ts",
@@ -29,12 +29,12 @@
   },
   "dependencies": {
     "zod": "^3.24.2",
-    "@x402/core": "~2.5.0",
-    "@x402/extensions": "~2.5.0"
+    "@x402/extensions": "~2.7.0",
+    "@x402/core": "~2.7.0"
   },
   "peerDependencies": {
     "hono": "^4.0.0",
-    "@x402/paywall": "2.5.0"
+    "@x402/paywall": "^2.7.0"
   },
   "peerDependenciesMeta": {
     "@x402/paywall": {