@skrillex1224/playwright-toolkit 3.0.24 → 3.0.26

package/index.d.ts

@@ -207,6 +207,7 @@ export interface RunStepOptions {
 }
 
 export interface ApifyKitInstance {
+    isAtHome(): boolean;
     runStep<T>(step: string, page: Page | null, actionFn: () => Promise<T>, options?: RunStepOptions): Promise<T>;
     runStepLoose<T>(step: string, page: Page | null, fn: () => Promise<T>, options?: RunStepOptions): Promise<T>;
     pushSuccess(data: Record<string, any>, options?: { page?: Page | null }): Promise<void>;
@@ -444,7 +445,7 @@ export interface GetPlaywrightCrawlerOptionsInput {
     };
     runInHeadfulMode?: boolean;
     debugMode?: boolean;
-    isRunningOnApify?: boolean;
+    isRunningAtHome?: boolean;
     launcher?: any;
     runtimeState?: RuntimeEnvState | null;
     hooks?: LaunchHooks;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skrillex1224/playwright-toolkit",
-  "version": "3.0.24",
+  "version": "3.0.26",
   "description": "一个在 Apify/Crawlee Actor 中启用实时截图视图的实用工具库。",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -22,8 +22,8 @@
   },
   "scripts": {
     "build": "node build.js",
-    "postinstall": "node ./scripts/postinstall.js",
     "release": "npm run build && npm version patch && npm publish --registry https://registry.npmjs.org --access public --userconfig ../.npmrc",
+    "postinstall": "node ./scripts/postinstall.js",
     "prepublishOnly": "npm run build",
     "test": "echo \"Error: no test specified\" && exit 1"
   },
@@ -61,16 +61,10 @@
   },
   "peerDependencies": {
     "apify": "*",
-    "cloakbrowser": "*",
     "crawlee": "*",
     "ghost-cursor-playwright": "*",
     "playwright": "*"
   },
-  "peerDependenciesMeta": {
-    "cloakbrowser": {
-      "optional": true
-    }
-  },
   "devDependencies": {
     "esbuild": "^0.24.2"
   }

package/scripts/postinstall.js

@@ -14,6 +14,13 @@ const warn = (message) => console.warn(`${PREFIX} ${message}`);
 
 const isTruthy = (value) => /^(1|true|yes|on)$/i.test(String(value || '').trim());
 
+const toPositiveInteger = (value, fallback) => {
+    const parsed = Number(value);
+    return Number.isInteger(parsed) && parsed > 0 ? parsed : fallback;
+};
+
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+
 const readTrimmedFile = (filePath) => {
     try {
         return fs.readFileSync(filePath, 'utf8').trim();
@@ -124,6 +131,35 @@ const clearStaleVersionMarkers = ({ cacheDir, expectedVersion, platformTag }) =>
     return clearedMarkers;
 };
 
+const ensureBinaryWithRetries = async ({ cloakModule, expectedBinaryPath }) => {
+    const attempts = toPositiveInteger(process.env.PLAYWRIGHT_TOOLKIT_CLOAK_POSTINSTALL_RETRIES, 4);
+    const baseDelayMs = toPositiveInteger(process.env.PLAYWRIGHT_TOOLKIT_CLOAK_POSTINSTALL_RETRY_DELAY_MS, 15000);
+    let lastError = null;
+
+    for (let attempt = 1; attempt <= attempts; attempt += 1) {
+        try {
+            return await cloakModule.ensureBinary();
+        } catch (error) {
+            lastError = error;
+            if (isBinaryReady(expectedBinaryPath)) {
+                warn(`ensureBinary failed after installing the expected binary; continuing with ${expectedBinaryPath}.`);
+                return expectedBinaryPath;
+            }
+            if (attempt >= attempts) {
+                break;
+            }
+            const delayMs = baseDelayMs * attempt;
+            warn(
+                `cloakbrowser install attempt ${attempt}/${attempts} failed: ${error?.message || String(error)}. `
+                + `Retrying in ${delayMs}ms.`,
+            );
+            await sleep(delayMs);
+        }
+    }
+
+    throw lastError;
+};
+
 const main = async () => {
     if (isTruthy(process.env[SKIP_ENV])) {
         log(`Skipped because ${SKIP_ENV} is set.`);
@@ -178,7 +214,10 @@ const main = async () => {
     }
 
     log(`Installing cloakbrowser ${expectedVersion} for ${platformTag}...`);
-    const resolvedBinaryPath = await cloakModule.ensureBinary();
+    const resolvedBinaryPath = await ensureBinaryWithRetries({
+        cloakModule,
+        expectedBinaryPath,
+    });
 
     if (!isBinaryReady(expectedBinaryPath)) {
         throw new Error(