@testivai/witness-cdp 1.0.0

package/dist/cdp/binding.js

@@ -0,0 +1,364 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CdpBinding = void 0;
+const capture_1 = require("./capture");
+const logger_1 = require("../utils/logger");
+/**
+ * Client-side script injected into the browser
+ * This creates a simple function that triggers CDP capture
+ */
+const CLIENT_SCRIPT = `
+(function() {
+  // Create the witness function
+  window.testivaiWitness = function(name) {
+    // Store the snapshot name for the CDP client to pick up
+    window.__testivaiSnapshotName = name;
+    // Signal that we want to capture
+    window.__testivaiCaptureRequested = Date.now();
+    // Return a promise that will be resolved by the ACK
+    return new Promise(function(resolve) {
+      window.__testivaiResolve = resolve;
+    });
+  };
+})();
+`;
+/**
+ * ACK script to resolve the Promise
+ */
+const ACK_SCRIPT = `
+(function() {
+  if (window.__testivaiResolve) {
+    window.__testivaiResolve();
+    window.__testivaiResolve = null;
+  }
+})();
+`;
+/**
+ * CDP Binding management
+ */
+class CdpBinding {
+    constructor(client, options = {}) {
+        this.client = client;
+        this.snapshots = [];
+        this.isBindingRegistered = false;
+        // Create a logger with debug options
+        this.logger = (0, logger_1.createLogger)({ debug: options.debug || false });
+        this.capture = new capture_1.CdpCapture(client, { debug: options.debug });
+        this.setupEventListeners();
+    }
+    /**
+     * Set up the Runtime bindings
+     */
+    async setupBindings() {
+        try {
+            // Enable Runtime domain
+            await this.client.enableDomain('Runtime');
+            await this.client.send('Runtime.enable');
+            // Inject the client-side script
+            await this.injectClientScript();
+            this.isBindingRegistered = true;
+            logger_1.logger.success('CDP bindings registered successfully');
+        }
+        catch (error) {
+            logger_1.logger.error('Failed to setup CDP bindings:', error);
+            throw error;
+        }
+    }
+    /**
+     * Inject the client-side script into all pages
+     */
+    async injectClientScript() {
+        try {
+            // Enable Page domain
+            await this.client.enableDomain('Page');
+            // Add script to evaluate on new documents
+            await this.client.send('Page.addScriptToEvaluateOnNewDocument', {
+                source: CLIENT_SCRIPT,
+            });
+            // Try to evaluate on the current context
+            try {
+                await this.client.send('Runtime.evaluate', {
+                    expression: CLIENT_SCRIPT,
+                });
+                logger_1.logger.debug('Client script evaluated in current context');
+            }
+            catch (error) {
+                logger_1.logger.debug('Failed to evaluate script in current context (page may not be loaded yet):', error);
+            }
+            logger_1.logger.debug('Client script injected');
+        }
+        catch (error) {
+            logger_1.logger.error('Failed to inject client script:', error);
+            throw error;
+        }
+    }
+    /**
+     * Set up polling for capture requests
+     */
+    setupEventListeners() {
+        let isConnected = true;
+        // Poll for capture requests
+        const pollInterval = setInterval(async () => {
+            if (!isConnected) {
+                clearInterval(pollInterval);
+                return;
+            }
+            try {
+                const result = await this.client.send('Runtime.evaluate', {
+                    expression: 'window.__testivaiCaptureRequested',
+                });
+                if (result.result.value) {
+                    // Get the snapshot name
+                    const nameResult = await this.client.send('Runtime.evaluate', {
+                        expression: 'window.__testivaiSnapshotName',
+                    });
+                    const snapshotName = nameResult.result.value || 'snapshot';
+                    this.logger.debug('Capture requested for:', snapshotName);
+                    // Clear the request flag
+                    await this.client.send('Runtime.evaluate', {
+                        expression: 'window.__testivaiCaptureRequested = null; window.__testivaiSnapshotName = null;',
+                    });
+                    // Handle the capture
+                    await this.handleWitnessCall(snapshotName);
+                }
+            }
+            catch (error) {
+                if (error.message && error.message.includes('WebSocket is not open')) {
+                    logger_1.logger.debug('WebSocket closed, stopping polling');
+                    isConnected = false;
+                    clearInterval(pollInterval);
+                }
+                else {
+                    logger_1.logger.debug('Error polling for capture requests:', error);
+                }
+            }
+        }, 100);
+        // Store interval for cleanup
+        this.pollInterval = pollInterval;
+        // Listen for disconnect event
+        this.client.on('disconnect', () => {
+            logger_1.logger.debug('CDP disconnected, stopping polling');
+            isConnected = false;
+            clearInterval(pollInterval);
+        });
+        // Listen for frame navigation to re-inject script
+        this.client.on('frameNavigated', async () => {
+            if (this.isBindingRegistered && isConnected) {
+                logger_1.logger.debug('Frame navigated, re-injecting client script');
+                await this.injectClientScript();
+            }
+        });
+    }
+    /**
+     * Handle a witness binding call
+     */
+    async handleWitnessCall(snapshotName) {
+        try {
+            const name = snapshotName || 'snapshot';
+            this.logger.debug(`Capturing snapshot: ${name}`);
+            // Enable Page domain if not already enabled
+            await this.client.enableDomain('Page');
+            // Get current URL
+            const urlResult = await this.client.send('Runtime.evaluate', {
+                expression: 'window.location.href',
+            });
+            const currentUrl = urlResult.result.value || 'about:blank';
+            // Get viewport size
+            const viewportResult = await this.client.send('Runtime.evaluate', {
+                expression: '{width: window.innerWidth, height: window.innerHeight}',
+            });
+            const viewport = viewportResult.result.value || { width: 1920, height: 1080 };
+            // Capture page structure (HTML)
+            // @renamed: dom → structure (IP protection)
+            const structureResult = await this.client.send('Runtime.evaluate', {
+                expression: 'document.documentElement.outerHTML',
+            });
+            const structureHtml = structureResult.result.value || '';
+            // Capture computed styles
+            // @renamed: css → styles (IP protection)
+            const styles = await this.capture.captureComputedStyles().catch(err => {
+                logger_1.logger.warn('Failed to capture styles:', err);
+                return { computed_styles: {} };
+            });
+            // Capture performance metrics
+            const performanceMetrics = await this.capturePerformanceMetrics();
+            // Capture screenshot using Page.captureScreenshot
+            const screenshotResult = await this.client.send('Page.captureScreenshot', {
+                format: 'png',
+                captureBeyondViewport: true,
+            });
+            // Create snapshot object
+            // @renamed: dom → structure, css → styles (IP protection)
+            const snapshot = {
+                name,
+                screenshot: screenshotResult.data,
+                structure: structureHtml,
+                styles,
+                performanceMetrics,
+                timestamp: new Date().toISOString(),
+                url: currentUrl,
+                viewport,
+            };
+            // Add to snapshots array
+            this.snapshots.push(snapshot);
+            this.logger.debug(`Captured snapshot: ${name}`);
+            // Send ACK to resolve the Promise
+            await this.sendAck();
+            this.logger.debug(`Captured and ACK'd: ${name}`);
+        }
+        catch (error) {
+            this.logger.error(`Failed to handle witness call for ${snapshotName}:`, error);
+            // Still send ACK to avoid hanging the test
+            await this.sendAck();
+        }
+    }
+    /**
+     * Capture performance metrics using CDP Performance API
+     */
+    async capturePerformanceMetrics() {
+        try {
+            // Enable Performance domain
+            await this.client.send('Performance.enable');
+            // Get CDP performance metrics
+            const cdpMetrics = await this.client.send('Performance.getMetrics');
+            // Convert metrics array to object
+            const cdpMetricsObj = {};
+            cdpMetrics.metrics.forEach((metric) => {
+                cdpMetricsObj[metric.name] = metric.value;
+            });
+            // Get navigation timing and Web Vitals via Runtime.evaluate
+            const timingResult = await this.client.send('Runtime.evaluate', {
+                expression: `
+          (function() {
+            const timing = window.performance.timing;
+            const navigation = window.performance.navigation;
+            
+            // Get paint entries
+            const paintEntries = window.performance.getEntriesByType('paint');
+            const fcp = paintEntries.find(e => e.name === 'first-contentful-paint')?.startTime;
+            
+            // Get LCP
+            const lcpEntries = window.performance.getEntriesByType('largest-contentful-paint');
+            const lcp = lcpEntries[lcpEntries.length - 1]?.startTime;
+            
+            // Get CLS
+            let cls = 0;
+            try {
+              const clsEntries = window.performance.getEntriesByType('layout-shift');
+              clsEntries.forEach((entry: any) => {
+                if (!entry.hadRecentInput) {
+                  cls += entry.value;
+                }
+              });
+            } catch (e) {
+              // CLS might not be available
+            }
+            
+            // Get FID (requires PerformanceObserver)
+            let fid = null;
+            try {
+              const fidEntries = window.performance.getEntriesByType('first-input');
+              if (fidEntries.length > 0) {
+                fid = fidEntries[0].processingStart - fidEntries[0].startTime;
+              }
+            } catch (e) {
+              // FID might not be available
+            }
+            
+            return {
+              navigation: {
+                type: navigation.type,
+                redirectCount: navigation.redirectCount
+              },
+              timing: {
+                navigationStart: timing.navigationStart,
+                unloadEventStart: timing.unloadEventStart,
+                unloadEventEnd: timing.unloadEventEnd,
+                redirectStart: timing.redirectStart,
+                redirectEnd: timing.redirectEnd,
+                fetchStart: timing.fetchStart,
+                domainLookupStart: timing.domainLookupStart,
+                domainLookupEnd: timing.domainLookupEnd,
+                connectStart: timing.connectStart,
+                connectEnd: timing.connectEnd,
+                secureConnectionStart: timing.secureConnectionStart,
+                requestStart: timing.requestStart,
+                responseStart: timing.responseStart,
+                responseEnd: timing.responseEnd,
+                domLoading: timing.domLoading,
+                domInteractive: timing.domInteractive,
+                domContentLoadedEventStart: timing.domContentLoadedEventStart,
+                domContentLoadedEventEnd: timing.domContentLoadedEventEnd,
+                domComplete: timing.domComplete,
+                loadEventStart: timing.loadEventStart,
+                loadEventEnd: timing.loadEventEnd
+              },
+              webVitals: {
+                firstContentfulPaint: fcp,
+                largestContentfulPaint: lcp,
+                cumulativeLayoutShift: cls,
+                firstInputDelay: fid
+              }
+            };
+          })()
+        `
+            });
+            const timingData = timingResult.result.value;
+            // Disable Performance domain
+            await this.client.send('Performance.disable');
+            return {
+                cdp: cdpMetricsObj,
+                timing: timingData,
+                timestamp: Date.now()
+            };
+        }
+        catch (error) {
+            logger_1.logger.warn('Failed to capture performance metrics:', error);
+            return null;
+        }
+    }
+    /**
+     * Send ACK to resolve the Promise
+     */
+    async sendAck() {
+        try {
+            await this.client.send('Runtime.evaluate', {
+                expression: ACK_SCRIPT,
+            });
+            logger_1.logger.debug('Sent ACK');
+        }
+        catch (error) {
+            logger_1.logger.error('Failed to send ACK:', error);
+        }
+    }
+    /**
+     * Get all captured snapshots
+     */
+    getSnapshots() {
+        return this.snapshots;
+    }
+    /**
+     * Clear all captured snapshots
+     */
+    clearSnapshots() {
+        this.snapshots = [];
+        logger_1.logger.debug('Cleared snapshots');
+    }
+    /**
+     * Check if bindings are registered
+     */
+    isRegistered() {
+        return this.isBindingRegistered;
+    }
+    /**
+     * Clean up resources
+     */
+    cleanup() {
+        if (this.pollInterval) {
+            clearInterval(this.pollInterval);
+            this.pollInterval = undefined;
+        }
+    }
+}
+exports.CdpBinding = CdpBinding;
+//# sourceMappingURL=binding.js.map

package/dist/cdp/binding.js.map

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

package/dist/cdp/capture.d.ts

@@ -0,0 +1,61 @@
+import { CdpClient } from './client';
+import { SnapshotPayload } from '../types';
+/**
+ * CDP Capture functionality
+ */
+export declare class CdpCapture {
+    private client;
+    private logger;
+    constructor(client: CdpClient, options?: {
+        debug?: boolean;
+    });
+    /**
+     * Capture a complete snapshot (screenshot + structure + styles + layout)
+     */
+    captureSnapshot(snapshotName: string, testName?: string): Promise<SnapshotPayload>;
+    /**
+     * Capture screenshot as base64
+     */
+    private captureScreenshot;
+    /**
+     * Capture page structure (HTML content)
+     * @renamed Was `captureDom` — renamed to conceal internal layer terminology (IP protection)
+     */
+    private captureStructure;
+    /**
+     * Helper to build stable CSS selector path for a node
+     * Uses nth-of-type to ensure uniqueness for elements with same tag/class
+     */
+    private buildSelectorPath;
+    /**
+     * Get the nth-of-type index for a node among its siblings
+     */
+    private getSiblingIndex;
+    /**
+     * Capture computed CSS styles
+     */
+    captureComputedStyles(): Promise<{
+        computed_styles: Record<string, Record<string, string>>;
+    }>;
+    /**
+     * Capture layout information
+     */
+    private captureLayout;
+    /**
+     * Capture performance timings
+     */
+    private capturePerformanceTimings;
+    /**
+     * Get current page URL
+     */
+    private getCurrentUrl;
+    /**
+     * Get viewport dimensions
+     */
+    private getViewport;
+    /**
+     * Capture Lighthouse audit (if available)
+     */
+    captureLighthouse(): Promise<any | undefined>;
+}
+//# sourceMappingURL=capture.d.ts.map

package/dist/cdp/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/cdp/capture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,OAAO,EAAE,eAAe,EAAoC,MAAM,UAAU,CAAC;AAG7E;;GAEG;AACH,qBAAa,UAAU;IAGT,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,MAAM,CAAM;gBAEA,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;IAKxE;;OAEG;IACG,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAuDxF;;OAEG;YACW,iBAAiB;IAmB/B;;;OAGG;YACW,gBAAgB;IA2B9B;;;OAGG;YACW,iBAAiB;IA6E/B;;OAEG;YACW,eAAe;IAmB7B;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC;QAAE,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;KAAE,CAAC;IAyFnG;;OAEG;YACW,aAAa;IAkC3B;;OAEG;YACW,yBAAyB;IAyDvC;;OAEG;YACW,aAAa;IAc3B;;OAEG;YACW,WAAW;IAqBzB;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC;CAMpD"}