@skrillex1224/playwright-toolkit 2.1.286 → 3.0.1

package/index.d.ts

@@ -20,10 +20,10 @@ export interface StatusType {
 
 export interface ModeType {
     Default: 'default';
-    CloakBrowser: 'cloakbrowser';
+    Cloak: 'cloak';
 }
 
-export type ToolkitMode = 'default' | 'cloakbrowser';
+export type ToolkitMode = 'default' | 'cloak';
 
 export interface ConstantsModule {
     Code: CodeType;
@@ -409,9 +409,9 @@ export interface CrawlerBaseOptions {
     requestHandlerTimeoutSecs: number;
     navigationTimeoutSecs: number;
     headless: boolean;
-    browserPoolOptions: {
-        useFingerprints: boolean;
-        fingerprintOptions: {
+    browserPoolOptions: Record<string, any> & {
+        useFingerprints?: boolean;
+        fingerprintOptions?: {
             fingerprintGeneratorOptions: Record<string, any>;
         };
     };
@@ -450,45 +450,23 @@ 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;
+export interface CloakGetPlaywrightCrawlerOptionsInput extends GetPlaywrightCrawlerOptionsInput {
     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 CloakPlaywrightCrawlerOptions extends PlaywrightCrawlerOptions {
+    cleanup?: () => Promise<void>;
+    closeActiveBrowsers?: () => Promise<void>;
+    forceTerminateActiveProcesses?: () => Promise<void>;
 }
 
-export interface CloakLaunchModule extends Omit<LaunchModule, 'getPlaywrightCrawlerOptions'> {
-    getPlaywrightCrawlerOptions(options?: GetPlaywrightCrawlerOptionsInput | CreateCloakBrowserCrawlerRuntimeInput): Promise<PlaywrightCrawlerOptions>;
-    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>;
+export interface CloakLaunchModule {
+    getPlaywrightCrawlerOptions(options?: CloakGetPlaywrightCrawlerOptionsInput): Promise<CloakPlaywrightCrawlerOptions>;
 }
 
 // =============================================================================
@@ -704,8 +682,8 @@ export interface ShareScreenCaptureOptions {
     restore?: boolean;
     /** 最大截图高度 (默认: 8000px) */
     maxHeight?: number;
-    /** 截图水印合成模式；`cloakbrowser` 时走兼容分支。 */
-    mode?: 'default' | 'cloakbrowser';
+    /** 截图水印合成模式；`cloak` 时走兼容分支。 */
+    mode?: 'default' | 'cloak';
     /** 返回 base64 字符串的最大字节数，默认 5MiB。 */
     maxBytes?: number;
     /** maxBytes 的别名。 */
@@ -911,4 +889,4 @@ export interface BrowserPlaywrightToolKit {
 
 export declare function usePlaywrightToolKit(): PlaywrightToolKit;
 export declare function usePlaywrightToolKit(mode: 'default'): PlaywrightToolKit;
-export declare function usePlaywrightToolKit(mode: 'cloakbrowser'): CloakPlaywrightToolKit;
+export declare function usePlaywrightToolKit(mode: 'cloak'): CloakPlaywrightToolKit;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skrillex1224/playwright-toolkit",
-  "version": "2.1.286",
+  "version": "3.0.1",
   "description": "一个在 Apify/Crawlee Actor 中启用实时截图视图的实用工具库。",
   "main": "dist/index.cjs",
   "module": "dist/index.js",