nativeproof 0.10.3 → 0.10.4

package/CHANGELOG.md

@@ -4,6 +4,23 @@ All notable changes to NativeProof are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/) and the project adheres to
 [Semantic Versioning](https://semver.org/).
 
+## 0.10.4
+
+Per-project spec sets and WebdriverIO tuning pass-through, for suites that run a different set of
+specs per platform and need longer timeouts on slow devices.
+
+**Added**
+
+- `DeviceProject.specs` — per-project spec globs that override the top-level `testDir`/`testMatch`,
+  for suites where platforms run different specs (e.g. a shared set plus a platform-specific set:
+  `["e2e/shared/**\/*.spec.ts", "e2e/android/**\/*.spec.ts"]`). A `--spec` CLI override still wins.
+  Precedence: `--spec` (comma-separated) > `project.specs` > `testDir`/`testMatch`.
+- WebdriverIO tuning pass-throughs on `RunnerConfig`: `connectionRetryTimeout`,
+  `connectionRetryCount`, `waitforTimeout`, `bail`, and `logLevel`. Each is forwarded to the
+  synthesised WebdriverIO config only when set, so WebdriverIO's own defaults apply otherwise —
+  slow software-GPU emulators in particular often need longer connection/wait timeouts. `bail: 0`
+  is meaningful (never bail) and is still forwarded.
+
 ## 0.10.3
 
 Out-of-the-box setup: scaffolding, minimal config, a route-optional mock contract, and typed

package/README.md

@@ -100,7 +100,13 @@ npx appium driver doctor uiautomator2
 
 ## Quick start
 
-Four steps from zero to a green run on Android.
+Scaffold the starting files with one command, then fill in your app's seam:
+
+```bash
+npx nativeproof init   # writes nativeproof.config.ts + a sample spec (never overwrites)
+```
+
+Then four steps from zero to a green run on Android — or set it all up by hand:
 
 **1. Configure** — one `nativeproof.config.ts` at the project root:
 

package/dist/config.d.ts

@@ -36,6 +36,13 @@ export interface DeviceProject {
      * for a smoke run against whatever is already installed. Anything you set here wins.
      */
     capabilities?: Record<string, unknown>;
+    /**
+     * Spec globs for THIS project, relative to the project root — overriding the top-level
+     * `testDir`/`testMatch` when set. For suites where platforms run different specs (e.g. a shared
+     * set plus a platform-specific set: `["e2e/shared/**\/*.spec.ts", "e2e/android/**\/*.spec.ts"]`).
+     * A `--spec` CLI override still wins over this.
+     */
+    specs?: string[];
 }
 /**
  * The standard capabilities for a platform, so a consumer doesn't restate the same
@@ -47,12 +54,27 @@ export declare function defaultCapabilities(platform: "android" | "ios"): Record
 export interface RunnerConfig {
     /** Directory holding the specs (default "tests"). */
     testDir?: string;
-    /** Glob within `testDir` (default "**\/*.spec.ts"). */
+    /** Glob within `testDir` (default "**\/*.spec.ts"). A project's own `specs` overrides this. */
     testMatch?: string;
     projects: DeviceProject[];
     appium?: AppiumOptions;
     /** Per-test timeout in ms (default 240000). */
     mochaTimeout?: number;
+    /**
+     * WebdriverIO pass-throughs for tuning real-device runs. Each is forwarded only when set, so
+     * WebdriverIO's own defaults apply otherwise. Slow software-GPU emulators in particular often
+     * need a longer `connectionRetryTimeout` / `waitforTimeout` than the defaults.
+     */
+    /** Per-command/session connection timeout in ms (wdio default 120000). */
+    connectionRetryTimeout?: number;
+    /** Connection retry count (wdio default 3). */
+    connectionRetryCount?: number;
+    /** Default auto-wait timeout in ms for `waitUntil`/`waitFor*` (wdio default 5000). */
+    waitforTimeout?: number;
+    /** Stop the run after N failures; 0 = never bail (wdio default 0). */
+    bail?: number;
+    /** WebdriverIO log level (wdio default "info"). */
+    logLevel?: "trace" | "debug" | "info" | "warn" | "error" | "silent";
 }
 export interface NativeProofConfig<Ctx = unknown> extends RunnerConfig {
     /** The app under test (from `defineApp`). */
@@ -72,9 +94,7 @@ export interface RunnerEnv {
 /** Pick the project by explicit name, else by platform, else the first one. */
 export declare function resolveProject(config: RunnerConfig, env?: RunnerEnv): DeviceProject;
 /**
- * Translate an NativeProof config into a WebdriverIO `config` object. Spec paths are made
- * absolute against `cwd` (the project root) because the synthesised config is loaded from
- * inside `node_modules`, so a relative glob would resolve against the wrong directory.
+ * Translate an NativeProof config into a WebdriverIO `config` object.
  */
 export declare function buildWdioConfig(config: RunnerConfig, env?: RunnerEnv, cwd?: string): Record<string, unknown>;
 /** Find an `nativeproof.config.*` in `dir`, or null. `exists` is injectable for testing. */

package/dist/config.js

@@ -34,21 +34,32 @@ export function resolveProject(config, env = {}) {
     return first;
 }
 /**
- * Translate an NativeProof config into a WebdriverIO `config` object. Spec paths are made
- * absolute against `cwd` (the project root) because the synthesised config is loaded from
- * inside `node_modules`, so a relative glob would resolve against the wrong directory.
+ * Resolve the spec globs (absolute) for a run, in precedence order: an explicit `--spec` override
+ * (comma-separated allowed), else the active project's own `specs`, else the top-level
+ * `testDir`/`testMatch`. Absolute against `cwd` because the synthesised config is loaded from inside
+ * `node_modules`, so a relative glob would resolve against the wrong directory.
  */
-export function buildWdioConfig(config, env = {}, cwd = process.cwd()) {
-    const project = resolveProject(config, env);
+function resolveSpecs(config, project, env, cwd) {
+    const abs = (glob) => path.resolve(cwd, glob);
+    if (env.spec)
+        return env.spec.split(",").map((glob) => abs(glob.trim()));
+    if (project.specs && project.specs.length > 0)
+        return project.specs.map(abs);
     const testDir = config.testDir ?? "tests";
     const testMatch = config.testMatch ?? "**/*.spec.ts";
-    const specs = [path.resolve(cwd, env.spec ?? `${testDir}/${testMatch}`)];
-    return {
+    return [abs(`${testDir}/${testMatch}`)];
+}
+/**
+ * Translate an NativeProof config into a WebdriverIO `config` object.
+ */
+export function buildWdioConfig(config, env = {}, cwd = process.cwd()) {
+    const project = resolveProject(config, env);
+    const wdio = {
         runner: "local",
         hostname: env.appiumHost ?? config.appium?.host ?? "127.0.0.1",
         port: env.appiumPort ?? config.appium?.port ?? 4723,
         path: env.appiumPath ?? config.appium?.path ?? "/wd/hub",
-        specs,
+        specs: resolveSpecs(config, project, env, cwd),
         maxInstances: 1,
         capabilities: [{ ...defaultCapabilities(project.platform), ...project.capabilities }],
         framework: "mocha",
@@ -64,6 +75,19 @@ export function buildWdioConfig(config, env = {}, cwd = process.cwd()) {
             await captureState(failureEvidenceName(test)).catch(() => { });
         },
     };
+    // Optional WebdriverIO tuning — forwarded only when the consumer set it, so wdio's defaults apply
+    // otherwise (real emulators/simulators often need longer connection/wait timeouts than the defaults).
+    if (config.connectionRetryTimeout !== undefined)
+        wdio.connectionRetryTimeout = config.connectionRetryTimeout;
+    if (config.connectionRetryCount !== undefined)
+        wdio.connectionRetryCount = config.connectionRetryCount;
+    if (config.waitforTimeout !== undefined)
+        wdio.waitforTimeout = config.waitforTimeout;
+    if (config.bail !== undefined)
+        wdio.bail = config.bail;
+    if (config.logLevel !== undefined)
+        wdio.logLevel = config.logLevel;
+    return wdio;
 }
 const CONFIG_NAMES = [
     "nativeproof.config.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nativeproof",
-  "version": "0.10.3",
+  "version": "0.10.4",
   "license": "MIT",
   "type": "module",
   "description": "Native Mobile E2E test framework inspired by Playwright (fixtures, locators, expect, route-style mocking) on Appium/WebdriverIO.",