detox 20.15.0 → 20.16.0

package/Detox-android/com/wix/detox/20.16.0/detox-20.16.0-javadoc.jar.md5

@@ -0,0 +1 @@
+56f5ec5b7efbb230f3238c004a5fe715

package/Detox-android/com/wix/detox/20.16.0/detox-20.16.0-javadoc.jar.sha1

@@ -0,0 +1 @@
+64494abc41fe95ddfa2592069865471684bee013

package/Detox-android/com/wix/detox/20.16.0/detox-20.16.0-javadoc.jar.sha256

@@ -0,0 +1 @@
+a59fe4333df991b4188fe010b85fd8cd739ea7244d8feb096ed77b42ec178d63

package/Detox-android/com/wix/detox/20.16.0/detox-20.16.0-javadoc.jar.sha512

@@ -0,0 +1 @@
+623c51f747c437bd88a7421ac94e30d1c4d9c11f7aca8066746213c80e79eb7aba7a1d067dbf1033ae710deb021fdaf503304f387e43ae6333c763786a64bf9f

package/Detox-android/com/wix/detox/20.16.0/detox-20.16.0-sources.jar.md5

@@ -0,0 +1 @@
+65e9a1e222c5bd2d0d8f1adbb87e81dc

package/Detox-android/com/wix/detox/20.16.0/detox-20.16.0-sources.jar.sha1

@@ -0,0 +1 @@
+a619619716feca26448febd692de8dac38314100

package/Detox-android/com/wix/detox/20.16.0/detox-20.16.0-sources.jar.sha256

@@ -0,0 +1 @@
+5aa3a4be5939728a238f7ed475ee6e6d55d0eef81d1f84fc842029a7ba597c58

package/Detox-android/com/wix/detox/20.16.0/detox-20.16.0-sources.jar.sha512

@@ -0,0 +1 @@
+61cf8afa304f860372a728279633e767070bddea071a2de58ff6b23fac2ef61e472ba4191704a8175cbd8cf1b10c526fae02db7205b8dcc5696d8f76e9441ab2

package/Detox-android/com/wix/detox/{20.15.0/detox-20.15.0.pom → 20.16.0/detox-20.16.0.pom}

@@ -3,7 +3,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.wix</groupId>
   <artifactId>detox</artifactId>
-  <version>20.15.0</version>
+  <version>20.16.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.16.0/detox-20.16.0.pom.md5

@@ -0,0 +1 @@
+6e8623d17be32c1363d08aa89e5fd3b2

package/Detox-android/com/wix/detox/20.16.0/detox-20.16.0.pom.sha1

@@ -0,0 +1 @@
+2b12affbd8b37c465ddc003dd59c224c83eb31fa

package/Detox-android/com/wix/detox/20.16.0/detox-20.16.0.pom.sha256

@@ -0,0 +1 @@
+1c812b8cb14e877335790a3dbf0ffd4db6e85c311e56050aa14853f1c78a7c90

package/Detox-android/com/wix/detox/20.16.0/detox-20.16.0.pom.sha512

@@ -0,0 +1 @@
+27641bf294e773373fa00156c73180d0260f0ee0611d5bb3f3e40001560a0a1537eed5807196397be5742d513974f7281bb682b0c09d2865888863080b305a05

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

@@ -3,11 +3,11 @@
   <groupId>com.wix</groupId>
   <artifactId>detox</artifactId>
   <versioning>
-    <latest>20.15.0</latest>
-    <release>20.15.0</release>
+    <latest>20.16.0</latest>
+    <release>20.16.0</release>
     <versions>
-      <version>20.15.0</version>
+      <version>20.16.0</version>
     </versions>
-    <lastUpdated>20240111111712</lastUpdated>
+    <lastUpdated>20240114094649</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-9e22bc0ea12d6e5775b68bde874bdf22
+3a7cd4da4ea3dd3e5cf31ee3a0c6ad4b

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

@@ -1 +1 @@
-add0ba9ace5604f9bad42acfe204f32728323ce4
+d32146f04f20a32ac69562f7fec718954e1f925d

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

@@ -1 +1 @@
-8d6d198043d40230347ae63f85625557fd6b2f45494d80c14e19e7e8e2f19fd2
+9440532f25a30a2d2c025159b566348219724e16f627e1c2cf80e384c9b40141

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

@@ -1 +1 @@
-7411bfbd2cbeb1e65e91618e520b083f54253f8b5e8f17f8b187de2716d3bf809c45246eb2bca80a9011f439f65f08053442daa846c4833bcb28f378a42e18b6
+ff53b142b83374497a6450075bf40da6df3996a77522efb5555d59b61b17e39c59b3891250a9c53789845add208bd28cfdbc975cd9e6a262ff47dead71e1dd74

package/detox.d.ts

@@ -644,10 +644,11 @@ declare global {
              */
             selectApp(app: string): Promise<void>;
 
+            // TODO: document permissions types.
             /**
              * Launch the app.
              *
-             * <p>For info regarding launch arguments, refer to the [dedicated guide](https://wix.github.io/Detox/docs/api/launch-args).
+             * <p>For info regarding launch arguments, refer to the [dedicated guide](https://wix.github.io/Detox/docs/guide/launch-args).
              *
              * @example
              * // Terminate the app and launch it again. If set to false, the simulator will try to bring app from background,
@@ -1624,23 +1625,25 @@ declare global {
             userTracking?: UserTrackingPermission;
         }
 
+        type BasicPermissionState = 'YES' | 'NO' | 'unset';
+        type ExtendedPermissionState = 'YES' | 'NO' | 'unset' | 'limited';
         type LocationPermission = 'always' | 'inuse' | 'never' | 'unset';
-        type PermissionState = 'YES' | 'NO' | 'unset';
-        type CameraPermission = PermissionState;
-        type ContactsPermission = PermissionState;
-        type CalendarPermission = PermissionState;
-        type HealthPermission = PermissionState;
-        type HomekitPermission = PermissionState;
-        type MediaLibraryPermission = PermissionState;
-        type MicrophonePermission = PermissionState;
-        type MotionPermission = PermissionState;
-        type PhotosPermission = PermissionState;
-        type RemindersPermission = PermissionState;
-        type SiriPermission = PermissionState;
-        type SpeechPermission = PermissionState;
-        type NotificationsPermission = PermissionState;
-        type FaceIDPermission = PermissionState;
-        type UserTrackingPermission = PermissionState;
+
+        type CameraPermission = BasicPermissionState;
+        type ContactsPermission = ExtendedPermissionState;
+        type CalendarPermission = BasicPermissionState;
+        type HealthPermission = BasicPermissionState;
+        type HomekitPermission = BasicPermissionState;
+        type MediaLibraryPermission = BasicPermissionState;
+        type MicrophonePermission = BasicPermissionState;
+        type MotionPermission = BasicPermissionState;
+        type PhotosPermission = ExtendedPermissionState;
+        type RemindersPermission = BasicPermissionState;
+        type SiriPermission = BasicPermissionState;
+        type SpeechPermission = BasicPermissionState;
+        type NotificationsPermission = BasicPermissionState;
+        type FaceIDPermission = BasicPermissionState;
+        type UserTrackingPermission = BasicPermissionState;
 
         interface DeviceLaunchAppConfig {
             /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "detox",
   "description": "E2E tests and automation for mobile",
-  "version": "20.15.0",
+  "version": "20.16.0",
   "bin": {
     "detox": "local-cli/cli.js"
   },
@@ -109,5 +109,5 @@
   "browserslist": [
     "node 14"
   ],
-  "gitHead": "bed7b965b2180bd3c628e242b9f78a80660c371f"
+  "gitHead": "3d7cb5de27cf768dca7216e60806819672553f4a"
 }

package/src/devices/common/drivers/ios/tools/AppleSimUtils.js

@@ -10,21 +10,123 @@ const environment = require('../../../../../utils/environment');
 const log = require('../../../../../utils/logger').child({ cat: 'device' });
 const { quote } = require('../../../../../utils/shellQuote');
 
+const PERMISSIONS_VALUES = {
+  YES: 'YES',
+  NO: 'NO',
+  UNSET: 'unset',
+  LIMITED: 'limited',
+};
+
+const SIMCTL_SET_PERMISSION_ACTIONS ={
+  GRANT: 'grant',
+  REVOKE: 'revoke',
+  RESET: 'reset',
+};
+
 class AppleSimUtils {
   async setPermissions(udid, bundleId, permissionsObj) {
-    let permissions = [];
-    _.forEach(permissionsObj, function (shouldAllow, permission) {
-      permissions.push(permission + '=' + shouldAllow);
-    });
+    for (const [service, value] of Object.entries(permissionsObj)) {
+      switch (service) {
+        case 'location':
+          switch (value) {
+            case 'always':
+              await this.setPermissionWithSimctl(udid, bundleId, SIMCTL_SET_PERMISSION_ACTIONS.GRANT, 'location-always');
+              break;
+
+            case 'inuse':
+              await this.setPermissionWithSimctl(udid, bundleId, SIMCTL_SET_PERMISSION_ACTIONS.GRANT, 'location');
+              break;
+
+            case 'never':
+              await this.setPermissionWithSimctl(udid, bundleId, SIMCTL_SET_PERMISSION_ACTIONS.REVOKE, 'location');
+              break;
+
+            case 'unset':
+              await this.setPermissionWithSimctl(udid, bundleId, SIMCTL_SET_PERMISSION_ACTIONS.RESET, 'location');
+              break;
+          }
+
+          break;
+
+        case 'contacts':
+          if (value === PERMISSIONS_VALUES.LIMITED) {
+            await this.setPermissionWithSimctl(udid, bundleId, SIMCTL_SET_PERMISSION_ACTIONS.GRANT, 'contacts-limited');
+          } else {
+            await this.setPermissionWithAppleSimUtils(udid, bundleId, service, value);
+          }
+          break;
+
+        case 'photos':
+          if (value === PERMISSIONS_VALUES.LIMITED) {
+            await this.setPermissionWithSimctl(udid, bundleId, SIMCTL_SET_PERMISSION_ACTIONS.GRANT, 'photos-add');
+          } else {
+            await this.setPermissionWithAppleSimUtils(udid, bundleId, service, value);
+          }
+          break;
+
+        // eslint-disable-next-line no-fallthrough
+        case 'calendar':
+        case 'camera':
+        case 'medialibrary':
+        case 'microphone':
+        case 'motion':
+        case 'reminders':
+        case 'siri':
+          // Simctl uses kebab-case for service names.
+          const simctlService = service.replace('medialibrary', 'media-library');
+          await this.setPermissionWithSimctl(udid, bundleId, this.basicPermissionValueToSimctlAction(value), simctlService);
+          break;
+
+        // Requires AppleSimUtils: unsupported by latest Simctl at the moment of writing this code.
+        // eslint-disable-next-line no-fallthrough
+        case 'notifications':
+        case 'health':
+        case 'homekit':
+        case 'speech':
+        case 'faceid':
+        case 'userTracking':
+          await this.setPermissionWithAppleSimUtils(udid, bundleId, service, value);
+          break;
+      }
+    }
+  }
+
+  basicPermissionValueToSimctlAction(value) {
+    switch (value) {
+      case PERMISSIONS_VALUES.YES:
+        return SIMCTL_SET_PERMISSION_ACTIONS.GRANT;
+
+      case PERMISSIONS_VALUES.NO:
+        return SIMCTL_SET_PERMISSION_ACTIONS.REVOKE;
+
+      case PERMISSIONS_VALUES.UNSET:
+        return SIMCTL_SET_PERMISSION_ACTIONS.RESET;
+    }
+  }
 
+  async setPermissionWithSimctl(udid, bundleId, action, service) {
     const options = {
-      args: `--byId ${udid} --bundle ${bundleId} --restartSB --setPermissions ${_.join(permissions, ',')}`,
+      cmd: `privacy ${udid} ${action} ${service} ${bundleId}`,
       statusLogs: {
-        trying: `Trying to set permissions...`,
-        successful: 'Permissions are set'
+        trying: `Trying to set permissions with Simctl: ${action} ${service}...`,
+        successful: `${service} permissions are set`
       },
       retries: 1,
     };
+
+    await this._execSimctl(options);
+  }
+
+  async setPermissionWithAppleSimUtils(udid, bundleId, service, value) {
+    const options = {
+      args: `--byId ${udid} --bundle ${bundleId} --restartSB --setPermissions ${service}=${value}`,
+      statusLogs: {
+        trying: `Trying to set permissions with AppleSimUtils: ${service}=${value}...`,
+        successful: `${service} permissions are set`
+      },
+      retries: 1,
+    };
+
     await this._execAppleSimUtils(options);
   }
 
@@ -319,14 +421,7 @@ class AppleSimUtils {
   }
 
   async setLocation(udid, lat, lon) {
-    const result = await childProcess.execWithRetriesAndLogs(`which fbsimctl`, { retries: 1 });
-    if (_.get(result, 'stdout')) {
-      await childProcess.execWithRetriesAndLogs(`fbsimctl ${udid} set_location ${lat} ${lon}`, { retries: 1 });
-    } else {
-      throw new DetoxRuntimeError(`setLocation currently supported only through fbsimctl.
-      Install fbsimctl using:
-      "brew tap facebook/fb && export CODE_SIGNING_REQUIRED=NO && brew install fbsimctl"`);
-    }
+    await this._execSimctl({ cmd: `location ${udid} set ${lat},${lon}` });
   }
 
   async resetContentAndSettings(udid) {

package/Detox-android/com/wix/detox/20.15.0/detox-20.15.0-javadoc.jar.md5

@@ -1 +0,0 @@
-6af6a1128b61c579b4a5c82d2865f585

package/Detox-android/com/wix/detox/20.15.0/detox-20.15.0-javadoc.jar.sha1

@@ -1 +0,0 @@
-4dba1aa3f352698d234cccc7f69d8d3e69350458

package/Detox-android/com/wix/detox/20.15.0/detox-20.15.0-javadoc.jar.sha256

@@ -1 +0,0 @@
-0d73e6570afca6e11cefdb63125dd01bdd0f33143089402c752c506b5acf85a3

package/Detox-android/com/wix/detox/20.15.0/detox-20.15.0-javadoc.jar.sha512

@@ -1 +0,0 @@
-cda5ab07eac2a8371056647e4b6391a1c42e2d4a5b1a6a7a810a398ed4f29946441ea9da132a236cee7e523b09b6b6ea8f1510e5faaec0061193c84767e1d849

package/Detox-android/com/wix/detox/20.15.0/detox-20.15.0-sources.jar.md5

@@ -1 +0,0 @@
-b912691ddb7318d42de9431f7435bc9a

package/Detox-android/com/wix/detox/20.15.0/detox-20.15.0-sources.jar.sha1

@@ -1 +0,0 @@
-5c90afac3b3a7d5fa2ba83e650604f6f9bc00682

package/Detox-android/com/wix/detox/20.15.0/detox-20.15.0-sources.jar.sha256

@@ -1 +0,0 @@
-5eabd613ae0284bc97755f7e29cf0d233e281ae7635afeeb0875437401c3ddb8

package/Detox-android/com/wix/detox/20.15.0/detox-20.15.0-sources.jar.sha512

@@ -1 +0,0 @@
-5ef628faf38474b46638efc54f932b15824f5735497279f0153fe9c6afc2f7de9a151ee46e51724ce93ff22515bf43b86147f8330c67a49b34dd45ce3b129c5d

package/Detox-android/com/wix/detox/20.15.0/detox-20.15.0.pom.md5

@@ -1 +0,0 @@
-b214c6ec949dbb966c2ab104243efbb5

package/Detox-android/com/wix/detox/20.15.0/detox-20.15.0.pom.sha1

@@ -1 +0,0 @@
-91c5ac02c59420f8a6eaca4af5fa5a5d40901b92

package/Detox-android/com/wix/detox/20.15.0/detox-20.15.0.pom.sha256

@@ -1 +0,0 @@
-8e39181294f58719e0d42ea4b6220526012c229b47ab6db988acd904a8bba64c

package/Detox-android/com/wix/detox/20.15.0/detox-20.15.0.pom.sha512

@@ -1 +0,0 @@
-c919a336c80ca89a3d41975a6b8574539f93234105f7762870afdd1540ef44763b00ecf7860b6cb22457ff9c714047f5c78f9a341c9ad923fc8beb25fd1d1331