node-simctl 8.0.8 → 8.1.0

package/build/lib/subcommands/ui.js

@@ -3,39 +3,42 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAppearance = getAppearance;
+exports.setAppearance = setAppearance;
+exports.getIncreaseContrast = getIncreaseContrast;
+exports.setIncreaseContrast = setIncreaseContrast;
+exports.getContentSize = getContentSize;
+exports.setContentSize = setContentSize;
 const lodash_1 = __importDefault(require("lodash"));
-const commands = {};
 /**
  * Retrieves the current UI appearance value from the given simulator
  *
  * @since Xcode 11.4 SDK
- * @this {import('../simctl').Simctl}
- * @return {Promise<string>} the appearance value, for example 'light' or 'dark'
+ * @return the appearance value, for example 'light' or 'dark'
  * @throws {Error} if the current SDK version does not support the command
  * or there was an error while getting the value
  * @throws {Error} If the `udid` instance property is unset
  */
-commands.getAppearance = async function getAppearance() {
+async function getAppearance() {
     const { stdout } = await this.exec('ui', {
         args: [this.requireUdid('ui'), 'appearance'],
     });
     return lodash_1.default.trim(stdout);
-};
+}
 /**
  * Sets the UI appearance to the given style
  *
  * @since Xcode 11.4 SDK
- * @this {import('../simctl').Simctl}
- * @param {string} appearance valid appearance value, for example 'light' or 'dark'
+ * @param appearance valid appearance value, for example 'light' or 'dark'
  * @throws {Error} if the current SDK version does not support the command
  * or there was an error while getting the value
  * @throws {Error} If the `udid` instance property is unset
  */
-commands.setAppearance = async function setAppearance(appearance) {
+async function setAppearance(appearance) {
     await this.exec('ui', {
         args: [this.requireUdid('ui'), 'appearance', appearance],
     });
-};
+}
 /**
  * Retrieves the current increase contrast configuration value from the given simulator.
  * The value could be:
@@ -45,20 +48,19 @@ commands.setAppearance = async function setAppearance(appearance) {
  *   - unknown: The current setting is unknown or there was an error detecting it.
  *
  * @since Xcode 15 (but lower xcode could have this command)
- * @this {import('../simctl').Simctl}
- * @return {Promise<string>} the contrast configuration value.
+ * @return the contrast configuration value.
  *                           Possible return value is 'enabled', 'disabled',
  *                           'unsupported' or 'unknown' with Xcode 16.2.
  * @throws {Error} if the current SDK version does not support the command
  * or there was an error while getting the value.
  * @throws {Error} If the `udid` instance property is unset
  */
-commands.getIncreaseContrast = async function getIncreaseContrast() {
+async function getIncreaseContrast() {
     const { stdout } = await this.exec('ui', {
         args: [this.requireUdid('ui'), 'increase_contrast'],
     });
     return lodash_1.default.trim(stdout);
-};
+}
 /**
  * Sets the increase constrast configuration for the given simulator.
  * Acceptable values (with Xcode 16.2, iOS 18.1) are 'enabled' or 'disabled'
@@ -66,18 +68,17 @@ commands.getIncreaseContrast = async function getIncreaseContrast() {
  * in the caller side.
  *
  * @since Xcode 15 (but lower xcode could have this command)
- * @this {import('../simctl').Simctl}
- * @param {string} increaseContrast valid increase constrast configuration value.
+ * @param increaseContrast valid increase constrast configuration value.
  *                                  Acceptable value is 'enabled' or 'disabled' with Xcode 16.2.
  * @throws {Error} if the current SDK version does not support the command
  * or the given value was invalid for the command.
  * @throws {Error} If the `udid` instance property is unset
  */
-commands.setIncreaseContrast = async function setIncreaseContrast(increaseContrast) {
+async function setIncreaseContrast(increaseContrast) {
     await this.exec('ui', {
         args: [this.requireUdid('ui'), 'increase_contrast', increaseContrast],
     });
-};
+}
 /**
  * Retrieves the current content size value from the given simulator.
  * The value could be:
@@ -89,8 +90,7 @@ commands.setIncreaseContrast = async function setIncreaseContrast(increaseContra
  *   Other values: unknown, unsupported.
  *
  * @since Xcode 15 (but lower xcode could have this command)
- * @this {import('../simctl').Simctl}
- * @return {Promise<string>} the content size value. Possible return value is
+ * @return the content size value. Possible return value is
  *                           extra-small, small, medium, large, extra-large, extra-extra-large,
  *                           extra-extra-extra-large, accessibility-medium, accessibility-large,
  *                           accessibility-extra-large, accessibility-extra-extra-large,
@@ -100,12 +100,12 @@ commands.setIncreaseContrast = async function setIncreaseContrast(increaseContra
  * or there was an error while getting the value.
  * @throws {Error} If the `udid` instance property is unset
  */
-commands.getContentSize = async function getContentSize() {
+async function getContentSize() {
     const { stdout } = await this.exec('ui', {
         args: [this.requireUdid('ui'), 'content_size'],
     });
     return lodash_1.default.trim(stdout);
-};
+}
 /**
  * Sets content size for the given simulator.
  * Acceptable values (with Xcode 16.2, iOS 18.1) are below:
@@ -119,8 +119,7 @@ commands.getContentSize = async function getContentSize() {
  * in the caller side.
  *
  * @since Xcode 15 (but lower xcode could have this command)
- * @this {import('../simctl').Simctl}
- * @param {string} contentSizeAction valid content size or action value. Acceptable value is
+ * @param contentSizeAction valid content size or action value. Acceptable value is
  *                                   extra-small, small, medium, large, extra-large, extra-extra-large,
  *                                   extra-extra-extra-large, accessibility-medium, accessibility-large,
  *                                   accessibility-extra-large, accessibility-extra-extra-large,
@@ -129,10 +128,9 @@ commands.getContentSize = async function getContentSize() {
  * or the given value was invalid for the command.
  * @throws {Error} If the `udid` instance property is unset
  */
-commands.setContentSize = async function setContentSize(contentSizeAction) {
+async function setContentSize(contentSizeAction) {
     await this.exec('ui', {
         args: [this.requireUdid('ui'), 'content_size', contentSizeAction],
     });
-};
-exports.default = commands;
+}
 //# sourceMappingURL=ui.js.map

package/build/lib/subcommands/ui.js.map

@@ -1 +1 @@
-{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../../lib/subcommands/ui.js"],"names":[],"mappings":";;;;;AAAA,oDAAuB;AAGvB,MAAM,QAAQ,GAAG,EAAE,CAAC;AAEpB;;;;;;;;;GASG;AACH,QAAQ,CAAC,aAAa,GAAG,KAAK,UAAU,aAAa;IACnD,MAAM,EAAC,MAAM,EAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QACrC,IAAI,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;KAC7C,CAAC,CAAC;IACH,OAAO,gBAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,QAAQ,CAAC,aAAa,GAAG,KAAK,UAAU,aAAa,CAAE,UAAU;IAC/D,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QACpB,IAAI,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,UAAU,CAAC;KACzD,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,QAAQ,CAAC,mBAAmB,GAAG,KAAK,UAAU,mBAAmB;IAC/D,MAAM,EAAC,MAAM,EAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QACrC,IAAI,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,mBAAmB,CAAC;KACpD,CAAC,CAAC;IACH,OAAO,gBAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,QAAQ,CAAC,mBAAmB,GAAG,KAAK,UAAU,mBAAmB,CAAE,gBAAgB;IACjF,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QACpB,IAAI,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,mBAAmB,EAAE,gBAAgB,CAAC;KACtE,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,QAAQ,CAAC,cAAc,GAAG,KAAK,UAAU,cAAc;IACrD,MAAM,EAAC,MAAM,EAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QACrC,IAAI,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC;KAC/C,CAAC,CAAC;IACH,OAAO,gBAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,QAAQ,CAAC,cAAc,GAAG,KAAK,UAAU,cAAc,CAAE,iBAAiB;IACxE,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QACpB,IAAI,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,cAAc,EAAE,iBAAiB,CAAC;KAClE,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,kBAAe,QAAQ,CAAC"}
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../../lib/subcommands/ui.ts"],"names":[],"mappings":";;;;;AAYA,sCAKC;AAWD,sCAIC;AAkBD,kDAKC;AAeD,kDAIC;AAuBD,wCAKC;AAwBD,wCAIC;AAlID,oDAAuB;AAGvB;;;;;;;;GAQG;AACI,KAAK,UAAU,aAAa;IACjC,MAAM,EAAC,MAAM,EAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QACrC,IAAI,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;KAC7C,CAAC,CAAC;IACH,OAAO,gBAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;;;GAQG;AACI,KAAK,UAAU,aAAa,CAAgB,UAAkB;IACnE,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QACpB,IAAI,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,UAAU,CAAC;KACzD,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACI,KAAK,UAAU,mBAAmB;IACvC,MAAM,EAAC,MAAM,EAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QACrC,IAAI,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,mBAAmB,CAAC;KACpD,CAAC,CAAC;IACH,OAAO,gBAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;;;;;;;GAYG;AACI,KAAK,UAAU,mBAAmB,CAAgB,gBAAwB;IAC/E,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QACpB,IAAI,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,mBAAmB,EAAE,gBAAgB,CAAC;KACtE,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACI,KAAK,UAAU,cAAc;IAClC,MAAM,EAAC,MAAM,EAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QACrC,IAAI,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC;KAC/C,CAAC,CAAC;IACH,OAAO,gBAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACI,KAAK,UAAU,cAAc,CAAgB,iBAAyB;IAC3E,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QACpB,IAAI,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,cAAc,EAAE,iBAAiB,CAAC;KAClE,CAAC,CAAC;AACL,CAAC"}

package/build/lib/subcommands/uninstall.d.ts

@@ -1,17 +1,14 @@
-export default commands;
-declare namespace commands {
-    /**
-     * Remove the particular application package from Simulator.
-     * It is required that Simulator is in _booted_ state and
-     * the application with given bundle identifier is already installed.
-     *
-     * @this {import('../simctl').Simctl}
-     * @param {string} bundleId - Bundle identifier of the application,
-     *                            which is going to be removed.
-     * @throws {Error} If the corresponding simctl subcommand command
-     *                 returns non-zero return code.
-     * @throws {Error} If the `udid` instance property is unset
-     */
-    function removeApp(this: import("../simctl").default, bundleId: string): Promise<void>;
-}
+import type { Simctl } from '../simctl';
+/**
+ * Remove the particular application package from Simulator.
+ * It is required that Simulator is in _booted_ state and
+ * the application with given bundle identifier is already installed.
+ *
+ * @param bundleId - Bundle identifier of the application,
+ *                            which is going to be removed.
+ * @throws {Error} If the corresponding simctl subcommand command
+ *                 returns non-zero return code.
+ * @throws {Error} If the `udid` instance property is unset
+ */
+export declare function removeApp(this: Simctl, bundleId: string): Promise<void>;
 //# sourceMappingURL=uninstall.d.ts.map

package/build/lib/subcommands/uninstall.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../../../lib/subcommands/uninstall.js"],"names":[],"mappings":";;IAEA;;;;;;;;;;;OAWG;IACH,gEANW,MAAM,iBAUhB"}
+{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../../../lib/subcommands/uninstall.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC;;;;;;;;;;GAUG;AACH,wBAAsB,SAAS,CAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI9E"}

package/build/lib/subcommands/uninstall.js

@@ -1,22 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const commands = {};
+exports.removeApp = removeApp;
 /**
  * Remove the particular application package from Simulator.
  * It is required that Simulator is in _booted_ state and
  * the application with given bundle identifier is already installed.
  *
- * @this {import('../simctl').Simctl}
- * @param {string} bundleId - Bundle identifier of the application,
+ * @param bundleId - Bundle identifier of the application,
  *                            which is going to be removed.
  * @throws {Error} If the corresponding simctl subcommand command
  *                 returns non-zero return code.
  * @throws {Error} If the `udid` instance property is unset
  */
-commands.removeApp = async function removeApp(bundleId) {
+async function removeApp(bundleId) {
     await this.exec('uninstall', {
         args: [this.requireUdid('uninstall'), bundleId],
     });
-};
-exports.default = commands;
+}
 //# sourceMappingURL=uninstall.js.map

package/build/lib/subcommands/uninstall.js.map

@@ -1 +1 @@
-{"version":3,"file":"uninstall.js","sourceRoot":"","sources":["../../../lib/subcommands/uninstall.js"],"names":[],"mappings":";;AAAA,MAAM,QAAQ,GAAG,EAAE,CAAC;AAEpB;;;;;;;;;;;GAWG;AACH,QAAQ,CAAC,SAAS,GAAG,KAAK,UAAU,SAAS,CAAE,QAAQ;IACrD,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;QAC3B,IAAI,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC;KAChD,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,kBAAe,QAAQ,CAAC"}
+{"version":3,"file":"uninstall.js","sourceRoot":"","sources":["../../../lib/subcommands/uninstall.ts"],"names":[],"mappings":";;AAaA,8BAIC;AAfD;;;;;;;;;;GAUG;AACI,KAAK,UAAU,SAAS,CAAgB,QAAgB;IAC7D,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;QAC3B,IAAI,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC;KAChD,CAAC,CAAC;AACL,CAAC"}

package/build/lib/types.d.ts

@@ -0,0 +1,231 @@
+import type { SubProcess, TeenProcessExecResult } from 'teen_process';
+/**
+ * XCRun configuration
+ */
+export interface XCRun {
+    /**
+     * Full path to the xcrun script
+     */
+    path: string | null;
+}
+/**
+ * Options for asynchronous execution
+ */
+export interface AsyncExecOpts {
+    asynchronous: true;
+}
+/**
+ * Execution options for simctl commands
+ */
+export interface ExecOpts {
+    /**
+     * The list of additional subcommand arguments.
+     * It's empty by default.
+     */
+    args?: string[];
+    /**
+     * Environment variables mapping. All these variables
+     * will be passed Simulator and used in the executing function.
+     */
+    env?: Record<string, any>;
+    /**
+     * Set it to _false_ to throw execution errors
+     * immediately without logging any additional information.
+     */
+    logErrors?: boolean;
+    /**
+     * Whether to execute the given command
+     * 'synchronously' or 'asynchronously'. Affects the returned result of the function.
+     */
+    asynchronous?: boolean;
+    /**
+     * Explicitly sets streams encoding for the executed
+     * command input and outputs.
+     */
+    encoding?: string;
+    /**
+     * 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[];
+    /**
+     * 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;
+}
+/**
+ * Simctl instance options
+ */
+export interface 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;
+    /**
+     * The default maximum number of milliseconds
+     * to wait for single synchronous xcrun command.
+     */
+    execTimeout?: number;
+    /**
+     * Whether to wire xcrun error messages
+     * into debug log before throwing them.
+     */
+    logErrors?: boolean;
+    /**
+     * 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;
+    /**
+     * 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;
+}
+/**
+ * Device information
+ */
+export interface DeviceInfo {
+    /**
+     * The device name.
+     */
+    name: string;
+    /**
+     * The device UDID.
+     */
+    udid: string;
+    /**
+     * The current Simulator state, for example 'booted' or 'shutdown'.
+     */
+    state: string;
+    /**
+     * The SDK version, for example '10.3'.
+     */
+    sdk: string;
+    /**
+     * The platform name, for example 'iOS'.
+     */
+    platform: string;
+}
+/**
+ * Simulator creation options
+ */
+export interface SimCreationOpts {
+    /**
+     * Platform name in order to specify runtime such as 'iOS', 'tvOS', 'watchOS'
+     */
+    platform?: string;
+    /**
+     * The maximum number of milliseconds to wait
+     * unit device creation is completed.
+     */
+    timeout?: number;
+}
+/**
+ * Result type for exec method - either SubProcess for async or TeenProcessExecResult for sync
+ */
+export type ExecResult<T extends ExecOpts> = T extends AsyncExecOpts ? SubProcess : TeenProcessExecResult<string>;
+/**
+ * Boot monitor options
+ */
+export interface BootMonitorOptions {
+    /**
+     * Simulator booting timeout in ms.
+     */
+    timeout?: number;
+    /**
+     * This event is fired when data migration stage starts.
+     */
+    onWaitingDataMigration?: () => void;
+    /**
+     * This event is fired when system app wait stage starts.
+     */
+    onWaitingSystemApp?: () => void;
+    /**
+     * This event is fired when Simulator is fully booted.
+     */
+    onFinished?: () => void;
+    /**
+     * This event is fired when there was an error while monitoring the booting process
+     * or when the timeout has expired.
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Whether to preboot the Simulator
+     * if this command is called and it is not already in booted or booting state.
+     */
+    shouldPreboot?: boolean;
+}
+/**
+ * Certificate options
+ */
+export interface CertOptions {
+    /**
+     * whether the `cert` argument
+     * is the path to the certificate on the local file system or
+     * a raw certificate content
+     */
+    raw?: boolean;
+}
+/**
+ * App information returned by simctl appinfo when the app is found
+ */
+export interface AppInfo {
+    /**
+     * Application type (e.g., "Hidden")
+     */
+    ApplicationType: string;
+    /**
+     * Bundle URL (file:// URL)
+     */
+    Bundle?: string;
+    /**
+     * Bundle container URL (file:// URL)
+     */
+    BundleContainer?: string;
+    /**
+     * Display name of the application
+     */
+    CFBundleDisplayName: string;
+    /**
+     * Executable name
+     */
+    CFBundleExecutable: string;
+    /**
+     * Bundle identifier
+     */
+    CFBundleIdentifier: string;
+    /**
+     * Bundle name
+     */
+    CFBundleName: string;
+    /**
+     * Bundle version
+     */
+    CFBundleVersion: string | number;
+    /**
+     * Data container URL (file:// URL)
+     */
+    DataContainer?: string;
+    /**
+     * Group containers dictionary
+     */
+    GroupContainers?: Record<string, any>;
+    /**
+     * Path to the app bundle
+     */
+    Path: string;
+    /**
+     * SpringBoard app tags
+     */
+    SBAppTags?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/build/lib/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/build/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../lib/types.ts"],"names":[],"mappings":""}

package/index.ts

@@ -0,0 +1,13 @@
+import { Simctl } from './lib/simctl';
+export type {
+  SimctlOpts,
+  DeviceInfo,
+  SimCreationOpts,
+  BootMonitorOptions,
+  CertOptions,
+  XCRun,
+  AppInfo,
+} from './lib/types';
+
+export { Simctl };
+export default Simctl;

package/lib/helpers.ts

@@ -0,0 +1,81 @@
+import * as semver from 'semver';
+import { spawn } from 'node:child_process';
+import { Readable } from 'node:stream';
+
+export const DEFAULT_EXEC_TIMEOUT = 10 * 60 * 1000; // ms
+export 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 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 {
+  const semverVersion = semver.coerce(version);
+  if (!semverVersion) {
+    throw new Error(`Unable to parse version '${version}'`);
+  }
+  return `${semverVersion.major}.${semverVersion.minor}`;
+}
+
+/**
+ * @returns The xcrun binary name
+ */
+export function getXcrunBinary (): string {
+  return process.env.XCRUN_BINARY || 'xcrun';
+}
+
+/**
+ * Generate a UUID v4
+ *
+ * @returns Promise resolving to UUID string
+ */
+export async function uuidV4 (): Promise<string> {
+  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
+ */
+export async function convertPlistToJson (plistInput: string): Promise<any> {
+  const plutilProcess = spawn('plutil', ['-convert', 'json', '-o', '-', '-']);
+  let jsonOutput = '';
+  plutilProcess.stdout.on('data', (chunk) => {
+    jsonOutput += chunk.toString();
+  });
+  const inputStream = Readable.from([plistInput]);
+  inputStream.pipe(plutilProcess.stdin);
+  try {
+    await new Promise<void>((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);
+}
+

package/lib/{logger.js → logger.ts}

@@ -1,6 +1,6 @@
 import appiumLogger from '@appium/logger';
 
-const LOG_PREFIX = 'simctl';
+export const LOG_PREFIX = 'simctl';
 
 function getLogger () {
   const logger = global._global_npmlog || appiumLogger;
@@ -10,7 +10,4 @@ function getLogger () {
   return logger;
 }
 
-const log = getLogger();
-
-export { LOG_PREFIX };
-export default log;
+export const log = getLogger();