@kodelyth/voice-call 2026.5.42 → 2026.6.2

package/src/tunnel.test.ts

@@ -1,173 +0,0 @@
-import { EventEmitter } from "node:events";
-import { beforeEach, describe, expect, it, vi } from "vitest";
-
-class FakeChildProcess extends EventEmitter {
-  readonly stdout = new EventEmitter();
-  readonly stderr = new EventEmitter();
-  killedWith: NodeJS.Signals | null = null;
-
-  kill(signal: NodeJS.Signals = "SIGTERM"): boolean {
-    this.killedWith = signal;
-    queueMicrotask(() => this.emit("close", null));
-    return true;
-  }
-
-  close(code: number | null = 0): void {
-    this.emit("close", code);
-  }
-
-  fail(error: Error): void {
-    this.emit("error", error);
-  }
-}
-
-const mocks = vi.hoisted(() => ({
-  spawn: vi.fn(),
-  getTailscaleDnsName: vi.fn(),
-}));
-
-vi.mock("node:child_process", () => ({
-  spawn: mocks.spawn,
-}));
-
-vi.mock("./webhook/tailscale.js", () => ({
-  getTailscaleDnsName: mocks.getTailscaleDnsName,
-}));
-
-import { isNgrokAvailable, startNgrokTunnel, startTailscaleTunnel, startTunnel } from "./tunnel.js";
-
-function nextProcess(): FakeChildProcess {
-  const proc = new FakeChildProcess();
-  mocks.spawn.mockReturnValueOnce(proc as never);
-  return proc;
-}
-
-function emitNgrokUrl(proc: FakeChildProcess, url: string): void {
-  proc.stdout.emit("data", Buffer.from(`${JSON.stringify({ msg: "started tunnel", url })}\n`));
-}
-
-describe("voice-call tunnels", () => {
-  beforeEach(() => {
-    vi.clearAllMocks();
-    mocks.getTailscaleDnsName.mockReset();
-  });
-
-  it("checks ngrok availability from the version command exit code", async () => {
-    const proc = nextProcess();
-    const result = isNgrokAvailable();
-    proc.close(0);
-
-    await expect(result).resolves.toBe(true);
-    expect(mocks.spawn).toHaveBeenCalledWith("ngrok", ["version"], {
-      stdio: ["ignore", "pipe", "pipe"],
-    });
-  });
-
-  it("treats ngrok spawn failures as unavailable", async () => {
-    const proc = nextProcess();
-    const result = isNgrokAvailable();
-    proc.fail(new Error("spawn ngrok ENOENT"));
-
-    await expect(result).resolves.toBe(false);
-  });
-
-  it("starts ngrok and appends the webhook path to the public URL", async () => {
-    const proc = nextProcess();
-    const result = startNgrokTunnel({ port: 3334, path: "/voice/webhook" });
-
-    emitNgrokUrl(proc, "https://abc.ngrok.io");
-
-    const tunnel = await result;
-    expect(tunnel.publicUrl).toBe("https://abc.ngrok.io/voice/webhook");
-    expect(tunnel.provider).toBe("ngrok");
-    expect(tunnel.stop).toBeTypeOf("function");
-    expect(mocks.spawn).toHaveBeenCalledWith(
-      "ngrok",
-      ["http", "3334", "--log", "stdout", "--log-format", "json"],
-      {
-        stdio: ["ignore", "pipe", "pipe"],
-      },
-    );
-  });
-
-  it("sets ngrok auth token before starting the tunnel", async () => {
-    const authProc = nextProcess();
-    const tunnelProc = nextProcess();
-    const result = startNgrokTunnel({
-      port: 3334,
-      path: "/hook",
-      authToken: "token",
-    });
-
-    authProc.close(0);
-    await vi.waitFor(() => expect(mocks.spawn).toHaveBeenCalledTimes(2));
-    emitNgrokUrl(tunnelProc, "https://auth.ngrok.io");
-
-    const tunnel = await result;
-    expect(tunnel.publicUrl).toBe("https://auth.ngrok.io/hook");
-    expect(tunnel.provider).toBe("ngrok");
-    expect(mocks.spawn).toHaveBeenNthCalledWith(1, "ngrok", ["config", "add-authtoken", "token"], {
-      stdio: ["ignore", "pipe", "pipe"],
-    });
-  });
-
-  it("rejects ngrok startup errors from stderr", async () => {
-    const proc = nextProcess();
-    const result = startNgrokTunnel({ port: 3334, path: "/hook" });
-
-    proc.stderr.emit("data", Buffer.from("ERR_NGROK_3200: invalid auth token"));
-
-    await expect(result).rejects.toThrow("ngrok error:");
-  });
-
-  it("starts Tailscale serve using the resolved tailnet DNS name", async () => {
-    mocks.getTailscaleDnsName.mockResolvedValue("host.tailnet.ts.net");
-    const proc = nextProcess();
-    const result = startTailscaleTunnel({
-      mode: "serve",
-      port: 3334,
-      path: "voice/webhook",
-    });
-
-    await vi.waitFor(() => expect(mocks.spawn).toHaveBeenCalled());
-    proc.close(0);
-
-    const tunnel = await result;
-    expect(tunnel.publicUrl).toBe("https://host.tailnet.ts.net/voice/webhook");
-    expect(tunnel.provider).toBe("tailscale-serve");
-    expect(tunnel.stop).toBeTypeOf("function");
-    expect(mocks.spawn).toHaveBeenCalledWith(
-      "tailscale",
-      [
-        "serve",
-        "--bg",
-        "--yes",
-        "--set-path",
-        "/voice/webhook",
-        "http://127.0.0.1:3334/voice/webhook",
-      ],
-      { stdio: ["ignore", "pipe", "pipe"] },
-    );
-  });
-
-  it("rejects Tailscale tunnel startup when the DNS name is unavailable", async () => {
-    mocks.getTailscaleDnsName.mockResolvedValue(null);
-
-    await expect(
-      startTailscaleTunnel({ mode: "funnel", port: 3334, path: "/hook" }),
-    ).rejects.toThrow("Could not get Tailscale DNS name");
-    expect(mocks.spawn).not.toHaveBeenCalled();
-  });
-
-  it("dispatches tunnel providers from config", async () => {
-    await expect(startTunnel({ provider: "none", port: 3334, path: "/hook" })).resolves.toBeNull();
-
-    const proc = nextProcess();
-    const result = startTunnel({ provider: "ngrok", port: 3334, path: "/hook" });
-    emitNgrokUrl(proc, "https://dispatch.ngrok.io");
-
-    const tunnel = await result;
-    expect(tunnel?.publicUrl).toBe("https://dispatch.ngrok.io/hook");
-    expect(tunnel?.provider).toBe("ngrok");
-  });
-});

package/src/tunnel.ts

@@ -1,314 +0,0 @@
-import { spawn } from "node:child_process";
-import { getTailscaleDnsName } from "./webhook/tailscale.js";
-
-/**
- * Tunnel configuration for exposing the webhook server.
- */
-interface TunnelConfig {
-  /** Tunnel provider: ngrok, tailscale-serve, or tailscale-funnel */
-  provider: "ngrok" | "tailscale-serve" | "tailscale-funnel" | "none";
-  /** Local port to tunnel */
-  port: number;
-  /** Path prefix for the tunnel (e.g., /voice/webhook) */
-  path: string;
-  /** ngrok auth token (optional, enables longer sessions) */
-  ngrokAuthToken?: string;
-  /** ngrok custom domain (paid feature) */
-  ngrokDomain?: string;
-}
-
-/**
- * Result of starting a tunnel.
- */
-export interface TunnelResult {
-  /** The public URL */
-  publicUrl: string;
-  /** Function to stop the tunnel */
-  stop: () => Promise<void>;
-  /** Tunnel provider name */
-  provider: string;
-}
-
-/**
- * Start an ngrok tunnel to expose the local webhook server.
- *
- * Uses the ngrok CLI which must be installed: https://ngrok.com/download
- *
- * @example
- * const tunnel = await startNgrokTunnel({ port: 3334, path: '/voice/webhook' });
- * console.log('Public URL:', tunnel.publicUrl);
- * // Later: await tunnel.stop();
- */
-export async function startNgrokTunnel(config: {
-  port: number;
-  path: string;
-  authToken?: string;
-  domain?: string;
-}): Promise<TunnelResult> {
-  // Set auth token if provided
-  if (config.authToken) {
-    await runNgrokCommand(["config", "add-authtoken", config.authToken]);
-  }
-
-  // Build ngrok command args
-  const args = ["http", String(config.port), "--log", "stdout", "--log-format", "json"];
-
-  // Add custom domain if provided (paid ngrok feature)
-  if (config.domain) {
-    args.push("--domain", config.domain);
-  }
-
-  return new Promise((resolve, reject) => {
-    const proc = spawn("ngrok", args, {
-      stdio: ["ignore", "pipe", "pipe"],
-    });
-
-    let resolved = false;
-    let publicUrl: string | null = null;
-    let outputBuffer = "";
-
-    const timeout = setTimeout(() => {
-      if (!resolved) {
-        resolved = true;
-        proc.kill("SIGTERM");
-        reject(new Error("ngrok startup timed out (30s)"));
-      }
-    }, 30000);
-
-    const processLine = (line: string) => {
-      try {
-        const log = JSON.parse(line);
-
-        // ngrok logs the public URL in a 'started tunnel' message
-        if (log.msg === "started tunnel" && log.url) {
-          publicUrl = log.url;
-        }
-
-        // Also check for the URL field directly
-        if (log.addr && log.url && !publicUrl) {
-          publicUrl = log.url;
-        }
-
-        // Check for ready state
-        if (publicUrl && !resolved) {
-          resolved = true;
-          clearTimeout(timeout);
-
-          // Add path to the public URL
-          const fullUrl = publicUrl + config.path;
-
-          console.log(`[voice-call] ngrok tunnel active: ${fullUrl}`);
-
-          resolve({
-            publicUrl: fullUrl,
-            provider: "ngrok",
-            stop: async () => {
-              proc.kill("SIGTERM");
-              await new Promise<void>((res) => {
-                proc.on("close", () => res());
-                setTimeout(res, 2000); // Fallback timeout
-              });
-            },
-          });
-        }
-      } catch {
-        // Not JSON, might be startup message
-      }
-    };
-
-    proc.stdout.on("data", (data: Buffer) => {
-      outputBuffer += data.toString();
-      const lines = outputBuffer.split("\n");
-      outputBuffer = lines.pop() || "";
-
-      for (const line of lines) {
-        if (line.trim()) {
-          processLine(line);
-        }
-      }
-    });
-
-    proc.stderr.on("data", (data: Buffer) => {
-      const msg = data.toString();
-      // Check for common errors
-      if (msg.includes("ERR_NGROK")) {
-        if (!resolved) {
-          resolved = true;
-          clearTimeout(timeout);
-          reject(new Error(`ngrok error: ${msg}`));
-        }
-      }
-    });
-
-    proc.on("error", (err) => {
-      if (!resolved) {
-        resolved = true;
-        clearTimeout(timeout);
-        reject(new Error(`Failed to start ngrok: ${err.message}`));
-      }
-    });
-
-    proc.on("close", (code) => {
-      if (!resolved) {
-        resolved = true;
-        clearTimeout(timeout);
-        reject(new Error(`ngrok exited unexpectedly with code ${code}`));
-      }
-    });
-  });
-}
-
-/**
- * Run an ngrok command and wait for completion.
- */
-async function runNgrokCommand(args: string[]): Promise<string> {
-  return new Promise((resolve, reject) => {
-    const proc = spawn("ngrok", args, {
-      stdio: ["ignore", "pipe", "pipe"],
-    });
-
-    let stdout = "";
-    let stderr = "";
-
-    proc.stdout.on("data", (data) => {
-      stdout += data.toString();
-    });
-    proc.stderr.on("data", (data) => {
-      stderr += data.toString();
-    });
-
-    proc.on("close", (code) => {
-      if (code === 0) {
-        resolve(stdout);
-      } else {
-        reject(new Error(`ngrok command failed: ${stderr || stdout}`));
-      }
-    });
-
-    proc.on("error", reject);
-  });
-}
-
-/**
- * Check if ngrok is installed and available.
- */
-export async function isNgrokAvailable(): Promise<boolean> {
-  return new Promise((resolve) => {
-    const proc = spawn("ngrok", ["version"], {
-      stdio: ["ignore", "pipe", "pipe"],
-    });
-
-    proc.on("close", (code) => {
-      resolve(code === 0);
-    });
-
-    proc.on("error", () => {
-      resolve(false);
-    });
-  });
-}
-
-/**
- * Start a Tailscale serve/funnel tunnel.
- */
-export async function startTailscaleTunnel(config: {
-  mode: "serve" | "funnel";
-  port: number;
-  path: string;
-}): Promise<TunnelResult> {
-  // Get Tailscale DNS name
-  const dnsName = await getTailscaleDnsName();
-  if (!dnsName) {
-    throw new Error("Could not get Tailscale DNS name. Is Tailscale running?");
-  }
-
-  const path = config.path.startsWith("/") ? config.path : `/${config.path}`;
-  const localUrl = `http://127.0.0.1:${config.port}${path}`;
-
-  return new Promise((resolve, reject) => {
-    const proc = spawn("tailscale", [config.mode, "--bg", "--yes", "--set-path", path, localUrl], {
-      stdio: ["ignore", "pipe", "pipe"],
-    });
-
-    const timeout = setTimeout(() => {
-      proc.kill("SIGKILL");
-      reject(new Error(`Tailscale ${config.mode} timed out`));
-    }, 10000);
-
-    proc.on("close", (code) => {
-      clearTimeout(timeout);
-      if (code === 0) {
-        const publicUrl = `https://${dnsName}${path}`;
-        console.log(`[voice-call] Tailscale ${config.mode} active: ${publicUrl}`);
-
-        resolve({
-          publicUrl,
-          provider: `tailscale-${config.mode}`,
-          stop: async () => {
-            await stopTailscaleTunnel(config.mode, path);
-          },
-        });
-      } else {
-        reject(new Error(`Tailscale ${config.mode} failed with code ${code}`));
-      }
-    });
-
-    proc.on("error", (err) => {
-      clearTimeout(timeout);
-      reject(err);
-    });
-  });
-}
-
-/**
- * Stop a Tailscale serve/funnel tunnel.
- */
-async function stopTailscaleTunnel(mode: "serve" | "funnel", path: string): Promise<void> {
-  return new Promise((resolve) => {
-    const proc = spawn("tailscale", [mode, "off", path], {
-      stdio: "ignore",
-    });
-
-    const timeout = setTimeout(() => {
-      proc.kill("SIGKILL");
-      resolve();
-    }, 5000);
-
-    proc.on("close", () => {
-      clearTimeout(timeout);
-      resolve();
-    });
-  });
-}
-
-/**
- * Start a tunnel based on configuration.
- */
-export async function startTunnel(config: TunnelConfig): Promise<TunnelResult | null> {
-  switch (config.provider) {
-    case "ngrok":
-      return startNgrokTunnel({
-        port: config.port,
-        path: config.path,
-        authToken: config.ngrokAuthToken,
-        domain: config.ngrokDomain,
-      });
-
-    case "tailscale-serve":
-      return startTailscaleTunnel({
-        mode: "serve",
-        port: config.port,
-        path: config.path,
-      });
-
-    case "tailscale-funnel":
-      return startTailscaleTunnel({
-        mode: "funnel",
-        port: config.port,
-        path: config.path,
-      });
-
-    default:
-      return null;
-  }
-}