@delacour/warden-e2e 0.11.0 → 0.12.1

package/types/e2e/src/devtools/native-log-tail.d.ts

@@ -0,0 +1,13 @@
+/** Console tail of a native log: the last few lines worth reading next to a failure. */
+export declare const TAIL_LINES = 20;
+/** `ndjson` of `log show` → up to {@link TAIL_LINES} readable lines; unresolved messages are never shown. */
+export declare function iosTail(ndjson: string): string[];
+/** How many of a `log show` ndjson's messages could not be composed (`<compose failure …>`). */
+export declare function unresolvedShare(ndjson: string): {
+    unresolved: number;
+    total: number;
+};
+/** `logcat -v epoch` text → up to {@link TAIL_LINES} lines, E/F/W first. */
+export declare function androidTail(logcat: string): string[];
+/** Console block for a failed attempt: a header, then each line indented. Empty for no lines. */
+export declare function formatNativeTail(lines: readonly string[]): string[];

package/types/e2e/src/devtools/native-log.d.ts

@@ -39,12 +39,25 @@ export type NativeLogWindow = {
 export type NativeCapture = {
     files: string[];
     problems: string[];
+    /** the last readable lines (errors first, at most 20) to print next to the failure */
+    tail: string[];
 };
+/** `log config` flag name for the opt-out of private data on the simulator. */
+export declare const NATIVE_PRIVATE_DATA_ENV = "WARDEN_NATIVE_LOG_PRIVATE";
+/**
+ * Makes sure the simulator's own logd keeps `%{private}` values readable (`log config --mode private_data:on`)
+ * so `native.log` shows them instead of `<private>`. It must be set before the app logs: what logd redacts when
+ * it writes cannot be recovered when it is read. Skipped when `log config --status` already lists `PRIVATE_DATA`
+ * (the case on the iOS 27.0 simulator, which refuses the change with "Simulator unable to set system mode").
+ * The sim is a leased, disposable test device. Resolves with a problem string, never throws.
+ */
+export declare function enableNativePrivateData(udid: string, exec: Exec, timeoutMs?: number): Promise<string | undefined>;
 export declare function realNativeFs(): NativeFs;
 export declare function realNativeLogDeps(exec: Exec, adb: string): NativeLogDeps;
 /**
  * `native.log` (and iOS `.ips` crash reports) for a failed attempt, read after the fact: iOS
- * `simctl spawn log show` for the app's process over the attempt's window, Android `logcat -d` for its pid
+ * `simctl spawn log show` (inside the simulator, so format strings resolve against the runtime's own shared cache)
+ * for the app's process over the attempt's window, Android `logcat -d` for its pid
  * plus the crash buffer. Reading afterwards needs no stream to start, stop or leak. Never throws.
  */
 export declare function captureNativeLog(target: NativeTarget, deps: NativeLogDeps, win: NativeLogWindow): Promise<NativeCapture>;

package/types/e2e/src/runner/failure.d.ts

@@ -13,6 +13,8 @@ export type CaptureBudget = () => number;
 export type FailureCapture = {
     /** files written into `dir`, relative to it */
     files: string[];
+    /** readable lines to print next to the failure (native log tail); absent for captures that have none */
+    tail?: string[];
     /** what could not be captured, for the trace */
     problems: string[];
 };

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

@@ -1,5 +1,5 @@
 import { type DevtoolsFacet, type DevtoolsResult } from "./devtools/devtools.types";
-import type { NativeLogDeps } from "./devtools/native-log";
+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";