browser-debugger-cli 0.5.1 → 0.6.1

package/dist/collectors/console.js

@@ -1,87 +0,0 @@
-import { MAX_CONSOLE_MESSAGES } from '../constants.js';
-import { CDPHandlerRegistry } from '../utils/cdpHandlers.js';
-import { shouldExcludeConsoleMessage } from '../utils/filters.js';
-/**
- * Start collecting console messages and exceptions via CDP Runtime domain.
- *
- * Captures console.log, console.error, etc. and JavaScript exceptions thrown in the page.
- *
- * @param cdp - CDP connection instance
- * @param messages - Array to populate with console messages
- * @param includeAll - If true, disable default pattern filtering (default: false)
- * @returns Cleanup function to remove event handlers
- *
- * @remarks
- * - Message limit of 10,000 prevents memory issues in long-running sessions
- * - After limit is reached, new messages are silently dropped (warning logged once)
- * - By default, common dev server noise patterns are filtered out (use includeAll to disable)
- */
-export async function startConsoleCollection(cdp, messages, includeAll = false) {
-    const registry = new CDPHandlerRegistry();
-    // Enable runtime
-    await cdp.send('Runtime.enable');
-    await cdp.send('Log.enable');
-    // Listen for console API calls
-    registry.register(cdp, 'Runtime.consoleAPICalled', (params) => {
-        const text = params.args
-            .map((arg) => {
-            // arg type already defined in CDPConsoleAPICalledParams
-            if (arg.value !== undefined) {
-                // Handle different value types - primitives only, objects use description
-                const value = arg.value;
-                if (typeof value === 'string' ||
-                    typeof value === 'number' ||
-                    typeof value === 'boolean') {
-                    return String(value);
-                }
-                // For objects/arrays, use description if available
-                return arg.description ?? '[object]';
-            }
-            if (arg.description !== undefined) {
-                return arg.description;
-            }
-            return '';
-        })
-            .join(' ');
-        // Apply pattern filtering
-        if (shouldExcludeConsoleMessage(text, includeAll)) {
-            return;
-        }
-        const message = {
-            type: params.type,
-            text,
-            timestamp: params.timestamp,
-            args: params.args,
-        };
-        if (messages.length < MAX_CONSOLE_MESSAGES) {
-            messages.push(message);
-        }
-        else if (messages.length === MAX_CONSOLE_MESSAGES) {
-            console.error(`Warning: Console message limit reached (${MAX_CONSOLE_MESSAGES})`);
-        }
-    });
-    // Listen for exceptions
-    registry.register(cdp, 'Runtime.exceptionThrown', (params) => {
-        const exception = params.exceptionDetails;
-        const text = exception.text ?? exception.exception?.description ?? 'Unknown error';
-        // Apply pattern filtering (but don't filter errors by default)
-        // Errors are usually important, only filter if they match noise patterns
-        if (shouldExcludeConsoleMessage(text, includeAll)) {
-            return;
-        }
-        const message = {
-            type: 'error',
-            text,
-            timestamp: exception.timestamp ?? Date.now(),
-        };
-        if (messages.length < MAX_CONSOLE_MESSAGES) {
-            messages.push(message);
-        }
-    });
-    // Return cleanup function
-    return () => {
-        // Remove event handlers
-        registry.cleanup(cdp);
-    };
-}
-//# sourceMappingURL=console.js.map

package/dist/collectors/console.js.map

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

package/dist/collectors/dom.d.ts

@@ -1,21 +0,0 @@
-import type { CDPConnection } from '../connection/cdp.js';
-import type { DOMData, CleanupFunction } from '../types.js';
-/**
- * Prepare CDP domains for DOM collection.
- *
- * Enables Page, DOM, and Runtime domains required for capturing DOM snapshots.
- *
- * @param cdp - CDP connection instance
- * @returns Cleanup function that disables Runtime domain
- */
-export declare function prepareDOMCollection(cdp: CDPConnection): Promise<CleanupFunction>;
-/**
- * Capture a complete DOM snapshot of the current page.
- *
- * Called during session shutdown to get the final state of the page.
- *
- * @param cdp - CDP connection instance
- * @returns DOM data including URL, title, and full HTML
- */
-export declare function collectDOM(cdp: CDPConnection): Promise<DOMData>;
-//# sourceMappingURL=dom.d.ts.map

package/dist/collectors/dom.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../src/collectors/dom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EACV,OAAO,EACP,eAAe,EAKhB,MAAM,SAAS,CAAC;AAEjB;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAsBvF;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAoFrE"}

package/dist/collectors/dom.js

@@ -1,99 +0,0 @@
-/**
- * Prepare CDP domains for DOM collection.
- *
- * Enables Page, DOM, and Runtime domains required for capturing DOM snapshots.
- *
- * @param cdp - CDP connection instance
- * @returns Cleanup function that disables Runtime domain
- */
-export async function prepareDOMCollection(cdp) {
-    // Enable Page domain for frame tree
-    await cdp.send('Page.enable');
-    // Enable DOM domain for document access
-    await cdp.send('DOM.enable');
-    // Enable Runtime domain for document.title evaluation
-    await cdp.send('Runtime.enable');
-    // Return cleanup function that disables Runtime domain
-    return () => {
-        // Disable Runtime domain to clean up resources
-        // Note: This is best-effort during shutdown; errors are ignored
-        try {
-            cdp.send('Runtime.disable').catch(() => {
-                // Ignore errors during cleanup (Chrome may be closing)
-            });
-        }
-        catch {
-            // Ignore synchronous errors
-        }
-    };
-}
-/**
- * Capture a complete DOM snapshot of the current page.
- *
- * Called during session shutdown to get the final state of the page.
- *
- * @param cdp - CDP connection instance
- * @returns DOM data including URL, title, and full HTML
- */
-export async function collectDOM(cdp) {
-    const domCaptureStart = Date.now();
-    try {
-        // Add a timeout wrapper to prevent hanging
-        const timeout = 5000; // 5 seconds should be plenty for DOM capture
-        const captureWithTimeout = async (promise, label) => {
-            return Promise.race([
-                promise,
-                new Promise((_, reject) => setTimeout(() => reject(new Error(`${label} timed out after ${timeout}ms`)), timeout)),
-            ]);
-        };
-        // Get document
-        console.error('Getting document...');
-        const docStart = Date.now();
-        const documentResponse = await captureWithTimeout(cdp.send('DOM.getDocument', { depth: -1 }), 'DOM.getDocument');
-        const root = documentResponse.root;
-        console.error(`[PERF] DOM.getDocument: ${Date.now() - docStart}ms (nodeId: ${root.nodeId})`);
-        // Get outer HTML
-        console.error('Getting outer HTML...');
-        const htmlStart = Date.now();
-        const htmlResponse = await captureWithTimeout(cdp.send('DOM.getOuterHTML', { nodeId: root.nodeId }), 'DOM.getOuterHTML');
-        const outerHTML = htmlResponse.outerHTML;
-        console.error(`[PERF] DOM.getOuterHTML: ${Date.now() - htmlStart}ms (${outerHTML.length} chars)`);
-        // Get page info
-        console.error('Getting page info...');
-        const frameStart = Date.now();
-        const frameTreeResponse = await captureWithTimeout(cdp.send('Page.getFrameTree'), 'Page.getFrameTree');
-        const frame = frameTreeResponse.frameTree.frame;
-        console.error(`[PERF] Page.getFrameTree: ${Date.now() - frameStart}ms (url: ${frame.url})`);
-        // Get real document title using Runtime.evaluate
-        console.error('Getting document title...');
-        let title = 'Untitled';
-        try {
-            const titleStart = Date.now();
-            const titleResult = await captureWithTimeout(cdp.send('Runtime.evaluate', {
-                expression: 'document.title',
-                returnByValue: true,
-            }), 'Runtime.evaluate (document.title)');
-            if (titleResult.result.value !== undefined && typeof titleResult.result.value === 'string') {
-                title = titleResult.result.value;
-            }
-            console.error(`[PERF] Runtime.evaluate (title): ${Date.now() - titleStart}ms`);
-        }
-        catch (titleError) {
-            console.error('Failed to get document title, using fallback:', titleError);
-        }
-        console.error(`Got document title: ${title}`);
-        const url = frame.url;
-        const totalDuration = Date.now() - domCaptureStart;
-        console.error(`[PERF] Total DOM capture: ${totalDuration}ms`);
-        return {
-            url,
-            title,
-            outerHTML,
-        };
-    }
-    catch (error) {
-        console.error('Error in collectDOM:', error);
-        throw error;
-    }
-}
-//# sourceMappingURL=dom.js.map

package/dist/collectors/dom.js.map

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

package/dist/collectors/network.d.ts

@@ -1,32 +0,0 @@
-import type { CDPConnection } from '../connection/cdp.js';
-import type { NetworkRequest, CleanupFunction } from '../types.js';
-export interface NetworkCollectionOptions {
-    includeAll?: boolean;
-    fetchAllBodies?: boolean;
-    fetchBodiesInclude?: string[];
-    fetchBodiesExclude?: string[];
-    networkInclude?: string[];
-    networkExclude?: string[];
-}
-/**
- * Start collecting network requests via CDP Network domain.
- *
- * Tracks all HTTP requests and responses, including headers and bodies (for JSON/text responses).
- * Implements automatic cleanup of stale requests to prevent memory leaks during long sessions.
- *
- * @param cdp - CDP connection instance
- * @param requests - Array to populate with completed network requests
- * @param options - Collection options
- * @returns Cleanup function to remove event handlers and clear state
- *
- * @remarks
- * - Chrome buffer limits: 50MB total, 10MB per resource, 1MB POST data (with fallback)
- * - Stale requests (incomplete after 60s) are removed from tracking but NOT added to output
- * - Request limit of 10,000 prevents memory issues in long-running sessions
- * - Response bodies are automatically skipped for images, fonts, CSS, and source maps (see DEFAULT_SKIP_BODY_PATTERNS)
- * - Response bodies larger than 5MB are skipped with a placeholder message
- * - By default, common tracking/analytics domains are filtered out (use includeAll to disable)
- * - Pattern precedence: include patterns always trump exclude patterns
- */
-export declare function startNetworkCollection(cdp: CDPConnection, requests: NetworkRequest[], options?: NetworkCollectionOptions): Promise<CleanupFunction>;
-//# sourceMappingURL=network.d.ts.map

package/dist/collectors/network.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/collectors/network.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAUzD,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAMhB,MAAM,SAAS,CAAC;AAIjB,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,cAAc,EAAE,EAC1B,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,eAAe,CAAC,CAuN1B"}

package/dist/collectors/network.js

@@ -1,191 +0,0 @@
-import { MAX_NETWORK_REQUESTS, STALE_REQUEST_TIMEOUT, STALE_REQUEST_CLEANUP_INTERVAL, MAX_RESPONSE_SIZE, CHROME_NETWORK_BUFFER_TOTAL, CHROME_NETWORK_BUFFER_PER_RESOURCE, CHROME_POST_DATA_LIMIT, } from '../constants.js';
-import { CDPHandlerRegistry } from '../utils/cdpHandlers.js';
-import { shouldExcludeDomain, shouldExcludeUrl, shouldFetchBody } from '../utils/filters.js';
-/**
- * Start collecting network requests via CDP Network domain.
- *
- * Tracks all HTTP requests and responses, including headers and bodies (for JSON/text responses).
- * Implements automatic cleanup of stale requests to prevent memory leaks during long sessions.
- *
- * @param cdp - CDP connection instance
- * @param requests - Array to populate with completed network requests
- * @param options - Collection options
- * @returns Cleanup function to remove event handlers and clear state
- *
- * @remarks
- * - Chrome buffer limits: 50MB total, 10MB per resource, 1MB POST data (with fallback)
- * - Stale requests (incomplete after 60s) are removed from tracking but NOT added to output
- * - Request limit of 10,000 prevents memory issues in long-running sessions
- * - Response bodies are automatically skipped for images, fonts, CSS, and source maps (see DEFAULT_SKIP_BODY_PATTERNS)
- * - Response bodies larger than 5MB are skipped with a placeholder message
- * - By default, common tracking/analytics domains are filtered out (use includeAll to disable)
- * - Pattern precedence: include patterns always trump exclude patterns
- */
-export async function startNetworkCollection(cdp, requests, options = {}) {
-    const { includeAll = false, fetchAllBodies = false, fetchBodiesInclude = [], fetchBodiesExclude = [], networkInclude = [], networkExclude = [], } = options;
-    const requestMap = new Map();
-    const registry = new CDPHandlerRegistry();
-    // Counters for PERF logging
-    let bodiesFetched = 0;
-    let bodiesSkipped = 0;
-    // Enable network tracking with buffer limits (if supported)
-    // These parameters are optional and experimental, but widely supported in Chrome 58+
-    // See docs/chrome-cdp-compatibility.md for details
-    try {
-        await cdp.send('Network.enable', {
-            maxTotalBufferSize: CHROME_NETWORK_BUFFER_TOTAL,
-            maxResourceBufferSize: CHROME_NETWORK_BUFFER_PER_RESOURCE,
-            maxPostDataSize: CHROME_POST_DATA_LIMIT,
-        });
-    }
-    catch {
-        // Fallback to basic Network.enable if buffer parameters not supported
-        console.error('Network buffer limits not supported, using default settings');
-        await cdp.send('Network.enable');
-    }
-    // Periodic cleanup of stale requests (see JSDoc @remarks for behavior)
-    const cleanupInterval = setInterval(() => {
-        const now = Date.now();
-        const staleRequests = [];
-        requestMap.forEach((value, requestId) => {
-            if (now - value.timestamp > STALE_REQUEST_TIMEOUT) {
-                staleRequests.push(requestId);
-            }
-        });
-        if (staleRequests.length > 0) {
-            console.error(`Cleaning up ${staleRequests.length} stale network requests`);
-            staleRequests.forEach((requestId) => requestMap.delete(requestId));
-        }
-    }, STALE_REQUEST_CLEANUP_INTERVAL);
-    // Listen for requests
-    registry.register(cdp, 'Network.requestWillBeSent', (params) => {
-        if (requestMap.size >= MAX_NETWORK_REQUESTS) {
-            console.error(`Warning: Network request limit reached (${MAX_NETWORK_REQUESTS}), dropping new requests`);
-            return;
-        }
-        const request = {
-            requestId: params.requestId,
-            url: params.request.url,
-            method: params.request.method,
-            timestamp: params.timestamp,
-            requestHeaders: params.request.headers,
-            requestBody: params.request.postData,
-        };
-        requestMap.set(params.requestId, {
-            request,
-            timestamp: Date.now(),
-        });
-    });
-    // Listen for responses
-    registry.register(cdp, 'Network.responseReceived', (params) => {
-        const entry = requestMap.get(params.requestId);
-        if (entry) {
-            entry.request.status = params.response.status;
-            entry.request.mimeType = params.response.mimeType;
-            entry.request.responseHeaders = params.response.headers;
-        }
-    });
-    // Listen for finished requests
-    registry.register(cdp, 'Network.loadingFinished', (params) => {
-        const entry = requestMap.get(params.requestId);
-        if (entry && requests.length < MAX_NETWORK_REQUESTS) {
-            const request = entry.request;
-            // Apply domain filtering
-            if (shouldExcludeDomain(request.url, includeAll)) {
-                requestMap.delete(params.requestId);
-                return;
-            }
-            // Apply URL pattern filtering
-            if (shouldExcludeUrl(request.url, {
-                includePatterns: networkInclude,
-                excludePatterns: networkExclude,
-            })) {
-                requestMap.delete(params.requestId);
-                return;
-            }
-            // Determine if we should fetch the response body
-            const isSizeAcceptable = params.encodedDataLength <= MAX_RESPONSE_SIZE;
-            const isTextResponse = (request.mimeType?.includes('json') ?? false) ||
-                (request.mimeType?.includes('javascript') ?? false) ||
-                (request.mimeType?.includes('text') ?? false) ||
-                (request.mimeType?.includes('html') ?? false);
-            if (isTextResponse && isSizeAcceptable) {
-                // Check if we should fetch body based on patterns
-                const shouldFetch = shouldFetchBody(request.url, request.mimeType, {
-                    fetchAllBodies,
-                    includePatterns: fetchBodiesInclude,
-                    excludePatterns: fetchBodiesExclude,
-                });
-                if (shouldFetch) {
-                    bodiesFetched++;
-                    // Fetch response body asynchronously
-                    void cdp
-                        .send('Network.getResponseBody', { requestId: params.requestId })
-                        .then((response) => {
-                        const typedResponse = response;
-                        request.responseBody = typedResponse.body;
-                    })
-                        .catch(() => {
-                        // Response body not available (e.g., 204 No Content, redirects, etc.)
-                    });
-                }
-                else {
-                    bodiesSkipped++;
-                    request.responseBody = '[SKIPPED: Auto-optimization (see DEFAULT_SKIP_BODY_PATTERNS)]';
-                }
-            }
-            else if (isTextResponse && !isSizeAcceptable) {
-                bodiesSkipped++;
-                // Mark large responses as skipped
-                request.responseBody = `[SKIPPED: Response too large (${(params.encodedDataLength / 1024 / 1024).toFixed(2)}MB > ${MAX_RESPONSE_SIZE / 1024 / 1024}MB)]`;
-            }
-            requests.push(request);
-            requestMap.delete(params.requestId);
-        }
-        else if (requests.length >= MAX_NETWORK_REQUESTS) {
-            console.error(`Warning: Network request limit reached (${MAX_NETWORK_REQUESTS})`);
-            requestMap.delete(params.requestId);
-        }
-    });
-    // Listen for failed requests
-    registry.register(cdp, 'Network.loadingFailed', (params) => {
-        const entry = requestMap.get(params.requestId);
-        if (entry && requests.length < MAX_NETWORK_REQUESTS) {
-            // Apply domain filtering
-            if (shouldExcludeDomain(entry.request.url, includeAll)) {
-                requestMap.delete(params.requestId);
-                return;
-            }
-            // Apply URL pattern filtering
-            if (shouldExcludeUrl(entry.request.url, {
-                includePatterns: networkInclude,
-                excludePatterns: networkExclude,
-            })) {
-                requestMap.delete(params.requestId);
-                return;
-            }
-            entry.request.status = 0; // Indicate failure
-            requests.push(entry.request);
-            requestMap.delete(params.requestId);
-        }
-        else if (requests.length >= MAX_NETWORK_REQUESTS) {
-            requestMap.delete(params.requestId);
-        }
-    });
-    // Return cleanup function
-    return () => {
-        // Log PERF metrics
-        const totalBodyDecisions = bodiesFetched + bodiesSkipped;
-        if (totalBodyDecisions > 0) {
-            const percentageSkipped = ((bodiesSkipped / totalBodyDecisions) * 100).toFixed(1);
-            console.error(`[PERF] Network bodies: ${bodiesFetched} fetched, ${bodiesSkipped} skipped (${percentageSkipped}% reduction)`);
-        }
-        // Clear interval
-        clearInterval(cleanupInterval);
-        // Remove event handlers
-        registry.cleanup(cdp);
-        // Clear request map
-        requestMap.clear();
-    };
-}
-//# sourceMappingURL=network.js.map

package/dist/collectors/network.js.map

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

package/dist/commands/dom.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../src/commands/dom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmSzC;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgE1D"}