@rzl-zone/utils-js 3.12.1-beta.0 → 3.12.1-beta.1

package/dist/urls/index.js

@@ -2,22 +2,23 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.0`
+*  Version: `3.12.1-beta.1`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
-import { A as isPlainObject, E as isNull, F as isBoolean, M as isArray, N as isNil, P as isFunction, S as isUndefined, k as isString, p as isNonEmptyArray, r as getPreciseType, v as isError, w as isNumber, y as isNonEmptyString } from "../assertIsBoolean-BlBct0Fc.js";
-import { t as assertIsArray } from "../assertIsArray-BfAbIUfa.js";
-import { t as toStringArrayUnRecursive } from "../toStringArrayUnRecursive-CFs0jTEg.js";
-import { t as safeStableStringify } from "../safeStableStringify-BNh3D0K0.js";
-import { t as isEmptyString } from "../isEmptyString-BTUWYTbw.js";
-import { t as isEmptyValue } from "../isEmptyValue-fjnfQnt5.js";
-import { t as isInteger } from "../isInteger-DS9V7l_f.js";
-import { t as punycodeUtilsJS } from "../punyCode-hmiFzLWT.js";
-import { t as isURL } from "../isURL-CQiowFq2.js";
-import { t as normalizeString } from "../normalizeString-2WLth_Gj.js";
-import { n as normalizePathname, t as formatEnvPort } from "../formatEnvPort-DpIXzPAZ.js";
+import { A as isPlainObject, E as isNull, F as isBoolean, M as isArray, N as isNil, P as isFunction, S as isUndefined, k as isString, p as isNonEmptyArray, r as getPreciseType, v as isError, w as isNumber, y as isNonEmptyString } from "../assertIsBoolean-DR1SaXPD.js";
+import { t as assertIsArray } from "../assertIsArray-bTA3XLjq.js";
+import { t as toStringArrayUnRecursive } from "../toStringArrayUnRecursive-DJGtPsFb.js";
+import { t as safeStableStringify } from "../safeStableStringify-CXOZ9Ub8.js";
+import { t as isEmptyString } from "../isEmptyString-BXzKAC2j.js";
+import { t as isEmptyValue } from "../isEmptyValue-jqOr7OHD.js";
+import { t as isInteger } from "../isInteger-naMbJsxJ.js";
+import { t as punycodeUtilsJS } from "../punyCode-8SrbMWfM.js";
+import { t as isURL } from "../isURL-C-kSk6KJ.js";
+import { n as EOL, r as joinLines } from "../isValidDomain-DoE98yhJ.js";
+import { t as normalizeString } from "../normalizeString-BDdkaXui.js";
+import { n as normalizePathname, t as formatEnvPort } from "../formatEnvPort-ByFVLjSV.js";
 const constructURL = (baseUrl, queryParams, removeParams) => {
 	if (isString(baseUrl)) {
 		if (isEmptyString(baseUrl)) throw new TypeError("First parameter (`baseUrl`) cannot be an empty-string.");
@@ -96,7 +97,7 @@ const getPrefixPathname = (url, base = null, options = {}) => {
 	const { levels = 1, removeDuplicates = true } = options;
 	if (!isInteger(levels) || 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: \`${getPreciseType(levels)}\`, with value: \`${safeStableStringify(levels, { keepUndefined: true })}\`.`);
 	if (!isBoolean(removeDuplicates)) errors.push(`Parameter \`removeDuplicates\` property of the \`options\` (second parameter) must be of type \`boolean\`, but received: \`${getPreciseType(removeDuplicates)}\`.`);
-	if (isNonEmptyArray(errors)) throw new TypeError(`Invalid parameter(s) in \`getPrefixPathname\` function:\n- ${errors.join("\n- ")}`);
+	if (isNonEmptyArray(errors)) throw new TypeError(joinLines("Invalid parameter(s) in `getPrefixPathname` function:", `- ${errors.join(`${EOL}- `)}`));
 	function getLevel(singleUrl) {
 		return `/${normalizePathname(singleUrl).split("/").filter(Boolean).slice(0, levels).join("/")}`;
 	}
@@ -113,7 +114,7 @@ const getPrefixPathname = (url, base = null, options = {}) => {
 	if (isArray(url)) {
 		const result = url.map(processUrl).filter((r) => !isNull(r));
 		const uniqueResult = removeDuplicates ? [...new Set(result)] : result;
-		if (uniqueResult.length === 1) return uniqueResult[0];
+		if (uniqueResult.length === 1) return uniqueResult[0] ?? null;
 		return uniqueResult;
 	}
 	return processUrl(url);

package/dist/urls/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/urls/builders/constructURL.ts","../../src/urls/extractors/extractURLs.ts","../../src/urls/pathname/getFirstPrefixPathname.ts","../../src/urls/pathname/getPrefixPathname.ts"],"sourcesContent":["import { isURL } from \"@/predicates/is/isURL\";\nimport { isError } from \"@/predicates/is/isError\";\nimport { isNumber } from \"@/predicates/is/isNumber\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isFunction } from \"@/predicates/is/isFunction\";\nimport { isUndefined } from \"@/predicates/is/isUndefined\";\nimport { isEmptyValue } from \"@/predicates/is/isEmptyValue\";\nimport { isEmptyString } from \"@/predicates/is/isEmptyString\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\nimport { normalizeString } from \"@/strings/sanitizations/normalizeString\";\n\nimport { assertIsArray } from \"@/assertions/objects/assertIsArray\";\n\nimport { safeStableStringify } from \"@/conversions/stringify/safeStableStringify\";\nimport { toStringArrayUnRecursive } from \"@/conversions/arrays/casts/toStringArrayUnRecursive\";\n\n/** ----------------------------------------------------------\n * * ***Type-Utility: `QueryParamPairs`.***\n * ----------------------------------------------------------\n * **Represents a non-empty array of key–value pairs.**\n * @description\n * Type for `queryParams` parameter, the second parameter of ***`constructURL` utility function***.\n * - **Behavior:**\n *    - Each inner tuple strictly follows the `[string, string | number]` shape.\n *    - Ensures the outer array contains **at least one pair** (non-empty).\n *    - Commonly used for URL construction parameters,\n *      query string segments, or other key–value structured data.\n * @example\n * // ✅ valid usage\n * const params: QueryParamPairs = [\n *   [\"foo\", 1],\n *   [\"bar\", \"baz\"]\n * ];\n * constructURL(\"https://example.com\", params);\n *\n * // ❌ invalid: must contain at least one item\n * const empty: QueryParamPairs = [];\n *\n * // ❌ invalid: key without value pairs.\n * const empty2: QueryParamPairs = [[\"key\"]];\n */\nexport type QueryParamPairs = [\n  [string, string | number],\n  ...[string, string | number][]\n];\n\n/** ---------------------------------\n * * ***Utility: `constructURL`.***\n * ---------------------------------\n * **Constructs a valid URL with optional query parameters and allows selective removal of duplicate parameters.**\n * @param {string | URL} baseUrl The base URL to build upon. Must include protocol (e.g., `\"https://\"`), `domain`, and may include port and existing query parameters.\n * @param {Iterable<[string, string]> | URLSearchParamsIterator<[string, string]> | QueryParamPairs} [queryParams]\n *   Additional query parameters to append or overwrite on the URL.\n *   - Accepts any iterable of key-value pairs (like `new URLSearchParams().entries()` and `[[string, string | number]...]`).\n * @param {string[]} [removeParams]\n *   A list of query parameter keys to remove from the final URL, whether they were in the base URL or provided queryParams.\n * @returns {URL} A new URL object representing the constructed URL with merged and cleaned query parameters.\n * @throws **{@link TypeError | `TypeError`}** if `baseUrl` is not a valid non-empty string or URL object, or if `queryParams` is not iterable, or if `removeParams` is not an array of strings.\n * @example\n *    1. #### Basic Usage:\n * ```ts\n *   constructURL(\n *     \"https://example.com/path\",\n *     new URLSearchParams({ a: \"1\", b: \"2\" }).entries()\n *   );\n *   // ➔ URL { href: \"https://example.com/path?a=1&b=2\", ... }\n * ```\n *    2. #### Remove parameters from Base and Added:\n * ```ts\n *   // with new URLSearchParams({ ... }).entries();\n *   constructURL(\n *     \"https://example.com/path?foo=1&bar=2\",\n *     new URLSearchParams({ bar: \"ignored\", baz: \"3\" }).entries(),\n *     [\"bar\"]\n *   );\n *   // ➔ URL { href: \"https://example.com/path?foo=1&baz=3\", ... }\n *\n *   // with [[string, string | number]...]\n *   constructURL(\n *     \"https://example.com/path?foo=1&bar=2\",\n *     [[\"bar\", \"ignored\"],[\"baz\", 3]],\n *     [\"bar\"]\n *   );\n *   // ➔ URL { href: \"https://example.com/path?foo=1&baz=3\", ... }\n *\n *   const params: QueryParamPairs = [\n *     [\"foo\", 1],\n *     [\"bar\", 2],\n *     [\"baz\", 3]\n *   ];\n *\n *   constructURL(\"https://example.com\", params, [\"bar\"]);\n *   // ➔ URL { href: \"https://example.com/?foo=1&baz=3\", ... }\n * ```\n */\nexport const constructURL = (\n  baseUrl: string | URL,\n  queryParams?:\n    | URLSearchParamsIterator<[string, string | number]>\n    | QueryParamPairs,\n  removeParams?: string[]\n): URL => {\n  if (isString(baseUrl)) {\n    if (isEmptyString(baseUrl)) {\n      throw new TypeError(\n        \"First parameter (`baseUrl`) cannot be an empty-string.\"\n      );\n    }\n    baseUrl = normalizeString(baseUrl);\n  } else if (!isURL(baseUrl)) {\n    throw new TypeError(\n      `First parameter (\\`baseUrl\\`) must be of type an URL instance or a \\`string\\` and a non empty-string, but received: \\`${getPreciseType(\n        baseUrl\n      )}\\`, with current value: \\`${safeStableStringify(baseUrl, {\n        keepUndefined: true\n      })}\\`.`\n    );\n  }\n\n  // Check removeParams\n  if (!isUndefined(removeParams)) {\n    assertIsArray(removeParams, {\n      message: ({ currentType, validType }) =>\n        `Third parameter (\\`removeParams\\`) must be of type \\`${validType} of strings\\`, but received: \\`${currentType}\\`.`\n    });\n\n    if (!removeParams.every((param) => isNonEmptyString(param))) {\n      throw new TypeError(\n        \"Third parameter (`removeParams`) must be of type `array` and contains `string` only and non empty-string.\"\n      );\n    }\n  }\n\n  try {\n    // Check queryParams\n    if (\n      !isUndefined(queryParams) &&\n      !isFunction(queryParams[Symbol.iterator])\n    ) {\n      throw new TypeError(\n        `Second parameter (\\`queryParams\\`) must be iterable (like URLSearchParams.entries() or an array of [[string, string | number]...]), but received: \\`${getPreciseType(\n          queryParams\n        )}\\`, with value: \\`${safeStableStringify(queryParams, {\n          keepUndefined: true\n        })}\\`.`\n      );\n    }\n\n    const urlInstance = new URL(baseUrl);\n\n    // Add query parameters if provided\n    if (!isUndefined(queryParams)) {\n      const paramObject = Object.fromEntries(queryParams);\n\n      if (!isEmptyValue(paramObject)) {\n        // existing params\n        const mergedParams = new URLSearchParams(urlInstance.search);\n\n        // add / overwrite from queryParams\n        for (const [key, value] of Object.entries(paramObject)) {\n          if (\n            !isNonEmptyString(value) &&\n            !isNumber(value, { includeNaN: true })\n          ) {\n            throw new TypeError(\n              `Second parameter (\\`queryParams\\`) must be iterable (like URLSearchParams.entries() or an array of [[string, string | number]...]), but received: \\`${getPreciseType(\n                queryParams\n              )}\\`, with value: \\`${safeStableStringify(queryParams, {\n                keepUndefined: true\n              })}\\`.`\n            );\n          }\n\n          mergedParams.set(key, String(value));\n        }\n\n        // Remove specific query parameters if needed\n        if (removeParams?.length) {\n          toStringArrayUnRecursive(removeParams).map((paramKey) => {\n            mergedParams.delete(paramKey);\n          });\n        }\n\n        urlInstance.search = mergedParams.toString();\n      }\n    }\n\n    // Remove query parameters directly from URL if needed\n    removeParams?.forEach((param) => urlInstance.searchParams.delete(param));\n\n    return urlInstance;\n  } catch (error) {\n    if (isError(error)) throw error;\n\n    throw new Error(\n      \"Failed to construct a valid URL in `constructURL()`, Error:\" + error,\n      { cause: error }\n    );\n  }\n};\n","import { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\n/** ---------------------------------\n * * ***Utility: `extractURLs`.***\n * ---------------------------------\n * **Extracts all valid URLs from a given string.**\n * @description\n * This function scans the input url and returns an array of URLs\n * that match a valid `http` or `https` format.\n * - **Supports:**\n *    - Internationalized domain names (IDN), e.g. `https://münich.de`\n *    - Unicode & emoji paths, e.g. `https://example.com/🎉/page`\n *    - Long URLs with multiple queries & fragments, e.g. `https://example.com/path?foo=1#hash`\n * - **Ignores:**\n *    - Non-string inputs\n *    - Empty or whitespace-only strings\n *    - Non-HTTP(S) protocols (ftp, mailto, etc)\n * @param {string | null | undefined} url - The input string containing potential URLs.\n * @returns {string[] | null} An array of extracted URLs or `null` if no URLs are found.\n * @example\n * extractURLs(\"Visit https://example.com and https://例子.公司\");\n * // ➔ [\"https://example.com\", \"https://例子.公司\"]\n * extractURLs(\"Here: https://example.com/🎉/page\");\n * // ➔ [\"https://example.com/🎉/page\"]\n * extractURLs(\"ftp://example.com http://example.com\");\n * // ➔ [\"http://example.com\"]\n */\nexport const extractURLs = (\n  url: string | null | undefined\n): string[] | null => {\n  if (!isNonEmptyString(url)) return null;\n\n  let decoded;\n  try {\n    decoded = decodeURIComponent(url);\n  } catch {\n    return null;\n  }\n\n  // Core regex with lookahead\n  const urlPattern = /https?:\\/\\/.*?(?=https?:\\/\\/|\\s|$)/g;\n  const matches = decoded.match(urlPattern);\n  if (!matches) return null;\n\n  // Cleanup trailing punctuation and validation protocol\n  const cleaned = matches\n    .map((url) => url.replace(/[.,;:!?)]*$/, \"\"))\n    .filter((url) => {\n      try {\n        const u = new URL(url);\n        return u.protocol === \"http:\" || u.protocol === \"https:\";\n      } catch {\n        return false;\n      }\n    });\n\n  return cleaned.length ? cleaned : null;\n};\n","import { isNil } from \"@/predicates/is/isNil\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\nimport { safeStableStringify } from \"@/conversions/stringify/safeStableStringify\";\nimport { normalizePathname } from \"./normalizePathname\";\n\n/** --------------------------------------------------------\n * * ***Utility: `getFirstPrefixPathname`.***\n * --------------------------------------------------------\n * **Extract First Valid Prefix from Path Array or String.**\n * - **Main Purpose:**\n *    - This function helps extract the first valid URL prefix from various possible inputs.\n *    - It is especially useful in routing systems, middleware, or frontend apps that need to\n *      decide layout, active navigation, or permissions based on the first segment (or prefix) of a pathname.\n * - **Typical uses include:**\n *    - Determining which layout to render (e.g., `/admin` vs `/dashboard` vs `/`).\n *    - Highlighting the active menu item in a sidebar based on the current URL.\n *    - Enforcing route guards or access controls depending on the URL prefix.\n *    - Parsing multi-level route prefixes and selecting the most relevant one.\n * - **Behavior:**\n *    - It works as follows:\n *        - If `result` is an array of strings, it normalizes each element and returns\n *          the first non-root path (i.e., not just `\"/\"`).\n *        - If all items normalize to `\"/\"`,\n *          it returns the `defaultValue` (normalized).\n *        - If `result` is a single string, it normalizes it and returns it if valid,\n *          otherwise falls back to the normalized `defaultValue`.\n *        - If `result` is `null` or `undefined`, it returns the normalized `defaultValue`.\n * - **Validation & Errors:**\n *    - Throws a `TypeError` if:\n *      - `defaultValue` is not a string or empty-string.\n *      - `result` is an array that contains non-string elements.\n *      - `result` is a value that is neither `string`, `string[]`, nor `null`.\n * @example\n * 1. #### For React (*Determining layout*):\n * ```ts\n *   const prefix = getFirstPrefixPathname(\n *      getPrefixPathname(\n *        \"/admin/settings\",\n *        [\"/admin\", \"/dashboard\"]\n *      )\n *   );\n *\n *   if (prefix === \"/admin\") {\n *     renderAdminLayout();\n *   }\n * ```\n *\n * 2. #### Setting active menu state:\n * ```ts\n *   const activeSection = getFirstPrefixPathname([\"\", \"/dashboard\", \"/profile\"]);\n *   // ➔ \"/dashboard\"\n * ```\n *\n * 3. #### Providing graceful fallback:\n * ```ts\n *   const section = getFirstPrefixPathname([], \"/home\");\n *   // ➔ \"/home\"\n * ```\n * 4. #### ✅ Using with an Array of Pathnames:\n * ```ts\n *   const result = getPrefixPathname([\"   \", \"/dashboard\", \"/settings\"]);\n *   console.log(getFirstPrefixPathname(result));\n *   // ➔ \"/dashboard\"\n * ```\n *\n * 5. #### ✅ Using with Single String:\n * ```ts\n *   console.log(getFirstPrefixPathname(\"/profile/settings\"));\n *   // ➔ \"/profile/settings\"\n *   console.log(getFirstPrefixPathname(\"   \"));\n *   // ➔ \"/\"\n * ```\n *\n * 6. #### ✅ Fallback to Custom Default:\n * ```ts\n *   console.log(getFirstPrefixPathname([\"   \", \"\"], \"/home\"));\n *   // ➔ \"/home\"\n *   console.log(getFirstPrefixPathname(null, \"/dashboard\"));\n *   // ➔ \"/dashboard\"\n * ```\n *\n * 7. #### ✅ Throws on Invalid Input:\n * ```ts\n *   getFirstPrefixPathname([1, 2] as any); // ➔ ❌ throws TypeError\n *   getFirstPrefixPathname({} as any);     // ➔ ❌ throws TypeError\n *   getFirstPrefixPathname(null, \"   \");   // ➔ ❌ throws TypeError\n * ```\n * @param {string | string[] | null | undefined} result\n *  ***The pathname(s) to process, can be:***\n *    - A string path (e.g. `\"/profile\"`),\n *    - An array of string paths (e.g. `[\"   \", \"/dashboard\"]`),\n *    - Or `null`.\n * @param {string} [defaultValue=\"/\"]\n *  ***A custom default path to use if `result` is null or no valid prefix is found, behavior:***\n *      - Must be a string and non-empty string.\n *      - Defaults to `\"/\"`.\n * @returns {string}\n *   ***The first valid normalized pathname, or the normalized default.***\n * @throws **{@link TypeError | `TypeError`}** ***if `result` is not a valid type, or `defaultValue` is not a string or empty-string.***\n */\nexport const getFirstPrefixPathname = (\n  result: string | string[] | null | undefined,\n  defaultValue: string = \"/\"\n): string => {\n  if (!isNonEmptyString(defaultValue)) {\n    throw new TypeError(\n      `Second parameter (\\`defaultValue\\`) must be of type \\`string\\` and not an \\`empty-string\\`, but received: \\`${getPreciseType(\n        defaultValue\n      )}\\`, with value: \\`${safeStableStringify(defaultValue, {\n        keepUndefined: true\n      })}\\`.`\n    );\n  }\n\n  if (isArray(result)) {\n    if (!result.every((item) => isString(item))) {\n      throw new TypeError(\n        `First parameter (\\`result\\`) must be of type \\`string\\` or \\`array of string\\`, but received: \\`${getPreciseType(\n          result\n        )}\\`, with value: \\`${safeStableStringify(result, {\n          keepUndefined: true\n        })}\\`.`\n      );\n    }\n\n    for (const item of result) {\n      const normalized = normalizePathname(item);\n      if (normalized !== \"/\") {\n        return normalized;\n      }\n    }\n    return normalizePathname(defaultValue);\n  }\n\n  if (isString(result)) {\n    const normalized = normalizePathname(result);\n    return normalized !== \"/\" ? normalized : normalizePathname(defaultValue);\n  }\n\n  if (!isNil(result)) {\n    throw new TypeError(\n      `First parameter (\\`result\\`) must be of type \\`string\\`, \\`array-string\\`, \\`null\\` or \\`undefined\\`, but received: \\`${getPreciseType(\n        result\n      )}\\`.`\n    );\n  }\n\n  return normalizePathname(defaultValue);\n};\n","import { isNull } from \"@/predicates/is/isNull\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isInteger } from \"@/predicates/is/isInteger\";\nimport { isBoolean } from \"@/predicates/is/isBoolean\";\nimport { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\nimport { isNonEmptyArray } from \"@/predicates/is/isNonEmptyArray\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\nimport { safeStableStringify } from \"@/conversions/stringify/safeStableStringify\";\n\nimport { normalizePathname } from \"./normalizePathname\";\n\ntype GetPrefixPathnameOptions = {\n  /** The number of levels to include in the prefix (default is `1`).\n   *\n   * - For example, with `levels = 2`, the function will return the first two parts of the URL.\n   *\n   * @default 1\n   */\n  levels?: number;\n  /** Whether to remove duplicates from the result if multiple URLs are passed (default is `true`).\n   *\n   * @default true\n   */\n  removeDuplicates?: boolean;\n};\n\n/** --------------------------------------------------------\n * * ***Utility: `getPrefixPathname`.***\n * --------------------------------------------------------\n * **Get Prefix from URL with Optional Base or Auto-detection (Supports String or Array of URLs).**\n * - **This function extracts the prefix from one or more URLs. It can either:**\n *    - Use a provided `base` string or an array of strings to check and return the matching prefix.\n *    - Automatically detect the prefix if no `base` is provided by analyzing the first part of the URL.\n * - **The function is flexible and can handle both scenarios:**\n *    1. **When the base is provided as a single string or an array of strings**:\n *        - The function will check if the URL starts with one of the provided base(s) and return the matching base.\n *    2. **When the base is not provided**:\n *        - The function will automatically detect the prefix by splitting the URL or using a regex.\n * - **Important Notes**:\n *    - If a base (or an array of bases) is provided, the URL must start with one of the given base(s).\n *    - If no base is provided, the function will attempt to detect the prefix automatically.\n *    - The `url` parameter can be either a string or an array of strings.\n *    - Supports deduplication of results (enabled by default).\n *    - Automatically returns a single string if only one unique result exists after processing.\n * @param {string|string[]} url\n *  ***The full URL(s) from which the prefix should be extracted, can be a `string` or an `array of strings`.***\n * @param {string|string[]|null} [base=null]\n *  ***The base URL(s) (e.g., `\"/settings\"`), behavior:***\n *    - It can be a `string`, an `array of strings`, or `null`.\n *    - If `provided`, it will be used to check the URL(s).\n *    - If `not provided`, the prefix will be auto-detected.\n * @param {GetPrefixPathnameOptions} [options]\n *  ***Additional options object:***\n *    - `levels` (default `1`): The number of segments to include when auto-detecting the prefix (e.g. `/foo/bar` for `levels: 2`).\n *    - `removeDuplicates` (default `true`): Whether to remove duplicate prefixes from the final array result.\n * @returns {string|string[]|null}\n *  ***Returns one of:***\n *    - A single string if only one unique prefix/base is found.\n *    - An array of strings if multiple different prefixes/bases are found.\n *    - `null` if no matching base is found when using `base`.\n * @throws **{@link TypeError | `TypeError`}**\n *  ***if:***\n *    - `url` is `not a string` or `not an array of strings`.\n *    - `base` is `not a string`, `array of strings`, or `null`.\n *    - `options` is `not an object`.\n *    - `levels` is `not a number`.\n *    - `removeDuplicates` is `not a boolean`.\n * @example\n * - #### ✅ **Correct Usage (With an Array of URLs and Base):**\n * ```ts\n *    const routes = [\n *      \"/settings/profile\",\n *      \"/settings/password\",\n *      \"/settings/other-path\",\n *      \"/other-path/xyz\",\n *    ];\n *\n *    // With base provided as a string\n *    routes.forEach(route => {\n *      console.log(getPrefixPathname(route, '/settings'));\n *      // ➔ \"/settings\"\n *    });\n *\n *    // With base provided as an array\n *    routes.forEach(route => {\n *      console.log(getPrefixPathname(route, ['/settings', '/admin']));\n *      // ➔ \"/settings\" or \"/admin\" depending on the current URL.\n *    });\n * ```\n * - #### ✅ **Correct Usage (With Single URL and Single Base):**\n * ```ts\n *    const result = getPrefixPathname(\"/settings/profile\", \"/settings\");\n *    console.log(result); // ➔ \"/settings\"\n * ```\n * - #### ✅ **Correct Usage (With Multiple URLs and Single Base):**\n * ```ts\n *    const result = getPrefixPathname(\n *      [\"/settings/profile\", \"/settings/password\"],\n *      \"/settings\"\n *    );\n *    console.log(result); // ➔ \"/settings\"\n *\n *    const result2 = getPrefixPathname(\n *      [\"/settings/profile\", \"/other/password\"],\n *      \"/other\"\n *    );\n *    console.log(result2); // ➔ \"/other\"\n * ```\n * - #### ✅ **Correct Usage (With Multiple URLs and Multiple Bases)**\n * ```ts\n *    const result = getPrefixPathname(\n *      [\"/settings/profile\", \"/admin/password\"],\n *      [\"/settings\", \"/admin\"]\n *    );\n *    console.log(result); // ➔ [\"/settings\", \"/admin\"]\n * ```\n * - #### ✅ **Auto-detection of Prefix**\n * ```ts\n *    const result = getPrefixPathname(\"/settings/profile\");\n *    console.log(result); // ➔ \"/settings\"\n *\n *    const result2 = getPrefixPathname(\n *      \"/settings/profile/info\",\n *      null,\n *      { levels: 2 }\n *    );\n *    console.log(result2); // ➔ \"/settings/profile\"\n * ```\n * - #### ✅ **Multiple URLs with Auto-detection**\n * ```ts\n *    const result = getPrefixPathname([\"/admin/profile\", \"/settings/password\"]);\n *    console.log(result); // ➔ [\"/admin\", \"/settings\"]\n * ```\n * - #### ✅ **Handling Duplicates**\n * ```ts\n *    const result = getPrefixPathname(\n *      [\"/settings/profile\", \"/settings/password\"],\n *      \"/settings\"\n *    );\n *    console.log(result); // ➔ \"/settings\" (deduped to single string)\n *\n *    const result2 = getPrefixPathname(\n *      [\"/settings/profile\", \"/settings/profile\"],\n *      \"/settings\",\n *      { removeDuplicates: false }\n *    );\n *    console.log(result2); // ➔ [\"/settings\", \"/settings\"]\n * ```\n * - #### ❌ **Incorrect Usage (URL Does Not Match Base)**\n * ```ts\n *    const result = getPrefixPathname(\"/other-path/profile\", \"/settings\");\n *    console.log(result); // ➔ null\n * ```\n */\nexport const getPrefixPathname = (\n  url: string | string[],\n  base: string | string[] | null = null,\n  options: GetPrefixPathnameOptions = {}\n): string | string[] | null => {\n  const errors: string[] = [];\n\n  if (!isString(url) && !isArray(url)) {\n    errors.push(\n      `First parameter (\\`url\\`) must be of type \\`string\\` or \\`array-string\\`, but received: \\`${getPreciseType(\n        url\n      )}\\`.`\n    );\n  }\n  if (!isString(base) && !isArray(base) && !isNull(base)) {\n    errors.push(\n      `Second parameter (\\`base\\`) must be of type \\`string\\`, \\`array-string\\` or \\`null\\`, but received: \\`${getPreciseType(\n        base\n      )}\\`.`\n    );\n  }\n  if (!isPlainObject(options)) {\n    errors.push(\n      `Second parameter (\\`options\\`) must be of type \\`plain-object\\`, but received: \\`${getPreciseType(\n        options\n      )}\\`.`\n    );\n  }\n\n  const { levels = 1, removeDuplicates = true } = options;\n\n  if (!isInteger(levels) || (isInteger(levels) && levels < 0)) {\n    errors.push(\n      `Parameter \\`levels\\` property of the \\`options\\` (second parameter) must be of type \\`integer-number\\` and minimum is \\`0\\`, but received: \\`${getPreciseType(\n        levels\n      )}\\`, with value: \\`${safeStableStringify(levels, {\n        keepUndefined: true\n      })}\\`.`\n    );\n  }\n  if (!isBoolean(removeDuplicates)) {\n    errors.push(\n      `Parameter \\`removeDuplicates\\` property of the \\`options\\` (second parameter) must be of type \\`boolean\\`, but received: \\`${getPreciseType(\n        removeDuplicates\n      )}\\`.`\n    );\n  }\n  if (isNonEmptyArray(errors)) {\n    throw new TypeError(\n      `Invalid parameter(s) in \\`getPrefixPathname\\` function:\\n- ${errors.join(\"\\n- \")}`\n    );\n  }\n\n  // Helper function to process a single URL\n  function getLevel(singleUrl: string) {\n    // If no base is provided, detect the base automatically\n    const parts = normalizePathname(singleUrl).split(\"/\").filter(Boolean); // Split URL into parts\n\n    // Return the first `levels` parts as the prefix\n    return `/${parts.slice(0, levels).join(\"/\")}`;\n  }\n\n  // Helper function to process a single URL\n  function processUrl(singleUrl: string): string | null {\n    // If a base is provided, check if URL starts with one of the bases\n    if (base) {\n      singleUrl = normalizePathname(singleUrl);\n\n      if (isArray(base)) {\n        // Check if the URL starts with any of the base values in the array\n        for (const b of base) {\n          if (singleUrl.startsWith(normalizePathname(b))) {\n            // return normalizePathname(b); // Return the matching base if URL starts with it\n            return getLevel(singleUrl);\n          }\n        }\n      } else if (\n        isNonEmptyString(base) &&\n        singleUrl.startsWith(normalizePathname(base))\n      ) {\n        // If base is a single string, check if URL starts with it\n        // return normalizePathname(base); // Return the base if URL starts with it\n        return getLevel(singleUrl);\n      }\n      return null; // Return null if the URL does not match any base\n    }\n\n    return getLevel(singleUrl);\n  }\n\n  // If url is an array, process each URL and return an array of results\n  if (isArray(url)) {\n    const result = url.map(processUrl).filter((r): r is string => !isNull(r));\n\n    // Remove duplicates if required\n    const uniqueResult = removeDuplicates ? [...new Set(result)] : result;\n\n    // If all results are the same, return just the first one\n    if (uniqueResult.length === 1) {\n      return uniqueResult[0];\n    }\n\n    return uniqueResult;\n  }\n\n  // If url is a single string, process it and return the result\n  return processUrl(url);\n};\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/urls/builders/constructURL.ts","../../src/urls/extractors/extractURLs.ts","../../src/urls/pathname/getFirstPrefixPathname.ts","../../src/urls/pathname/getPrefixPathname.ts"],"sourcesContent":["import { isURL } from \"@/predicates/is/isURL\";\nimport { isError } from \"@/predicates/is/isError\";\nimport { isNumber } from \"@/predicates/is/isNumber\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isFunction } from \"@/predicates/is/isFunction\";\nimport { isUndefined } from \"@/predicates/is/isUndefined\";\nimport { isEmptyValue } from \"@/predicates/is/isEmptyValue\";\nimport { isEmptyString } from \"@/predicates/is/isEmptyString\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\nimport { normalizeString } from \"@/strings/sanitizations/normalizeString\";\n\nimport { assertIsArray } from \"@/assertions/objects/assertIsArray\";\n\nimport { safeStableStringify } from \"@/conversions/stringify/safeStableStringify\";\nimport { toStringArrayUnRecursive } from \"@/conversions/arrays/casts/toStringArrayUnRecursive\";\n\n/** ----------------------------------------------------------\n * * ***Type-Utility: `QueryParamPairs`.***\n * ----------------------------------------------------------\n * **Represents a non-empty array of key–value pairs.**\n * @description\n * Type for `queryParams` parameter, the second parameter of ***`constructURL` utility function***.\n * - **Behavior:**\n *    - Each inner tuple strictly follows the `[string, string | number]` shape.\n *    - Ensures the outer array contains **at least one pair** (non-empty).\n *    - Commonly used for URL construction parameters,\n *      query string segments, or other key–value structured data.\n * @example\n * // ✅ valid usage\n * const params: QueryParamPairs = [\n *   [\"foo\", 1],\n *   [\"bar\", \"baz\"]\n * ];\n * constructURL(\"https://example.com\", params);\n *\n * // ❌ invalid: must contain at least one item\n * const empty: QueryParamPairs = [];\n *\n * // ❌ invalid: key without value pairs.\n * const empty2: QueryParamPairs = [[\"key\"]];\n */\nexport type QueryParamPairs = [\n  [string, string | number],\n  ...[string, string | number][]\n];\n\n/** ---------------------------------\n * * ***Utility: `constructURL`.***\n * ---------------------------------\n * **Constructs a valid URL with optional query parameters and allows selective removal of duplicate parameters.**\n * @param {string | URL} baseUrl The base URL to build upon. Must include protocol (e.g., `\"https://\"`), `domain`, and may include port and existing query parameters.\n * @param {Iterable<[string, string]> | URLSearchParamsIterator<[string, string]> | QueryParamPairs} [queryParams]\n *   Additional query parameters to append or overwrite on the URL.\n *   - Accepts any iterable of key-value pairs (like `new URLSearchParams().entries()` and `[[string, string | number]...]`).\n * @param {string[]} [removeParams]\n *   A list of query parameter keys to remove from the final URL, whether they were in the base URL or provided queryParams.\n * @returns {URL} A new URL object representing the constructed URL with merged and cleaned query parameters.\n * @throws **{@link TypeError | `TypeError`}** if `baseUrl` is not a valid non-empty string or URL object, or if `queryParams` is not iterable, or if `removeParams` is not an array of strings.\n * @example\n *    1. #### Basic Usage:\n * ```ts\n *   constructURL(\n *     \"https://example.com/path\",\n *     new URLSearchParams({ a: \"1\", b: \"2\" }).entries()\n *   );\n *   // ➔ URL { href: \"https://example.com/path?a=1&b=2\", ... }\n * ```\n *    2. #### Remove parameters from Base and Added:\n * ```ts\n *   // with new URLSearchParams({ ... }).entries();\n *   constructURL(\n *     \"https://example.com/path?foo=1&bar=2\",\n *     new URLSearchParams({ bar: \"ignored\", baz: \"3\" }).entries(),\n *     [\"bar\"]\n *   );\n *   // ➔ URL { href: \"https://example.com/path?foo=1&baz=3\", ... }\n *\n *   // with [[string, string | number]...]\n *   constructURL(\n *     \"https://example.com/path?foo=1&bar=2\",\n *     [[\"bar\", \"ignored\"],[\"baz\", 3]],\n *     [\"bar\"]\n *   );\n *   // ➔ URL { href: \"https://example.com/path?foo=1&baz=3\", ... }\n *\n *   const params: QueryParamPairs = [\n *     [\"foo\", 1],\n *     [\"bar\", 2],\n *     [\"baz\", 3]\n *   ];\n *\n *   constructURL(\"https://example.com\", params, [\"bar\"]);\n *   // ➔ URL { href: \"https://example.com/?foo=1&baz=3\", ... }\n * ```\n */\nexport const constructURL = (\n  baseUrl: string | URL,\n  queryParams?:\n    | URLSearchParamsIterator<[string, string | number]>\n    | QueryParamPairs,\n  removeParams?: string[]\n): URL => {\n  if (isString(baseUrl)) {\n    if (isEmptyString(baseUrl)) {\n      throw new TypeError(\n        \"First parameter (`baseUrl`) cannot be an empty-string.\"\n      );\n    }\n    baseUrl = normalizeString(baseUrl);\n  } else if (!isURL(baseUrl)) {\n    throw new TypeError(\n      `First parameter (\\`baseUrl\\`) must be of type an URL instance or a \\`string\\` and a non empty-string, but received: \\`${getPreciseType(\n        baseUrl\n      )}\\`, with current value: \\`${safeStableStringify(baseUrl, {\n        keepUndefined: true\n      })}\\`.`\n    );\n  }\n\n  // Check removeParams\n  if (!isUndefined(removeParams)) {\n    assertIsArray(removeParams, {\n      message: ({ currentType, validType }) =>\n        `Third parameter (\\`removeParams\\`) must be of type \\`${validType} of strings\\`, but received: \\`${currentType}\\`.`\n    });\n\n    if (!removeParams.every((param) => isNonEmptyString(param))) {\n      throw new TypeError(\n        \"Third parameter (`removeParams`) must be of type `array` and contains `string` only and non empty-string.\"\n      );\n    }\n  }\n\n  try {\n    // Check queryParams\n    if (\n      !isUndefined(queryParams) &&\n      !isFunction(queryParams[Symbol.iterator])\n    ) {\n      throw new TypeError(\n        `Second parameter (\\`queryParams\\`) must be iterable (like URLSearchParams.entries() or an array of [[string, string | number]...]), but received: \\`${getPreciseType(\n          queryParams\n        )}\\`, with value: \\`${safeStableStringify(queryParams, {\n          keepUndefined: true\n        })}\\`.`\n      );\n    }\n\n    const urlInstance = new URL(baseUrl);\n\n    // Add query parameters if provided\n    if (!isUndefined(queryParams)) {\n      const paramObject = Object.fromEntries(queryParams);\n\n      if (!isEmptyValue(paramObject)) {\n        // existing params\n        const mergedParams = new URLSearchParams(urlInstance.search);\n\n        // add / overwrite from queryParams\n        for (const [key, value] of Object.entries(paramObject)) {\n          if (\n            !isNonEmptyString(value) &&\n            !isNumber(value, { includeNaN: true })\n          ) {\n            throw new TypeError(\n              `Second parameter (\\`queryParams\\`) must be iterable (like URLSearchParams.entries() or an array of [[string, string | number]...]), but received: \\`${getPreciseType(\n                queryParams\n              )}\\`, with value: \\`${safeStableStringify(queryParams, {\n                keepUndefined: true\n              })}\\`.`\n            );\n          }\n\n          mergedParams.set(key, String(value));\n        }\n\n        // Remove specific query parameters if needed\n        if (removeParams?.length) {\n          toStringArrayUnRecursive(removeParams).map((paramKey) => {\n            mergedParams.delete(paramKey);\n          });\n        }\n\n        urlInstance.search = mergedParams.toString();\n      }\n    }\n\n    // Remove query parameters directly from URL if needed\n    removeParams?.forEach((param) => urlInstance.searchParams.delete(param));\n\n    return urlInstance;\n  } catch (error) {\n    if (isError(error)) throw error;\n\n    throw new Error(\n      \"Failed to construct a valid URL in `constructURL()`, Error:\" + error,\n      { cause: error }\n    );\n  }\n};\n","import { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\n/** ---------------------------------\n * * ***Utility: `extractURLs`.***\n * ---------------------------------\n * **Extracts all valid URLs from a given string.**\n * @description\n * This function scans the input url and returns an array of URLs\n * that match a valid `http` or `https` format.\n * - **Supports:**\n *    - Internationalized domain names (IDN), e.g. `https://münich.de`\n *    - Unicode & emoji paths, e.g. `https://example.com/🎉/page`\n *    - Long URLs with multiple queries & fragments, e.g. `https://example.com/path?foo=1#hash`\n * - **Ignores:**\n *    - Non-string inputs\n *    - Empty or whitespace-only strings\n *    - Non-HTTP(S) protocols (ftp, mailto, etc)\n * @param {string | null | undefined} url - The input string containing potential URLs.\n * @returns {string[] | null} An array of extracted URLs or `null` if no URLs are found.\n * @example\n * extractURLs(\"Visit https://example.com and https://例子.公司\");\n * // ➔ [\"https://example.com\", \"https://例子.公司\"]\n * extractURLs(\"Here: https://example.com/🎉/page\");\n * // ➔ [\"https://example.com/🎉/page\"]\n * extractURLs(\"ftp://example.com http://example.com\");\n * // ➔ [\"http://example.com\"]\n */\nexport const extractURLs = (\n  url: string | null | undefined\n): string[] | null => {\n  if (!isNonEmptyString(url)) return null;\n\n  let decoded;\n  try {\n    decoded = decodeURIComponent(url);\n  } catch {\n    return null;\n  }\n\n  // Core regex with lookahead\n  const urlPattern = /https?:\\/\\/.*?(?=https?:\\/\\/|\\s|$)/g;\n  const matches = decoded.match(urlPattern);\n  if (!matches) return null;\n\n  // Cleanup trailing punctuation and validation protocol\n  const cleaned = matches\n    .map((url) => url.replace(/[.,;:!?)]*$/, \"\"))\n    .filter((url) => {\n      try {\n        const u = new URL(url);\n        return u.protocol === \"http:\" || u.protocol === \"https:\";\n      } catch {\n        return false;\n      }\n    });\n\n  return cleaned.length ? cleaned : null;\n};\n","import { isNil } from \"@/predicates/is/isNil\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\nimport { safeStableStringify } from \"@/conversions/stringify/safeStableStringify\";\nimport { normalizePathname } from \"./normalizePathname\";\n\n/** --------------------------------------------------------\n * * ***Utility: `getFirstPrefixPathname`.***\n * --------------------------------------------------------\n * **Extract First Valid Prefix from Path Array or String.**\n * - **Main Purpose:**\n *    - This function helps extract the first valid URL prefix from various possible inputs.\n *    - It is especially useful in routing systems, middleware, or frontend apps that need to\n *      decide layout, active navigation, or permissions based on the first segment (or prefix) of a pathname.\n * - **Typical uses include:**\n *    - Determining which layout to render (e.g., `/admin` vs `/dashboard` vs `/`).\n *    - Highlighting the active menu item in a sidebar based on the current URL.\n *    - Enforcing route guards or access controls depending on the URL prefix.\n *    - Parsing multi-level route prefixes and selecting the most relevant one.\n * - **Behavior:**\n *    - It works as follows:\n *        - If `result` is an array of strings, it normalizes each element and returns\n *          the first non-root path (i.e., not just `\"/\"`).\n *        - If all items normalize to `\"/\"`,\n *          it returns the `defaultValue` (normalized).\n *        - If `result` is a single string, it normalizes it and returns it if valid,\n *          otherwise falls back to the normalized `defaultValue`.\n *        - If `result` is `null` or `undefined`, it returns the normalized `defaultValue`.\n * - **Validation & Errors:**\n *    - Throws a `TypeError` if:\n *      - `defaultValue` is not a string or empty-string.\n *      - `result` is an array that contains non-string elements.\n *      - `result` is a value that is neither `string`, `string[]`, nor `null`.\n * @example\n * 1. #### For React (*Determining layout*):\n * ```ts\n *   const prefix = getFirstPrefixPathname(\n *      getPrefixPathname(\n *        \"/admin/settings\",\n *        [\"/admin\", \"/dashboard\"]\n *      )\n *   );\n *\n *   if (prefix === \"/admin\") {\n *     renderAdminLayout();\n *   }\n * ```\n *\n * 2. #### Setting active menu state:\n * ```ts\n *   const activeSection = getFirstPrefixPathname([\"\", \"/dashboard\", \"/profile\"]);\n *   // ➔ \"/dashboard\"\n * ```\n *\n * 3. #### Providing graceful fallback:\n * ```ts\n *   const section = getFirstPrefixPathname([], \"/home\");\n *   // ➔ \"/home\"\n * ```\n * 4. #### ✅ Using with an Array of Pathnames:\n * ```ts\n *   const result = getPrefixPathname([\"   \", \"/dashboard\", \"/settings\"]);\n *   console.log(getFirstPrefixPathname(result));\n *   // ➔ \"/dashboard\"\n * ```\n *\n * 5. #### ✅ Using with Single String:\n * ```ts\n *   console.log(getFirstPrefixPathname(\"/profile/settings\"));\n *   // ➔ \"/profile/settings\"\n *   console.log(getFirstPrefixPathname(\"   \"));\n *   // ➔ \"/\"\n * ```\n *\n * 6. #### ✅ Fallback to Custom Default:\n * ```ts\n *   console.log(getFirstPrefixPathname([\"   \", \"\"], \"/home\"));\n *   // ➔ \"/home\"\n *   console.log(getFirstPrefixPathname(null, \"/dashboard\"));\n *   // ➔ \"/dashboard\"\n * ```\n *\n * 7. #### ✅ Throws on Invalid Input:\n * ```ts\n *   getFirstPrefixPathname([1, 2] as any); // ➔ ❌ throws TypeError\n *   getFirstPrefixPathname({} as any);     // ➔ ❌ throws TypeError\n *   getFirstPrefixPathname(null, \"   \");   // ➔ ❌ throws TypeError\n * ```\n * @param {string | string[] | null | undefined} result\n *  ***The pathname(s) to process, can be:***\n *    - A string path (e.g. `\"/profile\"`),\n *    - An array of string paths (e.g. `[\"   \", \"/dashboard\"]`),\n *    - Or `null`.\n * @param {string} [defaultValue=\"/\"]\n *  ***A custom default path to use if `result` is null or no valid prefix is found, behavior:***\n *      - Must be a string and non-empty string.\n *      - Defaults to `\"/\"`.\n * @returns {string}\n *   ***The first valid normalized pathname, or the normalized default.***\n * @throws **{@link TypeError | `TypeError`}** ***if `result` is not a valid type, or `defaultValue` is not a string or empty-string.***\n */\nexport const getFirstPrefixPathname = (\n  result: string | string[] | null | undefined,\n  defaultValue: string = \"/\"\n): string => {\n  if (!isNonEmptyString(defaultValue)) {\n    throw new TypeError(\n      `Second parameter (\\`defaultValue\\`) must be of type \\`string\\` and not an \\`empty-string\\`, but received: \\`${getPreciseType(\n        defaultValue\n      )}\\`, with value: \\`${safeStableStringify(defaultValue, {\n        keepUndefined: true\n      })}\\`.`\n    );\n  }\n\n  if (isArray(result)) {\n    if (!result.every((item) => isString(item))) {\n      throw new TypeError(\n        `First parameter (\\`result\\`) must be of type \\`string\\` or \\`array of string\\`, but received: \\`${getPreciseType(\n          result\n        )}\\`, with value: \\`${safeStableStringify(result, {\n          keepUndefined: true\n        })}\\`.`\n      );\n    }\n\n    for (const item of result) {\n      const normalized = normalizePathname(item);\n      if (normalized !== \"/\") {\n        return normalized;\n      }\n    }\n    return normalizePathname(defaultValue);\n  }\n\n  if (isString(result)) {\n    const normalized = normalizePathname(result);\n    return normalized !== \"/\" ? normalized : normalizePathname(defaultValue);\n  }\n\n  if (!isNil(result)) {\n    throw new TypeError(\n      `First parameter (\\`result\\`) must be of type \\`string\\`, \\`array-string\\`, \\`null\\` or \\`undefined\\`, but received: \\`${getPreciseType(\n        result\n      )}\\`.`\n    );\n  }\n\n  return normalizePathname(defaultValue);\n};\n","import { joinLines, EOL } from \"@rzl-zone/build-tools/utils\";\n\nimport { isNull } from \"@/predicates/is/isNull\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isInteger } from \"@/predicates/is/isInteger\";\nimport { isBoolean } from \"@/predicates/is/isBoolean\";\nimport { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\nimport { isNonEmptyArray } from \"@/predicates/is/isNonEmptyArray\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\nimport { safeStableStringify } from \"@/conversions/stringify/safeStableStringify\";\n\nimport { normalizePathname } from \"./normalizePathname\";\n\ntype GetPrefixPathnameOptions = {\n  /** The number of levels to include in the prefix (default is `1`).\n   *\n   * - For example, with `levels = 2`, the function will return the first two parts of the URL.\n   *\n   * @default 1\n   */\n  levels?: number;\n  /** Whether to remove duplicates from the result if multiple URLs are passed (default is `true`).\n   *\n   * @default true\n   */\n  removeDuplicates?: boolean;\n};\n\n/** --------------------------------------------------------\n * * ***Utility: `getPrefixPathname`.***\n * --------------------------------------------------------\n * **Get Prefix from URL with Optional Base or Auto-detection (Supports String or Array of URLs).**\n * - **This function extracts the prefix from one or more URLs. It can either:**\n *    - Use a provided `base` string or an array of strings to check and return the matching prefix.\n *    - Automatically detect the prefix if no `base` is provided by analyzing the first part of the URL.\n * - **The function is flexible and can handle both scenarios:**\n *    1. **When the base is provided as a single string or an array of strings**:\n *        - The function will check if the URL starts with one of the provided base(s) and return the matching base.\n *    2. **When the base is not provided**:\n *        - The function will automatically detect the prefix by splitting the URL or using a regex.\n * - **Important Notes**:\n *    - If a base (or an array of bases) is provided, the URL must start with one of the given base(s).\n *    - If no base is provided, the function will attempt to detect the prefix automatically.\n *    - The `url` parameter can be either a string or an array of strings.\n *    - Supports deduplication of results (enabled by default).\n *    - Automatically returns a single string if only one unique result exists after processing.\n * @param {string|string[]} url\n *  ***The full URL(s) from which the prefix should be extracted, can be a `string` or an `array of strings`.***\n * @param {string|string[]|null} [base=null]\n *  ***The base URL(s) (e.g., `\"/settings\"`), behavior:***\n *    - It can be a `string`, an `array of strings`, or `null`.\n *    - If `provided`, it will be used to check the URL(s).\n *    - If `not provided`, the prefix will be auto-detected.\n * @param {GetPrefixPathnameOptions} [options]\n *  ***Additional options object:***\n *    - `levels` (default `1`): The number of segments to include when auto-detecting the prefix (e.g. `/foo/bar` for `levels: 2`).\n *    - `removeDuplicates` (default `true`): Whether to remove duplicate prefixes from the final array result.\n * @returns {string|string[]|null}\n *  ***Returns one of:***\n *    - A single string if only one unique prefix/base is found.\n *    - An array of strings if multiple different prefixes/bases are found.\n *    - `null` if no matching base is found when using `base`.\n * @throws **{@link TypeError | `TypeError`}**\n *  ***if:***\n *    - `url` is `not a string` or `not an array of strings`.\n *    - `base` is `not a string`, `array of strings`, or `null`.\n *    - `options` is `not an object`.\n *    - `levels` is `not a number`.\n *    - `removeDuplicates` is `not a boolean`.\n * @example\n * - #### ✅ **Correct Usage (With an Array of URLs and Base):**\n * ```ts\n *    const routes = [\n *      \"/settings/profile\",\n *      \"/settings/password\",\n *      \"/settings/other-path\",\n *      \"/other-path/xyz\",\n *    ];\n *\n *    // With base provided as a string\n *    routes.forEach(route => {\n *      console.log(getPrefixPathname(route, '/settings'));\n *      // ➔ \"/settings\"\n *    });\n *\n *    // With base provided as an array\n *    routes.forEach(route => {\n *      console.log(getPrefixPathname(route, ['/settings', '/admin']));\n *      // ➔ \"/settings\" or \"/admin\" depending on the current URL.\n *    });\n * ```\n * - #### ✅ **Correct Usage (With Single URL and Single Base):**\n * ```ts\n *    const result = getPrefixPathname(\"/settings/profile\", \"/settings\");\n *    console.log(result); // ➔ \"/settings\"\n * ```\n * - #### ✅ **Correct Usage (With Multiple URLs and Single Base):**\n * ```ts\n *    const result = getPrefixPathname(\n *      [\"/settings/profile\", \"/settings/password\"],\n *      \"/settings\"\n *    );\n *    console.log(result); // ➔ \"/settings\"\n *\n *    const result2 = getPrefixPathname(\n *      [\"/settings/profile\", \"/other/password\"],\n *      \"/other\"\n *    );\n *    console.log(result2); // ➔ \"/other\"\n * ```\n * - #### ✅ **Correct Usage (With Multiple URLs and Multiple Bases)**\n * ```ts\n *    const result = getPrefixPathname(\n *      [\"/settings/profile\", \"/admin/password\"],\n *      [\"/settings\", \"/admin\"]\n *    );\n *    console.log(result); // ➔ [\"/settings\", \"/admin\"]\n * ```\n * - #### ✅ **Auto-detection of Prefix**\n * ```ts\n *    const result = getPrefixPathname(\"/settings/profile\");\n *    console.log(result); // ➔ \"/settings\"\n *\n *    const result2 = getPrefixPathname(\n *      \"/settings/profile/info\",\n *      null,\n *      { levels: 2 }\n *    );\n *    console.log(result2); // ➔ \"/settings/profile\"\n * ```\n * - #### ✅ **Multiple URLs with Auto-detection**\n * ```ts\n *    const result = getPrefixPathname([\"/admin/profile\", \"/settings/password\"]);\n *    console.log(result); // ➔ [\"/admin\", \"/settings\"]\n * ```\n * - #### ✅ **Handling Duplicates**\n * ```ts\n *    const result = getPrefixPathname(\n *      [\"/settings/profile\", \"/settings/password\"],\n *      \"/settings\"\n *    );\n *    console.log(result); // ➔ \"/settings\" (deduped to single string)\n *\n *    const result2 = getPrefixPathname(\n *      [\"/settings/profile\", \"/settings/profile\"],\n *      \"/settings\",\n *      { removeDuplicates: false }\n *    );\n *    console.log(result2); // ➔ [\"/settings\", \"/settings\"]\n * ```\n * - #### ❌ **Incorrect Usage (URL Does Not Match Base)**\n * ```ts\n *    const result = getPrefixPathname(\"/other-path/profile\", \"/settings\");\n *    console.log(result); // ➔ null\n * ```\n */\nexport const getPrefixPathname = (\n  url: string | string[],\n  base: string | string[] | null = null,\n  options: GetPrefixPathnameOptions = {}\n): string | string[] | null => {\n  const errors: string[] = [];\n\n  if (!isString(url) && !isArray(url)) {\n    errors.push(\n      `First parameter (\\`url\\`) must be of type \\`string\\` or \\`array-string\\`, but received: \\`${getPreciseType(\n        url\n      )}\\`.`\n    );\n  }\n  if (!isString(base) && !isArray(base) && !isNull(base)) {\n    errors.push(\n      `Second parameter (\\`base\\`) must be of type \\`string\\`, \\`array-string\\` or \\`null\\`, but received: \\`${getPreciseType(\n        base\n      )}\\`.`\n    );\n  }\n  if (!isPlainObject(options)) {\n    errors.push(\n      `Second parameter (\\`options\\`) must be of type \\`plain-object\\`, but received: \\`${getPreciseType(\n        options\n      )}\\`.`\n    );\n  }\n\n  const { levels = 1, removeDuplicates = true } = options;\n\n  if (!isInteger(levels) || (isInteger(levels) && levels < 0)) {\n    errors.push(\n      `Parameter \\`levels\\` property of the \\`options\\` (second parameter) must be of type \\`integer-number\\` and minimum is \\`0\\`, but received: \\`${getPreciseType(\n        levels\n      )}\\`, with value: \\`${safeStableStringify(levels, {\n        keepUndefined: true\n      })}\\`.`\n    );\n  }\n  if (!isBoolean(removeDuplicates)) {\n    errors.push(\n      `Parameter \\`removeDuplicates\\` property of the \\`options\\` (second parameter) must be of type \\`boolean\\`, but received: \\`${getPreciseType(\n        removeDuplicates\n      )}\\`.`\n    );\n  }\n  if (isNonEmptyArray(errors)) {\n    throw new TypeError(\n      joinLines(\n        \"Invalid parameter(s) in `getPrefixPathname` function:\",\n        `- ${errors.join(`${EOL}- `)}`\n      )\n    );\n  }\n\n  // Helper function to process a single URL\n  function getLevel(singleUrl: string) {\n    // If no base is provided, detect the base automatically\n    const parts = normalizePathname(singleUrl).split(\"/\").filter(Boolean); // Split URL into parts\n\n    // Return the first `levels` parts as the prefix\n    return `/${parts.slice(0, levels).join(\"/\")}`;\n  }\n\n  // Helper function to process a single URL\n  function processUrl(singleUrl: string): string | null {\n    // If a base is provided, check if URL starts with one of the bases\n    if (base) {\n      singleUrl = normalizePathname(singleUrl);\n\n      if (isArray(base)) {\n        // Check if the URL starts with any of the base values in the array\n        for (const b of base) {\n          if (singleUrl.startsWith(normalizePathname(b))) {\n            // return normalizePathname(b); // Return the matching base if URL starts with it\n            return getLevel(singleUrl);\n          }\n        }\n      } else if (\n        isNonEmptyString(base) &&\n        singleUrl.startsWith(normalizePathname(base))\n      ) {\n        // If base is a single string, check if URL starts with it\n        // return normalizePathname(base); // Return the base if URL starts with it\n        return getLevel(singleUrl);\n      }\n      return null; // Return null if the URL does not match any base\n    }\n\n    return getLevel(singleUrl);\n  }\n\n  // If url is an array, process each URL and return an array of results\n  if (isArray(url)) {\n    const result = url.map(processUrl).filter((r): r is string => !isNull(r));\n\n    // Remove duplicates if required\n    const uniqueResult = removeDuplicates ? [...new Set(result)] : result;\n\n    // If all results are the same, return just the first one\n    if (uniqueResult.length === 1) {\n      return uniqueResult[0] ?? null;\n    }\n\n    return uniqueResult;\n  }\n\n  // If url is a single string, process it and return the result\n  return processUrl(url);\n};\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rzl-zone/utils-js",
-  "version": "3.12.1-beta.0",
+  "version": "3.12.1-beta.1",
   "description": "A modern, lightweight set of JavaScript utility functions with TypeScript support for everyday development, crafted to enhance code readability and maintainability.",
   "license": "MIT",
   "unpkg": "./dist/rzl-utils.global.js",
@@ -211,7 +211,7 @@
     "tailwind-merge-v3": "npm:tailwind-merge@2.6.0",
     "tailwind-merge-v4": "npm:tailwind-merge@3.3.1",
     "@rzl-zone/node-only": "0.0.10-beta.0",
-    "@rzl-zone/ts-types-plus": "0.1.6-beta.0"
+    "@rzl-zone/ts-types-plus": "0.1.6-beta.1"
   },
   "devDependencies": {
     "@eslint/js": "^10",