appium-mac2-driver 4.5.0 → 4.6.0

package/node_modules/@appium/base-driver/build/lib/express/idempotency.js.map

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

package/node_modules/@appium/base-driver/build/lib/express/logger.d.ts

@@ -0,0 +1,2 @@
+export declare const log: import("../../../types/build/lib").AppiumLogger;
+//# sourceMappingURL=logger.d.ts.map

package/node_modules/@appium/base-driver/build/lib/express/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../lib/express/logger.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,GAAG,iDAA2B,CAAC"}

package/node_modules/@appium/base-driver/build/lib/express/logger.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.log = void 0;
+const support_1 = require("@appium/support");
+exports.log = support_1.logger.getLogger('HTTP');
+//# sourceMappingURL=logger.js.map

package/node_modules/@appium/base-driver/build/lib/express/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../lib/express/logger.ts"],"names":[],"mappings":";;;AAAA,6CAAuC;AAE1B,QAAA,GAAG,GAAG,gBAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC"}

package/node_modules/@appium/base-driver/build/lib/express/middleware.d.ts

@@ -0,0 +1,67 @@
+import type { IncomingMessage } from 'node:http';
+import type { Duplex } from 'node:stream';
+import type { NextFunction, Request, RequestHandler, Response } from 'express';
+export { handleIdempotency } from './idempotency';
+import type { StringRecord, WSServer } from '@appium/types';
+/**
+ * Basic CORS middleware.
+ * Sets permissive CORS headers and responds immediately to `OPTIONS` requests with 200.
+ */
+export declare function allowCrossDomain(req: Request, res: Response, next: NextFunction): void;
+/**
+ * CORS middleware for async execute response endpoints only.
+ * Leaves other routes untouched but applies {@link allowCrossDomain} to async response URLs.
+ *
+ * @param basePath - Server base path (e.g. `/wd/hub` or `/`)
+ * @returns Express request handler
+ */
+export declare function allowCrossDomainAsyncExecute(basePath: string): RequestHandler;
+/**
+ * Populates the logger's async context with request and session metadata.
+ * Derives `requestId`, optional session id/signature, and `isSensitive` flag from headers/URL.
+ */
+export declare function handleLogContext(req: Request, _res: Response, next: NextFunction): void;
+/**
+ * Ensures requests default to JSON content-type when none is provided.
+ */
+export declare function defaultToJSONContentType(req: Request, _res: Response, next: NextFunction): void;
+/** Options for {@linkcode tryHandleWebSocketUpgrade} */
+export interface WebSocketUpgradeOpts {
+    /** Incoming HTTP request */
+    req: IncomingMessage;
+    /** Network socket */
+    socket: Duplex;
+    /** First packet of the upgraded stream */
+    head: Buffer;
+    /** Path-to-WebSocket-server mapping */
+    webSocketsMapping: StringRecord<WSServer>;
+    /** Whether upgrades carrying an `Origin` header are accepted */
+    allowCors?: boolean;
+}
+/**
+ * Attempts to handle a WebSocket upgrade by matching the request path against registered handlers.
+ *
+ * @param opts - Upgrade options
+ * @returns `true` if the upgrade was handled; `false` otherwise
+ */
+export declare function tryHandleWebSocketUpgrade({ req, socket, head, webSocketsMapping, allowCors, }: WebSocketUpgradeOpts): boolean;
+/**
+ * Express middleware wrapper around {@link tryHandleWebSocketUpgrade}.
+ * Delegates WebSocket upgrades to the mapping and falls through to `next()` otherwise.
+ *
+ * @param webSocketsMapping - Path-to-WebSocket-server mapping
+ * @param allowCors - Whether upgrades carrying an `Origin` header are accepted
+ * @returns Express request handler
+ */
+export declare function handleUpgrade(webSocketsMapping: StringRecord<WSServer>, allowCors?: boolean): RequestHandler;
+/**
+ * Final error-handling middleware.
+ * Logs uncaught errors and returns a W3C-formatted error response unless headers were already sent.
+ */
+export declare function catchAllHandler(err: Error, _req: Request, res: Response, next: NextFunction): void;
+/**
+ * 404 handler for unmatched routes.
+ * Logs a debug message and responds with `UnknownCommandError` in W3C format.
+ */
+export declare function catch404Handler(req: Request, res: Response): void;
+//# sourceMappingURL=middleware.d.ts.map

package/node_modules/@appium/base-driver/build/lib/express/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../lib/express/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,aAAa,CAAC;AAGxC,OAAO,KAAK,EAAC,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAC,MAAM,SAAS,CAAC;AAI7E,OAAO,EAAC,iBAAiB,EAAC,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAC,YAAY,EAAE,QAAQ,EAAC,MAAM,eAAe,CAAC;AAQ1D;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAatF;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAe7E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAiBvF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAK/F;AAED,wDAAwD;AACxD,MAAM,WAAW,oBAAoB;IACnC,4BAA4B;IAC5B,GAAG,EAAE,eAAe,CAAC;IACrB,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,iBAAiB,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC1C,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,EACxC,GAAG,EACH,MAAM,EACN,IAAI,EACJ,iBAAiB,EACjB,SAAiB,GAClB,EAAE,oBAAoB,GAAG,OAAO,CA4BhC;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,iBAAiB,EAAE,YAAY,CAAC,QAAQ,CAAC,EAAE,SAAS,UAAQ,GAAG,cAAc,CAS1G;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAWlG;AAUD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,CAIjE"}

package/node_modules/@appium/base-driver/build/lib/express/middleware.js

@@ -0,0 +1,164 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleIdempotency = void 0;
+exports.allowCrossDomain = allowCrossDomain;
+exports.allowCrossDomainAsyncExecute = allowCrossDomainAsyncExecute;
+exports.handleLogContext = handleLogContext;
+exports.defaultToJSONContentType = defaultToJSONContentType;
+exports.tryHandleWebSocketUpgrade = tryHandleWebSocketUpgrade;
+exports.handleUpgrade = handleUpgrade;
+exports.catchAllHandler = catchAllHandler;
+exports.catch404Handler = catch404Handler;
+const support_1 = require("@appium/support");
+const protocol_1 = require("../protocol");
+const logger_1 = require("./logger");
+var idempotency_1 = require("./idempotency");
+Object.defineProperty(exports, "handleIdempotency", { enumerable: true, get: function () { return idempotency_1.handleIdempotency; } });
+const path_to_regexp_1 = require("path-to-regexp");
+const session_1 = require("../helpers/session");
+const errors_1 = require("../protocol/errors");
+const SESSION_ID_PATTERN = /\/session\/([^/]+)/;
+/**
+ * Basic CORS middleware.
+ * Sets permissive CORS headers and responds immediately to `OPTIONS` requests with 200.
+ */
+function allowCrossDomain(req, res, next) {
+    res.header('Access-Control-Allow-Origin', '*');
+    res.header('Access-Control-Allow-Methods', 'GET, POST, PUT, OPTIONS, DELETE');
+    res.header('Access-Control-Allow-Headers', 'Cache-Control, Pragma, Origin, X-Requested-With, Content-Type, Accept, User-Agent');
+    if (req.method === 'OPTIONS') {
+        res.sendStatus(200);
+        return;
+    }
+    next();
+}
+/**
+ * CORS middleware for async execute response endpoints only.
+ * Leaves other routes untouched but applies {@link allowCrossDomain} to async response URLs.
+ *
+ * @param basePath - Server base path (e.g. `/wd/hub` or `/`)
+ * @returns Express request handler
+ */
+function allowCrossDomainAsyncExecute(basePath) {
+    function allowCrossDomainAsyncExecuteHandler(req, res, next) {
+        const receiveAsyncResponseRegExp = new RegExp(`^${support_1.util.escapeRegExp(basePath)}/session/[a-f0-9-]+/(appium/)?receive_async_response/?$`);
+        // Match against req.path (query-stripped) so query-string data cannot be used
+        // to smuggle a match for an otherwise unrelated endpoint.
+        if (!receiveAsyncResponseRegExp.test(req.path)) {
+            next();
+            return;
+        }
+        allowCrossDomain(req, res, next);
+    }
+    return allowCrossDomainAsyncExecuteHandler;
+}
+/**
+ * Populates the logger's async context with request and session metadata.
+ * Derives `requestId`, optional session id/signature, and `isSensitive` flag from headers/URL.
+ */
+function handleLogContext(req, _res, next) {
+    const requestId = fetchHeaderValue(req, 'x-request-id') || support_1.util.uuidV4();
+    const sessionId = SESSION_ID_PATTERN.exec(req.path)?.[1];
+    const sessionInfo = sessionId ? { sessionId, sessionSignature: (0, session_1.calcSignature)(sessionId) } : {};
+    const isSensitiveHeaderValue = fetchHeaderValue(req, 'x-appium-is-sensitive');
+    logger_1.log.updateAsyncContext({
+        requestId,
+        ...sessionInfo,
+        isSensitive: ['true', '1', 'yes'].includes(String(isSensitiveHeaderValue ?? '').toLowerCase()),
+    }, true);
+    next();
+}
+/**
+ * Ensures requests default to JSON content-type when none is provided.
+ */
+function defaultToJSONContentType(req, _res, next) {
+    if (!req.headers['content-type']) {
+        req.headers['content-type'] = 'application/json; charset=utf-8';
+    }
+    next();
+}
+/**
+ * Attempts to handle a WebSocket upgrade by matching the request path against registered handlers.
+ *
+ * @param opts - Upgrade options
+ * @returns `true` if the upgrade was handled; `false` otherwise
+ */
+function tryHandleWebSocketUpgrade({ req, socket, head, webSocketsMapping, allowCors = false, }) {
+    if (String(req.headers?.upgrade ?? '').toLowerCase() !== 'websocket') {
+        return false;
+    }
+    // WebSocket handshakes are not subject to the Same-Origin Policy; browsers always send Origin
+    if (!allowCors && req.headers.origin !== undefined) {
+        logger_1.log.warn(`Rejecting the WebSocket upgrade from the browser origin '${req.headers.origin}'`);
+        socket.end('HTTP/1.1 403 Forbidden\r\nConnection: close\r\nContent-Length: 0\r\n\r\n');
+        return true;
+    }
+    let currentPathname;
+    try {
+        currentPathname = new URL(req.url ?? '', 'http://localhost').pathname;
+    }
+    catch {
+        currentPathname = req.url ?? '';
+    }
+    for (const [pathname, wsServer] of Object.entries(webSocketsMapping)) {
+        if ((0, path_to_regexp_1.match)(pathname)(currentPathname)) {
+            wsServer.handleUpgrade(req, socket, head, (ws) => {
+                wsServer.emit('connection', ws, req);
+            });
+            return true;
+        }
+    }
+    logger_1.log.info(`Did not match the websocket upgrade request at ${currentPathname} to any known route`);
+    return false;
+}
+/**
+ * Express middleware wrapper around {@link tryHandleWebSocketUpgrade}.
+ * Delegates WebSocket upgrades to the mapping and falls through to `next()` otherwise.
+ *
+ * @param webSocketsMapping - Path-to-WebSocket-server mapping
+ * @param allowCors - Whether upgrades carrying an `Origin` header are accepted
+ * @returns Express request handler
+ */
+function handleUpgrade(webSocketsMapping, allowCors = false) {
+    function handleUpgradeMiddleware(req, res, next) {
+        if (tryHandleWebSocketUpgrade({ req, socket: req.socket, head: Buffer.from(''), webSocketsMapping, allowCors })) {
+            return;
+        }
+        next();
+    }
+    return handleUpgradeMiddleware;
+}
+/**
+ * Final error-handling middleware.
+ * Logs uncaught errors and returns a W3C-formatted error response unless headers were already sent.
+ */
+function catchAllHandler(err, _req, res, next) {
+    if (res.headersSent) {
+        next(err);
+        return;
+    }
+    logger_1.log.error(`Uncaught error: ${err.message}`);
+    const [status, body] = (0, errors_1.getResponseForW3CError)(isBodyParseError(err) ? new protocol_1.errors.InvalidArgumentError(err.message) : err);
+    res.status(status).json(body);
+}
+/**
+ * Detects the error body-parser raises for a request body that is not valid JSON.
+ * The protocol expects such a request to be rejected as an invalid argument.
+ */
+function isBodyParseError(err) {
+    return err?.type === 'entity.parse.failed';
+}
+/**
+ * 404 handler for unmatched routes.
+ * Logs a debug message and responds with `UnknownCommandError` in W3C format.
+ */
+function catch404Handler(req, res) {
+    logger_1.log.debug(`No route found for ${req.url}`);
+    const [status, body] = (0, errors_1.getResponseForW3CError)(new protocol_1.errors.UnknownCommandError());
+    res.status(status).json(body);
+}
+function fetchHeaderValue(req, name) {
+    const value = req.headers[name];
+    return Array.isArray(value) ? value[0] : value;
+}
+//# sourceMappingURL=middleware.js.map

package/node_modules/@appium/base-driver/build/lib/express/middleware.js.map

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

package/node_modules/@appium/base-driver/build/lib/express/server.d.ts

@@ -0,0 +1,70 @@
+import type { Server as HttpServer } from 'node:http';
+import type { AppiumServer, ExternalDriver, MethodMap, ServerArgs, StringRecord, UpdateServerCallback } from '@appium/types';
+import type { Express, Router } from 'express';
+/** Options for {@linkcode RouteConfiguringFunction} */
+export interface RouteConfiguringFunctionOpts {
+    basePath?: string;
+    extraMethodMap?: MethodMap<ExternalDriver>;
+}
+/** A function which configures routes */
+export type RouteConfiguringFunction = (app: Express, opts?: RouteConfiguringFunctionOpts) => void;
+/** Options for {@linkcode server} */
+export interface ServerOpts {
+    routeConfiguringFunction: RouteConfiguringFunction;
+    port: number;
+    cliArgs?: Partial<ServerArgs>;
+    hostname?: string;
+    allowCors?: boolean;
+    basePath?: string;
+    extraMethodMap?: MethodMap<ExternalDriver>;
+    serverUpdaters?: UpdateServerCallback[];
+    keepAliveTimeout?: number;
+    requestTimeout?: number;
+}
+/** Options for {@linkcode configureServer} */
+export interface ConfigureServerOpts {
+    app: Express;
+    addRoutes: RouteConfiguringFunction;
+    allowCors?: boolean;
+    basePath?: string;
+    extraMethodMap?: MethodMap<ExternalDriver>;
+    webSocketsMapping?: StringRecord;
+    useLegacyUpgradeHandler?: boolean;
+    /** Router mounted before any route is registered; see {@linkcode AppiumServer.frontRouter}. */
+    frontRouter: Router;
+}
+/** Options for {@linkcode configureHttp} */
+export interface ConfigureHttpOpts {
+    httpServer: HttpServer;
+    reject: (error?: unknown) => void;
+    allowCors?: boolean;
+    keepAliveTimeout: number;
+    gracefulShutdownTimeout?: number;
+}
+/** Options for {@linkcode startServer} */
+export interface StartServerOpts {
+    httpServer: HttpServer;
+    port: number;
+    hostname?: string;
+    keepAliveTimeout: number;
+    requestTimeout?: number;
+}
+/**
+ * @param opts - Server options
+ * @returns Promise resolving to the Appium server instance
+ */
+export declare function server(opts: ServerOpts): Promise<AppiumServer>;
+/**
+ * Sets up Express middleware and routes.
+ *
+ * @param opts - Configuration options
+ */
+export declare function configureServer(opts: ConfigureServerOpts): void;
+/**
+ * Normalize base path string (leading slash, no trailing slash).
+ *
+ * @param basePath - Raw base path
+ * @returns Normalized base path
+ */
+export declare function normalizeBasePath(basePath: string): string;
+//# sourceMappingURL=server.d.ts.map

package/node_modules/@appium/base-driver/build/lib/express/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../lib/express/server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,MAAM,IAAI,UAAU,EAAC,MAAM,WAAW,CAAC;AAMpD,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,SAAS,EACT,UAAU,EACV,YAAY,EACZ,oBAAoB,EACrB,MAAM,eAAe,CAAC;AAGvB,OAAO,KAAK,EAAC,OAAO,EAAkB,MAAM,EAAC,MAAM,SAAS,CAAC;AA2B7D,uDAAuD;AACvD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;CAC5C;AAED,yCAAyC;AACzC,MAAM,MAAM,wBAAwB,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,4BAA4B,KAAK,IAAI,CAAC;AAEnG,qCAAqC;AACrC,MAAM,WAAW,UAAU;IACzB,wBAAwB,EAAE,wBAAwB,CAAC;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;IAC3C,cAAc,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACxC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,8CAA8C;AAC9C,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,EAAE,wBAAwB,CAAC;IACpC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;IAC3C,iBAAiB,CAAC,EAAE,YAAY,CAAC;IACjC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,+FAA+F;IAC/F,WAAW,EAAE,MAAM,CAAC;CACrB;AAQD,4CAA4C;AAC5C,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAClC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,0CAA0C;AAC1C,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAuEpE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAmD/D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAe1D"}

package/node_modules/@appium/base-driver/build/lib/express/server.js

@@ -0,0 +1,287 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.server = server;
+exports.configureServer = configureServer;
+exports.normalizeBasePath = normalizeBasePath;
+const node_http_1 = __importDefault(require("node:http"));
+const node_module_1 = require("node:module");
+// Import env helper directly — not from the test-pages barrel — so Express handlers and
+// fixture code stay unloaded unless APPIUM_ENABLE_LEGACY_TEST_PAGES is set.
+const support_1 = require("@appium/support");
+const body_parser_1 = __importDefault(require("body-parser"));
+const express_1 = __importDefault(require("express"));
+const method_override_1 = __importDefault(require("method-override"));
+const constants_1 = require("../constants");
+const env_1 = require("../test-pages/env");
+const express_logging_1 = require("./express-logging");
+const logger_1 = require("./logger");
+const middleware_1 = require("./middleware");
+const websocket_1 = require("./websocket");
+const KEEP_ALIVE_TIMEOUT_MS = 10 * 60 * 1000; // 10 minutes
+/**
+ * @param opts - Server options
+ * @returns Promise resolving to the Appium server instance
+ */
+async function server(opts) {
+    const { routeConfiguringFunction, port, hostname, cliArgs = {}, allowCors = true, basePath = constants_1.DEFAULT_BASE_PATH, extraMethodMap = {}, serverUpdaters = [], keepAliveTimeout = KEEP_ALIVE_TIMEOUT_MS, requestTimeout, } = opts;
+    const app = (0, express_1.default)();
+    const httpServer = await createServer(app, cliArgs);
+    return await new Promise((resolve, reject) => {
+        // we use a promise here because some elements of server start failure only happen in
+        // httpServer listeners. The async IIFE runs setup serially (e.g. plugin updates) while
+        // configureHttp can still reject via the listener registered below.
+        void (async () => {
+            try {
+                const appiumServer = configureHttp({
+                    httpServer,
+                    reject,
+                    allowCors,
+                    keepAliveTimeout,
+                    gracefulShutdownTimeout: cliArgs.shutdownTimeout,
+                });
+                const useLegacyUpgradeHandler = !hasShouldUpgradeCallback(httpServer);
+                let registerTestPages;
+                if ((0, env_1.isLegacyTestPagesEnabled)()) {
+                    const require = (0, node_module_1.createRequire)(__filename);
+                    registerTestPages = require('../test-pages').registerTestPages;
+                }
+                configureServer({
+                    app,
+                    addRoutes: routeConfiguringFunction,
+                    allowCors,
+                    basePath,
+                    extraMethodMap,
+                    webSocketsMapping: appiumServer.webSocketsMapping,
+                    useLegacyUpgradeHandler,
+                    registerTestPages,
+                    frontRouter: appiumServer.frontRouter,
+                });
+                // allow extensions to update the app and http server objects
+                for (const updater of serverUpdaters) {
+                    await updater(app, appiumServer, cliArgs);
+                }
+                // once all configurations and updaters have been applied, make sure to set up a catchall
+                // handler so that anything unknown 404s. But do this after everything else since we don't
+                // want to block extensions' ability to add routes if they want.
+                app.all('/*all', middleware_1.catch404Handler);
+                await startServer({
+                    httpServer,
+                    hostname,
+                    port,
+                    keepAliveTimeout,
+                    requestTimeout,
+                });
+                resolve(appiumServer);
+            }
+            catch (err) {
+                reject(err);
+            }
+        })();
+    });
+}
+/**
+ * Sets up Express middleware and routes.
+ *
+ * @param opts - Configuration options
+ */
+function configureServer(opts) {
+    const { app, addRoutes, allowCors = true, basePath: rawBasePath = constants_1.DEFAULT_BASE_PATH, extraMethodMap = {}, webSocketsMapping = {}, useLegacyUpgradeHandler = true, frontRouter, } = opts;
+    const { registerTestPages } = opts;
+    const basePath = normalizeBasePath(rawBasePath);
+    app.use(express_logging_1.endLogFormatter);
+    app.use(middleware_1.handleLogContext);
+    if (registerTestPages) {
+        registerTestPages(app, { basePath });
+    }
+    // Only use legacy Express middleware for WebSocket upgrades if shouldUpgradeCallback is not available.
+    // When shouldUpgradeCallback is available, upgrades are handled directly on the HTTP server
+    // to avoid Express middleware timeout issues with long-lived connections
+    if (useLegacyUpgradeHandler) {
+        app.use((0, middleware_1.handleUpgrade)(webSocketsMapping, allowCors));
+    }
+    if (allowCors) {
+        app.use(middleware_1.allowCrossDomain);
+    }
+    else {
+        app.use((0, middleware_1.allowCrossDomainAsyncExecute)(basePath));
+    }
+    app.use(middleware_1.handleIdempotency);
+    app.use(middleware_1.defaultToJSONContentType);
+    app.use(body_parser_1.default.urlencoded({ extended: true }));
+    app.use((0, method_override_1.default)());
+    // make sure appium never fails because of a file size upload limit
+    app.use(body_parser_1.default.json({ limit: '1gb' }));
+    // set up start logging (which depends on bodyParser doing its thing)
+    app.use(express_logging_1.startLogFormatter);
+    // mounted before any route, so middleware added later (e.g. via `updateServer`) still runs first
+    app.use(frontRouter);
+    addRoutes(app, { basePath, extraMethodMap });
+    // Express only passes errors to an error handler registered after the middleware
+    // that raised them, so this one must be the last of all.
+    app.use(middleware_1.catchAllHandler);
+}
+/**
+ * Normalize base path string (leading slash, no trailing slash).
+ *
+ * @param basePath - Raw base path
+ * @returns Normalized base path
+ */
+function normalizeBasePath(basePath) {
+    if (typeof basePath !== 'string') {
+        throw new Error(`Invalid path prefix ${basePath}`);
+    }
+    // ensure the path prefix does not end in '/', since our method map starts all paths with '/'
+    basePath = basePath.replace(/\/$/, '');
+    // likewise, ensure the path prefix does always START with /, unless the path
+    // is empty meaning no base path at all
+    if (basePath !== '' && !basePath.startsWith('/')) {
+        basePath = `/${basePath}`;
+    }
+    return basePath;
+}
+async function createServer(app, cliArgs) {
+    const { sslCertificatePath, sslKeyPath } = cliArgs ?? {};
+    if (!sslCertificatePath && !sslKeyPath) {
+        return node_http_1.default.createServer(app);
+    }
+    if (!sslCertificatePath || !sslKeyPath) {
+        throw new Error(`Both certificate path and key path must be provided to enable TLS`);
+    }
+    const certKey = [sslCertificatePath, sslKeyPath];
+    const [certExists, keyExists] = await Promise.all(certKey.map((p) => support_1.fs.exists(p)));
+    for (const [exists, desc, p] of [
+        [certExists, 'certificate', sslCertificatePath],
+        [keyExists, 'key', sslKeyPath],
+    ]) {
+        if (!exists) {
+            throw new Error(`The provided SSL ${desc} at '${p}' does not exist or is not accessible`);
+        }
+    }
+    const [cert, key] = (await Promise.all(certKey.map((p) => support_1.fs.readFile(p, 'utf8'))));
+    logger_1.log.debug('Enabling TLS/SPDY on the server using the provided certificate');
+    const spdy = require('spdy');
+    return spdy.createServer({
+        cert,
+        key,
+        spdy: {
+            plain: false,
+            ssl: true,
+        },
+    }, app);
+}
+/**
+ * Attaches Appium-specific behavior to the HTTP server and returns it as {@linkcode AppiumServer}.
+ * Mutates the `httpServer` parameter.
+ *
+ * @param opts - Configuration options
+ * @returns The same server instance typed as AppiumServer
+ */
+function configureHttp({ httpServer, reject, allowCors, keepAliveTimeout, gracefulShutdownTimeout, }) {
+    const appiumServer = httpServer;
+    appiumServer.webSocketsMapping = {};
+    appiumServer.frontRouter = express_1.default.Router();
+    appiumServer.addWebSocketHandler = websocket_1.addWebSocketHandler;
+    appiumServer.removeWebSocketHandler = websocket_1.removeWebSocketHandler;
+    appiumServer.removeAllWebSocketHandlers = websocket_1.removeAllWebSocketHandlers;
+    appiumServer.getWebSocketHandlers = websocket_1.getWebSocketHandlers;
+    appiumServer.isSecure = function isSecure() {
+        return Boolean(this._spdyState?.secure);
+    };
+    // This avoids Express middleware timeout issues with long-lived WebSocket connections
+    // See: https://github.com/appium/appium/issues/20760
+    // See: https://github.com/nodejs/node/pull/59824
+    if (hasShouldUpgradeCallback(httpServer)) {
+        // shouldUpgradeCallback only returns a boolean to indicate if the upgrade should proceed
+        appiumServer.shouldUpgradeCallback = (req) => String(req.headers?.upgrade ?? '').toLowerCase() === 'websocket';
+        appiumServer.on('upgrade', (req, socket, head) => {
+            if (!(0, middleware_1.tryHandleWebSocketUpgrade)({ req, socket, head, webSocketsMapping: appiumServer.webSocketsMapping, allowCors })) {
+                socket.destroy();
+            }
+        });
+    }
+    // http.Server.close() only stops new connections, but we need to wait until
+    // all connections are closed and the `close` event is emitted
+    const originalClose = appiumServer.close.bind(appiumServer);
+    appiumServer.close = async () => await new Promise((_resolve, _reject) => {
+        logger_1.log.info('Closing Appium HTTP server');
+        const timer = new support_1.timing.Timer().start();
+        const onTimeout = setTimeout(() => {
+            if ((gracefulShutdownTimeout ?? 0) > 0) {
+                logger_1.log.info(`Not all active connections have been closed within ${gracefulShutdownTimeout}ms. ` +
+                    `This timeout might be customized by the --shutdown-timeout command line ` +
+                    `argument. Closing the server anyway.`);
+            }
+            process.exit(process.exitCode ?? 0);
+        }, gracefulShutdownTimeout ?? 0);
+        const onClose = () => {
+            logger_1.log.info(`Appium HTTP server has been successfully closed after ` +
+                `${timer.getDuration().asMilliSeconds.toFixed(0)}ms`);
+            clearTimeout(onTimeout);
+            _resolve();
+        };
+        httpServer.once('close', onClose);
+        originalClose((err) => {
+            if (err) {
+                clearTimeout(onTimeout);
+                httpServer.removeListener('close', onClose);
+                _reject(err);
+            }
+        });
+    });
+    appiumServer.once('error', (err) => {
+        if (err.code === 'EADDRNOTAVAIL') {
+            logger_1.log.error('Could not start REST http interface listener. ' + 'Requested address is not available.');
+        }
+        else {
+            logger_1.log.error('Could not start REST http interface listener. The requested ' +
+                'port may already be in use. Please make sure there is no ' +
+                'other instance of this server running already.');
+        }
+        reject(err);
+    });
+    appiumServer.on('connection', (socket) => socket.setTimeout(keepAliveTimeout));
+    return appiumServer;
+}
+async function startServer({ httpServer, port, hostname, keepAliveTimeout, requestTimeout, }) {
+    // If the hostname is omitted, the server will accept connections on any IP address
+    const startPromise = new Promise((resolve, reject) => {
+        const onError = (err) => {
+            httpServer.removeListener('listening', onListening);
+            reject(err);
+        };
+        const onListening = () => {
+            httpServer.removeListener('error', onError);
+            resolve();
+        };
+        httpServer.once('error', onError);
+        httpServer.once('listening', onListening);
+        httpServer.listen(port, hostname);
+    });
+    httpServer.keepAliveTimeout = keepAliveTimeout;
+    if (Number.isInteger(requestTimeout)) {
+        httpServer.requestTimeout = Number(requestTimeout);
+    }
+    // headers timeout must be greater than keepAliveTimeout
+    httpServer.headersTimeout = keepAliveTimeout + 5 * 1000;
+    await startPromise;
+}
+/**
+ * Checks if the server supports `shouldUpgradeCallback` (Node.js v22.21.0+ / v24.9.0+).
+ *
+ * @param server - The HTTP server instance
+ * @returns true if shouldUpgradeCallback is available
+ */
+function hasShouldUpgradeCallback(server) {
+    // Check if shouldUpgradeCallback is available on http.Server
+    // This is a runtime check that works regardless of TypeScript types
+    try {
+        return typeof server.shouldUpgradeCallback !== 'undefined';
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=server.js.map