@creejs/commons-lang 2.1.23 → 2.1.25

package/dist/cjs/index-dev.cjs

@@ -2,7 +2,40 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
+/**
+ * @typedef  {{
+ *    type: string,
+ *    message: string,
+ *    _code: number,
+ * }} _ErrorLike
+ */
+
+// module vars
+const ErrorCode = {
+  NOT_FOUND: 404,
+  NOT_SUPPORTED: 505,
+  NOT_IMPL: 501
+};
+/**
+ * @class _Error
+ */
 class _Error extends Error {
+  static get Code () {
+    return ErrorCode
+  }
+
+  /**
+   * Checks if the given value is an _ErrorLike object
+   * @param {{[key:string]:any}} err - The value to checke
+   * @returns {boolean} True if the value is error-like
+   */
+  static isErrorLike (err) {
+    if (err == null) {
+      return false
+    }
+    return err._type === '_' && typeof err.code === 'number'
+  }
+
   /**
    * Creates and returns a 404 Not Found error instance with the given message.
    * @param {string} message - The error message to include.
@@ -42,6 +75,7 @@ class _Error extends Error {
    */
   constructor (message, code) {
     super(message);
+    this._type = '_'; // use this to identify if it's _Error
     this.code = code;
   }
 }
@@ -128,14 +162,14 @@ function constructorName (value) {
 
 /**
  * Assigns default values from source objects to target object for undefined properties.
- * @param {Object<string, any>} target - The target object to assign defaults to
- * @param {...Object<string, any>} sources - Source objects containing default values
- * @returns {Object<string, any>} The modified target object with defaults applied
- * @throws {TypeError} If target is null or undefined
+ * 1. No Deep-Copy, only first level properties are assigned.
+ * @param {{[key:string]:any}} target - The target object to assign defaults to
+ * @param {...{[key:string]:any}|undefined} sources - Source objects containing default values
+ * @returns {{[key:string]:any}} The modified target object with defaults applied
  */
 function defaults (target, ...sources) {
   if (target == null) {
-    throw new TypeError('"target" must not be null or undefined')
+    throw new TypeError('"target" Should Not Nil')
   }
   for (const source of sources) {
     if (source == null) {
@@ -1115,11 +1149,13 @@ function isEmpty (str) {
 /**
  * Asserts that the given string is not empty.
  * @param {string} str - The string to check.
+ * @param {string} [paramName]
+ *
  * @throws {Error} Throws an error if the string is empty.
  */
-function assertNotEmpty (str) {
+function assertNotEmpty (str, paramName) {
   if (isEmpty(str)) {
-    throw new Error(`Empty String: ${str}`)
+    throw new Error(`${paramName ? '"' + paramName + '" ' : ''}IsEmpty String: ${str}`)
   }
 }
 
@@ -1140,11 +1176,12 @@ function isBlank (str) {
 /**
  * Asserts that the given string is not blank.
  * @param {string} str - The string to check.
+ * @param {string} [paramName]
  * @throws {Error} Throws an error if the string is blank.
  */
-function assertNotBlank (str) {
+function assertNotBlank (str, paramName) {
   if (isBlank(str)) {
-    throw new Error(`Blank String: ${str}`)
+    throw new Error(`${paramName ? '"' + paramName + '" ' : ''}Is Blank: ${str}`)
   }
 }