@delacour/warden-e2e 0.9.0 → 0.11.0

package/{chunk-y0y7frfz.mjs → chunk-ggcjzrvh.mjs}

@@ -4351,6 +4351,9 @@ var healthDataSchema = z6.looseObject({
   socket: z6.object({ path: z6.string(), clients: z6.number() }).optional(),
   idb: z6.string().optional(),
   xcode: z6.string().optional(),
+  builtWith: z6.object({ xcode: z6.string().optional(), idb: z6.string().optional() }).optional(),
+  coreSimulatorVersion: z6.string().nullish(),
+  frontmost: z6.object({ unresolvedAgoMs: z6.number(), method: z6.string() }).optional(),
   state: z6.string().optional(),
   uptimeMs: z6.number().optional()
 });
@@ -4362,6 +4365,7 @@ var snapshotDataSchema = z6.looseObject({
   elements: z6.array(z6.custom(isWireElement, { error: (issue) => wireElementProblem(issue.input) })),
   ms: z6.number(),
   fallback: z6.object({ from: z6.string(), to: z6.string(), reason: z6.string() }).optional(),
+  target: z6.object({ pid: z6.number(), source: z6.string() }).optional(),
   readMs: z6.number().optional(),
   nodes: z6.number().optional()
 });
@@ -9170,6 +9174,6 @@ function onlyWasSeen() {
 
 // ../../packages/e2e/src/version.ts
 var WORKSPACE_VERSION = "0.0.0-workspace";
-var WARDEN_E2E_VERSION2 = "0.9.0";
+var WARDEN_E2E_VERSION2 = "0.11.0";
 
 export { E2eError2, registerA11yTarget, a11yTargetOf, canActOnElements, 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, createLineSplitter, encodeRequest, bunSpawn, stdioTransport, socketTransport, createSimdClient, spawnSimd, connectSimd, isRecoverableLoss, CAMERA_FACINGS, CONDITION_AREAS, resolveNetwork, resolveTextSize, androidFontScale, ENV_NAMES, DEFAULT_ASSERTION_TIMEOUT_MS, readEnv, runStep, setDefaultHidRecovery, setDefaultNativeLog, setDefaultDriverFactory, hasDefaultDriverFactory, setDefaultFixtureFactory, hasDefaultFixtureFactory, attemptSession, getSession, accessibleName, announce, failing, formatIssues, toE2eError, settled, unwrap, parseUiadA11yEvents, parseInjectEvents, withA11yRead, renderA11yScreen, createDeviceA11y, IOS_DEVICE_CAPABILITIES, sniffCameraMedia, cameraFeedDir, clearCameraFeeds, isLeaseAlive, processAlive, describeOwner, isPhysicalIosId, wardenHome, defaultDbPath, ownerKey, openStore, callerFile, formatCoord, DEFAULT_SPEED_MPS, DEFAULT_INTERVAL_S, realTickerClock, startRouteTicker, startFlap, registerConditions, conditionsOf, conditionSinkFor, createDeviceConditions, parseBudgets, createDevicePerf, perfStartFor, spawnWarden, hash6, attemptDir, screenshotPath, specIdOf, realNativeLogDeps, captureNativeLog, BUN_TIMEOUT_MARGIN_MS2, ownHook, currentScope, createScope, runInScope, hooksFor, resolveUse, registrationDefaults, markOnly, onlyWasSeen, WORKSPACE_VERSION, WARDEN_E2E_VERSION2 };

package/index.mjs

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

package/package.json

@@ -1,21 +1,25 @@
 {
   "name": "@delacour/warden-e2e",
-  "version": "0.9.0",
-  "description": "TypeScript spec API for `warden e2e`: test, expect, screen, device, app",
+  "version": "0.11.0",
+  "description": "TypeScript e2e testing for React Native and Expo on iOS simulators and Android emulators, run by `warden e2e`: test, expect, screen, device, app",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/delacournz/warden.git"
   },
-  "homepage": "https://github.com/delacournz/warden#readme",
+  "homepage": "https://warden.co.nz/docs/e2e",
   "bugs": {
     "url": "https://github.com/delacournz/warden/issues"
   },
   "type": "module",
   "keywords": [
     "e2e",
+    "e2e-testing",
+    "react-native",
+    "expo",
     "ios-simulator",
     "android-emulator",
+    "mobile-testing",
     "bun",
     "testing"
   ],
@@ -37,7 +41,7 @@
     "LICENSE"
   ],
   "peerDependencies": {
-    "@delacour/warden": "0.9.0"
+    "@delacour/warden": "0.11.0"
   },
   "dependencies": {
     "zod": "^4.4.3"

package/preload.mjs

@@ -109,7 +109,7 @@ import {
   onlyWasSeen,
   WORKSPACE_VERSION,
   WARDEN_E2E_VERSION2
-} from "./chunk-y0y7frfz.mjs";
+} from "./chunk-ggcjzrvh.mjs";
 
 // ../../packages/e2e/src/preload.ts
 import { afterAll, setDefaultTimeout } from "bun:test";
@@ -8331,6 +8331,37 @@ function nativeDetail(data) {
     noteSpanDetail("frontmostPid", frontmostPid);
   return detail;
 }
+function noteSnapshotError(detail) {
+  if (typeof detail !== "object" || detail === null)
+    return;
+  const fields = {
+    stage: "axStage",
+    reason: "axReason",
+    request: "axRequest",
+    bridgeError: "bridgeError",
+    axError: "axError"
+  };
+  for (const [from, to] of Object.entries(fields)) {
+    const value = detail[from];
+    if (typeof value === "string")
+      noteSpanDetail(to, value);
+  }
+}
+function noteHelperHealth(health) {
+  noteSpanDetail("bridge", health.ax.bridge);
+  if (health.ax.lastError)
+    noteSpanDetail("bridgeLastError", health.ax.lastError.message);
+  if (health.ax.error)
+    noteSpanDetail("bridgeLastError", health.ax.error);
+  if (health.xcode)
+    noteSpanDetail("hostXcode", health.xcode);
+  if (health.builtWith?.xcode)
+    noteSpanDetail("helperXcode", health.builtWith.xcode);
+  if (health.coreSimulatorVersion)
+    noteSpanDetail("coreSimulator", health.coreSimulatorVersion);
+  if (health.frontmost)
+    noteSpanDetail("frontmostUnresolvedAgoMs", health.frontmost.unresolvedAgoMs);
+}
 function noteRebind(data) {
   noteSpanDetail("rebind", data.bound ? "bound" : data.reason ?? "unbound");
   noteSpanDetail("rebindMs", data.waitedMs);
@@ -8401,6 +8432,7 @@ function createIosDriver(swap, simctl, opts) {
   const nativeSettle = ready.ax.default === "axbridge" && ready.ax.bridge === "available";
   const bridgeUp = ready.ax.bridge === "available";
   let settleUnsupported = !nativeSettle;
+  let settleAxFailures = 0;
   let rebindUnsupported = false;
   let gestureUnsupported = false;
   let appOpsOutdated = false;
@@ -8495,16 +8527,30 @@ function createIosDriver(swap, simctl, opts) {
     note(viaHelper.data);
     return okVoid2;
   }
+  let failureDiagnosed = false;
   const fetchSnapshot = async (o) => {
     const result = await request("snapshot", params({ interactiveOnly: o?.interactiveOnly, backend: o?.backend }));
-    if (!result.success)
+    if (!result.success) {
+      noteSnapshotError(result.error.detail);
+      if (!failureDiagnosed) {
+        failureDiagnosed = true;
+        const health = await request("health", {});
+        if (health.success)
+          noteHelperHealth(health.data);
+      }
       return result;
-    const { fallback } = result.data;
+    }
+    failureDiagnosed = false;
+    const { fallback, target } = result.data;
+    noteSpanDetail("backend", result.data.backend);
     if (fallback) {
       opts.log?.(`[ios] snapshot fell back ${fallback.from} -> ${fallback.to}: ${fallback.reason}`);
-      noteSpanDetail("backend", fallback.to);
       noteSpanDetail("fallback", fallback.reason);
     }
+    if (target) {
+      noteSpanDetail("targetPid", target.pid);
+      noteSpanDetail("targetSource", target.source);
+    }
     return { success: true, data: toSnapshot(result.data, now()) };
   };
   async function snapshot(o) {
@@ -8577,10 +8623,20 @@ function createIosDriver(swap, simctl, opts) {
     noteRebind(reply.data);
     return reply.data.bound;
   }
+  function noteSettleAxFailure(message) {
+    settleAxFailures += 1;
+    noteSpanDetail("nativeError", "E_AX_UNAVAILABLE");
+    if (settleAxFailures >= 2) {
+      settleUnsupported = true;
+      opts.log?.(`[ios] native settle could not bind the AX observer twice in a row, polling snapshot hashes: ${message}`);
+    }
+    return;
+  }
   async function settleViaHelper(quietMs, timeoutMs) {
     const expected = launchedBundle;
     const native = await request("settle", { quietMs, settleTimeoutMs: timeoutMs, ...expected === undefined ? {} : { bundleId: expected } }, { timeoutMs: timeoutMs + SETTLE_MARGIN_MS });
     if (native.success) {
+      settleAxFailures = 0;
       if (expected !== undefined && native.data.reason !== "frontmost_mismatch")
         launchedBundle = undefined;
       return { success: true, data: nativeDetail(native.data) };
@@ -8592,6 +8648,8 @@ function createIosDriver(swap, simctl, opts) {
         data: { quiet: false, waitedMs: timeoutMs + SETTLE_MARGIN_MS, reason: "helper_timeout" }
       };
     }
+    if (native.error.code === "E_AX_UNAVAILABLE")
+      return noteSettleAxFailure(native.error.message);
     if (native.error.code !== "E_UNSUPPORTED")
       return native;
     settleUnsupported = true;

package/types/e2e/src/driver/ios/ios-driver.d.ts

@@ -16,6 +16,7 @@ import { type SwappableClient } from "./ios-session";
 import { type IosSettings, type StagedSettings } from "./ios-settings";
 import { type Simctl } from "./simctl";
 import { type SimdClient } from "./simd-client";
+import type { HealthData } from "./simd-protocol";
 import type { SimdSpawn } from "./simd-transport";
 /**
  * The iOS `Driver`: input, AX and app launch / terminate / openUrl through `warden-simd` (socket when
@@ -83,6 +84,10 @@ export type OpenIosDriverOptions = {
 };
 /** USB HID keyboard-page usage ids for the keys `Driver.key` offers. */
 export declare const KEY_USAGE: Readonly<Record<KeyName, number>>;
+/** The fields of a failed snapshot's `detail` the helper sets (which reader, why, both readers' errors), on its span. */
+export declare function noteSnapshotError(detail: unknown): void;
+/** What the helper says about itself after a failed read: bridge state, host vs build Xcode, CoreSimulator. */
+export declare function noteHelperHealth(health: HealthData): void;
 export declare function createIosDriver(swap: SwappableClient, simctl: Simctl, opts: {
     udid: string;
     now: () => number;

package/types/e2e/src/driver/ios/simd-protocol.d.ts

@@ -183,6 +183,15 @@ export declare const healthDataSchema: z.ZodObject<{
     }, z.core.$strip>>;
     idb: z.ZodOptional<z.ZodString>;
     xcode: z.ZodOptional<z.ZodString>;
+    builtWith: z.ZodOptional<z.ZodObject<{
+        xcode: z.ZodOptional<z.ZodString>;
+        idb: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    coreSimulatorVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    frontmost: z.ZodOptional<z.ZodObject<{
+        unresolvedAgoMs: z.ZodNumber;
+        method: z.ZodString;
+    }, z.core.$strip>>;
     state: z.ZodOptional<z.ZodString>;
     uptimeMs: z.ZodOptional<z.ZodNumber>;
 }, z.core.$loose>;
@@ -206,6 +215,10 @@ export declare const snapshotDataSchema: z.ZodObject<{
         to: z.ZodString;
         reason: z.ZodString;
     }, z.core.$strip>>;
+    target: z.ZodOptional<z.ZodObject<{
+        pid: z.ZodNumber;
+        source: z.ZodString;
+    }, z.core.$strip>>;
     readMs: z.ZodOptional<z.ZodNumber>;
     nodes: z.ZodOptional<z.ZodNumber>;
 }, z.core.$loose>;
@@ -340,6 +353,15 @@ export declare const opSchemas: {
         }, z.core.$strip>>;
         idb: z.ZodOptional<z.ZodString>;
         xcode: z.ZodOptional<z.ZodString>;
+        builtWith: z.ZodOptional<z.ZodObject<{
+            xcode: z.ZodOptional<z.ZodString>;
+            idb: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        coreSimulatorVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        frontmost: z.ZodOptional<z.ZodObject<{
+            unresolvedAgoMs: z.ZodNumber;
+            method: z.ZodString;
+        }, z.core.$strip>>;
         state: z.ZodOptional<z.ZodString>;
         uptimeMs: z.ZodOptional<z.ZodNumber>;
     }, z.core.$loose>;
@@ -362,6 +384,10 @@ export declare const opSchemas: {
             to: z.ZodString;
             reason: z.ZodString;
         }, z.core.$strip>>;
+        target: z.ZodOptional<z.ZodObject<{
+            pid: z.ZodNumber;
+            source: z.ZodString;
+        }, z.core.$strip>>;
         readMs: z.ZodOptional<z.ZodNumber>;
         nodes: z.ZodOptional<z.ZodNumber>;
     }, z.core.$loose>;