webtty 1.1.0 → 1.2.0

package/README.md

@@ -1,3 +1,22 @@
+<img src="assets/social-preview.png" width="600">
+
 # webtty
 
-A web TTY for running CLI/TUI applications in a browser tab, across platforms.
+Terminal UI in the browser. Run CLI/TUI applications in a browser tab, across platforms.
+
+```sh
+npx webtty run        # start server + open a terminal in the browser
+npx webtty ls         # list sessions
+npx webtty help       # show all commands
+```
+
+## Debugging
+
+Build emits source maps (`dist/**/*.js.map`), so you can debug against the built output directly — no minification, original TypeScript line numbers preserved.
+
+```
+bun run build
+bun --inspect run dist/server/index.js
+# or
+node --inspect dist/server/index.js
+```

package/dist/cli/index.js

@@ -2157,7 +2157,7 @@ var {
 } = import__.default;
 
 // src/cli/http.ts
-import { spawn } from "node:child_process";
+import * as childProcess from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
@@ -2173,20 +2173,21 @@ async function isServerRunning() {
     return false;
   }
 }
-async function startServer() {
-  const isTs = __filename2.endsWith(".ts");
+async function startServer(timeoutMs = 1e4, _spawn = childProcess.spawn) {
+  const isBun = typeof globalThis.Bun !== "undefined";
+  const isTs = isBun && __filename2.endsWith(".ts");
   const serverEntry = path.resolve(__dirname2, isTs ? "../server/index.ts" : "../server/index.js");
   if (!fs.existsSync(serverEntry)) {
     console.error(`webtty: server entry not found at ${serverEntry}`);
     process.exit(1);
   }
-  const child = spawn(process.execPath, [serverEntry], {
+  const child = _spawn(process.execPath, [serverEntry], {
     detached: true,
     stdio: "ignore",
     env: { ...process.env, PORT: String(PORT) }
   });
   child.unref();
-  const deadline = Date.now() + 1e4;
+  const deadline = Date.now() + timeoutMs;
   while (Date.now() < deadline) {
     if (await isServerRunning())
       return;
@@ -2195,14 +2196,32 @@ async function startServer() {
   console.error("webtty: server did not start in time");
   process.exit(1);
 }
-function openBrowser(url) {
+async function stopServer(baseUrl = BASE_URL, timeoutMs = 5000) {
+  try {
+    const res = await fetch(`${baseUrl}/api/server/stop`, { method: "POST" });
+    if (!res.ok)
+      return false;
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+      if (!await isServerRunning())
+        return true;
+      await new Promise((r) => setTimeout(r, 100));
+    }
+    return false;
+  } catch {
+    return false;
+  }
+}
+function openBrowser(url, _spawn = childProcess.spawn) {
   if (process.env.WEBTTY_NO_OPEN === "1")
     return;
+  if (false)
+    ;
   if (process.platform === "win32") {
-    spawn("cmd.exe", ["/c", "start", "", url], { detached: true, stdio: "ignore" }).unref();
+    _spawn("cmd.exe", ["/c", "start", "", url], { detached: true, stdio: "ignore" }).unref();
   } else {
     const cmd = process.platform === "darwin" ? "open" : "xdg-open";
-    spawn(cmd, [url], { detached: true, stdio: "ignore" }).unref();
+    _spawn(cmd, [url], { detached: true, stdio: "ignore" }).unref();
   }
 }
 
@@ -2217,16 +2236,16 @@ function registerCommands(program2) {
     console.log("webtty started");
   });
   program2.command("stop").description("Stop the webtty server").action(async () => {
-    try {
-      const res = await fetch(`${BASE_URL}/api/server/stop`, { method: "POST" });
-      if (res.ok) {
-        console.log("webtty stopped");
-      } else {
-        console.error(`webtty stop failed (status: ${res.status})`);
-        process.exit(1);
-      }
-    } catch {
+    if (!await isServerRunning()) {
       console.log("webtty is not running");
+      return;
+    }
+    const ok = await stopServer();
+    if (ok) {
+      console.log("webtty stopped");
+    } else {
+      console.error("webtty stop failed");
+      process.exit(1);
     }
   });
   program2.command("ls").description("List all sessions").action(async () => {
@@ -2332,6 +2351,17 @@ function registerCommands(program2) {
       process.exit(1);
     }
   });
+  program2.command("restart").description("Restart the webtty server").action(async () => {
+    if (await isServerRunning()) {
+      const ok = await stopServer();
+      if (!ok) {
+        console.error("webtty: failed to stop server");
+        process.exit(1);
+      }
+    }
+    await startServer();
+    console.log("webtty restarted");
+  });
 }
 
 // src/cli/index.ts
@@ -2340,4 +2370,4 @@ program2.name("webtty").description("Web TTY — run terminal sessions in a brow
 registerCommands(program2);
 program2.parse(process.argv);
 
-//# debugId=C181BFB3597D22B864756E2164756E21
+//# debugId=1DEC1C353196B21C64756E2164756E21