@parallel-protocol/x402 0.7.1 → 0.8.1

package/dist/llm.d.cts

@@ -1,4 +1,4 @@
-import { m as PriceFunction, g as MeterFunction } from './types-q_gu5wjz.cjs';
+import { o as PriceFunction, j as MeterFunction } from './types-BkGQ2lPA.cjs';
 import 'viem';
 
 /**

package/dist/llm.d.ts

@@ -1,4 +1,4 @@
-import { m as PriceFunction, g as MeterFunction } from './types-q_gu5wjz.js';
+import { o as PriceFunction, j as MeterFunction } from './types-BkGQ2lPA.js';
 import 'viem';
 
 /**

package/dist/llm.js

@@ -1,4 +1,4 @@
-import { X402ConfigError, X402PriceRejectedError } from './chunk-AFRDHGDT.js';
+import { X402ConfigError, X402PriceRejectedError } from './chunk-QAECRSWF.js';
 
 // src/llm/estimate.ts
 function estimateTokens(text) {

package/dist/next.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkPOU7EH3E_cjs = require('./chunk-POU7EH3E.cjs');
-require('./chunk-JPMK5YBU.cjs');
+var chunkSNW5Z5HB_cjs = require('./chunk-SNW5Z5HB.cjs');
+require('./chunk-KZZY5LS6.cjs');
 var server = require('next/server');
 
 // src/next/adapter.ts
@@ -25,7 +25,7 @@ var NextAdapter = class {
   // Read from a clone: a request body is a stream that can be consumed once,
   // and the handler still needs the original.
   async getBody() {
-    if (!chunkPOU7EH3E_cjs.isJsonContentType(this.req.headers.get("content-type") ?? void 0))
+    if (!chunkSNW5Z5HB_cjs.isJsonContentType(this.req.headers.get("content-type") ?? void 0))
       return void 0;
     try {
       return await this.req.clone().json();
@@ -36,29 +36,27 @@ var NextAdapter = class {
 };
 
 // src/next/index.ts
+function fromResult(result) {
+  return new server.NextResponse(JSON.stringify(result.body), {
+    status: result.status,
+    headers: { "Content-Type": "application/json", ...result.headers }
+  });
+}
 function withPayment(config, handler) {
-  const gate = chunkPOU7EH3E_cjs.createPaymentGate(config);
+  const gate = chunkSNW5Z5HB_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"
-        }
-      });
-    }
+    if (gateResult.type === "error") return fromResult(gateResult.result);
     let response;
     try {
-      const outcome = await chunkPOU7EH3E_cjs.raceTimeout(
+      const outcome = await chunkSNW5Z5HB_cjs.raceTimeout(
         handler(req),
         gateResult.handlerTimeoutMs
       );
-      if (outcome === chunkPOU7EH3E_cjs.HANDLER_TIMEOUT) {
+      if (outcome === chunkSNW5Z5HB_cjs.HANDLER_TIMEOUT) {
         return new server.NextResponse(null, { status: 504 });
       }
       response = outcome;
@@ -67,10 +65,10 @@ function withPayment(config, handler) {
     }
     let raw;
     if (gateResult.scheme === "upto") {
-      raw = response.headers.get(chunkPOU7EH3E_cjs.SETTLE_AMOUNT_HEADER) ?? void 0;
+      raw = response.headers.get(chunkSNW5Z5HB_cjs.SETTLE_AMOUNT_HEADER) ?? void 0;
       if (raw !== void 0) {
         const headers = new Headers(response.headers);
-        headers.delete(chunkPOU7EH3E_cjs.SETTLE_AMOUNT_HEADER);
+        headers.delete(chunkSNW5Z5HB_cjs.SETTLE_AMOUNT_HEADER);
         response = new server.NextResponse(response.body, {
           status: response.status,
           headers
@@ -81,47 +79,33 @@ function withPayment(config, handler) {
       let settleOptions;
       if (gateResult.scheme === "upto") {
         const handled = response;
-        const resolved = await chunkPOU7EH3E_cjs.resolveCharge(gateResult, raw, {
+        const resolved = await chunkSNW5Z5HB_cjs.resolveCharge(gateResult, raw, {
           status: handled.status,
           header: (name) => handled.headers.get(name) ?? void 0,
           // Read from a clone: the body streams once, to the client.
-          body: () => chunkPOU7EH3E_cjs.jsonFromResponse(handled)
+          body: () => chunkSNW5Z5HB_cjs.jsonFromResponse(handled)
         });
         if (resolved.kind === "invalid") {
           handled.body?.cancel().catch(() => {
           });
-          return server.NextResponse.json(
-            chunkPOU7EH3E_cjs.invalidSettleAmountResponse(resolved.reason),
-            {
-              status: 402
-            }
-          );
+          return fromResult(chunkSNW5Z5HB_cjs.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", chunkPOU7EH3E_cjs.encodeBase64(settleResponse));
-          headers.set("access-control-expose-headers", "payment-response");
-          return new server.NextResponse(response.body, {
-            status: response.status,
-            headers
-          });
-        }
-      } catch {
+      const outcome = await chunkSNW5Z5HB_cjs.settleVerified(gateResult, settleOptions);
+      if (outcome.settled) {
+        const headers = new Headers(response.headers);
+        headers.set("payment-response", chunkSNW5Z5HB_cjs.encodeBase64(outcome.confirmation));
+        headers.set("access-control-expose-headers", "payment-response");
+        return new server.NextResponse(response.body, {
+          status: response.status,
+          headers
+        });
       }
       response.body?.cancel().catch(() => {
       });
-      return server.NextResponse.json(
-        {
-          error: "PAYMENT_SETTLEMENT_FAILED",
-          message: "Payment could not be confirmed after multiple attempts. Please retry."
-        },
-        { status: 402 }
-      );
+      return fromResult(chunkSNW5Z5HB_cjs.settlementFailureResponse(outcome));
     }
     return response;
   };

package/dist/next.d.cts

@@ -1,5 +1,5 @@
 import { NextRequest, NextResponse } from 'next/server';
-import { H as HTTPAdapter, P as PaymentMiddlewareConfig } from './types-q_gu5wjz.cjs';
+import { H as HTTPAdapter, P as PaymentMiddlewareConfig } from './types-BkGQ2lPA.cjs';
 import 'viem';
 
 declare class NextAdapter implements HTTPAdapter {

package/dist/next.d.ts

@@ -1,5 +1,5 @@
 import { NextRequest, NextResponse } from 'next/server';
-import { H as HTTPAdapter, P as PaymentMiddlewareConfig } from './types-q_gu5wjz.js';
+import { H as HTTPAdapter, P as PaymentMiddlewareConfig } from './types-BkGQ2lPA.js';
 import 'viem';
 
 declare class NextAdapter implements HTTPAdapter {

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-GXPUE3ES.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.1",
 	"description": "Parallel Protocol x402 payment middleware — Express, Next.js, Fastify, Hono",
 	"author": "Parallel Protocol <contact@parallel.best>",
 	"repository": {