@houwert/conductor 0.27.2 → 0.29.0

package/dist/commands/press-key.js

@@ -1,12 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VALID_KEYS = exports.HELP = void 0;
+exports.ANDROID_KEYCODE = exports.VALID_KEYS = exports.HELP = void 0;
+exports.dispatchKey = dispatchKey;
 exports.pressKey = pressKey;
 exports.HELP = `  press-key <key>                     Press a key (Enter, Backspace, Home, ...)
     --long-press                      Hold the button ~1.5s (tvOS remote buttons)
-    --duration <seconds>              Hold for a custom duration (tvOS remote buttons)`;
+    --duration <seconds>              Hold for a custom duration (tvOS remote buttons)
+    --measure                         Time the app's response to the press
+    --repeat <n>                      With --measure, take n samples and report a distribution
+    --sequence <k1,k2,...>            With --repeat, cycle these keys so focus oscillates
+    --timeout <ms>                    With --measure, give up on a sample after n ms (default 3000)
+    --poll-interval <ms>              With --measure, delay between focus polls (default 0)
+    --settle <ms>                     With --measure on Android, render time to allow (default 700)`;
 const runner_js_1 = require("../runner.js");
 const output_js_1 = require("../output.js");
+const input_latency_js_1 = require("./input-latency.js");
 const ios_js_1 = require("../drivers/ios.js");
 const android_js_1 = require("../drivers/android.js");
 const web_js_1 = require("../drivers/web.js");
@@ -87,7 +95,7 @@ const VEGA_REMOTE_BUTTONS = {
     VolumeDown: 'volumeDown',
 };
 // Android keyevent codes
-const ANDROID_KEYCODE = {
+exports.ANDROID_KEYCODE = {
     Home: 3,
     Back: 4,
     Enter: 66,
@@ -124,6 +132,72 @@ const ANDROID_KEYCODE = {
     'TV Input HDMI 2': 244,
     'TV Input HDMI 3': 245,
 };
+/**
+ * Send `key` on an already-connected driver. Split out of `pressKey` so
+ * `--measure` can reuse one driver across repeats instead of paying driver
+ * setup on every sample.
+ */
+async function dispatchKey(driver, matched, holdSeconds) {
+    if (driver instanceof ios_js_1.IOSDriver) {
+        if (driver.platform === 'tvos') {
+            const tvosButton = TVOS_REMOTE_BUTTONS[matched];
+            const iosButton = IOS_BUTTON_MAP[matched];
+            if (tvosButton) {
+                await driver.pressButton(tvosButton, holdSeconds);
+            }
+            else if (iosButton) {
+                await driver.pressButton(iosButton, holdSeconds);
+            }
+            // Keys not mapped on tvOS are silently ignored
+        }
+        else {
+            const iosKey = IOS_KEY_MAP[matched];
+            const iosButton = IOS_BUTTON_MAP[matched];
+            if (iosKey) {
+                await driver.pressKey(iosKey);
+            }
+            else if (iosButton) {
+                await driver.pressButton(iosButton);
+            }
+            // Keys not mapped on iOS (e.g. Back, VolumeUp) are silently ignored
+        }
+    }
+    else if (driver instanceof web_js_1.WebDriver) {
+        const WEB_KEY_MAP = {
+            Enter: 'Enter',
+            Tab: 'Tab',
+            Backspace: 'Backspace',
+            Delete: 'Delete',
+            Escape: 'Escape',
+            Home: 'Home',
+            End: 'End',
+            // Canvas webtv apps (Lightning/WPE) navigate focus via the D-pad, which they listen
+            // for as arrow keys (and Enter for select). Maps the TV remote onto web keyboard.
+            'Remote Dpad Up': 'ArrowUp',
+            'Remote Dpad Down': 'ArrowDown',
+            'Remote Dpad Left': 'ArrowLeft',
+            'Remote Dpad Right': 'ArrowRight',
+            'Remote Dpad Center': 'Enter',
+        };
+        const webKey = WEB_KEY_MAP[matched];
+        if (webKey) {
+            await driver.pressKey(webKey);
+        }
+    }
+    else if (driver instanceof vega_js_1.VegaDriver) {
+        const vegaButton = VEGA_REMOTE_BUTTONS[matched];
+        if (vegaButton) {
+            await driver.pressButton(vegaButton);
+        }
+        // Keys not mapped on vega are silently ignored
+    }
+    else if (driver instanceof android_js_1.AndroidDriver) {
+        const code = exports.ANDROID_KEYCODE[matched];
+        if (code !== undefined) {
+            await driver.pressKeyEvent(code);
+        }
+    }
+}
 async function pressKey(key, opts = {}, sessionName = 'default', flags = {}) {
     // A held press is requested via --long-press (default 1.5s) or an explicit --duration.
     const holdSeconds = flags.duration ?? (flags.longPress ? 1.5 : undefined);
@@ -136,67 +210,39 @@ async function pressKey(key, opts = {}, sessionName = 'default', flags = {}) {
         (0, output_js_1.printError)(`Unknown key "${key}". Valid keys: ${exports.VALID_KEYS.join(', ')}`, opts);
         return 1;
     }
-    const result = await (0, runner_js_1.runDirect)(async (driver) => {
-        if (driver instanceof ios_js_1.IOSDriver) {
-            if (driver.platform === 'tvos') {
-                const tvosButton = TVOS_REMOTE_BUTTONS[matched];
-                const iosButton = IOS_BUTTON_MAP[matched];
-                if (tvosButton) {
-                    await driver.pressButton(tvosButton, holdSeconds);
-                }
-                else if (iosButton) {
-                    await driver.pressButton(iosButton, holdSeconds);
-                }
-                // Keys not mapped on tvOS are silently ignored
-            }
-            else {
-                const iosKey = IOS_KEY_MAP[matched];
-                const iosButton = IOS_BUTTON_MAP[matched];
-                if (iosKey) {
-                    await driver.pressKey(iosKey);
-                }
-                else if (iosButton) {
-                    await driver.pressButton(iosButton);
-                }
-                // Keys not mapped on iOS (e.g. Back, VolumeUp) are silently ignored
+    if (flags.measure) {
+        const sequence = [matched];
+        for (const raw of flags.sequence ?? []) {
+            const k = exports.VALID_KEYS.find((v) => v.toLowerCase() === raw.trim().toLowerCase());
+            if (!k) {
+                (0, output_js_1.printError)(`Unknown key "${raw}" in --sequence. Valid keys: ${exports.VALID_KEYS.join(', ')}`, opts);
+                return 1;
             }
+            sequence.push(k);
         }
-        else if (driver instanceof web_js_1.WebDriver) {
-            const WEB_KEY_MAP = {
-                Enter: 'Enter',
-                Tab: 'Tab',
-                Backspace: 'Backspace',
-                Delete: 'Delete',
-                Escape: 'Escape',
-                Home: 'Home',
-                End: 'End',
-                // Canvas webtv apps (Lightning/WPE) navigate focus via the D-pad, which they listen
-                // for as arrow keys (and Enter for select). Maps the TV remote onto web keyboard.
-                'Remote Dpad Up': 'ArrowUp',
-                'Remote Dpad Down': 'ArrowDown',
-                'Remote Dpad Left': 'ArrowLeft',
-                'Remote Dpad Right': 'ArrowRight',
-                'Remote Dpad Center': 'Enter',
-            };
-            const webKey = WEB_KEY_MAP[matched];
-            if (webKey) {
-                await driver.pressKey(webKey);
-            }
+        const measureOpts = {
+            repeat: flags.repeat ?? 1,
+            timeoutMs: flags.timeoutMs ?? 3000,
+            pollIntervalMs: flags.pollIntervalMs ?? 0,
+            settleMs: flags.settleMs ?? 700,
+            appId: flags.appId,
+            holdSeconds,
+        };
+        try {
+            const report = await (0, input_latency_js_1.measureKeyLatency)(sessionName, sequence, measureOpts);
+            if (opts.json)
+                (0, output_js_1.printData)({ status: 'ok', ...report }, opts);
+            else
+                (0, input_latency_js_1.printLatencyReport)(report);
+            // Nothing measurable at all is a failure; boundary refusals are not.
+            return report.outcomes.moved === 0 && !report.pressToFrame ? 1 : 0;
         }
-        else if (driver instanceof vega_js_1.VegaDriver) {
-            const vegaButton = VEGA_REMOTE_BUTTONS[matched];
-            if (vegaButton) {
-                await driver.pressButton(vegaButton);
-            }
-            // Keys not mapped on vega are silently ignored
+        catch (err) {
+            (0, output_js_1.printError)(`press-key ${matched} --measure — ${err instanceof Error ? err.message : String(err)}`, opts);
+            return 1;
         }
-        else if (driver instanceof android_js_1.AndroidDriver) {
-            const code = ANDROID_KEYCODE[matched];
-            if (code !== undefined) {
-                await driver.pressKeyEvent(code);
-            }
-        }
-    }, sessionName);
+    }
+    const result = await (0, runner_js_1.runDirect)((driver) => dispatchKey(driver, matched, holdSeconds), sessionName);
     if (result.success) {
         (0, output_js_1.printSuccess)(`press-key ${matched} — done`, opts);
         return 0;