appium 2.0.0-beta.5 → 2.0.0-beta.52

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

@@ -1,404 +1,752 @@
 "use strict";
-
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-
-require("source-map-support/register");
-
-var _lodash = _interopRequireDefault(require("lodash"));
-
-var _npm = _interopRequireDefault(require("./npm"));
-
-var _path = _interopRequireDefault(require("path"));
-
-var _appiumSupport = require("appium-support");
-
-var _utils = require("./utils");
-
-var _extensionConfig = require("../extension-config");
-
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExtensionCommand = void 0;
+/* eslint-disable no-console */
+const bluebird_1 = __importDefault(require("bluebird"));
+const lodash_1 = __importDefault(require("lodash"));
+const path_1 = __importDefault(require("path"));
+const support_1 = require("@appium/support");
+const utils_1 = require("./utils");
+const teen_process_1 = require("teen_process");
+const extension_config_1 = require("../extension/extension-config");
+const package_changed_1 = require("../extension/package-changed");
 const UPDATE_ALL = 'installed';
-
-class NotUpdatableError extends Error {}
-
-class NoUpdatesAvailableError extends Error {}
-
+class NotUpdatableError extends Error {
+}
+class NoUpdatesAvailableError extends Error {
+}
+/**
+ * Omits `driverName`/`pluginName` props from the receipt to make a {@linkcode ExtManifest}
+ * @template {ExtensionType} ExtType
+ * @param {ExtInstallReceipt<ExtType>} receipt
+ * @returns {ExtManifest<ExtType>}
+ */
+function receiptToManifest(receipt) {
+    return /** @type {ExtManifest<ExtType>} */ (lodash_1.default.omit(receipt, 'driverName', 'pluginName'));
+}
+/**
+ * @template {ExtensionType} ExtType
+ */
 class ExtensionCommand {
-  constructor({
-    config,
-    json,
-    type
-  }) {
-    this.config = config;
-    this.type = type;
-    this.isJsonOutput = json;
-    this.npm = new _npm.default(this.config.appiumHome);
-    this.knownExtensions = {};
-  }
-
-  async execute(args) {
-    const cmd = args[`${this.type}Command`];
-
-    if (!_lodash.default.isFunction(ExtensionCommand.prototype[cmd])) {
-      throw new Error(`Cannot handle ${this.type} command ${cmd}`);
+    /**
+     * Build an ExtensionCommand
+     * @param {ExtensionCommandOptions<ExtType>} opts
+     */
+    constructor({ config, json }) {
+        this.config = config;
+        this.log = new support_1.console.CliConsole({ jsonMode: json });
+        this.isJsonOutput = Boolean(json);
     }
-
-    const executeCmd = this[cmd].bind(this);
-    return await executeCmd(args);
-  }
-
-  async list({
-    showInstalled,
-    showUpdates
-  }) {
-    const lsMsg = `Listing ${showInstalled ? 'installed' : 'available'} ${this.type}s`;
-    const installedNames = Object.keys(this.config.installedExtensions);
-    const knownNames = Object.keys(this.knownExtensions);
-    const exts = [...installedNames, ...knownNames].reduce((acc, name) => {
-      if (!acc[name]) {
-        if (installedNames.includes(name)) {
-          acc[name] = { ...this.config.installedExtensions[name],
-            installed: true
-          };
-        } else if (!showInstalled) {
-          acc[name] = {
-            pkgName: this.knownExtensions[name],
-            installed: false
-          };
-        }
-      }
-
-      return acc;
-    }, {});
-    await (0, _utils.spinWith)(this.isJsonOutput, lsMsg, async () => {
-      if (!showUpdates) {
-        return;
-      }
-
-      for (const [ext, data] of _lodash.default.toPairs(exts)) {
-        const {
-          installed,
-          installType
-        } = data;
-
-        if (!installed || installType !== _extensionConfig.INSTALL_TYPE_NPM) {
-          continue;
-        }
-
-        const updates = await this.checkForExtensionUpdate(ext);
-        data.updateVersion = updates.safeUpdate;
-        data.unsafeUpdateVersion = updates.unsafeUpdate;
-        data.upToDate = updates.safeUpdate === null && updates.unsafeUpdate === null;
-      }
-    });
-
-    if (this.isJsonOutput) {
-      return exts;
+    /**
+     * `driver` or `plugin`, depending on the `ExtensionConfig`.
+     */
+    get type() {
+        return this.config.extensionType;
     }
-
-    for (const [name, {
-      installType,
-      installSpec,
-      installed,
-      updateVersion,
-      unsafeUpdateVersion,
-      version,
-      upToDate
-    }] of _lodash.default.toPairs(exts)) {
-      let typeTxt;
-
-      switch (installType) {
-        case _extensionConfig.INSTALL_TYPE_GIT:
-        case _extensionConfig.INSTALL_TYPE_GITHUB:
-          typeTxt = `(cloned from ${installSpec})`.yellow;
-          break;
-
-        case _extensionConfig.INSTALL_TYPE_LOCAL:
-          typeTxt = `(linked from ${installSpec})`.magenta;
-          break;
-
-        default:
-          typeTxt = '(NPM)';
-      }
-
-      const installTxt = installed ? `@${version.yellow} ${('[installed ' + typeTxt + ']').green}` : ' [not installed]'.grey;
-      const updateTxt = showUpdates && updateVersion ? ` [${updateVersion} available]`.magenta : '';
-      const upToDateTxt = showUpdates && upToDate ? ` [Up to date]`.green : '';
-      const unsafeUpdateTxt = showUpdates && unsafeUpdateVersion ? ` [${unsafeUpdateVersion} available (potentially unsafe)]`.cyan : '';
-      console.log(`- ${name.yellow}${installTxt}${updateTxt}${upToDateTxt}${unsafeUpdateTxt}`);
+    /**
+     * Logs a message and returns an {@linkcode Error} to throw.
+     *
+     * For TS to understand that a function throws an exception, it must actually throw an exception--
+     * in other words, _calling_ a function which is guaranteed to throw an exception is not enough--
+     * nor is something like `@returns {never}` which does not imply a thrown exception.
+     * @param {string} message
+     * @protected
+     * @throws {Error}
+     */
+    _createFatalError(message) {
+        return new Error(this.log.decorate(message, 'error'));
     }
-
-    return exts;
-  }
-
-  async install({
-    ext,
-    installType,
-    packageName
-  }) {
-    (0, _utils.log)(this.isJsonOutput, `Attempting to find and install ${this.type} '${ext}'`);
-    let extData;
-    let installSpec = ext;
-
-    if (packageName && [_extensionConfig.INSTALL_TYPE_LOCAL, _extensionConfig.INSTALL_TYPE_NPM].includes(installType)) {
-      throw new Error(`When using --source=${installType}, cannot also use --package`);
-    }
-
-    if (!packageName && [_extensionConfig.INSTALL_TYPE_GIT, _extensionConfig.INSTALL_TYPE_GITHUB].includes(installType)) {
-      throw new Error(`When using --source=${installType}, must also use --package`);
+    /**
+     * 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
+     */
+    async execute(args) {
+        const cmd = args[`${this.type}Command`];
+        if (!lodash_1.default.isFunction(this[cmd])) {
+            throw this._createFatalError(`Cannot handle ${this.type} command ${cmd}`);
+        }
+        const executeCmd = this[cmd].bind(this);
+        return await executeCmd(args);
     }
-
-    if (installType === _extensionConfig.INSTALL_TYPE_LOCAL) {
-      const msg = `Linking ${this.type} from local path`;
-      const pkgJsonData = await (0, _utils.spinWith)(this.isJsonOutput, msg, async () => await this.npm.linkPackage(installSpec));
-      extData = this.getExtensionFields(pkgJsonData);
-      extData.installPath = extData.pkgName;
-    } else if (installType === _extensionConfig.INSTALL_TYPE_GITHUB) {
-      if (installSpec.split('/').length !== 2) {
-        throw new Error(`Github ${this.type} spec ${installSpec} appeared to be invalid; ` + 'it should be of the form <org>/<repo>');
-      }
-
-      extData = await this.installViaNpm({
-        ext: installSpec,
-        pkgName: packageName
-      });
-    } else if (installType === _extensionConfig.INSTALL_TYPE_GIT) {
-      installSpec = installSpec.replace(/\.git$/, '');
-      extData = await this.installViaNpm({
-        ext: installSpec,
-        pkgName: packageName
-      });
-    } else {
-      let name, pkgVer;
-      const splits = installSpec.split('@');
-
-      if (installSpec[0] === '@') {
-        [name, pkgVer] = [`@${splits[1]}`, splits[2]];
-      } else {
-        [name, pkgVer] = splits;
-      }
-
-      let pkgName;
-
-      if (installType === _extensionConfig.INSTALL_TYPE_NPM) {
-        pkgName = name;
-      } else {
+    /**
+     * List extensions
+     *
+     * @param {ListOptions} opts
+     * @return {Promise<ExtensionListData>} map of extension names to extension data
+     */
+    async list({ showInstalled, showUpdates }) {
+        const lsMsg = `Listing ${showInstalled ? 'installed' : 'available'} ${this.type}s`;
+        const installedNames = Object.keys(this.config.installedExtensions);
         const knownNames = Object.keys(this.knownExtensions);
-
-        if (!_lodash.default.includes(knownNames, name)) {
-          const msg = `Could not resolve ${this.type}; are you sure it's in the list ` + `of supported ${this.type}s? ${JSON.stringify(knownNames)}`;
-          throw new Error(msg);
-        }
-
-        pkgName = this.knownExtensions[name];
-        installType = _extensionConfig.INSTALL_TYPE_NPM;
-      }
-
-      extData = await this.installViaNpm({
-        ext,
-        pkgName,
-        pkgVer
-      });
-    }
-
-    const extName = extData[`${this.type}Name`];
-    delete extData[`${this.type}Name`];
-
-    if (this.config.isInstalled(extName)) {
-      throw new Error(`A ${this.type} named '${extName}' is already installed. ` + `Did you mean to update? 'appium ${this.type} update'. See ` + `installed ${this.type}s with 'appium ${this.type} list --installed'.`);
+        const exts = [...installedNames, ...knownNames].reduce((acc, name) => {
+            if (!acc[name]) {
+                if (installedNames.includes(name)) {
+                    acc[name] = {
+                        ...this.config.installedExtensions[name],
+                        installed: true,
+                    };
+                }
+                else if (!showInstalled) {
+                    acc[name] = { pkgName: this.knownExtensions[name], installed: false };
+                }
+            }
+            return acc;
+        }, 
+        /**
+         * This accumulator contains either {@linkcode UninstalledExtensionLIstData} _or_
+         * {@linkcode InstalledExtensionListData} without upgrade information (which is added by the below code block)
+         * @type {Record<string,Partial<InstalledExtensionListData>|UninstalledExtensionListData>}
+         */ ({}));
+        // if we want to show whether updates are available, put that behind a spinner
+        await (0, utils_1.spinWith)(this.isJsonOutput, lsMsg, async () => {
+            if (!showUpdates) {
+                return;
+            }
+            for (const [ext, data] of lodash_1.default.toPairs(exts)) {
+                if (!data.installed || data.installType !== extension_config_1.INSTALL_TYPE_NPM) {
+                    // don't need to check for updates on exts that aren't installed
+                    // also don't need to check for updates on non-npm exts
+                    continue;
+                }
+                try {
+                    const updates = await this.checkForExtensionUpdate(ext);
+                    data.updateVersion = updates.safeUpdate;
+                    data.unsafeUpdateVersion = updates.unsafeUpdate;
+                    data.upToDate = updates.safeUpdate === null && updates.unsafeUpdate === null;
+                }
+                catch (e) {
+                    data.updateError = e.message;
+                }
+            }
+        });
+        const listData = /** @type {ExtensionListData} */ (exts);
+        // if we're just getting the data, short circuit return here since we don't need to do any
+        // formatting logic
+        if (this.isJsonOutput) {
+            return listData;
+        }
+        for (const [name, data] of lodash_1.default.toPairs(listData)) {
+            let installTxt = ' [not installed]'.grey;
+            let updateTxt = '';
+            let upToDateTxt = '';
+            let unsafeUpdateTxt = '';
+            if (data.installed) {
+                const { installType, installSpec, updateVersion, unsafeUpdateVersion, version, upToDate, updateError, } = data;
+                let typeTxt;
+                switch (installType) {
+                    case extension_config_1.INSTALL_TYPE_GIT:
+                    case extension_config_1.INSTALL_TYPE_GITHUB:
+                        typeTxt = `(cloned from ${installSpec})`.yellow;
+                        break;
+                    case extension_config_1.INSTALL_TYPE_LOCAL:
+                        typeTxt = `(linked from ${installSpec})`.magenta;
+                        break;
+                    default:
+                        typeTxt = '(NPM)';
+                }
+                installTxt = `@${version.yellow} ${('[installed ' + typeTxt + ']').green}`;
+                if (showUpdates) {
+                    if (updateError) {
+                        updateTxt = ` [Cannot check for updates: ${updateError}]`.red;
+                    }
+                    else {
+                        if (updateVersion) {
+                            updateTxt = ` [${updateVersion} available]`.magenta;
+                        }
+                        if (upToDate) {
+                            upToDateTxt = ` [Up to date]`.green;
+                        }
+                        if (unsafeUpdateVersion) {
+                            unsafeUpdateTxt = ` [${unsafeUpdateVersion} available (potentially unsafe)]`.cyan;
+                        }
+                    }
+                }
+            }
+            this.log.log(`- ${name.yellow}${installTxt}${updateTxt}${upToDateTxt}${unsafeUpdateTxt}`);
+        }
+        return listData;
     }
-
-    extData.installType = installType;
-    extData.installSpec = installSpec;
-    await this.config.addExtension(extName, extData);
-    (0, _utils.log)(this.isJsonOutput, this.getPostInstallText({
-      extName,
-      extData
-    }));
-    return this.config.installedExtensions;
-  }
-
-  async installViaNpm({
-    ext,
-    pkgName,
-    pkgVer
-  }) {
-    const npmSpec = `${pkgName}${pkgVer ? '@' + pkgVer : ''}`;
-    const specMsg = npmSpec === ext ? '' : ` using NPM install spec '${npmSpec}'`;
-    const msg = `Installing '${ext}'${specMsg}`;
-
-    try {
-      const pkgJsonData = await (0, _utils.spinWith)(this.isJsonOutput, msg, async () => await this.npm.installPackage({
-        pkgDir: _path.default.resolve(this.config.appiumHome, pkgName),
-        pkgName,
-        pkgVer
-      }));
-      const extData = this.getExtensionFields(pkgJsonData);
-      extData.installPath = pkgName;
-      return extData;
-    } catch (err) {
-      throw new Error(`Encountered an error when installing package: ${err.message}`);
+    /**
+     * Install an extension
+     *
+     * @param {InstallOpts} opts
+     * @return {Promise<ExtRecord<ExtType>>} map of all installed extension names to extension data
+     */
+    async _install({ installSpec, installType, packageName }) {
+        /** @type {ExtInstallReceipt<ExtType>} */
+        let receipt;
+        if (packageName && [extension_config_1.INSTALL_TYPE_LOCAL, extension_config_1.INSTALL_TYPE_NPM].includes(installType)) {
+            throw this._createFatalError(`When using --source=${installType}, cannot also use --package`);
+        }
+        if (!packageName && [extension_config_1.INSTALL_TYPE_GIT, extension_config_1.INSTALL_TYPE_GITHUB].includes(installType)) {
+            throw this._createFatalError(`When using --source=${installType}, must also use --package`);
+        }
+        /**
+         * @type {InstallViaNpmArgs}
+         */
+        let installViaNpmOpts;
+        /**
+         * The probable (?) name of the extension derived from the install spec.
+         *
+         * If using a local install type, this will remain empty.
+         * @type {string}
+         */
+        let probableExtName = '';
+        // depending on `installType`, build the options to pass into `installViaNpm`
+        if (installType === extension_config_1.INSTALL_TYPE_GITHUB) {
+            if (installSpec.split('/').length !== 2) {
+                throw this._createFatalError(`Github ${this.type} spec ${installSpec} appeared to be invalid; ` +
+                    'it should be of the form <org>/<repo>');
+            }
+            installViaNpmOpts = {
+                installSpec,
+                installType,
+                pkgName: /** @type {string} */ (packageName),
+            };
+            probableExtName = installSpec;
+        }
+        else if (installType === extension_config_1.INSTALL_TYPE_GIT) {
+            // git urls can have '.git' at the end, but this is not necessary and would complicate the
+            // way we download and name directories, so we can just remove it
+            installSpec = installSpec.replace(/\.git$/, '');
+            installViaNpmOpts = {
+                installSpec,
+                installType,
+                pkgName: /** @type {string} */ (packageName),
+            };
+            probableExtName = installSpec;
+        }
+        else {
+            let pkgName, pkgVer;
+            if (installType === extension_config_1.INSTALL_TYPE_LOCAL) {
+                pkgName = path_1.default.isAbsolute(installSpec) ? installSpec : path_1.default.resolve(installSpec);
+            }
+            else {
+                // at this point we have either an npm package or an appium verified extension
+                // name or a local path. both of which will be installed via npm.
+                // extensions installed via npm can include versions or tags after the '@'
+                // sign, so check for that. We also need to be careful that package names themselves can
+                // contain the '@' symbol, as in `npm install @appium/fake-driver@1.2.0`
+                let name;
+                const splits = installSpec.split('@');
+                if (installSpec[0] === '@') {
+                    // this is the case where we have an npm org included in the package name
+                    [name, pkgVer] = [`@${splits[1]}`, splits[2]];
+                }
+                else {
+                    // this is the case without an npm org
+                    [name, pkgVer] = splits;
+                }
+                if (installType === extension_config_1.INSTALL_TYPE_NPM) {
+                    // if we're installing a named package from npm, we don't need to check
+                    // against the appium extension list; just use the installSpec as is
+                    pkgName = name;
+                }
+                else {
+                    // if we're installing a named appium driver (like 'xcuitest') we need to
+                    // dereference the actual npm package ('appiupm-xcuitest-driver'), so
+                    // check it exists and get the correct package
+                    const knownNames = Object.keys(this.knownExtensions);
+                    if (!lodash_1.default.includes(knownNames, name)) {
+                        const msg = `Could not resolve ${this.type}; are you sure it's in the list ` +
+                            `of supported ${this.type}s? ${JSON.stringify(knownNames)}`;
+                        throw this._createFatalError(msg);
+                    }
+                    probableExtName = name;
+                    pkgName = this.knownExtensions[name];
+                    // given that we'll use the install type in the driver json, store it as
+                    // 'npm' now
+                    installType = extension_config_1.INSTALL_TYPE_NPM;
+                }
+            }
+            installViaNpmOpts = { installSpec, pkgName, pkgVer, installType };
+        }
+        // fail fast here if we can
+        if (probableExtName && this.config.isInstalled(probableExtName)) {
+            throw this._createFatalError(`A ${this.type} named "${probableExtName}" is already installed. ` +
+                `Did you mean to update? Run "appium ${this.type} update". See ` +
+                `installed ${this.type}s with "appium ${this.type} list --installed".`);
+        }
+        receipt = await this.installViaNpm(installViaNpmOpts);
+        // this _should_ be the same as `probablyExtName` as the one derived above unless
+        // install type is local.
+        /** @type {string} */
+        const extName = receipt[ /** @type {string} */(`${this.type}Name`)];
+        // check _a second time_ with the more-accurate extName
+        if (this.config.isInstalled(extName)) {
+            throw this._createFatalError(`A ${this.type} named "${extName}" is already installed. ` +
+                `Did you mean to update? Run "appium ${this.type} update". See ` +
+                `installed ${this.type}s with "appium ${this.type} list --installed".`);
+        }
+        // this field does not exist as such in the manifest (it's used as a property name instead)
+        // so that's why it's being removed here.
+        /** @type {ExtManifest<ExtType>} */
+        const extManifest = receiptToManifest(receipt);
+        const [errors, warnings] = await bluebird_1.default.all([
+            this.config.getProblems(extName, extManifest),
+            this.config.getWarnings(extName, extManifest),
+        ]);
+        const errorMap = new Map([[extName, errors]]);
+        const warningMap = new Map([[extName, warnings]]);
+        const { errorSummaries, warningSummaries } = this.config.getValidationResultSummaries(errorMap, warningMap);
+        if (!lodash_1.default.isEmpty(errorSummaries)) {
+            throw this._createFatalError(errorSummaries.join('\n'));
+        }
+        // note that we won't show any warnings if there were errors.
+        if (!lodash_1.default.isEmpty(warningSummaries)) {
+            this.log.warn(warningSummaries.join('\n'));
+        }
+        await this.config.addExtension(extName, extManifest);
+        // update the hash if we've changed the local `package.json`
+        if (await support_1.env.hasAppiumDependency(this.config.appiumHome)) {
+            await (0, package_changed_1.packageDidChange)(this.config.appiumHome);
+        }
+        // log info for the user
+        this.log.info(this.getPostInstallText({ extName, extData: receipt }));
+        return this.config.installedExtensions;
     }
-  }
-
-  getPostInstallText() {
-    throw new Error('Must be implemented in final class');
-  }
-
-  getExtensionFields(pkgJsonData) {
-    if (!pkgJsonData.appium) {
-      throw new Error(`Installed driver did not have an 'appium' section in its ` + `package.json file as expected`);
+    /**
+     * Install an extension via NPM
+     *
+     * @param {InstallViaNpmArgs} args
+     * @returns {Promise<ExtInstallReceipt<ExtType>>}
+     */
+    async installViaNpm({ installSpec, pkgName, pkgVer, installType }) {
+        const npmSpec = `${pkgName}${pkgVer ? '@' + pkgVer : ''}`;
+        const specMsg = npmSpec === installSpec ? '' : ` using NPM install spec '${npmSpec}'`;
+        const msg = `Installing '${installSpec}'${specMsg}`;
+        try {
+            const { pkg, path } = await (0, utils_1.spinWith)(this.isJsonOutput, msg, async () => {
+                const { pkg, installPath: path } = await support_1.npm.installPackage(this.config.appiumHome, pkgName, {
+                    pkgVer,
+                    installType,
+                });
+                this.validatePackageJson(pkg, installSpec);
+                return { pkg, path };
+            });
+            return this.getInstallationReceipt({
+                pkg,
+                installPath: path,
+                installType,
+                installSpec,
+            });
+        }
+        catch (err) {
+            throw this._createFatalError(`Encountered an error when installing package: ${err.message}`);
+        }
     }
-
-    const {
-      appium,
-      name,
-      version
-    } = pkgJsonData;
-    this.validateExtensionFields(appium);
-    return { ...appium,
-      pkgName: name,
-      version
-    };
-  }
-
-  validateExtensionFields() {
-    throw new Error('Must be implemented in final class');
-  }
-
-  async uninstall({
-    ext
-  }) {
-    if (!this.config.isInstalled(ext)) {
-      throw new Error(`Can't uninstall ${this.type} '${ext}'; it is not installed`);
+    /**
+     * 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}
+     */
+    // eslint-disable-next-line no-unused-vars
+    getPostInstallText(args) {
+        throw this._createFatalError('Must be implemented in final class');
     }
-
-    try {
-      await _appiumSupport.fs.rimraf(this.config.getInstallPath(ext));
-    } finally {
-      await this.config.removeExtension(ext);
+    /**
+     * Once a package is installed on-disk, this gathers some necessary metadata for validation.
+     *
+     * @param {GetInstallationReceiptOpts<ExtType>} opts
+     * @returns {ExtInstallReceipt<ExtType>}
+     */
+    getInstallationReceipt({ pkg, installPath, installType, installSpec }) {
+        const { appium, name, version, peerDependencies } = pkg;
+        /** @type {import('appium/types').InternalMetadata} */
+        const internal = {
+            pkgName: name,
+            version,
+            installType,
+            installSpec,
+            installPath,
+            appiumVersion: peerDependencies?.appium,
+        };
+        /** @type {ExtMetadata<ExtType>} */
+        const extMetadata = appium;
+        return {
+            ...internal,
+            ...extMetadata,
+        };
     }
-
-    (0, _utils.log)(this.isJsonOutput, `Successfully uninstalled ${this.type} '${ext}'`.green);
-    return this.config.installedExtensions;
-  }
-
-  async update({
-    ext,
-    unsafe
-  }) {
-    const shouldUpdateAll = ext === UPDATE_ALL;
-
-    if (!shouldUpdateAll && !this.config.isInstalled(ext)) {
-      throw new Error(`The ${this.type} '${ext}' was not installed, so can't be updated`);
+    /**
+     * Validates the _required_ root fields of an extension's `package.json` file.
+     *
+     * These required fields are:
+     * - `name`
+     * - `version`
+     * - `appium`
+     * @param {import('type-fest').PackageJson} pkg - `package.json` of extension
+     * @param {string} installSpec - Extension name/spec
+     * @throws {ReferenceError} If `package.json` has a missing or invalid field
+     * @returns {pkg is ExtPackageJson<ExtType>}
+     */
+    validatePackageJson(pkg, installSpec) {
+        const { appium, name, version } = /** @type {ExtPackageJson<ExtType>} */ (pkg);
+        /**
+         *
+         * @param {string} field
+         * @returns {ReferenceError}
+         */
+        const createMissingFieldError = (field) => new ReferenceError(`${this.type} "${installSpec}" invalid; missing a \`${field}\` field of its \`package.json\``);
+        if (!name) {
+            throw createMissingFieldError('name');
+        }
+        if (!version) {
+            throw createMissingFieldError('version');
+        }
+        if (!appium) {
+            throw createMissingFieldError('appium');
+        }
+        this.validateExtensionFields(appium, installSpec);
+        return true;
     }
-
-    const extsToUpdate = shouldUpdateAll ? Object.keys(this.config.installedExtensions) : [ext];
-    const errors = {};
-    const updates = {};
-
-    for (const e of extsToUpdate) {
-      try {
-        await (0, _utils.spinWith)(this.isJsonOutput, `Checking if ${this.type} '${e}' is updatable`, () => {
-          if (this.config.installedExtensions[e].installType !== _extensionConfig.INSTALL_TYPE_NPM) {
-            throw new NotUpdatableError();
-          }
-        });
-        const update = await (0, _utils.spinWith)(this.isJsonOutput, `Checking if ${this.type} '${e}' needs an update`, async () => {
-          const update = await this.checkForExtensionUpdate(e);
-
-          if (!(update.safeUpdate || update.unsafeUpdate)) {
-            throw new NoUpdatesAvailableError();
-          }
-
-          return update;
-        });
-
-        if (!unsafe && !update.safeUpdate) {
-          throw new Error(`The ${this.type} '${e}' has a major revision update ` + `(${update.current} => ${update.unsafeUpdate}), which could include ` + `breaking changes. If you want to apply this update, re-run with --unsafe`);
-        }
-
-        const updateVer = unsafe && update.unsafeUpdate ? update.unsafeUpdate : update.safeUpdate;
-        await (0, _utils.spinWith)(this.isJsonOutput, `Updating driver '${e}' from ${update.current} to ${updateVer}`, async () => await this.updateExtension(e, updateVer));
-        updates[e] = {
-          from: update.current,
-          to: updateVer
-        };
-      } catch (err) {
-        errors[e] = err;
-      }
+    /**
+     * 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>} extMetadata - the data in the "appium" field of `package.json` for an extension
+     * @param {string} installSpec - Extension name/spec
+     */
+    // eslint-disable-next-line no-unused-vars
+    validateExtensionFields(extMetadata, installSpec) {
+        throw this._createFatalError('Must be implemented in final class');
     }
-
-    (0, _utils.log)(this.isJsonOutput, 'Update report:');
-
-    for (const [e, update] of _lodash.default.toPairs(updates)) {
-      (0, _utils.log)(this.isJsonOutput, `- ${this.type} ${e} updated: ${update.from} => ${update.to}`.green);
+    /**
+     * Uninstall an extension.
+     *
+     * First tries to do this via `npm uninstall`, but if that fails, just `rm -rf`'s the extension dir.
+     *
+     * Will only remove the extension from the manifest if it has been successfully removed.
+     *
+     * @param {UninstallOpts} opts
+     * @return {Promise<ExtRecord<ExtType>>} map of all installed extension names to extension data (without the extension just uninstalled)
+     */
+    async _uninstall({ installSpec }) {
+        if (!this.config.isInstalled(installSpec)) {
+            throw this._createFatalError(`Can't uninstall ${this.type} '${installSpec}'; it is not installed`);
+        }
+        const pkgName = this.config.installedExtensions[installSpec].pkgName;
+        await support_1.npm.uninstallPackage(this.config.appiumHome, pkgName);
+        await this.config.removeExtension(installSpec);
+        this.log.ok(`Successfully uninstalled ${this.type} '${installSpec}'`.green);
+        return this.config.installedExtensions;
     }
-
-    for (const [e, err] of _lodash.default.toPairs(errors)) {
-      if (err instanceof NotUpdatableError) {
-        (0, _utils.log)(this.isJsonOutput, `- '${e}' was not installed via npm, so we could not check ` + `for updates`.yellow);
-      } else if (err instanceof NoUpdatesAvailableError) {
-        (0, _utils.log)(this.isJsonOutput, `- '${e}' had no updates available`.yellow);
-      } else {
-        (0, _utils.log)(this.isJsonOutput, `- '${e}' failed to update: ${err}`.red);
-      }
+    /**
+     * Attempt to update one or more drivers using NPM
+     *
+     * @param {ExtensionUpdateOpts} updateSpec
+     * @return {Promise<ExtensionUpdateResult>}
+     */
+    async _update({ installSpec, unsafe }) {
+        const shouldUpdateAll = installSpec === UPDATE_ALL;
+        // if we're specifically requesting an update for an extension, make sure it's installed
+        if (!shouldUpdateAll && !this.config.isInstalled(installSpec)) {
+            throw this._createFatalError(`The ${this.type} "${installSpec}" was not installed, so can't be updated`);
+        }
+        const extsToUpdate = shouldUpdateAll
+            ? Object.keys(this.config.installedExtensions)
+            : [installSpec];
+        // 'errors' will have ext names as keys and error objects as values
+        /** @type {Record<string,Error>} */
+        const errors = {};
+        // 'updates' will have ext names as keys and update objects as values, where an update
+        // object is of the form {from: versionString, to: versionString}
+        /** @type {Record<string,UpdateReport>} */
+        const updates = {};
+        for (const e of extsToUpdate) {
+            try {
+                await (0, utils_1.spinWith)(this.isJsonOutput, `Checking if ${this.type} '${e}' is updatable`, () => {
+                    if (this.config.installedExtensions[e].installType !== extension_config_1.INSTALL_TYPE_NPM) {
+                        throw new NotUpdatableError();
+                    }
+                });
+                const update = await (0, utils_1.spinWith)(this.isJsonOutput, `Checking if ${this.type} '${e}' needs an update`, async () => {
+                    const update = await this.checkForExtensionUpdate(e);
+                    if (!(update.safeUpdate || update.unsafeUpdate)) {
+                        throw new NoUpdatesAvailableError();
+                    }
+                    return update;
+                });
+                if (!unsafe && !update.safeUpdate) {
+                    throw this._createFatalError(`The ${this.type} '${e}' has a major revision update ` +
+                        `(${update.current} => ${update.unsafeUpdate}), which could include ` +
+                        `breaking changes. If you want to apply this update, re-run with --unsafe`);
+                }
+                const updateVer = unsafe && update.unsafeUpdate ? update.unsafeUpdate : update.safeUpdate;
+                await (0, utils_1.spinWith)(this.isJsonOutput, `Updating driver '${e}' from ${update.current} to ${updateVer}`, async () => await this.updateExtension(e, updateVer));
+                updates[e] = { from: update.current, to: updateVer };
+            }
+            catch (err) {
+                errors[e] = err;
+            }
+        }
+        this.log.info('Update report:');
+        for (const [e, update] of lodash_1.default.toPairs(updates)) {
+            this.log.ok(`  - ${this.type} ${e} updated: ${update.from} => ${update.to}`.green);
+        }
+        for (const [e, err] of lodash_1.default.toPairs(errors)) {
+            if (err instanceof NotUpdatableError) {
+                this.log.warn(`  - '${e}' was not installed via npm, so we could not check ` + `for updates`.yellow);
+            }
+            else if (err instanceof NoUpdatesAvailableError) {
+                this.log.info(`  - '${e}' had no updates available`.yellow);
+            }
+            else {
+                // otherwise, make it pop with red!
+                this.log.error(`  - '${e}' failed to update: ${err}`.red);
+            }
+        }
+        return { updates, errors };
     }
-
-    return {
-      updates,
-      errors
-    };
-  }
-
-  async checkForExtensionUpdate(ext) {
-    const {
-      version,
-      pkgName
-    } = this.config.installedExtensions[ext];
-    let unsafeUpdate = await this.npm.getLatestVersion(pkgName);
-    let safeUpdate = await this.npm.getLatestSafeUpgradeVersion(pkgName, version);
-
-    if (!_appiumSupport.util.compareVersions(unsafeUpdate, '>', version)) {
-      unsafeUpdate = null;
-      safeUpdate = null;
+    /**
+     * 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>}
+     */
+    async checkForExtensionUpdate(ext) {
+        // TODO decide how we want to handle beta versions?
+        // this is a helper method, 'ext' is assumed to already be installed here, and of the npm
+        // install type
+        const { version, pkgName } = this.config.installedExtensions[ext];
+        /** @type {string?} */
+        let unsafeUpdate = await support_1.npm.getLatestVersion(this.config.appiumHome, pkgName);
+        let safeUpdate = await support_1.npm.getLatestSafeUpgradeVersion(this.config.appiumHome, pkgName, version);
+        if (unsafeUpdate !== null && !support_1.util.compareVersions(unsafeUpdate, '>', version)) {
+            // the latest version is not greater than the current version, so there's no possible update
+            unsafeUpdate = null;
+            safeUpdate = null;
+        }
+        if (unsafeUpdate && unsafeUpdate === safeUpdate) {
+            // the latest update is the same as the safe update, which means it's not actually unsafe
+            unsafeUpdate = null;
+        }
+        if (safeUpdate && !support_1.util.compareVersions(safeUpdate, '>', version)) {
+            // even the safe update is not later than the current, so it is not actually an update
+            safeUpdate = null;
+        }
+        return { current: version, safeUpdate, unsafeUpdate };
     }
-
-    if (unsafeUpdate && unsafeUpdate === safeUpdate) {
-      unsafeUpdate = null;
+    /**
+     * Actually update an extension installed by NPM, using the NPM cli. And update the installation
+     * manifest.
+     *
+     * @param {string} installSpec - name of extension to update
+     * @param {string} version - version string identifier to update extension to
+     * @returns {Promise<void>}
+     */
+    async updateExtension(installSpec, version) {
+        const { pkgName, installType } = this.config.installedExtensions[installSpec];
+        const extData = await this.installViaNpm({
+            installSpec,
+            installType,
+            pkgName,
+            pkgVer: version,
+        });
+        delete extData[ /** @type {string} */(`${this.type}Name`)];
+        await this.config.updateExtension(installSpec, extData);
     }
-
-    if (safeUpdate && !_appiumSupport.util.compareVersions(safeUpdate, '>', version)) {
-      safeUpdate = null;
+    /**
+     * 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>}
+     */
+    async _run({ installSpec, scriptName, extraArgs = [] }) {
+        if (!this.config.isInstalled(installSpec)) {
+            throw this._createFatalError(`The ${this.type} "${installSpec}" is not installed`);
+        }
+        const extConfig = this.config.installedExtensions[installSpec];
+        // note: TS cannot understand that _.has() is a type guard
+        if (!('scripts' in extConfig)) {
+            throw this._createFatalError(`The ${this.type} named '${installSpec}' does not contain the ` +
+                `"scripts" field underneath the "appium" field in its package.json`);
+        }
+        const extScripts = extConfig.scripts;
+        if (!extScripts || !lodash_1.default.isPlainObject(extScripts)) {
+            throw this._createFatalError(`The ${this.type} named '${installSpec}' "scripts" field must be a plain object`);
+        }
+        if (!(scriptName in extScripts)) {
+            throw this._createFatalError(`The ${this.type} named '${installSpec}' does not support the script: '${scriptName}'`);
+        }
+        const runner = new teen_process_1.SubProcess(process.execPath, [extScripts[scriptName], ...extraArgs], {
+            cwd: this.config.getInstallPath(installSpec),
+        });
+        const output = new utils_1.RingBuffer(50);
+        runner.on('stream-line', (line) => {
+            output.enqueue(line);
+            this.log.log(line);
+        });
+        await runner.start(0);
+        try {
+            await runner.join();
+            this.log.ok(`${scriptName} successfully ran`.green);
+            return { output: output.getBuff() };
+        }
+        catch (err) {
+            this.log.error(`Encountered an error when running '${scriptName}': ${err.message}`.red);
+            return { error: err.message, output: output.getBuff() };
+        }
     }
-
-    return {
-      current: version,
-      safeUpdate,
-      unsafeUpdate
-    };
-  }
-
-  async updateExtension(ext, version) {
-    const {
-      pkgName
-    } = this.config.installedExtensions[ext];
-    await this.installViaNpm({
-      ext,
-      pkgName,
-      pkgVer: version
-    });
-    this.config.installedExtensions[ext].version = version;
-    await this.config.write();
-  }
-
 }
-
-exports.default = ExtensionCommand;require('source-map-support').install();
-
-
-//# sourceMappingURL=data:application/json;charset=utf8;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbImxpYi9jbGkvZXh0ZW5zaW9uLWNvbW1hbmQuanMiXSwibmFtZXMiOlsiVVBEQVRFX0FMTCIsIk5vdFVwZGF0YWJsZUVycm9yIiwiRXJyb3IiLCJOb1VwZGF0ZXNBdmFpbGFibGVFcnJvciIsIkV4dGVuc2lvbkNvbW1hbmQiLCJjb25zdHJ1Y3RvciIsImNvbmZpZyIsImpzb24iLCJ0eXBlIiwiaXNKc29uT3V0cHV0IiwibnBtIiwiTlBNIiwiYXBwaXVtSG9tZSIsImtub3duRXh0ZW5zaW9ucyIsImV4ZWN1dGUiLCJhcmdzIiwiY21kIiwiXyIsImlzRnVuY3Rpb24iLCJwcm90b3R5cGUiLCJleGVjdXRlQ21kIiwiYmluZCIsImxpc3QiLCJzaG93SW5zdGFsbGVkIiwic2hvd1VwZGF0ZXMiLCJsc01zZyIsImluc3RhbGxlZE5hbWVzIiwiT2JqZWN0Iiwia2V5cyIsImluc3RhbGxlZEV4dGVuc2lvbnMiLCJrbm93bk5hbWVzIiwiZXh0cyIsInJlZHVjZSIsImFjYyIsIm5hbWUiLCJpbmNsdWRlcyIsImluc3RhbGxlZCIsInBrZ05hbWUiLCJleHQiLCJkYXRhIiwidG9QYWlycyIsImluc3RhbGxUeXBlIiwiSU5TVEFMTF9UWVBFX05QTSIsInVwZGF0ZXMiLCJjaGVja0ZvckV4dGVuc2lvblVwZGF0ZSIsInVwZGF0ZVZlcnNpb24iLCJzYWZlVXBkYXRlIiwidW5zYWZlVXBkYXRlVmVyc2lvbiIsInVuc2FmZVVwZGF0ZSIsInVwVG9EYXRlIiwiaW5zdGFsbFNwZWMiLCJ2ZXJzaW9uIiwidHlwZVR4dCIsIklOU1RBTExfVFlQRV9HSVQiLCJJTlNUQUxMX1RZUEVfR0lUSFVCIiwieWVsbG93IiwiSU5TVEFMTF9UWVBFX0xPQ0FMIiwibWFnZW50YSIsImluc3RhbGxUeHQiLCJncmVlbiIsImdyZXkiLCJ1cGRhdGVUeHQiLCJ1cFRvRGF0ZVR4dCIsInVuc2FmZVVwZGF0ZVR4dCIsImN5YW4iLCJjb25zb2xlIiwibG9nIiwiaW5zdGFsbCIsInBhY2thZ2VOYW1lIiwiZXh0RGF0YSIsIm1zZyIsInBrZ0pzb25EYXRhIiwibGlua1BhY2thZ2UiLCJnZXRFeHRlbnNpb25GaWVsZHMiLCJpbnN0YWxsUGF0aCIsInNwbGl0IiwibGVuZ3RoIiwiaW5zdGFsbFZpYU5wbSIsInJlcGxhY2UiLCJwa2dWZXIiLCJzcGxpdHMiLCJKU09OIiwic3RyaW5naWZ5IiwiZXh0TmFtZSIsImlzSW5zdGFsbGVkIiwiYWRkRXh0ZW5zaW9uIiwiZ2V0UG9zdEluc3RhbGxUZXh0IiwibnBtU3BlYyIsInNwZWNNc2ciLCJpbnN0YWxsUGFja2FnZSIsInBrZ0RpciIsInBhdGgiLCJyZXNvbHZlIiwiZXJyIiwibWVzc2FnZSIsImFwcGl1bSIsInZhbGlkYXRlRXh0ZW5zaW9uRmllbGRzIiwidW5pbnN0YWxsIiwiZnMiLCJyaW1yYWYiLCJnZXRJbnN0YWxsUGF0aCIsInJlbW92ZUV4dGVuc2lvbiIsInVwZGF0ZSIsInVuc2FmZSIsInNob3VsZFVwZGF0ZUFsbCIsImV4dHNUb1VwZGF0ZSIsImVycm9ycyIsImUiLCJjdXJyZW50IiwidXBkYXRlVmVyIiwidXBkYXRlRXh0ZW5zaW9uIiwiZnJvbSIsInRvIiwicmVkIiwiZ2V0TGF0ZXN0VmVyc2lvbiIsImdldExhdGVzdFNhZmVVcGdyYWRlVmVyc2lvbiIsInV0aWwiLCJjb21wYXJlVmVyc2lvbnMiLCJ3cml0ZSJdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7QUFFQTs7QUFDQTs7QUFDQTs7QUFDQTs7QUFDQTs7QUFDQTs7QUFHQSxNQUFNQSxVQUFVLEdBQUcsV0FBbkI7O0FBRUEsTUFBTUMsaUJBQU4sU0FBZ0NDLEtBQWhDLENBQXNDOztBQUN0QyxNQUFNQyx1QkFBTixTQUFzQ0QsS0FBdEMsQ0FBNEM7O0FBRTdCLE1BQU1FLGdCQUFOLENBQXVCO0FBZXBDQyxFQUFBQSxXQUFXLENBQUU7QUFBQ0MsSUFBQUEsTUFBRDtBQUFTQyxJQUFBQSxJQUFUO0FBQWVDLElBQUFBO0FBQWYsR0FBRixFQUF3QjtBQUNqQyxTQUFLRixNQUFMLEdBQWNBLE1BQWQ7QUFDQSxT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TUFBQUEsT0FBTjtBQUFlMEMsTUFBQUEsTUFBTSxFQUFFNUI7QUFBdkIsS0FBbkIsQ0FBTjtBQUNBLFNBQUs3QyxNQUFMLENBQVl1QixtQkFBWixDQUFnQ1MsR0FBaEMsRUFBcUNhLE9BQXJDLEdBQStDQSxPQUEvQztBQUNBLFVBQU0sS0FBSzdDLE1BQUwsQ0FBWWdILEtBQVosRUFBTjtBQUNEOztBQXhkbUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKiBlc2xpbnQtZGlzYWJsZSBuby1jb25zb2xlICovXG5cbmltcG9ydCBfIGZyb20gJ2xvZGFzaCc7XG5pbXBvcnQgTlBNIGZyb20gJy4vbnBtJztcbmltcG9ydCBwYXRoIGZyb20gJ3BhdGgnO1xuaW1wb3J0IHsgZnMsIHV0aWwgfSBmcm9tICdhcHBpdW0tc3VwcG9ydCc7XG5pbXBvcnQgeyBsb2csIHNwaW5XaXRoIH0gZnJvbSAnLi91dGlscyc7XG5pbXBvcnQgeyBJTlNUQUxMX1RZUEVfTlBNLCBJTlNUQUxMX1RZUEVfR0lULCBJTlNUQUxMX1RZUEVfR0lUSFVCLFxuICAgICAgICAgSU5TVEFMTF9UWVBFX0xPQ0FMIH0gZnJvbSAnLi4vZXh0ZW5zaW9uLWNvbmZpZyc7XG5cbmNvbnN0IFVQREFURV9BTEwgPSAnaW5zdGFsbGVkJztcblxuY2xhc3MgTm90VXBkYXRhYmxlRXJyb3IgZXh0ZW5kcyBFcnJvciB7fVxuY2xhc3MgTm9VcGRhdGVzQXZhaWxhYmxlRXJyb3IgZXh0ZW5kcyBFcnJvciB7fVxuXG5leHBvcnQgZGVmYXVsdCBjbGFzcyBFeHRlbnNpb25Db21tYW5kIHtcblxuICAvKipcbiAgICogQHR5cGVkZWYge09iamVjdH0gRXh0ZW5zaW9uQ29tbWFuZENvbnN0cnVjdG9yXG4gICAqIEBwcm9wZXJ0eSB7T2JqZWN0fSBjb25maWcgLSB0aGUgRHJpdmVyQ29uZmlnIG9yIFBsdWdpbkNvbmZpZyBvYmplY3QgdXNlZCBmb3IgdGhpcyBjb21tYW5kXG4gICAqIEBwcm9wZXJ0eSB7Ym9vbGVhbn0ganNvbiAtIHdoZXRoZXIgdGhlIG91dHB1dCBvZiB0aGlzIGNvbW1hbmQgc2hvdWxkIGJlIEpTT04gb3IgdGV4dFxuICAgKiBAcHJvcGVydHkge3N0cmluZ30gdHlwZSAtIERSSVZFUl9UWVBFIG9yIFBMVUdJTl9UWVBFXG4gICAqL1xuXG4gIC8qKlxuICAgKiBCdWlsZCBhbiBFeHRlbnNpb25Db21tYW5kXG4gICAqXG4gICAqIEBwYXJhbSB7RXh0ZW5zaW9uQ29tbWFuZENvbnN0cnVjdG9yfSBvcHRzXG4gICAqIEByZXR1cm4ge0V4dGVuc2lvbkNvbW1hbmR9XG4gICAqL1xuICBjb25zdHJ1Y3RvciAoe2NvbmZpZywganNvbiwgdHlwZX0pIHtcbiAgICB0aGlzLmNvbmZpZyA9IGNvbmZpZztcbiAgICB0aGlzLnR5cGUgPSB0eXBlO1xuICAgIHRoaXMuaXNKc29uT3V0cHV0ID0ganNvbjtcbiAgICB0aGlzLm5wbSA9IG5ldyBOUE0odGhpcy5jb25maWcuYXBwaXVtSG9tZSk7XG4gICAgdGhpcy5rbm93bkV4dGVuc2lvbnMgPSB7fTsgLy8gdGhpcyBuZWVkcyB0byBiZSBvdmVycmlkZGVuIGluIGZpbmFsIGNsYXNzXG4gIH1cblxuICAvKipcbiAgICogVGFrZSBhIENMSSBwYXJzZSBhbmQgcnVuIGFuIGV4dGVuc2lvbiBjb21tYW5kIGJhc2VkIG9uIGl0cyB0eXBlXG4gICAqXG4gICAqIEBwYXJhbSB7b2JqZWN0fSBhcmdzIC0gYSBrZXkvdmFsdWUgb2JqZWN0IHdpdGggQ0xJIGZsYWdzIGFuZCB2YWx1ZXNcbiAgICogQHJldHVybiB7b2JqZWN0fSB0aGUgcmVzdWx0IG9mIHRoZSBzcGVjaWZpYyBjb21tYW5kIHdoaWNoIGlzIGV4ZWN1dGVkXG4gICAqL1xuICBhc3luYyBleGVjdXRlIChhcmdzKSB7XG4gICAgY29uc3QgY21kID0gYXJnc1tgJHt0aGlzLnR5cGV9Q29tbWFuZGBdO1xuICAgIGlmICghXy5pc0Z1bmN0aW9uKEV4dGVuc2lvbkNvbW1hbmQucHJvdG90eXBlW2NtZF0pKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoYENhbm5vdCBoYW5kbGUgJHt0aGlzLnR5cGV9IGNvbW1hbmQgJHtjbWR9YCk7XG4gICAgfVxuICAgIGNvbnN0IGV4ZWN1dGVDbWQgPSB0aGlzW2NtZF0uYmluZCh0aGlzKTtcbiAgICByZXR1cm4gYXdhaXQgZXhlY3V0ZUNtZChhcmdzKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBAdHlwZWRlZiB7T2JqZWN0fSBMaXN0QXJnc1xuICAgKiBAcHJvcGVydHkge2Jvb2xlYW59IHNob3dJbnN0YWxsZWQgLSB3aGV0aGVyIHNob3VsZCBzaG93IG9ubHkgaW5zdGFsbGVkIGV4dGVuc2lvbnNcbiAgICogQHByb3BlcnR5IHtib29sZWFufSBzaG93VXBkYXRlcyAtIHdoZXRoZXIgc2hvdWxkIHNob3cgYXZhaWxhYmxlIHVwZGF0ZXNcbiAgICovXG5cbiAgLyoqXG4gICAqIExpc3QgZXh0ZW5zaW9uc1xuICAgKlxuICAgKiBAcGFyYW0ge0xpc3RBcmdzfSBhcmdzXG4gICAqIEByZXR1cm4ge29iamVjdH0gbWFwIG9mIGV4dGVuc2lvbiBuYW1lcyB0byBleHRlbnNpb24gZGF0YVxuICAgKi9cbiAgYXN5bmMgbGlzdCAoe3Nob3dJbnN0YWxsZWQsIHNob3dVcGRhdGVzfSkge1xuICAgIGNvbnN0IGxzTXNnID0gYExpc3RpbmcgJHtzaG93SW5zdGFsbGVkID8gJ2luc3RhbGxlZCcgOiAnYXZhaWxhYmxlJ30gJHt0aGlzLnR5cGV9c2A7XG4gICAgY29uc3QgaW5zdGFsbGVkTmFtZXMgPSBPYmplY3Qua2V5cyh0aGlzLmNvbmZpZy5pbnN0YWxsZWRFeHRlbnNpb25zKTtcbiAgICBjb25zdCBrbm93bk5hbWVzID0gT2JqZWN0LmtleXModGhpcy5rbm93bkV4dGVuc2lvbnMpO1xuICAgIGNvbnN0IGV4dHMgPSBbLi4uaW5zdGFsbGVkTmFtZXMsIC4uLmtub3duTmFtZXNdLnJlZHVjZSgoYWNjLCBuYW1lKSA9PiB7XG4gICAgICBpZiAoIWFjY1tuYW1lXSkge1xuICAgICAgICBpZiAoaW5zdGFsbGVkTmFtZXMuaW5jbHVkZXMobmFtZSkpIHtcbiAgICAgICAgICBhY2NbbmFtZV0gPSB7Li4udGhpcy5jb25maWcuaW5zdGFsbGVkRXh0ZW5zaW9uc1tuYW1lXSwgaW5zdGFsbGVkOiB0cnVlfTtcbiAgICAgICAgfSBlbHNlIGlmICghc2hvd0luc3RhbGxlZCkge1xuICAgICAgICAgIGFjY1tuYW1lXSA9IHtwa2dOYW1lOiB0aGlzLmtub3duRXh0ZW5zaW9uc1tuYW1lXSwgaW5zdGFsbGVkOiBmYWxzZX07XG4gICAgICAgIH1cbiAgICAgIH1cbiAgICAgIHJldHVybiBhY2M7XG4gICAgfSwge30pO1xuXG4gICAgLy8gaWYgd2Ugd2FudCB0byBzaG93IHdoZXRoZXIgdXBkYXRlcyBhcmUgYXZhaWxhYmxlLCBwdXQgdGhhdCBiZWhpbmQgYSBzcGlubmVyXG4gICAgYXdhaXQgc3BpbldpdGgodGhpcy5pc0pzb25PdXRwdXQsIGxzTXNnLCBhc3luYyAoKSA9PiB7XG4gICAgICBpZiAoIXNob3dVcGRhdGVzKSB7XG4gICAgICAgIHJldHVybjtcbiAgICAgIH1cbiAgICAgIGZvciAoY29uc3QgW2V4dCwgZGF0YV0gb2YgXy50b1BhaXJzKGV4dHMpKSB7XG4gICAgICAgIGNvbnN0IHtpbnN0YWxsZWQsIGluc3RhbGxUeXBlfSA9IGRhdGE7XG4gICAgICAgIGlmICghaW5zdGFsbGVkIHx8IGluc3RhbGxUeXBlICE9PSBJTlNUQUxMX1RZUEVfTlBNKSB7XG4gICAgICAgICAgLy8gZG9uJ3QgbmVlZCB0byBjaGVjayBmb3IgdXBkYXRlcyBvbiBleHRzIHRoYXQgYXJlbid0IGluc3RhbGxlZFxuICAgICAgICAgIC8vIGFsc28gZG9uJ3QgbmVlZCB0byBjaGVjayBmb3IgdXBkYXRlcyBvbiBub24tbnBtIGV4dHNcbiAgICAgICAgICBjb250aW51ZTtcbiAgICAgICAgfVxuICAgICAgICBjb25zdCB1cGRhdGVzID0gYXdhaXQgdGhpcy5jaGVja0ZvckV4dGVuc2lvblVwZGF0ZShleHQpO1xuICAgICAgICBkYXRhLnVwZGF0ZVZlcnNpb24gPSB1cGRhdGVzLnNhZmVVcGRhdGU7XG4gICAgICAgIGRhdGEudW5zYWZlVXBkYXRlVmVyc2lvbiA9IHVwZGF0ZXMudW5zYWZlVXBkYXRlO1xuICAgICAgICBkYXRhLnVwVG9EYXRlID0gdXBkYXRlcy5zYWZlVXBkYXRlID09PSBudWxsICYmIHVwZGF0ZXMudW5zYWZlVXBkYXRlID09PSBudWxsO1xuICAgICAgfVxuICAgIH0pO1xuXG4gICAgLy8gaWYgd2UncmUganVzdCBnZXR0aW5nIHRoZSBkYXRhLCBzaG9ydCBjaXJjdWl0IHJldHVybiBoZXJlIHNpbmNlIHdlIGRvbid0IG5lZWQgdG8gZG8gYW55XG4gICAgLy8gZm9ybWF0dGluZyBsb2dpY1xuICAgIGlmICh0aGlzLmlzSnNvbk91dHB1dCkge1xuICAgICAgcmV0dXJuIGV4dHM7XG4gICAgfVxuXG4gICAgZm9yIChjb25zdCBbXG4gICAgICBuYW1lLFxuICAgICAge2luc3RhbGxUeXBlLCBpbnN0YWxsU3BlYywgaW5zdGFsbGVkLCB1cGRhdGVWZXJzaW9uLCB1bnNhZmVVcGRhdGVWZXJzaW9uLCB2ZXJzaW9uLCB1cFRvRGF0ZX1cbiAgICBdIG9mIF8udG9QYWlycyhleHRzKSkge1xuICAgICAgbGV0IHR5cGVUeHQ7XG4gICAgICBzd2l0Y2ggKGluc3RhbGxUeXBlKSB7XG4gICAgICAgIGNhc2UgSU5TVEFMTF9UWVBFX0dJVDpcbiAgICAgICAgY2FzZSBJTlNUQUxMX1RZUEVfR0lUSFVCOlxuICAgICAgICAgIHR5cGVUeHQgPSBgKGNsb25lZCBmcm9tICR7aW5zdGFsbFNwZWN9KWAueWVsbG93O1xuICAgICAgICAgIGJyZWFrO1xuICAgICAgICBjYXNlIElOU1RBTExfVFlQRV9MT0NBTDpcbiAgICAgICAgICB0eXBlVHh0ID0gYChsaW5rZWQgZnJvbSAke2luc3RhbGxTcGVjfSlgLm1hZ2VudGE7XG4gICAgICAgICAgYnJlYWs7XG4gICAgICAgIGRlZmF1bHQ6XG4gICAgICAgICAgdHlwZVR4dCA9ICcoTlBNKSc7XG4gICAgICB9XG4gICAgICBjb25zdCBpbnN0YWxsVHh0ID0gaW5zdGFsbGVkID9cbiAgICAgICAgYEAke3ZlcnNpb24ueWVsbG93fSAkeygnW2luc3RhbGxlZCAnICsgdHlwZVR4dCArICddJykuZ3JlZW59YCA6XG4gICAgICAgICcgW25vdCBpbnN0YWxsZWRdJy5ncmV5O1xuICAgICAgY29uc3QgdXBkYXRlVHh0ID0gc2hvd1VwZGF0ZXMgJiYgdXBkYXRlVmVyc2lvbiA/XG4gICAgICAgIGAgWyR7dXBkYXRlVmVyc2lvbn0gYXZhaWxhYmxlXWAubWFnZW50YSA6XG4gICAgICAgICcnO1xuICAgICAgY29uc3QgdXBUb0RhdGVUeHQgPSBzaG93VXBkYXRlcyAmJiB1cFRvRGF0ZSA/XG4gICAgICAgIGAgW1VwIHRvIGRhdGVdYC5ncmVlbiA6XG4gICAgICAgICcnO1xuICAgICAgY29uc3QgdW5zYWZlVXBkYXRlVHh0ID0gc2hvd1VwZGF0ZXMgJiYgdW5zYWZlVXBkYXRlVmVyc2lvbiA/XG4gICAgICAgIGAgWyR7dW5zYWZlVXBkYXRlVmVyc2lvbn0gYXZhaWxhYmxlIChwb3RlbnRpYWxseSB1bnNhZmUpXWAuY3lhbiA6XG4gICAgICAgICcnO1xuXG4gICAgICBjb25zb2xlLmxvZyhgLSAke25hbWUueWVsbG93fSR7aW5zdGFsbFR4dH0ke3VwZGF0ZVR4dH0ke3VwVG9EYXRlVHh0fSR7dW5zYWZlVXBkYXRlVHh0fWApO1xuICAgIH1cblxuICAgIHJldHVybiBleHRzO1xuICB9XG5cbiAgLyoqXG4gICAqIEB0eXBlZGVmIHtPYmplY3R9IEluc3RhbGxBcmdzXG4gICAqIEBwcm9wZXJ0eSB7c3RyaW5nfSBleHQgLSB0aGUgbmFtZSBvciBzcGVjIG9mIGFuIGV4dGVuc2lvbiB0byBpbnN0YWxsXG4gICAqIEBwcm9wZXJ0eSB7c3RyaW5nfSBpbnN0YWxsVHlwZSAtIGhvdyB0byBpbnN0YWxsIHRoaXMgZXh0ZW5zaW9uLiBPbmUgb2YgdGhlIElOU1RBTExfVFlQRVNcbiAgICogQHByb3BlcnR5IHtzdHJpbmd9IFtwYWNrYWdlTmFtZV0gLSBmb3IgZ2l0L2dpdGh1YiBpbnN0YWxscywgdGhlIGV4dGVuc2lvbiBub2RlIHBhY2thZ2UgbmFtZVxuICAgKi9cblxuICAvKipcbiAgICogSW5zdGFsbCBhbiBleHRlbnNpb25cbiAgICpcbiAgICogQHBhcmFtIHtJbnN0YWxsQXJnc30gYXJnc1xuICAgKiBAcmV0dXJuIHtvYmplY3R9IG1hcCBvZiBhbGwgaW5zdGFsbGVkIGV4dGVuc2lvbiBuYW1lcyB0byBleHRlbnNpb24gZGF0YVxuICAgKi9cbiAgYXN5bmMgaW5zdGFsbCAoe2V4dCwgaW5zdGFsbFR5cGUsIHBhY2thZ2VOYW1lfSkge1xuICAgIGxvZyh0aGlzLmlzSnNvbk91dHB1dCwgYEF0dGVtcHRpbmcgdG8gZmluZCBhbmQgaW5zdGFsbCAke3RoaXMudHlwZX0gJyR7ZXh0fSdgKTtcblxuICAgIGxldCBleHREYXRhO1xuICAgIGxldCBpbnN0YWxsU3BlYyA9IGV4dDtcblxuICAgIGlmIChwYWNrYWdlTmFtZSAmJiBbSU5TVEFMTF9UWVBFX0xPQ0FMLCBJTlNUQUxMX1RZUEVfTlBNXS5pbmNsdWRlcyhpbnN0YWxsVHlwZSkpIHtcbiAgICAgIHRocm93IG5ldyBFcnJvcihgV2hlbiB1c2luZyAtLXNvdXJjZT0ke2luc3RhbGxUeXBlfSwgY2Fubm90IGFsc28gdXNlIC0tcGFja2FnZWApO1xuICAgIH1cblxuICAgIGlmICghcGFja2FnZU5hbWUgJiYgW0lOU1RBTExfVFlQRV9HSVQsIElOU1RBTExfVFlQRV9HSVRIVUJdLmluY2x1ZGVzKGluc3RhbGxUeXBlKSkge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKGBXaGVuIHVzaW5nIC0tc291cmNlPSR7aW5zdGFsbFR5cGV9LCBtdXN0IGFsc28gdXNlIC0tcGFja2FnZWApO1xuICAgIH1cblxuICAgIGlmIChpbnN0YWxsVHlwZSA9PT0gSU5TVEFMTF9UWVBFX0xPQ0FMKSB7XG4gICAgICBjb25zdCBtc2cgPSBgTGlua2luZyAke3RoaXMudHlwZX0gZnJvbSBsb2NhbCBwYXRoYDtcbiAgICAgIGNvbnN0IHBrZ0pzb25EYXRhID0gYXdhaXQgc3BpbldpdGgodGhpcy5pc0pzb25PdXRwdXQsIG1zZywgYXN5bmMgKCkgPT4gKFxuICAgICAgICBhd2FpdCB0aGlzLm5wbS5saW5rUGFja2FnZShpbnN0YWxsU3BlYykpXG4gICAgICApO1xuICAgICAgZXh0RGF0YSA9IHRoaXMuZ2V0RXh0ZW5zaW9uRmllbGRzKHBrZ0pzb25EYXRhKTtcbiAgICAgIGV4dERhdGEuaW5zdGFsbFBhdGggPSBleHREYXRhLnBrZ05hbWU7XG4gICAgfSBlbHNlIGlmIChpbnN0YWxsVHlwZSA9PT0gSU5TVEFMTF9UWVBFX0dJVEhVQikge1xuICAgICAgaWYgKGluc3RhbGxTcGVjLnNwbGl0KCcvJykubGVuZ3RoICE9PSAyKSB7XG4gICAgICAgIHRocm93IG5ldyBFcnJvcihgR2l0aHViICR7dGhpcy50eXBlfSBzcGVjICR7aW5zdGFsbFNwZWN9IGFwcGVhcmVkIHRvIGJlIGludmFsaWQ7IGAgK1xuICAgICAgICAgICAgICAgICAgICAgICAgJ2l0IHNob3VsZCBiZSBvZiB0aGUgZm9ybSA8b3JnPi88cmVwbz4nKTtcbiAgICAgIH1cbiAgICAgIGV4dERhdGEgPSBhd2FpdCB0aGlzLmluc3RhbGxWaWFOcG0oe2V4dDogaW5zdGFsbFNwZWMsIHBrZ05hbWU6IHBhY2thZ2VOYW1lfSk7XG4gICAgfSBlbHNlIGlmIChpbnN0YWxsVHlwZSA9PT0gSU5TVEFMTF9UWVBFX0dJVCkge1xuICAgICAgLy8gZ2l0IHVybHMgY2FuIGhhdmUgJy5naXQnIGF0IHRoZSBlbmQsIGJ1dCB0aGlzIGlzIG5vdCBuZWNlc3NhcnkgYW5kIHdvdWxkIGNvbXBsaWNhdGUgdGhlXG4gICAgICAvLyB3YXkgd2UgZG93bmxvYWQgYW5kIG5hbWUgZGlyZWN0b3JpZXMsIHNvIHdlIGNhbiBqdXN0IHJlbW92ZSBpdFxuICAgICAgaW5zdGFsbFNwZWMgPSBpbnN0YWxsU3BlYy5yZXBsYWNlKC9cXC5naXQkLywgJycpO1xuICAgICAgZXh0RGF0YSA9IGF3YWl0IHRoaXMuaW5zdGFsbFZpYU5wbSh7ZXh0OiBpbnN0YWxsU3BlYywgcGtnTmFtZTogcGFja2FnZU5hbWV9KTtcbiAgICB9IGVsc2Uge1xuICAgICAgLy8gYXQgdGhpcyBwb2ludCB3ZSBoYXZlIGVpdGhlciBhbiBucG0gcGFja2FnZSBvciBhbiBhcHBpdW0gdmVyaWZpZWQgZXh0ZW5zaW9uXG4gICAgICAvLyBuYW1lLiBib3RoIG9mIHdoaWNoIHdpbGwgYmUgaW5zdGFsbGVkIHZpYSBucG0uXG4gICAgICAvLyBleHRlbnNpb25zIGluc3RhbGxlZCB2aWEgbnBtIGNhbiBpbmNsdWRlIHZlcnNpb25zIG9yIHRhZ3MgYWZ0ZXIgdGhlICdAJ1xuICAgICAgLy8gc2lnbiwgc28gY2hlY2sgZm9yIHRoYXQuIFdlIGFsc28gbmVlZCB0byBiZSBjYXJlZnVsIHRoYXQgcGFja2FnZSBuYW1lcyB0aGVtc2VsdmVzIGNhblxuICAgICAgLy8gY29udGFpbiB0aGUgJ0AnIHN5bWJvbCwgYXMgaW4gYG5wbSBpbnN0YWxsIEBhcHBpdW0vZmFrZS1kcml2ZXJAMS4yLjBgXG4gICAgICBsZXQgbmFtZSwgcGtnVmVyO1xuICAgICAgY29uc3Qgc3BsaXRzID0gaW5zdGFsbFNwZWMuc3BsaXQoJ0AnKTtcbiAgICAgIGlmIChpbnN0YWxsU3BlY1swXSA9PT0gJ0AnKSB7XG4gICAgICAgIC8vIHRoaXMgaXMgdGhlIGNhc2Ugd2hlcmUgd2UgaGF2ZSBhbiBucG0gb3JnIGluY2x1ZGVkIGluIHRoZSBwYWNrYWdlIG5hbWVcbiAgICAgICAgW25hbWUsIHBrZ1Zlcl0gPSBbYEAke3NwbGl0c1sxXX1gLCBzcGxpdHNbMl1dO1xuICAgICAgfSBlbHNlIHtcbiAgICAgICAgLy8gdGhpcyBpcyB0aGUgY2FzZSB3aXRob3V0IGFuIG5wbSBvcmdcbiAgICAgICAgW25hbWUsIHBrZ1Zlcl0gPSBzcGxpdHM7XG4gICAgICB9XG4gICAgICBsZXQgcGtnTmFtZTtcblxuICAgICAgaWYgKGluc3RhbGxUeXBlID09PSBJTlNUQUxMX1RZUEVfTlBNKSB7XG4gICAgICAgIC8vIGlmIHdlJ3JlIGluc3RhbGxpbmcgYSBuYW1lZCBwYWNrYWdlIGZyb20gbnBtLCB3ZSBkb24ndCBuZWVkIHRvIGNoZWNrXG4gICAgICAgIC8vIGFnYWluc3QgdGhlIGFwcGl1bSBleHRlbnNpb24gbGlzdDsganVzdCB1c2UgdGhlIGluc3RhbGxTcGVjIGFzIGlzXG4gICAgICAgIHBrZ05hbWUgPSBuYW1lO1xuICAgICAgfSBlbHNlIHtcbiAgICAgICAgLy8gaWYgd2UncmUgaW5zdGFsbGluZyBhIG5hbWVkIGFwcGl1bSBkcml2ZXIgKGxpa2UgJ3hjdWl0ZXN0Jykgd2UgbmVlZCB0b1xuICAgICAgICAvLyBkZXJlZmVyZW5jZSB0aGUgYWN0dWFsIG5wbSBwYWNrYWdlICgnYXBwaXVwbS14Y3VpdGVzdC1kcml2ZXInKSwgc29cbiAgICAgICAgLy8gY2hlY2sgaXQgZXhpc3RzIGFuZCBnZXQgdGhlIGNvcnJlY3QgcGFja2FnZVxuICAgICAgICBjb25zdCBrbm93bk5hbWVzID0gT2JqZWN0LmtleXModGhpcy5rbm93bkV4dGVuc2lvbnMpO1xuICAgICAgICBpZiAoIV8uaW5jbHVkZXMoa25vd25OYW1lcywgbmFtZSkpIHtcbiAgICAgICAgICBjb25zdCBtc2cgPSBgQ291bGQgbm90IHJlc29sdmUgJHt0aGlzLnR5cGV9OyBhcmUgeW91IHN1cmUgaXQncyBpbiB0aGUgbGlzdCBgICtcbiAgICAgICAgICAgICAgICAgICAgICBgb2Ygc3VwcG9ydGVkICR7dGhpcy50eXBlfXM/ICR7SlNPTi5zdHJpbmdpZnkoa25vd25OYW1lcyl9YDtcbiAgICAgICAgICB0aHJvdyBuZXcgRXJyb3IobXNnKTtcbiAgICAgICAgfVxuICAgICAgICBwa2dOYW1lID0gdGhpcy5rbm93bkV4dGVuc2lvbnNbbmFtZV07XG4gICAgICAgIC8vIGdpdmVuIHRoYXQgd2UnbGwgdXNlIHRoZSBpbnN0YWxsIHR5cGUgaW4gdGhlIGRyaXZlciBqc29uLCBzdG9yZSBpdCBhc1xuICAgICAgICAvLyAnbnBtJyBub3dcbiAgICAgICAgaW5zdGFsbFR5cGUgPSBJTlNUQUxMX1RZUEVfTlBNO1xuICAgICAgfVxuXG4gICAgICBleHREYXRhID0gYXdhaXQgdGhpcy5pbnN0YWxsVmlhTnBtKHtleHQsIHBrZ05hbWUsIHBrZ1Zlcn0pO1xuICAgIH1cblxuICAgIGNvbnN0IGV4dE5hbWUgPSBleHREYXRhW2Ake3RoaXMudHlwZX1OYW1lYF07XG4gICAgZGVsZXRlIGV4dERhdGFbYCR7dGhpcy50eXBlfU5hbWVgXTtcblxuICAgIGlmICh0aGlzLmNvbmZpZy5pc0luc3RhbGxlZChleHROYW1lKSkge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKGBBICR7dGhpcy50eXBlfSBuYW1lZCAnJHtleHROYW1lfScgaXMgYWxyZWFkeSBpbnN0YWxsZWQuIGAgK1xuICAgICAgICAgICAgICAgICAgICAgIGBEaWQgeW91IG1lYW4gdG8gdXBkYXRlPyAnYXBwaXVtICR7dGhpcy50eXBlfSB1cGRhdGUnLiBTZWUgYCArXG4gICAgICAgICAgICAgICAgICAgICAgYGluc3RhbGxlZCAke3RoaXMudHlwZX1zIHdpdGggJ2FwcGl1bSAke3RoaXMudHlwZX0gbGlzdCAtLWluc3RhbGxlZCcuYCk7XG4gICAgfVxuXG4gICAgZXh0RGF0YS5pbnN0YWxsVHlwZSA9IGluc3RhbGxUeXBlO1xuICAgIGV4dERhdGEuaW5zdGFsbFNwZWMgPSBpbnN0YWxsU3BlYztcbiAgICBhd2FpdCB0aGlzLmNvbmZpZy5hZGRFeHRlbnNpb24oZXh0TmFtZSwgZXh0RGF0YSk7XG5cbiAgICAvLyBsb2cgaW5mbyBmb3IgdGhlIHVzZXJcbiAgICBsb2codGhpcy5pc0pzb25PdXRwdXQsIHRoaXMuZ2V0UG9zdEluc3RhbGxUZXh0KHtleHROYW1lLCBleHREYXRhfSkpO1xuXG4gICAgcmV0dXJuIHRoaXMuY29uZmlnLmluc3RhbGxlZEV4dGVuc2lvbnM7XG4gIH1cblxuICAvKipcbiAgICogQHR5cGVkZWYge09iamVjdH0gSW5zdGFsbFZpYU5wbUFyZ3NcbiAgICogQHByb3BlcnR5IHtzdHJpbmd9IGV4dCAtIHRoZSBuYW1lIG9yIHNwZWMgb2YgYW4gZXh0ZW5zaW9uIHRvIGluc3RhbGxcbiAgICogQHByb3BlcnR5IHtzdHJpbmd9IHBrZ05hbWUgLSB0aGUgTlBNIHBhY2thZ2UgbmFtZSBvZiB0aGUgZXh0ZW5zaW9uXG4gICAqIEBwcm9wZXJ0eSB7c3RyaW5nfSBbcGtnVmVyXSAtIHRoZSBzcGVjaWZpYyB2ZXJzaW9uIG9mIHRoZSBOUE0gcGFja2FnZVxuICAgKi9cblxuICAvKipcbiAgICogSW5zdGFsbCBhbiBleHRlbnNpb24gdmlhIE5QTVxuICAgKlxuICAgKiBAcGFyYW0ge0luc3RhbGxWaWFOcG1BcmdzfSBhcmdzXG4gICAqL1xuICBhc3luYyBpbnN0YWxsVmlhTnBtICh7ZXh0LCBwa2dOYW1lLCBwa2dWZXJ9KSB7XG4gICAgY29uc3QgbnBtU3BlYyA9IGAke3BrZ05hbWV9JHtwa2dWZXIgPyAnQCcgKyBwa2dWZXIgOiAnJ31gO1xuICAgIGNvbnN0IHNwZWNNc2cgPSBucG1TcGVjID09PSBleHQgPyAnJyA6IGAgdXNpbmcgTlBNIGluc3RhbGwgc3BlYyAnJHtucG1TcGVjfSdgO1xuICAgIGNvbnN0IG1zZyA9IGBJbnN0YWxsaW5nICcke2V4dH0nJHtzcGVjTXNnfWA7XG4gICAgdHJ5IHtcbiAgICAgIGNvbnN0IHBrZ0pzb25EYXRhID0gYXdhaXQgc3BpbldpdGgodGhpcy5pc0pzb25PdXRwdXQsIG1zZywgYXN5bmMgKCkgPT4gKFxuICAgICAgICBhd2FpdCB0aGlzLm5wbS5pbnN0YWxsUGFja2FnZSh7XG4gICAgICAgICAgcGtnRGlyOiBwYXRoLnJlc29sdmUodGhpcy5jb25maWcuYXBwaXVtSG9tZSwgcGtnTmFtZSksXG4gICAgICAgICAgcGtnTmFtZSxcbiAgICAgICAgICBwa2dWZXJcbiAgICAgICAgfSlcbiAgICAgICkpO1xuICAgICAgY29uc3QgZXh0RGF0YSA9IHRoaXMuZ2V0RXh0ZW5zaW9uRmllbGRzKHBrZ0pzb25EYXRhKTtcbiAgICAgIGV4dERhdGEuaW5zdGFsbFBhdGggPSBwa2dOYW1lO1xuICAgICAgcmV0dXJuIGV4dERhdGE7XG4gICAgfSBjYXRjaCAoZXJyKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoYEVuY291bnRlcmVkIGFuIGVycm9yIHdoZW4gaW5zdGFsbGluZyBwYWNrYWdlOiAke2Vyci5tZXNzYWdlfWApO1xuICAgIH1cbiAgfVxuXG4gIC8qKlxuICAgKiBAdHlwZWRlZiB7T2JqZWN0fSBFeHRlbnNpb25BcmdzXG4gICAqIEBwcm9wZXJ0eSB7c3RyaW5nfSBleHROYW1lIC0gdGhlIG5hbWUgb2YgYW4gZXh0ZW5zaW9uXG4gICAqIEBwcm9wZXJ0eSB7b2JqZWN0fSBleHREYXRhIC0gdGhlIGRhdGEgZm9yIGFuIGluc3RhbGxlZCBleHRlbnNpb25cbiAgICovXG5cbiAgLyoqXG4gICAqIEdldCB0aGUgdGV4dCB3aGljaCBzaG91bGQgYmUgZGlzcGxheWVkIHRvIHRoZSB1c2VyIGFmdGVyIGFuIGV4dGVuc2lvbiBoYXMgYmVlbiBpbnN0YWxsZWQuIFRoaXNcbiAgICogaXMgZGVzaWduZWQgdG8gYmUgb3ZlcnJpZGRlbiBieSBkcml2ZXJzL3BsdWdpbnMgd2l0aCB0aGVpciBvd24gcGFydGljdWxhciB0ZXh0LlxuICAgKlxuICAgKiBAcGFyYW0ge0V4dGVuc2lvbkFyZ3N9IGFyZ3NcbiAgICovXG4gIGdldFBvc3RJbnN0YWxsVGV4dCAoLyp7ZXh0TmFtZSwgZXh0RGF0YX0qLykge1xuICAgIHRocm93IG5ldyBFcnJvcignTXVzdCBiZSBpbXBsZW1lbnRlZCBpbiBmaW5hbCBjbGFzcycpO1xuICB9XG5cbiAgLyoqXG4gICAqIFRha2UgYW4gTlBNIG1vZHVsZSdzIHBhY2thZ2UuanNvbiBhbmQgZXh0cmFjdCBBcHBpdW0gZHJpdmVyIGluZm9ybWF0aW9uIGZyb20gYSBzcGVjaWFsXG4gICAqICdhcHBpdW0nIGZpZWxkIGluIHRoZSBKU09OIGRhdGEuIFdlIG5lZWQgdGhpcyBpbmZvcm1hdGlvbiB0byBlLmcuIGRldGVybWluZSB3aGljaCBjbGFzcyB0b1xuICAgKiBsb2FkIGFzIHRoZSBtYWluIGRyaXZlciBjbGFzcywgb3IgdG8gYmUgYWJsZSB0byBkZXRlY3QgaW5jb21wYXRpYmlsaXRpZXMgYmV0d2VlbiBkcml2ZXIgYW5kXG4gICAqIGFwcGl1bSB2ZXJzaW9ucy5cbiAgICpcbiAgICogQHBhcmFtIHtvYmplY3R9IHBrZ0pzb25EYXRhIC0gdGhlIHBhY2thZ2UuanNvbiBkYXRhIGZvciBhIGRyaXZlciBtb2R1bGUsIGFzIGlmIGl0IGhhZCBiZWVuXG4gICAqIHN0cmFpZ2h0Zm9yd2FyZGx5ICdyZXF1aXJlJ2RcbiAgICovXG4gIGdldEV4dGVuc2lvbkZpZWxkcyAocGtnSnNvbkRhdGEpIHtcbiAgICBpZiAoIXBrZ0pzb25EYXRhLmFwcGl1bSkge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKGBJbnN0YWxsZWQgZHJpdmVyIGRpZCBub3QgaGF2ZSBhbiAnYXBwaXVtJyBzZWN0aW9uIGluIGl0cyBgICtcbiAgICAgICAgICAgICAgICAgICAgICBgcGFja2FnZS5qc29uIGZpbGUgYXMgZXhwZWN0ZWRgKTtcbiAgICB9XG4gICAgY29uc3Qge2FwcGl1bSwgbmFtZSwgdmVyc2lvbn0gPSBwa2dKc29uRGF0YTtcbiAgICB0aGlzLnZhbGlkYXRlRXh0ZW5zaW9uRmllbGRzKGFwcGl1bSk7XG5cbiAgICByZXR1cm4gey4uLmFwcGl1bSwgcGtnTmFtZTogbmFtZSwgdmVyc2lvbn07XG4gIH1cblxuICAvKipcbiAgICogRm9yIGFueSBwYWNrYWdlLmpzb24gZmllbGRzIHdoaWNoIGEgcGFydGljdWxhciB0eXBlIG9mIGV4dGVuc2lvbiByZXF1aXJlcywgdmFsaWRhdGUgdGhlXG4gICAqIHByZXNlbmNlIGFuZCBmb3JtIG9mIHRob3NlIGZpZWxkcyBvbiB0aGUgcGFja2FnZS5qc29uIGRhdGEsIHRocm93aW5nIGFuIGVycm9yIGlmIGFueXRoaW5nIGlzXG4gICAqIGFtaXNzLlxuICAgKlxuICAgKiBAcGFyYW0ge29iamVjdH0gYXBwaXVtUGtnRGF0YSAtIHRoZSBkYXRhIGluIHRoZSBcImFwcGl1bVwiIGZpZWxkIG9mIHBhY2thZ2UuanNvbiBmb3IgYW5cbiAgICogZXh0ZW5zaW9uXG4gICAqL1xuICB2YWxpZGF0ZUV4dGVuc2lvbkZpZWxkcyAoLyphcHBpdW1Qa2dEYXRhKi8pIHtcbiAgICB0aHJvdyBuZXcgRXJyb3IoJ011c3QgYmUgaW1wbGVtZW50ZWQgaW4gZmluYWwgY2xhc3MnKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBAdHlwZWRlZiB7T2JqZWN0fSBVbmluc3RhbGxBcmdzXG4gICAqIEBwcm9wZXJ0eSB7c3RyaW5nfSBleHQgLSB0aGUgbmFtZSBvciBzcGVjIG9mIGFuIGV4dGVuc2lvbiB0byB1bmluc3RhbGxcbiAgICovXG5cbiAgLyoqXG4gICAqIFVuaW5zdGFsbCBhbiBleHRlbnNpb25cbiAgICpcbiAgICogQHBhcmFtIHtVbmluc3RhbGxBcmdzfSBhcmdzXG4gICAqIEByZXR1cm4ge29iamVjdH0gbWFwIG9mIGFsbCBpbnN0YWxsZWQgZXh0ZW5zaW9uIG5hbWVzIHRvIGV4dGVuc2lvbiBkYXRhXG4gICAqL1xuICBhc3luYyB1bmluc3RhbGwgKHtleHR9KSB7XG4gICAgaWYgKCF0aGlzLmNvbmZpZy5pc0luc3RhbGxlZChleHQpKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoYENhbid0IHVuaW5zdGFsbCAke3RoaXMudHlwZX0gJyR7ZXh0fSc7IGl0IGlzIG5vdCBpbnN0YWxsZWRgKTtcbiAgICB9XG4gICAgdHJ5IHtcbiAgICAgIGF3YWl0IGZzLnJpbXJhZih0aGlzLmNvbmZpZy5nZXRJbnN0YWxsUGF0aChleHQpKTtcbiAgICB9IGZpbmFsbHkge1xuICAgICAgYXdhaXQgdGhpcy5jb25maWcucmVtb3ZlRXh0ZW5zaW9uKGV4dCk7XG4gICAgfVxuICAgIGxvZyh0aGlzLmlzSnNvbk91dHB1dCwgYFN1Y2Nlc3NmdWxseSB1bmluc3RhbGxlZCAke3RoaXMudHlwZX0gJyR7ZXh0fSdgLmdyZWVuKTtcbiAgICByZXR1cm4gdGhpcy5jb25maWcuaW5zdGFsbGVkRXh0ZW5zaW9ucztcbiAgfVxuXG4gIC8qKlxuICAgKiBAdHlwZWRlZiB7T2JqZWN0fSBFeHRlbnNpb25VcGRhdGVPcHRzXG4gICAqIEBwcm9wZXJ0eSB7c3RyaW5nfSBleHQgLSB0aGUgbmFtZSBvZiB0aGUgZXh0ZW5zaW9uIHRvIHVwZGF0ZVxuICAgKiBAcHJvcGVydHkge2Jvb2xlYW59IHVuc2FmZSAtIGlmIHRydWUsIHdpbGwgcGVyZm9ybSB1bnNhZmUgdXBkYXRlcyBwYXN0IG1ham9yIHJldmlzaW9uXG4gICAqIGJvdW5kYXJpZXNcbiAgICovXG5cbiAgLyoqXG4gICAqIEB0eXBlZGVmIHtPYmplY3R9IFVwZGF0ZVJlcG9ydFxuICAgKiBAcHJvcGVydHkge3N0cmluZ30gZnJvbSAtIHZlcnNpb24gdXBkYXRlZCBmcm9tXG4gICAqIEBwcm9wZXJ0eSB7c3RyaW5nfSB0byAtIHZlcnNpb24gdXBkYXRlZCB0b1xuICAgKi9cblxuICAvKipcbiAgICogQHR5cGVkZWYge09iamVjdH0gRXh0ZW5zaW9uVXBkYXRlUmVzdWx0XG4gICAqIEBwcm9wZXJ0eSB7T2JqZWN0fSBlcnJvcnMgLSBtYXAgb2YgZXh0IG5hbWVzIHRvIGVycm9yIG9iamVjdHNcbiAgICogQHByb3BlcnR5IHtPYmplY3R9IHVwZGF0ZXMgLSBtYXAgb2YgZXh0IG5hbWVzIHRvIHtAbGluayBVcGRhdGVSZXBvcnR9c1xuICAgKi9cblxuICAvKipcbiAgICogQXR0ZW1wdCB0byB1cGRhdGUgb25lIG9yIG1vcmUgZHJpdmVycyB1c2luZyBOUE1cbiAgICpcbiAgICogQHBhcmFtIHtFeHRlbnNpb25VcGRhdGVPcHRzfSB1cGRhdGVTcGVjXG4gICAqIEByZXR1cm4ge0V4dGVuc2lvblVwZGF0ZVJlc3VsdH1cbiAgICovXG4gIGFzeW5jIHVwZGF0ZSAoe2V4dCwgdW5zYWZlfSkge1xuICAgIGNvbnN0IHNob3VsZFVwZGF0ZUFsbCA9IGV4dCA9PT0gVVBEQVRFX0FMTDtcbiAgICAvLyBpZiB3ZSdyZSBzcGVjaWZpY2FsbHkgcmVxdWVzdGluZyBhbiB1cGRhdGUgZm9yIGFuIGV4dGVuc2lvbiwgbWFrZSBzdXJlIGl0J3MgaW5zdGFsbGVkXG4gICAgaWYgKCFzaG91bGRVcGRhdGVBbGwgJiYgIXRoaXMuY29uZmlnLmlzSW5zdGFsbGVkKGV4dCkpIHtcbiAgICAgIHRocm93IG5ldyBFcnJvcihgVGhlICR7dGhpcy50eXBlfSAnJHtleHR9JyB3YXMgbm90IGluc3RhbGxlZCwgc28gY2FuJ3QgYmUgdXBkYXRlZGApO1xuICAgIH1cbiAgICBjb25zdCBleHRzVG9VcGRhdGUgPSBzaG91bGRVcGRhdGVBbGwgPyBPYmplY3Qua2V5cyh0aGlzLmNvbmZpZy5pbnN0YWxsZWRFeHRlbnNpb25zKSA6IFtleHRdO1xuXG4gICAgLy8gJ2Vycm9ycycgd2lsbCBoYXZlIGV4dCBuYW1lcyBhcyBrZXlzIGFuZCBlcnJvciBvYmplY3RzIGFzIHZhbHVlc1xuICAgIGNvbnN0IGVycm9ycyA9IHt9O1xuXG4gICAgLy8gJ3VwZGF0ZXMnIHdpbGwgaGF2ZSBleHQgbmFtZXMgYXMga2V5cyBhbmQgdXBkYXRlIG9iamVjdHMgYXMgdmFsdWVzLCB3aGVyZSBhbiB1cGRhdGVcbiAgICAvLyBvYmplY3QgaXMgb2YgdGhlIGZvcm0ge2Zyb206IHZlcnNpb25TdHJpbmcsIHRvOiB2ZXJzaW9uU3RyaW5nfVxuICAgIGNvbnN0IHVwZGF0ZXMgPSB7fTtcblxuICAgIGZvciAoY29uc3QgZSBvZiBleHRzVG9VcGRhdGUpIHtcbiAgICAgIHRyeSB7XG4gICAgICAgIGF3YWl0IHNwaW5XaXRoKHRoaXMuaXNKc29uT3V0cHV0LCBgQ2hlY2tpbmcgaWYgJHt0aGlzLnR5cGV9ICcke2V9JyBpcyB1cGRhdGFibGVgLCAoKSA9PiB7XG4gICAgICAgICAgaWYgKHRoaXMuY29uZmlnLmluc3RhbGxlZEV4dGVuc2lvbnNbZV0uaW5zdGFsbFR5cGUgIT09IElOU1RBTExfVFlQRV9OUE0pIHtcbiAgICAgICAgICAgIHRocm93IG5ldyBOb3RVcGRhdGFibGVFcnJvcigpO1xuICAgICAgICAgIH1cbiAgICAgICAgfSk7XG4gICAgICAgIGNvbnN0IHVwZGF0ZSA9IGF3YWl0IHNwaW5XaXRoKHRoaXMuaXNKc29uT3V0cHV0LCBgQ2hlY2tpbmcgaWYgJHt0aGlzLnR5cGV9ICcke2V9JyBuZWVkcyBhbiB1cGRhdGVgLCBhc3luYyAoKSA9PiB7XG4gICAgICAgICAgY29uc3QgdXBkYXRlID0gYXdhaXQgdGhpcy5jaGVja0ZvckV4dGVuc2lvblVwZGF0ZShlKTtcbiAgICAgICAgICBpZiAoISh1cGRhdGUuc2FmZVVwZGF0ZSB8fCB1cGRhdGUudW5zYWZlVXBkYXRlKSkge1xuICAgICAgICAgICAgdGhyb3cgbmV3IE5vVXBkYXRlc0F2YWlsYWJsZUVycm9yKCk7XG4gICAgICAgICAgfVxuICAgICAgICAgIHJldHVybiB1cGRhdGU7XG4gICAgICAgIH0pO1xuICAgICAgICBpZiAoIXVuc2FmZSAmJiAhdXBkYXRlLnNhZmVVcGRhdGUpIHtcbiAgICAgICAgICB0aHJvdyBuZXcgRXJyb3IoYFRoZSAke3RoaXMudHlwZX0gJyR7ZX0nIGhhcyBhIG1ham9yIHJldmlzaW9uIHVwZGF0ZSBgICtcbiAgICAgICAgICAgICAgICAgICAgICAgICAgYCgke3VwZGF0ZS5jdXJyZW50fSA9PiAke3VwZGF0ZS51bnNhZmVVcGRhdGV9KSwgd2hpY2ggY291bGQgaW5jbHVkZSBgICtcbiAgICAgICAgICAgICAgICAgICAgICAgICAgYGJyZWFraW5nIGNoYW5nZXMuIElmIHlvdSB3YW50IHRvIGFwcGx5IHRoaXMgdXBkYXRlLCByZS1ydW4gd2l0aCAtLXVuc2FmZWApO1xuICAgICAgICB9XG4gICAgICAgIGNvbnN0IHVwZGF0ZVZlciA9IHVuc2FmZSAmJiB1cGRhdGUudW5zYWZlVXBkYXRlID8gdXBkYXRlLnVuc2FmZVVwZGF0ZSA6IHVwZGF0ZS5zYWZlVXBkYXRlO1xuICAgICAgICBhd2FpdCBzcGluV2l0aChcbiAgICAgICAgICB0aGlzLmlzSnNvbk91dHB1dCxcbiAgICAgICAgICBgVXBkYXRpbmcgZHJpdmVyICcke2V9JyBmcm9tICR7dXBkYXRlLmN1cnJlbnR9IHRvICR7dXBkYXRlVmVyfWAsXG4gICAgICAgICAgYXN5bmMgKCkgPT4gYXdhaXQgdGhpcy51cGRhdGVFeHRlbnNpb24oZSwgdXBkYXRlVmVyKVxuICAgICAgICApO1xuICAgICAgICB1cGRhdGVzW2VdID0ge2Zyb206IHVwZGF0ZS5jdXJyZW50LCB0bzogdXBkYXRlVmVyfTtcbiAgICAgIH0gY2F0Y2ggKGVycikge1xuICAgICAgICBlcnJvcnNbZV0gPSBlcnI7XG4gICAgICB9XG4gICAgfVxuXG4gICAgbG9nKHRoaXMuaXNKc29uT3V0cHV0LCAnVXBkYXRlIHJlcG9ydDonKTtcbiAgICBmb3IgKGNvbnN0IFtlLCB1cGRhdGVdIG9mIF8udG9QYWlycyh1cGRhdGVzKSkge1xuICAgICAgbG9nKHRoaXMuaXNKc29uT3V0cHV0LCBgLSAke3RoaXMudHlwZX0gJHtlfSB1cGRhdGVkOiAke3VwZGF0ZS5mcm9tfSA9PiAke3VwZGF0ZS50b31gLmdyZWVuKTtcbiAgICB9XG4gICAgZm9yIChjb25zdCBbZSwgZXJyXSBvZiBfLnRvUGFpcnMoZXJyb3JzKSkge1xuICAgICAgaWYgKGVyciBpbnN0YW5jZW9mIE5vdFVwZGF0YWJsZUVycm9yKSB7XG4gICAgICAgIGxvZyh0aGlzLmlzSnNvbk91dHB1dCwgYC0gJyR7ZX0nIHdhcyBub3QgaW5zdGFsbGVkIHZpYSBucG0sIHNvIHdlIGNvdWxkIG5vdCBjaGVjayBgICtcbiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICBgZm9yIHVwZGF0ZXNgLnllbGxvdyk7XG4gICAgICB9IGVsc2UgaWYgKGVyciBpbnN0YW5jZW9mIE5vVXBkYXRlc0F2YWlsYWJsZUVycm9yKSB7XG4gICAgICAgIGxvZyh0aGlzLmlzSnNvbk91dHB1dCwgYC0gJyR7ZX0nIGhhZCBubyB1cGRhdGVzIGF2YWlsYWJsZWAueWVsbG93KTtcbiAgICAgIH0gZWxzZSB7XG4gICAgICAgIC8vIG90aGVyd2lzZSwgbWFrZSBpdCBwb3Agd2l0aCByZWQhXG4gICAgICAgIGxvZyh0aGlzLmlzSnNvbk91dHB1dCwgYC0gJyR7ZX0nIGZhaWxlZCB0byB1cGRhdGU6ICR7ZXJyfWAucmVkKTtcbiAgICAgIH1cbiAgICB9XG5cbiAgICByZXR1cm4ge3VwZGF0ZXMsIGVycm9yc307XG4gIH1cblxuICAvKipcbiAgICogQHR5cGVkZWYgUG9zc2libGVVcGRhdGVzXG4gICAqIEBwcm9wZXJ0eSB7c3RyaW5nfSBjdXJyZW50IC0gY3VycmVudCB2ZXJzaW9uXG4gICAqIEBwcm9wZXJ0eSB7c3RyaW5nfG51bGx9IHNhZmVVcGRhdGUgLSB2ZXJzaW9uIHdlIGNhbiBzYWZlbHkgdXBkYXRlIHRvIGlmIGl0IGV4aXN0cywgb3IgbnVsbFxuICAgKiBAcHJvcGVydHkge3N0cmluZ3xudWxsfSB1bnNhZmVVcGRhdGUgLSB2ZXJzaW9uIHdlIGNhbiB1bnNhZmVseSB1cGRhdGUgdG8gaWYgaXQgZXhpc3RzLCBvciBudWxsXG4gICAqL1xuXG4gIC8qKlxuICAgKiBHaXZlbiBhbiBleHRlbnNpb24gbmFtZSwgZmlndXJlIG91dCB3aGF0IGl0cyBoaWdoZXN0IHBvc3NpYmxlIHZlcnNpb24gdXBncmFkZSBpcywgYW5kIGFsc28gdGhlXG4gICAqIGhpZ2hlc3QgcG9zc2libGUgc2FmZSB1cGdyYWRlLlxuICAgKlxuICAgKiBAcGFyYW0ge3N0cmluZ30gZXh0IC0gbmFtZSBvZiBleHRlbnNpb25cbiAgICogQHJldHVybiB7UG9zc2libGVVcGRhdGVzfVxuICAgKi9cbiAgYXN5bmMgY2hlY2tGb3JFeHRlbnNpb25VcGRhdGUgKGV4dCkge1xuICAgIC8vIFRPRE8gZGVjaWRlIGhvdyB3ZSB3YW50IHRvIGhhbmRsZSBiZXRhIHZlcnNpb25zP1xuICAgIC8vIHRoaXMgaXMgYSBoZWxwZXIgbWV0aG9kLCAnZXh0JyBpcyBhc3N1bWVkIHRvIGFscmVhZHkgYmUgaW5zdGFsbGVkIGhlcmUsIGFuZCBvZiB0aGUgbnBtXG4gICAgLy8gaW5zdGFsbCB0eXBlXG4gICAgY29uc3Qge3ZlcnNpb24sIHBrZ05hbWV9ID0gdGhpcy5jb25maWcuaW5zdGFsbGVkRXh0ZW5zaW9uc1tleHRdO1xuICAgIGxldCB1bnNhZmVVcGRhdGUgPSBhd2FpdCB0aGlzLm5wbS5nZXRMYXRlc3RWZXJzaW9uKHBrZ05hbWUpO1xuICAgIGxldCBzYWZlVXBkYXRlID0gYXdhaXQgdGhpcy5ucG0uZ2V0TGF0ZXN0U2FmZVVwZ3JhZGVWZXJzaW9uKHBrZ05hbWUsIHZlcnNpb24pO1xuICAgIGlmICghdXRpbC5jb21wYXJlVmVyc2lvbnModW5zYWZlVXBkYXRlLCAnPicsIHZlcnNpb24pKSB7XG4gICAgICAvLyB0aGUgbGF0ZXN0IHZlcnNpb24gaXMgbm90IGdyZWF0ZXIgdGhhbiB0aGUgY3VycmVudCB2ZXJzaW9uLCBzbyB0aGVyZSdzIG5vIHBvc3NpYmxlIHVwZGF0ZVxuICAgICAgdW5zYWZlVXBkYXRlID0gbnVsbDtcbiAgICAgIHNhZmVVcGRhdGUgPSBudWxsO1xuICAgIH1cbiAgICBpZiAodW5zYWZlVXBkYXRlICYmIHVuc2FmZVVwZGF0ZSA9PT0gc2FmZVVwZGF0ZSkge1xuICAgICAgLy8gdGhlIGxhdGVzdCB1cGRhdGUgaXMgdGhlIHNhbWUgYXMgdGhlIHNhZmUgdXBkYXRlLCB3aGljaCBtZWFucyBpdCdzIG5vdCBhY3R1YWxseSB1bnNhZmVcbiAgICAgIHVuc2FmZVVwZGF0ZSA9IG51bGw7XG4gICAgfVxuICAgIGlmIChzYWZlVXBkYXRlICYmICF1dGlsLmNvbXBhcmVWZXJzaW9ucyhzYWZlVXBkYXRlLCAnPicsIHZlcnNpb24pKSB7XG4gICAgICAvLyBldmVuIHRoZSBzYWZlIHVwZGF0ZSBpcyBub3QgbGF0ZXIgdGhhbiB0aGUgY3VycmVudCwgc28gaXQgaXMgbm90IGFjdHVhbGx5IGFuIHVwZGF0ZVxuICAgICAgc2FmZVVwZGF0ZSA9IG51bGw7XG4gICAgfVxuICAgIHJldHVybiB7Y3VycmVudDogdmVyc2lvbiwgc2FmZVVwZGF0ZSwgdW5zYWZlVXBkYXRlfTtcbiAgfVxuXG4gIC8qKlxuICAgKiBBY3R1YWxseSB1cGRhdGUgYW4gZXh0ZW5zaW9uIGluc3RhbGxlZCBieSBOUE0sIHVzaW5nIHRoZSBOUE0gY2xpLiBBbmQgdXBkYXRlIHRoZSBpbnN0YWxsYXRpb25cbiAgICogbWFuaWZlc3QuXG4gICAqXG4gICAqIEBwYXJhbSB7c3RyaW5nfSBleHQgLSBuYW1lIG9mIGV4dGVuc2lvbiB0byB1cGRhdGVcbiAgICogQHBhcmFtIHtzdHJpbmd9IHZlcnNpb24gLSB2ZXJzaW9uIHN0cmluZyBpZGVudGlmaWVyIHRvIHVwZGF0ZSBleHRlbnNpb24gdG9cbiAgICovXG4gIGFzeW5jIHVwZGF0ZUV4dGVuc2lvbiAoZXh0LCB2ZXJzaW9uKSB7XG4gICAgY29uc3Qge3BrZ05hbWV9ID0gdGhpcy5jb25maWcuaW5zdGFsbGVkRXh0ZW5zaW9uc1tleHRdO1xuICAgIGF3YWl0IHRoaXMuaW5zdGFsbFZpYU5wbSh7ZXh0LCBwa2dOYW1lLCBwa2dWZXI6IHZlcnNpb259KTtcbiAgICB0aGlzLmNvbmZpZy5pbnN0YWxsZWRFeHRlbnNpb25zW2V4dF0udmVyc2lvbiA9IHZlcnNpb247XG4gICAgYXdhaXQgdGhpcy5jb25maWcud3JpdGUoKTtcbiAgfVxufVxuIl0sImZpbGUiOiJsaWIvY2xpL2V4dGVuc2lvbi1jb21tYW5kLmpzIiwic291cmNlUm9vdCI6Ii4uLy4uLy4uIn0=
+exports.ExtensionCommand = ExtensionCommand;
+exports.default = ExtensionCommand;
+/**
+ * Options for the {@linkcode ExtensionCommand} constructor
+ * @template {ExtensionType} ExtType
+ * @typedef ExtensionCommandOptions
+ * @property {ExtensionConfig<ExtType>} config - the `DriverConfig` or `PluginConfig` instance used for this command
+ * @property {boolean} json - whether the output of this command should be JSON or text
+ */
+/**
+ * Extra stuff about extensions; used indirectly by {@linkcode ExtensionCommand.list}.
+ *
+ * @typedef ExtensionMetadata
+ * @property {boolean} installed - If `true`, the extension is installed
+ * @property {string?} updateVersion - If the extension is installed, the version it can be updated to
+ * @property {string?} unsafeUpdateVersion - Same as above, but a major version bump
+ * @property {boolean} upToDate - If the extension is installed and the latest
+ * @property {string?} updateError - Update check error message (if present)
+ */
+/**
+ * @typedef {import('@appium/types').ExtensionType} ExtensionType
+ * @typedef {import('@appium/types').DriverType} DriverType
+ * @typedef {import('@appium/types').PluginType} PluginType
+ */
+/**
+ * @template {ExtensionType} ExtType
+ * @typedef {import('appium/types').ExtRecord<ExtType>} ExtRecord
+ */
+/**
+ * @template {ExtensionType} ExtType
+ * @typedef {import('../extension/extension-config').ExtensionConfig<ExtType>} ExtensionConfig
+ */
+/**
+ * @template {ExtensionType} ExtType
+ * @typedef {import('appium/types').ExtMetadata<ExtType>} ExtMetadata
+ */
+/**
+ * @template {ExtensionType} ExtType
+ * @typedef {import('appium/types').ExtManifest<ExtType>} ExtManifest
+ */
+/**
+ * @template {ExtensionType} ExtType
+ * @typedef {import('appium/types').ExtPackageJson<ExtType>} ExtPackageJson
+ */
+/**
+ * @template {ExtensionType} ExtType
+ * @typedef {import('appium/types').ExtInstallReceipt<ExtType>} ExtInstallReceipt
+ */
+/**
+ * Possible return value for {@linkcode ExtensionCommand.list}
+ * @typedef {Partial<InstalledExtensionListData> & {pkgName: string, installed: false}} UninstalledExtensionListData
+ */
+/**
+ * Possible return value for {@linkcode ExtensionCommand.list}
+ * @typedef {import('appium/types').InternalMetadata & ExtensionMetadata} InstalledExtensionListData
+ */
+/**
+ * Return value of {@linkcode ExtensionCommand.list}.
+ * @typedef {Record<string,InstalledExtensionListData|UninstalledExtensionListData>} ExtensionListData
+ */
+/**
+ * Options for {@linkcode ExtensionCommand._run}.
+ * @typedef RunOptions
+ * @property {string} installSpec - name of the extension to run a script from
+ * @property {string} scriptName - name of the script to run
+ * @property {string[]} [extraArgs] - arguments to pass to the script
+ */
+/**
+ * Return value of {@linkcode ExtensionCommand._run}
+ *
+ * @typedef RunOutput
+ * @property {string} [error] - error message if script ran unsuccessfully, otherwise undefined
+ * @property {string[]} output - script output
+ */
+/**
+ * Options for {@linkcode ExtensionCommand._update}.
+ * @typedef ExtensionUpdateOpts
+ * @property {string} installSpec - the name of the extension to update
+ * @property {boolean} unsafe - if true, will perform unsafe updates past major revision boundaries
+ */
+/**
+ * Return value of {@linkcode ExtensionCommand._update}.
+ * @typedef ExtensionUpdateResult
+ * @property {Record<string,Error>} errors - map of ext names to error objects
+ * @property {Record<string,UpdateReport>} updates - map of ext names to {@linkcode UpdateReport}s
+ */
+/**
+ * Part of result of {@linkcode ExtensionCommand._update}.
+ * @typedef UpdateReport
+ * @property {string} from - version the extension was updated from
+ * @property {string} to - version the extension was updated to
+ */
+/**
+ * Options for {@linkcode ExtensionCommand._uninstall}.
+ * @typedef UninstallOpts
+ * @property {string} installSpec - the name or spec of an extension to uninstall
+ */
+/**
+ * Used by {@linkcode ExtensionCommand.getPostInstallText}
+ * @typedef ExtensionArgs
+ * @property {string} extName - the name of an extension
+ * @property {object} extData - the data for an installed extension
+ */
+/**
+ * Options for {@linkcode ExtensionCommand.installViaNpm}
+ * @typedef InstallViaNpmArgs
+ * @property {string} installSpec - the name or spec of an extension to install
+ * @property {string} pkgName - the NPM package name of the extension
+ * @property {import('appium/types').InstallType} installType - type of install
+ * @property {string} [pkgVer] - the specific version of the NPM package
+ */
+/**
+ * Object returned by {@linkcode ExtensionCommand.checkForExtensionUpdate}
+ * @typedef PossibleUpdates
+ * @property {string} current - current version
+ * @property {string?} safeUpdate - version we can safely update to if it exists, or null
+ * @property {string?} unsafeUpdate - version we can unsafely update to if it exists, or null
+ */
+/**
+ * Options for {@linkcode ExtensionCommand._install}
+ * @typedef InstallOpts
+ * @property {string} installSpec - the name or spec of an extension to install
+ * @property {InstallType} installType - how to install this extension. One of the INSTALL_TYPES
+ * @property {string} [packageName] - for git/github installs, the extension node package name
+ */
+/**
+ * @template {ExtensionType} ExtType
+ * @typedef {ExtType extends DriverType ? typeof import('../constants').KNOWN_DRIVERS : ExtType extends PluginType ? typeof import('../constants').KNOWN_PLUGINS : never} KnownExtensions
+ */
+/**
+ * @typedef ListOptions
+ * @property {boolean} showInstalled - whether should show only installed extensions
+ * @property {boolean} showUpdates - whether should show available updates
+ */
+/**
+ * Opts for {@linkcode ExtensionCommand.getInstallationReceipt}
+ * @template {ExtensionType} ExtType
+ * @typedef GetInstallationReceiptOpts
+ * @property {string} installPath
+ * @property {string} installSpec
+ * @property {ExtPackageJson<ExtType>} pkg
+ * @property {InstallType} installType
+ */
+/**
+ * @typedef {import('appium/types').InstallType} InstallType
+ */
+//# sourceMappingURL=extension-command.js.map