browser-debugger-cli 0.3.0 → 0.5.1

package/dist/commands/domErrorHandler.d.ts

@@ -1,45 +0,0 @@
-/**
- * Handle command errors with consistent formatting
- *
- * Outputs error message in JSON or human-readable format and exits with error code.
- * This function never returns - it always calls process.exit().
- *
- * @param error - Error object or message
- * @param json - Whether to output JSON format
- * @param exitCode - Exit code to use (defaults to UNHANDLED_EXCEPTION)
- * @throws never This function always exits the process
- *
- * @example
- * ```typescript
- * try {
- *   await someOperation();
- * } catch (error) {
- *   handleCommandError(error, options.json);
- * }
- * ```
- */
-export declare function handleCommandError(error: unknown, json: boolean, exitCode?: number): never;
-/**
- * Handle command errors with additional context
- *
- * Similar to handleCommandError but allows adding suggestion or note metadata
- * to JSON error output for better user guidance.
- *
- * @param error - Error object or message
- * @param json - Whether to output JSON format
- * @param metadata - Additional context (suggestion, note, etc.)
- * @param exitCode - Exit code to use (defaults to UNHANDLED_EXCEPTION)
- * @throws never This function always exits the process
- *
- * @example
- * ```typescript
- * handleCommandErrorWithContext(
- *   'Session not found',
- *   options.json,
- *   { suggestion: 'Start a session with: bdg <url>' },
- *   EXIT_CODES.RESOURCE_NOT_FOUND
- * );
- * ```
- */
-export declare function handleCommandErrorWithContext(error: unknown, json: boolean, metadata: Record<string, string>, exitCode?: number): never;
-//# sourceMappingURL=domErrorHandler.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"domErrorHandler.d.ts","sourceRoot":"","sources":["../../src/commands/domErrorHandler.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,OAAO,EACb,QAAQ,GAAE,MAAuC,GAChD,KAAK,CAQP;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,QAAQ,GAAE,MAAuC,GAChD,KAAK,CAYP"}

package/dist/commands/domErrorHandler.js

@@ -1,71 +0,0 @@
-import { OutputBuilder } from '../commands/shared/OutputBuilder.js';
-import { genericError } from '../ui/messages/errors.js';
-import { getErrorMessage } from '../utils/errors.js';
-import { EXIT_CODES } from '../utils/exitCodes.js';
-/**
- * Handle command errors with consistent formatting
- *
- * Outputs error message in JSON or human-readable format and exits with error code.
- * This function never returns - it always calls process.exit().
- *
- * @param error - Error object or message
- * @param json - Whether to output JSON format
- * @param exitCode - Exit code to use (defaults to UNHANDLED_EXCEPTION)
- * @throws never This function always exits the process
- *
- * @example
- * ```typescript
- * try {
- *   await someOperation();
- * } catch (error) {
- *   handleCommandError(error, options.json);
- * }
- * ```
- */
-export function handleCommandError(error, json, exitCode = EXIT_CODES.UNHANDLED_EXCEPTION) {
-    const errorMsg = getErrorMessage(error);
-    if (json) {
-        console.log(JSON.stringify(OutputBuilder.buildJsonError(errorMsg), null, 2));
-    }
-    else {
-        console.error(genericError(errorMsg));
-    }
-    process.exit(exitCode);
-}
-/**
- * Handle command errors with additional context
- *
- * Similar to handleCommandError but allows adding suggestion or note metadata
- * to JSON error output for better user guidance.
- *
- * @param error - Error object or message
- * @param json - Whether to output JSON format
- * @param metadata - Additional context (suggestion, note, etc.)
- * @param exitCode - Exit code to use (defaults to UNHANDLED_EXCEPTION)
- * @throws never This function always exits the process
- *
- * @example
- * ```typescript
- * handleCommandErrorWithContext(
- *   'Session not found',
- *   options.json,
- *   { suggestion: 'Start a session with: bdg <url>' },
- *   EXIT_CODES.RESOURCE_NOT_FOUND
- * );
- * ```
- */
-export function handleCommandErrorWithContext(error, json, metadata, exitCode = EXIT_CODES.UNHANDLED_EXCEPTION) {
-    const errorMsg = getErrorMessage(error);
-    if (json) {
-        console.log(JSON.stringify(OutputBuilder.buildJsonError(errorMsg, metadata), null, 2));
-    }
-    else {
-        console.error(genericError(errorMsg));
-        // Output metadata as additional help text
-        for (const value of Object.values(metadata)) {
-            console.error(`${value}`);
-        }
-    }
-    process.exit(exitCode);
-}
-//# sourceMappingURL=domErrorHandler.js.map

package/dist/commands/domErrorHandler.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"domErrorHandler.js","sourceRoot":"","sources":["../../src/commands/domErrorHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAc,EACd,IAAa,EACb,WAAmB,UAAU,CAAC,mBAAmB;IAEjD,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/E,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAAc,EACd,IAAa,EACb,QAAgC,EAChC,WAAmB,UAAU,CAAC,mBAAmB;IAEjD,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACzF,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;QACtC,0CAA0C;QAC1C,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5C,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACzB,CAAC"}

package/dist/dom/cache.d.ts

@@ -1,36 +0,0 @@
-/**
- * DOM query cache structure
- * Stores results from last DOM query for index-based lookups
- */
-export interface DomQueryCache {
-    selector: string;
-    timestamp: string;
-    sessionId?: string;
-    nodes: Array<{
-        index: number;
-        nodeId: number;
-        tag?: string;
-        classes?: string[];
-        preview?: string;
-    }>;
-}
-/**
- * Write DOM query results to cache
- *
- * @param cache - DOM query cache data to write
- */
-export declare function writeQueryCache(cache: DomQueryCache): void;
-/**
- * Read DOM query cache
- *
- * @returns DOM query cache or null if not available/expired
- */
-export declare function readQueryCache(): DomQueryCache | null;
-/**
- * Get nodeId from cache by index
- *
- * @param index - Index from query results (1-based)
- * @returns nodeId if found, null otherwise
- */
-export declare function getNodeIdByIndex(index: number): number | null;
-//# sourceMappingURL=cache.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/dom/cache.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,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;AAOD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAQ1D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,aAAa,GAAG,IAAI,CA0BrD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ7D"}

package/dist/dom/cache.js

@@ -1,65 +0,0 @@
-import fs from 'fs';
-import { getDomQueryCachePath } from '../session/paths.js';
-import { getErrorMessage } from '../utils/errors.js';
-/**
- * Cache expiration time (5 minutes)
- */
-const CACHE_EXPIRY_MS = 5 * 60 * 1000;
-/**
- * Write DOM query results to cache
- *
- * @param cache - DOM query cache data to write
- */
-export function writeQueryCache(cache) {
-    try {
-        const cachePath = getDomQueryCachePath();
-        fs.writeFileSync(cachePath, JSON.stringify(cache, null, 2), 'utf8');
-    }
-    catch (error) {
-        // Silently fail - cache is optional and non-critical for CLI operation
-        console.error(`Warning: Failed to write DOM cache: ${getErrorMessage(error)}`);
-    }
-}
-/**
- * Read DOM query cache
- *
- * @returns DOM query cache or null if not available/expired
- */
-export function readQueryCache() {
-    try {
-        const cachePath = getDomQueryCachePath();
-        if (!fs.existsSync(cachePath)) {
-            return null;
-        }
-        const data = fs.readFileSync(cachePath, 'utf8');
-        const cache = JSON.parse(data);
-        // Check if cache is expired
-        const cacheTime = new Date(cache.timestamp).getTime();
-        const now = Date.now();
-        if (now - cacheTime > CACHE_EXPIRY_MS) {
-            // Cache expired - delete it
-            fs.unlinkSync(cachePath);
-            return null;
-        }
-        return cache;
-    }
-    catch {
-        // Silently fail - cache is optional, missing/corrupt cache doesn't affect core functionality
-        return null;
-    }
-}
-/**
- * Get nodeId from cache by index
- *
- * @param index - Index from query results (1-based)
- * @returns nodeId if found, null otherwise
- */
-export function getNodeIdByIndex(index) {
-    const cache = readQueryCache();
-    if (!cache) {
-        return null;
-    }
-    const node = cache.nodes.find((n) => n.index === index);
-    return node?.nodeId ?? null;
-}
-//# sourceMappingURL=cache.js.map

package/dist/dom/cache.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/dom/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAmBpD;;GAEG;AACH,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAEtC;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAoB;IAClD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC;QACzC,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACtE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,uEAAuE;QACvE,OAAO,CAAC,KAAK,CAAC,uCAAuC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACjF,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC;QAEzC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAkB,CAAC;QAEhD,4BAA4B;QAC5B,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;QACtD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,IAAI,GAAG,GAAG,SAAS,GAAG,eAAe,EAAE,CAAC;YACtC,4BAA4B;YAC5B,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;YACzB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,6FAA6F;QAC7F,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;IAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IACxD,OAAO,IAAI,EAAE,MAAM,IAAI,IAAI,CAAC;AAC9B,CAAC"}

package/dist/dom/index.d.ts

@@ -1,9 +0,0 @@
-/**
- * Shared DOM utilities used across CLI and daemon layers.
- *
- * This module provides low-level DOM operations via Chrome DevTools Protocol (CDP)
- * and query result caching for index-based lookups.
- */
-export * from './cache.js';
-export * from './query.js';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dom/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/dom/index.js

@@ -1,9 +0,0 @@
-/**
- * Shared DOM utilities used across CLI and daemon layers.
- *
- * This module provides low-level DOM operations via Chrome DevTools Protocol (CDP)
- * and query result caching for index-based lookups.
- */
-export * from './cache.js';
-export * from './query.js';
-//# sourceMappingURL=index.js.map

package/dist/dom/index.js.map

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

package/dist/dom/query.d.ts

@@ -1,48 +0,0 @@
-import type { CDPConnection } from '../connection/cdp.js';
-/**
- * DOM node information from CDP
- */
-export interface DomNodeInfo {
-    nodeId: number;
-    tag?: string;
-    classes?: string[];
-    attributes?: Record<string, string>;
-    outerHTML?: string;
-    textContent?: string;
-}
-/**
- * Get document root node ID
- *
- * @param cdp - CDP connection instance
- * @returns Root node ID
- * @throws Error When CDP command fails or connection is lost
- */
-export declare function getDocumentRoot(cdp: CDPConnection): Promise<number>;
-/**
- * Query DOM by CSS selector
- *
- * @param cdp - CDP connection instance
- * @param selector - CSS selector to query
- * @param rootNodeId - Optional root node ID (defaults to document root)
- * @returns Array of node IDs matching the selector
- * @throws Error When CDP command fails or selector is invalid
- */
-export declare function queryBySelector(cdp: CDPConnection, selector: string, rootNodeId?: number): Promise<number[]>;
-/**
- * Get node information
- *
- * @param cdp - CDP connection instance
- * @param nodeId - Node ID to query
- * @returns Node information including tag, classes, attributes
- * @throws Error When CDP command fails or nodeId is invalid
- */
-export declare function getNodeInfo(cdp: CDPConnection, nodeId: number): Promise<DomNodeInfo>;
-/**
- * Create preview text for a node
- *
- * @param nodeInfo - Node information
- * @param maxLength - Maximum preview length (default: 50)
- * @returns Preview text
- */
-export declare function createNodePreview(nodeInfo: DomNodeInfo, maxLength?: number): string;
-//# sourceMappingURL=query.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/dom/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAKzE;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,EAAE,CAAC,CAUnB;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAoD1F;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,SAAK,GAAG,MAAM,CAoB/E"}

package/dist/dom/query.js

@@ -1,104 +0,0 @@
-/**
- * Get document root node ID
- *
- * @param cdp - CDP connection instance
- * @returns Root node ID
- * @throws Error When CDP command fails or connection is lost
- */
-export async function getDocumentRoot(cdp) {
-    const result = (await cdp.send('DOM.getDocument', { depth: -1 }));
-    return result.root.nodeId;
-}
-/**
- * Query DOM by CSS selector
- *
- * @param cdp - CDP connection instance
- * @param selector - CSS selector to query
- * @param rootNodeId - Optional root node ID (defaults to document root)
- * @returns Array of node IDs matching the selector
- * @throws Error When CDP command fails or selector is invalid
- */
-export async function queryBySelector(cdp, selector, rootNodeId) {
-    // Get root node if not provided
-    const nodeId = rootNodeId ?? (await getDocumentRoot(cdp));
-    const result = (await cdp.send('DOM.querySelectorAll', {
-        nodeId,
-        selector,
-    }));
-    return result.nodeIds;
-}
-/**
- * Get node information
- *
- * @param cdp - CDP connection instance
- * @param nodeId - Node ID to query
- * @returns Node information including tag, classes, attributes
- * @throws Error When CDP command fails or nodeId is invalid
- */
-export async function getNodeInfo(cdp, nodeId) {
-    // Get node description
-    const describeResult = (await cdp.send('DOM.describeNode', {
-        nodeId,
-    }));
-    const node = describeResult.node;
-    // Parse attributes array into object
-    const attributes = {};
-    if (node.attributes) {
-        for (let i = 0; i < node.attributes.length; i += 2) {
-            const key = node.attributes[i];
-            const value = node.attributes[i + 1];
-            if (key !== undefined && value !== undefined) {
-                attributes[key] = value;
-            }
-        }
-    }
-    // Extract classes from class attribute
-    const classes = attributes['class']?.split(/\s+/).filter((c) => c.length > 0) ?? [];
-    // Get outer HTML
-    const htmlResult = (await cdp.send('DOM.getOuterHTML', {
-        nodeId,
-    }));
-    // Extract text content by removing HTML tags
-    // Uses simple regex to strip tags while preserving text content including < and > in text
-    // SAFETY: This HTML comes from Chrome's internal DOM via CDP, not user input.
-    // It's trusted browser-generated content used only for display/analysis in CLI output.
-    // The regex is intentionally simple because we're extracting text, not sanitizing for XSS.
-    const textContent = htmlResult.outerHTML
-        .replace(/<[^>]*>/g, '') // Remove HTML tags
-        .replace(/\s+/g, ' ') // Collapse whitespace
-        .trim();
-    return {
-        nodeId,
-        tag: node.nodeName.toLowerCase(),
-        classes,
-        attributes,
-        outerHTML: htmlResult.outerHTML,
-        textContent,
-    };
-}
-/**
- * Create preview text for a node
- *
- * @param nodeInfo - Node information
- * @param maxLength - Maximum preview length (default: 50)
- * @returns Preview text
- */
-export function createNodePreview(nodeInfo, maxLength = 50) {
-    // If we have text content, use that
-    if (nodeInfo.textContent && nodeInfo.textContent.length > 0) {
-        const text = nodeInfo.textContent;
-        if (text.length > maxLength) {
-            return text.slice(0, maxLength) + '...';
-        }
-        return text;
-    }
-    // Otherwise show the opening tag
-    const tag = nodeInfo.tag ?? 'unknown';
-    const classAttr = nodeInfo.classes && nodeInfo.classes.length > 0 ? ` class="${nodeInfo.classes.join(' ')}"` : '';
-    const preview = `<${tag}${classAttr}>`;
-    if (preview.length > maxLength) {
-        return preview.slice(0, maxLength) + '...';
-    }
-    return preview;
-}
-//# sourceMappingURL=query.js.map

package/dist/dom/query.js.map

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

package/dist/utils/formatters/network.d.ts

@@ -1,23 +0,0 @@
-/**
- * Network data formatters 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
- */
-export declare function formatCookies(cookies: Cookie[]): void;
-//# sourceMappingURL=network.d.ts.map

package/dist/utils/formatters/network.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../../src/utils/formatters/network.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;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;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CA6BrD"}

package/dist/utils/formatters/network.js

@@ -1,35 +0,0 @@
-/**
- * Network data formatters for human-readable output
- */
-/**
- * Format cookies for human-readable output
- *
- * @param cookies - Array of CDP cookies
- */
-export function formatCookies(cookies) {
-    if (cookies.length === 0) {
-        console.log('No cookies found');
-        return;
-    }
-    console.log(`Cookies (${cookies.length}):\n`);
-    cookies.forEach((cookie, index) => {
-        console.log(`[${index + 1}] ${cookie.name}`);
-        console.log(`  Value: ${cookie.value}`);
-        console.log(`  Domain: ${cookie.domain}`);
-        console.log(`  Path: ${cookie.path}`);
-        if (cookie.expires && cookie.expires !== -1) {
-            const expiresDate = new Date(cookie.expires * 1000);
-            console.log(`  Expires: ${expiresDate.toISOString()}`);
-        }
-        else {
-            console.log(`  Expires: Session`);
-        }
-        console.log(`  HttpOnly: ${cookie.httpOnly ? 'Yes' : 'No'}`);
-        console.log(`  Secure: ${cookie.secure ? 'Yes' : 'No'}`);
-        console.log(`  SameSite: ${cookie.sameSite ?? 'None'}`);
-        if (index < cookies.length - 1) {
-            console.log('');
-        }
-    });
-}
-//# sourceMappingURL=network.js.map

package/dist/utils/formatters/network.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"network.js","sourceRoot":"","sources":["../../../src/utils/formatters/network.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgBH;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,OAAiB;IAC7C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAChC,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,CAAC,MAAM,MAAM,CAAC,CAAC;IAE9C,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAChC,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAEtC,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,OAAO,CAAC,GAAG,CAAC,cAAc,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACzD,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QACpC,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,QAAQ,IAAI,MAAM,EAAE,CAAC,CAAC;QAExD,IAAI,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/ui.d.ts

@@ -1,36 +0,0 @@
-/**
- * UI utilities for enhanced terminal output.
- *
- * WHY: Provides visual feedback and branding for CLI operations.
- */
-/**
- * Options for the landing page display.
- */
-export interface LandingPageOptions {
-    /** Target URL being monitored */
-    url: string;
-    /** Worker process ID */
-    workerPid: number;
-    /** Chrome process ID */
-    chromePid: number;
-    /** Collectors enabled */
-    collectors: string[];
-}
-/**
- * Generate the landing page display for session start.
- *
- * @param options - Landing page options
- * @returns Formatted landing page string
- *
- * @example
- * ```typescript
- * landingPage({
- *   url: 'http://localhost:3000',
- *   workerPid: 12345,
- *   chromePid: 12346,
- *   collectors: ['network', 'console', 'dom']
- * });
- * ```
- */
-export declare function landingPage(options: LandingPageOptions): string;
-//# sourceMappingURL=ui.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/utils/ui.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CA2B/D"}

package/dist/utils/ui.js

@@ -1,47 +0,0 @@
-/**
- * UI utilities for enhanced terminal output.
- *
- * WHY: Provides visual feedback and branding for CLI operations.
- */
-/**
- * Generate the landing page display for session start.
- *
- * @param options - Landing page options
- * @returns Formatted landing page string
- *
- * @example
- * ```typescript
- * landingPage({
- *   url: 'http://localhost:3000',
- *   workerPid: 12345,
- *   chromePid: 12346,
- *   collectors: ['network', 'console', 'dom']
- * });
- * ```
- */
-export function landingPage(options) {
-    const { url, workerPid, chromePid, collectors } = options;
-    const lines = [];
-    lines.push('');
-    lines.push('   bdg');
-    lines.push('');
-    lines.push('   ▲  Session Started');
-    lines.push('');
-    lines.push(`   ○  Target      ${url}`);
-    lines.push(`   ○  Chrome      PID ${chromePid}`);
-    lines.push(`   ○  Worker      PID ${workerPid}`);
-    lines.push(`   ○  Collecting  ${collectors.join(', ')}`);
-    lines.push('');
-    lines.push('   Ready — use these commands:');
-    lines.push('');
-    lines.push('     bdg status                   Session info');
-    lines.push('     bdg peek                     Preview data');
-    lines.push('     bdg cdp <method> [params]    Execute CDP commands');
-    lines.push('     bdg stop                     Stop & save');
-    lines.push('');
-    lines.push('   💡 Run any Chrome DevTools Protocol command:');
-    lines.push('      bdg cdp Runtime.evaluate \'{"expression": "document.title"}\'');
-    lines.push('');
-    return lines.join('\n');
-}
-//# sourceMappingURL=ui.js.map

package/dist/utils/ui.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/utils/ui.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAE1D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,yBAAyB,SAAS,EAAE,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CAAC,yBAAyB,SAAS,EAAE,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CAAC,qBAAqB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IAC7C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;IAC7D,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;IAC7D,KAAK,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;IACrE,KAAK,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;IAC5D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;IAC9D,KAAK,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;IAClF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/utils/url/safeParseUrl.d.ts

@@ -1,63 +0,0 @@
-/**
- * Safe URL parsing utilities with automatic protocol detection.
- *
- * Provides centralized URL parsing that gracefully handles:
- * - Missing protocols (adds http://)
- * - Malformed URLs (returns null)
- * - Localhost and bare hostnames
- *
- * WHY: Eliminates duplicated try/catch blocks across 4+ files
- * (filters.ts, url.ts, collectors, connection layer).
- */
-/**
- * Safely parse a URL string with automatic protocol detection.
- *
- * Attempts to parse the URL in two passes:
- * 1. As-is (supports full URLs with protocols)
- * 2. With 'http://' prefix (supports localhost:3000, example.com, etc.)
- *
- * @param input - URL string to parse (may lack protocol)
- * @returns Parsed URL object, or null if parsing fails both attempts
- *
- * @example
- * ```typescript
- * safeParseUrl('https://example.com')       // → URL { ... }
- * safeParseUrl('localhost:3000')            // → URL { protocol: 'http:', ... }
- * safeParseUrl('example.com/path')          // → URL { protocol: 'http:', ... }
- * safeParseUrl('not a url')                 // → null
- * safeParseUrl('file:///path/to/file.html') // → URL { protocol: 'file:', ... }
- * ```
- */
-export declare function safeParseUrl(input: string): URL | null;
-/**
- * Extract hostname from a URL string safely.
- *
- * @param input - URL string to extract hostname from
- * @returns Hostname (e.g., 'example.com'), or original input if parsing fails
- *
- * @example
- * ```typescript
- * extractHostname('https://example.com/path') // → 'example.com'
- * extractHostname('localhost:3000')           // → 'localhost'
- * extractHostname('invalid')                  // → 'invalid'
- * ```
- */
-export declare function extractHostname(input: string): string;
-/**
- * Extract hostname with pathname from a URL string safely.
- *
- * Useful for pattern matching that needs both hostname and path segments.
- *
- * @param input - URL string to extract hostname+pathname from
- * @returns Hostname with pathname (e.g., 'example.com/api/users'), or original input if parsing fails
- *
- * @example
- * ```typescript
- * extractHostnameWithPath('https://api.example.com/v1/users?id=123')
- *   // → 'api.example.com/v1/users'
- * extractHostnameWithPath('localhost:3000/dashboard')
- *   // → 'localhost/dashboard'
- * ```
- */
-export declare function extractHostnameWithPath(input: string): string;
-//# sourceMappingURL=safeParseUrl.d.ts.map

package/dist/utils/url/safeParseUrl.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"safeParseUrl.d.ts","sourceRoot":"","sources":["../../../src/utils/url/safeParseUrl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAatD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG7D"}