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

package/dist/next/server/index.js

@@ -1,41 +1,26 @@
 /*!
- * ====================================================
- * Rzl Utils-JS.
- * ----------------------------------------------------
- * Version: 3.11.1.
- * Author: Rizalvin Dwiky.
- * Repository: https://github.com/rzl-zone/utils-js.
- * ====================================================
- */
-import { isFunction, assertIsBoolean } from '../../chunk-MSUW5VHZ.js';
-import 'server-only';
-import { NextRequest } from 'next/server';
-
-var getClientIpOrUrl = (request, includeFullUrl = true) => {
-  if (!isFunction(NextRequest)) {
-    throw new Error(
-      "Function `getClientIpOrUrl` is designed to be used in a `NextJS` environment."
-    );
-  }
-  if (!(request instanceof NextRequest)) {
-    throw new TypeError(
-      "First parameter (`request`) must be an `instance of NextRequest` from `NextJS`."
-    );
-  }
-  assertIsBoolean(includeFullUrl, {
-    message: ({ currentType, validType }) => `Second parameter (\`includeFullUrl\`) must be of type \`${validType}\`, but received: \`${currentType}\`.`
-  });
-  const forwardedIps = (request.headers.get("x-forwarded-for") ?? "127.0.0.1").trim().split(",");
-  if (forwardedIps[0] === "::ffff:127.0.0.1" || forwardedIps[0] === "::1") {
-    forwardedIps[0] = "127.0.0.1";
-  }
-  const clientIp = forwardedIps.length > 1 ? forwardedIps[forwardedIps.length - 1].trim() : forwardedIps[0];
-  if (!includeFullUrl) {
-    return clientIp;
-  }
-  const protocol = request.headers.get("x-forwarded-proto") || "http";
-  const port = request.headers.get("x-forwarded-port") || "3000";
-  return `${process.env.NODE_ENV === "production" ? protocol : "http"}://${clientIp}:${port}`;
+* ========================================================================
+*  @rzl-zone/utils-js
+* ------------------------------------------------------------------------
+*  Version: `3.12.1-beta.0`
+*  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
+*  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
+* ========================================================================
+*/
+import { P as isFunction, t as assertIsBoolean } from "../../assertIsBoolean-BlBct0Fc.js";
+import "@rzl-zone/node-only";
+import { NextRequest } from "next/server";
+const getClientIpOrUrl = (request, includeFullUrl = true) => {
+	if (!isFunction(NextRequest)) throw new Error("Function `getClientIpOrUrl` is designed to be used in a `NextJS` environment.");
+	if (!(request instanceof NextRequest)) throw new TypeError("First parameter (`request`) must be an `instance of NextRequest` from `NextJS`.");
+	assertIsBoolean(includeFullUrl, { message: ({ currentType, validType }) => `Second parameter (\`includeFullUrl\`) must be of type \`${validType}\`, but received: \`${currentType}\`.` });
+	const forwardedIps = (request.headers.get("x-forwarded-for") ?? "127.0.0.1").trim().split(",");
+	if (forwardedIps[0] === "::ffff:127.0.0.1" || forwardedIps[0] === "::1") forwardedIps[0] = "127.0.0.1";
+	const clientIp = forwardedIps.length > 1 ? forwardedIps[forwardedIps.length - 1]?.trim() || "" : forwardedIps[0] || "";
+	if (!includeFullUrl) return clientIp;
+	const protocol = request.headers.get("x-forwarded-proto") || "http";
+	const port = request.headers.get("x-forwarded-port") || "3000";
+	return `${process.env.NODE_ENV === "production" ? protocol : "http"}://${clientIp}:${port}`;
 };
-
 export { getClientIpOrUrl };
+//# sourceMappingURL=index.js.map

package/dist/next/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/next/server/getClientIpOrUrl.ts"],"sourcesContent":["import \"@rzl-zone/node-only\";\n\nimport { NextRequest } from \"next/server\";\n\nimport { isFunction } from \"@/predicates/is/isFunction\";\nimport { assertIsBoolean } from \"@/assertions/booleans/assertIsBoolean\";\n\n/** ---------------------------------\n * * ***Utility for NextJS Server: `getClientIpOrUrl`.***\n * ---------------------------------\n * **Retrieves the real client IP address and constructs the full URL using headers like `x-forwarded-for`, `x-forwarded-proto`, and `x-forwarded-port`.**\n * - **ℹ️ Note:**\n *    - Only supported in **Next.js** environments (specifically in `server-only` contexts).\n *    - Should be used in **middleware**, **route-handler** or **server actions** that have access to ***[`NextRequest - NextJS`](https://nextjs.org/docs/app/api-reference/functions/next-request)***.\n * @param {NextRequest} request - The incoming ***`NextJS`*** request object, must be instanceof `NextRequest` from `next/server`.\n * @param {boolean|undefined} [includeFullUrl=true] - Whether to return the full URL (`protocol`, `IP`, and `port` like `protocol://ip:port`) or just the IP address, defaultValue: `true`.\n * @returns {string} The extracted client IP address or the full constructed URL.\n * @throws **{@link Error | `Error`}** if the function is used outside a Next.js server environment.\n * @throws **{@link TypeError | `TypeError`}** if the arguments do not match the expected types.\n * @example\n * // Basic usage in Next.js middleware\n * import { NextRequest } from \"next/server\";\n * import { getClientIpOrUrl } from \"@rzl-zone/utils-js/next/server\";\n *\n * export function middleware(request: NextRequest) {\n *   const clientIp = getClientIpOrUrl(request, false);\n *   console.log(\"Client IP:\", clientIp);\n * }\n *\n * // Get full URL\n * const url = getClientIpOrUrl(request);\n * console.log(\"Client full URL:\", url);\n */\nexport const getClientIpOrUrl = (\n  request: NextRequest,\n  includeFullUrl: boolean = true\n): string => {\n  // Ensure we're in a Next.js edge/server environment\n  if (!isFunction(NextRequest)) {\n    throw new Error(\n      \"Function `getClientIpOrUrl` is designed to be used in a `NextJS` environment.\"\n    );\n  }\n\n  if (!(request instanceof NextRequest)) {\n    throw new TypeError(\n      \"First parameter (`request`) must be an `instance of NextRequest` from `NextJS`.\"\n    );\n  }\n\n  assertIsBoolean(includeFullUrl, {\n    message: ({ currentType, validType }) =>\n      `Second parameter (\\`includeFullUrl\\`) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  const forwardedIps = (request.headers.get(\"x-forwarded-for\") ?? \"127.0.0.1\")\n    .trim()\n    .split(\",\");\n\n  // Normalize IPv6 loopback addresses\n  if (forwardedIps[0] === \"::ffff:127.0.0.1\" || forwardedIps[0] === \"::1\") {\n    forwardedIps[0] = \"127.0.0.1\";\n  }\n\n  // Get the last non-empty IP from the list (more reliable for real client IP)\n  const clientIp: string =\n    forwardedIps.length > 1\n      ? forwardedIps[forwardedIps.length - 1]?.trim() || \"\"\n      : forwardedIps[0] || \"\";\n\n  if (!includeFullUrl) {\n    return clientIp;\n  }\n\n  // Construct full URL using protocol, IP, and port\n  const protocol = request.headers.get(\"x-forwarded-proto\") || \"http\";\n  // const protocol = \"http\";\n  const port = request.headers.get(\"x-forwarded-port\") || \"3000\";\n\n  return `${\n    process.env.NODE_ENV === \"production\" ? protocol : \"http\"\n  }://${clientIp}:${port}`;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,MAAa,oBACX,SACA,iBAA0B,SACf;CAEX,IAAI,CAAC,WAAW,YAAY,EAC1B,MAAM,IAAI,MACR,gFACD;CAGH,IAAI,EAAE,mBAAmB,cACvB,MAAM,IAAI,UACR,kFACD;CAGH,gBAAgB,gBAAgB,EAC9B,UAAU,EAAE,aAAa,gBACvB,2DAA2D,UAAU,sBAAsB,YAAY,MAC1G,CAAC;CAEF,MAAM,gBAAgB,QAAQ,QAAQ,IAAI,kBAAkB,IAAI,aAC7D,MAAM,CACN,MAAM,IAAI;CAGb,IAAI,aAAa,OAAO,sBAAsB,aAAa,OAAO,OAChE,aAAa,KAAK;CAIpB,MAAM,WACJ,aAAa,SAAS,IAClB,aAAa,aAAa,SAAS,IAAI,MAAM,IAAI,KACjD,aAAa,MAAM;CAEzB,IAAI,CAAC,gBACH,OAAO;CAIT,MAAM,WAAW,QAAQ,QAAQ,IAAI,oBAAoB,IAAI;CAE7D,MAAM,OAAO,QAAQ,QAAQ,IAAI,mBAAmB,IAAI;CAExD,OAAO,GACL,QAAQ,IAAI,aAAa,eAAe,WAAW,OACpD,KAAK,SAAS,GAAG"}

package/dist/noop-B2mTBhW-.cjs

@@ -0,0 +1,18 @@
+/*!
+* ========================================================================
+*  @rzl-zone/utils-js
+* ------------------------------------------------------------------------
+*  Version: `3.12.1-beta.0`
+*  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
+*  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
+* ========================================================================
+*/
+"use strict";
+const noop = () => {};
+Object.defineProperty(exports, 'noop', {
+  enumerable: true,
+  get: function () {
+    return noop;
+  }
+});
+//# sourceMappingURL=noop-B2mTBhW-.cjs.map

package/dist/noop-B2mTBhW-.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop-B2mTBhW-.cjs","names":[],"sources":["../src/generators/utils/noop.ts"],"sourcesContent":["/**\n * --------------------------------------------------\n * * ***Utility: `noop`.***\n * --------------------------------------------------\n * **A no-operation function that performs no action.**\n *\n * @description\n * Commonly used as a **placeholder**, **default callback**, or **stub function**.\n *\n * - **Behavior**:\n *    - Does not return any meaningful value (`void`).\n *    - Safely callable in any context without side effects.\n *\n * @remarks\n * Although this function returns `void`, it implicitly results in `undefined`,\n * but the return value should never be relied upon.\n *\n * @example\n * **1. Basic usage** — does nothing and returns undefined implicitly:\n * ```\n * import { noop } from \"@rzl-zone/utils-js/generators\";\n *\n * noop(); // ➔ no effect (void)\n * ```\n * @example\n * **2. Using with type-checking helpers:**\n * ```ts\n * import { noop } from \"@rzl-zone/utils-js/generators\";\n * import { isFunction, isUndefined } from \"@rzl-zone/utils-js/predicates\";\n *\n * isFunction(noop);    // ➔ true  — `noop` is a function\n * isUndefined(noop()); // ➔ true  — calling `noop()` returns `undefined`\n * isFunction(noop());  // ➔ false — the return value is `undefined`, not a function\n * ```\n * @example\n * **3. As a default callback:**\n * ```ts\n * import { noop } from \"@rzl-zone/utils-js/generators\";\n *\n * const callback = noop;\n * callback(); // ➔ no effect (void)\n * ```\n */\nexport const noop = (): void => {};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CA,MAAa,aAAmB"}

package/dist/noop-BzktGBVz.js

@@ -0,0 +1,12 @@
+/*!
+* ========================================================================
+*  @rzl-zone/utils-js
+* ------------------------------------------------------------------------
+*  Version: `3.12.1-beta.0`
+*  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
+*  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
+* ========================================================================
+*/
+const noop = () => {};
+export { noop as t };
+//# sourceMappingURL=noop-BzktGBVz.js.map

package/dist/noop-BzktGBVz.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop-BzktGBVz.js","names":[],"sources":["../src/generators/utils/noop.ts"],"sourcesContent":["/**\n * --------------------------------------------------\n * * ***Utility: `noop`.***\n * --------------------------------------------------\n * **A no-operation function that performs no action.**\n *\n * @description\n * Commonly used as a **placeholder**, **default callback**, or **stub function**.\n *\n * - **Behavior**:\n *    - Does not return any meaningful value (`void`).\n *    - Safely callable in any context without side effects.\n *\n * @remarks\n * Although this function returns `void`, it implicitly results in `undefined`,\n * but the return value should never be relied upon.\n *\n * @example\n * **1. Basic usage** — does nothing and returns undefined implicitly:\n * ```\n * import { noop } from \"@rzl-zone/utils-js/generators\";\n *\n * noop(); // ➔ no effect (void)\n * ```\n * @example\n * **2. Using with type-checking helpers:**\n * ```ts\n * import { noop } from \"@rzl-zone/utils-js/generators\";\n * import { isFunction, isUndefined } from \"@rzl-zone/utils-js/predicates\";\n *\n * isFunction(noop);    // ➔ true  — `noop` is a function\n * isUndefined(noop()); // ➔ true  — calling `noop()` returns `undefined`\n * isFunction(noop());  // ➔ false — the return value is `undefined`, not a function\n * ```\n * @example\n * **3. As a default callback:**\n * ```ts\n * import { noop } from \"@rzl-zone/utils-js/generators\";\n *\n * const callback = noop;\n * callback(); // ➔ no effect (void)\n * ```\n */\nexport const noop = (): void => {};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CA,MAAa,aAAmB"}

package/dist/normalizeSpaces-DQHR3Tlr.cjs

@@ -0,0 +1,29 @@
+/*!
+* ========================================================================
+*  @rzl-zone/utils-js
+* ------------------------------------------------------------------------
+*  Version: `3.12.1-beta.0`
+*  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-DozdtbNi.cjs');
+const normalizeSpaces = (value, options = {
+	withTrim: true,
+	trimOnly: false
+}) => {
+	if (!require_assertIsBoolean.isNonEmptyString(value)) return "";
+	if (!require_assertIsBoolean.isPlainObject(options)) options = {};
+	const { trimOnly = false, withTrim = true } = options;
+	if (trimOnly) return value.trim();
+	if (withTrim) value = value.trim();
+	return value.replace(/\s+/g, " ");
+};
+Object.defineProperty(exports, 'normalizeSpaces', {
+  enumerable: true,
+  get: function () {
+    return normalizeSpaces;
+  }
+});
+//# sourceMappingURL=normalizeSpaces-DQHR3Tlr.cjs.map

package/dist/normalizeSpaces-DQHR3Tlr.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeSpaces-DQHR3Tlr.cjs","names":["isNonEmptyString","isPlainObject"],"sources":["../src/strings/sanitizations/normalizeSpaces.ts"],"sourcesContent":["import { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\ntype NormalizeSpacesOptions = {\n  /** If `true`, skips normalization and only trims whitespace from start & end, defaultValue: `false`.\n   *\n   * @default false\n   */\n  trimOnly?: boolean;\n  /** If `false`, skips trimming value, defaultValue: `true`.\n   *\n   * @default true\n   */\n  withTrim?: boolean;\n};\n\n/** ----------------------------------------------------------\n * * ***Utility: `normalizeSpaces`.***\n * ----------------------------------------------------------\n * **Normalizes whitespace in a string by reducing multiple spaces\n * to a single space, optionally trims, or only trims based on options.**\n * - **Behavior:**\n *    - Collapses all consecutive whitespace (spaces, tabs, newlines) into a single space.\n *    - Can trim leading/trailing spaces (default behavior), or preserve them with `withTrim: false`.\n *    - Can skip normalization entirely and only trim using `trimOnly: true`.\n *    - Returns an empty string if input is `null` or `undefined`.\n * @param {string | null | undefined} value - The input string to be processed. If `null` or `undefined`, returns an empty string.\n * @param {NormalizeSpacesOptions} [options] - Configuration options.\n * @param {NormalizeSpacesOptions[\"trimOnly\"]} [options.trimOnly=false] - If `true`, skips normalization and only trims the string.\n * @param {NormalizeSpacesOptions[\"withTrim\"]} [options.withTrim=true] - If `false`, preserves leading/trailing whitespace.\n * @returns {string} The processed string.\n * @example\n * normalizeSpaces(\"   Hello    World\\tthis   is\\n\\nok \");\n * // ➔ \"Hello World this is ok\"\n * normalizeSpaces(\"   Hello    World\\tthis   is\\n\\nok \", { trimOnly: true });\n * // ➔ \"Hello    World\tthis   is\\n\\nok\"\n * normalizeSpaces(\"   Hello    World   \", { withTrim: false });\n * // ➔ \" Hello World \"\n * normalizeSpaces(null);\n * // ➔ \"\"\n */\nexport const normalizeSpaces = (\n  value: string | null | undefined,\n  options: NormalizeSpacesOptions = {\n    withTrim: true,\n    trimOnly: false\n  }\n): string => {\n  if (!isNonEmptyString(value)) return \"\";\n\n  if (!isPlainObject(options)) {\n    options = {};\n  }\n\n  const { trimOnly = false, withTrim = true } = options;\n\n  if (trimOnly) return value.trim();\n\n  if (withTrim) {\n    value = value.trim();\n  }\n\n  // Remove all duplicate spaces (including tabs, newlines, etc.)\n  return value.replace(/\\s+/g, \" \");\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCA,MAAa,mBACX,OACA,UAAkC;CAChC,UAAU;CACV,UAAU;CACX,KACU;CACX,IAAI,CAACA,yCAAiB,MAAM,EAAE,OAAO;CAErC,IAAI,CAACC,sCAAc,QAAQ,EACzB,UAAU,EAAE;CAGd,MAAM,EAAE,WAAW,OAAO,WAAW,SAAS;CAE9C,IAAI,UAAU,OAAO,MAAM,MAAM;CAEjC,IAAI,UACF,QAAQ,MAAM,MAAM;CAItB,OAAO,MAAM,QAAQ,QAAQ,IAAI"}

package/dist/normalizeSpaces-WS_iERJk.js

@@ -0,0 +1,23 @@
+/*!
+* ========================================================================
+*  @rzl-zone/utils-js
+* ------------------------------------------------------------------------
+*  Version: `3.12.1-beta.0`
+*  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
+*  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
+* ========================================================================
+*/
+import { A as isPlainObject, y as isNonEmptyString } from "./assertIsBoolean-BlBct0Fc.js";
+const normalizeSpaces = (value, options = {
+	withTrim: true,
+	trimOnly: false
+}) => {
+	if (!isNonEmptyString(value)) return "";
+	if (!isPlainObject(options)) options = {};
+	const { trimOnly = false, withTrim = true } = options;
+	if (trimOnly) return value.trim();
+	if (withTrim) value = value.trim();
+	return value.replace(/\s+/g, " ");
+};
+export { normalizeSpaces as t };
+//# sourceMappingURL=normalizeSpaces-WS_iERJk.js.map

package/dist/normalizeSpaces-WS_iERJk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeSpaces-WS_iERJk.js","names":[],"sources":["../src/strings/sanitizations/normalizeSpaces.ts"],"sourcesContent":["import { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\ntype NormalizeSpacesOptions = {\n  /** If `true`, skips normalization and only trims whitespace from start & end, defaultValue: `false`.\n   *\n   * @default false\n   */\n  trimOnly?: boolean;\n  /** If `false`, skips trimming value, defaultValue: `true`.\n   *\n   * @default true\n   */\n  withTrim?: boolean;\n};\n\n/** ----------------------------------------------------------\n * * ***Utility: `normalizeSpaces`.***\n * ----------------------------------------------------------\n * **Normalizes whitespace in a string by reducing multiple spaces\n * to a single space, optionally trims, or only trims based on options.**\n * - **Behavior:**\n *    - Collapses all consecutive whitespace (spaces, tabs, newlines) into a single space.\n *    - Can trim leading/trailing spaces (default behavior), or preserve them with `withTrim: false`.\n *    - Can skip normalization entirely and only trim using `trimOnly: true`.\n *    - Returns an empty string if input is `null` or `undefined`.\n * @param {string | null | undefined} value - The input string to be processed. If `null` or `undefined`, returns an empty string.\n * @param {NormalizeSpacesOptions} [options] - Configuration options.\n * @param {NormalizeSpacesOptions[\"trimOnly\"]} [options.trimOnly=false] - If `true`, skips normalization and only trims the string.\n * @param {NormalizeSpacesOptions[\"withTrim\"]} [options.withTrim=true] - If `false`, preserves leading/trailing whitespace.\n * @returns {string} The processed string.\n * @example\n * normalizeSpaces(\"   Hello    World\\tthis   is\\n\\nok \");\n * // ➔ \"Hello World this is ok\"\n * normalizeSpaces(\"   Hello    World\\tthis   is\\n\\nok \", { trimOnly: true });\n * // ➔ \"Hello    World\tthis   is\\n\\nok\"\n * normalizeSpaces(\"   Hello    World   \", { withTrim: false });\n * // ➔ \" Hello World \"\n * normalizeSpaces(null);\n * // ➔ \"\"\n */\nexport const normalizeSpaces = (\n  value: string | null | undefined,\n  options: NormalizeSpacesOptions = {\n    withTrim: true,\n    trimOnly: false\n  }\n): string => {\n  if (!isNonEmptyString(value)) return \"\";\n\n  if (!isPlainObject(options)) {\n    options = {};\n  }\n\n  const { trimOnly = false, withTrim = true } = options;\n\n  if (trimOnly) return value.trim();\n\n  if (withTrim) {\n    value = value.trim();\n  }\n\n  // Remove all duplicate spaces (including tabs, newlines, etc.)\n  return value.replace(/\\s+/g, \" \");\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCA,MAAa,mBACX,OACA,UAAkC;CAChC,UAAU;CACV,UAAU;CACX,KACU;CACX,IAAI,CAAC,iBAAiB,MAAM,EAAE,OAAO;CAErC,IAAI,CAAC,cAAc,QAAQ,EACzB,UAAU,EAAE;CAGd,MAAM,EAAE,WAAW,OAAO,WAAW,SAAS;CAE9C,IAAI,UAAU,OAAO,MAAM,MAAM;CAEjC,IAAI,UACF,QAAQ,MAAM,MAAM;CAItB,OAAO,MAAM,QAAQ,QAAQ,IAAI"}

package/dist/normalizeString-2WLth_Gj.js

@@ -0,0 +1,15 @@
+/*!
+* ========================================================================
+*  @rzl-zone/utils-js
+* ------------------------------------------------------------------------
+*  Version: `3.12.1-beta.0`
+*  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
+*  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
+* ========================================================================
+*/
+import { y as isNonEmptyString } from "./assertIsBoolean-BlBct0Fc.js";
+const normalizeString = (input) => {
+	return isNonEmptyString(input) ? input.trim() : "";
+};
+export { normalizeString as t };
+//# sourceMappingURL=normalizeString-2WLth_Gj.js.map

package/dist/normalizeString-2WLth_Gj.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeString-2WLth_Gj.js","names":[],"sources":["../src/strings/sanitizations/normalizeString.ts"],"sourcesContent":["import { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\n/** ----------------------------------------------------------\n * * ***Utility: `normalizeString`.***\n * ----------------------------------------------------------\n * **Normalizes a string by ensuring it is a valid string and trimming whitespace.**\n * - **Behavior:**\n *    - If the input is `undefined`, `null`, or an `empty string` after trimming,\n *      it returns an empty string `(\"\")`.\n * @param {string | undefined | null} input - The input string to be normalize. If `null` or `undefined`, returns an empty string.\n * @returns {string} A trimmed string or an empty string if the input is invalid.\n * @example\n * normalizeString(\"   Hello World   \");\n * // ➔ \"Hello World\"\n * normalizeString(\"   Hello    World   \");\n * // ➔ \"Hello    World\"\n * normalizeString(\"\");\n * // ➔ \"\"\n * normalizeString(null);\n * // ➔ \"\"\n * normalizeString(undefined);\n * // ➔ \"\"\n */\nexport const normalizeString = (input: string | null | undefined): string => {\n  return isNonEmptyString(input) ? input.trim() : \"\";\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuBA,MAAa,mBAAmB,UAA6C;CAC3E,OAAO,iBAAiB,MAAM,GAAG,MAAM,MAAM,GAAG"}

package/dist/normalizeString-D8euBcRD.cjs

@@ -0,0 +1,21 @@
+/*!
+* ========================================================================
+*  @rzl-zone/utils-js
+* ------------------------------------------------------------------------
+*  Version: `3.12.1-beta.0`
+*  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-DozdtbNi.cjs');
+const normalizeString = (input) => {
+	return require_assertIsBoolean.isNonEmptyString(input) ? input.trim() : "";
+};
+Object.defineProperty(exports, 'normalizeString', {
+  enumerable: true,
+  get: function () {
+    return normalizeString;
+  }
+});
+//# sourceMappingURL=normalizeString-D8euBcRD.cjs.map

package/dist/normalizeString-D8euBcRD.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeString-D8euBcRD.cjs","names":["isNonEmptyString"],"sources":["../src/strings/sanitizations/normalizeString.ts"],"sourcesContent":["import { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\n/** ----------------------------------------------------------\n * * ***Utility: `normalizeString`.***\n * ----------------------------------------------------------\n * **Normalizes a string by ensuring it is a valid string and trimming whitespace.**\n * - **Behavior:**\n *    - If the input is `undefined`, `null`, or an `empty string` after trimming,\n *      it returns an empty string `(\"\")`.\n * @param {string | undefined | null} input - The input string to be normalize. If `null` or `undefined`, returns an empty string.\n * @returns {string} A trimmed string or an empty string if the input is invalid.\n * @example\n * normalizeString(\"   Hello World   \");\n * // ➔ \"Hello World\"\n * normalizeString(\"   Hello    World   \");\n * // ➔ \"Hello    World\"\n * normalizeString(\"\");\n * // ➔ \"\"\n * normalizeString(null);\n * // ➔ \"\"\n * normalizeString(undefined);\n * // ➔ \"\"\n */\nexport const normalizeString = (input: string | null | undefined): string => {\n  return isNonEmptyString(input) ? input.trim() : \"\";\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuBA,MAAa,mBAAmB,UAA6C;CAC3E,OAAOA,yCAAiB,MAAM,GAAG,MAAM,MAAM,GAAG"}

package/dist/operations/index.cjs

@@ -1,33 +1,66 @@
 /*!
- * ====================================================
- * Rzl Utils-JS.
- * ----------------------------------------------------
- * Version: 3.11.1.
- * Author: Rizalvin Dwiky.
- * Repository: https://github.com/rzl-zone/utils-js.
- * ====================================================
- */
-'use strict';
-
-var chunkXPVTIGU2_cjs = require('../chunk-XPVTIGU2.cjs');
-require('../chunk-K5536YHG.cjs');
-require('../chunk-GIKL4PUF.cjs');
-require('../chunk-7FGNVDEV.cjs');
-require('../chunk-DLS3G6WQ.cjs');
-require('../chunk-BAV5T2E3.cjs');
-require('../chunk-DAPAK2W3.cjs');
-require('../chunk-UDA26MCU.cjs');
-require('../chunk-SYHPSOUU.cjs');
-
-Object.defineProperty(exports, "findDuplicates", {
-  enumerable: true,
-  get: function () { return chunkXPVTIGU2_cjs.findDuplicates; }
-});
-Object.defineProperty(exports, "omitKeys", {
-  enumerable: true,
-  get: function () { return chunkXPVTIGU2_cjs.omitKeys; }
-});
-Object.defineProperty(exports, "omitKeysDeep", {
-  enumerable: true,
-  get: function () { return chunkXPVTIGU2_cjs.omitKeysDeep; }
-});
+* ========================================================================
+*  @rzl-zone/utils-js
+* ------------------------------------------------------------------------
+*  Version: `3.12.1-beta.0`
+*  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-DozdtbNi.cjs');
+const require_assertIsArray = require('../assertIsArray-BChqwPiP.cjs');
+const require_isEmptyObject = require('../isEmptyObject-DI42NEo0.cjs');
+const require_safeStableStringify = require('../safeStableStringify-Cc62pfRp.cjs');
+const require_isEqual = require('../isEqual-B1fRgEuU.cjs');
+const require_safeJsonParse = require('../safeJsonParse-BBnQElk8.cjs');
+const findDuplicates = (values) => {
+	require_assertIsArray.assertIsArray(values, { message: ({ currentType, validType }) => `First parameter (\`values\`) must be of type \`${validType}\` (array literal or instance), but received: \`${currentType}\`.` });
+	const duplicates = [];
+	values.forEach((item, index) => {
+		for (let i = index + 1; i < values.length; i++) if (require_isEqual.isEqual(item, values[i])) {
+			if (!duplicates.some((dup) => require_isEqual.isEqual(dup, item))) duplicates.push(item);
+			break;
+		}
+	});
+	return duplicates;
+};
+const omitKeys = (object, keysToOmit) => {
+	if (!require_assertIsBoolean.isPlainObject(object)) return {};
+	require_assertIsArray.assertIsArray(keysToOmit, { message: ({ currentType, validType }) => `Second parameter (\`keysToOmit\`) must be of type \`${validType}\` (array literal or instance), but received: \`${currentType}\`.` });
+	const duplicates = findDuplicates(keysToOmit);
+	if (duplicates.length > 0) throw new Error(`Function "omitKeys" Error: Duplicate keys detected - \`${duplicates}\``);
+	return Object.fromEntries(Object.entries(object).filter(([key]) => !keysToOmit.includes(key)));
+};
+const omitKeysDeep = (object, keysToOmit) => {
+	if (!require_assertIsBoolean.isPlainObject(object)) return {};
+	require_assertIsArray.assertIsArray(keysToOmit, { message: ({ currentType, validType }) => `Second parameter (\`keysToOmit\`) must be of type \`${validType}\` (array literal or instance), but received: \`${currentType}\`.` });
+	const duplicates = findDuplicates(keysToOmit);
+	if (require_assertIsBoolean.isNonEmptyArray(duplicates)) throw new Error(`Function "omitKeysDeep" Error: Duplicate keys detected - \`${require_safeStableStringify.safeStableStringify(duplicates, { keepUndefined: true })}\`.`);
+	const omitAtPath = (obj, pathParts) => {
+		if (!require_assertIsBoolean.isObjectOrArray(obj)) return obj;
+		const [current, ...rest] = pathParts;
+		if (require_isEmptyObject.isEmptyArray(rest)) if (require_assertIsBoolean.isArray(obj)) {
+			const index = parseInt(current);
+			if (!require_assertIsBoolean.isNaN(index) && index in obj) obj.splice(index, 1);
+		} else delete obj[current];
+		else {
+			const next = obj[current];
+			if (require_assertIsBoolean.isObjectOrArray(next)) obj[current] = omitAtPath(next, rest);
+		}
+		return obj;
+	};
+	const deepRemoveEmptyObjects = (obj) => {
+		if (require_assertIsBoolean.isArray(obj)) return obj.map(deepRemoveEmptyObjects).filter((item) => !(require_assertIsBoolean.isObjectOrArray(item) && Object.keys(item).length === 0));
+		if (require_assertIsBoolean.isObjectOrArray(obj)) return Object.fromEntries(Object.entries(obj).map(([k, v]) => [k, deepRemoveEmptyObjects(v)]).filter(([, v]) => !require_assertIsBoolean.isUndefined(v) && !(require_assertIsBoolean.isObjectOrArray(v) && Object.keys(v).length === 0)));
+		return obj;
+	};
+	const result = require_safeJsonParse.safeJsonParse(require_safeStableStringify.safeStableStringify(object));
+	for (const key of keysToOmit) omitAtPath(result, key.split("."));
+	return deepRemoveEmptyObjects(result);
+};
+exports.findDuplicates = findDuplicates;
+exports.omitKeys = omitKeys;
+exports.omitKeysDeep = omitKeysDeep;
+//# sourceMappingURL=index.cjs.map

package/dist/operations/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["isEqual","isPlainObject","isPlainObject","isNonEmptyArray","safeStableStringify","isObjectOrArray","isEmptyArray","isArray","isNaN","isUndefined","safeJsonParse"],"sources":["../../src/operations/findDuplicates.ts","../../src/operations/omitKeys.ts","../../src/operations/omitKeysDeep.ts"],"sourcesContent":["import { isEqual } from \"@/predicates/is/isEqual\";\nimport { assertIsArray } from \"@/assertions/objects/assertIsArray\";\n\n/** ----------------------------------------------------------------------\n * * ***Utility: `findDuplicates`.***\n * ----------------------------------------------------------------------\n * **Finds duplicate values in an array by deep equality comparison.**\n * - **Behavior:**\n *    - Uses ***`isEqual` utility function*** to compare elements\n *      (handles objects, arrays, dates, NaN, etc.).\n *    - Returns a new array containing only the *first occurrences* of duplicated values.\n *    - Does **not mutate** the original array.\n *    - Throws ***{@link TypeError | `TypeError`}*** if input is not an array.\n * @template T Type of elements in the input array.\n * @param {T[]} values - The array to check for duplicates.\n * @returns {T[]} An array of the duplicate values found in the input,\n *                preserving order of their first duplicate appearance.\n * @throws **{@link TypeError | `TypeError`}** if the provided `values` argument is not an array.\n * @example\n * findDuplicates([1, 2, 2, 3, 4, 4]);\n * // ➔ [2, 4]\n * findDuplicates([\"apple\", \"banana\", \"apple\", \"orange\"]);\n * // ➔ [\"apple\"]\n * findDuplicates([{ a: 1 }, { a: 1 }, { a: 2 }]);\n * // ➔ [{ a: 1 }]\n * findDuplicates([NaN, NaN, 1]);\n * // ➔ [NaN]\n * findDuplicates([true, false, true]);\n * // ➔ [true]\n * findDuplicates([1, 2, 3]);\n * // ➔ []\n */\nexport const findDuplicates = <T>(values: T[]): T[] => {\n  assertIsArray(values, {\n    message: ({ currentType, validType }) =>\n      `First parameter (\\`values\\`) must be of type \\`${validType}\\` (array literal or instance), but received: \\`${currentType}\\`.`\n  });\n\n  const duplicates: T[] = [];\n  values.forEach((item, index) => {\n    for (let i = index + 1; i < values.length; i++) {\n      if (isEqual(item, values[i])) {\n        if (!duplicates.some((dup) => isEqual(dup, item))) {\n          duplicates.push(item);\n        }\n        break;\n      }\n    }\n  });\n\n  return duplicates;\n};\n","import { findDuplicates } from \"./findDuplicates\";\nimport { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { assertIsArray } from \"@/assertions/objects/assertIsArray\";\n\n/** --------------------------------\n * * ***Utility: `omitKeys`.***\n * --------------------------------\n * **This function creates a shallow copy of the given object omitting the\n *  specified keys.**\n * - **Behavior:**\n *    - It will return a new object without mutating the original.\n *    - It also validates that ***`keysToOmit`*** does not contain duplicate keys.\n * - **ℹ️ Internally:**\n *    - It uses ***`isEqual`*** to check for duplicates in\n *      the ***`keysToOmit`*** array.\n * @template I The type of the input object.\n * @template K The keys to omit from the object.\n * @param {I} object - The source object to omit keys from.\n * @param {K[]} keysToOmit - An array of keys to exclude from the returned object.\n * @returns {Omit<I, K>} A new object without the specified keys.\n * @throws **{@link TypeError | `TypeError`}** if `keysToOmit` is not an array.\n * @throws **{@link Error | `Error`}** if duplicate keys are found in `keysToOmit`.\n * @example\n * omitKeys({ a: 1, b: 2, c: 3 }, [\"b\", \"c\"]);\n * //➔ { a: 1 }\n * omitKeys({ name: \"John\", age: 30 }, [\"age\"]);\n * //➔ { name: \"John\" }\n * omitKeys({ a: 1, b: 2 }, []);\n * //➔ { a: 1, b: 2 } (no changes)\n */\nexport const omitKeys = <I extends Record<string, unknown>, K extends keyof I>(\n  object: I,\n  keysToOmit: K[]\n): Omit<I, K> => {\n  if (!isPlainObject(object)) return {} as Omit<I, K>;\n\n  assertIsArray(keysToOmit, {\n    message: ({ currentType, validType }) =>\n      `Second parameter (\\`keysToOmit\\`) must be of type \\`${validType}\\` (array literal or instance), but received: \\`${currentType}\\`.`\n  });\n\n  // Check for duplicate keys\n  const duplicates = findDuplicates(keysToOmit);\n  if (duplicates.length > 0) {\n    throw new Error(\n      `Function \"omitKeys\" Error: Duplicate keys detected - \\`${duplicates}\\``\n    );\n  }\n\n  // Remove specified keys\n  return Object.fromEntries(\n    Object.entries(object).filter(([key]) => !keysToOmit.includes(key as K))\n  ) as Omit<I, K>;\n};\n","import type { NumberRangeUnion } from \"@rzl-zone/ts-types-plus\";\n\nimport { findDuplicates } from \"./findDuplicates\";\n\nimport { isNaN } from \"@/predicates/is/isNaN\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isUndefined } from \"@/predicates/is/isUndefined\";\nimport { isEmptyArray } from \"@/predicates/is/isEmptyArray\";\nimport { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { isNonEmptyArray } from \"@/predicates/is/isNonEmptyArray\";\nimport { isObjectOrArray } from \"@/predicates/is/isObjectOrArray\";\n\nimport { assertIsArray } from \"@/assertions/objects/assertIsArray\";\n\nimport { safeJsonParse } from \"@/conversions/json/safeJsonParse\";\nimport { safeStableStringify } from \"@/conversions/stringify/safeStableStringify\";\n\ntype IndexArray = NumberRangeUnion<0, 30>;\ntype DotPath<T, Prev extends string = \"\"> =\n  T extends Array<infer U>\n    ? DotPath<U, `${Prev}${Prev extends \"\" ? \"\" : \".\"}${IndexArray}`>\n    : T extends object\n      ? {\n          [K in keyof T & string]:\n            | `${Prev}${Prev extends \"\" ? \"\" : \".\"}${K}`\n            | DotPath<T[K], `${Prev}${Prev extends \"\" ? \"\" : \".\"}${K}`>;\n        }[keyof T & string]\n      : never;\n\n/** ------------------------------------------------------\n * * ***Utility: `omitKeysDeep`.***\n * ------------------------------------------------------\n * **Recursively omits properties from an object using dot notation paths.**\n * - **Behavior:**\n *    - Removes resulting empty objects (`{}`) and arrays (`[]`), cascading upwards\n *      to remove empty parents until root if needed.\n * - **⚠️ Be careful:**\n *    - If after omission an object or array becomes empty, it will be removed entirely\n *      including all the way up to the root if necessary, resulting in `{}`.\n * - **ℹ️ Note:**\n *    - For array indices, TypeScript autocomplete only suggests `0`–`30`\n *      (to prevent editor lag on large unions).\n *      However, higher indices are still fully supported at runtime — you can\n *      manually type `\"arr.99.key\"` and it will work the same.\n * @template I - Type of the input object\n * @param {I} object\n *  The object to process, should be a plain nested object or array structure.\n * @param {DotPath<I>[]} keysToOmit\n *  An array of string paths in dot notation indicating the properties to remove, paths\n *  can include numeric indices to target array elements, e.g. `\"arr.0.x\"` to\n *  remove `x` from the first object inside the `arr` array.\n * @returns {Partial<I>}\n *  A new deeply cloned object with the specified keys omitted, with resulting\n *  empty objects or arrays fully removed (even if it collapses to `{}`).\n * @throws **{@link TypeError | `TypeError`}** if `keysToOmit` is not an array.\n * @throws **{@link Error | `Error`}** if `keysToOmit` contains duplicate paths.\n * @example\n * omitKeysDeep({ arr: [{ a: 1 }] }, [\"arr.0.a\"]);\n * // ➔ {} (array becomes empty and removed)\n * omitKeysDeep({ a: { b: { c: 1 }, d: 2 }, e: 3 }, [\"a.b.c\"]);\n * // ➔ { a: { d: 2 }, e: 3 }\n * omitKeysDeep({ a: [{ b: 1 }, { c: 2 }] }, [\"a.0.b\"]);\n * // ➔ { a: [{ c: 2 }] }\n * omitKeysDeep({ a: [{ b: 1 }] }, [\"a.0.b\"]);\n * // ➔ {} (array becomes empty and removed)\n * omitKeysDeep({ complex: [{ deep: [{ x: 1, y: 2 }] }] }, [\"complex.0.deep.0.x\"]);\n * // ➔ { complex: [{ deep: [{ y: 2 }] }] }\n * omitKeysDeep({ complex: [{ deep: [{ x: 1 }] }] }, [\"complex.0.deep.0.x\"]);\n * // ➔ {} (deep chain emptied and collapsed)\n * omitKeysDeep({ data: [[{ foo: 1, bar: 2 }]] }, [\"data.0.0.foo\"]);\n * // ➔ { data: [[{ bar: 2 }]] }\n * omitKeysDeep({ data: [[{ foo: 1 }]] }, [\"data.0.0.foo\"]);\n * // ➔ {} (nested arrays emptied completely)\n * omitKeysDeep({ x: [{ y: [{ z: 1 }, { w: 2 }] }] }, [\"x.0.y.0.z\"]);\n * // ➔ { x: [{ y: [{ w: 2 }] }] }\n * omitKeysDeep({ x: [{ y: [{ z: 1 }] }] }, [\"x.0.y.0.z\"]);\n * // ➔ {} (entire nested arrays removed)\n * omitKeysDeep({ p: { q: { r: 5 } }, s: 6 }, [\"p.q.r\"]);\n * // ➔ { s: 6 } (`p` removed because it becomes empty)\n * omitKeysDeep({ arr: [{ a: 1, b: 2 }, { c: 3 }] }, [\"arr.0.a\"]);\n * // ➔ { arr: [{ b: 2 }, { c: 3 }] }\n * omitKeysDeep({ root: [{ sub: [{ leaf: 10 }] }] }, [\"root.0.sub.0.leaf\"]);\n * // ➔ {} (deep nested arrays emptied to root)\n * omitKeysDeep({ meta: { tags: [\"x\", \"y\"], count: 2 } }, [\"meta.count\"]);\n * // ➔ { meta: { tags: [\"x\", \"y\"] } }\n * omitKeysDeep({ arr: [[{ a: 1 }, { b: 2 }]] }, [\"arr.0.0.a\"]);\n * // ➔ { arr: [[{ b: 2 }]] }\n * omitKeysDeep({ arr: [[{ a: 1 }]] }, [\"arr.0.0.a\"]);\n * // ➔ {} (double nested emptied)\n * omitKeysDeep({ nested: [{ list: [{ id: 1, val: 2 }] }] }, [\"nested.0.list.0.val\"]);\n * // ➔ { nested: [{ list: [{ id: 1 }] }] }\n * omitKeysDeep({ nested: [{ list: [{ id: 1 }] }] }, [\"nested.0.list.0.id\"]);\n * // ➔ {} (full collapse to empty)\n * omitKeysDeep({ mixed: { a: [1, 2, 3], b: { c: 4 } } }, [\"mixed.b.c\"]);\n * // ➔ { mixed: { a: [1, 2, 3] } }\n */\nexport const omitKeysDeep = <I extends Record<string, unknown>>(\n  object: I,\n  keysToOmit: DotPath<I>[]\n): Partial<I> => {\n  if (!isPlainObject(object)) return {} as Partial<I>;\n\n  assertIsArray(keysToOmit, {\n    message: ({ currentType, validType }) =>\n      `Second parameter (\\`keysToOmit\\`) must be of type \\`${validType}\\` (array literal or instance), but received: \\`${currentType}\\`.`\n  });\n\n  const duplicates = findDuplicates(keysToOmit);\n  if (isNonEmptyArray(duplicates)) {\n    throw new Error(\n      `Function \"omitKeysDeep\" Error: Duplicate keys detected - \\`${safeStableStringify(\n        duplicates,\n        {\n          keepUndefined: true\n        }\n      )}\\`.`\n    );\n  }\n\n  const omitAtPath = (obj: unknown, pathParts: string[]) => {\n    if (!isObjectOrArray(obj)) return obj;\n\n    const [current, ...rest] = pathParts;\n\n    if (isEmptyArray(rest)) {\n      if (isArray(obj)) {\n        // Support numeric index\n        const index = parseInt(current);\n        if (!isNaN(index) && index in obj) {\n          obj.splice(index, 1);\n        }\n      } else {\n        delete obj[current];\n      }\n    } else {\n      const next = obj[current];\n      if (isObjectOrArray(next)) {\n        obj[current] = omitAtPath(next, rest);\n      }\n    }\n    return obj;\n  };\n\n  const deepRemoveEmptyObjects = (obj: unknown): unknown => {\n    if (isArray(obj)) {\n      return obj\n        .map(deepRemoveEmptyObjects)\n        .filter(\n          (item) => !(isObjectOrArray(item) && Object.keys(item).length === 0)\n        );\n    }\n    if (isObjectOrArray(obj)) {\n      const cleaned = Object.fromEntries(\n        Object.entries(obj)\n          .map(([k, v]) => [k, deepRemoveEmptyObjects(v)])\n          .filter(\n            ([, v]) =>\n              !isUndefined(v) &&\n              !(isObjectOrArray(v) && Object.keys(v).length === 0)\n          )\n      );\n      return cleaned;\n    }\n    return obj;\n  };\n\n  const result = safeJsonParse(safeStableStringify(object)); // clone deep to avoid mutating original\n  for (const key of keysToOmit) {\n    const parts = key.split(\".\");\n    omitAtPath(result, parts);\n  }\n\n  return deepRemoveEmptyObjects(result) as Partial<I>;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,MAAa,kBAAqB,WAAqB;CACrD,oCAAc,QAAQ,EACpB,UAAU,EAAE,aAAa,gBACvB,kDAAkD,UAAU,kDAAkD,YAAY,MAC7H,CAAC;CAEF,MAAM,aAAkB,EAAE;CAC1B,OAAO,SAAS,MAAM,UAAU;EAC9B,KAAK,IAAI,IAAI,QAAQ,GAAG,IAAI,OAAO,QAAQ,KACzC,IAAIA,wBAAQ,MAAM,OAAO,GAAG,EAAE;GAC5B,IAAI,CAAC,WAAW,MAAM,QAAQA,wBAAQ,KAAK,KAAK,CAAC,EAC/C,WAAW,KAAK,KAAK;GAEvB;;GAGJ;CAEF,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACpBT,MAAa,YACX,QACA,eACe;CACf,IAAI,CAACC,sCAAc,OAAO,EAAE,OAAO,EAAE;CAErC,oCAAc,YAAY,EACxB,UAAU,EAAE,aAAa,gBACvB,uDAAuD,UAAU,kDAAkD,YAAY,MAClI,CAAC;CAGF,MAAM,aAAa,eAAe,WAAW;CAC7C,IAAI,WAAW,SAAS,GACtB,MAAM,IAAI,MACR,0DAA0D,WAAW,IACtE;CAIH,OAAO,OAAO,YACZ,OAAO,QAAQ,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,SAAS,IAAS,CAAC,CACzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AC4CH,MAAa,gBACX,QACA,eACe;CACf,IAAI,CAACC,sCAAc,OAAO,EAAE,OAAO,EAAE;CAErC,oCAAc,YAAY,EACxB,UAAU,EAAE,aAAa,gBACvB,uDAAuD,UAAU,kDAAkD,YAAY,MAClI,CAAC;CAEF,MAAM,aAAa,eAAe,WAAW;CAC7C,IAAIC,wCAAgB,WAAW,EAC7B,MAAM,IAAI,MACR,8DAA8DC,gDAC5D,YACA,EACE,eAAe,MAChB,CACF,CAAC,KACH;CAGH,MAAM,cAAc,KAAc,cAAwB;EACxD,IAAI,CAACC,wCAAgB,IAAI,EAAE,OAAO;EAElC,MAAM,CAAC,SAAS,GAAG,QAAQ;EAE3B,IAAIC,mCAAa,KAAK,EACpB,IAAIC,gCAAQ,IAAI,EAAE;GAEhB,MAAM,QAAQ,SAAS,QAAQ;GAC/B,IAAI,CAACC,8BAAM,MAAM,IAAI,SAAS,KAC5B,IAAI,OAAO,OAAO,EAAE;SAGtB,OAAO,IAAI;OAER;GACL,MAAM,OAAO,IAAI;GACjB,IAAIH,wCAAgB,KAAK,EACvB,IAAI,WAAW,WAAW,MAAM,KAAK;;EAGzC,OAAO;;CAGT,MAAM,0BAA0B,QAA0B;EACxD,IAAIE,gCAAQ,IAAI,EACd,OAAO,IACJ,IAAI,uBAAuB,CAC3B,QACE,SAAS,EAAEF,wCAAgB,KAAK,IAAI,OAAO,KAAK,KAAK,CAAC,WAAW,GACnE;EAEL,IAAIA,wCAAgB,IAAI,EAUtB,OATgB,OAAO,YACrB,OAAO,QAAQ,IAAI,CAChB,KAAK,CAAC,GAAG,OAAO,CAAC,GAAG,uBAAuB,EAAE,CAAC,CAAC,CAC/C,QACE,GAAG,OACF,CAACI,oCAAY,EAAE,IACf,EAAEJ,wCAAgB,EAAE,IAAI,OAAO,KAAK,EAAE,CAAC,WAAW,GACrD,CAES;EAEhB,OAAO;;CAGT,MAAM,SAASK,oCAAcN,gDAAoB,OAAO,CAAC;CACzD,KAAK,MAAM,OAAO,YAEhB,WAAW,QADG,IAAI,MAAM,IACA,CAAC;CAG3B,OAAO,uBAAuB,OAAO"}

package/dist/operations/index.d.cts

@@ -0,0 +1,139 @@
+/*!
+* ========================================================================
+*  @rzl-zone/utils-js
+* ------------------------------------------------------------------------
+*  Version: `3.12.1-beta.0`
+*  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
+*  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
+* ========================================================================
+*/
+
+import { NumberRangeUnion } from "@rzl-zone/ts-types-plus";
+/** ----------------------------------------------------------------------
+ * * ***Utility: `findDuplicates`.***
+ * ----------------------------------------------------------------------
+ * **Finds duplicate values in an array by deep equality comparison.**
+ * - **Behavior:**
+ *    - Uses ***`isEqual` utility function*** to compare elements
+ *      (handles objects, arrays, dates, NaN, etc.).
+ *    - Returns a new array containing only the *first occurrences* of duplicated values.
+ *    - Does **not mutate** the original array.
+ *    - Throws ***{@link TypeError | `TypeError`}*** if input is not an array.
+ * @template T Type of elements in the input array.
+ * @param {T[]} values - The array to check for duplicates.
+ * @returns {T[]} An array of the duplicate values found in the input,
+ *                preserving order of their first duplicate appearance.
+ * @throws **{@link TypeError | `TypeError`}** if the provided `values` argument is not an array.
+ * @example
+ * findDuplicates([1, 2, 2, 3, 4, 4]);
+ * // ➔ [2, 4]
+ * findDuplicates(["apple", "banana", "apple", "orange"]);
+ * // ➔ ["apple"]
+ * findDuplicates([{ a: 1 }, { a: 1 }, { a: 2 }]);
+ * // ➔ [{ a: 1 }]
+ * findDuplicates([NaN, NaN, 1]);
+ * // ➔ [NaN]
+ * findDuplicates([true, false, true]);
+ * // ➔ [true]
+ * findDuplicates([1, 2, 3]);
+ * // ➔ []
+ */
+declare const findDuplicates: <T>(values: T[]) => T[];
+/** --------------------------------
+ * * ***Utility: `omitKeys`.***
+ * --------------------------------
+ * **This function creates a shallow copy of the given object omitting the
+ *  specified keys.**
+ * - **Behavior:**
+ *    - It will return a new object without mutating the original.
+ *    - It also validates that ***`keysToOmit`*** does not contain duplicate keys.
+ * - **ℹ️ Internally:**
+ *    - It uses ***`isEqual`*** to check for duplicates in
+ *      the ***`keysToOmit`*** array.
+ * @template I The type of the input object.
+ * @template K The keys to omit from the object.
+ * @param {I} object - The source object to omit keys from.
+ * @param {K[]} keysToOmit - An array of keys to exclude from the returned object.
+ * @returns {Omit<I, K>} A new object without the specified keys.
+ * @throws **{@link TypeError | `TypeError`}** if `keysToOmit` is not an array.
+ * @throws **{@link Error | `Error`}** if duplicate keys are found in `keysToOmit`.
+ * @example
+ * omitKeys({ a: 1, b: 2, c: 3 }, ["b", "c"]);
+ * //➔ { a: 1 }
+ * omitKeys({ name: "John", age: 30 }, ["age"]);
+ * //➔ { name: "John" }
+ * omitKeys({ a: 1, b: 2 }, []);
+ * //➔ { a: 1, b: 2 } (no changes)
+ */
+declare const omitKeys: <I extends Record<string, unknown>, K extends keyof I>(object: I, keysToOmit: K[]) => Omit<I, K>;
+type IndexArray = NumberRangeUnion<0, 30>;
+type DotPath<T, Prev extends string = ""> = T extends Array<infer U> ? DotPath<U, `${Prev}${Prev extends "" ? "" : "."}${IndexArray}`> : T extends object ? { [K in keyof T & string]: `${Prev}${Prev extends "" ? "" : "."}${K}` | DotPath<T[K], `${Prev}${Prev extends "" ? "" : "."}${K}`> }[keyof T & string] : never;
+/** ------------------------------------------------------
+ * * ***Utility: `omitKeysDeep`.***
+ * ------------------------------------------------------
+ * **Recursively omits properties from an object using dot notation paths.**
+ * - **Behavior:**
+ *    - Removes resulting empty objects (`{}`) and arrays (`[]`), cascading upwards
+ *      to remove empty parents until root if needed.
+ * - **⚠️ Be careful:**
+ *    - If after omission an object or array becomes empty, it will be removed entirely
+ *      including all the way up to the root if necessary, resulting in `{}`.
+ * - **ℹ️ Note:**
+ *    - For array indices, TypeScript autocomplete only suggests `0`–`30`
+ *      (to prevent editor lag on large unions).
+ *      However, higher indices are still fully supported at runtime — you can
+ *      manually type `"arr.99.key"` and it will work the same.
+ * @template I - Type of the input object
+ * @param {I} object
+ *  The object to process, should be a plain nested object or array structure.
+ * @param {DotPath<I>[]} keysToOmit
+ *  An array of string paths in dot notation indicating the properties to remove, paths
+ *  can include numeric indices to target array elements, e.g. `"arr.0.x"` to
+ *  remove `x` from the first object inside the `arr` array.
+ * @returns {Partial<I>}
+ *  A new deeply cloned object with the specified keys omitted, with resulting
+ *  empty objects or arrays fully removed (even if it collapses to `{}`).
+ * @throws **{@link TypeError | `TypeError`}** if `keysToOmit` is not an array.
+ * @throws **{@link Error | `Error`}** if `keysToOmit` contains duplicate paths.
+ * @example
+ * omitKeysDeep({ arr: [{ a: 1 }] }, ["arr.0.a"]);
+ * // ➔ {} (array becomes empty and removed)
+ * omitKeysDeep({ a: { b: { c: 1 }, d: 2 }, e: 3 }, ["a.b.c"]);
+ * // ➔ { a: { d: 2 }, e: 3 }
+ * omitKeysDeep({ a: [{ b: 1 }, { c: 2 }] }, ["a.0.b"]);
+ * // ➔ { a: [{ c: 2 }] }
+ * omitKeysDeep({ a: [{ b: 1 }] }, ["a.0.b"]);
+ * // ➔ {} (array becomes empty and removed)
+ * omitKeysDeep({ complex: [{ deep: [{ x: 1, y: 2 }] }] }, ["complex.0.deep.0.x"]);
+ * // ➔ { complex: [{ deep: [{ y: 2 }] }] }
+ * omitKeysDeep({ complex: [{ deep: [{ x: 1 }] }] }, ["complex.0.deep.0.x"]);
+ * // ➔ {} (deep chain emptied and collapsed)
+ * omitKeysDeep({ data: [[{ foo: 1, bar: 2 }]] }, ["data.0.0.foo"]);
+ * // ➔ { data: [[{ bar: 2 }]] }
+ * omitKeysDeep({ data: [[{ foo: 1 }]] }, ["data.0.0.foo"]);
+ * // ➔ {} (nested arrays emptied completely)
+ * omitKeysDeep({ x: [{ y: [{ z: 1 }, { w: 2 }] }] }, ["x.0.y.0.z"]);
+ * // ➔ { x: [{ y: [{ w: 2 }] }] }
+ * omitKeysDeep({ x: [{ y: [{ z: 1 }] }] }, ["x.0.y.0.z"]);
+ * // ➔ {} (entire nested arrays removed)
+ * omitKeysDeep({ p: { q: { r: 5 } }, s: 6 }, ["p.q.r"]);
+ * // ➔ { s: 6 } (`p` removed because it becomes empty)
+ * omitKeysDeep({ arr: [{ a: 1, b: 2 }, { c: 3 }] }, ["arr.0.a"]);
+ * // ➔ { arr: [{ b: 2 }, { c: 3 }] }
+ * omitKeysDeep({ root: [{ sub: [{ leaf: 10 }] }] }, ["root.0.sub.0.leaf"]);
+ * // ➔ {} (deep nested arrays emptied to root)
+ * omitKeysDeep({ meta: { tags: ["x", "y"], count: 2 } }, ["meta.count"]);
+ * // ➔ { meta: { tags: ["x", "y"] } }
+ * omitKeysDeep({ arr: [[{ a: 1 }, { b: 2 }]] }, ["arr.0.0.a"]);
+ * // ➔ { arr: [[{ b: 2 }]] }
+ * omitKeysDeep({ arr: [[{ a: 1 }]] }, ["arr.0.0.a"]);
+ * // ➔ {} (double nested emptied)
+ * omitKeysDeep({ nested: [{ list: [{ id: 1, val: 2 }] }] }, ["nested.0.list.0.val"]);
+ * // ➔ { nested: [{ list: [{ id: 1 }] }] }
+ * omitKeysDeep({ nested: [{ list: [{ id: 1 }] }] }, ["nested.0.list.0.id"]);
+ * // ➔ {} (full collapse to empty)
+ * omitKeysDeep({ mixed: { a: [1, 2, 3], b: { c: 4 } } }, ["mixed.b.c"]);
+ * // ➔ { mixed: { a: [1, 2, 3] } }
+ */
+declare const omitKeysDeep: <I extends Record<string, unknown>>(object: I, keysToOmit: DotPath<I>[]) => Partial<I>;
+export { findDuplicates, omitKeys, omitKeysDeep };

package/dist/operations/index.d.ts

@@ -1,14 +1,14 @@
 /*!
- * ====================================================
- * Rzl Utils-JS.
- * ----------------------------------------------------
- * Version: 3.11.1.
- * Author: Rizalvin Dwiky.
- * Repository: https://github.com/rzl-zone/utils-js.
- * ====================================================
- */
-import { NumberRangeUnion } from '@rzl-zone/ts-types-plus';
+* ========================================================================
+*  @rzl-zone/utils-js
+* ------------------------------------------------------------------------
+*  Version: `3.12.1-beta.0`
+*  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
+*  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
+* ========================================================================
+*/
 
+import { NumberRangeUnion } from "@rzl-zone/ts-types-plus";
 /** ----------------------------------------------------------------------
  * * ***Utility: `findDuplicates`.***
  * ----------------------------------------------------------------------
@@ -39,7 +39,6 @@ import { NumberRangeUnion } from '@rzl-zone/ts-types-plus';
  * // ➔ []
  */
 declare const findDuplicates: <T>(values: T[]) => T[];
-
 /** --------------------------------
  * * ***Utility: `omitKeys`.***
  * --------------------------------
@@ -67,11 +66,8 @@ declare const findDuplicates: <T>(values: T[]) => T[];
  * //➔ { a: 1, b: 2 } (no changes)
  */
 declare const omitKeys: <I extends Record<string, unknown>, K extends keyof I>(object: I, keysToOmit: K[]) => Omit<I, K>;
-
 type IndexArray = NumberRangeUnion<0, 30>;
-type DotPath<T, Prev extends string = ""> = T extends Array<infer U> ? DotPath<U, `${Prev}${Prev extends "" ? "" : "."}${IndexArray}`> : T extends object ? {
-    [K in keyof T & string]: `${Prev}${Prev extends "" ? "" : "."}${K}` | DotPath<T[K], `${Prev}${Prev extends "" ? "" : "."}${K}`>;
-}[keyof T & string] : never;
+type DotPath<T, Prev extends string = ""> = T extends Array<infer U> ? DotPath<U, `${Prev}${Prev extends "" ? "" : "."}${IndexArray}`> : T extends object ? { [K in keyof T & string]: `${Prev}${Prev extends "" ? "" : "."}${K}` | DotPath<T[K], `${Prev}${Prev extends "" ? "" : "."}${K}`> }[keyof T & string] : never;
 /** ------------------------------------------------------
  * * ***Utility: `omitKeysDeep`.***
  * ------------------------------------------------------
@@ -140,5 +136,4 @@ type DotPath<T, Prev extends string = ""> = T extends Array<infer U> ? DotPath<U
  * // ➔ { mixed: { a: [1, 2, 3] } }
  */
 declare const omitKeysDeep: <I extends Record<string, unknown>>(object: I, keysToOmit: DotPath<I>[]) => Partial<I>;
-
 export { findDuplicates, omitKeys, omitKeysDeep };