cbrowser 10.5.0 → 10.5.1

package/dist/browser/selector-cache.js

@@ -0,0 +1,193 @@
+/**
+ * Selector Cache - Self-healing selector persistence
+ *
+ * Stores working selector alternatives for faster element finding.
+ * Extracted from CBrowser class for better modularity.
+ */
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+/**
+ * Manages self-healing selector cache for faster element finding.
+ */
+export class SelectorCacheManager {
+    config;
+    cache = null;
+    currentDomain = "unknown";
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Set current domain for cache key generation.
+     */
+    setCurrentDomain(domain) {
+        this.currentDomain = domain;
+    }
+    /**
+     * Get current domain.
+     */
+    getCurrentDomain() {
+        return this.currentDomain;
+    }
+    /**
+     * Get the cache file path.
+     */
+    getCachePath() {
+        return join(this.config.dataDir, "selector-cache.json");
+    }
+    /**
+     * Load the cache from disk.
+     */
+    load() {
+        if (this.cache)
+            return this.cache;
+        const cachePath = this.getCachePath();
+        if (existsSync(cachePath)) {
+            try {
+                const data = readFileSync(cachePath, "utf-8");
+                this.cache = JSON.parse(data);
+                return this.cache;
+            }
+            catch (e) {
+                if (this.config.verbose) {
+                    console.debug(`[CBrowser] Corrupted selector cache, starting fresh: ${e.message}`);
+                }
+            }
+        }
+        this.cache = { version: 1, entries: {} };
+        return this.cache;
+    }
+    /**
+     * Save the cache to disk.
+     */
+    save() {
+        if (!this.cache)
+            return;
+        const cachePath = this.getCachePath();
+        writeFileSync(cachePath, JSON.stringify(this.cache, null, 2));
+    }
+    /**
+     * Get cache key for a selector.
+     */
+    getKey(selector, domain) {
+        const d = domain || this.currentDomain;
+        return `${d}::${selector.toLowerCase()}`;
+    }
+    /**
+     * Cache a working alternative selector.
+     */
+    cacheAlternative(original, working, reason = "Alternative found") {
+        // Reject empty or meaningless selectors
+        if (!working || working.trim() === "" || working === 'text=""' || working === "text=''") {
+            if (this.config.verbose) {
+                console.log(`⚠️ Rejected invalid selector for caching: "${working}"`);
+            }
+            return;
+        }
+        const cache = this.load();
+        const key = this.getKey(original);
+        const domain = this.currentDomain;
+        cache.entries[key] = {
+            originalSelector: original,
+            workingSelector: working,
+            domain,
+            successCount: 1,
+            failCount: 0,
+            lastUsed: new Date().toISOString(),
+            reason,
+        };
+        this.save();
+        if (this.config.verbose) {
+            console.log(`📦 Cached healed selector: "${original}" → "${working}"`);
+        }
+    }
+    /**
+     * Get a cached alternative selector if available.
+     */
+    getCached(original) {
+        const cache = this.load();
+        const key = this.getKey(original);
+        const entry = cache.entries[key] || null;
+        if (entry && (entry.workingSelector === 'text=""' || entry.workingSelector === "text=''" || entry.workingSelector.trim() === "")) {
+            return null; // Reject invalid cached selectors
+        }
+        return entry;
+    }
+    /**
+     * Update cache entry statistics.
+     */
+    updateStats(original, success) {
+        const cache = this.load();
+        const key = this.getKey(original);
+        const entry = cache.entries[key];
+        if (entry) {
+            if (success) {
+                entry.successCount++;
+            }
+            else {
+                entry.failCount++;
+            }
+            entry.lastUsed = new Date().toISOString();
+            this.save();
+        }
+    }
+    /**
+     * Get cache statistics.
+     */
+    getStats() {
+        const cache = this.load();
+        const entries = Object.values(cache.entries);
+        const byDomain = {};
+        for (const entry of entries) {
+            byDomain[entry.domain] = (byDomain[entry.domain] || 0) + 1;
+        }
+        const topHealedSelectors = entries
+            .sort((a, b) => b.successCount - a.successCount)
+            .slice(0, 10)
+            .map((e) => ({
+            original: e.originalSelector,
+            working: e.workingSelector,
+            heals: e.successCount,
+        }));
+        return {
+            totalEntries: entries.length,
+            totalHeals: entries.reduce((sum, e) => sum + e.successCount, 0),
+            byDomain,
+            topHealedSelectors,
+        };
+    }
+    /**
+     * Clear the cache.
+     */
+    clear(domain) {
+        const cache = this.load();
+        let cleared = 0;
+        if (domain) {
+            // Clear only for specific domain
+            for (const [key, entry] of Object.entries(cache.entries)) {
+                if (entry.domain === domain) {
+                    delete cache.entries[key];
+                    cleared++;
+                }
+            }
+        }
+        else {
+            // Clear all
+            cleared = Object.keys(cache.entries).length;
+            cache.entries = {};
+        }
+        this.save();
+        return cleared;
+    }
+    /**
+     * List all cached selectors.
+     */
+    list(domain) {
+        const cache = this.load();
+        let entries = Object.values(cache.entries);
+        if (domain) {
+            entries = entries.filter((e) => e.domain === domain);
+        }
+        return entries.sort((a, b) => b.successCount - a.successCount);
+    }
+}
+//# sourceMappingURL=selector-cache.js.map

package/dist/browser/selector-cache.js.map

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

package/dist/browser/session-manager.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Session Manager - Handles browser session persistence
+ *
+ * Extracted from CBrowser class for better modularity.
+ */
+import type { Page, BrowserContext } from "playwright";
+import type { SavedSession, LoadSessionResult, SessionMetadata } from "../types.js";
+export interface SessionManagerConfig {
+    sessionsDir: string;
+    viewportWidth: number;
+    viewportHeight: number;
+    verbose?: boolean;
+}
+/**
+ * Manages browser session persistence - save, load, list, delete sessions.
+ */
+export declare class SessionManager {
+    private config;
+    constructor(config: SessionManagerConfig);
+    /**
+     * Save the current session to disk.
+     */
+    save(name: string, page: Page, context: BrowserContext): Promise<void>;
+    /**
+     * Load a saved session from disk.
+     */
+    load(name: string, page: Page, context: BrowserContext): Promise<LoadSessionResult>;
+    /**
+     * List all saved session names.
+     */
+    list(): string[];
+    /**
+     * List all saved sessions with rich metadata.
+     */
+    listDetailed(): SessionMetadata[];
+    /**
+     * Get detailed info for a single session.
+     */
+    getDetails(name: string): SavedSession | null;
+    /**
+     * Delete a saved session.
+     */
+    delete(name: string): boolean;
+    /**
+     * Delete sessions older than a given number of days.
+     */
+    cleanup(olderThanDays: number): {
+        deleted: string[];
+        kept: string[];
+    };
+    /**
+     * Export a session to a portable JSON file.
+     */
+    export(name: string, outputPath: string): boolean;
+    /**
+     * Import a session from a JSON file.
+     */
+    import(inputPath: string, name: string): boolean;
+}
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/browser/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../src/browser/session-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAU,MAAM,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEpF,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAuB;gBAEzB,MAAM,EAAE,oBAAoB;IAIxC;;OAEG;IACG,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC;IAoDhB;;OAEG;IACG,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,iBAAiB,CAAC;IAoE7B;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE;IAOhB;;OAEG;IACH,YAAY,IAAI,eAAe,EAAE;IAiCjC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAa7C;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAS7B;;OAEG;IACH,OAAO,CAAC,aAAa,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE;IA4BrE;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAQjD;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;CAajD"}

package/dist/browser/session-manager.js

@@ -0,0 +1,261 @@
+/**
+ * Session Manager - Handles browser session persistence
+ *
+ * Extracted from CBrowser class for better modularity.
+ */
+import { existsSync, readFileSync, writeFileSync, readdirSync, statSync, unlinkSync } from "fs";
+import { join } from "path";
+/**
+ * Manages browser session persistence - save, load, list, delete sessions.
+ */
+export class SessionManager {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Save the current session to disk.
+     */
+    async save(name, page, context) {
+        const cookies = await context.cookies();
+        let localStorage = {};
+        try {
+            localStorage = await page.evaluate(() => {
+                const data = {};
+                for (let i = 0; i < window.localStorage.length; i++) {
+                    const key = window.localStorage.key(i);
+                    if (key)
+                        data[key] = window.localStorage.getItem(key) || "";
+                }
+                return data;
+            });
+        }
+        catch (e) {
+            console.debug(`[CBrowser] localStorage inaccessible: ${e.message}`);
+        }
+        let sessionStorage = {};
+        try {
+            sessionStorage = await page.evaluate(() => {
+                const data = {};
+                for (let i = 0; i < window.sessionStorage.length; i++) {
+                    const key = window.sessionStorage.key(i);
+                    if (key)
+                        data[key] = window.sessionStorage.getItem(key) || "";
+                }
+                return data;
+            });
+        }
+        catch (e) {
+            console.debug(`[CBrowser] sessionStorage inaccessible: ${e.message}`);
+        }
+        const url = page.url();
+        const domain = new URL(url).hostname;
+        const session = {
+            name,
+            created: new Date().toISOString(),
+            lastUsed: new Date().toISOString(),
+            domain,
+            url,
+            viewport: {
+                width: this.config.viewportWidth,
+                height: this.config.viewportHeight,
+            },
+            cookies: cookies,
+            localStorage,
+            sessionStorage,
+        };
+        const sessionPath = join(this.config.sessionsDir, `${name}.json`);
+        writeFileSync(sessionPath, JSON.stringify(session, null, 2));
+    }
+    /**
+     * Load a saved session from disk.
+     */
+    async load(name, page, context) {
+        const sessionPath = join(this.config.sessionsDir, `${name}.json`);
+        if (!existsSync(sessionPath)) {
+            return {
+                success: false,
+                name,
+                cookiesRestored: 0,
+                localStorageKeysRestored: 0,
+                sessionStorageKeysRestored: 0,
+            };
+        }
+        const session = JSON.parse(readFileSync(sessionPath, "utf-8"));
+        const result = {
+            success: true,
+            name,
+            cookiesRestored: session.cookies.length,
+            localStorageKeysRestored: Object.keys(session.localStorage).length,
+            sessionStorageKeysRestored: Object.keys(session.sessionStorage).length,
+        };
+        // Cross-domain warning
+        const currentUrl = page.url();
+        if (currentUrl && currentUrl !== "about:blank") {
+            try {
+                const currentDomain = new URL(currentUrl).hostname;
+                if (session.domain && currentDomain !== session.domain) {
+                    result.warning = `Session '${name}' was saved for ${session.domain} but current page is ${currentDomain}. Some cookies may not apply.`;
+                }
+            }
+            catch (e) {
+                console.debug(`[CBrowser] URL parsing failed: ${e.message}`);
+            }
+        }
+        // Restore cookies
+        if (session.cookies.length > 0) {
+            await context.addCookies(session.cookies);
+        }
+        // Navigate to saved URL
+        await page.goto(session.url, { waitUntil: "networkidle" });
+        // Restore localStorage
+        await page.evaluate((data) => {
+            for (const [key, value] of Object.entries(data)) {
+                window.localStorage.setItem(key, value);
+            }
+        }, session.localStorage);
+        // Restore sessionStorage
+        await page.evaluate((data) => {
+            for (const [key, value] of Object.entries(data)) {
+                window.sessionStorage.setItem(key, value);
+            }
+        }, session.sessionStorage);
+        // Refresh to apply storage
+        await page.reload({ waitUntil: "networkidle" });
+        // Update lastUsed
+        session.lastUsed = new Date().toISOString();
+        writeFileSync(sessionPath, JSON.stringify(session, null, 2));
+        return result;
+    }
+    /**
+     * List all saved session names.
+     */
+    list() {
+        const files = readdirSync(this.config.sessionsDir);
+        return files
+            .filter((f) => f.endsWith(".json") && f !== "last-session.json")
+            .map((f) => f.replace(".json", ""));
+    }
+    /**
+     * List all saved sessions with rich metadata.
+     */
+    listDetailed() {
+        const files = readdirSync(this.config.sessionsDir);
+        const sessions = [];
+        for (const file of files) {
+            if (!file.endsWith(".json") || file === "last-session.json")
+                continue;
+            const filePath = join(this.config.sessionsDir, file);
+            try {
+                const data = JSON.parse(readFileSync(filePath, "utf-8"));
+                const stats = statSync(filePath);
+                sessions.push({
+                    name: data.name || file.replace(".json", ""),
+                    created: data.created,
+                    lastUsed: data.lastUsed,
+                    domain: data.domain,
+                    url: data.url,
+                    cookies: data.cookies?.length || 0,
+                    localStorageKeys: Object.keys(data.localStorage || {}).length,
+                    sessionStorageKeys: Object.keys(data.sessionStorage || {}).length,
+                    sizeBytes: stats.size,
+                });
+            }
+            catch (e) {
+                if (this.config.verbose) {
+                    console.debug(`[CBrowser] Skipping malformed session file ${file}: ${e.message}`);
+                }
+            }
+        }
+        return sessions.sort((a, b) => new Date(b.lastUsed).getTime() - new Date(a.lastUsed).getTime());
+    }
+    /**
+     * Get detailed info for a single session.
+     */
+    getDetails(name) {
+        const sessionPath = join(this.config.sessionsDir, `${name}.json`);
+        if (!existsSync(sessionPath))
+            return null;
+        try {
+            return JSON.parse(readFileSync(sessionPath, "utf-8"));
+        }
+        catch (e) {
+            if (this.config.verbose) {
+                console.debug(`[CBrowser] Failed to load session ${name}: ${e.message}`);
+            }
+            return null;
+        }
+    }
+    /**
+     * Delete a saved session.
+     */
+    delete(name) {
+        const sessionPath = join(this.config.sessionsDir, `${name}.json`);
+        if (existsSync(sessionPath)) {
+            unlinkSync(sessionPath);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Delete sessions older than a given number of days.
+     */
+    cleanup(olderThanDays) {
+        const cutoff = Date.now() - olderThanDays * 24 * 60 * 60 * 1000;
+        const deleted = [];
+        const kept = [];
+        const files = readdirSync(this.config.sessionsDir);
+        for (const file of files) {
+            if (!file.endsWith(".json") || file === "last-session.json")
+                continue;
+            const filePath = join(this.config.sessionsDir, file);
+            const name = file.replace(".json", "");
+            try {
+                const data = JSON.parse(readFileSync(filePath, "utf-8"));
+                const lastUsed = new Date(data.lastUsed).getTime();
+                if (lastUsed < cutoff) {
+                    unlinkSync(filePath);
+                    deleted.push(name);
+                }
+                else {
+                    kept.push(name);
+                }
+            }
+            catch (e) {
+                console.debug(`[CBrowser] Session cleanup error for ${name}: ${e.message}`);
+                kept.push(name);
+            }
+        }
+        return { deleted, kept };
+    }
+    /**
+     * Export a session to a portable JSON file.
+     */
+    export(name, outputPath) {
+        const sessionPath = join(this.config.sessionsDir, `${name}.json`);
+        if (!existsSync(sessionPath))
+            return false;
+        const data = readFileSync(sessionPath, "utf-8");
+        writeFileSync(outputPath, data);
+        return true;
+    }
+    /**
+     * Import a session from a JSON file.
+     */
+    import(inputPath, name) {
+        if (!existsSync(inputPath))
+            return false;
+        try {
+            const data = JSON.parse(readFileSync(inputPath, "utf-8"));
+            data.name = name;
+            const sessionPath = join(this.config.sessionsDir, `${name}.json`);
+            writeFileSync(sessionPath, JSON.stringify(data, null, 2));
+            return true;
+        }
+        catch (e) {
+            console.debug(`[CBrowser] Import failed: ${e.message}`);
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/browser/session-manager.js.map

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

package/dist/browser.d.ts

@@ -18,6 +18,9 @@ export declare class CBrowser {
     private harEntries;
     private isRecordingHar;
     private skipSessionRestore;
+    private sessionManager;
+    private selectorCacheManager;
+    private overlayHandler;
     constructor(userConfig?: Partial<CBrowserConfig>);
     private get sessionStateFile();
     private saveSessionState;
@@ -233,7 +236,7 @@ export declare class CBrowser {
      * Handle filling a custom input (hidden input with custom UI).
      * Handles autocomplete, datepickers, custom text inputs, etc.
      */
-    handleCustomInput(hiddenInput: Locator, value: string, options?: {
+    handleCustomInput(hiddenInput: Locator, value: string, _options?: {
         verbose?: boolean;
     }): Promise<{
         success: boolean;
@@ -249,57 +252,23 @@ export declare class CBrowser {
         retryDelay?: number;
         dismissOverlays?: boolean;
     }): Promise<SmartRetryResult>;
-    /** Common overlay patterns for detection */
-    private static readonly OVERLAY_PATTERNS;
     /**
      * Detect and dismiss overlays (cookie consent, age verification, newsletter popups).
      * Constitutional safety: Yellow zone - logs all dismissed overlays.
      */
     dismissOverlay(options?: DismissOverlayOptions): Promise<DismissOverlayResult>;
-    /** Text content keywords for overlay type classification */
-    private static readonly OVERLAY_TEXT_PATTERNS;
-    /**
-     * Classify an overlay by its text content.
-     */
-    private classifyOverlayType;
-    /**
-     * Detect overlays on the page by analyzing position, z-index, pattern matching, and text content.
-     * Returns overlays sorted by z-index (highest first) so the topmost blocking overlay is dismissed first.
-     */
-    private detectOverlays;
-    /**
-     * Try clicking a button, with force fallback if another element intercepts.
-     */
-    private tryClickOverlayButton;
-    /**
-     * Attempt to dismiss a single detected overlay.
-     */
-    private tryDismissOverlay;
     /**
      * Find alternative selectors for an element.
      */
     private findAlternativeSelectors;
-    private selectorCache;
     /**
-     * Get the selector cache file path.
+     * Get current page domain for cache key generation.
      */
-    private getSelectorCachePath;
-    /**
-     * Load the selector cache from disk.
-     */
-    private loadSelectorCache;
-    /**
-     * Save the selector cache to disk.
-     */
-    private saveSelectorCache;
-    /**
-     * Get cache key for a selector (includes domain for context).
-     */
-    private getSelectorCacheKey;
+    private getCurrentDomain;
     /**
-     * Get current page domain.
+     * Sync the current domain to the selector cache manager.
      */
-    private getCurrentDomain;
+    private syncCacheDomain;
     /**
      * Cache a working alternative selector for future use.
      */