@hyperbrowser/sdk 0.89.8 → 0.90.0

package/dist/services/base.js

@@ -51,9 +51,10 @@ class BaseService {
             }
             const headerKeys = Object.keys(init?.headers || {});
             const contentTypeKey = headerKeys.find((key) => key.toLowerCase() === "content-type");
+            const requestTimeout = init?.timeout ?? this.timeout;
             const response = await (0, node_fetch_1.default)(url.toString(), {
                 ...init,
-                timeout: this.timeout,
+                timeout: requestTimeout,
                 headers: {
                     "x-api-key": this.apiKey,
                     ...(contentTypeKey && init?.headers

package/dist/services/sessions.d.ts

@@ -1,4 +1,4 @@
-import { BasicResponse, CreateSessionParams, GetActiveSessionsCountResponse, GetSessionDownloadsUrlResponse, GetSessionRecordingUrlResponse, GetSessionVideoRecordingUrlResponse, SessionDetail, SessionListParams, SessionListResponse, SessionRecording, UploadFileOptions, UploadFileResponse, SessionEventLogListParams, SessionEventLogListResponse, UpdateSessionProfileParams, UpdateSessionProxyParams, UpdateSessionScreenParams, SessionGetParams } from "../types/session";
+import { BasicResponse, CaptchaEvaluationParams, CaptchaEvaluationResponse, CreateSessionParams, GetActiveSessionsCountResponse, GetSessionDownloadsUrlResponse, GetSessionRecordingUrlResponse, GetSessionVideoRecordingUrlResponse, SessionDetail, SessionListParams, SessionListResponse, SessionRecording, UploadFileOptions, UploadFileResponse, SessionEventLogListParams, SessionEventLogListResponse, UpdateSessionProfileParams, UpdateSessionProxyParams, UpdateSessionScreenParams, UpdateSessionSolveCaptchasParams, UpdateSessionSolveCaptchasResponse, SessionGetParams } from "../types/session";
 import { BaseService } from "./base";
 /**
  * Service for managing session event logs
@@ -29,6 +29,12 @@ export declare class SessionsService extends BaseService {
      * @param id The ID of the session to stop
      */
     stop(id: string): Promise<BasicResponse>;
+    /**
+     * Manually evaluate captchas in a running session.
+     * @param id The ID of the session to evaluate
+     * @param params Optional captcha evaluation parameters
+     */
+    evaluateCaptcha(id: string, params?: CaptchaEvaluationParams): Promise<CaptchaEvaluationResponse>;
     /**
      * List all sessions with optional filtering
      * @param params Optional parameters to filter the sessions
@@ -81,6 +87,17 @@ export declare class SessionsService extends BaseService {
     updateProfileParams(id: string, persistChanges: boolean): Promise<BasicResponse>;
     updateProxyParams(id: string, params: UpdateSessionProxyParams): Promise<BasicResponse>;
     updateScreenSize(id: string, params: UpdateSessionScreenParams): Promise<BasicResponse>;
+    /**
+     * Start automatic captcha solving for a running session.
+     * @param id The ID of the session to update
+     * @param params Optional captcha solver parameters
+     */
+    startCaptchaSolving(id: string, params?: UpdateSessionSolveCaptchasParams): Promise<UpdateSessionSolveCaptchasResponse>;
+    /**
+     * Stop automatic captcha solving for a running session.
+     * @param id The ID of the session to update
+     */
+    stopCaptchaSolving(id: string): Promise<UpdateSessionSolveCaptchasResponse>;
     private static hasWarnedUpdateSessionProfileParamsBooleanDeprecated;
     private warnUpdateSessionProfileParamsBooleanDeprecated;
 }

package/dist/services/sessions.js

@@ -32,6 +32,7 @@ const path = __importStar(require("path"));
 const form_data_1 = __importDefault(require("form-data"));
 const base_1 = require("./base");
 const client_1 = require("../client");
+const CAPTCHA_EVALUATION_REQUEST_TIMEOUT_MS = 185000;
 /**
  * Service for managing session event logs
  */
@@ -113,6 +114,26 @@ class SessionsService extends base_1.BaseService {
             throw new client_1.HyperbrowserError(`Failed to stop session ${id}`, undefined);
         }
     }
+    /**
+     * Manually evaluate captchas in a running session.
+     * @param id The ID of the session to evaluate
+     * @param params Optional captcha evaluation parameters
+     */
+    async evaluateCaptcha(id, params = {}) {
+        try {
+            return await this.request(`/session/${id}/captcha/evaluate`, {
+                method: "POST",
+                timeout: Math.max(this.timeout, CAPTCHA_EVALUATION_REQUEST_TIMEOUT_MS),
+                body: JSON.stringify(params),
+            });
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError(`Failed to evaluate captcha for session ${id}`, undefined);
+        }
+    }
     /**
      * List all sessions with optional filtering
      * @param params Optional parameters to filter the sessions
@@ -373,6 +394,54 @@ class SessionsService extends base_1.BaseService {
             throw new client_1.HyperbrowserError(`Failed to update screen for session ${id}`, undefined);
         }
     }
+    /**
+     * Start automatic captcha solving for a running session.
+     * @param id The ID of the session to update
+     * @param params Optional captcha solver parameters
+     */
+    async startCaptchaSolving(id, params = {}) {
+        try {
+            return await this.request(`/session/${id}/update`, {
+                method: "PUT",
+                body: JSON.stringify({
+                    type: "solveCaptchas",
+                    params: {
+                        enabled: true,
+                        ...params,
+                    },
+                }),
+            });
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError(`Failed to start captcha solving for session ${id}`, undefined);
+        }
+    }
+    /**
+     * Stop automatic captcha solving for a running session.
+     * @param id The ID of the session to update
+     */
+    async stopCaptchaSolving(id) {
+        try {
+            return await this.request(`/session/${id}/update`, {
+                method: "PUT",
+                body: JSON.stringify({
+                    type: "solveCaptchas",
+                    params: {
+                        enabled: false,
+                    },
+                }),
+            });
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError(`Failed to stop captcha solving for session ${id}`, undefined);
+        }
+    }
     warnUpdateSessionProfileParamsBooleanDeprecated() {
         if (SessionsService.hasWarnedUpdateSessionProfileParamsBooleanDeprecated) {
             return;

package/dist/types/index.d.ts

@@ -7,7 +7,7 @@ export { StartClaudeComputerUseTaskParams, StartClaudeComputerUseTaskResponse, C
 export { StartCuaTaskParams, StartCuaTaskResponse, CuaTaskStatusResponse, CuaTaskResponse, CuaTaskData, CuaStepResponse, CuaApiKeys, CuaTaskMetadata, } from "./agents/cua";
 export { StartHyperAgentTaskParams, StartHyperAgentTaskResponse, HyperAgentTaskStatusResponse, HyperAgentTaskResponse, HyperAgentTaskData, HyperAgentStep, HyperAgentOutput, HyperAgentActionOutput, HyperAgentApiKeys, HyperAgentTaskMetadata, HyperAgentOutputV110, HyperAgentStepV110, } from "./agents/hyper-agent";
 export { StartGeminiComputerUseTaskParams, StartGeminiComputerUseTaskResponse, GeminiComputerUseTaskStatusResponse, GeminiComputerUseTaskResponse, GeminiComputerUseTaskData, GeminiComputerUseStepResponse, GeminiComputerUseApiKeys, GeminiComputerUseTaskMetadata, } from "./agents/gemini-computer-use";
-export { BasicResponse, SessionStatus, Session, SessionDetail, SessionGetParams, SessionListParams, SessionListResponse, ScreenConfig, CreateSessionParams, GetSessionDownloadsUrlResponse, GetSessionVideoRecordingUrlResponse, GetSessionRecordingUrlResponse, ImageCaptchaParam, UploadFileResponse, UploadFileOptions, GetActiveSessionsCountResponse, SessionEventLogListParams, SessionEventLogListResponse, SessionEventLog, SessionProfile, SessionLaunchState, SessionCreditBreakdown, UpdateSessionProfileParams, UpdateSessionProxyLocationParams, UpdateSessionProxyParams, UpdateSessionScreenParams, } from "./session";
+export { BasicResponse, SessionStatus, Session, SessionDetail, SessionGetParams, SessionListParams, SessionListResponse, ScreenConfig, CaptchaEvaluationPageResult, CaptchaEvaluationParams, CaptchaEvaluationResponse, CaptchaEvaluationTarget, CaptchaEvaluationType, CaptchaSolverType, CreateSessionParams, GetSessionDownloadsUrlResponse, GetSessionVideoRecordingUrlResponse, GetSessionRecordingUrlResponse, ImageCaptchaParam, UploadFileResponse, UploadFileOptions, GetActiveSessionsCountResponse, SessionEventLogListParams, SessionEventLogListResponse, SessionEventLog, SessionProfile, SessionLaunchState, SessionCreditBreakdown, UpdateSessionProfileParams, UpdateSessionProxyLocationParams, UpdateSessionProxyParams, UpdateSessionScreenParams, UpdateSessionSolveCaptchasParams, UpdateSessionSolveCaptchasResponse, } from "./session";
 export { SandboxStatus, SandboxRuntimeTarget, Sandbox, SandboxDetail, SandboxVolumeMountType, SandboxVolumeMount, SandboxListParams, SandboxListResponse, SandboxImageSummary, SandboxImageListResponse, SandboxSnapshotStatus, SandboxSnapshotSummary, SandboxSnapshotListParams, SandboxSnapshotListResponse, CreateSandboxParams, SandboxMemorySnapshotParams, SandboxMemorySnapshotResult, SandboxExposeParams, SandboxExposeResult, SandboxUnexposeResult, SandboxProcessStatus, SandboxExecParams, SandboxExecOptions, SandboxProcessSummary, SandboxProcessResult, SandboxProcessListParams, SandboxProcessListResponse, SandboxProcessWaitParams, SandboxProcessSignal, SandboxProcessStdinParams, SandboxProcessStreamEvent, SandboxFileType, SandboxFileInfo, SandboxFileWriteInfo, SandboxFileListOptions, SandboxFileReadFormat, SandboxFileReadOptions, SandboxFileWriteData, SandboxFileWriteEntry, SandboxFileTextWriteOptions, SandboxFileBytesWriteOptions, SandboxFileMakeDirOptions, SandboxFileCopyParams, SandboxFileChmodParams, SandboxFileChownParams, SandboxFileTransferResult, SandboxFileSystemEventType, SandboxFileSystemEvent, SandboxWatchDirOptions, SandboxPresignFileParams, SandboxPresignedUrl, SandboxTerminalCreateParams, SandboxTerminalOutputChunk, SandboxTerminalStatus, SandboxTerminalWaitParams, SandboxTerminalKillParams, SandboxTerminalEvent, } from "./sandbox";
 export { CreateVolumeParams, Volume, VolumeListResponse } from "./volume";
 export { CreateProfileParams, ProfileResponse, CreateProfileResponse, ProfileListParams, ProfileListResponse, } from "./profile";

package/dist/types/session.d.ts

@@ -21,6 +21,7 @@ export interface SessionLaunchState {
     enableVideoWebRecording?: boolean;
     enableLogCapture?: boolean;
     acceptCookies?: boolean;
+    solverType?: CaptchaSolverType;
     profile?: SessionProfile;
     staticIpId?: string;
     saveDownloads?: boolean;
@@ -85,6 +86,39 @@ export interface ImageCaptchaParam {
     imageSelector: string;
     inputSelector: string;
 }
+export type CaptchaSolverType = "visual" | (string & {});
+export type CaptchaEvaluationType = "turnstile" | "cloudflare-challenge" | "aliexpress" | "recaptcha" | "recaptcha-visual" | "amazon";
+export type CaptchaEvaluationTarget = CaptchaEvaluationType;
+export interface CaptchaEvaluationParams {
+    captcha?: CaptchaEvaluationTarget;
+    captchaType?: CaptchaEvaluationTarget;
+    text?: CaptchaEvaluationTarget;
+    iterations?: number;
+    maxIterations?: number;
+    solverType?: CaptchaSolverType;
+    imageCaptchaParams?: Array<ImageCaptchaParam>;
+    useGeminiCaptchaSolver?: boolean;
+    useUltraStealth?: boolean;
+}
+export interface CaptchaEvaluationPageResult {
+    url: string;
+    targetId: string | null;
+    iterationsRun: number;
+    solved: boolean;
+    solvedCaptchas: CaptchaEvaluationType[];
+    checkedCaptchas: CaptchaEvaluationType[];
+    captchaSolvedCounts: Record<string, number>;
+    lastSolveTime: Record<string, number>;
+}
+export interface CaptchaEvaluationResponse {
+    success: true;
+    captcha: CaptchaEvaluationType | null;
+    iterationsRequested: number;
+    iterationsRun: number;
+    solved: boolean;
+    solvedCaptchas: CaptchaEvaluationType[];
+    pages: CaptchaEvaluationPageResult[];
+}
 export interface CreateSessionParams {
     useUltraStealth?: boolean;
     useStealth?: boolean;
@@ -101,6 +135,7 @@ export interface CreateSessionParams {
     locales?: ISO639_1[];
     screen?: ScreenConfig;
     solveCaptchas?: boolean;
+    solverType?: CaptchaSolverType;
     adblock?: boolean;
     trackers?: boolean;
     annoyances?: boolean;
@@ -206,3 +241,11 @@ export interface UpdateSessionScreenParams {
     width: number;
     height: number;
 }
+export interface UpdateSessionSolveCaptchasParams {
+    solverType?: CaptchaSolverType;
+}
+export interface UpdateSessionSolveCaptchasResponse extends BasicResponse {
+    solveCaptchas?: boolean;
+    sessionId?: string;
+    telemetryReady?: boolean;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperbrowser/sdk",
-  "version": "0.89.8",
+  "version": "0.90.0",
   "description": "Node SDK for Hyperbrowser API",
   "author": "",
   "repository": {
@@ -21,6 +21,7 @@
     "prepare": "yarn build",
     "test": "vitest run",
     "test:e2e": "vitest run tests/sandbox/e2e",
+    "test:integration": "vitest run tests/integration",
     "test:watch": "vitest",
     "format": "prettier --write 'src/**/*.ts'"
   },