@parallel-protocol/x402 0.9.0 → 0.10.1

package/dist/hono.js

@@ -1,5 +1,5 @@
-import { isJsonContentType, raceTimeout, HANDLER_TIMEOUT, jsonFromResponse, createPaymentMiddleware } from './chunk-G7HSURPM.js';
-import './chunk-QAECRSWF.js';
+import { isJsonContentType, raceTimeout, HANDLER_TIMEOUT, jsonFromResponse, createPaymentMiddleware, preflightInit } from './chunk-CNASNROQ.js';
+import './chunk-MZCHBBUN.js';
 
 // src/hono/adapter.ts
 var TIMEOUT_BODY = JSON.stringify({
@@ -36,6 +36,13 @@ var HonoAdapter = class {
     }
   }
   async runHandler(options) {
+    const headersBefore = new Headers(this.c.res.headers);
+    const replace = (body, status) => {
+      const headers = new Headers(headersBefore);
+      if (body !== null) headers.set("Content-Type", "application/json");
+      this.c.res = void 0;
+      this.c.res = new Response(body, { status, headers });
+    };
     const outcome = await raceTimeout(this.next(), options?.timeoutMs);
     if (outcome === HANDLER_TIMEOUT) {
       return {
@@ -45,12 +52,7 @@ var HonoAdapter = class {
         getResponseHeader: () => void 0,
         removeResponseHeader: () => {
         },
-        sendResponse: () => {
-          this.c.res = new Response(TIMEOUT_BODY, {
-            status: 504,
-            headers: { "Content-Type": "application/json" }
-          });
-        },
+        sendResponse: () => replace(TIMEOUT_BODY, 504),
         discardResponse: () => {
         }
       };
@@ -70,6 +72,7 @@ var HonoAdapter = class {
       discardResponse: () => {
         res.body?.cancel().catch(() => {
         });
+        replace(null);
       }
     };
   }
@@ -83,9 +86,14 @@ function paymentMiddleware(config) {
     if ("pass" in result) {
       if (result.handlerRan) return;
       await next();
+      if (result.preflight) {
+        const init = preflightInit(c.res);
+        c.res = void 0;
+        c.res = new Response(null, init);
+      }
       return;
     }
-    return new Response(JSON.stringify(result.body), {
+    c.res = new Response(JSON.stringify(result.body), {
       status: result.status,
       headers: { ...result.headers, "Content-Type": "application/json" }
     });

package/dist/index.cjs

@@ -1,83 +1,87 @@
 'use strict';
 
-var chunkTH77IB3T_cjs = require('./chunk-TH77IB3T.cjs');
-var chunkKZZY5LS6_cjs = require('./chunk-KZZY5LS6.cjs');
+var chunkAYMDIX7A_cjs = require('./chunk-AYMDIX7A.cjs');
+var chunk4CEMNRCZ_cjs = require('./chunk-4CEMNRCZ.cjs');
 
 
 
 Object.defineProperty(exports, "FacilitatorClient", {
   enumerable: true,
-  get: function () { return chunkTH77IB3T_cjs.FacilitatorClient; }
+  get: function () { return chunkAYMDIX7A_cjs.FacilitatorClient; }
 });
 Object.defineProperty(exports, "PARALLEL_TOKENS", {
   enumerable: true,
-  get: function () { return chunkTH77IB3T_cjs.PARALLEL_TOKENS; }
+  get: function () { return chunkAYMDIX7A_cjs.PARALLEL_TOKENS; }
 });
 Object.defineProperty(exports, "SETTLE_AMOUNT_HEADER", {
   enumerable: true,
-  get: function () { return chunkTH77IB3T_cjs.SETTLE_AMOUNT_HEADER; }
+  get: function () { return chunkAYMDIX7A_cjs.SETTLE_AMOUNT_HEADER; }
 });
 Object.defineProperty(exports, "createPaymentGate", {
   enumerable: true,
-  get: function () { return chunkTH77IB3T_cjs.createPaymentGate; }
+  get: function () { return chunkAYMDIX7A_cjs.createPaymentGate; }
 });
 Object.defineProperty(exports, "createPaymentMiddleware", {
   enumerable: true,
-  get: function () { return chunkTH77IB3T_cjs.createPaymentMiddleware; }
+  get: function () { return chunkAYMDIX7A_cjs.createPaymentMiddleware; }
 });
 Object.defineProperty(exports, "encodeBase64", {
   enumerable: true,
-  get: function () { return chunkTH77IB3T_cjs.encodeBase64; }
+  get: function () { return chunkAYMDIX7A_cjs.encodeBase64; }
 });
 Object.defineProperty(exports, "getDefaultAcceptedTokens", {
   enumerable: true,
-  get: function () { return chunkTH77IB3T_cjs.getDefaultAcceptedTokens; }
+  get: function () { return chunkAYMDIX7A_cjs.getDefaultAcceptedTokens; }
+});
+Object.defineProperty(exports, "normalizeRoutePath", {
+  enumerable: true,
+  get: function () { return chunkAYMDIX7A_cjs.normalizeRoutePath; }
 });
 Object.defineProperty(exports, "parsePrice", {
   enumerable: true,
-  get: function () { return chunkTH77IB3T_cjs.parsePrice; }
+  get: function () { return chunkAYMDIX7A_cjs.parsePrice; }
 });
 Object.defineProperty(exports, "resolveCharge", {
   enumerable: true,
-  get: function () { return chunkTH77IB3T_cjs.resolveCharge; }
+  get: function () { return chunkAYMDIX7A_cjs.resolveCharge; }
 });
 Object.defineProperty(exports, "resolveSettleAmount", {
   enumerable: true,
-  get: function () { return chunkTH77IB3T_cjs.resolveSettleAmount; }
+  get: function () { return chunkAYMDIX7A_cjs.resolveSettleAmount; }
 });
 Object.defineProperty(exports, "settleVerified", {
   enumerable: true,
-  get: function () { return chunkTH77IB3T_cjs.settleVerified; }
+  get: function () { return chunkAYMDIX7A_cjs.settleVerified; }
 });
 Object.defineProperty(exports, "settlementFailureResponse", {
   enumerable: true,
-  get: function () { return chunkTH77IB3T_cjs.settlementFailureResponse; }
+  get: function () { return chunkAYMDIX7A_cjs.settlementFailureResponse; }
 });
 Object.defineProperty(exports, "toEip155Network", {
   enumerable: true,
-  get: function () { return chunkTH77IB3T_cjs.toEip155Network; }
+  get: function () { return chunkAYMDIX7A_cjs.toEip155Network; }
 });
 Object.defineProperty(exports, "validateAddress", {
   enumerable: true,
-  get: function () { return chunkTH77IB3T_cjs.validateAddress; }
+  get: function () { return chunkAYMDIX7A_cjs.validateAddress; }
 });
 Object.defineProperty(exports, "X402ConfigError", {
   enumerable: true,
-  get: function () { return chunkKZZY5LS6_cjs.X402ConfigError; }
+  get: function () { return chunk4CEMNRCZ_cjs.X402ConfigError; }
 });
 Object.defineProperty(exports, "X402PriceRejectedError", {
   enumerable: true,
-  get: function () { return chunkKZZY5LS6_cjs.X402PriceRejectedError; }
+  get: function () { return chunk4CEMNRCZ_cjs.X402PriceRejectedError; }
 });
 Object.defineProperty(exports, "X402RuntimeError", {
   enumerable: true,
-  get: function () { return chunkKZZY5LS6_cjs.X402RuntimeError; }
+  get: function () { return chunk4CEMNRCZ_cjs.X402RuntimeError; }
 });
 Object.defineProperty(exports, "X402_ERROR_CODES", {
   enumerable: true,
-  get: function () { return chunkKZZY5LS6_cjs.X402_ERROR_CODES; }
+  get: function () { return chunk4CEMNRCZ_cjs.X402_ERROR_CODES; }
 });
 Object.defineProperty(exports, "isPriceRejection", {
   enumerable: true,
-  get: function () { return chunkKZZY5LS6_cjs.isPriceRejection; }
+  get: function () { return chunk4CEMNRCZ_cjs.isPriceRejection; }
 });

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { F as FacilitatorConfig, b as FacilitatorPaymentRequirements, V as VerifyResult, c as FacilitatorSettleOptions, d as FacilitatorResponse, e as PaymentConfirmation, P as PaymentMiddlewareConfig, H as HTTPAdapter, f as PaymentGateResult, M as MiddlewareResult, g as PassResult, h as VerifiedPayment, S as SettleOptions } from './types-BkGQ2lPA.cjs';
-export { i as MeterContext, j as MeterFunction, k as PaymentFailure, l as PaymentRequired, m as PaymentRequirements, n as PriceContext, o as PriceFunction, p as ResourceInfo, q as RouteConfig, R as RunHandlerOptions, a as RunHandlerResult } from './types-BkGQ2lPA.cjs';
+import { F as FacilitatorConfig, b as FacilitatorPaymentRequirements, V as VerifyResult, c as FacilitatorSettleOptions, d as FacilitatorResponse, e as PaymentConfirmation, P as PaymentMiddlewareConfig, H as HTTPAdapter, f as PaymentGateResult, M as MiddlewareResult, g as PassResult, h as VerifiedPayment, S as SettleOptions } from './types-CRBMTQaq.cjs';
+export { i as MeterContext, j as MeterFunction, k as PaymentFailure, l as PaymentRequired, m as PaymentRequirements, n as PriceContext, o as PriceFunction, p as ResourceInfo, q as RouteConfig, R as RunHandlerOptions, a as RunHandlerResult } from './types-CRBMTQaq.cjs';
 import { Address } from 'viem';
 
 declare class FacilitatorClient {
@@ -20,6 +20,8 @@ declare const X402_ERROR_CODES: {
     readonly FACILITATOR_UNAVAILABLE: "FACILITATOR_UNAVAILABLE";
     readonly FACILITATOR_INVALID_RESPONSE: "FACILITATOR_INVALID_RESPONSE";
     readonly INVALID_PAYMENT: "INVALID_PAYMENT";
+    /** A path with `.` or `..` segments on a paid route, refused with 400. */
+    readonly INVALID_PATH: "INVALID_PATH";
     /** The facilitator did not answer a settle within the client's timeout: the payment may still settle. */
     readonly SETTLE_TIMEOUT: "SETTLE_TIMEOUT";
 };
@@ -59,7 +61,7 @@ declare class X402PriceRejectedError extends Error {
  */
 declare function isPriceRejection(error: unknown): error is X402PriceRejectedError;
 
-type GateAdapter = Pick<HTTPAdapter, "getHeader" | "getPath" | "getUrl" | "getMethod" | "getBody">;
+type GateAdapter = Pick<HTTPAdapter, "getHeader" | "getPath" | "getFullPath" | "getUrl" | "getMethod" | "getBody">;
 /**
  * Response header a handler on a metered (`upto`) route sets to the amount it
  * actually charges, in whole token units like `price` ("0.75"). Read and
@@ -156,5 +158,7 @@ declare function parsePrice(price: string | bigint, decimals?: number): bigint;
 declare function validateAddress(address: string): address is Address;
 declare function toEip155Network(network: string): string;
 declare function encodeBase64(obj: unknown): string;
+/** The form routes are matched on: `"/API//Data/"` becomes `"/api/data"`. */
+declare function normalizeRoutePath(path: string): string;
 
-export { type ChargeResponse, FacilitatorClient, FacilitatorConfig, FacilitatorPaymentRequirements, FacilitatorResponse, FacilitatorSettleOptions, HTTPAdapter, MiddlewareResult, PARALLEL_TOKENS, type ParallelNetwork, PassResult, PaymentConfirmation, PaymentGateResult, PaymentMiddlewareConfig, SETTLE_AMOUNT_HEADER, type SettleAmountResolution, SettleOptions, type SettlementFailure, type SettlementFailureBody, type SettlementOutcome, VerifiedPayment, VerifyResult, X402ConfigError, type X402ErrorCode, X402PriceRejectedError, X402RuntimeError, X402_ERROR_CODES, createPaymentGate, createPaymentMiddleware, encodeBase64, getDefaultAcceptedTokens, isPriceRejection, parsePrice, resolveCharge, resolveSettleAmount, settleVerified, settlementFailureResponse, toEip155Network, validateAddress };
+export { type ChargeResponse, FacilitatorClient, FacilitatorConfig, FacilitatorPaymentRequirements, FacilitatorResponse, FacilitatorSettleOptions, HTTPAdapter, MiddlewareResult, PARALLEL_TOKENS, type ParallelNetwork, PassResult, PaymentConfirmation, PaymentGateResult, PaymentMiddlewareConfig, SETTLE_AMOUNT_HEADER, type SettleAmountResolution, SettleOptions, type SettlementFailure, type SettlementFailureBody, type SettlementOutcome, VerifiedPayment, VerifyResult, X402ConfigError, type X402ErrorCode, X402PriceRejectedError, X402RuntimeError, X402_ERROR_CODES, createPaymentGate, createPaymentMiddleware, encodeBase64, getDefaultAcceptedTokens, isPriceRejection, normalizeRoutePath, parsePrice, resolveCharge, resolveSettleAmount, settleVerified, settlementFailureResponse, toEip155Network, validateAddress };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FacilitatorConfig, b as FacilitatorPaymentRequirements, V as VerifyResult, c as FacilitatorSettleOptions, d as FacilitatorResponse, e as PaymentConfirmation, P as PaymentMiddlewareConfig, H as HTTPAdapter, f as PaymentGateResult, M as MiddlewareResult, g as PassResult, h as VerifiedPayment, S as SettleOptions } from './types-BkGQ2lPA.js';
-export { i as MeterContext, j as MeterFunction, k as PaymentFailure, l as PaymentRequired, m as PaymentRequirements, n as PriceContext, o as PriceFunction, p as ResourceInfo, q as RouteConfig, R as RunHandlerOptions, a as RunHandlerResult } from './types-BkGQ2lPA.js';
+import { F as FacilitatorConfig, b as FacilitatorPaymentRequirements, V as VerifyResult, c as FacilitatorSettleOptions, d as FacilitatorResponse, e as PaymentConfirmation, P as PaymentMiddlewareConfig, H as HTTPAdapter, f as PaymentGateResult, M as MiddlewareResult, g as PassResult, h as VerifiedPayment, S as SettleOptions } from './types-CRBMTQaq.js';
+export { i as MeterContext, j as MeterFunction, k as PaymentFailure, l as PaymentRequired, m as PaymentRequirements, n as PriceContext, o as PriceFunction, p as ResourceInfo, q as RouteConfig, R as RunHandlerOptions, a as RunHandlerResult } from './types-CRBMTQaq.js';
 import { Address } from 'viem';
 
 declare class FacilitatorClient {
@@ -20,6 +20,8 @@ declare const X402_ERROR_CODES: {
     readonly FACILITATOR_UNAVAILABLE: "FACILITATOR_UNAVAILABLE";
     readonly FACILITATOR_INVALID_RESPONSE: "FACILITATOR_INVALID_RESPONSE";
     readonly INVALID_PAYMENT: "INVALID_PAYMENT";
+    /** A path with `.` or `..` segments on a paid route, refused with 400. */
+    readonly INVALID_PATH: "INVALID_PATH";
     /** The facilitator did not answer a settle within the client's timeout: the payment may still settle. */
     readonly SETTLE_TIMEOUT: "SETTLE_TIMEOUT";
 };
@@ -59,7 +61,7 @@ declare class X402PriceRejectedError extends Error {
  */
 declare function isPriceRejection(error: unknown): error is X402PriceRejectedError;
 
-type GateAdapter = Pick<HTTPAdapter, "getHeader" | "getPath" | "getUrl" | "getMethod" | "getBody">;
+type GateAdapter = Pick<HTTPAdapter, "getHeader" | "getPath" | "getFullPath" | "getUrl" | "getMethod" | "getBody">;
 /**
  * Response header a handler on a metered (`upto`) route sets to the amount it
  * actually charges, in whole token units like `price` ("0.75"). Read and
@@ -156,5 +158,7 @@ declare function parsePrice(price: string | bigint, decimals?: number): bigint;
 declare function validateAddress(address: string): address is Address;
 declare function toEip155Network(network: string): string;
 declare function encodeBase64(obj: unknown): string;
+/** The form routes are matched on: `"/API//Data/"` becomes `"/api/data"`. */
+declare function normalizeRoutePath(path: string): string;
 
-export { type ChargeResponse, FacilitatorClient, FacilitatorConfig, FacilitatorPaymentRequirements, FacilitatorResponse, FacilitatorSettleOptions, HTTPAdapter, MiddlewareResult, PARALLEL_TOKENS, type ParallelNetwork, PassResult, PaymentConfirmation, PaymentGateResult, PaymentMiddlewareConfig, SETTLE_AMOUNT_HEADER, type SettleAmountResolution, SettleOptions, type SettlementFailure, type SettlementFailureBody, type SettlementOutcome, VerifiedPayment, VerifyResult, X402ConfigError, type X402ErrorCode, X402PriceRejectedError, X402RuntimeError, X402_ERROR_CODES, createPaymentGate, createPaymentMiddleware, encodeBase64, getDefaultAcceptedTokens, isPriceRejection, parsePrice, resolveCharge, resolveSettleAmount, settleVerified, settlementFailureResponse, toEip155Network, validateAddress };
+export { type ChargeResponse, FacilitatorClient, FacilitatorConfig, FacilitatorPaymentRequirements, FacilitatorResponse, FacilitatorSettleOptions, HTTPAdapter, MiddlewareResult, PARALLEL_TOKENS, type ParallelNetwork, PassResult, PaymentConfirmation, PaymentGateResult, PaymentMiddlewareConfig, SETTLE_AMOUNT_HEADER, type SettleAmountResolution, SettleOptions, type SettlementFailure, type SettlementFailureBody, type SettlementOutcome, VerifiedPayment, VerifyResult, X402ConfigError, type X402ErrorCode, X402PriceRejectedError, X402RuntimeError, X402_ERROR_CODES, createPaymentGate, createPaymentMiddleware, encodeBase64, getDefaultAcceptedTokens, isPriceRejection, normalizeRoutePath, parsePrice, resolveCharge, resolveSettleAmount, settleVerified, settlementFailureResponse, toEip155Network, validateAddress };

package/dist/index.js

@@ -1,2 +1,2 @@
-export { FacilitatorClient, PARALLEL_TOKENS, SETTLE_AMOUNT_HEADER, createPaymentGate, createPaymentMiddleware, encodeBase64, getDefaultAcceptedTokens, parsePrice, resolveCharge, resolveSettleAmount, settleVerified, settlementFailureResponse, toEip155Network, validateAddress } from './chunk-G7HSURPM.js';
-export { X402ConfigError, X402PriceRejectedError, X402RuntimeError, X402_ERROR_CODES, isPriceRejection } from './chunk-QAECRSWF.js';
+export { FacilitatorClient, PARALLEL_TOKENS, SETTLE_AMOUNT_HEADER, createPaymentGate, createPaymentMiddleware, encodeBase64, getDefaultAcceptedTokens, normalizeRoutePath, parsePrice, resolveCharge, resolveSettleAmount, settleVerified, settlementFailureResponse, toEip155Network, validateAddress } from './chunk-CNASNROQ.js';
+export { X402ConfigError, X402PriceRejectedError, X402RuntimeError, X402_ERROR_CODES, isPriceRejection } from './chunk-MZCHBBUN.js';

package/dist/llm.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkKZZY5LS6_cjs = require('./chunk-KZZY5LS6.cjs');
+var chunk4CEMNRCZ_cjs = require('./chunk-4CEMNRCZ.cjs');
 
 // src/llm/estimate.ts
 function estimateTokens(text) {
@@ -71,7 +71,7 @@ function lookup(table, model) {
 function staticPrices(table) {
   for (const [model, price] of Object.entries(table)) {
     if (!isValidPrice(price)) {
-      throw new chunkKZZY5LS6_cjs.X402ConfigError(
+      throw new chunk4CEMNRCZ_cjs.X402ConfigError(
         `Invalid price for model "${model}": expected { input, output } in USD per million tokens`
       );
     }
@@ -106,13 +106,13 @@ function shortName(value) {
 function parseDuration(value) {
   if (typeof value === "number") {
     if (!Number.isFinite(value) || value < 0) {
-      throw new chunkKZZY5LS6_cjs.X402ConfigError(`Invalid duration: ${value}`);
+      throw new chunk4CEMNRCZ_cjs.X402ConfigError(`Invalid duration: ${value}`);
     }
     return value;
   }
   const match = value.trim().match(/^(\d+(?:\.\d+)?)\s*(ms|s|m|h|d)$/i);
   if (!match) {
-    throw new chunkKZZY5LS6_cjs.X402ConfigError(
+    throw new chunk4CEMNRCZ_cjs.X402ConfigError(
       `Invalid duration "${value}": expected a number of milliseconds or a value like "24h", "30m", "10s"`
     );
   }
@@ -180,7 +180,7 @@ function openRouterPrices(options = {}) {
         if (canRetry()) await load().catch(() => {
         });
         if (!table) {
-          throw new chunkKZZY5LS6_cjs.X402PriceRejectedError(
+          throw new chunk4CEMNRCZ_cjs.X402PriceRejectedError(
             "PRICING_UNAVAILABLE",
             "Model prices are not available right now, retry shortly",
             503
@@ -197,7 +197,7 @@ function openRouterPrices(options = {}) {
         });
       }
       if (inflight) {
-        throw new chunkKZZY5LS6_cjs.X402PriceRejectedError(
+        throw new chunk4CEMNRCZ_cjs.X402PriceRejectedError(
           "UNKNOWN_MODEL",
           `No price known for model "${shortName(model)}" yet. The price list is being refreshed, retry in a few seconds.`
         );
@@ -210,7 +210,7 @@ function openRouterPrices(options = {}) {
 // src/llm/cap.ts
 var DEFAULT_MARGIN = 0;
 function reject(code, message) {
-  throw new chunkKZZY5LS6_cjs.X402PriceRejectedError(code, message);
+  throw new chunk4CEMNRCZ_cjs.X402PriceRejectedError(code, message);
 }
 function isTextOnly(modalities) {
   return Array.isArray(modalities) && modalities.every((modality) => modality === "text");
@@ -222,17 +222,17 @@ function chatCompletionCap(options) {
   const allowed = options.models ? new Set(options.models) : void 0;
   const estimate = options.estimateInputTokens ?? estimateInputTokens;
   if (positiveInteger(maxOutputTokens) === void 0) {
-    throw new chunkKZZY5LS6_cjs.X402ConfigError(
+    throw new chunk4CEMNRCZ_cjs.X402ConfigError(
       `chatCompletionCap: maxOutputTokens must be a positive integer, got ${maxOutputTokens}`
     );
   }
   if (!Number.isFinite(margin) || margin < 0) {
-    throw new chunkKZZY5LS6_cjs.X402ConfigError(
+    throw new chunk4CEMNRCZ_cjs.X402ConfigError(
       `chatCompletionCap: margin must be a non-negative number, got ${margin}`
     );
   }
   if (allowed?.size === 0) {
-    throw new chunkKZZY5LS6_cjs.X402ConfigError("chatCompletionCap: models must not be empty");
+    throw new chunk4CEMNRCZ_cjs.X402ConfigError("chatCompletionCap: models must not be empty");
   }
   return async (ctx) => {
     const raw = ctx.body;
@@ -295,7 +295,7 @@ function chatCompletionCap(options) {
       reject("UNKNOWN_MODEL", `No price known for model "${shortName(model)}"`);
     }
     if (!isValidPrice(price)) {
-      throw new chunkKZZY5LS6_cjs.X402ConfigError(
+      throw new chunk4CEMNRCZ_cjs.X402ConfigError(
         `chatCompletionCap: the price source returned an invalid price for model "${shortName(model)}"`
       );
     }
@@ -343,13 +343,13 @@ var failure = (status, error, message) => ({
 });
 async function forwardChatCompletion(body, options) {
   if (typeof options.baseUrl !== "string" || !URL.canParse(options.baseUrl)) {
-    throw new chunkKZZY5LS6_cjs.X402ConfigError(
+    throw new chunk4CEMNRCZ_cjs.X402ConfigError(
       `forwardChatCompletion: baseUrl must be a URL, got ${JSON.stringify(options.baseUrl)}`
     );
   }
   const maxOutputTokens = options.maxOutputTokens ?? DEFAULT_MAX_OUTPUT_TOKENS;
   if (positiveInteger(maxOutputTokens) === void 0) {
-    throw new chunkKZZY5LS6_cjs.X402ConfigError(
+    throw new chunk4CEMNRCZ_cjs.X402ConfigError(
       `forwardChatCompletion: maxOutputTokens must be a positive integer, got ${maxOutputTokens}`
     );
   }

package/dist/llm.d.cts

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

package/dist/llm.d.ts

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

package/dist/llm.js

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

package/dist/next.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkTH77IB3T_cjs = require('./chunk-TH77IB3T.cjs');
-require('./chunk-KZZY5LS6.cjs');
+var chunkAYMDIX7A_cjs = require('./chunk-AYMDIX7A.cjs');
+require('./chunk-4CEMNRCZ.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 (!chunkTH77IB3T_cjs.isJsonContentType(this.req.headers.get("content-type") ?? void 0))
+    if (!chunkAYMDIX7A_cjs.isJsonContentType(this.req.headers.get("content-type") ?? void 0))
       return void 0;
     try {
       return await this.req.clone().json();
@@ -43,20 +43,21 @@ function fromResult(result) {
   });
 }
 function withPayment(config, handler) {
-  const gate = chunkTH77IB3T_cjs.createPaymentGate(config);
+  const gate = chunkAYMDIX7A_cjs.createPaymentGate(config);
   return async (req) => {
     const gateResult = await gate(new NextAdapter(req));
     if (gateResult.type === "pass") {
-      return handler(req);
+      if (!gateResult.preflight) return handler(req);
+      return new server.NextResponse(null, { status: 204 });
     }
     if (gateResult.type === "error") return fromResult(gateResult.result);
     let response;
     try {
-      const outcome = await chunkTH77IB3T_cjs.raceTimeout(
+      const outcome = await chunkAYMDIX7A_cjs.raceTimeout(
         handler(req),
         gateResult.handlerTimeoutMs
       );
-      if (outcome === chunkTH77IB3T_cjs.HANDLER_TIMEOUT) {
+      if (outcome === chunkAYMDIX7A_cjs.HANDLER_TIMEOUT) {
         return new server.NextResponse(null, { status: 504 });
       }
       response = outcome;
@@ -65,10 +66,10 @@ function withPayment(config, handler) {
     }
     let raw;
     if (gateResult.scheme === "upto") {
-      raw = response.headers.get(chunkTH77IB3T_cjs.SETTLE_AMOUNT_HEADER) ?? void 0;
+      raw = response.headers.get(chunkAYMDIX7A_cjs.SETTLE_AMOUNT_HEADER) ?? void 0;
       if (raw !== void 0) {
         const headers = new Headers(response.headers);
-        headers.delete(chunkTH77IB3T_cjs.SETTLE_AMOUNT_HEADER);
+        headers.delete(chunkAYMDIX7A_cjs.SETTLE_AMOUNT_HEADER);
         response = new server.NextResponse(response.body, {
           status: response.status,
           headers
@@ -79,24 +80,24 @@ function withPayment(config, handler) {
       let settleOptions;
       if (gateResult.scheme === "upto") {
         const handled = response;
-        const resolved = await chunkTH77IB3T_cjs.resolveCharge(gateResult, raw, {
+        const resolved = await chunkAYMDIX7A_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: () => chunkTH77IB3T_cjs.jsonFromResponse(handled)
+          body: () => chunkAYMDIX7A_cjs.jsonFromResponse(handled)
         });
         if (resolved.kind === "invalid") {
           handled.body?.cancel().catch(() => {
           });
-          return fromResult(chunkTH77IB3T_cjs.invalidSettleAmountResponse(resolved.reason));
+          return fromResult(chunkAYMDIX7A_cjs.invalidSettleAmountResponse(resolved.reason));
         }
         if (resolved.kind === "skip") return response;
         settleOptions = { amount: resolved.amount };
       }
-      const outcome = await chunkTH77IB3T_cjs.settleVerified(gateResult, settleOptions);
+      const outcome = await chunkAYMDIX7A_cjs.settleVerified(gateResult, settleOptions);
       if (outcome.settled) {
         const headers = new Headers(response.headers);
-        headers.set("payment-response", chunkTH77IB3T_cjs.encodeBase64(outcome.confirmation));
+        headers.set("payment-response", chunkAYMDIX7A_cjs.encodeBase64(outcome.confirmation));
         headers.set("access-control-expose-headers", "payment-response");
         return new server.NextResponse(response.body, {
           status: response.status,
@@ -105,7 +106,7 @@ function withPayment(config, handler) {
       }
       response.body?.cancel().catch(() => {
       });
-      return fromResult(chunkTH77IB3T_cjs.settlementFailureResponse(outcome));
+      return fromResult(chunkAYMDIX7A_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-BkGQ2lPA.cjs';
+import { H as HTTPAdapter, P as PaymentMiddlewareConfig } from './types-CRBMTQaq.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-BkGQ2lPA.js';
+import { H as HTTPAdapter, P as PaymentMiddlewareConfig } from './types-CRBMTQaq.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, settleVerified, encodeBase64, settlementFailureResponse } from './chunk-G7HSURPM.js';
-import './chunk-QAECRSWF.js';
+import { isJsonContentType, createPaymentGate, raceTimeout, HANDLER_TIMEOUT, SETTLE_AMOUNT_HEADER, resolveCharge, jsonFromResponse, invalidSettleAmountResponse, settleVerified, encodeBase64, settlementFailureResponse } from './chunk-CNASNROQ.js';
+import './chunk-MZCHBBUN.js';
 import { NextResponse } from 'next/server';
 
 // src/next/adapter.ts
@@ -45,7 +45,8 @@ function withPayment(config, handler) {
   return async (req) => {
     const gateResult = await gate(new NextAdapter(req));
     if (gateResult.type === "pass") {
-      return handler(req);
+      if (!gateResult.preflight) return handler(req);
+      return new NextResponse(null, { status: 204 });
     }
     if (gateResult.type === "error") return fromResult(gateResult.result);
     let response;

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

@@ -10,7 +10,14 @@ interface FacilitatorConfig {
  */
 interface PriceContext {
     method: string;
+    /** As the framework gives it, not normalized: compare `routePath` instead. */
     path: string;
+    /**
+     * The path the route matched, in the form routes are matched on: under an
+     * Express mount, the full path when the key is written with it. Set by the
+     * middleware.
+     */
+    routePath?: string;
     url: string;
     header(name: string): string | undefined;
     body: unknown;
@@ -95,6 +102,8 @@ interface HTTPAdapter {
     getHeader(name: string): string | undefined;
     getMethod(): string;
     getPath(): string;
+    /** The path with the prefix a mount stripped from `getPath()`. */
+    getFullPath?(): string;
     getUrl(): string;
     /** The parsed request body, for routes priced per request. */
     getBody?(): Promise<unknown>;
@@ -163,11 +172,22 @@ interface PaymentConfirmation {
     networkId: string;
     /** Amount actually charged (smallest unit) — metered routes only. */
     amountSettled?: string;
+    /**
+     * A standard x402 Permit2 payment: the USDp the merchant received for
+     * `amountSettled` (smallest unit), when the facilitator read it from the
+     * settlement.
+     */
+    amountDelivered?: string;
     /**
      * Present when the facilitator answered from the outcome an earlier settle
      * of the same payment recorded: this call broadcast nothing.
      */
     alreadySettled?: true;
+    transaction?: Address;
+    network?: string;
+    /** The amount charged, in the smallest unit of the paid token. */
+    amount?: string;
+    payer?: Address;
 }
 interface PaymentFailure {
     success: false;
@@ -190,6 +210,8 @@ interface MiddlewareResult {
 interface PassResult {
     pass: true;
     handlerRan?: true;
+    /** An OPTIONS on a paid route: send only the handler's status and CORS headers. */
+    preflight?: true;
 }
 type VerifiedPayment = {
     type: "verified";
@@ -206,6 +228,7 @@ type VerifiedPayment = {
 };
 type PaymentGateResult = {
     type: "pass";
+    preflight?: true;
 } | {
     type: "error";
     result: MiddlewareResult;

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

@@ -10,7 +10,14 @@ interface FacilitatorConfig {
  */
 interface PriceContext {
     method: string;
+    /** As the framework gives it, not normalized: compare `routePath` instead. */
     path: string;
+    /**
+     * The path the route matched, in the form routes are matched on: under an
+     * Express mount, the full path when the key is written with it. Set by the
+     * middleware.
+     */
+    routePath?: string;
     url: string;
     header(name: string): string | undefined;
     body: unknown;
@@ -95,6 +102,8 @@ interface HTTPAdapter {
     getHeader(name: string): string | undefined;
     getMethod(): string;
     getPath(): string;
+    /** The path with the prefix a mount stripped from `getPath()`. */
+    getFullPath?(): string;
     getUrl(): string;
     /** The parsed request body, for routes priced per request. */
     getBody?(): Promise<unknown>;
@@ -163,11 +172,22 @@ interface PaymentConfirmation {
     networkId: string;
     /** Amount actually charged (smallest unit) — metered routes only. */
     amountSettled?: string;
+    /**
+     * A standard x402 Permit2 payment: the USDp the merchant received for
+     * `amountSettled` (smallest unit), when the facilitator read it from the
+     * settlement.
+     */
+    amountDelivered?: string;
     /**
      * Present when the facilitator answered from the outcome an earlier settle
      * of the same payment recorded: this call broadcast nothing.
      */
     alreadySettled?: true;
+    transaction?: Address;
+    network?: string;
+    /** The amount charged, in the smallest unit of the paid token. */
+    amount?: string;
+    payer?: Address;
 }
 interface PaymentFailure {
     success: false;
@@ -190,6 +210,8 @@ interface MiddlewareResult {
 interface PassResult {
     pass: true;
     handlerRan?: true;
+    /** An OPTIONS on a paid route: send only the handler's status and CORS headers. */
+    preflight?: true;
 }
 type VerifiedPayment = {
     type: "verified";
@@ -206,6 +228,7 @@ type VerifiedPayment = {
 };
 type PaymentGateResult = {
     type: "pass";
+    preflight?: true;
 } | {
     type: "error";
     result: MiddlewareResult;