browser-debugger-cli 0.0.1-alpha.0 → 0.1.0-alpha.1

package/dist/connection/__tests__/cdp.contract.test.js

@@ -0,0 +1,378 @@
+/* eslint-disable @typescript-eslint/no-floating-promises */
+/**
+ * CDPConnection contract tests
+ *
+ * Tests the public API contracts of CDPConnection WITHOUT testing implementation details.
+ * Uses FakeWebSocket to mock the WebSocket boundary while keeping all CDP logic real.
+ *
+ * Coverage:
+ * 1. Message correlation - Request/response pairing with IDs
+ * 2. Connection lifecycle - Connect, close, error handling
+ * 3. Timeouts - Connection timeout (10s), command timeout (30s)
+ * 4. Keepalive - Ping/pong lifecycle, missed pongs detection
+ * 5. Event subscription - on/off/removeAllListeners
+ * 6. Edge cases - Close during send, stale handlers, state transitions
+ */
+import assert from 'node:assert/strict';
+import { afterEach, beforeEach, describe, it } from 'node:test';
+import { createResponse, createErrorResponse, createEvent, } from '../../__testfixtures__/cdpMessages.js';
+import { FakeWebSocket } from '../../__testutils__/FakeWebSocket.js';
+import { useFakeClock } from '../../__testutils__/testClock.js';
+import { CDPConnection } from '../cdp.js';
+// Mock the 'ws' module to return our FakeWebSocket
+let mockWebSocket;
+describe('CDPConnection contract', () => {
+    const TEST_URL = 'ws://localhost:9222/devtools/browser';
+    let cdp;
+    async function connectAndOpen(options) {
+        const connectPromise = cdp.connect(TEST_URL, options);
+        mockWebSocket.simulateOpen();
+        await connectPromise;
+    }
+    function parseMessage(raw) {
+        return JSON.parse(raw);
+    }
+    // Shared setup for non-timer tests
+    beforeEach(() => {
+        mockWebSocket = new FakeWebSocket();
+        cdp = new CDPConnection(() => mockWebSocket);
+    });
+    afterEach(() => {
+        // Cleanup: close connection if still open
+        if (cdp.isConnected()) {
+            cdp.close();
+        }
+    });
+    describe('Message correlation', () => {
+        it('should pair requests with responses by message ID', async () => {
+            // Arrange: Create CDP connection with fake WebSocket
+            await connectAndOpen();
+            // Act: Send a CDP command
+            const resultPromise = cdp.send('Target.getTargets');
+            // Get the sent message
+            const messages = mockWebSocket.getSentMessages();
+            assert.equal(messages.length, 1);
+            const [firstMessage] = messages;
+            assert.ok(firstMessage, 'Expected a sent message');
+            const sentMessage = parseMessage(firstMessage);
+            assert.equal(typeof sentMessage.id, 'number');
+            const requestId = sentMessage.id;
+            // Simulate response with matching ID
+            const response = createResponse(requestId, { targetInfos: [] });
+            mockWebSocket.simulateMessage(JSON.stringify(response));
+            // Assert: Promise resolves with correct result
+            const result = await resultPromise;
+            assert.deepEqual(result, { targetInfos: [] });
+        });
+        it('should reject on error responses', async () => {
+            // Arrange
+            await connectAndOpen();
+            // Act: Send command
+            const resultPromise = cdp.send('Invalid.method');
+            const messages = mockWebSocket.getSentMessages();
+            const [firstMessage] = messages;
+            assert.ok(firstMessage, 'Expected a sent message');
+            const sentMessage = parseMessage(firstMessage);
+            assert.equal(typeof sentMessage.id, 'number');
+            const requestId = sentMessage.id;
+            // Simulate error response
+            const errorResponse = createErrorResponse(requestId, 'Method not found');
+            mockWebSocket.simulateMessage(JSON.stringify(errorResponse));
+            // Assert: Promise rejects with error message
+            await assert.rejects(resultPromise, /Method not found/);
+        });
+        it('should handle multiple concurrent requests', async () => {
+            // Arrange
+            await connectAndOpen();
+            // Act: Send three commands concurrently
+            const promise1 = cdp.send('Target.getTargets');
+            const promise2 = cdp.send('Browser.getVersion');
+            const promise3 = cdp.send('Page.navigate', { url: 'http://example.com' });
+            const messages = mockWebSocket.getSentMessages();
+            assert.equal(messages.length, 3);
+            // Simulate responses in different order (3, 1, 2)
+            const [message1, message2, message3] = messages;
+            if (message1 === undefined || message2 === undefined || message3 === undefined) {
+                throw new Error('Expected three sent messages');
+            }
+            const msg1 = parseMessage(message1);
+            const msg2 = parseMessage(message2);
+            const msg3 = parseMessage(message3);
+            assert.equal(typeof msg1.id, 'number');
+            assert.equal(typeof msg2.id, 'number');
+            assert.equal(typeof msg3.id, 'number');
+            mockWebSocket.simulateMessage(JSON.stringify(createResponse(msg3.id, { frameId: 'frame1' })));
+            mockWebSocket.simulateMessage(JSON.stringify(createResponse(msg1.id, { targetInfos: [] })));
+            mockWebSocket.simulateMessage(JSON.stringify(createResponse(msg2.id, { protocolVersion: '1.3' })));
+            // Assert: All promises resolve with correct results despite out-of-order responses
+            const [result1, result2, result3] = await Promise.all([promise1, promise2, promise3]);
+            assert.deepEqual(result1, { targetInfos: [] });
+            assert.deepEqual(result2, { protocolVersion: '1.3' });
+            assert.deepEqual(result3, { frameId: 'frame1' });
+        });
+    });
+    describe('Connection lifecycle', () => {
+        it('should resolve when WebSocket opens successfully', async () => {
+            // Arrange & Act
+            const connectPromise = cdp.connect(TEST_URL);
+            // Simulate successful open
+            mockWebSocket.simulateOpen();
+            // Assert: Connect resolves without error
+            await assert.doesNotReject(connectPromise);
+            assert.equal(cdp.isConnected(), true);
+        });
+        it('should throw error if connection fails', async () => {
+            const clock = useFakeClock();
+            try {
+                mockWebSocket = new FakeWebSocket();
+                cdp = new CDPConnection(() => mockWebSocket);
+                // Arrange & Act
+                const connectPromise = cdp.connect(TEST_URL, {
+                    maxRetries: 1,
+                });
+                // Simulate connection error immediately (before retry timer starts)
+                mockWebSocket.simulateError(new Error('Connection refused'));
+                // Advance time to trigger retry handling (even though maxRetries=1)
+                await clock.tickAndFlush(1000);
+                // Assert: Connect rejects with connection error
+                await assert.rejects(connectPromise, /Connection refused|Failed to connect/);
+                assert.equal(cdp.isConnected(), false);
+            }
+            finally {
+                clock.restore();
+            }
+        });
+        it('should cleanup on close and reject pending messages', async () => {
+            // Arrange
+            const connectPromise = cdp.connect(TEST_URL, {
+                maxRetries: 1,
+            });
+            mockWebSocket.simulateOpen();
+            await connectPromise;
+            // Send a command but don't respond
+            const pendingPromise = cdp.send('Target.getTargets');
+            // Act: Close connection
+            mockWebSocket.simulateClose(1000, 'Normal closure');
+            // Assert: Pending promise is rejected
+            await assert.rejects(pendingPromise, /connection closed/i);
+        });
+        it('should prevent sending commands when not connected', async () => {
+            // Arrange: No connection established
+            // Act & Assert: Sending command should throw immediately
+            await assert.rejects(() => cdp.send('Target.getTargets'), /Not connected to browser/);
+        });
+    });
+    // Timer-dependent tests: Install FakeClock in beforeEach
+    describe('Timeouts', () => {
+        let clockHelper;
+        beforeEach(() => {
+            // Install fake timers BEFORE creating CDP connection
+            clockHelper = useFakeClock();
+            mockWebSocket = new FakeWebSocket();
+            cdp = new CDPConnection(() => mockWebSocket);
+        });
+        afterEach(() => {
+            clockHelper.restore();
+            if (cdp.isConnected()) {
+                cdp.close();
+            }
+        });
+        it('should timeout connection after 10s by default', async () => {
+            // Arrange & Act: Start connection but never open WebSocket
+            const connectPromise = cdp.connect('ws://localhost:9222/devtools/browser', {
+                maxRetries: 1,
+            });
+            // Advance time by 10s (default connection timeout)
+            await clockHelper.tickAndFlush(10000);
+            // Assert: Connection times out
+            await assert.rejects(connectPromise, /Connection timeout|Failed to connect/);
+            assert.equal(clockHelper.clock.getPendingTimers(), 0);
+            assert.equal(clockHelper.clock.getPendingMicrotasks(), 0);
+        });
+        it('should timeout commands after 30s', async () => {
+            // Arrange: Establish connection
+            await connectAndOpen({ maxRetries: 1 });
+            // Act: Send command without responding
+            const commandPromise = cdp.send('Target.getTargets');
+            // Advance time by 30s (command timeout)
+            await clockHelper.tickAndFlush(30000);
+            // Assert: Command times out
+            await assert.rejects(commandPromise, /Command timeout/);
+            // Close connection to stop keepalive timers before checking pending handles
+            cdp.close();
+            assert.equal(clockHelper.clock.getPendingTimers(), 0);
+            assert.equal(clockHelper.clock.getPendingMicrotasks(), 0);
+        });
+    });
+    describe('Keepalive', () => {
+        let clockHelper;
+        beforeEach(() => {
+            // Install fake timers BEFORE creating CDP connection
+            clockHelper = useFakeClock();
+            mockWebSocket = new FakeWebSocket();
+            cdp = new CDPConnection(() => mockWebSocket);
+        });
+        afterEach(() => {
+            clockHelper.restore();
+            if (cdp.isConnected()) {
+                cdp.close();
+            }
+        });
+        it('should send ping at regular intervals', async () => {
+            // Arrange: Connect with 5s keepalive interval
+            await connectAndOpen({ keepaliveInterval: 5000, maxRetries: 1 });
+            // Act: Advance time by 5s
+            clockHelper.tick(5000);
+            // Assert: Ping sent
+            assert.equal(mockWebSocket.getPingSent(), 1);
+            // Act: Advance another 5s
+            clockHelper.tick(5000);
+            // Assert: Second ping sent
+            assert.equal(mockWebSocket.getPingSent(), 2);
+        });
+        it('should close connection after 3 missed pongs', async () => {
+            // Arrange: Connect with 1s keepalive
+            await connectAndOpen({ keepaliveInterval: 1000, maxRetries: 1 });
+            // Act: Miss 3 pongs (don't call simulatePong)
+            clockHelper.tick(1000); // 1st ping
+            clockHelper.tick(1000); // 2nd ping
+            clockHelper.tick(1000); // 3rd ping - should close
+            // Assert: Connection closed after 3 missed pongs
+            assert.equal(mockWebSocket.getCloseCode(), 1001);
+            assert.match(mockWebSocket.getCloseReason() ?? '', /No pong received/i);
+        });
+        it('should reset missed pong counter on pong received', async () => {
+            // Arrange
+            await connectAndOpen({ keepaliveInterval: 1000, maxRetries: 1 });
+            // Act: Miss 2 pongs, then receive one
+            clockHelper.tick(1000); // 1st ping
+            clockHelper.tick(1000); // 2nd ping
+            mockWebSocket.simulatePong(); // Reset counter
+            // Now miss 2 more - should NOT close (counter was reset)
+            clockHelper.tick(1000); // 3rd ping
+            clockHelper.tick(1000); // 4th ping
+            // Assert: Still connected (would close on 3rd consecutive miss)
+            assert.equal(cdp.isConnected(), true);
+        });
+    });
+    describe('Event subscription', () => {
+        it('should invoke event handlers when events arrive', async () => {
+            // Arrange
+            await connectAndOpen();
+            const receivedEvents = [];
+            cdp.on('Target.targetCreated', (params) => {
+                receivedEvents.push(params);
+            });
+            // Act: Simulate event
+            const event = createEvent('Target.targetCreated', {
+                targetInfo: { targetId: 't1', type: 'page' },
+            });
+            mockWebSocket.simulateMessage(JSON.stringify(event));
+            // Assert: Handler invoked
+            assert.equal(receivedEvents.length, 1);
+            assert.deepEqual(receivedEvents[0], { targetInfo: { targetId: 't1', type: 'page' } });
+        });
+        it('should allow multiple handlers for same event', async () => {
+            // Arrange
+            await connectAndOpen();
+            const handler1Called = [];
+            const handler2Called = [];
+            cdp.on('Network.requestWillBeSent', (params) => handler1Called.push(params));
+            cdp.on('Network.requestWillBeSent', (params) => handler2Called.push(params));
+            // Act: Simulate event
+            const event = createEvent('Network.requestWillBeSent', { requestId: 'req1' });
+            mockWebSocket.simulateMessage(JSON.stringify(event));
+            // Assert: Both handlers called
+            assert.equal(handler1Called.length, 1);
+            assert.equal(handler2Called.length, 1);
+        });
+        it('should remove handler with off()', async () => {
+            // Arrange
+            await connectAndOpen();
+            let callCount = 0;
+            const handlerId = cdp.on('Page.frameNavigated', () => callCount++);
+            // Act: Send event, then remove handler, then send again
+            const event = createEvent('Page.frameNavigated', { frame: { id: 'f1' } });
+            mockWebSocket.simulateMessage(JSON.stringify(event));
+            cdp.off('Page.frameNavigated', handlerId);
+            mockWebSocket.simulateMessage(JSON.stringify(event));
+            // Assert: Handler only called once (before removal)
+            assert.equal(callCount, 1);
+        });
+        it('should remove all handlers for event with removeAllListeners(event)', async () => {
+            // Arrange
+            await connectAndOpen();
+            let callCount1 = 0;
+            let callCount2 = 0;
+            cdp.on('Console.messageAdded', () => callCount1++);
+            cdp.on('Console.messageAdded', () => callCount2++);
+            // Act: Remove all handlers for this event
+            cdp.removeAllListeners('Console.messageAdded');
+            const event = createEvent('Console.messageAdded', { message: { text: 'test' } });
+            mockWebSocket.simulateMessage(JSON.stringify(event));
+            // Assert: No handlers called
+            assert.equal(callCount1, 0);
+            assert.equal(callCount2, 0);
+        });
+        it('should remove all handlers for all events with removeAllListeners()', async () => {
+            // Arrange
+            await connectAndOpen();
+            let callCount1 = 0;
+            let callCount2 = 0;
+            cdp.on('Network.requestWillBeSent', () => callCount1++);
+            cdp.on('Console.messageAdded', () => callCount2++);
+            // Act: Remove all handlers
+            cdp.removeAllListeners();
+            mockWebSocket.simulateMessage(JSON.stringify(createEvent('Network.requestWillBeSent', {})));
+            mockWebSocket.simulateMessage(JSON.stringify(createEvent('Console.messageAdded', {})));
+            // Assert: No handlers called
+            assert.equal(callCount1, 0);
+            assert.equal(callCount2, 0);
+        });
+    });
+    describe('Edge cases', () => {
+        it('should handle close during send (defensive copy test)', async () => {
+            // Arrange
+            await connectAndOpen();
+            // Act: Send command
+            const commandPromise = cdp.send('Target.getTargets');
+            // Capture messages snapshot before close
+            const messagesBefore = mockWebSocket.getSentMessages();
+            assert.equal(messagesBefore.length, 1);
+            // Close connection (should reject pending)
+            mockWebSocket.simulateClose(1000, 'Test close');
+            // Verify defensive copy: messagesBefore should be unchanged
+            assert.equal(messagesBefore.length, 1);
+            // Assert: Command rejected
+            await assert.rejects(commandPromise, /connection closed/i);
+        });
+        it('should return correct port from getPort()', async () => {
+            // Arrange & Act
+            const connectPromise = cdp.connect('ws://localhost:9444/devtools/browser');
+            mockWebSocket.simulateOpen();
+            await connectPromise;
+            // Assert: Port extracted correctly
+            const port = cdp.getPort();
+            assert.equal(port, 9444);
+        });
+        it('should throw if getPort() called before connect', () => {
+            // Arrange: No connection
+            // Act & Assert
+            assert.throws(() => cdp.getPort(), /Not connected/);
+        });
+        it('should handle events with sessionId', async () => {
+            // Arrange
+            const connectPromise = cdp.connect('ws://localhost:9222/devtools/browser');
+            mockWebSocket.simulateOpen();
+            await connectPromise;
+            const receivedEvents = [];
+            cdp.on('Page.frameNavigated', (params) => receivedEvents.push(params));
+            // Act: Event with sessionId
+            const event = createEvent('Page.frameNavigated', { frame: { id: 'f1' } }, 'session-123');
+            mockWebSocket.simulateMessage(JSON.stringify(event));
+            // Assert: Handler still invoked (sessionId doesn't affect event routing)
+            assert.equal(receivedEvents.length, 1);
+        });
+    });
+});
+//# sourceMappingURL=cdp.contract.test.js.map

package/dist/connection/__tests__/cdp.contract.test.js.map

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

package/dist/connection/__tests__/finder.contract.test.d.ts

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

package/dist/connection/__tests__/finder.contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finder.contract.test.d.ts","sourceRoot":"","sources":["../../../src/connection/__tests__/finder.contract.test.ts"],"names":[],"mappings":""}

package/dist/connection/__tests__/finder.contract.test.js

@@ -0,0 +1,239 @@
+import assert from 'node:assert/strict';
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import { createMockTarget, mockTargetList } from '../../__testfixtures__/connectionTargets.js';
+import { validateTarget } from '../finder.js';
+import { DEFAULT_CDP_PORT } from '../../constants.js';
+// Mock fetch globally for HTTP endpoints
+let originalFetch;
+let fetchCallHistory;
+let fetchMockResponses;
+let fetchCallCount;
+function setupFetchMock() {
+    originalFetch = global.fetch;
+    fetchCallHistory = [];
+    fetchMockResponses = [];
+    fetchCallCount = 0;
+    global.fetch = ((url, options) => {
+        fetchCallHistory.push({ url, options });
+        const responseIndex = fetchCallCount++;
+        const response = fetchMockResponses[responseIndex];
+        if (response) {
+            return response;
+        }
+        return Promise.reject(new Error(`Unexpected fetch call ${responseIndex + 1}: ${url}`));
+    });
+}
+function mockFetchResponse(response) {
+    fetchMockResponses.push(response);
+}
+function createSuccessResponse(data) {
+    return {
+        ok: true,
+        status: 200,
+        json: () => Promise.resolve(data),
+    };
+}
+function createFailureResponse(status, statusText) {
+    return {
+        ok: false,
+        status,
+        statusText,
+    };
+}
+void describe('Target Validation Contract', () => {
+    beforeEach(() => {
+        setupFetchMock();
+    });
+    afterEach(() => {
+        global.fetch = originalFetch;
+    });
+    void describe('validateTarget', () => {
+        void it('returns true when target exists in Chrome', async () => {
+            // Arrange: Mock target list containing the target
+            const targetId = 'target-123';
+            const existingTarget = createMockTarget({ id: targetId });
+            mockFetchResponse(createSuccessResponse([existingTarget, ...mockTargetList]));
+            // Act
+            const result = await validateTarget(targetId);
+            // Assert: Target is found
+            assert.equal(result, true);
+            // Verify correct HTTP endpoint was called
+            assert.equal(fetchCallHistory.length, 1);
+            const [firstCall] = fetchCallHistory;
+            assert.ok(firstCall, 'fetchCallHistory should have at least one entry');
+            assert.ok(firstCall.url.includes('/json/list'));
+            assert.ok(firstCall.url.includes(`127.0.0.1:${DEFAULT_CDP_PORT}`));
+        });
+        void it('returns false when target does not exist', async () => {
+            // Arrange: Mock target list without the target
+            const targetId = 'missing-target-456';
+            mockFetchResponse(createSuccessResponse(mockTargetList));
+            // Act
+            const result = await validateTarget(targetId);
+            // Assert: Target is not found
+            assert.equal(result, false);
+            // Verify HTTP endpoint was called
+            assert.equal(fetchCallHistory.length, 1);
+            const [firstCall] = fetchCallHistory;
+            assert.ok(firstCall, 'fetchCallHistory should have at least one entry');
+            assert.ok(firstCall.url.includes('/json/list'));
+        });
+        void it('returns false when HTTP request fails', async () => {
+            // Arrange: Mock HTTP failure
+            const targetId = 'target-123';
+            mockFetchResponse(createFailureResponse(500, 'Internal Server Error'));
+            // Act
+            const result = await validateTarget(targetId);
+            // Assert: Failure is handled gracefully
+            assert.equal(result, false);
+            // Verify HTTP endpoint was attempted
+            assert.equal(fetchCallHistory.length, 1);
+            const [firstCall] = fetchCallHistory;
+            assert.ok(firstCall, 'fetchCallHistory should have at least one entry');
+            assert.ok(firstCall.url.includes('/json/list'));
+        });
+        void it('returns false when response is malformed', async () => {
+            // Arrange: Mock malformed JSON response
+            const targetId = 'target-123';
+            const malformedResponse = {
+                ok: true,
+                status: 200,
+                json: () => Promise.reject(new Error('Invalid JSON')),
+            };
+            mockFetchResponse(malformedResponse);
+            // Act
+            const result = await validateTarget(targetId);
+            // Assert: Malformed response handled gracefully
+            assert.equal(result, false);
+        });
+        void it('uses correct port parameter', async () => {
+            // Arrange: Test with custom port
+            const targetId = 'target-123';
+            const customPort = 9333;
+            const existingTarget = createMockTarget({ id: targetId });
+            mockFetchResponse(createSuccessResponse([existingTarget]));
+            // Act
+            const result = await validateTarget(targetId, customPort);
+            // Assert: Target found and custom port used
+            assert.equal(result, true);
+            // Verify custom port was used in HTTP call
+            assert.equal(fetchCallHistory.length, 1);
+            const [firstCall] = fetchCallHistory;
+            assert.ok(firstCall, 'fetchCallHistory should have at least one entry');
+            assert.ok(firstCall.url.includes(`127.0.0.1:${customPort}`));
+            assert.ok(!firstCall.url.includes(`127.0.0.1:${DEFAULT_CDP_PORT}`));
+        });
+        void it('uses default port when not specified', async () => {
+            // Arrange: Call without port parameter
+            const targetId = 'target-123';
+            const existingTarget = createMockTarget({ id: targetId });
+            mockFetchResponse(createSuccessResponse([existingTarget]));
+            // Act
+            const result = await validateTarget(targetId);
+            // Assert: Uses default port
+            assert.equal(result, true);
+            // Verify default port was used
+            assert.equal(fetchCallHistory.length, 1);
+            const [firstCall] = fetchCallHistory;
+            assert.ok(firstCall, 'fetchCallHistory should have at least one entry');
+            assert.ok(firstCall.url.includes(`127.0.0.1:${DEFAULT_CDP_PORT}`));
+        });
+        void it('handles network errors gracefully', async () => {
+            // Arrange: Mock network error (connection refused, etc.)
+            const targetId = 'target-123';
+            mockFetchResponse(Promise.reject(new Error('ECONNREFUSED')));
+            // Act
+            const result = await validateTarget(targetId);
+            // Assert: Network error handled gracefully
+            assert.equal(result, false);
+        });
+        void it('handles empty target list', async () => {
+            // Arrange: Mock empty target list from Chrome
+            const targetId = 'target-123';
+            mockFetchResponse(createSuccessResponse([]));
+            // Act
+            const result = await validateTarget(targetId);
+            // Assert: Empty list handled correctly
+            assert.equal(result, false);
+        });
+        void it('handles target list with multiple matching IDs', async () => {
+            // Arrange: Mock target list with duplicate IDs (edge case)
+            const targetId = 'target-123';
+            const target1 = createMockTarget({ id: targetId, url: 'http://example.com/1' });
+            const target2 = createMockTarget({ id: targetId, url: 'http://example.com/2' });
+            mockFetchResponse(createSuccessResponse([target1, target2]));
+            // Act
+            const result = await validateTarget(targetId);
+            // Assert: First match is sufficient
+            assert.equal(result, true);
+        });
+    });
+    void describe('URL Construction', () => {
+        void it('constructs correct Chrome endpoint URL', async () => {
+            // Arrange
+            const targetId = 'target-123';
+            const port = 9555;
+            mockFetchResponse(createSuccessResponse([]));
+            // Act
+            await validateTarget(targetId, port);
+            // Assert: Correct URL format
+            const expectedUrl = `http://127.0.0.1:${port}/json/list`;
+            assert.equal(fetchCallHistory.length, 1);
+            const [firstCall] = fetchCallHistory;
+            assert.ok(firstCall, 'fetchCallHistory should have at least one entry');
+            assert.equal(firstCall.url, expectedUrl);
+        });
+        void it('uses localhost IP address consistently', async () => {
+            // Arrange
+            const targetId = 'target-123';
+            mockFetchResponse(createSuccessResponse([]));
+            // Act
+            await validateTarget(targetId);
+            // Assert: Uses 127.0.0.1 (not localhost hostname)
+            assert.equal(fetchCallHistory.length, 1);
+            const [firstCall] = fetchCallHistory;
+            assert.ok(firstCall, 'fetchCallHistory should have at least one entry');
+            assert.ok(firstCall.url.includes('127.0.0.1'));
+            assert.ok(!firstCall.url.includes('localhost'));
+        });
+    });
+    void describe('Edge Cases', () => {
+        void it('handles very long target IDs', async () => {
+            // Arrange: Create large target list (performance test)
+            const targetId = 'needle-in-haystack';
+            const largeTargetList = Array.from({ length: 1000 }, (_, i) => createMockTarget({ id: `target-${i}` }));
+            largeTargetList.push(createMockTarget({ id: targetId })); // Add target at end
+            mockFetchResponse(createSuccessResponse(largeTargetList));
+            // Act
+            const result = await validateTarget(targetId);
+            // Assert: Finds target even in large list
+            assert.equal(result, true);
+        });
+        void it('handles targets with special characters in ID', async () => {
+            // Arrange: Target with special characters
+            const targetId = 'target-with-special-chars-!@#$%^&*()';
+            const specialTarget = createMockTarget({ id: targetId });
+            mockFetchResponse(createSuccessResponse([specialTarget]));
+            // Act
+            const result = await validateTarget(targetId);
+            // Assert: Special characters handled correctly
+            assert.equal(result, true);
+        });
+        void it('handles null and undefined target IDs in list', async () => {
+            // Arrange: Malformed target list with null/undefined IDs
+            const targetId = 'valid-target';
+            const validTarget = createMockTarget({ id: targetId });
+            const malformedTargets = [
+                { ...createMockTarget(), id: null },
+                { ...createMockTarget(), id: undefined },
+                validTarget,
+            ];
+            mockFetchResponse(createSuccessResponse(malformedTargets));
+            // Act
+            const result = await validateTarget(targetId);
+            // Assert: Finds valid target despite malformed entries
+            assert.equal(result, true);
+        });
+    });
+});
+//# sourceMappingURL=finder.contract.test.js.map