appium-mac2-driver 4.5.1 → 4.6.1

package/node_modules/@appium/base-driver/build/lib/basedriver/core.js

@@ -0,0 +1,364 @@
+"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.DriverCore = void 0;
+const node_os_1 = __importDefault(require("node:os"));
+const support_1 = require("@appium/support");
+const async_lock_1 = __importDefault(require("async-lock"));
+const constants_1 = require("../constants");
+const protocol_1 = require("../protocol");
+const device_settings_1 = require("./device-settings");
+const extension_core_1 = require("./extension-core");
+const helpers = __importStar(require("./helpers"));
+const NEW_COMMAND_TIMEOUT_MS = 60 * 1000;
+const ON_UNEXPECTED_SHUTDOWN_EVENT = 'onUnexpectedShutdown';
+const ALL_DRIVERS_MATCH = '*';
+const FEATURE_NAME_SEPARATOR = ':';
+class DriverCore extends extension_core_1.ExtensionCore {
+    /**
+     * Make the basedriver version available so for any driver which inherits from this package, we
+     * know which version of basedriver it inherited from
+     */
+    static baseVersion = helpers.BASEDRIVER_VER;
+    sessionId;
+    sessionCreationTimestampMs;
+    opts;
+    initialOpts;
+    helpers;
+    /**
+     * basePath is used for several purposes, for example in setting up
+     * proxying to other drivers, since we need to know what the base path
+     * of any incoming request might look like. We set it to the default
+     * initially but it is automatically updated during any actual program
+     * execution by the routeConfiguringFunction, which is necessarily run as
+     * the entrypoint for any Appium server
+     */
+    basePath;
+    relaxedSecurityEnabled;
+    allowInsecure;
+    denyInsecure;
+    newCommandTimeoutMs;
+    implicitWaitMs;
+    locatorStrategies;
+    webLocatorStrategies;
+    managedDrivers;
+    noCommandTimer;
+    shutdownUnexpectedly;
+    shouldValidateCaps;
+    /**
+     * settings should be instantiated by drivers which extend BaseDriver, but
+     * we set it to an empty DeviceSettings instance here to make sure that the
+     * default settings are applied even if an extending driver doesn't utilize
+     * the settings functionality itself
+     */
+    settings;
+    protocol;
+    _eventHistory;
+    /**
+     * TODO: remove this._log and use this.log instead
+     */
+    _log;
+    commandsQueueGuard;
+    constructor(opts = {}, shouldValidateCaps = true) {
+        super();
+        this._log = this.log; // TODO: remove references to this._log and use this.log instead
+        // setup state
+        this.opts = opts;
+        // use a custom tmp dir to avoid losing data and app when computer is
+        // restarted
+        this.opts.tmpDir = this.opts.tmpDir || process.env.APPIUM_TMP_DIR || node_os_1.default.tmpdir();
+        // base-driver internals
+        this.shouldValidateCaps = shouldValidateCaps;
+        // keeping track of initial opts
+        this.initialOpts = { ...opts };
+        this.sessionId = null;
+        this.helpers = helpers;
+        this.basePath = constants_1.DEFAULT_BASE_PATH;
+        this.relaxedSecurityEnabled = false;
+        this.allowInsecure = [];
+        this.denyInsecure = [];
+        this.newCommandTimeoutMs = NEW_COMMAND_TIMEOUT_MS;
+        this.implicitWaitMs = 0;
+        this.locatorStrategies = [];
+        this.webLocatorStrategies = [];
+        this.managedDrivers = [];
+        this.noCommandTimer = null;
+        this._eventHistory = { commands: [] };
+        this.shutdownUnexpectedly = false;
+        this.commandsQueueGuard = new async_lock_1.default();
+        this.settings = new device_settings_1.DeviceSettings();
+    }
+    /**
+     * This property is used by AppiumDriver to store the data of the
+     * specific driver sessions. This data can be later used to adjust
+     * properties for driver instances running in parallel.
+     * Override it in inherited driver classes if necessary.
+     *
+     * @deprecated Use {@linkcode IAppiumIpc} for cross-session coordination instead.
+     */
+    get driverData() {
+        return {};
+    }
+    /**
+     * This property controls the way the `executeCommand` method
+     * handles new driver commands received from the client.
+     * Override it for inherited classes only in special cases.
+     *
+     * @return If the returned value is true (default) then all the commands
+     *   received by the particular driver instance are going to be put into the queue,
+     *   so each following command will not be executed until the previous command
+     *   execution is completed. False value disables that queue, so each driver command
+     *   is executed independently and does not wait for anything.
+     */
+    get isCommandsQueueEnabled() {
+        return true;
+    }
+    /*
+     * make eventHistory a property and return a cloned object so a consumer can't
+     * inadvertently change data outside of logEvent
+     */
+    get eventHistory() {
+        return structuredClone(this._eventHistory);
+    }
+    /**
+     * If this driver has requested proxying of bidi connections to an upstream bidi endpoint, this
+     * method should be overridden to return the URL of that websocket, to indicate that bidi
+     * proxying is enabled. Otherwise, a null return will indicate that bidi proxying should not be
+     * active and bidi commands will be handled by this driver.
+     *
+     * @returns {string | null}
+     */
+    get bidiProxyUrl() {
+        return null;
+    }
+    /**
+     * Set a callback handler if needed to execute a custom piece of code
+     * when the driver is shut down unexpectedly. Multiple calls to this method
+     * will cause the handler to be executed multiple times
+     *
+     * @param handler The code to be executed on unexpected shutdown.
+     * The function may accept one argument, which is the actual error instance, which
+     * caused the driver to shut down.
+     */
+    onUnexpectedShutdown(handler) {
+        this.eventEmitter.on(ON_UNEXPECTED_SHUTDOWN_EVENT, handler);
+    }
+    /**
+     * API method for driver developers to log timings for important events
+     */
+    logEvent(eventName) {
+        if (eventName === 'commands') {
+            throw new Error('Cannot log commands directly');
+        }
+        if (typeof eventName !== 'string') {
+            throw new Error(`Invalid eventName ${eventName}`);
+        }
+        if (!this._eventHistory[eventName]) {
+            this._eventHistory[eventName] = [];
+        }
+        const ts = Date.now();
+        const logTime = new Date(ts).toTimeString();
+        this._eventHistory[eventName].push(ts);
+        this.log.debug(`Event '${eventName}' logged at ${ts} (${logTime})`);
+    }
+    /**
+     * @privateRemarks Overridden in appium driver, but here so that individual drivers can be
+     * tested with clients that poll
+     */
+    async getStatus() {
+        return {};
+    }
+    /**
+     * method required by MJSONWP in order to determine whether it should
+     * respond with an invalid session response
+     */
+    sessionExists(sessionId) {
+        if (!sessionId)
+            return false; // eslint-disable-line curly
+        return sessionId === this.sessionId;
+    }
+    /**
+     * method required by MJSONWP in order to determine if the command should
+     * be proxied directly to the driver
+     */
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    driverForSession(sessionId) {
+        return this;
+    }
+    isMjsonwpProtocol() {
+        return this.protocol === constants_1.PROTOCOLS.MJSONWP;
+    }
+    isW3CProtocol() {
+        return this.protocol === constants_1.PROTOCOLS.W3C;
+    }
+    setProtocolMJSONWP() {
+        this.protocol = constants_1.PROTOCOLS.MJSONWP;
+    }
+    setProtocolW3C() {
+        this.protocol = constants_1.PROTOCOLS.W3C;
+    }
+    /**
+     * Check whether a given feature is enabled via its name
+     *
+     * @param name - name of feature/command
+     */
+    isFeatureEnabled(name) {
+        // automationName comparison is case-insensitive,
+        // while feature name is case-sensitive
+        const currentAutomationName = String(this.opts.automationName).toLowerCase();
+        const parseFullName = (fullName) => {
+            const separatorPos = fullName.indexOf(FEATURE_NAME_SEPARATOR);
+            if (separatorPos <= 0) {
+                // we do not expect this to happen as
+                // arguments are validated upon server startup,
+                // but better be safe than sorry
+                throw new Error(`The full feature name must include both the automation name ` +
+                    `'${this.opts.automationName}' or the '${ALL_DRIVERS_MATCH}' ` +
+                    `wildcard to apply the feature to all installed drivers, and ` +
+                    `the feature name split by a colon. Got '${fullName}' instead`);
+            }
+            return [fullName.substring(0, separatorPos).toLowerCase(), fullName.substring(separatorPos + 1)];
+        };
+        const parseFullNames = (fullNames) => fullNames.map(parseFullName);
+        const matches = (pair) => {
+            const [automationName, featureName] = pair;
+            return [currentAutomationName, ALL_DRIVERS_MATCH].includes(automationName) && featureName === name;
+        };
+        // if we have explicitly denied this feature, return false immediately
+        if (!support_1.util.isEmpty(this.denyInsecure) && parseFullNames(this.denyInsecure).some(matches)) {
+            return false;
+        }
+        // if we specifically have allowed the feature, return true
+        if (!support_1.util.isEmpty(this.allowInsecure) && parseFullNames(this.allowInsecure).some(matches)) {
+            return true;
+        }
+        // otherwise, if we've globally allowed insecure features and not denied
+        // this one, return true
+        if (this.relaxedSecurityEnabled) {
+            return true;
+        }
+        // if we haven't allowed anything insecure, then reject
+        return false;
+    }
+    /**
+     * Assert that a given feature is enabled and throw a helpful error if it's
+     * not
+     *
+     * @param name - name of feature/command
+     */
+    assertFeatureEnabled(name) {
+        if (!this.isFeatureEnabled(name)) {
+            throw new Error(`Potentially insecure feature '${name}' has not been ` +
+                `enabled. If you want to enable this feature and accept ` +
+                `the security ramifications, please do so by following ` +
+                `the documented instructions at http://appium.io/docs/en/latest/guides/security/`);
+        }
+    }
+    validateLocatorStrategy(strategy, webContext = false) {
+        let validStrategies = this.locatorStrategies;
+        this.log.debug(`Valid locator strategies for this request: ${validStrategies.join(', ')}`);
+        if (webContext) {
+            validStrategies = validStrategies.concat(this.webLocatorStrategies);
+        }
+        if (!validStrategies.includes(strategy)) {
+            throw new protocol_1.errors.InvalidSelectorError(`Locator Strategy '${strategy}' is not supported for this session`);
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    proxyActive(sessionId) {
+        return false;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    getProxyAvoidList(sessionId) {
+        return [];
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    canProxy(sessionId) {
+        return false;
+    }
+    /**
+     * Whether a given command route (expressed as method and url) should not be
+     * proxied according to this driver
+     *
+     * @param sessionId - the current sessionId (in case the driver runs
+     * multiple session ids and requires it). This is not used in this method but
+     * should be made available to overridden methods.
+     * @param method - HTTP method of the route
+     * @param url - url of the route
+     * @param [body] - webdriver request body
+     *
+     * @returns whether the route should be avoided
+     */
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    proxyRouteIsAvoided(sessionId, method, url, body) {
+        for (const avoidSchema of this.getProxyAvoidList(sessionId)) {
+            if (!Array.isArray(avoidSchema) || avoidSchema.length !== 2) {
+                throw new Error('Proxy avoidance must be a list of pairs');
+            }
+            const [avoidMethod, avoidPathRegex] = avoidSchema;
+            if (!['GET', 'POST', 'DELETE'].includes(avoidMethod)) {
+                throw new Error(`Unrecognized proxy avoidance method '${avoidMethod}'`);
+            }
+            if (!(avoidPathRegex instanceof RegExp)) {
+                throw new Error('Proxy avoidance path must be a regular expression');
+            }
+            const normalizedUrl = url.replace(new RegExp(`^${support_1.util.escapeRegExp(this.basePath)}`), '');
+            if (avoidMethod === method && avoidPathRegex.test(normalizedUrl)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * @param {Driver} driver
+     */
+    addManagedDriver(driver) {
+        this.managedDrivers.push(driver);
+    }
+    getManagedDrivers() {
+        return this.managedDrivers;
+    }
+    async clearNewCommandTimeout() {
+        if (this.noCommandTimer) {
+            clearTimeout(this.noCommandTimer);
+            this.noCommandTimer = null;
+        }
+    }
+}
+exports.DriverCore = DriverCore;
+//# sourceMappingURL=core.js.map

package/node_modules/@appium/base-driver/build/lib/basedriver/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../lib/basedriver/core.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,sDAAyB;AAEzB,6CAAqC;AAcrC,4DAAmC;AAEnC,4CAA0D;AAC1D,0CAAmC;AACnC,uDAAiD;AACjD,qDAA+C;AAC/C,mDAAqC;AAErC,MAAM,sBAAsB,GAAG,EAAE,GAAG,IAAI,CAAC;AAEzC,MAAM,4BAA4B,GAAG,sBAAsB,CAAC;AAE5D,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAC9B,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAEnC,MAAa,UACX,SAAQ,8BAAa;IAGrB;;;OAGG;IACH,MAAM,CAAC,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAE5C,SAAS,CAAgB;IAEzB,0BAA0B,CAAU;IAEpC,IAAI,CAAgB;IAEpB,WAAW,CAAc;IAEzB,OAAO,CAAiB;IAExB;;;;;;;OAOG;IACH,QAAQ,CAAS;IAEjB,sBAAsB,CAAU;IAEhC,aAAa,CAAW;IAExB,YAAY,CAAW;IAEvB,mBAAmB,CAAS;IAE5B,cAAc,CAAS;IAEvB,iBAAiB,CAAW;IAE5B,oBAAoB,CAAW;IAE/B,cAAc,CAAW;IAEzB,cAAc,CAAwB;IAEtC,oBAAoB,CAAU;IAE9B,kBAAkB,CAAU;IAE5B;;;;;OAKG;IACH,QAAQ,CAA2B;IAEnC,QAAQ,CAAY;IAEV,aAAa,CAAe;IAEtC;;OAEG;IACO,IAAI,CAAe;IAEnB,kBAAkB,CAAY;IAExC,YAAY,OAAiC,EAAE,EAAE,kBAAkB,GAAG,IAAI;QACxE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,gEAAgE;QAEtF,cAAc;QACd,IAAI,CAAC,IAAI,GAAG,IAAqB,CAAC;QAElC,qEAAqE;QACrE,YAAY;QACZ,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,iBAAE,CAAC,MAAM,EAAE,CAAC;QAEjF,wBAAwB;QACxB,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;QAE7C,gCAAgC;QAChC,IAAI,CAAC,WAAW,GAAG,EAAC,GAAG,IAAI,EAAC,CAAC;QAE7B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,6BAAiB,CAAC;QAClC,IAAI,CAAC,sBAAsB,GAAG,KAAK,CAAC;QACpC,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,mBAAmB,GAAG,sBAAsB,CAAC;QAClD,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;QACxB,IAAI,CAAC,iBAAiB,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,oBAAoB,GAAG,EAAE,CAAC;QAC/B,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC3B,IAAI,CAAC,aAAa,GAAG,EAAC,QAAQ,EAAE,EAAE,EAAC,CAAC;QACpC,IAAI,CAAC,oBAAoB,GAAG,KAAK,CAAC;QAClC,IAAI,CAAC,kBAAkB,GAAG,IAAI,oBAAS,EAAE,CAAC;QAC1C,IAAI,CAAC,QAAQ,GAAG,IAAI,gCAAc,EAAE,CAAC;IACvC,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,UAAU;QACZ,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,sBAAsB;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,IAAI,YAAY;QACd,OAAO,eAAe,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,YAAY;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;OAQG;IACH,oBAAoB,CAAC,OAAiC;QACpD,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,4BAA4B,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,SAAiB;QACxB,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,qBAAqB,SAAS,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;QACrC,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC;QAC5C,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,SAAS,eAAe,EAAE,KAAK,OAAO,GAAG,CAAC,CAAC;IACtE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS;QACb,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,SAAiB;QAC7B,IAAI,CAAC,SAAS;YAAE,OAAO,KAAK,CAAC,CAAC,4BAA4B;QAC1D,OAAO,SAAS,KAAK,IAAI,CAAC,SAAS,CAAC;IACtC,CAAC;IAED;;;OAGG;IACH,6DAA6D;IAC7D,gBAAgB,CAAC,SAAiB;QAChC,OAAO,IAAyB,CAAC;IACnC,CAAC;IAED,iBAAiB;QACf,OAAO,IAAI,CAAC,QAAQ,KAAK,qBAAS,CAAC,OAAO,CAAC;IAC7C,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,QAAQ,KAAK,qBAAS,CAAC,GAAG,CAAC;IACzC,CAAC;IAED,kBAAkB;QAChB,IAAI,CAAC,QAAQ,GAAG,qBAAS,CAAC,OAAO,CAAC;IACpC,CAAC;IAED,cAAc;QACZ,IAAI,CAAC,QAAQ,GAAG,qBAAS,CAAC,GAAG,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACH,gBAAgB,CAAC,IAAY;QAC3B,iDAAiD;QACjD,uCAAuC;QACvC,MAAM,qBAAqB,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,WAAW,EAAE,CAAC;QAE7E,MAAM,aAAa,GAAG,CAAC,QAAgB,EAAE,EAAE;YACzC,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;YAC9D,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;gBACtB,qCAAqC;gBACrC,+CAA+C;gBAC/C,gCAAgC;gBAChC,MAAM,IAAI,KAAK,CACb,8DAA8D;oBAC5D,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc,aAAa,iBAAiB,IAAI;oBAC9D,8DAA8D;oBAC9D,2CAA2C,QAAQ,WAAW,CACjE,CAAC;YACJ,CAAC;YACD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,SAAS,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC;QACnG,CAAC,CAAC;QACF,MAAM,cAAc,GAAG,CAAC,SAAmB,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC7E,MAAM,OAAO,GAAG,CAAC,IAAc,EAAE,EAAE;YACjC,MAAM,CAAC,cAAc,EAAE,WAAW,CAAC,GAAG,IAAI,CAAC;YAC3C,OAAO,CAAC,qBAAqB,EAAE,iBAAiB,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,WAAW,KAAK,IAAI,CAAC;QACrG,CAAC,CAAC;QAEF,sEAAsE;QACtE,IAAI,CAAC,cAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACxF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,2DAA2D;QAC3D,IAAI,CAAC,cAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1F,OAAO,IAAI,CAAC;QACd,CAAC;QAED,wEAAwE;QACxE,wBAAwB;QACxB,IAAI,IAAI,CAAC,sBAAsB,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,uDAAuD;QACvD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;OAKG;IACH,oBAAoB,CAAC,IAAY;QAC/B,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CACb,iCAAiC,IAAI,iBAAiB;gBACpD,yDAAyD;gBACzD,wDAAwD;gBACxD,iFAAiF,CACpF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,uBAAuB,CAAC,QAAgB,EAAE,UAAU,GAAG,KAAK;QAC1D,IAAI,eAAe,GAAG,IAAI,CAAC,iBAAiB,CAAC;QAC7C,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,8CAA8C,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAE3F,IAAI,UAAU,EAAE,CAAC;YACf,eAAe,GAAG,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACtE,CAAC;QAED,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,iBAAM,CAAC,oBAAoB,CAAC,qBAAqB,QAAQ,qCAAqC,CAAC,CAAC;QAC5G,CAAC;IACH,CAAC;IAED,6DAA6D;IAC7D,WAAW,CAAC,SAAiB;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,6DAA6D;IAC7D,iBAAiB,CAAC,SAAiB;QACjC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,6DAA6D;IAC7D,QAAQ,CAAC,SAAiB;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,6DAA6D;IAC7D,mBAAmB,CAAC,SAAiB,EAAE,MAAkB,EAAE,GAAW,EAAE,IAAU;QAChF,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC5D,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;YAC7D,CAAC;YACD,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,WAAW,CAAC;YAClD,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBACrD,MAAM,IAAI,KAAK,CAAC,wCAAwC,WAAW,GAAG,CAAC,CAAC;YAC1E,CAAC;YACD,IAAI,CAAC,CAAC,cAAc,YAAY,MAAM,CAAC,EAAE,CAAC;gBACxC,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;YACvE,CAAC;YACD,MAAM,aAAa,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,IAAI,cAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1F,IAAI,WAAW,KAAK,MAAM,IAAI,cAAc,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;gBACjE,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,MAAc;QAC7B,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,iBAAiB;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,sBAAsB;QAC1B,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAClC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC7B,CAAC;IACH,CAAC;;AArXH,gCAsXC"}

package/node_modules/@appium/base-driver/build/lib/basedriver/device-settings.d.ts

@@ -0,0 +1,27 @@
+import type { IDeviceSettings, SettingsUpdateListener, StringRecord } from '@appium/types';
+/**
+ * Maximum size (in bytes) of a given driver's settings object (which is internal to {@linkcode DeviceSettings}).
+ */
+export declare const MAX_SETTINGS_SIZE: number;
+/**
+ * @template T - Settings object shape (string-keyed record)
+ */
+export declare class DeviceSettings<T extends StringRecord = StringRecord> implements IDeviceSettings<T> {
+    protected _settings: T;
+    protected _onSettingsUpdate: SettingsUpdateListener<T>;
+    /**
+     * Creates a _shallow copy_ of the `defaultSettings` parameter!
+     *
+     * @param defaultSettings - Initial settings (shallow-copied).
+     * @param onSettingsUpdate - Called when a setting is changed; receives (prop, newValue, curValue).
+     */
+    constructor(defaultSettings?: T, onSettingsUpdate?: SettingsUpdateListener<T>);
+    /**
+     * Calls updateSettings from implementing driver every time a setting is changed.
+     *
+     * @param newSettings - New settings to merge (must be plain object; total size remains bounded).
+     */
+    update(newSettings: T): Promise<void>;
+    getSettings(): T;
+}
+//# sourceMappingURL=device-settings.d.ts.map

package/node_modules/@appium/base-driver/build/lib/basedriver/device-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-settings.d.ts","sourceRoot":"","sources":["../../../lib/basedriver/device-settings.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,eAAe,EAAE,sBAAsB,EAAE,YAAY,EAAC,MAAM,eAAe,CAAC;AAKzF;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAmB,CAAC;AAElD;;GAEG;AACH,qBAAa,cAAc,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,CAAE,YAAW,eAAe,CAAC,CAAC,CAAC;IAC9F,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC;IACvB,SAAS,CAAC,iBAAiB,EAAE,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAEvD;;;;;OAKG;gBACS,eAAe,GAAE,CAAW,EAAE,gBAAgB,GAAE,sBAAsB,CAAC,CAAC,CAAkB;IAKtG;;;;OAIG;IACG,MAAM,CAAC,WAAW,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B3C,WAAW,IAAI,CAAC;CAGjB"}

package/node_modules/@appium/base-driver/build/lib/basedriver/device-settings.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeviceSettings = exports.MAX_SETTINGS_SIZE = void 0;
+const support_1 = require("@appium/support");
+const errors_1 = require("../protocol/errors");
+const logger_1 = require("./logger");
+/**
+ * Maximum size (in bytes) of a given driver's settings object (which is internal to {@linkcode DeviceSettings}).
+ */
+exports.MAX_SETTINGS_SIZE = 20 * 1024 * 1024; // 20 MB
+/**
+ * @template T - Settings object shape (string-keyed record)
+ */
+class DeviceSettings {
+    _settings;
+    _onSettingsUpdate;
+    /**
+     * Creates a _shallow copy_ of the `defaultSettings` parameter!
+     *
+     * @param defaultSettings - Initial settings (shallow-copied).
+     * @param onSettingsUpdate - Called when a setting is changed; receives (prop, newValue, curValue).
+     */
+    constructor(defaultSettings = {}, onSettingsUpdate = async () => { }) {
+        this._settings = { ...defaultSettings };
+        this._onSettingsUpdate = onSettingsUpdate;
+    }
+    /**
+     * Calls updateSettings from implementing driver every time a setting is changed.
+     *
+     * @param newSettings - New settings to merge (must be plain object; total size remains bounded).
+     */
+    async update(newSettings) {
+        if (!support_1.util.isPlainObject(newSettings)) {
+            throw new errors_1.errors.InvalidArgumentError(`Settings update should be called with valid JSON. Got ` + `${JSON.stringify(newSettings)} instead`);
+        }
+        if (support_1.node.getObjectSize({ ...this._settings, ...newSettings }) >= exports.MAX_SETTINGS_SIZE) {
+            throw new errors_1.errors.InvalidArgumentError(`New settings cannot be applied, because the overall ` +
+                `object size exceeds the allowed limit of ${support_1.util.toReadableSizeString(exports.MAX_SETTINGS_SIZE)}`);
+        }
+        for (const prop in newSettings) {
+            if (this._settings[prop] !== undefined) {
+                if (this._settings[prop] === newSettings[prop]) {
+                    logger_1.log.debug(`The value of '${prop}' setting did not change. Skipping the update for it`);
+                    continue;
+                }
+            }
+            await this._onSettingsUpdate(prop, newSettings[prop], this._settings[prop]);
+            this._settings[prop] = newSettings[prop];
+        }
+    }
+    getSettings() {
+        return this._settings;
+    }
+}
+exports.DeviceSettings = DeviceSettings;
+//# sourceMappingURL=device-settings.js.map

package/node_modules/@appium/base-driver/build/lib/basedriver/device-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-settings.js","sourceRoot":"","sources":["../../../lib/basedriver/device-settings.ts"],"names":[],"mappings":";;;AAAA,6CAA2C;AAG3C,+CAA0C;AAC1C,qCAA6B;AAE7B;;GAEG;AACU,QAAA,iBAAiB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,QAAQ;AAE3D;;GAEG;AACH,MAAa,cAAc;IACf,SAAS,CAAI;IACb,iBAAiB,CAA4B;IAEvD;;;;;OAKG;IACH,YAAY,kBAAqB,EAAO,EAAE,mBAA8C,KAAK,IAAI,EAAE,GAAE,CAAC;QACpG,IAAI,CAAC,SAAS,GAAG,EAAC,GAAG,eAAe,EAAC,CAAC;QACtC,IAAI,CAAC,iBAAiB,GAAG,gBAAgB,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,WAAc;QACzB,IAAI,CAAC,cAAI,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,eAAM,CAAC,oBAAoB,CACnC,wDAAwD,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,UAAU,CACpG,CAAC;QACJ,CAAC;QAED,IAAI,cAAI,CAAC,aAAa,CAAC,EAAC,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,WAAW,EAAC,CAAC,IAAI,yBAAiB,EAAE,CAAC;YACjF,MAAM,IAAI,eAAM,CAAC,oBAAoB,CACnC,sDAAsD;gBACpD,4CAA4C,cAAI,CAAC,oBAAoB,CAAC,yBAAiB,CAAC,EAAE,CAC7F,CAAC;QACJ,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;gBACvC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC/C,YAAG,CAAC,KAAK,CAAC,iBAAiB,IAAI,sDAAsD,CAAC,CAAC;oBACvF,SAAS;gBACX,CAAC;YACH,CAAC;YACD,MAAM,IAAI,CAAC,iBAAiB,CAAC,IAAe,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YACvF,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;CACF;AAjDD,wCAiDC"}

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

@@ -0,0 +1,68 @@
+import { type AppiumServer, type BaseDriverCapConstraints, type Capabilities, type Constraints, type DefaultCreateSessionResult, type DefaultDeleteSessionResult, type Driver, type DriverCaps, type InitialOpts, type LegacyCreateSessionArgs, type ServerArgs, type SessionCapabilities, type SingularSessionData, type StringRecord, type W3CDriverCaps } from '@appium/types';
+import { DriverCore } from './core';
+export declare class BaseDriver<const C extends Constraints, CArgs extends StringRecord = StringRecord, Settings extends StringRecord = StringRecord, CreateResult = DefaultCreateSessionResult<C>, DeleteResult = DefaultDeleteSessionResult, SessionData extends StringRecord = StringRecord> extends DriverCore<C, Settings> implements Driver<C, CArgs, Settings, CreateResult, DeleteResult, SessionData> {
+    cliArgs: CArgs & ServerArgs;
+    caps: DriverCaps<C>;
+    originalCaps: W3CDriverCaps<C>;
+    desiredCapConstraints: C;
+    server?: AppiumServer;
+    serverHost?: string;
+    serverPort?: number;
+    serverPath?: string;
+    constructor(opts: InitialOpts, shouldValidateCaps?: boolean);
+    /**
+     * Contains the base constraints plus whatever the subclass wants to add.
+     *
+     * Subclasses _shouldn't_ need to use this. If you need to use this, please create
+     * an issue:
+     * @see {@link https://github.com/appium/appium/issues/new}
+     */
+    protected get _desiredCapConstraints(): Readonly<BaseDriverCapConstraints & C>;
+    /**
+     * This is the main command handler for the driver. It wraps command
+     * execution with timeout logic, checking that we have a valid session,
+     * and ensuring that we execute commands one at a time. This method is called
+     * by MJSONWP's express router.
+     */
+    executeCommand<T = unknown>(cmd: string, ...args: any[]): Promise<T>;
+    clarifyCommandName(cmd: string, args: string[]): string;
+    startUnexpectedShutdown(err?: Error): Promise<void>;
+    startNewCommandTimeout(): Promise<void>;
+    assignServer(server: AppiumServer, host: string, port: number, path: string): void;
+    reset(): Promise<void>;
+    /**
+     * Start a new automation session.
+     *
+     * @param w3cCapabilities - the new session capabilities in W3C format
+     */
+    createSession(w3cCapabilities: W3CDriverCaps<C>): Promise<CreateResult>;
+    /**
+     * @deprecated Historically the first three arguments were reserved for JSONWP capabilities.
+     * Appium 2 dropped support for that protocol; these positions are now intended to carry the
+     * same W3C capabilities value, and if they differ, which one wins is unspecified. Use the
+     * single-argument overload of {@linkcode createSession} instead. The `driverData` parameter is
+     * also deprecated; use {@linkcode IAppiumIpc} for cross-session coordination instead.
+     */
+    createSession(...legacyArgs: LegacyCreateSessionArgs<C>): Promise<CreateResult>;
+    /**
+     * Returns capabilities for the session and event history (if applicable)
+     * @deprecated Use {@linkcode getAppiumSessionCapabilities} instead for getting the capabilities.
+     * Use {@linkcode EventCommands.getLogEvents} instead to get the event history.
+     */
+    getSession(): Promise<SingularSessionData<C, SessionData>>;
+    /**
+     * Returns capabilities for the session
+     */
+    getAppiumSessionCapabilities(): Promise<SessionCapabilities<C>>;
+    /**
+     * Stop the current automation session.
+     */
+    deleteSession(sessionId?: string | null): Promise<void>;
+    logExtraCaps(caps: Capabilities<C>): void;
+    validateDesiredCaps(caps: any): caps is DriverCaps<C>;
+    updateSettings(newSettings: Settings): Promise<void>;
+    getSettings(): Promise<Settings>;
+}
+export * from './commands';
+export default BaseDriver;
+//# sourceMappingURL=driver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../../lib/basedriver/driver.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,YAAY,EAEjB,KAAK,wBAAwB,EAC7B,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAC/B,KAAK,MAAM,EACX,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,uBAAuB,EAC5B,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,eAAe,CAAC;AAWvB,OAAO,EAAC,UAAU,EAAC,MAAM,QAAQ,CAAC;AAWlC,qBAAa,UAAU,CACrB,KAAK,CAAC,CAAC,SAAS,WAAW,EAC3B,KAAK,SAAS,YAAY,GAAG,YAAY,EACzC,QAAQ,SAAS,YAAY,GAAG,YAAY,EAC5C,YAAY,GAAG,0BAA0B,CAAC,CAAC,CAAC,EAC5C,YAAY,GAAG,0BAA0B,EACzC,WAAW,SAAS,YAAY,GAAG,YAAY,CAE/C,SAAQ,UAAU,CAAC,CAAC,EAAE,QAAQ,CAC9B,YAAW,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,CAAC;IAE9E,OAAO,EAAE,KAAK,GAAG,UAAU,CAAC;IAC5B,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACpB,YAAY,EAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAChC,qBAAqB,EAAG,CAAC,CAAC;IAC1B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAER,IAAI,EAAE,WAAW,EAAE,kBAAkB,UAAO;IAOxD;;;;;;OAMG;IACH,SAAS,KAAK,sBAAsB,IAAI,QAAQ,CAAC,wBAAwB,GAAG,CAAC,CAAC,CAI7E;IAED;;;;;OAKG;IACG,cAAc,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IAuG1E,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM;IAWjD,uBAAuB,CAAC,GAAG,GAAE,KAA8E;IAY3G,sBAAsB;IAkB5B,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAWrE,KAAK;IAyBX;;;;OAIG;IACG,aAAa,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IAC7E;;;;;;OAMG;IACG,aAAa,CAAC,GAAG,UAAU,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IAkFrF;;;;OAIG;IACG,UAAU;IAOhB;;OAEG;IACG,4BAA4B,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAIrE;;OAEG;IAEG,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAc7C,YAAY,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC;IAalC,mBAAmB,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,IAAI,UAAU,CAAC,CAAC,CAAC;IAsB/C,cAAc,CAAC,WAAW,EAAE,QAAQ;IAOpC,WAAW;CAMlB;AAED,cAAc,YAAY,CAAC;AAE3B,eAAe,UAAU,CAAC"}