@parallel-protocol/x402 0.6.0 → 0.7.0

package/dist/next.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 server = require('next/server');
 
 // src/next/adapter.ts
@@ -21,11 +22,22 @@ var NextAdapter = class {
   getUrl() {
     return this.req.url;
   }
+  // 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))
+      return void 0;
+    try {
+      return await this.req.clone().json();
+    } catch {
+      return void 0;
+    }
+  }
 };
 
 // src/next/index.ts
 function withPayment(config, handler) {
-  const gate = chunkK6QETMQA_cjs.createPaymentGate(config);
+  const gate = chunkPOU7EH3E_cjs.createPaymentGate(config);
   return async (req) => {
     const gateResult = await gate(new NextAdapter(req));
     if (gateResult.type === "pass") {
@@ -42,11 +54,11 @@ function withPayment(config, handler) {
     }
     let response;
     try {
-      const outcome = await chunkK6QETMQA_cjs.raceTimeout(
+      const outcome = await chunkPOU7EH3E_cjs.raceTimeout(
         handler(req),
         gateResult.handlerTimeoutMs
       );
-      if (outcome === chunkK6QETMQA_cjs.HANDLER_TIMEOUT) {
+      if (outcome === chunkPOU7EH3E_cjs.HANDLER_TIMEOUT) {
         return new server.NextResponse(null, { status: 504 });
       }
       response = outcome;
@@ -55,10 +67,10 @@ function withPayment(config, handler) {
     }
     let raw;
     if (gateResult.scheme === "upto") {
-      raw = response.headers.get(chunkK6QETMQA_cjs.SETTLE_AMOUNT_HEADER) ?? void 0;
+      raw = response.headers.get(chunkPOU7EH3E_cjs.SETTLE_AMOUNT_HEADER) ?? void 0;
       if (raw !== void 0) {
         const headers = new Headers(response.headers);
-        headers.delete(chunkK6QETMQA_cjs.SETTLE_AMOUNT_HEADER);
+        headers.delete(chunkPOU7EH3E_cjs.SETTLE_AMOUNT_HEADER);
         response = new server.NextResponse(response.body, {
           status: response.status,
           headers
@@ -68,15 +80,22 @@ function withPayment(config, handler) {
     if (response.status >= 200 && response.status < 300) {
       let settleOptions;
       if (gateResult.scheme === "upto") {
-        const resolved = chunkK6QETMQA_cjs.resolveSettleAmount(
-          raw,
-          gateResult.maxAmount,
-          gateResult.decimals
-        );
+        const handled = response;
+        const resolved = await chunkPOU7EH3E_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)
+        });
         if (resolved.kind === "invalid") {
-          return server.NextResponse.json(chunkK6QETMQA_cjs.INVALID_SETTLE_AMOUNT_RESPONSE, {
-            status: 402
+          handled.body?.cancel().catch(() => {
           });
+          return server.NextResponse.json(
+            chunkPOU7EH3E_cjs.invalidSettleAmountResponse(resolved.reason),
+            {
+              status: 402
+            }
+          );
         }
         if (resolved.kind === "skip") return response;
         settleOptions = { amount: resolved.amount };
@@ -85,7 +104,7 @@ function withPayment(config, handler) {
         const settleResponse = settleOptions ? await gateResult.settle(settleOptions) : await gateResult.settle();
         if (settleResponse.success) {
           const headers = new Headers(response.headers);
-          headers.set("payment-response", chunkK6QETMQA_cjs.encodeBase64(settleResponse));
+          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,
@@ -94,6 +113,8 @@ function withPayment(config, handler) {
         }
       } catch {
       }
+      response.body?.cancel().catch(() => {
+      });
       return server.NextResponse.json(
         {
           error: "PAYMENT_SETTLEMENT_FAILED",

package/dist/next.d.cts

@@ -1,5 +1,5 @@
 import { NextRequest, NextResponse } from 'next/server';
-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 NextAdapter implements HTTPAdapter {
@@ -9,6 +9,7 @@ declare class NextAdapter implements HTTPAdapter {
     getMethod(): string;
     getPath(): string;
     getUrl(): string;
+    getBody(): Promise<unknown>;
 }
 
 type NextHandler = (req: NextRequest) => Promise<NextResponse>;

package/dist/next.d.ts

@@ -1,5 +1,5 @@
 import { NextRequest, NextResponse } from 'next/server';
-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 NextAdapter implements HTTPAdapter {
@@ -9,6 +9,7 @@ declare class NextAdapter implements HTTPAdapter {
     getMethod(): string;
     getPath(): string;
     getUrl(): string;
+    getBody(): Promise<unknown>;
 }
 
 type NextHandler = (req: NextRequest) => Promise<NextResponse>;

package/dist/next.js

@@ -1,4 +1,5 @@
-import { createPaymentGate, raceTimeout, HANDLER_TIMEOUT, SETTLE_AMOUNT_HEADER, resolveSettleAmount, INVALID_SETTLE_AMOUNT_RESPONSE, encodeBase64 } from './chunk-TLCEPWQI.js';
+import { isJsonContentType, createPaymentGate, raceTimeout, HANDLER_TIMEOUT, SETTLE_AMOUNT_HEADER, resolveCharge, jsonFromResponse, invalidSettleAmountResponse, encodeBase64 } from './chunk-AENXD4OC.js';
+import './chunk-AFRDHGDT.js';
 import { NextResponse } from 'next/server';
 
 // src/next/adapter.ts
@@ -19,6 +20,17 @@ var NextAdapter = class {
   getUrl() {
     return this.req.url;
   }
+  // 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 (!isJsonContentType(this.req.headers.get("content-type") ?? void 0))
+      return void 0;
+    try {
+      return await this.req.clone().json();
+    } catch {
+      return void 0;
+    }
+  }
 };
 
 // src/next/index.ts
@@ -66,15 +78,22 @@ function withPayment(config, handler) {
     if (response.status >= 200 && response.status < 300) {
       let settleOptions;
       if (gateResult.scheme === "upto") {
-        const resolved = resolveSettleAmount(
-          raw,
-          gateResult.maxAmount,
-          gateResult.decimals
-        );
+        const handled = response;
+        const resolved = await 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: () => jsonFromResponse(handled)
+        });
         if (resolved.kind === "invalid") {
-          return NextResponse.json(INVALID_SETTLE_AMOUNT_RESPONSE, {
-            status: 402
+          handled.body?.cancel().catch(() => {
           });
+          return NextResponse.json(
+            invalidSettleAmountResponse(resolved.reason),
+            {
+              status: 402
+            }
+          );
         }
         if (resolved.kind === "skip") return response;
         settleOptions = { amount: resolved.amount };
@@ -92,6 +111,8 @@ function withPayment(config, handler) {
         }
       } catch {
       }
+      response.body?.cancel().catch(() => {
+      });
       return NextResponse.json(
         {
           error: "PAYMENT_SETTLEMENT_FAILED",

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

@@ -4,8 +4,52 @@ interface FacilitatorConfig {
     url: string;
     apiKey?: string;
 }
+/**
+ * What a per-request price function sees. `body` is the request body as the
+ * framework parsed it (JSON), or `undefined` when there is none.
+ */
+interface PriceContext {
+    method: string;
+    path: string;
+    url: string;
+    header(name: string): string | undefined;
+    body: unknown;
+}
+/**
+ * Prices one request from its content. Called on the unpaid request to build
+ * the 402 and again on the paid retry, so it must be pure: same request, same
+ * price. Returns a price in the same format as a fixed `price`.
+ */
+type PriceFunction = (ctx: PriceContext) => string | bigint | Promise<string | bigint>;
+/**
+ * What a meter function sees once the handler has answered: the response
+ * (`body` is its JSON as parsed by the middleware, `undefined` when it is not
+ * JSON) and the request as the price function saw it.
+ */
+interface MeterContext {
+    status: number;
+    header(name: string): string | undefined;
+    body: unknown;
+    request: PriceContext;
+}
+/**
+ * Names the amount a metered route charges, from the handler's response.
+ * Returns an amount in the same format as `price`, bounded by the cap;
+ * `"0"` serves the request for free; `undefined` leaves the decision to the
+ * `payment-settle-amount` header, then to the cap.
+ */
+type MeterFunction = (ctx: MeterContext) => string | bigint | undefined | null | Promise<string | bigint | undefined | null>;
 interface RouteConfig {
-    price: string | bigint;
+    /**
+     * A fixed amount (`"0.01"` or a bigint in the smallest unit), or a function
+     * of the request for resources priced per request.
+     */
+    price: string | bigint | PriceFunction;
+    /**
+     * Metered routes only: reads the amount to charge from the handler's
+     * response instead of the `payment-settle-amount` header.
+     */
+    meter?: MeterFunction;
     decimals?: number;
     network: string;
     payTo: Address;
@@ -39,6 +83,11 @@ interface RunHandlerResult {
     getResponseHeader?(name: string): string | undefined;
     /** Strips a header before the response leaves (metered routes). */
     removeResponseHeader?(name: string): void;
+    /**
+     * The handler's response body as JSON, for routes with a `meter` function;
+     * `undefined` when the response is not JSON.
+     */
+    getResponseBody?(): Promise<unknown>;
     sendResponse(): void;
     discardResponse(): void;
 }
@@ -47,6 +96,8 @@ interface HTTPAdapter {
     getMethod(): string;
     getPath(): string;
     getUrl(): string;
+    /** The parsed request body, for routes priced per request. */
+    getBody?(): Promise<unknown>;
     runHandler?(options?: RunHandlerOptions): Promise<RunHandlerResult>;
 }
 interface ResourceInfo {
@@ -120,6 +171,9 @@ type VerifiedPayment = {
     /** How long the handler may run before the middleware gives up on it. */
     handlerTimeoutMs: number;
     settle(options?: SettleOptions): Promise<FacilitatorResponse>;
+    /** The route's meter function, and the request it will be shown. */
+    meter?: MeterFunction;
+    request?: PriceContext;
 };
 type PaymentGateResult = {
     type: "pass";
@@ -128,4 +182,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, PaymentConfirmation as f, PaymentFailure as g, PaymentRequired as h, PaymentRequirements as i, ResourceInfo as j, RouteConfig as k };
+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 };

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

@@ -4,8 +4,52 @@ interface FacilitatorConfig {
     url: string;
     apiKey?: string;
 }
+/**
+ * What a per-request price function sees. `body` is the request body as the
+ * framework parsed it (JSON), or `undefined` when there is none.
+ */
+interface PriceContext {
+    method: string;
+    path: string;
+    url: string;
+    header(name: string): string | undefined;
+    body: unknown;
+}
+/**
+ * Prices one request from its content. Called on the unpaid request to build
+ * the 402 and again on the paid retry, so it must be pure: same request, same
+ * price. Returns a price in the same format as a fixed `price`.
+ */
+type PriceFunction = (ctx: PriceContext) => string | bigint | Promise<string | bigint>;
+/**
+ * What a meter function sees once the handler has answered: the response
+ * (`body` is its JSON as parsed by the middleware, `undefined` when it is not
+ * JSON) and the request as the price function saw it.
+ */
+interface MeterContext {
+    status: number;
+    header(name: string): string | undefined;
+    body: unknown;
+    request: PriceContext;
+}
+/**
+ * Names the amount a metered route charges, from the handler's response.
+ * Returns an amount in the same format as `price`, bounded by the cap;
+ * `"0"` serves the request for free; `undefined` leaves the decision to the
+ * `payment-settle-amount` header, then to the cap.
+ */
+type MeterFunction = (ctx: MeterContext) => string | bigint | undefined | null | Promise<string | bigint | undefined | null>;
 interface RouteConfig {
-    price: string | bigint;
+    /**
+     * A fixed amount (`"0.01"` or a bigint in the smallest unit), or a function
+     * of the request for resources priced per request.
+     */
+    price: string | bigint | PriceFunction;
+    /**
+     * Metered routes only: reads the amount to charge from the handler's
+     * response instead of the `payment-settle-amount` header.
+     */
+    meter?: MeterFunction;
     decimals?: number;
     network: string;
     payTo: Address;
@@ -39,6 +83,11 @@ interface RunHandlerResult {
     getResponseHeader?(name: string): string | undefined;
     /** Strips a header before the response leaves (metered routes). */
     removeResponseHeader?(name: string): void;
+    /**
+     * The handler's response body as JSON, for routes with a `meter` function;
+     * `undefined` when the response is not JSON.
+     */
+    getResponseBody?(): Promise<unknown>;
     sendResponse(): void;
     discardResponse(): void;
 }
@@ -47,6 +96,8 @@ interface HTTPAdapter {
     getMethod(): string;
     getPath(): string;
     getUrl(): string;
+    /** The parsed request body, for routes priced per request. */
+    getBody?(): Promise<unknown>;
     runHandler?(options?: RunHandlerOptions): Promise<RunHandlerResult>;
 }
 interface ResourceInfo {
@@ -120,6 +171,9 @@ type VerifiedPayment = {
     /** How long the handler may run before the middleware gives up on it. */
     handlerTimeoutMs: number;
     settle(options?: SettleOptions): Promise<FacilitatorResponse>;
+    /** The route's meter function, and the request it will be shown. */
+    meter?: MeterFunction;
+    request?: PriceContext;
 };
 type PaymentGateResult = {
     type: "pass";
@@ -128,4 +182,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, PaymentConfirmation as f, PaymentFailure as g, PaymentRequired as h, PaymentRequirements as i, ResourceInfo as j, RouteConfig as k };
+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 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@parallel-protocol/x402",
-	"version": "0.6.0",
+	"version": "0.7.0",
 	"description": "Parallel Protocol x402 payment middleware — Express, Next.js, Fastify, Hono",
 	"author": "Parallel Protocol <contact@parallel.best>",
 	"repository": {
@@ -69,6 +69,16 @@
 				"default": "./dist/hono.cjs"
 			}
 		},
+		"./llm": {
+			"import": {
+				"types": "./dist/llm.d.ts",
+				"default": "./dist/llm.js"
+			},
+			"require": {
+				"types": "./dist/llm.d.cts",
+				"default": "./dist/llm.cjs"
+			}
+		},
 		"./package.json": "./package.json"
 	},
 	"files": [