node-simctl 8.0.9 → 8.1.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [8.1.0](https://github.com/appium/node-simctl/compare/v8.0.9...v8.1.0) (2025-12-12)
+
+### Features
+
+* Migrate the module to typescript ([#282](https://github.com/appium/node-simctl/issues/282)) ([6d3c887](https://github.com/appium/node-simctl/commit/6d3c8878cdea433e853be77fef34417e6eb3785a))
+
 ## [8.0.9](https://github.com/appium/node-simctl/compare/v8.0.8...v8.0.9) (2025-12-11)
 
 ### Miscellaneous Chores

package/build/index.d.ts

@@ -1,4 +1,5 @@
+import { Simctl } from './lib/simctl';
+export type { SimctlOpts, DeviceInfo, SimCreationOpts, BootMonitorOptions, CertOptions, XCRun, AppInfo, } from './lib/types';
 export { Simctl };
 export default Simctl;
-import { Simctl } from './lib/simctl';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.js"],"names":[],"mappings":";;uBAAuB,cAAc"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,YAAY,EACV,UAAU,EACV,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,KAAK,EACL,OAAO,GACR,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,MAAM,EAAE,CAAC;AAClB,eAAe,MAAM,CAAC"}

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.js"],"names":[],"mappings":";;;AAAA,yCAAsC;AAE7B,uFAFA,eAAM,OAEA;AACf,kBAAe,eAAM,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;AAAA,yCAAsC;AAW7B,uFAXA,eAAM,OAWA;AACf,kBAAe,eAAM,CAAC"}

package/build/lib/helpers.d.ts

@@ -1,22 +1,30 @@
+export declare const DEFAULT_EXEC_TIMEOUT: number;
+export declare const SIM_RUNTIME_NAME = "com.apple.CoreSimulator.SimRuntime.";
 /**
  * "Normalize" the version, since iOS uses 'major.minor' but the runtimes can
  * be 'major.minor.patch'
  *
- * @param {string} version - the string version
- * @return {string} The version in 'major.minor' form
+ * @param version - the string version
+ * @return The version in 'major.minor' form
  * @throws {Error} If the version not parseable by the `semver` package
  */
-export function normalizeVersion(version: string): string;
+export declare function normalizeVersion(version: string): string;
 /**
- * @returns {string}
+ * @returns The xcrun binary name
  */
-export function getXcrunBinary(): string;
+export declare function getXcrunBinary(): string;
 /**
  * Generate a UUID v4
  *
- * @returns {Promise<string>}
+ * @returns Promise resolving to UUID string
  */
-export function uuidV4(): Promise<string>;
-export const DEFAULT_EXEC_TIMEOUT: number;
-export const SIM_RUNTIME_NAME: "com.apple.CoreSimulator.SimRuntime.";
+export declare function uuidV4(): Promise<string>;
+/**
+ * Convert plist-style output to JSON using plutil
+ *
+ * @param plistInput - The plist-style string to convert
+ * @return Promise resolving to parsed JSON object
+ * @throws {Error} If plutil fails to convert the input
+ */
+export declare function convertPlistToJson(plistInput: string): Promise<any>;
 //# sourceMappingURL=helpers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../lib/helpers.js"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,0CAJW,MAAM,GACL,MAAM,CASjB;AAED;;GAEG;AACH,kCAFa,MAAM,CAIlB;AAED;;;;GAIG;AACH,0BAFa,OAAO,CAAC,MAAM,CAAC,CAK3B;AAlCD,0CAAmD;AACnD,+BAAgC,qCAAqC,CAAC"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../lib/helpers.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,oBAAoB,QAAiB,CAAC;AACnD,eAAO,MAAM,gBAAgB,wCAAwC,CAAC;AAEtE;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAK,MAAM,CAExC;AAED;;;;GAIG;AACH,wBAAsB,MAAM,IAAK,OAAO,CAAC,MAAM,CAAC,CAG/C;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAgC1E"}

package/build/lib/helpers.js

@@ -37,15 +37,18 @@ exports.SIM_RUNTIME_NAME = exports.DEFAULT_EXEC_TIMEOUT = void 0;
 exports.normalizeVersion = normalizeVersion;
 exports.getXcrunBinary = getXcrunBinary;
 exports.uuidV4 = uuidV4;
+exports.convertPlistToJson = convertPlistToJson;
 const semver = __importStar(require("semver"));
+const node_child_process_1 = require("node:child_process");
+const node_stream_1 = require("node:stream");
 exports.DEFAULT_EXEC_TIMEOUT = 10 * 60 * 1000; // ms
 exports.SIM_RUNTIME_NAME = 'com.apple.CoreSimulator.SimRuntime.';
 /**
  * "Normalize" the version, since iOS uses 'major.minor' but the runtimes can
  * be 'major.minor.patch'
  *
- * @param {string} version - the string version
- * @return {string} The version in 'major.minor' form
+ * @param version - the string version
+ * @return The version in 'major.minor' form
  * @throws {Error} If the version not parseable by the `semver` package
  */
 function normalizeVersion(version) {
@@ -56,7 +59,7 @@ function normalizeVersion(version) {
     return `${semverVersion.major}.${semverVersion.minor}`;
 }
 /**
- * @returns {string}
+ * @returns The xcrun binary name
  */
 function getXcrunBinary() {
     return process.env.XCRUN_BINARY || 'xcrun';
@@ -64,10 +67,53 @@ function getXcrunBinary() {
 /**
  * Generate a UUID v4
  *
- * @returns {Promise<string>}
+ * @returns Promise resolving to UUID string
  */
 async function uuidV4() {
     const uuidLib = await import('uuid');
     return uuidLib.v4();
 }
+/**
+ * Convert plist-style output to JSON using plutil
+ *
+ * @param plistInput - The plist-style string to convert
+ * @return Promise resolving to parsed JSON object
+ * @throws {Error} If plutil fails to convert the input
+ */
+async function convertPlistToJson(plistInput) {
+    const plutilProcess = (0, node_child_process_1.spawn)('plutil', ['-convert', 'json', '-o', '-', '-']);
+    let jsonOutput = '';
+    plutilProcess.stdout.on('data', (chunk) => {
+        jsonOutput += chunk.toString();
+    });
+    const inputStream = node_stream_1.Readable.from([plistInput]);
+    inputStream.pipe(plutilProcess.stdin);
+    try {
+        await new Promise((resolve, reject) => {
+            inputStream.once('error', reject);
+            plutilProcess.once('exit', (code, signal) => {
+                inputStream.unpipe(plutilProcess.stdin);
+                if (code === 0) {
+                    resolve();
+                }
+                else {
+                    reject(new Error(`plutil exited with code ${code}, signal ${signal}`));
+                }
+            });
+            plutilProcess.once('error', (e) => {
+                inputStream.unpipe(plutilProcess.stdin);
+                reject(e);
+            });
+        });
+    }
+    catch (err) {
+        plutilProcess.kill(9);
+        throw new Error(`Failed to convert plist to JSON: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    finally {
+        plutilProcess.removeAllListeners();
+        inputStream.removeAllListeners();
+    }
+    return JSON.parse(jsonOutput);
+}
 //# sourceMappingURL=helpers.js.map

package/build/lib/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../lib/helpers.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAaA,4CAMC;AAKD,wCAEC;AAOD,wBAGC;AApCD,+CAAiC;AAEpB,QAAA,oBAAoB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,KAAK;AAC5C,QAAA,gBAAgB,GAAG,qCAAqC,CAAC;AAEtE;;;;;;;GAOG;AACH,SAAgB,gBAAgB,CAAE,OAAO;IACvC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7C,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,4BAA4B,OAAO,GAAG,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,GAAG,aAAa,CAAC,KAAK,IAAI,aAAa,CAAC,KAAK,EAAE,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc;IAC5B,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,MAAM;IAC1B,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IACrC,OAAO,OAAO,CAAC,EAAE,EAAE,CAAC;AACtB,CAAC"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../lib/helpers.ts"],"names":[],"mappings":"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"}

package/build/lib/logger.d.ts

@@ -1,4 +1,3 @@
-export default log;
-export const LOG_PREFIX: "simctl";
-declare const log: any;
+export declare const LOG_PREFIX = "simctl";
+export declare const log: any;
 //# sourceMappingURL=logger.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../lib/logger.js"],"names":[],"mappings":";AAEA,yBAAmB,QAAQ,CAAC;AAU5B,uBAAwB"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../lib/logger.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU,WAAW,CAAC;AAUnC,eAAO,MAAM,GAAG,KAAc,CAAC"}

package/build/lib/logger.js

@@ -3,10 +3,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LOG_PREFIX = void 0;
+exports.log = exports.LOG_PREFIX = void 0;
 const logger_1 = __importDefault(require("@appium/logger"));
-const LOG_PREFIX = 'simctl';
-exports.LOG_PREFIX = LOG_PREFIX;
+exports.LOG_PREFIX = 'simctl';
 function getLogger() {
     const logger = global._global_npmlog || logger_1.default;
     if (!logger.debug) {
@@ -14,6 +13,5 @@ function getLogger() {
     }
     return logger;
 }
-const log = getLogger();
-exports.default = log;
+exports.log = getLogger();
 //# sourceMappingURL=logger.js.map

package/build/lib/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../lib/logger.js"],"names":[],"mappings":";;;;;;AAAA,4DAA0C;AAE1C,MAAM,UAAU,GAAG,QAAQ,CAAC;AAYnB,gCAAU;AAVnB,SAAS,SAAS;IAChB,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,IAAI,gBAAY,CAAC;IACrD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;AAGxB,kBAAe,GAAG,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../lib/logger.ts"],"names":[],"mappings":";;;;;;AAAA,4DAA0C;AAE7B,QAAA,UAAU,GAAG,QAAQ,CAAC;AAEnC,SAAS,SAAS;IAChB,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,IAAI,gBAAY,CAAC;IACrD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAEY,QAAA,GAAG,GAAG,SAAS,EAAE,CAAC"}

package/build/lib/simctl.d.ts

@@ -1,208 +1,102 @@
-export default Simctl;
-export type XCRun = {
-    /**
-     * Full path to the xcrun script
-     */
-    path: string | null;
-};
-export type TAsyncOpts = {
-    asynchronous: true;
-};
-export type ExecOpts = {
-    /**
-     * - The list of additional subcommand arguments.
-     * It's empty by default.
-     */
-    args?: string[] | undefined;
-    /**
-     * - Environment variables mapping. All these variables
-     * will be passed Simulator and used in the executing function.
-     */
-    env?: Record<string, any> | undefined;
-    /**
-     * - Set it to _false_ to throw execution errors
-     * immediately without logging any additional information.
-     */
-    logErrors?: boolean | undefined;
-    /**
-     * - Whether to execute the given command
-     * 'synchronously' or 'asynchronously'. Affects the returned result of the function.
-     */
-    asynchronous?: boolean | undefined;
-    /**
-     * - Explicitly sets streams encoding for the executed
-     * command input and outputs.
-     */
-    encoding?: string | undefined;
-    /**
-     * - One or more architecture names to be enforced while
-     * executing xcrun. See https://github.com/appium/appium/issues/18966 for more details.
-     */
-    architectures?: string | string[] | undefined;
-    /**
-     * - The maximum number of milliseconds
-     * to wait for single synchronous xcrun command. If not provided explicitly, then
-     * the value of execTimeout property is used by default.
-     */
-    timeout?: number | undefined;
-};
-export type SimctlOpts = {
-    /**
-     * - The xcrun properties. Currently only one property
-     * is supported, which is `path` and it by default contains `null`, which enforces
-     * the instance to automatically detect the full path to `xcrun` tool and to throw
-     * an exception if it cannot be detected. If the path is set upon instance creation
-     * then it is going to be used by `exec` and no autodetection will happen.
-     */
-    xcrun?: XCRun | undefined;
-    /**
-     * - The default maximum number of milliseconds
-     * to wait for single synchronous xcrun command.
-     */
-    execTimeout?: number | undefined;
-    /**
-     * - Whether to wire xcrun error messages
-     * into debug log before throwing them.
-     */
-    logErrors?: boolean | undefined;
-    /**
-     * - The unique identifier of the current device, which is
-     * going to be implicitly passed to all methods, which require it. It can either be set
-     * upon instance creation if it is already known in advance or later when/if needed via the
-     * corresponding instance setter.
-     */
-    udid?: string | null | undefined;
-    /**
-     * - Full path to the set of devices that you want to manage.
-     * By default this path usually equals to ~/Library/Developer/CoreSimulator/Devices
-     */
-    devicesSetPath?: string | null | undefined;
-};
-/**
- * @typedef {Object} XCRun
- * @property {string?} path Full path to the xcrun script
- */
-/**
- * @typedef {{asynchronous: true}} TAsyncOpts
- */
-/**
- * @typedef {Object} ExecOpts
- * @property {string[]} [args=[]] - The list of additional subcommand arguments.
- * It's empty by default.
- * @property {Record<string, any>} [env={}] - Environment variables mapping. All these variables
- * will be passed Simulator and used in the executing function.
- * @property {boolean} [logErrors=true] - Set it to _false_ to throw execution errors
- * immediately without logging any additional information.
- * @property {boolean} [asynchronous=false] - Whether to execute the given command
- * 'synchronously' or 'asynchronously'. Affects the returned result of the function.
- * @property {string} [encoding] - Explicitly sets streams encoding for the executed
- * command input and outputs.
- * @property {string|string[]} [architectures] - One or more architecture names to be enforced while
- * executing xcrun. See https://github.com/appium/appium/issues/18966 for more details.
- * @property {number} [timeout] - The maximum number of milliseconds
- * to wait for single synchronous xcrun command. If not provided explicitly, then
- * the value of execTimeout property is used by default.
- */
-/**
- * @typedef {Object} SimctlOpts
- * @property {XCRun} [xcrun] - The xcrun properties. Currently only one property
- * is supported, which is `path` and it by default contains `null`, which enforces
- * the instance to automatically detect the full path to `xcrun` tool and to throw
- * an exception if it cannot be detected. If the path is set upon instance creation
- * then it is going to be used by `exec` and no autodetection will happen.
- * @property {number} [execTimeout=600000] - The default maximum number of milliseconds
- * to wait for single synchronous xcrun command.
- * @property {boolean} [logErrors=true] - Whether to wire xcrun error messages
- * into debug log before throwing them.
- * @property {string?} [udid] - The unique identifier of the current device, which is
- * going to be implicitly passed to all methods, which require it. It can either be set
- * upon instance creation if it is already known in advance or later when/if needed via the
- * corresponding instance setter.
- * @property {string?} [devicesSetPath] - Full path to the set of devices that you want to manage.
- * By default this path usually equals to ~/Library/Developer/CoreSimulator/Devices
- */
-export class Simctl {
-    /**
-     * @param {SimctlOpts} [opts={}]
-     */
+import * as addmediaCommands from './subcommands/addmedia';
+import * as appinfoCommands from './subcommands/appinfo';
+import * as bootCommands from './subcommands/boot';
+import * as bootstatusCommands from './subcommands/bootstatus';
+import * as createCommands from './subcommands/create';
+import * as deleteCommands from './subcommands/delete';
+import * as eraseCommands from './subcommands/erase';
+import * as getappcontainerCommands from './subcommands/get_app_container';
+import * as installCommands from './subcommands/install';
+import * as ioCommands from './subcommands/io';
+import * as keychainCommands from './subcommands/keychain';
+import * as launchCommands from './subcommands/launch';
+import * as listCommands from './subcommands/list';
+import * as openurlCommands from './subcommands/openurl';
+import * as pbcopyCommands from './subcommands/pbcopy';
+import * as pbpasteCommands from './subcommands/pbpaste';
+import * as privacyCommands from './subcommands/privacy';
+import * as pushCommands from './subcommands/push';
+import * as envCommands from './subcommands/getenv';
+import * as shutdownCommands from './subcommands/shutdown';
+import * as spawnCommands from './subcommands/spawn';
+import * as terminateCommands from './subcommands/terminate';
+import * as uiCommands from './subcommands/ui';
+import * as uninstallCommands from './subcommands/uninstall';
+import * as locationCommands from './subcommands/location';
+import type { ExecOpts, SimctlOpts, ExecResult } from './types';
+export declare class Simctl {
+    private xcrun;
+    private execTimeout;
+    private logErrors;
+    private _udid;
+    private _devicesSetPath;
     constructor(opts?: SimctlOpts);
-    /** @type {XCRun} */
-    xcrun: XCRun;
-    /** @type {number} */
-    execTimeout: number;
-    /** @type {boolean} */
-    logErrors: boolean;
-    /** @type {string?} */
-    _udid: string | null;
-    /** @type {string?} */
-    _devicesSetPath: string | null;
     set udid(value: string | null);
     get udid(): string | null;
     set devicesSetPath(value: string | null);
     get devicesSetPath(): string | null;
     /**
-     * @param {string?} [commandName=null]
-     * @returns {string}
+     * @param commandName - Optional command name for error message
+     * @returns The UDID string
+     * @throws {Error} If UDID is not set
      */
     requireUdid(commandName?: string | null): string;
     /**
-     * @returns {Promise<string>}
+     * @returns Promise resolving to the xcrun binary path
      */
     requireXcrun(): Promise<string>;
     /**
      * Execute the particular simctl command.
      *
-     * @template {ExecOpts} TExecOpts
-     * @param {string} subcommand - One of available simctl subcommands.
+     * @param subcommand - One of available simctl subcommands.
      * Execute `xcrun simctl` in Terminal to see the full list  of available subcommands.
-     * @param {TExecOpts} [opts]
-     * @return {Promise<TExecOpts extends TAsyncOpts ? import('teen_process').SubProcess : import('teen_process').TeenProcessExecResult>}
-     * Either the result of teen process's `exec` or
+     * @param opts - Execution options
+     * @return Either the result of teen process's `exec` or
      * `SubProcess` instance depending of `opts.asynchronous` value.
      * @throws {Error} If the simctl subcommand command returns non-zero return code.
      */
-    exec<TExecOpts extends ExecOpts>(subcommand: string, opts?: TExecOpts): Promise<TExecOpts extends TAsyncOpts ? import("teen_process").SubProcess : import("teen_process").TeenProcessExecResult<any>>;
-    addMedia: (this: Simctl, filePath: string) => Promise<import("teen_process").TeenProcessExecResult<any>>;
-    appInfo: (this: Simctl, bundleId: string) => Promise<string>;
-    bootDevice: (this: Simctl) => Promise<void>;
-    startBootMonitor: (this: Simctl, opts?: BootMonitorOptions) => Promise<import("teen_process").SubProcess>;
-    createDevice: (this: Simctl, name: string, deviceTypeId: string, platformVersion: string, opts?: SimCreationOpts) => Promise<string>;
-    deleteDevice: (this: Simctl) => Promise<void>;
-    eraseDevice: (this: Simctl, timeout?: number) => Promise<void>;
-    getAppContainer: (this: Simctl, bundleId: string, containerType?: string | null) => Promise<string>;
-    getEnv: (this: Simctl, varName: string) => Promise<string | null>;
-    installApp: (this: Simctl, appPath: string) => Promise<void>;
-    getScreenshot: (this: Simctl) => Promise<string>;
-    addRootCertificate: (this: Simctl, cert: string, opts?: CertOptions) => Promise<void>;
-    addCertificate: (this: Simctl, cert: string, opts?: CertOptions) => Promise<void>;
-    resetKeychain: (this: Simctl) => Promise<void>;
-    launchApp: (this: Simctl, bundleId: string, tries?: number) => Promise<string>;
-    getDevicesByParsing: (this: Simctl, platform?: string | null) => Promise<Record<string, any>>;
-    getDevices: (this: Simctl, forSdk?: string | null, platform?: string | null) => Promise<any | DeviceInfo[]>;
-    getRuntimeForPlatformVersionViaJson: (this: Simctl, platformVersion: string, platform?: string) => Promise<string>;
-    getRuntimeForPlatformVersion: (this: Simctl, platformVersion: string, platform?: string) => Promise<string>;
-    getDeviceTypes: (this: Simctl) => Promise<string[]>;
-    list: (this: Simctl) => Promise<any>;
-    setLocation: (this: Simctl, latitude: string | number, longitude: string | number) => Promise<void>;
-    clearLocation: (this: Simctl) => Promise<void>;
-    openUrl: (this: Simctl, url: string) => Promise<import("teen_process").TeenProcessExecResult<any>>;
-    setPasteboard: (this: Simctl, content: string, encoding?: BufferEncoding) => Promise<void>;
-    getPasteboard: (this: Simctl, encoding?: string) => Promise<string>;
-    grantPermission: (this: Simctl, bundleId: string, perm: string) => Promise<void>;
-    revokePermission: (this: Simctl, bundleId: string, perm: string) => Promise<void>;
-    resetPermission: (this: Simctl, bundleId: string, perm: string) => Promise<void>;
-    pushNotification: (this: Simctl, payload: any) => Promise<void>;
-    shutdownDevice: (this: Simctl) => Promise<void>;
-    spawnProcess: (this: Simctl, args: string | string[], env?: object) => Promise<import("teen_process").TeenProcessExecResult<any>>;
-    spawnSubProcess: (this: Simctl, args: string | string[], env?: object) => Promise<import("teen_process").SubProcess>;
-    terminateApp: (this: Simctl, bundleId: string) => Promise<void>;
-    getAppearance: (this: Simctl) => Promise<string>;
-    setAppearance: (this: Simctl, appearance: string) => Promise<void>;
-    getIncreaseContrast: (this: Simctl) => Promise<string>;
-    setIncreaseContrast: (this: Simctl, increaseContrast: string) => Promise<void>;
-    getContentSize: (this: Simctl) => Promise<string>;
-    setContentSize: (this: Simctl, contentSizeAction: string) => Promise<void>;
-    removeApp: (this: Simctl, bundleId: string) => Promise<void>;
+    exec<T extends ExecOpts>(subcommand: string, opts?: T): Promise<ExecResult<T>>;
+    addMedia: typeof addmediaCommands.addMedia;
+    appInfo: typeof appinfoCommands.appInfo;
+    bootDevice: typeof bootCommands.bootDevice;
+    startBootMonitor: typeof bootstatusCommands.startBootMonitor;
+    createDevice: typeof createCommands.createDevice;
+    deleteDevice: typeof deleteCommands.deleteDevice;
+    eraseDevice: typeof eraseCommands.eraseDevice;
+    getAppContainer: typeof getappcontainerCommands.getAppContainer;
+    getEnv: typeof envCommands.getEnv;
+    installApp: typeof installCommands.installApp;
+    getScreenshot: typeof ioCommands.getScreenshot;
+    addRootCertificate: typeof keychainCommands.addRootCertificate;
+    addCertificate: typeof keychainCommands.addCertificate;
+    resetKeychain: typeof keychainCommands.resetKeychain;
+    launchApp: typeof launchCommands.launchApp;
+    getDevicesByParsing: typeof listCommands.getDevicesByParsing;
+    getDevices: typeof listCommands.getDevices;
+    getRuntimeForPlatformVersionViaJson: typeof listCommands.getRuntimeForPlatformVersionViaJson;
+    getRuntimeForPlatformVersion: typeof listCommands.getRuntimeForPlatformVersion;
+    getDeviceTypes: typeof listCommands.getDeviceTypes;
+    list: typeof listCommands.list;
+    setLocation: typeof locationCommands.setLocation;
+    clearLocation: typeof locationCommands.clearLocation;
+    openUrl: typeof openurlCommands.openUrl;
+    setPasteboard: typeof pbcopyCommands.setPasteboard;
+    getPasteboard: typeof pbpasteCommands.getPasteboard;
+    grantPermission: typeof privacyCommands.grantPermission;
+    revokePermission: typeof privacyCommands.revokePermission;
+    resetPermission: typeof privacyCommands.resetPermission;
+    pushNotification: typeof pushCommands.pushNotification;
+    shutdownDevice: typeof shutdownCommands.shutdownDevice;
+    spawnProcess: typeof spawnCommands.spawnProcess;
+    spawnSubProcess: typeof spawnCommands.spawnSubProcess;
+    terminateApp: typeof terminateCommands.terminateApp;
+    getAppearance: typeof uiCommands.getAppearance;
+    setAppearance: typeof uiCommands.setAppearance;
+    getIncreaseContrast: typeof uiCommands.getIncreaseContrast;
+    setIncreaseContrast: typeof uiCommands.setIncreaseContrast;
+    getContentSize: typeof uiCommands.getContentSize;
+    setContentSize: typeof uiCommands.setContentSize;
+    removeApp: typeof uninstallCommands.removeApp;
 }
-import { SubProcess } from 'teen_process';
+export default Simctl;
 //# sourceMappingURL=simctl.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"simctl.d.ts","sourceRoot":"","sources":["../../lib/simctl.js"],"names":[],"mappings":";;;;;UA4Cc,MAAM,OAAC;;yBAIR;IAAC,YAAY,EAAE,IAAI,CAAA;CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AANjC;;;GAGG;AAEH;;GAEG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AAGH;IAUE;;OAEG;IACH,mBAFW,UAAU,EAYpB;IAtBD,oBAAoB;IACpB,OADW,KAAK,CACV;IAEN,qBAAqB;IACrB,aADW,MAAM,CACL;IAEZ,sBAAsB;IACtB,WADW,OAAO,CACR;IAWR,sBAAsB;IACtB,OADW,MAAM,OAAC,CACgC;IAClD,sBAAsB;IACtB,iBADW,MAAM,OAAC,CAC8D;IAGlF,+BAEC;IAED,0BAEC;IAED,yCAEC;IAED,oCAEC;IAED;;;OAGG;IACH,0BAHW,MAAM,OAAC,GACL,MAAM,CAQlB;IAED;;OAEG;IACH,gBAFa,OAAO,CAAC,MAAM,CAAC,CAc3B;IAED;;;;;;;;;;;OAWG;IACH,KATwB,SAAS,SAAnB,QAAS,cACZ,MAAM,SAEN,SAAS,GACR,OAAO,CAAC,SAAS,SAAS,UAAU,GAAG,OAAO,cAAc,EAAE,UAAU,GAAG,iDAA4C,CAAC,CA6DnI;IAED,yGAAqC;IAErC,6DAAkC;IAElC,4CAAqC;IAErC,0GAAuD;IAEvD,qIAA2C;IAE3C,8CAA2C;IAE3C,+DAAwC;IAExC,oGAA0D;IAE1D,kEAA4B;IAE5B,6DAAwC;IAExC,iDAAyC;IAEzC,sFAAyD;IACzD,kFAAiD;IACjD,+CAA+C;IAE/C,+EAAqC;IAErC,8FAAuD;IACvD,4GAAqC;IACrC,mHAAuF;IACvF,4GAAyE;IACzE,oDAA6C;IAC7C,qCAAyB;IAEzB,oGAA2C;IAC3C,+CAA+C;IAE/C,mGAAkC;IAElC,2FAA6C;IAE7C,oEAA8C;IAE9C,iFAAkD;IAClD,kFAAoD;IACpD,iFAAkD;IAElD,gEAAiD;IAEjD,gDAAiD;IAEjD,kIAA0C;IAC1C,qHAAgD;IAEhD,gEAA8C;IAE9C,iDAAyC;IACzC,mEAAyC;IACzC,uDAAqD;IACrD,+EAAqD;IACrD,kDAA2C;IAC3C,2EAA2C;IAE3C,6DAAwC;CACzC;2BAjS0C,cAAc"}
+{"version":3,"file":"simctl.d.ts","sourceRoot":"","sources":["../../lib/simctl.ts"],"names":[],"mappings":"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"}