browser-debugger-cli 0.0.1-alpha.0

package/dist/connection/cdp.js

@@ -0,0 +1,317 @@
+import WebSocket from 'ws';
+/**
+ * Chrome DevTools Protocol WebSocket connection manager.
+ *
+ * Handles bidirectional communication with Chrome via CDP:
+ * - Request/response correlation with message IDs
+ * - Event subscription and handling
+ * - Connection lifecycle (connect, reconnect, keepalive)
+ * - Graceful error handling and cleanup
+ */
+export class CDPConnection {
+    ws = null;
+    messageId = 0;
+    pendingMessages = new Map();
+    nextHandlerId = 0;
+    eventHandlers = new Map(); // Event params typed at call site
+    // Keepalive state
+    pingInterval = null;
+    pongTimeout = null;
+    missedPongs = 0;
+    MAX_MISSED_PONGS = 3;
+    // Reconnection state
+    wsUrl = '';
+    autoReconnect = false;
+    reconnectAttempts = 0;
+    MAX_RECONNECT_ATTEMPTS = 5;
+    isIntentionallyClosed = false;
+    onReconnect;
+    /**
+     * Connect to Chrome via WebSocket.
+     *
+     * @param wsUrl - WebSocket debugger URL from CDP target
+     * @param options - Connection configuration options
+     * @throws Error if connection fails after all retries
+     */
+    async connect(wsUrl, options = {}) {
+        const { maxRetries = 3, autoReconnect = false, onReconnect } = options;
+        this.wsUrl = wsUrl;
+        this.autoReconnect = autoReconnect;
+        this.onReconnect = onReconnect;
+        this.isIntentionallyClosed = false;
+        let lastError;
+        for (let attempt = 0; attempt < maxRetries; attempt++) {
+            try {
+                await this.attemptConnection(wsUrl, options);
+                this.reconnectAttempts = 0;
+                return;
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt < maxRetries - 1) {
+                    const delay = Math.min(1000 * Math.pow(2, attempt), 5000);
+                    console.error(`Connection attempt ${attempt + 1} failed, retrying in ${delay}ms...`);
+                    await new Promise(resolve => setTimeout(resolve, delay));
+                }
+            }
+        }
+        throw new Error(`Failed to connect after ${maxRetries} attempts: ${lastError?.message}`);
+    }
+    attemptConnection(wsUrl, options = {}) {
+        const timeout = options.timeout ?? 10000;
+        return new Promise((resolve, reject) => {
+            this.ws = new WebSocket(wsUrl);
+            const connectTimeout = setTimeout(() => {
+                reject(new Error('Connection timeout'));
+                this.ws?.close();
+            }, timeout);
+            this.ws.on('open', () => {
+                clearTimeout(connectTimeout);
+                this.startKeepalive(options.keepaliveInterval ?? 30000);
+                resolve();
+            });
+            this.ws.on('error', (error) => {
+                clearTimeout(connectTimeout);
+                reject(error);
+            });
+            this.ws.on('close', async (code, reason) => {
+                this.stopKeepalive();
+                if (this.isIntentionallyClosed) {
+                    return;
+                }
+                console.error(`WebSocket closed: ${code} - ${reason.toString()}`);
+                // Reject all pending messages
+                this.pendingMessages.forEach((pending) => {
+                    clearTimeout(pending.timeout);
+                    pending.reject(new Error('WebSocket connection closed'));
+                });
+                this.pendingMessages.clear();
+                // Attempt reconnection if enabled
+                if (this.autoReconnect && this.reconnectAttempts < this.MAX_RECONNECT_ATTEMPTS) {
+                    await this.attemptReconnection();
+                }
+            });
+            this.ws.on('pong', () => {
+                this.missedPongs = 0;
+                if (this.pongTimeout) {
+                    clearTimeout(this.pongTimeout);
+                    this.pongTimeout = null;
+                }
+            });
+            this.ws.on('message', (data) => {
+                try {
+                    const message = JSON.parse(data.toString());
+                    // Handle responses
+                    if (message.id !== undefined) {
+                        const pending = this.pendingMessages.get(message.id);
+                        if (pending) {
+                            this.pendingMessages.delete(message.id);
+                            clearTimeout(pending.timeout);
+                            if (message.error) {
+                                pending.reject(new Error(message.error.message));
+                            }
+                            else {
+                                pending.resolve(message.result);
+                            }
+                        }
+                    }
+                    // Handle events
+                    if (message.method) {
+                        const handlers = this.eventHandlers.get(message.method);
+                        if (handlers) {
+                            handlers.forEach(handler => handler(message.params));
+                        }
+                    }
+                }
+                catch (error) {
+                    console.error('Failed to parse CDP message:', error);
+                }
+            });
+        });
+    }
+    async attemptReconnection() {
+        this.reconnectAttempts++;
+        const delay = Math.min(1000 * Math.pow(2, this.reconnectAttempts - 1), 10000);
+        console.error(`Reconnecting in ${delay}ms... (attempt ${this.reconnectAttempts}/${this.MAX_RECONNECT_ATTEMPTS})`);
+        await new Promise(resolve => setTimeout(resolve, delay));
+        try {
+            await this.attemptConnection(this.wsUrl);
+            this.reconnectAttempts = 0;
+            console.error('Reconnected successfully');
+            // Re-enable domains
+            if (this.onReconnect) {
+                await this.onReconnect();
+            }
+        }
+        catch (error) {
+            console.error('Reconnection failed:', error);
+        }
+    }
+    startKeepalive(interval) {
+        this.pingInterval = setInterval(() => {
+            if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+                this.missedPongs++;
+                if (this.missedPongs >= this.MAX_MISSED_PONGS) {
+                    console.error('Connection lost: no pong received');
+                    this.ws.close(1001, 'No pong received');
+                    return;
+                }
+                this.ws.ping();
+                this.pongTimeout = setTimeout(() => {
+                    console.error('Pong timeout');
+                }, 5000);
+            }
+        }, interval);
+    }
+    stopKeepalive() {
+        if (this.pingInterval) {
+            clearInterval(this.pingInterval);
+            this.pingInterval = null;
+        }
+        if (this.pongTimeout) {
+            clearTimeout(this.pongTimeout);
+            this.pongTimeout = null;
+        }
+    }
+    /**
+     * Get the CDP port from the WebSocket URL.
+     *
+     * @returns CDP port number
+     * @throws Error if not connected or URL is invalid
+     */
+    getPort() {
+        if (!this.wsUrl) {
+            throw new Error('Not connected - no WebSocket URL available');
+        }
+        try {
+            const url = new URL(this.wsUrl);
+            return parseInt(url.port, 10);
+        }
+        catch (error) {
+            throw new Error(`Invalid WebSocket URL: ${this.wsUrl}`);
+        }
+    }
+    /**
+     * Send a CDP command and wait for the response.
+     *
+     * @param method - CDP method name (e.g., 'Page.navigate', 'DOM.getDocument')
+     * @param params - Method parameters
+     * @param sessionId - Optional session ID for commands sent to specific targets
+     * @returns Promise resolving to the command result
+     * @throws Error if not connected or command times out (30s)
+     *
+     * @remarks
+     * Return type is `any` because CDP response structures vary by method.
+     * Callers should type-assert the result based on the specific method called.
+     */
+    async send(method, params = {}, sessionId) {
+        if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+            throw new Error('Not connected to browser');
+        }
+        const id = ++this.messageId;
+        const message = { id, method, params };
+        // Add sessionId if provided (for commands sent to specific targets)
+        if (sessionId) {
+            message.sessionId = sessionId;
+        }
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                const pending = this.pendingMessages.get(id);
+                if (pending) {
+                    this.pendingMessages.delete(id);
+                    reject(new Error(`Command timeout: ${method}`));
+                }
+            }, 30000);
+            this.pendingMessages.set(id, {
+                resolve: (value) => {
+                    clearTimeout(timeout);
+                    resolve(value);
+                },
+                reject: (error) => {
+                    clearTimeout(timeout);
+                    reject(error);
+                },
+                timeout
+            });
+            this.ws.send(JSON.stringify(message));
+        });
+    }
+    /**
+     * Register an event handler for CDP events.
+     *
+     * @param event - CDP event name (e.g., 'Network.requestWillBeSent')
+     * @param handler - Callback function to handle the event
+     * @returns Handler ID for later removal with off()
+     *
+     * @remarks
+     * Handler parameter type is `any` for flexibility. Callers should use typed
+     * event parameter interfaces (e.g., `CDPNetworkRequestParams`) at call site.
+     */
+    on(event, handler) {
+        if (!this.eventHandlers.has(event)) {
+            this.eventHandlers.set(event, new Map());
+        }
+        const handlerId = ++this.nextHandlerId;
+        this.eventHandlers.get(event).set(handlerId, handler);
+        return handlerId;
+    }
+    /**
+     * Remove a specific event handler.
+     *
+     * @param event - CDP event name
+     * @param handlerId - Handler ID returned from on()
+     */
+    off(event, handlerId) {
+        const handlers = this.eventHandlers.get(event);
+        if (handlers) {
+            handlers.delete(handlerId);
+            if (handlers.size === 0) {
+                this.eventHandlers.delete(event);
+            }
+        }
+    }
+    /**
+     * Remove all event handlers for a specific event or all events.
+     *
+     * @param event - Optional event name. If omitted, removes all handlers for all events.
+     */
+    removeAllListeners(event) {
+        if (event) {
+            this.eventHandlers.delete(event);
+        }
+        else {
+            this.eventHandlers.clear();
+        }
+    }
+    /**
+     * Close the WebSocket connection and clean up resources.
+     *
+     * @param code - WebSocket close code (default: 1000 for normal closure)
+     * @param reason - Human-readable close reason
+     */
+    close(code = 1000, reason = 'Normal closure') {
+        this.isIntentionallyClosed = true;
+        this.autoReconnect = false;
+        this.stopKeepalive();
+        // Clear all pending messages
+        this.pendingMessages.forEach((pending) => {
+            clearTimeout(pending.timeout);
+            pending.reject(new Error('Connection closed'));
+        });
+        this.pendingMessages.clear();
+        if (this.ws) {
+            this.ws.close(code, reason);
+            this.ws = null;
+        }
+        this.removeAllListeners();
+    }
+    /**
+     * Check if the WebSocket connection is open and ready.
+     *
+     * @returns True if connected and ready to send/receive
+     */
+    isConnected() {
+        return this.ws !== null && this.ws.readyState === WebSocket.OPEN;
+    }
+}
+//# sourceMappingURL=cdp.js.map

package/dist/connection/cdp.js.map

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

package/dist/connection/finder.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Validate that a target still exists in Chrome.
+ *
+ * Used to detect when a tab has been closed during collection.
+ *
+ * @param targetId - CDP target ID to validate
+ * @param port - Chrome debugging port
+ * @returns True if target still exists, false otherwise
+ */
+export declare function validateTarget(targetId: string, port?: number): Promise<boolean>;
+//# sourceMappingURL=finder.d.ts.map

package/dist/connection/finder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finder.d.ts","sourceRoot":"","sources":["../../src/connection/finder.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,SAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAWpF"}

package/dist/connection/finder.js

@@ -0,0 +1,23 @@
+/**
+ * Validate that a target still exists in Chrome.
+ *
+ * Used to detect when a tab has been closed during collection.
+ *
+ * @param targetId - CDP target ID to validate
+ * @param port - Chrome debugging port
+ * @returns True if target still exists, false otherwise
+ */
+export async function validateTarget(targetId, port = 9222) {
+    try {
+        const response = await fetch(`http://127.0.0.1:${port}/json/list`);
+        if (!response.ok) {
+            return false;
+        }
+        const targets = await response.json();
+        return targets.some(t => t.id === targetId);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=finder.js.map

package/dist/connection/finder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finder.js","sourceRoot":"","sources":["../../src/connection/finder.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB,EAAE,IAAI,GAAG,IAAI;IAChE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,oBAAoB,IAAI,YAAY,CAAC,CAAC;QACnE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,OAAO,GAAgB,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/connection/launcher.d.ts

@@ -0,0 +1,30 @@
+import { LaunchedChrome } from '../types.js';
+export interface LaunchOptions {
+    port?: number;
+    userDataDir?: string;
+    headless?: boolean;
+    url?: string;
+}
+/**
+ * Launch Chrome with remote debugging enabled using chrome-launcher.
+ *
+ * Supports macOS, Linux, and Windows. Chrome will be launched with
+ * the specified debugging port and user data directory.
+ *
+ * @param options - Launch configuration options
+ * @returns LaunchedChrome instance with PID and kill method
+ * @throws Error if Chrome fails to launch or CDP doesn't become available
+ *
+ * @remarks
+ * Chrome 136+ requires --user-data-dir with a non-default directory.
+ * Uses chrome-launcher for cross-platform Chrome detection and launching.
+ */
+export declare function launchChrome(options?: LaunchOptions): Promise<LaunchedChrome>;
+/**
+ * Check if Chrome is already running with CDP on the specified port.
+ *
+ * @param port - Chrome debugging port to check
+ * @returns True if Chrome is running and CDP is available
+ */
+export declare function isChromeRunning(port?: number): Promise<boolean>;
+//# sourceMappingURL=launcher.d.ts.map

package/dist/connection/launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher.d.ts","sourceRoot":"","sources":["../../src/connection/launcher.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAK7C,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,CAqDvF;AA4DD;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,IAAI,GAAE,MAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAS3E"}

package/dist/connection/launcher.js

@@ -0,0 +1,134 @@
+import * as chromeLauncher from 'chrome-launcher';
+import * as os from 'os';
+import * as path from 'path';
+import * as fs from 'fs';
+/**
+ * Launch Chrome with remote debugging enabled using chrome-launcher.
+ *
+ * Supports macOS, Linux, and Windows. Chrome will be launched with
+ * the specified debugging port and user data directory.
+ *
+ * @param options - Launch configuration options
+ * @returns LaunchedChrome instance with PID and kill method
+ * @throws Error if Chrome fails to launch or CDP doesn't become available
+ *
+ * @remarks
+ * Chrome 136+ requires --user-data-dir with a non-default directory.
+ * Uses chrome-launcher for cross-platform Chrome detection and launching.
+ */
+export async function launchChrome(options = {}) {
+    const port = options.port ?? 9222;
+    const headless = options.headless ?? false;
+    const startingUrl = options.url ?? 'about:blank';
+    // Use persistent user-data-dir if not provided
+    const userDataDir = options.userDataDir ?? getPersistentUserDataDir();
+    console.error(`Launching Chrome with CDP on port ${port}...`);
+    console.error(`User data directory: ${userDataDir}`);
+    // Build Chrome launch flags
+    const chromeFlags = [
+        `--remote-debugging-port=${port}`,
+        `--user-data-dir=${userDataDir}`,
+        '--no-first-run',
+        '--no-default-browser-check',
+        '--disable-search-engine-choice-screen',
+    ];
+    if (headless) {
+        chromeFlags.push('--headless=new');
+    }
+    try {
+        const chrome = await chromeLauncher.launch({
+            port,
+            chromePath: findChromeBinary(), // Let chrome-launcher find Chrome
+            chromeFlags,
+            startingUrl,
+            ignoreDefaultFlags: false,
+        });
+        console.error(`Chrome launched successfully (PID: ${chrome.pid})`);
+        // Wait for CDP to be fully available
+        await waitForCDP(port);
+        // Return LaunchedChrome instance
+        return {
+            pid: chrome.pid,
+            port: chrome.port,
+            kill: async () => {
+                try {
+                    await chrome.kill();
+                }
+                catch (error) {
+                    console.error(`Error killing Chrome: ${error instanceof Error ? error.message : String(error)}`);
+                }
+            },
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to launch Chrome: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Find Chrome binary path for the current platform.
+ *
+ * Returns undefined to let chrome-launcher use its own detection logic.
+ * Can be extended to support custom paths if needed.
+ *
+ * @returns Chrome binary path or undefined for auto-detection
+ */
+function findChromeBinary() {
+    // Let chrome-launcher handle Chrome detection
+    // It already supports macOS, Linux, Windows, and various Chrome flavors
+    return undefined;
+}
+/**
+ * Get the default persistent user-data-dir path.
+ *
+ * Uses ~/.bdg/chrome-profile to persist cookies, settings, and other
+ * browser state across bdg sessions. This allows cookies to be saved
+ * and avoids showing cookie consent dialogs on every run.
+ *
+ * @returns Absolute path to persistent user-data-dir
+ */
+function getPersistentUserDataDir() {
+    const homeDir = os.homedir();
+    const userDataDir = path.join(homeDir, '.bdg', 'chrome-profile');
+    // Create directory if it doesn't exist
+    if (!fs.existsSync(userDataDir)) {
+        fs.mkdirSync(userDataDir, { recursive: true });
+    }
+    return userDataDir;
+}
+/**
+ * Wait for Chrome CDP to become available.
+ *
+ * Polls the CDP version endpoint until it responds successfully.
+ *
+ * @param port - CDP port to check
+ * @param maxWaitMs - Maximum time to wait in milliseconds
+ * @throws Error if CDP doesn't become available within timeout
+ */
+async function waitForCDP(port, maxWaitMs = 10000) {
+    const startTime = Date.now();
+    while (Date.now() - startTime < maxWaitMs) {
+        if (await isChromeRunning(port)) {
+            return; // CDP is ready!
+        }
+        await new Promise(resolve => setTimeout(resolve, 200));
+    }
+    throw new Error(`CDP not available on port ${port} after ${maxWaitMs}ms`);
+}
+/**
+ * Check if Chrome is already running with CDP on the specified port.
+ *
+ * @param port - Chrome debugging port to check
+ * @returns True if Chrome is running and CDP is available
+ */
+export async function isChromeRunning(port = 9222) {
+    try {
+        const response = await fetch(`http://127.0.0.1:${port}/json/version`, {
+            signal: AbortSignal.timeout(2000), // 2 second timeout
+        });
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=launcher.js.map

package/dist/connection/launcher.js.map

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

package/dist/connection/tabs.d.ts

@@ -0,0 +1,49 @@
+import { CDPConnection } from './cdp.js';
+import { CDPTarget } from '../types.js';
+/**
+ * Find the best matching target from a list of tabs.
+ *
+ * @param url - Target URL to find (will be normalized)
+ * @param targets - List of available targets
+ * @returns Best matching target or null if no match found
+ */
+export declare function findBestTarget(url: string, targets: CDPTarget[]): CDPTarget | null;
+/**
+ * Create a new tab with the specified URL using CDP.
+ *
+ * @param url - URL to open in the new tab
+ * @param cdp - CDP connection instance
+ * @returns Target information for the new tab
+ */
+export declare function createNewTab(url: string, cdp: CDPConnection): Promise<CDPTarget>;
+/**
+ * Navigate an existing tab to a new URL using CDP.
+ *
+ * @param targetId - CDP target ID to navigate
+ * @param url - URL to navigate to
+ * @param cdp - CDP connection instance
+ */
+export declare function navigateToUrl(targetId: string, url: string, cdp: CDPConnection): Promise<void>;
+/**
+ * Wait for a target to be ready (URL matches expected).
+ *
+ * @param targetId - CDP target ID to wait for
+ * @param expectedUrl - Expected URL (normalized)
+ * @param cdp - CDP connection instance
+ * @param maxWaitMs - Maximum time to wait in milliseconds
+ */
+export declare function waitForTargetReady(targetId: string, expectedUrl: string, cdp: CDPConnection, maxWaitMs?: number): Promise<void>;
+/**
+ * Create a new tab or find existing tab with the target URL.
+ *
+ * This is the main entry point for tab management.
+ * It tries to find an existing tab first, and if not found,
+ * creates a new one.
+ *
+ * @param url - Target URL
+ * @param cdp - CDP connection instance
+ * @param reuseTab - If true, navigate existing tab instead of creating new one
+ * @returns Target information
+ */
+export declare function createOrFindTarget(url: string, cdp: CDPConnection, reuseTab?: boolean): Promise<CDPTarget>;
+//# sourceMappingURL=tabs.d.ts.map

package/dist/connection/tabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabs.d.ts","sourceRoot":"","sources":["../../src/connection/tabs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,SAAS,EAKV,MAAM,aAAa,CAAC;AA8DrB;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,SAAS,EAAE,GACnB,SAAS,GAAG,IAAI,CAgClB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,aAAa,GACjB,OAAO,CAAC,SAAS,CAAC,CA0CpB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,aAAa,GACjB,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,aAAa,EAClB,SAAS,SAAQ,GAChB,OAAO,CAAC,IAAI,CAAC,CAqCf;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,aAAa,EAClB,QAAQ,UAAQ,GACf,OAAO,CAAC,SAAS,CAAC,CAqCpB"}