@thinkbrowse/cli 0.1.0

package/dist/src/adapters/cloud.js

@@ -0,0 +1,336 @@
+/**
+ * Cloud API adapter - connects to thinkbrowse.io API
+ */
+import { ApiError, SessionError } from '../errors.js';
+import { config } from '../config/store.js';
+export class CloudAdapter {
+    baseUrl;
+    apiKey;
+    defaultTimeout = 60000; // 60 seconds
+    constructor(apiKey, baseUrl) {
+        this.apiKey = apiKey || config.get('apiKey') || '';
+        this.baseUrl = baseUrl || config.get('apiUrl') || 'https://api.thinkbrowse.io';
+        if (!this.apiKey) {
+            throw new ApiError('API key not configured', 401, 'Run: thinkbrowse config set-key <your-api-key>');
+        }
+    }
+    async request(path, options = {}, retries = 3) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            'Content-Type': 'application/json',
+            'x-api-key': this.apiKey,
+            ...options.headers,
+        };
+        try {
+            const response = await fetch(url, {
+                method: options.method || 'GET',
+                headers,
+                body: options.body,
+                signal: AbortSignal.timeout(this.defaultTimeout),
+            });
+            const data = await response.json();
+            if (!response.ok) {
+                if (response.status === 401) {
+                    throw new ApiError('Invalid API key', 401, 'Check your API key with: thinkbrowse config show');
+                }
+                if (response.status === 404) {
+                    throw new SessionError(data.error || 'Session not found', 'The session may have expired. Create a new one with: thinkbrowse cloud start');
+                }
+                throw new ApiError(data.error || data.message || 'API request failed', response.status);
+            }
+            return data;
+        }
+        catch (error) {
+            // Retry on transient errors
+            if (retries > 0 && (error.code === 'ECONNRESET' || error.code === 'ETIMEDOUT' || error.status === 502 || error.status === 503)) {
+                await this.sleep(Math.pow(2, 3 - retries) * 1000);
+                return this.request(path, options, retries - 1);
+            }
+            // Re-throw our custom errors
+            if (error instanceof ApiError || error instanceof SessionError) {
+                throw error;
+            }
+            // Wrap unknown errors
+            throw new ApiError(error.message || 'Network request failed', undefined, 'Check your internet connection');
+        }
+    }
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    getActiveSessionId() {
+        const sessionId = config.get('activeSessionId');
+        if (!sessionId) {
+            throw new SessionError('No active session', 'Start a session with: thinkbrowse cloud start');
+        }
+        return sessionId;
+    }
+    // --- Session Management ---
+    async startSession(options = {}) {
+        const response = await this.request('/api/sessions', {
+            method: 'POST',
+            body: JSON.stringify({
+                browser: options.browser || config.get('defaultBrowser') || 'chromium',
+                proxyRotation: options.proxy ? { enabled: true } : undefined,
+                stealth: options.stealth,
+                headless: options.headless !== false,
+            }),
+        });
+        const session = {
+            sessionId: response.sessionId,
+            status: response.status,
+            createdAt: new Date().toISOString(),
+        };
+        config.set('activeSessionId', session.sessionId);
+        return session;
+    }
+    async waitForSessionReady(sessionId, timeout = 90000) {
+        const pollInterval = 2000;
+        const startTime = Date.now();
+        const terminalStatuses = ['active', 'ready', 'running', 'error', 'failed', 'terminated', 'closed'];
+        while (Date.now() - startTime < timeout) {
+            const session = await this.getSession(sessionId);
+            if (terminalStatuses.includes(session.status)) {
+                if (['error', 'failed', 'terminated', 'closed'].includes(session.status)) {
+                    throw new SessionError(`Session entered ${session.status} state during provisioning`, 'Try creating a new session with: thinkbrowse cloud start');
+                }
+                return session;
+            }
+            await this.sleep(pollInterval);
+        }
+        throw new SessionError('Session provisioning timed out', 'The session may still be starting. Check with: thinkbrowse cloud status');
+    }
+    async stopSession(sessionId) {
+        const id = sessionId || this.getActiveSessionId();
+        await this.request(`/api/sessions/${id}`, {
+            method: 'DELETE',
+        });
+        if (id === config.get('activeSessionId')) {
+            config.delete('activeSessionId');
+        }
+    }
+    async getSession(sessionId) {
+        return this.request(`/api/sessions/${sessionId}`);
+    }
+    async listSessions() {
+        const response = await this.request('/api/sessions?includeTerminated=false');
+        // Handle both array and { sessions: [] } response shapes
+        if (Array.isArray(response))
+            return response;
+        return response.sessions || [];
+    }
+    // --- Navigation ---
+    async navigate(url, options = {}) {
+        const sessionId = this.getActiveSessionId();
+        const response = await this.request(`/api/sessions/${sessionId}/navigate`, {
+            method: 'POST',
+            body: JSON.stringify({
+                url,
+                waitUntil: options.waitUntil || 'load',
+                timeout: options.timeout,
+            }),
+        });
+        return {
+            success: response.success,
+            data: {
+                url: response.url,
+                title: response.title,
+            },
+        };
+    }
+    async goBack() {
+        const sessionId = this.getActiveSessionId();
+        return this.request(`/api/sessions/${sessionId}/go-back`, {
+            method: 'POST',
+        });
+    }
+    async goForward() {
+        const sessionId = this.getActiveSessionId();
+        return this.request(`/api/sessions/${sessionId}/go-forward`, {
+            method: 'POST',
+        });
+    }
+    // --- Interaction ---
+    async click(selector, options = {}) {
+        const sessionId = this.getActiveSessionId();
+        const response = await this.request(`/api/sessions/${sessionId}/click`, {
+            method: 'POST',
+            body: JSON.stringify({
+                selector,
+                button: options.button || 'left',
+                clickCount: options.count || 1,
+                delay: options.delay,
+                timeout: options.timeout || 15000,
+            }),
+        });
+        return { success: response.success };
+    }
+    async type(selector, text, options = {}) {
+        const sessionId = this.getActiveSessionId();
+        const response = await this.request(`/api/sessions/${sessionId}/type`, {
+            method: 'POST',
+            body: JSON.stringify({
+                selector,
+                text,
+                delay: options.delay,
+            }),
+        });
+        return { success: response.success };
+    }
+    async fill(selector, value) {
+        const sessionId = this.getActiveSessionId();
+        const response = await this.request(`/api/sessions/${sessionId}/fill`, {
+            method: 'POST',
+            body: JSON.stringify({ selector, value }),
+        });
+        return { success: response.success };
+    }
+    async press(key) {
+        const sessionId = this.getActiveSessionId();
+        const response = await this.request(`/api/sessions/${sessionId}/press`, {
+            method: 'POST',
+            body: JSON.stringify({ key }),
+        });
+        return { success: response.success };
+    }
+    async scroll(options) {
+        const sessionId = this.getActiveSessionId();
+        const response = await this.request(`/api/sessions/${sessionId}/scroll`, {
+            method: 'POST',
+            body: JSON.stringify(options),
+        });
+        return { success: response.success };
+    }
+    async hover(selector) {
+        const sessionId = this.getActiveSessionId();
+        const response = await this.request(`/api/sessions/${sessionId}/hover`, {
+            method: 'POST',
+            body: JSON.stringify({ selector }),
+        });
+        return { success: response.success };
+    }
+    async select(selector, value) {
+        const sessionId = this.getActiveSessionId();
+        const response = await this.request(`/api/sessions/${sessionId}/select`, {
+            method: 'POST',
+            body: JSON.stringify({ selector, value }),
+        });
+        return { success: response.success };
+    }
+    // --- Waiting ---
+    async wait(condition, options = {}) {
+        // If condition is a number, it's a timeout in ms
+        if (typeof condition === 'number') {
+            await this.sleep(condition);
+            return { success: true };
+        }
+        // Use the dedicated wait endpoint
+        const sessionId = this.getActiveSessionId();
+        const state = options.hidden ? 'hidden' : options.visible ? 'visible' : 'visible';
+        return this.request(`/api/sessions/${sessionId}/wait`, {
+            method: 'POST',
+            body: JSON.stringify({
+                selector: condition,
+                state,
+                timeout: options.timeout || 30000,
+            }),
+        });
+    }
+    async waitForText(text, options = {}) {
+        const sessionId = this.getActiveSessionId();
+        return this.request(`/api/sessions/${sessionId}/wait-for-text`, {
+            method: 'POST',
+            body: JSON.stringify({
+                text,
+                timeout: options.timeout || 30000,
+            }),
+        });
+    }
+    // --- Observation ---
+    async snapshot() {
+        const sessionId = this.getActiveSessionId();
+        const response = await this.request(`/api/sessions/${sessionId}/snapshot`, { method: 'POST' });
+        return {
+            success: response.success,
+            data: response.snapshot,
+        };
+    }
+    async screenshot(options = {}) {
+        const sessionId = this.getActiveSessionId();
+        const response = await this.request(`/api/sessions/${sessionId}/screenshot`, {
+            method: 'POST',
+            body: JSON.stringify({
+                fullPage: options.fullPage,
+                selector: options.selector,
+                type: options.format || 'png',
+                quality: options.quality,
+                upload: true,
+            }),
+        });
+        return {
+            success: response.success,
+            data: {
+                url: response.publicUrl,
+                artifactId: response.artifactId,
+            },
+        };
+    }
+    async extract(selector, options = {}) {
+        const sessionId = this.getActiveSessionId();
+        const response = await this.request(`/api/sessions/${sessionId}/extract`, {
+            method: 'POST',
+            body: JSON.stringify({
+                selector,
+                type: options.attr ? 'attribute' : options.format || 'text',
+                attribute: options.attr,
+                multiple: options.all,
+            }),
+        });
+        return {
+            success: response.success,
+            data: response.data,
+        };
+    }
+    async evaluate(script, args = []) {
+        const sessionId = this.getActiveSessionId();
+        const response = await this.request(`/api/sessions/${sessionId}/evaluate`, {
+            method: 'POST',
+            body: JSON.stringify({ script, args }),
+        });
+        return {
+            success: response.success,
+            data: response.result,
+        };
+    }
+    // --- Dialog Handling ---
+    async getDialog() {
+        const sessionId = this.getActiveSessionId();
+        return this.request(`/api/sessions/${sessionId}/dialog`);
+    }
+    async handleDialog(action, promptText) {
+        const sessionId = this.getActiveSessionId();
+        return this.request(`/api/sessions/${sessionId}/dialog`, {
+            method: 'POST',
+            body: JSON.stringify({ accept: action === 'accept', promptText }),
+        });
+    }
+    // --- Monitoring ---
+    async getConsoleMessages() {
+        const sessionId = this.getActiveSessionId();
+        const result = await this.request(`/api/sessions/${sessionId}/console`);
+        return {
+            success: result.success,
+            logs: result.data?.logs || [],
+            count: result.data?.count || 0,
+        };
+    }
+    async getNetworkRequests() {
+        const sessionId = this.getActiveSessionId();
+        const result = await this.request(`/api/sessions/${sessionId}/network`);
+        return {
+            success: result.success,
+            requests: result.data?.requests || [],
+            count: result.data?.count || 0,
+        };
+    }
+}
+//# sourceMappingURL=cloud.js.map

package/dist/src/adapters/cloud.js.map

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

package/dist/src/adapters/types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Browser adapter interface
+ * Defines the contract for all browser backends (cloud, local, extension)
+ */
+import type { Session, SessionOptions, ActionResult, NavigateOptions, ClickOptions, TypeOptions, ScreenshotOptions, ExtractOptions, WaitOptions, DialogResult, ConsoleResult, NetworkResult } from '../types.js';
+export interface BrowserAdapter {
+    startSession(options?: SessionOptions): Promise<Session>;
+    stopSession(sessionId?: string): Promise<void>;
+    getSession(sessionId: string): Promise<Session>;
+    listSessions(): Promise<Session[]>;
+    waitForSessionReady(sessionId: string, timeout?: number): Promise<Session>;
+    navigate(url: string, options?: NavigateOptions): Promise<ActionResult>;
+    goBack(): Promise<ActionResult>;
+    goForward(): Promise<ActionResult>;
+    click(selector: string, options?: ClickOptions): Promise<ActionResult>;
+    type(selector: string, text: string, options?: TypeOptions): Promise<ActionResult>;
+    fill(selector: string, value: string): Promise<ActionResult>;
+    press(key: string): Promise<ActionResult>;
+    scroll(options: {
+        selector?: string;
+        x?: number;
+        y?: number;
+    }): Promise<ActionResult>;
+    hover(selector: string): Promise<ActionResult>;
+    select(selector: string, value: string): Promise<ActionResult>;
+    wait(condition: string | number, options?: WaitOptions): Promise<ActionResult>;
+    waitForText(text: string, options?: {
+        timeout?: number;
+    }): Promise<ActionResult>;
+    snapshot(): Promise<ActionResult>;
+    screenshot(options?: ScreenshotOptions): Promise<ActionResult>;
+    extract(selector: string, options?: ExtractOptions): Promise<ActionResult>;
+    evaluate(script: string, args?: any[]): Promise<ActionResult>;
+    getDialog(): Promise<DialogResult>;
+    handleDialog(action: 'accept' | 'dismiss', promptText?: string): Promise<ActionResult>;
+    getConsoleMessages(): Promise<ConsoleResult>;
+    getNetworkRequests(): Promise<NetworkResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/adapters/types.d.ts.map

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

package/dist/src/adapters/types.js

@@ -0,0 +1,6 @@
+/**
+ * Browser adapter interface
+ * Defines the contract for all browser backends (cloud, local, extension)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/adapters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/adapters/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/src/commands/actions.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Browser action commands
+ * Includes: navigate, click, type, scroll, wait, hover, select, screenshot, extract, evaluate,
+ *           back, forward, press, fill, snapshot, wait-for-text, dialog, console, network
+ */
+import { Command } from 'commander';
+export declare function createNavigateCommand(): Command;
+export declare function createClickCommand(): Command;
+export declare function createTypeCommand(): Command;
+export declare function createFillCommand(): Command;
+export declare function createScrollCommand(): Command;
+export declare function createWaitCommand(): Command;
+export declare function createWaitForTextCommand(): Command;
+export declare function createHoverCommand(): Command;
+export declare function createSelectCommand(): Command;
+export declare function createPressCommand(): Command;
+export declare function createBackCommand(): Command;
+export declare function createForwardCommand(): Command;
+export declare function createSnapshotCommand(): Command;
+export declare function createScreenshotCommand(): Command;
+export declare function createExtractCommand(): Command;
+export declare function createEvaluateCommand(): Command;
+export declare function createDialogCommand(): Command;
+export declare function createConsoleCommand(): Command;
+export declare function createNetworkCommand(): Command;
+//# sourceMappingURL=actions.d.ts.map

package/dist/src/commands/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/commands/actions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,wBAAgB,qBAAqB,IAAI,OAAO,CAkC/C;AAGD,wBAAgB,kBAAkB,IAAI,OAAO,CA0B5C;AAGD,wBAAgB,iBAAiB,IAAI,OAAO,CA0B3C;AAGD,wBAAgB,iBAAiB,IAAI,OAAO,CAiB3C;AAGD,wBAAgB,mBAAmB,IAAI,OAAO,CA+B7C;AAGD,wBAAgB,iBAAiB,IAAI,OAAO,CAmC3C;AAGD,wBAAgB,wBAAwB,IAAI,OAAO,CAoBlD;AAGD,wBAAgB,kBAAkB,IAAI,OAAO,CAgB5C;AAGD,wBAAgB,mBAAmB,IAAI,OAAO,CAiB7C;AAGD,wBAAgB,kBAAkB,IAAI,OAAO,CAgB5C;AAGD,wBAAgB,iBAAiB,IAAI,OAAO,CAe3C;AAGD,wBAAgB,oBAAoB,IAAI,OAAO,CAe9C;AAGD,wBAAgB,qBAAqB,IAAI,OAAO,CAiB/C;AAGD,wBAAgB,uBAAuB,IAAI,OAAO,CAoCjD;AAGD,wBAAgB,oBAAoB,IAAI,OAAO,CA8B9C;AAGD,wBAAgB,qBAAqB,IAAI,OAAO,CA4B/C;AAGD,wBAAgB,mBAAmB,IAAI,OAAO,CAqE7C;AAGD,wBAAgB,oBAAoB,IAAI,OAAO,CAiC9C;AAGD,wBAAgB,oBAAoB,IAAI,OAAO,CAqC9C"}