@hyperbrowser/sdk 0.56.0 → 0.57.0

package/dist/services/base.d.ts

@@ -4,5 +4,5 @@ export declare class BaseService {
     protected readonly baseUrl: string;
     protected readonly timeout: number;
     constructor(apiKey: string, baseUrl: string, timeout?: number);
-    protected request<T>(path: string, init?: RequestInit, params?: Record<string, string | number | undefined>, fullUrl?: boolean): Promise<T>;
+    protected request<T>(path: string, init?: RequestInit, params?: Record<string, string | number | string[] | undefined>, fullUrl?: boolean): Promise<T>;
 }

package/dist/services/base.js

@@ -18,7 +18,14 @@ class BaseService {
             if (params) {
                 Object.entries(params).forEach(([key, value]) => {
                     if (value !== undefined) {
-                        url.searchParams.append(key, value.toString());
+                        if (Array.isArray(value)) {
+                            value.forEach((item) => {
+                                url.searchParams.append(key, item.toString());
+                            });
+                        }
+                        else {
+                            url.searchParams.append(key, value.toString());
+                        }
                     }
                 });
             }

package/dist/services/sessions.d.ts

@@ -1,6 +1,19 @@
-import { BasicResponse, CreateSessionParams, GetActiveSessionsCountResponse, GetSessionDownloadsUrlResponse, GetSessionRecordingUrlResponse, GetSessionVideoRecordingUrlResponse, SessionDetail, SessionListParams, SessionListResponse, SessionRecording, UploadFileOptions, UploadFileResponse } from "../types/session";
+import { BasicResponse, CreateSessionParams, GetActiveSessionsCountResponse, GetSessionDownloadsUrlResponse, GetSessionRecordingUrlResponse, GetSessionVideoRecordingUrlResponse, SessionDetail, SessionListParams, SessionListResponse, SessionRecording, UploadFileOptions, UploadFileResponse, SessionEventLogListParams, SessionEventLogListResponse } from "../types/session";
 import { BaseService } from "./base";
+/**
+ * Service for managing session event logs
+ */
+declare class SessionEventLogsService extends BaseService {
+    /**
+     * List event logs for a session
+     * @param sessionId The ID of the session
+     * @param params Optional parameters to filter the event logs
+     */
+    list(sessionId: string, params?: SessionEventLogListParams): Promise<SessionEventLogListResponse>;
+}
 export declare class SessionsService extends BaseService {
+    readonly eventLogs: SessionEventLogsService;
+    constructor(apiKey: string, baseUrl: string, timeout: number);
     /**
      * Create a new browser session
      * @param params Configuration parameters for the new session
@@ -58,3 +71,4 @@ export declare class SessionsService extends BaseService {
      */
     getActiveSessionsCount(): Promise<GetActiveSessionsCountResponse>;
 }
+export {};

package/dist/services/sessions.js

@@ -32,7 +32,35 @@ const path = __importStar(require("path"));
 const form_data_1 = __importDefault(require("form-data"));
 const base_1 = require("./base");
 const client_1 = require("../client");
+/**
+ * Service for managing session event logs
+ */
+class SessionEventLogsService extends base_1.BaseService {
+    /**
+     * List event logs for a session
+     * @param sessionId The ID of the session
+     * @param params Optional parameters to filter the event logs
+     */
+    async list(sessionId, params = {}) {
+        try {
+            return await this.request(`/session/${sessionId}/event-logs`, undefined, {
+                ...params,
+                types: params.types,
+            });
+        }
+        catch (error) {
+            if (error instanceof client_1.HyperbrowserError) {
+                throw error;
+            }
+            throw new client_1.HyperbrowserError(`Failed to list event logs for session ${sessionId}`, undefined);
+        }
+    }
+}
 class SessionsService extends base_1.BaseService {
+    constructor(apiKey, baseUrl, timeout) {
+        super(apiKey, baseUrl, timeout);
+        this.eventLogs = new SessionEventLogsService(apiKey, baseUrl, timeout);
+    }
     /**
      * Create a new browser session
      * @param params Configuration parameters for the new session

package/dist/types/constants.d.ts

@@ -1,3 +1,4 @@
+export type SessionEventLogType = "captcha_detected" | "captcha_solved" | "captcha_error";
 export type ScrapeFormat = "markdown" | "html" | "links" | "screenshot";
 export type ScrapeJobStatus = "pending" | "running" | "completed" | "failed";
 export type ExtractJobStatus = "pending" | "running" | "completed" | "failed";

package/dist/types/index.d.ts

@@ -6,9 +6,9 @@ export { StartBrowserUseTaskParams, StartBrowserUseTaskResponse, BrowserUseTaskS
 export { StartClaudeComputerUseTaskParams, StartClaudeComputerUseTaskResponse, ClaudeComputerUseTaskStatusResponse, ClaudeComputerUseTaskResponse, ClaudeComputerUseTaskData, ClaudeComputerUseStepResponse, ClaudeComputerUseApiKeys, } from "./agents/claude-computer-use";
 export { StartCuaTaskParams, StartCuaTaskResponse, CuaTaskStatusResponse, CuaTaskResponse, CuaTaskData, CuaStepResponse, CuaApiKeys, } from "./agents/cua";
 export { StartHyperAgentTaskParams, StartHyperAgentTaskResponse, HyperAgentTaskStatusResponse, HyperAgentTaskResponse, HyperAgentTaskData, HyperAgentStep, HyperAgentOutput, HyperAgentActionOutput, HyperAgentApiKeys, } from "./agents/hyper-agent";
-export { BasicResponse, SessionStatus, Session, SessionDetail, SessionListParams, SessionListResponse, ScreenConfig, CreateSessionParams, GetSessionDownloadsUrlResponse, GetSessionVideoRecordingUrlResponse, GetSessionRecordingUrlResponse, ImageCaptchaParam, UploadFileResponse, UploadFileOptions, GetActiveSessionsCountResponse, } from "./session";
+export { BasicResponse, SessionStatus, Session, SessionDetail, SessionListParams, SessionListResponse, ScreenConfig, CreateSessionParams, GetSessionDownloadsUrlResponse, GetSessionVideoRecordingUrlResponse, GetSessionRecordingUrlResponse, ImageCaptchaParam, UploadFileResponse, UploadFileOptions, GetActiveSessionsCountResponse, SessionEventLogListParams, SessionEventLogListResponse, SessionEventLog, } from "./session";
 export { CreateProfileParams, ProfileResponse, CreateProfileResponse, ProfileListParams, ProfileListResponse, } from "./profile";
 export { CreateExtensionParams, CreateExtensionResponse, ListExtensionsResponse, } from "./extension";
-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";
+export { ExtractJobStatus, BrowserUseTaskStatus, BrowserUseLlm, ClaudeComputerUseLlm, ScrapeScreenshotFormat, ScrapeJobStatus, CrawlJobStatus, Country, State, ISO639_1, OperatingSystem, Platform, ScrapeFormat, ScrapeWaitUntil, ScrapePageStatus, CrawlPageStatus, RecordingStatus, DownloadsStatus, HyperAgentLlm, HyperAgentTaskStatus, ClaudeComputerUseTaskStatus, CuaTaskStatus, SessionEventLogType, } from "./constants";
 export { TeamCreditInfo } from "./team";
 export { ComputerAction, Coordinate, ClickActionParams, DragActionParams, PressKeysActionParams, MoveMouseActionParams, ScreenshotActionParams, ScrollActionParams, TypeTextActionParams, ComputerActionParams, ComputerActionResponse, } from "./computer-action";

package/dist/types/session.d.ts

@@ -1,5 +1,5 @@
 import fs from "fs";
-import { Country, DownloadsStatus, ISO639_1, OperatingSystem, Platform, RecordingStatus, State } from "./constants";
+import { Country, DownloadsStatus, ISO639_1, OperatingSystem, Platform, RecordingStatus, SessionEventLogType, State } from "./constants";
 export type SessionStatus = "active" | "closed" | "error";
 export interface BasicResponse {
     success: boolean;
@@ -73,6 +73,7 @@ export interface CreateSessionParams {
     saveDownloads?: boolean;
     imageCaptchaParams?: Array<ImageCaptchaParam>;
     timeoutMinutes?: number;
+    enableWebglFingerprinting?: boolean;
 }
 export interface SessionRecording {
     type: number;
@@ -105,3 +106,27 @@ export interface UploadFileOptions {
 export interface GetActiveSessionsCountResponse {
     activeSessionsCount: number;
 }
+export interface SessionEventLog {
+    id: string;
+    sessionId: string;
+    targetId: string;
+    pageUrl: string;
+    teamId: string;
+    type: SessionEventLogType;
+    metadata: Record<string, unknown>;
+    timestamp: number;
+}
+export interface SessionEventLogListParams {
+    page?: number;
+    limit?: number;
+    startTimestamp?: number;
+    endTimestamp?: number;
+    targetId?: string;
+    types?: SessionEventLogType[];
+}
+export interface SessionEventLogListResponse {
+    data: SessionEventLog[];
+    totalCount: number;
+    page: number;
+    perPage: number;
+}

package/package.json

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