@quenty/studio-bridge 0.7.1 → 0.8.0

package/dist/src/process/studio-process-manager.test.js

@@ -24,8 +24,25 @@ describe('findPluginsFolder', () => {
         expect(result).toContain('test');
         expect(result).toMatch(/Roblox[/\\]Plugins$/);
     });
-    it('throws on unsupported platform', () => {
+    it('returns correct Linux path using WINEPREFIX', () => {
+        Object.defineProperty(process, 'platform', { value: 'linux' });
+        process.env.WINEPREFIX = '/home/test/.wine';
+        process.env.USER = 'testuser';
+        const result = findPluginsFolder();
+        expect(result).toMatch(/Plugins$/);
+        expect(result).toContain('/home/test/.wine/drive_c/users/testuser');
+        expect(result).toContain('Roblox');
+    });
+    it('returns correct Linux path with default Wine prefix', () => {
         Object.defineProperty(process, 'platform', { value: 'linux' });
+        delete process.env.WINEPREFIX;
+        const result = findPluginsFolder();
+        expect(result).toMatch(/Plugins$/);
+        expect(result).toContain('.wine');
+        expect(result).toContain('Roblox');
+    });
+    it('throws on unsupported platform', () => {
+        Object.defineProperty(process, 'platform', { value: 'freebsd' });
         expect(() => findPluginsFolder()).toThrow('Unsupported platform');
     });
     it('throws when LOCALAPPDATA is missing on Windows', () => {

package/dist/src/process/studio-process-manager.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"studio-process-manager.test.js","sourceRoot":"","sources":["../../../src/process/studio-process-manager.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEhE,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,MAAM,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC1C,MAAM,WAAW,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAEvC,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC;QACxE,OAAO,CAAC,GAAG,GAAG,EAAE,GAAG,WAAW,EAAE,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,iCAAiC,CAAC;QAE7D,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,iCAAiC,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAChE,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,aAAa,CAAC;QAEjC,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;QACnC,uEAAuE;QACvE,sDAAsD;QACtD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAE/D,MAAM,CAAC,GAAG,EAAE,CAAC,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/D,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QAEhC,MAAM,CAAC,GAAG,EAAE,CAAC,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAChE,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QAExB,MAAM,CAAC,GAAG,EAAE,CAAC,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"studio-process-manager.test.js","sourceRoot":"","sources":["../../../src/process/studio-process-manager.test.ts"],"names":[],"mappings":"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"}

package/dist/src/server/action-dispatcher.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Action dispatcher for v2 protocol actions. Generates request IDs,
+ * tracks pending requests, applies per-action-type timeouts, and
+ * correlates incoming plugin responses to outgoing requests.
+ *
+ * Used by StudioBridgeServer for the v2 `performActionAsync` path.
+ * The v1 `executeAsync` path bypasses this entirely.
+ */
+import type { PluginMessage } from './web-socket-protocol.js';
+export declare const ACTION_TIMEOUTS: Record<string, number>;
+export declare class ActionDispatcher {
+    private _pendingRequests;
+    /**
+     * Create a new pending request for the given action type.
+     * Returns the generated requestId and a promise that resolves when
+     * the plugin responds (or rejects on timeout).
+     */
+    createRequestAsync(actionType: string, timeoutMs?: number): {
+        requestId: string;
+        responsePromise: Promise<PluginMessage>;
+    };
+    /**
+     * Handle an incoming plugin message. If it has a requestId and matches
+     * a pending request, resolves (or rejects for error type) the request.
+     * Returns true if the message was consumed by the dispatcher.
+     */
+    handleResponse(message: PluginMessage): boolean;
+    /**
+     * Cancel all pending requests, rejecting each with the given reason.
+     */
+    cancelAll(reason?: string): void;
+    /** Number of currently pending requests. */
+    get pendingCount(): number;
+}
+//# sourceMappingURL=action-dispatcher.d.ts.map

package/dist/src/server/action-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-dispatcher.d.ts","sourceRoot":"","sources":["../../../src/server/action-dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQlD,CAAC;AAEF,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,gBAAgB,CAA0C;IAElE;;;;OAIG;IACH,kBAAkB,CAChB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;KAAE;IAWjE;;;;OAIG;IACH,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO;IA2B/C;;OAEG;IACH,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAIhC,4CAA4C;IAC5C,IAAI,YAAY,IAAI,MAAM,CAEzB;CACF"}

package/dist/src/server/action-dispatcher.js

@@ -0,0 +1,67 @@
+/**
+ * Action dispatcher for v2 protocol actions. Generates request IDs,
+ * tracks pending requests, applies per-action-type timeouts, and
+ * correlates incoming plugin responses to outgoing requests.
+ *
+ * Used by StudioBridgeServer for the v2 `performActionAsync` path.
+ * The v1 `executeAsync` path bypasses this entirely.
+ */
+import { randomUUID } from 'crypto';
+import { PendingRequestMap } from './pending-request-map.js';
+export const ACTION_TIMEOUTS = {
+    queryState: 5_000,
+    captureScreenshot: 15_000,
+    queryDataModel: 10_000,
+    queryLogs: 10_000,
+    execute: 120_000,
+    subscribe: 5_000,
+    unsubscribe: 5_000,
+};
+export class ActionDispatcher {
+    _pendingRequests = new PendingRequestMap();
+    /**
+     * Create a new pending request for the given action type.
+     * Returns the generated requestId and a promise that resolves when
+     * the plugin responds (or rejects on timeout).
+     */
+    createRequestAsync(actionType, timeoutMs) {
+        const requestId = randomUUID();
+        const timeout = timeoutMs ?? ACTION_TIMEOUTS[actionType] ?? 30_000;
+        const responsePromise = this._pendingRequests.addRequestAsync(requestId, timeout);
+        return { requestId, responsePromise };
+    }
+    /**
+     * Handle an incoming plugin message. If it has a requestId and matches
+     * a pending request, resolves (or rejects for error type) the request.
+     * Returns true if the message was consumed by the dispatcher.
+     */
+    handleResponse(message) {
+        // Extract requestId from the message -- it may or may not exist
+        const requestId = 'requestId' in message ? message.requestId : undefined;
+        if (typeof requestId !== 'string') {
+            return false;
+        }
+        if (!this._pendingRequests.hasPendingRequest(requestId)) {
+            return false;
+        }
+        if (message.type === 'error') {
+            const errorMsg = message.payload.message ?? 'Unknown plugin error';
+            const code = message.payload.code ?? 'INTERNAL_ERROR';
+            this._pendingRequests.rejectRequest(requestId, new Error(`Plugin error [${code}]: ${errorMsg}`));
+            return true;
+        }
+        this._pendingRequests.resolveRequest(requestId, message);
+        return true;
+    }
+    /**
+     * Cancel all pending requests, rejecting each with the given reason.
+     */
+    cancelAll(reason) {
+        this._pendingRequests.cancelAll(reason);
+    }
+    /** Number of currently pending requests. */
+    get pendingCount() {
+        return this._pendingRequests.pendingCount;
+    }
+}
+//# sourceMappingURL=action-dispatcher.js.map

package/dist/src/server/action-dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-dispatcher.js","sourceRoot":"","sources":["../../../src/server/action-dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7D,MAAM,CAAC,MAAM,eAAe,GAA2B;IACrD,UAAU,EAAE,KAAK;IACjB,iBAAiB,EAAE,MAAM;IACzB,cAAc,EAAE,MAAM;IACtB,SAAS,EAAE,MAAM;IACjB,OAAO,EAAE,OAAO;IAChB,SAAS,EAAE,KAAK;IAChB,WAAW,EAAE,KAAK;CACnB,CAAC;AAEF,MAAM,OAAO,gBAAgB;IACnB,gBAAgB,GAAG,IAAI,iBAAiB,EAAiB,CAAC;IAElE;;;;OAIG;IACH,kBAAkB,CAChB,UAAkB,EAClB,SAAkB;QAElB,MAAM,SAAS,GAAG,UAAU,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,SAAS,IAAI,eAAe,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC;QACnE,MAAM,eAAe,GAAG,IAAI,CAAC,gBAAgB,CAAC,eAAe,CAC3D,SAAS,EACT,OAAO,CACR,CAAC;QAEF,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC;IACxC,CAAC;IAED;;;;OAIG;IACH,cAAc,CAAC,OAAsB;QACnC,gEAAgE;QAChE,MAAM,SAAS,GACb,WAAW,IAAI,OAAO,CAAC,CAAC,CAAE,OAAe,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QAElE,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAClC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;YACxD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,sBAAsB,CAAC;YACnE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,gBAAgB,CAAC;YACtD,IAAI,CAAC,gBAAgB,CAAC,aAAa,CACjC,SAAS,EACT,IAAI,KAAK,CAAC,iBAAiB,IAAI,MAAM,QAAQ,EAAE,CAAC,CACjD,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC,gBAAgB,CAAC,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAAe;QACvB,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,4CAA4C;IAC5C,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC;IAC5C,CAAC;CACF"}

package/dist/src/server/action-dispatcher.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Unit tests for ActionDispatcher -- validates request creation, response
+ * handling, timeout behavior, error handling, and cancel-all functionality.
+ */
+export {};
+//# sourceMappingURL=action-dispatcher.test.d.ts.map

package/dist/src/server/action-dispatcher.test.d.ts.map

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

package/dist/src/server/action-dispatcher.test.js

@@ -0,0 +1,173 @@
+/**
+ * Unit tests for ActionDispatcher -- validates request creation, response
+ * handling, timeout behavior, error handling, and cancel-all functionality.
+ */
+import { describe, it, expect, vi, afterEach, beforeEach } from 'vitest';
+import { ActionDispatcher, ACTION_TIMEOUTS } from './action-dispatcher.js';
+describe('ActionDispatcher', () => {
+    let dispatcher;
+    beforeEach(() => {
+        vi.useFakeTimers();
+        dispatcher = new ActionDispatcher();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    describe('createRequestAsync', () => {
+        it('generates a unique requestId', () => {
+            const req1 = dispatcher.createRequestAsync('queryState');
+            const req2 = dispatcher.createRequestAsync('queryState');
+            expect(req1.requestId).not.toBe(req2.requestId);
+            expect(typeof req1.requestId).toBe('string');
+            expect(req1.requestId.length).toBeGreaterThan(0);
+        });
+        it('returns a promise that can be resolved', async () => {
+            const { requestId, responsePromise } = dispatcher.createRequestAsync('queryState');
+            const response = {
+                type: 'stateResult',
+                sessionId: 'session-1',
+                requestId,
+                payload: { state: 'Edit', placeId: 0, placeName: 'Test', gameId: 0 },
+            };
+            // Resolve via handleResponse
+            const consumed = dispatcher.handleResponse(response);
+            expect(consumed).toBe(true);
+            const result = await responsePromise;
+            expect(result.type).toBe('stateResult');
+        });
+        it('increments pendingCount', () => {
+            expect(dispatcher.pendingCount).toBe(0);
+            dispatcher.createRequestAsync('queryState');
+            expect(dispatcher.pendingCount).toBe(1);
+            dispatcher.createRequestAsync('captureScreenshot');
+            expect(dispatcher.pendingCount).toBe(2);
+        });
+    });
+    describe('timeout', () => {
+        it('uses default timeout for known action type', async () => {
+            const { responsePromise } = dispatcher.createRequestAsync('queryState');
+            // Advance time just past the queryState timeout
+            vi.advanceTimersByTime(ACTION_TIMEOUTS.queryState + 100);
+            await expect(responsePromise).rejects.toThrow('timed out');
+        });
+        it('uses custom timeout when provided', async () => {
+            const { responsePromise } = dispatcher.createRequestAsync('queryState', 500);
+            vi.advanceTimersByTime(600);
+            await expect(responsePromise).rejects.toThrow('timed out');
+        });
+        it('does not reject before timeout', async () => {
+            const { requestId, responsePromise } = dispatcher.createRequestAsync('queryState');
+            // Advance time to just before the timeout
+            vi.advanceTimersByTime(ACTION_TIMEOUTS.queryState - 100);
+            // Should still be pending
+            expect(dispatcher.pendingCount).toBe(1);
+            // Now resolve it
+            dispatcher.handleResponse({
+                type: 'stateResult',
+                sessionId: 'session-1',
+                requestId,
+                payload: { state: 'Edit', placeId: 0, placeName: 'Test', gameId: 0 },
+            });
+            const result = await responsePromise;
+            expect(result.type).toBe('stateResult');
+        });
+        it('uses 30s fallback for unknown action type', async () => {
+            const { responsePromise } = dispatcher.createRequestAsync('unknownAction');
+            vi.advanceTimersByTime(31_000);
+            await expect(responsePromise).rejects.toThrow('timed out');
+        });
+    });
+    describe('handleResponse', () => {
+        it('resolves the matching pending request', async () => {
+            const { requestId, responsePromise } = dispatcher.createRequestAsync('captureScreenshot');
+            const response = {
+                type: 'screenshotResult',
+                sessionId: 'session-1',
+                requestId,
+                payload: { data: 'base64', format: 'png', width: 800, height: 600 },
+            };
+            const consumed = dispatcher.handleResponse(response);
+            expect(consumed).toBe(true);
+            expect(dispatcher.pendingCount).toBe(0);
+            const result = await responsePromise;
+            expect(result.type).toBe('screenshotResult');
+        });
+        it('returns false for messages without requestId', () => {
+            const consumed = dispatcher.handleResponse({
+                type: 'heartbeat',
+                sessionId: 'session-1',
+                payload: { uptimeMs: 1000, state: 'Edit', pendingRequests: 0 },
+            });
+            expect(consumed).toBe(false);
+        });
+        it('returns false for messages with unknown requestId', () => {
+            const consumed = dispatcher.handleResponse({
+                type: 'stateResult',
+                sessionId: 'session-1',
+                requestId: 'nonexistent-request',
+                payload: { state: 'Edit', placeId: 0, placeName: 'Test', gameId: 0 },
+            });
+            expect(consumed).toBe(false);
+        });
+        it('rejects pending request when plugin sends error response', async () => {
+            const { requestId, responsePromise } = dispatcher.createRequestAsync('queryDataModel');
+            const errorResponse = {
+                type: 'error',
+                sessionId: 'session-1',
+                requestId,
+                payload: {
+                    code: 'INSTANCE_NOT_FOUND',
+                    message: 'Instance not found at path game.NonExistent',
+                },
+            };
+            const consumed = dispatcher.handleResponse(errorResponse);
+            expect(consumed).toBe(true);
+            await expect(responsePromise).rejects.toThrow('INSTANCE_NOT_FOUND');
+            await expect(responsePromise).rejects.toThrow('Instance not found');
+        });
+        it('handles multiple concurrent requests independently', async () => {
+            const req1 = dispatcher.createRequestAsync('queryState');
+            const req2 = dispatcher.createRequestAsync('captureScreenshot');
+            expect(dispatcher.pendingCount).toBe(2);
+            // Resolve req2 first
+            dispatcher.handleResponse({
+                type: 'screenshotResult',
+                sessionId: 'session-1',
+                requestId: req2.requestId,
+                payload: { data: 'img', format: 'png', width: 100, height: 100 },
+            });
+            expect(dispatcher.pendingCount).toBe(1);
+            // Resolve req1
+            dispatcher.handleResponse({
+                type: 'stateResult',
+                sessionId: 'session-1',
+                requestId: req1.requestId,
+                payload: { state: 'Play', placeId: 1, placeName: 'Place', gameId: 2 },
+            });
+            expect(dispatcher.pendingCount).toBe(0);
+            const result1 = await req1.responsePromise;
+            const result2 = await req2.responsePromise;
+            expect(result1.type).toBe('stateResult');
+            expect(result2.type).toBe('screenshotResult');
+        });
+    });
+    describe('cancelAll', () => {
+        it('rejects all pending requests', async () => {
+            const req1 = dispatcher.createRequestAsync('queryState');
+            const req2 = dispatcher.createRequestAsync('captureScreenshot');
+            dispatcher.cancelAll('Server shutting down');
+            expect(dispatcher.pendingCount).toBe(0);
+            await expect(req1.responsePromise).rejects.toThrow('Server shutting down');
+            await expect(req2.responsePromise).rejects.toThrow('Server shutting down');
+        });
+        it('uses default message when no reason provided', async () => {
+            const { responsePromise } = dispatcher.createRequestAsync('queryState');
+            dispatcher.cancelAll();
+            await expect(responsePromise).rejects.toThrow('cancelled');
+        });
+        it('is safe to call when no requests pending', () => {
+            expect(() => dispatcher.cancelAll()).not.toThrow();
+        });
+    });
+});
+//# sourceMappingURL=action-dispatcher.test.js.map

package/dist/src/server/action-dispatcher.test.js.map

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

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

@@ -1,5 +1,5 @@
 export { StudioBridgeServer as StudioBridge } from './studio-bridge-server.js';
 export type { StudioBridgeServerOptions, ExecuteOptions, StudioBridgeResult, StudioBridgePhase, } from './studio-bridge-server.js';
 export { encodeMessage, decodePluginMessage } from './web-socket-protocol.js';
-export type { OutputLevel, PluginMessage, ServerMessage, HelloMessage, OutputMessage, ScriptCompleteMessage, WelcomeMessage, ExecuteMessage, ShutdownMessage, } from './web-socket-protocol.js';
+export type { OutputLevel, PluginMessage, ServerMessage, ScriptCompleteMessage, ExecuteMessage, ShutdownMessage, } from './web-socket-protocol.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,IAAI,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC/E,YAAY,EACV,yBAAyB,EACzB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC9E,YAAY,EACV,WAAW,EACX,aAAa,EACb,aAAa,EACb,YAAY,EACZ,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,eAAe,GAChB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,IAAI,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC/E,YAAY,EACV,yBAAyB,EACzB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC9E,YAAY,EACV,WAAW,EACX,aAAa,EACb,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,eAAe,GAChB,MAAM,0BAA0B,CAAC"}

package/dist/src/server/pending-request-map.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Request/response correlation layer for matching outgoing server requests
+ * to incoming plugin responses by requestId.
+ */
+export declare class PendingRequestMap<T> {
+    private _pending;
+    /**
+     * Register a pending request and return a promise that resolves when the
+     * response arrives or rejects on timeout/cancellation. If a request with
+     * the same ID is already pending, the new promise rejects immediately
+     * without disturbing the existing one.
+     */
+    addRequestAsync(requestId: string, timeoutMs: number): Promise<T>;
+    /**
+     * Resolve a pending request with the given result. Unknown IDs are
+     * silently ignored.
+     */
+    resolveRequest(requestId: string, result: T): void;
+    /**
+     * Reject a pending request with the given error. Unknown IDs are
+     * silently ignored.
+     */
+    rejectRequest(requestId: string, error: Error): void;
+    /**
+     * Cancel all pending requests, rejecting each with a cancellation error.
+     */
+    cancelAll(reason?: string): void;
+    /** Number of currently pending requests. */
+    get pendingCount(): number;
+    /** Whether a request with the given ID is currently pending. */
+    hasPendingRequest(requestId: string): boolean;
+}
+//# sourceMappingURL=pending-request-map.d.ts.map

package/dist/src/server/pending-request-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-request-map.d.ts","sourceRoot":"","sources":["../../../src/server/pending-request-map.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,qBAAa,iBAAiB,CAAC,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAsC;IAEtD;;;;;OAKG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAmBjE;;;OAGG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI;IASlD;;;OAGG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IASpD;;OAEG;IACH,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAShC,4CAA4C;IAC5C,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,gEAAgE;IAChE,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;CAG9C"}

package/dist/src/server/pending-request-map.js

@@ -0,0 +1,69 @@
+/**
+ * Request/response correlation layer for matching outgoing server requests
+ * to incoming plugin responses by requestId.
+ */
+export class PendingRequestMap {
+    _pending = new Map();
+    /**
+     * Register a pending request and return a promise that resolves when the
+     * response arrives or rejects on timeout/cancellation. If a request with
+     * the same ID is already pending, the new promise rejects immediately
+     * without disturbing the existing one.
+     */
+    addRequestAsync(requestId, timeoutMs) {
+        if (this._pending.has(requestId)) {
+            return Promise.reject(new Error(`Request "${requestId}" is already pending`));
+        }
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this._pending.delete(requestId);
+                reject(new Error(`Request "${requestId}" timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            this._pending.set(requestId, { resolve, reject, timer });
+        });
+    }
+    /**
+     * Resolve a pending request with the given result. Unknown IDs are
+     * silently ignored.
+     */
+    resolveRequest(requestId, result) {
+        const entry = this._pending.get(requestId);
+        if (!entry)
+            return;
+        clearTimeout(entry.timer);
+        this._pending.delete(requestId);
+        entry.resolve(result);
+    }
+    /**
+     * Reject a pending request with the given error. Unknown IDs are
+     * silently ignored.
+     */
+    rejectRequest(requestId, error) {
+        const entry = this._pending.get(requestId);
+        if (!entry)
+            return;
+        clearTimeout(entry.timer);
+        this._pending.delete(requestId);
+        entry.reject(error);
+    }
+    /**
+     * Cancel all pending requests, rejecting each with a cancellation error.
+     */
+    cancelAll(reason) {
+        const message = reason ?? 'All pending requests cancelled';
+        for (const [, entry] of this._pending) {
+            clearTimeout(entry.timer);
+            entry.reject(new Error(message));
+        }
+        this._pending.clear();
+    }
+    /** Number of currently pending requests. */
+    get pendingCount() {
+        return this._pending.size;
+    }
+    /** Whether a request with the given ID is currently pending. */
+    hasPendingRequest(requestId) {
+        return this._pending.has(requestId);
+    }
+}
+//# sourceMappingURL=pending-request-map.js.map

package/dist/src/server/pending-request-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-request-map.js","sourceRoot":"","sources":["../../../src/server/pending-request-map.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,OAAO,iBAAiB;IACpB,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEtD;;;;;OAKG;IACH,eAAe,CAAC,SAAiB,EAAE,SAAiB;QAClD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACjC,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,KAAK,CAAC,YAAY,SAAS,sBAAsB,CAAC,CACvD,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBAChC,MAAM,CACJ,IAAI,KAAK,CAAC,YAAY,SAAS,qBAAqB,SAAS,IAAI,CAAC,CACnE,CAAC;YACJ,CAAC,EAAE,SAAS,CAAC,CAAC;YAEd,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,cAAc,CAAC,SAAiB,EAAE,MAAS;QACzC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAChC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,SAAiB,EAAE,KAAY;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAChC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAAe;QACvB,MAAM,OAAO,GAAG,MAAM,IAAI,gCAAgC,CAAC;QAC3D,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC1B,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,4CAA4C;IAC5C,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;IAED,gEAAgE;IAChE,iBAAiB,CAAC,SAAiB;QACjC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/src/server/pending-request-map.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pending-request-map.test.d.ts.map

package/dist/src/server/pending-request-map.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-request-map.test.d.ts","sourceRoot":"","sources":["../../../src/server/pending-request-map.test.ts"],"names":[],"mappings":""}