@browserbasehq/orca 3.7.1-preview.0 → 3.7.2-preview.1

package/dist/cjs/lib/v3/v3.d.ts

@@ -73,6 +73,14 @@ export declare class V3 {
      * @deprecated Use `isVerified` instead. This alias will be removed in a future version.
      */
     get isAdvancedStealth(): boolean;
+    /**
+     * Whether coordinate pointer actions should actuate as touch instead of mouse.
+     *
+     * Explicit opt-in via the `useTouch` option — no session-derived or probed
+     * detection, so the answer is known before the first action, is stable for the
+     * whole run, and never surprises a caller who didn't ask for touch.
+     */
+    get usesTouch(): boolean;
     /**
      * Returns the configured viewport dimensions from launch options.
      * Falls back to default 1288x711 if not configured.
@@ -81,6 +89,12 @@ export declare class V3 {
         width: number;
         height: number;
     };
+    get hasConfiguredViewport(): boolean;
+    private rawConfiguredViewport;
+    resolveViewport(): Promise<{
+        width: number;
+        height: number;
+    }>;
     private _onCdpClosed;
     readonly experimental: boolean;
     readonly logInferenceToFile: boolean;

package/dist/cjs/lib/v3/v3.js

@@ -231,27 +231,52 @@ let V3 = (() => {
         get isAdvancedStealth() {
             return this.isVerified;
         }
+        /**
+         * Whether coordinate pointer actions should actuate as touch instead of mouse.
+         *
+         * Explicit opt-in via the `useTouch` option — no session-derived or probed
+         * detection, so the answer is known before the first action, is stable for the
+         * whole run, and never surprises a caller who didn't ask for touch.
+         */
+        get usesTouch() {
+            return this.opts.useTouch === true;
+        }
         /**
          * Returns the configured viewport dimensions from launch options.
          * Falls back to default 1288x711 if not configured.
          */
         get configuredViewport() {
-            const defaultWidth = 1288;
-            const defaultHeight = 711;
-            if (this.opts.env === "BROWSERBASE") {
-                const vp = this.opts.browserbaseSessionCreateParams?.browserSettings?.viewport;
-                return {
-                    width: vp?.width ?? defaultWidth,
-                    height: vp?.height ?? defaultHeight,
-                };
-            }
-            // LOCAL env
-            const vp = this.opts.localBrowserLaunchOptions?.viewport;
+            const viewport = this.rawConfiguredViewport();
             return {
-                width: vp?.width ?? defaultWidth,
-                height: vp?.height ?? defaultHeight,
+                width: viewport?.width ?? 1288,
+                height: viewport?.height ?? 711,
             };
         }
+        get hasConfiguredViewport() {
+            return this.rawConfiguredViewport() !== undefined;
+        }
+        rawConfiguredViewport() {
+            if (this.opts.env === "BROWSERBASE") {
+                return this.opts.browserbaseSessionCreateParams?.browserSettings
+                    ?.viewport;
+            }
+            return this.opts.localBrowserLaunchOptions?.viewport;
+        }
+        async resolveViewport() {
+            const configured = this.rawConfiguredViewport();
+            if (configured)
+                return this.configuredViewport;
+            try {
+                const page = await this.context.awaitActivePage();
+                const { width, height } = await page.mainFrame().evaluate("({ width: window.innerWidth, height: window.innerHeight })");
+                if (width && height)
+                    return { width, height };
+            }
+            catch {
+                //
+            }
+            return this.configuredViewport;
+        }
         _onCdpClosed = (why) => {
             if (this.state.kind === "BROWSERBASE") {
                 void this._logBrowserbaseSessionStatus();
@@ -899,6 +924,7 @@ let V3 = (() => {
                                 verbose: this.verbose,
                                 systemPrompt: this.opts.systemPrompt,
                                 selfHeal: this.opts.selfHeal,
+                                useTouch: this.opts.useTouch,
                                 browserbaseSessionCreateParams: createSessionPayload,
                                 browserbaseSessionID: this.opts.browserbaseSessionID,
                             });