@pyrokine/mcp-chrome 1.0.0

package/dist/core/session.d.ts

@@ -0,0 +1,254 @@
+/**
+ * 会话管理
+ *
+ * 管理浏览器会话，包括：
+ * - CDP 客户端
+ * - 反检测注入
+ * - 页面状态
+ * - 日志收集
+ */
+import { BehaviorSimulator } from '../anti-detection/index.js';
+import { AutoWait } from './auto-wait.js';
+import { Locator } from './locator.js';
+import type { ConnectOptions, ConsoleLogEntry, Cookie, CookieOptions, LaunchOptions, NetworkRequestEntry, PageState, Target, TargetInfo, WaitUntil } from './types.js';
+/**
+ * 会话状态
+ */
+interface SessionState {
+    url: string;
+    title: string;
+    targetId: string;
+}
+/**
+ * 会话管理器（单例）
+ */
+declare class SessionManager {
+    private static instance;
+    private static readonly MAX_LOG_ENTRIES;
+    private launcher;
+    private cdp;
+    private sessionId;
+    private currentTargetId;
+    private state;
+    private behaviorSimulator;
+    private stealthMode;
+    private operationLock;
+    private consoleLogs;
+    private networkRequests;
+    private requestMap;
+    private listenersInstalled;
+    private constructor();
+    static getInstance(): SessionManager;
+    /**
+     * 启动浏览器
+     */
+    launch(options?: LaunchOptions): Promise<TargetInfo>;
+    /**
+     * 连接到已运行的浏览器
+     */
+    connect(options: ConnectOptions): Promise<TargetInfo>;
+    /**
+     * 列出所有可用页面
+     */
+    listTargets(): Promise<TargetInfo[]>;
+    /**
+     * 附加到指定页面
+     */
+    attachToTarget(targetId: string): Promise<void>;
+    /**
+     * 导航到 URL
+     */
+    navigate(url: string, options?: {
+        wait?: WaitUntil;
+        timeout?: number;
+    }): Promise<void>;
+    /**
+     * 等待网络空闲（无进行中的请求且持续指定时间）
+     */
+    waitForNetworkIdle(timeout: number, idleTime?: number): Promise<void>;
+    /**
+     * 等待导航完成（Page.loadEventFired 事件）
+     */
+    waitForNavigation(timeout?: number): Promise<void>;
+    /**
+     * 后退
+     */
+    goBack(): Promise<void>;
+    /**
+     * 前进
+     */
+    goForward(): Promise<void>;
+    /**
+     * 刷新
+     */
+    reload(options?: {
+        ignoreCache?: boolean;
+        timeout?: number;
+    }): Promise<void>;
+    /**
+     * 创建定位器
+     */
+    createLocator(target: Target, options?: {
+        timeout?: number;
+    }): Locator;
+    /**
+     * 创建自动等待器
+     */
+    createAutoWait(options?: {
+        timeout?: number;
+    }): AutoWait;
+    /**
+     * 获取行为模拟器
+     */
+    getBehaviorSimulator(): BehaviorSimulator;
+    /**
+     * 鼠标移动
+     */
+    mouseMove(x: number, y: number): Promise<void>;
+    /**
+     * 鼠标按下
+     */
+    mouseDown(button?: 'left' | 'middle' | 'right' | 'back' | 'forward'): Promise<void>;
+    /**
+     * 鼠标释放
+     */
+    mouseUp(button?: 'left' | 'middle' | 'right' | 'back' | 'forward'): Promise<void>;
+    /**
+     * 滚轮
+     */
+    mouseWheel(deltaX: number, deltaY: number): Promise<void>;
+    /**
+     * 键盘按下
+     */
+    keyDown(key: string): Promise<void>;
+    /**
+     * 键盘释放
+     */
+    keyUp(key: string): Promise<void>;
+    /**
+     * 输入文本
+     */
+    type(text: string, delay?: number): Promise<void>;
+    /**
+     * 触屏开始
+     */
+    touchStart(x: number, y: number): Promise<void>;
+    /**
+     * 触屏移动
+     */
+    touchMove(x: number, y: number): Promise<void>;
+    /**
+     * 触屏结束
+     */
+    touchEnd(): Promise<void>;
+    /**
+     * 截图
+     */
+    screenshot(fullPage?: boolean): Promise<string>;
+    /**
+     * 获取页面状态
+     */
+    getPageState(): Promise<PageState>;
+    /**
+     * 获取 Cookies
+     */
+    getCookies(): Promise<Cookie[]>;
+    /**
+     * 设置 Cookie
+     */
+    setCookie(name: string, value: string, options?: CookieOptions): Promise<void>;
+    /**
+     * 删除 Cookie
+     */
+    deleteCookie(name: string): Promise<void>;
+    /**
+     * 清除所有 Cookies
+     */
+    clearCookies(): Promise<void>;
+    /**
+     * 获取控制台日志
+     */
+    getConsoleLogs(level?: string, limit?: number): ConsoleLogEntry[];
+    /**
+     * 获取网络请求日志
+     */
+    getNetworkRequests(urlPattern?: string, limit?: number): NetworkRequestEntry[];
+    /**
+     * 清除日志
+     */
+    clearLogs(): void;
+    /**
+     * 执行 JavaScript
+     */
+    evaluate<T>(script: string, args?: unknown[], timeout?: number): Promise<T>;
+    /**
+     * 设置视口
+     */
+    setViewport(width: number, height: number): Promise<void>;
+    /**
+     * 设置 User-Agent
+     */
+    setUserAgent(userAgent: string): Promise<void>;
+    /**
+     * 清除缓存
+     */
+    clearCache(type?: 'all' | 'cookies' | 'storage' | 'cache'): Promise<void>;
+    /**
+     * 新建页面
+     */
+    newPage(): Promise<TargetInfo>;
+    /**
+     * 关闭页面
+     */
+    closePage(targetId?: string): Promise<void>;
+    /**
+     * 关闭浏览器
+     */
+    close(): Promise<void>;
+    /**
+     * 获取当前状态
+     */
+    getState(): SessionState | null;
+    /**
+     * 是否已连接
+     */
+    isConnected(): boolean;
+    /**
+     * 是否有活跃会话
+     */
+    hasSession(): boolean;
+    /**
+     * 串行执行操作（防止并发竞态）
+     */
+    private withLock;
+    /**
+     * 初始化会话
+     */
+    private initSession;
+    /**
+     * 设置事件监听（幂等，只安装一次）
+     */
+    private setupEventListeners;
+    /**
+     * 更新页面状态
+     */
+    private updateState;
+    /**
+     * 发送 CDP 命令
+     */
+    private send;
+    /**
+     * 确保已连接
+     */
+    private ensureConnected;
+    /**
+     * 确保有活跃会话
+     */
+    private ensureSession;
+}
+/**
+ * 获取会话管理器实例
+ */
+export declare function getSession(): SessionManager;
+export {};
+//# sourceMappingURL=session.d.ts.map

package/dist/core/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAC,iBAAiB,EAAyB,MAAM,4BAA4B,CAAA;AAEpF,OAAO,EAAC,QAAQ,EAAC,MAAM,gBAAgB,CAAA;AAEvC,OAAO,EAAC,OAAO,EAAC,MAAM,cAAc,CAAA;AACpC,OAAO,KAAK,EACR,cAAc,EACd,eAAe,EACf,MAAM,EACN,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,SAAS,EACT,MAAM,EACN,UAAU,EACV,SAAS,EACZ,MAAM,YAAY,CAAA;AAEnB;;GAEG;AACH,UAAU,YAAY;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,cAAM,cAAc;IAChB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgB;IAEvC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAc;IACrD,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,GAAG,CAA8C;IACzD,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,iBAAiB,CAAmD;IAC5E,OAAO,CAAC,WAAW,CAAwC;IAE3D,OAAO,CAAC,aAAa,CAAmC;IACxD,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,eAAe,CAA4B;IACnD,OAAO,CAAC,UAAU,CAKd;IAGJ,OAAO,CAAC,kBAAkB,CAAQ;IAElC,OAAO;IAGP,MAAM,CAAC,WAAW,IAAI,cAAc;IAOpC;;OAEG;IACG,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IAoC9D;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IAqC3D;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAuB1C;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCrD;;OAEG;IACG,QAAQ,CACV,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,SAAS,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GACrD,OAAO,CAAC,IAAI,CAAC;IA+BhB;;OAEG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAkEhF;;OAEG;IACG,iBAAiB,CAAC,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/D;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAM7B;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAMhC;;OAEG;IACG,MAAM,CAAC,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBtF;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO;IAQtE;;OAEG;IACH,cAAc,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,QAAQ;IAKxD;;OAEG;IACH,oBAAoB,IAAI,iBAAiB;IAIzC;;OAEG;IACG,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUpD;;OAEG;IACG,SAAS,CACX,MAAM,GAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAkB,GAClE,OAAO,CAAC,IAAI,CAAC;IAWhB;;OAEG;IACG,OAAO,CACT,MAAM,GAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAkB,GAClE,OAAO,CAAC,IAAI,CAAC;IAWhB;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/D;;OAEG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASzC;;OAEG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASvC;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBlD;;OAEG;IACG,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrD;;OAEG;IACG,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ/B;;OAEG;IACG,UAAU,CAAC,QAAQ,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAkCnD;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,SAAS,CAAC;IAgExC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAQrC;;OAEG;IACG,SAAS,CACX,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,GAC5B,OAAO,CAAC,IAAI,CAAC;IAchB;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/C;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAKnC;;OAEG;IACH,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,eAAe,EAAE;IAQ9D;;OAEG;IACH,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,mBAAmB,EAAE;IAS3E;;OAEG;IACH,SAAS,IAAI,IAAI;IAMjB;;OAEG;IACG,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IA0BjF;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/D;;OAEG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpD;;OAEG;IACG,UAAU,CAAC,IAAI,GAAE,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBtF;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IAiBpC;;OAEG;IACG,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBjD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB5B;;OAEG;IACH,QAAQ,IAAI,YAAY,GAAG,IAAI;IAI/B;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;YACW,QAAQ;IActB;;OAEG;YACW,WAAW;IA6BzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAuE3B;;OAEG;YACW,WAAW;IAczB;;OAEG;IACH,OAAO,CAAC,IAAI;IAIZ;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACH,OAAO,CAAC,aAAa;CAMxB;AAoED;;GAEG;AACH,wBAAgB,UAAU,IAAI,cAAc,CAE3C"}