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

package/dist/utils/filters.js

@@ -0,0 +1,304 @@
+/**
+ * Default filters for reducing noise in collected data
+ */
+import { extractHostname, extractHostnameWithPath } from './url/safeParseUrl.js';
+/**
+ * Domains to exclude by default (common tracking/analytics)
+ * These generate high volume but are rarely useful for debugging
+ */
+export const DEFAULT_EXCLUDED_DOMAINS = [
+    // Google Analytics & Ads
+    'analytics.google.com',
+    'googletagmanager.com',
+    'googleadservices.com',
+    'doubleclick.net',
+    'google-analytics.com',
+    // Microsoft/Bing
+    'clarity.ms',
+    'bat.bing.com',
+    // Social Media Tracking
+    'facebook.com',
+    'connect.facebook.net',
+    'tiktok.com',
+    'linkedin.com',
+    'twitter.com',
+    'snapchat.com',
+    // Product Analytics
+    'mixpanel.com',
+    'segment.com',
+    'segment.io',
+    'amplitude.com',
+    'heap.io',
+    // Session Recording & Heatmaps
+    'fullstory.com',
+    'hotjar.com',
+    'logrocket.com',
+    'smartlook.com',
+    // Ad Networks & Attribution
+    'exactag.com',
+    'criteo.com',
+    'adroll.com',
+    'outbrain.com',
+    'taboola.com',
+    // Other Analytics
+    'confirmit.com',
+    'newrelic.com',
+    'datadoghq.com',
+    'sentry.io',
+];
+/**
+ * Console message types to exclude by default (Redux/React DevTools noise)
+ */
+export const DEFAULT_EXCLUDED_CONSOLE_TYPES = ['startGroup', 'startGroupCollapsed', 'endGroup'];
+/**
+ * Console message patterns to exclude by default (dev server noise)
+ */
+export const DEFAULT_EXCLUDED_CONSOLE_PATTERNS = [
+    'webpack-dev-server',
+    '[HMR]',
+    '[WDS]',
+    'Download the React DevTools',
+    '@@redux', // Redux actions
+    '%c prev state', // Redux logger
+    '%c action', // Redux logger
+    '%c next state', // Redux logger
+];
+/**
+ * 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 const DEFAULT_SKIP_BODY_PATTERNS = [
+    // Images
+    '*.png',
+    '*.jpg',
+    '*.jpeg',
+    '*.gif',
+    '*.svg',
+    '*.ico',
+    '*.webp',
+    '*.bmp',
+    '*.tiff',
+    // Fonts
+    '*.woff',
+    '*.woff2',
+    '*.ttf',
+    '*.eot',
+    '*.otf',
+    // Stylesheets
+    '*.css',
+    // Source maps (can be large and rarely needed)
+    '*.map',
+    '*.js.map',
+    '*.css.map',
+    // Videos
+    '*.mp4',
+    '*.webm',
+    '*.ogg',
+    '*.avi',
+    '*.mov',
+    // Audio
+    '*.mp3',
+    '*.wav',
+    '*.flac',
+    '*.aac',
+];
+/**
+ * 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 const DEFAULT_SKIP_BODY_MIME_TYPES = [
+    'text/css',
+    'image/svg+xml',
+    'image/png',
+    'image/jpeg',
+    'image/gif',
+    'image/webp',
+    'image/avif',
+    'image/bmp',
+    'image/tiff',
+    'font/woff',
+    'font/woff2',
+    'font/ttf',
+    'font/eot',
+    'font/otf',
+    'application/font-woff',
+    'application/font-woff2',
+    'video/mp4',
+    'video/webm',
+    'audio/mpeg',
+    'audio/wav',
+];
+/**
+ * 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 function shouldExcludeDomain(url, includeAll = false) {
+    if (includeAll) {
+        return false; // Don't filter anything if --include-all flag is set
+    }
+    const hostname = extractHostname(url).toLowerCase();
+    return DEFAULT_EXCLUDED_DOMAINS.some((domain) => hostname.includes(domain.toLowerCase()));
+}
+/**
+ * Check if a console message should be excluded based on type and pattern filtering
+ */
+export function shouldExcludeConsoleMessage(text, type, includeAll = false) {
+    if (includeAll) {
+        return false; // Don't filter anything if --include-all flag is set
+    }
+    // Check if message type should be excluded (e.g., group messages)
+    if (DEFAULT_EXCLUDED_CONSOLE_TYPES.includes(type)) {
+        return true;
+    }
+    const lowerText = text.toLowerCase();
+    return DEFAULT_EXCLUDED_CONSOLE_PATTERNS.some((pattern) => lowerText.includes(pattern.toLowerCase()));
+}
+/**
+ * Evaluate whether a URL matches pattern rules using include-trumps-exclude logic.
+ *
+ * Provides centralized pattern matching with consistent precedence rules:
+ * 1. If URL matches includePatterns → true (even if it also matches excludePatterns)
+ * 2. If includePatterns specified but URL doesn't match → false (whitelist mode)
+ * 3. If URL matches excludePatterns → false
+ * 4. Otherwise → use defaultBehavior
+ *
+ * This function consolidates the URL parsing and wildcard matching logic that was
+ * previously duplicated across multiple filter functions.
+ *
+ * @param url - The URL to check against patterns
+ * @param config - Pattern matching configuration with include/exclude patterns
+ * @returns True if the URL should be included based on pattern rules
+ */
+function evaluatePatternMatch(url, config) {
+    const { includePatterns = [], excludePatterns = [], defaultBehavior = 'include' } = config;
+    // Parse URL once for all pattern checks
+    const hostname = extractHostname(url);
+    const hostnameWithPath = extractHostnameWithPath(url);
+    // Helper: check if any pattern matches hostname or hostname+path
+    const matchesAny = (patterns) => patterns.some((pattern) => matchesWildcard(hostname, pattern) || matchesWildcard(hostnameWithPath, pattern));
+    // Compute match states
+    const includeSpecified = includePatterns.length > 0;
+    const includeMatch = includeSpecified && matchesAny(includePatterns);
+    const excludeMatch = excludePatterns.length > 0 && matchesAny(excludePatterns);
+    // Decision logic: include trumps exclude, then whitelist mode, then exclude, then default
+    return includeMatch || (!includeSpecified && !excludeMatch && defaultBehavior === 'include');
+}
+/**
+ * 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 function matchesWildcard(str, pattern) {
+    // Escape special regex characters except *
+    const regexPattern = pattern
+        .replace(/[.+?^${}()|[\]\\]/g, '\\$&') // Escape special chars
+        .replace(/\*/g, '.*'); // Replace * with .*
+    const regex = new RegExp(`^${regexPattern}$`, 'i'); // Case-insensitive
+    return regex.test(str);
+}
+/**
+ * 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 function shouldFetchBody(url, mimeType, options = {}) {
+    const { fetchAllBodies = false, includePatterns = [], excludePatterns = [] } = options;
+    // If includePatterns specified, act as whitelist (trumps everything else)
+    if (includePatterns.length > 0) {
+        return evaluatePatternMatch(url, {
+            includePatterns,
+            defaultBehavior: 'exclude',
+        });
+    }
+    // If excludePatterns specified and URL matches → skip (trumps fetchAllBodies)
+    if (excludePatterns.length > 0) {
+        const matchesExclude = evaluatePatternMatch(url, {
+            includePatterns: excludePatterns,
+            defaultBehavior: 'exclude',
+        });
+        if (matchesExclude) {
+            return false;
+        }
+    }
+    // If fetchAllBodies flag is set → fetch everything
+    if (fetchAllBodies) {
+        return true;
+    }
+    // Check MIME type against default skip list (case-insensitive)
+    if (mimeType) {
+        const normalizedMimeType = mimeType.toLowerCase().split(';')[0]?.trim() ?? ''; // Remove charset etc.
+        if (normalizedMimeType &&
+            DEFAULT_SKIP_BODY_MIME_TYPES.some((skipType) => normalizedMimeType === skipType.toLowerCase())) {
+            return false;
+        }
+    }
+    // Apply default auto-skip URL patterns
+    const matchesDefaultSkip = evaluatePatternMatch(url, {
+        includePatterns: DEFAULT_SKIP_BODY_PATTERNS,
+        defaultBehavior: 'exclude',
+    });
+    // Default: fetch the body unless it matches default skip patterns
+    return !matchesDefaultSkip;
+}
+/**
+ * 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 function shouldExcludeUrl(url, options = {}) {
+    const { includePatterns = [], excludePatterns = [] } = options;
+    // Use unified pattern matching - invert result since we want exclusion logic
+    return !evaluatePatternMatch(url, {
+        includePatterns,
+        excludePatterns,
+        defaultBehavior: 'include',
+    });
+}
+//# sourceMappingURL=filters.js.map

package/dist/utils/filters.js.map

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

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

@@ -0,0 +1,23 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,35 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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/http.d.ts

@@ -0,0 +1,34 @@
+import type { CDPTarget } from '../types.js';
+/**
+ * Fetch CDP targets from Chrome's HTTP API.
+ *
+ * Uses centralized constants for host and default port to ensure consistency
+ * across all CDP target operations. This replaces duplicate HTTP endpoint logic
+ * scattered across the codebase.
+ *
+ * @param port - Chrome debugging port (defaults to centralized DEFAULT_CDP_PORT)
+ * @returns Promise resolving to array of CDP targets, or empty array on error
+ *
+ * @remarks
+ * - Uses HTTP_LOCALHOST constant for consistent host addressing
+ * - Returns empty array rather than throwing on HTTP errors for easier consumption
+ * - Network errors are silently handled - callers should validate results
+ */
+export declare function fetchCDPTargets(port?: number): Promise<CDPTarget[]>;
+/**
+ * Fetch specific CDP target by ID from Chrome's HTTP API.
+ *
+ * Convenience wrapper around fetchCDPTargets that filters for a specific target ID.
+ * Uses centralized constants and shared HTTP logic for consistency.
+ *
+ * @param targetId - Target ID to search for
+ * @param port - Chrome debugging port (defaults to centralized DEFAULT_CDP_PORT)
+ * @returns Promise resolving to matching target, or null if not found/error
+ *
+ * @remarks
+ * - Returns null rather than throwing on errors for easier consumption
+ * - Searches all targets returned by Chrome's /json/list endpoint
+ * - Uses shared fetchCDPTargets helper to avoid code duplication
+ */
+export declare function fetchCDPTargetById(targetId: string, port?: number): Promise<CDPTarget | null>;
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/utils/http.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,eAAe,CAAC,IAAI,GAAE,MAAyB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAU3F;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,MAAyB,GAC9B,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAG3B"}

package/dist/utils/http.js

@@ -0,0 +1,48 @@
+import { DEFAULT_CDP_PORT, HTTP_LOCALHOST } from '../constants.js';
+/**
+ * Fetch CDP targets from Chrome's HTTP API.
+ *
+ * Uses centralized constants for host and default port to ensure consistency
+ * across all CDP target operations. This replaces duplicate HTTP endpoint logic
+ * scattered across the codebase.
+ *
+ * @param port - Chrome debugging port (defaults to centralized DEFAULT_CDP_PORT)
+ * @returns Promise resolving to array of CDP targets, or empty array on error
+ *
+ * @remarks
+ * - Uses HTTP_LOCALHOST constant for consistent host addressing
+ * - Returns empty array rather than throwing on HTTP errors for easier consumption
+ * - Network errors are silently handled - callers should validate results
+ */
+export async function fetchCDPTargets(port = DEFAULT_CDP_PORT) {
+    try {
+        const response = await fetch(`http://${HTTP_LOCALHOST}:${port}/json/list`);
+        if (!response.ok) {
+            return [];
+        }
+        return (await response.json());
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Fetch specific CDP target by ID from Chrome's HTTP API.
+ *
+ * Convenience wrapper around fetchCDPTargets that filters for a specific target ID.
+ * Uses centralized constants and shared HTTP logic for consistency.
+ *
+ * @param targetId - Target ID to search for
+ * @param port - Chrome debugging port (defaults to centralized DEFAULT_CDP_PORT)
+ * @returns Promise resolving to matching target, or null if not found/error
+ *
+ * @remarks
+ * - Returns null rather than throwing on errors for easier consumption
+ * - Searches all targets returned by Chrome's /json/list endpoint
+ * - Uses shared fetchCDPTargets helper to avoid code duplication
+ */
+export async function fetchCDPTargetById(targetId, port = DEFAULT_CDP_PORT) {
+    const targets = await fetchCDPTargets(port);
+    return targets.find((t) => t.id === targetId) ?? null;
+}
+//# sourceMappingURL=http.js.map

package/dist/utils/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/utils/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG/D;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAe,gBAAgB;IACnE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,UAAU,cAAc,IAAI,IAAI,YAAY,CAAC,CAAC;QAC3E,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAgB,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAgB,EAChB,OAAe,gBAAgB;IAE/B,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,IAAI,IAAI,CAAC;AACxD,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Logging utilities for consistent formatted output.
+ *
+ * WHY: Centralizes log formatting to avoid repetitive `console.error('[component] message')` patterns.
+ */
+/**
+ * Log contexts for different components.
+ * Used to prefix log messages with component name.
+ */
+export type LogContext = 'bdg' | 'launcher' | 'daemon' | 'worker' | 'client' | 'cleanup' | 'session' | 'chrome' | 'cdp' | 'ipc';
+/**
+ * Create a logger function for a specific context.
+ *
+ * WHY: Provides consistent log formatting with context prefix.
+ *
+ * @param context - Component context for log prefix
+ * @returns Logger function that prefixes messages with context
+ *
+ * @example
+ * ```typescript
+ * const log = createLogger('cleanup');
+ * log('Removed stale daemon socket');
+ * // Output: [cleanup] Removed stale daemon socket
+ * ```
+ */
+export declare function createLogger(context: LogContext): (message: string) => void;
+/**
+ * Log a message with a specific context (one-off usage).
+ *
+ * WHY: Convenient for single log statements without creating a logger function.
+ *
+ * @param context - Component context for log prefix
+ * @param message - Log message
+ *
+ * @example
+ * ```typescript
+ * log('cleanup', 'Removed stale daemon socket');
+ * // Output: [cleanup] Removed stale daemon socket
+ * ```
+ */
+export declare function log(context: LogContext, message: string): void;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,MAAM,UAAU,GAClB,KAAK,GACL,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,SAAS,GACT,QAAQ,GACR,KAAK,GACL,KAAK,CAAC;AAEV;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAI3E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE9D"}

package/dist/utils/logger.js

@@ -0,0 +1,43 @@
+/**
+ * Logging utilities for consistent formatted output.
+ *
+ * WHY: Centralizes log formatting to avoid repetitive `console.error('[component] message')` patterns.
+ */
+/**
+ * Create a logger function for a specific context.
+ *
+ * WHY: Provides consistent log formatting with context prefix.
+ *
+ * @param context - Component context for log prefix
+ * @returns Logger function that prefixes messages with context
+ *
+ * @example
+ * ```typescript
+ * const log = createLogger('cleanup');
+ * log('Removed stale daemon socket');
+ * // Output: [cleanup] Removed stale daemon socket
+ * ```
+ */
+export function createLogger(context) {
+    return (message) => {
+        console.error(`[${context}] ${message}`);
+    };
+}
+/**
+ * Log a message with a specific context (one-off usage).
+ *
+ * WHY: Convenient for single log statements without creating a logger function.
+ *
+ * @param context - Component context for log prefix
+ * @param message - Log message
+ *
+ * @example
+ * ```typescript
+ * log('cleanup', 'Removed stale daemon socket');
+ * // Output: [cleanup] Removed stale daemon socket
+ * ```
+ */
+export function log(context, message) {
+    console.error(`[${context}] ${message}`);
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,YAAY,CAAC,OAAmB;IAC9C,OAAO,CAAC,OAAe,EAAE,EAAE;QACzB,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,GAAG,CAAC,OAAmB,EAAE,OAAe;IACtD,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC,CAAC;AAC3C,CAAC"}

package/dist/utils/objects.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Filter out undefined values from an object, returning only defined properties.
+ *
+ * This utility removes properties with undefined values from an object, which is
+ * useful for building configuration objects where undefined values should be
+ * completely omitted rather than passed as undefined. Common use cases include
+ * API payloads, configuration merging, and type-safe object construction.
+ *
+ * @param obj - Object with potentially undefined values
+ * @returns New object with only defined values, no undefined properties
+ *
+ * @example
+ * ```typescript
+ * const config = filterDefined({
+ *   name: 'test',
+ *   value: undefined,
+ *   count: 0
+ * });
+ * // Result: { name: 'test', count: 0 }
+ * ```
+ */
+export declare function filterDefined<T extends Record<string, unknown>>(obj: T): Record<string, unknown>;
+//# sourceMappingURL=objects.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"objects.d.ts","sourceRoot":"","sources":["../../src/utils/objects.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEhG"}

package/dist/utils/objects.js

@@ -0,0 +1,25 @@
+/**
+ * Filter out undefined values from an object, returning only defined properties.
+ *
+ * This utility removes properties with undefined values from an object, which is
+ * useful for building configuration objects where undefined values should be
+ * completely omitted rather than passed as undefined. Common use cases include
+ * API payloads, configuration merging, and type-safe object construction.
+ *
+ * @param obj - Object with potentially undefined values
+ * @returns New object with only defined values, no undefined properties
+ *
+ * @example
+ * ```typescript
+ * const config = filterDefined({
+ *   name: 'test',
+ *   value: undefined,
+ *   count: 0
+ * });
+ * // Result: { name: 'test', count: 0 }
+ * ```
+ */
+export function filterDefined(obj) {
+    return Object.fromEntries(Object.entries(obj).filter(([, value]) => value !== undefined));
+}
+//# sourceMappingURL=objects.js.map

package/dist/utils/objects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects.js","sourceRoot":"","sources":["../../src/utils/objects.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,aAAa,CAAoC,GAAM;IACrE,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC;AAC5F,CAAC"}