browser-debugger-cli 0.6.0 → 0.6.1

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

@@ -1,239 +0,0 @@
-import assert from 'node:assert/strict';
-import { describe, it, beforeEach, afterEach } from 'node:test';
-import { createMockTarget, mockTargetList } from '../../__testfixtures__/connectionTargets.js';
-import { validateTarget } from '../../connection/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

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

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

package/dist/connection/domOperations.d.ts

@@ -1,48 +0,0 @@
-import type { CDPConnection } from '../connection/cdp.js';
-/**
- * DOM node information from CDP
- */
-export interface DomNodeInfo {
-    nodeId: number;
-    tag?: string;
-    classes?: string[];
-    attributes?: Record<string, string>;
-    outerHTML?: string;
-    textContent?: string;
-}
-/**
- * Get document root node ID
- *
- * @param cdp - CDP connection instance
- * @returns Root node ID
- * @throws Error When CDP command fails or connection is lost
- */
-export declare function getDocumentRoot(cdp: CDPConnection): Promise<number>;
-/**
- * Query DOM by CSS selector
- *
- * @param cdp - CDP connection instance
- * @param selector - CSS selector to query
- * @param rootNodeId - Optional root node ID (defaults to document root)
- * @returns Array of node IDs matching the selector
- * @throws Error When CDP command fails or selector is invalid
- */
-export declare function queryBySelector(cdp: CDPConnection, selector: string, rootNodeId?: number): Promise<number[]>;
-/**
- * Get node information
- *
- * @param cdp - CDP connection instance
- * @param nodeId - Node ID to query
- * @returns Node information including tag, classes, attributes
- * @throws Error When CDP command fails or nodeId is invalid
- */
-export declare function getNodeInfo(cdp: CDPConnection, nodeId: number): Promise<DomNodeInfo>;
-/**
- * Create preview text for a node
- *
- * @param nodeInfo - Node information
- * @param maxLength - Maximum preview length (default: 50)
- * @returns Preview text
- */
-export declare function createNodePreview(nodeInfo: DomNodeInfo, maxLength?: number): string;
-//# sourceMappingURL=domOperations.d.ts.map

package/dist/connection/domOperations.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"domOperations.d.ts","sourceRoot":"","sources":["../../src/connection/domOperations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAKzE;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,EAAE,CAAC,CAUnB;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA8C1F;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,SAAK,GAAG,MAAM,CAoB/E"}

package/dist/connection/domOperations.js

@@ -1,106 +0,0 @@
-/**
- * Get document root node ID
- *
- * @param cdp - CDP connection instance
- * @returns Root node ID
- * @throws Error When CDP command fails or connection is lost
- */
-export async function getDocumentRoot(cdp) {
-    const result = (await cdp.send('DOM.getDocument', {
-        depth: -1,
-    }));
-    return result.root.nodeId;
-}
-/**
- * Query DOM by CSS selector
- *
- * @param cdp - CDP connection instance
- * @param selector - CSS selector to query
- * @param rootNodeId - Optional root node ID (defaults to document root)
- * @returns Array of node IDs matching the selector
- * @throws Error When CDP command fails or selector is invalid
- */
-export async function queryBySelector(cdp, selector, rootNodeId) {
-    // Get root node if not provided
-    const nodeId = rootNodeId ?? (await getDocumentRoot(cdp));
-    const result = (await cdp.send('DOM.querySelectorAll', {
-        nodeId,
-        selector,
-    }));
-    return result.nodeIds;
-}
-/**
- * Get node information
- *
- * @param cdp - CDP connection instance
- * @param nodeId - Node ID to query
- * @returns Node information including tag, classes, attributes
- * @throws Error When CDP command fails or nodeId is invalid
- */
-export async function getNodeInfo(cdp, nodeId) {
-    // Get node description
-    const describeResult = (await cdp.send('DOM.describeNode', {
-        nodeId,
-    }));
-    const node = describeResult.node;
-    // Parse attributes array into object
-    const attributes = {};
-    if (node.attributes) {
-        for (let i = 0; i < node.attributes.length; i += 2) {
-            const key = node.attributes[i];
-            const value = node.attributes[i + 1];
-            if (key !== undefined && value !== undefined) {
-                attributes[key] = value;
-            }
-        }
-    }
-    // Extract classes from class attribute
-    const classes = attributes['class']?.split(/\s+/).filter((c) => c.length > 0) ?? [];
-    // Get outer HTML
-    const htmlResult = (await cdp.send('DOM.getOuterHTML', {
-        nodeId,
-    }));
-    // Extract text content by removing HTML tags
-    // Uses simple regex to strip tags while preserving text content including < and > in text
-    // SAFETY: This HTML comes from Chrome's internal DOM via CDP, not user input.
-    // It's trusted browser-generated content used only for display/analysis in CLI output.
-    // The regex is intentionally simple because we're extracting text, not sanitizing for XSS.
-    const textContent = htmlResult.outerHTML
-        .replace(/<[^>]*>/g, '') // Remove HTML tags
-        .replace(/\s+/g, ' ') // Collapse whitespace
-        .trim();
-    return {
-        nodeId,
-        tag: node.nodeName.toLowerCase(),
-        classes,
-        attributes,
-        outerHTML: htmlResult.outerHTML,
-        textContent,
-    };
-}
-/**
- * Create preview text for a node
- *
- * @param nodeInfo - Node information
- * @param maxLength - Maximum preview length (default: 50)
- * @returns Preview text
- */
-export function createNodePreview(nodeInfo, maxLength = 50) {
-    // If we have text content, use that
-    if (nodeInfo.textContent && nodeInfo.textContent.length > 0) {
-        const text = nodeInfo.textContent;
-        if (text.length > maxLength) {
-            return text.slice(0, maxLength) + '...';
-        }
-        return text;
-    }
-    // Otherwise show the opening tag
-    const tag = nodeInfo.tag ?? 'unknown';
-    const classAttr = nodeInfo.classes && nodeInfo.classes.length > 0 ? ` class="${nodeInfo.classes.join(' ')}"` : '';
-    const preview = `<${tag}${classAttr}>`;
-    if (preview.length > maxLength) {
-        return preview.slice(0, maxLength) + '...';
-    }
-    return preview;
-}
-//# sourceMappingURL=domOperations.js.map

package/dist/connection/domOperations.js.map

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

package/dist/connection/finder.d.ts

@@ -1,12 +0,0 @@
-/**
- * Validate that a CDP target still exists.
- *
- * This function polls Chrome's target list to verify the target hasn't been closed.
- * Used during long-running sessions to detect tab closures.
- *
- * @param targetId - Target ID to validate
- * @param port - Chrome debugging port (defaults to centralized DEFAULT_CDP_PORT)
- * @returns True if target still exists, false otherwise
- */
-export declare function validateTarget(targetId: string, port?: number): Promise<boolean>;
-//# sourceMappingURL=finder.d.ts.map

package/dist/connection/finder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"finder.d.ts","sourceRoot":"","sources":["../../src/connection/finder.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,SAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAGhG"}

package/dist/connection/finder.js

@@ -1,17 +0,0 @@
-import { DEFAULT_CDP_PORT } from '../constants.js';
-import { fetchCDPTargets } from '../utils/http.js';
-/**
- * Validate that a CDP target still exists.
- *
- * This function polls Chrome's target list to verify the target hasn't been closed.
- * Used during long-running sessions to detect tab closures.
- *
- * @param targetId - Target ID to validate
- * @param port - Chrome debugging port (defaults to centralized DEFAULT_CDP_PORT)
- * @returns True if target still exists, false otherwise
- */
-export async function validateTarget(targetId, port = DEFAULT_CDP_PORT) {
-    const targets = await fetchCDPTargets(port);
-    return targets.some((t) => t.id === targetId);
-}
-//# sourceMappingURL=finder.js.map

package/dist/connection/finder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"finder.js","sourceRoot":"","sources":["../../src/connection/finder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB,EAAE,IAAI,GAAG,gBAAgB;IAC5E,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;AAChD,CAAC"}