@delacour/warden-e2e 0.1.1 → 0.2.0

package/types/e2e/src/session.d.ts

@@ -1,5 +1,7 @@
 import { type DevtoolsFacet, type DevtoolsResult } from "./devtools/devtools.types";
+import type { NativeLogDeps } from "./devtools/native-log";
 import type { Driver, DriverResult } from "./driver/driver.types";
+import { type HidRecoveryDeps } from "./driver/ios/hid-recovery";
 import { type E2eEnv } from "./env";
 import type { AttemptContext, FixtureFactory } from "./runner/fixtures.types";
 import { type ResultsWriter } from "./runner/results";
@@ -25,6 +27,15 @@ export type Session = {
     readonly results: ResultsWriter;
     /** builds `app`/`device`/`screen` for each attempt (T4/T6); settable so tests can fake it */
     fixtures: FixtureFactory | undefined;
+    /** how a failed attempt's `native.log` / crash reports are read; absent in unit tests (nothing is spawned) */
+    nativeLog: NativeLogDeps | undefined;
+    /**
+     * Present for iOS runs with recovery wired: after a test failed with a lost HID connection, reboots the sim and
+     * reopens the driver and devtools, once per session. Resolves `true` when the test is worth running again.
+     */
+    recoverHid: (() => Promise<boolean>) | undefined;
+    /** closes the open driver and devtools so the next call opens them afresh (the device was rebooted under them) */
+    resetDevice(): Promise<void>;
     /** where the console reporter prints one line; default fd 1 */
     readonly log: (line: string) => void;
     /** the running attempt, if any */
@@ -70,6 +81,10 @@ export type SessionOptions = {
     driverFactory?: DriverFactory;
     /** how to attach devtools; default {@link openDevtools} */
     devtools?: DevtoolsOpener;
+    /** native log reader; default {@link setDefaultNativeLog}'s */
+    nativeLog?: NativeLogDeps;
+    /** sim reboot seams; default {@link setDefaultHidRecovery}'s */
+    hidRecovery?: HidRecoveryDeps;
     /** fixture factory; default {@link setDefaultFixtureFactory}'s */
     fixtures?: FixtureFactory;
     /** console line sink; default writes to fd 1 (bun test captures `process.stdout`, fd 1 is not captured) */
@@ -77,6 +92,10 @@ export type SessionOptions = {
     /** close from `process.on("exit")`; default true */
     exitHook?: boolean;
 };
+/** Wires the HID-loss recovery used when a session gets none (`preload.ts` registers the real one). */
+export declare function setDefaultHidRecovery(deps: HidRecoveryDeps | undefined): void;
+/** Wires the native-log reader used when a session gets none (`preload.ts` registers the real one). */
+export declare function setDefaultNativeLog(deps: NativeLogDeps | undefined): void;
 /** Wires the factory used when `getSession` gets none (`driver/open.ts`'s opener, set by the package entry). */
 export declare function setDefaultDriverFactory(factory: DriverFactory | undefined): void;
 /** Whether a default driver factory is wired (so the preload leaves a test-installed fake alone). */