@parallel-protocol/x402 0.6.0 → 0.7.1

package/dist/express.js

@@ -1,10 +1,36 @@
-import { raceTimeout, HANDLER_TIMEOUT, createPaymentMiddleware } from './chunk-TLCEPWQI.js';
+import { raceTimeout, HANDLER_TIMEOUT, parseJsonBody, createPaymentMiddleware } from './chunk-AENXD4OC.js';
+import './chunk-AFRDHGDT.js';
 
 // src/express/adapter.ts
+function chunkBytes(args) {
+  const [chunk, encoding] = args;
+  if (typeof chunk === "string") {
+    return Buffer.from(
+      chunk,
+      typeof encoding === "string" ? encoding : "utf8"
+    );
+  }
+  if (chunk instanceof Uint8Array) return Buffer.from(chunk);
+  return void 0;
+}
 function headerValue(value) {
   if (value === void 0) return void 0;
   return Array.isArray(value) ? value[0] : String(value);
 }
+function writeHeadContentType(args) {
+  const headers = args.find((arg) => typeof arg === "object" && arg !== null);
+  if (!headers) return void 0;
+  if (Array.isArray(headers)) {
+    const index = headers.findIndex(
+      (entry, i) => i % 2 === 0 && typeof entry === "string" && entry.toLowerCase() === "content-type"
+    );
+    return index === -1 ? void 0 : headerValue(headers[index + 1]);
+  }
+  for (const [name, value] of Object.entries(headers)) {
+    if (name.toLowerCase() === "content-type") return headerValue(value);
+  }
+  return void 0;
+}
 var TIMEOUT_BODY = JSON.stringify({
   error: "HANDLER_TIMEOUT",
   message: "The resource handler did not respond in time."
@@ -31,6 +57,11 @@ var ExpressAdapter = class {
   getUrl() {
     return `${this.req.protocol}://${this.req.headers.host}${this.req.originalUrl}`;
   }
+  // Whatever a body parser mounted before this middleware left on `req.body`
+  // (`express.json()` for JSON); `undefined` when none ran.
+  async getBody() {
+    return this.req.body;
+  }
   async runHandler(options) {
     const res = this.res;
     const next = this.next;
@@ -100,6 +131,24 @@ var ExpressAdapter = class {
       setResponseHeader: (name, value) => res.setHeader(name, value),
       getResponseHeader: (name) => headerValue(res.getHeader(name)),
       removeResponseHeader: (name) => res.removeHeader(name),
+      // The buffered chunks are the whole response: parse them when the
+      // handler declared JSON.
+      getResponseBody: async () => {
+        const bytes = [];
+        let contentType = headerValue(res.getHeader("content-type"));
+        for (const [method, args] of buffered) {
+          if (method === "writeHead") {
+            contentType ??= writeHeadContentType(args);
+            continue;
+          }
+          const chunk = chunkBytes(args);
+          if (chunk) bytes.push(chunk);
+        }
+        return parseJsonBody(
+          contentType,
+          Buffer.concat(bytes).toString("utf8")
+        );
+      },
       sendResponse: () => {
         settled = true;
         restore();

package/dist/fastify.cjs

@@ -1,6 +1,7 @@
 'use strict';
 
-var chunkK6QETMQA_cjs = require('./chunk-K6QETMQA.cjs');
+var chunkPOU7EH3E_cjs = require('./chunk-POU7EH3E.cjs');
+require('./chunk-JPMK5YBU.cjs');
 var fp = require('fastify-plugin');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
@@ -26,9 +27,18 @@ var FastifyAdapter = class {
   getUrl() {
     return `${this.req.protocol}://${this.req.host || this.req.hostname}${this.req.url}`;
   }
+  // Fastify has parsed the body by the time the preHandler stage runs, which
+  // is where routes priced per request are gated.
+  async getBody() {
+    return this.req.body;
+  }
 };
 
 // src/fastify/index.ts
+function payloadJson(contentType, payload) {
+  const text = typeof payload === "string" ? payload : payload instanceof Uint8Array ? Buffer.from(payload).toString("utf8") : void 0;
+  return chunkPOU7EH3E_cjs.parseJsonBody(contentType, text);
+}
 function refuse(reply, body) {
   const json = JSON.stringify(body);
   reply.status(402);
@@ -42,10 +52,25 @@ function headerValue(value) {
 }
 function paymentMiddleware(config) {
   return fp__default.default(async (fastify) => {
-    const gate = chunkK6QETMQA_cjs.createPaymentGate(config);
+    const gate = chunkPOU7EH3E_cjs.createPaymentGate(config);
     const verifiedMap = /* @__PURE__ */ new WeakMap();
     const rawWriters = /* @__PURE__ */ new WeakMap();
+    const needsBody = (req) => {
+      const route = chunkPOU7EH3E_cjs.matchRoute(
+        new FastifyAdapter(req).getPath(),
+        config.routes
+      );
+      return typeof route?.price === "function" || route?.meter !== void 0;
+    };
     fastify.addHook("onRequest", async (req, reply) => {
+      if (needsBody(req)) return;
+      await runGate(req, reply);
+    });
+    fastify.addHook("preHandler", async (req, reply) => {
+      if (!needsBody(req)) return;
+      await runGate(req, reply);
+    });
+    async function runGate(req, reply) {
       const gateResult = await gate(new FastifyAdapter(req));
       if (gateResult.type === "pass") return;
       if (gateResult.type === "error") {
@@ -70,7 +95,7 @@ function paymentMiddleware(config) {
       raw.write = refuse2;
       raw.end = refuse2;
       raw.writeHead = refuse2;
-    });
+    }
     fastify.addHook("onSend", async (req, reply, payload) => {
       const writers = rawWriters.get(req);
       if (writers) {
@@ -84,21 +109,21 @@ function paymentMiddleware(config) {
       if (!verified) return payload;
       let raw;
       if (verified.scheme === "upto") {
-        raw = headerValue(reply.getHeader(chunkK6QETMQA_cjs.SETTLE_AMOUNT_HEADER));
-        reply.removeHeader(chunkK6QETMQA_cjs.SETTLE_AMOUNT_HEADER);
+        raw = headerValue(reply.getHeader(chunkPOU7EH3E_cjs.SETTLE_AMOUNT_HEADER));
+        reply.removeHeader(chunkPOU7EH3E_cjs.SETTLE_AMOUNT_HEADER);
       }
       if (reply.statusCode < 200 || reply.statusCode >= 300) {
         return payload;
       }
       let settleOptions;
       if (verified.scheme === "upto") {
-        const resolved = chunkK6QETMQA_cjs.resolveSettleAmount(
-          raw,
-          verified.maxAmount,
-          verified.decimals
-        );
+        const resolved = await chunkPOU7EH3E_cjs.resolveCharge(verified, raw, {
+          status: reply.statusCode,
+          header: (name) => headerValue(reply.getHeader(name)),
+          body: async () => payloadJson(headerValue(reply.getHeader("content-type")), payload)
+        });
         if (resolved.kind === "invalid") {
-          return refuse(reply, chunkK6QETMQA_cjs.INVALID_SETTLE_AMOUNT_RESPONSE);
+          return refuse(reply, chunkPOU7EH3E_cjs.invalidSettleAmountResponse(resolved.reason));
         }
         if (resolved.kind === "skip") return payload;
         settleOptions = { amount: resolved.amount };
@@ -107,7 +132,7 @@ function paymentMiddleware(config) {
       try {
         const settleResponse = settleOptions ? await verified.settle(settleOptions) : await verified.settle();
         if (settleResponse.success) {
-          reply.header("payment-response", chunkK6QETMQA_cjs.encodeBase64(settleResponse));
+          reply.header("payment-response", chunkPOU7EH3E_cjs.encodeBase64(settleResponse));
           reply.header("access-control-expose-headers", "payment-response");
           settled = true;
         }

package/dist/fastify.d.cts

@@ -1,5 +1,5 @@
 import { FastifyRequest, FastifyPluginAsync } from 'fastify';
-import { H as HTTPAdapter, P as PaymentMiddlewareConfig } from './types-CBzm5CtM.cjs';
+import { H as HTTPAdapter, P as PaymentMiddlewareConfig } from './types-q_gu5wjz.cjs';
 import 'viem';
 
 declare class FastifyAdapter implements HTTPAdapter {
@@ -9,6 +9,7 @@ declare class FastifyAdapter implements HTTPAdapter {
     getMethod(): string;
     getPath(): string;
     getUrl(): string;
+    getBody(): Promise<unknown>;
 }
 
 declare function paymentMiddleware(config: PaymentMiddlewareConfig): FastifyPluginAsync;

package/dist/fastify.d.ts

@@ -1,5 +1,5 @@
 import { FastifyRequest, FastifyPluginAsync } from 'fastify';
-import { H as HTTPAdapter, P as PaymentMiddlewareConfig } from './types-CBzm5CtM.js';
+import { H as HTTPAdapter, P as PaymentMiddlewareConfig } from './types-q_gu5wjz.js';
 import 'viem';
 
 declare class FastifyAdapter implements HTTPAdapter {
@@ -9,6 +9,7 @@ declare class FastifyAdapter implements HTTPAdapter {
     getMethod(): string;
     getPath(): string;
     getUrl(): string;
+    getBody(): Promise<unknown>;
 }
 
 declare function paymentMiddleware(config: PaymentMiddlewareConfig): FastifyPluginAsync;

package/dist/fastify.js

@@ -1,4 +1,5 @@
-import { createPaymentGate, SETTLE_AMOUNT_HEADER, resolveSettleAmount, encodeBase64, INVALID_SETTLE_AMOUNT_RESPONSE } from './chunk-TLCEPWQI.js';
+import { createPaymentGate, SETTLE_AMOUNT_HEADER, resolveCharge, invalidSettleAmountResponse, encodeBase64, matchRoute, parseJsonBody } from './chunk-AENXD4OC.js';
+import './chunk-AFRDHGDT.js';
 import fp from 'fastify-plugin';
 
 // src/fastify/adapter.ts
@@ -20,9 +21,18 @@ var FastifyAdapter = class {
   getUrl() {
     return `${this.req.protocol}://${this.req.host || this.req.hostname}${this.req.url}`;
   }
+  // Fastify has parsed the body by the time the preHandler stage runs, which
+  // is where routes priced per request are gated.
+  async getBody() {
+    return this.req.body;
+  }
 };
 
 // src/fastify/index.ts
+function payloadJson(contentType, payload) {
+  const text = typeof payload === "string" ? payload : payload instanceof Uint8Array ? Buffer.from(payload).toString("utf8") : void 0;
+  return parseJsonBody(contentType, text);
+}
 function refuse(reply, body) {
   const json = JSON.stringify(body);
   reply.status(402);
@@ -39,7 +49,22 @@ function paymentMiddleware(config) {
     const gate = createPaymentGate(config);
     const verifiedMap = /* @__PURE__ */ new WeakMap();
     const rawWriters = /* @__PURE__ */ new WeakMap();
+    const needsBody = (req) => {
+      const route = matchRoute(
+        new FastifyAdapter(req).getPath(),
+        config.routes
+      );
+      return typeof route?.price === "function" || route?.meter !== void 0;
+    };
     fastify.addHook("onRequest", async (req, reply) => {
+      if (needsBody(req)) return;
+      await runGate(req, reply);
+    });
+    fastify.addHook("preHandler", async (req, reply) => {
+      if (!needsBody(req)) return;
+      await runGate(req, reply);
+    });
+    async function runGate(req, reply) {
       const gateResult = await gate(new FastifyAdapter(req));
       if (gateResult.type === "pass") return;
       if (gateResult.type === "error") {
@@ -64,7 +89,7 @@ function paymentMiddleware(config) {
       raw.write = refuse2;
       raw.end = refuse2;
       raw.writeHead = refuse2;
-    });
+    }
     fastify.addHook("onSend", async (req, reply, payload) => {
       const writers = rawWriters.get(req);
       if (writers) {
@@ -86,13 +111,13 @@ function paymentMiddleware(config) {
       }
       let settleOptions;
       if (verified.scheme === "upto") {
-        const resolved = resolveSettleAmount(
-          raw,
-          verified.maxAmount,
-          verified.decimals
-        );
+        const resolved = await resolveCharge(verified, raw, {
+          status: reply.statusCode,
+          header: (name) => headerValue(reply.getHeader(name)),
+          body: async () => payloadJson(headerValue(reply.getHeader("content-type")), payload)
+        });
         if (resolved.kind === "invalid") {
-          return refuse(reply, INVALID_SETTLE_AMOUNT_RESPONSE);
+          return refuse(reply, invalidSettleAmountResponse(resolved.reason));
         }
         if (resolved.kind === "skip") return payload;
         settleOptions = { amount: resolved.amount };

package/dist/hono.cjs

@@ -1,6 +1,7 @@
 'use strict';
 
-var chunkK6QETMQA_cjs = require('./chunk-K6QETMQA.cjs');
+var chunkPOU7EH3E_cjs = require('./chunk-POU7EH3E.cjs');
+require('./chunk-JPMK5YBU.cjs');
 
 // src/hono/adapter.ts
 var TIMEOUT_BODY = JSON.stringify({
@@ -26,9 +27,19 @@ var HonoAdapter = class {
   getUrl() {
     return this.c.req.url;
   }
+  // Hono caches the parsed body on the request, so the handler can still read
+  // it after the price function did.
+  async getBody() {
+    if (!chunkPOU7EH3E_cjs.isJsonContentType(this.c.req.header("content-type"))) return void 0;
+    try {
+      return await this.c.req.json();
+    } catch {
+      return void 0;
+    }
+  }
   async runHandler(options) {
-    const outcome = await chunkK6QETMQA_cjs.raceTimeout(this.next(), options?.timeoutMs);
-    if (outcome === chunkK6QETMQA_cjs.HANDLER_TIMEOUT) {
+    const outcome = await chunkPOU7EH3E_cjs.raceTimeout(this.next(), options?.timeoutMs);
+    if (outcome === chunkPOU7EH3E_cjs.HANDLER_TIMEOUT) {
       return {
         status: 504,
         setResponseHeader: () => {
@@ -52,9 +63,15 @@ var HonoAdapter = class {
       setResponseHeader: (name, value) => res.headers.set(name, value),
       getResponseHeader: (name) => res.headers.get(name) ?? void 0,
       removeResponseHeader: (name) => res.headers.delete(name),
+      // Read from a clone: the response body streams once, to the client.
+      getResponseBody: () => chunkPOU7EH3E_cjs.jsonFromResponse(res),
       sendResponse: () => {
       },
+      // The response is replaced: release its body (and whatever upstream
+      // stream feeds it) instead of leaving it open until collected.
       discardResponse: () => {
+        res.body?.cancel().catch(() => {
+        });
       }
     };
   }
@@ -62,7 +79,7 @@ var HonoAdapter = class {
 
 // src/hono/index.ts
 function paymentMiddleware(config) {
-  const middleware = chunkK6QETMQA_cjs.createPaymentMiddleware(config);
+  const middleware = chunkPOU7EH3E_cjs.createPaymentMiddleware(config);
   return async (c, next) => {
     const result = await middleware(new HonoAdapter(c, next));
     if ("pass" in result) {

package/dist/hono.d.cts

@@ -1,5 +1,5 @@
 import { Context, Next, MiddlewareHandler } from 'hono';
-import { H as HTTPAdapter, R as RunHandlerOptions, a as RunHandlerResult, P as PaymentMiddlewareConfig } from './types-CBzm5CtM.cjs';
+import { H as HTTPAdapter, R as RunHandlerOptions, a as RunHandlerResult, P as PaymentMiddlewareConfig } from './types-q_gu5wjz.cjs';
 import 'viem';
 
 declare class HonoAdapter implements HTTPAdapter {
@@ -10,6 +10,7 @@ declare class HonoAdapter implements HTTPAdapter {
     getMethod(): string;
     getPath(): string;
     getUrl(): string;
+    getBody(): Promise<unknown>;
     runHandler(options?: RunHandlerOptions): Promise<RunHandlerResult>;
 }
 

package/dist/hono.d.ts

@@ -1,5 +1,5 @@
 import { Context, Next, MiddlewareHandler } from 'hono';
-import { H as HTTPAdapter, R as RunHandlerOptions, a as RunHandlerResult, P as PaymentMiddlewareConfig } from './types-CBzm5CtM.js';
+import { H as HTTPAdapter, R as RunHandlerOptions, a as RunHandlerResult, P as PaymentMiddlewareConfig } from './types-q_gu5wjz.js';
 import 'viem';
 
 declare class HonoAdapter implements HTTPAdapter {
@@ -10,6 +10,7 @@ declare class HonoAdapter implements HTTPAdapter {
     getMethod(): string;
     getPath(): string;
     getUrl(): string;
+    getBody(): Promise<unknown>;
     runHandler(options?: RunHandlerOptions): Promise<RunHandlerResult>;
 }
 

package/dist/hono.js

@@ -1,4 +1,5 @@
-import { raceTimeout, HANDLER_TIMEOUT, createPaymentMiddleware } from './chunk-TLCEPWQI.js';
+import { isJsonContentType, raceTimeout, HANDLER_TIMEOUT, jsonFromResponse, createPaymentMiddleware } from './chunk-AENXD4OC.js';
+import './chunk-AFRDHGDT.js';
 
 // src/hono/adapter.ts
 var TIMEOUT_BODY = JSON.stringify({
@@ -24,6 +25,16 @@ var HonoAdapter = class {
   getUrl() {
     return this.c.req.url;
   }
+  // Hono caches the parsed body on the request, so the handler can still read
+  // it after the price function did.
+  async getBody() {
+    if (!isJsonContentType(this.c.req.header("content-type"))) return void 0;
+    try {
+      return await this.c.req.json();
+    } catch {
+      return void 0;
+    }
+  }
   async runHandler(options) {
     const outcome = await raceTimeout(this.next(), options?.timeoutMs);
     if (outcome === HANDLER_TIMEOUT) {
@@ -50,9 +61,15 @@ var HonoAdapter = class {
       setResponseHeader: (name, value) => res.headers.set(name, value),
       getResponseHeader: (name) => res.headers.get(name) ?? void 0,
       removeResponseHeader: (name) => res.headers.delete(name),
+      // Read from a clone: the response body streams once, to the client.
+      getResponseBody: () => jsonFromResponse(res),
       sendResponse: () => {
       },
+      // The response is replaced: release its body (and whatever upstream
+      // stream feeds it) instead of leaving it open until collected.
       discardResponse: () => {
+        res.body?.cancel().catch(() => {
+        });
       }
     };
   }

package/dist/index.cjs

@@ -1,62 +1,75 @@
 'use strict';
 
-var chunkK6QETMQA_cjs = require('./chunk-K6QETMQA.cjs');
+var chunkPOU7EH3E_cjs = require('./chunk-POU7EH3E.cjs');
+var chunkJPMK5YBU_cjs = require('./chunk-JPMK5YBU.cjs');
 
 
 
 Object.defineProperty(exports, "FacilitatorClient", {
   enumerable: true,
-  get: function () { return chunkK6QETMQA_cjs.FacilitatorClient; }
+  get: function () { return chunkPOU7EH3E_cjs.FacilitatorClient; }
 });
 Object.defineProperty(exports, "PARALLEL_TOKENS", {
   enumerable: true,
-  get: function () { return chunkK6QETMQA_cjs.PARALLEL_TOKENS; }
+  get: function () { return chunkPOU7EH3E_cjs.PARALLEL_TOKENS; }
 });
 Object.defineProperty(exports, "SETTLE_AMOUNT_HEADER", {
   enumerable: true,
-  get: function () { return chunkK6QETMQA_cjs.SETTLE_AMOUNT_HEADER; }
-});
-Object.defineProperty(exports, "X402ConfigError", {
-  enumerable: true,
-  get: function () { return chunkK6QETMQA_cjs.X402ConfigError; }
-});
-Object.defineProperty(exports, "X402RuntimeError", {
-  enumerable: true,
-  get: function () { return chunkK6QETMQA_cjs.X402RuntimeError; }
-});
-Object.defineProperty(exports, "X402_ERROR_CODES", {
-  enumerable: true,
-  get: function () { return chunkK6QETMQA_cjs.X402_ERROR_CODES; }
+  get: function () { return chunkPOU7EH3E_cjs.SETTLE_AMOUNT_HEADER; }
 });
 Object.defineProperty(exports, "createPaymentGate", {
   enumerable: true,
-  get: function () { return chunkK6QETMQA_cjs.createPaymentGate; }
+  get: function () { return chunkPOU7EH3E_cjs.createPaymentGate; }
 });
 Object.defineProperty(exports, "createPaymentMiddleware", {
   enumerable: true,
-  get: function () { return chunkK6QETMQA_cjs.createPaymentMiddleware; }
+  get: function () { return chunkPOU7EH3E_cjs.createPaymentMiddleware; }
 });
 Object.defineProperty(exports, "encodeBase64", {
   enumerable: true,
-  get: function () { return chunkK6QETMQA_cjs.encodeBase64; }
+  get: function () { return chunkPOU7EH3E_cjs.encodeBase64; }
 });
 Object.defineProperty(exports, "getDefaultAcceptedTokens", {
   enumerable: true,
-  get: function () { return chunkK6QETMQA_cjs.getDefaultAcceptedTokens; }
+  get: function () { return chunkPOU7EH3E_cjs.getDefaultAcceptedTokens; }
 });
 Object.defineProperty(exports, "parsePrice", {
   enumerable: true,
-  get: function () { return chunkK6QETMQA_cjs.parsePrice; }
+  get: function () { return chunkPOU7EH3E_cjs.parsePrice; }
+});
+Object.defineProperty(exports, "resolveCharge", {
+  enumerable: true,
+  get: function () { return chunkPOU7EH3E_cjs.resolveCharge; }
 });
 Object.defineProperty(exports, "resolveSettleAmount", {
   enumerable: true,
-  get: function () { return chunkK6QETMQA_cjs.resolveSettleAmount; }
+  get: function () { return chunkPOU7EH3E_cjs.resolveSettleAmount; }
 });
 Object.defineProperty(exports, "toEip155Network", {
   enumerable: true,
-  get: function () { return chunkK6QETMQA_cjs.toEip155Network; }
+  get: function () { return chunkPOU7EH3E_cjs.toEip155Network; }
 });
 Object.defineProperty(exports, "validateAddress", {
   enumerable: true,
-  get: function () { return chunkK6QETMQA_cjs.validateAddress; }
+  get: function () { return chunkPOU7EH3E_cjs.validateAddress; }
+});
+Object.defineProperty(exports, "X402ConfigError", {
+  enumerable: true,
+  get: function () { return chunkJPMK5YBU_cjs.X402ConfigError; }
+});
+Object.defineProperty(exports, "X402PriceRejectedError", {
+  enumerable: true,
+  get: function () { return chunkJPMK5YBU_cjs.X402PriceRejectedError; }
+});
+Object.defineProperty(exports, "X402RuntimeError", {
+  enumerable: true,
+  get: function () { return chunkJPMK5YBU_cjs.X402RuntimeError; }
+});
+Object.defineProperty(exports, "X402_ERROR_CODES", {
+  enumerable: true,
+  get: function () { return chunkJPMK5YBU_cjs.X402_ERROR_CODES; }
+});
+Object.defineProperty(exports, "isPriceRejection", {
+  enumerable: true,
+  get: function () { return chunkJPMK5YBU_cjs.isPriceRejection; }
 });

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { F as FacilitatorConfig, b as FacilitatorPaymentRequirements, S as SettleOptions, c as FacilitatorResponse, P as PaymentMiddlewareConfig, H as HTTPAdapter, d as PaymentGateResult, M as MiddlewareResult, e as PassResult } from './types-CBzm5CtM.cjs';
-export { f as PaymentConfirmation, g as PaymentFailure, h as PaymentRequired, i as PaymentRequirements, j as ResourceInfo, k as RouteConfig, R as RunHandlerOptions, a as RunHandlerResult, V as VerifiedPayment } from './types-CBzm5CtM.cjs';
+import { F as FacilitatorConfig, b as FacilitatorPaymentRequirements, S as SettleOptions, c as FacilitatorResponse, P as PaymentMiddlewareConfig, H as HTTPAdapter, d as PaymentGateResult, M as MiddlewareResult, e as PassResult, V as VerifiedPayment } from './types-q_gu5wjz.cjs';
+export { f as MeterContext, g as MeterFunction, h as PaymentConfirmation, i as PaymentFailure, j as PaymentRequired, k as PaymentRequirements, l as PriceContext, m as PriceFunction, n as ResourceInfo, o as RouteConfig, R as RunHandlerOptions, a as RunHandlerResult } from './types-q_gu5wjz.cjs';
 import { Address } from 'viem';
 
 declare class FacilitatorClient {
@@ -24,7 +24,25 @@ declare class X402RuntimeError extends Error {
     readonly code: string;
     constructor(code: string);
 }
+/**
+ * Thrown by a per-request price function to refuse a request before anything
+ * is invoiced or signed: the middleware answers with `status` and a JSON body
+ * `{ error: code, message }`. For requests the route will not serve (an
+ * unknown model, an unsupported option) rather than merchant bugs.
+ */
+declare class X402PriceRejectedError extends Error {
+    readonly code: string;
+    readonly status: number;
+    constructor(code: string, message: string, status?: number);
+}
+/**
+ * Recognises a price refusal by shape rather than by class identity, so a
+ * refusal thrown from another copy of this package (a nested install, the
+ * CommonJS build next to the ESM one) is still answered as a refusal.
+ */
+declare function isPriceRejection(error: unknown): error is X402PriceRejectedError;
 
+type GateAdapter = Pick<HTTPAdapter, "getHeader" | "getPath" | "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
@@ -39,7 +57,7 @@ type SettleAmountResolution = {
     kind: "skip";
 } | {
     kind: "invalid";
-    reason: "malformed" | "precision" | "above-cap";
+    reason: "malformed" | "precision" | "above-cap" | "meter";
 };
 /**
  * Turns the handler's `payment-settle-amount` header into a settle decision.
@@ -50,7 +68,23 @@ type SettleAmountResolution = {
  * silently served for free.
  */
 declare function resolveSettleAmount(raw: string | undefined, maxAmount: bigint, decimals: number): SettleAmountResolution;
-declare function createPaymentGate(config: PaymentMiddlewareConfig): (adapter: Pick<HTTPAdapter, "getHeader" | "getPath" | "getUrl" | "getMethod">) => Promise<PaymentGateResult>;
+/** What the middleware can read from the handler's response. */
+interface ChargeResponse {
+    status: number;
+    header(name: string): string | undefined;
+    body(): Promise<unknown>;
+}
+/**
+ * The amount a metered route settles, once the handler answered with a 2xx.
+ * A `meter` function on the route decides first, from the response: its
+ * amount is bounded by the cap (an overrun is the merchant's loss, not a
+ * refused response), zero serves for free, and no amount hands over to the
+ * `payment-settle-amount` header, which keeps its rules (absent charges the
+ * cap, above the cap is refused). A meter that throws or returns something
+ * that is not an amount fails closed like an invalid header.
+ */
+declare function resolveCharge(verified: VerifiedPayment, settleHeader: string | undefined, response: ChargeResponse): Promise<SettleAmountResolution>;
+declare function createPaymentGate(config: PaymentMiddlewareConfig): (adapter: GateAdapter) => Promise<PaymentGateResult>;
 declare function createPaymentMiddleware(config: PaymentMiddlewareConfig): (adapter: HTTPAdapter) => Promise<MiddlewareResult | PassResult>;
 
 type ParallelNetwork = "ethereum" | "base" | "avalanche" | "hyperevm";
@@ -74,4 +108,4 @@ declare function validateAddress(address: string): address is Address;
 declare function toEip155Network(network: string): string;
 declare function encodeBase64(obj: unknown): string;
 
-export { FacilitatorClient, FacilitatorConfig, FacilitatorPaymentRequirements, FacilitatorResponse, HTTPAdapter, MiddlewareResult, PARALLEL_TOKENS, type ParallelNetwork, PassResult, PaymentGateResult, PaymentMiddlewareConfig, SETTLE_AMOUNT_HEADER, type SettleAmountResolution, SettleOptions, X402ConfigError, type X402ErrorCode, X402RuntimeError, X402_ERROR_CODES, createPaymentGate, createPaymentMiddleware, encodeBase64, getDefaultAcceptedTokens, parsePrice, resolveSettleAmount, toEip155Network, validateAddress };
+export { type ChargeResponse, FacilitatorClient, FacilitatorConfig, FacilitatorPaymentRequirements, FacilitatorResponse, HTTPAdapter, MiddlewareResult, PARALLEL_TOKENS, type ParallelNetwork, PassResult, PaymentGateResult, PaymentMiddlewareConfig, SETTLE_AMOUNT_HEADER, type SettleAmountResolution, SettleOptions, VerifiedPayment, X402ConfigError, type X402ErrorCode, X402PriceRejectedError, X402RuntimeError, X402_ERROR_CODES, createPaymentGate, createPaymentMiddleware, encodeBase64, getDefaultAcceptedTokens, isPriceRejection, parsePrice, resolveCharge, resolveSettleAmount, toEip155Network, validateAddress };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FacilitatorConfig, b as FacilitatorPaymentRequirements, S as SettleOptions, c as FacilitatorResponse, P as PaymentMiddlewareConfig, H as HTTPAdapter, d as PaymentGateResult, M as MiddlewareResult, e as PassResult } from './types-CBzm5CtM.js';
-export { f as PaymentConfirmation, g as PaymentFailure, h as PaymentRequired, i as PaymentRequirements, j as ResourceInfo, k as RouteConfig, R as RunHandlerOptions, a as RunHandlerResult, V as VerifiedPayment } from './types-CBzm5CtM.js';
+import { F as FacilitatorConfig, b as FacilitatorPaymentRequirements, S as SettleOptions, c as FacilitatorResponse, P as PaymentMiddlewareConfig, H as HTTPAdapter, d as PaymentGateResult, M as MiddlewareResult, e as PassResult, V as VerifiedPayment } from './types-q_gu5wjz.js';
+export { f as MeterContext, g as MeterFunction, h as PaymentConfirmation, i as PaymentFailure, j as PaymentRequired, k as PaymentRequirements, l as PriceContext, m as PriceFunction, n as ResourceInfo, o as RouteConfig, R as RunHandlerOptions, a as RunHandlerResult } from './types-q_gu5wjz.js';
 import { Address } from 'viem';
 
 declare class FacilitatorClient {
@@ -24,7 +24,25 @@ declare class X402RuntimeError extends Error {
     readonly code: string;
     constructor(code: string);
 }
+/**
+ * Thrown by a per-request price function to refuse a request before anything
+ * is invoiced or signed: the middleware answers with `status` and a JSON body
+ * `{ error: code, message }`. For requests the route will not serve (an
+ * unknown model, an unsupported option) rather than merchant bugs.
+ */
+declare class X402PriceRejectedError extends Error {
+    readonly code: string;
+    readonly status: number;
+    constructor(code: string, message: string, status?: number);
+}
+/**
+ * Recognises a price refusal by shape rather than by class identity, so a
+ * refusal thrown from another copy of this package (a nested install, the
+ * CommonJS build next to the ESM one) is still answered as a refusal.
+ */
+declare function isPriceRejection(error: unknown): error is X402PriceRejectedError;
 
+type GateAdapter = Pick<HTTPAdapter, "getHeader" | "getPath" | "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
@@ -39,7 +57,7 @@ type SettleAmountResolution = {
     kind: "skip";
 } | {
     kind: "invalid";
-    reason: "malformed" | "precision" | "above-cap";
+    reason: "malformed" | "precision" | "above-cap" | "meter";
 };
 /**
  * Turns the handler's `payment-settle-amount` header into a settle decision.
@@ -50,7 +68,23 @@ type SettleAmountResolution = {
  * silently served for free.
  */
 declare function resolveSettleAmount(raw: string | undefined, maxAmount: bigint, decimals: number): SettleAmountResolution;
-declare function createPaymentGate(config: PaymentMiddlewareConfig): (adapter: Pick<HTTPAdapter, "getHeader" | "getPath" | "getUrl" | "getMethod">) => Promise<PaymentGateResult>;
+/** What the middleware can read from the handler's response. */
+interface ChargeResponse {
+    status: number;
+    header(name: string): string | undefined;
+    body(): Promise<unknown>;
+}
+/**
+ * The amount a metered route settles, once the handler answered with a 2xx.
+ * A `meter` function on the route decides first, from the response: its
+ * amount is bounded by the cap (an overrun is the merchant's loss, not a
+ * refused response), zero serves for free, and no amount hands over to the
+ * `payment-settle-amount` header, which keeps its rules (absent charges the
+ * cap, above the cap is refused). A meter that throws or returns something
+ * that is not an amount fails closed like an invalid header.
+ */
+declare function resolveCharge(verified: VerifiedPayment, settleHeader: string | undefined, response: ChargeResponse): Promise<SettleAmountResolution>;
+declare function createPaymentGate(config: PaymentMiddlewareConfig): (adapter: GateAdapter) => Promise<PaymentGateResult>;
 declare function createPaymentMiddleware(config: PaymentMiddlewareConfig): (adapter: HTTPAdapter) => Promise<MiddlewareResult | PassResult>;
 
 type ParallelNetwork = "ethereum" | "base" | "avalanche" | "hyperevm";
@@ -74,4 +108,4 @@ declare function validateAddress(address: string): address is Address;
 declare function toEip155Network(network: string): string;
 declare function encodeBase64(obj: unknown): string;
 
-export { FacilitatorClient, FacilitatorConfig, FacilitatorPaymentRequirements, FacilitatorResponse, HTTPAdapter, MiddlewareResult, PARALLEL_TOKENS, type ParallelNetwork, PassResult, PaymentGateResult, PaymentMiddlewareConfig, SETTLE_AMOUNT_HEADER, type SettleAmountResolution, SettleOptions, X402ConfigError, type X402ErrorCode, X402RuntimeError, X402_ERROR_CODES, createPaymentGate, createPaymentMiddleware, encodeBase64, getDefaultAcceptedTokens, parsePrice, resolveSettleAmount, toEip155Network, validateAddress };
+export { type ChargeResponse, FacilitatorClient, FacilitatorConfig, FacilitatorPaymentRequirements, FacilitatorResponse, HTTPAdapter, MiddlewareResult, PARALLEL_TOKENS, type ParallelNetwork, PassResult, PaymentGateResult, PaymentMiddlewareConfig, SETTLE_AMOUNT_HEADER, type SettleAmountResolution, SettleOptions, VerifiedPayment, X402ConfigError, type X402ErrorCode, X402PriceRejectedError, X402RuntimeError, X402_ERROR_CODES, createPaymentGate, createPaymentMiddleware, encodeBase64, getDefaultAcceptedTokens, isPriceRejection, parsePrice, resolveCharge, resolveSettleAmount, toEip155Network, validateAddress };