x-shell.js 0.1.0

package/README.md

@@ -0,0 +1,304 @@
+# x-shell.js
+
+> WebSocket-based terminal for Node.js - the truth is in your shell
+
+A plug-and-play terminal solution for web applications. Includes a server component (node-pty), client library, and ready-to-use Lit web component.
+
+## Features
+
+- **Server**: WebSocket server with node-pty for real shell sessions
+- **Client**: Lightweight WebSocket client with auto-reconnection
+- **UI**: `<x-shell-terminal>` Lit web component with xterm.js
+- **Themes**: Built-in dark/light/auto theme support
+- **Security**: Configurable shell and path allowlists
+- **Framework Agnostic**: Works with React, Vue, Angular, Svelte, or vanilla JS
+
+## Installation
+
+```bash
+npm install x-shell.js node-pty
+```
+
+Note: `node-pty` requires native compilation. See [node-pty docs](https://github.com/microsoft/node-pty) for platform-specific requirements.
+
+## Quick Start
+
+### Server Setup
+
+```javascript
+import express from 'express';
+import { createServer } from 'http';
+import { TerminalServer } from 'x-shell.js/server';
+
+const app = express();
+const server = createServer(app);
+
+// Create and attach terminal server
+const terminalServer = new TerminalServer({
+  allowedShells: ['/bin/bash', '/bin/zsh'],
+  allowedPaths: ['/home/user'],
+  defaultCwd: '/home/user',
+  verbose: true,
+});
+
+terminalServer.attach(server);
+
+server.listen(3000, () => {
+  console.log('Server running on http://localhost:3000');
+});
+```
+
+### Client Usage (Web Component)
+
+```html
+<!-- Load xterm.js CSS -->
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/xterm@5.3.0/css/xterm.css">
+
+<!-- Load x-shell.js UI bundle -->
+<script type="module" src="https://unpkg.com/x-shell.js/dist/ui/browser-bundle.js"></script>
+
+<!-- Use the component -->
+<x-shell-terminal
+  url="ws://localhost:3000/terminal"
+  theme="dark"
+  auto-connect
+  auto-spawn
+></x-shell-terminal>
+```
+
+### Client Usage (JavaScript)
+
+```javascript
+import { TerminalClient } from 'x-shell.js/client';
+
+const client = new TerminalClient({
+  url: 'ws://localhost:3000/terminal'
+});
+
+await client.connect();
+
+client.onData((data) => {
+  console.log('Output:', data);
+});
+
+client.onExit((code) => {
+  console.log('Exited with code:', code);
+});
+
+await client.spawn({
+  shell: '/bin/bash',
+  cwd: '/home/user'
+});
+
+client.write('ls -la\n');
+client.resize(120, 40);
+```
+
+## API Reference
+
+### Server
+
+#### `TerminalServer`
+
+```typescript
+import { TerminalServer } from 'x-shell.js/server';
+
+const server = new TerminalServer({
+  // Allowed shells (empty = all allowed)
+  allowedShells: ['/bin/bash', '/bin/zsh', 'cmd.exe'],
+
+  // Allowed working directories (empty = all allowed)
+  allowedPaths: ['/home/user', '/var/www'],
+
+  // Default shell if not specified
+  defaultShell: '/bin/bash',
+
+  // Default working directory
+  defaultCwd: '/home/user',
+
+  // Max sessions per client (default: 5)
+  maxSessionsPerClient: 5,
+
+  // Idle timeout in ms (default: 30 minutes, 0 = disabled)
+  idleTimeout: 30 * 60 * 1000,
+
+  // WebSocket path (default: '/terminal')
+  path: '/terminal',
+
+  // Enable verbose logging
+  verbose: false,
+});
+
+// Attach to HTTP server
+server.attach(httpServer);
+
+// Or start standalone
+server.listen(3001);
+
+// Get active sessions
+const sessions = server.getSessions();
+
+// Close server
+server.close();
+```
+
+### Client
+
+#### `TerminalClient`
+
+```typescript
+import { TerminalClient } from 'x-shell.js/client';
+
+const client = new TerminalClient({
+  url: 'ws://localhost:3000/terminal',
+  reconnect: true,           // Auto-reconnect (default: true)
+  maxReconnectAttempts: 10,  // Max attempts (default: 10)
+  reconnectDelay: 1000,      // Initial delay ms (default: 1000)
+});
+
+// Connect to server
+await client.connect();
+
+// Spawn terminal session
+const sessionInfo = await client.spawn({
+  shell: '/bin/bash',
+  cwd: '/home/user',
+  env: { TERM: 'xterm-256color' },
+  cols: 80,
+  rows: 24,
+});
+
+// Write to terminal
+client.write('echo "Hello World"\n');
+
+// Resize terminal
+client.resize(120, 40);
+
+// Kill session
+client.kill();
+
+// Disconnect
+client.disconnect();
+
+// Event handlers
+client.onConnect(() => console.log('Connected'));
+client.onDisconnect(() => console.log('Disconnected'));
+client.onData((data) => console.log('Data:', data));
+client.onExit((code) => console.log('Exit:', code));
+client.onError((err) => console.log('Error:', err));
+client.onSpawned((info) => console.log('Spawned:', info));
+
+// State getters
+client.isConnected();      // boolean
+client.hasActiveSession(); // boolean
+client.getSessionId();     // string | null
+client.getSessionInfo();   // SessionInfo | null
+```
+
+### UI Component
+
+#### `<x-shell-terminal>`
+
+```html
+<x-shell-terminal
+  url="ws://localhost:3000/terminal"
+  shell="/bin/bash"
+  cwd="/home/user"
+  theme="dark"
+  font-size="14"
+  font-family="Menlo, Monaco, monospace"
+  cols="80"
+  rows="24"
+  auto-connect
+  auto-spawn
+  no-header
+></x-shell-terminal>
+```
+
+**Attributes:**
+
+| Attribute | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `url` | string | `''` | WebSocket URL |
+| `shell` | string | `''` | Shell to use |
+| `cwd` | string | `''` | Working directory |
+| `theme` | `'dark'` \| `'light'` \| `'auto'` | `'dark'` | Color theme |
+| `font-size` | number | `14` | Terminal font size |
+| `font-family` | string | `'Menlo, Monaco, ...'` | Terminal font |
+| `cols` | number | `80` | Initial columns |
+| `rows` | number | `24` | Initial rows |
+| `auto-connect` | boolean | `false` | Connect on mount |
+| `auto-spawn` | boolean | `false` | Spawn on connect |
+| `no-header` | boolean | `false` | Hide header bar |
+
+**Methods:**
+
+```javascript
+const terminal = document.querySelector('x-shell-terminal');
+
+await terminal.connect();     // Connect to server
+terminal.disconnect();        // Disconnect
+await terminal.spawn();       // Spawn session
+terminal.kill();              // Kill session
+terminal.clear();             // Clear display
+terminal.write('text');       // Write to display
+terminal.writeln('line');     // Write line to display
+terminal.focus();             // Focus terminal
+```
+
+**Events:**
+
+```javascript
+terminal.addEventListener('connect', () => {});
+terminal.addEventListener('disconnect', () => {});
+terminal.addEventListener('spawned', (e) => console.log(e.detail.session));
+terminal.addEventListener('exit', (e) => console.log(e.detail.exitCode));
+terminal.addEventListener('error', (e) => console.log(e.detail.error));
+```
+
+## Theming
+
+The component uses CSS custom properties for theming:
+
+```css
+x-shell-terminal {
+  --xs-bg: #1e1e1e;
+  --xs-bg-header: #2d2d2d;
+  --xs-text: #cccccc;
+  --xs-text-muted: #808080;
+  --xs-border: #3e3e3e;
+  --xs-terminal-bg: #1e1e1e;
+  --xs-terminal-fg: #cccccc;
+  --xs-terminal-cursor: #ffffff;
+  --xs-terminal-selection: #264f78;
+  --xs-btn-bg: #3c3c3c;
+  --xs-btn-text: #cccccc;
+  --xs-btn-hover: #4a4a4a;
+  --xs-status-connected: #22c55e;
+  --xs-status-disconnected: #ef4444;
+}
+```
+
+## Security
+
+**Always configure security for production:**
+
+```javascript
+const server = new TerminalServer({
+  // Restrict allowed shells
+  allowedShells: ['/bin/bash'],
+
+  // Restrict working directories
+  allowedPaths: ['/home/app', '/var/www'],
+
+  // Limit sessions per client
+  maxSessionsPerClient: 2,
+
+  // Set idle timeout
+  idleTimeout: 10 * 60 * 1000, // 10 minutes
+});
+```
+
+## License
+
+MIT

package/dist/client/browser-bundle.js

@@ -0,0 +1,314 @@
+// src/client/terminal-client.ts
+var TerminalClient = class {
+  constructor(config) {
+    this.ws = null;
+    this.state = "disconnected";
+    this.sessionId = null;
+    this.sessionInfo = null;
+    this.reconnectAttempts = 0;
+    this.reconnectTimeout = null;
+    // Event handlers
+    this.connectHandlers = [];
+    this.disconnectHandlers = [];
+    this.dataHandlers = [];
+    this.exitHandlers = [];
+    this.errorHandlers = [];
+    this.spawnedHandlers = [];
+    // Promise resolvers for spawn
+    this.spawnResolve = null;
+    this.spawnReject = null;
+    this.config = {
+      url: config.url,
+      reconnect: config.reconnect ?? true,
+      maxReconnectAttempts: config.maxReconnectAttempts ?? 10,
+      reconnectDelay: config.reconnectDelay ?? 1e3
+    };
+  }
+  /**
+   * Connect to the terminal server
+   */
+  connect() {
+    return new Promise((resolve, reject) => {
+      if (this.state === "connected") {
+        resolve();
+        return;
+      }
+      this.state = "connecting";
+      try {
+        this.ws = new WebSocket(this.config.url);
+      } catch (error) {
+        this.state = "disconnected";
+        reject(error);
+        return;
+      }
+      this.ws.onopen = () => {
+        this.state = "connected";
+        this.reconnectAttempts = 0;
+        this.connectHandlers.forEach((handler) => handler());
+        resolve();
+      };
+      this.ws.onclose = () => {
+        const wasConnected = this.state === "connected";
+        this.state = "disconnected";
+        this.sessionId = null;
+        this.sessionInfo = null;
+        if (wasConnected) {
+          this.disconnectHandlers.forEach((handler) => handler());
+        }
+        if (this.config.reconnect && this.reconnectAttempts < this.config.maxReconnectAttempts) {
+          this.scheduleReconnect();
+        }
+      };
+      this.ws.onerror = (event) => {
+        const error = new Error("WebSocket error");
+        this.errorHandlers.forEach((handler) => handler(error));
+        if (this.state === "connecting") {
+          reject(error);
+        }
+      };
+      this.ws.onmessage = (event) => {
+        this.handleMessage(event.data);
+      };
+    });
+  }
+  /**
+   * Disconnect from the terminal server
+   */
+  disconnect() {
+    this.config.reconnect = false;
+    if (this.reconnectTimeout) {
+      clearTimeout(this.reconnectTimeout);
+      this.reconnectTimeout = null;
+    }
+    if (this.ws) {
+      this.ws.close();
+      this.ws = null;
+    }
+    this.state = "disconnected";
+    this.sessionId = null;
+    this.sessionInfo = null;
+  }
+  /**
+   * Schedule a reconnection attempt
+   */
+  scheduleReconnect() {
+    if (this.reconnectTimeout)
+      return;
+    const delay = this.config.reconnectDelay * Math.pow(2, this.reconnectAttempts);
+    const maxDelay = 3e4;
+    this.reconnectTimeout = setTimeout(() => {
+      this.reconnectTimeout = null;
+      this.reconnectAttempts++;
+      this.connect().catch(() => {
+      });
+    }, Math.min(delay, maxDelay));
+  }
+  /**
+   * Handle incoming message
+   */
+  handleMessage(data) {
+    let message;
+    try {
+      message = JSON.parse(data);
+    } catch {
+      console.error("[x-shell] Invalid message:", data);
+      return;
+    }
+    switch (message.type) {
+      case "spawned":
+        this.sessionId = message.sessionId;
+        this.sessionInfo = {
+          sessionId: message.sessionId,
+          shell: message.shell,
+          cwd: message.cwd,
+          cols: message.cols,
+          rows: message.rows,
+          createdAt: /* @__PURE__ */ new Date()
+        };
+        this.spawnedHandlers.forEach((handler) => handler(this.sessionInfo));
+        if (this.spawnResolve) {
+          this.spawnResolve(this.sessionInfo);
+          this.spawnResolve = null;
+          this.spawnReject = null;
+        }
+        break;
+      case "data":
+        this.dataHandlers.forEach((handler) => handler(message.data));
+        break;
+      case "exit":
+        const exitCode = message.exitCode;
+        this.exitHandlers.forEach((handler) => handler(exitCode));
+        this.sessionId = null;
+        this.sessionInfo = null;
+        break;
+      case "error":
+        const error = new Error(message.error);
+        this.errorHandlers.forEach((handler) => handler(error));
+        if (this.spawnReject) {
+          this.spawnReject(error);
+          this.spawnResolve = null;
+          this.spawnReject = null;
+        }
+        break;
+    }
+  }
+  /**
+   * Spawn a terminal session
+   */
+  spawn(options = {}) {
+    return new Promise((resolve, reject) => {
+      if (this.state !== "connected" || !this.ws) {
+        reject(new Error("Not connected to server"));
+        return;
+      }
+      if (this.sessionId) {
+        reject(new Error("Session already spawned. Call kill() first."));
+        return;
+      }
+      this.spawnResolve = resolve;
+      this.spawnReject = reject;
+      this.ws.send(
+        JSON.stringify({
+          type: "spawn",
+          options
+        })
+      );
+    });
+  }
+  /**
+   * Write data to the terminal
+   */
+  write(data) {
+    if (!this.ws || this.state !== "connected") {
+      console.error("[x-shell] Cannot write: not connected");
+      return;
+    }
+    if (!this.sessionId) {
+      console.error("[x-shell] Cannot write: no active session");
+      return;
+    }
+    this.ws.send(
+      JSON.stringify({
+        type: "data",
+        sessionId: this.sessionId,
+        data
+      })
+    );
+  }
+  /**
+   * Resize the terminal
+   */
+  resize(cols, rows) {
+    if (!this.ws || this.state !== "connected") {
+      console.error("[x-shell] Cannot resize: not connected");
+      return;
+    }
+    if (!this.sessionId) {
+      console.error("[x-shell] Cannot resize: no active session");
+      return;
+    }
+    this.ws.send(
+      JSON.stringify({
+        type: "resize",
+        sessionId: this.sessionId,
+        cols,
+        rows
+      })
+    );
+  }
+  /**
+   * Kill the terminal session
+   */
+  kill() {
+    if (!this.ws || this.state !== "connected") {
+      return;
+    }
+    if (!this.sessionId) {
+      return;
+    }
+    this.ws.send(
+      JSON.stringify({
+        type: "close",
+        sessionId: this.sessionId
+      })
+    );
+    this.sessionId = null;
+    this.sessionInfo = null;
+  }
+  // ==========================================
+  // Event handlers
+  // ==========================================
+  /**
+   * Called when connected to server
+   */
+  onConnect(handler) {
+    this.connectHandlers.push(handler);
+  }
+  /**
+   * Called when disconnected from server
+   */
+  onDisconnect(handler) {
+    this.disconnectHandlers.push(handler);
+  }
+  /**
+   * Called when data is received from the terminal
+   */
+  onData(handler) {
+    this.dataHandlers.push(handler);
+  }
+  /**
+   * Called when the terminal session exits
+   */
+  onExit(handler) {
+    this.exitHandlers.push(handler);
+  }
+  /**
+   * Called when an error occurs
+   */
+  onError(handler) {
+    this.errorHandlers.push(handler);
+  }
+  /**
+   * Called when a session is spawned
+   */
+  onSpawned(handler) {
+    this.spawnedHandlers.push(handler);
+  }
+  // ==========================================
+  // Getters
+  // ==========================================
+  /**
+   * Get current connection state
+   */
+  getState() {
+    return this.state;
+  }
+  /**
+   * Check if connected
+   */
+  isConnected() {
+    return this.state === "connected";
+  }
+  /**
+   * Get current session ID
+   */
+  getSessionId() {
+    return this.sessionId;
+  }
+  /**
+   * Get current session info
+   */
+  getSessionInfo() {
+    return this.sessionInfo;
+  }
+  /**
+   * Check if a session is active
+   */
+  hasActiveSession() {
+    return this.sessionId !== null;
+  }
+};
+export {
+  TerminalClient
+};
+//# sourceMappingURL=browser-bundle.js.map

package/dist/client/browser-bundle.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/client/terminal-client.ts"],
+  "sourcesContent": ["/**\r\n * Terminal client for connecting to x-shell server\r\n *\r\n * Example usage:\r\n * ```typescript\r\n * import { TerminalClient } from 'x-shell.js/client';\r\n *\r\n * const client = new TerminalClient({ url: 'ws://localhost:3000/terminal' });\r\n * await client.connect();\r\n *\r\n * client.onData((data) => console.log(data));\r\n * client.onExit((code) => console.log('Exited with code:', code));\r\n *\r\n * await client.spawn({ shell: '/bin/bash', cwd: '/home/user' });\r\n * client.write('ls -la\\n');\r\n * client.resize(120, 40);\r\n * client.kill();\r\n * ```\r\n */\r\n\r\nimport type {\r\n  ClientConfig,\r\n  TerminalOptions,\r\n  TerminalMessage,\r\n  SessionInfo,\r\n} from '../shared/types.js';\r\n\r\n/**\r\n * Connection state\r\n */\r\nexport type ConnectionState = 'disconnected' | 'connecting' | 'connected';\r\n\r\n/**\r\n * Terminal client class\r\n */\r\nexport class TerminalClient {\r\n  private config: Required<ClientConfig>;\r\n  private ws: WebSocket | null = null;\r\n  private state: ConnectionState = 'disconnected';\r\n  private sessionId: string | null = null;\r\n  private sessionInfo: SessionInfo | null = null;\r\n  private reconnectAttempts = 0;\r\n  private reconnectTimeout: ReturnType<typeof setTimeout> | null = null;\r\n\r\n  // Event handlers\r\n  private connectHandlers: (() => void)[] = [];\r\n  private disconnectHandlers: (() => void)[] = [];\r\n  private dataHandlers: ((data: string) => void)[] = [];\r\n  private exitHandlers: ((code: number) => void)[] = [];\r\n  private errorHandlers: ((error: Error) => void)[] = [];\r\n  private spawnedHandlers: ((info: SessionInfo) => void)[] = [];\r\n\r\n  // Promise resolvers for spawn\r\n  private spawnResolve: ((info: SessionInfo) => void) | null = null;\r\n  private spawnReject: ((error: Error) => void) | null = null;\r\n\r\n  constructor(config: ClientConfig) {\r\n    this.config = {\r\n      url: config.url,\r\n      reconnect: config.reconnect ?? true,\r\n      maxReconnectAttempts: config.maxReconnectAttempts ?? 10,\r\n      reconnectDelay: config.reconnectDelay ?? 1000,\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Connect to the terminal server\r\n   */\r\n  connect(): Promise<void> {\r\n    return new Promise((resolve, reject) => {\r\n      if (this.state === 'connected') {\r\n        resolve();\r\n        return;\r\n      }\r\n\r\n      this.state = 'connecting';\r\n\r\n      try {\r\n        this.ws = new WebSocket(this.config.url);\r\n      } catch (error) {\r\n        this.state = 'disconnected';\r\n        reject(error);\r\n        return;\r\n      }\r\n\r\n      this.ws.onopen = () => {\r\n        this.state = 'connected';\r\n        this.reconnectAttempts = 0;\r\n        this.connectHandlers.forEach((handler) => handler());\r\n        resolve();\r\n      };\r\n\r\n      this.ws.onclose = () => {\r\n        const wasConnected = this.state === 'connected';\r\n        this.state = 'disconnected';\r\n        this.sessionId = null;\r\n        this.sessionInfo = null;\r\n\r\n        if (wasConnected) {\r\n          this.disconnectHandlers.forEach((handler) => handler());\r\n        }\r\n\r\n        // Attempt reconnection\r\n        if (this.config.reconnect && this.reconnectAttempts < this.config.maxReconnectAttempts) {\r\n          this.scheduleReconnect();\r\n        }\r\n      };\r\n\r\n      this.ws.onerror = (event) => {\r\n        const error = new Error('WebSocket error');\r\n        this.errorHandlers.forEach((handler) => handler(error));\r\n\r\n        if (this.state === 'connecting') {\r\n          reject(error);\r\n        }\r\n      };\r\n\r\n      this.ws.onmessage = (event) => {\r\n        this.handleMessage(event.data);\r\n      };\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Disconnect from the terminal server\r\n   */\r\n  disconnect(): void {\r\n    this.config.reconnect = false; // Prevent auto-reconnect\r\n\r\n    if (this.reconnectTimeout) {\r\n      clearTimeout(this.reconnectTimeout);\r\n      this.reconnectTimeout = null;\r\n    }\r\n\r\n    if (this.ws) {\r\n      this.ws.close();\r\n      this.ws = null;\r\n    }\r\n\r\n    this.state = 'disconnected';\r\n    this.sessionId = null;\r\n    this.sessionInfo = null;\r\n  }\r\n\r\n  /**\r\n   * Schedule a reconnection attempt\r\n   */\r\n  private scheduleReconnect(): void {\r\n    if (this.reconnectTimeout) return;\r\n\r\n    const delay = this.config.reconnectDelay * Math.pow(2, this.reconnectAttempts);\r\n    const maxDelay = 30000; // 30 seconds max\r\n\r\n    this.reconnectTimeout = setTimeout(() => {\r\n      this.reconnectTimeout = null;\r\n      this.reconnectAttempts++;\r\n      this.connect().catch(() => {\r\n        // Error handled by onclose\r\n      });\r\n    }, Math.min(delay, maxDelay));\r\n  }\r\n\r\n  /**\r\n   * Handle incoming message\r\n   */\r\n  private handleMessage(data: string): void {\r\n    let message: TerminalMessage;\r\n\r\n    try {\r\n      message = JSON.parse(data);\r\n    } catch {\r\n      console.error('[x-shell] Invalid message:', data);\r\n      return;\r\n    }\r\n\r\n    switch (message.type) {\r\n      case 'spawned':\r\n        this.sessionId = message.sessionId;\r\n        this.sessionInfo = {\r\n          sessionId: message.sessionId,\r\n          shell: message.shell,\r\n          cwd: message.cwd,\r\n          cols: message.cols,\r\n          rows: message.rows,\r\n          createdAt: new Date(),\r\n        };\r\n        this.spawnedHandlers.forEach((handler) => handler(this.sessionInfo!));\r\n        if (this.spawnResolve) {\r\n          this.spawnResolve(this.sessionInfo);\r\n          this.spawnResolve = null;\r\n          this.spawnReject = null;\r\n        }\r\n        break;\r\n\r\n      case 'data':\r\n        this.dataHandlers.forEach((handler) => handler(message.data));\r\n        break;\r\n\r\n      case 'exit':\r\n        const exitCode = message.exitCode;\r\n        this.exitHandlers.forEach((handler) => handler(exitCode));\r\n        this.sessionId = null;\r\n        this.sessionInfo = null;\r\n        break;\r\n\r\n      case 'error':\r\n        const error = new Error(message.error);\r\n        this.errorHandlers.forEach((handler) => handler(error));\r\n        if (this.spawnReject) {\r\n          this.spawnReject(error);\r\n          this.spawnResolve = null;\r\n          this.spawnReject = null;\r\n        }\r\n        break;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Spawn a terminal session\r\n   */\r\n  spawn(options: TerminalOptions = {}): Promise<SessionInfo> {\r\n    return new Promise((resolve, reject) => {\r\n      if (this.state !== 'connected' || !this.ws) {\r\n        reject(new Error('Not connected to server'));\r\n        return;\r\n      }\r\n\r\n      if (this.sessionId) {\r\n        reject(new Error('Session already spawned. Call kill() first.'));\r\n        return;\r\n      }\r\n\r\n      this.spawnResolve = resolve;\r\n      this.spawnReject = reject;\r\n\r\n      this.ws.send(\r\n        JSON.stringify({\r\n          type: 'spawn',\r\n          options,\r\n        })\r\n      );\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Write data to the terminal\r\n   */\r\n  write(data: string): void {\r\n    if (!this.ws || this.state !== 'connected') {\r\n      console.error('[x-shell] Cannot write: not connected');\r\n      return;\r\n    }\r\n\r\n    if (!this.sessionId) {\r\n      console.error('[x-shell] Cannot write: no active session');\r\n      return;\r\n    }\r\n\r\n    this.ws.send(\r\n      JSON.stringify({\r\n        type: 'data',\r\n        sessionId: this.sessionId,\r\n        data,\r\n      })\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Resize the terminal\r\n   */\r\n  resize(cols: number, rows: number): void {\r\n    if (!this.ws || this.state !== 'connected') {\r\n      console.error('[x-shell] Cannot resize: not connected');\r\n      return;\r\n    }\r\n\r\n    if (!this.sessionId) {\r\n      console.error('[x-shell] Cannot resize: no active session');\r\n      return;\r\n    }\r\n\r\n    this.ws.send(\r\n      JSON.stringify({\r\n        type: 'resize',\r\n        sessionId: this.sessionId,\r\n        cols,\r\n        rows,\r\n      })\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Kill the terminal session\r\n   */\r\n  kill(): void {\r\n    if (!this.ws || this.state !== 'connected') {\r\n      return;\r\n    }\r\n\r\n    if (!this.sessionId) {\r\n      return;\r\n    }\r\n\r\n    this.ws.send(\r\n      JSON.stringify({\r\n        type: 'close',\r\n        sessionId: this.sessionId,\r\n      })\r\n    );\r\n\r\n    this.sessionId = null;\r\n    this.sessionInfo = null;\r\n  }\r\n\r\n  // ==========================================\r\n  // Event handlers\r\n  // ==========================================\r\n\r\n  /**\r\n   * Called when connected to server\r\n   */\r\n  onConnect(handler: () => void): void {\r\n    this.connectHandlers.push(handler);\r\n  }\r\n\r\n  /**\r\n   * Called when disconnected from server\r\n   */\r\n  onDisconnect(handler: () => void): void {\r\n    this.disconnectHandlers.push(handler);\r\n  }\r\n\r\n  /**\r\n   * Called when data is received from the terminal\r\n   */\r\n  onData(handler: (data: string) => void): void {\r\n    this.dataHandlers.push(handler);\r\n  }\r\n\r\n  /**\r\n   * Called when the terminal session exits\r\n   */\r\n  onExit(handler: (code: number) => void): void {\r\n    this.exitHandlers.push(handler);\r\n  }\r\n\r\n  /**\r\n   * Called when an error occurs\r\n   */\r\n  onError(handler: (error: Error) => void): void {\r\n    this.errorHandlers.push(handler);\r\n  }\r\n\r\n  /**\r\n   * Called when a session is spawned\r\n   */\r\n  onSpawned(handler: (info: SessionInfo) => void): void {\r\n    this.spawnedHandlers.push(handler);\r\n  }\r\n\r\n  // ==========================================\r\n  // Getters\r\n  // ==========================================\r\n\r\n  /**\r\n   * Get current connection state\r\n   */\r\n  getState(): ConnectionState {\r\n    return this.state;\r\n  }\r\n\r\n  /**\r\n   * Check if connected\r\n   */\r\n  isConnected(): boolean {\r\n    return this.state === 'connected';\r\n  }\r\n\r\n  /**\r\n   * Get current session ID\r\n   */\r\n  getSessionId(): string | null {\r\n    return this.sessionId;\r\n  }\r\n\r\n  /**\r\n   * Get current session info\r\n   */\r\n  getSessionInfo(): SessionInfo | null {\r\n    return this.sessionInfo;\r\n  }\r\n\r\n  /**\r\n   * Check if a session is active\r\n   */\r\n  hasActiveSession(): boolean {\r\n    return this.sessionId !== null;\r\n  }\r\n}\r\n"],
+  "mappings": ";AAmCO,IAAM,iBAAN,MAAqB;AAAA,EAqB1B,YAAY,QAAsB;AAnBlC,SAAQ,KAAuB;AAC/B,SAAQ,QAAyB;AACjC,SAAQ,YAA2B;AACnC,SAAQ,cAAkC;AAC1C,SAAQ,oBAAoB;AAC5B,SAAQ,mBAAyD;AAGjE;AAAA,SAAQ,kBAAkC,CAAC;AAC3C,SAAQ,qBAAqC,CAAC;AAC9C,SAAQ,eAA2C,CAAC;AACpD,SAAQ,eAA2C,CAAC;AACpD,SAAQ,gBAA4C,CAAC;AACrD,SAAQ,kBAAmD,CAAC;AAG5D;AAAA,SAAQ,eAAqD;AAC7D,SAAQ,cAA+C;AAGrD,SAAK,SAAS;AAAA,MACZ,KAAK,OAAO;AAAA,MACZ,WAAW,OAAO,aAAa;AAAA,MAC/B,sBAAsB,OAAO,wBAAwB;AAAA,MACrD,gBAAgB,OAAO,kBAAkB;AAAA,IAC3C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,UAAyB;AACvB,WAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,UAAI,KAAK,UAAU,aAAa;AAC9B,gBAAQ;AACR;AAAA,MACF;AAEA,WAAK,QAAQ;AAEb,UAAI;AACF,aAAK,KAAK,IAAI,UAAU,KAAK,OAAO,GAAG;AAAA,MACzC,SAAS,OAAO;AACd,aAAK,QAAQ;AACb,eAAO,KAAK;AACZ;AAAA,MACF;AAEA,WAAK,GAAG,SAAS,MAAM;AACrB,aAAK,QAAQ;AACb,aAAK,oBAAoB;AACzB,aAAK,gBAAgB,QAAQ,CAAC,YAAY,QAAQ,CAAC;AACnD,gBAAQ;AAAA,MACV;AAEA,WAAK,GAAG,UAAU,MAAM;AACtB,cAAM,eAAe,KAAK,UAAU;AACpC,aAAK,QAAQ;AACb,aAAK,YAAY;AACjB,aAAK,cAAc;AAEnB,YAAI,cAAc;AAChB,eAAK,mBAAmB,QAAQ,CAAC,YAAY,QAAQ,CAAC;AAAA,QACxD;AAGA,YAAI,KAAK,OAAO,aAAa,KAAK,oBAAoB,KAAK,OAAO,sBAAsB;AACtF,eAAK,kBAAkB;AAAA,QACzB;AAAA,MACF;AAEA,WAAK,GAAG,UAAU,CAAC,UAAU;AAC3B,cAAM,QAAQ,IAAI,MAAM,iBAAiB;AACzC,aAAK,cAAc,QAAQ,CAAC,YAAY,QAAQ,KAAK,CAAC;AAEtD,YAAI,KAAK,UAAU,cAAc;AAC/B,iBAAO,KAAK;AAAA,QACd;AAAA,MACF;AAEA,WAAK,GAAG,YAAY,CAAC,UAAU;AAC7B,aAAK,cAAc,MAAM,IAAI;AAAA,MAC/B;AAAA,IACF,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,aAAmB;AACjB,SAAK,OAAO,YAAY;AAExB,QAAI,KAAK,kBAAkB;AACzB,mBAAa,KAAK,gBAAgB;AAClC,WAAK,mBAAmB;AAAA,IAC1B;AAEA,QAAI,KAAK,IAAI;AACX,WAAK,GAAG,MAAM;AACd,WAAK,KAAK;AAAA,IACZ;AAEA,SAAK,QAAQ;AACb,SAAK,YAAY;AACjB,SAAK,cAAc;AAAA,EACrB;AAAA;AAAA;AAAA;AAAA,EAKQ,oBAA0B;AAChC,QAAI,KAAK;AAAkB;AAE3B,UAAM,QAAQ,KAAK,OAAO,iBAAiB,KAAK,IAAI,GAAG,KAAK,iBAAiB;AAC7E,UAAM,WAAW;AAEjB,SAAK,mBAAmB,WAAW,MAAM;AACvC,WAAK,mBAAmB;AACxB,WAAK;AACL,WAAK,QAAQ,EAAE,MAAM,MAAM;AAAA,MAE3B,CAAC;AAAA,IACH,GAAG,KAAK,IAAI,OAAO,QAAQ,CAAC;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA,EAKQ,cAAc,MAAoB;AACxC,QAAI;AAEJ,QAAI;AACF,gBAAU,KAAK,MAAM,IAAI;AAAA,IAC3B,QAAQ;AACN,cAAQ,MAAM,8BAA8B,IAAI;AAChD;AAAA,IACF;AAEA,YAAQ,QAAQ,MAAM;AAAA,MACpB,KAAK;AACH,aAAK,YAAY,QAAQ;AACzB,aAAK,cAAc;AAAA,UACjB,WAAW,QAAQ;AAAA,UACnB,OAAO,QAAQ;AAAA,UACf,KAAK,QAAQ;AAAA,UACb,MAAM,QAAQ;AAAA,UACd,MAAM,QAAQ;AAAA,UACd,WAAW,oBAAI,KAAK;AAAA,QACtB;AACA,aAAK,gBAAgB,QAAQ,CAAC,YAAY,QAAQ,KAAK,WAAY,CAAC;AACpE,YAAI,KAAK,cAAc;AACrB,eAAK,aAAa,KAAK,WAAW;AAClC,eAAK,eAAe;AACpB,eAAK,cAAc;AAAA,QACrB;AACA;AAAA,MAEF,KAAK;AACH,aAAK,aAAa,QAAQ,CAAC,YAAY,QAAQ,QAAQ,IAAI,CAAC;AAC5D;AAAA,MAEF,KAAK;AACH,cAAM,WAAW,QAAQ;AACzB,aAAK,aAAa,QAAQ,CAAC,YAAY,QAAQ,QAAQ,CAAC;AACxD,aAAK,YAAY;AACjB,aAAK,cAAc;AACnB;AAAA,MAEF,KAAK;AACH,cAAM,QAAQ,IAAI,MAAM,QAAQ,KAAK;AACrC,aAAK,cAAc,QAAQ,CAAC,YAAY,QAAQ,KAAK,CAAC;AACtD,YAAI,KAAK,aAAa;AACpB,eAAK,YAAY,KAAK;AACtB,eAAK,eAAe;AACpB,eAAK,cAAc;AAAA,QACrB;AACA;AAAA,IACJ;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,UAA2B,CAAC,GAAyB;AACzD,WAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,UAAI,KAAK,UAAU,eAAe,CAAC,KAAK,IAAI;AAC1C,eAAO,IAAI,MAAM,yBAAyB,CAAC;AAC3C;AAAA,MACF;AAEA,UAAI,KAAK,WAAW;AAClB,eAAO,IAAI,MAAM,6CAA6C,CAAC;AAC/D;AAAA,MACF;AAEA,WAAK,eAAe;AACpB,WAAK,cAAc;AAEnB,WAAK,GAAG;AAAA,QACN,KAAK,UAAU;AAAA,UACb,MAAM;AAAA,UACN;AAAA,QACF,CAAC;AAAA,MACH;AAAA,IACF,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,MAAoB;AACxB,QAAI,CAAC,KAAK,MAAM,KAAK,UAAU,aAAa;AAC1C,cAAQ,MAAM,uCAAuC;AACrD;AAAA,IACF;AAEA,QAAI,CAAC,KAAK,WAAW;AACnB,cAAQ,MAAM,2CAA2C;AACzD;AAAA,IACF;AAEA,SAAK,GAAG;AAAA,MACN,KAAK,UAAU;AAAA,QACb,MAAM;AAAA,QACN,WAAW,KAAK;AAAA,QAChB;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,MAAc,MAAoB;AACvC,QAAI,CAAC,KAAK,MAAM,KAAK,UAAU,aAAa;AAC1C,cAAQ,MAAM,wCAAwC;AACtD;AAAA,IACF;AAEA,QAAI,CAAC,KAAK,WAAW;AACnB,cAAQ,MAAM,4CAA4C;AAC1D;AAAA,IACF;AAEA,SAAK,GAAG;AAAA,MACN,KAAK,UAAU;AAAA,QACb,MAAM;AAAA,QACN,WAAW,KAAK;AAAA,QAChB;AAAA,QACA;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,OAAa;AACX,QAAI,CAAC,KAAK,MAAM,KAAK,UAAU,aAAa;AAC1C;AAAA,IACF;AAEA,QAAI,CAAC,KAAK,WAAW;AACnB;AAAA,IACF;AAEA,SAAK,GAAG;AAAA,MACN,KAAK,UAAU;AAAA,QACb,MAAM;AAAA,QACN,WAAW,KAAK;AAAA,MAClB,CAAC;AAAA,IACH;AAEA,SAAK,YAAY;AACjB,SAAK,cAAc;AAAA,EACrB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,UAAU,SAA2B;AACnC,SAAK,gBAAgB,KAAK,OAAO;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA,EAKA,aAAa,SAA2B;AACtC,SAAK,mBAAmB,KAAK,OAAO;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,SAAuC;AAC5C,SAAK,aAAa,KAAK,OAAO;AAAA,EAChC;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,SAAuC;AAC5C,SAAK,aAAa,KAAK,OAAO;AAAA,EAChC;AAAA;AAAA;AAAA;AAAA,EAKA,QAAQ,SAAuC;AAC7C,SAAK,cAAc,KAAK,OAAO;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA,EAKA,UAAU,SAA4C;AACpD,SAAK,gBAAgB,KAAK,OAAO;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,WAA4B;AAC1B,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,cAAuB;AACrB,WAAO,KAAK,UAAU;AAAA,EACxB;AAAA;AAAA;AAAA;AAAA,EAKA,eAA8B;AAC5B,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,iBAAqC;AACnC,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,mBAA4B;AAC1B,WAAO,KAAK,cAAc;AAAA,EAC5B;AACF;",
+  "names": []
+}

package/dist/client/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * x-shell.js client exports
+ */
+export { TerminalClient } from './terminal-client.js';
+export type { ConnectionState } from './terminal-client.js';
+export type { ClientConfig, TerminalOptions, SessionInfo, } from '../shared/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EACV,YAAY,EACZ,eAAe,EACf,WAAW,GACZ,MAAM,oBAAoB,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,5 @@
+/**
+ * x-shell.js client exports
+ */
+export { TerminalClient } from './terminal-client.js';
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}