@quenty/studio-bridge 0.7.1 → 0.9.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-client.d.ts","sourceRoot":"","sources":["../../../../src/bridge/internal/bridge-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAetC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAC7E,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACd,MAAM,qCAAqC,CAAC;AAiD7C,qBAAa,YAAa,SAAQ,YAAY;IAC5C,OAAO,CAAC,UAAU,CAAyB;IAC3C,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,eAAe,CAA6C;IACpE,OAAO,CAAC,eAAe,CAAoC;IAC3D,OAAO,CAAC,gBAAgB,CAOpB;IACJ,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAA6B;IAE7C;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmC9D;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBtC;;OAEG;IACH,YAAY,IAAI,WAAW,EAAE;IAI7B;;OAEG;IACH,aAAa,IAAI,YAAY,EAAE;IA+B/B;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIxD,mDAAmD;IACnD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACG,iBAAiB,CACrB,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC;IA8BzB;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI3B,OAAO,CAAC,cAAc;IA6BtB,OAAO,CAAC,mBAAmB;IAmB3B,OAAO,CAAC,2BAA2B;IAkBnC,OAAO,CAAC,4BAA4B;IAIpC,OAAO,CAAC,mBAAmB;IAqC3B,OAAO,CAAC,mBAAmB;YAUb,mBAAmB;IA+BjC;;;;;OAKG;YACW,0BAA0B;CAoBzC"}

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

@@ -0,0 +1,344 @@
+/**
+ * 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 { randomUUID } from 'crypto';
+import { TransportClient } from './transport-client.js';
+import { encodeHostMessage, decodeHostMessage, } from './host-protocol.js';
+import { HandOffManager } from './hand-off.js';
+import { BridgeSession } from '../bridge-session.js';
+/**
+ * A TransportHandle that wraps actions in HostEnvelope messages and sends
+ * them through the bridge host. Waits for the matching HostResponse.
+ */
+class RelayedTransportHandle extends EventEmitter {
+    _sessionId;
+    _client;
+    _connected = true;
+    constructor(sessionId, client) {
+        super();
+        this._sessionId = sessionId;
+        this._client = client;
+    }
+    async sendActionAsync(message, timeoutMs) {
+        return this._client.sendEnvelopeAsync(this._sessionId, message, timeoutMs);
+    }
+    sendMessage(message) {
+        const requestId = randomUUID();
+        const envelope = {
+            type: 'host-envelope',
+            requestId,
+            targetSessionId: this._sessionId,
+            action: message,
+        };
+        this._client.sendRaw(encodeHostMessage(envelope));
+    }
+    get isConnected() {
+        return this._connected && this._client.isConnected;
+    }
+    markDisconnected() {
+        this._connected = false;
+        this.emit('disconnected');
+    }
+}
+export class BridgeClient extends EventEmitter {
+    _transport = new TransportClient();
+    _sessions = new Map();
+    _sessionHandles = new Map();
+    _bridgeSessions = new Map();
+    _pendingRequests = new Map();
+    _isConnected = false;
+    _handOff;
+    /**
+     * Connect to an existing bridge host.
+     */
+    async connectAsync(port, host) {
+        const targetHost = host ?? 'localhost';
+        const url = `ws://${targetHost}:${port}/client`;
+        this._handOff = new HandOffManager({ port });
+        this._transport.on('message', (data) => {
+            this._handleMessage(data);
+        });
+        this._transport.on('disconnected', () => {
+            this._isConnected = false;
+            this.emit('disconnected');
+            // Trigger failover detection
+            this._handleHostDisconnectAsync();
+        });
+        this._transport.on('connected', () => {
+            this._isConnected = true;
+            this.emit('connected');
+        });
+        await this._transport.connectAsync(url, {
+            maxReconnectAttempts: 10,
+            initialBackoffMs: 1_000,
+            maxBackoffMs: 30_000,
+        });
+        this._isConnected = true;
+        // Fetch initial session list from host
+        await this._fetchSessionsAsync();
+    }
+    /**
+     * Disconnect from the bridge host.
+     */
+    async disconnectAsync() {
+        // Remove listeners before disconnecting to prevent the 'disconnected'
+        // event from triggering failover recovery on intentional disconnect.
+        this._transport.removeAllListeners();
+        this._transport.disconnect();
+        this._isConnected = false;
+        // Cancel all pending requests
+        for (const [, entry] of this._pendingRequests) {
+            clearTimeout(entry.timer);
+            entry.reject(new Error('Client disconnected'));
+        }
+        this._pendingRequests.clear();
+        // Mark all handles as disconnected
+        for (const handle of this._sessionHandles.values()) {
+            handle.markDisconnected();
+        }
+        this._sessions.clear();
+        this._sessionHandles.clear();
+        this._bridgeSessions.clear();
+    }
+    /**
+     * List all known sessions.
+     */
+    listSessions() {
+        return Array.from(this._sessions.values());
+    }
+    /**
+     * List unique instances derived from session data.
+     */
+    listInstances() {
+        const instanceMap = new Map();
+        for (const session of this._sessions.values()) {
+            const existing = instanceMap.get(session.instanceId);
+            if (existing) {
+                existing.contexts.push(session.context);
+            }
+            else {
+                instanceMap.set(session.instanceId, {
+                    info: session,
+                    contexts: [session.context],
+                });
+            }
+        }
+        return Array.from(instanceMap.entries()).map(([instanceId, data]) => ({
+            instanceId,
+            placeName: data.info.placeName,
+            placeId: data.info.placeId,
+            gameId: data.info.gameId,
+            contexts: data.contexts,
+            origin: data.info.origin,
+        }));
+    }
+    /**
+     * Get a BridgeSession for a specific session ID.
+     */
+    getSession(sessionId) {
+        return this._bridgeSessions.get(sessionId);
+    }
+    /** Whether the client is connected to the host. */
+    get isConnected() {
+        return this._isConnected;
+    }
+    /**
+     * Send an action wrapped in a HostEnvelope and wait for the response.
+     */
+    async sendEnvelopeAsync(targetSessionId, action, timeoutMs) {
+        const requestId = randomUUID();
+        const envelope = {
+            type: 'host-envelope',
+            requestId,
+            targetSessionId,
+            action,
+        };
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this._pendingRequests.delete(requestId);
+                reject(new Error(`Request "${requestId}" timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            this._pendingRequests.set(requestId, { resolve, reject, timer });
+            try {
+                this._transport.send(encodeHostMessage(envelope));
+            }
+            catch (err) {
+                this._pendingRequests.delete(requestId);
+                clearTimeout(timer);
+                reject(err);
+            }
+        });
+    }
+    /**
+     * Send a raw string over the transport.
+     */
+    sendRaw(data) {
+        this._transport.send(data);
+    }
+    _handleMessage(data) {
+        const msg = decodeHostMessage(data);
+        if (!msg) {
+            return;
+        }
+        switch (msg.type) {
+            case 'host-response':
+                this._handleHostResponse(msg);
+                break;
+            case 'list-sessions-response':
+                this._handleListSessionsResponse(msg);
+                break;
+            case 'list-instances-response':
+                this._handleListInstancesResponse(msg);
+                break;
+            case 'session-event':
+                this._handleSessionEvent(msg);
+                break;
+            case 'host-transfer':
+                this._handOff?.onHostTransferNotice();
+                break;
+        }
+    }
+    _handleHostResponse(msg) {
+        const pending = this._pendingRequests.get(msg.requestId);
+        if (pending) {
+            clearTimeout(pending.timer);
+            this._pendingRequests.delete(msg.requestId);
+            pending.resolve(msg.result);
+        }
+        // Also forward to the appropriate session handle for push messages
+        const result = msg.result;
+        if (result && typeof result === 'object' && 'sessionId' in result) {
+            const sessionId = result.sessionId;
+            const handle = this._sessionHandles.get(sessionId);
+            if (handle) {
+                handle.emit('message', result);
+            }
+        }
+    }
+    _handleListSessionsResponse(msg) {
+        const pending = this._pendingRequests.get(msg.requestId);
+        if (pending) {
+            clearTimeout(pending.timer);
+            this._pendingRequests.delete(msg.requestId);
+            // We handle this specially -- populate the cache
+            for (const session of msg.sessions) {
+                this._addSessionFromInfo(session);
+            }
+            // Resolve with a synthetic message (the caller only cares about the list)
+            pending.resolve({
+                type: 'heartbeat',
+                sessionId: '',
+                payload: { uptimeMs: 0, state: 'Edit', pendingRequests: 0 },
+            });
+        }
+    }
+    _handleListInstancesResponse(_msg) {
+        // Instances are derived from sessions, so this is informational
+    }
+    _handleSessionEvent(msg) {
+        switch (msg.event) {
+            case 'connected': {
+                if (msg.session) {
+                    this._addSessionFromInfo(msg.session);
+                    const bridgeSession = this._bridgeSessions.get(msg.sessionId);
+                    if (bridgeSession) {
+                        this.emit('session-connected', bridgeSession);
+                    }
+                }
+                break;
+            }
+            case 'disconnected': {
+                const handle = this._sessionHandles.get(msg.sessionId);
+                if (handle) {
+                    handle.markDisconnected();
+                }
+                this._sessions.delete(msg.sessionId);
+                this._sessionHandles.delete(msg.sessionId);
+                this._bridgeSessions.delete(msg.sessionId);
+                this.emit('session-disconnected', msg.sessionId);
+                break;
+            }
+            case 'state-changed': {
+                if (msg.session) {
+                    const existing = this._sessions.get(msg.sessionId);
+                    if (existing) {
+                        this._sessions.set(msg.sessionId, msg.session);
+                    }
+                }
+                break;
+            }
+        }
+    }
+    _addSessionFromInfo(info) {
+        this._sessions.set(info.sessionId, info);
+        if (!this._sessionHandles.has(info.sessionId)) {
+            const handle = new RelayedTransportHandle(info.sessionId, this);
+            this._sessionHandles.set(info.sessionId, handle);
+            this._bridgeSessions.set(info.sessionId, new BridgeSession(info, handle));
+        }
+    }
+    async _fetchSessionsAsync() {
+        const requestId = randomUUID();
+        const request = {
+            type: 'list-sessions',
+            requestId,
+        };
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this._pendingRequests.delete(requestId);
+                reject(new Error('Timed out waiting for session list'));
+            }, 5_000);
+            this._pendingRequests.set(requestId, {
+                resolve: () => {
+                    resolve();
+                },
+                reject,
+                timer,
+            });
+            try {
+                this._transport.send(encodeHostMessage(request));
+            }
+            catch (err) {
+                this._pendingRequests.delete(requestId);
+                clearTimeout(timer);
+                reject(err);
+            }
+        });
+    }
+    /**
+     * 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.
+     */
+    async _handleHostDisconnectAsync() {
+        if (!this._handOff) {
+            return;
+        }
+        console.warn('Bridge host disconnected. Attempting recovery...');
+        try {
+            const outcome = await this._handOff.onHostDisconnectedAsync();
+            if (outcome === 'promoted') {
+                this.emit('host-promoted');
+            }
+            else {
+                this.emit('host-fallback');
+            }
+        }
+        catch {
+            // HostUnreachableError — nothing we can do
+            this.emit('host-unreachable');
+        }
+    }
+}
+//# sourceMappingURL=bridge-client.js.map

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * Unit tests for BridgeClient -- validates connection to a mock host,
+ * session listing, action forwarding via HostEnvelope, and session
+ * event handling.
+ */
+export {};
+//# sourceMappingURL=bridge-client.test.d.ts.map

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

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

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

@@ -0,0 +1,301 @@
+/**
+ * Unit tests for BridgeClient -- validates connection to a mock host,
+ * session listing, action forwarding via HostEnvelope, and session
+ * event handling.
+ */
+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';
+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 createMockHost() {
+    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);
+                // Auto-respond to list-sessions with empty list
+                if (msg.type === 'list-sessions') {
+                    ws.send(encodeHostMessage({
+                        type: 'list-sessions-response',
+                        requestId: msg.requestId,
+                        sessions: [],
+                    }));
+                }
+            }
+        });
+    });
+    return { wss, port, clients, receivedMessages };
+}
+async function createMockHostWithSessions(sessions) {
+    const host = await createMockHost();
+    // Override the message handler to respond with sessions
+    host.wss.removeAllListeners('connection');
+    host.wss.on('connection', (ws) => {
+        host.clients.push(ws);
+        ws.on('message', (raw) => {
+            const data = typeof raw === 'string' ? raw : raw.toString('utf-8');
+            const msg = decodeHostMessage(data);
+            if (msg) {
+                host.receivedMessages.push(msg);
+                if (msg.type === 'list-sessions') {
+                    ws.send(encodeHostMessage({
+                        type: 'list-sessions-response',
+                        requestId: msg.requestId,
+                        sessions,
+                    }));
+                }
+            }
+        });
+    });
+    return host;
+}
+async function closeHost(host) {
+    for (const client of host.wss.clients) {
+        client.terminate();
+    }
+    await new Promise((resolve) => {
+        host.wss.close(() => resolve());
+    });
+}
+describe('BridgeClient', () => {
+    let host;
+    let client;
+    afterEach(async () => {
+        if (client) {
+            await client.disconnectAsync();
+            client = undefined;
+        }
+        if (host) {
+            await closeHost(host);
+            host = undefined;
+        }
+    });
+    describe('connectAsync', () => {
+        it('connects to a mock host', async () => {
+            host = await createMockHost();
+            client = new BridgeClient();
+            await client.connectAsync(host.port);
+            expect(client.isConnected).toBe(true);
+        });
+        it('sends list-sessions request on connect', async () => {
+            host = await createMockHost();
+            client = new BridgeClient();
+            await client.connectAsync(host.port);
+            // Wait for message processing
+            await new Promise((r) => setTimeout(r, 50));
+            const listReqs = host.receivedMessages.filter((m) => m.type === 'list-sessions');
+            expect(listReqs.length).toBeGreaterThanOrEqual(1);
+        });
+    });
+    describe('listSessions', () => {
+        it('returns empty list when host has no sessions', async () => {
+            host = await createMockHost();
+            client = new BridgeClient();
+            await client.connectAsync(host.port);
+            expect(client.listSessions()).toEqual([]);
+        });
+        it('returns sessions from host response', async () => {
+            const sessions = [
+                createSessionInfo({ sessionId: 'session-a' }),
+                createSessionInfo({ sessionId: 'session-b', instanceId: 'inst-2' }),
+            ];
+            host = await createMockHostWithSessions(sessions);
+            client = new BridgeClient();
+            await client.connectAsync(host.port);
+            const listed = client.listSessions();
+            expect(listed).toHaveLength(2);
+            expect(listed.map((s) => s.sessionId).sort()).toEqual([
+                'session-a',
+                'session-b',
+            ]);
+        });
+    });
+    describe('listInstances', () => {
+        it('derives instances from sessions', async () => {
+            const sessions = [
+                createSessionInfo({
+                    sessionId: 's-edit',
+                    instanceId: 'inst-A',
+                    context: 'edit',
+                }),
+                createSessionInfo({
+                    sessionId: 's-server',
+                    instanceId: 'inst-A',
+                    context: 'server',
+                }),
+            ];
+            host = await createMockHostWithSessions(sessions);
+            client = new BridgeClient();
+            await client.connectAsync(host.port);
+            const instances = client.listInstances();
+            expect(instances).toHaveLength(1);
+            expect(instances[0].instanceId).toBe('inst-A');
+            expect(instances[0].contexts.sort()).toEqual(['edit', 'server']);
+        });
+    });
+    describe('getSession', () => {
+        it('returns a BridgeSession for a known session', async () => {
+            const sessions = [createSessionInfo({ sessionId: 'session-x' })];
+            host = await createMockHostWithSessions(sessions);
+            client = new BridgeClient();
+            await client.connectAsync(host.port);
+            const session = client.getSession('session-x');
+            expect(session).toBeDefined();
+            expect(session.info.sessionId).toBe('session-x');
+        });
+        it('returns undefined for unknown session', async () => {
+            host = await createMockHost();
+            client = new BridgeClient();
+            await client.connectAsync(host.port);
+            expect(client.getSession('nonexistent')).toBeUndefined();
+        });
+    });
+    describe('action forwarding', () => {
+        it('sends HostEnvelope for session actions', async () => {
+            const sessions = [createSessionInfo({ sessionId: 'session-1' })];
+            host = await createMockHostWithSessions(sessions);
+            // Override host to respond to envelopes
+            host.wss.removeAllListeners('connection');
+            host.wss.on('connection', (ws) => {
+                host.clients.push(ws);
+                ws.on('message', (raw) => {
+                    const data = typeof raw === 'string' ? raw : raw.toString('utf-8');
+                    const msg = decodeHostMessage(data);
+                    if (!msg)
+                        return;
+                    host.receivedMessages.push(msg);
+                    if (msg.type === 'list-sessions') {
+                        ws.send(encodeHostMessage({
+                            type: 'list-sessions-response',
+                            requestId: msg.requestId,
+                            sessions,
+                        }));
+                    }
+                    if (msg.type === 'host-envelope') {
+                        // Respond with a host response
+                        ws.send(encodeHostMessage({
+                            type: 'host-response',
+                            requestId: msg.requestId,
+                            result: {
+                                type: 'stateResult',
+                                sessionId: 'session-1',
+                                requestId: msg.requestId,
+                                payload: {
+                                    state: 'Edit',
+                                    placeId: 100,
+                                    placeName: 'TestPlace',
+                                    gameId: 200,
+                                },
+                            },
+                        }));
+                    }
+                });
+            });
+            client = new BridgeClient();
+            await client.connectAsync(host.port);
+            const session = client.getSession('session-1');
+            expect(session).toBeDefined();
+            const result = await session.queryStateAsync();
+            expect(result.state).toBe('Edit');
+            expect(result.placeId).toBe(100);
+            // Verify that a host-envelope was sent
+            const envelopes = host.receivedMessages.filter((m) => m.type === 'host-envelope');
+            expect(envelopes.length).toBeGreaterThanOrEqual(1);
+        });
+    });
+    describe('session events', () => {
+        it('handles session-connected event from host', async () => {
+            host = await createMockHost();
+            client = new BridgeClient();
+            await client.connectAsync(host.port);
+            // Wait for client to be fully set up
+            await new Promise((r) => setTimeout(r, 50));
+            const connectedPromise = new Promise((resolve) => {
+                client.on('session-connected', (session) => {
+                    resolve(session.info.sessionId);
+                });
+            });
+            // Host broadcasts a session-connected event
+            host.clients[0].send(encodeHostMessage({
+                type: 'session-event',
+                event: 'connected',
+                session: createSessionInfo({ sessionId: 'new-session' }),
+                sessionId: 'new-session',
+                context: 'edit',
+                instanceId: 'inst-1',
+            }));
+            const sessionId = await connectedPromise;
+            expect(sessionId).toBe('new-session');
+            expect(client.listSessions()).toHaveLength(1);
+        });
+        it('handles session-disconnected event from host', async () => {
+            const sessions = [createSessionInfo({ sessionId: 'session-1' })];
+            host = await createMockHostWithSessions(sessions);
+            client = new BridgeClient();
+            await client.connectAsync(host.port);
+            expect(client.listSessions()).toHaveLength(1);
+            const disconnectedPromise = new Promise((resolve) => {
+                client.on('session-disconnected', resolve);
+            });
+            // Wait for client to be fully set up
+            await new Promise((r) => setTimeout(r, 50));
+            // Host broadcasts a session-disconnected event
+            host.clients[0].send(encodeHostMessage({
+                type: 'session-event',
+                event: 'disconnected',
+                sessionId: 'session-1',
+                context: 'edit',
+                instanceId: 'inst-1',
+            }));
+            const sessionId = await disconnectedPromise;
+            expect(sessionId).toBe('session-1');
+            expect(client.listSessions()).toHaveLength(0);
+        });
+    });
+    describe('disconnectAsync', () => {
+        it('disconnects and clears state', async () => {
+            const sessions = [createSessionInfo()];
+            host = await createMockHostWithSessions(sessions);
+            client = new BridgeClient();
+            await client.connectAsync(host.port);
+            expect(client.listSessions()).toHaveLength(1);
+            await client.disconnectAsync();
+            expect(client.isConnected).toBe(false);
+            expect(client.listSessions()).toHaveLength(0);
+        });
+    });
+});
+//# sourceMappingURL=bridge-client.test.js.map