@delacour/warden-e2e 0.5.0 → 0.7.0

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>>;
@@ -152,6 +165,7 @@ 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>;
     warmRunners: z.ZodOptional<z.ZodUndefined>;
     warmDrivers: z.ZodOptional<z.ZodBoolean>;
     headless: z.ZodOptional<z.ZodBoolean>;
@@ -164,6 +178,84 @@ 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>>;
     required: z.ZodDefault<z.ZodBoolean>;
     specs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         entries: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -178,6 +270,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,34 @@
+/**
+ * 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;
+};
+/**
+ * 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

@@ -40,6 +40,7 @@ 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>;
     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/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[];

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

@@ -114,6 +114,11 @@ export declare const projectConfigSchema: z.ZodObject<{
             jsInputs: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
+    ios: z.ZodOptional<z.ZodObject<{
+        device: z.ZodOptional<z.ZodObject<{
+            bundleIdentifier: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
     cacheDirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strict>;
 export declare const wardenConfigSchema: z.ZodObject<{
@@ -202,6 +207,11 @@ export declare const wardenConfigSchema: z.ZodObject<{
                 jsInputs: z.ZodOptional<z.ZodArray<z.ZodString>>;
             }, z.core.$strict>>;
         }, z.core.$strict>>;
+        ios: z.ZodOptional<z.ZodObject<{
+            device: z.ZodOptional<z.ZodObject<{
+                bundleIdentifier: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
         cacheDirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>>>;
     batches: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -237,6 +247,7 @@ export declare const wardenConfigSchema: z.ZodObject<{
             except: z.ZodOptional<z.ZodArray<z.ZodString>>;
             keep: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strict>]>>;
+        biometrics: z.ZodOptional<z.ZodBoolean>;
         retry: z.ZodOptional<z.ZodNumber>;
         passes: z.ZodOptional<z.ZodNumber>;
         env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -275,6 +286,9 @@ export declare const wardenConfigSchema: 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>;
@@ -291,6 +305,9 @@ export declare const wardenConfigSchema: 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>>;
@@ -335,6 +352,7 @@ export declare const wardenConfigSchema: z.ZodObject<{
             except: z.ZodOptional<z.ZodArray<z.ZodString>>;
             keep: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strict>]>>;
+        biometrics: z.ZodOptional<z.ZodBoolean>;
         warmRunners: z.ZodOptional<z.ZodUndefined>;
         warmDrivers: z.ZodOptional<z.ZodBoolean>;
         headless: z.ZodOptional<z.ZodBoolean>;
@@ -347,6 +365,84 @@ export declare const wardenConfigSchema: 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>>;
         required: z.ZodDefault<z.ZodBoolean>;
         specs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
             entries: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -364,6 +460,7 @@ export declare const wardenConfigSchema: z.ZodObject<{
         except: z.ZodOptional<z.ZodArray<z.ZodString>>;
         keep: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>]>>;
+    biometrics: z.ZodOptional<z.ZodBoolean>;
     perf: z.ZodOptional<z.ZodObject<{
         budgets: z.ZodOptional<z.ZodObject<{
             startupColdMs: z.ZodOptional<z.ZodNumber>;
@@ -373,9 +470,94 @@ export declare const wardenConfigSchema: 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>>;
     android: z.ZodOptional<z.ZodObject<{
         snapshot: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
+    physical: z.ZodOptional<z.ZodObject<{
+        allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    ios: z.ZodOptional<z.ZodObject<{
+        teamId: z.ZodOptional<z.ZodString>;
+        runnerBundleId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 /** The slice of an Expo `app.json` warden reads (name, bundle ids). */
 export declare const appJsonSchema: z.ZodObject<{

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

@@ -209,6 +209,8 @@ export interface WardenProject {
      * `--kind`. Kinds sit on top of {@link WardenProject.variants}: both keep working, but a build is one or the other.
      */
     kinds?: WardenKinds | undefined;
+    /** iOS-only project settings. */
+    ios?: WardenProjectIos | undefined;
     /** Extra (legacy) cache roots laid out as `<dir>/<hash>/*.app|*.apk`, imported on demand. `~` expands to `$HOME`. */
     cacheDirs?: string[] | undefined;
 }
@@ -318,6 +320,12 @@ export interface WardenBatchPreset {
         except?: string[] | undefined;
         keep?: string[] | undefined;
     } | undefined;
+    /**
+     * Devices of this run have a fingerprint (Android) / Face ID (iOS) enrolled before any app install. Enrolled
+     * devices are a separate pool and golden from plain ones (profile `<profile>+bio`). Overrides the top-level
+     * `biometrics`. Default false.
+     */
+    biometrics?: boolean | undefined;
     /** Per-job log dir. */
     logs?: string | undefined;
     /**
@@ -412,6 +420,49 @@ export interface WardenPerfConfig {
     /** Budgets; a metric the report has no number for (its capture did not run) cannot breach. */
     budgets?: WardenPerfBudgets | undefined;
 }
+/** `conditions.network` as a custom shape: the fields of a `custom` network condition. */
+export interface WardenCustomNetwork {
+    /** Added round-trip time, ms. */
+    latencyMs?: number | undefined;
+    /** Plus or minus spread on the latency, ms. */
+    jitterMs?: number | undefined;
+    /** Download rate, kilobits per second (0 = unlimited). */
+    downKbps?: number | undefined;
+    /** Upload rate, kilobits per second (0 = unlimited). */
+    upKbps?: number | undefined;
+    /** Share of packets lost, 0-100. */
+    lossPct?: number | undefined;
+}
+/**
+ * `conditions` (top level, or `e2e.<suite>.conditions`): the device state every spec of the suite starts from.
+ * `network`, `location` and `clock` are applied before the app launches and put back after each spec;
+ * `permissions`, `locale`, `timezone` and `a11y` are accepted but not applied yet (`warden e2e` says so once).
+ */
+export interface WardenConditionsConfig {
+    /** `online`, `offline`, a preset (`edge`, `3g`, `4g`, `lte`, `wifi`, `slow`, `lossy`) or custom shaping. iOS launches the app with the network dylib so specs can change it later. */
+    network?: "online" | "offline" | "edge" | "3g" | "4g" | "lte" | "wifi" | "slow" | "lossy" | WardenCustomNetwork | undefined;
+    /** A point, or one of the bundled scenarios (`city-run`, `city-bike`, `freeway`). */
+    location?: "city-run" | "city-bike" | "freeway" | {
+        lat: number;
+        lon: number;
+        altM?: number | undefined;
+    } | undefined;
+    /** An ISO instant the clock starts at (and keeps running from), `{ at, frozen }`, or `{ offset }` ("2d") from now. */
+    clock?: string | {
+        at: string;
+        frozen?: boolean | undefined;
+    } | {
+        offset: string;
+    } | undefined;
+    /** Not applied yet. */
+    permissions?: Record<string, "granted" | "denied" | "unset"> | undefined;
+    /** Not applied yet. */
+    locale?: string | undefined;
+    /** Not applied yet. */
+    timezone?: string | undefined;
+    /** Not applied yet. */
+    a11y?: Record<string, unknown> | undefined;
+}
 /** `e2e.<suite>.spec`: how `warden e2e` runs the `*.e2e.ts` specs (`bun test` with `@delacour/warden-e2e`). */
 export interface WardenE2eSpec {
     /** The app under test. Default: the suite project's `bundleId` for the platform. */
@@ -468,6 +519,8 @@ export interface WardenE2eSuite {
     project?: string | undefined;
     /** Perf budgets for this suite; each key replaces the top-level `perf.budgets` one. */
     perf?: WardenPerfConfig | undefined;
+    /** Device conditions every spec of this suite starts from; each area replaces the top-level one. */
+    conditions?: WardenConditionsConfig | undefined;
     /** Directory of specs: `*.e2e.ts(x)` specs whose other `.ts` files are helpers (searched recursively; dot dirs, `node_modules` and `__baselines__` skipped). */
     specsDir: string;
     /** How the specs run: the app under test, its launch arguments and the timeouts. */
@@ -626,6 +679,12 @@ export interface WardenE2eSuite {
         except?: string[] | undefined;
         keep?: string[] | undefined;
     } | undefined;
+    /**
+     * Devices of this run have a fingerprint (Android) / Face ID (iOS) enrolled before any app install. Enrolled
+     * devices are a separate pool and golden from plain ones (profile `<profile>+bio`). Overrides the top-level
+     * `biometrics`. Default false.
+     */
+    biometrics?: boolean | undefined;
     /** Removed: renamed `warmDrivers`. */
     warmRunners?: undefined;
     /**
@@ -683,10 +742,55 @@ export interface WardenConfig {
         except?: string[] | undefined;
         keep?: string[] | undefined;
     } | undefined;
+    /**
+     * Devices of this run have a fingerprint (Android) / Face ID (iOS) enrolled before any app install. Enrolled
+     * devices are a separate pool and golden from plain ones (profile `<profile>+bio`). `e2e` suites and `batches` presets
+     * override it. Default false.
+     */
+    biometrics?: boolean | undefined;
     /** Perf budgets every `e2e` suite starts from (a suite's own `perf.budgets` replace them per key). */
     perf?: WardenPerfConfig | undefined;
+    /** Device conditions every `e2e` suite starts from (a suite's own `conditions` replace them per area). */
+    conditions?: WardenConditionsConfig | undefined;
     /** Android emulator settings. */
     android?: WardenAndroidSettings | undefined;
+    /** Physical iPhone settings. */
+    ios?: WardenIosSettings | undefined;
+    /** Physical phone and tablet settings. */
+    physical?: WardenPhysicalSettings | undefined;
+}
+/** Physical phone and tablet settings (`physical`). */
+export interface WardenPhysicalSettings {
+    /**
+     * Allowlist for `--physical` claims that name no device: only these adb serials / CoreDevice UDIDs are picked.
+     * `WARDEN_PHYSICAL_IDS` (comma-separated) wins over it. Naming a device with `--serial` / `--udid` works for
+     * any device, listed or not.
+     *
+     * @example ["00008140-000A0B0C0D0E0F10", "R5CT123ABC"]
+     */
+    allow?: string[] | undefined;
+}
+/** iOS settings of one project (`projects[].ios`). */
+export interface WardenProjectIos {
+    /** Builds for a physical iPhone (`--physical`, `--udid <iPhone>`). */
+    device?: {
+        bundleIdentifier?: string | undefined;
+    } | undefined;
+}
+/** Physical iPhone settings (`ios`). */
+export interface WardenIosSettings {
+    /**
+     * Apple developer team id (10 characters, e.g. `LN69P7N673`) that signs warden's on-device runner. Without it
+     * (and without `WARDEN_IOS_TEAM_ID`, which wins) warden uses the team of the one `Apple Development` identity
+     * in your keychain and fails `ios_team_ambiguous` when there are several teams.
+     */
+    teamId?: string | undefined;
+    /**
+     * Bundle id of the runner app (its UI-test bundle is `<id>.uitests`).
+     *
+     * @default "nz.co.delacour.warden.runner.<team id, lower case>"
+     */
+    runnerBundleId?: string | undefined;
 }
 /** Android emulator settings (`android`). */
 export interface WardenAndroidSettings {