@hamedb89/localghost 0.1.0

package/dist/cli.js

@@ -0,0 +1,804 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { existsSync as existsSync5, unlinkSync } from "fs";
+import { Command, InvalidArgumentError } from "commander";
+
+// src/config.ts
+import { existsSync, readFileSync, readdirSync } from "fs";
+import { basename, join, resolve } from "path";
+
+// src/parse.ts
+var HOST_PATTERN = /^(?=.{1,253}$)(?!-)[a-z0-9-]+(\.[a-z0-9-]+)*\.?$/i;
+function parseDevHosts(input, fileName = ".localghost") {
+  const entries = [];
+  input.split(/\r?\n/).forEach((rawLine, index) => {
+    const line = rawLine.replace(/#.*/, "").trim();
+    if (!line) {
+      return;
+    }
+    const parts = line.split(/\s+/);
+    const host = parts[0];
+    const portRaw = parts[1];
+    if (!host || !portRaw || parts.length > 2) {
+      throw new Error(`Invalid ${fileName} line ${index + 1}: "${rawLine}"`);
+    }
+    if (!HOST_PATTERN.test(host)) {
+      throw new Error(`Invalid host on line ${index + 1}: "${host}"`);
+    }
+    const port = Number(portRaw);
+    if (!Number.isInteger(port) || port < 1 || port > 65535) {
+      throw new Error(`Invalid port on line ${index + 1}: "${portRaw}"`);
+    }
+    entries.push({
+      host: host.toLowerCase().replace(/\.$/, ""),
+      port,
+      target: `127.0.0.1:${port}`
+    });
+  });
+  return entries;
+}
+function findLocalMdnsHosts(entries) {
+  return [...new Set(entries.map((entry) => entry.host).filter((host) => host.endsWith(".local")))];
+}
+
+// src/config.ts
+var LOCALGHOST_CONFIG_FILE = ".localghost";
+function unique(values) {
+  return [...new Set(values.filter(Boolean))];
+}
+function toRegExp(pattern) {
+  return typeof pattern === "string" ? new RegExp(pattern) : pattern;
+}
+function findPatternMatches(cwd, pattern) {
+  const matcher = toRegExp(pattern);
+  return readdirSync(cwd, { withFileTypes: true }).filter((entry) => entry.isFile()).map((entry) => entry.name).filter((name) => {
+    matcher.lastIndex = 0;
+    return matcher.test(name);
+  }).sort();
+}
+function getConfigFileCandidates(options = {}) {
+  const cwd = options.cwd ?? process.cwd();
+  const exactFiles = unique([
+    ...options.fileName ? [options.fileName] : [],
+    ...options.configFiles ?? []
+  ]);
+  const patternFiles = options.configPattern ? findPatternMatches(cwd, options.configPattern) : [];
+  const candidates = unique([...exactFiles, ...patternFiles]);
+  if (candidates.length > 0) return candidates;
+  if (exactFiles.length > 0 || options.configPattern) return [];
+  return [LOCALGHOST_CONFIG_FILE];
+}
+function resolveDevHostsPath(options = {}) {
+  const cwd = options.cwd ?? process.cwd();
+  const searchedFiles = getConfigFileCandidates(options);
+  for (const fileName2 of searchedFiles) {
+    const path = resolve(cwd, fileName2);
+    if (existsSync(path)) {
+      return {
+        path,
+        fileName: basename(fileName2),
+        exists: true,
+        searchedFiles,
+        ...options.configPattern ? { configPattern: options.configPattern } : {}
+      };
+    }
+  }
+  const fileName = searchedFiles[0] ?? LOCALGHOST_CONFIG_FILE;
+  return {
+    path: resolve(cwd, fileName),
+    fileName: basename(fileName),
+    exists: false,
+    searchedFiles,
+    ...options.configPattern ? { configPattern: options.configPattern } : {}
+  };
+}
+function formatSearchedFiles(files, pattern) {
+  if (files.length > 0) return files.map((file) => `\`${file}\``).join(", ");
+  if (pattern) return `files matching ${pattern.toString()}`;
+  return `\`${LOCALGHOST_CONFIG_FILE}\``;
+}
+function readDevHosts(options = {}) {
+  const resolvedOptions = typeof options === "string" ? { cwd: options } : options;
+  const resolvedPath = resolveDevHostsPath(resolvedOptions);
+  if (!resolvedPath.exists) {
+    const cwd = resolvedOptions.cwd ?? process.cwd();
+    throw new Error(
+      `Missing Localghost config in ${cwd}. Looked for ${formatSearchedFiles(resolvedPath.searchedFiles, resolvedPath.configPattern)}. Run \`localghost init\` or pass --config/--config-pattern.`
+    );
+  }
+  return parseDevHosts(readFileSync(resolvedPath.path, "utf8"), resolvedPath.fileName);
+}
+function getProjectName(cwd = process.cwd()) {
+  try {
+    const pkg = JSON.parse(readFileSync(join(cwd, "package.json"), "utf8"));
+    const name = typeof pkg.name === "string" && pkg.name ? pkg.name : "app";
+    return sanitizeProjectName(name.replace(/^@/, ""));
+  } catch {
+    return "app";
+  }
+}
+function sanitizeProjectName(value) {
+  const projectName = value.replace(/[^\w.-]+/g, "-").replace(/^-+|-+$/g, "");
+  return projectName || "app";
+}
+
+// src/caddy.ts
+import { dirname as dirname2, join as join2 } from "path";
+import { execa } from "execa";
+
+// src/fs.ts
+import { mkdirSync, readFileSync as readFileSync2, writeFileSync } from "fs";
+import { dirname } from "path";
+function readTextFile(path) {
+  return readFileSync2(path, "utf8");
+}
+function writeTextFile(path, value) {
+  mkdirSync(dirname(path), { recursive: true });
+  writeFileSync(path, value, "utf8");
+  return path;
+}
+
+// src/caddy.ts
+function groupByPort(entries) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const entry of entries) {
+    const group = groups.get(entry.port) ?? [];
+    group.push(entry);
+    groups.set(entry.port, group);
+  }
+  return groups;
+}
+function getCaddyfilePath(cwd = process.cwd()) {
+  return join2(cwd, "ops/local/Caddyfile");
+}
+function renderCaddyfile(entries) {
+  const groups = groupByPort(entries);
+  const blocks = [...groups.entries()].sort(([leftPort], [rightPort]) => leftPort - rightPort).map(([port, group]) => {
+    const hosts = group.map((entry) => entry.host).sort().join(", ");
+    return `${hosts} {
+  reverse_proxy 127.0.0.1:${port}
+}`;
+  });
+  return `{
+  local_certs
+}
+
+${blocks.join("\n\n")}
+`;
+}
+async function writeCaddyfile(entries, cwd = process.cwd()) {
+  const path = getCaddyfilePath(cwd);
+  writeTextFile(path, renderCaddyfile(entries));
+  return path;
+}
+async function validateCaddyfile(path) {
+  await execa("caddy", ["validate", "--config", path], {
+    cwd: dirname2(path),
+    stdio: "inherit"
+  });
+}
+async function runCaddy(path) {
+  await execa("caddy", ["run", "--config", path], {
+    cwd: dirname2(path),
+    stdio: "inherit"
+  });
+}
+
+// src/doctor.ts
+import { execa as execa2 } from "execa";
+async function checkCaddy() {
+  try {
+    const result = await execa2("caddy", ["version"], { reject: false });
+    const version = [result.stdout, result.stderr].filter(Boolean).join("\n").trim();
+    return {
+      found: result.exitCode === 0,
+      ...version ? { version } : {},
+      installHint: "brew install caddy"
+    };
+  } catch {
+    return {
+      found: false,
+      installHint: "brew install caddy"
+    };
+  }
+}
+async function runDoctor() {
+  const caddy = await checkCaddy();
+  return {
+    ok: caddy.found,
+    caddy
+  };
+}
+
+// src/hosts-file.ts
+import { writeFileSync as writeFileSync2 } from "fs";
+import { tmpdir } from "os";
+import { join as join3 } from "path";
+import { execa as execa3 } from "execa";
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function getManagedBlockPattern(projectName) {
+  const sanitizedProjectName = sanitizeProjectName(projectName);
+  const start = `# localghost:start ${sanitizedProjectName}`;
+  const end = `# localghost:end ${sanitizedProjectName}`;
+  return new RegExp(`${escapeRegExp(start)}[\\s\\S]*?${escapeRegExp(end)}\\n?`, "m");
+}
+function getSystemHostsPath() {
+  return process.platform === "win32" ? "C:\\Windows\\System32\\drivers\\etc\\hosts" : "/etc/hosts";
+}
+function renderHostsBlock(projectName, entries) {
+  const sanitizedProjectName = sanitizeProjectName(projectName);
+  const hosts = [...new Set(entries.map((entry) => entry.host))].sort();
+  return [
+    `# localghost:start ${sanitizedProjectName}`,
+    ...hosts.map((host) => `127.0.0.1 ${host}`),
+    `# localghost:end ${sanitizedProjectName}`,
+    ""
+  ].join("\n");
+}
+function upsertManagedBlock(existing, projectName, block) {
+  const pattern = getManagedBlockPattern(projectName);
+  if (pattern.test(existing)) {
+    return existing.replace(pattern, block);
+  }
+  return `${existing.trimEnd()}
+
+${block}`;
+}
+function removeManagedBlock(existing, projectName) {
+  const pattern = getManagedBlockPattern(projectName);
+  if (!pattern.test(existing)) {
+    return existing;
+  }
+  return existing.replace(pattern, "").replace(/\n{3,}/g, "\n\n").trimEnd() + "\n";
+}
+async function writeSystemHostsFile(hostsPath, next, projectName) {
+  const sanitizedProjectName = sanitizeProjectName(projectName);
+  const tempPath = join3(tmpdir(), `localghost-${sanitizedProjectName}-hosts`);
+  writeFileSync2(tempPath, next, "utf8");
+  if (process.platform === "win32") {
+    throw new Error(`Windows support: run as administrator and copy ${tempPath} to ${hostsPath}.`);
+  }
+  await execa3("sudo", ["cp", tempPath, hostsPath], { stdio: "inherit" });
+  return tempPath;
+}
+async function updateSystemHosts(projectName, entries) {
+  const sanitizedProjectName = sanitizeProjectName(projectName);
+  const hostsPath = getSystemHostsPath();
+  const existing = readTextFile(hostsPath);
+  const block = renderHostsBlock(sanitizedProjectName, entries);
+  const next = upsertManagedBlock(existing, sanitizedProjectName, block);
+  if (next === existing) {
+    return { changed: false, hostsPath };
+  }
+  const tempPath = await writeSystemHostsFile(hostsPath, next, sanitizedProjectName);
+  return { changed: true, hostsPath, tempPath };
+}
+async function removeSystemHosts(projectName) {
+  const sanitizedProjectName = sanitizeProjectName(projectName);
+  const hostsPath = getSystemHostsPath();
+  const existing = readTextFile(hostsPath);
+  const next = removeManagedBlock(existing, sanitizedProjectName);
+  if (next === existing) {
+    return { changed: false, removed: false, hostsPath };
+  }
+  const tempPath = await writeSystemHostsFile(hostsPath, next, sanitizedProjectName);
+  return { changed: true, removed: true, hostsPath, tempPath };
+}
+
+// src/init.ts
+import { existsSync as existsSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "fs";
+import { join as join4 } from "path";
+function detectPackageManager(cwd = process.cwd()) {
+  if (existsSync2(join4(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync2(join4(cwd, "yarn.lock"))) return "yarn";
+  return "npm";
+}
+function packageRunCommand(packageManager, script) {
+  if (packageManager === "yarn") return `yarn ${script}`;
+  if (packageManager === "pnpm") return `pnpm ${script}`;
+  return `npm run ${script}`;
+}
+function renderConfig(options) {
+  return [
+    "# Buh. Friendly names for local services.",
+    "# Format: <host> <port>",
+    `${options.host} ${options.port}`,
+    `www.${options.host} ${options.port}`,
+    `${options.apiHost} ${options.apiPort}`,
+    ""
+  ].join("\n");
+}
+function readPackageJson(path) {
+  try {
+    return JSON.parse(readFileSync3(path, "utf8"));
+  } catch {
+    return null;
+  }
+}
+function shellQuote(value) {
+  if (/^[A-Za-z0-9_./:-]+$/.test(value)) return value;
+  return `'${value.replace(/'/g, `'"'"'`)}'`;
+}
+function getConfigFlag(configFile) {
+  return configFile === LOCALGHOST_CONFIG_FILE ? "" : ` --config ${shellQuote(configFile)}`;
+}
+function updatePackageScripts(packageJsonPath, configFile) {
+  const pkg = readPackageJson(packageJsonPath);
+  if (!pkg) return false;
+  const scripts = typeof pkg.scripts === "object" && pkg.scripts ? pkg.scripts : {};
+  const configFlag = getConfigFlag(configFile);
+  const nextScripts = {
+    ...scripts,
+    "localghost:setup": scripts["localghost:setup"] ?? `localghost setup${configFlag}`,
+    "localghost:proxy": scripts["localghost:proxy"] ?? `localghost dev${configFlag}`,
+    "localghost:print": scripts["localghost:print"] ?? `localghost print${configFlag}`,
+    "localghost:routes": scripts["localghost:routes"] ?? `localghost routes${configFlag}`,
+    "localghost:status": scripts["localghost:status"] ?? "localghost status",
+    "localghost:teardown": scripts["localghost:teardown"] ?? "localghost teardown",
+    "localghost:doctor": scripts["localghost:doctor"] ?? "localghost doctor",
+    "localghost:update": scripts["localghost:update"] ?? "localghost update"
+  };
+  const changed = JSON.stringify(scripts) !== JSON.stringify(nextScripts);
+  if (!changed) return false;
+  pkg.scripts = nextScripts;
+  writeFileSync3(packageJsonPath, `${JSON.stringify(pkg, null, 2)}
+`, "utf8");
+  return true;
+}
+function initLocalghost(options = {}) {
+  const cwd = options.cwd ?? process.cwd();
+  const projectName = sanitizeProjectName(getProjectName(cwd).split("/").pop() ?? "app");
+  const host = options.host ?? `${projectName}.localhost`;
+  const port = options.port ?? 5173;
+  const apiHost = options.apiHost ?? `api.${host}`;
+  const apiPort = options.apiPort ?? 8787;
+  const packageManager = options.packageManager ?? detectPackageManager(cwd);
+  const configFile = options.configFile ?? LOCALGHOST_CONFIG_FILE;
+  const configPath = join4(cwd, configFile);
+  const configExists = existsSync2(configPath);
+  if (configExists && !options.force) {
+    return {
+      configPath,
+      configCreated: false,
+      packageJsonChanged: false,
+      packageManager,
+      nextSteps: [
+        packageRunCommand(packageManager, "localghost:doctor"),
+        packageRunCommand(packageManager, "localghost:setup"),
+        packageRunCommand(packageManager, "localghost:proxy")
+      ]
+    };
+  }
+  writeTextFile(configPath, renderConfig({ host, port, apiHost, apiPort }));
+  const packageJsonPath = join4(cwd, "package.json");
+  const packageJsonChanged = options.writeScripts ? updatePackageScripts(packageJsonPath, configFile) : false;
+  return {
+    configPath,
+    configCreated: true,
+    ...existsSync2(packageJsonPath) ? { packageJsonPath } : {},
+    packageJsonChanged,
+    packageManager,
+    nextSteps: [
+      packageRunCommand(packageManager, "localghost:doctor"),
+      packageRunCommand(packageManager, "localghost:setup"),
+      packageRunCommand(packageManager, "localghost:proxy")
+    ]
+  };
+}
+
+// src/routes.ts
+function getDomainRoutes(entries, options = {}) {
+  const protocol = options.https === false ? "http" : "https";
+  return [...entries].sort((left, right) => left.host.localeCompare(right.host) || left.port - right.port).map((entry) => ({
+    host: entry.host,
+    port: entry.port,
+    url: `${protocol}://${entry.host}/`,
+    upstream: `http://${entry.target}`
+  }));
+}
+function formatDomainRoutes(entries, options = {}) {
+  const routes = getDomainRoutes(entries, options);
+  if (routes.length === 0) {
+    return "localghost routes\n  no routes";
+  }
+  return [
+    "localghost routes",
+    ...routes.map((route) => `  ${route.url} -> ${route.upstream}`)
+  ].join("\n");
+}
+
+// src/state.ts
+import { existsSync as existsSync3 } from "fs";
+import { join as join5 } from "path";
+var LOCALGHOST_STATE_FILE = "ops/local/localghost-state.json";
+function getLocalghostStatePath(cwd = process.cwd()) {
+  return join5(cwd, LOCALGHOST_STATE_FILE);
+}
+function readLocalghostState(cwd = process.cwd()) {
+  const path = getLocalghostStatePath(cwd);
+  if (!existsSync3(path)) return null;
+  return JSON.parse(readTextFile(path));
+}
+function writeLocalghostState(cwd, state) {
+  const path = getLocalghostStatePath(cwd);
+  writeTextFile(path, `${JSON.stringify({ version: 1, updatedAt: (/* @__PURE__ */ new Date()).toISOString(), ...state }, null, 2)}
+`);
+  return path;
+}
+
+// src/update-check.ts
+import { existsSync as existsSync4, mkdirSync as mkdirSync2, readFileSync as readFileSync4, writeFileSync as writeFileSync4 } from "fs";
+import { homedir } from "os";
+import { dirname as dirname3, join as join6 } from "path";
+var LOCALGHOST_PACKAGE_NAME = "@hamedb89/localghost";
+var LOCALGHOST_VERSION = "0.1.0";
+var UPDATE_CHECK_CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
+var UPDATE_CHECK_NOTIFY_TTL_MS = 24 * 60 * 60 * 1e3;
+var UPDATE_CHECK_TIMEOUT_MS = 900;
+function truthyEnv(value) {
+  return value === "1" || value === "true" || value === "yes";
+}
+function isUpdateCheckDisabled(env = process.env) {
+  return truthyEnv(env.LOCALGHOST_NO_UPDATE_CHECK);
+}
+function getUpdateCheckCachePath(env = process.env) {
+  if (env.LOCALGHOST_UPDATE_CHECK_CACHE) return env.LOCALGHOST_UPDATE_CHECK_CACHE;
+  const cacheRoot = env.XDG_CACHE_HOME || join6(homedir(), ".cache");
+  return join6(cacheRoot, "localghost", "update-check.json");
+}
+function readCache(path = getUpdateCheckCachePath()) {
+  if (!existsSync4(path)) return null;
+  try {
+    return JSON.parse(readFileSync4(path, "utf8"));
+  } catch {
+    return null;
+  }
+}
+function writeCache(cache, path = getUpdateCheckCachePath()) {
+  try {
+    mkdirSync2(dirname3(path), { recursive: true });
+    writeFileSync4(path, `${JSON.stringify(cache, null, 2)}
+`, "utf8");
+  } catch {
+  }
+}
+function ageMs(date, now = Date.now()) {
+  if (!date) return Number.POSITIVE_INFINITY;
+  const time = Date.parse(date);
+  return Number.isFinite(time) ? now - time : Number.POSITIVE_INFINITY;
+}
+function isCacheFresh(cache, ttlMs, now = Date.now()) {
+  return Boolean(cache?.latestVersion && ageMs(cache.checkedAt, now) >= 0 && ageMs(cache.checkedAt, now) < ttlMs);
+}
+function parseVersion(version) {
+  const match = version.trim().replace(/^v/, "").match(/^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/);
+  if (!match) return null;
+  return {
+    major: Number(match[1]),
+    minor: Number(match[2]),
+    patch: Number(match[3]),
+    ...match[4] ? { prerelease: match[4] } : {}
+  };
+}
+function compareVersions(a, b) {
+  const left = parseVersion(a);
+  const right = parseVersion(b);
+  if (!left || !right) return a.localeCompare(b);
+  for (const key of ["major", "minor", "patch"]) {
+    if (left[key] !== right[key]) return left[key] > right[key] ? 1 : -1;
+  }
+  if (left.prerelease === right.prerelease) return 0;
+  if (!left.prerelease) return 1;
+  if (!right.prerelease) return -1;
+  return left.prerelease.localeCompare(right.prerelease);
+}
+function isNewerVersion(candidate, current = LOCALGHOST_VERSION) {
+  return Boolean(candidate && compareVersions(candidate, current) > 0);
+}
+async function fetchLatestVersion(packageName, timeoutMs) {
+  const encodedName = packageName.startsWith("@") ? `@${packageName.slice(1).replace("/", "%2f")}` : packageName;
+  const response = await fetch(`https://registry.npmjs.org/${encodedName}`, {
+    signal: AbortSignal.timeout(timeoutMs),
+    headers: {
+      accept: "application/vnd.npm.install-v1+json"
+    }
+  });
+  if (!response.ok) throw new Error(`npm registry returned ${response.status}`);
+  const data = await response.json();
+  const latest = data["dist-tags"]?.latest;
+  if (typeof latest !== "string" || latest.length === 0) throw new Error("npm registry response did not include latest dist-tag");
+  return latest;
+}
+async function checkForUpdate(options = {}) {
+  const env = options.env ?? process.env;
+  const packageName = options.packageName ?? LOCALGHOST_PACKAGE_NAME;
+  const currentVersion = options.currentVersion ?? LOCALGHOST_VERSION;
+  const cachePath = options.cachePath ?? getUpdateCheckCachePath(env);
+  if (!options.force && isUpdateCheckDisabled(env)) {
+    return {
+      currentVersion,
+      packageName,
+      updateAvailable: false,
+      source: "disabled"
+    };
+  }
+  const cache = readCache(cachePath);
+  if (!options.force && isCacheFresh(cache, UPDATE_CHECK_CACHE_TTL_MS)) {
+    const latestVersion = cache?.latestVersion;
+    return {
+      currentVersion,
+      packageName,
+      ...latestVersion ? { latestVersion } : {},
+      updateAvailable: isNewerVersion(latestVersion, currentVersion),
+      source: "cache"
+    };
+  }
+  try {
+    const latestVersion = await fetchLatestVersion(packageName, options.timeoutMs ?? UPDATE_CHECK_TIMEOUT_MS);
+    writeCache({ checkedAt: (/* @__PURE__ */ new Date()).toISOString(), latestVersion }, cachePath);
+    return {
+      currentVersion,
+      packageName,
+      latestVersion,
+      updateAvailable: isNewerVersion(latestVersion, currentVersion),
+      source: "registry"
+    };
+  } catch (error) {
+    const latestVersion = cache?.latestVersion;
+    return {
+      currentVersion,
+      packageName,
+      ...latestVersion ? { latestVersion } : {},
+      updateAvailable: isNewerVersion(latestVersion, currentVersion),
+      source: "error",
+      error: error instanceof Error ? error.message : String(error)
+    };
+  }
+}
+function formatUpdateMessage(result) {
+  if (!result.updateAvailable || !result.latestVersion) return null;
+  return [
+    `localghost ${result.latestVersion} is available. Current: ${result.currentVersion}`,
+    `Update with: npm i -g ${result.packageName}@latest`
+  ].join("\n");
+}
+function shouldNotifyAboutUpdate(result, cachePath = getUpdateCheckCachePath(), now = Date.now()) {
+  if (!result.updateAvailable || !result.latestVersion) return false;
+  const cache = readCache(cachePath);
+  if (cache?.notifiedVersion !== result.latestVersion) return true;
+  return ageMs(cache.notifiedAt, now) >= UPDATE_CHECK_NOTIFY_TTL_MS;
+}
+function markUpdateNotified(result, cachePath = getUpdateCheckCachePath()) {
+  if (!result.latestVersion) return;
+  const cache = readCache(cachePath) ?? { checkedAt: (/* @__PURE__ */ new Date()).toISOString() };
+  writeCache(
+    {
+      ...cache,
+      latestVersion: result.latestVersion,
+      notifiedVersion: result.latestVersion,
+      notifiedAt: (/* @__PURE__ */ new Date()).toISOString()
+    },
+    cachePath
+  );
+}
+async function maybeNotifyAboutUpdate(options = {}) {
+  if (options.disabled) return;
+  const cachePath = getUpdateCheckCachePath();
+  const result = await checkForUpdate({ cachePath });
+  if (!shouldNotifyAboutUpdate(result, cachePath)) return;
+  const message = formatUpdateMessage(result);
+  if (!message) return;
+  console.warn(`
+${message}`);
+  markUpdateNotified(result, cachePath);
+}
+
+// src/cli.ts
+function warnAboutLocalMdns(entries) {
+  const localHosts = findLocalMdnsHosts(entries);
+  if (localHosts.length > 0) {
+    console.warn(
+      `Warning: .local can collide with mDNS/Bonjour. Prefer .localhost for dev hosts: ${localHosts.join(", ")}`
+    );
+  }
+}
+function logDomainRoutes(entries) {
+  console.log(formatDomainRoutes(entries));
+}
+function parsePort(value) {
+  const port = Number.parseInt(value, 10);
+  if (!Number.isInteger(port) || port < 1 || port > 65535) {
+    throw new InvalidArgumentError("Port must be a number between 1 and 65535.");
+  }
+  return port;
+}
+function parsePackageManager(value) {
+  if (value === "npm" || value === "yarn" || value === "pnpm") return value;
+  throw new InvalidArgumentError("Package manager must be npm, yarn, or pnpm.");
+}
+function collect(value, previous = []) {
+  return [...previous, value];
+}
+function readOptionsFromCli(options) {
+  return {
+    cwd: options.cwd,
+    ...options.config && options.config.length > 0 ? { configFiles: options.config } : {},
+    ...options.configPattern ? { configPattern: options.configPattern } : {}
+  };
+}
+async function assertCaddyReady() {
+  const caddy = await checkCaddy();
+  if (caddy.found) return;
+  throw new Error([
+    "Caddy was not found.",
+    `Install it with: ${caddy.installHint}`,
+    "Localghost will not install it for you. No surprise spells."
+  ].join("\n"));
+}
+var program = new Command();
+program.name("localghost").description("Buh. Friendly local hostnames for app repos.").version(LOCALGHOST_VERSION).option("--no-update-check", "Skip the npm update check for this run");
+program.hook("postAction", async (_thisCommand, actionCommand) => {
+  if (actionCommand.name() === "update") return;
+  const options = program.opts();
+  await maybeNotifyAboutUpdate({ disabled: options.updateCheck === false });
+});
+program.command("init").description("Create a .localghost config for this project").option("--cwd <path>", "Project directory", process.cwd()).option("--config <file>", "Config file to create", ".localghost").option("--host <host>", "Primary local hostname").option("--port <number>", "Primary app port", parsePort).option("--api-host <host>", "API local hostname").option("--api-port <number>", "API port", parsePort).option("--package-manager <npm|yarn|pnpm>", "Package manager for suggested commands", parsePackageManager).option("--write-scripts", "Add localghost scripts to package.json").option("--force", "Overwrite an existing config file").action((options) => {
+  const result = initLocalghost({ ...options, configFile: options.config });
+  if (result.configCreated) {
+    console.log(`Buh. Created ${result.configPath}`);
+  } else {
+    console.log(`${result.configPath} already exists. Use --force to rewrite it.`);
+  }
+  if (options.writeScripts) {
+    if (result.packageJsonChanged) {
+      console.log(`Updated ${result.packageJsonPath}`);
+    } else if (result.packageJsonPath) {
+      console.log(`${result.packageJsonPath} already has localghost scripts.`);
+    } else {
+      console.log("No package.json found; skipped script setup.");
+    }
+  }
+  console.log("Next:");
+  for (const step of result.nextSteps) {
+    console.log(`  ${step}`);
+  }
+});
+program.command("doctor").description("Check machine prerequisites").action(async () => {
+  const result = await runDoctor();
+  if (result.caddy.found) {
+    console.log(`Caddy: ${result.caddy.version ?? "found"}`);
+  } else {
+    console.log("Caddy: missing");
+    console.log(`Run: ${result.caddy.installHint}`);
+    console.log("Localghost will not install it for you. No surprise spells.");
+  }
+  if (!result.ok) {
+    process.exitCode = 1;
+  }
+});
+program.command("update").description("Check npm for a newer localghost release").option("--json", "Print raw JSON").action(async (options) => {
+  const result = await checkForUpdate({ force: true, timeoutMs: 5e3 });
+  if (options.json) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  const message = formatUpdateMessage(result);
+  if (message) {
+    console.log(message);
+    return;
+  }
+  if (result.source === "error") {
+    console.log(`Could not check npm for updates: ${result.error ?? "unknown error"}`);
+    process.exitCode = 1;
+    return;
+  }
+  console.log(`localghost is up to date. Current: ${result.currentVersion}`);
+});
+program.command("setup").description("Update /etc/hosts and generate/validate Caddyfile").option("--project <name>", "Managed /etc/hosts block name").option("--cwd <path>", "Project directory", process.cwd()).option("--config <file>", "Config file to look for. Can be repeated.", collect, []).option("--config-pattern <regex>", "Regex for config filenames in the project root").action(async (options) => {
+  await assertCaddyReady();
+  const projectName = sanitizeProjectName(options.project ?? getProjectName(options.cwd));
+  const readOptions = readOptionsFromCli(options);
+  const configPath = resolveDevHostsPath(readOptions).path;
+  const entries = readDevHosts(readOptions);
+  warnAboutLocalMdns(entries);
+  logDomainRoutes(entries);
+  const hostsResult = await updateSystemHosts(projectName, entries);
+  if (hostsResult.changed) {
+    console.log(`Updated ${hostsResult.hostsPath}`);
+  } else {
+    console.log(`${hostsResult.hostsPath} already up to date`);
+  }
+  const caddyfile = await writeCaddyfile(entries, options.cwd);
+  await validateCaddyfile(caddyfile);
+  const statePath = writeLocalghostState(options.cwd, {
+    action: "setup",
+    projectName,
+    cwd: options.cwd,
+    configPath,
+    hostsPath: hostsResult.hostsPath,
+    hostsChanged: hostsResult.changed,
+    ...hostsResult.tempPath ? { hostsTempPath: hostsResult.tempPath } : {},
+    caddyfilePath: caddyfile,
+    entries
+  });
+  console.log(`Generated ${caddyfile}`);
+  console.log(`State ${statePath}`);
+  console.log("Setup complete.");
+});
+program.command("teardown").description("Remove Localghost's managed /etc/hosts block").option("--project <name>", "Managed /etc/hosts block name").option("--cwd <path>", "Project directory", process.cwd()).option("--remove-caddyfile", "Also remove ops/local/Caddyfile").action(async (options) => {
+  const projectName = sanitizeProjectName(options.project ?? getProjectName(options.cwd));
+  const hostsResult = await removeSystemHosts(projectName);
+  const caddyfilePath = getCaddyfilePath(options.cwd);
+  let caddyfileRemoved = false;
+  if (options.removeCaddyfile && existsSync5(caddyfilePath)) {
+    unlinkSync(caddyfilePath);
+    caddyfileRemoved = true;
+  }
+  const statePath = writeLocalghostState(options.cwd, {
+    action: "teardown",
+    projectName,
+    cwd: options.cwd,
+    hostsPath: hostsResult.hostsPath,
+    hostsChanged: hostsResult.changed,
+    ...hostsResult.tempPath ? { hostsTempPath: hostsResult.tempPath } : {},
+    caddyfilePath,
+    caddyfileRemoved
+  });
+  if (hostsResult.removed) {
+    console.log(`Removed Localghost hosts block from ${hostsResult.hostsPath}`);
+  } else {
+    console.log(`No Localghost hosts block found in ${hostsResult.hostsPath}`);
+  }
+  if (options.removeCaddyfile) {
+    console.log(caddyfileRemoved ? `Removed ${caddyfilePath}` : `${caddyfilePath} was not present`);
+  }
+  console.log(`State ${statePath}`);
+});
+program.command("status").description("Print Localghost's project-local state file").option("--cwd <path>", "Project directory", process.cwd()).option("--json", "Print raw JSON").action((options) => {
+  const state = readLocalghostState(options.cwd);
+  const statePath = getLocalghostStatePath(options.cwd);
+  if (!state) {
+    console.log(`No Localghost state found at ${statePath}`);
+    return;
+  }
+  if (options.json) {
+    console.log(JSON.stringify(state, null, 2));
+    return;
+  }
+  console.log(`State: ${statePath}`);
+  console.log(`Last action: ${state.action}`);
+  console.log(`Updated: ${state.updatedAt}`);
+  console.log(`Project: ${state.projectName}`);
+  if (state.configPath) console.log(`Config: ${state.configPath}`);
+  if (state.hostsPath) console.log(`Hosts: ${state.hostsPath}`);
+  if (state.caddyfilePath) console.log(`Caddyfile: ${state.caddyfilePath}`);
+  if (typeof state.caddyfileRemoved === "boolean") console.log(`Caddyfile removed: ${state.caddyfileRemoved}`);
+});
+program.command("routes").description("Print domain to upstream routes").option("--cwd <path>", "Project directory", process.cwd()).option("--config <file>", "Config file to look for. Can be repeated.", collect, []).option("--config-pattern <regex>", "Regex for config filenames in the project root").option("--http", "Print domain URLs with http instead of https").action((options) => {
+  const entries = readDevHosts(readOptionsFromCli(options));
+  warnAboutLocalMdns(entries);
+  console.log(formatDomainRoutes(entries, { https: !options.http }));
+});
+program.command("dev").description("Generate Caddyfile and run Caddy").option("--cwd <path>", "Project directory", process.cwd()).option("--config <file>", "Config file to look for. Can be repeated.", collect, []).option("--config-pattern <regex>", "Regex for config filenames in the project root").action(async (options) => {
+  await assertCaddyReady();
+  const entries = readDevHosts(readOptionsFromCli(options));
+  warnAboutLocalMdns(entries);
+  logDomainRoutes(entries);
+  const caddyfile = await writeCaddyfile(entries, options.cwd);
+  await validateCaddyfile(caddyfile);
+  await runCaddy(caddyfile);
+});
+program.command("print").description("Print parsed host config").option("--cwd <path>", "Project directory", process.cwd()).option("--config <file>", "Config file to look for. Can be repeated.", collect, []).option("--config-pattern <regex>", "Regex for config filenames in the project root").action((options) => {
+  const entries = readDevHosts(readOptionsFromCli(options));
+  warnAboutLocalMdns(entries);
+  console.log(JSON.stringify(entries, null, 2));
+});
+program.parseAsync().catch((error) => {
+  const message = error instanceof Error ? error.message : String(error);
+  console.error(message);
+  process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map