@hyperbrowser/sdk 0.49.1 → 0.51.0

package/dist/services/sessions.d.ts

@@ -1,4 +1,4 @@
-import { BasicResponse, CreateSessionParams, GetSessionDownloadsUrlResponse, GetSessionRecordingUrlResponse, GetSessionVideoRecordingUrlResponse, SessionDetail, SessionListParams, SessionListResponse, SessionRecording } from "../types/session";
+import { BasicResponse, CreateSessionParams, GetActiveSessionsCountResponse, GetSessionDownloadsUrlResponse, GetSessionRecordingUrlResponse, GetSessionVideoRecordingUrlResponse, SessionDetail, SessionListParams, SessionListResponse, SessionRecording, UploadFileOptions, UploadFileResponse } from "../types/session";
 import { BaseService } from "./base";
 export declare class SessionsService extends BaseService {
     /**
@@ -41,4 +41,20 @@ export declare class SessionsService extends BaseService {
      * @param id The ID of the session to get the downloads URL from
      */
     getDownloadsURL(id: string): Promise<GetSessionDownloadsUrlResponse>;
+    /**
+     * Upload a file to the session
+     * @param id The ID of the session to upload the file to
+     * @param fileOptions Options for uploading a file
+     * @param fileOptions.fileInput File path string, ReadStream, or Buffer containing the file data
+     * @param fileOptions.fileName Optional name to use for the uploaded file. Required when fileInput is a Buffer
+     */
+    uploadFile(id: string, fileOptions: UploadFileOptions): Promise<UploadFileResponse>;
+    /**
+     * Helper method to check if input is a readable stream
+     */
+    private isReadableStream;
+    /**
+     * Get the number of active sessions
+     */
+    getActiveSessionsCount(): Promise<GetActiveSessionsCountResponse>;
 }

package/dist/services/sessions.js

@@ -1,6 +1,35 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SessionsService = void 0;
+const fs_1 = require("fs");
+const path = __importStar(require("path"));
+const form_data_1 = __importDefault(require("form-data"));
 const base_1 = require("./base");
 const client_1 = require("../client");
 class SessionsService extends base_1.BaseService {
@@ -133,5 +162,113 @@ class SessionsService extends base_1.BaseService {
             throw new client_1.HyperbrowserError(`Failed to get downloads url for session ${id}`, undefined);
         }
     }
+    /**
+     * Upload a file to the session
+     * @param id The ID of the session to upload the file to
+     * @param fileOptions Options for uploading a file
+     * @param fileOptions.fileInput File path string, ReadStream, or Buffer containing the file data
+     * @param fileOptions.fileName Optional name to use for the uploaded file. Required when fileInput is a Buffer
+     */
+    async uploadFile(id, fileOptions) {
+        const { fileInput, fileName } = fileOptions;
+        try {
+            let fetchOptions;
+            if (typeof fileInput === "string") {
+                let stats;
+                try {
+                    stats = await fs_1.promises.stat(fileInput);
+                }
+                catch (error) {
+                    if (error.code === "ENOENT") {
+                        throw new client_1.HyperbrowserError(`File not found: ${fileInput}`, undefined);
+                    }
+                    if (error.code === "EACCES") {
+                        throw new client_1.HyperbrowserError(`Permission denied accessing file: ${fileInput}`, undefined);
+                    }
+                    throw new client_1.HyperbrowserError(`Failed to access file ${fileInput}: ${error.message}`, undefined);
+                }
+                if (!stats.isFile()) {
+                    throw new client_1.HyperbrowserError(`Path is not a file: ${fileInput}`, undefined);
+                }
+                const formData = new form_data_1.default();
+                const fileStream = (0, fs_1.createReadStream)(fileInput);
+                const fileBaseName = fileName || path.basename(fileInput);
+                fileStream.on("error", (error) => {
+                    throw new client_1.HyperbrowserError(`Failed to read file ${fileInput}: ${error.message}`, undefined);
+                });
+                formData.append("file", fileStream, {
+                    filename: fileBaseName,
+                });
+                fetchOptions = {
+                    method: "POST",
+                    body: formData,
+                    headers: formData.getHeaders(),
+                };
+            }
+            else if (this.isReadableStream(fileInput)) {
+                const formData = new form_data_1.default();
+                let tmpFileName = fileName || `file-${Date.now()}`;
+                if (fileInput.path && typeof fileInput.path === "string" && !fileName) {
+                    tmpFileName = path.basename(fileInput.path);
+                }
+                formData.append("file", fileInput, {
+                    filename: tmpFileName,
+                });
+                fetchOptions = {
+                    method: "POST",
+                    body: formData,
+                    headers: formData.getHeaders(),
+                };
+            }
+            else if (Buffer.isBuffer(fileInput)) {
+                if (!fileName) {
+                    throw new client_1.HyperbrowserError("fileName is required when uploading Buffer data", undefined);
+                }
+                const formData = new form_data_1.default();
+                formData.append("file", fileInput, {
+                    filename: fileName,
+                });
+                fetchOptions = {
+                    method: "POST",
+                    body: formData,
+                    headers: formData.getHeaders(),
+                };
+            }
+            else {
+                throw new client_1.HyperbrowserError("Unsupported file input type. Please provide a file path string, ReadStream, or Buffer.", undefined);
+            }
+            return await this.request(`/session/${id}/uploads`, fetchOptions);
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError(`Failed to upload file for session ${id}: ${error}`, undefined);
+        }
+    }
+    /**
+     * Helper method to check if input is a readable stream
+     */
+    isReadableStream(obj) {
+        return (obj &&
+            typeof obj === "object" &&
+            typeof obj.read === "function" &&
+            typeof obj.on === "function" &&
+            obj.readable !== false);
+    }
+    /**
+     * Get the number of active sessions
+     */
+    async getActiveSessionsCount() {
+        try {
+            return await this.request("/sessions/active-count");
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError("Failed to get active sessions count", undefined);
+        }
+    }
 }
 exports.SessionsService = SessionsService;

package/dist/types/agents/claude-computer-use.d.ts

@@ -1,7 +1,8 @@
-import { ClaudeComputerUseTaskStatus } from "../constants";
+import { ClaudeComputerUseLlm, ClaudeComputerUseTaskStatus } from "../constants";
 import { CreateSessionParams } from "../session";
 export interface StartClaudeComputerUseTaskParams {
     task: string;
+    llm?: ClaudeComputerUseLlm;
     sessionId?: string;
     maxFailures?: number;
     maxSteps?: number;

package/dist/types/constants.d.ts

@@ -13,7 +13,8 @@ export type ScrapeScreenshotFormat = "jpeg" | "png" | "webp";
 export type RecordingStatus = "not_enabled" | "pending" | "in_progress" | "completed" | "failed";
 export type DownloadsStatus = "not_enabled" | "pending" | "in_progress" | "completed" | "failed";
 export declare const POLLING_ATTEMPTS = 5;
-export type BrowserUseLlm = "gpt-4o" | "gpt-4o-mini" | "claude-3-7-sonnet-20250219" | "claude-3-5-sonnet-20241022" | "claude-3-5-haiku-20241022" | "gemini-2.0-flash";
+export type BrowserUseLlm = "gpt-4o" | "gpt-4o-mini" | "gpt-4.1" | "gpt-4.1-mini" | "claude-sonnet-4-20250514" | "claude-3-7-sonnet-20250219" | "claude-3-5-sonnet-20241022" | "claude-3-5-haiku-20241022" | "gemini-2.0-flash";
+export type ClaudeComputerUseLlm = "claude-3-7-sonnet-20250219" | "claude-sonnet-4-20250514";
 export type HyperAgentLlm = "gpt-4o" | "gpt-4o-mini" | "gpt-4.1" | "gpt-4.1-mini" | "gpt-4.1-nano";
 export type Country = "AD" | "AE" | "AF" | "AL" | "AM" | "AO" | "AR" | "AT" | "AU" | "AW" | "AZ" | "BA" | "BD" | "BE" | "BG" | "BH" | "BJ" | "BO" | "BR" | "BS" | "BT" | "BY" | "BZ" | "CA" | "CF" | "CH" | "CI" | "CL" | "CM" | "CN" | "CO" | "CR" | "CU" | "CY" | "CZ" | "DE" | "DJ" | "DK" | "DM" | "EC" | "EE" | "EG" | "ES" | "ET" | "EU" | "FI" | "FJ" | "FR" | "GB" | "GE" | "GH" | "GM" | "GR" | "HK" | "HN" | "HR" | "HT" | "HU" | "ID" | "IE" | "IL" | "IN" | "IQ" | "IR" | "IS" | "IT" | "JM" | "JO" | "JP" | "KE" | "KH" | "KR" | "KW" | "KZ" | "LB" | "LI" | "LR" | "LT" | "LU" | "LV" | "MA" | "MC" | "MD" | "ME" | "MG" | "MK" | "ML" | "MM" | "MN" | "MR" | "MT" | "MU" | "MV" | "MX" | "MY" | "MZ" | "NG" | "NL" | "NO" | "NZ" | "OM" | "PA" | "PE" | "PH" | "PK" | "PL" | "PR" | "PT" | "PY" | "QA" | "RANDOM_COUNTRY" | "RO" | "RS" | "RU" | "SA" | "SC" | "SD" | "SE" | "SG" | "SI" | "SK" | "SN" | "SS" | "TD" | "TG" | "TH" | "TM" | "TN" | "TR" | "TT" | "TW" | "UA" | "UG" | "US" | "UY" | "UZ" | "VE" | "VG" | "VN" | "YE" | "ZA" | "ZM" | "ZW" | "ad" | "ae" | "af" | "al" | "am" | "ao" | "ar" | "at" | "au" | "aw" | "az" | "ba" | "bd" | "be" | "bg" | "bh" | "bj" | "bo" | "br" | "bs" | "bt" | "by" | "bz" | "ca" | "cf" | "ch" | "ci" | "cl" | "cm" | "cn" | "co" | "cr" | "cu" | "cy" | "cz" | "de" | "dj" | "dk" | "dm" | "ec" | "ee" | "eg" | "es" | "et" | "eu" | "fi" | "fj" | "fr" | "gb" | "ge" | "gh" | "gm" | "gr" | "hk" | "hn" | "hr" | "ht" | "hu" | "id" | "ie" | "il" | "in" | "iq" | "ir" | "is" | "it" | "jm" | "jo" | "jp" | "ke" | "kh" | "kr" | "kw" | "kz" | "lb" | "li" | "lr" | "lt" | "lu" | "lv" | "ma" | "mc" | "md" | "me" | "mg" | "mk" | "ml" | "mm" | "mn" | "mr" | "mt" | "mu" | "mv" | "mx" | "my" | "mz" | "ng" | "nl" | "no" | "nz" | "om" | "pa" | "pe" | "ph" | "pk" | "pl" | "pr" | "pt" | "py" | "qa" | "ro" | "rs" | "ru" | "sa" | "sc" | "sd" | "se" | "sg" | "si" | "sk" | "sn" | "ss" | "td" | "tg" | "th" | "tm" | "tn" | "tr" | "tt" | "tw" | "ua" | "ug" | "us" | "uy" | "uz" | "ve" | "vg" | "vn" | "ye" | "za" | "zm" | "zw";
 export type OperatingSystem = "windows" | "android" | "macos" | "linux" | "ios";

package/dist/types/index.d.ts

@@ -6,7 +6,7 @@ export { StartBrowserUseTaskParams, StartBrowserUseTaskResponse, BrowserUseTaskS
 export { StartClaudeComputerUseTaskParams, StartClaudeComputerUseTaskResponse, ClaudeComputerUseTaskStatusResponse, ClaudeComputerUseTaskResponse, ClaudeComputerUseTaskData, ClaudeComputerUseStepResponse, } from "./agents/claude-computer-use";
 export { StartCuaTaskParams, StartCuaTaskResponse, CuaTaskStatusResponse, CuaTaskResponse, CuaTaskData, CuaStepResponse, } from "./agents/cua";
 export { StartHyperAgentTaskParams, StartHyperAgentTaskResponse, HyperAgentTaskStatusResponse, HyperAgentTaskResponse, HyperAgentTaskData, HyperAgentStep, HyperAgentOutput, HyperAgentActionOutput, } from "./agents/hyper-agent";
-export { BasicResponse, SessionStatus, Session, SessionDetail, SessionListParams, SessionListResponse, ScreenConfig, CreateSessionParams, GetSessionDownloadsUrlResponse, GetSessionVideoRecordingUrlResponse, GetSessionRecordingUrlResponse, ImageCaptchaParam, } from "./session";
+export { BasicResponse, SessionStatus, Session, SessionDetail, SessionListParams, SessionListResponse, ScreenConfig, CreateSessionParams, GetSessionDownloadsUrlResponse, GetSessionVideoRecordingUrlResponse, GetSessionRecordingUrlResponse, ImageCaptchaParam, UploadFileResponse, UploadFileOptions, GetActiveSessionsCountResponse, } from "./session";
 export { CreateProfileParams, ProfileResponse, CreateProfileResponse, ProfileListParams, ProfileListResponse, } from "./profile";
 export { CreateExtensionParams, CreateExtensionResponse, ListExtensionsResponse, } from "./extension";
-export { ExtractJobStatus, BrowserUseTaskStatus, BrowserUseLlm, ScrapeScreenshotFormat, ScrapeJobStatus, CrawlJobStatus, Country, State, ISO639_1, OperatingSystem, Platform, ScrapeFormat, ScrapeWaitUntil, ScrapePageStatus, CrawlPageStatus, RecordingStatus, DownloadsStatus, HyperAgentLlm, HyperAgentTaskStatus, ClaudeComputerUseTaskStatus, CuaTaskStatus, } from "./constants";
+export { ExtractJobStatus, BrowserUseTaskStatus, BrowserUseLlm, ClaudeComputerUseLlm, ScrapeScreenshotFormat, ScrapeJobStatus, CrawlJobStatus, Country, State, ISO639_1, OperatingSystem, Platform, ScrapeFormat, ScrapeWaitUntil, ScrapePageStatus, CrawlPageStatus, RecordingStatus, DownloadsStatus, HyperAgentLlm, HyperAgentTaskStatus, ClaudeComputerUseTaskStatus, CuaTaskStatus, } from "./constants";

package/dist/types/session.d.ts

@@ -1,3 +1,4 @@
+import fs from "fs";
 import { Country, DownloadsStatus, ISO639_1, OperatingSystem, Platform, RecordingStatus, State } from "./constants";
 export type SessionStatus = "active" | "closed" | "error";
 export interface BasicResponse {
@@ -92,3 +93,13 @@ export interface GetSessionDownloadsUrlResponse {
     downloadsUrl?: string | null;
     error?: string | null;
 }
+export interface UploadFileResponse {
+    message: string;
+}
+export interface UploadFileOptions {
+    fileInput: string | fs.ReadStream | Buffer;
+    fileName?: string;
+}
+export interface GetActiveSessionsCountResponse {
+    activeSessionsCount: number;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperbrowser/sdk",
-  "version": "0.49.1",
+  "version": "0.51.0",
   "description": "Node SDK for Hyperbrowser API",
   "author": "",
   "main": "dist/index.js",