@rzl-zone/utils-js 3.8.0 → 3.9.1

package/dist/chunk-OCTHWEZK.cjs

@@ -0,0 +1,249 @@
+/*!
+ * ====================================================
+ * Rzl Utils-JS.
+ * ----------------------------------------------------
+ * Version: 3.9.1.
+ * Author: Rizalvin Dwiky.
+ * Repository: https://github.com/rzl-zone/utils-js.
+ * ====================================================
+ */
+'use strict';
+
+var chunk6AMDHVS2_cjs = require('./chunk-6AMDHVS2.cjs');
+var chunkIX6PF5ZP_cjs = require('./chunk-IX6PF5ZP.cjs');
+var chunkFWWPEL7J_cjs = require('./chunk-FWWPEL7J.cjs');
+var chunkH44QVAZL_cjs = require('./chunk-H44QVAZL.cjs');
+var chunk7C7TQC5J_cjs = require('./chunk-7C7TQC5J.cjs');
+
+var NormalizePathnameError = class _NormalizePathnameError extends Error {
+  /** * ***The original error that triggered this normalization failure.***
+   *
+   * **Always available for backward compatibility.**
+   */
+  originalError;
+  constructor(message, originalError) {
+    super(message, chunk7C7TQC5J_cjs.isFunction(Error) ? { cause: originalError } : void 0);
+    this.name = "NormalizePathnameError";
+    this.originalError = originalError;
+    if (chunk7C7TQC5J_cjs.isFunction(Error.captureStackTrace)) {
+      Error.captureStackTrace(this, _NormalizePathnameError);
+    } else {
+      this.stack = new Error(message).stack;
+    }
+  }
+  /** * ***Safe JSON representation for logging or IPC.*** */
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      stack: this.stack,
+      originalError: {
+        name: this.originalError.name,
+        message: this.originalError.message,
+        stack: this.originalError.stack
+      }
+    };
+  }
+};
+
+function normalizePathname(pathname, options = {
+  defaultPath: "/",
+  keepNullable: false
+}) {
+  chunk7C7TQC5J_cjs.assertIsPlainObject(options, {
+    message({ currentType, validType }) {
+      return `Second parameter (\`options\`) must be of type \`${validType}\`, but received: \`${currentType}\`.`;
+    }
+  });
+  const {
+    defaultPath = "/",
+    keepNullable = false,
+    keepTrailingSlash = false,
+    localhostDomain = false,
+    ignoreDomainExtensions = void 0
+  } = options;
+  if (!chunk7C7TQC5J_cjs.isNonEmptyString(defaultPath)) {
+    throw new TypeError(
+      `Parameter \`defaultPath\` property of the \`options\` (second parameter) must be of type \`string\` and not empty-string, but received: \`${chunk7C7TQC5J_cjs.getPreciseType(
+        defaultPath
+      )}\`, with value: \`${chunkH44QVAZL_cjs.safeStableStringify(defaultPath, {
+        keepUndefined: true
+      })}\`.`
+    );
+  }
+  chunk7C7TQC5J_cjs.assertIsBoolean(keepNullable, {
+    message({ currentType, validType }) {
+      return `Parameter \`keepNullable\` property of the \`options\` (second parameter)  must be of type \`${validType}\`, but received: \`${currentType}\`.`;
+    }
+  });
+  chunk7C7TQC5J_cjs.assertIsBoolean(keepTrailingSlash, {
+    message({ currentType, validType }) {
+      return `Parameter \`keepTrailingSlash\` property of the \`options\` (second parameter)  must be of type \`${validType}\`, but received: \`${currentType}\`.`;
+    }
+  });
+  chunk7C7TQC5J_cjs.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 (!chunk7C7TQC5J_cjs.isUndefined(ignoreDomainExtensions)) {
+    if (!chunk7C7TQC5J_cjs.isSet(ignoreDomainExtensions) && !chunk7C7TQC5J_cjs.isArray(ignoreDomainExtensions)) {
+      throw new TypeError(
+        `Parameter \`ignoreDomainExtensions\` must be of type a \`Set<string>\` or \`string[]\`, but received: \`${chunk7C7TQC5J_cjs.getPreciseType(
+          ignoreDomainExtensions
+        )}\`.`
+      );
+    }
+    ignoreDomainExtsSet = chunk7C7TQC5J_cjs.isSet(ignoreDomainExtensions) ? ignoreDomainExtensions : new Set(ignoreDomainExtensions);
+    let idx = 0;
+    for (const ext of ignoreDomainExtsSet) {
+      if (!chunk7C7TQC5J_cjs.isNonEmptyString(ext)) {
+        throw new TypeError(
+          `Parameter \`ignoreDomainExtensions[${idx}]\` must be a \`string\` and \`non-empty string\`, but received: \`${chunkH44QVAZL_cjs.safeStableStringify(
+            ext,
+            { keepUndefined: true }
+          )}\`.`
+        );
+      }
+      if (!ext.startsWith(".")) {
+        throw new TypeError(
+          `Parameter \`ignoreDomainExtensions[${idx}]\` must start with a dot (.), but received: ${chunkH44QVAZL_cjs.safeStableStringify(
+            ext,
+            { keepUndefined: true }
+          )}`
+        );
+      }
+      idx++;
+    }
+  }
+  try {
+    if (keepNullable && (chunk7C7TQC5J_cjs.isNil(pathname) || !chunk7C7TQC5J_cjs.isString(pathname))) {
+      if (chunk7C7TQC5J_cjs.isNull(pathname)) return null;
+      return void 0;
+    }
+    let currentPathName = chunk7C7TQC5J_cjs.isNonEmptyString(pathname) ? pathname : defaultPath;
+    currentPathName = chunkIX6PF5ZP_cjs.removeSpaces(currentPathName, { trimOnly: true }).replace(
+      /\s+/g,
+      ""
+    );
+    currentPathName = stripLeadingDomain(currentPathName, {
+      keepTrailingSlash,
+      localhostDomain,
+      ignoreDomainExtensions: ignoreDomainExtsSet
+    });
+    let _pathName = currentPathName;
+    let search = "";
+    let hash = "";
+    const searchIndex = currentPathName.indexOf("?");
+    const hashIndex = currentPathName.indexOf("#");
+    if (searchIndex !== -1) {
+      search = currentPathName.slice(
+        searchIndex,
+        hashIndex !== -1 ? hashIndex : void 0
+      );
+    }
+    if (hashIndex !== -1) {
+      hash = currentPathName.slice(hashIndex);
+    }
+    const endIndex = Math.min(
+      searchIndex !== -1 ? searchIndex : currentPathName.length,
+      hashIndex !== -1 ? hashIndex : currentPathName.length
+    );
+    _pathName = currentPathName.slice(0, endIndex);
+    _pathName = "/" + _pathName.replace(/^\/+/, "").replace(/\/{2,}/g, "/");
+    if (!keepTrailingSlash && _pathName !== "/") {
+      _pathName = _pathName.replace(/\/+$/, "");
+    }
+    _pathName = decodeUnicodeSequences(_pathName);
+    search = decodeUnicodeSequences(search);
+    hash = decodeUnicodeSequences(hash);
+    return _pathName + search + hash;
+  } catch (error) {
+    throwError(error);
+  }
+}
+var decodeUnicodeSequences = (str) => {
+  return str.replace(/(?:%(?:[0-9A-F]{2})){2,}/gi, (match) => {
+    try {
+      const decoded = decodeURIComponent(match);
+      if (/^[\u0000-\u007F]+$/.test(decoded)) return match;
+      return decoded;
+    } catch {
+      return match;
+    }
+  });
+};
+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;
+      return ensureLeadingSlash(currentPath);
+    } catch (error) {
+      throwError(error);
+    }
+  }
+  if (currentPath.startsWith("/")) {
+    currentPath = currentPath.replace(/\/{2,}/g, "/").slice(1);
+  }
+  const segments = currentPath.split("/");
+  const firstPart = segments[0];
+  const domainPart = firstPart.split(":")[0];
+  const isDomain = chunk6AMDHVS2_cjs.isValidDomain(domainPart, {
+    subdomain: true,
+    allowUnicode: true,
+    wildcard: true,
+    allowLocalhost: localhostDomain,
+    allowPort: true,
+    allowProtocol: true,
+    topLevel: false
+  });
+  let hasIgnoredExtension = false;
+  if (ignoreDomainExtensions) {
+    for (const ext of ignoreDomainExtensions) {
+      if (firstPart.endsWith(ext)) {
+        hasIgnoredExtension = true;
+        break;
+      }
+    }
+  }
+  if (isDomain && !hasIgnoredExtension) {
+    segments.shift();
+  }
+  return ensureLeadingSlash(segments.join("/"));
+};
+var ensureLeadingSlash = (path) => {
+  if (!path.startsWith("/")) path = "/" + path;
+  return path;
+};
+var throwError = (error) => {
+  const err = chunk7C7TQC5J_cjs.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 (!chunk7C7TQC5J_cjs.isNonEmptyString(envVar)) return "";
+  chunk7C7TQC5J_cjs.assertIsPlainObject(options, {
+    message: ({ currentType, validType }) => `Second parameter (\`options\`) must be of type \`${validType}\`, but received: \`${currentType}\`.`
+  });
+  const prefixColon = chunk7C7TQC5J_cjs.hasOwnProp(options, "prefixColon") ? options.prefixColon : false;
+  if (!chunk7C7TQC5J_cjs.isBoolean(prefixColon)) {
+    throw new TypeError(
+      `Parameter \`prefixColon\` property of the \`options\` (second parameter) must be of type \`boolean\`, but received: \`${chunk7C7TQC5J_cjs.getPreciseType(
+        prefixColon
+      )}\`.`
+    );
+  }
+  const digitsOnly = envVar.replace(/\D+/g, "");
+  if (chunkFWWPEL7J_cjs.isEmptyString(digitsOnly)) return "";
+  return prefixColon ? `:${digitsOnly}` : digitsOnly;
+};
+
+exports.formatEnvPort = formatEnvPort;
+exports.normalizePathname = normalizePathname;

package/dist/chunk-ONZFBJVW.js

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

package/dist/{chunk-FI76UZRF.js → chunk-OSSFLQDD.js}

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

package/dist/{chunk-7WBMA2VE.cjs → chunk-OYFUBKEG.cjs}

@@ -2,23 +2,22 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.8.0.
+ * Version: 3.9.1.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
 'use strict';
 
-var chunkF3WBQKRI_cjs = require('./chunk-F3WBQKRI.cjs');
+var chunk7C7TQC5J_cjs = require('./chunk-7C7TQC5J.cjs');
 
 function assertIsArray(value, options) {
-  if (chunkF3WBQKRI_cjs.isArray(value)) return;
-  const errorMessage = chunkF3WBQKRI_cjs.resolveErrorMessageAssertions({
+  if (chunk7C7TQC5J_cjs.isArray(value)) return;
+  chunk7C7TQC5J_cjs.resolveErrorMessageAssertions({
     value,
     options,
     requiredValidType: "array"
   });
-  throw new TypeError(errorMessage);
 }
 
 exports.assertIsArray = assertIsArray;

package/dist/{chunk-B4SDEBN7.cjs → chunk-PWKOFPAH.cjs}

@@ -2,17 +2,17 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.8.0.
+ * Version: 3.9.1.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
 'use strict';
 
-var chunkF3WBQKRI_cjs = require('./chunk-F3WBQKRI.cjs');
+var chunk7C7TQC5J_cjs = require('./chunk-7C7TQC5J.cjs');
 
 function isFinite(value) {
-  return chunkF3WBQKRI_cjs.isNumber(value) && Number.isFinite(value);
+  return chunk7C7TQC5J_cjs.isNumber(value) && Number.isFinite(value);
 }
 
 exports.isFinite = isFinite;

package/dist/{chunk-RJYWBVGD.cjs → chunk-QGTFQ7RO.cjs}

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.8.0.
+ * Version: 3.9.1.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
@@ -10,8 +10,8 @@
 'use strict';
 
 var chunkDVMHRLKP_cjs = require('./chunk-DVMHRLKP.cjs');
-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 CustomPromise = class extends Promise {
   _value;
@@ -74,14 +74,14 @@ var AbortError = class extends Error {
 var delay = (milliSeconds = 1e3, signal) => {
   if (!chunkDVMHRLKP_cjs.isInteger(milliSeconds) || milliSeconds <= 0) {
     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: \`${chunkF3WBQKRI_cjs.getPreciseType(
+      `First parameter (\`milliSeconds\`) must be of type \`number\` and value must be a \`non-zero\`, \`non-NaN\`, \`non-negative\`, and \`integer-number\`, but received: \`${chunk7C7TQC5J_cjs.getPreciseType(
         milliSeconds
-      )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(milliSeconds, {
+      )}\`, with value: \`${chunkH44QVAZL_cjs.safeStableStringify(milliSeconds, {
         keepUndefined: true
       })}\`.`
     );
   }
-  if (chunkF3WBQKRI_cjs.isNull(signal) || signal && !(signal instanceof AbortSignal)) {
+  if (chunk7C7TQC5J_cjs.isNull(signal) || signal && !(signal instanceof AbortSignal)) {
     throw new TypeError(
       "Second parameter (`signal`) must be an `instance of AbortSignal` if provided."
     );

package/dist/chunk-QNKGP5DY.js

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