@roveapi/browser 1.0.0

package/README.md

@@ -0,0 +1,77 @@
+# @roveapi/browser
+
+Browser automation SDK for AI agents. Wraps the [Rove API](https://roveapi.com) — Playwright-as-a-Service with accessibility trees for 77% fewer tokens.
+
+## Install
+
+```bash
+npm install @roveapi/browser
+```
+
+## Quickstart
+
+```typescript
+import { BrowserClient } from '@roveapi/browser'
+
+const client = new BrowserClient({ apiKey: 'rvp_live_...' })
+
+// One-shot screenshot
+const screenshot = await client.screenshot({ url: 'https://example.com' })
+console.log(screenshot.url) // signed S3 URL
+
+// Session-based workflow
+const session = await client.session()
+await session.navigate('https://example.com')
+const tree = await session.getA11yTree()
+console.log(tree.result.tree) // accessibility tree (~26K tokens vs ~114K for screenshot)
+await session.click({ label: 'Get Started' })
+await session.fill({ selector: '#email', value: 'user@example.com' })
+await session.close()
+```
+
+## Error Handling
+
+```typescript
+import { BrowserClient, InsufficientCreditsError, RateLimitError } from '@roveapi/browser'
+
+try {
+  const session = await client.session()
+} catch (err) {
+  if (err instanceof InsufficientCreditsError) {
+    console.log('Top up credits at roveapi.com')
+  }
+  if (err instanceof RateLimitError) {
+    console.log(`Retry after ${err.retryAfter} seconds`)
+  }
+}
+```
+
+## API
+
+### `BrowserClient`
+
+```typescript
+new BrowserClient({ apiKey, baseUrl?, retries?, retryDelay? })
+```
+
+- `client.session(options?)` → `Session`
+- `client.screenshot({ url, selector?, fullPage?, format? })` → `ScreenshotResponse`
+- `client.extract({ url, schema, waitForSelector? })` → `ExtractResponse`
+- `client.usage()` → `UsageResponse`
+
+### `Session`
+
+- `session.navigate(url, options?)` — load URL, return title + status
+- `session.getA11yTree(options?)` — accessibility tree (primary tool for LLMs)
+- `session.click({ selector?, label? })` — click element
+- `session.fill({ selector?, label?, value })` — type into input
+- `session.select({ selector?, value? })` — select dropdown option
+- `session.scroll({ direction?, amount? })` — scroll page
+- `session.waitFor({ type, value })` — wait for condition
+- `session.screenshot({ fullPage?, format? })` — capture page
+- `session.getText(selector)` — extract text
+- `session.getAttribute(selector, attribute)` — get attribute
+- `session.evaluate(expression)` — run JavaScript
+- `session.close()` — close session, finalize artifacts
+
+Auto-retry on 503 (pool exhausted, browser crash) with exponential backoff. No retry on 402 (insufficient credits) or 410 (session expired).

package/dist/client.d.ts

@@ -0,0 +1,52 @@
+import { Session } from './session';
+import type { ScreenshotResponse, ExtractResponse, UsageResponse } from './types';
+export type BrowserClientOptions = {
+    apiKey: string;
+    baseUrl?: string;
+    retries?: number;
+    retryDelay?: number;
+};
+export declare class BrowserClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly retries;
+    private readonly retryDelay;
+    constructor(options: BrowserClientOptions);
+    /** Create a persistent browser session */
+    session(options?: {
+        viewport?: {
+            width: number;
+            height: number;
+        };
+        recordVideo?: boolean;
+        locale?: string;
+        timezone?: string;
+        userAgent?: string;
+        blockResources?: string[];
+    }): Promise<Session>;
+    /** One-shot screenshot (no persistent session) */
+    screenshot(params: {
+        url: string;
+        selector?: string;
+        fullPage?: boolean;
+        format?: 'png' | 'jpeg';
+        viewport?: {
+            width: number;
+            height: number;
+        };
+    }): Promise<ScreenshotResponse>;
+    /** One-shot structured data extraction */
+    extract(params: {
+        url: string;
+        schema: Record<string, string>;
+        waitForSelector?: string;
+    }): Promise<ExtractResponse>;
+    /** Get usage and credit balance */
+    usage(): Promise<UsageResponse>;
+    /** @internal — used by Session class */
+    request<T>(path: string, init: {
+        method: string;
+        body?: unknown;
+    }): Promise<T>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAEjF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;gBAEvB,OAAO,EAAE,oBAAoB;IAOzC,0CAA0C;IACpC,OAAO,CAAC,OAAO,CAAC,EAAE;QACtB,QAAQ,CAAC,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;QAC5C,WAAW,CAAC,EAAE,OAAO,CAAA;QACrB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;KAC1B,GAAG,OAAO,CAAC,OAAO,CAAC;IAapB,kDAAkD;IAC5C,UAAU,CAAC,MAAM,EAAE;QACvB,GAAG,EAAE,MAAM,CAAA;QACX,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;QACvB,QAAQ,CAAC,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KAC7C,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAa/B,0CAA0C;IACpC,OAAO,CAAC,MAAM,EAAE;QACpB,GAAG,EAAE,MAAM,CAAA;QACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC9B,eAAe,CAAC,EAAE,MAAM,CAAA;KACzB,GAAG,OAAO,CAAC,eAAe,CAAC;IAW5B,mCAAmC;IAC7B,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC;IAIrC,wCAAwC;IAClC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC;CAsCrF"}

package/dist/client.js

@@ -0,0 +1,94 @@
+import { Session } from './session';
+import { mapApiError } from './http';
+export class BrowserClient {
+    apiKey;
+    baseUrl;
+    retries;
+    retryDelay;
+    constructor(options) {
+        this.apiKey = options.apiKey;
+        this.baseUrl = options.baseUrl ?? 'https://api.roveapi.com';
+        this.retries = options.retries ?? 3;
+        this.retryDelay = options.retryDelay ?? 1000;
+    }
+    /** Create a persistent browser session */
+    async session(options) {
+        const body = {
+            viewport: options?.viewport,
+            record_video: options?.recordVideo,
+            locale: options?.locale,
+            timezone: options?.timezone,
+            user_agent: options?.userAgent,
+            block_resources: options?.blockResources,
+        };
+        const data = await this.request('/v1/browser/session', { method: 'POST', body });
+        return new Session(data.session_id, this);
+    }
+    /** One-shot screenshot (no persistent session) */
+    async screenshot(params) {
+        return this.request('/v1/browser/screenshot', {
+            method: 'POST',
+            body: {
+                url: params.url,
+                selector: params.selector,
+                full_page: params.fullPage,
+                format: params.format,
+                viewport: params.viewport,
+            },
+        });
+    }
+    /** One-shot structured data extraction */
+    async extract(params) {
+        return this.request('/v1/browser/extract', {
+            method: 'POST',
+            body: {
+                url: params.url,
+                schema: params.schema,
+                wait_for_selector: params.waitForSelector,
+            },
+        });
+    }
+    /** Get usage and credit balance */
+    async usage() {
+        return this.request('/v1/account/usage', { method: 'GET' });
+    }
+    /** @internal — used by Session class */
+    async request(path, init) {
+        let lastError;
+        for (let attempt = 0; attempt <= this.retries; attempt++) {
+            try {
+                const response = await fetch(`${this.baseUrl}${path}`, {
+                    method: init.method,
+                    headers: {
+                        'content-type': 'application/json',
+                        authorization: `Bearer ${this.apiKey}`,
+                    },
+                    body: init.body ? JSON.stringify(init.body) : undefined,
+                });
+                if (!response.ok) {
+                    const error = await mapApiError(response);
+                    // Don't retry on client errors (except 429 and 503)
+                    if (response.status < 500 && response.status !== 429) {
+                        throw error;
+                    }
+                    throw error;
+                }
+                return (await response.json());
+            }
+            catch (err) {
+                lastError = err instanceof Error ? err : new Error(String(err));
+                // Don't retry non-retryable errors
+                if (lastError.name === 'InsufficientCreditsError' || lastError.name === 'SessionExpiredError' || lastError.name === 'InvalidParamsError') {
+                    throw lastError;
+                }
+                if (attempt < this.retries) {
+                    const jitter = Math.random() * 0.3 + 0.85; // 0.85-1.15x
+                    const delay = this.retryDelay * Math.pow(2, attempt) * jitter;
+                    await new Promise((r) => setTimeout(r, delay));
+                }
+            }
+        }
+        throw lastError;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAUpC,MAAM,OAAO,aAAa;IACP,MAAM,CAAQ;IACd,OAAO,CAAQ;IACf,OAAO,CAAQ;IACf,UAAU,CAAQ;IAEnC,YAAY,OAA6B;QACvC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;QAC5B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,yBAAyB,CAAA;QAC3D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,CAAA;QACnC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAA;IAC9C,CAAC;IAED,0CAA0C;IAC1C,KAAK,CAAC,OAAO,CAAC,OAOb;QACC,MAAM,IAAI,GAAG;YACX,QAAQ,EAAE,OAAO,EAAE,QAAQ;YAC3B,YAAY,EAAE,OAAO,EAAE,WAAW;YAClC,MAAM,EAAE,OAAO,EAAE,MAAM;YACvB,QAAQ,EAAE,OAAO,EAAE,QAAQ;YAC3B,UAAU,EAAE,OAAO,EAAE,SAAS;YAC9B,eAAe,EAAE,OAAO,EAAE,cAAc;SACzC,CAAA;QACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAyB,qBAAqB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;QACxG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;IAC3C,CAAC;IAED,kDAAkD;IAClD,KAAK,CAAC,UAAU,CAAC,MAMhB;QACC,OAAO,IAAI,CAAC,OAAO,CAAC,wBAAwB,EAAE;YAC5C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE;gBACJ,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,SAAS,EAAE,MAAM,CAAC,QAAQ;gBAC1B,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B;SACF,CAAC,CAAA;IACJ,CAAC;IAED,0CAA0C;IAC1C,KAAK,CAAC,OAAO,CAAC,MAIb;QACC,OAAO,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE;YACzC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE;gBACJ,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,iBAAiB,EAAE,MAAM,CAAC,eAAe;aAC1C;SACF,CAAC,CAAA;IACJ,CAAC;IAED,mCAAmC;IACnC,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;IAC7D,CAAC;IAED,wCAAwC;IACxC,KAAK,CAAC,OAAO,CAAI,IAAY,EAAE,IAAwC;QACrE,IAAI,SAA4B,CAAA;QAChC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC;YACzD,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE;oBACrD,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,OAAO,EAAE;wBACP,cAAc,EAAE,kBAAkB;wBAClC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;qBACvC;oBACD,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;iBACxD,CAAC,CAAA;gBAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC,CAAA;oBACzC,oDAAoD;oBACpD,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;wBACrD,MAAM,KAAK,CAAA;oBACb,CAAC;oBACD,MAAM,KAAK,CAAA;gBACb,CAAC;gBAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAA;YACrC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,SAAS,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;gBAC/D,mCAAmC;gBACnC,IAAI,SAAS,CAAC,IAAI,KAAK,0BAA0B,IAAI,SAAS,CAAC,IAAI,KAAK,qBAAqB,IAAI,SAAS,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;oBACzI,MAAM,SAAS,CAAA;gBACjB,CAAC;gBACD,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;oBAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,IAAI,CAAA,CAAC,aAAa;oBACvD,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,MAAM,CAAA;oBAC7D,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAA;gBAChD,CAAC;YACH,CAAC;QACH,CAAC;QACD,MAAM,SAAU,CAAA;IAClB,CAAC;CACF"}

package/dist/errors.d.ts

@@ -0,0 +1,26 @@
+export declare class RoveError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly detail?: string | undefined;
+    constructor(message: string, status: number, code: string, detail?: string | undefined);
+}
+export declare class InsufficientCreditsError extends RoveError {
+    constructor(detail?: string);
+}
+export declare class SessionExpiredError extends RoveError {
+    constructor(detail?: string);
+}
+export declare class RateLimitError extends RoveError {
+    readonly retryAfter: number;
+    constructor(retryAfter: number, detail?: string);
+}
+export declare class BrowserCrashError extends RoveError {
+    constructor(detail?: string);
+}
+export declare class PoolExhaustedError extends RoveError {
+    constructor(detail?: string);
+}
+export declare class InvalidParamsError extends RoveError {
+    constructor(detail?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,SAAU,SAAQ,KAAK;aAGhB,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,MAAM;aACZ,MAAM,CAAC,EAAE,MAAM;gBAH/B,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,YAAA;CAKlC;AAED,qBAAa,wBAAyB,SAAQ,SAAS;gBACzC,MAAM,CAAC,EAAE,MAAM;CAI5B;AAED,qBAAa,mBAAoB,SAAQ,SAAS;gBACpC,MAAM,CAAC,EAAE,MAAM;CAI5B;AAED,qBAAa,cAAe,SAAQ,SAAS;aAEzB,UAAU,EAAE,MAAM;gBAAlB,UAAU,EAAE,MAAM,EAClC,MAAM,CAAC,EAAE,MAAM;CAKlB;AAED,qBAAa,iBAAkB,SAAQ,SAAS;gBAClC,MAAM,CAAC,EAAE,MAAM;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,SAAS;gBACnC,MAAM,CAAC,EAAE,MAAM;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,SAAS;gBACnC,MAAM,CAAC,EAAE,MAAM;CAI5B"}

package/dist/errors.js

@@ -0,0 +1,51 @@
+export class RoveError extends Error {
+    status;
+    code;
+    detail;
+    constructor(message, status, code, detail) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.detail = detail;
+        this.name = 'RoveError';
+    }
+}
+export class InsufficientCreditsError extends RoveError {
+    constructor(detail) {
+        super('Insufficient credits', 402, 'insufficient-credits', detail);
+        this.name = 'InsufficientCreditsError';
+    }
+}
+export class SessionExpiredError extends RoveError {
+    constructor(detail) {
+        super('Session expired', 410, 'session-expired', detail);
+        this.name = 'SessionExpiredError';
+    }
+}
+export class RateLimitError extends RoveError {
+    retryAfter;
+    constructor(retryAfter, detail) {
+        super('Rate limit exceeded', 429, 'rate-limit-exceeded', detail);
+        this.retryAfter = retryAfter;
+        this.name = 'RateLimitError';
+    }
+}
+export class BrowserCrashError extends RoveError {
+    constructor(detail) {
+        super('Browser crash', 503, 'browser-crash', detail);
+        this.name = 'BrowserCrashError';
+    }
+}
+export class PoolExhaustedError extends RoveError {
+    constructor(detail) {
+        super('Pool exhausted', 503, 'pool-exhausted', detail);
+        this.name = 'PoolExhaustedError';
+    }
+}
+export class InvalidParamsError extends RoveError {
+    constructor(detail) {
+        super('Invalid parameters', 400, 'invalid-params', detail);
+        this.name = 'InvalidParamsError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,SAAU,SAAQ,KAAK;IAGhB;IACA;IACA;IAJlB,YACE,OAAe,EACC,MAAc,EACd,IAAY,EACZ,MAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAA;QAJE,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAQ;QACZ,WAAM,GAAN,MAAM,CAAS;QAG/B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAA;IACzB,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,SAAS;IACrD,YAAY,MAAe;QACzB,KAAK,CAAC,sBAAsB,EAAE,GAAG,EAAE,sBAAsB,EAAE,MAAM,CAAC,CAAA;QAClE,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAA;IACxC,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,SAAS;IAChD,YAAY,MAAe;QACzB,KAAK,CAAC,iBAAiB,EAAE,GAAG,EAAE,iBAAiB,EAAE,MAAM,CAAC,CAAA;QACxD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,SAAS;IAEzB;IADlB,YACkB,UAAkB,EAClC,MAAe;QAEf,KAAK,CAAC,qBAAqB,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,CAAC,CAAA;QAHhD,eAAU,GAAV,UAAU,CAAQ;QAIlC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IAC9C,YAAY,MAAe;QACzB,KAAK,CAAC,eAAe,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,CAAC,CAAA;QACpD,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;IACjC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,SAAS;IAC/C,YAAY,MAAe;QACzB,KAAK,CAAC,gBAAgB,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAA;QACtD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;IAClC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,SAAS;IAC/C,YAAY,MAAe;QACzB,KAAK,CAAC,oBAAoB,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAA;QAC1D,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;IAClC,CAAC;CACF"}

package/dist/http.d.ts

@@ -0,0 +1,3 @@
+import { RoveError } from './errors';
+export declare function mapApiError(response: Response): Promise<RoveError>;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EAOV,MAAM,UAAU,CAAA;AASjB,wBAAsB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,CA4BxE"}

package/dist/http.js

@@ -0,0 +1,31 @@
+import { RoveError, InsufficientCreditsError, SessionExpiredError, RateLimitError, BrowserCrashError, PoolExhaustedError, InvalidParamsError, } from './errors';
+export async function mapApiError(response) {
+    let problem = {};
+    try {
+        problem = (await response.json());
+    }
+    catch {
+        // ignore parse errors
+    }
+    const detail = problem.detail ?? response.statusText;
+    const code = problem.type?.split('/').pop() ?? 'unknown';
+    switch (response.status) {
+        case 400:
+            return new InvalidParamsError(detail);
+        case 402:
+            return new InsufficientCreditsError(detail);
+        case 410:
+            return new SessionExpiredError(detail);
+        case 429: {
+            const retryAfter = Number(response.headers.get('retry-after') ?? 60);
+            return new RateLimitError(retryAfter, detail);
+        }
+        case 503:
+            if (code === 'pool-exhausted')
+                return new PoolExhaustedError(detail);
+            return new BrowserCrashError(detail);
+        default:
+            return new RoveError(detail, response.status, code, detail);
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,wBAAwB,EACxB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,UAAU,CAAA;AASjB,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAkB;IAClD,IAAI,OAAO,GAAmB,EAAE,CAAA;IAChC,IAAI,CAAC;QACH,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAmB,CAAA;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,CAAA;IACpD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,SAAS,CAAA;IAExD,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC;QACxB,KAAK,GAAG;YACN,OAAO,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAA;QACvC,KAAK,GAAG;YACN,OAAO,IAAI,wBAAwB,CAAC,MAAM,CAAC,CAAA;QAC7C,KAAK,GAAG;YACN,OAAO,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAA;QACxC,KAAK,GAAG,CAAC,CAAC,CAAC;YACT,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAA;YACpE,OAAO,IAAI,cAAc,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;QAC/C,CAAC;QACD,KAAK,GAAG;YACN,IAAI,IAAI,KAAK,gBAAgB;gBAAE,OAAO,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAA;YACpE,OAAO,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAA;QACtC;YACE,OAAO,IAAI,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;IAC/D,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { BrowserClient, type BrowserClientOptions } from './client';
+export { Session } from './session';
+export { RoveError, InsufficientCreditsError, SessionExpiredError, RateLimitError, BrowserCrashError, PoolExhaustedError, InvalidParamsError, } from './errors';
+export type { SessionCreateResponse, ActionResponse, ScreenshotResponse, ExtractResponse, UsageResponse, A11yTreeResult, NavigateResult, ClickResult, FillResult, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,UAAU,CAAA;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EACL,SAAS,EACT,wBAAwB,EACxB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,UAAU,CAAA;AACjB,YAAY,EACV,qBAAqB,EACrB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,cAAc,EACd,cAAc,EACd,WAAW,EACX,UAAU,GACX,MAAM,SAAS,CAAA"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { BrowserClient } from './client';
+export { Session } from './session';
+export { RoveError, InsufficientCreditsError, SessionExpiredError, RateLimitError, BrowserCrashError, PoolExhaustedError, InvalidParamsError, } from './errors';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA6B,MAAM,UAAU,CAAA;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EACL,SAAS,EACT,wBAAwB,EACxB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,UAAU,CAAA"}

package/dist/session.d.ts

@@ -0,0 +1,65 @@
+import type { BrowserClient } from './client';
+import type { ActionResponse, NavigateResult, A11yTreeResult, ClickResult, FillResult } from './types';
+export declare class Session {
+    readonly id: string;
+    private readonly client;
+    constructor(id: string, client: BrowserClient);
+    private action;
+    navigate(url: string, options?: {
+        waitUntil?: 'load' | 'domcontentloaded' | 'networkidle';
+        timeoutMs?: number;
+    }): Promise<ActionResponse<NavigateResult>>;
+    getA11yTree(options?: {
+        includeHidden?: boolean;
+        rootSelector?: string;
+    }): Promise<ActionResponse<A11yTreeResult>>;
+    click(target: {
+        selector?: string;
+        label?: string;
+        button?: 'left' | 'right' | 'middle';
+        clickCount?: number;
+        waitAfterMs?: number;
+    }): Promise<ActionResponse<ClickResult>>;
+    fill(target: {
+        selector?: string;
+        label?: string;
+        value: string;
+        clearFirst?: boolean;
+    }): Promise<ActionResponse<FillResult>>;
+    select(params: {
+        selector?: string;
+        value?: string;
+        labelText?: string;
+    }): Promise<ActionResponse<unknown>>;
+    scroll(params?: {
+        direction?: 'up' | 'down' | 'left' | 'right';
+        amount?: number;
+        selector?: string;
+    }): Promise<ActionResponse<unknown>>;
+    waitFor(params: {
+        type: 'selector' | 'text' | 'url' | 'timeout';
+        value: string;
+        state?: string;
+        timeoutMs?: number;
+    }): Promise<ActionResponse<unknown>>;
+    screenshot(params?: {
+        selector?: string;
+        fullPage?: boolean;
+        format?: 'png' | 'jpeg';
+    }): Promise<ActionResponse<unknown>>;
+    getText(selector: string, trim?: boolean): Promise<ActionResponse<{
+        text: string;
+        selector: string;
+    }>>;
+    getAttribute(selector: string, attribute: string): Promise<ActionResponse<{
+        attribute: string;
+        value: string | null;
+        selector: string;
+    }>>;
+    evaluate(expression: string): Promise<ActionResponse<{
+        value: unknown;
+        type: string;
+    }>>;
+    close(): Promise<ActionResponse<unknown>>;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEtG,qBAAa,OAAO;aAEA,EAAE,EAAE,MAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADP,EAAE,EAAE,MAAM,EACT,MAAM,EAAE,aAAa;IAGxC,OAAO,CAAC,MAAM;IAOR,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,GAAG,kBAAkB,GAAG,aAAa,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IAI/G,WAAW,CAAC,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE;IAIxE,KAAK,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE;IAIpI,IAAI,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE;IAIvF,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IAIxE,MAAM,CAAC,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;IAIpG,OAAO,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IAIpH,UAAU,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE;IAItF,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,UAAO;cACd,MAAM;kBAAY,MAAM;;IAG/C,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;mBACpB,MAAM;eAAS,MAAM,GAAG,IAAI;kBAAY,MAAM;;IAG1E,QAAQ,CAAC,UAAU,EAAE,MAAM;eACH,OAAO;cAAQ,MAAM;;IAG7C,KAAK;CAGZ"}

package/dist/session.js

@@ -0,0 +1,51 @@
+export class Session {
+    id;
+    client;
+    constructor(id, client) {
+        this.id = id;
+        this.client = client;
+    }
+    action(action, params = {}) {
+        return this.client.request('/v1/browser/action', {
+            method: 'POST',
+            body: { session_id: this.id, action, params },
+        });
+    }
+    async navigate(url, options) {
+        return this.action('navigate', { url, wait_until: options?.waitUntil, timeout_ms: options?.timeoutMs });
+    }
+    async getA11yTree(options) {
+        return this.action('get_a11y_tree', { include_hidden: options?.includeHidden, root_selector: options?.rootSelector });
+    }
+    async click(target) {
+        return this.action('click', { selector: target.selector, label: target.label, button: target.button, click_count: target.clickCount, wait_after_ms: target.waitAfterMs });
+    }
+    async fill(target) {
+        return this.action('fill', { selector: target.selector, label: target.label, value: target.value, clear_first: target.clearFirst });
+    }
+    async select(params) {
+        return this.action('select', { selector: params.selector, value: params.value, label_text: params.labelText });
+    }
+    async scroll(params) {
+        return this.action('scroll', { direction: params?.direction, amount: params?.amount, selector: params?.selector });
+    }
+    async waitFor(params) {
+        return this.action('wait_for', { type: params.type, value: params.value, state: params.state, timeout_ms: params.timeoutMs });
+    }
+    async screenshot(params) {
+        return this.action('screenshot', { selector: params?.selector, full_page: params?.fullPage, format: params?.format });
+    }
+    async getText(selector, trim = true) {
+        return this.action('get_text', { selector, trim });
+    }
+    async getAttribute(selector, attribute) {
+        return this.action('get_attribute', { selector, attribute });
+    }
+    async evaluate(expression) {
+        return this.action('evaluate', { expression });
+    }
+    async close() {
+        return this.action('close_session');
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,65 @@
+export type SessionCreateResponse = {
+    session_id: string;
+    connection_token: string;
+    expires_at: string;
+    environment: 'live' | 'test';
+};
+export type ActionResponse<T = Record<string, unknown>> = {
+    success: boolean;
+    result: T;
+    credits_used: number;
+    duration_ms: number;
+    environment: 'live' | 'test';
+};
+export type NavigateResult = {
+    url: string;
+    title: string;
+    status_code: number;
+    load_time_ms: number;
+};
+export type A11yTreeResult = {
+    tree: string;
+    node_count: number;
+    estimated_tokens: number;
+};
+export type ClickResult = {
+    clicked: boolean;
+    element: {
+        tag: string;
+        text: string;
+        selector: string;
+    };
+};
+export type FillResult = {
+    filled: boolean;
+    selector: string;
+    length: number;
+};
+export type ScreenshotResponse = {
+    url: string;
+    expires_at: string;
+    file_size_bytes?: number;
+    width_px?: number;
+    height_px?: number;
+    source_url?: string;
+    artifact_id?: string;
+};
+export type ExtractResponse = {
+    data: Record<string, unknown>;
+};
+export type UsageResponse = {
+    api_key: string;
+    plan: string;
+    credits_total: number;
+    credits_used: number;
+    credits_remaining: number;
+    current_period_actions: {
+        sessions: number;
+        navigations: number;
+        interactions: number;
+        screenshots: number;
+        extractions: number;
+    };
+    credits_expire: string | null;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG;IAClC,UAAU,EAAE,MAAM,CAAA;IAClB,gBAAgB,EAAE,MAAM,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,GAAG,MAAM,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IACxD,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,CAAC,CAAA;IACT,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,GAAG,MAAM,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,gBAAgB,EAAE,MAAM,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CACzD,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9B,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,iBAAiB,EAAE,MAAM,CAAA;IACzB,sBAAsB,EAAE;QACtB,QAAQ,EAAE,MAAM,CAAA;QAChB,WAAW,EAAE,MAAM,CAAA;QACnB,YAAY,EAAE,MAAM,CAAA;QACpB,WAAW,EAAE,MAAM,CAAA;QACnB,WAAW,EAAE,MAAM,CAAA;KACpB,CAAA;IACD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B,CAAA"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@roveapi/browser",
+  "version": "1.0.0",
+  "description": "Browser automation SDK for AI agents — Playwright-as-a-Service with accessibility trees",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "browser",
+    "automation",
+    "playwright",
+    "a11y",
+    "accessibility",
+    "mcp",
+    "ai-agent"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^5"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "echo 'no tests yet'"
+  }
+}