refactor: modularize cli helpers

src/infra/binaries.ts

@@ -0,0 +1,14 @@
+import { runExec } from "../process/exec.js";
+import { defaultRuntime, type RuntimeEnv } from "../runtime.js";
+
+export async function ensureBinary(
+	name: string,
+	exec: typeof runExec = runExec,
+	runtime: RuntimeEnv = defaultRuntime,
+): Promise<void> {
+	// Abort early if a required CLI tool is missing.
+	await exec("which", [name]).catch(() => {
+		runtime.error(`Missing required binary: ${name}. Please install it.`);
+		runtime.exit(1);
+	});
+}

src/infra/ports.ts

@@ -0,0 +1,107 @@
+import net from "node:net";
+
+import chalk from "chalk";
+
+import { runExec } from "../process/exec.js";
+import { defaultRuntime, type RuntimeEnv } from "../runtime.js";
+import { danger, info, isVerbose, logVerbose, warn } from "../globals.js";
+
+class PortInUseError extends Error {
+	port: number;
+	details?: string;
+
+	constructor(port: number, details?: string) {
+		super(`Port ${port} is already in use.`);
+		this.name = "PortInUseError";
+		this.port = port;
+		this.details = details;
+	}
+}
+
+function isErrno(err: unknown): err is NodeJS.ErrnoException {
+	return Boolean(err && typeof err === "object" && "code" in err);
+}
+
+export async function describePortOwner(port: number): Promise<string | undefined> {
+	// Best-effort process info for a listening port (macOS/Linux).
+	try {
+		const { stdout } = await runExec("lsof", [
+			"-i",
+			`tcp:${port}`,
+			"-sTCP:LISTEN",
+			"-nP",
+		]);
+		const trimmed = stdout.trim();
+		if (trimmed) return trimmed;
+	} catch (err) {
+		logVerbose(`lsof unavailable: ${String(err)}`);
+	}
+	return undefined;
+}
+
+export async function ensurePortAvailable(port: number): Promise<void> {
+	// Detect EADDRINUSE early with a friendly message.
+	try {
+		await new Promise<void>((resolve, reject) => {
+			const tester = net
+				.createServer()
+				.once("error", (err) => reject(err))
+				.once("listening", () => {
+					tester.close(() => resolve());
+				})
+				.listen(port);
+		});
+	} catch (err) {
+		if (isErrno(err) && err.code === "EADDRINUSE") {
+			const details = await describePortOwner(port);
+			throw new PortInUseError(port, details);
+		}
+		throw err;
+	}
+}
+
+export async function handlePortError(
+	err: unknown,
+	port: number,
+	context: string,
+	runtime: RuntimeEnv = defaultRuntime,
+): Promise<never> {
+	// Uniform messaging for EADDRINUSE with optional owner details.
+	if (
+		err instanceof PortInUseError ||
+		(isErrno(err) && err.code === "EADDRINUSE")
+	) {
+		const details =
+			err instanceof PortInUseError
+				? err.details
+				: await describePortOwner(port);
+		runtime.error(danger(`${context} failed: port ${port} is already in use.`));
+		if (details) {
+			runtime.error(info("Port listener details:"));
+			runtime.error(details);
+			if (/warelay|src\/index\.ts|dist\/index\.js/.test(details)) {
+				runtime.error(
+					warn(
+						"It looks like another warelay instance is already running. Stop it or pick a different port.",
+					),
+				);
+			}
+		}
+		runtime.error(
+			info(
+				"Resolve by stopping the process using the port or passing --port <free-port>.",
+			),
+		);
+		runtime.exit(1);
+	}
+	runtime.error(danger(`${context} failed: ${String(err)}`));
+	if (isVerbose()) {
+		const stdout = (err as { stdout?: string })?.stdout;
+		const stderr = (err as { stderr?: string })?.stderr;
+		if (stdout?.trim()) runtime.error(chalk.gray(`stdout: ${stdout.trim()}`));
+		if (stderr?.trim()) runtime.error(chalk.gray(`stderr: ${stderr.trim()}`));
+	}
+	return runtime.exit(1);
+}
+
+export { PortInUseError };

src/infra/tailscale.ts

@@ -0,0 +1,164 @@
+import chalk from "chalk";
+
+import { danger, info, isVerbose, logVerbose, warn } from "../globals.js";
+import { promptYesNo } from "../cli/prompt.js";
+import { runExec } from "../process/exec.js";
+import { defaultRuntime, type RuntimeEnv } from "../runtime.js";
+import { ensureBinary } from "./binaries.js";
+
+export async function getTailnetHostname(exec: typeof runExec = runExec) {
+	// Derive tailnet hostname (or IP fallback) from tailscale status JSON.
+	const { stdout } = await exec("tailscale", ["status", "--json"]);
+	const parsed = stdout ? (JSON.parse(stdout) as Record<string, unknown>) : {};
+	const self =
+		typeof parsed.Self === "object" && parsed.Self !== null
+			? (parsed.Self as Record<string, unknown>)
+			: undefined;
+	const dns =
+		typeof self?.DNSName === "string" ? (self.DNSName as string) : undefined;
+	const ips = Array.isArray(self?.TailscaleIPs)
+		? (self.TailscaleIPs as string[])
+		: [];
+	if (dns && dns.length > 0) return dns.replace(/\.$/, "");
+	if (ips.length > 0) return ips[0];
+	throw new Error("Could not determine Tailscale DNS or IP");
+}
+
+export async function ensureGoInstalled(
+	exec: typeof runExec = runExec,
+	prompt: typeof promptYesNo = promptYesNo,
+	runtime: RuntimeEnv = defaultRuntime,
+) {
+	// Ensure Go toolchain is present; offer Homebrew install if missing.
+	const hasGo = await exec("go", ["version"]).then(
+		() => true,
+		() => false,
+	);
+	if (hasGo) return;
+	const install = await prompt(
+		"Go is not installed. Install via Homebrew (brew install go)?",
+		true,
+	);
+	if (!install) {
+		runtime.error("Go is required to build tailscaled from source. Aborting.");
+		runtime.exit(1);
+	}
+	logVerbose("Installing Go via Homebrew…");
+	await exec("brew", ["install", "go"]);
+}
+
+export async function ensureTailscaledInstalled(
+	exec: typeof runExec = runExec,
+	prompt: typeof promptYesNo = promptYesNo,
+	runtime: RuntimeEnv = defaultRuntime,
+) {
+	// Ensure tailscaled binary exists; install via Homebrew tailscale if missing.
+	const hasTailscaled = await exec("tailscaled", ["--version"]).then(
+		() => true,
+		() => false,
+	);
+	if (hasTailscaled) return;
+
+	const install = await prompt(
+		"tailscaled not found. Install via Homebrew (tailscale package)?",
+		true,
+	);
+	if (!install) {
+		runtime.error("tailscaled is required for user-space funnel. Aborting.");
+		runtime.exit(1);
+	}
+	logVerbose("Installing tailscaled via Homebrew…");
+	await exec("brew", ["install", "tailscale"]);
+}
+
+export async function ensureFunnel(
+	port: number,
+	exec: typeof runExec = runExec,
+	runtime: RuntimeEnv = defaultRuntime,
+	prompt: typeof promptYesNo = promptYesNo,
+) {
+	// Ensure Funnel is enabled and publish the webhook port.
+	try {
+		const statusOut = (
+			await exec("tailscale", ["funnel", "status", "--json"])
+		).stdout.trim();
+		const parsed = statusOut
+			? (JSON.parse(statusOut) as Record<string, unknown>)
+			: {};
+		if (!parsed || Object.keys(parsed).length === 0) {
+			runtime.error(
+				danger("Tailscale Funnel is not enabled on this tailnet/device."),
+			);
+			runtime.error(
+				info(
+					"Enable in admin console: https://login.tailscale.com/admin (see https://tailscale.com/kb/1223/funnel)",
+				),
+			);
+			runtime.error(
+				info(
+					"macOS user-space tailscaled docs: https://github.com/tailscale/tailscale/wiki/Tailscaled-on-macOS",
+				),
+			);
+			const proceed = await prompt(
+				"Attempt local setup with user-space tailscaled?",
+				true,
+			);
+			if (!proceed) runtime.exit(1);
+			await ensureBinary("brew", exec, runtime);
+			await ensureGoInstalled(exec, prompt, runtime);
+			await ensureTailscaledInstalled(exec, prompt, runtime);
+		}
+
+		logVerbose(`Enabling funnel on port ${port}…`);
+		const { stdout } = await exec(
+			"tailscale",
+			["funnel", "--yes", "--bg", `${port}`],
+			{
+				maxBuffer: 200_000,
+				timeoutMs: 15_000,
+			},
+		);
+		if (stdout.trim()) console.log(stdout.trim());
+	} catch (err) {
+		const errOutput = err as { stdout?: unknown; stderr?: unknown };
+		const stdout = typeof errOutput.stdout === "string" ? errOutput.stdout : "";
+		const stderr = typeof errOutput.stderr === "string" ? errOutput.stderr : "";
+		if (stdout.includes("Funnel is not enabled")) {
+			console.error(danger("Funnel is not enabled on this tailnet/device."));
+			const linkMatch = stdout.match(/https?:\/\/\S+/);
+			if (linkMatch) {
+				console.error(info(`Enable it here: ${linkMatch[0]}`));
+			} else {
+				console.error(
+					info(
+						"Enable in admin console: https://login.tailscale.com/admin (see https://tailscale.com/kb/1223/funnel)",
+					),
+				);
+			}
+		}
+		if (
+			stderr.includes("client version") ||
+			stdout.includes("client version")
+		) {
+			console.error(
+				warn(
+					"Tailscale client/server version mismatch detected; try updating tailscale/tailscaled.",
+				),
+			);
+		}
+		runtime.error(
+			"Failed to enable Tailscale Funnel. Is it allowed on your tailnet?",
+		);
+		runtime.error(
+			info(
+				"Tip: you can fall back to polling (no webhooks needed): `pnpm warelay relay --provider twilio --interval 5 --lookback 10`",
+			),
+		);
+		if (isVerbose()) {
+			if (stdout.trim()) runtime.error(chalk.gray(`stdout: ${stdout.trim()}`));
+			if (stderr.trim()) runtime.error(chalk.gray(`stderr: ${stderr.trim()}`));
+			runtime.error(err as Error);
+		}
+		runtime.exit(1);
+	}
+}