browser-debugger-cli 0.6.0 → 0.6.2

package/dist/telemetry/__tests__/a11y.unit.test.js

@@ -0,0 +1,265 @@
+/**
+ * Unit tests for accessibility tree pure functions.
+ *
+ * Tests the contract of pure functions:
+ * - buildTreeFromRawNodes: Tree construction from CDP nodes
+ * - parseQueryPattern: Pattern string parsing
+ * - queryA11yTree: Tree querying logic
+ */
+import { strict as assert } from 'node:assert';
+import { describe, test } from 'node:test';
+import { buildTreeFromRawNodes, parseQueryPattern, queryA11yTree } from '../../telemetry/a11y.js';
+describe('buildTreeFromRawNodes', () => {
+    test('builds tree from valid CDP nodes', () => {
+        const rawNodes = [
+            {
+                nodeId: '1',
+                ignored: false,
+                role: { type: 'role', value: 'RootWebArea' },
+                name: { type: 'computedString', value: 'Test Page' },
+                childIds: ['2', '3'],
+            },
+            {
+                nodeId: '2',
+                ignored: false,
+                role: { type: 'role', value: 'button' },
+                name: { type: 'computedString', value: 'Submit' },
+                properties: [{ name: 'focusable', value: { type: 'boolean', value: true } }],
+            },
+            {
+                nodeId: '3',
+                ignored: false,
+                role: { type: 'role', value: 'textbox' },
+                name: { type: 'computedString', value: 'Email' },
+                properties: [{ name: 'required', value: { type: 'boolean', value: true } }],
+            },
+        ];
+        const tree = buildTreeFromRawNodes(rawNodes);
+        assert.equal(tree.count, 3, 'Should count all non-ignored nodes');
+        assert.equal(tree.root.role, 'RootWebArea', 'First node should be root');
+        assert.equal(tree.root.name, 'Test Page');
+        assert.ok(tree.nodes.has('1'), 'Should index node by nodeId');
+        assert.ok(tree.nodes.has('2'), 'Should index all nodes');
+        assert.ok(tree.nodes.has('3'), 'Should index all nodes');
+    });
+    test('filters out ignored nodes', () => {
+        const rawNodes = [
+            {
+                nodeId: '1',
+                ignored: false,
+                role: { type: 'role', value: 'button' },
+                name: { type: 'computedString', value: 'Click Me' },
+            },
+            {
+                nodeId: '2',
+                ignored: true,
+                ignoredReasons: [{ name: 'uninteresting', value: { type: 'boolean', value: true } }],
+                role: { type: 'role', value: 'none' },
+            },
+            {
+                nodeId: '3',
+                ignored: false,
+                role: { type: 'role', value: 'textbox' },
+                name: { type: 'computedString', value: 'Input' },
+            },
+        ];
+        const tree = buildTreeFromRawNodes(rawNodes);
+        assert.equal(tree.count, 2, 'Should exclude ignored nodes');
+        assert.ok(tree.nodes.has('1'), 'Should include non-ignored nodes');
+        assert.ok(!tree.nodes.has('2'), 'Should exclude ignored node');
+        assert.ok(tree.nodes.has('3'), 'Should include non-ignored nodes');
+    });
+    test('extracts common properties (focusable, focused, disabled, required)', () => {
+        const rawNodes = [
+            {
+                nodeId: '1',
+                ignored: false,
+                role: { type: 'role', value: 'textbox' },
+                name: { type: 'computedString', value: 'Email' },
+                properties: [
+                    { name: 'focusable', value: { type: 'boolean', value: true } },
+                    { name: 'focused', value: { type: 'boolean', value: true } },
+                    { name: 'required', value: { type: 'boolean', value: true } },
+                ],
+            },
+        ];
+        const tree = buildTreeFromRawNodes(rawNodes);
+        const node = tree.nodes.get('1');
+        assert.ok(node);
+        assert.equal(node.focusable, true);
+        assert.equal(node.focused, true);
+        assert.equal(node.required, true);
+    });
+    test('stores non-standard properties in properties map', () => {
+        const rawNodes = [
+            {
+                nodeId: '1',
+                ignored: false,
+                role: { type: 'role', value: 'textbox' },
+                properties: [
+                    { name: 'invalid', value: { type: 'string', value: 'false' } },
+                    { name: 'editable', value: { type: 'string', value: 'plaintext' } },
+                ],
+            },
+        ];
+        const tree = buildTreeFromRawNodes(rawNodes);
+        const node = tree.nodes.get('1');
+        assert.ok(node);
+        assert.ok(node.properties);
+        assert.equal(node.properties['invalid'], 'false');
+        assert.equal(node.properties['editable'], 'plaintext');
+    });
+    test('throws error when no non-ignored nodes found', () => {
+        const rawNodes = [
+            {
+                nodeId: '1',
+                ignored: true,
+                ignoredReasons: [{ name: 'uninteresting', value: { type: 'boolean', value: true } }],
+                role: { type: 'role', value: 'none' },
+            },
+        ];
+        assert.throws(() => buildTreeFromRawNodes(rawNodes), /No root node found/, 'Should throw when all nodes are ignored');
+    });
+    test('handles empty node array', () => {
+        const rawNodes = [];
+        assert.throws(() => buildTreeFromRawNodes(rawNodes), /No root node found/, 'Should throw for empty array');
+    });
+});
+describe('parseQueryPattern', () => {
+    test('parses single field pattern', () => {
+        const pattern = parseQueryPattern('role:button');
+        assert.equal(pattern.role, 'button');
+        assert.equal(pattern.name, undefined);
+        assert.equal(pattern.description, undefined);
+    });
+    test('parses multiple field pattern with AND logic', () => {
+        const pattern = parseQueryPattern('role:button name:Submit');
+        assert.equal(pattern.role, 'button');
+        assert.equal(pattern.name, 'Submit');
+    });
+    test('parses all three fields', () => {
+        const pattern = parseQueryPattern('role:button name:Submit description:Primary');
+        assert.equal(pattern.role, 'button');
+        assert.equal(pattern.name, 'Submit');
+        assert.equal(pattern.description, 'Primary');
+    });
+    test('handles values with spaces (takes first word)', () => {
+        const pattern = parseQueryPattern('role:button name:Submit Form');
+        assert.equal(pattern.role, 'button');
+        assert.equal(pattern.name, 'Submit');
+    });
+    test('handles description shorthand (desc)', () => {
+        const pattern = parseQueryPattern('desc:Main');
+        assert.equal(pattern.description, 'Main');
+    });
+    test('handles values with colons', () => {
+        const pattern = parseQueryPattern('name:Click:Me');
+        assert.equal(pattern.name, 'Click:Me');
+    });
+    test('ignores invalid fields', () => {
+        const pattern = parseQueryPattern('invalid:value role:button');
+        assert.equal(pattern.role, 'button');
+        assert.equal(Object.keys(pattern).length, 1, 'Should only include valid fields');
+    });
+    test('returns empty object for invalid pattern', () => {
+        const pattern = parseQueryPattern('invalid:value');
+        assert.deepEqual(pattern, {});
+    });
+    test('is case-insensitive for field names', () => {
+        const pattern = parseQueryPattern('ROLE:button Name:Submit DESC:Primary');
+        assert.equal(pattern.role, 'button');
+        assert.equal(pattern.name, 'Submit');
+        assert.equal(pattern.description, 'Primary');
+    });
+});
+describe('queryA11yTree', () => {
+    const tree = {
+        root: {
+            nodeId: '1',
+            role: 'RootWebArea',
+            name: 'Test Page',
+        },
+        nodes: new Map([
+            ['1', { nodeId: '1', role: 'RootWebArea', name: 'Test Page' }],
+            ['2', { nodeId: '2', role: 'button', name: 'Submit Form', focusable: true }],
+            ['3', { nodeId: '3', role: 'button', name: 'Cancel', focusable: true }],
+            ['4', { nodeId: '4', role: 'textbox', name: 'Email Address', required: true }],
+            ['5', { nodeId: '5', role: 'textbox', name: 'Password', required: true }],
+        ]),
+        count: 5,
+    };
+    test('queries by role only', () => {
+        const result = queryA11yTree(tree, { role: 'button' });
+        assert.equal(result.count, 2, 'Should find both buttons');
+        assert.equal(result.nodes.length, 2);
+        assert.ok(result.nodes.every((n) => n.role === 'button'), 'All results should be buttons');
+    });
+    test('queries by name only', () => {
+        const result = queryA11yTree(tree, { name: 'Email' });
+        assert.equal(result.count, 1);
+        assert.ok(result.nodes[0]);
+        assert.equal(result.nodes[0].name, 'Email Address');
+    });
+    test('queries with AND logic (role + name)', () => {
+        const result = queryA11yTree(tree, { role: 'button', name: 'Submit' });
+        assert.equal(result.count, 1);
+        assert.ok(result.nodes[0]);
+        assert.equal(result.nodes[0].name, 'Submit Form');
+        assert.equal(result.nodes[0].role, 'button');
+    });
+    test('name matching is case-insensitive', () => {
+        const result = queryA11yTree(tree, { name: 'submit' });
+        assert.equal(result.count, 1);
+        assert.ok(result.nodes[0]);
+        assert.equal(result.nodes[0].name, 'Submit Form');
+    });
+    test('name matching is substring match', () => {
+        const result = queryA11yTree(tree, { name: 'Form' });
+        assert.equal(result.count, 1);
+        assert.ok(result.nodes[0]);
+        assert.equal(result.nodes[0].name, 'Submit Form');
+    });
+    test('role matching is case-insensitive', () => {
+        const result = queryA11yTree(tree, { role: 'BUTTON' });
+        assert.equal(result.count, 2);
+    });
+    test('returns empty result when no matches', () => {
+        const result = queryA11yTree(tree, { role: 'heading' });
+        assert.equal(result.count, 0);
+        assert.equal(result.nodes.length, 0);
+    });
+    test('returns query pattern in result', () => {
+        const pattern = { role: 'button', name: 'Submit' };
+        const result = queryA11yTree(tree, pattern);
+        assert.deepEqual(result.pattern, pattern);
+    });
+    test('queries by description', () => {
+        const treeWithDesc = {
+            root: { nodeId: '1', role: 'button', name: 'Click' },
+            nodes: new Map([
+                ['1', { nodeId: '1', role: 'button', name: 'Click', description: 'Primary action' }],
+                ['2', { nodeId: '2', role: 'button', name: 'Cancel', description: 'Secondary action' }],
+            ]),
+            count: 2,
+        };
+        const result = queryA11yTree(treeWithDesc, { description: 'Primary' });
+        assert.equal(result.count, 1);
+        assert.ok(result.nodes[0]);
+        assert.equal(result.nodes[0].description, 'Primary action');
+    });
+    test('handles nodes without name field', () => {
+        const treeWithoutNames = {
+            root: { nodeId: '1', role: 'generic' },
+            nodes: new Map([
+                ['1', { nodeId: '1', role: 'generic' }],
+                ['2', { nodeId: '2', role: 'button', name: 'Submit' }],
+            ]),
+            count: 2,
+        };
+        const result = queryA11yTree(treeWithoutNames, { name: 'Submit' });
+        assert.equal(result.count, 1);
+        assert.ok(result.nodes[0]);
+        assert.equal(result.nodes[0].name, 'Submit');
+    });
+});
+//# sourceMappingURL=a11y.unit.test.js.map

package/dist/telemetry/__tests__/a11y.unit.test.js.map

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

package/dist/telemetry/__tests__/navigation.contract.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Navigation tracking contract tests
+ *
+ * Tests the public API behavior of startNavigationTracking WITHOUT testing implementation details.
+ * Follows the testing philosophy: "Test the contract, not the implementation"
+ */
+export {};
+//# sourceMappingURL=navigation.contract.test.d.ts.map

package/dist/telemetry/__tests__/navigation.contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.contract.test.d.ts","sourceRoot":"","sources":["../../../src/telemetry/__tests__/navigation.contract.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/telemetry/__tests__/navigation.contract.test.js

@@ -0,0 +1,211 @@
+/**
+ * Navigation tracking contract tests
+ *
+ * Tests the public API behavior of startNavigationTracking WITHOUT testing implementation details.
+ * Follows the testing philosophy: "Test the contract, not the implementation"
+ */
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+import { startNavigationTracking } from '../../telemetry/navigation.js';
+/**
+ * Mock CDP connection for testing navigation tracking.
+ * Only mocks the CDP boundary - all telemetry logic is real.
+ */
+class MockCDPConnection {
+    eventHandlers = new Map();
+    nextHandlerId = 0;
+    sendCalls = [];
+    send(method, params) {
+        this.sendCalls.push({ method, params });
+        return Promise.resolve({});
+    }
+    on(event, handler) {
+        if (!this.eventHandlers.has(event)) {
+            this.eventHandlers.set(event, new Map());
+        }
+        const id = this.nextHandlerId++;
+        const handlers = this.eventHandlers.get(event);
+        if (handlers) {
+            handlers.set(id, handler);
+        }
+        return () => this.off(event, id);
+    }
+    off(event, handlerId) {
+        this.eventHandlers.get(event)?.delete(handlerId);
+    }
+    emit(event, params) {
+        const handlers = this.eventHandlers.get(event);
+        if (handlers) {
+            handlers.forEach((handler) => handler(params));
+        }
+    }
+    wasPageEnabled() {
+        return this.sendCalls.some((call) => call.method === 'Page.enable');
+    }
+    getHandlerCount(event) {
+        return this.eventHandlers.get(event)?.size ?? 0;
+    }
+}
+/**
+ * Test helper - create minimal Protocol.Page.Frame with required fields
+ */
+function createTestFrame(partial) {
+    return {
+        id: '',
+        loaderId: '',
+        url: '',
+        securityOrigin: '',
+        mimeType: 'text/html',
+        domainAndRegistry: '',
+        secureContextType: 'Secure',
+        crossOriginIsolatedContextType: 'Isolated',
+        gatedAPIFeatures: [],
+        ...partial,
+    };
+}
+describe('startNavigationTracking contract', () => {
+    it('should enable Page domain on initialization', async () => {
+        const mockCdp = new MockCDPConnection();
+        const navigations = [];
+        await startNavigationTracking(mockCdp, navigations);
+        assert.equal(mockCdp.wasPageEnabled(), true);
+    });
+    it('should record initial navigation event with navigationId 0', async () => {
+        const mockCdp = new MockCDPConnection();
+        const navigations = [];
+        await startNavigationTracking(mockCdp, navigations);
+        assert.equal(navigations.length, 1);
+        const nav = navigations[0];
+        assert.ok(nav, 'First navigation should exist');
+        assert.equal(nav.navigationId, 0);
+        assert.equal(nav.url, '');
+        assert.equal(typeof nav.timestamp, 'number');
+    });
+    it('should track main frame navigations and increment navigationId', async () => {
+        const mockCdp = new MockCDPConnection();
+        const navigations = [];
+        await startNavigationTracking(mockCdp, navigations);
+        const mainFrameNav = {
+            frame: createTestFrame({
+                id: 'main-frame',
+                url: 'http://localhost:3000/',
+                loaderId: 'loader1',
+                securityOrigin: 'http://localhost:3000',
+            }),
+            type: 'Navigation',
+        };
+        mockCdp.emit('Page.frameNavigated', mainFrameNav);
+        assert.equal(navigations.length, 2);
+        const nav1 = navigations[1];
+        assert.ok(nav1, 'Second navigation should exist');
+        assert.equal(nav1.navigationId, 1);
+        assert.equal(nav1.url, 'http://localhost:3000/');
+    });
+    it('should ignore iframe navigations (only track main frame)', async () => {
+        const mockCdp = new MockCDPConnection();
+        const navigations = [];
+        await startNavigationTracking(mockCdp, navigations);
+        const iframeNav = {
+            frame: createTestFrame({
+                id: 'iframe-1',
+                parentId: 'main-frame',
+                url: 'http://localhost:3000/iframe',
+                loaderId: 'loader2',
+                securityOrigin: 'http://localhost:3000',
+            }),
+            type: 'Navigation',
+        };
+        mockCdp.emit('Page.frameNavigated', iframeNav);
+        assert.equal(navigations.length, 1);
+    });
+    it('should increment navigationId for each main frame navigation', async () => {
+        const mockCdp = new MockCDPConnection();
+        const navigations = [];
+        await startNavigationTracking(mockCdp, navigations);
+        const nav1 = {
+            frame: createTestFrame({
+                id: 'main',
+                url: 'http://localhost:3000/',
+                loaderId: 'loader1',
+                securityOrigin: 'http://localhost:3000',
+            }),
+            type: 'Navigation',
+        };
+        const nav2 = {
+            frame: createTestFrame({
+                id: 'main',
+                url: 'http://localhost:3000/about',
+                loaderId: 'loader2',
+                securityOrigin: 'http://localhost:3000',
+            }),
+            type: 'Navigation',
+        };
+        const nav3 = {
+            frame: createTestFrame({
+                id: 'main',
+                url: 'http://localhost:3000/contact',
+                loaderId: 'loader3',
+                securityOrigin: 'http://localhost:3000',
+            }),
+            type: 'Navigation',
+        };
+        mockCdp.emit('Page.frameNavigated', nav1);
+        mockCdp.emit('Page.frameNavigated', nav2);
+        mockCdp.emit('Page.frameNavigated', nav3);
+        assert.equal(navigations.length, 4);
+        assert.ok(navigations[0], 'Navigation 0 should exist');
+        assert.ok(navigations[1], 'Navigation 1 should exist');
+        assert.ok(navigations[2], 'Navigation 2 should exist');
+        assert.ok(navigations[3], 'Navigation 3 should exist');
+        assert.equal(navigations[0].navigationId, 0);
+        assert.equal(navigations[1].navigationId, 1);
+        assert.equal(navigations[1].url, 'http://localhost:3000/');
+        assert.equal(navigations[2].navigationId, 2);
+        assert.equal(navigations[2].url, 'http://localhost:3000/about');
+        assert.equal(navigations[3].navigationId, 3);
+        assert.equal(navigations[3].url, 'http://localhost:3000/contact');
+    });
+    it('should return current navigationId via getCurrentNavigationId', async () => {
+        const mockCdp = new MockCDPConnection();
+        const navigations = [];
+        const { getCurrentNavigationId } = await startNavigationTracking(mockCdp, navigations);
+        assert.equal(getCurrentNavigationId(), 0);
+        const nav = {
+            frame: createTestFrame({
+                id: 'main',
+                url: 'http://localhost:3000/',
+                loaderId: 'loader1',
+                securityOrigin: 'http://localhost:3000',
+            }),
+            type: 'Navigation',
+        };
+        mockCdp.emit('Page.frameNavigated', nav);
+        assert.equal(getCurrentNavigationId(), 1);
+    });
+    it('should clean up event handlers when cleanup is called', async () => {
+        const mockCdp = new MockCDPConnection();
+        const navigations = [];
+        const { cleanup } = await startNavigationTracking(mockCdp, navigations);
+        assert.equal(mockCdp.getHandlerCount('Page.frameNavigated'), 1);
+        cleanup();
+        assert.equal(mockCdp.getHandlerCount('Page.frameNavigated'), 0);
+    });
+    it('should not track navigations after cleanup is called', async () => {
+        const mockCdp = new MockCDPConnection();
+        const navigations = [];
+        const { cleanup } = await startNavigationTracking(mockCdp, navigations);
+        cleanup();
+        const nav = {
+            frame: createTestFrame({
+                id: 'main',
+                url: 'http://localhost:3000/',
+                loaderId: 'loader1',
+                securityOrigin: 'http://localhost:3000',
+            }),
+            type: 'Navigation',
+        };
+        mockCdp.emit('Page.frameNavigated', nav);
+        assert.equal(navigations.length, 1);
+    });
+});
+//# sourceMappingURL=navigation.contract.test.js.map

package/dist/telemetry/__tests__/navigation.contract.test.js.map

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

package/dist/telemetry/__tests__/network.contract.test.d.ts

@@ -3,26 +3,6 @@
  *
  * Tests the public API behavior of startNetworkCollection WITHOUT testing implementation details.
  * Follows the testing philosophy: "Test the contract, not the implementation"
- *
- * Coverage:
- * 1. Request/response pairing - Normal flow with matching IDs
- * 2. Out-of-order events - Response arrives before request
- * 3. Stale requests - Incomplete requests after timeout
- * 4. Failed requests - Network.loadingFailed events
- * 5. Request limits - MAX_NETWORK_REQUESTS enforcement
- * 6. Cleanup - Handler removal and state cleanup
- * 7. Domain filtering - Tracking/analytics exclusion
- * 8. Body fetching - Size limits and MIME type handling
- *
- * What we test:
- * ✅ Behavior: Given CDP events → expect NetworkRequest array contents
- * ✅ Invariants: "Requests are paired with responses", "Cleanup removes all handlers"
- * ✅ Edge cases: Out-of-order, stale, limits, failures
- *
- * What we DON'T test:
- * ❌ Internal requestMap structure
- * ❌ Internal function calls (tryExactMatch, normalizeUrl, etc.)
- * ❌ Implementation details (Map vs Set, event handler IDs)
  */
 export {};
 //# sourceMappingURL=network.contract.test.d.ts.map

package/dist/telemetry/__tests__/network.contract.test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"network.contract.test.d.ts","sourceRoot":"","sources":["../../../src/telemetry/__tests__/network.contract.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG"}
+{"version":3,"file":"network.contract.test.d.ts","sourceRoot":"","sources":["../../../src/telemetry/__tests__/network.contract.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}