@zenalexa/unicli 0.207.1

package/dist/browser/idle-manager.js

@@ -0,0 +1,47 @@
+/**
+ * Idle timeout manager for the browser daemon.
+ * Auto-exits the daemon process when no CLI requests arrive
+ * and no extension is connected within the timeout period.
+ */
+export class IdleManager {
+    timeoutMs;
+    onIdle;
+    lastCliRequestTime = Date.now();
+    timer = null;
+    extensionConnected = false;
+    constructor(timeoutMs, onIdle) {
+        this.timeoutMs = timeoutMs;
+        this.onIdle = onIdle;
+        this.scheduleCheck();
+    }
+    /** Call when a CLI request arrives to reset the idle timer. */
+    onCliRequest() {
+        this.lastCliRequestTime = Date.now();
+    }
+    /** Track extension connection state. */
+    setExtensionConnected(connected) {
+        this.extensionConnected = connected;
+    }
+    /** Clean up timer. */
+    destroy() {
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+    }
+    scheduleCheck() {
+        const interval = Math.min(60_000, Math.max(10_000, this.timeoutMs / 4));
+        this.timer = setTimeout(() => {
+            const elapsed = Date.now() - this.lastCliRequestTime;
+            if (elapsed >= this.timeoutMs && !this.extensionConnected) {
+                this.onIdle();
+            }
+            else {
+                this.scheduleCheck();
+            }
+        }, interval);
+        // Don't keep process alive just for the timer
+        this.timer.unref();
+    }
+}
+//# sourceMappingURL=idle-manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"idle-manager.js","sourceRoot":"","sources":["../../src/browser/idle-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,OAAO,WAAW;IAMH;IACA;IANnB,kBAAkB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACxB,KAAK,GAAyC,IAAI,CAAC;IACnD,kBAAkB,GAAG,KAAK,CAAC;IAEnC,YACmB,SAAiB,EACjB,MAAkB;QADlB,cAAS,GAAT,SAAS,CAAQ;QACjB,WAAM,GAAN,MAAM,CAAY;QAEnC,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED,+DAA+D;IAC/D,YAAY;QACV,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvC,CAAC;IAED,wCAAwC;IACxC,qBAAqB,CAAC,SAAkB;QACtC,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC;IACtC,CAAC;IAED,sBAAsB;IACtB,OAAO;QACL,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IAEO,aAAa;QACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC;QACxE,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,kBAAkB,CAAC;YACrD,IAAI,OAAO,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBAC1D,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,CAAC;QACH,CAAC,EAAE,QAAQ,CAAC,CAAC;QACb,8CAA8C;QAC9C,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}

package/dist/browser/launcher.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Chrome browser launcher and discovery.
+ *
+ * Finds an existing Chrome instance with CDP enabled, or launches one.
+ * Supports macOS, Linux, and Windows.
+ */
+/**
+ * Find Chrome executable on this system.
+ */
+export declare function findChrome(): string | null;
+/**
+ * Check if a CDP port is responding.
+ */
+export declare function isCDPAvailable(port: number): Promise<boolean>;
+/**
+ * Launch Chrome with CDP enabled.
+ * Returns the port number.
+ */
+export declare function launchChrome(port?: number, options?: {
+    profile?: boolean;
+    headless?: boolean;
+}): Promise<number>;
+/**
+ * Get CDP port from environment or default.
+ */
+export declare function getCDPPort(): number;
+/**
+ * Resolve Electron app CDP endpoint.
+ * Returns WebSocket URL for the most suitable target, or null.
+ */
+export declare function resolveElectronEndpoint(site: string): Promise<{
+    wsUrl: string;
+    port: number;
+} | null>;
+/**
+ * Launch an Electron app with CDP debug port enabled.
+ * Returns when the CDP endpoint is ready.
+ */
+export declare function launchElectronApp(site: string): Promise<{
+    wsUrl: string;
+    port: number;
+}>;
+//# sourceMappingURL=launcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"launcher.d.ts","sourceRoot":"","sources":["../../src/browser/launcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4BH;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,GAAG,IAAI,CAe1C;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASnE;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,IAAI,GAAE,MAAyB,EAC/B,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAClD,OAAO,CAAC,MAAM,CAAC,CAwDjB;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAInC;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CA2CjD;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAqD1C"}

package/dist/browser/launcher.js

@@ -0,0 +1,257 @@
+/**
+ * Chrome browser launcher and discovery.
+ *
+ * Finds an existing Chrome instance with CDP enabled, or launches one.
+ * Supports macOS, Linux, and Windows.
+ */
+import { execSync, spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { getElectronApp } from "../electron-apps.js";
+const DEFAULT_CDP_PORT = 9222;
+/** Known Chrome executable paths by platform */
+const CHROME_PATHS = {
+    darwin: [
+        "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+        "/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary",
+        "/Applications/Chromium.app/Contents/MacOS/Chromium",
+    ],
+    linux: [
+        "google-chrome",
+        "google-chrome-stable",
+        "chromium-browser",
+        "chromium",
+    ],
+    win32: [
+        "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
+        "C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe",
+    ],
+};
+/**
+ * Find Chrome executable on this system.
+ */
+export function findChrome() {
+    const paths = CHROME_PATHS[process.platform] ?? [];
+    for (const p of paths) {
+        if (process.platform === "linux") {
+            try {
+                execSync(`which ${p}`, { stdio: "ignore" });
+                return p;
+            }
+            catch {
+                continue;
+            }
+        }
+        else if (existsSync(p)) {
+            return p;
+        }
+    }
+    return null;
+}
+/**
+ * Check if a CDP port is responding.
+ */
+export async function isCDPAvailable(port) {
+    try {
+        const resp = await fetch(`http://127.0.0.1:${port}/json`, {
+            signal: AbortSignal.timeout(1000),
+        });
+        return resp.ok;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Launch Chrome with CDP enabled.
+ * Returns the port number.
+ */
+export async function launchChrome(port = DEFAULT_CDP_PORT, options) {
+    const chromePath = findChrome();
+    if (!chromePath) {
+        throw new Error("Chrome not found. Install Google Chrome or set CHROME_PATH env var.");
+    }
+    // Check if already running with CDP
+    if (await isCDPAvailable(port)) {
+        return port;
+    }
+    // Launch Chrome with remote debugging
+    const args = [
+        `--remote-debugging-port=${String(port)}`,
+        "--no-first-run",
+        "--no-default-browser-check",
+    ];
+    // Dedicated automation profile — avoids polluting user's default Chrome profile
+    if (options?.profile) {
+        const profileDir = join(process.env.HOME ?? "~", ".unicli", "chrome-profile");
+        args.push(`--user-data-dir=${profileDir}`);
+    }
+    // Chrome's new headless mode (for CI / server environments)
+    if (options?.headless) {
+        args.push("--headless=new");
+    }
+    // Use env override if set
+    const actualPath = process.env.CHROME_PATH ?? chromePath;
+    const child = spawn(actualPath, args, {
+        detached: true,
+        stdio: "ignore",
+    });
+    child.unref();
+    // Wait for CDP to become available (poll every 200ms, max 10s)
+    const start = Date.now();
+    while (Date.now() - start < 10_000) {
+        if (await isCDPAvailable(port)) {
+            return port;
+        }
+        await new Promise((r) => setTimeout(r, 200));
+    }
+    throw new Error(`Chrome launched but CDP not available on port ${String(port)} after 10s`);
+}
+/**
+ * Get CDP port from environment or default.
+ */
+export function getCDPPort() {
+    const envPort = process.env.UNICLI_CDP_PORT;
+    if (envPort)
+        return parseInt(envPort, 10);
+    return DEFAULT_CDP_PORT;
+}
+/**
+ * Resolve Electron app CDP endpoint.
+ * Returns WebSocket URL for the most suitable target, or null.
+ */
+export async function resolveElectronEndpoint(site) {
+    // Check env override first
+    const envEndpoint = process.env.UNICLI_CDP_ENDPOINT;
+    if (envEndpoint) {
+        return { wsUrl: envEndpoint, port: 0 };
+    }
+    const app = getElectronApp(site);
+    if (!app)
+        return null;
+    if (!(await isCDPAvailable(app.port)))
+        return null;
+    // Discover targets and pick the best one
+    try {
+        const resp = await fetch(`http://127.0.0.1:${app.port}/json`, {
+            signal: AbortSignal.timeout(2000),
+        });
+        const targets = (await resp.json());
+        // Score targets: prefer page > app > webview, skip devtools/service_worker
+        const scored = targets
+            .filter((t) => !t.url.startsWith("devtools://") && t.type !== "service_worker")
+            .map((t) => ({
+            ...t,
+            score: (t.type === "page" ? 80 : t.type === "app" ? 120 : 60) +
+                (t.url.startsWith("http") ? 10 : 0),
+        }))
+            .sort((a, b) => b.score - a.score);
+        if (scored.length === 0)
+            return null;
+        return { wsUrl: scored[0].webSocketDebuggerUrl, port: app.port };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Launch an Electron app with CDP debug port enabled.
+ * Returns when the CDP endpoint is ready.
+ */
+export async function launchElectronApp(site) {
+    const app = getElectronApp(site);
+    if (!app)
+        throw new Error(`Unknown Electron app: ${site}`);
+    // Already running with CDP?
+    const existing = await resolveElectronEndpoint(site);
+    if (existing)
+        return existing;
+    // Check if process is running without CDP
+    try {
+        const { execSync: syncExec } = await import("node:child_process");
+        const result = syncExec(`pgrep -f "${app.processName}"`, {
+            encoding: "utf-8",
+        });
+        if (result.trim()) {
+            throw new Error(`${app.displayName ?? site} is running but CDP port ${app.port} is not available. ` +
+                `Restart the app with: --remote-debugging-port=${app.port}`);
+        }
+    }
+    catch (err) {
+        if (err instanceof Error && err.message.includes("Restart"))
+            throw err;
+        // pgrep not found or no process — continue to launch
+    }
+    // Discover app path
+    const appPath = await findElectronAppPath(app);
+    if (!appPath) {
+        throw new Error(`Could not find ${app.displayName ?? site}. Install it or set UNICLI_CDP_ENDPOINT.`);
+    }
+    // Launch with CDP port
+    const { spawn: spawnProc } = await import("node:child_process");
+    const args = [
+        `--remote-debugging-port=${app.port}`,
+        ...(app.extraArgs ?? []),
+    ];
+    const proc = spawnProc(appPath, args, { detached: true, stdio: "ignore" });
+    proc.unref();
+    // Poll until CDP is available
+    const deadline = Date.now() + 10_000;
+    while (Date.now() < deadline) {
+        await new Promise((r) => setTimeout(r, 500));
+        const endpoint = await resolveElectronEndpoint(site);
+        if (endpoint)
+            return endpoint;
+    }
+    throw new Error(`${app.displayName ?? site} failed to start CDP on port ${app.port} within 10s`);
+}
+/**
+ * Find the executable path for an Electron app.
+ * macOS: mdfind by bundle ID, fallback to /Applications.
+ */
+async function findElectronAppPath(app) {
+    if (process.platform === "darwin") {
+        // Try mdfind first
+        if (app.bundleId) {
+            try {
+                const { execSync: syncExec } = await import("node:child_process");
+                const result = syncExec(`mdfind "kMDItemCFBundleIdentifier == '${app.bundleId}'" | head -1`, { encoding: "utf-8" }).trim();
+                if (result) {
+                    const execName = app.executableNames?.[0] ?? app.processName;
+                    return `${result}/Contents/MacOS/${execName}`;
+                }
+            }
+            catch {
+                /* mdfind failed */
+            }
+        }
+        // Fallback: check /Applications
+        const { existsSync: fsExists } = await import("node:fs");
+        const appName = app.displayName ?? app.processName;
+        const candidates = [
+            `/Applications/${appName}.app/Contents/MacOS/${app.executableNames?.[0] ?? app.processName}`,
+            `/Applications/${appName}.app/Contents/MacOS/Electron`,
+            `${process.env.HOME}/Applications/${appName}.app/Contents/MacOS/${app.executableNames?.[0] ?? app.processName}`,
+        ];
+        for (const p of candidates) {
+            if (fsExists(p))
+                return p;
+        }
+    }
+    // Linux: check PATH
+    if (process.platform === "linux") {
+        try {
+            const { execSync: syncExec } = await import("node:child_process");
+            const result = syncExec(`which ${app.processName.toLowerCase()}`, {
+                encoding: "utf-8",
+            }).trim();
+            if (result)
+                return result;
+        }
+        catch {
+            /* not in PATH */
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=launcher.js.map

package/dist/browser/launcher.js.map

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

package/dist/browser/page.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Browser page abstraction -- implements IPage interface via CDP.
+ *
+ * Provides high-level operations (goto, evaluate, click, type, cookies)
+ * on top of the raw CDPClient WebSocket connection.
+ */
+import { CDPClient } from "./cdp-client.js";
+import type { IPage, SnapshotOptions, ScreenshotOptions, NetworkRequest } from "../types.js";
+/** Captured network response with body content */
+export interface NetworkCaptureEntry {
+    url: string;
+    method: string;
+    status: number;
+    contentType: string;
+    responseBody?: string;
+    size: number;
+    timestamp: number;
+}
+export declare class BrowserPage implements IPage {
+    private client;
+    private _networkEnabled;
+    private _networkRequests;
+    private _networkCapture;
+    private _networkCaptureEnabled;
+    private _networkCapturePattern?;
+    private _requestMethods;
+    constructor(client: CDPClient);
+    /**
+     * Navigate to a URL and wait for page load.
+     */
+    goto(url: string, options?: {
+        settleMs?: number;
+        waitUntil?: string;
+    }): Promise<void>;
+    /**
+     * Execute JavaScript in the page context and return the result.
+     */
+    evaluate(expression: string): Promise<unknown>;
+    /**
+     * Click an element by CSS selector.
+     * Attempts CDP DOM-based click first, falls back to JS click.
+     */
+    click(selector: string): Promise<void>;
+    /**
+     * Type text into a specific element (focuses it first via click).
+     */
+    type(selector: string, text: string): Promise<void>;
+    /**
+     * Press a keyboard key, optionally with modifier keys.
+     */
+    press(key: string, modifiers?: string[]): Promise<void>;
+    /**
+     * Wait for a fixed number of seconds.
+     */
+    wait(seconds: number): Promise<void>;
+    /**
+     * Wait for a CSS selector to appear in the DOM.
+     */
+    waitForSelector(selector: string, timeout?: number): Promise<void>;
+    /**
+     * Get all cookies for the current page, returned as name-value pairs.
+     */
+    cookies(): Promise<Record<string, string>>;
+    /**
+     * Get page title.
+     */
+    title(): Promise<string>;
+    /**
+     * Get current URL.
+     */
+    url(): Promise<string>;
+    /**
+     * Inject a script to evaluate on every new document.
+     */
+    addInitScript(source: string): Promise<void>;
+    /**
+     * Scroll the page in a direction.
+     */
+    scroll(direction?: "down" | "up" | "bottom" | "top"): Promise<void>;
+    /**
+     * Polymorphic wait: milliseconds (number) or CSS selector (string).
+     */
+    waitFor(condition: number | string, timeout?: number): Promise<void>;
+    /**
+     * Insert text directly via CDP Input.insertText.
+     * Bypasses controlled input handling (React, Vue, etc.).
+     */
+    insertText(text: string): Promise<void>;
+    /**
+     * Coordinate-based native click via CDP mouse events.
+     */
+    nativeClick(x: number, y: number): Promise<void>;
+    /**
+     * Native key press with optional modifiers via CDP.
+     */
+    nativeKeyPress(key: string, modifiers?: string[]): Promise<void>;
+    /**
+     * Upload files to a file input element via CDP.
+     */
+    setFileInput(selector: string, files: string[]): Promise<void>;
+    /**
+     * Automatically scroll to the bottom of the page.
+     * Useful for infinite-scroll pages.
+     */
+    autoScroll(opts?: {
+        maxScrolls?: number;
+        delay?: number;
+    }): Promise<void>;
+    /**
+     * Capture a screenshot of the page.
+     */
+    screenshot(opts?: ScreenshotOptions): Promise<Buffer>;
+    /**
+     * Collect network requests. Enables Network domain on first call
+     * and accumulates responses from that point on.
+     */
+    networkRequests(): Promise<NetworkRequest[]>;
+    /**
+     * Start capturing network responses with body content.
+     * Optionally filter by URL pattern (substring match or /regex/).
+     *
+     * Unlike networkRequests() which only captures metadata, this method
+     * also fetches the response body via Network.getResponseBody.
+     *
+     * Captured entries are read and drained via readNetworkCapture().
+     */
+    startNetworkCapture(pattern?: string): Promise<void>;
+    /**
+     * Read all captured network entries and clear the buffer.
+     * Call startNetworkCapture() first to begin capturing.
+     */
+    readNetworkCapture(): Promise<NetworkCaptureEntry[]>;
+    /**
+     * Generate a DOM snapshot (accessibility-style text tree).
+     * Interactive elements are annotated with [N] refs.
+     */
+    snapshot(opts?: SnapshotOptions): Promise<string>;
+    /**
+     * Raw CDP command passthrough for stealth injection etc.
+     */
+    sendCDP(method: string, params?: Record<string, unknown>, sessionId?: string): Promise<unknown>;
+    /**
+     * Close/disconnect from the page.
+     */
+    close(): Promise<void>;
+    /**
+     * Close the entire browser window. Best-effort -- browser may already be gone.
+     */
+    closeWindow(): Promise<void>;
+    /**
+     * Static convenience: connect to Chrome and return a BrowserPage.
+     */
+    static connect(port?: number): Promise<BrowserPage>;
+}
+//# sourceMappingURL=page.d.ts.map

package/dist/browser/page.d.ts.map

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