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

package/dist/server-nextjs.cjs

@@ -140,9 +140,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 {
@@ -154,17 +165,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,
@@ -252,6 +275,10 @@ async function checkPayment(input) {
           facilitatorUrl,
           paymentRequirements
         };
+        debugLog(telemetry, "verify", "\u2705 Payment verified", {
+          nonce: authorization.nonce,
+          route: routeKey
+        });
         if (onPaymentSettled) {
           onPaymentSettled(baseLogEntry);
         }
@@ -264,17 +291,33 @@ 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).catch(
+        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,
@@ -301,6 +344,12 @@ async function checkPayment(input) {
 }
 
 // src/server/adapters/nextjs.ts
+function debugLog2(config, prefix, message, data) {
+  if (config?.debug) {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    console.log(`[${timestamp}] [x402-debug:${prefix}]`, message, data || "");
+  }
+}
 function mantlePaywall(opts) {
   const { priceUsd, payTo, facilitatorUrl, apiKey, telemetry, onPaymentSettled } = opts;
   validateAddress(payTo, "payTo");
@@ -344,14 +393,21 @@ function mantlePaywall(opts) {
         });
       }
       try {
+        debugLog2(telemetry, "handler", "\u25B6\uFE0F Handler execution started");
         const response = await handler(req);
+        debugLog2(telemetry, "handler", `\u2705 Handler completed: ${response.status}`);
         if (result.sendTelemetryAfterResponse) {
+          debugLog2(telemetry, "callback", `\u{1F4E4} Calling telemetry callback with status ${response.status}`);
           result.sendTelemetryAfterResponse(response.status);
+        } else {
+          debugLog2(telemetry, "callback", "\u26A0\uFE0F No telemetry callback to call");
         }
         return response;
       } catch (err) {
         const errorMessage = err instanceof Error ? err.message : "Unknown error";
+        debugLog2(telemetry, "handler", `\u274C Handler error: ${errorMessage}`);
         if (result.sendTelemetryAfterResponse) {
+          debugLog2(telemetry, "callback", "\u{1F4E4} Calling telemetry callback with error");
           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-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 { N as NextJSHandler, a as NextJSPaywallWrapper, P as PaywallErrorResponse, i as isPaywallErrorResponse, m as mantlePaywall } from './nextjs-Bujo9Okf.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-BkGUHT4x.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-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 { N as NextJSHandler, a as NextJSPaywallWrapper, P as PaywallErrorResponse, i as isPaywallErrorResponse, m as mantlePaywall } from './nextjs-CzSejZe8.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-Ba0v9XsC.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-CKBTOS7X.js";
-import "./chunk-IXIFGPJ2.js";
+} from "./chunk-P5FKQVHW.js";
+import "./chunk-UVYA6H32.js";
 import {
   MANTLE_DEFAULTS
 } from "./chunk-HEZZ74SI.js";

package/dist/server-web.cjs

@@ -136,9 +136,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 {
@@ -150,17 +161,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,
@@ -248,6 +271,10 @@ async function checkPayment(input) {
           facilitatorUrl,
           paymentRequirements
         };
+        debugLog(telemetry, "verify", "\u2705 Payment verified", {
+          nonce: authorization.nonce,
+          route: routeKey
+        });
         if (onPaymentSettled) {
           onPaymentSettled(baseLogEntry);
         }
@@ -260,17 +287,33 @@ 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).catch(
+        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,
@@ -297,6 +340,12 @@ async function checkPayment(input) {
 }
 
 // src/server/adapters/web-standards.ts
+function debugLog2(config, prefix, message, data) {
+  if (config?.debug) {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    console.log(`[${timestamp}] [x402-debug:${prefix}]`, message, data || "");
+  }
+}
 function mantlePaywall(opts) {
   const { priceUsd, payTo, facilitatorUrl, apiKey, telemetry, onPaymentSettled } = opts;
   validateAddress(payTo, "payTo");
@@ -343,14 +392,21 @@ function mantlePaywall(opts) {
         });
       }
       try {
+        debugLog2(telemetry, "handler", "\u25B6\uFE0F Handler execution started");
         const response = await handler(request);
+        debugLog2(telemetry, "handler", `\u2705 Handler completed: ${response.status}`);
         if (result.sendTelemetryAfterResponse) {
+          debugLog2(telemetry, "callback", `\u{1F4E4} Calling telemetry callback with status ${response.status}`);
           result.sendTelemetryAfterResponse(response.status);
+        } else {
+          debugLog2(telemetry, "callback", "\u26A0\uFE0F No telemetry callback to call");
         }
         return response;
       } catch (err) {
         const errorMessage = err instanceof Error ? err.message : "Unknown error";
+        debugLog2(telemetry, "handler", `\u274C Handler error: ${errorMessage}`);
         if (result.sendTelemetryAfterResponse) {
+          debugLog2(telemetry, "callback", "\u{1F4E4} Calling telemetry callback with error");
           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-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 { W as WebHandler, a as WebPaywallWrapper, m as mantlePaywall } from './web-standards-QCbyQ14G.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-BkGUHT4x.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-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 { W as WebHandler, a as WebPaywallWrapper, m as mantlePaywall } from './web-standards-DsCZRJPE.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-Ba0v9XsC.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-T4DIHTBP.js";
-import "./chunk-IXIFGPJ2.js";
+} from "./chunk-JXMWK3BO.js";
+import "./chunk-UVYA6H32.js";
 import {
   MANTLE_DEFAULTS
 } from "./chunk-HEZZ74SI.js";

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,
@@ -258,6 +281,10 @@ async function checkPayment(input) {
           facilitatorUrl,
           paymentRequirements
         };
+        debugLog(telemetry, "verify", "\u2705 Payment verified", {
+          nonce: authorization.nonce,
+          route: routeKey
+        });
         if (onPaymentSettled) {
           onPaymentSettled(baseLogEntry);
         }
@@ -270,17 +297,33 @@ 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).catch(
+        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,
@@ -312,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) {
@@ -362,17 +411,24 @@ 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();
   };
@@ -409,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");
@@ -452,14 +514,21 @@ function mantlePaywall2(opts) {
         });
       }
       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;
@@ -476,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");
@@ -522,14 +597,21 @@ function mantlePaywall3(opts) {
         });
       }
       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-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 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-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';
+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-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 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-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';
+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-IEJB5W26.js";
+} from "./chunk-3DGAB7HD.js";
 import {
   nextjs_exports
-} from "./chunk-CKBTOS7X.js";
+} from "./chunk-P5FKQVHW.js";
 import {
   web_standards_exports
-} from "./chunk-T4DIHTBP.js";
+} from "./chunk-JXMWK3BO.js";
 import {
   DEFAULT_TELEMETRY_ENDPOINT,
   buildRouteKey,
@@ -18,7 +18,7 @@ import {
   decodePaymentHeader,
   sendTelemetry,
   validateAddress
-} from "./chunk-IXIFGPJ2.js";
+} from "./chunk-UVYA6H32.js";
 import "./chunk-HEZZ74SI.js";
 export {
   DEFAULT_TELEMETRY_ENDPOINT,