@letsscrapedata/controller 0.0.28 → 0.0.29

package/dist/index.cjs

@@ -17190,6 +17190,9 @@ var import_os = __toESM(require("os"), 1);
 var import_puppeteer = __toESM(require("puppeteer"), 1);
 var import_playwright = __toESM(require("playwright"), 1);
 var import_utils15 = require("@letsscrapedata/utils");
+var import_puppeteer_extra = __toESM(require("puppeteer-extra"), 1);
+var playwrightExtra = __toESM(require("playwright-extra"), 1);
+var import_puppeteer_extra_plugin_stealth = __toESM(require("puppeteer-extra-plugin-stealth"), 1);
 var LsdBrowserController = class _LsdBrowserController {
   static #forbidConstructor = false;
   #puppeteer;
@@ -17204,8 +17207,8 @@ var LsdBrowserController = class _LsdBrowserController {
       throw new Error("Only one LsdBrowserController instance can be created!");
     }
     this.#puppeteer = import_puppeteer.default;
-    const { chromium, firefox, webkit } = import_playwright.default;
-    this.#playwrightBrowserTypes = { chromium, firefox, webkit };
+    const { chromium: chromium2, firefox: firefox2, webkit: webkit2 } = import_playwright.default;
+    this.#playwrightBrowserTypes = { chromium: chromium2, firefox: firefox2, webkit: webkit2 };
     this.#osPlatform = import_os.default.platform();
     this.#nextBrowserIdx = 1;
     _LsdBrowserController.#forbidConstructor = true;
@@ -17231,19 +17234,35 @@ var LsdBrowserController = class _LsdBrowserController {
     }
   }
   setPuppeteerNode(puppeteer2) {
-    this.#puppeteer = puppeteer2;
+    if (puppeteer2) {
+      this.#puppeteer = puppeteer2;
+    } else {
+      this.#puppeteer = import_puppeteer_extra.default.use((0, import_puppeteer_extra_plugin_stealth.default)());
+    }
     return true;
   }
   setPlaywrightBrowserType(browserType, playwrightBrowserType) {
     switch (browserType) {
       case "chromium":
-        this.#playwrightBrowserTypes.chromium = playwrightBrowserType;
+        if (playwrightBrowserType) {
+          this.#playwrightBrowserTypes.chromium = playwrightBrowserType;
+        } else {
+          this.#playwrightBrowserTypes.chromium = playwrightExtra.chromium.use((0, import_puppeteer_extra_plugin_stealth.default)());
+        }
         break;
       case "firefox":
-        this.#playwrightBrowserTypes.firefox = playwrightBrowserType;
+        if (playwrightBrowserType) {
+          this.#playwrightBrowserTypes.firefox = playwrightBrowserType;
+        } else {
+          this.#playwrightBrowserTypes.firefox = playwrightExtra.firefox.use((0, import_puppeteer_extra_plugin_stealth.default)());
+        }
         break;
       case "webkit":
-        this.#playwrightBrowserTypes.webkit = playwrightBrowserType;
+        if (playwrightBrowserType) {
+          this.#playwrightBrowserTypes.webkit = playwrightBrowserType;
+        } else {
+          this.#playwrightBrowserTypes.webkit = playwrightExtra.webkit.use((0, import_puppeteer_extra_plugin_stealth.default)());
+        }
         break;
       default:
         (0, import_utils15.unreachable)(browserType);

package/dist/index.d.cts

@@ -936,10 +936,30 @@ interface LsdBrowser extends EventEmitter {
     _origBrowserContexts(): AllBrowserContext[];
 }
 interface LsdBrowserController$1 {
+    /**
+     * launch a new browser using related browser controller
+     * @param browserControllerType
+     * @param browserType
+     * @param options
+     */
     launch(browserControllerType: BrowserControllerType, browserType: LsdBrowserType, options?: LsdLaunchOptions): Promise<LsdBrowser>;
+    /**
+     * connect to the current browser using related browser controller
+     * @param browserControllerType
+     * @param browserType
+     * @param options
+     */
     connect(browserControllerType: BrowserControllerType, browserType: LsdBrowserType, options?: LsdConnectOptions): Promise<LsdBrowser>;
-    setPuppeteerNode(puppeteer: PuppeteerNode): boolean;
-    setPlaywrightBrowserType(browserType: LsdBrowserType, playwrightBrowserType: BrowserType): boolean;
+    /**
+     *
+     * @param puppeteer  null means use puppeteer-extra-plugin-stealth based on puppeteer-extra
+     */
+    setPuppeteerNode(puppeteer: PuppeteerNode | null): boolean;
+    /**
+     *
+     * @param puppeteer  null means use puppeteer-extra-plugin-stealth based on playwright-extra
+     */
+    setPlaywrightBrowserType(browserType: LsdBrowserType, playwrightBrowserType: BrowserType | null): boolean;
 }
 /**
  * globObj.cfg.XXX:
@@ -1265,8 +1285,8 @@ declare class CheerioElement implements LsdElement {
 declare class LsdBrowserController implements LsdBrowserController$1 {
     #private;
     constructor();
-    setPuppeteerNode(puppeteer: PuppeteerNode): boolean;
-    setPlaywrightBrowserType(browserType: LsdBrowserType, playwrightBrowserType: BrowserType): boolean;
+    setPuppeteerNode(puppeteer: PuppeteerNode | null): boolean;
+    setPlaywrightBrowserType(browserType: LsdBrowserType, playwrightBrowserType: BrowserType | null): boolean;
     launch(browserControllerType: BrowserControllerType, browserType: LsdBrowserType, options: LsdLaunchOptions): Promise<LsdBrowser>;
     connect(browserControllerType: BrowserControllerType, browserType: LsdBrowserType, options: LsdConnectOptions): Promise<LsdBrowser>;
 }

package/dist/index.d.ts

@@ -936,10 +936,30 @@ interface LsdBrowser extends EventEmitter {
     _origBrowserContexts(): AllBrowserContext[];
 }
 interface LsdBrowserController$1 {
+    /**
+     * launch a new browser using related browser controller
+     * @param browserControllerType
+     * @param browserType
+     * @param options
+     */
     launch(browserControllerType: BrowserControllerType, browserType: LsdBrowserType, options?: LsdLaunchOptions): Promise<LsdBrowser>;
+    /**
+     * connect to the current browser using related browser controller
+     * @param browserControllerType
+     * @param browserType
+     * @param options
+     */
     connect(browserControllerType: BrowserControllerType, browserType: LsdBrowserType, options?: LsdConnectOptions): Promise<LsdBrowser>;
-    setPuppeteerNode(puppeteer: PuppeteerNode): boolean;
-    setPlaywrightBrowserType(browserType: LsdBrowserType, playwrightBrowserType: BrowserType): boolean;
+    /**
+     *
+     * @param puppeteer  null means use puppeteer-extra-plugin-stealth based on puppeteer-extra
+     */
+    setPuppeteerNode(puppeteer: PuppeteerNode | null): boolean;
+    /**
+     *
+     * @param puppeteer  null means use puppeteer-extra-plugin-stealth based on playwright-extra
+     */
+    setPlaywrightBrowserType(browserType: LsdBrowserType, playwrightBrowserType: BrowserType | null): boolean;
 }
 /**
  * globObj.cfg.XXX:
@@ -1265,8 +1285,8 @@ declare class CheerioElement implements LsdElement {
 declare class LsdBrowserController implements LsdBrowserController$1 {
     #private;
     constructor();
-    setPuppeteerNode(puppeteer: PuppeteerNode): boolean;
-    setPlaywrightBrowserType(browserType: LsdBrowserType, playwrightBrowserType: BrowserType): boolean;
+    setPuppeteerNode(puppeteer: PuppeteerNode | null): boolean;
+    setPlaywrightBrowserType(browserType: LsdBrowserType, playwrightBrowserType: BrowserType | null): boolean;
     launch(browserControllerType: BrowserControllerType, browserType: LsdBrowserType, options: LsdLaunchOptions): Promise<LsdBrowser>;
     connect(browserControllerType: BrowserControllerType, browserType: LsdBrowserType, options: LsdConnectOptions): Promise<LsdBrowser>;
 }

package/dist/index.js

@@ -17170,6 +17170,9 @@ import os from "os";
 import puppeteer from "puppeteer";
 import playwright from "playwright";
 import { logwarn as logwarn6, unreachable as unreachable5 } from "@letsscrapedata/utils";
+import puppeteerExtra from "puppeteer-extra";
+import * as playwrightExtra from "playwright-extra";
+import StealthPlugin from "puppeteer-extra-plugin-stealth";
 var LsdBrowserController = class _LsdBrowserController {
   static #forbidConstructor = false;
   #puppeteer;
@@ -17184,8 +17187,8 @@ var LsdBrowserController = class _LsdBrowserController {
       throw new Error("Only one LsdBrowserController instance can be created!");
     }
     this.#puppeteer = puppeteer;
-    const { chromium, firefox, webkit } = playwright;
-    this.#playwrightBrowserTypes = { chromium, firefox, webkit };
+    const { chromium: chromium2, firefox: firefox2, webkit: webkit2 } = playwright;
+    this.#playwrightBrowserTypes = { chromium: chromium2, firefox: firefox2, webkit: webkit2 };
     this.#osPlatform = os.platform();
     this.#nextBrowserIdx = 1;
     _LsdBrowserController.#forbidConstructor = true;
@@ -17211,19 +17214,35 @@ var LsdBrowserController = class _LsdBrowserController {
     }
   }
   setPuppeteerNode(puppeteer2) {
-    this.#puppeteer = puppeteer2;
+    if (puppeteer2) {
+      this.#puppeteer = puppeteer2;
+    } else {
+      this.#puppeteer = puppeteerExtra.use(StealthPlugin());
+    }
     return true;
   }
   setPlaywrightBrowserType(browserType, playwrightBrowserType) {
     switch (browserType) {
       case "chromium":
-        this.#playwrightBrowserTypes.chromium = playwrightBrowserType;
+        if (playwrightBrowserType) {
+          this.#playwrightBrowserTypes.chromium = playwrightBrowserType;
+        } else {
+          this.#playwrightBrowserTypes.chromium = playwrightExtra.chromium.use(StealthPlugin());
+        }
         break;
       case "firefox":
-        this.#playwrightBrowserTypes.firefox = playwrightBrowserType;
+        if (playwrightBrowserType) {
+          this.#playwrightBrowserTypes.firefox = playwrightBrowserType;
+        } else {
+          this.#playwrightBrowserTypes.firefox = playwrightExtra.firefox.use(StealthPlugin());
+        }
         break;
       case "webkit":
-        this.#playwrightBrowserTypes.webkit = playwrightBrowserType;
+        if (playwrightBrowserType) {
+          this.#playwrightBrowserTypes.webkit = playwrightBrowserType;
+        } else {
+          this.#playwrightBrowserTypes.webkit = playwrightExtra.webkit.use(StealthPlugin());
+        }
         break;
       default:
         unreachable5(browserType);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letsscrapedata/controller",
-  "version": "0.0.28",
+  "version": "0.0.29",
   "description": "Unified browser / HTML controller interfaces that support playwright, puppeteer and cheerio",
   "type": "module",
   "main": "./dist/index.mjs",
@@ -36,7 +36,10 @@
   "dependencies": {
     "@letsscrapedata/utils": "^0.0.7",
     "playwright": "^1.43.0",
-    "puppeteer": "^22.6.3"
+    "playwright-extra": "^4.3.6",
+    "puppeteer": "^22.6.3",
+    "puppeteer-extra": "^3.3.6",
+    "puppeteer-extra-plugin-stealth": "^2.11.2"
   },
   "devDependencies": {
     "tsup": "^8.0.2"