@x402/express 0.0.1 → 2.1.0

package/README.md

@@ -1 +1,281 @@
 # @x402/express
+
+Express middleware integration for the x402 Payment Protocol. This package provides a simple middleware function for adding x402 payment requirements to your Express.js applications.
+
+## Installation
+
+```bash
+pnpm install @x402/express
+```
+
+## Quick Start
+
+```typescript
+import express from "express";
+import { paymentMiddleware, x402ResourceServer } from "@x402/express";
+import { ExactEvmScheme } from "@x402/evm/exact/server";
+import { HTTPFacilitatorClient } from "@x402/core/server";
+
+const app = express();
+
+const facilitatorClient = new HTTPFacilitatorClient({ url: "https://facilitator.x402.org" });
+const resourceServer = new x402ResourceServer(facilitatorClient)
+  .register("eip155:84532", new ExactEvmScheme());
+
+// Apply the payment middleware with your configuration
+app.use(
+  paymentMiddleware(
+    {
+      "GET /protected-route": {
+        accepts: {
+          scheme: "exact",
+          price: "$0.10",
+          network: "eip155:84532",
+          payTo: "0xYourAddress",
+        },
+        description: "Access to premium content",
+      },
+    },
+    resourceServer,
+  ),
+);
+
+// Implement your protected route
+app.get("/protected-route", (req, res) => {
+  res.json({ message: "This content is behind a paywall" });
+});
+
+app.listen(3000);
+```
+
+## Configuration
+
+The `paymentMiddleware` function accepts the following parameters:
+
+```typescript
+paymentMiddleware(
+  routes: RoutesConfig,
+  server: x402ResourceServer,
+  paywallConfig?: PaywallConfig,
+  paywall?: PaywallProvider,
+  syncFacilitatorOnStart?: boolean
+)
+```
+
+### Parameters
+
+1. **`routes`** (required): Route configurations for protected endpoints
+2. **`server`** (required): Pre-configured x402ResourceServer instance
+3. **`paywallConfig`** (optional): Configuration for the built-in paywall UI
+4. **`paywall`** (optional): Custom paywall provider
+5. **`syncFacilitatorOnStart`** (optional): Whether to sync with facilitator on startup (defaults to true)
+
+See the sections below for detailed configuration options.
+
+## API Reference
+
+### ExpressAdapter
+
+The `ExpressAdapter` class implements the `HTTPAdapter` interface from `@x402/core`, providing Express-specific request handling:
+
+```typescript
+class ExpressAdapter implements HTTPAdapter {
+  getHeader(name: string): string | undefined;
+  getMethod(): string;
+  getPath(): string;
+  getUrl(): string;
+  getAcceptHeader(): string;
+  getUserAgent(): string;
+}
+```
+
+### Middleware Function
+
+```typescript
+function paymentMiddleware(
+  routes: RoutesConfig,
+  server: x402ResourceServer,
+  paywallConfig?: PaywallConfig,
+  paywall?: PaywallProvider,
+  syncFacilitatorOnStart?: boolean,
+): (req: Request, res: Response, next: NextFunction) => Promise<void>;
+```
+
+Creates Express middleware that:
+
+1. Uses the provided x402ResourceServer for payment processing
+2. Checks if the incoming request matches a protected route
+3. Validates payment headers if required
+4. Returns payment instructions (402 status) if payment is missing or invalid
+5. Processes the request if payment is valid
+6. Handles settlement after successful response
+
+### Route Configuration
+
+Routes are passed as the first parameter to `paymentMiddleware`:
+
+```typescript
+const routes: RoutesConfig = {
+  "GET /api/protected": {
+    accepts: {
+      scheme: "exact",
+      price: "$0.10",
+      network: "eip155:84532",
+      payTo: "0xYourAddress",
+      maxTimeoutSeconds: 60,
+    },
+    description: "Premium API access",
+  },
+};
+
+app.use(paymentMiddleware(routes, resourceServer));
+```
+
+### Paywall Configuration
+
+The middleware automatically displays a paywall UI when browsers request protected endpoints.
+
+**Option 1: Full Paywall UI (Recommended)**
+
+Install the optional `@x402/paywall` package for a complete wallet connection and payment UI:
+
+```bash
+pnpm add @x402/paywall
+```
+
+Then configure it:
+
+```typescript
+const paywallConfig: PaywallConfig = {
+  appName: "Your App Name",
+  appLogo: "/path/to/logo.svg",
+  testnet: true,
+};
+
+app.use(paymentMiddleware(routes, resourceServer, paywallConfig));
+```
+
+The paywall includes:
+
+- EVM wallet support (MetaMask, Coinbase Wallet, etc.)
+- Solana wallet support (Phantom, Solflare, etc.)
+- USDC balance checking
+- Chain switching
+- Onramp integration for mainnet
+
+**Option 2: Basic Paywall (No Installation)**
+
+Without `@x402/paywall` installed, the middleware returns a basic HTML page with payment instructions. This works but doesn't include wallet connections.
+
+**Option 3: Custom Paywall Provider**
+
+Provide your own paywall provider:
+
+```typescript
+app.use(paymentMiddleware(routes, resourceServer, paywallConfig, customPaywallProvider));
+```
+
+This allows full customization of the paywall UI.
+
+**For advanced configuration** (builder pattern, network-specific bundles, custom handlers), see the [@x402/paywall README](../paywall/README.md).
+
+## Advanced Usage
+
+### Multiple Protected Routes
+
+```typescript
+app.use(
+  paymentMiddleware(
+    {
+      "GET /api/premium/*": {
+        accepts: {
+          scheme: "exact",
+          price: "$1.00",
+          network: "eip155:8453",
+          payTo: "0xYourAddress",
+        },
+        description: "Premium API access",
+      },
+      "GET /api/data": {
+        accepts: {
+          scheme: "exact",
+          price: "$0.50",
+          network: "eip155:84532",
+          payTo: "0xYourAddress",
+          maxTimeoutSeconds: 120,
+        },
+        description: "Data endpoint access",
+      },
+    },
+    resourceServer,
+  ),
+);
+```
+
+### Custom Facilitator Client
+
+If you need to use a custom facilitator server, configure it when creating the x402ResourceServer:
+
+```typescript
+import { HTTPFacilitatorClient } from "@x402/core/server";
+import { x402ResourceServer } from "@x402/express";
+import { ExactEvmScheme } from "@x402/evm/exact/server";
+
+const customFacilitator = new HTTPFacilitatorClient({
+  url: "https://your-facilitator.com",
+  createAuthHeaders: async () => ({
+    verify: { Authorization: "Bearer your-token" },
+    settle: { Authorization: "Bearer your-token" },
+  }),
+});
+
+const resourceServer = new x402ResourceServer(customFacilitator)
+  .register("eip155:84532", new ExactEvmScheme());
+
+app.use(paymentMiddleware(routes, resourceServer, paywallConfig));
+```
+
+## Migration from x402-express
+
+If you're migrating from the legacy `x402-express` package:
+
+1. **Update imports**: Change from `x402-express` to `@x402/express`
+2. **New API**: Create an x402ResourceServer and register payment schemes
+3. **Parameter order**: Routes first, then resource server, then optional paywall config
+
+### Before (x402-express):
+
+```typescript
+import { paymentMiddleware } from "x402-express";
+
+app.use(
+  paymentMiddleware(
+    payTo, // First param was payTo address
+    routes, // Second param was routes
+    facilitator, // Third param was facilitator config
+    paywall, // Fourth param was paywall config
+  ),
+);
+```
+
+### After (@x402/express):
+
+```typescript
+import { paymentMiddleware, x402ResourceServer } from "@x402/express";
+import { HTTPFacilitatorClient } from "@x402/core/server";
+import { ExactEvmScheme } from "@x402/evm/exact/server";
+
+const facilitator = new HTTPFacilitatorClient({ url: facilitatorUrl });
+const resourceServer = new x402ResourceServer(facilitator)
+  .register("eip155:84532", new ExactEvmScheme());
+
+app.use(
+  paymentMiddleware(
+    routes, // First param is routes (payTo is part of route config)
+    resourceServer, // Second param is resource server (required)
+    paywallConfig, // Third param is paywall config (optional)
+  ),
+);
+```
+
+Note: The `payTo` address is now specified within each route configuration rather than as a separate parameter.

package/dist/cjs/index.d.ts

@@ -0,0 +1,145 @@
+import { HTTPAdapter, RoutesConfig, x402ResourceServer, PaywallConfig, PaywallProvider, 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';
+import { Request, Response, NextFunction } from 'express';
+
+/**
+ * Express adapter implementation
+ */
+declare class ExpressAdapter implements HTTPAdapter {
+    private req;
+    /**
+     * Creates a new ExpressAdapter instance.
+     *
+     * @param req - The Express request object
+     */
+    constructor(req: Request);
+    /**
+     * Gets a header value from the request.
+     *
+     * @param name - The header name
+     * @returns The header value or undefined
+     */
+    getHeader(name: string): string | undefined;
+    /**
+     * Gets the HTTP method of the request.
+     *
+     * @returns The HTTP method
+     */
+    getMethod(): string;
+    /**
+     * Gets the path of the request.
+     *
+     * @returns The request path
+     */
+    getPath(): string;
+    /**
+     * Gets the full URL of the request.
+     *
+     * @returns The full request URL
+     */
+    getUrl(): string;
+    /**
+     * Gets the Accept header from the request.
+     *
+     * @returns The Accept header value or empty string
+     */
+    getAcceptHeader(): string;
+    /**
+     * Gets the User-Agent header from the request.
+     *
+     * @returns The User-Agent header value or empty string
+     */
+    getUserAgent(): string;
+    /**
+     * Gets all query parameters from the request URL.
+     *
+     * @returns Record of query parameter key-value pairs
+     */
+    getQueryParams(): Record<string, string | string[]>;
+    /**
+     * Gets a specific query parameter by name.
+     *
+     * @param name - The query parameter name
+     * @returns The query parameter value(s) or undefined
+     */
+    getQueryParam(name: string): string | string[] | undefined;
+    /**
+     * Gets the parsed request body.
+     * Requires express.json() or express.urlencoded() middleware.
+     *
+     * @returns The parsed request body
+     */
+    getBody(): unknown;
+}
+
+/**
+ * Configuration for registering a payment scheme with a specific network
+ */
+interface SchemeRegistration {
+    /**
+     * The network identifier (e.g., 'eip155:84532', 'solana:mainnet')
+     */
+    network: Network;
+    /**
+     * The scheme server implementation for this network
+     */
+    server: SchemeNetworkServer;
+}
+/**
+ * Express payment middleware for x402 protocol (direct server instance).
+ *
+ * Use this when you want to pass a pre-configured x402ResourceServer instance.
+ * This provides more flexibility for testing, custom configuration, and reusing
+ * server instances across multiple middlewares.
+ *
+ * @param routes - Route configurations for protected endpoints
+ * @param server - Pre-configured x402ResourceServer instance
+ * @param paywallConfig - Optional configuration for the built-in paywall UI
+ * @param paywall - Optional custom paywall provider (overrides default)
+ * @param syncFacilitatorOnStart - Whether to sync with the facilitator on startup (defaults to true)
+ * @returns Express middleware handler
+ *
+ * @example
+ * ```typescript
+ * import { paymentMiddleware } from "@x402/express";
+ * import { x402ResourceServer } from "@x402/core/server";
+ * import { registerExactEvmScheme } from "@x402/evm/exact/server";
+ *
+ * const server = new x402ResourceServer(myFacilitatorClient);
+ * registerExactEvmScheme(server, { signer: myServerSigner });
+ *
+ * app.use(paymentMiddleware(routes, server, paywallConfig));
+ * ```
+ */
+declare function paymentMiddleware(routes: RoutesConfig, server: x402ResourceServer, paywallConfig?: PaywallConfig, paywall?: PaywallProvider, syncFacilitatorOnStart?: boolean): (req: Request, res: Response, next: NextFunction) => Promise<void>;
+/**
+ * Express payment middleware for x402 protocol (configuration-based).
+ *
+ * Use this when you want to quickly set up middleware with simple configuration.
+ * This function creates and configures the x402ResourceServer internally.
+ *
+ * @param routes - Route configurations for protected endpoints
+ * @param facilitatorClients - Optional facilitator client(s) for payment processing
+ * @param schemes - Optional array of scheme registrations for server-side payment processing
+ * @param paywallConfig - Optional configuration for the built-in paywall UI
+ * @param paywall - Optional custom paywall provider (overrides default)
+ * @param syncFacilitatorOnStart - Whether to sync with the facilitator on startup (defaults to true)
+ * @returns Express middleware handler
+ *
+ * @example
+ * ```typescript
+ * import { paymentMiddlewareFromConfig } from "@x402/express";
+ *
+ * app.use(paymentMiddlewareFromConfig(
+ *   routes,
+ *   myFacilitatorClient,
+ *   [{ network: "eip155:8453", server: evmSchemeServer }],
+ *   paywallConfig
+ * ));
+ * ```
+ */
+declare function paymentMiddlewareFromConfig(routes: RoutesConfig, facilitatorClients?: FacilitatorClient | FacilitatorClient[], schemes?: SchemeRegistration[], paywallConfig?: PaywallConfig, paywall?: PaywallProvider, syncFacilitatorOnStart?: boolean): (req: Request, res: Response, next: NextFunction) => Promise<void>;
+
+export { ExpressAdapter, type SchemeRegistration, paymentMiddleware, paymentMiddlewareFromConfig };

package/dist/cjs/index.js

@@ -0,0 +1,314 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  ExpressAdapter: () => ExpressAdapter,
+  RouteConfigurationError: () => import_server3.RouteConfigurationError,
+  paymentMiddleware: () => paymentMiddleware,
+  paymentMiddlewareFromConfig: () => paymentMiddlewareFromConfig,
+  x402HTTPResourceServer: () => import_server2.x402HTTPResourceServer,
+  x402ResourceServer: () => import_server2.x402ResourceServer
+});
+module.exports = __toCommonJS(src_exports);
+var import_server = require("@x402/core/server");
+
+// src/adapter.ts
+var ExpressAdapter = class {
+  /**
+   * Creates a new ExpressAdapter instance.
+   *
+   * @param req - The Express request object
+   */
+  constructor(req) {
+    this.req = req;
+  }
+  /**
+   * Gets a header value from the request.
+   *
+   * @param name - The header name
+   * @returns The header value or undefined
+   */
+  getHeader(name) {
+    const value = this.req.header(name);
+    return Array.isArray(value) ? value[0] : value;
+  }
+  /**
+   * Gets the HTTP method of the request.
+   *
+   * @returns The HTTP method
+   */
+  getMethod() {
+    return this.req.method;
+  }
+  /**
+   * Gets the path of the request.
+   *
+   * @returns The request path
+   */
+  getPath() {
+    return this.req.path;
+  }
+  /**
+   * Gets the full URL of the request.
+   *
+   * @returns The full request URL
+   */
+  getUrl() {
+    return `${this.req.protocol}://${this.req.headers.host}${this.req.path}`;
+  }
+  /**
+   * Gets the Accept header from the request.
+   *
+   * @returns The Accept header value or empty string
+   */
+  getAcceptHeader() {
+    return this.req.header("Accept") || "";
+  }
+  /**
+   * Gets the User-Agent header from the request.
+   *
+   * @returns The User-Agent header value or empty string
+   */
+  getUserAgent() {
+    return this.req.header("User-Agent") || "";
+  }
+  /**
+   * Gets all query parameters from the request URL.
+   *
+   * @returns Record of query parameter key-value pairs
+   */
+  getQueryParams() {
+    return this.req.query;
+  }
+  /**
+   * Gets a specific query parameter by name.
+   *
+   * @param name - The query parameter name
+   * @returns The query parameter value(s) or undefined
+   */
+  getQueryParam(name) {
+    const value = this.req.query[name];
+    return value;
+  }
+  /**
+   * Gets the parsed request body.
+   * Requires express.json() or express.urlencoded() middleware.
+   *
+   * @returns The parsed request body
+   */
+  getBody() {
+    return this.req.body;
+  }
+};
+
+// src/index.ts
+var import_server2 = require("@x402/core/server");
+var import_server3 = require("@x402/core/server");
+function checkIfBazaarNeeded(routes) {
+  if ("accepts" in routes) {
+    return !!(routes.extensions && "bazaar" in routes.extensions);
+  }
+  return Object.values(routes).some((routeConfig) => {
+    return !!(routeConfig.extensions && "bazaar" in routeConfig.extensions);
+  });
+}
+function paymentMiddleware(routes, server, paywallConfig, paywall, syncFacilitatorOnStart = true) {
+  const httpServer = new import_server.x402HTTPResourceServer(server, routes);
+  if (paywall) {
+    httpServer.registerPaywallProvider(paywall);
+  }
+  let initPromise = syncFacilitatorOnStart ? httpServer.initialize() : null;
+  let bazaarPromise = null;
+  if (checkIfBazaarNeeded(routes)) {
+    bazaarPromise = import("@x402/extensions/bazaar").then(({ bazaarResourceServerExtension }) => {
+      server.registerExtension(bazaarResourceServerExtension);
+    }).catch((err) => {
+      console.error("Failed to load bazaar extension:", err);
+    });
+  }
+  return async (req, res, next) => {
+    const adapter = new ExpressAdapter(req);
+    const context = {
+      adapter,
+      path: req.path,
+      method: req.method,
+      paymentHeader: adapter.getHeader("payment-signature") || adapter.getHeader("x-payment")
+    };
+    if (!httpServer.requiresPayment(context)) {
+      return next();
+    }
+    if (initPromise) {
+      await initPromise;
+      initPromise = null;
+    }
+    if (bazaarPromise) {
+      await bazaarPromise;
+      bazaarPromise = null;
+    }
+    const result = await httpServer.processHTTPRequest(context, paywallConfig);
+    switch (result.type) {
+      case "no-payment-required":
+        return next();
+      case "payment-error":
+        const { response } = result;
+        res.status(response.status);
+        Object.entries(response.headers).forEach(([key, value]) => {
+          res.setHeader(key, value);
+        });
+        if (response.isHtml) {
+          res.send(response.body);
+        } else {
+          res.json(response.body || {});
+        }
+        return;
+      case "payment-verified":
+        const { paymentPayload, paymentRequirements } = result;
+        const originalWriteHead = res.writeHead.bind(res);
+        const originalWrite = res.write.bind(res);
+        const originalEnd = res.end.bind(res);
+        const originalFlushHeaders = res.flushHeaders.bind(res);
+        let bufferedCalls = [];
+        let settled = false;
+        let endCalled;
+        const endPromise = new Promise((resolve) => {
+          endCalled = resolve;
+        });
+        res.writeHead = function(...args) {
+          if (!settled) {
+            bufferedCalls.push(["writeHead", args]);
+            return res;
+          }
+          return originalWriteHead(...args);
+        };
+        res.write = function(...args) {
+          if (!settled) {
+            bufferedCalls.push(["write", args]);
+            return true;
+          }
+          return originalWrite(...args);
+        };
+        res.end = function(...args) {
+          if (!settled) {
+            bufferedCalls.push(["end", args]);
+            endCalled();
+            return res;
+          }
+          return originalEnd(...args);
+        };
+        res.flushHeaders = function() {
+          if (!settled) {
+            bufferedCalls.push(["flushHeaders", []]);
+            return;
+          }
+          return originalFlushHeaders();
+        };
+        next();
+        await endPromise;
+        if (res.statusCode >= 400) {
+          settled = true;
+          res.writeHead = originalWriteHead;
+          res.write = originalWrite;
+          res.end = originalEnd;
+          res.flushHeaders = originalFlushHeaders;
+          for (const [method, args] of bufferedCalls) {
+            if (method === "writeHead")
+              originalWriteHead(...args);
+            else if (method === "write")
+              originalWrite(...args);
+            else if (method === "end") originalEnd(...args);
+            else if (method === "flushHeaders") originalFlushHeaders();
+          }
+          bufferedCalls = [];
+          return;
+        }
+        try {
+          const settleResult = await httpServer.processSettlement(
+            paymentPayload,
+            paymentRequirements
+          );
+          if (!settleResult.success) {
+            bufferedCalls = [];
+            res.status(402).json({
+              error: "Settlement failed",
+              details: settleResult.errorReason
+            });
+            return;
+          }
+          Object.entries(settleResult.headers).forEach(([key, value]) => {
+            res.setHeader(key, value);
+          });
+        } catch (error) {
+          console.error(error);
+          bufferedCalls = [];
+          res.status(402).json({
+            error: "Settlement failed",
+            details: error instanceof Error ? error.message : "Unknown error"
+          });
+          return;
+        } finally {
+          settled = true;
+          res.writeHead = originalWriteHead;
+          res.write = originalWrite;
+          res.end = originalEnd;
+          res.flushHeaders = originalFlushHeaders;
+          for (const [method, args] of bufferedCalls) {
+            if (method === "writeHead")
+              originalWriteHead(...args);
+            else if (method === "write")
+              originalWrite(...args);
+            else if (method === "end") originalEnd(...args);
+            else if (method === "flushHeaders") originalFlushHeaders();
+          }
+          bufferedCalls = [];
+        }
+        return;
+    }
+  };
+}
+function paymentMiddlewareFromConfig(routes, facilitatorClients, schemes, paywallConfig, paywall, syncFacilitatorOnStart = true) {
+  const ResourceServer = new import_server.x402ResourceServer(facilitatorClients);
+  if (schemes) {
+    schemes.forEach(({ network, server: schemeServer }) => {
+      ResourceServer.register(network, schemeServer);
+    });
+  }
+  return paymentMiddleware(routes, ResourceServer, paywallConfig, paywall, syncFacilitatorOnStart);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ExpressAdapter,
+  RouteConfigurationError,
+  paymentMiddleware,
+  paymentMiddlewareFromConfig,
+  x402HTTPResourceServer,
+  x402ResourceServer
+});
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +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 { NextFunction, Request, Response } from \"express\";\nimport { ExpressAdapter } 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 * Express 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 Express middleware handler\n *\n * @example\n * ```typescript\n * import { paymentMiddleware } from \"@x402/express\";\n * import { x402ResourceServer } from \"@x402/core/server\";\n * import { registerExactEvmScheme } from \"@x402/evm/exact/server\";\n *\n * const server = new x402ResourceServer(myFacilitatorClient);\n * registerExactEvmScheme(server, { signer: myServerSigner });\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) {\n  // Create the x402 HTTP server instance with the resource server\n  const httpServer = new x402HTTPResourceServer(server, routes);\n\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\n  let bazaarPromise: Promise<void> | null = null;\n  if (checkIfBazaarNeeded(routes)) {\n    bazaarPromise = import(\"@x402/extensions/bazaar\")\n      .then(({ bazaarResourceServerExtension }) => {\n        server.registerExtension(bazaarResourceServerExtension);\n      })\n      .catch(err => {\n        console.error(\"Failed to load bazaar extension:\", err);\n      });\n  }\n\n  return async (req: Request, res: Response, next: NextFunction) => {\n    // Create adapter and context\n    const adapter = new ExpressAdapter(req);\n    const context: HTTPRequestContext = {\n      adapter,\n      path: req.path,\n      method: 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        res.status(response.status);\n        Object.entries(response.headers).forEach(([key, value]) => {\n          res.setHeader(key, value);\n        });\n        if (response.isHtml) {\n          res.send(response.body);\n        } else {\n          res.json(response.body || {});\n        }\n        return;\n\n      case \"payment-verified\":\n        // Payment is valid, need to wrap response for settlement\n        const { paymentPayload, paymentRequirements } = result;\n\n        // Intercept and buffer all core methods that can commit response to client\n        const originalWriteHead = res.writeHead.bind(res);\n        const originalWrite = res.write.bind(res);\n        const originalEnd = res.end.bind(res);\n        const originalFlushHeaders = res.flushHeaders.bind(res);\n\n        type BufferedCall =\n          | [\"writeHead\", Parameters<typeof originalWriteHead>]\n          | [\"write\", Parameters<typeof originalWrite>]\n          | [\"end\", Parameters<typeof originalEnd>]\n          | [\"flushHeaders\", []];\n        let bufferedCalls: BufferedCall[] = [];\n        let settled = false;\n\n        // Create a promise that resolves when the handler finishes and calls res.end()\n        let endCalled: () => void;\n        const endPromise = new Promise<void>(resolve => {\n          endCalled = resolve;\n        });\n\n        res.writeHead = function (...args: Parameters<typeof originalWriteHead>) {\n          if (!settled) {\n            bufferedCalls.push([\"writeHead\", args]);\n            return res;\n          }\n          return originalWriteHead(...args);\n        } as typeof originalWriteHead;\n\n        res.write = function (...args: Parameters<typeof originalWrite>) {\n          if (!settled) {\n            bufferedCalls.push([\"write\", args]);\n            return true;\n          }\n          return originalWrite(...args);\n        } as typeof originalWrite;\n\n        res.end = function (...args: Parameters<typeof originalEnd>) {\n          if (!settled) {\n            bufferedCalls.push([\"end\", args]);\n            // Signal that the handler has finished\n            endCalled();\n            return res;\n          }\n          return originalEnd(...args);\n        } as typeof originalEnd;\n\n        res.flushHeaders = function () {\n          if (!settled) {\n            bufferedCalls.push([\"flushHeaders\", []]);\n            return;\n          }\n          return originalFlushHeaders();\n        };\n\n        // Proceed to the next middleware or route handler\n        next();\n\n        // Wait for the handler to actually call res.end() before checking status\n        await endPromise;\n\n        // If the response from the protected route is >= 400, do not settle payment\n        if (res.statusCode >= 400) {\n          settled = true;\n          res.writeHead = originalWriteHead;\n          res.write = originalWrite;\n          res.end = originalEnd;\n          res.flushHeaders = originalFlushHeaders;\n          // Replay all buffered calls in order\n          for (const [method, args] of bufferedCalls) {\n            if (method === \"writeHead\")\n              originalWriteHead(...(args as Parameters<typeof originalWriteHead>));\n            else if (method === \"write\")\n              originalWrite(...(args as Parameters<typeof originalWrite>));\n            else if (method === \"end\") originalEnd(...(args as Parameters<typeof originalEnd>));\n            else if (method === \"flushHeaders\") originalFlushHeaders();\n          }\n          bufferedCalls = [];\n          return;\n        }\n\n        try {\n          const settleResult = await httpServer.processSettlement(\n            paymentPayload,\n            paymentRequirements,\n          );\n\n          // If settlement fails, return an error and do not send the buffered response\n          if (!settleResult.success) {\n            bufferedCalls = [];\n            res.status(402).json({\n              error: \"Settlement failed\",\n              details: settleResult.errorReason,\n            });\n            return;\n          }\n\n          // Settlement succeeded - add headers to response\n          Object.entries(settleResult.headers).forEach(([key, value]) => {\n            res.setHeader(key, value);\n          });\n        } catch (error) {\n          console.error(error);\n          // If settlement fails, don't send the buffered response\n          bufferedCalls = [];\n          res.status(402).json({\n            error: \"Settlement failed\",\n            details: error instanceof Error ? error.message : \"Unknown error\",\n          });\n          return;\n        } finally {\n          settled = true;\n          res.writeHead = originalWriteHead;\n          res.write = originalWrite;\n          res.end = originalEnd;\n          res.flushHeaders = originalFlushHeaders;\n\n          // Replay all buffered calls in order\n          for (const [method, args] of bufferedCalls) {\n            if (method === \"writeHead\")\n              originalWriteHead(...(args as Parameters<typeof originalWriteHead>));\n            else if (method === \"write\")\n              originalWrite(...(args as Parameters<typeof originalWrite>));\n            else if (method === \"end\") originalEnd(...(args as Parameters<typeof originalEnd>));\n            else if (method === \"flushHeaders\") originalFlushHeaders();\n          }\n          bufferedCalls = [];\n        }\n        return;\n    }\n  };\n}\n\n/**\n * Express 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 Express middleware handler\n *\n * @example\n * ```typescript\n * import { paymentMiddlewareFromConfig } from \"@x402/express\";\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) {\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 { ExpressAdapter } from \"./adapter\";\n","import { HTTPAdapter } from \"@x402/core/server\";\nimport { Request } from \"express\";\n\n/**\n * Express adapter implementation\n */\nexport class ExpressAdapter implements HTTPAdapter {\n  /**\n   * Creates a new ExpressAdapter instance.\n   *\n   * @param req - The Express request object\n   */\n  constructor(private req: Request) {}\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    const value = this.req.header(name);\n    return Array.isArray(value) ? value[0] : value;\n  }\n\n  /**\n   * Gets the HTTP method of the request.\n   *\n   * @returns The HTTP method\n   */\n  getMethod(): string {\n    return this.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.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.req.protocol}://${this.req.headers.host}${this.req.path}`;\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.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.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    return this.req.query as Record<string, string | string[]>;\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    const value = this.req.query[name];\n    return value as string | string[] | undefined;\n  }\n\n  /**\n   * Gets the parsed request body.\n   * Requires express.json() or express.urlencoded() middleware.\n   *\n   * @returns The parsed request body\n   */\n  getBody(): unknown {\n    return this.req.body;\n  }\n}\n"],"mappings":"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","names":["import_server"]}

package/dist/esm/index.d.mts

@@ -0,0 +1,145 @@
+import { HTTPAdapter, RoutesConfig, x402ResourceServer, PaywallConfig, PaywallProvider, 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';
+import { Request, Response, NextFunction } from 'express';
+
+/**
+ * Express adapter implementation
+ */
+declare class ExpressAdapter implements HTTPAdapter {
+    private req;
+    /**
+     * Creates a new ExpressAdapter instance.
+     *
+     * @param req - The Express request object
+     */
+    constructor(req: Request);
+    /**
+     * Gets a header value from the request.
+     *
+     * @param name - The header name
+     * @returns The header value or undefined
+     */
+    getHeader(name: string): string | undefined;
+    /**
+     * Gets the HTTP method of the request.
+     *
+     * @returns The HTTP method
+     */
+    getMethod(): string;
+    /**
+     * Gets the path of the request.
+     *
+     * @returns The request path
+     */
+    getPath(): string;
+    /**
+     * Gets the full URL of the request.
+     *
+     * @returns The full request URL
+     */
+    getUrl(): string;
+    /**
+     * Gets the Accept header from the request.
+     *
+     * @returns The Accept header value or empty string
+     */
+    getAcceptHeader(): string;
+    /**
+     * Gets the User-Agent header from the request.
+     *
+     * @returns The User-Agent header value or empty string
+     */
+    getUserAgent(): string;
+    /**
+     * Gets all query parameters from the request URL.
+     *
+     * @returns Record of query parameter key-value pairs
+     */
+    getQueryParams(): Record<string, string | string[]>;
+    /**
+     * Gets a specific query parameter by name.
+     *
+     * @param name - The query parameter name
+     * @returns The query parameter value(s) or undefined
+     */
+    getQueryParam(name: string): string | string[] | undefined;
+    /**
+     * Gets the parsed request body.
+     * Requires express.json() or express.urlencoded() middleware.
+     *
+     * @returns The parsed request body
+     */
+    getBody(): unknown;
+}
+
+/**
+ * Configuration for registering a payment scheme with a specific network
+ */
+interface SchemeRegistration {
+    /**
+     * The network identifier (e.g., 'eip155:84532', 'solana:mainnet')
+     */
+    network: Network;
+    /**
+     * The scheme server implementation for this network
+     */
+    server: SchemeNetworkServer;
+}
+/**
+ * Express payment middleware for x402 protocol (direct server instance).
+ *
+ * Use this when you want to pass a pre-configured x402ResourceServer instance.
+ * This provides more flexibility for testing, custom configuration, and reusing
+ * server instances across multiple middlewares.
+ *
+ * @param routes - Route configurations for protected endpoints
+ * @param server - Pre-configured x402ResourceServer instance
+ * @param paywallConfig - Optional configuration for the built-in paywall UI
+ * @param paywall - Optional custom paywall provider (overrides default)
+ * @param syncFacilitatorOnStart - Whether to sync with the facilitator on startup (defaults to true)
+ * @returns Express middleware handler
+ *
+ * @example
+ * ```typescript
+ * import { paymentMiddleware } from "@x402/express";
+ * import { x402ResourceServer } from "@x402/core/server";
+ * import { registerExactEvmScheme } from "@x402/evm/exact/server";
+ *
+ * const server = new x402ResourceServer(myFacilitatorClient);
+ * registerExactEvmScheme(server, { signer: myServerSigner });
+ *
+ * app.use(paymentMiddleware(routes, server, paywallConfig));
+ * ```
+ */
+declare function paymentMiddleware(routes: RoutesConfig, server: x402ResourceServer, paywallConfig?: PaywallConfig, paywall?: PaywallProvider, syncFacilitatorOnStart?: boolean): (req: Request, res: Response, next: NextFunction) => Promise<void>;
+/**
+ * Express payment middleware for x402 protocol (configuration-based).
+ *
+ * Use this when you want to quickly set up middleware with simple configuration.
+ * This function creates and configures the x402ResourceServer internally.
+ *
+ * @param routes - Route configurations for protected endpoints
+ * @param facilitatorClients - Optional facilitator client(s) for payment processing
+ * @param schemes - Optional array of scheme registrations for server-side payment processing
+ * @param paywallConfig - Optional configuration for the built-in paywall UI
+ * @param paywall - Optional custom paywall provider (overrides default)
+ * @param syncFacilitatorOnStart - Whether to sync with the facilitator on startup (defaults to true)
+ * @returns Express middleware handler
+ *
+ * @example
+ * ```typescript
+ * import { paymentMiddlewareFromConfig } from "@x402/express";
+ *
+ * app.use(paymentMiddlewareFromConfig(
+ *   routes,
+ *   myFacilitatorClient,
+ *   [{ network: "eip155:8453", server: evmSchemeServer }],
+ *   paywallConfig
+ * ));
+ * ```
+ */
+declare function paymentMiddlewareFromConfig(routes: RoutesConfig, facilitatorClients?: FacilitatorClient | FacilitatorClient[], schemes?: SchemeRegistration[], paywallConfig?: PaywallConfig, paywall?: PaywallProvider, syncFacilitatorOnStart?: boolean): (req: Request, res: Response, next: NextFunction) => Promise<void>;
+
+export { ExpressAdapter, type SchemeRegistration, paymentMiddleware, paymentMiddlewareFromConfig };

package/dist/esm/index.mjs

@@ -0,0 +1,277 @@
+// src/index.ts
+import {
+  x402HTTPResourceServer,
+  x402ResourceServer
+} from "@x402/core/server";
+
+// src/adapter.ts
+var ExpressAdapter = class {
+  /**
+   * Creates a new ExpressAdapter instance.
+   *
+   * @param req - The Express request object
+   */
+  constructor(req) {
+    this.req = req;
+  }
+  /**
+   * Gets a header value from the request.
+   *
+   * @param name - The header name
+   * @returns The header value or undefined
+   */
+  getHeader(name) {
+    const value = this.req.header(name);
+    return Array.isArray(value) ? value[0] : value;
+  }
+  /**
+   * Gets the HTTP method of the request.
+   *
+   * @returns The HTTP method
+   */
+  getMethod() {
+    return this.req.method;
+  }
+  /**
+   * Gets the path of the request.
+   *
+   * @returns The request path
+   */
+  getPath() {
+    return this.req.path;
+  }
+  /**
+   * Gets the full URL of the request.
+   *
+   * @returns The full request URL
+   */
+  getUrl() {
+    return `${this.req.protocol}://${this.req.headers.host}${this.req.path}`;
+  }
+  /**
+   * Gets the Accept header from the request.
+   *
+   * @returns The Accept header value or empty string
+   */
+  getAcceptHeader() {
+    return this.req.header("Accept") || "";
+  }
+  /**
+   * Gets the User-Agent header from the request.
+   *
+   * @returns The User-Agent header value or empty string
+   */
+  getUserAgent() {
+    return this.req.header("User-Agent") || "";
+  }
+  /**
+   * Gets all query parameters from the request URL.
+   *
+   * @returns Record of query parameter key-value pairs
+   */
+  getQueryParams() {
+    return this.req.query;
+  }
+  /**
+   * Gets a specific query parameter by name.
+   *
+   * @param name - The query parameter name
+   * @returns The query parameter value(s) or undefined
+   */
+  getQueryParam(name) {
+    const value = this.req.query[name];
+    return value;
+  }
+  /**
+   * Gets the parsed request body.
+   * Requires express.json() or express.urlencoded() middleware.
+   *
+   * @returns The parsed request body
+   */
+  getBody() {
+    return this.req.body;
+  }
+};
+
+// src/index.ts
+import { x402ResourceServer as x402ResourceServer2, x402HTTPResourceServer as x402HTTPResourceServer2 } from "@x402/core/server";
+import { RouteConfigurationError } from "@x402/core/server";
+function checkIfBazaarNeeded(routes) {
+  if ("accepts" in routes) {
+    return !!(routes.extensions && "bazaar" in routes.extensions);
+  }
+  return Object.values(routes).some((routeConfig) => {
+    return !!(routeConfig.extensions && "bazaar" in routeConfig.extensions);
+  });
+}
+function paymentMiddleware(routes, server, paywallConfig, paywall, syncFacilitatorOnStart = true) {
+  const httpServer = new x402HTTPResourceServer(server, routes);
+  if (paywall) {
+    httpServer.registerPaywallProvider(paywall);
+  }
+  let initPromise = syncFacilitatorOnStart ? httpServer.initialize() : null;
+  let bazaarPromise = null;
+  if (checkIfBazaarNeeded(routes)) {
+    bazaarPromise = import("@x402/extensions/bazaar").then(({ bazaarResourceServerExtension }) => {
+      server.registerExtension(bazaarResourceServerExtension);
+    }).catch((err) => {
+      console.error("Failed to load bazaar extension:", err);
+    });
+  }
+  return async (req, res, next) => {
+    const adapter = new ExpressAdapter(req);
+    const context = {
+      adapter,
+      path: req.path,
+      method: req.method,
+      paymentHeader: adapter.getHeader("payment-signature") || adapter.getHeader("x-payment")
+    };
+    if (!httpServer.requiresPayment(context)) {
+      return next();
+    }
+    if (initPromise) {
+      await initPromise;
+      initPromise = null;
+    }
+    if (bazaarPromise) {
+      await bazaarPromise;
+      bazaarPromise = null;
+    }
+    const result = await httpServer.processHTTPRequest(context, paywallConfig);
+    switch (result.type) {
+      case "no-payment-required":
+        return next();
+      case "payment-error":
+        const { response } = result;
+        res.status(response.status);
+        Object.entries(response.headers).forEach(([key, value]) => {
+          res.setHeader(key, value);
+        });
+        if (response.isHtml) {
+          res.send(response.body);
+        } else {
+          res.json(response.body || {});
+        }
+        return;
+      case "payment-verified":
+        const { paymentPayload, paymentRequirements } = result;
+        const originalWriteHead = res.writeHead.bind(res);
+        const originalWrite = res.write.bind(res);
+        const originalEnd = res.end.bind(res);
+        const originalFlushHeaders = res.flushHeaders.bind(res);
+        let bufferedCalls = [];
+        let settled = false;
+        let endCalled;
+        const endPromise = new Promise((resolve) => {
+          endCalled = resolve;
+        });
+        res.writeHead = function(...args) {
+          if (!settled) {
+            bufferedCalls.push(["writeHead", args]);
+            return res;
+          }
+          return originalWriteHead(...args);
+        };
+        res.write = function(...args) {
+          if (!settled) {
+            bufferedCalls.push(["write", args]);
+            return true;
+          }
+          return originalWrite(...args);
+        };
+        res.end = function(...args) {
+          if (!settled) {
+            bufferedCalls.push(["end", args]);
+            endCalled();
+            return res;
+          }
+          return originalEnd(...args);
+        };
+        res.flushHeaders = function() {
+          if (!settled) {
+            bufferedCalls.push(["flushHeaders", []]);
+            return;
+          }
+          return originalFlushHeaders();
+        };
+        next();
+        await endPromise;
+        if (res.statusCode >= 400) {
+          settled = true;
+          res.writeHead = originalWriteHead;
+          res.write = originalWrite;
+          res.end = originalEnd;
+          res.flushHeaders = originalFlushHeaders;
+          for (const [method, args] of bufferedCalls) {
+            if (method === "writeHead")
+              originalWriteHead(...args);
+            else if (method === "write")
+              originalWrite(...args);
+            else if (method === "end") originalEnd(...args);
+            else if (method === "flushHeaders") originalFlushHeaders();
+          }
+          bufferedCalls = [];
+          return;
+        }
+        try {
+          const settleResult = await httpServer.processSettlement(
+            paymentPayload,
+            paymentRequirements
+          );
+          if (!settleResult.success) {
+            bufferedCalls = [];
+            res.status(402).json({
+              error: "Settlement failed",
+              details: settleResult.errorReason
+            });
+            return;
+          }
+          Object.entries(settleResult.headers).forEach(([key, value]) => {
+            res.setHeader(key, value);
+          });
+        } catch (error) {
+          console.error(error);
+          bufferedCalls = [];
+          res.status(402).json({
+            error: "Settlement failed",
+            details: error instanceof Error ? error.message : "Unknown error"
+          });
+          return;
+        } finally {
+          settled = true;
+          res.writeHead = originalWriteHead;
+          res.write = originalWrite;
+          res.end = originalEnd;
+          res.flushHeaders = originalFlushHeaders;
+          for (const [method, args] of bufferedCalls) {
+            if (method === "writeHead")
+              originalWriteHead(...args);
+            else if (method === "write")
+              originalWrite(...args);
+            else if (method === "end") originalEnd(...args);
+            else if (method === "flushHeaders") originalFlushHeaders();
+          }
+          bufferedCalls = [];
+        }
+        return;
+    }
+  };
+}
+function paymentMiddlewareFromConfig(routes, facilitatorClients, schemes, paywallConfig, paywall, syncFacilitatorOnStart = true) {
+  const ResourceServer = new x402ResourceServer(facilitatorClients);
+  if (schemes) {
+    schemes.forEach(({ network, server: schemeServer }) => {
+      ResourceServer.register(network, schemeServer);
+    });
+  }
+  return paymentMiddleware(routes, ResourceServer, paywallConfig, paywall, syncFacilitatorOnStart);
+}
+export {
+  ExpressAdapter,
+  RouteConfigurationError,
+  paymentMiddleware,
+  paymentMiddlewareFromConfig,
+  x402HTTPResourceServer2 as x402HTTPResourceServer,
+  x402ResourceServer2 as x402ResourceServer
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -0,0 +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 { NextFunction, Request, Response } from \"express\";\nimport { ExpressAdapter } 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 * Express 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 Express middleware handler\n *\n * @example\n * ```typescript\n * import { paymentMiddleware } from \"@x402/express\";\n * import { x402ResourceServer } from \"@x402/core/server\";\n * import { registerExactEvmScheme } from \"@x402/evm/exact/server\";\n *\n * const server = new x402ResourceServer(myFacilitatorClient);\n * registerExactEvmScheme(server, { signer: myServerSigner });\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) {\n  // Create the x402 HTTP server instance with the resource server\n  const httpServer = new x402HTTPResourceServer(server, routes);\n\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\n  let bazaarPromise: Promise<void> | null = null;\n  if (checkIfBazaarNeeded(routes)) {\n    bazaarPromise = import(\"@x402/extensions/bazaar\")\n      .then(({ bazaarResourceServerExtension }) => {\n        server.registerExtension(bazaarResourceServerExtension);\n      })\n      .catch(err => {\n        console.error(\"Failed to load bazaar extension:\", err);\n      });\n  }\n\n  return async (req: Request, res: Response, next: NextFunction) => {\n    // Create adapter and context\n    const adapter = new ExpressAdapter(req);\n    const context: HTTPRequestContext = {\n      adapter,\n      path: req.path,\n      method: 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        res.status(response.status);\n        Object.entries(response.headers).forEach(([key, value]) => {\n          res.setHeader(key, value);\n        });\n        if (response.isHtml) {\n          res.send(response.body);\n        } else {\n          res.json(response.body || {});\n        }\n        return;\n\n      case \"payment-verified\":\n        // Payment is valid, need to wrap response for settlement\n        const { paymentPayload, paymentRequirements } = result;\n\n        // Intercept and buffer all core methods that can commit response to client\n        const originalWriteHead = res.writeHead.bind(res);\n        const originalWrite = res.write.bind(res);\n        const originalEnd = res.end.bind(res);\n        const originalFlushHeaders = res.flushHeaders.bind(res);\n\n        type BufferedCall =\n          | [\"writeHead\", Parameters<typeof originalWriteHead>]\n          | [\"write\", Parameters<typeof originalWrite>]\n          | [\"end\", Parameters<typeof originalEnd>]\n          | [\"flushHeaders\", []];\n        let bufferedCalls: BufferedCall[] = [];\n        let settled = false;\n\n        // Create a promise that resolves when the handler finishes and calls res.end()\n        let endCalled: () => void;\n        const endPromise = new Promise<void>(resolve => {\n          endCalled = resolve;\n        });\n\n        res.writeHead = function (...args: Parameters<typeof originalWriteHead>) {\n          if (!settled) {\n            bufferedCalls.push([\"writeHead\", args]);\n            return res;\n          }\n          return originalWriteHead(...args);\n        } as typeof originalWriteHead;\n\n        res.write = function (...args: Parameters<typeof originalWrite>) {\n          if (!settled) {\n            bufferedCalls.push([\"write\", args]);\n            return true;\n          }\n          return originalWrite(...args);\n        } as typeof originalWrite;\n\n        res.end = function (...args: Parameters<typeof originalEnd>) {\n          if (!settled) {\n            bufferedCalls.push([\"end\", args]);\n            // Signal that the handler has finished\n            endCalled();\n            return res;\n          }\n          return originalEnd(...args);\n        } as typeof originalEnd;\n\n        res.flushHeaders = function () {\n          if (!settled) {\n            bufferedCalls.push([\"flushHeaders\", []]);\n            return;\n          }\n          return originalFlushHeaders();\n        };\n\n        // Proceed to the next middleware or route handler\n        next();\n\n        // Wait for the handler to actually call res.end() before checking status\n        await endPromise;\n\n        // If the response from the protected route is >= 400, do not settle payment\n        if (res.statusCode >= 400) {\n          settled = true;\n          res.writeHead = originalWriteHead;\n          res.write = originalWrite;\n          res.end = originalEnd;\n          res.flushHeaders = originalFlushHeaders;\n          // Replay all buffered calls in order\n          for (const [method, args] of bufferedCalls) {\n            if (method === \"writeHead\")\n              originalWriteHead(...(args as Parameters<typeof originalWriteHead>));\n            else if (method === \"write\")\n              originalWrite(...(args as Parameters<typeof originalWrite>));\n            else if (method === \"end\") originalEnd(...(args as Parameters<typeof originalEnd>));\n            else if (method === \"flushHeaders\") originalFlushHeaders();\n          }\n          bufferedCalls = [];\n          return;\n        }\n\n        try {\n          const settleResult = await httpServer.processSettlement(\n            paymentPayload,\n            paymentRequirements,\n          );\n\n          // If settlement fails, return an error and do not send the buffered response\n          if (!settleResult.success) {\n            bufferedCalls = [];\n            res.status(402).json({\n              error: \"Settlement failed\",\n              details: settleResult.errorReason,\n            });\n            return;\n          }\n\n          // Settlement succeeded - add headers to response\n          Object.entries(settleResult.headers).forEach(([key, value]) => {\n            res.setHeader(key, value);\n          });\n        } catch (error) {\n          console.error(error);\n          // If settlement fails, don't send the buffered response\n          bufferedCalls = [];\n          res.status(402).json({\n            error: \"Settlement failed\",\n            details: error instanceof Error ? error.message : \"Unknown error\",\n          });\n          return;\n        } finally {\n          settled = true;\n          res.writeHead = originalWriteHead;\n          res.write = originalWrite;\n          res.end = originalEnd;\n          res.flushHeaders = originalFlushHeaders;\n\n          // Replay all buffered calls in order\n          for (const [method, args] of bufferedCalls) {\n            if (method === \"writeHead\")\n              originalWriteHead(...(args as Parameters<typeof originalWriteHead>));\n            else if (method === \"write\")\n              originalWrite(...(args as Parameters<typeof originalWrite>));\n            else if (method === \"end\") originalEnd(...(args as Parameters<typeof originalEnd>));\n            else if (method === \"flushHeaders\") originalFlushHeaders();\n          }\n          bufferedCalls = [];\n        }\n        return;\n    }\n  };\n}\n\n/**\n * Express 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 Express middleware handler\n *\n * @example\n * ```typescript\n * import { paymentMiddlewareFromConfig } from \"@x402/express\";\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) {\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 { ExpressAdapter } from \"./adapter\";\n","import { HTTPAdapter } from \"@x402/core/server\";\nimport { Request } from \"express\";\n\n/**\n * Express adapter implementation\n */\nexport class ExpressAdapter implements HTTPAdapter {\n  /**\n   * Creates a new ExpressAdapter instance.\n   *\n   * @param req - The Express request object\n   */\n  constructor(private req: Request) {}\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    const value = this.req.header(name);\n    return Array.isArray(value) ? value[0] : value;\n  }\n\n  /**\n   * Gets the HTTP method of the request.\n   *\n   * @returns The HTTP method\n   */\n  getMethod(): string {\n    return this.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.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.req.protocol}://${this.req.headers.host}${this.req.path}`;\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.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.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    return this.req.query as Record<string, string | string[]>;\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    const value = this.req.query[name];\n    return value as string | string[] | undefined;\n  }\n\n  /**\n   * Gets the parsed request body.\n   * Requires express.json() or express.urlencoded() middleware.\n   *\n   * @returns The parsed request body\n   */\n  getBody(): unknown {\n    return this.req.body;\n  }\n}\n"],"mappings":"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","names":["x402ResourceServer","x402HTTPResourceServer"]}

package/package.json

@@ -1,12 +1,74 @@
 {
   "name": "@x402/express",
-  "version": "0.0.1",
-  "description": "The Express middleware package for the x402 payment protocol",
-  "main": "index.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
-  },
-  "author": "Coinbase Inc.",
+  "version": "2.1.0",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/index.d.ts",
+  "keywords": [],
   "license": "Apache-2.0",
-  "repository": "https://github.com/coinbase/x402"
+  "author": "Coinbase Inc.",
+  "repository": "https://github.com/coinbase/x402",
+  "description": "x402 Payment Protocol",
+  "devDependencies": {
+    "@eslint/js": "^9.24.0",
+    "@types/express": "^5.0.1",
+    "@types/node": "^22.13.4",
+    "@typescript-eslint/eslint-plugin": "^8.29.1",
+    "@typescript-eslint/parser": "^8.29.1",
+    "eslint": "^9.24.0",
+    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-jsdoc": "^50.6.9",
+    "eslint-plugin-prettier": "^5.2.6",
+    "express": "^4.18.2",
+    "prettier": "3.5.2",
+    "tsup": "^8.4.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3",
+    "vite": "^6.2.6",
+    "vite-tsconfig-paths": "^5.1.4",
+    "vitest": "^3.0.5"
+  },
+  "dependencies": {
+    "@coinbase/cdp-sdk": "^1.22.0",
+    "@solana/kit": "^2.1.1",
+    "viem": "^2.39.3",
+    "zod": "^3.24.2",
+    "@x402/core": "^2.1.0",
+    "@x402/extensions": "^2.1.0"
+  },
+  "peerDependencies": {
+    "express": "^4.0.0 || ^5.0.0",
+    "@x402/paywall": "2.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@x402/paywall": {
+      "optional": true
+    }
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.mts",
+        "default": "./dist/esm/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "start": "tsx --env-file=.env index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "build": "tsup",
+    "watch": "tsc --watch",
+    "format": "prettier -c .prettierrc --write \"**/*.{ts,js,cjs,json,md}\"",
+    "format:check": "prettier -c .prettierrc --check \"**/*.{ts,js,cjs,json,md}\"",
+    "lint": "eslint . --ext .ts --fix",
+    "lint:check": "eslint . --ext .ts"
+  }
 }

package/index.js

@@ -1,3 +0,0 @@
-// Placeholder for @x402/express
-module.exports = {};
-