@util.js/errors 0.41.5 → 0.41.6

package/package.json

@@ -25,5 +25,5 @@
     "type": "git",
     "url": "https://github.com/creemama/utiljs/tree/master/packages/utiljs-errors"
   },
-  "version": "0.41.5"
+  "version": "0.41.6"
 }

package/dist/AsyncError.js

@@ -1,49 +0,0 @@
-"use strict";
-
-/*
- * See {@link Errors#AsyncError}.
- */
-var _Reflect$construct = require("@babel/runtime-corejs3/core-js-stable/reflect/construct");
-var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault");
-var _concat = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/instance/concat"));
-var _splice = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/instance/splice"));
-var _stringify = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/json/stringify"));
-var _createClass2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/createClass"));
-var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/classCallCheck"));
-var _possibleConstructorReturn2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/possibleConstructorReturn"));
-var _getPrototypeOf2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/getPrototypeOf"));
-var _inherits2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/inherits"));
-var _wrapNativeSuper2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/wrapNativeSuper"));
-function _callSuper(t, o, e) { return o = (0, _getPrototypeOf2["default"])(o), (0, _possibleConstructorReturn2["default"])(t, _isNativeReflectConstruct() ? _Reflect$construct(o, e || [], (0, _getPrototypeOf2["default"])(t).constructor) : o.apply(t, e)); }
-function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(_Reflect$construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
-module.exports = /*#__PURE__*/function (_Error) {
-  function AsyncError(callerError, asyncError, message) {
-    var _context, _context2, _context3, _context4, _context5;
-    var _this;
-    (0, _classCallCheck2["default"])(this, AsyncError);
-    _this = _callSuper(this, AsyncError, [message != null ? message : getErrorProperty(asyncError, "message")]);
-    if (!callerError) throw new TypeError((0, _concat["default"])(_context = "".concat(_this.constructor.name, "'s constructor expects a defined callerError, but it was ")).call(_context, callerError, "."));
-    if (!asyncError) throw new TypeError((0, _concat["default"])(_context2 = "".concat(_this.constructor.name, "'s constructor expects a defined asyncError, but it was ")).call(_context2, asyncError, "."));
-    _this.name = _this.constructor.name;
-    _this.original = asyncError;
-    _this.newStack = _this.stack;
-    var callerStack = "    at " + (0, _splice["default"])(_context3 = callerError.stack.split("    at ")).call(_context3, 2).join("    at ");
-    // If asyncError.stack is falsy, then let us just try asyncError;
-    // asyncError may be a string.
-    var asyncErrorStack = getErrorProperty(asyncError, "stack");
-    _this.stack = (0, _concat["default"])(_context4 = (0, _concat["default"])(_context5 = "".concat(_this.stack, "\n")).call(_context5, callerStack, "\n")).call(_context4, asyncErrorStack);
-    return _this;
-  }
-  (0, _inherits2["default"])(AsyncError, _Error);
-  return (0, _createClass2["default"])(AsyncError);
-}(/*#__PURE__*/(0, _wrapNativeSuper2["default"])(Error));
-function getErrorProperty(error, property) {
-  if (error[property]) return error[property];
-  try {
-    return (0, _stringify["default"])(error);
-  } catch (e) {
-    // JSON.stringify might throw the following, "TypeError: Converting circular
-    // structure to JSON."
-    return error;
-  }
-}

package/dist/Errors.js

@@ -1,165 +0,0 @@
-"use strict";
-
-/**
- * JavaScript utility methods for [errors]{@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error}
- *
- * @public
- * @class Errors
- */
-var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault");
-var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/classCallCheck"));
-var _createClass2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/createClass"));
-module.exports = /*#__PURE__*/function () {
-  function Errors() {
-    (0, _classCallCheck2["default"])(this, Errors);
-  }
-  return (0, _createClass2["default"])(Errors, [{
-    key: "catch",
-    value:
-    /**
-     * Wraps the given promise so that errors caught preserve the stack trace of the calling thread.
-     *
-     * The example compares the stack trace of a rejected promise using this method and the stack trace of a rejected promise that does not use this method.
-     *
-     * @example
-     * const errors = require("@util.js/errors");
-     * function rejectAPromise() {
-     *   return Promise.reject(new TypeError("Fail!"));
-     * }
-     *
-     * errors
-     *   .catch(rejectAPromise())
-     *   .catch(error => console.log("\n\nWith Caller Stack Trace\n" + error.stack));
-     * // With Caller Stack Trace
-     * // AsyncError: Fail!
-     * //     at promise.catch.error (/root/utiljs/packages/utiljs-errors/lib/Errors.js:28:13)
-     * //     at process._tickCallback (internal/process/next_tick.js:68:7)
-     * //     at Function.Module.runMain (internal/modules/cjs/loader.js:746:11)
-     * //     at startup (internal/bootstrap/node.js:240:19)
-     * //     at bootstrapNodeJSCore (internal/bootstrap/node.js:564:3)
-     * //     at runExample0 (/root/utiljs/packages/utiljs-errors/doc/README-examples.js:23:11)
-     * //     at runExample (/root/utiljs/packages/utiljs-errors/doc/README-examples.js:12:7)
-     * //     at Object.<anonymous> (/root/utiljs/packages/utiljs-errors/doc/README-examples.js:4:31)
-     * //     at Module._compile (internal/modules/cjs/loader.js:702:30)
-     * //     at Object.Module._extensions..js (internal/modules/cjs/loader.js:713:10)
-     * //     at Module.load (internal/modules/cjs/loader.js:612:32)
-     * //     at tryModuleLoad (internal/modules/cjs/loader.js:551:12)
-     * //     at Function.Module._load (internal/modules/cjs/loader.js:543:3)
-     * //     at Function.Module.runMain (internal/modules/cjs/loader.js:744:10)
-     * // TypeError: Fail!
-     * //     at rejectAPromise (/root/utiljs/packages/utiljs-errors/doc/README-examples.js:20:27)
-     * //     at runExample0 (/root/utiljs/packages/utiljs-errors/doc/README-examples.js:23:12)
-     * //     at runExample (/root/utiljs/packages/utiljs-errors/doc/README-examples.js:12:7)
-     * //     at Object.<anonymous> (/root/utiljs/packages/utiljs-errors/doc/README-examples.js:4:31)
-     * //     at Module._compile (internal/modules/cjs/loader.js:702:30)
-     * //     at Object.Module._extensions..js (internal/modules/cjs/loader.js:713:10)
-     * //     at Module.load (internal/modules/cjs/loader.js:612:32)
-     * //     at tryModuleLoad (internal/modules/cjs/loader.js:551:12)
-     * //     at Function.Module._load (internal/modules/cjs/loader.js:543:3)
-     * //     at Function.Module.runMain (internal/modules/cjs/loader.js:744:10)
-     *
-     * rejectAPromise().catch(error =>
-     *   console.log("\n\nWithout Caller Stack Trace\n" + error.stack)
-     * );
-     * // Without Caller Stack Trace
-     * // TypeError: Fail!
-     * //     at rejectAPromise (/root/utiljs/packages/utiljs-errors/doc/README-examples.js:20:27)
-     * //     at runExample0 (/root/utiljs/packages/utiljs-errors/doc/README-examples.js:53:3)
-     * //     at runExample (/root/utiljs/packages/utiljs-errors/doc/README-examples.js:12:7)
-     * //     at Object.<anonymous> (/root/utiljs/packages/utiljs-errors/doc/README-examples.js:4:31)
-     * //     at Module._compile (internal/modules/cjs/loader.js:702:30)
-     * //     at Object.Module._extensions..js (internal/modules/cjs/loader.js:713:10)
-     * //     at Module.load (internal/modules/cjs/loader.js:612:32)
-     * //     at tryModuleLoad (internal/modules/cjs/loader.js:551:12)
-     * //     at Function.Module._load (internal/modules/cjs/loader.js:543:3)
-     * //     at Function.Module.runMain (internal/modules/cjs/loader.js:744:10)
-     *
-     * @param {Promise} promise The promise to wrap
-     * @param {String} [message] A human-readable description of the error
-     * @return {Promise} A promise that upon rejection wraps the error in an AsyncError and rethrows
-     * @throws {TypeError} If the given promise is not an instance of Promise
-     *
-     * @public
-     * @function Errors#catch
-     */
-    function _catch(promise, message) {
-      var _this = this;
-      var callerError = new Error();
-      return promise["catch"](function (error) {
-        throw new _this.AsyncError(callerError, error, message);
-      });
-    }
-
-    /**
-     * An error that preserves the stack trace of the thread that calls an asynchronous function.
-     *
-     * Use {@link Errors#catch} to use this class. Use this class directly for instanceof checks.
-     *
-     * @public
-     * @class Errors#AsyncError
-     */
-  }, {
-    key: "AsyncError",
-    get: function get() {
-      return require("./AsyncError");
-    }
-  }, {
-    key: "FalsyError",
-    get: function get() {
-      return require("./FalsyError");
-    }
-  }, {
-    key: "MissingError",
-    get: function get() {
-      return require("./MissingError");
-    }
-
-    /**
-     * A wrapper of another error used for rethrowing.
-     *
-     * This error preserves information about the original error and its stack trace.
-     *
-     * A [Stack Overflow]{@link https://stackoverflow.com/questions/42754270/re-throwing-exception-in-nodejs-and-not-losing-stack-trace} article inspired this class.
-     *
-     * @example
-     * function throwATypeError() {
-     *   throw new TypeError("Invalid Argument");
-     * }
-     *
-     * function rethrowTheTypeError() {
-     *   try {
-     *     throwATypeError();
-     *   } catch (error) {
-     *     throw new RethrownError(error, "Lorem Ipsum");
-     *   }
-     * }
-     *
-     * try {
-     *   rethrowTheTypeError();
-     * } catch (error) {
-     *   console.log(error.stack);
-     *   // This outputs a stack trace like the following:
-     *   //
-     *   // RethrownError: Lorem Ipsum
-     *   //     at rethrowTheTypeError (/root/utiljs/packages/utiljs-errors/test/ErrorsTest.js:16:15)
-     *   // TypeError: Invalid Argument
-     *   //     at throwATypeError (/root/utiljs/packages/utiljs-errors/test/ErrorsTest.js:10:13)
-     *   //     at rethrowTheTypeError (/root/utiljs/packages/utiljs-errors/test/ErrorsTest.js:14:9)
-     *   //     at Context.it (/root/utiljs/packages/utiljs-errors/test/ErrorsTest.js:20:7)
-     *   //     ...
-     * }
-     *
-     * @param {Error} error The error to rethrow
-     * @param {String} [message] A human-readable description of the error
-     * @throws {TypeError} if the given error is not defined
-     *
-     * @public
-     * @class Errors#RethrownError
-     */
-  }, {
-    key: "RethrownError",
-    get: function get() {
-      return require("./RethrownError");
-    }
-  }]);
-}();

package/dist/FalsyError.js

@@ -1,30 +0,0 @@
-"use strict";
-
-var _Reflect$construct = require("@babel/runtime-corejs3/core-js-stable/reflect/construct");
-var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault");
-var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/classCallCheck"));
-var _createClass2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/createClass"));
-var _possibleConstructorReturn2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/possibleConstructorReturn"));
-var _getPrototypeOf2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/getPrototypeOf"));
-var _inherits2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/inherits"));
-var _wrapNativeSuper2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/wrapNativeSuper"));
-function _callSuper(t, o, e) { return o = (0, _getPrototypeOf2["default"])(o), (0, _possibleConstructorReturn2["default"])(t, _isNativeReflectConstruct() ? _Reflect$construct(o, e || [], (0, _getPrototypeOf2["default"])(t).constructor) : o.apply(t, e)); }
-function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(_Reflect$construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
-module.exports = /*#__PURE__*/function (_TypeError) {
-  function FalsyError(argumentValue, argumentName, functionName) {
-    var _this;
-    (0, _classCallCheck2["default"])(this, FalsyError);
-    _this = _callSuper(this, FalsyError, [argumentValue ? "Why are you creating a FalsyError with a truthy `argumentValue`: '" + argumentValue + "'?" : (functionName || "We") + " expected " + (argumentName ? "`" + argumentName + "`" : "an argument") + " to be truthy. " + (argumentName ? "`" + argumentName + "`" : "It") + " is the falsy value " + (argumentValue === "" ? "''" : argumentValue) + "."]);
-    _this.name = _this.constructor.name;
-    _this.argumentName = argumentName;
-    return _this;
-  }
-  (0, _inherits2["default"])(FalsyError, _TypeError);
-  return (0, _createClass2["default"])(FalsyError, null, [{
-    key: "check",
-    value: function check(argumentValue, argumentName, functionName) {
-      if (argumentValue) return;
-      throw new FalsyError(argumentValue, argumentName, functionName);
-    }
-  }]);
-}(/*#__PURE__*/(0, _wrapNativeSuper2["default"])(TypeError));

package/dist/MissingError.js

@@ -1,30 +0,0 @@
-"use strict";
-
-var _Reflect$construct = require("@babel/runtime-corejs3/core-js-stable/reflect/construct");
-var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault");
-var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/classCallCheck"));
-var _createClass2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/createClass"));
-var _possibleConstructorReturn2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/possibleConstructorReturn"));
-var _getPrototypeOf2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/getPrototypeOf"));
-var _inherits2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/inherits"));
-var _wrapNativeSuper2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/wrapNativeSuper"));
-function _callSuper(t, o, e) { return o = (0, _getPrototypeOf2["default"])(o), (0, _possibleConstructorReturn2["default"])(t, _isNativeReflectConstruct() ? _Reflect$construct(o, e || [], (0, _getPrototypeOf2["default"])(t).constructor) : o.apply(t, e)); }
-function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(_Reflect$construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
-module.exports = /*#__PURE__*/function (_TypeError) {
-  function MissingError(argumentValue, argumentName, functionName) {
-    var _this;
-    (0, _classCallCheck2["default"])(this, MissingError);
-    _this = _callSuper(this, MissingError, [argumentValue != null ? "Why are you creating a MissingError with a defined `argumentValue`: '" + argumentValue + "'?" : (functionName || "We") + " expected " + (argumentName ? "`" + argumentName + "`" : "an argument") + " to be defined. " + (argumentName ? "`" + argumentName + "`" : "It") + " is '" + argumentValue + "'."]);
-    _this.name = _this.constructor.name;
-    _this.argumentName = argumentName;
-    return _this;
-  }
-  (0, _inherits2["default"])(MissingError, _TypeError);
-  return (0, _createClass2["default"])(MissingError, null, [{
-    key: "check",
-    value: function check(argumentValue, argumentName, functionName) {
-      if (argumentValue != null) return;
-      throw new MissingError(argumentValue, argumentName, functionName);
-    }
-  }]);
-}(/*#__PURE__*/(0, _wrapNativeSuper2["default"])(TypeError));

package/dist/RethrownError.js

@@ -1,44 +0,0 @@
-"use strict";
-
-/*
- * See {@link Errors#RethrownError}.
- */
-var _Reflect$construct = require("@babel/runtime-corejs3/core-js-stable/reflect/construct");
-var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault");
-var _concat = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/instance/concat"));
-var _stringify = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/json/stringify"));
-var _createClass2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/createClass"));
-var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/classCallCheck"));
-var _possibleConstructorReturn2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/possibleConstructorReturn"));
-var _getPrototypeOf2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/getPrototypeOf"));
-var _inherits2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/inherits"));
-var _wrapNativeSuper2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/wrapNativeSuper"));
-function _callSuper(t, o, e) { return o = (0, _getPrototypeOf2["default"])(o), (0, _possibleConstructorReturn2["default"])(t, _isNativeReflectConstruct() ? _Reflect$construct(o, e || [], (0, _getPrototypeOf2["default"])(t).constructor) : o.apply(t, e)); }
-function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(_Reflect$construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
-module.exports = /*#__PURE__*/function (_Error) {
-  function RethrownError(error, message) {
-    var _context;
-    var _this;
-    (0, _classCallCheck2["default"])(this, RethrownError);
-    _this = _callSuper(this, RethrownError, [message != null ? message : getErrorProperty(error, "message")]);
-    if (!error) throw new TypeError("RethrownError's constructor expects a defined error, but it was ".concat(error, "."));
-    _this.name = _this.constructor.name;
-    _this.original = error;
-    _this.newStack = _this.stack;
-    var errorStack = getErrorProperty(error, "stack");
-    _this.stack = (0, _concat["default"])(_context = "".concat(_this.stack, "\n")).call(_context, errorStack);
-    return _this;
-  }
-  (0, _inherits2["default"])(RethrownError, _Error);
-  return (0, _createClass2["default"])(RethrownError);
-}(/*#__PURE__*/(0, _wrapNativeSuper2["default"])(Error));
-function getErrorProperty(error, property) {
-  if (error[property]) return error[property];
-  try {
-    return (0, _stringify["default"])(error);
-  } catch (e) {
-    // JSON.stringify might throw the following, "TypeError: Converting circular
-    // structure to JSON."
-    return error;
-  }
-}