browser-debugger-cli 0.5.1 → 0.6.0

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/connection/tabs.d.ts

@@ -1,52 +0,0 @@
-import type { CDPConnection } from './cdp.js';
-import type { CDPTarget } from '../types.js';
-/**
- * Find the best matching target from a list of tabs.
- *
- * @param normalizedUrl - Target URL to find (must be pre-normalized)
- * @param targets - List of available targets
- * @returns Best matching target or null if no match found
- */
-export declare function findBestTarget(normalizedUrl: string, targets: CDPTarget[]): CDPTarget | null;
-/**
- * Create a new tab with the specified URL using CDP.
- *
- * @param normalizedUrl - URL to open in the new tab (must be pre-normalized)
- * @param cdp - CDP connection instance
- * @returns Target information for the new tab
- * @throws Error if tab creation fails via both CDP and HTTP fallback methods
- */
-export declare function createNewTab(normalizedUrl: string, cdp: CDPConnection): Promise<CDPTarget>;
-/**
- * Navigate an existing tab to a new URL using CDP.
- *
- * @param targetId - CDP target ID to navigate
- * @param normalizedUrl - URL to navigate to (must be pre-normalized)
- * @param cdp - CDP connection instance
- * @throws Error if navigation fails (e.g., network error, invalid URL, blocked by browser)
- */
-export declare function navigateToUrl(targetId: string, normalizedUrl: string, cdp: CDPConnection): Promise<void>;
-/**
- * Wait for a target to be ready (URL matches expected).
- *
- * @param targetId - CDP target ID to wait for
- * @param normalizedUrl - Expected URL (must be pre-normalized)
- * @param cdp - CDP connection instance
- * @param maxWaitMs - Maximum time to wait in milliseconds
- * @throws Error if target doesn't become ready within maxWaitMs timeout
- */
-export declare function waitForTargetReady(targetId: string, normalizedUrl: string, cdp: CDPConnection, maxWaitMs?: number): Promise<void>;
-/**
- * Create a new tab or find existing tab with the target URL.
- *
- * This is the main entry point for tab management.
- * It tries to find an existing tab first, and if not found,
- * creates a new one.
- *
- * @param url - Target URL (will be normalized once at entry)
- * @param cdp - CDP connection instance
- * @param reuseTab - If true, navigate existing tab instead of creating new one
- * @returns Target information
- */
-export declare function createOrFindTarget(url: string, cdp: CDPConnection, reuseTab?: boolean): Promise<CDPTarget>;
-//# sourceMappingURL=tabs.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"tabs.d.ts","sourceRoot":"","sources":["../../src/connection/tabs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAiEzC;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,CA8B5F;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC,CAyDhG;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,aAAa,GACjB,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,aAAa,EAClB,SAAS,SAAQ,GAChB,OAAO,CAAC,IAAI,CAAC,CAkCf;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,aAAa,EAClB,QAAQ,UAAQ,GACf,OAAO,CAAC,SAAS,CAAC,CAwCpB"}

package/dist/connection/tabs.js

@@ -1,227 +0,0 @@
-import { normalizeUrl } from '../utils/url.js';
-/**
- * Score how well a tab matches the search URL.
- * Higher score = better match.
- *
- * @param tab - Target to score
- * @param searchUrl - Normalized URL to match against
- * @returns Match score (0-100)
- */
-function scoreTabMatch(tab, searchUrl) {
-    // Exact match = best score
-    if (tab.url === searchUrl) {
-        return 100;
-    }
-    // Try URL-based matching
-    try {
-        const tabUrlObj = new URL(tab.url);
-        const searchUrlObj = new URL(searchUrl);
-        // Same host + path = excellent score
-        if (tabUrlObj.host === searchUrlObj.host && tabUrlObj.pathname === searchUrlObj.pathname) {
-            return 90;
-        }
-        // Same host + path prefix = good score
-        if (tabUrlObj.host === searchUrlObj.host &&
-            tabUrlObj.pathname.startsWith(searchUrlObj.pathname)) {
-            return 70;
-        }
-        // Same host = decent score
-        if (tabUrlObj.host === searchUrlObj.host) {
-            return 50;
-        }
-    }
-    catch {
-        // URL parsing failed, fall back to substring matching
-    }
-    // Substring match = weak score
-    if (tab.url.includes(searchUrl)) {
-        return 30;
-    }
-    return 0; // No match
-}
-/**
- * Find the best matching target from a list of tabs.
- *
- * @param normalizedUrl - Target URL to find (must be pre-normalized)
- * @param targets - List of available targets
- * @returns Best matching target or null if no match found
- */
-export function findBestTarget(normalizedUrl, targets) {
-    const searchUrl = normalizedUrl;
-    // Filter for page targets only
-    const pageTargets = targets.filter((t) => t.type === 'page');
-    if (pageTargets.length === 0) {
-        return null;
-    }
-    // Score all targets
-    const scored = pageTargets
-        .map((t) => ({ target: t, score: scoreTabMatch(t, searchUrl) }))
-        .filter(({ score }) => score > 0)
-        .sort((a, b) => b.score - a.score);
-    if (scored.length === 0) {
-        return null;
-    }
-    // Warn if multiple tabs have same score
-    const first = scored[0];
-    const second = scored[1];
-    if (scored.length > 1 && first && second && first.score === second.score && first.score < 100) {
-        console.error(`Warning: Multiple tabs match equally (score ${first.score}), using: ${first.target.url}`);
-    }
-    return first ? first.target : null;
-}
-/**
- * Create a new tab with the specified URL using CDP.
- *
- * @param normalizedUrl - URL to open in the new tab (must be pre-normalized)
- * @param cdp - CDP connection instance
- * @returns Target information for the new tab
- * @throws Error if tab creation fails via both CDP and HTTP fallback methods
- */
-export async function createNewTab(normalizedUrl, cdp) {
-    const port = cdp.getPort();
-    let createdTargetId = null;
-    try {
-        const response = (await cdp.send('Target.createTarget', {
-            url: normalizedUrl,
-            newWindow: false, // Open as tab, not window
-        }));
-        createdTargetId = response.targetId;
-    }
-    catch (error) {
-        console.error('CDP Target.createTarget failed, attempting HTTP fallback...', error);
-    }
-    if (createdTargetId) {
-        try {
-            const listResponse = await fetch(`http://127.0.0.1:${port}/json/list`);
-            if (!listResponse.ok) {
-                throw new Error(`Failed to list targets: ${listResponse.status} ${listResponse.statusText}`);
-            }
-            const targets = (await listResponse.json());
-            const target = targets.find((t) => t.id === createdTargetId);
-            if (!target) {
-                throw new Error(`Created target ${createdTargetId} not found in Chrome target list`);
-            }
-            return target;
-        }
-        catch (resolveError) {
-            throw new Error(`Failed to resolve created tab: ${resolveError instanceof Error ? resolveError.message : String(resolveError)}`);
-        }
-    }
-    // Fallback to HTTP endpoint method
-    try {
-        const createResponse = await fetch(`http://127.0.0.1:${port}/json/new?${encodeURIComponent(normalizedUrl)}`);
-        if (!createResponse.ok) {
-            throw new Error(`HTTP /json/new failed: ${createResponse.statusText}`);
-        }
-        const target = (await createResponse.json());
-        return target;
-    }
-    catch (httpError) {
-        throw new Error(`Failed to create new tab: ${httpError instanceof Error ? httpError.message : String(httpError)}`);
-    }
-}
-/**
- * Navigate an existing tab to a new URL using CDP.
- *
- * @param targetId - CDP target ID to navigate
- * @param normalizedUrl - URL to navigate to (must be pre-normalized)
- * @param cdp - CDP connection instance
- * @throws Error if navigation fails (e.g., network error, invalid URL, blocked by browser)
- */
-export async function navigateToUrl(targetId, normalizedUrl, cdp) {
-    // Attach to target
-    const sessionResponse = (await cdp.send('Target.attachToTarget', {
-        targetId,
-        flatten: true,
-    }));
-    // Navigate
-    const navResponse = (await cdp.send('Page.navigate', { url: normalizedUrl }, sessionResponse.sessionId));
-    if (navResponse.errorText) {
-        throw new Error(`Navigation failed: ${navResponse.errorText}`);
-    }
-}
-/**
- * Wait for a target to be ready (URL matches expected).
- *
- * @param targetId - CDP target ID to wait for
- * @param normalizedUrl - Expected URL (must be pre-normalized)
- * @param cdp - CDP connection instance
- * @param maxWaitMs - Maximum time to wait in milliseconds
- * @throws Error if target doesn't become ready within maxWaitMs timeout
- */
-export async function waitForTargetReady(targetId, normalizedUrl, cdp, maxWaitMs = 15000) {
-    const startTime = Date.now();
-    while (Date.now() - startTime < maxWaitMs) {
-        try {
-            // Fetch current targets
-            const response = await fetch(`http://127.0.0.1:${cdp.getPort()}/json/list`);
-            const targets = (await response.json());
-            const target = targets.find((t) => t.id === targetId);
-            if (target) {
-                // Check if URL matches or is loading
-                if (target.url === normalizedUrl ||
-                    target.url.startsWith(normalizedUrl) ||
-                    target.url === 'about:blank' // Still loading
-                ) {
-                    // Wait a bit more if still on about:blank
-                    if (target.url === 'about:blank') {
-                        await new Promise((resolve) => setTimeout(resolve, 500));
-                        continue;
-                    }
-                    return; // Target is ready!
-                }
-            }
-        }
-        catch {
-            // Target doesn't exist yet or fetch failed, keep waiting
-        }
-        await new Promise((resolve) => setTimeout(resolve, 200));
-    }
-    throw new Error(`Target did not become ready within ${maxWaitMs}ms`);
-}
-/**
- * Create a new tab or find existing tab with the target URL.
- *
- * This is the main entry point for tab management.
- * It tries to find an existing tab first, and if not found,
- * creates a new one.
- *
- * @param url - Target URL (will be normalized once at entry)
- * @param cdp - CDP connection instance
- * @param reuseTab - If true, navigate existing tab instead of creating new one
- * @returns Target information
- */
-export async function createOrFindTarget(url, cdp, reuseTab = false) {
-    // Normalize URL once at entry point
-    const normalizedUrl = normalizeUrl(url);
-    // Only look for existing tabs if reuseTab is true
-    if (reuseTab) {
-        // Try to find existing target via CDP
-        const targetsResponse = (await cdp.send('Target.getTargets'));
-        const targets = targetsResponse.targetInfos.map((info) => ({
-            id: info.targetId,
-            type: info.type,
-            url: info.url,
-            title: info.title,
-            webSocketDebuggerUrl: '', // Not needed for this operation
-        }));
-        const existingTarget = findBestTarget(normalizedUrl, targets);
-        if (existingTarget) {
-            console.error(`Found existing tab: ${existingTarget.url}`);
-            // If URLs don't match exactly, navigate
-            if (existingTarget.url !== normalizedUrl) {
-                console.error(`Navigating tab to: ${normalizedUrl}`);
-                await navigateToUrl(existingTarget.id, normalizedUrl, cdp);
-                await waitForTargetReady(existingTarget.id, normalizedUrl, cdp);
-            }
-            return existingTarget;
-        }
-    }
-    // No matching tab found (or reuseTab=false), create new one
-    console.error(`Creating new tab for: ${normalizedUrl}`);
-    const newTarget = await createNewTab(normalizedUrl, cdp);
-    // Wait for tab to start loading
-    await waitForTargetReady(newTarget.id, normalizedUrl, cdp);
-    return newTarget;
-}
-//# sourceMappingURL=tabs.js.map

package/dist/connection/tabs.js.map

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

package/dist/help/machineReadableHelp.d.ts

@@ -1,100 +0,0 @@
-/**
- * Machine-readable help generation using Commander.js introspection API.
- *
- * @module help/machineReadableHelp
- */
-import type { Command } from 'commander';
-/**
- * Option metadata for machine-readable help.
- */
-export interface OptionMetadata {
-    /** Option flags (e.g., "-j, --json") */
-    flags: string;
-    /** Option description */
-    description: string;
-    /** Whether option is required */
-    required: boolean;
-    /** Whether option has an optional value */
-    optional: boolean;
-    /** Default value if any */
-    defaultValue?: unknown;
-    /** Description of default value */
-    defaultValueDescription?: string;
-    /** Allowed choices if restricted */
-    choices?: readonly string[];
-}
-/**
- * Argument metadata for machine-readable help.
- */
-export interface ArgumentMetadata {
-    /** Argument name */
-    name: string;
-    /** Argument description */
-    description: string;
-    /** Whether argument is required */
-    required: boolean;
-    /** Whether argument accepts multiple values */
-    variadic: boolean;
-    /** Default value if any */
-    defaultValue?: unknown;
-    /** Allowed choices if restricted */
-    choices?: readonly string[];
-}
-/**
- * Command metadata for machine-readable help.
- */
-export interface CommandMetadata {
-    /** Command name */
-    name: string;
-    /** Command aliases */
-    aliases: readonly string[];
-    /** Command description */
-    description: string;
-    /** Command usage string */
-    usage: string;
-    /** Command arguments */
-    arguments: ArgumentMetadata[];
-    /** Command options */
-    options: OptionMetadata[];
-    /** Subcommands */
-    subcommands: CommandMetadata[];
-}
-/**
- * Root machine-readable help structure.
- */
-export interface MachineReadableHelp {
-    /** CLI name */
-    name: string;
-    /** CLI version */
-    version: string;
-    /** CLI description */
-    description: string;
-    /** Root command metadata */
-    command: CommandMetadata;
-    /** Exit code documentation */
-    exitCodes: {
-        /** Exit code value */
-        code: number;
-        /** Exit code name */
-        name: string;
-        /** Exit code description */
-        description: string;
-    }[];
-}
-/**
- * Generates machine-readable help from a Commander program.
- *
- * @param program - Commander program instance
- * @returns Machine-readable help structure
- *
- * @example
- * ```typescript
- * import { program } from 'commander';
- * import { generateMachineReadableHelp } from './help/machineReadableHelp.js';
- *
- * const help = generateMachineReadableHelp(program);
- * console.log(JSON.stringify(help, null, 2));
- * ```
- */
-export declare function generateMachineReadableHelp(program: Command): MachineReadableHelp;
-//# sourceMappingURL=machineReadableHelp.d.ts.map

package/dist/help/machineReadableHelp.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"machineReadableHelp.d.ts","sourceRoot":"","sources":["../../src/help/machineReadableHelp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAoB,MAAM,WAAW,CAAC;AAI3D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,2CAA2C;IAC3C,QAAQ,EAAE,OAAO,CAAC;IAClB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mCAAmC;IACnC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,oCAAoC;IACpC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,QAAQ,EAAE,OAAO,CAAC;IAClB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oCAAoC;IACpC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,sBAAsB;IACtB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,kBAAkB;IAClB,WAAW,EAAE,eAAe,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,OAAO,EAAE,eAAe,CAAC;IACzB,8BAA8B;IAC9B,SAAS,EAAE;QACT,sBAAsB;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,qBAAqB;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,4BAA4B;QAC5B,WAAW,EAAE,MAAM,CAAC;KACrB,EAAE,CAAC;CACL;AAuDD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,mBAAmB,CAkEjF"}