@better-webhook/cli 3.4.4 → 3.6.0

package/dist/commands/templates.js

@@ -1,285 +0,0 @@
-import { Command } from "commander";
-import ora from "ora";
-import prompts from "prompts";
-import chalk from "chalk";
-import { getTemplateManager } from "../core/template-manager.js";
-const listCommand = new Command()
-    .name("list")
-    .alias("ls")
-    .description("List available remote templates from the repository")
-    .option("-p, --provider <provider>", "Filter by provider (stripe, github, etc.)")
-    .option("-r, --refresh", "Force refresh the template index cache")
-    .action(async (options) => {
-    const spinner = ora("Fetching remote templates...").start();
-    try {
-        const manager = getTemplateManager();
-        const templates = await manager.listRemoteTemplates({
-            forceRefresh: !!options.refresh,
-        });
-        spinner.stop();
-        if (templates.length === 0) {
-            console.log(chalk.yellow("📭 No remote templates found."));
-            return;
-        }
-        let filtered = templates;
-        if (options.provider) {
-            filtered = templates.filter((t) => t.metadata.provider.toLowerCase() ===
-                options.provider?.toLowerCase());
-        }
-        if (filtered.length === 0) {
-            console.log(chalk.yellow(`📭 No templates found for provider: ${options.provider}`));
-            return;
-        }
-        console.log(chalk.bold("\n📦 Available Templates\n"));
-        const byProvider = new Map();
-        for (const t of filtered) {
-            const provider = t.metadata.provider;
-            if (!byProvider.has(provider)) {
-                byProvider.set(provider, []);
-            }
-            byProvider.get(provider).push(t);
-        }
-        for (const [provider, providerTemplates] of byProvider) {
-            console.log(chalk.cyan.bold(`  ${provider.toUpperCase()}`));
-            for (const t of providerTemplates) {
-                const status = t.isDownloaded
-                    ? chalk.green("✓ downloaded")
-                    : chalk.gray("○ remote");
-                console.log(`    ${chalk.white(t.metadata.id)} ${status}`);
-                if (t.metadata.description) {
-                    console.log(chalk.gray(`      ${t.metadata.description}`));
-                }
-            }
-            console.log();
-        }
-        console.log(chalk.gray(`  Total: ${filtered.length} templates`));
-        console.log(chalk.gray(`  Download: better-webhook templates download <id>\n`));
-    }
-    catch (error) {
-        spinner.fail("Failed to fetch templates");
-        console.error(chalk.red(error.message));
-        process.exitCode = 1;
-    }
-});
-const 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 spinner = ora("Fetching template list...").start();
-        try {
-            const templates = await manager.listRemoteTemplates({
-                forceRefresh: true,
-            });
-            const toDownload = templates.filter((t) => !t.isDownloaded);
-            spinner.stop();
-            if (toDownload.length === 0) {
-                console.log(chalk.green("✓ All templates already downloaded"));
-                return;
-            }
-            console.log(chalk.bold(`\nDownloading ${toDownload.length} templates...\n`));
-            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✓ Download complete\n"));
-        }
-        catch (error) {
-            spinner.fail("Failed to fetch templates");
-            console.error(chalk.red(error.message));
-            process.exitCode = 1;
-        }
-        return;
-    }
-    if (!templateId) {
-        const spinner = ora("Fetching templates...").start();
-        try {
-            const templates = await manager.listRemoteTemplates({
-                forceRefresh: !!options?.refresh,
-            });
-            spinner.stop();
-            const notDownloaded = templates.filter((t) => !t.isDownloaded);
-            if (notDownloaded.length === 0) {
-                console.log(chalk.green("✓ 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) {
-            spinner.fail("Failed to fetch templates");
-            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}\n`));
-    }
-    catch (error) {
-        spinner.fail(`Failed to download ${templateId}`);
-        console.error(chalk.red(error.message));
-        process.exitCode = 1;
-    }
-});
-const localCommand = new Command()
-    .name("local")
-    .description("List downloaded local templates")
-    .option("-p, --provider <provider>", "Filter by provider")
-    .action((options) => {
-    const manager = getTemplateManager();
-    let templates = manager.listLocalTemplates();
-    if (options.provider) {
-        templates = templates.filter((t) => t.metadata.provider.toLowerCase() === options.provider?.toLowerCase());
-    }
-    if (templates.length === 0) {
-        console.log(chalk.yellow("\n📭 No local templates found."));
-        console.log(chalk.gray("   Download templates with: better-webhook templates download\n"));
-        return;
-    }
-    console.log(chalk.bold("\n📁 Local Templates\n"));
-    const byProvider = new Map();
-    for (const t of templates) {
-        const provider = t.metadata.provider;
-        if (!byProvider.has(provider)) {
-            byProvider.set(provider, []);
-        }
-        byProvider.get(provider).push(t);
-    }
-    for (const [provider, providerTemplates] of byProvider) {
-        console.log(chalk.cyan.bold(`  ${provider.toUpperCase()}`));
-        for (const t of providerTemplates) {
-            console.log(`    ${chalk.white(t.id)}`);
-            console.log(chalk.gray(`      Event: ${t.metadata.event}`));
-            console.log(chalk.gray(`      Downloaded: ${new Date(t.downloadedAt).toLocaleDateString()}`));
-        }
-        console.log();
-    }
-    console.log(chalk.gray(`  Total: ${templates.length} templates`));
-    console.log(chalk.gray(`  Storage: ${manager.getTemplatesDir()}\n`));
-});
-const searchCommand = new Command()
-    .name("search")
-    .argument("<query>", "Search query")
-    .description("Search templates by name, provider, or event")
-    .action(async (query) => {
-    const spinner = ora("Searching...").start();
-    try {
-        const manager = getTemplateManager();
-        const results = await manager.searchTemplates(query);
-        spinner.stop();
-        const totalCount = results.remote.length + results.local.length;
-        if (totalCount === 0) {
-            console.log(chalk.yellow(`\n📭 No templates found for: "${query}"\n`));
-            return;
-        }
-        console.log(chalk.bold(`\n🔍 Search Results for "${query}"\n`));
-        if (results.local.length > 0) {
-            console.log(chalk.cyan.bold("  LOCAL TEMPLATES"));
-            for (const t of results.local) {
-                console.log(`    ${chalk.green("✓")} ${t.id} (${t.metadata.provider})`);
-            }
-            console.log();
-        }
-        if (results.remote.length > 0) {
-            console.log(chalk.cyan.bold("  REMOTE TEMPLATES"));
-            for (const t of results.remote) {
-                const status = t.isDownloaded ? chalk.green("✓") : chalk.gray("○");
-                console.log(`    ${status} ${t.metadata.id} (${t.metadata.provider})`);
-            }
-            console.log();
-        }
-        console.log(chalk.gray(`  Found: ${totalCount} templates\n`));
-    }
-    catch (error) {
-        spinner.fail("Search failed");
-        console.error(chalk.red(error.message));
-        process.exitCode = 1;
-    }
-});
-const cacheCommand = new Command()
-    .name("cache")
-    .description("Manage template cache")
-    .option("-c, --clear", "Clear the template cache")
-    .action((options) => {
-    if (options.clear) {
-        const manager = getTemplateManager();
-        manager.clearCache();
-        console.log(chalk.green("✓ Template cache cleared"));
-    }
-    else {
-        console.log("Use --clear to clear the template cache");
-    }
-});
-const cleanCommand = new Command()
-    .name("clean")
-    .alias("remove-all")
-    .description("Remove all downloaded templates")
-    .option("-f, --force", "Skip confirmation prompt")
-    .action(async (options) => {
-    const manager = getTemplateManager();
-    const templates = manager.listLocalTemplates();
-    if (templates.length === 0) {
-        console.log(chalk.yellow("\n📭 No local templates to remove.\n"));
-        return;
-    }
-    console.log(chalk.bold(`\n🗑️  Found ${templates.length} downloaded template(s)\n`));
-    for (const t of templates) {
-        console.log(chalk.gray(`    ${t.id} (${t.metadata.provider})`));
-    }
-    console.log();
-    if (!options.force) {
-        const response = await prompts({
-            type: "confirm",
-            name: "confirm",
-            message: `Delete all ${templates.length} template(s)?`,
-            initial: false,
-        });
-        if (!response.confirm) {
-            console.log(chalk.yellow("Cancelled"));
-            return;
-        }
-    }
-    const deleted = manager.deleteAllLocalTemplates();
-    console.log(chalk.green(`\n✓ Removed ${deleted} template(s)`));
-    console.log(chalk.gray(`  Storage: ${manager.getTemplatesDir()}\n`));
-});
-export const templates = new Command()
-    .name("templates")
-    .alias("t")
-    .description("Manage webhook templates")
-    .addCommand(listCommand)
-    .addCommand(downloadCommand)
-    .addCommand(localCommand)
-    .addCommand(searchCommand)
-    .addCommand(cacheCommand)
-    .addCommand(cleanCommand);

package/dist/core/capture-server.d.ts

@@ -1,31 +0,0 @@
-import type { CapturedWebhook, CaptureFile } from "../types/index.js";
-export interface CaptureServerOptions {
-    capturesDir?: string;
-    enableWebSocket?: boolean;
-    onCapture?: (args: {
-        file: string;
-        capture: CapturedWebhook;
-    }) => void;
-}
-export declare class CaptureServer {
-    private server;
-    private wss;
-    private capturesDir;
-    private clients;
-    private captureCount;
-    private enableWebSocket;
-    private onCapture?;
-    constructor(options?: string | CaptureServerOptions);
-    getCapturesDir(): string;
-    start(port?: number, host?: string): Promise<number>;
-    stop(): Promise<void>;
-    private handleRequest;
-    private detectProvider;
-    private broadcast;
-    private sendToClient;
-    listCaptures(limit?: number): CaptureFile[];
-    getCapture(captureId: string): CaptureFile | null;
-    deleteCapture(captureId: string): boolean;
-    getClientCount(): number;
-}
-export declare function getCaptureServer(capturesDir?: string): CaptureServer;

package/dist/core/capture-server.js

@@ -1,298 +0,0 @@
-import { createServer, } from "http";
-import { WebSocketServer } from "ws";
-import { writeFileSync, mkdirSync, existsSync, readdirSync, readFileSync, unlinkSync, } from "fs";
-import { join } from "path";
-import { randomUUID } from "crypto";
-import { homedir } from "os";
-export class CaptureServer {
-    server = null;
-    wss = null;
-    capturesDir;
-    clients = new Set();
-    captureCount = 0;
-    enableWebSocket;
-    onCapture;
-    constructor(options) {
-        const capturesDir = typeof options === "string" ? options : options?.capturesDir;
-        this.capturesDir =
-            capturesDir || join(homedir(), ".better-webhook", "captures");
-        this.enableWebSocket =
-            typeof options === "object" ? options?.enableWebSocket !== false : true;
-        this.onCapture =
-            typeof options === "object" ? options?.onCapture : undefined;
-        if (!existsSync(this.capturesDir)) {
-            mkdirSync(this.capturesDir, { recursive: true });
-        }
-    }
-    getCapturesDir() {
-        return this.capturesDir;
-    }
-    async start(port = 3001, host = "0.0.0.0") {
-        return new Promise((resolve, reject) => {
-            this.server = createServer((req, res) => this.handleRequest(req, res));
-            if (this.enableWebSocket) {
-                this.wss = new WebSocketServer({ server: this.server });
-                this.wss.on("connection", (ws) => {
-                    this.clients.add(ws);
-                    console.log("📡 Dashboard connected via WebSocket");
-                    ws.on("close", () => {
-                        this.clients.delete(ws);
-                        console.log("📡 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`));
-                }
-                else {
-                    reject(err);
-                }
-            });
-            this.server.listen(port, host, () => {
-                const address = this.server?.address();
-                const actualPort = typeof address === "object" ? address?.port || port : port;
-                console.log(`\n🎣 Webhook Capture Server`);
-                console.log(`   Listening on http://${host === "0.0.0.0" ? "localhost" : host}:${actualPort}`);
-                console.log(`   📁 Captures saved to: ${this.capturesDir}`);
-                console.log(`   💡 Send webhooks to any path to capture them`);
-                if (this.enableWebSocket) {
-                    console.log(`   🌐 WebSocket available for real-time updates`);
-                }
-                console.log(`   ⏹️  Press Ctrl+C to stop\n`);
-                resolve(actualPort);
-            });
-        });
-    }
-    async stop() {
-        return new Promise((resolve) => {
-            for (const client of this.clients) {
-                client.close();
-            }
-            this.clients.clear();
-            if (this.wss) {
-                this.wss.close();
-                this.wss = null;
-            }
-            if (this.server) {
-                this.server.close(() => {
-                    console.log("\n🛑 Capture server stopped");
-                    resolve();
-                });
-            }
-            else {
-                resolve();
-            }
-        });
-    }
-    async handleRequest(req, res) {
-        if (req.headers.upgrade?.toLowerCase() === "websocket") {
-            return;
-        }
-        const timestamp = new Date().toISOString();
-        const id = randomUUID();
-        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 = [];
-        for await (const chunk of req) {
-            chunks.push(chunk);
-        }
-        const rawBody = Buffer.concat(chunks).toString("utf8");
-        let body = null;
-        const contentType = req.headers["content-type"] || "";
-        if (rawBody) {
-            if (contentType.includes("application/json")) {
-                try {
-                    body = JSON.parse(rawBody);
-                }
-                catch {
-                    body = rawBody;
-                }
-            }
-            else if (contentType.includes("application/x-www-form-urlencoded")) {
-                body = Object.fromEntries(new URLSearchParams(rawBody));
-            }
-            else {
-                body = rawBody;
-            }
-        }
-        const provider = this.detectProvider(req.headers, body);
-        const captured = {
-            id,
-            timestamp,
-            method: (req.method || "GET"),
-            url,
-            path: urlParts.pathname,
-            headers: req.headers,
-            body,
-            rawBody,
-            query,
-            provider,
-            contentType: contentType || undefined,
-            contentLength: rawBody.length,
-        };
-        const date = new Date(timestamp);
-        const dateStr = date.toISOString().split("T")[0];
-        const timeStr = date
-            .toISOString()
-            .split("T")[1]
-            ?.replace(/[:.]/g, "-")
-            .slice(0, 8);
-        const filename = `${dateStr}_${timeStr}_${id.slice(0, 8)}.json`;
-        const filepath = join(this.capturesDir, filename);
-        try {
-            writeFileSync(filepath, JSON.stringify(captured, null, 2));
-            this.captureCount++;
-            const providerStr = provider ? ` [${provider}]` : "";
-            console.log(`📦 ${req.method} ${urlParts.pathname}${providerStr} -> ${filename}`);
-            this.onCapture?.({ file: filename, capture: captured });
-            if (this.enableWebSocket) {
-                this.broadcast({
-                    type: "capture",
-                    payload: {
-                        file: filename,
-                        capture: captured,
-                    },
-                });
-            }
-        }
-        catch (error) {
-            console.error(`❌ Failed to save capture:`, error);
-        }
-        res.statusCode = 200;
-        res.setHeader("Content-Type", "application/json");
-        res.setHeader("X-Capture-Id", id);
-        res.end(JSON.stringify({
-            success: true,
-            message: "Webhook captured successfully",
-            id,
-            timestamp,
-            file: filename,
-        }));
-    }
-    detectProvider(headers, body) {
-        if (headers["stripe-signature"]) {
-            return "stripe";
-        }
-        if (headers["x-github-event"] || headers["x-hub-signature-256"]) {
-            return "github";
-        }
-        if (headers["x-signature"]) {
-            if (body &&
-                typeof body === "object" &&
-                "type" in body &&
-                "payload" in body &&
-                "nonce" in body) {
-                return "ragie";
-            }
-        }
-        if (headers["x-shopify-hmac-sha256"] || headers["x-shopify-topic"]) {
-            return "shopify";
-        }
-        if (headers["x-twilio-signature"]) {
-            return "twilio";
-        }
-        if (headers["x-twilio-email-event-webhook-signature"]) {
-            return "sendgrid";
-        }
-        if (headers["x-slack-signature"]) {
-            return "slack";
-        }
-        if (headers["x-signature-ed25519"]) {
-            return "discord";
-        }
-        if (headers["linear-signature"]) {
-            return "linear";
-        }
-        if (headers["svix-signature"]) {
-            return "clerk";
-        }
-        return undefined;
-    }
-    broadcast(message) {
-        const data = JSON.stringify(message);
-        for (const client of this.clients) {
-            if (client.readyState === 1) {
-                client.send(data);
-            }
-        }
-    }
-    sendToClient(client, message) {
-        if (client.readyState === 1) {
-            client.send(JSON.stringify(message));
-        }
-    }
-    listCaptures(limit = 100) {
-        if (!existsSync(this.capturesDir)) {
-            return [];
-        }
-        const files = readdirSync(this.capturesDir)
-            .filter((f) => f.endsWith(".json"))
-            .sort()
-            .reverse()
-            .slice(0, limit);
-        const captures = [];
-        for (const file of files) {
-            try {
-                const content = readFileSync(join(this.capturesDir, file), "utf-8");
-                const capture = JSON.parse(content);
-                captures.push({ file, capture });
-            }
-            catch {
-            }
-        }
-        return captures;
-    }
-    getCapture(captureId) {
-        const captures = this.listCaptures(1000);
-        return (captures.find((c) => c.capture.id === captureId || c.file.includes(captureId)) || null);
-    }
-    deleteCapture(captureId) {
-        const capture = this.getCapture(captureId);
-        if (!capture) {
-            return false;
-        }
-        try {
-            unlinkSync(join(this.capturesDir, capture.file));
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
-    getClientCount() {
-        return this.clients.size;
-    }
-}
-let instance = null;
-export function getCaptureServer(capturesDir) {
-    if (!instance) {
-        instance = new CaptureServer(capturesDir);
-    }
-    return instance;
-}

package/dist/core/dashboard-api.d.ts

@@ -1,8 +0,0 @@
-import express from "express";
-import { type WebSocketMessage } from "../types/index.js";
-export interface DashboardApiOptions {
-    capturesDir?: string;
-    templatesBaseDir?: string;
-    broadcast?: (message: WebSocketMessage) => void;
-}
-export declare function createDashboardApiRouter(options?: DashboardApiOptions): express.Router;