browser-use-sdk 2.0.15 → 3.0.3

package/README.md

@@ -1,197 +1,214 @@
-<img src="https://raw.githubusercontent.com/browser-use/browser-use-node/refs/heads/main/assets/cloud-banner-js.png" alt="Browser Use JS" width="full"/>
+# browser-use-sdk
 
-# BrowserUse TypeScript Library
+Official TypeScript SDK for the [Browser Use](https://browser-use.com) API -- run AI-powered browser agents in the cloud.
 
-[![fern shield](https://img.shields.io/badge/%F0%9F%8C%BF-Built%20with%20Fern-brightgreen)](https://buildwithfern.com?utm_source=github&utm_medium=github&utm_campaign=readme&utm_source=https%3A%2F%2Fgithub.com%2Fbrowser-use%2Fbrowser-use-node)
-[![npm shield](https://img.shields.io/npm/v/browser-use-sdk)](https://www.npmjs.com/package/browser-use-sdk)
-
-The BrowserUse TypeScript library provides convenient access to the BrowserUse APIs from TypeScript.
-
-## Three-Step QuickStart
-
-1.  📦 Install BrowserUse SDK.
-
-    ```sh
-    # NPM
-    npm i -s browser-use-sdk
+## Installation
 
-    # Yarn
-    yarn add browser-use-sdk
+```bash
+npm install browser-use-sdk
+# or
+pnpm add browser-use-sdk
+# or
+yarn add browser-use-sdk
+# or
+bun add browser-use-sdk
+```
 
-    # PNPM
-    pnpm add browser-use-sdk
-    ```
+## Quick Start (v2)
 
-1.  🔑 Get your API Key at [Browser Use Cloud](https://cloud.browser-use.com)!
+The default import exposes the **v2** API client.
 
-1.  🦄 Automate the Internet!
+```ts
+import { BrowserUse } from "browser-use-sdk";
 
-    ```ts
-    import { BrowserUseClient } from "browser-use-sdk";
+const client = new BrowserUse();
 
-    const client = new BrowserUseClient({
-        apiKey: "bu_...",
-    });
+const result = await client.run("Find the top post on Hacker News");
+console.log(result.output);
+console.log(result.id, result.status);
+```
 
-    const task = await client.tasks.createTask({
-        task: "Search for the top 10 Hacker News posts and return the title and url.",
-    });
+## V3 (Experimental)
 
-    const result = await task.complete();
+The v3 API uses a unified session model. Import from `browser-use-sdk/v3`:
 
-    console.log(result.output);
-    ```
+```ts
+import { BrowserUse } from "browser-use-sdk/v3";
 
-> The full API of this library can be found in [api.md](api.md).
+const client = new BrowserUse();
 
----
+const output = await client.run("Find the top post on HN");
+console.log(output);
+```
 
-### Structured Output with Zod
+## Client Options
 
 ```ts
-import z from "zod";
-
-const TaskOutput = z.object({
-    posts: z.array(
-        z.object({
-            title: z.string(),
-            url: z.string(),
-        }),
-    ),
-});
-
-const task = await client.tasks.createTask({
-    task: "Search for the top 10 Hacker News posts and return the title and url.",
-    schema: TaskOutput,
+const client = new BrowserUse({
+  apiKey: "bu_...",           // Or set BROWSER_USE_API_KEY env var
+  baseUrl: "https://...",     // Override API base URL
+  maxRetries: 3,              // Retry on 429 (default: 3)
+  timeout: 30_000,            // Request timeout in ms (default: 30s)
 });
-
-const result = await task.complete();
-
-for (const post of result.parsed.posts) {
-    console.log(`${post.title} - ${post.url}`);
-}
 ```
 
-### Streaming Agent Updates
+## Structured Output
 
-> You can use the `stream` method to get the latest step taken on every change.
+Pass a Zod schema to get typed results:
 
 ```ts
-const task = await browseruse.tasks.createTask({
-    task: "Search for the top 10 Hacker News posts and return the title and url.",
-    schema: TaskOutput,
-});
-
-for await (const step of task.stream()) {
-    console.log(step);
-}
+import { z } from "zod";
 
-const result = await task.complete();
+const Product = z.object({ name: z.string(), price: z.number() });
 
-for (const post of result.parsed.posts) {
-    console.log(`${post.title} - ${post.url}`);
-}
+const result = await client.run("Find the price of the MacBook Air", { schema: Product });
+console.log(`${result.output.name}: $${result.output.price}`);
 ```
 
-### Watching Agent Updates
+## Polling and Streaming
+
+`client.run()` returns a dual-purpose handle: `await` it for the output, or `for await...of` it for step-by-step progress.
 
-> You can use the `watch` method to get the latest update on every change.
+### Wait for Result
 
 ```ts
-const task = await browseruse.tasks.createTask({
-    task: "Search for the top 10 Hacker News posts and return the title and url.",
-    schema: TaskOutput,
-});
+const result = await client.run("Search for AI news");
+console.log(result.output, result.id, result.status);
+```
 
-for await (const update of task.watch()) {
-    console.log(update);
+### Stream Steps
 
-    if (update.data.status === "finished") {
-        for (const post of update.data.parsed.posts) {
-            console.log(`${post.title} - ${post.url}`);
-        }
-    }
+```ts
+for await (const step of client.run("Search for AI news")) {
+  console.log(`[${step.number}] ${step.nextGoal} — ${step.url}`);
 }
 ```
 
-## Webhook Verification
-
-> We encourage you to use the SDK functions that verify and parse webhook events.
+## V2 API Reference
+
+### Billing
+
+| Method                | Description                          |
+|-----------------------|--------------------------------------|
+| `billing.account()`  | Get account info and credit balance  |
+
+### Tasks
+
+| Method                       | Description                             |
+|------------------------------|-----------------------------------------|
+| `tasks.create(body)`        | Create and start a new task             |
+| `tasks.list(params?)`       | List tasks with optional filtering      |
+| `tasks.get(taskId)`         | Get detailed task information           |
+| `tasks.stop(taskId)`        | Stop a running task                     |
+| `tasks.status(taskId)`      | Lightweight status for polling          |
+| `tasks.wait(taskId, opts?)` | Poll until terminal, return TaskView    |
+| `tasks.logs(taskId)`        | Get download URL for task logs          |
+
+### Sessions
+
+| Method                             | Description                          |
+|------------------------------------|--------------------------------------|
+| `sessions.create(body?)`          | Create a new session                 |
+| `sessions.list(params?)`          | List sessions                        |
+| `sessions.get(sessionId)`         | Get session details                  |
+| `sessions.stop(sessionId)`        | Stop session and running tasks       |
+| `sessions.delete(sessionId)`      | Delete session and all tasks         |
+| `sessions.getShare(sessionId)`    | Get public share info                |
+| `sessions.createShare(sessionId)` | Create public share link             |
+| `sessions.deleteShare(sessionId)` | Remove public share                  |
+
+### Files
+
+| Method                                  | Description                            |
+|-----------------------------------------|----------------------------------------|
+| `files.sessionUrl(sessionId, body)`    | Presigned URL for session file upload  |
+| `files.browserUrl(sessionId, body)`    | Presigned URL for browser file upload  |
+| `files.taskOutput(taskId, fileId)`     | Download URL for task output file      |
+
+### Profiles
+
+| Method                            | Description                  |
+|-----------------------------------|------------------------------|
+| `profiles.create(body?)`         | Create a browser profile     |
+| `profiles.list(params?)`         | List profiles                |
+| `profiles.get(profileId)`        | Get profile details          |
+| `profiles.update(profileId, body)` | Update a profile           |
+| `profiles.delete(profileId)`     | Delete a profile             |
+
+### Browsers
+
+| Method                        | Description                        |
+|-------------------------------|------------------------------------|
+| `browsers.create(body)`      | Create a browser session           |
+| `browsers.list(params?)`     | List browser sessions              |
+| `browsers.get(sessionId)`    | Get browser session details        |
+| `browsers.stop(sessionId)`   | Stop a browser session             |
+
+### Skills
+
+| Method                                         | Description                          |
+|------------------------------------------------|--------------------------------------|
+| `skills.create(body)`                         | Create a skill via generation        |
+| `skills.list(params?)`                        | List skills                          |
+| `skills.get(skillId)`                         | Get skill details                    |
+| `skills.delete(skillId)`                      | Delete a skill                       |
+| `skills.update(skillId, body)`                | Update skill metadata                |
+| `skills.cancel(skillId)`                      | Cancel in-progress generation        |
+| `skills.execute(skillId, body)`               | Execute a skill                      |
+| `skills.refine(skillId, body)`                | Refine a skill with feedback         |
+| `skills.rollback(skillId)`                    | Rollback to previous version         |
+| `skills.executions(skillId, params?)`         | List skill executions                |
+| `skills.executionOutput(skillId, executionId)` | Download execution output           |
+
+### Marketplace
+
+| Method                              | Description                         |
+|-------------------------------------|-------------------------------------|
+| `marketplace.list(params?)`        | List public marketplace skills      |
+| `marketplace.get(skillSlug)`       | Get marketplace skill by slug       |
+| `marketplace.clone(skillId)`       | Clone a marketplace skill           |
+| `marketplace.execute(skillId, body)` | Execute a marketplace skill       |
+
+## V3 API Reference
+
+### Sessions
+
+| Method                               | Description                          |
+|--------------------------------------|--------------------------------------|
+| `sessions.create(body)`             | Create session and run a task        |
+| `sessions.list(params?)`            | List sessions                        |
+| `sessions.get(sessionId)`           | Get session details                  |
+| `sessions.stop(sessionId)`          | Stop a session                       |
+| `sessions.files(sessionId, params?)` | List files in session workspace     |
+
+## Error Handling
+
+All API errors throw `BrowserUseError`:
 
 ```ts
-import { verifyWebhookEventSignature, type WebhookAgentTaskStatusUpdatePayload } from "browser-use-sdk";
-
-export async function POST(req: Request) {
-    const signature = req.headers["x-browser-use-signature"] as string;
-    const timestamp = req.headers["x-browser-use-timestamp"] as string;
-
-    const event = await verifyWebhookEventSignature(
-        {
-            body,
-            signature,
-            timestamp,
-        },
-        {
-            secret: SECRET_KEY,
-        },
-    );
-
-    if (!event.ok) {
-        return;
-    }
-
-    switch (event.event.type) {
-        case "agent.task.status_update":
-            break;
-        case "test":
-            break;
-        default:
-            break;
-    }
+import { BrowserUse, BrowserUseError } from "browser-use-sdk";
+
+try {
+  await client.tasks.get("nonexistent-id");
+} catch (err) {
+  if (err instanceof BrowserUseError) {
+    console.error(err.statusCode); // 404
+    console.error(err.message);    // "Task not found"
+    console.error(err.detail);     // Raw error body
+  }
 }
 ```
 
-## Contributing
-
-While we value open-source contributions to this SDK, this library is generated programmatically.
-Additions made directly to this library would have to be moved over to our generation code,
-otherwise they would be overwritten upon the next generated release. Feel free to open a PR as
-a proof of concept, but know that we will not be able to merge it as-is. We suggest opening
-an issue first to discuss with us!
+The client automatically retries on `429` (rate limit) with exponential backoff.
 
-On the other hand, contributions to the README are always very welcome!
+## TypeScript
 
-## Installation
+Types are re-exported from `browser-use-sdk` and `browser-use-sdk/v3`. The SDK ships with full type definitions for all request/response shapes.
 
-```sh
-npm i -s browser-use-sdk
+```ts
+import type { TaskView, CreateTaskRequest } from "browser-use-sdk";
 ```
 
-## Reference
+## License
 
-A full reference for this library is available [here](https://github.com/browser-use/browser-use-node/blob/HEAD/./reference.md).
-
-### Runtime Compatibility
-
-The SDK works in the following runtimes:
-
-- Node.js 18+
-- Vercel
-- Cloudflare Workers
-- Deno v1.25+
-- Bun 1.0+
-- React Native
-
-### Customizing Fetch Client
-
-The SDK provides a way for you to customize the underlying HTTP client / Fetch function. If you're running in an
-unsupported environment, this provides a way for you to break glass and ensure the SDK works.
-
-```typescript
-import { BrowserUseClient } from "browser-use-sdk";
-
-const client = new BrowserUseClient({
-    ...
-    fetcher: // provide your implementation here
-});
-```
+MIT

package/dist/chunk-I75IFZAL.js

@@ -0,0 +1,100 @@
+// src/core/errors.ts
+var BrowserUseError = class extends Error {
+  statusCode;
+  detail;
+  constructor(statusCode, message, detail) {
+    super(message);
+    this.name = "BrowserUseError";
+    this.statusCode = statusCode;
+    this.detail = detail;
+  }
+};
+
+// src/core/http.ts
+var HttpClient = class {
+  apiKey;
+  baseUrl;
+  maxRetries;
+  timeout;
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.baseUrl = options.baseUrl.replace(/\/+$/, "");
+    this.maxRetries = options.maxRetries ?? 3;
+    this.timeout = options.timeout ?? 3e4;
+  }
+  async request(method, path, options) {
+    const url = new URL(`${this.baseUrl}${path}`);
+    if (options?.query) {
+      for (const [key, value] of Object.entries(options.query)) {
+        if (value !== void 0 && value !== null) {
+          url.searchParams.set(key, String(value));
+        }
+      }
+    }
+    const headers = {
+      "X-Browser-Use-API-Key": this.apiKey
+    };
+    if (options?.body !== void 0) {
+      headers["Content-Type"] = "application/json";
+    }
+    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+      if (attempt > 0) {
+        const delay = Math.min(1e3 * 2 ** (attempt - 1), 1e4);
+        await new Promise((resolve) => setTimeout(resolve, delay));
+      }
+      const controller = new AbortController();
+      const timeoutId = options?.signal ? void 0 : setTimeout(() => controller.abort(), this.timeout);
+      const signal = options?.signal ?? controller.signal;
+      try {
+        const response = await fetch(url.toString(), {
+          method,
+          headers,
+          body: options?.body !== void 0 ? JSON.stringify(options.body) : void 0,
+          signal
+        });
+        clearTimeout(timeoutId);
+        if (response.ok) {
+          if (response.status === 204) {
+            return void 0;
+          }
+          return await response.json();
+        }
+        const shouldRetry = response.status === 429 && attempt < this.maxRetries;
+        if (shouldRetry) {
+          continue;
+        }
+        let errorBody;
+        try {
+          errorBody = await response.json();
+        } catch {
+        }
+        const message = typeof errorBody === "object" && errorBody !== null ? String(
+          "message" in errorBody ? errorBody.message : "detail" in errorBody ? errorBody.detail : `HTTP ${response.status}`
+        ) : `HTTP ${response.status}`;
+        throw new BrowserUseError(response.status, message, errorBody);
+      } catch (error) {
+        clearTimeout(timeoutId);
+        throw error;
+      }
+    }
+    throw new Error("Unreachable: retry loop exhausted");
+  }
+  get(path, query) {
+    return this.request("GET", path, { query });
+  }
+  post(path, body, query) {
+    return this.request("POST", path, { body, query });
+  }
+  patch(path, body, query) {
+    return this.request("PATCH", path, { body, query });
+  }
+  delete(path, query) {
+    return this.request("DELETE", path, { query });
+  }
+};
+
+export {
+  BrowserUseError,
+  HttpClient
+};
+//# sourceMappingURL=chunk-I75IFZAL.js.map

package/dist/chunk-I75IFZAL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/errors.ts","../src/core/http.ts"],"sourcesContent":["export class BrowserUseError extends Error {\n  readonly statusCode: number;\n  readonly detail: unknown;\n\n  constructor(statusCode: number, message: string, detail?: unknown) {\n    super(message);\n    this.name = \"BrowserUseError\";\n    this.statusCode = statusCode;\n    this.detail = detail;\n  }\n}\n","import { BrowserUseError } from \"./errors.js\";\n\nexport interface HttpClientOptions {\n  apiKey: string;\n  baseUrl: string;\n  maxRetries?: number;\n  timeout?: number;\n}\n\nexport class HttpClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly maxRetries: number;\n  private readonly timeout: number;\n\n  constructor(options: HttpClientOptions) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = options.baseUrl.replace(/\\/+$/, \"\");\n    this.maxRetries = options.maxRetries ?? 3;\n    this.timeout = options.timeout ?? 30_000;\n  }\n\n  async request<T>(\n    method: string,\n    path: string,\n    options?: {\n      body?: unknown;\n      query?: Record<string, unknown>;\n      signal?: AbortSignal;\n    },\n  ): Promise<T> {\n    const url = new URL(`${this.baseUrl}${path}`);\n    if (options?.query) {\n      for (const [key, value] of Object.entries(options.query)) {\n        if (value !== undefined && value !== null) {\n          url.searchParams.set(key, String(value));\n        }\n      }\n    }\n\n    const headers: Record<string, string> = {\n      \"X-Browser-Use-API-Key\": this.apiKey,\n    };\n    if (options?.body !== undefined) {\n      headers[\"Content-Type\"] = \"application/json\";\n    }\n\n    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {\n      if (attempt > 0) {\n        const delay = Math.min(1000 * 2 ** (attempt - 1), 10_000);\n        await new Promise((resolve) => setTimeout(resolve, delay));\n      }\n\n      const controller = new AbortController();\n      const timeoutId = options?.signal\n        ? undefined\n        : setTimeout(() => controller.abort(), this.timeout);\n\n      // Combine user signal with internal timeout when both are present\n      const signal = options?.signal ?? controller.signal;\n\n      try {\n        const response = await fetch(url.toString(), {\n          method,\n          headers,\n          body: options?.body !== undefined ? JSON.stringify(options.body) : undefined,\n          signal,\n        });\n\n        clearTimeout(timeoutId);\n\n        if (response.ok) {\n          if (response.status === 204) {\n            return undefined as T;\n          }\n          return (await response.json()) as T;\n        }\n\n        const shouldRetry =\n          response.status === 429 &&\n          attempt < this.maxRetries;\n\n        if (shouldRetry) {\n          continue;\n        }\n\n        let errorBody: unknown;\n        try {\n          errorBody = await response.json();\n        } catch {\n          /* ignore parse errors */\n        }\n        const message =\n          typeof errorBody === \"object\" && errorBody !== null\n            ? String(\n                \"message\" in errorBody\n                  ? (errorBody as Record<string, unknown>).message\n                  : \"detail\" in errorBody\n                    ? (errorBody as Record<string, unknown>).detail\n                    : `HTTP ${response.status}`,\n              )\n            : `HTTP ${response.status}`;\n        throw new BrowserUseError(response.status, message, errorBody);\n      } catch (error) {\n        clearTimeout(timeoutId);\n        throw error;\n      }\n    }\n\n    throw new Error(\"Unreachable: retry loop exhausted\");\n  }\n\n  get<T>(path: string, query?: Record<string, unknown>): Promise<T> {\n    return this.request<T>(\"GET\", path, { query });\n  }\n\n  post<T>(path: string, body?: unknown, query?: Record<string, unknown>): Promise<T> {\n    return this.request<T>(\"POST\", path, { body, query });\n  }\n\n  patch<T>(path: string, body?: unknown, query?: Record<string, unknown>): Promise<T> {\n    return this.request<T>(\"PATCH\", path, { body, query });\n  }\n\n  delete<T>(path: string, query?: Record<string, unknown>): Promise<T> {\n    return this.request<T>(\"DELETE\", path, { query });\n  }\n}\n"],"mappings":";AAAO,IAAM,kBAAN,cAA8B,MAAM;AAAA,EAChC;AAAA,EACA;AAAA,EAET,YAAY,YAAoB,SAAiB,QAAkB;AACjE,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,aAAa;AAClB,SAAK,SAAS;AAAA,EAChB;AACF;;;ACDO,IAAM,aAAN,MAAiB;AAAA,EACL;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEjB,YAAY,SAA4B;AACtC,SAAK,SAAS,QAAQ;AACtB,SAAK,UAAU,QAAQ,QAAQ,QAAQ,QAAQ,EAAE;AACjD,SAAK,aAAa,QAAQ,cAAc;AACxC,SAAK,UAAU,QAAQ,WAAW;AAAA,EACpC;AAAA,EAEA,MAAM,QACJ,QACA,MACA,SAKY;AACZ,UAAM,MAAM,IAAI,IAAI,GAAG,KAAK,OAAO,GAAG,IAAI,EAAE;AAC5C,QAAI,SAAS,OAAO;AAClB,iBAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,QAAQ,KAAK,GAAG;AACxD,YAAI,UAAU,UAAa,UAAU,MAAM;AACzC,cAAI,aAAa,IAAI,KAAK,OAAO,KAAK,CAAC;AAAA,QACzC;AAAA,MACF;AAAA,IACF;AAEA,UAAM,UAAkC;AAAA,MACtC,yBAAyB,KAAK;AAAA,IAChC;AACA,QAAI,SAAS,SAAS,QAAW;AAC/B,cAAQ,cAAc,IAAI;AAAA,IAC5B;AAEA,aAAS,UAAU,GAAG,WAAW,KAAK,YAAY,WAAW;AAC3D,UAAI,UAAU,GAAG;AACf,cAAM,QAAQ,KAAK,IAAI,MAAO,MAAM,UAAU,IAAI,GAAM;AACxD,cAAM,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,KAAK,CAAC;AAAA,MAC3D;AAEA,YAAM,aAAa,IAAI,gBAAgB;AACvC,YAAM,YAAY,SAAS,SACvB,SACA,WAAW,MAAM,WAAW,MAAM,GAAG,KAAK,OAAO;AAGrD,YAAM,SAAS,SAAS,UAAU,WAAW;AAE7C,UAAI;AACF,cAAM,WAAW,MAAM,MAAM,IAAI,SAAS,GAAG;AAAA,UAC3C;AAAA,UACA;AAAA,UACA,MAAM,SAAS,SAAS,SAAY,KAAK,UAAU,QAAQ,IAAI,IAAI;AAAA,UACnE;AAAA,QACF,CAAC;AAED,qBAAa,SAAS;AAEtB,YAAI,SAAS,IAAI;AACf,cAAI,SAAS,WAAW,KAAK;AAC3B,mBAAO;AAAA,UACT;AACA,iBAAQ,MAAM,SAAS,KAAK;AAAA,QAC9B;AAEA,cAAM,cACJ,SAAS,WAAW,OACpB,UAAU,KAAK;AAEjB,YAAI,aAAa;AACf;AAAA,QACF;AAEA,YAAI;AACJ,YAAI;AACF,sBAAY,MAAM,SAAS,KAAK;AAAA,QAClC,QAAQ;AAAA,QAER;AACA,cAAM,UACJ,OAAO,cAAc,YAAY,cAAc,OAC3C;AAAA,UACE,aAAa,YACR,UAAsC,UACvC,YAAY,YACT,UAAsC,SACvC,QAAQ,SAAS,MAAM;AAAA,QAC/B,IACA,QAAQ,SAAS,MAAM;AAC7B,cAAM,IAAI,gBAAgB,SAAS,QAAQ,SAAS,SAAS;AAAA,MAC/D,SAAS,OAAO;AACd,qBAAa,SAAS;AACtB,cAAM;AAAA,MACR;AAAA,IACF;AAEA,UAAM,IAAI,MAAM,mCAAmC;AAAA,EACrD;AAAA,EAEA,IAAO,MAAc,OAA6C;AAChE,WAAO,KAAK,QAAW,OAAO,MAAM,EAAE,MAAM,CAAC;AAAA,EAC/C;AAAA,EAEA,KAAQ,MAAc,MAAgB,OAA6C;AACjF,WAAO,KAAK,QAAW,QAAQ,MAAM,EAAE,MAAM,MAAM,CAAC;AAAA,EACtD;AAAA,EAEA,MAAS,MAAc,MAAgB,OAA6C;AAClF,WAAO,KAAK,QAAW,SAAS,MAAM,EAAE,MAAM,MAAM,CAAC;AAAA,EACvD;AAAA,EAEA,OAAU,MAAc,OAA6C;AACnE,WAAO,KAAK,QAAW,UAAU,MAAM,EAAE,MAAM,CAAC;AAAA,EAClD;AACF;","names":[]}

package/dist/chunk-RIRVOEIU.cjs

@@ -0,0 +1,100 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/core/errors.ts
+var BrowserUseError = class extends Error {
+  
+  
+  constructor(statusCode, message, detail) {
+    super(message);
+    this.name = "BrowserUseError";
+    this.statusCode = statusCode;
+    this.detail = detail;
+  }
+};
+
+// src/core/http.ts
+var HttpClient = class {
+  
+  
+  
+  
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.baseUrl = options.baseUrl.replace(/\/+$/, "");
+    this.maxRetries = _nullishCoalesce(options.maxRetries, () => ( 3));
+    this.timeout = _nullishCoalesce(options.timeout, () => ( 3e4));
+  }
+  async request(method, path, options) {
+    const url = new URL(`${this.baseUrl}${path}`);
+    if (_optionalChain([options, 'optionalAccess', _ => _.query])) {
+      for (const [key, value] of Object.entries(options.query)) {
+        if (value !== void 0 && value !== null) {
+          url.searchParams.set(key, String(value));
+        }
+      }
+    }
+    const headers = {
+      "X-Browser-Use-API-Key": this.apiKey
+    };
+    if (_optionalChain([options, 'optionalAccess', _2 => _2.body]) !== void 0) {
+      headers["Content-Type"] = "application/json";
+    }
+    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+      if (attempt > 0) {
+        const delay = Math.min(1e3 * 2 ** (attempt - 1), 1e4);
+        await new Promise((resolve) => setTimeout(resolve, delay));
+      }
+      const controller = new AbortController();
+      const timeoutId = _optionalChain([options, 'optionalAccess', _3 => _3.signal]) ? void 0 : setTimeout(() => controller.abort(), this.timeout);
+      const signal = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _4 => _4.signal]), () => ( controller.signal));
+      try {
+        const response = await fetch(url.toString(), {
+          method,
+          headers,
+          body: _optionalChain([options, 'optionalAccess', _5 => _5.body]) !== void 0 ? JSON.stringify(options.body) : void 0,
+          signal
+        });
+        clearTimeout(timeoutId);
+        if (response.ok) {
+          if (response.status === 204) {
+            return void 0;
+          }
+          return await response.json();
+        }
+        const shouldRetry = response.status === 429 && attempt < this.maxRetries;
+        if (shouldRetry) {
+          continue;
+        }
+        let errorBody;
+        try {
+          errorBody = await response.json();
+        } catch (e) {
+        }
+        const message = typeof errorBody === "object" && errorBody !== null ? String(
+          "message" in errorBody ? errorBody.message : "detail" in errorBody ? errorBody.detail : `HTTP ${response.status}`
+        ) : `HTTP ${response.status}`;
+        throw new BrowserUseError(response.status, message, errorBody);
+      } catch (error) {
+        clearTimeout(timeoutId);
+        throw error;
+      }
+    }
+    throw new Error("Unreachable: retry loop exhausted");
+  }
+  get(path, query) {
+    return this.request("GET", path, { query });
+  }
+  post(path, body, query) {
+    return this.request("POST", path, { body, query });
+  }
+  patch(path, body, query) {
+    return this.request("PATCH", path, { body, query });
+  }
+  delete(path, query) {
+    return this.request("DELETE", path, { query });
+  }
+};
+
+
+
+
+exports.BrowserUseError = BrowserUseError; exports.HttpClient = HttpClient;
+//# sourceMappingURL=chunk-RIRVOEIU.cjs.map

package/dist/chunk-RIRVOEIU.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/greg/Documents/browser-use/core/sdk/browser-use-node/dist/chunk-RIRVOEIU.cjs","../src/core/errors.ts","../src/core/http.ts"],"names":[],"mappings":"AAAA;ACAO,IAAM,gBAAA,EAAN,MAAA,QAA8B,MAAM;AAAA,EAChC;AAAA,EACA;AAAA,EAET,WAAA,CAAY,UAAA,EAAoB,OAAA,EAAiB,MAAA,EAAkB;AACjE,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,KAAA,EAAO,iBAAA;AACZ,IAAA,IAAA,CAAK,WAAA,EAAa,UAAA;AAClB,IAAA,IAAA,CAAK,OAAA,EAAS,MAAA;AAAA,EAChB;AACF,CAAA;ADCA;AACA;AEHO,IAAM,WAAA,EAAN,MAAiB;AAAA,EACL;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEjB,WAAA,CAAY,OAAA,EAA4B;AACtC,IAAA,IAAA,CAAK,OAAA,EAAS,OAAA,CAAQ,MAAA;AACtB,IAAA,IAAA,CAAK,QAAA,EAAU,OAAA,CAAQ,OAAA,CAAQ,OAAA,CAAQ,MAAA,EAAQ,EAAE,CAAA;AACjD,IAAA,IAAA,CAAK,WAAA,mBAAa,OAAA,CAAQ,UAAA,UAAc,GAAA;AACxC,IAAA,IAAA,CAAK,QAAA,mBAAU,OAAA,CAAQ,OAAA,UAAW,KAAA;AAAA,EACpC;AAAA,EAEA,MAAM,OAAA,CACJ,MAAA,EACA,IAAA,EACA,OAAA,EAKY;AACZ,IAAA,MAAM,IAAA,EAAM,IAAI,GAAA,CAAI,CAAA,EAAA;AACA,IAAA;AACD,MAAA;AACD,QAAA;AACR,UAAA;AACN,QAAA;AACF,MAAA;AACF,IAAA;AAEwC,IAAA;AACtC,MAAA;AACF,IAAA;AACa,IAAA;AACH,MAAA;AACV,IAAA;AAEmB,IAAA;AACA,MAAA;AACD,QAAA;AACJ,QAAA;AACZ,MAAA;AAEmB,MAAA;AACD,MAAA;AAKH,MAAA;AAEX,MAAA;AACe,QAAA;AACf,UAAA;AACA,UAAA;AACe,UAAA;AACf,UAAA;AACD,QAAA;AAEY,QAAA;AAEI,QAAA;AACF,UAAA;AACJ,YAAA;AACT,UAAA;AACc,UAAA;AAChB,QAAA;AAEM,QAAA;AAIW,QAAA;AACf,UAAA;AACF,QAAA;AAEI,QAAA;AACA,QAAA;AACU,UAAA;AACN,QAAA;AAER,QAAA;AAEE,QAAA;AAEmB,UAAA;AAMP,QAAA;AACJ,QAAA;AACI,MAAA;AACD,QAAA;AACP,QAAA;AACR,MAAA;AACF,IAAA;AAEgB,IAAA;AAClB,EAAA;AAEkE,EAAA;AACzC,IAAA;AACzB,EAAA;AAEsC,EAAA;AACb,IAAA;AACzB,EAAA;AAEuC,EAAA;AACd,IAAA;AACzB,EAAA;AAEqE,EAAA;AAC5C,IAAA;AACzB,EAAA;AACF;AFjCyB;AACA;AACA;AACA;AACA","file":"/Users/greg/Documents/browser-use/core/sdk/browser-use-node/dist/chunk-RIRVOEIU.cjs","sourcesContent":[null,"export class BrowserUseError extends Error {\n  readonly statusCode: number;\n  readonly detail: unknown;\n\n  constructor(statusCode: number, message: string, detail?: unknown) {\n    super(message);\n    this.name = \"BrowserUseError\";\n    this.statusCode = statusCode;\n    this.detail = detail;\n  }\n}\n","import { BrowserUseError } from \"./errors.js\";\n\nexport interface HttpClientOptions {\n  apiKey: string;\n  baseUrl: string;\n  maxRetries?: number;\n  timeout?: number;\n}\n\nexport class HttpClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly maxRetries: number;\n  private readonly timeout: number;\n\n  constructor(options: HttpClientOptions) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = options.baseUrl.replace(/\\/+$/, \"\");\n    this.maxRetries = options.maxRetries ?? 3;\n    this.timeout = options.timeout ?? 30_000;\n  }\n\n  async request<T>(\n    method: string,\n    path: string,\n    options?: {\n      body?: unknown;\n      query?: Record<string, unknown>;\n      signal?: AbortSignal;\n    },\n  ): Promise<T> {\n    const url = new URL(`${this.baseUrl}${path}`);\n    if (options?.query) {\n      for (const [key, value] of Object.entries(options.query)) {\n        if (value !== undefined && value !== null) {\n          url.searchParams.set(key, String(value));\n        }\n      }\n    }\n\n    const headers: Record<string, string> = {\n      \"X-Browser-Use-API-Key\": this.apiKey,\n    };\n    if (options?.body !== undefined) {\n      headers[\"Content-Type\"] = \"application/json\";\n    }\n\n    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {\n      if (attempt > 0) {\n        const delay = Math.min(1000 * 2 ** (attempt - 1), 10_000);\n        await new Promise((resolve) => setTimeout(resolve, delay));\n      }\n\n      const controller = new AbortController();\n      const timeoutId = options?.signal\n        ? undefined\n        : setTimeout(() => controller.abort(), this.timeout);\n\n      // Combine user signal with internal timeout when both are present\n      const signal = options?.signal ?? controller.signal;\n\n      try {\n        const response = await fetch(url.toString(), {\n          method,\n          headers,\n          body: options?.body !== undefined ? JSON.stringify(options.body) : undefined,\n          signal,\n        });\n\n        clearTimeout(timeoutId);\n\n        if (response.ok) {\n          if (response.status === 204) {\n            return undefined as T;\n          }\n          return (await response.json()) as T;\n        }\n\n        const shouldRetry =\n          response.status === 429 &&\n          attempt < this.maxRetries;\n\n        if (shouldRetry) {\n          continue;\n        }\n\n        let errorBody: unknown;\n        try {\n          errorBody = await response.json();\n        } catch {\n          /* ignore parse errors */\n        }\n        const message =\n          typeof errorBody === \"object\" && errorBody !== null\n            ? String(\n                \"message\" in errorBody\n                  ? (errorBody as Record<string, unknown>).message\n                  : \"detail\" in errorBody\n                    ? (errorBody as Record<string, unknown>).detail\n                    : `HTTP ${response.status}`,\n              )\n            : `HTTP ${response.status}`;\n        throw new BrowserUseError(response.status, message, errorBody);\n      } catch (error) {\n        clearTimeout(timeoutId);\n        throw error;\n      }\n    }\n\n    throw new Error(\"Unreachable: retry loop exhausted\");\n  }\n\n  get<T>(path: string, query?: Record<string, unknown>): Promise<T> {\n    return this.request<T>(\"GET\", path, { query });\n  }\n\n  post<T>(path: string, body?: unknown, query?: Record<string, unknown>): Promise<T> {\n    return this.request<T>(\"POST\", path, { body, query });\n  }\n\n  patch<T>(path: string, body?: unknown, query?: Record<string, unknown>): Promise<T> {\n    return this.request<T>(\"PATCH\", path, { body, query });\n  }\n\n  delete<T>(path: string, query?: Record<string, unknown>): Promise<T> {\n    return this.request<T>(\"DELETE\", path, { query });\n  }\n}\n"]}

package/dist/errors-BtB79l7x.d.cts

@@ -0,0 +1,30 @@
+interface HttpClientOptions {
+    apiKey: string;
+    baseUrl: string;
+    maxRetries?: number;
+    timeout?: number;
+}
+declare class HttpClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly maxRetries;
+    private readonly timeout;
+    constructor(options: HttpClientOptions);
+    request<T>(method: string, path: string, options?: {
+        body?: unknown;
+        query?: Record<string, unknown>;
+        signal?: AbortSignal;
+    }): Promise<T>;
+    get<T>(path: string, query?: Record<string, unknown>): Promise<T>;
+    post<T>(path: string, body?: unknown, query?: Record<string, unknown>): Promise<T>;
+    patch<T>(path: string, body?: unknown, query?: Record<string, unknown>): Promise<T>;
+    delete<T>(path: string, query?: Record<string, unknown>): Promise<T>;
+}
+
+declare class BrowserUseError extends Error {
+    readonly statusCode: number;
+    readonly detail: unknown;
+    constructor(statusCode: number, message: string, detail?: unknown);
+}
+
+export { BrowserUseError as B, HttpClient as H };

package/dist/errors-BtB79l7x.d.ts

@@ -0,0 +1,30 @@
+interface HttpClientOptions {
+    apiKey: string;
+    baseUrl: string;
+    maxRetries?: number;
+    timeout?: number;
+}
+declare class HttpClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly maxRetries;
+    private readonly timeout;
+    constructor(options: HttpClientOptions);
+    request<T>(method: string, path: string, options?: {
+        body?: unknown;
+        query?: Record<string, unknown>;
+        signal?: AbortSignal;
+    }): Promise<T>;
+    get<T>(path: string, query?: Record<string, unknown>): Promise<T>;
+    post<T>(path: string, body?: unknown, query?: Record<string, unknown>): Promise<T>;
+    patch<T>(path: string, body?: unknown, query?: Record<string, unknown>): Promise<T>;
+    delete<T>(path: string, query?: Record<string, unknown>): Promise<T>;
+}
+
+declare class BrowserUseError extends Error {
+    readonly statusCode: number;
+    readonly detail: unknown;
+    constructor(statusCode: number, message: string, detail?: unknown);
+}
+
+export { BrowserUseError as B, HttpClient as H };