@puga-labs/x402-mantle-sdk 0.3.3 → 0.3.4

package/dist/chunk-IT6VV6YL.js

@@ -0,0 +1,73 @@
+import {
+  buildRouteKey,
+  checkPayment,
+  validateAddress
+} from "./chunk-ZLCKBFVJ.js";
+import {
+  MANTLE_DEFAULTS,
+  __export,
+  getDefaultAssetForNetwork,
+  usdCentsToAtomic
+} from "./chunk-HEZZ74SI.js";
+
+// src/server/adapters/nextjs.ts
+var nextjs_exports = {};
+__export(nextjs_exports, {
+  isPaywallErrorResponse: () => isPaywallErrorResponse,
+  mantlePaywall: () => mantlePaywall
+});
+import { NextResponse } from "next/server";
+function mantlePaywall(opts) {
+  const { priceUsd, payTo, facilitatorUrl, telemetry, onPaymentSettled } = opts;
+  validateAddress(payTo, "payTo");
+  const priceUsdCents = Math.round(priceUsd * 100);
+  return function(handler) {
+    return async (req) => {
+      const url = new URL(req.url);
+      const method = req.method;
+      const path = url.pathname;
+      const routeKey = buildRouteKey(method, path);
+      const network = MANTLE_DEFAULTS.NETWORK;
+      const assetConfig = getDefaultAssetForNetwork(network);
+      const maxAmountRequiredBigInt = usdCentsToAtomic(
+        priceUsdCents,
+        assetConfig.decimals
+      );
+      const paymentRequirements = {
+        scheme: "exact",
+        network,
+        asset: assetConfig.address,
+        maxAmountRequired: maxAmountRequiredBigInt.toString(),
+        payTo,
+        price: `$${(priceUsdCents / 100).toFixed(2)}`,
+        currency: "USD"
+      };
+      const paymentHeader = req.headers.get("X-PAYMENT") || req.headers.get("x-payment") || null;
+      const result = await checkPayment({
+        paymentHeader,
+        paymentRequirements,
+        facilitatorUrl: facilitatorUrl || MANTLE_DEFAULTS.FACILITATOR_URL,
+        routeKey,
+        network,
+        asset: assetConfig.address,
+        telemetry,
+        onPaymentSettled
+      });
+      if (!result.isValid) {
+        return NextResponse.json(result.responseBody, {
+          status: result.statusCode
+        });
+      }
+      return handler(req);
+    };
+  };
+}
+function isPaywallErrorResponse(response) {
+  return typeof response === "object" && response !== null && "error" in response && typeof response.error === "string";
+}
+
+export {
+  mantlePaywall,
+  isPaywallErrorResponse,
+  nextjs_exports
+};

package/dist/nextjs-BgyAWzT3.d.ts

@@ -0,0 +1,82 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { M as MinimalPaywallOptions } from './types-CqQ6OgRi.js';
+import { P as PaymentRequirements } from './types-BFUqKBBO.js';
+
+/**
+ * Error response returned when payment verification fails.
+ * This can be due to missing payment, invalid payment, or verification errors.
+ */
+interface PaywallErrorResponse {
+    error: string;
+    paymentRequirements?: PaymentRequirements;
+    paymentHeader?: null;
+    invalidReason?: string | null;
+    details?: string;
+}
+/**
+ * Next.js App Router route handler type.
+ */
+type NextJSHandler<T = any> = (req: NextRequest) => Promise<NextResponse<T>>;
+/**
+ * Wrapper function that adds x402 payment verification to Next.js route handler.
+ * Returns a handler that may return either the original handler's response type (T)
+ * or a PaywallErrorResponse if payment verification fails.
+ */
+type NextJSPaywallWrapper = <T>(handler: NextJSHandler<T>) => NextJSHandler<T | PaywallErrorResponse>;
+/**
+ * Create Next.js App Router middleware for x402 payment verification.
+ * Uses Mantle mainnet defaults (USDC, exact scheme, etc.).
+ *
+ * @example
+ * ```typescript
+ * // app/api/generate-image/route.ts
+ * import { mantlePaywall } from '@puga-labs/x402-mantle-sdk/server/nextjs'
+ *
+ * const pay = mantlePaywall({
+ *   priceUsd: 0.01,
+ *   payTo: process.env.PAY_TO!,
+ * });
+ *
+ * // No 'as any' needed! TypeScript correctly infers the union type
+ * export const POST = pay(async (req: NextRequest) => {
+ *   const { prompt } = await req.json();
+ *   // Your handler code here
+ *   return NextResponse.json({ success: true, imageUrl: "..." });
+ * });
+ * // TypeScript knows POST returns: NextResponse<{ success: boolean; imageUrl: string } | PaywallErrorResponse>
+ * ```
+ *
+ * @param opts - Minimal configuration (price, payTo, optional facilitator/telemetry).
+ * @returns Function that wraps Next.js route handlers with payment verification.
+ */
+declare function mantlePaywall(opts: MinimalPaywallOptions): NextJSPaywallWrapper;
+/**
+ * Type guard to check if a response is a paywall error response.
+ * Useful for handling the union type returned by the paywall wrapper.
+ *
+ * @example
+ * ```typescript
+ * const response = await fetch('/api/protected');
+ * const data = await response.json();
+ *
+ * if (isPaywallErrorResponse(data)) {
+ *   // Handle error: data.error, data.paymentRequirements, etc.
+ *   console.error('Payment required:', data.paymentRequirements);
+ * } else {
+ *   // Handle success: data has type T
+ *   console.log('Success:', data);
+ * }
+ * ```
+ */
+declare function isPaywallErrorResponse(response: unknown): response is PaywallErrorResponse;
+
+type nextjs_NextJSHandler<T = any> = NextJSHandler<T>;
+type nextjs_NextJSPaywallWrapper = NextJSPaywallWrapper;
+type nextjs_PaywallErrorResponse = PaywallErrorResponse;
+declare const nextjs_isPaywallErrorResponse: typeof isPaywallErrorResponse;
+declare const nextjs_mantlePaywall: typeof mantlePaywall;
+declare namespace nextjs {
+  export { type nextjs_NextJSHandler as NextJSHandler, type nextjs_NextJSPaywallWrapper as NextJSPaywallWrapper, type nextjs_PaywallErrorResponse as PaywallErrorResponse, nextjs_isPaywallErrorResponse as isPaywallErrorResponse, nextjs_mantlePaywall as mantlePaywall };
+}
+
+export { type NextJSHandler as N, type PaywallErrorResponse as P, type NextJSPaywallWrapper as a, isPaywallErrorResponse as i, mantlePaywall as m, nextjs as n };

package/dist/nextjs-CY13JXkV.d.cts

@@ -0,0 +1,82 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { M as MinimalPaywallOptions } from './types-CrOsOHcX.cjs';
+import { P as PaymentRequirements } from './types-BFUqKBBO.cjs';
+
+/**
+ * Error response returned when payment verification fails.
+ * This can be due to missing payment, invalid payment, or verification errors.
+ */
+interface PaywallErrorResponse {
+    error: string;
+    paymentRequirements?: PaymentRequirements;
+    paymentHeader?: null;
+    invalidReason?: string | null;
+    details?: string;
+}
+/**
+ * Next.js App Router route handler type.
+ */
+type NextJSHandler<T = any> = (req: NextRequest) => Promise<NextResponse<T>>;
+/**
+ * Wrapper function that adds x402 payment verification to Next.js route handler.
+ * Returns a handler that may return either the original handler's response type (T)
+ * or a PaywallErrorResponse if payment verification fails.
+ */
+type NextJSPaywallWrapper = <T>(handler: NextJSHandler<T>) => NextJSHandler<T | PaywallErrorResponse>;
+/**
+ * Create Next.js App Router middleware for x402 payment verification.
+ * Uses Mantle mainnet defaults (USDC, exact scheme, etc.).
+ *
+ * @example
+ * ```typescript
+ * // app/api/generate-image/route.ts
+ * import { mantlePaywall } from '@puga-labs/x402-mantle-sdk/server/nextjs'
+ *
+ * const pay = mantlePaywall({
+ *   priceUsd: 0.01,
+ *   payTo: process.env.PAY_TO!,
+ * });
+ *
+ * // No 'as any' needed! TypeScript correctly infers the union type
+ * export const POST = pay(async (req: NextRequest) => {
+ *   const { prompt } = await req.json();
+ *   // Your handler code here
+ *   return NextResponse.json({ success: true, imageUrl: "..." });
+ * });
+ * // TypeScript knows POST returns: NextResponse<{ success: boolean; imageUrl: string } | PaywallErrorResponse>
+ * ```
+ *
+ * @param opts - Minimal configuration (price, payTo, optional facilitator/telemetry).
+ * @returns Function that wraps Next.js route handlers with payment verification.
+ */
+declare function mantlePaywall(opts: MinimalPaywallOptions): NextJSPaywallWrapper;
+/**
+ * Type guard to check if a response is a paywall error response.
+ * Useful for handling the union type returned by the paywall wrapper.
+ *
+ * @example
+ * ```typescript
+ * const response = await fetch('/api/protected');
+ * const data = await response.json();
+ *
+ * if (isPaywallErrorResponse(data)) {
+ *   // Handle error: data.error, data.paymentRequirements, etc.
+ *   console.error('Payment required:', data.paymentRequirements);
+ * } else {
+ *   // Handle success: data has type T
+ *   console.log('Success:', data);
+ * }
+ * ```
+ */
+declare function isPaywallErrorResponse(response: unknown): response is PaywallErrorResponse;
+
+type nextjs_NextJSHandler<T = any> = NextJSHandler<T>;
+type nextjs_NextJSPaywallWrapper = NextJSPaywallWrapper;
+type nextjs_PaywallErrorResponse = PaywallErrorResponse;
+declare const nextjs_isPaywallErrorResponse: typeof isPaywallErrorResponse;
+declare const nextjs_mantlePaywall: typeof mantlePaywall;
+declare namespace nextjs {
+  export { type nextjs_NextJSHandler as NextJSHandler, type nextjs_NextJSPaywallWrapper as NextJSPaywallWrapper, type nextjs_PaywallErrorResponse as PaywallErrorResponse, nextjs_isPaywallErrorResponse as isPaywallErrorResponse, nextjs_mantlePaywall as mantlePaywall };
+}
+
+export { type NextJSHandler as N, type PaywallErrorResponse as P, type NextJSPaywallWrapper as a, isPaywallErrorResponse as i, mantlePaywall as m, nextjs as n };

package/dist/server-nextjs.cjs

@@ -21,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var server_nextjs_exports = {};
 __export(server_nextjs_exports, {
   MANTLE_DEFAULTS: () => MANTLE_DEFAULTS,
+  isPaywallErrorResponse: () => isPaywallErrorResponse,
   mantlePaywall: () => mantlePaywall
 });
 module.exports = __toCommonJS(server_nextjs_exports);
@@ -332,8 +333,12 @@ function mantlePaywall(opts) {
     };
   };
 }
+function isPaywallErrorResponse(response) {
+  return typeof response === "object" && response !== null && "error" in response && typeof response.error === "string";
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   MANTLE_DEFAULTS,
+  isPaywallErrorResponse,
   mantlePaywall
 });

package/dist/server-nextjs.d.cts

@@ -1,4 +1,4 @@
-export { N as NextJSHandler, a as NextJSPaywallWrapper, m as mantlePaywall } from './nextjs-Duecps0q.cjs';
+export { N as NextJSHandler, a as NextJSPaywallWrapper, P as PaywallErrorResponse, i as isPaywallErrorResponse, m as mantlePaywall } from './nextjs-CY13JXkV.cjs';
 export { M as MinimalPaywallOptions, c as PaymentCheckInput, d as PaymentCheckResult, P as PaymentLogEntry, R as RouteKey, a as RoutePricingConfig, b as RoutesConfig, T as TelemetryConfig } from './types-CrOsOHcX.cjs';
 export { A as AssetConfig, a as Authorization, E as EIP1193Provider, N as NetworkId, d as PaymentHeaderBase64, c as PaymentHeaderObject, b as PaymentHeaderPayload, P as PaymentRequirements } from './types-BFUqKBBO.cjs';
 export { M as MANTLE_DEFAULTS } from './constants-CsIL25uQ.cjs';

package/dist/server-nextjs.d.ts

@@ -1,4 +1,4 @@
-export { N as NextJSHandler, a as NextJSPaywallWrapper, m as mantlePaywall } from './nextjs-TFhFiQuL.js';
+export { N as NextJSHandler, a as NextJSPaywallWrapper, P as PaywallErrorResponse, i as isPaywallErrorResponse, m as mantlePaywall } from './nextjs-BgyAWzT3.js';
 export { M as MinimalPaywallOptions, c as PaymentCheckInput, d as PaymentCheckResult, P as PaymentLogEntry, R as RouteKey, a as RoutePricingConfig, b as RoutesConfig, T as TelemetryConfig } from './types-CqQ6OgRi.js';
 export { A as AssetConfig, a as Authorization, E as EIP1193Provider, N as NetworkId, d as PaymentHeaderBase64, c as PaymentHeaderObject, b as PaymentHeaderPayload, P as PaymentRequirements } from './types-BFUqKBBO.js';
 export { M as MANTLE_DEFAULTS } from './constants-0ncqvV_O.js';

package/dist/server-nextjs.js

@@ -1,11 +1,13 @@
 import {
+  isPaywallErrorResponse,
   mantlePaywall
-} from "./chunk-CXRILT3C.js";
+} from "./chunk-IT6VV6YL.js";
 import "./chunk-ZLCKBFVJ.js";
 import {
   MANTLE_DEFAULTS
 } from "./chunk-HEZZ74SI.js";
 export {
   MANTLE_DEFAULTS,
+  isPaywallErrorResponse,
   mantlePaywall
 };

package/dist/server.cjs

@@ -378,6 +378,7 @@ function mantlePaywall(opts) {
 // src/server/adapters/nextjs.ts
 var nextjs_exports = {};
 __export(nextjs_exports, {
+  isPaywallErrorResponse: () => isPaywallErrorResponse,
   mantlePaywall: () => mantlePaywall2
 });
 var import_server = require("next/server");
@@ -426,6 +427,9 @@ function mantlePaywall2(opts) {
     };
   };
 }
+function isPaywallErrorResponse(response) {
+  return typeof response === "object" && response !== null && "error" in response && typeof response.error === "string";
+}
 
 // src/server/adapters/web-standards.ts
 var web_standards_exports = {};

package/dist/server.d.cts

@@ -2,7 +2,7 @@ import { c as PaymentCheckInput, d as PaymentCheckResult } from './types-CrOsOHc
 export { M as MinimalPaywallOptions, P as PaymentLogEntry, R as RouteKey, a as RoutePricingConfig, b as RoutesConfig, T as TelemetryConfig } from './types-CrOsOHcX.cjs';
 import { c as PaymentHeaderObject } from './types-BFUqKBBO.cjs';
 export { M as MantleMiddleware, c as createPaymentMiddleware, e as express, m as mantlePaywall } from './express-eQOPxfnI.cjs';
-export { n as nextjs } from './nextjs-Duecps0q.cjs';
+export { n as nextjs } from './nextjs-CY13JXkV.cjs';
 export { w as web } from './web-standards-BNQyWzBC.cjs';
 import { P as PaymentLogEntry, T as TelemetryConfig, c as TelemetryEvent } from './types-CoOdbZSp.cjs';
 import 'express';

package/dist/server.d.ts

@@ -2,7 +2,7 @@ import { c as PaymentCheckInput, d as PaymentCheckResult } from './types-CqQ6OgR
 export { M as MinimalPaywallOptions, P as PaymentLogEntry, R as RouteKey, a as RoutePricingConfig, b as RoutesConfig, T as TelemetryConfig } from './types-CqQ6OgRi.js';
 import { c as PaymentHeaderObject } from './types-BFUqKBBO.js';
 export { M as MantleMiddleware, c as createPaymentMiddleware, e as express, m as mantlePaywall } from './express-D8EwEcOL.js';
-export { n as nextjs } from './nextjs-TFhFiQuL.js';
+export { n as nextjs } from './nextjs-BgyAWzT3.js';
 export { w as web } from './web-standards-D8j1kZxd.js';
 import { P as PaymentLogEntry, T as TelemetryConfig, c as TelemetryEvent } from './types-DTzov_EE.js';
 import 'express';

package/dist/server.js

@@ -6,7 +6,7 @@ import {
 } from "./chunk-QWQUSRLY.js";
 import {
   nextjs_exports
-} from "./chunk-CXRILT3C.js";
+} from "./chunk-IT6VV6YL.js";
 import {
   web_standards_exports
 } from "./chunk-ZROK2XOB.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@puga-labs/x402-mantle-sdk",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "description": "x402 payments SDK for Mantle (USDC, gasless, facilitator-based)",
   "license": "MIT",
   "author": "Evgenii Pugachev <cyprus.pugamuga@gmail.com>",