@skrillex1224/playwright-toolkit 2.1.274 → 2.1.276

package/index.d.ts

@@ -441,6 +441,46 @@ export interface LaunchModule {
     getPlaywrightCrawlerOptions(options?: GetPlaywrightCrawlerOptionsInput): PlaywrightCrawlerOptions;
 }
 
+export interface CloakBrowserResolvedProxy {
+    server: string;
+    username?: string;
+    password?: string;
+    bypass?: string;
+}
+
+export interface CreateCloakBrowserCrawlerRuntimeInput {
+    proxyConfiguration?: ProxyConfiguration;
+    runInHeadfulMode?: boolean;
+    isRunningOnApify?: boolean;
+    launcher?: any;
+    cloakOptions?: Record<string, any>;
+    humanizeOptions?: boolean | Record<string, any>;
+    crawlerBaseOptions?: Partial<CrawlerBaseOptions>;
+    browserPoolOptions?: Record<string, any>;
+    launchContext?: Record<string, any>;
+    preNavigationHooks?: CrawlerNavigationHook[];
+    postNavigationHooks?: CrawlerNavigationHook[];
+    recommendedGotoOptions?: Record<string, any>;
+}
+
+export interface CloakBrowserCrawlerRuntime {
+    headless: boolean;
+    launchOptions: LaunchOptions;
+    fingerprintArg: string;
+    crawlerOptions: PlaywrightCrawlerOptions;
+    closeActiveBrowsers(): Promise<void>;
+    forceTerminateActiveProcesses(): Promise<void>;
+    cleanup(): Promise<void>;
+}
+
+export interface CloakLaunchModule extends LaunchModule {
+    resolveProxyConfiguration(proxyConfiguration?: ProxyConfiguration): string | CloakBrowserResolvedProxy | null;
+    extractFingerprintArg(launchOptions?: LaunchOptions): string;
+    createStableGotoHook(recommendedGotoOptions?: Record<string, any>): CrawlerNavigationHook;
+    buildLaunchOptions(options?: Record<string, any>): Promise<LaunchOptions>;
+    createPlaywrightCrawlerRuntime(options?: CreateCloakBrowserCrawlerRuntimeInput): Promise<CloakBrowserCrawlerRuntime>;
+}
+
 // =============================================================================
 // LiveView
 // =============================================================================
@@ -654,6 +694,8 @@ export interface ShareScreenCaptureOptions {
     restore?: boolean;
     /** 最大截图高度 (默认: 8000px) */
     maxHeight?: number;
+    /** 截图水印合成模式；`cloakbrowser` 时走兼容分支。 */
+    mode?: 'default' | 'cloakbrowser';
     /** 返回 base64 字符串的最大字节数，默认 5MiB。 */
     maxBytes?: number;
     /** maxBytes 的别名。 */
@@ -840,6 +882,10 @@ export interface PlaywrightToolKit {
     };
 }
 
+export interface CloakPlaywrightToolKit extends PlaywrightToolKit {
+    Launch: CloakLaunchModule;
+}
+
 /** Browser/Extension version of the toolkit */
 export interface BrowserPlaywrightToolKit {
     Logger: LoggerModule;
@@ -854,3 +900,5 @@ export interface BrowserPlaywrightToolKit {
 }
 
 export declare function usePlaywrightToolKit(): PlaywrightToolKit;
+export declare function usePlaywrightToolKit(mode: 'default'): PlaywrightToolKit;
+export declare function usePlaywrightToolKit(mode: 'cloakbrowser'): CloakPlaywrightToolKit;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skrillex1224/playwright-toolkit",
-  "version": "2.1.274",
+  "version": "2.1.276",
   "description": "一个在 Apify/Crawlee Actor 中启用实时截图视图的实用工具库。",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -59,10 +59,16 @@
   },
   "peerDependencies": {
     "apify": "*",
+    "cloakbrowser": "*",
     "crawlee": "*",
     "ghost-cursor-playwright": "*",
     "playwright": "*"
   },
+  "peerDependenciesMeta": {
+    "cloakbrowser": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "esbuild": "^0.24.2"
   }