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

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

@@ -126,6 +126,7 @@ let Page = (() => {
     let _waitForSelector_decorators;
     let _evaluate_decorators;
     let _click_decorators;
+    let _tap_decorators;
     let _hover_decorators;
     let _scroll_decorators;
     let _dragAndDrop_decorators;
@@ -155,6 +156,7 @@ let Page = (() => {
                 })];
             _evaluate_decorators = [FlowLogger_js_1.FlowLogger.wrapWithLogging({ eventType: "PageEvaluate" })];
             _click_decorators = [FlowLogger_js_1.FlowLogger.wrapWithLogging({ eventType: "PageClick" })];
+            _tap_decorators = [FlowLogger_js_1.FlowLogger.wrapWithLogging({ eventType: "PageTap" })];
             _hover_decorators = [FlowLogger_js_1.FlowLogger.wrapWithLogging({ eventType: "PageHover" })];
             _scroll_decorators = [FlowLogger_js_1.FlowLogger.wrapWithLogging({ eventType: "PageScroll" })];
             _dragAndDrop_decorators = [FlowLogger_js_1.FlowLogger.wrapWithLogging({
@@ -175,6 +177,7 @@ let Page = (() => {
             __esDecorate(this, null, _waitForSelector_decorators, { kind: "method", name: "waitForSelector", static: false, private: false, access: { has: obj => "waitForSelector" in obj, get: obj => obj.waitForSelector }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _evaluate_decorators, { kind: "method", name: "evaluate", static: false, private: false, access: { has: obj => "evaluate" in obj, get: obj => obj.evaluate }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _click_decorators, { kind: "method", name: "click", static: false, private: false, access: { has: obj => "click" in obj, get: obj => obj.click }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _tap_decorators, { kind: "method", name: "tap", static: false, private: false, access: { has: obj => "tap" in obj, get: obj => obj.tap }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _hover_decorators, { kind: "method", name: "hover", static: false, private: false, access: { has: obj => "hover" in obj, get: obj => obj.hover }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _scroll_decorators, { kind: "method", name: "scroll", static: false, private: false, access: { has: obj => "scroll" in obj, get: obj => obj.scroll }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _dragAndDrop_decorators, { kind: "method", name: "dragAndDrop", static: false, private: false, access: { has: obj => "dragAndDrop" in obj, get: obj => obj.dragAndDrop }, metadata: _metadata }, null, _instanceExtraInitializers);
@@ -1523,6 +1526,53 @@ let Page = (() => {
             await Promise.all(dispatches);
             return xpathResult ?? "";
         }
+        /**
+         * Tap at absolute page coordinates (CSS pixels) with a real (trusted) touch.
+         * Mirrors {@link click} but synthesizes touch input via `Input.dispatchTouchEvent`
+         * instead of mouse input, so mobile layouts that gate their handlers on
+         * touch/pointer events (`pointerType: "touch"`) — where a synthesized mouse click
+         * never registers — respond correctly. Coordinates are relative to the viewport
+         * origin (top-left). Does not scroll.
+         *
+         * Does not require touch emulation: CDP delivers a trusted touch sequence even on
+         * a session reporting `maxTouchPoints: 0`. Whether the agent *chooses* this over
+         * {@link click} is decided by `V3.usesTouch`.
+         */
+        async tap(x, y, options) {
+            let xpathResult;
+            if (options?.returnXpath) {
+                // Resolve the deepest node at the tap coordinates so a recorded/replayed
+                // step can target it by XPath, mirroring click's returnXpath path.
+                try {
+                    const hit = await (0, index_js_1.resolveXpathForLocation)(this, x, y);
+                    if (hit) {
+                        xpathResult = hit.absoluteXPath;
+                    }
+                }
+                catch {
+                    // best-effort; fall through if resolution fails
+                }
+            }
+            // Keep the cursor overlay in sync with the action, like every other
+            // coordinate action (click/hover/drag), even though touch has no cursor.
+            await this.updateCursor(x, y);
+            // Dispatch touchStart/touchEnd as one pipelined burst, the same way click
+            // batches press/release. CDP processes commands on a session in the order
+            // they were written, so the pair still arrives ordered; awaiting each in
+            // turn only adds a round trip of latency (a full network RTT when the
+            // browser is remote).
+            await Promise.all([
+                this.mainSession.send("Input.dispatchTouchEvent", {
+                    type: "touchStart",
+                    touchPoints: [{ x, y }],
+                }),
+                this.mainSession.send("Input.dispatchTouchEvent", {
+                    type: "touchEnd",
+                    touchPoints: [],
+                }),
+            ]);
+            return xpathResult ?? "";
+        }
         /**
          * Hover at absolute page coordinates (CSS pixels).
          * Dispatches mouseMoved via CDP Input domain on the top-level page target's