@cliftonc/cfld 0.2.1 → 0.2.3

package/README.md

@@ -1,5 +1,7 @@
 # cfld
 
+**`cfld` = cloudflare local dev.**
+
 **One command to give your localhost a permanent public HTTPS URL — no API tokens, no teardown.**
 
 `cfld` wraps [`cloudflared`](https://github.com/cloudflare/cloudflared) into a frictionless dev experience: the **same** custom URL every run (not a random `trycloudflare.com` one), authorized with a **browser login** (zero API tokens), reusing the same named tunnel and DNS record across restarts instead of churning them. It runs a **live dashboard** (URL, connection count, request/latency counters, tailing logs), **auto-reconnects** on edge blips, and **guards** against stealing a DNS record that belongs to another tunnel.

package/dist/cli.js

@@ -637,13 +637,13 @@ async function startRunner(options) {
         );
         return;
       }
-      const delay = BACKOFF_MS[Math.min(rapidFailures, BACKOFF_MS.length - 1)];
+      const delay2 = BACKOFF_MS[Math.min(rapidFailures, BACKOFF_MS.length - 1)];
       options.onStatus?.("reconnecting");
       restartTimer = setTimeout(() => {
         if (stopped) return;
         options.onStatus?.("connecting");
         spawnOnce();
-      }, delay);
+      }, delay2);
       restartTimer.unref();
     });
   };
@@ -700,9 +700,22 @@ function startChild(options) {
   const exited = new Promise((resolve) => {
     markExited = resolve;
   });
+  const ownPgid = getpgid(process.pid);
+  const trackedPgids = /* @__PURE__ */ new Set();
+  const track = (g) => {
+    if (g > 1 && g !== process.pid && g !== ownPgid) trackedPgids.add(g);
+  };
+  if (child.pid !== void 0) track(child.pid);
+  const trackTree = () => {
+    if (child.pid === void 0) return;
+    for (const g of descendantPgids(child.pid)) track(g);
+  };
+  const poll = setInterval(trackTree, options.pollTreeMs ?? 1500);
+  poll.unref();
   wireLines2(child, "stdout", options.onLine);
   wireLines2(child, "stderr", options.onLine);
   child.on("error", (err) => {
+    clearInterval(poll);
     markExited();
     if (stopped) return;
     stopped = true;
@@ -710,93 +723,105 @@ function startChild(options) {
     options.onLine?.(String(err.message ?? err), "stderr");
   });
   child.on("exit", (code, signal) => {
+    clearInterval(poll);
     markExited();
     if (stopped) return;
     stopped = true;
     options.onExit?.(code, signal);
   });
+  const signalTree = (signal) => {
+    trackTree();
+    for (const g of trackedPgids) trySignalGroup(g, signal);
+  };
   return {
     exited,
     get pid() {
       return child.pid;
     },
+    treeAlive() {
+      if (trackedPgids.size === 0) return false;
+      const live = livePgids();
+      for (const g of trackedPgids) if (live.has(g)) return true;
+      return false;
+    },
     stop() {
-      if (stopped) return;
       stopped = true;
-      killGroup(child, "SIGINT");
-      const t = setTimeout(() => {
-        if (child.exitCode === null && !child.signalCode) killGroup(child, "SIGKILL");
-      }, 4e3);
-      t.unref();
+      signalTree("SIGINT");
     },
     kill() {
-      killGroup(child, "SIGKILL");
+      clearInterval(poll);
+      signalTree("SIGKILL");
     }
   };
 }
-function descendantPids(pid) {
+function descendantPgids(pid) {
   let out = "";
   try {
-    out = execSync("ps -A -o pid=,ppid=", { encoding: "utf8" });
+    out = execSync("ps -A -o pid=,ppid=,pgid=", { encoding: "utf8" });
   } catch {
     return [];
   }
   const childrenOf = /* @__PURE__ */ new Map();
+  const pgidOf = /* @__PURE__ */ new Map();
   for (const line of out.split("\n")) {
-    const m = line.trim().match(/^(\d+)\s+(\d+)$/);
+    const m = line.trim().match(/^(\d+)\s+(\d+)\s+(\d+)$/);
     if (!m) continue;
-    const child = Number(m[1]);
+    const proc = Number(m[1]);
     const parent = Number(m[2]);
+    pgidOf.set(proc, Number(m[3]));
     const list = childrenOf.get(parent);
-    if (list) list.push(child);
-    else childrenOf.set(parent, [child]);
+    if (list) list.push(proc);
+    else childrenOf.set(parent, [proc]);
   }
-  const found = [];
+  const pgids = /* @__PURE__ */ new Set();
+  const seen = /* @__PURE__ */ new Set();
   const stack = [pid];
   while (stack.length) {
     for (const child of childrenOf.get(stack.pop()) ?? []) {
-      if (!found.includes(child)) {
-        found.push(child);
-        stack.push(child);
-      }
+      if (seen.has(child)) continue;
+      seen.add(child);
+      stack.push(child);
+      const g = pgidOf.get(child);
+      if (g !== void 0) pgids.add(g);
     }
   }
-  return found;
+  return [...pgids];
 }
-function signalPids(pids, signal) {
-  for (const pid of pids) {
-    try {
-      process.kill(pid, signal);
-    } catch {
-    }
+function trySignalGroup(pgid, signal) {
+  try {
+    process.kill(-pgid, signal);
+  } catch {
   }
 }
-function reapChild(child, graceMs = 3e3) {
-  const tree = child.pid ? descendantPids(child.pid) : [];
-  child.stop();
-  signalPids(tree, "SIGINT");
-  return new Promise((resolve) => {
-    const done2 = () => {
-      clearTimeout(grace);
-      child.kill();
-      signalPids(tree, "SIGKILL");
-      resolve();
-    };
-    const grace = setTimeout(done2, graceMs);
-    grace.unref();
-    child.exited.then(done2);
-  });
-}
-function killGroup(child, signal) {
-  const pid = child.pid;
-  if (pid === void 0) return;
+function getpgid(pid) {
   try {
-    process.kill(-pid, signal);
+    const n = Number(execSync(`ps -o pgid= -p ${pid}`, { encoding: "utf8" }).trim());
+    return Number.isInteger(n) ? n : void 0;
   } catch {
-    try {
-      child.kill(signal);
-    } catch {
+    return void 0;
+  }
+}
+function livePgids() {
+  const live = /* @__PURE__ */ new Set();
+  try {
+    for (const line of execSync("ps -A -o pgid=", { encoding: "utf8" }).split("\n")) {
+      const n = Number(line.trim());
+      if (Number.isInteger(n) && n > 0) live.add(n);
     }
+  } catch {
+  }
+  return live;
+}
+var delay = (ms) => new Promise((r) => setTimeout(r, ms));
+async function reapChild(child, graceMs = 3e3) {
+  child.stop();
+  await Promise.race([child.exited, delay(Math.min(graceMs, 1200))]);
+  const deadline = Date.now() + graceMs + 5e3;
+  for (; ; ) {
+    child.kill();
+    if (!child.treeAlive()) return;
+    if (Date.now() >= deadline) return;
+    await delay(200);
   }
 }
 function wireLines2(child, stream, onLine) {
@@ -1170,6 +1195,7 @@ async function runCommand(flags) {
     cwd,
     envKey,
     noEnv: flags.noEnv,
+    noUi: flags.noUi,
     port: primary.port,
     exec: flags.exec
   });
@@ -1178,7 +1204,7 @@ async function launch(result, ctx) {
   const metricsPort = await findFreePort();
   const url = `https://${result.hostname}`;
   const target = `localhost:${ctx.port}`;
-  const interactive = isInteractive();
+  const interactive = isInteractive() && !ctx.noUi;
   let dashboard;
   if (interactive) {
     const { startDashboard } = await import("./dashboard-Q6WI32AK.js");
@@ -1221,9 +1247,9 @@ async function launch(result, ctx) {
     dashboard?.stop();
     if (opts.reason) note(`
 ${opts.reason}`);
-    const exit = () => setTimeout(() => process.exit(opts.code ?? 0), 100).unref();
-    if (child) reapChild(child).then(exit);
-    else exit();
+    const finish = () => process.exit(opts.code ?? 0);
+    if (child) reapChild(child).then(finish, finish);
+    else finish();
   };
   runner = await startRunner({
     configPath: result.configPath,
@@ -1257,16 +1283,15 @@ ${opts.reason}`);
       }
     });
   }
-  if (!dashboard) {
-    process.once(
-      "SIGINT",
-      () => shutdown({ reason: "Stopping \u2014 your URL is preserved. Re-run `cfld`." })
-    );
-    process.once(
-      "SIGTERM",
-      () => shutdown({ reason: "Stopping \u2014 your URL is preserved." })
-    );
-  }
+  process.once(
+    "SIGINT",
+    () => shutdown({ reason: "Stopping \u2014 your URL is preserved. Re-run `cfld`." })
+  );
+  process.once(
+    "SIGTERM",
+    () => shutdown({ reason: "Stopping \u2014 your URL is preserved." })
+  );
+  process.once("SIGHUP", () => shutdown({ reason: "Terminal closed \u2014 stopping." }));
   const ready = await waitForReady(metricsPort).catch((err) => {
     child?.stop();
     runner?.stop();
@@ -1404,7 +1429,7 @@ async function startQuickTunnel(port, opts = {}) {
 async function quickCommand(flags) {
   const port = await resolvePort2(flags);
   const target = `localhost:${port}`;
-  const interactive = isInteractive();
+  const interactive = isInteractive() && !flags.noUi;
   const metricsPort = await findFreePort();
   const envKey = flags.envKey ?? "PUBLIC_URL";
   if (!interactive) step(`Starting an ephemeral tunnel to ${target}\u2026`);
@@ -1437,9 +1462,9 @@ async function quickCommand(flags) {
     dashboard?.stop();
     note(`
 ${opts.reason ?? "Stopped ephemeral tunnel."}`);
-    const exit = () => setTimeout(() => process.exit(opts.code ?? 0), 100).unref();
-    if (child) reapChild(child).then(exit);
-    else exit();
+    const finish = () => process.exit(opts.code ?? 0);
+    if (child) reapChild(child).then(finish, finish);
+    else finish();
   };
   tunnel = await startQuickTunnel(port, { metricsPort, onLine: emitLine });
   const url = tunnel.url;
@@ -1477,10 +1502,9 @@ ${opts.reason ?? "Stopped ephemeral tunnel."}`);
       ephemeral: true
     });
   }
-  if (!dashboard) {
-    process.once("SIGINT", () => shutdown());
-    process.once("SIGTERM", () => shutdown());
-  }
+  process.once("SIGINT", () => shutdown());
+  process.once("SIGTERM", () => shutdown());
+  process.once("SIGHUP", () => shutdown());
   if (child) {
     if (!dashboard) step(`Waiting for your dev server on :${port}\u2026`);
     const up = await waitForPort(port, { signal: childAbort.signal });
@@ -2230,6 +2254,7 @@ ${pc7.bold("Options")}
   --zone <domain>   Cloudflare domain to use (e.g. example.com)
   --env <KEY>       .env key to write the URL to (default: PUBLIC_URL)
   --no-env          Don't write the URL to .env
+  --no-ui           Plain line-by-line output instead of the live dashboard
   --exec <cmd>      Dev command to run + supervise (shell form of \`-- <cmd>\`)
   --force           Skip confirmation (destroy)
   -h, --help        Show this help
@@ -2250,6 +2275,7 @@ async function main(rawArgv) {
       zone: { type: "string" },
       env: { type: "string" },
       "no-env": { type: "boolean" },
+      "no-ui": { type: "boolean" },
       exec: { type: "string" },
       quick: { type: "boolean" },
       force: { type: "boolean" },
@@ -2273,6 +2299,7 @@ async function main(rawArgv) {
     zone: values.zone,
     envKey: values.env,
     noEnv: values["no-env"],
+    noUi: values["no-ui"],
     quick: values.quick,
     force: values.force,
     reauth: values.reauth,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cliftonc/cfld",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Zero-token, persistent Cloudflare tunnel CLI for local dev — same public HTTPS URL every run.",
   "type": "module",
   "bin": {