appium 3.2.2 → 3.3.1

package/build/lib/schema/arg-spec.d.ts

@@ -1,143 +1,68 @@
+import type { ExtensionType } from '@appium/types';
 /**
  * The original ID of the Appium config schema.
  * We use this in the CLI to convert it to `argparse` options.
  */
-export const APPIUM_CONFIG_SCHEMA_ID: "appium.json";
+export declare const APPIUM_CONFIG_SCHEMA_ID = "appium.json";
 /**
  * The schema prop containing server-related options. Everything in here
  * is "native" to Appium.
- * Used by {@link flattenSchema} for transforming the schema into CLI args.
  */
-export const SERVER_PROP_NAME: "server";
+export declare const SERVER_PROP_NAME = "server";
+export interface ArgSpecOptions<D = unknown> {
+    extName?: string;
+    extType?: ExtensionType;
+    dest?: string;
+    defaultValue?: D;
+}
 /**
  * An `ArgSpec` is a class representing metadata about an argument (or config
  * option) used for cross-referencing.
  *
- * This class has no instance methods, and is basically just a read-only "struct".
- * @template D
+ * This class has no instance methods beyond stringification and is effectively
+ * a read-only struct.
  */
-export class ArgSpec<D> {
+export declare class ArgSpec<D = unknown> {
+    readonly name: string;
+    readonly extType?: ExtensionType;
+    readonly extName?: string;
+    readonly ref: string;
+    readonly arg: string;
+    readonly dest: string;
+    readonly rawDest: string;
+    readonly defaultValue?: D;
+    /**
+     * Builds computed fields and assigns them to the instance.
+     * Use {@link ArgSpec.create} instead of `new ArgSpec()`.
+     */
+    constructor(name: string, { extType, extName, dest, defaultValue }?: ArgSpecOptions<D>);
     /**
-     * Return the schema ID (`$id`) for the **argument** given the parameters.
-     *
-     * If you need the "root" or "base" schema ID, use {@link ArgSpec.toSchemaBaseRef} instead.
-     * @param {string} name - Argument name
-     * @param {ExtensionType} [extType] - Extension type
-     * @param {string} [extName] - Extension name
-     * @returns {string} Schema ID
+     * Return the schema ID (`$id`) for the argument given the parameters.
      */
     static toSchemaRef(name: string, extType?: ExtensionType, extName?: string): string;
     /**
-     * Return the schema ID for an extension or the base schema ID.
-     * @param {ExtensionType} [extType] - Extension type
-     * @param {string} [extName] - Extension name
+     * Return the root schema ID for an extension or Appium base schema.
      */
     static toSchemaBaseRef(extType?: ExtensionType, extName?: string): string;
     /**
-     * Return the unique ID for the argument given the parameters.
-     * @param {string} name - Argument name
-     * @param {ExtensionType} [extType] - Extension type
-     * @param {string} [extName] - Extension name
-     * @returns {string} Unique ID
+     * Return the unique CLI argument key for the argument.
      */
     static toArg(name: string, extType?: ExtensionType, extName?: string): string;
     /**
-     * Normalizes a raw extension name (not including the type).
-     * @param {string} extName - Extension name
-     * @returns {string} Normalized extension name
+     * Normalizes a raw extension name (not including type).
      */
     static toNormalizedExtName(extName: string): string;
     /**
-     * When given the root ID of a schema for an extension (`<extType>-<normalizedExtName>.json`) Returns an object containing the extension type and the _normalized_ extension name.
-     * @param {string} schemaId - Root schema ID
-     * @returns { {extType?: ExtensionType, normalizedExtName?: string} }
+     * Parse root schema ID (`<extType>-<normalizedExtName>.json`) to extension info.
      */
     static extensionInfoFromRootSchemaId(schemaId: string): {
         extType?: ExtensionType;
         normalizedExtName?: string;
     };
     /**
-     * Creates an `ArgSpec`
-     *
-     * @param {string} name - The canonical name of the argument. Corresponds to a key in a schema's
-     * `properties` property.
-     * @template D
-     * @param {ArgSpecOptions<D>} [opts] - Options
-     * @returns {Readonly<ArgSpec>}
-     */
-    static create<D_1>(name: string, opts?: ArgSpecOptions<D_1>): Readonly<ArgSpec<any>>;
-    /**
-     * Builds some computed fields and assigns them to the instance.
-     *
-     * Undefined properties are not assigned.
-     *
-     * The _constructor_ is private. Use {@link ArgSpec.create} instead.
-     * @private
-     * @param {string} name
-     * @param {ArgSpecOptions<D>} opts
-     */
-    private constructor();
-    /**
-     * The canonical name of the argument. Corresponds to key in schema's `properties` prop.
-     * @type {string}
-     */
-    name: string;
-    /**
-     * The `ExtensionType` of the argument. This will be set if the arg came from an extension;
-     * otherwise it will be `undefined`.
-     * @type {ExtensionType|undefined}
-     */
-    extType: ExtensionType | undefined;
-    /**
-     * The name of the extension, if this argument came from an extension.
-     *
-     * Otherwise `undefined`.
-     * @type {string|undefined}
-     */
-    extName: string | undefined;
-    /**
-     * The schema ID (`$id`) for the argument.  This is automatically determined, and any user-provided `$id`s will be overwritten.
-     *
-     * @type {string}
-     */
-    ref: string;
-    /**
-     * The CLI argument, sans leading dashes.
-     * @type {string}
-     */
-    arg: string;
-    /**
-     * The desired keypath for the argument after arguments have been parsed.
-     *
-     * Typically this is camelCased.  If the arg came from an extension, it will be prefixed with
-     * `<extType>.<extName>.`
-     * @type {string}
-     */
-    dest: string;
-    /**
-     * The same as {@link ArgSpec.dest} but without the leading `<extType>.<extName>.` prefix.
-     */
-    rawDest: string;
-    /**
-     * Whatever the default value of this argument is, as specified by the
-     * `default` property of the schema.
-     * @type {D|undefined}
-     */
-    defaultValue: D | undefined;
-    /**
-     * String representation, useful for debugging
-     * @returns {string}
+     * Creates a frozen `ArgSpec`.
      */
+    static create<D = unknown>(name: string, opts?: ArgSpecOptions<D>): Readonly<ArgSpec<D>>;
     toString(): string;
 }
-/**
- * Options for {@link ArgSpec.create}
- */
-export type ArgSpecOptions<D> = {
-    extName?: string | undefined;
-    extType?: import("@appium/types").ExtensionType | undefined;
-    dest?: string | undefined;
-    defaultValue?: D | undefined;
-};
-export type ExtensionType = import("@appium/types").ExtensionType;
 //# sourceMappingURL=arg-spec.d.ts.map

package/build/lib/schema/arg-spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arg-spec.d.ts","sourceRoot":"","sources":["../../../lib/schema/arg-spec.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH,sCAAuC,aAAa,CAAC;AAErD;;;;GAIG;AACH,+BAAgC,QAAQ,CAAC;AAYzC;;;;;;GAMG;AACH,qBAFa,CAAC;IA2FZ;;;;;;;;OAQG;IACH,yBALW,MAAM,YACN,aAAa,YACb,MAAM,GACJ,MAAM,CAQlB;IAED;;;;OAIG;IACH,iCAHW,aAAa,YACb,MAAM,UAOhB;IAED;;;;;;OAMG;IACH,mBALW,MAAM,YACN,aAAa,YACb,MAAM,GACJ,MAAM,CAQlB;IAED;;;;OAIG;IACH,oCAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;;OAIG;IACH,+CAHW,MAAM,GACH;QAAC,OAAO,CAAC,EAAE,aAAa,CAAC;QAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAC,CAUlE;IAED;;;;;;;;OAQG;IACH,yBANW,MAAM,SAGN,cAAc,CAAC,GAAC,CAAC,GACf,QAAQ,cAAS,CAI7B;IAhHD;;;;;;;;;OASG;IACH,sBAqBC;IAtFD;;;OAGG;IACH,MAFU,MAAM,CAEX;IAEL;;;;OAIG;IACH,SAFU,aAAa,GAAC,SAAS,CAEzB;IAER;;;;;OAKG;IACH,SAFU,MAAM,GAAC,SAAS,CAElB;IAER;;;;OAIG;IACH,KAFU,MAAM,CAEZ;IAEJ;;;OAGG;IACH,KAFU,MAAM,CAEZ;IAEJ;;;;;;OAMG;IACH,MAFU,MAAM,CAEX;IAEL;;OAEG;IACH,gBAAQ;IAER;;;;OAIG;IACH,cAFU,CAAC,GAAC,SAAS,CAER;IAoHb;;;OAGG;IAEH,YAHa,MAAM,CASlB;CACF;;;;2BAIY,CAAC;;;;;;4BASD,OAAO,eAAe,EAAE,aAAa"}
+{"version":3,"file":"arg-spec.d.ts","sourceRoot":"","sources":["../../../lib/schema/arg-spec.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,eAAe,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,uBAAuB,gBAAgB,CAAC;AACrD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,WAAW,CAAC;AAIzC,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,CAAC,CAAC;CAClB;AAED;;;;;;GAMG;AACH,qBAAa,OAAO,CAAC,CAAC,GAAG,OAAO;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IAE1B;;;OAGG;gBACS,IAAI,EAAE,MAAM,EAAE,EAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAC,GAAE,cAAc,CAAC,CAAC,CAAM;IAgBxF;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAQnF;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAOzE;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAQ7E;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAInD;;OAEG;IACH,MAAM,CAAC,6BAA6B,CAClC,QAAQ,EAAE,MAAM,GACf;QAAC,OAAO,CAAC,EAAE,aAAa,CAAC;QAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAC;IAYxD;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAIxF,QAAQ,IAAI,MAAM;CAOnB"}

package/build/lib/schema/arg-spec.js

@@ -13,89 +13,33 @@ exports.APPIUM_CONFIG_SCHEMA_ID = 'appium.json';
 /**
  * The schema prop containing server-related options. Everything in here
  * is "native" to Appium.
- * Used by {@link flattenSchema} for transforming the schema into CLI args.
  */
 exports.SERVER_PROP_NAME = 'server';
-/**
- * Used to parse extension info from a schema ID.
- */
 const SCHEMA_ID_REGEXP = /^(?<extType>.+?)-(?<normalizedExtName>.+)\.json$/;
-/**
- * Avoid typos by using constants!
- */
 const PROPERTIES = 'properties';
 /**
  * An `ArgSpec` is a class representing metadata about an argument (or config
  * option) used for cross-referencing.
  *
- * This class has no instance methods, and is basically just a read-only "struct".
- * @template D
+ * This class has no instance methods beyond stringification and is effectively
+ * a read-only struct.
  */
 class ArgSpec {
-    /**
-     * The canonical name of the argument. Corresponds to key in schema's `properties` prop.
-     * @type {string}
-     */
     name;
-    /**
-     * The `ExtensionType` of the argument. This will be set if the arg came from an extension;
-     * otherwise it will be `undefined`.
-     * @type {ExtensionType|undefined}
-     */
     extType;
-    /**
-     * The name of the extension, if this argument came from an extension.
-     *
-     * Otherwise `undefined`.
-     * @type {string|undefined}
-     */
     extName;
-    /**
-     * The schema ID (`$id`) for the argument.  This is automatically determined, and any user-provided `$id`s will be overwritten.
-     *
-     * @type {string}
-     */
     ref;
-    /**
-     * The CLI argument, sans leading dashes.
-     * @type {string}
-     */
     arg;
-    /**
-     * The desired keypath for the argument after arguments have been parsed.
-     *
-     * Typically this is camelCased.  If the arg came from an extension, it will be prefixed with
-     * `<extType>.<extName>.`
-     * @type {string}
-     */
     dest;
-    /**
-     * The same as {@link ArgSpec.dest} but without the leading `<extType>.<extName>.` prefix.
-     */
     rawDest;
-    /**
-     * Whatever the default value of this argument is, as specified by the
-     * `default` property of the schema.
-     * @type {D|undefined}
-     */
     defaultValue;
     /**
-     * Builds some computed fields and assigns them to the instance.
-     *
-     * Undefined properties are not assigned.
-     *
-     * The _constructor_ is private. Use {@link ArgSpec.create} instead.
-     * @private
-     * @param {string} name
-     * @param {ArgSpecOptions<D>} opts
+     * Builds computed fields and assigns them to the instance.
+     * Use {@link ArgSpec.create} instead of `new ArgSpec()`.
      */
     constructor(name, { extType, extName, dest, defaultValue } = {}) {
-        // we must normalize the extension name to fit into our convention for CLI
-        // args.
         const arg = ArgSpec.toArg(name, extType, extName);
         const ref = ArgSpec.toSchemaRef(name, extType, extName);
-        // if no explicit `dest` provided, just camelCase the name to avoid needing
-        // to use bracket syntax when accessing props on the parsed args object.
         const rawDest = lodash_1.default.camelCase(dest ?? name);
         const destKeypath = extType && extName ? [extType, extName, rawDest].join('.') : rawDest;
         this.defaultValue = defaultValue;
@@ -108,13 +52,7 @@ class ArgSpec {
         this.rawDest = rawDest;
     }
     /**
-     * Return the schema ID (`$id`) for the **argument** given the parameters.
-     *
-     * If you need the "root" or "base" schema ID, use {@link ArgSpec.toSchemaBaseRef} instead.
-     * @param {string} name - Argument name
-     * @param {ExtensionType} [extType] - Extension type
-     * @param {string} [extName] - Extension name
-     * @returns {string} Schema ID
+     * Return the schema ID (`$id`) for the argument given the parameters.
      */
     static toSchemaRef(name, extType, extName) {
         const baseRef = ArgSpec.toSchemaBaseRef(extType, extName);
@@ -124,9 +62,7 @@ class ArgSpec {
         return [`${baseRef}#`, PROPERTIES, exports.SERVER_PROP_NAME, PROPERTIES, name].join('/');
     }
     /**
-     * Return the schema ID for an extension or the base schema ID.
-     * @param {ExtensionType} [extType] - Extension type
-     * @param {string} [extName] - Extension name
+     * Return the root schema ID for an extension or Appium base schema.
      */
     static toSchemaBaseRef(extType, extName) {
         if (extType && extName) {
@@ -135,11 +71,7 @@ class ArgSpec {
         return exports.APPIUM_CONFIG_SCHEMA_ID;
     }
     /**
-     * Return the unique ID for the argument given the parameters.
-     * @param {string} name - Argument name
-     * @param {ExtensionType} [extType] - Extension type
-     * @param {string} [extName] - Extension name
-     * @returns {string} Unique ID
+     * Return the unique CLI argument key for the argument.
      */
     static toArg(name, extType, extName) {
         const properName = lodash_1.default.kebabCase(name.replace(/^--?/, ''));
@@ -149,44 +81,28 @@ class ArgSpec {
         return properName;
     }
     /**
-     * Normalizes a raw extension name (not including the type).
-     * @param {string} extName - Extension name
-     * @returns {string} Normalized extension name
+     * Normalizes a raw extension name (not including type).
      */
     static toNormalizedExtName(extName) {
         return lodash_1.default.kebabCase(extName);
     }
     /**
-     * When given the root ID of a schema for an extension (`<extType>-<normalizedExtName>.json`) Returns an object containing the extension type and the _normalized_ extension name.
-     * @param {string} schemaId - Root schema ID
-     * @returns { {extType?: ExtensionType, normalizedExtName?: string} }
+     * Parse root schema ID (`<extType>-<normalizedExtName>.json`) to extension info.
      */
     static extensionInfoFromRootSchemaId(schemaId) {
         const matches = schemaId.match(SCHEMA_ID_REGEXP);
         if (matches?.groups) {
-            const { extType, normalizedExtName } = 
-            /** @type { {extType: ExtensionType, normalizedExtName: string} } */ (matches.groups);
+            const { extType, normalizedExtName } = matches.groups;
             return { extType, normalizedExtName };
         }
         return {};
     }
     /**
-     * Creates an `ArgSpec`
-     *
-     * @param {string} name - The canonical name of the argument. Corresponds to a key in a schema's
-     * `properties` property.
-     * @template D
-     * @param {ArgSpecOptions<D>} [opts] - Options
-     * @returns {Readonly<ArgSpec>}
+     * Creates a frozen `ArgSpec`.
      */
     static create(name, opts) {
         return Object.freeze(new ArgSpec(name, opts));
     }
-    /**
-     * String representation, useful for debugging
-     * @returns {string}
-     */
-    /* istanbul ignore next */
     toString() {
         let str = `[ArgSpec] ${this.name} (${this.ref})`;
         if (this.extType && this.extName) {
@@ -196,16 +112,4 @@ class ArgSpec {
     }
 }
 exports.ArgSpec = ArgSpec;
-/**
- * Options for {@link ArgSpec.create}
- * @template D
- * @typedef ArgSpecOptions
- * @property {string} [extName]
- * @property {ExtensionType} [extType]
- * @property {string} [dest]
- * @property {D} [defaultValue]
- */
-/**
- * @typedef {import('@appium/types').ExtensionType} ExtensionType
- */
 //# sourceMappingURL=arg-spec.js.map

package/build/lib/schema/arg-spec.js.map

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

package/build/lib/schema/cli-args-guards.d.ts

@@ -0,0 +1,34 @@
+import type { Args, CliCommand, CliCommandDriver, CliCommandPlugin, CliCommandServer, CliCommandSetup, CliExtensionCommand, CliExtensionSubcommand, CliCommandSetupSubcommand } from 'appium/types';
+type AnyArgs = Args<CliCommand, CliExtensionSubcommand | CliCommandSetupSubcommand | void>;
+/**
+ * Type guard: args are for the server command.
+ *
+ * @param args - Parsed args before full subcommand-specific narrowing
+ */
+export declare function isServerCommandArgs(args: AnyArgs): args is Args<CliCommandServer, void>;
+/**
+ * Type guard: args are for the setup command.
+ *
+ * @param args - Parsed args before full subcommand-specific narrowing
+ */
+export declare function isSetupCommandArgs(args: AnyArgs): args is Args<CliCommandSetup, CliCommandSetupSubcommand>;
+/**
+ * Type guard: args are for an extension command (driver or plugin).
+ *
+ * @param args - Parsed args before full subcommand-specific narrowing
+ */
+export declare function isExtensionCommandArgs(args: AnyArgs): args is Args<CliExtensionCommand, CliExtensionSubcommand>;
+/**
+ * Type guard: args are for a driver extension command.
+ *
+ * @param args - Parsed args before full subcommand-specific narrowing
+ */
+export declare function isDriverCommandArgs(args: AnyArgs): args is Args<CliCommandDriver, CliExtensionSubcommand>;
+/**
+ * Type guard: args are for a plugin extension command.
+ *
+ * @param args - Parsed args before full subcommand-specific narrowing
+ */
+export declare function isPluginCommandArgs(args: AnyArgs): args is Args<CliCommandPlugin, CliExtensionSubcommand>;
+export {};
+//# sourceMappingURL=cli-args-guards.d.ts.map

package/build/lib/schema/cli-args-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-args-guards.d.ts","sourceRoot":"","sources":["../../../lib/schema/cli-args-guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,IAAI,EACJ,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,yBAAyB,EAC1B,MAAM,cAAc,CAAC;AAGtB,KAAK,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,sBAAsB,GAAG,yBAAyB,GAAG,IAAI,CAAC,CAAC;AAE3F;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAEvF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,OAAO,GACZ,IAAI,IAAI,IAAI,CAAC,eAAe,EAAE,yBAAyB,CAAC,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,GACZ,IAAI,IAAI,IAAI,CAAC,mBAAmB,EAAE,sBAAsB,CAAC,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,OAAO,GACZ,IAAI,IAAI,IAAI,CAAC,gBAAgB,EAAE,sBAAsB,CAAC,CAExD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,OAAO,GACZ,IAAI,IAAI,IAAI,CAAC,gBAAgB,EAAE,sBAAsB,CAAC,CAExD"}

package/build/lib/schema/cli-args-guards.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isServerCommandArgs = isServerCommandArgs;
+exports.isSetupCommandArgs = isSetupCommandArgs;
+exports.isExtensionCommandArgs = isExtensionCommandArgs;
+exports.isDriverCommandArgs = isDriverCommandArgs;
+exports.isPluginCommandArgs = isPluginCommandArgs;
+const constants_1 = require("../constants");
+/**
+ * Type guard: args are for the server command.
+ *
+ * @param args - Parsed args before full subcommand-specific narrowing
+ */
+function isServerCommandArgs(args) {
+    return args.subcommand === constants_1.SERVER_SUBCOMMAND;
+}
+/**
+ * Type guard: args are for the setup command.
+ *
+ * @param args - Parsed args before full subcommand-specific narrowing
+ */
+function isSetupCommandArgs(args) {
+    return args.subcommand === constants_1.SETUP_SUBCOMMAND;
+}
+/**
+ * Type guard: args are for an extension command (driver or plugin).
+ *
+ * @param args - Parsed args before full subcommand-specific narrowing
+ */
+function isExtensionCommandArgs(args) {
+    return args.subcommand === constants_1.DRIVER_TYPE || args.subcommand === constants_1.PLUGIN_TYPE;
+}
+/**
+ * Type guard: args are for a driver extension command.
+ *
+ * @param args - Parsed args before full subcommand-specific narrowing
+ */
+function isDriverCommandArgs(args) {
+    return args.subcommand === constants_1.DRIVER_TYPE;
+}
+/**
+ * Type guard: args are for a plugin extension command.
+ *
+ * @param args - Parsed args before full subcommand-specific narrowing
+ */
+function isPluginCommandArgs(args) {
+    return args.subcommand === constants_1.PLUGIN_TYPE;
+}
+//# sourceMappingURL=cli-args-guards.js.map

package/build/lib/schema/cli-args-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-args-guards.js","sourceRoot":"","sources":["../../../lib/schema/cli-args-guards.ts"],"names":[],"mappings":";;AAoBA,kDAEC;AAOD,gDAIC;AAOD,wDAIC;AAOD,kDAIC;AAOD,kDAIC;AAvDD,4CAA2F;AAI3F;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,IAAa;IAC/C,OAAO,IAAI,CAAC,UAAU,KAAK,6BAAiB,CAAC;AAC/C,CAAC;AAED;;;;GAIG;AACH,SAAgB,kBAAkB,CAChC,IAAa;IAEb,OAAO,IAAI,CAAC,UAAU,KAAK,4BAAgB,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,SAAgB,sBAAsB,CACpC,IAAa;IAEb,OAAO,IAAI,CAAC,UAAU,KAAK,uBAAW,IAAI,IAAI,CAAC,UAAU,KAAK,uBAAW,CAAC;AAC5E,CAAC;AAED;;;;GAIG;AACH,SAAgB,mBAAmB,CACjC,IAAa;IAEb,OAAO,IAAI,CAAC,UAAU,KAAK,uBAAW,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,SAAgB,mBAAmB,CACjC,IAAa;IAEb,OAAO,IAAI,CAAC,UAAU,KAAK,uBAAW,CAAC;AACzC,CAAC"}

package/build/lib/schema/cli-args.d.ts

@@ -1,19 +1,7 @@
+import type { ArgumentDefinitions } from '../cli/args';
 /**
  * Converts the finalized, flattened schema representation into
- * ArgumentDefinitions for handoff to `argparse`.
- *
- * @throws If schema has not been added to ajv (via `finalizeSchema()`)
- * @returns {import('../cli/args').ArgumentDefinitions} A map of arrays of
- * aliases to `argparse` arguments; empty if no schema found
+ * `ArgumentDefinitions` for handoff to `argparse`.
  */
-export function toParserArgs(): import("../cli/args").ArgumentDefinitions;
-/**
- * <T>
- */
-export type FormatValidator<T extends string | number> = import("ajv/dist/types").FormatValidator<T>;
-/**
- * A JSON 7 schema with our custom keywords.
- */
-export type AppiumJSONSchema = import("./keywords").AppiumJSONSchemaKeywords & import("json-schema").JSONSchema7;
-export type ArgSpec = import("./arg-spec").ArgSpec<any>;
+export declare function toParserArgs(): ArgumentDefinitions;
 //# sourceMappingURL=cli-args.d.ts.map

package/build/lib/schema/cli-args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-args.d.ts","sourceRoot":"","sources":["../../../lib/schema/cli-args.js"],"names":[],"mappings":"AAoOA;;;;;;;GAOG;AACH,gCAHa,OAAO,aAAa,EAAE,mBAAmB,CAMrD;;;;4BAG4B,CAAC,SAAhB,MAAM,GAAC,MAAO,IACf,OAAO,gBAAgB,EAAE,eAAe,CAAC,CAAC,CAAC;;;;+BAK3C,OAAO,YAAY,EAAE,wBAAwB,GAAG,OAAO,aAAa,EAAE,WAAW"}
+{"version":3,"file":"cli-args.d.ts","sourceRoot":"","sources":["../../../lib/schema/cli-args.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,aAAa,CAAC;AAiBrD;;;GAGG;AACH,wBAAgB,YAAY,IAAI,mBAAmB,CAKlD"}