yerror 6.1.1 → 6.2.1

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+## [6.2.1](https://github.com/nfroidure/yerror/compare/v6.2.0...v6.2.1) (2022-12-19)
+
+
+### Bug Fixes
+
+* **lib:** fix stack printing ([edf5fd3](https://github.com/nfroidure/yerror/commit/edf5fd32126a1689863cc995859243251d25c8b4))
+
+
+
+# [6.2.0](https://github.com/nfroidure/yerror/compare/v6.1.1...v6.2.0) (2022-12-19)
+
+
+
 ## [6.1.1](https://github.com/nfroidure/yerror/compare/v6.1.0...v6.1.1) (2022-05-27)
 
 

package/README.md

@@ -76,6 +76,24 @@ doSomethingAsync('nuts', 'code')
 [//]: # (::contents:end)
 
 # API
+## Classes
+
+<dl>
+<dt><a href="#YError">YError</a> ⇐ <code>Error</code></dt>
+<dd><p>An YError class able to contain some params and
+ print better stack traces</p>
+</dd>
+</dl>
+
+## Functions
+
+<dl>
+<dt><a href="#printStackTrace">printStackTrace(err)</a> ⇒ <code>string</code></dt>
+<dd><p>Allow to print a stack from anything (especially catched
+ errors that may or may not contain errors 🤷).</p>
+</dd>
+</dl>
+
 <a name="YError"></a>
 
 ## YError ⇐ <code>Error</code>
@@ -149,6 +167,19 @@ Same than `YError.wrap()` but preserves the code
 | [errorCode] | <code>string</code> | <code>&quot;&#x27;E_UNEXPECTED&#x27;&quot;</code> | The error code corresponding to the actual error |
 | [...params] | <code>any</code> |  | Some additional debugging values |
 
+<a name="printStackTrace"></a>
+
+## printStackTrace(err) ⇒ <code>string</code>
+Allow to print a stack from anything (especially catched
+ errors that may or may not contain errors 🤷).
+
+**Kind**: global function  
+**Returns**: <code>string</code> - The stack trace if any  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| err | <code>Error</code> | The error to print |
+
 
 # Authors
 - [Nicolas Froidure (formerly at SimpliField)](http://insertafter.com/en/index.html)

package/dist/index.js

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = exports.YError = void 0;
+exports.printStackTrace = printStackTrace;
 
 var _os = _interopRequireDefault(require("os"));
 
@@ -166,7 +167,20 @@ YError.bump = function yerrorBump(err, ...params) {
   }
 
   return YError.wrap.apply(YError, [err].concat(params));
-}; // In order to keep compatibility through major versions
+};
+/**
+ * Allow to print a stack from anything (especially catched
+ *  errors that may or may not contain errors 🤷).
+ * @param {Error} err
+ * The error to print
+ * @return {string}
+ * The stack trace if any
+ */
+
+
+function printStackTrace(err) {
+  return typeof err === 'object' && typeof err.stack === 'string' ? err.stack : `[no_stack_trace]: error is ${err != null && typeof err.toString === 'function' ? err.toString() : typeof err}`;
+} // In order to keep compatibility through major versions
 // we have to make kind of an cross major version instanceof
 
 

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["YError","wrappedErrors","errorCode","params","Array","concat","code","name","toString","Error","captureStackTrace","constructor","length","stack","os","EOL","join","wrap","yerrorWrap","err","yError","wrappedErrorIsACode","_looksLikeAYErrorCode","message","push","cast","yerrorCast","_looksLikeAYError","apply","bump","yerrorBump","endsWith","str","test"],"sources":["../src/index.js"],"sourcesContent":["import os from 'os';\n\n/**\n * An YError class able to contain some params and\n *  print better stack traces\n * @extends Error\n */\nclass YError extends Error {\n  /**\n   * Creates a new YError with an error code\n   *  and some params as debug values.\n   * @param {string} [errorCode = 'E_UNEXPECTED']\n   * The error code corresponding to the actual error\n   * @param {...any} [params]\n   * Some additional debugging values\n   */\n  constructor(wrappedErrors, errorCode, ...params) {\n    // Detecting if wrappedErrors are passed\n    if (!(wrappedErrors instanceof Array)) {\n      params = ('undefined' === typeof errorCode ? [] : [errorCode]).concat(\n        params,\n      );\n      errorCode = wrappedErrors;\n      wrappedErrors = [];\n    }\n\n    // Call the parent constructor\n    super(errorCode);\n\n    // Filling error\n    this.code = errorCode || 'E_UNEXPECTED';\n    this.params = params;\n    this.wrappedErrors = wrappedErrors;\n    this.name = this.toString();\n\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, this.constructor);\n    }\n  }\n\n  toString() {\n    return (\n      (this.wrappedErrors.length\n        ? // eslint-disable-next-line\n          this.wrappedErrors[this.wrappedErrors.length - 1].stack + os.EOL\n        : '') +\n      this.constructor.name +\n      ': ' +\n      this.code +\n      ' (' +\n      this.params.join(', ') +\n      ')'\n    );\n  }\n}\n\n/**\n * Wraps any error and output a YError with an error\n *  code and some params as debug values.\n * @param {Error} err\n * The error to wrap\n * @param {string} [errorCode = 'E_UNEXPECTED']\n * The error code corresponding to the actual error\n * @param {...any} [params]\n * Some additional debugging values\n * @return {YError}\n * The wrapped error\n */\nYError.wrap = function yerrorWrap(err, errorCode, ...params) {\n  let yError = null;\n  const wrappedErrorIsACode = _looksLikeAYErrorCode(err.message);\n  const wrappedErrors = (err.wrappedErrors || []).concat(err);\n\n  if (!errorCode) {\n    if (wrappedErrorIsACode) {\n      errorCode = err.message;\n    } else {\n      errorCode = 'E_UNEXPECTED';\n    }\n  }\n  if (err.message && !wrappedErrorIsACode) {\n    params.push(err.message);\n  }\n  yError = new YError(wrappedErrors, errorCode, ...params);\n  return yError;\n};\n\n/**\n * Return a YError as is or wraps any other error and output\n *  a YError with a code and some params as debug values.\n * @param {Error} err\n * The error to cast\n * @param {string} [errorCode = 'E_UNEXPECTED']\n * The error code corresponding to the actual error\n * @param {...any} [params]\n * Some additional debugging values\n * @return {YError}\n * The wrapped error\n */\nYError.cast = function yerrorCast(err, ...params) {\n  if (_looksLikeAYError(err)) {\n    return err;\n  }\n  return YError.wrap.apply(YError, [err].concat(params));\n};\n\n/**\n * Same than `YError.wrap()` but preserves the code\n *  and the debug values of the error if it is\n *  already an instance of the YError constructor.\n * @param {Error} err\n * The error to bump\n * @param {string} [errorCode = 'E_UNEXPECTED']\n * The error code corresponding to the actual error\n * @param {...any} [params]\n * Some additional debugging values\n * @return {YError}\n * The wrapped error\n */\nYError.bump = function yerrorBump(err, ...params) {\n  if (_looksLikeAYError(err)) {\n    return YError.wrap.apply(YError, [err, err.code].concat(err.params));\n  }\n  return YError.wrap.apply(YError, [err].concat(params));\n};\n\n// In order to keep compatibility through major versions\n// we have to make kind of an cross major version instanceof\nfunction _looksLikeAYError(err) {\n  return (\n    err instanceof YError ||\n    (err.constructor &&\n      err.constructor.name &&\n      err.constructor.name.endsWith('Error') &&\n      'string' === typeof err.code &&\n      _looksLikeAYErrorCode(err.code) &&\n      err.params &&\n      err.params instanceof Array)\n  );\n}\n\nfunction _looksLikeAYErrorCode(str) {\n  return /^([A-Z0-9_]+)$/.test(str);\n}\n\nexport default YError;\nexport { YError };\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["YError","wrappedErrors","errorCode","params","Array","concat","code","name","toString","Error","captureStackTrace","constructor","length","stack","os","EOL","join","wrap","yerrorWrap","err","yError","wrappedErrorIsACode","_looksLikeAYErrorCode","message","push","cast","yerrorCast","_looksLikeAYError","apply","bump","yerrorBump","printStackTrace","endsWith","str","test"],"sources":["../src/index.js"],"sourcesContent":["import os from 'os';\n\n/**\n * An YError class able to contain some params and\n *  print better stack traces\n * @extends Error\n */\nclass YError extends Error {\n  /**\n   * Creates a new YError with an error code\n   *  and some params as debug values.\n   * @param {string} [errorCode = 'E_UNEXPECTED']\n   * The error code corresponding to the actual error\n   * @param {...any} [params]\n   * Some additional debugging values\n   */\n  constructor(wrappedErrors, errorCode, ...params) {\n    // Detecting if wrappedErrors are passed\n    if (!(wrappedErrors instanceof Array)) {\n      params = ('undefined' === typeof errorCode ? [] : [errorCode]).concat(\n        params,\n      );\n      errorCode = wrappedErrors;\n      wrappedErrors = [];\n    }\n\n    // Call the parent constructor\n    super(errorCode);\n\n    // Filling error\n    this.code = errorCode || 'E_UNEXPECTED';\n    this.params = params;\n    this.wrappedErrors = wrappedErrors;\n    this.name = this.toString();\n\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, this.constructor);\n    }\n  }\n\n  toString() {\n    return (\n      (this.wrappedErrors.length\n        ? // eslint-disable-next-line\n          this.wrappedErrors[this.wrappedErrors.length - 1].stack + os.EOL\n        : '') +\n      this.constructor.name +\n      ': ' +\n      this.code +\n      ' (' +\n      this.params.join(', ') +\n      ')'\n    );\n  }\n}\n\n/**\n * Wraps any error and output a YError with an error\n *  code and some params as debug values.\n * @param {Error} err\n * The error to wrap\n * @param {string} [errorCode = 'E_UNEXPECTED']\n * The error code corresponding to the actual error\n * @param {...any} [params]\n * Some additional debugging values\n * @return {YError}\n * The wrapped error\n */\nYError.wrap = function yerrorWrap(err, errorCode, ...params) {\n  let yError = null;\n  const wrappedErrorIsACode = _looksLikeAYErrorCode(err.message);\n  const wrappedErrors = (err.wrappedErrors || []).concat(err);\n\n  if (!errorCode) {\n    if (wrappedErrorIsACode) {\n      errorCode = err.message;\n    } else {\n      errorCode = 'E_UNEXPECTED';\n    }\n  }\n  if (err.message && !wrappedErrorIsACode) {\n    params.push(err.message);\n  }\n  yError = new YError(wrappedErrors, errorCode, ...params);\n  return yError;\n};\n\n/**\n * Return a YError as is or wraps any other error and output\n *  a YError with a code and some params as debug values.\n * @param {Error} err\n * The error to cast\n * @param {string} [errorCode = 'E_UNEXPECTED']\n * The error code corresponding to the actual error\n * @param {...any} [params]\n * Some additional debugging values\n * @return {YError}\n * The wrapped error\n */\nYError.cast = function yerrorCast(err, ...params) {\n  if (_looksLikeAYError(err)) {\n    return err;\n  }\n  return YError.wrap.apply(YError, [err].concat(params));\n};\n\n/**\n * Same than `YError.wrap()` but preserves the code\n *  and the debug values of the error if it is\n *  already an instance of the YError constructor.\n * @param {Error} err\n * The error to bump\n * @param {string} [errorCode = 'E_UNEXPECTED']\n * The error code corresponding to the actual error\n * @param {...any} [params]\n * Some additional debugging values\n * @return {YError}\n * The wrapped error\n */\nYError.bump = function yerrorBump(err, ...params) {\n  if (_looksLikeAYError(err)) {\n    return YError.wrap.apply(YError, [err, err.code].concat(err.params));\n  }\n  return YError.wrap.apply(YError, [err].concat(params));\n};\n\n/**\n * Allow to print a stack from anything (especially catched\n *  errors that may or may not contain errors 🤷).\n * @param {Error} err\n * The error to print\n * @return {string}\n * The stack trace if any\n */\nexport function printStackTrace(err) {\n  return typeof err === 'object' && typeof err.stack === 'string'\n    ? err.stack\n    : `[no_stack_trace]: error is ${\n        err != null && typeof err.toString === 'function'\n          ? err.toString()\n          : typeof err\n      }`;\n}\n\n// In order to keep compatibility through major versions\n// we have to make kind of an cross major version instanceof\nfunction _looksLikeAYError(err) {\n  return (\n    err instanceof YError ||\n    (err.constructor &&\n      err.constructor.name &&\n      err.constructor.name.endsWith('Error') &&\n      'string' === typeof err.code &&\n      _looksLikeAYErrorCode(err.code) &&\n      err.params &&\n      err.params instanceof Array)\n  );\n}\n\nfunction _looksLikeAYErrorCode(str) {\n  return /^([A-Z0-9_]+)$/.test(str);\n}\n\nexport default YError;\nexport { YError };\n"],"mappings":"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"}

package/dist/index.mjs

@@ -100,6 +100,10 @@ YError.bump = function yerrorBump(err, ...params) {
   return YError.wrap.apply(YError, [err].concat(params));
 };
 
+export function printStackTrace(err) {
+  return typeof err === 'object' && typeof err.stack === 'string' ? err.stack : `[no_stack_trace]: error is ${err != null && typeof err.toString === 'function' ? err.toString() : typeof err}`;
+}
+
 function _looksLikeAYError(err) {
   return err instanceof YError || err.constructor && err.constructor.name && err.constructor.name.endsWith('Error') && 'string' === typeof err.code && _looksLikeAYErrorCode(err.code) && err.params && err.params instanceof Array;
 }

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["os","YError","wrappedErrors","errorCode","params","Array","concat","code","name","toString","Error","captureStackTrace","constructor","length","stack","EOL","join","wrap","yerrorWrap","err","yError","wrappedErrorIsACode","_looksLikeAYErrorCode","message","push","cast","yerrorCast","_looksLikeAYError","apply","bump","yerrorBump","endsWith","str","test"],"sources":["../src/index.js"],"sourcesContent":["import os from 'os';\n\n/**\n * An YError class able to contain some params and\n *  print better stack traces\n * @extends Error\n */\nclass YError extends Error {\n  /**\n   * Creates a new YError with an error code\n   *  and some params as debug values.\n   * @param {string} [errorCode = 'E_UNEXPECTED']\n   * The error code corresponding to the actual error\n   * @param {...any} [params]\n   * Some additional debugging values\n   */\n  constructor(wrappedErrors, errorCode, ...params) {\n    // Detecting if wrappedErrors are passed\n    if (!(wrappedErrors instanceof Array)) {\n      params = ('undefined' === typeof errorCode ? [] : [errorCode]).concat(\n        params,\n      );\n      errorCode = wrappedErrors;\n      wrappedErrors = [];\n    }\n\n    // Call the parent constructor\n    super(errorCode);\n\n    // Filling error\n    this.code = errorCode || 'E_UNEXPECTED';\n    this.params = params;\n    this.wrappedErrors = wrappedErrors;\n    this.name = this.toString();\n\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, this.constructor);\n    }\n  }\n\n  toString() {\n    return (\n      (this.wrappedErrors.length\n        ? // eslint-disable-next-line\n          this.wrappedErrors[this.wrappedErrors.length - 1].stack + os.EOL\n        : '') +\n      this.constructor.name +\n      ': ' +\n      this.code +\n      ' (' +\n      this.params.join(', ') +\n      ')'\n    );\n  }\n}\n\n/**\n * Wraps any error and output a YError with an error\n *  code and some params as debug values.\n * @param {Error} err\n * The error to wrap\n * @param {string} [errorCode = 'E_UNEXPECTED']\n * The error code corresponding to the actual error\n * @param {...any} [params]\n * Some additional debugging values\n * @return {YError}\n * The wrapped error\n */\nYError.wrap = function yerrorWrap(err, errorCode, ...params) {\n  let yError = null;\n  const wrappedErrorIsACode = _looksLikeAYErrorCode(err.message);\n  const wrappedErrors = (err.wrappedErrors || []).concat(err);\n\n  if (!errorCode) {\n    if (wrappedErrorIsACode) {\n      errorCode = err.message;\n    } else {\n      errorCode = 'E_UNEXPECTED';\n    }\n  }\n  if (err.message && !wrappedErrorIsACode) {\n    params.push(err.message);\n  }\n  yError = new YError(wrappedErrors, errorCode, ...params);\n  return yError;\n};\n\n/**\n * Return a YError as is or wraps any other error and output\n *  a YError with a code and some params as debug values.\n * @param {Error} err\n * The error to cast\n * @param {string} [errorCode = 'E_UNEXPECTED']\n * The error code corresponding to the actual error\n * @param {...any} [params]\n * Some additional debugging values\n * @return {YError}\n * The wrapped error\n */\nYError.cast = function yerrorCast(err, ...params) {\n  if (_looksLikeAYError(err)) {\n    return err;\n  }\n  return YError.wrap.apply(YError, [err].concat(params));\n};\n\n/**\n * Same than `YError.wrap()` but preserves the code\n *  and the debug values of the error if it is\n *  already an instance of the YError constructor.\n * @param {Error} err\n * The error to bump\n * @param {string} [errorCode = 'E_UNEXPECTED']\n * The error code corresponding to the actual error\n * @param {...any} [params]\n * Some additional debugging values\n * @return {YError}\n * The wrapped error\n */\nYError.bump = function yerrorBump(err, ...params) {\n  if (_looksLikeAYError(err)) {\n    return YError.wrap.apply(YError, [err, err.code].concat(err.params));\n  }\n  return YError.wrap.apply(YError, [err].concat(params));\n};\n\n// In order to keep compatibility through major versions\n// we have to make kind of an cross major version instanceof\nfunction _looksLikeAYError(err) {\n  return (\n    err instanceof YError ||\n    (err.constructor &&\n      err.constructor.name &&\n      err.constructor.name.endsWith('Error') &&\n      'string' === typeof err.code &&\n      _looksLikeAYErrorCode(err.code) &&\n      err.params &&\n      err.params instanceof Array)\n  );\n}\n\nfunction _looksLikeAYErrorCode(str) {\n  return /^([A-Z0-9_]+)$/.test(str);\n}\n\nexport default YError;\nexport { YError };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAOA,EAAP,MAAe,IAAf;;IAOMC,M;;;EASJ,gBAAYC,aAAZ,EAA2BC,SAA3B,EAAsC,GAAGC,MAAzC,EAAiD;IAAA;;IAAA;;IAE/C,IAAI,EAAEF,aAAa,YAAYG,KAA3B,CAAJ,EAAuC;MACrCD,MAAM,GAAG,CAAC,gBAAgB,OAAOD,SAAvB,GAAmC,EAAnC,GAAwC,CAACA,SAAD,CAAzC,EAAsDG,MAAtD,CACPF,MADO,CAAT;MAGAD,SAAS,GAAGD,aAAZ;MACAA,aAAa,GAAG,EAAhB;IACD;;IAGD,4EAAMC,SAAN;IAGA,MAAKI,IAAL,GAAYJ,SAAS,IAAI,cAAzB;IACA,MAAKC,MAAL,GAAcA,MAAd;IACA,MAAKF,aAAL,GAAqBA,aAArB;IACA,MAAKM,IAAL,GAAY,MAAKC,QAAL,EAAZ;;IAEA,IAAIC,KAAK,CAACC,iBAAV,EAA6B;MAC3BD,KAAK,CAACC,iBAAN,gCAA8B,MAAKC,WAAnC;IACD;;IArB8C;EAsBhD;;;;+BAEU;MACT,OACE,CAAC,KAAKV,aAAL,CAAmBW,MAAnB,GAEG,KAAKX,aAAL,CAAmB,KAAKA,aAAL,CAAmBW,MAAnB,GAA4B,CAA/C,EAAkDC,KAAlD,GAA0Dd,EAAE,CAACe,GAFhE,GAGG,EAHJ,IAIA,KAAKH,WAAL,CAAiBJ,IAJjB,GAKA,IALA,GAMA,KAAKD,IANL,GAOA,IAPA,GAQA,KAAKH,MAAL,CAAYY,IAAZ,CAAiB,IAAjB,CARA,GASA,GAVF;IAYD;;;;mBA9CkBN,K;;AA6DrBT,MAAM,CAACgB,IAAP,GAAc,SAASC,UAAT,CAAoBC,GAApB,EAAyBhB,SAAzB,EAAoC,GAAGC,MAAvC,EAA+C;EAC3D,IAAIgB,MAAM,GAAG,IAAb;;EACA,MAAMC,mBAAmB,GAAGC,qBAAqB,CAACH,GAAG,CAACI,OAAL,CAAjD;;EACA,MAAMrB,aAAa,GAAG,CAACiB,GAAG,CAACjB,aAAJ,IAAqB,EAAtB,EAA0BI,MAA1B,CAAiCa,GAAjC,CAAtB;;EAEA,IAAI,CAAChB,SAAL,EAAgB;IACd,IAAIkB,mBAAJ,EAAyB;MACvBlB,SAAS,GAAGgB,GAAG,CAACI,OAAhB;IACD,CAFD,MAEO;MACLpB,SAAS,GAAG,cAAZ;IACD;EACF;;EACD,IAAIgB,GAAG,CAACI,OAAJ,IAAe,CAACF,mBAApB,EAAyC;IACvCjB,MAAM,CAACoB,IAAP,CAAYL,GAAG,CAACI,OAAhB;EACD;;EACDH,MAAM,GAAG,IAAInB,MAAJ,CAAWC,aAAX,EAA0BC,SAA1B,EAAqC,GAAGC,MAAxC,CAAT;EACA,OAAOgB,MAAP;AACD,CAjBD;;AA+BAnB,MAAM,CAACwB,IAAP,GAAc,SAASC,UAAT,CAAoBP,GAApB,EAAyB,GAAGf,MAA5B,EAAoC;EAChD,IAAIuB,iBAAiB,CAACR,GAAD,CAArB,EAA4B;IAC1B,OAAOA,GAAP;EACD;;EACD,OAAOlB,MAAM,CAACgB,IAAP,CAAYW,KAAZ,CAAkB3B,MAAlB,EAA0B,CAACkB,GAAD,EAAMb,MAAN,CAAaF,MAAb,CAA1B,CAAP;AACD,CALD;;AAoBAH,MAAM,CAAC4B,IAAP,GAAc,SAASC,UAAT,CAAoBX,GAApB,EAAyB,GAAGf,MAA5B,EAAoC;EAChD,IAAIuB,iBAAiB,CAACR,GAAD,CAArB,EAA4B;IAC1B,OAAOlB,MAAM,CAACgB,IAAP,CAAYW,KAAZ,CAAkB3B,MAAlB,EAA0B,CAACkB,GAAD,EAAMA,GAAG,CAACZ,IAAV,EAAgBD,MAAhB,CAAuBa,GAAG,CAACf,MAA3B,CAA1B,CAAP;EACD;;EACD,OAAOH,MAAM,CAACgB,IAAP,CAAYW,KAAZ,CAAkB3B,MAAlB,EAA0B,CAACkB,GAAD,EAAMb,MAAN,CAAaF,MAAb,CAA1B,CAAP;AACD,CALD;;AASA,SAASuB,iBAAT,CAA2BR,GAA3B,EAAgC;EAC9B,OACEA,GAAG,YAAYlB,MAAf,IACCkB,GAAG,CAACP,WAAJ,IACCO,GAAG,CAACP,WAAJ,CAAgBJ,IADjB,IAECW,GAAG,CAACP,WAAJ,CAAgBJ,IAAhB,CAAqBuB,QAArB,CAA8B,OAA9B,CAFD,IAGC,aAAa,OAAOZ,GAAG,CAACZ,IAHzB,IAICe,qBAAqB,CAACH,GAAG,CAACZ,IAAL,CAJtB,IAKCY,GAAG,CAACf,MALL,IAMCe,GAAG,CAACf,MAAJ,YAAsBC,KAR1B;AAUD;;AAED,SAASiB,qBAAT,CAA+BU,GAA/B,EAAoC;EAClC,OAAO,iBAAiBC,IAAjB,CAAsBD,GAAtB,CAAP;AACD;;AAED,eAAe/B,MAAf;AACA,SAASA,MAAT"}
+{"version":3,"file":"index.mjs","names":["os","YError","wrappedErrors","errorCode","params","Array","concat","code","name","toString","Error","captureStackTrace","constructor","length","stack","EOL","join","wrap","yerrorWrap","err","yError","wrappedErrorIsACode","_looksLikeAYErrorCode","message","push","cast","yerrorCast","_looksLikeAYError","apply","bump","yerrorBump","printStackTrace","endsWith","str","test"],"sources":["../src/index.js"],"sourcesContent":["import os from 'os';\n\n/**\n * An YError class able to contain some params and\n *  print better stack traces\n * @extends Error\n */\nclass YError extends Error {\n  /**\n   * Creates a new YError with an error code\n   *  and some params as debug values.\n   * @param {string} [errorCode = 'E_UNEXPECTED']\n   * The error code corresponding to the actual error\n   * @param {...any} [params]\n   * Some additional debugging values\n   */\n  constructor(wrappedErrors, errorCode, ...params) {\n    // Detecting if wrappedErrors are passed\n    if (!(wrappedErrors instanceof Array)) {\n      params = ('undefined' === typeof errorCode ? [] : [errorCode]).concat(\n        params,\n      );\n      errorCode = wrappedErrors;\n      wrappedErrors = [];\n    }\n\n    // Call the parent constructor\n    super(errorCode);\n\n    // Filling error\n    this.code = errorCode || 'E_UNEXPECTED';\n    this.params = params;\n    this.wrappedErrors = wrappedErrors;\n    this.name = this.toString();\n\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, this.constructor);\n    }\n  }\n\n  toString() {\n    return (\n      (this.wrappedErrors.length\n        ? // eslint-disable-next-line\n          this.wrappedErrors[this.wrappedErrors.length - 1].stack + os.EOL\n        : '') +\n      this.constructor.name +\n      ': ' +\n      this.code +\n      ' (' +\n      this.params.join(', ') +\n      ')'\n    );\n  }\n}\n\n/**\n * Wraps any error and output a YError with an error\n *  code and some params as debug values.\n * @param {Error} err\n * The error to wrap\n * @param {string} [errorCode = 'E_UNEXPECTED']\n * The error code corresponding to the actual error\n * @param {...any} [params]\n * Some additional debugging values\n * @return {YError}\n * The wrapped error\n */\nYError.wrap = function yerrorWrap(err, errorCode, ...params) {\n  let yError = null;\n  const wrappedErrorIsACode = _looksLikeAYErrorCode(err.message);\n  const wrappedErrors = (err.wrappedErrors || []).concat(err);\n\n  if (!errorCode) {\n    if (wrappedErrorIsACode) {\n      errorCode = err.message;\n    } else {\n      errorCode = 'E_UNEXPECTED';\n    }\n  }\n  if (err.message && !wrappedErrorIsACode) {\n    params.push(err.message);\n  }\n  yError = new YError(wrappedErrors, errorCode, ...params);\n  return yError;\n};\n\n/**\n * Return a YError as is or wraps any other error and output\n *  a YError with a code and some params as debug values.\n * @param {Error} err\n * The error to cast\n * @param {string} [errorCode = 'E_UNEXPECTED']\n * The error code corresponding to the actual error\n * @param {...any} [params]\n * Some additional debugging values\n * @return {YError}\n * The wrapped error\n */\nYError.cast = function yerrorCast(err, ...params) {\n  if (_looksLikeAYError(err)) {\n    return err;\n  }\n  return YError.wrap.apply(YError, [err].concat(params));\n};\n\n/**\n * Same than `YError.wrap()` but preserves the code\n *  and the debug values of the error if it is\n *  already an instance of the YError constructor.\n * @param {Error} err\n * The error to bump\n * @param {string} [errorCode = 'E_UNEXPECTED']\n * The error code corresponding to the actual error\n * @param {...any} [params]\n * Some additional debugging values\n * @return {YError}\n * The wrapped error\n */\nYError.bump = function yerrorBump(err, ...params) {\n  if (_looksLikeAYError(err)) {\n    return YError.wrap.apply(YError, [err, err.code].concat(err.params));\n  }\n  return YError.wrap.apply(YError, [err].concat(params));\n};\n\n/**\n * Allow to print a stack from anything (especially catched\n *  errors that may or may not contain errors 🤷).\n * @param {Error} err\n * The error to print\n * @return {string}\n * The stack trace if any\n */\nexport function printStackTrace(err) {\n  return typeof err === 'object' && typeof err.stack === 'string'\n    ? err.stack\n    : `[no_stack_trace]: error is ${\n        err != null && typeof err.toString === 'function'\n          ? err.toString()\n          : typeof err\n      }`;\n}\n\n// In order to keep compatibility through major versions\n// we have to make kind of an cross major version instanceof\nfunction _looksLikeAYError(err) {\n  return (\n    err instanceof YError ||\n    (err.constructor &&\n      err.constructor.name &&\n      err.constructor.name.endsWith('Error') &&\n      'string' === typeof err.code &&\n      _looksLikeAYErrorCode(err.code) &&\n      err.params &&\n      err.params instanceof Array)\n  );\n}\n\nfunction _looksLikeAYErrorCode(str) {\n  return /^([A-Z0-9_]+)$/.test(str);\n}\n\nexport default YError;\nexport { YError };\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yerror",
-  "version": "6.1.1",
+  "version": "6.2.1",
   "description": "It helps to know why you got an error.",
   "main": "dist/index",
   "module": "dist/index.mjs",

package/src/index.d.ts

@@ -20,5 +20,7 @@ declare class YError extends Error {
   ): YError;
 }
 
+export function printStackTrace(err: any): string;
+
 export { YError };
 export default YError;

package/src/index.js

@@ -124,6 +124,24 @@ YError.bump = function yerrorBump(err, ...params) {
   return YError.wrap.apply(YError, [err].concat(params));
 };
 
+/**
+ * Allow to print a stack from anything (especially catched
+ *  errors that may or may not contain errors 🤷).
+ * @param {Error} err
+ * The error to print
+ * @return {string}
+ * The stack trace if any
+ */
+export function printStackTrace(err) {
+  return typeof err === 'object' && typeof err.stack === 'string'
+    ? err.stack
+    : `[no_stack_trace]: error is ${
+        err != null && typeof err.toString === 'function'
+          ? err.toString()
+          : typeof err
+      }`;
+}
+
 // In order to keep compatibility through major versions
 // we have to make kind of an cross major version instanceof
 function _looksLikeAYError(err) {