appium 3.3.0 → 3.3.1

package/build/lib/{config-file.js → bootstrap/config-file.js}

@@ -36,45 +36,26 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatErrors = formatErrors;
 exports.readConfigFile = readConfigFile;
 exports.normalizeConfig = normalizeConfig;
-const better_ajv_errors_1 = __importDefault(require("@sidvind/better-ajv-errors"));
 const lilconfig_1 = require("lilconfig");
 const lodash_1 = __importDefault(require("lodash"));
 const yaml = __importStar(require("yaml"));
-const schema_1 = require("./schema/schema");
+const schema_1 = require("../schema/schema");
+const format_errors_1 = require("../schema/format-errors");
 /**
  * A cache of the raw config file (a JSON string) at a filepath.
  * This is used for better error reporting.
  * Note that config files needn't be JSON, but it helps if they are.
  */
 const rawConfig = new Map();
-/**
- * Given an array of errors and the result of loading a config file, generate a
- * helpful string for the user.
- *
- * - If `opts` contains a `json` property, this should be the original JSON
- *   _string_ of the config file.  This is only applicable if the config file
- *   was in JSON format. If present, it will associate line numbers with errors.
- * - If `errors` happens to be empty, this will throw.
- *
- * @throws {TypeError} If `errors` is empty
- */
-function formatErrors(errors = [], config = {}, opts = {}) {
-    if (errors && !errors.length) {
-        throw new TypeError('Array of errors must be non-empty');
-    }
-    return (0, better_ajv_errors_1.default)((0, schema_1.getSchema)(opts.schemaId), config, errors, {
-        json: opts.json,
-        format: opts.pretty === false ? 'js' : 'cli',
-    });
-}
 /**
  * Given an optional path, read a config file. Validates the config file.
  *
  * Call {@link validate} if you already have a config object.
  * @public
+ * @param filepath - Explicit config path; when omitted, searches with lilconfig
+ * @param opts - e.g. `pretty` for formatted validation errors
  * @returns Contains config and filepath, if found, and any errors
  */
 async function readConfigFile(filepath, opts = {}) {
@@ -97,7 +78,7 @@ async function readConfigFile(filepath, opts = {}) {
                 configResult = { ...result, errors };
             }
             else {
-                const reason = formatErrors(errors, result.config, {
+                const reason = (0, format_errors_1.formatErrors)(errors, result.config, {
                     json: rawConfig.get(result.filepath),
                     pretty,
                 });
@@ -115,8 +96,10 @@ async function readConfigFile(filepath, opts = {}) {
     return result ?? {};
 }
 /**
- * Convert schema property names to either a) the value of the `appiumCliDest` property, if any; or b) camel-case
- * @returns New object with camel-cased keys (or `dest` keys).
+ * Converts schema property names to either the `appiumCliDest` value, if any, or camelCase.
+ *
+ * @param config - Raw config object as parsed from file
+ * @returns New object with camel-cased keys (or CLI `dest` keys).
  */
 function normalizeConfig(config) {
     const schema = (0, schema_1.getSchema)();

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

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

package/build/lib/bootstrap/grid-v3-register.d.ts

@@ -0,0 +1,20 @@
+import type { StringRecord } from '@appium/types';
+interface Grid3HubConfiguration {
+    hubProtocol?: string;
+    hubHost?: string;
+    hubPort?: number;
+    url?: string;
+    host?: string;
+    port?: number;
+    id?: string;
+    register?: boolean;
+    registerCycle?: number;
+}
+interface Grid3NodeConfig extends StringRecord {
+    configuration?: Grid3HubConfiguration;
+    capabilities?: unknown;
+}
+export default function registerNode(data: string, addr: string, port: number, basePath: string): Promise<void>;
+export default function registerNode(data: Grid3NodeConfig, addr?: string, port?: number, basePath?: string): Promise<void>;
+export {};
+//# sourceMappingURL=grid-v3-register.d.ts.map

package/build/lib/bootstrap/grid-v3-register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid-v3-register.d.ts","sourceRoot":"","sources":["../../../lib/bootstrap/grid-v3-register.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,eAAe,CAAC;AAkBhD,UAAU,qBAAqB;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,eAAgB,SAAQ,YAAY;IAC5C,aAAa,CAAC,EAAE,qBAAqB,CAAC;IACtC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAOD,wBAA8B,YAAY,CACxC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAAC;AACjB,wBAA8B,YAAY,CACxC,IAAI,EAAE,eAAe,EACrB,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/build/lib/{grid-register.js → bootstrap/grid-v3-register.js}

@@ -7,7 +7,7 @@ exports.default = registerNode;
 const axios_1 = __importDefault(require("axios"));
 const support_1 = require("@appium/support");
 const lodash_1 = __importDefault(require("lodash"));
-const logger_1 = __importDefault(require("./logger"));
+const logger_1 = require("../logger");
 /**
  * Selenium **Grid 3** (legacy hub) node integration.
  *
@@ -20,14 +20,29 @@ const logger_1 = __importDefault(require("./logger"));
 /** REST paths exposed by a Selenium Grid 3 hub. */
 const GRID_V3_REGISTER_PATH = '/grid/register';
 const GRID_V3_PROXY_API_PATH = '/grid/api/proxy';
+/**
+ * Registers this server as a node with a **Selenium Grid 3** hub.
+ *
+ * When `data` is a path to a JSON config file, `addr`, `port`, and `basePath` are required (they define
+ * how the hub reaches this Appium server). When `data` is an inline config object, those parameters are
+ * optional and only used to fill missing node URL fields in the config.
+ *
+ * @deprecated Selenium Grid 3 registration is legacy and slated for removal.
+ * Use Selenium Grid 4 integration (node relay) instead.
+ *
+ * @param data - Path to a JSON file or an inline parsed config object
+ * @param addr - Bind to this address
+ * @param port - Bind to this port
+ * @param basePath - Base path for the Appium server (used in the node URL sent to the hub; may be `''`)
+ */
 async function registerNode(data, addr, port, basePath) {
     if (typeof data === 'string') {
         if (addr === undefined || port === undefined || basePath === undefined) {
-            throw logger_1.default.errorWithException('When the first argument is a Selenium Grid 3 node config file path, address, port, and basePath ' +
+            throw logger_1.log.errorWithException('When the first argument is a Selenium Grid 3 node config file path, address, port, and basePath ' +
                 'are required (e.g. match your Appium `--address`, `--port`, and base path).');
         }
         if (typeof port !== 'number' || !Number.isFinite(port)) {
-            throw logger_1.default.errorWithException('When registering from a node config file path, port must be a finite number.');
+            throw logger_1.log.errorWithException('When registering from a node config file path, port must be a finite number.');
         }
     }
     let configHolder;
@@ -38,7 +53,7 @@ async function registerNode(data, addr, port, basePath) {
             fileContent = await support_1.fs.readFile(data, 'utf-8');
         }
         catch (err) {
-            logger_1.default.error(`Unable to load Selenium Grid 3 node configuration file ${configFilePath} to ` +
+            logger_1.log.error(`Unable to load Selenium Grid 3 node configuration file ${configFilePath} to ` +
                 `register with the hub: ${err.message}`);
             return;
         }
@@ -46,7 +61,7 @@ async function registerNode(data, addr, port, basePath) {
             configHolder = JSON.parse(fileContent);
         }
         catch (err) {
-            throw logger_1.default.errorWithException(`Syntax error in Selenium Grid 3 node configuration file ${configFilePath}: ` +
+            throw logger_1.log.errorWithException(`Syntax error in Selenium Grid 3 node configuration file ${configFilePath}: ` +
                 err.message);
         }
     }
@@ -71,10 +86,10 @@ async function registerToGrid(postOptions, configHolder) {
         if (status !== 200) {
             throw new Error(`Request failed with code ${status}`);
         }
-        logger_1.default.debug(`Appium successfully registered with the Selenium Grid 3 hub at ` + hubUri(hubCfg));
+        logger_1.log.debug(`Appium successfully registered with the Selenium Grid 3 hub at ` + hubUri(hubCfg));
     }
     catch (err) {
-        logger_1.default.error(`An attempt to register with the Selenium Grid 3 hub was unsuccessful: ` +
+        logger_1.log.error(`An attempt to register with the Selenium Grid 3 hub was unsuccessful: ` +
             err.message);
     }
 }
@@ -116,18 +131,18 @@ function postRequest(configHolder, addr, port, basePath) {
         data: configHolder,
     };
     if (cfg.register !== true) {
-        logger_1.default.debug(`No Selenium Grid 3 hub registration sent (${cfg.register} = false)`);
+        logger_1.log.debug(`No Selenium Grid 3 hub registration sent (${cfg.register} = false)`);
         return;
     }
     const registerCycleInterval = cfg.registerCycle;
     if (registerCycleInterval === undefined || isNaN(registerCycleInterval) || registerCycleInterval <= 0) {
-        logger_1.default.warn(`'registerCycle' is not a valid positive number. ` +
+        logger_1.log.warn(`'registerCycle' is not a valid positive number. ` +
             `No registration request will be sent to the Selenium Grid 3 hub.`);
         return;
     }
     // initiate a new Thread
     let first = true;
-    logger_1.default.debug(`Starting auto-register thread for Selenium Grid 3. ` +
+    logger_1.log.debug(`Starting auto-register thread for Selenium Grid 3. ` +
         `Will try to register every ${registerCycleInterval} ms.`);
     setInterval(async function registerRetry() {
         if (first) {
@@ -159,12 +174,12 @@ async function isAlreadyRegistered(configHolder) {
         }
         if (!data.success) {
             // if register fail, print the debug msg
-            logger_1.default.debug(`Selenium Grid 3 hub registration check: ${data.msg}`);
+            logger_1.log.debug(`Selenium Grid 3 hub registration check: ${data.msg}`);
         }
         return data.success;
     }
     catch (err) {
-        logger_1.default.debug(`Selenium Grid 3 hub down or not responding: ${err.message}`);
+        logger_1.log.debug(`Selenium Grid 3 hub down or not responding: ${err.message}`);
     }
 }
-//# sourceMappingURL=grid-register.js.map
+//# sourceMappingURL=grid-v3-register.js.map

package/build/lib/bootstrap/grid-v3-register.js.map

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

package/build/lib/bootstrap/init-types.d.ts

@@ -0,0 +1,16 @@
+import type { AppiumDriver } from '../appium';
+import type { Args, CliCommand, CliCommandServer, CliCommandSetupSubcommand, CliExtensionSubcommand, ParsedArgs } from 'appium/types';
+import type { ExtensionConfigs } from '../extension';
+/** Empty object returned when `init` completes for non-server CLI flows (extension/setup). */
+export type ExtCommandInitResult = Record<string, never>;
+/** Driver/plugin config plus server instance and merged server args after successful server `init`. */
+export type ServerInitData = ExtensionConfigs & {
+    appiumDriver: AppiumDriver;
+    parsedArgs: ParsedArgs<CliCommandServer>;
+    appiumHome: string;
+};
+/** Discriminated by CLI command: server subcommand yields {@link ServerInitData}; otherwise {@link ExtCommandInitResult}. */
+export type InitResult<Cmd extends CliCommand = CliCommandServer> = Cmd extends CliCommandServer ? ServerInitData : ExtCommandInitResult;
+/** CLI + programmatic args before `init` narrows by `subcommand`. */
+export type PreConfigArgs = Args<CliCommand, CliExtensionSubcommand | CliCommandSetupSubcommand | void>;
+//# sourceMappingURL=init-types.d.ts.map

package/build/lib/bootstrap/init-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-types.d.ts","sourceRoot":"","sources":["../../../lib/bootstrap/init-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EACV,IAAI,EACJ,UAAU,EACV,gBAAgB,EAChB,yBAAyB,EACzB,sBAAsB,EACtB,UAAU,EACX,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,cAAc,CAAC;AAEnD,8FAA8F;AAC9F,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAEzD,uGAAuG;AACvG,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG;IAC9C,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC;IACzC,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,6HAA6H;AAC7H,MAAM,MAAM,UAAU,CAAC,GAAG,SAAS,UAAU,GAAG,gBAAgB,IAAI,GAAG,SAAS,gBAAgB,GAC5F,cAAc,GACd,oBAAoB,CAAC;AAEzB,qEAAqE;AACrE,MAAM,MAAM,aAAa,GAAG,IAAI,CAC9B,UAAU,EACV,sBAAsB,GAAG,yBAAyB,GAAG,IAAI,CAC1D,CAAC"}

package/build/lib/bootstrap/init-types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=init-types.js.map

package/build/lib/bootstrap/init-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-types.js","sourceRoot":"","sources":["../../../lib/bootstrap/init-types.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,55 @@
+import { type ServerOpts } from '@appium/base-driver';
+import type { AppiumServer, Driver, MethodMap, UpdateServerCallback } from '@appium/types';
+import type { AppiumDriver } from '../appium';
+import type { ParsedArgs, CliCommandServer } from 'appium/types';
+import type { DriverNameMap, PluginNameMap } from '../extension';
+/**
+ * Logs a value to the console using the info logger (with util.inspect formatting).
+ */
+export declare const inspect: (t1: unknown) => void;
+/**
+ * Prints the current build info JSON to stdout.
+ *
+ * This updates build metadata first (using GitHub fallback) and then logs the
+ * resulting {@link BuildInfo} object.
+ */
+export declare function showBuildInfo(): Promise<void>;
+/**
+ * Human-readable label for where Appium resolved `APPIUM_HOME` from (CLI, env, or autodetect).
+ */
+export declare function determineAppiumHomeSource(appiumHomeFromArgs?: string | null): string;
+/**
+ * Logs the REST listener URL; if the bind address is a broadcast address, lists concrete interface URLs.
+ */
+export declare function logServerAddress(url: string): void;
+/**
+ * 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)`
+ */
+export declare function preflightChecks(args: ParsedArgs<CliCommandServer>, throwInsteadOfExit?: boolean): Promise<void>;
+/**
+ * Prints welcome line (version + optional git rev), non-default server args, and default capabilities.
+ */
+export declare function logStartupInfo(args: ParsedArgs<CliCommandServer>): Promise<void>;
+/**
+ * Collects `updateServer` hooks from active driver and plugin classes for HTTP server customization.
+ */
+export declare function getServerUpdaters(driverClasses: DriverNameMap, pluginClasses: PluginNameMap): UpdateServerCallback[];
+/**
+ * Merges `newMethodMap` contributions from all active drivers and plugins into one method map.
+ */
+export declare function getExtraMethodMap(driverClasses: DriverNameMap, pluginClasses: PluginNameMap): MethodMap<Driver>;
+/**
+ * Builds {@link ServerOpts} and normalized base path for the Appium HTTP server from CLI args and extensions.
+ */
+export declare function buildServerOpts(appiumDriver: AppiumDriver, parsedArgs: ParsedArgs<CliCommandServer>, driverClasses: DriverNameMap, pluginClasses: PluginNameMap): {
+    serverOpts: ServerOpts;
+    normalizedBasePath: string;
+};
+/**
+ * Creates the Appium HTTP server and attaches WebSocket handlers for BiDi under the normalized base path.
+ */
+export declare function createAppiumServer(serverOpts: ServerOpts, appiumDriver: AppiumDriver, normalizedBasePath: string): Promise<AppiumServer>;
+//# sourceMappingURL=main-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"main-helpers.d.ts","sourceRoot":"","sources":["../../../lib/bootstrap/main-helpers.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,oBAAoB,EAAC,MAAM,eAAe,CAAC;AAGzF,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,WAAW,CAAC;AAO5C,OAAO,KAAK,EAAO,UAAU,EAAE,gBAAgB,EAAC,MAAM,cAAc,CAAC;AACrE,OAAO,KAAK,EAAC,aAAa,EAAE,aAAa,EAAC,MAAM,cAAc,CAAC;AAI/D;;GAEG;AACH,eAAO,MAAM,OAAO,uBASnB,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAInD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAQpF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAiBlD;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,UAAU,CAAC,gBAAgB,CAAC,EAClC,kBAAkB,UAAQ,GACzB,OAAO,CAAC,IAAI,CAAC,CAyBf;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAetF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,aAAa,GAC3B,oBAAoB,EAAE,CAExB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,GAAG,SAAS,CAAC,MAAM,CAAC,CAQ/G;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,UAAU,CAAC,gBAAgB,CAAC,EACxC,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,aAAa,GAC3B;IAAC,UAAU,EAAE,UAAU,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAA;CAAC,CAmBtD;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,YAAY,EAC1B,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC,YAAY,CAAC,CASvB"}

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":";;;;;;AA4CA,sCAIC;AAKD,8DAQC;AAKD,4CAiBC;AAQD,0CA4BC;AAKD,wCAeC;AAKD,8CAKC;AAKD,8CAQC;AAKD,0CAwBC;AAKD,gDAaC;AAjND,yCAA+D;AAC/D,sCAAwC;AACxC,qDAK6B;AAC7B,oDAAuB;AAEvB,2BAAmC;AAGnC,4CAAsF;AACtF,iDAAuD;AACvD,qDAAyD;AACzD,6CAA4D;AAC5D,gDAAmF;AACnF,4CAAmE;AAInE,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;AAEzC;;GAEG;AACU,QAAA,OAAO,GAAG,gBAAC,CAAC,IAAI,CAC3B,gBAAC,CAAC,YAAY,CAAC,mBAA4D,EAAE;IAC3E,MAAM,EAAE,IAAI;IACZ,KAAK,EAAE,IAAI;IACX,OAAO,EAAE,CAAC,WAAW;CACtB,CAAC,EACF,CAAC,GAAG,IAAe,EAAE,EAAE;IACrB,YAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;AACvB,CAAC,CACF,CAAC;AAEF;;;;;GAKG;AACI,KAAK,UAAU,aAAa;IACjC,MAAM,IAAA,uBAAe,EAAC,IAAI,CAAC,CAAC;IAC5B,qEAAqE;IACrE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAA,oBAAY,GAAE,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,SAAgB,yBAAyB,CAAC,kBAAkC;IAC1E,IAAI,CAAC,gBAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACjC,OAAO,yBAAyB,CAAC;IACnC,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;QAC5B,OAAO,kCAAkC,CAAC;IAC5C,CAAC;IACD,OAAO,+BAA+B,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,GAAW;IAC1C,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,YAAM,CAAC,IAAI,CAAC,kDAAkD,GAAG,EAAE,CAAC,CAAC;IACrE,IAAI,CAAC,IAAA,uBAAa,EAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpC,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GAAG,IAAA,yBAAe,EAAC,MAAM,CAAC,QAAQ,KAAK,yBAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChF,MAAM,OAAO,GAAG,CAAC,KAA2B,EAAE,EAAE;QAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACjE,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,uCAAuC,CAAC,CAAC,CAAC,IAAI,CAAC;IAChF,CAAC,CAAC;IACF,YAAM,CAAC,IAAI,CACT,iCAAiC,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,GAAG;QAC1E,kDAAkD;QAClD,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAC9D,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,eAAe,CACnC,IAAkC,EAClC,kBAAkB,GAAG,KAAK;IAE1B,IAAI,CAAC;QACH,IAAA,0BAAW,GAAE,CAAC;QACd,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,KAAK,CAAC,eAAe,GAAG,iCAAqB,CAAC;QAChD,CAAC;QACD,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,MAAM,aAAa,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,IAAA,iBAAc,EAAC,IAAI,CAAC,CAAC;QAErB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAA,yBAAU,EAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,uBAAuB,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,YAAM,CAAC,KAAK,CAAE,OAAkC,CAAC,GAAG,CAAC,CAAC;QACtD,IAAI,kBAAkB,EAAE,CAAC;YACvB,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,cAAc,CAAC,IAAkC;IACrE,IAAI,OAAO,GAAG,sBAAsB,kBAAU,EAAE,CAAC;IACjD,MAAM,SAAS,GAAG,MAAM,IAAA,iBAAS,GAAE,CAAC;IACpC,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,IAAI,SAAS,SAAS,GAAG,CAAC;IACnC,CAAC;IACD,YAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAErB,MAAM,QAAQ,GAAG,IAAA,wCAAuB,EAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,gBAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrB,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,CAAC,gBAAC,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACzC,6BAA6B,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAC/B,aAA4B,EAC5B,aAA4B;IAE5B,OAAO,gBAAC,CAAC,OAAO,CAAC,gBAAC,CAAC,GAAG,CAAC,CAAC,GAAG,aAAa,CAAC,IAAI,EAAE,EAAE,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;AAC9F,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,aAA4B,EAAE,aAA4B;IAC1F,OAAO,CAAC,GAAG,aAAa,CAAC,IAAI,EAAE,EAAE,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAC9D,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACf,GAAG,GAAG;QACN,GAAG,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC;KAC9B,CAAC,EACF,EAAE,CACH,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAC7B,YAA0B,EAC1B,UAAwC,EACxC,aAA4B,EAC5B,aAA4B;IAE5B,MAAM,wBAAwB,GAAG,IAAA,sCAAU,EAAC,YAAY,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAe;QAC7B,wBAAwB;QACxB,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,QAAQ,EAAE,UAAU,CAAC,OAAO;QAC5B,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,cAAc,EAAE,iBAAiB,CAAC,aAAa,EAAE,aAAa,CAAC;QAC/D,cAAc,EAAE,iBAAiB,CAAC,aAAa,EAAE,aAAa,CAAC;QAC/D,OAAO,EAAE,UAAU;KACpB,CAAC;IACF,MAAM,kBAAkB,GAAG,IAAA,+BAAiB,EAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClE,KAAK,MAAM,cAAc,IAAI,CAAC,kBAAkB,EAAE,gBAAgB,CAAU,EAAE,CAAC;QAC7E,IAAI,gBAAC,CAAC,SAAS,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC;YAC5C,UAAU,CAAC,cAAc,CAAC,GAAG,UAAU,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;QACjE,CAAC;IACH,CAAC;IACD,OAAO,EAAC,UAAU,EAAE,kBAAkB,EAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,kBAAkB,CACtC,UAAsB,EACtB,YAA0B,EAC1B,kBAA0B;IAE1B,MAAM,UAAU,GAAG,IAAI,oBAAe,CAAC,EAAC,QAAQ,EAAE,IAAI,EAAC,CAAC,CAAC;IACzD,UAAU,CAAC,EAAE,CAAC,YAAY,EAAE,YAAY,CAAC,gBAAgB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;IAC9E,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,iBAAiB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAG,MAAM,IAAA,oBAAU,EAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,GAAG,kBAAkB,GAAG,0BAAc,EAAE,CAAC;IAC9D,MAAM,MAAM,CAAC,mBAAmB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC3D,MAAM,MAAM,CAAC,mBAAmB,CAAC,GAAG,YAAY,aAAa,EAAE,UAAU,CAAC,CAAC;IAC3E,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,wBAAwB,CAAC,IAAU;IAC1C,YAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IACxC,IAAA,eAAO,EAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,SAAS,6BAA6B,CAAC,IAAyD;IAC9F,YAAM,CAAC,IAAI,CACT,4DAA4D;QAC1D,4CAA4C,CAC/C,CAAC;IACF,IAAA,eAAO,EAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

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"}