@parallel-protocol/x402 0.7.1 → 0.8.0

package/dist/next.js

@@ -1,5 +1,5 @@
-import { isJsonContentType, createPaymentGate, raceTimeout, HANDLER_TIMEOUT, SETTLE_AMOUNT_HEADER, resolveCharge, jsonFromResponse, invalidSettleAmountResponse, encodeBase64 } from './chunk-AENXD4OC.js';
-import './chunk-AFRDHGDT.js';
+import { isJsonContentType, createPaymentGate, raceTimeout, HANDLER_TIMEOUT, SETTLE_AMOUNT_HEADER, resolveCharge, jsonFromResponse, invalidSettleAmountResponse, settleVerified, encodeBase64, settlementFailureResponse } from './chunk-SA5ULSG2.js';
+import './chunk-QAECRSWF.js';
 import { NextResponse } from 'next/server';
 
 // src/next/adapter.ts
@@ -34,6 +34,12 @@ var NextAdapter = class {
 };
 
 // src/next/index.ts
+function fromResult(result) {
+  return new NextResponse(JSON.stringify(result.body), {
+    status: result.status,
+    headers: { "Content-Type": "application/json", ...result.headers }
+  });
+}
 function withPayment(config, handler) {
   const gate = createPaymentGate(config);
   return async (req) => {
@@ -41,15 +47,7 @@ function withPayment(config, handler) {
     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"
-        }
-      });
-    }
+    if (gateResult.type === "error") return fromResult(gateResult.result);
     let response;
     try {
       const outcome = await raceTimeout(
@@ -88,38 +86,24 @@ function withPayment(config, handler) {
         if (resolved.kind === "invalid") {
           handled.body?.cancel().catch(() => {
           });
-          return NextResponse.json(
-            invalidSettleAmountResponse(resolved.reason),
-            {
-              status: 402
-            }
-          );
+          return fromResult(invalidSettleAmountResponse(resolved.reason));
         }
         if (resolved.kind === "skip") return response;
         settleOptions = { amount: resolved.amount };
       }
-      try {
-        const settleResponse = settleOptions ? await gateResult.settle(settleOptions) : 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 {
+      const outcome = await settleVerified(gateResult, settleOptions);
+      if (outcome.settled) {
+        const headers = new Headers(response.headers);
+        headers.set("payment-response", encodeBase64(outcome.confirmation));
+        headers.set("access-control-expose-headers", "payment-response");
+        return new NextResponse(response.body, {
+          status: response.status,
+          headers
+        });
       }
       response.body?.cancel().catch(() => {
       });
-      return NextResponse.json(
-        {
-          error: "PAYMENT_SETTLEMENT_FAILED",
-          message: "Payment could not be confirmed after multiple attempts. Please retry."
-        },
-        { status: 402 }
-      );
+      return fromResult(settlementFailureResponse(outcome));
     }
     return response;
   };

package/dist/{types-q_gu5wjz.d.cts → types-BkGQ2lPA.d.cts}

@@ -117,6 +117,8 @@ interface PaymentRequirements {
 interface PaymentRequired {
     x402Version: number;
     error?: string;
+    /** The facilitator's message for `error`, when it answered with one. */
+    message?: string;
     resource: ResourceInfo;
     accepts: PaymentRequirements[];
     extensions?: Record<string, unknown>;
@@ -134,6 +136,24 @@ interface SettleOptions {
     /** Amount actually charged, in the asset's smallest unit. */
     amount?: string;
 }
+/**
+ * What `FacilitatorClient.settle` sends besides the payment: the metered
+ * amount, and the settle token the facilitator issued at verify. The payment
+ * gate fills the token in itself; a direct caller of the client passes the one
+ * `verify` returned.
+ */
+interface FacilitatorSettleOptions extends SettleOptions {
+    settleToken?: string;
+}
+/**
+ * What a successful `FacilitatorClient.verify` returns: the settle token the
+ * facilitator issued for this payment, to present back at settle. It is a
+ * secret for the life of the request: keep it in memory, never log it, never
+ * send it to the payer.
+ */
+interface VerifyResult {
+    settleToken: string;
+}
 interface PaymentConfirmation {
     success: true;
     txHash: Address;
@@ -143,6 +163,11 @@ interface PaymentConfirmation {
     networkId: string;
     /** Amount actually charged (smallest unit) — metered routes only. */
     amountSettled?: string;
+    /**
+     * Present when the facilitator answered from the outcome an earlier settle
+     * of the same payment recorded: this call broadcast nothing.
+     */
+    alreadySettled?: true;
 }
 interface PaymentFailure {
     success: false;
@@ -150,6 +175,10 @@ interface PaymentFailure {
         code: string;
         message: string;
         hint?: string;
+        /** The facilitator's HTTP status, when the refusal is its answer. */
+        status?: number;
+        /** The facilitator's `Retry-After` header, when it sent one. */
+        retryAfter?: string;
     };
 }
 type FacilitatorResponse = PaymentConfirmation | PaymentFailure;
@@ -182,4 +211,4 @@ type PaymentGateResult = {
     result: MiddlewareResult;
 } | VerifiedPayment;
 
-export type { FacilitatorConfig as F, HTTPAdapter as H, MiddlewareResult as M, PaymentMiddlewareConfig as P, RunHandlerOptions as R, SettleOptions as S, VerifiedPayment as V, RunHandlerResult as a, FacilitatorPaymentRequirements as b, FacilitatorResponse as c, PaymentGateResult as d, PassResult as e, MeterContext as f, MeterFunction as g, PaymentConfirmation as h, PaymentFailure as i, PaymentRequired as j, PaymentRequirements as k, PriceContext as l, PriceFunction as m, ResourceInfo as n, RouteConfig as o };
+export type { FacilitatorConfig as F, HTTPAdapter as H, MiddlewareResult as M, PaymentMiddlewareConfig as P, RunHandlerOptions as R, SettleOptions as S, VerifyResult as V, RunHandlerResult as a, FacilitatorPaymentRequirements as b, FacilitatorSettleOptions as c, FacilitatorResponse as d, PaymentConfirmation as e, PaymentGateResult as f, PassResult as g, VerifiedPayment as h, MeterContext as i, MeterFunction as j, PaymentFailure as k, PaymentRequired as l, PaymentRequirements as m, PriceContext as n, PriceFunction as o, ResourceInfo as p, RouteConfig as q };

package/dist/{types-q_gu5wjz.d.ts → types-BkGQ2lPA.d.ts}

@@ -117,6 +117,8 @@ interface PaymentRequirements {
 interface PaymentRequired {
     x402Version: number;
     error?: string;
+    /** The facilitator's message for `error`, when it answered with one. */
+    message?: string;
     resource: ResourceInfo;
     accepts: PaymentRequirements[];
     extensions?: Record<string, unknown>;
@@ -134,6 +136,24 @@ interface SettleOptions {
     /** Amount actually charged, in the asset's smallest unit. */
     amount?: string;
 }
+/**
+ * What `FacilitatorClient.settle` sends besides the payment: the metered
+ * amount, and the settle token the facilitator issued at verify. The payment
+ * gate fills the token in itself; a direct caller of the client passes the one
+ * `verify` returned.
+ */
+interface FacilitatorSettleOptions extends SettleOptions {
+    settleToken?: string;
+}
+/**
+ * What a successful `FacilitatorClient.verify` returns: the settle token the
+ * facilitator issued for this payment, to present back at settle. It is a
+ * secret for the life of the request: keep it in memory, never log it, never
+ * send it to the payer.
+ */
+interface VerifyResult {
+    settleToken: string;
+}
 interface PaymentConfirmation {
     success: true;
     txHash: Address;
@@ -143,6 +163,11 @@ interface PaymentConfirmation {
     networkId: string;
     /** Amount actually charged (smallest unit) — metered routes only. */
     amountSettled?: string;
+    /**
+     * Present when the facilitator answered from the outcome an earlier settle
+     * of the same payment recorded: this call broadcast nothing.
+     */
+    alreadySettled?: true;
 }
 interface PaymentFailure {
     success: false;
@@ -150,6 +175,10 @@ interface PaymentFailure {
         code: string;
         message: string;
         hint?: string;
+        /** The facilitator's HTTP status, when the refusal is its answer. */
+        status?: number;
+        /** The facilitator's `Retry-After` header, when it sent one. */
+        retryAfter?: string;
     };
 }
 type FacilitatorResponse = PaymentConfirmation | PaymentFailure;
@@ -182,4 +211,4 @@ type PaymentGateResult = {
     result: MiddlewareResult;
 } | VerifiedPayment;
 
-export type { FacilitatorConfig as F, HTTPAdapter as H, MiddlewareResult as M, PaymentMiddlewareConfig as P, RunHandlerOptions as R, SettleOptions as S, VerifiedPayment as V, RunHandlerResult as a, FacilitatorPaymentRequirements as b, FacilitatorResponse as c, PaymentGateResult as d, PassResult as e, MeterContext as f, MeterFunction as g, PaymentConfirmation as h, PaymentFailure as i, PaymentRequired as j, PaymentRequirements as k, PriceContext as l, PriceFunction as m, ResourceInfo as n, RouteConfig as o };
+export type { FacilitatorConfig as F, HTTPAdapter as H, MiddlewareResult as M, PaymentMiddlewareConfig as P, RunHandlerOptions as R, SettleOptions as S, VerifyResult as V, RunHandlerResult as a, FacilitatorPaymentRequirements as b, FacilitatorSettleOptions as c, FacilitatorResponse as d, PaymentConfirmation as e, PaymentGateResult as f, PassResult as g, VerifiedPayment as h, MeterContext as i, MeterFunction as j, PaymentFailure as k, PaymentRequired as l, PaymentRequirements as m, PriceContext as n, PriceFunction as o, ResourceInfo as p, RouteConfig as q };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@parallel-protocol/x402",
-	"version": "0.7.1",
+	"version": "0.8.0",
 	"description": "Parallel Protocol x402 payment middleware — Express, Next.js, Fastify, Hono",
 	"author": "Parallel Protocol <contact@parallel.best>",
 	"repository": {