appium-ios-device 2.0.0 → 2.3.0

package/lib/utilities.js

@@ -1,5 +1,5 @@
 import Usbmux, { getDefaultSocket } from './usbmux';
-import { upgradeToSSL } from './ssl-helper';
+import { upgradeToSSL, enableSSLHandshakeOnly } from './ssl-helper';
 import _ from 'lodash';
 import log from './logger';
 
@@ -73,6 +73,55 @@ async function getDeviceName (udid, socket = null) {
   }
 }
 
+/**
+ * Returns all available device values
+ * @param {string} udid Device UDID
+ * @param {?net.Socket} socket the socket of usbmuxd. It will default to /var/run/usbmuxd if it is not passed
+ * @returns {object} Returns available default device values via lockdown.
+ * e.g.
+ * {
+ *   "BasebandCertId"=>3840149528,
+ *   "BasebandKeyHashInformation"=>
+ *     {"AKeyStatus"=>2,
+ *     "SKeyHash"=>{
+ *       "type"=>"Buffer",
+ *       "data"=>[187, 239, ....]},
+ *     "SKeyStatus"=>0},
+ *   "BasebandSerialNumber"=>{"type"=>"Buffer", "data"=>[...]},
+ *   "BasebandVersion"=>"11.01.02",
+ *   "BoardId"=>2,
+ *   "BuildVersion"=>"19C56",
+ *   "CPUArchitecture"=>"arm64",
+ *   "ChipID"=>32768,
+ *   "DeviceClass"=>"iPhone",
+ *   "DeviceColor"=>"#c8caca",
+ *   "DeviceName"=>"kazu",
+ *   "DieID"=>1111111111111,
+ *   "HardwareModel"=>"N69uAP",
+ *   "HasSiDP"=>true,
+ *   "PartitionType"=>"GUID_partition_scheme",
+ *   "ProductName"=>"iPhone OS",
+ *   "ProductType"=>"iPhone8,4",
+ *   "ProductVersion"=>"15.2",
+ *   "ProductionSOC"=>true,
+ *   "ProtocolVersion"=>"2",
+ *   "SupportedDeviceFamilies"=>[1],
+ *   "TelephonyCapability"=>true,
+ *   "UniqueChipID"=>1111111111111,
+ *   "UniqueDeviceID"=>"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+ *   "WiFiAddress"=>"00:00:00:00:00:00"
+ * }
+ */
+async function getDeviceInfo (udid, socket = null) {
+  const usbmux = new Usbmux(socket || await getDefaultSocket());
+  try {
+    const lockdown = await usbmux.connectLockdown(udid);
+    return await lockdown.getValue();
+  } finally {
+    usbmux.close();
+  }
+}
+
 /**
  * @typedef {Object} DeviceTime
  *
@@ -134,9 +183,10 @@ async function startLockdownSession (udid, socket = null) {
  * @param {string} udid Device UDID
  * @param {number} port Port to connect
  * @param {?net.Socket} socket the socket of usbmuxd. It will default to /var/run/usbmuxd if it is not passed
+ * @param {boolean} handshakeOnly only handshake and return the initial socket
  * @returns {tls.TLSSocket|Object} The socket or the object returned in the callback if the callback function exists
  */
-async function connectPortSSL (udid, port, socket = null) {
+async function connectPortSSL (udid, port, socket = null, handshakeOnly = false) {
   const usbmux = new Usbmux(socket || await getDefaultSocket());
   try {
     const device = await usbmux.findDevice(udid);
@@ -148,7 +198,9 @@ async function connectPortSSL (udid, port, socket = null) {
       throw new Error(`Could not find a pair record for device '${udid}'. Please first pair with the device`);
     }
     const socket = await usbmux.connect(device.Properties.DeviceID, port, undefined);
-    return upgradeToSSL(socket, pairRecord.HostPrivateKey, pairRecord.HostCertificate);
+    return handshakeOnly ?
+      await enableSSLHandshakeOnly(socket, pairRecord.HostPrivateKey, pairRecord.HostCertificate) :
+      upgradeToSSL(socket, pairRecord.HostPrivateKey, pairRecord.HostCertificate);
   } catch (e) {
     usbmux.close();
     throw e;
@@ -179,5 +231,5 @@ async function connectPort (udid, port, socket = null) {
 
 export {
   getConnectedDevices, getOSVersion, getDeviceName, getDeviceTime,
-  startLockdownSession, connectPort, connectPortSSL,
+  startLockdownSession, connectPort, connectPortSSL, getDeviceInfo
 };

package/package.json

@@ -4,7 +4,7 @@
   "keywords": [
     "appium"
   ],
-  "version": "2.0.0",
+  "version": "2.3.0",
   "author": "appium",
   "license": "Apache-2.0",
   "repository": {
@@ -31,10 +31,14 @@
   "dependencies": {
     "@appium/support": "^2.55.3",
     "@babel/runtime": "^7.0.0",
+    "asyncbox": "^2.9.2",
     "bluebird": "^3.1.1",
+    "bplist-creator": "^0.x",
+    "bplist-parser": "^0.x",
     "lodash": "^4.17.15",
     "semver": "^7.0.0",
-    "source-map-support": "^0.x"
+    "source-map-support": "^0.x",
+    "uuid": "^8.3.2"
   },
   "scripts": {
     "build": "gulp transpile",
@@ -54,9 +58,11 @@
   "devDependencies": {
     "@appium/gulp-plugins": "^6.0.0",
     "@appium/eslint-config-appium": "^5.0.0",
+    "@semantic-release/git": "^10.0.1",
     "chai": "^4.1.2",
     "chai-as-promised": "^7.1.1",
     "gulp": "^4.0.0",
-    "pre-commit": "^1.1.3"
+    "pre-commit": "^1.1.3",
+    "semantic-release": "^19.0.2"
   }
 }