@rzl-zone/utils-js 3.5.6 → 3.6.0

package/dist/chunk-VNADVWSJ.js

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

package/dist/chunk-WNO3EPYT.js

@@ -0,0 +1,170 @@
+/*!
+ * ====================================================
+ * Rzl Utils-JS.
+ * ----------------------------------------------------
+ * Version: 3.6.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';
+
+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, isFunction(Error) ? { cause: originalError } : void 0);
+    this.name = "NormalizePathnameError";
+    this.originalError = originalError;
+    if (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
+}) {
+  assertIsPlainObject(options, {
+    message({ currentType, validType }) {
+      return `Second parameter (\`options\`) must be of type \`${validType}\`, but received: \`${currentType}\`.`;
+    }
+  });
+  const { defaultPath = "/", keepNullable = false, keepTrailingSlash = false } = 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)}\`.`
+    );
+  }
+  assertIsBoolean(keepTrailingSlash, {
+    message({ currentType, validType }) {
+      return `Parameter \`keepTrailingSlash\` property of the \`options\` (second parameter)  must be of type \`${validType}\`, but received: \`${currentType}\`.`;
+    }
+  });
+  try {
+    if (keepNullable && (isNil(pathname) || !isString(pathname))) {
+      if (isNull(pathname)) return null;
+      return void 0;
+    }
+    let currentPathName = isNonEmptyString(pathname) ? pathname : defaultPath;
+    currentPathName = removeSpaces(currentPathName, { trimOnly: true }).replace(
+      /\s+/g,
+      ""
+    );
+    currentPathName = stripLeadingDomain(currentPathName);
+    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) {
+    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
+    );
+  }
+}
+function 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;
+    }
+  });
+}
+function stripLeadingDomain(path) {
+  let currentPath = path;
+  if (/^https?:\/\//i.test(currentPath)) {
+    try {
+      const url = new URL(currentPath);
+      currentPath = "/" + url.pathname.replace(/^\/+/, "").replace(/\/{2,}/g, "/") + url.search + url.hash;
+    } catch {
+    }
+  }
+  if (currentPath.startsWith("/")) {
+    currentPath = currentPath.replace(/\/{2,}/g, "/").slice(1);
+  }
+  const firstPart = currentPath.split("/")[0];
+  const domainPart = firstPart.split(":")[0];
+  if (isValidDomain(domainPart, {
+    subdomain: true,
+    allowUnicode: true,
+    wildcard: true,
+    topLevel: false
+  }) || domainPart === "localhost") {
+    currentPath = currentPath.slice(firstPart.length);
+  }
+  if (!currentPath.startsWith("/")) currentPath = "/" + currentPath;
+  return currentPath;
+}
+
+var formatEnvPort = (envVar, options = {}) => {
+  if (!isNonEmptyString(envVar)) return "";
+  assertIsPlainObject(options, {
+    message: ({ currentType, validType }) => `Second parameter (\`options\`) must be of type \`${validType}\`, but received: \`${currentType}\`.`
+  });
+  const prefixColon = hasOwnProp(options, "prefixColon") ? options.prefixColon : false;
+  if (!isBoolean(prefixColon)) {
+    throw new TypeError(
+      `Parameter \`prefixColon\` property of the \`options\` (second parameter) must be of type \`boolean\`, but received: \`${getPreciseType(
+        prefixColon
+      )}\`.`
+    );
+  }
+  const digitsOnly = envVar.replace(/\D+/g, "");
+  if (isEmptyString(digitsOnly)) return "";
+  return prefixColon ? `:${digitsOnly}` : digitsOnly;
+};
+
+export { formatEnvPort, normalizePathname };

package/dist/chunk-WVSPXFTY.js

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

package/dist/chunk-XFTUHS4Y.js

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

package/dist/chunk-YC7AK3KX.cjs

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

package/dist/chunk-YGB2BQPB.cjs

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