@better-webhook/cli 3.6.0 → 3.7.0

package/README.md

@@ -165,10 +165,12 @@ Start a server to capture incoming webhooks. All captured webhooks are saved to
 better-webhook capture [options]
 ```
 
-| Option              | Description       | Default   |
-| ------------------- | ----------------- | --------- |
-| `-p, --port <port>` | Port to listen on | `3001`    |
-| `-h, --host <host>` | Host to bind to   | `0.0.0.0` |
+| Option              | Description              | Default   |
+| ------------------- | ------------------------ | --------- |
+| `-p, --port <port>` | Port to listen on        | `3001`    |
+| `-h, --host <host>` | Host to bind to          | `0.0.0.0` |
+| `-v, --verbose`     | Show raw request details |           |
+| `--debug`           | Alias for `--verbose`    |           |
 
 **Features:**
 
@@ -176,11 +178,15 @@ better-webhook capture [options]
 - Saves full request including headers, body, query params
 - WebSocket server for real-time notifications
 - Returns capture ID in response for easy reference
+- `--verbose/--debug` prints raw request data; use with care since it may include sensitive payloads
 
 **Example:**
 
 ```bash
 better-webhook capture --port 4000 --host localhost
+
+# Show request headers + raw body
+better-webhook capture --verbose
 ```
 
 ---

package/dist/index.cjs

@@ -1297,11 +1297,13 @@ var CaptureServer = class {
   captureCount = 0;
   enableWebSocket;
   onCapture;
+  verbose;
   constructor(options) {
     const capturesDir = typeof options === "string" ? options : options?.capturesDir;
     this.capturesDir = capturesDir || (0, import_path2.join)((0, import_os2.homedir)(), ".better-webhook", "captures");
     this.enableWebSocket = typeof options === "object" ? options?.enableWebSocket !== false : true;
     this.onCapture = typeof options === "object" ? options?.onCapture : void 0;
+    this.verbose = typeof options === "object" ? options?.verbose === true : false;
     if (!(0, import_fs2.existsSync)(this.capturesDir)) {
       (0, import_fs2.mkdirSync)(this.capturesDir, { recursive: true });
     }
@@ -1399,7 +1401,16 @@ var CaptureServer = class {
     const timestamp = (/* @__PURE__ */ new Date()).toISOString();
     const id = (0, import_crypto2.randomUUID)();
     const url = req.url || "/";
-    const urlParts = new URL(url, `http://${req.headers.host || "localhost"}`);
+    const hostHeader = req.headers.host;
+    const hostValue = typeof hostHeader === "string" ? hostHeader : "";
+    const isHostSafe = /^[a-z0-9.-]+(:\d+)?$/i.test(hostValue);
+    const baseUrl = isHostSafe ? `http://${hostValue}` : "http://localhost";
+    let urlParts;
+    try {
+      urlParts = new URL(url, baseUrl);
+    } catch {
+      urlParts = new URL(url, "http://localhost");
+    }
     const query = {};
     for (const [key, value] of urlParts.searchParams.entries()) {
       if (query[key]) {
@@ -1459,6 +1470,34 @@ var CaptureServer = class {
       console.log(
         `\u{1F4E6} ${req.method} ${urlParts.pathname}${providerStr} -> ${filename}`
       );
+      if (this.verbose) {
+        const headerEntries = Object.entries(req.headers).map(([key, value]) => {
+          if (Array.isArray(value)) {
+            return `${key}: ${value.join(", ")}`;
+          }
+          if (value === void 0) {
+            return `${key}:`;
+          }
+          return `${key}: ${value}`;
+        }).join("\n");
+        const method = req.method || "GET";
+        const providerLabel = provider || "unknown";
+        const contentTypeLabel = contentType || "(none)";
+        console.log(
+          [
+            "[debug] request",
+            `method: ${method}`,
+            `path: ${urlParts.pathname}`,
+            `provider: ${providerLabel}`,
+            `content-type: ${contentTypeLabel}`,
+            `body-length: ${rawBody.length}`,
+            "headers:",
+            headerEntries || "(none)",
+            "raw-body:",
+            rawBody
+          ].join("\n")
+        );
+      }
       this.onCapture?.({ file: filename, capture: captured });
       if (this.enableWebSocket) {
         this.broadcast({
@@ -1594,27 +1633,30 @@ var CaptureServer = class {
 };
 
 // src/commands/capture.ts
-var capture = new import_commander3.Command().name("capture").description("Start a server to capture incoming webhooks").option("-p, --port <port>", "Port to listen on", "3001").option("-h, --host <host>", "Host to bind to", "0.0.0.0").action(async (options) => {
-  const port = parseInt(options.port, 10);
-  if (isNaN(port) || port < 0 || port > 65535) {
-    console.error(import_chalk3.default.red("Invalid port number"));
-    process.exitCode = 1;
-    return;
-  }
-  const server = new CaptureServer();
-  try {
-    await server.start(port, options.host);
-    const shutdown = async () => {
-      await server.stop();
-      process.exit(0);
-    };
-    process.on("SIGINT", shutdown);
-    process.on("SIGTERM", shutdown);
-  } catch (error) {
-    console.error(import_chalk3.default.red(`Failed to start server: ${error.message}`));
-    process.exitCode = 1;
+var capture = new import_commander3.Command().name("capture").description("Start a server to capture incoming webhooks").option("-p, --port <port>", "Port to listen on", "3001").option("-h, --host <host>", "Host to bind to", "0.0.0.0").option("-v, --verbose", "Show raw request details").option("--debug", "Alias for --verbose").action(
+  async (options) => {
+    const port = parseInt(options.port, 10);
+    if (isNaN(port) || port < 0 || port > 65535) {
+      console.error(import_chalk3.default.red("Invalid port number"));
+      process.exitCode = 1;
+      return;
+    }
+    const verbose = Boolean(options.verbose || options.debug);
+    const server = new CaptureServer({ verbose });
+    try {
+      await server.start(port, options.host);
+      const shutdown = async () => {
+        await server.stop();
+        process.exit(0);
+      };
+      process.on("SIGINT", shutdown);
+      process.on("SIGTERM", shutdown);
+    } catch (error) {
+      console.error(import_chalk3.default.red(`Failed to start server: ${error.message}`));
+      process.exitCode = 1;
+    }
   }
-});
+);
 
 // src/commands/captures.ts
 var import_commander4 = require("commander");

package/dist/index.js

@@ -1291,11 +1291,13 @@ var CaptureServer = class {
   captureCount = 0;
   enableWebSocket;
   onCapture;
+  verbose;
   constructor(options) {
     const capturesDir = typeof options === "string" ? options : options?.capturesDir;
     this.capturesDir = capturesDir || join2(homedir2(), ".better-webhook", "captures");
     this.enableWebSocket = typeof options === "object" ? options?.enableWebSocket !== false : true;
     this.onCapture = typeof options === "object" ? options?.onCapture : void 0;
+    this.verbose = typeof options === "object" ? options?.verbose === true : false;
     if (!existsSync2(this.capturesDir)) {
       mkdirSync2(this.capturesDir, { recursive: true });
     }
@@ -1393,7 +1395,16 @@ var CaptureServer = class {
     const timestamp = (/* @__PURE__ */ new Date()).toISOString();
     const id = randomUUID();
     const url = req.url || "/";
-    const urlParts = new URL(url, `http://${req.headers.host || "localhost"}`);
+    const hostHeader = req.headers.host;
+    const hostValue = typeof hostHeader === "string" ? hostHeader : "";
+    const isHostSafe = /^[a-z0-9.-]+(:\d+)?$/i.test(hostValue);
+    const baseUrl = isHostSafe ? `http://${hostValue}` : "http://localhost";
+    let urlParts;
+    try {
+      urlParts = new URL(url, baseUrl);
+    } catch {
+      urlParts = new URL(url, "http://localhost");
+    }
     const query = {};
     for (const [key, value] of urlParts.searchParams.entries()) {
       if (query[key]) {
@@ -1453,6 +1464,34 @@ var CaptureServer = class {
       console.log(
         `\u{1F4E6} ${req.method} ${urlParts.pathname}${providerStr} -> ${filename}`
       );
+      if (this.verbose) {
+        const headerEntries = Object.entries(req.headers).map(([key, value]) => {
+          if (Array.isArray(value)) {
+            return `${key}: ${value.join(", ")}`;
+          }
+          if (value === void 0) {
+            return `${key}:`;
+          }
+          return `${key}: ${value}`;
+        }).join("\n");
+        const method = req.method || "GET";
+        const providerLabel = provider || "unknown";
+        const contentTypeLabel = contentType || "(none)";
+        console.log(
+          [
+            "[debug] request",
+            `method: ${method}`,
+            `path: ${urlParts.pathname}`,
+            `provider: ${providerLabel}`,
+            `content-type: ${contentTypeLabel}`,
+            `body-length: ${rawBody.length}`,
+            "headers:",
+            headerEntries || "(none)",
+            "raw-body:",
+            rawBody
+          ].join("\n")
+        );
+      }
       this.onCapture?.({ file: filename, capture: captured });
       if (this.enableWebSocket) {
         this.broadcast({
@@ -1588,27 +1627,30 @@ var CaptureServer = class {
 };
 
 // src/commands/capture.ts
-var capture = new Command3().name("capture").description("Start a server to capture incoming webhooks").option("-p, --port <port>", "Port to listen on", "3001").option("-h, --host <host>", "Host to bind to", "0.0.0.0").action(async (options) => {
-  const port = parseInt(options.port, 10);
-  if (isNaN(port) || port < 0 || port > 65535) {
-    console.error(chalk3.red("Invalid port number"));
-    process.exitCode = 1;
-    return;
-  }
-  const server = new CaptureServer();
-  try {
-    await server.start(port, options.host);
-    const shutdown = async () => {
-      await server.stop();
-      process.exit(0);
-    };
-    process.on("SIGINT", shutdown);
-    process.on("SIGTERM", shutdown);
-  } catch (error) {
-    console.error(chalk3.red(`Failed to start server: ${error.message}`));
-    process.exitCode = 1;
+var capture = new Command3().name("capture").description("Start a server to capture incoming webhooks").option("-p, --port <port>", "Port to listen on", "3001").option("-h, --host <host>", "Host to bind to", "0.0.0.0").option("-v, --verbose", "Show raw request details").option("--debug", "Alias for --verbose").action(
+  async (options) => {
+    const port = parseInt(options.port, 10);
+    if (isNaN(port) || port < 0 || port > 65535) {
+      console.error(chalk3.red("Invalid port number"));
+      process.exitCode = 1;
+      return;
+    }
+    const verbose = Boolean(options.verbose || options.debug);
+    const server = new CaptureServer({ verbose });
+    try {
+      await server.start(port, options.host);
+      const shutdown = async () => {
+        await server.stop();
+        process.exit(0);
+      };
+      process.on("SIGINT", shutdown);
+      process.on("SIGTERM", shutdown);
+    } catch (error) {
+      console.error(chalk3.red(`Failed to start server: ${error.message}`));
+      process.exitCode = 1;
+    }
   }
-});
+);
 
 // src/commands/captures.ts
 import { Command as Command4 } from "commander";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@better-webhook/cli",
-  "version": "3.6.0",
+  "version": "3.7.0",
   "description": "Modern CLI for developing, capturing, and replaying webhooks locally with dashboard UI.",
   "type": "module",
   "bin": {