browser-debugger-cli 0.7.1 → 0.8.0

package/dist/connection/__tests__/handlers.unit.test.js

@@ -1,220 +0,0 @@
-/**
- * Unit tests for CDPHandlerRegistry
- *
- * Tests the contract: register handlers → track them → cleanup removes all
- *
- * Philosophy: Test the public API contract, not implementation details.
- * We don't care about the internal array structure - we only care that
- * cleanup() removes all handlers that were registered.
- */
-import assert from 'node:assert/strict';
-import { describe, test } from 'node:test';
-import { CDPHandlerRegistry } from '../../connection/handlers.js';
-import { TypedCDPConnection } from '../../connection/typed-cdp.js';
-describe('CDPHandlerRegistry - Handler Tracking', () => {
-    test('tracks single handler correctly', () => {
-        const registry = new CDPHandlerRegistry();
-        const mockCDP = createMockCDP();
-        registry.register(mockCDP, 'Network.requestWillBeSent', () => { });
-        assert.equal(registry.size(), 1, 'Should track one handler');
-    });
-    test('tracks multiple handlers correctly', () => {
-        const registry = new CDPHandlerRegistry();
-        const mockCDP = createMockCDP();
-        registry.register(mockCDP, 'Network.requestWillBeSent', () => { });
-        registry.register(mockCDP, 'Network.loadingFinished', () => { });
-        registry.register(mockCDP, 'Console.messageAdded', () => { });
-        assert.equal(registry.size(), 3, 'Should track all three handlers');
-    });
-    test('size() starts at zero', () => {
-        const registry = new CDPHandlerRegistry();
-        assert.equal(registry.size(), 0, 'Empty registry should have size 0');
-    });
-    test('tracks handlers from different events', () => {
-        const registry = new CDPHandlerRegistry();
-        const mockCDP = createMockCDP();
-        // Different events
-        registry.register(mockCDP, 'Network.requestWillBeSent', () => { });
-        registry.register(mockCDP, 'Console.messageAdded', () => { });
-        registry.register(mockCDP, 'Page.loadEventFired', () => { });
-        assert.equal(registry.size(), 3, 'Should track handlers for different events');
-    });
-    test('tracks multiple handlers for same event', () => {
-        const registry = new CDPHandlerRegistry();
-        const mockCDP = createMockCDP();
-        // Same event, different handlers
-        registry.register(mockCDP, 'Network.requestWillBeSent', () => { });
-        registry.register(mockCDP, 'Network.requestWillBeSent', () => { });
-        assert.equal(registry.size(), 2, 'Should track multiple handlers for same event');
-    });
-});
-describe('CDPHandlerRegistry - Cleanup', () => {
-    test('cleanup removes all handlers', () => {
-        const registry = new CDPHandlerRegistry();
-        const mockCDP = createMockCDP();
-        registry.register(mockCDP, 'Network.requestWillBeSent', () => { });
-        registry.register(mockCDP, 'Network.loadingFinished', () => { });
-        registry.cleanup();
-        // Contract: after cleanup, size should be 0
-        assert.equal(registry.size(), 0, 'Cleanup should clear all handlers');
-    });
-    test('cleanup calls all cleanup functions', () => {
-        const registry = new CDPHandlerRegistry();
-        const cleanupCalls = [];
-        const mockCDP = createMockCDP();
-        mockCDP.on = (event) => {
-            // Return cleanup function that tracks which event was cleaned up
-            return () => cleanupCalls.push(event);
-        };
-        registry.register(mockCDP, 'Network.requestWillBeSent', () => { });
-        registry.register(mockCDP, 'Console.messageAdded', () => { });
-        registry.cleanup();
-        // Contract: cleanup must call all cleanup functions
-        assert.equal(cleanupCalls.length, 2, 'Should call cleanup for each handler');
-        assert.deepEqual(cleanupCalls, ['Network.requestWillBeSent', 'Console.messageAdded'], 'Should cleanup handlers in registration order');
-    });
-    test('cleanup on empty registry is safe', () => {
-        const registry = new CDPHandlerRegistry();
-        // Should not throw
-        assert.doesNotThrow(() => {
-            registry.cleanup();
-        }, 'Cleanup on empty registry should be safe');
-    });
-    test('cleanup can be called multiple times', () => {
-        const registry = new CDPHandlerRegistry();
-        const mockCDP = createMockCDP();
-        registry.register(mockCDP, 'Network.requestWillBeSent', () => { });
-        registry.cleanup();
-        registry.cleanup(); // Second cleanup
-        assert.equal(registry.size(), 0, 'Multiple cleanups should be safe');
-    });
-    test('size is zero after cleanup', () => {
-        const registry = new CDPHandlerRegistry();
-        const mockCDP = createMockCDP();
-        registry.register(mockCDP, 'Network.requestWillBeSent', () => { });
-        registry.register(mockCDP, 'Network.loadingFinished', () => { });
-        registry.register(mockCDP, 'Console.messageAdded', () => { });
-        assert.equal(registry.size(), 3, 'Pre-cleanup: should have 3 handlers');
-        registry.cleanup();
-        assert.equal(registry.size(), 0, 'Post-cleanup: should have 0 handlers');
-    });
-});
-describe('CDPHandlerRegistry - Reusability', () => {
-    test('can register new handlers after cleanup', () => {
-        const registry = new CDPHandlerRegistry();
-        const mockCDP = createMockCDP();
-        // First batch
-        registry.register(mockCDP, 'Network.requestWillBeSent', () => { });
-        registry.cleanup();
-        // Second batch
-        registry.register(mockCDP, 'Console.messageAdded', () => { });
-        registry.register(mockCDP, 'Page.loadEventFired', () => { });
-        assert.equal(registry.size(), 2, 'Should track new handlers after cleanup');
-    });
-    test('cleanup only affects registered handlers, not future ones', () => {
-        const registry = new CDPHandlerRegistry();
-        const mockCDP = createMockCDP();
-        const cleanupCalls = [];
-        mockCDP.on = (event) => {
-            return () => cleanupCalls.push(event);
-        };
-        registry.register(mockCDP, 'Network.requestWillBeSent', () => { });
-        assert.equal(registry.size(), 1, 'Should have 1 handler before first cleanup');
-        registry.cleanup();
-        assert.equal(registry.size(), 0, 'Should have 0 handlers after first cleanup');
-        assert.equal(cleanupCalls.length, 1, 'First cleanup should call 1 cleanup function');
-        registry.register(mockCDP, 'Console.messageAdded', () => { }); // After cleanup
-        assert.equal(registry.size(), 1, 'Should have 1 new handler');
-        registry.cleanup(); // Second cleanup
-        assert.equal(registry.size(), 0, 'Should have 0 handlers after second cleanup');
-        // Contract: Each cleanup only affects handlers registered before it
-        assert.equal(cleanupCalls.length, 2, 'Should have two cleanup calls total');
-        assert.equal(cleanupCalls[0], 'Network.requestWillBeSent', 'First cleanup removes Network handler');
-        assert.equal(cleanupCalls[1], 'Console.messageAdded', 'Second cleanup removes Console handler');
-    });
-});
-describe('CDPHandlerRegistry - Type-Safe API (registerTyped)', () => {
-    test('registerTyped tracks handlers correctly', () => {
-        const registry = new CDPHandlerRegistry();
-        const mockCDP = createMockCDP();
-        const typed = new TypedCDPConnection(mockCDP);
-        registry.registerTyped(typed, 'Network.requestWillBeSent', () => { });
-        registry.registerTyped(typed, 'Console.messageAdded', () => { });
-        assert.equal(registry.size(), 2, 'Should track typed handlers');
-    });
-    test('cleanup works with typed handlers', () => {
-        const registry = new CDPHandlerRegistry();
-        const mockCDP = createMockCDP();
-        const typed = new TypedCDPConnection(mockCDP);
-        registry.registerTyped(typed, 'Network.requestWillBeSent', () => { });
-        registry.registerTyped(typed, 'Network.loadingFinished', () => { });
-        registry.cleanup();
-        assert.equal(registry.size(), 0, 'Cleanup should remove typed handlers');
-    });
-    test('can mix legacy and typed handler registration', () => {
-        const registry = new CDPHandlerRegistry();
-        const mockCDP = createMockCDP();
-        const typed = new TypedCDPConnection(mockCDP);
-        registry.register(mockCDP, 'Network.requestWillBeSent', () => { }); // Legacy
-        registry.registerTyped(typed, 'Console.messageAdded', () => { }); // Typed
-        assert.equal(registry.size(), 2, 'Should track both legacy and typed handlers');
-    });
-    test('cleanup removes both legacy and typed handlers', () => {
-        const registry = new CDPHandlerRegistry();
-        const cleanupCalls = [];
-        const mockCDP = createMockCDP();
-        mockCDP.on = (event) => {
-            return () => cleanupCalls.push(event);
-        };
-        const typed = new TypedCDPConnection(mockCDP);
-        registry.register(mockCDP, 'Network.requestWillBeSent', () => { });
-        registry.registerTyped(typed, 'Console.messageAdded', () => { });
-        assert.equal(registry.size(), 2, 'Should have 2 handlers before cleanup');
-        registry.cleanup();
-        assert.equal(cleanupCalls.length, 2, 'Should cleanup both handler types');
-        assert.equal(registry.size(), 0, 'Size should be zero after mixed cleanup');
-    });
-});
-describe('CDPHandlerRegistry - Cleanup Function Management', () => {
-    test('calls cleanup functions correctly', () => {
-        const registry = new CDPHandlerRegistry();
-        const mockCDP = createMockCDP();
-        const cleanupCalls = [];
-        // Mock returns cleanup functions that track calls
-        let nextId = 100;
-        mockCDP.on = () => {
-            const id = nextId++;
-            return () => cleanupCalls.push(id);
-        };
-        registry.register(mockCDP, 'Network.requestWillBeSent', () => { });
-        registry.register(mockCDP, 'Console.messageAdded', () => { });
-        registry.cleanup();
-        // Contract: cleanup should call all cleanup functions
-        assert.deepEqual(cleanupCalls, [100, 101], 'Should call all cleanup functions');
-    });
-    test('handles duplicate handler IDs for same event', () => {
-        const registry = new CDPHandlerRegistry();
-        const mockCDP = createMockCDP();
-        // Same event, same handler function - CDP should return different IDs
-        const handler = () => { };
-        registry.register(mockCDP, 'Network.requestWillBeSent', handler);
-        registry.register(mockCDP, 'Network.requestWillBeSent', handler);
-        assert.equal(registry.size(), 2, 'Should track both handlers even if same function');
-    });
-});
-// Test Helpers
-/**
- * Create a mock CDPConnection for testing
- */
-function createMockCDP() {
-    return {
-        on: (_event, _handler) => {
-            // Return cleanup function (no-op by default)
-            return () => { };
-        },
-        off: (_event, _id) => {
-            // No-op by default (deprecated but still exists)
-        },
-    };
-}
-//# sourceMappingURL=handlers.unit.test.js.map

package/dist/connection/__tests__/handlers.unit.test.js.map

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

package/dist/connection/__tests__/pageReadiness.contract.test.d.ts

@@ -1,14 +0,0 @@
-/**
- * Contract tests for page readiness detection
- *
- * Tests the contract: wait for load → network stable → DOM stable OR timeout
- *
- * Philosophy: Test the state machine behavior using a mock CDP connection.
- * We don't test timing-sensitive behavior (exact ms), we test the sequence
- * of operations and state transitions.
- *
- * These are contract tests because they validate the multi-phase readiness
- * detection contract without caring about internal implementation.
- */
-export {};
-//# sourceMappingURL=pageReadiness.contract.test.d.ts.map

package/dist/connection/__tests__/pageReadiness.contract.test.d.ts.map

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

package/dist/connection/__tests__/pageReadiness.contract.test.js

@@ -1,382 +0,0 @@
-/**
- * Contract tests for page readiness detection
- *
- * Tests the contract: wait for load → network stable → DOM stable OR timeout
- *
- * Philosophy: Test the state machine behavior using a mock CDP connection.
- * We don't test timing-sensitive behavior (exact ms), we test the sequence
- * of operations and state transitions.
- *
- * These are contract tests because they validate the multi-phase readiness
- * detection contract without caring about internal implementation.
- */
-import assert from 'node:assert/strict';
-import { describe, test } from 'node:test';
-import { waitForPageReady } from '../../connection/pageReadiness.js';
-describe('Page Readiness - Happy Path', () => {
-    test('waits through all three phases (load → network → DOM)', async () => {
-        const phases = [];
-        const mockCDP = createMockCDP({
-            onSend: (method) => {
-                phases.push(method);
-            },
-            loadEventAlreadyFired: false,
-            networkQuiet: true,
-            domStable: true,
-        });
-        await waitForPageReady(mockCDP);
-        // Contract: should enable Page and Network domains
-        assert.ok(phases.includes('Page.enable'), 'Should enable Page domain');
-        assert.ok(phases.includes('Network.enable'), 'Should enable Network domain');
-        // Contract: should check document.readyState
-        assert.ok(phases.some((p) => p.includes('Runtime.evaluate')), 'Should check document readiness');
-    });
-    test('handles page where load event already fired', async () => {
-        const mockCDP = createMockCDP({
-            loadEventAlreadyFired: true,
-            networkQuiet: true,
-            domStable: true,
-        });
-        // Contract: should not wait for load event if already complete
-        await waitForPageReady(mockCDP);
-        // Should complete without error
-        assert.ok(true, 'Should handle already-loaded page');
-    });
-    test('proceeds when network stabilizes', async () => {
-        const mockCDP = createMockCDP({
-            loadEventAlreadyFired: true,
-            networkQuiet: true,
-            domStable: true,
-        });
-        await waitForPageReady(mockCDP);
-        // Should complete network phase
-        assert.ok(true, 'Should proceed when network is stable');
-    });
-    test('proceeds when DOM stabilizes', async () => {
-        const mockCDP = createMockCDP({
-            loadEventAlreadyFired: true,
-            networkQuiet: true,
-            domStable: true,
-        });
-        await waitForPageReady(mockCDP);
-        // Should complete DOM phase
-        assert.ok(true, 'Should proceed when DOM is stable');
-    });
-});
-describe('Page Readiness - Timeout Behavior', () => {
-    test('proceeds on timeout without throwing', async () => {
-        const mockCDP = createMockCDP({
-            loadEventAlreadyFired: false,
-            networkQuiet: false, // Never becomes quiet
-            domStable: false, // Never stabilizes
-            delayLoadEvent: true, // Delay to trigger timeout
-        });
-        // Contract: should NOT throw on timeout, should proceed anyway
-        await assert.doesNotReject(async () => {
-            await waitForPageReady(mockCDP, { maxWaitMs: 100 });
-        }, 'Should not throw on timeout');
-    });
-    test('respects custom maxWaitMs option', async () => {
-        const mockCDP = createMockCDP({
-            loadEventAlreadyFired: false,
-            networkQuiet: false,
-            domStable: false,
-            delayLoadEvent: true,
-        });
-        const start = Date.now();
-        await waitForPageReady(mockCDP, { maxWaitMs: 200 });
-        const duration = Date.now() - start;
-        // Should timeout around 200ms (with some tolerance for scheduling)
-        assert.ok(duration >= 150 && duration < 400, 'Should respect custom timeout');
-    });
-    test('uses default 5000ms timeout when not specified', async () => {
-        const mockCDP = createMockCDP({
-            loadEventAlreadyFired: true,
-            networkQuiet: true,
-            domStable: true,
-        });
-        const start = Date.now();
-        await waitForPageReady(mockCDP); // No options
-        const duration = Date.now() - start;
-        // Should complete quickly when stable (not wait full 5s)
-        assert.ok(duration < 1000, 'Should not wait unnecessarily when page is ready');
-    });
-});
-describe('Page Readiness - Load Event Phase', () => {
-    test('waits for Page.loadEventFired when not already loaded', async () => {
-        let loadEventFired = false;
-        const mockCDP = createMockCDP({
-            loadEventAlreadyFired: false,
-            networkQuiet: true,
-            domStable: true,
-            onEventRegistered: (event) => {
-                if (event === 'Page.loadEventFired') {
-                    // Simulate load event firing after a delay
-                    setTimeout(() => {
-                        loadEventFired = true;
-                        mockCDP.emit('Page.loadEventFired', {});
-                    }, 50);
-                }
-            },
-        });
-        await waitForPageReady(mockCDP, { maxWaitMs: 500 });
-        assert.ok(loadEventFired, 'Should wait for and receive load event');
-    });
-    test('skips waiting for load event when document.readyState is complete', async () => {
-        const events = [];
-        const mockCDP = createMockCDP({
-            loadEventAlreadyFired: true,
-            networkQuiet: true,
-            domStable: true,
-            onEventRegistered: (event) => {
-                events.push(event);
-            },
-        });
-        await waitForPageReady(mockCDP);
-        // Contract: should not register for Page.loadEventFired if already complete
-        // (though it's okay if it does register and immediately continues)
-        assert.ok(true, 'Should handle pre-loaded page');
-    });
-    test('handles Runtime.evaluate errors gracefully', async () => {
-        const mockCDP = createMockCDP({
-            loadEventAlreadyFired: false,
-            networkQuiet: true,
-            domStable: true,
-            evaluateThrows: true,
-        });
-        // Contract: should proceed even if readyState check fails
-        await assert.doesNotReject(async () => {
-            await waitForPageReady(mockCDP, { maxWaitMs: 200 });
-        }, 'Should handle evaluate errors gracefully');
-    });
-});
-describe('Page Readiness - Network Stability Phase', () => {
-    test('detects network activity via requestWillBeSent events', async () => {
-        const events = [];
-        const mockCDP = createMockCDP({
-            loadEventAlreadyFired: true,
-            networkQuiet: false,
-            domStable: true,
-            onEventRegistered: (event) => {
-                events.push(event);
-            },
-        });
-        await waitForPageReady(mockCDP, { maxWaitMs: 200 });
-        // Contract: should listen for network events
-        assert.ok(events.includes('Network.requestWillBeSent'), 'Should listen for network requests');
-        assert.ok(events.includes('Network.loadingFinished'), 'Should listen for loading finished');
-        assert.ok(events.includes('Network.loadingFailed'), 'Should listen for loading failed');
-    });
-    test('tracks active requests (requestWillBeSent increases, responses decrease)', async () => {
-        const mockCDP = createMockCDP({
-            loadEventAlreadyFired: true,
-            networkQuiet: false,
-            domStable: true,
-            onEventRegistered: (event) => {
-                if (event === 'Network.requestWillBeSent') {
-                    // Simulate request/response cycle
-                    setTimeout(() => {
-                        mockCDP.emit('Network.requestWillBeSent', {});
-                        setTimeout(() => {
-                            mockCDP.emit('Network.loadingFinished', {});
-                        }, 50);
-                    }, 30);
-                }
-            },
-        });
-        await waitForPageReady(mockCDP, { maxWaitMs: 500 });
-        // Network phase should have completed
-        assert.ok(true, 'Should track network request lifecycle');
-    });
-    test('waits for 200ms of network idle before proceeding', async () => {
-        // This test verifies the threshold concept but not exact timing
-        const mockCDP = createMockCDP({
-            loadEventAlreadyFired: true,
-            networkQuiet: true,
-            domStable: true,
-        });
-        await waitForPageReady(mockCDP);
-        // Contract: should wait for network stability (implementation uses 200ms threshold)
-        assert.ok(true, 'Should wait for network stability threshold');
-    });
-});
-describe('Page Readiness - DOM Stability Phase', () => {
-    test('injects MutationObserver into page', async () => {
-        const evaluations = [];
-        const mockCDP = createMockCDP({
-            loadEventAlreadyFired: true,
-            networkQuiet: true,
-            domStable: true,
-            onSend: (method, params) => {
-                if (method === 'Runtime.evaluate' && params?.['expression']) {
-                    evaluations.push(params['expression']);
-                }
-            },
-        });
-        await waitForPageReady(mockCDP);
-        // Contract: should inject MutationObserver
-        const hasObserver = evaluations.some((expr) => expr.includes('MutationObserver'));
-        assert.ok(hasObserver, 'Should inject MutationObserver for DOM tracking');
-    });
-    test('cleans up MutationObserver after detection', async () => {
-        const evaluations = [];
-        const mockCDP = createMockCDP({
-            loadEventAlreadyFired: true,
-            networkQuiet: true,
-            domStable: true,
-            onSend: (method, params) => {
-                if (method === 'Runtime.evaluate' && params?.['expression']) {
-                    evaluations.push(params['expression']);
-                }
-            },
-        });
-        await waitForPageReady(mockCDP);
-        // Contract: should clean up observer
-        const hasCleanup = evaluations.some((expr) => expr.includes('disconnect') || expr.includes('delete window.__bdg'));
-        assert.ok(hasCleanup, 'Should clean up MutationObserver after detection');
-    });
-    test('waits for 300ms of DOM stability before proceeding', async () => {
-        // This test verifies the threshold concept but not exact timing
-        const mockCDP = createMockCDP({
-            loadEventAlreadyFired: true,
-            networkQuiet: true,
-            domStable: true,
-        });
-        await waitForPageReady(mockCDP);
-        // Contract: should wait for DOM stability threshold (implementation uses 300ms)
-        assert.ok(true, 'Should wait for DOM stability threshold');
-    });
-    test('handles missing document.body gracefully', async () => {
-        const mockCDP = createMockCDP({
-            loadEventAlreadyFired: true,
-            networkQuiet: true,
-            domStable: true,
-            evaluateThrows: true, // Simulate errors injecting observer
-        });
-        // Contract: should handle observer injection failures
-        await assert.doesNotReject(async () => {
-            await waitForPageReady(mockCDP, { maxWaitMs: 200 });
-        }, 'Should handle missing document.body');
-    });
-});
-describe('Page Readiness - Event Handler Cleanup', () => {
-    test('removes load event listener after phase completes', async () => {
-        const offCalls = [];
-        const mockCDP = createMockCDP({
-            loadEventAlreadyFired: false,
-            networkQuiet: true,
-            domStable: true,
-            onOff: (event) => {
-                offCalls.push(event);
-            },
-        });
-        // Fire load event to complete phase
-        setTimeout(() => mockCDP.emit('Page.loadEventFired', {}), 50);
-        await waitForPageReady(mockCDP, { maxWaitMs: 500 });
-        // Contract: should clean up load event listener
-        assert.ok(offCalls.includes('Page.loadEventFired'), 'Should remove Page.loadEventFired listener');
-    });
-    test('removes network event listeners after phase completes', async () => {
-        const offCalls = [];
-        const mockCDP = createMockCDP({
-            loadEventAlreadyFired: true,
-            networkQuiet: true,
-            domStable: true,
-            onOff: (event) => {
-                offCalls.push(event);
-            },
-        });
-        await waitForPageReady(mockCDP);
-        // Contract: should clean up all network listeners
-        assert.ok(offCalls.includes('Network.requestWillBeSent'), 'Should remove requestWillBeSent listener');
-        assert.ok(offCalls.includes('Network.loadingFinished'), 'Should remove loadingFinished listener');
-        assert.ok(offCalls.includes('Network.loadingFailed'), 'Should remove loadingFailed listener');
-    });
-    test('cleans up even when timeout occurs', async () => {
-        const offCalls = [];
-        const mockCDP = createMockCDP({
-            loadEventAlreadyFired: false,
-            networkQuiet: false,
-            domStable: false,
-            delayLoadEvent: true,
-            onOff: (event) => {
-                offCalls.push(event);
-            },
-        });
-        await waitForPageReady(mockCDP, { maxWaitMs: 100 });
-        // Contract: should clean up even on timeout
-        assert.ok(offCalls.length > 0, 'Should clean up listeners even on timeout');
-    });
-});
-/**
- * Create a mock CDPConnection for testing page readiness
- */
-function createMockCDP(options = {}) {
-    const { loadEventAlreadyFired = false, domStable = true, delayLoadEvent = false, evaluateThrows = false, onSend, onEventRegistered, onOff, } = options;
-    const handlers = new Map();
-    let handlerId = 0;
-    const mock = {
-        send(method, params) {
-            onSend?.(method, params);
-            if (method === 'Page.enable' || method === 'Network.enable') {
-                return Promise.resolve({});
-            }
-            if (method === 'Runtime.evaluate') {
-                if (evaluateThrows) {
-                    throw new Error('Evaluation failed');
-                }
-                const expression = params?.['expression'];
-                // Mock document.readyState check
-                if (expression?.includes('document.readyState')) {
-                    return Promise.resolve({
-                        result: {
-                            value: loadEventAlreadyFired ? 'complete' : 'loading',
-                        },
-                    });
-                }
-                // Mock MutationObserver injection
-                if (expression?.includes('MutationObserver')) {
-                    return Promise.resolve({ result: {} });
-                }
-                // Mock DOM stability check
-                if (expression?.includes('__bdg_lastMutation')) {
-                    const timeSinceLastMutation = domStable ? 500 : 0; // 500ms > 300ms threshold
-                    return Promise.resolve({
-                        result: {
-                            value: timeSinceLastMutation,
-                        },
-                    });
-                }
-                return Promise.resolve({ result: {} });
-            }
-            return Promise.resolve({});
-        },
-        on(event, handler) {
-            onEventRegistered?.(event);
-            if (!handlers.has(event)) {
-                handlers.set(event, new Map());
-            }
-            const id = handlerId++;
-            handlers.get(event)?.set(id, handler);
-            // Auto-fire load event if configured
-            if (event === 'Page.loadEventFired' && !delayLoadEvent) {
-                setTimeout(() => {
-                    handler({});
-                }, 10);
-            }
-            return () => this.off(event, id);
-        },
-        off(event, id) {
-            onOff?.(event);
-            handlers.get(event)?.delete(id);
-        },
-        emit(event, params) {
-            const eventHandlers = handlers.get(event);
-            if (eventHandlers) {
-                eventHandlers.forEach((handler) => handler(params));
-            }
-        },
-    };
-    return mock;
-}
-//# sourceMappingURL=pageReadiness.contract.test.js.map