browser-debugger-cli 0.6.0 → 0.6.2

package/dist/telemetry/network.js

@@ -1,6 +1,67 @@
+import { getErrorMessage } from '../connection/errors.js';
 import { CDPHandlerRegistry } from '../connection/handlers.js';
+import { TypedCDPConnection } from '../connection/typed-cdp.js';
 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 { createLogger } from '../ui/logging/index.js';
 import { shouldExcludeDomain, shouldExcludeUrl, shouldFetchBodyWithReason } from './filters.js';
+const log = createLogger('network');
+/**
+ * Check if a request should be filtered out based on domain and URL patterns.
+ */
+function shouldFilterRequest(url, includeAll, networkInclude, networkExclude) {
+    if (shouldExcludeDomain(url, includeAll)) {
+        return true;
+    }
+    if (shouldExcludeUrl(url, { includePatterns: networkInclude, excludePatterns: networkExclude })) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Fetch response body for a request.
+ */
+function fetchResponseBody(cdp, requestId, request) {
+    void cdp
+        .send('Network.getResponseBody', { requestId })
+        .then((response) => {
+        const typedResponse = response;
+        request.responseBody = typedResponse.body;
+    })
+        .catch((error) => {
+        log.debug(`Failed to fetch response body for request ${requestId}: ${getErrorMessage(error)}`);
+    });
+}
+/**
+ * Create a network request from CDP event parameters.
+ */
+function createNetworkRequest(params, getCurrentNavigationId) {
+    const navigationId = getCurrentNavigationId?.();
+    return {
+        requestId: params.requestId,
+        url: params.request.url,
+        method: params.request.method,
+        timestamp: Date.now(),
+        requestHeaders: params.request.headers,
+        ...(params.request.postData !== undefined && { requestBody: params.request.postData }),
+        ...(navigationId !== undefined && { navigationId }),
+    };
+}
+/**
+ * Clean up stale requests from the request map.
+ */
+function cleanupStaleRequests(requestMap) {
+    const now = Date.now();
+    const staleRequests = [];
+    requestMap.forEach((value, requestId) => {
+        if (now - value.timestamp > STALE_REQUEST_TIMEOUT) {
+            staleRequests.push(requestId);
+        }
+    });
+    if (staleRequests.length > 0) {
+        log.debug(`Cleaning up ${staleRequests.length} stale network requests`);
+        staleRequests.forEach((requestId) => requestMap.delete(requestId));
+    }
+}
 /**
  * Start collecting network requests via CDP Network domain.
  *
@@ -25,12 +86,9 @@ export async function startNetworkCollection(cdp, requests, options = {}) {
     const { includeAll = false, fetchAllBodies = false, fetchBodiesInclude = [], fetchBodiesExclude = [], networkInclude = [], networkExclude = [], maxBodySize = MAX_RESPONSE_SIZE, getCurrentNavigationId, } = options;
     const requestMap = new Map();
     const registry = new CDPHandlerRegistry();
-    // Counters for PERF logging
+    const typed = new TypedCDPConnection(cdp);
     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,
@@ -39,46 +97,22 @@ export async function startNetworkCollection(cdp, requests, options = {}) {
         });
     }
     catch {
-        // Fallback to basic Network.enable if buffer parameters not supported
-        console.error('Network buffer limits not supported, using default settings');
+        log.debug('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) => {
+    const cleanupInterval = setInterval(() => cleanupStaleRequests(requestMap), STALE_REQUEST_CLEANUP_INTERVAL);
+    registry.registerTyped(typed, 'Network.requestWillBeSent', (params) => {
         if (requestMap.size >= MAX_NETWORK_REQUESTS) {
-            console.error(`Warning: Network request limit reached (${MAX_NETWORK_REQUESTS}), dropping new requests`);
+            log.debug(`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,
-            navigationId: getCurrentNavigationId?.(),
-        };
+        const request = createNetworkRequest(params, getCurrentNavigationId);
         requestMap.set(params.requestId, {
             request,
             timestamp: Date.now(),
         });
     });
-    // Listen for responses
-    registry.register(cdp, 'Network.responseReceived', (params) => {
+    registry.registerTyped(typed, 'Network.responseReceived', (params) => {
         const entry = requestMap.get(params.requestId);
         if (entry) {
             entry.request.status = params.response.status;
@@ -86,94 +120,61 @@ export async function startNetworkCollection(cdp, requests, options = {}) {
             entry.request.responseHeaders = params.response.headers;
         }
     });
-    // Listen for finished requests
-    registry.register(cdp, 'Network.loadingFinished', (params) => {
+    registry.registerTyped(typed, '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 decision = shouldFetchBodyWithReason(request.url, request.mimeType, params.encodedDataLength, {
-                fetchAllBodies,
-                includePatterns: fetchBodiesInclude,
-                excludePatterns: fetchBodiesExclude,
-                maxBodySize,
-            });
-            if (decision.should) {
-                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: ${decision.reason}]`;
-            }
-            requests.push(request);
+        if (!entry)
+            return;
+        if (requests.length >= MAX_NETWORK_REQUESTS) {
+            log.debug(`Warning: Network request limit reached (${MAX_NETWORK_REQUESTS})`);
             requestMap.delete(params.requestId);
+            return;
         }
-        else if (requests.length >= MAX_NETWORK_REQUESTS) {
-            console.error(`Warning: Network request limit reached (${MAX_NETWORK_REQUESTS})`);
+        const request = entry.request;
+        if (shouldFilterRequest(request.url, includeAll, networkInclude, networkExclude)) {
             requestMap.delete(params.requestId);
+            return;
+        }
+        const decision = shouldFetchBodyWithReason(request.url, request.mimeType, params.encodedDataLength, {
+            fetchAllBodies,
+            includePatterns: fetchBodiesInclude,
+            excludePatterns: fetchBodiesExclude,
+            maxBodySize,
+        });
+        if (decision.should) {
+            bodiesFetched++;
+            fetchResponseBody(cdp, params.requestId, request);
+        }
+        else {
+            bodiesSkipped++;
+            request.responseBody = `[SKIPPED: ${decision.reason}]`;
         }
+        requests.push(request);
+        requestMap.delete(params.requestId);
     });
-    // Listen for failed requests
-    registry.register(cdp, 'Network.loadingFailed', (params) => {
+    registry.registerTyped(typed, '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);
+        if (!entry)
+            return;
+        if (requests.length >= MAX_NETWORK_REQUESTS) {
             requestMap.delete(params.requestId);
+            return;
         }
-        else if (requests.length >= MAX_NETWORK_REQUESTS) {
+        if (shouldFilterRequest(entry.request.url, includeAll, networkInclude, networkExclude)) {
             requestMap.delete(params.requestId);
+            return;
         }
+        entry.request.status = 0;
+        requests.push(entry.request);
+        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)`);
+            log.debug(`[PERF] Network bodies: ${bodiesFetched} fetched, ${bodiesSkipped} skipped (${percentageSkipped}% reduction)`);
         }
-        // Clear interval
         clearInterval(cleanupInterval);
-        // Remove event handlers
-        registry.cleanup(cdp);
-        // Clear request map
+        registry.cleanup();
         requestMap.clear();
     };
 }

package/dist/telemetry/network.js.map

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

package/dist/telemetry/utils.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Shared utilities for telemetry collectors
+ */
+export declare function pushWithLimit<T>(buffer: T[], item: T, limit: number, onLimitReached: () => void): void;
+/**
+ * Wrap a CDP operation with a timeout to prevent hanging.
+ *
+ * Prevents telemetry collectors from hanging indefinitely on slow or
+ * unresponsive CDP commands. Useful for operations like DOM capture,
+ * screenshot capture, or other potentially slow CDP calls.
+ *
+ * @param promise - CDP operation to wrap
+ * @param timeoutMs - Timeout in milliseconds
+ * @param label - Human-readable label for error messages
+ * @returns Promise that resolves with the CDP result or rejects on timeout
+ * @throws Error if the operation times out
+ *
+ * @example
+ * ```typescript
+ * const doc = await withTimeout(
+ *   cdp.send('DOM.getDocument', { depth: -1 }),
+ *   5000,
+ *   'DOM.getDocument'
+ * );
+ * ```
+ */
+export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, label: string): Promise<T>;
+/**
+ * Result of a batch CDP operation.
+ */
+export interface BatchCDPResult<T> {
+    /** Successfully resolved results */
+    results: T[];
+    /** Errors that occurred during execution */
+    errors: Array<{
+        index: number;
+        error: Error;
+    }>;
+}
+/**
+ * Execute multiple CDP operations in parallel with concurrency control.
+ *
+ * Processes an array of async operations with a maximum concurrency limit,
+ * preventing overwhelming of the CDP connection. Collects both successful
+ * results and errors, allowing partial success handling.
+ *
+ * @param operations - Array of async operations to execute
+ * @param concurrency - Maximum number of concurrent operations (default: 10)
+ * @returns Object containing successful results and errors with their indices
+ *
+ * @example
+ * ```typescript
+ * const operations = nodeIds.map(id => () => cdp.send('DOM.describeNode', { nodeId: id }));
+ * const { results, errors } = await batchCDPOperations(operations, 5);
+ *
+ * if (errors.length > 0) {
+ *   log.debug(`Failed to describe ${errors.length} nodes`);
+ * }
+ * ```
+ */
+export declare function batchCDPOperations<T>(operations: Array<() => Promise<T>>, concurrency?: number): Promise<BatchCDPResult<T>>;
+/**
+ * Process an array in parallel with concurrency control and transformation.
+ *
+ * Similar to `Promise.all(array.map(fn))` but with concurrency limiting and
+ * error collection. Useful for processing large arrays of data that require
+ * async operations without blocking the entire event loop.
+ *
+ * @param items - Array of items to process
+ * @param mapper - Async function to transform each item
+ * @param concurrency - Maximum number of concurrent operations (default: 10)
+ * @returns Object containing successful results and errors with their indices
+ *
+ * @example
+ * ```typescript
+ * const requestIds = ['req1', 'req2', 'req3'];
+ * const { results, errors } = await parallelMap(
+ *   requestIds,
+ *   async (id) => cdp.send('Network.getResponseBody', { requestId: id }),
+ *   5
+ * );
+ * ```
+ */
+export declare function parallelMap<T, R>(items: T[], mapper: (item: T, index: number) => Promise<R>, concurrency?: number): Promise<BatchCDPResult<R>>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/telemetry/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/telemetry/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AA+BH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,MAAM,EAAE,CAAC,EAAE,EACX,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,MAAM,IAAI,GACzB,IAAI,CAQN;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,CAAC,CAAC,CAOZ;AAQD;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,oCAAoC;IACpC,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,4CAA4C;IAC5C,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;CAChD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,UAAU,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EACnC,WAAW,GAAE,MAAgC,GAC5C,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAsB5B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,CAAC,EACpC,KAAK,EAAE,CAAC,EAAE,EACV,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAC9C,WAAW,GAAE,MAAgC,GAC5C,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAG5B"}

package/dist/telemetry/utils.js

@@ -0,0 +1,138 @@
+/**
+ * Shared utilities for telemetry collectors
+ */
+import { ConcurrencyLimiter } from '../utils/concurrency.js';
+/**
+ * Push an item to a bounded buffer with limit enforcement.
+ *
+ * Prevents unbounded memory growth in long-running sessions by enforcing
+ * a maximum buffer size. When the limit is reached, new items are silently
+ * dropped and a warning callback is invoked exactly once.
+ *
+ * @param buffer - Array to push item into
+ * @param item - Item to add to buffer
+ * @param limit - Maximum buffer size
+ * @param onLimitReached - Callback invoked once when limit is first reached
+ *
+ * @example
+ * ```typescript
+ * const messages: ConsoleMessage[] = [];
+ * const log = createLogger('console');
+ *
+ * pushWithLimit(
+ *   messages,
+ *   newMessage,
+ *   10_000,
+ *   () => log.debug('Console message limit reached (10000)')
+ * );
+ * ```
+ */
+const limitReachedBuffers = new WeakSet();
+export function pushWithLimit(buffer, item, limit, onLimitReached) {
+    if (buffer.length < limit) {
+        buffer.push(item);
+        if (buffer.length === limit && !limitReachedBuffers.has(buffer)) {
+            limitReachedBuffers.add(buffer);
+            onLimitReached();
+        }
+    }
+}
+/**
+ * Wrap a CDP operation with a timeout to prevent hanging.
+ *
+ * Prevents telemetry collectors from hanging indefinitely on slow or
+ * unresponsive CDP commands. Useful for operations like DOM capture,
+ * screenshot capture, or other potentially slow CDP calls.
+ *
+ * @param promise - CDP operation to wrap
+ * @param timeoutMs - Timeout in milliseconds
+ * @param label - Human-readable label for error messages
+ * @returns Promise that resolves with the CDP result or rejects on timeout
+ * @throws Error if the operation times out
+ *
+ * @example
+ * ```typescript
+ * const doc = await withTimeout(
+ *   cdp.send('DOM.getDocument', { depth: -1 }),
+ *   5000,
+ *   'DOM.getDocument'
+ * );
+ * ```
+ */
+export async function withTimeout(promise, timeoutMs, label) {
+    return Promise.race([
+        promise,
+        new Promise((_, reject) => setTimeout(() => reject(new Error(`CDP ${label} timed out after ${timeoutMs}ms`)), timeoutMs)),
+    ]);
+}
+/**
+ * Default concurrency limit for batch CDP operations.
+ * Prevents overwhelming the CDP connection with too many simultaneous requests.
+ */
+const DEFAULT_CDP_CONCURRENCY = 10;
+/**
+ * Execute multiple CDP operations in parallel with concurrency control.
+ *
+ * Processes an array of async operations with a maximum concurrency limit,
+ * preventing overwhelming of the CDP connection. Collects both successful
+ * results and errors, allowing partial success handling.
+ *
+ * @param operations - Array of async operations to execute
+ * @param concurrency - Maximum number of concurrent operations (default: 10)
+ * @returns Object containing successful results and errors with their indices
+ *
+ * @example
+ * ```typescript
+ * const operations = nodeIds.map(id => () => cdp.send('DOM.describeNode', { nodeId: id }));
+ * const { results, errors } = await batchCDPOperations(operations, 5);
+ *
+ * if (errors.length > 0) {
+ *   log.debug(`Failed to describe ${errors.length} nodes`);
+ * }
+ * ```
+ */
+export async function batchCDPOperations(operations, concurrency = DEFAULT_CDP_CONCURRENCY) {
+    const limiter = new ConcurrencyLimiter(concurrency);
+    const results = [];
+    const errors = [];
+    await Promise.all(operations.map((operation, index) => limiter.run(async () => {
+        try {
+            const result = await operation();
+            results.push(result);
+        }
+        catch (error) {
+            errors.push({
+                index,
+                error: error instanceof Error ? error : new Error(String(error)),
+            });
+        }
+    })));
+    return { results, errors };
+}
+/**
+ * Process an array in parallel with concurrency control and transformation.
+ *
+ * Similar to `Promise.all(array.map(fn))` but with concurrency limiting and
+ * error collection. Useful for processing large arrays of data that require
+ * async operations without blocking the entire event loop.
+ *
+ * @param items - Array of items to process
+ * @param mapper - Async function to transform each item
+ * @param concurrency - Maximum number of concurrent operations (default: 10)
+ * @returns Object containing successful results and errors with their indices
+ *
+ * @example
+ * ```typescript
+ * const requestIds = ['req1', 'req2', 'req3'];
+ * const { results, errors } = await parallelMap(
+ *   requestIds,
+ *   async (id) => cdp.send('Network.getResponseBody', { requestId: id }),
+ *   5
+ * );
+ * ```
+ */
+export async function parallelMap(items, mapper, concurrency = DEFAULT_CDP_CONCURRENCY) {
+    const operations = items.map((item, index) => () => mapper(item, index));
+    return batchCDPOperations(operations, concurrency);
+}
+//# sourceMappingURL=utils.js.map

package/dist/telemetry/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/telemetry/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,mBAAmB,GAAG,IAAI,OAAO,EAAa,CAAC;AAErD,MAAM,UAAU,aAAa,CAC3B,MAAW,EACX,IAAO,EACP,KAAa,EACb,cAA0B;IAE1B,IAAI,MAAM,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClB,IAAI,MAAM,CAAC,MAAM,KAAK,KAAK,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAChE,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAChC,cAAc,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAmB,EACnB,SAAiB,EACjB,KAAa;IAEb,OAAO,OAAO,CAAC,IAAI,CAAC;QAClB,OAAO;QACP,IAAI,OAAO,CAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAC3B,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,KAAK,oBAAoB,SAAS,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC,CAC9F;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAYnC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAAmC,EACnC,cAAsB,uBAAuB;IAE7C,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,OAAO,GAAQ,EAAE,CAAC;IACxB,MAAM,MAAM,GAA2C,EAAE,CAAC;IAE1D,MAAM,OAAO,CAAC,GAAG,CACf,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAClC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;QACrB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;YACjC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK;gBACL,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;aACjE,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CACH,CACF,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAU,EACV,MAA8C,EAC9C,cAAsB,uBAAuB;IAE7C,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACzE,OAAO,kBAAkB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AACrD,CAAC"}

package/dist/types/dom.d.ts

@@ -0,0 +1,66 @@
+/**
+ * DOM operation types.
+ *
+ * Shared type definitions for DOM query, get, and screenshot operations.
+ * Used by both commands and formatters to avoid circular dependencies.
+ */
+/**
+ * Result of a DOM query operation
+ */
+export interface DomQueryResult {
+    selector: string;
+    count: number;
+    nodes: Array<{
+        index: number;
+        nodeId: number;
+        tag?: string;
+        classes?: string[];
+        preview?: string;
+    }>;
+}
+/**
+ * Result of a DOM get operation
+ */
+export interface DomGetResult {
+    nodes: Array<{
+        nodeId: number;
+        tag?: string;
+        attributes?: Record<string, unknown>;
+        classes?: string[];
+        outerHTML?: string;
+    }>;
+}
+/**
+ * Result of a screenshot operation
+ */
+export interface ScreenshotResult {
+    path: string;
+    format: 'png' | 'jpeg';
+    quality?: number;
+    width: number;
+    height: number;
+    size: number;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    fullPage: boolean;
+}
+/**
+ * Options for DOM get operation
+ */
+export interface DomGetOptions {
+    selector?: string;
+    nodeId?: number;
+    all?: boolean;
+    nth?: number;
+}
+/**
+ * Options for screenshot operation
+ */
+export interface ScreenshotOptions {
+    format?: 'png' | 'jpeg';
+    quality?: number;
+    fullPage?: boolean;
+}
+//# sourceMappingURL=dom.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../src/types/dom.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,KAAK,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/types/dom.js

@@ -0,0 +1,8 @@
+/**
+ * DOM operation types.
+ *
+ * Shared type definitions for DOM query, get, and screenshot operations.
+ * Used by both commands and formatters to avoid circular dependencies.
+ */
+export {};
+//# sourceMappingURL=dom.js.map

package/dist/types/dom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.js","sourceRoot":"","sources":["../../src/types/dom.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}