@mearl/client 2.0.2 → 2.2.0

package/dist/generated-browser-action-protocol.js

@@ -0,0 +1,144 @@
+// Generated by scripts/generate-client-action-protocol.mjs.
+// Do not edit directly; update browser-core/src/browserActionProtocol.ts.
+export const PAGE_ACT_ACTIONS = [
+    'page_click',
+    'page_type',
+    'page_hover',
+    'page_scroll',
+    'page_press',
+    'page_upload',
+    'page_eval',
+];
+export const BROWSER_ACTIONS = {
+    get_requests: true,
+    get_logs: true,
+    get_events: true,
+    get_api_schema: true,
+    set_mock: true,
+    get_mocks: true,
+    set_rule: true,
+    get_rules: true,
+    send_request: true,
+    send_mtop_request: true,
+    tdbank_account: true,
+    browser_list: true,
+    browser_select_browser: true,
+    browser_release: true,
+    browser_launch: true,
+    browser_close: true,
+    page_screenshot: true,
+    page_selected_element: true,
+    tab_open: true,
+    tab_close: true,
+    tab_list: true,
+    page_click: true,
+    page_type: true,
+    page_scroll: true,
+    page_hover: true,
+    page_eval: true,
+    page_snapshot: true,
+    page_press: true,
+    page_wait: true,
+    page_navigate: true,
+    page_upload: true,
+    page_frames: true,
+    set_device_emulation: true,
+    set_timezone: true,
+    get_cookie: true,
+    set_cookie: true,
+    record_start: true,
+    record_stop: true,
+    request_domain_permission: true,
+    get_user_info: true,
+    run_actions: true,
+};
+export const BROWSER_COMMAND_ACTIONS = {
+    get_requests: true,
+    get_logs: true,
+    get_events: true,
+    get_api_schema: true,
+    set_mock: true,
+    get_mocks: true,
+    set_rule: true,
+    get_rules: true,
+    send_request: true,
+    send_mtop_request: true,
+    tdbank_account: true,
+    browser_list: true,
+    browser_release: true,
+    browser_launch: true,
+    browser_close: true,
+    page_screenshot: true,
+    page_selected_element: true,
+    tab_open: true,
+    tab_close: true,
+    tab_list: true,
+    page_click: true,
+    page_type: true,
+    page_scroll: true,
+    page_hover: true,
+    page_eval: true,
+    page_snapshot: true,
+    page_press: true,
+    page_wait: true,
+    page_navigate: true,
+    page_upload: true,
+    page_frames: true,
+    set_device_emulation: true,
+    set_timezone: true,
+    get_cookie: true,
+    set_cookie: true,
+    record_start: true,
+    record_stop: true,
+    request_domain_permission: true,
+    get_user_info: true,
+    run_actions: true,
+};
+export const EXTENSION_BROWSER_ACTIONS = {
+    get_requests: true,
+    get_logs: true,
+    get_events: true,
+    get_api_schema: true,
+    set_mock: true,
+    get_mocks: true,
+    set_rule: true,
+    get_rules: true,
+    send_request: true,
+    send_mtop_request: true,
+    tdbank_account: true,
+    browser_release: true,
+    page_screenshot: true,
+    page_selected_element: true,
+    tab_open: true,
+    tab_close: true,
+    tab_list: true,
+    page_click: true,
+    page_type: true,
+    page_scroll: true,
+    page_hover: true,
+    page_eval: true,
+    page_snapshot: true,
+    page_press: true,
+    page_wait: true,
+    page_navigate: true,
+    page_upload: true,
+    page_frames: true,
+    set_device_emulation: true,
+    set_timezone: true,
+    get_cookie: true,
+    set_cookie: true,
+    record_start: true,
+    record_stop: true,
+    request_domain_permission: true,
+    get_user_info: true,
+    run_actions: true,
+};
+export function isBrowserAction(value) {
+    return typeof value === 'string' && Object.hasOwn(BROWSER_ACTIONS, value);
+}
+export function isBrowserCommandAction(value) {
+    return typeof value === 'string' && Object.hasOwn(BROWSER_COMMAND_ACTIONS, value);
+}
+export function isExtensionBrowserAction(value) {
+    return typeof value === 'string' && Object.hasOwn(EXTENSION_BROWSER_ACTIONS, value);
+}

package/dist/index.d.ts

@@ -3,431 +3,47 @@
  *
  * 通过 Unix Domain Socket 与 Chrome Extension 的 native host 通信，
  * 提供类型安全的具名方法和通用的 invoke 底层方法。
- *
- * @example
- * ```ts
- * import * as client from '@mearl/client';
- *
- * // 具名方法（类型安全）
- * const result = await client.sendRequest({ url: 'https://...', method: 'GET', withCookies: true });
- *
- * // 底层通用方法（灵活扩展）
- * const data = await client.invoke('send_request', { url: '...' });
- * ```
  */
 export { invoke } from './socket.js';
 export type { InvokeOptions } from './socket.js';
-export interface GetRequestsParams {
-    tabId?: number;
-    count?: number;
-    filter?: string;
-    since?: number;
-    includeBody?: boolean;
-    includeHeaders?: boolean;
-    maxBodySize?: number;
-    fields?: string[];
-    keysOnly?: boolean;
-    source?: 'mtop' | 'requests';
-}
-export declare function getRequests(params?: GetRequestsParams): Promise<any>;
-export interface GetLogsParams {
-    level?: 'log' | 'warn' | 'error' | 'info' | 'all';
-    since?: number;
-    limit?: number;
-    filter?: string;
-}
-export declare function getLogs(params?: GetLogsParams): Promise<any>;
-export interface GetEventsParams {
-    tabId?: number;
-    source?: 'rum' | 'aplus' | 'arms' | 'all';
-    event_type?: string;
-    filter?: string;
-    since?: number;
-    limit?: number;
-    /** Include full tracking URL, raw payload, and parsed context. Defaults to false. */
-    includeRaw?: boolean;
-}
-export declare function getEvents(params?: GetEventsParams): Promise<any>;
-export interface SetMockParams {
-    apiName: string;
-    mockData?: any;
-    fields?: Array<{
-        path: string;
-        value: any;
-    }>;
-    enabled?: boolean;
-    /** 完整响应时长（毫秒）：mock 的总耗时，绕过真实服务器精确控制 */
-    duration?: number;
-    /** 请求 query/body 字段子集匹配；$index 从 0 开始指定调用顺序 */
-    conditions?: Record<string, any>;
-}
-export declare function setMock(params: SetMockParams): Promise<any>;
-export interface GetMocksParams {
-    apiName?: string;
-}
-export declare function getMocks(params?: GetMocksParams): Promise<any>;
-export interface GetApiSchemaParams {
-    api: string;
-    version?: string;
-    fields?: ('schema' | 'hsf')[];
-}
-export declare function getApiSchema(params: GetApiSchemaParams): Promise<any>;
-export interface SendRequestParams {
-    url: string;
-    method?: string;
-    headers?: Record<string, string>;
-    params?: Record<string, string>;
-    body?: any;
-    withCookies?: boolean;
-    cookieDomain?: string;
-    responseType?: 'json' | 'text' | 'auto';
-    timeout?: number;
-}
-export declare function sendRequest(params: SendRequestParams): Promise<any>;
-export interface SendMtopRequestParams {
-    api: string;
-    data?: any;
-    version?: string;
-    method?: string;
-    appKey?: string;
-    env?: string;
-    timeout?: number;
-}
-export declare function sendMtopRequest(params: SendMtopRequestParams): Promise<any>;
-export interface TdbankAccountParams {
-    operation?: 'current' | 'list' | 'switch' | 'borrow';
-    pageIndex?: number;
-    refresh?: boolean;
-    query?: string;
-    accountId?: string | number;
-    havanaId?: string | number;
-    site?: string | number;
-    tabId?: number;
-}
-export declare function tdbankAccount(params?: TdbankAccountParams): Promise<any>;
-export type BrowserStatus = 'connected' | 'running_disconnected' | 'stopped';
-export interface BrowserInfoBase {
-    browserId: string;
-    name: string;
-    status: BrowserStatus;
-    extensionVersion?: string;
-    nativeHostVersion?: string;
-    transport?: 'extension' | 'cdp';
-}
-export interface RegularBrowserInfo extends BrowserInfoBase {
-    type: 'regular';
-    status: 'connected';
-}
-export interface ManagedBrowserAccount {
-    accountId?: string;
-    loginId?: string;
-    nickname: string;
-}
-export interface ManagedBrowserInfo extends BrowserInfoBase {
-    type: 'managed';
-    headless: boolean;
-    persistent: boolean;
-    cdpPort: number;
-    createdAt: string;
-    account?: ManagedBrowserAccount;
-    copiedCookies?: {
-        domains: string[];
-        count: number;
-    };
-}
-export type BrowserInfo = RegularBrowserInfo | ManagedBrowserInfo;
-export interface BrowserListResult {
-    count: number;
-    connectedCount: number;
-    defaultBrowserId: string | null;
-    browsers: BrowserInfo[];
-}
-export declare function browserList(): Promise<BrowserListResult>;
-export interface SelectBrowserParams {
-    browser?: string;
-}
-export interface SelectBrowserResult {
-    selected: {
-        browserId: string;
-        name: string;
-    } | null;
-    note?: string;
-}
-export declare function selectBrowser(params?: SelectBrowserParams): Promise<SelectBrowserResult>;
-export interface BrowserLaunchParams {
-    name: string;
-    headless?: boolean;
-    userAgentMode?: 'default' | 'desktop';
-    persistent?: boolean;
-    executablePath?: string;
-    url?: string;
-    accountId?: string | number;
-    havanaId?: string | number;
-    site?: string | number;
-    query?: string;
-    tabId?: number;
-    copyCookieDomains?: string[];
-}
-export declare function browserLaunch(params: BrowserLaunchParams): Promise<any>;
-export interface BrowserCloseParams {
-    browser: string;
-    deleteProfile?: boolean;
-}
-export declare function browserClose(params: BrowserCloseParams): Promise<any>;
-export interface SetRuleParams {
-    actionType: 'redirect' | 'block' | 'allow' | 'upgradeScheme' | 'modifyHeaders';
-    filter: string;
-    redirectUrl?: string;
-    requestHeaders?: Array<{
-        header: string;
-        operation: 'set' | 'append' | 'remove';
-        value?: string;
-    }>;
-    responseHeaders?: Array<{
-        header: string;
-        operation: 'set' | 'append' | 'remove';
-        value?: string;
-    }>;
-    initiatorDomains?: string;
-    resourceTypes?: string[];
-    priority?: number;
-    description?: string;
-}
-export declare function setRule(params: SetRuleParams): Promise<any>;
-/** 返回当前存储的全部请求规则（含 Options 面板配置的），字段结构与 set_rule 入参对齐。 */
-export declare function getRules(): Promise<{
-    enabled: boolean;
-    rules: Array<Record<string, any>>;
-}>;
-export interface PageScreenshotParams {
-    tabId: number;
-    selector?: string;
-    format?: 'png' | 'jpeg';
-    quality?: number;
-}
-export declare function pageScreenshot(params: PageScreenshotParams): Promise<any>;
-export interface PageSelectedElementParams {
-    tabId: number;
-    includeOuterHTML?: boolean;
-    includeScreenshot?: boolean;
-}
-export declare function pageSelectedElement(params: PageSelectedElementParams): Promise<any>;
-export interface TabOpenParams {
-    url: string;
-    active?: boolean;
-    /** 打开前先关闭 Agent 受控的已有标签页。默认 false */
-    closeExisting?: boolean;
-    /** 是否复用匹配标签页。默认 never，保持始终新开的兼容行为。 */
-    reuse?: 'never' | 'prefer' | 'require';
-    /** 复用标签页时的 URL 匹配规则。 */
-    match?: {
-        /** 完整 URL glob，`*` 匹配任意字符；省略时匹配 url。 */
-        urlPattern?: string;
-        ignoreSearch?: boolean;
-        ignoreHash?: boolean;
-        onMultiple?: 'error' | 'first';
-    };
-    /** active 新标签页关闭后，恢复打开前的活动标签页。默认 false。 */
-    restoreFocusOnClose?: boolean;
-    /**
-     * 开 tab 即进入移动端模拟态（视口/UA/触摸），在导航前生效，页面首屏即移动态、无需 reload。
-     * 等价于随后立即调用 set_device_emulation，但省一次整页加载并避开桌面态首屏的 UA 判端跳转。
-     */
-    emulation?: EmulationOptions;
-    /** 把标签页加入指定标题的分组（同窗口同名分组存在则加入，否则新建）。仅扩展模式支持。 */
-    group?: string;
-}
-export declare function tabOpen(params: TabOpenParams): Promise<any>;
-export interface TabCloseParams {
-    tabId: number;
-}
-export declare function tabClose(params: TabCloseParams): Promise<any>;
-export declare function tabList(): Promise<any>;
-/**
- * 页面交互动作（click/type/hover/scroll/press/upload）默认内置观察：
- * 同一次调用内执行动作并等待异步稳定，返回 `{ action, observation }`。
- * 传 `observe: false` 关闭观察，仅执行裸动作并直接返回其结果。
- * page_eval 默认裸执行，显式传 observe 对象时才进入同一观察链路。
- */
-export interface PageObserveOptions {
-    quietMs?: number;
-    firstChangeTimeoutMs?: number;
-    timeoutMs?: number;
-    navigationGraceMs?: number;
-    navigationTimeoutMs?: number;
-    networkIdleMs?: number;
-    contentReadyAfterMs?: number;
-}
-export interface PageClickParams {
-    tabId: number;
-    /** 原生 CSS 选择器，或 snapshot / 页面动作 observation 返回的 @eN ref。 */
-    selector?: string;
-    /** 按可见文本（AX name）定位；可配合 role/exact 消歧。 */
-    text?: string;
-    /** 按视口坐标点击（CSS 像素）。 */
-    point?: {
-        x: number;
-        y: number;
-    };
-    /** 配合 text，按 AX role 过滤。 */
-    role?: string;
-    /** 配合 text，默认 true（精确匹配），false 时子串匹配。 */
-    exact?: boolean;
-    /** 配合 text，把 AX 文本匹配限制在指定 CSS 元素或 @eN ref 子树内。 */
-    scope?: string;
-    /**
-     * 点击模式。auto 会在可见页按设备模拟状态选择可信 mouse/touch，在隐藏页
-     * 使用 DOM fallback；checkbox/radio 使用带状态校验的 DOM 路径。
-     * dom/mouse/touch 可强制指定实际派发方式。
-     */
-    clickMode?: 'auto' | 'dom' | 'mouse' | 'touch';
-    /** 观察选项；传 false 关闭内置观察。 */
-    observe?: PageObserveOptions | false;
-}
-export declare function pageClick(params: PageClickParams): Promise<any>;
-export interface PageTypeParams {
-    tabId: number;
-    selector: string;
-    text: string;
-    clearFirst?: boolean;
-    /** 观察选项；传 false 关闭内置观察。 */
-    observe?: PageObserveOptions | false;
-}
-export declare function pageType(params: PageTypeParams): Promise<any>;
-export interface PageScrollParams {
-    tabId: number;
-    direction: 'up' | 'down' | 'top' | 'bottom';
-    distance?: number;
-    /** 原生 CSS 选择器或 page_snapshot 返回的 @eN ref；不传时滚动页面。 */
-    selector?: string;
-    /** selector 指向子节点时，是否自动使用最近的可滚动祖先。默认 self。 */
-    containerPolicy?: 'self' | 'nearest';
-    /** 观察选项；传 false 关闭内置观察。 */
-    observe?: PageObserveOptions | false;
-}
-export declare function pageScroll(params: PageScrollParams): Promise<any>;
-export interface PageHoverParams {
-    tabId: number;
-    selector: string;
-    /** 观察选项；传 false 关闭内置观察。 */
-    observe?: PageObserveOptions | false;
-}
-export declare function pageHover(params: PageHoverParams): Promise<any>;
-export interface PageEvalParams {
-    tabId: number;
-    expression: string;
-    frameId?: string;
-    awaitPromise?: boolean;
-    /** 显式传入时观察表达式引发的页面变化；不传保持轻量裸执行。 */
-    observe?: PageObserveOptions;
-}
-export declare function pageEval(params: PageEvalParams): Promise<any>;
-export interface PageSnapshotQuery {
-    /** 按 accessibility name 匹配。 */
-    text?: string;
-    /** 按 AX role 匹配。 */
-    role?: string;
-    /** 默认 true 精确匹配；false 时按子串匹配 text。 */
-    exact?: boolean;
-}
-export interface PageSnapshotParams {
-    tabId: number;
-    depth?: number;
-    maxChars?: number;
-    maxNodes?: number;
-    /** CSS 根元素；与 rootRef 互斥。 */
-    rootSelector?: string;
-    /** 以已有 @eN ref 为根获取局部 AX 子树；与 rootSelector 互斥。 */
-    rootRef?: string;
-    /** rootRef 向上扩展的 DOM 祖先层数，默认 0，最大 20。 */
-    ancestorDepth?: number;
-    /** 服务端过滤 AX 树，只保留命中节点及其祖先路径。 */
-    query?: PageSnapshotQuery;
-    /** full 为完整树；interactive 为当前视口内的语义控件；viewport 为当前可视区域。 */
-    mode?: 'full' | 'interactive' | 'viewport';
-}
-export declare function pageSnapshot(params: PageSnapshotParams): Promise<any>;
-export interface PagePressParams {
-    tabId: number;
-    key: string;
-    modifiers?: string[];
-    /** 观察选项；传 false 关闭内置观察。 */
-    observe?: PageObserveOptions | false;
-}
-export declare function pagePress(params: PagePressParams): Promise<any>;
-export interface PageWaitParams {
-    tabId: number;
-    time?: number;
-    selector?: string;
-    /** 在页面主执行上下文中轮询，表达式返回 truthy 时结束。 */
-    condition?: string;
-    timeout?: number;
-    interval?: number;
-}
-export declare function pageWait(params: PageWaitParams): Promise<any>;
-export interface PageNavigateParams {
-    tabId: number;
-    /** 要导航到的 URL；与 refresh/history 互斥。 */
-    url?: string;
-    /** 为 true 时直接重新加载当前页面；与 url/history 互斥。 */
-    refresh?: boolean;
-    /** 沿当前标签页的浏览历史后退或前进；与 url/refresh 互斥。 */
-    history?: 'back' | 'forward';
-}
-export declare function pageNavigate(params: PageNavigateParams): Promise<any>;
-export interface PageUploadParams {
-    tabId: number;
-    selector: string;
-    filePaths: string[];
-    /** 观察选项；传 false 关闭内置观察。 */
-    observe?: PageObserveOptions | false;
-}
-export declare function pageUpload(params: PageUploadParams): Promise<any>;
-export interface PageFramesParams {
-    tabId: number;
-}
-export declare function pageFrames(params: PageFramesParams): Promise<any>;
-export type DevicePresetName = 'iphone-15-pro' | 'iphone-se' | 'pixel-8' | 'ipad-mini' | 'galaxy-s23';
-/**
- * 移动端模拟入参（不含 enabled/tabId/reload）。tab_open 的 emulation 字段与
- * set_device_emulation 复用同一套字段，规则一致。
- */
-export interface EmulationOptions {
-    preset?: DevicePresetName;
-    width?: number;
-    height?: number;
-    deviceScaleFactor?: number;
-    mobile?: boolean;
-    userAgent?: string;
-    orientation?: 'portrait' | 'landscape';
-    touch?: boolean;
-}
-export interface SetDeviceEmulationParams extends EmulationOptions {
-    tabId: number;
-    enabled: boolean;
-    reload?: boolean;
-}
-export declare function setDeviceEmulation(params: SetDeviceEmulationParams): Promise<any>;
-export interface SetTimezoneParams {
-    tabId: number;
-    /** IANA timezone identifier, or an empty string to restore the browser default. */
-    timezone: string;
-}
-export interface SetTimezoneResult {
-    enabled: boolean;
-    timezone: string | null;
-}
-export declare function setTimezone(params: SetTimezoneParams): Promise<SetTimezoneResult>;
-export interface GetUserInfoParams {
-    detail?: boolean;
-}
-export declare function getUserInfo(params?: GetUserInfoParams): Promise<any>;
-export interface ActionStep {
-    action: string;
-    data?: Record<string, any>;
-}
-export interface RunActionsParams {
-    actions: ActionStep[];
-    tabId: number;
-}
-export declare function runActions(params: RunActionsParams): Promise<any>;
+export { BROWSER_ACTIONS, BROWSER_COMMAND_ACTIONS, EXTENSION_BROWSER_ACTIONS, PAGE_ACT_ACTIONS, 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, BrowserDevicePresetName, BrowserEmulationOptions, ExtensionBrowserAction, GetApiSchemaParams, GetCookieParams, GetCookieResult, GetEventsParams, GetLogsParams, GetMocksParams, GetRequestsParams, GetUserInfoParams, ManagedBrowserAccount, ManagedBrowserInfo, PageClickParams, PageActAction, PageEvalParams, PageFramesParams, PageHoverParams, PageNavigateParams, PageObservationWaitOptions, PagePressParams, PageScreenshotParams, PageScrollParams, PageSelectedElementParams, PageSnapshotParams, PageSnapshotQuery, PageTypeParams, PageUploadParams, PageWaitParams, RecordParams, RegularBrowserInfo, RequestDomainPermissionParams, RulesResult, RunActionName, RunActionsParams, SelectBrowserParams, SelectBrowserResult, SendMtopRequestParams, SendRequestParams, SetCookieParams, SetCookieResult, SetDeviceEmulationParams, SetMockParams, SetRuleParams, SetTimezoneParams, SetTimezoneResult, TabCloseParams, TabOpenParams, TdbankAccountParams, } from './generated-browser-action-protocol.js';
+import type * as Protocol from './generated-browser-action-protocol.js';
+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'>>;

package/dist/index.js

@@ -3,19 +3,9 @@
  *
  * 通过 Unix Domain Socket 与 Chrome Extension 的 native host 通信，
  * 提供类型安全的具名方法和通用的 invoke 底层方法。
- *
- * @example
- * ```ts
- * import * as client from '@mearl/client';
- *
- * // 具名方法（类型安全）
- * const result = await client.sendRequest({ url: 'https://...', method: 'GET', withCookies: true });
- *
- * // 底层通用方法（灵活扩展）
- * const data = await client.invoke('send_request', { url: '...' });
- * ```
  */
 export { invoke } from './socket.js';
+export { BROWSER_ACTIONS, BROWSER_COMMAND_ACTIONS, EXTENSION_BROWSER_ACTIONS, PAGE_ACT_ACTIONS, isBrowserAction, isBrowserCommandAction, isExtensionBrowserAction, } from './generated-browser-action-protocol.js';
 import { invoke } from './socket.js';
 export function getRequests(params = {}) {
     return invoke('get_requests', params);
@@ -50,6 +40,9 @@ export function browserList() {
 export function selectBrowser(params = {}) {
     return invoke('browser_select_browser', params);
 }
+export function browserRelease() {
+    return invoke('browser_release', {});
+}
 export function browserLaunch(params) {
     return invoke('browser_launch', params);
 }
@@ -59,7 +52,6 @@ export function browserClose(params) {
 export function setRule(params) {
     return invoke('set_rule', params);
 }
-/** 返回当前存储的全部请求规则（含 Options 面板配置的），字段结构与 set_rule 入参对齐。 */
 export function getRules() {
     return invoke('get_rules', {});
 }
@@ -117,6 +109,12 @@ export function setDeviceEmulation(params) {
 export function setTimezone(params) {
     return invoke('set_timezone', params);
 }
+export function getCookie(params) {
+    return invoke('get_cookie', params);
+}
+export function setCookie(params) {
+    return invoke('set_cookie', params);
+}
 export function getUserInfo(params = {}) {
     return invoke('get_user_info', params);
 }

package/dist/socket.d.ts

@@ -20,6 +20,8 @@ export interface InvokeOptions {
     transport?: 'cdp';
     /** Target a specific browser by id / name (see the browser registry). */
     browser?: string;
+    /** Identifies whether browser control originated locally or through the cloud connector. */
+    controlSource?: 'local' | 'cloud';
 }
 /** Pin the default target browser for subsequent invokes (undefined clears it). */
 export declare function setDefaultBrowser(selector: string | undefined): void;