@hyperbrowser/sdk 0.68.0 → 0.69.0

package/dist/services/computer-action.d.ts

@@ -1,13 +1,17 @@
 import { SessionDetail } from "../types";
-import { ComputerActionResponse, Coordinate } from "../types/computer-action";
+import { ComputerActionResponse, Coordinate, ComputerActionMouseButton } from "../types/computer-action";
 import { BaseService } from "./base";
 export declare class ComputerActionService extends BaseService {
     private executeRequest;
-    click(session: SessionDetail | string, x: number, y: number, button?: "left" | "right" | "middle" | "back" | "forward" | "wheel", numClicks?: number, returnScreenshot?: boolean): Promise<ComputerActionResponse>;
+    click(session: SessionDetail | string, x: number, y: number, button?: ComputerActionMouseButton, numClicks?: number, returnScreenshot?: boolean): Promise<ComputerActionResponse>;
     typeText(session: SessionDetail | string, text: string, returnScreenshot?: boolean): Promise<ComputerActionResponse>;
     screenshot(session: SessionDetail | string): Promise<ComputerActionResponse>;
     pressKeys(session: SessionDetail | string, keys: string[], returnScreenshot?: boolean): Promise<ComputerActionResponse>;
     drag(session: SessionDetail | string, path: Coordinate[], returnScreenshot?: boolean): Promise<ComputerActionResponse>;
     moveMouse(session: SessionDetail | string, x: number, y: number, returnScreenshot?: boolean): Promise<ComputerActionResponse>;
     scroll(session: SessionDetail | string, x: number, y: number, scrollX: number, scrollY: number, returnScreenshot?: boolean): Promise<ComputerActionResponse>;
+    holdKey(session: SessionDetail | string, key: string, duration: number, returnScreenshot?: boolean): Promise<ComputerActionResponse>;
+    mouseDown(session: SessionDetail | string, button?: ComputerActionMouseButton, returnScreenshot?: boolean): Promise<ComputerActionResponse>;
+    mouseUp(session: SessionDetail | string, button?: ComputerActionMouseButton, returnScreenshot?: boolean): Promise<ComputerActionResponse>;
+    getClipboardText(session: SessionDetail | string, returnScreenshot?: boolean): Promise<ComputerActionResponse>;
 }

package/dist/services/computer-action.js

@@ -83,5 +83,33 @@ class ComputerActionService extends base_1.BaseService {
             returnScreenshot,
         });
     }
+    async holdKey(session, key, duration, returnScreenshot = false) {
+        return this.executeRequest(session, {
+            action: computer_action_1.ComputerAction.HOLD_KEY,
+            key,
+            duration,
+            returnScreenshot,
+        });
+    }
+    async mouseDown(session, button = "left", returnScreenshot = false) {
+        return this.executeRequest(session, {
+            action: computer_action_1.ComputerAction.MOUSE_DOWN,
+            button,
+            returnScreenshot,
+        });
+    }
+    async mouseUp(session, button = "left", returnScreenshot = false) {
+        return this.executeRequest(session, {
+            action: computer_action_1.ComputerAction.MOUSE_UP,
+            button,
+            returnScreenshot,
+        });
+    }
+    async getClipboardText(session, returnScreenshot = false) {
+        return this.executeRequest(session, {
+            action: computer_action_1.ComputerAction.GET_CLIPBOARD_TEXT,
+            returnScreenshot,
+        });
+    }
 }
 exports.ComputerActionService = ComputerActionService;

package/dist/types/computer-action.d.ts

@@ -4,12 +4,17 @@
 export declare enum ComputerAction {
     CLICK = "click",
     DRAG = "drag",
+    HOLD_KEY = "hold_key",
+    MOUSE_DOWN = "mouse_down",
+    MOUSE_UP = "mouse_up",
     PRESS_KEYS = "press_keys",
     MOVE_MOUSE = "move_mouse",
     SCREENSHOT = "screenshot",
     SCROLL = "scroll",
-    TYPE_TEXT = "type_text"
+    TYPE_TEXT = "type_text",
+    GET_CLIPBOARD_TEXT = "get_clipboard_text"
 }
+export type ComputerActionMouseButton = "left" | "right" | "middle" | "back" | "forward" | "wheel";
 /**
  * Coordinate model for drag actions
  */
@@ -22,9 +27,9 @@ export interface Coordinate {
  */
 export interface ClickActionParams {
     action: ComputerAction.CLICK;
-    x: number;
-    y: number;
-    button?: "left" | "right" | "middle" | "back" | "forward" | "wheel";
+    x?: number;
+    y?: number;
+    button?: ComputerActionMouseButton;
     numClicks?: number;
     returnScreenshot?: boolean;
 }
@@ -78,16 +83,50 @@ export interface TypeTextActionParams {
     text: string;
     returnScreenshot?: boolean;
 }
+/**
+ * Parameters for hold key action
+ */
+export interface HoldKeyActionParams {
+    action: ComputerAction.HOLD_KEY;
+    key: string;
+    duration: number;
+    returnScreenshot?: boolean;
+}
+/**
+ * Parameters for mouse down action
+ */
+export interface MouseDownActionParams {
+    action: ComputerAction.MOUSE_DOWN;
+    button?: ComputerActionMouseButton;
+    returnScreenshot?: boolean;
+}
+/**
+ * Parameters for mouse up action
+ */
+export interface MouseUpActionParams {
+    action: ComputerAction.MOUSE_UP;
+    button?: ComputerActionMouseButton;
+    returnScreenshot?: boolean;
+}
+export interface GetClipboardTextActionParams {
+    action: ComputerAction.GET_CLIPBOARD_TEXT;
+    returnScreenshot?: boolean;
+}
 /**
  * Union type for all computer action parameters
  */
-export type ComputerActionParams = ClickActionParams | DragActionParams | PressKeysActionParams | MoveMouseActionParams | ScreenshotActionParams | ScrollActionParams | TypeTextActionParams;
+export type ComputerActionParams = ClickActionParams | DragActionParams | PressKeysActionParams | MoveMouseActionParams | ScreenshotActionParams | ScrollActionParams | TypeTextActionParams | HoldKeyActionParams | MouseDownActionParams | MouseUpActionParams | GetClipboardTextActionParams;
+export interface ComputerActionResponseDataClipboardText {
+    clipboardText?: string;
+}
+export type ComputerActionResponseData = ComputerActionResponseDataClipboardText;
 /**
  * Response from computer action API
  */
 export interface ComputerActionResponse {
     success: boolean;
     screenshot?: string;
+    data?: ComputerActionResponseData;
     error?: string;
     message?: string;
 }

package/dist/types/computer-action.js

@@ -8,9 +8,13 @@ var ComputerAction;
 (function (ComputerAction) {
     ComputerAction["CLICK"] = "click";
     ComputerAction["DRAG"] = "drag";
+    ComputerAction["HOLD_KEY"] = "hold_key";
+    ComputerAction["MOUSE_DOWN"] = "mouse_down";
+    ComputerAction["MOUSE_UP"] = "mouse_up";
     ComputerAction["PRESS_KEYS"] = "press_keys";
     ComputerAction["MOVE_MOUSE"] = "move_mouse";
     ComputerAction["SCREENSHOT"] = "screenshot";
     ComputerAction["SCROLL"] = "scroll";
     ComputerAction["TYPE_TEXT"] = "type_text";
+    ComputerAction["GET_CLIPBOARD_TEXT"] = "get_clipboard_text";
 })(ComputerAction || (exports.ComputerAction = ComputerAction = {}));

package/dist/types/index.d.ts

@@ -12,4 +12,4 @@ export { CreateProfileParams, ProfileResponse, CreateProfileResponse, ProfileLis
 export { CreateExtensionParams, CreateExtensionResponse, ListExtensionsResponse, } from "./extension";
 export { ExtractJobStatus, BrowserUseTaskStatus, BrowserUseLlm, ClaudeComputerUseLlm, GeminiComputerUseLlm, ScrapeScreenshotFormat, ScrapeJobStatus, CrawlJobStatus, Country, State, ISO639_1, OperatingSystem, Platform, ScrapeFormat, ScrapeWaitUntil, ScrapePageStatus, CrawlPageStatus, RecordingStatus, DownloadsStatus, HyperAgentLlm, HyperAgentTaskStatus, ClaudeComputerUseTaskStatus, CuaTaskStatus, GeminiComputerUseTaskStatus, SessionEventLogType, SessionRegion, } from "./constants";
 export { TeamCreditInfo } from "./team";
-export { ComputerAction, Coordinate, ClickActionParams, DragActionParams, PressKeysActionParams, MoveMouseActionParams, ScreenshotActionParams, ScrollActionParams, TypeTextActionParams, ComputerActionParams, ComputerActionResponse, } from "./computer-action";
+export { ComputerAction, Coordinate, ClickActionParams, DragActionParams, PressKeysActionParams, MoveMouseActionParams, ScreenshotActionParams, ScrollActionParams, TypeTextActionParams, ComputerActionParams, ComputerActionResponse, ComputerActionMouseButton, ComputerActionResponseData, HoldKeyActionParams, MouseDownActionParams, MouseUpActionParams, GetClipboardTextActionParams, ComputerActionResponseDataClipboardText, } from "./computer-action";

package/package.json

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