appium-mac2-driver 3.2.2 → 3.2.3

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+## [3.2.3](https://github.com/appium/appium-mac2-driver/compare/v3.2.2...v3.2.3) (2025-11-15)
+
+
+### Miscellaneous Chores
+
+* Migrate doctor checks to typescript ([#351](https://github.com/appium/appium-mac2-driver/issues/351)) ([66057a4](https://github.com/appium/appium-mac2-driver/commit/66057a41612d5ac71cfa10a04da1eea4fddbdc17))
+* Migrate logger and utils to typescipt ([#352](https://github.com/appium/appium-mac2-driver/issues/352)) ([9a51427](https://github.com/appium/appium-mac2-driver/commit/9a514271f1169ff29b878b7ea53b330bed5ab3c5))
+
 ## [3.2.2](https://github.com/appium/appium-mac2-driver/compare/v3.2.1...v3.2.2) (2025-11-14)
 
 

package/build/lib/doctor/optional-checks.d.ts

@@ -1,19 +1,21 @@
-/** @satisfies {import('@appium/types').IDoctorCheck} */
-export class OptionalFfmpegCheck {
-    FFMPEG_BINARY: string;
-    FFMPEG_INSTALL_LINK: string;
-    diagnose(): Promise<import("@appium/types").DoctorCheckResult>;
+import type { IDoctorCheck, AppiumLogger, DoctorCheckResult } from '@appium/types';
+import '@colors/colors';
+export declare class OptionalFfmpegCheck implements IDoctorCheck {
+    log: AppiumLogger;
+    static readonly FFMPEG_BINARY = "ffmpeg";
+    static readonly FFMPEG_INSTALL_LINK = "https://www.ffmpeg.org/download.html";
+    diagnose(): Promise<DoctorCheckResult>;
     fix(): Promise<string>;
     hasAutofix(): boolean;
     isOptional(): boolean;
 }
-export const optionalFfmpegCheck: OptionalFfmpegCheck;
-/** @satisfies {import('@appium/types').IDoctorCheck} */
-export class OptionalAutomationModeCheck {
-    diagnose(): Promise<import("@appium/types").DoctorCheckResult>;
+export declare const optionalFfmpegCheck: OptionalFfmpegCheck;
+export declare class OptionalAutomationModeCheck implements IDoctorCheck {
+    log: AppiumLogger;
+    diagnose(): Promise<DoctorCheckResult>;
     fix(): Promise<string>;
     hasAutofix(): boolean;
     isOptional(): boolean;
 }
-export const optionalAutomationModeCheck: OptionalAutomationModeCheck;
+export declare const optionalAutomationModeCheck: OptionalAutomationModeCheck;
 //# sourceMappingURL=optional-checks.d.ts.map

package/build/lib/doctor/optional-checks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"optional-checks.d.ts","sourceRoot":"","sources":["../../../lib/doctor/optional-checks.js"],"names":[],"mappings":"AAKA,wDAAwD;AACxD;IACE,sBAAyB;IACzB,4BAA6D;IAE7D,+DAMC;IAED,uBAKC;IAED,sBAEC;IAED,sBAEC;CACF;AACD,sDAA6D;AAG7D,wDAAwD;AACxD;IACE,+DAWC;IAED,uBAEC;IAED,sBAEC;IAED,sBAEC;CACF;AACD,sEAA6E"}
+{"version":3,"file":"optional-checks.d.ts","sourceRoot":"","sources":["../../../lib/doctor/optional-checks.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAC,MAAM,eAAe,CAAC;AACjF,OAAO,gBAAgB,CAAC;AAExB,qBAAa,mBAAoB,YAAW,YAAY;IACtD,GAAG,EAAG,YAAY,CAAC;IACnB,MAAM,CAAC,QAAQ,CAAC,aAAa,YAAY;IACzC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,0CAA0C;IAEvE,QAAQ,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAQtC,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;IAO5B,UAAU,IAAI,OAAO;IAIrB,UAAU,IAAI,OAAO;CAGtB;AACD,eAAO,MAAM,mBAAmB,qBAA4B,CAAC;AAG7D,qBAAa,2BAA4B,YAAW,YAAY;IAC9D,GAAG,EAAG,YAAY,CAAC;IAEb,QAAQ,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAatC,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;IAI5B,UAAU,IAAI,OAAO;IAIrB,UAAU,IAAI,OAAO;CAGtB;AACD,eAAO,MAAM,2BAA2B,6BAAoC,CAAC"}

package/build/lib/doctor/optional-checks.js

@@ -5,19 +5,19 @@ const utils_1 = require("./utils");
 const support_1 = require("appium/support");
 const teen_process_1 = require("teen_process");
 require("@colors/colors");
-/** @satisfies {import('@appium/types').IDoctorCheck} */
 class OptionalFfmpegCheck {
-    FFMPEG_BINARY = 'ffmpeg';
-    FFMPEG_INSTALL_LINK = 'https://www.ffmpeg.org/download.html';
+    log;
+    static FFMPEG_BINARY = 'ffmpeg';
+    static FFMPEG_INSTALL_LINK = 'https://www.ffmpeg.org/download.html';
     async diagnose() {
-        const ffmpegPath = await (0, utils_1.resolveExecutablePath)(this.FFMPEG_BINARY);
+        const ffmpegPath = await (0, utils_1.resolveExecutablePath)(OptionalFfmpegCheck.FFMPEG_BINARY);
         return ffmpegPath
-            ? support_1.doctor.okOptional(`${this.FFMPEG_BINARY} exists at '${ffmpegPath}'`)
-            : support_1.doctor.nokOptional(`${this.FFMPEG_BINARY} cannot be found`);
+            ? support_1.doctor.okOptional(`${OptionalFfmpegCheck.FFMPEG_BINARY} exists at '${ffmpegPath}'`)
+            : support_1.doctor.nokOptional(`${OptionalFfmpegCheck.FFMPEG_BINARY} cannot be found`);
     }
     async fix() {
-        return (`${`${this.FFMPEG_BINARY}`.bold} is used to capture screen recordings. ` +
-            `Please read ${this.FFMPEG_INSTALL_LINK}.`);
+        return (`${`${OptionalFfmpegCheck.FFMPEG_BINARY}`.bold} is used to capture screen recordings. ` +
+            `Please read ${OptionalFfmpegCheck.FFMPEG_INSTALL_LINK}.`);
     }
     hasAutofix() {
         return false;
@@ -28,8 +28,8 @@ class OptionalFfmpegCheck {
 }
 exports.OptionalFfmpegCheck = OptionalFfmpegCheck;
 exports.optionalFfmpegCheck = new OptionalFfmpegCheck();
-/** @satisfies {import('@appium/types').IDoctorCheck} */
 class OptionalAutomationModeCheck {
+    log;
     async diagnose() {
         let stdout;
         try {

package/build/lib/doctor/optional-checks.js.map

@@ -1 +1 @@
-{"version":3,"file":"optional-checks.js","sourceRoot":"","sources":["../../../lib/doctor/optional-checks.js"],"names":[],"mappings":";;;AAAA,mCAA8C;AAC9C,4CAAsC;AACtC,+CAAkC;AAClC,0BAAwB;AAExB,wDAAwD;AACxD,MAAa,mBAAmB;IAC9B,aAAa,GAAG,QAAQ,CAAC;IACzB,mBAAmB,GAAG,sCAAsC,CAAC;IAE7D,KAAK,CAAC,QAAQ;QACZ,MAAM,UAAU,GAAG,MAAM,IAAA,6BAAqB,EAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAEnE,OAAO,UAAU;YACf,CAAC,CAAC,gBAAM,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,aAAa,eAAe,UAAU,GAAG,CAAC;YACtE,CAAC,CAAC,gBAAM,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,aAAa,kBAAkB,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,GAAG;QACP,OAAO,CACL,GAAG,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC,IAAI,yCAAyC;YACxE,eAAe,IAAI,CAAC,mBAAmB,GAAG,CAC3C,CAAC;IACJ,CAAC;IAED,UAAU;QACR,OAAO,KAAK,CAAC;IACf,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AA1BD,kDA0BC;AACY,QAAA,mBAAmB,GAAG,IAAI,mBAAmB,EAAE,CAAC;AAG7D,wDAAwD;AACxD,MAAa,2BAA2B;IACtC,KAAK,CAAC,QAAQ;QACZ,IAAI,MAAM,CAAC;QACX,IAAI,CAAC;YACH,CAAC,EAAC,MAAM,EAAC,GAAG,MAAM,IAAA,mBAAI,EAAC,oBAAoB,CAAC,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,gBAAM,CAAC,WAAW,CAAC,oCAAoC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7F,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACxC,OAAO,gBAAM,CAAC,UAAU,CAAC,sDAAsD,CAAC,CAAC;QACnF,CAAC;QACD,OAAO,gBAAM,CAAC,WAAW,CAAC,8CAA8C,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,GAAG;QACP,OAAO,mHAAmH,CAAC;IAC7H,CAAC;IAED,UAAU;QACR,OAAO,KAAK,CAAC;IACf,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAzBD,kEAyBC;AACY,QAAA,2BAA2B,GAAG,IAAI,2BAA2B,EAAE,CAAC"}
+{"version":3,"file":"optional-checks.js","sourceRoot":"","sources":["../../../lib/doctor/optional-checks.ts"],"names":[],"mappings":";;;AAAA,mCAA8C;AAC9C,4CAAsC;AACtC,+CAAkC;AAElC,0BAAwB;AAExB,MAAa,mBAAmB;IAC9B,GAAG,CAAgB;IACnB,MAAM,CAAU,aAAa,GAAG,QAAQ,CAAC;IACzC,MAAM,CAAU,mBAAmB,GAAG,sCAAsC,CAAC;IAE7E,KAAK,CAAC,QAAQ;QACZ,MAAM,UAAU,GAAG,MAAM,IAAA,6BAAqB,EAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;QAElF,OAAO,UAAU;YACf,CAAC,CAAC,gBAAM,CAAC,UAAU,CAAC,GAAG,mBAAmB,CAAC,aAAa,eAAe,UAAU,GAAG,CAAC;YACrF,CAAC,CAAC,gBAAM,CAAC,WAAW,CAAC,GAAG,mBAAmB,CAAC,aAAa,kBAAkB,CAAC,CAAC;IACjF,CAAC;IAED,KAAK,CAAC,GAAG;QACP,OAAO,CACL,GAAG,GAAG,mBAAmB,CAAC,aAAa,EAAE,CAAC,IAAI,yCAAyC;YACvF,eAAe,mBAAmB,CAAC,mBAAmB,GAAG,CAC1D,CAAC;IACJ,CAAC;IAED,UAAU;QACR,OAAO,KAAK,CAAC;IACf,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC;IACd,CAAC;;AA1BH,kDA2BC;AACY,QAAA,mBAAmB,GAAG,IAAI,mBAAmB,EAAE,CAAC;AAG7D,MAAa,2BAA2B;IACtC,GAAG,CAAgB;IAEnB,KAAK,CAAC,QAAQ;QACZ,IAAI,MAAc,CAAC;QACnB,IAAI,CAAC;YACH,CAAC,EAAC,MAAM,EAAC,GAAG,MAAM,IAAA,mBAAI,EAAC,oBAAoB,CAAC,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,gBAAM,CAAC,WAAW,CAAC,oCAAqC,GAAW,CAAC,MAAM,IAAK,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACjH,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACxC,OAAO,gBAAM,CAAC,UAAU,CAAC,sDAAsD,CAAC,CAAC;QACnF,CAAC;QACD,OAAO,gBAAM,CAAC,WAAW,CAAC,8CAA8C,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,GAAG;QACP,OAAO,mHAAmH,CAAC;IAC7H,CAAC;IAED,UAAU;QACR,OAAO,KAAK,CAAC;IACf,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AA3BD,kEA2BC;AACY,QAAA,2BAA2B,GAAG,IAAI,2BAA2B,EAAE,CAAC"}

package/build/lib/doctor/required-checks.d.ts

@@ -1,19 +1,21 @@
-/** @satisfies {import('@appium/types').IDoctorCheck} */
-export class XcodeCheck {
-    diagnose(): Promise<import("@appium/types").DoctorCheckResult>;
+import type { IDoctorCheck, AppiumLogger, DoctorCheckResult } from '@appium/types';
+import '@colors/colors';
+export declare class XcodeCheck implements IDoctorCheck {
+    log: AppiumLogger;
+    diagnose(): Promise<DoctorCheckResult>;
     fix(): Promise<string>;
     hasAutofix(): boolean;
     isOptional(): boolean;
 }
-export const xcodeCheck: XcodeCheck;
-/** @satisfies {import('@appium/types').IDoctorCheck} */
-export class XcodebuildCheck {
-    XCODE_VER_PATTERN: RegExp;
-    MIN_XCODE_VERSION: number;
-    diagnose(): Promise<import("@appium/types").DoctorCheckResult>;
+export declare const xcodeCheck: XcodeCheck;
+export declare class XcodebuildCheck implements IDoctorCheck {
+    log: AppiumLogger;
+    static readonly XCODE_VER_PATTERN: RegExp;
+    static readonly MIN_XCODE_VERSION = 13;
+    diagnose(): Promise<DoctorCheckResult>;
     fix(): Promise<string>;
     hasAutofix(): boolean;
     isOptional(): boolean;
 }
-export const xcodebuildCheck: XcodebuildCheck;
+export declare const xcodebuildCheck: XcodebuildCheck;
 //# sourceMappingURL=required-checks.d.ts.map

package/build/lib/doctor/required-checks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"required-checks.d.ts","sourceRoot":"","sources":["../../../lib/doctor/required-checks.js"],"names":[],"mappings":"AAMA,wDAAwD;AACxD;IACE,+DAOC;IAED,uBAEC;IAED,sBAEC;IAED,sBAEC;CACF;AACD,oCAA2C;AAG3C,wDAAwD;AACxD;IACE,0BAA0C;IAC1C,0BAAuB;IAEvB,+DAoBC;IAED,uBAEC;IAED,sBAEC;IAED,sBAEC;CACF;AACD,8CAAqD"}
+{"version":3,"file":"required-checks.d.ts","sourceRoot":"","sources":["../../../lib/doctor/required-checks.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAC,MAAM,eAAe,CAAC;AACjF,OAAO,gBAAgB,CAAC;AAGxB,qBAAa,UAAW,YAAW,YAAY;IAC7C,GAAG,EAAG,YAAY,CAAC;IAEb,QAAQ,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAStC,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;IAI5B,UAAU,IAAI,OAAO;IAIrB,UAAU,IAAI,OAAO;CAGtB;AACD,eAAO,MAAM,UAAU,YAAmB,CAAC;AAG3C,qBAAa,eAAgB,YAAW,YAAY;IAClD,GAAG,EAAG,YAAY,CAAC;IACnB,MAAM,CAAC,QAAQ,CAAC,iBAAiB,SAAyB;IAC1D,MAAM,CAAC,QAAQ,CAAC,iBAAiB,MAAM;IAEjC,QAAQ,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAsBtC,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;IAI5B,UAAU,IAAI,OAAO;IAIrB,UAAU,IAAI,OAAO;CAGtB;AACD,eAAO,MAAM,eAAe,iBAAwB,CAAC"}

package/build/lib/doctor/required-checks.js

@@ -5,8 +5,8 @@ const support_1 = require("appium/support");
 const teen_process_1 = require("teen_process");
 const appium_xcode_1 = require("appium-xcode");
 require("@colors/colors");
-/** @satisfies {import('@appium/types').IDoctorCheck} */
 class XcodeCheck {
+    log;
     async diagnose() {
         try {
             const xcodePath = await (0, appium_xcode_1.getPath)();
@@ -28,17 +28,17 @@ class XcodeCheck {
 }
 exports.XcodeCheck = XcodeCheck;
 exports.xcodeCheck = new XcodeCheck();
-/** @satisfies {import('@appium/types').IDoctorCheck} */
 class XcodebuildCheck {
-    XCODE_VER_PATTERN = /^Xcode\s+([\d.]+)$/m;
-    MIN_XCODE_VERSION = 13;
+    log;
+    static XCODE_VER_PATTERN = /^Xcode\s+([\d.]+)$/m;
+    static MIN_XCODE_VERSION = 13;
     async diagnose() {
         let xcodeVerMatch;
         let stdout;
         let stderr;
         try {
             ({ stdout, stderr } = await (0, teen_process_1.exec)('xcodebuild', ['-version']));
-            xcodeVerMatch = this.XCODE_VER_PATTERN.exec(stdout);
+            xcodeVerMatch = XcodebuildCheck.XCODE_VER_PATTERN.exec(stdout);
         }
         catch (err) {
             return support_1.doctor.nok(`Cannot run 'xcodebuild': ${err.stderr || err.message}`);
@@ -47,15 +47,15 @@ class XcodebuildCheck {
             return support_1.doctor.nok(`Cannot determine Xcode version. stdout: ${stdout}; stderr: ${stderr}`);
         }
         const xcodeMajorVer = parseInt(xcodeVerMatch[1], 10);
-        if (xcodeMajorVer < this.MIN_XCODE_VERSION) {
+        if (xcodeMajorVer < XcodebuildCheck.MIN_XCODE_VERSION) {
             return support_1.doctor.nok(`The actual Xcode version (${xcodeVerMatch[0]}) is older than the expected ` +
-                `one (${this.MIN_XCODE_VERSION})`);
+                `one (${XcodebuildCheck.MIN_XCODE_VERSION})`);
         }
         return support_1.doctor.ok(`xcodebuild is installed and has a matching version number ` +
-            `(${xcodeVerMatch[1]} >= ${this.MIN_XCODE_VERSION})`);
+            `(${xcodeVerMatch[1]} >= ${XcodebuildCheck.MIN_XCODE_VERSION})`);
     }
     async fix() {
-        return `Install ${'Xcode'.bold} ${this.MIN_XCODE_VERSION}+ or upgrade the existing setup`;
+        return `Install ${'Xcode'.bold} ${XcodebuildCheck.MIN_XCODE_VERSION}+ or upgrade the existing setup`;
     }
     hasAutofix() {
         return false;

package/build/lib/doctor/required-checks.js.map

@@ -1 +1 @@
-{"version":3,"file":"required-checks.js","sourceRoot":"","sources":["../../../lib/doctor/required-checks.js"],"names":[],"mappings":";;;AAAA,4CAAsC;AACtC,+CAAkC;AAClC,+CAAuD;AACvD,0BAAwB;AAGxB,wDAAwD;AACxD,MAAa,UAAU;IACrB,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,IAAA,sBAAY,GAAE,CAAC;YACvC,OAAO,gBAAM,CAAC,EAAE,CAAC,0BAA0B,SAAS,GAAG,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,gBAAM,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG;QACP,OAAO,oBAAoB,OAAO,CAAC,IAAI,gFAAgF,CAAC;IAC1H,CAAC;IAED,UAAU;QACR,OAAO,KAAK,CAAC;IACf,CAAC;IAED,UAAU;QACR,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AArBD,gCAqBC;AACY,QAAA,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC;AAG3C,wDAAwD;AACxD,MAAa,eAAe;IAC1B,iBAAiB,GAAG,qBAAqB,CAAC;IAC1C,iBAAiB,GAAG,EAAE,CAAC;IAEvB,KAAK,CAAC,QAAQ;QACZ,IAAI,aAAa,CAAC;QAClB,IAAI,MAAM,CAAC;QACX,IAAI,MAAM,CAAC;QACX,IAAI,CAAC;YACH,CAAC,EAAC,MAAM,EAAE,MAAM,EAAC,GAAG,MAAM,IAAA,mBAAI,EAAC,YAAY,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAC5D,aAAa,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,gBAAM,CAAC,GAAG,CAAC,4BAA4B,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,gBAAM,CAAC,GAAG,CAAC,2CAA2C,MAAM,aAAa,MAAM,EAAE,CAAC,CAAC;QAC5F,CAAC;QACD,MAAM,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrD,IAAI,aAAa,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3C,OAAO,gBAAM,CAAC,GAAG,CAAC,6BAA6B,aAAa,CAAC,CAAC,CAAC,+BAA+B;gBAC5F,QAAQ,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,gBAAM,CAAC,EAAE,CAAC,4DAA4D;YAC3E,IAAI,aAAa,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,GAAG;QACP,OAAO,WAAW,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,iBAAiB,iCAAiC,CAAC;IAC5F,CAAC;IAED,UAAU;QACR,OAAO,KAAK,CAAC;IACf,CAAC;IAED,UAAU;QACR,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AArCD,0CAqCC;AACY,QAAA,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC"}
+{"version":3,"file":"required-checks.js","sourceRoot":"","sources":["../../../lib/doctor/required-checks.ts"],"names":[],"mappings":";;;AAAA,4CAAsC;AACtC,+CAAkC;AAClC,+CAAuD;AAEvD,0BAAwB;AAGxB,MAAa,UAAU;IACrB,GAAG,CAAgB;IAEnB,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,IAAA,sBAAY,GAAE,CAAC;YACvC,OAAO,gBAAM,CAAC,EAAE,CAAC,0BAA0B,SAAS,GAAG,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,gBAAM,CAAC,GAAG,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG;QACP,OAAO,oBAAoB,OAAO,CAAC,IAAI,gFAAgF,CAAC;IAC1H,CAAC;IAED,UAAU;QACR,OAAO,KAAK,CAAC;IACf,CAAC;IAED,UAAU;QACR,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAvBD,gCAuBC;AACY,QAAA,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC;AAG3C,MAAa,eAAe;IAC1B,GAAG,CAAgB;IACnB,MAAM,CAAU,iBAAiB,GAAG,qBAAqB,CAAC;IAC1D,MAAM,CAAU,iBAAiB,GAAG,EAAE,CAAC;IAEvC,KAAK,CAAC,QAAQ;QACZ,IAAI,aAAqC,CAAC;QAC1C,IAAI,MAAc,CAAC;QACnB,IAAI,MAAc,CAAC;QACnB,IAAI,CAAC;YACH,CAAC,EAAC,MAAM,EAAE,MAAM,EAAC,GAAG,MAAM,IAAA,mBAAI,EAAC,YAAY,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAC5D,aAAa,GAAG,eAAe,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,gBAAM,CAAC,GAAG,CAAC,4BAA6B,GAAW,CAAC,MAAM,IAAK,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACjG,CAAC;QACD,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,gBAAM,CAAC,GAAG,CAAC,2CAA2C,MAAM,aAAa,MAAM,EAAE,CAAC,CAAC;QAC5F,CAAC;QACD,MAAM,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrD,IAAI,aAAa,GAAG,eAAe,CAAC,iBAAiB,EAAE,CAAC;YACtD,OAAO,gBAAM,CAAC,GAAG,CAAC,6BAA6B,aAAa,CAAC,CAAC,CAAC,+BAA+B;gBAC5F,QAAQ,eAAe,CAAC,iBAAiB,GAAG,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,gBAAM,CAAC,EAAE,CAAC,4DAA4D;YAC3E,IAAI,aAAa,CAAC,CAAC,CAAC,OAAO,eAAe,CAAC,iBAAiB,GAAG,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,GAAG;QACP,OAAO,WAAW,OAAO,CAAC,IAAI,IAAI,eAAe,CAAC,iBAAiB,iCAAiC,CAAC;IACvG,CAAC;IAED,UAAU;QACR,OAAO,KAAK,CAAC;IACf,CAAC;IAED,UAAU;QACR,OAAO,KAAK,CAAC;IACf,CAAC;;AArCH,0CAsCC;AACY,QAAA,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC"}

package/build/lib/doctor/utils.d.ts

@@ -1,8 +1,8 @@
 /**
  * Return an executable path of cmd
  *
- * @param {string} cmd Standard output by command
- * @return {Promise<string?>} The full path of cmd. `null` if the cmd is not found.
+ * @param cmd Standard output by command
+ * @return The full path of cmd. `null` if the cmd is not found.
  */
-export function resolveExecutablePath(cmd: string): Promise<string | null>;
+export declare function resolveExecutablePath(cmd: string): Promise<string | null>;
 //# sourceMappingURL=utils.d.ts.map

package/build/lib/doctor/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../lib/doctor/utils.js"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,2CAHW,MAAM,GACL,OAAO,CAAC,MAAM,OAAC,CAAC,CAU3B"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../lib/doctor/utils.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQ/E"}

package/build/lib/doctor/utils.js

@@ -5,8 +5,8 @@ const support_1 = require("appium/support");
 /**
  * Return an executable path of cmd
  *
- * @param {string} cmd Standard output by command
- * @return {Promise<string?>} The full path of cmd. `null` if the cmd is not found.
+ * @param cmd Standard output by command
+ * @return The full path of cmd. `null` if the cmd is not found.
  */
 async function resolveExecutablePath(cmd) {
     try {

package/build/lib/doctor/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../lib/doctor/utils.js"],"names":[],"mappings":";;AAQA,sDAQC;AAhBD,4CAAkC;AAElC;;;;;GAKG;AACI,KAAK,UAAU,qBAAqB,CAAC,GAAG;IAC7C,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,MAAM,YAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,cAAc,IAAI,CAAC,MAAM,YAAE,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC;YACxD,OAAO,cAAc,CAAC;QACxB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IACV,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../lib/doctor/utils.ts"],"names":[],"mappings":";;AAQA,sDAQC;AAhBD,4CAAkC;AAElC;;;;;GAKG;AACI,KAAK,UAAU,qBAAqB,CAAC,GAAW;IACrD,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,MAAM,YAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,cAAc,IAAI,CAAC,MAAM,YAAE,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC;YACxD,OAAO,cAAc,CAAC;QACxB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IACV,OAAO,IAAI,CAAC;AACd,CAAC"}

package/build/lib/logger.d.ts

@@ -1,3 +1,3 @@
-export default log;
 declare const log: import("@appium/types").AppiumLogger;
+export default log;
 //# 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,wDAA2C"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../lib/logger.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,GAAG,sCAAiC,CAAC;AAE3C,eAAe,GAAG,CAAC"}

package/build/lib/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../lib/logger.js"],"names":[],"mappings":";;AAAA,4CAAwC;AAExC,MAAM,GAAG,GAAG,gBAAM,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;AAE3C,kBAAe,GAAG,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../lib/logger.ts"],"names":[],"mappings":";;AAAA,4CAAwC;AAExC,MAAM,GAAG,GAAG,gBAAM,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;AAE3C,kBAAe,GAAG,CAAC"}

package/build/lib/utils.d.ts

@@ -1,18 +1,18 @@
+import _ from 'lodash';
 /**
- * Retrieves process ids of all the children processes created by the given
- * parent process identifier
+ * Calculates the path to the current module's root folder
  *
- * @param {number|string} parentPid parent process ID
- * @returns {Promise<string[]>} the list of matched children process ids
- * or an empty list if none matched
+ * @returns The full path to module root
+ * @throws If the current module root folder cannot be determined
  */
-export function listChildrenProcessIds(parentPid: number | string): Promise<string[]>;
+export declare const getModuleRoot: (() => string) & _.MemoizedFunction;
 /**
- * Calculates the path to the current module's root folder
+ * Retrieves process ids of all the children processes created by the given
+ * parent process identifier
  *
- * @returns {string} The full path to module root
- * @throws {Error} If the current module root folder cannot be determined
+ * @param parentPid parent process ID
+ * @returns the list of matched children process ids
+ * or an empty list if none matched
  */
-export const getModuleRoot: (() => string) & _.MemoizedFunction;
-import _ from 'lodash';
+export declare function listChildrenProcessIds(parentPid: number | string): Promise<string[]>;
 //# sourceMappingURL=utils.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../lib/utils.js"],"names":[],"mappings":"AAoBA;;;;;;;GAOG;AACH,kDAJW,MAAM,GAAC,MAAM,GACX,OAAO,CAAC,MAAM,EAAE,CAAC,CAc7B;AAjCD;;;;;GAKG;AACH,gEAMG;cAlBW,QAAQ"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../lib/utils.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,QAAQ,CAAC;AAMvB;;;;;GAKG;AACH,eAAO,MAAM,aAAa,SAAwC,MAAM,sBAMtE,CAAC;AAEH;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAW3F"}

package/build/lib/utils.js

@@ -12,23 +12,22 @@ const MODULE_NAME = 'appium-mac2-driver';
 /**
  * Calculates the path to the current module's root folder
  *
- * @returns {string} The full path to module root
- * @throws {Error} If the current module root folder cannot be determined
+ * @returns The full path to module root
+ * @throws If the current module root folder cannot be determined
  */
-const getModuleRoot = lodash_1.default.memoize(function getModuleRoot() {
+exports.getModuleRoot = lodash_1.default.memoize(function getModuleRoot() {
     const root = support_1.node.getModuleRootSync(MODULE_NAME, __filename);
     if (!root) {
         throw new Error(`Cannot find the root folder of the ${MODULE_NAME} Node.js module`);
     }
     return root;
 });
-exports.getModuleRoot = getModuleRoot;
 /**
  * Retrieves process ids of all the children processes created by the given
  * parent process identifier
  *
- * @param {number|string} parentPid parent process ID
- * @returns {Promise<string[]>} the list of matched children process ids
+ * @param parentPid parent process ID
+ * @returns the list of matched children process ids
  * or an empty list if none matched
  */
 async function listChildrenProcessIds(parentPid) {
@@ -41,6 +40,6 @@ async function listChildrenProcessIds(parentPid) {
         return [pid, lodash_1.default.last(rest)];
     })
         .filter(([, ppid]) => ppid === `${parentPid}`)
-        .map(([pid]) => (String)(pid));
+        .map(([pid]) => String(pid));
 }
 //# sourceMappingURL=utils.js.map

package/build/lib/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../lib/utils.js"],"names":[],"mappings":";;;;;;AAyCS,wDAAsB;AAzC/B,oDAAuB;AACvB,+CAAoC;AACpC,4CAAsC;AAEtC,MAAM,WAAW,GAAG,oBAAoB,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,aAAa,GAAG,gBAAC,CAAC,OAAO,CAAC,SAAS,aAAa;IACpD,MAAM,IAAI,GAAG,cAAI,CAAC,iBAAiB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAC7D,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,sCAAsC,WAAW,iBAAiB,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC,CAAC;AAuB8B,sCAAa;AArB9C;;;;;;;GAOG;AACH,KAAK,UAAU,sBAAsB,CAAE,SAAS;IAC9C,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAA,mBAAI,EAAC,IAAI,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3D,wEAAwE;IACxE,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;SACtB,MAAM,CAAC,gBAAC,CAAC,IAAI,CAAC;SACd,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,gBAAC,CAAC,IAAI,CAAC,CAAC;QAC1D,OAAO,CAAC,GAAG,EAAE,gBAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7B,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;SAC7C,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../lib/utils.ts"],"names":[],"mappings":";;;;;;AA4BA,wDAWC;AAvCD,oDAAuB;AACvB,+CAAoC;AACpC,4CAAsC;AAEtC,MAAM,WAAW,GAAG,oBAAoB,CAAC;AAEzC;;;;;GAKG;AACU,QAAA,aAAa,GAAG,gBAAC,CAAC,OAAO,CAAC,SAAS,aAAa;IAC3D,MAAM,IAAI,GAAG,cAAI,CAAC,iBAAiB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAC7D,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,sCAAsC,WAAW,iBAAiB,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC,CAAC;AAEH;;;;;;;GAOG;AACI,KAAK,UAAU,sBAAsB,CAAE,SAA0B;IACtE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAA,mBAAI,EAAC,IAAI,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3D,wEAAwE;IACxE,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;SACtB,MAAM,CAAC,gBAAC,CAAC,IAAI,CAAC;SACd,GAAG,CAAC,CAAC,IAAY,EAAE,EAAE;QACpB,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,gBAAC,CAAC,IAAI,CAAC,CAAC;QAC1D,OAAO,CAAC,GAAG,EAAE,gBAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7B,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;SAC7C,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AACjC,CAAC"}

package/lib/doctor/optional-checks.ts

@@ -0,0 +1,67 @@
+import {resolveExecutablePath} from './utils';
+import {doctor} from 'appium/support';
+import {exec} from 'teen_process';
+import type {IDoctorCheck, AppiumLogger, DoctorCheckResult} from '@appium/types';
+import '@colors/colors';
+
+export class OptionalFfmpegCheck implements IDoctorCheck {
+  log!: AppiumLogger;
+  static readonly FFMPEG_BINARY = 'ffmpeg';
+  static readonly FFMPEG_INSTALL_LINK = 'https://www.ffmpeg.org/download.html';
+
+  async diagnose(): Promise<DoctorCheckResult> {
+    const ffmpegPath = await resolveExecutablePath(OptionalFfmpegCheck.FFMPEG_BINARY);
+
+    return ffmpegPath
+      ? doctor.okOptional(`${OptionalFfmpegCheck.FFMPEG_BINARY} exists at '${ffmpegPath}'`)
+      : doctor.nokOptional(`${OptionalFfmpegCheck.FFMPEG_BINARY} cannot be found`);
+  }
+
+  async fix(): Promise<string> {
+    return (
+      `${`${OptionalFfmpegCheck.FFMPEG_BINARY}`.bold} is used to capture screen recordings. ` +
+      `Please read ${OptionalFfmpegCheck.FFMPEG_INSTALL_LINK}.`
+    );
+  }
+
+  hasAutofix(): boolean {
+    return false;
+  }
+
+  isOptional(): boolean {
+    return true;
+  }
+}
+export const optionalFfmpegCheck = new OptionalFfmpegCheck();
+
+
+export class OptionalAutomationModeCheck implements IDoctorCheck {
+  log!: AppiumLogger;
+
+  async diagnose(): Promise<DoctorCheckResult> {
+    let stdout: string;
+    try {
+      ({stdout} = await exec('automationmodetool'));
+    } catch (err) {
+      return doctor.nokOptional(`Cannot run 'automationmodetool': ${(err as any).stderr || (err as Error).message}`);
+    }
+    if (stdout.includes('DOES NOT REQUIRE')) {
+      return doctor.okOptional(`Automation Mode does not require user authentication`);
+    }
+    return doctor.nokOptional(`Automation Mode requires user authentication`);
+  }
+
+  async fix(): Promise<string> {
+    return `Run \`automationmodetool enable-automationmode-without-authentication\` to disable Automation Mode authentication`;
+  }
+
+  hasAutofix(): boolean {
+    return false;
+  }
+
+  isOptional(): boolean {
+    return true;
+  }
+}
+export const optionalAutomationModeCheck = new OptionalAutomationModeCheck();
+

package/lib/doctor/required-checks.ts

@@ -0,0 +1,75 @@
+import {doctor} from 'appium/support';
+import {exec} from 'teen_process';
+import { getPath as getXcodePath } from 'appium-xcode';
+import type {IDoctorCheck, AppiumLogger, DoctorCheckResult} from '@appium/types';
+import '@colors/colors';
+
+
+export class XcodeCheck implements IDoctorCheck {
+  log!: AppiumLogger;
+
+  async diagnose(): Promise<DoctorCheckResult> {
+    try {
+      const xcodePath = await getXcodePath();
+      return doctor.ok(`xCode is installed at '${xcodePath}'`);
+    } catch (err) {
+      return doctor.nok((err as Error).message);
+    }
+  }
+
+  async fix(): Promise<string> {
+    return `Manually install ${'Xcode'.bold} and configure the active developer directory path using the xcode-select tool`;
+  }
+
+  hasAutofix(): boolean {
+    return false;
+  }
+
+  isOptional(): boolean {
+    return false;
+  }
+}
+export const xcodeCheck = new XcodeCheck();
+
+
+export class XcodebuildCheck implements IDoctorCheck {
+  log!: AppiumLogger;
+  static readonly XCODE_VER_PATTERN = /^Xcode\s+([\d.]+)$/m;
+  static readonly MIN_XCODE_VERSION = 13;
+
+  async diagnose(): Promise<DoctorCheckResult> {
+    let xcodeVerMatch: RegExpExecArray | null;
+    let stdout: string;
+    let stderr: string;
+    try {
+      ({stdout, stderr} = await exec('xcodebuild', ['-version']));
+      xcodeVerMatch = XcodebuildCheck.XCODE_VER_PATTERN.exec(stdout);
+    } catch (err) {
+      return doctor.nok(`Cannot run 'xcodebuild': ${(err as any).stderr || (err as Error).message}`);
+    }
+    if (!xcodeVerMatch) {
+      return doctor.nok(`Cannot determine Xcode version. stdout: ${stdout}; stderr: ${stderr}`);
+    }
+    const xcodeMajorVer = parseInt(xcodeVerMatch[1], 10);
+    if (xcodeMajorVer < XcodebuildCheck.MIN_XCODE_VERSION) {
+      return doctor.nok(`The actual Xcode version (${xcodeVerMatch[0]}) is older than the expected ` +
+        `one (${XcodebuildCheck.MIN_XCODE_VERSION})`);
+    }
+    return doctor.ok(`xcodebuild is installed and has a matching version number ` +
+      `(${xcodeVerMatch[1]} >= ${XcodebuildCheck.MIN_XCODE_VERSION})`);
+  }
+
+  async fix(): Promise<string> {
+    return `Install ${'Xcode'.bold} ${XcodebuildCheck.MIN_XCODE_VERSION}+ or upgrade the existing setup`;
+  }
+
+  hasAutofix(): boolean {
+    return false;
+  }
+
+  isOptional(): boolean {
+    return false;
+  }
+}
+export const xcodebuildCheck = new XcodebuildCheck();
+

package/lib/doctor/{utils.js → utils.ts}

@@ -3,10 +3,10 @@ import {fs} from 'appium/support';
 /**
  * Return an executable path of cmd
  *
- * @param {string} cmd Standard output by command
- * @return {Promise<string?>} The full path of cmd. `null` if the cmd is not found.
+ * @param cmd Standard output by command
+ * @return The full path of cmd. `null` if the cmd is not found.
  */
-export async function resolveExecutablePath(cmd) {
+export async function resolveExecutablePath(cmd: string): Promise<string | null> {
   try {
     const executablePath = await fs.which(cmd);
     if (executablePath && (await fs.exists(executablePath))) {
@@ -15,3 +15,4 @@ export async function resolveExecutablePath(cmd) {
   } catch {}
   return null;
 }
+

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

@@ -3,3 +3,4 @@ import { logger } from 'appium/support';
 const log = logger.getLogger('Mac2Driver');
 
 export default log;
+

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

@@ -7,10 +7,10 @@ const MODULE_NAME = 'appium-mac2-driver';
 /**
  * Calculates the path to the current module's root folder
  *
- * @returns {string} The full path to module root
- * @throws {Error} If the current module root folder cannot be determined
+ * @returns The full path to module root
+ * @throws If the current module root folder cannot be determined
  */
-const getModuleRoot = _.memoize(function getModuleRoot () {
+export const getModuleRoot = _.memoize(function getModuleRoot (): string {
   const root = node.getModuleRootSync(MODULE_NAME, __filename);
   if (!root) {
     throw new Error(`Cannot find the root folder of the ${MODULE_NAME} Node.js module`);
@@ -22,21 +22,19 @@ const getModuleRoot = _.memoize(function getModuleRoot () {
  * Retrieves process ids of all the children processes created by the given
  * parent process identifier
  *
- * @param {number|string} parentPid parent process ID
- * @returns {Promise<string[]>} the list of matched children process ids
+ * @param parentPid parent process ID
+ * @returns the list of matched children process ids
  * or an empty list if none matched
  */
-async function listChildrenProcessIds (parentPid) {
+export async function listChildrenProcessIds (parentPid: number | string): Promise<string[]> {
   const { stdout } = await exec('ps', ['axu', '-o', 'ppid']);
   // USER  PID  %CPU %MEM  VSZ  RSS   TT  STAT STARTED  TIME COMMAND  PPID
   return stdout.split('\n')
     .filter(_.trim)
-    .map((line) => {
+    .map((line: string) => {
       const [, pid, ...rest] = line.split(/\s+/).filter(_.trim);
       return [pid, _.last(rest)];
     })
     .filter(([, ppid]) => ppid === `${parentPid}`)
-    .map(([pid]) => (String) (pid));
+    .map(([pid]) => String(pid));
 }
-
-export { listChildrenProcessIds, getModuleRoot };

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "appium-mac2-driver",
-  "version": "3.2.2",
+  "version": "3.2.3",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "appium-mac2-driver",
-      "version": "3.2.2",
+      "version": "3.2.3",
       "license": "Apache-2.0",
       "dependencies": {
         "@appium/strongbox": "^1.0.0-rc.1",
@@ -1542,14 +1542,14 @@
       }
     },
     "node_modules/color": {
-      "version": "5.0.2",
-      "resolved": "https://registry.npmjs.org/color/-/color-5.0.2.tgz",
-      "integrity": "sha512-e2hz5BzbUPcYlIRHo8ieAhYgoajrJr+hWoceg6E345TPsATMUKqDgzt8fSXZJJbxfpiPzkWyphz8yn8At7q3fA==",
+      "version": "5.0.3",
+      "resolved": "https://registry.npmjs.org/color/-/color-5.0.3.tgz",
+      "integrity": "sha512-ezmVcLR3xAVp8kYOm4GS45ZLLgIE6SPAFoduLr6hTDajwb3KZ2F46gulK3XpcwRFb5KKGCSezCBAY4Dw4HsyXA==",
       "extraneous": true,
       "license": "MIT",
       "dependencies": {
-        "color-convert": "^3.0.1",
-        "color-string": "^2.0.0"
+        "color-convert": "^3.1.3",
+        "color-string": "^2.1.3"
       },
       "engines": {
         "node": ">=18"
@@ -1574,9 +1574,9 @@
       "license": "MIT"
     },
     "node_modules/color-string": {
-      "version": "2.1.2",
-      "resolved": "https://registry.npmjs.org/color-string/-/color-string-2.1.2.tgz",
-      "integrity": "sha512-RxmjYxbWemV9gKu4zPgiZagUxbH3RQpEIO77XoSSX0ivgABDZ+h8Zuash/EMFLTI4N9QgFPOJ6JQpPZKFxa+dA==",
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/color-string/-/color-string-2.1.3.tgz",
+      "integrity": "sha512-r/wfcFshhORndnDjn3GtNVLA4QL4TAi0A/XIBNuWUIEAVyUBNWYLuckrDz/JM1aQlpIDzKuY5hAYdHcLYgwJsg==",
       "extraneous": true,
       "license": "MIT",
       "dependencies": {
@@ -1597,9 +1597,9 @@
       }
     },
     "node_modules/color/node_modules/color-convert": {
-      "version": "3.1.2",
-      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-3.1.2.tgz",
-      "integrity": "sha512-UNqkvCDXstVck3kdowtOTWROIJQwafjOfXSmddoDrXo4cewMKmusCeF22Q24zvjR8nwWib/3S/dfyzPItPEiJg==",
+      "version": "3.1.3",
+      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-3.1.3.tgz",
+      "integrity": "sha512-fasDH2ont2GqF5HpyO4w0+BcewlhHEZOFn9c1ckZdHpJ56Qb7MHhH/IcJZbBGgvdtwdwNbLvxiBEdg336iA9Sg==",
       "extraneous": true,
       "license": "MIT",
       "dependencies": {

package/package.json

@@ -6,7 +6,7 @@
     "mac",
     "XCTest"
   ],
-  "version": "3.2.2",
+  "version": "3.2.3",
   "author": "Appium Contributors",
   "license": "Apache-2.0",
   "repository": {

package/lib/doctor/optional-checks.js

@@ -1,64 +0,0 @@
-import {resolveExecutablePath} from './utils';
-import {doctor} from 'appium/support';
-import {exec} from 'teen_process';
-import '@colors/colors';
-
-/** @satisfies {import('@appium/types').IDoctorCheck} */
-export class OptionalFfmpegCheck {
-  FFMPEG_BINARY = 'ffmpeg';
-  FFMPEG_INSTALL_LINK = 'https://www.ffmpeg.org/download.html';
-
-  async diagnose() {
-    const ffmpegPath = await resolveExecutablePath(this.FFMPEG_BINARY);
-
-    return ffmpegPath
-      ? doctor.okOptional(`${this.FFMPEG_BINARY} exists at '${ffmpegPath}'`)
-      : doctor.nokOptional(`${this.FFMPEG_BINARY} cannot be found`);
-  }
-
-  async fix() {
-    return (
-      `${`${this.FFMPEG_BINARY}`.bold} is used to capture screen recordings. ` +
-      `Please read ${this.FFMPEG_INSTALL_LINK}.`
-    );
-  }
-
-  hasAutofix() {
-    return false;
-  }
-
-  isOptional() {
-    return true;
-  }
-}
-export const optionalFfmpegCheck = new OptionalFfmpegCheck();
-
-
-/** @satisfies {import('@appium/types').IDoctorCheck} */
-export class OptionalAutomationModeCheck {
-  async diagnose() {
-    let stdout;
-    try {
-      ({stdout} = await exec('automationmodetool'));
-    } catch (err) {
-      return doctor.nokOptional(`Cannot run 'automationmodetool': ${err.stderr || err.message}`);
-    }
-    if (stdout.includes('DOES NOT REQUIRE')) {
-      return doctor.okOptional(`Automation Mode does not require user authentication`);
-    }
-    return doctor.nokOptional(`Automation Mode requires user authentication`);
-  }
-
-  async fix() {
-    return `Run \`automationmodetool enable-automationmode-without-authentication\` to disable Automation Mode authentication`;
-  }
-
-  hasAutofix() {
-    return false;
-  }
-
-  isOptional() {
-    return true;
-  }
-}
-export const optionalAutomationModeCheck = new OptionalAutomationModeCheck();

package/lib/doctor/required-checks.js

@@ -1,72 +0,0 @@
-import {doctor} from 'appium/support';
-import {exec} from 'teen_process';
-import { getPath as getXcodePath } from 'appium-xcode';
-import '@colors/colors';
-
-
-/** @satisfies {import('@appium/types').IDoctorCheck} */
-export class XcodeCheck {
-  async diagnose() {
-    try {
-      const xcodePath = await getXcodePath();
-      return doctor.ok(`xCode is installed at '${xcodePath}'`);
-    } catch (err) {
-      return doctor.nok(err.message);
-    }
-  }
-
-  async fix() {
-    return `Manually install ${'Xcode'.bold} and configure the active developer directory path using the xcode-select tool`;
-  }
-
-  hasAutofix() {
-    return false;
-  }
-
-  isOptional() {
-    return false;
-  }
-}
-export const xcodeCheck = new XcodeCheck();
-
-
-/** @satisfies {import('@appium/types').IDoctorCheck} */
-export class XcodebuildCheck {
-  XCODE_VER_PATTERN = /^Xcode\s+([\d.]+)$/m;
-  MIN_XCODE_VERSION = 13;
-
-  async diagnose() {
-    let xcodeVerMatch;
-    let stdout;
-    let stderr;
-    try {
-      ({stdout, stderr} = await exec('xcodebuild', ['-version']));
-      xcodeVerMatch = this.XCODE_VER_PATTERN.exec(stdout);
-    } catch (err) {
-      return doctor.nok(`Cannot run 'xcodebuild': ${err.stderr || err.message}`);
-    }
-    if (!xcodeVerMatch) {
-      return doctor.nok(`Cannot determine Xcode version. stdout: ${stdout}; stderr: ${stderr}`);
-    }
-    const xcodeMajorVer = parseInt(xcodeVerMatch[1], 10);
-    if (xcodeMajorVer < this.MIN_XCODE_VERSION) {
-      return doctor.nok(`The actual Xcode version (${xcodeVerMatch[0]}) is older than the expected ` +
-        `one (${this.MIN_XCODE_VERSION})`);
-    }
-    return doctor.ok(`xcodebuild is installed and has a matching version number ` +
-      `(${xcodeVerMatch[1]} >= ${this.MIN_XCODE_VERSION})`);
-  }
-
-  async fix() {
-    return `Install ${'Xcode'.bold} ${this.MIN_XCODE_VERSION}+ or upgrade the existing setup`;
-  }
-
-  hasAutofix() {
-    return false;
-  }
-
-  isOptional() {
-    return false;
-  }
-}
-export const xcodebuildCheck = new XcodebuildCheck();