appium 2.0.0-beta.8 → 2.0.0-rc.1

package/build/lib/schema/schema.js

@@ -0,0 +1,640 @@
+"use strict";
+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 __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 __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var _a, _AppiumSchema_argSpecs, _AppiumSchema_registeredSchemas, _AppiumSchema_ajv, _AppiumSchema_instance, _AppiumSchema_finalizedSchemas;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAllowedSchemaFileExtension = exports.getDefaultsForExtension = exports.getDefaultsForSchema = exports.flattenSchema = exports.getSchema = exports.validate = exports.resetSchema = exports.finalizeSchema = exports.isFinalized = exports.hasArgSpec = exports.getArgSpec = exports.getAllArgSpecs = exports.registerSchema = exports.SchemaUnsupportedSchemaError = exports.SchemaUnknownSchemaError = exports.SchemaNameConflictError = exports.SchemaFinalizationError = exports.ALLOWED_SCHEMA_EXTENSIONS = exports.RoachHotelMap = void 0;
+const ajv_1 = __importDefault(require("ajv"));
+const ajv_formats_1 = __importDefault(require("ajv-formats"));
+const lodash_1 = __importDefault(require("lodash"));
+const path_1 = __importDefault(require("path"));
+const constants_1 = require("../constants");
+const schema_1 = require("@appium/schema");
+const arg_spec_1 = require("./arg-spec");
+const keywords_1 = require("./keywords");
+/**
+ * Key/value pairs go in... but they don't come out.
+ *
+ * @template K,V
+ * @extends {Map<K,V>}
+ */
+class RoachHotelMap extends Map {
+    /**
+     * @param {K} key
+     * @param {V} value
+     */
+    set(key, value) {
+        if (this.has(key)) {
+            throw new Error(`${key} is already set`);
+        }
+        return super.set(key, value);
+    }
+    /**
+     * @param {K} key
+     */
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    delete(key) {
+        return false;
+    }
+    clear() {
+        throw new Error(`Cannot clear RoachHotelMap`);
+    }
+}
+exports.RoachHotelMap = RoachHotelMap;
+/**
+ * Extensions that an extension schema file can have.
+ */
+exports.ALLOWED_SCHEMA_EXTENSIONS = Object.freeze(new Set(/** @type {AllowedSchemaExtension[]} */ (['.json', '.js', '.cjs'])));
+const SCHEMA_KEY = '$schema';
+/**
+ * A wrapper around Ajv and schema-related functions.
+ *
+ * Should have been named Highlander, because _there can only be one_
+ */
+class AppiumSchema {
+    /**
+     * Initializes Ajv, adds standard formats and our custom keywords.
+     * @see https://npm.im/ajv-formats
+     * @private
+     */
+    constructor() {
+        /**
+         * A mapping of unique argument IDs to their corresponding {@link ArgSpec}s.
+         *
+         * An "argument" is a CLI argument or a config property.
+         *
+         * Used to provide easy lookups of argument metadata when converting between different representations of those arguments.
+         * @type {RoachHotelMap<string,ArgSpec>}
+         */
+        _AppiumSchema_argSpecs.set(this, new RoachHotelMap());
+        /**
+         * A map of extension types to extension names to schema objects.
+         *
+         * This data structure is used to ensure there are no naming conflicts. The schemas
+         * are stored here in memory until the instance is _finalized_.
+         * @type {Record<ExtensionType,Map<string,SchemaObject>>}
+         */
+        _AppiumSchema_registeredSchemas.set(this, { [constants_1.DRIVER_TYPE]: new Map(), [constants_1.PLUGIN_TYPE]: new Map() });
+        /**
+         * Ajv instance
+         *
+         * @type {Ajv}
+         */
+        _AppiumSchema_ajv.set(this, void 0);
+        /**
+         * Lookup of schema IDs to finalized schemas.
+         *
+         * This does not include references, but rather the root schemas themselves.
+         * @type {Record<string,StrictSchemaObject>?}
+         */
+        _AppiumSchema_finalizedSchemas.set(this, null);
+        __classPrivateFieldSet(this, _AppiumSchema_ajv, AppiumSchema._instantiateAjv(), "f");
+    }
+    /**
+     * Factory function for {@link AppiumSchema} instances.
+     *
+     * Returns a singleton instance if one exists, otherwise creates a new one.
+     * Binds public methods to the instance.
+     * @returns {AppiumSchema}
+     */
+    static create() {
+        if (!__classPrivateFieldGet(AppiumSchema, _a, "f", _AppiumSchema_instance)) {
+            const instance = new AppiumSchema();
+            __classPrivateFieldSet(AppiumSchema, _a, instance, "f", _AppiumSchema_instance);
+            lodash_1.default.bindAll(instance, [
+                'finalize',
+                'flatten',
+                'getAllArgSpecs',
+                'getArgSpec',
+                'getDefaults',
+                'getDefaultsForExtension',
+                'getSchema',
+                'hasArgSpec',
+                'isFinalized',
+                'registerSchema',
+                'hasRegisteredSchema',
+                'reset',
+                'validate',
+            ]);
+        }
+        return __classPrivateFieldGet(AppiumSchema, _a, "f", _AppiumSchema_instance);
+    }
+    /**
+     * Returns `true` if a schema has been registered using given extension type and name.
+     *
+     * This does not depend on whether or not the instance has been _finalized_.
+     * @param {ExtensionType} extType - Extension type
+     * @param {string} extName - Name
+     * @returns {boolean} If registered
+     */
+    hasRegisteredSchema(extType, extName) {
+        return __classPrivateFieldGet(this, _AppiumSchema_registeredSchemas, "f")[extType].has(extName);
+    }
+    /**
+     * Return `true` if {@link AppiumSchema.finalize finalize} has been called
+     * successfully and {@link AppiumSchema.reset reset} has not been called since.
+     * @returns {boolean} If finalized
+     */
+    isFinalized() {
+        return Boolean(__classPrivateFieldGet(this, _AppiumSchema_finalizedSchemas, "f"));
+    }
+    getAllArgSpecs() {
+        return __classPrivateFieldGet(this, _AppiumSchema_argSpecs, "f");
+    }
+    /**
+     * Call this when no more schemas will be registered.
+     *
+     * This does three things:
+     * 1. It combines all schemas from extensions into the Appium config schema,
+     *    then adds the result to the `Ajv` instance.
+     * 2. It adds schemas for _each_ argument/property for validation purposes.
+     *    The CLI uses these schemas to validate specific arguments.
+     * 3. The schemas are validated against JSON schema draft-07 (which is the
+     *    only one supported at this time)
+     *
+     * Any method in this instance that needs to interact with the `Ajv` instance
+     * will throw if this method has not been called.
+     *
+     * If the instance has already been finalized, this is a no-op.
+     * @public
+     * @throws {Error} If the schema is not valid
+     * @returns {Readonly<Record<string,StrictSchemaObject>>} Record of schema IDs to full schema objects
+     */
+    finalize() {
+        if (this.isFinalized()) {
+            return /** @type {Record<string,StrictSchemaObject>} */ (__classPrivateFieldGet(this, _AppiumSchema_finalizedSchemas, "f"));
+        }
+        const ajv = __classPrivateFieldGet(this, _AppiumSchema_ajv, "f");
+        // Ajv will _mutate_ the schema, so we need to clone it.
+        const baseSchema = lodash_1.default.cloneDeep(schema_1.AppiumConfigJsonSchema);
+        /**
+         *
+         * @param {SchemaObject} schema
+         * @param {ExtensionType} [extType]
+         * @param {string} [extName]
+         */
+        const addArgSpecs = (schema, extType, extName) => {
+            for (let [propName, propSchema] of Object.entries(schema)) {
+                const argSpec = arg_spec_1.ArgSpec.create(propName, {
+                    dest: propSchema.appiumCliDest,
+                    defaultValue: propSchema.default,
+                    extType,
+                    extName,
+                });
+                const { arg } = argSpec;
+                __classPrivateFieldGet(this, _AppiumSchema_argSpecs, "f").set(arg, argSpec);
+            }
+        };
+        addArgSpecs(lodash_1.default.omit(baseSchema.properties.server.properties, [constants_1.DRIVER_TYPE, constants_1.PLUGIN_TYPE]));
+        /**
+         * @type {Record<string,StrictSchemaObject>}
+         */
+        const finalizedSchemas = {};
+        const finalSchema = lodash_1.default.reduce(__classPrivateFieldGet(this, _AppiumSchema_registeredSchemas, "f"), 
+        /**
+         * @param {typeof baseSchema} baseSchema
+         * @param {Map<string,SchemaObject>} extensionSchemas
+         * @param {ExtensionType} extType
+         */
+        (baseSchema, extensionSchemas, extType) => {
+            extensionSchemas.forEach((schema, extName) => {
+                const $ref = arg_spec_1.ArgSpec.toSchemaBaseRef(extType, extName);
+                schema.$id = $ref;
+                schema.additionalProperties = false; // this makes `schema` become a `StrictSchemaObject`
+                baseSchema.properties.server.properties[extType].properties[extName] = {
+                    $ref,
+                    $comment: extName,
+                };
+                ajv.validateSchema(schema, true);
+                addArgSpecs(schema.properties, extType, extName);
+                ajv.addSchema(schema, $ref);
+                finalizedSchemas[$ref] = /** @type {StrictSchemaObject} */ (schema);
+            });
+            return baseSchema;
+        }, baseSchema);
+        ajv.addSchema(finalSchema, arg_spec_1.APPIUM_CONFIG_SCHEMA_ID);
+        finalizedSchemas[arg_spec_1.APPIUM_CONFIG_SCHEMA_ID] = finalSchema;
+        ajv.validateSchema(finalSchema, true);
+        __classPrivateFieldSet(this, _AppiumSchema_finalizedSchemas, finalizedSchemas, "f");
+        return Object.freeze(finalizedSchemas);
+    }
+    /**
+     * Configures and creates an Ajv instance.
+     * @private
+     * @returns {Ajv}
+     */
+    static _instantiateAjv() {
+        const ajv = (0, ajv_formats_1.default)(new ajv_1.default({
+            // without this not much validation actually happens
+            allErrors: true,
+        }));
+        // add custom keywords to ajv. see schema-keywords.js
+        lodash_1.default.forEach(keywords_1.keywords, (keyword) => {
+            ajv.addKeyword(keyword);
+        });
+        return ajv;
+    }
+    /**
+     * Resets this instance to its original state.
+     *
+     * - Removes all added schemas from the `Ajv` instance
+     * - Resets the map of {@link ArgSpec ArgSpecs}
+     * - Resets the map of registered schemas
+     * - Sets the {@link AppiumSchema._finalized _finalized} flag to `false`
+     *
+     * If you need to call {@link AppiumSchema.finalize} again, you'll want to call this first.
+     * @returns {void}
+     */
+    reset() {
+        for (const schemaId of Object.keys(__classPrivateFieldGet(this, _AppiumSchema_finalizedSchemas, "f") ?? {})) {
+            __classPrivateFieldGet(this, _AppiumSchema_ajv, "f").removeSchema(schemaId);
+        }
+        __classPrivateFieldSet(this, _AppiumSchema_argSpecs, new RoachHotelMap(), "f");
+        __classPrivateFieldSet(this, _AppiumSchema_registeredSchemas, {
+            [constants_1.DRIVER_TYPE]: new Map(),
+            [constants_1.PLUGIN_TYPE]: new Map(),
+        }, "f");
+        __classPrivateFieldSet(this, _AppiumSchema_finalizedSchemas, null, "f");
+        // Ajv seems to have an over-eager cache, so we have to dump the object entirely.
+        __classPrivateFieldSet(this, _AppiumSchema_ajv, AppiumSchema._instantiateAjv(), "f");
+    }
+    /**
+     * Registers a schema from an extension.
+     *
+     * This is "fail-fast" in that the schema will immediately be validated against JSON schema draft-07 _or_ whatever the value of the schema's `$schema` prop is.
+     *
+     * Does _not_ add the schema to the `ajv` instance (this is done by {@link AppiumSchema.finalize}).
+     * @param {ExtensionType} extType - Extension type
+     * @param {string} extName - Unique extension name for `type`
+     * @param {SchemaObject} schema - Schema object
+     * @throws {SchemaNameConflictError} If the schema is an invalid
+     * @returns {void}
+     */
+    registerSchema(extType, extName, schema) {
+        if (!(extType && extName) || lodash_1.default.isUndefined(schema)) {
+            throw new TypeError('Expected extension type, extension name, and a defined schema');
+        }
+        if (!AppiumSchema.isSupportedSchemaType(schema)) {
+            throw new SchemaUnsupportedSchemaError(schema, extType, extName);
+        }
+        const normalizedExtName = lodash_1.default.kebabCase(extName);
+        if (this.hasRegisteredSchema(extType, normalizedExtName)) {
+            if (lodash_1.default.isEqual(__classPrivateFieldGet(this, _AppiumSchema_registeredSchemas, "f")[extType].get(normalizedExtName), schema)) {
+                return;
+            }
+            throw new SchemaNameConflictError(extType, extName);
+        }
+        __classPrivateFieldGet(this, _AppiumSchema_ajv, "f").validateSchema(schema, true);
+        __classPrivateFieldGet(this, _AppiumSchema_registeredSchemas, "f")[extType].set(normalizedExtName, schema);
+    }
+    /**
+     * Returns a {@link ArgSpec} for the given argument name.
+     * @param {string} name - CLI argument name
+     * @param {ExtensionType} [extType] - Extension type
+     * @param {string} [extName] - Extension name
+     * @returns {ArgSpec|undefined} ArgSpec or `undefined` if not found
+     */
+    getArgSpec(name, extType, extName) {
+        return __classPrivateFieldGet(this, _AppiumSchema_argSpecs, "f").get(arg_spec_1.ArgSpec.toArg(name, extType, extName));
+    }
+    /**
+     * Returns `true` if the instance knows about an argument by the given `name`.
+     * @param {string} name - CLI argument name
+     * @param {ExtensionType} [extType] - Extension type
+     * @param {string} [extName] - Extension name
+     * @returns {boolean} `true` if such an {@link ArgSpec} exists
+     */
+    hasArgSpec(name, extType, extName) {
+        return __classPrivateFieldGet(this, _AppiumSchema_argSpecs, "f").has(arg_spec_1.ArgSpec.toArg(name, extType, extName));
+    }
+    /**
+     * Returns a `Record` of argument "dest" strings to default values.
+     *
+     * The "dest" string is the property name in object returned by
+     * `argparse.ArgumentParser['parse_args']`.
+     * @template {boolean|undefined} Flattened
+     * @param {Flattened} [flatten=true] - If `true`, flattens the returned object
+     * using "keypath"-style keys of the format `<extType>.<extName>.<argName>`.
+     * Otherwise, returns a nested object using `extType` and `extName` as
+     * properties. Base arguments (server arguments) are always at the top level.
+     * @returns {DefaultValues<Flattened>}
+     */
+    getDefaults(flatten = /** @type {Flattened} */ (true)) {
+        if (!this.isFinalized()) {
+            throw new SchemaFinalizationError();
+        }
+        /**
+         * @private
+         * @callback DefaultReducer
+         * @param {DefaultValues<Flattened>} defaults
+         * @param {ArgSpec} argSpec
+         * @returns {DefaultValues<Flattened>}
+         */
+        /** @type {DefaultReducer} */
+        const reducer = flatten
+            ? (defaults, { defaultValue, dest }) => {
+                if (!lodash_1.default.isUndefined(defaultValue)) {
+                    defaults[dest] = defaultValue;
+                }
+                return defaults;
+            }
+            : (defaults, { defaultValue, dest }) => {
+                if (!lodash_1.default.isUndefined(defaultValue)) {
+                    lodash_1.default.set(defaults, dest, defaultValue);
+                }
+                return defaults;
+            };
+        /** @type {DefaultValues<Flattened>} */
+        const retval = {};
+        return [...__classPrivateFieldGet(this, _AppiumSchema_argSpecs, "f").values()].reduce(reducer, retval);
+    }
+    /**
+     * Returns a flattened Record of defaults for a specific extension. Keys will
+     * be of format `<argName>`.
+     * @param {ExtensionType} extType - Extension type
+     * @param {string} extName - Extension name
+     * @returns {Record<string,ArgSpecDefaultValue>}
+     */
+    getDefaultsForExtension(extType, extName) {
+        if (!this.isFinalized()) {
+            throw new SchemaFinalizationError();
+        }
+        const specs = [...__classPrivateFieldGet(this, _AppiumSchema_argSpecs, "f").values()].filter((spec) => spec.extType === extType && spec.extName === extName);
+        return specs.reduce((defaults, { defaultValue, rawDest }) => {
+            if (!lodash_1.default.isUndefined(defaultValue)) {
+                defaults[rawDest] = defaultValue;
+            }
+            return defaults;
+        }, {});
+    }
+    /**
+     * Flatten schema into an array of `SchemaObject`s and associated
+     * {@link ArgSpec ArgSpecs}.
+     *
+     * Converts nested extension schemas to keys based on the extension type and
+     * name. Used when translating to `argparse` options or getting the list of
+     * default values (see {@link AppiumSchema.getDefaults}) for CLI or otherwise.
+     *
+     * The return value is an intermediate reprsentation used by `cli-args`
+     * module's `toParserArgs`, which converts the finalized schema to parameters
+     * used by `argparse`.
+     * @throws If {@link AppiumSchema.finalize} has not been called yet.
+     * @returns {FlattenedSchema}
+     */
+    flatten() {
+        const schema = this.getSchema();
+        /** @type { {properties: SchemaObject, prefix: string[]}[] } */
+        const stack = [{ properties: schema.properties, prefix: [] }];
+        /** @type {FlattenedSchema} */
+        const flattened = [];
+        // this bit is a recursive algorithm rewritten as a for loop.
+        // when we find something we want to traverse, we add it to `stack`
+        for (const { properties, prefix } of stack) {
+            const pairs = lodash_1.default.toPairs(properties);
+            for (const [key, value] of pairs) {
+                if (key === SCHEMA_KEY) {
+                    continue;
+                }
+                const { properties, $ref } = value;
+                if (properties) {
+                    stack.push({
+                        properties,
+                        prefix: key === arg_spec_1.SERVER_PROP_NAME ? [] : [...prefix, key],
+                    });
+                }
+                else if ($ref) {
+                    let refSchema;
+                    try {
+                        refSchema = this.getSchema($ref);
+                    }
+                    catch (err) {
+                        // this can happen if an extension schema supplies a $ref to a non-existent schema
+                        throw new SchemaUnknownSchemaError($ref);
+                    }
+                    const { normalizedExtName } = arg_spec_1.ArgSpec.extensionInfoFromRootSchemaId($ref);
+                    if (!normalizedExtName) {
+                        /* istanbul ignore next */
+                        throw new ReferenceError(`Could not determine extension name from schema ID ${$ref}. This is a bug.`);
+                    }
+                    stack.push({
+                        properties: refSchema.properties,
+                        prefix: [...prefix, key, normalizedExtName],
+                    });
+                }
+                else if (key !== constants_1.DRIVER_TYPE && key !== constants_1.PLUGIN_TYPE) {
+                    const [extType, extName] = prefix;
+                    const argSpec = this.getArgSpec(key, /** @type {ExtensionType} */ (extType), extName);
+                    if (!argSpec) {
+                        /* istanbul ignore next */
+                        throw new ReferenceError(`Unknown argument with key ${key}, extType ${extType} and extName ${extName}. This is a bug.`);
+                    }
+                    flattened.push({ schema: lodash_1.default.cloneDeep(value), argSpec });
+                }
+            }
+        }
+        return flattened;
+    }
+    /**
+     * Retrieves the schema itself
+     * @public
+     * @param {string} [ref] - Schema ID
+     * @throws If the schema has not yet been finalized
+     * @returns {SchemaObject}
+     */
+    getSchema(ref = arg_spec_1.APPIUM_CONFIG_SCHEMA_ID) {
+        return /** @type {SchemaObject} */ (this._getValidator(ref).schema);
+    }
+    /**
+     * Retrieves schema validator function from Ajv
+     * @param {string} [id] - Schema ID
+     * @private
+     * @returns {import('ajv').ValidateFunction}
+     */
+    _getValidator(id = arg_spec_1.APPIUM_CONFIG_SCHEMA_ID) {
+        const validator = __classPrivateFieldGet(this, _AppiumSchema_ajv, "f").getSchema(id);
+        if (!validator) {
+            if (id === arg_spec_1.APPIUM_CONFIG_SCHEMA_ID) {
+                throw new SchemaFinalizationError();
+            }
+            else {
+                throw new SchemaUnknownSchemaError(id);
+            }
+        }
+        return validator;
+    }
+    /**
+     * Given an object, validates it against the Appium config schema.
+     * If errors occur, the returned array will be non-empty.
+     * @param {any} value - The value (hopefully an object) to validate against the schema
+     * @param {string} [ref] - Schema ID or ref.
+     * @public
+     * @returns {import('ajv').ErrorObject[]} Array of errors, if any.
+     */
+    validate(value, ref = arg_spec_1.APPIUM_CONFIG_SCHEMA_ID) {
+        const validator = this._getValidator(ref);
+        return !validator(value) && lodash_1.default.isArray(validator.errors) ? [...validator.errors] : [];
+    }
+    /**
+     * Returns `true` if `filename`'s file extension is allowed (in {@link ALLOWED_SCHEMA_EXTENSIONS}).
+     * @param {import('type-fest').LiteralUnion<AllowedSchemaExtension, string>} filename
+     * @returns {boolean}
+     */
+    static isAllowedSchemaFileExtension(filename) {
+        return exports.ALLOWED_SCHEMA_EXTENSIONS.has(
+        /** @type {AllowedSchemaExtension} */ (path_1.default.extname(filename)));
+    }
+    /**
+     * Returns `true` if `schema` is a plain object with a non-true `$async` property.
+     * @param {any} schema - Schema to check
+     * @returns {schema is SchemaObject}
+     */
+    static isSupportedSchemaType(schema) {
+        return lodash_1.default.isPlainObject(schema) && schema.$async !== true;
+    }
+}
+_a = AppiumSchema, _AppiumSchema_argSpecs = new WeakMap(), _AppiumSchema_registeredSchemas = new WeakMap(), _AppiumSchema_ajv = new WeakMap(), _AppiumSchema_finalizedSchemas = new WeakMap();
+/**
+ * Singleton instance.
+ * @type {AppiumSchema}
+ */
+_AppiumSchema_instance = { value: void 0 };
+/**
+ * Thrown when the {@link AppiumSchema} instance has not yet been finalized, but
+ * the method called requires it.
+ */
+class SchemaFinalizationError extends Error {
+    constructor() {
+        super('Schema not yet finalized; `finalize()` must be called first.');
+        /**
+         * @type {Readonly<string>}
+         */
+        this.code = 'APPIUMERR_SCHEMA_FINALIZATION';
+    }
+}
+exports.SchemaFinalizationError = SchemaFinalizationError;
+/**
+ * Thrown when a "unique" schema ID conflicts with an existing schema ID.
+ *
+ * This is likely going to be caused by attempting to register the same schema twice.
+ */
+class SchemaNameConflictError extends Error {
+    /**
+     * @param {ExtensionType} extType
+     * @param {string} extName
+     */
+    constructor(extType, extName) {
+        super(`Name for ${extType} schema "${extName}" conflicts with an existing schema`);
+        /**
+         * @type {Readonly<string>}
+         */
+        this.code = 'APPIUMERR_SCHEMA_NAME_CONFLICT';
+        this.data = { extType, extName };
+    }
+}
+exports.SchemaNameConflictError = SchemaNameConflictError;
+/**
+ * Thrown when a schema ID was expected, but it doesn't exist on the {@link Ajv} instance.
+ */
+class SchemaUnknownSchemaError extends ReferenceError {
+    /**
+     * @param {string} schemaId
+     */
+    constructor(schemaId) {
+        super(`Unknown schema: "${schemaId}"`);
+        /**
+         * @type {Readonly<string>}
+         */
+        this.code = 'APPIUMERR_SCHEMA_UNKNOWN_SCHEMA';
+        this.data = { schemaId };
+    }
+}
+exports.SchemaUnknownSchemaError = SchemaUnknownSchemaError;
+/**
+ * Thrown when a schema is provided, but it's of an unsupported type.
+ *
+ * "Valid" schemas which are unsupported include boolean schemas and async schemas
+ * (having a `true` `$async` property).
+ */
+class SchemaUnsupportedSchemaError extends TypeError {
+    /**
+     * @param {any} schema
+     * @param {ExtensionType} extType
+     * @param {string} extName
+     */
+    constructor(schema, extType, extName) {
+        // https://github.com/Microsoft/TypeScript/issues/8277
+        super((() => {
+            let msg = `Unsupported schema from ${extType} "${extName}":`;
+            if (lodash_1.default.isBoolean(schema)) {
+                return `${msg} schema cannot be a boolean`;
+            }
+            if (lodash_1.default.isPlainObject(schema)) {
+                if (schema.$async) {
+                    return `${msg} schema cannot be an async schema`;
+                }
+                /* istanbul ignore next */
+                throw new TypeError(`schema IS supported; this error should not be thrown (this is a bug). value of schema: ${JSON.stringify(schema)}`);
+            }
+            return `${msg} schema must be a plain object without a true "$async" property`;
+        })());
+        /**
+         * @type {Readonly<string>}
+         */
+        this.code = 'APPIUMERR_SCHEMA_UNSUPPORTED_SCHEMA';
+        this.data = { schema, extType, extName };
+    }
+}
+exports.SchemaUnsupportedSchemaError = SchemaUnsupportedSchemaError;
+const appiumSchema = AppiumSchema.create();
+exports.registerSchema = appiumSchema.registerSchema, exports.getAllArgSpecs = appiumSchema.getAllArgSpecs, exports.getArgSpec = appiumSchema.getArgSpec, exports.hasArgSpec = appiumSchema.hasArgSpec, exports.isFinalized = appiumSchema.isFinalized, exports.finalizeSchema = appiumSchema.finalize, exports.resetSchema = appiumSchema.reset, exports.validate = appiumSchema.validate, exports.getSchema = appiumSchema.getSchema, exports.flattenSchema = appiumSchema.flatten, exports.getDefaultsForSchema = appiumSchema.getDefaults, exports.getDefaultsForExtension = appiumSchema.getDefaultsForExtension;
+exports.isAllowedSchemaFileExtension = AppiumSchema.isAllowedSchemaFileExtension;
+/**
+ * Appium only supports schemas that are plain objects; not arrays.
+ * @typedef {import('ajv').SchemaObject & {[key: number]: never}} SchemaObject
+ */
+/**
+ * @typedef {import('@appium/types').ExtensionType} ExtensionType
+ */
+/**
+ * An object having property `additionalProperties: false`
+ * @typedef StrictProp
+ * @property {false} additionalProperties
+ */
+/**
+ * A {@link SchemaObject} with `additionalProperties: false`
+ * @typedef {SchemaObject & StrictProp} StrictSchemaObject
+ */
+/**
+ * A list of schemas associated with properties and their corresponding {@link ArgSpec} objects.
+ *
+ * Intermediate data structure used when converting the entire schema down to CLI arguments.
+ * @typedef { {schema: SchemaObject, argSpec: ArgSpec}[] } FlattenedSchema
+ */
+/**
+ * @typedef {ArgSpec['defaultValue']} ArgSpecDefaultValue
+ */
+/**
+ * e.g. `{driver: {foo: 'bar'}}` where `foo` is the arg name and `bar` is the default value.
+ * @typedef {Record<string,Record<string,ArgSpecDefaultValue>>} NestedArgSpecDefaultValue
+ */
+/**
+ * Helper type for the return value of {@link AppiumSchema.getDefaults}
+ * @template {boolean|undefined} Flattened
+ * @typedef {Record<string,Flattened extends true ? ArgSpecDefaultValue : ArgSpecDefaultValue | NestedArgSpecDefaultValue>} DefaultValues
+ */
+/**
+ * @typedef {'.json'|'.js'|'.cjs'} AllowedSchemaExtension
+ */
+//# sourceMappingURL=schema.js.map

package/build/lib/schema/schema.js.map

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