@better-webhook/cli 0.2.0 → 0.3.1

package/dist/index.cjs

@@ -1,13 +1,39 @@
 #!/usr/bin/env node
 "use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 
 // src/index.ts
+var import_commander4 = require("commander");
+
+// src/commands/webhooks.ts
 var import_commander = require("commander");
+var import_path2 = require("path");
 var import_fs2 = require("fs");
-var import_path = require("path");
 
-// src/loader.ts
+// src/utils/index.ts
 var import_fs = require("fs");
+var import_path = require("path");
 
 // src/schema.ts
 var import_zod = require("zod");
@@ -43,24 +69,7 @@ ${issues}`);
   return parsed.data;
 }
 
-// src/loader.ts
-function loadWebhookFile(path) {
-  let rawContent;
-  try {
-    rawContent = (0, import_fs.readFileSync)(path, "utf8");
-  } catch (e) {
-    throw new Error(`Failed to read file ${path}: ${e.message}`);
-  }
-  let json;
-  try {
-    json = JSON.parse(rawContent);
-  } catch (e) {
-    throw new Error(`Invalid JSON in file ${path}: ${e.message}`);
-  }
-  return validateWebhookJSON(json, path);
-}
-
-// src/http.ts
+// src/utils/http.ts
 var import_undici = require("undici");
 async function executeWebhook(def) {
   const headerMap = {};
@@ -96,28 +105,232 @@ async function executeWebhook(def) {
   };
 }
 
-// src/index.ts
-var import_undici2 = require("undici");
-var program = new import_commander.Command();
-program.name("better-webhook").description("CLI for listing, downloading and executing predefined webhooks").version("0.2.0");
+// src/utils/index.ts
 function findWebhooksDir(cwd) {
   return (0, import_path.resolve)(cwd, ".webhooks");
 }
 function listWebhookFiles(dir) {
+  return listJsonFiles(dir);
+}
+function findCapturesDir(cwd) {
+  return (0, import_path.resolve)(cwd, ".webhook-captures");
+}
+function listJsonFiles(dir) {
   try {
-    const entries = (0, import_fs2.readdirSync)(dir);
+    const entries = (0, import_fs.readdirSync)(dir);
     return entries.filter(
-      (e) => (0, import_fs2.statSync)((0, import_path.join)(dir, e)).isFile() && (0, import_path.extname)(e) === ".json"
+      (e) => (0, import_fs.statSync)((0, import_path.join)(dir, e)).isFile() && (0, import_path.extname)(e) === ".json"
     );
   } catch {
     return [];
   }
 }
+function loadWebhookFile(path) {
+  let rawContent;
+  try {
+    rawContent = (0, import_fs.readFileSync)(path, "utf8");
+  } catch (e) {
+    throw new Error(`Failed to read file ${path}: ${e.message}`);
+  }
+  let json;
+  try {
+    json = JSON.parse(rawContent);
+  } catch (e) {
+    throw new Error(`Invalid JSON in file ${path}: ${e.message}`);
+  }
+  return validateWebhookJSON(json, path);
+}
+
+// src/commands/webhooks.ts
+var import_fs3 = require("fs");
+var import_undici2 = require("undici");
+
+// src/config.ts
 var TEMPLATE_REPO_BASE = "https://raw.githubusercontent.com/endalk200/better-webhook/main";
 var TEMPLATES = {
   "stripe-invoice.payment_succeeded": "templates/stripe-invoice.payment_succeeded.json"
 };
-program.command("download [name]").description(
+
+// src/commands/webhooks.ts
+var import_prompts = __toESM(require("prompts"), 1);
+var import_ora = __toESM(require("ora"), 1);
+function statExists(p) {
+  try {
+    (0, import_fs2.statSync)(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+var listCommand = new import_commander.Command().name("list").description("List available webhook JSON definitions in .webhooks directory").action(() => {
+  const cwd = process.cwd();
+  const dir = findWebhooksDir(cwd);
+  const files = listWebhookFiles(dir);
+  if (!files.length) {
+    console.log("\u{1F4ED} No webhook definitions found in .webhooks directory.");
+    console.log("\u{1F4A1} Create webhook files or download templates with:");
+    console.log("   better-webhook webhooks download --all");
+    return;
+  }
+  console.log("Available webhook definitions:");
+  files.forEach((f) => console.log(`  \u2022 ${(0, import_path2.basename)(f, ".json")}`));
+});
+var runCommand = new import_commander.Command().name("run").argument(
+  "[nameOrPath]",
+  "Webhook name (in .webhooks) or path to JSON file (optional - will prompt if not provided)"
+).description(
+  "Run a webhook by name (in .webhooks) or by providing a path to a JSON file"
+).option("-u, --url <url>", "Override destination URL").option("-m, --method <method>", "Override HTTP method").action(async (nameOrPath, options = {}) => {
+  const cwd = process.cwd();
+  const webhooksDir = findWebhooksDir(cwd);
+  let selectedNameOrPath = nameOrPath;
+  if (!selectedNameOrPath) {
+    const spinner = (0, import_ora.default)("Loading available webhooks...").start();
+    const localFiles = listWebhookFiles(webhooksDir);
+    const templates = Object.keys(TEMPLATES);
+    spinner.stop();
+    if (localFiles.length === 0 && templates.length === 0) {
+      console.log("\u{1F4ED} No webhook definitions found.");
+      console.log(
+        "\u{1F4A1} Create webhook files in .webhooks directory or download templates with:"
+      );
+      console.log("   better-webhook webhooks download --all");
+      return;
+    }
+    const choices = [];
+    if (localFiles.length > 0) {
+      choices.push(
+        {
+          title: "--- Local Webhooks (.webhooks) ---",
+          description: "",
+          value: "",
+          type: "separator"
+        },
+        ...localFiles.map((file) => ({
+          title: (0, import_path2.basename)(file, ".json"),
+          description: `Local file: ${file}`,
+          value: (0, import_path2.basename)(file, ".json"),
+          type: "local"
+        }))
+      );
+    }
+    if (templates.length > 0) {
+      choices.push(
+        {
+          title: "--- Available Templates ---",
+          description: "",
+          value: "",
+          type: "separator"
+        },
+        ...templates.map((template) => ({
+          title: template,
+          description: `Template: ${TEMPLATES[template]}`,
+          value: template,
+          type: "template"
+        }))
+      );
+    }
+    const response = await (0, import_prompts.default)({
+      type: "select",
+      name: "webhook",
+      message: "Select a webhook to run:",
+      choices: choices.filter((choice) => choice.value !== ""),
+      // Remove separators for selection
+      initial: 0
+    });
+    if (!response.webhook) {
+      console.log("\u274C No webhook selected. Exiting.");
+      process.exitCode = 1;
+      return;
+    }
+    selectedNameOrPath = response.webhook;
+    if (selectedNameOrPath && templates.includes(selectedNameOrPath)) {
+      const downloadSpinner = (0, import_ora.default)(
+        `Downloading template: ${selectedNameOrPath}...`
+      ).start();
+      try {
+        const rel = TEMPLATES[selectedNameOrPath];
+        const rawUrl = `${TEMPLATE_REPO_BASE}/${rel}`;
+        const { statusCode, body } = await (0, import_undici2.request)(rawUrl);
+        if (statusCode !== 200) {
+          throw new Error(`HTTP ${statusCode}`);
+        }
+        const text = await body.text();
+        const json = JSON.parse(text);
+        validateWebhookJSON(json, rawUrl);
+        (0, import_fs3.mkdirSync)(webhooksDir, { recursive: true });
+        const fileName = (0, import_path2.basename)(rel);
+        const destPath = (0, import_path2.join)(webhooksDir, fileName);
+        (0, import_fs3.writeFileSync)(destPath, JSON.stringify(json, null, 2));
+        selectedNameOrPath = (0, import_path2.basename)(fileName, ".json");
+        downloadSpinner.succeed(`Downloaded template: ${selectedNameOrPath}`);
+      } catch (error) {
+        downloadSpinner.fail(`Failed to download template: ${error.message}`);
+        process.exitCode = 1;
+        return;
+      }
+    }
+  }
+  if (!selectedNameOrPath) {
+    console.error("\u274C No webhook selected.");
+    process.exitCode = 1;
+    return;
+  }
+  let filePath;
+  if (selectedNameOrPath.endsWith(".json") && !selectedNameOrPath.includes("/") && !selectedNameOrPath.startsWith(".")) {
+    filePath = (0, import_path2.join)(webhooksDir, selectedNameOrPath);
+  } else {
+    const candidate = (0, import_path2.join)(
+      webhooksDir,
+      selectedNameOrPath + (selectedNameOrPath.endsWith(".json") ? "" : ".json")
+    );
+    if (statExists(candidate)) {
+      filePath = candidate;
+    } else {
+      filePath = (0, import_path2.resolve)(cwd, selectedNameOrPath);
+    }
+  }
+  if (!statExists(filePath)) {
+    console.error(`Webhook file not found: ${filePath}`);
+    process.exitCode = 1;
+    return;
+  }
+  let def;
+  try {
+    def = loadWebhookFile(filePath);
+  } catch (err) {
+    console.error(err.message);
+    process.exitCode = 1;
+    return;
+  }
+  if (options.url) def = { ...def, url: options.url };
+  if (options.method)
+    def = { ...def, method: options.method.toUpperCase() };
+  const executeSpinner = (0, import_ora.default)(
+    `Executing webhook: ${(0, import_path2.basename)(filePath, ".json")}...`
+  ).start();
+  try {
+    const result = await executeWebhook(def);
+    executeSpinner.succeed("Webhook executed successfully!");
+    console.log("Status:", result.status);
+    console.log("Headers:");
+    for (const [k, v] of Object.entries(result.headers)) {
+      console.log(`  ${k}: ${Array.isArray(v) ? v.join(", ") : v}`);
+    }
+    if (result.json !== void 0) {
+      console.log("Response JSON:");
+      console.log(JSON.stringify(result.json, null, 2));
+    } else {
+      console.log("Response Body:");
+      console.log(result.bodyText);
+    }
+  } catch (err) {
+    executeSpinner.fail("Request failed");
+    console.error("Error:", err.message);
+    process.exitCode = 1;
+  }
+});
+var downloadCommand = new import_commander.Command().name("download").argument("[name]", "Template name to download").description(
   "Download official webhook template(s) into the .webhooks directory. If no name is provided, prints available templates."
 ).option("-a, --all", "Download all available templates").option("-f, --force", "Overwrite existing files if they exist").action(
   async (name, opts) => {
@@ -128,12 +341,12 @@ program.command("download [name]").description(
     }
     const cwd = process.cwd();
     const dir = findWebhooksDir(cwd);
-    (0, import_fs2.mkdirSync)(dir, { recursive: true });
+    (0, import_fs3.mkdirSync)(dir, { recursive: true });
     const toDownload = opts.all ? Object.keys(TEMPLATES) : name ? [name] : [];
     if (!toDownload.length) {
       console.log("Available templates:");
       for (const key of Object.keys(TEMPLATES)) console.log(` - ${key}`);
-      console.log("Use: better-webhook download <name> OR --all");
+      console.log("Use: better-webhook webhooks download <name> OR --all");
       return;
     }
     for (const templateName of toDownload) {
@@ -169,15 +382,15 @@ program.command("download [name]").description(
           console.error(`Template failed schema validation: ${e.message}`);
           continue;
         }
-        const fileName = (0, import_path.basename)(rel);
-        const destPath = (0, import_path.join)(dir, fileName);
-        if ((0, import_fs2.existsSync)(destPath) && !opts.force) {
+        const fileName = (0, import_path2.basename)(rel);
+        const destPath = (0, import_path2.join)(dir, fileName);
+        if ((0, import_fs3.existsSync)(destPath) && !opts.force) {
           console.log(
             `Skipping existing file ${fileName} (use --force to overwrite)`
           );
           continue;
         }
-        (0, import_fs2.writeFileSync)(destPath, JSON.stringify(json, null, 2));
+        (0, import_fs3.writeFileSync)(destPath, JSON.stringify(json, null, 2));
         console.log(`Downloaded ${templateName} -> .webhooks/${fileName}`);
       } catch (e) {
         console.error(`Error downloading ${templateName}: ${e.message}`);
@@ -185,75 +398,519 @@ program.command("download [name]").description(
     }
   }
 );
-program.command("list").description("List available webhook JSON definitions in .webhooks directory").action(() => {
-  const cwd = process.cwd();
-  const dir = findWebhooksDir(cwd);
-  const files = listWebhookFiles(dir);
-  if (!files.length) {
-    console.log("No webhook definitions found in .webhooks");
-    return;
+var webhooks = new import_commander.Command().name("webhooks").description("Manage and execute webhook definitions").addCommand(listCommand).addCommand(runCommand).addCommand(downloadCommand);
+
+// src/commands/capture.ts
+var import_commander2 = require("commander");
+var import_fs6 = require("fs");
+var import_path5 = require("path");
+
+// src/capture.ts
+var import_http2 = require("http");
+var import_fs4 = require("fs");
+var import_path3 = require("path");
+var import_crypto = require("crypto");
+var WebhookCaptureServer = class {
+  server = null;
+  capturesDir;
+  constructor(capturesDir) {
+    this.capturesDir = capturesDir;
+    if (!(0, import_fs4.existsSync)(capturesDir)) {
+      (0, import_fs4.mkdirSync)(capturesDir, { recursive: true });
+    }
   }
-  files.forEach((f) => console.log((0, import_path.basename)(f, ".json")));
-});
-program.command("run <nameOrPath>").description(
-  "Run a webhook by name (in .webhooks) or by providing a path to a JSON file"
-).option("-u, --url <url>", "Override destination URL").option("-m, --method <method>", "Override HTTP method").action(async (nameOrPath, options) => {
-  const cwd = process.cwd();
-  let filePath;
-  if (nameOrPath.endsWith(".json") && !nameOrPath.includes("/") && !nameOrPath.startsWith(".")) {
-    filePath = (0, import_path.join)(findWebhooksDir(cwd), nameOrPath);
-  } else {
-    const candidate = (0, import_path.join)(
-      findWebhooksDir(cwd),
-      nameOrPath + (nameOrPath.endsWith(".json") ? "" : ".json")
+  start(startPort = 3001, maxAttempts = 20) {
+    return new Promise((resolve4, reject) => {
+      if (!Number.isInteger(startPort) || startPort < 0 || startPort > 65535) {
+        startPort = 3001;
+      }
+      let attempt = 0;
+      const tryListen = (portToTry) => {
+        this.server = (0, import_http2.createServer)(
+          async (req, res) => {
+            try {
+              await this.handleRequest(req, res);
+            } catch (error) {
+              console.error("Error handling request:", error);
+              res.statusCode = 500;
+              res.end("Internal Server Error");
+            }
+          }
+        );
+        const onError = (err) => {
+          this.server?.off("error", onError);
+          this.server?.off("listening", onListening);
+          if (err && err.code === "EADDRINUSE") {
+            attempt += 1;
+            if (startPort === 0) {
+              reject(new Error("Failed to bind to an ephemeral port."));
+              return;
+            }
+            if (attempt >= maxAttempts) {
+              reject(
+                new Error(
+                  `All ${maxAttempts} port attempts starting at ${startPort} are in use.`
+                )
+              );
+              return;
+            }
+            const nextPort = startPort + attempt;
+            tryListen(nextPort);
+          } else {
+            reject(err);
+          }
+        };
+        const onListening = () => {
+          this.server?.off("error", onError);
+          this.server?.off("listening", onListening);
+          const address = this.server?.address();
+          const actualPort = address?.port ?? portToTry;
+          console.log(
+            `\u{1F3A3} Webhook capture server running on http://localhost:${actualPort}`
+          );
+          console.log(
+            `\u{1F4C1} Captured webhooks will be saved to: ${this.capturesDir}`
+          );
+          console.log(
+            "\u{1F4A1} Send webhooks to any path on this server to capture them"
+          );
+          console.log("\u23F9\uFE0F  Press Ctrl+C to stop the server");
+          resolve4(actualPort);
+        };
+        this.server.on("error", onError);
+        this.server.on("listening", onListening);
+        this.server.listen(portToTry);
+      };
+      tryListen(startPort === 0 ? 0 : startPort);
+    });
+  }
+  stop() {
+    return new Promise((resolve4) => {
+      if (this.server) {
+        this.server.close(() => {
+          console.log("\u{1F4F4} Webhook capture server stopped");
+          resolve4();
+        });
+      } else {
+        resolve4();
+      }
+    });
+  }
+  async handleRequest(req, res) {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    const id = this.generateId();
+    const url = req.url || "/";
+    const urlParts = new URL(url, `http://${req.headers.host || "localhost"}`);
+    const query = {};
+    for (const [key, value] of urlParts.searchParams.entries()) {
+      if (query[key]) {
+        if (Array.isArray(query[key])) {
+          query[key].push(value);
+        } else {
+          query[key] = [query[key], value];
+        }
+      } else {
+        query[key] = value;
+      }
+    }
+    const chunks = [];
+    req.on("data", (chunk) => chunks.push(chunk));
+    await new Promise((resolve4) => {
+      req.on("end", () => resolve4());
+    });
+    const rawBody = Buffer.concat(chunks).toString("utf8");
+    let parsedBody;
+    try {
+      parsedBody = rawBody ? JSON.parse(rawBody) : null;
+    } catch {
+      parsedBody = rawBody || null;
+    }
+    const captured = {
+      id,
+      timestamp,
+      method: req.method || "GET",
+      url: urlParts.pathname,
+      headers: req.headers,
+      body: parsedBody,
+      rawBody,
+      query
+    };
+    const filename = `${timestamp.replace(/[:.]/g, "-")}_${id}.json`;
+    const filepath = (0, import_path3.join)(this.capturesDir, filename);
+    try {
+      (0, import_fs4.writeFileSync)(filepath, JSON.stringify(captured, null, 2));
+      console.log(
+        `\u{1F4E6} Captured ${req.method} ${urlParts.pathname} -> ${filename}`
+      );
+    } catch (error) {
+      console.error(`\u274C Failed to save capture: ${error}`);
+    }
+    res.statusCode = 200;
+    res.setHeader("Content-Type", "application/json");
+    res.end(
+      JSON.stringify(
+        {
+          message: "Webhook captured successfully",
+          id,
+          timestamp,
+          file: filename
+        },
+        null,
+        2
+      )
     );
-    if (statExists(candidate)) {
-      filePath = candidate;
+  }
+  generateId() {
+    try {
+      return (0, import_crypto.randomUUID)();
+    } catch {
+      return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+    }
+  }
+};
+
+// src/replay.ts
+var import_fs5 = require("fs");
+var import_path4 = require("path");
+var WebhookReplayer = class {
+  constructor(capturesDir) {
+    this.capturesDir = capturesDir;
+  }
+  /**
+   * List all captured webhooks
+   */
+  listCaptured() {
+    try {
+      const files = listJsonFiles(this.capturesDir).sort().reverse();
+      return files.map((file) => ({
+        file,
+        capture: this.loadCapture((0, import_path4.join)(this.capturesDir, file))
+      }));
+    } catch {
+      return [];
+    }
+  }
+  /**
+   * Load a specific captured webhook by filename or ID
+   */
+  loadCapture(filePathOrId) {
+    let filepath;
+    if (filePathOrId.includes("/") || filePathOrId.endsWith(".json")) {
+      filepath = filePathOrId;
     } else {
-      filePath = (0, import_path.resolve)(cwd, nameOrPath);
+      const files = listJsonFiles(this.capturesDir).filter(
+        (f) => f.includes(filePathOrId)
+      );
+      if (files.length === 0) {
+        throw new Error(`No capture found with ID: ${filePathOrId}`);
+      }
+      if (files.length > 1) {
+        throw new Error(
+          `Multiple captures found with ID ${filePathOrId}: ${files.join(", ")}`
+        );
+      }
+      filepath = (0, import_path4.join)(this.capturesDir, files[0] ?? "");
+    }
+    try {
+      const content = (0, import_fs5.readFileSync)(filepath, "utf8");
+      return JSON.parse(content);
+    } catch (error) {
+      throw new Error(
+        `Failed to load capture from ${filepath}: ${error.message}`
+      );
     }
   }
-  if (!statExists(filePath)) {
-    console.error(`Webhook file not found: ${filePath}`);
+  /**
+   * Replay a captured webhook to a target URL
+   */
+  async replay(captureId, targetUrl, options = {}) {
+    const capture2 = this.loadCapture(captureId);
+    const webhookDef = {
+      url: options.url || targetUrl,
+      method: options.method || capture2.method,
+      headers: options.headers || this.convertHeaders(capture2.headers),
+      body: capture2.body
+    };
+    console.log(`\u{1F504} Replaying webhook ${capture2.id} (${capture2.timestamp})`);
+    console.log(`   Method: ${webhookDef.method}`);
+    console.log(`   URL: ${webhookDef.url}`);
+    console.log(`   Original: ${capture2.method} ${capture2.url}`);
+    try {
+      const result = await executeWebhook(webhookDef);
+      return result;
+    } catch (error) {
+      throw new Error(`Replay failed: ${error.message}`);
+    }
+  }
+  /**
+   * Convert captured webhook to template format
+   */
+  captureToTemplate(captureId, templateUrl) {
+    const capture2 = this.loadCapture(captureId);
+    return {
+      url: templateUrl || "http://localhost:3000/webhook",
+      method: capture2.method,
+      headers: this.convertHeaders(capture2.headers),
+      body: capture2.body
+    };
+  }
+  /**
+   * Convert captured headers to template format
+   */
+  convertHeaders(headers) {
+    const result = [];
+    for (const [key, value] of Object.entries(headers)) {
+      const skipHeaders = [
+        "host",
+        "content-length",
+        "connection",
+        "accept-encoding",
+        "user-agent",
+        "x-forwarded-for",
+        "x-forwarded-proto"
+      ];
+      if (skipHeaders.includes(key.toLowerCase())) {
+        continue;
+      }
+      if (Array.isArray(value)) {
+        if (value.length === 1) {
+          result.push({ key, value: value[0] ?? "" });
+        } else {
+          result.push({ key, value: value.join(", ") });
+        }
+      } else {
+        result.push({ key, value });
+      }
+    }
+    return result;
+  }
+  /**
+   * Get summary information about a capture
+   */
+  getCaptureSummary(captureId) {
+    const capture2 = this.loadCapture(captureId);
+    const date = new Date(capture2.timestamp);
+    const bodySize = capture2.rawBody ? capture2.rawBody.length : 0;
+    const headerCount = Object.keys(capture2.headers).length;
+    return [
+      `ID: ${capture2.id}`,
+      `Date: ${date.toLocaleString()}`,
+      `Method: ${capture2.method}`,
+      `Path: ${capture2.url}`,
+      `Headers: ${headerCount}`,
+      `Body Size: ${bodySize} bytes`,
+      `Query Params: ${Object.keys(capture2.query).length}`
+    ].join("\n");
+  }
+};
+
+// src/commands/capture.ts
+var listCommand2 = new import_commander2.Command().name("list").description("List captured webhook requests").option("-l, --limit <limit>", "Maximum number of captures to show", "10").action((options) => {
+  const cwd = process.cwd();
+  const capturesDir = findCapturesDir(cwd);
+  const replayer = new WebhookReplayer(capturesDir);
+  const captures = replayer.listCaptured();
+  const limit = parseInt(options.limit, 10);
+  if (Number.isNaN(limit) || limit <= 0) {
+    console.error("Invalid --limit: must be a positive integer.");
     process.exitCode = 1;
     return;
   }
-  let def;
+  if (captures.length === 0) {
+    console.log("No webhook captures found.");
+    console.log(`Run 'better-webhook capture' to start capturing webhooks.`);
+    return;
+  }
+  console.log(
+    `\u{1F4CB} Found ${captures.length} captured webhooks (showing ${Math.min(limit, captures.length)}):
+`
+  );
+  captures.slice(0, limit).forEach(({ file, capture: capture2 }) => {
+    const date = new Date(capture2.timestamp).toLocaleString();
+    const bodySize = capture2.rawBody ? capture2.rawBody.length : 0;
+    console.log(`\u{1F194} ${capture2.id} | \u{1F4C5} ${date}`);
+    console.log(`   ${capture2.method} ${capture2.url} | ${bodySize} bytes`);
+    console.log(`   \u{1F4C4} ${file}
+`);
+  });
+  if (captures.length > limit) {
+    console.log(
+      `... and ${captures.length - limit} more. Use --limit to show more.`
+    );
+  }
+});
+var templateCommand = new import_commander2.Command().name("template").argument("<captureId>", "ID of the captured webhook to create template from").argument("[templateName]", "Name for the generated template").description("Generate a webhook template from a captured request").option(
+  "-u, --url <url>",
+  "Template URL (default: http://localhost:3000/webhook)"
+).option("-o, --output-dir <dir>", "Output directory (default: .webhooks)").action(
+  async (captureId, templateName, options) => {
+    const cwd = process.cwd();
+    const capturesDir = findCapturesDir(cwd);
+    const replayer = new WebhookReplayer(capturesDir);
+    try {
+      const template = replayer.captureToTemplate(captureId, options?.url);
+      if (!templateName) {
+        const capture2 = replayer.loadCapture(captureId);
+        const date = new Date(capture2.timestamp).toISOString().split("T")[0];
+        const pathPart = capture2.url.replace(/[^a-zA-Z0-9]/g, "_").substring(1) || "webhook";
+        templateName = `captured_${date}_${pathPart}_${capture2.id}`;
+      }
+      const outputDir = options?.outputDir ? (0, import_path5.resolve)(cwd, options.outputDir) : findWebhooksDir(cwd);
+      (0, import_fs6.mkdirSync)(outputDir, { recursive: true });
+      const templatePath = (0, import_path5.join)(outputDir, `${templateName}.json`);
+      (0, import_fs6.writeFileSync)(templatePath, JSON.stringify(template, null, 2));
+      console.log(`\u2705 Template created: ${templatePath}`);
+      console.log(
+        `\u{1F504} Run it with: better-webhook webhooks run ${templateName}`
+      );
+      console.log("\n\u{1F4CA} Template Summary:");
+      console.log(replayer.getCaptureSummary(captureId));
+    } catch (error) {
+      console.error("\u274C Template generation failed:", error.message);
+      process.exitCode = 1;
+    }
+  }
+);
+var capture = new import_commander2.Command().name("capture").description(
+  "Start a server to capture incoming webhook requests, or list captured webhooks"
+).option("-p, --port <port>", "Port to listen on", "3001").action(async (options) => {
+  const cwd = process.cwd();
+  const capturesDir = findCapturesDir(cwd);
+  const server = new WebhookCaptureServer(capturesDir);
+  let actualPort;
   try {
-    def = loadWebhookFile(filePath);
-  } catch (err) {
-    console.error(err.message);
+    actualPort = await server.start(parseInt(options.port));
+  } catch (error) {
+    console.error("Failed to start capture server:", error.message);
     process.exitCode = 1;
     return;
   }
-  if (options.url) def = { ...def, url: options.url };
-  if (options.method)
-    def = { ...def, method: options.method.toUpperCase() };
-  try {
-    const result = await executeWebhook(def);
-    console.log("Status:", result.status);
-    console.log("Headers:");
-    for (const [k, v] of Object.entries(result.headers)) {
-      console.log(`  ${k}: ${Array.isArray(v) ? v.join(", ") : v}`);
+  const shutdown = async () => {
+    console.log("\n\u{1F6D1} Shutting down server...");
+    await server.stop();
+    process.exit(0);
+  };
+  process.on("SIGINT", shutdown);
+  process.on("SIGTERM", shutdown);
+}).addCommand(listCommand2).addCommand(templateCommand);
+
+// src/commands/replay.ts
+var import_commander3 = require("commander");
+var import_prompts2 = __toESM(require("prompts"), 1);
+var import_ora2 = __toESM(require("ora"), 1);
+var replay = new import_commander3.Command().name("replay").argument(
+  "[captureId]",
+  "ID of the captured webhook to replay (optional - will prompt if not provided)"
+).argument(
+  "[targetUrl]",
+  "Target URL to replay the webhook to (optional - will prompt if not provided)"
+).description("Replay a captured webhook to a target URL").option("-m, --method <method>", "Override HTTP method").option(
+  "-H, --header <header>",
+  "Add custom header (format: key:value)",
+  (value, previous) => {
+    const [key, ...valueParts] = value.split(":");
+    const headerValue = valueParts.join(":");
+    if (!key || !headerValue) {
+      throw new Error("Header format should be key:value");
     }
-    if (result.json !== void 0) {
-      console.log("Response JSON:");
-      console.log(JSON.stringify(result.json, null, 2));
-    } else {
-      console.log("Response Body:");
-      console.log(result.bodyText);
+    return (previous || []).concat([
+      { key: key.trim(), value: headerValue.trim() }
+    ]);
+  },
+  []
+).action(
+  async (captureId, targetUrl, options = {}) => {
+    const cwd = process.cwd();
+    const capturesDir = findCapturesDir(cwd);
+    const replayer = new WebhookReplayer(capturesDir);
+    const spinner = (0, import_ora2.default)("Loading captured webhooks...").start();
+    const captured = replayer.listCaptured();
+    spinner.stop();
+    if (captured.length === 0) {
+      console.log("\u{1F4ED} No captured webhooks found.");
+      console.log(
+        "\u{1F4A1} Run 'better-webhook capture' to start capturing webhooks first."
+      );
+      return;
+    }
+    let selectedCaptureId = captureId;
+    let selectedTargetUrl = targetUrl;
+    if (!selectedCaptureId) {
+      const choices = captured.map((c) => {
+        const date = new Date(c.capture.timestamp).toLocaleString();
+        const bodySize = c.capture.rawBody?.length ?? 0;
+        return {
+          title: `${c.capture.id} - ${c.capture.method} ${c.capture.url}`,
+          description: `${date} | Body: ${bodySize} bytes`,
+          value: c.capture.id
+        };
+      });
+      const response = await (0, import_prompts2.default)({
+        type: "select",
+        name: "captureId",
+        message: "Select a captured webhook to replay:",
+        choices,
+        initial: 0
+      });
+      if (!response.captureId) {
+        console.log("\u274C No webhook selected. Exiting.");
+        process.exitCode = 1;
+        return;
+      }
+      selectedCaptureId = response.captureId;
+    }
+    if (!selectedTargetUrl) {
+      const response = await (0, import_prompts2.default)({
+        type: "text",
+        name: "targetUrl",
+        message: "Enter the target URL to replay to:",
+        initial: "http://localhost:3000/webhook",
+        validate: (value) => {
+          try {
+            new URL(value);
+            return true;
+          } catch {
+            return "Please enter a valid URL";
+          }
+        }
+      });
+      if (!response.targetUrl) {
+        console.log("\u274C No target URL provided. Exiting.");
+        process.exitCode = 1;
+        return;
+      }
+      selectedTargetUrl = response.targetUrl;
+    }
+    try {
+      const result = await replayer.replay(
+        selectedCaptureId,
+        selectedTargetUrl,
+        {
+          method: options.method,
+          headers: options.header
+        }
+      );
+      console.log("\u2705 Replay completed successfully!");
+      console.log("Status:", result.status);
+      console.log("Headers:");
+      for (const [k, v] of Object.entries(result.headers)) {
+        console.log(`  ${k}: ${Array.isArray(v) ? v.join(", ") : v}`);
+      }
+      if (result.json !== void 0) {
+        console.log("Response JSON:");
+        console.log(JSON.stringify(result.json, null, 2));
+      } else {
+        console.log("Response Body:");
+        console.log(result.bodyText);
+      }
+    } catch (error) {
+      console.error("\u274C Replay failed:", error.message);
+      process.exitCode = 1;
     }
-  } catch (err) {
-    console.error("Request failed:", err.message);
-    process.exitCode = 1;
-  }
-});
-function statExists(p) {
-  try {
-    (0, import_fs2.statSync)(p);
-    return true;
-  } catch {
-    return false;
   }
-}
+);
+
+// src/index.ts
+var program = new import_commander4.Command().name("better-webhook").description("CLI for listing, downloading and executing predefined webhooks").version("0.2.0");
+program.addCommand(webhooks).addCommand(capture).addCommand(replay);
 program.parseAsync(process.argv);