cbrowser 2.4.0 → 3.0.1

package/dist/browser.d.ts

@@ -190,5 +190,186 @@ export declare class CBrowser {
         count: number;
         size: number;
     }>;
+    /**
+     * Get the data directory path.
+     */
+    getDataDir(): string;
+    /**
+     * Save a visual baseline screenshot.
+     */
+    saveBaseline(name: string, url?: string): Promise<string>;
+    /**
+     * Compare current page to a baseline.
+     */
+    compareBaseline(name: string, threshold?: number): Promise<{
+        baseline: string;
+        current: string;
+        diffPath?: string;
+        diffPercentage: number;
+        passed: boolean;
+    }>;
+    /**
+     * List all visual baselines.
+     */
+    listBaselines(): string[];
+    /**
+     * Run accessibility audit on current page.
+     */
+    auditAccessibility(): Promise<{
+        url: string;
+        violations: Array<{
+            id: string;
+            impact: string;
+            description: string;
+            helpUrl: string;
+        }>;
+        passes: number;
+        score: number;
+    }>;
+    private recordingActions;
+    private isRecording;
+    /**
+     * Start recording user interactions.
+     */
+    startRecording(url?: string): Promise<void>;
+    /**
+     * Stop recording and return actions.
+     */
+    stopRecording(): Array<{
+        type: string;
+        selector?: string;
+        value?: string;
+        url?: string;
+        timestamp: number;
+    }>;
+    /**
+     * Save recording to file.
+     */
+    saveRecording(name: string, actions?: Array<{
+        type: string;
+        selector?: string;
+        value?: string;
+        url?: string;
+        timestamp: number;
+    }>): string;
+    /**
+     * Generate test code from recording.
+     */
+    generateTestCode(name: string, actions: Array<{
+        type: string;
+        selector?: string;
+        value?: string;
+        url?: string;
+    }>): string;
+    /**
+     * Export test results as JUnit XML.
+     */
+    exportJUnit(suite: {
+        name: string;
+        tests: Array<{
+            name: string;
+            status: string;
+            duration: number;
+            error?: string;
+        }>;
+    }, outputPath?: string): string;
+    /**
+     * Export test results as TAP format.
+     */
+    exportTAP(suite: {
+        name: string;
+        tests: Array<{
+            name: string;
+            status: string;
+            error?: string;
+        }>;
+    }, outputPath?: string): string;
+    /**
+     * Run multiple browser tasks in parallel.
+     */
+    static parallel<T>(tasks: Array<{
+        name: string;
+        config?: Partial<import("./config.js").CBrowserConfig>;
+        run: (browser: CBrowser) => Promise<T>;
+    }>, options?: {
+        maxConcurrency?: number;
+    }): Promise<Array<{
+        name: string;
+        result?: T;
+        error?: string;
+        duration: number;
+    }>>;
+    /**
+     * Run the same task across multiple device configurations in parallel.
+     */
+    static parallelDevices<T>(devices: string[], run: (browser: CBrowser, device: string) => Promise<T>, options?: {
+        maxConcurrency?: number;
+    }): Promise<Array<{
+        device: string;
+        result?: T;
+        error?: string;
+        duration: number;
+    }>>;
+    /**
+     * Run the same task across multiple URLs in parallel.
+     */
+    static parallelUrls<T>(urls: string[], run: (browser: CBrowser, url: string) => Promise<T>, options?: {
+        maxConcurrency?: number;
+        config?: Partial<import("./config.js").CBrowserConfig>;
+    }): Promise<Array<{
+        url: string;
+        result?: T;
+        error?: string;
+        duration: number;
+    }>>;
+    /**
+     * Fluent API - navigate and return chainable instance.
+     */
+    goto(url: string): Promise<FluentCBrowser>;
+}
+/**
+ * Fluent wrapper for chainable API.
+ */
+export declare class FluentCBrowser {
+    private browser;
+    constructor(browser: CBrowser);
+    click(selector: string, options?: {
+        force?: boolean;
+    }): Promise<FluentCBrowser>;
+    fill(selector: string, value: string): Promise<FluentCBrowser>;
+    screenshot(path?: string): Promise<FluentCBrowser>;
+    wait(ms: number): Promise<FluentCBrowser>;
+    extract(what: string): Promise<{
+        data: unknown;
+        fluent: FluentCBrowser;
+    }>;
+    close(): Promise<void>;
+    get instance(): CBrowser;
 }
+/**
+ * Parse natural language into browser action.
+ */
+export declare function parseNaturalLanguage(command: string): {
+    action: string;
+    params: Record<string, string>;
+} | null;
+/**
+ * Execute a natural language command.
+ */
+export declare function executeNaturalLanguage(browser: CBrowser, command: string): Promise<{
+    success: boolean;
+    action: string;
+    result?: unknown;
+    error?: string;
+}>;
+/**
+ * Execute multiple natural language commands in sequence.
+ */
+export declare function executeNaturalLanguageScript(browser: CBrowser, commands: string[]): Promise<Array<{
+    command: string;
+    success: boolean;
+    action: string;
+    result?: unknown;
+    error?: string;
+}>>;
 //# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

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

package/dist/browser.js

@@ -5,7 +5,10 @@
  * AI-powered browser automation with constitutional safety.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CBrowser = void 0;
+exports.FluentCBrowser = exports.CBrowser = void 0;
+exports.parseNaturalLanguage = parseNaturalLanguage;
+exports.executeNaturalLanguage = executeNaturalLanguage;
+exports.executeNaturalLanguageScript = executeNaturalLanguageScript;
 const playwright_1 = require("playwright");
 const fs_1 = require("fs");
 const path_1 = require("path");
@@ -1106,6 +1109,457 @@ class CBrowser {
         stats.audit = countDir(this.paths.auditDir, /\.json$/i);
         return stats;
     }
+    /**
+     * Get the data directory path.
+     */
+    getDataDir() {
+        return this.paths.dataDir;
+    }
+    // =========================================================================
+    // Tier 2: Visual Regression (v2.5.0)
+    // =========================================================================
+    /**
+     * Save a visual baseline screenshot.
+     */
+    async saveBaseline(name, url) {
+        const baselinesDir = (0, path_1.join)(this.paths.dataDir, "baselines");
+        if (!(0, fs_1.existsSync)(baselinesDir)) {
+            (0, fs_1.mkdirSync)(baselinesDir, { recursive: true });
+        }
+        const page = await this.getPage();
+        const screenshotPath = (0, path_1.join)(baselinesDir, `${name}.png`);
+        await page.screenshot({ path: screenshotPath, fullPage: true });
+        const baseline = {
+            name,
+            url: url || page.url(),
+            viewport: page.viewportSize() || { width: 1280, height: 800 },
+            screenshotPath,
+            created: new Date().toISOString(),
+            lastUsed: new Date().toISOString(),
+        };
+        const metaPath = (0, path_1.join)(baselinesDir, `${name}.json`);
+        (0, fs_1.writeFileSync)(metaPath, JSON.stringify(baseline, null, 2));
+        return screenshotPath;
+    }
+    /**
+     * Compare current page to a baseline.
+     */
+    async compareBaseline(name, threshold = 0.1) {
+        const baselinesDir = (0, path_1.join)(this.paths.dataDir, "baselines");
+        const metaPath = (0, path_1.join)(baselinesDir, `${name}.json`);
+        if (!(0, fs_1.existsSync)(metaPath)) {
+            throw new Error(`Baseline not found: ${name}`);
+        }
+        const baseline = JSON.parse((0, fs_1.readFileSync)(metaPath, "utf-8"));
+        const page = await this.getPage();
+        const currentPath = (0, path_1.join)(baselinesDir, `${name}-current-${Date.now()}.png`);
+        await page.screenshot({ path: currentPath, fullPage: true });
+        const baselineBuffer = (0, fs_1.readFileSync)(baseline.screenshotPath);
+        const currentBuffer = (0, fs_1.readFileSync)(currentPath);
+        const sizeDiff = Math.abs(baselineBuffer.length - currentBuffer.length);
+        const maxSize = Math.max(baselineBuffer.length, currentBuffer.length);
+        const diffPercentage = sizeDiff / maxSize;
+        return {
+            baseline: baseline.screenshotPath,
+            current: currentPath,
+            diffPercentage,
+            passed: diffPercentage <= threshold,
+        };
+    }
+    /**
+     * List all visual baselines.
+     */
+    listBaselines() {
+        const baselinesDir = (0, path_1.join)(this.paths.dataDir, "baselines");
+        if (!(0, fs_1.existsSync)(baselinesDir))
+            return [];
+        return (0, fs_1.readdirSync)(baselinesDir)
+            .filter(f => f.endsWith(".json"))
+            .map(f => f.replace(".json", ""));
+    }
+    // =========================================================================
+    // Tier 2: Accessibility Audit (v2.5.0)
+    // =========================================================================
+    /**
+     * Run accessibility audit on current page.
+     */
+    async auditAccessibility() {
+        const page = await this.getPage();
+        const results = await page.evaluate(() => {
+            const violations = [];
+            // Check images without alt
+            document.querySelectorAll("img").forEach(img => {
+                if (!img.alt && !img.getAttribute("aria-label")) {
+                    violations.push({
+                        id: "img-alt",
+                        impact: "serious",
+                        description: "Image missing alt text",
+                        helpUrl: "https://dequeuniversity.com/rules/axe/4.4/image-alt",
+                    });
+                }
+            });
+            // Check buttons without text
+            document.querySelectorAll("button").forEach(btn => {
+                if (!btn.textContent?.trim() && !btn.getAttribute("aria-label")) {
+                    violations.push({
+                        id: "button-name",
+                        impact: "critical",
+                        description: "Button has no accessible name",
+                        helpUrl: "https://dequeuniversity.com/rules/axe/4.4/button-name",
+                    });
+                }
+            });
+            // Check inputs without labels
+            document.querySelectorAll("input:not([type='hidden'])").forEach(input => {
+                const id = input.id;
+                const hasLabel = id && document.querySelector(`label[for="${id}"]`);
+                if (!hasLabel && !input.getAttribute("aria-label")) {
+                    violations.push({
+                        id: "label",
+                        impact: "serious",
+                        description: "Form input missing label",
+                        helpUrl: "https://dequeuniversity.com/rules/axe/4.4/label",
+                    });
+                }
+            });
+            // Check lang attribute
+            if (!document.documentElement.lang) {
+                violations.push({
+                    id: "html-has-lang",
+                    impact: "serious",
+                    description: "Page missing lang attribute",
+                    helpUrl: "https://dequeuniversity.com/rules/axe/4.4/html-has-lang",
+                });
+            }
+            const passes = document.querySelectorAll("img[alt], button:not(:empty), label").length;
+            return { violations, passes };
+        });
+        const score = results.passes > 0
+            ? Math.round((results.passes / (results.passes + results.violations.length)) * 100)
+            : 100;
+        return {
+            url: page.url(),
+            violations: results.violations,
+            passes: results.passes,
+            score,
+        };
+    }
+    // =========================================================================
+    // Tier 2: Test Recording (v2.5.0)
+    // =========================================================================
+    recordingActions = [];
+    isRecording = false;
+    /**
+     * Start recording user interactions.
+     */
+    async startRecording(url) {
+        this.isRecording = true;
+        this.recordingActions = [];
+        if (url) {
+            await this.navigate(url);
+            this.recordingActions.push({ type: "navigate", url, timestamp: Date.now() });
+        }
+    }
+    /**
+     * Stop recording and return actions.
+     */
+    stopRecording() {
+        this.isRecording = false;
+        return [...this.recordingActions];
+    }
+    /**
+     * Save recording to file.
+     */
+    saveRecording(name, actions) {
+        const recordingsDir = (0, path_1.join)(this.paths.dataDir, "recordings");
+        if (!(0, fs_1.existsSync)(recordingsDir)) {
+            (0, fs_1.mkdirSync)(recordingsDir, { recursive: true });
+        }
+        const recording = {
+            name,
+            actions: actions || this.recordingActions,
+            created: new Date().toISOString(),
+        };
+        const filePath = (0, path_1.join)(recordingsDir, `${name}.json`);
+        (0, fs_1.writeFileSync)(filePath, JSON.stringify(recording, null, 2));
+        return filePath;
+    }
+    /**
+     * Generate test code from recording.
+     */
+    generateTestCode(name, actions) {
+        let code = `// Generated test: ${name}\n\n`;
+        code += `import { CBrowser } from 'cbrowser';\n\n`;
+        code += `async function test_${name.replace(/[^a-zA-Z0-9]/g, "_")}() {\n`;
+        code += `  const browser = new CBrowser();\n\n`;
+        for (const action of actions) {
+            switch (action.type) {
+                case "navigate":
+                    code += `  await browser.navigate("${action.url}");\n`;
+                    break;
+                case "click":
+                    code += `  await browser.click("${action.selector}");\n`;
+                    break;
+                case "fill":
+                    code += `  await browser.fill("${action.selector}", "${action.value}");\n`;
+                    break;
+            }
+        }
+        code += `\n  await browser.close();\n`;
+        code += `}\n\n`;
+        code += `test_${name.replace(/[^a-zA-Z0-9]/g, "_")}();\n`;
+        return code;
+    }
+    // =========================================================================
+    // Tier 2: Test Export (v2.5.0)
+    // =========================================================================
+    /**
+     * Export test results as JUnit XML.
+     */
+    exportJUnit(suite, outputPath) {
+        const filename = outputPath || (0, path_1.join)(this.paths.dataDir, `junit-${Date.now()}.xml`);
+        let xml = `<?xml version="1.0" encoding="UTF-8"?>\n`;
+        xml += `<testsuite name="${suite.name}" tests="${suite.tests.length}">\n`;
+        for (const test of suite.tests) {
+            xml += `  <testcase name="${test.name}" time="${(test.duration / 1000).toFixed(3)}">\n`;
+            if (test.status === "failed" && test.error) {
+                xml += `    <failure message="${test.error.replace(/"/g, "&quot;")}">${test.error}</failure>\n`;
+            }
+            xml += `  </testcase>\n`;
+        }
+        xml += `</testsuite>\n`;
+        (0, fs_1.writeFileSync)(filename, xml);
+        return filename;
+    }
+    /**
+     * Export test results as TAP format.
+     */
+    exportTAP(suite, outputPath) {
+        const filename = outputPath || (0, path_1.join)(this.paths.dataDir, `tap-${Date.now()}.tap`);
+        let tap = `TAP version 13\n`;
+        tap += `1..${suite.tests.length}\n`;
+        suite.tests.forEach((test, i) => {
+            const status = test.status === "passed" ? "ok" : "not ok";
+            tap += `${status} ${i + 1} ${test.name}\n`;
+        });
+        (0, fs_1.writeFileSync)(filename, tap);
+        return filename;
+    }
+    // =========================================================================
+    // Tier 2: Parallel Execution (v2.5.0)
+    // =========================================================================
+    /**
+     * Run multiple browser tasks in parallel.
+     */
+    static async parallel(tasks, options = {}) {
+        const maxConcurrency = options.maxConcurrency || tasks.length;
+        const results = [];
+        // Process tasks in batches
+        for (let i = 0; i < tasks.length; i += maxConcurrency) {
+            const batch = tasks.slice(i, i + maxConcurrency);
+            const batchResults = await Promise.all(batch.map(async (task) => {
+                const startTime = Date.now();
+                const browser = new CBrowser(task.config || {});
+                try {
+                    const result = await task.run(browser);
+                    return {
+                        name: task.name,
+                        result,
+                        duration: Date.now() - startTime,
+                    };
+                }
+                catch (e) {
+                    return {
+                        name: task.name,
+                        error: e.message,
+                        duration: Date.now() - startTime,
+                    };
+                }
+                finally {
+                    await browser.close();
+                }
+            }));
+            results.push(...batchResults);
+        }
+        return results;
+    }
+    /**
+     * Run the same task across multiple device configurations in parallel.
+     */
+    static async parallelDevices(devices, run, options = {}) {
+        const tasks = devices.map(device => ({
+            name: device,
+            config: { device },
+            run: (browser) => run(browser, device),
+        }));
+        const results = await CBrowser.parallel(tasks, options);
+        return results.map(r => ({ device: r.name, ...r }));
+    }
+    /**
+     * Run the same task across multiple URLs in parallel.
+     */
+    static async parallelUrls(urls, run, options = {}) {
+        const tasks = urls.map(url => ({
+            name: url,
+            config: options.config,
+            run: (browser) => run(browser, url),
+        }));
+        const results = await CBrowser.parallel(tasks, options);
+        return results.map(r => ({ url: r.name, ...r }));
+    }
+    // =========================================================================
+    // Tier 3: Fluent API (v3.0.0)
+    // =========================================================================
+    /**
+     * Fluent API - navigate and return chainable instance.
+     */
+    async goto(url) {
+        await this.navigate(url);
+        return new FluentCBrowser(this);
+    }
 }
 exports.CBrowser = CBrowser;
+/**
+ * Fluent wrapper for chainable API.
+ */
+class FluentCBrowser {
+    browser;
+    constructor(browser) {
+        this.browser = browser;
+    }
+    async click(selector, options) {
+        await this.browser.click(selector, options);
+        return this;
+    }
+    async fill(selector, value) {
+        await this.browser.fill(selector, value);
+        return this;
+    }
+    async screenshot(path) {
+        await this.browser.screenshot(path);
+        return this;
+    }
+    async wait(ms) {
+        await new Promise(resolve => setTimeout(resolve, ms));
+        return this;
+    }
+    async extract(what) {
+        const result = await this.browser.extract(what);
+        return { data: result.data, fluent: this };
+    }
+    async close() {
+        await this.browser.close();
+    }
+    get instance() {
+        return this.browser;
+    }
+}
+exports.FluentCBrowser = FluentCBrowser;
+// ============================================================================
+// Tier 3: Natural Language API (v3.0.0)
+// ============================================================================
+/**
+ * Natural language command patterns.
+ */
+const NL_PATTERNS = [
+    // Navigation
+    { pattern: /^(?:go to|navigate to|open|visit)\s+(.+)$/i, action: "navigate", extract: (m) => ({ url: m[1] }) },
+    { pattern: /^(?:go\s+)?back$/i, action: "back", extract: () => ({}) },
+    { pattern: /^(?:go\s+)?forward$/i, action: "forward", extract: () => ({}) },
+    { pattern: /^refresh|reload$/i, action: "reload", extract: () => ({}) },
+    // Clicking
+    { pattern: /^click(?:\s+on)?\s+(?:the\s+)?["']?(.+?)["']?$/i, action: "click", extract: (m) => ({ selector: m[1] }) },
+    { pattern: /^press(?:\s+the)?\s+["']?(.+?)["']?(?:\s+button)?$/i, action: "click", extract: (m) => ({ selector: m[1] }) },
+    { pattern: /^tap(?:\s+on)?\s+["']?(.+?)["']?$/i, action: "click", extract: (m) => ({ selector: m[1] }) },
+    // Form filling
+    { pattern: /^(?:type|enter|input|fill(?:\s+in)?)\s+["'](.+?)["']\s+(?:in(?:to)?|on)\s+(?:the\s+)?["']?(.+?)["']?$/i, action: "fill", extract: (m) => ({ value: m[1], selector: m[2] }) },
+    { pattern: /^(?:fill(?:\s+in)?|set)\s+(?:the\s+)?["']?(.+?)["']?\s+(?:to|with|as)\s+["'](.+?)["']$/i, action: "fill", extract: (m) => ({ selector: m[1], value: m[2] }) },
+    // Selecting
+    { pattern: /^select\s+["'](.+?)["']\s+(?:from|in)\s+(?:the\s+)?["']?(.+?)["']?$/i, action: "select", extract: (m) => ({ value: m[1], selector: m[2] }) },
+    { pattern: /^choose\s+["'](.+?)["']$/i, action: "click", extract: (m) => ({ selector: m[1] }) },
+    // Screenshots
+    { pattern: /^(?:take\s+a?\s*)?screenshot(?:\s+as\s+["']?(.+?)["']?)?$/i, action: "screenshot", extract: (m) => ({ path: m[1] || "" }) },
+    { pattern: /^capture(?:\s+the)?\s+(?:page|screen)$/i, action: "screenshot", extract: () => ({}) },
+    // Waiting
+    { pattern: /^wait(?:\s+for)?\s+(\d+)\s*(?:ms|milliseconds?)?$/i, action: "wait", extract: (m) => ({ ms: m[1] }) },
+    { pattern: /^wait(?:\s+for)?\s+(\d+)\s*(?:s|seconds?)$/i, action: "waitSeconds", extract: (m) => ({ seconds: m[1] }) },
+    { pattern: /^wait(?:\s+for)?\s+["']?(.+?)["']?(?:\s+to\s+appear)?$/i, action: "waitFor", extract: (m) => ({ selector: m[1] }) },
+    // Scrolling
+    { pattern: /^scroll\s+(?:to\s+)?(?:the\s+)?(top|bottom)$/i, action: "scroll", extract: (m) => ({ direction: m[1] }) },
+    { pattern: /^scroll\s+(up|down)(?:\s+(\d+))?$/i, action: "scrollBy", extract: (m) => ({ direction: m[1], amount: m[2] || "300" }) },
+    // Extraction
+    { pattern: /^(?:get|extract|find)\s+(?:all\s+)?(?:the\s+)?(.+)$/i, action: "extract", extract: (m) => ({ what: m[1] }) },
+];
+/**
+ * Parse natural language into browser action.
+ */
+function parseNaturalLanguage(command) {
+    const trimmed = command.trim();
+    for (const { pattern, action, extract } of NL_PATTERNS) {
+        const match = trimmed.match(pattern);
+        if (match) {
+            return { action, params: extract(match) };
+        }
+    }
+    return null;
+}
+/**
+ * Execute a natural language command.
+ */
+async function executeNaturalLanguage(browser, command) {
+    const parsed = parseNaturalLanguage(command);
+    if (!parsed) {
+        return { success: false, action: "unknown", error: `Could not parse command: "${command}"` };
+    }
+    const { action, params } = parsed;
+    try {
+        let result;
+        switch (action) {
+            case "navigate":
+                result = await browser.navigate(params.url);
+                break;
+            case "click":
+                result = await browser.click(params.selector);
+                break;
+            case "fill":
+                result = await browser.fill(params.selector, params.value);
+                break;
+            case "screenshot":
+                result = await browser.screenshot(params.path || undefined);
+                break;
+            case "wait":
+                await new Promise(r => setTimeout(r, parseInt(params.ms)));
+                result = { waited: parseInt(params.ms) };
+                break;
+            case "waitSeconds":
+                await new Promise(r => setTimeout(r, parseInt(params.seconds) * 1000));
+                result = { waited: parseInt(params.seconds) * 1000 };
+                break;
+            case "extract":
+                result = await browser.extract(params.what);
+                break;
+            default:
+                return { success: false, action, error: `Unsupported action: ${action}` };
+        }
+        return { success: true, action, result };
+    }
+    catch (e) {
+        return { success: false, action, error: e.message };
+    }
+}
+/**
+ * Execute multiple natural language commands in sequence.
+ */
+async function executeNaturalLanguageScript(browser, commands) {
+    const results = [];
+    for (const command of commands) {
+        if (!command.trim() || command.startsWith("#"))
+            continue; // Skip empty lines and comments
+        const result = await executeNaturalLanguage(browser, command);
+        results.push({ command, ...result });
+        if (!result.success)
+            break; // Stop on first error
+    }
+    return results;
+}
 //# sourceMappingURL=browser.js.map