termbeam 1.13.6 → 1.14.1

package/bin/termbeam.js

@@ -16,7 +16,8 @@ if (subcommand === 'service') {
   });
 } else if (subcommand === 'list') {
   const { list } = require('../src/cli/resume');
-  list().catch((err) => {
+  const listArgs = process.argv.slice(3);
+  list({ json: listArgs.includes('--json') }).catch((err) => {
     console.error(err.message);
     process.exit(1);
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "termbeam",
-  "version": "1.13.6",
+  "version": "1.14.1",
   "description": "Beam your terminal to any device — mobile-optimized web terminal with multi-session support",
   "main": "src/server/index.js",
   "bin": {

package/src/cli/index.js

@@ -11,7 +11,7 @@ termbeam — Beam your terminal to any device
 Usage:
   termbeam [options] [shell] [args...]
   termbeam resume [name] [options]     Reconnect to a running session (alias: attach)
-  termbeam list                        List running sessions
+  termbeam list [--json]                List running sessions
   termbeam service <action>            Manage as a background service (PM2)
 
 Actions (service):

package/src/cli/resume.js

@@ -315,8 +315,8 @@ async function resume(args) {
   }
 }
 
-async function list() {
-  log.info('Listing sessions');
+async function list(options = {}) {
+  if (!options.json) log.info('Listing sessions');
   const saved = readConnectionConfig();
   const host = (saved && saved.host) || 'localhost';
   const port = (saved && saved.port) || 3456;
@@ -345,6 +345,10 @@ async function list() {
         process.exit(1);
       }
     } else if (err.code === 'ECONNREFUSED') {
+      if (options.json) {
+        console.log('[]');
+        return;
+      }
       console.log(dim('  No TermBeam server is running.'));
       return;
     } else {
@@ -353,6 +357,11 @@ async function list() {
     }
   }
 
+  if (options.json) {
+    console.log(JSON.stringify(sessions));
+    return;
+  }
+
   if (sessions.length === 0) {
     console.log(dim(`  Connected to server on ${displayUrl} — no active sessions.`));
     return;
@@ -381,6 +390,8 @@ async function list() {
     );
   }
   console.log('');
+  console.log(dim('  Tip: use --json for machine-readable output'));
+  console.log('');
 }
 
 module.exports = {

package/src/server/sessions.js

@@ -1,8 +1,27 @@
 const crypto = require('crypto');
 const path = require('path');
 const { exec } = require('child_process');
-const pty = require('node-pty');
 const log = require('../utils/logger');
+
+let pty;
+try {
+  pty = require('node-pty');
+} catch (err) {
+  const isLinux = process.platform === 'linux';
+  console.error('\n  ❌ Failed to load node-pty — terminal sessions require this native module.\n');
+  console.error(`  Error: ${err.message.split('\n')[0]}\n`);
+  if (isLinux) {
+    console.error('  On Linux (including WSL/devbox), you need build tools to compile node-pty:');
+    console.error('    Ubuntu/Debian:  sudo apt-get install -y build-essential python3');
+    console.error('    Fedora/RHEL:    sudo dnf groupinstall "Development Tools"');
+    console.error('    Alpine:         apk add build-base python3\n');
+    console.error('  Then rebuild:     npm rebuild node-pty');
+    console.error('                    (or reinstall: npm i -g termbeam)\n');
+  } else {
+    console.error('  Try rebuilding:   npm rebuild node-pty\n');
+  }
+  process.exit(1);
+}
 const { getGitInfo } = require('../utils/git');
 
 // Cache git info per session to avoid blocking the event loop on every list() call.

package/src/tunnel/index.js

@@ -14,6 +14,59 @@ let devtunnelCmd = 'devtunnel';
 
 const SAFE_ID_RE = /^[a-zA-Z0-9._-]+$/;
 
+const DEVICE_CODE_INITIAL_TIMEOUT = 15000;
+const DEVICE_CODE_AUTH_TIMEOUT = 120000;
+
+function deviceCodeLogin(cmd) {
+  return new Promise((resolve, reject) => {
+    const proc = spawn(cmd, ['user', 'login', '-d'], {
+      stdio: ['inherit', 'pipe', 'pipe'],
+    });
+
+    let gotOutput = false;
+
+    const initialTimer = setTimeout(() => {
+      if (!gotOutput) {
+        proc.kill();
+        reject(
+          new Error(
+            'Device code flow produced no output — devtunnel may not work in this environment.\n' +
+              '  Try logging in manually first: devtunnel user login',
+          ),
+        );
+      }
+    }, DEVICE_CODE_INITIAL_TIMEOUT);
+
+    const overallTimer = setTimeout(() => {
+      proc.kill();
+      reject(new Error('Device code login timed out — authentication was not completed in time.'));
+    }, DEVICE_CODE_AUTH_TIMEOUT);
+
+    proc.stdout.on('data', (data) => {
+      gotOutput = true;
+      process.stdout.write(data);
+    });
+
+    proc.stderr.on('data', (data) => {
+      gotOutput = true;
+      process.stderr.write(data);
+    });
+
+    proc.on('close', (code) => {
+      clearTimeout(initialTimer);
+      clearTimeout(overallTimer);
+      if (code === 0) resolve();
+      else reject(new Error(`Device code login exited with code ${code}`));
+    });
+
+    proc.on('error', (err) => {
+      clearTimeout(initialTimer);
+      clearTimeout(overallTimer);
+      reject(err);
+    });
+  });
+}
+
 function findDevtunnel() {
   // Try devtunnel directly
   try {
@@ -123,7 +176,7 @@ async function startTunnel(port, options = {}) {
         log.info('Browser login failed or unavailable, falling back to device code flow...');
         log.info('A code will be displayed — open the URL on any device to authenticate.');
         try {
-          execFileSync(devtunnelCmd, ['user', 'login', '-d'], { stdio: 'inherit' });
+          await deviceCodeLogin(devtunnelCmd);
         } catch (_loginErr) {
           log.error('');
           log.error('  DevTunnel login failed. To use tunnels, run:');