@t402/fastify 2.0.0

package/dist/cjs/index.d.ts

@@ -0,0 +1,145 @@
+import { HTTPAdapter, RoutesConfig, t402ResourceServer, PaywallConfig, PaywallProvider, FacilitatorClient } from '@t402/core/server';
+export { PaywallConfig, PaywallProvider, RouteConfigurationError, RouteValidationError, t402HTTPResourceServer, t402ResourceServer } from '@t402/core/server';
+import { Network, SchemeNetworkServer } from '@t402/core/types';
+export { Network, PaymentPayload, PaymentRequired, PaymentRequirements, SchemeNetworkServer } from '@t402/core/types';
+import { FastifyRequest, preHandlerHookHandler } from 'fastify';
+
+/**
+ * Fastify adapter implementation
+ */
+declare class FastifyAdapter implements HTTPAdapter {
+    private request;
+    /**
+     * Creates a new FastifyAdapter instance.
+     *
+     * @param request - The Fastify request object
+     */
+    constructor(request: FastifyRequest);
+    /**
+     * 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 (without query string).
+     *
+     * @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.
+     * Fastify parses the body automatically.
+     *
+     * @returns The parsed request body
+     */
+    getBody(): Promise<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;
+}
+/**
+ * Fastify payment middleware for t402 protocol (direct server instance).
+ *
+ * Use this when you want to pass a pre-configured t402ResourceServer 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 t402ResourceServer 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 Fastify preHandler hook
+ *
+ * @example
+ * ```typescript
+ * import { paymentMiddleware } from "@t402/fastify";
+ * import { t402ResourceServer } from "@t402/core/server";
+ * import { registerExactEvmScheme } from "@t402/evm/exact/server";
+ *
+ * const server = new t402ResourceServer(myFacilitatorClient);
+ * registerExactEvmScheme(server, {});
+ *
+ * app.addHook('preHandler', paymentMiddleware(routes, server, paywallConfig));
+ * ```
+ */
+declare function paymentMiddleware(routes: RoutesConfig, server: t402ResourceServer, paywallConfig?: PaywallConfig, paywall?: PaywallProvider, syncFacilitatorOnStart?: boolean): preHandlerHookHandler;
+/**
+ * Fastify payment middleware for t402 protocol (configuration-based).
+ *
+ * Use this when you want to quickly set up middleware with simple configuration.
+ * This function creates and configures the t402ResourceServer 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 Fastify preHandler hook
+ *
+ * @example
+ * ```typescript
+ * import { paymentMiddlewareFromConfig } from "@t402/fastify";
+ *
+ * app.addHook('preHandler', 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): preHandlerHookHandler;
+
+export { FastifyAdapter, type SchemeRegistration, paymentMiddleware, paymentMiddlewareFromConfig };

package/dist/cjs/index.js

@@ -0,0 +1,260 @@
+"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, {
+  FastifyAdapter: () => FastifyAdapter,
+  RouteConfigurationError: () => import_server3.RouteConfigurationError,
+  paymentMiddleware: () => paymentMiddleware,
+  paymentMiddlewareFromConfig: () => paymentMiddlewareFromConfig,
+  t402HTTPResourceServer: () => import_server2.t402HTTPResourceServer,
+  t402ResourceServer: () => import_server2.t402ResourceServer
+});
+module.exports = __toCommonJS(src_exports);
+var import_server = require("@t402/core/server");
+
+// src/adapter.ts
+var FastifyAdapter = class {
+  /**
+   * Creates a new FastifyAdapter instance.
+   *
+   * @param request - The Fastify request object
+   */
+  constructor(request) {
+    this.request = request;
+  }
+  /**
+   * Gets a header value from the request.
+   *
+   * @param name - The header name
+   * @returns The header value or undefined
+   */
+  getHeader(name) {
+    const value = this.request.headers[name.toLowerCase()];
+    return Array.isArray(value) ? value[0] : value;
+  }
+  /**
+   * Gets the HTTP method of the request.
+   *
+   * @returns The HTTP method
+   */
+  getMethod() {
+    return this.request.method;
+  }
+  /**
+   * Gets the path of the request (without query string).
+   *
+   * @returns The request path
+   */
+  getPath() {
+    const url = this.request.url;
+    const queryIndex = url.indexOf("?");
+    return queryIndex === -1 ? url : url.substring(0, queryIndex);
+  }
+  /**
+   * Gets the full URL of the request.
+   *
+   * @returns The full request URL
+   */
+  getUrl() {
+    return `${this.request.protocol}://${this.request.hostname}${this.request.url}`;
+  }
+  /**
+   * Gets the Accept header from the request.
+   *
+   * @returns The Accept header value or empty string
+   */
+  getAcceptHeader() {
+    return this.getHeader("accept") || "";
+  }
+  /**
+   * Gets the User-Agent header from the request.
+   *
+   * @returns The User-Agent header value or empty string
+   */
+  getUserAgent() {
+    return this.getHeader("user-agent") || "";
+  }
+  /**
+   * Gets all query parameters from the request URL.
+   *
+   * @returns Record of query parameter key-value pairs
+   */
+  getQueryParams() {
+    const query = this.request.query;
+    if (!query) return {};
+    const result = {};
+    for (const [key, value] of Object.entries(query)) {
+      result[key] = value;
+    }
+    return result;
+  }
+  /**
+   * Gets a specific query parameter by name.
+   *
+   * @param name - The query parameter name
+   * @returns The query parameter value(s) or undefined
+   */
+  getQueryParam(name) {
+    const query = this.request.query;
+    if (!query) return void 0;
+    return query[name];
+  }
+  /**
+   * Gets the parsed request body.
+   * Fastify parses the body automatically.
+   *
+   * @returns The parsed request body
+   */
+  async getBody() {
+    try {
+      return this.request.body;
+    } catch {
+      return void 0;
+    }
+  }
+};
+
+// src/index.ts
+var import_server2 = require("@t402/core/server");
+var import_server3 = require("@t402/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.t402HTTPResourceServer(server, routes);
+  if (paywall) {
+    httpServer.registerPaywallProvider(paywall);
+  }
+  let initPromise = syncFacilitatorOnStart ? httpServer.initialize() : null;
+  let bazaarPromise = null;
+  if (checkIfBazaarNeeded(routes)) {
+    bazaarPromise = import("@t402/extensions/bazaar").then(({ bazaarResourceServerExtension }) => {
+      server.registerExtension(bazaarResourceServerExtension);
+    }).catch((err) => {
+      console.error("Failed to load bazaar extension:", err);
+    });
+  }
+  return async (request, reply) => {
+    const adapter = new FastifyAdapter(request);
+    const path = adapter.getPath();
+    const context = {
+      adapter,
+      path,
+      method: request.method,
+      paymentHeader: adapter.getHeader("payment-signature") || adapter.getHeader("x-payment")
+    };
+    if (!httpServer.requiresPayment(context)) {
+      return;
+    }
+    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;
+      case "payment-error": {
+        const { response } = result;
+        Object.entries(response.headers).forEach(([key, value]) => {
+          reply.header(key, value);
+        });
+        if (response.isHtml) {
+          return reply.code(response.status).type("text/html").send(response.body);
+        } else {
+          return reply.code(response.status).send(response.body || {});
+        }
+      }
+      case "payment-verified": {
+        const { paymentPayload, paymentRequirements } = result;
+        const replyWithHooks = reply;
+        replyWithHooks.addHook("onSend", async (_request, reply2, payload) => {
+          if (reply2.statusCode >= 400) {
+            return payload;
+          }
+          try {
+            const settleResult = await httpServer.processSettlement(
+              paymentPayload,
+              paymentRequirements
+            );
+            if (!settleResult.success) {
+              reply2.code(402);
+              return JSON.stringify({
+                error: "Settlement failed",
+                details: settleResult.errorReason
+              });
+            }
+            Object.entries(settleResult.headers).forEach(([key, value]) => {
+              reply2.header(key, value);
+            });
+            return payload;
+          } catch (error) {
+            console.error(error);
+            reply2.code(402);
+            return JSON.stringify({
+              error: "Settlement failed",
+              details: error instanceof Error ? error.message : "Unknown error"
+            });
+          }
+        });
+        return;
+      }
+    }
+  };
+}
+function paymentMiddlewareFromConfig(routes, facilitatorClients, schemes, paywallConfig, paywall, syncFacilitatorOnStart = true) {
+  const ResourceServer = new import_server.t402ResourceServer(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 = {
+  FastifyAdapter,
+  RouteConfigurationError,
+  paymentMiddleware,
+  paymentMiddlewareFromConfig,
+  t402HTTPResourceServer,
+  t402ResourceServer
+});
+//# 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  t402HTTPResourceServer,\n  t402ResourceServer,\n  RoutesConfig,\n  FacilitatorClient,\n} from \"@t402/core/server\";\nimport { SchemeNetworkServer, Network } from \"@t402/core/types\";\nimport type { FastifyRequest, FastifyReply, preHandlerHookHandler, onSendHookHandler } from \"fastify\";\nimport { FastifyAdapter } from \"./adapter.js\";\n\n// Extend FastifyReply to include addHook which exists at runtime but not in types\ninterface FastifyReplyWithHooks extends FastifyReply {\n  addHook(name: \"onSend\", hook: onSendHookHandler): void;\n}\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 * Fastify payment middleware for t402 protocol (direct server instance).\n *\n * Use this when you want to pass a pre-configured t402ResourceServer 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 t402ResourceServer 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 Fastify preHandler hook\n *\n * @example\n * ```typescript\n * import { paymentMiddleware } from \"@t402/fastify\";\n * import { t402ResourceServer } from \"@t402/core/server\";\n * import { registerExactEvmScheme } from \"@t402/evm/exact/server\";\n *\n * const server = new t402ResourceServer(myFacilitatorClient);\n * registerExactEvmScheme(server, {});\n *\n * app.addHook('preHandler', paymentMiddleware(routes, server, paywallConfig));\n * ```\n */\nexport function paymentMiddleware(\n  routes: RoutesConfig,\n  server: t402ResourceServer,\n  paywallConfig?: PaywallConfig,\n  paywall?: PaywallProvider,\n  syncFacilitatorOnStart: boolean = true,\n): preHandlerHookHandler {\n  // Create the t402 HTTP server instance with the resource server\n  const httpServer = new t402HTTPResourceServer(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(\"@t402/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 (request: FastifyRequest, reply: FastifyReply) => {\n    // Create adapter and context\n    const adapter = new FastifyAdapter(request);\n    const path = adapter.getPath();\n\n    const context: HTTPRequestContext = {\n      adapter,\n      path,\n      method: request.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; // Continue to route handler\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;\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          reply.header(key, value);\n        });\n        if (response.isHtml) {\n          return reply.code(response.status).type(\"text/html\").send(response.body);\n        } else {\n          return reply.code(response.status).send(response.body || {});\n        }\n      }\n\n      case \"payment-verified\": {\n        // Payment is valid, need to handle settlement after route handler\n        const { paymentPayload, paymentRequirements } = result;\n\n        // Use onSend hook to handle settlement after route handler completes\n        // Cast to extended interface since addHook exists at runtime\n        const replyWithHooks = reply as unknown as FastifyReplyWithHooks;\n        replyWithHooks.addHook(\"onSend\", async (_request: FastifyRequest, reply: FastifyReply, payload: unknown) => {\n          // If the response from the protected route is >= 400, do not settle payment\n          if (reply.statusCode >= 400) {\n            return payload;\n          }\n\n          try {\n            const settleResult = await httpServer.processSettlement(\n              paymentPayload,\n              paymentRequirements,\n            );\n\n            if (!settleResult.success) {\n              // Settlement failed - return error response\n              reply.code(402);\n              return JSON.stringify({\n                error: \"Settlement failed\",\n                details: settleResult.errorReason,\n              });\n            }\n\n            // Settlement succeeded - add headers to response\n            Object.entries(settleResult.headers).forEach(([key, value]) => {\n              reply.header(key, value);\n            });\n\n            return payload;\n          } catch (error) {\n            console.error(error);\n            // If settlement fails, return an error response\n            reply.code(402);\n            return JSON.stringify({\n              error: \"Settlement failed\",\n              details: error instanceof Error ? error.message : \"Unknown error\",\n            });\n          }\n        });\n\n        // Continue to route handler\n        return;\n      }\n    }\n  };\n}\n\n/**\n * Fastify payment middleware for t402 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 t402ResourceServer 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 Fastify preHandler hook\n *\n * @example\n * ```typescript\n * import { paymentMiddlewareFromConfig } from \"@t402/fastify\";\n *\n * app.addHook('preHandler', 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): preHandlerHookHandler {\n  const ResourceServer = new t402ResourceServer(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 { t402ResourceServer, t402HTTPResourceServer } from \"@t402/core/server\";\n\nexport type {\n  PaymentRequired,\n  PaymentRequirements,\n  PaymentPayload,\n  Network,\n  SchemeNetworkServer,\n} from \"@t402/core/types\";\n\nexport type { PaywallProvider, PaywallConfig } from \"@t402/core/server\";\n\nexport { RouteConfigurationError } from \"@t402/core/server\";\n\nexport type { RouteValidationError } from \"@t402/core/server\";\n\nexport { FastifyAdapter } from \"./adapter.js\";\n","import { HTTPAdapter } from \"@t402/core/server\";\nimport type { FastifyRequest } from \"fastify\";\n\n/**\n * Fastify adapter implementation\n */\nexport class FastifyAdapter implements HTTPAdapter {\n  /**\n   * Creates a new FastifyAdapter instance.\n   *\n   * @param request - The Fastify request object\n   */\n  constructor(private request: FastifyRequest) {}\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.request.headers[name.toLowerCase()];\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.request.method;\n  }\n\n  /**\n   * Gets the path of the request (without query string).\n   *\n   * @returns The request path\n   */\n  getPath(): string {\n    // Split URL to remove query string\n    const url = this.request.url;\n    const queryIndex = url.indexOf(\"?\");\n    return queryIndex === -1 ? url : url.substring(0, queryIndex);\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.request.protocol}://${this.request.hostname}${this.request.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.getHeader(\"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.getHeader(\"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.request.query as Record<string, string | string[]> | undefined;\n    if (!query) return {};\n\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    const query = this.request.query as Record<string, string | string[]> | undefined;\n    if (!query) return undefined;\n    return query[name];\n  }\n\n  /**\n   * Gets the parsed request body.\n   * Fastify parses the body automatically.\n   *\n   * @returns The parsed request body\n   */\n  async getBody(): Promise<unknown> {\n    try {\n      return this.request.body;\n    } catch {\n      return undefined;\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,oBAQO;;;ACFA,IAAM,iBAAN,MAA4C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMjD,YAAoB,SAAyB;AAAzB;AAAA,EAA0B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ9C,UAAU,MAAkC;AAC1C,UAAM,QAAQ,KAAK,QAAQ,QAAQ,KAAK,YAAY,CAAC;AACrD,WAAO,MAAM,QAAQ,KAAK,IAAI,MAAM,CAAC,IAAI;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,YAAoB;AAClB,WAAO,KAAK,QAAQ;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,UAAkB;AAEhB,UAAM,MAAM,KAAK,QAAQ;AACzB,UAAM,aAAa,IAAI,QAAQ,GAAG;AAClC,WAAO,eAAe,KAAK,MAAM,IAAI,UAAU,GAAG,UAAU;AAAA,EAC9D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,SAAiB;AACf,WAAO,GAAG,KAAK,QAAQ,QAAQ,MAAM,KAAK,QAAQ,QAAQ,GAAG,KAAK,QAAQ,GAAG;AAAA,EAC/E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,kBAA0B;AACxB,WAAO,KAAK,UAAU,QAAQ,KAAK;AAAA,EACrC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,eAAuB;AACrB,WAAO,KAAK,UAAU,YAAY,KAAK;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,iBAAoD;AAClD,UAAM,QAAQ,KAAK,QAAQ;AAC3B,QAAI,CAAC,MAAO,QAAO,CAAC;AAEpB,UAAM,SAA4C,CAAC;AACnD,eAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,GAAG;AAChD,aAAO,GAAG,IAAI;AAAA,IAChB;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,cAAc,MAA6C;AACzD,UAAM,QAAQ,KAAK,QAAQ;AAC3B,QAAI,CAAC,MAAO,QAAO;AACnB,WAAO,MAAM,IAAI;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,UAA4B;AAChC,QAAI;AACF,aAAO,KAAK,QAAQ;AAAA,IACtB,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AACF;;;ADgJA,IAAAA,iBAA2D;AAY3D,IAAAA,iBAAwC;AAtPxC,SAAS,oBAAoB,QAA+B;AAE1D,MAAI,aAAa,QAAQ;AACvB,WAAO,CAAC,EAAE,OAAO,cAAc,YAAY,OAAO;AAAA,EACpD;AAGA,SAAO,OAAO,OAAO,MAAM,EAAE,KAAK,iBAAe;AAC/C,WAAO,CAAC,EAAE,YAAY,cAAc,YAAY,YAAY;AAAA,EAC9D,CAAC;AACH;AA2CO,SAAS,kBACd,QACA,QACA,eACA,SACA,yBAAkC,MACX;AAEvB,QAAM,aAAa,IAAI,qCAAuB,QAAQ,MAAM;AAG5D,MAAI,SAAS;AACX,eAAW,wBAAwB,OAAO;AAAA,EAC5C;AAIA,MAAI,cAAoC,yBAAyB,WAAW,WAAW,IAAI;AAG3F,MAAI,gBAAsC;AAC1C,MAAI,oBAAoB,MAAM,GAAG;AAC/B,oBAAgB,OAAO,yBAAyB,EAC7C,KAAK,CAAC,EAAE,8BAA8B,MAAM;AAC3C,aAAO,kBAAkB,6BAA6B;AAAA,IACxD,CAAC,EACA,MAAM,SAAO;AACZ,cAAQ,MAAM,oCAAoC,GAAG;AAAA,IACvD,CAAC;AAAA,EACL;AAEA,SAAO,OAAO,SAAyB,UAAwB;AAE7D,UAAM,UAAU,IAAI,eAAe,OAAO;AAC1C,UAAM,OAAO,QAAQ,QAAQ;AAE7B,UAAM,UAA8B;AAAA,MAClC;AAAA,MACA;AAAA,MACA,QAAQ,QAAQ;AAAA,MAChB,eAAe,QAAQ,UAAU,mBAAmB,KAAK,QAAQ,UAAU,WAAW;AAAA,IACxF;AAGA,QAAI,CAAC,WAAW,gBAAgB,OAAO,GAAG;AACxC;AAAA,IACF;AAGA,QAAI,aAAa;AACf,YAAM;AACN,oBAAc;AAAA,IAChB;AAGA,QAAI,eAAe;AACjB,YAAM;AACN,sBAAgB;AAAA,IAClB;AAGA,UAAM,SAAS,MAAM,WAAW,mBAAmB,SAAS,aAAa;AAGzE,YAAQ,OAAO,MAAM;AAAA,MACnB,KAAK;AAEH;AAAA,MAEF,KAAK,iBAAiB;AAEpB,cAAM,EAAE,SAAS,IAAI;AACrB,eAAO,QAAQ,SAAS,OAAO,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM;AACzD,gBAAM,OAAO,KAAK,KAAK;AAAA,QACzB,CAAC;AACD,YAAI,SAAS,QAAQ;AACnB,iBAAO,MAAM,KAAK,SAAS,MAAM,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,IAAI;AAAA,QACzE,OAAO;AACL,iBAAO,MAAM,KAAK,SAAS,MAAM,EAAE,KAAK,SAAS,QAAQ,CAAC,CAAC;AAAA,QAC7D;AAAA,MACF;AAAA,MAEA,KAAK,oBAAoB;AAEvB,cAAM,EAAE,gBAAgB,oBAAoB,IAAI;AAIhD,cAAM,iBAAiB;AACvB,uBAAe,QAAQ,UAAU,OAAO,UAA0BC,QAAqB,YAAqB;AAE1G,cAAIA,OAAM,cAAc,KAAK;AAC3B,mBAAO;AAAA,UACT;AAEA,cAAI;AACF,kBAAM,eAAe,MAAM,WAAW;AAAA,cACpC;AAAA,cACA;AAAA,YACF;AAEA,gBAAI,CAAC,aAAa,SAAS;AAEzB,cAAAA,OAAM,KAAK,GAAG;AACd,qBAAO,KAAK,UAAU;AAAA,gBACpB,OAAO;AAAA,gBACP,SAAS,aAAa;AAAA,cACxB,CAAC;AAAA,YACH;AAGA,mBAAO,QAAQ,aAAa,OAAO,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM;AAC7D,cAAAA,OAAM,OAAO,KAAK,KAAK;AAAA,YACzB,CAAC;AAED,mBAAO;AAAA,UACT,SAAS,OAAO;AACd,oBAAQ,MAAM,KAAK;AAEnB,YAAAA,OAAM,KAAK,GAAG;AACd,mBAAO,KAAK,UAAU;AAAA,cACpB,OAAO;AAAA,cACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU;AAAA,YACpD,CAAC;AAAA,UACH;AAAA,QACF,CAAC;AAGD;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AA4BO,SAAS,4BACd,QACA,oBACA,SACA,eACA,SACA,yBAAkC,MACX;AACvB,QAAM,iBAAiB,IAAI,iCAAmB,kBAAkB;AAEhE,MAAI,SAAS;AACX,YAAQ,QAAQ,CAAC,EAAE,SAAS,QAAQ,aAAa,MAAM;AACrD,qBAAe,SAAS,SAAS,YAAY;AAAA,IAC/C,CAAC;AAAA,EACH;AAIA,SAAO,kBAAkB,QAAQ,gBAAgB,eAAe,SAAS,sBAAsB;AACjG;","names":["import_server","reply"]}

package/dist/esm/index.d.mts

@@ -0,0 +1,145 @@
+import { HTTPAdapter, RoutesConfig, t402ResourceServer, PaywallConfig, PaywallProvider, FacilitatorClient } from '@t402/core/server';
+export { PaywallConfig, PaywallProvider, RouteConfigurationError, RouteValidationError, t402HTTPResourceServer, t402ResourceServer } from '@t402/core/server';
+import { Network, SchemeNetworkServer } from '@t402/core/types';
+export { Network, PaymentPayload, PaymentRequired, PaymentRequirements, SchemeNetworkServer } from '@t402/core/types';
+import { FastifyRequest, preHandlerHookHandler } from 'fastify';
+
+/**
+ * Fastify adapter implementation
+ */
+declare class FastifyAdapter implements HTTPAdapter {
+    private request;
+    /**
+     * Creates a new FastifyAdapter instance.
+     *
+     * @param request - The Fastify request object
+     */
+    constructor(request: FastifyRequest);
+    /**
+     * 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 (without query string).
+     *
+     * @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.
+     * Fastify parses the body automatically.
+     *
+     * @returns The parsed request body
+     */
+    getBody(): Promise<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;
+}
+/**
+ * Fastify payment middleware for t402 protocol (direct server instance).
+ *
+ * Use this when you want to pass a pre-configured t402ResourceServer 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 t402ResourceServer 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 Fastify preHandler hook
+ *
+ * @example
+ * ```typescript
+ * import { paymentMiddleware } from "@t402/fastify";
+ * import { t402ResourceServer } from "@t402/core/server";
+ * import { registerExactEvmScheme } from "@t402/evm/exact/server";
+ *
+ * const server = new t402ResourceServer(myFacilitatorClient);
+ * registerExactEvmScheme(server, {});
+ *
+ * app.addHook('preHandler', paymentMiddleware(routes, server, paywallConfig));
+ * ```
+ */
+declare function paymentMiddleware(routes: RoutesConfig, server: t402ResourceServer, paywallConfig?: PaywallConfig, paywall?: PaywallProvider, syncFacilitatorOnStart?: boolean): preHandlerHookHandler;
+/**
+ * Fastify payment middleware for t402 protocol (configuration-based).
+ *
+ * Use this when you want to quickly set up middleware with simple configuration.
+ * This function creates and configures the t402ResourceServer 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 Fastify preHandler hook
+ *
+ * @example
+ * ```typescript
+ * import { paymentMiddlewareFromConfig } from "@t402/fastify";
+ *
+ * app.addHook('preHandler', 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): preHandlerHookHandler;
+
+export { FastifyAdapter, type SchemeRegistration, paymentMiddleware, paymentMiddlewareFromConfig };

package/dist/esm/index.mjs

@@ -0,0 +1,223 @@
+// src/index.ts
+import {
+  t402HTTPResourceServer,
+  t402ResourceServer
+} from "@t402/core/server";
+
+// src/adapter.ts
+var FastifyAdapter = class {
+  /**
+   * Creates a new FastifyAdapter instance.
+   *
+   * @param request - The Fastify request object
+   */
+  constructor(request) {
+    this.request = request;
+  }
+  /**
+   * Gets a header value from the request.
+   *
+   * @param name - The header name
+   * @returns The header value or undefined
+   */
+  getHeader(name) {
+    const value = this.request.headers[name.toLowerCase()];
+    return Array.isArray(value) ? value[0] : value;
+  }
+  /**
+   * Gets the HTTP method of the request.
+   *
+   * @returns The HTTP method
+   */
+  getMethod() {
+    return this.request.method;
+  }
+  /**
+   * Gets the path of the request (without query string).
+   *
+   * @returns The request path
+   */
+  getPath() {
+    const url = this.request.url;
+    const queryIndex = url.indexOf("?");
+    return queryIndex === -1 ? url : url.substring(0, queryIndex);
+  }
+  /**
+   * Gets the full URL of the request.
+   *
+   * @returns The full request URL
+   */
+  getUrl() {
+    return `${this.request.protocol}://${this.request.hostname}${this.request.url}`;
+  }
+  /**
+   * Gets the Accept header from the request.
+   *
+   * @returns The Accept header value or empty string
+   */
+  getAcceptHeader() {
+    return this.getHeader("accept") || "";
+  }
+  /**
+   * Gets the User-Agent header from the request.
+   *
+   * @returns The User-Agent header value or empty string
+   */
+  getUserAgent() {
+    return this.getHeader("user-agent") || "";
+  }
+  /**
+   * Gets all query parameters from the request URL.
+   *
+   * @returns Record of query parameter key-value pairs
+   */
+  getQueryParams() {
+    const query = this.request.query;
+    if (!query) return {};
+    const result = {};
+    for (const [key, value] of Object.entries(query)) {
+      result[key] = value;
+    }
+    return result;
+  }
+  /**
+   * Gets a specific query parameter by name.
+   *
+   * @param name - The query parameter name
+   * @returns The query parameter value(s) or undefined
+   */
+  getQueryParam(name) {
+    const query = this.request.query;
+    if (!query) return void 0;
+    return query[name];
+  }
+  /**
+   * Gets the parsed request body.
+   * Fastify parses the body automatically.
+   *
+   * @returns The parsed request body
+   */
+  async getBody() {
+    try {
+      return this.request.body;
+    } catch {
+      return void 0;
+    }
+  }
+};
+
+// src/index.ts
+import { t402ResourceServer as t402ResourceServer2, t402HTTPResourceServer as t402HTTPResourceServer2 } from "@t402/core/server";
+import { RouteConfigurationError } from "@t402/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 t402HTTPResourceServer(server, routes);
+  if (paywall) {
+    httpServer.registerPaywallProvider(paywall);
+  }
+  let initPromise = syncFacilitatorOnStart ? httpServer.initialize() : null;
+  let bazaarPromise = null;
+  if (checkIfBazaarNeeded(routes)) {
+    bazaarPromise = import("@t402/extensions/bazaar").then(({ bazaarResourceServerExtension }) => {
+      server.registerExtension(bazaarResourceServerExtension);
+    }).catch((err) => {
+      console.error("Failed to load bazaar extension:", err);
+    });
+  }
+  return async (request, reply) => {
+    const adapter = new FastifyAdapter(request);
+    const path = adapter.getPath();
+    const context = {
+      adapter,
+      path,
+      method: request.method,
+      paymentHeader: adapter.getHeader("payment-signature") || adapter.getHeader("x-payment")
+    };
+    if (!httpServer.requiresPayment(context)) {
+      return;
+    }
+    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;
+      case "payment-error": {
+        const { response } = result;
+        Object.entries(response.headers).forEach(([key, value]) => {
+          reply.header(key, value);
+        });
+        if (response.isHtml) {
+          return reply.code(response.status).type("text/html").send(response.body);
+        } else {
+          return reply.code(response.status).send(response.body || {});
+        }
+      }
+      case "payment-verified": {
+        const { paymentPayload, paymentRequirements } = result;
+        const replyWithHooks = reply;
+        replyWithHooks.addHook("onSend", async (_request, reply2, payload) => {
+          if (reply2.statusCode >= 400) {
+            return payload;
+          }
+          try {
+            const settleResult = await httpServer.processSettlement(
+              paymentPayload,
+              paymentRequirements
+            );
+            if (!settleResult.success) {
+              reply2.code(402);
+              return JSON.stringify({
+                error: "Settlement failed",
+                details: settleResult.errorReason
+              });
+            }
+            Object.entries(settleResult.headers).forEach(([key, value]) => {
+              reply2.header(key, value);
+            });
+            return payload;
+          } catch (error) {
+            console.error(error);
+            reply2.code(402);
+            return JSON.stringify({
+              error: "Settlement failed",
+              details: error instanceof Error ? error.message : "Unknown error"
+            });
+          }
+        });
+        return;
+      }
+    }
+  };
+}
+function paymentMiddlewareFromConfig(routes, facilitatorClients, schemes, paywallConfig, paywall, syncFacilitatorOnStart = true) {
+  const ResourceServer = new t402ResourceServer(facilitatorClients);
+  if (schemes) {
+    schemes.forEach(({ network, server: schemeServer }) => {
+      ResourceServer.register(network, schemeServer);
+    });
+  }
+  return paymentMiddleware(routes, ResourceServer, paywallConfig, paywall, syncFacilitatorOnStart);
+}
+export {
+  FastifyAdapter,
+  RouteConfigurationError,
+  paymentMiddleware,
+  paymentMiddlewareFromConfig,
+  t402HTTPResourceServer2 as t402HTTPResourceServer,
+  t402ResourceServer2 as t402ResourceServer
+};
+//# 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  t402HTTPResourceServer,\n  t402ResourceServer,\n  RoutesConfig,\n  FacilitatorClient,\n} from \"@t402/core/server\";\nimport { SchemeNetworkServer, Network } from \"@t402/core/types\";\nimport type { FastifyRequest, FastifyReply, preHandlerHookHandler, onSendHookHandler } from \"fastify\";\nimport { FastifyAdapter } from \"./adapter.js\";\n\n// Extend FastifyReply to include addHook which exists at runtime but not in types\ninterface FastifyReplyWithHooks extends FastifyReply {\n  addHook(name: \"onSend\", hook: onSendHookHandler): void;\n}\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 * Fastify payment middleware for t402 protocol (direct server instance).\n *\n * Use this when you want to pass a pre-configured t402ResourceServer 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 t402ResourceServer 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 Fastify preHandler hook\n *\n * @example\n * ```typescript\n * import { paymentMiddleware } from \"@t402/fastify\";\n * import { t402ResourceServer } from \"@t402/core/server\";\n * import { registerExactEvmScheme } from \"@t402/evm/exact/server\";\n *\n * const server = new t402ResourceServer(myFacilitatorClient);\n * registerExactEvmScheme(server, {});\n *\n * app.addHook('preHandler', paymentMiddleware(routes, server, paywallConfig));\n * ```\n */\nexport function paymentMiddleware(\n  routes: RoutesConfig,\n  server: t402ResourceServer,\n  paywallConfig?: PaywallConfig,\n  paywall?: PaywallProvider,\n  syncFacilitatorOnStart: boolean = true,\n): preHandlerHookHandler {\n  // Create the t402 HTTP server instance with the resource server\n  const httpServer = new t402HTTPResourceServer(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(\"@t402/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 (request: FastifyRequest, reply: FastifyReply) => {\n    // Create adapter and context\n    const adapter = new FastifyAdapter(request);\n    const path = adapter.getPath();\n\n    const context: HTTPRequestContext = {\n      adapter,\n      path,\n      method: request.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; // Continue to route handler\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;\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          reply.header(key, value);\n        });\n        if (response.isHtml) {\n          return reply.code(response.status).type(\"text/html\").send(response.body);\n        } else {\n          return reply.code(response.status).send(response.body || {});\n        }\n      }\n\n      case \"payment-verified\": {\n        // Payment is valid, need to handle settlement after route handler\n        const { paymentPayload, paymentRequirements } = result;\n\n        // Use onSend hook to handle settlement after route handler completes\n        // Cast to extended interface since addHook exists at runtime\n        const replyWithHooks = reply as unknown as FastifyReplyWithHooks;\n        replyWithHooks.addHook(\"onSend\", async (_request: FastifyRequest, reply: FastifyReply, payload: unknown) => {\n          // If the response from the protected route is >= 400, do not settle payment\n          if (reply.statusCode >= 400) {\n            return payload;\n          }\n\n          try {\n            const settleResult = await httpServer.processSettlement(\n              paymentPayload,\n              paymentRequirements,\n            );\n\n            if (!settleResult.success) {\n              // Settlement failed - return error response\n              reply.code(402);\n              return JSON.stringify({\n                error: \"Settlement failed\",\n                details: settleResult.errorReason,\n              });\n            }\n\n            // Settlement succeeded - add headers to response\n            Object.entries(settleResult.headers).forEach(([key, value]) => {\n              reply.header(key, value);\n            });\n\n            return payload;\n          } catch (error) {\n            console.error(error);\n            // If settlement fails, return an error response\n            reply.code(402);\n            return JSON.stringify({\n              error: \"Settlement failed\",\n              details: error instanceof Error ? error.message : \"Unknown error\",\n            });\n          }\n        });\n\n        // Continue to route handler\n        return;\n      }\n    }\n  };\n}\n\n/**\n * Fastify payment middleware for t402 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 t402ResourceServer 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 Fastify preHandler hook\n *\n * @example\n * ```typescript\n * import { paymentMiddlewareFromConfig } from \"@t402/fastify\";\n *\n * app.addHook('preHandler', 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): preHandlerHookHandler {\n  const ResourceServer = new t402ResourceServer(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 { t402ResourceServer, t402HTTPResourceServer } from \"@t402/core/server\";\n\nexport type {\n  PaymentRequired,\n  PaymentRequirements,\n  PaymentPayload,\n  Network,\n  SchemeNetworkServer,\n} from \"@t402/core/types\";\n\nexport type { PaywallProvider, PaywallConfig } from \"@t402/core/server\";\n\nexport { RouteConfigurationError } from \"@t402/core/server\";\n\nexport type { RouteValidationError } from \"@t402/core/server\";\n\nexport { FastifyAdapter } from \"./adapter.js\";\n","import { HTTPAdapter } from \"@t402/core/server\";\nimport type { FastifyRequest } from \"fastify\";\n\n/**\n * Fastify adapter implementation\n */\nexport class FastifyAdapter implements HTTPAdapter {\n  /**\n   * Creates a new FastifyAdapter instance.\n   *\n   * @param request - The Fastify request object\n   */\n  constructor(private request: FastifyRequest) {}\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.request.headers[name.toLowerCase()];\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.request.method;\n  }\n\n  /**\n   * Gets the path of the request (without query string).\n   *\n   * @returns The request path\n   */\n  getPath(): string {\n    // Split URL to remove query string\n    const url = this.request.url;\n    const queryIndex = url.indexOf(\"?\");\n    return queryIndex === -1 ? url : url.substring(0, queryIndex);\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.request.protocol}://${this.request.hostname}${this.request.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.getHeader(\"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.getHeader(\"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.request.query as Record<string, string | string[]> | undefined;\n    if (!query) return {};\n\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    const query = this.request.query as Record<string, string | string[]> | undefined;\n    if (!query) return undefined;\n    return query[name];\n  }\n\n  /**\n   * Gets the parsed request body.\n   * Fastify parses the body automatically.\n   *\n   * @returns The parsed request body\n   */\n  async getBody(): Promise<unknown> {\n    try {\n      return this.request.body;\n    } catch {\n      return undefined;\n    }\n  }\n}\n"],"mappings":"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","names":["t402ResourceServer","t402HTTPResourceServer","reply"]}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@t402/fastify",
+  "version": "2.0.0",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/index.d.ts",
+  "keywords": [
+    "t402",
+    "payment",
+    "protocol",
+    "fastify",
+    "middleware",
+    "usdt",
+    "usdt0"
+  ],
+  "license": "Apache-2.0",
+  "author": "T402 Team",
+  "repository": "https://github.com/t402-io/t402",
+  "description": "t402 Payment Protocol middleware for Fastify",
+  "devDependencies": {
+    "@eslint/js": "^9.24.0",
+    "@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",
+    "fastify": "^5.2.0",
+    "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": {
+    "zod": "^3.24.2",
+    "@t402/core": "^2.0.0",
+    "@t402/extensions": "^2.0.0"
+  },
+  "peerDependencies": {
+    "fastify": "^4.0.0 || ^5.0.0",
+    "@t402/paywall": "2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@t402/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": {
+    "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"
+  }
+}