@rzl-zone/utils-js 3.5.7 → 3.7.0

package/dist/urls/index.d.ts

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.5.7.
+ * Version: 3.7.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
@@ -347,39 +347,192 @@ removeDuplicates?:boolean;};
  * ```
  */
 declare const getPrefixPathname:(url:string|string[],base?:string|string[]|null,options?:GetPrefixPathnameOptions)=>string|string[]|null;
+/** Options when `keepNullable` is false (default).
+ *
+ * Returns `defaultPath` if `pathname` is empty or invalid.
+ */
+type UnKeepNullableOptions={
+/** * ***Fallback value returned if `pathname` is empty-string or invalid.***
+ *
+ * Must be a **`non-empty string`**, defaultValue: `"/"`.
+ *
+ * @defaultValue `"/"`.
+ */
+defaultPath?:string;
+/** * ***Whether to preserve `null` or `undefined`, defaultValue: `false`.***
+ *
+ * @defaultValue `false`.
+ */
+keepNullable?:false;};
+/** Options when `keepNullable` is true.
+ *
+ * Preserves `null` or `undefined` instead of returning `defaultPath`.
+ */
+type KeepNullableOptions={
+/** * ***Fallback path is ignored when `keepNullable` is true **(except if
+ * `pathname` is empty-string or invalid, even this `true`)**,
+ * defaultValue: `"/"`.***
+ *
+ * @defaultValue `"/"`.
+ */
+defaultPath?:string;
+/** * ***Preserve `null` or `undefined` as-is if `true` (defaultValue: `false`).***
+ *
+ * - ***⚠️ Notes:***
+ *      - Keep returning `defaultPath` if `pathname` is empty-string, even this `true`.
+ *
+ * **Must be `true` in this type.**
+ */
+keepNullable?:true;};type MainNormalizePathnameOptions={
+/** * ***Preserve trailing slash at the end of the normalized pathname, defaultValue: `false`.***
+ *
+ * @defaultValue `false`
+ */
+keepTrailingSlash?:boolean;};type NormalizePathnameOptionsKeepNullableTrue=MainNormalizePathnameOptions & KeepNullableOptions;type NormalizePathnameOptionsKeepNullableFalse=MainNormalizePathnameOptions & UnKeepNullableOptions;type ResUnKeepNullable<T>=T extends undefined?string:T extends null?string:T extends null|undefined?string:string;type ResKeepNullable<T>=T extends string?string:T extends undefined?undefined:T extends null?null:T extends null|undefined?null|undefined:string|null|undefined;
 /** --------------------------------------------------------
  * * ***Utility: `normalizePathname`.***
  * --------------------------------------------------------
- * **This function processes and normalizes a given pathname.**
- * - **Behavior:**
- *    - If `pathname` is `null`, `undefined`, empty, or only whitespace, the `defaultPath` will be returned instead.
- *    - If `pathname` is a full URL (starting with `http://` or `https://`), it extracts and returns the pathname along
- *      with any search parameters and hash.
- *      - Example: `"https://site.com/foo/bar?x=1#sec"` becomes `"/foo/bar?x=1#sec"`.
- *    - All spaces inside the pathname are removed.
- *    - Multiple consecutive slashes (like `"//"` or `"///"`) are collapsed into a single slash `"/"`.
- *    - Ensures the returned string always starts with exactly one `/`.
- * @param {string | null | undefined} pathname - The pathname to normalize.
- * @param {string} [defaultPath="/"] - A fallback value returned if `pathname` is empty or invalid, must be a string and non-empty string, default `"/"`.
- * @returns {string} A properly normalized pathname starting with a single `/`,
- * or the `defaultPath` if the input is invalid or empty.
- * @throws {TypeError} If `defaultPath` is not a string or empty-string.
- * @throws {NormalizePathnameError} If an unexpected error occurs during normalization (e.g., URL parsing failure).
+ * - **Description:**
+ *    - Normalizes a given pathname string for consistent routing, URL handling, and string hygiene.
+ *    - It trims whitespace, collapses redundant slashes, handles full URLs, query strings, hash fragments,
+ *    - Unicode characters, emojis, and optionally preserves `null` or `undefined`.
+ *    - Trailing slash behavior can be controlled via `keepTrailingSlash`.
+ *
+ * - **Behavior Details:**
+ *    - Trims leading and trailing whitespace.
+ *    - Removes all internal spaces.
+ *    - Collapses multiple consecutive slashes into a single `/`.
+ *    - Prepends a leading slash if missing.
+ *    - Preserves trailing slash only if `keepTrailingSlash` is `true`.
+ *    - Supports full URLs (`http://` or `https://`) and relative paths only also detect valid domain and
+ *      subdomain (with support handle wildcard eg: *.example.com) (with optional with port) eg (localhost, localhost:3000, example.com, sub.domain.com, *.domain.test, etc).
+ *    - Preserves query strings (`?key=value`) and hash fragments (`#anchor`) intact.
+ *    - Handles emojis and Unicode safely.
+ *    - Returns `string`, `null` or `undefined` as-is if `keepNullable` is true.
+ *    - Returns `undefined` if pathname is not a string and `keepNullable` is `true`.
+ *    - Returns `defaultPath` if pathname is empty-string even when `keepNullable` is true.
+ *    - Returns `defaultPath` if pathname is empty/invalid and `keepNullable` is `false`.
+ *
+ * - **Options (`options`)**:
+ *    - `defaultPath` (***`string`***, default: **`"/"`**)
+ *       - Fallback path if the input is invalid (**empty-string**, **null**, **undefined**) and
+ *          `keepNullable` is **false**, if `keepNullable` is true, used only when pathname is empty-string.
+ *    - `keepNullable` (***`boolean`***, default: **`false`**)
+ *       - If **true**, preserves `null` or `undefined` as-is instead of returning
+ *         `defaultPath` (except if `pathname` is **empty-string**).
+ *    - `keepTrailingSlash` (***`boolean`***, default: **`false`**)
+ *      - If **true**, preserves a trailing slash at the end of the normalized pathname.
+ *
+ * @param {string | null | undefined} pathname - ***The pathname to normalize.***
+ * @param {NormalizePathnameOptions} [options] - ***Configuration options.***
+ *
+ * @returns {string | null | undefined} ***Normalized pathname, or original nullable value if `keepNullable` is `true`
+ * _(except if `pathname` is empty-string, will keep returning `defaultPath`)_.***
+ *
+ * @throws {TypeError} If `defaultPath` is invalid when `keepNullable` is false.
+ * @throws {NormalizePathnameError} If normalization fails (e.g., invalid URL).
+ *
  * @example
+ * // Basic normalization
  * normalizePathname("   /foo//bar  ");
  * // ➔ "/foo/bar"
+ *
+ * // Full URL with query and hash
  * normalizePathname("https://example.com//path///to/resource?x=1#hash");
  * // ➔ "/path/to/resource?x=1#hash"
+ *
+ * // Empty string returns defaultPath
  * normalizePathname("   ");
  * // ➔ "/"
- * normalizePathname(null, "/home");
+ *
+ * // Return defaultPath if isn't valid pathname and keepNullable is `undefined` or `false`.
+ * normalizePathname(null, { defaultPath: "/home" });
+ * // ➔ "/home"
+ *
+ * // Preserve null
+ * normalizePathname(null, { keepNullable: true });
+ * // ➔ null
+ *
+ * // Preserve undefined
+ * normalizePathname(undefined, { keepNullable: true });
+ * // ➔ undefined
+ *
+ * // Return defaultPath if pathname is empty-string even with keepNullable
+ * normalizePathname("  ", { keepNullable: true, defaultPath:"/home" });
  * // ➔ "/home"
+ *
+ * // Return undefined if pathname is not a valid-string.
+ * normalizePathname(true, { keepNullable: true, defaultPath:"/home" });
+ * // ➔ undefined
+ *
+ * // Collapse multiple slashes
  * normalizePathname("/double//slashes");
  * // ➔ "/double/slashes"
+ *
+ * // Handles emoji and Unicode
  * normalizePathname(" nested / path / 🚀 ");
  * // ➔ "/nested/path/🚀"
+ *
+ * // Query and hash preserved
+ * normalizePathname("/dashboard///stats?view=all#top");
+ * // ➔ "/dashboard/stats?view=all#top"
+ *
+ * // Leading/trailing slashes normalized
+ * normalizePathname("///api//v1///user/");
+ * // ➔ "/api/v1/user"
+ *
+ * // Keep trailing slash if option enabled
+ * normalizePathname("///api//v1///user//", { keepTrailingSlash: true });
+ * // ➔ "/api/v1/user/"
+ *
+ * // Relative-like paths handled safely
+ * normalizePathname("path/to/page");
+ * // ➔ "/path/to/page"
+ *
+ * // Query-only path
+ * normalizePathname("?page=2");
+ * // ➔ "/?page=2"
+ *
+ * // Hash-only path
+ * normalizePathname("#section3");
+ * // ➔ "/#section3"
+ *
+ * // URL parsing failure triggers custom error
+ * try {
+ *    normalizePathname("http://");
+ * } catch (e) {
+ *    // ➔ console.log(e);
+ * }
+ *
+ * // Internal encoded spaces preserved
+ * normalizePathname("/search/%20item%20");
+ * // ➔ "/search/%20item%20"
+ *
+ * // Edge case: relative URL-like input
+ * normalizePathname("localhost/path");
+ * // ➔ "/path"
+ * normalizePathname("localhost:3000/path");
+ * // ➔ "/path"
+ * normalizePathname("example.com/path");
+ * // ➔ "/path"
+ * normalizePathname("sub.domain.com/path");
+ * // ➔ "/path"
+ * normalizePathname("*.domain.com/path");
+ * // ➔ "/path"
+ *
+ * // Deeply nested messy path
+ * normalizePathname("   /🔥//deep//path///🚀  ");
+ * // ➔ "/🔥/deep/path/🚀"
+ *
+ * // Edge case: root slash
+ * normalizePathname("/");
+ * // ➔ "/"
+ *
+ * // Edge case: multiple spaces only
+ * normalizePathname("    ");
+ * // ➔ "/"
  */
-declare const normalizePathname:(pathname:string|null|undefined,defaultPath?:string)=>string;type FormatEnvPortOptions={
+declare function normalizePathname<T>(pathname:T,options?:NormalizePathnameOptionsKeepNullableFalse):ResUnKeepNullable<T>;declare function normalizePathname<T>(pathname:T,options?:NormalizePathnameOptionsKeepNullableTrue):ResKeepNullable<T>;type FormatEnvPortOptions={
 /** Add prefix with a colon, defaultValue: `false`.
  *
  * @default false
@@ -404,4 +557,100 @@ prefixColon?:boolean;};
  * formatEnvPort("port:8080", { prefixColon: true });
  * // ➔ ":8080"
  */
-declare const formatEnvPort:(envVar:string|null|undefined,options?:FormatEnvPortOptions)=>string;export{type QueryParamPairs,constructURL,extractURLs,formatEnvPort,getFirstPrefixPathname,getPrefixPathname,normalizePathname};
+declare const formatEnvPort:(envVar:string|null|undefined,options?:FormatEnvPortOptions)=>string;
+/** ---------------------------------------------------------
+ * * ***Constants for `Punycode-UtilsJS` algorithm.***
+ * ---------------------------------------------------------
+ * These constants are used internally for encoding and decoding.
+ *
+ * Unicode domain names to ASCII (`Punycode-UtilsJS`) and vice versa.
+ */
+type PunycodeUtilsJS={
+/** ---------------------------------------------------------
+ * * ***Version of the `Punycode-UtilsJS` implementation.***
+ * ---------------------------------------------------------
+ *
+ * @example
+ * console.log(punycodeUtilsJS.version); // "1.0.0"
+ */
+version:string;
+/** ---------------------------------------------------------
+ * * ***UCS-2 utility functions.***
+ * ---------------------------------------------------------
+ */
+ucs2:{
+/** ---------------------------------------------------------
+ * * ***Decodes a UCS-2 encoded string to an array of Unicode code points.***
+ * ---------------------------------------------------------
+ *
+ * @param input - The UCS-2 string to decode.
+ * @returns Array of Unicode code points.
+ * @example
+ * punycodeUtilsJS.ucs2.decode("𐍈");
+ * // ➔ [66376]
+ */
+decode:(input:string)=>number[];
+/** ---------------------------------------------------------
+ * * ***Encodes an array of Unicode code points to a UCS-2 string.***
+ * ---------------------------------------------------------
+ *
+ * @param points - Array of Unicode code points.
+ * @returns Encoded string.
+ * @example
+ * punycodeUtilsJS.ucs2.encode([66376]);
+ * // ➔ "𐍈"
+ */
+encode:(points:number[])=>string;};
+/** ---------------------------------------------------------
+ * * ***Decodes a `Punycode-UtilsJS` string to a Unicode string.***
+ * ---------------------------------------------------------
+ *
+ * @param input - The `Punycode-UtilsJS` string to decode.
+ * @returns Decoded Unicode string.
+ * @example
+ * punycodeUtilsJS.decode("xn--fsq");
+ * // ➔ "ü"
+ */
+decode:(input:string)=>string;
+/** ---------------------------------------------------------
+ * * ***Encodes a Unicode string to `Punycode-UtilsJS`.***
+ * ---------------------------------------------------------
+ *
+ * @param input - Unicode string to encode.
+ * @returns `Punycode-UtilsJS` string.
+ * @example
+ * punycodeUtilsJS.encode("ü");
+ * // ➔ "xn--fsq"
+ */
+encode:(input:string)=>string;
+/** ---------------------------------------------------------
+ * * ***Converts a Unicode domain or label to ASCII (`Punycode-UtilsJS`).***
+ * ---------------------------------------------------------
+ *
+ * @param input - Domain or label string.
+ * @returns ASCII string suitable for DNS.
+ * @example
+ * punycodeUtilsJS.toASCII("пример.рф");
+ * // ➔ "xn--e1afmkfd.xn--p1ai"
+ */
+toASCII:(input:string)=>string;
+/** ---------------------------------------------------------
+ * * ***Converts an ASCII (`Punycode-UtilsJS`) domain or label to Unicode.***
+ * ---------------------------------------------------------
+ *
+ * @param input - ASCII string (with xn-- prefix if needed).
+ * @returns Unicode string.
+ * @example
+ * punycodeUtilsJS.toUnicode("xn--e1afmkfd.xn--p1ai");
+ * // ➔ "пример.рф"
+ */
+toUnicode:(input:string)=>string;};
+/** ---------------------------------------------------------
+ * * ***`Punycode-UtilsJS` object exposing all API functions and version.***
+ * ---------------------------------------------------------
+ * Provides encoding and decoding of Unicode domain names to ASCII (`Punycode-UtilsJS`)
+ * and vice versa.
+ *
+ * - Useful for IDN (Internationalized Domain Names) support.
+ */
+declare const punycodeUtilsJS:PunycodeUtilsJS;export{type QueryParamPairs,constructURL,extractURLs,formatEnvPort,getFirstPrefixPathname,getPrefixPathname,normalizePathname,punycodeUtilsJS};

package/dist/urls/index.js

@@ -2,19 +2,20 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.5.7.
+ * Version: 3.7.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
-export { constructURL, extractURLs, getFirstPrefixPathname, getPrefixPathname } from '../chunk-6DSPJA5U.js';
+export { constructURL, extractURLs, getFirstPrefixPathname, getPrefixPathname } from '../chunk-6PKW4WCT.js';
 import '../chunk-ONZFBJVW.js';
 import '../chunk-GAJBF6DR.js';
 import '../chunk-TDYGYHSH.js';
 import '../chunk-PZQC3FZY.js';
 import '../chunk-7ZNEUWYP.js';
 import '../chunk-WVSPXFTY.js';
-export { formatEnvPort, normalizePathname } from '../chunk-LBNOZIZ6.js';
+export { formatEnvPort, normalizePathname } from '../chunk-WNO3EPYT.js';
+export { punycodeUtilsJS } from '../chunk-YS27V6LS.js';
 import '../chunk-4ACKNPL5.js';
 import '../chunk-JY4HLZ4W.js';
 import '../chunk-VCVND6CH.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rzl-zone/utils-js",
-  "version": "3.5.7",
+  "version": "3.7.0",
   "sideEffects": false,
   "engineStrict": true,
   "license": "MIT",
@@ -19,7 +19,6 @@
   },
   "dependencies": {
     "@rzl-zone/ts-types-plus": "latest",
-    "clsx": "^2.1.1",
     "date-fns": "^4.1.0",
     "libphonenumber-js": "^1.12.17",
     "server-only": "^0.0.1",
@@ -191,16 +190,25 @@
   "keywords": [
     "javascript",
     "typescript",
+    "js",
+    "ts",
+    "util",
     "utils",
+    "helper",
     "helpers",
     "library",
     "@rzl-zone/utils-js",
     "rzl",
     "rzl-zone",
+    "rzl zone",
+    "util js",
+    "util-js",
     "utils-js",
+    "utils js",
     "utility",
+    "utility js",
     "rzl-utils",
-    "helper",
+    "rzl utils",
     "functions"
   ],
   "publishConfig": {

package/dist/chunk-LBNOZIZ6.js

@@ -1,90 +0,0 @@
-/*!
- * ====================================================
- * Rzl Utils-JS.
- * ----------------------------------------------------
- * Version: 3.5.7.
- * Author: Rizalvin Dwiky.
- * Repository: https://github.com/rzl-zone/utils-js.
- * ====================================================
- */
-import { removeSpaces } from './chunk-4ACKNPL5.js';
-import { isEmptyString } from './chunk-JY4HLZ4W.js';
-import { safeStableStringify } from './chunk-2VO2CBTU.js';
-import { isNonEmptyString, getPreciseType, isError, assertIsPlainObject, 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
-      }
-    };
-  }
-};
-
-var normalizePathname = (pathname, defaultPath = "/") => {
-  if (!isNonEmptyString(defaultPath)) {
-    throw new TypeError(
-      `Second parameter (\`defaultPath\`) must be of type \`string\` and not empty-string, but received: \`${getPreciseType(
-        defaultPath
-      )}\`, with value: \`${safeStableStringify(defaultPath)}\`.`
-    );
-  }
-  if (!isNonEmptyString(pathname)) return defaultPath;
-  try {
-    pathname = removeSpaces(pathname, { trimOnly: true });
-    pathname = pathname.replace(/\s+/g, "");
-    if (pathname.startsWith("http://") || pathname.startsWith("https://")) {
-      const url = new URL(pathname);
-      return `${url.pathname}${url.search}${url.hash}`.replace(/^\/+/, "/");
-    }
-    return "/" + pathname.replace(/^\/+/, "").replace(/\/{2,}/g, "/");
-  } 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
-    );
-  }
-};
-
-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-URDI3IMY.cjs

@@ -1,93 +0,0 @@
-/*!
- * ====================================================
- * Rzl Utils-JS.
- * ----------------------------------------------------
- * Version: 3.5.7.
- * Author: Rizalvin Dwiky.
- * Repository: https://github.com/rzl-zone/utils-js.
- * ====================================================
- */
-'use strict';
-
-var chunkLIU4S3JA_cjs = require('./chunk-LIU4S3JA.cjs');
-var chunkNREACG6M_cjs = require('./chunk-NREACG6M.cjs');
-var chunkYC7AK3KX_cjs = require('./chunk-YC7AK3KX.cjs');
-var chunkF3WBQKRI_cjs = require('./chunk-F3WBQKRI.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, chunkF3WBQKRI_cjs.isFunction(Error) ? { cause: originalError } : void 0);
-    this.name = "NormalizePathnameError";
-    this.originalError = originalError;
-    if (chunkF3WBQKRI_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
-      }
-    };
-  }
-};
-
-var normalizePathname = (pathname, defaultPath = "/") => {
-  if (!chunkF3WBQKRI_cjs.isNonEmptyString(defaultPath)) {
-    throw new TypeError(
-      `Second parameter (\`defaultPath\`) must be of type \`string\` and not empty-string, but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
-        defaultPath
-      )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(defaultPath)}\`.`
-    );
-  }
-  if (!chunkF3WBQKRI_cjs.isNonEmptyString(pathname)) return defaultPath;
-  try {
-    pathname = chunkLIU4S3JA_cjs.removeSpaces(pathname, { trimOnly: true });
-    pathname = pathname.replace(/\s+/g, "");
-    if (pathname.startsWith("http://") || pathname.startsWith("https://")) {
-      const url = new URL(pathname);
-      return `${url.pathname}${url.search}${url.hash}`.replace(/^\/+/, "/");
-    }
-    return "/" + pathname.replace(/^\/+/, "").replace(/\/{2,}/g, "/");
-  } catch (error) {
-    const err = chunkF3WBQKRI_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 (!chunkF3WBQKRI_cjs.isNonEmptyString(envVar)) return "";
-  chunkF3WBQKRI_cjs.assertIsPlainObject(options, {
-    message: ({ currentType, validType }) => `Second parameter (\`options\`) must be of type \`${validType}\`, but received: \`${currentType}\`.`
-  });
-  const prefixColon = chunkF3WBQKRI_cjs.hasOwnProp(options, "prefixColon") ? options.prefixColon : false;
-  if (!chunkF3WBQKRI_cjs.isBoolean(prefixColon)) {
-    throw new TypeError(
-      `Parameter \`prefixColon\` property of the \`options\` (second parameter) must be of type \`boolean\`, but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
-        prefixColon
-      )}\`.`
-    );
-  }
-  const digitsOnly = envVar.replace(/\D+/g, "");
-  if (chunkNREACG6M_cjs.isEmptyString(digitsOnly)) return "";
-  return prefixColon ? `:${digitsOnly}` : digitsOnly;
-};
-
-exports.formatEnvPort = formatEnvPort;
-exports.normalizePathname = normalizePathname;