@puga-labs/x402-mantle-sdk 0.3.7 → 0.3.9

package/dist/server-express.js

@@ -1,8 +1,8 @@
 import {
   createPaymentMiddleware,
   mantlePaywall
-} from "./chunk-MBJTUNDL.js";
-import "./chunk-EKEVUVF3.js";
+} from "./chunk-IEJB5W26.js";
+import "./chunk-IXIFGPJ2.js";
 import {
   MANTLE_DEFAULTS
 } from "./chunk-HEZZ74SI.js";

package/dist/server-nextjs.cjs

@@ -170,6 +170,7 @@ async function checkPayment(input) {
     paymentHeader,
     paymentRequirements,
     facilitatorUrl,
+    apiKey,
     routeKey,
     network,
     asset,
@@ -193,7 +194,8 @@ async function checkPayment(input) {
     const verifyRes = await fetch(verifyUrl, {
       method: "POST",
       headers: {
-        "Content-Type": "application/json"
+        "Content-Type": "application/json",
+        ...apiKey && { "Authorization": `Bearer ${apiKey}` }
       },
       body: JSON.stringify({
         x402Version: 1,
@@ -232,12 +234,13 @@ async function checkPayment(input) {
         isValid: false
       };
     }
-    if (onPaymentSettled) {
+    let baseLogEntry = null;
+    if (onPaymentSettled || telemetry) {
       try {
         const headerObj = decodePaymentHeader(paymentHeader);
         const { authorization } = headerObj.payload;
         const assetConfig = getDefaultAssetForNetwork(network);
-        const logEntry = {
+        baseLogEntry = {
           id: authorization.nonce,
           from: authorization.from,
           to: authorization.to,
@@ -249,12 +252,8 @@ async function checkPayment(input) {
           facilitatorUrl,
           paymentRequirements
         };
-        onPaymentSettled(logEntry);
-        if (telemetry) {
-          const event = createTelemetryEvent(logEntry, telemetry);
-          sendTelemetry(event, telemetry.endpoint).catch(
-            (err) => console.error("[x402-telemetry] Async send failed:", err)
-          );
+        if (onPaymentSettled) {
+          onPaymentSettled(baseLogEntry);
         }
       } catch (err) {
         console.error(
@@ -263,11 +262,25 @@ async function checkPayment(input) {
         );
       }
     }
+    const sendTelemetryAfterResponse = telemetry && baseLogEntry ? (responseStatus, error) => {
+      try {
+        const event = createTelemetryEvent(baseLogEntry, telemetry);
+        event.responseStatus = responseStatus;
+        event.errorMessage = error;
+        event.serviceDelivered = responseStatus >= 200 && responseStatus < 300;
+        sendTelemetry(event, telemetry.endpoint).catch(
+          (err) => console.error("[x402-telemetry] Async send failed:", err)
+        );
+      } catch (err) {
+        console.error("[x402-telemetry] Error creating telemetry event:", err);
+      }
+    } : void 0;
     return {
       status: "verified",
       statusCode: 200,
       responseBody: null,
-      isValid: true
+      isValid: true,
+      sendTelemetryAfterResponse
     };
   } catch (err) {
     console.error(
@@ -289,7 +302,7 @@ async function checkPayment(input) {
 
 // src/server/adapters/nextjs.ts
 function mantlePaywall(opts) {
-  const { priceUsd, payTo, facilitatorUrl, telemetry, onPaymentSettled } = opts;
+  const { priceUsd, payTo, facilitatorUrl, apiKey, telemetry, onPaymentSettled } = opts;
   validateAddress(payTo, "payTo");
   const priceUsdCents = Math.round(priceUsd * 100);
   return function(handler) {
@@ -318,6 +331,7 @@ function mantlePaywall(opts) {
         paymentHeader,
         paymentRequirements,
         facilitatorUrl: facilitatorUrl || MANTLE_DEFAULTS.FACILITATOR_URL,
+        apiKey,
         routeKey,
         network,
         asset: assetConfig.address,
@@ -329,7 +343,19 @@ function mantlePaywall(opts) {
           status: result.statusCode
         });
       }
-      return handler(req);
+      try {
+        const response = await handler(req);
+        if (result.sendTelemetryAfterResponse) {
+          result.sendTelemetryAfterResponse(response.status);
+        }
+        return response;
+      } catch (err) {
+        const errorMessage = err instanceof Error ? err.message : "Unknown error";
+        if (result.sendTelemetryAfterResponse) {
+          result.sendTelemetryAfterResponse(500, errorMessage);
+        }
+        throw err;
+      }
     };
   };
 }

package/dist/server-nextjs.d.cts

@@ -1,5 +1,5 @@
-export { N as NextJSHandler, a as NextJSPaywallWrapper, P as PaywallErrorResponse, i as isPaywallErrorResponse, m as mantlePaywall } from './nextjs-CGOVHJXl.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 { N as NextJSHandler, a as NextJSPaywallWrapper, P as PaywallErrorResponse, i as isPaywallErrorResponse, m as mantlePaywall } from './nextjs-EoISXVEo.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-B87bD2yo.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';
 import 'next/server';

package/dist/server-nextjs.d.ts

@@ -1,5 +1,5 @@
-export { N as NextJSHandler, a as NextJSPaywallWrapper, P as PaywallErrorResponse, i as isPaywallErrorResponse, m as mantlePaywall } from './nextjs-w61gRvpz.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 { N as NextJSHandler, a as NextJSPaywallWrapper, P as PaywallErrorResponse, i as isPaywallErrorResponse, m as mantlePaywall } from './nextjs-DGcN_MGa.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-vicT7qsY.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';
 import 'next/server';

package/dist/server-nextjs.js

@@ -1,8 +1,8 @@
 import {
   isPaywallErrorResponse,
   mantlePaywall
-} from "./chunk-5TTSYEOF.js";
-import "./chunk-EKEVUVF3.js";
+} from "./chunk-CKBTOS7X.js";
+import "./chunk-IXIFGPJ2.js";
 import {
   MANTLE_DEFAULTS
 } from "./chunk-HEZZ74SI.js";

package/dist/server-web.cjs

@@ -166,6 +166,7 @@ async function checkPayment(input) {
     paymentHeader,
     paymentRequirements,
     facilitatorUrl,
+    apiKey,
     routeKey,
     network,
     asset,
@@ -189,7 +190,8 @@ async function checkPayment(input) {
     const verifyRes = await fetch(verifyUrl, {
       method: "POST",
       headers: {
-        "Content-Type": "application/json"
+        "Content-Type": "application/json",
+        ...apiKey && { "Authorization": `Bearer ${apiKey}` }
       },
       body: JSON.stringify({
         x402Version: 1,
@@ -228,12 +230,13 @@ async function checkPayment(input) {
         isValid: false
       };
     }
-    if (onPaymentSettled) {
+    let baseLogEntry = null;
+    if (onPaymentSettled || telemetry) {
       try {
         const headerObj = decodePaymentHeader(paymentHeader);
         const { authorization } = headerObj.payload;
         const assetConfig = getDefaultAssetForNetwork(network);
-        const logEntry = {
+        baseLogEntry = {
           id: authorization.nonce,
           from: authorization.from,
           to: authorization.to,
@@ -245,12 +248,8 @@ async function checkPayment(input) {
           facilitatorUrl,
           paymentRequirements
         };
-        onPaymentSettled(logEntry);
-        if (telemetry) {
-          const event = createTelemetryEvent(logEntry, telemetry);
-          sendTelemetry(event, telemetry.endpoint).catch(
-            (err) => console.error("[x402-telemetry] Async send failed:", err)
-          );
+        if (onPaymentSettled) {
+          onPaymentSettled(baseLogEntry);
         }
       } catch (err) {
         console.error(
@@ -259,11 +258,25 @@ async function checkPayment(input) {
         );
       }
     }
+    const sendTelemetryAfterResponse = telemetry && baseLogEntry ? (responseStatus, error) => {
+      try {
+        const event = createTelemetryEvent(baseLogEntry, telemetry);
+        event.responseStatus = responseStatus;
+        event.errorMessage = error;
+        event.serviceDelivered = responseStatus >= 200 && responseStatus < 300;
+        sendTelemetry(event, telemetry.endpoint).catch(
+          (err) => console.error("[x402-telemetry] Async send failed:", err)
+        );
+      } catch (err) {
+        console.error("[x402-telemetry] Error creating telemetry event:", err);
+      }
+    } : void 0;
     return {
       status: "verified",
       statusCode: 200,
       responseBody: null,
-      isValid: true
+      isValid: true,
+      sendTelemetryAfterResponse
     };
   } catch (err) {
     console.error(
@@ -285,7 +298,7 @@ async function checkPayment(input) {
 
 // src/server/adapters/web-standards.ts
 function mantlePaywall(opts) {
-  const { priceUsd, payTo, facilitatorUrl, telemetry, onPaymentSettled } = opts;
+  const { priceUsd, payTo, facilitatorUrl, apiKey, telemetry, onPaymentSettled } = opts;
   validateAddress(payTo, "payTo");
   const priceUsdCents = Math.round(priceUsd * 100);
   return function(handler) {
@@ -314,6 +327,7 @@ function mantlePaywall(opts) {
         paymentHeader,
         paymentRequirements,
         facilitatorUrl: facilitatorUrl || MANTLE_DEFAULTS.FACILITATOR_URL,
+        apiKey,
         routeKey,
         network,
         asset: assetConfig.address,
@@ -328,7 +342,19 @@ function mantlePaywall(opts) {
           }
         });
       }
-      return handler(request);
+      try {
+        const response = await handler(request);
+        if (result.sendTelemetryAfterResponse) {
+          result.sendTelemetryAfterResponse(response.status);
+        }
+        return response;
+      } catch (err) {
+        const errorMessage = err instanceof Error ? err.message : "Unknown error";
+        if (result.sendTelemetryAfterResponse) {
+          result.sendTelemetryAfterResponse(500, errorMessage);
+        }
+        throw err;
+      }
     };
   };
 }

package/dist/server-web.d.cts

@@ -1,4 +1,4 @@
-export { W as WebHandler, a as WebPaywallWrapper, m as mantlePaywall } from './web-standards-BNQyWzBC.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 { W as WebHandler, a as WebPaywallWrapper, m as mantlePaywall } from './web-standards-C6JwCDmd.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-B87bD2yo.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-web.d.ts

@@ -1,4 +1,4 @@
-export { W as WebHandler, a as WebPaywallWrapper, m as mantlePaywall } from './web-standards-D8j1kZxd.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 { W as WebHandler, a as WebPaywallWrapper, m as mantlePaywall } from './web-standards-BJcdcxD6.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-vicT7qsY.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-web.js

@@ -1,7 +1,7 @@
 import {
   mantlePaywall
-} from "./chunk-F2OTZ3BB.js";
-import "./chunk-EKEVUVF3.js";
+} from "./chunk-T4DIHTBP.js";
+import "./chunk-IXIFGPJ2.js";
 import {
   MANTLE_DEFAULTS
 } from "./chunk-HEZZ74SI.js";

package/dist/server.cjs

@@ -176,6 +176,7 @@ async function checkPayment(input) {
     paymentHeader,
     paymentRequirements,
     facilitatorUrl,
+    apiKey,
     routeKey,
     network,
     asset,
@@ -199,7 +200,8 @@ async function checkPayment(input) {
     const verifyRes = await fetch(verifyUrl, {
       method: "POST",
       headers: {
-        "Content-Type": "application/json"
+        "Content-Type": "application/json",
+        ...apiKey && { "Authorization": `Bearer ${apiKey}` }
       },
       body: JSON.stringify({
         x402Version: 1,
@@ -238,12 +240,13 @@ async function checkPayment(input) {
         isValid: false
       };
     }
-    if (onPaymentSettled) {
+    let baseLogEntry = null;
+    if (onPaymentSettled || telemetry) {
       try {
         const headerObj = decodePaymentHeader(paymentHeader);
         const { authorization } = headerObj.payload;
         const assetConfig = getDefaultAssetForNetwork(network);
-        const logEntry = {
+        baseLogEntry = {
           id: authorization.nonce,
           from: authorization.from,
           to: authorization.to,
@@ -255,12 +258,8 @@ async function checkPayment(input) {
           facilitatorUrl,
           paymentRequirements
         };
-        onPaymentSettled(logEntry);
-        if (telemetry) {
-          const event = createTelemetryEvent(logEntry, telemetry);
-          sendTelemetry(event, telemetry.endpoint).catch(
-            (err) => console.error("[x402-telemetry] Async send failed:", err)
-          );
+        if (onPaymentSettled) {
+          onPaymentSettled(baseLogEntry);
         }
       } catch (err) {
         console.error(
@@ -269,11 +268,25 @@ async function checkPayment(input) {
         );
       }
     }
+    const sendTelemetryAfterResponse = telemetry && baseLogEntry ? (responseStatus, error) => {
+      try {
+        const event = createTelemetryEvent(baseLogEntry, telemetry);
+        event.responseStatus = responseStatus;
+        event.errorMessage = error;
+        event.serviceDelivered = responseStatus >= 200 && responseStatus < 300;
+        sendTelemetry(event, telemetry.endpoint).catch(
+          (err) => console.error("[x402-telemetry] Async send failed:", err)
+        );
+      } catch (err) {
+        console.error("[x402-telemetry] Error creating telemetry event:", err);
+      }
+    } : void 0;
     return {
       status: "verified",
       statusCode: 200,
       responseBody: null,
-      isValid: true
+      isValid: true,
+      sendTelemetryAfterResponse
     };
   } catch (err) {
     console.error(
@@ -300,7 +313,7 @@ __export(express_exports, {
   mantlePaywall: () => mantlePaywall
 });
 function createPaymentMiddleware(config) {
-  const { facilitatorUrl, receiverAddress, routes, onPaymentSettled, telemetry } = config;
+  const { facilitatorUrl, receiverAddress, routes, apiKey, onPaymentSettled, telemetry } = config;
   if (!facilitatorUrl) {
     throw new Error("facilitatorUrl is required");
   }
@@ -338,6 +351,7 @@ function createPaymentMiddleware(config) {
       paymentHeader,
       paymentRequirements,
       facilitatorUrl,
+      apiKey,
       routeKey,
       network,
       asset: assetConfig.address,
@@ -348,11 +362,23 @@ function createPaymentMiddleware(config) {
       res.status(result.statusCode).json(result.responseBody);
       return;
     }
+    if (result.sendTelemetryAfterResponse) {
+      res.on("finish", () => {
+        const statusCode = res.statusCode;
+        const errorMessage = statusCode >= 400 ? `Handler returned ${statusCode}` : void 0;
+        result.sendTelemetryAfterResponse(statusCode, errorMessage);
+      });
+      res.on("close", () => {
+        if (!res.writableEnded) {
+          result.sendTelemetryAfterResponse(500, "Response closed without finishing");
+        }
+      });
+    }
     next();
   };
 }
 function mantlePaywall(opts) {
-  const { priceUsd, payTo, facilitatorUrl, telemetry, onPaymentSettled } = opts;
+  const { priceUsd, payTo, facilitatorUrl, apiKey, telemetry, onPaymentSettled } = opts;
   validateAddress(payTo, "payTo");
   const priceUsdCents = Math.round(priceUsd * 100);
   return async (req, res, next) => {
@@ -368,6 +394,7 @@ function mantlePaywall(opts) {
           network: MANTLE_DEFAULTS.NETWORK
         }
       },
+      apiKey,
       telemetry,
       onPaymentSettled
     });
@@ -383,7 +410,7 @@ __export(nextjs_exports, {
 });
 var import_server = require("next/server");
 function mantlePaywall2(opts) {
-  const { priceUsd, payTo, facilitatorUrl, telemetry, onPaymentSettled } = opts;
+  const { priceUsd, payTo, facilitatorUrl, apiKey, telemetry, onPaymentSettled } = opts;
   validateAddress(payTo, "payTo");
   const priceUsdCents = Math.round(priceUsd * 100);
   return function(handler) {
@@ -412,6 +439,7 @@ function mantlePaywall2(opts) {
         paymentHeader,
         paymentRequirements,
         facilitatorUrl: facilitatorUrl || MANTLE_DEFAULTS.FACILITATOR_URL,
+        apiKey,
         routeKey,
         network,
         asset: assetConfig.address,
@@ -423,7 +451,19 @@ function mantlePaywall2(opts) {
           status: result.statusCode
         });
       }
-      return handler(req);
+      try {
+        const response = await handler(req);
+        if (result.sendTelemetryAfterResponse) {
+          result.sendTelemetryAfterResponse(response.status);
+        }
+        return response;
+      } catch (err) {
+        const errorMessage = err instanceof Error ? err.message : "Unknown error";
+        if (result.sendTelemetryAfterResponse) {
+          result.sendTelemetryAfterResponse(500, errorMessage);
+        }
+        throw err;
+      }
     };
   };
 }
@@ -437,7 +477,7 @@ __export(web_standards_exports, {
   mantlePaywall: () => mantlePaywall3
 });
 function mantlePaywall3(opts) {
-  const { priceUsd, payTo, facilitatorUrl, telemetry, onPaymentSettled } = opts;
+  const { priceUsd, payTo, facilitatorUrl, apiKey, telemetry, onPaymentSettled } = opts;
   validateAddress(payTo, "payTo");
   const priceUsdCents = Math.round(priceUsd * 100);
   return function(handler) {
@@ -466,6 +506,7 @@ function mantlePaywall3(opts) {
         paymentHeader,
         paymentRequirements,
         facilitatorUrl: facilitatorUrl || MANTLE_DEFAULTS.FACILITATOR_URL,
+        apiKey,
         routeKey,
         network,
         asset: assetConfig.address,
@@ -480,7 +521,19 @@ function mantlePaywall3(opts) {
           }
         });
       }
-      return handler(request);
+      try {
+        const response = await handler(request);
+        if (result.sendTelemetryAfterResponse) {
+          result.sendTelemetryAfterResponse(response.status);
+        }
+        return response;
+      } catch (err) {
+        const errorMessage = err instanceof Error ? err.message : "Unknown error";
+        if (result.sendTelemetryAfterResponse) {
+          result.sendTelemetryAfterResponse(500, errorMessage);
+        }
+        throw err;
+      }
     };
   };
 }

package/dist/server.d.cts

@@ -1,10 +1,10 @@
-import { c as PaymentCheckInput, d as PaymentCheckResult } from './types-CrOsOHcX.cjs';
-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 PaymentCheckInput, d as PaymentCheckResult } from './types-B87bD2yo.cjs';
+export { M as MinimalPaywallOptions, P as PaymentLogEntry, R as RouteKey, a as RoutePricingConfig, b as RoutesConfig, T as TelemetryConfig } from './types-B87bD2yo.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-CGOVHJXl.cjs';
-export { w as web } from './web-standards-BNQyWzBC.cjs';
-import { P as PaymentLogEntry, T as TelemetryConfig, c as TelemetryEvent } from './types-CoOdbZSp.cjs';
+export { M as MantleMiddleware, c as createPaymentMiddleware, e as express, m as mantlePaywall } from './express-DqyVgO5n.cjs';
+export { n as nextjs } from './nextjs-EoISXVEo.cjs';
+export { w as web } from './web-standards-C6JwCDmd.cjs';
+import { P as PaymentLogEntry, T as TelemetryConfig, c as TelemetryEvent } from './types-X6DeBEgb.cjs';
 import 'express';
 import 'next/server';
 

package/dist/server.d.ts

@@ -1,10 +1,10 @@
-import { c as PaymentCheckInput, d as PaymentCheckResult } from './types-CqQ6OgRi.js';
-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 PaymentCheckInput, d as PaymentCheckResult } from './types-vicT7qsY.js';
+export { M as MinimalPaywallOptions, P as PaymentLogEntry, R as RouteKey, a as RoutePricingConfig, b as RoutesConfig, T as TelemetryConfig } from './types-vicT7qsY.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-w61gRvpz.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';
+export { M as MantleMiddleware, c as createPaymentMiddleware, e as express, m as mantlePaywall } from './express-DxxlKmmF.js';
+export { n as nextjs } from './nextjs-DGcN_MGa.js';
+export { w as web } from './web-standards-BJcdcxD6.js';
+import { P as PaymentLogEntry, T as TelemetryConfig, c as TelemetryEvent } from './types-DvKDSdL6.js';
 import 'express';
 import 'next/server';
 

package/dist/server.js

@@ -3,13 +3,13 @@ import {
   createPaymentMiddleware,
   express_exports,
   mantlePaywall
-} from "./chunk-MBJTUNDL.js";
+} from "./chunk-IEJB5W26.js";
 import {
   nextjs_exports
-} from "./chunk-5TTSYEOF.js";
+} from "./chunk-CKBTOS7X.js";
 import {
   web_standards_exports
-} from "./chunk-F2OTZ3BB.js";
+} from "./chunk-T4DIHTBP.js";
 import {
   DEFAULT_TELEMETRY_ENDPOINT,
   buildRouteKey,
@@ -18,7 +18,7 @@ import {
   decodePaymentHeader,
   sendTelemetry,
   validateAddress
-} from "./chunk-EKEVUVF3.js";
+} from "./chunk-IXIFGPJ2.js";
 import "./chunk-HEZZ74SI.js";
 export {
   DEFAULT_TELEMETRY_ENDPOINT,

package/dist/types-B87bD2yo.d.cts

@@ -0,0 +1,102 @@
+import { N as NetworkId, P as PaymentRequirements } from './types-BFUqKBBO.cjs';
+
+/** Unique key for a protected route, e.g. "GET /api/protected". */
+type RouteKey = string;
+/** Pricing config for a single route. */
+interface RoutePricingConfig {
+    /** Price in USD cents, e.g. 1 => $0.01. */
+    priceUsdCents: number;
+    /** Network identifier (e.g. "mantle-mainnet"). */
+    network: NetworkId;
+}
+/** Map of route keys to pricing config. */
+type RoutesConfig = Record<RouteKey, RoutePricingConfig>;
+/** Log entry for a successfully settled payment. */
+interface PaymentLogEntry {
+    id: string;
+    from: string;
+    to: string;
+    valueAtomic: string;
+    network: NetworkId;
+    asset: string;
+    route?: RouteKey;
+    txHash?: string;
+    timestamp: number;
+    facilitatorUrl?: string;
+    paymentRequirements?: PaymentRequirements;
+}
+/** Config for optional telemetry (billing/analytics). */
+interface TelemetryConfig {
+    /** Project key from nosubs.ai dashboard. */
+    projectKey: string;
+    /**
+     * Telemetry endpoint URL.
+     * If not specified, uses DEFAULT_TELEMETRY_ENDPOINT (see server/constants.ts).
+     */
+    endpoint?: string;
+}
+/**
+ * Minimal config for mantlePaywall() - simplified API for single-route protection.
+ * This is the "sweet path" for Mantle mainnet + USDC with sensible defaults.
+ */
+interface MinimalPaywallOptions {
+    /** Price in USD (e.g. 0.01 for 1 cent). */
+    priceUsd: number;
+    /** Recipient address (developer wallet). Validated at runtime. */
+    payTo: string;
+    /** Optional facilitator URL (defaults to localhost:8080 or NEXT_PUBLIC_FACILITATOR_URL). */
+    facilitatorUrl?: string;
+    /**
+     * Optional API key for hosted facilitator billing.
+     * Required when using hosted facilitator (e.g., https://facilitator.x402mantlesdk.xyz).
+     * Not needed for self-hosted facilitator.
+     */
+    apiKey?: string;
+    /** Optional telemetry config. */
+    telemetry?: TelemetryConfig;
+    /** Optional payment settled hook. */
+    onPaymentSettled?: (entry: PaymentLogEntry) => void;
+}
+/** Input for checkPayment function. */
+interface PaymentCheckInput {
+    /** X-PAYMENT header value (base64 encoded), or null if not present. */
+    paymentHeader: string | null;
+    /** Payment requirements for this route. */
+    paymentRequirements: PaymentRequirements;
+    /** Facilitator URL for verification. */
+    facilitatorUrl: string;
+    /** Optional API key for hosted facilitator billing. */
+    apiKey?: string;
+    /** Route key for logging, e.g. "POST /api/generate-image". */
+    routeKey?: RouteKey;
+    /** Network ID for this payment. */
+    network: NetworkId;
+    /** Asset address (ERC-20 token). */
+    asset: string;
+    /** Telemetry config (optional). */
+    telemetry?: TelemetryConfig;
+    /** Payment settled callback (optional). */
+    onPaymentSettled?: (entry: PaymentLogEntry) => void;
+}
+/** Result from checkPayment function. */
+interface PaymentCheckResult {
+    /** Status of the payment check. */
+    status: "require_payment" | "verification_error" | "invalid_payment" | "verified";
+    /** HTTP status code to return. */
+    statusCode: 402 | 500 | 200;
+    /** Response body to return (null if verified). */
+    responseBody: any | null;
+    /** Whether payment is valid (only true if status is "verified"). */
+    isValid: boolean;
+    /**
+     * Callback to send telemetry after handler execution.
+     * Only present when payment is verified and telemetry is enabled.
+     * Adapters should call this after the protected route handler completes.
+     *
+     * @param responseStatus - HTTP status code from handler (200, 500, etc.)
+     * @param error - Optional error message if handler threw
+     */
+    sendTelemetryAfterResponse?: (responseStatus: number, error?: string) => void;
+}
+
+export type { MinimalPaywallOptions as M, PaymentLogEntry as P, RouteKey as R, TelemetryConfig as T, RoutePricingConfig as a, RoutesConfig as b, PaymentCheckInput as c, PaymentCheckResult as d };