@letsscrapedata/controller 0.0.28 → 0.0.30

package/dist/index.cjs

@@ -545,6 +545,11 @@ var PlaywrightPage = class extends import_node_events.default {
     this.#responseCb = null;
     this.#addPageOn();
   }
+  apiRequestContext() {
+    const origBrowserContext = this.browserContext()._origBrowserContext();
+    const apiRequestContext = origBrowserContext.request;
+    return apiRequestContext;
+  }
   async bringToFront() {
     if (!this.#page) {
       throw new Error("No valid page");
@@ -2026,6 +2031,9 @@ var PuppeteerPage = class extends import_node_events4.default {
     this.#client = null;
     this.#addPageOn();
   }
+  apiRequestContext() {
+    throw new Error("Not supported in PuppeteerPage.");
+  }
   async bringToFront() {
     if (!this.#page) {
       throw new Error("No valid page");
@@ -17008,6 +17016,9 @@ var CheerioPage = class extends import_node_events7.default {
       this.#document = load(html3, { xml: true }).root();
     }
   }
+  apiRequestContext() {
+    throw new Error("Not supported in CheerioPage.");
+  }
   async bringToFront() {
     throw new Error("Not supported in CheerioPage.");
   }
@@ -17190,6 +17201,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 +17218,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 +17245,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);
@@ -17331,6 +17361,9 @@ var LsdBrowserController = class _LsdBrowserController {
         args.push("--start-maximized");
         launchOptions.defaultViewport = null;
       }
+      if (!args.includes("--no-sandbox")) {
+        args.push("--no-sandbox");
+      }
       if (browserType === "chromium") {
         if (incognito) {
           args.push("--incognito");
@@ -17393,6 +17426,10 @@ var LsdBrowserController = class _LsdBrowserController {
       throw new Error(`Invalid browserControllerType: ${browserControllerType} in connect`);
     }
   }
+  async newApiRequestContext(options) {
+    const apiRequestContext = await import_playwright.request.newContext(options);
+    return apiRequestContext;
+  }
 };
 var controller = new LsdBrowserController();
 // Annotate the CommonJS export names for ESM import in node:

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import EventEmitter from 'node:events';
 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 { Browser, BrowserContext, Frame, Page, Response, APIRequestContext, BrowserType, Locator } from 'playwright';
 import * as cheerio from 'cheerio';
 
 /**
@@ -15,6 +15,7 @@ type AllBrowserContext = BrowserContext | BrowserContext$1;
 type AllFrame = Frame | Frame$1;
 type AllPage = Page | Page$1;
 type AllResponse = Response | HTTPResponse;
+type AllApiRequestContext = APIRequestContext;
 type CheerioNode = cheerio.Cheerio<cheerio.Element>;
 type Proxy = {
     server: string;
@@ -772,6 +773,11 @@ interface WaitNavigationOptions {
 }
 type PageEvent = "pageClose" | "pagePopup";
 interface LsdPage extends EventEmitter {
+    /**
+     * Get the APIRequestContext associated with this page's browser context.
+     * * only vaild in playwright
+     */
+    apiRequestContext(): AllApiRequestContext;
     bringToFront(): Promise<boolean>;
     browserContext(): LsdBrowserContext;
     clearCookies(): Promise<boolean>;
@@ -918,7 +924,7 @@ interface LsdBrowserContext extends EventEmitter {
     pages(): LsdPage[];
     proxy(): Proxy | null;
     setStateData(stateData: StateData): Promise<boolean>;
-    _origBrowserContext(): AllBrowserContext | null;
+    _origBrowserContext(): AllBrowserContext;
 }
 interface LsdBrowser extends EventEmitter {
     newBrowserContext(options?: LsdBrowserContextOptions): Promise<LsdBrowserContext | null>;
@@ -936,10 +942,34 @@ 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;
+    /**
+     * Create a new APIRequestContext, valid in playwright;
+     */
+    newApiRequestContext(options?: any): Promise<AllApiRequestContext>;
 }
 /**
  * globObj.cfg.XXX:
@@ -1001,12 +1031,13 @@ declare class PlaywrightBrowserContext extends EventEmitter implements LsdBrowse
     pages(): LsdPage[];
     proxy(): Proxy | null;
     setStateData(stateData: StateData): Promise<boolean>;
-    _origBrowserContext(): AllBrowserContext | null;
+    _origBrowserContext(): AllBrowserContext;
 }
 
 declare class PlaywrightPage extends EventEmitter implements LsdPage {
     #private;
     constructor(browserContext: LsdBrowserContext, page: Page, pageInfo?: PageInfo);
+    apiRequestContext(): APIRequestContext;
     bringToFront(): Promise<boolean>;
     browserContext(): LsdBrowserContext;
     clearCookies(): Promise<boolean>;
@@ -1109,12 +1140,13 @@ declare class PuppeteerBrowserContext extends EventEmitter implements LsdBrowser
     pages(): LsdPage[];
     proxy(): Proxy | null;
     setStateData(stateData: StateData): Promise<boolean>;
-    _origBrowserContext(): AllBrowserContext | null;
+    _origBrowserContext(): AllBrowserContext;
 }
 
 declare class PuppeteerPage extends EventEmitter implements LsdPage {
     #private;
     constructor(browserContext: LsdBrowserContext, page: Page$1, pageInfo?: PageInfo);
+    apiRequestContext(): APIRequestContext;
     bringToFront(): Promise<boolean>;
     browserContext(): LsdBrowserContext;
     clearCookies(): Promise<boolean>;
@@ -1193,6 +1225,7 @@ declare class CheerioPage extends EventEmitter implements LsdPage {
      * @param isHtml  default true
      */
     constructor(html?: string, isHtml?: boolean);
+    apiRequestContext(): APIRequestContext;
     bringToFront(): Promise<boolean>;
     browserContext(): LsdBrowserContext;
     clearCookies(): Promise<boolean>;
@@ -1265,11 +1298,12 @@ 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>;
+    newApiRequestContext(options?: any): Promise<AllApiRequestContext>;
 }
 declare const controller: LsdBrowserController;
 
-export { type AllBrowser, type AllBrowserContext, type AllFrame, type AllPage, type AllResponse, type BrowserControllerOptions, type BrowserControllerType, type BrowserCreationMethod, type BrowserManager, CheerioElement, type CheerioNode, CheerioPage, type CookieItem, type GotoOptions, type IframeOption, type InputOptions, type KeyInput, type KeyPressOptions, type LocalStorageItem, type LocalStorageOrigin, type LowerCasePaperFormat, type LsdBrowser, type LsdBrowserContext, type LsdBrowserContextOptions, type LsdBrowserController$1 as LsdBrowserController, type LsdBrowserType, type LsdConnectOptions, type LsdElement, type LsdLaunchOptions, type LsdPage, type MouseClickOptions, type MouseClickType, type NavigationWaitUntil, type PDFMargin, type PDFOptions, type PageEvent, type PageExtInPlaywright, type PageExtInPuppeteer, type PageInfo, type PageOpenType, type PageStatus, type PaperFormat, PlaywrightBrowser, PlaywrightBrowserContext, type PlaywrightBrowserTypes, PlaywrightElement, PlaywrightPage, type Proxy, PuppeteerBrowser, PuppeteerBrowserContext, PuppeteerElement, PuppeteerPage, type RequestInterceptionAction, type RequestInterceptionOption, type RequestMatch, type RequestMethod, type RequestResourceType, type ResponseHandler, type ResponseHandlerOptions, type ResponseInterceptionItem, type ResponseInterceptionOption, type ResponseMatch, type ScreenshotOptions, type SelectOptions, type StateData, type UpdatablePageInfo, type ViewportSize, type WaitElementOptions, type WaitElementState, type WaitNavigationOptions, controller, defaultProxy };
+export { type AllApiRequestContext, type AllBrowser, type AllBrowserContext, type AllFrame, type AllPage, type AllResponse, type BrowserControllerOptions, type BrowserControllerType, type BrowserCreationMethod, type BrowserManager, CheerioElement, type CheerioNode, CheerioPage, type CookieItem, type GotoOptions, type IframeOption, type InputOptions, type KeyInput, type KeyPressOptions, type LocalStorageItem, type LocalStorageOrigin, type LowerCasePaperFormat, type LsdBrowser, type LsdBrowserContext, type LsdBrowserContextOptions, type LsdBrowserController$1 as LsdBrowserController, type LsdBrowserType, type LsdConnectOptions, type LsdElement, type LsdLaunchOptions, type LsdPage, type MouseClickOptions, type MouseClickType, type NavigationWaitUntil, type PDFMargin, type PDFOptions, type PageEvent, type PageExtInPlaywright, type PageExtInPuppeteer, type PageInfo, type PageOpenType, type PageStatus, type PaperFormat, PlaywrightBrowser, PlaywrightBrowserContext, type PlaywrightBrowserTypes, PlaywrightElement, PlaywrightPage, type Proxy, PuppeteerBrowser, PuppeteerBrowserContext, PuppeteerElement, PuppeteerPage, type RequestInterceptionAction, type RequestInterceptionOption, type RequestMatch, type RequestMethod, type RequestResourceType, type ResponseHandler, type ResponseHandlerOptions, type ResponseInterceptionItem, type ResponseInterceptionOption, type ResponseMatch, type ScreenshotOptions, type SelectOptions, type StateData, type UpdatablePageInfo, type ViewportSize, type WaitElementOptions, type WaitElementState, type WaitNavigationOptions, controller, defaultProxy };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import EventEmitter from 'node:events';
 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 { Browser, BrowserContext, Frame, Page, Response, APIRequestContext, BrowserType, Locator } from 'playwright';
 import * as cheerio from 'cheerio';
 
 /**
@@ -15,6 +15,7 @@ type AllBrowserContext = BrowserContext | BrowserContext$1;
 type AllFrame = Frame | Frame$1;
 type AllPage = Page | Page$1;
 type AllResponse = Response | HTTPResponse;
+type AllApiRequestContext = APIRequestContext;
 type CheerioNode = cheerio.Cheerio<cheerio.Element>;
 type Proxy = {
     server: string;
@@ -772,6 +773,11 @@ interface WaitNavigationOptions {
 }
 type PageEvent = "pageClose" | "pagePopup";
 interface LsdPage extends EventEmitter {
+    /**
+     * Get the APIRequestContext associated with this page's browser context.
+     * * only vaild in playwright
+     */
+    apiRequestContext(): AllApiRequestContext;
     bringToFront(): Promise<boolean>;
     browserContext(): LsdBrowserContext;
     clearCookies(): Promise<boolean>;
@@ -918,7 +924,7 @@ interface LsdBrowserContext extends EventEmitter {
     pages(): LsdPage[];
     proxy(): Proxy | null;
     setStateData(stateData: StateData): Promise<boolean>;
-    _origBrowserContext(): AllBrowserContext | null;
+    _origBrowserContext(): AllBrowserContext;
 }
 interface LsdBrowser extends EventEmitter {
     newBrowserContext(options?: LsdBrowserContextOptions): Promise<LsdBrowserContext | null>;
@@ -936,10 +942,34 @@ 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;
+    /**
+     * Create a new APIRequestContext, valid in playwright;
+     */
+    newApiRequestContext(options?: any): Promise<AllApiRequestContext>;
 }
 /**
  * globObj.cfg.XXX:
@@ -1001,12 +1031,13 @@ declare class PlaywrightBrowserContext extends EventEmitter implements LsdBrowse
     pages(): LsdPage[];
     proxy(): Proxy | null;
     setStateData(stateData: StateData): Promise<boolean>;
-    _origBrowserContext(): AllBrowserContext | null;
+    _origBrowserContext(): AllBrowserContext;
 }
 
 declare class PlaywrightPage extends EventEmitter implements LsdPage {
     #private;
     constructor(browserContext: LsdBrowserContext, page: Page, pageInfo?: PageInfo);
+    apiRequestContext(): APIRequestContext;
     bringToFront(): Promise<boolean>;
     browserContext(): LsdBrowserContext;
     clearCookies(): Promise<boolean>;
@@ -1109,12 +1140,13 @@ declare class PuppeteerBrowserContext extends EventEmitter implements LsdBrowser
     pages(): LsdPage[];
     proxy(): Proxy | null;
     setStateData(stateData: StateData): Promise<boolean>;
-    _origBrowserContext(): AllBrowserContext | null;
+    _origBrowserContext(): AllBrowserContext;
 }
 
 declare class PuppeteerPage extends EventEmitter implements LsdPage {
     #private;
     constructor(browserContext: LsdBrowserContext, page: Page$1, pageInfo?: PageInfo);
+    apiRequestContext(): APIRequestContext;
     bringToFront(): Promise<boolean>;
     browserContext(): LsdBrowserContext;
     clearCookies(): Promise<boolean>;
@@ -1193,6 +1225,7 @@ declare class CheerioPage extends EventEmitter implements LsdPage {
      * @param isHtml  default true
      */
     constructor(html?: string, isHtml?: boolean);
+    apiRequestContext(): APIRequestContext;
     bringToFront(): Promise<boolean>;
     browserContext(): LsdBrowserContext;
     clearCookies(): Promise<boolean>;
@@ -1265,11 +1298,12 @@ 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>;
+    newApiRequestContext(options?: any): Promise<AllApiRequestContext>;
 }
 declare const controller: LsdBrowserController;
 
-export { type AllBrowser, type AllBrowserContext, type AllFrame, type AllPage, type AllResponse, type BrowserControllerOptions, type BrowserControllerType, type BrowserCreationMethod, type BrowserManager, CheerioElement, type CheerioNode, CheerioPage, type CookieItem, type GotoOptions, type IframeOption, type InputOptions, type KeyInput, type KeyPressOptions, type LocalStorageItem, type LocalStorageOrigin, type LowerCasePaperFormat, type LsdBrowser, type LsdBrowserContext, type LsdBrowserContextOptions, type LsdBrowserController$1 as LsdBrowserController, type LsdBrowserType, type LsdConnectOptions, type LsdElement, type LsdLaunchOptions, type LsdPage, type MouseClickOptions, type MouseClickType, type NavigationWaitUntil, type PDFMargin, type PDFOptions, type PageEvent, type PageExtInPlaywright, type PageExtInPuppeteer, type PageInfo, type PageOpenType, type PageStatus, type PaperFormat, PlaywrightBrowser, PlaywrightBrowserContext, type PlaywrightBrowserTypes, PlaywrightElement, PlaywrightPage, type Proxy, PuppeteerBrowser, PuppeteerBrowserContext, PuppeteerElement, PuppeteerPage, type RequestInterceptionAction, type RequestInterceptionOption, type RequestMatch, type RequestMethod, type RequestResourceType, type ResponseHandler, type ResponseHandlerOptions, type ResponseInterceptionItem, type ResponseInterceptionOption, type ResponseMatch, type ScreenshotOptions, type SelectOptions, type StateData, type UpdatablePageInfo, type ViewportSize, type WaitElementOptions, type WaitElementState, type WaitNavigationOptions, controller, defaultProxy };
+export { type AllApiRequestContext, type AllBrowser, type AllBrowserContext, type AllFrame, type AllPage, type AllResponse, type BrowserControllerOptions, type BrowserControllerType, type BrowserCreationMethod, type BrowserManager, CheerioElement, type CheerioNode, CheerioPage, type CookieItem, type GotoOptions, type IframeOption, type InputOptions, type KeyInput, type KeyPressOptions, type LocalStorageItem, type LocalStorageOrigin, type LowerCasePaperFormat, type LsdBrowser, type LsdBrowserContext, type LsdBrowserContextOptions, type LsdBrowserController$1 as LsdBrowserController, type LsdBrowserType, type LsdConnectOptions, type LsdElement, type LsdLaunchOptions, type LsdPage, type MouseClickOptions, type MouseClickType, type NavigationWaitUntil, type PDFMargin, type PDFOptions, type PageEvent, type PageExtInPlaywright, type PageExtInPuppeteer, type PageInfo, type PageOpenType, type PageStatus, type PaperFormat, PlaywrightBrowser, PlaywrightBrowserContext, type PlaywrightBrowserTypes, PlaywrightElement, PlaywrightPage, type Proxy, PuppeteerBrowser, PuppeteerBrowserContext, PuppeteerElement, PuppeteerPage, type RequestInterceptionAction, type RequestInterceptionOption, type RequestMatch, type RequestMethod, type RequestResourceType, type ResponseHandler, type ResponseHandlerOptions, type ResponseInterceptionItem, type ResponseInterceptionOption, type ResponseMatch, type ScreenshotOptions, type SelectOptions, type StateData, type UpdatablePageInfo, type ViewportSize, type WaitElementOptions, type WaitElementState, type WaitNavigationOptions, controller, defaultProxy };

package/dist/index.js

@@ -525,6 +525,11 @@ var PlaywrightPage = class extends EventEmitter {
     this.#responseCb = null;
     this.#addPageOn();
   }
+  apiRequestContext() {
+    const origBrowserContext = this.browserContext()._origBrowserContext();
+    const apiRequestContext = origBrowserContext.request;
+    return apiRequestContext;
+  }
   async bringToFront() {
     if (!this.#page) {
       throw new Error("No valid page");
@@ -2006,6 +2011,9 @@ var PuppeteerPage = class extends EventEmitter4 {
     this.#client = null;
     this.#addPageOn();
   }
+  apiRequestContext() {
+    throw new Error("Not supported in PuppeteerPage.");
+  }
   async bringToFront() {
     if (!this.#page) {
       throw new Error("No valid page");
@@ -16988,6 +16996,9 @@ var CheerioPage = class extends EventEmitter7 {
       this.#document = load(html3, { xml: true }).root();
     }
   }
+  apiRequestContext() {
+    throw new Error("Not supported in CheerioPage.");
+  }
   async bringToFront() {
     throw new Error("Not supported in CheerioPage.");
   }
@@ -17168,8 +17179,11 @@ var CheerioPage = class extends EventEmitter7 {
 // src/controller/controller.ts
 import os from "os";
 import puppeteer from "puppeteer";
-import playwright from "playwright";
+import playwright, { request as apiRequest } 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 +17198,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 +17225,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);
@@ -17311,6 +17341,9 @@ var LsdBrowserController = class _LsdBrowserController {
         args.push("--start-maximized");
         launchOptions.defaultViewport = null;
       }
+      if (!args.includes("--no-sandbox")) {
+        args.push("--no-sandbox");
+      }
       if (browserType === "chromium") {
         if (incognito) {
           args.push("--incognito");
@@ -17373,6 +17406,10 @@ var LsdBrowserController = class _LsdBrowserController {
       throw new Error(`Invalid browserControllerType: ${browserControllerType} in connect`);
     }
   }
+  async newApiRequestContext(options) {
+    const apiRequestContext = await apiRequest.newContext(options);
+    return apiRequestContext;
+  }
 };
 var controller = new LsdBrowserController();
 export {

package/package.json

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