browser-debugger-cli 0.6.7 → 0.6.9

package/dist/commands/network/har.js

@@ -0,0 +1,97 @@
+/**
+ * HAR export command for network data.
+ *
+ * Exports collected network requests to HAR 1.2 format.
+ * Supports filtering with DevTools-compatible DSL.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { Option } from 'commander';
+import { runCommand } from '../../commands/shared/CommandRunner.js';
+import { jsonOption } from '../../commands/shared/commonOptions.js';
+import { getSessionFilePath } from '../../session/paths.js';
+import { applyFilters, parseFilterString, validateFilterString } from '../../telemetry/filterDsl.js';
+import { buildHAR } from '../../telemetry/har/builder.js';
+import { CommandError } from '../../ui/errors/index.js';
+import { AtomicFileWriter } from '../../utils/atomicFile.js';
+import { EXIT_CODES } from '../../utils/exitCodes.js';
+import { VERSION } from '../../utils/version.js';
+import { getNetworkRequests } from './shared.js';
+/**
+ * Generate timestamped filename for HAR export in ~/.bdg/ directory.
+ *
+ * @returns Full path to HAR file in ~/.bdg/capture-YYYY-MM-DD-HHMMSS.har
+ */
+function generateHARFilename() {
+    const now = new Date();
+    const year = now.getFullYear();
+    const month = String(now.getMonth() + 1).padStart(2, '0');
+    const day = String(now.getDate()).padStart(2, '0');
+    const hours = String(now.getHours()).padStart(2, '0');
+    const minutes = String(now.getMinutes()).padStart(2, '0');
+    const seconds = String(now.getSeconds()).padStart(2, '0');
+    const filename = `capture-${year}-${month}-${day}-${hours}${minutes}${seconds}.har`;
+    const sessionDir = path.dirname(getSessionFilePath('OUTPUT'));
+    return path.join(sessionDir, filename);
+}
+/**
+ * Format HAR export success message for human output.
+ *
+ * @param data - HAR export result data
+ * @returns Formatted success message
+ */
+function formatHARExport(data) {
+    const filterNote = data.filtered ? ' (filtered)' : '';
+    return `✓ Exported ${data.entries} requests${filterNote} to ${data.file}`;
+}
+/**
+ * Option for filter DSL.
+ */
+const filterDslOption = new Option('--filter <dsl>', 'Filter requests using DevTools DSL (e.g., "status-code:>=400")');
+/**
+ * Register HAR export command.
+ *
+ * @param networkCmd - Network parent command
+ */
+export function registerHarCommand(networkCmd) {
+    networkCmd
+        .command('har [output-file]')
+        .description('Export network data as HAR 1.2 format')
+        .addOption(jsonOption())
+        .addOption(filterDslOption)
+        .action(async (outputFile, options) => {
+        await runCommand(async () => {
+            let requests = await getNetworkRequests();
+            let filtered = false;
+            if (options.filter) {
+                const validation = validateFilterString(options.filter);
+                if (!validation.valid) {
+                    const metadata = validation.suggestion ? { suggestion: validation.suggestion } : {};
+                    throw new CommandError(validation.error, metadata, EXIT_CODES.INVALID_ARGUMENTS);
+                }
+                const filters = parseFilterString(options.filter);
+                const originalCount = requests.length;
+                requests = applyFilters(requests, filters);
+                filtered = requests.length !== originalCount;
+            }
+            const outputPath = outputFile ?? generateHARFilename();
+            const dir = path.dirname(outputPath);
+            if (dir !== '.' && !fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            const har = buildHAR(requests, {
+                version: VERSION,
+            });
+            await AtomicFileWriter.writeAsync(outputPath, JSON.stringify(har, null, 2));
+            return {
+                success: true,
+                data: {
+                    file: outputPath,
+                    entries: har.log.entries.length,
+                    filtered,
+                },
+            };
+        }, options, formatHARExport);
+    });
+}
+//# sourceMappingURL=har.js.map

package/dist/commands/network/har.js.map

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

package/dist/commands/network/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Network command group registration.
+ *
+ * Provides commands for inspecting and exporting network data:
+ * - list: List requests with DevTools-compatible filtering
+ * - har: Export to HAR 1.2 format
+ * - getCookies: List cookies
+ * - headers: Show HTTP headers
+ * - document: Show main document headers
+ */
+import type { Command } from 'commander';
+/**
+ * Register all network subcommands.
+ *
+ * @param program - Commander.js Command instance to register commands on
+ */
+export declare function registerNetworkCommands(program: Command): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/network/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/network/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAQ9D"}

package/dist/commands/network/index.js

@@ -0,0 +1,27 @@
+/**
+ * Network command group registration.
+ *
+ * Provides commands for inspecting and exporting network data:
+ * - list: List requests with DevTools-compatible filtering
+ * - har: Export to HAR 1.2 format
+ * - getCookies: List cookies
+ * - headers: Show HTTP headers
+ * - document: Show main document headers
+ */
+import { registerHarCommand } from './har.js';
+import { registerListCommand } from './list.js';
+import { registerGetCookiesCommand, registerHeadersCommand, registerDocumentCommand, } from './shared.js';
+/**
+ * Register all network subcommands.
+ *
+ * @param program - Commander.js Command instance to register commands on
+ */
+export function registerNetworkCommands(program) {
+    const networkCmd = program.command('network').description('Inspect network state and resources');
+    registerListCommand(networkCmd);
+    registerHarCommand(networkCmd);
+    registerGetCookiesCommand(networkCmd);
+    registerHeadersCommand(networkCmd);
+    registerDocumentCommand(networkCmd);
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/network/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/network/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,qCAAqC,CAAC,CAAC;IAEjG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAChC,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC/B,yBAAyB,CAAC,UAAU,CAAC,CAAC;IACtC,sBAAsB,CAAC,UAAU,CAAC,CAAC;IACnC,uBAAuB,CAAC,UAAU,CAAC,CAAC;AACtC,CAAC"}

package/dist/commands/network/list.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Network list command with DevTools-compatible filter DSL.
+ *
+ * Provides powerful filtering capabilities for network requests including
+ * status codes, domains, HTTP methods, MIME types, size thresholds, and more.
+ */
+import { type Command } from 'commander';
+/**
+ * Register network list command.
+ *
+ * @param networkCmd - Network parent command
+ */
+export declare function registerListCommand(networkCmd: Command): void;
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/network/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/network/list.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAoUjD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI,CAY7D"}

package/dist/commands/network/list.js

@@ -0,0 +1,273 @@
+/**
+ * Network list command with DevTools-compatible filter DSL.
+ *
+ * Provides powerful filtering capabilities for network requests including
+ * status codes, domains, HTTP methods, MIME types, size thresholds, and more.
+ */
+import { Option } from 'commander';
+import { jsonOption } from '../../commands/shared/commonOptions.js';
+import { handleDaemonConnectionError } from '../../commands/shared/daemonErrorHandler.js';
+import { getErrorMessage } from '../../connection/errors.js';
+import { getPeek } from '../../ipc/client.js';
+import { validateIPCResponse } from '../../ipc/index.js';
+import { applyFilters, getFilterHelpText, validateFilterString } from '../../telemetry/filterDsl.js';
+import { resolvePreset, FILTER_PRESETS } from '../../telemetry/filterPresets.js';
+import { CommandError } from '../../ui/errors/index.js';
+import { formatNetworkList } from '../../ui/formatters/networkList.js';
+import { followingNetworkMessage, noNetworkDataMessage, stoppedFollowingNetworkMessage, } from '../../ui/messages/networkMessages.js';
+import { invalidLastRangeError } from '../../ui/messages/validation.js';
+import { getExitCodeForConnectionError } from '../../utils/errorMapping.js';
+import { EXIT_CODES } from '../../utils/exitCodes.js';
+const MIN_LAST_ITEMS = 0;
+const MAX_LAST_ITEMS = 10000;
+const DEFAULT_LAST_ITEMS = 100;
+const FOLLOW_MODE_LIMIT = 50;
+const FOLLOW_INTERVAL_MS = 1000;
+const networkLastOption = new Option('--last <n>', `Show last N requests (0 = all, default: ${DEFAULT_LAST_ITEMS})`)
+    .default(DEFAULT_LAST_ITEMS)
+    .argParser(parseLastOption);
+const filterDslOption = new Option('--filter <dsl>', 'Filter requests using DevTools DSL (e.g., "status-code:>=400 domain:api.*")');
+const presetOption = new Option('--preset <name>', 'Use predefined filter preset').choices(Object.keys(FILTER_PRESETS));
+const followOption = new Option('-f, --follow', 'Stream network requests in real-time').default(false);
+const verboseOption = new Option('-v, --verbose', 'Show full URLs and additional details').default(false);
+/**
+ * Parse and validate --last option value.
+ */
+function parseLastOption(val) {
+    const n = parseInt(val, 10);
+    if (isNaN(n) || n < MIN_LAST_ITEMS || n > MAX_LAST_ITEMS) {
+        throw new CommandError(invalidLastRangeError(MIN_LAST_ITEMS, MAX_LAST_ITEMS), {}, EXIT_CODES.INVALID_ARGUMENTS);
+    }
+    return n;
+}
+/**
+ * Build combined filter string from preset and explicit filter.
+ */
+function buildFilterString(options) {
+    const explicit = options.filter ?? '';
+    if (!options.preset)
+        return explicit;
+    const presetFilter = resolvePreset(options.preset);
+    return explicit ? `${presetFilter} ${explicit}` : presetFilter;
+}
+/**
+ * Validate filter syntax and throw CommandError if invalid.
+ */
+function validateFilterOptions(options) {
+    const filterString = buildFilterString(options);
+    if (!filterString)
+        return;
+    const validation = validateFilterString(filterString);
+    if (validation.valid)
+        return;
+    const metadata = validation.suggestion ? { suggestion: validation.suggestion } : {};
+    throw new CommandError(validation.error, metadata, EXIT_CODES.INVALID_ARGUMENTS);
+}
+/**
+ * Apply filters to requests array.
+ */
+function filterRequests(requests, options) {
+    const filterString = buildFilterString(options);
+    if (!filterString)
+        return requests;
+    const validation = validateFilterString(filterString);
+    return validation.valid ? applyFilters(requests, validation.filters) : requests;
+}
+/**
+ * Handle empty network data response.
+ */
+function handleEmptyNetworkData(options) {
+    if (options.json) {
+        console.log(JSON.stringify({ success: true, data: [], count: 0 }));
+    }
+    else {
+        console.log(noNetworkDataMessage());
+    }
+    process.exit(EXIT_CODES.SUCCESS);
+}
+/**
+ * Handle IPC validation error with daemon error handler.
+ */
+function handleValidationError(error, options) {
+    const errorMsg = getErrorMessage(error);
+    const exitCode = getExitCodeForConnectionError(errorMsg);
+    const result = handleDaemonConnectionError(errorMsg, {
+        json: options.json,
+        follow: options.follow,
+        retryIntervalMs: FOLLOW_INTERVAL_MS,
+        exitCode,
+    });
+    if (result.shouldExit) {
+        process.exit(result.exitCode);
+    }
+    return false;
+}
+/**
+ * Handle daemon connection failure.
+ */
+function handleConnectionFailure(options) {
+    const result = handleDaemonConnectionError('Daemon not running', {
+        json: options.json,
+        follow: options.follow,
+        retryIntervalMs: FOLLOW_INTERVAL_MS,
+    });
+    if (result.shouldExit) {
+        process.exit(result.exitCode);
+    }
+    return null;
+}
+/**
+ * Fetch network requests from the daemon.
+ */
+async function fetchNetworkRequests(options) {
+    try {
+        const response = await getPeek();
+        try {
+            validateIPCResponse(response);
+        }
+        catch (validationError) {
+            handleValidationError(validationError, options);
+            return null;
+        }
+        const output = response.data?.preview;
+        if (!output?.data.network) {
+            handleEmptyNetworkData(options);
+        }
+        return output.data.network;
+    }
+    catch {
+        return handleConnectionFailure(options);
+    }
+}
+/**
+ * Build format options for display functions.
+ */
+function buildFormatOptions(options, totalCount, lastLimit, follow = false) {
+    return {
+        json: options.json ?? false,
+        verbose: options.verbose ?? false,
+        last: lastLimit,
+        totalCount,
+        follow,
+    };
+}
+/**
+ * Display network requests in standard mode.
+ */
+function displayNetworkList(requests, options) {
+    const lastCount = options.last ?? DEFAULT_LAST_ITEMS;
+    const displayRequests = lastCount === 0 ? requests : requests.slice(-lastCount);
+    const formatOptions = buildFormatOptions(options, requests.length, lastCount);
+    console.log(formatNetworkList(displayRequests, formatOptions));
+}
+/**
+ * Display network requests in follow/streaming mode.
+ */
+function displayNetworkStreaming(requests, options) {
+    const displayRequests = requests.slice(-FOLLOW_MODE_LIMIT);
+    const formatOptions = buildFormatOptions(options, requests.length, FOLLOW_MODE_LIMIT, true);
+    console.clear();
+    console.log(formatNetworkList(displayRequests, formatOptions));
+}
+/**
+ * Handle CommandError with appropriate output format.
+ */
+function handleCommandError(error, json) {
+    if (json) {
+        console.log(JSON.stringify({ success: false, error: error.message }));
+    }
+    else {
+        console.error(error.message);
+        if (error.metadata?.suggestion) {
+            console.error(error.metadata.suggestion);
+        }
+    }
+    process.exit(error.exitCode);
+}
+/**
+ * Process and display filtered network requests.
+ */
+async function processNetworkRequests(options, displayFn) {
+    const requests = await fetchNetworkRequests(options);
+    if (!requests)
+        return;
+    try {
+        const filtered = filterRequests(requests, options);
+        displayFn(filtered, options);
+    }
+    catch (error) {
+        if (error instanceof CommandError) {
+            handleCommandError(error, options.json ?? false);
+        }
+        throw error;
+    }
+}
+/**
+ * Run follow mode with periodic updates.
+ */
+async function runFollowMode(options) {
+    console.error(followingNetworkMessage());
+    const refresh = () => processNetworkRequests(options, displayNetworkStreaming);
+    await refresh();
+    const intervalId = setInterval(() => {
+        void refresh();
+    }, FOLLOW_INTERVAL_MS);
+    process.on('SIGINT', () => {
+        clearInterval(intervalId);
+        console.error(stoppedFollowingNetworkMessage());
+        process.exit(EXIT_CODES.SUCCESS);
+    });
+}
+/**
+ * Run standard (non-follow) mode.
+ */
+async function runStandardMode(options) {
+    await processNetworkRequests(options, displayNetworkList);
+}
+/**
+ * Execute network list command action.
+ */
+async function executeNetworkList(options) {
+    try {
+        validateFilterOptions(options);
+    }
+    catch (error) {
+        if (error instanceof CommandError) {
+            handleCommandError(error, options.json ?? false);
+        }
+        throw error;
+    }
+    if (options.follow) {
+        await runFollowMode(options);
+    }
+    else {
+        await runStandardMode(options);
+    }
+}
+/**
+ * Format preset help text for command help output.
+ */
+function formatPresetHelp() {
+    return Object.entries(FILTER_PRESETS)
+        .map(([name, preset]) => `  ${name.padEnd(12)} ${preset.description}`)
+        .join('\n');
+}
+/**
+ * Register network list command.
+ *
+ * @param networkCmd - Network parent command
+ */
+export function registerListCommand(networkCmd) {
+    networkCmd
+        .command('list')
+        .description('List network requests with DevTools-compatible filtering')
+        .addOption(jsonOption())
+        .addOption(filterDslOption)
+        .addOption(presetOption)
+        .addOption(networkLastOption)
+        .addOption(followOption)
+        .addOption(verboseOption)
+        .addHelpText('after', `\n${getFilterHelpText()}\n\nPresets:\n${formatPresetHelp()}`)
+        .action(executeNetworkList);
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/network/list.js.map

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

package/dist/commands/network/shared.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Shared utilities and helper commands for network subcommands.
+ *
+ * Contains getCookies and headers commands, plus shared data fetching utilities.
+ */
+import type { Command } from 'commander';
+import type { NetworkRequest } from '../../types.js';
+/**
+ * Fetch network requests from live daemon session.
+ *
+ * @returns Network requests array
+ * @throws Error if daemon connection fails or no network data available
+ */
+export declare function fetchFromLiveSession(): Promise<NetworkRequest[]>;
+/**
+ * Fetch network requests from offline session.json file.
+ *
+ * @returns Network requests array
+ * @throws Error if session file not found or no network data available
+ */
+export declare function fetchFromOfflineSession(): NetworkRequest[];
+/**
+ * Check if error indicates daemon is unavailable.
+ *
+ * @param error - Error to check
+ * @returns True if error indicates no active session or daemon connection failure
+ */
+export declare function isDaemonUnavailable(error: unknown): boolean;
+/**
+ * Get network requests from live session or session.json.
+ *
+ * Tries live daemon first, falls back to offline session file.
+ *
+ * @returns Network requests array
+ * @throws Error if no session available (live or offline)
+ */
+export declare function getNetworkRequests(): Promise<NetworkRequest[]>;
+/**
+ * Register getCookies command.
+ *
+ * @param networkCmd - Network parent command
+ */
+export declare function registerGetCookiesCommand(networkCmd: Command): void;
+/**
+ * Register headers command.
+ *
+ * @param networkCmd - Network parent command
+ */
+export declare function registerHeadersCommand(networkCmd: Command): void;
+/**
+ * Register document command.
+ *
+ * @param networkCmd - Network parent command
+ */
+export declare function registerDocumentCommand(networkCmd: Command): void;
+//# sourceMappingURL=shared.d.ts.map

package/dist/commands/network/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/commands/network/shared.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWzC,OAAO,KAAK,EAAa,cAAc,EAAE,MAAM,YAAY,CAAC;AAO5D;;;;;GAKG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAStE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,IAAI,cAAc,EAAE,CAkB1D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAO3D;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CASpE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI,CA6BnE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI,CAqChE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI,CAgCjE"}