@quenty/studio-bridge 0.7.1 → 0.9.0

package/dist/src/bridge/internal/transport-client.js

@@ -0,0 +1,146 @@
+/**
+ * Low-level WebSocket client with automatic reconnection and exponential
+ * backoff. Handles connection, message send/receive, and reconnection
+ * on disconnect. No business logic -- it is a dumb pipe.
+ */
+import { EventEmitter } from 'events';
+import { WebSocket } from 'ws';
+const DEFAULT_MAX_RECONNECT_ATTEMPTS = 10;
+const DEFAULT_INITIAL_BACKOFF_MS = 1_000;
+const DEFAULT_MAX_BACKOFF_MS = 30_000;
+export class TransportClient extends EventEmitter {
+    _ws;
+    _url = '';
+    _isConnected = false;
+    _reconnectAttempt = 0;
+    _reconnectTimer;
+    _options = {
+        maxReconnectAttempts: DEFAULT_MAX_RECONNECT_ATTEMPTS,
+        initialBackoffMs: DEFAULT_INITIAL_BACKOFF_MS,
+        maxBackoffMs: DEFAULT_MAX_BACKOFF_MS,
+    };
+    _intentionalClose = false;
+    /**
+     * Connect to the given WebSocket URL. Resolves when the connection is
+     * established. Rejects if the initial connection fails.
+     */
+    async connectAsync(url, options) {
+        this._url = url;
+        this._intentionalClose = false;
+        if (options) {
+            this._options = {
+                maxReconnectAttempts: options.maxReconnectAttempts ?? DEFAULT_MAX_RECONNECT_ATTEMPTS,
+                initialBackoffMs: options.initialBackoffMs ?? DEFAULT_INITIAL_BACKOFF_MS,
+                maxBackoffMs: options.maxBackoffMs ?? DEFAULT_MAX_BACKOFF_MS,
+            };
+        }
+        await this._connectInternalAsync();
+    }
+    /**
+     * Disconnect from the server. Does not attempt reconnection.
+     */
+    disconnect() {
+        this._intentionalClose = true;
+        this._clearReconnectTimer();
+        if (this._ws) {
+            this._ws.removeAllListeners();
+            if (this._ws.readyState === WebSocket.OPEN ||
+                this._ws.readyState === WebSocket.CONNECTING) {
+                this._ws.close();
+            }
+            this._ws = undefined;
+        }
+        if (this._isConnected) {
+            this._isConnected = false;
+            this.emit('disconnected');
+        }
+    }
+    /**
+     * Send a string message over the WebSocket.
+     */
+    send(data) {
+        if (!this._ws || this._ws.readyState !== WebSocket.OPEN) {
+            throw new Error('TransportClient is not connected');
+        }
+        this._ws.send(data);
+    }
+    /** Whether the client is currently connected. */
+    get isConnected() {
+        return this._isConnected;
+    }
+    _connectInternalAsync() {
+        return new Promise((resolve, reject) => {
+            const ws = new WebSocket(this._url);
+            this._ws = ws;
+            const onOpen = () => {
+                cleanup();
+                this._isConnected = true;
+                this._reconnectAttempt = 0;
+                this._setupMessageHandler(ws);
+                this.emit('connected');
+                resolve();
+            };
+            const onError = (err) => {
+                cleanup();
+                reject(err);
+            };
+            const onClose = () => {
+                cleanup();
+                reject(new Error(`WebSocket closed before connection to ${this._url}`));
+            };
+            const cleanup = () => {
+                ws.off('open', onOpen);
+                ws.off('error', onError);
+                ws.off('close', onClose);
+            };
+            ws.on('open', onOpen);
+            ws.on('error', onError);
+            ws.on('close', onClose);
+        });
+    }
+    _setupMessageHandler(ws) {
+        ws.on('message', (raw) => {
+            const data = typeof raw === 'string' ? raw : raw.toString('utf-8');
+            this.emit('message', data);
+        });
+        ws.on('close', () => {
+            this._isConnected = false;
+            this.emit('disconnected');
+            if (!this._intentionalClose) {
+                this._scheduleReconnect();
+            }
+        });
+        ws.on('error', (err) => {
+            this.emit('error', err);
+        });
+    }
+    _scheduleReconnect() {
+        if (this._reconnectAttempt >= this._options.maxReconnectAttempts) {
+            this.emit('error', new Error(`Failed to reconnect after ${this._options.maxReconnectAttempts} attempts`));
+            return;
+        }
+        const backoff = Math.min(this._options.initialBackoffMs * Math.pow(2, this._reconnectAttempt), this._options.maxBackoffMs);
+        this._reconnectAttempt++;
+        this._reconnectTimer = setTimeout(async () => {
+            try {
+                await this._connectInternalAsync();
+            }
+            catch {
+                // _connectInternalAsync rejected -- the close handler in
+                // _setupMessageHandler will fire and schedule the next retry
+                // IF the connection actually opened and then closed. But if
+                // the connection never opened, we need to schedule manually.
+                if (!this._isConnected && !this._intentionalClose) {
+                    this._scheduleReconnect();
+                }
+            }
+        }, backoff);
+    }
+    _clearReconnectTimer() {
+        if (this._reconnectTimer !== undefined) {
+            clearTimeout(this._reconnectTimer);
+            this._reconnectTimer = undefined;
+        }
+    }
+}
+//# sourceMappingURL=transport-client.js.map

package/dist/src/bridge/internal/transport-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-client.js","sourceRoot":"","sources":["../../../../src/bridge/internal/transport-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAW/B,MAAM,8BAA8B,GAAG,EAAE,CAAC;AAC1C,MAAM,0BAA0B,GAAG,KAAK,CAAC;AACzC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAEtC,MAAM,OAAO,eAAgB,SAAQ,YAAY;IACvC,GAAG,CAAwB;IAC3B,IAAI,GAAW,EAAE,CAAC;IAClB,YAAY,GAAG,KAAK,CAAC;IACrB,iBAAiB,GAAG,CAAC,CAAC;IACtB,eAAe,CAA4C;IAC3D,QAAQ,GAAqC;QACnD,oBAAoB,EAAE,8BAA8B;QACpD,gBAAgB,EAAE,0BAA0B;QAC5C,YAAY,EAAE,sBAAsB;KACrC,CAAC;IACM,iBAAiB,GAAG,KAAK,CAAC;IAElC;;;OAGG;IACH,KAAK,CAAC,YAAY,CAChB,GAAW,EACX,OAAgC;QAEhC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC;QAE/B,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,QAAQ,GAAG;gBACd,oBAAoB,EAClB,OAAO,CAAC,oBAAoB,IAAI,8BAA8B;gBAChE,gBAAgB,EACd,OAAO,CAAC,gBAAgB,IAAI,0BAA0B;gBACxD,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,sBAAsB;aAC7D,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAC9B,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAE5B,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;YAC9B,IACE,IAAI,CAAC,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI;gBACtC,IAAI,CAAC,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,UAAU,EAC5C,CAAC;gBACD,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YACnB,CAAC;YACD,IAAI,CAAC,GAAG,GAAG,SAAS,CAAC;QACvB,CAAC;QAED,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;YAC1B,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,IAAY;QACf,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,iDAAiD;IACjD,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAEO,qBAAqB;QAC3B,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;YAEd,MAAM,MAAM,GAAG,GAAG,EAAE;gBAClB,OAAO,EAAE,CAAC;gBACV,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;gBACzB,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC;gBAC3B,IAAI,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;gBAC9B,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBACvB,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC;YAEF,MAAM,OAAO,GAAG,CAAC,GAAU,EAAE,EAAE;gBAC7B,OAAO,EAAE,CAAC;gBACV,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC,CAAC;YAEF,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,OAAO,EAAE,CAAC;gBACV,MAAM,CAAC,IAAI,KAAK,CAAC,yCAAyC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAC1E,CAAC,CAAC;YAEF,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACvB,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACzB,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC3B,CAAC,CAAC;YAEF,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACtB,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACxB,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,oBAAoB,CAAC,EAAa;QACxC,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE;YACvB,MAAM,IAAI,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACnE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YAClB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;YAC1B,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAE1B,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBAC5B,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACrB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,kBAAkB;QACxB,IAAI,IAAI,CAAC,iBAAiB,IAAI,IAAI,CAAC,QAAQ,CAAC,oBAAoB,EAAE,CAAC;YACjE,IAAI,CAAC,IAAI,CACP,OAAO,EACP,IAAI,KAAK,CACP,6BAA6B,IAAI,CAAC,QAAQ,CAAC,oBAAoB,WAAW,CAC3E,CACF,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CACtB,IAAI,CAAC,QAAQ,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,iBAAiB,CAAC,EACpE,IAAI,CAAC,QAAQ,CAAC,YAAY,CAC3B,CAAC;QAEF,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,IAAI,CAAC,eAAe,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE;YAC3C,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;YACrC,CAAC;YAAC,MAAM,CAAC;gBACP,yDAAyD;gBACzD,6DAA6D;gBAC7D,4DAA4D;gBAC5D,6DAA6D;gBAC7D,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;oBAClD,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBAC5B,CAAC;YACH,CAAC;QACH,CAAC,EAAE,OAAO,CAAC,CAAC;IACd,CAAC;IAEO,oBAAoB;QAC1B,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YACvC,YAAY,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACnC,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;QACnC,CAAC;IACH,CAAC;CACF"}

package/dist/src/bridge/internal/transport-client.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Unit tests for TransportClient -- validates connection, message
+ * send/receive, disconnect handling, and reconnection with backoff.
+ */
+export {};
+//# sourceMappingURL=transport-client.test.d.ts.map

package/dist/src/bridge/internal/transport-client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-client.test.d.ts","sourceRoot":"","sources":["../../../../src/bridge/internal/transport-client.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/src/bridge/internal/transport-client.test.js

@@ -0,0 +1,176 @@
+/**
+ * Unit tests for TransportClient -- validates connection, message
+ * send/receive, disconnect handling, and reconnection with backoff.
+ */
+import { describe, it, expect, vi, afterEach, beforeEach } from 'vitest';
+import { WebSocketServer } from 'ws';
+import { TransportClient } from './transport-client.js';
+async function createTestServer() {
+    const connections = [];
+    const wss = new WebSocketServer({ port: 0 });
+    const port = await new Promise((resolve) => {
+        wss.on('listening', () => {
+            const addr = wss.address();
+            if (typeof addr === 'object' && addr !== null) {
+                resolve(addr.port);
+            }
+        });
+    });
+    wss.on('connection', (ws) => {
+        connections.push(ws);
+    });
+    return { wss, port, connections };
+}
+async function closeServer(wss) {
+    for (const client of wss.clients) {
+        client.terminate();
+    }
+    await new Promise((resolve) => {
+        wss.close(() => resolve());
+    });
+}
+describe('TransportClient', () => {
+    let server;
+    let client;
+    afterEach(async () => {
+        if (client) {
+            client.disconnect();
+            client = undefined;
+        }
+        if (server) {
+            await closeServer(server.wss);
+            server = undefined;
+        }
+    });
+    describe('connectAsync', () => {
+        it('connects to a WebSocket server', async () => {
+            server = await createTestServer();
+            client = new TransportClient();
+            await client.connectAsync(`ws://localhost:${server.port}`);
+            expect(client.isConnected).toBe(true);
+        });
+        it('rejects when server is not available', async () => {
+            client = new TransportClient();
+            await expect(client.connectAsync('ws://localhost:19999')).rejects.toThrow();
+        });
+        it('emits connected event', async () => {
+            server = await createTestServer();
+            client = new TransportClient();
+            const listener = vi.fn();
+            client.on('connected', listener);
+            await client.connectAsync(`ws://localhost:${server.port}`);
+            expect(listener).toHaveBeenCalledTimes(1);
+        });
+    });
+    describe('send and receive', () => {
+        it('sends a message to the server', async () => {
+            server = await createTestServer();
+            client = new TransportClient();
+            await client.connectAsync(`ws://localhost:${server.port}`);
+            // Wait for server to register the connection
+            await new Promise((r) => setTimeout(r, 50));
+            const received = new Promise((resolve) => {
+                server.connections[0].on('message', (raw) => {
+                    resolve(typeof raw === 'string' ? raw : raw.toString('utf-8'));
+                });
+            });
+            client.send('hello-server');
+            expect(await received).toBe('hello-server');
+        });
+        it('receives messages from the server', async () => {
+            server = await createTestServer();
+            client = new TransportClient();
+            await client.connectAsync(`ws://localhost:${server.port}`);
+            await new Promise((r) => setTimeout(r, 50));
+            const received = new Promise((resolve) => {
+                client.on('message', resolve);
+            });
+            server.connections[0].send('hello-client');
+            expect(await received).toBe('hello-client');
+        });
+        it('throws when sending on a disconnected client', async () => {
+            client = new TransportClient();
+            expect(() => client.send('test')).toThrow('TransportClient is not connected');
+        });
+    });
+    describe('disconnect', () => {
+        it('disconnects cleanly', async () => {
+            server = await createTestServer();
+            client = new TransportClient();
+            await client.connectAsync(`ws://localhost:${server.port}`);
+            client.disconnect();
+            expect(client.isConnected).toBe(false);
+        });
+        it('emits disconnected event', async () => {
+            server = await createTestServer();
+            client = new TransportClient();
+            await client.connectAsync(`ws://localhost:${server.port}`);
+            const listener = vi.fn();
+            client.on('disconnected', listener);
+            client.disconnect();
+            expect(listener).toHaveBeenCalledTimes(1);
+        });
+        it('emits disconnected when server closes connection', async () => {
+            server = await createTestServer();
+            client = new TransportClient();
+            await client.connectAsync(`ws://localhost:${server.port}`, {
+                maxReconnectAttempts: 0,
+            });
+            // Suppress the unhandled error event from reconnection failure
+            client.on('error', () => { });
+            await new Promise((r) => setTimeout(r, 50));
+            const disconnected = new Promise((resolve) => {
+                client.on('disconnected', resolve);
+            });
+            // Close from server side
+            server.connections[0].close();
+            await disconnected;
+            expect(client.isConnected).toBe(false);
+        });
+    });
+    describe('reconnection', () => {
+        beforeEach(() => {
+            vi.useFakeTimers();
+        });
+        afterEach(() => {
+            vi.useRealTimers();
+        });
+        it('attempts reconnection after server-initiated disconnect', async () => {
+            vi.useRealTimers(); // Need real timers for initial connect
+            server = await createTestServer();
+            client = new TransportClient();
+            await client.connectAsync(`ws://localhost:${server.port}`, {
+                maxReconnectAttempts: 3,
+                initialBackoffMs: 100,
+                maxBackoffMs: 1000,
+            });
+            await new Promise((r) => setTimeout(r, 50));
+            // Disconnect from server side
+            server.connections[0].close();
+            // Wait for disconnect to register
+            await new Promise((r) => setTimeout(r, 50));
+            expect(client.isConnected).toBe(false);
+            // Wait for first reconnection attempt (100ms backoff)
+            await new Promise((r) => setTimeout(r, 200));
+            // Client should reconnect
+            expect(client.isConnected).toBe(true);
+        });
+        it('does not reconnect after intentional disconnect', async () => {
+            vi.useRealTimers();
+            server = await createTestServer();
+            client = new TransportClient();
+            await client.connectAsync(`ws://localhost:${server.port}`, {
+                maxReconnectAttempts: 3,
+                initialBackoffMs: 50,
+            });
+            const errorListener = vi.fn();
+            client.on('error', errorListener);
+            client.disconnect();
+            // Wait well past the backoff
+            await new Promise((r) => setTimeout(r, 200));
+            // Should not have tried to reconnect (no error events from failed reconnects)
+            expect(client.isConnected).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=transport-client.test.js.map

package/dist/src/bridge/internal/transport-client.test.js.map

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

package/dist/src/bridge/internal/transport-server.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Low-level WebSocket server with path-based routing. Handles HTTP server
+ * creation, port binding, WebSocket upgrade for registered paths, and HTTP
+ * GET for the /health endpoint. No business logic — it is a dumb pipe that
+ * routes connections by URL path.
+ */
+import { type IncomingMessage, type ServerResponse } from 'http';
+import { WebSocket } from 'ws';
+export interface TransportServerOptions {
+    /** Port to bind on. Default: 38741. Use 0 for ephemeral (test-friendly). */
+    port?: number;
+    /** Host to bind on. Default: 'localhost'. */
+    host?: string;
+}
+export type ConnectionHandler = (ws: WebSocket, request: IncomingMessage) => void;
+export type HttpHandler = (req: IncomingMessage, res: ServerResponse) => void;
+export declare class TransportServer {
+    private _httpServer;
+    private _wss;
+    private _port;
+    private _isListening;
+    private readonly _sockets;
+    private readonly _wsHandlers;
+    private readonly _httpHandlers;
+    /**
+     * Start the WebSocket server. Binds to the specified port.
+     * Uses `exclusive: false` for SO_REUSEADDR so the port can be reused
+     * after a crash without waiting for TIME_WAIT.
+     * Returns the actual bound port (important when port: 0 is used).
+     */
+    startAsync(options?: TransportServerOptions): Promise<number>;
+    /**
+     * Stop the server and close all connections.
+     */
+    stopAsync(): Promise<void>;
+    /** The actual port the server is bound to. */
+    get port(): number;
+    /** Whether the server is currently listening. */
+    get isListening(): boolean;
+    /**
+     * Register a handler for WebSocket connections on a specific path.
+     * Paths: '/plugin' for Studio plugins, '/client' for CLI clients.
+     */
+    onConnection(path: string, handler: ConnectionHandler): void;
+    /**
+     * Register an HTTP request handler for a specific path.
+     * Used for '/health' to handle plain HTTP GET requests.
+     */
+    onHttpRequest(path: string, handler: HttpHandler): void;
+    /**
+     * Force-close the server by destroying all open TCP sockets immediately.
+     * Unlike stopAsync(), this does not wait for graceful close handshakes.
+     * Used during host shutdown to release the port as fast as possible.
+     */
+    forceCloseAsync(): Promise<void>;
+    private _parsePath;
+    private _handleHttpRequest;
+}
+//# sourceMappingURL=transport-server.d.ts.map

package/dist/src/bridge/internal/transport-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-server.d.ts","sourceRoot":"","sources":["../../../../src/bridge/internal/transport-server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,cAAc,EAEpB,MAAM,MAAM,CAAC;AAEd,OAAO,EAAmB,SAAS,EAAE,MAAM,IAAI,CAAC;AAGhD,MAAM,WAAW,sBAAsB;IACrC,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,iBAAiB,GAAG,CAC9B,EAAE,EAAE,SAAS,EACb,OAAO,EAAE,eAAe,KACrB,IAAI,CAAC;AACV,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,CAAC;AAK9E,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,IAAI,CAA8B;IAC1C,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAE9C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwC;IACpE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkC;IAEhE;;;;;OAKG;IACG,UAAU,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC;IAoEnE;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAgChC,8CAA8C;IAC9C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,iDAAiD;IACjD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAI5D;;;OAGG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAIvD;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAkCtC,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,kBAAkB;CAY3B"}

package/dist/src/bridge/internal/transport-server.js

@@ -0,0 +1,189 @@
+/**
+ * Low-level WebSocket server with path-based routing. Handles HTTP server
+ * creation, port binding, WebSocket upgrade for registered paths, and HTTP
+ * GET for the /health endpoint. No business logic — it is a dumb pipe that
+ * routes connections by URL path.
+ */
+import { createServer, } from 'http';
+import { WebSocketServer } from 'ws';
+import { URL } from 'url';
+const DEFAULT_PORT = 38741;
+const DEFAULT_HOST = 'localhost';
+export class TransportServer {
+    _httpServer;
+    _wss;
+    _port = 0;
+    _isListening = false;
+    _sockets = new Set();
+    _wsHandlers = new Map();
+    _httpHandlers = new Map();
+    /**
+     * Start the WebSocket server. Binds to the specified port.
+     * Uses `exclusive: false` for SO_REUSEADDR so the port can be reused
+     * after a crash without waiting for TIME_WAIT.
+     * Returns the actual bound port (important when port: 0 is used).
+     */
+    async startAsync(options) {
+        if (this._isListening) {
+            throw new Error('TransportServer is already listening');
+        }
+        const port = options?.port ?? DEFAULT_PORT;
+        const host = options?.host ?? DEFAULT_HOST;
+        this._httpServer = createServer((req, res) => {
+            this._handleHttpRequest(req, res);
+        });
+        // Track all raw TCP sockets so forceCloseAsync() can destroy them
+        this._httpServer.on('connection', (socket) => {
+            this._sockets.add(socket);
+            socket.on('close', () => {
+                this._sockets.delete(socket);
+            });
+        });
+        this._wss = new WebSocketServer({ noServer: true });
+        this._httpServer.on('upgrade', (request, socket, head) => {
+            const pathname = this._parsePath(request);
+            const handler = this._wsHandlers.get(pathname);
+            if (!handler) {
+                socket.write('HTTP/1.1 404 Not Found\r\n\r\n');
+                socket.destroy();
+                return;
+            }
+            this._wss.handleUpgrade(request, socket, head, (ws) => {
+                handler(ws, request);
+            });
+        });
+        return new Promise((resolve, reject) => {
+            const server = this._httpServer;
+            const onError = (err) => {
+                server.off('listening', onListening);
+                if (err.code === 'EADDRINUSE') {
+                    reject(new Error(`Port ${port} is already in use`));
+                }
+                else {
+                    reject(err);
+                }
+            };
+            const onListening = () => {
+                server.off('error', onError);
+                const addr = server.address();
+                if (typeof addr === 'object' && addr !== null) {
+                    this._port = addr.port;
+                }
+                this._isListening = true;
+                resolve(this._port);
+            };
+            server.once('error', onError);
+            server.once('listening', onListening);
+            // SO_REUSEADDR is enabled by default in Node's net module, allowing
+            // the port to be rebound immediately after a process crash without
+            // waiting for TIME_WAIT to expire. This is essential for host failover.
+            server.listen(port, host, undefined, undefined);
+        });
+    }
+    /**
+     * Stop the server and close all connections.
+     */
+    async stopAsync() {
+        if (!this._isListening) {
+            return;
+        }
+        this._isListening = false;
+        // Terminate all WebSocket connections first
+        if (this._wss) {
+            for (const client of this._wss.clients) {
+                client.terminate();
+            }
+        }
+        // Close the WebSocket server
+        if (this._wss) {
+            await new Promise((resolve) => {
+                this._wss.close(() => resolve());
+            });
+            this._wss = undefined;
+        }
+        // Close the HTTP server
+        if (this._httpServer) {
+            await new Promise((resolve) => {
+                this._httpServer.close(() => resolve());
+            });
+            this._httpServer = undefined;
+        }
+        this._port = 0;
+    }
+    /** The actual port the server is bound to. */
+    get port() {
+        return this._port;
+    }
+    /** Whether the server is currently listening. */
+    get isListening() {
+        return this._isListening;
+    }
+    /**
+     * Register a handler for WebSocket connections on a specific path.
+     * Paths: '/plugin' for Studio plugins, '/client' for CLI clients.
+     */
+    onConnection(path, handler) {
+        this._wsHandlers.set(path, handler);
+    }
+    /**
+     * Register an HTTP request handler for a specific path.
+     * Used for '/health' to handle plain HTTP GET requests.
+     */
+    onHttpRequest(path, handler) {
+        this._httpHandlers.set(path, handler);
+    }
+    /**
+     * Force-close the server by destroying all open TCP sockets immediately.
+     * Unlike stopAsync(), this does not wait for graceful close handshakes.
+     * Used during host shutdown to release the port as fast as possible.
+     */
+    async forceCloseAsync() {
+        if (!this._isListening) {
+            return;
+        }
+        this._isListening = false;
+        // Destroy all raw TCP sockets immediately
+        for (const socket of this._sockets) {
+            socket.destroy();
+        }
+        this._sockets.clear();
+        // Terminate all WebSocket connections
+        if (this._wss) {
+            for (const client of this._wss.clients) {
+                client.terminate();
+            }
+            await new Promise((resolve) => {
+                this._wss.close(() => resolve());
+            });
+            this._wss = undefined;
+        }
+        // Close the HTTP server
+        if (this._httpServer) {
+            await new Promise((resolve) => {
+                this._httpServer.close(() => resolve());
+            });
+            this._httpServer = undefined;
+        }
+        this._port = 0;
+    }
+    _parsePath(request) {
+        try {
+            const url = new URL(request.url ?? '/', `http://${request.headers.host ?? 'localhost'}`);
+            return url.pathname;
+        }
+        catch {
+            return '/';
+        }
+    }
+    _handleHttpRequest(req, res) {
+        const pathname = this._parsePath(req);
+        const handler = this._httpHandlers.get(pathname);
+        if (handler) {
+            handler(req, res);
+            return;
+        }
+        res.writeHead(404, { 'Content-Type': 'text/plain' });
+        res.end('Not Found');
+    }
+}
+//# sourceMappingURL=transport-server.js.map

package/dist/src/bridge/internal/transport-server.js.map

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

package/dist/src/bridge/internal/transport-server.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Unit tests for TransportServer — validates port binding, path-based
+ * WebSocket routing, HTTP health endpoint delegation, and cleanup.
+ */
+export {};
+//# sourceMappingURL=transport-server.test.d.ts.map

package/dist/src/bridge/internal/transport-server.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-server.test.d.ts","sourceRoot":"","sources":["../../../../src/bridge/internal/transport-server.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}