@rzl-zone/utils-js 3.13.1-beta.0 → 3.14.0-beta.0

package/dist/safeJsonParse-D1FLVTEM.cjs

@@ -0,0 +1,209 @@
+/*!
+* ========================================================================
+*  @rzl-zone/utils-js
+* ------------------------------------------------------------------------
+*  Version: `3.14.0-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_logger = require('./logger-CUacYy3D.cjs');
+const require_isNumber = require('./isNumber-BkzwAe50.cjs');
+const require_isEmptyValue = require('./isEmptyValue-CFExALXZ.cjs');
+const require_safeStableStringify = require('./safeStableStringify-C5HHKUdn.cjs');
+const require_noop = require('./noop-CjEbNsJL.cjs');
+const parseCustomDate = (dateString, format) => {
+	if (!require_logger.isNonEmptyString(dateString) || !require_logger.isNonEmptyString(format)) throw new TypeError(require_logger.createMessage("parseCustomDate", `Parameter \`dateString\` and \`format\` must be of type \`string\` and not empty-string, but received: "['dateString': \`${require_logger.getPreciseType(dateString)}\` - (current value: \`${require_safeStableStringify.safeStableStringify(dateString, { keepUndefined: true })}\`), 'format': \`${require_logger.getPreciseType(format)}\` - (current value: \`${require_safeStableStringify.safeStableStringify(format, { keepUndefined: true })}\`)]".`));
+	const dateParts = dateString.split(/[-/]/).map(Number);
+	if (dateParts.length !== 3 || dateParts.some(isNaN)) return null;
+	let day, month, year;
+	if (format === "DD/MM/YYYY") [day, month, year] = dateParts;
+	else if (format === "MM/DD/YYYY") [month, day, year] = dateParts;
+	else return null;
+	if (month) month -= 1;
+	const date = year && month && day ? new Date(year, month, day) : void 0;
+	if (!date || date.getFullYear() !== year || date.getMonth() !== month || date.getDate() !== day) return null;
+	return date;
+};
+const validateJsonParsingOptions = (optionsValue, calledFromSource) => {
+	if (!require_logger.isPlainObject(optionsValue)) optionsValue = {};
+	const convertBooleans = optionsValue.convertBooleans ?? false;
+	const convertDates = optionsValue.convertDates ?? false;
+	const convertNumbers = optionsValue.convertNumbers ?? false;
+	const loggingOnFail = optionsValue.loggingOnFail ?? false;
+	const removeEmptyArrays = optionsValue.removeEmptyArrays ?? false;
+	const removeEmptyObjects = optionsValue.removeEmptyObjects ?? false;
+	const removeNulls = optionsValue.removeNulls ?? false;
+	const removeUndefined = optionsValue.removeUndefined ?? false;
+	const strictMode = optionsValue.strictMode ?? false;
+	const checkSymbols = optionsValue.checkSymbols ?? false;
+	const convertNaN = optionsValue.convertNaN ?? false;
+	const customDateFormats = optionsValue.customDateFormats ?? [];
+	const onError = optionsValue.onError ?? require_noop.noop;
+	if (!(require_logger.isBoolean(convertBooleans) && require_logger.isBoolean(convertDates) && require_logger.isBoolean(convertNumbers) && require_logger.isBoolean(convertNaN) && require_logger.isBoolean(checkSymbols) && require_logger.isBoolean(loggingOnFail) && require_logger.isBoolean(removeEmptyArrays) && require_logger.isBoolean(removeEmptyObjects) && require_logger.isBoolean(removeNulls) && require_logger.isBoolean(removeUndefined) && require_logger.isBoolean(strictMode) && require_logger.isArray(customDateFormats) && require_logger.isFunction(onError))) throw new TypeError(require_logger.createMessage(calledFromSource, `Invalid \`options\` parameter (second argument): \`convertBooleans\`, \`convertDates\`, \`convertNumbers\`, \`loggingOnFail\`, \`removeEmptyArrays\`, \`removeEmptyObjects\`, \`removeNulls\`, \`removeUndefined\`, \`strictMode\` expected to be a \`boolean\` type, \`customDateFormats\` expected to be a \`array\` type and \`onError\` expected to be a \`void function\` type. But received: ['convertBooleans': \`${require_logger.getPreciseType(convertBooleans)}\`, 'convertDates': \`${require_logger.getPreciseType(convertDates)}\`, 'convertNumbers': \`${require_logger.getPreciseType(convertNumbers)}\`, 'loggingOnFail': \`${require_logger.getPreciseType(loggingOnFail)}\`, 'removeEmptyArrays': \`${require_logger.getPreciseType(removeEmptyArrays)}\`, 'removeEmptyObjects': \`${require_logger.getPreciseType(removeEmptyObjects)}\`, 'removeNulls': \`${require_logger.getPreciseType(removeNulls)}\`, 'removeUndefined': \`${require_logger.getPreciseType(removeUndefined)}\`, 'strictMode': \`${require_logger.getPreciseType(strictMode)}\`, 'customDateFormats': \`${require_logger.getPreciseType(customDateFormats)}\`, 'onError': \`${require_logger.getPreciseType(onError)}\`].`));
+	return {
+		convertBooleans,
+		convertDates,
+		convertNumbers,
+		convertNaN,
+		loggingOnFail,
+		removeEmptyArrays,
+		removeEmptyObjects,
+		removeNulls,
+		removeUndefined,
+		strictMode,
+		customDateFormats,
+		onError,
+		checkSymbols
+	};
+};
+const cleanParsedData = (data, options) => {
+	const validOptions = validateJsonParsingOptions(options ?? {}, "cleanParsedData");
+	if (require_logger.isNull(data)) return validOptions.removeNulls ? void 0 : null;
+	if (require_safeStableStringify.isUndefined(data)) return validOptions.removeUndefined ? void 0 : void 0;
+	if (require_logger.isString(data)) {
+		const trimmed = data.trim();
+		if (validOptions.convertNaN && trimmed === "NaN") return NaN;
+		if (validOptions.convertNumbers && !isNaN(Number(trimmed))) return Number(trimmed);
+		if (validOptions.convertBooleans) {
+			if (trimmed === "true") return true;
+			if (trimmed === "false") return false;
+		}
+		if (validOptions.convertDates) {
+			if (/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/.test(trimmed)) return new Date(trimmed);
+			if (validOptions.customDateFormats?.length) for (const format of validOptions.customDateFormats) {
+				const date = parseCustomDate(trimmed, format);
+				if (date) return date;
+			}
+		}
+		return validOptions.strictMode ? void 0 : trimmed;
+	}
+	if (require_logger.isArray(data)) {
+		const cleanedArray = data.map((item) => cleanParsedData(item, validOptions)).filter((item) => !require_safeStableStringify.isUndefined(item));
+		return validOptions.removeEmptyArrays && require_isEmptyValue.isEmptyArray(cleanedArray) ? void 0 : cleanedArray;
+	}
+	if (require_logger.isObject(data)) {
+		const cleanedObject = {};
+		for (const key in data) if (Object.prototype.hasOwnProperty.call(data, key)) {
+			const cleanedValue = cleanParsedData(data[key], validOptions);
+			if (!require_safeStableStringify.isUndefined(cleanedValue)) cleanedObject[key] = cleanedValue;
+		}
+		return validOptions.removeEmptyObjects && require_isEmptyValue.isEmptyObject(cleanedObject, { checkSymbols: validOptions.checkSymbols }) ? void 0 : cleanedObject;
+	}
+	return validOptions.strictMode ? void 0 : data;
+};
+const extractDigits = (value) => {
+	if (!require_logger.isString(value) && !require_isNumber.isNumber(value)) return 0;
+	const cleaned = String(value).trim().replace(/[^0-9]/g, "");
+	return Number(cleaned) || 0;
+};
+function fixSingleQuotesEscapeBackslash(input) {
+	const validEscapes = new Set([
+		"\\",
+		"\"",
+		"/",
+		"b",
+		"f",
+		"n",
+		"r",
+		"t",
+		"u"
+	]);
+	let output = "";
+	let inSingleQuote = false;
+	let inDoubleQuote = false;
+	let escapeNext = false;
+	for (let i = 0; i < input.length; i++) {
+		const c = input[i] || "";
+		if (escapeNext) {
+			if (inSingleQuote) if (c === "'") output += "'";
+			else if (validEscapes.has(c)) if (c === "\\") output += "\\\\";
+			else if (c === "\"") output += "\\\"";
+			else output += "\\" + c;
+			else output += "\\\\" + c;
+			else if (inDoubleQuote) if (c === "\"") output += "\\\"";
+			else if (validEscapes.has(c)) output += "\\" + c;
+			else output += "\\\\" + c;
+			else output += "\\" + c;
+			escapeNext = false;
+			continue;
+		}
+		if (c === "\\") {
+			escapeNext = true;
+			continue;
+		}
+		if (!inSingleQuote && !inDoubleQuote) {
+			if (c === "'") {
+				output += "\"";
+				inSingleQuote = true;
+				continue;
+			}
+			if (c === "\"") {
+				output += "\"";
+				inDoubleQuote = true;
+				continue;
+			}
+		} else if (inSingleQuote) {
+			if (c === "'") {
+				output += "\"";
+				inSingleQuote = false;
+				continue;
+			}
+		} else if (inDoubleQuote) {
+			if (c === "\"") {
+				output += "\"";
+				inDoubleQuote = false;
+				continue;
+			}
+		}
+		output += c;
+	}
+	return output;
+}
+//! implement main function
+function safeJsonParse(value, options) {
+	if (require_logger.isNull(value)) return null;
+	const validOptions = validateJsonParsingOptions(options ?? {}, "safeJsonParse");
+	if (validOptions.convertNaN && (require_logger.isNaN(value) || require_logger.isNonEmptyString(value) && value === "NaN")) return NaN;
+	if (validOptions.convertNumbers && !require_logger.isNaN(Number(value)) && require_isNumber.isNumber(extractDigits(value))) return Number(value);
+	if (!require_logger.isString(value)) return void 0;
+	try {
+		let normalized = fixSingleQuotesEscapeBackslash(value);
+		if (validOptions.removeUndefined) normalized = normalized.replace(/,\s*"[^"]*"\s*:\s*undefined(?=\s*[},])/g, "").replace(/"[^"]*"\s*:\s*undefined\s*(,)?/g, "");
+		else normalized = normalized.replace(/:\s*undefined(?=\s*[,}])/g, ":null");
+		if (validOptions.convertNaN) normalized = normalized.replace(/:\s*NaN(?=\s*[,}])/g, ":\"NaN\"");
+		else normalized = normalized.replace(/:\s*NaN(?=\s*[,}])/g, ":\"NaN\"").replace(/,\s*"[^"]*"\s*:\s*NaN(?=\s*[},])/g, "").replace(/"[^"]*"\s*:\s*NaN\s*(,)?/g, "");
+		normalized = normalized.replace(/,(\s*[}\]])/g, "$1");
+		return cleanParsedData(JSON.parse(normalized), validOptions);
+	} catch (error) {
+		if (validOptions.loggingOnFail) console.error("Failed to parsing at `[@rzl-zone/utils-js]:safeJsonParse`:", error);
+		validOptions.onError(require_logger.isError(error) ? new Error(error.message.replace(/^JSON\.parse:/, "Failed to parsing")) : new Error(String(error)));
+		return;
+	}
+}
+Object.defineProperty(exports, 'cleanParsedData', {
+  enumerable: true,
+  get: function () {
+    return cleanParsedData;
+  }
+});
+Object.defineProperty(exports, 'extractDigits', {
+  enumerable: true,
+  get: function () {
+    return extractDigits;
+  }
+});
+Object.defineProperty(exports, 'parseCustomDate', {
+  enumerable: true,
+  get: function () {
+    return parseCustomDate;
+  }
+});
+Object.defineProperty(exports, 'safeJsonParse', {
+  enumerable: true,
+  get: function () {
+    return safeJsonParse;
+  }
+});
+//# sourceMappingURL=safeJsonParse-D1FLVTEM.cjs.map

package/dist/safeJsonParse-D1FLVTEM.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeJsonParse-D1FLVTEM.cjs","names":["isNonEmptyString","createMessage","getPreciseType","safeStableStringify","isPlainObject","noop","isBoolean","isArray","isFunction","createMessage","getPreciseType","isNull","isUndefined","isString","isArray","isEmptyArray","isObject","isEmptyObject","isString","isNumber","isNull","isNaN","isNonEmptyString","isNumber","isString","isError"],"sources":["../src/conversions/json/parseCustomDate.ts","../src/conversions/json/_private/utils/validateJsonParsingOptions.ts","../src/conversions/json/cleanParsedData.ts","../src/conversions/numerics/extractDigits.ts","../src/conversions/json/_private/utils/fixSingleQuotesEscapeBackslash.ts","../src/conversions/json/safeJsonParse.ts"],"sourcesContent":["import { createMessage } from \"@/_private/logger\";\n\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\nimport { safeStableStringify } from \"../stringify/safeStableStringify\";\n\n/** ---------------------------------------------------------------------------------------\n * * ***Utility: `parseCustomDate`.***\n * ----------------------------------------------------------------------------------------\n * **Parses custom date formats like `\"DD/MM/YYYY\"` or `\"MM/DD/YYYY\"`.**\n *\n * ---\n * @param {string} dateString - Date string to parse.\n * @param {string} format - Date format to match.\n *\n * ---\n * @throws **{@link TypeError | `TypeError`}** if `dateString` **(first parameter)** and\n *         `format` **(second parameter)** is not a string or empty-string.\n *\n * ---\n * @returns {Date | null} Returns a `Date` object if valid, otherwise `null`.\n *\n * ---\n * @example\n * 1. #### Parse European date format:\n *    ```ts\n *    const date1 = parseCustomDate(\n *      \"03/09/2025\",\n *      \"DD/MM/YYYY\"\n *    );\n *\n *    console.log(date1);\n *    // ➔ Date { Wed Sep 03 2025 ... }\n *    ```\n *    ---\n * 2. #### Parse US date format:\n *    ```ts\n *    const date2 = parseCustomDate(\n *      \"09/03/2025\",\n *      \"MM/DD/YYYY\"\n *    );\n *\n *    console.log(date2);\n *    // ➔ Date { Wed Sep 03 2025 ... }\n *    ```\n *    ---\n * 3. #### Invalid date format:\n *    ```ts\n *    const date3 = parseCustomDate(\n *      \"2025-09-03\",\n *      \"DD/MM/YYYY\"\n *    );\n *\n *    console.log(date3);\n *    // ➔ null\n *    ```\n *    ---\n * 4. #### Invalid date string:\n *    ```ts\n *    const date4 = parseCustomDate(\n *      \"hello\",\n *      \"DD/MM/YYYY\"\n *    );\n *\n *    console.log(date4);\n *    // ➔ null\n *    ```\n *    ---\n * 5. #### Invalid parameter types:\n *    ```ts\n *    parseCustomDate(\n *      123,\n *      \"DD/MM/YYYY\"\n *    );\n *\n *    // ➔ TypeError: Parameter `dateString` and `format` must be of type `string`...\n *    ```\n */\nexport const parseCustomDate = (\n  dateString: string,\n  format: string\n): Date | null => {\n  if (!isNonEmptyString(dateString) || !isNonEmptyString(format)) {\n    throw new TypeError(\n      createMessage(\n        \"parseCustomDate\",\n        `Parameter \\`dateString\\` and \\`format\\` must be of type \\`string\\` and not empty-string, but received: \"['dateString': \\`${getPreciseType(\n          dateString\n        )}\\` - (current value: \\`${safeStableStringify(dateString, {\n          keepUndefined: true\n        })}\\`), 'format': \\`${getPreciseType(\n          format\n        )}\\` - (current value: \\`${safeStableStringify(format, {\n          keepUndefined: true\n        })}\\`)]\".`\n      )\n    );\n  }\n\n  const dateParts = dateString.split(/[-/]/).map(Number);\n  if (dateParts.length !== 3 || dateParts.some(isNaN)) return null;\n\n  let day: number | undefined,\n    month: number | undefined,\n    year: number | undefined;\n\n  if (format === \"DD/MM/YYYY\") {\n    [day, month, year] = dateParts;\n  } else if (format === \"MM/DD/YYYY\") {\n    [month, day, year] = dateParts;\n  } else {\n    return null;\n  }\n\n  if (month) month -= 1;\n  const date = year && month && day ? new Date(year, month, day) : undefined;\n\n  if (\n    !date ||\n    date.getFullYear() !== year ||\n    date.getMonth() !== month ||\n    date.getDate() !== day\n  ) {\n    return null;\n  }\n\n  return date;\n};\n","import type { Prettify } from \"@rzl-zone/ts-types-plus\";\n\nimport type { ParseParsedDataOptions } from \"../types/ParseParsedDataOptions\";\n\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nimport type { cleanParsedData } from \"../../cleanParsedData\";\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nimport type { parseCustomDate } from \"../../parseCustomDate\";\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nimport type { safeJsonParse } from \"../../safeJsonParse\";\n\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isBoolean } from \"@/predicates/is/isBoolean\";\nimport { isFunction } from \"@/predicates/is/isFunction\";\nimport { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\n\nimport { noop } from \"@/generators/utils/noop\";\nimport { createMessage } from \"@/_private/logger\";\n\ntype ValidatedParsedDataOptions = Prettify<Required<ParseParsedDataOptions>>;\n\n/** * ***Private Helper for Options Validation Function: {@link cleanParsedData | `cleanParsedData`}, {@link parseCustomDate | `parseCustomDate`} and {@link safeJsonParse | `safeJsonParse`}.***\n *\n * @internal\n */\nexport const validateJsonParsingOptions = (\n  optionsValue: ParseParsedDataOptions,\n  calledFromSource: string\n): ValidatedParsedDataOptions => {\n  if (!isPlainObject(optionsValue)) optionsValue = {};\n\n  const convertBooleans = optionsValue.convertBooleans ?? false;\n  const convertDates = optionsValue.convertDates ?? false;\n  const convertNumbers = optionsValue.convertNumbers ?? false;\n  const loggingOnFail = optionsValue.loggingOnFail ?? false;\n  const removeEmptyArrays = optionsValue.removeEmptyArrays ?? false;\n  const removeEmptyObjects = optionsValue.removeEmptyObjects ?? false;\n  const removeNulls = optionsValue.removeNulls ?? false;\n  const removeUndefined = optionsValue.removeUndefined ?? false;\n  const strictMode = optionsValue.strictMode ?? false;\n  const checkSymbols = optionsValue.checkSymbols ?? false;\n  const convertNaN = optionsValue.convertNaN ?? false;\n\n  const customDateFormats = optionsValue.customDateFormats ?? [];\n  const onError = optionsValue.onError ?? noop;\n\n  if (\n    !(\n      isBoolean(convertBooleans) &&\n      isBoolean(convertDates) &&\n      isBoolean(convertNumbers) &&\n      isBoolean(convertNaN) &&\n      isBoolean(checkSymbols) &&\n      isBoolean(loggingOnFail) &&\n      isBoolean(removeEmptyArrays) &&\n      isBoolean(removeEmptyObjects) &&\n      isBoolean(removeNulls) &&\n      isBoolean(removeUndefined) &&\n      isBoolean(strictMode) &&\n      isArray(customDateFormats) &&\n      isFunction(onError)\n    )\n  ) {\n    throw new TypeError(\n      createMessage(\n        calledFromSource,\n        `Invalid \\`options\\` parameter (second argument): \\`convertBooleans\\`, \\`convertDates\\`, \\`convertNumbers\\`, \\`loggingOnFail\\`, \\`removeEmptyArrays\\`, \\`removeEmptyObjects\\`, \\`removeNulls\\`, \\`removeUndefined\\`, \\`strictMode\\` expected to be a \\`boolean\\` type, \\`customDateFormats\\` expected to be a \\`array\\` type and \\`onError\\` expected to be a \\`void function\\` type. But received: ['convertBooleans': \\`${getPreciseType(\n          convertBooleans\n        )}\\`, 'convertDates': \\`${getPreciseType(\n          convertDates\n        )}\\`, 'convertNumbers': \\`${getPreciseType(\n          convertNumbers\n        )}\\`, 'loggingOnFail': \\`${getPreciseType(\n          loggingOnFail\n        )}\\`, 'removeEmptyArrays': \\`${getPreciseType(\n          removeEmptyArrays\n        )}\\`, 'removeEmptyObjects': \\`${getPreciseType(\n          removeEmptyObjects\n        )}\\`, 'removeNulls': \\`${getPreciseType(\n          removeNulls\n        )}\\`, 'removeUndefined': \\`${getPreciseType(\n          removeUndefined\n        )}\\`, 'strictMode': \\`${getPreciseType(\n          strictMode\n        )}\\`, 'customDateFormats': \\`${getPreciseType(\n          customDateFormats\n        )}\\`, 'onError': \\`${getPreciseType(onError)}\\`].`\n      )\n    );\n  }\n\n  return {\n    convertBooleans,\n    convertDates,\n    convertNumbers,\n    convertNaN,\n    loggingOnFail,\n    removeEmptyArrays,\n    removeEmptyObjects,\n    removeNulls,\n    removeUndefined,\n    strictMode,\n    customDateFormats,\n    onError,\n    checkSymbols\n  };\n};\n","import type { ParseParsedDataOptions } from \"./_private/types/ParseParsedDataOptions\";\n\nimport { isNull } from \"@/predicates/is/isNull\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isObject } from \"@/predicates/is/isObject\";\nimport { isUndefined } from \"@/predicates/is/isUndefined\";\nimport { isEmptyArray } from \"@/predicates/is/isEmptyArray\";\nimport { isEmptyObject } from \"@/predicates/is/isEmptyObject\";\n\nimport { parseCustomDate } from \"./parseCustomDate\";\nimport { validateJsonParsingOptions } from \"./_private/utils/validateJsonParsingOptions\";\n\n/** --------------------------------------------------------------------------------------------\n * * ***Utility: `cleanParsedData`.***\n * ---------------------------------------------------------------------------------------------\n * **Cleans parsed JSON data based on provided options.**\n *\n * ---\n * @template T - Expected output type.\n *\n * ---\n * @param {*} data - The parsed JSON data.\n * @param {ParseParsedDataOptions} [options] - The cleaning options.\n *\n * ---\n * @returns {T | null | undefined} The cleaned data.\n * - ***⚠️ Notice:*** _If data is JSON string, we recommend use ***`safeJsonParse` utility\n *   function*** for more safe._\n * - ***⚠️ Note:*** _If using **`convertDates`** **options**, result may contain Date objects,\n *   you may need type assertions in strict TypeScript settings._\n *\n * ---\n * @example\n * 1. #### Convert numbers and remove null values:\n *    ```ts\n *    const result = cleanParsedData(\n *      { age: \"25\", name: null },\n *      { convertNumbers: true, removeNulls: true }\n *    );\n *\n *    console.log(result);\n *    // ➔ { age: 25 }\n *    ```\n *    ---\n * 2. #### Convert boolean strings:\n *    ```ts\n *    const result = cleanParsedData(\n *      { isActive: \"true\" },\n *      { convertBooleans: true }\n *    );\n *\n *    console.log(result);\n *    // ➔ { isActive: true }\n *    ```\n */\nexport const cleanParsedData = <T = unknown>(\n  data: T,\n  options?: ParseParsedDataOptions\n): T | undefined | null => {\n  const validOptions = validateJsonParsingOptions(\n    options ?? {},\n    \"cleanParsedData\"\n  );\n\n  if (isNull(data)) return validOptions.removeNulls ? undefined : null;\n  if (isUndefined(data))\n    return validOptions.removeUndefined ? undefined : undefined;\n\n  if (isString(data)) {\n    const trimmed = data.trim();\n\n    if (validOptions.convertNaN && trimmed === \"NaN\") return NaN as T;\n\n    if (validOptions.convertNumbers && !isNaN(Number(trimmed))) {\n      return Number(trimmed) as T;\n    }\n\n    if (validOptions.convertBooleans) {\n      if (trimmed === \"true\") return true as T;\n      if (trimmed === \"false\") return false as T;\n    }\n\n    if (validOptions.convertDates) {\n      if (/^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$/.test(trimmed)) {\n        return new Date(trimmed) as T;\n      }\n\n      if (validOptions.customDateFormats?.length) {\n        for (const format of validOptions.customDateFormats) {\n          const date = parseCustomDate(trimmed, format);\n          if (date) return date as T;\n        }\n      }\n    }\n\n    return validOptions.strictMode ? undefined : (trimmed as T);\n  }\n\n  if (isArray(data)) {\n    const cleanedArray = data\n      .map((item) => cleanParsedData(item, validOptions))\n      .filter((item) => !isUndefined(item));\n\n    return validOptions.removeEmptyArrays && isEmptyArray(cleanedArray)\n      ? undefined\n      : (cleanedArray as T);\n  }\n\n  if (isObject(data)) {\n    const cleanedObject: Record<string, unknown> = {};\n\n    for (const key in data) {\n      if (Object.prototype.hasOwnProperty.call(data, key)) {\n        const cleanedValue = cleanParsedData(data[key], validOptions);\n        if (!isUndefined(cleanedValue)) {\n          cleanedObject[key] = cleanedValue;\n        }\n      }\n    }\n\n    return validOptions.removeEmptyObjects &&\n      isEmptyObject(cleanedObject, { checkSymbols: validOptions.checkSymbols })\n      ? undefined\n      : (cleanedObject as T);\n  }\n\n  return validOptions.strictMode ? undefined : data;\n};\n","import { isNumber } from \"@/predicates/is/isNumber\";\nimport { isString } from \"@/predicates/is/isString\";\n\n/** -----------------------------------------------------------------------------------------------------------------------------------------\n * * ***Utility: `extractDigits`.***\n * ------------------------------------------------------------------------------------------------------------------------------------------\n * **Extracts digits from a string or number input.**\n *\n * ---\n * - **Behavior:**\n *     - Converts the input to a string, trims whitespace, and removes any characters that are not digits (`0-9`).\n *     - Returns the cleaned numeric value as a `number`.\n *     - If the input is a `null`, `undefined`, results in no digits, or not a `string` (or empty-string) or `number`, it safely return `0`.\n *\n * ---\n * @param {*} [value]\n *  ***The value to process.***\n *     - Accepts a string, number, `null`, or `undefined`.\n *\n * ---\n * @returns {number} The numeric value after extracting digits (returns `0` if input is invalid or contains no digits).\n *\n * ---\n * @example\n * extractDigits(12345);\n * // ➔ 12345\n * extractDigits(\"9A8B7C6X1\");\n * // ➔ 98761\n * extractDigits(\"123abc456\");\n * // ➔ 123456\n * extractDigits(\"$1,234.56\");\n * // ➔ 123456\n * extractDigits(NaN);\n * // ➔ 0\n * extractDigits(null);\n * // ➔ 0\n * extractDigits(undefined);\n * // ➔ 0\n * extractDigits(Infinity);\n * // ➔ 0\n * extractDigits(-Infinity);\n * // ➔ 0\n * extractDigits({});\n * // ➔ 0\n * extractDigits([]);\n * // ➔ 0\n * extractDigits(\"\");\n * // ➔ 0\n * extractDigits(\" \");\n * // ➔ 0\n * extractDigits(\"abc\");\n * // ➔ 0\n * extractDigits(\"   00a  \");\n * // ➔ 0\n */\nexport const extractDigits = (value: unknown): number => {\n  if (!isString(value) && !isNumber(value)) return 0;\n\n  const cleaned = String(value)\n    .trim()\n    .replace(/[^0-9]/g, \"\");\n\n  return Number(cleaned) || 0;\n};\n","/* eslint-disable quotes */\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nimport type { safeJsonParse } from \"../../safeJsonParse\";\n\n/** * ***Util Helper for {@link safeJsonParse | `safeJsonParse`}.***\n *\n * @internal\n */\nexport function fixSingleQuotesEscapeBackslash(input: string): string {\n  const validEscapes = new Set([\"\\\\\", '\"', \"/\", \"b\", \"f\", \"n\", \"r\", \"t\", \"u\"]);\n\n  let output = \"\";\n  let inSingleQuote = false;\n  let inDoubleQuote = false;\n  let escapeNext = false;\n\n  for (let i = 0; i < input.length; i++) {\n    const c = input[i] || \"\";\n\n    if (escapeNext) {\n      if (inSingleQuote) {\n        if (c === \"'\") {\n          output += \"'\";\n        } else if (validEscapes.has(c)) {\n          if (c === \"\\\\\") {\n            output += \"\\\\\\\\\";\n          } else if (c === '\"') {\n            output += '\\\\\"';\n          } else {\n            output += \"\\\\\" + c;\n          }\n        } else {\n          output += \"\\\\\\\\\" + c;\n        }\n      } else if (inDoubleQuote) {\n        if (c === '\"') {\n          output += '\\\\\"';\n        } else if (validEscapes.has(c)) {\n          output += \"\\\\\" + c;\n        } else {\n          output += \"\\\\\\\\\" + c;\n        }\n      } else {\n        output += \"\\\\\" + c;\n      }\n      escapeNext = false;\n      continue;\n    }\n\n    if (c === \"\\\\\") {\n      escapeNext = true;\n      continue;\n    }\n\n    if (!inSingleQuote && !inDoubleQuote) {\n      if (c === \"'\") {\n        output += '\"';\n        inSingleQuote = true;\n        continue;\n      }\n      if (c === '\"') {\n        output += '\"';\n        inDoubleQuote = true;\n        continue;\n      }\n    } else if (inSingleQuote) {\n      if (c === \"'\") {\n        output += '\"';\n        inSingleQuote = false;\n        continue;\n      }\n    } else if (inDoubleQuote) {\n      if (c === '\"') {\n        output += '\"';\n        inDoubleQuote = false;\n        continue;\n      }\n    }\n\n    output += c;\n  }\n\n  return output;\n}\n","/* eslint-disable @typescript-eslint/no-explicit-any */\nimport type { IsAny } from \"@rzl-zone/ts-types-plus\";\nimport type { ParseParsedDataOptions } from \"./_private/types/ParseParsedDataOptions\";\nimport type {\n  SafeJsonParseResult,\n  UnknownValue\n} from \"./_private/types/safeJsonParse\";\n\nimport { isNaN } from \"@/predicates/is/isNaN\";\nimport { isNull } from \"@/predicates/is/isNull\";\nimport { isError } from \"@/predicates/is/isError\";\nimport { isNumber } from \"@/predicates/is/isNumber\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\nimport { cleanParsedData } from \"./cleanParsedData\";\nimport { extractDigits } from \"../numerics/extractDigits\";\nimport { validateJsonParsingOptions } from \"./_private/utils/validateJsonParsingOptions\";\nimport { fixSingleQuotesEscapeBackslash } from \"./_private/utils/fixSingleQuotesEscapeBackslash\";\n\n/** ------------------------------------------------------------------------------------------------------------------------------------------\n * * ***Utility: `safeJsonParse`.***\n * -------------------------------------------------------------------------------------------------------------------------------------------\n * **Safely parses JSON while handling errors and applying transformations.**\n *\n * ---\n * - **Supports generics** to ensure accurate return type inference.\n *      - Always provide both `<TData, TInput>` for best results.\n *      - ℹ️ ***Scroll down for full generic behavior explanation.***\n * - Automatically parses valid JSON strings into `objects`, `arrays`, `numbers`, etc.\n * - Supports data transformation via options (e.g., convert strings to `numbers`, `booleans`, or `dates`).\n * - **Returns:**\n *      1. `null` ➔ if input is explicitly `null`.\n *      2. `undefined` ➔ if input is `undefined`, not a `string`, or if parsing fails.\n *      3. Parsed and cleaned result (`TData`) ➔ if input is a valid JSON string.\n *\n * ---\n * - ⚠️ **JSON.stringify note**:\n *      - _If the input JSON string was created using `JSON.stringify()`, any properties with `undefined`\n *        values would have been automatically removed or converted to `null` depending on the serializer, example:_\n *        ```ts\n *        JSON.stringify({ a: undefined, b: 1 });\n *        // ➔ '{\"b\":1}'\n *        JSON.parse('{\"a\": undefined, \"b\": 1}')\n *        // ❌ invalid JSON\n *        ```\n *        _Therefore, if you see `undefined` in raw input, it will likely throw unless pre-cleaned or replaced with `null`._\n *\n *        ```ts\n *        safeJsonParse('{\"name\": \"John\", \"score\": undefined}');\n *        // result ➔ { name: \"John\", score: null } <- because `undefined` is not valid JSON, gets replaced to null.\n *        ```\n *\n * ---\n * - ℹ️ **Additionally:**\n *      - This function normalizes single quotes (`'`) to double quotes (`\"`) before parsing,\n *        so JSON strings using single quotes will be converted to valid JSON format, example:\n *        ```ts\n *        safeJsonParse(\"{'name': 'John', 'age': 30}\");\n *        // result ➔ { name: \"John\", age: 30 }\n *\n *        safeJsonParse(\"{'string\\\\'s': 'abc', \\\"quote's\\\": 'It\\\\'s awesome!', 'aNumber\\\\'s': 123, 'keyWith\\\\'Backslash\\\\'s': 'value\\\\'s'}\");\n *        // result ➔ { \"string's\": \"abc\", \"quote's\": \"It's awesome!\", \"aNumber's\": 123, \"keyWith'Backslash's\": \"value's\" }\n *        ```\n *\n * ---\n * @template TData - The expected output type after parsing and cleaning.\n * @template TInput - The input value type, used for advanced type inference and return typing.\n *\n * ---\n * @param {TInput} [value] - The JSON string or value to parse.\n * @param {ParseParsedDataOptions} [options] - Options to clean, convert types, enable strict mode,\n *   support custom date formats, enable logging, or handle errors via callback.\n *\n * ---\n * @returns {SafeJsonParseResult<TData, TInput>} Parsed and optionally cleaned result, or `null`/`undefined`.\n *\n * ---\n * @example\n * 1. #### *Basic parse with number & boolean conversion:*\n *       ```ts\n *       const result = safeJsonParse(30);\n *       // result ➔ undefined\n *       const result = safeJsonParse(30, {\n *         convertNumbers: true\n *       });\n *       // result ➔ 30\n *\n *       const result = safeJsonParse('{\"age\": \"30\", \"isActive\": \"true\"}', {\n *         convertNumbers: true,\n *         convertBooleans: true\n *       });\n *       // result ➔ { age: 30, isActive: true }\n *       ```\n *       ---\n * 2. #### *Handling `undefined` in input string (manually written, not JSON.stringify):*\n *       ```ts\n *       const result = safeJsonParse('{\"score\": undefined}');\n *       // result ➔ { score: null } <- because `undefined` is not valid JSON, gets replaced\n *       ```\n *       ---\n * 3. #### *Handling `NaN` in input string (manually written, not JSON.stringify):*\n *       ```ts\n *       const value = NaN; // <- value is NaN or \"NaN\";\n *       const result = safeJsonParse(value);\n *       // result ➔ undefined <- will return as undefined, because options `convertNaN` is false (default),\n *       const result2 = safeJsonParse(value, { convertNaN: true });\n *       // result2 ➔ NaN <- will return as undefined because options `convertNaN` is false,\n *\n *       const result4 = safeJsonParse('{\"strNan\": \"NaN\", \"pureNan\": NaN}');\n *       // NaN will convert to string (NaN ➔ \"NaN\") because options `convertNaN` is false (default),\n *       // result4 ➔ { strNan: \"NaN\", pureNan: \"NaN\" }\n *\n *       const result3 = safeJsonParse('{\"strNan\": \"NaN\", \"pureNan\": NaN}', {\n *         convertNaN: true\n *       });\n *       // String \"NaN\" will convert to NaN (\"NaN\" ➔ NaN) because options `convertNaN` is true,\n *       // result3 ➔ { strNan: NaN, pureNan: NaN }\n *       ```\n *       ---\n * 4. #### *Strict mode (removes invalid values):*\n *       ```ts\n *       const result = safeJsonParse('{\"name\": \"   \", \"score\": \"99abc\"}', {\n *         convertNumbers: true,\n *         strictMode: true\n *       });\n *       // result ➔ {}\n *\n *       const result2 = safeJsonParse('{\"name\": \"   \", \"score\": undefined}');\n *       // result2 ➔ { name: \"\",score: null }\n *       ```\n *       ---\n * 5. #### *Custom date format parsing:*\n *       ```ts\n *       const result = safeJsonParse('{\"birthday\": \"25/12/2000\"}', {\n *         convertDates: true,\n *         customDateFormats: [\"DD/MM/YYYY\"]\n *       });\n *       // result ➔ { birthday: new Date(\"2000-12-25T00:00:00.000Z\") }\n *       ```\n *       ---\n * 6. #### *Invalid JSON with custom error handling:*\n *       ```ts\n *       safeJsonParse(\"{invalid}\", {\n *         loggingOnFail: true,\n *         onError: (err) => console.log(\"Custom handler:\", err.message)\n *       });\n *       // ➔ Logs parsing error and invokes handler\n *       ```\n *       ---\n * 7. #### *Null or non-string input returns null/undefined (default options):*\n *       ```ts\n *       safeJsonParse(123);\n *       // ➔ undefined\n *       safeJsonParse(null);\n *       // ➔ null\n *       safeJsonParse(undefined);\n *       // ➔ undefined\n *       ```\n *       ---\n * 8. #### *Generic usage: Provide both output and input type to ensure correct return typing:*\n *       ```ts\n *       type UserType = { name: string };\n *\n *       const obj = JSON.stringify({\n *         name: \"John\"\n *       });\n *\n *       const toParse = isAuth() ? obj : null;\n *       const toParse2 = isAuth() ? obj : undefined;\n *\n *       //! * `Without Generic`:\n *         const parsed = safeJsonParse(toParse);\n *         //- runtime: { name: \"John\" } | undefined | null\n *         //- type: Record<string, unknown> | undefined | null\n *         const parsed2 = safeJsonParse(toParse);\n *         //- runtime: { name: \"John\" } | undefined\n *         //- type: Record<string, unknown> | undefined\n *\n *       //! * `With Generic`:\n *         const parsed = safeJsonParse<UserType>(toParse);\n *         //- runtime: { name: \"John\" } | undefined | null\n *         //- type: undefined  <- (⚠️ unexpected!)\n *         const parsed2 = safeJsonParse<UserType>(toParse);\n *         //- runtime: { name: \"John\" } | undefined\n *         //- type: undefined  <- (⚠️ unexpected!)\n *         const parsed = safeJsonParse<UserType, typeof toParse>(toParse);\n *         //- runtime: { name: \"John\" } | null | undefined\n *         //- type: UserType | null | undefined\n *         const parsed2 = safeJsonParse<UserType, typeof toParse>(toParse);\n *         //- runtime: { name: \"John\" } | undefined\n *         //- type: UserType | undefined\n *       ```\n *\n * ---\n * @note\n * - ⚠️ **Generic Behavior:**\n *      - This function supports advanced generic inference for clean, type-safe return values.\n *      - If only the first generic (`TData`) is provided and the second (`TInput`) is omitted,\n *        then `TInput` defaults to `undefined`, resulting in a return type of `undefined`.\n *      - To ensure correct return typing, **always pass both generics** when `value` is dynamic,\n *        nullable, or unioned: `safeJsonParse<TData, typeof value>(value)`.\n *      - This makes the returned type exactly match your expectation: `TData | null | undefined`.\n */\nexport function safeJsonParse<\n  TData extends Record<string, any> = Record<string, unknown>,\n  TInput extends UnknownValue = UnknownValue\n>(\n  value: TInput,\n  options?: ParseParsedDataOptions\n): IsAny<TInput> extends true ? TData | null | undefined : undefined;\nexport function safeJsonParse<\n  TData extends Record<string, any> = Record<string, unknown>,\n  TInput extends string | null | undefined | unknown = undefined\n>(\n  value: TInput,\n  options?: ParseParsedDataOptions\n): SafeJsonParseResult<TData, TInput>;\n//! implement main function\nexport function safeJsonParse<TData extends Record<string, unknown>>(\n  value: unknown,\n  options?: ParseParsedDataOptions\n) {\n  if (isNull(value)) return null;\n  const validOptions = validateJsonParsingOptions(\n    options ?? {},\n    \"safeJsonParse\"\n  );\n\n  if (\n    validOptions.convertNaN &&\n    (isNaN(value) || (isNonEmptyString(value) && value === \"NaN\"))\n  ) {\n    return NaN;\n  }\n  if (\n    validOptions.convertNumbers &&\n    !isNaN(Number(value)) &&\n    isNumber(extractDigits(value))\n  ) {\n    return Number(value);\n  }\n\n  if (!isString(value)) return undefined;\n\n  try {\n    // First, normalize all single quotes to double quotes\n    let normalized = fixSingleQuotesEscapeBackslash(value);\n\n    if (validOptions.removeUndefined) {\n      normalized = normalized\n        .replace(/,\\s*\"[^\"]*\"\\s*:\\s*undefined(?=\\s*[},])/g, \"\")\n        // ➔ remove , \"key\": undefined\n        .replace(/\"[^\"]*\"\\s*:\\s*undefined\\s*(,)?/g, \"\");\n      // ➔ remove \"key\": undefined\n    } else {\n      normalized = normalized.replace(/:\\s*undefined(?=\\s*[,}])/g, \":null\");\n      // ➔ replace :undefined with :null\n    }\n\n    if (validOptions.convertNaN) {\n      // eslint-disable-next-line quotes\n      normalized = normalized.replace(/:\\s*NaN(?=\\s*[,}])/g, ':\"NaN\"');\n      // ➔ convert :NaN to :\"NaN\"\n    } else {\n      normalized = normalized\n        // eslint-disable-next-line quotes\n        .replace(/:\\s*NaN(?=\\s*[,}])/g, ':\"NaN\"')\n        // ➔ convert :NaN to :\"NaN\"\n        .replace(/,\\s*\"[^\"]*\"\\s*:\\s*NaN(?=\\s*[},])/g, \"\")\n        // ➔ remove , \"key\": NaN\n        .replace(/\"[^\"]*\"\\s*:\\s*NaN\\s*(,)?/g, \"\");\n      // ➔ remove \"key\": NaN\n    }\n\n    normalized = normalized.replace(/,(\\s*[}\\]])/g, \"$1\");\n    // ➔ remove trailing comma before } or ]\n\n    const parsed = JSON.parse(normalized);\n    return cleanParsedData<TData>(parsed, validOptions);\n  } catch (error) {\n    if (validOptions.loggingOnFail) {\n      console.error(\n        \"Failed to parsing at `[@rzl-zone/utils-js]:safeJsonParse`:\",\n        error\n      );\n    }\n\n    validOptions.onError(\n      isError(error)\n        ? new Error(error.message.replace(/^JSON\\.parse:/, \"Failed to parsing\"))\n        : new Error(String(error))\n    );\n\n    return undefined;\n  }\n}\n"],"mappings":"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"}

package/dist/{safeJsonParse-D8H3wCv7.js → safeJsonParse-DEVKNDSn.js}

@@ -2,17 +2,18 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.13.1-beta.0`
+*  Version: `3.14.0-beta.0`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
-import { D as isNaN$1, E as isNull, F as isBoolean, M as isArray, P as isFunction, S as isUndefined, T as assertIsPlainObject, b as hasOwnProp, j as isObject, k as isString, r as getPreciseType, v as isError, w as isNumber, y as isNonEmptyString } from "./assertIsBoolean-DDhQ2D-k.js";
-import { n as isEmptyArray, t as isEmptyObject } from "./isEmptyObject-BYNnSKzw.js";
-import { t as safeStableStringify } from "./safeStableStringify-BLwA1VC-.js";
-import { t as noop } from "./noop-D_Ots__Z.js";
+import { A as isFunction, D as isObject, E as isPlainObject, O as isArray, S as isNaN$1, T as isString, b as isError, i as getPreciseType, j as isBoolean, t as createMessage, w as isNonEmptyString, x as isNull } from "./logger-CLWnKRKE.js";
+import { t as isNumber } from "./isNumber-BCWD4dW0.js";
+import { n as isEmptyObject, r as isEmptyArray } from "./isEmptyValue-kCjnLjbN.js";
+import { r as isUndefined, t as safeStableStringify } from "./safeStableStringify-DfwxmiWn.js";
+import { t as noop } from "./noop-qxrcogt5.js";
 const parseCustomDate = (dateString, format) => {
-	if (!isNonEmptyString(dateString) || !isNonEmptyString(format)) throw new TypeError(`Parameter \`dateString\` and \`format\` must be of type \`string\` and not empty-string, but received: "['dateString': \`${getPreciseType(dateString)}\` - (current value: \`${safeStableStringify(dateString, { keepUndefined: true })}\`), 'format': \`${getPreciseType(format)}\` - (current value: \`${safeStableStringify(format, { keepUndefined: true })}\`)]".`);
+	if (!isNonEmptyString(dateString) || !isNonEmptyString(format)) throw new TypeError(createMessage("parseCustomDate", `Parameter \`dateString\` and \`format\` must be of type \`string\` and not empty-string, but received: "['dateString': \`${getPreciseType(dateString)}\` - (current value: \`${safeStableStringify(dateString, { keepUndefined: true })}\`), 'format': \`${getPreciseType(format)}\` - (current value: \`${safeStableStringify(format, { keepUndefined: true })}\`)]".`));
 	const dateParts = dateString.split(/[-/]/).map(Number);
 	if (dateParts.length !== 3 || dateParts.some(isNaN)) return null;
 	let day, month, year;
@@ -24,22 +25,22 @@ const parseCustomDate = (dateString, format) => {
 	if (!date || date.getFullYear() !== year || date.getMonth() !== month || date.getDate() !== day) return null;
 	return date;
 };
-const validateJsonParsingOptions = (optionsValue = {}) => {
-	assertIsPlainObject(optionsValue, { message: ({ currentType, validType }) => `Second parameter (\`options\`) must be of type \`${validType}\`, but received: \`${currentType}\`.` });
-	const convertBooleans = hasOwnProp(optionsValue, "convertBooleans") ? optionsValue.convertBooleans : false;
-	const convertDates = hasOwnProp(optionsValue, "convertDates") ? optionsValue.convertDates : false;
-	const convertNumbers = hasOwnProp(optionsValue, "convertNumbers") ? optionsValue.convertNumbers : false;
-	const loggingOnFail = hasOwnProp(optionsValue, "loggingOnFail") ? optionsValue.loggingOnFail : false;
-	const removeEmptyArrays = hasOwnProp(optionsValue, "removeEmptyArrays") ? optionsValue.removeEmptyArrays : false;
-	const removeEmptyObjects = hasOwnProp(optionsValue, "removeEmptyObjects") ? optionsValue.removeEmptyObjects : false;
-	const removeNulls = hasOwnProp(optionsValue, "removeNulls") ? optionsValue.removeNulls : false;
-	const removeUndefined = hasOwnProp(optionsValue, "removeUndefined") ? optionsValue.removeUndefined : false;
-	const strictMode = hasOwnProp(optionsValue, "strictMode") ? optionsValue.strictMode : false;
-	const checkSymbols = hasOwnProp(optionsValue, "checkSymbols") ? optionsValue.checkSymbols : false;
-	const convertNaN = hasOwnProp(optionsValue, "convertNaN") ? optionsValue.convertNaN : false;
-	const customDateFormats = hasOwnProp(optionsValue, "customDateFormats") ? optionsValue.customDateFormats : [];
-	const onError = hasOwnProp(optionsValue, "onError") ? optionsValue.onError : noop;
-	if (!(isBoolean(convertBooleans) && isBoolean(convertDates) && isBoolean(convertNumbers) && isBoolean(convertNaN) && isBoolean(checkSymbols) && isBoolean(loggingOnFail) && isBoolean(removeEmptyArrays) && isBoolean(removeEmptyObjects) && isBoolean(removeNulls) && isBoolean(removeUndefined) && isBoolean(strictMode) && isArray(customDateFormats) && isFunction(onError))) throw new TypeError(`Invalid \`options\` parameter (second argument): \`convertBooleans\`, \`convertDates\`, \`convertNumbers\`, \`loggingOnFail\`, \`removeEmptyArrays\`, \`removeEmptyObjects\`, \`removeNulls\`, \`removeUndefined\`, \`strictMode\` expected to be a \`boolean\` type, \`customDateFormats\` expected to be a \`array\` type and \`onError\` expected to be a \`void function\` type. But received: ['convertBooleans': \`${getPreciseType(convertBooleans)}\`, 'convertDates': \`${getPreciseType(convertDates)}\`, 'convertNumbers': \`${getPreciseType(convertNumbers)}\`, 'loggingOnFail': \`${getPreciseType(loggingOnFail)}\`, 'removeEmptyArrays': \`${getPreciseType(removeEmptyArrays)}\`, 'removeEmptyObjects': \`${getPreciseType(removeEmptyObjects)}\`, 'removeNulls': \`${getPreciseType(removeNulls)}\`, 'removeUndefined': \`${getPreciseType(removeUndefined)}\`, 'strictMode': \`${getPreciseType(strictMode)}\`, 'customDateFormats': \`${getPreciseType(customDateFormats)}\`, 'onError': \`${getPreciseType(onError)}\`].`);
+const validateJsonParsingOptions = (optionsValue, calledFromSource) => {
+	if (!isPlainObject(optionsValue)) optionsValue = {};
+	const convertBooleans = optionsValue.convertBooleans ?? false;
+	const convertDates = optionsValue.convertDates ?? false;
+	const convertNumbers = optionsValue.convertNumbers ?? false;
+	const loggingOnFail = optionsValue.loggingOnFail ?? false;
+	const removeEmptyArrays = optionsValue.removeEmptyArrays ?? false;
+	const removeEmptyObjects = optionsValue.removeEmptyObjects ?? false;
+	const removeNulls = optionsValue.removeNulls ?? false;
+	const removeUndefined = optionsValue.removeUndefined ?? false;
+	const strictMode = optionsValue.strictMode ?? false;
+	const checkSymbols = optionsValue.checkSymbols ?? false;
+	const convertNaN = optionsValue.convertNaN ?? false;
+	const customDateFormats = optionsValue.customDateFormats ?? [];
+	const onError = optionsValue.onError ?? noop;
+	if (!(isBoolean(convertBooleans) && isBoolean(convertDates) && isBoolean(convertNumbers) && isBoolean(convertNaN) && isBoolean(checkSymbols) && isBoolean(loggingOnFail) && isBoolean(removeEmptyArrays) && isBoolean(removeEmptyObjects) && isBoolean(removeNulls) && isBoolean(removeUndefined) && isBoolean(strictMode) && isArray(customDateFormats) && isFunction(onError))) throw new TypeError(createMessage(calledFromSource, `Invalid \`options\` parameter (second argument): \`convertBooleans\`, \`convertDates\`, \`convertNumbers\`, \`loggingOnFail\`, \`removeEmptyArrays\`, \`removeEmptyObjects\`, \`removeNulls\`, \`removeUndefined\`, \`strictMode\` expected to be a \`boolean\` type, \`customDateFormats\` expected to be a \`array\` type and \`onError\` expected to be a \`void function\` type. But received: ['convertBooleans': \`${getPreciseType(convertBooleans)}\`, 'convertDates': \`${getPreciseType(convertDates)}\`, 'convertNumbers': \`${getPreciseType(convertNumbers)}\`, 'loggingOnFail': \`${getPreciseType(loggingOnFail)}\`, 'removeEmptyArrays': \`${getPreciseType(removeEmptyArrays)}\`, 'removeEmptyObjects': \`${getPreciseType(removeEmptyObjects)}\`, 'removeNulls': \`${getPreciseType(removeNulls)}\`, 'removeUndefined': \`${getPreciseType(removeUndefined)}\`, 'strictMode': \`${getPreciseType(strictMode)}\`, 'customDateFormats': \`${getPreciseType(customDateFormats)}\`, 'onError': \`${getPreciseType(onError)}\`].`));
 	return {
 		convertBooleans,
 		convertDates,
@@ -56,8 +57,8 @@ const validateJsonParsingOptions = (optionsValue = {}) => {
 		checkSymbols
 	};
 };
-const cleanParsedData = (data, options = {}) => {
-	const validOptions = validateJsonParsingOptions(options);
+const cleanParsedData = (data, options) => {
+	const validOptions = validateJsonParsingOptions(options ?? {}, "cleanParsedData");
 	if (isNull(data)) return validOptions.removeNulls ? void 0 : null;
 	if (isUndefined(data)) return validOptions.removeUndefined ? void 0 : void 0;
 	if (isString(data)) {
@@ -160,9 +161,9 @@ function fixSingleQuotesEscapeBackslash(input) {
 	return output;
 }
 //! implement main function
-function safeJsonParse(value, options = {}) {
+function safeJsonParse(value, options) {
 	if (isNull(value)) return null;
-	const validOptions = validateJsonParsingOptions(options);
+	const validOptions = validateJsonParsingOptions(options ?? {}, "safeJsonParse");
 	if (validOptions.convertNaN && (isNaN$1(value) || isNonEmptyString(value) && value === "NaN")) return NaN;
 	if (validOptions.convertNumbers && !isNaN$1(Number(value)) && isNumber(extractDigits(value))) return Number(value);
 	if (!isString(value)) return void 0;
@@ -175,10 +176,10 @@ function safeJsonParse(value, options = {}) {
 		normalized = normalized.replace(/,(\s*[}\]])/g, "$1");
 		return cleanParsedData(JSON.parse(normalized), validOptions);
 	} catch (error) {
-		if (validOptions.loggingOnFail) console.error("Failed to parsing at `safeJsonParse`:", error);
+		if (validOptions.loggingOnFail) console.error("Failed to parsing at `[@rzl-zone/utils-js]:safeJsonParse`:", error);
 		validOptions.onError(isError(error) ? new Error(error.message.replace(/^JSON\.parse:/, "Failed to parsing")) : new Error(String(error)));
 		return;
 	}
 }
 export { parseCustomDate as i, extractDigits as n, cleanParsedData as r, safeJsonParse as t };
-//# sourceMappingURL=safeJsonParse-D8H3wCv7.js.map
+//# sourceMappingURL=safeJsonParse-DEVKNDSn.js.map

package/dist/safeJsonParse-DEVKNDSn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeJsonParse-DEVKNDSn.js","names":["isNaN"],"sources":["../src/conversions/json/parseCustomDate.ts","../src/conversions/json/_private/utils/validateJsonParsingOptions.ts","../src/conversions/json/cleanParsedData.ts","../src/conversions/numerics/extractDigits.ts","../src/conversions/json/_private/utils/fixSingleQuotesEscapeBackslash.ts","../src/conversions/json/safeJsonParse.ts"],"sourcesContent":["import { createMessage } from \"@/_private/logger\";\n\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\nimport { safeStableStringify } from \"../stringify/safeStableStringify\";\n\n/** ---------------------------------------------------------------------------------------\n * * ***Utility: `parseCustomDate`.***\n * ----------------------------------------------------------------------------------------\n * **Parses custom date formats like `\"DD/MM/YYYY\"` or `\"MM/DD/YYYY\"`.**\n *\n * ---\n * @param {string} dateString - Date string to parse.\n * @param {string} format - Date format to match.\n *\n * ---\n * @throws **{@link TypeError | `TypeError`}** if `dateString` **(first parameter)** and\n *         `format` **(second parameter)** is not a string or empty-string.\n *\n * ---\n * @returns {Date | null} Returns a `Date` object if valid, otherwise `null`.\n *\n * ---\n * @example\n * 1. #### Parse European date format:\n *    ```ts\n *    const date1 = parseCustomDate(\n *      \"03/09/2025\",\n *      \"DD/MM/YYYY\"\n *    );\n *\n *    console.log(date1);\n *    // ➔ Date { Wed Sep 03 2025 ... }\n *    ```\n *    ---\n * 2. #### Parse US date format:\n *    ```ts\n *    const date2 = parseCustomDate(\n *      \"09/03/2025\",\n *      \"MM/DD/YYYY\"\n *    );\n *\n *    console.log(date2);\n *    // ➔ Date { Wed Sep 03 2025 ... }\n *    ```\n *    ---\n * 3. #### Invalid date format:\n *    ```ts\n *    const date3 = parseCustomDate(\n *      \"2025-09-03\",\n *      \"DD/MM/YYYY\"\n *    );\n *\n *    console.log(date3);\n *    // ➔ null\n *    ```\n *    ---\n * 4. #### Invalid date string:\n *    ```ts\n *    const date4 = parseCustomDate(\n *      \"hello\",\n *      \"DD/MM/YYYY\"\n *    );\n *\n *    console.log(date4);\n *    // ➔ null\n *    ```\n *    ---\n * 5. #### Invalid parameter types:\n *    ```ts\n *    parseCustomDate(\n *      123,\n *      \"DD/MM/YYYY\"\n *    );\n *\n *    // ➔ TypeError: Parameter `dateString` and `format` must be of type `string`...\n *    ```\n */\nexport const parseCustomDate = (\n  dateString: string,\n  format: string\n): Date | null => {\n  if (!isNonEmptyString(dateString) || !isNonEmptyString(format)) {\n    throw new TypeError(\n      createMessage(\n        \"parseCustomDate\",\n        `Parameter \\`dateString\\` and \\`format\\` must be of type \\`string\\` and not empty-string, but received: \"['dateString': \\`${getPreciseType(\n          dateString\n        )}\\` - (current value: \\`${safeStableStringify(dateString, {\n          keepUndefined: true\n        })}\\`), 'format': \\`${getPreciseType(\n          format\n        )}\\` - (current value: \\`${safeStableStringify(format, {\n          keepUndefined: true\n        })}\\`)]\".`\n      )\n    );\n  }\n\n  const dateParts = dateString.split(/[-/]/).map(Number);\n  if (dateParts.length !== 3 || dateParts.some(isNaN)) return null;\n\n  let day: number | undefined,\n    month: number | undefined,\n    year: number | undefined;\n\n  if (format === \"DD/MM/YYYY\") {\n    [day, month, year] = dateParts;\n  } else if (format === \"MM/DD/YYYY\") {\n    [month, day, year] = dateParts;\n  } else {\n    return null;\n  }\n\n  if (month) month -= 1;\n  const date = year && month && day ? new Date(year, month, day) : undefined;\n\n  if (\n    !date ||\n    date.getFullYear() !== year ||\n    date.getMonth() !== month ||\n    date.getDate() !== day\n  ) {\n    return null;\n  }\n\n  return date;\n};\n","import type { Prettify } from \"@rzl-zone/ts-types-plus\";\n\nimport type { ParseParsedDataOptions } from \"../types/ParseParsedDataOptions\";\n\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nimport type { cleanParsedData } from \"../../cleanParsedData\";\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nimport type { parseCustomDate } from \"../../parseCustomDate\";\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nimport type { safeJsonParse } from \"../../safeJsonParse\";\n\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isBoolean } from \"@/predicates/is/isBoolean\";\nimport { isFunction } from \"@/predicates/is/isFunction\";\nimport { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\n\nimport { noop } from \"@/generators/utils/noop\";\nimport { createMessage } from \"@/_private/logger\";\n\ntype ValidatedParsedDataOptions = Prettify<Required<ParseParsedDataOptions>>;\n\n/** * ***Private Helper for Options Validation Function: {@link cleanParsedData | `cleanParsedData`}, {@link parseCustomDate | `parseCustomDate`} and {@link safeJsonParse | `safeJsonParse`}.***\n *\n * @internal\n */\nexport const validateJsonParsingOptions = (\n  optionsValue: ParseParsedDataOptions,\n  calledFromSource: string\n): ValidatedParsedDataOptions => {\n  if (!isPlainObject(optionsValue)) optionsValue = {};\n\n  const convertBooleans = optionsValue.convertBooleans ?? false;\n  const convertDates = optionsValue.convertDates ?? false;\n  const convertNumbers = optionsValue.convertNumbers ?? false;\n  const loggingOnFail = optionsValue.loggingOnFail ?? false;\n  const removeEmptyArrays = optionsValue.removeEmptyArrays ?? false;\n  const removeEmptyObjects = optionsValue.removeEmptyObjects ?? false;\n  const removeNulls = optionsValue.removeNulls ?? false;\n  const removeUndefined = optionsValue.removeUndefined ?? false;\n  const strictMode = optionsValue.strictMode ?? false;\n  const checkSymbols = optionsValue.checkSymbols ?? false;\n  const convertNaN = optionsValue.convertNaN ?? false;\n\n  const customDateFormats = optionsValue.customDateFormats ?? [];\n  const onError = optionsValue.onError ?? noop;\n\n  if (\n    !(\n      isBoolean(convertBooleans) &&\n      isBoolean(convertDates) &&\n      isBoolean(convertNumbers) &&\n      isBoolean(convertNaN) &&\n      isBoolean(checkSymbols) &&\n      isBoolean(loggingOnFail) &&\n      isBoolean(removeEmptyArrays) &&\n      isBoolean(removeEmptyObjects) &&\n      isBoolean(removeNulls) &&\n      isBoolean(removeUndefined) &&\n      isBoolean(strictMode) &&\n      isArray(customDateFormats) &&\n      isFunction(onError)\n    )\n  ) {\n    throw new TypeError(\n      createMessage(\n        calledFromSource,\n        `Invalid \\`options\\` parameter (second argument): \\`convertBooleans\\`, \\`convertDates\\`, \\`convertNumbers\\`, \\`loggingOnFail\\`, \\`removeEmptyArrays\\`, \\`removeEmptyObjects\\`, \\`removeNulls\\`, \\`removeUndefined\\`, \\`strictMode\\` expected to be a \\`boolean\\` type, \\`customDateFormats\\` expected to be a \\`array\\` type and \\`onError\\` expected to be a \\`void function\\` type. But received: ['convertBooleans': \\`${getPreciseType(\n          convertBooleans\n        )}\\`, 'convertDates': \\`${getPreciseType(\n          convertDates\n        )}\\`, 'convertNumbers': \\`${getPreciseType(\n          convertNumbers\n        )}\\`, 'loggingOnFail': \\`${getPreciseType(\n          loggingOnFail\n        )}\\`, 'removeEmptyArrays': \\`${getPreciseType(\n          removeEmptyArrays\n        )}\\`, 'removeEmptyObjects': \\`${getPreciseType(\n          removeEmptyObjects\n        )}\\`, 'removeNulls': \\`${getPreciseType(\n          removeNulls\n        )}\\`, 'removeUndefined': \\`${getPreciseType(\n          removeUndefined\n        )}\\`, 'strictMode': \\`${getPreciseType(\n          strictMode\n        )}\\`, 'customDateFormats': \\`${getPreciseType(\n          customDateFormats\n        )}\\`, 'onError': \\`${getPreciseType(onError)}\\`].`\n      )\n    );\n  }\n\n  return {\n    convertBooleans,\n    convertDates,\n    convertNumbers,\n    convertNaN,\n    loggingOnFail,\n    removeEmptyArrays,\n    removeEmptyObjects,\n    removeNulls,\n    removeUndefined,\n    strictMode,\n    customDateFormats,\n    onError,\n    checkSymbols\n  };\n};\n","import type { ParseParsedDataOptions } from \"./_private/types/ParseParsedDataOptions\";\n\nimport { isNull } from \"@/predicates/is/isNull\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isObject } from \"@/predicates/is/isObject\";\nimport { isUndefined } from \"@/predicates/is/isUndefined\";\nimport { isEmptyArray } from \"@/predicates/is/isEmptyArray\";\nimport { isEmptyObject } from \"@/predicates/is/isEmptyObject\";\n\nimport { parseCustomDate } from \"./parseCustomDate\";\nimport { validateJsonParsingOptions } from \"./_private/utils/validateJsonParsingOptions\";\n\n/** --------------------------------------------------------------------------------------------\n * * ***Utility: `cleanParsedData`.***\n * ---------------------------------------------------------------------------------------------\n * **Cleans parsed JSON data based on provided options.**\n *\n * ---\n * @template T - Expected output type.\n *\n * ---\n * @param {*} data - The parsed JSON data.\n * @param {ParseParsedDataOptions} [options] - The cleaning options.\n *\n * ---\n * @returns {T | null | undefined} The cleaned data.\n * - ***⚠️ Notice:*** _If data is JSON string, we recommend use ***`safeJsonParse` utility\n *   function*** for more safe._\n * - ***⚠️ Note:*** _If using **`convertDates`** **options**, result may contain Date objects,\n *   you may need type assertions in strict TypeScript settings._\n *\n * ---\n * @example\n * 1. #### Convert numbers and remove null values:\n *    ```ts\n *    const result = cleanParsedData(\n *      { age: \"25\", name: null },\n *      { convertNumbers: true, removeNulls: true }\n *    );\n *\n *    console.log(result);\n *    // ➔ { age: 25 }\n *    ```\n *    ---\n * 2. #### Convert boolean strings:\n *    ```ts\n *    const result = cleanParsedData(\n *      { isActive: \"true\" },\n *      { convertBooleans: true }\n *    );\n *\n *    console.log(result);\n *    // ➔ { isActive: true }\n *    ```\n */\nexport const cleanParsedData = <T = unknown>(\n  data: T,\n  options?: ParseParsedDataOptions\n): T | undefined | null => {\n  const validOptions = validateJsonParsingOptions(\n    options ?? {},\n    \"cleanParsedData\"\n  );\n\n  if (isNull(data)) return validOptions.removeNulls ? undefined : null;\n  if (isUndefined(data))\n    return validOptions.removeUndefined ? undefined : undefined;\n\n  if (isString(data)) {\n    const trimmed = data.trim();\n\n    if (validOptions.convertNaN && trimmed === \"NaN\") return NaN as T;\n\n    if (validOptions.convertNumbers && !isNaN(Number(trimmed))) {\n      return Number(trimmed) as T;\n    }\n\n    if (validOptions.convertBooleans) {\n      if (trimmed === \"true\") return true as T;\n      if (trimmed === \"false\") return false as T;\n    }\n\n    if (validOptions.convertDates) {\n      if (/^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$/.test(trimmed)) {\n        return new Date(trimmed) as T;\n      }\n\n      if (validOptions.customDateFormats?.length) {\n        for (const format of validOptions.customDateFormats) {\n          const date = parseCustomDate(trimmed, format);\n          if (date) return date as T;\n        }\n      }\n    }\n\n    return validOptions.strictMode ? undefined : (trimmed as T);\n  }\n\n  if (isArray(data)) {\n    const cleanedArray = data\n      .map((item) => cleanParsedData(item, validOptions))\n      .filter((item) => !isUndefined(item));\n\n    return validOptions.removeEmptyArrays && isEmptyArray(cleanedArray)\n      ? undefined\n      : (cleanedArray as T);\n  }\n\n  if (isObject(data)) {\n    const cleanedObject: Record<string, unknown> = {};\n\n    for (const key in data) {\n      if (Object.prototype.hasOwnProperty.call(data, key)) {\n        const cleanedValue = cleanParsedData(data[key], validOptions);\n        if (!isUndefined(cleanedValue)) {\n          cleanedObject[key] = cleanedValue;\n        }\n      }\n    }\n\n    return validOptions.removeEmptyObjects &&\n      isEmptyObject(cleanedObject, { checkSymbols: validOptions.checkSymbols })\n      ? undefined\n      : (cleanedObject as T);\n  }\n\n  return validOptions.strictMode ? undefined : data;\n};\n","import { isNumber } from \"@/predicates/is/isNumber\";\nimport { isString } from \"@/predicates/is/isString\";\n\n/** -----------------------------------------------------------------------------------------------------------------------------------------\n * * ***Utility: `extractDigits`.***\n * ------------------------------------------------------------------------------------------------------------------------------------------\n * **Extracts digits from a string or number input.**\n *\n * ---\n * - **Behavior:**\n *     - Converts the input to a string, trims whitespace, and removes any characters that are not digits (`0-9`).\n *     - Returns the cleaned numeric value as a `number`.\n *     - If the input is a `null`, `undefined`, results in no digits, or not a `string` (or empty-string) or `number`, it safely return `0`.\n *\n * ---\n * @param {*} [value]\n *  ***The value to process.***\n *     - Accepts a string, number, `null`, or `undefined`.\n *\n * ---\n * @returns {number} The numeric value after extracting digits (returns `0` if input is invalid or contains no digits).\n *\n * ---\n * @example\n * extractDigits(12345);\n * // ➔ 12345\n * extractDigits(\"9A8B7C6X1\");\n * // ➔ 98761\n * extractDigits(\"123abc456\");\n * // ➔ 123456\n * extractDigits(\"$1,234.56\");\n * // ➔ 123456\n * extractDigits(NaN);\n * // ➔ 0\n * extractDigits(null);\n * // ➔ 0\n * extractDigits(undefined);\n * // ➔ 0\n * extractDigits(Infinity);\n * // ➔ 0\n * extractDigits(-Infinity);\n * // ➔ 0\n * extractDigits({});\n * // ➔ 0\n * extractDigits([]);\n * // ➔ 0\n * extractDigits(\"\");\n * // ➔ 0\n * extractDigits(\" \");\n * // ➔ 0\n * extractDigits(\"abc\");\n * // ➔ 0\n * extractDigits(\"   00a  \");\n * // ➔ 0\n */\nexport const extractDigits = (value: unknown): number => {\n  if (!isString(value) && !isNumber(value)) return 0;\n\n  const cleaned = String(value)\n    .trim()\n    .replace(/[^0-9]/g, \"\");\n\n  return Number(cleaned) || 0;\n};\n","/* eslint-disable quotes */\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nimport type { safeJsonParse } from \"../../safeJsonParse\";\n\n/** * ***Util Helper for {@link safeJsonParse | `safeJsonParse`}.***\n *\n * @internal\n */\nexport function fixSingleQuotesEscapeBackslash(input: string): string {\n  const validEscapes = new Set([\"\\\\\", '\"', \"/\", \"b\", \"f\", \"n\", \"r\", \"t\", \"u\"]);\n\n  let output = \"\";\n  let inSingleQuote = false;\n  let inDoubleQuote = false;\n  let escapeNext = false;\n\n  for (let i = 0; i < input.length; i++) {\n    const c = input[i] || \"\";\n\n    if (escapeNext) {\n      if (inSingleQuote) {\n        if (c === \"'\") {\n          output += \"'\";\n        } else if (validEscapes.has(c)) {\n          if (c === \"\\\\\") {\n            output += \"\\\\\\\\\";\n          } else if (c === '\"') {\n            output += '\\\\\"';\n          } else {\n            output += \"\\\\\" + c;\n          }\n        } else {\n          output += \"\\\\\\\\\" + c;\n        }\n      } else if (inDoubleQuote) {\n        if (c === '\"') {\n          output += '\\\\\"';\n        } else if (validEscapes.has(c)) {\n          output += \"\\\\\" + c;\n        } else {\n          output += \"\\\\\\\\\" + c;\n        }\n      } else {\n        output += \"\\\\\" + c;\n      }\n      escapeNext = false;\n      continue;\n    }\n\n    if (c === \"\\\\\") {\n      escapeNext = true;\n      continue;\n    }\n\n    if (!inSingleQuote && !inDoubleQuote) {\n      if (c === \"'\") {\n        output += '\"';\n        inSingleQuote = true;\n        continue;\n      }\n      if (c === '\"') {\n        output += '\"';\n        inDoubleQuote = true;\n        continue;\n      }\n    } else if (inSingleQuote) {\n      if (c === \"'\") {\n        output += '\"';\n        inSingleQuote = false;\n        continue;\n      }\n    } else if (inDoubleQuote) {\n      if (c === '\"') {\n        output += '\"';\n        inDoubleQuote = false;\n        continue;\n      }\n    }\n\n    output += c;\n  }\n\n  return output;\n}\n","/* eslint-disable @typescript-eslint/no-explicit-any */\nimport type { IsAny } from \"@rzl-zone/ts-types-plus\";\nimport type { ParseParsedDataOptions } from \"./_private/types/ParseParsedDataOptions\";\nimport type {\n  SafeJsonParseResult,\n  UnknownValue\n} from \"./_private/types/safeJsonParse\";\n\nimport { isNaN } from \"@/predicates/is/isNaN\";\nimport { isNull } from \"@/predicates/is/isNull\";\nimport { isError } from \"@/predicates/is/isError\";\nimport { isNumber } from \"@/predicates/is/isNumber\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\nimport { cleanParsedData } from \"./cleanParsedData\";\nimport { extractDigits } from \"../numerics/extractDigits\";\nimport { validateJsonParsingOptions } from \"./_private/utils/validateJsonParsingOptions\";\nimport { fixSingleQuotesEscapeBackslash } from \"./_private/utils/fixSingleQuotesEscapeBackslash\";\n\n/** ------------------------------------------------------------------------------------------------------------------------------------------\n * * ***Utility: `safeJsonParse`.***\n * -------------------------------------------------------------------------------------------------------------------------------------------\n * **Safely parses JSON while handling errors and applying transformations.**\n *\n * ---\n * - **Supports generics** to ensure accurate return type inference.\n *      - Always provide both `<TData, TInput>` for best results.\n *      - ℹ️ ***Scroll down for full generic behavior explanation.***\n * - Automatically parses valid JSON strings into `objects`, `arrays`, `numbers`, etc.\n * - Supports data transformation via options (e.g., convert strings to `numbers`, `booleans`, or `dates`).\n * - **Returns:**\n *      1. `null` ➔ if input is explicitly `null`.\n *      2. `undefined` ➔ if input is `undefined`, not a `string`, or if parsing fails.\n *      3. Parsed and cleaned result (`TData`) ➔ if input is a valid JSON string.\n *\n * ---\n * - ⚠️ **JSON.stringify note**:\n *      - _If the input JSON string was created using `JSON.stringify()`, any properties with `undefined`\n *        values would have been automatically removed or converted to `null` depending on the serializer, example:_\n *        ```ts\n *        JSON.stringify({ a: undefined, b: 1 });\n *        // ➔ '{\"b\":1}'\n *        JSON.parse('{\"a\": undefined, \"b\": 1}')\n *        // ❌ invalid JSON\n *        ```\n *        _Therefore, if you see `undefined` in raw input, it will likely throw unless pre-cleaned or replaced with `null`._\n *\n *        ```ts\n *        safeJsonParse('{\"name\": \"John\", \"score\": undefined}');\n *        // result ➔ { name: \"John\", score: null } <- because `undefined` is not valid JSON, gets replaced to null.\n *        ```\n *\n * ---\n * - ℹ️ **Additionally:**\n *      - This function normalizes single quotes (`'`) to double quotes (`\"`) before parsing,\n *        so JSON strings using single quotes will be converted to valid JSON format, example:\n *        ```ts\n *        safeJsonParse(\"{'name': 'John', 'age': 30}\");\n *        // result ➔ { name: \"John\", age: 30 }\n *\n *        safeJsonParse(\"{'string\\\\'s': 'abc', \\\"quote's\\\": 'It\\\\'s awesome!', 'aNumber\\\\'s': 123, 'keyWith\\\\'Backslash\\\\'s': 'value\\\\'s'}\");\n *        // result ➔ { \"string's\": \"abc\", \"quote's\": \"It's awesome!\", \"aNumber's\": 123, \"keyWith'Backslash's\": \"value's\" }\n *        ```\n *\n * ---\n * @template TData - The expected output type after parsing and cleaning.\n * @template TInput - The input value type, used for advanced type inference and return typing.\n *\n * ---\n * @param {TInput} [value] - The JSON string or value to parse.\n * @param {ParseParsedDataOptions} [options] - Options to clean, convert types, enable strict mode,\n *   support custom date formats, enable logging, or handle errors via callback.\n *\n * ---\n * @returns {SafeJsonParseResult<TData, TInput>} Parsed and optionally cleaned result, or `null`/`undefined`.\n *\n * ---\n * @example\n * 1. #### *Basic parse with number & boolean conversion:*\n *       ```ts\n *       const result = safeJsonParse(30);\n *       // result ➔ undefined\n *       const result = safeJsonParse(30, {\n *         convertNumbers: true\n *       });\n *       // result ➔ 30\n *\n *       const result = safeJsonParse('{\"age\": \"30\", \"isActive\": \"true\"}', {\n *         convertNumbers: true,\n *         convertBooleans: true\n *       });\n *       // result ➔ { age: 30, isActive: true }\n *       ```\n *       ---\n * 2. #### *Handling `undefined` in input string (manually written, not JSON.stringify):*\n *       ```ts\n *       const result = safeJsonParse('{\"score\": undefined}');\n *       // result ➔ { score: null } <- because `undefined` is not valid JSON, gets replaced\n *       ```\n *       ---\n * 3. #### *Handling `NaN` in input string (manually written, not JSON.stringify):*\n *       ```ts\n *       const value = NaN; // <- value is NaN or \"NaN\";\n *       const result = safeJsonParse(value);\n *       // result ➔ undefined <- will return as undefined, because options `convertNaN` is false (default),\n *       const result2 = safeJsonParse(value, { convertNaN: true });\n *       // result2 ➔ NaN <- will return as undefined because options `convertNaN` is false,\n *\n *       const result4 = safeJsonParse('{\"strNan\": \"NaN\", \"pureNan\": NaN}');\n *       // NaN will convert to string (NaN ➔ \"NaN\") because options `convertNaN` is false (default),\n *       // result4 ➔ { strNan: \"NaN\", pureNan: \"NaN\" }\n *\n *       const result3 = safeJsonParse('{\"strNan\": \"NaN\", \"pureNan\": NaN}', {\n *         convertNaN: true\n *       });\n *       // String \"NaN\" will convert to NaN (\"NaN\" ➔ NaN) because options `convertNaN` is true,\n *       // result3 ➔ { strNan: NaN, pureNan: NaN }\n *       ```\n *       ---\n * 4. #### *Strict mode (removes invalid values):*\n *       ```ts\n *       const result = safeJsonParse('{\"name\": \"   \", \"score\": \"99abc\"}', {\n *         convertNumbers: true,\n *         strictMode: true\n *       });\n *       // result ➔ {}\n *\n *       const result2 = safeJsonParse('{\"name\": \"   \", \"score\": undefined}');\n *       // result2 ➔ { name: \"\",score: null }\n *       ```\n *       ---\n * 5. #### *Custom date format parsing:*\n *       ```ts\n *       const result = safeJsonParse('{\"birthday\": \"25/12/2000\"}', {\n *         convertDates: true,\n *         customDateFormats: [\"DD/MM/YYYY\"]\n *       });\n *       // result ➔ { birthday: new Date(\"2000-12-25T00:00:00.000Z\") }\n *       ```\n *       ---\n * 6. #### *Invalid JSON with custom error handling:*\n *       ```ts\n *       safeJsonParse(\"{invalid}\", {\n *         loggingOnFail: true,\n *         onError: (err) => console.log(\"Custom handler:\", err.message)\n *       });\n *       // ➔ Logs parsing error and invokes handler\n *       ```\n *       ---\n * 7. #### *Null or non-string input returns null/undefined (default options):*\n *       ```ts\n *       safeJsonParse(123);\n *       // ➔ undefined\n *       safeJsonParse(null);\n *       // ➔ null\n *       safeJsonParse(undefined);\n *       // ➔ undefined\n *       ```\n *       ---\n * 8. #### *Generic usage: Provide both output and input type to ensure correct return typing:*\n *       ```ts\n *       type UserType = { name: string };\n *\n *       const obj = JSON.stringify({\n *         name: \"John\"\n *       });\n *\n *       const toParse = isAuth() ? obj : null;\n *       const toParse2 = isAuth() ? obj : undefined;\n *\n *       //! * `Without Generic`:\n *         const parsed = safeJsonParse(toParse);\n *         //- runtime: { name: \"John\" } | undefined | null\n *         //- type: Record<string, unknown> | undefined | null\n *         const parsed2 = safeJsonParse(toParse);\n *         //- runtime: { name: \"John\" } | undefined\n *         //- type: Record<string, unknown> | undefined\n *\n *       //! * `With Generic`:\n *         const parsed = safeJsonParse<UserType>(toParse);\n *         //- runtime: { name: \"John\" } | undefined | null\n *         //- type: undefined  <- (⚠️ unexpected!)\n *         const parsed2 = safeJsonParse<UserType>(toParse);\n *         //- runtime: { name: \"John\" } | undefined\n *         //- type: undefined  <- (⚠️ unexpected!)\n *         const parsed = safeJsonParse<UserType, typeof toParse>(toParse);\n *         //- runtime: { name: \"John\" } | null | undefined\n *         //- type: UserType | null | undefined\n *         const parsed2 = safeJsonParse<UserType, typeof toParse>(toParse);\n *         //- runtime: { name: \"John\" } | undefined\n *         //- type: UserType | undefined\n *       ```\n *\n * ---\n * @note\n * - ⚠️ **Generic Behavior:**\n *      - This function supports advanced generic inference for clean, type-safe return values.\n *      - If only the first generic (`TData`) is provided and the second (`TInput`) is omitted,\n *        then `TInput` defaults to `undefined`, resulting in a return type of `undefined`.\n *      - To ensure correct return typing, **always pass both generics** when `value` is dynamic,\n *        nullable, or unioned: `safeJsonParse<TData, typeof value>(value)`.\n *      - This makes the returned type exactly match your expectation: `TData | null | undefined`.\n */\nexport function safeJsonParse<\n  TData extends Record<string, any> = Record<string, unknown>,\n  TInput extends UnknownValue = UnknownValue\n>(\n  value: TInput,\n  options?: ParseParsedDataOptions\n): IsAny<TInput> extends true ? TData | null | undefined : undefined;\nexport function safeJsonParse<\n  TData extends Record<string, any> = Record<string, unknown>,\n  TInput extends string | null | undefined | unknown = undefined\n>(\n  value: TInput,\n  options?: ParseParsedDataOptions\n): SafeJsonParseResult<TData, TInput>;\n//! implement main function\nexport function safeJsonParse<TData extends Record<string, unknown>>(\n  value: unknown,\n  options?: ParseParsedDataOptions\n) {\n  if (isNull(value)) return null;\n  const validOptions = validateJsonParsingOptions(\n    options ?? {},\n    \"safeJsonParse\"\n  );\n\n  if (\n    validOptions.convertNaN &&\n    (isNaN(value) || (isNonEmptyString(value) && value === \"NaN\"))\n  ) {\n    return NaN;\n  }\n  if (\n    validOptions.convertNumbers &&\n    !isNaN(Number(value)) &&\n    isNumber(extractDigits(value))\n  ) {\n    return Number(value);\n  }\n\n  if (!isString(value)) return undefined;\n\n  try {\n    // First, normalize all single quotes to double quotes\n    let normalized = fixSingleQuotesEscapeBackslash(value);\n\n    if (validOptions.removeUndefined) {\n      normalized = normalized\n        .replace(/,\\s*\"[^\"]*\"\\s*:\\s*undefined(?=\\s*[},])/g, \"\")\n        // ➔ remove , \"key\": undefined\n        .replace(/\"[^\"]*\"\\s*:\\s*undefined\\s*(,)?/g, \"\");\n      // ➔ remove \"key\": undefined\n    } else {\n      normalized = normalized.replace(/:\\s*undefined(?=\\s*[,}])/g, \":null\");\n      // ➔ replace :undefined with :null\n    }\n\n    if (validOptions.convertNaN) {\n      // eslint-disable-next-line quotes\n      normalized = normalized.replace(/:\\s*NaN(?=\\s*[,}])/g, ':\"NaN\"');\n      // ➔ convert :NaN to :\"NaN\"\n    } else {\n      normalized = normalized\n        // eslint-disable-next-line quotes\n        .replace(/:\\s*NaN(?=\\s*[,}])/g, ':\"NaN\"')\n        // ➔ convert :NaN to :\"NaN\"\n        .replace(/,\\s*\"[^\"]*\"\\s*:\\s*NaN(?=\\s*[},])/g, \"\")\n        // ➔ remove , \"key\": NaN\n        .replace(/\"[^\"]*\"\\s*:\\s*NaN\\s*(,)?/g, \"\");\n      // ➔ remove \"key\": NaN\n    }\n\n    normalized = normalized.replace(/,(\\s*[}\\]])/g, \"$1\");\n    // ➔ remove trailing comma before } or ]\n\n    const parsed = JSON.parse(normalized);\n    return cleanParsedData<TData>(parsed, validOptions);\n  } catch (error) {\n    if (validOptions.loggingOnFail) {\n      console.error(\n        \"Failed to parsing at `[@rzl-zone/utils-js]:safeJsonParse`:\",\n        error\n      );\n    }\n\n    validOptions.onError(\n      isError(error)\n        ? new Error(error.message.replace(/^JSON\\.parse:/, \"Failed to parsing\"))\n        : new Error(String(error))\n    );\n\n    return undefined;\n  }\n}\n"],"mappings":"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"}

package/dist/safeStableStringify-C5HHKUdn.cjs

@@ -0,0 +1,125 @@
+/*!
+* ========================================================================
+*  @rzl-zone/utils-js
+* ------------------------------------------------------------------------
+*  Version: `3.14.0-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_logger = require('./logger-CUacYy3D.cjs');
+const require_isBigInt = require('./isBigInt-YgpNKTbA.cjs');
+const require_isNumber = require('./isNumber-BkzwAe50.cjs');
+function isMap(value) {
+	return Object.prototype.toString.call(value) === "[object Map]" || value instanceof Map;
+}
+const isDate = (value, options = {}) => {
+	if (!require_logger.isPlainObject(options)) options = {};
+	const skipInvalidDate = require_logger.isPlainObject(options) && require_logger.isBoolean(options.skipInvalidDate) ? options.skipInvalidDate : false;
+	const instanceDate = value instanceof Date;
+	if (skipInvalidDate) return instanceDate;
+	return instanceDate && !require_logger.isNaN(value.getTime());
+};
+const isUndefined = (value) => {
+	return typeof value === "undefined";
+};
+const isSymbol = (value) => {
+	return typeof value === "symbol";
+};
+const safeStableStringify = (value, options = {}) => {
+	if (!require_logger.isPlainObject(options)) options = {};
+	const pretty = options.pretty ?? false;
+	const sortKeys = options.sortKeys ?? true;
+	const sortArray = options.sortArray ?? false;
+	const keepUndefined = options.keepUndefined ?? false;
+	if (!require_logger.isBoolean(sortKeys) || !require_logger.isBoolean(sortArray) || !require_logger.isBoolean(pretty) || !require_logger.isBoolean(keepUndefined)) throw new TypeError(require_logger.createMessage("safeStableStringify", `Parameters \`sortKeys\`, \`sortArray\`, \`keepUndefined\` and \`pretty\` property of the \`options\` (second parameter) must be of type \`boolean\`, but received: "['sortKeys': \`${require_logger.getPreciseType(sortKeys)}\`, 'sortArray': \`${require_logger.getPreciseType(sortArray)}\`, 'keepUndefined': \`${require_logger.getPreciseType(keepUndefined)}\`, 'pretty': \`${require_logger.getPreciseType(pretty)}\`]".`));
+	if (isUndefined(value)) return keepUndefined ? "undefined" : "null";
+	const seen = /* @__PURE__ */ new WeakSet();
+	const isPrimitive = (val) => require_logger.isNull(val) || !require_logger.isObjectOrArray(val) && !require_logger.isFunction(val);
+	const deepProcess = (val) => {
+		if (require_logger.isNumberObject(val)) {
+			const valOf = val.valueOf();
+			return require_logger.isNaN(valOf) || require_logger.isInfinityNumber(valOf) ? null : valOf;
+		}
+		if (require_logger.isStringObject(val)) return val.valueOf();
+		if (require_logger.isBooleanObject(val)) return val.valueOf();
+		if (require_logger.isFunction(val) || isSymbol(val)) return void 0;
+		if (require_isBigInt.isBigInt(val)) return val.toString();
+		if (require_logger.isNaN(val) || require_logger.isInfinityNumber(val)) return null;
+		if (isUndefined(val)) return keepUndefined ? void 0 : null;
+		if (require_logger.isObjectOrArray(val)) {
+			if (seen.has(val)) return "[Circular]";
+			seen.add(val);
+			if (isDate(val)) return val.toISOString();
+			if (isMap(val)) return { map: Array.from(val.entries()).map(([k, v]) => [k, deepProcess(v)]) };
+			if (require_logger.isSet(val)) return { set: Array.from(val.values()).map(deepProcess) };
+			if (require_logger.isArray(val)) {
+				const processedArr = val.map(deepProcess);
+				if (sortArray) {
+					const primitives = [];
+					const nonPrimitives = [];
+					for (const item of processedArr) if (isPrimitive(item)) primitives.push(item);
+					else nonPrimitives.push(item);
+					primitives.sort((a, b) => {
+						if (require_isNumber.isNumber(a) && require_isNumber.isNumber(b)) return a - b;
+						return String(a).localeCompare(String(b));
+					});
+					return [...primitives, ...nonPrimitives];
+				}
+				return processedArr;
+			}
+			const keys = Object.keys(val);
+			if (sortKeys) keys.sort((a, b) => {
+				const na = Number(a);
+				const nb = Number(b);
+				if (!require_logger.isNaN(na) && !require_logger.isNaN(nb)) return na - nb;
+				return a.localeCompare(b);
+			});
+			const result = {};
+			if (require_logger.isObject(val)) for (const k of keys) {
+				const v = deepProcess(val[k]);
+				if (!isUndefined(v)) result[k] = v;
+			}
+			return result;
+		}
+		return val;
+	};
+	try {
+		return JSON.stringify(deepProcess(value), null, pretty ? 2 : 0);
+	} catch (err) {
+		console.warn(require_logger.createMessage("safeStableStringify", String(err)));
+		return "{}";
+	}
+};
+Object.defineProperty(exports, 'isDate', {
+  enumerable: true,
+  get: function () {
+    return isDate;
+  }
+});
+Object.defineProperty(exports, 'isMap', {
+  enumerable: true,
+  get: function () {
+    return isMap;
+  }
+});
+Object.defineProperty(exports, 'isSymbol', {
+  enumerable: true,
+  get: function () {
+    return isSymbol;
+  }
+});
+Object.defineProperty(exports, 'isUndefined', {
+  enumerable: true,
+  get: function () {
+    return isUndefined;
+  }
+});
+Object.defineProperty(exports, 'safeStableStringify', {
+  enumerable: true,
+  get: function () {
+    return safeStableStringify;
+  }
+});
+//# sourceMappingURL=safeStableStringify-C5HHKUdn.cjs.map