donobu 2.30.0 → 2.31.0

package/dist/tools/TriggerDonobuFlowTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TriggerDonobuFlowTool.d.ts","sourceRoot":"","sources":["../../src/tools/TriggerDonobuFlowTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG1D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAItC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEtC,CAAC;AAEF,qBAAa,qBAAsB,SAAQ,IAAI,CAC7C,OAAO,2BAA2B,EAClC,OAAO,0BAA0B,CAClC;IACC,gBAAuB,IAAI,uBAAuB;;IAc5B,IAAI,CACxB,OAAO,EAAE,eAAe,EACxB,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,GACtD,OAAO,CAAC,cAAc,CAAC;IAWJ,WAAW,CAC/B,OAAO,EAAE,eAAe,EACxB,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,GACrD,OAAO,CAAC,cAAc,CAAC;CAG3B"}
+{"version":3,"file":"TriggerDonobuFlowTool.d.ts","sourceRoot":"","sources":["../../src/tools/TriggerDonobuFlowTool.ts"],"names":[],"mappings":"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"}

package/dist/utils/BrowserUtils.d.ts

@@ -2,6 +2,38 @@ import { BrowserContext } from 'playwright';
 import { BrowserDevice } from '../models/BrowserDevice';
 import { BrowserStorageState } from '../models/BrowserStorageState';
 import { BrowserConfig } from '../models/BrowserConfig';
+export type BROWSER_TYPE_NAME = 'firefox' | 'chromium' | 'chrome' | 'webkit' | 'ios';
+/**
+ * Utility class for managing browser instances and contexts across different browser types and configurations.
+ *
+ * Provides comprehensive browser automation capabilities including:
+ * - Device emulation with pre-configured browser/device combinations
+ * - Remote browser instance connection via Chrome DevTools Protocol (CDP)
+ * - BrowserBase cloud browser integration
+ * - Complete storage state management (cookies, localStorage, sessionStorage)
+ * - Proxy configuration and environment variable integration
+ *
+ * Supports multiple browser engines: Chromium, Chrome, Firefox, WebKit, and iOS Safari.
+ *
+ * @example
+ * ```typescript
+ * // Create a browser context with device emulation
+ * const config: BrowserConfig = {
+ *   using: { type: 'device', deviceName: 'iPhone 13' }
+ * };
+ * const context = await BrowserUtils.create(config, './output');
+ *
+ * // Get supported devices
+ * const devices = BrowserUtils.getSupportedDevices();
+ *
+ * // Extract storage state
+ * const storageState = await BrowserUtils.getBrowserStorageState(context);
+ * ```
+ *
+ * @see {@link BrowserConfig} for configuration options
+ * @see {@link BrowserStorageState} for storage state structure
+ * @see {@link BrowserDevice} for device configuration format
+ */
 export declare class BrowserUtils {
     private static readonly DEFAULT_DEVICE_NAME;
     /**
@@ -11,26 +43,82 @@ export declare class BrowserUtils {
      * The returned map keys the devices by their name (ex: 'Desktop Firefox').
      *
      * See `assets/devices.json` for details.
+     *
+     * @returns A Map containing device configurations keyed by device name
+     * @throws {Error} When the devices configuration file cannot be loaded
      */
     static getSupportedDevices(): Map<string, BrowserDevice>;
+    /**
+     * Creates a browser context based on the provided configuration.
+     * Supports different browser types including device emulation, remote instances, and BrowserBase.
+     *
+     * @param browserConfig - Configuration object specifying browser type and settings
+     * @param outputDir - Directory path where browser artifacts (videos, etc.) will be stored
+     * @param storageState - Optional browser storage state to restore (cookies, localStorage, sessionStorage)
+     * @returns A promise that resolves to a configured BrowserContext
+     * @throws {InvalidParamValueException} When an invalid browser type is specified
+     */
     static create(browserConfig: BrowserConfig, outputDir: string, storageState?: BrowserStorageState): Promise<BrowserContext>;
     /**
      * Gets the browser storage state including cookies, localStorage, and sessionStorage.
      *
-     * @param browserContext The browser context to extract storage state from.
-     * @returns A promise that resolves to the complete browser storage state.
+     * @param browserContext - The browser context to extract storage state from
+     * @returns A promise that resolves to the complete browser storage state
      */
     static getBrowserStorageState(browserContext: BrowserContext): Promise<BrowserStorageState>;
     /**
-     * Connects to an existing Chromium browser using the Chrome DevTools Protocol (CDP) at the given
-     * URL.
+     * Connects to an existing Chromium browser using the Chrome DevTools Protocol (CDP) at the given URL.
+     *
+     * @param remoteBrowserInstanceUrl - The CDP endpoint URL of the remote browser instance
+     * @param outputDir - Directory path where browser artifacts will be stored
+     * @param storageState - Optional browser storage state to restore
+     * @returns A promise that resolves to an object containing the browser and browser context
+     * @throws {InvalidParamValueException} When the remote browser URL is invalid or connection fails
+     * @private
      */
     private static forRemoteBrowser;
     /**
+     * Creates a browser and context for a specific device configuration.
      * If {@link storageState} is present, must be an object conforming to what is returned by
      * {@link BrowserContext.storageState()}.
+     *
+     * @param deviceName - Name of the device configuration to use
+     * @param headless - Whether to run the browser in headless mode
+     * @param outputDir - Directory path where browser artifacts will be stored
+     * @param storageState - Optional browser storage state to restore
+     * @param proxy - Optional proxy configuration for the browser
+     * @returns A promise that resolves to an object containing the browser and browser context
+     * @throws {InvalidParamValueException} When the device name is not found in supported devices
      */
     private static forDevice;
+    /**
+     * Builds browser context options for a specific device configuration.
+     *
+     * @param deviceName - Name of the device configuration to use
+     * @param outputDir - Directory path where browser artifacts will be stored
+     * @returns An object containing the browser type name and context options
+     * @throws {InvalidParamValueException} When the device name is not found in supported devices
+     */
+    private static browserContextOptionsForDevice;
+    /**
+     * Expands proxy configuration by merging provided proxy settings with environment variables.
+     * Environment variables serve as fallbacks for missing proxy configuration values.
+     *
+     * @param proxy - Optional proxy configuration object
+     * @returns Expanded proxy configuration or undefined if no proxy is configured
+     */
+    private static expandProxyConfiguration;
+    /**
+     * Creates a new browser instance of the specified type with given launch and context options.
+     * Handles cleanup by closing the browser if context creation fails.
+     *
+     * @param browserTypeName - The type of browser to launch
+     * @param launchOptions - Options for launching the browser
+     * @param browserContextOptions - Options for creating the browser context
+     * @returns A promise that resolves to an object containing the browser and browser context
+     * @throws {InvalidParamValueException} When an unsupported browser type is specified
+     */
+    private static newBrowser;
     /**
      * Creates a BrowserBase session. Using this method requires the
      * BROWSERBASE_API_KEY environment variable to be set.
@@ -38,15 +126,40 @@ export declare class BrowserUtils {
      * The returned browserBaseData object conforms to the response of the session
      * creation API endpoint. See...
      * https://docs.browserbase.com/reference/api/create-a-session#response-id
+     *
+     * @param sessionArgs - Arguments for creating the BrowserBase session
+     * @param outputDir - Directory path where browser artifacts will be stored
+     * @param storageState - Optional browser storage state to restore
+     * @returns A promise that resolves to an object containing the browser, context, and session data
+     * @throws {InvalidParamValueException} When BrowserBase API key is missing or session creation fails
      */
     private static forBrowserBase;
     /**
      * Establishes a BrowserBase session. The returned structure matches the
-     * response structore from the BrowserBase session API. See...
+     * response structure from the BrowserBase session API. See...
      * https://docs.browserbase.com/reference/api/create-a-session#response-id
+     *
+     * @param sessionArgs - Arguments for creating the BrowserBase session
+     * @returns A promise that resolves to the BrowserBase session data
+     * @throws {InvalidParamValueException} When the API key is missing or the API returns an error
      */
     private static establishBrowserBaseSession;
+    /**
+     * Attaches sessionStorage data to a browser context by adding an initialization script.
+     * The script will restore sessionStorage items for each origin when pages are loaded.
+     *
+     * @param browserContext - The browser context to attach sessionStorage to
+     * @param storageState - Optional browser storage state containing sessionStorage data
+     */
     static attachSessionStorageToBrowserContext(browserContext: BrowserContext, storageState?: BrowserStorageState): Promise<void>;
+    /**
+     * Patches the close method of a browser context to execute additional cleanup logic.
+     * The extra cleanup function will be called after the original close method completes.
+     * Both the original close and extra cleanup are wrapped in try-catch blocks to prevent errors from propagating.
+     *
+     * @param ctx - The browser context to patch
+     * @param extra - Additional cleanup function to execute when the context is closed
+     */
     private static patchClose;
 }
 //# sourceMappingURL=BrowserUtils.d.ts.map

package/dist/utils/BrowserUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BrowserUtils.d.ts","sourceRoot":"","sources":["../../src/utils/BrowserUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,cAAc,EAGf,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEpE,OAAO,EAA0B,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAIhF,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IACjE;;;;;;;OAOG;WACW,mBAAmB,IAAI,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC;WAY3C,MAAM,CACxB,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,mBAAmB,GACjC,OAAO,CAAC,cAAc,CAAC;IAuF1B;;;;;OAKG;WACiB,sBAAsB,CACxC,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,mBAAmB,CAAC;IAgF/B;;;OAGG;mBACkB,gBAAgB;IAiCrC;;;OAGG;mBACkB,SAAS;IAiF9B;;;;;;;OAOG;mBACkB,cAAc;IA2BnC;;;;OAIG;mBACkB,2BAA2B;WAkC5B,oCAAoC,CACtD,cAAc,EAAE,cAAc,EAC9B,YAAY,CAAC,EAAE,mBAAmB,GACjC,OAAO,CAAC,IAAI,CAAC;IAwChB,OAAO,CAAC,MAAM,CAAC,UAAU;CAgB1B"}
+{"version":3,"file":"BrowserUtils.d.ts","sourceRoot":"","sources":["../../src/utils/BrowserUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,cAAc,EAGf,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEpE,OAAO,EAA0B,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAIhF,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,KAAK,CAAC;AAEV;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAEjE;;;;;;;;;;OAUG;WACW,mBAAmB,IAAI,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC;IAY/D;;;;;;;;;OASG;WACiB,MAAM,CACxB,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,mBAAmB,GACjC,OAAO,CAAC,cAAc,CAAC;IAwF1B;;;;;OAKG;WACiB,sBAAsB,CACxC,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,mBAAmB,CAAC;IAgF/B;;;;;;;;;OASG;mBACkB,gBAAgB;IAiCrC;;;;;;;;;;;;OAYG;mBACkB,SAAS;IA8B9B;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,8BAA8B;IA4C7C;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAyBvC;;;;;;;;;OASG;mBACkB,UAAU;IAqC/B;;;;;;;;;;;;;OAaG;mBACkB,cAAc;IA2BnC;;;;;;;;OAQG;mBACkB,2BAA2B;IAkChD;;;;;;OAMG;WACiB,oCAAoC,CACtD,cAAc,EAAE,cAAc,EAC9B,YAAY,CAAC,EAAE,mBAAmB,GACjC,OAAO,CAAC,IAAI,CAAC;IAwChB;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;CAgB1B"}

package/dist/utils/BrowserUtils.js

@@ -10,6 +10,37 @@ const InvalidParamValueException_1 = require("../exceptions/InvalidParamValueExc
 const path_1 = __importDefault(require("path"));
 const envVars_1 = require("../envVars");
 const Logger_1 = require("./Logger");
+/**
+ * Utility class for managing browser instances and contexts across different browser types and configurations.
+ *
+ * Provides comprehensive browser automation capabilities including:
+ * - Device emulation with pre-configured browser/device combinations
+ * - Remote browser instance connection via Chrome DevTools Protocol (CDP)
+ * - BrowserBase cloud browser integration
+ * - Complete storage state management (cookies, localStorage, sessionStorage)
+ * - Proxy configuration and environment variable integration
+ *
+ * Supports multiple browser engines: Chromium, Chrome, Firefox, WebKit, and iOS Safari.
+ *
+ * @example
+ * ```typescript
+ * // Create a browser context with device emulation
+ * const config: BrowserConfig = {
+ *   using: { type: 'device', deviceName: 'iPhone 13' }
+ * };
+ * const context = await BrowserUtils.create(config, './output');
+ *
+ * // Get supported devices
+ * const devices = BrowserUtils.getSupportedDevices();
+ *
+ * // Extract storage state
+ * const storageState = await BrowserUtils.getBrowserStorageState(context);
+ * ```
+ *
+ * @see {@link BrowserConfig} for configuration options
+ * @see {@link BrowserStorageState} for storage state structure
+ * @see {@link BrowserDevice} for device configuration format
+ */
 class BrowserUtils {
     /**
      * Loads all the pre-canned browser device configurations from the local
@@ -18,6 +49,9 @@ class BrowserUtils {
      * The returned map keys the devices by their name (ex: 'Desktop Firefox').
      *
      * See `assets/devices.json` for details.
+     *
+     * @returns A Map containing device configurations keyed by device name
+     * @throws {Error} When the devices configuration file cannot be loaded
      */
     static getSupportedDevices() {
         const rawDevices = JsonUtils_1.JsonUtils.readResourceAsJson(path_1.default.join('devices.json'));
@@ -26,13 +60,23 @@ class BrowserUtils {
         }
         return new Map(Object.entries(rawDevices));
     }
+    /**
+     * Creates a browser context based on the provided configuration.
+     * Supports different browser types including device emulation, remote instances, and BrowserBase.
+     *
+     * @param browserConfig - Configuration object specifying browser type and settings
+     * @param outputDir - Directory path where browser artifacts (videos, etc.) will be stored
+     * @param storageState - Optional browser storage state to restore (cookies, localStorage, sessionStorage)
+     * @returns A promise that resolves to a configured BrowserContext
+     * @throws {InvalidParamValueException} When an invalid browser type is specified
+     */
     static async create(browserConfig, outputDir, storageState) {
         const type = browserConfig.using.type;
         let browser;
         let browserContext;
         switch (type) {
             case 'device': {
-                ({ browser, browserContext } = await BrowserUtils.forDevice(browserConfig.using.deviceName ?? BrowserUtils.DEFAULT_DEVICE_NAME, browserConfig.using.headless ?? false, outputDir, storageState));
+                ({ browser, browserContext } = await BrowserUtils.forDevice(browserConfig.using.deviceName ?? BrowserUtils.DEFAULT_DEVICE_NAME, browserConfig.using.headless ?? false, outputDir, storageState, browserConfig.using.proxy));
                 BrowserUtils.patchClose(browserContext, () => browser.close());
                 break;
             }
@@ -88,8 +132,8 @@ class BrowserUtils {
     /**
      * Gets the browser storage state including cookies, localStorage, and sessionStorage.
      *
-     * @param browserContext The browser context to extract storage state from.
-     * @returns A promise that resolves to the complete browser storage state.
+     * @param browserContext - The browser context to extract storage state from
+     * @returns A promise that resolves to the complete browser storage state
      */
     static async getBrowserStorageState(browserContext) {
         let result;
@@ -156,8 +200,14 @@ class BrowserUtils {
         return result;
     }
     /**
-     * Connects to an existing Chromium browser using the Chrome DevTools Protocol (CDP) at the given
-     * URL.
+     * Connects to an existing Chromium browser using the Chrome DevTools Protocol (CDP) at the given URL.
+     *
+     * @param remoteBrowserInstanceUrl - The CDP endpoint URL of the remote browser instance
+     * @param outputDir - Directory path where browser artifacts will be stored
+     * @param storageState - Optional browser storage state to restore
+     * @returns A promise that resolves to an object containing the browser and browser context
+     * @throws {InvalidParamValueException} When the remote browser URL is invalid or connection fails
+     * @private
      */
     static async forRemoteBrowser(remoteBrowserInstanceUrl, outputDir, storageState) {
         try {
@@ -184,47 +234,112 @@ class BrowserUtils {
         }
     }
     /**
+     * Creates a browser and context for a specific device configuration.
      * If {@link storageState} is present, must be an object conforming to what is returned by
      * {@link BrowserContext.storageState()}.
+     *
+     * @param deviceName - Name of the device configuration to use
+     * @param headless - Whether to run the browser in headless mode
+     * @param outputDir - Directory path where browser artifacts will be stored
+     * @param storageState - Optional browser storage state to restore
+     * @param proxy - Optional proxy configuration for the browser
+     * @returns A promise that resolves to an object containing the browser and browser context
+     * @throws {InvalidParamValueException} When the device name is not found in supported devices
+     */
+    static async forDevice(deviceName, headless, outputDir, storageState, proxy) {
+        const { browserTypeName, browserContextOptions } = this.browserContextOptionsForDevice(deviceName, outputDir);
+        if (storageState) {
+            browserContextOptions.storageState = storageState;
+        }
+        const launchOptions = {
+            headless,
+            args: [
+                '--ignore-certificate-errors',
+                '--disable-blink-features=AutomationControlled',
+            ],
+            proxy: this.expandProxyConfiguration(proxy),
+        };
+        return await this.newBrowser(browserTypeName, launchOptions, browserContextOptions);
+    }
+    /**
+     * Builds browser context options for a specific device configuration.
+     *
+     * @param deviceName - Name of the device configuration to use
+     * @param outputDir - Directory path where browser artifacts will be stored
+     * @returns An object containing the browser type name and context options
+     * @throws {InvalidParamValueException} When the device name is not found in supported devices
      */
-    static async forDevice(deviceName, headless, outputDir, storageState) {
-        const device = BrowserUtils.getSupportedDevices().get(deviceName);
-        if (!device) {
+    static browserContextOptionsForDevice(deviceName, outputDir) {
+        const browserDevice = BrowserUtils.getSupportedDevices().get(deviceName);
+        if (!browserDevice) {
             throw new InvalidParamValueException_1.InvalidParamValueException('deviceName', deviceName);
         }
-        const contextOptions = {
-            userAgent: device.userAgent,
+        const browserContextOptions = {
+            userAgent: browserDevice.userAgent,
             recordVideo: {
                 dir: outputDir,
                 size: {
-                    width: device.viewport?.width ?? 1280,
-                    height: device.viewport?.height ?? 720,
+                    width: browserDevice.viewport?.width ?? 1280,
+                    height: browserDevice.viewport?.height ?? 720,
                 },
             },
             viewport: {
-                width: device.viewport?.width ?? 1280,
-                height: device.viewport?.height ?? 720,
+                width: browserDevice.viewport?.width ?? 1280,
+                height: browserDevice.viewport?.height ?? 720,
             },
             screen: {
-                width: device.screen?.width ?? device.viewport?.width ?? 1280,
-                height: device.screen?.height ?? device.viewport?.height ?? 720,
+                width: browserDevice.screen?.width ?? browserDevice.viewport?.width ?? 1280,
+                height: browserDevice.screen?.height ?? browserDevice.viewport?.height ?? 720,
             },
-            deviceScaleFactor: device.deviceScaleFactor ?? 1.0,
-            isMobile: device.isMobile ?? false,
-            hasTouch: device.hasTouch ?? false,
+            deviceScaleFactor: browserDevice.deviceScaleFactor ?? 1.0,
+            isMobile: browserDevice.isMobile ?? false,
+            hasTouch: browserDevice.hasTouch ?? false,
         };
-        if (storageState) {
-            contextOptions.storageState = storageState;
+        return {
+            browserTypeName: browserDevice.defaultBrowserType.toLowerCase(),
+            browserContextOptions: browserContextOptions,
+        };
+    }
+    /**
+     * Expands proxy configuration by merging provided proxy settings with environment variables.
+     * Environment variables serve as fallbacks for missing proxy configuration values.
+     *
+     * @param proxy - Optional proxy configuration object
+     * @returns Expanded proxy configuration or undefined if no proxy is configured
+     */
+    static expandProxyConfiguration(proxy) {
+        const envProxyServer = process.env[envVars_1.ENV_VAR_NAMES.PROXY_SERVER];
+        const envProxyUsername = process.env[envVars_1.ENV_VAR_NAMES.PROXY_USERNAME];
+        const envProxyPassword = process.env[envVars_1.ENV_VAR_NAMES.PROXY_PASSWORD];
+        if (!proxy) {
+            return envProxyServer !== undefined
+                ? {
+                    server: envProxyServer,
+                    username: envProxyUsername,
+                    password: envProxyPassword,
+                }
+                : undefined;
         }
-        const launchOptions = {
-            headless,
-            args: [
-                '--ignore-certificate-errors',
-                '--disable-blink-features=AutomationControlled',
-            ],
+        return {
+            server: proxy.server,
+            bypass: proxy.bypass,
+            username: proxy.username ?? envProxyUsername,
+            password: proxy.password ?? envProxyPassword,
         };
+    }
+    /**
+     * Creates a new browser instance of the specified type with given launch and context options.
+     * Handles cleanup by closing the browser if context creation fails.
+     *
+     * @param browserTypeName - The type of browser to launch
+     * @param launchOptions - Options for launching the browser
+     * @param browserContextOptions - Options for creating the browser context
+     * @returns A promise that resolves to an object containing the browser and browser context
+     * @throws {InvalidParamValueException} When an unsupported browser type is specified
+     */
+    static async newBrowser(browserTypeName, launchOptions, browserContextOptions) {
         let browser;
-        switch (device.defaultBrowserType.toLowerCase()) {
+        switch (browserTypeName) {
             case 'firefox':
                 browser = await playwright_1.firefox.launch(launchOptions);
                 break;
@@ -242,10 +357,10 @@ class BrowserUtils {
                 browser = await playwright_1.webkit.launch(launchOptions);
                 break;
             default:
-                throw new InvalidParamValueException_1.InvalidParamValueException('browserType', device.defaultBrowserType);
+                throw new InvalidParamValueException_1.InvalidParamValueException('browserType', browserTypeName);
         }
         try {
-            const browserContext = await browser.newContext(contextOptions);
+            const browserContext = await browser.newContext(browserContextOptions);
             return { browser, browserContext };
         }
         catch (error) {
@@ -260,6 +375,12 @@ class BrowserUtils {
      * The returned browserBaseData object conforms to the response of the session
      * creation API endpoint. See...
      * https://docs.browserbase.com/reference/api/create-a-session#response-id
+     *
+     * @param sessionArgs - Arguments for creating the BrowserBase session
+     * @param outputDir - Directory path where browser artifacts will be stored
+     * @param storageState - Optional browser storage state to restore
+     * @returns A promise that resolves to an object containing the browser, context, and session data
+     * @throws {InvalidParamValueException} When BrowserBase API key is missing or session creation fails
      */
     static async forBrowserBase(sessionArgs, outputDir, storageState) {
         const browserBaseData = await BrowserUtils.establishBrowserBaseSession(sessionArgs);
@@ -278,8 +399,12 @@ class BrowserUtils {
     }
     /**
      * Establishes a BrowserBase session. The returned structure matches the
-     * response structore from the BrowserBase session API. See...
+     * response structure from the BrowserBase session API. See...
      * https://docs.browserbase.com/reference/api/create-a-session#response-id
+     *
+     * @param sessionArgs - Arguments for creating the BrowserBase session
+     * @returns A promise that resolves to the BrowserBase session data
+     * @throws {InvalidParamValueException} When the API key is missing or the API returns an error
      */
     static async establishBrowserBaseSession(sessionArgs) {
         const password = process.env[envVars_1.ENV_VAR_NAMES.BROWSERBASE_API_KEY];
@@ -297,6 +422,13 @@ class BrowserUtils {
         }
         return browserBaseData;
     }
+    /**
+     * Attaches sessionStorage data to a browser context by adding an initialization script.
+     * The script will restore sessionStorage items for each origin when pages are loaded.
+     *
+     * @param browserContext - The browser context to attach sessionStorage to
+     * @param storageState - Optional browser storage state containing sessionStorage data
+     */
     static async attachSessionStorageToBrowserContext(browserContext, storageState) {
         // Add init script to restore sessionStorage if storage state is provided
         if (storageState && storageState.origins) {
@@ -327,6 +459,14 @@ class BrowserUtils {
             }, sessionStorageByOrigin);
         }
     }
+    /**
+     * Patches the close method of a browser context to execute additional cleanup logic.
+     * The extra cleanup function will be called after the original close method completes.
+     * Both the original close and extra cleanup are wrapped in try-catch blocks to prevent errors from propagating.
+     *
+     * @param ctx - The browser context to patch
+     * @param extra - Additional cleanup function to execute when the context is closed
+     */
     static patchClose(ctx, extra) {
         const original = ctx.close.bind(ctx);
         ctx.close = async (...args) => {

package/dist/utils/BrowserUtils.js.map

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

package/dist/utils/JsonUtils.d.ts

@@ -1,18 +1,103 @@
+/**
+ * Utility class for JSON operations including serialization, parsing, and safe object conversion.
+ *
+ * Provides comprehensive JSON handling capabilities including:
+ * - Safe object-to-JSON conversion with circular reference detection
+ * - Resource file reading and parsing with error handling
+ * - JSON string parsing with graceful error recovery
+ *
+ * All methods handle errors gracefully and provide appropriate logging.
+ *
+ * @example
+ * ```typescript
+ * // Safe object serialization
+ * const obj = { name: 'test', date: new Date() };
+ * const safeJson = JsonUtils.objectToJson(obj);
+ *
+ * // Read JSON from resource file
+ * const config = JsonUtils.readResourceAsJson('config.json');
+ *
+ * // Parse JSON string safely
+ * const parsed = JsonUtils.jsonStringToJsonObject('{"key": "value"}');
+ * ```
+ *
+ * @since 1.0.0
+ */
 export declare class JsonUtils {
+    /**
+     * Private constructor to prevent instantiation of this utility class.
+     * All methods are static and should be called directly on the class.
+     */
     private constructor();
+    /**
+     * Converts an object to a JSON-serializable format with comprehensive type handling and circular reference protection.
+     *
+     * Handles special cases including:
+     * - Date objects (converted to ISO strings)
+     * - RegExp objects (converted to string representation)
+     * - Error objects (converted to structured object with name, message, stack)
+     * - Node.js-specific objects (Timeout, EventEmitter, etc. - converted to descriptive strings)
+     * - Circular references (replaced with '[Circular Reference]' string)
+     * - Functions and symbols (excluded from output)
+     *
+     * @param object - The object to convert to JSON-safe format
+     * @returns A JSON-serializable version of the input object, or the original value for primitives
+     *
+     * @example
+     * ```typescript
+     * const complexObj = {
+     *   date: new Date(),
+     *   error: new Error('test'),
+     *   regex: /test/g,
+     *   func: () => {},  // Will be excluded
+     *   circular: null as any
+     * };
+     * complexObj.circular = complexObj;  // Create circular reference
+     *
+     * const safe = JsonUtils.objectToJson(complexObj);
+     * // Result: { date: "2023-...", error: {...}, regex: "/test/g", circular: "[Circular Reference]" }
+     * ```
+     */
     static objectToJson(object: any): any;
-    static readResourceAsJson(source: string): unknown;
-    static jsonStringToJsonObject(jsonString: string): any | null;
     /**
-     * Post-process the given schema to conform with OpenAI constraints
-     * @see https://platform.openai.com/docs/guides/structured-outputs/additionalproperties-false-must-always-be-set-in-objects
+     * Reads and parses a JSON file from the application's resource directory.
+     *
+     * Uses MiscUtils to read the file as a string and then parses it as JSON.
+     * Provides error handling and logging for file read and parse failures.
+     *
+     * @param source - The relative path to the JSON resource file
+     * @returns The parsed JSON object, or null if reading or parsing fails
+     *
+     * @example
+     * ```typescript
+     * // Read configuration from resources
+     * const config = JsonUtils.readResourceAsJson('config/app-settings.json');
+     * if (config) {
+     *   console.log('Config loaded:', config);
+     * } else {
+     *   console.log('Failed to load config');
+     * }
+     * ```
      */
-    private static postProcessJsonSchema;
+    static readResourceAsJson(source: string): any;
     /**
-     * Ensures the given file path exists. If the file does not initially exist,
-     * all directories to it will be created and the file will be created with a
-     * value of an empty JSON object (AKA {}).
+     * Safely parses a JSON string into a JavaScript object.
+     *
+     * Provides error handling and logging for malformed JSON strings.
+     * Returns null instead of throwing an exception when parsing fails.
+     *
+     * @param jsonString - The JSON string to parse
+     * @returns The parsed JavaScript object, or null if parsing fails
+     *
+     * @example
+     * ```typescript
+     * const validJson = '{"name": "test", "value": 123}';
+     * const invalidJson = '{name: "test"}';  // Missing quotes
+     *
+     * const obj1 = JsonUtils.jsonStringToJsonObject(validJson);   // Returns object
+     * const obj2 = JsonUtils.jsonStringToJsonObject(invalidJson); // Returns null
+     * ```
      */
-    static maybeInitEmptyJsonFile(filePath: string): Promise<void>;
+    static jsonStringToJsonObject(jsonString: string): any | null;
 }
 //# sourceMappingURL=JsonUtils.d.ts.map