@letsscrapedata/controller 0.0.27 → 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,10 +17234,40 @@ 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;
   }
-  setPlaywrightBrowserTypes(playwrightBrowserTypes) {
-    this.#playwrightBrowserTypes = playwrightBrowserTypes;
+  setPlaywrightBrowserType(browserType, playwrightBrowserType) {
+    switch (browserType) {
+      case "chromium":
+        if (playwrightBrowserType) {
+          this.#playwrightBrowserTypes.chromium = playwrightBrowserType;
+        } else {
+          this.#playwrightBrowserTypes.chromium = playwrightExtra.chromium.use((0, import_puppeteer_extra_plugin_stealth.default)());
+        }
+        break;
+      case "firefox":
+        if (playwrightBrowserType) {
+          this.#playwrightBrowserTypes.firefox = playwrightBrowserType;
+        } else {
+          this.#playwrightBrowserTypes.firefox = playwrightExtra.firefox.use((0, import_puppeteer_extra_plugin_stealth.default)());
+        }
+        break;
+      case "webkit":
+        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);
+    }
+    return true;
   }
   async launch(browserControllerType, browserType, options) {
     let {

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import EventEmitter from 'node:events';
-import { Browser as Browser$1, BrowserContext as BrowserContext$1, Frame as Frame$1, Page as Page$1, HTTPResponse, ElementHandle, PuppeteerNode } from 'puppeteer';
+import { Browser as Browser$1, BrowserContext as BrowserContext$1, Frame as Frame$1, Page as Page$1, HTTPResponse, PuppeteerNode, ElementHandle } from 'puppeteer';
 import { Browser, BrowserContext, Frame, Page, Response, BrowserType, Locator } from 'playwright';
 import * as cheerio from 'cheerio';
 
@@ -936,8 +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>;
+    /**
+     *
+     * @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:
@@ -1263,8 +1285,8 @@ declare class CheerioElement implements LsdElement {
 declare class LsdBrowserController implements LsdBrowserController$1 {
     #private;
     constructor();
-    setPuppeteerNode(puppeteer: PuppeteerNode): void;
-    setPlaywrightBrowserTypes(playwrightBrowserTypes: PlaywrightBrowserTypes): void;
+    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

@@ -1,5 +1,5 @@
 import EventEmitter from 'node:events';
-import { Browser as Browser$1, BrowserContext as BrowserContext$1, Frame as Frame$1, Page as Page$1, HTTPResponse, ElementHandle, PuppeteerNode } from 'puppeteer';
+import { Browser as Browser$1, BrowserContext as BrowserContext$1, Frame as Frame$1, Page as Page$1, HTTPResponse, PuppeteerNode, ElementHandle } from 'puppeteer';
 import { Browser, BrowserContext, Frame, Page, Response, BrowserType, Locator } from 'playwright';
 import * as cheerio from 'cheerio';
 
@@ -936,8 +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>;
+    /**
+     *
+     * @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:
@@ -1263,8 +1285,8 @@ declare class CheerioElement implements LsdElement {
 declare class LsdBrowserController implements LsdBrowserController$1 {
     #private;
     constructor();
-    setPuppeteerNode(puppeteer: PuppeteerNode): void;
-    setPlaywrightBrowserTypes(playwrightBrowserTypes: PlaywrightBrowserTypes): void;
+    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

@@ -17169,7 +17169,10 @@ var CheerioPage = class extends EventEmitter7 {
 import os from "os";
 import puppeteer from "puppeteer";
 import playwright from "playwright";
-import { logwarn as logwarn6 } from "@letsscrapedata/utils";
+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,10 +17214,40 @@ var LsdBrowserController = class _LsdBrowserController {
     }
   }
   setPuppeteerNode(puppeteer2) {
-    this.#puppeteer = puppeteer2;
+    if (puppeteer2) {
+      this.#puppeteer = puppeteer2;
+    } else {
+      this.#puppeteer = puppeteerExtra.use(StealthPlugin());
+    }
+    return true;
   }
-  setPlaywrightBrowserTypes(playwrightBrowserTypes) {
-    this.#playwrightBrowserTypes = playwrightBrowserTypes;
+  setPlaywrightBrowserType(browserType, playwrightBrowserType) {
+    switch (browserType) {
+      case "chromium":
+        if (playwrightBrowserType) {
+          this.#playwrightBrowserTypes.chromium = playwrightBrowserType;
+        } else {
+          this.#playwrightBrowserTypes.chromium = playwrightExtra.chromium.use(StealthPlugin());
+        }
+        break;
+      case "firefox":
+        if (playwrightBrowserType) {
+          this.#playwrightBrowserTypes.firefox = playwrightBrowserType;
+        } else {
+          this.#playwrightBrowserTypes.firefox = playwrightExtra.firefox.use(StealthPlugin());
+        }
+        break;
+      case "webkit":
+        if (playwrightBrowserType) {
+          this.#playwrightBrowserTypes.webkit = playwrightBrowserType;
+        } else {
+          this.#playwrightBrowserTypes.webkit = playwrightExtra.webkit.use(StealthPlugin());
+        }
+        break;
+      default:
+        unreachable5(browserType);
+    }
+    return true;
   }
   async launch(browserControllerType, browserType, options) {
     let {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letsscrapedata/controller",
-  "version": "0.0.27",
+  "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"