peer-term 1.4.3 → 1.4.5

package/README.md

@@ -12,7 +12,7 @@ npx peer-term
 
 This will start a terminal sharing session and give you a 6-digit code.
 
-Share this code with your peer. They can view your terminal by going to https://relay.dhananjaybalekar.in/ and entering the code.
+Share this code with your peer. They can view your terminal by going to https://peerterm.dhananjaybalekar.in/ and entering the code.
 
 ## Global Installation
 
@@ -51,6 +51,8 @@ peer-term --verbose                    # enable debug logging
 - **Custom Start Path**: Set the starting directory with `--path`.
 - **Resilient Connections**: Both host and client get a 2-minute rejoin window if their IP changes or connection drops. PTY state is fully preserved — no session restart needed.
 - **Multi-Session**: Manage multiple simultaneous sessions with the interactive CLI menu.
+- **QR Code Support**: Displays a terminal QR code for instant connection from mobile or tablet devices without manually entering the code.
+- **Interactive Controls**: Manage sessions directly from the CLI (`n` for new session, `l` to list, `k` to kill, `a` to authorize fingerprint, `q` to quit).
 
 ## How It Works
 

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "peer-term",
-  "version": "1.4.3",
+  "version": "1.4.5",
   "license": "MIT",
   "description": "Share your terminal instantly using a 6-digit code or QR code. Encrypted. No config.",
   "repository": {
     "type": "git",
-    "url": "https://github.com/jay6205/Peer_Term",
+    "url": "https://github.com/jay6205/Peer_term.git",
     "directory": "host"
   },
-  "homepage": "https://github.com/jay6205/Peer_Term#readme",
+  "homepage": "https://github.com/jay6205/Peer_term#readme",
   "bugs": {
-    "url": "https://github.com/jay6205/Peer_Term/issues"
+    "url": "https://github.com/jay6205/Peer_term/issues"
   },
   "keywords": [
     "terminal",

package/src/index.js

@@ -338,6 +338,12 @@ class Session {
       case 'code': {
         this.code = msg.code;
         this.hostToken = msg.hostToken || null;
+        const shareUrl = process.env.PEERTERM_CLIENT_URL || (
+          url.includes('relay.dhananjaybalekar.in')
+            ? 'https://peerterm.dhananjaybalekar.in'
+            : url.replace(/^wss:\/\//i, 'https://').replace(/^ws:\/\//i, 'http://')
+        );
+
         await printSessionBox({
           code: this.code,
           expiry: formatDuration(this.expiryMs),
@@ -345,7 +351,7 @@ class Session {
           mode: (this.readOnly ? 'Read-Only' : 'Read-Write') + (this.secureMode ? ' (Secure)' : ''),
           shell: this.shell,
           startPath: this.startPath,
-          shareUrl: url.replace(/^wss:\/\//i, 'https://').replace(/^ws:\/\//i, 'http://')
+          shareUrl
         });
         if (resolve) resolve(this.code);
         break;

package/src/ui.js

@@ -1,166 +1,166 @@
-/**
- * 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';
-import qrcode from 'qrcode-terminal';
-
-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 async function printSessionBox({ code, expiry, rejoinWindow, mode, shell, startPath, shareUrl }) {
-  const spacedCode = code.split('').join(' ');
-  const url = shareUrl || 'https://peerterm.dev';
-  const joinUrl = `${url}?code=${code}`;
-
-  // 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('');
-
-  // Render QR code for instant scan-to-join
-  try {
-    const qrString = await new Promise((resolve) => {
-      qrcode.generate(joinUrl, { small: true }, (qr) => {
-        resolve(qr);
-      });
-    });
-
-    console.log('  Scan to join:');
-    console.log('');
-    // Indent each QR line for alignment with the box
-    const qrLines = qrString.split('\n');
-    for (const line of qrLines) {
-      if (line.length > 0) console.log(`    ${line}`);
-    }
-    console.log('');
-    console.log(`  Or open: ${joinUrl}`);
-    console.log('');
-  } catch {
-    // QR generation failed — not critical, code is still shown in the box
-  }
-}
-
-// ─── 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';
+import qrcode from 'qrcode-terminal';
+
+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.dhananjaybalekar.in")
+ */
+export async function printSessionBox({ code, expiry, rejoinWindow, mode, shell, startPath, shareUrl }) {
+  const spacedCode = code.split('').join(' ');
+  const url = shareUrl || 'https://peerterm.dhananjaybalekar.in';
+  const joinUrl = `${url}?code=${code}`;
+
+  // 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('');
+
+  // Render QR code for instant scan-to-join
+  try {
+    const qrString = await new Promise((resolve) => {
+      qrcode.generate(joinUrl, { small: true }, (qr) => {
+        resolve(qr);
+      });
+    });
+
+    console.log('  Scan to join:');
+    console.log('');
+    // Indent each QR line for alignment with the box
+    const qrLines = qrString.split('\n');
+    for (const line of qrLines) {
+      if (line.length > 0) console.log(`    ${line}`);
+    }
+    console.log('');
+    console.log(`  Or open: ${joinUrl}`);
+    console.log('');
+  } catch {
+    // QR generation failed — not critical, code is still shown in the box
+  }
+}
+
+// ─── 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)');
+  }
+}