npm - @x402/hono - Versions diffs - 2.7.0 → 2.8.0 - Mend

@x402/hono 2.7.0 → 2.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/dist/cjs/index.js CHANGED Viewed

@@ -148,11 +148,30 @@ function checkIfBazaarNeeded(routes) {
     return !!(routeConfig.extensions && "bazaar" in routeConfig.extensions);
   });
 }
+function facilitatorErrorResponse(c, error) {
+  return c.json({ error: error.message }, 502);
+}
 function paymentMiddlewareFromHTTPServer(httpServer, paywallConfig, paywall, syncFacilitatorOnStart = true) {
   if (paywall) {
     httpServer.registerPaywallProvider(paywall);
   }
   let initPromise = syncFacilitatorOnStart ? httpServer.initialize() : null;
+  let isInitialized = false;
+  async function initializeHttpServer() {
+    if (!syncFacilitatorOnStart || isInitialized) {
+      return;
+    }
+    if (!initPromise) {
+      initPromise = httpServer.initialize();
+    }
+    try {
+      await initPromise;
+      isInitialized = true;
+    } catch (error) {
+      initPromise = null;
+      throw error;
+    }
+  }
   let bazaarPromise = null;
   if (checkIfBazaarNeeded(httpServer.routes) && !httpServer.server.hasExtension("bazaar")) {
     bazaarPromise = import("@x402/extensions/bazaar").then(({ bazaarResourceServerExtension }) => {
@@ -172,15 +191,30 @@ function paymentMiddlewareFromHTTPServer(httpServer, paywallConfig, paywall, syn
     if (!httpServer.requiresPayment(context)) {
       return next();
     }
-    if (initPromise) {
-      await initPromise;
-      initPromise = null;
+    if (syncFacilitatorOnStart && !isInitialized) {
+      try {
+        await initializeHttpServer();
+      } catch (error) {
+        const facilitatorError = (0, import_server.getFacilitatorResponseError)(error);
+        if (facilitatorError) {
+          return facilitatorErrorResponse(c, facilitatorError);
+        }
+        throw error;
+      }
     }
     if (bazaarPromise) {
       await bazaarPromise;
       bazaarPromise = null;
     }
-    const result = await httpServer.processHTTPRequest(context, paywallConfig);
+    let result;
+    try {
+      result = await httpServer.processHTTPRequest(context, paywallConfig);
+    } catch (error) {
+      if (error instanceof import_server.FacilitatorResponseError) {
+        return facilitatorErrorResponse(c, error);
+      }
+      throw error;
+    }
     switch (result.type) {
       case "no-payment-required":
         return next();
@@ -223,6 +257,11 @@ function paymentMiddlewareFromHTTPServer(httpServer, paywallConfig, paywall, syn
             });
           }
         } catch (error) {
+          if (error instanceof import_server.FacilitatorResponseError) {
+            res = facilitatorErrorResponse(c, error);
+            c.res = res;
+            return;
+          }
           console.error(error);
           res = c.json({}, 402);
         }

package/dist/cjs/index.js.map CHANGED Viewed

	@@ -1 +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 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"]}
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 FacilitatorResponseError,\n getFacilitatorResponseError,\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 Builds a normalized 502 response for facilitator boundary failures.\n \n @param c - The current Hono context\n * @param error - The facilitator response error to surface\n * @returns A JSON 502 response\n /\nfunction facilitatorErrorResponse(c: Context, error: FacilitatorResponseError): Response {\n return c.json({ error: error.message }, 502);\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 let isInitialized = false;\n\n /\n Ensures facilitator initialization succeeds once, while allowing retries after failures.\n /\n async function initializeHttpServer(): Promise<void> {\n if (!syncFacilitatorOnStart \|\| isInitialized) {\n return;\n }\n\n if (!initPromise) {\n initPromise = httpServer.initialize();\n }\n\n try {\n await initPromise;\n isInitialized = true;\n } catch (error) {\n initPromise = null;\n throw error;\n }\n }\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 (syncFacilitatorOnStart && !isInitialized) {\n try {\n await initializeHttpServer();\n } catch (error) {\n const facilitatorError = getFacilitatorResponseError(error);\n if (facilitatorError) {\n return facilitatorErrorResponse(c, facilitatorError);\n }\n throw error;\n }\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 let result: Awaited<ReturnType<x402HTTPResourceServer[\"processHTTPRequest\"]>>;\n try {\n result = await httpServer.processHTTPRequest(context, paywallConfig);\n } catch (error) {\n if (error instanceof FacilitatorResponseError) {\n return facilitatorErrorResponse(c, error);\n }\n throw error;\n }\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 if (error instanceof FacilitatorResponseError) {\n res = facilitatorErrorResponse(c, error);\n c.res = res;\n return;\n }\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.mjs CHANGED Viewed

@@ -1,7 +1,9 @@
 // src/index.ts
 import {
   x402HTTPResourceServer,
-  x402ResourceServer
+  x402ResourceServer,
+  FacilitatorResponseError,
+  getFacilitatorResponseError
 } from "@x402/core/server";
 // src/adapter.ts
@@ -111,11 +113,30 @@ function checkIfBazaarNeeded(routes) {
     return !!(routeConfig.extensions && "bazaar" in routeConfig.extensions);
   });
 }
+function facilitatorErrorResponse(c, error) {
+  return c.json({ error: error.message }, 502);
+}
 function paymentMiddlewareFromHTTPServer(httpServer, paywallConfig, paywall, syncFacilitatorOnStart = true) {
   if (paywall) {
     httpServer.registerPaywallProvider(paywall);
   }
   let initPromise = syncFacilitatorOnStart ? httpServer.initialize() : null;
+  let isInitialized = false;
+  async function initializeHttpServer() {
+    if (!syncFacilitatorOnStart || isInitialized) {
+      return;
+    }
+    if (!initPromise) {
+      initPromise = httpServer.initialize();
+    }
+    try {
+      await initPromise;
+      isInitialized = true;
+    } catch (error) {
+      initPromise = null;
+      throw error;
+    }
+  }
   let bazaarPromise = null;
   if (checkIfBazaarNeeded(httpServer.routes) && !httpServer.server.hasExtension("bazaar")) {
     bazaarPromise = import("@x402/extensions/bazaar").then(({ bazaarResourceServerExtension }) => {
@@ -135,15 +156,30 @@ function paymentMiddlewareFromHTTPServer(httpServer, paywallConfig, paywall, syn
     if (!httpServer.requiresPayment(context)) {
       return next();
     }
-    if (initPromise) {
-      await initPromise;
-      initPromise = null;
+    if (syncFacilitatorOnStart && !isInitialized) {
+      try {
+        await initializeHttpServer();
+      } catch (error) {
+        const facilitatorError = getFacilitatorResponseError(error);
+        if (facilitatorError) {
+          return facilitatorErrorResponse(c, facilitatorError);
+        }
+        throw error;
+      }
     }
     if (bazaarPromise) {
       await bazaarPromise;
       bazaarPromise = null;
     }
-    const result = await httpServer.processHTTPRequest(context, paywallConfig);
+    let result;
+    try {
+      result = await httpServer.processHTTPRequest(context, paywallConfig);
+    } catch (error) {
+      if (error instanceof FacilitatorResponseError) {
+        return facilitatorErrorResponse(c, error);
+      }
+      throw error;
+    }
     switch (result.type) {
       case "no-payment-required":
         return next();
@@ -186,6 +222,11 @@ function paymentMiddlewareFromHTTPServer(httpServer, paywallConfig, paywall, syn
             });
           }
         } catch (error) {
+          if (error instanceof FacilitatorResponseError) {
+            res = facilitatorErrorResponse(c, error);
+            c.res = res;
+            return;
+          }
           console.error(error);
           res = c.json({}, 402);
         }

package/dist/esm/index.mjs.map CHANGED Viewed

	@@ -1 +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 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"]}
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 FacilitatorResponseError,\n getFacilitatorResponseError,\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 Builds a normalized 502 response for facilitator boundary failures.\n \n @param c - The current Hono context\n * @param error - The facilitator response error to surface\n * @returns A JSON 502 response\n /\nfunction facilitatorErrorResponse(c: Context, error: FacilitatorResponseError): Response {\n return c.json({ error: error.message }, 502);\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 let isInitialized = false;\n\n /\n Ensures facilitator initialization succeeds once, while allowing retries after failures.\n /\n async function initializeHttpServer(): Promise<void> {\n if (!syncFacilitatorOnStart \|\| isInitialized) {\n return;\n }\n\n if (!initPromise) {\n initPromise = httpServer.initialize();\n }\n\n try {\n await initPromise;\n isInitialized = true;\n } catch (error) {\n initPromise = null;\n throw error;\n }\n }\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 (syncFacilitatorOnStart && !isInitialized) {\n try {\n await initializeHttpServer();\n } catch (error) {\n const facilitatorError = getFacilitatorResponseError(error);\n if (facilitatorError) {\n return facilitatorErrorResponse(c, facilitatorError);\n }\n throw error;\n }\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 let result: Awaited<ReturnType<x402HTTPResourceServer[\"processHTTPRequest\"]>>;\n try {\n result = await httpServer.processHTTPRequest(context, paywallConfig);\n } catch (error) {\n if (error instanceof FacilitatorResponseError) {\n return facilitatorErrorResponse(c, error);\n }\n throw error;\n }\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 if (error instanceof FacilitatorResponseError) {\n res = facilitatorErrorResponse(c, error);\n c.res = res;\n return;\n }\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 CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@x402/hono",
-  "version": "2.7.0",
+  "version": "2.8.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/extensions": "~2.7.0",
-    "@x402/core": "~2.7.0"
+    "@x402/core": "~2.8.0",
+    "@x402/extensions": "~2.8.0"
   },
   "peerDependencies": {
     "hono": "^4.0.0",
-    "@x402/paywall": "^2.7.0"
+    "@x402/paywall": "^2.8.0"
   },
   "peerDependenciesMeta": {
     "@x402/paywall": {