@rzl-zone/utils-js 3.7.1 → 3.8.0

package/dist/chunk-DPLL67OT.js

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================

package/dist/chunk-DVMHRLKP.cjs

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================

package/dist/chunk-EK7FSI7F.cjs

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================

package/dist/chunk-F3WBQKRI.cjs

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================

package/dist/chunk-FI76UZRF.js

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================

package/dist/chunk-GAJBF6DR.js

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================

package/dist/{chunk-K3SONK25.cjs → chunk-HKJZ7K2K.cjs}

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
@@ -27,16 +27,25 @@ var randomInt = (min, max) => {
         max
       )}value, but received: ['min': \`${chunkF3WBQKRI_cjs.getPreciseType(
         min
-      )}\` - (with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(min)})\`, 'max': \`${chunkF3WBQKRI_cjs.getPreciseType(
-        max
-      )}\` - (with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(max)}\`)].`
+      )}\` - (with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(min, {
+        keepUndefined: true
+      })})\`, 'max': \`${chunkF3WBQKRI_cjs.getPreciseType(max)}\` - (with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(
+        max,
+        {
+          keepUndefined: true
+        }
+      )}\`)].`
     );
   }
   if (min > max) {
     throw new RangeError(
       `First parameter (\`min\`) must be less than or equal to second parameter (\`max\`), but received: ['min': ${formatValue(
         min
-      )}, 'max': ${formatValue(max)}].`
+      )} - (with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(min, {
+        keepUndefined: true
+      })})\`, 'max': ${formatValue(max)} - (with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(max, {
+        keepUndefined: true
+      })})\`].`
     );
   }
   min = Math.max(1, min);
@@ -64,11 +73,13 @@ var randomIntByLength = (options) => {
     throw new TypeError(
       `Parameters \`minLength\` and \`maxLength\` must be of type \`integer-number\`, but received: ['minLength': \`${chunkF3WBQKRI_cjs.getPreciseType(
         minLength
-      )}\` - (with value: ${chunkYC7AK3KX_cjs.safeStableStringify(
-        minLength
-      )}), 'maxLength': \`${chunkF3WBQKRI_cjs.getPreciseType(
+      )}\` - (with value: ${chunkYC7AK3KX_cjs.safeStableStringify(minLength, {
+        keepUndefined: true
+      })}), 'maxLength': \`${chunkF3WBQKRI_cjs.getPreciseType(
         maxLength
-      )}\` - (with value: ${chunkYC7AK3KX_cjs.safeStableStringify(maxLength)})].`
+      )}\` - (with value: ${chunkYC7AK3KX_cjs.safeStableStringify(maxLength, {
+        keepUndefined: true
+      })})].`
     );
   }
   if (minLength < 1 || maxLength > 16 || minLength > maxLength) {
@@ -105,11 +116,13 @@ var randomStr = (options) => {
     throw new TypeError(
       `Parameters \`minLength\` and \`maxLength\` must be of type \`integer-number\`, but received: ['minLength': \`${chunkF3WBQKRI_cjs.getPreciseType(
         minLength
-      )}\` - (with value: ${chunkYC7AK3KX_cjs.safeStableStringify(
-        minLength
-      )}), 'maxLength': \`${chunkF3WBQKRI_cjs.getPreciseType(
+      )}\` - (with value: ${chunkYC7AK3KX_cjs.safeStableStringify(minLength, {
+        keepUndefined: true
+      })}), 'maxLength': \`${chunkF3WBQKRI_cjs.getPreciseType(
         maxLength
-      )}\` - (with value: ${chunkYC7AK3KX_cjs.safeStableStringify(maxLength)})].`
+      )}\` - (with value: ${chunkYC7AK3KX_cjs.safeStableStringify(maxLength, {
+        keepUndefined: true
+      })})].`
     );
   }
   if (minLength < 1 || maxLength > 5e3 || minLength > maxLength) {
@@ -121,7 +134,9 @@ var randomStr = (options) => {
     throw new TypeError(
       `Parameter \`type\` must be of type \`string\` with value one of "string" | "number", but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
         type
-      )}\`, with value: ${chunkYC7AK3KX_cjs.safeStableStringify(type)}.`
+      )}\`, with value: ${chunkYC7AK3KX_cjs.safeStableStringify(type, {
+        keepUndefined: true
+      })}.`
     );
   }
   const length = randomInt(minLength, maxLength);
@@ -151,7 +166,143 @@ var randomStr = (options) => {
   return result;
 };
 
+function randomUUID(options = {}) {
+  if (!chunkF3WBQKRI_cjs.isPlainObject(options)) {
+    throw new TypeError(
+      `First parameter (\`options\`) must be a plain object with optional properties \`version\` and \`monotonic\`, but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
+        options
+      )}\` - (with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(options, { keepUndefined: true })}\`).`
+    );
+  }
+  const { version = "v4", monotonic = false } = options;
+  if (!chunkF3WBQKRI_cjs.isNonEmptyString(version)) {
+    throw new TypeError(
+      `Parameter \`version\` property of the \`options\` (first parameter) must be a \`string\` of either "v4" or "v7", but received type: \`${chunkF3WBQKRI_cjs.getPreciseType(
+        version
+      )}\` - (with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(version, { keepUndefined: true })}\`).`
+    );
+  }
+  if (version !== "v4" && version !== "v7") {
+    throw new RangeError(
+      `Unsupported UUID version. Allowed values are "v4" or "v7". (received: \`${chunkYC7AK3KX_cjs.safeStableStringify(
+        version,
+        {
+          keepUndefined: true
+        }
+      )}\`).`
+    );
+  }
+  if (!chunkF3WBQKRI_cjs.isBoolean(monotonic)) {
+    throw new TypeError(
+      `Parameter \`monotonic\` property of the \`options\` (first parameter) must be a \`boolean\` when provided, but received type: \`${chunkF3WBQKRI_cjs.getPreciseType(
+        monotonic
+      )}\` - (with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(monotonic, {
+        keepUndefined: true
+      })}\`).`
+    );
+  }
+  if (monotonic && version !== "v7") {
+    throw new TypeError(
+      `Parameter \`monotonic\` property of the \`options\` (first parameter) is only supported for version "v7". Received: version=${chunkYC7AK3KX_cjs.safeStableStringify(
+        version,
+        { keepUndefined: true }
+      )}.`
+    );
+  }
+  if (version === "v4") {
+    return generateUUIDv4();
+  }
+  return generateUUIDv7({ monotonic });
+}
+function hasCryptoGetRandomValues() {
+  return typeof crypto !== "undefined" && typeof crypto.getRandomValues === "function";
+}
+function hasCryptoRandomUUID() {
+  return typeof crypto !== "undefined" && typeof crypto.randomUUID === "function";
+}
+function getRandomBytes(len) {
+  if (hasCryptoGetRandomValues()) {
+    return crypto.getRandomValues(new Uint8Array(len));
+  }
+  const arr = new Uint8Array(len);
+  for (let i = 0; i < len; i++) {
+    arr[i] = Math.floor(Math.random() * 256);
+  }
+  return arr;
+}
+var byteToHex = (() => {
+  const arr = [];
+  for (let i = 0; i < 256; ++i) {
+    arr.push((i + 256).toString(16).substring(1));
+  }
+  return arr;
+})();
+function generateUUIDv4() {
+  if (hasCryptoRandomUUID()) {
+    return crypto.randomUUID();
+  }
+  if (hasCryptoGetRandomValues()) {
+    const rnd = crypto.getRandomValues(new Uint8Array(16));
+    rnd[6] = rnd[6] & 15 | 64;
+    rnd[8] = rnd[8] & 63 | 128;
+    return byteToHex[rnd[0]] + byteToHex[rnd[1]] + byteToHex[rnd[2]] + byteToHex[rnd[3]] + "-" + byteToHex[rnd[4]] + byteToHex[rnd[5]] + "-" + byteToHex[rnd[6]] + byteToHex[rnd[7]] + "-" + byteToHex[rnd[8]] + byteToHex[rnd[9]] + "-" + byteToHex[rnd[10]] + byteToHex[rnd[11]] + byteToHex[rnd[12]] + byteToHex[rnd[13]] + byteToHex[rnd[14]] + byteToHex[rnd[15]];
+  }
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    const v = c === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
+var monotonicState = {
+  lastTimestampMs: -1,
+  lastRand: null
+};
+function incrementUint8ArrayBigEndian(arr) {
+  for (let i = arr.length - 1; i >= 0; i--) {
+    if (arr[i] === 255) {
+      arr[i] = 0;
+      continue;
+    }
+    arr[i] = arr[i] + 1 & 255;
+    return false;
+  }
+  return true;
+}
+function generateUUIDv7({ monotonic = false } = {}) {
+  const nowMs = Date.now();
+  const tsHex = BigInt(nowMs).toString(16).padStart(12, "0");
+  let rand = getRandomBytes(10);
+  if (monotonic) {
+    if (monotonicState.lastTimestampMs === nowMs && monotonicState.lastRand) {
+      const copy = new Uint8Array(monotonicState.lastRand);
+      const overflow = incrementUint8ArrayBigEndian(copy);
+      if (overflow) {
+        throw new RangeError(
+          "Monotonic UUID sequence overflow: too many UUIDs generated within the same millisecond."
+        );
+      }
+      rand = copy;
+      monotonicState.lastRand = copy;
+    } else {
+      const fresh = getRandomBytes(10);
+      monotonicState.lastRand = new Uint8Array(fresh);
+      monotonicState.lastTimestampMs = nowMs;
+      rand = fresh;
+    }
+  }
+  rand[0] = rand[0] & 15 | 112;
+  rand[2] = rand[2] & 63 | 128;
+  const randHex = Array.from(rand, (b) => byteToHex[b]).join("");
+  const part1 = tsHex.slice(0, 8);
+  const part2 = tsHex.slice(8, 12);
+  const part3 = randHex.slice(0, 4);
+  const part4 = randHex.slice(4, 8);
+  const part5 = randHex.slice(8, 20);
+  return [part1, part2, part3, part4, part5].join("-");
+}
+
 exports.getRandomItem = getRandomItem;
 exports.randomInt = randomInt;
 exports.randomIntByLength = randomIntByLength;
 exports.randomStr = randomStr;
+exports.randomUUID = randomUUID;

package/dist/{chunk-QUITZ3GP.js → chunk-I3IXLEEG.js}

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
@@ -30,7 +30,9 @@ var formatCurrency = (value, options = {}) => {
     throw new TypeError(
       `First parameter (\`value\`) must be of type \`string\` or \`primitive-number\`, but received: \`${getPreciseType(
         value
-      )}\`, with value: \`${safeStableStringify(value)}\`.`
+      )}\`, with value: \`${safeStableStringify(value, {
+        keepUndefined: true
+      })}\`.`
     );
   }
   assertIsPlainObject(options, {
@@ -70,21 +72,27 @@ var formatCurrency = (value, options = {}) => {
     throw new TypeError(
       `Parameter \`totalDecimal\` property of the \`options\` (second parameter) must be of type \`integer-number\`, but received: \`${getPreciseType(
         totalDecimal
-      )}\`, with value: \`${safeStableStringify(length)}\`.`
+      )}\`, with value: \`${safeStableStringify(length, {
+        keepUndefined: true
+      })}\`.`
     );
   }
   if (!(roundedDecimal === false || roundedDecimal === "round" || roundedDecimal === "ceil" || roundedDecimal === "floor")) {
     throw new TypeError(
       `Parameter \`roundedDecimal\` property of the \`options\` (second parameter) must be of type \`false\` or \`string\` must be one of "round" | "ceil" | "floor", but received: \`${getPreciseType(
         roundedDecimal
-      )}\`, with value: \`${safeStableStringify(roundedDecimal)}\`.`
+      )}\`, with value: \`${safeStableStringify(roundedDecimal, {
+        keepUndefined: true
+      })}\`.`
     );
   }
   if (!(negativeFormat === "abs" || negativeFormat === "brackets" || negativeFormat === "dash" || isPlainObject(negativeFormat))) {
     throw new TypeError(
       `Parameter \`negativeFormat\` property of the \`options\` (second parameter) must be of type \`string\` must be one of "abs" | "brackets" | "dash" or \`plain-object\` type, but received: \`${getPreciseType(
         negativeFormat
-      )}\`, with value: \`${safeStableStringify(negativeFormat)}\`.`
+      )}\`, with value: \`${safeStableStringify(negativeFormat, {
+        keepUndefined: true
+      })}\`.`
     );
   }
   const rawNum = isString(value) ? parseCurrencyString(value) : value;
@@ -162,7 +170,9 @@ var formatCurrency = (value, options = {}) => {
           throw new TypeError(
             `Parameter \`negativeFormat.style\` property of the \`options\` (second parameter) must be of type \`string\` must be of type "abs" | "brackets" | "dash", but received: \`${getPreciseType(
               formatStyleNegative
-            )}\`, with value: \`${safeStableStringify(formatStyleNegative)}\`.`
+            )}\`, with value: \`${safeStableStringify(formatStyleNegative, {
+              keepUndefined: true
+            })}\`.`
           );
         }
         switch (formatStyleNegative) {
@@ -355,7 +365,9 @@ var censorEmail = (email, options = {}) => {
     throw new TypeError(
       `Parameter \`mode\` property of the \`options\` (second parameter) must be one of "fixed" or "random", but received: \`${getPreciseType(
         mode
-      )}\`, with value: \`${safeStableStringify(mode)}\`.`
+      )}\`, with value: \`${safeStableStringify(mode, {
+        keepUndefined: true
+      })}\`.`
     );
   }
   const emailRegex = /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/;
@@ -383,7 +395,9 @@ function chunkString(subject, limiter, options = {}) {
     throw new TypeError(
       `Second parameter (\`limiter\`) must be of type \`integer-number\`, but received: \`${getPreciseType(
         limiter
-      )}\`, with value: \`${safeStableStringify(limiter)}\`.`
+      )}\`, with value: \`${safeStableStringify(limiter, {
+        keepUndefined: true
+      })}\`.`
     );
   }
   assertIsPlainObject(options, {
@@ -451,7 +465,9 @@ var truncateString = (text, options = {}) => {
     throw new TypeError(
       `Parameter \`length\` property of the \`options\` (second parameter) must be of type \`integer-number\`, but received: \`${getPreciseType(
         length2
-      )}\`, with value: \`${safeStableStringify(length2)}\`.`
+      )}\`, with value: \`${safeStableStringify(length2, {
+        keepUndefined: true
+      })}\`.`
     );
   }
   if (length2 < 1) return "";

package/dist/{chunk-VNADVWSJ.js → chunk-JIROTDOU.js}

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
@@ -74,7 +74,9 @@ var delay = (milliSeconds = 1e3, signal) => {
     throw new TypeError(
       `First parameter (\`milliSeconds\`) must be of type \`number\` and value must be a \`non-zero\`, \`non-NaN\`, \`non-negative\`, and \`integer-number\`, but received: \`${getPreciseType(
         milliSeconds
-      )}\`, with value: \`${safeStableStringify(milliSeconds)}\`.`
+      )}\`, with value: \`${safeStableStringify(milliSeconds, {
+        keepUndefined: true
+      })}\`.`
     );
   }
   if (isNull(signal) || signal && !(signal instanceof AbortSignal)) {

package/dist/chunk-JY4HLZ4W.js

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================

package/dist/chunk-K63WO3XA.cjs

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================

package/dist/chunk-KHO2SBNA.cjs

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================

package/dist/chunk-KPCDDYTZ.js

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================

package/dist/{chunk-XFTUHS4Y.js → chunk-KVZ3HL2B.js}

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
@@ -17,11 +17,13 @@ var parseCustomDate = (dateString, format) => {
     throw new TypeError(
       `Parameter \`dateString\` and \`format\` must be of type \`string\` and not empty-string, but received: "['dateString': \`${getPreciseType(
         dateString
-      )}\` - (current value: \`${safeStableStringify(
-        dateString
-      )}\`), 'format': \`${getPreciseType(
+      )}\` - (current value: \`${safeStableStringify(dateString, {
+        keepUndefined: true
+      })}\`), 'format': \`${getPreciseType(
         format
-      )}\` - (current value: \`${safeStableStringify(format)}\`)]".`
+      )}\` - (current value: \`${safeStableStringify(format, {
+        keepUndefined: true
+      })}\`)]".`
     );
   }
   const dateParts = dateString.split(/[-/]/).map(Number);

package/dist/chunk-L5RDAVVH.js

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================

package/dist/chunk-LEX4TQW2.js

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================

package/dist/chunk-LIU4S3JA.cjs

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================

package/dist/{chunk-R3PBF6F7.cjs → chunk-LVFTN6DK.cjs}

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
@@ -14,7 +14,7 @@ var chunkBYUT376O_cjs = require('./chunk-BYUT376O.cjs');
 var chunkAKKM6MOX_cjs = require('./chunk-AKKM6MOX.cjs');
 var chunkUKAUXY2U_cjs = require('./chunk-UKAUXY2U.cjs');
 var chunkDVMHRLKP_cjs = require('./chunk-DVMHRLKP.cjs');
-var chunkBG3AS5BU_cjs = require('./chunk-BG3AS5BU.cjs');
+var chunkSGCN4ED4_cjs = require('./chunk-SGCN4ED4.cjs');
 var chunkNREACG6M_cjs = require('./chunk-NREACG6M.cjs');
 var chunk7WBMA2VE_cjs = require('./chunk-7WBMA2VE.cjs');
 var chunkYC7AK3KX_cjs = require('./chunk-YC7AK3KX.cjs');
@@ -30,7 +30,9 @@ var constructURL = (baseUrl, queryParams, removeParams) => {
     throw new TypeError(
       `First parameter (\`baseUrl\`) must be of type an URL instance or a \`string\` and a non empty-string, but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
         baseUrl
-      )}\`, with current value: \`${chunkYC7AK3KX_cjs.safeStableStringify(baseUrl)}\`.`
+      )}\`, with current value: \`${chunkYC7AK3KX_cjs.safeStableStringify(baseUrl, {
+        keepUndefined: true
+      })}\`.`
     );
   }
   if (!chunkF3WBQKRI_cjs.isUndefined(removeParams)) {
@@ -48,7 +50,9 @@ var constructURL = (baseUrl, queryParams, removeParams) => {
       throw new TypeError(
         `Second parameter (\`queryParams\`) must be iterable (like URLSearchParams.entries() or an array of [[string, string | number]...]), but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
           queryParams
-        )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(queryParams)}\`.`
+        )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(queryParams, {
+          keepUndefined: true
+        })}\`.`
       );
     }
     const urlInstance = new URL(baseUrl);
@@ -61,7 +65,9 @@ var constructURL = (baseUrl, queryParams, removeParams) => {
             throw new TypeError(
               `Second parameter (\`queryParams\`) must be iterable (like URLSearchParams.entries() or an array of [[string, string | number]...]), but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
                 queryParams
-              )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(queryParams)}\`.`
+              )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(queryParams, {
+                keepUndefined: true
+              })}\`.`
             );
           }
           mergedParams.set(key, String(value));
@@ -111,7 +117,9 @@ var getFirstPrefixPathname = (result, defaultValue = "/") => {
     throw new TypeError(
       `Second parameter (\`defaultValue\`) must be of type \`string\` and not an \`empty-string\`, but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
         defaultValue
-      )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(defaultValue)}\`.`
+      )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(defaultValue, {
+        keepUndefined: true
+      })}\`.`
     );
   }
   if (chunkF3WBQKRI_cjs.isArray(result)) {
@@ -119,20 +127,22 @@ var getFirstPrefixPathname = (result, defaultValue = "/") => {
       throw new TypeError(
         `First parameter (\`result\`) must be of type \`string\` or \`array of string\`, but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
           result
-        )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(result)}\`.`
+        )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(result, {
+          keepUndefined: true
+        })}\`.`
       );
     }
     for (const item of result) {
-      const normalized = chunkBG3AS5BU_cjs.normalizePathname(item);
+      const normalized = chunkSGCN4ED4_cjs.normalizePathname(item);
       if (normalized !== "/") {
         return normalized;
       }
     }
-    return chunkBG3AS5BU_cjs.normalizePathname(defaultValue);
+    return chunkSGCN4ED4_cjs.normalizePathname(defaultValue);
   }
   if (chunkF3WBQKRI_cjs.isString(result)) {
-    const normalized = chunkBG3AS5BU_cjs.normalizePathname(result);
-    return normalized !== "/" ? normalized : chunkBG3AS5BU_cjs.normalizePathname(defaultValue);
+    const normalized = chunkSGCN4ED4_cjs.normalizePathname(result);
+    return normalized !== "/" ? normalized : chunkSGCN4ED4_cjs.normalizePathname(defaultValue);
   }
   if (!chunkF3WBQKRI_cjs.isNil(result)) {
     throw new TypeError(
@@ -141,7 +151,7 @@ var getFirstPrefixPathname = (result, defaultValue = "/") => {
       )}\`.`
     );
   }
-  return chunkBG3AS5BU_cjs.normalizePathname(defaultValue);
+  return chunkSGCN4ED4_cjs.normalizePathname(defaultValue);
 };
 
 var getPrefixPathname = (url, base = null, options = {}) => {
@@ -172,7 +182,9 @@ var getPrefixPathname = (url, base = null, options = {}) => {
     errors.push(
       `Parameter \`levels\` property of the \`options\` (second parameter) must be of type \`integer-number\` and minimum is \`0\`, but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
         levels
-      )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(levels)}\`.`
+      )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(levels, {
+        keepUndefined: true
+      })}\`.`
     );
   }
   if (!chunkF3WBQKRI_cjs.isBoolean(removeDuplicates)) {
@@ -189,19 +201,19 @@ var getPrefixPathname = (url, base = null, options = {}) => {
     );
   }
   function getLevel(singleUrl) {
-    const parts = chunkBG3AS5BU_cjs.normalizePathname(singleUrl).split("/").filter(Boolean);
+    const parts = chunkSGCN4ED4_cjs.normalizePathname(singleUrl).split("/").filter(Boolean);
     return `/${parts.slice(0, levels).join("/")}`;
   }
   function processUrl(singleUrl) {
     if (base) {
-      singleUrl = chunkBG3AS5BU_cjs.normalizePathname(singleUrl);
+      singleUrl = chunkSGCN4ED4_cjs.normalizePathname(singleUrl);
       if (chunkF3WBQKRI_cjs.isArray(base)) {
         for (const b of base) {
-          if (singleUrl.startsWith(chunkBG3AS5BU_cjs.normalizePathname(b))) {
+          if (singleUrl.startsWith(chunkSGCN4ED4_cjs.normalizePathname(b))) {
             return getLevel(singleUrl);
           }
         }
-      } else if (chunkF3WBQKRI_cjs.isNonEmptyString(base) && singleUrl.startsWith(chunkBG3AS5BU_cjs.normalizePathname(base))) {
+      } else if (chunkF3WBQKRI_cjs.isNonEmptyString(base) && singleUrl.startsWith(chunkSGCN4ED4_cjs.normalizePathname(base))) {
         return getLevel(singleUrl);
       }
       return null;

package/dist/chunk-NREACG6M.cjs

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================

package/dist/chunk-OFBFGFVH.js

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================

package/dist/chunk-ONZFBJVW.js

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================