appium-mac2-driver 4.5.1 → 4.6.1

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

@@ -0,0 +1,378 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseDriver = void 0;
+const support_1 = require("@appium/support");
+const types_1 = require("@appium/types");
+const capabilities_1 = require("../helpers/capabilities");
+const extension_command_name_1 = require("../helpers/extension-command-name");
+const levenshtein_match_1 = require("../helpers/levenshtein-match");
+const session_1 = require("../helpers/session");
+const protocol_1 = require("../protocol");
+const utils_1 = require("../utils");
+const capabilities_2 = require("./capabilities");
+const bidi_subscriptions_1 = require("./commands/bidi-subscriptions");
+const core_1 = require("./core");
+const helpers = __importStar(require("./helpers"));
+const EVENT_SESSION_INIT = 'newSessionRequested';
+const EVENT_SESSION_START = 'newSessionStarted';
+const EVENT_SESSION_QUIT_START = 'quitSessionRequested';
+const EVENT_SESSION_QUIT_DONE = 'quitSessionFinished';
+const ON_UNEXPECTED_SHUTDOWN_EVENT = 'onUnexpectedShutdown';
+class BaseDriver extends core_1.DriverCore {
+    cliArgs;
+    caps;
+    originalCaps;
+    desiredCapConstraints;
+    server;
+    serverHost;
+    serverPort;
+    serverPath;
+    constructor(opts, shouldValidateCaps = true) {
+        super(opts, shouldValidateCaps);
+        this.caps = {};
+        this.cliArgs = {};
+    }
+    /**
+     * 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}
+     */
+    get _desiredCapConstraints() {
+        return Object.freeze((0, utils_1.mergePlainObjects)({}, types_1.BASE_DESIRED_CAP_CONSTRAINTS, this.desiredCapConstraints));
+    }
+    /**
+     * 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.
+     */
+    async executeCommand(cmd, ...args) {
+        // get start time for this command, and log in special cases
+        const startTime = Date.now();
+        if (cmd === 'createSession') {
+            // If creating a session determine if W3C or MJSONWP protocol was requested and remember the choice
+            this.protocol = (0, protocol_1.determineProtocol)(args);
+            this.logEvent(EVENT_SESSION_INIT);
+        }
+        else if (cmd === protocol_1.DELETE_SESSION_COMMAND) {
+            this.logEvent(EVENT_SESSION_QUIT_START);
+        }
+        // if we had a command timer running, clear it now that we're starting
+        // a new command and so don't want to time out
+        await this.clearNewCommandTimeout();
+        if (this.shutdownUnexpectedly) {
+            throw new protocol_1.errors.NoSuchDriverError('The driver was unexpectedly shut down!');
+        }
+        const invoker = this;
+        const command = invoker[cmd];
+        // If we don't have this command, it must not be implemented
+        if (!command) {
+            await this.startNewCommandTimeout();
+            throw new protocol_1.errors.NotYetImplementedError();
+        }
+        const runCommandPromise = async () => {
+            let unexpectedShutdownRejecter = null;
+            let unexpectedShutdownResolver = null;
+            let wasSessionShutdownUnexpectedly = false;
+            const onUnexpectedShutdown = (e) => {
+                wasSessionShutdownUnexpectedly = true;
+                unexpectedShutdownRejecter?.(e);
+            };
+            try {
+                return await Promise.race([
+                    command.call(this, ...args),
+                    // This promise is needed to monitor if the session has been
+                    // shut down unexpectedly while the command was running
+                    new Promise((resolve, reject) => {
+                        unexpectedShutdownResolver = resolve;
+                        unexpectedShutdownRejecter = reject;
+                        this.eventEmitter.once(ON_UNEXPECTED_SHUTDOWN_EVENT, onUnexpectedShutdown);
+                    }),
+                ]);
+            }
+            finally {
+                if (unexpectedShutdownRejecter && unexpectedShutdownResolver) {
+                    // This is needed to prevent memory leaks
+                    this.eventEmitter.removeListener(ON_UNEXPECTED_SHUTDOWN_EVENT, onUnexpectedShutdown);
+                    unexpectedShutdownRejecter = null;
+                    // @ts-ignore typescript cannot understand this
+                    unexpectedShutdownResolver?.();
+                }
+                // if we have set a new command timeout (which is the default), start a
+                // timer once we've finished executing this command. If we don't clear
+                // the timer (which is done when a new command comes in), we will trigger
+                // automatic session deletion in this.onCommandTimeout. Of course we don't
+                // want to trigger the timer when the user is shutting down the session
+                // intentionally
+                if (!wasSessionShutdownUnexpectedly && this.isCommandsQueueEnabled && cmd !== protocol_1.DELETE_SESSION_COMMAND) {
+                    // resetting existing timeout
+                    await this.startNewCommandTimeout();
+                }
+            }
+        };
+        const synchronizationKey = BaseDriver.name;
+        const commandsQueueGuard = this.commandsQueueGuard;
+        const commandsQueueLen = commandsQueueGuard.queues?.[synchronizationKey]?.length ?? 0;
+        if (this.isCommandsQueueEnabled && commandsQueueLen > 0) {
+            this.log.debug(`Scheduling the '${cmd}' command to the ${this.constructor.name} commands queue. ` +
+                `${support_1.util.pluralize('queue item', commandsQueueLen, true)} ${commandsQueueLen === 1 ? 'is' : 'are'} ` +
+                `already waiting for execution.`);
+        }
+        const res = this.isCommandsQueueEnabled
+            ? await this.commandsQueueGuard.acquire(synchronizationKey, runCommandPromise)
+            : await runCommandPromise();
+        // log timing information about this command
+        const endTime = Date.now();
+        if (this.clarifyCommandName) {
+            cmd = this.clarifyCommandName(cmd, args);
+        }
+        this._eventHistory.commands.push({ cmd, startTime, endTime });
+        if (cmd === 'createSession') {
+            this.logEvent(EVENT_SESSION_START);
+        }
+        else if (cmd === protocol_1.DELETE_SESSION_COMMAND) {
+            this.logEvent(EVENT_SESSION_QUIT_DONE);
+        }
+        return res;
+    }
+    clarifyCommandName(cmd, args) {
+        if (cmd === 'execute') {
+            const firstArg = args?.[0];
+            if (typeof firstArg === 'string' && firstArg.trim().length > 0) {
+                return extension_command_name_1.resolveExecuteExtensionName.call(this, firstArg);
+            }
+        }
+        return cmd;
+    }
+    async startUnexpectedShutdown(err = new protocol_1.errors.NoSuchDriverError('The driver was unexpectedly shut down!')) {
+        this.eventEmitter.emit(ON_UNEXPECTED_SHUTDOWN_EVENT, err); // allow others to listen for this
+        this.shutdownUnexpectedly = true;
+        try {
+            if (this.sessionId !== null) {
+                await this.deleteSession(this.sessionId);
+            }
+        }
+        finally {
+            this.shutdownUnexpectedly = false;
+        }
+    }
+    async startNewCommandTimeout() {
+        // make sure there are no rogue timeouts
+        await this.clearNewCommandTimeout();
+        // if command timeout is 0, it is disabled
+        if (!this.newCommandTimeoutMs)
+            return; // eslint-disable-line curly
+        this.noCommandTimer = setTimeout(async () => {
+            this.log.warn(`Shutting down because we waited ` + `${this.newCommandTimeoutMs / 1000.0} seconds for a command`);
+            const errorMessage = `New Command Timeout of ` +
+                `${this.newCommandTimeoutMs / 1000.0} seconds ` +
+                `expired. Try customizing the timeout using the ` +
+                `'newCommandTimeout' desired capability`;
+            await this.startUnexpectedShutdown(new Error(errorMessage));
+        }, this.newCommandTimeoutMs);
+    }
+    assignServer(server, host, port, path) {
+        this.server = server;
+        this.serverHost = host;
+        this.serverPort = port;
+        this.serverPath = path;
+    }
+    /*
+     * Restart the session with the original caps,
+     * preserving the timeout config.
+     */
+    async reset() {
+        this.log.debug('Resetting app mid-session');
+        this.log.debug('Running generic full reset');
+        // preserving state
+        const currentConfig = {
+            implicitWaitMs: this.implicitWaitMs,
+            newCommandTimeoutMs: this.newCommandTimeoutMs,
+            sessionId: this.sessionId,
+            shutdownUnexpectedly: this.shutdownUnexpectedly,
+        };
+        try {
+            if (this.sessionId !== null) {
+                await this.deleteSession(this.sessionId);
+            }
+            this.log.debug('Restarting app');
+            await this.createSession(this.originalCaps);
+        }
+        finally {
+            // always restore state.
+            Object.assign(this, currentConfig);
+        }
+        await this.clearNewCommandTimeout();
+    }
+    async createSession(...legacyArgs) {
+        const [w3cCapabilities1, w3cCapabilities2, w3cCapabilities] = legacyArgs;
+        if (this.sessionId !== null) {
+            throw new protocol_1.errors.SessionNotCreatedError('Cannot create a new session while one is in progress');
+        }
+        this.log.debug();
+        const originalCaps = structuredClone([w3cCapabilities, w3cCapabilities1, w3cCapabilities2].find(capabilities_1.isW3cCaps));
+        if (!originalCaps) {
+            throw new protocol_1.errors.SessionNotCreatedError('Appium only supports W3C-style capability objects. ' +
+                'Your client is sending an older capabilities format. Please update your client library.');
+        }
+        this.setProtocolW3C();
+        this.originalCaps = originalCaps;
+        this.log.debug('Creating session with W3C capabilities: %s', support_1.logger.markSensitive(JSON.stringify(originalCaps, null, 2)));
+        let caps;
+        try {
+            caps = (0, capabilities_2.processCapabilities)(originalCaps, this._desiredCapConstraints, this.shouldValidateCaps);
+            caps = (0, capabilities_1.fixCaps)(caps, this._desiredCapConstraints, this.log);
+        }
+        catch (e) {
+            const message = e instanceof Error ? e.message : String(e);
+            throw new protocol_1.errors.SessionNotCreatedError(message);
+        }
+        this.validateDesiredCaps(caps);
+        this.sessionId = support_1.util.uuidV4();
+        this.sessionCreationTimestampMs = Date.now();
+        this.caps = caps;
+        // merge caps onto opts so we don't need to worry about what's where
+        this.opts = { ...this.initialOpts, ...this.caps };
+        // deal with resets
+        // some people like to do weird things by setting noReset and fullReset
+        // both to true, but this is misguided and strange, so error here instead
+        if (this.opts.noReset && this.opts.fullReset) {
+            throw new Error("The 'noReset' and 'fullReset' capabilities are mutually " +
+                'exclusive and should not both be set to true. You ' +
+                "probably meant to just use 'fullReset' on its own");
+        }
+        if (this.opts.noReset === true) {
+            this.opts.fullReset = false;
+        }
+        if (this.opts.fullReset === true) {
+            this.opts.noReset = false;
+        }
+        this.opts.fastReset = !this.opts.fullReset && !this.opts.noReset;
+        this.opts.skipUninstall = this.opts.fastReset || this.opts.noReset;
+        // Prevents empty string caps so we don't need to test it everywhere
+        if (typeof this.opts.app === 'string' && this.opts.app.trim() === '') {
+            delete this.opts.app;
+        }
+        if (this.caps.newCommandTimeout !== undefined) {
+            this.newCommandTimeoutMs = this.caps.newCommandTimeout * 1000;
+        }
+        this._log.prefix = helpers.generateDriverLogPrefix(this);
+        this.log.updateAsyncContext({
+            sessionId: this.sessionId,
+            sessionSignature: (0, session_1.calcSignature)(this.sessionId),
+        });
+        this.log.info(`Session created with session id: ${this.sessionId}`);
+        return [this.sessionId, caps];
+    }
+    /**
+     * 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.
+     */
+    async getSession() {
+        return (this.caps.eventTimings ? { ...this.caps, events: this.eventHistory } : this.caps);
+    }
+    /**
+     * Returns capabilities for the session
+     */
+    async getAppiumSessionCapabilities() {
+        return { capabilities: this.caps };
+    }
+    /**
+     * Stop the current automation session.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    async deleteSession(sessionId) {
+        await this.clearNewCommandTimeout();
+        if (this.isCommandsQueueEnabled && this.commandsQueueGuard.isBusy()) {
+            // simple hack to release pending commands if they exist
+            // @ts-expect-error private API
+            const queues = this.commandsQueueGuard.queues;
+            for (const key of Object.keys(queues)) {
+                queues[key] = [];
+            }
+        }
+        this.sessionId = null;
+        (0, bidi_subscriptions_1.clearBidiSubscriptions)(this);
+    }
+    logExtraCaps(caps) {
+        const knownCaps = Object.keys(this._desiredCapConstraints);
+        const knownCapsSet = new Set(knownCaps);
+        const extraCaps = Object.keys(caps).filter((cap) => !knownCapsSet.has(cap));
+        if (extraCaps.length) {
+            this.log.warn(`The following provided capabilities were not recognized by this driver:`);
+            for (const cap of extraCaps) {
+                const suggestion = (0, levenshtein_match_1.getLevenshteinSuggestion)(cap, knownCaps);
+                this.log.warn(suggestion ? `  ${cap} (did you mean '${suggestion}'?)` : `  ${cap}`);
+            }
+        }
+    }
+    validateDesiredCaps(caps) {
+        if (!this.shouldValidateCaps) {
+            return true;
+        }
+        try {
+            (0, capabilities_2.validateCaps)(caps, this._desiredCapConstraints);
+        }
+        catch (e) {
+            const capError = e instanceof Error ? e : new Error(String(e));
+            throw this.log.errorWithException(new protocol_1.errors.SessionNotCreatedError(`Session capabilities were not valid for the ` + `following reason(s): ${capError.message}`, capError));
+        }
+        this.logExtraCaps(caps);
+        return true;
+    }
+    async updateSettings(newSettings) {
+        if (!this.settings) {
+            throw this.log.errorWithException('Cannot update settings; settings object not found');
+        }
+        return await this.settings.update(newSettings);
+    }
+    async getSettings() {
+        if (!this.settings) {
+            throw this.log.errorWithException('Cannot get settings; settings object not found');
+        }
+        return this.settings.getSettings();
+    }
+}
+exports.BaseDriver = BaseDriver;
+__exportStar(require("./commands"), exports);
+exports.default = BaseDriver;
+//# sourceMappingURL=driver.js.map

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

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

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

@@ -0,0 +1,19 @@
+import type { AppiumLogger, BidiModuleMap, BiDiResultData, IIpcSubscription, IpcData, StringRecord } from '@appium/types';
+export declare class ExtensionCore {
+    bidiEventSubs: Record<string, string[]>;
+    bidiCommands: BidiModuleMap;
+    _logPrefix?: string;
+    readonly eventEmitter: NodeJS.EventEmitter;
+    protected _log: AppiumLogger;
+    private ipc?;
+    constructor(logPrefix?: string);
+    get log(): AppiumLogger;
+    updateLogPrefix(logPrefix: string): void;
+    updateBidiCommands(cmds: BidiModuleMap): void;
+    doesBidiCommandExist(moduleName: string, methodName: string): boolean;
+    ensureBidiCommandExists(moduleName: string, methodName: string): void;
+    executeBidiCommand(bidiCmd: string, bidiParams: StringRecord, next?: () => Promise<any>, driver?: ExtensionCore): Promise<BiDiResultData>;
+    onIpcInit(): Promise<void>;
+    ipcSubscribe<T extends IpcData>(topic: string): IIpcSubscription<T>;
+}
+//# sourceMappingURL=extension-core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension-core.d.ts","sourceRoot":"","sources":["../../../lib/basedriver/extension-core.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EAEd,gBAAgB,EAChB,OAAO,EACP,YAAY,EACb,MAAM,eAAe,CAAC;AAOvB,qBAAa,aAAa;IACxB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACxC,YAAY,EAAE,aAAa,CAAkC;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,YAAY,CAAC;IAC3C,SAAS,CAAC,IAAI,EAAG,YAAY,CAAC;IAC9B,OAAO,CAAC,GAAG,CAAC,CAAa;gBAEb,SAAS,CAAC,EAAE,MAAM;IAM9B,IAAI,GAAG,IAAI,YAAY,CAKtB;IAED,eAAe,CAAC,SAAS,EAAE,MAAM;IAIjC,kBAAkB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAW7C,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IASrE,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IA4B/D,kBAAkB,CACtB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,YAAY,EACxB,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,EACzB,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,cAAc,CAAC;IAuDpB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC,YAAY,CAAC,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC;CAUpE"}

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

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExtensionCore = void 0;
+const node_events_1 = require("node:events");
+const support_1 = require("@appium/support");
+const constants_1 = require("../constants");
+const protocol_1 = require("../protocol");
+const bidi_commands_1 = require("../protocol/bidi-commands");
+const helpers_1 = require("./helpers");
+class ExtensionCore {
+    bidiEventSubs;
+    bidiCommands = bidi_commands_1.BIDI_COMMANDS;
+    _logPrefix;
+    // used to handle driver events
+    eventEmitter;
+    _log;
+    ipc;
+    constructor(logPrefix) {
+        this._logPrefix = logPrefix;
+        this.bidiEventSubs = {};
+        this.eventEmitter = new node_events_1.EventEmitter();
+    }
+    get log() {
+        if (!this._log) {
+            this.updateLogPrefix(this._logPrefix ?? (0, helpers_1.generateDriverLogPrefix)(this));
+        }
+        return this._log;
+    }
+    updateLogPrefix(logPrefix) {
+        this._log = support_1.logger.getLogger(logPrefix);
+    }
+    updateBidiCommands(cmds) {
+        const overlappingKeys = Object.keys(cmds).filter((key) => key in this.bidiCommands);
+        if (overlappingKeys.length) {
+            this.log.warn(`Overwriting existing bidi modules: ${JSON.stringify(overlappingKeys)}. This may not be intended!`);
+        }
+        this.bidiCommands = {
+            ...this.bidiCommands,
+            ...cmds,
+        };
+    }
+    doesBidiCommandExist(moduleName, methodName) {
+        try {
+            this.ensureBidiCommandExists(moduleName, methodName);
+        }
+        catch {
+            return false;
+        }
+        return true;
+    }
+    ensureBidiCommandExists(moduleName, methodName) {
+        // if we don't get a valid format for bidi command name, reject
+        if (!moduleName || !methodName) {
+            throw new protocol_1.errors.UnknownCommandError(`Did not receive a valid BiDi module and method name ` +
+                `of the form moduleName.methodName. Instead received ` +
+                `'${moduleName}.${methodName}'`);
+        }
+        // if the command module or method isn't part of our spec, reject
+        if (!this.bidiCommands[moduleName]?.[methodName]) {
+            throw new protocol_1.errors.UnknownCommandError();
+        }
+        const { command } = this.bidiCommands[moduleName][methodName];
+        // if the command method isn't part of our spec, also reject
+        if (!command) {
+            throw new protocol_1.errors.UnknownCommandError();
+        }
+        // If the driver doesn't have this command, it must not be implemented
+        const handler = this[command];
+        if (typeof handler !== 'function') {
+            throw new protocol_1.errors.NotYetImplementedError();
+        }
+    }
+    async executeBidiCommand(bidiCmd, bidiParams, next, driver) {
+        const handlerType = next && driver ? 'plugin' : 'driver';
+        const [moduleName, methodName] = bidiCmd.split('.');
+        this.ensureBidiCommandExists(moduleName, methodName);
+        const { command, params } = this.bidiCommands[moduleName][methodName];
+        // TODO improve param parsing and error messages along the lines of what we have in the http
+        // handlers
+        const args = [];
+        if (params?.required?.length) {
+            for (const requiredParam of params.required) {
+                if (bidiParams[requiredParam] === undefined) {
+                    throw new protocol_1.errors.InvalidArgumentError(`The ${requiredParam} parameter was required but you omitted it`);
+                }
+                args.push(bidiParams[requiredParam]);
+            }
+        }
+        if (params?.optional?.length) {
+            for (const optionalParam of params.optional) {
+                args.push(bidiParams[optionalParam]);
+            }
+        }
+        const logParams = support_1.util.truncateString(JSON.stringify(bidiParams), {
+            length: constants_1.MAX_LOG_BODY_LENGTH,
+        });
+        this.log.debug(`Executing bidi command '${bidiCmd}' with params ${logParams} by passing to ${handlerType} ` +
+            `method '${command}'`);
+        // call the handler with the signature appropriate to extension type (plugin or driver)
+        const commandHandler = this[command];
+        const response = next && driver
+            ? await commandHandler.call(this, next, driver, ...args)
+            : await commandHandler.call(this, ...args);
+        const finalResponse = response === undefined ? {} : response;
+        this.log.debug(`Responding to bidi command '${bidiCmd}' with ` +
+            `${support_1.util.truncateString(JSON.stringify(finalResponse), { length: constants_1.MAX_LOG_BODY_LENGTH })}`);
+        return finalResponse;
+    }
+    /**
+     * @internal Used by AppiumDriver to wire session IPC; extension authors should use {@link onIpcInit} instead.
+     */
+    async assignIpc(ipc) {
+        this.ipc = ipc;
+        try {
+            await this.onIpcInit();
+        }
+        catch (e) {
+            this.log.error(`Error running onIpcInit: `, e);
+        }
+    }
+    async onIpcInit() { }
+    ipcSubscribe(topic) {
+        if (!this.ipc) {
+            throw new Error(`Cannot subscribe to an IPC topic without an IPC object assigned. ` +
+                `This is likely a programming error. ipcSubscribe should be called in the ` +
+                `onIpcInit handler or after you are certain that createSession has completed successfully.`);
+        }
+        return this.ipc.subscribe(topic, (0, helpers_1.generateDriverLogPrefix)(this));
+    }
+}
+exports.ExtensionCore = ExtensionCore;
+//# sourceMappingURL=extension-core.js.map

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

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

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

@@ -0,0 +1,59 @@
+import type { ConfigureAppOptions } from '@appium/types';
+export declare const BASEDRIVER_VER: string;
+/**
+ * Performs initial application package configuration so the app is ready for driver use.
+ * Resolves local paths, downloads remote apps (http/https) with optional caching, and
+ * runs optional post-process or custom download hooks.
+ *
+ * @param app - Path to a local app or URL of a downloadable app (http/https).
+ * @param options - Supported extensions and optional hooks. Either a single extension
+ * string, an array of extension strings, or {@link ConfigureAppOptions} (e.g.
+ * `supportedExtensions`, `onPostProcess`, `onDownload`).
+ * @returns Resolved path to the application (local path or path to downloaded/cached app).
+ * @throws {Error} If supported extensions are missing, the app path/URL is invalid, or download fails.
+ */
+export declare function configureApp(app: string, options?: string | string[] | ConfigureAppOptions): Promise<string>;
+/**
+ * Returns whether the given string looks like a package or bundle identifier
+ * (e.g. `com.example.app` or `org.company.AnotherApp`).
+ *
+ * @param app - Value to check (e.g. app path or bundle id).
+ * @returns `true` if the value matches a dot-separated identifier pattern.
+ */
+export declare function isPackageOrBundle(app: string): boolean;
+/**
+ * Recursively ensures both keys exist with the same value in objects and arrays.
+ * For each object, if `firstKey` exists its value is also set at `secondKey`, and vice versa.
+ *
+ * @param input - Object, array, or primitive to process (arrays/objects traversed recursively).
+ * @param firstKey - First key name to mirror.
+ * @param secondKey - Second key name to mirror.
+ * @returns A deep copy of `input` with both keys present where objects had either key.
+ */
+export declare function duplicateKeys<T>(input: T, firstKey: string, secondKey: string): T;
+/**
+ * Normalizes a capability value to a string array. If already an array, returns it;
+ * if a string, parses as JSON array when possible, otherwise returns a single-element array.
+ *
+ * @param capValue - Capability value: string (including JSON array like `"[\"a\",\"b\"]"`) or string[].
+ * @returns Array of strings.
+ * @throws {TypeError} If value is not a string/array or JSON parsing fails for array-like input.
+ */
+export declare function parseCapsArray(capValue: string | string[]): string[];
+/**
+ * Builds a short log prefix for a driver instance (e.g. `UiAutomator2@a1b2`).
+ *
+ * @param obj - Driver or other object; its constructor name and a short id are used.
+ * @param _sessionId - Deprecated and unused; kept for {@link DriverHelpers} interface compatibility.
+ * @returns Prefix string like `DriverName@xxxx`, or `UnknownDriver@????` if `obj` is null.
+ */
+export declare function generateDriverLogPrefix(obj: object | null, _sessionId?: string | null): string;
+declare const _default: {
+    configureApp: typeof configureApp;
+    isPackageOrBundle: typeof isPackageOrBundle;
+    duplicateKeys: typeof duplicateKeys;
+    parseCapsArray: typeof parseCapsArray;
+    generateDriverLogPrefix: typeof generateDriverLogPrefix;
+};
+export default _default;
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../lib/basedriver/helpers.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAgB,mBAAmB,EAAiD,MAAM,eAAe,CAAC;AAUtH,eAAO,MAAM,cAAc,QAA0B,CAAC;AAuEtD;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,MAAM,GAAG,MAAM,EAAE,GAAG,mBAA+C,GAC3E,OAAO,CAAC,MAAM,CAAC,CA4LjB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,CAuBjF;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAqBpE;AAED;;;;;;GAMG;AAEH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAM9F;;;;;;;;AAyOD,wBAM0B"}