@testivai/witness-cdp 0.1.0

package/dist/cdp/capture.d.ts

@@ -0,0 +1,42 @@
+import { CdpClient } from './client';
+import { SnapshotPayload } from '../types';
+/**
+ * CDP Capture functionality
+ */
+export declare class CdpCapture {
+    private client;
+    constructor(client: CdpClient);
+    /**
+     * Capture a complete snapshot (screenshot + DOM + layout)
+     */
+    captureSnapshot(snapshotName: string, testName?: string): Promise<SnapshotPayload>;
+    /**
+     * Capture screenshot as base64
+     */
+    private captureScreenshot;
+    /**
+     * Capture DOM content
+     */
+    private captureDom;
+    /**
+     * 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,EAAkC,MAAM,UAAU,CAAC;AAG3E;;GAEG;AACH,qBAAa,UAAU;IACT,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,SAAS;IAErC;;OAEG;IACG,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAuCxF;;OAEG;YACW,iBAAiB;IAmB/B;;OAEG;YACW,UAAU;IA2BxB;;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"}

package/dist/cdp/capture.js

@@ -0,0 +1,235 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CdpCapture = void 0;
+const logger_1 = require("../utils/logger");
+const common_1 = require("@testivai/common");
+/**
+ * CDP Capture functionality
+ */
+class CdpCapture {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Capture a complete snapshot (screenshot + DOM + layout)
+     */
+    async captureSnapshot(snapshotName, testName) {
+        const timestamp = Date.now();
+        logger_1.logger.capture(snapshotName);
+        // Get current URL
+        const url = await this.getCurrentUrl();
+        // Get viewport information
+        const viewport = await this.getViewport();
+        // Capture screenshot
+        const screenshotData = await this.captureScreenshot();
+        // Capture DOM
+        const dom = await this.captureDom();
+        // Capture layout
+        const layout = await this.captureLayout();
+        // Capture performance timings (optional)
+        const performanceTimings = await this.capturePerformanceTimings();
+        const snapshot = {
+            dom,
+            layout,
+            timestamp,
+            testName: testName || 'test',
+            snapshotName,
+            url,
+            viewport,
+            screenshotData,
+            performanceTimings,
+        };
+        logger_1.logger.debug(`Captured snapshot: ${snapshotName}`);
+        return snapshot;
+    }
+    /**
+     * Capture screenshot as base64
+     */
+    async captureScreenshot() {
+        try {
+            const result = await this.client.send('Page.captureScreenshot', {
+                format: 'png',
+                fromSurface: true,
+                captureBeyondViewport: true,
+            });
+            if (!result.data) {
+                throw new Error('No screenshot data received');
+            }
+            return result.data;
+        }
+        catch (error) {
+            logger_1.logger.error('Failed to capture screenshot:', error);
+            throw error;
+        }
+    }
+    /**
+     * Capture DOM content
+     */
+    async captureDom() {
+        try {
+            // Get document root
+            const { root } = await this.client.send('DOM.getDocument');
+            // Get outer HTML of the document
+            const result = await this.client.send('DOM.getOuterHTML', {
+                nodeId: root.nodeId,
+            });
+            if (!result.outerHTML) {
+                throw new Error('No DOM content received');
+            }
+            // Try to compress if large
+            const compressionResult = await common_1.compressionHelper.compress(result.outerHTML);
+            const html = typeof compressionResult.data === 'string'
+                ? compressionResult.data
+                : compressionResult.data.toString('utf-8');
+            return { html };
+        }
+        catch (error) {
+            logger_1.logger.error('Failed to capture DOM:', error);
+            throw error;
+        }
+    }
+    /**
+     * Capture layout information
+     */
+    async captureLayout() {
+        try {
+            // Get layout of the body element using getBoundingClientRect
+            const result = await this.client.send('Runtime.evaluate', {
+                expression: `
+          (function() {
+            const body = document.body;
+            const rect = body.getBoundingClientRect();
+            return {
+              x: rect.x,
+              y: rect.y,
+              width: rect.width,
+              height: rect.height,
+              top: rect.top,
+              left: rect.left,
+              right: rect.right,
+              bottom: rect.bottom
+            };
+          })()
+        `,
+                returnByValue: true,
+            });
+            if (!result.result.value) {
+                throw new Error('No layout data received');
+            }
+            return result.result.value;
+        }
+        catch (error) {
+            logger_1.logger.error('Failed to capture layout:', error);
+            throw error;
+        }
+    }
+    /**
+     * Capture performance timings
+     */
+    async capturePerformanceTimings() {
+        try {
+            const result = await this.client.send('Runtime.evaluate', {
+                expression: `
+          (function() {
+            const timing = performance.timing;
+            const navigation = performance.navigation;
+            
+            // Calculate metrics
+            const metrics = {
+              navigationStart: timing.navigationStart,
+              domContentLoaded: timing.domContentLoadedEventEnd - timing.navigationStart,
+              loadComplete: timing.loadEventEnd - timing.navigationStart,
+            };
+            
+            // Try to get Web Vitals if available
+            if (window.performance && window.performance.getEntriesByType) {
+              const paintEntries = performance.getEntriesByType('paint');
+              if (paintEntries) {
+                paintEntries.forEach((entry) => {
+                  if (entry.name === 'first-contentful-paint') {
+                    metrics.firstContentfulPaint = entry.startTime;
+                  }
+                });
+              }
+              
+              const lcpEntries = performance.getEntriesByType('largest-contentful-paint');
+              if (lcpEntries && lcpEntries.length > 0) {
+                metrics.largestContentfulPaint = lcpEntries[lcpEntries.length - 1].startTime;
+              }
+              
+              const clsEntries = performance.getEntriesByType('layout-shift');
+              if (clsEntries) {
+                let clsValue = 0;
+                clsEntries.forEach((entry) => {
+                  if (!entry.hadRecentInput) {
+                    clsValue += entry.value;
+                  }
+                });
+                metrics.cumulativeLayoutShift = clsValue;
+              }
+            }
+            
+            return metrics;
+          })()
+        `,
+                returnByValue: true,
+            });
+            return result.result.value;
+        }
+        catch (error) {
+            logger_1.logger.debug('Failed to capture performance timings:', error);
+            // Performance capture is optional, so don't throw
+            return undefined;
+        }
+    }
+    /**
+     * Get current page URL
+     */
+    async getCurrentUrl() {
+        try {
+            const result = await this.client.send('Runtime.evaluate', {
+                expression: 'window.location.href',
+                returnByValue: true,
+            });
+            return result.result.value || 'about:blank';
+        }
+        catch (error) {
+            logger_1.logger.debug('Failed to get current URL:', error);
+            return 'unknown';
+        }
+    }
+    /**
+     * Get viewport dimensions
+     */
+    async getViewport() {
+        try {
+            const result = await this.client.send('Runtime.evaluate', {
+                expression: `
+          (function() {
+            return {
+              width: window.innerWidth,
+              height: window.innerHeight
+            };
+          })()
+        `,
+                returnByValue: true,
+            });
+            return result.result.value || { width: 0, height: 0 };
+        }
+        catch (error) {
+            logger_1.logger.debug('Failed to get viewport:', error);
+            return { width: 0, height: 0 };
+        }
+    }
+    /**
+     * Capture Lighthouse audit (if available)
+     */
+    async captureLighthouse() {
+        // Lighthouse capture is not implemented in CDP SDK
+        // This would require additional setup and dependencies
+        // Returning undefined for now
+        return undefined;
+    }
+}
+exports.CdpCapture = CdpCapture;
+//# sourceMappingURL=capture.js.map

package/dist/cdp/capture.js.map

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

package/dist/cdp/client.d.ts

@@ -0,0 +1,63 @@
+import { Client } from 'chrome-remote-interface';
+import { EventEmitter } from 'events';
+import { CdpConnectionInfo } from '../types';
+/**
+ * Chrome DevTools Protocol client wrapper
+ */
+export declare class CdpClient extends EventEmitter {
+    private client;
+    private connectionInfo;
+    private isConnected;
+    private reconnectAttempts;
+    private maxReconnectAttempts;
+    private reconnectDelay;
+    /**
+     * Connect to Chrome DevTools Protocol
+     */
+    connect(port?: number): Promise<void>;
+    /**
+     * Disconnect from CDP
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if connected
+     */
+    isClientConnected(): boolean;
+    /**
+     * Get the raw CDP client
+     */
+    getClient(): Client | null;
+    /**
+     * Get connection info
+     */
+    getConnectionInfo(): CdpConnectionInfo | null;
+    /**
+     * Enable a domain
+     */
+    enableDomain(domain: string): Promise<void>;
+    /**
+     * Send a command to CDP
+     */
+    send<T = any>(method: string, params?: any): Promise<T>;
+    /**
+     * Get available targets (tabs/pages)
+     */
+    getTargets(): Promise<any[]>;
+    /**
+     * Attach to a specific target
+     */
+    attachToTarget(targetId: string): Promise<void>;
+    /**
+     * Create a new tab
+     */
+    createTarget(url?: string): Promise<string>;
+    /**
+     * Close a target
+     */
+    closeTarget(targetId: string): Promise<void>;
+    /**
+     * Set up event listeners for specific domains
+     */
+    setupEventListeners(): void;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/cdp/client.ts"],"names":[],"mappings":"AAAA,OAAY,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C;;GAEG;AACH,qBAAa,SAAU,SAAQ,YAAY;IACzC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,cAAc,CAAkC;IACxD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,cAAc,CAAO;IAE7B;;OAEG;IACG,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgD3C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAejC;;OAEG;IACH,iBAAiB,IAAI,OAAO;IAI5B;;OAEG;IACH,SAAS,IAAI,MAAM,GAAG,IAAI;IAI1B;;OAEG;IACH,iBAAiB,IAAI,iBAAiB,GAAG,IAAI;IAI7C;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcjD;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAe7D;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAelC;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAerD;;OAEG;IACG,YAAY,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBhE;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAelD;;OAEG;IACH,mBAAmB,IAAI,IAAI;CA8C5B"}

package/dist/cdp/client.js

@@ -0,0 +1,279 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CdpClient = void 0;
+const chrome_remote_interface_1 = __importDefault(require("chrome-remote-interface"));
+const events_1 = require("events");
+const logger_1 = require("../utils/logger");
+/**
+ * Chrome DevTools Protocol client wrapper
+ */
+class CdpClient extends events_1.EventEmitter {
+    constructor() {
+        super(...arguments);
+        this.client = null;
+        this.connectionInfo = null;
+        this.isConnected = false;
+        this.reconnectAttempts = 0;
+        this.maxReconnectAttempts = 3;
+        this.reconnectDelay = 500;
+    }
+    /**
+     * Connect to Chrome DevTools Protocol
+     */
+    async connect(port) {
+        try {
+            // Import here to avoid issues if chrome-remote-interface is not available
+            const { CdpDiscovery } = await Promise.resolve().then(() => __importStar(require('./discovery')));
+            // Discover CDP endpoint
+            this.connectionInfo = await CdpDiscovery.discover(port);
+            // Connect to the WebSocket
+            this.client = await (0, chrome_remote_interface_1.default)({
+                target: this.connectionInfo.webSocketDebuggerUrl,
+            });
+            // Set up event handlers
+            if (this.client) {
+                this.client.on('disconnect', () => {
+                    this.isConnected = false;
+                    this.emit('disconnect');
+                    logger_1.logger.debug('CDP client disconnected');
+                });
+                this.client.on('event', (method, params) => {
+                    this.emit('event', method, params);
+                });
+            }
+            this.isConnected = true;
+            this.reconnectAttempts = 0;
+            logger_1.logger.connected(port || 9222);
+            this.emit('connect', this.client);
+        }
+        catch (error) {
+            logger_1.logger.error(`Failed to connect to CDP: ${error}`);
+            // Try to reconnect if we haven't exceeded max attempts
+            if (this.reconnectAttempts < this.maxReconnectAttempts) {
+                this.reconnectAttempts++;
+                logger_1.logger.debug(`Reconnecting attempt ${this.reconnectAttempts}/${this.maxReconnectAttempts}...`);
+                await new Promise(resolve => setTimeout(resolve, this.reconnectDelay));
+                return this.connect(port);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Disconnect from CDP
+     */
+    async disconnect() {
+        if (this.client) {
+            try {
+                await this.client.close();
+                this.client = null;
+                this.isConnected = false;
+                this.connectionInfo = null;
+                logger_1.logger.disconnected();
+                this.emit('disconnect');
+            }
+            catch (error) {
+                logger_1.logger.error(`Error disconnecting from CDP: ${error}`);
+            }
+        }
+    }
+    /**
+     * Check if connected
+     */
+    isClientConnected() {
+        return this.isConnected && this.client !== null;
+    }
+    /**
+     * Get the raw CDP client
+     */
+    getClient() {
+        return this.client;
+    }
+    /**
+     * Get connection info
+     */
+    getConnectionInfo() {
+        return this.connectionInfo;
+    }
+    /**
+     * Enable a domain
+     */
+    async enableDomain(domain) {
+        if (!this.client) {
+            throw new Error('Not connected to CDP');
+        }
+        try {
+            await this.client.send(`${domain}.enable`);
+            logger_1.logger.debug(`Enabled domain: ${domain}`);
+        }
+        catch (error) {
+            logger_1.logger.error(`Failed to enable domain ${domain}: ${error}`);
+            throw error;
+        }
+    }
+    /**
+     * Send a command to CDP
+     */
+    async send(method, params) {
+        if (!this.client) {
+            throw new Error('Not connected to CDP');
+        }
+        try {
+            const result = await this.client.send(method, params);
+            logger_1.logger.debug(`CDP command: ${method}`, params);
+            return result;
+        }
+        catch (error) {
+            logger_1.logger.error(`CDP command failed: ${method}`, error);
+            throw error;
+        }
+    }
+    /**
+     * Get available targets (tabs/pages)
+     */
+    async getTargets() {
+        if (!this.client) {
+            throw new Error('Not connected to CDP');
+        }
+        try {
+            const { Target } = this.client;
+            const targets = await Target.getTargets();
+            return targets.targetInfos;
+        }
+        catch (error) {
+            logger_1.logger.error('Failed to get targets:', error);
+            throw error;
+        }
+    }
+    /**
+     * Attach to a specific target
+     */
+    async attachToTarget(targetId) {
+        if (!this.client) {
+            throw new Error('Not connected to CDP');
+        }
+        try {
+            const { Target } = this.client;
+            await Target.attachToTarget({ targetId, flatten: true });
+            logger_1.logger.debug(`Attached to target: ${targetId}`);
+        }
+        catch (error) {
+            logger_1.logger.error(`Failed to attach to target ${targetId}:`, error);
+            throw error;
+        }
+    }
+    /**
+     * Create a new tab
+     */
+    async createTarget(url = 'about:blank') {
+        if (!this.client) {
+            throw new Error('Not connected to CDP');
+        }
+        try {
+            const { Target } = this.client;
+            const result = await Target.createTarget({ url });
+            logger_1.logger.debug(`Created new target: ${result.targetId}`);
+            return result.targetId;
+        }
+        catch (error) {
+            logger_1.logger.error('Failed to create target:', error);
+            throw error;
+        }
+    }
+    /**
+     * Close a target
+     */
+    async closeTarget(targetId) {
+        if (!this.client) {
+            throw new Error('Not connected to CDP');
+        }
+        try {
+            const { Target } = this.client;
+            await Target.closeTarget({ targetId });
+            logger_1.logger.debug(`Closed target: ${targetId}`);
+        }
+        catch (error) {
+            logger_1.logger.error(`Failed to close target ${targetId}:`, error);
+            throw error;
+        }
+    }
+    /**
+     * Set up event listeners for specific domains
+     */
+    setupEventListeners() {
+        if (!this.client) {
+            return;
+        }
+        // Page events
+        if (this.client.Page) {
+            this.client.Page.frameNavigated((params) => {
+                this.emit('frameNavigated', params);
+                logger_1.logger.debug('Frame navigated:', params.frame.id);
+            });
+            this.client.Page.loadEventFired(() => {
+                this.emit('loadEventFired');
+                logger_1.logger.debug('Load event fired');
+            });
+        }
+        // Runtime events
+        if (this.client.Runtime) {
+            this.client.Runtime.bindingCalled((params) => {
+                this.emit('bindingCalled', params);
+                logger_1.logger.bindingCalled(params.name, params.payload);
+            });
+            this.client.Runtime.consoleAPICalled((params) => {
+                this.emit('consoleAPICalled', params);
+            });
+            this.client.Runtime.exceptionThrown((params) => {
+                this.emit('exceptionThrown', params);
+                logger_1.logger.error('Runtime exception:', params.exceptionDetails);
+            });
+        }
+        // Network events
+        if (this.client.Network) {
+            this.client.Network.requestWillBeSent((params) => {
+                this.emit('requestWillBeSent', params);
+            });
+            this.client.Network.responseReceived((params) => {
+                this.emit('responseReceived', params);
+            });
+        }
+    }
+}
+exports.CdpClient = CdpClient;
+//# sourceMappingURL=client.js.map

package/dist/cdp/client.js.map

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

package/dist/cdp/discovery.d.ts

@@ -0,0 +1,33 @@
+import { CdpConnectionInfo } from '../types';
+/**
+ * Auto-discover Chrome DevTools Protocol endpoint
+ */
+export declare class CdpDiscovery {
+    /**
+     * Discover CDP endpoint on available ports
+     */
+    static discover(port?: number): Promise<CdpConnectionInfo>;
+    /**
+     * Try to connect to a specific port
+     */
+    private static tryPort;
+    /**
+     * Check if a port is available
+     */
+    static isPortAvailable(port: number): Promise<boolean>;
+    /**
+     * Get launch instructions for Chrome
+     */
+    static getLaunchInstructions(port?: number): string[];
+}
+/**
+ * Custom error for CDP discovery failures
+ */
+export declare class CdpDiscoveryError extends Error {
+    constructor();
+    /**
+     * Get user-friendly error message with instructions
+     */
+    getInstructions(): string[];
+}
+//# sourceMappingURL=discovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/cdp/discovery.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAQ7C;;GAEG;AACH,qBAAa,YAAY;IACvB;;OAEG;WACU,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAqChE;;OAEG;mBACkB,OAAO;IA6C5B;;OAEG;WACU,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS5D;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,IAAI,GAAE,MAAa,GAAG,MAAM,EAAE;CAgC5D;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;;IAM1C;;OAEG;IACH,eAAe,IAAI,MAAM,EAAE;CAG5B"}