@desplega.ai/qa-use 2.1.7 → 2.2.3

package/dist/lib/api/browser-types.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Type definitions for the Browser API (/browsers/v1/)
+ */
+export type BrowserSessionStatus = 'starting' | 'active' | 'closing' | 'closed';
+export type ViewportType = 'desktop' | 'mobile' | 'tablet';
+export interface CreateBrowserSessionOptions {
+    headless?: boolean;
+    viewport?: ViewportType;
+    timeout?: number;
+    ws_url?: string;
+}
+export interface BrowserSession {
+    id: string;
+    status: BrowserSessionStatus;
+    created_at: string;
+    updated_at?: string;
+    current_url?: string;
+    viewport?: ViewportType;
+    headless?: boolean;
+    timeout?: number;
+}
+export type BrowserActionType = 'goto' | 'back' | 'forward' | 'reload' | 'click' | 'fill' | 'type' | 'press' | 'hover' | 'scroll' | 'scroll_into_view' | 'select' | 'check' | 'uncheck' | 'wait' | 'wait_for_selector' | 'wait_for_load' | 'snapshot' | 'screenshot';
+export type ScrollDirection = 'up' | 'down' | 'left' | 'right';
+export interface GotoAction {
+    type: 'goto';
+    url: string;
+}
+export interface BackAction {
+    type: 'back';
+}
+export interface ForwardAction {
+    type: 'forward';
+}
+export interface ReloadAction {
+    type: 'reload';
+}
+export interface ClickAction {
+    type: 'click';
+    ref?: string;
+    text?: string;
+}
+export interface FillAction {
+    type: 'fill';
+    ref?: string;
+    text?: string;
+    value: string;
+}
+export interface TypeAction {
+    type: 'type';
+    ref: string;
+    text: string;
+}
+export interface PressAction {
+    type: 'press';
+    key: string;
+}
+export interface HoverAction {
+    type: 'hover';
+    ref?: string;
+    text?: string;
+}
+export interface ScrollAction {
+    type: 'scroll';
+    direction: ScrollDirection;
+    amount?: number;
+}
+export interface SelectAction {
+    type: 'select';
+    ref?: string;
+    text?: string;
+    value: string;
+}
+export interface CheckAction {
+    type: 'check';
+    ref?: string;
+    text?: string;
+}
+export interface UncheckAction {
+    type: 'uncheck';
+    ref?: string;
+    text?: string;
+}
+export interface ScrollIntoViewAction {
+    type: 'scroll_into_view';
+    ref?: string;
+    text?: string;
+}
+export interface WaitAction {
+    type: 'wait';
+    duration_ms: number;
+}
+export interface WaitForSelectorAction {
+    type: 'wait_for_selector';
+    selector: string;
+    state?: 'visible' | 'hidden' | 'attached' | 'detached';
+}
+export interface WaitForLoadAction {
+    type: 'wait_for_load';
+    state?: 'load' | 'domcontentloaded' | 'networkidle';
+}
+export interface SnapshotAction {
+    type: 'snapshot';
+}
+export interface ScreenshotAction {
+    type: 'screenshot';
+}
+export type BrowserAction = GotoAction | BackAction | ForwardAction | ReloadAction | ClickAction | FillAction | TypeAction | PressAction | HoverAction | ScrollAction | ScrollIntoViewAction | SelectAction | CheckAction | UncheckAction | WaitAction | WaitForSelectorAction | WaitForLoadAction | SnapshotAction | ScreenshotAction;
+export interface ActionResult {
+    success: boolean;
+    error?: string;
+    data?: unknown;
+}
+export interface SnapshotResult {
+    snapshot: string;
+    url?: string;
+}
+export interface UrlResult {
+    url: string;
+}
+export interface BlocksResult {
+    blocks: unknown[];
+}
+export type WebSocketEventType = 'action_started' | 'action_completed' | 'status_changed' | 'error' | 'closed';
+export interface WebSocketEvent {
+    type: WebSocketEventType;
+    data?: unknown;
+    timestamp?: string;
+}
+export interface ActionStartedEvent extends WebSocketEvent {
+    type: 'action_started';
+    data: {
+        action_type: BrowserActionType;
+        action_id?: string;
+    };
+}
+export interface ActionCompletedEvent extends WebSocketEvent {
+    type: 'action_completed';
+    data: {
+        action_id?: string;
+        success: boolean;
+        error?: string;
+        result?: unknown;
+    };
+}
+export interface StatusChangedEvent extends WebSocketEvent {
+    type: 'status_changed';
+    data: {
+        status: BrowserSessionStatus;
+    };
+}
+export interface ErrorEvent extends WebSocketEvent {
+    type: 'error';
+    data: {
+        message: string;
+        code?: string;
+    };
+}
+export interface ClosedEvent extends WebSocketEvent {
+    type: 'closed';
+    data?: {
+        reason?: string;
+    };
+}
+export interface PingMessage {
+    type: 'ping';
+}
+export interface ActionMessage {
+    type: 'action';
+    data: BrowserAction;
+}
+export interface GetStatusMessage {
+    type: 'get_status';
+}
+export type ClientMessage = PingMessage | ActionMessage | GetStatusMessage;
+//# sourceMappingURL=browser-types.d.ts.map

package/dist/lib/api/browser-types.d.ts.map

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

package/dist/lib/api/browser-types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for the Browser API (/browsers/v1/)
+ */
+export {};
+//# sourceMappingURL=browser-types.js.map

package/dist/lib/api/browser-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-types.js","sourceRoot":"","sources":["../../../lib/api/browser-types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/lib/api/browser.d.ts

@@ -0,0 +1,66 @@
+/**
+ * BrowserApiClient - Client for the desplega.ai Browser API (/browsers/v1/)
+ */
+import type { BrowserSession, BrowserAction, ActionResult, SnapshotResult, CreateBrowserSessionOptions, BrowserSessionStatus } from './browser-types.js';
+import type { ExtendedStep } from '../../src/types/test-definition.js';
+export declare class BrowserApiClient {
+    private readonly client;
+    private apiKey;
+    constructor(baseUrl?: string);
+    setApiKey(apiKey: string): void;
+    getApiKey(): string | null;
+    getBaseUrl(): string;
+    /**
+     * Create a new browser session
+     */
+    createSession(options?: CreateBrowserSessionOptions): Promise<BrowserSession>;
+    /**
+     * List all sessions for the organization
+     */
+    listSessions(): Promise<BrowserSession[]>;
+    /**
+     * Get a specific session by ID
+     */
+    getSession(sessionId: string): Promise<BrowserSession>;
+    /**
+     * Delete/close a session
+     */
+    deleteSession(sessionId: string): Promise<void>;
+    /**
+     * Wait for a session to reach a specific status
+     * @param sessionId - The session ID to wait for
+     * @param targetStatus - The status to wait for (default: 'active')
+     * @param timeoutMs - Maximum time to wait in milliseconds (default: 30000)
+     * @param pollIntervalMs - Polling interval in milliseconds (default: 1000)
+     */
+    waitForStatus(sessionId: string, targetStatus?: BrowserSessionStatus, timeoutMs?: number, pollIntervalMs?: number): Promise<BrowserSession>;
+    /**
+     * Execute a browser action
+     */
+    executeAction(sessionId: string, action: BrowserAction): Promise<ActionResult>;
+    /**
+     * Get the ARIA accessibility tree snapshot
+     */
+    getSnapshot(sessionId: string): Promise<SnapshotResult>;
+    /**
+     * Get a screenshot of the current page
+     * @returns Buffer containing PNG image data
+     */
+    getScreenshot(sessionId: string): Promise<Buffer>;
+    /**
+     * Get the current page URL
+     */
+    getUrl(sessionId: string): Promise<string>;
+    /**
+     * Get recorded blocks (test steps) from the session
+     * @returns Array of ExtendedStep objects
+     */
+    getBlocks(sessionId: string): Promise<ExtendedStep[]>;
+    /**
+     * Get the WebSocket URL for streaming events
+     */
+    getStreamUrl(sessionId: string): string;
+    private handleError;
+}
+export type { BrowserSession, BrowserAction, ActionResult, SnapshotResult, UrlResult, CreateBrowserSessionOptions, BrowserSessionStatus, } from './browser-types.js';
+//# sourceMappingURL=browser.d.ts.map

package/dist/lib/api/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../lib/api/browser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,YAAY,EACZ,cAAc,EAGd,2BAA2B,EAC3B,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAEvE,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,MAAM,CAAuB;gBAEzB,OAAO,CAAC,EAAE,MAAM;IAmB5B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B,SAAS,IAAI,MAAM,GAAG,IAAI;IAI1B,UAAU,IAAI,MAAM;IAQpB;;OAEG;IACG,aAAa,CAAC,OAAO,GAAE,2BAAgC,GAAG,OAAO,CAAC,cAAc,CAAC;IAevF;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAU/C;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAS5D;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrD;;;;;;OAMG;IACG,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,YAAY,GAAE,oBAA+B,EAC7C,SAAS,GAAE,MAAc,EACzB,cAAc,GAAE,MAAa,GAC5B,OAAO,CAAC,cAAc,CAAC;IA0B1B;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAapF;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAS7D;;;OAGG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWvD;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUhD;;;OAGG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAc3D;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAWvC,OAAO,CAAC,WAAW;CA4BpB;AAGD,YAAY,EACV,cAAc,EACd,aAAa,EACb,YAAY,EACZ,cAAc,EACd,SAAS,EACT,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,oBAAoB,CAAC"}

package/dist/lib/api/browser.js

@@ -0,0 +1,223 @@
+/**
+ * BrowserApiClient - Client for the desplega.ai Browser API (/browsers/v1/)
+ */
+import axios from 'axios';
+import { getEnv } from '../env/index.js';
+export class BrowserApiClient {
+    client;
+    apiKey = null;
+    constructor(baseUrl) {
+        // Use environment variable if available, otherwise use provided baseUrl, finally fall back to production
+        const apiUrl = getEnv('QA_USE_API_URL') || baseUrl || 'https://api.desplega.ai';
+        this.client = axios.create({
+            baseURL: `${apiUrl}/browsers/v1`,
+            timeout: 60000, // Longer timeout for browser operations
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        });
+        // Auto-load API key from environment or config file if available
+        const envApiKey = getEnv('QA_USE_API_KEY');
+        if (envApiKey) {
+            this.setApiKey(envApiKey);
+        }
+    }
+    setApiKey(apiKey) {
+        this.apiKey = apiKey;
+        this.client.defaults.headers['Authorization'] = `Bearer ${apiKey}`;
+    }
+    getApiKey() {
+        return this.apiKey;
+    }
+    getBaseUrl() {
+        return this.client.defaults.baseURL || 'https://api.desplega.ai/browsers/v1';
+    }
+    // ==========================================
+    // Session Management
+    // ==========================================
+    /**
+     * Create a new browser session
+     */
+    async createSession(options = {}) {
+        try {
+            const response = await this.client.post('/sessions', {
+                headless: options.headless ?? true,
+                viewport: options.viewport ?? 'desktop',
+                timeout: options.timeout ?? 300,
+                ...(options.ws_url && { ws_url: options.ws_url }),
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw this.handleError(error, 'create session');
+        }
+    }
+    /**
+     * List all sessions for the organization
+     */
+    async listSessions() {
+        try {
+            const response = await this.client.get('/sessions');
+            // API may return { sessions: [...] } or just [...]
+            return Array.isArray(response.data) ? response.data : response.data.sessions || [];
+        }
+        catch (error) {
+            throw this.handleError(error, 'list sessions');
+        }
+    }
+    /**
+     * Get a specific session by ID
+     */
+    async getSession(sessionId) {
+        try {
+            const response = await this.client.get(`/sessions/${sessionId}`);
+            return response.data;
+        }
+        catch (error) {
+            throw this.handleError(error, 'get session');
+        }
+    }
+    /**
+     * Delete/close a session
+     */
+    async deleteSession(sessionId) {
+        try {
+            await this.client.delete(`/sessions/${sessionId}`);
+        }
+        catch (error) {
+            throw this.handleError(error, 'delete session');
+        }
+    }
+    /**
+     * Wait for a session to reach a specific status
+     * @param sessionId - The session ID to wait for
+     * @param targetStatus - The status to wait for (default: 'active')
+     * @param timeoutMs - Maximum time to wait in milliseconds (default: 30000)
+     * @param pollIntervalMs - Polling interval in milliseconds (default: 1000)
+     */
+    async waitForStatus(sessionId, targetStatus = 'active', timeoutMs = 30000, pollIntervalMs = 1000) {
+        const startTime = Date.now();
+        while (Date.now() - startTime < timeoutMs) {
+            const session = await this.getSession(sessionId);
+            if (session.status === targetStatus) {
+                return session;
+            }
+            // If session is closed or failed, throw error
+            if (session.status === 'closed') {
+                throw new Error(`Session ${sessionId} is closed`);
+            }
+            // Wait before polling again
+            await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+        }
+        throw new Error(`Timeout waiting for session ${sessionId} to reach status "${targetStatus}"`);
+    }
+    // ==========================================
+    // Actions
+    // ==========================================
+    /**
+     * Execute a browser action
+     */
+    async executeAction(sessionId, action) {
+        try {
+            const response = await this.client.post(`/sessions/${sessionId}/action`, action);
+            return response.data;
+        }
+        catch (error) {
+            throw this.handleError(error, `execute action "${action.type}"`);
+        }
+    }
+    // ==========================================
+    // Inspection
+    // ==========================================
+    /**
+     * Get the ARIA accessibility tree snapshot
+     */
+    async getSnapshot(sessionId) {
+        try {
+            const response = await this.client.get(`/sessions/${sessionId}/snapshot`);
+            return response.data;
+        }
+        catch (error) {
+            throw this.handleError(error, 'get snapshot');
+        }
+    }
+    /**
+     * Get a screenshot of the current page
+     * @returns Buffer containing PNG image data
+     */
+    async getScreenshot(sessionId) {
+        try {
+            const response = await this.client.get(`/sessions/${sessionId}/screenshot`, {
+                responseType: 'arraybuffer',
+            });
+            return Buffer.from(response.data);
+        }
+        catch (error) {
+            throw this.handleError(error, 'get screenshot');
+        }
+    }
+    /**
+     * Get the current page URL
+     */
+    async getUrl(sessionId) {
+        try {
+            const response = await this.client.get(`/sessions/${sessionId}/url`);
+            const result = response.data;
+            return result.url;
+        }
+        catch (error) {
+            throw this.handleError(error, 'get URL');
+        }
+    }
+    /**
+     * Get recorded blocks (test steps) from the session
+     * @returns Array of ExtendedStep objects
+     */
+    async getBlocks(sessionId) {
+        try {
+            const response = await this.client.get(`/sessions/${sessionId}/blocks`);
+            const result = response.data;
+            return (result.blocks || []);
+        }
+        catch (error) {
+            throw this.handleError(error, 'get blocks');
+        }
+    }
+    // ==========================================
+    // WebSocket Streaming
+    // ==========================================
+    /**
+     * Get the WebSocket URL for streaming events
+     */
+    getStreamUrl(sessionId) {
+        // Convert HTTP URL to WebSocket URL
+        const baseUrl = this.getBaseUrl();
+        const wsUrl = baseUrl.replace(/^http/, 'ws');
+        return `${wsUrl}/sessions/${sessionId}/stream`;
+    }
+    // ==========================================
+    // Error Handling
+    // ==========================================
+    handleError(error, operation) {
+        if (axios.isAxiosError(error)) {
+            const statusCode = error.response?.status;
+            const errorData = error.response?.data;
+            if (statusCode === 404) {
+                return new Error(`Session not found`);
+            }
+            if (statusCode === 401) {
+                return new Error(`Unauthorized. Please check your API key.`);
+            }
+            if (statusCode === 403) {
+                return new Error(`Forbidden. You don't have permission for this operation.`);
+            }
+            const message = errorData?.message || errorData?.detail || `HTTP ${statusCode}: Failed to ${operation}`;
+            return new Error(message);
+        }
+        if (error instanceof Error) {
+            return error;
+        }
+        return new Error(`Unknown error during ${operation}`);
+    }
+}
+//# sourceMappingURL=browser.js.map

package/dist/lib/api/browser.js.map

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

package/dist/lib/browser/index.d.ts

@@ -1,4 +1,9 @@
 import type { BrowserServer, Browser } from 'playwright';
+export interface BrowserInstallationStatus {
+    installed: boolean;
+    executablePath: string | null;
+    error?: string;
+}
 export interface BrowserSession {
     browserServer: BrowserServer;
     wsEndpoint: string;
@@ -24,5 +29,10 @@ export declare class BrowserManager {
     checkHealth(): Promise<boolean>;
     getWebSocketEndpoint(): string | null;
     installPlaywrightBrowsers(): Promise<void>;
+    /**
+     * Check if Playwright Chromium browser is installed without launching it.
+     * This is a fast, cheap check that verifies the executable file exists.
+     */
+    checkBrowsersInstalled(): BrowserInstallationStatus;
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/browser/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/browser/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAMzD,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,aAAa,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA+B;IAExC,YAAY,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;IAmDnE,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAe5B,gBAAgB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAYjD,UAAU,IAAI,cAAc,GAAG,IAAI;IAInC,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAerC,oBAAoB,IAAI,MAAM,GAAG,IAAI;IAI/B,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC;CAgDjD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/browser/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAOzD,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,aAAa,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA+B;IAExC,YAAY,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;IAmDnE,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAe5B,gBAAgB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAYjD,UAAU,IAAI,cAAc,GAAG,IAAI;IAInC,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAerC,oBAAoB,IAAI,MAAM,GAAG,IAAI;IAI/B,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC;IAiDhD;;;OAGG;IACH,sBAAsB,IAAI,yBAAyB;CAyBpD"}

package/dist/lib/browser/index.js

@@ -1,6 +1,7 @@
 import { chromium } from 'playwright';
 import { fork } from 'child_process';
 import path from 'path';
+import fs from 'fs';
 import { createRequire } from 'module';
 import { fileURLToPath } from 'url';
 export class BrowserManager {
@@ -141,5 +142,33 @@ export class BrowserManager {
             }
         });
     }
+    /**
+     * Check if Playwright Chromium browser is installed without launching it.
+     * This is a fast, cheap check that verifies the executable file exists.
+     */
+    checkBrowsersInstalled() {
+        try {
+            const executablePath = chromium.executablePath();
+            // Check if the executable file actually exists
+            if (fs.existsSync(executablePath)) {
+                return {
+                    installed: true,
+                    executablePath,
+                };
+            }
+            return {
+                installed: false,
+                executablePath: null,
+                error: `Chromium executable not found at expected path: ${executablePath}`,
+            };
+        }
+        catch (error) {
+            return {
+                installed: false,
+                executablePath: null,
+                error: error.message,
+            };
+        }
+    }
 }
 //# sourceMappingURL=index.js.map

package/dist/lib/browser/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/browser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAgBpC,MAAM,OAAO,cAAc;IACjB,OAAO,GAA0B,IAAI,CAAC;IAE9C,KAAK,CAAC,YAAY,CAAC,UAA0B,EAAE;QAC7C,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QAED,MAAM,WAAW,GAAG;YAClB,yBAAyB;YACzB,cAAc;YACd,0BAA0B;YAC1B,eAAe;YACf,uCAAuC;YACvC,kCAAkC;YAClC,0CAA0C;YAC1C,cAAc;YACd,sBAAsB;YACtB,0DAA0D;YAC1D,mBAAmB;YACnB,2BAA2B;SAC5B,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC;gBAChD,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;gBAClC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,KAAK;gBACnC,IAAI,EAAE,CAAC,GAAG,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;gBAC/C,YAAY,EAAE,KAAK;gBACnB,aAAa,EAAE,KAAK;aACrB,CAAC,CAAC;YAEH,MAAM,UAAU,GAAG,aAAa,CAAC,UAAU,EAAE,CAAC;YAE9C,IAAI,CAAC,OAAO,GAAG;gBACb,aAAa;gBACb,UAAU;gBACV,QAAQ,EAAE,IAAI;aACf,CAAC;YAEF,OAAO,IAAI,CAAC,OAAO,CAAC;QACtB,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IACE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAC;gBAClD,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAC5C,CAAC;gBACD,MAAM,IAAI,KAAK,CACb,qFAAqF,CACtF,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,WAAW;QACf,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QAEpB,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,iCAAiC;QACnC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC;YACH,OAAO,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,IAAI,KAAK,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW;QACf,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAEhC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE;gBAC9D,OAAO,EAAE,IAAI,EAAE,mBAAmB;aACnC,CAAC,CAAC;YACH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,oBAAoB;QAClB,OAAO,IAAI,CAAC,OAAO,EAAE,UAAU,IAAI,IAAI,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,yBAAyB;QAC7B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC;gBACH,0DAA0D;gBAC1D,sDAAsD;gBACtD,yCAAyC;gBACzC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC/C,MAAM,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;gBACzE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,EAAE,QAAQ,CAAC,CAAC;gBAEzE,OAAO,CAAC,KAAK,CAAC,kDAAkD,OAAO,EAAE,CAAC,CAAC;gBAE3E,oDAAoD;gBACpD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE;oBACnD,KAAK,EAAE,MAAM;iBACd,CAAC,CAAC;gBAEH,MAAM,MAAM,GAAa,EAAE,CAAC;gBAE5B,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;oBAChC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAChC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBACrB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,yBAAyB;gBACnD,CAAC,CAAC,CAAC;gBAEH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;oBAChC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAChC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBACrB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB;gBACjD,CAAC,CAAC,CAAC;gBAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;oBACzB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;wBACf,OAAO,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;wBAC9D,OAAO,EAAE,CAAC;oBACZ,CAAC;yBAAM,CAAC;wBACN,MAAM,CAAC,IAAI,KAAK,CAAC,8BAA8B,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;oBACrE,CAAC;gBACH,CAAC,CAAC,CAAC;gBAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;oBAC1B,MAAM,CAAC,IAAI,KAAK,CAAC,yCAAyC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBAC9E,CAAC,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,MAAM,CAAC,IAAI,KAAK,CAAC,oCAAoC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACzE,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/browser/index.ts"],"names":[],"mappings":"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"}

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@desplega.ai/qa-use",
-    "version": "2.1.7",
+    "version": "2.2.3",
     "packageManager": "bun@^1.3.4",
     "description": "QA automation tool for browser testing with MCP server support",
     "type": "module",
@@ -95,6 +95,7 @@
         "express": "^4.21.2",
         "glob": "^13.0.0",
         "playwright": "1.55.0",
+        "ws": "^8.19.0",
         "yaml": "^2.8.2"
     }
 }

package/dist/src/cli/commands/browser/back.d.ts

@@ -0,0 +1,6 @@
+/**
+ * qa-use browser back - Navigate back in browser history
+ */
+import { Command } from 'commander';
+export declare const backCommand: Command;
+//# sourceMappingURL=back.d.ts.map

package/dist/src/cli/commands/browser/back.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"back.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/browser/back.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,eAAO,MAAM,WAAW,SAkCpB,CAAC"}

package/dist/src/cli/commands/browser/back.js

@@ -0,0 +1,42 @@
+/**
+ * qa-use browser back - Navigate back in browser history
+ */
+import { Command } from 'commander';
+import { BrowserApiClient } from '../../../../lib/api/browser.js';
+import { resolveSessionId, touchSession } from '../../lib/browser-sessions.js';
+import { loadConfig } from '../../lib/config.js';
+import { success, error } from '../../lib/output.js';
+export const backCommand = new Command('back')
+    .description('Navigate back in browser history')
+    .option('-s, --session-id <id>', 'Session ID (auto-resolved if only one session)')
+    .action(async (options) => {
+    try {
+        const config = await loadConfig();
+        if (!config.api_key) {
+            console.log(error('API key not configured. Run `qa-use setup` first.'));
+            process.exit(1);
+        }
+        const client = new BrowserApiClient(config.api_url);
+        client.setApiKey(config.api_key);
+        const resolved = await resolveSessionId({
+            explicitId: options.sessionId,
+            client,
+        });
+        const result = await client.executeAction(resolved.id, {
+            type: 'back',
+        });
+        if (result.success) {
+            console.log(success('Navigated back'));
+            await touchSession(resolved.id);
+        }
+        else {
+            console.log(error(result.error || 'Navigation failed'));
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        console.log(error(err instanceof Error ? err.message : 'Failed to navigate back'));
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=back.js.map