@naturalcycles/js-lib 14.173.0 → 14.174.0

package/dist/error/error.util.d.ts

@@ -55,6 +55,26 @@ export declare function _isErrorLike(o: any): o is ErrorLike;
  * }
  */
 export declare function _errorDataAppend<ERR>(err: ERR, data?: ErrorData): ERR;
+export interface AppErrorComponents<DATA_TYPE extends ErrorData = ErrorData> {
+    message: string;
+    name?: string;
+    data?: DATA_TYPE;
+    cause?: any;
+}
+/**
+ * Extra options for AppError constructor.
+ */
+export interface AppErrorOptions {
+    /**
+     * Overrides Error.name and Error.constructor.name
+     */
+    name?: string;
+    /**
+     * Sets Error.cause.
+     * It is transformed with _anyToErrorObject()
+     */
+    cause?: any;
+}
 /**
  * Base class for all our (not system) errors.
  *
@@ -70,21 +90,11 @@ export declare class AppError<DATA_TYPE extends ErrorData = ErrorData> extends E
      * `cause` here is normalized to be an ErrorObject
      */
     cause?: ErrorObject;
-    constructor(message: string, data?: DATA_TYPE, opt?: AppErrorOptions);
-}
-/**
- * Extra options for AppError constructor.
- */
-export interface AppErrorOptions {
     /**
-     * Overrides Error.name and Error.constructor.name
+     * Experimental alternative static constructor.
      */
-    name?: string;
-    /**
-     * Sets Error.cause.
-     * It is transformed with _anyToErrorObject()
-     */
-    cause?: any;
+    static of<DATA_TYPE extends ErrorData = ErrorData>(opt: AppErrorComponents): AppError<DATA_TYPE>;
+    constructor(message: string, data?: DATA_TYPE, opt?: AppErrorOptions);
 }
 /**
  * Error that is thrown when Http Request was made and returned an error.

package/dist/error/error.util.js

@@ -235,9 +235,18 @@ exports._errorDataAppend = _errorDataAppend;
  * Based on: https://medium.com/@xpl/javascript-deriving-from-error-properly-8d2f8f315801
  */
 class AppError extends Error {
+    /**
+     * Experimental alternative static constructor.
+     */
+    static of(opt) {
+        return new AppError(opt.message, opt.data, {
+            name: opt.name,
+            cause: opt.cause,
+        });
+    }
     constructor(message, data = {}, opt = {}) {
         super(message);
-        const { name = this.constructor.name, cause } = opt;
+        const { name = 'AppError', cause } = opt;
         Object.defineProperties(this, {
             name: {
                 value: name,

package/dist-esm/error/error.util.js

@@ -217,9 +217,18 @@ export function _errorDataAppend(err, data) {
  * Based on: https://medium.com/@xpl/javascript-deriving-from-error-properly-8d2f8f315801
  */
 export class AppError extends Error {
+    /**
+     * Experimental alternative static constructor.
+     */
+    static of(opt) {
+        return new AppError(opt.message, opt.data, {
+            name: opt.name,
+            cause: opt.cause,
+        });
+    }
     constructor(message, data = {}, opt = {}) {
         super(message);
-        const { name = this.constructor.name, cause } = opt;
+        const { name = 'AppError', cause } = opt;
         Object.defineProperties(this, {
             name: {
                 value: name,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.173.0",
+  "version": "14.174.0",
   "scripts": {
     "prepare": "husky install",
     "build-prod": "build-prod-esm-cjs",

package/src/error/error.util.ts

@@ -273,6 +273,29 @@ export function _errorDataAppend<ERR>(err: ERR, data?: ErrorData): ERR {
   return err
 }
 
+export interface AppErrorComponents<DATA_TYPE extends ErrorData = ErrorData> {
+  message: string
+  name?: string
+  data?: DATA_TYPE
+  cause?: any
+}
+
+/**
+ * Extra options for AppError constructor.
+ */
+export interface AppErrorOptions {
+  /**
+   * Overrides Error.name and Error.constructor.name
+   */
+  name?: string
+
+  /**
+   * Sets Error.cause.
+   * It is transformed with _anyToErrorObject()
+   */
+  cause?: any
+}
+
 /**
  * Base class for all our (not system) errors.
  *
@@ -290,9 +313,19 @@ export class AppError<DATA_TYPE extends ErrorData = ErrorData> extends Error {
    */
   override cause?: ErrorObject
 
+  /**
+   * Experimental alternative static constructor.
+   */
+  static of<DATA_TYPE extends ErrorData = ErrorData>(opt: AppErrorComponents): AppError<DATA_TYPE> {
+    return new AppError<DATA_TYPE>(opt.message, opt.data as DATA_TYPE, {
+      name: opt.name,
+      cause: opt.cause,
+    })
+  }
+
   constructor(message: string, data = {} as DATA_TYPE, opt: AppErrorOptions = {}) {
     super(message)
-    const { name = this.constructor.name, cause } = opt
+    const { name = 'AppError', cause } = opt
 
     Object.defineProperties(this, {
       name: {
@@ -337,22 +370,6 @@ export class AppError<DATA_TYPE extends ErrorData = ErrorData> extends Error {
   }
 }
 
-/**
- * Extra options for AppError constructor.
- */
-export interface AppErrorOptions {
-  /**
-   * Overrides Error.name and Error.constructor.name
-   */
-  name?: string
-
-  /**
-   * Sets Error.cause.
-   * It is transformed with _anyToErrorObject()
-   */
-  cause?: any
-}
-
 /**
  * Error that is thrown when Http Request was made and returned an error.
  * Thrown by, for example, Fetcher.