node-devicectl 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -0,0 +1,21 @@
+## [1.1.0](https://github.com/appium/node-devicectl/compare/v1.0.1...v1.1.0) (2025-11-02)
+
+### Features
+
+* Add a possibility to list connected devices ([#3](https://github.com/appium/node-devicectl/issues/3)) ([ffce717](https://github.com/appium/node-devicectl/commit/ffce717c46d314f221bbc33b4b4ad363562b7c3c))
+
+## [1.0.1](https://github.com/appium/node-devicectl/compare/v1.0.0...v1.0.1) (2025-10-23)
+
+### Miscellaneous Chores
+
+* Prettify ([0b44180](https://github.com/appium/node-devicectl/commit/0b441806c2803231861260424bc82f2fb3a42224))
+
+## 1.0.0 (2025-10-23)
+
+### Features
+
+* Initial release ([#1](https://github.com/appium/node-devicectl/issues/1)) ([59ba0bb](https://github.com/appium/node-devicectl/commit/59ba0bb4a002b21e5b3cdd78a6f7be21362f4ac1))
+
+### Bug Fixes
+
+* Update buidling logic ([#2](https://github.com/appium/node-devicectl/issues/2)) ([2b6dbd5](https://github.com/appium/node-devicectl/commit/2b6dbd50878940e60152e3850b8d7aa480663bb0))

package/build/lib/devicectl.d.ts

@@ -0,0 +1,39 @@
+import type { ExecuteOptions, ExecuteResult } from './types';
+import * as processMixins from './mixins/process';
+import * as infoMixins from './mixins/info';
+import * as copyMixins from './mixins/copy';
+import * as listMixins from './mixins/list';
+/**
+ * Node.js wrapper around Apple's devicectl tool
+ *
+ * This class provides methods to interact with iOS devices using the devicectl command-line tool.
+ * It requires Xcode 15+ and iOS 17+ to function properly.
+ *
+ */
+export declare class Devicectl {
+    /** The unique device identifier */
+    readonly udid: string;
+    /**
+     * Creates a new Devicectl instance
+     *
+     * @param udid - The unique device identifier
+     */
+    constructor(udid: string);
+    /**
+     * Executes a devicectl command
+     *
+     * @param subcommand - The devicectl subcommand to execute
+     * @param opts - Execution options
+     * @returns Promise that resolves to the command result
+     */
+    execute<T extends ExecuteOptions>(subcommand: string[], opts?: T): Promise<ExecuteResult<T>>;
+    sendMemoryWarning: typeof processMixins.sendMemoryWarning;
+    sendSignalToProcess: typeof processMixins.sendSignalToProcess;
+    launchApp: typeof processMixins.launchApp;
+    listProcesses: typeof infoMixins.listProcesses;
+    listApps: typeof infoMixins.listApps;
+    listFiles: typeof copyMixins.listFiles;
+    pullFile: typeof copyMixins.pullFile;
+    listDevices: typeof listMixins.listDevices;
+}
+//# sourceMappingURL=devicectl.d.ts.map

package/build/lib/devicectl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devicectl.d.ts","sourceRoot":"","sources":["../../lib/devicectl.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,cAAc,EAAE,aAAa,EAAC,MAAM,SAAS,CAAC;AAC3D,OAAO,KAAK,aAAa,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,UAAU,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,UAAU,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,UAAU,MAAM,eAAe,CAAC;AAK5C;;;;;;GAMG;AACH,qBAAa,SAAS;IACpB,mCAAmC;IACnC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B;;;;OAIG;gBACS,IAAI,EAAE,MAAM;IAIxB;;;;;;OAMG;IACG,OAAO,CAAC,CAAC,SAAS,cAAc,EACpC,UAAU,EAAE,MAAM,EAAE,EACpB,IAAI,CAAC,EAAE,CAAC,GACP,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IA4C5B,iBAAiB,yCAAmC;IACpD,mBAAmB,2CAAqC;IACxD,SAAS,iCAA2B;IAEpC,aAAa,kCAA4B;IACzC,QAAQ,6BAAuB;IAE/B,SAAS,8BAAwB;IACjC,QAAQ,6BAAuB;IAE/B,WAAW,gCAA0B;CACtC"}

package/build/lib/devicectl.js

@@ -0,0 +1,111 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Devicectl = void 0;
+const teen_process_1 = require("teen_process");
+const lodash_1 = __importDefault(require("lodash"));
+const logger_1 = __importDefault(require("@appium/logger"));
+const processMixins = __importStar(require("./mixins/process"));
+const infoMixins = __importStar(require("./mixins/info"));
+const copyMixins = __importStar(require("./mixins/copy"));
+const listMixins = __importStar(require("./mixins/list"));
+const XCRUN = 'xcrun';
+const LOG_TAG = 'Devicectl';
+/**
+ * Node.js wrapper around Apple's devicectl tool
+ *
+ * This class provides methods to interact with iOS devices using the devicectl command-line tool.
+ * It requires Xcode 15+ and iOS 17+ to function properly.
+ *
+ */
+class Devicectl {
+    /** The unique device identifier */
+    udid;
+    /**
+     * Creates a new Devicectl instance
+     *
+     * @param udid - The unique device identifier
+     */
+    constructor(udid) {
+        this.udid = udid;
+    }
+    /**
+     * Executes a devicectl command
+     *
+     * @param subcommand - The devicectl subcommand to execute
+     * @param opts - Execution options
+     * @returns Promise that resolves to the command result
+     */
+    async execute(subcommand, opts) {
+        const { logStdout = false, asynchronous = false, asJson = true, noDevice = false, subcommandOptions, timeout, } = opts ?? {};
+        const finalArgs = ['devicectl', ...subcommand, ...(noDevice ? [] : ['--device', this.udid])];
+        if (subcommandOptions && !lodash_1.default.isEmpty(subcommandOptions)) {
+            finalArgs.push(...(Array.isArray(subcommandOptions) ? subcommandOptions : [subcommandOptions]));
+        }
+        if (asJson) {
+            finalArgs.push('--quiet', '--json-output', '-');
+        }
+        const cmdStr = [XCRUN, ...finalArgs].map((arg) => `"${arg}"`).join(' ');
+        logger_1.default.debug(LOG_TAG, `Executing ${cmdStr}`);
+        try {
+            if (asynchronous) {
+                const result = new teen_process_1.SubProcess(XCRUN, finalArgs);
+                await result.start(0);
+                return result;
+            }
+            const result = await (0, teen_process_1.exec)(XCRUN, finalArgs, ...(lodash_1.default.isNumber(timeout) ? [{ timeout }] : []));
+            if (logStdout) {
+                logger_1.default.debug(LOG_TAG, `Command output: ${result.stdout}`);
+            }
+            return result;
+        }
+        catch (e) {
+            throw new Error(`'${cmdStr}' failed. Original error: ${e.stderr || e.stdout || e.message}`);
+        }
+    }
+    sendMemoryWarning = processMixins.sendMemoryWarning;
+    sendSignalToProcess = processMixins.sendSignalToProcess;
+    launchApp = processMixins.launchApp;
+    listProcesses = infoMixins.listProcesses;
+    listApps = infoMixins.listApps;
+    listFiles = copyMixins.listFiles;
+    pullFile = copyMixins.pullFile;
+    listDevices = listMixins.listDevices;
+}
+exports.Devicectl = Devicectl;
+//# sourceMappingURL=devicectl.js.map

package/build/lib/devicectl.js.map

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

package/build/lib/index.d.ts

@@ -0,0 +1,3 @@
+export { Devicectl } from './devicectl';
+export type * from './types';
+//# sourceMappingURL=index.d.ts.map

package/build/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,aAAa,CAAC;AACtC,mBAAmB,SAAS,CAAC"}

package/build/lib/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Devicectl = void 0;
+var devicectl_1 = require("./devicectl");
+Object.defineProperty(exports, "Devicectl", { enumerable: true, get: function () { return devicectl_1.Devicectl; } });
+//# sourceMappingURL=index.js.map

package/build/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/index.ts"],"names":[],"mappings":";;;AAAA,yCAAsC;AAA9B,sGAAA,SAAS,OAAA"}

package/build/lib/mixins/copy.d.ts

@@ -0,0 +1,11 @@
+import type { ListFilesOptions, PullFileOptions } from '../types';
+import type { Devicectl } from '../devicectl';
+/**
+ * Lists files at a specified path on the device
+ */
+export declare function listFiles(this: Devicectl, domainType: string, domainIdentifier: string, opts?: ListFilesOptions): Promise<string[]>;
+/**
+ * Pulls a file from the specified path on the device to a local file system
+ */
+export declare function pullFile(this: Devicectl, from: string, to: string, opts: PullFileOptions): Promise<string>;
+//# sourceMappingURL=copy.d.ts.map

package/build/lib/mixins/copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy.d.ts","sourceRoot":"","sources":["../../../lib/mixins/copy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,gBAAgB,EAAE,eAAe,EAAC,MAAM,UAAU,CAAC;AAChE,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAE5C;;GAEG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,SAAS,EACf,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,MAAM,EACxB,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,MAAM,EAAE,CAAC,CAgBnB;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,MAAM,CAAC,CAuBjB"}

package/build/lib/mixins/copy.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listFiles = listFiles;
+exports.pullFile = pullFile;
+/**
+ * Lists files at a specified path on the device
+ */
+async function listFiles(domainType, domainIdentifier, opts = {}) {
+    const subcommandOptions = ['--domain-type', domainType, '--domain-identifier', domainIdentifier];
+    if (opts.username) {
+        subcommandOptions.push('--username', opts.username);
+    }
+    if (opts.subdirectory) {
+        subcommandOptions.push('--subdirectory', opts.subdirectory);
+    }
+    const { stdout } = await this.execute(['device', 'info', 'files'], {
+        subcommandOptions,
+    });
+    return JSON.parse(stdout).result.files.map(({ name }) => name);
+}
+/**
+ * Pulls a file from the specified path on the device to a local file system
+ */
+async function pullFile(from, to, opts) {
+    const subcommandOptions = [
+        '--domain-type',
+        opts.domainType,
+        '--domain-identifier',
+        opts.domainIdentifier,
+        '--source',
+        from,
+        '--destination',
+        to,
+    ];
+    if (opts.username) {
+        subcommandOptions.push('--user', opts.username);
+    }
+    await this.execute(['device', 'copy', 'from'], {
+        subcommandOptions,
+        timeout: opts.timeout ?? 120000,
+        asJson: false,
+    });
+    return to;
+}
+//# sourceMappingURL=copy.js.map

package/build/lib/mixins/copy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy.js","sourceRoot":"","sources":["../../../lib/mixins/copy.ts"],"names":[],"mappings":";;AAMA,8BAqBC;AAKD,4BA4BC;AAzDD;;GAEG;AACI,KAAK,UAAU,SAAS,CAE7B,UAAkB,EAClB,gBAAwB,EACxB,OAAyB,EAAE;IAE3B,MAAM,iBAAiB,GAAG,CAAC,eAAe,EAAE,UAAU,EAAE,qBAAqB,EAAE,gBAAgB,CAAC,CAAC;IAEjG,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,iBAAiB,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,iBAAiB,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,EAAC,MAAM,EAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAC/D,iBAAiB;KAClB,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAC,IAAI,EAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;AAC/E,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,QAAQ,CAE5B,IAAY,EACZ,EAAU,EACV,IAAqB;IAErB,MAAM,iBAAiB,GAAG;QACxB,eAAe;QACf,IAAI,CAAC,UAAU;QACf,qBAAqB;QACrB,IAAI,CAAC,gBAAgB;QACrB,UAAU;QACV,IAAI;QACJ,eAAe;QACf,EAAE;KACH,CAAC;IAEF,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,iBAAiB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QAC7C,iBAAiB;QACjB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,MAAM;QAC/B,MAAM,EAAE,KAAK;KACd,CAAC,CAAC;IAEH,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/build/lib/mixins/info.d.ts

@@ -0,0 +1,11 @@
+import type { AppInfo, ProcessInfo } from '../types';
+import type { Devicectl } from '../devicectl';
+/**
+ * Retrieves the list of installed apps from the device
+ */
+export declare function listApps(this: Devicectl, bundleId?: string): Promise<AppInfo[]>;
+/**
+ * Lists running processes on the device
+ */
+export declare function listProcesses(this: Devicectl): Promise<ProcessInfo[]>;
+//# sourceMappingURL=info.d.ts.map

package/build/lib/mixins/info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../../lib/mixins/info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,OAAO,EAAE,WAAW,EAAC,MAAM,UAAU,CAAC;AACnD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAE5C;;GAEG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAYrF;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAG3E"}

package/build/lib/mixins/info.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listApps = listApps;
+exports.listProcesses = listProcesses;
+/**
+ * Retrieves the list of installed apps from the device
+ */
+async function listApps(bundleId) {
+    const subcommandOptions = ['--include-all-apps'];
+    if (bundleId) {
+        subcommandOptions.push('--bundle-id', bundleId);
+    }
+    const { stdout } = await this.execute(['device', 'info', 'apps'], {
+        subcommandOptions,
+    });
+    return JSON.parse(stdout).result.apps;
+}
+/**
+ * Lists running processes on the device
+ */
+async function listProcesses() {
+    const { stdout } = await this.execute(['device', 'info', 'processes']);
+    return JSON.parse(stdout).result.runningProcesses;
+}
+//# sourceMappingURL=info.js.map

package/build/lib/mixins/info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.js","sourceRoot":"","sources":["../../../lib/mixins/info.ts"],"names":[],"mappings":";;AAMA,4BAYC;AAKD,sCAGC;AAvBD;;GAEG;AACI,KAAK,UAAU,QAAQ,CAAkB,QAAiB;IAC/D,MAAM,iBAAiB,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAEjD,IAAI,QAAQ,EAAE,CAAC;QACb,iBAAiB,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,EAAC,MAAM,EAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QAC9D,iBAAiB;KAClB,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;AACxC,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,aAAa;IACjC,MAAM,EAAC,MAAM,EAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IACrE,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC;AACpD,CAAC"}

package/build/lib/mixins/list.d.ts

@@ -0,0 +1,8 @@
+import type { DeviceInfo } from '../types';
+import type { Devicectl } from '../devicectl';
+/**
+ * Retrieves the list of connected device infos.
+ * Might be empty if no devices are connected.
+ */
+export declare function listDevices(this: Devicectl): Promise<DeviceInfo[]>;
+//# sourceMappingURL=list.d.ts.map

package/build/lib/mixins/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../lib/mixins/list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAE5C;;;GAGG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAKxE"}

package/build/lib/mixins/list.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listDevices = listDevices;
+/**
+ * Retrieves the list of connected device infos.
+ * Might be empty if no devices are connected.
+ */
+async function listDevices() {
+    const { stdout } = await this.execute(['list', 'devices'], {
+        noDevice: true,
+    });
+    return JSON.parse(stdout).result.devices;
+}
+//# sourceMappingURL=list.js.map

package/build/lib/mixins/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../lib/mixins/list.ts"],"names":[],"mappings":";;AAOA,kCAKC;AATD;;;GAGG;AACI,KAAK,UAAU,WAAW;IAC/B,MAAM,EAAC,MAAM,EAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE;QACvD,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;AAC3C,CAAC"}

package/build/lib/mixins/process.d.ts

@@ -0,0 +1,17 @@
+import type { LaunchAppOptions } from '../types';
+import type { Devicectl } from '../devicectl';
+/**
+ * Simulates memory warning for the process with the given PID
+ */
+export declare function sendMemoryWarning(this: Devicectl, pid: number | string): Promise<void>;
+/**
+ * Send POSIX signal to the running process
+ */
+export declare function sendSignalToProcess(this: Devicectl, pid: number | string, signal: number | string): Promise<void>;
+/**
+ * Launch the given bundle id application with the given environment variable.
+ * This method is over devicectl command, this it may take additional seconds to launch the app.
+ * Please use via WDA or via appium-ios-device as primary method to launch app if possible.
+ */
+export declare function launchApp(this: Devicectl, bundleId: string, opts?: LaunchAppOptions): Promise<void>;
+//# sourceMappingURL=process.d.ts.map

package/build/lib/mixins/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../../lib/mixins/process.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAE5C;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI5F;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,SAAS,EACf,GAAG,EAAE,MAAM,GAAG,MAAM,EACpB,MAAM,EAAE,MAAM,GAAG,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAwBf"}

package/build/lib/mixins/process.js

@@ -0,0 +1,48 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendMemoryWarning = sendMemoryWarning;
+exports.sendSignalToProcess = sendSignalToProcess;
+exports.launchApp = launchApp;
+const lodash_1 = __importDefault(require("lodash"));
+/**
+ * Simulates memory warning for the process with the given PID
+ */
+async function sendMemoryWarning(pid) {
+    await this.execute(['device', 'process', 'sendMemoryWarning'], {
+        subcommandOptions: ['--pid', `${pid}`],
+    });
+}
+/**
+ * Send POSIX signal to the running process
+ */
+async function sendSignalToProcess(pid, signal) {
+    await this.execute(['device', 'process', 'signal'], {
+        subcommandOptions: ['--signal', `${signal}`, '--pid', `${pid}`],
+    });
+}
+/**
+ * Launch the given bundle id application with the given environment variable.
+ * This method is over devicectl command, this it may take additional seconds to launch the app.
+ * Please use via WDA or via appium-ios-device as primary method to launch app if possible.
+ */
+async function launchApp(bundleId, opts = {}) {
+    const { env, terminateExisting = false } = opts;
+    const subcommandOptions = [];
+    if (terminateExisting) {
+        subcommandOptions.push('--terminate-existing');
+    }
+    if (!lodash_1.default.isEmpty(env)) {
+        subcommandOptions.push('--environment-variables', JSON.stringify(lodash_1.default.mapValues(env, (v) => lodash_1.default.toString(v))));
+    }
+    // The bundle id should be the last to apply arguments properly.
+    // devicectl command might not raise exception while the order is wrong.
+    subcommandOptions.push(bundleId);
+    await this.execute(['device', 'process', 'launch'], {
+        subcommandOptions,
+        asJson: false,
+    });
+}
+//# sourceMappingURL=process.js.map

package/build/lib/mixins/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../../lib/mixins/process.ts"],"names":[],"mappings":";;;;;AAOA,8CAIC;AAKD,kDAQC;AAOD,8BA4BC;AA3DD,oDAAuB;AAIvB;;GAEG;AACI,KAAK,UAAU,iBAAiB,CAAkB,GAAoB;IAC3E,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,mBAAmB,CAAC,EAAE;QAC7D,iBAAiB,EAAE,CAAC,OAAO,EAAE,GAAG,GAAG,EAAE,CAAC;KACvC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,mBAAmB,CAEvC,GAAoB,EACpB,MAAuB;IAEvB,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE;QAClD,iBAAiB,EAAE,CAAC,UAAU,EAAE,GAAG,MAAM,EAAE,EAAE,OAAO,EAAE,GAAG,GAAG,EAAE,CAAC;KAChE,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,SAAS,CAE7B,QAAgB,EAChB,OAAyB,EAAE;IAE3B,MAAM,EAAC,GAAG,EAAE,iBAAiB,GAAG,KAAK,EAAC,GAAG,IAAI,CAAC;IAE9C,MAAM,iBAAiB,GAAa,EAAE,CAAC;IAEvC,IAAI,iBAAiB,EAAE,CAAC;QACtB,iBAAiB,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,CAAC,gBAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACpB,iBAAiB,CAAC,IAAI,CACpB,yBAAyB,EACzB,IAAI,CAAC,SAAS,CAAC,gBAAC,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CACvD,CAAC;IACJ,CAAC;IAED,gEAAgE;IAChE,wEAAwE;IACxE,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEjC,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE;QAClD,iBAAiB;QACjB,MAAM,EAAE,KAAK;KACd,CAAC,CAAC;AACL,CAAC"}