appium 2.0.0-beta.3 → 2.0.0-beta.30

package/build/lib/cli/driver-command.js

@@ -13,9 +13,9 @@ var _lodash = _interopRequireDefault(require("lodash"));
 
 var _extensionCommand = _interopRequireDefault(require("./extension-command"));
 
-var _extensionConfig = require("../extension-config");
+var _constants = require("../constants");
 
-var _drivers = require("../drivers");
+require("@colors/colors");
 
 const REQ_DRIVER_FIELDS = ['driverName', 'automationName', 'platformNames', 'mainClass'];
 
@@ -26,10 +26,9 @@ class DriverCommand extends _extensionCommand.default {
   }) {
     super({
       config,
-      json,
-      type: _extensionConfig.DRIVER_TYPE
+      json
     });
-    this.knownExtensions = _drivers.KNOWN_DRIVERS;
+    this.knownExtensions = _constants.KNOWN_DRIVERS;
   }
 
   async install({
@@ -37,7 +36,7 @@ class DriverCommand extends _extensionCommand.default {
     installType,
     packageName
   }) {
-    return await super.install({
+    return await super._install({
       ext: driver,
       installType,
       packageName
@@ -47,7 +46,7 @@ class DriverCommand extends _extensionCommand.default {
   async uninstall({
     driver
   }) {
-    return await super.uninstall({
+    return await super._uninstall({
       ext: driver
     });
   }
@@ -56,12 +55,22 @@ class DriverCommand extends _extensionCommand.default {
     driver,
     unsafe
   }) {
-    return await super.update({
+    return await super._update({
       ext: driver,
       unsafe
     });
   }
 
+  async run({
+    driver,
+    scriptName
+  }) {
+    return await super._run({
+      ext: driver,
+      scriptName
+    });
+  }
+
   getPostInstallText({
     extName,
     extData
@@ -79,7 +88,5 @@ class DriverCommand extends _extensionCommand.default {
 
 }
 
-exports.default = DriverCommand;require('source-map-support').install();
-
-
-//# sourceMappingURL=data:application/json;charset=utf8;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbImxpYi9jbGkvZHJpdmVyLWNvbW1hbmQuanMiXSwibmFtZXMiOlsiUkVRX0RSSVZFUl9GSUVMRFMiLCJEcml2ZXJDb21tYW5kIiwiRXh0ZW5zaW9uQ29tbWFuZCIsImNvbnN0cnVjdG9yIiwiY29uZmlnIiwianNvbiIsInR5cGUiLCJEUklWRVJfVFlQRSIsImtub3duRXh0ZW5zaW9ucyIsIktOT1dOX0RSSVZFUlMiLCJpbnN0YWxsIiwiZHJpdmVyIiwiaW5zdGFsbFR5cGUiLCJwYWNrYWdlTmFtZSIsImV4dCIsInVuaW5zdGFsbCIsInVwZGF0ZSIsInVuc2FmZSIsImdldFBvc3RJbnN0YWxsVGV4dCIsImV4dE5hbWUiLCJleHREYXRhIiwidmVyc2lvbiIsImdyZWVuIiwiYXV0b21hdGlvbk5hbWUiLCJKU09OIiwic3RyaW5naWZ5IiwicGxhdGZvcm1OYW1lcyIsInZhbGlkYXRlRXh0ZW5zaW9uRmllbGRzIiwiYXBwaXVtUGtnRGF0YSIsIm1pc3NpbmdGaWVsZHMiLCJyZWR1Y2UiLCJhY2MiLCJmaWVsZCIsIl8iLCJpc0VtcHR5IiwiRXJyb3IiXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7O0FBQUE7O0FBQ0E7O0FBQ0E7O0FBQ0E7O0FBRUEsTUFBTUEsaUJBQWlCLEdBQUcsQ0FBQyxZQUFELEVBQWUsZ0JBQWYsRUFBaUMsZUFBakMsRUFBa0QsV0FBbEQsQ0FBMUI7O0FBRWUsTUFBTUMsYUFBTixTQUE0QkMseUJBQTVCLENBQTZDO0FBRTFEQyxFQUFBQSxXQUFXLENBQUU7QUFBQ0MsSUFBQUEsTUFBRDtBQUFTQyxJQUFBQTtBQUFULEdBQUYsRUFBa0I7QUFDM0IsVUFBTTtBQUFDRCxNQUFBQSxNQUFEO0FBQVNDLE1BQUFBLElBQVQ7QUFBZUMsTUFBQUEsSUFBSSxFQUFFQztBQUFyQixLQUFOO0FBQ0EsU0FBS0MsZUFBTCxHQUF1QkMsc0JBQXZCO0FBQ0Q7O0FBRUQsUUFBTUMsT0FBTixDQUFlO0FBQUNDLElBQUFBLE1BQUQ7QUFBU0MsSUFBQUEsV0FBVDtBQUFzQkMsSUFBQUE7QUFBdEIsR0FBZixFQUFtRDtBQUNqRCxXQUFPLE1BQU0sTUFBTUgsT0FBTixDQUFjO0FBQUNJLE1BQUFBLEdBQUcsRUFBRUgsTUFBTjtBQUFjQyxNQUFBQSxXQUFkO0FBQTJCQyxNQUFBQTtBQUEzQixLQUFkLENBQWI7QUFDRDs7QUFFRCxRQUFNRSxTQUFOLENBQWlCO0FBQUNKLElBQUFBO0FBQUQsR0FBakIsRUFBMkI7QUFDekIsV0FBTyxNQUFNLE1BQU1JLFNBQU4sQ0FBZ0I7QUFBQ0QsTUFBQUEsR0FBRyxFQUFFSDtBQUFOLEtBQWhCLENBQWI7QUFDRDs7QUFFRCxRQUFNSyxNQUFOLENBQWM7QUFBQ0wsSUFBQUEsTUFBRDtBQUFTTSxJQUFBQTtBQUFULEdBQWQsRUFBZ0M7QUFDOUIsV0FBTyxNQUFNLE1BQU1ELE1BQU4sQ0FBYTtBQUFDRixNQUFBQSxHQUFHLEVBQUVILE1BQU47QUFBY00sTUFBQUE7QUFBZCxLQUFiLENBQWI7QUFDRDs7QUFFREMsRUFBQUEsa0JBQWtCLENBQUU7QUFBQ0MsSUFBQUEsT0FBRDtBQUFVQyxJQUFBQTtBQUFWLEdBQUYsRUFBc0I7QUFDdEMsV0FBUSxVQUFTRCxPQUFRLElBQUdDLE9BQU8sQ0FBQ0MsT0FBUSwyQkFBckMsQ0FBZ0VDLEtBQWhFLEdBQ0MscUJBQW9CRixPQUFPLENBQUNHLGNBQVIsQ0FBdUJELEtBQU0sSUFEbEQsR0FFQyxvQkFBbUJFLElBQUksQ0FBQ0MsU0FBTCxDQUFlTCxPQUFPLENBQUNNLGFBQXZCLEVBQXNDSixLQUFNLEVBRnZFO0FBR0Q7O0FBRURLLEVBQUFBLHVCQUF1QixDQUFFQyxhQUFGLEVBQWlCO0FBQ3RDLFVBQU1DLGFBQWEsR0FBRzdCLGlCQUFpQixDQUFDOEIsTUFBbEIsQ0FBeUIsQ0FBQ0MsR0FBRCxFQUFNQyxLQUFOLEtBQzdDSixhQUFhLENBQUNJLEtBQUQsQ0FBYixHQUF1QkQsR0FBdkIsR0FBNkIsQ0FBQyxHQUFHQSxHQUFKLEVBQVNDLEtBQVQsQ0FEVCxFQUVuQixFQUZtQixDQUF0Qjs7QUFJQSxRQUFJLENBQUNDLGdCQUFFQyxPQUFGLENBQVVMLGFBQVYsQ0FBTCxFQUErQjtBQUM3QixZQUFNLElBQUlNLEtBQUosQ0FBVyxpRUFBRCxHQUNDLGdDQUErQlgsSUFBSSxDQUFDQyxTQUFMLENBQWVJLGFBQWYsQ0FBOEIsRUFEeEUsQ0FBTjtBQUVEO0FBRUY7O0FBbkN5RCIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCBfIGZyb20gJ2xvZGFzaCc7XG5pbXBvcnQgRXh0ZW5zaW9uQ29tbWFuZCBmcm9tICcuL2V4dGVuc2lvbi1jb21tYW5kJztcbmltcG9ydCB7IERSSVZFUl9UWVBFIH0gZnJvbSAnLi4vZXh0ZW5zaW9uLWNvbmZpZyc7XG5pbXBvcnQgeyBLTk9XTl9EUklWRVJTIH0gZnJvbSAnLi4vZHJpdmVycyc7XG5cbmNvbnN0IFJFUV9EUklWRVJfRklFTERTID0gWydkcml2ZXJOYW1lJywgJ2F1dG9tYXRpb25OYW1lJywgJ3BsYXRmb3JtTmFtZXMnLCAnbWFpbkNsYXNzJ107XG5cbmV4cG9ydCBkZWZhdWx0IGNsYXNzIERyaXZlckNvbW1hbmQgZXh0ZW5kcyBFeHRlbnNpb25Db21tYW5kIHtcblxuICBjb25zdHJ1Y3RvciAoe2NvbmZpZywganNvbn0pIHtcbiAgICBzdXBlcih7Y29uZmlnLCBqc29uLCB0eXBlOiBEUklWRVJfVFlQRX0pO1xuICAgIHRoaXMua25vd25FeHRlbnNpb25zID0gS05PV05fRFJJVkVSUztcbiAgfVxuXG4gIGFzeW5jIGluc3RhbGwgKHtkcml2ZXIsIGluc3RhbGxUeXBlLCBwYWNrYWdlTmFtZX0pIHtcbiAgICByZXR1cm4gYXdhaXQgc3VwZXIuaW5zdGFsbCh7ZXh0OiBkcml2ZXIsIGluc3RhbGxUeXBlLCBwYWNrYWdlTmFtZX0pO1xuICB9XG5cbiAgYXN5bmMgdW5pbnN0YWxsICh7ZHJpdmVyfSkge1xuICAgIHJldHVybiBhd2FpdCBzdXBlci51bmluc3RhbGwoe2V4dDogZHJpdmVyfSk7XG4gIH1cblxuICBhc3luYyB1cGRhdGUgKHtkcml2ZXIsIHVuc2FmZX0pIHtcbiAgICByZXR1cm4gYXdhaXQgc3VwZXIudXBkYXRlKHtleHQ6IGRyaXZlciwgdW5zYWZlfSk7XG4gIH1cblxuICBnZXRQb3N0SW5zdGFsbFRleHQgKHtleHROYW1lLCBleHREYXRhfSkge1xuICAgIHJldHVybiBgRHJpdmVyICR7ZXh0TmFtZX1AJHtleHREYXRhLnZlcnNpb259IHN1Y2Nlc3NmdWxseSBpbnN0YWxsZWRcXG5gLmdyZWVuICtcbiAgICAgICAgICAgYC0gYXV0b21hdGlvbk5hbWU6ICR7ZXh0RGF0YS5hdXRvbWF0aW9uTmFtZS5ncmVlbn1cXG5gICtcbiAgICAgICAgICAgYC0gcGxhdGZvcm1OYW1lczogJHtKU09OLnN0cmluZ2lmeShleHREYXRhLnBsYXRmb3JtTmFtZXMpLmdyZWVufWA7XG4gIH1cblxuICB2YWxpZGF0ZUV4dGVuc2lvbkZpZWxkcyAoYXBwaXVtUGtnRGF0YSkge1xuICAgIGNvbnN0IG1pc3NpbmdGaWVsZHMgPSBSRVFfRFJJVkVSX0ZJRUxEUy5yZWR1Y2UoKGFjYywgZmllbGQpID0+IChcbiAgICAgIGFwcGl1bVBrZ0RhdGFbZmllbGRdID8gYWNjIDogWy4uLmFjYywgZmllbGRdXG4gICAgKSwgW10pO1xuXG4gICAgaWYgKCFfLmlzRW1wdHkobWlzc2luZ0ZpZWxkcykpIHtcbiAgICAgIHRocm93IG5ldyBFcnJvcihgSW5zdGFsbGVkIGRyaXZlciBkaWQgbm90IGV4cG9zZSBjb3JyZWN0IGZpZWxkcyBmb3IgY29tcGFiaWxpdHkgYCArXG4gICAgICAgICAgICAgICAgICAgICAgYHdpdGggQXBwaXVtLiBNaXNzaW5nIGZpZWxkczogJHtKU09OLnN0cmluZ2lmeShtaXNzaW5nRmllbGRzKX1gKTtcbiAgICB9XG5cbiAgfVxuXG59XG4iXSwiZmlsZSI6ImxpYi9jbGkvZHJpdmVyLWNvbW1hbmQuanMiLCJzb3VyY2VSb290IjoiLi4vLi4vLi4ifQ==
+exports.default = DriverCommand;
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uL2xpYi9jbGkvZHJpdmVyLWNvbW1hbmQuanMiXSwibmFtZXMiOlsiUkVRX0RSSVZFUl9GSUVMRFMiLCJEcml2ZXJDb21tYW5kIiwiRXh0ZW5zaW9uQ29tbWFuZCIsImNvbnN0cnVjdG9yIiwiY29uZmlnIiwianNvbiIsImtub3duRXh0ZW5zaW9ucyIsIktOT1dOX0RSSVZFUlMiLCJpbnN0YWxsIiwiZHJpdmVyIiwiaW5zdGFsbFR5cGUiLCJwYWNrYWdlTmFtZSIsIl9pbnN0YWxsIiwiZXh0IiwidW5pbnN0YWxsIiwiX3VuaW5zdGFsbCIsInVwZGF0ZSIsInVuc2FmZSIsIl91cGRhdGUiLCJydW4iLCJzY3JpcHROYW1lIiwiX3J1biIsImdldFBvc3RJbnN0YWxsVGV4dCIsImV4dE5hbWUiLCJleHREYXRhIiwidmVyc2lvbiIsImdyZWVuIiwiYXV0b21hdGlvbk5hbWUiLCJKU09OIiwic3RyaW5naWZ5IiwicGxhdGZvcm1OYW1lcyIsInZhbGlkYXRlRXh0ZW5zaW9uRmllbGRzIiwiYXBwaXVtUGtnRGF0YSIsIm1pc3NpbmdGaWVsZHMiLCJyZWR1Y2UiLCJhY2MiLCJmaWVsZCIsIl8iLCJpc0VtcHR5IiwiRXJyb3IiXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7O0FBQUE7O0FBQ0E7O0FBQ0E7O0FBQ0E7O0FBRUEsTUFBTUEsaUJBQWlCLEdBQUcsQ0FBQyxZQUFELEVBQWUsZ0JBQWYsRUFBaUMsZUFBakMsRUFBa0QsV0FBbEQsQ0FBMUI7O0FBSWUsTUFBTUMsYUFBTixTQUE0QkMseUJBQTVCLENBQTZDO0FBSzFEQyxFQUFBQSxXQUFXLENBQUU7QUFBQ0MsSUFBQUEsTUFBRDtBQUFTQyxJQUFBQTtBQUFULEdBQUYsRUFBa0I7QUFDM0IsVUFBTTtBQUFDRCxNQUFBQSxNQUFEO0FBQVNDLE1BQUFBO0FBQVQsS0FBTjtBQUNBLFNBQUtDLGVBQUwsR0FBdUJDLHdCQUF2QjtBQUNEOztBQUVZLFFBQVBDLE9BQU8sQ0FBRTtBQUFDQyxJQUFBQSxNQUFEO0FBQVNDLElBQUFBLFdBQVQ7QUFBc0JDLElBQUFBO0FBQXRCLEdBQUYsRUFBc0M7QUFDakQsV0FBTyxNQUFNLE1BQU1DLFFBQU4sQ0FBZTtBQUFDQyxNQUFBQSxHQUFHLEVBQUVKLE1BQU47QUFBY0MsTUFBQUEsV0FBZDtBQUEyQkMsTUFBQUE7QUFBM0IsS0FBZixDQUFiO0FBQ0Q7O0FBRWMsUUFBVEcsU0FBUyxDQUFFO0FBQUNMLElBQUFBO0FBQUQsR0FBRixFQUFZO0FBQ3pCLFdBQU8sTUFBTSxNQUFNTSxVQUFOLENBQWlCO0FBQUNGLE1BQUFBLEdBQUcsRUFBRUo7QUFBTixLQUFqQixDQUFiO0FBQ0Q7O0FBRVcsUUFBTk8sTUFBTSxDQUFFO0FBQUNQLElBQUFBLE1BQUQ7QUFBU1EsSUFBQUE7QUFBVCxHQUFGLEVBQW9CO0FBQzlCLFdBQU8sTUFBTSxNQUFNQyxPQUFOLENBQWM7QUFBQ0wsTUFBQUEsR0FBRyxFQUFFSixNQUFOO0FBQWNRLE1BQUFBO0FBQWQsS0FBZCxDQUFiO0FBQ0Q7O0FBRVEsUUFBSEUsR0FBRyxDQUFFO0FBQUNWLElBQUFBLE1BQUQ7QUFBU1csSUFBQUE7QUFBVCxHQUFGLEVBQXdCO0FBQy9CLFdBQU8sTUFBTSxNQUFNQyxJQUFOLENBQVc7QUFBQ1IsTUFBQUEsR0FBRyxFQUFFSixNQUFOO0FBQWNXLE1BQUFBO0FBQWQsS0FBWCxDQUFiO0FBQ0Q7O0FBRURFLEVBQUFBLGtCQUFrQixDQUFFO0FBQUNDLElBQUFBLE9BQUQ7QUFBVUMsSUFBQUE7QUFBVixHQUFGLEVBQXNCO0FBQ3RDLFdBQVEsVUFBU0QsT0FBUSxJQUFHQyxPQUFPLENBQUNDLE9BQVEsMkJBQXJDLENBQWdFQyxLQUFoRSxHQUNDLHFCQUFvQkYsT0FBTyxDQUFDRyxjQUFSLENBQXVCRCxLQUFNLElBRGxELEdBRUMsb0JBQW1CRSxJQUFJLENBQUNDLFNBQUwsQ0FBZUwsT0FBTyxDQUFDTSxhQUF2QixFQUFzQ0osS0FBTSxFQUZ2RTtBQUdEOztBQUVESyxFQUFBQSx1QkFBdUIsQ0FBRUMsYUFBRixFQUFpQjtBQUN0QyxVQUFNQyxhQUFhLEdBQUdqQyxpQkFBaUIsQ0FBQ2tDLE1BQWxCLENBQXlCLENBQUNDLEdBQUQsRUFBTUMsS0FBTixLQUM3Q0osYUFBYSxDQUFDSSxLQUFELENBQWIsR0FBdUJELEdBQXZCLEdBQTZCLENBQUMsR0FBR0EsR0FBSixFQUFTQyxLQUFULENBRFQsRUFFbkIsRUFGbUIsQ0FBdEI7O0FBSUEsUUFBSSxDQUFDQyxnQkFBRUMsT0FBRixDQUFVTCxhQUFWLENBQUwsRUFBK0I7QUFDN0IsWUFBTSxJQUFJTSxLQUFKLENBQVcsaUVBQUQsR0FDQyxnQ0FBK0JYLElBQUksQ0FBQ0MsU0FBTCxDQUFlSSxhQUFmLENBQThCLEVBRHhFLENBQU47QUFFRDtBQUVGOztBQTFDeUQiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgXyBmcm9tICdsb2Rhc2gnO1xuaW1wb3J0IEV4dGVuc2lvbkNvbW1hbmQgZnJvbSAnLi9leHRlbnNpb24tY29tbWFuZCc7XG5pbXBvcnQgeyBLTk9XTl9EUklWRVJTIH0gZnJvbSAnLi4vY29uc3RhbnRzJztcbmltcG9ydCAnQGNvbG9ycy9jb2xvcnMnO1xuXG5jb25zdCBSRVFfRFJJVkVSX0ZJRUxEUyA9IFsnZHJpdmVyTmFtZScsICdhdXRvbWF0aW9uTmFtZScsICdwbGF0Zm9ybU5hbWVzJywgJ21haW5DbGFzcyddO1xuLyoqXG4gKiBAZXh0ZW5kcyB7RXh0ZW5zaW9uQ29tbWFuZDxpbXBvcnQoJy4uL2V4dGVuc2lvbi9tYW5pZmVzdCcpLkRyaXZlclR5cGU+fVxuICovXG5leHBvcnQgZGVmYXVsdCBjbGFzcyBEcml2ZXJDb21tYW5kIGV4dGVuZHMgRXh0ZW5zaW9uQ29tbWFuZCB7XG5cbiAgLyoqXG4gICAqIEBwYXJhbSB7RHJpdmVyQ29tbWFuZE9wdGlvbnN9IG9wdHNcbiAgICovXG4gIGNvbnN0cnVjdG9yICh7Y29uZmlnLCBqc29ufSkge1xuICAgIHN1cGVyKHtjb25maWcsIGpzb259KTtcbiAgICB0aGlzLmtub3duRXh0ZW5zaW9ucyA9IEtOT1dOX0RSSVZFUlM7XG4gIH1cblxuICBhc3luYyBpbnN0YWxsICh7ZHJpdmVyLCBpbnN0YWxsVHlwZSwgcGFja2FnZU5hbWV9KSB7XG4gICAgcmV0dXJuIGF3YWl0IHN1cGVyLl9pbnN0YWxsKHtleHQ6IGRyaXZlciwgaW5zdGFsbFR5cGUsIHBhY2thZ2VOYW1lfSk7XG4gIH1cblxuICBhc3luYyB1bmluc3RhbGwgKHtkcml2ZXJ9KSB7XG4gICAgcmV0dXJuIGF3YWl0IHN1cGVyLl91bmluc3RhbGwoe2V4dDogZHJpdmVyfSk7XG4gIH1cblxuICBhc3luYyB1cGRhdGUgKHtkcml2ZXIsIHVuc2FmZX0pIHtcbiAgICByZXR1cm4gYXdhaXQgc3VwZXIuX3VwZGF0ZSh7ZXh0OiBkcml2ZXIsIHVuc2FmZX0pO1xuICB9XG5cbiAgYXN5bmMgcnVuICh7ZHJpdmVyLCBzY3JpcHROYW1lfSkge1xuICAgIHJldHVybiBhd2FpdCBzdXBlci5fcnVuKHtleHQ6IGRyaXZlciwgc2NyaXB0TmFtZX0pO1xuICB9XG5cbiAgZ2V0UG9zdEluc3RhbGxUZXh0ICh7ZXh0TmFtZSwgZXh0RGF0YX0pIHtcbiAgICByZXR1cm4gYERyaXZlciAke2V4dE5hbWV9QCR7ZXh0RGF0YS52ZXJzaW9ufSBzdWNjZXNzZnVsbHkgaW5zdGFsbGVkXFxuYC5ncmVlbiArXG4gICAgICAgICAgIGAtIGF1dG9tYXRpb25OYW1lOiAke2V4dERhdGEuYXV0b21hdGlvbk5hbWUuZ3JlZW59XFxuYCArXG4gICAgICAgICAgIGAtIHBsYXRmb3JtTmFtZXM6ICR7SlNPTi5zdHJpbmdpZnkoZXh0RGF0YS5wbGF0Zm9ybU5hbWVzKS5ncmVlbn1gO1xuICB9XG5cbiAgdmFsaWRhdGVFeHRlbnNpb25GaWVsZHMgKGFwcGl1bVBrZ0RhdGEpIHtcbiAgICBjb25zdCBtaXNzaW5nRmllbGRzID0gUkVRX0RSSVZFUl9GSUVMRFMucmVkdWNlKChhY2MsIGZpZWxkKSA9PiAoXG4gICAgICBhcHBpdW1Qa2dEYXRhW2ZpZWxkXSA/IGFjYyA6IFsuLi5hY2MsIGZpZWxkXVxuICAgICksIFtdKTtcblxuICAgIGlmICghXy5pc0VtcHR5KG1pc3NpbmdGaWVsZHMpKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoYEluc3RhbGxlZCBkcml2ZXIgZGlkIG5vdCBleHBvc2UgY29ycmVjdCBmaWVsZHMgZm9yIGNvbXBhYmlsaXR5IGAgK1xuICAgICAgICAgICAgICAgICAgICAgIGB3aXRoIEFwcGl1bS4gTWlzc2luZyBmaWVsZHM6ICR7SlNPTi5zdHJpbmdpZnkobWlzc2luZ0ZpZWxkcyl9YCk7XG4gICAgfVxuXG4gIH1cblxufVxuXG4vKipcbiAqIEB0eXBlZGVmIERyaXZlckNvbW1hbmRPcHRpb25zXG4gKiBAcHJvcGVydHkge2ltcG9ydCgnLi4vZXh0ZW5zaW9uL2V4dGVuc2lvbi1jb25maWcnKS5FeHRlbnNpb25Db25maWc8aW1wb3J0KCcuLi9leHRlbnNpb24vbWFuaWZlc3QnKS5Ecml2ZXJUeXBlPn0gY29uZmlnXG4gKiBAcHJvcGVydHkge2Jvb2xlYW59IGpzb25cbiAqL1xuIl19

package/build/lib/cli/extension-command.d.ts

@@ -0,0 +1,345 @@
+export default ExtensionCommand;
+/**
+ * Options for the {@linkcode ExtensionCommand } constructor
+ */
+export type ExtensionCommandOptions<ExtType extends import("../../types").ExtensionType> = {
+    /**
+     * - the `DriverConfig` or `PluginConfig` instance used for this command
+     */
+    config: ExtensionConfig<ExtType>;
+    /**
+     * - whether the output of this command should be JSON or text
+     */
+    json: boolean;
+};
+/**
+ * Extra stuff about extensions; used indirectly by {@linkcode ExtensionCommand.list }.
+ */
+export type ExtensionMetadata = {
+    /**
+     * - If `true`, the extension is installed
+     */
+    installed: boolean;
+    /**
+     * - If the extension is installed, the version it can be updated to
+     */
+    updateVersion: string | null;
+    /**
+     * - Same as above, but a major version bump
+     */
+    unsafeUpdateVersion: string | null;
+    /**
+     * - If the extension is installed and the latest
+     */
+    upToDate: boolean;
+};
+export type ExtensionType = import('../../types').ExtensionType;
+export type DriverType = import('../../types').DriverType;
+export type PluginType = import('../../types').PluginType;
+export type ExtRecord<ExtType extends import("../../types").ExtensionType> = import('../../types/appium-manifest').ExtRecord<ExtType>;
+export type ExtensionConfig<ExtType extends import("../../types").ExtensionType> = import('../extension/extension-config').ExtensionConfig<ExtType>;
+export type ExtMetadata<ExtType extends import("../../types").ExtensionType> = import('../../types/external-manifest').ExtMetadata<ExtType>;
+export type ExtManifest<ExtType extends import("../../types").ExtensionType> = import('../../types/appium-manifest').ExtManifest<ExtType>;
+export type ExtPackageJson<ExtType extends import("../../types").ExtensionType> = import('../../types/external-manifest').ExtPackageJson<ExtType>;
+/**
+ * Possible return value for {@linkcode ExtensionCommand.list }
+ */
+export type UninstalledExtensionListData = {
+    pkgName: string;
+    installed: false;
+};
+/**
+ * Possible return value for {@linkcode ExtensionCommand.list }
+ */
+export type InstalledExtensionListData = import('../../types/appium-manifest').InternalMetadata & ExtensionMetadata;
+/**
+ * Return value of {@linkcode ExtensionCommand.list }.
+ */
+export type ExtensionListData = Record<string, InstalledExtensionListData | UninstalledExtensionListData>;
+/**
+ * Options for {@linkcode ExtensionCommand._run }.
+ */
+export type RunOptions = {
+    /**
+     * - name of the extension to run a script from
+     */
+    ext: string;
+    /**
+     * - name of the script to run
+     */
+    scriptName: string;
+};
+/**
+ * Return value of {@linkcode ExtensionCommand._run }
+ */
+export type RunOutput = {
+    /**
+     * - error message if script ran unsuccessfully, otherwise undefined
+     */
+    error?: string | undefined;
+    /**
+     * - script output
+     */
+    output: string[];
+};
+/**
+ * Options for {@linkcode ExtensionCommand._update }.
+ */
+export type ExtensionUpdateOpts = {
+    /**
+     * - the name of the extension to update
+     */
+    ext: string;
+    /**
+     * - if true, will perform unsafe updates past major revision boundaries
+     */
+    unsafe: boolean;
+};
+/**
+ * Return value of {@linkcode ExtensionCommand._update }.
+ */
+export type ExtensionUpdateResult = {
+    /**
+     * - map of ext names to error objects
+     */
+    errors: Record<string, Error>;
+    /**
+     * - map of ext names to {@linkcode UpdateReport }s
+     */
+    updates: Record<string, UpdateReport>;
+};
+/**
+ * Part of result of {@linkcode ExtensionCommand._update }.
+ */
+export type UpdateReport = {
+    /**
+     * - version the extension was updated from
+     */
+    from: string;
+    /**
+     * - version the extension was updated to
+     */
+    to: string;
+};
+/**
+ * Options for {@linkcode ExtensionCommand._uninstall }.
+ */
+export type UninstallOpts = {
+    /**
+     * - the name or spec of an extension to uninstall
+     */
+    ext: string;
+};
+/**
+ * Used by {@linkcode ExtensionCommand.getPostInstallText }
+ */
+export type ExtensionArgs = {
+    /**
+     * - the name of an extension
+     */
+    extName: string;
+    /**
+     * - the data for an installed extension
+     */
+    extData: object;
+};
+/**
+ * Options for {@linkcode ExtensionCommand.installViaNpm }
+ */
+export type InstallViaNpmArgs = {
+    /**
+     * - the name or spec of an extension to install
+     */
+    ext: string;
+    /**
+     * - the NPM package name of the extension
+     */
+    pkgName: string;
+    /**
+     * - the specific version of the NPM package
+     */
+    pkgVer?: string | undefined;
+};
+/**
+ * Object returned by {@linkcode ExtensionCommand.checkForExtensionUpdate }
+ */
+export type PossibleUpdates = {
+    /**
+     * - current version
+     */
+    current: string;
+    /**
+     * - version we can safely update to if it exists, or null
+     */
+    safeUpdate: string | null;
+    /**
+     * - version we can unsafely update to if it exists, or null
+     */
+    unsafeUpdate: string | null;
+};
+/**
+ * Options for {@linkcode ExtensionCommand._install }
+ */
+export type InstallArgs = {
+    /**
+     * - the name or spec of an extension to install
+     */
+    ext: string;
+    /**
+     * - how to install this extension. One of the INSTALL_TYPES
+     */
+    installType: import('../../types/appium-manifest').InstallType;
+    /**
+     * - for git/github installs, the extension node package name
+     */
+    packageName?: string | undefined;
+};
+/**
+ * Returned by {@linkcode ExtensionCommand.getExtensionFields }
+ */
+export type ExtensionFields<ExtType extends import("../../types").ExtensionType> = ExtMetadata<ExtType> & {
+    pkgName: string;
+    version: string;
+} & import('../../types/external-manifest').CommonMetadata;
+export type KnownExtensions<ExtType extends import("../../types").ExtensionType> = ExtType extends DriverType ? typeof import('../constants').KNOWN_DRIVERS : ExtType extends PluginType ? typeof import('../constants').KNOWN_PLUGINS : never;
+/**
+ * @template {ExtensionType} ExtType
+ */
+export class ExtensionCommand<ExtType extends import("../../types").ExtensionType> {
+    /**
+     * Build an ExtensionCommand
+     * @param {ExtensionCommandOptions<ExtType>} opts
+     */
+    constructor({ config, json }: ExtensionCommandOptions<ExtType>);
+    /**
+     * This is the `DriverConfig` or `PluginConfig`, depending on `ExtType`.
+     * @type {ExtensionConfig<ExtType>}
+     */
+    config: ExtensionConfig<ExtType>;
+    /**
+     * {@linkcode Record} of official plugins or drivers.
+     * @type {KnownExtensions<ExtType>}
+     */
+    knownExtensions: KnownExtensions<ExtType>;
+    /**
+     * If `true`, command output has been requested as JSON.
+     * @type {boolean}
+     */
+    isJsonOutput: boolean;
+    /**
+     * `driver` or `plugin`, depending on the `ExtensionConfig`.
+     */
+    get type(): ExtType;
+    /**
+     * Take a CLI parse and run an extension command based on its type
+     *
+     * @param {object} args - a key/value object with CLI flags and values
+     * @return {Promise<object>} the result of the specific command which is executed
+     */
+    execute(args: object): Promise<object>;
+    /**
+     * @typedef ListOptions
+     * @property {boolean} showInstalled - whether should show only installed extensions
+     * @property {boolean} showUpdates - whether should show available updates
+     */
+    /**
+     * List extensions
+     *
+     * @param {ListOptions} opts
+     * @return {Promise<ExtensionListData>} map of extension names to extension data
+     */
+    list({ showInstalled, showUpdates }: {
+        /**
+         * - whether should show only installed extensions
+         */
+        showInstalled: boolean;
+        /**
+         * - whether should show available updates
+         */
+        showUpdates: boolean;
+    }): Promise<ExtensionListData>;
+    /**
+     * Install an extension
+     *
+     * @param {InstallArgs} args
+     * @return {Promise<ExtRecord<ExtType>>} map of all installed extension names to extension data
+     */
+    _install({ ext, installType, packageName }: InstallArgs): Promise<ExtRecord<ExtType>>;
+    /**
+     * Install an extension via NPM
+     *
+     * @param {InstallViaNpmArgs} args
+     */
+    installViaNpm({ ext, pkgName, pkgVer }: InstallViaNpmArgs): Promise<ExtensionFields<ExtType>>;
+    /**
+     * Get the text which should be displayed to the user after an extension has been installed. This
+     * is designed to be overridden by drivers/plugins with their own particular text.
+     *
+     * @param {ExtensionArgs} args
+     * @returns {string}
+     */
+    getPostInstallText(args: ExtensionArgs): string;
+    /**
+     * Take an NPM module's package.json and extract Appium driver information from a special
+     * 'appium' field in the JSON data. We need this information to e.g. determine which class to
+     * load as the main driver class, or to be able to detect incompatibilities between driver and
+     * appium versions.
+     *
+     * @param {ExtPackageJson<ExtType>} pkgJsonData - the package.json data for a driver module, as if it had been
+     * straightforwardly 'require'd
+     * @returns {ExtensionFields<ExtType>}
+     */
+    getExtensionFields(pkgJsonData: ExtPackageJson<ExtType>): ExtensionFields<ExtType>;
+    /**
+     * For any package.json fields which a particular type of extension requires, validate the
+     * presence and form of those fields on the package.json data, throwing an error if anything is
+     * amiss.
+     *
+     * @param {ExtMetadata<ExtType>} appiumPkgData - the data in the "appium" field of package.json for an extension
+     */
+    validateExtensionFields(appiumPkgData: ExtMetadata<ExtType>): void;
+    /**
+     * Uninstall an extension
+     *
+     * @param {UninstallOpts} opts
+     * @return {Promise<ExtRecord<ExtType>>} map of all installed extension names to extension data
+     */
+    _uninstall({ ext }: UninstallOpts): Promise<ExtRecord<ExtType>>;
+    /**
+     * Attempt to update one or more drivers using NPM
+     *
+     * @param {ExtensionUpdateOpts} updateSpec
+     * @return {Promise<ExtensionUpdateResult>}
+     */
+    _update({ ext, unsafe }: ExtensionUpdateOpts): Promise<ExtensionUpdateResult>;
+    /**
+     * Given an extension name, figure out what its highest possible version upgrade is, and also the
+     * highest possible safe upgrade.
+     *
+     * @param {string} ext - name of extension
+     * @return {Promise<PossibleUpdates>}
+     */
+    checkForExtensionUpdate(ext: string): Promise<PossibleUpdates>;
+    /**
+     * Actually update an extension installed by NPM, using the NPM cli. And update the installation
+     * manifest.
+     *
+     * @param {string} ext - name of extension to update
+     * @param {string} version - version string identifier to update extension to
+     * @returns {Promise<void>}
+     */
+    updateExtension(ext: string, version: string): Promise<void>;
+    /**
+     * Runs a script cached inside the "scripts" field under "appium"
+     * inside of the driver/plugins "package.json" file. Will throw
+     * an error if the driver/plugin does not contain a "scripts" field
+     * underneath the "appium" field in its package.json, if the
+     * "scripts" field is not a plain object, or if the scriptName is
+     * not found within "scripts" object.
+     *
+     * @param {RunOptions} opts
+     * @return {Promise<RunOutput>}
+     */
+    _run({ ext, scriptName }: RunOptions): Promise<RunOutput>;
+}
+//# sourceMappingURL=extension-command.d.ts.map

package/build/lib/cli/extension-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-command.d.ts","sourceRoot":"","sources":["../../../lib/cli/extension-command.js"],"names":[],"mappings":"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"}