@shadowcoderr/context-graph 0.3.0

package/dist/core/browser-adapter.js

@@ -0,0 +1,208 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserAdapter = void 0;
+const logger_1 = require("../utils/logger");
+class BrowserAdapter {
+    browser;
+    context;
+    isClosed = false;
+    async launchBrowser(config) {
+        const { chromium, firefox } = await Promise.resolve().then(() => __importStar(require('playwright')));
+        let browserType;
+        switch (config.browser.channel) {
+            case 'msedge':
+            case 'chromium':
+                browserType = chromium;
+                break;
+            case 'firefox':
+                browserType = firefox;
+                break;
+            default:
+                throw new Error(`Unsupported browser: ${config.browser.channel}`);
+        }
+        const launchOptions = {
+            headless: config.browser.headless,
+            slowMo: config.browser.slowMo,
+            devtools: config.browser.devtools,
+            args: [
+                '--start-maximized',
+                '--disable-extensions',
+                '--disable-popup-blocking',
+                '--disable-notifications',
+                '--no-first-run',
+                '--no-default-browser-check',
+                '--disable-background-networking',
+                '--disable-background-timer-throttling',
+                '--disable-backgrounding-occluded-windows',
+                '--disable-breakpad',
+                '--disable-component-update',
+                '--disable-sync',
+                '--disable-translate',
+                '--metrics-recording-only',
+                '--no-first-run',
+                '--safebrowsing-disable-auto-update',
+                '--password-store=basic'
+            ],
+            handleSIGINT: false, // Don't close browser on Ctrl+C
+            handleSIGTERM: false,
+            handleSIGHUP: false,
+        };
+        // When requesting msedge, instruct playwright to use the msedge channel
+        if (config.browser.channel === 'msedge' && browserType === chromium) {
+            launchOptions.channel = 'msedge';
+        }
+        this.browser = await browserType.launch(launchOptions);
+        if (!this.browser) {
+            throw new Error('Failed to launch browser');
+        }
+        logger_1.logger.info(`Launched ${config.browser.channel} browser`);
+        return this.browser;
+    }
+    async createContext(browser, config) {
+        // Check if --start-maximized is being used
+        const isMaximized = true; // Since we're always using --start-maximized in launchOptions
+        const contextOptions = {
+            // Disable fixed viewport to allow window sizing when maximized
+            viewport: isMaximized ? null : (config?.viewport || null),
+            isMobile: false,
+            hasTouch: false,
+            javaScriptEnabled: true,
+            acceptDownloads: true,
+            ignoreHTTPSErrors: true,
+            bypassCSP: true,
+            userAgent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+            // Keep the browser process alive
+            closeBrowserOnContextClose: false,
+        };
+        // Only set viewport if explicitly provided in config AND not using --start-maximized
+        if (config?.viewport && !isMaximized) {
+            contextOptions.viewport = {
+                width: config.viewport.width,
+                height: config.viewport.height,
+            };
+        }
+        this.context = await browser.newContext(contextOptions);
+        logger_1.logger.info('Created browser context');
+        return this.context;
+    }
+    consoleMessages = [];
+    getConsoleMessages() {
+        return [...this.consoleMessages];
+    }
+    clearConsoleMessages() {
+        this.consoleMessages = [];
+    }
+    async attachPageListeners(page) {
+        page.on('load', () => {
+            logger_1.logger.debug('Page loaded');
+        });
+        page.on('domcontentloaded', () => {
+            logger_1.logger.debug('DOM content loaded');
+        });
+        page.on('console', (msg) => {
+            const message = {
+                type: msg.type(),
+                message: msg.text(),
+                location: msg.location(),
+                timestamp: new Date().toISOString(),
+                stack: msg.type() === 'error' ? msg.text() : undefined,
+            };
+            this.consoleMessages.push(message);
+            logger_1.logger.debug(`Console: ${msg.type()}: ${msg.text()}`);
+        });
+        page.on('pageerror', (error) => {
+            const errorMsg = {
+                type: 'error',
+                message: error.message,
+                location: { url: page.url(), lineNumber: 0, columnNumber: 0 },
+                timestamp: new Date().toISOString(),
+            };
+            if (error.stack) {
+                errorMsg.stack = error.stack;
+            }
+            this.consoleMessages.push(errorMsg);
+            logger_1.logger.warn(`Page error: ${error.message}`);
+        });
+    }
+    onBrowserDisconnect(callback) {
+        // Register a guarded disconnect handler
+        if (this.browser) {
+            this.browser.on('disconnected', () => {
+                try {
+                    callback();
+                }
+                catch (error) {
+                    logger_1.logger.warn(`Error in browser disconnect handler: ${error.message}`);
+                }
+            });
+        }
+    }
+    async getFrameHierarchy(page) {
+        const frames = page.frames();
+        const buildHierarchy = (frame) => {
+            return {
+                url: frame.url(),
+                name: frame.name(),
+                children: frame.childFrames().map(buildHierarchy),
+            };
+        };
+        return buildHierarchy(frames[0]); // Main frame
+    }
+    async close() {
+        if (this.isClosed)
+            return;
+        this.isClosed = true;
+        try {
+            if (this.context) {
+                await this.context.close();
+            }
+        }
+        catch (error) {
+            logger_1.logger.warn('Error closing browser context: ' + error.message);
+        }
+        try {
+            if (this.browser) {
+                await this.browser.close();
+            }
+        }
+        catch (error) {
+            logger_1.logger.warn('Error closing browser: ' + error.message);
+        }
+        logger_1.logger.info('Browser closed');
+    }
+}
+exports.BrowserAdapter = BrowserAdapter;
+//# sourceMappingURL=browser-adapter.js.map

package/dist/core/browser-adapter.js.map

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

package/dist/core/capture-engine.d.ts

@@ -0,0 +1,52 @@
+import { Page } from '@playwright/test';
+import { Config } from '../types/config';
+import { PageSnapshot } from '../types/capture';
+export declare class CaptureEngine {
+    private domAnalyzer;
+    private a11yExtractor;
+    private locatorGenerator;
+    private networkLogger;
+    private redactor;
+    private validator;
+    constructor(config: Config);
+    attachNetworkListeners(page: Page): Promise<void>;
+    capturePageSnapshot(page: Page, config: Config, consoleMessages?: any[]): Promise<PageSnapshot>;
+    private getFrameHierarchy;
+    getRedactionAudit(): import("../types/storage").RedactionAuditEntry[];
+    private generatePageName;
+    private sanitize;
+    /**
+     * Compute a content hash for change detection
+     * Combines DOM, accessibility tree, and locators into a single hash
+     */
+    private computeContentHash;
+    /**
+     * Normalize DOM for hashing by removing dynamic content
+     */
+    private normalizeDomForHash;
+    /**
+     * Normalize accessibility tree for hashing
+     */
+    private normalizeA11yForHash;
+    /**
+     * Capture page state information
+     */
+    private capturePageState;
+    /**
+     * Capture network request summary
+     */
+    private captureNetworkSummary;
+    /**
+     * Capture enhanced timing metrics
+     */
+    private captureEnhancedTiming;
+    /**
+     * Enhance locators data with CSS styles, viewport info, and form details
+     */
+    private enhanceLocatorsData;
+    /**
+     * Capture form field details
+     */
+    private captureFormFieldDetails;
+}
+//# sourceMappingURL=capture-engine.d.ts.map

package/dist/core/capture-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-engine.d.ts","sourceRoot":"","sources":["../../src/core/capture-engine.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAShD,qBAAa,aAAa;IACxB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,SAAS,CAAgB;gBAErB,MAAM,EAAE,MAAM;IASpB,sBAAsB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAE,GAAG,EAAO,GAAG,OAAO,CAAC,YAAY,CAAC;YAwG3F,iBAAiB;IAkB/B,iBAAiB;IAIjB,OAAO,CAAC,gBAAgB;IA8CxB,OAAO,CAAC,QAAQ;IAIhB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IA2B1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAc3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;OAEG;YACW,gBAAgB;IAgE9B;;OAEG;YACW,qBAAqB;IA2CnC;;OAEG;YACW,qBAAqB;IA6BnC;;OAEG;YACW,mBAAmB;IA8GjC;;OAEG;YACW,uBAAuB;CAuEtC"}