browser-debugger-cli 0.5.1 → 0.6.1

package/dist/session/BdgSession.js

@@ -1,230 +0,0 @@
-import { startConsoleCollection } from '../collectors/console.js';
-import { prepareDOMCollection, collectDOM } from '../collectors/dom.js';
-import { startNetworkCollection } from '../collectors/network.js';
-import { CDPConnection } from '../connection/cdp.js';
-import { validateTarget } from '../connection/finder.js';
-import { VERSION } from '../utils/version.js';
-/**
- * Manages a browser debugging session.
- *
- * Encapsulates the lifecycle of collecting telemetry from a browser tab:
- * - CDP connection management
- * - Collector initialization and cleanup
- * - Data aggregation
- * - Graceful shutdown with final snapshot
- */
-export class BdgSession {
-    target;
-    port;
-    cdp;
-    collectors = new Map();
-    startTime;
-    isActive = false;
-    networkRequests = [];
-    consoleLogs = [];
-    activeCollectors = [];
-    sessionOptions;
-    constructor(target, port, options = {}) {
-        this.target = target;
-        this.port = port;
-        this.cdp = new CDPConnection();
-        this.startTime = Date.now();
-        this.sessionOptions = options;
-    }
-    async connect() {
-        // Connect with retry and keepalive (no auto-reconnect for CLI use)
-        await this.cdp.connect(this.target.webSocketDebuggerUrl, {
-            maxRetries: 3,
-            autoReconnect: false,
-            keepaliveInterval: 30000,
-        });
-        // Validate target still exists
-        const targetExists = await validateTarget(this.target.id, this.port);
-        if (!targetExists) {
-            this.cdp.close();
-            throw new Error('Target tab closed during connection');
-        }
-        // Enable Target domain to receive targetDestroyed events
-        await this.cdp.send('Target.setDiscoverTargets', { discover: true });
-        this.isActive = true;
-    }
-    /**
-     * Start a specific data collector.
-     *
-     * @param type - Type of collector to start ('dom', 'network', or 'console')
-     * @throws Error if session is not active
-     */
-    async startCollector(type) {
-        if (!this.isActive) {
-            throw new Error('Session not active');
-        }
-        this.activeCollectors.push(type);
-        let cleanup;
-        switch (type) {
-            case 'network': {
-                const networkOptions = {};
-                if (this.sessionOptions.includeAll !== undefined) {
-                    networkOptions.includeAll = this.sessionOptions.includeAll;
-                }
-                if (this.sessionOptions.fetchAllBodies !== undefined) {
-                    networkOptions.fetchAllBodies = this.sessionOptions.fetchAllBodies;
-                }
-                if (this.sessionOptions.fetchBodiesInclude !== undefined) {
-                    networkOptions.fetchBodiesInclude = this.sessionOptions.fetchBodiesInclude;
-                }
-                if (this.sessionOptions.fetchBodiesExclude !== undefined) {
-                    networkOptions.fetchBodiesExclude = this.sessionOptions.fetchBodiesExclude;
-                }
-                if (this.sessionOptions.networkInclude !== undefined) {
-                    networkOptions.networkInclude = this.sessionOptions.networkInclude;
-                }
-                if (this.sessionOptions.networkExclude !== undefined) {
-                    networkOptions.networkExclude = this.sessionOptions.networkExclude;
-                }
-                cleanup = await startNetworkCollection(this.cdp, this.networkRequests, networkOptions);
-                break;
-            }
-            case 'console':
-                cleanup = await startConsoleCollection(this.cdp, this.consoleLogs, this.sessionOptions.includeAll ?? false);
-                break;
-            case 'dom':
-                cleanup = await prepareDOMCollection(this.cdp);
-                break;
-        }
-        this.collectors.set(type, cleanup);
-    }
-    /**
-     * Stop the session and return collected telemetry.
-     *
-     * Captures final DOM snapshot, aggregates all collected data,
-     * and performs cleanup of CDP connection and collectors.
-     *
-     * @returns Complete telemetry output with success/error status
-     * @throws Error if session is not active
-     */
-    async stop() {
-        if (!this.isActive) {
-            throw new Error('Session not active');
-        }
-        console.error('Capturing final state...');
-        // Attempt to capture DOM if it's an active collector
-        let domData;
-        if (this.activeCollectors.includes('dom')) {
-            try {
-                console.error('Capturing DOM snapshot...');
-                domData = await collectDOM(this.cdp);
-                console.error('DOM snapshot captured successfully');
-            }
-            catch (domError) {
-                // Chrome may be closing during shutdown, ignore DOM capture failures
-                console.error('Warning: DOM capture failed (Chrome may be closing):', domError instanceof Error ? domError.message : String(domError));
-            }
-        }
-        // Build output (even if DOM capture failed)
-        const output = {
-            version: VERSION,
-            success: true,
-            timestamp: new Date().toISOString(),
-            duration: Date.now() - this.startTime,
-            target: {
-                url: domData?.url ?? this.target.url,
-                title: domData?.title ?? this.target.title,
-            },
-            data: {},
-        };
-        // Add collected data
-        if (this.activeCollectors.includes('dom') && domData) {
-            output.data.dom = domData;
-        }
-        if (this.activeCollectors.includes('network')) {
-            output.data.network = this.networkRequests;
-        }
-        if (this.activeCollectors.includes('console')) {
-            output.data.console = this.consoleLogs;
-        }
-        // Clean up collectors (skip CDP domain disabling during shutdown to avoid hanging)
-        try {
-            console.error('Cleaning up session...');
-            // Call cleanup functions for all collectors
-            this.collectors.forEach((cleanup) => cleanup());
-            this.collectors.clear();
-            // Skip disabling CDP domains - Chrome may be dead during SIGINT shutdown
-            // Just close the connection and mark as inactive
-            try {
-                this.cdp.close();
-            }
-            catch {
-                // Ignore close errors
-            }
-            this.isActive = false;
-            console.error('Session cleanup complete');
-        }
-        catch (cleanupError) {
-            console.error('Warning: Cleanup error:', cleanupError instanceof Error ? cleanupError.message : String(cleanupError));
-        }
-        return output;
-    }
-    /**
-     * Check if the session is active and connected.
-     *
-     * @returns True if session is active and CDP connection is open
-     */
-    isConnected() {
-        return this.isActive && this.cdp.isConnected();
-    }
-    /**
-     * Get the CDP target information for this session.
-     *
-     * @returns Target information (URL, title, ID, etc.)
-     */
-    getTarget() {
-        return this.target;
-    }
-    /**
-     * Get the CDP connection instance.
-     *
-     * Useful for registering additional event handlers or sending custom commands.
-     *
-     * @returns CDP connection instance
-     */
-    getCDP() {
-        return this.cdp;
-    }
-    /**
-     * Get collected network requests.
-     *
-     * Useful for live preview of collected data without stopping the session.
-     *
-     * @returns Array of network requests collected so far
-     */
-    getNetworkRequests() {
-        return this.networkRequests;
-    }
-    /**
-     * Get collected console messages.
-     *
-     * Useful for live preview of collected data without stopping the session.
-     *
-     * @returns Array of console messages collected so far
-     */
-    getConsoleLogs() {
-        return this.consoleLogs;
-    }
-    /**
-     * Get session start time.
-     *
-     * @returns Timestamp when session was created
-     */
-    getStartTime() {
-        return this.startTime;
-    }
-    /**
-     * Get list of active collectors.
-     *
-     * @returns Array of collector types that are currently active
-     */
-    getActiveCollectors() {
-        return this.activeCollectors;
-    }
-}
-//# sourceMappingURL=BdgSession.js.map

package/dist/session/BdgSession.js.map

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

package/dist/session/fileOps.d.ts

@@ -1,25 +0,0 @@
-/**
- * File operation utilities for session management.
- *
- * Provides safe file operations with consistent error handling and logging.
- */
-import type { Logger } from '../ui/logging/index.js';
-/**
- * Safely delete a file if it exists.
- *
- * Handles missing files and errors gracefully with consistent logging.
- *
- * @param path - File path to delete
- * @param label - Human-readable label for logging
- * @param log - Logger instance
- * @returns True if file was deleted, false if it didn't exist or error occurred
- *
- * @example
- * ```typescript
- * const log = createLogger('session');
- * safeDeleteFile('/path/to/file.txt', 'config file', log);
- * // Logs: "Removed config file" or "Failed to remove config file: <error>"
- * ```
- */
-export declare function safeDeleteFile(path: string, label: string, log: Logger): boolean;
-//# sourceMappingURL=fileOps.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"fileOps.d.ts","sourceRoot":"","sources":["../../src/session/fileOps.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAahF"}

package/dist/session/fileOps.js

@@ -1,39 +0,0 @@
-/**
- * File operation utilities for session management.
- *
- * Provides safe file operations with consistent error handling and logging.
- */
-import * as fs from 'fs';
-import { getErrorMessage } from '../ui/errors/index.js';
-/**
- * Safely delete a file if it exists.
- *
- * Handles missing files and errors gracefully with consistent logging.
- *
- * @param path - File path to delete
- * @param label - Human-readable label for logging
- * @param log - Logger instance
- * @returns True if file was deleted, false if it didn't exist or error occurred
- *
- * @example
- * ```typescript
- * const log = createLogger('session');
- * safeDeleteFile('/path/to/file.txt', 'config file', log);
- * // Logs: "Removed config file" or "Failed to remove config file: <error>"
- * ```
- */
-export function safeDeleteFile(path, label, log) {
-    if (!fs.existsSync(path)) {
-        return false;
-    }
-    try {
-        fs.unlinkSync(path);
-        log(`Removed ${label}`);
-        return true;
-    }
-    catch (error) {
-        log(`Failed to remove ${label}: ${getErrorMessage(error)}`);
-        return false;
-    }
-}
-//# sourceMappingURL=fileOps.js.map

package/dist/session/fileOps.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fileOps.js","sourceRoot":"","sources":["../../src/session/fileOps.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,KAAa,EAAE,GAAW;IACrE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACpB,GAAG,CAAC,WAAW,KAAK,EAAE,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,oBAAoB,KAAK,KAAK,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC5D,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/session/queryCache.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=queryCache.d.ts.map

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

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

@@ -1,66 +0,0 @@
-import fs from 'fs';
-import { getDomQueryCachePath } from '../session/paths.js';
-import { getErrorMessage } from '../ui/errors/index.js';
-import { domCacheWriteWarning } from '../ui/messages/internal.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(domCacheWriteWarning(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=queryCache.js.map

package/dist/session/queryCache.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"queryCache.js","sourceRoot":"","sources":["../../src/session/queryCache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAmBjE;;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,oBAAoB,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9D,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/ui/errors/SystemErrors.d.ts

@@ -1,22 +0,0 @@
-/**
- * Legacy system error classes (deprecated).
- *
- * This file will be removed. Domain errors have been moved to their respective modules.
- * Use connection/errors.ts for CDP and Chrome errors.
- */
-/**
- * Base error class for all bdg system errors (legacy).
- *
- * No longer used. Domain modules define their own error base classes.
- *
- * Extends native Error with error codes for programmatic handling,
- * category for filtering, exit codes for semantic exit codes,
- * and 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);
-}
-//# sourceMappingURL=SystemErrors.d.ts.map

package/dist/ui/errors/SystemErrors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SystemErrors.d.ts","sourceRoot":"","sources":["../../../src/ui/errors/SystemErrors.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"}

package/dist/ui/errors/SystemErrors.js

@@ -1,23 +0,0 @@
-/**
- * Legacy system error classes (deprecated).
- *
- * This file will be removed. Domain errors have been moved to their respective modules.
- * Use connection/errors.ts for CDP and Chrome errors.
- */
-/**
- * Base error class for all bdg system errors (legacy).
- *
- * No longer used. Domain modules define their own error base classes.
- *
- * Extends native Error with error codes for programmatic handling,
- * category for filtering, exit codes for semantic exit codes,
- * and cause chaining for nested errors.
- */
-export class BdgError extends Error {
-    constructor(message, cause) {
-        super(message);
-        this.name = this.constructor.name;
-        this.cause = cause;
-    }
-}
-//# sourceMappingURL=SystemErrors.js.map

package/dist/ui/errors/SystemErrors.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SystemErrors.js","sourceRoot":"","sources":["../../../src/ui/errors/SystemErrors.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"}

package/dist/ui/errors.d.ts

@@ -1,39 +0,0 @@
-/**
- * Structured error handling for CLI commands.
- *
- * Provides CommandError class for throwing errors with metadata and exit codes.
- */
-/**
- * Custom error class for CLI commands with structured metadata.
- *
- * Extends Error to include additional context like suggestions, notes,
- * and specific exit codes for better user experience and automation support.
- *
- * @example
- * ```typescript
- * throw new CommandError(
- *   'Session not found',
- *   { suggestion: 'Start a session with: bdg <url>' },
- *   EXIT_CODES.RESOURCE_NOT_FOUND
- * );
- * ```
- */
-export declare class CommandError extends Error {
-    /**
-     * Additional context for the error (suggestions, notes, etc.)
-     */
-    readonly metadata: Record<string, string>;
-    /**
-     * Specific exit code for this error
-     */
-    readonly exitCode: number;
-    /**
-     * Create a new CommandError
-     *
-     * @param message - Main error message
-     * @param metadata - Additional context (suggestions, notes, etc.)
-     * @param exitCode - Exit code to use when this error occurs
-     */
-    constructor(message: string, metadata?: Record<string, string>, exitCode?: number);
-}
-//# sourceMappingURL=errors.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/ui/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;GAcG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC;;OAEG;IACH,SAAgB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjD;;OAEG;IACH,SAAgB,QAAQ,EAAE,MAAM,CAAC;IAEjC;;;;;;OAMG;gBACS,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EAAE,QAAQ,GAAE,MAAU;CAWzF"}

package/dist/ui/errors.js

@@ -1,48 +0,0 @@
-/**
- * Structured error handling for CLI commands.
- *
- * Provides CommandError class for throwing errors with metadata and exit codes.
- */
-/**
- * Custom error class for CLI commands with structured metadata.
- *
- * Extends Error to include additional context like suggestions, notes,
- * and specific exit codes for better user experience and automation support.
- *
- * @example
- * ```typescript
- * throw new CommandError(
- *   'Session not found',
- *   { suggestion: 'Start a session with: bdg <url>' },
- *   EXIT_CODES.RESOURCE_NOT_FOUND
- * );
- * ```
- */
-export class CommandError extends Error {
-    /**
-     * Additional context for the error (suggestions, notes, etc.)
-     */
-    metadata;
-    /**
-     * Specific exit code for this error
-     */
-    exitCode;
-    /**
-     * Create a new CommandError
-     *
-     * @param message - Main error message
-     * @param metadata - Additional context (suggestions, notes, etc.)
-     * @param exitCode - Exit code to use when this error occurs
-     */
-    constructor(message, metadata = {}, exitCode = 1) {
-        super(message);
-        this.name = 'CommandError';
-        this.metadata = metadata;
-        this.exitCode = exitCode;
-        // Maintains proper stack trace for where our error was thrown
-        if (Error.captureStackTrace) {
-            Error.captureStackTrace(this, CommandError);
-        }
-    }
-}
-//# sourceMappingURL=errors.js.map

package/dist/ui/errors.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/ui/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC;;OAEG;IACa,QAAQ,CAAyB;IAEjD;;OAEG;IACa,QAAQ,CAAS;IAEjC;;;;;;OAMG;IACH,YAAY,OAAe,EAAE,WAAmC,EAAE,EAAE,WAAmB,CAAC;QACtF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAEzB,8DAA8D;QAC9D,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;CACF"}

package/dist/ui/messages/deprecation.d.ts

@@ -1,30 +0,0 @@
-/**
- * Deprecation warning messages
- *
- * Messages for deprecated flags and features that will be removed in future versions.
- */
-/**
- * Generate deprecation warning for peek --follow flag.
- *
- * @returns Formatted deprecation warning message
- *
- * @example
- * ```typescript
- * console.error(peekFollowDeprecationWarning());
- * // Output: "⚠️  Deprecation Warning: The --follow flag will be removed in v1.0"
- * ```
- */
-export declare function peekFollowDeprecationWarning(): string;
-/**
- * Generate deprecation warning for stop --kill-chrome flag.
- *
- * @returns Formatted deprecation warning message
- *
- * @example
- * ```typescript
- * console.error(stopKillChromeDeprecationWarning());
- * // Output: "⚠️  Deprecation Warning: The --kill-chrome flag will be removed in v1.0"
- * ```
- */
-export declare function stopKillChromeDeprecationWarning(): string;
-//# sourceMappingURL=deprecation.d.ts.map

package/dist/ui/messages/deprecation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"deprecation.d.ts","sourceRoot":"","sources":["../../../src/ui/messages/deprecation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAQrD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gCAAgC,IAAI,MAAM,CAQzD"}

package/dist/ui/messages/deprecation.js

@@ -1,49 +0,0 @@
-/**
- * Deprecation warning messages
- *
- * Messages for deprecated flags and features that will be removed in future versions.
- */
-// ============================================================================
-// Deprecation Warnings
-// ============================================================================
-/**
- * Generate deprecation warning for peek --follow flag.
- *
- * @returns Formatted deprecation warning message
- *
- * @example
- * ```typescript
- * console.error(peekFollowDeprecationWarning());
- * // Output: "⚠️  Deprecation Warning: The --follow flag will be removed in v1.0"
- * ```
- */
-export function peekFollowDeprecationWarning() {
-    const lines = [];
-    lines.push('');
-    lines.push('⚠️  Deprecation Warning:');
-    lines.push('   The --follow flag is deprecated and will be removed in v1.0');
-    lines.push('   Please use: bdg tail');
-    lines.push('');
-    return lines.join('\n');
-}
-/**
- * Generate deprecation warning for stop --kill-chrome flag.
- *
- * @returns Formatted deprecation warning message
- *
- * @example
- * ```typescript
- * console.error(stopKillChromeDeprecationWarning());
- * // Output: "⚠️  Deprecation Warning: The --kill-chrome flag will be removed in v1.0"
- * ```
- */
-export function stopKillChromeDeprecationWarning() {
-    const lines = [];
-    lines.push('');
-    lines.push('⚠️  Deprecation Warning:');
-    lines.push('   The --kill-chrome flag is deprecated and will be removed in v1.0');
-    lines.push('   Please use: bdg stop && bdg cleanup --aggressive');
-    lines.push('');
-    return lines.join('\n');
-}
-//# sourceMappingURL=deprecation.js.map

package/dist/ui/messages/deprecation.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"deprecation.js","sourceRoot":"","sources":["../../../src/ui/messages/deprecation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,4BAA4B;IAC1C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IAC7E,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gCAAgC;IAC9C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;IAClF,KAAK,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;IAClE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}