@better-webhook/cli 3.5.0 → 3.6.0

package/README.md

@@ -43,6 +43,37 @@ These providers are auto-detected from headers but signature generation is not y
 
 ## Installation
 
+### Standalone Binary (Recommended)
+
+Download a standalone binary - no Node.js required:
+
+**macOS (Homebrew)**
+
+```bash
+brew install endalk200/tap/better-webhook
+```
+
+**Manual Download**
+
+Download the latest binary for your platform from [GitHub Releases](https://github.com/endalk200/better-webhook/releases):
+
+| Platform      | Download                                                                                      |
+| ------------- | --------------------------------------------------------------------------------------------- |
+| macOS (ARM)   | [better-webhook-darwin-arm64](https://github.com/endalk200/better-webhook/releases/latest)    |
+| macOS (Intel) | [better-webhook-darwin-x64](https://github.com/endalk200/better-webhook/releases/latest)      |
+| Linux (x64)   | [better-webhook-linux-x64](https://github.com/endalk200/better-webhook/releases/latest)       |
+| Linux (ARM)   | [better-webhook-linux-arm64](https://github.com/endalk200/better-webhook/releases/latest)     |
+| Windows       | [better-webhook-windows-x64.exe](https://github.com/endalk200/better-webhook/releases/latest) |
+
+```bash
+# Example: macOS ARM
+curl -L https://github.com/endalk200/better-webhook/releases/latest/download/better-webhook-darwin-arm64 -o better-webhook
+chmod +x better-webhook
+sudo mv better-webhook /usr/local/bin/
+```
+
+### NPM (Alternative)
+
 ```bash
 # NPM
 npm install -g @better-webhook/cli

package/dist/index.cjs

@@ -2738,6 +2738,89 @@ function createDashboardApiRouter(options = {}) {
 
 // src/core/dashboard-server.ts
 var import_meta = {};
+function isStandaloneBinary() {
+  if (typeof STANDALONE_BINARY !== "undefined" && STANDALONE_BINARY) {
+    return true;
+  }
+  if (typeof globalThis.embeddedDashboardFiles !== "undefined" && globalThis.embeddedDashboardFiles) {
+    return true;
+  }
+  return false;
+}
+function getMimeType(filePath) {
+  const ext = import_path4.default.extname(filePath).toLowerCase();
+  const mimeTypes = {
+    ".html": "text/html; charset=utf-8",
+    ".js": "application/javascript; charset=utf-8",
+    ".css": "text/css; charset=utf-8",
+    ".json": "application/json; charset=utf-8",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".svg": "image/svg+xml",
+    ".ico": "image/x-icon",
+    ".woff": "font/woff",
+    ".woff2": "font/woff2",
+    ".ttf": "font/ttf",
+    ".eot": "application/vnd.ms-fontobject"
+  };
+  return mimeTypes[ext] || "application/octet-stream";
+}
+function createEmbeddedDashboardMiddleware() {
+  const filePathMap = /* @__PURE__ */ new Map();
+  let indexHtmlPath = null;
+  if (typeof globalThis.embeddedDashboardFiles !== "undefined") {
+    for (const [key, filePath] of Object.entries(
+      globalThis.embeddedDashboardFiles
+    )) {
+      const servePath = "/" + key.replace(/^dashboard\//, "");
+      filePathMap.set(servePath, filePath);
+      if (servePath === "/index.html") {
+        indexHtmlPath = filePath;
+      }
+    }
+  }
+  const staticMiddleware = async (req, res, next) => {
+    if (!Bun) {
+      return next();
+    }
+    const requestPath = req.path === "/" ? "/index.html" : req.path;
+    const filePath = filePathMap.get(requestPath);
+    if (filePath) {
+      try {
+        const file = Bun.file(filePath);
+        const content = await file.arrayBuffer();
+        res.setHeader("Content-Type", getMimeType(requestPath));
+        res.setHeader("Content-Length", content.byteLength);
+        res.send(Buffer.from(content));
+      } catch (err) {
+        console.error(`Failed to serve embedded file ${requestPath}:`, err);
+        next();
+      }
+    } else {
+      next();
+    }
+  };
+  const spaFallback = async (req, res, next) => {
+    if (req.path.startsWith("/api") || req.path === "/health") {
+      return next();
+    }
+    if (!Bun || !indexHtmlPath) {
+      return next();
+    }
+    try {
+      const file = Bun.file(indexHtmlPath);
+      const content = await file.arrayBuffer();
+      res.setHeader("Content-Type", "text/html; charset=utf-8");
+      res.setHeader("Content-Length", content.byteLength);
+      res.send(Buffer.from(content));
+    } catch {
+      next();
+    }
+  };
+  return { staticMiddleware, spaFallback };
+}
 function resolveDashboardDistDir(runtimeDir) {
   const candidates = [
     // Bundled CLI: dist/index.js -> dist/dashboard
@@ -2791,18 +2874,24 @@ async function startDashboardServer(options = {}) {
   );
   const host = options.host || "localhost";
   const port = options.port ?? 4e3;
-  const runtimeDir = typeof __dirname !== "undefined" ? (
-    // eslint-disable-next-line no-undef
-    __dirname
-  ) : import_path4.default.dirname((0, import_url.fileURLToPath)(import_meta.url));
-  const { distDir: dashboardDistDir, indexHtml: dashboardIndexHtml } = resolveDashboardDistDir(runtimeDir);
-  app.use(import_express2.default.static(dashboardDistDir));
-  app.get("*", (req, res, next) => {
-    if (req.path.startsWith("/api") || req.path === "/health") return next();
-    res.sendFile(dashboardIndexHtml, (err) => {
-      if (err) next();
+  if (isStandaloneBinary()) {
+    const { staticMiddleware, spaFallback } = createEmbeddedDashboardMiddleware();
+    app.use(staticMiddleware);
+    app.get("*", spaFallback);
+  } else {
+    const runtimeDir = typeof __dirname !== "undefined" ? (
+      // eslint-disable-next-line no-undef
+      __dirname
+    ) : import_path4.default.dirname((0, import_url.fileURLToPath)(import_meta.url));
+    const { distDir: dashboardDistDir, indexHtml: dashboardIndexHtml } = resolveDashboardDistDir(runtimeDir);
+    app.use(import_express2.default.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 = (0, import_http2.createServer)(app);
   const wss = new import_ws2.WebSocketServer({ server, path: "/ws" });
   wss.on("connection", async (ws) => {
@@ -2929,14 +3018,24 @@ var dashboard = new import_commander6.Command().name("dashboard").description("S
 
 // src/index.ts
 var import_meta2 = {};
-var packageJsonPath = (0, import_node_url.fileURLToPath)(
-  new URL("../package.json", import_meta2.url)
-);
-var packageJson = JSON.parse(
-  (0, import_node_fs.readFileSync)(packageJsonPath, { encoding: "utf8" })
-);
+function getVersion() {
+  if (typeof CLI_VERSION !== "undefined") {
+    return CLI_VERSION;
+  }
+  try {
+    const packageJsonPath = (0, import_node_url.fileURLToPath)(
+      new URL("../package.json", import_meta2.url)
+    );
+    const packageJson = JSON.parse(
+      (0, import_node_fs.readFileSync)(packageJsonPath, { encoding: "utf8" })
+    );
+    return packageJson.version;
+  } catch {
+    return "0.0.0-unknown";
+  }
+}
 var program = new import_commander7.Command().name("better-webhook").description(
   "Modern CLI for developing, capturing, and replaying webhooks locally"
-).version(packageJson.version);
+).version(getVersion());
 program.addCommand(templates).addCommand(run).addCommand(capture).addCommand(captures).addCommand(replay).addCommand(dashboard);
 program.parseAsync(process.argv);

package/dist/index.js

@@ -2,7 +2,7 @@
 
 // src/index.ts
 import { Command as Command7 } from "commander";
-import { readFileSync as readFileSync4 } from "fs";
+import { readFileSync as readFileSync5 } from "fs";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
 // src/commands/templates.ts
@@ -2731,6 +2731,89 @@ function createDashboardApiRouter(options = {}) {
 }
 
 // src/core/dashboard-server.ts
+function isStandaloneBinary() {
+  if (typeof STANDALONE_BINARY !== "undefined" && STANDALONE_BINARY) {
+    return true;
+  }
+  if (typeof globalThis.embeddedDashboardFiles !== "undefined" && globalThis.embeddedDashboardFiles) {
+    return true;
+  }
+  return false;
+}
+function getMimeType(filePath) {
+  const ext = path.extname(filePath).toLowerCase();
+  const mimeTypes = {
+    ".html": "text/html; charset=utf-8",
+    ".js": "application/javascript; charset=utf-8",
+    ".css": "text/css; charset=utf-8",
+    ".json": "application/json; charset=utf-8",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".svg": "image/svg+xml",
+    ".ico": "image/x-icon",
+    ".woff": "font/woff",
+    ".woff2": "font/woff2",
+    ".ttf": "font/ttf",
+    ".eot": "application/vnd.ms-fontobject"
+  };
+  return mimeTypes[ext] || "application/octet-stream";
+}
+function createEmbeddedDashboardMiddleware() {
+  const filePathMap = /* @__PURE__ */ new Map();
+  let indexHtmlPath = null;
+  if (typeof globalThis.embeddedDashboardFiles !== "undefined") {
+    for (const [key, filePath] of Object.entries(
+      globalThis.embeddedDashboardFiles
+    )) {
+      const servePath = "/" + key.replace(/^dashboard\//, "");
+      filePathMap.set(servePath, filePath);
+      if (servePath === "/index.html") {
+        indexHtmlPath = filePath;
+      }
+    }
+  }
+  const staticMiddleware = async (req, res, next) => {
+    if (!Bun) {
+      return next();
+    }
+    const requestPath = req.path === "/" ? "/index.html" : req.path;
+    const filePath = filePathMap.get(requestPath);
+    if (filePath) {
+      try {
+        const file = Bun.file(filePath);
+        const content = await file.arrayBuffer();
+        res.setHeader("Content-Type", getMimeType(requestPath));
+        res.setHeader("Content-Length", content.byteLength);
+        res.send(Buffer.from(content));
+      } catch (err) {
+        console.error(`Failed to serve embedded file ${requestPath}:`, err);
+        next();
+      }
+    } else {
+      next();
+    }
+  };
+  const spaFallback = async (req, res, next) => {
+    if (req.path.startsWith("/api") || req.path === "/health") {
+      return next();
+    }
+    if (!Bun || !indexHtmlPath) {
+      return next();
+    }
+    try {
+      const file = Bun.file(indexHtmlPath);
+      const content = await file.arrayBuffer();
+      res.setHeader("Content-Type", "text/html; charset=utf-8");
+      res.setHeader("Content-Length", content.byteLength);
+      res.send(Buffer.from(content));
+    } catch {
+      next();
+    }
+  };
+  return { staticMiddleware, spaFallback };
+}
 function resolveDashboardDistDir(runtimeDir) {
   const candidates = [
     // Bundled CLI: dist/index.js -> dist/dashboard
@@ -2784,18 +2867,24 @@ async function startDashboardServer(options = {}) {
   );
   const host = options.host || "localhost";
   const port = options.port ?? 4e3;
-  const runtimeDir = 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();
+  if (isStandaloneBinary()) {
+    const { staticMiddleware, spaFallback } = createEmbeddedDashboardMiddleware();
+    app.use(staticMiddleware);
+    app.get("*", spaFallback);
+  } else {
+    const runtimeDir = 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) => {
@@ -2921,14 +3010,24 @@ var dashboard = new Command6().name("dashboard").description("Start the local da
 });
 
 // src/index.ts
-var packageJsonPath = fileURLToPath2(
-  new URL("../package.json", import.meta.url)
-);
-var packageJson = JSON.parse(
-  readFileSync4(packageJsonPath, { encoding: "utf8" })
-);
+function getVersion() {
+  if (typeof CLI_VERSION !== "undefined") {
+    return CLI_VERSION;
+  }
+  try {
+    const packageJsonPath = fileURLToPath2(
+      new URL("../package.json", import.meta.url)
+    );
+    const packageJson = JSON.parse(
+      readFileSync5(packageJsonPath, { encoding: "utf8" })
+    );
+    return packageJson.version;
+  } catch {
+    return "0.0.0-unknown";
+  }
+}
 var program = new Command7().name("better-webhook").description(
   "Modern CLI for developing, capturing, and replaying webhooks locally"
-).version(packageJson.version);
+).version(getVersion());
 program.addCommand(templates).addCommand(run).addCommand(capture).addCommand(captures).addCommand(replay).addCommand(dashboard);
 program.parseAsync(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@better-webhook/cli",
-  "version": "3.5.0",
+  "version": "3.6.0",
   "description": "Modern CLI for developing, capturing, and replaying webhooks locally with dashboard UI.",
   "type": "module",
   "bin": {
@@ -60,6 +60,7 @@
     "zod": "^3.23.8"
   },
   "devDependencies": {
+    "@types/bun": "^1.2.18",
     "@types/express": "^4.17.21",
     "@types/node": "^24.3.1",
     "@types/prompts": "^2.4.9",
@@ -72,6 +73,8 @@
   "scripts": {
     "build:cli": "tsup --format cjs,esm --dts && node ./scripts/copy-dashboard.mjs",
     "build": "pnpm --filter @better-webhook/dashboard build && pnpm run build:cli",
+    "build:binary": "bun ./scripts/build-binary.ts",
+    "build:binary:all": "bun ./scripts/build-binary.ts --all",
     "dev": "tsup --watch",
     "start": "tsx src/index.ts",
     "lint": "tsc",