browser-debugger-cli 0.1.0-alpha.1 → 0.2.0

package/dist/telemetry/console.js

@@ -0,0 +1,87 @@
+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, params.type, 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, 'error', 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/telemetry/console.js.map

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

package/dist/telemetry/dom.d.ts

@@ -0,0 +1,21 @@
+import type { CDPConnection } from '../connection/cdp.js';
+import type { DOMData, CleanupFunction } from '../types';
+/**
+ * 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/telemetry/dom.d.ts.map

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

@@ -0,0 +1,99 @@
+/**
+ * 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/telemetry/dom.js.map

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

package/dist/telemetry/network.d.ts

@@ -0,0 +1,33 @@
+import type { CDPConnection } from '../connection/cdp.js';
+import type { NetworkRequest, CleanupFunction } from '../types';
+export interface NetworkCollectionOptions {
+    includeAll?: boolean;
+    fetchAllBodies?: boolean;
+    fetchBodiesInclude?: string[];
+    fetchBodiesExclude?: string[];
+    networkInclude?: string[];
+    networkExclude?: string[];
+    maxBodySize?: number;
+}
+/**
+ * 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/telemetry/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/telemetry/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;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,cAAc,EAAE,EAC1B,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,eAAe,CAAC,CAwN1B"}

package/dist/telemetry/network.js

@@ -0,0 +1,191 @@
+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 = [], maxBodySize = MAX_RESPONSE_SIZE, } = 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: Date.now(), // Use actual timestamp, not CDP monotonic time
+            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 <= maxBodySize;
+            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 > ${maxBodySize / 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/telemetry/network.js.map

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

package/dist/types.d.ts

@@ -57,7 +57,7 @@ export interface BdgOutput {
     error?: string;
     partial?: boolean;
 }
-export type CollectorType = 'dom' | 'network' | 'console';
+export type TelemetryType = 'dom' | 'network' | 'console';
 export type CDPResourceType = 'Document' | 'Stylesheet' | 'Image' | 'Media' | 'Font' | 'Script' | 'TextTrack' | 'XHR' | 'Fetch' | 'Prefetch' | 'EventSource' | 'WebSocket' | 'Manifest' | 'SignedExchange' | 'Ping' | 'CSPViolationReport' | 'Preflight' | 'FedCM' | 'Other';
 export type CDPMonotonicTime = number;
 export type CDPTimeSinceEpoch = number;

package/dist/ui/formatters/cookies.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Cookie formatter for human-readable output.
+ */
+/**
+ * CDP Cookie type
+ */
+export interface Cookie {
+    name: string;
+    value: string;
+    domain: string;
+    path: string;
+    expires?: number;
+    httpOnly: boolean;
+    secure: boolean;
+    sameSite?: 'Strict' | 'Lax' | 'None';
+}
+/**
+ * Format cookies for human-readable output.
+ *
+ * @param cookies - Array of CDP cookies
+ * @returns Formatted cookie list
+ *
+ * @example
+ * ```typescript
+ * const output = formatCookies([
+ *   { name: 'session', value: 'abc123', domain: '.example.com', ... }
+ * ]);
+ * console.log(output);
+ * ```
+ */
+export declare function formatCookies(cookies: Cookie[]): string;
+//# sourceMappingURL=cookies.d.ts.map

package/dist/ui/formatters/cookies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../../../src/ui/formatters/cookies.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;CACtC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAkCvD"}

package/dist/ui/formatters/cookies.js

@@ -0,0 +1,48 @@
+/**
+ * Cookie formatter for human-readable output.
+ */
+import { pluralize } from '../../ui/formatting.js';
+/**
+ * Format cookies for human-readable output.
+ *
+ * @param cookies - Array of CDP cookies
+ * @returns Formatted cookie list
+ *
+ * @example
+ * ```typescript
+ * const output = formatCookies([
+ *   { name: 'session', value: 'abc123', domain: '.example.com', ... }
+ * ]);
+ * console.log(output);
+ * ```
+ */
+export function formatCookies(cookies) {
+    if (cookies.length === 0) {
+        return 'No cookies found';
+    }
+    const lines = [];
+    lines.push(`${pluralize(cookies.length, 'Cookie', 'Cookies')}:\n`);
+    cookies.forEach((cookie, index) => {
+        const cookieLines = [];
+        cookieLines.push(`[${index + 1}] ${cookie.name}`);
+        cookieLines.push(`  Value: ${cookie.value}`);
+        cookieLines.push(`  Domain: ${cookie.domain}`);
+        cookieLines.push(`  Path: ${cookie.path}`);
+        if (cookie.expires && cookie.expires !== -1) {
+            const expiresDate = new Date(cookie.expires * 1000);
+            cookieLines.push(`  Expires: ${expiresDate.toISOString()}`);
+        }
+        else {
+            cookieLines.push(`  Expires: Session`);
+        }
+        cookieLines.push(`  HttpOnly: ${cookie.httpOnly ? 'Yes' : 'No'}`);
+        cookieLines.push(`  Secure: ${cookie.secure ? 'Yes' : 'No'}`);
+        cookieLines.push(`  SameSite: ${cookie.sameSite ?? 'None'}`);
+        lines.push(cookieLines.join('\n'));
+        if (index < cookies.length - 1) {
+            lines.push('');
+        }
+    });
+    return lines.join('\n');
+}
+//# sourceMappingURL=cookies.js.map

package/dist/ui/formatters/cookies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.js","sourceRoot":"","sources":["../../../src/ui/formatters/cookies.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAgB/C;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAAC,OAAiB;IAC7C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IAEnE,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAChC,MAAM,WAAW,GAAa,EAAE,CAAC;QACjC,WAAW,CAAC,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAClD,WAAW,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC7C,WAAW,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/C,WAAW,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAE3C,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;YAC5C,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;YACpD,WAAW,CAAC,IAAI,CAAC,cAAc,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC9D,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACzC,CAAC;QAED,WAAW,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAClE,WAAW,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9D,WAAW,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,QAAQ,IAAI,MAAM,EAAE,CAAC,CAAC;QAE7D,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAEnC,IAAI,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/ui/formatters/details.d.ts

@@ -0,0 +1,10 @@
+import type { NetworkRequest, ConsoleMessage } from '../../types';
+/**
+ * Format network request details for human-readable output
+ */
+export declare function formatNetworkDetails(request: NetworkRequest): string;
+/**
+ * Format console message details for human-readable output
+ */
+export declare function formatConsoleDetails(message: ConsoleMessage): string;
+//# sourceMappingURL=details.d.ts.map

package/dist/ui/formatters/details.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"details.d.ts","sourceRoot":"","sources":["../../../src/ui/formatters/details.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9D;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CA4CpE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAmBpE"}

package/dist/ui/formatters/details.js

@@ -0,0 +1,63 @@
+/**
+ * Format network request details for human-readable output
+ */
+export function formatNetworkDetails(request) {
+    const lines = [];
+    lines.push('Network Request Details');
+    lines.push('━'.repeat(70));
+    lines.push(`Request ID:  ${request.requestId}`);
+    lines.push(`URL:         ${request.url}`);
+    lines.push(`Method:      ${request.method}`);
+    lines.push(`Status:      ${request.status ?? 'pending'}`);
+    lines.push(`MIME Type:   ${request.mimeType ?? 'N/A'}`);
+    lines.push('');
+    if (request.requestHeaders) {
+        lines.push('Request Headers:');
+        lines.push('━'.repeat(70));
+        Object.entries(request.requestHeaders).forEach(([key, value]) => {
+            lines.push(`  ${key}: ${value}`);
+        });
+        lines.push('');
+    }
+    if (request.requestBody) {
+        lines.push('Request Body:');
+        lines.push('━'.repeat(70));
+        lines.push(request.requestBody);
+        lines.push('');
+    }
+    if (request.responseHeaders) {
+        lines.push('Response Headers:');
+        lines.push('━'.repeat(70));
+        Object.entries(request.responseHeaders).forEach(([key, value]) => {
+            lines.push(`  ${key}: ${value}`);
+        });
+        lines.push('');
+    }
+    if (request.responseBody) {
+        lines.push('Response Body:');
+        lines.push('━'.repeat(70));
+        lines.push(request.responseBody);
+    }
+    return lines.join('\n');
+}
+/**
+ * Format console message details for human-readable output
+ */
+export function formatConsoleDetails(message) {
+    const lines = [];
+    lines.push('Console Message Details');
+    lines.push('━'.repeat(70));
+    lines.push(`Type:       ${message.type}`);
+    lines.push(`Timestamp:  ${new Date(message.timestamp).toISOString()}`);
+    lines.push(`Text:       ${message.text}`);
+    lines.push('');
+    if (message.args && message.args.length > 0) {
+        lines.push('Arguments:');
+        lines.push('━'.repeat(70));
+        message.args.forEach((arg, idx) => {
+            lines.push(`  [${idx}]: ${JSON.stringify(arg, null, 2)}`);
+        });
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=details.js.map