browser-debugger-cli 0.5.1 → 0.6.1

package/dist/utils/pageReadiness.js

@@ -1,270 +0,0 @@
-/**
- * Smart page readiness detection using self-tuning thresholds
- *
- * This module provides adaptive page load detection that works for any page type
- * without configuration. It uses a three-phase approach:
- * 1. Load event (baseline readiness)
- * 2. Network stability (adapts to request patterns)
- * 3. DOM stability (adapts to mutation rate)
- */
-/**
- * Wait for page to be ready using self-tuning detection
- *
- * Strategy (always applied):
- * 1. Wait for load event (baseline readiness)
- * 2. Wait for network to stabilize (adaptive 200ms idle)
- * 3. Wait for DOM to stabilize (adaptive 300ms idle)
- *
- * All thresholds adapt to observed page behavior.
- * No framework detection, no configuration needed.
- * Works for static HTML, SPAs, and everything in between.
- *
- * @param cdp - CDP connection
- * @param options - Optional configuration
- *
- * @example
- * ```typescript
- * // Default: Wait up to 5s for full stability
- * await waitForPageReady(cdp);
- *
- * // Custom timeout for very slow apps
- * await waitForPageReady(cdp, { maxWaitMs: 15000 });
- * ```
- */
-export async function waitForPageReady(cdp, options = {}) {
-    const maxWaitMs = options.maxWaitMs ?? 5000;
-    const deadline = Date.now() + maxWaitMs;
-    try {
-        // Phase 1: Wait for load event (baseline)
-        await waitForLoadEvent(cdp, deadline);
-        console.error('[readiness] ✓ Load event');
-        // Phase 2: Wait for network stability (always - modern web is async)
-        const networkIdleMs = await waitForNetworkStable(cdp, deadline);
-        console.error(`[readiness] ✓ Network stable (${networkIdleMs}ms idle)`);
-        // Phase 3: Wait for DOM stability (always - SPAs mutate after load)
-        const domIdleMs = await waitForDOMStable(cdp, deadline);
-        console.error(`[readiness] ✓ DOM stable (${domIdleMs}ms idle)`);
-        console.error('[readiness] ✓ Page ready');
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.error(`[readiness] ${message}, proceeding anyway`);
-        // Don't rethrow - allow session to continue
-    }
-}
-/**
- * Wait for Page.loadEventFired (window.onload equivalent)
- *
- * This is the browser's native load event - fires when:
- * - Document is fully loaded
- * - All synchronous scripts executed
- * - DOMContentLoaded already fired
- *
- * Framework-agnostic baseline.
- *
- * Handles edge case where load event already fired (Chrome navigates during launch).
- *
- * @param cdp - CDP connection
- * @param deadline - Timestamp when to timeout
- * @throws Error if deadline exceeded
- */
-async function waitForLoadEvent(cdp, deadline) {
-    await cdp.send('Page.enable');
-    // Check if page already loaded (handles Chrome pre-navigation)
-    try {
-        const result = await cdp.send('Runtime.evaluate', {
-            expression: 'document.readyState',
-            returnByValue: true,
-        });
-        if (result.result?.value === 'complete') {
-            // Load event already fired
-            return;
-        }
-    }
-    catch {
-        // Ignore evaluation errors, proceed to wait for event
-    }
-    return new Promise((resolve, reject) => {
-        let timeout;
-        let handlerId;
-        const cleanup = () => {
-            clearTimeout(timeout);
-            if (handlerId !== undefined) {
-                cdp.off('Page.loadEventFired', handlerId);
-            }
-        };
-        const checkDeadline = () => {
-            if (Date.now() >= deadline) {
-                cleanup();
-                reject(new Error('Load event timeout'));
-            }
-            else {
-                timeout = setTimeout(checkDeadline, 100);
-            }
-        };
-        const loadHandler = () => {
-            cleanup();
-            resolve();
-        };
-        handlerId = cdp.on('Page.loadEventFired', loadHandler);
-        checkDeadline();
-    });
-}
-/**
- * Wait for network to stabilize
- *
- * Uses a fixed 200ms idle threshold which works well for most pages:
- * - Fast enough for quick sites (avoids unnecessary waiting)
- * - Patient enough for API-heavy apps (catches late requests)
- * - Simpler and more predictable than adaptive learning
- *
- * Network is considered stable when there are zero active requests
- * for at least 200ms continuously.
- *
- * Why this works:
- * - Catches initial request bursts (CSS, JS, images)
- * - Waits for lazy-loaded resources
- * - Detects API calls triggered by hydration
- * - Framework-agnostic - based on actual network activity
- *
- * @param cdp - CDP connection
- * @param deadline - Timestamp when to timeout
- * @returns Actual idle duration detected
- * @throws Error if deadline exceeded
- */
-async function waitForNetworkStable(cdp, deadline) {
-    await cdp.send('Network.enable');
-    let activeRequests = 0;
-    let lastActivity = Date.now();
-    const intervals = [];
-    let lastRequestTime = Date.now();
-    // Track request patterns
-    const requestHandler = () => {
-        const now = Date.now();
-        const interval = now - lastRequestTime;
-        if (interval < 5000)
-            intervals.push(interval);
-        lastRequestTime = now;
-        activeRequests++;
-        lastActivity = now;
-    };
-    const finishHandler = () => {
-        activeRequests--;
-        if (activeRequests === 0) {
-            lastActivity = Date.now();
-        }
-    };
-    const requestHandlerId = cdp.on('Network.requestWillBeSent', requestHandler);
-    const loadingFinishedId = cdp.on('Network.loadingFinished', finishHandler);
-    const loadingFailedId = cdp.on('Network.loadingFailed', finishHandler);
-    try {
-        // Use fixed threshold for immediate detection
-        const idleThreshold = 200; // 200ms idle = network stable
-        // Detection phase: wait for stability
-        while (Date.now() < deadline) {
-            if (activeRequests === 0) {
-                const idleTime = Date.now() - lastActivity;
-                if (idleTime >= idleThreshold) {
-                    return idleTime; // Success!
-                }
-            }
-            await delay(50); // Check every 50ms
-        }
-        throw new Error('Network stability timeout');
-    }
-    finally {
-        // Cleanup handlers
-        cdp.off('Network.requestWillBeSent', requestHandlerId);
-        cdp.off('Network.loadingFinished', loadingFinishedId);
-        cdp.off('Network.loadingFailed', loadingFailedId);
-    }
-}
-/**
- * Wait for DOM to stabilize
- *
- * Uses a MutationObserver to detect when the DOM stops changing.
- * DOM is considered stable when there are no mutations for 300ms continuously.
- *
- * HOW IT WORKS:
- * 1. Inject MutationObserver into page to track all DOM changes
- * 2. Monitor childList, attributes, subtree, and characterData changes
- * 3. Wait for 300ms of continuous no-change activity
- * 4. Clean up observer when complete
- *
- * Why this works:
- * - SSR hydration causes DOM mutations (React, Vue, Svelte)
- * - Client-side rendering creates DOM elements
- * - When mutations stop, framework initialization is complete
- * - 300ms is long enough to catch batched updates, short enough to be responsive
- *
- * Framework-agnostic - detects actual mutations regardless of framework.
- *
- * @param cdp - CDP connection
- * @param deadline - Timestamp when to timeout
- * @returns Actual stable duration detected
- * @throws Error if deadline exceeded
- */
-async function waitForDOMStable(cdp, deadline) {
-    // Inject mutation observer
-    await cdp.send('Runtime.evaluate', {
-        expression: `
-      window.__bdg_mutations = 0;
-      window.__bdg_lastMutation = Date.now();
-
-      const observer = new MutationObserver(() => {
-        window.__bdg_mutations++;
-        window.__bdg_lastMutation = Date.now();
-      });
-
-      observer.observe(document.body, {
-        childList: true,
-        subtree: true,
-        attributes: true,
-        characterData: true
-      });
-
-      window.__bdg_observer = observer;
-    `,
-    });
-    try {
-        // Use fixed threshold for immediate detection
-        const stableThreshold = 300; // 300ms no mutations = DOM stable
-        // Detection phase: wait for stability
-        while (Date.now() < deadline) {
-            const checkResult = await cdp.send('Runtime.evaluate', {
-                expression: 'Date.now() - window.__bdg_lastMutation',
-                returnByValue: true,
-            });
-            const timeSinceLastMutation = checkResult.result?.value ?? 0;
-            if (timeSinceLastMutation >= stableThreshold) {
-                return timeSinceLastMutation; // Success!
-            }
-            await delay(100); // Check every 100ms
-        }
-        throw new Error('DOM stability timeout');
-    }
-    finally {
-        // Cleanup observer
-        await cdp
-            .send('Runtime.evaluate', {
-            expression: `
-        window.__bdg_observer?.disconnect();
-        delete window.__bdg_observer;
-        delete window.__bdg_mutations;
-        delete window.__bdg_lastMutation;
-      `,
-        })
-            .catch(() => {
-            // Ignore cleanup errors
-        });
-    }
-}
-/**
- * Delay utility
- *
- * @param ms - Milliseconds to delay
- */
-function delay(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-//# sourceMappingURL=pageReadiness.js.map

package/dist/utils/pageReadiness.js.map

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

package/dist/utils/session.d.ts

@@ -1,200 +0,0 @@
-import type { BdgOutput, CollectorType } from '../types.js';
-/**
- * Session file paths relative to ~/.bdg/
- * Centralized definition for all session-related files.
- */
-declare const SESSION_FILES: {
-    readonly PID: "session.pid";
-    readonly OUTPUT: "session.json";
-    readonly LOCK: "session.lock";
-    readonly METADATA: "session.meta.json";
-    readonly CHROME_PID: "chrome.pid";
-    readonly PREVIEW: "session.preview.json";
-    readonly FULL: "session.full.json";
-};
-/**
- * Session file type for type-safe path generation
- */
-export type SessionFileType = keyof typeof SESSION_FILES;
-/**
- * Get the session directory path (~/.bdg)
- */
-export declare function getSessionDir(): string;
-/**
- * Get the path to a session file by type.
- *
- * @param fileType - The type of session file
- * @returns Full path to the session file
- */
-export declare function getSessionFilePath(fileType: SessionFileType): string;
-/**
- * Ensure the session directory exists
- */
-export declare function ensureSessionDir(): void;
-/**
- * Get the path to the PID file
- */
-export declare function getPidFilePath(): string;
-/**
- * Get the path to the output JSON file
- */
-export declare function getOutputFilePath(): string;
-/**
- * Get the path to the session lock file
- */
-export declare function getLockFilePath(): string;
-/**
- * Get the path to the session metadata file
- */
-export declare function getMetadataFilePath(): string;
-/**
- * Get the path to the persistent Chrome PID cache file.
- * This file survives session cleanup so aggressive cleanup can still find Chrome.
- */
-export declare function getChromePidCachePath(): string;
-/**
- * Session metadata stored alongside PID
- */
-export interface SessionMetadata {
-    bdgPid: number;
-    chromePid?: number | undefined;
-    startTime: number;
-    port: number;
-    targetId?: string | undefined;
-    webSocketDebuggerUrl?: string | undefined;
-    activeCollectors?: CollectorType[] | undefined;
-}
-/**
- * Write the current process PID to the session file atomically
- *
- * @param pid - Process ID to write
- */
-export declare function writePid(pid: number): void;
-/**
- * Read the PID from the session file
- *
- * @returns The PID if file exists and is valid, null otherwise
- */
-export declare function readPid(): number | null;
-/**
- * Check if a process with the given PID is alive
- *
- * @param pid - Process ID to check
- * @returns True if process is running, false otherwise
- */
-export declare function isProcessAlive(pid: number): boolean;
-/**
- * Remove the PID file
- */
-export declare function cleanupPidFile(): void;
-/**
- * Write session output to the JSON file
- *
- * @param output - The BdgOutput data to write
- * @param compact - If true, use compact JSON format (no indentation)
- */
-export declare function writeSessionOutput(output: BdgOutput, compact?: boolean): void;
-/**
- * Acquire session lock atomically.
- *
- * Uses exclusive file creation (wx flag) to ensure only one session can run.
- *
- * @returns True if lock was acquired, false if another session is running
- */
-export declare function acquireSessionLock(): boolean;
-/**
- * Release session lock.
- *
- * Removes the lock file to allow other sessions to start.
- */
-export declare function releaseSessionLock(): void;
-/**
- * Write session metadata.
- *
- * @param metadata - Session metadata to write
- */
-export declare function writeSessionMetadata(metadata: SessionMetadata): void;
-/**
- * Read session metadata.
- *
- * @returns Session metadata if file exists and is valid, null otherwise
- */
-export declare function readSessionMetadata(): SessionMetadata | null;
-/**
- * Write Chrome PID to persistent cache.
- * This survives session cleanup so aggressive cleanup can find Chrome later.
- *
- * @param chromePid - Chrome process ID to cache
- */
-export declare function writeChromePid(chromePid: number): void;
-/**
- * Read Chrome PID from persistent cache.
- *
- * @returns Chrome PID if cached and process is alive, null otherwise
- */
-export declare function readChromePid(): number | null;
-/**
- * Remove Chrome PID from persistent cache.
- */
-export declare function clearChromePid(): void;
-/**
- * Kill a Chrome process using cross-platform approach.
- *
- * Windows: Uses `taskkill /pid <pid> /T /F` to kill process tree
- * Unix/macOS: Uses `process.kill(-pid, signal)` to kill process group
- *
- * @param pid - Chrome process ID to kill
- * @param signal - Signal to send (Unix only, default 'SIGTERM'). Ignored on Windows.
- * @throws Error if kill operation fails
- */
-export declare function killChromeProcess(pid: number, signal?: NodeJS.Signals): void;
-/**
- * Get the path to the partial output file (lightweight preview, metadata only)
- */
-export declare function getPartialFilePath(): string;
-/**
- * Get the path to the full output file (complete data with bodies)
- */
-export declare function getFullFilePath(): string;
-/**
- * Write partial session output for live preview (async version).
- *
- * Uses atomic write (tmp file + rename) to prevent corruption.
- * Non-blocking version for periodic writes during collection.
- *
- * @param output - The partial BdgOutput data to write
- * @param compact - If true, use compact JSON format (no indentation)
- * @returns Promise that resolves when write completes
- */
-export declare function writePartialOutputAsync(output: BdgOutput, compact?: boolean): Promise<void>;
-/**
- * Write full session output for details view (async version).
- *
- * Uses atomic write (tmp file + rename) to prevent corruption.
- * Non-blocking version for periodic writes during collection.
- *
- * @param output - The full BdgOutput data to write
- * @param compact - If true, use compact JSON format (no indentation)
- * @returns Promise that resolves when write completes
- */
-export declare function writeFullOutputAsync(output: BdgOutput, compact?: boolean): Promise<void>;
-/**
- * Read partial session output for live preview (lightweight metadata).
- *
- * @returns The partial BdgOutput data if file exists and is valid, null otherwise
- */
-export declare function readPartialOutput(): BdgOutput | null;
-/**
- * Read full session output for details view (complete data with bodies).
- *
- * @returns The full BdgOutput data if file exists and is valid, null otherwise
- */
-export declare function readFullOutput(): BdgOutput | null;
-/**
- * Cleanup all session files.
- *
- * Removes PID, lock, metadata, preview, full, and output files.
- */
-export declare function cleanupSession(): void;
-export {};
-//# sourceMappingURL=session.d.ts.map

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

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