browser-use-sdk 2.0.3 → 2.0.5

package/dist/esm/core/logging/logger.d.mts

@@ -0,0 +1,126 @@
+export declare const LogLevel: {
+    readonly Debug: "debug";
+    readonly Info: "info";
+    readonly Warn: "warn";
+    readonly Error: "error";
+};
+export type LogLevel = (typeof LogLevel)[keyof typeof LogLevel];
+export interface ILogger {
+    /**
+     * Logs a debug message.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    debug(message: string, ...args: unknown[]): void;
+    /**
+     * Logs an info message.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    info(message: string, ...args: unknown[]): void;
+    /**
+     * Logs a warning message.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    warn(message: string, ...args: unknown[]): void;
+    /**
+     * Logs an error message.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    error(message: string, ...args: unknown[]): void;
+}
+/**
+ * Configuration for logger initialization.
+ */
+export interface LogConfig {
+    /**
+     * Minimum log level to output.
+     * @default LogLevel.Info
+     */
+    level?: LogLevel;
+    /**
+     * Logger implementation to use.
+     * @default new ConsoleLogger()
+     */
+    logger?: ILogger;
+    /**
+     * Whether logging should be silenced.
+     * @default true
+     */
+    silent?: boolean;
+}
+/**
+ * Default console-based logger implementation.
+ */
+export declare class ConsoleLogger implements ILogger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+/**
+ * Logger class that provides level-based logging functionality.
+ */
+export declare class Logger {
+    private readonly level;
+    private readonly logger;
+    private readonly silent;
+    /**
+     * Creates a new logger instance.
+     * @param config - Logger configuration
+     */
+    constructor(config: Required<LogConfig>);
+    /**
+     * Checks if a log level should be output based on configuration.
+     * @param level - The log level to check
+     * @returns True if the level should be logged
+     */
+    shouldLog(level: LogLevel): boolean;
+    /**
+     * Checks if debug logging is enabled.
+     * @returns True if debug logs should be output
+     */
+    isDebug(): boolean;
+    /**
+     * Logs a debug message if debug logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    debug(message: string, ...args: unknown[]): void;
+    /**
+     * Checks if info logging is enabled.
+     * @returns True if info logs should be output
+     */
+    isInfo(): boolean;
+    /**
+     * Logs an info message if info logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    info(message: string, ...args: unknown[]): void;
+    /**
+     * Checks if warning logging is enabled.
+     * @returns True if warning logs should be output
+     */
+    isWarn(): boolean;
+    /**
+     * Logs a warning message if warning logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    warn(message: string, ...args: unknown[]): void;
+    /**
+     * Checks if error logging is enabled.
+     * @returns True if error logs should be output
+     */
+    isError(): boolean;
+    /**
+     * Logs an error message if error logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    error(message: string, ...args: unknown[]): void;
+}
+export declare function createLogger(config?: LogConfig | Logger): Logger;

package/dist/esm/core/logging/logger.mjs

@@ -0,0 +1,138 @@
+export const LogLevel = {
+    Debug: "debug",
+    Info: "info",
+    Warn: "warn",
+    Error: "error",
+};
+const logLevelMap = {
+    [LogLevel.Debug]: 1,
+    [LogLevel.Info]: 2,
+    [LogLevel.Warn]: 3,
+    [LogLevel.Error]: 4,
+};
+/**
+ * Default console-based logger implementation.
+ */
+export class ConsoleLogger {
+    debug(message, ...args) {
+        console.debug(message, ...args);
+    }
+    info(message, ...args) {
+        console.info(message, ...args);
+    }
+    warn(message, ...args) {
+        console.warn(message, ...args);
+    }
+    error(message, ...args) {
+        console.error(message, ...args);
+    }
+}
+/**
+ * Logger class that provides level-based logging functionality.
+ */
+export class Logger {
+    /**
+     * Creates a new logger instance.
+     * @param config - Logger configuration
+     */
+    constructor(config) {
+        this.level = logLevelMap[config.level];
+        this.logger = config.logger;
+        this.silent = config.silent;
+    }
+    /**
+     * Checks if a log level should be output based on configuration.
+     * @param level - The log level to check
+     * @returns True if the level should be logged
+     */
+    shouldLog(level) {
+        return !this.silent && this.level <= logLevelMap[level];
+    }
+    /**
+     * Checks if debug logging is enabled.
+     * @returns True if debug logs should be output
+     */
+    isDebug() {
+        return this.shouldLog(LogLevel.Debug);
+    }
+    /**
+     * Logs a debug message if debug logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    debug(message, ...args) {
+        if (this.isDebug()) {
+            this.logger.debug(message, ...args);
+        }
+    }
+    /**
+     * Checks if info logging is enabled.
+     * @returns True if info logs should be output
+     */
+    isInfo() {
+        return this.shouldLog(LogLevel.Info);
+    }
+    /**
+     * Logs an info message if info logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    info(message, ...args) {
+        if (this.isInfo()) {
+            this.logger.info(message, ...args);
+        }
+    }
+    /**
+     * Checks if warning logging is enabled.
+     * @returns True if warning logs should be output
+     */
+    isWarn() {
+        return this.shouldLog(LogLevel.Warn);
+    }
+    /**
+     * Logs a warning message if warning logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    warn(message, ...args) {
+        if (this.isWarn()) {
+            this.logger.warn(message, ...args);
+        }
+    }
+    /**
+     * Checks if error logging is enabled.
+     * @returns True if error logs should be output
+     */
+    isError() {
+        return this.shouldLog(LogLevel.Error);
+    }
+    /**
+     * Logs an error message if error logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    error(message, ...args) {
+        if (this.isError()) {
+            this.logger.error(message, ...args);
+        }
+    }
+}
+export function createLogger(config) {
+    var _a, _b, _c;
+    if (config == null) {
+        return defaultLogger;
+    }
+    if (config instanceof Logger) {
+        return config;
+    }
+    config = config !== null && config !== void 0 ? config : {};
+    (_a = config.level) !== null && _a !== void 0 ? _a : (config.level = LogLevel.Info);
+    (_b = config.logger) !== null && _b !== void 0 ? _b : (config.logger = new ConsoleLogger());
+    (_c = config.silent) !== null && _c !== void 0 ? _c : (config.silent = true);
+    return new Logger(config);
+}
+const defaultLogger = new Logger({
+    level: LogLevel.Info,
+    logger: new ConsoleLogger(),
+    silent: true,
+});

package/dist/esm/core/url/encodePathParam.d.mts

@@ -0,0 +1 @@
+export declare function encodePathParam(param: unknown): string;

package/dist/esm/core/url/encodePathParam.mjs

@@ -0,0 +1,18 @@
+export function encodePathParam(param) {
+    if (param === null) {
+        return "null";
+    }
+    const typeofParam = typeof param;
+    switch (typeofParam) {
+        case "undefined":
+            return "undefined";
+        case "string":
+        case "number":
+        case "boolean":
+            break;
+        default:
+            param = String(param);
+            break;
+    }
+    return encodeURIComponent(param);
+}

package/dist/esm/core/url/index.d.mts

@@ -1,2 +1,3 @@
+export { encodePathParam } from "./encodePathParam.mjs";
 export { join } from "./join.mjs";
 export { toQueryString } from "./qs.mjs";

package/dist/esm/core/url/index.mjs

@@ -1,2 +1,3 @@
+export { encodePathParam } from "./encodePathParam.mjs";
 export { join } from "./join.mjs";
 export { toQueryString } from "./qs.mjs";

package/dist/esm/core/url/join.mjs

@@ -11,11 +11,10 @@ export function join(base, ...segments) {
             url = new URL(base);
         }
         catch (_a) {
-            // Fallback to path joining if URL is malformed
             return joinPath(base, ...segments);
         }
         const lastSegment = segments[segments.length - 1];
-        const shouldPreserveTrailingSlash = lastSegment && lastSegment.endsWith("/");
+        const shouldPreserveTrailingSlash = lastSegment === null || lastSegment === void 0 ? void 0 : lastSegment.endsWith("/");
         for (const segment of segments) {
             const cleanSegment = trimSlashes(segment);
             if (cleanSegment) {
@@ -35,7 +34,7 @@ function joinPath(base, ...segments) {
     }
     let result = base;
     const lastSegment = segments[segments.length - 1];
-    const shouldPreserveTrailingSlash = lastSegment && lastSegment.endsWith("/");
+    const shouldPreserveTrailingSlash = lastSegment === null || lastSegment === void 0 ? void 0 : lastSegment.endsWith("/");
     for (const segment of segments) {
         const cleanSegment = trimSlashes(segment);
         if (cleanSegment) {
@@ -51,7 +50,7 @@ function joinPathSegments(left, right) {
     if (left.endsWith("/")) {
         return left + right;
     }
-    return left + "/" + right;
+    return `${left}/${right}`;
 }
 function trimSlashes(str) {
     if (!str)

package/dist/esm/environments.d.mts

@@ -1,6 +1,3 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
 export declare const BrowserUseEnvironment: {
     readonly Production: "https://api.browser-use.com/api/v2";
 };

package/dist/esm/environments.mjs

@@ -1,6 +1,4 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 export const BrowserUseEnvironment = {
     Production: "https://api.browser-use.com/api/v2",
 };

package/dist/esm/errors/BrowserUseError.d.mts

@@ -1,7 +1,4 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as core from "../core/index.mjs";
+import type * as core from "../core/index.mjs";
 export declare class BrowserUseError extends Error {
     readonly statusCode?: number;
     readonly body?: unknown;

package/dist/esm/errors/BrowserUseError.mjs

@@ -1,6 +1,4 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 import { toJson } from "../core/json.mjs";
 export class BrowserUseError extends Error {
     constructor({ message, statusCode, body, rawResponse, }) {
@@ -12,7 +10,7 @@ export class BrowserUseError extends Error {
     }
 }
 function buildMessage({ message, statusCode, body, }) {
-    let lines = [];
+    const lines = [];
     if (message != null) {
         lines.push(message);
     }

package/dist/esm/errors/BrowserUseTimeoutError.d.mts

@@ -1,6 +1,3 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
 export declare class BrowserUseTimeoutError extends Error {
     constructor(message: string);
 }

package/dist/esm/errors/BrowserUseTimeoutError.mjs

@@ -1,6 +1,4 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 export class BrowserUseTimeoutError extends Error {
     constructor(message) {
         super(message);

package/dist/esm/exports.d.mts

@@ -0,0 +1 @@
+export * from "./core/exports.mjs";

package/dist/esm/exports.mjs

@@ -0,0 +1 @@
+export * from "./core/exports.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.0.3";
+export declare const SDK_VERSION = "2.0.5";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "2.0.3";
+export const SDK_VERSION = "2.0.5";

package/dist/esm/wrapper/api/BrowserUseTasks.d.mts

@@ -8,8 +8,8 @@ export declare class BrowserUseTasks extends Tasks {
     createTask<T extends ZodType>(request: CreateTaskRequestWithSchema<T>, requestOptions?: Tasks.RequestOptions): core.HttpResponsePromise<WrappedTaskFnsWithSchema<T>>;
     createTask(request: BrowserUse.CreateTaskRequest, requestOptions?: Tasks.RequestOptions): core.HttpResponsePromise<WrappedTaskFnsWithoutSchema>;
     getTask<T extends ZodType>(request: {
-        taskId: string;
+        task_id: string;
         schema: T;
     }, requestOptions?: Tasks.RequestOptions): core.HttpResponsePromise<TaskViewWithSchema<T>>;
-    getTask(taskId: string, requestOptions?: Tasks.RequestOptions): core.HttpResponsePromise<BrowserUse.TaskView>;
+    getTask(request: BrowserUse.GetTaskTasksTaskIdGetRequest, requestOptions?: Tasks.RequestOptions): core.HttpResponsePromise<BrowserUse.TaskView>;
 }

package/dist/esm/wrapper/api/BrowserUseTasks.mjs

@@ -1,3 +1,4 @@
+import * as BrowserUse from "../../api/index.mjs";
 import * as core from "../../core/index.mjs";
 import { Tasks } from "../../api/resources/tasks/client/Client.mjs";
 import { stringifyStructuredOutput, wrapCreateTaskResponse, parseStructuredTaskOutput, } from "../lib/parse.mjs";
@@ -33,12 +34,12 @@ export class BrowserUseTasks extends Tasks {
         return core.HttpResponsePromise.fromPromise(promise);
     }
     getTask(request, requestOptions) {
-        if (typeof request === "string") {
+        if (!request.schema) {
             return super.getTask(request, requestOptions);
         }
-        const { taskId, schema } = request;
+        const { task_id, schema } = request;
         const promise = super
-            .getTask(taskId, requestOptions)
+            .getTask({ task_id }, requestOptions)
             .withRawResponse()
             .then((res) => {
             const parsed = parseStructuredTaskOutput(res.data, schema);

package/dist/esm/wrapper/lib/parse.mjs

@@ -29,7 +29,7 @@ var __asyncValues = (this && this.__asyncValues) || function (o) {
 };
 import { createHash } from "crypto";
 import stringify from "fast-json-stable-stringify";
-import z from "zod";
+import z, {} from "zod";
 import { ExhaustiveSwitchCheck } from "./types.mjs";
 export function stringifyStructuredOutput(schema) {
     return JSON.stringify(z.toJSONSchema(schema));
@@ -74,7 +74,7 @@ export function wrapCreateTaskResponse(client, response, schema) {
                 if ((_b = options === null || options === void 0 ? void 0 : options.signal) === null || _b === void 0 ? void 0 : _b.aborted) {
                     break poll;
                 }
-                const res = yield __await(client.getTask(taskId));
+                const res = yield __await(client.getTask({ task_id: taskId }));
                 const resHash = getTaskViewHash(res);
                 if (hash.current == null || resHash !== hash.current) {
                     hash.current = resHash;
@@ -83,8 +83,6 @@ export function wrapCreateTaskResponse(client, response, schema) {
                 switch (res.status) {
                     case "finished":
                     case "stopped":
-                    case "paused":
-                        break poll;
                     case "started":
                         yield __await(new Promise((resolve) => setTimeout(resolve, intervalMs)));
                         break;
@@ -164,16 +162,6 @@ export function wrapCreateTaskResponse(client, response, schema) {
                     switch (msg.data.status) {
                         case "finished":
                         case "stopped":
-                        case "paused": {
-                            if (schema != null) {
-                                const parsed = parseStructuredTaskOutput(msg.data, schema);
-                                return parsed;
-                            }
-                            else {
-                                const result = msg.data;
-                                return result;
-                            }
-                        }
                         case "started":
                             break;
                         default:

package/dist/esm/wrapper/lib/webhooks.d.mts

@@ -12,11 +12,21 @@ export declare const zWebhookTest: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const zWebhookAgentTaskStatusUpdatePayloadMetadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-export declare const zWebhookAgentTaskStatusUpdatePayloadStatus: z.ZodLiteral<"stopped" | "started" | "paused" | "finished" | "initializing">;
+export declare const zWebhookAgentTaskStatusUpdatePayloadStatus: z.ZodEnum<{
+    stopped: "stopped";
+    started: "started";
+    finished: "finished";
+    initializing: "initializing";
+}>;
 export declare const zWebhookAgentTaskStatusUpdatePayload: z.ZodObject<{
     session_id: z.ZodString;
     task_id: z.ZodString;
-    status: z.ZodLiteral<"stopped" | "started" | "paused" | "finished" | "initializing">;
+    status: z.ZodEnum<{
+        stopped: "stopped";
+        started: "started";
+        finished: "finished";
+        initializing: "initializing";
+    }>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
 export type WebhookAgentTaskStatusUpdatePayload = z.infer<typeof zWebhookAgentTaskStatusUpdatePayload>;
@@ -26,7 +36,12 @@ export declare const zWebhookAgentTaskStatusUpdate: z.ZodObject<{
     payload: z.ZodObject<{
         session_id: z.ZodString;
         task_id: z.ZodString;
-        status: z.ZodLiteral<"stopped" | "started" | "paused" | "finished" | "initializing">;
+        status: z.ZodEnum<{
+            stopped: "stopped";
+            started: "started";
+            finished: "finished";
+            initializing: "initializing";
+        }>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
@@ -42,7 +57,12 @@ export declare const zWebhookSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     payload: z.ZodObject<{
         session_id: z.ZodString;
         task_id: z.ZodString;
-        status: z.ZodLiteral<"stopped" | "started" | "paused" | "finished" | "initializing">;
+        status: z.ZodEnum<{
+            stopped: "stopped";
+            started: "started";
+            finished: "finished";
+            initializing: "initializing";
+        }>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>;
 }, z.core.$strip>], "type">;

package/dist/esm/wrapper/lib/webhooks.mjs

@@ -24,10 +24,10 @@ export const zWebhookTest = z.object({
 });
 // agent.task.status_update
 export const zWebhookAgentTaskStatusUpdatePayloadMetadata = z.record(z.string(), z.unknown()).optional();
-export const zWebhookAgentTaskStatusUpdatePayloadStatus = z.literal([
+export const zWebhookAgentTaskStatusUpdatePayloadStatus = z.enum([
     "initializing",
     "started",
-    "paused",
+    // "paused", // deprecated
     "stopped",
     "finished",
 ]);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "browser-use-sdk",
-    "version": "2.0.3",
+    "version": "2.0.5",
     "private": false,
     "repository": "github:browser-use/browser-use-node",
     "type": "commonjs",
@@ -29,14 +29,18 @@
         "LICENSE"
     ],
     "scripts": {
-        "format": "prettier . --write --ignore-unknown",
-        "build": "yarn build:cjs && yarn build:esm",
+        "format": "biome format --write --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
+        "format:check": "biome format --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
+        "lint": "biome lint --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
+        "lint:fix": "biome lint --fix --unsafe --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
+        "check": "biome check --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
+        "check:fix": "biome check --fix --unsafe --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
+        "build": "pnpm build:cjs && pnpm build:esm",
         "build:cjs": "tsc --project ./tsconfig.cjs.json",
         "build:esm": "tsc --project ./tsconfig.esm.json && node scripts/rename-to-esm-files.js dist/esm",
-        "test": "jest --config jest.config.mjs",
-        "test:unit": "jest --selectProjects unit",
-        "test:browser": "jest --selectProjects browser",
-        "test:wire": "jest --selectProjects wire",
+        "test": "vitest",
+        "test:unit": "vitest --project unit",
+        "test:wire": "vitest --project wire",
         "tsn": "ts-node -r tsconfig-paths/register"
     },
     "dependencies": {
@@ -49,15 +53,11 @@
     "devDependencies": {
         "webpack": "^5.97.1",
         "ts-loader": "^9.5.1",
-        "jest": "^29.7.0",
-        "@jest/globals": "^29.7.0",
-        "@types/jest": "^29.5.14",
-        "ts-jest": "^29.3.4",
-        "jest-environment-jsdom": "^29.7.0",
-        "msw": "^2.8.4",
+        "vitest": "^3.2.4",
+        "msw": "2.11.2",
         "@types/node": "^18.19.70",
-        "prettier": "^3.4.2",
         "typescript": "~5.7.2",
+        "@biomejs/biome": "2.3.1",
         "@dotenvx/dotenvx": "^1.49.0",
         "react": "^19.1.1",
         "react-dom": "^19.1.1",
@@ -71,7 +71,7 @@
         "path": false,
         "stream": false
     },
-    "packageManager": "yarn@1.22.22",
+    "packageManager": "pnpm@10.20.0",
     "engines": {
         "node": ">=18.0.0"
     },