browser-debugger-cli 0.0.1-alpha.0 → 0.1.0-alpha.1

package/dist/utils/cdpHandlers.d.ts

@@ -0,0 +1,31 @@
+import type { CDPConnection } from '../connection/cdp.js';
+/**
+ * Registry for managing CDP event handlers with automatic cleanup.
+ *
+ * Provides a centralized way to register and clean up CDP event handlers,
+ * eliminating the boilerplate code repeated across all collectors.
+ */
+export declare class CDPHandlerRegistry {
+    private handlers;
+    /**
+     * Register a CDP event handler and track it for cleanup.
+     *
+     * @param cdp - CDP connection instance
+     * @param event - CDP event name (e.g., 'Network.requestWillBeSent')
+     * @param handler - Event handler function
+     */
+    register<T>(cdp: CDPConnection, event: string, handler: (params: T) => void): void;
+    /**
+     * Remove all registered event handlers and clear the registry.
+     *
+     * @param cdp - CDP connection instance
+     */
+    cleanup(cdp: CDPConnection): void;
+    /**
+     * Get the number of registered handlers.
+     *
+     * @returns Number of active handlers
+     */
+    size(): number;
+}
+//# sourceMappingURL=cdpHandlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cdpHandlers.d.ts","sourceRoot":"","sources":["../../src/utils/cdpHandlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAA4C;IAE5D;;;;;;OAMG;IACH,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI;IAKlF;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IAKjC;;;;OAIG;IACH,IAAI,IAAI,MAAM;CAGf"}

package/dist/utils/cdpHandlers.js

@@ -0,0 +1,38 @@
+/**
+ * Registry for managing CDP event handlers with automatic cleanup.
+ *
+ * Provides a centralized way to register and clean up CDP event handlers,
+ * eliminating the boilerplate code repeated across all collectors.
+ */
+export class CDPHandlerRegistry {
+    handlers = [];
+    /**
+     * Register a CDP event handler and track it for cleanup.
+     *
+     * @param cdp - CDP connection instance
+     * @param event - CDP event name (e.g., 'Network.requestWillBeSent')
+     * @param handler - Event handler function
+     */
+    register(cdp, event, handler) {
+        const id = cdp.on(event, handler);
+        this.handlers.push({ event, id });
+    }
+    /**
+     * Remove all registered event handlers and clear the registry.
+     *
+     * @param cdp - CDP connection instance
+     */
+    cleanup(cdp) {
+        this.handlers.forEach(({ event, id }) => cdp.off(event, id));
+        this.handlers.length = 0;
+    }
+    /**
+     * Get the number of registered handlers.
+     *
+     * @returns Number of active handlers
+     */
+    size() {
+        return this.handlers.length;
+    }
+}
+//# sourceMappingURL=cdpHandlers.js.map

package/dist/utils/cdpHandlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdpHandlers.js","sourceRoot":"","sources":["../../src/utils/cdpHandlers.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IACrB,QAAQ,GAAyC,EAAE,CAAC;IAE5D;;;;;;OAMG;IACH,QAAQ,CAAI,GAAkB,EAAE,KAAa,EAAE,OAA4B;QACzE,MAAM,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,GAAkB;QACxB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;QAC7D,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC9B,CAAC;CACF"}

package/dist/utils/chromeDiagnostics.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Chrome installation diagnostics information
+ */
+export interface ChromeDiagnostics {
+    defaultPath: string | null;
+    installations: string[];
+    installationCount: number;
+}
+/**
+ * Get Chrome installation diagnostics.
+ * Results are cached for the lifetime of the process to avoid expensive filesystem scans.
+ *
+ * @returns Chrome diagnostics information
+ */
+export declare function getChromeDiagnostics(): ChromeDiagnostics;
+/**
+ * Format diagnostics for error reporting when Chrome launch fails.
+ * @param diagnostics - Chrome diagnostics information
+ * @returns Formatted error message with troubleshooting steps
+ */
+export declare function formatDiagnosticsForError(diagnostics: ChromeDiagnostics): string[];
+/**
+ * Format diagnostics for verbose status output (bdg status --verbose).
+ * @param diagnostics - Chrome diagnostics information
+ * @returns Array of formatted status lines
+ */
+export declare function formatDiagnosticsForStatus(diagnostics: ChromeDiagnostics): string[];
+//# sourceMappingURL=chromeDiagnostics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chromeDiagnostics.d.ts","sourceRoot":"","sources":["../../src/utils/chromeDiagnostics.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAOD;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,CA0BxD;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAwBlF;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAmBnF"}

package/dist/utils/chromeDiagnostics.js

@@ -0,0 +1,88 @@
+import * as chromeLauncher from 'chrome-launcher';
+/**
+ * Cached diagnostics result to avoid repeated filesystem scans
+ */
+let cachedDiagnostics = null;
+/**
+ * Get Chrome installation diagnostics.
+ * Results are cached for the lifetime of the process to avoid expensive filesystem scans.
+ *
+ * @returns Chrome diagnostics information
+ */
+export function getChromeDiagnostics() {
+    if (cachedDiagnostics) {
+        return cachedDiagnostics;
+    }
+    let defaultPath = null;
+    try {
+        defaultPath = chromeLauncher.getChromePath();
+    }
+    catch {
+        // getChromePath() may throw if no Chrome found
+    }
+    let installations = [];
+    try {
+        installations = chromeLauncher.Launcher.getInstallations();
+    }
+    catch {
+        // getInstallations() may throw on detection failure
+    }
+    cachedDiagnostics = {
+        defaultPath,
+        installations,
+        installationCount: installations.length,
+    };
+    return cachedDiagnostics;
+}
+/**
+ * Format diagnostics for error reporting when Chrome launch fails.
+ * @param diagnostics - Chrome diagnostics information
+ * @returns Formatted error message with troubleshooting steps
+ */
+export function formatDiagnosticsForError(diagnostics) {
+    const lines = [];
+    if (diagnostics.installationCount === 0) {
+        lines.push('Error: No Chrome installations detected\n');
+        lines.push('Install Chrome from:');
+        lines.push('   https://www.google.com/chrome/\n');
+    }
+    else {
+        lines.push(`Found ${diagnostics.installationCount} Chrome installation${diagnostics.installationCount > 1 ? 's' : ''}:\n`);
+        diagnostics.installations.forEach((path, index) => {
+            lines.push(`  ${index + 1}. ${path}`);
+        });
+        lines.push('');
+        if (diagnostics.defaultPath) {
+            lines.push(`Default binary: ${diagnostics.defaultPath}\n`);
+        }
+        else {
+            lines.push('Default binary: Could not determine\n');
+        }
+    }
+    return lines;
+}
+/**
+ * Format diagnostics for verbose status output (bdg status --verbose).
+ * @param diagnostics - Chrome diagnostics information
+ * @returns Array of formatted status lines
+ */
+export function formatDiagnosticsForStatus(diagnostics) {
+    const lines = [];
+    if (diagnostics.defaultPath) {
+        lines.push(`Binary:           ${diagnostics.defaultPath}`);
+    }
+    else {
+        lines.push('Binary:           Could not determine');
+    }
+    lines.push(`Installations:    ${diagnostics.installationCount} found`);
+    if (diagnostics.installationCount > 0 && diagnostics.installationCount <= 3) {
+        diagnostics.installations.forEach((path, index) => {
+            lines.push(`  ${index + 1}. ${path}`);
+        });
+    }
+    else if (diagnostics.installationCount > 3) {
+        lines.push(`  (Use 'bdg cleanup --aggressive' to see all)`);
+    }
+    return lines;
+}
+//# sourceMappingURL=chromeDiagnostics.js.map

package/dist/utils/chromeDiagnostics.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Custom error classes for bdg CLI.
+ *
+ * Provides structured error handling with error codes and categorization
+ * for better debugging and user-friendly error messages.
+ */
+/**
+ * Base error class for all bdg errors.
+ *
+ * Extends native Error with:
+ * - Error codes for programmatic handling
+ * - Category for filtering (system/user/external)
+ * - Exit code for semantic exit codes (80-99 user errors, 100-119 software errors)
+ * - Cause chaining for nested errors
+ */
+export declare abstract class BdgError extends Error {
+    abstract readonly code: string;
+    abstract readonly category: 'system' | 'user' | 'external';
+    abstract readonly exitCode: number;
+    constructor(message: string, cause?: Error);
+}
+/**
+ * CDP connection failed (network/protocol issues).
+ *
+ * Examples:
+ * - WebSocket connection refused
+ * - Chrome not running on specified port
+ * - Protocol version mismatch
+ */
+export declare class CDPConnectionError extends BdgError {
+    readonly code = "CDP_CONNECTION_ERROR";
+    readonly category: "external";
+    readonly exitCode = 101;
+}
+/**
+ * Chrome launch failed.
+ *
+ * Examples:
+ * - Chrome binary not found
+ * - Insufficient permissions
+ * - Port already in use
+ */
+export declare class ChromeLaunchError extends BdgError {
+    readonly code = "CHROME_LAUNCH_ERROR";
+    readonly category: "system";
+    readonly exitCode = 100;
+}
+/**
+ * CDP command timed out.
+ *
+ * Examples:
+ * - Command took longer than 30s
+ * - Browser became unresponsive
+ */
+export declare class CDPTimeoutError extends BdgError {
+    readonly code = "CDP_TIMEOUT_ERROR";
+    readonly category: "external";
+    readonly exitCode = 102;
+}
+/**
+ * Extract error message from unknown error type.
+ *
+ * Safely extracts error messages from various error types:
+ * - Error instances → error.message
+ * - Unknown types → String(error)
+ *
+ * Useful for error handling when error type is unknown.
+ *
+ * @param error - Error of unknown type
+ * @returns Error message string
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await someOperation();
+ * } catch (error) {
+ *   throw new ChromeLaunchError(`Failed: ${getErrorMessage(error)}`, error);
+ * }
+ * ```
+ */
+export declare function getErrorMessage(error: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;GAQG;AACH,8BAAsB,QAAS,SAAQ,KAAK;IAC1C,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAC3D,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEvB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAK3C;AAED;;;;;;;GAOG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,QAAQ,CAAC,IAAI,0BAA0B;IACvC,QAAQ,CAAC,QAAQ,EAAG,UAAU,CAAU;IACxC,QAAQ,CAAC,QAAQ,OAAO;CACzB;AAED;;;;;;;GAOG;AACH,qBAAa,iBAAkB,SAAQ,QAAQ;IAC7C,QAAQ,CAAC,IAAI,yBAAyB;IACtC,QAAQ,CAAC,QAAQ,EAAG,QAAQ,CAAU;IACtC,QAAQ,CAAC,QAAQ,OAAO;CACzB;AAED;;;;;;GAMG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;IAC3C,QAAQ,CAAC,IAAI,uBAAuB;IACpC,QAAQ,CAAC,QAAQ,EAAG,UAAU,CAAU;IACxC,QAAQ,CAAC,QAAQ,OAAO;CACzB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKtD"}

package/dist/utils/errors.js

@@ -0,0 +1,88 @@
+/**
+ * Custom error classes for bdg CLI.
+ *
+ * Provides structured error handling with error codes and categorization
+ * for better debugging and user-friendly error messages.
+ */
+/**
+ * Base error class for all bdg errors.
+ *
+ * Extends native Error with:
+ * - Error codes for programmatic handling
+ * - Category for filtering (system/user/external)
+ * - Exit code for semantic exit codes (80-99 user errors, 100-119 software errors)
+ * - Cause chaining for nested errors
+ */
+export class BdgError extends Error {
+    constructor(message, cause) {
+        super(message);
+        this.name = this.constructor.name;
+        this.cause = cause;
+    }
+}
+/**
+ * CDP connection failed (network/protocol issues).
+ *
+ * Examples:
+ * - WebSocket connection refused
+ * - Chrome not running on specified port
+ * - Protocol version mismatch
+ */
+export class CDPConnectionError extends BdgError {
+    code = 'CDP_CONNECTION_ERROR';
+    category = 'external';
+    exitCode = 101; // CDP_CONNECTION_FAILURE
+}
+/**
+ * Chrome launch failed.
+ *
+ * Examples:
+ * - Chrome binary not found
+ * - Insufficient permissions
+ * - Port already in use
+ */
+export class ChromeLaunchError extends BdgError {
+    code = 'CHROME_LAUNCH_ERROR';
+    category = 'system';
+    exitCode = 100; // CHROME_LAUNCH_FAILURE
+}
+/**
+ * CDP command timed out.
+ *
+ * Examples:
+ * - Command took longer than 30s
+ * - Browser became unresponsive
+ */
+export class CDPTimeoutError extends BdgError {
+    code = 'CDP_TIMEOUT_ERROR';
+    category = 'external';
+    exitCode = 102; // CDP_TIMEOUT
+}
+/**
+ * Extract error message from unknown error type.
+ *
+ * Safely extracts error messages from various error types:
+ * - Error instances → error.message
+ * - Unknown types → String(error)
+ *
+ * Useful for error handling when error type is unknown.
+ *
+ * @param error - Error of unknown type
+ * @returns Error message string
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await someOperation();
+ * } catch (error) {
+ *   throw new ChromeLaunchError(`Failed: ${getErrorMessage(error)}`, error);
+ * }
+ * ```
+ */
+export function getErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;GAQG;AACH,MAAM,OAAgB,QAAS,SAAQ,KAAK;IAK1C,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IACrC,IAAI,GAAG,sBAAsB,CAAC;IAC9B,QAAQ,GAAG,UAAmB,CAAC;IAC/B,QAAQ,GAAG,GAAG,CAAC,CAAC,yBAAyB;CACnD;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,iBAAkB,SAAQ,QAAQ;IACpC,IAAI,GAAG,qBAAqB,CAAC;IAC7B,QAAQ,GAAG,QAAiB,CAAC;IAC7B,QAAQ,GAAG,GAAG,CAAC,CAAC,wBAAwB;CAClD;AAED;;;;;;GAMG;AACH,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAClC,IAAI,GAAG,mBAAmB,CAAC;IAC3B,QAAQ,GAAG,UAAmB,CAAC;IAC/B,QAAQ,GAAG,GAAG,CAAC,CAAC,cAAc;CACxC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}

package/dist/utils/exitCodes.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Semantic exit codes for agent-friendly error handling.
+ *
+ * Based on Square Engineering's semantic exit code system:
+ * - 0: Success
+ * - 1: Generic failure (backward compatibility)
+ * - 80-99: User errors (invalid input, permissions, resource issues)
+ * - 100-119: Software errors (bugs, integration failures, timeouts)
+ *
+ * Reference: https://developer.squareup.com/blog/command-line-observability-with-semantic-exit-codes/
+ */
+/**
+ * Exit code constants following semantic ranges.
+ */
+export declare const EXIT_CODES: {
+    readonly SUCCESS: 0;
+    readonly GENERIC_FAILURE: 1;
+    readonly INVALID_URL: 80;
+    readonly INVALID_ARGUMENTS: 81;
+    readonly PERMISSION_DENIED: 82;
+    readonly RESOURCE_NOT_FOUND: 83;
+    readonly RESOURCE_ALREADY_EXISTS: 84;
+    readonly RESOURCE_BUSY: 85;
+    readonly DAEMON_ALREADY_RUNNING: 86;
+    readonly CHROME_LAUNCH_FAILURE: 100;
+    readonly CDP_CONNECTION_FAILURE: 101;
+    readonly CDP_TIMEOUT: 102;
+    readonly SESSION_FILE_ERROR: 103;
+    readonly UNHANDLED_EXCEPTION: 104;
+    readonly SIGNAL_HANDLER_ERROR: 105;
+};
+//# sourceMappingURL=exitCodes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exitCodes.d.ts","sourceRoot":"","sources":["../../src/utils/exitCodes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;CAuBb,CAAC"}

package/dist/utils/exitCodes.js

@@ -0,0 +1,36 @@
+/**
+ * Semantic exit codes for agent-friendly error handling.
+ *
+ * Based on Square Engineering's semantic exit code system:
+ * - 0: Success
+ * - 1: Generic failure (backward compatibility)
+ * - 80-99: User errors (invalid input, permissions, resource issues)
+ * - 100-119: Software errors (bugs, integration failures, timeouts)
+ *
+ * Reference: https://developer.squareup.com/blog/command-line-observability-with-semantic-exit-codes/
+ */
+/**
+ * Exit code constants following semantic ranges.
+ */
+export const EXIT_CODES = {
+    // Success
+    SUCCESS: 0,
+    // Generic failure (backward compatibility)
+    GENERIC_FAILURE: 1,
+    // User errors (80-99)
+    INVALID_URL: 80,
+    INVALID_ARGUMENTS: 81,
+    PERMISSION_DENIED: 82,
+    RESOURCE_NOT_FOUND: 83,
+    RESOURCE_ALREADY_EXISTS: 84,
+    RESOURCE_BUSY: 85,
+    DAEMON_ALREADY_RUNNING: 86,
+    // Software/Integration errors (100-119)
+    CHROME_LAUNCH_FAILURE: 100,
+    CDP_CONNECTION_FAILURE: 101,
+    CDP_TIMEOUT: 102,
+    SESSION_FILE_ERROR: 103,
+    UNHANDLED_EXCEPTION: 104,
+    SIGNAL_HANDLER_ERROR: 105,
+};
+//# sourceMappingURL=exitCodes.js.map

package/dist/utils/exitCodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exitCodes.js","sourceRoot":"","sources":["../../src/utils/exitCodes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,UAAU;IACV,OAAO,EAAE,CAAC;IAEV,2CAA2C;IAC3C,eAAe,EAAE,CAAC;IAElB,sBAAsB;IACtB,WAAW,EAAE,EAAE;IACf,iBAAiB,EAAE,EAAE;IACrB,iBAAiB,EAAE,EAAE;IACrB,kBAAkB,EAAE,EAAE;IACtB,uBAAuB,EAAE,EAAE;IAC3B,aAAa,EAAE,EAAE;IACjB,sBAAsB,EAAE,EAAE;IAE1B,wCAAwC;IACxC,qBAAqB,EAAE,GAAG;IAC1B,sBAAsB,EAAE,GAAG;IAC3B,WAAW,EAAE,GAAG;IAChB,kBAAkB,EAAE,GAAG;IACvB,mBAAmB,EAAE,GAAG;IACxB,oBAAoB,EAAE,GAAG;CACjB,CAAC"}

package/dist/utils/filters.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Default filters for reducing noise in collected data
+ */
+/**
+ * Domains to exclude by default (common tracking/analytics)
+ * These generate high volume but are rarely useful for debugging
+ */
+export declare const DEFAULT_EXCLUDED_DOMAINS: string[];
+/**
+ * Console message types to exclude by default (Redux/React DevTools noise)
+ */
+export declare const DEFAULT_EXCLUDED_CONSOLE_TYPES: string[];
+/**
+ * Console message patterns to exclude by default (dev server noise)
+ */
+export declare const DEFAULT_EXCLUDED_CONSOLE_PATTERNS: string[];
+/**
+ * File patterns to skip body fetching by default (assets unlikely to be useful for debugging)
+ * These reduce data volume significantly without losing critical debugging information.
+ */
+export declare const DEFAULT_SKIP_BODY_PATTERNS: string[];
+/**
+ * MIME types to skip body fetching by default
+ * This catches resources that may not have obvious file extensions (e.g., CSS with query params)
+ */
+export declare const DEFAULT_SKIP_BODY_MIME_TYPES: string[];
+/**
+ * Check if a URL should be excluded based on domain filtering.
+ *
+ * @param url - URL to check against exclusion list
+ * @param includeAll - If true, disables all filtering
+ * @returns True if the URL's domain matches an excluded domain
+ */
+export declare function shouldExcludeDomain(url: string, includeAll?: boolean): boolean;
+/**
+ * Check if a console message should be excluded based on type and pattern filtering
+ */
+export declare function shouldExcludeConsoleMessage(text: string, type: string, includeAll?: boolean): boolean;
+/**
+ * Simple wildcard pattern matcher.
+ * Supports only the * wildcard character.
+ *
+ * Examples:
+ *   matchesWildcard("api.json", "*.json") → true
+ *   matchesWildcard("api/users", "*api*") → true
+ *   matchesWildcard("index.html", "*.js") → false
+ *
+ * @param str - The string to test
+ * @param pattern - The pattern with * wildcards
+ * @returns True if the string matches the pattern
+ */
+export declare function matchesWildcard(str: string, pattern: string): boolean;
+/**
+ * Check if a URL matches any pattern in a list.
+ *
+ * Matches against both bare hostname and hostname+pathname to support:
+ * - Bare hostname patterns: `api.example.com` matches all requests to that host
+ * - Hostname wildcard patterns: `*analytics*` matches "analytics.google.com/collect"
+ * - Path patterns: `*\/api\/*` matches "example.com/api/users"
+ * - Combined patterns: `api.example.com\/users` matches specific endpoint
+ *
+ * @param url - The URL to check
+ * @param patterns - Array of wildcard patterns
+ * @returns True if URL matches any pattern
+ */
+/**
+ * Determine if a response body should be fetched based on URL, MIME type, and patterns.
+ *
+ * Pattern precedence (follows include-trumps-exclude rule):
+ * 1. If URL matches includePatterns → FETCH (even if it also matches excludePatterns)
+ * 2. If includePatterns specified but URL doesn't match → SKIP (whitelist mode)
+ * 3. If URL matches excludePatterns → SKIP
+ * 4. If fetchAllBodies flag is true → FETCH
+ * 5. If MIME type matches DEFAULT_SKIP_BODY_MIME_TYPES → SKIP
+ * 6. If URL matches DEFAULT_SKIP_BODY_PATTERNS → SKIP
+ * 7. Otherwise → FETCH (default behavior)
+ *
+ * @param url - The request URL
+ * @param mimeType - The response MIME type (for MIME-based skipping)
+ * @param options - Configuration options
+ * @returns True if the body should be fetched
+ */
+export declare function shouldFetchBody(url: string, mimeType: string | undefined, options?: {
+    fetchAllBodies?: boolean;
+    includePatterns?: string[];
+    excludePatterns?: string[];
+}): boolean;
+/**
+ * Determine if a network request should be excluded based on URL patterns.
+ *
+ * Pattern precedence (follows include-trumps-exclude rule):
+ * 1. If URL matches includePatterns → CAPTURE (even if it also matches excludePatterns)
+ * 2. If includePatterns specified but URL doesn't match → EXCLUDE (whitelist mode)
+ * 3. If URL matches excludePatterns → EXCLUDE
+ * 4. Otherwise → CAPTURE (default behavior)
+ *
+ * Note: This function is separate from domain filtering (shouldExcludeDomain).
+ * Both filters can be applied: domain filtering happens first, then URL pattern filtering.
+ *
+ * @param url - The request URL
+ * @param options - Configuration options
+ * @returns True if the request should be excluded
+ */
+export declare function shouldExcludeUrl(url: string, options?: {
+    includePatterns?: string[];
+    excludePatterns?: string[];
+}): boolean;
+//# sourceMappingURL=filters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../src/utils/filters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;GAGG;AACH,eAAO,MAAM,wBAAwB,UA6CpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,8BAA8B,UAAoD,CAAC;AAEhG;;GAEG;AACH,eAAO,MAAM,iCAAiC,UAS7C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,UAuCtC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,UAqBxC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,GAAE,OAAe,GAAG,OAAO,CAOrF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,OAAe,GAC1B,OAAO,CAeT;AAoDD;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAQrE;AAED;;;;;;;;;;;;GAYG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,GAAE;IACP,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,GACL,OAAO,CA8CT;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IACP,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,GACL,OAAO,CAST"}