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

package/dist/{toStringArrayUnRecursive-C4zYCja7.cjs → toStringArrayUnRecursive-D1mPM4wg.cjs}

@@ -2,16 +2,16 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.1`
+*  Version: `3.13.0-beta.2`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 "use strict";
-const require_assertIsBoolean = require('./assertIsBoolean-C8WEXVr2.cjs');
-const require_isBigInt = require('./isBigInt-C4krUeAw.cjs');
-const require_isEmptyObject = require('./isEmptyObject-ZkSwRC_D.cjs');
-const require_isFinite = require('./isFinite-D24ZaE6c.cjs');
+const require_assertIsBoolean = require('./assertIsBoolean-amRiJHnh.cjs');
+const require_isBigInt = require('./isBigInt-CIFRnsdx.cjs');
+const require_isEmptyObject = require('./isEmptyObject-CEySmyHK.cjs');
+const require_isFinite = require('./isFinite-uukWvxJh.cjs');
 function filterNilArray(input) {
 	if (require_assertIsBoolean.isNil(input)) return void 0;
 	if (!require_assertIsBoolean.isArray(input)) return [];
@@ -48,4 +48,4 @@ Object.defineProperty(exports, 'toStringArrayUnRecursive', {
     return toStringArrayUnRecursive;
   }
 });
-//# sourceMappingURL=toStringArrayUnRecursive-C4zYCja7.cjs.map
+//# sourceMappingURL=toStringArrayUnRecursive-D1mPM4wg.cjs.map

package/dist/{toStringArrayUnRecursive-C4zYCja7.cjs.map → toStringArrayUnRecursive-D1mPM4wg.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"toStringArrayUnRecursive-C4zYCja7.cjs","names":["isNil","isArray","isEmptyArray","hasOwnProp","isArray","isString","isFinite","isBoolean","isBigInt","isNull"],"sources":["../src/conversions/arrays/transforms/filterNilArray.ts","../src/conversions/arrays/casts/toStringArrayUnRecursive.ts"],"sourcesContent":["import type {\n  FilterNilArray,\n  FilterNilArrayFromTuple,\n  PreserveMutability\n} from \"./_private/filterNilArray.types\";\n\nimport { isNil } from \"@/predicates/is/isNil\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isEmptyArray } from \"@/predicates/is/isEmptyArray\";\n\n/** ----------------------------------------------------------\n * * ***Utility: `filterNilArray`.***\n * ---------------------------------------------\n * **Removes `null` and `undefined` values from an array, including nested arrays.**\n * - **Behavior:**\n *    - Returns `undefined` if the input is explicitly `undefined` or `null`.\n *    - Returns `[]` if input is empty or all elements are removed after filtering.\n *    - Recursively filters nested arrays while preserving structure.\n *    - Ensures proper type inference for safer downstream operations.\n * @template A - The type of elements in the array.\n * @param {T[]|null|undefined} input - The array to be filtered.\n * @returns {T[] | undefined} A new array with `null` and `undefined` values removed,\n * or `undefined` if the input is explicitly `undefined` or `null`.\n * @example\n * ```ts\n * filterNilArray([1, null, 2, undefined, 3]);\n * // ➔ [1, 2, 3]\n * filterNilArray([null, undefined]);\n * // ➔ []\n * filterNilArray(undefined);\n * // ➔ undefined\n * filterNilArray(null);\n * // ➔ undefined\n * filterNilArray([]); // or\n * filterNilArray([[[]]]); // or\n * filterNilArray([[[],undefined,null]]);\n * // ➔ []\n * filterNilArray([1, [null, 2, [undefined, 3]]]);\n * // ➔ [1, [2, [3]]]\n * ```\n */\nexport function filterNilArray(input: null | undefined): undefined;\nexport function filterNilArray<A extends readonly unknown[]>(\n  input: A\n): PreserveMutability<A, FilterNilArrayFromTuple<A>>;\nexport function filterNilArray<A extends readonly unknown[]>(\n  input: A | null | undefined\n): PreserveMutability<A, FilterNilArrayFromTuple<A>> | undefined;\nexport function filterNilArray<A>(\n  input: (A | null | undefined)[] | null | undefined\n): FilterNilArray<A> | undefined;\nexport function filterNilArray(\n  input: readonly unknown[] | null | undefined\n): unknown[] | undefined;\nexport function filterNilArray(input: unknown[]): unknown[];\nexport function filterNilArray(input: unknown): unknown {\n  if (isNil(input)) return undefined;\n  if (!isArray(input)) return [];\n\n  const filtered = input.reduce<unknown[]>((output, element) => {\n    if (!isNil(element)) {\n      if (isArray(element)) {\n        const cleanedNested = filterNilArray(element);\n        if (cleanedNested && !isEmptyArray(cleanedNested)) {\n          output.push(cleanedNested);\n        }\n      } else {\n        output.push(element);\n      }\n    }\n    return output;\n  }, []);\n\n  return filtered;\n}\n","import type {\n  ToStringArrayUnRecursiveOptions,\n  ToStringArrayUnRecursiveReturn\n} from \"./toStringArrayUnRecursive.types\";\n\nimport { isNull } from \"@/predicates/is/isNull\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isFinite } from \"@/predicates/is/isFinite\";\nimport { isBigInt } from \"@/predicates/is/isBigInt\";\nimport { isBoolean } from \"@/predicates/is/isBoolean\";\nimport { hasOwnProp } from \"@/predicates/has/hasOwnProp\";\nimport { assertIsBoolean } from \"@/assertions/booleans/assertIsBoolean\";\nimport { assertIsPlainObject } from \"@/assertions/objects/assertIsPlainObject\";\n\nimport { filterNilArray } from \"../transforms/filterNilArray\";\n\n/** ---------------------------------------------\n * * ***Utility: `toStringArrayUnRecursive`.***\n * ---------------------------------------------\n * **Converts all values in a flat array into string representations.**\n * - **Behavior:**\n *    - Only processes **flat arrays** (non-recursive).\n *    - Supports input values: `string`, `number`, `bigint`, `boolean`,\n *      `null`, `undefined`.\n *    - Invalid values (`null` and `undefined`) can be **removed** or **kept**\n *      depending on the option.\n *    - Other unsupported types will be converted to `undefined` (and removed\n *      if `removeInvalidValue=true`).\n * - **ℹ️ Note:**\n *    - _For recursive / nested arrays, use ***`toStringDeep` utility function*** instead._\n * @template T - Element type of the input array.\n * @template R - Whether invalid values should be removed (`true`) or kept (`false`).\n * @param {Array<string | number | bigint | boolean | null | undefined> | null | undefined} [array] - The array to convert, returns `undefined` if not an array.\n * @param {ToStringArrayUnRecursiveOptions<RemoveInvalidValue>} [options] - Options to control transformation behavior, defaults to `{ removeInvalidValue: true }`.\n * @param {RemoveInvalidValue extends true ? boolean : boolean} [options.removeInvalidValue=true] Whether to remove invalid values (`null`, `undefined`, or unsupported types), default: `true`.\n * @returns {RemoveInvalidValue extends true ? string[] : (string | null | undefined)[]} A new array of string representations, with invalid values optionally removed.\n * @example\n * ```ts\n * // Convert numbers and strings\n * toStringArrayUnRecursive([1, 2, '3']);\n * // ➔ ['1', '2', '3']\n * // Remove null and undefined\n * toStringArrayUnRecursive([1, null, undefined, 'abc'], {\n *   removeInvalidValue: true\n * });\n * // ➔ ['1', 'abc']\n * // Keep null and undefined\n * toStringArrayUnRecursive([1, null, undefined, 'abc'], {\n *   removeInvalidValue: false\n * });\n * // ➔ ['1', null, undefined, 'abc']\n * // Convert boolean and bigint\n * toStringArrayUnRecursive([true, false, 10n]);\n * // ➔ ['true', 'false', '10']\n * // Not an array ➔ returns undefined\n * toStringArrayUnRecursive(null);\n * // ➔ undefined\n * toStringArrayUnRecursive(undefined);\n * // ➔ undefined\n * toStringArrayUnRecursive(1);\n * // ➔ undefined\n * toStringArrayUnRecursive(\"string\");\n * // ➔ undefined\n * ```\n */\nexport function toStringArrayUnRecursive(\n  array?: undefined | null,\n  options?: ToStringArrayUnRecursiveOptions<boolean>\n): undefined;\nexport function toStringArrayUnRecursive(\n  array?: Array<never>,\n  options?: ToStringArrayUnRecursiveOptions<boolean>\n): [];\nexport function toStringArrayUnRecursive<T, R extends boolean = true>(\n  array?: Array<T> | readonly T[] | null,\n  options?: ToStringArrayUnRecursiveOptions<R>\n): ToStringArrayUnRecursiveReturn<T, R>;\nexport function toStringArrayUnRecursive<T = unknown>(\n  array?: T,\n  options?: ToStringArrayUnRecursiveOptions<boolean>\n): undefined;\nexport function toStringArrayUnRecursive<T>(\n  array?: Array<T> | readonly T[] | null,\n  options: ToStringArrayUnRecursiveOptions<boolean> = {}\n) {\n  assertIsPlainObject(options, {\n    message: ({ currentType, validType }) =>\n      `Second parameter (\\`options\\`) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  const riv = hasOwnProp(options, \"removeInvalidValue\")\n    ? options.removeInvalidValue\n    : true;\n\n  assertIsBoolean(riv, {\n    message: ({ currentType, validType }) =>\n      `Parameter \\`removeInvalidValue\\` property of the \\`options\\` (second parameter) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  if (isArray(array)) {\n    // Convert each item in the array to a string, or null/undefined if it's not a valid value.\n    const result = Array.from(array, (x) => {\n      // Convert finite number, boolean, bigInt or string to string\n      if (isString(x) || isFinite(x) || isBoolean(x) || isBigInt(x))\n        return String(x);\n\n      // Handle null or undefined values\n      return isNull(x) ? null : undefined;\n    });\n\n    // Remove invalid values (null, undefined) if specified in options\n    if (riv) return filterNilArray(result);\n\n    return result;\n  }\n\n  // Return undefined if no array is provided\n  return undefined;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAuDA,SAAgB,eAAe,OAAyB;CACtD,IAAIA,8BAAM,MAAM,EAAE,OAAO;CACzB,IAAI,CAACC,gCAAQ,MAAM,EAAE,OAAO,EAAE;CAgB9B,OAdiB,MAAM,QAAmB,QAAQ,YAAY;EAC5D,IAAI,CAACD,8BAAM,QAAQ,EACjB,IAAIC,gCAAQ,QAAQ,EAAE;GACpB,MAAM,gBAAgB,eAAe,QAAQ;GAC7C,IAAI,iBAAiB,CAACC,mCAAa,cAAc,EAC/C,OAAO,KAAK,cAAc;SAG5B,OAAO,KAAK,QAAQ;EAGxB,OAAO;IACN,EAAE,CAEU;;;;;ACSjB,SAAgB,yBACd,OACA,UAAoD,EAAE,EACtD;CACA,4CAAoB,SAAS,EAC3B,UAAU,EAAE,aAAa,gBACvB,oDAAoD,UAAU,sBAAsB,YAAY,MACnG,CAAC;CAEF,MAAM,MAAMC,mCAAW,SAAS,qBAAqB,GACjD,QAAQ,qBACR;CAEJ,wCAAgB,KAAK,EACnB,UAAU,EAAE,aAAa,gBACvB,qGAAqG,UAAU,sBAAsB,YAAY,MACpJ,CAAC;CAEF,IAAIC,gCAAQ,MAAM,EAAE;EAElB,MAAM,SAAS,MAAM,KAAK,QAAQ,MAAM;GAEtC,IAAIC,iCAAS,EAAE,IAAIC,0BAAS,EAAE,IAAIC,kCAAU,EAAE,IAAIC,0BAAS,EAAE,EAC3D,OAAO,OAAO,EAAE;GAGlB,OAAOC,+BAAO,EAAE,GAAG,OAAO;IAC1B;EAGF,IAAI,KAAK,OAAO,eAAe,OAAO;EAEtC,OAAO"}
+{"version":3,"file":"toStringArrayUnRecursive-D1mPM4wg.cjs","names":["isNil","isArray","isEmptyArray","hasOwnProp","isArray","isString","isFinite","isBoolean","isBigInt","isNull"],"sources":["../src/conversions/arrays/transforms/filterNilArray.ts","../src/conversions/arrays/casts/toStringArrayUnRecursive.ts"],"sourcesContent":["import type {\n  FilterNilArray,\n  FilterNilArrayFromTuple,\n  PreserveMutability\n} from \"./_private/filterNilArray.types\";\n\nimport { isNil } from \"@/predicates/is/isNil\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isEmptyArray } from \"@/predicates/is/isEmptyArray\";\n\n/** ----------------------------------------------------------\n * * ***Utility: `filterNilArray`.***\n * ---------------------------------------------\n * **Removes `null` and `undefined` values from an array, including nested arrays.**\n * - **Behavior:**\n *    - Returns `undefined` if the input is explicitly `undefined` or `null`.\n *    - Returns `[]` if input is empty or all elements are removed after filtering.\n *    - Recursively filters nested arrays while preserving structure.\n *    - Ensures proper type inference for safer downstream operations.\n * @template A - The type of elements in the array.\n * @param {T[]|null|undefined} input - The array to be filtered.\n * @returns {T[] | undefined} A new array with `null` and `undefined` values removed,\n * or `undefined` if the input is explicitly `undefined` or `null`.\n * @example\n * ```ts\n * filterNilArray([1, null, 2, undefined, 3]);\n * // ➔ [1, 2, 3]\n * filterNilArray([null, undefined]);\n * // ➔ []\n * filterNilArray(undefined);\n * // ➔ undefined\n * filterNilArray(null);\n * // ➔ undefined\n * filterNilArray([]); // or\n * filterNilArray([[[]]]); // or\n * filterNilArray([[[],undefined,null]]);\n * // ➔ []\n * filterNilArray([1, [null, 2, [undefined, 3]]]);\n * // ➔ [1, [2, [3]]]\n * ```\n */\nexport function filterNilArray(input: null | undefined): undefined;\nexport function filterNilArray<A extends readonly unknown[]>(\n  input: A\n): PreserveMutability<A, FilterNilArrayFromTuple<A>>;\nexport function filterNilArray<A extends readonly unknown[]>(\n  input: A | null | undefined\n): PreserveMutability<A, FilterNilArrayFromTuple<A>> | undefined;\nexport function filterNilArray<A>(\n  input: (A | null | undefined)[] | null | undefined\n): FilterNilArray<A> | undefined;\nexport function filterNilArray(\n  input: readonly unknown[] | null | undefined\n): unknown[] | undefined;\nexport function filterNilArray(input: unknown[]): unknown[];\nexport function filterNilArray(input: unknown): unknown {\n  if (isNil(input)) return undefined;\n  if (!isArray(input)) return [];\n\n  const filtered = input.reduce<unknown[]>((output, element) => {\n    if (!isNil(element)) {\n      if (isArray(element)) {\n        const cleanedNested = filterNilArray(element);\n        if (cleanedNested && !isEmptyArray(cleanedNested)) {\n          output.push(cleanedNested);\n        }\n      } else {\n        output.push(element);\n      }\n    }\n    return output;\n  }, []);\n\n  return filtered;\n}\n","import type {\n  ToStringArrayUnRecursiveOptions,\n  ToStringArrayUnRecursiveReturn\n} from \"./toStringArrayUnRecursive.types\";\n\nimport { isNull } from \"@/predicates/is/isNull\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isFinite } from \"@/predicates/is/isFinite\";\nimport { isBigInt } from \"@/predicates/is/isBigInt\";\nimport { isBoolean } from \"@/predicates/is/isBoolean\";\nimport { hasOwnProp } from \"@/predicates/has/hasOwnProp\";\nimport { assertIsBoolean } from \"@/assertions/booleans/assertIsBoolean\";\nimport { assertIsPlainObject } from \"@/assertions/objects/assertIsPlainObject\";\n\nimport { filterNilArray } from \"../transforms/filterNilArray\";\n\n/** ---------------------------------------------\n * * ***Utility: `toStringArrayUnRecursive`.***\n * ---------------------------------------------\n * **Converts all values in a flat array into string representations.**\n * - **Behavior:**\n *    - Only processes **flat arrays** (non-recursive).\n *    - Supports input values: `string`, `number`, `bigint`, `boolean`,\n *      `null`, `undefined`.\n *    - Invalid values (`null` and `undefined`) can be **removed** or **kept**\n *      depending on the option.\n *    - Other unsupported types will be converted to `undefined` (and removed\n *      if `removeInvalidValue=true`).\n * - **ℹ️ Note:**\n *    - _For recursive / nested arrays, use ***`toStringDeep` utility function*** instead._\n * @template T - Element type of the input array.\n * @template R - Whether invalid values should be removed (`true`) or kept (`false`).\n * @param {Array<string | number | bigint | boolean | null | undefined> | null | undefined} [array] - The array to convert, returns `undefined` if not an array.\n * @param {ToStringArrayUnRecursiveOptions<RemoveInvalidValue>} [options] - Options to control transformation behavior, defaults to `{ removeInvalidValue: true }`.\n * @param {RemoveInvalidValue extends true ? boolean : boolean} [options.removeInvalidValue=true] Whether to remove invalid values (`null`, `undefined`, or unsupported types), default: `true`.\n * @returns {RemoveInvalidValue extends true ? string[] : (string | null | undefined)[]} A new array of string representations, with invalid values optionally removed.\n * @example\n * ```ts\n * // Convert numbers and strings\n * toStringArrayUnRecursive([1, 2, '3']);\n * // ➔ ['1', '2', '3']\n * // Remove null and undefined\n * toStringArrayUnRecursive([1, null, undefined, 'abc'], {\n *   removeInvalidValue: true\n * });\n * // ➔ ['1', 'abc']\n * // Keep null and undefined\n * toStringArrayUnRecursive([1, null, undefined, 'abc'], {\n *   removeInvalidValue: false\n * });\n * // ➔ ['1', null, undefined, 'abc']\n * // Convert boolean and bigint\n * toStringArrayUnRecursive([true, false, 10n]);\n * // ➔ ['true', 'false', '10']\n * // Not an array ➔ returns undefined\n * toStringArrayUnRecursive(null);\n * // ➔ undefined\n * toStringArrayUnRecursive(undefined);\n * // ➔ undefined\n * toStringArrayUnRecursive(1);\n * // ➔ undefined\n * toStringArrayUnRecursive(\"string\");\n * // ➔ undefined\n * ```\n */\nexport function toStringArrayUnRecursive(\n  array?: undefined | null,\n  options?: ToStringArrayUnRecursiveOptions<boolean>\n): undefined;\nexport function toStringArrayUnRecursive(\n  array?: Array<never>,\n  options?: ToStringArrayUnRecursiveOptions<boolean>\n): [];\nexport function toStringArrayUnRecursive<T, R extends boolean = true>(\n  array?: Array<T> | readonly T[] | null,\n  options?: ToStringArrayUnRecursiveOptions<R>\n): ToStringArrayUnRecursiveReturn<T, R>;\nexport function toStringArrayUnRecursive<T = unknown>(\n  array?: T,\n  options?: ToStringArrayUnRecursiveOptions<boolean>\n): undefined;\nexport function toStringArrayUnRecursive<T>(\n  array?: Array<T> | readonly T[] | null,\n  options: ToStringArrayUnRecursiveOptions<boolean> = {}\n) {\n  assertIsPlainObject(options, {\n    message: ({ currentType, validType }) =>\n      `Second parameter (\\`options\\`) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  const riv = hasOwnProp(options, \"removeInvalidValue\")\n    ? options.removeInvalidValue\n    : true;\n\n  assertIsBoolean(riv, {\n    message: ({ currentType, validType }) =>\n      `Parameter \\`removeInvalidValue\\` property of the \\`options\\` (second parameter) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  if (isArray(array)) {\n    // Convert each item in the array to a string, or null/undefined if it's not a valid value.\n    const result = Array.from(array, (x) => {\n      // Convert finite number, boolean, bigInt or string to string\n      if (isString(x) || isFinite(x) || isBoolean(x) || isBigInt(x))\n        return String(x);\n\n      // Handle null or undefined values\n      return isNull(x) ? null : undefined;\n    });\n\n    // Remove invalid values (null, undefined) if specified in options\n    if (riv) return filterNilArray(result);\n\n    return result;\n  }\n\n  // Return undefined if no array is provided\n  return undefined;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAuDA,SAAgB,eAAe,OAAyB;CACtD,IAAIA,8BAAM,MAAM,EAAE,OAAO;CACzB,IAAI,CAACC,gCAAQ,MAAM,EAAE,OAAO,EAAE;CAgB9B,OAdiB,MAAM,QAAmB,QAAQ,YAAY;EAC5D,IAAI,CAACD,8BAAM,QAAQ,EACjB,IAAIC,gCAAQ,QAAQ,EAAE;GACpB,MAAM,gBAAgB,eAAe,QAAQ;GAC7C,IAAI,iBAAiB,CAACC,mCAAa,cAAc,EAC/C,OAAO,KAAK,cAAc;SAG5B,OAAO,KAAK,QAAQ;EAGxB,OAAO;IACN,EAAE,CAEU;;;;;ACSjB,SAAgB,yBACd,OACA,UAAoD,EAAE,EACtD;CACA,4CAAoB,SAAS,EAC3B,UAAU,EAAE,aAAa,gBACvB,oDAAoD,UAAU,sBAAsB,YAAY,MACnG,CAAC;CAEF,MAAM,MAAMC,mCAAW,SAAS,qBAAqB,GACjD,QAAQ,qBACR;CAEJ,wCAAgB,KAAK,EACnB,UAAU,EAAE,aAAa,gBACvB,qGAAqG,UAAU,sBAAsB,YAAY,MACpJ,CAAC;CAEF,IAAIC,gCAAQ,MAAM,EAAE;EAElB,MAAM,SAAS,MAAM,KAAK,QAAQ,MAAM;GAEtC,IAAIC,iCAAS,EAAE,IAAIC,0BAAS,EAAE,IAAIC,kCAAU,EAAE,IAAIC,0BAAS,EAAE,EAC3D,OAAO,OAAO,EAAE;GAGlB,OAAOC,+BAAO,EAAE,GAAG,OAAO;IAC1B;EAGF,IAAI,KAAK,OAAO,eAAe,OAAO;EAEtC,OAAO"}

package/dist/{toStringArrayUnRecursive-DJGtPsFb.js → toStringArrayUnRecursive-tHp2a7KR.js}

@@ -2,15 +2,15 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.1`
+*  Version: `3.13.0-beta.2`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
-import { E as isNull, F as isBoolean, M as isArray, N as isNil, T as assertIsPlainObject, b as hasOwnProp, k as isString, t as assertIsBoolean } from "./assertIsBoolean-DR1SaXPD.js";
-import { t as isBigInt } from "./isBigInt-DKe0M6hp.js";
-import { n as isEmptyArray } from "./isEmptyObject-DCipFwxJ.js";
-import { t as isFinite } from "./isFinite-BCnaDpod.js";
+import { E as isNull, F as isBoolean, M as isArray, N as isNil, T as assertIsPlainObject, b as hasOwnProp, k as isString, t as assertIsBoolean } from "./assertIsBoolean-Bv6gL-xe.js";
+import { t as isBigInt } from "./isBigInt-D-Pu9sxp.js";
+import { n as isEmptyArray } from "./isEmptyObject-CZ9DLi7R.js";
+import { t as isFinite } from "./isFinite-Cz_IFXuV.js";
 function filterNilArray(input) {
 	if (isNil(input)) return void 0;
 	if (!isArray(input)) return [];
@@ -36,4 +36,4 @@ function toStringArrayUnRecursive(array, options = {}) {
 	}
 }
 export { filterNilArray as n, toStringArrayUnRecursive as t };
-//# sourceMappingURL=toStringArrayUnRecursive-DJGtPsFb.js.map
+//# sourceMappingURL=toStringArrayUnRecursive-tHp2a7KR.js.map

package/dist/{toStringArrayUnRecursive-DJGtPsFb.js.map → toStringArrayUnRecursive-tHp2a7KR.js.map}

@@ -1 +1 @@
-{"version":3,"file":"toStringArrayUnRecursive-DJGtPsFb.js","names":[],"sources":["../src/conversions/arrays/transforms/filterNilArray.ts","../src/conversions/arrays/casts/toStringArrayUnRecursive.ts"],"sourcesContent":["import type {\n  FilterNilArray,\n  FilterNilArrayFromTuple,\n  PreserveMutability\n} from \"./_private/filterNilArray.types\";\n\nimport { isNil } from \"@/predicates/is/isNil\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isEmptyArray } from \"@/predicates/is/isEmptyArray\";\n\n/** ----------------------------------------------------------\n * * ***Utility: `filterNilArray`.***\n * ---------------------------------------------\n * **Removes `null` and `undefined` values from an array, including nested arrays.**\n * - **Behavior:**\n *    - Returns `undefined` if the input is explicitly `undefined` or `null`.\n *    - Returns `[]` if input is empty or all elements are removed after filtering.\n *    - Recursively filters nested arrays while preserving structure.\n *    - Ensures proper type inference for safer downstream operations.\n * @template A - The type of elements in the array.\n * @param {T[]|null|undefined} input - The array to be filtered.\n * @returns {T[] | undefined} A new array with `null` and `undefined` values removed,\n * or `undefined` if the input is explicitly `undefined` or `null`.\n * @example\n * ```ts\n * filterNilArray([1, null, 2, undefined, 3]);\n * // ➔ [1, 2, 3]\n * filterNilArray([null, undefined]);\n * // ➔ []\n * filterNilArray(undefined);\n * // ➔ undefined\n * filterNilArray(null);\n * // ➔ undefined\n * filterNilArray([]); // or\n * filterNilArray([[[]]]); // or\n * filterNilArray([[[],undefined,null]]);\n * // ➔ []\n * filterNilArray([1, [null, 2, [undefined, 3]]]);\n * // ➔ [1, [2, [3]]]\n * ```\n */\nexport function filterNilArray(input: null | undefined): undefined;\nexport function filterNilArray<A extends readonly unknown[]>(\n  input: A\n): PreserveMutability<A, FilterNilArrayFromTuple<A>>;\nexport function filterNilArray<A extends readonly unknown[]>(\n  input: A | null | undefined\n): PreserveMutability<A, FilterNilArrayFromTuple<A>> | undefined;\nexport function filterNilArray<A>(\n  input: (A | null | undefined)[] | null | undefined\n): FilterNilArray<A> | undefined;\nexport function filterNilArray(\n  input: readonly unknown[] | null | undefined\n): unknown[] | undefined;\nexport function filterNilArray(input: unknown[]): unknown[];\nexport function filterNilArray(input: unknown): unknown {\n  if (isNil(input)) return undefined;\n  if (!isArray(input)) return [];\n\n  const filtered = input.reduce<unknown[]>((output, element) => {\n    if (!isNil(element)) {\n      if (isArray(element)) {\n        const cleanedNested = filterNilArray(element);\n        if (cleanedNested && !isEmptyArray(cleanedNested)) {\n          output.push(cleanedNested);\n        }\n      } else {\n        output.push(element);\n      }\n    }\n    return output;\n  }, []);\n\n  return filtered;\n}\n","import type {\n  ToStringArrayUnRecursiveOptions,\n  ToStringArrayUnRecursiveReturn\n} from \"./toStringArrayUnRecursive.types\";\n\nimport { isNull } from \"@/predicates/is/isNull\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isFinite } from \"@/predicates/is/isFinite\";\nimport { isBigInt } from \"@/predicates/is/isBigInt\";\nimport { isBoolean } from \"@/predicates/is/isBoolean\";\nimport { hasOwnProp } from \"@/predicates/has/hasOwnProp\";\nimport { assertIsBoolean } from \"@/assertions/booleans/assertIsBoolean\";\nimport { assertIsPlainObject } from \"@/assertions/objects/assertIsPlainObject\";\n\nimport { filterNilArray } from \"../transforms/filterNilArray\";\n\n/** ---------------------------------------------\n * * ***Utility: `toStringArrayUnRecursive`.***\n * ---------------------------------------------\n * **Converts all values in a flat array into string representations.**\n * - **Behavior:**\n *    - Only processes **flat arrays** (non-recursive).\n *    - Supports input values: `string`, `number`, `bigint`, `boolean`,\n *      `null`, `undefined`.\n *    - Invalid values (`null` and `undefined`) can be **removed** or **kept**\n *      depending on the option.\n *    - Other unsupported types will be converted to `undefined` (and removed\n *      if `removeInvalidValue=true`).\n * - **ℹ️ Note:**\n *    - _For recursive / nested arrays, use ***`toStringDeep` utility function*** instead._\n * @template T - Element type of the input array.\n * @template R - Whether invalid values should be removed (`true`) or kept (`false`).\n * @param {Array<string | number | bigint | boolean | null | undefined> | null | undefined} [array] - The array to convert, returns `undefined` if not an array.\n * @param {ToStringArrayUnRecursiveOptions<RemoveInvalidValue>} [options] - Options to control transformation behavior, defaults to `{ removeInvalidValue: true }`.\n * @param {RemoveInvalidValue extends true ? boolean : boolean} [options.removeInvalidValue=true] Whether to remove invalid values (`null`, `undefined`, or unsupported types), default: `true`.\n * @returns {RemoveInvalidValue extends true ? string[] : (string | null | undefined)[]} A new array of string representations, with invalid values optionally removed.\n * @example\n * ```ts\n * // Convert numbers and strings\n * toStringArrayUnRecursive([1, 2, '3']);\n * // ➔ ['1', '2', '3']\n * // Remove null and undefined\n * toStringArrayUnRecursive([1, null, undefined, 'abc'], {\n *   removeInvalidValue: true\n * });\n * // ➔ ['1', 'abc']\n * // Keep null and undefined\n * toStringArrayUnRecursive([1, null, undefined, 'abc'], {\n *   removeInvalidValue: false\n * });\n * // ➔ ['1', null, undefined, 'abc']\n * // Convert boolean and bigint\n * toStringArrayUnRecursive([true, false, 10n]);\n * // ➔ ['true', 'false', '10']\n * // Not an array ➔ returns undefined\n * toStringArrayUnRecursive(null);\n * // ➔ undefined\n * toStringArrayUnRecursive(undefined);\n * // ➔ undefined\n * toStringArrayUnRecursive(1);\n * // ➔ undefined\n * toStringArrayUnRecursive(\"string\");\n * // ➔ undefined\n * ```\n */\nexport function toStringArrayUnRecursive(\n  array?: undefined | null,\n  options?: ToStringArrayUnRecursiveOptions<boolean>\n): undefined;\nexport function toStringArrayUnRecursive(\n  array?: Array<never>,\n  options?: ToStringArrayUnRecursiveOptions<boolean>\n): [];\nexport function toStringArrayUnRecursive<T, R extends boolean = true>(\n  array?: Array<T> | readonly T[] | null,\n  options?: ToStringArrayUnRecursiveOptions<R>\n): ToStringArrayUnRecursiveReturn<T, R>;\nexport function toStringArrayUnRecursive<T = unknown>(\n  array?: T,\n  options?: ToStringArrayUnRecursiveOptions<boolean>\n): undefined;\nexport function toStringArrayUnRecursive<T>(\n  array?: Array<T> | readonly T[] | null,\n  options: ToStringArrayUnRecursiveOptions<boolean> = {}\n) {\n  assertIsPlainObject(options, {\n    message: ({ currentType, validType }) =>\n      `Second parameter (\\`options\\`) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  const riv = hasOwnProp(options, \"removeInvalidValue\")\n    ? options.removeInvalidValue\n    : true;\n\n  assertIsBoolean(riv, {\n    message: ({ currentType, validType }) =>\n      `Parameter \\`removeInvalidValue\\` property of the \\`options\\` (second parameter) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  if (isArray(array)) {\n    // Convert each item in the array to a string, or null/undefined if it's not a valid value.\n    const result = Array.from(array, (x) => {\n      // Convert finite number, boolean, bigInt or string to string\n      if (isString(x) || isFinite(x) || isBoolean(x) || isBigInt(x))\n        return String(x);\n\n      // Handle null or undefined values\n      return isNull(x) ? null : undefined;\n    });\n\n    // Remove invalid values (null, undefined) if specified in options\n    if (riv) return filterNilArray(result);\n\n    return result;\n  }\n\n  // Return undefined if no array is provided\n  return undefined;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAuDA,SAAgB,eAAe,OAAyB;CACtD,IAAI,MAAM,MAAM,EAAE,OAAO;CACzB,IAAI,CAAC,QAAQ,MAAM,EAAE,OAAO,EAAE;CAgB9B,OAdiB,MAAM,QAAmB,QAAQ,YAAY;EAC5D,IAAI,CAAC,MAAM,QAAQ,EACjB,IAAI,QAAQ,QAAQ,EAAE;GACpB,MAAM,gBAAgB,eAAe,QAAQ;GAC7C,IAAI,iBAAiB,CAAC,aAAa,cAAc,EAC/C,OAAO,KAAK,cAAc;SAG5B,OAAO,KAAK,QAAQ;EAGxB,OAAO;IACN,EAAE,CAEU;;;;;ACSjB,SAAgB,yBACd,OACA,UAAoD,EAAE,EACtD;CACA,oBAAoB,SAAS,EAC3B,UAAU,EAAE,aAAa,gBACvB,oDAAoD,UAAU,sBAAsB,YAAY,MACnG,CAAC;CAEF,MAAM,MAAM,WAAW,SAAS,qBAAqB,GACjD,QAAQ,qBACR;CAEJ,gBAAgB,KAAK,EACnB,UAAU,EAAE,aAAa,gBACvB,qGAAqG,UAAU,sBAAsB,YAAY,MACpJ,CAAC;CAEF,IAAI,QAAQ,MAAM,EAAE;EAElB,MAAM,SAAS,MAAM,KAAK,QAAQ,MAAM;GAEtC,IAAI,SAAS,EAAE,IAAI,SAAS,EAAE,IAAI,UAAU,EAAE,IAAI,SAAS,EAAE,EAC3D,OAAO,OAAO,EAAE;GAGlB,OAAO,OAAO,EAAE,GAAG,OAAO;IAC1B;EAGF,IAAI,KAAK,OAAO,eAAe,OAAO;EAEtC,OAAO"}
+{"version":3,"file":"toStringArrayUnRecursive-tHp2a7KR.js","names":[],"sources":["../src/conversions/arrays/transforms/filterNilArray.ts","../src/conversions/arrays/casts/toStringArrayUnRecursive.ts"],"sourcesContent":["import type {\n  FilterNilArray,\n  FilterNilArrayFromTuple,\n  PreserveMutability\n} from \"./_private/filterNilArray.types\";\n\nimport { isNil } from \"@/predicates/is/isNil\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isEmptyArray } from \"@/predicates/is/isEmptyArray\";\n\n/** ----------------------------------------------------------\n * * ***Utility: `filterNilArray`.***\n * ---------------------------------------------\n * **Removes `null` and `undefined` values from an array, including nested arrays.**\n * - **Behavior:**\n *    - Returns `undefined` if the input is explicitly `undefined` or `null`.\n *    - Returns `[]` if input is empty or all elements are removed after filtering.\n *    - Recursively filters nested arrays while preserving structure.\n *    - Ensures proper type inference for safer downstream operations.\n * @template A - The type of elements in the array.\n * @param {T[]|null|undefined} input - The array to be filtered.\n * @returns {T[] | undefined} A new array with `null` and `undefined` values removed,\n * or `undefined` if the input is explicitly `undefined` or `null`.\n * @example\n * ```ts\n * filterNilArray([1, null, 2, undefined, 3]);\n * // ➔ [1, 2, 3]\n * filterNilArray([null, undefined]);\n * // ➔ []\n * filterNilArray(undefined);\n * // ➔ undefined\n * filterNilArray(null);\n * // ➔ undefined\n * filterNilArray([]); // or\n * filterNilArray([[[]]]); // or\n * filterNilArray([[[],undefined,null]]);\n * // ➔ []\n * filterNilArray([1, [null, 2, [undefined, 3]]]);\n * // ➔ [1, [2, [3]]]\n * ```\n */\nexport function filterNilArray(input: null | undefined): undefined;\nexport function filterNilArray<A extends readonly unknown[]>(\n  input: A\n): PreserveMutability<A, FilterNilArrayFromTuple<A>>;\nexport function filterNilArray<A extends readonly unknown[]>(\n  input: A | null | undefined\n): PreserveMutability<A, FilterNilArrayFromTuple<A>> | undefined;\nexport function filterNilArray<A>(\n  input: (A | null | undefined)[] | null | undefined\n): FilterNilArray<A> | undefined;\nexport function filterNilArray(\n  input: readonly unknown[] | null | undefined\n): unknown[] | undefined;\nexport function filterNilArray(input: unknown[]): unknown[];\nexport function filterNilArray(input: unknown): unknown {\n  if (isNil(input)) return undefined;\n  if (!isArray(input)) return [];\n\n  const filtered = input.reduce<unknown[]>((output, element) => {\n    if (!isNil(element)) {\n      if (isArray(element)) {\n        const cleanedNested = filterNilArray(element);\n        if (cleanedNested && !isEmptyArray(cleanedNested)) {\n          output.push(cleanedNested);\n        }\n      } else {\n        output.push(element);\n      }\n    }\n    return output;\n  }, []);\n\n  return filtered;\n}\n","import type {\n  ToStringArrayUnRecursiveOptions,\n  ToStringArrayUnRecursiveReturn\n} from \"./toStringArrayUnRecursive.types\";\n\nimport { isNull } from \"@/predicates/is/isNull\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isFinite } from \"@/predicates/is/isFinite\";\nimport { isBigInt } from \"@/predicates/is/isBigInt\";\nimport { isBoolean } from \"@/predicates/is/isBoolean\";\nimport { hasOwnProp } from \"@/predicates/has/hasOwnProp\";\nimport { assertIsBoolean } from \"@/assertions/booleans/assertIsBoolean\";\nimport { assertIsPlainObject } from \"@/assertions/objects/assertIsPlainObject\";\n\nimport { filterNilArray } from \"../transforms/filterNilArray\";\n\n/** ---------------------------------------------\n * * ***Utility: `toStringArrayUnRecursive`.***\n * ---------------------------------------------\n * **Converts all values in a flat array into string representations.**\n * - **Behavior:**\n *    - Only processes **flat arrays** (non-recursive).\n *    - Supports input values: `string`, `number`, `bigint`, `boolean`,\n *      `null`, `undefined`.\n *    - Invalid values (`null` and `undefined`) can be **removed** or **kept**\n *      depending on the option.\n *    - Other unsupported types will be converted to `undefined` (and removed\n *      if `removeInvalidValue=true`).\n * - **ℹ️ Note:**\n *    - _For recursive / nested arrays, use ***`toStringDeep` utility function*** instead._\n * @template T - Element type of the input array.\n * @template R - Whether invalid values should be removed (`true`) or kept (`false`).\n * @param {Array<string | number | bigint | boolean | null | undefined> | null | undefined} [array] - The array to convert, returns `undefined` if not an array.\n * @param {ToStringArrayUnRecursiveOptions<RemoveInvalidValue>} [options] - Options to control transformation behavior, defaults to `{ removeInvalidValue: true }`.\n * @param {RemoveInvalidValue extends true ? boolean : boolean} [options.removeInvalidValue=true] Whether to remove invalid values (`null`, `undefined`, or unsupported types), default: `true`.\n * @returns {RemoveInvalidValue extends true ? string[] : (string | null | undefined)[]} A new array of string representations, with invalid values optionally removed.\n * @example\n * ```ts\n * // Convert numbers and strings\n * toStringArrayUnRecursive([1, 2, '3']);\n * // ➔ ['1', '2', '3']\n * // Remove null and undefined\n * toStringArrayUnRecursive([1, null, undefined, 'abc'], {\n *   removeInvalidValue: true\n * });\n * // ➔ ['1', 'abc']\n * // Keep null and undefined\n * toStringArrayUnRecursive([1, null, undefined, 'abc'], {\n *   removeInvalidValue: false\n * });\n * // ➔ ['1', null, undefined, 'abc']\n * // Convert boolean and bigint\n * toStringArrayUnRecursive([true, false, 10n]);\n * // ➔ ['true', 'false', '10']\n * // Not an array ➔ returns undefined\n * toStringArrayUnRecursive(null);\n * // ➔ undefined\n * toStringArrayUnRecursive(undefined);\n * // ➔ undefined\n * toStringArrayUnRecursive(1);\n * // ➔ undefined\n * toStringArrayUnRecursive(\"string\");\n * // ➔ undefined\n * ```\n */\nexport function toStringArrayUnRecursive(\n  array?: undefined | null,\n  options?: ToStringArrayUnRecursiveOptions<boolean>\n): undefined;\nexport function toStringArrayUnRecursive(\n  array?: Array<never>,\n  options?: ToStringArrayUnRecursiveOptions<boolean>\n): [];\nexport function toStringArrayUnRecursive<T, R extends boolean = true>(\n  array?: Array<T> | readonly T[] | null,\n  options?: ToStringArrayUnRecursiveOptions<R>\n): ToStringArrayUnRecursiveReturn<T, R>;\nexport function toStringArrayUnRecursive<T = unknown>(\n  array?: T,\n  options?: ToStringArrayUnRecursiveOptions<boolean>\n): undefined;\nexport function toStringArrayUnRecursive<T>(\n  array?: Array<T> | readonly T[] | null,\n  options: ToStringArrayUnRecursiveOptions<boolean> = {}\n) {\n  assertIsPlainObject(options, {\n    message: ({ currentType, validType }) =>\n      `Second parameter (\\`options\\`) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  const riv = hasOwnProp(options, \"removeInvalidValue\")\n    ? options.removeInvalidValue\n    : true;\n\n  assertIsBoolean(riv, {\n    message: ({ currentType, validType }) =>\n      `Parameter \\`removeInvalidValue\\` property of the \\`options\\` (second parameter) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  if (isArray(array)) {\n    // Convert each item in the array to a string, or null/undefined if it's not a valid value.\n    const result = Array.from(array, (x) => {\n      // Convert finite number, boolean, bigInt or string to string\n      if (isString(x) || isFinite(x) || isBoolean(x) || isBigInt(x))\n        return String(x);\n\n      // Handle null or undefined values\n      return isNull(x) ? null : undefined;\n    });\n\n    // Remove invalid values (null, undefined) if specified in options\n    if (riv) return filterNilArray(result);\n\n    return result;\n  }\n\n  // Return undefined if no array is provided\n  return undefined;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAuDA,SAAgB,eAAe,OAAyB;CACtD,IAAI,MAAM,MAAM,EAAE,OAAO;CACzB,IAAI,CAAC,QAAQ,MAAM,EAAE,OAAO,EAAE;CAgB9B,OAdiB,MAAM,QAAmB,QAAQ,YAAY;EAC5D,IAAI,CAAC,MAAM,QAAQ,EACjB,IAAI,QAAQ,QAAQ,EAAE;GACpB,MAAM,gBAAgB,eAAe,QAAQ;GAC7C,IAAI,iBAAiB,CAAC,aAAa,cAAc,EAC/C,OAAO,KAAK,cAAc;SAG5B,OAAO,KAAK,QAAQ;EAGxB,OAAO;IACN,EAAE,CAEU;;;;;ACSjB,SAAgB,yBACd,OACA,UAAoD,EAAE,EACtD;CACA,oBAAoB,SAAS,EAC3B,UAAU,EAAE,aAAa,gBACvB,oDAAoD,UAAU,sBAAsB,YAAY,MACnG,CAAC;CAEF,MAAM,MAAM,WAAW,SAAS,qBAAqB,GACjD,QAAQ,qBACR;CAEJ,gBAAgB,KAAK,EACnB,UAAU,EAAE,aAAa,gBACvB,qGAAqG,UAAU,sBAAsB,YAAY,MACpJ,CAAC;CAEF,IAAI,QAAQ,MAAM,EAAE;EAElB,MAAM,SAAS,MAAM,KAAK,QAAQ,MAAM;GAEtC,IAAI,SAAS,EAAE,IAAI,SAAS,EAAE,IAAI,UAAU,EAAE,IAAI,SAAS,EAAE,EAC3D,OAAO,OAAO,EAAE;GAGlB,OAAO,OAAO,EAAE,GAAG,OAAO;IAC1B;EAGF,IAAI,KAAK,OAAO,eAAe,OAAO;EAEtC,OAAO"}

package/dist/urls/index.cjs

@@ -2,130 +2,19 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.1`
+*  Version: `3.13.0-beta.2`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_assertIsBoolean = require('../assertIsBoolean-C8WEXVr2.cjs');
-const require_assertIsArray = require('../assertIsArray-DJXkjHZs.cjs');
-const require_toStringArrayUnRecursive = require('../toStringArrayUnRecursive-C4zYCja7.cjs');
-const require_safeStableStringify = require('../safeStableStringify-CJtP89qn.cjs');
-const require_isEmptyString = require('../isEmptyString-UiiUsSQj.cjs');
-const require_isEmptyValue = require('../isEmptyValue-BQzcjVaL.cjs');
-const require_isInteger = require('../isInteger-Caeuz0rB.cjs');
-const require_punyCode = require('../punyCode-D-Qu6nj6.cjs');
-const require_isURL = require('../isURL-DeUPO_oR.cjs');
-const require_isValidDomain = require('../isValidDomain-BB9IGhJs.cjs');
-const require_normalizeString = require('../normalizeString-BE6ELqEb.cjs');
-const require_formatEnvPort = require('../formatEnvPort-B3OLxQk9.cjs');
-const constructURL = (baseUrl, queryParams, removeParams) => {
-	if (require_assertIsBoolean.isString(baseUrl)) {
-		if (require_isEmptyString.isEmptyString(baseUrl)) throw new TypeError("First parameter (`baseUrl`) cannot be an empty-string.");
-		baseUrl = require_normalizeString.normalizeString(baseUrl);
-	} else if (!require_isURL.isURL(baseUrl)) throw new TypeError(`First parameter (\`baseUrl\`) must be of type an URL instance or a \`string\` and a non empty-string, but received: \`${require_assertIsBoolean.getPreciseType(baseUrl)}\`, with current value: \`${require_safeStableStringify.safeStableStringify(baseUrl, { keepUndefined: true })}\`.`);
-	if (!require_assertIsBoolean.isUndefined(removeParams)) {
-		require_assertIsArray.assertIsArray(removeParams, { message: ({ currentType, validType }) => `Third parameter (\`removeParams\`) must be of type \`${validType} of strings\`, but received: \`${currentType}\`.` });
-		if (!removeParams.every((param) => require_assertIsBoolean.isNonEmptyString(param))) throw new TypeError("Third parameter (`removeParams`) must be of type `array` and contains `string` only and non empty-string.");
-	}
-	try {
-		if (!require_assertIsBoolean.isUndefined(queryParams) && !require_assertIsBoolean.isFunction(queryParams[Symbol.iterator])) throw new TypeError(`Second parameter (\`queryParams\`) must be iterable (like URLSearchParams.entries() or an array of [[string, string | number]...]), but received: \`${require_assertIsBoolean.getPreciseType(queryParams)}\`, with value: \`${require_safeStableStringify.safeStableStringify(queryParams, { keepUndefined: true })}\`.`);
-		const urlInstance = new URL(baseUrl);
-		if (!require_assertIsBoolean.isUndefined(queryParams)) {
-			const paramObject = Object.fromEntries(queryParams);
-			if (!require_isEmptyValue.isEmptyValue(paramObject)) {
-				const mergedParams = new URLSearchParams(urlInstance.search);
-				for (const [key, value] of Object.entries(paramObject)) {
-					if (!require_assertIsBoolean.isNonEmptyString(value) && !require_assertIsBoolean.isNumber(value, { includeNaN: true })) throw new TypeError(`Second parameter (\`queryParams\`) must be iterable (like URLSearchParams.entries() or an array of [[string, string | number]...]), but received: \`${require_assertIsBoolean.getPreciseType(queryParams)}\`, with value: \`${require_safeStableStringify.safeStableStringify(queryParams, { keepUndefined: true })}\`.`);
-					mergedParams.set(key, String(value));
-				}
-				if (removeParams?.length) require_toStringArrayUnRecursive.toStringArrayUnRecursive(removeParams).map((paramKey) => {
-					mergedParams.delete(paramKey);
-				});
-				urlInstance.search = mergedParams.toString();
-			}
-		}
-		removeParams?.forEach((param) => urlInstance.searchParams.delete(param));
-		return urlInstance;
-	} catch (error) {
-		if (require_assertIsBoolean.isError(error)) throw error;
-		throw new Error("Failed to construct a valid URL in `constructURL()`, Error:" + error, { cause: error });
-	}
-};
-const extractURLs = (url) => {
-	if (!require_assertIsBoolean.isNonEmptyString(url)) return null;
-	let decoded;
-	try {
-		decoded = decodeURIComponent(url);
-	} catch {
-		return null;
-	}
-	const matches = decoded.match(/https?:\/\/.*?(?=https?:\/\/|\s|$)/g);
-	if (!matches) return null;
-	const cleaned = matches.map((url) => url.replace(/[.,;:!?)]*$/, "")).filter((url) => {
-		try {
-			const u = new URL(url);
-			return u.protocol === "http:" || u.protocol === "https:";
-		} catch {
-			return false;
-		}
-	});
-	return cleaned.length ? cleaned : null;
-};
-const getFirstPrefixPathname = (result, defaultValue = "/") => {
-	if (!require_assertIsBoolean.isNonEmptyString(defaultValue)) throw new TypeError(`Second parameter (\`defaultValue\`) must be of type \`string\` and not an \`empty-string\`, but received: \`${require_assertIsBoolean.getPreciseType(defaultValue)}\`, with value: \`${require_safeStableStringify.safeStableStringify(defaultValue, { keepUndefined: true })}\`.`);
-	if (require_assertIsBoolean.isArray(result)) {
-		if (!result.every((item) => require_assertIsBoolean.isString(item))) throw new TypeError(`First parameter (\`result\`) must be of type \`string\` or \`array of string\`, but received: \`${require_assertIsBoolean.getPreciseType(result)}\`, with value: \`${require_safeStableStringify.safeStableStringify(result, { keepUndefined: true })}\`.`);
-		for (const item of result) {
-			const normalized = require_formatEnvPort.normalizePathname(item);
-			if (normalized !== "/") return normalized;
-		}
-		return require_formatEnvPort.normalizePathname(defaultValue);
-	}
-	if (require_assertIsBoolean.isString(result)) {
-		const normalized = require_formatEnvPort.normalizePathname(result);
-		return normalized !== "/" ? normalized : require_formatEnvPort.normalizePathname(defaultValue);
-	}
-	if (!require_assertIsBoolean.isNil(result)) throw new TypeError(`First parameter (\`result\`) must be of type \`string\`, \`array-string\`, \`null\` or \`undefined\`, but received: \`${require_assertIsBoolean.getPreciseType(result)}\`.`);
-	return require_formatEnvPort.normalizePathname(defaultValue);
-};
-const getPrefixPathname = (url, base = null, options = {}) => {
-	const errors = [];
-	if (!require_assertIsBoolean.isString(url) && !require_assertIsBoolean.isArray(url)) errors.push(`First parameter (\`url\`) must be of type \`string\` or \`array-string\`, but received: \`${require_assertIsBoolean.getPreciseType(url)}\`.`);
-	if (!require_assertIsBoolean.isString(base) && !require_assertIsBoolean.isArray(base) && !require_assertIsBoolean.isNull(base)) errors.push(`Second parameter (\`base\`) must be of type \`string\`, \`array-string\` or \`null\`, but received: \`${require_assertIsBoolean.getPreciseType(base)}\`.`);
-	if (!require_assertIsBoolean.isPlainObject(options)) errors.push(`Second parameter (\`options\`) must be of type \`plain-object\`, but received: \`${require_assertIsBoolean.getPreciseType(options)}\`.`);
-	const { levels = 1, removeDuplicates = true } = options;
-	if (!require_isInteger.isInteger(levels) || require_isInteger.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: \`${require_assertIsBoolean.getPreciseType(levels)}\`, with value: \`${require_safeStableStringify.safeStableStringify(levels, { keepUndefined: true })}\`.`);
-	if (!require_assertIsBoolean.isBoolean(removeDuplicates)) errors.push(`Parameter \`removeDuplicates\` property of the \`options\` (second parameter) must be of type \`boolean\`, but received: \`${require_assertIsBoolean.getPreciseType(removeDuplicates)}\`.`);
-	if (require_assertIsBoolean.isNonEmptyArray(errors)) throw new TypeError(require_isValidDomain.joinLines("Invalid parameter(s) in `getPrefixPathname` function:", `- ${errors.join(`${require_isValidDomain.EOL}- `)}`));
-	function getLevel(singleUrl) {
-		return `/${require_formatEnvPort.normalizePathname(singleUrl).split("/").filter(Boolean).slice(0, levels).join("/")}`;
-	}
-	function processUrl(singleUrl) {
-		if (base) {
-			singleUrl = require_formatEnvPort.normalizePathname(singleUrl);
-			if (require_assertIsBoolean.isArray(base)) {
-				for (const b of base) if (singleUrl.startsWith(require_formatEnvPort.normalizePathname(b))) return getLevel(singleUrl);
-			} else if (require_assertIsBoolean.isNonEmptyString(base) && singleUrl.startsWith(require_formatEnvPort.normalizePathname(base))) return getLevel(singleUrl);
-			return null;
-		}
-		return getLevel(singleUrl);
-	}
-	if (require_assertIsBoolean.isArray(url)) {
-		const result = url.map(processUrl).filter((r) => !require_assertIsBoolean.isNull(r));
-		const uniqueResult = removeDuplicates ? [...new Set(result)] : result;
-		if (uniqueResult.length === 1) return uniqueResult[0] ?? null;
-		return uniqueResult;
-	}
-	return processUrl(url);
-};
-exports.constructURL = constructURL;
-exports.extractURLs = extractURLs;
-exports.formatEnvPort = require_formatEnvPort.formatEnvPort;
-exports.getFirstPrefixPathname = getFirstPrefixPathname;
-exports.getPrefixPathname = getPrefixPathname;
-exports.normalizePathname = require_formatEnvPort.normalizePathname;
+const require_punyCode = require('../punyCode-DmTsB7q_.cjs');
+const require_urls = require('../urls-DCyx8Wpk.cjs');
+exports.constructURL = require_urls.constructURL;
+exports.extractURLs = require_urls.extractURLs;
+exports.formatEnvPort = require_urls.formatEnvPort;
+exports.getFirstPrefixPathname = require_urls.getFirstPrefixPathname;
+exports.getPrefixPathname = require_urls.getPrefixPathname;
+exports.normalizePathname = require_urls.normalizePathname;
 exports.punycodeUtilsJS = require_punyCode.punycodeUtilsJS;
-//# sourceMappingURL=index.cjs.map

package/dist/urls/index.d.cts

@@ -2,7 +2,7 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.1`
+*  Version: `3.13.0-beta.2`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================

package/dist/urls/index.d.ts

@@ -2,7 +2,7 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.1`
+*  Version: `3.13.0-beta.2`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================

package/dist/urls/index.js

@@ -2,122 +2,11 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.1`
+*  Version: `3.13.0-beta.2`
 *  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-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.");
-		baseUrl = normalizeString(baseUrl);
-	} else if (!isURL(baseUrl)) throw new TypeError(`First parameter (\`baseUrl\`) must be of type an URL instance or a \`string\` and a non empty-string, but received: \`${getPreciseType(baseUrl)}\`, with current value: \`${safeStableStringify(baseUrl, { keepUndefined: true })}\`.`);
-	if (!isUndefined(removeParams)) {
-		assertIsArray(removeParams, { message: ({ currentType, validType }) => `Third parameter (\`removeParams\`) must be of type \`${validType} of strings\`, but received: \`${currentType}\`.` });
-		if (!removeParams.every((param) => isNonEmptyString(param))) throw new TypeError("Third parameter (`removeParams`) must be of type `array` and contains `string` only and non empty-string.");
-	}
-	try {
-		if (!isUndefined(queryParams) && !isFunction(queryParams[Symbol.iterator])) throw new TypeError(`Second parameter (\`queryParams\`) must be iterable (like URLSearchParams.entries() or an array of [[string, string | number]...]), but received: \`${getPreciseType(queryParams)}\`, with value: \`${safeStableStringify(queryParams, { keepUndefined: true })}\`.`);
-		const urlInstance = new URL(baseUrl);
-		if (!isUndefined(queryParams)) {
-			const paramObject = Object.fromEntries(queryParams);
-			if (!isEmptyValue(paramObject)) {
-				const mergedParams = new URLSearchParams(urlInstance.search);
-				for (const [key, value] of Object.entries(paramObject)) {
-					if (!isNonEmptyString(value) && !isNumber(value, { includeNaN: true })) throw new TypeError(`Second parameter (\`queryParams\`) must be iterable (like URLSearchParams.entries() or an array of [[string, string | number]...]), but received: \`${getPreciseType(queryParams)}\`, with value: \`${safeStableStringify(queryParams, { keepUndefined: true })}\`.`);
-					mergedParams.set(key, String(value));
-				}
-				if (removeParams?.length) toStringArrayUnRecursive(removeParams).map((paramKey) => {
-					mergedParams.delete(paramKey);
-				});
-				urlInstance.search = mergedParams.toString();
-			}
-		}
-		removeParams?.forEach((param) => urlInstance.searchParams.delete(param));
-		return urlInstance;
-	} catch (error) {
-		if (isError(error)) throw error;
-		throw new Error("Failed to construct a valid URL in `constructURL()`, Error:" + error, { cause: error });
-	}
-};
-const extractURLs = (url) => {
-	if (!isNonEmptyString(url)) return null;
-	let decoded;
-	try {
-		decoded = decodeURIComponent(url);
-	} catch {
-		return null;
-	}
-	const matches = decoded.match(/https?:\/\/.*?(?=https?:\/\/|\s|$)/g);
-	if (!matches) return null;
-	const cleaned = matches.map((url) => url.replace(/[.,;:!?)]*$/, "")).filter((url) => {
-		try {
-			const u = new URL(url);
-			return u.protocol === "http:" || u.protocol === "https:";
-		} catch {
-			return false;
-		}
-	});
-	return cleaned.length ? cleaned : null;
-};
-const getFirstPrefixPathname = (result, defaultValue = "/") => {
-	if (!isNonEmptyString(defaultValue)) throw new TypeError(`Second parameter (\`defaultValue\`) must be of type \`string\` and not an \`empty-string\`, but received: \`${getPreciseType(defaultValue)}\`, with value: \`${safeStableStringify(defaultValue, { keepUndefined: true })}\`.`);
-	if (isArray(result)) {
-		if (!result.every((item) => isString(item))) throw new TypeError(`First parameter (\`result\`) must be of type \`string\` or \`array of string\`, but received: \`${getPreciseType(result)}\`, with value: \`${safeStableStringify(result, { keepUndefined: true })}\`.`);
-		for (const item of result) {
-			const normalized = normalizePathname(item);
-			if (normalized !== "/") return normalized;
-		}
-		return normalizePathname(defaultValue);
-	}
-	if (isString(result)) {
-		const normalized = normalizePathname(result);
-		return normalized !== "/" ? normalized : normalizePathname(defaultValue);
-	}
-	if (!isNil(result)) throw new TypeError(`First parameter (\`result\`) must be of type \`string\`, \`array-string\`, \`null\` or \`undefined\`, but received: \`${getPreciseType(result)}\`.`);
-	return normalizePathname(defaultValue);
-};
-const getPrefixPathname = (url, base = null, options = {}) => {
-	const errors = [];
-	if (!isString(url) && !isArray(url)) errors.push(`First parameter (\`url\`) must be of type \`string\` or \`array-string\`, but received: \`${getPreciseType(url)}\`.`);
-	if (!isString(base) && !isArray(base) && !isNull(base)) errors.push(`Second parameter (\`base\`) must be of type \`string\`, \`array-string\` or \`null\`, but received: \`${getPreciseType(base)}\`.`);
-	if (!isPlainObject(options)) errors.push(`Second parameter (\`options\`) must be of type \`plain-object\`, but received: \`${getPreciseType(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(joinLines("Invalid parameter(s) in `getPrefixPathname` function:", `- ${errors.join(`${EOL}- `)}`));
-	function getLevel(singleUrl) {
-		return `/${normalizePathname(singleUrl).split("/").filter(Boolean).slice(0, levels).join("/")}`;
-	}
-	function processUrl(singleUrl) {
-		if (base) {
-			singleUrl = normalizePathname(singleUrl);
-			if (isArray(base)) {
-				for (const b of base) if (singleUrl.startsWith(normalizePathname(b))) return getLevel(singleUrl);
-			} else if (isNonEmptyString(base) && singleUrl.startsWith(normalizePathname(base))) return getLevel(singleUrl);
-			return null;
-		}
-		return getLevel(singleUrl);
-	}
-	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] ?? null;
-		return uniqueResult;
-	}
-	return processUrl(url);
-};
+import { t as punycodeUtilsJS } from "../punyCode-BeFYDjj0.js";
+import { a as extractURLs, i as normalizePathname, n as getPrefixPathname, o as constructURL, r as getFirstPrefixPathname, t as formatEnvPort } from "../urls-CoxDAoki.js";
 export { constructURL, extractURLs, formatEnvPort, getFirstPrefixPathname, getPrefixPathname, normalizePathname, punycodeUtilsJS };
-//# sourceMappingURL=index.js.map