detox 20.0.11-prerelease.0 → 20.0.13-prerelease.0

package/Detox-android/com/wix/detox/20.0.13-prerelease.0/detox-20.0.13-prerelease.0-javadoc.jar.md5

@@ -0,0 +1 @@
+43636e3328432ab0def8f704399cb9af

package/Detox-android/com/wix/detox/20.0.13-prerelease.0/detox-20.0.13-prerelease.0-javadoc.jar.sha1

@@ -0,0 +1 @@
+e87aec483ca0f1a8681dd604c172b1496be36552

package/Detox-android/com/wix/detox/20.0.13-prerelease.0/detox-20.0.13-prerelease.0-javadoc.jar.sha256

@@ -0,0 +1 @@
+4af74d1ca1aaeaa1d39e5d8911cbd10161b3114367691907d8e1618033d5b3e6

package/Detox-android/com/wix/detox/20.0.13-prerelease.0/detox-20.0.13-prerelease.0-javadoc.jar.sha512

@@ -0,0 +1 @@
+52171a50fce017136149bb98c6451148d77e4cf114b3026917dc51a603bd3e0f13aecdacf29a5f69731fa35767a0bd6947dfe4e7d48b16e277b73e5b5cc21619

package/Detox-android/com/wix/detox/20.0.13-prerelease.0/detox-20.0.13-prerelease.0-sources.jar.md5

@@ -0,0 +1 @@
+e8e7e3be590ebb3e05a4f2e4c4bfee02

package/Detox-android/com/wix/detox/20.0.13-prerelease.0/detox-20.0.13-prerelease.0-sources.jar.sha1

@@ -0,0 +1 @@
+58eb8e948d53b73075a1f5e97f7e1ef87335451d

package/Detox-android/com/wix/detox/20.0.13-prerelease.0/detox-20.0.13-prerelease.0-sources.jar.sha256

@@ -0,0 +1 @@
+4e2bc47c1bd786a7305e50cf174b2a44b76185b3510f43e6239783aa976f6ed7

package/Detox-android/com/wix/detox/20.0.13-prerelease.0/detox-20.0.13-prerelease.0-sources.jar.sha512

@@ -0,0 +1 @@
+88399f3c653950bc413629a0801211e0532b1fa8dcc012c37855deb27e5a048b2813c85079e21763f194c76ead892762d2e357b18869a1e3e0d465405f733aa2

package/Detox-android/com/wix/detox/{20.0.11-prerelease.0/detox-20.0.11-prerelease.0.pom → 20.0.13-prerelease.0/detox-20.0.13-prerelease.0.pom}

@@ -3,7 +3,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.wix</groupId>
   <artifactId>detox</artifactId>
-  <version>20.0.11-prerelease.0</version>
+  <version>20.0.13-prerelease.0</version>
   <packaging>aar</packaging>
   <name>Detox</name>
   <description>Gray box end-to-end testing and automation library for mobile apps</description>

package/Detox-android/com/wix/detox/20.0.13-prerelease.0/detox-20.0.13-prerelease.0.pom.md5

@@ -0,0 +1 @@
+af38d8520fe68b4005004b263bd44a99

package/Detox-android/com/wix/detox/20.0.13-prerelease.0/detox-20.0.13-prerelease.0.pom.sha1

@@ -0,0 +1 @@
+4b05c8d532f93162c18be667feb8f603f8a07341

package/Detox-android/com/wix/detox/20.0.13-prerelease.0/detox-20.0.13-prerelease.0.pom.sha256

@@ -0,0 +1 @@
+70d293de323b61f3f135b127ea949f8536f9a9693c13f4c496a68ceba31b2c2d

package/Detox-android/com/wix/detox/20.0.13-prerelease.0/detox-20.0.13-prerelease.0.pom.sha512

@@ -0,0 +1 @@
+fba1065b23a33a85282fbc1a47b80a2725dea603c2ccc4285956d04f7220d3428948b7dba61fe5ffad0928812c03f87549c4395b31df33e785e8b88fa5d46aeb

package/Detox-android/com/wix/detox/maven-metadata.xml

@@ -3,11 +3,11 @@
   <groupId>com.wix</groupId>
   <artifactId>detox</artifactId>
   <versioning>
-    <latest>20.0.11-prerelease.0</latest>
-    <release>20.0.11-prerelease.0</release>
+    <latest>20.0.13-prerelease.0</latest>
+    <release>20.0.13-prerelease.0</release>
     <versions>
-      <version>20.0.11-prerelease.0</version>
+      <version>20.0.13-prerelease.0</version>
     </versions>
-    <lastUpdated>20220930144845</lastUpdated>
+    <lastUpdated>20221027152922</lastUpdated>
   </versioning>
 </metadata>

package/Detox-android/com/wix/detox/maven-metadata.xml.md5

@@ -1 +1 @@
-7298eb41c092e9d6471b11d8c4072549
+ee112aada0b842b84d9d0ce02c34412d

package/Detox-android/com/wix/detox/maven-metadata.xml.sha1

@@ -1 +1 @@
-d59581aa200215423697a398b1e30952dbcad89d
+4a588bcf856923db72dcce6afbbd5d3e8deac76a

package/Detox-android/com/wix/detox/maven-metadata.xml.sha256

@@ -1 +1 @@
-964eb89f375a8ac845a5d63eaa867d544a7fdc4b0cd9abe539417827895a9b6a
+2508b9fd44abf05b74a3a95332f0ad7f91277e421f07301e69774ca9ab2addb8

package/Detox-android/com/wix/detox/maven-metadata.xml.sha512

@@ -1 +1 @@
-8b8c26e1906aff908931afb6a7e095bd0d4eb3b08df4061c5b3645c0a6c9e1dc3cc0e9415f7e7a4b5bd7aec76c1e8f2de11388067b1e4d33cfcc2d6eb595933e
+e99c975ec5eb3d44859e1b3730703240e4aafc46dd57adb66ea43667c2f16d4c57311ea041e605a68816353074b852dc9572513a66cbadf2963d2247fd3c5cd3

package/android/detox/proguard-rules-app.pro

@@ -1,4 +1,5 @@
 -keepattributes InnerClasses, Exceptions
+
 -keep class com.facebook.react.modules.** { *; }
 -keep class com.facebook.react.uimanager.** { *; }
 -keep class com.facebook.react.animated.** { *; }
@@ -8,8 +9,9 @@
 -keep class com.facebook.react.ReactInstanceManager** { *; }
 -keep class com.facebook.react.ReactInstanceEventListener { *; }
 
--keep class com.facebook.react.views.slider.ReactSlider { *; }
--keep class com.reactnativecommunity.slider.ReactSlider { *; }
+-keep class com.facebook.react.views.slider.** { *; }
+-keep class com.google.android.material.slider.** { *; }
+-keep class com.reactnativecommunity.slider.** { *; }
 -keep class com.reactnativecommunity.asyncstorage.** { *; }
 
 -keep class kotlin.jvm.** { *; }

package/index.d.ts

@@ -11,6 +11,7 @@
 import { BunyanDebugStreamOptions } from 'bunyan-debug-stream';
 
 declare global {
+    const detox: Detox.DetoxExportWrapper;
     const device: Detox.DetoxExportWrapper['device'];
     const element: Detox.DetoxExportWrapper['element'];
     const waitFor: Detox.DetoxExportWrapper['waitFor'];
@@ -20,6 +21,7 @@ declare global {
 
     namespace NodeJS {
         interface Global {
+            detox: Detox.DetoxExportWrapper;
             device: Detox.DetoxExportWrapper['device'];
             element: Detox.DetoxExportWrapper['element'];
             waitFor: Detox.DetoxExportWrapper['waitFor'];
@@ -103,9 +105,9 @@ declare global {
         interface DetoxLoggerConfig {
             level?: DetoxLogLevel;
             /**
-             * @default 'sandbox'
+             * @default true
              */
-            overrideConsole?: 'all' | 'sandbox' | 'none';
+            overrideConsole?: boolean;
             options?: BunyanDebugStreamOptions | ((config: Partial<DetoxLoggerConfig>) => BunyanDebugStreamOptions);
         }
 
@@ -137,9 +139,13 @@ declare global {
              */
             jest?: {
                 /**
-                 * Device init timeout
+                 * Environment setup timeout
+                 */
+                setupTimeout?: number | undefined;
+                /**
+                 * Environment teardown timeout
                  */
-                initTimeout?: number | undefined;
+                teardownTimeout?: number | undefined;
                 /**
                  * Insist on CLI-based retry mechanism even when the failed tests have been handled
                  * by jest.retryTimes(n) mechanism from Jest Circus.
@@ -152,11 +158,21 @@ declare global {
              * Retries count. Zero means a single attempt to run tests.
              */
             retries?: number;
+            /**
+             * When true, tells Detox CLI to cancel next retrying if it gets
+             * at least one report about a permanent test suite failure.
+             * Has no effect, if {@link DetoxTestRunnerConfig#retries} is
+             * undefined or set to zero.
+             *
+             * @default false
+             * @see {DetoxInternals.DetoxTestFileReport#isPermanentFailure}
+             */
+            bail?: boolean;
             /**
              * Custom handler to process --inspect-brk CLI flag.
-             * Use it when you rely on another test runner than Jest.
+             * Use it when you rely on another test runner than Jest to mutate the config.
              */
-            inspectBrk?: boolean | ((config: DetoxTestRunnerConfig) => void);
+            inspectBrk?: (config: DetoxTestRunnerConfig) => void;
             /**
              * Forward environment variables to the spawned test runner
              * accordingly to the given CLI argument overrides.

package/internals.d.ts

@@ -40,28 +40,80 @@ declare global {
       // endregion
 
       // region Lifecycle
-      onRunStart(event: unknown): Promise<void>;
-      onRunDescribeStart(event: unknown): Promise<void>;
-      onTestStart(event: unknown): Promise<void>;
-      onHookStart(event: unknown): Promise<void>;
-      onHookFailure(event: unknown): Promise<void>;
-      onHookSuccess(event: unknown): Promise<void>;
-      onTestFnStart(event: unknown): Promise<void>;
-      onTestFnFailure(event: unknown): Promise<void>;
-      onTestFnSuccess(event: unknown): Promise<void>;
-      onTestDone(event: unknown): Promise<void>;
-      onRunDescribeFinish(event: unknown): Promise<void>;
-      onRunFinish(event: unknown): Promise<void>;
-
-      /**
-       * Reports to Detox CLI about failed tests that could have been re-run if
+      /**
+       * Reports that the test runner started executing a test suite, e.g. a `beforeAll` hook or a first test.
+       */
+      onRunDescribeStart(event: {
+        /** Test suite name */
+        name: string;
+      }): Promise<void>;
+      /**
+       * Reports that the test runner started executing a specific test.
+       */
+      onTestStart(event: {
+        /** Test name */
+        title: string;
+        /** Test name including the ancestor suite titles */
+        fullName: string;
+        /**
+         * N-th time this test is running, if there is a retry mechanism.
+         *
+         * @default 1
+         */
+        invocations?: number;
+        status: 'running';
+      }): Promise<void>;
+      /**
+       * Reports about an error in the midst of `beforeAll`, `beforeEach`, `afterEach`, `afterAll` or any other hook.
+       */
+      onHookFailure(event: {
+        error: Error | string;
+        /**
+         * @example 'beforeAll'
+         * @example 'afterEach'
+         */
+        hook: string;
+      }): Promise<void>;
+      /**
+       * Reports about an error in the midst of a test function, `test` or `it`.
+       */
+      onTestFnFailure(event: {
+        error: Error | string;
+      }): Promise<void>;
+      /**
+       * Reports the final status of the test, `passed` or `failed`.
+       */
+      onTestDone(event: {
+        /** Test name */
+        title: string;
+        /** Test name including the ancestor suite titles */
+        fullName: string;
+        /**
+         * N-th time this test is running, if there is a retry mechanism.
+         *
+         * @default 1
+         */
+        invocations?: number;
+        status: 'passed' | 'failed';
+        /** Whether a timeout was the reason for why the test failed. */
+        timedOut?: boolean;
+      }): Promise<void>;
+      /**
+       * Reports that the test runner has finished executing a test suite, e.g. all the `afterAll` hooks have been executed or the last test has finished running.
+       */
+      onRunDescribeFinish(event: {
+        /** Test suite name */
+        name: string;
+      }): Promise<void>;
+
+      /**
+       * Reports to Detox CLI about passed and failed test files.
+       * The failed test files might be re-run again if
        * {@link Detox.DetoxTestRunnerConfig#retries} is set to a non-zero.
        *
-       * @param testFilePaths array of failed test files' paths
-       * @param permanent whether the failure is permanent, and the tests
-       * should not be re-run.
+       * @param testResults - reports about test files
        */
-      reportFailedTests(testFilePaths: string[], permanent?: boolean): Promise<void>;
+      reportTestResults(testResults: DetoxTestFileReport[]): Promise<void>;
       // endregion
 
       readonly config: RuntimeConfig;
@@ -88,11 +140,14 @@ declare global {
 
     type DetoxInitOptions = {
       cwd: string;
+      /**
+       * @internal
+       */
       argv: Record<string, unknown>;
       testRunnerArgv: Record<string, unknown>;
       override: Partial<Detox.DetoxConfig>;
       /** @inheritDoc */
-      global: NodeJS.Global;
+      global: NodeJS.Global | {};
       /**
        * Worker ID. Used to distinguish allocated workers in parallel test execution environment.
        *
@@ -111,7 +166,7 @@ declare global {
        * {@link DetoxInternals.Facade#setup} might override {@link Console} methods
        * to integrate it with Detox loggeing subsystem.
        */
-      global: NodeJS.Global;
+      global: NodeJS.Global | {};
       /**
        * Worker ID. Used to distinguish allocated workers in parallel test execution environment.
        *
@@ -120,25 +175,48 @@ declare global {
       workerId: string;
     };
 
+    type DetoxTestFileReport = {
+      /**
+       * Global or relative path to the failed test file.
+       */
+      testFilePath: string;
+      /**
+       * Whether the test passed or not.
+       */
+      success: boolean;
+      /**
+       * Top-level error if the entire test file failed.
+       */
+      testExecError?: { name?: string; message: string; stack?: string; };
+      /**
+       * If the test failed, it should tell whether the failure is permanent.
+       * Permanent failure means that the test file should not be re-run.
+       *
+       * @default false
+       * @see {Detox.DetoxTestRunnerConfig#retries}
+       */
+      isPermanentFailure?: boolean;
+    };
+
     type SessionState = Readonly<{
       /**
        * Randomly generated ID for the entire Detox test session, including retries.
        */
       id: string;
       /**
-       * Permanently failed test file paths.
-       */
-      failedTestFiles: string[];
-      /**
-       * Failed test file paths suggested to retry via Detox CLI mechanism.
+       * Results of test file executions. Primarily used for Detox CLI retry mechanism.
        */
-      testFilesToRetry: string[];
+      testResults: DetoxTestFileReport[];
       /**
        * Retry index of the test session: 0..retriesCount.
        */
       testSessionIndex: number;
       /**
-       * TODO
+       * Count of Detox contexts with a worker installed.
+       * Oversimplified, it reflects the count of allocated devices in the current test session.
+       *
+       * @see {Facade#init}
+       * @see {Facade#installWorker}
        */
       workersCount: number;
     }>;

package/local-cli/cli.js

@@ -1,8 +1,11 @@
 #!/usr/bin/env node
+const fs = require('fs');
+
+const _ = require('lodash');
 const yargs = require('yargs');
 
+const logger = require('../internals').log.child({ cat: 'cli' });
 const DetoxError = require('../src/errors/DetoxError');
-const logger = require('../src/utils/logger').child({ cat: 'cli' });
 
 yargs
   .scriptName('detox')
@@ -25,12 +28,11 @@ yargs
   .wrap(yargs.terminalWidth() * 0.9)
   .fail(function(msg, err, program) {
     if (err) {
-      const lines = DetoxError.format(err).split('\n');
-      for (const line of lines) {
-        logger.error(line);
-      }
+      logger.error(DetoxError.format(err));
       // eslint-disable-next-line no-console
       console.error('');
+      // @ts-ignore
+      _.attempt(() => fs.unlinkSync(logger.file));
       // eslint-disable-next-line no-process-exit
       process.exit(1);
     }

package/local-cli/init.js

@@ -76,7 +76,7 @@ function createDefaultConfigurations() {
         config: 'e2e/jest.config.js',
       },
       jest: {
-        initTimeout: 120000,
+        setupTimeout: 120000,
       },
     },
     apps: {

package/local-cli/reset-lock-file.js

@@ -0,0 +1,16 @@
+const { log } = require('../internals');
+const DeviceRegistry = require('../src/devices/DeviceRegistry');
+const { getDetoxLibraryRootPath } = require('../src/utils/environment');
+
+
+module.exports.command = 'reset-lock-file';
+module.exports.desc = 'Resets all Detox lock files. Useful when you need to run multiple `detox test` commands in parallel with --keepLockFile.';
+
+module.exports.handler = async function resetLockFile() {
+  await Promise.all([
+    DeviceRegistry.forIOS().reset(),
+    DeviceRegistry.forAndroid().reset(),
+  ]);
+
+  log.info(`Cleaned lock files from: ${getDetoxLibraryRootPath()}`);
+};

package/local-cli/test.js

@@ -16,14 +16,14 @@ module.exports.handler = async function test({ detoxArgs, runnerArgs }) {
     };
 
     const config = await detox.resolveConfig(opts);
-    if (!config.testRunner.inspectBrk) {
+    if (!detoxArgs['inspect-brk']) {
       await detox.init(opts);
     }
 
     const runnerCommand = new TestRunnerCommand()
-      .setDeviceConfig(detox.config.device)
-      .replicateCLIConfig(detox.config.cli)
-      .setRunnerConfig(detox.config.testRunner);
+      .setDeviceConfig(config.device)
+      .replicateCLIConfig(config.cli)
+      .setRunnerConfig(config.testRunner);
 
     await runnerCommand.execute();
   } finally {