appium 3.2.2 → 3.3.1

package/build/lib/bootstrap/main-helpers.js

@@ -0,0 +1,187 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inspect = void 0;
+exports.showBuildInfo = showBuildInfo;
+exports.determineAppiumHomeSource = determineAppiumHomeSource;
+exports.logServerAddress = logServerAddress;
+exports.preflightChecks = preflightChecks;
+exports.logStartupInfo = logStartupInfo;
+exports.getServerUpdaters = getServerUpdaters;
+exports.getExtraMethodMap = getExtraMethodMap;
+exports.buildServerOpts = buildServerOpts;
+exports.createAppiumServer = createAppiumServer;
+const node_util_1 = require("node:util");
+const logger_1 = require("../logger");
+const base_driver_1 = require("@appium/base-driver");
+const lodash_1 = __importDefault(require("lodash"));
+const ws_1 = require("ws");
+const build_1 = require("../helpers/build");
+const node_helpers_1 = require("./node-helpers");
+const startup_config_1 = require("./startup-config");
+const schema_1 = require("../schema/schema");
+const network_1 = require("../helpers/network");
+const constants_1 = require("../constants");
+const isStdoutTTY = process.stdout.isTTY;
+/**
+ * Logs a value to the console using the info logger (with util.inspect formatting).
+ */
+exports.inspect = lodash_1.default.flow(lodash_1.default.partialRight(node_util_1.inspect, {
+    colors: true,
+    depth: null,
+    compact: !isStdoutTTY,
+}), (...args) => {
+    logger_1.log.info(...args);
+});
+/**
+ * Prints the current build info JSON to stdout.
+ *
+ * This updates build metadata first (using GitHub fallback) and then logs the
+ * resulting {@link BuildInfo} object.
+ */
+async function showBuildInfo() {
+    await (0, build_1.updateBuildInfo)(true);
+    // eslint-disable-next-line no-console -- CLI output for --build-info
+    console.log(JSON.stringify((0, build_1.getBuildInfo)()));
+}
+/**
+ * Human-readable label for where Appium resolved `APPIUM_HOME` from (CLI, env, or autodetect).
+ */
+function determineAppiumHomeSource(appiumHomeFromArgs) {
+    if (!lodash_1.default.isNil(appiumHomeFromArgs)) {
+        return 'appiumHome config value';
+    }
+    if (process.env.APPIUM_HOME) {
+        return 'APPIUM_HOME environment variable';
+    }
+    return 'autodetected Appium home path';
+}
+/**
+ * Logs the REST listener URL; if the bind address is a broadcast address, lists concrete interface URLs.
+ */
+function logServerAddress(url) {
+    const urlObj = new URL(url);
+    logger_1.log.info(`Appium REST http interface listener started on ${url}`);
+    if (!(0, network_1.isBroadcastIp)(urlObj.hostname)) {
+        return;
+    }
+    const interfaces = (0, network_1.fetchInterfaces)(urlObj.hostname === network_1.V4_BROADCAST_IP ? 4 : 6);
+    const toLabel = (iface) => {
+        const href = urlObj.href.replace(urlObj.hostname, iface.address);
+        return iface.internal ? `${href} (only accessible from the same host)` : href;
+    };
+    logger_1.log.info(`You can provide the following ${interfaces.length === 1 ? 'URL' : 'URLs'} ` +
+        `in your client code to connect to this server:\n` +
+        interfaces.map((iface) => `\t${toLabel(iface)}`).join('\n'));
+}
+/**
+ * Validates Node version, optional long stack traces, schema, tmp dir, and `--build-info` early exit.
+ *
+ * @param args - Parsed server CLI args
+ * @param throwInsteadOfExit - When true, rethrows failures instead of calling `process.exit(1)`
+ */
+async function preflightChecks(args, throwInsteadOfExit = false) {
+    try {
+        (0, node_helpers_1.checkNodeOk)();
+        if (args.longStacktrace) {
+            Error.stackTraceLimit = constants_1.LONG_STACKTRACE_LIMIT;
+        }
+        if (args.showBuildInfo) {
+            await showBuildInfo();
+            process.exit(0);
+        }
+        (0, schema_1.validate)(args);
+        if (args.tmpDir) {
+            await (0, node_helpers_1.requireDir)(args.tmpDir, !args.noPermsCheck, 'tmpDir argument value');
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        logger_1.log.error(message.red);
+        if (throwInsteadOfExit) {
+            throw err;
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Prints welcome line (version + optional git rev), non-default server args, and default capabilities.
+ */
+async function logStartupInfo(args) {
+    let welcome = `Welcome to Appium v${build_1.APPIUM_VER}`;
+    const appiumRev = await (0, build_1.getGitRev)();
+    if (appiumRev) {
+        welcome += ` (REV ${appiumRev})`;
+    }
+    logger_1.log.info(welcome);
+    const showArgs = (0, startup_config_1.getNonDefaultServerArgs)(args);
+    if (lodash_1.default.size(showArgs)) {
+        logNonDefaultArgsWarning(showArgs);
+    }
+    if (!lodash_1.default.isEmpty(args.defaultCapabilities)) {
+        logDefaultCapabilitiesWarning(args.defaultCapabilities);
+    }
+}
+/**
+ * Collects `updateServer` hooks from active driver and plugin classes for HTTP server customization.
+ */
+function getServerUpdaters(driverClasses, pluginClasses) {
+    return lodash_1.default.compact(lodash_1.default.map([...driverClasses.keys(), ...pluginClasses.keys()], 'updateServer'));
+}
+/**
+ * Merges `newMethodMap` contributions from all active drivers and plugins into one method map.
+ */
+function getExtraMethodMap(driverClasses, pluginClasses) {
+    return [...driverClasses.keys(), ...pluginClasses.keys()].reduce((map, klass) => ({
+        ...map,
+        ...(klass.newMethodMap ?? {}),
+    }), {});
+}
+/**
+ * Builds {@link ServerOpts} and normalized base path for the Appium HTTP server from CLI args and extensions.
+ */
+function buildServerOpts(appiumDriver, parsedArgs, driverClasses, pluginClasses) {
+    const routeConfiguringFunction = (0, base_driver_1.routeConfiguringFunction)(appiumDriver);
+    const serverOpts = {
+        routeConfiguringFunction,
+        port: parsedArgs.port,
+        hostname: parsedArgs.address,
+        allowCors: parsedArgs.allowCors,
+        basePath: parsedArgs.basePath,
+        serverUpdaters: getServerUpdaters(driverClasses, pluginClasses),
+        extraMethodMap: getExtraMethodMap(driverClasses, pluginClasses),
+        cliArgs: parsedArgs,
+    };
+    const normalizedBasePath = (0, base_driver_1.normalizeBasePath)(parsedArgs.basePath);
+    for (const timeoutArgName of ['keepAliveTimeout', 'requestTimeout']) {
+        if (lodash_1.default.isInteger(parsedArgs[timeoutArgName])) {
+            serverOpts[timeoutArgName] = parsedArgs[timeoutArgName] * 1000;
+        }
+    }
+    return { serverOpts, normalizedBasePath };
+}
+/**
+ * Creates the Appium HTTP server and attaches WebSocket handlers for BiDi under the normalized base path.
+ */
+async function createAppiumServer(serverOpts, appiumDriver, normalizedBasePath) {
+    const bidiServer = new ws_1.WebSocketServer({ noServer: true });
+    bidiServer.on('connection', appiumDriver.onBidiConnection.bind(appiumDriver));
+    bidiServer.on('error', appiumDriver.onBidiServerError.bind(appiumDriver));
+    const server = await (0, base_driver_1.server)(serverOpts);
+    const bidiBasePath = `${normalizedBasePath}${constants_1.BIDI_BASE_PATH}`;
+    await server.addWebSocketHandler(bidiBasePath, bidiServer);
+    await server.addWebSocketHandler(`${bidiBasePath}/:sessionId`, bidiServer);
+    return server;
+}
+function logNonDefaultArgsWarning(args) {
+    logger_1.log.info('Non-default server args:');
+    (0, exports.inspect)(args);
+}
+function logDefaultCapabilitiesWarning(caps) {
+    logger_1.log.info('Default capabilities, which will be added to each request ' +
+        'unless overridden by desired capabilities:');
+    (0, exports.inspect)(caps);
+}
+//# sourceMappingURL=main-helpers.js.map

package/build/lib/bootstrap/main-helpers.js.map

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

package/build/lib/bootstrap/node-helpers.d.ts

@@ -0,0 +1,32 @@
+interface DebugInfoInput {
+    driverConfig: {
+        installedExtensions: unknown;
+    };
+    pluginConfig: {
+        installedExtensions: unknown;
+    };
+    appiumHome: string;
+}
+/**
+ * @throws {Error} If Node version is outside of the supported range
+ */
+export declare function checkNodeOk(): void;
+/**
+ * Adjusts NODE_PATH so CJS drivers/plugins can load peer deps. Does not work with ESM.
+ */
+export declare function adjustNodePath(): void;
+/**
+ * Prints JSON debug info (OS, Node/npm, Appium build, installed drivers/plugins) to stdout.
+ * Input combines extension config snapshots with the resolved Appium home path.
+ */
+export declare function showDebugInfo({ driverConfig, pluginConfig, appiumHome }: DebugInfoInput): Promise<void>;
+/**
+ * Ensures a directory exists and (optionally) is writeable.
+ *
+ * If the directory does not exist, this attempts to create it recursively.
+ *
+ * @throws {Error}
+ */
+export declare function requireDir(root: string, requireWriteable?: boolean, displayName?: string): Promise<void>;
+export {};
+//# sourceMappingURL=node-helpers.d.ts.map

package/build/lib/bootstrap/node-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-helpers.d.ts","sourceRoot":"","sources":["../../../lib/bootstrap/node-helpers.ts"],"names":[],"mappings":"AAiBA,UAAU,cAAc;IACtB,YAAY,EAAE;QAAC,mBAAmB,EAAE,OAAO,CAAA;KAAC,CAAC;IAC7C,YAAY,EAAE;QAAC,mBAAmB,EAAE,OAAO,CAAA;KAAC,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAKlC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CA0CrC;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,EAAC,YAAY,EAAE,YAAY,EAAE,UAAU,EAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAyC3G;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,gBAAgB,UAAO,EACvB,WAAW,SAAgB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAyBf"}

package/build/lib/bootstrap/node-helpers.js

@@ -0,0 +1,201 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkNodeOk = checkNodeOk;
+exports.adjustNodePath = adjustNodePath;
+exports.showDebugInfo = showDebugInfo;
+exports.requireDir = requireDir;
+/* eslint-disable no-console */
+const lodash_1 = __importDefault(require("lodash"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_os_1 = __importDefault(require("node:os"));
+const semver = __importStar(require("semver"));
+const bluebird_1 = __importDefault(require("bluebird"));
+const support_1 = require("@appium/support");
+const logger_1 = require("../logger");
+const utils_1 = require("../utils");
+const build_1 = require("../helpers/build");
+const MIN_NODE_VERSION = utils_1.npmPackage.engines.node;
+/**
+ * @throws {Error} If Node version is outside of the supported range
+ */
+function checkNodeOk() {
+    const version = getNodeVersion();
+    if (!semver.satisfies(version, MIN_NODE_VERSION)) {
+        throw new Error(`Node version must be at least ${MIN_NODE_VERSION}; current is ${version.version}`);
+    }
+}
+/**
+ * Adjusts NODE_PATH so CJS drivers/plugins can load peer deps. Does not work with ESM.
+ */
+function adjustNodePath() {
+    let appiumModuleSearchRoot;
+    try {
+        appiumModuleSearchRoot = node_path_1.default.dirname((0, utils_1.getAppiumModuleRoot)());
+    }
+    catch (error) {
+        logger_1.log.warn(error.message);
+        return;
+    }
+    const refreshRequirePaths = () => {
+        try {
+            // Private API; see https://gist.github.com/branneman/8048520#7-the-hack
+            require('node:module').Module._initPaths();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    if (!process.env.NODE_PATH) {
+        process.env.NODE_PATH = appiumModuleSearchRoot;
+        if (refreshRequirePaths()) {
+            process.env.APPIUM_OMIT_PEER_DEPS = '1';
+        }
+        else {
+            delete process.env.NODE_PATH;
+        }
+        return;
+    }
+    const nodePathParts = process.env.NODE_PATH.split(node_path_1.default.delimiter);
+    if (nodePathParts.includes(appiumModuleSearchRoot)) {
+        process.env.APPIUM_OMIT_PEER_DEPS = '1';
+        return;
+    }
+    nodePathParts.push(appiumModuleSearchRoot);
+    process.env.NODE_PATH = nodePathParts.join(node_path_1.default.delimiter);
+    if (refreshRequirePaths()) {
+        process.env.APPIUM_OMIT_PEER_DEPS = '1';
+    }
+    else {
+        process.env.NODE_PATH = lodash_1.default.without(nodePathParts, appiumModuleSearchRoot).join(node_path_1.default.delimiter);
+    }
+}
+/**
+ * Prints JSON debug info (OS, Node/npm, Appium build, installed drivers/plugins) to stdout.
+ * Input combines extension config snapshots with the resolved Appium home path.
+ */
+async function showDebugInfo({ driverConfig, pluginConfig, appiumHome }) {
+    const getNpmVersion = async () => {
+        const { stdout } = await support_1.npm.exec('--version', [], { cwd: process.cwd() });
+        return lodash_1.default.trim(stdout);
+    };
+    const findNpmLocation = async () => await support_1.fs.which(support_1.system.isWindows() ? 'npm.cmd' : 'npm');
+    const [npmVersion, npmLocation] = await bluebird_1.default.all([
+        ...[getNpmVersion, findNpmLocation].map((f) => getSafeResult(f, 'unknown')),
+        (0, build_1.updateBuildInfo)(),
+    ]);
+    const debugInfo = {
+        os: {
+            platform: node_os_1.default.platform(),
+            release: node_os_1.default.release(),
+            arch: node_os_1.default.arch(),
+            homedir: node_os_1.default.homedir(),
+            username: node_os_1.default.userInfo().username,
+        },
+        node: {
+            version: process.version,
+            arch: process.arch,
+            cwd: process.cwd(),
+            argv: process.argv,
+            env: process.env,
+            npm: {
+                location: npmLocation,
+                version: npmVersion,
+            },
+        },
+        appium: {
+            location: build_1.rootDir,
+            homedir: appiumHome,
+            build: (0, build_1.getBuildInfo)(),
+            drivers: driverConfig.installedExtensions,
+            plugins: pluginConfig.installedExtensions,
+        },
+    };
+    console.log(JSON.stringify(debugInfo, null, 2));
+}
+/**
+ * Ensures a directory exists and (optionally) is writeable.
+ *
+ * If the directory does not exist, this attempts to create it recursively.
+ *
+ * @throws {Error}
+ */
+async function requireDir(root, requireWriteable = true, displayName = 'folder path') {
+    let stat;
+    try {
+        stat = await support_1.fs.stat(root);
+    }
+    catch (e) {
+        if (e.code === 'ENOENT') {
+            try {
+                await support_1.fs.mkdir(root, { recursive: true });
+                return;
+            }
+            catch { }
+        }
+        throw new Error(`The ${displayName} '${root}' must exist and be a valid directory`);
+    }
+    if (stat && !stat.isDirectory()) {
+        throw new Error(`The ${displayName} '${root}' must be a valid directory`);
+    }
+    if (requireWriteable) {
+        try {
+            await support_1.fs.access(root, support_1.fs.constants.W_OK);
+        }
+        catch {
+            throw new Error(`The ${displayName} '${root}' must be writeable for the current user account '${node_os_1.default.userInfo().username}'`);
+        }
+    }
+}
+function getNodeVersion() {
+    return semver.coerce(process.version);
+}
+/**
+ * Calculates the result of the given function and return its value
+ * or the default one if there was an exception.
+ */
+async function getSafeResult(f, defaultValue) {
+    try {
+        return await f();
+    }
+    catch {
+        return defaultValue;
+    }
+}
+//# sourceMappingURL=node-helpers.js.map

package/build/lib/bootstrap/node-helpers.js.map

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

package/build/lib/bootstrap/startup-config.d.ts

@@ -0,0 +1,22 @@
+import type { Args } from 'appium/types';
+import type { ReadConfigFileResult } from './config-file';
+/**
+ * Returns key/value pairs of server arguments that differ from schema defaults (flattened comparison).
+ *
+ * @param parsedArgs - Fully merged server args (CLI + config + defaults)
+ */
+export declare function getNonDefaultServerArgs(parsedArgs: Args): Args;
+/**
+ * Prints a breakdown of configuration: defaults, config file, CLI/programmatic overrides, and final merged args.
+ *
+ * The actual shape of `nonDefaultPreConfigParsedArgs` and `defaults` does not matter for the purposes of this
+ * function, but it's intended to be called with values of type {@link ParsedArgs} and
+ * `DefaultValues<true>`, respectively.
+ *
+ * @param nonDefaultPreConfigParsedArgs - CLI-only (or programmatic) args that differ from defaults
+ * @param configResult - Result of {@link readConfigFile}
+ * @param defaults - Schema default values
+ * @param parsedArgs - Final merged configuration
+ */
+export declare function showConfig(nonDefaultPreConfigParsedArgs: Partial<Args>, configResult: ReadConfigFileResult, defaults: Partial<Args>, parsedArgs: Args): void;
+//# sourceMappingURL=startup-config.d.ts.map

package/build/lib/bootstrap/startup-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-config.d.ts","sourceRoot":"","sources":["../../../lib/bootstrap/startup-config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,cAAc,CAAC;AACvC,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,eAAe,CAAC;AAOxD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,IAAI,GAAG,IAAI,CA0E9D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CACxB,6BAA6B,EAAE,OAAO,CAAC,IAAI,CAAC,EAC5C,YAAY,EAAE,oBAAoB,EAClC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,EACvB,UAAU,EAAE,IAAI,GACf,IAAI,CAmBN"}

package/build/lib/bootstrap/startup-config.js

@@ -0,0 +1,111 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNonDefaultServerArgs = getNonDefaultServerArgs;
+exports.showConfig = showConfig;
+/* eslint-disable no-console */
+const lodash_1 = __importDefault(require("lodash"));
+const schema_1 = require("../schema/schema");
+/**
+ * Returns key/value pairs of server arguments that differ from schema defaults (flattened comparison).
+ *
+ * @param parsedArgs - Fully merged server args (CLI + config + defaults)
+ */
+function getNonDefaultServerArgs(parsedArgs) {
+    /**
+     * Flattens parsed args into a single level object for comparison with
+     * flattened defaults across server args and extension args.
+     */
+    const flatten = (args) => {
+        const argSpecs = (0, schema_1.getAllArgSpecs)();
+        const flattened = lodash_1.default.reduce([...argSpecs.values()], (acc, argSpec) => {
+            if (lodash_1.default.has(args, argSpec.dest)) {
+                acc[argSpec.dest] = { value: lodash_1.default.get(args, argSpec.dest), argSpec };
+            }
+            return acc;
+        }, {});
+        return flattened;
+    };
+    const args = flatten(parsedArgs);
+    // hopefully these function names are descriptive enough
+    const typesDiffer = (dest) => typeof args[dest].value !== typeof defaultsFromSchema[dest];
+    const defaultValueIsArray = (dest) => lodash_1.default.isArray(defaultsFromSchema[dest]);
+    const argsValueIsArray = (dest) => lodash_1.default.isArray(args[dest].value);
+    const arraysDiffer = (dest) => lodash_1.default.gt(lodash_1.default.size(lodash_1.default.difference(args[dest].value, defaultsFromSchema[dest])), 0);
+    const valuesDiffer = (dest) => args[dest].value !== defaultsFromSchema[dest];
+    const defaultIsDefined = (dest) => !lodash_1.default.isUndefined(defaultsFromSchema[dest]);
+    // note that `_.overEvery` is like an "AND", and `_.overSome` is like an "OR"
+    const argValueNotArrayOrArraysDiffer = lodash_1.default.overSome([lodash_1.default.negate(argsValueIsArray), arraysDiffer]);
+    const defaultValueNotArrayAndValuesDiffer = lodash_1.default.overEvery([
+        lodash_1.default.negate(defaultValueIsArray),
+        valuesDiffer,
+    ]);
+    /**
+     * This used to be a hideous conditional, but it's broken up into a hideous function instead.
+     * hopefully this makes things a little more understandable.
+     * - checks if the default value is defined
+     * - if so, and the default is not an array:
+     *   - ensures the types are the same
+     *   - ensures the values are equal
+     * - if so, and the default is an array:
+     *   - ensures the args value is an array
+     *   - ensures the args values do not differ from the default values
+     */
+    const isNotDefault = lodash_1.default.overEvery([
+        defaultIsDefined,
+        lodash_1.default.overSome([
+            typesDiffer,
+            lodash_1.default.overEvery([defaultValueIsArray, argValueNotArrayOrArraysDiffer]),
+            defaultValueNotArrayAndValuesDiffer,
+        ]),
+    ]);
+    const defaultsFromSchema = (0, schema_1.getDefaultsForSchema)(true);
+    return lodash_1.default.reduce(lodash_1.default.pickBy(args, (_v, key) => isNotDefault(key)), 
+    // explodes the flattened object back into nested one
+    (acc, { value, argSpec }) => lodash_1.default.set(acc, argSpec.dest, value), {});
+}
+/**
+ * Prints a breakdown of configuration: defaults, config file, CLI/programmatic overrides, and final merged args.
+ *
+ * The actual shape of `nonDefaultPreConfigParsedArgs` and `defaults` does not matter for the purposes of this
+ * function, but it's intended to be called with values of type {@link ParsedArgs} and
+ * `DefaultValues<true>`, respectively.
+ *
+ * @param nonDefaultPreConfigParsedArgs - CLI-only (or programmatic) args that differ from defaults
+ * @param configResult - Result of {@link readConfigFile}
+ * @param defaults - Schema default values
+ * @param parsedArgs - Final merged configuration
+ */
+function showConfig(nonDefaultPreConfigParsedArgs, configResult, defaults, parsedArgs) {
+    console.log('Appium Configuration\n');
+    console.log('from defaults:\n');
+    console.dir(compactConfig(defaults));
+    if (configResult.config) {
+        console.log(`\nfrom config file at ${configResult.filepath}:\n`);
+        console.dir(compactConfig(configResult.config));
+    }
+    else {
+        console.log(`\n(no configuration file loaded)`);
+    }
+    const compactedNonDefaultPreConfigArgs = compactConfig(nonDefaultPreConfigParsedArgs);
+    if (lodash_1.default.isEmpty(compactedNonDefaultPreConfigArgs)) {
+        console.log(`\n(no CLI parameters provided)`);
+    }
+    else {
+        console.log('\nvia CLI or function call:\n');
+        console.dir(compactedNonDefaultPreConfigArgs);
+    }
+    console.log('\nfinal configuration:\n');
+    console.dir(compactConfig(parsedArgs));
+}
+/**
+ * Compacts an object for {@link showConfig}:
+ * 1. Removes `subcommand` key/value
+ * 2. Removes `undefined` values
+ * 3. Removes empty objects (but not `false` values)
+ * Does not operate recursively.
+ */
+const compactConfig = lodash_1.default.partial(lodash_1.default.omitBy, lodash_1.default, (value, key) => key === 'subcommand' || lodash_1.default.isUndefined(value) || (lodash_1.default.isObject(value) && lodash_1.default.isEmpty(value)));
+//# sourceMappingURL=startup-config.js.map

package/build/lib/bootstrap/startup-config.js.map

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

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

@@ -1,17 +1,21 @@
-export type ExtensionType = import("@appium/types").ExtensionType;
-/**
- * A tuple of argument aliases and argument options
- */
-export type ArgumentDefinitions = Map<[name: string] | [name: string, alias: string], import("argparse").ArgumentOptions>;
+import _ from 'lodash';
+import type { ArgumentOptions } from 'argparse';
+import type { ExtensionType } from '@appium/types';
+import type { CliExtensionSubcommand } from 'appium/types';
+export type ArgumentDefinitions = Map<[
+    name: string
+] | [name: string, alias: string], ArgumentOptions>;
 /**
- * Derives the options for the `server` command from the schema, and adds the arguments
- * which are disallowed in the config file.
- * @returns {ArgumentDefinitions}
+ * Returns CLI argument definitions for extension commands by extension type.
+ *
+ * The result is memoized because parser setup is static across process lifetime.
  */
-export function getServerArgs(): ArgumentDefinitions;
+export declare const getExtensionArgs: (() => Record<ExtensionType, Record<CliExtensionSubcommand, ArgumentDefinitions>>) & _.MemoizedFunction;
 /**
- * Builds a Record of extension types to a Record of subcommands to their argument definitions
+ * Returns CLI argument definitions for the `server` command.
+ *
+ * This includes schema-derived options and additional CLI-only options which
+ * are intentionally disallowed in config files.
  */
-export const getExtensionArgs: (() => Record<ExtensionType, Record<import("appium/types").CliExtensionSubcommand, ArgumentDefinitions>>) & _.MemoizedFunction;
-import _ from 'lodash';
+export declare function getServerArgs(): ArgumentDefinitions;
 //# sourceMappingURL=args.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../../lib/cli/args.js"],"names":[],"mappings":"4BA4Ta,OAAO,eAAe,EAAE,aAAa;;;;kCAKrC,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,GAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,EAAC,OAAO,UAAU,EAAE,eAAe,CAAC;AAzEjG;;;;GAIG;AACH,iCAFa,mBAAmB,CAI/B;AAvND;;GAEG;AACH,sCAYoB,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,OAAO,cAAc,EAAE,sBAAsB,EAAC,mBAAmB,CAAC,CAAC,uBAGjH;cA1DW,QAAQ"}
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../../lib/cli/args.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,QAAQ,CAAC;AACvB,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,cAAc,CAAC;AAgBzD,MAAM,MAAM,mBAAmB,GAAG,GAAG,CACnC;IAAC,IAAI,EAAE,MAAM;CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,EAC9C,eAAe,CAChB,CAAC;AAwBF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,SAA0C,MAAM,CAC3E,aAAa,EACb,MAAM,CAAC,sBAAsB,EAAE,mBAAmB,CAAC,CACpD,sBAgBC,CAAC;AAEH;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,mBAAmB,CAEnD"}