@parallel-protocol/x402 0.5.0

package/dist/next.cjs

@@ -0,0 +1,81 @@
+'use strict';
+
+var chunkXUNNMCO5_cjs = require('./chunk-XUNNMCO5.cjs');
+var chunkW3SMR5LQ_cjs = require('./chunk-W3SMR5LQ.cjs');
+var server = require('next/server');
+
+// src/next/adapter.ts
+var NextAdapter = class {
+  constructor(req) {
+    this.req = req;
+  }
+  req;
+  getHeader(name) {
+    return this.req.headers.get(name) ?? void 0;
+  }
+  getMethod() {
+    return this.req.method;
+  }
+  getPath() {
+    return this.req.nextUrl.pathname;
+  }
+  getUrl() {
+    return this.req.url;
+  }
+};
+
+// src/next/index.ts
+function withPayment(config, handler) {
+  const gate = chunkW3SMR5LQ_cjs.createPaymentGate(config);
+  return async (req) => {
+    const gateResult = await gate(new NextAdapter(req));
+    if (gateResult.type === "pass") {
+      return handler(req);
+    }
+    if (gateResult.type === "error") {
+      return new server.NextResponse(JSON.stringify(gateResult.result.body), {
+        status: gateResult.result.status,
+        headers: {
+          ...gateResult.result.headers,
+          "Content-Type": "application/json"
+        }
+      });
+    }
+    let response;
+    try {
+      const outcome = await chunkXUNNMCO5_cjs.raceTimeout(handler(req));
+      if (outcome === chunkXUNNMCO5_cjs.HANDLER_TIMEOUT) {
+        return new server.NextResponse(null, { status: 504 });
+      }
+      response = outcome;
+    } catch {
+      return new server.NextResponse(null, { status: 504 });
+    }
+    if (response.status >= 200 && response.status < 300) {
+      try {
+        const settleResponse = await gateResult.settle();
+        if (settleResponse.success) {
+          const headers = new Headers(response.headers);
+          headers.set("payment-response", chunkW3SMR5LQ_cjs.encodeBase64(settleResponse));
+          headers.set("access-control-expose-headers", "payment-response");
+          return new server.NextResponse(response.body, {
+            status: response.status,
+            headers
+          });
+        }
+      } catch {
+      }
+      return server.NextResponse.json(
+        {
+          error: "PAYMENT_SETTLEMENT_FAILED",
+          message: "Payment could not be confirmed after multiple attempts. Please retry."
+        },
+        { status: 402 }
+      );
+    }
+    return response;
+  };
+}
+
+exports.NextAdapter = NextAdapter;
+exports.withPayment = withPayment;

package/dist/next.d.cts

@@ -0,0 +1,17 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { H as HTTPAdapter, P as PaymentMiddlewareConfig } from './types-CUi55YSx.cjs';
+import 'viem';
+
+declare class NextAdapter implements HTTPAdapter {
+    private readonly req;
+    constructor(req: NextRequest);
+    getHeader(name: string): string | undefined;
+    getMethod(): string;
+    getPath(): string;
+    getUrl(): string;
+}
+
+type NextHandler = (req: NextRequest) => Promise<NextResponse>;
+declare function withPayment(config: PaymentMiddlewareConfig, handler: NextHandler): NextHandler;
+
+export { NextAdapter, withPayment };

package/dist/next.d.ts

@@ -0,0 +1,17 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { H as HTTPAdapter, P as PaymentMiddlewareConfig } from './types-CUi55YSx.js';
+import 'viem';
+
+declare class NextAdapter implements HTTPAdapter {
+    private readonly req;
+    constructor(req: NextRequest);
+    getHeader(name: string): string | undefined;
+    getMethod(): string;
+    getPath(): string;
+    getUrl(): string;
+}
+
+type NextHandler = (req: NextRequest) => Promise<NextResponse>;
+declare function withPayment(config: PaymentMiddlewareConfig, handler: NextHandler): NextHandler;
+
+export { NextAdapter, withPayment };

package/dist/next.js

@@ -0,0 +1,78 @@
+import { raceTimeout, HANDLER_TIMEOUT } from './chunk-2UEAVMCH.js';
+import { createPaymentGate, encodeBase64 } from './chunk-FDQULXKG.js';
+import { NextResponse } from 'next/server';
+
+// src/next/adapter.ts
+var NextAdapter = class {
+  constructor(req) {
+    this.req = req;
+  }
+  req;
+  getHeader(name) {
+    return this.req.headers.get(name) ?? void 0;
+  }
+  getMethod() {
+    return this.req.method;
+  }
+  getPath() {
+    return this.req.nextUrl.pathname;
+  }
+  getUrl() {
+    return this.req.url;
+  }
+};
+
+// src/next/index.ts
+function withPayment(config, handler) {
+  const gate = createPaymentGate(config);
+  return async (req) => {
+    const gateResult = await gate(new NextAdapter(req));
+    if (gateResult.type === "pass") {
+      return handler(req);
+    }
+    if (gateResult.type === "error") {
+      return new NextResponse(JSON.stringify(gateResult.result.body), {
+        status: gateResult.result.status,
+        headers: {
+          ...gateResult.result.headers,
+          "Content-Type": "application/json"
+        }
+      });
+    }
+    let response;
+    try {
+      const outcome = await raceTimeout(handler(req));
+      if (outcome === HANDLER_TIMEOUT) {
+        return new NextResponse(null, { status: 504 });
+      }
+      response = outcome;
+    } catch {
+      return new NextResponse(null, { status: 504 });
+    }
+    if (response.status >= 200 && response.status < 300) {
+      try {
+        const settleResponse = await gateResult.settle();
+        if (settleResponse.success) {
+          const headers = new Headers(response.headers);
+          headers.set("payment-response", encodeBase64(settleResponse));
+          headers.set("access-control-expose-headers", "payment-response");
+          return new NextResponse(response.body, {
+            status: response.status,
+            headers
+          });
+        }
+      } catch {
+      }
+      return NextResponse.json(
+        {
+          error: "PAYMENT_SETTLEMENT_FAILED",
+          message: "Payment could not be confirmed after multiple attempts. Please retry."
+        },
+        { status: 402 }
+      );
+    }
+    return response;
+  };
+}
+
+export { NextAdapter, withPayment };

package/dist/types-CUi55YSx.d.cts

@@ -0,0 +1,95 @@
+import { Address } from 'viem';
+
+interface FacilitatorConfig {
+    url: string;
+    apiKey?: string;
+}
+interface RouteConfig {
+    price: string | bigint;
+    decimals?: number;
+    network: string;
+    payTo: Address;
+    acceptedTokens?: Address[];
+    description?: string;
+}
+interface PaymentMiddlewareConfig {
+    facilitator: FacilitatorConfig;
+    routes: Record<string, RouteConfig>;
+}
+interface RunHandlerResult {
+    status: number;
+    setResponseHeader(name: string, value: string): void;
+    sendResponse(): void;
+    discardResponse(): void;
+}
+interface HTTPAdapter {
+    getHeader(name: string): string | undefined;
+    getMethod(): string;
+    getPath(): string;
+    getUrl(): string;
+    runHandler?(): Promise<RunHandlerResult>;
+}
+interface ResourceInfo {
+    url: string;
+    description?: string;
+    mimeType?: string;
+}
+interface PaymentRequirements {
+    scheme: string;
+    network: string;
+    asset: string;
+    amount: string;
+    payTo: string;
+    maxTimeoutSeconds: number;
+    extra: Record<string, unknown>;
+}
+interface PaymentRequired {
+    x402Version: number;
+    error?: string;
+    resource: ResourceInfo;
+    accepts: PaymentRequirements[];
+    extensions?: Record<string, unknown>;
+}
+interface FacilitatorPaymentRequirements {
+    maxAmountRequired: string;
+    asset: string;
+    payTo: string;
+    network: string;
+}
+interface PaymentConfirmation {
+    success: true;
+    txHash: Address;
+    route: string;
+    chain: string;
+    gasSponsored: boolean;
+    networkId: string;
+}
+interface PaymentFailure {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+        hint?: string;
+    };
+}
+type FacilitatorResponse = PaymentConfirmation | PaymentFailure;
+interface MiddlewareResult {
+    status: number;
+    headers: Record<string, string>;
+    body: unknown;
+}
+interface PassResult {
+    pass: true;
+    handlerRan?: true;
+}
+type PaymentGateResult = {
+    type: "pass";
+} | {
+    type: "error";
+    result: MiddlewareResult;
+} | {
+    type: "verified";
+    settle(): Promise<FacilitatorResponse>;
+};
+
+export type { FacilitatorConfig as F, HTTPAdapter as H, MiddlewareResult as M, PaymentMiddlewareConfig as P, RunHandlerResult as R, FacilitatorPaymentRequirements as a, FacilitatorResponse as b, PaymentGateResult as c, PassResult as d, PaymentConfirmation as e, PaymentFailure as f, PaymentRequired as g, PaymentRequirements as h, ResourceInfo as i, RouteConfig as j };

package/dist/types-CUi55YSx.d.ts

@@ -0,0 +1,95 @@
+import { Address } from 'viem';
+
+interface FacilitatorConfig {
+    url: string;
+    apiKey?: string;
+}
+interface RouteConfig {
+    price: string | bigint;
+    decimals?: number;
+    network: string;
+    payTo: Address;
+    acceptedTokens?: Address[];
+    description?: string;
+}
+interface PaymentMiddlewareConfig {
+    facilitator: FacilitatorConfig;
+    routes: Record<string, RouteConfig>;
+}
+interface RunHandlerResult {
+    status: number;
+    setResponseHeader(name: string, value: string): void;
+    sendResponse(): void;
+    discardResponse(): void;
+}
+interface HTTPAdapter {
+    getHeader(name: string): string | undefined;
+    getMethod(): string;
+    getPath(): string;
+    getUrl(): string;
+    runHandler?(): Promise<RunHandlerResult>;
+}
+interface ResourceInfo {
+    url: string;
+    description?: string;
+    mimeType?: string;
+}
+interface PaymentRequirements {
+    scheme: string;
+    network: string;
+    asset: string;
+    amount: string;
+    payTo: string;
+    maxTimeoutSeconds: number;
+    extra: Record<string, unknown>;
+}
+interface PaymentRequired {
+    x402Version: number;
+    error?: string;
+    resource: ResourceInfo;
+    accepts: PaymentRequirements[];
+    extensions?: Record<string, unknown>;
+}
+interface FacilitatorPaymentRequirements {
+    maxAmountRequired: string;
+    asset: string;
+    payTo: string;
+    network: string;
+}
+interface PaymentConfirmation {
+    success: true;
+    txHash: Address;
+    route: string;
+    chain: string;
+    gasSponsored: boolean;
+    networkId: string;
+}
+interface PaymentFailure {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+        hint?: string;
+    };
+}
+type FacilitatorResponse = PaymentConfirmation | PaymentFailure;
+interface MiddlewareResult {
+    status: number;
+    headers: Record<string, string>;
+    body: unknown;
+}
+interface PassResult {
+    pass: true;
+    handlerRan?: true;
+}
+type PaymentGateResult = {
+    type: "pass";
+} | {
+    type: "error";
+    result: MiddlewareResult;
+} | {
+    type: "verified";
+    settle(): Promise<FacilitatorResponse>;
+};
+
+export type { FacilitatorConfig as F, HTTPAdapter as H, MiddlewareResult as M, PaymentMiddlewareConfig as P, RunHandlerResult as R, FacilitatorPaymentRequirements as a, FacilitatorResponse as b, PaymentGateResult as c, PassResult as d, PaymentConfirmation as e, PaymentFailure as f, PaymentRequired as g, PaymentRequirements as h, ResourceInfo as i, RouteConfig as j };

package/package.json

@@ -0,0 +1,145 @@
+{
+	"name": "@parallel-protocol/x402",
+	"version": "0.5.0",
+	"description": "Parallel Protocol x402 payment middleware — Express, Next.js, Fastify, Hono",
+	"author": "Parallel Protocol <contact@parallel.best>",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/parallel-protocol/sdk-merchant.git",
+		"directory": "packages/x402"
+	},
+	"homepage": "https://github.com/parallel-protocol/sdk-merchant",
+	"bugs": {
+		"url": "https://github.com/parallel-protocol/sdk-merchant/issues"
+	},
+	"license": "MIT",
+	"sideEffects": false,
+	"type": "module",
+	"main": "./dist/index.cjs",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"import": {
+				"types": "./dist/index.d.ts",
+				"default": "./dist/index.js"
+			},
+			"require": {
+				"types": "./dist/index.d.cts",
+				"default": "./dist/index.cjs"
+			}
+		},
+		"./express": {
+			"import": {
+				"types": "./dist/express.d.ts",
+				"default": "./dist/express.js"
+			},
+			"require": {
+				"types": "./dist/express.d.cts",
+				"default": "./dist/express.cjs"
+			}
+		},
+		"./next": {
+			"import": {
+				"types": "./dist/next.d.ts",
+				"default": "./dist/next.js"
+			},
+			"require": {
+				"types": "./dist/next.d.cts",
+				"default": "./dist/next.cjs"
+			}
+		},
+		"./fastify": {
+			"import": {
+				"types": "./dist/fastify.d.ts",
+				"default": "./dist/fastify.js"
+			},
+			"require": {
+				"types": "./dist/fastify.d.cts",
+				"default": "./dist/fastify.cjs"
+			}
+		},
+		"./hono": {
+			"import": {
+				"types": "./dist/hono.d.ts",
+				"default": "./dist/hono.js"
+			},
+			"require": {
+				"types": "./dist/hono.d.cts",
+				"default": "./dist/hono.cjs"
+			}
+		},
+		"./package.json": "./package.json"
+	},
+	"files": [
+		"dist",
+		"README.md",
+		"LICENSE"
+	],
+	"publishConfig": {
+		"registry": "https://registry.npmjs.org",
+		"access": "public"
+	},
+	"scripts": {
+		"build": "tsup",
+		"dev": "tsup --watch",
+		"clean": "rm -rf dist coverage",
+		"type-check": "tsc --noEmit",
+		"test": "vitest"
+	},
+	"peerDependencies": {
+		"viem": "^2.0.0",
+		"express": "^4.0.0 || ^5.0.0",
+		"next": "^14.0.0 || ^15.0.0",
+		"fastify": "^4.0.0 || ^5.0.0",
+		"hono": "^4.0.0"
+	},
+	"peerDependenciesMeta": {
+		"viem": {
+			"optional": true
+		},
+		"express": {
+			"optional": true
+		},
+		"next": {
+			"optional": true
+		},
+		"fastify": {
+			"optional": true
+		},
+		"hono": {
+			"optional": true
+		}
+	},
+	"devDependencies": {
+		"@types/express": "^5.0.1",
+		"@types/node": "^22.0.0",
+		"fastify": "^5.0.0",
+		"hono": "^4.0.0",
+		"next": "^15.0.0",
+		"tsup": "^8.0.0",
+		"typescript": "^5.9.0",
+		"viem": "^2.47.0",
+		"vitest": "^4.0.14"
+	},
+	"dependencies": {
+		"@parallel-protocol/chains": "^0.2.0",
+		"fastify-plugin": "^6.0.0",
+		"zod": "^4.4.3"
+	},
+	"keywords": [
+		"x402",
+		"402",
+		"agent-payments",
+		"stablecoin",
+		"middleware",
+		"express",
+		"fastify",
+		"hono",
+		"nextjs",
+		"parallel-protocol"
+	],
+	"engines": {
+		"node": ">=18"
+	}
+}