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

package/dist/server.cjs

@@ -146,9 +146,20 @@ function createTelemetryEvent(entry, config) {
     priceUsd: entry.paymentRequirements?.price
   };
 }
-async function sendTelemetry(event, endpoint) {
+async function sendTelemetry(event, endpoint, debug) {
   const targetEndpoint = endpoint ?? DEFAULT_TELEMETRY_ENDPOINT;
+  if (debug) {
+    console.log(`[x402-debug:telemetry] \u{1F4E4} Sending telemetry event:`, {
+      event: event.event,
+      endpoint: targetEndpoint,
+      projectKey: event.projectKey.substring(0, 10) + "...",
+      route: event.route,
+      responseStatus: event.responseStatus,
+      serviceDelivered: event.serviceDelivered
+    });
+  }
   if (!targetEndpoint) {
+    if (debug) console.log(`[x402-debug:telemetry] \u26A0\uFE0F No endpoint configured, skipping`);
     return;
   }
   try {
@@ -160,17 +171,29 @@ async function sendTelemetry(event, endpoint) {
       },
       body: JSON.stringify(event)
     });
+    if (debug) {
+      console.log(`[x402-debug:telemetry] ${response.ok ? "\u2705" : "\u274C"} Telemetry sent: HTTP ${response.status}`);
+    }
     if (!response.ok) {
       console.warn(
         `[x402-telemetry] Failed to send event: HTTP ${response.status}`
       );
     }
   } catch (err) {
+    if (debug) {
+      console.error(`[x402-debug:telemetry] \u274C Error sending:`, err);
+    }
     console.error("[x402-telemetry] Error sending telemetry:", err);
   }
 }
 
 // src/server/core/verifyPayment.ts
+function debugLog(config, prefix, message, data) {
+  if (config?.debug) {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    console.log(`[${timestamp}] [x402-debug:${prefix}]`, message, data || "");
+  }
+}
 async function checkPayment(input) {
   const {
     paymentHeader,
@@ -240,12 +263,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 +281,12 @@ 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)
-          );
+        debugLog(telemetry, "verify", "\u2705 Payment verified", {
+          nonce: authorization.nonce,
+          route: routeKey
+        });
+        if (onPaymentSettled) {
+          onPaymentSettled(baseLogEntry);
         }
       } catch (err) {
         console.error(
@@ -271,11 +295,41 @@ async function checkPayment(input) {
         );
       }
     }
+    const sendTelemetryAfterResponse = telemetry && baseLogEntry ? (responseStatus, error) => {
+      try {
+        debugLog(telemetry, "callback", "\u{1F4E4} Telemetry callback invoked", {
+          responseStatus,
+          hasError: !!error
+        });
+        const event = createTelemetryEvent(baseLogEntry, telemetry);
+        event.responseStatus = responseStatus;
+        event.errorMessage = error;
+        event.serviceDelivered = responseStatus >= 200 && responseStatus < 300;
+        sendTelemetry(event, telemetry.endpoint, telemetry.debug).catch(
+          (err) => console.error("[x402-telemetry] Async send failed:", err)
+        );
+      } catch (err) {
+        console.error("[x402-telemetry] Error creating telemetry event:", err);
+      }
+    } : void 0;
+    if (telemetry && baseLogEntry) {
+      debugLog(telemetry, "callback", "\u2705 Telemetry callback created", {
+        route: routeKey,
+        hasTelemetryConfig: !!telemetry,
+        hasLogEntry: !!baseLogEntry
+      });
+    } else if (telemetry) {
+      debugLog(telemetry, "callback", "\u26A0\uFE0F Telemetry callback NOT created", {
+        hasTelemetryConfig: !!telemetry,
+        hasLogEntry: !!baseLogEntry
+      });
+    }
     return {
       status: "verified",
       statusCode: 200,
       responseBody: null,
-      isValid: true
+      isValid: true,
+      sendTelemetryAfterResponse
     };
   } catch (err) {
     console.error(
@@ -301,6 +355,12 @@ __export(express_exports, {
   createPaymentMiddleware: () => createPaymentMiddleware,
   mantlePaywall: () => mantlePaywall
 });
+function debugLog2(config, prefix, message, data) {
+  if (config?.debug) {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    console.log(`[${timestamp}] [x402-debug:${prefix}]`, message, data || "");
+  }
+}
 function createPaymentMiddleware(config) {
   const { facilitatorUrl, receiverAddress, routes, apiKey, onPaymentSettled, telemetry } = config;
   if (!facilitatorUrl) {
@@ -351,6 +411,25 @@ function createPaymentMiddleware(config) {
       res.status(result.statusCode).json(result.responseBody);
       return;
     }
+    debugLog2(telemetry, "handler", "\u25B6\uFE0F Handler execution started (Express middleware)");
+    if (result.sendTelemetryAfterResponse) {
+      res.on("finish", () => {
+        const statusCode = res.statusCode;
+        debugLog2(telemetry, "handler", `\u2705 Handler completed: ${statusCode}`);
+        const errorMessage = statusCode >= 400 ? `Handler returned ${statusCode}` : void 0;
+        debugLog2(telemetry, "callback", `\u{1F4E4} Calling telemetry callback with status ${statusCode}`);
+        result.sendTelemetryAfterResponse(statusCode, errorMessage);
+      });
+      res.on("close", () => {
+        if (!res.writableEnded) {
+          debugLog2(telemetry, "handler", "\u274C Response closed without finishing");
+          debugLog2(telemetry, "callback", "\u{1F4E4} Calling telemetry callback with error");
+          result.sendTelemetryAfterResponse(500, "Response closed without finishing");
+        }
+      });
+    } else {
+      debugLog2(telemetry, "callback", "\u26A0\uFE0F No telemetry callback to call");
+    }
     next();
   };
 }
@@ -386,6 +465,12 @@ __export(nextjs_exports, {
   mantlePaywall: () => mantlePaywall2
 });
 var import_server = require("next/server");
+function debugLog3(config, prefix, message, data) {
+  if (config?.debug) {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    console.log(`[${timestamp}] [x402-debug:${prefix}]`, message, data || "");
+  }
+}
 function mantlePaywall2(opts) {
   const { priceUsd, payTo, facilitatorUrl, apiKey, telemetry, onPaymentSettled } = opts;
   validateAddress(payTo, "payTo");
@@ -428,7 +513,26 @@ function mantlePaywall2(opts) {
           status: result.statusCode
         });
       }
-      return handler(req);
+      try {
+        debugLog3(telemetry, "handler", "\u25B6\uFE0F Handler execution started");
+        const response = await handler(req);
+        debugLog3(telemetry, "handler", `\u2705 Handler completed: ${response.status}`);
+        if (result.sendTelemetryAfterResponse) {
+          debugLog3(telemetry, "callback", `\u{1F4E4} Calling telemetry callback with status ${response.status}`);
+          result.sendTelemetryAfterResponse(response.status);
+        } else {
+          debugLog3(telemetry, "callback", "\u26A0\uFE0F No telemetry callback to call");
+        }
+        return response;
+      } catch (err) {
+        const errorMessage = err instanceof Error ? err.message : "Unknown error";
+        debugLog3(telemetry, "handler", `\u274C Handler error: ${errorMessage}`);
+        if (result.sendTelemetryAfterResponse) {
+          debugLog3(telemetry, "callback", "\u{1F4E4} Calling telemetry callback with error");
+          result.sendTelemetryAfterResponse(500, errorMessage);
+        }
+        throw err;
+      }
     };
   };
 }
@@ -441,6 +545,12 @@ var web_standards_exports = {};
 __export(web_standards_exports, {
   mantlePaywall: () => mantlePaywall3
 });
+function debugLog4(config, prefix, message, data) {
+  if (config?.debug) {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    console.log(`[${timestamp}] [x402-debug:${prefix}]`, message, data || "");
+  }
+}
 function mantlePaywall3(opts) {
   const { priceUsd, payTo, facilitatorUrl, apiKey, telemetry, onPaymentSettled } = opts;
   validateAddress(payTo, "payTo");
@@ -486,7 +596,26 @@ function mantlePaywall3(opts) {
           }
         });
       }
-      return handler(request);
+      try {
+        debugLog4(telemetry, "handler", "\u25B6\uFE0F Handler execution started");
+        const response = await handler(request);
+        debugLog4(telemetry, "handler", `\u2705 Handler completed: ${response.status}`);
+        if (result.sendTelemetryAfterResponse) {
+          debugLog4(telemetry, "callback", `\u{1F4E4} Calling telemetry callback with status ${response.status}`);
+          result.sendTelemetryAfterResponse(response.status);
+        } else {
+          debugLog4(telemetry, "callback", "\u26A0\uFE0F No telemetry callback to call");
+        }
+        return response;
+      } catch (err) {
+        const errorMessage = err instanceof Error ? err.message : "Unknown error";
+        debugLog4(telemetry, "handler", `\u274C Handler error: ${errorMessage}`);
+        if (result.sendTelemetryAfterResponse) {
+          debugLog4(telemetry, "callback", "\u{1F4E4} Calling telemetry callback with error");
+          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-BkGUHT4x.cjs';
+export { M as MinimalPaywallOptions, P as PaymentLogEntry, R as RouteKey, a as RoutePricingConfig, b as RoutesConfig, T as TelemetryConfig } from './types-BkGUHT4x.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-BWE0nQty.cjs';
+export { n as nextjs } from './nextjs-Bujo9Okf.cjs';
+export { w as web } from './web-standards-QCbyQ14G.cjs';
+import { P as PaymentLogEntry, T as TelemetryConfig, c as TelemetryEvent } from './types-DrBw0xwj.cjs';
 import 'express';
 import 'next/server';
 
@@ -73,7 +73,8 @@ declare function createTelemetryEvent(entry: PaymentLogEntry, config: TelemetryC
  *
  * @param event - The telemetry event to send
  * @param endpoint - The telemetry endpoint URL (optional, falls back to DEFAULT_TELEMETRY_ENDPOINT)
+ * @param debug - Enable debug logging for telemetry transmission
  */
-declare function sendTelemetry(event: TelemetryEvent, endpoint?: string): Promise<void>;
+declare function sendTelemetry(event: TelemetryEvent, endpoint?: string, debug?: boolean): Promise<void>;
 
 export { DEFAULT_TELEMETRY_ENDPOINT, PaymentCheckInput, PaymentCheckResult, buildRouteKey, checkPayment, createTelemetryEvent, decodePaymentHeader, sendTelemetry, validateAddress };

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-Ba0v9XsC.js';
+export { M as MinimalPaywallOptions, P as PaymentLogEntry, R as RouteKey, a as RoutePricingConfig, b as RoutesConfig, T as TelemetryConfig } from './types-Ba0v9XsC.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-BvuN0Lx1.js';
+export { n as nextjs } from './nextjs-CzSejZe8.js';
+export { w as web } from './web-standards-DsCZRJPE.js';
+import { P as PaymentLogEntry, T as TelemetryConfig, c as TelemetryEvent } from './types-DEpSrXCf.js';
 import 'express';
 import 'next/server';
 
@@ -73,7 +73,8 @@ declare function createTelemetryEvent(entry: PaymentLogEntry, config: TelemetryC
  *
  * @param event - The telemetry event to send
  * @param endpoint - The telemetry endpoint URL (optional, falls back to DEFAULT_TELEMETRY_ENDPOINT)
+ * @param debug - Enable debug logging for telemetry transmission
  */
-declare function sendTelemetry(event: TelemetryEvent, endpoint?: string): Promise<void>;
+declare function sendTelemetry(event: TelemetryEvent, endpoint?: string, debug?: boolean): Promise<void>;
 
 export { DEFAULT_TELEMETRY_ENDPOINT, PaymentCheckInput, PaymentCheckResult, buildRouteKey, checkPayment, createTelemetryEvent, decodePaymentHeader, sendTelemetry, validateAddress };

package/dist/server.js

@@ -3,13 +3,13 @@ import {
   createPaymentMiddleware,
   express_exports,
   mantlePaywall
-} from "./chunk-B4GST723.js";
+} from "./chunk-3DGAB7HD.js";
 import {
   nextjs_exports
-} from "./chunk-33WHNZDS.js";
+} from "./chunk-P5FKQVHW.js";
 import {
   web_standards_exports
-} from "./chunk-T63MVWX3.js";
+} from "./chunk-JXMWK3BO.js";
 import {
   DEFAULT_TELEMETRY_ENDPOINT,
   buildRouteKey,
@@ -18,7 +18,7 @@ import {
   decodePaymentHeader,
   sendTelemetry,
   validateAddress
-} from "./chunk-OW2BDRGZ.js";
+} from "./chunk-UVYA6H32.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-Ba0v9XsC.d.ts

@@ -0,0 +1,108 @@
+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;
+    /**
+     * Enable debug logging for telemetry flow.
+     * When true, logs detailed information about payment verification,
+     * handler execution, and telemetry transmission.
+     */
+    debug?: boolean;
+}
+/**
+ * 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-BkGUHT4x.d.cts

@@ -0,0 +1,108 @@
+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;
+    /**
+     * Enable debug logging for telemetry flow.
+     * When true, logs detailed information about payment verification,
+     * handler execution, and telemetry transmission.
+     */
+    debug?: boolean;
+}
+/**
+ * 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 };