@appium/support 7.0.4 → 7.0.6

package/build/lib/plist.js

@@ -4,11 +4,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parsePlistFile = parsePlistFile;
-exports.parsePlist = parsePlist;
-exports.createPlist = createPlist;
 exports.updatePlistFile = updatePlistFile;
 exports.createBinaryPlist = createBinaryPlist;
 exports.parseBinaryPlist = parseBinaryPlist;
+exports.createPlist = createPlist;
+exports.parsePlist = parsePlist;
 const plist_1 = __importDefault(require("plist"));
 const bplist_creator_1 = __importDefault(require("bplist-creator"));
 const bplist_parser_1 = require("bplist-parser");
@@ -23,38 +23,33 @@ const PLIST_IDENTIFIER = {
     BUFFER: Buffer.from('<'),
     TEXT: '<',
 };
-// XML Plist library helper
-async function parseXmlPlistFile(plistFilename) {
-    let xmlContent = await fs_1.fs.readFile(plistFilename, 'utf8');
-    return plist_1.default.parse(xmlContent);
-}
 /**
  * Parses a file in xml or binary format of plist
- * @param {string} plist The plist file path
- * @param {boolean} mustExist If set to false, this method will return an empty object when the file doesn't exist
- * @param {boolean} quiet If set to false, the plist path will be logged in debug level
- * @returns {Promise<any>} parsed plist JS Object
+ *
+ * @param plist - The plist file path
+ * @param mustExist - If set to false, this method will return an empty object when the file doesn't exist
+ * @param quiet - If set to false, the plist path will be logged in debug level
+ * @returns Parsed plist as a JS object
  */
 async function parsePlistFile(plist, mustExist = true, quiet = true) {
-    // handle nonexistent file
     if (!(await fs_1.fs.exists(plist))) {
         if (mustExist) {
             throw logger_1.default.errorWithException(`Plist file doesn't exist: '${plist}'`);
         }
-        else {
+        if (!quiet) {
             logger_1.default.debug(`Plist file '${plist}' does not exist. Returning an empty plist.`);
-            return {};
         }
+        return {};
     }
     let obj = {};
     let type = 'binary';
     try {
-        obj = await (0, bplist_parser_1.parseFile)(plist);
-        if (obj.length) {
-            obj = obj[0];
+        const parsed = await (0, bplist_parser_1.parseFile)(plist);
+        if (parsed.length) {
+            obj = parsed[0];
         }
         else {
-            throw new Error(`Binary file '${plist}'' appears to be empty`);
+            throw new Error(`Binary file '${plist}' appears to be empty`);
         }
     }
     catch {
@@ -73,11 +68,12 @@ async function parsePlistFile(plist, mustExist = true, quiet = true) {
 }
 /**
  * Updates a plist file with the given fields
- * @param {string} plist The plist file path
- * @param {Object} updatedFields The updated fields-value pairs
- * @param {boolean} binary If set to false, the file will be created as a xml plist
- * @param {boolean} mustExist If set to false, this method will update an empty plist
- * @param {boolean} quiet If set to false, the plist path will be logged in debug level
+ *
+ * @param plist - The plist file path
+ * @param updatedFields - The updated fields-value pairs
+ * @param binary - If set to false, the file will be created as a xml plist
+ * @param mustExist - If set to false, this method will update an empty plist
+ * @param quiet - If set to false, the plist path will be logged in debug level
  */
 async function updatePlistFile(plist, updatedFields, binary = true, mustExist = true, quiet = true) {
     let obj;
@@ -88,7 +84,7 @@ async function updatePlistFile(plist, updatedFields, binary = true, mustExist =
         throw logger_1.default.errorWithException(`Could not update plist: ${err.message}`);
     }
     lodash_1.default.extend(obj, updatedFields);
-    let newPlist = binary ? (0, bplist_creator_1.default)(obj) : plist_1.default.build(obj);
+    const newPlist = binary ? (0, bplist_creator_1.default)(obj) : plist_1.default.build(obj);
     try {
         await fs_1.fs.writeFile(plist, newPlist);
     }
@@ -101,68 +97,75 @@ async function updatePlistFile(plist, updatedFields, binary = true, mustExist =
 }
 /**
  * Creates a binary plist Buffer from an object
- * @param {Object} data The object to be turned into a binary plist
- * @returns {Buffer} plist in the form of a binary buffer
+ *
+ * @param data - The object to be turned into a binary plist
+ * @returns Plist in the form of a binary buffer
  */
 function createBinaryPlist(data) {
     return (0, bplist_creator_1.default)(data);
 }
 /**
  * Parses a Buffer into an Object
- * @param {Buffer} data The buffer of a binary plist
+ *
+ * @param data - The buffer of a binary plist
+ * @returns Array of parsed root objects (typically one element)
  */
 function parseBinaryPlist(data) {
     return (0, bplist_parser_1.parseBuffer)(data);
 }
-function getXmlPlist(data) {
-    if (lodash_1.default.isString(data) && data.startsWith(PLIST_IDENTIFIER.TEXT)) {
-        return data;
-    }
-    if (lodash_1.default.isBuffer(data) &&
-        PLIST_IDENTIFIER.BUFFER.compare(data, 0, PLIST_IDENTIFIER.BUFFER.length) === 0) {
-        return data.toString();
-    }
-    return null;
-}
-function getBinaryPlist(data) {
-    if (lodash_1.default.isString(data) && data.startsWith(BPLIST_IDENTIFIER.TEXT)) {
-        return Buffer.from(data);
-    }
-    if (lodash_1.default.isBuffer(data) &&
-        BPLIST_IDENTIFIER.BUFFER.compare(data, 0, BPLIST_IDENTIFIER.BUFFER.length) === 0) {
-        return data;
-    }
-    return null;
-}
 /**
  * Creates a plist from an object
- * @param {Object} object The JS object to be turned into a plist
- * @param {boolean} binary Set it to true for a binary plist
- * @returns {string|Buffer} returns a buffer or a string in respect to the binary parameter
+ *
+ * @param object - The JS object to be turned into a plist
+ * @param binary - Set it to true for a binary plist
+ * @returns A buffer or a string depending on the binary parameter
  */
 function createPlist(object, binary = false) {
     if (binary) {
         return createBinaryPlist(object);
     }
-    else {
-        return plist_1.default.build(object);
-    }
+    return plist_1.default.build(object);
 }
 /**
- * Parses an buffer or a string to a JS object a plist from an object
- * @param {string|Buffer} data The plist in the form of string or Buffer
- * @returns {Object} parsed plist JS Object
+ * Parses a buffer or string into a JS object
+ *
+ * @param data - The plist as a string or Buffer
+ * @returns Parsed plist as a JS object
  * @throws Will throw an error if the plist type is unknown
  */
 function parsePlist(data) {
-    let textPlist = getXmlPlist(data);
+    const textPlist = getXmlPlist(data);
     if (textPlist) {
         return plist_1.default.parse(textPlist);
     }
-    let binaryPlist = getBinaryPlist(data);
+    const binaryPlist = getBinaryPlist(data);
     if (binaryPlist) {
         return parseBinaryPlist(binaryPlist)[0];
     }
-    throw new Error(`Unknown type of plist, data: ${data.toString()}`);
+    throw new Error(`Unknown type of plist, data: ${lodash_1.default.truncate(data.toString(), { length: 200 })}`);
+}
+async function parseXmlPlistFile(plistFilename) {
+    const xmlContent = await fs_1.fs.readFile(plistFilename, 'utf8');
+    return plist_1.default.parse(xmlContent);
+}
+function getXmlPlist(data) {
+    if (lodash_1.default.isString(data) && data.startsWith(PLIST_IDENTIFIER.TEXT)) {
+        return data;
+    }
+    if (Buffer.isBuffer(data) &&
+        PLIST_IDENTIFIER.BUFFER.compare(data, 0, PLIST_IDENTIFIER.BUFFER.length) === 0) {
+        return data.toString();
+    }
+    return null;
+}
+function getBinaryPlist(data) {
+    if (lodash_1.default.isString(data) && data.startsWith(BPLIST_IDENTIFIER.TEXT)) {
+        return Buffer.from(data);
+    }
+    if (Buffer.isBuffer(data) &&
+        BPLIST_IDENTIFIER.BUFFER.compare(data, 0, BPLIST_IDENTIFIER.BUFFER.length) === 0) {
+        return data;
+    }
+    return null;
 }
 //# sourceMappingURL=plist.js.map

package/build/lib/plist.js.map

@@ -1 +1 @@
-{"version":3,"file":"plist.js","sourceRoot":"","sources":["../../lib/plist.js"],"names":[],"mappings":";;;;;AA+KE,wCAAc;AACd,gCAAU;AACV,kCAAW;AACX,0CAAe;AACf,8CAAiB;AACjB,4CAAgB;AApLlB,kDAA6B;AAC7B,oEAA0C;AAC1C,iDAAuD;AACvD,6BAAwB;AACxB,sDAA2B;AAC3B,oDAAuB;AAEvB,MAAM,iBAAiB,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;IAC/B,IAAI,EAAE,UAAU;CACjB,CAAC;AACF,MAAM,gBAAgB,GAAG;IACvB,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;IACxB,IAAI,EAAE,GAAG;CACV,CAAC;AAEF,2BAA2B;AAC3B,KAAK,UAAU,iBAAiB,CAAC,aAAa;IAC5C,IAAI,UAAU,GAAG,MAAM,OAAE,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC1D,OAAO,eAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI;IACjE,0BAA0B;IAC1B,IAAI,CAAC,CAAC,MAAM,OAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAC9B,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,gBAAG,CAAC,kBAAkB,CAAC,8BAA8B,KAAK,GAAG,CAAC,CAAC;QACvE,CAAC;aAAM,CAAC;YACN,gBAAG,CAAC,KAAK,CAAC,eAAe,KAAK,6CAA6C,CAAC,CAAC;YAC7E,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,IAAI,GAAG,QAAQ,CAAC;IACpB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,IAAA,yBAAS,EAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YACf,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACf,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,gBAAgB,KAAK,wBAAwB,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,iBAAiB,CAAC,KAAK,CAAC,CAAC;YACrC,IAAI,GAAG,KAAK,CAAC;QACf,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,gBAAG,CAAC,kBAAkB,CAAC,+BAA+B,KAAK,aAAa,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/F,CAAC;IACH,CAAC;IAED,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,gBAAG,CAAC,KAAK,CAAC,sBAAsB,KAAK,QAAQ,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,eAAe,CAC5B,KAAK,EACL,aAAa,EACb,MAAM,GAAG,IAAI,EACb,SAAS,GAAG,IAAI,EAChB,KAAK,GAAG,IAAI;IAEZ,IAAI,GAAG,CAAC;IACR,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,gBAAG,CAAC,kBAAkB,CAAC,2BAA2B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,gBAAC,CAAC,MAAM,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IAC7B,IAAI,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,IAAA,wBAAY,EAAC,GAAG,CAAC,CAAC,CAAC,CAAC,eAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChE,IAAI,CAAC;QACH,MAAM,OAAE,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,gBAAG,CAAC,kBAAkB,CAAC,yBAAyB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,gBAAG,CAAC,KAAK,CAAC,qBAAqB,KAAK,GAAG,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AACD;;;;GAIG;AACH,SAAS,iBAAiB,CAAC,IAAI;IAC7B,OAAO,IAAA,wBAAY,EAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,IAAI;IAC5B,OAAO,IAAA,2BAAW,EAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,WAAW,CAAC,IAAI;IACvB,IAAI,gBAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IACE,gBAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAChB,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAC9E,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,cAAc,CAAC,IAAI;IAC1B,IAAI,gBAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;QAChE,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,IACE,gBAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAChB,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAChF,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,SAAS,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK;IACzC,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;SAAM,CAAC;QACN,OAAO,eAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,UAAU,CAAC,IAAI;IACtB,IAAI,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,eAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,gCAAgC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AACrE,CAAC"}
+{"version":3,"file":"plist.js","sourceRoot":"","sources":["../../lib/plist.ts"],"names":[],"mappings":"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"}

package/build/lib/process.d.ts

@@ -1,3 +1,20 @@
-export function getProcessIds(appName: any): Promise<any[]>;
-export function killProcess(appName: any, force?: boolean): Promise<void>;
+/**
+ * Get PIDs of processes whose executable name matches the given name (exact match via pgrep -x).
+ *
+ * @param appName - Executable name to match (e.g. 'tail', 'node').
+ * @returns Promise resolving to an array of process IDs. Empty if no processes matched.
+ * @throws {Error} If pgrep fails for any reason other than "no processes matched" (exit 1).
+ * @deprecated Use a process-management API or package that fits your platform instead.
+ */
+export declare function getProcessIds(appName: string): Promise<number[]>;
+/**
+ * Kill all processes whose executable name matches the given name (via pkill -x).
+ *
+ * @param appName - Executable name to match (e.g. 'tail', 'node').
+ * @param force - If true, use SIGKILL (-9); otherwise use default pkill signal.
+ * @returns Promise that resolves when done, or when no matching processes were running.
+ * @throws {Error} If pkill fails for any reason other than "no processes matched" (exit 1).
+ * @deprecated Use a process-management API or package that fits your platform instead.
+ */
+export declare function killProcess(appName: string, force?: boolean): Promise<void>;
 //# sourceMappingURL=process.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../lib/process.js"],"names":[],"mappings":"AAUA,4DAeC;AAED,0EAgBC"}
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../lib/process.ts"],"names":[],"mappings":"AAWA;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAgBtE;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAe/E"}

package/build/lib/process.js

@@ -10,36 +10,53 @@ const teen_process_1 = require("teen_process");
  *  2. Syntax error in the command line.
  *  3. Fatal error: out of memory etc.
  */
+/**
+ * Get PIDs of processes whose executable name matches the given name (exact match via pgrep -x).
+ *
+ * @param appName - Executable name to match (e.g. 'tail', 'node').
+ * @returns Promise resolving to an array of process IDs. Empty if no processes matched.
+ * @throws {Error} If pgrep fails for any reason other than "no processes matched" (exit 1).
+ * @deprecated Use a process-management API or package that fits your platform instead.
+ */
 async function getProcessIds(appName) {
     let pids;
     try {
-        let { stdout } = await (0, teen_process_1.exec)('pgrep', ['-x', appName]);
+        const { stdout } = await (0, teen_process_1.exec)('pgrep', ['-x', appName]);
         pids = stdout
             .trim()
             .split('\n')
             .map((pid) => parseInt(pid, 10));
     }
     catch (err) {
-        if (parseInt(err.code, 10) !== 1) {
+        const code = err.code;
+        if (code !== 1) {
             throw new Error(`Error getting process ids for app '${appName}': ${err.message}`);
         }
         pids = [];
     }
     return pids;
 }
+/**
+ * Kill all processes whose executable name matches the given name (via pkill -x).
+ *
+ * @param appName - Executable name to match (e.g. 'tail', 'node').
+ * @param force - If true, use SIGKILL (-9); otherwise use default pkill signal.
+ * @returns Promise that resolves when done, or when no matching processes were running.
+ * @throws {Error} If pkill fails for any reason other than "no processes matched" (exit 1).
+ * @deprecated Use a process-management API or package that fits your platform instead.
+ */
 async function killProcess(appName, force = false) {
-    let pids = await getProcessIds(appName);
+    const pids = await getProcessIds(appName);
     if (pids.length === 0) {
-        // the process is not running
         return;
     }
     try {
-        let args = force ? ['-9'] : [];
-        args.push('-x', appName);
+        const args = force ? ['-9', '-x', appName] : ['-x', appName];
         await (0, teen_process_1.exec)('pkill', args);
     }
     catch (err) {
-        if (parseInt(err.code, 10) !== 1) {
+        const code = err.code;
+        if (code !== 1) {
             throw new Error(`Error killing app '${appName}' with pkill: ${err.message}`);
         }
     }

package/build/lib/process.js.map

@@ -1 +1 @@
-{"version":3,"file":"process.js","sourceRoot":"","sources":["../../lib/process.js"],"names":[],"mappings":";;AA6CQ,sCAAa;AAAE,kCAAW;AA7ClC,+CAAkC;AAElC;;;;;;GAMG;AAEH,KAAK,UAAU,aAAa,CAAC,OAAO;IAClC,IAAI,IAAI,CAAC;IACT,IAAI,CAAC;QACH,IAAI,EAAC,MAAM,EAAC,GAAG,MAAM,IAAA,mBAAI,EAAC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QACpD,IAAI,GAAG,MAAM;aACV,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,sCAAsC,OAAO,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACpF,CAAC;QACD,IAAI,GAAG,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,OAAO,EAAE,KAAK,GAAG,KAAK;IAC/C,IAAI,IAAI,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,6BAA6B;QAC7B,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,IAAI,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACzB,MAAM,IAAA,mBAAI,EAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,sBAAsB,OAAO,iBAAiB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../lib/process.ts"],"names":[],"mappings":";;AAmBA,sCAgBC;AAWD,kCAeC;AA7DD,+CAAkC;AAGlC;;;;;;GAMG;AAEH;;;;;;;GAOG;AACI,KAAK,UAAU,aAAa,CAAC,OAAe;IACjD,IAAI,IAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,EAAC,MAAM,EAAC,GAAG,MAAM,IAAA,mBAAI,EAAC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QACtD,IAAI,GAAG,MAAM;aACV,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,GAAI,GAAiB,CAAC,IAAI,CAAC;QACrC,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,sCAAsC,OAAO,MAAO,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/F,CAAC;QACD,IAAI,GAAG,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;GAQG;AACI,KAAK,UAAU,WAAW,CAAC,OAAe,EAAE,KAAK,GAAG,KAAK;IAC9D,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC7D,MAAM,IAAA,mBAAI,EAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,GAAI,GAAiB,CAAC,IAAI,CAAC;QACrC,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,sBAAsB,OAAO,iBAAkB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;AACH,CAAC"}

package/build/lib/system.d.ts

@@ -1,7 +1,42 @@
-export function isWindows(): boolean;
-export function isMac(): boolean;
-export function isLinux(): boolean;
-export function isOSWin64(): boolean;
-export function arch(): Promise<"32" | "64" | undefined>;
-export function macOsxVersion(): Promise<string>;
+/**
+ * Whether the current OS is Windows.
+ */
+export declare function isWindows(): boolean;
+/**
+ * Whether the current OS is macOS (Darwin).
+ */
+export declare function isMac(): boolean;
+/**
+ * Whether the current OS is Linux (i.e. not Windows and not macOS).
+ */
+export declare function isLinux(): boolean;
+/**
+ * Whether the current Windows process is 64-bit (or WOW64).
+ */
+export declare function isOSWin64(): boolean;
+/**
+ * Detects the major.minor macOS version (e.g. "10.12") via `sw_vers -productVersion`.
+ *
+ * @returns The major.minor version string.
+ * @throws {Error} If `sw_vers` fails or output cannot be parsed.
+ */
+export declare function macOsxVersion(): Promise<string>;
+/**
+ * System detection helpers (platform, architecture, macOS version).
+ * Use this object when you need `arch()` to call other helpers via `this` (e.g. for testing).
+ */
+export declare const system: System;
+/**
+ * Resolves the process architecture as `'32'` or `'64'` (uname on Unix, process.arch/env on Windows).
+ */
+export declare const arch: () => Promise<string>;
+interface System {
+    isWindows(): boolean;
+    isMac(): boolean;
+    isLinux(): boolean;
+    isOSWin64(): boolean;
+    arch(): Promise<string>;
+    macOsxVersion(): Promise<string>;
+}
+export {};
 //# sourceMappingURL=system.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../lib/system.js"],"names":[],"mappings":"AAMA,qCAEC;AAED,iCAEC;AAED,mCAEC;AAED,qCAEC;AAED,yDAQC;AAED,iDAaC"}
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../lib/system.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;GAEG;AACH,wBAAgB,KAAK,IAAI,OAAO,CAE/B;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAEjC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAarD;AAED;;;GAGG;AACH,eAAO,MAAM,MAAM,EAAE,MAOpB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,IAAI,QASP,OAAO,CAAC,MAAM,CAAC,AATM,CAAC;AAIhC,UAAU,MAAM;IACd,SAAS,IAAI,OAAO,CAAC;IACrB,KAAK,IAAI,OAAO,CAAC;IACjB,OAAO,IAAI,OAAO,CAAC;IACnB,SAAS,IAAI,OAAO,CAAC;IACrB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAClC"}

package/build/lib/system.js

@@ -3,38 +3,46 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.arch = exports.system = void 0;
 exports.isWindows = isWindows;
 exports.isMac = isMac;
 exports.isLinux = isLinux;
 exports.isOSWin64 = isOSWin64;
-exports.arch = arch;
 exports.macOsxVersion = macOsxVersion;
 const teen_process_1 = require("teen_process");
 const lodash_1 = __importDefault(require("lodash"));
-const os_1 = __importDefault(require("os"));
+const node_os_1 = __importDefault(require("node:os"));
 const VERSION_PATTERN = /^(\d+\.\d+)/m;
+/**
+ * Whether the current OS is Windows.
+ */
 function isWindows() {
-    return os_1.default.type() === 'Windows_NT';
+    return node_os_1.default.type() === 'Windows_NT';
 }
+/**
+ * Whether the current OS is macOS (Darwin).
+ */
 function isMac() {
-    return os_1.default.type() === 'Darwin';
+    return node_os_1.default.type() === 'Darwin';
 }
+/**
+ * Whether the current OS is Linux (i.e. not Windows and not macOS).
+ */
 function isLinux() {
     return !isWindows() && !isMac();
 }
+/**
+ * Whether the current Windows process is 64-bit (or WOW64).
+ */
 function isOSWin64() {
     return process.arch === 'x64' || lodash_1.default.has(process.env, 'PROCESSOR_ARCHITEW6432');
 }
-async function arch() {
-    if (isLinux() || isMac()) {
-        let { stdout } = await (0, teen_process_1.exec)('uname', ['-m']);
-        return stdout.trim() === 'i686' ? '32' : '64';
-    }
-    else if (isWindows()) {
-        let is64 = this.isOSWin64();
-        return is64 ? '64' : '32';
-    }
-}
+/**
+ * Detects the major.minor macOS version (e.g. "10.12") via `sw_vers -productVersion`.
+ *
+ * @returns The major.minor version string.
+ * @throws {Error} If `sw_vers` fails or output cannot be parsed.
+ */
 async function macOsxVersion() {
     let stdout;
     try {
@@ -49,4 +57,31 @@ async function macOsxVersion() {
     }
     return versionMatch[1];
 }
+/**
+ * System detection helpers (platform, architecture, macOS version).
+ * Use this object when you need `arch()` to call other helpers via `this` (e.g. for testing).
+ */
+exports.system = {
+    isWindows,
+    isMac,
+    isLinux,
+    isOSWin64,
+    arch: archImpl,
+    macOsxVersion,
+};
+/**
+ * Resolves the process architecture as `'32'` or `'64'` (uname on Unix, process.arch/env on Windows).
+ */
+exports.arch = exports.system.arch;
+async function archImpl() {
+    if (this.isLinux() || this.isMac()) {
+        const { stdout } = await (0, teen_process_1.exec)('uname', ['-m']);
+        return stdout.trim() === 'i686' ? '32' : '64';
+    }
+    else if (this.isWindows()) {
+        return this.isOSWin64() ? '64' : '32';
+    }
+    return '64';
+}
+// #endregion
 //# sourceMappingURL=system.js.map

package/build/lib/system.js.map

@@ -1 +1 @@
-{"version":3,"file":"system.js","sourceRoot":"","sources":["../../lib/system.js"],"names":[],"mappings":";;;;;AA+CQ,8BAAS;AAAE,sBAAK;AAAE,0BAAO;AAAE,8BAAS;AAAE,oBAAI;AAAE,sCAAa;AA/CjE,+CAAkC;AAClC,oDAAuB;AACvB,4CAAoB;AAEpB,MAAM,eAAe,GAAG,cAAc,CAAC;AAEvC,SAAS,SAAS;IAChB,OAAO,YAAE,CAAC,IAAI,EAAE,KAAK,YAAY,CAAC;AACpC,CAAC;AAED,SAAS,KAAK;IACZ,OAAO,YAAE,CAAC,IAAI,EAAE,KAAK,QAAQ,CAAC;AAChC,CAAC;AAED,SAAS,OAAO;IACd,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,OAAO,CAAC,IAAI,KAAK,KAAK,IAAI,gBAAC,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,wBAAwB,CAAC,CAAC;AAChF,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,IAAI,OAAO,EAAE,IAAI,KAAK,EAAE,EAAE,CAAC;QACzB,IAAI,EAAC,MAAM,EAAC,GAAG,MAAM,IAAA,mBAAI,EAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3C,OAAO,MAAM,CAAC,IAAI,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAChD,CAAC;SAAM,IAAI,SAAS,EAAE,EAAE,CAAC;QACvB,IAAI,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa;IAC1B,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,MAAM,IAAA,mBAAI,EAAC,SAAS,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACtE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,sCAAsC,GAAG,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,2DAA2D,MAAM,GAAG,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC;AACzB,CAAC"}
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../../lib/system.ts"],"names":[],"mappings":";;;;;;AASA,8BAEC;AAKD,sBAEC;AAKD,0BAEC;AAKD,8BAEC;AAQD,sCAaC;AArDD,+CAAkC;AAClC,oDAAuB;AACvB,sDAAyB;AAEzB,MAAM,eAAe,GAAG,cAAc,CAAC;AAEvC;;GAEG;AACH,SAAgB,SAAS;IACvB,OAAO,iBAAE,CAAC,IAAI,EAAE,KAAK,YAAY,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,SAAgB,KAAK;IACnB,OAAO,iBAAE,CAAC,IAAI,EAAE,KAAK,QAAQ,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,SAAgB,OAAO;IACrB,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,SAAS;IACvB,OAAO,OAAO,CAAC,IAAI,KAAK,KAAK,IAAI,gBAAC,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,wBAAwB,CAAC,CAAC;AAChF,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,aAAa;IACjC,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,MAAM,IAAA,mBAAI,EAAC,SAAS,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACtE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,sCAAsC,GAAG,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,2DAA2D,MAAM,GAAG,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC;AACzB,CAAC;AAED;;;GAGG;AACU,QAAA,MAAM,GAAW;IAC5B,SAAS;IACT,KAAK;IACL,OAAO;IACP,SAAS;IACT,IAAI,EAAE,QAAQ;IACd,aAAa;CACd,CAAC;AAEF;;GAEG;AACU,QAAA,IAAI,GAAG,cAAM,CAAC,IAAI,CAAC;AAahC,KAAK,UAAU,QAAQ;IACrB,IAAI,IAAI,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;QACnC,MAAM,EAAC,MAAM,EAAC,GAAG,MAAM,IAAA,mBAAI,EAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7C,OAAO,MAAM,CAAC,IAAI,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAChD,CAAC;SAAM,IAAI,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACxC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,aAAa"}

package/build/lib/tempdir.d.ts

@@ -1,63 +1,40 @@
-export type Affixes = {
-    /**
-     * - prefix of the temp directory name
-     */
-    prefix?: string | undefined;
-    /**
-     * - suffix of the temp directory name
-     */
-    suffix?: string | undefined;
-};
-export type OpenedAffixes = {
-    /**
-     * - The path to file
-     */
+import _ from 'lodash';
+/** Prefix/suffix for temp directory or file names */
+export interface Affixes {
+    prefix?: string;
+    suffix?: string;
+}
+/** Result of opening a temp file */
+export interface OpenedAffixes {
     path: string;
-    /**
-     * - The file descriptor opened
-     */
     fd: number;
-};
+}
 /**
- * @typedef OpenedAffixes
- * @property {string} path - The path to file
- * @property {number} fd - The file descriptor opened
- */
-/**
- * Generate a temporary directory in os.tempdir() or process.env.APPIUM_TMP_DIR
- * with arbitrary prefix/suffix for the directory name and return it as open.
+ * Generate a temporary directory with arbitrary prefix/suffix for the directory name.
  *
- * @param {Affixes} affixes
- * @returns {Promise<OpenedAffixes>}
+ * @param rawAffixes - Prefix string, or object with prefix/suffix, or omitted.
+ * @param defaultPrefix - Default prefix when rawAffixes is omitted.
+ * @returns A path to the temporary directory.
  */
-export function open(affixes: Affixes): Promise<OpenedAffixes>;
+export declare function path(rawAffixes?: string | Affixes, defaultPrefix?: string): Promise<string>;
 /**
- * @typedef Affixes
- * @property {string} [prefix] - prefix of the temp directory name
- * @property {string} [suffix] - suffix of the temp directory name
- */
-/**
- * Generate a temporary directory in os.tempdir() or process.env.APPIUM_TMP_DIR
- * with arbitrary prefix/suffix for the directory name.
+ * Generate a temp file path with prefix/suffix, open the file, and return path and fd.
  *
- * @param {string|Affixes} rawAffixes
- * @param {string} [defaultPrefix]
- * @returns {Promise<string>}  A path to the temporary directory with rawAffixes and defaultPrefix
+ * @param affixes - Prefix/suffix for the file name.
+ * @returns The opened file path and descriptor.
  */
-export function path(rawAffixes: string | Affixes, defaultPrefix?: string): Promise<string>;
+export declare function open(affixes: Affixes): Promise<OpenedAffixes>;
+/** Returns a new path to a temporary directory (alias for the tempDir implementation). */
+export declare const openDir: typeof tempDir;
 /**
- * Generate a temporary directory in os.tempdir() or process.env.APPIUM_TMP_DIR.
- * e.g.
- * - No `process.env.APPIUM_TMP_DIR`: `/var/folders/34/2222sh8n27d6rcp7jqlkw8km0000gn/T/xxxxxxxx.yyyy`
- * - With `process.env.APPIUM_TMP_DIR = '/path/to/root'`: `/path/to/root/xxxxxxxx.yyyy`
+ * Returns a path to a temporary directory which is reused for the life of the process.
  *
- * @returns {Promise<string>} A path to the temporary directory
+ * @returns The same temp directory path on every call.
  */
-export function openDir(): Promise<string>;
+export declare const staticDir: (() => Promise<string>) & _.MemoizedFunction;
 /**
- * Returns a path to a temporary directory which is defined as static in the same process
- *
- * @returns {Promise<string>} A temp directory path which is defined as static in the same process
+ * Generate a temporary directory in os.tmpdir() or process.env.APPIUM_TMP_DIR.
  */
-export function staticDir(): Promise<string>;
+declare function tempDir(): Promise<string>;
+export {};
 //# sourceMappingURL=tempdir.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tempdir.d.ts","sourceRoot":"","sources":["../../lib/tempdir.js"],"names":[],"mappings":";;;;;;;;;;;;;;UA6Dc,MAAM;;;;QACN,MAAM;;AAHpB;;;;GAIG;AAEH;;;;;;GAMG;AACH,8BAHW,OAAO,GACL,OAAO,CAAC,aAAa,CAAC,CAWlC;AA3CD;;;;GAIG;AAEH;;;;;;;GAOG;AACH,iCAJW,MAAM,GAAC,OAAO,kBACd,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAO3B;AAhDD;;;;;;;GAOG;AACH,2BAFa,OAAO,CAAC,MAAM,CAAC,CAqB3B;AAoFD;;;;GAIG;AAEH,6BAHa,OAAO,CAAC,MAAM,CAAC,CAK3B"}
+{"version":3,"file":"tempdir.d.ts","sourceRoot":"","sources":["../../lib/tempdir.ts"],"names":[],"mappings":"AAIA,OAAO,CAAC,MAAM,QAAQ,CAAC;AAMvB,qDAAqD;AACrD,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;GAMG;AACH,wBAAsB,IAAI,CACxB,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,EAC7B,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED;;;;;GAKG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAQnE;AAED,0FAA0F;AAC1F,eAAO,MAAM,OAAO,gBAAU,CAAC;AAE/B;;;;GAIG;AACH,eAAO,MAAM,SAAS,SAA0C,OAAO,CAAC,MAAM,CAAC,sBAE7E,CAAC;AAIH;;GAEG;AACH,iBAAe,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAkBxC"}