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

package/dist/server.cjs

@@ -240,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,
@@ -257,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(
@@ -271,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(
@@ -351,6 +362,18 @@ 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();
   };
 }
@@ -428,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;
+      }
     };
   };
 }
@@ -486,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-BmK0G74m.cjs';
-export { M as MinimalPaywallOptions, P as PaymentLogEntry, R as RouteKey, a as RoutePricingConfig, b as RoutesConfig, T as TelemetryConfig } from './types-BmK0G74m.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-Pukmnwuu.cjs';
-export { n as nextjs } from './nextjs-CSUWjcxv.cjs';
-export { w as web } from './web-standards-BvMLEKlU.cjs';
-import { P as PaymentLogEntry, T as TelemetryConfig, c as TelemetryEvent } from './types-BWfKovFm.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-CXdNC0Ra.js';
-export { M as MinimalPaywallOptions, P as PaymentLogEntry, R as RouteKey, a as RoutePricingConfig, b as RoutesConfig, T as TelemetryConfig } from './types-CXdNC0Ra.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-D8L5Dg1D.js';
-export { n as nextjs } from './nextjs-DUdgN0d_.js';
-export { w as web } from './web-standards-g2rYUpgc.js';
-import { P as PaymentLogEntry, T as TelemetryConfig, c as TelemetryEvent } from './types-DgfVPQFb.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-B4GST723.js";
+} from "./chunk-IEJB5W26.js";
 import {
   nextjs_exports
-} from "./chunk-33WHNZDS.js";
+} from "./chunk-CKBTOS7X.js";
 import {
   web_standards_exports
-} from "./chunk-T63MVWX3.js";
+} from "./chunk-T4DIHTBP.js";
 import {
   DEFAULT_TELEMETRY_ENDPOINT,
   buildRouteKey,
@@ -18,7 +18,7 @@ import {
   decodePaymentHeader,
   sendTelemetry,
   validateAddress
-} from "./chunk-OW2BDRGZ.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 };

package/dist/types-DvKDSdL6.d.ts

@@ -0,0 +1,106 @@
+import { Request, Response, NextFunction } from 'express';
+import { N as NetworkId, P as PaymentRequirements } from './types-BFUqKBBO.js';
+
+/** 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).
+     * If both are undefined, telemetry is not sent.
+     */
+    endpoint?: string;
+}
+/** Telemetry event payload for payment_verified. */
+interface TelemetryEvent {
+    event: "payment_verified";
+    ts: number;
+    projectKey: string;
+    network: string;
+    buyer: string;
+    payTo: string;
+    amountAtomic: string;
+    asset: string;
+    decimals: number;
+    nonce: string;
+    route: string;
+    facilitatorType: "hosted" | "self-hosted";
+    facilitatorUrl?: string;
+    facilitatorAddress?: string;
+    txHash?: string;
+    priceUsd?: string;
+    responseStatus?: number;
+    errorMessage?: string;
+    serviceDelivered?: boolean;
+}
+/** Config for createPaymentMiddleware. */
+interface PaymentMiddlewareConfig {
+    /** Base URL of facilitator, e.g. https://facilitator.nosubs.ai */
+    facilitatorUrl: string;
+    /** Recipient address (developer). Validated at runtime. */
+    receiverAddress: string;
+    /** Map of protected routes and their pricing. */
+    routes: RoutesConfig;
+    /**
+     * Optional hook called whenever a payment is successfully settled.
+     * You can use this to push logs into your DB / analytics pipeline.
+     */
+    onPaymentSettled?: (entry: PaymentLogEntry) => void;
+    /** Optional: Send usage telemetry for billing/analytics. */
+    telemetry?: TelemetryConfig;
+}
+/**
+ * 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;
+}
+/**
+ * Express middleware function type for Mantle paywall.
+ * Async function that returns Promise<void>.
+ */
+type MantleMiddleware = (req: Request, res: Response, next: NextFunction) => Promise<void>;
+
+export type { MantleMiddleware as M, PaymentLogEntry as P, RouteKey as R, TelemetryConfig as T, RoutePricingConfig as a, RoutesConfig as b, TelemetryEvent as c, PaymentMiddlewareConfig as d, MinimalPaywallOptions as e };

package/dist/types-X6DeBEgb.d.cts

@@ -0,0 +1,106 @@
+import { Request, Response, NextFunction } from 'express';
+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).
+     * If both are undefined, telemetry is not sent.
+     */
+    endpoint?: string;
+}
+/** Telemetry event payload for payment_verified. */
+interface TelemetryEvent {
+    event: "payment_verified";
+    ts: number;
+    projectKey: string;
+    network: string;
+    buyer: string;
+    payTo: string;
+    amountAtomic: string;
+    asset: string;
+    decimals: number;
+    nonce: string;
+    route: string;
+    facilitatorType: "hosted" | "self-hosted";
+    facilitatorUrl?: string;
+    facilitatorAddress?: string;
+    txHash?: string;
+    priceUsd?: string;
+    responseStatus?: number;
+    errorMessage?: string;
+    serviceDelivered?: boolean;
+}
+/** Config for createPaymentMiddleware. */
+interface PaymentMiddlewareConfig {
+    /** Base URL of facilitator, e.g. https://facilitator.nosubs.ai */
+    facilitatorUrl: string;
+    /** Recipient address (developer). Validated at runtime. */
+    receiverAddress: string;
+    /** Map of protected routes and their pricing. */
+    routes: RoutesConfig;
+    /**
+     * Optional hook called whenever a payment is successfully settled.
+     * You can use this to push logs into your DB / analytics pipeline.
+     */
+    onPaymentSettled?: (entry: PaymentLogEntry) => void;
+    /** Optional: Send usage telemetry for billing/analytics. */
+    telemetry?: TelemetryConfig;
+}
+/**
+ * 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;
+}
+/**
+ * Express middleware function type for Mantle paywall.
+ * Async function that returns Promise<void>.
+ */
+type MantleMiddleware = (req: Request, res: Response, next: NextFunction) => Promise<void>;
+
+export type { MantleMiddleware as M, PaymentLogEntry as P, RouteKey as R, TelemetryConfig as T, RoutePricingConfig as a, RoutesConfig as b, TelemetryEvent as c, PaymentMiddlewareConfig as d, MinimalPaywallOptions as e };

package/dist/types-vicT7qsY.d.ts

@@ -0,0 +1,102 @@
+import { N as NetworkId, P as PaymentRequirements } from './types-BFUqKBBO.js';
+
+/** 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 };

package/dist/web-standards-BJcdcxD6.d.ts

@@ -0,0 +1,77 @@
+import { M as MinimalPaywallOptions } from './types-vicT7qsY.js';
+
+/**
+ * Web Standards route handler type.
+ * Takes a Request and returns a Response.
+ */
+type WebHandler = (request: Request) => Promise<Response>;
+/**
+ * Wrapper function that adds x402 payment verification to Web Standards handler.
+ */
+type WebPaywallWrapper = (handler: WebHandler) => WebHandler;
+/**
+ * Create Web Standards middleware for x402 payment verification.
+ * Uses Mantle mainnet defaults (USDC, exact scheme, etc.).
+ *
+ * Compatible with:
+ * - Hono
+ * - Cloudflare Workers
+ * - Deno
+ * - Bun
+ * - Any platform supporting Web Request/Response API
+ *
+ * @example
+ * ```typescript
+ * // Hono example
+ * import { Hono } from 'hono'
+ * import { mantlePaywall } from '@puga-labs/x402-mantle-sdk/server/web'
+ *
+ * const app = new Hono()
+ * const pay = mantlePaywall({
+ *   priceUsd: 0.01,
+ *   payTo: '0x...',
+ * });
+ *
+ * app.post('/api/generate', pay(async (req) => {
+ *   const body = await req.json();
+ *   // Your handler code here
+ *   return new Response(JSON.stringify({ success: true }), {
+ *     headers: { 'Content-Type': 'application/json' }
+ *   });
+ * }));
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Cloudflare Workers example
+ * import { mantlePaywall } from '@puga-labs/x402-mantle-sdk/server/web'
+ *
+ * const pay = mantlePaywall({
+ *   priceUsd: 0.01,
+ *   payTo: '0x...',
+ * });
+ *
+ * export default {
+ *   async fetch(request: Request) {
+ *     const handler = pay(async (req) => {
+ *       // Your handler code here
+ *       return new Response('Hello World');
+ *     });
+ *     return handler(request);
+ *   }
+ * }
+ * ```
+ *
+ * @param opts - Minimal configuration (price, payTo, optional facilitator/telemetry).
+ * @returns Function that wraps Web Standards handlers with payment verification.
+ */
+declare function mantlePaywall(opts: MinimalPaywallOptions): WebPaywallWrapper;
+
+type webStandards_WebHandler = WebHandler;
+type webStandards_WebPaywallWrapper = WebPaywallWrapper;
+declare const webStandards_mantlePaywall: typeof mantlePaywall;
+declare namespace webStandards {
+  export { type webStandards_WebHandler as WebHandler, type webStandards_WebPaywallWrapper as WebPaywallWrapper, webStandards_mantlePaywall as mantlePaywall };
+}
+
+export { type WebHandler as W, type WebPaywallWrapper as a, mantlePaywall as m, webStandards as w };