peer-term 1.3.9 → 1.4.0

package/src/prompts.js

@@ -0,0 +1,143 @@
+/**
+ * PeerTerm — Interactive Prompts
+ *
+ * Terminal prompts for session expiry and rejoin window configuration.
+ * Handles three modes: CLI flag, interactive TTY prompt, silent default.
+ */
+
+import readline from 'readline';
+import { parseDuration } from './utils.js';
+import { argv, expiryFlagPassed, rejoinFlagPassed } from './config.js';
+import logger from './logger.js';
+
+// ─── Generic Duration Prompt ─────────────────────────────────────────────────
+
+/**
+ * Prompt the user for a duration value in the terminal.
+ * Re-prompts on invalid input until a valid value is entered or Enter is pressed for default.
+ *
+ * @param {Object} opts
+ * @param {string} opts.label       - Main prompt question
+ * @param {string} opts.description - Additional context shown below the question
+ * @param {number} opts.defaultMs   - Default value in milliseconds
+ * @param {string} opts.defaultLabel - Human-readable default (e.g. "5 minutes")
+ * @param {number} opts.minMs       - Minimum allowed value in milliseconds
+ * @param {number} opts.maxMs       - Maximum allowed value in milliseconds
+ * @param {string} opts.minLabel    - Human-readable minimum (e.g. "2m")
+ * @param {string} opts.maxLabel    - Human-readable maximum (e.g. "24h")
+ * @returns {Promise<number>} Resolved duration in milliseconds
+ */
+function promptDuration({ label, description, defaultMs, defaultLabel, minMs, maxMs, minLabel, maxLabel }) {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+
+    const ask = () => {
+      console.log('');
+      console.log(`  ${label}`);
+      if (description) console.log(`  ${description}`);
+      console.log(`  Enter a value between ${minLabel} and ${maxLabel} (e.g. ${minLabel}, 30m, 2h)`);
+      console.log(`  Default is ${defaultLabel}. Press Enter to use default.`);
+      rl.question('  > ', (answer) => {
+        const input = answer.trim();
+
+        // Empty input — use default
+        if (!input) {
+          rl.close();
+          resolve(defaultMs);
+          return;
+        }
+
+        const parsed = parseDuration(input);
+        if (!parsed || parsed < minMs || parsed > maxMs) {
+          console.log(`  Invalid value. Please enter a time between ${minLabel} and ${maxLabel} (e.g. 5m, 1h).`);
+          ask();
+          return;
+        }
+
+        rl.close();
+        resolve(parsed);
+      });
+    };
+
+    ask();
+  });
+}
+
+// ─── Expiry ──────────────────────────────────────────────────────────────────
+
+/**
+ * Get the session code expiry — from flag, interactive prompt, or silent default.
+ *
+ * @returns {Promise<number>} Expiry in milliseconds
+ */
+export async function getExpiryInteractive() {
+  const DEFAULT_EXPIRY = 5 * 60 * 1000;       // 5 minutes
+  const MIN_EXPIRY     = 2 * 60 * 1000;       // 2 minutes
+  const MAX_EXPIRY     = 24 * 60 * 60 * 1000; // 24 hours
+
+  // If --expiry flag was explicitly passed, use it (validate and exit on error)
+  if (expiryFlagPassed) {
+    const parsed = parseDuration(argv.expiry);
+    if (!parsed || parsed < MIN_EXPIRY || parsed > MAX_EXPIRY) {
+      logger.error(`Invalid expiry: "${argv.expiry}". Must be between 2m and 24h.`);
+      process.exit(1);
+    }
+    return parsed;
+  }
+
+  // Non-interactive — use default silently
+  if (!process.stdin.isTTY) return DEFAULT_EXPIRY;
+
+  // Interactive prompt
+  return promptDuration({
+    label: 'How long should the session code be valid?',
+    description: null,
+    defaultMs: DEFAULT_EXPIRY,
+    defaultLabel: '5 minutes',
+    minMs: MIN_EXPIRY,
+    maxMs: MAX_EXPIRY,
+    minLabel: '2m',
+    maxLabel: '24h',
+  });
+}
+
+// ─── Rejoin Window ───────────────────────────────────────────────────────────
+
+/**
+ * Get the reconnection window — from flag, interactive prompt, or silent default.
+ *
+ * @returns {Promise<number>} Rejoin window in milliseconds
+ */
+export async function getRejoinInteractive() {
+  const DEFAULT_REJOIN = 5 * 60 * 1000;       // 5 minutes
+  const MIN_REJOIN     = 5 * 60 * 1000;       // 5 minutes
+  const MAX_REJOIN     = 6 * 60 * 60 * 1000;  // 6 hours
+
+  // If --rejoin flag was explicitly passed, use it
+  if (rejoinFlagPassed) {
+    const parsed = parseDuration(argv.rejoin);
+    if (!parsed || parsed < MIN_REJOIN || parsed > MAX_REJOIN) {
+      logger.error(`Invalid rejoin window: "${argv.rejoin}". Must be between 5m and 6h.`);
+      process.exit(1);
+    }
+    return parsed;
+  }
+
+  // Non-interactive — use default silently
+  if (!process.stdin.isTTY) return DEFAULT_REJOIN;
+
+  // Interactive prompt
+  return promptDuration({
+    label: 'How long should the reconnection window be?',
+    description: 'This is how long a disconnected client or host has to rejoin before the session ends.',
+    defaultMs: DEFAULT_REJOIN,
+    defaultLabel: '2 minutes',
+    minMs: MIN_REJOIN,
+    maxMs: MAX_REJOIN,
+    minLabel: '5m',
+    maxLabel: '6h',
+  });
+}

package/src/ui.js

@@ -1,142 +1,142 @@
-/**
- * PeerTerm — CLI UI Module
- *
- * Handles all terminal output formatting:
- * - ASCII art banner
- * - Session code display box
- * - Help text
- * - Version display
- */
-
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-// ─── ASCII Banner ────────────────────────────────────────────────────────────
-
-const BANNER = `
-  ██████╗ ███████╗███████╗██████╗ ████████╗███████╗██████╗ ███╗   ███╗
-  ██╔══██╗██╔════╝██╔════╝██╔══██╗╚══██╔══╝██╔════╝██╔══██╗████╗ ████║
-  ██████╔╝█████╗  █████╗  ██████╔╝   ██║   █████╗  ██████╔╝██╔████╔██║
-  ██╔═══╝ ██╔══╝  ██╔══╝  ██╔══██╗   ██║   ██╔══╝  ██╔══██╗██║╚██╔╝██║
-  ██║     ███████╗███████╗██║  ██║   ██║   ███████╗██║  ██║██║ ╚═╝ ██║
-  ╚═╝     ╚══════╝╚══════╝╚═╝  ╚═╝   ╚═╝   ╚══════╝╚═╝  ╚═╝╚═╝     ╚═╝
-                      Terminal sharing. Instant. Encrypted.`;
-
-/**
- * Print the startup ASCII art banner.
- */
-export function printBanner() {
-  console.log(BANNER);
-  console.log('');
-}
-
-// ─── Session Code Box ────────────────────────────────────────────────────────
-
-/**
- * Print the bordered session information box.
- *
- * @param {Object} opts
- * @param {string} opts.code     - 6-digit session code
- * @param {string} opts.expiry   - Formatted expiry string (e.g. "5 minute(s)")
- * @param {string} opts.mode     - "Read-Write" or "Read-Only"
- * @param {string} opts.shell    - Shell path (e.g. "/bin/zsh")
- * @param {string} [opts.startPath] - Starting directory for the session
- * @param {string} [opts.shareUrl] - URL to share (e.g. "https://peerterm.dev")
- */
-export function printSessionBox({ code, expiry, rejoinWindow, mode, shell, startPath, shareUrl }) {
-  const spacedCode = code.split('').join(' ');
-  const url = shareUrl || 'https://peerterm.dev';
-
-  // Truncate long shell paths to keep box readable
-  const shellDisplay = shell.length > 24 ? '...' + shell.slice(-21) : shell;
-
-  // Truncate long start paths similarly
-  const homeDir = process.env.HOME || process.env.USERPROFILE || '';
-  let pathDisplay = startPath || homeDir;
-  if (homeDir && pathDisplay.startsWith(homeDir)) {
-    pathDisplay = '~' + pathDisplay.slice(homeDir.length);
-  }
-  if (pathDisplay.length > 30) pathDisplay = '...' + pathDisplay.slice(-27);
-
-  // Calculate dynamic box width based on longest content
-  const infoLines = [
-    `   Session Code:  ${spacedCode}`,
-    `   Expires in:    ${expiry}`,
-    `   Rejoin Window: ${rejoinWindow}`,
-    `   Mode:          ${mode}`,
-    `   Shell:         ${shellDisplay}`,
-    `   Path:          ${pathDisplay}`,
-  ];
-  const shareLine = `   Share at: ${url}`;
-  const allLines = [...infoLines, shareLine];
-  const maxLen = Math.max(...allLines.map(l => l.length), 35);
-  const innerWidth = maxLen + 3; // padding on right
-
-  const hr = '─'.repeat(innerWidth);
-  const emptyLine = ' '.repeat(innerWidth);
-
-  console.log('');
-  console.log(`  ┌${hr}┐`);
-  console.log(`  │${emptyLine}│`);
-  for (const line of infoLines) {
-    console.log(`  │${line.padEnd(innerWidth)}│`);
-  }
-  console.log(`  │${emptyLine}│`);
-  console.log(`  │${shareLine.padEnd(innerWidth)}│`);
-  console.log(`  │${emptyLine}│`);
-  console.log(`  └${hr}┘`);
-  console.log('');
-}
-
-// ─── Help Text ───────────────────────────────────────────────────────────────
-
-const HELP_TEXT = `
-Usage: peer-term [options]
-
-Options:
-  --expiry <time>     Session expiry time (e.g. 5m, 30s, 1h)  [default: 5m]
-  --rejoin <time>     Reconnection window (e.g. 5m, 1h, 6h)   [default: 2m]
-  --readonly          Share in view-only mode
-  --secure            Enable fingerprint verification for MITM protection
-  --path <dir>        Starting directory for the terminal session  [default: home]
-  --relay <url>       Custom relay server URL
-  --verbose           Enable debug logging
-  --help              Show this help message
-  --version           Print version number
-
-Examples:
-  peer-term                        Start session with defaults
-  peer-term --expiry 10m           Custom expiry
-  peer-term --rejoin 30m           Custom reconnection window
-  peer-term --readonly             View-only session
-  peer-term --secure               Require fingerprint verification
-  peer-term --path ~/projects      Start in ~/projects
-  peer-term --verbose              Debug logs
-  peer-term --relay wss://custom   Use custom relay server
-`;
-
-/**
- * Print CLI help text.
- */
-export function printHelp() {
-  console.log(HELP_TEXT);
-}
-
-// ─── Version ─────────────────────────────────────────────────────────────────
-
-/**
- * Print the version number from package.json.
- */
-export function printVersion() {
-  try {
-    const pkgPath = path.join(__dirname, '..', 'package.json');
-    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
-    console.log(`peer-term v${pkg.version}`);
-  } catch {
-    console.log('peer-term (version unknown)');
-  }
-}
+/**
+ * PeerTerm — CLI UI Module
+ *
+ * Handles all terminal output formatting:
+ * - ASCII art banner
+ * - Session code display box
+ * - Help text
+ * - Version display
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// ─── ASCII Banner ────────────────────────────────────────────────────────────
+
+const BANNER = `
+  ██████╗ ███████╗███████╗██████╗ ████████╗███████╗██████╗ ███╗   ███╗
+  ██╔══██╗██╔════╝██╔════╝██╔══██╗╚══██╔══╝██╔════╝██╔══██╗████╗ ████║
+  ██████╔╝█████╗  █████╗  ██████╔╝   ██║   █████╗  ██████╔╝██╔████╔██║
+  ██╔═══╝ ██╔══╝  ██╔══╝  ██╔══██╗   ██║   ██╔══╝  ██╔══██╗██║╚██╔╝██║
+  ██║     ███████╗███████╗██║  ██║   ██║   ███████╗██║  ██║██║ ╚═╝ ██║
+  ╚═╝     ╚══════╝╚══════╝╚═╝  ╚═╝   ╚═╝   ╚══════╝╚═╝  ╚═╝╚═╝     ╚═╝
+                      Terminal sharing. Instant. Encrypted.`;
+
+/**
+ * Print the startup ASCII art banner.
+ */
+export function printBanner() {
+  console.log(BANNER);
+  console.log('');
+}
+
+// ─── Session Code Box ────────────────────────────────────────────────────────
+
+/**
+ * Print the bordered session information box.
+ *
+ * @param {Object} opts
+ * @param {string} opts.code     - 6-digit session code
+ * @param {string} opts.expiry   - Formatted expiry string (e.g. "5 minute(s)")
+ * @param {string} opts.mode     - "Read-Write" or "Read-Only"
+ * @param {string} opts.shell    - Shell path (e.g. "/bin/zsh")
+ * @param {string} [opts.startPath] - Starting directory for the session
+ * @param {string} [opts.shareUrl] - URL to share (e.g. "https://peerterm.dev")
+ */
+export function printSessionBox({ code, expiry, rejoinWindow, mode, shell, startPath, shareUrl }) {
+  const spacedCode = code.split('').join(' ');
+  const url = shareUrl || 'https://peerterm.dev';
+
+  // Truncate long shell paths to keep box readable
+  const shellDisplay = shell.length > 24 ? '...' + shell.slice(-21) : shell;
+
+  // Truncate long start paths similarly
+  const homeDir = process.env.HOME || process.env.USERPROFILE || '';
+  let pathDisplay = startPath || homeDir;
+  if (homeDir && pathDisplay.startsWith(homeDir)) {
+    pathDisplay = '~' + pathDisplay.slice(homeDir.length);
+  }
+  if (pathDisplay.length > 30) pathDisplay = '...' + pathDisplay.slice(-27);
+
+  // Calculate dynamic box width based on longest content
+  const infoLines = [
+    `   Session Code:  ${spacedCode}`,
+    `   Expires in:    ${expiry}`,
+    `   Rejoin Window: ${rejoinWindow}`,
+    `   Mode:          ${mode}`,
+    `   Shell:         ${shellDisplay}`,
+    `   Path:          ${pathDisplay}`,
+  ];
+  const shareLine = `   Share at: ${url}`;
+  const allLines = [...infoLines, shareLine];
+  const maxLen = Math.max(...allLines.map(l => l.length), 35);
+  const innerWidth = maxLen + 3; // padding on right
+
+  const hr = '─'.repeat(innerWidth);
+  const emptyLine = ' '.repeat(innerWidth);
+
+  console.log('');
+  console.log(`  ┌${hr}┐`);
+  console.log(`  │${emptyLine}│`);
+  for (const line of infoLines) {
+    console.log(`  │${line.padEnd(innerWidth)}│`);
+  }
+  console.log(`  │${emptyLine}│`);
+  console.log(`  │${shareLine.padEnd(innerWidth)}│`);
+  console.log(`  │${emptyLine}│`);
+  console.log(`  └${hr}┘`);
+  console.log('');
+}
+
+// ─── Help Text ───────────────────────────────────────────────────────────────
+
+const HELP_TEXT = `
+Usage: peer-term [options]
+
+Options:
+  --expiry <time>     Session expiry time (e.g. 5m, 30s, 1h)  [default: 5m]
+  --rejoin <time>     Reconnection window (e.g. 5m, 1h, 6h)   [default: 2m]
+  --readonly          Share in view-only mode
+  --secure            Enable fingerprint verification for MITM protection
+  --path <dir>        Starting directory for the terminal session  [default: home]
+  --relay <url>       Custom relay server URL
+  --verbose           Enable debug logging
+  --help              Show this help message
+  --version           Print version number
+
+Examples:
+  peer-term                        Start session with defaults
+  peer-term --expiry 10m           Custom expiry
+  peer-term --rejoin 30m           Custom reconnection window
+  peer-term --readonly             View-only session
+  peer-term --secure               Require fingerprint verification
+  peer-term --path ~/projects      Start in ~/projects
+  peer-term --verbose              Debug logs
+  peer-term --relay wss://custom   Use custom relay server
+`;
+
+/**
+ * Print CLI help text.
+ */
+export function printHelp() {
+  console.log(HELP_TEXT);
+}
+
+// ─── Version ─────────────────────────────────────────────────────────────────
+
+/**
+ * Print the version number from package.json.
+ */
+export function printVersion() {
+  try {
+    const pkgPath = path.join(__dirname, '..', 'package.json');
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+    console.log(`peer-term v${pkg.version}`);
+  } catch {
+    console.log('peer-term (version unknown)');
+  }
+}

package/src/utils.js

@@ -0,0 +1,113 @@
+/**
+ * PeerTerm — Utility Functions
+ *
+ * Generic helpers with no domain dependencies:
+ * - Duration parsing and formatting
+ * - Path resolution (tilde expansion, start path validation)
+ * - Shell detection
+ */
+
+import os from 'os';
+import fs from 'fs';
+import path from 'path';
+import logger from './logger.js';
+
+// ─── Duration Parsing ────────────────────────────────────────────────────────
+
+/**
+ * Parse a human-readable duration string into milliseconds.
+ * Accepted formats: "30s", "5m", "1h" (case-insensitive).
+ *
+ * @param {string} str - Duration string
+ * @returns {number|null} Duration in milliseconds, or null if invalid
+ */
+export function parseDuration(str) {
+  const match = str.match(/^(\d+)(s|m|h)$/i);
+  if (!match) return null;
+  const value = parseInt(match[1], 10);
+  const unit = match[2].toLowerCase();
+  switch (unit) {
+    case 's': return value * 1000;
+    case 'm': return value * 60 * 1000;
+    case 'h': return value * 60 * 60 * 1000;
+    default:  return null;
+  }
+}
+
+/**
+ * Format a duration in milliseconds to a human-readable string.
+ *
+ * @param {number} ms - Duration in milliseconds
+ * @returns {string} Formatted string (e.g. "5 minute(s)")
+ */
+export function formatDuration(ms) {
+  if (ms >= 3600000) return `${Math.round(ms / 3600000)} hour(s)`;
+  if (ms >= 60000) return `${Math.round(ms / 60000)} minute(s)`;
+  return `${Math.round(ms / 1000)} second(s)`;
+}
+
+// ─── Path Resolution ─────────────────────────────────────────────────────────
+
+/**
+ * Expand a leading ~ to the user's home directory.
+ *
+ * @param {string} inputPath
+ * @returns {string}
+ */
+export function expandTilde(inputPath) {
+  if (inputPath.startsWith('~/') || inputPath === '~') {
+    return inputPath.replace(/^~/, process.env.HOME || process.env.USERPROFILE || '.');
+  }
+  return inputPath;
+}
+
+/**
+ * Resolve and validate a starting directory path.
+ * Falls back to the user's home directory if no path is provided.
+ * Exits the process if the path doesn't exist or isn't a directory.
+ *
+ * @param {string|undefined} inputPath
+ * @returns {string} Resolved absolute path
+ */
+export function resolveStartPath(inputPath) {
+  if (!inputPath) return process.env.HOME || process.env.USERPROFILE || process.cwd();
+
+  const resolved = path.resolve(expandTilde(inputPath));
+
+  if (!fs.existsSync(resolved)) {
+    logger.error(`Path does not exist: ${resolved}`);
+    process.exit(1);
+  }
+
+  const stat = fs.statSync(resolved);
+  if (!stat.isDirectory()) {
+    logger.error(`Path is not a directory: ${resolved}`);
+    process.exit(1);
+  }
+
+  return resolved;
+}
+
+// ─── Shell Detection ─────────────────────────────────────────────────────────
+
+/**
+ * Detect the user's default shell.
+ * Checks $SHELL, Windows COMSPEC, /etc/passwd, and falls back to bash/powershell.
+ *
+ * @returns {string} Shell executable path or name
+ */
+export function detectShell() {
+  const platform = os.platform();
+  if (process.env.SHELL) return process.env.SHELL;
+  if (platform === 'win32') return process.env.COMSPEC || 'powershell.exe';
+  try {
+    const passwd = fs.readFileSync('/etc/passwd', 'utf-8');
+    const username = os.userInfo().username;
+    const line = passwd.split('\n').find((l) => l.startsWith(username + ':'));
+    if (line) {
+      const shell = line.split(':').pop().trim();
+      if (shell) return shell;
+    }
+  } catch {}
+  return platform === 'win32' ? 'powershell.exe' : 'bash';
+}