browser-debugger-cli 0.6.0 → 0.6.2

package/dist/ipc/__tests__/guards.unit.test.js

@@ -0,0 +1,73 @@
+/**
+ * Protocol Guards Unit Tests
+ *
+ * Tests type guard behavior for command identification.
+ */
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+import { getCommandName, isCommandRequest, isCommandResponse } from '../../ipc/protocol/guards.js';
+void describe('isCommandRequest', () => {
+    void it('identifies all registered command requests', () => {
+        const validCommands = ['worker_peek', 'worker_status', 'cdp_call', 'worker_details'];
+        validCommands.forEach((cmd) => {
+            assert.ok(isCommandRequest(`${cmd}_request`), `Should identify ${cmd}_request`);
+        });
+    });
+    void it('rejects non-command requests', () => {
+        const invalid = ['status_request', 'handshake_request', 'start_session_request'];
+        invalid.forEach((type) => {
+            const result = isCommandRequest(type);
+            assert.equal(result, false, `Should reject ${type}`);
+        });
+    });
+    void it('rejects malformed request types', () => {
+        assert.ok(!isCommandRequest('worker_peek'));
+        assert.ok(!isCommandRequest('worker_peek_response'));
+        assert.ok(!isCommandRequest('invalid_request'));
+    });
+});
+void describe('isCommandResponse', () => {
+    void it('identifies all registered command responses', () => {
+        const validCommands = ['worker_peek', 'worker_status', 'cdp_call', 'worker_details'];
+        validCommands.forEach((cmd) => {
+            const type = `${cmd}_response`;
+            const result = isCommandResponse(type);
+            assert.ok(result, `Should identify ${type}, got ${result}`);
+        });
+    });
+    void it('rejects non-command responses', () => {
+        const invalid = ['status_response', 'handshake_response', 'stop_session_response'];
+        invalid.forEach((type) => {
+            const result = isCommandResponse(type);
+            assert.equal(result, false, `Should reject ${type}`);
+        });
+    });
+    void it('rejects malformed response types', () => {
+        assert.ok(!isCommandResponse('worker_peek'));
+        assert.ok(!isCommandResponse('worker_peek_request'));
+        assert.ok(!isCommandResponse('invalid_response'));
+    });
+});
+void describe('getCommandName', () => {
+    void it('extracts command name from request types', () => {
+        assert.equal(getCommandName('worker_peek_request'), 'worker_peek');
+        assert.equal(getCommandName('worker_status_request'), 'worker_status');
+        assert.equal(getCommandName('cdp_call_request'), 'cdp_call');
+    });
+    void it('extracts command name from response types', () => {
+        assert.equal(getCommandName('worker_peek_response'), 'worker_peek');
+        assert.equal(getCommandName('worker_status_response'), 'worker_status');
+        assert.equal(getCommandName('cdp_call_response'), 'cdp_call');
+    });
+    void it('returns null for non-command types', () => {
+        assert.equal(getCommandName('status_request'), null);
+        assert.equal(getCommandName('handshake_response'), null);
+        assert.equal(getCommandName('invalid_type'), null);
+    });
+    void it('returns null for malformed types', () => {
+        assert.equal(getCommandName('worker_peek'), null);
+        assert.equal(getCommandName('_request'), null);
+        assert.equal(getCommandName(''), null);
+    });
+});
+//# sourceMappingURL=guards.unit.test.js.map

package/dist/ipc/__tests__/guards.unit.test.js.map

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

package/dist/ipc/__tests__/jsonl.unit.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * JSONL Protocol Unit Tests
+ *
+ * Tests JSONL parsing and formatting behavior.
+ */
+export {};
+//# sourceMappingURL=jsonl.unit.test.d.ts.map

package/dist/ipc/__tests__/jsonl.unit.test.d.ts.map

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

package/dist/ipc/__tests__/jsonl.unit.test.js

@@ -0,0 +1,103 @@
+/**
+ * JSONL Protocol Unit Tests
+ *
+ * Tests JSONL parsing and formatting behavior.
+ */
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+import { JSONLBuffer, JSONLBufferOverflowError, parseJSONLFrame, toJSONLFrame, } from '../../ipc/transport/jsonl.js';
+void describe('JSONLBuffer', () => {
+    void it('handles partial frames across chunks', () => {
+        const buffer = new JSONLBuffer();
+        const lines1 = buffer.process('{"foo":');
+        assert.deepEqual(lines1, []);
+        const lines2 = buffer.process('"bar"}\n');
+        assert.deepEqual(lines2, ['{"foo":"bar"}']);
+    });
+    void it('processes multiple complete frames in one chunk', () => {
+        const buffer = new JSONLBuffer();
+        const lines = buffer.process('{"a":1}\n{"b":2}\n{"c":3}\n');
+        assert.deepEqual(lines, ['{"a":1}', '{"b":2}', '{"c":3}']);
+    });
+    void it('filters out empty lines', () => {
+        const buffer = new JSONLBuffer();
+        const lines = buffer.process('{"a":1}\n\n{"b":2}\n   \n');
+        assert.deepEqual(lines, ['{"a":1}', '{"b":2}']);
+    });
+    void it('accumulates across multiple chunks', () => {
+        const buffer = new JSONLBuffer();
+        buffer.process('{"type":"status",');
+        buffer.process('"sessionId":"123",');
+        const lines = buffer.process('"status":"ok"}\n');
+        assert.deepEqual(lines, ['{"type":"status","sessionId":"123","status":"ok"}']);
+    });
+    void it('clears buffer', () => {
+        const buffer = new JSONLBuffer();
+        buffer.process('{"incomplete":');
+        buffer.clear();
+        const lines = buffer.process('{"new":"message"}\n');
+        assert.deepEqual(lines, ['{"new":"message"}']);
+    });
+    void it('throws on buffer overflow', () => {
+        const buffer = new JSONLBuffer();
+        // Create a chunk larger than MAX_JSONL_BUFFER_SIZE (10MB) without newlines
+        const largeChunk = 'x'.repeat(11 * 1024 * 1024); // 11MB
+        assert.throws(() => {
+            buffer.process(largeChunk);
+        }, (error) => {
+            return error instanceof JSONLBufferOverflowError && error.message.includes('10485760');
+        });
+    });
+    void it('allows chunks under buffer limit', () => {
+        const buffer = new JSONLBuffer();
+        // Create a chunk just under the limit
+        const largeButValidChunk = '{"data":"' + 'x'.repeat(9 * 1024 * 1024) + '"}\n';
+        // Should not throw
+        const lines = buffer.process(largeButValidChunk);
+        assert.equal(lines.length, 1);
+    });
+});
+void describe('parseJSONLFrame', () => {
+    void it('parses valid JSON string', () => {
+        const result = parseJSONLFrame('{"type":"test","value":42}');
+        assert.equal(result.type, 'test');
+        assert.equal(result.value, 42);
+    });
+    void it('throws on invalid JSON', () => {
+        assert.throws(() => {
+            parseJSONLFrame('{"invalid": json}');
+        }, SyntaxError);
+    });
+    void it('handles complex nested objects', () => {
+        const result = parseJSONLFrame('{"data":{"nested":{"value":"test"}}}');
+        assert.equal(result.data.nested.value, 'test');
+    });
+});
+void describe('toJSONLFrame', () => {
+    void it('always adds newline', () => {
+        const inputs = [
+            { type: 'status' },
+            { type: 'peek', data: [] },
+            { complex: { nested: { value: true } } },
+        ];
+        inputs.forEach((input) => {
+            const result = toJSONLFrame(input);
+            assert.ok(result.endsWith('\n'));
+        });
+    });
+    void it('produces valid JSON', () => {
+        const input = { type: 'status', sessionId: '123', value: 42 };
+        const frame = toJSONLFrame(input);
+        const parsed = JSON.parse(frame.trim());
+        assert.deepEqual(parsed, input);
+    });
+    void it('handles empty objects', () => {
+        const result = toJSONLFrame({});
+        assert.equal(result, '{}\n');
+    });
+    void it('handles arrays', () => {
+        const result = toJSONLFrame([1, 2, 3]);
+        assert.equal(result, '[1,2,3]\n');
+    });
+});
+//# sourceMappingURL=jsonl.unit.test.js.map

package/dist/ipc/__tests__/jsonl.unit.test.js.map

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

package/dist/ipc/__tests__/validation.unit.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Response Validation Unit Tests
+ *
+ * Tests response validation behavior.
+ */
+export {};
+//# sourceMappingURL=validation.unit.test.d.ts.map

package/dist/ipc/__tests__/validation.unit.test.d.ts.map

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

package/dist/ipc/__tests__/validation.unit.test.js

@@ -0,0 +1,60 @@
+/**
+ * Response Validation Unit Tests
+ *
+ * Tests response validation behavior.
+ */
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+import { validateResponseType, validateSessionId } from '../../ipc/transport/validation.js';
+void describe('validateSessionId', () => {
+    void it('passes when session IDs match', () => {
+        const request = { sessionId: '123' };
+        const response = { sessionId: '123' };
+        assert.doesNotThrow(() => {
+            validateSessionId(request, response, 'test');
+        });
+    });
+    void it('throws when session IDs mismatch', () => {
+        const request = { sessionId: '123' };
+        const response = { sessionId: '456' };
+        assert.throws(() => {
+            validateSessionId(request, response, 'status');
+        }, {
+            message: /Response sessionId mismatch/,
+        });
+    });
+    void it('includes request name in error message', () => {
+        const request = { sessionId: 'abc' };
+        const response = { sessionId: 'xyz' };
+        assert.throws(() => {
+            validateSessionId(request, response, 'peek');
+        }, {
+            message: /peek/,
+        });
+    });
+});
+void describe('validateResponseType', () => {
+    void it('passes when response type matches expected', () => {
+        const response = { type: 'status_response' };
+        assert.doesNotThrow(() => {
+            validateResponseType(response, 'status_response', 'status');
+        });
+    });
+    void it('throws when response type does not match expected', () => {
+        const response = { type: 'peek_response' };
+        assert.throws(() => {
+            validateResponseType(response, 'status_response', 'status');
+        }, {
+            message: /Unexpected response type.*peek_response.*expected.*status_response/i,
+        });
+    });
+    void it('includes request name in error message', () => {
+        const response = { type: 'wrong_type' };
+        assert.throws(() => {
+            validateResponseType(response, 'expected_type', 'test_command');
+        }, {
+            message: /test_command/,
+        });
+    });
+});
+//# sourceMappingURL=validation.unit.test.js.map

package/dist/ipc/__tests__/validation.unit.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.unit.test.js","sourceRoot":"","sources":["../../../src/ipc/__tests__/validation.unit.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAExF,KAAK,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACtC,KAAK,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QAC5C,MAAM,OAAO,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QAEtC,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE;YACvB,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,KAAK,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC/C,MAAM,OAAO,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QAEtC,MAAM,CAAC,MAAM,CACX,GAAG,EAAE;YACH,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACjD,CAAC,EACD;YACE,OAAO,EAAE,6BAA6B;SACvC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,KAAK,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QACrD,MAAM,OAAO,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QAEtC,MAAM,CAAC,MAAM,CACX,GAAG,EAAE;YACH,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC/C,CAAC,EACD;YACE,OAAO,EAAE,MAAM;SAChB,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,KAAK,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACzC,KAAK,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACzD,MAAM,QAAQ,GAAG,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;QAE7C,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE;YACvB,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,QAAQ,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,KAAK,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAChE,MAAM,QAAQ,GAAG,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;QAE3C,MAAM,CAAC,MAAM,CACX,GAAG,EAAE;YACH,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,QAAQ,CAAC,CAAC;QAC9D,CAAC,EACD;YACE,OAAO,EAAE,qEAAqE;SAC/E,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,KAAK,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QACrD,MAAM,QAAQ,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;QAExC,MAAM,CAAC,MAAM,CACX,GAAG,EAAE;YACH,oBAAoB,CAAC,QAAQ,EAAE,eAAe,EAAE,cAAc,CAAC,CAAC;QAClE,CAAC,EACD;YACE,OAAO,EAAE,cAAc;SACxB,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/ipc/client.d.ts

@@ -1,124 +1,133 @@
 /**
- * IPC Client - Minimal JSONL handshake MVP
+ * IPC Client
  *
- * Connects to the daemon's Unix domain socket and performs handshake.
+ * Public API for communicating with the daemon via Unix socket.
+ * Provides high-level functions for session lifecycle and queries.
  */
-import type { ClientResponse } from '../ipc/commands.js';
-import type { HandshakeResponse, PeekResponse, StartSessionResponse, StatusResponse, StopSessionResponse } from '../ipc/types.js';
-import type { TelemetryType } from '../types.js';
+import type { ClientResponse } from './protocol/index.js';
+import type { HandshakeResponse, PeekResponse, SessionOptions, StartSessionResponse, StatusResponse, StopSessionResponse } from './session/index.js';
 /**
  * Connect to the daemon and perform handshake.
+ * Verifies daemon is running and ready to accept commands.
  *
- * @returns Handshake response from daemon
- * @throws Error if connection fails or handshake times out
+ * @returns Handshake response with connection status
+ * @throws Error if connection fails or times out
+ *
+ * @example
+ * ```typescript
+ * const response = await connectToDaemon();
+ * if (response.status === 'ok') {
+ *   console.log('Connected:', response.message);
+ * }
+ * ```
  */
 export declare function connectToDaemon(): Promise<HandshakeResponse>;
 /**
  * Request status information from the daemon.
+ * Returns daemon state, session metadata, and activity metrics.
+ *
+ * @returns Status response with daemon and session information
+ * @throws Error if connection fails or times out
  *
- * @returns Status response with daemon and session metadata
- * @throws Error if connection fails, daemon is not running, or request times out
+ * @example
+ * ```typescript
+ * const response = await getStatus();
+ * if (response.status === 'ok' && response.data) {
+ *   console.log('Daemon PID:', response.data.daemonPid);
+ *   console.log('Session active:', !!response.data.sessionPid);
+ * }
+ * ```
  */
 export declare function getStatus(): Promise<StatusResponse>;
 /**
  * Request preview data from the daemon.
+ * Returns snapshot of collected telemetry without stopping session.
+ *
+ * @returns Peek response with preview data
+ * @throws Error if connection fails, times out, or no active session
  *
- * @returns Peek response with session preview data
- * @throws Error if connection fails, daemon is not running, or request times out
+ * @example
+ * ```typescript
+ * const response = await getPeek();
+ * if (response.status === 'ok' && response.data) {
+ *   console.log('Network requests:', response.data.preview.data.network?.length);
+ *   console.log('Console messages:', response.data.preview.data.console?.length);
+ * }
+ * ```
  */
 export declare function getPeek(): Promise<PeekResponse>;
 /**
  * Request daemon to start a new browser session.
+ * Launches Chrome, establishes CDP connection, and begins telemetry collection.
  *
  * @param url - Target URL to navigate to
  * @param options - Session configuration options
- * @returns Start session response with worker and Chrome metadata
- * @throws Error if connection fails, daemon is not running, or request times out
- */
-export declare function startSession(url: string, options?: {
-    port?: number;
-    timeout?: number;
-    telemetry?: TelemetryType[];
-    includeAll?: boolean;
-    userDataDir?: string;
-    maxBodySize?: number;
-    headless?: boolean;
-    chromeWsUrl?: string;
-}): Promise<StartSessionResponse>;
-/**
- * Request session stop from the daemon.
+ * @returns Start session response with worker and Chrome PIDs
+ * @throws Error if connection fails, session already running, or Chrome launch fails
  *
- * @returns Stop session response with success/error status
- * @throws Error if connection fails, daemon is not running, or request times out
+ * @example
+ * ```typescript
+ * const response = await startSession('http://localhost:3000', {
+ *   timeout: 30,
+ *   headless: true,
+ *   maxBodySize: 10
+ * });
+ * if (response.status === 'ok' && response.data) {
+ *   console.log('Session started, worker PID:', response.data.workerPid);
+ * }
+ * ```
  */
-export declare function stopSession(): Promise<StopSessionResponse>;
+export declare function startSession(url: string, options?: SessionOptions): Promise<StartSessionResponse>;
 /**
- * Query DOM elements by CSS selector via the daemon's worker.
- *
- * @param selector - CSS selector to query
- * @returns DOM query response with matched elements
- * @throws Error if connection fails, daemon is not running, or request times out
- */
-export declare function queryDOM(selector: string): Promise<ClientResponse<'dom_query'>>;
-/**
- * Highlight DOM elements in the browser via the daemon's worker.
+ * Request session stop from the daemon.
+ * Stops telemetry collection, closes Chrome, and writes output file.
  *
- * @param options - Highlight options (selector, index, nodeId, color, etc.)
- * @returns DOM highlight response with highlighted node information
- * @throws Error if connection fails, daemon is not running, or request times out
- */
-export declare function highlightDOM(options: {
-    selector?: string;
-    index?: number;
-    nodeId?: number;
-    first?: boolean;
-    nth?: number;
-    color?: string;
-    opacity?: number;
-}): Promise<ClientResponse<'dom_highlight'>>;
-/**
- * Get full HTML and attributes for DOM elements via the daemon's worker.
+ * @returns Stop session response with termination status
+ * @throws Error if connection fails, times out, or no active session
  *
- * @param options - Get options (selector, index, nodeId, all, nth)
- * @returns DOM get response with node information
- * @throws Error if connection fails, daemon is not running, or request times out
+ * @example
+ * ```typescript
+ * const response = await stopSession();
+ * if (response.status === 'ok') {
+ *   console.log('Session stopped:', response.message);
+ * }
+ * ```
  */
-export declare function getDOM(options: {
-    selector?: string;
-    index?: number;
-    nodeId?: number;
-    all?: boolean;
-    nth?: number;
-}): Promise<ClientResponse<'dom_get'>>;
+export declare function stopSession(): Promise<StopSessionResponse>;
 /**
- * Capture page screenshot via the daemon's worker.
+ * Get details for a specific network request or console message.
+ * Retrieves full data (headers, body, stack trace) for a telemetry item.
  *
- * @param path - Output file path (absolute path)
- * @param options - Screenshot options (format, quality, fullPage)
- * @returns Screenshot response with metadata (path, dimensions, size)
- * @throws Error if connection fails, daemon is not running, or request times out
- */
-export declare function captureScreenshot(path: string, options?: {
-    format?: 'png' | 'jpeg';
-    quality?: number;
-    fullPage?: boolean;
-}): Promise<ClientResponse<'dom_screenshot'>>;
-/**
- * Get details for a specific network request or console message via the daemon's worker.
+ * @param type - Type of item to retrieve ('network' or 'console')
+ * @param id - Unique identifier of the item
+ * @returns Response with full item details
+ * @throws Error if connection fails or item not found
  *
- * @param type - Type of item: 'network' or 'console'
- * @param id - Request ID for network, index for console
- * @returns Worker details response with full object (including bodies/args)
- * @throws Error if connection fails, daemon is not running, or request times out
+ * @example
+ * ```typescript
+ * const response = await getDetails('network', 'req-123');
+ * if (response.status === 'ok' && response.data) {
+ *   console.log('Full request:', response.data.item);
+ * }
+ * ```
  */
 export declare function getDetails(type: 'network' | 'console', id: string): Promise<ClientResponse<'worker_details'>>;
 /**
  * Execute arbitrary CDP method via the daemon's worker.
+ * Forwards CDP commands to the worker's active CDP connection.
+ *
+ * @param method - CDP method name (e.g., 'Network.getCookies')
+ * @param params - Optional method parameters
+ * @returns Response with CDP method result
+ * @throws Error if connection fails or CDP method fails
  *
- * @param method - CDP method name (e.g., 'Network.getCookies', 'Runtime.evaluate')
- * @param params - CDP method parameters (optional)
- * @returns CDP call response with method result
- * @throws Error if connection fails, daemon is not running, or request times out
+ * @example
+ * ```typescript
+ * const response = await callCDP('Network.getCookies', {});
+ * if (response.status === 'ok' && response.data) {
+ *   console.log('Cookies:', response.data.result);
+ * }
+ * ```
  */
 export declare function callCDP(method: string, params?: Record<string, unknown>): Promise<ClientResponse<'cdp_call'>>;
 //# sourceMappingURL=client.d.ts.map

package/dist/ipc/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/ipc/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/ipc/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAiB,cAAc,EAAe,MAAM,qBAAqB,CAAC;AAEtF,OAAO,KAAK,EAEV,iBAAiB,EAEjB,YAAY,EACZ,cAAc,EAEd,oBAAoB,EAEpB,cAAc,EAEd,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAM5B;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAOlE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,cAAc,CAAC,CAGzD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC,CAGrD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,oBAAoB,CAAC,CAqB/B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAOhE;AA4BD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,SAAS,GAAG,SAAS,EAC3B,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAE3C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAErC"}