appium 2.0.0-beta.6 → 2.0.0-beta.60

package/build/lib/extension/extension-config.js

@@ -0,0 +1,601 @@
+"use strict";
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var _ExtensionConfig_listDataCache;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExtensionConfig = exports.INSTALL_TYPES = exports.INSTALL_TYPE_DEV = exports.INSTALL_TYPE_GIT = exports.INSTALL_TYPE_GITHUB = exports.INSTALL_TYPE_LOCAL = exports.INSTALL_TYPE_NPM = void 0;
+const support_1 = require("@appium/support");
+const bluebird_1 = __importDefault(require("bluebird"));
+const lodash_1 = __importDefault(require("lodash"));
+const path_1 = __importDefault(require("path"));
+const resolve_from_1 = __importDefault(require("resolve-from"));
+const semver_1 = require("semver");
+const extension_1 = require("../cli/extension");
+const config_1 = require("../config");
+const logger_1 = __importDefault(require("../logger"));
+const schema_1 = require("../schema/schema");
+/**
+ * "npm" install type
+ * Used when extension was installed by npm package name
+ * @remarks _All_ extensions are installed _by_ `npm`, but only this one means the package name was
+ * used to specify it
+ */
+exports.INSTALL_TYPE_NPM = 'npm';
+/**
+ * "local" install type
+ * Used when extension was installed from a local path
+ */
+exports.INSTALL_TYPE_LOCAL = 'local';
+/**
+ * "github" install type
+ * Used when extension was installed via GitHub URL
+ */
+exports.INSTALL_TYPE_GITHUB = 'github';
+/**
+ * "git" install type
+ * Used when extensions was installed via Git URL
+ */
+exports.INSTALL_TYPE_GIT = 'git';
+/**
+ * "dev" install type
+ * Used when automatically detected as a working copy
+ */
+exports.INSTALL_TYPE_DEV = 'dev';
+/** @type {Set<InstallType>} */
+exports.INSTALL_TYPES = new Set([
+    exports.INSTALL_TYPE_GIT,
+    exports.INSTALL_TYPE_GITHUB,
+    exports.INSTALL_TYPE_LOCAL,
+    exports.INSTALL_TYPE_NPM,
+    exports.INSTALL_TYPE_DEV,
+]);
+/**
+ * This class is abstract. It should not be instantiated directly.
+ *
+ * Subclasses should provide the generic parameter to implement.
+ * @template {ExtensionType} ExtType
+ */
+class ExtensionConfig {
+    /**
+     * @protected
+     * @param {ExtType} extensionType - Type of extension
+     * @param {Manifest} manifest - `Manifest` instance
+     */
+    constructor(extensionType, manifest) {
+        /**
+         * @type {import('../cli/extension-command').ExtensionList<ExtType>|undefined}
+         */
+        _ExtensionConfig_listDataCache.set(this, void 0);
+        this.extensionType = extensionType;
+        this.installedExtensions = manifest.getExtensionData(extensionType);
+        this.manifest = manifest;
+    }
+    get manifestPath() {
+        return this.manifest.manifestPath;
+    }
+    get appiumHome() {
+        return this.manifest.appiumHome;
+    }
+    /**
+     * Returns a list of errors for a given extension.
+     *
+     * @param {ExtName<ExtType>} extName
+     * @param {ExtManifest<ExtType>} extManifest
+     * @returns {ExtManifestProblem[]}
+     */
+    getProblems(extName, extManifest) {
+        return [
+            ...this.getGenericConfigProblems(extManifest, extName),
+            ...this.getConfigProblems(extManifest, extName),
+            ...this.getSchemaProblems(extManifest, extName),
+        ];
+    }
+    /**
+     * Returns a list of warnings for a given extension.
+     *
+     * @param {ExtName<ExtType>} extName
+     * @param {ExtManifest<ExtType>} extManifest
+     * @returns {Promise<string[]>}
+     */
+    async getWarnings(extName, extManifest) {
+        const [genericConfigWarnings, configWarnings] = await bluebird_1.default.all([
+            this.getGenericConfigWarnings(extManifest, extName),
+            this.getConfigWarnings(extManifest, extName),
+        ]);
+        return [...genericConfigWarnings, ...configWarnings];
+    }
+    /**
+     * Returns a list of extension-type-specific issues. To be implemented by subclasses.
+     * @abstract
+     * @param {ExtManifest<ExtType>} extManifest
+     * @param {ExtName<ExtType>} extName
+     * @returns {Promise<string[]>}
+     */
+    // eslint-disable-next-line no-unused-vars,require-await
+    async getConfigWarnings(extManifest, extName) {
+        return [];
+    }
+    /**
+     *
+     * @param {Map<ExtName<ExtType>,ExtManifestProblem[]>} [errorMap]
+     * @param {Map<ExtName<ExtType>,string[]>} [warningMap]
+     */
+    getValidationResultSummaries(errorMap = new Map(), warningMap = new Map()) {
+        /**
+         * Array of computed strings
+         * @type {string[]}
+         */
+        const errorSummaries = [];
+        for (const [extName, problems] of errorMap.entries()) {
+            if (lodash_1.default.isEmpty(problems)) {
+                continue;
+            }
+            // remove this extension from the list since it's not valid
+            errorSummaries.push(`${this.extensionType} "${extName}" had ${support_1.util.pluralize('error', problems.length)} and will not be available:`);
+            for (const problem of problems) {
+                errorSummaries.push(`  - ${problem.err} (Actual value: ` + `${JSON.stringify(problem.val)})`);
+            }
+        }
+        /** @type {string[]} */
+        const warningSummaries = [];
+        for (const [extName, warnings] of warningMap.entries()) {
+            if (lodash_1.default.isEmpty(warnings)) {
+                continue;
+            }
+            const extTypeText = lodash_1.default.capitalize(this.extensionType);
+            const problemEnumerationText = support_1.util.pluralize('potential problem', warnings.length, true);
+            warningSummaries.push(`${extTypeText} "${extName}" has ${problemEnumerationText}: `);
+            for (const warning of warnings) {
+                warningSummaries.push(`  - ${warning}`);
+            }
+        }
+        return { errorSummaries, warningSummaries };
+    }
+    /**
+     * Checks extensions for problems.  To be called by subclasses' `validate` method.
+     *
+     * Errors and warnings will be displayed to the user.
+     *
+     * This method mutates `exts`.
+     *
+     * @protected
+     * @param {ExtRecord<ExtType>} exts - Lookup of extension names to {@linkcode ExtManifest} objects
+     * @returns {Promise<ExtRecord<ExtType>>} The same lookup, but picking only error-free extensions
+     */
+    async _validate(exts) {
+        /**
+         * Lookup of extension names to {@linkcode ExtManifestProblem ExtManifestProblems}
+         * @type {Map<ExtName<ExtType>,ExtManifestProblem[]>}
+         */
+        const errorMap = new Map();
+        /**
+         * Lookup of extension names to warnings.
+         * @type {Map<ExtName<ExtType>,string[]>}
+         */
+        const warningMap = new Map();
+        for (const [extName, extManifest] of lodash_1.default.toPairs(exts)) {
+            const [errors, warnings] = await bluebird_1.default.all([
+                this.getProblems(extName, extManifest),
+                this.getWarnings(extName, extManifest),
+            ]);
+            if (errors.length) {
+                delete exts[extName];
+            }
+            errorMap.set(extName, errors);
+            warningMap.set(extName, warnings);
+        }
+        const { errorSummaries, warningSummaries } = this.getValidationResultSummaries(errorMap, warningMap);
+        if (!lodash_1.default.isEmpty(errorSummaries)) {
+            logger_1.default.error(`Appium encountered ${support_1.util.pluralize('error', errorMap.size, true)} while validating ${this.extensionType}s found in manifest ${this.manifestPath}`);
+            for (const summary of errorSummaries) {
+                logger_1.default.error(summary);
+            }
+        }
+        else {
+            // only display warnings if there are no errors!
+            if (!lodash_1.default.isEmpty(warningSummaries)) {
+                logger_1.default.warn(`Appium encountered ${support_1.util.pluralize('warning', warningMap.size, true)} while validating ${this.extensionType}s found in manifest ${this.manifestPath}`);
+                for (const summary of warningSummaries) {
+                    logger_1.default.warn(summary);
+                }
+            }
+        }
+        return exts;
+    }
+    /**
+     * Retrieves listing data for extensions via command class.
+     *
+     * This is an expensive operation, so the result is cached.  Currently, there is no
+     * use case for invalidating the cache.
+     * @protected
+     * @returns {Promise<import('../cli/extension-command').ExtensionList<ExtType>>}
+     */
+    async getListData() {
+        if (__classPrivateFieldGet(this, _ExtensionConfig_listDataCache, "f")) {
+            return __classPrivateFieldGet(this, _ExtensionConfig_listDataCache, "f");
+        }
+        const CommandClass = /** @type {ExtCommand<ExtType>} */ (extension_1.commandClasses[this.extensionType]);
+        const cmd = new CommandClass({ config: this, json: true });
+        const listData = await cmd.list({ showInstalled: true, showUpdates: true });
+        __classPrivateFieldSet(this, _ExtensionConfig_listDataCache, listData, "f");
+        return listData;
+    }
+    /**
+     * Returns a list of warnings for a particular extension.
+     *
+     * By definition, a non-empty list of warnings does _not_ imply the extension cannot be loaded,
+     * but it may not work as expected or otherwise throw an exception at runtime.
+     *
+     * @param {ExtManifest<ExtType>} extManifest
+     * @param {ExtName<ExtType>} extName
+     * @returns {Promise<string[]>}
+     */
+    async getGenericConfigWarnings(extManifest, extName) {
+        const { appiumVersion, installSpec, installType, pkgName } = extManifest;
+        const warnings = [];
+        const invalidFields = [];
+        if (!lodash_1.default.isString(installSpec)) {
+            invalidFields.push('installSpec');
+        }
+        if (!exports.INSTALL_TYPES.has(installType)) {
+            invalidFields.push('installType');
+        }
+        const extTypeText = lodash_1.default.capitalize(this.extensionType);
+        if (invalidFields.length) {
+            const invalidFieldsEnumerationText = support_1.util.pluralize('invalid or missing field', invalidFields.length, true);
+            const invalidFieldsText = invalidFields.map((field) => `"${field}"`).join(', ');
+            warnings.push(`${extTypeText} "${extName}" (package \`${pkgName}\`) has ${invalidFieldsEnumerationText} (${invalidFieldsText}) in \`extensions.yaml\`; this may cause upgrades done via the \`appium\` CLI tool to fail. Please reinstall with \`appium ${this.extensionType} uninstall ${extName}\` and \`appium ${this.extensionType} install ${extName}\` to attempt a fix.`);
+        }
+        /**
+         * Helps concatenate warning messages related to peer dependencies
+         * @param {string} reason
+         * @returns string
+         */
+        const createPeerWarning = (reason) => `${extTypeText} "${extName}" (package \`${pkgName}\`) may be incompatible with the current version of Appium (v${config_1.APPIUM_VER}) due to ${reason}`;
+        if (lodash_1.default.isString(appiumVersion) && !(0, semver_1.satisfies)(config_1.APPIUM_VER, appiumVersion)) {
+            const listData = await this.getListData();
+            const extListData = 
+            /** @type {import('../cli/extension-command').ExtensionListData<ExtType>} */ (listData[extName]);
+            if (extListData?.installed) {
+                const { updateVersion, upToDate } = extListData;
+                if (!upToDate) {
+                    warnings.push(createPeerWarning(`its peer dependency on older Appium v${appiumVersion}. Please upgrade \`${pkgName}\` to v${updateVersion} or newer.`));
+                }
+                else {
+                    warnings.push(createPeerWarning(`its peer dependency on older Appium v${appiumVersion}. Please ask the developer of \`${pkgName}\` to update the peer dependency on Appium to v${config_1.APPIUM_VER}.`));
+                }
+            }
+        }
+        else if (!lodash_1.default.isString(appiumVersion)) {
+            const listData = await this.getListData();
+            const extListData = 
+            /** @type {import('../cli/extension-command').InstalledExtensionListData<ExtType>} */ (listData[extName]);
+            if (!extListData?.upToDate && extListData?.updateVersion) {
+                warnings.push(createPeerWarning(`an invalid or missing peer dependency on Appium. A newer version of \`${pkgName}\` is available; please attempt to upgrade "${extName}" to v${extListData.updateVersion} or newer.`));
+            }
+            else {
+                warnings.push(createPeerWarning(`an invalid or missing peer dependency on Appium. Please ask the developer of \`${pkgName}\` to add a peer dependency on \`^appium@${config_1.APPIUM_VER}\`.`));
+            }
+        }
+        return warnings;
+    }
+    /**
+     * Returns list of unrecoverable errors (if any) for the given extension _if_ it has a `schema` property.
+     *
+     * @param {ExtManifest<ExtType>} extManifest - Extension data (from manifest)
+     * @param {ExtName<ExtType>} extName - Extension name (from manifest)
+     * @returns {ExtManifestProblem[]}
+     */
+    getSchemaProblems(extManifest, extName) {
+        /** @type {ExtManifestProblem[]} */
+        const problems = [];
+        const { schema: argSchemaPath } = extManifest;
+        if (ExtensionConfig.extDataHasSchema(extManifest)) {
+            if (lodash_1.default.isString(argSchemaPath)) {
+                if ((0, schema_1.isAllowedSchemaFileExtension)(argSchemaPath)) {
+                    try {
+                        this.readExtensionSchema(extName, extManifest);
+                    }
+                    catch (err) {
+                        problems.push({
+                            err: `Unable to register schema at path ${argSchemaPath}; ${err.message}`,
+                            val: argSchemaPath,
+                        });
+                    }
+                }
+                else {
+                    problems.push({
+                        err: `Schema file has unsupported extension. Allowed: ${[
+                            ...schema_1.ALLOWED_SCHEMA_EXTENSIONS,
+                        ].join(', ')}`,
+                        val: argSchemaPath,
+                    });
+                }
+            }
+            else if (lodash_1.default.isPlainObject(argSchemaPath)) {
+                try {
+                    this.readExtensionSchema(extName, extManifest);
+                }
+                catch (err) {
+                    problems.push({
+                        err: `Unable to register embedded schema; ${err.message}`,
+                        val: argSchemaPath,
+                    });
+                }
+            }
+            else {
+                problems.push({
+                    err: 'Incorrectly formatted schema field; must be a path to a schema file or a schema object.',
+                    val: argSchemaPath,
+                });
+            }
+        }
+        return problems;
+    }
+    /**
+     * Return a list of generic unrecoverable errors for the given extension
+     * @param {ExtManifest<ExtType>} extManifest - Extension data (from manifest)
+     * @param {ExtName<ExtType>} extName - Extension name (from manifest)
+     * @returns {ExtManifestProblem[]}
+     */
+    // eslint-disable-next-line no-unused-vars
+    getGenericConfigProblems(extManifest, extName) {
+        const { version, pkgName, mainClass } = extManifest;
+        const problems = [];
+        if (!lodash_1.default.isString(version)) {
+            problems.push({
+                err: `Invalid or missing \`version\` field in my \`package.json\` and/or \`extensions.yaml\` (must be a string)`,
+                val: version,
+            });
+        }
+        if (!lodash_1.default.isString(pkgName)) {
+            problems.push({
+                err: `Invalid or missing \`name\` field in my \`package.json\` and/or \`extensions.yaml\` (must be a string)`,
+                val: pkgName,
+            });
+        }
+        if (!lodash_1.default.isString(mainClass)) {
+            problems.push({
+                err: `Invalid or missing \`appium.mainClass\` field in my \`package.json\` and/or \`mainClass\` field in \`extensions.yaml\` (must be a string)`,
+                val: mainClass,
+            });
+        }
+        return problems;
+    }
+    /**
+     * @abstract
+     * @param {ExtManifest<ExtType>} extManifest
+     * @param {ExtName<ExtType>} extName
+     * @returns {ExtManifestProblem[]}
+     */
+    // eslint-disable-next-line no-unused-vars
+    getConfigProblems(extManifest, extName) {
+        // shoud override this method if special validation is necessary for this extension type
+        return [];
+    }
+    /**
+     * @param {string} extName
+     * @param {ExtManifest<ExtType>} extManifest
+     * @param {ExtensionConfigMutationOpts} opts
+     * @returns {Promise<void>}
+     */
+    async addExtension(extName, extManifest, { write = true } = {}) {
+        this.manifest.setExtension(this.extensionType, extName, extManifest);
+        if (write) {
+            await this.manifest.write();
+        }
+    }
+    /**
+     * @param {ExtName<ExtType>} extName
+     * @param {ExtManifest<ExtType>} extManifest
+     * @param {ExtensionConfigMutationOpts} opts
+     * @returns {Promise<void>}
+     */
+    async updateExtension(extName, extManifest, { write = true } = {}) {
+        this.manifest.setExtension(this.extensionType, extName, {
+            ...this.installedExtensions[extName],
+            ...extManifest,
+        });
+        if (write) {
+            await this.manifest.write();
+        }
+    }
+    /**
+     * Remove an extension from the list of installed extensions, and optionally avoid a write to the manifest file.
+     *
+     * @param {ExtName<ExtType>} extName
+     * @param {ExtensionConfigMutationOpts} opts
+     * @returns {Promise<void>}
+     */
+    async removeExtension(extName, { write = true } = {}) {
+        this.manifest.deleteExtension(this.extensionType, extName);
+        if (write) {
+            await this.manifest.write();
+        }
+    }
+    /**
+     * @param {ExtName<ExtType>[]} [activeNames]
+     * @returns {void}
+     */
+    // eslint-disable-next-line no-unused-vars
+    print(activeNames) {
+        if (lodash_1.default.isEmpty(this.installedExtensions)) {
+            logger_1.default.info(`No ${this.extensionType}s have been installed in ${this.appiumHome}. Use the "appium ${this.extensionType}" ` +
+                'command to install the one(s) you want to use.');
+            return;
+        }
+        logger_1.default.info(`Available ${this.extensionType}s:`);
+        for (const [extName, extManifest] of /** @type {[string, ExtManifest<ExtType>][]} */ (lodash_1.default.toPairs(this.installedExtensions))) {
+            logger_1.default.info(`  - ${this.extensionDesc(extName, extManifest)}`);
+        }
+    }
+    /**
+     * Returns a string describing the extension. Subclasses must implement.
+     * @param {ExtName<ExtType>} extName - Extension name
+     * @param {ExtManifest<ExtType>} extManifest - Extension data
+     * @returns {string}
+     * @abstract
+     */
+    // eslint-disable-next-line no-unused-vars
+    extensionDesc(extName, extManifest) {
+        throw new Error('This must be implemented in a subclass');
+    }
+    /**
+     * Returns--with reasonable accuracy--the path on disk to the extension.
+     *
+     * If `installPath` is present in the manifest, then it is used; otherwise we just guess.
+     * @param {keyof typeof this.installedExtensions} extName
+     * @returns {string}
+     */
+    getInstallPath(extName) {
+        return (this.installedExtensions[extName]?.installPath ??
+            path_1.default.join(this.appiumHome, 'node_modules', this.installedExtensions[extName].pkgName));
+    }
+    /**
+     * Loads extension and returns its main class (constructor)
+     * @param {ExtName<ExtType>} extName
+     * @returns {ExtClass<ExtType>}
+     */
+    require(extName) {
+        const { mainClass } = this.installedExtensions[extName];
+        const reqPath = this.getInstallPath(extName);
+        /** @type {string} */
+        let reqResolved;
+        try {
+            reqResolved = require.resolve(reqPath);
+        }
+        catch (err) {
+            throw new ReferenceError(`Could not find a ${this.extensionType} installed at ${reqPath}`);
+        }
+        // note: this will only reload the entry point
+        if (process.env.APPIUM_RELOAD_EXTENSIONS && require.cache[reqResolved]) {
+            logger_1.default.debug(`Removing ${reqResolved} from require cache`);
+            delete require.cache[reqResolved];
+        }
+        logger_1.default.debug(`Requiring ${this.extensionType} at ${reqPath}`);
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const MainClass = require(reqPath)[mainClass];
+        if (!MainClass) {
+            throw new ReferenceError(`Could not find a class named "${mainClass}" exported by ${this.extensionType} "${extName}"`);
+        }
+        return MainClass;
+    }
+    /**
+     * @param {string} extName
+     * @returns {boolean}
+     */
+    isInstalled(extName) {
+        return extName in this.installedExtensions;
+    }
+    /**
+     * Intended to be called by corresponding instance methods of subclass.
+     * @private
+     * @template {ExtensionType} ExtType
+     * @param {string} appiumHome
+     * @param {ExtType} extType
+     * @param {ExtName<ExtType>} extName - Extension name (unique to its type)
+     * @param {ExtManifestWithSchema<ExtType>} extManifest - Extension config
+     * @returns {import('ajv').SchemaObject|undefined}
+     */
+    static _readExtensionSchema(appiumHome, extType, extName, extManifest) {
+        const { pkgName, schema: argSchemaPath } = extManifest;
+        if (!argSchemaPath) {
+            throw new TypeError(`No \`schema\` property found in config for ${extType} ${pkgName} -- why is this function being called?`);
+        }
+        let moduleObject;
+        if (lodash_1.default.isString(argSchemaPath)) {
+            const schemaPath = (0, resolve_from_1.default)(appiumHome, path_1.default.join(pkgName, argSchemaPath));
+            moduleObject = require(schemaPath);
+        }
+        else {
+            moduleObject = argSchemaPath;
+        }
+        // this sucks. default exports should be destroyed
+        const schema = moduleObject.__esModule ? moduleObject.default : moduleObject;
+        (0, schema_1.registerSchema)(extType, extName, schema);
+        return schema;
+    }
+    /**
+     * Returns `true` if a specific {@link ExtManifest} object has a `schema` prop.
+     * The {@link ExtManifest} object becomes a {@link ExtManifestWithSchema} object.
+     * @template {ExtensionType} ExtType
+     * @param {ExtManifest<ExtType>} extManifest
+     * @returns {extManifest is ExtManifestWithSchema<ExtType>}
+     */
+    static extDataHasSchema(extManifest) {
+        return lodash_1.default.isString(extManifest?.schema) || lodash_1.default.isObject(extManifest?.schema);
+    }
+    /**
+     * If an extension provides a schema, this will load the schema and attempt to
+     * register it with the schema registrar.
+     * @param {ExtName<ExtType>} extName - Name of extension
+     * @param {ExtManifestWithSchema<ExtType>} extManifest - Extension data
+     * @returns {import('ajv').SchemaObject|undefined}
+     */
+    readExtensionSchema(extName, extManifest) {
+        return ExtensionConfig._readExtensionSchema(this.appiumHome, this.extensionType, extName, extManifest);
+    }
+}
+exports.ExtensionConfig = ExtensionConfig;
+_ExtensionConfig_listDataCache = new WeakMap();
+/**
+ * An issue with the {@linkcode ExtManifest} for a particular extension.
+ *
+ * The existance of such an object implies that the extension cannot be loaded.
+ * @typedef ExtManifestProblem
+ * @property {string} err - Error message
+ * @property {any} val - Associated value
+ */
+/**
+ * An optional logging function provided to an {@link ExtensionConfig} subclass.
+ * @callback ExtensionLogFn
+ * @param {...any} args
+ * @returns {void}
+ */
+/**
+ * @typedef {import('@appium/types').ExtensionType} ExtensionType
+ * @typedef {import('./manifest').Manifest} Manifest
+ * @typedef {import('appium/types').InstallType} InstallType
+ */
+/**
+ * @template {ExtensionType} ExtType
+ * @typedef {import('appium/types').ExtManifest<ExtType>} ExtManifest
+ */
+/**
+ * @template {ExtensionType} ExtType
+ * @typedef {ExtManifest<ExtType> & {schema: NonNullable<ExtManifest<ExtType>['schema']>}} ExtManifestWithSchema
+ */
+/**
+ * @template {ExtensionType} ExtType
+ * @typedef {import('appium/types').ExtName<ExtType>} ExtName
+ */
+/**
+ * @template {ExtensionType} ExtType
+ * @typedef {import('appium/types').ExtClass<ExtType>} ExtClass
+ */
+/**
+ * @template {ExtensionType} ExtType
+ * @typedef {import('appium/types').ExtRecord<ExtType>} ExtRecord
+ */
+/**
+ * @template {ExtensionType} ExtType
+ * @typedef {import('../cli/extension').ExtCommand<ExtType>} ExtCommand
+ */
+/**
+ * Options for various methods in {@link ExtensionConfig}
+ * @typedef ExtensionConfigMutationOpts
+ * @property {boolean} [write=true] Whether or not to write the manifest to disk after a mutation operation
+ */
+//# sourceMappingURL=extension-config.js.map

package/build/lib/extension/extension-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-config.js","sourceRoot":"","sources":["../../../lib/extension/extension-config.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA,6CAAqC;AACrC,wDAAyB;AACzB,oDAAuB;AACvB,gDAAwB;AACxB,gEAAuC;AACvC,mCAAiC;AACjC,gDAAgD;AAChD,sCAAqC;AACrC,uDAA4B;AAC5B,6CAI0B;AAE1B;;;;;GAKG;AACU,QAAA,gBAAgB,GAAG,KAAK,CAAC;AACtC;;;GAGG;AACU,QAAA,kBAAkB,GAAG,OAAO,CAAC;AAC1C;;;GAGG;AACU,QAAA,mBAAmB,GAAG,QAAQ,CAAC;AAC5C;;;GAGG;AACU,QAAA,gBAAgB,GAAG,KAAK,CAAC;AACtC;;;GAGG;AACU,QAAA,gBAAgB,GAAG,KAAK,CAAC;AAEtC,+BAA+B;AAClB,QAAA,aAAa,GAAG,IAAI,GAAG,CAAC;IACnC,wBAAgB;IAChB,2BAAmB;IACnB,0BAAkB;IAClB,wBAAgB;IAChB,wBAAgB;CACjB,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAa,eAAe;IA0B1B;;;;OAIG;IACH,YAAY,aAAa,EAAE,QAAQ;QAVnC;;WAEG;QACH,iDAAe;QAQb,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,mBAAmB,GAAG,QAAQ,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC;QACpE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;IACpC,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;IAClC,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CAAC,OAAO,EAAE,WAAW;QAC9B,OAAO;YACL,GAAG,IAAI,CAAC,wBAAwB,CAAC,WAAW,EAAE,OAAO,CAAC;YACtD,GAAG,IAAI,CAAC,iBAAiB,CAAC,WAAW,EAAE,OAAO,CAAC;YAC/C,GAAG,IAAI,CAAC,iBAAiB,CAAC,WAAW,EAAE,OAAO,CAAC;SAChD,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,WAAW;QACpC,MAAM,CAAC,qBAAqB,EAAE,cAAc,CAAC,GAAG,MAAM,kBAAC,CAAC,GAAG,CAAC;YAC1D,IAAI,CAAC,wBAAwB,CAAC,WAAW,EAAE,OAAO,CAAC;YACnD,IAAI,CAAC,iBAAiB,CAAC,WAAW,EAAE,OAAO,CAAC;SAC7C,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,qBAAqB,EAAE,GAAG,cAAc,CAAC,CAAC;IACvD,CAAC;IAED;;;;;;OAMG;IACH,wDAAwD;IACxD,KAAK,CAAC,iBAAiB,CAAC,WAAW,EAAE,OAAO;QAC1C,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;OAIG;IACH,4BAA4B,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAE,EAAE,UAAU,GAAG,IAAI,GAAG,EAAE;QACvE;;;WAGG;QACH,MAAM,cAAc,GAAG,EAAE,CAAC;QAC1B,KAAK,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE;YACpD,IAAI,gBAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;gBACvB,SAAS;aACV;YACD,2DAA2D;YAC3D,cAAc,CAAC,IAAI,CACjB,GAAG,IAAI,CAAC,aAAa,KAAK,OAAO,SAAS,cAAI,CAAC,SAAS,CACtD,OAAO,EACP,QAAQ,CAAC,MAAM,CAChB,6BAA6B,CAC/B,CAAC;YACF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE;gBAC9B,cAAc,CAAC,IAAI,CACjB,OAAO,OAAO,CAAC,GAAG,kBAAkB,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CACzE,CAAC;aACH;SACF;QACD,uBAAuB;QACvB,MAAM,gBAAgB,GAAG,EAAE,CAAC;QAC5B,KAAK,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,EAAE;YACtD,IAAI,gBAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;gBACvB,SAAS;aACV;YACD,MAAM,WAAW,GAAG,gBAAC,CAAC,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACrD,MAAM,sBAAsB,GAAG,cAAI,CAAC,SAAS,CAAC,mBAAmB,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC1F,gBAAgB,CAAC,IAAI,CAAC,GAAG,WAAW,KAAK,OAAO,SAAS,sBAAsB,IAAI,CAAC,CAAC;YACrF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE;gBAC9B,gBAAgB,CAAC,IAAI,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC;aACzC;SACF;QAED,OAAO,EAAC,cAAc,EAAE,gBAAgB,EAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,SAAS,CAAC,IAAI;QAClB;;;WAGG;QACH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;QAC3B;;;WAGG;QACH,MAAM,UAAU,GAAG,IAAI,GAAG,EAAE,CAAC;QAE7B,KAAK,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,gBAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YACpD,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,MAAM,kBAAC,CAAC,GAAG,CAAC;gBACrC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC;gBACtC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC;aACvC,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,MAAM,EAAE;gBACjB,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC;aACtB;YACD,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC9B,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;SACnC;QAED,MAAM,EAAC,cAAc,EAAE,gBAAgB,EAAC,GAAG,IAAI,CAAC,4BAA4B,CAC1E,QAAQ,EACR,UAAU,CACX,CAAC;QAEF,IAAI,CAAC,gBAAC,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE;YAC9B,gBAAG,CAAC,KAAK,CACP,sBAAsB,cAAI,CAAC,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,qBAChE,IAAI,CAAC,aACP,uBAAuB,IAAI,CAAC,YAAY,EAAE,CAC3C,CAAC;YACF,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE;gBACpC,gBAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;aACpB;SACF;aAAM;YACL,gDAAgD;YAEhD,IAAI,CAAC,gBAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE;gBAChC,gBAAG,CAAC,IAAI,CACN,sBAAsB,cAAI,CAAC,SAAS,CAClC,SAAS,EACT,UAAU,CAAC,IAAI,EACf,IAAI,CACL,qBAAqB,IAAI,CAAC,aAAa,uBAAuB,IAAI,CAAC,YAAY,EAAE,CACnF,CAAC;gBACF,KAAK,MAAM,OAAO,IAAI,gBAAgB,EAAE;oBACtC,gBAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;iBACnB;aACF;SACF;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,WAAW;QACf,IAAI,uBAAA,IAAI,sCAAe,EAAE;YACvB,OAAO,uBAAA,IAAI,sCAAe,CAAC;SAC5B;QACD,MAAM,YAAY,GAAG,kCAAkC,CAAC,CAAC,0BAAc,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;QAC7F,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,EAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAC,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,EAAC,aAAa,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAC,CAAC,CAAC;QAC1E,uBAAA,IAAI,kCAAkB,QAAQ,MAAA,CAAC;QAC/B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,wBAAwB,CAAC,WAAW,EAAE,OAAO;QACjD,MAAM,EAAC,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAC,GAAG,WAAW,CAAC;QACvE,MAAM,QAAQ,GAAG,EAAE,CAAC;QAEpB,MAAM,aAAa,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,gBAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE;YAC5B,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;SACnC;QAED,IAAI,CAAC,qBAAa,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE;YACnC,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;SACnC;QAED,MAAM,WAAW,GAAG,gBAAC,CAAC,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAErD,IAAI,aAAa,CAAC,MAAM,EAAE;YACxB,MAAM,4BAA4B,GAAG,cAAI,CAAC,SAAS,CACjD,0BAA0B,EAC1B,aAAa,CAAC,MAAM,EACpB,IAAI,CACL,CAAC;YACF,MAAM,iBAAiB,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEhF,QAAQ,CAAC,IAAI,CACX,GAAG,WAAW,KAAK,OAAO,gBAAgB,OAAO,WAAW,4BAA4B,KAAK,iBAAiB,8HAA8H,IAAI,CAAC,aAAa,cAAc,OAAO,mBAAmB,IAAI,CAAC,aAAa,YAAY,OAAO,sBAAsB,CAClW,CAAC;SACH;QAED;;;;WAIG;QACH,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,EAAE,CACnC,GAAG,WAAW,KAAK,OAAO,gBAAgB,OAAO,gEAAgE,mBAAU,YAAY,MAAM,EAAE,CAAC;QAElJ,IAAI,gBAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,IAAA,kBAAS,EAAC,mBAAU,EAAE,aAAa,CAAC,EAAE;YACtE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;YAC1C,MAAM,WAAW;YACf,4EAA4E,CAAC,CAC3E,QAAQ,CAAC,OAAO,CAAC,CAClB,CAAC;YACJ,IAAI,WAAW,EAAE,SAAS,EAAE;gBAC1B,MAAM,EAAC,aAAa,EAAE,QAAQ,EAAC,GAAG,WAAW,CAAC;gBAC9C,IAAI,CAAC,QAAQ,EAAE;oBACb,QAAQ,CAAC,IAAI,CACX,iBAAiB,CACf,wCAAwC,aAAa,sBAAsB,OAAO,UAAU,aAAa,YAAY,CACtH,CACF,CAAC;iBACH;qBAAM;oBACL,QAAQ,CAAC,IAAI,CACX,iBAAiB,CACf,wCAAwC,aAAa,mCAAmC,OAAO,kDAAkD,mBAAU,GAAG,CAC/J,CACF,CAAC;iBACH;aACF;SACF;aAAM,IAAI,CAAC,gBAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE;YACrC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;YAC1C,MAAM,WAAW;YACf,qFAAqF,CAAC,CACpF,QAAQ,CAAC,OAAO,CAAC,CAClB,CAAC;YACJ,IAAI,CAAC,WAAW,EAAE,QAAQ,IAAI,WAAW,EAAE,aAAa,EAAE;gBACxD,QAAQ,CAAC,IAAI,CACX,iBAAiB,CACf,yEAAyE,OAAO,+CAA+C,OAAO,SAAS,WAAW,CAAC,aAAa,YAAY,CACrL,CACF,CAAC;aACH;iBAAM;gBACL,QAAQ,CAAC,IAAI,CACX,iBAAiB,CACf,kFAAkF,OAAO,4CAA4C,mBAAU,KAAK,CACrJ,CACF,CAAC;aACH;SACF;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD;;;;;;OAMG;IACH,iBAAiB,CAAC,WAAW,EAAE,OAAO;QACpC,mCAAmC;QACnC,MAAM,QAAQ,GAAG,EAAE,CAAC;QACpB,MAAM,EAAC,MAAM,EAAE,aAAa,EAAC,GAAG,WAAW,CAAC;QAC5C,IAAI,eAAe,CAAC,gBAAgB,CAAC,WAAW,CAAC,EAAE;YACjD,IAAI,gBAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE;gBAC7B,IAAI,IAAA,qCAA4B,EAAC,aAAa,CAAC,EAAE;oBAC/C,IAAI;wBACF,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;qBAChD;oBAAC,OAAO,GAAG,EAAE;wBACZ,QAAQ,CAAC,IAAI,CAAC;4BACZ,GAAG,EAAE,qCAAqC,aAAa,KAAK,GAAG,CAAC,OAAO,EAAE;4BACzE,GAAG,EAAE,aAAa;yBACnB,CAAC,CAAC;qBACJ;iBACF;qBAAM;oBACL,QAAQ,CAAC,IAAI,CAAC;wBACZ,GAAG,EAAE,mDAAmD;4BACtD,GAAG,kCAAyB;yBAC7B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;wBACd,GAAG,EAAE,aAAa;qBACnB,CAAC,CAAC;iBACJ;aACF;iBAAM,IAAI,gBAAC,CAAC,aAAa,CAAC,aAAa,CAAC,EAAE;gBACzC,IAAI;oBACF,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;iBAChD;gBAAC,OAAO,GAAG,EAAE;oBACZ,QAAQ,CAAC,IAAI,CAAC;wBACZ,GAAG,EAAE,uCAAuC,GAAG,CAAC,OAAO,EAAE;wBACzD,GAAG,EAAE,aAAa;qBACnB,CAAC,CAAC;iBACJ;aACF;iBAAM;gBACL,QAAQ,CAAC,IAAI,CAAC;oBACZ,GAAG,EAAE,yFAAyF;oBAC9F,GAAG,EAAE,aAAa;iBACnB,CAAC,CAAC;aACJ;SACF;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;OAKG;IACH,0CAA0C;IAC1C,wBAAwB,CAAC,WAAW,EAAE,OAAO;QAC3C,MAAM,EAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAC,GAAG,WAAW,CAAC;QAClD,MAAM,QAAQ,GAAG,EAAE,CAAC;QAEpB,IAAI,CAAC,gBAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE;YACxB,QAAQ,CAAC,IAAI,CAAC;gBACZ,GAAG,EAAE,2GAA2G;gBAChH,GAAG,EAAE,OAAO;aACb,CAAC,CAAC;SACJ;QAED,IAAI,CAAC,gBAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE;YACxB,QAAQ,CAAC,IAAI,CAAC;gBACZ,GAAG,EAAE,wGAAwG;gBAC7G,GAAG,EAAE,OAAO;aACb,CAAC,CAAC;SACJ;QAED,IAAI,CAAC,gBAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE;YAC1B,QAAQ,CAAC,IAAI,CAAC;gBACZ,GAAG,EAAE,2IAA2I;gBAChJ,GAAG,EAAE,SAAS;aACf,CAAC,CAAC;SACJ;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;OAKG;IACH,0CAA0C;IAC1C,iBAAiB,CAAC,WAAW,EAAE,OAAO;QACpC,wFAAwF;QACxF,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,EAAC,KAAK,GAAG,IAAI,EAAC,GAAG,EAAE;QAC1D,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;QACrE,IAAI,KAAK,EAAE;YACT,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;SAC7B;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,EAAC,KAAK,GAAG,IAAI,EAAC,GAAG,EAAE;QAC7D,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,EAAE;YACtD,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC;YACpC,GAAG,WAAW;SACf,CAAC,CAAC;QACH,IAAI,KAAK,EAAE;YACT,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;SAC7B;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,eAAe,CAAC,OAAO,EAAE,EAAC,KAAK,GAAG,IAAI,EAAC,GAAG,EAAE;QAChD,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAC3D,IAAI,KAAK,EAAE;YACT,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;SAC7B;IACH,CAAC;IAED;;;OAGG;IACH,0CAA0C;IAC1C,KAAK,CAAC,WAAW;QACf,IAAI,gBAAC,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,EAAE;YACvC,gBAAG,CAAC,IAAI,CACN,MAAM,IAAI,CAAC,aAAa,4BAA4B,IAAI,CAAC,UAAU,qBAAqB,IAAI,CAAC,aAAa,IAAI;gBAC5G,gDAAgD,CACnD,CAAC;YACF,OAAO;SACR;QAED,gBAAG,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC;QAC9C,KAAK,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,+CAA+C,CAAC,CACnF,gBAAC,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,CACpC,EAAE;YACD,gBAAG,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;SAC7D;IACH,CAAC;IAED;;;;;;OAMG;IACH,0CAA0C;IAC1C,aAAa,CAAC,OAAO,EAAE,WAAW;QAChC,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;;OAMG;IACH,cAAc,CAAC,OAAO;QACpB,OAAO,CACL,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,WAAW;YAC9C,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CACtF,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,OAAO;QACb,MAAM,EAAC,SAAS,EAAC,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC7C,qBAAqB;QACrB,IAAI,WAAW,CAAC;QAChB,IAAI;YACF,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;SACxC;QAAC,OAAO,GAAG,EAAE;YACZ,MAAM,IAAI,cAAc,CAAC,oBAAoB,IAAI,CAAC,aAAa,iBAAiB,OAAO,EAAE,CAAC,CAAC;SAC5F;QACD,8CAA8C;QAC9C,IAAI,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE;YACtE,gBAAG,CAAC,KAAK,CAAC,YAAY,WAAW,qBAAqB,CAAC,CAAC;YACxD,OAAO,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;SACnC;QACD,gBAAG,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC,aAAa,OAAO,OAAO,EAAE,CAAC,CAAC;QAC3D,8DAA8D;QAC9D,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,SAAS,EAAE;YACd,MAAM,IAAI,cAAc,CACtB,iCAAiC,SAAS,iBAAiB,IAAI,CAAC,aAAa,KAAK,OAAO,GAAG,CAC7F,CAAC;SACH;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,OAAO;QACjB,OAAO,OAAO,IAAI,IAAI,CAAC,mBAAmB,CAAC;IAC7C,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,oBAAoB,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW;QACnE,MAAM,EAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAC,GAAG,WAAW,CAAC;QACrD,IAAI,CAAC,aAAa,EAAE;YAClB,MAAM,IAAI,SAAS,CACjB,8CAA8C,OAAO,IAAI,OAAO,wCAAwC,CACzG,CAAC;SACH;QACD,IAAI,YAAY,CAAC;QACjB,IAAI,gBAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE;YAC7B,MAAM,UAAU,GAAG,IAAA,sBAAW,EAAC,UAAU,EAAE,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;YAC9E,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;SACpC;aAAM;YACL,YAAY,GAAG,aAAa,CAAC;SAC9B;QACD,kDAAkD;QAClD,MAAM,MAAM,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC;QAC7E,IAAA,uBAAc,EAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACzC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,gBAAgB,CAAC,WAAW;QACjC,OAAO,gBAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,gBAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;OAMG;IACH,mBAAmB,CAAC,OAAO,EAAE,WAAW;QACtC,OAAO,eAAe,CAAC,oBAAoB,CACzC,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,aAAa,EAClB,OAAO,EACP,WAAW,CACZ,CAAC;IACJ,CAAC;CACF;AAhlBD,0CAglBC;;AAED;;;;;;;GAOG;AAEH;;;;;GAKG;AAEH;;;;GAIG;AAEH;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG;AAEH;;;;GAIG"}

package/build/lib/extension/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Loads extensions and creates `ExtensionConfig` instances.
+ *
+ * - Reads the manifest file, creating if necessary
+ * - Using the parsed extension data, creates/gets the `ExtensionConfig` subclass instances
+ * - Returns these instances
+ *
+ * If `appiumHome` is needed, use `resolveAppiumHome` from the `env` module in `@appium/support`.
+ * @param {string} appiumHome
+ * @returns {Promise<ExtensionConfigs>}
+ */
+export function loadExtensions(appiumHome: string): Promise<ExtensionConfigs>;
+/**
+ * Find any plugin name which has been installed, and which has been requested for activation by
+ * using the --use-plugins flag, and turn each one into its class, so we can send them as objects
+ * to the server init. We also want to send/assign them to the umbrella driver so it can use them
+ * to wrap command execution
+ *
+ * @param {import('./plugin-config').PluginConfig} pluginConfig - a plugin extension config
+ * @param {string[]} usePlugins
+ * @returns {PluginNameMap} Mapping of PluginClass to name
+ */
+export function getActivePlugins(pluginConfig: import('./plugin-config').PluginConfig, usePlugins?: string[]): PluginNameMap;
+/**
+ * Find any driver name which has been installed, and turn each one into its class, so we can send
+ * them as objects to the server init in case they need to add methods/routes or update the server.
+ * If the --drivers flag was given, this method only loads the given drivers.
+ *
+ * @param {import('./driver-config').DriverConfig} driverConfig - a driver extension config
+ * @param {string[]} [useDrivers] - optional list of drivers to load
+ * @returns {DriverNameMap}
+ */
+export function getActiveDrivers(driverConfig: import('./driver-config').DriverConfig, useDrivers?: string[] | undefined): DriverNameMap;
+/**
+ * A mapping of {@linkcode PluginClass } classes to their names.
+ */
+export type PluginNameMap = Map<PluginClass, string>;
+/**
+ * A mapping of {@linkcode DriverClass } classes to their names.
+ */
+export type DriverNameMap = Map<DriverClass, string>;
+export type PluginClass = import('@appium/types').PluginClass;
+export type DriverClass = import('@appium/types').DriverClass;
+export type ExtensionConfigs = {
+    driverConfig: import('./driver-config').DriverConfig;
+    pluginConfig: import('./plugin-config').PluginConfig;
+};
+//# sourceMappingURL=index.d.ts.map

package/build/lib/extension/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/extension/index.js"],"names":[],"mappings":"AAQA;;;;;;;;;;GAUG;AACH,2CAHW,MAAM,GACJ,QAAQ,gBAAgB,CAAC,CAUrC;AAED;;;;;;;;;GASG;AACH,+CAJW,OAAO,iBAAiB,EAAE,YAAY,eACtC,MAAM,EAAE,iBA2BlB;AAED;;;;;;;;GAQG;AACH,+CAJW,OAAO,iBAAiB,EAAE,YAAY,oDAwBhD;;;;4BAIY,IAAI,WAAW,EAAC,MAAM,CAAC;;;;4BAKvB,IAAI,WAAW,EAAC,MAAM,CAAC;0BAIvB,OAAO,eAAe,EAAE,WAAW;0BACnC,OAAO,eAAe,EAAE,WAAW;;kBAKlC,OAAO,iBAAiB,EAAE,YAAY;kBACtC,OAAO,iBAAiB,EAAE,YAAY"}