@delacour/warden-e2e 0.3.1 → 0.5.0

package/{chunk-8em9kgsk.mjs → chunk-j9b17ade.mjs}

@@ -64,10 +64,17 @@ var READS = new Set([
   "previous",
   "peek"
 ]);
+var WAITS = new Set(["settle"]);
 var READS_WITHOUT_ARGUMENT = new Set(["orientation", "appearance", "clipboard"]);
 function isCall(value) {
   return typeof value === "function";
 }
+function reportsQuiet(result) {
+  if (typeof result !== "object" || result === null || !("success" in result) || result.success !== true)
+    return false;
+  const data = "data" in result ? result.data : undefined;
+  return typeof data === "object" && data !== null && "quiet" in data && data.quiet === true;
+}
 function isThenable(value) {
   return typeof value === "object" && value !== null && "then" in value && typeof value.then === "function";
 }
@@ -137,21 +144,31 @@ function cacheObservations(driver, options = {}) {
       return { success: true, data: reader.alertIn(taken.data) };
     };
   };
-  const asInput = (fn, target) => {
+  const edged = (fn, target, edge) => {
     return (...args) => {
-      inputEdge();
+      edge();
       let result;
       try {
         result = Reflect.apply(fn, target, args);
       } catch (error) {
-        inputEdge();
+        edge();
         throw error;
       }
       if (!isThenable(result)) {
-        inputEdge();
+        edge();
         return result;
       }
-      return Promise.resolve(result).finally(inputEdge);
+      return Promise.resolve(result).finally(edge);
+    };
+  };
+  const asInput = (fn, target) => edged(fn, target, inputEdge);
+  const asWait = (fn, target) => {
+    const waited = edged(fn, target, moveOn);
+    return async (...args) => {
+      const result = await waited(...args);
+      if (reportsQuiet(result))
+        lastInputAt = undefined;
+      return result;
     };
   };
   const wrapMember = (name, value, target) => {
@@ -159,6 +176,8 @@ function cacheObservations(driver, options = {}) {
       return wrap(value, {});
     if (!isCall(value) || READS.has(name))
       return value;
+    if (WAITS.has(name))
+      return asWait(value, target);
     const input = asInput(value, target);
     if (!READS_WITHOUT_ARGUMENT.has(name))
       return input;
@@ -271,6 +290,9 @@ function canSelectAll(driver) {
 function canSetText(driver) {
   return typeof driver.setText === "function";
 }
+function canPasteText(driver) {
+  return typeof driver.pasteText === "function";
+}
 var segmenter = new Intl.Segmenter(undefined, { granularity: "grapheme" });
 function graphemesOf(text) {
   return Array.from(segmenter.segment(text), (part) => part.segment);
@@ -921,7 +943,7 @@ async function focusAndClear(driver, sleep, point, entry, method = "auto") {
     return prepared;
   return prepared.data.pending === "selection" ? pressKeys(driver, sleep, "Backspace", 1) : ok(undefined);
 }
-async function focusClearType(driver, sleep, point, entry, text, method = "auto", env = process.env) {
+async function focusClearType(driver, sleep, point, entry, text, method = "auto", env = process.env, via = "paste") {
   const wantsSetText = method === "setText" || method === "auto" && setTextOptedIn(env);
   if (wantsSetText && entry !== undefined && fieldContent(entry).kind === "text" && canSetText(driver)) {
     const focused = await driver.tap(point);
@@ -930,15 +952,20 @@ async function focusClearType(driver, sleep, point, entry, text, method = "auto"
     const replaced = await driver.setText(text);
     if (replaced.success)
       return replaced;
-    return typeOver(driver, sleep, await prepareFocused(driver, sleep, entry, method), text);
+    return typeOver(driver, sleep, await prepareFocused(driver, sleep, entry, method), text, "type");
   }
-  return typeOver(driver, sleep, await focusAndSelect(driver, sleep, point, entry, method), text);
+  return typeOver(driver, sleep, await focusAndSelect(driver, sleep, point, entry, method), text, via);
 }
-async function typeOver(driver, sleep, prepared, text) {
+async function typeOver(driver, sleep, prepared, text, via) {
   if (!prepared.success)
     return prepared;
   if (text === "")
     return prepared.data.pending === "selection" ? pressKeys(driver, sleep, "Backspace", 1) : ok(undefined);
+  if (via === "paste" && canPasteText(driver)) {
+    const pasted = await driver.pasteText(text);
+    if (pasted.success)
+      return pasted;
+  }
   return typeText(driver, sleep, text);
 }
 
@@ -1750,10 +1777,20 @@ class Locator {
     const reason = blockedReason(entry, spec, observed);
     if (reason !== undefined)
       return { done: false, state: { kind: "blocked", reason, snapshot: observed.snapshot } };
-    if (!anyFrame && !this.heldStill(entry, observation.earlier))
-      return "moving";
+    if (!anyFrame && !this.heldStill(entry, observation.earlier)) {
+      const compared = observation.earlier?.previous !== undefined;
+      if (compared || !await this.stillByHitTest(entry, observed))
+        return "moving";
+    }
     return { done: true, value: { entry, observed } };
   }
+  async stillByHitTest(entry, observed) {
+    const { driver } = observed;
+    if (driver.capabilities.cheapHitTest !== true || this.rt.host.answerSystemAlert !== undefined)
+      return false;
+    const hit = await driver.elementAtPoint(tapPointOf(entry));
+    return hit.success && hit.data !== null && sameElement(hit.data, entry.element);
+  }
   heldStill(entry, earlier) {
     if (earlier === undefined)
       return true;
@@ -1851,14 +1888,15 @@ class Locator {
     });
   }
   async fill(text, options = {}) {
-    assertOptions("fill", options, ["timeout"]);
+    assertOptions("fill", options, ["via", "timeout"]);
+    const via = fillViaOf(this, options.via);
     return this.act("fill", async () => {
       const budget = this.rt.budget(options.timeout);
       let target = await this.actionable({ enabled: true, tapPointOnScreen: false }, budget.remaining());
       let firstHeld;
       for (let attempt = 1;; attempt += 1) {
         const point = focusPoint(target.entry.element.frame);
-        this.rt.drive("fill", await focusClearType(target.observed.driver, this.pause, point, target.entry, text, clearMethodFor(attempt)));
+        this.rt.drive("fill", await focusClearType(target.observed.driver, this.pause, point, target.entry, text, clearMethodFor(attempt), process.env, viaFor(attempt, via)));
         if (target.entry.secure)
           return;
         const outcome = await this.confirm(target, text, budget);
@@ -2067,6 +2105,14 @@ function retryPlan(options) {
 function describeUntil(until) {
   return typeof until === "function" ? "check" : String(until);
 }
+function fillViaOf(locator, via) {
+  if (via === undefined || via === "paste" || via === "type")
+    return via ?? "paste";
+  throw new E2eError2("INVALID_ARGUMENT", `${locator}: fill via must be "paste" or "type", got ${JSON.stringify(via)}`);
+}
+function viaFor(attempt, via) {
+  return attempt === 1 ? via : "type";
+}
 function clearMethodFor(attempt) {
   return attempt === 1 ? "auto" : "counted";
 }
@@ -2313,7 +2359,7 @@ async function openCdp(wsUrl, options = {}) {
     if (method)
       dispatch(method, params);
   });
-  ws.addEventListener("close", () => {
+  ws.addEventListener("close", (event) => {
     if (closed)
       return;
     closed = true;
@@ -2326,7 +2372,7 @@ async function openCdp(wsUrl, options = {}) {
       binding.settle(devtoolsErr("cdp_closed", "CDP connection closed"));
     if (!intentional)
       for (const handler of [...closeHandlers])
-        handler();
+        handler({ code: event.code, reason: event.reason });
   });
   const subscribe = (set, handler) => {
     set.add(handler);
@@ -2427,7 +2473,8 @@ var stackTraceSchema = z2.looseObject({
   callFrames: z2.array(z2.looseObject({
     url: z2.string().optional(),
     lineNumber: z2.number().optional(),
-    columnNumber: z2.number().optional()
+    columnNumber: z2.number().optional(),
+    functionName: z2.string().optional()
   }))
 });
 var consoleCalledSchema = z2.looseObject({
@@ -2438,7 +2485,7 @@ var consoleCalledSchema = z2.looseObject({
 });
 var exceptionThrownSchema = z2.looseObject({
   timestamp: z2.number().optional(),
-  exceptionDetails: exceptionDetailsSchema
+  exceptionDetails: exceptionDetailsSchema.extend({ stackTrace: stackTraceSchema.optional() })
 });
 var LEVELS = {
   log: "log",
@@ -2529,6 +2576,20 @@ function sourceOf(url, line, col) {
     return;
   return { url, line: (line ?? 0) + 1, col: (col ?? 0) + 1 };
 }
+function framesOf(trace) {
+  const frames = [];
+  for (const frame of trace?.callFrames ?? []) {
+    if (!frame.url)
+      continue;
+    frames.push({
+      file: frame.url,
+      line: (frame.lineNumber ?? 0) + 1,
+      col: (frame.columnNumber ?? 0) + 1,
+      ...frame.functionName ? { fn: frame.functionName } : {}
+    });
+  }
+  return frames.length > 0 ? frames : undefined;
+}
 var lineKey = (ts, text) => `${ts}\x00${text}`;
 function createConsoleCapture(options = {}) {
   const ring = options.ring ?? DEFAULT_RING;
@@ -2576,13 +2637,15 @@ function createConsoleCapture(options = {}) {
     const formatted = formatConsoleArgs(args);
     const frame = stackTrace?.callFrames[0];
     const source = sourceOf(frame?.url, frame?.lineNumber, frame?.columnNumber);
+    const stack = framesOf(stackTrace);
     return {
       ts: timestamp ?? now(),
       level: LEVELS[type] ?? "log",
       kind: "console",
       text: formatted.text,
       args: formatted.args,
-      ...source ? { source } : {}
+      ...source ? { source } : {},
+      ...stack ? { stack } : {}
     };
   };
   const fromException = (params) => {
@@ -2591,12 +2654,14 @@ function createConsoleCapture(options = {}) {
       return;
     const { exceptionDetails: details, timestamp } = parsed.data;
     const source = sourceOf(details.url, details.lineNumber, details.columnNumber);
+    const stack = framesOf(details.stackTrace);
     return {
       ts: timestamp ?? now(),
       level: "error",
       kind: "exception",
       text: describeException(details),
-      ...source ? { source } : {}
+      ...source ? { source } : {},
+      ...stack ? { stack } : {}
     };
   };
   return {
@@ -2620,6 +2685,71 @@ function createConsoleCapture(options = {}) {
   };
 }
 
+// ../../packages/e2e/src/devtools/logbox.script.ts
+var LOGBOX_SCRIPT = `function (g) {
+  var req = g.__r;
+  if (typeof req !== "function" || typeof req.getModules !== "function") return "no-require";
+  var modules = req.getModules();
+  if (!modules || typeof modules.forEach !== "function") return "no-require";
+  var data = null;
+  modules.forEach(function (mod) {
+    if (data || !mod || typeof mod.verboseName !== "string" || !mod.isInitialized) return;
+    var name = mod.verboseName.replace(/\\\\/g, "/");
+    if (!/(^|\\/)react-native\\/Libraries\\/LogBox\\/Data\\/LogBoxData\\.js$/.test(name)) return;
+    var exports = mod.publicModule && mod.publicModule.exports;
+    if (exports && typeof exports.addIgnorePatterns === "function") data = exports;
+  });
+  if (!data) return "not-ready";
+  data.addIgnorePatterns([/[\\s\\S]*/]);
+  if (typeof data.setDisabled === "function") data.setDisabled(true);
+  if (typeof data.setSelectedLog === "function") data.setSelectedLog(-1);
+  return "off";
+}`;
+var LOGBOX_EXPRESSION = `(${LOGBOX_SCRIPT})(typeof globalThis !== "undefined" ? globalThis : (typeof global !== "undefined" ? global : this))`;
+
+// ../../packages/e2e/src/devtools/logbox.ts
+var INTERVAL_MS = 250;
+var ATTEMPTS = 80;
+var timerSleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+function muteLogBox(session, options = {}) {
+  const sleep = options.sleep ?? timerSleep;
+  const intervalMs = options.intervalMs ?? INTERVAL_MS;
+  const attempts = options.attempts ?? ATTEMPTS;
+  let generation = 0;
+  let stopped = false;
+  async function tryOnce() {
+    const reply = await session.evaluate(LOGBOX_EXPRESSION);
+    if (!reply.success)
+      return reply.error.message;
+    return reply.data === "off" ? undefined : String(reply.data);
+  }
+  async function apply(mine) {
+    const current = () => !stopped && mine === generation;
+    let last = "no reply";
+    for (let attempt = 1;attempt <= attempts && current(); attempt++) {
+      last = await tryOnce();
+      if (last === undefined)
+        return;
+      if (attempt < attempts)
+        await sleep(intervalMs);
+    }
+    if (current())
+      options.log?.(`devtools: LogBox left on (${last} after ${attempts} attempts)`);
+  }
+  const start = () => apply(++generation);
+  const off = session.on("reconnected", () => {
+    start();
+  });
+  const settled = start();
+  return {
+    settled,
+    stop() {
+      stopped = true;
+      off();
+    }
+  };
+}
+
 // ../../packages/e2e/src/devtools/network.ts
 import { z as z3 } from "zod";
 
@@ -2760,10 +2890,10 @@ var pageEntrySchema = z3.looseObject({
   responseBodyTruncated: z3.boolean().optional(),
   error: z3.string().optional()
 });
-var timerSleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+var timerSleep2 = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 async function attachNetwork(session, options = {}) {
   const ring = options.ring ?? DEFAULT_RING2;
-  const sleep = options.sleep ?? timerSleep;
+  const sleep = options.sleep ?? timerSleep2;
   const pollMs = options.pollMs ?? DEFAULT_POLL_MS2;
   const installExpression = networkInstallExpression({
     ring,
@@ -3009,13 +3139,13 @@ var RECONNECT_BUDGET_MS = 30000;
 var RELOAD_WAIT_MS = 5000;
 var HANDSHAKE_OPTIONAL_TIMEOUT_MS = 3000;
 var RELOAD_EXPRESSION = '(function(){var g=globalThis;if(g.expo&&typeof g.expo.reloadAppAsync==="function"){setTimeout(function(){g.expo.reloadAppAsync("warden e2e reloadJs")},0);return "expo"}var m=g.nativeModuleProxy&&g.nativeModuleProxy.DevSettings;if(m&&typeof m.reload==="function"){setTimeout(function(){m.reload()},0);return "devsettings"}return false})()';
-var timerSleep2 = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+var timerSleep3 = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 async function connectDevtools(o) {
   const { metroUrl } = o;
   if (!metroUrl) {
     return devtoolsErr("devtools_unavailable", "no Metro URL: release builds have no devtools (start a dev client)");
   }
-  const sleep = o.sleep ?? timerSleep2;
+  const sleep = o.sleep ?? timerSleep3;
   const log = o.log ?? (() => {
     return;
   });
@@ -3033,7 +3163,8 @@ async function connectDevtools(o) {
   const cdpHandlers = new Map;
   const eventHandlers = {
     reconnected: new Set,
-    lost: new Set
+    lost: new Set,
+    yielded: new Set
   };
   let unsubscribeCdp = [];
   let connection = 0;
@@ -3083,9 +3214,17 @@ async function connectDevtools(o) {
       for (const handler of handlers)
         unsubscribeCdp.push(attached.cdp.on(method, handler));
     }
-    attached.cdp.onClose(() => {
-      if (state.kind === "up" && state.attached.cdp === attached.cdp)
-        reconnect("socket closed");
+    attached.cdp.onClose((info) => {
+      if (state.kind !== "up" || state.attached.cdp !== attached.cdp)
+        return;
+      if (o.yieldOnClose?.(info)) {
+        state = { kind: "closed" };
+        log(`devtools: yielded (${info.code} ${info.reason})`);
+        for (const handler of [...eventHandlers.yielded])
+          handler(info);
+        return;
+      }
+      reconnect("socket closed");
     });
     attached.cdp.on("Runtime.executionContextsCleared", () => {
       if (state.kind === "up" && state.attached.cdp === attached.cdp)
@@ -3782,7 +3921,7 @@ var scriptResultSchema = z5.union([
   z5.object({ screen: z5.string().optional(), components: z5.array(componentSchema), truncated: z5.boolean() })
 ]);
 var bindingPayloadSchema2 = z5.object({ requestId: z5.string(), result: z5.unknown() });
-var timerSleep3 = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+var timerSleep4 = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 var requestCounter = 0;
 function scriptError(message) {
   if (message === "no-hook")
@@ -3845,7 +3984,7 @@ async function viaBinding(session, expression, requestId, timeoutMs) {
 }
 async function fetchTree(session, options = {}, deps = {}) {
   const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS2;
-  const resolved = { sleep: deps.sleep ?? timerSleep3, now: deps.now ?? Date.now };
+  const resolved = { sleep: deps.sleep ?? timerSleep4, now: deps.now ?? Date.now };
   requestCounter += 1;
   const requestId = `tree-${Date.now().toString(36)}-${requestCounter}`;
   const config = {
@@ -3896,6 +4035,7 @@ async function openDevtoolsFacet(o) {
     return attached;
   }
   const network = attached.data;
+  const logbox = o.muteLogBox ? muteLogBox(session, { log: o.log }) : undefined;
   return ok({
     evaluate: (expression, options) => session.evaluate(expression, options),
     reloadJs: () => session.reloadJs(),
@@ -3921,6 +4061,7 @@ async function openDevtoolsFacet(o) {
       return ok(paths);
     },
     close() {
+      logbox?.stop();
       network.stop();
       session.close();
     }
@@ -3937,6 +4078,25 @@ function spawnFailure(cmd, cwd, error) {
     return `cannot run \`${cmd.join(" ")}\`: no such directory ${cwd}`;
   return `cannot run \`${cmd.join(" ")}\`: ${error instanceof Error ? error.message : String(error)}`;
 }
+async function readLines(stream, onLine) {
+  const decoder = new TextDecoder;
+  let text = "";
+  let pending = "";
+  for await (const chunk of stream) {
+    const piece = decoder.decode(chunk, { stream: true });
+    text += piece;
+    const lines = (pending + piece).split(/\r?\n/);
+    pending = lines.pop() ?? "";
+    for (const line of lines)
+      onLine(line);
+  }
+  const rest = decoder.decode();
+  text += rest;
+  pending += rest;
+  if (pending !== "")
+    onLine(pending);
+  return text;
+}
 var bunExec = async (cmd, opts = {}) => {
   try {
     const proc = Bun.spawn([...cmd], {
@@ -3948,11 +4108,9 @@ var bunExec = async (cmd, opts = {}) => {
       timeout: opts.timeoutMs,
       ...opts.signal !== undefined ? { signal: opts.signal } : {}
     });
-    const [stdout, stderr, exitCode] = await Promise.all([
-      new Response(proc.stdout).text(),
-      new Response(proc.stderr).text(),
-      proc.exited
-    ]);
+    const { onLine } = opts;
+    const read = (stream) => onLine ? readLines(stream, onLine) : new Response(stream).text();
+    const [stdout, stderr, exitCode] = await Promise.all([read(proc.stdout), read(proc.stderr), proc.exited]);
     return { exitCode, stdout, stderr };
   } catch (error) {
     return { exitCode: 127, stdout: "", stderr: spawnFailure(cmd, opts.cwd, error) };
@@ -4186,6 +4344,8 @@ var frontmostDataSchema = z6.looseObject({
   pid: z6.number().optional(),
   frontmostPid: z6.number().optional()
 });
+var launchDataSchema = z6.looseObject({ pid: z6.number() });
+var terminateDataSchema = z6.looseObject({ terminated: z6.boolean() });
 var orientationDataSchema = z6.object({
   orientation: z6.enum([
     "portrait",
@@ -4207,7 +4367,9 @@ var opSchemas = {
   rebind: rebindDataSchema,
   alertButtons: alertButtonsDataSchema,
   frontmost: frontmostDataSchema,
-  orientation: orientationDataSchema
+  orientation: orientationDataSchema,
+  launch: launchDataSchema,
+  terminate: terminateDataSchema
 };
 function hasOpSchema(op) {
   return Object.hasOwn(opSchemas, op);
@@ -5108,7 +5270,8 @@ var openDevtools = (env) => openDevtoolsFacet({
   WebSocket,
   timeoutMs: 5000,
   log: (line) => process.stderr.write(`[devtools] ${line}
-`)
+`),
+  muteLogBox: true
 });
 var SESSION_KEY = Symbol.for("@delacour/warden-e2e/session");
 var slot = () => globalThis;
@@ -5855,6 +6018,6 @@ function onlyWasSeen() {
 
 // ../../packages/e2e/src/version.ts
 var WORKSPACE_VERSION = "0.0.0-workspace";
-var WARDEN_E2E_VERSION2 = "0.3.1";
+var WARDEN_E2E_VERSION2 = "0.5.0";
 
 export { E2eError2, noteSpanDetail, addSpanDetail, canObserve, canDetectAlerts, settleDetailOf, DEFAULT_SETTLE_QUIET_MS, DEFAULT_SETTLE_TIMEOUT_MS, settleByHash, snapshotHash, ok, err, swipeVector, screenRect, fieldValue, PINCH_MS, ROTATE_MS, PATH_MS, centreOf, pinchRadius, rotateRadius, requireGesture, assertScale, assertDegrees, isInteractiveRole, resolveRole, normalizeText, matchesText, indexSnapshot, testIdQuery, textQuery, roleQuery, selectorExpression, renderSnapshot, renderHeader, resolve, locateByTestIdViaReact, isLocator, Locator, pickOne, textOf, scrollUntilVisible, bunExec, execError, driverError, driverErr, logEventSchema, fatalEventSchema, responseSchema, mapWireError, encodeRequest, bunSpawn, stdioTransport, spawnSimd, connectSimd, isHidLost, ENV_NAMES, DEFAULT_ASSERTION_TIMEOUT_MS, readEnv, runStep, setDefaultHidRecovery, setDefaultNativeLog, setDefaultDriverFactory, hasDefaultDriverFactory, setDefaultFixtureFactory, hasDefaultFixtureFactory, attemptSession, getSession, parseBudgets, createDevicePerf, perfStartFor, spawnWarden, hash6, attemptDir, screenshotPath, specIdOf, realNativeLogDeps, captureNativeLog, callerFile, BUN_TIMEOUT_MARGIN_MS2, ownHook, currentScope, createScope, runInScope, hooksFor, resolveUse, registrationDefaults, markOnly, onlyWasSeen, WORKSPACE_VERSION, WARDEN_E2E_VERSION2 };

package/index.mjs

@@ -31,7 +31,7 @@ import {
   registrationDefaults,
   markOnly,
   WARDEN_E2E_VERSION2
-} from "./chunk-8em9kgsk.mjs";
+} from "./chunk-j9b17ade.mjs";
 // ../../packages/e2e/src/expect/expect.ts
 import { expect as bunExpect } from "bun:test";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@delacour/warden-e2e",
-  "version": "0.3.1",
+  "version": "0.5.0",
   "description": "TypeScript spec API for `warden e2e`: test, expect, screen, device, app",
   "license": "MIT",
   "repository": {
@@ -37,7 +37,7 @@
     "LICENSE"
   ],
   "peerDependencies": {
-    "@delacour/warden": "0.3.1"
+    "@delacour/warden": "0.5.0"
   },
   "dependencies": {
     "zod": "^4.4.3"

package/preload.mjs

@@ -68,7 +68,7 @@ import {
   onlyWasSeen,
   WORKSPACE_VERSION,
   WARDEN_E2E_VERSION2
-} from "./chunk-8em9kgsk.mjs";
+} from "./chunk-j9b17ade.mjs";
 
 // ../../packages/e2e/src/preload.ts
 import { afterAll, setDefaultTimeout } from "bun:test";
@@ -3238,8 +3238,8 @@ function createSimctl(deps) {
 
 // ../../packages/e2e/src/driver/ios/type-budget.ts
 var TYPE_BASE_MS = 1e4;
-var TYPE_PER_CHAR_MS = 70;
-var TYPE_PER_REPEAT_MS = 300;
+var TYPE_PER_CHAR_MS = 100;
+var TYPE_PER_REPEAT_MS = 200;
 function typeTextBudgetMs(text) {
   const characters = Array.from(text);
   let repeats = 0;
@@ -3257,6 +3257,8 @@ var SETTLE_MARGIN_MS = 2000;
 var REBIND_TIMEOUT_MS = 3000;
 var GESTURE_MARGIN_MS = 5000;
 var FRONTMOST_TIMEOUT_MS = 3000;
+var LAUNCH_TIMEOUT_MS = 30000;
+var APP_OP_TIMEOUT_MS = 15000;
 var KEY_USAGE = {
   Enter: 40,
   Escape: 41,
@@ -3348,6 +3350,9 @@ function restOf(error, text) {
 function decodeBase64(png) {
   return new Uint8Array(Buffer.from(png, "base64"));
 }
+function predatesOp(error) {
+  return error.code === "E_UNSUPPORTED" || error.code === "E_BAD_REQUEST" && /unknown (input )?op/.test(error.message);
+}
 function createIosDriver(swap, simctl, opts) {
   const { udid, now, sleep } = opts;
   const { client } = swap;
@@ -3359,6 +3364,7 @@ function createIosDriver(swap, simctl, opts) {
   let settleUnsupported = !nativeSettle;
   let rebindUnsupported = false;
   let gestureUnsupported = false;
+  let appOpsOutdated = false;
   const capabilities = {
     pinch: true,
     maxPointers: 2,
@@ -3426,6 +3432,30 @@ function createIosDriver(swap, simctl, opts) {
     }
     return result;
   };
+  async function appOp(op, p, timeoutMs) {
+    if (appOpsOutdated) {
+      noteSpanDetail("via", "simctl");
+      return;
+    }
+    const result = await request(op, p, { timeoutMs });
+    if (!result.success && predatesOp(result.error)) {
+      appOpsOutdated = true;
+      noteSpanDetail("via", "simctl");
+      noteSpanDetail("reason", "helper_outdated");
+      opts.log?.(`[ios] this warden-simd predates the \`${op}\` op (${result.error.code}: ${result.error.message}); app lifecycle goes through simctl until the helper is restarted (warden ui close --udid ${udid}) or rebuilt (bun run --cwd packages/e2e native:build)`);
+      return;
+    }
+    noteSpanDetail("via", "simd");
+    return result;
+  }
+  async function appOutcome(viaHelper, fallback, note) {
+    if (viaHelper === undefined)
+      return fallback();
+    if (!viaHelper.success)
+      return viaHelper;
+    note(viaHelper.data);
+    return okVoid;
+  }
   const fetchSnapshot = async (o) => {
     const result = await request("snapshot", params({ interactiveOnly: o?.interactiveOnly, backend: o?.backend }));
     if (!result.success)
@@ -3463,11 +3493,17 @@ function createIosDriver(swap, simctl, opts) {
     const rest = restOf(typed.error, text);
     if (rest === undefined)
       return typed;
-    const copied = await simctl.pbcopy(rest);
-    if (!copied.success)
-      return copied;
     opts.log?.(`[ios] typeText: pasting ${rest.length} unmappable character(s)`);
-    return sendVoid("paste");
+    return pasteText(rest);
+  }
+  async function pasteText(text) {
+    if (text === "")
+      return ok(undefined);
+    const copied = await simctl.pbcopy(text);
+    const result = copied.success ? await sendVoid("paste") : copied;
+    if (!result.success)
+      opts.log?.(`[ios] pasteText failed (${result.error.code}): ${result.error.message}`);
+    return result;
   }
   async function hashSettle(o) {
     try {
@@ -3631,6 +3667,7 @@ function createIosDriver(swap, simctl, opts) {
     typeText,
     key: (key, modifiers) => sendVoid("key", params({ usage: KEY_USAGE[key], modifiers: modifiers && [...modifiers] })),
     selectAll: () => sendVoid("selectAll"),
+    pasteText,
     pressButton,
     screenshot,
     orientation,
@@ -3647,7 +3684,8 @@ function createIosDriver(swap, simctl, opts) {
     },
     app: {
       launch: async (bundleId, o) => {
-        const launched = await simctl.launch(bundleId, o);
+        const viaHelper = await appOp("launch", params({ bundleId, args: o?.args && [...o.args], env: o?.env, terminateRunning: o?.relaunch !== false }), LAUNCH_TIMEOUT_MS);
+        const launched = await appOutcome(viaHelper, () => simctl.launch(bundleId, o), (data) => noteSpanDetail("pid", data.pid));
         if (launched.success) {
           launchedBundle = bundleId;
           if (await rebind(bundleId))
@@ -3656,12 +3694,18 @@ function createIosDriver(swap, simctl, opts) {
         return launched;
       },
       terminate: async (bundleId) => {
-        const terminated = await simctl.terminate(bundleId);
+        const viaHelper = await appOp("terminate", { bundleId }, APP_OP_TIMEOUT_MS);
+        const terminated = await appOutcome(viaHelper, () => simctl.terminate(bundleId), (data) => noteSpanDetail("terminated", data.terminated));
         if (terminated.success && launchedBundle === bundleId)
           launchedBundle = undefined;
         return terminated;
       },
-      openUrl: (url) => simctl.openUrl(url),
+      openUrl: async (url) => {
+        const viaHelper = await appOp("openUrl", { url }, APP_OP_TIMEOUT_MS);
+        return appOutcome(viaHelper, () => simctl.openUrl(url), () => {
+          return;
+        });
+      },
       install: (path) => simctl.install(path),
       uninstall: (bundleId) => simctl.uninstall(bundleId),
       isInstalled: (bundleId) => simctl.isInstalled(bundleId),
@@ -3939,6 +3983,8 @@ function createApp({ session, driver, env, log = stderrLog2, clock = systemClock
     if (options.env !== undefined)
       opts.env = options.env;
     await unwrap(() => driver.app.launch(bundleId, opts), `launch ${bundleId}`, session.signal);
+    if (env.metroUrl !== undefined)
+      session.devtools?.();
     if (options.url !== undefined) {
       const url = options.url;
       await unwrap(() => driver.app.openUrl(url), `open ${url}`, session.signal);
@@ -4773,6 +4819,10 @@ ${read.error}
     }
   });
 }
+function scrubRunnerEnv(env) {
+  delete env.BUN_BE_BUN;
+}
+scrubRunnerEnv(process.env);
 if (!hasDefaultDriverFactory()) {
   setDefaultDriverFactory(defaultDriverFactory);
   setDefaultNativeLog(realNativeLogDeps(bunExec, androidTools(process.env).adb));
@@ -4796,5 +4846,6 @@ export {
   BUN_TIMEOUT_MARGIN_MS2 as BUN_TIMEOUT_MARGIN_MS,
   installPreload,
   isCi,
+  scrubRunnerEnv,
   versionMismatch
 };