appium-mac2-driver 1.6.3 → 1.7.1

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [1.7.1](https://github.com/appium/appium-mac2-driver/compare/v1.7.0...v1.7.1) (2023-08-14)
+
+
+### Miscellaneous Chores
+
+* **deps-dev:** bump lint-staged from 13.3.0 to 14.0.0 ([#217](https://github.com/appium/appium-mac2-driver/issues/217)) ([7c02fb6](https://github.com/appium/appium-mac2-driver/commit/7c02fb618471c221d98f77b4c187d6a98895428b))
+
+## [1.7.0](https://github.com/appium/appium-mac2-driver/compare/v1.6.3...v1.7.0) (2023-08-12)
+
+
+### Features
+
+* Switch babel to typescript ([#216](https://github.com/appium/appium-mac2-driver/issues/216)) ([c908503](https://github.com/appium/appium-mac2-driver/commit/c9085034ebe57ee743acb18da5236af4563873f7))
+
 ## [1.6.3](https://github.com/appium/appium-mac2-driver/compare/v1.6.2...v1.6.3) (2023-06-16)
 
 

package/README.md

@@ -217,6 +217,7 @@ startY | number | if `sourceElementId` and `destinationElementId` are unset | st
 endX | number | if `sourceElementId` and `destinationElementId` are unset | end X coordinate | 200
 endY | number | if `sourceElementId` and `destinationElementId` are unset | end Y coordinate | 220
 duration | number | yes | The number of float seconds to hold the mouse button | 2.5
+holdDuration | number | yes | Touch hold duration in float seconds | 2.5
 velocity | number | no | Dragging velocity in pixels per second. If not provided then the default velocity is used. See official documentation on [XCUIGestureVelocity structure](https://developer.apple.com/documentation/xctest/xcuigesturevelocity) for more details | 2500
 keyModifierFlags | number | no | if set then the given key modifiers will be applied while drag is performed. See the official documentation on [XCUIKeyModifierFlags enumeration](https://developer.apple.com/documentation/xctest/xcuikeymodifierflags) for more details | `1 << 1 | 1 << 2`
 
@@ -341,6 +342,7 @@ startY | number | if `sourceElementId` and `destinationElementId` are unset | st
 endX | number | if `sourceElementId` and `destinationElementId` are unset | end X coordinate | 200
 endY | number | if `sourceElementId` and `destinationElementId` are unset | end Y coordinate | 220
 duration | number | yes | The number of float seconds to hold the touch | 2.5
+holdDuration | number | yes | Touch hold duration in float seconds | 2.5
 velocity | number | no | Dragging velocity in pixels per second. If not provided then the default velocity is used. See official documentation on [XCUIGestureVelocity structure](https://developer.apple.com/documentation/xctest/xcuigesturevelocity) for more details | 2500
 keyModifierFlags | number | no | if set then the given key modifiers will be applied while the gesture is performed. See the official documentation on [XCUIKeyModifierFlags enumeration](https://developer.apple.com/documentation/xctest/xcuikeymodifierflags) for more details | `1 << 1 | 1 << 2`
 

package/build/index.js

@@ -1,18 +1,10 @@
 "use strict";
-
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-Object.defineProperty(exports, "Mac2Driver", {
-  enumerable: true,
-  get: function () {
-    return _driver.default;
-  }
-});
-exports.default = void 0;
-require("source-map-support/register");
-var _driver = _interopRequireDefault(require("./lib/driver"));
-var _default = _driver.default;
-exports.default = _default;
-//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJuYW1lcyI6WyJfZHJpdmVyIiwiX2ludGVyb3BSZXF1aXJlRGVmYXVsdCIsInJlcXVpcmUiLCJfZGVmYXVsdCIsIk1hYzJEcml2ZXIiLCJleHBvcnRzIiwiZGVmYXVsdCJdLCJzb3VyY2VzIjpbIi4uL2luZGV4LmpzIl0sInNvdXJjZXNDb250ZW50IjpbImltcG9ydCBNYWMyRHJpdmVyIGZyb20gJy4vbGliL2RyaXZlcic7XG5cbmV4cG9ydCBkZWZhdWx0IE1hYzJEcml2ZXI7XG5leHBvcnQgeyBNYWMyRHJpdmVyIH07XG4iXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7O0FBQUEsSUFBQUEsT0FBQSxHQUFBQyxzQkFBQSxDQUFBQyxPQUFBO0FBQXNDLElBQUFDLFFBQUEsR0FFdkJDLGVBQVU7QUFBQUMsT0FBQSxDQUFBQyxPQUFBLEdBQUFILFFBQUEifQ==
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Mac2Driver = void 0;
+const driver_1 = __importDefault(require("./lib/driver"));
+exports.Mac2Driver = driver_1.default;
+exports.default = driver_1.default;
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,96 @@
+export default commands;
+export type LaunchAppOptions = {
+    /**
+     * bundle identifier of the app to be launched
+     * or activated
+     */
+    bundleId: string;
+    /**
+     * the list of command line arguments
+     * for the app to be be launched with. This parameter is ignored if the app
+     * is already running.
+     */
+    arguments: string[];
+    /**
+     * environment variables mapping. Custom
+     * variables are added to the default process environment.
+     */
+    environment: any;
+};
+export type ActivateAppOptions = {
+    /**
+     * bundle identifier of the app to be activated
+     */
+    bundleId: string;
+};
+export type TerminateAppOptions = {
+    /**
+     * bundle identifier of the app to be terminated
+     */
+    bundleId: string;
+};
+export type QueryAppStateOptions = {
+    /**
+     * bundle identifier of the app whose state should be queried
+     */
+    bundleId: string;
+};
+declare namespace commands {
+    /**
+     * @typedef {Object} LaunchAppOptions
+     * @property {string} bundleId bundle identifier of the app to be launched
+     * or activated
+     * @property {string[]} arguments the list of command line arguments
+     * for the app to be be launched with. This parameter is ignored if the app
+     * is already running.
+     * @property {Object} environment environment variables mapping. Custom
+     * variables are added to the default process environment.
+     */
+    /**
+     * 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.
+     *
+     * @param {LaunchAppOptions} opts
+     */
+    function macosLaunchApp(opts: LaunchAppOptions): Promise<any>;
+    /**
+     * @typedef {Object} ActivateAppOptions
+     * @property {string} bundleId bundle identifier of the app to be activated
+     */
+    /**
+     * Activate an app with given bundle identifier. An exception is thrown if the
+     * app cannot be found or is not running.
+     *
+     * @param {ActivateAppOptions} opts
+     */
+    function macosActivateApp(opts: ActivateAppOptions): Promise<any>;
+    /**
+     * @typedef {Object} TerminateAppOptions
+     * @property {string} bundleId bundle identifier of the app to be terminated
+     */
+    /**
+     * Terminate an app with given bundle identifier. An exception is thrown if the
+     * app cannot be found.
+     *
+     * @param {TerminateAppOptions} opts
+     * @returns {Promise<boolean>} `true` if the app was running and has been successfully terminated.
+     * `false` if the app was not running before.
+     */
+    function macosTerminateApp(opts: TerminateAppOptions): Promise<boolean>;
+    /**
+     * @typedef {Object} QueryAppStateOptions
+     * @property {string} bundleId bundle identifier of the app whose state should be queried
+     */
+    /**
+     * Query an app state with given bundle identifier. An exception is thrown if the
+     * app cannot be found.
+     *
+     * @param {QueryAppStateOptions} opts
+     * @returns {Promise<number>} The application state code. See
+     * https://developer.apple.com/documentation/xctest/xcuiapplicationstate?language=objc
+     * for more details
+     */
+    function macosQueryAppState(opts: QueryAppStateOptions): Promise<number>;
+}
+//# sourceMappingURL=app-management.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"app-management.d.ts","sourceRoot":"","sources":["../../../lib/commands/app-management.js"],"names":[],"mappings":";;;;;;cAIc,MAAM;;;;;;eAEN,MAAM,EAAE;;;;;;;;;;;cAyBR,MAAM;;;;;;cAgBN,MAAM;;;;;;cAkBN,MAAM;;;IA/DpB;;;;;;;;;OASG;IAEH;;;;;;OAMG;IACH,8DAOC;IAED;;;OAGG;IAEH;;;;;OAKG;IACH,kEAGC;IAED;;;OAGG;IAEH;;;;;;;OAOG;IACH,wEAGC;IAED;;;OAGG;IAEH;;;;;;;;OAQG;IACH,yEAGC"}

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

@@ -1,46 +1,77 @@
 "use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-require("source-map-support/register");
+Object.defineProperty(exports, "__esModule", { value: true });
 const commands = {};
-commands.macosLaunchApp = async function macosLaunchApp(opts = {}) {
-  const {
-    bundleId,
-    environment
-  } = opts;
-  return await this.wda.proxy.command('/wda/apps/launch', 'POST', {
-    arguments: opts.arguments,
-    environment,
-    bundleId
-  });
+/**
+ * @typedef {Object} LaunchAppOptions
+ * @property {string} bundleId bundle identifier of the app to be launched
+ * or activated
+ * @property {string[]} arguments the list of command line arguments
+ * for the app to be be launched with. This parameter is ignored if the app
+ * is already running.
+ * @property {Object} environment environment variables mapping. Custom
+ * variables are added to the default process environment.
+ */
+/**
+ * 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.
+ *
+ * @param {LaunchAppOptions} opts
+ */
+commands.macosLaunchApp = async function macosLaunchApp(opts) {
+    const { bundleId, environment } = opts ?? {};
+    return await this.wda.proxy.command('/wda/apps/launch', 'POST', {
+        arguments: opts.arguments,
+        environment,
+        bundleId,
+    });
 };
-commands.macosActivateApp = async function macosActivateApp(opts = {}) {
-  const {
-    bundleId
-  } = opts;
-  return await this.wda.proxy.command('/wda/apps/activate', 'POST', {
-    bundleId
-  });
+/**
+ * @typedef {Object} ActivateAppOptions
+ * @property {string} bundleId bundle identifier of the app to be activated
+ */
+/**
+ * Activate an app with given bundle identifier. An exception is thrown if the
+ * app cannot be found or is not running.
+ *
+ * @param {ActivateAppOptions} opts
+ */
+commands.macosActivateApp = async function macosActivateApp(opts) {
+    const { bundleId } = opts ?? {};
+    return await this.wda.proxy.command('/wda/apps/activate', 'POST', { bundleId });
 };
-commands.macosTerminateApp = async function macosTerminateApp(opts = {}) {
-  const {
-    bundleId
-  } = opts;
-  return await this.wda.proxy.command('/wda/apps/terminate', 'POST', {
-    bundleId
-  });
+/**
+ * @typedef {Object} TerminateAppOptions
+ * @property {string} bundleId bundle identifier of the app to be terminated
+ */
+/**
+ * Terminate an app with given bundle identifier. An exception is thrown if the
+ * app cannot be found.
+ *
+ * @param {TerminateAppOptions} opts
+ * @returns {Promise<boolean>} `true` if the app was running and has been successfully terminated.
+ * `false` if the app was not running before.
+ */
+commands.macosTerminateApp = async function macosTerminateApp(opts) {
+    const { bundleId } = opts ?? {};
+    return await this.wda.proxy.command('/wda/apps/terminate', 'POST', { bundleId });
 };
-commands.macosQueryAppState = async function macosQueryAppState(opts = {}) {
-  const {
-    bundleId
-  } = opts;
-  return await this.wda.proxy.command('/wda/apps/state', 'POST', {
-    bundleId
-  });
+/**
+ * @typedef {Object} QueryAppStateOptions
+ * @property {string} bundleId bundle identifier of the app whose state should be queried
+ */
+/**
+ * Query an app state with given bundle identifier. An exception is thrown if the
+ * app cannot be found.
+ *
+ * @param {QueryAppStateOptions} opts
+ * @returns {Promise<number>} The application state code. See
+ * https://developer.apple.com/documentation/xctest/xcuiapplicationstate?language=objc
+ * for more details
+ */
+commands.macosQueryAppState = async function macosQueryAppState(opts) {
+    const { bundleId } = opts ?? {};
+    return await this.wda.proxy.command('/wda/apps/state', 'POST', { bundleId });
 };
-var _default = commands;
-exports.default = _default;
-//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJuYW1lcyI6WyJjb21tYW5kcyIsIm1hY29zTGF1bmNoQXBwIiwib3B0cyIsImJ1bmRsZUlkIiwiZW52aXJvbm1lbnQiLCJ3ZGEiLCJwcm94eSIsImNvbW1hbmQiLCJhcmd1bWVudHMiLCJtYWNvc0FjdGl2YXRlQXBwIiwibWFjb3NUZXJtaW5hdGVBcHAiLCJtYWNvc1F1ZXJ5QXBwU3RhdGUiLCJfZGVmYXVsdCIsImV4cG9ydHMiLCJkZWZhdWx0Il0sInNvdXJjZXMiOlsiLi4vLi4vLi4vbGliL2NvbW1hbmRzL2FwcC1tYW5hZ2VtZW50LmpzIl0sInNvdXJjZXNDb250ZW50IjpbImNvbnN0IGNvbW1hbmRzID0ge307XG5cbi8qKlxuICogQHR5cGVkZWYge09iamVjdH0gTGF1bmNoQXBwT3B0aW9uc1xuICogQHByb3BlcnR5IHshc3RyaW5nfSBidW5kbGVJZCBidW5kbGUgaWRlbnRpZmllciBvZiB0aGUgYXBwIHRvIGJlIGxhdW5jaGVkXG4gKiBvciBhY3RpdmF0ZWRcbiAqIEBwcm9wZXJ0eSB7P0FycmF5PHN0cmluZz59IGFyZ3VtZW50cyB0aGUgbGlzdCBvZiBjb21tYW5kIGxpbmUgYXJndW1lbnRzXG4gKiBmb3IgdGhlIGFwcCB0byBiZSBiZSBsYXVuY2hlZCB3aXRoLiBUaGlzIHBhcmFtZXRlciBpcyBpZ25vcmVkIGlmIHRoZSBhcHBcbiAqIGlzIGFscmVhZHkgcnVubmluZy5cbiAqIEBwcm9wZXJ0eSB7T2JqZWN0fSBlbnZpcm9ubWVudCBlbnZpcm9ubWVudCB2YXJpYWJsZXMgbWFwcGluZy4gQ3VzdG9tXG4gKiB2YXJpYWJsZXMgYXJlIGFkZGVkIHRvIHRoZSBkZWZhdWx0IHByb2Nlc3MgZW52aXJvbm1lbnQuXG4gKi9cblxuLyoqXG4gKiBTdGFydCBhbiBhcHAgd2l0aCBnaXZlbiBidW5kbGUgaWRlbnRpZmllciBvciBhY3RpdmF0ZXMgaXRcbiAqIGlmIHRoZSBhcHAgaXMgYWxyZWFkeSBydW5uaW5nLiBBbiBleGNlcHRpb24gaXMgdGhyb3duIGlmIHRoZVxuICogYXBwIHdpdGggdGhlIGdpdmVuIGlkZW50aWZpZXIgY2Fubm90IGJlIGZvdW5kLlxuICpcbiAqIEBwYXJhbSB7TGF1bmNoQXBwT3B0aW9uc30gb3B0c1xuICovXG5jb21tYW5kcy5tYWNvc0xhdW5jaEFwcCA9IGFzeW5jIGZ1bmN0aW9uIG1hY29zTGF1bmNoQXBwIChvcHRzID0ge30pIHtcbiAgY29uc3QgeyBidW5kbGVJZCwgZW52aXJvbm1lbnQgfSA9IG9wdHM7XG4gIHJldHVybiBhd2FpdCB0aGlzLndkYS5wcm94eS5jb21tYW5kKCcvd2RhL2FwcHMvbGF1bmNoJywgJ1BPU1QnLCB7XG4gICAgYXJndW1lbnRzOiBvcHRzLmFyZ3VtZW50cyxcbiAgICBlbnZpcm9ubWVudCxcbiAgICBidW5kbGVJZCxcbiAgfSk7XG59O1xuXG4vKipcbiAqIEB0eXBlZGVmIHtPYmplY3R9IEFjdGl2YXRlQXBwT3B0aW9uc1xuICogQHByb3BlcnR5IHshc3RyaW5nfSBidW5kbGVJZCBidW5kbGUgaWRlbnRpZmllciBvZiB0aGUgYXBwIHRvIGJlIGFjdGl2YXRlZFxuICovXG5cbi8qKlxuICogQWN0aXZhdGUgYW4gYXBwIHdpdGggZ2l2ZW4gYnVuZGxlIGlkZW50aWZpZXIuIEFuIGV4Y2VwdGlvbiBpcyB0aHJvd24gaWYgdGhlXG4gKiBhcHAgY2Fubm90IGJlIGZvdW5kIG9yIGlzIG5vdCBydW5uaW5nLlxuICpcbiAqIEBwYXJhbSB7QWN0aXZhdGVBcHBPcHRpb25zfSBvcHRzXG4gKi9cbmNvbW1hbmRzLm1hY29zQWN0aXZhdGVBcHAgPSBhc3luYyBmdW5jdGlvbiBtYWNvc0FjdGl2YXRlQXBwIChvcHRzID0ge30pIHtcbiAgY29uc3QgeyBidW5kbGVJZCB9ID0gb3B0cztcbiAgcmV0dXJuIGF3YWl0IHRoaXMud2RhLnByb3h5LmNvbW1hbmQoJy93ZGEvYXBwcy9hY3RpdmF0ZScsICdQT1NUJywgeyBidW5kbGVJZCB9KTtcbn07XG5cbi8qKlxuICogQHR5cGVkZWYge09iamVjdH0gVGVybWluYXRlQXBwT3B0aW9uc1xuICogQHByb3BlcnR5IHshc3RyaW5nfSBidW5kbGVJZCBidW5kbGUgaWRlbnRpZmllciBvZiB0aGUgYXBwIHRvIGJlIHRlcm1pbmF0ZWRcbiAqL1xuXG4vKipcbiAqIFRlcm1pbmF0ZSBhbiBhcHAgd2l0aCBnaXZlbiBidW5kbGUgaWRlbnRpZmllci4gQW4gZXhjZXB0aW9uIGlzIHRocm93biBpZiB0aGVcbiAqIGFwcCBjYW5ub3QgYmUgZm91bmQuXG4gKlxuICogQHBhcmFtIHtUZXJtaW5hdGVBcHBPcHRpb25zfSBvcHRzXG4gKiBAcmV0dXJucyB7Ym9vbGVhbn0gYHRydWVgIGlmIHRoZSBhcHAgd2FzIHJ1bm5pbmcgYW5kIGhhcyBiZWVuIHN1Y2Nlc3NmdWxseSB0ZXJtaW5hdGVkLlxuICogYGZhbHNlYCBpZiB0aGUgYXBwIHdhcyBub3QgcnVubmluZyBiZWZvcmUuXG4gKi9cbmNvbW1hbmRzLm1hY29zVGVybWluYXRlQXBwID0gYXN5bmMgZnVuY3Rpb24gbWFjb3NUZXJtaW5hdGVBcHAgKG9wdHMgPSB7fSkge1xuICBjb25zdCB7IGJ1bmRsZUlkIH0gPSBvcHRzO1xuICByZXR1cm4gYXdhaXQgdGhpcy53ZGEucHJveHkuY29tbWFuZCgnL3dkYS9hcHBzL3Rlcm1pbmF0ZScsICdQT1NUJywgeyBidW5kbGVJZCB9KTtcbn07XG5cbi8qKlxuICogQHR5cGVkZWYge09iamVjdH0gUXVlcnlBcHBTdGF0ZU9wdGlvbnNcbiAqIEBwcm9wZXJ0eSB7IXN0cmluZ30gYnVuZGxlSWQgYnVuZGxlIGlkZW50aWZpZXIgb2YgdGhlIGFwcCB3aG9zZSBzdGF0ZSBzaG91bGQgYmUgcXVlcmllZFxuICovXG5cbi8qKlxuICogUXVlcnkgYW4gYXBwIHN0YXRlIHdpdGggZ2l2ZW4gYnVuZGxlIGlkZW50aWZpZXIuIEFuIGV4Y2VwdGlvbiBpcyB0aHJvd24gaWYgdGhlXG4gKiBhcHAgY2Fubm90IGJlIGZvdW5kLlxuICpcbiAqIEBwYXJhbSB7UXVlcnlBcHBTdGF0ZU9wdGlvbnN9IG9wdHNcbiAqIEByZXR1cm5zIHtudW1iZXJ9IFRoZSBhcHBsaWNhdGlvbiBzdGF0ZSBjb2RlLiBTZWVcbiAqIGh0dHBzOi8vZGV2ZWxvcGVyLmFwcGxlLmNvbS9kb2N1bWVudGF0aW9uL3hjdGVzdC94Y3VpYXBwbGljYXRpb25zdGF0ZT9sYW5ndWFnZT1vYmpjXG4gKiBmb3IgbW9yZSBkZXRhaWxzXG4gKi9cbmNvbW1hbmRzLm1hY29zUXVlcnlBcHBTdGF0ZSA9IGFzeW5jIGZ1bmN0aW9uIG1hY29zUXVlcnlBcHBTdGF0ZSAob3B0cyA9IHt9KSB7XG4gIGNvbnN0IHsgYnVuZGxlSWQgfSA9IG9wdHM7XG4gIHJldHVybiBhd2FpdCB0aGlzLndkYS5wcm94eS5jb21tYW5kKCcvd2RhL2FwcHMvc3RhdGUnLCAnUE9TVCcsIHsgYnVuZGxlSWQgfSk7XG59O1xuXG5leHBvcnQgZGVmYXVsdCBjb21tYW5kcztcbiJdLCJtYXBwaW5ncyI6Ijs7Ozs7OztBQUFBLE1BQU1BLFFBQVEsR0FBRyxDQUFDLENBQUM7QUFvQm5CQSxRQUFRLENBQUNDLGNBQWMsR0FBRyxlQUFlQSxjQUFjQSxDQUFFQyxJQUFJLEdBQUcsQ0FBQyxDQUFDLEVBQUU7RUFDbEUsTUFBTTtJQUFFQyxRQUFRO0lBQUVDO0VBQVksQ0FBQyxHQUFHRixJQUFJO0VBQ3RDLE9BQU8sTUFBTSxJQUFJLENBQUNHLEdBQUcsQ0FBQ0MsS0FBSyxDQUFDQyxPQUFPLENBQUMsa0JBQWtCLEVBQUUsTUFBTSxFQUFFO0lBQzlEQyxTQUFTLEVBQUVOLElBQUksQ0FBQ00sU0FBUztJQUN6QkosV0FBVztJQUNYRDtFQUNGLENBQUMsQ0FBQztBQUNKLENBQUM7QUFhREgsUUFBUSxDQUFDUyxnQkFBZ0IsR0FBRyxlQUFlQSxnQkFBZ0JBLENBQUVQLElBQUksR0FBRyxDQUFDLENBQUMsRUFBRTtFQUN0RSxNQUFNO0lBQUVDO0VBQVMsQ0FBQyxHQUFHRCxJQUFJO0VBQ3pCLE9BQU8sTUFBTSxJQUFJLENBQUNHLEdBQUcsQ0FBQ0MsS0FBSyxDQUFDQyxPQUFPLENBQUMsb0JBQW9CLEVBQUUsTUFBTSxFQUFFO0lBQUVKO0VBQVMsQ0FBQyxDQUFDO0FBQ2pGLENBQUM7QUFlREgsUUFBUSxDQUFDVSxpQkFBaUIsR0FBRyxlQUFlQSxpQkFBaUJBLENBQUVSLElBQUksR0FBRyxDQUFDLENBQUMsRUFBRTtFQUN4RSxNQUFNO0lBQUVDO0VBQVMsQ0FBQyxHQUFHRCxJQUFJO0VBQ3pCLE9BQU8sTUFBTSxJQUFJLENBQUNHLEdBQUcsQ0FBQ0MsS0FBSyxDQUFDQyxPQUFPLENBQUMscUJBQXFCLEVBQUUsTUFBTSxFQUFFO0lBQUVKO0VBQVMsQ0FBQyxDQUFDO0FBQ2xGLENBQUM7QUFnQkRILFFBQVEsQ0FBQ1csa0JBQWtCLEdBQUcsZUFBZUEsa0JBQWtCQSxDQUFFVCxJQUFJLEdBQUcsQ0FBQyxDQUFDLEVBQUU7RUFDMUUsTUFBTTtJQUFFQztFQUFTLENBQUMsR0FBR0QsSUFBSTtFQUN6QixPQUFPLE1BQU0sSUFBSSxDQUFDRyxHQUFHLENBQUNDLEtBQUssQ0FBQ0MsT0FBTyxDQUFDLGlCQUFpQixFQUFFLE1BQU0sRUFBRTtJQUFFSjtFQUFTLENBQUMsQ0FBQztBQUM5RSxDQUFDO0FBQUMsSUFBQVMsUUFBQSxHQUVhWixRQUFRO0FBQUFhLE9BQUEsQ0FBQUMsT0FBQSxHQUFBRixRQUFBIn0=
+exports.default = commands;
+//# sourceMappingURL=app-management.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"app-management.js","names":["commands","macosLaunchApp","opts","bundleId","environment","wda","proxy","command","arguments","macosActivateApp","macosTerminateApp","macosQueryAppState","_default","exports","default"],"sources":["../../../lib/commands/app-management.js"],"sourcesContent":["const commands = {};\n\n/**\n * @typedef {Object} LaunchAppOptions\n * @property {!string} bundleId bundle identifier of the app to be launched\n * or activated\n * @property {?Array<string>} arguments the list of command line arguments\n * for the app to be be launched with. This parameter is ignored if the app\n * is already running.\n * @property {Object} environment environment variables mapping. Custom\n * variables are added to the default process environment.\n */\n\n/**\n * Start an app with given bundle identifier or activates it\n * if the app is already running. An exception is thrown if the\n * app with the given identifier cannot be found.\n *\n * @param {LaunchAppOptions} opts\n */\ncommands.macosLaunchApp = async function macosLaunchApp (opts = {}) {\n  const { bundleId, environment } = opts;\n  return await this.wda.proxy.command('/wda/apps/launch', 'POST', {\n    arguments: opts.arguments,\n    environment,\n    bundleId,\n  });\n};\n\n/**\n * @typedef {Object} ActivateAppOptions\n * @property {!string} bundleId bundle identifier of the app to be activated\n */\n\n/**\n * Activate an app with given bundle identifier. An exception is thrown if the\n * app cannot be found or is not running.\n *\n * @param {ActivateAppOptions} opts\n */\ncommands.macosActivateApp = async function macosActivateApp (opts = {}) {\n  const { bundleId } = opts;\n  return await this.wda.proxy.command('/wda/apps/activate', 'POST', { bundleId });\n};\n\n/**\n * @typedef {Object} TerminateAppOptions\n * @property {!string} bundleId bundle identifier of the app to be terminated\n */\n\n/**\n * Terminate an app with given bundle identifier. An exception is thrown if the\n * app cannot be found.\n *\n * @param {TerminateAppOptions} opts\n * @returns {boolean} `true` if the app was running and has been successfully terminated.\n * `false` if the app was not running before.\n */\ncommands.macosTerminateApp = async function macosTerminateApp (opts = {}) {\n  const { bundleId } = opts;\n  return await this.wda.proxy.command('/wda/apps/terminate', 'POST', { bundleId });\n};\n\n/**\n * @typedef {Object} QueryAppStateOptions\n * @property {!string} bundleId bundle identifier of the app whose state should be queried\n */\n\n/**\n * Query an app state with given bundle identifier. An exception is thrown if the\n * app cannot be found.\n *\n * @param {QueryAppStateOptions} opts\n * @returns {number} The application state code. See\n * https://developer.apple.com/documentation/xctest/xcuiapplicationstate?language=objc\n * for more details\n */\ncommands.macosQueryAppState = async function macosQueryAppState (opts = {}) {\n  const { bundleId } = opts;\n  return await this.wda.proxy.command('/wda/apps/state', 'POST', { bundleId });\n};\n\nexport default commands;\n"],"mappings":";;;;;;;AAAA,MAAMA,QAAQ,GAAG,CAAC,CAAC;AAoBnBA,QAAQ,CAACC,cAAc,GAAG,eAAeA,cAAcA,CAAEC,IAAI,GAAG,CAAC,CAAC,EAAE;EAClE,MAAM;IAAEC,QAAQ;IAAEC;EAAY,CAAC,GAAGF,IAAI;EACtC,OAAO,MAAM,IAAI,CAACG,GAAG,CAACC,KAAK,CAACC,OAAO,CAAC,kBAAkB,EAAE,MAAM,EAAE;IAC9DC,SAAS,EAAEN,IAAI,CAACM,SAAS;IACzBJ,WAAW;IACXD;EACF,CAAC,CAAC;AACJ,CAAC;AAaDH,QAAQ,CAACS,gBAAgB,GAAG,eAAeA,gBAAgBA,CAAEP,IAAI,GAAG,CAAC,CAAC,EAAE;EACtE,MAAM;IAAEC;EAAS,CAAC,GAAGD,IAAI;EACzB,OAAO,MAAM,IAAI,CAACG,GAAG,CAACC,KAAK,CAACC,OAAO,CAAC,oBAAoB,EAAE,MAAM,EAAE;IAAEJ;EAAS,CAAC,CAAC;AACjF,CAAC;AAeDH,QAAQ,CAACU,iBAAiB,GAAG,eAAeA,iBAAiBA,CAAER,IAAI,GAAG,CAAC,CAAC,EAAE;EACxE,MAAM;IAAEC;EAAS,CAAC,GAAGD,IAAI;EACzB,OAAO,MAAM,IAAI,CAACG,GAAG,CAACC,KAAK,CAACC,OAAO,CAAC,qBAAqB,EAAE,MAAM,EAAE;IAAEJ;EAAS,CAAC,CAAC;AAClF,CAAC;AAgBDH,QAAQ,CAACW,kBAAkB,GAAG,eAAeA,kBAAkBA,CAAET,IAAI,GAAG,CAAC,CAAC,EAAE;EAC1E,MAAM;IAAEC;EAAS,CAAC,GAAGD,IAAI;EACzB,OAAO,MAAM,IAAI,CAACG,GAAG,CAACC,KAAK,CAACC,OAAO,CAAC,iBAAiB,EAAE,MAAM,EAAE;IAAEJ;EAAS,CAAC,CAAC;AAC9E,CAAC;AAAC,IAAAS,QAAA,GAEaZ,QAAQ;AAAAa,OAAA,CAAAC,OAAA,GAAAF,QAAA"}
+{"version":3,"file":"app-management.js","sourceRoot":"","sources":["../../../lib/commands/app-management.js"],"names":[],"mappings":";;AAAA,MAAM,QAAQ,GAAG,EAAE,CAAC;AAEpB;;;;;;;;;GASG;AAEH;;;;;;GAMG;AACH,QAAQ,CAAC,cAAc,GAAG,KAAK,UAAU,cAAc,CAAE,IAAI;IAC3D,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC;IAC7C,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,kBAAkB,EAAE,MAAM,EAAE;QAC9D,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,WAAW;QACX,QAAQ;KACT,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;GAGG;AAEH;;;;;GAKG;AACH,QAAQ,CAAC,gBAAgB,GAAG,KAAK,UAAU,gBAAgB,CAAE,IAAI;IAC/D,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC;IAChC,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,oBAAoB,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;AAClF,CAAC,CAAC;AAEF;;;GAGG;AAEH;;;;;;;GAOG;AACH,QAAQ,CAAC,iBAAiB,GAAG,KAAK,UAAU,iBAAiB,CAAE,IAAI;IACjE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC;IAChC,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;AACnF,CAAC,CAAC;AAEF;;;GAGG;AAEH;;;;;;;;GAQG;AACH,QAAQ,CAAC,kBAAkB,GAAG,KAAK,UAAU,kBAAkB,CAAE,IAAI;IACnE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC;IAChC,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,iBAAiB,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC/E,CAAC,CAAC;AAEF,kBAAe,QAAQ,CAAC"}

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

@@ -0,0 +1,57 @@
+export default commands;
+export type ExecAppleScriptOptions = {
+    /**
+     * A valid AppleScript to execute
+     */
+    script: string;
+    /**
+     * Overrides the scripting language. Basically, sets the value of `-l` command
+     * line argument of `osascript` tool. If unset the AppleScript language is assumed.
+     */
+    language: string;
+    /**
+     * A valid AppleScript as a single command (no line breaks) to execute
+     */
+    command: string;
+    /**
+     * [20000] 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.
+     */
+    timeout: number;
+    /**
+     * The path to an existing folder, which is going to be set as the
+     * working directory for the command/script being executed.
+     */
+    cwd: string;
+};
+export namespace commands {
+    /**
+     * @typedef {Object} ExecAppleScriptOptions
+     * @property {string} script A valid AppleScript to execute
+     * @property {string} language Overrides the scripting language. Basically, sets the value of `-l` command
+     * line argument of `osascript` tool. If unset the AppleScript language is assumed.
+     * @property {string} command A valid AppleScript as a single command (no line breaks) to execute
+     * @property {number} timeout [20000] 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.
+     * @property {string} cwd The path to an existing folder, which is going to be set as the
+     * working directory for the command/script being executed.
+     */
+    /**
+     * 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
+     * then the `command` one gets the priority.
+     * Note that AppleScript command cannot contain line breaks. Consider making it
+     * to a script in such case.
+     * Note that by default AppleScript engine blocks commands/scripts execution if your script
+     * is trying to access some private entities, like cameras or the desktop screen
+     * and no permissions to do it are given to the parent (for example, Appium or Terminal)
+     * process in System Preferences -> Privacy list.
+     *
+     * @param {ExecAppleScriptOptions} opts
+     * @returns {Promise<string>} 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.
+     */
+    function macosExecAppleScript(opts: ExecAppleScriptOptions): Promise<string>;
+}
+//# sourceMappingURL=applescript.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"applescript.d.ts","sourceRoot":"","sources":["../../../lib/commands/applescript.js"],"names":[],"mappings":";;;;;YAYc,MAAM;;;;;cACN,MAAM;;;;aAEN,MAAM;;;;;aACN,MAAM;;;;;SAEN,MAAM;;;IARpB;;;;;;;;;;OAUG;IAEH;;;;;;;;;;;;;;;OAeG;IACH,6EA6CC"}

package/build/lib/commands/applescript.js

@@ -1,67 +1,84 @@
 "use strict";
-
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = exports.commands = void 0;
-require("source-map-support/register");
-var _support = require("appium/support");
-var _teen_process = require("teen_process");
-var _logger = _interopRequireDefault(require("../logger"));
-var _path = _interopRequireDefault(require("path"));
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commands = void 0;
+const support_1 = require("appium/support");
+const teen_process_1 = require("teen_process");
+const logger_1 = __importDefault(require("../logger"));
+const path_1 = __importDefault(require("path"));
 const OSASCRIPT = 'osascript';
 const APPLE_SCRIPT_FEATURE = 'apple_script';
 const commands = {};
 exports.commands = commands;
-commands.macosExecAppleScript = async function macosExecAppleScript(opts = {}) {
-  this.ensureFeatureEnabled(APPLE_SCRIPT_FEATURE);
-  const {
-    script,
-    language,
-    command,
-    cwd,
-    timeout
-  } = opts;
-  if (!script && !command) {
-    _logger.default.errorAndThrow('AppleScript script/command must not be empty');
-  }
-  if (/\n/.test(command)) {
-    _logger.default.errorAndThrow('AppleScript commands cannot contain line breaks');
-  }
-  const shouldRunScript = !command;
-  const args = [];
-  if (language) {
-    args.push('-l', language);
-  }
-  let tmpRoot;
-  try {
-    if (shouldRunScript) {
-      tmpRoot = await _support.tempDir.openDir();
-      const tmpScriptPath = _path.default.resolve(tmpRoot, 'appium_script.scpt');
-      await _support.fs.writeFile(tmpScriptPath, script, 'utf8');
-      args.push(tmpScriptPath);
-    } else {
-      args.push('-e', command);
+/**
+ * @typedef {Object} ExecAppleScriptOptions
+ * @property {string} script A valid AppleScript to execute
+ * @property {string} language Overrides the scripting language. Basically, sets the value of `-l` command
+ * line argument of `osascript` tool. If unset the AppleScript language is assumed.
+ * @property {string} command A valid AppleScript as a single command (no line breaks) to execute
+ * @property {number} timeout [20000] 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.
+ * @property {string} cwd The path to an existing folder, which is going to be set as the
+ * working directory for the command/script being executed.
+ */
+/**
+ * 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
+ * then the `command` one gets the priority.
+ * Note that AppleScript command cannot contain line breaks. Consider making it
+ * to a script in such case.
+ * Note that by default AppleScript engine blocks commands/scripts execution if your script
+ * is trying to access some private entities, like cameras or the desktop screen
+ * and no permissions to do it are given to the parent (for example, Appium or Terminal)
+ * process in System Preferences -> Privacy list.
+ *
+ * @param {ExecAppleScriptOptions} opts
+ * @returns {Promise<string>} 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.
+ */
+commands.macosExecAppleScript = async function macosExecAppleScript(opts) {
+    this.ensureFeatureEnabled(APPLE_SCRIPT_FEATURE);
+    const { script, language, command, cwd, timeout, } = opts ?? {};
+    if (!script && !command) {
+        logger_1.default.errorAndThrow('AppleScript script/command must not be empty');
+    }
+    if (/\n/.test(command)) {
+        logger_1.default.errorAndThrow('AppleScript commands cannot contain line breaks');
+    }
+    // 'command' has priority over 'script'
+    const shouldRunScript = !command;
+    const args = [];
+    if (language) {
+        args.push('-l', language);
     }
-    _logger.default.info(`Running ${OSASCRIPT} with arguments: ${_support.util.quote(args)}`);
+    let tmpRoot;
     try {
-      const {
-        stdout
-      } = await (0, _teen_process.exec)(OSASCRIPT, args, {
-        cwd,
-        timeout
-      });
-      return stdout;
-    } catch (e) {
-      throw new Error(e.stderr || e.message);
+        if (shouldRunScript) {
+            tmpRoot = await support_1.tempDir.openDir();
+            const tmpScriptPath = path_1.default.resolve(tmpRoot, 'appium_script.scpt');
+            await support_1.fs.writeFile(tmpScriptPath, script, 'utf8');
+            args.push(tmpScriptPath);
+        }
+        else {
+            args.push('-e', command);
+        }
+        logger_1.default.info(`Running ${OSASCRIPT} with arguments: ${support_1.util.quote(args)}`);
+        try {
+            const { stdout } = await (0, teen_process_1.exec)(OSASCRIPT, args, { cwd, timeout });
+            return stdout;
+        }
+        catch (e) {
+            throw new Error(e.stderr || e.message);
+        }
     }
-  } finally {
-    if (tmpRoot) {
-      await _support.fs.rimraf(tmpRoot);
+    finally {
+        if (tmpRoot) {
+            await support_1.fs.rimraf(tmpRoot);
+        }
     }
-  }
 };
-var _default = commands;
-exports.default = _default;
-//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJuYW1lcyI6WyJfc3VwcG9ydCIsInJlcXVpcmUiLCJfdGVlbl9wcm9jZXNzIiwiX2xvZ2dlciIsIl9pbnRlcm9wUmVxdWlyZURlZmF1bHQiLCJfcGF0aCIsIk9TQVNDUklQVCIsIkFQUExFX1NDUklQVF9GRUFUVVJFIiwiY29tbWFuZHMiLCJleHBvcnRzIiwibWFjb3NFeGVjQXBwbGVTY3JpcHQiLCJvcHRzIiwiZW5zdXJlRmVhdHVyZUVuYWJsZWQiLCJzY3JpcHQiLCJsYW5ndWFnZSIsImNvbW1hbmQiLCJjd2QiLCJ0aW1lb3V0IiwibG9nIiwiZXJyb3JBbmRUaHJvdyIsInRlc3QiLCJzaG91bGRSdW5TY3JpcHQiLCJhcmdzIiwicHVzaCIsInRtcFJvb3QiLCJ0ZW1wRGlyIiwib3BlbkRpciIsInRtcFNjcmlwdFBhdGgiLCJwYXRoIiwicmVzb2x2ZSIsImZzIiwid3JpdGVGaWxlIiwiaW5mbyIsInV0aWwiLCJxdW90ZSIsInN0ZG91dCIsImV4ZWMiLCJlIiwiRXJyb3IiLCJzdGRlcnIiLCJtZXNzYWdlIiwicmltcmFmIiwiX2RlZmF1bHQiLCJkZWZhdWx0Il0sInNvdXJjZXMiOlsiLi4vLi4vLi4vbGliL2NvbW1hbmRzL2FwcGxlc2NyaXB0LmpzIl0sInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IGZzLCB0ZW1wRGlyLCB1dGlsIH0gZnJvbSAnYXBwaXVtL3N1cHBvcnQnO1xuaW1wb3J0IHsgZXhlYyB9IGZyb20gJ3RlZW5fcHJvY2Vzcyc7XG5pbXBvcnQgbG9nIGZyb20gJy4uL2xvZ2dlcic7XG5pbXBvcnQgcGF0aCBmcm9tICdwYXRoJztcblxuY29uc3QgT1NBU0NSSVBUID0gJ29zYXNjcmlwdCc7XG5jb25zdCBBUFBMRV9TQ1JJUFRfRkVBVFVSRSA9ICdhcHBsZV9zY3JpcHQnO1xuXG5jb25zdCBjb21tYW5kcyA9IHt9O1xuXG4vKipcbiAqIEB0eXBlZGVmIHtPYmplY3R9IEV4ZWNBcHBsZVNjcmlwdE9wdGlvbnNcbiAqIEBwcm9wZXJ0eSB7P3N0cmluZ30gc2NyaXB0IEEgdmFsaWQgQXBwbGVTY3JpcHQgdG8gZXhlY3V0ZVxuICogQHByb3BlcnR5IHs/c3RyaW5nfSBsYW5ndWFnZSBPdmVycmlkZXMgdGhlIHNjcmlwdGluZyBsYW5ndWFnZS4gQmFzaWNhbGx5LCBzZXRzIHRoZSB2YWx1ZSBvZiBgLWxgIGNvbW1hbmRcbiAqIGxpbmUgYXJndW1lbnQgb2YgYG9zYXNjcmlwdGAgdG9vbC4gSWYgdW5zZXQgdGhlIEFwcGxlU2NyaXB0IGxhbmd1YWdlIGlzIGFzc3VtZWQuXG4gKiBAcHJvcGVydHkgez9zdHJpbmd9IGNvbW1hbmQgQSB2YWxpZCBBcHBsZVNjcmlwdCBhcyBhIHNpbmdsZSBjb21tYW5kIChubyBsaW5lIGJyZWFrcykgdG8gZXhlY3V0ZVxuICogQHByb3BlcnR5IHs/bnVtYmVyfSB0aW1lb3V0IFsyMDAwMF0gVGhlIG51bWJlciBvZiBzZWNvbmRzIHRvIHdhaXQgdW50aWwgYSBsb25nLXJ1bm5pbmcgY29tbWFuZCBpc1xuICogZmluaXNoZWQuIEFuIGVycm9yIGlzIHRocm93biBpZiB0aGUgY29tbWFuZCBpcyBzdGlsbCBydW5uaW5nIGFmdGVyIHRoaXMgdGltZW91dCBleHBpcmVzLlxuICogQHByb3BlcnR5IHs/c3RyaW5nfSBjd2QgVGhlIHBhdGggdG8gYW4gZXhpc3RpbmcgZm9sZGVyLCB3aGljaCBpcyBnb2luZyB0byBiZSBzZXQgYXMgdGhlXG4gKiB3b3JraW5nIGRpcmVjdG9yeSBmb3IgdGhlIGNvbW1hbmQvc2NyaXB0IGJlaW5nIGV4ZWN1dGVkLlxuICovXG5cbi8qKlxuICogRXhlY3V0ZXMgdGhlIGdpdmVuIEFwcGxlU2NyaXB0IGNvbW1hbmQgb3IgYSB3aG9sZSBzY3JpcHQgYmFzZWQgb24gdGhlXG4gKiBnaXZlbiBvcHRpb25zLiBFaXRoZXIgb2YgdGhlc2Ugb3B0aW9ucyBtdXN0IGJlIHByb3ZpZGVkLiBJZiBib3RoIGFyZSBwcm92aWRlZFxuICogdGhlbiB0aGUgYGNvbW1hbmRgIG9uZSBnZXRzIHRoZSBwcmlvcml0eS5cbiAqIE5vdGUgdGhhdCBBcHBsZVNjcmlwdCBjb21tYW5kIGNhbm5vdCBjb250YWluIGxpbmUgYnJlYWtzLiBDb25zaWRlciBtYWtpbmcgaXRcbiAqIHRvIGEgc2NyaXB0IGluIHN1Y2ggY2FzZS5cbiAqIE5vdGUgdGhhdCBieSBkZWZhdWx0IEFwcGxlU2NyaXB0IGVuZ2luZSBibG9ja3MgY29tbWFuZHMvc2NyaXB0cyBleGVjdXRpb24gaWYgeW91ciBzY3JpcHRcbiAqIGlzIHRyeWluZyB0byBhY2Nlc3Mgc29tZSBwcml2YXRlIGVudGl0aWVzLCBsaWtlIGNhbWVyYXMgb3IgdGhlIGRlc2t0b3Agc2NyZWVuXG4gKiBhbmQgbm8gcGVybWlzc2lvbnMgdG8gZG8gaXQgYXJlIGdpdmVuIHRvIHRoZSBwYXJlbnQgKGZvciBleGFtcGxlLCBBcHBpdW0gb3IgVGVybWluYWwpXG4gKiBwcm9jZXNzIGluIFN5c3RlbSBQcmVmZXJlbmNlcyAtPiBQcml2YWN5IGxpc3QuXG4gKlxuICogQHBhcmFtIHshRXhlY0FwcGxlU2NyaXB0T3B0aW9uc30gb3B0c1xuICogQHJldHVybnMge3N0cmluZ30gVGhlIGFjdHVhbCBzdGRvdXQgb2YgdGhlIGdpdmVuIGNvbW1hbmQvc2NyaXB0XG4gKiBAdGhyb3dzIHtFcnJvcn0gSWYgdGhlIGV4aXQgY29kZSBvZiB0aGUgZ2l2ZW4gY29tbWFuZC9zY3JpcHQgaXMgbm90IHplcm8uXG4gKiBUaGUgYWN0dWFsIHN0ZGVyciBvdXRwdXQgaXMgc2V0IHRvIHRoZSBlcnJvciBtZXNzYWdlIHZhbHVlLlxuICovXG5jb21tYW5kcy5tYWNvc0V4ZWNBcHBsZVNjcmlwdCA9IGFzeW5jIGZ1bmN0aW9uIG1hY29zRXhlY0FwcGxlU2NyaXB0IChvcHRzID0ge30pIHtcbiAgdGhpcy5lbnN1cmVGZWF0dXJlRW5hYmxlZChBUFBMRV9TQ1JJUFRfRkVBVFVSRSk7XG5cbiAgY29uc3Qge1xuICAgIHNjcmlwdCxcbiAgICBsYW5ndWFnZSxcbiAgICBjb21tYW5kLFxuICAgIGN3ZCxcbiAgICB0aW1lb3V0LFxuICB9ID0gb3B0cztcbiAgaWYgKCFzY3JpcHQgJiYgIWNvbW1hbmQpIHtcbiAgICBsb2cuZXJyb3JBbmRUaHJvdygnQXBwbGVTY3JpcHQgc2NyaXB0L2NvbW1hbmQgbXVzdCBub3QgYmUgZW1wdHknKTtcbiAgfVxuICBpZiAoL1xcbi8udGVzdChjb21tYW5kKSkge1xuICAgIGxvZy5lcnJvckFuZFRocm93KCdBcHBsZVNjcmlwdCBjb21tYW5kcyBjYW5ub3QgY29udGFpbiBsaW5lIGJyZWFrcycpO1xuICB9XG4gIC8vICdjb21tYW5kJyBoYXMgcHJpb3JpdHkgb3ZlciAnc2NyaXB0J1xuICBjb25zdCBzaG91bGRSdW5TY3JpcHQgPSAhY29tbWFuZDtcblxuICBjb25zdCBhcmdzID0gW107XG4gIGlmIChsYW5ndWFnZSkge1xuICAgIGFyZ3MucHVzaCgnLWwnLCBsYW5ndWFnZSk7XG4gIH1cbiAgbGV0IHRtcFJvb3Q7XG4gIHRyeSB7XG4gICAgaWYgKHNob3VsZFJ1blNjcmlwdCkge1xuICAgICAgdG1wUm9vdCA9IGF3YWl0IHRlbXBEaXIub3BlbkRpcigpO1xuICAgICAgY29uc3QgdG1wU2NyaXB0UGF0aCA9IHBhdGgucmVzb2x2ZSh0bXBSb290LCAnYXBwaXVtX3NjcmlwdC5zY3B0Jyk7XG4gICAgICBhd2FpdCBmcy53cml0ZUZpbGUodG1wU2NyaXB0UGF0aCwgc2NyaXB0LCAndXRmOCcpO1xuICAgICAgYXJncy5wdXNoKHRtcFNjcmlwdFBhdGgpO1xuICAgIH0gZWxzZSB7XG4gICAgICBhcmdzLnB1c2goJy1lJywgY29tbWFuZCk7XG4gICAgfVxuICAgIGxvZy5pbmZvKGBSdW5uaW5nICR7T1NBU0NSSVBUfSB3aXRoIGFyZ3VtZW50czogJHt1dGlsLnF1b3RlKGFyZ3MpfWApO1xuICAgIHRyeSB7XG4gICAgICBjb25zdCB7c3Rkb3V0fSA9IGF3YWl0IGV4ZWMoT1NBU0NSSVBULCBhcmdzLCB7Y3dkLCB0aW1lb3V0fSk7XG4gICAgICByZXR1cm4gc3Rkb3V0O1xuICAgIH0gY2F0Y2ggKGUpIHtcbiAgICAgIHRocm93IG5ldyBFcnJvcihlLnN0ZGVyciB8fCBlLm1lc3NhZ2UpO1xuICAgIH1cbiAgfSBmaW5hbGx5IHtcbiAgICBpZiAodG1wUm9vdCkge1xuICAgICAgYXdhaXQgZnMucmltcmFmKHRtcFJvb3QpO1xuICAgIH1cbiAgfVxufTtcblxuZXhwb3J0IHsgY29tbWFuZHMgfTtcbmV4cG9ydCBkZWZhdWx0IGNvbW1hbmRzO1xuIl0sIm1hcHBpbmdzIjoiOzs7Ozs7OztBQUFBLElBQUFBLFFBQUEsR0FBQUMsT0FBQTtBQUNBLElBQUFDLGFBQUEsR0FBQUQsT0FBQTtBQUNBLElBQUFFLE9BQUEsR0FBQUMsc0JBQUEsQ0FBQUgsT0FBQTtBQUNBLElBQUFJLEtBQUEsR0FBQUQsc0JBQUEsQ0FBQUgsT0FBQTtBQUVBLE1BQU1LLFNBQVMsR0FBRyxXQUFXO0FBQzdCLE1BQU1DLG9CQUFvQixHQUFHLGNBQWM7QUFFM0MsTUFBTUMsUUFBUSxHQUFHLENBQUMsQ0FBQztBQUFDQyxPQUFBLENBQUFELFFBQUEsR0FBQUEsUUFBQTtBQThCcEJBLFFBQVEsQ0FBQ0Usb0JBQW9CLEdBQUcsZUFBZUEsb0JBQW9CQSxDQUFFQyxJQUFJLEdBQUcsQ0FBQyxDQUFDLEVBQUU7RUFDOUUsSUFBSSxDQUFDQyxvQkFBb0IsQ0FBQ0wsb0JBQW9CLENBQUM7RUFFL0MsTUFBTTtJQUNKTSxNQUFNO0lBQ05DLFFBQVE7SUFDUkMsT0FBTztJQUNQQyxHQUFHO0lBQ0hDO0VBQ0YsQ0FBQyxHQUFHTixJQUFJO0VBQ1IsSUFBSSxDQUFDRSxNQUFNLElBQUksQ0FBQ0UsT0FBTyxFQUFFO0lBQ3ZCRyxlQUFHLENBQUNDLGFBQWEsQ0FBQyw4Q0FBOEMsQ0FBQztFQUNuRTtFQUNBLElBQUksSUFBSSxDQUFDQyxJQUFJLENBQUNMLE9BQU8sQ0FBQyxFQUFFO0lBQ3RCRyxlQUFHLENBQUNDLGFBQWEsQ0FBQyxpREFBaUQsQ0FBQztFQUN0RTtFQUVBLE1BQU1FLGVBQWUsR0FBRyxDQUFDTixPQUFPO0VBRWhDLE1BQU1PLElBQUksR0FBRyxFQUFFO0VBQ2YsSUFBSVIsUUFBUSxFQUFFO0lBQ1pRLElBQUksQ0FBQ0MsSUFBSSxDQUFDLElBQUksRUFBRVQsUUFBUSxDQUFDO0VBQzNCO0VBQ0EsSUFBSVUsT0FBTztFQUNYLElBQUk7SUFDRixJQUFJSCxlQUFlLEVBQUU7TUFDbkJHLE9BQU8sR0FBRyxNQUFNQyxnQkFBTyxDQUFDQyxPQUFPLENBQUMsQ0FBQztNQUNqQyxNQUFNQyxhQUFhLEdBQUdDLGFBQUksQ0FBQ0MsT0FBTyxDQUFDTCxPQUFPLEVBQUUsb0JBQW9CLENBQUM7TUFDakUsTUFBTU0sV0FBRSxDQUFDQyxTQUFTLENBQUNKLGFBQWEsRUFBRWQsTUFBTSxFQUFFLE1BQU0sQ0FBQztNQUNqRFMsSUFBSSxDQUFDQyxJQUFJLENBQUNJLGFBQWEsQ0FBQztJQUMxQixDQUFDLE1BQU07TUFDTEwsSUFBSSxDQUFDQyxJQUFJLENBQUMsSUFBSSxFQUFFUixPQUFPLENBQUM7SUFDMUI7SUFDQUcsZUFBRyxDQUFDYyxJQUFJLENBQUUsV0FBVTFCLFNBQVUsb0JBQW1CMkIsYUFBSSxDQUFDQyxLQUFLLENBQUNaLElBQUksQ0FBRSxFQUFDLENBQUM7SUFDcEUsSUFBSTtNQUNGLE1BQU07UUFBQ2E7TUFBTSxDQUFDLEdBQUcsTUFBTSxJQUFBQyxrQkFBSSxFQUFDOUIsU0FBUyxFQUFFZ0IsSUFBSSxFQUFFO1FBQUNOLEdBQUc7UUFBRUM7TUFBTyxDQUFDLENBQUM7TUFDNUQsT0FBT2tCLE1BQU07SUFDZixDQUFDLENBQUMsT0FBT0UsQ0FBQyxFQUFFO01BQ1YsTUFBTSxJQUFJQyxLQUFLLENBQUNELENBQUMsQ0FBQ0UsTUFBTSxJQUFJRixDQUFDLENBQUNHLE9BQU8sQ0FBQztJQUN4QztFQUNGLENBQUMsU0FBUztJQUNSLElBQUloQixPQUFPLEVBQUU7TUFDWCxNQUFNTSxXQUFFLENBQUNXLE1BQU0sQ0FBQ2pCLE9BQU8sQ0FBQztJQUMxQjtFQUNGO0FBQ0YsQ0FBQztBQUFDLElBQUFrQixRQUFBLEdBR2FsQyxRQUFRO0FBQUFDLE9BQUEsQ0FBQWtDLE9BQUEsR0FBQUQsUUFBQSJ9
+exports.default = commands;
+//# sourceMappingURL=applescript.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"applescript.js","names":["_support","require","_teen_process","_logger","_interopRequireDefault","_path","OSASCRIPT","APPLE_SCRIPT_FEATURE","commands","exports","macosExecAppleScript","opts","ensureFeatureEnabled","script","language","command","cwd","timeout","log","errorAndThrow","test","shouldRunScript","args","push","tmpRoot","tempDir","openDir","tmpScriptPath","path","resolve","fs","writeFile","info","util","quote","stdout","exec","e","Error","stderr","message","rimraf","_default","default"],"sources":["../../../lib/commands/applescript.js"],"sourcesContent":["import { fs, tempDir, util } from 'appium/support';\nimport { exec } from 'teen_process';\nimport log from '../logger';\nimport path from 'path';\n\nconst OSASCRIPT = 'osascript';\nconst APPLE_SCRIPT_FEATURE = 'apple_script';\n\nconst commands = {};\n\n/**\n * @typedef {Object} ExecAppleScriptOptions\n * @property {?string} script A valid AppleScript to execute\n * @property {?string} language Overrides the scripting language. Basically, sets the value of `-l` command\n * line argument of `osascript` tool. If unset the AppleScript language is assumed.\n * @property {?string} command A valid AppleScript as a single command (no line breaks) to execute\n * @property {?number} timeout [20000] The number of seconds to wait until a long-running command is\n * finished. An error is thrown if the command is still running after this timeout expires.\n * @property {?string} cwd The path to an existing folder, which is going to be set as the\n * working directory for the command/script being executed.\n */\n\n/**\n * Executes the given AppleScript command or a whole script based on the\n * given options. Either of these options must be provided. If both are provided\n * then the `command` one gets the priority.\n * Note that AppleScript command cannot contain line breaks. Consider making it\n * to a script in such case.\n * Note that by default AppleScript engine blocks commands/scripts execution if your script\n * is trying to access some private entities, like cameras or the desktop screen\n * and no permissions to do it are given to the parent (for example, Appium or Terminal)\n * process in System Preferences -> Privacy list.\n *\n * @param {!ExecAppleScriptOptions} opts\n * @returns {string} The actual stdout of the given command/script\n * @throws {Error} If the exit code of the given command/script is not zero.\n * The actual stderr output is set to the error message value.\n */\ncommands.macosExecAppleScript = async function macosExecAppleScript (opts = {}) {\n  this.ensureFeatureEnabled(APPLE_SCRIPT_FEATURE);\n\n  const {\n    script,\n    language,\n    command,\n    cwd,\n    timeout,\n  } = opts;\n  if (!script && !command) {\n    log.errorAndThrow('AppleScript script/command must not be empty');\n  }\n  if (/\\n/.test(command)) {\n    log.errorAndThrow('AppleScript commands cannot contain line breaks');\n  }\n  // 'command' has priority over 'script'\n  const shouldRunScript = !command;\n\n  const args = [];\n  if (language) {\n    args.push('-l', language);\n  }\n  let tmpRoot;\n  try {\n    if (shouldRunScript) {\n      tmpRoot = await tempDir.openDir();\n      const tmpScriptPath = path.resolve(tmpRoot, 'appium_script.scpt');\n      await fs.writeFile(tmpScriptPath, script, 'utf8');\n      args.push(tmpScriptPath);\n    } else {\n      args.push('-e', command);\n    }\n    log.info(`Running ${OSASCRIPT} with arguments: ${util.quote(args)}`);\n    try {\n      const {stdout} = await exec(OSASCRIPT, args, {cwd, timeout});\n      return stdout;\n    } catch (e) {\n      throw new Error(e.stderr || e.message);\n    }\n  } finally {\n    if (tmpRoot) {\n      await fs.rimraf(tmpRoot);\n    }\n  }\n};\n\nexport { commands };\nexport default commands;\n"],"mappings":";;;;;;;;AAAA,IAAAA,QAAA,GAAAC,OAAA;AACA,IAAAC,aAAA,GAAAD,OAAA;AACA,IAAAE,OAAA,GAAAC,sBAAA,CAAAH,OAAA;AACA,IAAAI,KAAA,GAAAD,sBAAA,CAAAH,OAAA;AAEA,MAAMK,SAAS,GAAG,WAAW;AAC7B,MAAMC,oBAAoB,GAAG,cAAc;AAE3C,MAAMC,QAAQ,GAAG,CAAC,CAAC;AAACC,OAAA,CAAAD,QAAA,GAAAA,QAAA;AA8BpBA,QAAQ,CAACE,oBAAoB,GAAG,eAAeA,oBAAoBA,CAAEC,IAAI,GAAG,CAAC,CAAC,EAAE;EAC9E,IAAI,CAACC,oBAAoB,CAACL,oBAAoB,CAAC;EAE/C,MAAM;IACJM,MAAM;IACNC,QAAQ;IACRC,OAAO;IACPC,GAAG;IACHC;EACF,CAAC,GAAGN,IAAI;EACR,IAAI,CAACE,MAAM,IAAI,CAACE,OAAO,EAAE;IACvBG,eAAG,CAACC,aAAa,CAAC,8CAA8C,CAAC;EACnE;EACA,IAAI,IAAI,CAACC,IAAI,CAACL,OAAO,CAAC,EAAE;IACtBG,eAAG,CAACC,aAAa,CAAC,iDAAiD,CAAC;EACtE;EAEA,MAAME,eAAe,GAAG,CAACN,OAAO;EAEhC,MAAMO,IAAI,GAAG,EAAE;EACf,IAAIR,QAAQ,EAAE;IACZQ,IAAI,CAACC,IAAI,CAAC,IAAI,EAAET,QAAQ,CAAC;EAC3B;EACA,IAAIU,OAAO;EACX,IAAI;IACF,IAAIH,eAAe,EAAE;MACnBG,OAAO,GAAG,MAAMC,gBAAO,CAACC,OAAO,CAAC,CAAC;MACjC,MAAMC,aAAa,GAAGC,aAAI,CAACC,OAAO,CAACL,OAAO,EAAE,oBAAoB,CAAC;MACjE,MAAMM,WAAE,CAACC,SAAS,CAACJ,aAAa,EAAEd,MAAM,EAAE,MAAM,CAAC;MACjDS,IAAI,CAACC,IAAI,CAACI,aAAa,CAAC;IAC1B,CAAC,MAAM;MACLL,IAAI,CAACC,IAAI,CAAC,IAAI,EAAER,OAAO,CAAC;IAC1B;IACAG,eAAG,CAACc,IAAI,CAAE,WAAU1B,SAAU,oBAAmB2B,aAAI,CAACC,KAAK,CAACZ,IAAI,CAAE,EAAC,CAAC;IACpE,IAAI;MACF,MAAM;QAACa;MAAM,CAAC,GAAG,MAAM,IAAAC,kBAAI,EAAC9B,SAAS,EAAEgB,IAAI,EAAE;QAACN,GAAG;QAAEC;MAAO,CAAC,CAAC;MAC5D,OAAOkB,MAAM;IACf,CAAC,CAAC,OAAOE,CAAC,EAAE;MACV,MAAM,IAAIC,KAAK,CAACD,CAAC,CAACE,MAAM,IAAIF,CAAC,CAACG,OAAO,CAAC;IACxC;EACF,CAAC,SAAS;IACR,IAAIhB,OAAO,EAAE;MACX,MAAMM,WAAE,CAACW,MAAM,CAACjB,OAAO,CAAC;IAC1B;EACF;AACF,CAAC;AAAC,IAAAkB,QAAA,GAGalC,QAAQ;AAAAC,OAAA,CAAAkC,OAAA,GAAAD,QAAA"}
+{"version":3,"file":"applescript.js","sourceRoot":"","sources":["../../../lib/commands/applescript.js"],"names":[],"mappings":";;;;;;AAAA,4CAAmD;AACnD,+CAAoC;AACpC,uDAA4B;AAC5B,gDAAwB;AAExB,MAAM,SAAS,GAAG,WAAW,CAAC;AAC9B,MAAM,oBAAoB,GAAG,cAAc,CAAC;AAE5C,MAAM,QAAQ,GAAG,EAAE,CAAC;AA6EX,4BAAQ;AA3EjB;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,QAAQ,CAAC,oBAAoB,GAAG,KAAK,UAAU,oBAAoB,CAAE,IAAI;IACvE,IAAI,CAAC,oBAAoB,CAAC,oBAAoB,CAAC,CAAC;IAEhD,MAAM,EACJ,MAAM,EACN,QAAQ,EACR,OAAO,EACP,GAAG,EACH,OAAO,GACR,GAAG,IAAI,IAAI,EAAE,CAAC;IACf,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE;QACvB,gBAAG,CAAC,aAAa,CAAC,8CAA8C,CAAC,CAAC;KACnE;IACD,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;QACtB,gBAAG,CAAC,aAAa,CAAC,iDAAiD,CAAC,CAAC;KACtE;IACD,uCAAuC;IACvC,MAAM,eAAe,GAAG,CAAC,OAAO,CAAC;IAEjC,MAAM,IAAI,GAAG,EAAE,CAAC;IAChB,IAAI,QAAQ,EAAE;QACZ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;KAC3B;IACD,IAAI,OAAO,CAAC;IACZ,IAAI;QACF,IAAI,eAAe,EAAE;YACnB,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;SAC1B;aAAM;YACL,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;SAC1B;QACD,gBAAG,CAAC,IAAI,CAAC,WAAW,SAAS,oBAAoB,cAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrE,IAAI;YACF,MAAM,EAAC,MAAM,EAAC,GAAG,MAAM,IAAA,mBAAI,EAAC,SAAS,EAAE,IAAI,EAAE,EAAC,GAAG,EAAE,OAAO,EAAC,CAAC,CAAC;YAC7D,OAAO,MAAM,CAAC;SACf;QAAC,OAAO,CAAC,EAAE;YACV,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC;SACxC;KACF;YAAS;QACR,IAAI,OAAO,EAAE;YACX,MAAM,YAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;SAC1B;KACF;AACH,CAAC,CAAC;AAGF,kBAAe,QAAQ,CAAC"}

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

@@ -0,0 +1,6 @@
+export default commands;
+declare namespace commands {
+    function execute(script: any, args: any): Promise<any>;
+    function executeMacosCommand(command: any, opts?: {}): Promise<any>;
+}
+//# sourceMappingURL=execute.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../lib/commands/execute.js"],"names":[],"mappings":";;IAuCA,uDAOC;IAED,oEAMC"}