detox 20.0.12-prerelease.0 → 20.0.14-next-is-hittable-check-2.0

package/Detox-android/com/wix/detox/20.0.14-next-is-hittable-check-2.0/detox-20.0.14-next-is-hittable-check-2.0-javadoc.jar.md5

@@ -0,0 +1 @@
+0b09890dab4c0f9d2e18ce9810152b48

package/Detox-android/com/wix/detox/20.0.14-next-is-hittable-check-2.0/detox-20.0.14-next-is-hittable-check-2.0-javadoc.jar.sha1

@@ -0,0 +1 @@
+4fb3f1aa20e1d1a833a2ef036ca603165505cc54

package/Detox-android/com/wix/detox/20.0.14-next-is-hittable-check-2.0/detox-20.0.14-next-is-hittable-check-2.0-javadoc.jar.sha256

@@ -0,0 +1 @@
+6bfd20ec1ae900abd578d862751e5ac04ef373cbe27201e7dbb078779340eaa5

package/Detox-android/com/wix/detox/20.0.14-next-is-hittable-check-2.0/detox-20.0.14-next-is-hittable-check-2.0-javadoc.jar.sha512

@@ -0,0 +1 @@
+f969f49c3ed45ff55bc020e06ed2ce25ec442379d558f6c9a7a1f0345a472a4245cfaad8ceba876e6459920c8fb691eddc7906baf4231ef7838bc49c3822f2cd

package/Detox-android/com/wix/detox/20.0.14-next-is-hittable-check-2.0/detox-20.0.14-next-is-hittable-check-2.0-sources.jar.md5

@@ -0,0 +1 @@
+d9897e95c4ecf505d3f7b2ae7e11eb47

package/Detox-android/com/wix/detox/20.0.14-next-is-hittable-check-2.0/detox-20.0.14-next-is-hittable-check-2.0-sources.jar.sha1

@@ -0,0 +1 @@
+fad4877aef09f6ff02c3fd424200df022e44f047

package/Detox-android/com/wix/detox/20.0.14-next-is-hittable-check-2.0/detox-20.0.14-next-is-hittable-check-2.0-sources.jar.sha256

@@ -0,0 +1 @@
+6d018ab8b1a477b086e9cb9daabb86b406a84b908acb5b51aa19e07cf178c4f7

package/Detox-android/com/wix/detox/20.0.14-next-is-hittable-check-2.0/detox-20.0.14-next-is-hittable-check-2.0-sources.jar.sha512

@@ -0,0 +1 @@
+fb025c2b71f43d76d274e2a9c62654f6b3497cdf8ddf4b92318a35508e3383c87a0ed0b9f5e461c7e1a6779962d3a012f23baa9a9f2116525f6c32d8c163882c

package/Detox-android/com/wix/detox/{20.0.12-prerelease.0/detox-20.0.12-prerelease.0.pom → 20.0.14-next-is-hittable-check-2.0/detox-20.0.14-next-is-hittable-check-2.0.pom}

@@ -3,7 +3,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.wix</groupId>
   <artifactId>detox</artifactId>
-  <version>20.0.12-prerelease.0</version>
+  <version>20.0.14-next-is-hittable-check-2.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.14-next-is-hittable-check-2.0/detox-20.0.14-next-is-hittable-check-2.0.pom.md5

@@ -0,0 +1 @@
+a3e045f487ba8e722d220f63208ad9ac

package/Detox-android/com/wix/detox/20.0.14-next-is-hittable-check-2.0/detox-20.0.14-next-is-hittable-check-2.0.pom.sha1

@@ -0,0 +1 @@
+779c98eabebaa2cebd52d12afa1981259ecdb05a

package/Detox-android/com/wix/detox/20.0.14-next-is-hittable-check-2.0/detox-20.0.14-next-is-hittable-check-2.0.pom.sha256

@@ -0,0 +1 @@
+ba3edd4b7874e8e296a34bc55fa4aa1d49a40eb36ce442de000e62e9876e3b2d

package/Detox-android/com/wix/detox/20.0.14-next-is-hittable-check-2.0/detox-20.0.14-next-is-hittable-check-2.0.pom.sha512

@@ -0,0 +1 @@
+05ee92a5fcff9f5b53bc52ba1d5e3915369d0b34df12f94690f8b87f30ec705d2ba00d52bc79293cbcfecfbdc6773167b544b4973d82fbb4d6ecaed4ee3ae2a5

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

@@ -3,11 +3,11 @@
   <groupId>com.wix</groupId>
   <artifactId>detox</artifactId>
   <versioning>
-    <latest>20.0.12-prerelease.0</latest>
-    <release>20.0.12-prerelease.0</release>
+    <latest>20.0.14-next-is-hittable-check-2.0</latest>
+    <release>20.0.14-next-is-hittable-check-2.0</release>
     <versions>
-      <version>20.0.12-prerelease.0</version>
+      <version>20.0.14-next-is-hittable-check-2.0</version>
     </versions>
-    <lastUpdated>20221011170939</lastUpdated>
+    <lastUpdated>20221102074725</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-79cf31a8db7ad74ff1286cd11496ad71
+a1b9fb9ca9d07b3262312c77cbff61fb

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

@@ -1 +1 @@
-0d7ee0e81eefa10376669b9858bd76020fde79ca
+e8e44759632af3d4984893f4a28563aea9527f22

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

@@ -1 +1 @@
-d36ef71b4b4869d33efcc8332d5a8ba0e78539d934e0bf9879af9ff9a47a8f29
+ae7d117aa6790de1a9487a514d0cf8244edb3885b266cc06030c77f14feb86ff

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

@@ -1 +1 @@
-91d5852150f7da4be8a3758d64a7eb28bede7863ac6d34e56b81b1587b837c935a4e5af1e5476c0beb90ada1a154efc3028ae6e4f7878699d2942aba64293579
+d256253b0492f63eda88eebb21a54e0ee3d73ab7420ff1db8e766ef09f49d8c854e4054358a0ad0d539380faa918ac0334405977c1e73126f00f6e939e4cb9da

package/android/build.gradle

@@ -37,7 +37,6 @@ allprojects {
         mavenLocal()
         mavenCentral()
         google()
-        jcenter()
         maven {
             url "$projectDir/../../node_modules/react-native/android"
         }

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

@@ -32,7 +32,7 @@ declare global {
     }
 
     namespace Detox {
-        // region DetoxConfig
+        //#region DetoxConfig
 
         interface DetoxConfig extends DetoxConfigurationCommon {
             /**
@@ -88,9 +88,13 @@ declare global {
                  */
                 reinstallApp?: boolean;
                 /**
-                 * If you wish to run multiple "detox test" commands in parallel,
-                 * make sure they don't delete the shared lock file – only the
-                 * first command should reset the lock file.
+                 * When false, `detox test` command always deletes the shared lock file on start,
+                 * assuming it had been left from the previous, already finished test session.
+                 * The lock file contains information about busy and free devices and ensures
+                 * no device can be used simultaneously by multiple test workers.
+                 *
+                 * Setting it to **true** might be useful when if you need to run multiple
+                 * `detox test` commands in parallel, e.g. test a few configurations at once.
                  *
                  * @default false
                  */
@@ -102,13 +106,43 @@ declare global {
             };
         }
 
+        type _DetoxLoggerOptions = Omit<BunyanDebugStreamOptions, 'out'>;
+
         interface DetoxLoggerConfig {
+            /**
+             * Log level filters the messages printed to your terminal,
+             * and it does not affect the logs written to the artifacts.
+             *
+             * Use `info` by default.
+             * Use `error` or warn when you want to make the output as silent as possible.
+             * Use `debug` to control what generally is happening under the hood.
+             * Use `trace` when troubleshooting specific issues.
+             *
+             * @default 'info'
+             */
             level?: DetoxLogLevel;
             /**
-             * @default 'sandbox'
+             * When enabled, hijacks all the console methods (console.log, console.warn, etc)
+             * so that the messages printed via them are formatted and saved as Detox logs.
+             *
+             * @default true
              */
-            overrideConsole?: 'all' | 'sandbox' | 'none';
-            options?: BunyanDebugStreamOptions | ((config: Partial<DetoxLoggerConfig>) => BunyanDebugStreamOptions);
+            overrideConsole?: boolean;
+            /**
+             * Since Detox is using
+             * {@link https://www.npmjs.com/package/bunyan-debug-stream bunyan-debug-stream}
+             * for printing logs, all its options are exposed for sake of simplicity
+             * of customization.
+             *
+             * The only exception is {@link BunyanDebugStreamOptions#out} option,
+             * which is always set to `process.stdout`.
+             *
+             * You can also pass a callback function to override the logger config
+             * programmatically, e.g. depending on the selected log level.
+             *
+             * @see {@link BunyanDebugStreamOptions}
+             */
+            options?: _DetoxLoggerOptions | ((config: Partial<DetoxLoggerConfig>) => _DetoxLoggerOptions);
         }
 
         interface DetoxSessionConfig {
@@ -133,25 +167,78 @@ declare global {
                  */
                 [prop: string]: unknown;
             };
+
             /**
-             * Configuration of custom integration features
-             * between Detox and Jest
+             * This is an add-on section used by our Jest integration code (but not Detox core itself).
+             * In other words, if you’re implementing (or using) a custom integration with some other test runner, feel free to define a section for yourself (e.g. `testRunner.mocha`)
              */
             jest?: {
                 /**
                  * Environment setup timeout
+                 *
+                 * As a part of the environment setup, Detox boots the device and installs the apps.
+                 * If that takes longer than the specified value, the entire test suite will be considered as failed, e.g.:
+                 * ```plain text
+                 * FAIL  e2e/starter.test.js
+                 * ● Test suite failed to run
+                 *
+                 * Exceeded timeout of 300000ms while setting up Detox environment
+                 * ```
+                 *
+                 * The default value is 5 minutes.
+                 *
+                 * @default 300000
+                 * @see {@link https://jestjs.io/docs/configuration/#testenvironment-string}
                  */
                 setupTimeout?: number | undefined;
                 /**
-                 * Environment teardown timeout
+                 * Environemnt teardown timeout
+                 *
+                 * If the environment teardown takes longer than the specified value, Detox will throw a timeout error.
+                 * The default value is half a minute.
+                 *
+                 * @default 30000 (30 seconds)
+                 * @see {@link https://jestjs.io/docs/configuration/#testenvironment-string}
                  */
                 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.
+                 * Jest provides an API to re-run individual failed tests: `jest.retryTimes(count)`.
+                 * When Detox detects the use of this API, it suppresses its own CLI retry mechanism controlled via `detox test … --retries <N>` or {@link DetoxTestRunnerConfig#retries}.
+                 * The motivation is simple – activating the both mechanisms is apt to increase your test duration dramatically, if your tests are flaky.
+                 * If you wish nevertheless to use both the mechanisms simultaneously, set it to `true`.
+                 *
+                 * @default false
+                 * @see {@link https://jestjs.io/docs/29.0/jest-object#jestretrytimesnumretries-options}
                  */
                 retryAfterCircusRetries?: boolean;
+                /**
+                 * By default, Jest prints the test names and their status (_passed_ or _failed_) at the very end of the test session.
+                 * When enabled, it makes Detox to print messages like these each time the new test starts and ends:
+                 * ```plain text
+                 * 18:03:36.258 detox[40125] i Sanity: should have welcome screen
+                 * 18:03:37.495 detox[40125] i Sanity: should have welcome screen [OK]
+                 * 18:03:37.496 detox[40125] i Sanity: should show hello screen after tap
+                 * 18:03:38.928 detox[40125] i Sanity: should show hello screen after tap [OK]
+                 * 18:03:38.929 detox[40125] i Sanity: should show world screen after tap
+                 * 18:03:40.351 detox[40125] i Sanity: should show world screen after tap [OK]
+                 * ```
+                 * By default, it is enabled automatically in test sessions with a single worker.
+                 * And vice versa, if multiple tests are executed concurrently, Detox turns it off to avoid confusion in the log.
+                 * Use boolean values, `true` or `false`, to turn off the automatic choice.
+                 *
+                 * @default undefined
+                 */
                 reportSpecs?: boolean | undefined;
+                /**
+                 * In the environment setup phase, Detox boots the device and installs the apps.
+                 * This flag tells Detox to print messages like these every time the device gets assigned to a specific suite:
+                 *
+                 * ```plain text
+                 * 18:03:29.869 detox[40125] i starter.test.js is assigned to 4EC84833-C7EA-4CA3-A6E9-5C30A29EA596 (iPhone 12 Pro Max)
+                 * ```
+                 *
+                 * @default true
+                 */
                 reportWorkerAssign?: boolean | undefined;
             };
             /**
@@ -170,9 +257,9 @@ declare global {
             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.
@@ -342,7 +429,7 @@ declare global {
 
         type DetoxAliasedApp = string | DetoxAppConfig;
 
-        // endregion DetoxConfig
+        //#endregion
 
         interface DetoxExportWrapper {
             readonly device: Device;

package/internals.d.ts

@@ -6,7 +6,7 @@ declare global {
     type DetoxStatus = 'inactive' | 'init' | 'active' | 'cleanup';
 
     type Facade = {
-      // region Initialization
+      //#region Initialization
       /**
        * Use with a caution, when you still have no config, yet need to avoid {@link Facade#init}
        */
@@ -37,21 +37,74 @@ declare global {
        * This is the phase where the Detox server shuts down.
        */
       cleanup(): Promise<void>;
-      // 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>;
+      //#endregion
+
+      //#region Lifecycle
+      /**
+       * 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.
@@ -61,7 +114,7 @@ declare global {
        * @param testResults - reports about test files
        */
       reportTestResults(testResults: DetoxTestFileReport[]): Promise<void>;
-      // endregion
+      //#endregion
 
       readonly config: RuntimeConfig;
       readonly log: Detox.Logger;
@@ -78,6 +131,10 @@ declare global {
         createEventStream(): NodeJS.ReadableStream;
       };
 
+      /**
+       * Not documented on purpose.
+       * Provides direct access to the object which holds the device driver, websocket client, matchers, expectations, etc.
+       */
       readonly worker: Worker;
     }
 
@@ -87,6 +144,9 @@ declare global {
 
     type DetoxInitOptions = {
       cwd: string;
+      /**
+       * @internal
+       */
       argv: Record<string, unknown>;
       testRunnerArgv: Record<string, unknown>;
       override: Partial<Detox.DetoxConfig>;

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 {