execbro 2.8.2 → 2.8.4

package/build/__tests__/unit/tapAndroidSerial.test.js

@@ -0,0 +1,179 @@
+import { describe, it, expect, jest, beforeEach } from "@jest/globals";
+import WebSocket from "ws";
+const TARGET = "emulator-5556";
+const DEFAULT = "emulator-5554";
+const adbCalls = [];
+const verifyCalls = [];
+jest.unstable_mockModule("../../core/exec.js", () => ({
+    execFileAsync: async (file, args) => {
+        if (file === "adb")
+            adbCalls.push(args);
+        if (args?.[0] === "devices") {
+            return { stdout: `List of devices attached\n${DEFAULT}\tdevice\n${TARGET}\tdevice\n`, stderr: "" };
+        }
+        if (args?.includes("wm density"))
+            return { stdout: "Physical density: 160", stderr: "" };
+        return { stdout: "", stderr: "" };
+    },
+    execAsync: async () => ({ stdout: "", stderr: "" }),
+    quoteForDeviceShell: (v) => v,
+    withCancelableTimeout: async (p) => p
+}));
+jest.unstable_mockModule("../../core/deviceResolver.js", () => ({
+    resolveDeviceTarget: async () => ({
+        ok: true,
+        target: {
+            platform: "android",
+            androidSerial: TARGET,
+            deviceName: "sdk_gphone64_arm64",
+            source: "adb-serial"
+        }
+    }),
+    formatResolverError: (e) => e.message
+}));
+jest.unstable_mockModule("../../pro/verifyAction.js", () => ({
+    captureScreenshot: async (platform, udid, deviceId) => {
+        verifyCalls.push({ fn: "captureScreenshot", platform, udid, deviceId });
+        return { buffer: Buffer.from("png"), width: 1080, height: 2400, scaleFactor: 1 };
+    },
+    verifyAndCapture: async (args) => {
+        verifyCalls.push({ fn: "verifyAndCapture", ...args });
+        return { screenshot: undefined, verification: undefined, afterWithMarkerBuffer: null };
+    },
+    burstCaptureAndVerify: async (args) => {
+        verifyCalls.push({ fn: "burstCaptureAndVerify", ...args });
+        return { screenshot: undefined, verification: undefined };
+    },
+    drawTapMarker: async (b) => b,
+    settleAndDiff: async () => null
+}));
+jest.unstable_mockModule("../../pro/overlayGuard.js", () => ({
+    checkOverlayBlocking: async () => null
+}));
+jest.unstable_mockModule("../../core/pressables.js", () => ({
+    pressElement: async () => ({
+        success: true,
+        result: JSON.stringify({
+            needsNativeTap: true,
+            nativeTapTarget: { x: 100, y: 200, unit: "points" },
+            pressed: "Button",
+            totalMatches: 1,
+            text: "Submit",
+            testID: "submit-btn",
+            path: "App > Button",
+            isInput: false
+        })
+    }),
+    findPressableElements: async () => ({ success: true, result: "[]" })
+}));
+const { tap } = await import("../../pro/tap.js");
+const { connectedApps } = await import("../../core/state.js");
+function connectAndroidApp() {
+    connectedApps.set("android-1", {
+        ws: { readyState: WebSocket.OPEN },
+        deviceInfo: {
+            id: "android-1",
+            title: "Hermes React Native",
+            description: "",
+            appId: "com.test",
+            type: "node",
+            webSocketDebuggerUrl: "ws://localhost:8081/android-1",
+            deviceName: "sdk_gphone64_arm64"
+        },
+        port: 8081,
+        platform: "android",
+        adbSerial: TARGET
+    });
+}
+function adbCallsMatching(fragment) {
+    return adbCalls.filter((args) => args.some((a) => a.includes(fragment)));
+}
+function targetsTheResolvedDevice(args) {
+    const i = args.indexOf("-s");
+    return i !== -1 && args[i + 1] === TARGET;
+}
+describe("tap threads the Android serial to the device", () => {
+    beforeEach(() => {
+        adbCalls.length = 0;
+        verifyCalls.length = 0;
+        connectedApps.clear();
+    });
+    it("sends a native coordinate tap to the resolved emulator, not the default one", async () => {
+        await tap({ x: 300, y: 600, native: true, device: TARGET, screenshot: false });
+        const taps = adbCallsMatching("input tap");
+        expect(taps).toHaveLength(1);
+        expect(targetsTheResolvedDevice(taps[0])).toBe(true);
+    });
+    it("captures the verification frames from the resolved emulator", async () => {
+        await tap({ x: 300, y: 600, native: true, device: TARGET, screenshot: false });
+        expect(verifyCalls.length).toBeGreaterThan(0);
+        for (const call of verifyCalls) {
+            expect(call.deviceId).toBe(TARGET);
+        }
+    });
+    it("sends a fiber-resolved tap to the resolved emulator", async () => {
+        connectAndroidApp();
+        await tap({ testID: "submit-btn", device: TARGET, screenshot: false, verify: false });
+        const taps = adbCallsMatching("input tap");
+        expect(taps).toHaveLength(1);
+        expect(targetsTheResolvedDevice(taps[0])).toBe(true);
+        const density = adbCallsMatching("wm density");
+        expect(density.length).toBeGreaterThan(0);
+        expect(density.every(targetsTheResolvedDevice)).toBe(true);
+    });
+    it("dumps the accessibility tree from the resolved emulator", async () => {
+        connectAndroidApp();
+        await tap({
+            text: "Submit",
+            device: TARGET,
+            strategy: "accessibility",
+            screenshot: false,
+            verify: false
+        });
+        const dumps = adbCallsMatching("uiautomator dump");
+        expect(dumps.length).toBeGreaterThan(0);
+        expect(dumps.every(targetsTheResolvedDevice)).toBe(true);
+    });
+    it("screenshots the resolved emulator for OCR", async () => {
+        connectAndroidApp();
+        await tap({
+            text: "Submit",
+            device: TARGET,
+            strategy: "ocr",
+            screenshot: false,
+            verify: false
+        });
+        const caps = adbCallsMatching("screencap");
+        expect(caps.length).toBeGreaterThan(0);
+        expect(caps.every(targetsTheResolvedDevice)).toBe(true);
+    });
+    it("leaves adb on its default device when no device is named", async () => {
+        await tap({ x: 300, y: 600, native: true, screenshot: false, verify: false });
+        const version = adbCalls.filter((args) => args[0] === "version");
+        expect(version.every((args) => !args.includes("-s"))).toBe(true);
+    });
+});
+describe("swipe verification frames come from the resolved emulator", () => {
+    beforeEach(() => {
+        adbCalls.length = 0;
+        verifyCalls.length = 0;
+        connectedApps.clear();
+    });
+    it("captures before/after frames from the target, not adb's default", async () => {
+        const handlers = new Map();
+        jest.unstable_mockModule("../../core/register.js", () => ({
+            registerToolWithTelemetry: (_s, name, _c, handler) => {
+                handlers.set(name, handler);
+            },
+            toolRegistry: new Map()
+        }));
+        const { registerInteractionTools } = await import("../../tools/interactionTools.js");
+        registerInteractionTools({ registerTool: () => { } });
+        await handlers.get("swipe")({ direction: "up", device: TARGET, screenshot: false });
+        expect(verifyCalls.length).toBeGreaterThan(0);
+        for (const call of verifyCalls) {
+            expect(call.deviceId).toBe(TARGET);
+        }
+    });
+});
+//# sourceMappingURL=tapAndroidSerial.test.js.map

package/build/__tests__/unit/tapAndroidSerial.test.js.map

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

package/build/__tests__/unit/tapDuration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tapDuration.test.d.ts.map

package/build/__tests__/unit/tapDuration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tapDuration.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/tapDuration.test.ts"],"names":[],"mappings":""}

package/build/__tests__/unit/tapDuration.test.js

@@ -0,0 +1,168 @@
+import { describe, it, expect, jest, beforeEach } from "@jest/globals";
+import WebSocket from "ws";
+const TARGET = "emulator-5556";
+const HOLD_MS = 800;
+const adbCalls = [];
+const adbOptions = [];
+const axeCalls = [];
+const UI_XML = `<?xml version='1.0' encoding='UTF-8' standalone='yes' ?>
+<hierarchy rotation="0">
+  <node index="0" text="Submit" resource-id="submit-btn" class="android.widget.Button"
+        package="com.test" content-desc="" checkable="false" checked="false" clickable="true"
+        enabled="true" focusable="true" focused="false" scrollable="false" long-clickable="true"
+        password="false" selected="false" bounds="[100,200][400,300]" />
+</hierarchy>`;
+jest.unstable_mockModule("../../core/exec.js", () => ({
+    execFileAsync: async (file, args, options) => {
+        if (file === "adb") {
+            adbCalls.push(args);
+            adbOptions.push(options ?? {});
+        }
+        if (file.endsWith("axe"))
+            axeCalls.push(args);
+        if (args?.[0] === "devices") {
+            return { stdout: `List of devices attached\n${TARGET}\tdevice\n`, stderr: "" };
+        }
+        if (args?.some((a) => a.includes("cat /sdcard/ui_dump.xml"))) {
+            return { stdout: UI_XML, stderr: "" };
+        }
+        if (args?.includes("wm density"))
+            return { stdout: "Physical density: 160", stderr: "" };
+        return { stdout: "", stderr: "" };
+    },
+    execAsync: async () => ({ stdout: "", stderr: "" }),
+    quoteForDeviceShell: (v) => v,
+    withCancelableTimeout: async (p) => p
+}));
+jest.unstable_mockModule("../../core/deviceResolver.js", () => ({
+    resolveDeviceTarget: async () => ({
+        ok: true,
+        target: {
+            platform: "android",
+            androidSerial: TARGET,
+            deviceName: "sdk_gphone64_arm64",
+            source: "adb-serial"
+        }
+    }),
+    formatResolverError: (e) => e.message
+}));
+jest.unstable_mockModule("../../pro/verifyAction.js", () => ({
+    captureScreenshot: async () => ({
+        buffer: Buffer.from("png"),
+        width: 1080,
+        height: 2400,
+        scaleFactor: 1
+    }),
+    verifyAndCapture: async () => ({
+        screenshot: undefined,
+        verification: undefined,
+        afterWithMarkerBuffer: null
+    }),
+    burstCaptureAndVerify: async () => ({ screenshot: undefined, verification: undefined }),
+    drawTapMarker: async (b) => b,
+    settleAndDiff: async () => null
+}));
+jest.unstable_mockModule("../../pro/overlayGuard.js", () => ({
+    checkOverlayBlocking: async () => null
+}));
+let pressElementResult = {
+    needsNativeTap: true,
+    nativeTapTarget: { x: 100, y: 200, unit: "points" },
+    pressed: "Button",
+    totalMatches: 1,
+    text: "Submit",
+    testID: "submit-btn",
+    path: "App > Button",
+    isInput: false
+};
+const pressElementArgs = [];
+jest.unstable_mockModule("../../core/pressables.js", () => ({
+    pressElement: async (opts) => {
+        pressElementArgs.push(opts);
+        return { success: true, result: JSON.stringify(pressElementResult) };
+    },
+    findPressableElements: async () => ({ success: true, result: "[]" })
+}));
+const { tap } = await import("../../pro/tap.js");
+const { androidTap } = await import("../../core/android.js");
+const { connectedApps } = await import("../../core/state.js");
+function connectAndroidApp() {
+    connectedApps.set("android-1", {
+        ws: { readyState: WebSocket.OPEN },
+        deviceInfo: {
+            id: "android-1",
+            title: "Hermes React Native",
+            description: "",
+            appId: "com.test",
+            type: "node",
+            webSocketDebuggerUrl: "ws://localhost:8081/android-1",
+            deviceName: "sdk_gphone64_arm64"
+        },
+        port: 8081,
+        platform: "android",
+        adbSerial: TARGET
+    });
+}
+function inputCommands() {
+    return adbCalls
+        .map((args) => args.find((a) => a.startsWith("input ")))
+        .filter((c) => !!c);
+}
+describe("tap duration — Android", () => {
+    beforeEach(() => {
+        adbCalls.length = 0;
+        adbOptions.length = 0;
+        pressElementArgs.length = 0;
+        connectedApps.clear();
+    });
+    it("holds via a same-point swipe, and gives adb time to finish it", async () => {
+        await androidTap(10, 20, TARGET, HOLD_MS);
+        expect(inputCommands()).toEqual([`input swipe 10 20 10 20 ${HOLD_MS}`]);
+        const swipeCall = adbOptions[adbCalls.findIndex((a) => a.some((s) => s.startsWith("input swipe")))];
+        expect(swipeCall.timeout).toBeGreaterThan(HOLD_MS);
+    });
+    it("still sends a plain tap when no duration is given", async () => {
+        await androidTap(10, 20, TARGET);
+        expect(inputCommands()).toEqual(["input tap 10 20"]);
+    });
+    it("holds on the native coordinate path", async () => {
+        await tap({ x: 300, y: 600, native: true, device: TARGET, duration: HOLD_MS, screenshot: false });
+        expect(inputCommands()).toEqual([`input swipe 300 600 300 600 ${HOLD_MS}`]);
+    });
+    it("holds on the fiber path", async () => {
+        connectAndroidApp();
+        await tap({ testID: "submit-btn", device: TARGET, strategy: "fiber", duration: HOLD_MS, screenshot: false, verify: false });
+        expect(inputCommands()).toEqual([`input swipe 100 200 100 200 ${HOLD_MS}`]);
+    });
+    it("holds on the accessibility path", async () => {
+        connectAndroidApp();
+        await tap({
+            text: "Submit",
+            device: TARGET,
+            strategy: "accessibility",
+            duration: HOLD_MS,
+            screenshot: false,
+            verify: false
+        });
+        expect(inputCommands()).toEqual([`input swipe 250 250 250 250 ${HOLD_MS}`]);
+    });
+    it("leaves every path on a plain tap when duration is omitted", async () => {
+        connectAndroidApp();
+        await tap({ testID: "submit-btn", device: TARGET, strategy: "fiber", screenshot: false, verify: false });
+        expect(inputCommands()).toEqual(["input tap 100 200"]);
+    });
+});
+describe("tap duration — iOS", () => {
+    beforeEach(() => {
+        axeCalls.length = 0;
+        connectedApps.clear();
+    });
+    it("passes the hold to the driver as a delay in seconds", async () => {
+        const { iosTap } = await import("../../core/ios.js");
+        await iosTap(50, 60, { duration: HOLD_MS, udid: "SIM-UDID" });
+        const touch = axeCalls.find((a) => a[0] === "touch");
+        expect(touch).toBeDefined();
+        expect(touch).toEqual(expect.arrayContaining(["--down", "--up", "--delay", "0.8"]));
+    });
+});
+//# sourceMappingURL=tapDuration.test.js.map

package/build/__tests__/unit/tapDuration.test.js.map

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

package/build/__tests__/unit/tapLongPressReport.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tapLongPressReport.test.d.ts.map

package/build/__tests__/unit/tapLongPressReport.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tapLongPressReport.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/tapLongPressReport.test.ts"],"names":[],"mappings":""}

package/build/__tests__/unit/tapLongPressReport.test.js

@@ -0,0 +1,167 @@
+import { describe, it, expect, jest, beforeEach } from "@jest/globals";
+import WebSocket from "ws";
+const TARGET = "emulator-5556";
+const HOLD_MS = 800;
+jest.unstable_mockModule("../../core/exec.js", () => ({
+    execFileAsync: async (_file, args) => {
+        if (args?.[0] === "devices") {
+            return { stdout: `List of devices attached\n${TARGET}\tdevice\n`, stderr: "" };
+        }
+        if (args?.some((a) => a.includes("cat /sdcard/ui_dump.xml"))) {
+            return {
+                stdout: `<?xml version='1.0' encoding='UTF-8' standalone='yes' ?>
+<hierarchy rotation="0">
+  <node index="0" text="Gift card" resource-id="gift-card" class="android.widget.Button"
+        package="com.test" content-desc="" checkable="false" checked="false" clickable="true"
+        enabled="true" focusable="true" focused="false" scrollable="false" long-clickable="true"
+        password="false" selected="false" bounds="[100,200][400,300]" />
+</hierarchy>`,
+                stderr: ""
+            };
+        }
+        if (args?.includes("wm density"))
+            return { stdout: "Physical density: 160", stderr: "" };
+        return { stdout: "", stderr: "" };
+    },
+    execAsync: async () => ({ stdout: "", stderr: "" }),
+    quoteForDeviceShell: (v) => v,
+    withCancelableTimeout: async (p) => p
+}));
+jest.unstable_mockModule("../../core/deviceResolver.js", () => ({
+    resolveDeviceTarget: async () => ({
+        ok: true,
+        target: {
+            platform: "android",
+            androidSerial: TARGET,
+            deviceName: "sdk_gphone64_arm64",
+            source: "adb-serial"
+        }
+    }),
+    formatResolverError: (e) => e.message
+}));
+jest.unstable_mockModule("../../pro/verifyAction.js", () => ({
+    captureScreenshot: async () => ({
+        buffer: Buffer.from("png"),
+        width: 1080,
+        height: 2400,
+        scaleFactor: 1
+    }),
+    verifyAndCapture: async () => ({
+        screenshot: undefined,
+        verification: undefined,
+        afterWithMarkerBuffer: null
+    }),
+    burstCaptureAndVerify: async () => ({ screenshot: undefined, verification: undefined }),
+    drawTapMarker: async (b) => b,
+    settleAndDiff: async () => null
+}));
+jest.unstable_mockModule("../../pro/overlayGuard.js", () => ({
+    checkOverlayBlocking: async () => null
+}));
+let hasLongPress = true;
+const pressElementArgs = [];
+jest.unstable_mockModule("../../core/pressables.js", () => ({
+    pressElement: async (opts) => {
+        pressElementArgs.push(opts);
+        return {
+            success: true,
+            result: JSON.stringify({
+                needsNativeTap: true,
+                nativeTapTarget: { x: 100, y: 200, unit: "points" },
+                pressed: "GiftCard",
+                totalMatches: 1,
+                text: "Gift card",
+                testID: "gift-card",
+                path: "App > GiftCard",
+                isInput: false,
+                hasLongPress
+            })
+        };
+    },
+    findPressableElements: async () => ({ success: true, result: "[]" })
+}));
+const { tap } = await import("../../pro/tap.js");
+const { connectedApps } = await import("../../core/state.js");
+function connectAndroidApp() {
+    connectedApps.set("android-1", {
+        ws: { readyState: WebSocket.OPEN },
+        deviceInfo: {
+            id: "android-1",
+            title: "Hermes React Native",
+            description: "",
+            appId: "com.test",
+            type: "node",
+            webSocketDebuggerUrl: "ws://localhost:8081/android-1",
+            deviceName: "sdk_gphone64_arm64"
+        },
+        port: 8081,
+        platform: "android",
+        adbSerial: TARGET
+    });
+}
+const fiberTap = (extra = {}) => tap({
+    testID: "gift-card",
+    device: TARGET,
+    strategy: "fiber",
+    screenshot: false,
+    verify: false,
+    ...extra
+});
+describe("what a long press reports", () => {
+    beforeEach(() => {
+        pressElementArgs.length = 0;
+        connectedApps.clear();
+        hasLongPress = true;
+    });
+    it("says nothing about long press when none was requested", async () => {
+        connectAndroidApp();
+        const result = await fiberTap();
+        expect(result.longPress).toBeUndefined();
+        expect(pressElementArgs[0].longPress).toBe(false);
+    });
+    it("confirms the element has a long-press handler", async () => {
+        connectAndroidApp();
+        const result = await fiberTap({ duration: HOLD_MS });
+        expect(result.success).toBe(true);
+        expect(result.longPress).toMatchObject({ durationMs: HOLD_MS, handlerFound: true });
+        expect(result.longPress?.warning).toBeUndefined();
+        expect(pressElementArgs[0].longPress).toBe(true);
+    });
+    it("warns when the element has no long-press handler, without failing the tap", async () => {
+        hasLongPress = false;
+        connectAndroidApp();
+        const result = await fiberTap({ duration: HOLD_MS });
+        expect(result.success).toBe(true);
+        expect(result.longPress?.handlerFound).toBe(false);
+        expect(result.longPress?.warning).toMatch(/onLongPress/);
+        expect(result.longPress?.warning).toMatch(/GiftCard/);
+    });
+    it("admits it cannot know on an accessibility tap either", async () => {
+        connectAndroidApp();
+        const result = await tap({
+            text: "Gift card",
+            device: TARGET,
+            strategy: "accessibility",
+            duration: HOLD_MS,
+            screenshot: false,
+            verify: false
+        });
+        expect(result.success).toBe(true);
+        expect(result.method).toBe("accessibility");
+        expect(result.longPress).toMatchObject({ durationMs: HOLD_MS, handlerFound: null });
+    });
+    it("admits it cannot know on a coordinate tap", async () => {
+        const result = await tap({
+            x: 300,
+            y: 600,
+            native: true,
+            device: TARGET,
+            duration: HOLD_MS,
+            screenshot: false
+        });
+        expect(result.success).toBe(true);
+        expect(result.longPress).toMatchObject({ durationMs: HOLD_MS, handlerFound: null });
+        expect(result.longPress?.warning).toBeUndefined();
+    });
+});
+//# sourceMappingURL=tapLongPressReport.test.js.map

package/build/__tests__/unit/tapLongPressReport.test.js.map

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

package/build/__tests__/unit/textEntry.test.js

@@ -314,4 +314,36 @@ describe("retry clearing", () => {
         expect(ops).toContain("clear");
     });
 });
+describe("resolving through a screen transition", () => {
+    const miss = (reason = "no TextInput matched that target (1 input(s) mounted)") => ({
+        found: false,
+        reason,
+        candidates: [],
+        totalInputs: 1
+    });
+    it("re-resolves a targeted miss once before failing", async () => {
+        const d = deps([miss(), found(), found({ value: "hi" }), found({ value: "hi" })], { delay: jest.fn(async () => { }) });
+        const r = await enterText({ text: "hi", testID: "message-text-input" }, d);
+        expect(r.success).toBe(true);
+        expect(opsOf(d).filter((k) => k === "find")).toHaveLength(2);
+    });
+    it("gives up after the one retry", async () => {
+        const d = deps([miss(), miss()], { delay: jest.fn(async () => { }) });
+        const r = await enterText({ text: "hi", testID: "message-text-input" }, d);
+        expect(r.success).toBe(false);
+        expect(opsOf(d).filter((k) => k === "find")).toHaveLength(2);
+    });
+    it("does not wait on an ambiguous match — waiting cannot resolve a choice", async () => {
+        const d = deps([{ found: false, ambiguous: true, reason: "2 inputs match this target" }], { delay: jest.fn(async () => { }) });
+        const r = await enterText({ text: "hi", testID: "message-text-input" }, d);
+        expect(r.success).toBe(false);
+        expect(opsOf(d).filter((k) => k === "find")).toHaveLength(1);
+    });
+    it("does not retry an untargeted call — nothing has focus now and waiting will not change that", async () => {
+        const d = deps([miss("no focused TextInput. Pass testID")], { delay: jest.fn(async () => { }) });
+        const r = await enterText({ text: "hi" }, d);
+        expect(r.success).toBe(false);
+        expect(opsOf(d).filter((k) => k === "find")).toHaveLength(1);
+    });
+});
 //# sourceMappingURL=textEntry.test.js.map