@testspectra/cli 1.0.70 → 1.1.0-rc.1

package/dist/config/schema.d.ts

@@ -9,97 +9,106 @@ export interface WebConfig {
     baseUrl: string;
     /**
      * Maximum number of parallel browser sessions/workers spawned during test execution.
-     * @default "1"
+     * Can be an explicit number, numeric string, or `"auto"`.
+     * @default "auto"
      */
-    maxConcurrentSessions: string;
+    maxConcurrentSessions: number | string | 'auto';
     /**
      * Whether to run browsers in headless mode without a visible GUI window.
      * @default true
      */
-    headlessMode: boolean;
+    headless: boolean | 'new';
     /**
      * Implicit wait timeout (in milliseconds) for finding elements before throwing an error.
+     * Also the ceiling auto-waiting element assertions/actions poll against (capped at 2000ms for
+     * assertions — see `getAssertionTimeoutMs()`).
      * @default "5000"
      */
     implicitWait: string;
     /**
-     * Maximum time (in milliseconds) allowed for a webpage to complete navigation and initial load.
-     * @default "30000"
-     */
-    pageLoadTimeout: string;
-    /**
-     * Maximum time (in milliseconds) allowed for asynchronous scripts to finish executing.
-     * @default "30000"
+     * Delay between consecutive actions and commands in milliseconds (slow motion).
+     * @default 0
      */
-    scriptTimeout: string;
+    stepDelay?: number;
     /**
      * Parallelization granularity:
      * - `"testcase"`: Each test case executes in parallel across available workers.
      * - `"suite"`: Test cases within a suite run serially, while different suites run in parallel.
      * @default "testcase"
      */
-    parallelizationMode: "testcase" | "suite";
+    parallelizationMode: 'testcase' | 'suite';
 }
 /**
- * Browser target definition for web test execution.
+ * Target Android device specification for multi-device parallel execution.
  */
-export interface Browser {
+export interface AndroidDeviceTarget {
     /**
-     * Unique identifier for this browser configuration.
+     * ADB serial or device ID (e.g. "emulator-5554", "192.168.1.50:5555").
      */
     id: string;
     /**
-     * Browser type/engine: `"chrome"`, `"firefox"`, `"safari"`, `"edge"`.
-     * @default "chrome"
+     * Emulator AVD name (e.g. "Pixel_7_Pro_API_34").
      */
-    type: string;
+    avd?: string;
     /**
-     * Whether to simulate mobile viewport and touch metrics.
-     * @default false
+     * Friendly display/model name (e.g. "Pixel 7 Pro").
      */
-    mobileEmulation: boolean;
+    name?: string;
     /**
-     * Emulated device name when `mobileEmulation` is true (e.g. `"iPhone 14"`, `"Pixel 7"`).
+     * Android OS version (e.g. "14.0").
      */
-    deviceName?: string;
+    version?: string;
     /**
-     * Custom browser window width in pixels.
+     * UiAutomator2 port (e.g. 8200).
      */
-    width?: string;
+    systemPort?: number;
     /**
-     * Custom browser window height in pixels.
+     * Custom Appium capabilities overrides for this specific device.
      */
-    height?: string;
+    capabilities?: Record<string, any>;
 }
 /**
- * Configuration for Android mobile test automation with Appium & UiAutomator2.
+ * Target iOS device specification for multi-device parallel execution.
  */
-export interface AndroidConfig {
+export interface IosDeviceTarget {
     /**
-     * Appium server endpoint URL.
-     * @default "http://127.0.0.1:4723"
+     * Device ID or simulator slug (e.g. "iphone-15-pro").
      */
-    appiumServer: string;
+    id: string;
     /**
-     * Mobile platform name.
-     * @default "Android"
+     * Friendly name (e.g. "iPhone 15 Pro Simulator").
      */
-    platformName: string;
+    name?: string;
     /**
-     * Android OS version (e.g. `"13"`, `"14"`).
-     * @default "13"
+     * iOS version (e.g. "17.0").
      */
-    platformVersion: string;
+    version?: string;
     /**
-     * Target Android device name or ADB serial ID (e.g. `"emulator-5554"`).
-     * @default "emulator-5554"
+     * Physical device UDID or "auto".
      */
-    deviceName: string;
+    udid?: string;
     /**
-     * Appium mobile automation driver engine.
-     * @default "UiAutomator2"
+     * WebDriverAgent local port (e.g. 8100).
      */
-    automationName: string;
+    wdaLocalPort?: number;
+    /**
+     * Custom Appium capabilities overrides for this specific device.
+     */
+    capabilities?: Record<string, any>;
+}
+/**
+ * Configuration for Android mobile test automation with Spectra Android Native Driver.
+ */
+export interface AndroidConfig {
+    /**
+     * Spectra Android Driver server endpoint URL.
+     * @default "tcp://127.0.0.1:8200"
+     */
+    driverServer?: string;
+    /**
+     * Legacy Appium server endpoint URL (fallback, deprecated — use `driverServer`).
+     */
+    appiumServer?: string;
     /**
      * Android application package name (e.g. `"com.example.app"`).
      */
@@ -108,11 +117,6 @@ export interface AndroidConfig {
      * Main activity name launched when starting the app.
      */
     appActivity: string;
-    /**
-     * Whether to automatically grant Android runtime permissions upon installation.
-     * @default true
-     */
-    autoGrantPermissions: boolean;
     /**
      * Whether to preserve app state and prevent clearing app data/cache between sessions.
      * @default false
@@ -120,39 +124,47 @@ export interface AndroidConfig {
     noReset: boolean;
     /**
      * Implicit wait timeout (in milliseconds) for locating mobile elements.
-     * @default "10000"
+     * @default 10000
      */
-    implicitWait: string;
+    implicitWait: string | number;
     /**
      * Parallelization execution mode for Android mobile tests.
      * @default "suite"
      */
-    parallelizationMode: "testcase" | "suite";
+    parallelizationMode: 'testcase' | 'suite';
+    /**
+     * Array of explicit target devices or configurations for multi-device parallel execution.
+     * Each entry can specify its own `id`, `name`, `version`, `avd`, `systemPort`, etc.
+     */
+    devices: (string | AndroidDeviceTarget)[] | 'auto';
+    /**
+     * Raw custom WebdriverIO / Appium capabilities array override.
+     */
+    capabilities?: Record<string, any>[];
+    /**
+     * Maximum concurrent mobile sessions/devices cap.
+     */
+    maxConcurrentSessions?: number | string;
+    /**
+     * Delay between consecutive actions and commands in milliseconds (slow motion).
+     * @default 0
+     */
+    stepDelay?: number;
 }
 /**
  * Configuration for iOS mobile test automation with Appium & XCUITest.
  */
 export interface IosConfig {
+    /**
+     * Delay between consecutive actions and commands in milliseconds (slow motion).
+     * @default 0
+     */
+    stepDelay?: number;
     /**
      * Appium server endpoint URL.
      * @default "http://127.0.0.1:4723"
      */
     appiumServer: string;
-    /**
-     * Mobile platform name.
-     * @default "iOS"
-     */
-    platformName: string;
-    /**
-     * iOS version (e.g. `"16.0"`, `"17.0"`).
-     * @default "16.0"
-     */
-    platformVersion: string;
-    /**
-     * iOS simulator or connected physical device name (e.g. `"iPhone 14"`).
-     * @default "iPhone 14"
-     */
-    deviceName: string;
     /**
      * Appium mobile automation driver engine for iOS.
      * @default "XCUITest"
@@ -166,16 +178,28 @@ export interface IosConfig {
      * Target device Unique Device Identifier (UDID) or `"auto"`.
      * @default "auto"
      */
-    udid: string;
+    udid?: string;
+    /**
+     * Array of explicit target devices or configurations for multi-device execution.
+     */
+    devices: (string | IosDeviceTarget)[] | 'auto';
+    /**
+     * Raw custom WebdriverIO / Appium capabilities array override.
+     */
+    capabilities?: Record<string, any>[];
+    /**
+     * Maximum concurrent mobile sessions/devices cap.
+     */
+    maxConcurrentSessions?: number | string;
     /**
      * Apple Developer Team 10-character Organization ID for code signing.
      */
-    xcodeOrgId: string;
+    xcodeOrgId?: string;
     /**
      * Xcode code signing identity string (e.g. `"iPhone Developer"`).
      * @default "iPhone Developer"
      */
-    xcodeSigningId: string;
+    xcodeSigningId?: string;
     /**
      * Whether to automatically accept iOS system permission alerts.
      * @default true
@@ -188,48 +212,14 @@ export interface IosConfig {
     noReset: boolean;
     /**
      * Implicit wait timeout (in milliseconds) for locating iOS UI elements.
-     * @default "10000"
+     * @default 10000
      */
-    implicitWait: string;
+    implicitWait: string | number;
     /**
      * Parallelization execution mode for iOS mobile tests.
      * @default "suite"
      */
-    parallelizationMode: "testcase" | "suite";
-}
-/**
- * Load testing stage ramp-up profile.
- */
-export interface LoadStage {
-    /**
-     * Stage identifier.
-     */
-    id: string;
-    /**
-     * Duration for this load stage (e.g. `"30s"`, `"2m"`).
-     */
-    duration: string;
-    /**
-     * Target virtual users (VUs) to scale to during this stage.
-     */
-    targetVUs: string;
-}
-/**
- * Performance and pass/fail metric threshold definition.
- */
-export interface SuccessThreshold {
-    /**
-     * Unique threshold identifier.
-     */
-    id: string;
-    /**
-     * Performance metric type (e.g. `"http_req_duration"`, `"http_req_failed"`).
-     */
-    metricType: string;
-    /**
-     * Maximum acceptable value (e.g. `"500ms"`, `"0.01"`).
-     */
-    maxValue: string;
+    parallelizationMode: 'testcase' | 'suite';
 }
 /**
  * Specific domain filter for real-time network interception and recording.
@@ -244,19 +234,6 @@ export interface MonitoredDomain {
      */
     enabled: boolean;
 }
-/**
- * Custom environment variable key-value pair injected into the test execution sandbox.
- */
-export interface EnvironmentVariable {
-    /**
-     * Environment variable name (e.g. `"API_SECRET_KEY"`).
-     */
-    key: string;
-    /**
-     * Environment variable value.
-     */
-    value: string;
-}
 /**
  * Test execution, CDP network monitoring, and sandbox environment configuration.
  */
@@ -281,9 +258,10 @@ export interface ExecutionConfig {
      */
     monitoredDomains?: MonitoredDomain[];
     /**
-     * Custom environment variables injected into the test process runtime.
+     * Custom environment variables injected into the test process runtime
+     * (e.g. `{ API_SECRET_KEY: "..." }`).
      */
-    environmentVariables?: EnvironmentVariable[];
+    environmentVariables?: Record<string, string>;
 }
 /**
  * Root configuration data structure matching TestSpectra project schema.
@@ -293,10 +271,6 @@ export interface ConfigData {
      * Web browser execution settings.
      */
     webConfig: WebConfig;
-    /**
-     * List of target browsers for web automation runs.
-     */
-    browsers: Browser[];
     /**
      * Android Appium driver and device options.
      */
@@ -305,21 +279,6 @@ export interface ConfigData {
      * iOS Appium driver and device options.
      */
     iosConfig: IosConfig;
-    /**
-     * Load testing parameters.
-     */
-    loadConfig: {
-        virtualUsers: string;
-        duration: string;
-    };
-    /**
-     * Load testing stages.
-     */
-    loadStages: LoadStage[];
-    /**
-     * Pass/fail metric thresholds.
-     */
-    thresholds: SuccessThreshold[];
     /**
      * Advanced execution and network recording settings.
      */
@@ -328,9 +287,9 @@ export interface ConfigData {
 /**
  * Deep recursive partial type for user-friendly configuration objects.
  */
-export type DeepPartial<T> = {
-    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
-};
+export type DeepPartial<T> = T extends Function | boolean | number | string | symbol | null | undefined ? T : T extends Array<infer U> ? DeepPartial<U>[] : T extends ReadonlyArray<infer U> ? readonly DeepPartial<U>[] : T extends object ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : T;
 /**
  * User-provided configuration options with optional deep partial properties.
  */
@@ -345,7 +304,7 @@ export type UserConfig = DeepPartial<ConfigData>;
  * export default defineConfig({
  *   webConfig: {
  *     baseUrl: "https://example.com",
- *     headlessMode: false,
+ *     headless: false,
  *   },
  * });
  * ```

package/dist/config/schema.js

@@ -8,7 +8,7 @@
  * export default defineConfig({
  *   webConfig: {
  *     baseUrl: "https://example.com",
- *     headlessMode: false,
+ *     headless: false,
  *   },
  * });
  * ```
@@ -21,60 +21,51 @@ export function defineConfig(config) {
  */
 export const DEFAULT_CONFIG_DATA = {
     webConfig: {
-        baseUrl: "http://localhost:3000",
-        maxConcurrentSessions: "1",
-        headlessMode: true,
-        implicitWait: "5000",
-        pageLoadTimeout: "30000",
-        scriptTimeout: "30000",
-        parallelizationMode: "testcase",
+        baseUrl: 'http://localhost:3000',
+        maxConcurrentSessions: '1',
+        headless: true,
+        implicitWait: '5000',
+        parallelizationMode: 'testcase',
     },
-    browsers: [
-        {
-            id: "chrome-desktop",
-            type: "chrome",
-            mobileEmulation: false,
-        },
-    ],
     androidConfig: {
-        appiumServer: "http://127.0.0.1:4723",
-        platformName: "Android",
-        platformVersion: "13",
-        deviceName: "emulator-5554",
-        automationName: "UiAutomator2",
-        appPackage: "",
-        appActivity: "",
-        autoGrantPermissions: true,
+        driverServer: 'http://127.0.0.1:4800',
+        appPackage: '',
+        appActivity: '',
         noReset: false,
-        implicitWait: "10000",
-        parallelizationMode: "suite",
+        implicitWait: 10000,
+        parallelizationMode: 'suite',
+        devices: [
+            {
+                id: 'emulator-5554',
+                name: 'Pixel 7 Pro Emulator',
+                version: '14.0',
+                systemPort: 8200,
+            },
+        ],
     },
     iosConfig: {
-        appiumServer: "http://127.0.0.1:4723",
-        platformName: "iOS",
-        platformVersion: "16.0",
-        deviceName: "iPhone 14",
-        automationName: "XCUITest",
-        bundleId: "",
-        udid: "auto",
-        xcodeOrgId: "",
-        xcodeSigningId: "iPhone Developer",
+        appiumServer: 'http://127.0.0.1:4723',
+        automationName: 'XCUITest',
+        bundleId: '',
         autoAcceptAlerts: true,
         noReset: false,
-        implicitWait: "10000",
-        parallelizationMode: "suite",
+        implicitWait: 10000,
+        parallelizationMode: 'suite',
+        devices: [
+            {
+                id: 'iphone-15-pro',
+                name: 'iPhone 15 Pro Simulator',
+                version: '17.0',
+                udid: 'auto',
+                wdaLocalPort: 8100,
+            },
+        ],
     },
-    loadConfig: {
-        virtualUsers: "10",
-        duration: "1m",
-    },
-    loadStages: [],
-    thresholds: [],
     executionConfig: {
         networkMonitoringEnabled: true,
-        fastResponseTime: "200",
-        normalResponseTime: "1000",
+        fastResponseTime: '200',
+        normalResponseTime: '1000',
         monitoredDomains: [],
-        environmentVariables: [],
+        environmentVariables: {},
     },
 };

package/dist/generator/__tests__/tsconfig-isolation.test.d.ts

@@ -0,0 +1 @@
+export {};