@creejs/commons-lang 2.1.20 → 2.1.21

package/dist/umd/index.dev.js

@@ -4,6 +4,104 @@
   (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.CommonsLang = {}));
 })(this, (function (exports) { 'use strict';
 
+  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
@@ -2573,8 +2671,9 @@
    * @description Core language utilities for type checking, string manipulation, and common operations.
    */
 
-
   var index = {
+    _Error,
+    AggregatedError,
     LangUtils,
     StringUtils,
     TypeUtils,
@@ -2593,6 +2692,7 @@
     ArrayUtils
   };
 
+  exports.AggregatedError = AggregatedError;
   exports.ArrayBufferUtils = ArrayBufferUtils;
   exports.ArrayUtils = ArrayUtils;
   exports.ClassProxyUtils = ClassProxyUtils;
@@ -2609,6 +2709,7 @@
   exports.TypeAssert = TypeAssert;
   exports.TypeUtils = TypeUtils;
   exports.TypedArrayUtils = TypedArrayUtils;
+  exports._Error = _Error;
   exports.default = index;
 
   Object.defineProperty(exports, '__esModule', { value: true });