@appium/support 4.1.10 → 4.2.0

package/README.md

@@ -1,11 +1,15 @@
-# appium-support
+# @appium/support
 
-Utility functions used to support Appium drivers and plugins.
+> Utility functions used to support Appium drivers and plugins
 
-# Usage in drivers and plugins
+[![NPM version](http://img.shields.io/npm/v/@appium/support.svg)](https://npmjs.org/package/@appium/support)
+[![Downloads](http://img.shields.io/npm/dm/@appium/support.svg)](https://npmjs.org/package/@appium/support)
 
-It is recommended to have Appium as a peer dependency in driver and plugin packages.
-Add the following line to `peerDependencies` section of your module's `package.json`:
+## Usage in drivers and plugins
+
+Drivers and plugins are recommended to have Appium as a peer dependency, as it already includes
+these utility functions. Add the following line to `peerDependencies` section of your module's
+`package.json`:
 
 ```js
   "peerDependencies": {
@@ -19,7 +23,7 @@ Afterwards import it in your code similarly to the below example:
 import {timing, util} from 'appium/support';
 ```
 
-# Usage in helper modules
+## Usage in helper modules
 
 If you want to use this module in a helper library, which is not a driver or a plugin,
 then add the following line to `dependencies` section of your module's `package.json`:
@@ -36,96 +40,49 @@ Afterwards import it in your code similarly to the below example:
 import {timing, util} from '@appium/support';
 ```
 
-### Categories
+## Categories
 
 All utility functions are split into a bunch of different categories. Each category has its own file under the `lib` folder. All utility functions in these files are documented.
 
-#### fs
-
-Most of the functions there are just thin wrappers over utility functions available in [Promises API](https://nodejs.org/api/fs.html#promises-api).
-
-#### env
-
-Several helpers needed by the server to cope with internal dependencies and manifests.
-
-#### console
-
-Wrappers for the command line interface abstraction used by the Appium server.
-
-#### image-util
-
-Utilities to work with images. Use [sharp](https://github.com/lovell/sharp) under the hood.
-
-#### log-internal
-
-Utilities needed for internal Appium log config assistance.
-
-#### logging
-
-See [below](#logger)
-
-#### mjpeg
-
-Helpers needed to implement [MJPEG streaming](https://en.wikipedia.org/wiki/Motion_JPEG#Video_streaming).
-
-#### net
-
-Helpers needed for network interactions, for example, upload and download of files.
-
-#### node
-
-Set of Node.js-specific utility functions needed, for example, to ensure objects immutability or to calculate their sizes.
-
-#### npm
-
-Set of [npm](https://en.wikipedia.org/wiki/Npm_(software))-related helpers.
-
-#### plist
-
-Set of utilities used to read and write data from [plist](https://en.wikipedia.org/wiki/Property_List) files in javascript.
-
-#### process
-
-Helpers for interactions with system processes. These APIs don't support Windows.
-
-#### system
-
-Set of helper functions needed to determine properties of the current operating system.
-
-#### tempdir
-
-Set of helpers that allow interactions with temporary folders.
-
-#### timing
-
-Helpers that allow to measure execution time.
-
-#### util
-
-Miscellaneous utilities.
-
-#### zip
-
-Helpers that allow to work with archives in .ZIP format.
-
-
-## logger
-
-Basic logger defaulting to [npmlog](https://github.com/npm/npmlog) with special consideration for running
-tests (doesn't output logs when run with `_TESTING=1` in the env).
+|Category|Description|
+|-|-|
+|console|Wrappers for the command line interface abstraction used by the Appium server|
+|doctor|Common doctor utilities that can be used by drivers and plugins|
+|env|Several helpers needed by the server to cope with internal dependencies and manifests|
+|fs|Most of the functions here are just thin wrappers over utility functions available in [Promises API](https://nodejs.org/api/fs.html#promises-api)|
+|image-util|Utilities to work with images. Use [sharp](https://github.com/lovell/sharp) under the hood.<br>:bangbang: Node >=18.17 is required to use these utilities|
+|log-internal|Utilities needed for internal Appium log config assistance|
+|logging|See [the logging section below](#logging)|
+|mjpeg|Helpers needed to implement [MJPEG streaming](https://en.wikipedia.org/wiki/Motion_JPEG#Video_streaming)|
+|net|Helpers needed for network interactions, for example, upload and download of files|
+|node|Set of Node.js-specific utility functions needed, for example, to ensure objects immutability or to calculate their sizes|
+|npm|Set of `npm`-related helpers|
+|plist|Set of utilities used to read and write data from [plist](https://en.wikipedia.org/wiki/Property_List) files in javascript|
+|process|Helpers for interactions with system processes. These APIs don't support Windows.|
+|system|Set of helper functions needed to determine properties of the current operating system|
+|tempdir|Set of helpers that allow interactions with temporary folders|
+|timing|Helpers that allow to measure execution time|
+|util|Miscellaneous utilities|
+|zip|Helpers that allow to work with archives in `.zip ` format|
+
+## logging
+
+This is a basic logger defaulting to [npmlog](https://github.com/npm/npmlog) with special
+consideration for running tests (doesn't output logs when run with `_TESTING=1`).
 
 ### Logging levels
 
-There are a number of levels, exposed as methods on the log object, at which logging can be made. The built-in ones correspond to those of [npmlog](https://github.com/npm/npmlog#loglevelprefix-message-), and are:
-`silly`, `verbose`, `info`, `http`, `warn`, and `error`. In addition there is a `debug` level.
+There are a number of levels, exposed as methods on the log object, at which logging can be made.
+The built-in ones correspond to those of [npmlog](https://github.com/npm/npmlog#loglevelprefix-message-),
+and are: `silly`, `verbose`, `info`, `http`, `warn`, and `error`. There is also a `debug` level.
 
 The default threshold level is `verbose`.
 
 The logged output, by default, will be `level prefix message`. So
 
 ```js
-import { logger } from 'appium-support';
-let log = logger.getLogger('mymodule');
+import {logging} from 'appium/support';
+let log = logging.getLogger('mymodule');
 log.warn('a warning');`
 ```
 
@@ -139,27 +96,25 @@ warn mymodule a warning
 
 There are two environment variable flags that affect the way `logger` works.
 
-`_TESTING`
-
-- `_TESTING=1` stops output of logs when set to `1`.
-
-`_FORCE_LOGS`
-
-- This flag, when set to `1`, reverses the `_TESTING`
-
+|Variable|Description|
+|-|-|
+|`_TESTING`|If set to `1`, logging output is stopped|
+|`_FORCE_LOGS`|If set to `1`, overrides the value of `_TESTING`|
 
 ### Usage
 
 `log.level`
 
-- get and set the threshold level at which to display the logs. Any logs at or above this level will be displayed. The special level silent will prevent anything from being displayed ever. See [npmlog#level](https://github.com/npm/npmlog#loglevel).
+- Get and set the threshold level at which to display the logs. Any logs at or above this level will
+be displayed. The special level `silent` will prevent anything from being displayed ever. See
+[npmlog#level](https://github.com/npm/npmlog#loglevel) for more details.
 
 `log[level](message)`
 
-- logs to `level`
+- Logs `message` at the specified `level`
 ```js
-import { logger } from 'appium-support';
-let log = logger.getLogger('mymodule');
+import {logging} from 'appium/support';
+let log = logging.getLogger('mymodule');
 
 log.info('hi!');
 // => info mymodule hi!
@@ -167,11 +122,13 @@ log.info('hi!');
 
 `log.unwrap()`
 
-- retrieves the underlying [npmlog](https://github.com/npm/npmlog) object, in order to manage how logging is done at a low level (e.g., changing output streams, retrieving an array of messages, adding log levels, etc.).
+- Retrieves the underlying [npmlog](https://github.com/npm/npmlog) object, in order to manage how
+logging is done at a low level (e.g., changing output streams, retrieving an array of messages,
+adding log levels, etc.).
 
 ```js
-import { getLogger } from 'appium-base-driver';
-let log = getLogger('mymodule');
+import {logging} from 'appium/support';
+let log = logging.getLogger('mymodule');
 
 log.info('hi!');
 
@@ -182,18 +139,24 @@ let logs = npmlogger.record;
 // logs === [ { id: 0, level: 'info', prefix: 'mymodule', message: 'hi!', messageRaw: [ 'hi!' ] }]
 ```
 
-`log.errorAndThrow(error)`
+`log.errorWithException(error)`
 
-- logs the error passed in, at `error` level, and then throws the error. If the error passed in is not an instance of [Error](https://nodejs.org/api/errors.html#errors_class_error) (either directly, or a subclass of `Error`) it will be wrapped in a generic `Error` object.
+- Logs the error passed in, at `error` level, and then returns the error. If the error passed in is
+not an instance of [Error](https://nodejs.org/api/errors.html#errors_class_error) (either directly,
+or a subclass of `Error`), it will be wrapped in a generic `Error` object.
 
 ```js
-import { getLogger } from 'appium-base-driver';
-let log = getLogger('mymodule');
+import {logging} from 'appium/support';
+let log = logging.getLogger('mymodule');
 
 // previously there would be two lines
 log.error('This is an error');
 throw new Error('This is an error');
 
 // now is compacted
-log.errorAndThrow('This is an error');
+throw log.errorWithException('This is an error');
 ```
+
+## License
+
+Apache-2.0

package/build/lib/console.js

@@ -153,6 +153,7 @@ class CliConsole {
         this.log(this.decorate(message, 'error'), ...args);
     }
 }
+exports.CliConsole = CliConsole;
 _CliConsole_console = new WeakMap(), _CliConsole_useSymbols = new WeakMap(), _CliConsole_useColor = new WeakMap();
 /**
  * @type {Record<keyof typeof symbols,keyof Extract<import('@colors/colors').Color, 'string'>>}
@@ -163,7 +164,6 @@ CliConsole.symbolToColor = {
     warning: 'yellow',
     error: 'red',
 };
-exports.CliConsole = CliConsole;
 /**
  * Options for {@linkcode CliConsole}.
  *

package/build/lib/console.js.map

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

package/build/lib/doctor.d.ts

@@ -0,0 +1,36 @@
+/**
+ * A shortcut for a successful required doctor check
+ *
+ * @param {string} message
+ * @returns {DoctorCheckResult}
+ */
+export function ok(message: string): DoctorCheckResult;
+/**
+ * A shortcut for an unsuccessful required doctor check
+ *
+ * @param {string} message
+ * @returns {DoctorCheckResult}
+ */
+export function nok(message: string): DoctorCheckResult;
+/**
+ * A shortcut for a successful optional doctor check
+ *
+ * @param {string} message
+ * @returns {DoctorCheckResult}
+ */
+export function okOptional(message: string): DoctorCheckResult;
+/**
+ * A shortcut for an unsuccessful optional doctor check
+ *
+ * @param {string} message
+ * @returns {DoctorCheckResult}
+ */
+export function nokOptional(message: string): DoctorCheckResult;
+/**
+ * Throw this exception in the fix() method
+ * of your doctor check to skip the actual fix if hasAutofix() is true
+ */
+export class FixSkippedError extends Error {
+}
+export type DoctorCheckResult = import('@appium/types').DoctorCheckResult;
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../lib/doctor.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,4BAHW,MAAM,GACJ,iBAAiB,CAI7B;AAED;;;;;GAKG;AACH,6BAHW,MAAM,GACJ,iBAAiB,CAI7B;AAED;;;;;GAKG;AACH,oCAHW,MAAM,GACJ,iBAAiB,CAI7B;AAED;;;;;GAKG;AACH,qCAHW,MAAM,GACJ,iBAAiB,CAI7B;AAED;;;GAGG;AACH;CAA6C;gCAGhC,OAAO,eAAe,EAAE,iBAAiB"}

package/build/lib/doctor.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FixSkippedError = exports.nokOptional = exports.okOptional = exports.nok = exports.ok = void 0;
+/**
+ * A shortcut for a successful required doctor check
+ *
+ * @param {string} message
+ * @returns {DoctorCheckResult}
+ */
+function ok(message) {
+    return { ok: true, optional: false, message };
+}
+exports.ok = ok;
+/**
+ * A shortcut for an unsuccessful required doctor check
+ *
+ * @param {string} message
+ * @returns {DoctorCheckResult}
+ */
+function nok(message) {
+    return { ok: false, optional: false, message };
+}
+exports.nok = nok;
+/**
+ * A shortcut for a successful optional doctor check
+ *
+ * @param {string} message
+ * @returns {DoctorCheckResult}
+ */
+function okOptional(message) {
+    return { ok: true, optional: true, message };
+}
+exports.okOptional = okOptional;
+/**
+ * A shortcut for an unsuccessful optional doctor check
+ *
+ * @param {string} message
+ * @returns {DoctorCheckResult}
+ */
+function nokOptional(message) {
+    return { ok: false, optional: true, message };
+}
+exports.nokOptional = nokOptional;
+/**
+ * Throw this exception in the fix() method
+ * of your doctor check to skip the actual fix if hasAutofix() is true
+ */
+class FixSkippedError extends Error {
+}
+exports.FixSkippedError = FixSkippedError;
+/**
+ * @typedef {import('@appium/types').DoctorCheckResult} DoctorCheckResult
+ */
+//# sourceMappingURL=doctor.js.map

package/build/lib/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../lib/doctor.js"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,SAAgB,EAAE,CAAC,OAAO;IACxB,OAAO,EAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAC,CAAC;AAC9C,CAAC;AAFD,gBAEC;AAED;;;;;GAKG;AACH,SAAgB,GAAG,CAAC,OAAO;IACzB,OAAO,EAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAC,CAAC;AAC/C,CAAC;AAFD,kBAEC;AAED;;;;;GAKG;AACH,SAAgB,UAAU,CAAC,OAAO;IAChC,OAAO,EAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAC,CAAC;AAC7C,CAAC;AAFD,gCAEC;AAED;;;;;GAKG;AACH,SAAgB,WAAW,CAAC,OAAO;IACjC,OAAO,EAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAC,CAAC;AAC9C,CAAC;AAFD,kCAEC;AAED;;;GAGG;AACH,MAAa,eAAgB,SAAQ,KAAK;CAAG;AAA7C,0CAA6C;AAE7C;;GAEG"}

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

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../lib/env.js"],"names":[],"mappings":"AAgCA;;;;;GAKG;AACH,yCAHW,MAAM,GACJ,QAAQ,OAAO,CAAC,CAI5B;AAjCD;;;GAGG;AACH,kCAFU,MAAM,CAEsD;AAEtE;;;GAGG;AACH,gCAFU,MAAM,CAEmC;AAEnD;;;GAGG;AACH,qCAFU,MAAM,CAOd;AAcF;;;;GAIG;AACH,yEAGe,QAAQ,MAAM,GAAC,SAAS,CAAC,uBAsCtC;AAEF;;GAEG;AACH,sCAGa,MAAM,KACJ,QAAQ,OAAO,UAAU,EAAE,qBAAqB,GAAC,SAAS,CAAC,uBAKxE;AAEF;;;;;;;GAOG;AACH,+DAGe,QAAQ,MAAM,CAAC,uBAiB5B;AAEF;;;;;GAKG;AACH,wEAGe,QAAQ,MAAM,CAAC,uBAO5B;oCAGW,OAAO,UAAU,EAAE,qBAAqB;cAxJvC,QAAQ"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../lib/env.js"],"names":[],"mappings":"AA8BA;;;;;GAKG;AACH,yCAHW,MAAM,GACJ,QAAQ,OAAO,CAAC,CAI5B;AA/BD;;;GAGG;AACH,kCAFU,MAAM,CAEsD;AAEtE;;;GAGG;AACH,gCAFU,MAAM,CAEmC;AAEnD;;;GAGG;AACH,qCAFU,MAAM,CAOd;AAYF;;;;GAIG;AACH,yEAGe,QAAQ,MAAM,GAAC,SAAS,CAAC,uBAkCtC;AAEF;;GAEG;AACH,sCAGa,MAAM,KACJ,QAAQ,OAAO,UAAU,EAAE,qBAAqB,GAAC,SAAS,CAAC,uBAKxE;AAEF;;;;;;;GAOG;AACH,+DAGe,QAAQ,MAAM,CAAC,uBAa5B;AAEF;;;;;GAKG;AACH,wEAGe,QAAQ,MAAM,CAAC,uBAO5B;oCAGW,OAAO,UAAU,EAAE,qBAAqB;cA9IvC,QAAQ"}

package/build/lib/env.js

@@ -9,7 +9,7 @@ const lodash_1 = __importDefault(require("lodash"));
 const os_1 = require("os");
 const path_1 = __importDefault(require("path"));
 const read_pkg_1 = __importDefault(require("read-pkg"));
-const npm_1 = require("./npm");
+const semver_1 = __importDefault(require("semver"));
 /**
  * Path to the default `APPIUM_HOME` dir (`~/.appium`).
  * @type {string}
@@ -25,7 +25,6 @@ exports.MANIFEST_BASENAME = 'extensions.yaml';
  * @type {string}
  */
 exports.MANIFEST_RELATIVE_PATH = path_1.default.join('node_modules', '.cache', 'appium', exports.MANIFEST_BASENAME);
-const OLD_VERSION_REGEX = /^[01]/;
 /**
  * Resolves `true` if an `appium` dependency can be found somewhere in the given `cwd`.
  *
@@ -48,38 +47,33 @@ exports.findAppiumDependencyPackage = lodash_1.default.memoize(
  */
 async (cwd = process.cwd()) => {
     /**
-     * Tries to read `package.json` in `cwd` and resolves the identity if it depends on `appium`;
+     * Tries to read `package.json` in `root` and resolves the identity if it depends on `appium`;
      * otherwise resolves `undefined`.
-     * @param {string} cwd
+     * @param {string} root
      * @returns {Promise<string|undefined>}
      */
-    const readPkg = async (cwd) => {
-        /** @type {string|undefined} */
-        let pkgPath;
+    const readPkg = async (root) => {
         try {
-            const pkg = await (0, exports.readPackageInDir)(cwd);
-            const version = pkg?.dependencies?.appium ??
+            const pkg = await (0, exports.readPackageInDir)(root);
+            const version = semver_1.default.coerce(String(pkg?.dependencies?.appium ??
                 pkg?.devDependencies?.appium ??
-                pkg?.peerDependencies?.appium;
-            pkgPath = version && !OLD_VERSION_REGEX.test(String(version)) ? cwd : undefined;
+                pkg?.peerDependencies?.appium));
+            return version && semver_1.default.satisfies(version, '>=2.0.0-beta', { includePrerelease: true })
+                ? root
+                : undefined;
         }
         catch { }
-        return pkgPath;
     };
-    cwd = path_1.default.resolve(cwd);
-    /** @type {string} */
-    let pkgDir;
-    try {
-        const { json: list } = await npm_1.npm.exec('list', ['--long', '--json'], { cwd });
-        ({ path: pkgDir } = list);
-        if (pkgDir !== cwd) {
-            pkgDir = pkgDir ?? cwd;
+    let currentDir = path_1.default.resolve(cwd);
+    let isAtFsRoot = false;
+    while (!isAtFsRoot) {
+        const result = await readPkg(currentDir);
+        if (result) {
+            return result;
         }
+        currentDir = path_1.default.dirname(currentDir);
+        isAtFsRoot = currentDir.length <= path_1.default.dirname(currentDir).length;
     }
-    catch {
-        pkgDir = cwd;
-    }
-    return await readPkg(pkgDir);
 });
 /**
  * Read a `package.json` in dir `cwd`.  If none found, return `undefined`.
@@ -113,11 +107,7 @@ async function _resolveAppiumHome(cwd = process.cwd()) {
     if (process.env.APPIUM_HOME) {
         return path_1.default.resolve(cwd, process.env.APPIUM_HOME);
     }
-    const pkgPath = await (0, exports.findAppiumDependencyPackage)(cwd);
-    if (pkgPath) {
-        return pkgPath;
-    }
-    return exports.DEFAULT_APPIUM_HOME;
+    return await (0, exports.findAppiumDependencyPackage)(cwd) ?? exports.DEFAULT_APPIUM_HOME;
 });
 /**
  * Figure out manifest path based on `appiumHome`.

package/build/lib/env.js.map

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

package/build/lib/fs.d.ts

@@ -127,34 +127,34 @@ export namespace fs {
      * @returns {string} The closeset parent dir containing `package.json`
      */
     export function findRoot(dir: string): string;
-    export const access: typeof fsPromises.access;
-    export const appendFile: typeof fsPromises.appendFile;
-    export const chmod: typeof fsPromises.chmod;
-    export const close: (arg1: number) => B<any>;
+    export let access: typeof fsPromises.access;
+    export let appendFile: typeof fsPromises.appendFile;
+    export let chmod: typeof fsPromises.chmod;
+    export let close: (arg1: number) => B<any>;
     export { constants };
     export { createWriteStream };
     export { createReadStream };
-    export const lstat: typeof fsPromises.lstat;
-    export const open: (path: import("fs").PathLike, flags: import("fs").OpenMode, mode?: import("fs").Mode | undefined) => Promise<number>;
-    export const openFile: typeof fsPromises.open;
-    export const readdir: typeof fsPromises.readdir;
+    export let lstat: typeof fsPromises.lstat;
+    export let open: (path: import("fs").PathLike, flags: import("fs").OpenMode, mode?: import("fs").Mode | undefined) => Promise<number>;
+    export let openFile: typeof fsPromises.open;
+    export let readdir: typeof fsPromises.readdir;
     export function read(fd: number, buffer: NodeJS.ArrayBufferView | import("fs").ReadAsyncOptions<NodeJS.ArrayBufferView>, offset: number | undefined, length: number | undefined, position: number | null | undefined): B<{
         bytesRead: number;
         buffer: NodeJS.ArrayBufferView;
     }>;
-    export const readFile: typeof fsPromises.readFile;
-    export const readlink: typeof fsPromises.readlink;
-    export const realpath: typeof fsPromises.realpath;
-    export const rename: typeof fsPromises.rename;
-    export const stat: typeof fsPromises.stat;
-    export const symlink: typeof fsPromises.symlink;
-    export const unlink: typeof fsPromises.unlink;
-    export const write: (arg1: number, arg2: string) => B<number>;
-    export const writeFile: typeof fsPromises.writeFile;
-    export const F_OK: number;
-    export const R_OK: number;
-    export const W_OK: number;
-    export const X_OK: number;
+    export let readFile: typeof fsPromises.readFile;
+    export let readlink: typeof fsPromises.readlink;
+    export let realpath: typeof fsPromises.realpath;
+    export let rename: typeof fsPromises.rename;
+    export let stat: typeof fsPromises.stat;
+    export let symlink: typeof fsPromises.symlink;
+    export let unlink: typeof fsPromises.unlink;
+    export let write: (arg1: number, arg2: string) => B<number>;
+    export let writeFile: typeof fsPromises.writeFile;
+    export let F_OK: number;
+    export let R_OK: number;
+    export let W_OK: number;
+    export let X_OK: number;
 }
 import mv from 'mv';
 import B from 'bluebird';

package/build/lib/index.d.ts

@@ -20,9 +20,10 @@ import * as node from './node';
 import * as timing from './timing';
 import * as env from './env';
 import * as console from './console';
+import * as doctor from './doctor';
 export { npm } from './npm';
 declare const cancellableDelay: typeof util.cancellableDelay;
-export { tempDir, system, util, fs, cancellableDelay, plist, mkdirp, logger, process, zip, imageUtil, net, mjpeg, node, timing, env, console, };
+export { tempDir, system, util, fs, cancellableDelay, plist, mkdirp, logger, process, zip, imageUtil, net, mjpeg, node, timing, env, console, doctor, };
 declare const _default: {
     tempDir: typeof tempDir;
     system: typeof system;
@@ -85,6 +86,7 @@ declare const _default: {
     timing: typeof timing;
     env: typeof env;
     console: typeof console;
+    doctor: typeof doctor;
 };
 export default _default;
 export type { ConsoleOpts } from './console';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/index.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,EAAC,EAAE,EAAC,MAAM,MAAM,CAAC;AACxB,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAC7B,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,EAAC,MAAM,EAAC,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,MAAM,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAC7B,OAAO,KAAK,SAAS,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAC7B,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AAErC,OAAO,EAAC,GAAG,EAAC,MAAM,OAAO,CAAC;AAE1B,QAAA,MAAO,gBAAgB,8BAAQ,CAAC;AAEhC,OAAO,EACL,OAAO,EACP,MAAM,EACN,IAAI,EACJ,EAAE,EACF,gBAAgB,EAChB,KAAK,EACL,MAAM,EACN,MAAM,EACN,OAAO,EACP,GAAG,EACH,SAAS,EACT,GAAG,EACH,KAAK,EACL,IAAI,EACJ,MAAM,EACN,GAAG,EACH,OAAO,GACR,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACF,wBAkBE;AAEF,YAAY,EAAC,WAAW,EAAC,MAAM,WAAW,CAAC;AAC3C,YAAY,EAAC,MAAM,EAAE,eAAe,EAAC,MAAM,MAAM,CAAC;AAClD,YAAY,EACV,UAAU,EACV,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,OAAO,CAAC;AACf,YAAY,EAAC,kBAAkB,EAAE,QAAQ,EAAE,iBAAiB,EAAC,MAAM,OAAO,CAAC;AAC3E,YAAY,EAAC,OAAO,EAAE,aAAa,EAAC,MAAM,WAAW,CAAC;AACtD,YAAY,EAAC,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAC,MAAM,QAAQ,CAAC;AAC/F,YAAY,EACV,iBAAiB,EACjB,QAAQ,EACR,UAAU,EACV,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,OAAO,CAAC;AACf,YAAY,EAAC,4BAA4B,EAAC,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/index.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,EAAC,EAAE,EAAC,MAAM,MAAM,CAAC;AACxB,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAC7B,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,EAAC,MAAM,EAAC,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,MAAM,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAC7B,OAAO,KAAK,SAAS,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAC7B,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AAEnC,OAAO,EAAC,GAAG,EAAC,MAAM,OAAO,CAAC;AAE1B,QAAA,MAAO,gBAAgB,8BAAQ,CAAC;AAEhC,OAAO,EACL,OAAO,EACP,MAAM,EACN,IAAI,EACJ,EAAE,EACF,gBAAgB,EAChB,KAAK,EACL,MAAM,EACN,MAAM,EACN,OAAO,EACP,GAAG,EACH,SAAS,EACT,GAAG,EACH,KAAK,EACL,IAAI,EACJ,MAAM,EACN,GAAG,EACH,OAAO,EACP,MAAM,GACP,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACF,wBAmBE;AAEF,YAAY,EAAC,WAAW,EAAC,MAAM,WAAW,CAAC;AAC3C,YAAY,EAAC,MAAM,EAAE,eAAe,EAAC,MAAM,MAAM,CAAC;AAClD,YAAY,EACV,UAAU,EACV,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,OAAO,CAAC;AACf,YAAY,EAAC,kBAAkB,EAAE,QAAQ,EAAE,iBAAiB,EAAC,MAAM,OAAO,CAAC;AAC3E,YAAY,EAAC,OAAO,EAAE,aAAa,EAAC,MAAM,WAAW,CAAC;AACtD,YAAY,EAAC,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAC,MAAM,QAAQ,CAAC;AAC/F,YAAY,EACV,iBAAiB,EACjB,QAAQ,EACR,UAAU,EACV,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,OAAO,CAAC;AACf,YAAY,EAAC,4BAA4B,EAAC,MAAM,gBAAgB,CAAC"}

package/build/lib/index.js

@@ -23,7 +23,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.console = exports.env = exports.timing = exports.node = exports.mjpeg = exports.net = exports.imageUtil = exports.zip = exports.process = exports.logger = exports.mkdirp = exports.plist = exports.cancellableDelay = exports.fs = exports.util = exports.system = exports.tempDir = exports.npm = void 0;
+exports.doctor = exports.console = exports.env = exports.timing = exports.node = exports.mjpeg = exports.net = exports.imageUtil = exports.zip = exports.process = exports.logger = exports.mkdirp = exports.plist = exports.cancellableDelay = exports.fs = exports.util = exports.system = exports.tempDir = exports.npm = void 0;
 const tempDir = __importStar(require("./tempdir"));
 exports.tempDir = tempDir;
 const system = __importStar(require("./system"));
@@ -56,6 +56,8 @@ const env = __importStar(require("./env"));
 exports.env = env;
 const console = __importStar(require("./console"));
 exports.console = console;
+const doctor = __importStar(require("./doctor"));
+exports.doctor = doctor;
 var npm_1 = require("./npm");
 Object.defineProperty(exports, "npm", { enumerable: true, get: function () { return npm_1.npm; } });
 const { cancellableDelay } = util;
@@ -78,5 +80,6 @@ exports.default = {
     timing,
     env,
     console,
+    doctor,
 };
 //# sourceMappingURL=index.js.map

package/build/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,mDAAqC;AAsBnC,0BAAO;AArBT,iDAAmC;AAsBjC,wBAAM;AArBR,6CAA+B;AAsB7B,oBAAI;AArBN,6BAAwB;AAsBtB,mFAtBM,OAAE,OAsBN;AArBJ,2CAA6B;AA6B3B,kBAAG;AA5BL,+CAAiC;AAsB/B,sBAAK;AArBP,qCAAgC;AAsB9B,uFAtBM,eAAM,OAsBN;AArBR,kDAAoC;AAsBlC,wBAAM;AArBR,mDAAqC;AAsBnC,0BAAO;AArBT,2CAA6B;AAsB3B,kBAAG;AArBL,wDAA0C;AAsBxC,8BAAS;AArBX,+CAAiC;AAuB/B,sBAAK;AAtBP,6CAA+B;AAuB7B,oBAAI;AAtBN,iDAAmC;AAuBjC,wBAAM;AAtBR,2CAA6B;AAuB3B,kBAAG;AAtBL,mDAAqC;AAuBnC,0BAAO;AArBT,6BAA0B;AAAlB,0FAAA,GAAG,OAAA;AAEX,MAAM,EAAC,gBAAgB,EAAC,GAAG,IAAI,CAAC;AAO9B,4CAAgB;AAclB,kBAAe;IACb,OAAO;IACP,MAAM;IACN,IAAI;IACJ,EAAE,EAAF,OAAE;IACF,gBAAgB;IAChB,KAAK;IACL,MAAM,EAAN,eAAM;IACN,MAAM;IACN,OAAO;IACP,GAAG;IACH,SAAS;IACT,GAAG;IACH,KAAK;IACL,IAAI;IACJ,MAAM;IACN,GAAG;IACH,OAAO;CACR,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,mDAAqC;AAuBnC,0BAAO;AAtBT,iDAAmC;AAuBjC,wBAAM;AAtBR,6CAA+B;AAuB7B,oBAAI;AAtBN,6BAAwB;AAuBtB,mFAvBM,OAAE,OAuBN;AAtBJ,2CAA6B;AA8B3B,kBAAG;AA7BL,+CAAiC;AAuB/B,sBAAK;AAtBP,qCAAgC;AAuB9B,uFAvBM,eAAM,OAuBN;AAtBR,kDAAoC;AAuBlC,wBAAM;AAtBR,mDAAqC;AAuBnC,0BAAO;AAtBT,2CAA6B;AAuB3B,kBAAG;AAtBL,wDAA0C;AAuBxC,8BAAS;AAtBX,+CAAiC;AAwB/B,sBAAK;AAvBP,6CAA+B;AAwB7B,oBAAI;AAvBN,iDAAmC;AAwBjC,wBAAM;AAvBR,2CAA6B;AAwB3B,kBAAG;AAvBL,mDAAqC;AAwBnC,0BAAO;AAvBT,iDAAmC;AAwBjC,wBAAM;AAtBR,6BAA0B;AAAlB,0FAAA,GAAG,OAAA;AAEX,MAAM,EAAC,gBAAgB,EAAC,GAAG,IAAI,CAAC;AAO9B,4CAAgB;AAelB,kBAAe;IACb,OAAO;IACP,MAAM;IACN,IAAI;IACJ,EAAE,EAAF,OAAE;IACF,gBAAgB;IAChB,KAAK;IACL,MAAM,EAAN,eAAM;IACN,MAAM;IACN,OAAO;IACP,GAAG;IACH,SAAS;IACT,GAAG;IACH,KAAK;IACL,IAAI;IACJ,MAAM;IACN,GAAG;IACH,OAAO;IACP,MAAM;CACP,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../lib/logging.js"],"names":[],"mappings":"AAQA,0DAA0D;AAC1D,qBADW,OAAO,eAAe,EAAE,iBAAiB,EAAE,CAC+B;;;;;;;YAsHvE,MAAM,EAAE;;;;;WAER,OAAO,gBAAgB,EAAE,4BAA4B,EAAE;;iCA+BxD,OAAO,eAAe,EAAE,kBAAkB;2BAC1C,OAAO,eAAe,EAAE,YAAY;gCACpC,OAAO,eAAe,EAAE,iBAAiB;AARtD,uDAAwB;AAtIxB;;;GAGG;AACH,oCAFW,OAAO,QAAQ,EAAE,MAAM,QAMjC;AAsCD;;;;GAIG;AACH,mCAHW,kBAAkB,UAChB,YAAY,CAsDxB;AAED;;;;;;GAMG;AAEH;;;;;;;;;;;GAWG;AACH,kEANW,MAAM,GAAC,MAAM,EAAE,GAAC,OAAO,eAAe,EAAE,gBAAgB,GAItD,QAAQ,UAAU,CAAC,CAQ/B"}
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../lib/logging.js"],"names":[],"mappings":"AAQA,0DAA0D;AAC1D,qBADW,OAAO,eAAe,EAAE,iBAAiB,EAAE,CAC+B;;;;;;;YA2HvE,MAAM,EAAE;;;;;WAER,OAAO,gBAAgB,EAAE,4BAA4B,EAAE;;iCA+BxD,OAAO,eAAe,EAAE,kBAAkB;2BAC1C,OAAO,eAAe,EAAE,YAAY;gCACpC,OAAO,eAAe,EAAE,iBAAiB;AARtD,uDAAwB;AA3IxB;;;GAGG;AACH,oCAFW,OAAO,QAAQ,EAAE,MAAM,QAMjC;AAsCD;;;;GAIG;AACH,mCAHW,kBAAkB,UAChB,YAAY,CA2DxB;AAED;;;;;;GAMG;AAEH;;;;;;;;;;;GAWG;AACH,kEANW,MAAM,GAAC,MAAM,EAAE,GAAC,OAAO,eAAe,EAAE,gBAAgB,GAItD,QAAQ,UAAU,CAAC,CAQ/B"}

package/build/lib/logging.js

@@ -103,11 +103,16 @@ function getLogger(prefix = null) {
             }
         };
     }
-    // add method to log an error, and throw it, for convenience
-    wrappedLogger.errorAndThrow = function (err) {
-        this.error(err);
+    wrappedLogger.errorWithException = function (/** @type {any[]} */ ...args) {
+        this.error(...args);
         // make sure we have an `Error` object. Wrap if necessary
-        throw lodash_1.default.isError(err) ? err : new Error((0, util_1.unleakString)(err));
+        return lodash_1.default.isError(args[0]) ? args[0] : new Error(args.map(util_1.unleakString).join('\n'));
+    };
+    /**
+     * @deprecated Use {@link errorWithException} instead
+     */
+    wrappedLogger.errorAndThrow = function (/** @type {any[]} */ ...args) {
+        throw this.errorWithException(args);
     };
     if (!usingGlobalLog) {
         // if we're not using a global log specified from some top-level package,