@quenty/studio-bridge 0.7.1 → 0.8.0

package/dist/src/bridge/internal/__tests__/failover-inflight.test.js

@@ -0,0 +1,246 @@
+/**
+ * Integration tests for inflight request handling during failover. Verifies
+ * that pending requests are properly rejected when the client is disconnected,
+ * and that old sessions throw SessionDisconnectedError after failover.
+ *
+ * Uses real BridgeClient connected to a mock host (WebSocketServer).
+ */
+import { describe, it, expect, afterEach, vi } from 'vitest';
+import { WebSocketServer } from 'ws';
+import { BridgeClient } from '../bridge-client.js';
+// Mock loadActionSourcesAsync so _ensureActionsAsync is a no-op in tests
+vi.mock('../../../commands/framework/action-loader.js', () => ({
+    loadActionSourcesAsync: vi.fn(async () => []),
+}));
+import { encodeHostMessage, decodeHostMessage, } from '../host-protocol.js';
+import { SessionDisconnectedError } from '../../types.js';
+function createSessionInfo(overrides = {}) {
+    return {
+        sessionId: 'session-1',
+        placeName: 'TestPlace',
+        state: 'Edit',
+        pluginVersion: '1.0.0',
+        capabilities: ['execute', 'queryState'],
+        connectedAt: new Date('2024-01-01'),
+        origin: 'user',
+        context: 'edit',
+        instanceId: 'inst-1',
+        placeId: 100,
+        gameId: 200,
+        ...overrides,
+    };
+}
+async function createMockHostWithSessions(sessions) {
+    const clients = [];
+    const receivedMessages = [];
+    const wss = new WebSocketServer({ port: 0, path: '/client' });
+    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) => {
+        clients.push(ws);
+        ws.on('message', (raw) => {
+            const data = typeof raw === 'string' ? raw : raw.toString('utf-8');
+            const msg = decodeHostMessage(data);
+            if (msg) {
+                receivedMessages.push(msg);
+                if (msg.type === 'list-sessions') {
+                    ws.send(encodeHostMessage({
+                        type: 'list-sessions-response',
+                        requestId: msg.requestId,
+                        sessions,
+                    }));
+                }
+                // Do NOT respond to host-envelope — leave them pending
+            }
+        });
+    });
+    return { wss, port, clients, receivedMessages };
+}
+async function closeHost(host) {
+    for (const client of host.wss.clients) {
+        client.terminate();
+    }
+    await new Promise((resolve) => {
+        host.wss.close(() => resolve());
+    });
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+describe('Inflight request handling during failover', () => {
+    let host;
+    let client;
+    afterEach(async () => {
+        if (client) {
+            try {
+                await client.disconnectAsync();
+            }
+            catch {
+                /* ignore */
+            }
+            client = undefined;
+        }
+        if (host) {
+            try {
+                await closeHost(host);
+            }
+            catch {
+                /* ignore */
+            }
+            host = undefined;
+        }
+    });
+    it('pending request rejects with error when client disconnects', async () => {
+        const sessions = [createSessionInfo({ sessionId: 'session-1' })];
+        host = await createMockHostWithSessions(sessions);
+        client = new BridgeClient();
+        await client.connectAsync(host.port);
+        const session = client.getSession('session-1');
+        expect(session).toBeDefined();
+        // Send an action that will never get a response (mock host doesn't
+        // respond to host-envelope messages)
+        const execPromise = session.execAsync('print("hello")', 30_000);
+        // Wait for the envelope to be sent
+        await delay(50);
+        // Simulate failover cleanup by explicitly disconnecting
+        await client.disconnectAsync();
+        client = undefined;
+        // The pending request should reject with 'Client disconnected'
+        await expect(execPromise).rejects.toThrow('Client disconnected');
+    });
+    it('ALL pending requests are rejected, not just the first', async () => {
+        const sessions = [createSessionInfo({ sessionId: 'session-1' })];
+        host = await createMockHostWithSessions(sessions);
+        client = new BridgeClient();
+        await client.connectAsync(host.port);
+        const session = client.getSession('session-1');
+        expect(session).toBeDefined();
+        // Send multiple actions that will never get responses
+        const promises = [
+            session.execAsync('print("a")', 30_000),
+            session.execAsync('print("b")', 30_000),
+            session.execAsync('print("c")', 30_000),
+        ];
+        // Wait for envelopes to be sent
+        await delay(50);
+        // Simulate failover cleanup
+        await client.disconnectAsync();
+        client = undefined;
+        // ALL promises should reject
+        const results = await Promise.allSettled(promises);
+        for (const result of results) {
+            expect(result.status).toBe('rejected');
+        }
+        // All should reject with 'Client disconnected'
+        for (const result of results) {
+            if (result.status === 'rejected') {
+                expect(result.reason.message).toContain('Client disconnected');
+            }
+        }
+    });
+    it('requests reject before takeover would complete', async () => {
+        const sessions = [createSessionInfo({ sessionId: 'session-1' })];
+        host = await createMockHostWithSessions(sessions);
+        client = new BridgeClient();
+        await client.connectAsync(host.port);
+        const session = client.getSession('session-1');
+        expect(session).toBeDefined();
+        // Track ordering
+        const events = [];
+        // Start a pending request
+        const execPromise = session
+            .execAsync('print("hello")', 30_000)
+            .catch((err) => {
+            events.push('request-rejected');
+            throw err;
+        });
+        await delay(50);
+        // Disconnect (which immediately rejects pending requests)
+        await client.disconnectAsync();
+        client = undefined;
+        // Verify the promise rejected
+        await expect(execPromise).rejects.toThrow();
+        // Request rejection should have been recorded
+        expect(events).toContain('request-rejected');
+    });
+    it('after failover, old BridgeSession throws SessionDisconnectedError', async () => {
+        const sessions = [createSessionInfo({ sessionId: 'session-1' })];
+        host = await createMockHostWithSessions(sessions);
+        client = new BridgeClient();
+        await client.connectAsync(host.port);
+        const session = client.getSession('session-1');
+        expect(session).toBeDefined();
+        // Disconnect the client (simulates failover cleanup)
+        await client.disconnectAsync();
+        client = undefined;
+        // The old session should now throw SessionDisconnectedError
+        expect(session.isConnected).toBe(false);
+        await expect(session.execAsync('print("hello")')).rejects.toThrow(SessionDisconnectedError);
+        await expect(session.queryStateAsync()).rejects.toThrow(SessionDisconnectedError);
+        await expect(session.captureScreenshotAsync()).rejects.toThrow(SessionDisconnectedError);
+        await expect(session.queryLogsAsync()).rejects.toThrow(SessionDisconnectedError);
+        await expect(session.queryDataModelAsync({ path: 'game' })).rejects.toThrow(SessionDisconnectedError);
+    });
+    it('client emits disconnected event when host dies', async () => {
+        host = await createMockHostWithSessions([]);
+        client = new BridgeClient();
+        await client.connectAsync(host.port);
+        const disconnectedPromise = new Promise((resolve) => {
+            client.on('disconnected', resolve);
+        });
+        // Kill the host (force close)
+        await closeHost(host);
+        host = undefined;
+        // Should emit disconnected
+        await disconnectedPromise;
+        expect(client.isConnected).toBe(false);
+    });
+    it('multiple pending requests from different sessions all reject', async () => {
+        const sessions = [
+            createSessionInfo({ sessionId: 'session-a', instanceId: 'inst-a' }),
+            createSessionInfo({ sessionId: 'session-b', instanceId: 'inst-b' }),
+        ];
+        host = await createMockHostWithSessions(sessions);
+        client = new BridgeClient();
+        await client.connectAsync(host.port);
+        const sessionA = client.getSession('session-a');
+        const sessionB = client.getSession('session-b');
+        expect(sessionA).toBeDefined();
+        expect(sessionB).toBeDefined();
+        // Send actions on both sessions
+        const promiseA = sessionA.execAsync('print("a")', 30_000);
+        const promiseB = sessionB.execAsync('print("b")', 30_000);
+        await delay(50);
+        // Disconnect (simulating failover cleanup)
+        await client.disconnectAsync();
+        client = undefined;
+        // Both should reject
+        const results = await Promise.allSettled([promiseA, promiseB]);
+        expect(results[0].status).toBe('rejected');
+        expect(results[1].status).toBe('rejected');
+    });
+    it('session disconnected event fires when handles are marked disconnected', async () => {
+        const sessions = [createSessionInfo({ sessionId: 'session-1' })];
+        host = await createMockHostWithSessions(sessions);
+        client = new BridgeClient();
+        await client.connectAsync(host.port);
+        const session = client.getSession('session-1');
+        expect(session).toBeDefined();
+        const disconnectedPromise = new Promise((resolve) => {
+            session.on('disconnected', resolve);
+        });
+        // Disconnect the client
+        await client.disconnectAsync();
+        client = undefined;
+        // Session should have emitted disconnected
+        await disconnectedPromise;
+        expect(session.isConnected).toBe(false);
+    });
+});
+//# sourceMappingURL=failover-inflight.test.js.map

package/dist/src/bridge/internal/__tests__/failover-inflight.test.js.map

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

package/dist/src/bridge/internal/__tests__/host-client-integration.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Integration tests for host<->client protocol. Verifies that a real
+ * BridgeHost correctly processes client WebSocket messages (list-sessions,
+ * list-instances) and broadcasts session events when plugins connect or
+ * disconnect. This covers Bug 1: host never processed client messages.
+ *
+ * Uses real BridgeHost and WebSocket connections — no mocks for the host side.
+ */
+export {};
+//# sourceMappingURL=host-client-integration.test.d.ts.map

package/dist/src/bridge/internal/__tests__/host-client-integration.test.d.ts.map

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

package/dist/src/bridge/internal/__tests__/host-client-integration.test.js

@@ -0,0 +1,298 @@
+/**
+ * Integration tests for host<->client protocol. Verifies that a real
+ * BridgeHost correctly processes client WebSocket messages (list-sessions,
+ * list-instances) and broadcasts session events when plugins connect or
+ * disconnect. This covers Bug 1: host never processed client messages.
+ *
+ * Uses real BridgeHost and WebSocket connections — no mocks for the host side.
+ */
+import { describe, it, expect, afterEach } from 'vitest';
+import { EventEmitter } from 'events';
+import { WebSocket } from 'ws';
+import { BridgeHost } from '../bridge-host.js';
+import { SessionTracker } from '../session-tracker.js';
+import { encodeHostMessage, decodeHostMessage, } from '../host-protocol.js';
+class StubTransportHandle extends EventEmitter {
+    get isConnected() {
+        return true;
+    }
+    async sendActionAsync() {
+        throw new Error('stub');
+    }
+    sendMessage() {
+        // no-op
+    }
+}
+function connectClientWsAsync(port) {
+    return new Promise((resolve, reject) => {
+        const ws = new WebSocket(`ws://localhost:${port}/client`);
+        ws.on('open', () => resolve(ws));
+        ws.on('error', reject);
+    });
+}
+function connectPluginWsAsync(port) {
+    return new Promise((resolve, reject) => {
+        const ws = new WebSocket(`ws://localhost:${port}/plugin`);
+        ws.on('open', () => resolve(ws));
+        ws.on('error', reject);
+    });
+}
+async function waitForMessageAsync(ws, timeoutMs = 2_000) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            reject(new Error(`Timed out waiting for message (${timeoutMs}ms)`));
+        }, timeoutMs);
+        ws.once('message', (raw) => {
+            clearTimeout(timer);
+            const data = typeof raw === 'string' ? raw : raw.toString('utf-8');
+            const msg = decodeHostMessage(data);
+            if (!msg) {
+                reject(new Error(`Failed to decode host message: ${data}`));
+                return;
+            }
+            resolve(msg);
+        });
+    });
+}
+function deriveContext(state) {
+    if (state === 'Server')
+        return 'server';
+    if (state === 'Client')
+        return 'client';
+    return 'edit';
+}
+/**
+ * Wire BridgeHost events to a SessionTracker, mirroring the pattern from
+ * BridgeConnection._initHostAsync. Returns the tracker for querying.
+ */
+function wireHostAndTracker(host) {
+    const tracker = new SessionTracker();
+    // plugin-connected -> tracker.addSession
+    host.on('plugin-connected', (info) => {
+        const state = info.state ?? 'Edit';
+        const context = deriveContext(state);
+        const sessionInfo = {
+            sessionId: info.sessionId,
+            placeName: info.placeName ?? '',
+            placeFile: info.placeFile,
+            state: state,
+            pluginVersion: info.pluginVersion ?? '',
+            capabilities: info.capabilities,
+            connectedAt: new Date(),
+            origin: 'user',
+            context,
+            instanceId: info.instanceId ?? info.sessionId,
+            placeId: 0,
+            gameId: 0,
+        };
+        const handle = new StubTransportHandle();
+        tracker.addSession(info.sessionId, sessionInfo, handle);
+    });
+    // plugin-disconnected -> tracker.removeSession
+    host.on('plugin-disconnected', (sessionId) => {
+        tracker.removeSession(sessionId);
+    });
+    // client-message -> respond to list-sessions, list-instances
+    host.on('client-message', (msg, reply) => {
+        if (msg.type === 'list-sessions') {
+            const req = msg;
+            reply({
+                type: 'list-sessions-response',
+                requestId: req.requestId,
+                sessions: tracker.listSessions(),
+            });
+        }
+        else if (msg.type === 'list-instances') {
+            const req = msg;
+            reply({
+                type: 'list-instances-response',
+                requestId: req.requestId,
+                instances: tracker.listInstances(),
+            });
+        }
+    });
+    // session-added -> broadcast session-event connected
+    tracker.on('session-added', (tracked) => {
+        host.broadcastToClients({
+            type: 'session-event',
+            event: 'connected',
+            sessionId: tracked.info.sessionId,
+            session: tracked.info,
+            context: tracked.info.context,
+            instanceId: tracked.info.instanceId,
+        });
+    });
+    // session-removed -> broadcast session-event disconnected
+    tracker.on('session-removed', (sessionId) => {
+        host.broadcastToClients({
+            type: 'session-event',
+            event: 'disconnected',
+            sessionId,
+            context: 'edit',
+            instanceId: sessionId,
+        });
+    });
+    return tracker;
+}
+/**
+ * Send a register message on a plugin WebSocket.
+ */
+async function registerPluginAsync(pluginWs, options) {
+    pluginWs.send(JSON.stringify({
+        type: 'register',
+        sessionId: options.sessionId,
+        payload: {
+            pluginVersion: options.pluginVersion ?? '0.7.0',
+            instanceId: options.instanceId,
+            placeName: options.placeName ?? 'TestPlace',
+            state: options.state ?? 'Edit',
+            capabilities: options.capabilities ?? ['execute'],
+        },
+    }));
+    // Yield to let the host process the register
+    await new Promise((r) => setTimeout(r, 20));
+}
+describe('Host-client integration', { timeout: 10_000 }, () => {
+    let host;
+    const openSockets = [];
+    afterEach(async () => {
+        for (const ws of openSockets) {
+            if (ws.readyState === WebSocket.OPEN ||
+                ws.readyState === WebSocket.CONNECTING) {
+                ws.terminate();
+            }
+        }
+        openSockets.length = 0;
+        if (host) {
+            try {
+                await host.stopAsync();
+            }
+            catch {
+                /* ignore */
+            }
+            host = undefined;
+        }
+    });
+    it('host responds to list-sessions request from client WebSocket', async () => {
+        host = new BridgeHost();
+        const port = await host.startAsync({ port: 0 });
+        wireHostAndTracker(host);
+        const clientWs = await connectClientWsAsync(port);
+        openSockets.push(clientWs);
+        // Send list-sessions request
+        const responsePromise = waitForMessageAsync(clientWs);
+        clientWs.send(encodeHostMessage({
+            type: 'list-sessions',
+            requestId: 'req-1',
+        }));
+        const response = await responsePromise;
+        expect(response.type).toBe('list-sessions-response');
+        expect(response).toHaveProperty('requestId', 'req-1');
+        expect(response).toHaveProperty('sessions');
+        expect(response.sessions).toEqual([]);
+    });
+    it('host responds to list-instances request from client WebSocket', async () => {
+        host = new BridgeHost();
+        const port = await host.startAsync({ port: 0 });
+        wireHostAndTracker(host);
+        const clientWs = await connectClientWsAsync(port);
+        openSockets.push(clientWs);
+        // Send list-instances request
+        const responsePromise = waitForMessageAsync(clientWs);
+        clientWs.send(encodeHostMessage({
+            type: 'list-instances',
+            requestId: 'req-2',
+        }));
+        const response = await responsePromise;
+        expect(response.type).toBe('list-instances-response');
+        expect(response).toHaveProperty('requestId', 'req-2');
+        expect(response).toHaveProperty('instances');
+        expect(response.instances).toEqual([]);
+    });
+    it('client WebSocket receives session-event when plugin connects', async () => {
+        host = new BridgeHost();
+        const port = await host.startAsync({ port: 0 });
+        wireHostAndTracker(host);
+        // Connect a client first so it can receive the broadcast
+        const clientWs = await connectClientWsAsync(port);
+        openSockets.push(clientWs);
+        // Set up listener before plugin connects
+        const eventPromise = waitForMessageAsync(clientWs);
+        // Connect a plugin and register
+        const pluginWs = await connectPluginWsAsync(port);
+        openSockets.push(pluginWs);
+        await registerPluginAsync(pluginWs, {
+            sessionId: 'test-session-1',
+            instanceId: 'game-123',
+            placeName: 'TestPlace',
+            pluginVersion: '0.7.0',
+            state: 'Edit',
+            capabilities: ['execute'],
+        });
+        const event = await eventPromise;
+        expect(event.type).toBe('session-event');
+        expect(event).toHaveProperty('event', 'connected');
+        expect(event).toHaveProperty('sessionId', 'test-session-1');
+    });
+    it('client WebSocket receives session-event when plugin disconnects', async () => {
+        host = new BridgeHost();
+        const port = await host.startAsync({ port: 0 });
+        wireHostAndTracker(host);
+        const clientWs = await connectClientWsAsync(port);
+        openSockets.push(clientWs);
+        // Connect and register a plugin
+        const pluginWs = await connectPluginWsAsync(port);
+        openSockets.push(pluginWs);
+        // Wait for the connected event first
+        const connectedPromise = waitForMessageAsync(clientWs);
+        await registerPluginAsync(pluginWs, {
+            sessionId: 'test-session-1',
+            instanceId: 'game-123',
+        });
+        await connectedPromise;
+        // Now set up listener for the disconnected event
+        const disconnectPromise = waitForMessageAsync(clientWs);
+        // Close the plugin WebSocket
+        pluginWs.close();
+        const event = await disconnectPromise;
+        expect(event.type).toBe('session-event');
+        expect(event).toHaveProperty('event', 'disconnected');
+        expect(event).toHaveProperty('sessionId', 'test-session-1');
+    });
+    it('list-sessions returns connected plugin after register', async () => {
+        host = new BridgeHost();
+        const port = await host.startAsync({ port: 0 });
+        wireHostAndTracker(host);
+        const clientWs = await connectClientWsAsync(port);
+        openSockets.push(clientWs);
+        // Connect and register a plugin
+        const pluginWs = await connectPluginWsAsync(port);
+        openSockets.push(pluginWs);
+        // Wait for the connected session-event so we know the tracker has the session
+        const connectedPromise = waitForMessageAsync(clientWs);
+        await registerPluginAsync(pluginWs, {
+            sessionId: 'test-session-1',
+            instanceId: 'game-123',
+            placeName: 'TestPlace',
+            pluginVersion: '0.7.0',
+            state: 'Edit',
+            capabilities: ['execute'],
+        });
+        await connectedPromise;
+        // Now send list-sessions
+        const responsePromise = waitForMessageAsync(clientWs);
+        clientWs.send(encodeHostMessage({
+            type: 'list-sessions',
+            requestId: 'req-ls-1',
+        }));
+        const response = await responsePromise;
+        expect(response.type).toBe('list-sessions-response');
+        expect(response).toHaveProperty('requestId', 'req-ls-1');
+        const sessions = response.sessions;
+        expect(sessions).toHaveLength(1);
+        expect(sessions[0].sessionId).toBe('test-session-1');
+        expect(sessions[0].instanceId).toBe('game-123');
+        expect(sessions[0].placeName).toBe('TestPlace');
+    });
+});
+//# sourceMappingURL=host-client-integration.test.js.map

package/dist/src/bridge/internal/__tests__/host-client-integration.test.js.map

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

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

@@ -0,0 +1,70 @@
+/**
+ * Bridge client that connects to an existing bridge host. From the
+ * consumer's perspective it behaves identically to being the host --
+ * actions are forwarded through the host rather than delivered directly
+ * to plugins.
+ *
+ * The client:
+ * - Connects to ws://host:port/client using TransportClient
+ * - Sends ListSessionsRequest on connect to populate local session cache
+ * - Listens for SessionEvent messages from host to keep cache in sync
+ * - Creates BridgeSession instances backed by RelayedTransportHandle
+ */
+import { EventEmitter } from 'events';
+import { BridgeSession } from '../bridge-session.js';
+import type { SessionInfo, InstanceInfo } from '../types.js';
+import type { PluginMessage, ServerMessage } from '../../server/web-socket-protocol.js';
+export declare class BridgeClient extends EventEmitter {
+    private _transport;
+    private _sessions;
+    private _sessionHandles;
+    private _bridgeSessions;
+    private _pendingRequests;
+    private _isConnected;
+    private _handOff;
+    /**
+     * Connect to an existing bridge host.
+     */
+    connectAsync(port: number, host?: string): Promise<void>;
+    /**
+     * Disconnect from the bridge host.
+     */
+    disconnectAsync(): Promise<void>;
+    /**
+     * List all known sessions.
+     */
+    listSessions(): SessionInfo[];
+    /**
+     * List unique instances derived from session data.
+     */
+    listInstances(): InstanceInfo[];
+    /**
+     * Get a BridgeSession for a specific session ID.
+     */
+    getSession(sessionId: string): BridgeSession | undefined;
+    /** Whether the client is connected to the host. */
+    get isConnected(): boolean;
+    /**
+     * Send an action wrapped in a HostEnvelope and wait for the response.
+     */
+    sendEnvelopeAsync(targetSessionId: string, action: ServerMessage, timeoutMs: number): Promise<PluginMessage>;
+    /**
+     * Send a raw string over the transport.
+     */
+    sendRaw(data: string): void;
+    private _handleMessage;
+    private _handleHostResponse;
+    private _handleListSessionsResponse;
+    private _handleListInstancesResponse;
+    private _handleSessionEvent;
+    private _addSessionFromInfo;
+    private _fetchSessionsAsync;
+    /**
+     * Handle host WebSocket disconnect by running the failover state machine.
+     * Emits 'host-promoted' if this client should become the new host, or
+     * 'host-fallback' if another client won the race, or 'host-unreachable'
+     * if all retries are exhausted.
+     */
+    private _handleHostDisconnectAsync;
+}
+//# sourceMappingURL=bridge-client.d.ts.map