@delacour/warden-e2e 0.6.0 → 0.8.0

package/types/core/src/a11y/a11y.config.d.ts

@@ -0,0 +1,47 @@
+import { type Result } from "../../../types/src/result";
+import { z } from "zod";
+/** Every rule id an audit can report (`native` = XCUITest / ATF findings). Keep in step with `A11yRuleId` in `@delacour/warden-e2e`. */
+export declare const A11Y_RULE_IDS: readonly ["missing-name", "image-no-name", "target-size", "target-size-platform", "duplicate-name", "role-in-name", "label-in-name", "hidden-focusable", "text-clipped", "native"];
+/**
+ * `a11y` (top level, or per `e2e.<suite>`): how `device.a11yAudit()` / `toPassA11yAudit()` judge a screen.
+ * `ignore` drops a rule (everywhere, or only on the element with that `identifier`); `minSeverity` is the lowest
+ * severity that fails (default `error`); `rules` limits the audit to those rules.
+ */
+export declare const a11yAuditConfigSchema: z.ZodObject<{
+    ignore: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        rule: z.ZodEnum<{
+            "missing-name": "missing-name";
+            "image-no-name": "image-no-name";
+            "target-size": "target-size";
+            "target-size-platform": "target-size-platform";
+            "duplicate-name": "duplicate-name";
+            "role-in-name": "role-in-name";
+            "label-in-name": "label-in-name";
+            "hidden-focusable": "hidden-focusable";
+            "text-clipped": "text-clipped";
+            native: "native";
+        }>;
+        identifier: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    minSeverity: z.ZodOptional<z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+    }>>;
+    rules: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        "missing-name": "missing-name";
+        "image-no-name": "image-no-name";
+        "target-size": "target-size";
+        "target-size-platform": "target-size-platform";
+        "duplicate-name": "duplicate-name";
+        "role-in-name": "role-in-name";
+        "label-in-name": "label-in-name";
+        "hidden-focusable": "hidden-focusable";
+        "text-clipped": "text-clipped";
+        native: "native";
+    }>>>;
+}, z.core.$strict>;
+export type A11yAuditConfig = z.infer<typeof a11yAuditConfigSchema>;
+/** The suite's keys over the top-level ones (a suite's `ignore` / `rules` replace, not extend); undefined when neither is set. */
+export declare function mergeA11yAuditConfig(top: A11yAuditConfig | undefined, suite: A11yAuditConfig | undefined): A11yAuditConfig | undefined;
+/** `WARDEN_A11Y_AUDIT`: the JSON `warden e2e` writes. */
+export declare function parseA11yAuditEnv(raw: string): Result<A11yAuditConfig>;

package/types/core/src/affected/affected.schema.d.ts

@@ -39,12 +39,19 @@ export declare const e2eMetroSchema: z.ZodObject<{
     prewarm: z.ZodDefault<z.ZodBoolean>;
     readyTimeout: z.ZodDefault<z.ZodString>;
 }, z.core.$strict>;
+/** `physical` on a suite or leg: `true` = any ready physical device, `{ ids }` = exactly these (adb serials / CoreDevice UDIDs). Never booted, created or arranged. */
+export declare const physicalSchema: z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodObject<{
+    ids: z.ZodArray<z.ZodString>;
+}, z.core.$strict>]>;
 /** `e2e.<suite>.devices[]`: one leg of the run, with its own device pool. */
 export declare const e2eDeviceLegSchema: z.ZodObject<{
     profile: z.ZodString;
     count: z.ZodDefault<z.ZodNumber>;
     env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     default: z.ZodDefault<z.ZodBoolean>;
+    physical: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodObject<{
+        ids: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>]>>;
 }, z.core.$strict>;
 /** `perf` (top level, or per `e2e.<suite>`): ceilings `device.perf.stop()` holds the report to. Each is lower-is-better. */
 export declare const perfConfigSchema: z.ZodObject<{
@@ -92,6 +99,9 @@ export declare const e2eSuiteSchema: z.ZodObject<{
         count: z.ZodDefault<z.ZodNumber>;
         env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         default: z.ZodDefault<z.ZodBoolean>;
+        physical: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodObject<{
+            ids: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>]>>;
     }, z.core.$strict>>>;
     metro: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
@@ -108,6 +118,9 @@ export declare const e2eSuiteSchema: z.ZodObject<{
         ios: "ios";
         android: "android";
     }>>;
+    physical: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodObject<{
+        ids: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>]>>;
     base: z.ZodDefault<z.ZodString>;
     maxDepth: z.ZodOptional<z.ZodNumber>;
     runAll: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -138,8 +151,8 @@ export declare const e2eSuiteSchema: z.ZodObject<{
         variant: z.ZodOptional<z.ZodString>;
         kind: z.ZodOptional<z.ZodEnum<{
             release: "release";
-            dev: "dev";
             simulator: "simulator";
+            dev: "dev";
         }>>;
     }, z.core.$strict>]>>;
     ports: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -152,6 +165,12 @@ export declare const e2eSuiteSchema: z.ZodObject<{
         except: z.ZodOptional<z.ZodArray<z.ZodString>>;
         keep: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>]>>;
+    biometrics: z.ZodOptional<z.ZodBoolean>;
+    reclaim: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        uninstall: "uninstall";
+        erase: "erase";
+    }>>;
     warmRunners: z.ZodOptional<z.ZodUndefined>;
     warmDrivers: z.ZodOptional<z.ZodBoolean>;
     headless: z.ZodOptional<z.ZodBoolean>;
@@ -164,6 +183,127 @@ export declare const e2eSuiteSchema: z.ZodObject<{
             peakMemoryMb: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
+    conditions: z.ZodOptional<z.ZodObject<{
+        network: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+            edge: "edge";
+            "3g": "3g";
+            "4g": "4g";
+            lte: "lte";
+            wifi: "wifi";
+            slow: "slow";
+            lossy: "lossy";
+            online: "online";
+            offline: "offline";
+        }>, z.ZodObject<{
+            latencyMs: z.ZodOptional<z.ZodNumber>;
+            jitterMs: z.ZodOptional<z.ZodNumber>;
+            downKbps: z.ZodOptional<z.ZodNumber>;
+            upKbps: z.ZodOptional<z.ZodNumber>;
+            lossPct: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>>;
+        location: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+            "city-run": "city-run";
+            "city-bike": "city-bike";
+            freeway: "freeway";
+        }>, z.ZodObject<{
+            lat: z.ZodNumber;
+            lon: z.ZodNumber;
+            altM: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>>;
+        clock: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            at: z.ZodString;
+            frozen: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>, z.ZodObject<{
+            offset: z.ZodString;
+        }, z.core.$strict>]>>;
+        permissions: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+            location: "location";
+            locationAlways: "locationAlways";
+            camera: "camera";
+            photos: "photos";
+            photosAdd: "photosAdd";
+            contacts: "contacts";
+            contactsLimited: "contactsLimited";
+            notifications: "notifications";
+            microphone: "microphone";
+            calendar: "calendar";
+            reminders: "reminders";
+            motion: "motion";
+            mediaLibrary: "mediaLibrary";
+            siri: "siri";
+        }> & z.core.$partial, z.ZodEnum<{
+            granted: "granted";
+            denied: "denied";
+            unset: "unset";
+        }>>>;
+        locale: z.ZodOptional<z.ZodString>;
+        timezone: z.ZodOptional<z.ZodString>;
+        a11y: z.ZodOptional<z.ZodObject<{
+            textSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+                "extra-small": "extra-small";
+                small: "small";
+                medium: "medium";
+                large: "large";
+                "extra-large": "extra-large";
+                "extra-extra-large": "extra-extra-large";
+                "extra-extra-extra-large": "extra-extra-extra-large";
+                "accessibility-medium": "accessibility-medium";
+                "accessibility-large": "accessibility-large";
+                "accessibility-extra-large": "accessibility-extra-large";
+                "accessibility-extra-extra-large": "accessibility-extra-extra-large";
+                "accessibility-extra-extra-extra-large": "accessibility-extra-extra-extra-large";
+            }>, z.ZodNumber]>>;
+            boldText: z.ZodOptional<z.ZodBoolean>;
+            contrast: z.ZodOptional<z.ZodEnum<{
+                increased: "increased";
+                normal: "normal";
+            }>>;
+            reduceMotion: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    a11y: z.ZodOptional<z.ZodObject<{
+        ignore: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            rule: z.ZodEnum<{
+                "missing-name": "missing-name";
+                "image-no-name": "image-no-name";
+                "target-size": "target-size";
+                "target-size-platform": "target-size-platform";
+                "duplicate-name": "duplicate-name";
+                "role-in-name": "role-in-name";
+                "label-in-name": "label-in-name";
+                "hidden-focusable": "hidden-focusable";
+                "text-clipped": "text-clipped";
+                native: "native";
+            }>;
+            identifier: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        minSeverity: z.ZodOptional<z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>>;
+        rules: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            "missing-name": "missing-name";
+            "image-no-name": "image-no-name";
+            "target-size": "target-size";
+            "target-size-platform": "target-size-platform";
+            "duplicate-name": "duplicate-name";
+            "role-in-name": "role-in-name";
+            "label-in-name": "label-in-name";
+            "hidden-focusable": "hidden-focusable";
+            "text-clipped": "text-clipped";
+            native: "native";
+        }>>>;
+    }, z.core.$strict>>;
+    camera: z.ZodOptional<z.ZodObject<{
+        back: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            path: z.ZodString;
+            loop: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>]>>;
+        front: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            path: z.ZodString;
+            loop: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>]>>;
+    }, z.core.$strict>>;
     required: z.ZodDefault<z.ZodBoolean>;
     specs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         entries: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -178,6 +318,7 @@ export declare const e2eSuiteSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type E2eSpecConfig = z.infer<typeof e2eSpecSchema>;
 export type E2eMetroConfig = z.infer<typeof e2eMetroSchema>;
+export type E2ePhysical = z.infer<typeof physicalSchema>;
 export type E2eDeviceLeg = z.infer<typeof e2eDeviceLegSchema>;
 export type E2eSpecEntryConfig = z.infer<typeof e2eSpecEntrySchema>;
 export type E2eSlimConfig = z.infer<typeof slimConfigSchema>;

package/types/core/src/allocate.d.ts

@@ -18,6 +18,7 @@ export declare function compareRuntimeDesc(a: InventoryDevice, b: InventoryDevic
 /**
  * Pure allocation: which devices satisfy `request` given current leases. Free warden devices first
  * (booted before shutdown, newest runtime first), then pool growth up to `max`. Foreign devices are
- * only considered with `adopt`. Stale leases are ignored and returned for reclaim.
+ * only considered with `adopt`. Physical devices are never considered, even with `adopt`, unless
+ * `request.physical` asks for them: then only ready ones, no profile match, and nothing is created. Stale leases are ignored and returned for reclaim.
  */
 export declare function allocate({ inventory, leases, request, now, pidAlive, skip }: AllocateInput): AllocationPlan;

package/types/core/src/android-keyguard.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Android emulator keyguard + readiness for biometrics (`+bio`) devices. Fingerprint enrollment needs a secure
+ * lock (a PIN), so an enrolled emulator boots behind a lock screen and the app cannot resolve its launcher until
+ * the user is unlocked. A restored snapshot can also come back with a black, unresponsive SystemUI that ignores
+ * wake / dismiss / PIN input until SystemUI is restarted. Emulator serials only: never run on a foreign device.
+ */
+import { type AsyncResult } from "../../types/src/result";
+import type { Exec } from "./exec";
+/** Keep the screen on and never time out, so the unlocked device does not lock again. */
+export declare const STAY_AWAKE_COMMAND = "svc power stayon true; settings put system screen_off_timeout 2147483647";
+/** Crashing SystemUI makes the system restart it with a fresh, responsive lock screen. */
+export declare const SYSTEMUI_RESTART_COMMAND = "am crash com.android.systemui";
+/** Wake, swipe the lock screen up to the PIN bouncer, type the PIN. */
+export declare function unlockCommand(): string;
+/** `isKeyguardShowing=` of `dumpsys window` (API 36), `undefined` when the dump has no such line. */
+export declare function parseKeyguardShowing(dump: string): boolean | undefined;
+export type KeyguardDeps = {
+    exec: Exec;
+    sleep: (ms: number) => Promise<void>;
+    /** the adb binary (`androidTools(env).adb`) */
+    adb: string;
+    now?: () => number;
+};
+/** Whether `dumpsys window` positively reports the keyguard up; an unreadable dump is not a lock screen. */
+export declare function keyguardIsShowing(deps: KeyguardDeps, serial: string): Promise<boolean>;
+/**
+ * Get past the lock screen (idempotent: nothing is typed when it is already gone) and keep the device awake.
+ * Up to three unlock attempts; before the last one SystemUI is restarted, which recovers a restored snapshot
+ * whose lock screen is black and ignores input.
+ */
+export declare function ensureUnlocked(deps: KeyguardDeps, serial: string): AsyncResult<void>;
+/**
+ * `adb get-state` = device and the package manager answering (`pm path android`), polled for up to `timeoutMs`:
+ * `boot_completed` can precede both on a restored snapshot, and an install in that window fails `device offline`.
+ */
+export declare function systemReady(deps: KeyguardDeps, serial: string, timeoutMs: number): AsyncResult<void>;

package/types/core/src/batch/preset.schema.d.ts

@@ -4,6 +4,12 @@ export declare const slimConfigSchema: z.ZodUnion<readonly [z.ZodBoolean, z.ZodO
     except: z.ZodOptional<z.ZodArray<z.ZodString>>;
     keep: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strict>]>;
+/** `reclaim`: what happens to a device's state when its lease ends (`ReclaimMode`). */
+export declare const reclaimSchema: z.ZodEnum<{
+    none: "none";
+    uninstall: "uninstall";
+    erase: "erase";
+}>;
 export declare const duration: z.ZodString;
 export declare const portSpec: z.ZodString;
 /** `batches.<name>` in `warden.config.ts`: a saved `warden batch` invocation. */
@@ -31,8 +37,8 @@ export declare const batchPresetSchema: z.ZodObject<{
         variant: z.ZodOptional<z.ZodString>;
         kind: z.ZodOptional<z.ZodEnum<{
             release: "release";
-            dev: "dev";
             simulator: "simulator";
+            dev: "dev";
         }>>;
     }, z.core.$strict>]>>;
     headless: z.ZodOptional<z.ZodBoolean>;
@@ -40,6 +46,12 @@ export declare const batchPresetSchema: z.ZodObject<{
         except: z.ZodOptional<z.ZodArray<z.ZodString>>;
         keep: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>]>>;
+    biometrics: z.ZodOptional<z.ZodBoolean>;
+    reclaim: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        uninstall: "uninstall";
+        erase: "erase";
+    }>>;
     retry: z.ZodOptional<z.ZodNumber>;
     passes: z.ZodOptional<z.ZodNumber>;
     env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;

package/types/core/src/biometrics.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Biometric profiles. A profile with `biometrics: true` is a different device identity from the same profile
+ * without it: pool matching, goldens and snapshots all key on the profile string, so enrolled and plain
+ * devices never mix. The identity is the profile plus `+bio` (a character `profileSlug` never produces).
+ */
+export declare const BIOMETRIC_PROFILE_SUFFIX = "+bio";
+/** Screen-lock PIN set on every biometrics device (Android needs a secure lock before it enrolls a fingerprint). */
+export declare const BIOMETRIC_PIN = "1111";
+/** Finger id `emu finger touch` presents once enrolled; `99` matches nothing. */
+export declare const BIOMETRIC_FINGER_ID = 1;
+export declare function biometricProfile(profile: string, biometrics: boolean): string;
+export declare function splitBiometricProfile(profile: string): {
+    profile: string;
+    biometrics: boolean;
+};

package/types/core/src/builds/app-option.schema.d.ts

@@ -29,8 +29,8 @@ export declare const appOptionSchema: z.ZodUnion<readonly [z.ZodBoolean, z.ZodOb
     variant: z.ZodOptional<z.ZodString>;
     kind: z.ZodOptional<z.ZodEnum<{
         release: "release";
-        dev: "dev";
         simulator: "simulator";
+        dev: "dev";
     }>>;
 }, z.core.$strict>]>;
 export type AppOption = z.infer<typeof appOptionSchema>;

package/types/core/src/builds/builds.defaults.d.ts

@@ -12,6 +12,21 @@ export type BuildConfiguration = "Debug" | "Release";
 export declare const IOS_NATIVE_PREPARE: string;
 /** Local build command (run in the project root) when `build.<platform>` is not configured. */
 export declare function defaultBuildCommand(platform: Platform, configuration: BuildConfiguration, framework?: AppFramework): string;
+/** What an iOS device build is signed with: the team (always) and, when set, the bundle id that replaces the project's. */
+export type IosDeviceBuild = {
+    team: string;
+    bundleIdentifier?: string | undefined;
+};
+/** The `xcodebuild -derivedDataPath` of a device build, relative to `ios/`: products land in `ios/build/Build/Products/<Config>-iphoneos`. */
+export declare const IOS_DEVICE_DERIVED_DATA = "build";
+/**
+ * Local build command of an iOS build for a physical device. A plain `xcodebuild` on the prebuilt workspace (the scheme
+ * has the workspace's name, as in Expo and the React Native template): `expo run:ios` would install to a device itself
+ * and cannot take the team or `-allowProvisioningUpdates`. `generic/platform=iOS` builds for any device the team's
+ * development profile lists; `-allowProvisioningUpdates` lets Xcode create that profile. A Release build runs Xcode's
+ * own bundling phase, so the JS is embedded.
+ */
+export declare function iosDeviceBuildCommand(configuration: BuildConfiguration, framework: AppFramework, device: IosDeviceBuild): string;
 /** Android twin of `IOS_NATIVE_PREPARE`: generate `android/` when a CNG checkout has none. */
 export declare const ANDROID_NATIVE_PREPARE = "{ [ -f android/gradlew ] || bunx expo prebuild --platform android --no-install; }";
 /**

package/types/core/src/builds/config.d.ts

@@ -3,7 +3,7 @@ import type { z } from "zod";
 import type { Platform } from "../types";
 import { type BuildConfiguration } from "./builds.defaults";
 import type { projectConfigSchema, wardenConfigSchema } from "./config.schema";
-import type { BuildKind, ProjectKinds } from "./kinds";
+import type { BuildKind, BuildTarget, ProjectKinds } from "./kinds";
 import { type AppFramework } from "./native-ids";
 /** The preferred config file, named in hints. */
 export declare const CONFIG_FILE = "warden.config.ts";
@@ -45,6 +45,10 @@ export type Project = {
     kinds?: ProjectKinds;
     /** set by `projectForKind`: the kind this project is resolved as; undefined = the kind-less flow */
     kind?: BuildKind;
+    /** set by `projectForKind` for a build signed for a physical iPhone; undefined = a simulator / emulator build */
+    target?: BuildTarget;
+    /** `projects[].ios.device.bundleIdentifier`: replaces the bundle id of builds for a physical iPhone (and the app's id there) */
+    iosDeviceBundleId?: string;
     /** set by `projectForKind`: env of the local build (`kinds.<kind>.env`) */
     buildEnv?: Record<string, string>;
     cacheDirs: string[];