peer-term 1.4.5 → 1.4.7

package/README.md

@@ -37,10 +37,38 @@ peer-term --path .                     # starts in current directory
 peer-term --readonly                   # view-only session
 peer-term --secure                     # require fingerprint verification
 peer-term --expiry 10m                 # custom expiry time
+peer-term --rejoin 5m                  # custom reconnection window
 peer-term --relay wss://custom         # use a custom relay server
 peer-term --verbose                    # enable debug logging
 ```
 
+### CLI Highlights
+
+| Flag | Description | Default |
+| :--- | :--- | :--- |
+| `--expiry <time>` | Session expiry duration (e.g. `5m`, `30s`, `1h`) | `5m` |
+| `--rejoin <time>` | Reconnection window if connection drops (e.g. `2m`, `10m`) | `2m` |
+| `--readonly` | Disable client keystrokes (view-only terminal mode) | Off |
+| `--secure` | Enable fingerprint verification for MITM protection | Off |
+| `--path <dir>` | Starting directory for the terminal session | `~` (Home) |
+| `--relay <url>` | Custom relay server WebSocket URL(s) | `wss://relay.dhananjaybalekar.in` |
+| `-V, --verbose` | Enable verbose debug logging | Off |
+| `-h, --help` | Display usage information and exit | — |
+| `-v, --version` | Output version number and exit | — |
+
+### Interactive Controls
+
+While running, you can manage sessions directly from the host CLI:
+
+| Command | Description |
+| :--- | :--- |
+| `n` | Create a new session |
+| `l` | List all active sessions |
+| `a <code>` | Authorize verified fingerprint (in `--secure` mode) |
+| `k <code>` | Kill a specific session |
+| `q` | Quit all sessions and exit |
+
+
 ## Features
 
 - **No Config**: Works instantly. No port forwarding or firewall configuration needed.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "peer-term",
-  "version": "1.4.5",
+  "version": "1.4.7",
   "license": "MIT",
   "description": "Share your terminal instantly using a 6-digit code or QR code. Encrypted. No config.",
   "repository": {

package/src/cli.js

@@ -4,13 +4,13 @@
  * Top-level orchestration:
  *   1. Detects shell, resolves start path, runs interactive prompts
  *   2. Creates a SessionManager and starts the first session
- *   3. Provides a readline-based menu (n/l/k/a/q) for managing sessions
+ *   3. Provides a readline-based menu (n/l/r/k/a/q) for managing sessions
  *   4. Handles SIGINT and global error handlers
  */
 
 import readline from 'readline';
 import logger from './logger.js';
-import { printBanner } from './ui.js';
+import { printBanner, printCommandsMenu } from './ui.js';
 import { argv, RELAY_URLS } from './config.js';
 import { formatDuration, detectShell, resolveStartPath } from './utils.js';
 import { getExpiryInteractive, getRejoinInteractive } from './prompts.js';
@@ -50,14 +50,7 @@ async function main() {
   }
 
   // ─── Interactive CLI menu ──────────────────────────────────────────
-  console.log('  ─────────────────────────────────────────');
-  console.log('  Commands:');
-  console.log('    [n] New session');
-  console.log('    [l] List sessions');
-  console.log('    [a <code>] Authorize verified fingerprint');
-  console.log('    [k <code>] Kill session');
-  console.log('    [q] Quit all');
-  console.log('  ─────────────────────────────────────────');
+  printCommandsMenu();
   console.log('');
 
   const rl = readline.createInterface({
@@ -76,6 +69,13 @@ async function main() {
       await manager.createSession();
     } else if (input === 'l') {
       manager.listSessions();
+    } else if (input.startsWith('r ') || input.startsWith('rt ') || input === 'r' || input === 'rt') {
+      const code = input.startsWith('rt ')
+        ? input.slice(3).trim()
+        : input.startsWith('r ')
+        ? input.slice(2).trim()
+        : '';
+      await manager.toggleReadonlySession(code);
     } else if (input.startsWith('a ')) {
       const code = input.slice(2).trim();
       await manager.authorizeSession(code);
@@ -88,7 +88,7 @@ async function main() {
       rl.close();
       process.exit(0);
     } else if (input) {
-      console.log('  Unknown command. Use n, l, a <code>, k <code>, or q.');
+      console.log('  Unknown command. Use n, l, r <code>, a <code>, k <code>, or q.');
     }
 
     rl.prompt();

package/src/index.js

@@ -46,7 +46,7 @@ import { ViewerServer } from './viewer.js';
 
 // ─── Session Class ───────────────────────────────────────────────────────────
 
-class Session {
+export class Session {
   constructor(shell, expiryMs, rejoinMs, readOnly, startPath, onDestroy) {
     this.shell = shell;
     this.expiryMs = expiryMs;
@@ -92,6 +92,25 @@ class Session {
     this.sessionDurationInterval = null; // Interval: periodic CLI status log
   }
 
+  get readonly() {
+    return this.readOnly;
+  }
+
+  set readonly(val) {
+    this.readOnly = Boolean(val);
+  }
+
+  async toggleReadonly() {
+    this.readonly = !this.readonly;
+    const modeStr = this.readonly ? 'READ-ONLY' : 'INTERACTIVE (write enabled)';
+    const codeLabel = this.code ? `Session ${this.code}` : 'Session';
+    this.log(`${codeLabel} is now ${modeStr}`);
+    if (this.sharedKey) {
+      await this._sendSessionConfig();
+    }
+    return this.readonly;
+  }
+
   /**
    * Build the context object for FileTransferHandler.
    * Called on construction and whenever shared key changes.
@@ -233,18 +252,18 @@ class Session {
   }
 
   async _sendSessionConfig() {
-    if (!this.sharedKey || !this.ws || this.ws.readyState !== WebSocket.OPEN) return;
+    if (!this.sharedKey) return;
 
     const config = JSON.stringify({
       type: 'session-config',
-      readonly: this.readOnly,
+      readonly: this.readonly,
       version: version,
       shell: this.shell,
       startPath: this.startPath,
     });
     try {
       const payload = await encrypt(this.sharedKey, config);
-      this.ws.send(JSON.stringify({ type: 'data', payload }));
+      this._sendEncryptedToClient(payload);
     } catch (err) {
       this.log(`Failed to send session config: ${err.message}`);
     }
@@ -941,8 +960,8 @@ class Session {
     } else {
       status = `waiting for client (expires in ${formatDuration(remaining)})`;
     }
-    if (this.readOnly) status += '  (readonly)';
-    return status;
+    const mode = this.readonly ? '[READ-ONLY]' : '[INTERACTIVE]';
+    return `${status} ${mode}`;
   }
 
   // ─── Session Duration Logging ────────────────────────────────────────
@@ -1034,6 +1053,19 @@ export class SessionManager {
     await session.authorizeFingerprint();
   }
 
+  async toggleReadonlySession(code) {
+    const session = this.sessions.get(code);
+    if (!session) {
+      logger.warn(`Session ${code} not found.`);
+      return;
+    }
+    await session.toggleReadonly();
+  }
+
+  async toggleReadonly(code) {
+    return this.toggleReadonlySession(code);
+  }
+
   killAll() {
     for (const [, session] of this.sessions) {
       session.destroy();

package/src/ui.js

@@ -164,3 +164,21 @@ export function printVersion() {
     console.log('peer-term (version unknown)');
   }
 }
+
+// ─── Commands Menu ───────────────────────────────────────────────────────────
+
+/**
+ * Print the interactive CLI commands menu.
+ */
+export function printCommandsMenu() {
+  console.log('  ─────────────────────────────────────────');
+  console.log('  Commands:');
+  console.log('    [n] New session');
+  console.log('    [l] List sessions');
+  console.log('    [r <code>] Toggle read-only mode');
+  console.log('    [a <code>] Authorize verified fingerprint');
+  console.log('    [k <code>] Kill session');
+  console.log('    [q] Quit all');
+  console.log('  ─────────────────────────────────────────');
+}
+