wicked-crew 0.1.0 → 0.2.0

package/dist/events/terminals.js

@@ -0,0 +1,106 @@
+import { WebSocket } from 'ws';
+/**
+ * Per-terminal WS fan-out (DES-TERMINAL-001 §6). The daemon's single CoreEvent
+ * subscription is the source of truth; this hub routes the `terminalOutput` /
+ * `terminalExited` frames for a given terminal id to the ONE browser socket that
+ * opened it, keyed by id (a `Map<id, socket>`). Raw PTY output arrives
+ * base64-encoded (`bytesB64`); we decode and send it as a BINARY frame so
+ * xterm.js writes the exact bytes — control sequences and multi-byte UTF-8
+ * survive a text-frame round-trip.
+ */
+export class TerminalHub {
+    sockets = new Map();
+    /**
+     * ids whose `terminalExited` we've already routed — so the WS close handler
+     * skips a redundant `closeTerminal` (the engine already reaped that child).
+     */
+    exited = new Set();
+    /** Bind a browser socket to a terminal id (later `terminalOutput` fans out to it). */
+    register(id, socket) {
+        this.sockets.set(id, socket);
+    }
+    /** True once a `terminalExited` frame has been routed for this id. */
+    hasExited(id) {
+        return this.exited.has(id);
+    }
+    /** Drop the socket + exit bookkeeping for a terminal id. */
+    unregister(id) {
+        this.sockets.delete(id);
+        this.exited.delete(id);
+    }
+    /** Live terminal-socket count (diagnostics / tests). */
+    size() {
+        return this.sockets.size;
+    }
+    /**
+     * Route one CoreEvent frame to the terminal socket it belongs to. Called for
+     * EVERY core event; non-terminal frames and frames for an unknown id are no-ops.
+     */
+    route(event) {
+        const id = typeof event.id === 'string' ? event.id : undefined;
+        if (id === undefined)
+            return;
+        const socket = this.sockets.get(id);
+        if (!socket)
+            return;
+        if (event.type === 'terminalOutput') {
+            if (typeof event.bytesB64 === 'string' && socket.readyState === WebSocket.OPEN) {
+                socket.send(Buffer.from(event.bytesB64, 'base64'));
+            }
+        }
+        else if (event.type === 'terminalExited') {
+            // The child is gone. Mark it (so the socket-close handler skips a redundant
+            // closeTerminal), then close the browser socket so xterm stops cleanly.
+            this.exited.add(id);
+            if (socket.readyState === WebSocket.OPEN)
+                socket.close();
+        }
+    }
+}
+/** Normalise a ws frame (Buffer | ArrayBuffer | Buffer[]) to a single Buffer. */
+function toBuffer(data) {
+    if (Buffer.isBuffer(data))
+        return data;
+    if (Array.isArray(data))
+        return Buffer.concat(data);
+    return Buffer.from(data);
+}
+/**
+ * The per-terminal WS channel: `GET /ws/terminals/:id`. Binds the browser socket
+ * to the terminal id in the hub (so `terminalOutput` for that id fans out to it),
+ * forwards every inbound browser frame to the PTY as raw stdin bytes, and closes
+ * the terminal when the socket drops (unless the PTY already exited on its own).
+ */
+export function registerTerminalWs(app, adapter, hub) {
+    app.get('/ws/terminals/:id', { websocket: true }, (socket, req) => {
+        const { id } = req.params;
+        const ws = socket;
+        hub.register(id, ws);
+        // Browser keystrokes (xterm.onData → ws.send): text or binary, both are raw
+        // input bytes for the PTY. Failures (unknown/closed id) are swallowed — the
+        // exit/close path tears the socket down.
+        ws.on('message', (data) => {
+            void adapter.writeTerminal(id, toBuffer(data)).catch(() => {
+                /* terminal gone */
+            });
+        });
+        let torn = false;
+        const teardown = () => {
+            if (torn)
+                return;
+            torn = true;
+            const alreadyExited = hub.hasExited(id);
+            hub.unregister(id);
+            // Socket dropped by the browser (unmount) → close the PTY. Skip when the PTY
+            // already exited (engine reaped it; a second closeTerminal would reject).
+            if (!alreadyExited) {
+                void adapter.closeTerminal(id).catch(() => {
+                    /* already closed / unknown id */
+                });
+            }
+        };
+        ws.on('close', teardown);
+        ws.on('error', teardown);
+    });
+}
+//# sourceMappingURL=terminals.js.map

package/dist/events/terminals.js.map

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