@hyperbrowser/sdk 0.81.1 → 0.82.0

package/dist/client.d.ts

@@ -12,6 +12,7 @@ import { HyperAgentService } from "./services/agents/hyper-agent";
 import { TeamService } from "./services/team";
 import { ComputerActionService } from "./services/computer-action";
 import { GeminiComputerUseService } from "./services/agents/gemini-computer-use";
+import { WebService } from "./services/web";
 export declare class HyperbrowserError extends Error {
     statusCode?: number | undefined;
     constructor(message: string, statusCode?: number | undefined);
@@ -23,6 +24,7 @@ export declare class HyperbrowserClient {
     readonly extract: ExtractService;
     readonly profiles: ProfilesService;
     readonly extensions: ExtensionService;
+    readonly web: WebService;
     readonly agents: {
         browserUse: BrowserUseService;
         claudeComputerUse: ClaudeComputerUseService;

package/dist/client.js

@@ -14,6 +14,7 @@ const hyper_agent_1 = require("./services/agents/hyper-agent");
 const team_1 = require("./services/team");
 const computer_action_1 = require("./services/computer-action");
 const gemini_computer_use_1 = require("./services/agents/gemini-computer-use");
+const web_1 = require("./services/web");
 class HyperbrowserError extends Error {
     constructor(message, statusCode) {
         super(`[Hyperbrowser]: ${message}`);
@@ -36,6 +37,7 @@ class HyperbrowserClient {
         this.extract = new extract_1.ExtractService(apiKey, baseUrl, timeout);
         this.profiles = new profiles_1.ProfilesService(apiKey, baseUrl, timeout);
         this.extensions = new extensions_1.ExtensionService(apiKey, baseUrl, timeout);
+        this.web = new web_1.WebService(apiKey, baseUrl, timeout);
         this.team = new team_1.TeamService(apiKey, baseUrl, timeout);
         this.computerAction = new computer_action_1.ComputerActionService(apiKey, baseUrl, timeout);
         this.agents = {

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 } from "../types/session";
+import { BasicResponse, CreateSessionParams, GetActiveSessionsCountResponse, GetSessionDownloadsUrlResponse, GetSessionRecordingUrlResponse, GetSessionVideoRecordingUrlResponse, SessionDetail, SessionListParams, SessionListResponse, SessionRecording, UploadFileOptions, UploadFileResponse, SessionEventLogListParams, SessionEventLogListResponse, UpdateSessionProfileParams, SessionGetParams } from "../types/session";
 import { BaseService } from "./base";
 /**
  * Service for managing session event logs
@@ -23,7 +23,7 @@ export declare class SessionsService extends BaseService {
      * Get details of an existing session
      * @param id The ID of the session to get
      */
-    get(id: string): Promise<SessionDetail>;
+    get(id: string, params?: SessionGetParams): Promise<SessionDetail>;
     /**
      * Stop a running session
      * @param id The ID of the session to stop

package/dist/services/sessions.js

@@ -83,9 +83,11 @@ class SessionsService extends base_1.BaseService {
      * Get details of an existing session
      * @param id The ID of the session to get
      */
-    async get(id) {
+    async get(id, params = {}) {
         try {
-            return await this.request(`/session/${id}`);
+            return await this.request(`/session/${id}`, undefined, {
+                liveViewTtlSeconds: params.liveViewTtlSeconds,
+            });
         }
         catch (error) {
             if (error instanceof client_1.HyperbrowserError) {

package/dist/services/web/index.d.ts

@@ -0,0 +1,15 @@
+import { BaseService } from "../base";
+import { FetchParams, FetchResponse } from "../../types/web/fetch";
+import { WebSearchParams, WebSearchResponse } from "../../types/web/search";
+export declare class WebService extends BaseService {
+    /**
+     * Fetch a URL and extract content
+     * @param params The parameters for the fetch request
+     */
+    fetch(params: FetchParams): Promise<FetchResponse>;
+    /**
+     * Search the web
+     * @param params The parameters for the search request
+     */
+    search(params: WebSearchParams): Promise<WebSearchResponse>;
+}

package/dist/services/web/index.js

@@ -0,0 +1,68 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebService = void 0;
+const zod_1 = require("zod");
+const zod_to_json_schema_1 = __importDefault(require("zod-to-json-schema"));
+const base_1 = require("../base");
+const client_1 = require("../../client");
+const utils_1 = require("../../utils");
+class WebService extends base_1.BaseService {
+    /**
+     * Fetch a URL and extract content
+     * @param params The parameters for the fetch request
+     */
+    async fetch(params) {
+        try {
+            // Handle JSON schema serialization if needed (similar to Python SDK)
+            if (params.outputs?.formats) {
+                for (const output of params.outputs.formats) {
+                    if (typeof output === "object" && "type" in output && output.type === "json") {
+                        const jsonOutput = output;
+                        if (jsonOutput.schema) {
+                            if ((0, utils_1.isZodSchema)(jsonOutput.schema)) {
+                                try {
+                                    output.schema = (0, zod_1.toJSONSchema)(jsonOutput.schema);
+                                }
+                                catch {
+                                    output.schema = (0, zod_to_json_schema_1.default)(jsonOutput.schema);
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+            return await this.request("/web/fetch", {
+                method: "POST",
+                body: JSON.stringify(params),
+            });
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError("Failed to fetch URL", undefined);
+        }
+    }
+    /**
+     * Search the web
+     * @param params The parameters for the search request
+     */
+    async search(params) {
+        try {
+            return await this.request("/web/search", {
+                method: "POST",
+                body: JSON.stringify(params),
+            });
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError("Failed to search web", undefined);
+        }
+    }
+}
+exports.WebService = WebService;

package/dist/types/index.d.ts

@@ -7,9 +7,12 @@ 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, SessionListParams, SessionListResponse, ScreenConfig, CreateSessionParams, GetSessionDownloadsUrlResponse, GetSessionVideoRecordingUrlResponse, GetSessionRecordingUrlResponse, ImageCaptchaParam, UploadFileResponse, UploadFileOptions, GetActiveSessionsCountResponse, SessionEventLogListParams, SessionEventLogListResponse, SessionEventLog, SessionProfile, SessionLaunchState, UpdateSessionProfileParams, } from "./session";
+export { BasicResponse, SessionStatus, Session, SessionDetail, SessionGetParams, SessionListParams, SessionListResponse, ScreenConfig, CreateSessionParams, GetSessionDownloadsUrlResponse, GetSessionVideoRecordingUrlResponse, GetSessionRecordingUrlResponse, ImageCaptchaParam, UploadFileResponse, UploadFileOptions, GetActiveSessionsCountResponse, SessionEventLogListParams, SessionEventLogListResponse, SessionEventLog, SessionProfile, SessionLaunchState, UpdateSessionProfileParams, } from "./session";
 export { CreateProfileParams, ProfileResponse, CreateProfileResponse, ProfileListParams, ProfileListResponse, } from "./profile";
 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, BrowserUseVersion, HyperAgentVersion, } from "./constants";
 export { TeamCreditInfo } from "./team";
 export { ComputerAction, Coordinate, ClickActionParams, DragActionParams, PressKeysActionParams, MoveMouseActionParams, ScreenshotActionParams, ScrollActionParams, TypeTextActionParams, ComputerActionParams, ComputerActionResponse, ComputerActionMouseButton, ComputerActionResponseData, HoldKeyActionParams, MouseDownActionParams, MouseUpActionParams, GetClipboardTextActionParams, PutSelectionTextActionParams, ComputerActionResponseDataClipboardText, } from "./computer-action";
+export { FetchParams, FetchResponse, FetchResponseData, FetchStatus } from "./web/fetch";
+export { WebSearchParams, WebSearchResponse, WebSearchResponseData, WebSearchResultItem, WebSearchFilters, WebSearchLocation, WebSearchFiletype, WebSearchStatus, } from "./web/search";
+export { FetchStealthMode, FetchSanitizeMode, FetchWaitUntil, FetchScreenshotFormat, PageStatus, FetchOutputScreenshotOptions, FetchStorageStateOptions, FetchBrowserLocationOptions, PageData, FetchOutputMarkdown, FetchOutputHtml, FetchOutputLinks, FetchOutputScreenshot, FetchOutputJsonOptions, FetchOutputJson, FetchOutputFormat, FetchOutputOptions, FetchBrowserOptions, FetchNavigationOptions, FetchCacheOptions, } from "./web/common";

package/dist/types/session.d.ts

@@ -50,6 +50,9 @@ export interface SessionDetail extends Session {
     liveUrl?: string;
     token: string;
 }
+export interface SessionGetParams {
+    liveViewTtlSeconds?: number;
+}
 export interface SessionListParams {
     status?: SessionStatus;
     page?: number;
@@ -114,6 +117,7 @@ export interface CreateSessionParams {
     enableAlwaysOpenPdfExternally?: boolean;
     appendTimestampToDownloads?: boolean;
     showScrollbars?: boolean;
+    liveViewTtlSeconds?: number;
     replaceNativeElements?: boolean;
 }
 export interface SessionRecording {

package/dist/types/web/common.d.ts

@@ -0,0 +1,74 @@
+import { Country, State } from "../constants";
+import { ScreenConfig } from "../session";
+export type FetchStealthMode = "none" | "auto" | "ultra";
+export type FetchSanitizeMode = "none" | "basic" | "advanced";
+export type FetchWaitUntil = "load" | "domcontentloaded" | "networkidle";
+export type FetchScreenshotFormat = "jpeg" | "png" | "webp";
+export type PageStatus = "completed" | "failed" | "pending" | "running";
+export interface FetchOutputScreenshotOptions {
+    fullPage?: boolean;
+    format?: FetchScreenshotFormat;
+    cropToContent?: boolean;
+    cropToContentMaxHeight?: number;
+    cropToContentMinHeight?: number;
+}
+export interface FetchStorageStateOptions {
+    localStorage?: Record<string, string>;
+    sessionStorage?: Record<string, string>;
+}
+export interface FetchBrowserLocationOptions {
+    country?: Country;
+    state?: State;
+    city?: string;
+}
+export interface PageData {
+    url: string;
+    status: PageStatus;
+    error?: string;
+    metadata?: Record<string, string | string[]>;
+    markdown?: string;
+    html?: string;
+    links?: string[];
+    screenshot?: string;
+    json?: Record<string, any>;
+}
+export interface FetchOutputMarkdown {
+    type: "markdown";
+}
+export interface FetchOutputHtml {
+    type: "html";
+}
+export interface FetchOutputLinks {
+    type: "links";
+}
+export interface FetchOutputScreenshot extends FetchOutputScreenshotOptions {
+    type: "screenshot";
+}
+export interface FetchOutputJsonOptions {
+    schema?: any;
+}
+export interface FetchOutputJson extends FetchOutputJsonOptions {
+    type: "json";
+}
+export type FetchOutputFormat = FetchOutputMarkdown | FetchOutputHtml | FetchOutputLinks | FetchOutputScreenshot | FetchOutputJson | "markdown" | "html" | "links" | "screenshot";
+export interface FetchOutputOptions {
+    formats?: FetchOutputFormat[];
+    sanitize?: FetchSanitizeMode;
+    includeSelectors?: string[];
+    excludeSelectors?: string[];
+    storageState?: FetchStorageStateOptions;
+}
+export interface FetchBrowserOptions {
+    screen?: ScreenConfig;
+    profileId?: string;
+    solveCaptchas?: string;
+    location?: FetchBrowserLocationOptions;
+}
+export interface FetchNavigationOptions {
+    waitUntil?: FetchWaitUntil;
+    timeoutMs?: number;
+    waitFor?: number;
+}
+export interface FetchCacheOptions {
+    maxAgeSeconds?: number;
+}

package/dist/types/web/common.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/web/fetch.d.ts

@@ -0,0 +1,24 @@
+import { FetchStealthMode, FetchOutputOptions, FetchBrowserOptions, FetchNavigationOptions, FetchCacheOptions } from "./common";
+export type FetchStatus = "completed" | "failed" | "pending" | "running";
+export interface FetchParams {
+    url: string;
+    stealth?: FetchStealthMode;
+    outputs?: FetchOutputOptions;
+    browser?: FetchBrowserOptions;
+    navigation?: FetchNavigationOptions;
+    cache?: FetchCacheOptions;
+}
+export interface FetchResponseData {
+    metadata?: Record<string, string | string[]>;
+    html?: string;
+    markdown?: string;
+    links?: string[];
+    screenshot?: string;
+    json?: Record<string, any>;
+}
+export interface FetchResponse {
+    jobId: string;
+    status: FetchStatus;
+    error?: string;
+    data?: FetchResponseData;
+}

package/dist/types/web/fetch.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/web/search.d.ts

@@ -0,0 +1,41 @@
+import { Country, State } from "../constants";
+export type WebSearchFiletype = "pdf" | "doc" | "docx" | "xls" | "xlsx" | "ppt" | "pptx" | "html";
+export type WebSearchStatus = "completed" | "failed" | "pending" | "running";
+export interface WebSearchFilters {
+    exactPhrase?: boolean;
+    semanticPhrase?: boolean;
+    excludeTerms?: string[];
+    boostTerms?: string[];
+    filetype?: WebSearchFiletype;
+    site?: string;
+    excludeSite?: string;
+    intitle?: string;
+    inurl?: string;
+}
+export interface WebSearchLocation {
+    country?: Country;
+    state?: State;
+    city?: string;
+}
+export interface WebSearchParams {
+    query: string;
+    page?: number;
+    maxAgeSeconds?: number;
+    location?: WebSearchLocation;
+    filters?: WebSearchFilters;
+}
+export interface WebSearchResultItem {
+    title: string;
+    url: string;
+    description: string;
+}
+export interface WebSearchResponseData {
+    query: string;
+    results: WebSearchResultItem[];
+}
+export interface WebSearchResponse {
+    jobId: string;
+    status: WebSearchStatus;
+    error?: string;
+    data?: WebSearchResponseData;
+}

package/dist/types/web/search.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

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