@creejs/commons-lang 2.1.20 → 2.1.22

package/dist/cjs/index-dev.cjs

@@ -2,6 +2,104 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
+class _Error extends Error {
+  /**
+   * Creates and returns a 404 Not Found error instance with the given message.
+   * @param {string} message - The error message to include.
+   * @returns {_Error} A new Error instance with status code 404.
+   */
+  static notFound (message) {
+    return new _Error(`Not Found: ${message}`, 404)
+  }
+
+  static notImpled () {
+    return new _Error('Not Impled Yet', 501)
+  }
+
+  /**
+   * Creates and returns a new Error instance for not supported operations.
+   * @param {string} message - The error message to include.
+   * @returns {_Error} A new Error instance with "Not Supported:" prefix and 505 status code.
+   */
+  static notSupported (message) {
+    return new _Error('Not Supported:' + message, 505)
+  }
+
+  /**
+   * Checks if the given error is a "Not Supported" error.
+   * @param {Error|_Error|{[key:string]:any}|unknown} err - The error to check
+   * @returns {boolean} True if the error is a Not Supported error (code 505), false otherwise
+   */
+  static isNotSupported (err) {
+    // @ts-ignore
+    return err?.code === 505
+  }
+
+  /**
+   * Error constructor with custom message and code.
+   * @param {string} message - Error message
+   * @param {number|string} code - Error code
+   */
+  constructor (message, code) {
+    super(message);
+    this.code = code;
+  }
+}
+
+class AggregatedError extends Error {
+  /**
+   * Checks if the given error is an AggregatedErrorLike
+   * 1. have "message:string" property
+   * 2. have "errors:Error[]" property
+   * @param {any} err - The error to check
+   * @returns {boolean} True if the error is an AggregatedError, false otherwise
+   */
+  static isAggregatedErrorLike (err) {
+    return err && Array.isArray(err.errors)
+  }
+
+  /**
+   * Checks if the given error is an instance of AggregatedError.
+   * @param {Error} err - The error to check.
+   * @returns {boolean} True if the error is an AggregatedError, false otherwise.
+   */
+  static isAggregatedError (err) {
+    return err instanceof AggregatedError
+  }
+
+  /**
+   * Error constructor with custom message and code.
+   * @param {string} message - Error message
+   * @param {any[]} [errors] - Errors
+   */
+  constructor (message, errors) {
+    super(message);
+    this.errors = errors ?? [];
+  }
+
+  /**
+   * Adds an error to the errors collection.
+   * @param {any} err - The error object to be added.
+   */
+  addError (err) {
+    this.errors.push(err);
+  }
+
+  /**
+   * Removes a specific error from the errors array.
+   * @param {Error} err - The error instance to remove.
+   * @returns {boolean} True if the error was found and removed, false otherwise.
+   */
+  removeError (err) {
+    const index = this.errors.indexOf(err);
+    if (index === -1) {
+      return false
+    }
+    this.errors.splice(index, 1);
+    return true
+  }
+}
+
 /**
  * @module LangUtils
  * @description Language utility functions
@@ -1755,12 +1853,12 @@ function any (tasks) {
       errors.push(e);
       // all tasks failed
       if (errors.length >= tasks.length) {
-        deferred.reject(errors);
+        deferred.reject(new AggregatedError('All Tasks Failed', errors));
       }
     });
   }
   if (errors.length === tasks.length) {
-    deferred.reject(errors);
+    deferred.reject(new AggregatedError('All Tasks Failed', errors));
   }
   return deferred.promise
 }
@@ -1953,7 +2051,7 @@ async function parallelAny (tasks, maxParallel = 5) {
       // No task left, and No successful execution, reject with errors
       if (errors.length >= tasks.length) {
         if (deferred.pending) {
-          deferred.reject(errors);
+          deferred.reject(new AggregatedError('All Tasks Failed', errors));
           return
         }
       }
@@ -2571,8 +2669,9 @@ function chunk (array, size) {
  * @description Core language utilities for type checking, string manipulation, and common operations.
  */
 
-
 var index = {
+  _Error,
+  AggregatedError,
   LangUtils,
   StringUtils,
   TypeUtils,
@@ -2591,6 +2690,7 @@ var index = {
   ArrayUtils
 };
 
+exports.AggregatedError = AggregatedError;
 exports.ArrayBufferUtils = ArrayBufferUtils;
 exports.ArrayUtils = ArrayUtils;
 exports.ClassProxyUtils = ClassProxyUtils;
@@ -2607,5 +2707,6 @@ exports.Type = TypeUtils;
 exports.TypeAssert = TypeAssert;
 exports.TypeUtils = TypeUtils;
 exports.TypedArrayUtils = TypedArrayUtils;
+exports._Error = _Error;
 exports.default = index;
 //# sourceMappingURL=index-dev.cjs.map