x-shell.js 0.1.0

package/dist/server/terminal-server.js

@@ -0,0 +1,392 @@
+/**
+ * Server-side terminal handler using node-pty
+ *
+ * Manages PTY sessions and WebSocket connections for web-based terminals.
+ */
+import { WebSocketServer } from 'ws';
+import * as path from 'path';
+import * as os from 'os';
+/**
+ * Get platform default shell
+ */
+function getDefaultShell() {
+    if (process.platform === 'win32') {
+        return process.env.COMSPEC || 'cmd.exe';
+    }
+    return process.env.SHELL || '/bin/bash';
+}
+/**
+ * Terminal server class
+ */
+export class TerminalServer {
+    constructor(options = {}) {
+        this.sessions = new Map();
+        this.wss = null;
+        this.pty = null;
+        this.cleanupInterval = null;
+        this.config = {
+            allowedShells: options.allowedShells || [getDefaultShell()],
+            allowedPaths: options.allowedPaths || [os.homedir()],
+            defaultShell: options.defaultShell || getDefaultShell(),
+            defaultCwd: options.defaultCwd || os.homedir(),
+            maxSessionsPerClient: options.maxSessionsPerClient || 5,
+            idleTimeout: options.idleTimeout || 30 * 60 * 1000, // 30 minutes
+            path: options.path || '/terminal',
+            verbose: options.verbose || false,
+        };
+        // Start cleanup interval
+        this.cleanupInterval = setInterval(() => this.cleanupSessions(), 60000);
+    }
+    /**
+     * Initialize node-pty (lazy load)
+     */
+    async initPty() {
+        if (this.pty)
+            return;
+        try {
+            // @ts-ignore - node-pty is a peer dependency
+            this.pty = await import('node-pty');
+        }
+        catch (error) {
+            throw new Error('node-pty is required for x-shell. Install it with: npm install node-pty');
+        }
+    }
+    /**
+     * Attach to an existing HTTP server
+     */
+    attach(server) {
+        this.wss = new WebSocketServer({
+            server,
+            path: this.config.path,
+        });
+        this.setupWebSocketServer();
+        this.log(`Terminal WebSocket server listening on ${this.config.path}`);
+    }
+    /**
+     * Start standalone WebSocket server
+     */
+    listen(port) {
+        this.wss = new WebSocketServer({ port });
+        this.setupWebSocketServer();
+        this.log(`Terminal WebSocket server listening on port ${port}`);
+    }
+    /**
+     * Setup WebSocket server event handlers
+     */
+    setupWebSocketServer() {
+        if (!this.wss)
+            return;
+        this.wss.on('connection', async (ws, req) => {
+            this.log(`Client connected from ${req.socket.remoteAddress}`);
+            await this.handleConnection(ws, req);
+        });
+    }
+    /**
+     * Handle WebSocket connection
+     */
+    async handleConnection(ws, req) {
+        // Load node-pty
+        try {
+            await this.initPty();
+        }
+        catch (error) {
+            this.sendError(ws, error.message);
+            ws.close();
+            return;
+        }
+        // Handle messages
+        ws.on('message', (data) => {
+            try {
+                const message = JSON.parse(data.toString());
+                this.handleMessage(ws, message);
+            }
+            catch (error) {
+                this.log(`Invalid message: ${error}`, 'error');
+            }
+        });
+        ws.on('close', () => {
+            this.log('Client disconnected');
+            // Clean up sessions for this WebSocket
+            for (const [sessionId, session] of this.sessions.entries()) {
+                if (session.ws === ws) {
+                    this.closeSession(sessionId);
+                }
+            }
+        });
+        ws.on('error', (error) => {
+            this.log(`WebSocket error: ${error.message}`, 'error');
+        });
+    }
+    /**
+     * Handle message from client
+     */
+    handleMessage(ws, message) {
+        switch (message.type) {
+            case 'spawn':
+                this.spawnSession(ws, message.options || {});
+                break;
+            case 'data':
+                if (message.sessionId) {
+                    this.writeToSession(message.sessionId, message.data);
+                }
+                break;
+            case 'resize':
+                if (message.sessionId) {
+                    this.resizeSession(message.sessionId, message.cols, message.rows);
+                }
+                break;
+            case 'close':
+                if (message.sessionId) {
+                    this.closeSession(message.sessionId);
+                }
+                break;
+            default:
+                this.log(`Unknown message type: ${message.type}`, 'warn');
+        }
+    }
+    /**
+     * Validate shell path
+     */
+    isShellAllowed(shell) {
+        if (this.config.allowedShells.length === 0)
+            return true;
+        const normalizedShell = path.normalize(shell);
+        const shellBasename = path.basename(normalizedShell).toLowerCase();
+        return this.config.allowedShells.some((allowedShell) => {
+            const normalizedAllowed = path.normalize(allowedShell);
+            const allowedBasename = path.basename(normalizedAllowed).toLowerCase();
+            return (normalizedShell === normalizedAllowed ||
+                shellBasename === allowedBasename);
+        });
+    }
+    /**
+     * Validate working directory
+     */
+    isCwdAllowed(cwd) {
+        if (this.config.allowedPaths.length === 0)
+            return true;
+        const normalizedCwd = path.normalize(path.resolve(cwd));
+        return this.config.allowedPaths.some((allowedPath) => normalizedCwd.startsWith(path.normalize(path.resolve(allowedPath))));
+    }
+    /**
+     * Spawn a new terminal session
+     */
+    spawnSession(ws, options) {
+        const shell = options.shell || this.config.defaultShell;
+        const cwd = options.cwd || this.config.defaultCwd;
+        const cols = options.cols || 80;
+        const rows = options.rows || 24;
+        const env = options.env || {};
+        // Count sessions for this client
+        let clientSessions = 0;
+        for (const session of this.sessions.values()) {
+            if (session.ws === ws)
+                clientSessions++;
+        }
+        if (clientSessions >= this.config.maxSessionsPerClient) {
+            this.sendError(ws, `Maximum sessions (${this.config.maxSessionsPerClient}) reached`);
+            return;
+        }
+        // Validate shell
+        if (!this.isShellAllowed(shell)) {
+            this.sendError(ws, `Shell not allowed: ${shell}. Allowed: ${this.config.allowedShells.join(', ')}`);
+            return;
+        }
+        // Validate cwd
+        if (!this.isCwdAllowed(cwd)) {
+            this.sendError(ws, `Working directory not allowed: ${cwd}`);
+            return;
+        }
+        try {
+            // Spawn PTY
+            const ptyProcess = this.pty.spawn(shell, [], {
+                name: 'xterm-256color',
+                cols,
+                rows,
+                cwd,
+                env: { ...process.env, ...env },
+            });
+            const sessionId = `term-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+            const now = new Date();
+            // Store session
+            const session = {
+                id: sessionId,
+                pty: ptyProcess,
+                ws,
+                shell,
+                cwd,
+                cols,
+                rows,
+                createdAt: now,
+                lastActivity: now,
+            };
+            this.sessions.set(sessionId, session);
+            // Handle PTY output
+            ptyProcess.onData((data) => {
+                session.lastActivity = new Date();
+                ws.send(JSON.stringify({
+                    type: 'data',
+                    sessionId,
+                    data,
+                }));
+            });
+            // Handle PTY exit
+            ptyProcess.onExit(({ exitCode }) => {
+                ws.send(JSON.stringify({
+                    type: 'exit',
+                    sessionId,
+                    exitCode,
+                }));
+                this.sessions.delete(sessionId);
+                this.log(`Session exited: ${sessionId} (code: ${exitCode})`);
+            });
+            // Notify client
+            ws.send(JSON.stringify({
+                type: 'spawned',
+                sessionId,
+                shell,
+                cwd,
+                cols,
+                rows,
+            }));
+            this.log(`Session spawned: ${sessionId} (shell: ${shell}, cwd: ${cwd})`);
+        }
+        catch (error) {
+            this.log(`Failed to spawn session: ${error}`, 'error');
+            this.sendError(ws, error.message);
+        }
+    }
+    /**
+     * Write data to session
+     */
+    writeToSession(sessionId, data) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            this.log(`Session not found: ${sessionId}`, 'warn');
+            return;
+        }
+        session.lastActivity = new Date();
+        session.pty.write(data);
+    }
+    /**
+     * Resize session
+     */
+    resizeSession(sessionId, cols, rows) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            this.log(`Session not found: ${sessionId}`, 'warn');
+            return;
+        }
+        session.cols = cols;
+        session.rows = rows;
+        session.pty.resize(cols, rows);
+    }
+    /**
+     * Close session
+     */
+    closeSession(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return;
+        try {
+            session.pty.kill();
+        }
+        catch (error) {
+            this.log(`Error killing PTY: ${error}`, 'error');
+        }
+        this.sessions.delete(sessionId);
+        this.log(`Session closed: ${sessionId}`);
+    }
+    /**
+     * Clean up inactive sessions
+     */
+    cleanupSessions() {
+        if (this.config.idleTimeout === 0)
+            return;
+        const now = Date.now();
+        for (const [sessionId, session] of this.sessions.entries()) {
+            const idleTime = now - session.lastActivity.getTime();
+            if (idleTime > this.config.idleTimeout) {
+                this.log(`Closing inactive session: ${sessionId}`);
+                session.ws.send(JSON.stringify({
+                    type: 'exit',
+                    sessionId,
+                    exitCode: -1,
+                }));
+                this.closeSession(sessionId);
+            }
+        }
+    }
+    /**
+     * Send error message to client
+     */
+    sendError(ws, error, sessionId) {
+        ws.send(JSON.stringify({
+            type: 'error',
+            sessionId,
+            error,
+        }));
+    }
+    /**
+     * Log message
+     */
+    log(message, level = 'info') {
+        if (!this.config.verbose && level === 'info')
+            return;
+        const prefix = '[x-shell]';
+        switch (level) {
+            case 'error':
+                console.error(`${prefix} ${message}`);
+                break;
+            case 'warn':
+                console.warn(`${prefix} ${message}`);
+                break;
+            default:
+                console.log(`${prefix} ${message}`);
+        }
+    }
+    /**
+     * Get all active sessions
+     */
+    getSessions() {
+        return Array.from(this.sessions.values()).map((session) => ({
+            sessionId: session.id,
+            shell: session.shell,
+            cwd: session.cwd,
+            cols: session.cols,
+            rows: session.rows,
+            createdAt: session.createdAt,
+        }));
+    }
+    /**
+     * Close all sessions and stop server
+     */
+    close() {
+        // Clear cleanup interval
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+        // Close all sessions
+        for (const sessionId of this.sessions.keys()) {
+            this.closeSession(sessionId);
+        }
+        // Close WebSocket server
+        if (this.wss) {
+            this.wss.close();
+            this.wss = null;
+        }
+        this.log('Terminal server closed');
+    }
+}
+/**
+ * Express middleware to attach terminal server
+ */
+export function createTerminalMiddleware(options = {}) {
+    const server = new TerminalServer(options);
+    return {
+        server,
+        attach: (httpServer) => server.attach(httpServer),
+    };
+}
+//# sourceMappingURL=terminal-server.js.map

package/dist/server/terminal-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-server.js","sourceRoot":"","sources":["../../src/server/terminal-server.ts"],"names":[],"mappings":"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"}

package/dist/shared/types.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Shared types for x-shell.js
+ */
+/**
+ * Terminal spawn options
+ */
+export interface TerminalOptions {
+    /** Shell to use (e.g., 'bash', 'zsh', 'cmd.exe', 'powershell.exe') */
+    shell?: string;
+    /** Working directory */
+    cwd?: string;
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Initial columns (default: 80) */
+    cols?: number;
+    /** Initial rows (default: 24) */
+    rows?: number;
+}
+/**
+ * Server configuration
+ */
+export interface ServerConfig {
+    /** Allowed shells (empty = all allowed) */
+    allowedShells?: string[];
+    /** Allowed working directories (empty = all allowed) */
+    allowedPaths?: string[];
+    /** Default shell if not specified by client */
+    defaultShell?: string;
+    /** Default working directory */
+    defaultCwd?: string;
+    /** Maximum concurrent sessions per client */
+    maxSessionsPerClient?: number;
+    /** Session idle timeout in ms (0 = no timeout) */
+    idleTimeout?: number;
+}
+/**
+ * WebSocket message types
+ */
+export type MessageType = 'spawn' | 'data' | 'resize' | 'close' | 'error' | 'exit' | 'spawned';
+/**
+ * Base message structure
+ */
+export interface BaseMessage {
+    type: MessageType;
+    sessionId?: string;
+}
+/**
+ * Spawn request from client
+ */
+export interface SpawnMessage extends BaseMessage {
+    type: 'spawn';
+    options?: TerminalOptions;
+}
+/**
+ * Spawned response from server
+ */
+export interface SpawnedMessage extends BaseMessage {
+    type: 'spawned';
+    sessionId: string;
+    shell: string;
+    cwd: string;
+    cols: number;
+    rows: number;
+}
+/**
+ * Data message (bidirectional)
+ */
+export interface DataMessage extends BaseMessage {
+    type: 'data';
+    sessionId: string;
+    data: string;
+}
+/**
+ * Resize request from client
+ */
+export interface ResizeMessage extends BaseMessage {
+    type: 'resize';
+    sessionId: string;
+    cols: number;
+    rows: number;
+}
+/**
+ * Close request from client
+ */
+export interface CloseMessage extends BaseMessage {
+    type: 'close';
+    sessionId: string;
+}
+/**
+ * Error message from server
+ */
+export interface ErrorMessage extends BaseMessage {
+    type: 'error';
+    sessionId?: string;
+    error: string;
+}
+/**
+ * Exit message from server
+ */
+export interface ExitMessage extends BaseMessage {
+    type: 'exit';
+    sessionId: string;
+    exitCode: number;
+}
+/**
+ * Union of all message types
+ */
+export type TerminalMessage = SpawnMessage | SpawnedMessage | DataMessage | ResizeMessage | CloseMessage | ErrorMessage | ExitMessage;
+/**
+ * Client configuration
+ */
+export interface ClientConfig {
+    /** WebSocket URL */
+    url: string;
+    /** Reconnect on disconnect (default: true) */
+    reconnect?: boolean;
+    /** Maximum reconnection attempts (default: 10) */
+    maxReconnectAttempts?: number;
+    /** Initial reconnection delay in ms (default: 1000) */
+    reconnectDelay?: number;
+}
+/**
+ * Terminal session info
+ */
+export interface SessionInfo {
+    sessionId: string;
+    shell: string;
+    cwd: string;
+    cols: number;
+    rows: number;
+    createdAt: Date;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/shared/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"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"}

package/dist/shared/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared types for x-shell.js
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/shared/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}