@rzl-zone/utils-js 3.7.1 → 3.9.0

package/dist/{chunk-WNO3EPYT.js → chunk-R2DR7SPJ.js}

@@ -2,16 +2,16 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.9.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
-import { isValidDomain } from './chunk-YS27V6LS.js';
-import { removeSpaces } from './chunk-4ACKNPL5.js';
-import { isEmptyString } from './chunk-JY4HLZ4W.js';
-import { safeStableStringify } from './chunk-2VO2CBTU.js';
-import { assertIsPlainObject, isNonEmptyString, getPreciseType, assertIsBoolean, isNil, isString, isNull, isError, hasOwnProp, isBoolean, isFunction } from './chunk-3KTD3QDI.js';
+import { isValidDomain } from './chunk-3LE6NX57.js';
+import { removeSpaces } from './chunk-5KDVIEVO.js';
+import { isEmptyString } from './chunk-5O66AUEC.js';
+import { safeStableStringify } from './chunk-X6ULJZ3X.js';
+import { assertIsPlainObject, isNonEmptyString, getPreciseType, assertIsBoolean, isUndefined, isSet, isArray, isNil, isString, isNull, isError, hasOwnProp, isBoolean, isFunction } from './chunk-J4TT33ZX.js';
 
 var NormalizePathnameError = class _NormalizePathnameError extends Error {
   /** * ***The original error that triggered this normalization failure.***
@@ -53,19 +53,68 @@ function normalizePathname(pathname, options = {
       return `Second parameter (\`options\`) must be of type \`${validType}\`, but received: \`${currentType}\`.`;
     }
   });
-  const { defaultPath = "/", keepNullable = false, keepTrailingSlash = false } = options;
+  const {
+    defaultPath = "/",
+    keepNullable = false,
+    keepTrailingSlash = false,
+    localhostDomain = false,
+    ignoreDomainExtensions = void 0
+  } = options;
   if (!isNonEmptyString(defaultPath)) {
     throw new TypeError(
       `Parameter \`defaultPath\` property of the \`options\` (second parameter) must be of type \`string\` and not empty-string, but received: \`${getPreciseType(
         defaultPath
-      )}\`, with value: \`${safeStableStringify(defaultPath)}\`.`
+      )}\`, with value: \`${safeStableStringify(defaultPath, {
+        keepUndefined: true
+      })}\`.`
     );
   }
+  assertIsBoolean(keepNullable, {
+    message({ currentType, validType }) {
+      return `Parameter \`keepNullable\` property of the \`options\` (second parameter)  must be of type \`${validType}\`, but received: \`${currentType}\`.`;
+    }
+  });
   assertIsBoolean(keepTrailingSlash, {
     message({ currentType, validType }) {
       return `Parameter \`keepTrailingSlash\` property of the \`options\` (second parameter)  must be of type \`${validType}\`, but received: \`${currentType}\`.`;
     }
   });
+  assertIsBoolean(localhostDomain, {
+    message({ currentType, validType }) {
+      return `Parameter \`localhostDomain\` property of the \`options\` (second parameter) must be of type \`${validType}\`, but received: \`${currentType}\`.`;
+    }
+  });
+  let ignoreDomainExtsSet;
+  if (!isUndefined(ignoreDomainExtensions)) {
+    if (!isSet(ignoreDomainExtensions) && !isArray(ignoreDomainExtensions)) {
+      throw new TypeError(
+        `Parameter \`ignoreDomainExtensions\` must be of type a \`Set<string>\` or \`string[]\`, but received: \`${getPreciseType(
+          ignoreDomainExtensions
+        )}\`.`
+      );
+    }
+    ignoreDomainExtsSet = isSet(ignoreDomainExtensions) ? ignoreDomainExtensions : new Set(ignoreDomainExtensions);
+    let idx = 0;
+    for (const ext of ignoreDomainExtsSet) {
+      if (!isNonEmptyString(ext)) {
+        throw new TypeError(
+          `Parameter \`ignoreDomainExtensions[${idx}]\` must be a \`string\` and \`non-empty string\`, but received: \`${safeStableStringify(
+            ext,
+            { keepUndefined: true }
+          )}\`.`
+        );
+      }
+      if (!ext.startsWith(".")) {
+        throw new TypeError(
+          `Parameter \`ignoreDomainExtensions[${idx}]\` must start with a dot (.), but received: ${safeStableStringify(
+            ext,
+            { keepUndefined: true }
+          )}`
+        );
+      }
+      idx++;
+    }
+  }
   try {
     if (keepNullable && (isNil(pathname) || !isString(pathname))) {
       if (isNull(pathname)) return null;
@@ -76,7 +125,11 @@ function normalizePathname(pathname, options = {
       /\s+/g,
       ""
     );
-    currentPathName = stripLeadingDomain(currentPathName);
+    currentPathName = stripLeadingDomain(currentPathName, {
+      keepTrailingSlash,
+      localhostDomain,
+      ignoreDomainExtensions: ignoreDomainExtsSet
+    });
     let _pathName = currentPathName;
     let search = "";
     let hash = "";
@@ -105,14 +158,10 @@ function normalizePathname(pathname, options = {
     hash = decodeUnicodeSequences(hash);
     return _pathName + search + hash;
   } catch (error) {
-    const err = isError(error) ? error : new Error("Unknown error from function `normalizePathname()`.");
-    throw new NormalizePathnameError(
-      `Failed to normalize pathname in function \`normalizePathname()\`: ${err.message}`,
-      err
-    );
+    throwError(error);
   }
 }
-function decodeUnicodeSequences(str) {
+var decodeUnicodeSequences = (str) => {
   return str.replace(/(?:%(?:[0-9A-F]{2})){2,}/gi, (match) => {
     try {
       const decoded = decodeURIComponent(match);
@@ -122,32 +171,59 @@ function decodeUnicodeSequences(str) {
       return match;
     }
   });
-}
-function stripLeadingDomain(path) {
+};
+var stripLeadingDomain = (path, options) => {
   let currentPath = path;
+  const { ignoreDomainExtensions, localhostDomain } = options;
   if (/^https?:\/\//i.test(currentPath)) {
     try {
       const url = new URL(currentPath);
-      currentPath = "/" + url.pathname.replace(/^\/+/, "").replace(/\/{2,}/g, "/") + url.search + url.hash;
-    } catch {
+      currentPath = url.pathname.replace(/^\/+/, "").replace(/\/{2,}/g, "/") + url.search + url.hash;
+      return ensureLeadingSlash(currentPath);
+    } catch (error) {
+      throwError(error);
     }
   }
   if (currentPath.startsWith("/")) {
     currentPath = currentPath.replace(/\/{2,}/g, "/").slice(1);
   }
-  const firstPart = currentPath.split("/")[0];
+  const segments = currentPath.split("/");
+  const firstPart = segments[0];
   const domainPart = firstPart.split(":")[0];
-  if (isValidDomain(domainPart, {
+  const isDomain = isValidDomain(domainPart, {
     subdomain: true,
     allowUnicode: true,
     wildcard: true,
+    allowLocalhost: localhostDomain,
+    allowPort: true,
+    allowProtocol: true,
     topLevel: false
-  }) || domainPart === "localhost") {
-    currentPath = currentPath.slice(firstPart.length);
+  });
+  let hasIgnoredExtension = false;
+  if (ignoreDomainExtensions) {
+    for (const ext of ignoreDomainExtensions) {
+      if (firstPart.endsWith(ext)) {
+        hasIgnoredExtension = true;
+        break;
+      }
+    }
   }
-  if (!currentPath.startsWith("/")) currentPath = "/" + currentPath;
-  return currentPath;
-}
+  if (isDomain && !hasIgnoredExtension) {
+    segments.shift();
+  }
+  return ensureLeadingSlash(segments.join("/"));
+};
+var ensureLeadingSlash = (path) => {
+  if (!path.startsWith("/")) path = "/" + path;
+  return path;
+};
+var throwError = (error) => {
+  const err = isError(error) ? error : new Error("Unknown error from function `normalizePathname()`.");
+  throw new NormalizePathnameError(
+    `Failed to normalize pathname in function \`normalizePathname()\`: ${err.message}`,
+    err
+  );
+};
 
 var formatEnvPort = (envVar, options = {}) => {
   if (!isNonEmptyString(envVar)) return "";

package/dist/{chunk-TDYGYHSH.js → chunk-SN5HAK3Y.js}

@@ -2,15 +2,15 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.9.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
-import { isFinite } from './chunk-7ZNEUWYP.js';
-import { isEmptyArray } from './chunk-VCVND6CH.js';
+import { isFinite } from './chunk-MZ3T6L7Z.js';
+import { isEmptyArray } from './chunk-M5QB2GM5.js';
 import { isBigInt } from './chunk-QNKGP5DY.js';
-import { isNil, isArray, assertIsPlainObject, hasOwnProp, assertIsBoolean, isString, isBoolean, isNull } from './chunk-3KTD3QDI.js';
+import { isNil, isArray, assertIsPlainObject, hasOwnProp, assertIsBoolean, isString, isBoolean, isNull } from './chunk-J4TT33ZX.js';
 
 function filterNilArray(input) {
   if (isNil(input)) return void 0;

package/dist/{chunk-D53CE4BT.js → chunk-SRWL4YCP.js}

@@ -2,17 +2,17 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.9.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
-import { safeJsonParse } from './chunk-XFTUHS4Y.js';
-import { isEqual } from './chunk-SZJ7OI4S.js';
-import { isEmptyArray } from './chunk-VCVND6CH.js';
-import { assertIsArray } from './chunk-6WMB5AJR.js';
-import { safeStableStringify } from './chunk-2VO2CBTU.js';
-import { isPlainObject, isNonEmptyArray, isObjectOrArray, isArray, isNaN, isUndefined } from './chunk-3KTD3QDI.js';
+import { safeJsonParse } from './chunk-DXPM4NOU.js';
+import { isEqual } from './chunk-J6VLFVIL.js';
+import { isEmptyArray } from './chunk-M5QB2GM5.js';
+import { assertIsArray } from './chunk-TXOVQZPU.js';
+import { safeStableStringify } from './chunk-X6ULJZ3X.js';
+import { isPlainObject, isNonEmptyArray, isObjectOrArray, isArray, isNaN, isUndefined } from './chunk-J4TT33ZX.js';
 
 var findDuplicates = (values) => {
   assertIsArray(values, {
@@ -57,7 +57,10 @@ var omitKeysDeep = (object, keysToOmit) => {
   if (isNonEmptyArray(duplicates)) {
     throw new Error(
       `Function "omitKeysDeep" Error: Duplicate keys detected - \`${safeStableStringify(
-        duplicates
+        duplicates,
+        {
+          keepUndefined: true
+        }
       )}\`.`
     );
   }

package/dist/{chunk-7QQV66RX.cjs → chunk-TJ5OY6MC.cjs}

@@ -2,15 +2,15 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.9.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
 'use strict';
 
-var chunkYC7AK3KX_cjs = require('./chunk-YC7AK3KX.cjs');
-var chunkF3WBQKRI_cjs = require('./chunk-F3WBQKRI.cjs');
+var chunkH44QVAZL_cjs = require('./chunk-H44QVAZL.cjs');
+var chunk7C7TQC5J_cjs = require('./chunk-7C7TQC5J.cjs');
 
 var isRegExp = (value) => {
   return value instanceof RegExp;
@@ -23,7 +23,7 @@ function isArrayBuffer(value) {
 function baseDeepEqual(value, other, customizer, seen = /* @__PURE__ */ new WeakMap()) {
   if (value === other) return true;
   if (value !== value && other !== other) return true;
-  if (!chunkF3WBQKRI_cjs.isObjectOrArray(value) || !chunkF3WBQKRI_cjs.isObjectOrArray(other)) {
+  if (!chunk7C7TQC5J_cjs.isObjectOrArray(value) || !chunk7C7TQC5J_cjs.isObjectOrArray(other)) {
     return false;
   }
   if (seen.get(value) === other) return true;
@@ -31,14 +31,14 @@ function baseDeepEqual(value, other, customizer, seen = /* @__PURE__ */ new Weak
   const callCustomizer = (v, o, key, valObj, othObj) => {
     if (customizer) {
       const result = customizer(v, o, key, valObj, othObj, seen);
-      if (!chunkF3WBQKRI_cjs.isUndefined(result)) return result;
+      if (!chunk7C7TQC5J_cjs.isUndefined(result)) return result;
     }
     return baseDeepEqual(v, o, customizer, seen);
   };
-  if (chunkYC7AK3KX_cjs.isDate(value) && chunkYC7AK3KX_cjs.isDate(other)) return value.getTime() === other.getTime();
+  if (chunkH44QVAZL_cjs.isDate(value) && chunkH44QVAZL_cjs.isDate(other)) return value.getTime() === other.getTime();
   if (isRegExp(value) && isRegExp(other))
     return value.source === other.source && value.flags === other.flags;
-  if (chunkF3WBQKRI_cjs.isError(value) && chunkF3WBQKRI_cjs.isError(other))
+  if (chunk7C7TQC5J_cjs.isError(value) && chunk7C7TQC5J_cjs.isError(other))
     return value.name === other.name && value.message === other.message;
   if (ArrayBuffer.isView(value) && ArrayBuffer.isView(other)) {
     const v = new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
@@ -53,7 +53,7 @@ function baseDeepEqual(value, other, customizer, seen = /* @__PURE__ */ new Weak
     for (let i = 0; i < v.length; i++) if (v[i] !== o[i]) return false;
     return true;
   }
-  if (chunkYC7AK3KX_cjs.isMap(value) && chunkYC7AK3KX_cjs.isMap(other)) {
+  if (chunkH44QVAZL_cjs.isMap(value) && chunkH44QVAZL_cjs.isMap(other)) {
     if (value.size !== other.size) return false;
     for (const [k, v] of value) {
       if (!other.has(k)) return false;
@@ -61,7 +61,7 @@ function baseDeepEqual(value, other, customizer, seen = /* @__PURE__ */ new Weak
     }
     return true;
   }
-  if (chunkF3WBQKRI_cjs.isSet(value) && chunkF3WBQKRI_cjs.isSet(other)) {
+  if (chunk7C7TQC5J_cjs.isSet(value) && chunk7C7TQC5J_cjs.isSet(other)) {
     if (value.size !== other.size) return false;
     for (const v of value) {
       let matched = false;
@@ -75,7 +75,7 @@ function baseDeepEqual(value, other, customizer, seen = /* @__PURE__ */ new Weak
     }
     return true;
   }
-  if (chunkF3WBQKRI_cjs.isArray(value) && chunkF3WBQKRI_cjs.isArray(other)) {
+  if (chunk7C7TQC5J_cjs.isArray(value) && chunk7C7TQC5J_cjs.isArray(other)) {
     if (value.length !== other.length) return false;
     for (let i = 0; i < value.length; i++) {
       if (!callCustomizer(value[i], other[i], i, value, other)) return false;

package/dist/{chunk-6WMB5AJR.js → chunk-TXOVQZPU.js}

@@ -2,21 +2,20 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.9.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
-import { isArray, resolveErrorMessageAssertions } from './chunk-3KTD3QDI.js';
+import { isArray, resolveErrorMessageAssertions } from './chunk-J4TT33ZX.js';
 
 function assertIsArray(value, options) {
   if (isArray(value)) return;
-  const errorMessage = resolveErrorMessageAssertions({
+  resolveErrorMessageAssertions({
     value,
     options,
     requiredValidType: "array"
   });
-  throw new TypeError(errorMessage);
 }
 
 export { assertIsArray };

package/dist/chunk-UDA26MCU.cjs

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

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

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.9.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
@@ -10,64 +10,70 @@
 'use strict';
 
 var chunkKHO2SBNA_cjs = require('./chunk-KHO2SBNA.cjs');
-var chunkBYUT376O_cjs = require('./chunk-BYUT376O.cjs');
-var chunkAKKM6MOX_cjs = require('./chunk-AKKM6MOX.cjs');
-var chunkUKAUXY2U_cjs = require('./chunk-UKAUXY2U.cjs');
+var chunk76ATVDCR_cjs = require('./chunk-76ATVDCR.cjs');
+var chunkI33PB44Q_cjs = require('./chunk-I33PB44Q.cjs');
+var chunkMMRHKYT6_cjs = require('./chunk-MMRHKYT6.cjs');
 var chunkDVMHRLKP_cjs = require('./chunk-DVMHRLKP.cjs');
-var chunkBG3AS5BU_cjs = require('./chunk-BG3AS5BU.cjs');
-var chunkNREACG6M_cjs = require('./chunk-NREACG6M.cjs');
-var chunk7WBMA2VE_cjs = require('./chunk-7WBMA2VE.cjs');
-var chunkYC7AK3KX_cjs = require('./chunk-YC7AK3KX.cjs');
-var chunkF3WBQKRI_cjs = require('./chunk-F3WBQKRI.cjs');
+var chunkOCTHWEZK_cjs = require('./chunk-OCTHWEZK.cjs');
+var chunkFWWPEL7J_cjs = require('./chunk-FWWPEL7J.cjs');
+var chunkOYFUBKEG_cjs = require('./chunk-OYFUBKEG.cjs');
+var chunkH44QVAZL_cjs = require('./chunk-H44QVAZL.cjs');
+var chunk7C7TQC5J_cjs = require('./chunk-7C7TQC5J.cjs');
 
 var constructURL = (baseUrl, queryParams, removeParams) => {
-  if (chunkF3WBQKRI_cjs.isString(baseUrl)) {
-    if (chunkNREACG6M_cjs.isEmptyString(baseUrl)) {
+  if (chunk7C7TQC5J_cjs.isString(baseUrl)) {
+    if (chunkFWWPEL7J_cjs.isEmptyString(baseUrl)) {
       throw new TypeError(`First parameter (\`baseUrl\`) cannot be an empty-string.`);
     }
-    baseUrl = chunkBYUT376O_cjs.normalizeString(baseUrl);
+    baseUrl = chunk76ATVDCR_cjs.normalizeString(baseUrl);
   } else if (!chunkKHO2SBNA_cjs.isURL(baseUrl)) {
     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(
+      `First parameter (\`baseUrl\`) must be of type an URL instance or a \`string\` and a non empty-string, but received: \`${chunk7C7TQC5J_cjs.getPreciseType(
         baseUrl
-      )}\`, with current value: \`${chunkYC7AK3KX_cjs.safeStableStringify(baseUrl)}\`.`
+      )}\`, with current value: \`${chunkH44QVAZL_cjs.safeStableStringify(baseUrl, {
+        keepUndefined: true
+      })}\`.`
     );
   }
-  if (!chunkF3WBQKRI_cjs.isUndefined(removeParams)) {
-    chunk7WBMA2VE_cjs.assertIsArray(removeParams, {
+  if (!chunk7C7TQC5J_cjs.isUndefined(removeParams)) {
+    chunkOYFUBKEG_cjs.assertIsArray(removeParams, {
       message: ({ currentType, validType }) => `Third parameter (\`removeParams\`) must be of type \`${validType} of strings\`, but received: \`${currentType}\`.`
     });
-    if (!removeParams.every((param) => chunkF3WBQKRI_cjs.isNonEmptyString(param))) {
+    if (!removeParams.every((param) => chunk7C7TQC5J_cjs.isNonEmptyString(param))) {
       throw new TypeError(
         `Third parameter (\`removeParams\`) must be of type \`array\` and contains \`string\` only and non empty-string.`
       );
     }
   }
   try {
-    if (!chunkF3WBQKRI_cjs.isUndefined(queryParams) && !chunkF3WBQKRI_cjs.isFunction(queryParams[Symbol.iterator])) {
+    if (!chunk7C7TQC5J_cjs.isUndefined(queryParams) && !chunk7C7TQC5J_cjs.isFunction(queryParams[Symbol.iterator])) {
       throw new TypeError(
-        `Second parameter (\`queryParams\`) must be iterable (like URLSearchParams.entries() or an array of [[string, string | number]...]), but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
+        `Second parameter (\`queryParams\`) must be iterable (like URLSearchParams.entries() or an array of [[string, string | number]...]), but received: \`${chunk7C7TQC5J_cjs.getPreciseType(
           queryParams
-        )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(queryParams)}\`.`
+        )}\`, with value: \`${chunkH44QVAZL_cjs.safeStableStringify(queryParams, {
+          keepUndefined: true
+        })}\`.`
       );
     }
     const urlInstance = new URL(baseUrl);
-    if (!chunkF3WBQKRI_cjs.isUndefined(queryParams)) {
+    if (!chunk7C7TQC5J_cjs.isUndefined(queryParams)) {
       const paramObject = Object.fromEntries(queryParams);
-      if (!chunkUKAUXY2U_cjs.isEmptyValue(paramObject)) {
+      if (!chunkMMRHKYT6_cjs.isEmptyValue(paramObject)) {
         const mergedParams = new URLSearchParams(urlInstance.search);
         for (const [key, value] of Object.entries(paramObject)) {
-          if (!chunkF3WBQKRI_cjs.isNonEmptyString(value) && !chunkF3WBQKRI_cjs.isNumber(value, { includeNaN: true })) {
+          if (!chunk7C7TQC5J_cjs.isNonEmptyString(value) && !chunk7C7TQC5J_cjs.isNumber(value, { includeNaN: true })) {
             throw new TypeError(
-              `Second parameter (\`queryParams\`) must be iterable (like URLSearchParams.entries() or an array of [[string, string | number]...]), but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
+              `Second parameter (\`queryParams\`) must be iterable (like URLSearchParams.entries() or an array of [[string, string | number]...]), but received: \`${chunk7C7TQC5J_cjs.getPreciseType(
                 queryParams
-              )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(queryParams)}\`.`
+              )}\`, with value: \`${chunkH44QVAZL_cjs.safeStableStringify(queryParams, {
+                keepUndefined: true
+              })}\`.`
             );
           }
           mergedParams.set(key, String(value));
         }
         if (removeParams?.length) {
-          chunkAKKM6MOX_cjs.toStringArrayUnRecursive(removeParams).map((paramKey) => {
+          chunkI33PB44Q_cjs.toStringArrayUnRecursive(removeParams).map((paramKey) => {
             mergedParams.delete(paramKey);
           });
         }
@@ -77,7 +83,7 @@ var constructURL = (baseUrl, queryParams, removeParams) => {
     removeParams?.forEach((param) => urlInstance.searchParams.delete(param));
     return urlInstance;
   } catch (error) {
-    if (chunkF3WBQKRI_cjs.isError(error)) throw error;
+    if (chunk7C7TQC5J_cjs.isError(error)) throw error;
     throw new Error(
       "Failed to construct a valid URL in `constructURL()`, Error:" + error
     );
@@ -85,7 +91,7 @@ var constructURL = (baseUrl, queryParams, removeParams) => {
 };
 
 var extractURLs = (url) => {
-  if (!chunkF3WBQKRI_cjs.isNonEmptyString(url)) return null;
+  if (!chunk7C7TQC5J_cjs.isNonEmptyString(url)) return null;
   let decoded;
   try {
     decoded = decodeURIComponent(url);
@@ -107,62 +113,66 @@ var extractURLs = (url) => {
 };
 
 var getFirstPrefixPathname = (result, defaultValue = "/") => {
-  if (!chunkF3WBQKRI_cjs.isNonEmptyString(defaultValue)) {
+  if (!chunk7C7TQC5J_cjs.isNonEmptyString(defaultValue)) {
     throw new TypeError(
-      `Second parameter (\`defaultValue\`) must be of type \`string\` and not an \`empty-string\`, but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
+      `Second parameter (\`defaultValue\`) must be of type \`string\` and not an \`empty-string\`, but received: \`${chunk7C7TQC5J_cjs.getPreciseType(
         defaultValue
-      )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(defaultValue)}\`.`
+      )}\`, with value: \`${chunkH44QVAZL_cjs.safeStableStringify(defaultValue, {
+        keepUndefined: true
+      })}\`.`
     );
   }
-  if (chunkF3WBQKRI_cjs.isArray(result)) {
-    if (!result.every((item) => chunkF3WBQKRI_cjs.isString(item))) {
+  if (chunk7C7TQC5J_cjs.isArray(result)) {
+    if (!result.every((item) => chunk7C7TQC5J_cjs.isString(item))) {
       throw new TypeError(
-        `First parameter (\`result\`) must be of type \`string\` or \`array of string\`, but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
+        `First parameter (\`result\`) must be of type \`string\` or \`array of string\`, but received: \`${chunk7C7TQC5J_cjs.getPreciseType(
           result
-        )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(result)}\`.`
+        )}\`, with value: \`${chunkH44QVAZL_cjs.safeStableStringify(result, {
+          keepUndefined: true
+        })}\`.`
       );
     }
     for (const item of result) {
-      const normalized = chunkBG3AS5BU_cjs.normalizePathname(item);
+      const normalized = chunkOCTHWEZK_cjs.normalizePathname(item);
       if (normalized !== "/") {
         return normalized;
       }
     }
-    return chunkBG3AS5BU_cjs.normalizePathname(defaultValue);
+    return chunkOCTHWEZK_cjs.normalizePathname(defaultValue);
   }
-  if (chunkF3WBQKRI_cjs.isString(result)) {
-    const normalized = chunkBG3AS5BU_cjs.normalizePathname(result);
-    return normalized !== "/" ? normalized : chunkBG3AS5BU_cjs.normalizePathname(defaultValue);
+  if (chunk7C7TQC5J_cjs.isString(result)) {
+    const normalized = chunkOCTHWEZK_cjs.normalizePathname(result);
+    return normalized !== "/" ? normalized : chunkOCTHWEZK_cjs.normalizePathname(defaultValue);
   }
-  if (!chunkF3WBQKRI_cjs.isNil(result)) {
+  if (!chunk7C7TQC5J_cjs.isNil(result)) {
     throw new TypeError(
-      `First parameter (\`result\`) must be of type \`string\`, \`array-string\`, \`null\` or \`undefined\`, but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
+      `First parameter (\`result\`) must be of type \`string\`, \`array-string\`, \`null\` or \`undefined\`, but received: \`${chunk7C7TQC5J_cjs.getPreciseType(
         result
       )}\`.`
     );
   }
-  return chunkBG3AS5BU_cjs.normalizePathname(defaultValue);
+  return chunkOCTHWEZK_cjs.normalizePathname(defaultValue);
 };
 
 var getPrefixPathname = (url, base = null, options = {}) => {
   const errors = [];
-  if (!chunkF3WBQKRI_cjs.isString(url) && !chunkF3WBQKRI_cjs.isArray(url)) {
+  if (!chunk7C7TQC5J_cjs.isString(url) && !chunk7C7TQC5J_cjs.isArray(url)) {
     errors.push(
-      `First parameter (\`url\`) must be of type \`string\` or \`array-string\`, but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
+      `First parameter (\`url\`) must be of type \`string\` or \`array-string\`, but received: \`${chunk7C7TQC5J_cjs.getPreciseType(
         url
       )}\`.`
     );
   }
-  if (!chunkF3WBQKRI_cjs.isString(base) && !chunkF3WBQKRI_cjs.isArray(base) && !chunkF3WBQKRI_cjs.isNull(base)) {
+  if (!chunk7C7TQC5J_cjs.isString(base) && !chunk7C7TQC5J_cjs.isArray(base) && !chunk7C7TQC5J_cjs.isNull(base)) {
     errors.push(
-      `Second parameter (\`base\`) must be of type \`string\`, \`array-string\` or \`null\`, but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
+      `Second parameter (\`base\`) must be of type \`string\`, \`array-string\` or \`null\`, but received: \`${chunk7C7TQC5J_cjs.getPreciseType(
         base
       )}\`.`
     );
   }
-  if (!chunkF3WBQKRI_cjs.isPlainObject(options)) {
+  if (!chunk7C7TQC5J_cjs.isPlainObject(options)) {
     errors.push(
-      `Second parameter (\`options\`) must be of type \`plain-object\`, but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
+      `Second parameter (\`options\`) must be of type \`plain-object\`, but received: \`${chunk7C7TQC5J_cjs.getPreciseType(
         options
       )}\`.`
     );
@@ -170,46 +180,48 @@ var getPrefixPathname = (url, base = null, options = {}) => {
   const { levels = 1, removeDuplicates = true } = options;
   if (!chunkDVMHRLKP_cjs.isInteger(levels) || chunkDVMHRLKP_cjs.isInteger(levels) && levels < 0) {
     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(
+      `Parameter \`levels\` property of the \`options\` (second parameter) must be of type \`integer-number\` and minimum is \`0\`, but received: \`${chunk7C7TQC5J_cjs.getPreciseType(
         levels
-      )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(levels)}\`.`
+      )}\`, with value: \`${chunkH44QVAZL_cjs.safeStableStringify(levels, {
+        keepUndefined: true
+      })}\`.`
     );
   }
-  if (!chunkF3WBQKRI_cjs.isBoolean(removeDuplicates)) {
+  if (!chunk7C7TQC5J_cjs.isBoolean(removeDuplicates)) {
     errors.push(
-      `Parameter \`removeDuplicates\` property of the \`options\` (second parameter) must be of type \`boolean\`, but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
+      `Parameter \`removeDuplicates\` property of the \`options\` (second parameter) must be of type \`boolean\`, but received: \`${chunk7C7TQC5J_cjs.getPreciseType(
         removeDuplicates
       )}\`.`
     );
   }
-  if (chunkF3WBQKRI_cjs.isNonEmptyArray(errors)) {
+  if (chunk7C7TQC5J_cjs.isNonEmptyArray(errors)) {
     throw new TypeError(
       `Invalid parameter(s) in \`getPrefixPathname\` function:
 - ${errors.join("\n- ")}`
     );
   }
   function getLevel(singleUrl) {
-    const parts = chunkBG3AS5BU_cjs.normalizePathname(singleUrl).split("/").filter(Boolean);
+    const parts = chunkOCTHWEZK_cjs.normalizePathname(singleUrl).split("/").filter(Boolean);
     return `/${parts.slice(0, levels).join("/")}`;
   }
   function processUrl(singleUrl) {
     if (base) {
-      singleUrl = chunkBG3AS5BU_cjs.normalizePathname(singleUrl);
-      if (chunkF3WBQKRI_cjs.isArray(base)) {
+      singleUrl = chunkOCTHWEZK_cjs.normalizePathname(singleUrl);
+      if (chunk7C7TQC5J_cjs.isArray(base)) {
         for (const b of base) {
-          if (singleUrl.startsWith(chunkBG3AS5BU_cjs.normalizePathname(b))) {
+          if (singleUrl.startsWith(chunkOCTHWEZK_cjs.normalizePathname(b))) {
             return getLevel(singleUrl);
           }
         }
-      } else if (chunkF3WBQKRI_cjs.isNonEmptyString(base) && singleUrl.startsWith(chunkBG3AS5BU_cjs.normalizePathname(base))) {
+      } else if (chunk7C7TQC5J_cjs.isNonEmptyString(base) && singleUrl.startsWith(chunkOCTHWEZK_cjs.normalizePathname(base))) {
         return getLevel(singleUrl);
       }
       return null;
     }
     return getLevel(singleUrl);
   }
-  if (chunkF3WBQKRI_cjs.isArray(url)) {
-    const result = url.map(processUrl).filter((r) => !chunkF3WBQKRI_cjs.isNull(r));
+  if (chunk7C7TQC5J_cjs.isArray(url)) {
+    const result = url.map(processUrl).filter((r) => !chunk7C7TQC5J_cjs.isNull(r));
     const uniqueResult = removeDuplicates ? [...new Set(result)] : result;
     if (uniqueResult.length === 1) {
       return uniqueResult[0];