appium-mac2-driver 3.2.3 → 3.2.4

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [3.2.4](https://github.com/appium/appium-mac2-driver/compare/v3.2.3...v3.2.4) (2025-11-15)
+
+
+### Miscellaneous Chores
+
+* Migrate the rest of driver commands to typescript ([#353](https://github.com/appium/appium-mac2-driver/issues/353)) ([760ae72](https://github.com/appium/appium-mac2-driver/commit/760ae72b7c76d62c52c1a190f44854c70b2190a5))
+
 ## [3.2.3](https://github.com/appium/appium-mac2-driver/compare/v3.2.2...v3.2.3) (2025-11-15)
 
 

package/build/lib/commands/app-management.d.ts

@@ -1,56 +1,53 @@
+import type { Mac2Driver } from '../driver';
+import type { StringRecord } from '@appium/types';
 /**
  * Start an app with given bundle identifier or activates it
  * if the app is already running. An exception is thrown if the
  * app with the given identifier cannot be found.
  *
- * @this {Mac2Driver}
- * @param {string} [bundleId] Bundle identifier of the app to be launched or activated.
+ * @param bundleId - Bundle identifier of the app to be launched or activated.
  *                 Either this property or `path` must be provided
- * @param {string} [path] Full path to the app bundle. Either this property or
+ * @param path - Full path to the app bundle. Either this property or
  *                 `bundleId` must be provided
- * @param {string[]} [args] The list of command line arguments for the app to be launched with.
+ * @param args - The list of command line arguments for the app to be launched with.
  *                   This parameter is ignored if the app is already running.
- * @param {import('@appium/types').StringRecord} [environment] Environment variables mapping.
+ * @param environment - Environment variables mapping.
  *                   Custom variables are added to the default process environment.
  */
-export function macosLaunchApp(this: import("../driver").Mac2Driver, bundleId?: string, path?: string, args?: string[], environment?: import("@appium/types").StringRecord): Promise<any>;
+export declare function macosLaunchApp(this: Mac2Driver, bundleId?: string, path?: string, args?: string[], environment?: StringRecord): Promise<unknown>;
 /**
  * Activate an app with given bundle identifier. An exception is thrown if the
  * app cannot be found or is not running.
  *
- * @this {Mac2Driver}
- * @param {string} [bundleId] Bundle identifier of the app to be activated.
+ * @param bundleId - Bundle identifier of the app to be activated.
  *                 Either this property or `path` must be provided
- * @param {string} [path] Full path to the app bundle. Either this property
+ * @param path - Full path to the app bundle. Either this property
  *                 or `bundleId` must be provided
  */
-export function macosActivateApp(this: import("../driver").Mac2Driver, bundleId?: string, path?: string): Promise<any>;
+export declare function macosActivateApp(this: Mac2Driver, bundleId?: string, path?: string): Promise<unknown>;
 /**
  * Terminate an app with given bundle identifier. An exception is thrown if the
  * app cannot be found.
  *
- * @this {Mac2Driver}
- * @param {string} [bundleId] Bundle identifier of the app to be terminated.
+ * @param bundleId - Bundle identifier of the app to be terminated.
  *                 Either this property or `path` must be provided
- * @param {string} [path] Full path to the app bundle. Either this property
+ * @param path - Full path to the app bundle. Either this property
  *                 or `bundleId` must be provided
- * @returns {Promise<boolean>} `true` if the app was running and has been successfully terminated.
+ * @returns `true` if the app was running and has been successfully terminated.
  * `false` if the app was not running before.
  */
-export function macosTerminateApp(this: import("../driver").Mac2Driver, bundleId?: string, path?: string): Promise<boolean>;
+export declare function macosTerminateApp(this: Mac2Driver, bundleId?: string, path?: string): Promise<boolean>;
 /**
  * Query an app state with given bundle identifier. An exception is thrown if the
  * app cannot be found.
  *
- * @this {Mac2Driver}
- * @param {string} [bundleId] Bundle identifier of the app whose state should be queried.
+ * @param bundleId - Bundle identifier of the app whose state should be queried.
  *                 Either this property or `path` must be provided
- * @param {string} [path] Full path to the app bundle. Either this property
+ * @param path - Full path to the app bundle. Either this property
  *                 or `bundleId` must be provided
- * @returns {Promise<number>} The application state code. See
+ * @returns The application state code. See
  * https://developer.apple.com/documentation/xctest/xcuiapplicationstate?language=objc
  * for more details
  */
-export function macosQueryAppState(this: import("../driver").Mac2Driver, bundleId?: string, path?: string): Promise<number>;
-export type Mac2Driver = import("../driver").Mac2Driver;
+export declare function macosQueryAppState(this: Mac2Driver, bundleId?: string, path?: string): Promise<number>;
 //# sourceMappingURL=app-management.d.ts.map

package/build/lib/commands/app-management.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-management.d.ts","sourceRoot":"","sources":["../../../lib/commands/app-management.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,gFATW,MAAM,SAEN,MAAM,SAEN,MAAM,EAAE,gBAER,OAAO,eAAe,EAAE,YAAY,gBAe9C;AAED;;;;;;;;;GASG;AACH,kFALW,MAAM,SAEN,MAAM,gBAKhB;AAED;;;;;;;;;;;GAWG;AACH,mFAPW,MAAM,SAEN,MAAM,GAEJ,OAAO,CAAC,OAAO,CAAC,CAO5B;AAED;;;;;;;;;;;;GAYG;AACH,oFARW,MAAM,SAEN,MAAM,GAEJ,OAAO,CAAC,MAAM,CAAC,CAQ3B;yBAGY,OAAO,WAAW,EAAE,UAAU"}
+{"version":3,"file":"app-management.d.ts","sourceRoot":"","sources":["../../../lib/commands/app-management.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,UAAU,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,EAAE,EACf,WAAW,CAAC,EAAE,YAAY,GACzB,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,UAAU,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC,CAElB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,UAAU,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC,CAElB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,UAAU,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAEjB"}

package/build/lib/commands/app-management.js

@@ -9,14 +9,13 @@ exports.macosQueryAppState = macosQueryAppState;
  * if the app is already running. An exception is thrown if the
  * app with the given identifier cannot be found.
  *
- * @this {Mac2Driver}
- * @param {string} [bundleId] Bundle identifier of the app to be launched or activated.
+ * @param bundleId - Bundle identifier of the app to be launched or activated.
  *                 Either this property or `path` must be provided
- * @param {string} [path] Full path to the app bundle. Either this property or
+ * @param path - Full path to the app bundle. Either this property or
  *                 `bundleId` must be provided
- * @param {string[]} [args] The list of command line arguments for the app to be launched with.
+ * @param args - The list of command line arguments for the app to be launched with.
  *                   This parameter is ignored if the app is already running.
- * @param {import('@appium/types').StringRecord} [environment] Environment variables mapping.
+ * @param environment - Environment variables mapping.
  *                   Custom variables are added to the default process environment.
  */
 async function macosLaunchApp(bundleId, path, args, environment) {
@@ -27,55 +26,45 @@ async function macosLaunchApp(bundleId, path, args, environment) {
         path,
     });
 }
-;
 /**
  * Activate an app with given bundle identifier. An exception is thrown if the
  * app cannot be found or is not running.
  *
- * @this {Mac2Driver}
- * @param {string} [bundleId] Bundle identifier of the app to be activated.
+ * @param bundleId - Bundle identifier of the app to be activated.
  *                 Either this property or `path` must be provided
- * @param {string} [path] Full path to the app bundle. Either this property
+ * @param path - Full path to the app bundle. Either this property
  *                 or `bundleId` must be provided
  */
 async function macosActivateApp(bundleId, path) {
     return await this.wda.proxy.command('/wda/apps/activate', 'POST', { bundleId, path });
 }
-;
 /**
  * Terminate an app with given bundle identifier. An exception is thrown if the
  * app cannot be found.
  *
- * @this {Mac2Driver}
- * @param {string} [bundleId] Bundle identifier of the app to be terminated.
+ * @param bundleId - Bundle identifier of the app to be terminated.
  *                 Either this property or `path` must be provided
- * @param {string} [path] Full path to the app bundle. Either this property
+ * @param path - Full path to the app bundle. Either this property
  *                 or `bundleId` must be provided
- * @returns {Promise<boolean>} `true` if the app was running and has been successfully terminated.
+ * @returns `true` if the app was running and has been successfully terminated.
  * `false` if the app was not running before.
  */
 async function macosTerminateApp(bundleId, path) {
-    return /** @type {boolean} */ (await this.wda.proxy.command('/wda/apps/terminate', 'POST', { bundleId, path }));
+    return (await this.wda.proxy.command('/wda/apps/terminate', 'POST', { bundleId, path }));
 }
-;
 /**
  * Query an app state with given bundle identifier. An exception is thrown if the
  * app cannot be found.
  *
- * @this {Mac2Driver}
- * @param {string} [bundleId] Bundle identifier of the app whose state should be queried.
+ * @param bundleId - Bundle identifier of the app whose state should be queried.
  *                 Either this property or `path` must be provided
- * @param {string} [path] Full path to the app bundle. Either this property
+ * @param path - Full path to the app bundle. Either this property
  *                 or `bundleId` must be provided
- * @returns {Promise<number>} The application state code. See
+ * @returns The application state code. See
  * https://developer.apple.com/documentation/xctest/xcuiapplicationstate?language=objc
  * for more details
  */
 async function macosQueryAppState(bundleId, path) {
-    return /** @type {number} */ (await this.wda.proxy.command('/wda/apps/state', 'POST', { bundleId, path }));
+    return (await this.wda.proxy.command('/wda/apps/state', 'POST', { bundleId, path }));
 }
-;
-/**
- * @typedef {import('../driver').Mac2Driver} Mac2Driver
- */
 //# sourceMappingURL=app-management.js.map

package/build/lib/commands/app-management.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-management.js","sourceRoot":"","sources":["../../../lib/commands/app-management.js"],"names":[],"mappings":";;AAeA,wCAYC;AAYD,4CAEC;AAcD,8CAIC;AAeD,gDAIC;AA9ED;;;;;;;;;;;;;;GAcG;AACI,KAAK,UAAU,cAAc,CAClC,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,WAAW;IAEX,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,kBAAkB,EAAE,MAAM,EAAE;QAC9D,SAAS,EAAE,IAAI;QACf,WAAW;QACX,QAAQ;QACR,IAAI;KACL,CAAC,CAAC;AACL,CAAC;AAAA,CAAC;AAEF;;;;;;;;;GASG;AACI,KAAK,UAAU,gBAAgB,CAAE,QAAQ,EAAE,IAAI;IACpD,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,oBAAoB,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AACxF,CAAC;AAAA,CAAC;AAEF;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,iBAAiB,CAAE,QAAQ,EAAE,IAAI;IACrD,OAAO,sBAAsB,CAAC,CAC5B,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAChF,CAAC;AACJ,CAAC;AAAA,CAAC;AAEF;;;;;;;;;;;;GAYG;AACI,KAAK,UAAU,kBAAkB,CAAE,QAAQ,EAAE,IAAI;IACtD,OAAO,qBAAqB,CAAC,CAC3B,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,iBAAiB,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAC5E,CAAC;AACJ,CAAC;AAAA,CAAC;AAEF;;GAEG"}
+{"version":3,"file":"app-management.js","sourceRoot":"","sources":["../../../lib/commands/app-management.ts"],"names":[],"mappings":";;AAiBA,wCAaC;AAWD,4CAMC;AAaD,8CAMC;AAcD,gDAMC;AAnFD;;;;;;;;;;;;;GAaG;AACI,KAAK,UAAU,cAAc,CAElC,QAAiB,EACjB,IAAa,EACb,IAAe,EACf,WAA0B;IAE1B,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,kBAAkB,EAAE,MAAM,EAAE;QAC9D,SAAS,EAAE,IAAI;QACf,WAAW;QACX,QAAQ;QACR,IAAI;KACL,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACI,KAAK,UAAU,gBAAgB,CAEpC,QAAiB,EACjB,IAAa;IAEb,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,oBAAoB,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AACxF,CAAC;AAED;;;;;;;;;;GAUG;AACI,KAAK,UAAU,iBAAiB,CAErC,QAAiB,EACjB,IAAa;IAEb,OAAO,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAY,CAAC;AACtG,CAAC;AAED;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,kBAAkB,CAEtC,QAAiB,EACjB,IAAa;IAEb,OAAO,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,iBAAiB,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAW,CAAC;AACjG,CAAC"}

package/build/lib/commands/applescript.d.ts

@@ -1,3 +1,4 @@
+import type { Mac2Driver } from '../driver';
 /**
  * Executes the given AppleScript command or a whole script based on the
  * given options. Either of these options must be provided. If both are provided
@@ -9,20 +10,18 @@
  * and no permissions to do it are given to the parent (for example, Appium or Terminal)
  * process in System Preferences -> Privacy list.
  *
- * @this {Mac2Driver}
- * @param {string} [script] A valid AppleScript to execute
- * @param {string} [language] Overrides the scripting language. Basically, sets
+ * @param script - A valid AppleScript to execute
+ * @param language - Overrides the scripting language. Basically, sets
  *                 the value of `-l` command line argument of `osascript` tool.
  *                 If unset the AppleScript language is assumed.
- * @param {string} [command] A valid AppleScript as a single command (no line breaks) to execute
- * @param {string} [cwd] The path to an existing folder, which is going to be set as
+ * @param command - A valid AppleScript as a single command (no line breaks) to execute
+ * @param cwd - The path to an existing folder, which is going to be set as
  *                       the working directory for the command/script being executed.
- * @param {number} [timeout] The number of seconds to wait until a long-running command is finished.
+ * @param timeout - The number of seconds to wait until a long-running command is finished.
  *                           An error is thrown if the command is still running after this timeout expires.
- * @returns {Promise<string>} The actual stdout of the given command/script
+ * @returns The actual stdout of the given command/script
  * @throws {Error} If the exit code of the given command/script is not zero.
  * The actual stderr output is set to the error message value.
  */
-export function macosExecAppleScript(this: import("../driver").Mac2Driver, script?: string, language?: string, command?: string, cwd?: string, timeout?: number): Promise<string>;
-export type Mac2Driver = import("../driver").Mac2Driver;
+export declare function macosExecAppleScript(this: Mac2Driver, script?: string, language?: string, command?: string, cwd?: string, timeout?: number): Promise<string>;
 //# sourceMappingURL=applescript.d.ts.map

package/build/lib/commands/applescript.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"applescript.d.ts","sourceRoot":"","sources":["../../../lib/commands/applescript.js"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,oFAbW,MAAM,aACN,MAAM,YAGN,MAAM,QACN,MAAM,YAEN,MAAM,GAEJ,OAAO,CAAC,MAAM,CAAC,CAgD3B;yBAGY,OAAO,WAAW,EAAE,UAAU"}
+{"version":3,"file":"applescript.d.ts","sourceRoot":"","sources":["../../../lib/commands/applescript.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAK5C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,UAAU,EAChB,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CA4CjB"}

package/build/lib/commands/applescript.js

@@ -20,17 +20,16 @@ const APPLE_SCRIPT_FEATURE = 'apple_script';
  * and no permissions to do it are given to the parent (for example, Appium or Terminal)
  * process in System Preferences -> Privacy list.
  *
- * @this {Mac2Driver}
- * @param {string} [script] A valid AppleScript to execute
- * @param {string} [language] Overrides the scripting language. Basically, sets
+ * @param script - A valid AppleScript to execute
+ * @param language - Overrides the scripting language. Basically, sets
  *                 the value of `-l` command line argument of `osascript` tool.
  *                 If unset the AppleScript language is assumed.
- * @param {string} [command] A valid AppleScript as a single command (no line breaks) to execute
- * @param {string} [cwd] The path to an existing folder, which is going to be set as
+ * @param command - A valid AppleScript as a single command (no line breaks) to execute
+ * @param cwd - The path to an existing folder, which is going to be set as
  *                       the working directory for the command/script being executed.
- * @param {number} [timeout] The number of seconds to wait until a long-running command is finished.
+ * @param timeout - The number of seconds to wait until a long-running command is finished.
  *                           An error is thrown if the command is still running after this timeout expires.
- * @returns {Promise<string>} The actual stdout of the given command/script
+ * @returns The actual stdout of the given command/script
  * @throws {Error} If the exit code of the given command/script is not zero.
  * The actual stderr output is set to the error message value.
  */
@@ -39,7 +38,7 @@ async function macosExecAppleScript(script, language, command, cwd, timeout) {
     if (!script && !command) {
         throw this.log.errorWithException('AppleScript script/command must not be empty');
     }
-    if (/\n/.test(/** @type {string} */ (command))) {
+    if (command && /\n/.test(command)) {
         throw this.log.errorWithException('AppleScript commands cannot contain line breaks');
     }
     // 'command' has priority over 'script'
@@ -51,12 +50,18 @@ async function macosExecAppleScript(script, language, command, cwd, timeout) {
     let tmpRoot;
     try {
         if (shouldRunScript) {
+            if (!script) {
+                throw this.log.errorWithException('AppleScript script must be provided');
+            }
             tmpRoot = await support_1.tempDir.openDir();
             const tmpScriptPath = path_1.default.resolve(tmpRoot, 'appium_script.scpt');
-            await support_1.fs.writeFile(tmpScriptPath, /** @type {string} */ (script), 'utf8');
+            await support_1.fs.writeFile(tmpScriptPath, script, 'utf8');
             args.push(tmpScriptPath);
         }
         else {
+            if (!command) {
+                throw this.log.errorWithException('AppleScript command must be provided');
+            }
             args.push('-e', command);
         }
         this.log.info(`Running ${OSASCRIPT} with arguments: ${support_1.util.quote(args)}`);
@@ -74,8 +79,4 @@ async function macosExecAppleScript(script, language, command, cwd, timeout) {
         }
     }
 }
-;
-/**
- * @typedef {import('../driver').Mac2Driver} Mac2Driver
- */
 //# sourceMappingURL=applescript.js.map

package/build/lib/commands/applescript.js.map

@@ -1 +1 @@
-{"version":3,"file":"applescript.js","sourceRoot":"","sources":["../../../lib/commands/applescript.js"],"names":[],"mappings":";;;;;AAgCA,oDA4CC;AA5ED,4CAAmD;AACnD,+CAAoC;AACpC,gDAAwB;AAExB,MAAM,SAAS,GAAG,WAAW,CAAC;AAC9B,MAAM,oBAAoB,GAAG,cAAc,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACI,KAAK,UAAU,oBAAoB,CACxC,MAAM,EACN,QAAQ,EACR,OAAO,EACP,GAAG,EACH,OAAO;IAEP,IAAI,CAAC,oBAAoB,CAAC,oBAAoB,CAAC,CAAC;IAEhD,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,8CAA8C,CAAC,CAAC;IACpF,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAA,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,iDAAiD,CAAC,CAAC;IACvF,CAAC;IACD,uCAAuC;IACvC,MAAM,eAAe,GAAG,CAAC,OAAO,CAAC;IAEjC,MAAM,IAAI,GAAG,EAAE,CAAC;IAChB,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC5B,CAAC;IACD,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO,GAAG,MAAM,iBAAO,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,aAAa,GAAG,cAAI,CAAC,OAAO,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;YAClE,MAAM,YAAE,CAAC,SAAS,CAAC,aAAa,EAAE,qBAAqB,CAAA,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;YACzE,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,SAAS,oBAAoB,cAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1E,IAAI,CAAC;YACH,MAAM,EAAC,MAAM,EAAC,GAAG,MAAM,IAAA,mBAAI,EAAC,SAAS,EAAE,IAAI,EAAE,EAAC,GAAG,EAAE,OAAO,EAAC,CAAC,CAAC;YAC7D,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;YAAS,CAAC;QACT,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,YAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;AACH,CAAC;AAAA,CAAC;AAEF;;GAEG"}
+{"version":3,"file":"applescript.js","sourceRoot":"","sources":["../../../lib/commands/applescript.ts"],"names":[],"mappings":";;;;;AAgCA,oDAmDC;AAnFD,4CAAmD;AACnD,+CAAoC;AACpC,gDAAwB;AAGxB,MAAM,SAAS,GAAG,WAAW,CAAC;AAC9B,MAAM,oBAAoB,GAAG,cAAc,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACI,KAAK,UAAU,oBAAoB,CAExC,MAAe,EACf,QAAiB,EACjB,OAAgB,EAChB,GAAY,EACZ,OAAgB;IAEhB,IAAI,CAAC,oBAAoB,CAAC,oBAAoB,CAAC,CAAC;IAEhD,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,8CAA8C,CAAC,CAAC;IACpF,CAAC;IACD,IAAI,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,iDAAiD,CAAC,CAAC;IACvF,CAAC;IACD,uCAAuC;IACvC,MAAM,eAAe,GAAG,CAAC,OAAO,CAAC;IAEjC,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC5B,CAAC;IACD,IAAI,OAA2B,CAAC;IAChC,IAAI,CAAC;QACH,IAAI,eAAe,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,qCAAqC,CAAC,CAAC;YAC3E,CAAC;YACD,OAAO,GAAG,MAAM,iBAAO,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,aAAa,GAAG,cAAI,CAAC,OAAO,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;YAClE,MAAM,YAAE,CAAC,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YAClD,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,sCAAsC,CAAC,CAAC;YAC5E,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,SAAS,oBAAoB,cAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1E,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAA,mBAAI,EAAC,SAAS,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;YACjE,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;YAAS,CAAC;QACT,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,YAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;AACH,CAAC"}

package/build/lib/commands/execute.d.ts

@@ -1,12 +1,9 @@
+import type { Mac2Driver } from '../driver';
+import type { StringRecord } from '@appium/types';
 /**
  *
- * @this {Mac2Driver}
- * @param {string} script
- * @param {any[]|import('@appium/types').StringRecord} [args]
- * @returns {Promise<any>}
+ * @param script - The script to execute
+ * @param args - Arguments to pass to the script
  */
-export function execute(this: import("../driver").Mac2Driver, script: string, args?: any[] | import("@appium/types").StringRecord): Promise<any>;
-export type Mac2Driver = import("../driver").Mac2Driver;
-export type StringRecord = import("@appium/types").StringRecord;
-export type ExecuteMethodArgs = readonly any[] | readonly [StringRecord] | Readonly<StringRecord>;
+export declare function execute(this: Mac2Driver, script: string, args?: readonly any[] | StringRecord): Promise<any>;
 //# sourceMappingURL=execute.d.ts.map

package/build/lib/commands/execute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../lib/commands/execute.js"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,sEAJW,MAAM,SACN,GAAG,EAAE,GAAC,OAAO,eAAe,EAAE,YAAY,GACxC,OAAO,CAAC,GAAG,CAAC,CAOxB;yBAaY,OAAO,WAAW,EAAE,UAAU;2BAC9B,OAAO,eAAe,EAAE,YAAY;gCACpC,SAAS,GAAG,EAAE,GAAG,SAAS,CAAC,YAAY,CAAC,GAAG,QAAQ,CAAC,YAAY,CAAC"}
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../lib/commands/execute.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAIlD;;;;GAIG;AACH,wBAAsB,OAAO,CAC3B,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,SAAS,GAAG,EAAE,GAAG,YAAY,GACnC,OAAO,CAAC,GAAG,CAAC,CAKd"}

package/build/lib/commands/execute.js

@@ -8,10 +8,8 @@ const lodash_1 = __importDefault(require("lodash"));
 const EXECUTE_SCRIPT_PREFIX = 'macos:';
 /**
  *
- * @this {Mac2Driver}
- * @param {string} script
- * @param {any[]|import('@appium/types').StringRecord} [args]
- * @returns {Promise<any>}
+ * @param script - The script to execute
+ * @param args - Arguments to pass to the script
  */
 async function execute(script, args) {
     this.log.info(`Executing extension command '${script}'`);
@@ -19,19 +17,13 @@ async function execute(script, args) {
     const preprocessedArgs = preprocessExecuteMethodArgs(args);
     return await this.executeMethod(formattedScript, [preprocessedArgs]);
 }
-;
 /**
  * Massages the arguments going into an execute method.
  *
- * @param {ExecuteMethodArgs} [args]
- * @returns {StringRecord}
+ * @param args - Arguments to preprocess
+ * @returns Preprocessed arguments as StringRecord
  */
 function preprocessExecuteMethodArgs(args) {
-    return /** @type {StringRecord} */ ((lodash_1.default.isArray(args) ? lodash_1.default.first(args) : args) ?? {});
+    return (lodash_1.default.isArray(args) ? lodash_1.default.first(args) : args) ?? {};
 }
-/**
- * @typedef {import('../driver').Mac2Driver} Mac2Driver
- * @typedef {import('@appium/types').StringRecord} StringRecord
- * @typedef {readonly any[] | readonly [StringRecord] | Readonly<StringRecord>} ExecuteMethodArgs
- */
 //# sourceMappingURL=execute.js.map

package/build/lib/commands/execute.js.map

@@ -1 +1 @@
-{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../../lib/commands/execute.js"],"names":[],"mappings":";;;;;AAWA,0BAKC;AAhBD,oDAAuB;AAEvB,MAAM,qBAAqB,GAAG,QAAQ,CAAC;AAEvC;;;;;;GAMG;AACI,KAAK,UAAU,OAAO,CAAE,MAAM,EAAE,IAAI;IACzC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gCAAgC,MAAM,GAAG,CAAC,CAAC;IACzD,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,GAAG,qBAAqB,GAAG,CAAC,CAAC;IACjG,MAAM,gBAAgB,GAAG,2BAA2B,CAAC,IAAI,CAAC,CAAC;IAC3D,OAAO,MAAM,IAAI,CAAC,aAAa,CAAC,eAAe,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC;AACvE,CAAC;AAAA,CAAC;AAEF;;;;;GAKG;AACH,SAAS,2BAA2B,CAAC,IAAI;IACvC,OAAO,2BAA2B,CAAC,CAAC,CAAC,gBAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,gBAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;AACtF,CAAC;AAED;;;;GAIG"}
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../../lib/commands/execute.ts"],"names":[],"mappings":";;;;;AAWA,0BASC;AApBD,oDAAuB;AAIvB,MAAM,qBAAqB,GAAG,QAAQ,CAAC;AAEvC;;;;GAIG;AACI,KAAK,UAAU,OAAO,CAE3B,MAAc,EACd,IAAoC;IAEpC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gCAAgC,MAAM,GAAG,CAAC,CAAC;IACzD,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,GAAG,qBAAqB,GAAG,CAAC,CAAC;IACjG,MAAM,gBAAgB,GAAG,2BAA2B,CAAC,IAAI,CAAC,CAAC;IAC3D,OAAO,MAAM,IAAI,CAAC,aAAa,CAAC,eAAe,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC;AACvE,CAAC;AAED;;;;;GAKG;AACH,SAAS,2BAA2B,CAAC,IAAoC;IACvE,OAAO,CAAC,gBAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,gBAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;AACxD,CAAC"}

package/build/lib/commands/find.d.ts

@@ -1,13 +1,11 @@
+import type { Mac2Driver } from '../driver';
 /**
  * This is needed to make lookup by image working
  *
- * @this {Mac2Driver}
- * @param {string} strategy
- * @param {string} selector
- * @param {boolean} mult
- * @param {string} [context]
- * @returns {Promise<any>}
+ * @param strategy - The locator strategy to use
+ * @param selector - The selector value
+ * @param mult - Whether to find multiple elements
+ * @param context - Optional context element ID
  */
-export function findElOrEls(this: import("../driver").Mac2Driver, strategy: string, selector: string, mult: boolean, context?: string): Promise<any>;
-export type Mac2Driver = import("../driver").Mac2Driver;
+export declare function findElOrEls(this: Mac2Driver, strategy: string, selector: string, mult: boolean, context?: string): Promise<any>;
 //# sourceMappingURL=find.d.ts.map

package/build/lib/commands/find.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../lib/commands/find.js"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,4EANW,MAAM,YACN,MAAM,QACN,OAAO,YACP,MAAM,GACJ,OAAO,CAAC,GAAG,CAAC,CAgBxB;yBAGY,OAAO,WAAW,EAAE,UAAU"}
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../lib/commands/find.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,GAAG,CAAC,CAed"}

package/build/lib/commands/find.js

@@ -5,29 +5,24 @@ const support_1 = require("appium/support");
 /**
  * This is needed to make lookup by image working
  *
- * @this {Mac2Driver}
- * @param {string} strategy
- * @param {string} selector
- * @param {boolean} mult
- * @param {string} [context]
- * @returns {Promise<any>}
+ * @param strategy - The locator strategy to use
+ * @param selector - The selector value
+ * @param mult - Whether to find multiple elements
+ * @param context - Optional context element ID
  */
 async function findElOrEls(strategy, selector, mult, context) {
     const contextId = context ? support_1.util.unwrapElement(context) : context;
     const endpoint = `/element${contextId ? `/${contextId}/element` : ''}${mult ? 's' : ''}`;
+    let normalizedStrategy = strategy;
     if (strategy === '-ios predicate string') {
-        strategy = 'predicate string';
+        normalizedStrategy = 'predicate string';
     }
     else if (strategy === '-ios class chain') {
-        strategy = 'class chain';
+        normalizedStrategy = 'class chain';
     }
     return await this.wda.proxy.command(endpoint, 'POST', {
-        using: strategy,
+        using: normalizedStrategy,
         value: selector,
     });
 }
-;
-/**
- * @typedef {import('../driver').Mac2Driver} Mac2Driver
- */
 //# sourceMappingURL=find.js.map

package/build/lib/commands/find.js.map

@@ -1 +1 @@
-{"version":3,"file":"find.js","sourceRoot":"","sources":["../../../lib/commands/find.js"],"names":[],"mappings":";;AAYA,kCAcC;AA1BD,4CAAsC;AAEtC;;;;;;;;;GASG;AACI,KAAK,UAAU,WAAW,CAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO;IAClE,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,cAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAClE,MAAM,QAAQ,GAAG,WAAW,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAEzF,IAAI,QAAQ,KAAK,uBAAuB,EAAE,CAAC;QACzC,QAAQ,GAAG,kBAAkB,CAAC;IAChC,CAAC;SAAM,IAAI,QAAQ,KAAK,kBAAkB,EAAE,CAAC;QAC3C,QAAQ,GAAG,aAAa,CAAC;IAC3B,CAAC;IAED,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE;QACpD,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,QAAQ;KAChB,CAAC,CAAC;AACL,CAAC;AAAA,CAAC;AAEF;;GAEG"}
+{"version":3,"file":"find.js","sourceRoot":"","sources":["../../../lib/commands/find.ts"],"names":[],"mappings":";;AAWA,kCAqBC;AAhCD,4CAAsC;AAGtC;;;;;;;GAOG;AACI,KAAK,UAAU,WAAW,CAE/B,QAAgB,EAChB,QAAgB,EAChB,IAAa,EACb,OAAgB;IAEhB,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,cAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAClE,MAAM,QAAQ,GAAG,WAAW,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAEzF,IAAI,kBAAkB,GAAG,QAAQ,CAAC;IAClC,IAAI,QAAQ,KAAK,uBAAuB,EAAE,CAAC;QACzC,kBAAkB,GAAG,kBAAkB,CAAC;IAC1C,CAAC;SAAM,IAAI,QAAQ,KAAK,kBAAkB,EAAE,CAAC;QAC3C,kBAAkB,GAAG,aAAa,CAAC;IACrC,CAAC;IAED,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE;QACpD,KAAK,EAAE,kBAAkB;QACzB,KAAK,EAAE,QAAQ;KAChB,CAAC,CAAC;AACL,CAAC"}