x-shell.js 0.1.0

package/dist/client/terminal-client.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Terminal client for connecting to x-shell server
+ *
+ * Example usage:
+ * ```typescript
+ * import { TerminalClient } from 'x-shell.js/client';
+ *
+ * const client = new TerminalClient({ url: 'ws://localhost:3000/terminal' });
+ * await client.connect();
+ *
+ * client.onData((data) => console.log(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);
+ * client.kill();
+ * ```
+ */
+import type { ClientConfig, TerminalOptions, SessionInfo } from '../shared/types.js';
+/**
+ * Connection state
+ */
+export type ConnectionState = 'disconnected' | 'connecting' | 'connected';
+/**
+ * Terminal client class
+ */
+export declare class TerminalClient {
+    private config;
+    private ws;
+    private state;
+    private sessionId;
+    private sessionInfo;
+    private reconnectAttempts;
+    private reconnectTimeout;
+    private connectHandlers;
+    private disconnectHandlers;
+    private dataHandlers;
+    private exitHandlers;
+    private errorHandlers;
+    private spawnedHandlers;
+    private spawnResolve;
+    private spawnReject;
+    constructor(config: ClientConfig);
+    /**
+     * Connect to the terminal server
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the terminal server
+     */
+    disconnect(): void;
+    /**
+     * Schedule a reconnection attempt
+     */
+    private scheduleReconnect;
+    /**
+     * Handle incoming message
+     */
+    private handleMessage;
+    /**
+     * Spawn a terminal session
+     */
+    spawn(options?: TerminalOptions): Promise<SessionInfo>;
+    /**
+     * Write data to the terminal
+     */
+    write(data: string): void;
+    /**
+     * Resize the terminal
+     */
+    resize(cols: number, rows: number): void;
+    /**
+     * Kill the terminal session
+     */
+    kill(): void;
+    /**
+     * Called when connected to server
+     */
+    onConnect(handler: () => void): void;
+    /**
+     * Called when disconnected from server
+     */
+    onDisconnect(handler: () => void): void;
+    /**
+     * Called when data is received from the terminal
+     */
+    onData(handler: (data: string) => void): void;
+    /**
+     * Called when the terminal session exits
+     */
+    onExit(handler: (code: number) => void): void;
+    /**
+     * Called when an error occurs
+     */
+    onError(handler: (error: Error) => void): void;
+    /**
+     * Called when a session is spawned
+     */
+    onSpawned(handler: (info: SessionInfo) => void): void;
+    /**
+     * Get current connection state
+     */
+    getState(): ConnectionState;
+    /**
+     * Check if connected
+     */
+    isConnected(): boolean;
+    /**
+     * Get current session ID
+     */
+    getSessionId(): string | null;
+    /**
+     * Get current session info
+     */
+    getSessionInfo(): SessionInfo | null;
+    /**
+     * Check if a session is active
+     */
+    hasActiveSession(): boolean;
+}
+//# sourceMappingURL=terminal-client.d.ts.map

package/dist/client/terminal-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-client.d.ts","sourceRoot":"","sources":["../../src/client/terminal-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EAEf,WAAW,EACZ,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,CAAC;AAE1E;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,gBAAgB,CAA8C;IAGtE,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,kBAAkB,CAAsB;IAChD,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,eAAe,CAAuC;IAG9D,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,WAAW,CAAyC;gBAEhD,MAAM,EAAE,YAAY;IAShC;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAuDxB;;OAEG;IACH,UAAU,IAAI,IAAI;IAkBlB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAezB;;OAEG;IACH,OAAO,CAAC,aAAa;IAoDrB;;OAEG;IACH,KAAK,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,WAAW,CAAC;IAwB1D;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAoBzB;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAqBxC;;OAEG;IACH,IAAI,IAAI,IAAI;IAwBZ;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIpC;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIvC;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAI7C;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAI7C;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAI9C;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;IAQrD;;OAEG;IACH,QAAQ,IAAI,eAAe;IAI3B;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,YAAY,IAAI,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACH,cAAc,IAAI,WAAW,GAAG,IAAI;IAIpC;;OAEG;IACH,gBAAgB,IAAI,OAAO;CAG5B"}

package/dist/client/terminal-client.js

@@ -0,0 +1,328 @@
+/**
+ * Terminal client for connecting to x-shell server
+ *
+ * Example usage:
+ * ```typescript
+ * import { TerminalClient } from 'x-shell.js/client';
+ *
+ * const client = new TerminalClient({ url: 'ws://localhost:3000/terminal' });
+ * await client.connect();
+ *
+ * client.onData((data) => console.log(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);
+ * client.kill();
+ * ```
+ */
+/**
+ * Terminal client class
+ */
+export class TerminalClient {
+    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 ?? 1000,
+        };
+    }
+    /**
+     * 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());
+                }
+                // Attempt reconnection
+                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; // Prevent auto-reconnect
+        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 = 30000; // 30 seconds max
+        this.reconnectTimeout = setTimeout(() => {
+            this.reconnectTimeout = null;
+            this.reconnectAttempts++;
+            this.connect().catch(() => {
+                // Error handled by onclose
+            });
+        }, 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: 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;
+    }
+}
+//# sourceMappingURL=terminal-client.js.map

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

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

package/dist/server/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * x-shell.js server exports
+ */
+export { TerminalServer, createTerminalMiddleware } from './terminal-server.js';
+export type { TerminalServerOptions } from './terminal-server.js';
+export type { ServerConfig, TerminalOptions, SessionInfo, } from '../shared/types.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/server/index.js

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

package/dist/server/index.js.map

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

package/dist/server/terminal-server.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Server-side terminal handler using node-pty
+ *
+ * Manages PTY sessions and WebSocket connections for web-based terminals.
+ */
+import type { Server as HttpServer } from 'http';
+import type { ServerConfig, SessionInfo } from '../shared/types.js';
+/**
+ * Terminal server options
+ */
+export interface TerminalServerOptions extends ServerConfig {
+    /** HTTP server to attach to (for upgrade handling) */
+    server?: HttpServer;
+    /** WebSocket path (default: '/terminal') */
+    path?: string;
+    /** Port for standalone WebSocket server */
+    port?: number;
+    /** Enable verbose logging */
+    verbose?: boolean;
+}
+/**
+ * Terminal server class
+ */
+export declare class TerminalServer {
+    private config;
+    private sessions;
+    private wss;
+    private pty;
+    private cleanupInterval;
+    constructor(options?: TerminalServerOptions);
+    /**
+     * Initialize node-pty (lazy load)
+     */
+    private initPty;
+    /**
+     * Attach to an existing HTTP server
+     */
+    attach(server: HttpServer): void;
+    /**
+     * Start standalone WebSocket server
+     */
+    listen(port: number): void;
+    /**
+     * Setup WebSocket server event handlers
+     */
+    private setupWebSocketServer;
+    /**
+     * Handle WebSocket connection
+     */
+    private handleConnection;
+    /**
+     * Handle message from client
+     */
+    private handleMessage;
+    /**
+     * Validate shell path
+     */
+    private isShellAllowed;
+    /**
+     * Validate working directory
+     */
+    private isCwdAllowed;
+    /**
+     * Spawn a new terminal session
+     */
+    private spawnSession;
+    /**
+     * Write data to session
+     */
+    private writeToSession;
+    /**
+     * Resize session
+     */
+    private resizeSession;
+    /**
+     * Close session
+     */
+    private closeSession;
+    /**
+     * Clean up inactive sessions
+     */
+    private cleanupSessions;
+    /**
+     * Send error message to client
+     */
+    private sendError;
+    /**
+     * Log message
+     */
+    private log;
+    /**
+     * Get all active sessions
+     */
+    getSessions(): SessionInfo[];
+    /**
+     * Close all sessions and stop server
+     */
+    close(): void;
+}
+/**
+ * Express middleware to attach terminal server
+ */
+export declare function createTerminalMiddleware(options?: Omit<TerminalServerOptions, 'server' | 'port'>): {
+    server: TerminalServer;
+    attach: (httpServer: HttpServer) => void;
+};
+//# sourceMappingURL=terminal-server.d.ts.map

package/dist/server/terminal-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-server.d.ts","sourceRoot":"","sources":["../../src/server/terminal-server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAC;AACjD,OAAO,KAAK,EACV,YAAY,EAGZ,WAAW,EACZ,MAAM,oBAAoB,CAAC;AA2B5B;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,YAAY;IACzD,sDAAsD;IACtD,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAA2D;IACzE,OAAO,CAAC,QAAQ,CAAsC;IACtD,OAAO,CAAC,GAAG,CAAgC;IAC3C,OAAO,CAAC,GAAG,CAAa;IACxB,OAAO,CAAC,eAAe,CAA+C;gBAE1D,OAAO,GAAE,qBAA0B;IAgB/C;;OAEG;YACW,OAAO;IAarB;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAUhC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAS5B;;OAEG;YACW,gBAAgB;IAmC9B;;OAEG;IACH,OAAO,CAAC,aAAa;IA6BrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAgBtB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,OAAO,CAAC,YAAY;IA2GpB;;OAEG;IACH,OAAO,CAAC,cAAc;IAWtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;IACH,OAAO,CAAC,eAAe;IAoBvB;;OAEG;IACH,OAAO,CAAC,SAAS;IAUjB;;OAEG;IACH,OAAO,CAAC,GAAG;IAgBX;;OAEG;IACH,WAAW,IAAI,WAAW,EAAE;IAW5B;;OAEG;IACH,KAAK,IAAI,IAAI;CAoBd;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,IAAI,CAAC,qBAAqB,EAAE,QAAQ,GAAG,MAAM,CAAM,GAC3D;IACD,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;CAC1C,CAMA"}