@letsscrapedata/controller 0.0.37 → 0.0.39

package/dist/index.d.cts

@@ -1,13 +1,11 @@
 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, APIRequestContext, BrowserType, Locator, FrameLocator } from 'playwright';
-import * as cheerio from 'cheerio';
 
 /**
  * 命名规则：为了与playwright/puppeteer中的同名区别
- * 1. 类型type的名称：AllXxxYyy，如AllBrowserContext
- * 2. 接口interface的名称: InterfaceXxxYyy，如InterfaceBrowserContext
- * 3. 接口的实现类class的名称: LsdXxxYyy，如LsdBrowserContext
+ * 1. name of type：AllXxxYyy，如AllBrowserContext
+ * 2. 接口的实现类class的名称: LsdXxxYyy，如LsdBrowserContext
  */
 
 type AllBrowser = Browser | Browser$1;
@@ -16,16 +14,80 @@ type AllFrame = Frame | Frame$1;
 type AllPage = Page | Page$1;
 type AllResponse = Response | HTTPResponse;
 type AllApiRequestContext = APIRequestContext;
-type CheerioNode = cheerio.Cheerio<cheerio.Element>;
-type ProxyInController = {
+type CheerioNode = cheerio.Cheerio;
+type BrowserControllerType = "puppeteer" | "playwright";
+type BrowserCreationMethod = "launch" | "connect";
+type LsdBrowserType = "chromium" | "firefox" | "webkit";
+interface BrowserContextRequirements {
+    browserControllerTypes: BrowserControllerType[];
+    browserTypes: LsdBrowserType[];
+    headlesses: boolean[];
+    incognitos: boolean[];
+}
+interface ProxyInController {
     proxyUrl: string;
     username?: string;
     password?: string;
     proxyId?: string;
-};
-type BrowserControllerType = "puppeteer" | "playwright";
-type BrowserCreationMethod = "launch" | "connect";
-type LsdBrowserType = "chromium" | "firefox" | "webkit";
+}
+interface ClientCertificate {
+    origin: string;
+    cert?: Buffer;
+    certPath?: string;
+    key?: Buffer;
+    keyPath?: string;
+    pfx?: Buffer;
+    pfxPath?: string;
+    passphrase?: string;
+}
+interface LsdApiContextOptions {
+    proxy?: ProxyInController;
+    /**
+     * storageState
+     */
+    stateData?: BrowserStateData;
+    userAgent?: string;
+    timeout?: number;
+    ignoreHTTPSErrors?: boolean;
+    extraHTTPHeaders?: Record<string, string>;
+    httpCredentials?: {
+        username: string;
+        password: string;
+        origin?: string;
+        send?: 'always' | 'unauthorized';
+    };
+    clientCertificates?: ClientCertificate[];
+}
+interface LsdFetchOptions {
+    /**
+     * @default "get"
+     */
+    method?: "delete" | "get" | "post" | "put";
+    params?: Record<string, string | number | boolean>;
+    headers?: Record<string, string>;
+    data?: any;
+    form?: Record<string, string | number | boolean>;
+    timeout?: number;
+    failOnStatusCode?: boolean;
+    ignoreHTTPSErrors?: boolean;
+    maxRedirects?: number;
+    maxRetries?: number;
+}
+interface LsdApiResponse {
+    headers: Record<string, string>;
+    status: number;
+    statusText: string;
+    text: string;
+    url: string;
+}
+interface LsdApiContext {
+    fetch(url: string, options?: LsdFetchOptions): Promise<LsdApiResponse>;
+    stateData(): Promise<BrowserStateData>;
+    /**
+     * destroyed LsdApiContext cannot be used again, or throw an exeception
+     */
+    destroy(): Promise<boolean>;
+}
 interface PlaywrightBrowserTypes {
     chromium: BrowserType;
     firefox: BrowserType;
@@ -771,10 +833,10 @@ interface WaitNavigationOptions {
 type PageEvent = "pageClose" | "pagePopup";
 interface LsdPage extends EventEmitter {
     /**
-     * Get the APIRequestContext associated with this page's browser context.
+     * Get the LsdApiContext associated with this page's LsdBrowserContext
      * * only vaild in playwright
      */
-    apiRequestContext(): AllApiRequestContext;
+    apiContext(): LsdApiContext;
     bringToFront(): Promise<boolean>;
     browserContext(): LsdBrowserContext;
     /**
@@ -916,6 +978,11 @@ interface LsdPage extends EventEmitter {
     _origPage(): AllPage;
 }
 interface LsdBrowserContext extends EventEmitter {
+    /**
+     * Get the LsdApiContext associated with this LsdBrowserContext
+     * * only vaild in playwright
+     */
+    apiContext(): LsdApiContext;
     browser(): LsdBrowser;
     close(): Promise<boolean>;
     /**
@@ -924,6 +991,11 @@ interface LsdBrowserContext extends EventEmitter {
      * @default 0 the default maxPageFreeSeconds of the browserContext will be used
      */
     closeFreePages(maxPageFreeSeconds?: number): Promise<boolean>;
+    /**
+     * doest this browser meet browserContextRequirements (incognitos ignored in browser)?
+     * @param browserContextRequirements
+     */
+    doesMeetBrowserContextRequirements(browserContextRequirements: BrowserContextRequirements): boolean;
     /**
      * get a free page from current pages or by creating a new page
      */
@@ -955,6 +1027,11 @@ interface LsdBrowser extends EventEmitter {
     browserControllerType(): BrowserControllerType;
     browserCreationMethod(): BrowserCreationMethod;
     browserType(): LsdBrowserType;
+    /**
+     * doest this browser meet browserContextRequirements (incognitos ignored in browser)?
+     * @param browserContextRequirements
+     */
+    doesMeetBrowserContextRequirements(browserContextRequirements: BrowserContextRequirements): boolean;
     /**
      * @returns
      * 1. launched: actual executable path
@@ -1009,9 +1086,9 @@ interface LsdBrowserController$1 {
      */
     setPlaywrightBrowserType(browserType: LsdBrowserType, playwrightBrowserType: BrowserType | null): boolean;
     /**
-     * Create a new APIRequestContext, valid in playwright;
+     * Create a new LsdApiContext, valid in playwright;
      */
-    newApiRequestContext(options?: any): Promise<AllApiRequestContext>;
+    newApiContext(options?: LsdApiContextOptions): Promise<LsdApiContext>;
 }
 /**
  * globObj.cfg.XXX:
@@ -1050,6 +1127,7 @@ declare class PlaywrightBrowser extends EventEmitter implements LsdBrowser {
     browserControllerType(): BrowserControllerType;
     browserCreationMethod(): BrowserCreationMethod;
     browserType(): LsdBrowserType;
+    doesMeetBrowserContextRequirements(browserContextRequirements: BrowserContextRequirements): boolean;
     executablePath(): string;
     id(): string;
     isConnected(): boolean;
@@ -1067,9 +1145,11 @@ declare class PlaywrightBrowser extends EventEmitter implements LsdBrowser {
 declare class PlaywrightBrowserContext extends EventEmitter implements LsdBrowserContext {
     #private;
     constructor(lsdBrowser: LsdBrowser, browserContext: BrowserContext, incognito?: boolean, proxy?: ProxyInController | null, browserIdx?: number, browserContextIdx?: number, maxPagesPerBrowserContext?: number, maxPageFreeSeconds?: number, maxViewportOfNewPage?: boolean);
+    apiContext(): LsdApiContext;
     browser(): LsdBrowser;
     close(): Promise<boolean>;
     closeFreePages(maxPageFreeSeconds?: number): Promise<boolean>;
+    doesMeetBrowserContextRequirements(browserContextRequirements: BrowserContextRequirements): boolean;
     getPage(always?: boolean): Promise<LsdPage | null>;
     hasFreePage(pageNum?: number): boolean;
     id(): string;
@@ -1084,7 +1164,7 @@ declare class PlaywrightBrowserContext extends EventEmitter implements LsdBrowse
 declare class PlaywrightPage extends EventEmitter implements LsdPage {
     #private;
     constructor(browserContext: LsdBrowserContext, page: Page, pageInfo?: PageInfo);
-    apiRequestContext(): APIRequestContext;
+    apiContext(): LsdApiContext;
     bringToFront(): Promise<boolean>;
     browserContext(): LsdBrowserContext;
     clearCookies(): Promise<boolean>;
@@ -1166,6 +1246,7 @@ declare class PuppeteerBrowser extends EventEmitter implements LsdBrowser {
     browserControllerType(): BrowserControllerType;
     browserCreationMethod(): BrowserCreationMethod;
     browserType(): LsdBrowserType;
+    doesMeetBrowserContextRequirements(browserContextRequirements: BrowserContextRequirements): boolean;
     executablePath(): string;
     id(): string;
     isConnected(): boolean;
@@ -1183,9 +1264,11 @@ declare class PuppeteerBrowser extends EventEmitter implements LsdBrowser {
 declare class PuppeteerBrowserContext extends EventEmitter implements LsdBrowserContext {
     #private;
     constructor(lsdBrowser: LsdBrowser, browserContext: BrowserContext$1, incognito?: boolean, proxy?: ProxyInController | null, browserIdx?: number, browserContextIdx?: number, maxPagesPerBrowserContext?: number, maxPageFreeSeconds?: number, userAgent?: string, maxViewportOfNewPage?: boolean);
+    apiContext(): LsdApiContext;
     browser(): LsdBrowser;
     close(): Promise<boolean>;
     closeFreePages(maxPageFreeSeconds?: number): Promise<boolean>;
+    doesMeetBrowserContextRequirements(browserContextRequirements: BrowserContextRequirements): boolean;
     getPage(always?: boolean): Promise<LsdPage | null>;
     hasFreePage(pageNum?: number): boolean;
     id(): string;
@@ -1200,7 +1283,7 @@ declare class PuppeteerBrowserContext extends EventEmitter implements LsdBrowser
 declare class PuppeteerPage extends EventEmitter implements LsdPage {
     #private;
     constructor(browserContext: LsdBrowserContext, page: Page$1, pageInfo?: PageInfo);
-    apiRequestContext(): APIRequestContext;
+    apiContext(): LsdApiContext;
     bringToFront(): Promise<boolean>;
     browserContext(): LsdBrowserContext;
     clearCookies(): Promise<boolean>;
@@ -1282,7 +1365,7 @@ declare class CheerioPage extends EventEmitter implements LsdPage {
      */
     constructor(html?: string, isHtml?: boolean);
     _origPage(): AllPage;
-    apiRequestContext(): APIRequestContext;
+    apiContext(): LsdApiContext;
     bringToFront(): Promise<boolean>;
     browserContext(): LsdBrowserContext;
     clearCookies(): Promise<boolean>;
@@ -1360,8 +1443,8 @@ declare class LsdBrowserController implements LsdBrowserController$1 {
     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>;
+    newApiContext(options?: LsdApiContextOptions): Promise<LsdApiContext>;
 }
 declare const controller: LsdBrowserController;
 
-export { type AllApiRequestContext, type AllBrowser, type AllBrowserContext, type AllFrame, type AllPage, type AllResponse, type BrowserControllerType, type BrowserCreationMethod, type BrowserLaunchMethod, type BrowserManager, type BrowserStateData, 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 ProxyInController, 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 ResponsePageData, type ScreenshotOptions, type SelectOptions, type UpdatablePageInfo, type ViewportSize, type WaitElementOptions, type WaitElementState, type WaitNavigationOptions, controller };
+export { type AllApiRequestContext, type AllBrowser, type AllBrowserContext, type AllFrame, type AllPage, type AllResponse, type BrowserContextRequirements, type BrowserControllerType, type BrowserCreationMethod, type BrowserLaunchMethod, type BrowserManager, type BrowserStateData, CheerioElement, type CheerioNode, CheerioPage, type ClientCertificate, type CookieItem, type GotoOptions, type IframeOption, type InputOptions, type KeyInput, type KeyPressOptions, type LocalStorageItem, type LocalStorageOrigin, type LowerCasePaperFormat, type LsdApiContext, type LsdApiContextOptions, type LsdApiResponse, type LsdBrowser, type LsdBrowserContext, type LsdBrowserContextOptions, type LsdBrowserController$1 as LsdBrowserController, type LsdBrowserType, type LsdConnectOptions, type LsdElement, type LsdFetchOptions, 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 ProxyInController, 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 ResponsePageData, type ScreenshotOptions, type SelectOptions, type UpdatablePageInfo, type ViewportSize, type WaitElementOptions, type WaitElementState, type WaitNavigationOptions, controller };

package/dist/index.d.ts

@@ -1,13 +1,11 @@
 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, APIRequestContext, BrowserType, Locator, FrameLocator } from 'playwright';
-import * as cheerio from 'cheerio';
 
 /**
  * 命名规则：为了与playwright/puppeteer中的同名区别
- * 1. 类型type的名称：AllXxxYyy，如AllBrowserContext
- * 2. 接口interface的名称: InterfaceXxxYyy，如InterfaceBrowserContext
- * 3. 接口的实现类class的名称: LsdXxxYyy，如LsdBrowserContext
+ * 1. name of type：AllXxxYyy，如AllBrowserContext
+ * 2. 接口的实现类class的名称: LsdXxxYyy，如LsdBrowserContext
  */
 
 type AllBrowser = Browser | Browser$1;
@@ -16,16 +14,80 @@ type AllFrame = Frame | Frame$1;
 type AllPage = Page | Page$1;
 type AllResponse = Response | HTTPResponse;
 type AllApiRequestContext = APIRequestContext;
-type CheerioNode = cheerio.Cheerio<cheerio.Element>;
-type ProxyInController = {
+type CheerioNode = cheerio.Cheerio;
+type BrowserControllerType = "puppeteer" | "playwright";
+type BrowserCreationMethod = "launch" | "connect";
+type LsdBrowserType = "chromium" | "firefox" | "webkit";
+interface BrowserContextRequirements {
+    browserControllerTypes: BrowserControllerType[];
+    browserTypes: LsdBrowserType[];
+    headlesses: boolean[];
+    incognitos: boolean[];
+}
+interface ProxyInController {
     proxyUrl: string;
     username?: string;
     password?: string;
     proxyId?: string;
-};
-type BrowserControllerType = "puppeteer" | "playwright";
-type BrowserCreationMethod = "launch" | "connect";
-type LsdBrowserType = "chromium" | "firefox" | "webkit";
+}
+interface ClientCertificate {
+    origin: string;
+    cert?: Buffer;
+    certPath?: string;
+    key?: Buffer;
+    keyPath?: string;
+    pfx?: Buffer;
+    pfxPath?: string;
+    passphrase?: string;
+}
+interface LsdApiContextOptions {
+    proxy?: ProxyInController;
+    /**
+     * storageState
+     */
+    stateData?: BrowserStateData;
+    userAgent?: string;
+    timeout?: number;
+    ignoreHTTPSErrors?: boolean;
+    extraHTTPHeaders?: Record<string, string>;
+    httpCredentials?: {
+        username: string;
+        password: string;
+        origin?: string;
+        send?: 'always' | 'unauthorized';
+    };
+    clientCertificates?: ClientCertificate[];
+}
+interface LsdFetchOptions {
+    /**
+     * @default "get"
+     */
+    method?: "delete" | "get" | "post" | "put";
+    params?: Record<string, string | number | boolean>;
+    headers?: Record<string, string>;
+    data?: any;
+    form?: Record<string, string | number | boolean>;
+    timeout?: number;
+    failOnStatusCode?: boolean;
+    ignoreHTTPSErrors?: boolean;
+    maxRedirects?: number;
+    maxRetries?: number;
+}
+interface LsdApiResponse {
+    headers: Record<string, string>;
+    status: number;
+    statusText: string;
+    text: string;
+    url: string;
+}
+interface LsdApiContext {
+    fetch(url: string, options?: LsdFetchOptions): Promise<LsdApiResponse>;
+    stateData(): Promise<BrowserStateData>;
+    /**
+     * destroyed LsdApiContext cannot be used again, or throw an exeception
+     */
+    destroy(): Promise<boolean>;
+}
 interface PlaywrightBrowserTypes {
     chromium: BrowserType;
     firefox: BrowserType;
@@ -771,10 +833,10 @@ interface WaitNavigationOptions {
 type PageEvent = "pageClose" | "pagePopup";
 interface LsdPage extends EventEmitter {
     /**
-     * Get the APIRequestContext associated with this page's browser context.
+     * Get the LsdApiContext associated with this page's LsdBrowserContext
      * * only vaild in playwright
      */
-    apiRequestContext(): AllApiRequestContext;
+    apiContext(): LsdApiContext;
     bringToFront(): Promise<boolean>;
     browserContext(): LsdBrowserContext;
     /**
@@ -916,6 +978,11 @@ interface LsdPage extends EventEmitter {
     _origPage(): AllPage;
 }
 interface LsdBrowserContext extends EventEmitter {
+    /**
+     * Get the LsdApiContext associated with this LsdBrowserContext
+     * * only vaild in playwright
+     */
+    apiContext(): LsdApiContext;
     browser(): LsdBrowser;
     close(): Promise<boolean>;
     /**
@@ -924,6 +991,11 @@ interface LsdBrowserContext extends EventEmitter {
      * @default 0 the default maxPageFreeSeconds of the browserContext will be used
      */
     closeFreePages(maxPageFreeSeconds?: number): Promise<boolean>;
+    /**
+     * doest this browser meet browserContextRequirements (incognitos ignored in browser)?
+     * @param browserContextRequirements
+     */
+    doesMeetBrowserContextRequirements(browserContextRequirements: BrowserContextRequirements): boolean;
     /**
      * get a free page from current pages or by creating a new page
      */
@@ -955,6 +1027,11 @@ interface LsdBrowser extends EventEmitter {
     browserControllerType(): BrowserControllerType;
     browserCreationMethod(): BrowserCreationMethod;
     browserType(): LsdBrowserType;
+    /**
+     * doest this browser meet browserContextRequirements (incognitos ignored in browser)?
+     * @param browserContextRequirements
+     */
+    doesMeetBrowserContextRequirements(browserContextRequirements: BrowserContextRequirements): boolean;
     /**
      * @returns
      * 1. launched: actual executable path
@@ -1009,9 +1086,9 @@ interface LsdBrowserController$1 {
      */
     setPlaywrightBrowserType(browserType: LsdBrowserType, playwrightBrowserType: BrowserType | null): boolean;
     /**
-     * Create a new APIRequestContext, valid in playwright;
+     * Create a new LsdApiContext, valid in playwright;
      */
-    newApiRequestContext(options?: any): Promise<AllApiRequestContext>;
+    newApiContext(options?: LsdApiContextOptions): Promise<LsdApiContext>;
 }
 /**
  * globObj.cfg.XXX:
@@ -1050,6 +1127,7 @@ declare class PlaywrightBrowser extends EventEmitter implements LsdBrowser {
     browserControllerType(): BrowserControllerType;
     browserCreationMethod(): BrowserCreationMethod;
     browserType(): LsdBrowserType;
+    doesMeetBrowserContextRequirements(browserContextRequirements: BrowserContextRequirements): boolean;
     executablePath(): string;
     id(): string;
     isConnected(): boolean;
@@ -1067,9 +1145,11 @@ declare class PlaywrightBrowser extends EventEmitter implements LsdBrowser {
 declare class PlaywrightBrowserContext extends EventEmitter implements LsdBrowserContext {
     #private;
     constructor(lsdBrowser: LsdBrowser, browserContext: BrowserContext, incognito?: boolean, proxy?: ProxyInController | null, browserIdx?: number, browserContextIdx?: number, maxPagesPerBrowserContext?: number, maxPageFreeSeconds?: number, maxViewportOfNewPage?: boolean);
+    apiContext(): LsdApiContext;
     browser(): LsdBrowser;
     close(): Promise<boolean>;
     closeFreePages(maxPageFreeSeconds?: number): Promise<boolean>;
+    doesMeetBrowserContextRequirements(browserContextRequirements: BrowserContextRequirements): boolean;
     getPage(always?: boolean): Promise<LsdPage | null>;
     hasFreePage(pageNum?: number): boolean;
     id(): string;
@@ -1084,7 +1164,7 @@ declare class PlaywrightBrowserContext extends EventEmitter implements LsdBrowse
 declare class PlaywrightPage extends EventEmitter implements LsdPage {
     #private;
     constructor(browserContext: LsdBrowserContext, page: Page, pageInfo?: PageInfo);
-    apiRequestContext(): APIRequestContext;
+    apiContext(): LsdApiContext;
     bringToFront(): Promise<boolean>;
     browserContext(): LsdBrowserContext;
     clearCookies(): Promise<boolean>;
@@ -1166,6 +1246,7 @@ declare class PuppeteerBrowser extends EventEmitter implements LsdBrowser {
     browserControllerType(): BrowserControllerType;
     browserCreationMethod(): BrowserCreationMethod;
     browserType(): LsdBrowserType;
+    doesMeetBrowserContextRequirements(browserContextRequirements: BrowserContextRequirements): boolean;
     executablePath(): string;
     id(): string;
     isConnected(): boolean;
@@ -1183,9 +1264,11 @@ declare class PuppeteerBrowser extends EventEmitter implements LsdBrowser {
 declare class PuppeteerBrowserContext extends EventEmitter implements LsdBrowserContext {
     #private;
     constructor(lsdBrowser: LsdBrowser, browserContext: BrowserContext$1, incognito?: boolean, proxy?: ProxyInController | null, browserIdx?: number, browserContextIdx?: number, maxPagesPerBrowserContext?: number, maxPageFreeSeconds?: number, userAgent?: string, maxViewportOfNewPage?: boolean);
+    apiContext(): LsdApiContext;
     browser(): LsdBrowser;
     close(): Promise<boolean>;
     closeFreePages(maxPageFreeSeconds?: number): Promise<boolean>;
+    doesMeetBrowserContextRequirements(browserContextRequirements: BrowserContextRequirements): boolean;
     getPage(always?: boolean): Promise<LsdPage | null>;
     hasFreePage(pageNum?: number): boolean;
     id(): string;
@@ -1200,7 +1283,7 @@ declare class PuppeteerBrowserContext extends EventEmitter implements LsdBrowser
 declare class PuppeteerPage extends EventEmitter implements LsdPage {
     #private;
     constructor(browserContext: LsdBrowserContext, page: Page$1, pageInfo?: PageInfo);
-    apiRequestContext(): APIRequestContext;
+    apiContext(): LsdApiContext;
     bringToFront(): Promise<boolean>;
     browserContext(): LsdBrowserContext;
     clearCookies(): Promise<boolean>;
@@ -1282,7 +1365,7 @@ declare class CheerioPage extends EventEmitter implements LsdPage {
      */
     constructor(html?: string, isHtml?: boolean);
     _origPage(): AllPage;
-    apiRequestContext(): APIRequestContext;
+    apiContext(): LsdApiContext;
     bringToFront(): Promise<boolean>;
     browserContext(): LsdBrowserContext;
     clearCookies(): Promise<boolean>;
@@ -1360,8 +1443,8 @@ declare class LsdBrowserController implements LsdBrowserController$1 {
     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>;
+    newApiContext(options?: LsdApiContextOptions): Promise<LsdApiContext>;
 }
 declare const controller: LsdBrowserController;
 
-export { type AllApiRequestContext, type AllBrowser, type AllBrowserContext, type AllFrame, type AllPage, type AllResponse, type BrowserControllerType, type BrowserCreationMethod, type BrowserLaunchMethod, type BrowserManager, type BrowserStateData, 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 ProxyInController, 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 ResponsePageData, type ScreenshotOptions, type SelectOptions, type UpdatablePageInfo, type ViewportSize, type WaitElementOptions, type WaitElementState, type WaitNavigationOptions, controller };
+export { type AllApiRequestContext, type AllBrowser, type AllBrowserContext, type AllFrame, type AllPage, type AllResponse, type BrowserContextRequirements, type BrowserControllerType, type BrowserCreationMethod, type BrowserLaunchMethod, type BrowserManager, type BrowserStateData, CheerioElement, type CheerioNode, CheerioPage, type ClientCertificate, type CookieItem, type GotoOptions, type IframeOption, type InputOptions, type KeyInput, type KeyPressOptions, type LocalStorageItem, type LocalStorageOrigin, type LowerCasePaperFormat, type LsdApiContext, type LsdApiContextOptions, type LsdApiResponse, type LsdBrowser, type LsdBrowserContext, type LsdBrowserContextOptions, type LsdBrowserController$1 as LsdBrowserController, type LsdBrowserType, type LsdConnectOptions, type LsdElement, type LsdFetchOptions, 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 ProxyInController, 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 ResponsePageData, type ScreenshotOptions, type SelectOptions, type UpdatablePageInfo, type ViewportSize, type WaitElementOptions, type WaitElementState, type WaitNavigationOptions, controller };