@better-webhook/cli 3.0.0 → 3.2.0

package/dist/index.js

@@ -1,13 +1,7 @@
 #!/usr/bin/env node
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
 
 // src/index.ts
-import { Command as Command6 } from "commander";
+import { Command as Command7 } from "commander";
 
 // src/commands/templates.ts
 import { Command } from "commander";
@@ -49,6 +43,7 @@ var WebhookProviderSchema = z.enum([
   "github",
   "shopify",
   "twilio",
+  "ragie",
   "sendgrid",
   "slack",
   "discord",
@@ -183,8 +178,8 @@ var TemplateManager = class {
   /**
    * List all remote templates
    */
-  async listRemoteTemplates() {
-    const index = await this.fetchRemoteIndex();
+  async listRemoteTemplates(options) {
+    const index = await this.fetchRemoteIndex(!!options?.forceRefresh);
     const localIds = new Set(this.listLocalTemplates().map((t) => t.id));
     return index.templates.map((metadata) => ({
       metadata,
@@ -382,7 +377,9 @@ var listCommand = new Command().name("list").alias("ls").description("List avail
   const spinner = ora("Fetching remote templates...").start();
   try {
     const manager = getTemplateManager();
-    const templates2 = await manager.listRemoteTemplates();
+    const templates2 = await manager.listRemoteTemplates({
+      forceRefresh: !!options.refresh
+    });
     spinner.stop();
     if (templates2.length === 0) {
       console.log(chalk.yellow("\u{1F4ED} No remote templates found."));
@@ -433,88 +430,98 @@ var listCommand = new Command().name("list").alias("ls").description("List avail
     process.exitCode = 1;
   }
 });
-var downloadCommand = new Command().name("download").alias("get").argument("[templateId]", "Template ID to download").description("Download a template to local storage").option("-a, --all", "Download all available templates").action(async (templateId, options) => {
-  const manager = getTemplateManager();
-  if (options?.all) {
-    const spinner2 = ora("Fetching template list...").start();
-    try {
-      const templates2 = await manager.listRemoteTemplates();
-      const toDownload = templates2.filter((t) => !t.isDownloaded);
-      spinner2.stop();
-      if (toDownload.length === 0) {
-        console.log(chalk.green("\u2713 All templates already downloaded"));
-        return;
-      }
-      console.log(
-        chalk.bold(`
+var downloadCommand = new Command().name("download").alias("get").argument("[templateId]", "Template ID to download").description("Download a template to local storage").option("-a, --all", "Download all available templates").option("-r, --refresh", "Force refresh the template index cache").action(
+  async (templateId, options) => {
+    const manager = getTemplateManager();
+    if (options?.all) {
+      const spinner2 = ora("Fetching template list...").start();
+      try {
+        const templates2 = await manager.listRemoteTemplates({
+          forceRefresh: true
+        });
+        const toDownload = templates2.filter((t) => !t.isDownloaded);
+        spinner2.stop();
+        if (toDownload.length === 0) {
+          console.log(chalk.green("\u2713 All templates already downloaded"));
+          return;
+        }
+        console.log(
+          chalk.bold(`
 Downloading ${toDownload.length} templates...
 `)
-      );
-      for (const t of toDownload) {
-        const downloadSpinner = ora(
-          `Downloading ${t.metadata.id}...`
-        ).start();
-        try {
-          await manager.downloadTemplate(t.metadata.id);
-          downloadSpinner.succeed(`Downloaded ${t.metadata.id}`);
-        } catch (error) {
-          downloadSpinner.fail(`Failed: ${t.metadata.id} - ${error.message}`);
+        );
+        for (const t of toDownload) {
+          const downloadSpinner = ora(
+            `Downloading ${t.metadata.id}...`
+          ).start();
+          try {
+            await manager.downloadTemplate(t.metadata.id);
+            downloadSpinner.succeed(`Downloaded ${t.metadata.id}`);
+          } catch (error) {
+            downloadSpinner.fail(
+              `Failed: ${t.metadata.id} - ${error.message}`
+            );
+          }
         }
+        console.log(chalk.green("\n\u2713 Download complete\n"));
+      } catch (error) {
+        spinner2.fail("Failed to fetch templates");
+        console.error(chalk.red(error.message));
+        process.exitCode = 1;
       }
-      console.log(chalk.green("\n\u2713 Download complete\n"));
-    } catch (error) {
-      spinner2.fail("Failed to fetch templates");
-      console.error(chalk.red(error.message));
-      process.exitCode = 1;
+      return;
     }
-    return;
-  }
-  if (!templateId) {
-    const spinner2 = ora("Fetching templates...").start();
-    try {
-      const templates2 = await manager.listRemoteTemplates();
-      spinner2.stop();
-      const notDownloaded = templates2.filter((t) => !t.isDownloaded);
-      if (notDownloaded.length === 0) {
-        console.log(chalk.green("\u2713 All templates already downloaded"));
-        return;
-      }
-      const choices = notDownloaded.map((t) => ({
-        title: t.metadata.id,
-        description: `${t.metadata.provider} - ${t.metadata.event}`,
-        value: t.metadata.id
-      }));
-      const response = await prompts({
-        type: "select",
-        name: "templateId",
-        message: "Select a template to download:",
-        choices
-      });
-      if (!response.templateId) {
-        console.log(chalk.yellow("Cancelled"));
+    if (!templateId) {
+      const spinner2 = ora("Fetching templates...").start();
+      try {
+        const templates2 = await manager.listRemoteTemplates({
+          forceRefresh: !!options?.refresh
+        });
+        spinner2.stop();
+        const notDownloaded = templates2.filter((t) => !t.isDownloaded);
+        if (notDownloaded.length === 0) {
+          console.log(chalk.green("\u2713 All templates already downloaded"));
+          return;
+        }
+        const choices = notDownloaded.map((t) => ({
+          title: t.metadata.id,
+          description: `${t.metadata.provider} - ${t.metadata.event}`,
+          value: t.metadata.id
+        }));
+        const response = await prompts({
+          type: "select",
+          name: "templateId",
+          message: "Select a template to download:",
+          choices
+        });
+        if (!response.templateId) {
+          console.log(chalk.yellow("Cancelled"));
+          return;
+        }
+        templateId = response.templateId;
+      } catch (error) {
+        spinner2.fail("Failed to fetch templates");
+        console.error(chalk.red(error.message));
+        process.exitCode = 1;
         return;
       }
-      templateId = response.templateId;
+    }
+    const spinner = ora(`Downloading ${templateId}...`).start();
+    try {
+      const template = await manager.downloadTemplate(templateId);
+      spinner.succeed(`Downloaded ${templateId}`);
+      console.log(chalk.gray(`  Saved to: ${template.filePath}`));
+      console.log(
+        chalk.gray(`  Run with: better-webhook run ${templateId}
+`)
+      );
     } catch (error) {
-      spinner2.fail("Failed to fetch templates");
+      spinner.fail(`Failed to download ${templateId}`);
       console.error(chalk.red(error.message));
       process.exitCode = 1;
-      return;
     }
   }
-  const spinner = ora(`Downloading ${templateId}...`).start();
-  try {
-    const template = await manager.downloadTemplate(templateId);
-    spinner.succeed(`Downloaded ${templateId}`);
-    console.log(chalk.gray(`  Saved to: ${template.filePath}`));
-    console.log(chalk.gray(`  Run with: better-webhook run ${templateId}
-`));
-  } catch (error) {
-    spinner.fail(`Failed to download ${templateId}`);
-    console.error(chalk.red(error.message));
-    process.exitCode = 1;
-  }
-});
+);
 var localCommand = new Command().name("local").description("List downloaded local templates").option("-p, --provider <provider>", "Filter by provider").action((options) => {
   const manager = getTemplateManager();
   let templates2 = manager.listLocalTemplates();
@@ -984,6 +991,7 @@ function getSecretEnvVarName(provider) {
     stripe: "STRIPE_WEBHOOK_SECRET",
     shopify: "SHOPIFY_WEBHOOK_SECRET",
     twilio: "TWILIO_WEBHOOK_SECRET",
+    ragie: "RAGIE_WEBHOOK_SECRET",
     slack: "SLACK_WEBHOOK_SECRET",
     linear: "LINEAR_WEBHOOK_SECRET",
     clerk: "CLERK_WEBHOOK_SECRET",
@@ -1175,7 +1183,8 @@ import {
   mkdirSync as mkdirSync2,
   existsSync as existsSync2,
   readdirSync as readdirSync2,
-  readFileSync as readFileSync2
+  readFileSync as readFileSync2,
+  unlinkSync as unlinkSync2
 } from "fs";
 import { join as join2 } from "path";
 import { randomUUID } from "crypto";
@@ -1186,8 +1195,13 @@ var CaptureServer = class {
   capturesDir;
   clients = /* @__PURE__ */ new Set();
   captureCount = 0;
-  constructor(capturesDir) {
+  enableWebSocket;
+  onCapture;
+  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;
     if (!existsSync2(this.capturesDir)) {
       mkdirSync2(this.capturesDir, { recursive: true });
     }
@@ -1204,26 +1218,28 @@ var CaptureServer = class {
   async start(port = 3001, host = "0.0.0.0") {
     return new Promise((resolve, reject) => {
       this.server = createServer((req, res) => this.handleRequest(req, res));
-      this.wss = new WebSocketServer({ server: this.server });
-      this.wss.on("connection", (ws) => {
-        this.clients.add(ws);
-        console.log("\u{1F4E1} Dashboard connected via WebSocket");
-        ws.on("close", () => {
-          this.clients.delete(ws);
-          console.log("\u{1F4E1} Dashboard disconnected");
-        });
-        ws.on("error", (error) => {
-          console.error("WebSocket error:", error);
-          this.clients.delete(ws);
-        });
-        this.sendToClient(ws, {
-          type: "captures_updated",
-          payload: {
-            captures: this.listCaptures(),
-            count: this.captureCount
-          }
+      if (this.enableWebSocket) {
+        this.wss = new WebSocketServer({ server: this.server });
+        this.wss.on("connection", (ws) => {
+          this.clients.add(ws);
+          console.log("\u{1F4E1} Dashboard connected via WebSocket");
+          ws.on("close", () => {
+            this.clients.delete(ws);
+            console.log("\u{1F4E1} Dashboard disconnected");
+          });
+          ws.on("error", (error) => {
+            console.error("WebSocket error:", error);
+            this.clients.delete(ws);
+          });
+          this.sendToClient(ws, {
+            type: "captures_updated",
+            payload: {
+              captures: this.listCaptures(),
+              count: this.captureCount
+            }
+          });
         });
-      });
+      }
       this.server.on("error", (err) => {
         if (err.code === "EADDRINUSE") {
           reject(new Error(`Port ${port} is already in use`));
@@ -1241,7 +1257,9 @@ var CaptureServer = class {
         );
         console.log(`   \u{1F4C1} Captures saved to: ${this.capturesDir}`);
         console.log(`   \u{1F4A1} Send webhooks to any path to capture them`);
-        console.log(`   \u{1F310} WebSocket available for real-time updates`);
+        if (this.enableWebSocket) {
+          console.log(`   \u{1F310} WebSocket available for real-time updates`);
+        }
         console.log(`   \u23F9\uFE0F  Press Ctrl+C to stop
 `);
         resolve(actualPort);
@@ -1341,13 +1359,16 @@ var CaptureServer = class {
       console.log(
         `\u{1F4E6} ${req.method} ${urlParts.pathname}${providerStr} -> ${filename}`
       );
-      this.broadcast({
-        type: "capture",
-        payload: {
-          file: filename,
-          capture: captured
-        }
-      });
+      this.onCapture?.({ file: filename, capture: captured });
+      if (this.enableWebSocket) {
+        this.broadcast({
+          type: "capture",
+          payload: {
+            file: filename,
+            capture: captured
+          }
+        });
+      }
     } catch (error) {
       console.error(`\u274C Failed to save capture:`, error);
     }
@@ -1374,6 +1395,9 @@ var CaptureServer = class {
     if (headers["x-github-event"] || headers["x-hub-signature-256"]) {
       return "github";
     }
+    if (headers["x-ragie-delivery"]) {
+      return "ragie";
+    }
     if (headers["x-shopify-hmac-sha256"] || headers["x-shopify-topic"]) {
       return "shopify";
     }
@@ -1453,8 +1477,7 @@ var CaptureServer = class {
       return false;
     }
     try {
-      const fs = __require("fs");
-      fs.unlinkSync(join2(this.capturesDir, capture2.file));
+      unlinkSync2(join2(this.capturesDir, capture2.file));
       return true;
     } catch {
       return false;
@@ -1497,7 +1520,7 @@ import chalk4 from "chalk";
 import prompts3 from "prompts";
 
 // src/core/replay-engine.ts
-import { existsSync as existsSync3, readFileSync as readFileSync3, readdirSync as readdirSync3, unlinkSync as unlinkSync2 } from "fs";
+import { existsSync as existsSync3, readFileSync as readFileSync3, readdirSync as readdirSync3, unlinkSync as unlinkSync3 } from "fs";
 import { join as join3 } from "path";
 import { homedir as homedir3 } from "os";
 var ReplayEngine = class {
@@ -1688,7 +1711,7 @@ var ReplayEngine = class {
       return false;
     }
     try {
-      unlinkSync2(join3(this.capturesDir, captureFile.file));
+      unlinkSync3(join3(this.capturesDir, captureFile.file));
       return true;
     } catch {
       return false;
@@ -1708,7 +1731,7 @@ var ReplayEngine = class {
     let deleted = 0;
     for (const file of files) {
       try {
-        unlinkSync2(join3(this.capturesDir, file));
+        unlinkSync3(join3(this.capturesDir, file));
         deleted++;
       } catch {
       }
@@ -2077,9 +2100,482 @@ var replay = new Command5().name("replay").argument("[captureId]", "Capture ID t
   }
 );
 
+// src/commands/dashboard.ts
+import { Command as Command6 } from "commander";
+import chalk6 from "chalk";
+
+// src/core/dashboard-server.ts
+import express2 from "express";
+import { createServer as createServer2 } from "http";
+import { WebSocketServer as WebSocketServer2 } from "ws";
+import path from "path";
+import { existsSync as existsSync4 } from "fs";
+import { fileURLToPath } from "url";
+
+// src/core/dashboard-api.ts
+import express from "express";
+import { z as z2 } from "zod";
+function jsonError(res, status, message) {
+  return res.status(status).json({ error: message });
+}
+function getSecretEnvVarName2(provider) {
+  const envVarMap = {
+    github: "GITHUB_WEBHOOK_SECRET",
+    stripe: "STRIPE_WEBHOOK_SECRET",
+    shopify: "SHOPIFY_WEBHOOK_SECRET",
+    twilio: "TWILIO_WEBHOOK_SECRET",
+    ragie: "RAGIE_WEBHOOK_SECRET",
+    slack: "SLACK_WEBHOOK_SECRET",
+    linear: "LINEAR_WEBHOOK_SECRET",
+    clerk: "CLERK_WEBHOOK_SECRET",
+    sendgrid: "SENDGRID_WEBHOOK_SECRET",
+    discord: "DISCORD_WEBHOOK_SECRET",
+    custom: "WEBHOOK_SECRET"
+  };
+  return envVarMap[provider] || "WEBHOOK_SECRET";
+}
+var ReplayBodySchema = z2.object({
+  captureId: z2.string().min(1),
+  targetUrl: z2.string().min(1),
+  method: HttpMethodSchema.optional(),
+  headers: z2.array(HeaderEntrySchema).optional()
+});
+var TemplateDownloadBodySchema = z2.object({
+  id: z2.string().min(1)
+});
+var RunTemplateBodySchema = z2.object({
+  templateId: z2.string().min(1),
+  url: z2.string().min(1),
+  secret: z2.string().optional(),
+  headers: z2.array(HeaderEntrySchema).optional()
+});
+function createDashboardApiRouter(options = {}) {
+  const router = express.Router();
+  const replayEngine = new ReplayEngine(options.capturesDir);
+  const templateManager = new TemplateManager(options.templatesBaseDir);
+  const broadcast = options.broadcast;
+  const broadcastCaptures = () => {
+    if (!broadcast) return;
+    const captures2 = replayEngine.listCaptures(200);
+    broadcast({
+      type: "captures_updated",
+      payload: { captures: captures2, count: captures2.length }
+    });
+  };
+  const broadcastTemplates = async () => {
+    if (!broadcast) return;
+    const local = templateManager.listLocalTemplates();
+    let remote = [];
+    try {
+      const index = await templateManager.fetchRemoteIndex(false);
+      const localIds = new Set(local.map((t) => t.id));
+      remote = index.templates.map((metadata) => ({
+        metadata,
+        isDownloaded: localIds.has(metadata.id)
+      }));
+    } catch {
+      remote = [];
+    }
+    broadcast({
+      type: "templates_updated",
+      payload: { local, remote }
+    });
+  };
+  router.get("/captures", (req, res) => {
+    const limitRaw = typeof req.query.limit === "string" ? req.query.limit : "";
+    const providerRaw = typeof req.query.provider === "string" ? req.query.provider : "";
+    const qRaw = typeof req.query.q === "string" ? req.query.q : "";
+    const limit = limitRaw ? Number.parseInt(limitRaw, 10) : 50;
+    if (!Number.isFinite(limit) || limit <= 0 || limit > 5e3) {
+      return jsonError(res, 400, "Invalid limit");
+    }
+    const q = qRaw.trim();
+    const provider = providerRaw.trim();
+    let captures2 = q ? replayEngine.searchCaptures(q) : replayEngine.listCaptures(Math.max(limit, 1e3));
+    if (provider) {
+      captures2 = captures2.filter(
+        (c) => (c.capture.provider || "").toLowerCase() === provider.toLowerCase()
+      );
+    }
+    captures2 = captures2.slice(0, limit);
+    return res.json({ captures: captures2, count: captures2.length });
+  });
+  router.get("/captures/:id", (req, res) => {
+    const id = req.params.id;
+    if (!id) {
+      return jsonError(res, 400, "Missing capture id");
+    }
+    const captureFile = replayEngine.getCapture(id);
+    if (!captureFile) {
+      return jsonError(res, 404, "Capture not found");
+    }
+    return res.json(captureFile);
+  });
+  router.delete("/captures/:id", (req, res) => {
+    const id = req.params.id;
+    if (!id) {
+      return jsonError(res, 400, "Missing capture id");
+    }
+    const deleted = replayEngine.deleteCapture(id);
+    if (!deleted) {
+      return jsonError(res, 404, "Capture not found");
+    }
+    broadcastCaptures();
+    return res.json({ success: true });
+  });
+  router.delete("/captures", (_req, res) => {
+    const deleted = replayEngine.deleteAllCaptures();
+    broadcastCaptures();
+    return res.json({ success: true, deleted });
+  });
+  router.post("/replay", express.json({ limit: "5mb" }), async (req, res) => {
+    const parsed = ReplayBodySchema.safeParse(req.body);
+    if (!parsed.success) {
+      return jsonError(
+        res,
+        400,
+        parsed.error.issues[0]?.message || "Invalid body"
+      );
+    }
+    const { captureId, targetUrl, method, headers } = parsed.data;
+    try {
+      new URL(targetUrl);
+    } catch {
+      return jsonError(res, 400, "Invalid targetUrl");
+    }
+    try {
+      const result = await replayEngine.replay(captureId, {
+        targetUrl,
+        method,
+        headers
+      });
+      broadcast?.({
+        type: "replay_result",
+        payload: { captureId, targetUrl, result }
+      });
+      return res.json(result);
+    } catch (error) {
+      return jsonError(res, 400, error?.message || "Replay failed");
+    }
+  });
+  router.get("/templates/local", (_req, res) => {
+    const local = templateManager.listLocalTemplates();
+    return res.json({ templates: local, count: local.length });
+  });
+  router.get("/templates/remote", async (req, res) => {
+    const refresh = typeof req.query.refresh === "string" ? req.query.refresh === "1" || req.query.refresh.toLowerCase() === "true" : false;
+    try {
+      const index = await templateManager.fetchRemoteIndex(refresh);
+      const localIds = new Set(
+        templateManager.listLocalTemplates().map((t) => t.id)
+      );
+      const remote = index.templates.map((metadata) => ({
+        metadata,
+        isDownloaded: localIds.has(metadata.id)
+      }));
+      return res.json({ templates: remote, count: remote.length });
+    } catch (error) {
+      return jsonError(
+        res,
+        500,
+        error?.message || "Failed to fetch remote templates"
+      );
+    }
+  });
+  router.post(
+    "/templates/download",
+    express.json({ limit: "2mb" }),
+    async (req, res) => {
+      const parsed = TemplateDownloadBodySchema.safeParse(req.body);
+      if (!parsed.success) {
+        return jsonError(
+          res,
+          400,
+          parsed.error.issues[0]?.message || "Invalid body"
+        );
+      }
+      try {
+        const template = await templateManager.downloadTemplate(parsed.data.id);
+        void broadcastTemplates();
+        return res.json({ success: true, template });
+      } catch (error) {
+        return jsonError(res, 400, error?.message || "Download failed");
+      }
+    }
+  );
+  router.post(
+    "/templates/download-all",
+    express.json({ limit: "1mb" }),
+    async (_req, res) => {
+      try {
+        const index = await templateManager.fetchRemoteIndex(true);
+        const localIds = new Set(
+          templateManager.listLocalTemplates().map((t) => t.id)
+        );
+        const toDownload = index.templates.filter((t) => !localIds.has(t.id));
+        const downloaded = [];
+        const failed = [];
+        for (const t of toDownload) {
+          try {
+            await templateManager.downloadTemplate(t.id);
+            downloaded.push(t.id);
+          } catch (e) {
+            failed.push({ id: t.id, error: e?.message || "Failed" });
+          }
+        }
+        return res.json({
+          success: true,
+          total: index.templates.length,
+          downloaded,
+          failed
+        });
+      } catch (error) {
+        return jsonError(res, 500, error?.message || "Download-all failed");
+      }
+    }
+  );
+  router.post("/run", express.json({ limit: "10mb" }), async (req, res) => {
+    const parsed = RunTemplateBodySchema.safeParse(req.body);
+    if (!parsed.success) {
+      return jsonError(
+        res,
+        400,
+        parsed.error.issues[0]?.message || "Invalid body"
+      );
+    }
+    let { templateId, url, secret, headers } = parsed.data;
+    try {
+      new URL(url);
+    } catch {
+      return jsonError(res, 400, "Invalid url");
+    }
+    if (templateId.startsWith("remote:")) {
+      templateId = templateId.slice("remote:".length);
+      try {
+        await templateManager.downloadTemplate(templateId);
+      } catch (error) {
+        return jsonError(
+          res,
+          400,
+          error?.message || "Failed to download template"
+        );
+      }
+    }
+    let localTemplate = templateManager.getLocalTemplate(templateId);
+    if (!localTemplate) {
+      try {
+        await templateManager.downloadTemplate(templateId);
+        localTemplate = templateManager.getLocalTemplate(templateId);
+      } catch {
+      }
+    }
+    if (!localTemplate) {
+      return jsonError(res, 404, "Template not found");
+    }
+    if (!secret && localTemplate.metadata.provider) {
+      const envVarName = getSecretEnvVarName2(localTemplate.metadata.provider);
+      secret = process.env[envVarName];
+    }
+    const safeHeaders = headers?.length ? headers : void 0;
+    try {
+      const result = await executeTemplate(localTemplate.template, {
+        url,
+        secret,
+        headers: safeHeaders
+      });
+      broadcast?.({
+        type: "replay_result",
+        payload: { templateId, url, result }
+      });
+      return res.json(result);
+    } catch (error) {
+      return jsonError(res, 400, error?.message || "Run failed");
+    }
+  });
+  return router;
+}
+
+// src/core/dashboard-server.ts
+function resolveDashboardDistDir(runtimeDir) {
+  const candidates = [
+    path.resolve(runtimeDir, "..", "dashboard"),
+    path.resolve(runtimeDir, "..", "..", "dist", "dashboard"),
+    path.resolve(runtimeDir, "..", "..", "..", "dashboard", "dist")
+  ];
+  for (const distDir of candidates) {
+    const indexHtml = path.join(distDir, "index.html");
+    if (existsSync4(indexHtml)) {
+      return { distDir, indexHtml };
+    }
+  }
+  const details = candidates.map((p) => `- ${p}`).join("\n");
+  throw new Error(
+    `Dashboard UI build output not found.
+Looked in:
+${details}
+
+Build it with:
+- pnpm --filter @better-webhook/dashboard build
+- pnpm --filter @better-webhook/cli build
+`
+  );
+}
+async function startDashboardServer(options = {}) {
+  const app = express2();
+  app.get("/health", (_req, res) => {
+    res.json({ ok: true });
+  });
+  const clients = /* @__PURE__ */ new Set();
+  const broadcast = (message) => {
+    const data = JSON.stringify(message);
+    for (const client of clients) {
+      if (client.readyState === 1) {
+        client.send(data);
+      }
+    }
+  };
+  app.use(
+    "/api",
+    createDashboardApiRouter({
+      capturesDir: options.capturesDir,
+      templatesBaseDir: options.templatesBaseDir,
+      broadcast
+    })
+  );
+  const host = options.host || "localhost";
+  const port = options.port ?? 4e3;
+  const runtimeDir = (
+    // eslint-disable-next-line no-undef
+    typeof __dirname !== "undefined" ? (
+      // eslint-disable-next-line no-undef
+      __dirname
+    ) : path.dirname(fileURLToPath(import.meta.url))
+  );
+  const { distDir: dashboardDistDir, indexHtml: dashboardIndexHtml } = resolveDashboardDistDir(runtimeDir);
+  app.use(express2.static(dashboardDistDir));
+  app.get("*", (req, res, next) => {
+    if (req.path.startsWith("/api") || req.path === "/health") return next();
+    res.sendFile(dashboardIndexHtml, (err) => {
+      if (err) next();
+    });
+  });
+  const server = createServer2(app);
+  const wss = new WebSocketServer2({ server, path: "/ws" });
+  wss.on("connection", async (ws) => {
+    clients.add(ws);
+    ws.on("close", () => clients.delete(ws));
+    ws.on("error", () => clients.delete(ws));
+    const replayEngine = new ReplayEngine(options.capturesDir);
+    const templateManager = new TemplateManager(options.templatesBaseDir);
+    const captures2 = replayEngine.listCaptures(200);
+    ws.send(
+      JSON.stringify({
+        type: "captures_updated",
+        payload: { captures: captures2, count: captures2.length }
+      })
+    );
+    const local = templateManager.listLocalTemplates();
+    let remote = [];
+    try {
+      const index = await templateManager.fetchRemoteIndex(true);
+      const localIds = new Set(local.map((t) => t.id));
+      remote = index.templates.map((metadata) => ({
+        metadata,
+        isDownloaded: localIds.has(metadata.id)
+      }));
+    } catch {
+      remote = [];
+    }
+    ws.send(
+      JSON.stringify({
+        type: "templates_updated",
+        payload: { local, remote }
+      })
+    );
+  });
+  await new Promise((resolve, reject) => {
+    server.listen(port, host, () => resolve());
+    server.on("error", reject);
+  });
+  const url = `http://${host}:${port}`;
+  let capture2;
+  const shouldStartCapture = options.startCapture !== false;
+  if (shouldStartCapture) {
+    const captureHost = options.captureHost || "0.0.0.0";
+    const capturePort = options.capturePort ?? 3001;
+    const captureServer = new CaptureServer({
+      capturesDir: options.capturesDir,
+      enableWebSocket: false,
+      onCapture: ({ file, capture: capture3 }) => {
+        broadcast({
+          type: "capture",
+          payload: { file, capture: capture3 }
+        });
+      }
+    });
+    const actualPort = await captureServer.start(capturePort, captureHost);
+    capture2 = {
+      server: captureServer,
+      url: `http://${captureHost === "0.0.0.0" ? "localhost" : captureHost}:${actualPort}`
+    };
+  }
+  return { app, server, url, capture: capture2 };
+}
+
+// src/commands/dashboard.ts
+var dashboard = new Command6().name("dashboard").description("Start the local dashboard (UI + API + WebSocket) server").option("-p, --port <port>", "Port to listen on", "4000").option("-h, --host <host>", "Host to bind to", "localhost").option("--capture-port <port>", "Capture server port", "3001").option("--capture-host <host>", "Capture server host", "0.0.0.0").option("--no-capture", "Do not start the capture server").option("--captures-dir <dir>", "Override captures directory").option("--templates-dir <dir>", "Override templates base directory").action(async (options) => {
+  const port = Number.parseInt(String(options.port), 10);
+  if (!Number.isFinite(port) || port < 0 || port > 65535) {
+    console.error(chalk6.red("Invalid port number"));
+    process.exitCode = 1;
+    return;
+  }
+  try {
+    const capturePort = Number.parseInt(String(options.capturePort), 10);
+    if (!Number.isFinite(capturePort) || capturePort < 0 || capturePort > 65535) {
+      console.error(chalk6.red("Invalid capture port number"));
+      process.exitCode = 1;
+      return;
+    }
+    const { url, server, capture: capture2 } = await startDashboardServer({
+      host: options.host,
+      port,
+      captureHost: options.captureHost,
+      capturePort,
+      startCapture: options.capture !== false,
+      capturesDir: options.capturesDir,
+      templatesBaseDir: options.templatesDir
+    });
+    console.log(chalk6.bold("\n\u{1F9ED} Dashboard Server\n"));
+    console.log(chalk6.gray(`   Dashboard: ${url}/`));
+    console.log(chalk6.gray(`   Health: ${url}/health`));
+    console.log(chalk6.gray(`   API Base: ${url}/api`));
+    console.log(chalk6.gray(`   WebSocket: ${url.replace("http://", "ws://")}/ws`));
+    if (capture2) {
+      console.log();
+      console.log(chalk6.bold("\u{1F3A3} Capture Server"));
+      console.log(chalk6.gray(`   Capture: ${capture2.url}`));
+      console.log(chalk6.gray(`   Tip: Send webhooks to any path, e.g. ${capture2.url}/webhooks/github`));
+    }
+    console.log();
+    const shutdown = async () => {
+      if (capture2) {
+        await capture2.server.stop();
+      }
+      await new Promise((resolve) => server.close(() => resolve()));
+      process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+  } catch (error) {
+    console.error(chalk6.red(`Failed to start dashboard server: ${error?.message || error}`));
+    process.exitCode = 1;
+  }
+});
+
 // src/index.ts
-var program = new Command6().name("better-webhook").description(
+var program = new Command7().name("better-webhook").description(
   "Modern CLI for developing, capturing, and replaying webhooks locally"
 ).version("2.0.0");
-program.addCommand(templates).addCommand(run).addCommand(capture).addCommand(captures).addCommand(replay);
+program.addCommand(templates).addCommand(run).addCommand(capture).addCommand(captures).addCommand(replay).addCommand(dashboard);
 program.parseAsync(process.argv);