browser-debugger-cli 0.6.8 → 0.6.10

package/dist/telemetry/filterDsl.js

@@ -0,0 +1,299 @@
+/**
+ * DevTools-compatible Network Filter DSL parser and evaluator.
+ *
+ * Provides Chrome DevTools Network panel filter syntax for querying network requests.
+ * Supports domain matching, status codes, HTTP methods, MIME types, size thresholds,
+ * header inspection, and various state filters.
+ */
+import { matchesWildcard } from '../telemetry/filters.js';
+import { createLogger } from '../ui/logging/index.js';
+import { extractHostname } from '../utils/url.js';
+const log = createLogger('network');
+const SIZE_UNITS = {
+    b: 1,
+    kb: 1024,
+    mb: 1024 * 1024,
+    gb: 1024 * 1024 * 1024,
+};
+const VALID_FILTER_TYPES = [
+    'domain',
+    'status-code',
+    'method',
+    'mime-type',
+    'resource-type',
+    'larger-than',
+    'has-response-header',
+    'is',
+    'scheme',
+];
+const VALID_IS_VALUES = ['from-cache', 'running'];
+const SIZE_PATTERN = /^(\d+(?:\.\d+)?)\s*(b|kb|mb|gb)?$/i;
+const QUOTED_TOKEN_PATTERN = /(?:[^\s"]+|"[^"]*")+/g;
+/**
+ * Parse a size string with units into bytes.
+ */
+export function parseSize(value) {
+    const match = value.match(SIZE_PATTERN);
+    if (!match) {
+        throw new Error(`Invalid size format: "${value}". Use format like "100KB", "1MB", "1.5GB"`);
+    }
+    const [, numStr, unit = 'b'] = match;
+    const num = parseFloat(numStr ?? '0');
+    const multiplier = SIZE_UNITS[unit.toLowerCase()] ?? 1;
+    return Math.floor(num * multiplier);
+}
+function extractOperator(value) {
+    if (value.startsWith('>='))
+        return ['>=', value.slice(2)];
+    if (value.startsWith('<='))
+        return ['<=', value.slice(2)];
+    if (value.startsWith('>'))
+        return ['>', value.slice(1)];
+    if (value.startsWith('<'))
+        return ['<', value.slice(1)];
+    return ['=', value];
+}
+function findSimilarTypes(input) {
+    const lowerInput = input.toLowerCase();
+    return VALID_FILTER_TYPES.filter((type) => {
+        const prefix = type.split('-')[0] ?? '';
+        const typeNoHyphens = type.replace('-', '');
+        return (type.startsWith(lowerInput) ||
+            lowerInput.startsWith(prefix) ||
+            type.includes(lowerInput) ||
+            lowerInput.includes(typeNoHyphens));
+    });
+}
+function createError(error, suggestion) {
+    return suggestion ? { error, suggestion } : { error };
+}
+function isNegated(token) {
+    return token.startsWith('-') || token.startsWith('!');
+}
+function validateFilterType(type) {
+    if (VALID_FILTER_TYPES.includes(type))
+        return null;
+    const similar = findSimilarTypes(type);
+    const suggestion = similar.length > 0
+        ? `Did you mean: ${similar.join(', ')}?`
+        : `Valid types: ${VALID_FILTER_TYPES.join(', ')}`;
+    return createError(`Unknown filter type: "${type}"`, suggestion);
+}
+function validateIsValue(value) {
+    const lowerValue = value.toLowerCase();
+    if (VALID_IS_VALUES.includes(lowerValue))
+        return null;
+    return createError(`Invalid "is" filter value: "${value}"`, `Valid values: ${VALID_IS_VALUES.join(', ')}`);
+}
+function validateSizeValue(value) {
+    try {
+        parseSize(value);
+        return null;
+    }
+    catch (error) {
+        log.debug(`Size parse failed for "${value}": ${error instanceof Error ? error.message : String(error)}`);
+        return createError(`Invalid size format: "${value}"`, 'Use format like "100KB", "1MB", "1.5GB"');
+    }
+}
+function validateStatusCode(value) {
+    const numValue = parseInt(value, 10);
+    if (!isNaN(numValue) && numValue >= 100 && numValue <= 599)
+        return null;
+    return createError(`Invalid status code: "${value}"`, 'Status codes must be between 100 and 599');
+}
+function parseFilterToken(token) {
+    const trimmed = token.trim();
+    if (!trimmed)
+        return createError('Empty filter token');
+    const negated = isNegated(trimmed);
+    const withoutPrefix = negated ? trimmed.slice(1) : trimmed;
+    const colonIndex = withoutPrefix.indexOf(':');
+    if (colonIndex === -1) {
+        return createError(`Invalid filter format: "${token}". Expected "type:value" format`, 'Use format like "status-code:404" or "domain:api.*"');
+    }
+    const type = withoutPrefix.slice(0, colonIndex).toLowerCase();
+    const rawValue = withoutPrefix.slice(colonIndex + 1);
+    if (!rawValue) {
+        return createError(`Missing value for filter "${type}"`, `Provide a value after the colon`);
+    }
+    const typeError = validateFilterType(type);
+    if (typeError)
+        return typeError;
+    let operator = '=';
+    let value = rawValue;
+    if (type === 'status-code' || type === 'larger-than') {
+        [operator, value] = extractOperator(rawValue);
+    }
+    if (type === 'is') {
+        const isError = validateIsValue(value);
+        if (isError)
+            return isError;
+        value = value.toLowerCase();
+    }
+    if (type === 'larger-than') {
+        const sizeError = validateSizeValue(value);
+        if (sizeError)
+            return sizeError;
+    }
+    if (type === 'status-code') {
+        const statusError = validateStatusCode(value);
+        if (statusError)
+            return statusError;
+    }
+    return { type: type, value, negated, operator };
+}
+function tokenize(input) {
+    return input.match(QUOTED_TOKEN_PATTERN) ?? [];
+}
+function stripQuotes(token) {
+    return token.startsWith('"') && token.endsWith('"') ? token.slice(1, -1) : token;
+}
+/**
+ * Parse a filter string into an array of ParsedFilter objects.
+ */
+export function parseFilterString(input) {
+    if (!input.trim())
+        return [];
+    const tokens = tokenize(input);
+    const filters = [];
+    for (const token of tokens) {
+        const result = parseFilterToken(stripQuotes(token));
+        if ('error' in result) {
+            const errorMsg = result.suggestion ? `${result.error}\n${result.suggestion}` : result.error;
+            throw new Error(errorMsg);
+        }
+        filters.push(result);
+    }
+    return filters;
+}
+/**
+ * Validate a filter string and return detailed results.
+ */
+export function validateFilterString(input) {
+    try {
+        const filters = parseFilterString(input);
+        return { valid: true, filters };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const [errorLine, suggestionLine] = message.split('\n');
+        const result = { valid: false, error: errorLine ?? message };
+        if (suggestionLine)
+            result.suggestion = suggestionLine;
+        return result;
+    }
+}
+function compareNumeric(actual, target, operator) {
+    switch (operator) {
+        case '=':
+            return actual === target;
+        case '>=':
+            return actual >= target;
+        case '<=':
+            return actual <= target;
+        case '>':
+            return actual > target;
+        case '<':
+            return actual < target;
+    }
+}
+function extractScheme(url) {
+    try {
+        return new URL(url).protocol.replace(':', '');
+    }
+    catch {
+        return '';
+    }
+}
+function normalizeMimeType(mimeType) {
+    return mimeType.toLowerCase().split(';')[0]?.trim() ?? '';
+}
+function matchesCacheHeaders(headers) {
+    if (!headers)
+        return false;
+    const cacheHeader = headers['x-cache']?.toLowerCase() ?? '';
+    const cfCacheStatus = headers['cf-cache-status']?.toLowerCase() ?? '';
+    return cacheHeader.includes('hit') || cfCacheStatus === 'hit';
+}
+function matchesFilter(request, filter) {
+    switch (filter.type) {
+        case 'domain':
+            return matchesWildcard(extractHostname(request.url), filter.value);
+        case 'status-code':
+            if (request.status === undefined)
+                return false;
+            return compareNumeric(request.status, parseInt(filter.value, 10), filter.operator);
+        case 'method':
+            return request.method.toUpperCase() === filter.value.toUpperCase();
+        case 'mime-type': {
+            if (!request.mimeType)
+                return false;
+            const normalizedMime = normalizeMimeType(request.mimeType);
+            const filterValue = filter.value.toLowerCase();
+            return normalizedMime === filterValue || normalizedMime.startsWith(filterValue);
+        }
+        case 'resource-type': {
+            if (!request.resourceType)
+                return false;
+            const types = filter.value.split(',').map((t) => t.trim().toLowerCase());
+            return types.includes(request.resourceType.toLowerCase());
+        }
+        case 'larger-than': {
+            const size = request.encodedDataLength ?? 0;
+            const threshold = parseSize(filter.value);
+            const effectiveOperator = filter.operator === '=' ? '>' : filter.operator;
+            return compareNumeric(size, threshold, effectiveOperator);
+        }
+        case 'has-response-header': {
+            if (!request.responseHeaders)
+                return false;
+            const headerName = filter.value.toLowerCase();
+            return Object.keys(request.responseHeaders).some((h) => h.toLowerCase() === headerName);
+        }
+        case 'is':
+            if (filter.value === 'from-cache')
+                return matchesCacheHeaders(request.responseHeaders);
+            if (filter.value === 'running')
+                return request.status === undefined;
+            return false;
+        case 'scheme':
+            return extractScheme(request.url).toLowerCase() === filter.value.toLowerCase();
+    }
+}
+/**
+ * Apply parsed filters to an array of network requests.
+ */
+export function applyFilters(requests, filters) {
+    if (filters.length === 0)
+        return requests;
+    return requests.filter((request) => filters.every((filter) => {
+        const matches = matchesFilter(request, filter);
+        return filter.negated ? !matches : matches;
+    }));
+}
+/**
+ * Get help text for filter DSL syntax.
+ */
+export function getFilterHelpText() {
+    return `
+Filter syntax:
+  status-code:>=400       HTTP status codes (supports =, >=, <=, >, <)
+  domain:api.*            Domain with wildcards
+  method:POST             HTTP method
+  mime-type:application/json
+  resource-type:XHR,Fetch CDP resource types (comma-separated)
+  larger-than:100KB       Size threshold (B, KB, MB, GB)
+  has-response-header:set-cookie
+  is:from-cache           Cached responses
+  is:running              In-progress requests
+  scheme:https            URL scheme
+
+Negation (use ! to avoid CLI conflicts with -):
+  !domain:cdn.*           Exclude matching requests
+  --filter="!method:POST" Alternative: use = syntax with -
+
+Multiple filters:
+  "domain:api.* status-code:>=400"  (AND logic)
+`.trim();
+}
+//# sourceMappingURL=filterDsl.js.map

package/dist/telemetry/filterDsl.js.map

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

package/dist/telemetry/filterPresets.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Predefined filter presets for common network queries.
+ *
+ * Provides convenient shortcuts for frequently used filter combinations.
+ */
+/**
+ * Filter preset definition.
+ */
+export interface FilterPreset {
+    /** Preset name (used in --preset option) */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Filter DSL string */
+    filter: string;
+}
+/**
+ * Available filter presets.
+ */
+export declare const FILTER_PRESETS: Record<string, FilterPreset>;
+/**
+ * Resolve a preset name to its filter string.
+ *
+ * @param name - Preset name
+ * @returns Filter DSL string
+ * @throws CommandError if preset not found
+ */
+export declare function resolvePreset(name: string): string;
+/**
+ * Get all preset names for CLI choices.
+ *
+ * @returns Array of preset names
+ */
+export declare function getPresetNames(): string[];
+//# sourceMappingURL=filterPresets.d.ts.map

package/dist/telemetry/filterPresets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterPresets.d.ts","sourceRoot":"","sources":["../../src/telemetry/filterPresets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAyCvD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWlD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAEzC"}

package/dist/telemetry/filterPresets.js

@@ -0,0 +1,76 @@
+/**
+ * Predefined filter presets for common network queries.
+ *
+ * Provides convenient shortcuts for frequently used filter combinations.
+ */
+import { CommandError } from '../ui/errors/index.js';
+import { EXIT_CODES } from '../utils/exitCodes.js';
+/**
+ * Available filter presets.
+ */
+export const FILTER_PRESETS = {
+    errors: {
+        name: 'errors',
+        description: 'Failed requests (4xx and 5xx status codes)',
+        filter: 'status-code:>=400',
+    },
+    api: {
+        name: 'api',
+        description: 'API requests (XHR and Fetch)',
+        filter: 'resource-type:XHR,Fetch',
+    },
+    large: {
+        name: 'large',
+        description: 'Large responses (>1MB)',
+        filter: 'larger-than:1MB',
+    },
+    cached: {
+        name: 'cached',
+        description: 'Cached responses',
+        filter: 'is:from-cache',
+    },
+    documents: {
+        name: 'documents',
+        description: 'HTML documents only',
+        filter: 'resource-type:Document',
+    },
+    media: {
+        name: 'media',
+        description: 'Images, video, and audio',
+        filter: 'resource-type:Image,Media',
+    },
+    scripts: {
+        name: 'scripts',
+        description: 'JavaScript files',
+        filter: 'resource-type:Script',
+    },
+    pending: {
+        name: 'pending',
+        description: 'In-progress requests (no response yet)',
+        filter: 'is:running',
+    },
+};
+/**
+ * Resolve a preset name to its filter string.
+ *
+ * @param name - Preset name
+ * @returns Filter DSL string
+ * @throws CommandError if preset not found
+ */
+export function resolvePreset(name) {
+    const preset = FILTER_PRESETS[name.toLowerCase()];
+    if (!preset) {
+        const available = Object.keys(FILTER_PRESETS).join(', ');
+        throw new CommandError(`Unknown preset: "${name}"`, { suggestion: `Available presets: ${available}` }, EXIT_CODES.INVALID_ARGUMENTS);
+    }
+    return preset.filter;
+}
+/**
+ * Get all preset names for CLI choices.
+ *
+ * @returns Array of preset names
+ */
+export function getPresetNames() {
+    return Object.keys(FILTER_PRESETS);
+}
+//# sourceMappingURL=filterPresets.js.map

package/dist/telemetry/filterPresets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterPresets.js","sourceRoot":"","sources":["../../src/telemetry/filterPresets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAclD;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAiC;IAC1D,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,4CAA4C;QACzD,MAAM,EAAE,mBAAmB;KAC5B;IACD,GAAG,EAAE;QACH,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,8BAA8B;QAC3C,MAAM,EAAE,yBAAyB;KAClC;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,wBAAwB;QACrC,MAAM,EAAE,iBAAiB;KAC1B;IACD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,kBAAkB;QAC/B,MAAM,EAAE,eAAe;KACxB;IACD,SAAS,EAAE;QACT,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,qBAAqB;QAClC,MAAM,EAAE,wBAAwB;KACjC;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,0BAA0B;QACvC,MAAM,EAAE,2BAA2B;KACpC;IACD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,kBAAkB;QAC/B,MAAM,EAAE,sBAAsB;KAC/B;IACD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,wCAAwC;QACrD,MAAM,EAAE,YAAY;KACrB;CACF,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAClD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzD,MAAM,IAAI,YAAY,CACpB,oBAAoB,IAAI,GAAG,EAC3B,EAAE,UAAU,EAAE,sBAAsB,SAAS,EAAE,EAAE,EACjD,UAAU,CAAC,iBAAiB,CAC7B,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AACrC,CAAC"}

package/dist/telemetry/navigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/telemetry/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAK/C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,aAAa,EAClB,WAAW,EAAE,eAAe,EAAE,GAC7B,OAAO,CAAC;IAAE,OAAO,EAAE,eAAe,CAAC;IAAC,sBAAsB,EAAE,MAAM,MAAM,CAAA;CAAE,CAAC,CAoC7E"}
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/telemetry/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAK/C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,aAAa,EAClB,WAAW,EAAE,eAAe,EAAE,GAC7B,OAAO,CAAC;IAAE,OAAO,EAAE,eAAe,CAAC;IAAC,sBAAsB,EAAE,MAAM,MAAM,CAAA;CAAE,CAAC,CA6C7E"}

package/dist/telemetry/navigation.js

@@ -56,6 +56,13 @@ export async function startNavigationTracking(cdp, navigations) {
             log.debug(`Main frame navigation detected [${navigationCounter}]: ${params.frame.url}`);
         }
     });
+    // Track DOM.documentUpdated for SPA re-renders and document replacements
+    // This fires when the document is completely replaced (React root re-renders, etc.)
+    await cdp.send('DOM.enable');
+    registry.registerTyped(typed, 'DOM.documentUpdated', () => {
+        navigationCounter++;
+        log.debug(`DOM document updated [${navigationCounter}]`);
+    });
     return {
         cleanup: () => {
             registry.cleanup();

package/dist/telemetry/navigation.js.map

@@ -1 +1 @@
-{"version":3,"file":"navigation.js","sourceRoot":"","sources":["../../src/telemetry/navigation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;AAcvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,GAAkB,EAClB,WAA8B;IAE9B,MAAM,QAAQ,GAAG,IAAI,kBAAkB,EAAE,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAE1B,MAAM,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAE9B,MAAM,iBAAiB,GAAoB;QACzC,GAAG,EAAE,EAAE;QACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,YAAY,EAAE,iBAAiB;KAChC,CAAC;IACF,WAAW,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAEpC,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,qBAAqB,EAAE,CAAC,MAAM,EAAE,EAAE;QAC9D,IAAI,MAAM,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACxC,iBAAiB,EAAE,CAAC;YAEpB,MAAM,UAAU,GAAoB;gBAClC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG;gBACrB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,YAAY,EAAE,iBAAiB;aAChC,CAAC;YAEF,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAE7B,GAAG,CAAC,KAAK,CAAC,mCAAmC,iBAAiB,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,GAAG,EAAE;YACZ,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrB,CAAC;QACD,sBAAsB,EAAE,GAAG,EAAE,CAAC,iBAAiB;KAChD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"navigation.js","sourceRoot":"","sources":["../../src/telemetry/navigation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;AAcvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,GAAkB,EAClB,WAA8B;IAE9B,MAAM,QAAQ,GAAG,IAAI,kBAAkB,EAAE,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAE1B,MAAM,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAE9B,MAAM,iBAAiB,GAAoB;QACzC,GAAG,EAAE,EAAE;QACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,YAAY,EAAE,iBAAiB;KAChC,CAAC;IACF,WAAW,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAEpC,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,qBAAqB,EAAE,CAAC,MAAM,EAAE,EAAE;QAC9D,IAAI,MAAM,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACxC,iBAAiB,EAAE,CAAC;YAEpB,MAAM,UAAU,GAAoB;gBAClC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG;gBACrB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,YAAY,EAAE,iBAAiB;aAChC,CAAC;YAEF,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAE7B,GAAG,CAAC,KAAK,CAAC,mCAAmC,iBAAiB,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,yEAAyE;IACzE,oFAAoF;IACpF,MAAM,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAE7B,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,qBAAqB,EAAE,GAAG,EAAE;QACxD,iBAAiB,EAAE,CAAC;QACpB,GAAG,CAAC,KAAK,CAAC,yBAAyB,iBAAiB,GAAG,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,GAAG,EAAE;YACZ,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrB,CAAC;QACD,sBAAsB,EAAE,GAAG,EAAE,CAAC,iBAAiB;KAChD,CAAC;AACJ,CAAC"}

package/dist/telemetry/network.d.ts

@@ -1,5 +1,5 @@
 import type { CDPConnection } from '../connection/cdp.js';
-import type { NetworkRequest, CleanupFunction } from '../types';
+import type { NetworkRequest, WebSocketConnection, CleanupFunction } from '../types';
 export interface NetworkCollectionOptions {
     includeAll?: boolean;
     fetchAllBodies?: boolean;
@@ -31,4 +31,15 @@ export interface NetworkCollectionOptions {
  * - Pattern precedence: include patterns always trump exclude patterns
  */
 export declare function startNetworkCollection(cdp: CDPConnection, requests: NetworkRequest[], options?: NetworkCollectionOptions): Promise<CleanupFunction>;
+/**
+ * Start collecting WebSocket connections and frames via CDP Network domain.
+ *
+ * Tracks WebSocket lifecycle (creation, handshake, frames, close) separately from HTTP requests.
+ * Network.enable must be called before this (typically by startNetworkCollection).
+ *
+ * @param cdp - CDP connection instance
+ * @param connections - Array to populate with WebSocket connections
+ * @returns Cleanup function to remove event handlers
+ */
+export declare function startWebSocketCollection(cdp: CDPConnection, connections: WebSocketConnection[]): CleanupFunction;
 //# sourceMappingURL=network.d.ts.map

package/dist/telemetry/network.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/telemetry/network.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAczD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAoH/D,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAC;CACrD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,cAAc,EAAE,EAC1B,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,eAAe,CAAC,CA0L1B"}
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/telemetry/network.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAczD,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAkB,eAAe,EAAE,MAAM,SAAS,CAAC;AA8GpG,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAC;CACrD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,cAAc,EAAE,EAC1B,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,eAAe,CAAC,CAyM1B;AAWD;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,aAAa,EAClB,WAAW,EAAE,mBAAmB,EAAE,GACjC,eAAe,CA2HjB"}