toolbox-x 1.1.0 → 1.1.1

package/dist/dom.cjs

@@ -18,6 +18,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_primitives = require('./primitives-CBGICrDR.cjs');
 const require_specials = require('./specials-BM6cx43o.cjs');
 const require_guards = require('./guards-FSW16LfU.cjs');
+const require_basics = require('./basics-K8BDSYD6.cjs');
 const require_objectify = require('./objectify-CRUYlTtI.cjs');
 const require_utils = require('./utils-B1BHomba.cjs');
 
@@ -266,19 +267,20 @@ async function copyToClipboard(text) {
 * @returns `FormData` instance containing the sanitized and transformed data.
 */
 const createFormData = (data, configs) => {
+	if (typeof FormData === "undefined") throw new Error("FormData is not available! Please make sure your environment supports FormData.");
 	const formData = new FormData();
-	const { stringifyNested = "*" } = configs || {};
-	/** - Helper to compare a key with a path */
-	const _compareKeyPath = (key, path) => {
-		return key === path || key.startsWith(`${path}.`);
+	const { stringifyNested = "*", ignoreKeys = [], breakArray, lowerCaseKeys, dotNotateNested, lowerCaseValues, requiredKeys } = configs || {};
+	/** - Helper to check if a key (plain or dot-notated) matches a path */
+	const _compareKeyPaths = (key, paths) => {
+		return paths.some((path) => key === path || key.startsWith(`${path}.`));
 	};
 	/** - Helper to check if a key should be lowercase */
 	const _shouldLowercaseKeys = (key) => {
-		return Array.isArray(configs?.lowerCaseKeys) ? configs?.lowerCaseKeys?.some((path) => _compareKeyPath(key, path)) : configs?.lowerCaseKeys === "*";
+		return Array.isArray(lowerCaseKeys) ? _compareKeyPaths(key, lowerCaseKeys) : lowerCaseKeys === "*";
 	};
 	/** - Helper to check if a key should be lowercase */
 	const _shouldLowercaseValue = (key) => {
-		return Array.isArray(configs?.lowerCaseValues) ? configs.lowerCaseValues?.some((path) => _compareKeyPath(key, path)) : configs?.lowerCaseValues === "*";
+		return Array.isArray(lowerCaseValues) ? _compareKeyPaths(key, lowerCaseValues) : lowerCaseValues === "*";
 	};
 	/** - Transforms key to lowercase if needed */
 	const _transformKey = (key) => {
@@ -291,29 +293,29 @@ const createFormData = (data, configs) => {
 	/** - Helper function to check if a key matches a breakArray key. */
 	const _isRequiredKey = (key) => {
 		const transformedKey = _transformKey(key);
-		return Array.isArray(configs?.requiredKeys) ? configs?.requiredKeys?.some((path) => _compareKeyPath(transformedKey, path)) : configs?.requiredKeys === "*";
+		return Array.isArray(requiredKeys) ? _compareKeyPaths(transformedKey, requiredKeys) : requiredKeys === "*";
 	};
 	/** - Helper function to check if a key matches a dotNotation path to preserve. */
 	const _shouldDotNotate = (key) => {
 		const transformedKey = _transformKey(key);
-		return Array.isArray(configs?.dotNotateNested) ? configs?.dotNotateNested?.some((path) => _compareKeyPath(transformedKey, path)) : configs?.dotNotateNested === "*";
+		return Array.isArray(dotNotateNested) ? _compareKeyPaths(transformedKey, dotNotateNested) : dotNotateNested === "*";
 	};
 	/** - Helper function to check if a key matches a stringifyNested key. */
 	const _shouldStringify = (key) => {
 		const transformedKey = _transformKey(key);
-		return Array.isArray(stringifyNested) ? stringifyNested?.some((path) => _compareKeyPath(transformedKey, path)) : stringifyNested === "*";
+		return Array.isArray(stringifyNested) ? _compareKeyPaths(transformedKey, stringifyNested) : stringifyNested === "*";
 	};
 	/** - Helper function to check if a key matches a breakArray key. */
 	const _shouldBreakArray = (key) => {
 		const transformedKey = _transformKey(key);
-		return Array.isArray(configs?.breakArray) ? configs.breakArray.some((path) => _compareKeyPath(transformedKey, path)) : configs?.breakArray === "*";
+		return Array.isArray(breakArray) ? _compareKeyPaths(transformedKey, breakArray) : breakArray === "*";
 	};
 	/** - Helper to clean object by removing null/undefined/empty values while respecting required keys */
 	const _cleanObject = (obj, parentKey = "") => {
 		return Object.entries(obj).reduce((acc, [key, value]) => {
 			const transformedKey = _transformKey(key);
 			const fullKey = parentKey ? `${parentKey}.${transformedKey}` : transformedKey;
-			if (configs?.ignoreKeys?.includes(fullKey)) return acc;
+			if (_compareKeyPaths(fullKey, ignoreKeys)) return acc;
 			if (value != null && value !== "" || _isRequiredKey(fullKey) || require_primitives.isNonEmptyString(value) || require_specials.isValidArray(value) || require_specials.isNotEmptyObject(value)) if (require_guards.isDateLike(value)) acc[transformedKey] = value;
 			else if (require_specials.isNotEmptyObject(value)) if (require_guards.isDateLike(value)) acc[transformedKey] = value;
 			else {
@@ -322,7 +324,7 @@ const createFormData = (data, configs) => {
 			}
 			else if (require_primitives.isString(value)) if (require_primitives.isNonEmptyString(value)) {
 				let cleanString = value;
-				if (configs?.trimStrings) cleanString = cleanString?.trim();
+				if (configs?.trimStrings) cleanString = require_basics.trimString(cleanString);
 				if (_shouldLowercaseValue(fullKey)) cleanString = cleanString?.toLowerCase();
 				acc[transformedKey] = cleanString;
 			} else acc[transformedKey] = value;
@@ -337,6 +339,7 @@ const createFormData = (data, configs) => {
 	/** * Helper function to add values to formData */
 	const _addToFormData = (key, value) => {
 		const transformedKey = _transformKey(key);
+		if (_compareKeyPaths(transformedKey, ignoreKeys)) return;
 		if (require_objectify.isCustomFileArray(value)) value?.forEach((file) => formData.append(transformedKey, file?.originFileObj));
 		else if (require_objectify.isFileUpload(value)) {
 			if (value?.fileList) value?.fileList.forEach((file) => formData.append(transformedKey, file?.originFileObj));
@@ -365,7 +368,7 @@ const createFormData = (data, configs) => {
 		});
 		else if (value != null && value !== "" || _isRequiredKey(key)) if (require_primitives.isString(value)) {
 			let processedValue = value;
-			if (configs?.trimStrings) processedValue = processedValue.trim();
+			if (configs?.trimStrings) processedValue = require_basics.trimString(processedValue);
 			if (_shouldLowercaseValue(key)) processedValue = processedValue.toLowerCase();
 			formData.append(transformedKey, processedValue);
 		} else formData.append(transformedKey, value);
@@ -375,8 +378,8 @@ const createFormData = (data, configs) => {
 		Object.entries(obj).forEach(([key, value]) => {
 			const transformedKey = _transformKey(key);
 			const fullKey = parentKey ? `${parentKey}.${transformedKey}` : transformedKey;
-			if (configs?.ignoreKeys?.includes(fullKey)) return;
-			if (configs?.trimStrings && require_primitives.isNonEmptyString(value)) value = value.trim();
+			if (_compareKeyPaths(fullKey, ignoreKeys)) return;
+			if (configs?.trimStrings && require_primitives.isNonEmptyString(value)) value = require_basics.trimString(value);
 			if (_shouldDotNotate(fullKey)) _addToFormData(fullKey, value);
 			else if (require_specials.isNotEmptyObject(value) && !_shouldStringify(fullKey)) if (require_guards.isDateLike(value)) _addToFormData(key, _parseDateLike(value));
 			else _processObject(value, key);

package/dist/dom.mjs

@@ -17,6 +17,7 @@
 import { a as isNonEmptyString, d as isString } from "./primitives-Djsevc69.mjs";
 import { j as isValidArray, v as isEmptyObject, w as isNotEmptyObject } from "./specials-Cye93-uo.mjs";
 import { t as isDateLike } from "./guards-DEcnNbI5.mjs";
+import { n as trimString } from "./basics-1_M7UvCn.mjs";
 import { _ as isOriginFileObj, a as flattenObjectKeyValue, d as isCustomFile, f as isCustomFileArray, g as isFileUpload, h as isFileOrBlob, l as parseObjectValues, m as isFileList, p as isFileArray, v as isValidFormData } from "./objectify-DgkPCH_o.mjs";
 import { a as deepParsePrimitives } from "./utils-BCytS67y.mjs";
 
@@ -265,19 +266,20 @@ async function copyToClipboard(text) {
 * @returns `FormData` instance containing the sanitized and transformed data.
 */
 const createFormData = (data, configs) => {
+	if (typeof FormData === "undefined") throw new Error("FormData is not available! Please make sure your environment supports FormData.");
 	const formData = new FormData();
-	const { stringifyNested = "*" } = configs || {};
-	/** - Helper to compare a key with a path */
-	const _compareKeyPath = (key, path) => {
-		return key === path || key.startsWith(`${path}.`);
+	const { stringifyNested = "*", ignoreKeys = [], breakArray, lowerCaseKeys, dotNotateNested, lowerCaseValues, requiredKeys } = configs || {};
+	/** - Helper to check if a key (plain or dot-notated) matches a path */
+	const _compareKeyPaths = (key, paths) => {
+		return paths.some((path) => key === path || key.startsWith(`${path}.`));
 	};
 	/** - Helper to check if a key should be lowercase */
 	const _shouldLowercaseKeys = (key) => {
-		return Array.isArray(configs?.lowerCaseKeys) ? configs?.lowerCaseKeys?.some((path) => _compareKeyPath(key, path)) : configs?.lowerCaseKeys === "*";
+		return Array.isArray(lowerCaseKeys) ? _compareKeyPaths(key, lowerCaseKeys) : lowerCaseKeys === "*";
 	};
 	/** - Helper to check if a key should be lowercase */
 	const _shouldLowercaseValue = (key) => {
-		return Array.isArray(configs?.lowerCaseValues) ? configs.lowerCaseValues?.some((path) => _compareKeyPath(key, path)) : configs?.lowerCaseValues === "*";
+		return Array.isArray(lowerCaseValues) ? _compareKeyPaths(key, lowerCaseValues) : lowerCaseValues === "*";
 	};
 	/** - Transforms key to lowercase if needed */
 	const _transformKey = (key) => {
@@ -290,29 +292,29 @@ const createFormData = (data, configs) => {
 	/** - Helper function to check if a key matches a breakArray key. */
 	const _isRequiredKey = (key) => {
 		const transformedKey = _transformKey(key);
-		return Array.isArray(configs?.requiredKeys) ? configs?.requiredKeys?.some((path) => _compareKeyPath(transformedKey, path)) : configs?.requiredKeys === "*";
+		return Array.isArray(requiredKeys) ? _compareKeyPaths(transformedKey, requiredKeys) : requiredKeys === "*";
 	};
 	/** - Helper function to check if a key matches a dotNotation path to preserve. */
 	const _shouldDotNotate = (key) => {
 		const transformedKey = _transformKey(key);
-		return Array.isArray(configs?.dotNotateNested) ? configs?.dotNotateNested?.some((path) => _compareKeyPath(transformedKey, path)) : configs?.dotNotateNested === "*";
+		return Array.isArray(dotNotateNested) ? _compareKeyPaths(transformedKey, dotNotateNested) : dotNotateNested === "*";
 	};
 	/** - Helper function to check if a key matches a stringifyNested key. */
 	const _shouldStringify = (key) => {
 		const transformedKey = _transformKey(key);
-		return Array.isArray(stringifyNested) ? stringifyNested?.some((path) => _compareKeyPath(transformedKey, path)) : stringifyNested === "*";
+		return Array.isArray(stringifyNested) ? _compareKeyPaths(transformedKey, stringifyNested) : stringifyNested === "*";
 	};
 	/** - Helper function to check if a key matches a breakArray key. */
 	const _shouldBreakArray = (key) => {
 		const transformedKey = _transformKey(key);
-		return Array.isArray(configs?.breakArray) ? configs.breakArray.some((path) => _compareKeyPath(transformedKey, path)) : configs?.breakArray === "*";
+		return Array.isArray(breakArray) ? _compareKeyPaths(transformedKey, breakArray) : breakArray === "*";
 	};
 	/** - Helper to clean object by removing null/undefined/empty values while respecting required keys */
 	const _cleanObject = (obj, parentKey = "") => {
 		return Object.entries(obj).reduce((acc, [key, value]) => {
 			const transformedKey = _transformKey(key);
 			const fullKey = parentKey ? `${parentKey}.${transformedKey}` : transformedKey;
-			if (configs?.ignoreKeys?.includes(fullKey)) return acc;
+			if (_compareKeyPaths(fullKey, ignoreKeys)) return acc;
 			if (value != null && value !== "" || _isRequiredKey(fullKey) || isNonEmptyString(value) || isValidArray(value) || isNotEmptyObject(value)) if (isDateLike(value)) acc[transformedKey] = value;
 			else if (isNotEmptyObject(value)) if (isDateLike(value)) acc[transformedKey] = value;
 			else {
@@ -321,7 +323,7 @@ const createFormData = (data, configs) => {
 			}
 			else if (isString(value)) if (isNonEmptyString(value)) {
 				let cleanString = value;
-				if (configs?.trimStrings) cleanString = cleanString?.trim();
+				if (configs?.trimStrings) cleanString = trimString(cleanString);
 				if (_shouldLowercaseValue(fullKey)) cleanString = cleanString?.toLowerCase();
 				acc[transformedKey] = cleanString;
 			} else acc[transformedKey] = value;
@@ -336,6 +338,7 @@ const createFormData = (data, configs) => {
 	/** * Helper function to add values to formData */
 	const _addToFormData = (key, value) => {
 		const transformedKey = _transformKey(key);
+		if (_compareKeyPaths(transformedKey, ignoreKeys)) return;
 		if (isCustomFileArray(value)) value?.forEach((file) => formData.append(transformedKey, file?.originFileObj));
 		else if (isFileUpload(value)) {
 			if (value?.fileList) value?.fileList.forEach((file) => formData.append(transformedKey, file?.originFileObj));
@@ -364,7 +367,7 @@ const createFormData = (data, configs) => {
 		});
 		else if (value != null && value !== "" || _isRequiredKey(key)) if (isString(value)) {
 			let processedValue = value;
-			if (configs?.trimStrings) processedValue = processedValue.trim();
+			if (configs?.trimStrings) processedValue = trimString(processedValue);
 			if (_shouldLowercaseValue(key)) processedValue = processedValue.toLowerCase();
 			formData.append(transformedKey, processedValue);
 		} else formData.append(transformedKey, value);
@@ -374,8 +377,8 @@ const createFormData = (data, configs) => {
 		Object.entries(obj).forEach(([key, value]) => {
 			const transformedKey = _transformKey(key);
 			const fullKey = parentKey ? `${parentKey}.${transformedKey}` : transformedKey;
-			if (configs?.ignoreKeys?.includes(fullKey)) return;
-			if (configs?.trimStrings && isNonEmptyString(value)) value = value.trim();
+			if (_compareKeyPaths(fullKey, ignoreKeys)) return;
+			if (configs?.trimStrings && isNonEmptyString(value)) value = trimString(value);
 			if (_shouldDotNotate(fullKey)) _addToFormData(fullKey, value);
 			else if (isNotEmptyObject(value) && !_shouldStringify(fullKey)) if (isDateLike(value)) _addToFormData(key, _parseDateLike(value));
 			else _processObject(value, key);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolbox-x",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "A versatile collection of smart, efficient, and reusable utility functions, classes and types for everyday development needs.",
   "main": "./dist/index.cjs",
   "type": "module",