appium 2.0.0-beta.46 → 2.0.0-beta.47

package/build/lib/cli/args.js.map

@@ -1 +1 @@
-{"version":3,"file":"args.js","names":["DRIVER_EXAMPLE","PLUGIN_EXAMPLE","INSTALL_TYPES_ARRAY","INSTALL_TYPES","EXTENSION_TYPES","Set","DRIVER_TYPE","PLUGIN_TYPE","globalExtensionArgs","Map","required","default","action","help","dest","getExtensionArgs","_","memoize","extensionArgs","type","EXT_SUBCOMMAND_LIST","makeListArgs","EXT_SUBCOMMAND_INSTALL","makeInstallArgs","EXT_SUBCOMMAND_UNINSTALL","makeUninstallArgs","EXT_SUBCOMMAND_UPDATE","makeUpdateArgs","EXT_SUBCOMMAND_RUN","makeRunArgs","choices","join","getServerArgs","toParserArgs","serverArgsDisallowedInConfig","const"],"sources":["../../../lib/cli/args.js"],"sourcesContent":["import _ from 'lodash';\nimport {\n  DRIVER_TYPE,\n  PLUGIN_TYPE,\n  EXT_SUBCOMMAND_INSTALL,\n  EXT_SUBCOMMAND_LIST,\n  EXT_SUBCOMMAND_RUN,\n  EXT_SUBCOMMAND_UNINSTALL,\n  EXT_SUBCOMMAND_UPDATE,\n} from '../constants';\nimport {INSTALL_TYPES} from '../extension/extension-config';\nimport {toParserArgs} from '../schema/cli-args';\nconst DRIVER_EXAMPLE = 'xcuitest';\nconst PLUGIN_EXAMPLE = 'find_by_image';\n\n/**\n * This is necessary because we pass the array into `argparse`. `argparse` is bad and mutates things. We don't want that.\n * Bad `argparse`! Bad!\n */\nconst INSTALL_TYPES_ARRAY = [...INSTALL_TYPES];\n\n/** @type {Set<ExtensionType>} */\nconst EXTENSION_TYPES = new Set([DRIVER_TYPE, PLUGIN_TYPE]);\n\n// this set of args works for both drivers and plugins ('extensions')\n/** @type {ArgumentDefinitions} */\nconst globalExtensionArgs = new Map([\n  [\n    ['--json'],\n    {\n      required: false,\n      default: false,\n      action: 'store_true',\n      help: 'Use JSON for output format',\n      dest: 'json',\n    },\n  ],\n]);\n\n/**\n * Builds a Record of extension types to a Record of subcommands to their argument definitions\n */\nconst getExtensionArgs = _.memoize(function getExtensionArgs() {\n  const extensionArgs = {};\n  for (const type of EXTENSION_TYPES) {\n    extensionArgs[type] = {\n      [EXT_SUBCOMMAND_LIST]: makeListArgs(type),\n      [EXT_SUBCOMMAND_INSTALL]: makeInstallArgs(type),\n      [EXT_SUBCOMMAND_UNINSTALL]: makeUninstallArgs(type),\n      [EXT_SUBCOMMAND_UPDATE]: makeUpdateArgs(type),\n      [EXT_SUBCOMMAND_RUN]: makeRunArgs(type),\n    };\n  }\n  return /** @type {Record<ExtensionType, Record<import('appium/types').CliExtensionSubcommand,ArgumentDefinitions>>} */ (\n    extensionArgs\n  );\n});\n\n/**\n * Makes the opts for the `list` subcommand for each extension type.\n * @param {ExtensionType} type\n * @returns {ArgumentDefinitions}\n */\nfunction makeListArgs(type) {\n  return new Map([\n    ...globalExtensionArgs,\n    [\n      ['--installed'],\n      {\n        required: false,\n        default: false,\n        action: 'store_true',\n        help: `List only installed ${type}s`,\n        dest: 'showInstalled',\n      },\n    ],\n    [\n      ['--updates'],\n      {\n        required: false,\n        default: false,\n        action: 'store_true',\n        help: 'Show information about newer versions',\n        dest: 'showUpdates',\n      },\n    ],\n  ]);\n}\n\n/**\n * Makes the opts for the `install` subcommand for each extension type\n * @param {ExtensionType} type\n * @returns {ArgumentDefinitions}\n */\nfunction makeInstallArgs(type) {\n  return new Map([\n    ...globalExtensionArgs,\n    [\n      [type],\n      {\n        type: 'str',\n        help:\n          `Name of the ${type} to install, for example: ` + type === DRIVER_TYPE\n            ? DRIVER_EXAMPLE\n            : PLUGIN_EXAMPLE,\n      },\n    ],\n    [\n      ['--source'],\n      {\n        required: false,\n        default: null,\n        choices: INSTALL_TYPES_ARRAY,\n        help:\n          `Where to look for the ${type} if it is not one of Appium's verified ` +\n          `${type}s. Possible values: ${INSTALL_TYPES_ARRAY.join(', ')}`,\n        dest: 'installType',\n      },\n    ],\n    [\n      ['--package'],\n      {\n        required: false,\n        default: null,\n        type: 'str',\n        help:\n          `If installing from Git or GitHub, the package name, as defined in the plugin's ` +\n          `package.json file in the \"name\" field, cannot be determined automatically, and ` +\n          `should be reported here, otherwise the install will probably fail.`,\n        dest: 'packageName',\n      },\n    ],\n  ]);\n}\n\n/**\n * Makes the opts for the `uninstall` subcommand for each extension type\n * @param {ExtensionType} type\n * @returns {ArgumentDefinitions}\n */\nfunction makeUninstallArgs(type) {\n  return new Map([\n    ...globalExtensionArgs,\n    [\n      [type],\n      {\n        type: 'str',\n        help:\n          'Name of the driver to uninstall, for example: ' + type === DRIVER_TYPE\n            ? DRIVER_EXAMPLE\n            : PLUGIN_EXAMPLE,\n      },\n    ],\n  ]);\n}\n\n/**\n * Makes the opts for the `update` subcommand for each extension type\n * @param {ExtensionType} type\n * @returns {ArgumentDefinitions}\n */\nfunction makeUpdateArgs(type) {\n  return new Map([\n    ...globalExtensionArgs,\n    [\n      [type],\n      {\n        type: 'str',\n        help:\n          `Name of the ${type} to update, or the word \"installed\" to update all installed ` +\n            `${type}s. To see available updates, run \"appium ${type} list --installed --updates\". ` +\n            'For example: ' +\n            type ===\n          DRIVER_TYPE\n            ? DRIVER_EXAMPLE\n            : PLUGIN_EXAMPLE,\n      },\n    ],\n    [\n      ['--unsafe'],\n      {\n        required: false,\n        default: false,\n        action: 'store_true',\n        help:\n          `Include updates that might have a new major revision, and potentially include ` +\n          `breaking changes`,\n      },\n    ],\n  ]);\n}\n\n/**\n * Makes the opts for the `run` subcommand for each extension type\n * @param {ExtensionType} type\n * @returns {ArgumentDefinitions}\n */\nfunction makeRunArgs(type) {\n  return new Map([\n    ...globalExtensionArgs,\n    [\n      [type],\n      {\n        type: 'str',\n        help:\n          `Name of the ${type} to run a script from, for example: ` + type === DRIVER_TYPE\n            ? DRIVER_EXAMPLE\n            : PLUGIN_EXAMPLE,\n      },\n    ],\n    [\n      ['scriptName'],\n      {\n        default: null,\n        type: 'str',\n        help:\n          `Name of the script to run from the ${type}. The script name must be a key ` +\n          `inside the \"appium.scripts\" field inside the ${type}'s \"package.json\" file`,\n      },\n    ],\n  ]);\n}\n\n/**\n * Derives the options for the `server` command from the schema, and adds the arguments\n * which are disallowed in the config file.\n * @returns {ArgumentDefinitions}\n */\nfunction getServerArgs() {\n  return new Map([...toParserArgs(), ...serverArgsDisallowedInConfig]);\n}\n\n/**\n * These don't make sense in the context of a config file for obvious reasons.\n * @type {ArgumentDefinitions}\n */\nconst serverArgsDisallowedInConfig = new Map([\n  [\n    ['--shell'],\n    {\n      required: false,\n      help: 'Enter REPL mode',\n      action: 'store_const',\n      const: true,\n      dest: 'shell',\n    },\n  ],\n  [\n    ['--show-build-info'],\n    {\n      dest: 'showBuildInfo',\n      action: 'store_const',\n      const: true,\n      required: false,\n      help: 'Show info about the Appium build and exit',\n    },\n  ],\n  [\n    ['--show-config'],\n    {\n      dest: 'showConfig',\n      action: 'store_const',\n      const: true,\n      required: false,\n      help: 'Show the current Appium configuration and exit',\n    },\n  ],\n  [\n    ['--config'],\n    {\n      dest: 'configFile',\n      type: 'string',\n      required: false,\n      help: 'Explicit path to Appium configuration file',\n    },\n  ],\n]);\n\nexport {getServerArgs, getExtensionArgs};\n\n/**\n * @typedef {import('@appium/types').ExtensionType} ExtensionType\n */\n\n/**\n * A tuple of argument aliases and argument options\n * @typedef {Map<string[],import('argparse').ArgumentOptions>} ArgumentDefinitions\n */\n"],"mappings":"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"}
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../../lib/cli/args.js"],"names":[],"mappings":"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"}

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

@@ -1,94 +1,69 @@
 "use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-
-require("source-map-support/register");
-
-var _lodash = _interopRequireDefault(require("lodash"));
-
-var _extensionCommand = _interopRequireDefault(require("./extension-command"));
-
-var _constants = require("../constants");
-
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const lodash_1 = __importDefault(require("lodash"));
+const extension_command_1 = __importDefault(require("./extension-command"));
+const constants_1 = require("../constants");
 require("@colors/colors");
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
 const REQ_DRIVER_FIELDS = ['driverName', 'automationName', 'platformNames', 'mainClass'];
-
-class DriverCommand extends _extensionCommand.default {
-  constructor({
-    config,
-    json
-  }) {
-    super({
-      config,
-      json
-    });
-    this.knownExtensions = _constants.KNOWN_DRIVERS;
-  }
-
-  async install({
-    driver,
-    installType,
-    packageName
-  }) {
-    return await super._install({
-      installSpec: driver,
-      installType,
-      packageName
-    });
-  }
-
-  async uninstall({
-    driver
-  }) {
-    return await super._uninstall({
-      installSpec: driver
-    });
-  }
-
-  async update({
-    driver,
-    unsafe
-  }) {
-    return await super._update({
-      installSpec: driver,
-      unsafe
-    });
-  }
-
-  async run({
-    driver,
-    scriptName,
-    extraArgs
-  }) {
-    return await super._run({
-      installSpec: driver,
-      scriptName,
-      extraArgs
-    });
-  }
-
-  getPostInstallText({
-    extName,
-    extData
-  }) {
-    return `Driver ${extName}@${extData.version} successfully installed\n`.green + `- automationName: ${extData.automationName.green}\n` + `- platformNames: ${JSON.stringify(extData.platformNames).green}`;
-  }
-
-  validateExtensionFields(driverMetadata, installSpec) {
-    const missingFields = REQ_DRIVER_FIELDS.reduce((acc, field) => driverMetadata[field] ? acc : [...acc, field], []);
-
-    if (!_lodash.default.isEmpty(missingFields)) {
-      throw new Error(`Driver "${installSpec}" did not expose correct fields for compability ` + `with Appium. Missing fields: ${JSON.stringify(missingFields)}`);
+/**
+ * @extends {ExtensionCommand<DriverType>}
+ */
+class DriverCommand extends extension_command_1.default {
+    /**
+     * @param {import('./extension-command').ExtensionCommandOptions<DriverType>} opts
+     */
+    constructor({ config, json }) {
+        super({ config, json });
+        this.knownExtensions = constants_1.KNOWN_DRIVERS;
+    }
+    async install({ driver, installType, packageName }) {
+        return await super._install({
+            installSpec: driver,
+            installType,
+            packageName,
+        });
+    }
+    async uninstall({ driver }) {
+        return await super._uninstall({ installSpec: driver });
+    }
+    async update({ driver, unsafe }) {
+        return await super._update({ installSpec: driver, unsafe });
+    }
+    async run({ driver, scriptName, extraArgs }) {
+        return await super._run({ installSpec: driver, scriptName, extraArgs });
+    }
+    getPostInstallText({ extName, extData }) {
+        return (`Driver ${extName}@${extData.version} successfully installed\n`.green +
+            `- automationName: ${extData.automationName.green}\n` +
+            `- platformNames: ${JSON.stringify(extData.platformNames).green}`);
+    }
+    /**
+     * Validates fields in `appium` field of `driverMetadata`
+     *
+     * For any `package.json` fields which a driver requires, validate the type of
+     * those fields on the `package.json` data, throwing an error if anything is
+     * amiss.
+     * @param {import('appium/types').ExtMetadata<DriverType>} driverMetadata
+     * @param {string} installSpec
+     */
+    validateExtensionFields(driverMetadata, installSpec) {
+        const missingFields = REQ_DRIVER_FIELDS.reduce((acc, field) => (driverMetadata[field] ? acc : [...acc, field]), []);
+        if (!lodash_1.default.isEmpty(missingFields)) {
+            throw new Error(`Driver "${installSpec}" did not expose correct fields for compability ` +
+                `with Appium. Missing fields: ${JSON.stringify(missingFields)}`);
+        }
     }
-  }
-
 }
-
 exports.default = DriverCommand;
-//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJuYW1lcyI6WyJSRVFfRFJJVkVSX0ZJRUxEUyIsIkRyaXZlckNvbW1hbmQiLCJFeHRlbnNpb25Db21tYW5kIiwiY29uc3RydWN0b3IiLCJjb25maWciLCJqc29uIiwia25vd25FeHRlbnNpb25zIiwiS05PV05fRFJJVkVSUyIsImluc3RhbGwiLCJkcml2ZXIiLCJpbnN0YWxsVHlwZSIsInBhY2thZ2VOYW1lIiwiX2luc3RhbGwiLCJpbnN0YWxsU3BlYyIsInVuaW5zdGFsbCIsIl91bmluc3RhbGwiLCJ1cGRhdGUiLCJ1bnNhZmUiLCJfdXBkYXRlIiwicnVuIiwic2NyaXB0TmFtZSIsImV4dHJhQXJncyIsIl9ydW4iLCJnZXRQb3N0SW5zdGFsbFRleHQiLCJleHROYW1lIiwiZXh0RGF0YSIsInZlcnNpb24iLCJncmVlbiIsImF1dG9tYXRpb25OYW1lIiwiSlNPTiIsInN0cmluZ2lmeSIsInBsYXRmb3JtTmFtZXMiLCJ2YWxpZGF0ZUV4dGVuc2lvbkZpZWxkcyIsImRyaXZlck1ldGFkYXRhIiwibWlzc2luZ0ZpZWxkcyIsInJlZHVjZSIsImFjYyIsImZpZWxkIiwiXyIsImlzRW1wdHkiLCJFcnJvciJdLCJzb3VyY2VzIjpbIi4uLy4uLy4uL2xpYi9jbGkvZHJpdmVyLWNvbW1hbmQuanMiXSwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IF8gZnJvbSAnbG9kYXNoJztcbmltcG9ydCBFeHRlbnNpb25Db21tYW5kIGZyb20gJy4vZXh0ZW5zaW9uLWNvbW1hbmQnO1xuaW1wb3J0IHtLTk9XTl9EUklWRVJTfSBmcm9tICcuLi9jb25zdGFudHMnO1xuaW1wb3J0ICdAY29sb3JzL2NvbG9ycyc7XG5cbmNvbnN0IFJFUV9EUklWRVJfRklFTERTID0gWydkcml2ZXJOYW1lJywgJ2F1dG9tYXRpb25OYW1lJywgJ3BsYXRmb3JtTmFtZXMnLCAnbWFpbkNsYXNzJ107XG5cbi8qKlxuICogQGV4dGVuZHMge0V4dGVuc2lvbkNvbW1hbmQ8RHJpdmVyVHlwZT59XG4gKi9cbmV4cG9ydCBkZWZhdWx0IGNsYXNzIERyaXZlckNvbW1hbmQgZXh0ZW5kcyBFeHRlbnNpb25Db21tYW5kIHtcbiAgLyoqXG4gICAqIEBwYXJhbSB7aW1wb3J0KCcuL2V4dGVuc2lvbi1jb21tYW5kJykuRXh0ZW5zaW9uQ29tbWFuZE9wdGlvbnM8RHJpdmVyVHlwZT59IG9wdHNcbiAgICovXG4gIGNvbnN0cnVjdG9yKHtjb25maWcsIGpzb259KSB7XG4gICAgc3VwZXIoe2NvbmZpZywganNvbn0pO1xuICAgIHRoaXMua25vd25FeHRlbnNpb25zID0gS05PV05fRFJJVkVSUztcbiAgfVxuXG4gIGFzeW5jIGluc3RhbGwoe2RyaXZlciwgaW5zdGFsbFR5cGUsIHBhY2thZ2VOYW1lfSkge1xuICAgIHJldHVybiBhd2FpdCBzdXBlci5faW5zdGFsbCh7XG4gICAgICBpbnN0YWxsU3BlYzogZHJpdmVyLFxuICAgICAgaW5zdGFsbFR5cGUsXG4gICAgICBwYWNrYWdlTmFtZSxcbiAgICB9KTtcbiAgfVxuXG4gIGFzeW5jIHVuaW5zdGFsbCh7ZHJpdmVyfSkge1xuICAgIHJldHVybiBhd2FpdCBzdXBlci5fdW5pbnN0YWxsKHtpbnN0YWxsU3BlYzogZHJpdmVyfSk7XG4gIH1cblxuICBhc3luYyB1cGRhdGUoe2RyaXZlciwgdW5zYWZlfSkge1xuICAgIHJldHVybiBhd2FpdCBzdXBlci5fdXBkYXRlKHtpbnN0YWxsU3BlYzogZHJpdmVyLCB1bnNhZmV9KTtcbiAgfVxuXG4gIGFzeW5jIHJ1bih7ZHJpdmVyLCBzY3JpcHROYW1lLCBleHRyYUFyZ3N9KSB7XG4gICAgcmV0dXJuIGF3YWl0IHN1cGVyLl9ydW4oe2luc3RhbGxTcGVjOiBkcml2ZXIsIHNjcmlwdE5hbWUsIGV4dHJhQXJnc30pO1xuICB9XG5cbiAgZ2V0UG9zdEluc3RhbGxUZXh0KHtleHROYW1lLCBleHREYXRhfSkge1xuICAgIHJldHVybiAoXG4gICAgICBgRHJpdmVyICR7ZXh0TmFtZX1AJHtleHREYXRhLnZlcnNpb259IHN1Y2Nlc3NmdWxseSBpbnN0YWxsZWRcXG5gLmdyZWVuICtcbiAgICAgIGAtIGF1dG9tYXRpb25OYW1lOiAke2V4dERhdGEuYXV0b21hdGlvbk5hbWUuZ3JlZW59XFxuYCArXG4gICAgICBgLSBwbGF0Zm9ybU5hbWVzOiAke0pTT04uc3RyaW5naWZ5KGV4dERhdGEucGxhdGZvcm1OYW1lcykuZ3JlZW59YFxuICAgICk7XG4gIH1cblxuICAvKipcbiAgICogVmFsaWRhdGVzIGZpZWxkcyBpbiBgYXBwaXVtYCBmaWVsZCBvZiBgZHJpdmVyTWV0YWRhdGFgXG4gICAqXG4gICAqIEZvciBhbnkgYHBhY2thZ2UuanNvbmAgZmllbGRzIHdoaWNoIGEgZHJpdmVyIHJlcXVpcmVzLCB2YWxpZGF0ZSB0aGUgdHlwZSBvZlxuICAgKiB0aG9zZSBmaWVsZHMgb24gdGhlIGBwYWNrYWdlLmpzb25gIGRhdGEsIHRocm93aW5nIGFuIGVycm9yIGlmIGFueXRoaW5nIGlzXG4gICAqIGFtaXNzLlxuICAgKiBAcGFyYW0ge2ltcG9ydCgnYXBwaXVtL3R5cGVzJykuRXh0TWV0YWRhdGE8RHJpdmVyVHlwZT59IGRyaXZlck1ldGFkYXRhXG4gICAqIEBwYXJhbSB7c3RyaW5nfSBpbnN0YWxsU3BlY1xuICAgKi9cbiAgdmFsaWRhdGVFeHRlbnNpb25GaWVsZHMoZHJpdmVyTWV0YWRhdGEsIGluc3RhbGxTcGVjKSB7XG4gICAgY29uc3QgbWlzc2luZ0ZpZWxkcyA9IFJFUV9EUklWRVJfRklFTERTLnJlZHVjZShcbiAgICAgIChhY2MsIGZpZWxkKSA9PiAoZHJpdmVyTWV0YWRhdGFbZmllbGRdID8gYWNjIDogWy4uLmFjYywgZmllbGRdKSxcbiAgICAgIFtdXG4gICAgKTtcblxuICAgIGlmICghXy5pc0VtcHR5KG1pc3NpbmdGaWVsZHMpKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoXG4gICAgICAgIGBEcml2ZXIgXCIke2luc3RhbGxTcGVjfVwiIGRpZCBub3QgZXhwb3NlIGNvcnJlY3QgZmllbGRzIGZvciBjb21wYWJpbGl0eSBgICtcbiAgICAgICAgICBgd2l0aCBBcHBpdW0uIE1pc3NpbmcgZmllbGRzOiAke0pTT04uc3RyaW5naWZ5KG1pc3NpbmdGaWVsZHMpfWBcbiAgICAgICk7XG4gICAgfVxuICB9XG59XG5cbi8qKlxuICogQHR5cGVkZWYgRHJpdmVyQ29tbWFuZE9wdGlvbnNcbiAqIEBwcm9wZXJ0eSB7aW1wb3J0KCcuLi9leHRlbnNpb24vZXh0ZW5zaW9uLWNvbmZpZycpLkV4dGVuc2lvbkNvbmZpZzxEcml2ZXJUeXBlPn0gY29uZmlnXG4gKiBAcHJvcGVydHkge2Jvb2xlYW59IGpzb25cbiAqL1xuXG4vKipcbiAqIEB0eXBlZGVmIHtpbXBvcnQoJ0BhcHBpdW0vdHlwZXMnKS5Ecml2ZXJUeXBlfSBEcml2ZXJUeXBlXG4gKi9cbiJdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7O0FBQUE7O0FBQ0E7O0FBQ0E7O0FBQ0E7Ozs7QUFFQSxNQUFNQSxpQkFBaUIsR0FBRyxDQUFDLFlBQUQsRUFBZSxnQkFBZixFQUFpQyxlQUFqQyxFQUFrRCxXQUFsRCxDQUExQjs7QUFLZSxNQUFNQyxhQUFOLFNBQTRCQyx5QkFBNUIsQ0FBNkM7RUFJMURDLFdBQVcsQ0FBQztJQUFDQyxNQUFEO0lBQVNDO0VBQVQsQ0FBRCxFQUFpQjtJQUMxQixNQUFNO01BQUNELE1BQUQ7TUFBU0M7SUFBVCxDQUFOO0lBQ0EsS0FBS0MsZUFBTCxHQUF1QkMsd0JBQXZCO0VBQ0Q7O0VBRVksTUFBUEMsT0FBTyxDQUFDO0lBQUNDLE1BQUQ7SUFBU0MsV0FBVDtJQUFzQkM7RUFBdEIsQ0FBRCxFQUFxQztJQUNoRCxPQUFPLE1BQU0sTUFBTUMsUUFBTixDQUFlO01BQzFCQyxXQUFXLEVBQUVKLE1BRGE7TUFFMUJDLFdBRjBCO01BRzFCQztJQUgwQixDQUFmLENBQWI7RUFLRDs7RUFFYyxNQUFURyxTQUFTLENBQUM7SUFBQ0w7RUFBRCxDQUFELEVBQVc7SUFDeEIsT0FBTyxNQUFNLE1BQU1NLFVBQU4sQ0FBaUI7TUFBQ0YsV0FBVyxFQUFFSjtJQUFkLENBQWpCLENBQWI7RUFDRDs7RUFFVyxNQUFOTyxNQUFNLENBQUM7SUFBQ1AsTUFBRDtJQUFTUTtFQUFULENBQUQsRUFBbUI7SUFDN0IsT0FBTyxNQUFNLE1BQU1DLE9BQU4sQ0FBYztNQUFDTCxXQUFXLEVBQUVKLE1BQWQ7TUFBc0JRO0lBQXRCLENBQWQsQ0FBYjtFQUNEOztFQUVRLE1BQUhFLEdBQUcsQ0FBQztJQUFDVixNQUFEO0lBQVNXLFVBQVQ7SUFBcUJDO0VBQXJCLENBQUQsRUFBa0M7SUFDekMsT0FBTyxNQUFNLE1BQU1DLElBQU4sQ0FBVztNQUFDVCxXQUFXLEVBQUVKLE1BQWQ7TUFBc0JXLFVBQXRCO01BQWtDQztJQUFsQyxDQUFYLENBQWI7RUFDRDs7RUFFREUsa0JBQWtCLENBQUM7SUFBQ0MsT0FBRDtJQUFVQztFQUFWLENBQUQsRUFBcUI7SUFDckMsT0FDRyxVQUFTRCxPQUFRLElBQUdDLE9BQU8sQ0FBQ0MsT0FBUSwyQkFBckMsQ0FBZ0VDLEtBQWhFLEdBQ0MscUJBQW9CRixPQUFPLENBQUNHLGNBQVIsQ0FBdUJELEtBQU0sSUFEbEQsR0FFQyxvQkFBbUJFLElBQUksQ0FBQ0MsU0FBTCxDQUFlTCxPQUFPLENBQUNNLGFBQXZCLEVBQXNDSixLQUFNLEVBSGxFO0VBS0Q7O0VBV0RLLHVCQUF1QixDQUFDQyxjQUFELEVBQWlCcEIsV0FBakIsRUFBOEI7SUFDbkQsTUFBTXFCLGFBQWEsR0FBR2xDLGlCQUFpQixDQUFDbUMsTUFBbEIsQ0FDcEIsQ0FBQ0MsR0FBRCxFQUFNQyxLQUFOLEtBQWlCSixjQUFjLENBQUNJLEtBQUQsQ0FBZCxHQUF3QkQsR0FBeEIsR0FBOEIsQ0FBQyxHQUFHQSxHQUFKLEVBQVNDLEtBQVQsQ0FEM0IsRUFFcEIsRUFGb0IsQ0FBdEI7O0lBS0EsSUFBSSxDQUFDQyxlQUFBLENBQUVDLE9BQUYsQ0FBVUwsYUFBVixDQUFMLEVBQStCO01BQzdCLE1BQU0sSUFBSU0sS0FBSixDQUNILFdBQVUzQixXQUFZLGtEQUF2QixHQUNHLGdDQUErQmdCLElBQUksQ0FBQ0MsU0FBTCxDQUFlSSxhQUFmLENBQThCLEVBRjVELENBQU47SUFJRDtFQUNGOztBQTFEeUQifQ==
+/**
+ * @typedef DriverCommandOptions
+ * @property {import('../extension/extension-config').ExtensionConfig<DriverType>} config
+ * @property {boolean} json
+ */
+/**
+ * @typedef {import('@appium/types').DriverType} DriverType
+ */
+//# sourceMappingURL=driver-command.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"driver-command.js","names":["REQ_DRIVER_FIELDS","DriverCommand","ExtensionCommand","constructor","config","json","knownExtensions","KNOWN_DRIVERS","install","driver","installType","packageName","_install","installSpec","uninstall","_uninstall","update","unsafe","_update","run","scriptName","extraArgs","_run","getPostInstallText","extName","extData","version","green","automationName","JSON","stringify","platformNames","validateExtensionFields","driverMetadata","missingFields","reduce","acc","field","_","isEmpty","Error"],"sources":["../../../lib/cli/driver-command.js"],"sourcesContent":["import _ from 'lodash';\nimport ExtensionCommand from './extension-command';\nimport {KNOWN_DRIVERS} from '../constants';\nimport '@colors/colors';\n\nconst REQ_DRIVER_FIELDS = ['driverName', 'automationName', 'platformNames', 'mainClass'];\n\n/**\n * @extends {ExtensionCommand<DriverType>}\n */\nexport default class DriverCommand extends ExtensionCommand {\n  /**\n   * @param {import('./extension-command').ExtensionCommandOptions<DriverType>} opts\n   */\n  constructor({config, json}) {\n    super({config, json});\n    this.knownExtensions = KNOWN_DRIVERS;\n  }\n\n  async install({driver, installType, packageName}) {\n    return await super._install({\n      installSpec: driver,\n      installType,\n      packageName,\n    });\n  }\n\n  async uninstall({driver}) {\n    return await super._uninstall({installSpec: driver});\n  }\n\n  async update({driver, unsafe}) {\n    return await super._update({installSpec: driver, unsafe});\n  }\n\n  async run({driver, scriptName, extraArgs}) {\n    return await super._run({installSpec: driver, scriptName, extraArgs});\n  }\n\n  getPostInstallText({extName, extData}) {\n    return (\n      `Driver ${extName}@${extData.version} successfully installed\\n`.green +\n      `- automationName: ${extData.automationName.green}\\n` +\n      `- platformNames: ${JSON.stringify(extData.platformNames).green}`\n    );\n  }\n\n  /**\n   * Validates fields in `appium` field of `driverMetadata`\n   *\n   * For any `package.json` fields which a driver requires, validate the type of\n   * those fields on the `package.json` data, throwing an error if anything is\n   * amiss.\n   * @param {import('appium/types').ExtMetadata<DriverType>} driverMetadata\n   * @param {string} installSpec\n   */\n  validateExtensionFields(driverMetadata, installSpec) {\n    const missingFields = REQ_DRIVER_FIELDS.reduce(\n      (acc, field) => (driverMetadata[field] ? acc : [...acc, field]),\n      []\n    );\n\n    if (!_.isEmpty(missingFields)) {\n      throw new Error(\n        `Driver \"${installSpec}\" did not expose correct fields for compability ` +\n          `with Appium. Missing fields: ${JSON.stringify(missingFields)}`\n      );\n    }\n  }\n}\n\n/**\n * @typedef DriverCommandOptions\n * @property {import('../extension/extension-config').ExtensionConfig<DriverType>} config\n * @property {boolean} json\n */\n\n/**\n * @typedef {import('@appium/types').DriverType} DriverType\n */\n"],"mappings":";;;;;;;;;AAAA;;AACA;;AACA;;AACA;;;;AAEA,MAAMA,iBAAiB,GAAG,CAAC,YAAD,EAAe,gBAAf,EAAiC,eAAjC,EAAkD,WAAlD,CAA1B;;AAKe,MAAMC,aAAN,SAA4BC,yBAA5B,CAA6C;EAI1DC,WAAW,CAAC;IAACC,MAAD;IAASC;EAAT,CAAD,EAAiB;IAC1B,MAAM;MAACD,MAAD;MAASC;IAAT,CAAN;IACA,KAAKC,eAAL,GAAuBC,wBAAvB;EACD;;EAEY,MAAPC,OAAO,CAAC;IAACC,MAAD;IAASC,WAAT;IAAsBC;EAAtB,CAAD,EAAqC;IAChD,OAAO,MAAM,MAAMC,QAAN,CAAe;MAC1BC,WAAW,EAAEJ,MADa;MAE1BC,WAF0B;MAG1BC;IAH0B,CAAf,CAAb;EAKD;;EAEc,MAATG,SAAS,CAAC;IAACL;EAAD,CAAD,EAAW;IACxB,OAAO,MAAM,MAAMM,UAAN,CAAiB;MAACF,WAAW,EAAEJ;IAAd,CAAjB,CAAb;EACD;;EAEW,MAANO,MAAM,CAAC;IAACP,MAAD;IAASQ;EAAT,CAAD,EAAmB;IAC7B,OAAO,MAAM,MAAMC,OAAN,CAAc;MAACL,WAAW,EAAEJ,MAAd;MAAsBQ;IAAtB,CAAd,CAAb;EACD;;EAEQ,MAAHE,GAAG,CAAC;IAACV,MAAD;IAASW,UAAT;IAAqBC;EAArB,CAAD,EAAkC;IACzC,OAAO,MAAM,MAAMC,IAAN,CAAW;MAACT,WAAW,EAAEJ,MAAd;MAAsBW,UAAtB;MAAkCC;IAAlC,CAAX,CAAb;EACD;;EAEDE,kBAAkB,CAAC;IAACC,OAAD;IAAUC;EAAV,CAAD,EAAqB;IACrC,OACG,UAASD,OAAQ,IAAGC,OAAO,CAACC,OAAQ,2BAArC,CAAgEC,KAAhE,GACC,qBAAoBF,OAAO,CAACG,cAAR,CAAuBD,KAAM,IADlD,GAEC,oBAAmBE,IAAI,CAACC,SAAL,CAAeL,OAAO,CAACM,aAAvB,EAAsCJ,KAAM,EAHlE;EAKD;;EAWDK,uBAAuB,CAACC,cAAD,EAAiBpB,WAAjB,EAA8B;IACnD,MAAMqB,aAAa,GAAGlC,iBAAiB,CAACmC,MAAlB,CACpB,CAACC,GAAD,EAAMC,KAAN,KAAiBJ,cAAc,CAACI,KAAD,CAAd,GAAwBD,GAAxB,GAA8B,CAAC,GAAGA,GAAJ,EAASC,KAAT,CAD3B,EAEpB,EAFoB,CAAtB;;IAKA,IAAI,CAACC,eAAA,CAAEC,OAAF,CAAUL,aAAV,CAAL,EAA+B;MAC7B,MAAM,IAAIM,KAAJ,CACH,WAAU3B,WAAY,kDAAvB,GACG,gCAA+BgB,IAAI,CAACC,SAAL,CAAeI,aAAf,CAA8B,EAF5D,CAAN;IAID;EACF;;AA1DyD"}
+{"version":3,"file":"driver-command.js","sourceRoot":"","sources":["../../../lib/cli/driver-command.js"],"names":[],"mappings":";;;;;AAAA,oDAAuB;AACvB,4EAAmD;AACnD,4CAA2C;AAC3C,0BAAwB;AAExB,MAAM,iBAAiB,GAAG,CAAC,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,WAAW,CAAC,CAAC;AAEzF;;GAEG;AACH,MAAqB,aAAc,SAAQ,2BAAgB;IACzD;;OAEG;IACH,YAAY,EAAC,MAAM,EAAE,IAAI,EAAC;QACxB,KAAK,CAAC,EAAC,MAAM,EAAE,IAAI,EAAC,CAAC,CAAC;QACtB,IAAI,CAAC,eAAe,GAAG,yBAAa,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,EAAC,MAAM,EAAE,WAAW,EAAE,WAAW,EAAC;QAC9C,OAAO,MAAM,KAAK,CAAC,QAAQ,CAAC;YAC1B,WAAW,EAAE,MAAM;YACnB,WAAW;YACX,WAAW;SACZ,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,EAAC,MAAM,EAAC;QACtB,OAAO,MAAM,KAAK,CAAC,UAAU,CAAC,EAAC,WAAW,EAAE,MAAM,EAAC,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAC,MAAM,EAAE,MAAM,EAAC;QAC3B,OAAO,MAAM,KAAK,CAAC,OAAO,CAAC,EAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAC,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAC;QACvC,OAAO,MAAM,KAAK,CAAC,IAAI,CAAC,EAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAC,CAAC,CAAC;IACxE,CAAC;IAED,kBAAkB,CAAC,EAAC,OAAO,EAAE,OAAO,EAAC;QACnC,OAAO,CACL,UAAU,OAAO,IAAI,OAAO,CAAC,OAAO,2BAA2B,CAAC,KAAK;YACrE,qBAAqB,OAAO,CAAC,cAAc,CAAC,KAAK,IAAI;YACrD,oBAAoB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,KAAK,EAAE,CAClE,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,uBAAuB,CAAC,cAAc,EAAE,WAAW;QACjD,MAAM,aAAa,GAAG,iBAAiB,CAAC,MAAM,CAC5C,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC,EAC/D,EAAE,CACH,CAAC;QAEF,IAAI,CAAC,gBAAC,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE;YAC7B,MAAM,IAAI,KAAK,CACb,WAAW,WAAW,kDAAkD;gBACtE,gCAAgC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,CAClE,CAAC;SACH;IACH,CAAC;CACF;AA3DD,gCA2DC;AAED;;;;GAIG;AAEH;;GAEG"}

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

@@ -32,6 +32,10 @@ export type ExtensionMetadata = {
      * - If the extension is installed and the latest
      */
     upToDate: boolean;
+    /**
+     * - Update check error message (if present)
+     */
+    updateError: string | null;
 };
 export type ExtensionType = import('@appium/types').ExtensionType;
 export type DriverType = import('@appium/types').DriverType;
@@ -41,6 +45,7 @@ export type ExtensionConfig<ExtType extends import("@appium/types").ExtensionTyp
 export type ExtMetadata<ExtType extends import("@appium/types").ExtensionType> = import('appium/types').ExtMetadata<ExtType>;
 export type ExtManifest<ExtType extends import("@appium/types").ExtensionType> = import('appium/types').ExtManifest<ExtType>;
 export type ExtPackageJson<ExtType extends import("@appium/types").ExtensionType> = import('appium/types').ExtPackageJson<ExtType>;
+export type ExtInstallReceipt<ExtType extends import("@appium/types").ExtensionType> = import('appium/types').ExtInstallReceipt<ExtType>;
 /**
  * Possible return value for {@linkcode ExtensionCommand.list }
  */
@@ -159,6 +164,10 @@ export type InstallViaNpmArgs = {
      * - the NPM package name of the extension
      */
     pkgName: string;
+    /**
+     * - type of install
+     */
+    installType: import('appium/types').InstallType;
     /**
      * - the specific version of the NPM package
      */
@@ -184,7 +193,7 @@ export type PossibleUpdates = {
 /**
  * Options for {@linkcode ExtensionCommand._install }
  */
-export type InstallArgs = {
+export type InstallOpts = {
     /**
      * - the name or spec of an extension to install
      */
@@ -192,20 +201,12 @@ export type InstallArgs = {
     /**
      * - how to install this extension. One of the INSTALL_TYPES
      */
-    installType: import('appium/types').InstallType;
+    installType: InstallType;
     /**
      * - for git/github installs, the extension node package name
      */
     packageName?: string | undefined;
 };
-/**
- * Returned by {@linkcode ExtensionCommand.getExtensionFields }
- */
-export type ExtensionFields<ExtType extends import("@appium/types").ExtensionType> = ExtMetadata<ExtType> & {
-    pkgName: string;
-    version: string;
-    appiumVersion: string;
-} & import('appium/types').CommonExtMetadata;
 export type KnownExtensions<ExtType extends import("@appium/types").ExtensionType> = ExtType extends DriverType ? typeof import('../constants').KNOWN_DRIVERS : ExtType extends PluginType ? typeof import('../constants').KNOWN_PLUGINS : never;
 export type ListOptions = {
     /**
@@ -217,6 +218,16 @@ export type ListOptions = {
      */
     showUpdates: boolean;
 };
+/**
+ * Opts for {@linkcode ExtensionCommand.getInstallationReceipt }
+ */
+export type GetInstallationReceiptOpts<ExtType extends import("@appium/types").ExtensionType> = {
+    installPath: string;
+    installSpec: string;
+    pkg: ExtPackageJson<ExtType>;
+    installType: InstallType;
+};
+export type InstallType = import('appium/types').InstallType;
 /**
  * @template {ExtensionType} ExtType
  */
@@ -274,16 +285,17 @@ export class ExtensionCommand<ExtType extends import("@appium/types").ExtensionT
     /**
      * Install an extension
      *
-     * @param {InstallArgs} args
+     * @param {InstallOpts} opts
      * @return {Promise<ExtRecord<ExtType>>} map of all installed extension names to extension data
      */
-    _install({ installSpec, installType, packageName }: InstallArgs): Promise<ExtRecord<ExtType>>;
+    _install({ installSpec, installType, packageName }: InstallOpts): Promise<ExtRecord<ExtType>>;
     /**
      * Install an extension via NPM
      *
      * @param {InstallViaNpmArgs} args
+     * @returns {Promise<ExtInstallReceipt<ExtType>>}
      */
-    installViaNpm({ installSpec, pkgName, pkgVer }: InstallViaNpmArgs): Promise<ExtensionFields<ExtType>>;
+    installViaNpm({ installSpec, pkgName, pkgVer, installType }: InstallViaNpmArgs): Promise<ExtInstallReceipt<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.
@@ -293,15 +305,12 @@ export class ExtensionCommand<ExtType extends import("@appium/types").ExtensionT
      */
     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.
+     * Once a package is installed on-disk, this gathers some necessary metadata for validation.
      *
-     * @param {ExtPackageJson<ExtType>} pkgJson - the package.json data for a driver module, as if it had been straightforwardly 'require'd
-     * @returns {ExtensionFields<ExtType>}
+     * @param {GetInstallationReceiptOpts<ExtType>} opts
+     * @returns {ExtInstallReceipt<ExtType>}
      */
-    getExtensionFields(pkgJson: ExtPackageJson<ExtType>): ExtensionFields<ExtType>;
+    getInstallationReceipt({ pkg, installPath, installType, installSpec }: GetInstallationReceiptOpts<ExtType>): ExtInstallReceipt<ExtType>;
     /**
      * Validates the _required_ root fields of an extension's `package.json` file.
      *
@@ -309,12 +318,12 @@ export class ExtensionCommand<ExtType extends import("@appium/types").ExtensionT
      * - `name`
      * - `version`
      * - `appium`
-     * @param {import('type-fest').PackageJson} pkgJson - `package.json` of extension
+     * @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 {pkgJson is ExtPackageJson<ExtType>}
+     * @returns {pkg is ExtPackageJson<ExtType>}
      */
-    validatePackageJson(pkgJson: import('type-fest').PackageJson, installSpec: string): pkgJson is ExtPackageJson<ExtType>;
+    validatePackageJson(pkg: import('type-fest').PackageJson, installSpec: string): pkg is ExtPackageJson<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

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

@@ -1 +1 @@
-{"version":3,"file":"extension-command.d.ts","sourceRoot":"","sources":["../../../lib/cli/extension-command.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"extension-command.d.ts","sourceRoot":"","sources":["../../../lib/cli/extension-command.js"],"names":[],"mappings":";;;;;;;;YA2tBc,gBAAgB,OAAO,CAAC;;;;UACxB,OAAO;;;;;;;;;eAOP,OAAO;;;;mBACP,MAAM;;;;yBACN,MAAM;;;;cACN,OAAO;;;;iBACP,MAAM;;4BAIP,OAAO,eAAe,EAAE,aAAa;yBACrC,OAAO,eAAe,EAAE,UAAU;yBAClC,OAAO,eAAe,EAAE,UAAU;+EAKlC,OAAO,cAAc,EAAE,SAAS,CAAC,OAAO,CAAC;qFAKzC,OAAO,+BAA+B,EAAE,eAAe,CAAC,OAAO,CAAC;iFAKhE,OAAO,cAAc,EAAE,WAAW,CAAC,OAAO,CAAC;iFAK3C,OAAO,cAAc,EAAE,WAAW,CAAC,OAAO,CAAC;oFAK3C,OAAO,cAAc,EAAE,cAAc,CAAC,OAAO,CAAC;uFAK9C,OAAO,cAAc,EAAE,iBAAiB,CAAC,OAAO,CAAC;;;;;aAMhD,MAAM;eACN,KAAK;;;;;yCAKN,OAAO,cAAc,EAAE,gBAAgB,GAAG,iBAAiB;;;;gCAK3D,OAAO,MAAM,EAAC,0BAA0B,GAAC,4BAA4B,CAAC;;;;;;;;iBAMrE,MAAM;;;;gBACN,MAAM;;;;;;;;;;;;;;;;;YASN,MAAM,EAAE;;;;;;;;;iBAMR,MAAM;;;;YACN,OAAO;;;;;;;;;YAMP,OAAO,MAAM,EAAC,KAAK,CAAC;;;;aACpB,OAAO,MAAM,EAAC,YAAY,CAAC;;;;;;;;;UAM3B,MAAM;;;;QACN,MAAM;;;;;;;;;iBAMN,MAAM;;;;;;;;;aAMN,MAAM;;;;aACN,MAAM;;;;;;;;;iBAMN,MAAM;;;;aACN,MAAM;;;;iBACN,OAAO,cAAc,EAAE,WAAW;;;;;;;;;;;;;aAOlC,MAAM;;;;gBACN,MAAM;;;;kBACN,MAAM;;;;;;;;;iBAMN,MAAM;;;;iBACN,WAAW;;;;;;qFAMZ,OAAO,SAAS,UAAU,GAAG,cAAc,cAAc,EAAE,aAAa,GAAG,OAAO,SAAS,UAAU,GAAG,cAAc,cAAc,EAAE,aAAa,GAAG,KAAK;;;;;mBAK1J,OAAO;;;;iBACP,OAAO;;;;;;iBAOP,MAAM;iBACN,MAAM;SACN,eAAe,OAAO,CAAC;iBACvB,WAAW;;0BAIZ,OAAO,cAAc,EAAE,WAAW;AAl2B/C;;GAEG;AACH;IAmBE;;;OAGG;IACH,8BAFW,wBAAwB,OAAO,CAAC,EAM1C;IA1BD;;;OAGG;IACH,QAFU,gBAAgB,OAAO,CAAC,CAE3B;IAEP;;;OAGG;IACH,iBAFU,gBAAgB,OAAO,CAAC,CAElB;IAEhB;;;OAGG;IACH,cAFU,OAAO,CAEJ;IAQX,wBAAmD;IAIrD;;OAEG;IACH,oBAEC;IAED;;;;;;;;;OASG;IACH,qCAJW,MAAM,GAEJ,KAAK,CAIjB;IAED;;;;;OAKG;IACH,cAHW,MAAM,GACL,QAAQ,MAAM,CAAC,CAS1B;IAED;;;;;OAKG;IACH,qCAHW,WAAW,GACV,QAAQ,iBAAiB,CAAC,CA2GrC;IAED;;;;;OAKG;IACH,oDAHW,WAAW,GACV,QAAQ,UAAU,OAAO,CAAC,CAAC,CA4JtC;IAED;;;;;OAKG;IACH,6DAHW,iBAAiB,GACf,QAAQ,kBAAkB,OAAO,CAAC,CAAC,CAyB/C;IAED;;;;;;OAMG;IAEH,yBAJW,aAAa,GACX,MAAM,CAKlB;IAED;;;;;OAKG;IACH,uEAHW,2BAA2B,OAAO,CAAC,GACjC,kBAAkB,OAAO,CAAC,CAsBtC;IAED;;;;;;;;;;;OAWG;IACH,yBALW,OAAO,WAAW,EAAE,WAAW,eAC/B,MAAM,kCA8BhB;IAED;;;;;;;OAOG;IAEH,qCAJW,YAAY,OAAO,CAAC,eACpB,MAAM,QAKhB;IAED;;;;;;;;;OASG;IACH,4BAHW,aAAa,GACZ,QAAQ,UAAU,OAAO,CAAC,CAAC,CAatC;IAED;;;;;OAKG;IACH,iCAHW,mBAAmB,GAClB,QAAQ,qBAAqB,CAAC,CA+EzC;IAED;;;;;;OAMG;IACH,6BAHW,MAAM,GACL,QAAQ,eAAe,CAAC,CA4BnC;IAED;;;;;;;OAOG;IACH,6BAJW,MAAM,WACN,MAAM,GACJ,QAAQ,IAAI,CAAC,CAYzB;IAED;;;;;;;;;;OAUG;IACH,6CAHW,UAAU,GACT,QAAQ,SAAS,CAAC,CAoD7B;CACF"}