@mearl/client 2.5.1 → 2.6.0

package/dist/index.d.ts

@@ -1,50 +1,51 @@
 /**
- * @mearl/client — Mearl Socket Client SDK
+ * @mearl/client — unified Mearl browser client
  *
- * 通过 Unix Domain Socket 与 Chrome Extension 的 native host 通信，
- * 提供类型安全的具名方法和通用的 invoke 底层方法。
+ * Discovers browser targets on this machine and every configured cloud connector,
+ * then routes actions using the global browser ids returned by browser_list.
  */
-export { invoke } from './socket.js';
-export type { InvokeOptions } from './socket.js';
+export { UnifiedClient, UnifiedClient as MearlClient, decodeBrowserTarget, invoke, listCloudConnectors, } from './unified.js';
+export type { UnifiedClientOptions, UnifiedInvokeOptions, UnifiedInvokeOptions as InvokeOptions, } from './unified.js';
 export { BROWSER_ACTIONS, BROWSER_COMMAND_ACTIONS, EXTENSION_BROWSER_ACTIONS, PAGE_ACT_ACTIONS, SEND_REQUEST_MAX_FILES, SEND_REQUEST_MAX_TOTAL_BASE64_FILE_BYTES, SEND_REQUEST_MAX_TOTAL_FILE_BYTES, isBrowserAction, isBrowserCommandAction, isExtensionBrowserAction, } from './generated-browser-action-protocol.js';
-export type { ActionStep, BrowserAction, BrowserActionMap, BrowserActionRequest, BrowserActionResponse, BrowserCloseParams, BrowserCommandAction, BrowserInfo, BrowserInfoBase, BrowserLaunchParams, BrowserListResult, BrowserReleaseFailure, BrowserReleaseResult, BrowserStatus, CaptureCheckpointParams, CaptureCheckpointResult, BrowserDevicePresetName, BrowserEmulationOptions, ExtensionBrowserAction, GetApiSchemaParams, GetCookieParams, GetCookieResult, GetEventsParams, GetLogsParams, GetMocksParams, GetRequestsParams, GetUserInfoParams, ManagedBrowserAccount, ManagedBrowserInfo, PageClickParams, PageActAction, PageDiagnosticsOptions, PageDiagnosticsSetting, PageEvalParams, PageFramesParams, PageHoverParams, PageNavigateParams, PageObservationWaitOptions, PagePressParams, PageScreenshotParams, PageScrollParams, PageSelectedElementParams, PageSnapshotParams, PageSnapshotQuery, PageTypeParams, PageUploadParams, PageWaitParams, RecordParams, RegularBrowserInfo, RequestDomainPermissionParams, RulesResult, RunActionName, RunActionsParams, SelectBrowserParams, SelectBrowserResult, SendRequestFile, SendRequestFormValue, SendMtopRequestParams, SendRequestParams, SetCookieParams, SetCookieResult, SetDeviceEmulationParams, SetMockParams, SetRuleParams, SetTimezoneParams, SetTimezoneResult, TabCloseParams, TabOpenParams, TdbankAccountParams, } from './generated-browser-action-protocol.js';
+export type { ActionStep, BrowserAction, BrowserActionMap, BrowserActionRequest, BrowserActionResponse, BrowserCloseParams, BrowserCommandAction, BrowserInfo, BrowserInfoBase, BrowserLaunchParams, BrowserListResult, BrowserReleaseFailure, BrowserReleaseResult, BrowserSource, BrowserStatus, CaptureCheckpointParams, CaptureCheckpointResult, BrowserDevicePresetName, BrowserEmulationOptions, ExtensionBrowserAction, GetApiSchemaParams, GetCookieParams, GetCookieResult, GetEventsParams, GetLogsParams, GetMocksParams, GetRequestsParams, GetUserInfoParams, ManagedBrowserAccount, ManagedBrowserInfo, PageClickParams, PageActAction, PageDiagnosticsOptions, PageDiagnosticsSetting, PageEvalParams, PageFramesParams, PageHoverParams, PageNavigateParams, PageObservationWaitOptions, PagePressParams, PageScreenshotParams, PageScrollParams, PageSelectedElementParams, PageSnapshotParams, PageSnapshotQuery, PageTypeParams, PageUploadParams, PageWaitParams, RecordParams, RegularBrowserInfo, RequestDomainPermissionParams, RulesResult, RunActionName, RunActionsParams, SelectBrowserParams, SelectBrowserResult, SendRequestFile, SendRequestFormValue, SendMtopRequestParams, SendRequestParams, SetCookieParams, SetCookieResult, SetDeviceEmulationParams, SetMockParams, SetRuleParams, SetTimezoneParams, SetTimezoneResult, TabCloseParams, TabOpenParams, TdbankAccountParams, } from './generated-browser-action-protocol.js';
+import { type UnifiedInvokeOptions } from './unified.js';
 import type * as Protocol from './generated-browser-action-protocol.js';
-export declare function captureCheckpoint(params?: Protocol.CaptureCheckpointParams): Promise<Protocol.BrowserActionResponse<'capture_checkpoint'>>;
-export declare function getRequests(params?: Protocol.GetRequestsParams): Promise<Protocol.BrowserActionResponse<'get_requests'>>;
-export declare function getLogs(params?: Protocol.GetLogsParams): Promise<Protocol.BrowserActionResponse<'get_logs'>>;
-export declare function getEvents(params?: Protocol.GetEventsParams): Promise<Protocol.BrowserActionResponse<'get_events'>>;
-export declare function setMock(params: Protocol.SetMockParams): Promise<Protocol.BrowserActionResponse<'set_mock'>>;
-export declare function getMocks(params?: Protocol.GetMocksParams): Promise<Protocol.BrowserActionResponse<'get_mocks'>>;
-export declare function getApiSchema(params: Protocol.GetApiSchemaParams): Promise<Protocol.BrowserActionResponse<'get_api_schema'>>;
-export declare function sendRequest(params: Protocol.SendRequestParams): Promise<Protocol.BrowserActionResponse<'send_request'>>;
-export declare function sendMtopRequest(params: Protocol.SendMtopRequestParams): Promise<Protocol.BrowserActionResponse<'send_mtop_request'>>;
-export declare function tdbankAccount(params?: Protocol.TdbankAccountParams): Promise<Protocol.BrowserActionResponse<'tdbank_account'>>;
-export declare function browserList(): Promise<Protocol.BrowserActionResponse<'browser_list'>>;
-export declare function selectBrowser(params?: Protocol.SelectBrowserParams): Promise<Protocol.BrowserActionResponse<'browser_select_browser'>>;
-export declare function browserRelease(): Promise<Protocol.BrowserActionResponse<'browser_release'>>;
-export declare function browserLaunch(params: Protocol.BrowserLaunchParams): Promise<Protocol.BrowserActionResponse<'browser_launch'>>;
-export declare function browserClose(params: Protocol.BrowserCloseParams): Promise<Protocol.BrowserActionResponse<'browser_close'>>;
-export declare function setRule(params: Protocol.SetRuleParams): Promise<Protocol.BrowserActionResponse<'set_rule'>>;
-export declare function getRules(): Promise<Protocol.BrowserActionResponse<'get_rules'>>;
-export declare function pageScreenshot(params: Protocol.PageScreenshotParams): Promise<Protocol.BrowserActionResponse<'page_screenshot'>>;
-export declare function pageSelectedElement(params: Protocol.PageSelectedElementParams): Promise<Protocol.BrowserActionResponse<'page_selected_element'>>;
-export declare function tabOpen(params: Protocol.TabOpenParams): Promise<Protocol.BrowserActionResponse<'tab_open'>>;
-export declare function tabClose(params: Protocol.TabCloseParams): Promise<Protocol.BrowserActionResponse<'tab_close'>>;
-export declare function tabList(): Promise<Protocol.BrowserActionResponse<'tab_list'>>;
-export declare function pageClick(params: Protocol.PageClickParams): Promise<Protocol.BrowserActionResponse<'page_click'>>;
-export declare function pageType(params: Protocol.PageTypeParams): Promise<Protocol.BrowserActionResponse<'page_type'>>;
-export declare function pageScroll(params: Protocol.PageScrollParams): Promise<Protocol.BrowserActionResponse<'page_scroll'>>;
-export declare function pageHover(params: Protocol.PageHoverParams): Promise<Protocol.BrowserActionResponse<'page_hover'>>;
-export declare function pageEval(params: Protocol.PageEvalParams): Promise<Protocol.BrowserActionResponse<'page_eval'>>;
-export declare function pageSnapshot(params: Protocol.PageSnapshotParams): Promise<Protocol.BrowserActionResponse<'page_snapshot'>>;
-export declare function pagePress(params: Protocol.PagePressParams): Promise<Protocol.BrowserActionResponse<'page_press'>>;
-export declare function pageWait(params: Protocol.PageWaitParams): Promise<Protocol.BrowserActionResponse<'page_wait'>>;
-export declare function pageNavigate(params: Protocol.PageNavigateParams): Promise<Protocol.BrowserActionResponse<'page_navigate'>>;
-export declare function pageUpload(params: Protocol.PageUploadParams): Promise<Protocol.BrowserActionResponse<'page_upload'>>;
-export declare function pageFrames(params: Protocol.PageFramesParams): Promise<Protocol.BrowserActionResponse<'page_frames'>>;
-export declare function setDeviceEmulation(params: Protocol.SetDeviceEmulationParams): Promise<Protocol.BrowserActionResponse<'set_device_emulation'>>;
-export declare function setTimezone(params: Protocol.SetTimezoneParams): Promise<Protocol.BrowserActionResponse<'set_timezone'>>;
-export declare function getCookie(params: Protocol.GetCookieParams): Promise<Protocol.BrowserActionResponse<'get_cookie'>>;
-export declare function setCookie(params: Protocol.SetCookieParams): Promise<Protocol.BrowserActionResponse<'set_cookie'>>;
-export declare function getUserInfo(params?: Protocol.GetUserInfoParams): Promise<Protocol.BrowserActionResponse<'get_user_info'>>;
-export declare function runActions(params: Protocol.RunActionsParams): Promise<Protocol.BrowserActionResponse<'run_actions'>>;
+export declare function captureCheckpoint(params?: Protocol.CaptureCheckpointParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'capture_checkpoint'>>;
+export declare function getRequests(params?: Protocol.GetRequestsParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'get_requests'>>;
+export declare function getLogs(params?: Protocol.GetLogsParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'get_logs'>>;
+export declare function getEvents(params?: Protocol.GetEventsParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'get_events'>>;
+export declare function setMock(params: Protocol.SetMockParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'set_mock'>>;
+export declare function getMocks(params?: Protocol.GetMocksParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'get_mocks'>>;
+export declare function getApiSchema(params: Protocol.GetApiSchemaParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'get_api_schema'>>;
+export declare function sendRequest(params: Protocol.SendRequestParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'send_request'>>;
+export declare function sendMtopRequest(params: Protocol.SendMtopRequestParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'send_mtop_request'>>;
+export declare function tdbankAccount(params?: Protocol.TdbankAccountParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'tdbank_account'>>;
+export declare function browserList(options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'browser_list'>>;
+export declare function selectBrowser(params?: Protocol.SelectBrowserParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'browser_select_browser'>>;
+export declare function browserRelease(options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'browser_release'>>;
+export declare function browserLaunch(params: Protocol.BrowserLaunchParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'browser_launch'>>;
+export declare function browserClose(params: Protocol.BrowserCloseParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'browser_close'>>;
+export declare function setRule(params: Protocol.SetRuleParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'set_rule'>>;
+export declare function getRules(options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'get_rules'>>;
+export declare function pageScreenshot(params: Protocol.PageScreenshotParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'page_screenshot'>>;
+export declare function pageSelectedElement(params: Protocol.PageSelectedElementParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'page_selected_element'>>;
+export declare function tabOpen(params: Protocol.TabOpenParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'tab_open'>>;
+export declare function tabClose(params: Protocol.TabCloseParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'tab_close'>>;
+export declare function tabList(options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'tab_list'>>;
+export declare function pageClick(params: Protocol.PageClickParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'page_click'>>;
+export declare function pageType(params: Protocol.PageTypeParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'page_type'>>;
+export declare function pageScroll(params: Protocol.PageScrollParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'page_scroll'>>;
+export declare function pageHover(params: Protocol.PageHoverParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'page_hover'>>;
+export declare function pageEval(params: Protocol.PageEvalParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'page_eval'>>;
+export declare function pageSnapshot(params: Protocol.PageSnapshotParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'page_snapshot'>>;
+export declare function pagePress(params: Protocol.PagePressParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'page_press'>>;
+export declare function pageWait(params: Protocol.PageWaitParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'page_wait'>>;
+export declare function pageNavigate(params: Protocol.PageNavigateParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'page_navigate'>>;
+export declare function pageUpload(params: Protocol.PageUploadParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'page_upload'>>;
+export declare function pageFrames(params: Protocol.PageFramesParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'page_frames'>>;
+export declare function setDeviceEmulation(params: Protocol.SetDeviceEmulationParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'set_device_emulation'>>;
+export declare function setTimezone(params: Protocol.SetTimezoneParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'set_timezone'>>;
+export declare function getCookie(params: Protocol.GetCookieParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'get_cookie'>>;
+export declare function setCookie(params: Protocol.SetCookieParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'set_cookie'>>;
+export declare function getUserInfo(params?: Protocol.GetUserInfoParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'get_user_info'>>;
+export declare function runActions(params: Protocol.RunActionsParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'run_actions'>>;

package/dist/index.js

@@ -1,126 +1,126 @@
 /**
- * @mearl/client — Mearl Socket Client SDK
+ * @mearl/client — unified Mearl browser client
  *
- * 通过 Unix Domain Socket 与 Chrome Extension 的 native host 通信，
- * 提供类型安全的具名方法和通用的 invoke 底层方法。
+ * Discovers browser targets on this machine and every configured cloud connector,
+ * then routes actions using the global browser ids returned by browser_list.
  */
-export { invoke } from './socket.js';
+export { UnifiedClient, UnifiedClient as MearlClient, decodeBrowserTarget, invoke, listCloudConnectors, } from './unified.js';
 export { BROWSER_ACTIONS, BROWSER_COMMAND_ACTIONS, EXTENSION_BROWSER_ACTIONS, PAGE_ACT_ACTIONS, SEND_REQUEST_MAX_FILES, SEND_REQUEST_MAX_TOTAL_BASE64_FILE_BYTES, SEND_REQUEST_MAX_TOTAL_FILE_BYTES, isBrowserAction, isBrowserCommandAction, isExtensionBrowserAction, } from './generated-browser-action-protocol.js';
-import { invoke } from './socket.js';
-export function captureCheckpoint(params = {}) {
-    return invoke('capture_checkpoint', params);
+import { invoke } from './unified.js';
+export function captureCheckpoint(params = {}, options) {
+    return invoke('capture_checkpoint', params, options);
 }
-export function getRequests(params = {}) {
-    return invoke('get_requests', params);
+export function getRequests(params = {}, options) {
+    return invoke('get_requests', params, options);
 }
-export function getLogs(params = {}) {
-    return invoke('get_logs', params);
+export function getLogs(params = {}, options) {
+    return invoke('get_logs', params, options);
 }
-export function getEvents(params = {}) {
-    return invoke('get_events', params);
+export function getEvents(params = {}, options) {
+    return invoke('get_events', params, options);
 }
-export function setMock(params) {
-    return invoke('set_mock', params);
+export function setMock(params, options) {
+    return invoke('set_mock', params, options);
 }
-export function getMocks(params = {}) {
-    return invoke('get_mocks', params);
+export function getMocks(params = {}, options) {
+    return invoke('get_mocks', params, options);
 }
-export function getApiSchema(params) {
-    return invoke('get_api_schema', params);
+export function getApiSchema(params, options) {
+    return invoke('get_api_schema', params, options);
 }
-export function sendRequest(params) {
-    return invoke('send_request', params);
+export function sendRequest(params, options) {
+    return invoke('send_request', params, options);
 }
-export function sendMtopRequest(params) {
-    return invoke('send_mtop_request', params);
+export function sendMtopRequest(params, options) {
+    return invoke('send_mtop_request', params, options);
 }
-export function tdbankAccount(params = {}) {
-    return invoke('tdbank_account', params);
+export function tdbankAccount(params = {}, options) {
+    return invoke('tdbank_account', params, options);
 }
-export function browserList() {
-    return invoke('browser_list', {});
+export function browserList(options) {
+    return invoke('browser_list', {}, options);
 }
-export function selectBrowser(params = {}) {
-    return invoke('browser_select_browser', params);
+export function selectBrowser(params = {}, options) {
+    return invoke('browser_select_browser', params, options);
 }
-export function browserRelease() {
-    return invoke('browser_release', {});
+export function browserRelease(options) {
+    return invoke('browser_release', {}, options);
 }
-export function browserLaunch(params) {
-    return invoke('browser_launch', params);
+export function browserLaunch(params, options) {
+    return invoke('browser_launch', params, options);
 }
-export function browserClose(params) {
-    return invoke('browser_close', params);
+export function browserClose(params, options) {
+    return invoke('browser_close', params, options);
 }
-export function setRule(params) {
-    return invoke('set_rule', params);
+export function setRule(params, options) {
+    return invoke('set_rule', params, options);
 }
-export function getRules() {
-    return invoke('get_rules', {});
+export function getRules(options) {
+    return invoke('get_rules', {}, options);
 }
-export function pageScreenshot(params) {
-    return invoke('page_screenshot', params);
+export function pageScreenshot(params, options) {
+    return invoke('page_screenshot', params, options);
 }
-export function pageSelectedElement(params) {
-    return invoke('page_selected_element', params);
+export function pageSelectedElement(params, options) {
+    return invoke('page_selected_element', params, options);
 }
-export function tabOpen(params) {
-    return invoke('tab_open', params);
+export function tabOpen(params, options) {
+    return invoke('tab_open', params, options);
 }
-export function tabClose(params) {
-    return invoke('tab_close', params);
+export function tabClose(params, options) {
+    return invoke('tab_close', params, options);
 }
-export function tabList() {
-    return invoke('tab_list', {});
+export function tabList(options) {
+    return invoke('tab_list', {}, options);
 }
-export function pageClick(params) {
-    return invoke('page_click', params);
+export function pageClick(params, options) {
+    return invoke('page_click', params, options);
 }
-export function pageType(params) {
-    return invoke('page_type', params);
+export function pageType(params, options) {
+    return invoke('page_type', params, options);
 }
-export function pageScroll(params) {
-    return invoke('page_scroll', params);
+export function pageScroll(params, options) {
+    return invoke('page_scroll', params, options);
 }
-export function pageHover(params) {
-    return invoke('page_hover', params);
+export function pageHover(params, options) {
+    return invoke('page_hover', params, options);
 }
-export function pageEval(params) {
-    return invoke('page_eval', params);
+export function pageEval(params, options) {
+    return invoke('page_eval', params, options);
 }
-export function pageSnapshot(params) {
-    return invoke('page_snapshot', params);
+export function pageSnapshot(params, options) {
+    return invoke('page_snapshot', params, options);
 }
-export function pagePress(params) {
-    return invoke('page_press', params);
+export function pagePress(params, options) {
+    return invoke('page_press', params, options);
 }
-export function pageWait(params) {
-    return invoke('page_wait', params);
+export function pageWait(params, options) {
+    return invoke('page_wait', params, options);
 }
-export function pageNavigate(params) {
-    return invoke('page_navigate', params);
+export function pageNavigate(params, options) {
+    return invoke('page_navigate', params, options);
 }
-export function pageUpload(params) {
-    return invoke('page_upload', params);
+export function pageUpload(params, options) {
+    return invoke('page_upload', params, options);
 }
-export function pageFrames(params) {
-    return invoke('page_frames', params);
+export function pageFrames(params, options) {
+    return invoke('page_frames', params, options);
 }
-export function setDeviceEmulation(params) {
-    return invoke('set_device_emulation', params);
+export function setDeviceEmulation(params, options) {
+    return invoke('set_device_emulation', params, options);
 }
-export function setTimezone(params) {
-    return invoke('set_timezone', params);
+export function setTimezone(params, options) {
+    return invoke('set_timezone', params, options);
 }
-export function getCookie(params) {
-    return invoke('get_cookie', params);
+export function getCookie(params, options) {
+    return invoke('get_cookie', params, options);
 }
-export function setCookie(params) {
-    return invoke('set_cookie', params);
+export function setCookie(params, options) {
+    return invoke('set_cookie', params, options);
 }
-export function getUserInfo(params = {}) {
-    return invoke('get_user_info', params);
+export function getUserInfo(params = {}, options) {
+    return invoke('get_user_info', params, options);
 }
-export function runActions(params) {
-    return invoke('run_actions', params);
+export function runActions(params, options) {
+    return invoke('run_actions', params, options);
 }

package/dist/local.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Machine-local transport for infrastructure components such as cloud-connector.
+ * User-facing integrations should import from `@mearl/client` so browser routing
+ * remains consistent across local and remote sources.
+ */
+export { CLIENT_VERSION, SOCKET_PATH, decorateBrowserListResult, getDefaultBrowser, invoke, setDefaultBrowser, } from './socket.js';
+export type { InvokeOptions } from './socket.js';

package/dist/local.js

@@ -0,0 +1,6 @@
+/**
+ * Machine-local transport for infrastructure components such as cloud-connector.
+ * User-facing integrations should import from `@mearl/client` so browser routing
+ * remains consistent across local and remote sources.
+ */
+export { CLIENT_VERSION, SOCKET_PATH, decorateBrowserListResult, getDefaultBrowser, invoke, setDefaultBrowser, } from './socket.js';

package/dist/unified.d.ts

@@ -0,0 +1,64 @@
+import { type CloudConnectorListResult } from '@mearl/cloud-types';
+export interface UnifiedInvokeOptions {
+    timeoutSec?: number;
+    /** Global browser id, source-local browser id, or unique browser name. */
+    browser?: string;
+    /** Restrict the action to one remote connector. */
+    connector?: string;
+    /** Restrict the action to browsers on this machine. */
+    local?: boolean;
+    /** Force CDP on this machine. Implies local routing. */
+    transport?: 'cdp';
+}
+export interface UnifiedClientOptions {
+    serverUrl?: string;
+    connectTimeoutSec?: number;
+    requestTimeoutSec?: number;
+    heartbeatInterval?: number;
+    defaultBrowser?: string;
+    defaultConnector?: string;
+}
+interface BrowserTarget {
+    browser: string;
+    connector?: string;
+}
+export declare function decodeBrowserTarget(selector: string | undefined): BrowserTarget | undefined;
+export declare class UnifiedClient {
+    private readonly options;
+    private defaultBrowser;
+    private defaultConnector;
+    private ws;
+    private connectPromise;
+    private messageBuffer;
+    private pendingRequests;
+    private heartbeatTimer;
+    private closing;
+    constructor(options?: UnifiedClientOptions);
+    disconnect(): void;
+    invoke(action: string, data?: Record<string, any>, options?: UnifiedInvokeOptions): Promise<any>;
+    private invokeExplicitLocal;
+    private invokeLaunchWithoutControlBrowser;
+    private selectDefaultBrowser;
+    private resolveUnifiedBrowser;
+    listConnectors(timeoutSec?: number): Promise<CloudConnectorListResult>;
+    private resolveConnector;
+    private listLocalBrowsers;
+    private tryLocalBrowserList;
+    private decorateListing;
+    private applyConfiguredDefault;
+    private listConnectorBrowsers;
+    private listAllBrowsers;
+    private invokeLocal;
+    private invokeRemote;
+    private decorateActionResult;
+    private ensureConnected;
+    private connect;
+    private startHeartbeat;
+    private handleMessage;
+    private handleResponse;
+    private requestRemote;
+    private rejectAllPending;
+}
+export declare function invoke(action: string, data?: Record<string, any>, options?: UnifiedInvokeOptions): Promise<any>;
+export declare function listCloudConnectors(): Promise<CloudConnectorListResult>;
+export {};