nolo-cli 0.144.0-alpha.1 → 0.145.0-alpha.1

package/node_modules/maybe-combine-errors/README.md

@@ -0,0 +1,94 @@
+# maybe-combine-errors
+
+**Combine 0 or more errors into one.**
+
+[![npm status](http://img.shields.io/npm/v/maybe-combine-errors.svg)](https://www.npmjs.org/package/maybe-combine-errors)
+[![node](https://img.shields.io/node/v/maybe-combine-errors.svg)](https://www.npmjs.org/package/maybe-combine-errors)
+[![Travis build status](https://img.shields.io/travis/com/vweevers/maybe-combine-errors.svg?label=travis)](http://travis-ci.com/vweevers/maybe-combine-errors)
+[![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://standardjs.com)
+
+## Usage
+
+```js
+const combine = require('maybe-combine-errors')
+
+const err1 = new Error('one')
+const err2 = new Error('two')
+
+console.log(combine([err1, err2]).message)
+console.log(combine([err1, err2]) instanceof Error)
+console.log(combine([err1, null]) === err1)
+console.log(combine([]) === undefined)
+
+throw combine([err1, err2])
+```
+
+```
+$ node example.js
+one; two
+true
+true
+true
+example.js:9
+throw combine([err1, err2])
+^
+
+Error: one
+    at Object.<anonymous> (example.js:3:14)
+    at Module._compile (internal/modules/cjs/loader.js:945:30)
+    at Object.Module._extensions..js (internal/modules/cjs/loader.js:962:10)
+    at Module.load (internal/modules/cjs/loader.js:798:32)
+    at Function.Module._load (internal/modules/cjs/loader.js:711:12)
+    at Function.Module.runMain (internal/modules/cjs/loader.js:1014:10)
+    at internal/main/run_main_module.js:17:11
+
+Error: two
+    at Object.<anonymous> (example.js:4:14)
+    at Module._compile (internal/modules/cjs/loader.js:945:30)
+    at Object.Module._extensions..js (internal/modules/cjs/loader.js:962:10)
+    at Module.load (internal/modules/cjs/loader.js:798:32)
+    at Function.Module._load (internal/modules/cjs/loader.js:711:12)
+    at Function.Module.runMain (internal/modules/cjs/loader.js:1014:10)
+    at internal/main/run_main_module.js:17:11
+```
+
+## API
+
+### `combine(errors)`
+
+The `errors` argument must be an array.
+
+Elements that are `null` or `undefined` are skipped. If the array is empty (after skipping `null` and `undefined`), `undefined` will be returned. If the array contains only 1 error, that error will be returned as-is. Otherwise, a combined error with joined messages and a lazily joined stack. Duplicate messages are skipped.
+
+Respects [`transient-error`](https://github.com/vweevers/transient-error) and `err.expected`: if all errors have `.transient === true` then the combined error will also be transient. Same for `.expected`, which is useful for the following pattern:
+
+```js
+if (err.expected) {
+  console.error(err.message)
+  process.exit(1)
+} else {
+  throw err
+}
+```
+
+## Alternatives
+
+### [`combine-errors`](https://github.com/MatthewMueller/combine-errors)
+
+Same message and stack behavior. Different in that it always returns an error regardless of input length.
+
+### [`aggregate-error`](https://github.com/sindresorhus/aggregate-error)
+
+Sets message to a joined stack, which means you can't get a human-friendly message with e.g. `console.error(err.message)`. Removes "mostly unhelpful" internal Node.js entries from the stack.
+
+## Install
+
+With [npm](https://npmjs.org) do:
+
+```
+npm install maybe-combine-errors
+```
+
+## License
+
+[MIT](LICENSE.md) © 2020-present Vincent Weevers

package/node_modules/maybe-combine-errors/index.js

@@ -0,0 +1,60 @@
+'use strict'
+
+const kErrors = Symbol('kErrors')
+
+module.exports = function (errors) {
+  errors = errors.filter(defined)
+
+  if (errors.length === 0) return
+  if (errors.length === 1) return errors[0]
+
+  return new CombinedError(errors)
+}
+
+class CombinedError extends Error {
+  constructor (errors) {
+    const unique = new Set(errors.map(getMessage).filter(Boolean))
+    const message = Array.from(unique).join('; ')
+
+    super(message)
+
+    value(this, 'name', 'CombinedError')
+    value(this, kErrors, errors)
+
+    getter(this, 'stack', () => errors.map(getStack).join('\n\n'))
+    getter(this, 'transient', () => errors.length > 0 && errors.every(transient))
+    getter(this, 'expected', () => errors.length > 0 && errors.every(expected))
+  }
+
+  [Symbol.iterator] () {
+    return this[kErrors][Symbol.iterator]()
+  }
+}
+
+function value (obj, prop, value) {
+  Object.defineProperty(obj, prop, { value })
+}
+
+function getter (obj, prop, get) {
+  Object.defineProperty(obj, prop, { get })
+}
+
+function defined (err) {
+  return err != null
+}
+
+function getMessage (err) {
+  return err.message
+}
+
+function getStack (err) {
+  return err.stack
+}
+
+function transient (err) {
+  return err.transient === true
+}
+
+function expected (err) {
+  return err.expected === true
+}

package/node_modules/maybe-combine-errors/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "maybe-combine-errors",
+  "version": "1.0.0",
+  "description": "Combine 0 or more errors into one",
+  "license": "MIT",
+  "author": "Vincent Weevers",
+  "scripts": {
+    "test": "standard && nyc node test"
+  },
+  "files": [
+    "index.js"
+  ],
+  "dependencies": {},
+  "devDependencies": {
+    "nyc": "^15.1.0",
+    "standard": "^14.3.4",
+    "tape": "^5.0.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vweevers/maybe-combine-errors.git"
+  },
+  "homepage": "https://github.com/vweevers/maybe-combine-errors",
+  "keywords": [
+    "combine",
+    "error",
+    "errors",
+    "exception"
+  ],
+  "engines": {
+    "node": ">=10"
+  }
+}

package/node_modules/module-error/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+## [1.0.2] - 2022-02-19
+
+### Fixed
+
+- Align LICENSE format with standardized SPDX ([`915c436`](https://github.com/vweevers/module-error/commit/915c436)).
+
+## [1.0.1] - 2021-10-24
+
+### Fixed
+
+- Add types ([`027e1ea`](https://github.com/vweevers/module-error/commit/027e1ea))
+
+## [1.0.0] - 2021-10-22
+
+:seedling: Initial release.
+
+[1.0.2]: https://github.com/vweevers/module-error/releases/tag/v1.0.2
+
+[1.0.1]: https://github.com/vweevers/module-error/releases/tag/v1.0.1
+
+[1.0.0]: https://github.com/vweevers/module-error/releases/tag/v1.0.0

package/node_modules/module-error/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Vincent Weevers
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/node_modules/module-error/README.md

@@ -0,0 +1,89 @@
+# module-error
+
+**Create errors with `code` and `cause` properties. Simple and extensible.**
+
+[![npm status](http://img.shields.io/npm/v/module-error.svg)](https://www.npmjs.org/package/module-error)
+[![node](https://img.shields.io/node/v/module-error.svg)](https://www.npmjs.org/package/module-error)
+[![Test](https://img.shields.io/github/workflow/status/vweevers/module-error/Test?label=test)](https://github.com/vweevers/module-error/actions/workflows/test.yml)
+[![Standard](https://img.shields.io/badge/standard-informational?logo=javascript&logoColor=fff)](https://standardjs.com)
+[![Common Changelog](https://common-changelog.org/badge.svg)](https://common-changelog.org)
+
+## Usage
+
+Works like a regular `Error` constructor but adds an options argument (as [`proposal-error-cause`](https://github.com/tc39/proposal-error-cause) does).
+
+```js
+const ModuleError = require('module-error')
+
+throw new ModuleError('Message goes here', {
+  code: 'EXAMPLE_NOT_FOUND'
+})
+```
+
+The primary purpose of `ModuleError` is to define a `code` property on the error object following Node.js conventions. It should be set to an uppercase string that uniquely identifies a situation, prefixed with the name of your module (or a collection of modules) to prevent conflicts.
+
+The output looks like this in Node.js (some stack frames omitted for brevity):
+
+```
+ModuleError: Message goes here
+    at Object.<anonymous> (/home/app/example.js:5:7)
+    at node:internal/main/run_main_module:17:47 {
+  code: 'EXAMPLE_NOT_FOUND'
+}
+```
+
+The benefit of error codes is that messages can be changed without a semver-major release because your [semver](https://semver.org) contract will be on the codes. Codes can be reused across related modules while allowing individual modules to customize messages. I also prefer it over `instanceof MyError` logic because codes work cross-realm and when a tree of `node_modules` contains multiple versions of a module.
+
+To wrap another error:
+
+```js
+try {
+  JSON.parse(await fs.readFile('state.json'))
+} catch (err) {
+  throw new ModuleError('Could not load state', {
+    code: 'EXAMPLE_INVALID_STATE',
+    cause: err
+  })
+}
+```
+
+If for convenience you want to create subclasses with prepared codes:
+
+```js
+class NotFoundError extends ModuleError {
+  constructor(message, options) {
+    super(message, { ...options, code: 'EXAMPLE_NOT_FOUND' })
+  }
+}
+```
+
+Then you can do:
+
+```js
+throw new NotFoundError('Message goes here')
+```
+
+Under Node.js the stack trace will be adjusted accordingly, to skip the frame containing your error constructor.
+
+## API
+
+### `ModuleError(message, [options])`
+
+Constructor to create an error with the provided `message` string. Options:
+
+- `code` (string): if provided, define a `code` property with this value.
+- `cause` (Error): if provided, define a `cause` property with this value. Unlike the spec of [`proposal-error-cause`](https://github.com/tc39/proposal-error-cause) the property is enumerable so that Node.js (v16 at the time of writing) will print it. Firefox prints it regardless, Chromium doesn't yet.
+- `expected`: if truthy, define a `expected` property with value `true`. This is useful for command line interfaces to differentiate unexpected errors from e.g. invalid user input. A pattern I like to follow is to print only an error message if `err.expected` is true and no `--verbose` flag was provided. Otherwise print the full stack.
+- `transient`: if truthy, define a `transient` property with value `true`. This communicates to users that the operation that caused the error may be retried. See also [`transient-error`](https://github.com/vweevers/transient-error) to mark existing errors as transient.
+
+## Install
+
+With [npm](https://npmjs.org) do:
+
+```
+npm install module-error
+```
+
+## License
+
+[MIT](LICENSE)

package/node_modules/module-error/index.d.ts

@@ -0,0 +1,18 @@
+declare class ModuleError extends Error {
+  /**
+   * @param message Error message
+   */
+  constructor(message: string, options?: {
+    code?: string
+    cause?: Error
+    expected?: boolean
+    transient?: boolean
+  } | undefined)
+
+  code: string | undefined
+  expected: boolean | undefined
+  transient: boolean | undefined
+  cause: Error | undefined
+}
+
+export = ModuleError

package/node_modules/module-error/index.js

@@ -0,0 +1,22 @@
+'use strict'
+
+module.exports = class ModuleError extends Error {
+  /**
+   * @param {string} message Error message
+   * @param {{ code?: string, cause?: Error, expected?: boolean, transient?: boolean }} [options]
+   */
+  constructor (message, options) {
+    super(message || '')
+
+    if (typeof options === 'object' && options !== null) {
+      if (options.code) this.code = String(options.code)
+      if (options.expected) this.expected = true
+      if (options.transient) this.transient = true
+      if (options.cause) this.cause = options.cause
+    }
+
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, this.constructor)
+    }
+  }
+}

package/node_modules/module-error/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "module-error",
+  "version": "1.0.2",
+  "description": "Create errors with code and cause properties",
+  "license": "MIT",
+  "author": "Vincent Weevers",
+  "scripts": {
+    "test": "standard && tsc && hallmark && node test",
+    "build": "tsc -d --emitDeclarationOnly --noEmit false"
+  },
+  "types": "./index.d.ts",
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "CHANGELOG.md"
+  ],
+  "devDependencies": {
+    "@types/node": "^17.0.6",
+    "@voxpelli/tsconfig": "^3.0.0",
+    "hallmark": "^4.0.0",
+    "standard": "^16.0.4",
+    "tape": "^5.3.1",
+    "typescript": "^4.4.4"
+  },
+  "keywords": [
+    "cause",
+    "code",
+    "error"
+  ],
+  "repository": "vweevers/module-error",
+  "bugs": "https://github.com/vweevers/module-error/issues",
+  "homepage": "https://github.com/vweevers/module-error",
+  "engines": {
+    "node": ">=10"
+  }
+}

package/node_modules/napi-macros/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 Mathias Buus
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.