@hanivanrizky/nestjs-browser-action 0.21.0 → 0.23.0

package/dist/utils/browser-launcher.d.ts

@@ -0,0 +1,6 @@
+import type { Browser } from 'puppeteer-core';
+import type { BrowserActionOptions, CloakOptions, RemoteOptions } from '../interfaces/browser-action-options';
+import { LoggerWithLevel } from './logger.util';
+export declare function validateRemoteOptions(remote?: RemoteOptions): void;
+export declare function launchLocalBrowser(base: BrowserActionOptions, cloakOverride?: CloakOptions, logger?: LoggerWithLevel): Promise<Browser>;
+export declare function connectRemoteBrowser(remote: RemoteOptions, logger?: LoggerWithLevel): Promise<Browser>;

package/dist/utils/browser-launcher.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateRemoteOptions = validateRemoteOptions;
+exports.launchLocalBrowser = launchLocalBrowser;
+exports.connectRemoteBrowser = connectRemoteBrowser;
+const puppeteer_core_1 = require("puppeteer-core");
+const browser_action_constants_1 = require("../constants/browser-action.constants");
+const cloak_loader_1 = require("./cloak.loader");
+const delay_util_1 = require("./delay.util");
+const BLOCKED_CHROMIUM_FLAGS = new Set([
+    '--remote-debugging-port',
+    '--remote-allow-origins',
+    '--load-extension',
+    '--disable-web-security',
+    '--no-sandbox',
+    '--disable-features=IsolateOrigins',
+    '--disable-site-isolation-trials',
+    '--allow-running-insecure-content',
+    '--reduce-security-for-testing',
+    '--disable-setuid-sandbox',
+    '--single-process',
+    '--no-zygote',
+]);
+function validateRemoteOptions(remote) {
+    if (!remote)
+        return;
+    const hasURL = !!remote.browserURL;
+    const hasWSEndpoint = !!remote.browserWSEndpoint;
+    if (hasURL && hasWSEndpoint) {
+        throw new Error(browser_action_constants_1.ERROR_MESSAGES.REMOTE_BOTH_PROVIDED);
+    }
+    if (!hasURL && !hasWSEndpoint) {
+        throw new Error(browser_action_constants_1.ERROR_MESSAGES.REMOTE_NONE_PROVIDED);
+    }
+}
+function warnOnDangerousFlags(args, logger) {
+    if (!args)
+        return;
+    for (const arg of args) {
+        const flagName = arg.split('=')[0];
+        if (BLOCKED_CHROMIUM_FLAGS.has(flagName)) {
+            logger?.warn(`Potentially dangerous Chromium flag detected: ${flagName}. ` +
+                `Only use this flag if you understand the security implications.`);
+        }
+    }
+}
+async function launchLocalBrowser(base, cloakOverride, logger) {
+    const { launch, launchPersistentContext } = await (0, cloak_loader_1.loadCloakPuppeteer)();
+    const cloak = {
+        ...(base.cloak ?? {}),
+        ...(cloakOverride ?? {}),
+    };
+    const headless = base.launchOptions?.headless ?? cloak.headless;
+    const launchOptions = {
+        ...(cloak.launchOptions ?? {}),
+        ...base.launchOptions,
+    };
+    if (Array.isArray(launchOptions.args)) {
+        warnOnDangerousFlags(launchOptions.args, logger);
+    }
+    const cloakOptions = {
+        ...cloak,
+        ...(typeof headless === 'boolean' ? { headless } : {}),
+        launchOptions,
+    };
+    return cloak.userDataDir
+        ? await launchPersistentContext({
+            ...cloakOptions,
+            userDataDir: cloak.userDataDir,
+        })
+        : await launch(cloakOptions);
+}
+async function connectRemoteBrowser(remote, logger) {
+    const { browserURL, browserWSEndpoint, retryMax = browser_action_constants_1.DEFAULT_REMOTE_OPTIONS.retryMax, retryDelay = browser_action_constants_1.DEFAULT_REMOTE_OPTIONS.retryDelay, } = remote;
+    const connectOptions = {};
+    if (browserURL) {
+        connectOptions.browserURL = browserURL;
+    }
+    else if (browserWSEndpoint) {
+        connectOptions.browserWSEndpoint = browserWSEndpoint;
+    }
+    let lastError;
+    for (let attempt = 1; attempt <= retryMax; attempt++) {
+        try {
+            logger?.debug(`Connecting to remote Chrome (attempt ${attempt}/${retryMax})`);
+            const browser = await (0, puppeteer_core_1.connect)(connectOptions);
+            logger?.debug('Successfully connected to remote Chrome');
+            return browser;
+        }
+        catch (error) {
+            lastError = error;
+            logger?.warn(`Connection attempt ${attempt}/${retryMax} failed: ${lastError.message}`);
+            if (attempt < retryMax) {
+                await (0, delay_util_1.delay)(retryDelay);
+            }
+        }
+    }
+    throw new Error(`Failed to connect to remote Chrome after ${retryMax} attempts: ${lastError?.message}`);
+}
+//# sourceMappingURL=browser-launcher.js.map

package/dist/utils/browser-launcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-launcher.js","sourceRoot":"","sources":["../../src/utils/browser-launcher.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanivanrizky/nestjs-browser-action",
-  "version": "0.21.0",
+  "version": "0.23.0",
   "description": "Stealth browser automation module for NestJS (CloakBrowser + puppeteer-core)",
   "author": "Hanivan Rizky S <hanivan20@gmail.com> (https://www.hanivan.my.id)",
   "license": "MIT",
@@ -69,7 +69,7 @@
   "dependencies": {
     "class-transformer": "^0.5.1",
     "class-validator": "^0.15.1",
-    "cloakbrowser": "^0.4.4",
+    "cloakbrowser": "^0.4.5",
     "html-entities": "^2.6.0",
     "jsonpath-plus": "^10.4.0",
     "libxmljs2": "^0.37.0",