@appium/support 7.0.5 → 7.0.6

package/build/lib/npm.js

@@ -1,5 +1,4 @@
 "use strict";
-// @ts-check
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -59,100 +58,88 @@ exports.INSTALL_LOCKFILE_RELATIVE_PATH = node_path_1.default.join(exports.CACHE_
  * XXX: This should probably be a singleton, but it isn't.  Maybe this module should just export functions?
  */
 class NPM {
-    /**
-     * Returns path to "install" lockfile
-     * @private
-     * @param {string} cwd
-     */
-    _getInstallLockfilePath(cwd) {
-        return node_path_1.default.join(cwd, exports.INSTALL_LOCKFILE_RELATIVE_PATH);
-    }
     /**
      * Execute `npm` with given args.
      *
      * If the process exits with a nonzero code, the contents of `STDOUT` and `STDERR` will be in the
      * `message` of any rejected error.
-     * @param {string} cmd
-     * @param {string[]} args
-     * @param {ExecOpts} opts
-     * @param {Omit<TeenProcessExecOptions, 'cwd'>} [execOpts]
      */
     async exec(cmd, args, opts, execOpts = {}) {
         const { cwd, json, lockFile } = opts;
-        // make sure we perform the current operation in cwd
-        /** @type {TeenProcessExecOptions} */
         const teenProcessExecOpts = {
             ...execOpts,
-            // https://github.com/nodejs/node/issues/52572
             shell: system.isWindows() || execOpts.shell,
             cwd,
         };
-        args.unshift(cmd);
+        const argsCopy = [cmd, ...args];
         if (json) {
-            args.push('--json');
+            argsCopy.push('--json');
         }
         const npmCmd = system.isWindows() ? 'npm.cmd' : 'npm';
-        let runner = async () => await (0, teen_process_1.exec)(npmCmd, args, teenProcessExecOpts);
+        let runner = async () => await (0, teen_process_1.exec)(npmCmd, argsCopy, teenProcessExecOpts);
         if (lockFile) {
             const acquireLock = util.getLockFileGuard(lockFile);
             const _runner = runner;
-            runner = async () => await acquireLock(_runner);
+            runner = async () => (await acquireLock(_runner));
         }
-        /** @type {import('teen_process').TeenProcessExecResult<string> & {json?: any}} */
         let ret;
         try {
             const { stdout, stderr, code } = await runner();
             ret = { stdout, stderr, code };
-            // if possible, parse NPM's json output. During NPM install 3rd-party
-            // packages can write to stdout, so sometimes the json output can't be
-            // guaranteed to be parseable
             try {
                 ret.json = JSON.parse(stdout);
             }
-            catch { }
+            catch {
+                // ignore
+            }
         }
         catch (e) {
-            const { stdout = '', stderr = '', code = null, } = /** @type {import('teen_process').ExecError} */ (e);
-            const err = new Error(`npm command '${args.join(' ')}' failed with code ${code}.\n\nSTDOUT:\n${stdout.trim()}\n\nSTDERR:\n${stderr.trim()}`);
-            throw err;
+            const { stdout = '', stderr = '', code = null } = e;
+            throw new Error(`npm command '${argsCopy.join(' ')}' failed with code ${code}.\n\nSTDOUT:\n${stdout.trim()}\n\nSTDERR:\n${stderr.trim()}`);
         }
         return ret;
     }
     /**
-     * @param {string} cwd
-     * @param {string} pkg
-     * @returns {Promise<string?>}
+     * Gets the latest published version of a package from npm registry.
+     *
+     * @param cwd - Current working directory for npm command
+     * @param pkg - Package name to query
+     * @returns Latest version string, or `null` if package not found (e.g. 404)
      */
     async getLatestVersion(cwd, pkg) {
         try {
-            return ((await this.exec('view', [pkg, 'dist-tags'], {
-                json: true,
-                cwd,
-            })).json?.latest ?? null);
+            const result = await this.exec('view', [pkg, 'dist-tags'], { json: true, cwd });
+            const json = result.json;
+            return json?.latest ?? null;
         }
         catch (err) {
-            if (!err?.message.includes('E404')) {
+            if (!(err instanceof Error) || !err.message.includes('E404')) {
                 throw err;
             }
             return null;
         }
     }
     /**
-     * @param {string} cwd
-     * @param {string} pkg
-     * @param {string} curVersion
-     * @returns {Promise<string?>}
+     * Gets the latest version of a package that is a safe upgrade from the current version
+     * (same major, no prereleases). Fetches versions from npm and delegates to
+     * {@link NPM.getLatestSafeUpgradeFromVersions}.
+     *
+     * @param cwd - Current working directory for npm command
+     * @param pkg - Package name to query
+     * @param curVersion - Current installed version
+     * @returns Latest safe upgrade version string, or `null` if none or package not found
      */
     async getLatestSafeUpgradeVersion(cwd, pkg, curVersion) {
         try {
-            const allVersions = (await this.exec('view', [pkg, 'versions'], {
-                json: true,
-                cwd,
-            })).json;
+            const result = await this.exec('view', [pkg, 'versions'], { json: true, cwd });
+            const allVersions = result.json;
+            if (!Array.isArray(allVersions)) {
+                return null;
+            }
             return this.getLatestSafeUpgradeFromVersions(curVersion, allVersions);
         }
         catch (err) {
-            if (!err?.message.includes('E404')) {
+            if (!(err instanceof Error) || !err.message.includes('E404')) {
                 throw err;
             }
             return null;
@@ -160,8 +147,6 @@ class NPM {
     }
     /**
      * Runs `npm ls`, optionally for a particular package.
-     * @param {string} cwd
-     * @param {string} [pkg]
      */
     async list(cwd, pkg) {
         return (await this.exec('list', pkg ? [pkg] : [], { cwd, json: true })).json;
@@ -170,11 +155,6 @@ class NPM {
      * Given a current version and a list of all versions for a package, return the version which is
      * the highest safely-upgradable version (meaning not crossing any major revision boundaries, and
      * not including any alpha/beta/rc versions)
-     *
-     * @param {string} curVersion - the current version of a package
-     * @param {Array<string>} allVersions - a list of version strings
-     *
-     * @return {string|null} - the highest safely-upgradable version, or null if there isn't one
      */
     getLatestSafeUpgradeFromVersions(curVersion, allVersions) {
         let safeUpgradeVer = null;
@@ -184,48 +164,31 @@ class NPM {
         }
         for (const testVer of allVersions) {
             const testSemver = semver.parse(testVer) ?? semver.parse(semver.coerce(testVer));
-            if (testSemver === null) {
-                continue;
-            }
-            // if the test version is a prerelease, ignore it
-            if (testSemver.prerelease.length > 0) {
-                continue;
-            }
-            // if the current version is later than the test version, skip this test version
-            if (curSemver.compare(testSemver) === 1) {
-                continue;
-            }
-            // if the test version is newer, but crosses a major revision boundary, also skip it
-            if (testSemver.major > curSemver.major) {
+            if (testSemver === null ||
+                testSemver.prerelease.length > 0 ||
+                curSemver.compare(testSemver) === 1 ||
+                testSemver.major > curSemver.major) {
                 continue;
             }
-            // otherwise this version is safe to upgrade to. But there might be multiple ones of this
-            // kind, so keep iterating and keeping the highest
             if (safeUpgradeVer === null || testSemver.compare(safeUpgradeVer) === 1) {
                 safeUpgradeVer = testSemver;
             }
         }
-        if (safeUpgradeVer) {
-            safeUpgradeVer = safeUpgradeVer.format();
-        }
-        return safeUpgradeVer;
+        return safeUpgradeVer ? safeUpgradeVer.format() : null;
     }
     /**
      * Installs a package w/ `npm`
-     * @param {string} cwd
-     * @param {string} installStr - as in "npm install <installStr>"
-     * @param {InstallPackageOpts} opts
-     * @returns {Promise<NpmInstallReceipt>}
      */
-    async installPackage(cwd, installStr, { pkgName, installType }) {
-        /** @type {any} */
+    async installPackage(cwd, installStr, opts) {
+        const { pkgName, installType } = opts;
         let dummyPkgJson;
         const dummyPkgPath = node_path_1.default.join(cwd, 'package.json');
         try {
             dummyPkgJson = JSON.parse(await fs_1.fs.readFile(dummyPkgPath, 'utf8'));
         }
         catch (err) {
-            if (err.code === 'ENOENT') {
+            const nodeErr = err;
+            if (nodeErr.code === 'ENOENT') {
                 dummyPkgJson = {};
                 await fs_1.fs.writeFile(dummyPkgPath, JSON.stringify(dummyPkgJson, null, 2), 'utf8');
             }
@@ -246,17 +209,9 @@ class NPM {
             json: true,
             lockFile: this._getInstallLockfilePath(cwd),
         });
-        if (res.json) {
-            // we parsed a valid json response, so if we got an error here, return that
-            // message straightaway
-            if (res.json.error) {
-                throw new Error(res.json.error);
-            }
+        if (res.json && typeof res.json === 'object' && 'error' in res.json && res.json.error) {
+            throw new Error(String(res.json.error));
         }
-        // Now read package data from the installed package to return, and make sure
-        // everything got installed ok. Remember, pkgName might end up with a / in it due to an npm
-        // org, so if so, that will get correctly exploded into multiple directories, by path.resolve here
-        // (even on Windows!)
         const pkgJsonPath = (0, resolve_from_1.default)(cwd, `${pkgName}/package.json`);
         try {
             const pkgJson = await fs_1.fs.readFile(pkgJsonPath, 'utf8');
@@ -270,8 +225,10 @@ class NPM {
         }
     }
     /**
-     * @param {string} cwd
-     * @param {string} pkg
+     * Uninstalls a package with `npm uninstall`.
+     *
+     * @param cwd - Current working directory (project root)
+     * @param pkg - Package name to uninstall
      */
     async uninstallPackage(cwd, pkg) {
         await this.exec('uninstall', [pkg], {
@@ -280,39 +237,24 @@ class NPM {
         });
     }
     /**
-     * @param {string} pkg Npm package spec to query
-     * @param {string[]} [entries=[]] Field names to be included into the
-     * resulting output. By default all fields are included.
-     * @returns {Promise<import('@appium/types').StringRecord>}
+     * Fetches package metadata from the npm registry via `npm info`.
+     *
+     * @param pkg - Npm package spec to query
+     * @param entries - Field names to be included into the resulting output. By default all fields are included.
+     * @returns Package metadata as a record of string values
      */
     async getPackageInfo(pkg, entries = []) {
-        return (await this.exec('info', [pkg, ...entries], {
+        const result = await this.exec('info', [pkg, ...entries], {
             cwd: process.cwd(),
             json: true,
-        })).json;
+        });
+        return (result.json ?? {});
+    }
+    /** Returns path to "install" lockfile */
+    _getInstallLockfilePath(cwd) {
+        return node_path_1.default.join(cwd, exports.INSTALL_LOCKFILE_RELATIVE_PATH);
     }
 }
 exports.NPM = NPM;
 exports.npm = new NPM();
-/**
- * Options for {@link NPM.installPackage}
- * @typedef InstallPackageOpts
- * @property {string} pkgName - the name of the package to install
- * @property {import('type-fest').LiteralUnion<'local', string>} [installType] - whether to install from a local path or from npm
- */
-/**
- * Options for {@link NPM.exec}
- * @typedef ExecOpts
- * @property {string} cwd - Current working directory
- * @property {boolean} [json] - If `true`, supply `--json` flag to npm and resolve w/ parsed JSON
- * @property {string} [lockFile] - Path to lockfile to use
- */
-/**
- * @typedef {import('teen_process').TeenProcessExecOptions} TeenProcessExecOptions
- */
-/**
- * @typedef NpmInstallReceipt
- * @property {string} installPath - Path to installed package
- * @property {import('type-fest').PackageJson} pkg - Package data
- */
 //# sourceMappingURL=npm.js.map

package/build/lib/npm.js.map

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

package/build/lib/plist.d.ts

@@ -1,43 +1,50 @@
 /**
  * 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
  */
-export function parsePlistFile(plist: string, mustExist?: boolean, quiet?: boolean): Promise<any>;
+export declare function parsePlistFile(plist: string, mustExist?: boolean, quiet?: boolean): Promise<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
- * @throws Will throw an error if the plist type is unknown
+ * Updates a plist file with the given fields
+ *
+ * @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
  */
-export function parsePlist(data: string | Buffer): any;
+export declare function updatePlistFile(plist: string, updatedFields: object, binary?: boolean, mustExist?: boolean, quiet?: boolean): Promise<void>;
 /**
- * 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
+ * Creates a binary plist Buffer from an object
+ *
+ * @param data - The object to be turned into a binary plist
+ * @returns Plist in the form of a binary buffer
  */
-export function createPlist(object: any, binary?: boolean): string | Buffer;
+export declare function createBinaryPlist(data: object): Buffer;
 /**
- * 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
+ * Parses a Buffer into an Object
+ *
+ * @param data - The buffer of a binary plist
+ * @returns Array of parsed root objects (typically one element)
  */
-export function updatePlistFile(plist: string, updatedFields: any, binary?: boolean, mustExist?: boolean, quiet?: boolean): Promise<void>;
+export declare function parseBinaryPlist(data: Buffer): object[];
 /**
- * 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
+ * Creates a plist from an object
+ *
+ * @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
  */
-export function createBinaryPlist(data: any): Buffer;
+export declare function createPlist(object: object, binary?: boolean): Buffer | string;
 /**
- * Parses a Buffer into an Object
- * @param {Buffer} data The buffer of a binary plist
+ * 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
  */
-export function parseBinaryPlist(data: Buffer): [any];
+export declare function parsePlist(data: string | Buffer): object;
 //# sourceMappingURL=plist.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"plist.d.ts","sourceRoot":"","sources":["../../lib/plist.js"],"names":[],"mappings":"AAsBA;;;;;;GAMG;AACH,sCALW,MAAM,cACN,OAAO,UACP,OAAO,GACL,OAAO,CAAC,GAAG,CAAC,CAmCxB;AA4FD;;;;;GAKG;AACH,iCAJW,MAAM,GAAC,MAAM,OAgBvB;AAhCD;;;;;GAKG;AACH,kDAHW,OAAO,GACL,MAAM,GAAC,MAAM,CAQzB;AAxFD;;;;;;;GAOG;AACH,uCANW,MAAM,+BAEN,OAAO,cACP,OAAO,UACP,OAAO,iBAyBjB;AACD;;;;GAIG;AACH,8CAFa,MAAM,CAIlB;AAED;;;GAGG;AACH,uCAFW,MAAM,SAIhB"}
+{"version":3,"file":"plist.d.ts","sourceRoot":"","sources":["../../lib/plist.ts"],"names":[],"mappings":"AAgBA;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,SAAS,UAAO,EAChB,KAAK,UAAO,GACX,OAAO,CAAC,MAAM,CAAC,CAmCjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,EACrB,MAAM,UAAO,EACb,SAAS,UAAO,EAChB,KAAK,UAAO,GACX,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEvD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,MAAM,GAAG,MAAM,CAK3E;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAcxD"}

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