nhb-toolbox 2.8.9 → 2.9.2

package/dist/form/convert.d.ts

@@ -1,16 +1,11 @@
 import type { GenericObject } from '../object/types';
+import type { FormDataConfigs } from './types';
 /**
- * * Utility to convert object into FormData.
+ * * Utility to convert object into FormData in a controlled way.
  *
- * @param data Data to convert into FormData.
- * @returns Converted FormData.
+ * @param data - The source object to control and convert to FormData.
+ * @param configs - Configuration options to control the formData.
+ * @returns `FormData` instance containing the sanitized and transformed data.
  */
-export declare const convertIntoFormData: <T extends GenericObject>(data: T) => FormData;
-/**
- * * Check if a formdata object is empty.
- *
- * @param data FormData to check.
- * @returns Boolean (`true`/`false`) Whether the formdata is empty.
- */
-export declare const isEmptyFormData: (data: FormData) => boolean;
+export declare const createControlledFormData: <T extends GenericObject>(data: T, configs?: FormDataConfigs<T>) => FormData;
 //# sourceMappingURL=convert.d.ts.map

package/dist/form/convert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../src/form/convert.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,aAAa,QACpD,CAAC,KACL,QAYF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,SAAU,QAAQ,KAAG,OAQhD,CAAC"}
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../src/form/convert.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAEX,aAAa,EAEb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,GAAI,CAAC,SAAS,aAAa,QACzD,CAAC,YACG,eAAe,CAAC,CAAC,CAAC,KAC1B,QAiPF,CAAC"}

package/dist/form/convert.js

@@ -1,31 +1,213 @@
-import { isInvalidOrEmptyArray } from '../array/basics';
+import { isEmptyObject, isNotEmptyObject, isValidArray, } from '../guards/non-primitives';
+import { isNonEmptyString } from '../guards/primitives';
+import { isCustomFile, isCustomFileArray, isFileUpload } from './guards';
 /**
- * * Utility to convert object into FormData.
+ * * Utility to convert object into FormData in a controlled way.
  *
- * @param data Data to convert into FormData.
- * @returns Converted FormData.
+ * @param data - The source object to control and convert to FormData.
+ * @param configs - Configuration options to control the formData.
+ * @returns `FormData` instance containing the sanitized and transformed data.
  */
-export const convertIntoFormData = (data) => {
+export const createControlledFormData = (data, configs) => {
     const formData = new FormData();
-    Object.entries(data).forEach(([key, value]) => {
-        if (!isInvalidOrEmptyArray(value) && value[0]?.originFileObj) {
-            formData.append(key, value[0].originFileObj);
+    const { stringifyNested = '*' } = configs || {};
+    /** - Helper to check if a key should be lowercase */
+    const shouldLowercaseKeys = (key) => {
+        return Array.isArray(configs?.lowerCaseKeys) ?
+            configs.lowerCaseKeys.some((path) => key === path || key.startsWith(`${path}.`))
+            : configs?.lowerCaseKeys === '*';
+    };
+    /** - Helper to check if a key should be lowercase */
+    const shouldLowercaseValue = (key) => {
+        return Array.isArray(configs?.lowerCaseValues) ?
+            configs.lowerCaseValues.some((path) => key === path || key.startsWith(`${path}.`))
+            : configs?.lowerCaseValues === '*';
+    };
+    /** - Transforms key to lowercase if needed */
+    const _transformKey = (key) => {
+        return shouldLowercaseKeys(key) ? key.toLowerCase() : key;
+    };
+    /** - 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) => transformedKey === path ||
+                transformedKey.startsWith(`${path}.`))
+            : configs?.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.includes(transformedKey)
+            : configs?.dotNotateNested === '*';
+    };
+    /** - Helper function to check if a key matches a stringifyNested key. */
+    const shouldStringify = (key) => {
+        const transformedKey = _transformKey(key);
+        return Array.isArray(stringifyNested) ?
+            stringifyNested.includes(transformedKey)
+            : 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.includes(transformedKey)
+            : configs?.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;
+            // * Skip ignored keys (don't include them in the cleaned object)
+            if (configs?.ignoreKeys?.includes(fullKey)) {
+                return acc;
+            }
+            const isNotNullish = value != null && value !== '';
+            // * Keep value if:
+            // * 1. It's required OR
+            // * 2. It's not null/undefined AND not empty string/object
+            const shouldKeep = isRequiredKey(fullKey) ||
+                isNotNullish ||
+                isNonEmptyString(value) ||
+                isValidArray(value) ||
+                isNotEmptyObject(value);
+            if (shouldKeep) {
+                if (isNotEmptyObject(value)) {
+                    // * Recursively clean nested objects
+                    const cleaned = _cleanObject(value, fullKey);
+                    if (isRequiredKey(fullKey) || isNotEmptyObject(cleaned)) {
+                        acc[_transformKey(key)] = cleaned;
+                    }
+                }
+                else {
+                    if (typeof value === 'string') {
+                        acc[_transformKey(key)] = value.toLowerCase();
+                    }
+                    else if (Array.isArray(value)) {
+                        if (isRequiredKey(fullKey) || isValidArray(value)) {
+                            acc[_transformKey(key)] = value;
+                        }
+                    }
+                    else if (isEmptyObject(value)) {
+                        if (isRequiredKey(fullKey)) {
+                            acc[_transformKey(key)] = value;
+                        }
+                    }
+                    else {
+                        acc[_transformKey(key)] = value;
+                    }
+                }
+            }
+            return acc;
+        }, {});
+    };
+    /** * Helper function to add values to formData */
+    const _addToFormData = (key, value) => {
+        const transformedKey = _transformKey(key);
+        if (isCustomFileArray(value)) {
+            value.forEach((file) => formData.append(transformedKey, file.originFileObj));
         }
-        else if (value !== undefined && value !== null && value !== '') {
-            formData.append(key, value);
+        else if (isFileUpload(value)) {
+            if (value.fileList) {
+                value.fileList.forEach((file) => formData.append(transformedKey, file.originFileObj));
+            }
+            else if (value.file) {
+                if (isCustomFile(value.file)) {
+                    formData.append(transformedKey, value.file.originFileObj);
+                }
+                else {
+                    formData.append(transformedKey, value.file);
+                }
+            }
         }
-    });
-    return formData;
-};
-/**
- * * Check if a formdata object is empty.
- *
- * @param data FormData to check.
- * @returns Boolean (`true`/`false`) Whether the formdata is empty.
- */
-export const isEmptyFormData = (data) => {
-    if ('entries' in data && typeof data.entries === 'function') {
-        return Array.from(data.entries()).length === 0;
+        else if (value instanceof Blob || value instanceof File) {
+            formData.append(transformedKey, value);
+        }
+        // else if (value instanceof FileList) {
+        // 	for (let i = 0; i < value.length; i++) {
+        // 		formData.append(transformedKey, value.item(i) as File);
+        // 	}
+        // }
+        else if (Array.isArray(value)) {
+            if (isValidArray(value)) {
+                if (shouldBreakArray(key)) {
+                    value.forEach((item, index) => {
+                        _addToFormData(`${transformedKey}[${index}]`, item);
+                    });
+                }
+                else {
+                    formData.append(transformedKey, JSON.stringify(value));
+                }
+            }
+            else if (isRequiredKey(key)) {
+                formData.append(transformedKey, JSON.stringify(value));
+            }
+        }
+        else if (isNotEmptyObject(value)) {
+            if (shouldStringify(key) && !shouldDotNotate(key)) {
+                // * Clean object before stringifying, preserving required keys
+                const cleanedValue = _cleanObject(value, key);
+                if (isNotEmptyObject(cleanedValue) || isRequiredKey(key)) {
+                    formData.append(transformedKey, JSON.stringify(cleanedValue));
+                }
+            }
+            else {
+                Object.entries(value).forEach(([nestedKey, nestedValue]) => {
+                    _addToFormData(`${key}.${nestedKey}`, nestedValue);
+                });
+            }
+        }
+        else {
+            const isNotNullish = value != null && value !== '';
+            if (isNotNullish || isRequiredKey(key)) {
+                if (typeof value === 'string' && shouldLowercaseValue(key)) {
+                    formData.append(transformedKey, value.toLowerCase());
+                }
+                // else if (isRequiredKey(key) || isNotEmptyObject(value)) {
+                // 	formData.append(transformedKey, JSON.stringify(value));
+                // }
+                else {
+                    formData.append(transformedKey, value);
+                }
+            }
+        }
+    };
+    /** - Helper to process object */
+    const _processObject = (obj, parentKey = '') => {
+        Object.entries(obj).forEach(([key, value]) => {
+            const transformedKey = _transformKey(key);
+            const fullKey = parentKey ? `${parentKey}.${transformedKey}` : transformedKey;
+            // * Skip keys that are in ignoreKeys
+            if (configs?.ignoreKeys?.includes(fullKey))
+                return;
+            // * Trim string values if trimStrings is enabled
+            if (configs?.trimStrings && typeof value === 'string') {
+                value = value.trim();
+            }
+            // * Check if this key is preserved as dot-notation
+            if (shouldDotNotate(fullKey)) {
+                _addToFormData(fullKey, value);
+            }
+            else if (isNotEmptyObject(value) && !shouldStringify(fullKey)) {
+                // * Process nested objects
+                _processObject(value, key);
+            }
+            else if (isEmptyObject(value)) {
+                if (isRequiredKey(fullKey)) {
+                    _addToFormData(key, JSON.stringify(value));
+                }
+            }
+            else {
+                // * For other cases, just append as key-value
+                _addToFormData(key, value);
+            }
+        });
+    };
+    if (isNotEmptyObject(data)) {
+        _processObject(data);
     }
-    throw new Error('`FormData.entries()` is not supported in this environment!');
+    return formData;
 };

package/dist/form/guards.d.ts

@@ -1,4 +1,10 @@
 import type { CustomFile, FileUpload, OriginFileObj } from './types';
+/**
+ * * Checks if a given value is a valid `FormData` & it's not empty.
+ * @param value - The value to check.
+ * @returns `true` if the value is a valid `FormData` and not empty, otherwise `false`.
+ */
+export declare function isValidFormData(value: unknown): value is FormData;
 /**
  * * Checks if a given value is an `OriginFileObj`.
  * @param value - The value to check.

package/dist/form/guards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../src/form/guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAErE;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAQtE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAQhE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,EAAE,CAIvE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAWhE"}
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../src/form/guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAErE;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAajE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAQtE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAQhE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,EAAE,CAIvE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAWhE"}

package/dist/form/guards.js

@@ -1,3 +1,20 @@
+/**
+ * * Checks if a given value is a valid `FormData` & it's not empty.
+ * @param value - The value to check.
+ * @returns `true` if the value is a valid `FormData` and not empty, otherwise `false`.
+ */
+export function isValidFormData(value) {
+    if (!(value instanceof FormData))
+        return false;
+    if ('entries' in value) {
+        if (typeof value.entries !== 'function') {
+            console.warn('`FormData.entries()` is not supported!');
+            return false;
+        }
+        return Array.from(value.entries()).length > 0;
+    }
+    return false;
+}
 /**
  * * Checks if a given value is an `OriginFileObj`.
  * @param value - The value to check.

package/dist/form/types.d.ts

@@ -1,4 +1,4 @@
-import type { DotNotationKey, KeyForArray, KeyForObject } from '../object/types';
+import type { DotNotationKey, KeyForArray, KeyForObject, NestedKeyString } from '../object/types';
 /** - Configuration options to control FormData generation behavior. */
 export interface FormDataConfigs<T> {
     /**
@@ -16,6 +16,11 @@ export interface FormDataConfigs<T> {
      * * Use `*` to apply to all keys.
      */
     lowerCaseKeys?: '*' | DotNotationKey<T>[];
+    /**
+     * * Defines which values should be converted to lowercase.
+     * * Use `*` to apply to all keys.
+     */
+    lowerCaseValues?: '*' | NestedKeyString<T>[];
     /**
      * * An array of keys (values must be object) to preserve in their original structure.
      * - Use `*` to preserve all keys with object values in their dot-notation format.

package/dist/form/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/form/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,cAAc,EACd,WAAW,EACX,YAAY,EACZ,MAAM,iBAAiB,CAAC;AAEzB,uEAAuE;AACvE,MAAM,WAAW,eAAe,CAAC,CAAC;IACjC;;;OAGG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAEjC;;;OAGG;IACH,YAAY,CAAC,EAAE,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAEzC;;;OAGG;IACH,aAAa,CAAC,EAAE,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAE1C;;;;OAIG;IACH,eAAe,CAAC,EAAE,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAE1C;;;;;OAKG;IACH,eAAe,CAAC,EAAE,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAE1C;;;;OAIG;IACH,UAAU,CAAC,EAAE,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IAEpC,uFAAuF;IACvF,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,+GAA+G;AAC/G,MAAM,WAAW,UAAU;IAC1B,uCAAuC;IACvC,IAAI,EAAE,IAAI,GAAG,UAAU,CAAC;IACxB,oDAAoD;IACpD,QAAQ,EAAE,UAAU,EAAE,CAAC;CACvB;AAED,2EAA2E;AAC3E,MAAM,WAAW,UAAU;IAC1B,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,gBAAgB,EAAE,IAAI,CAAC;IACvB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,aAAa,EAAE,aAAa,CAAC;IAC7B,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,sEAAsE;AACtE,MAAM,WAAW,aAAc,SAAQ,IAAI;IAC1C,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,8DAA8D;AAC9D,MAAM,WAAW,SAAU,SAAQ,KAAK;IACvC,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;CACZ"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/form/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,cAAc,EACd,WAAW,EACX,YAAY,EACZ,eAAe,EACf,MAAM,iBAAiB,CAAC;AAEzB,uEAAuE;AACvE,MAAM,WAAW,eAAe,CAAC,CAAC;IACjC;;;OAGG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAEjC;;;OAGG;IACH,YAAY,CAAC,EAAE,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAEzC;;;OAGG;IACH,aAAa,CAAC,EAAE,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAE1C;;;OAGG;IACH,eAAe,CAAC,EAAE,GAAG,GAAG,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IAE7C;;;;OAIG;IACH,eAAe,CAAC,EAAE,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAE1C;;;;;OAKG;IACH,eAAe,CAAC,EAAE,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAE1C;;;;OAIG;IACH,UAAU,CAAC,EAAE,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IAEpC,uFAAuF;IACvF,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,+GAA+G;AAC/G,MAAM,WAAW,UAAU;IAC1B,uCAAuC;IACvC,IAAI,EAAE,IAAI,GAAG,UAAU,CAAC;IACxB,oDAAoD;IACpD,QAAQ,EAAE,UAAU,EAAE,CAAC;CACvB;AAED,2EAA2E;AAC3E,MAAM,WAAW,UAAU;IAC1B,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,gBAAgB,EAAE,IAAI,CAAC;IACvB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,aAAa,EAAE,aAAa,CAAC;IAC7B,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,sEAAsE;AACtE,MAAM,WAAW,aAAc,SAAQ,IAAI;IAC1C,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,8DAA8D;AAC9D,MAAM,WAAW,SAAU,SAAQ,KAAK;IACvC,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;CACZ"}

package/dist/guards/non-primitives.d.ts

@@ -1,30 +1,42 @@
 import type { AsyncFunction, GenericFn } from '../types';
 /**
- * Type guard to check if a value is an array.
+ * * Type guard to check if a value is an array.
  * @param value - The value to check.
  * @returns `true` if the value is an array, otherwise `false`.
  */
 export declare function isArray<T>(value: unknown): value is Array<T>;
 /**
- * Type guard to check if a value is an object (excluding null).
+ * * Type guard to check if a value is an array with length.
+ * @param value - The value to check.
+ * @returns `true` if the value is an array with length, otherwise `false`.
+ */
+export declare function isValidArray<T>(value: unknown): value is Array<T>;
+/**
+ * * Type guard to check if a value is an object (excluding null).
  * @param value - The value to check.
  * @returns `true` if the value is an object, otherwise `false`.
  */
 export declare function isObject(value: unknown): value is Record<string, unknown>;
 /**
- * Type guard to check if a value is a function.
+ * * Type guard to check if a value is an object (excluding null) and has keys in it.
+ * @param value - The value to check.
+ * @returns `true` if the value is an object with valid keys, otherwise `false`.
+ */
+export declare function isNotEmptyObject(value: unknown): value is Record<string, unknown>;
+/**
+ * * Type guard to check if a value is a function.
  * @param value - The value to check.
  * @returns `true` if the value is a function, otherwise `false`.
  */
 export declare function isFunction(value: unknown): value is GenericFn;
 /**
- * Type guard to check if a value is a Date object.
+ * * Type guard to check if a value is a Date object.
  * @param value - The value to check.
  * @returns `true` if the value is a Date object, otherwise `false`.
  */
 export declare function isDate(value: unknown): value is Date;
 /**
- * Type guard to check if a value is an object with specific keys.
+ * * Type guard to check if a value is an object with specific keys.
  * @param value - The value to check.
  * @param keys - The set of keys the object should contain.
  * @returns `true` if the value is an object with the specified keys, otherwise `false`.

package/dist/guards/non-primitives.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"non-primitives.d.ts","sourceRoot":"","sources":["../../src/guards/non-primitives.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGzD;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GACf,KAAK,IAAI,CAAC,CAEZ;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC5B,KAAK,EAAE,OAAO,GACZ,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAElC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC9B,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,IAAI,CAAC,GACrC,KAAK,IAAI,CAAC,EAAE,CAEd;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,CAExD;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAStD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,aAAa,CAAC,CAAC,CAAC,CAEzE"}
+{"version":3,"file":"non-primitives.d.ts","sourceRoot":"","sources":["../../src/guards/non-primitives.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGzD;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,OAAO,GACZ,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAElC;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GACf,KAAK,IAAI,CAAC,CAEZ;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC5B,KAAK,EAAE,OAAO,GACZ,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAElC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC9B,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,IAAI,CAAC,GACrC,KAAK,IAAI,CAAC,EAAE,CAEd;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,CAExD;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAStD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,aAAa,CAAC,CAAC,CAAC,CAEzE"}

package/dist/guards/non-primitives.js

@@ -1,6 +1,6 @@
 import { isString } from './primitives';
 /**
- * Type guard to check if a value is an array.
+ * * Type guard to check if a value is an array.
  * @param value - The value to check.
  * @returns `true` if the value is an array, otherwise `false`.
  */
@@ -8,7 +8,15 @@ export function isArray(value) {
     return Array.isArray(value);
 }
 /**
- * Type guard to check if a value is an object (excluding null).
+ * * Type guard to check if a value is an array with length.
+ * @param value - The value to check.
+ * @returns `true` if the value is an array with length, otherwise `false`.
+ */
+export function isValidArray(value) {
+    return Array.isArray(value) && value.length > 0;
+}
+/**
+ * * Type guard to check if a value is an object (excluding null).
  * @param value - The value to check.
  * @returns `true` if the value is an object, otherwise `false`.
  */
@@ -16,7 +24,15 @@ export function isObject(value) {
     return value !== null && typeof value === 'object' && !isArray(value);
 }
 /**
- * Type guard to check if a value is a function.
+ * * Type guard to check if a value is an object (excluding null) and has keys in it.
+ * @param value - The value to check.
+ * @returns `true` if the value is an object with valid keys, otherwise `false`.
+ */
+export function isNotEmptyObject(value) {
+    return isObject(value) && Object.keys(value).length > 0;
+}
+/**
+ * * Type guard to check if a value is a function.
  * @param value - The value to check.
  * @returns `true` if the value is a function, otherwise `false`.
  */
@@ -24,7 +40,7 @@ export function isFunction(value) {
     return typeof value === 'function';
 }
 /**
- * Type guard to check if a value is a Date object.
+ * * Type guard to check if a value is a Date object.
  * @param value - The value to check.
  * @returns `true` if the value is a Date object, otherwise `false`.
  */
@@ -32,7 +48,7 @@ export function isDate(value) {
     return value instanceof Date;
 }
 /**
- * Type guard to check if a value is an object with specific keys.
+ * * Type guard to check if a value is an object with specific keys.
  * @param value - The value to check.
  * @param keys - The set of keys the object should contain.
  * @returns `true` if the value is an object with the specified keys, otherwise `false`.

package/dist/guards/primitives.js

@@ -77,7 +77,7 @@ export function isPrimitive(value) {
  * @returns `true` if the value is a non-empty string, otherwise `false`.
  */
 export function isNonEmptyString(value) {
-    return isString(value) && value?.trim().length > 0;
+    return isString(value) && value?.length > 0;
 }
 /**
  * * Type guard to check if a value is falsy.

package/dist/index.d.ts

@@ -14,15 +14,14 @@ export { Color, Color as Colour } from './colors/Color';
 export { filterArrayOfObjects, flattenArray, getLastArrayElement, isInvalidOrEmptyArray, isInvalidOrEmptyArray as isValidEmptyArray, shuffleArray, } from './array/basics';
 export { sortAnArray } from './array/sort';
 export { createOptionsArray, removeDuplicatesFromArray, } from './array/transform';
-export { convertIntoFormData, isEmptyFormData } from './form/convert';
-export { createControlledFormData } from './form/transform';
-export { isCustomFile, isCustomFileArray, isFileUpload, isOriginFileObj, } from './form/guards';
-export { cloneObject, countObjectFields, generateQueryParams, isEmptyObject, isObject, } from './object/basics';
+export { createControlledFormData as convertIntoFormData, createControlledFormData, } from './form/convert';
+export { isCustomFile, isCustomFileArray, isFileUpload, isOriginFileObj, isValidFormData, } from './form/guards';
+export { cloneObject, countObjectFields, generateQueryParams, } from './object/basics';
 export { extractNewFields, extractUpdatedAndNewFields, extractUpdatedFields, flattenObjectDotNotation, flattenObjectKeyValue, mergeAndFlattenObjects, mergeObjects, } from './object/objectify';
 export { sanitizeData } from './object/sanitize';
 export { convertObjectValues } from './object/convert';
 export { convertArrayToString, debounceAction, isDeepEqual, throttleAction, } from './utils';
 export { isBoolean, isFalsy, isInteger, isNonEmptyString, isNull, isNumber, isPositiveInteger, isPrimitive, isString, isSymbol, isTruthy, isUndefined, } from './guards/primitives';
-export { isReturningPromise as doesReturnPromise, isArray, isArrayOfType, isBigInt, isDate, isEmptyObject as isEmptyObjectGuard, isError, isFunction, isJSON, isJSON as isJSONObject, isMap, isEmptyObject as isObjectEmpty, isObjectWithKeys, isPromise, isRegExp, isRegExp as isRegularExpression, isReturningPromise, isSet, isJSON as isValidJSON, isMap as isValidMap, isObject as isValidObject, isSet as isValidSet, } from './guards/non-primitives';
+export { isReturningPromise as doesReturnPromise, isArray, isArrayOfType, isValidArray as isArrayWithLength, isBigInt, isDate, isEmptyObject, isEmptyObject as isEmptyObjectGuard, isError, isFunction, isJSON, isJSON as isJSONObject, isMap, isNotEmptyObject, isObject, isEmptyObject as isObjectEmpty, isObjectWithKeys, isPromise, isRegExp, isRegExp as isRegularExpression, isReturningPromise, isSet, isValidArray, isJSON as isValidJSON, isMap as isValidMap, isNotEmptyObject as isValidObject, isSet as isValidSet, } from './guards/non-primitives';
 export { isBase64, isBrowser, isDateString, isEmail, isEmailArray, isEnvironment, isEnvironment as isExpectedNodeENV, isIPAddress, isNode, isEnvironment as isNodeENV, isEnvironment as isNodeEnvironment, isNumericString, isPhoneNumber, isURL, isUUID, isEmail as isValidEmail, isURL as isValidURL, } from './guards/specials';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -19,11 +19,10 @@ export { filterArrayOfObjects, flattenArray, getLastArrayElement, isInvalidOrEmp
 export { sortAnArray } from './array/sort';
 export { createOptionsArray, removeDuplicatesFromArray, } from './array/transform';
 // ! Form Utilities
-export { convertIntoFormData, isEmptyFormData } from './form/convert';
-export { createControlledFormData } from './form/transform';
-export { isCustomFile, isCustomFileArray, isFileUpload, isOriginFileObj, } from './form/guards';
+export { createControlledFormData as convertIntoFormData, createControlledFormData, } from './form/convert';
+export { isCustomFile, isCustomFileArray, isFileUpload, isOriginFileObj, isValidFormData, } from './form/guards';
 // ! Object Utilities
-export { cloneObject, countObjectFields, generateQueryParams, isEmptyObject, isObject, } from './object/basics';
+export { cloneObject, countObjectFields, generateQueryParams, } from './object/basics';
 export { extractNewFields, extractUpdatedAndNewFields, extractUpdatedFields, flattenObjectDotNotation, flattenObjectKeyValue, mergeAndFlattenObjects, mergeObjects, } from './object/objectify';
 export { sanitizeData } from './object/sanitize';
 export { convertObjectValues } from './object/convert';
@@ -32,6 +31,6 @@ export { convertArrayToString, debounceAction, isDeepEqual, throttleAction, } fr
 // ! Primitive Type Guards
 export { isBoolean, isFalsy, isInteger, isNonEmptyString, isNull, isNumber, isPositiveInteger, isPrimitive, isString, isSymbol, isTruthy, isUndefined, } from './guards/primitives';
 // ! Non-Primitive Type Guards
-export { isReturningPromise as doesReturnPromise, isArray, isArrayOfType, isBigInt, isDate, isEmptyObject as isEmptyObjectGuard, isError, isFunction, isJSON, isJSON as isJSONObject, isMap, isEmptyObject as isObjectEmpty, isObjectWithKeys, isPromise, isRegExp, isRegExp as isRegularExpression, isReturningPromise, isSet, isJSON as isValidJSON, isMap as isValidMap, isObject as isValidObject, isSet as isValidSet, } from './guards/non-primitives';
+export { isReturningPromise as doesReturnPromise, isArray, isArrayOfType, isValidArray as isArrayWithLength, isBigInt, isDate, isEmptyObject, isEmptyObject as isEmptyObjectGuard, isError, isFunction, isJSON, isJSON as isJSONObject, isMap, isNotEmptyObject, isObject, isEmptyObject as isObjectEmpty, isObjectWithKeys, isPromise, isRegExp, isRegExp as isRegularExpression, isReturningPromise, isSet, isValidArray, isJSON as isValidJSON, isMap as isValidMap, isNotEmptyObject as isValidObject, isSet as isValidSet, } from './guards/non-primitives';
 // ! Special Type Guards
 export { isBase64, isBrowser, isDateString, isEmail, isEmailArray, isEnvironment, isEnvironment as isExpectedNodeENV, isIPAddress, isNode, isEnvironment as isNodeENV, isEnvironment as isNodeEnvironment, isNumericString, isPhoneNumber, isURL, isUUID, isEmail as isValidEmail, isURL as isValidURL, } from './guards/specials';

package/dist/object/basics.d.ts

@@ -21,13 +21,6 @@ export declare const generateQueryParams: <T extends QueryObject>(params?: T) =>
  * @returns Deep cloned object.
  */
 export declare const cloneObject: <T extends GenericObject>(obj: T) => T;
-/**
- * * Check if an object is empty.
- *
- * @param obj Object to check.
- * @returns Whether the object is empty.
- */
-export declare const isEmptyObject: <T extends GenericObject>(obj: T) => boolean;
 /**
  * * Count the number of fields in an object.
  *
@@ -35,11 +28,4 @@ export declare const isEmptyObject: <T extends GenericObject>(obj: T) => boolean
  * @returns Number of fields in the object.
  */
 export declare const countObjectFields: <T extends GenericObject>(obj: T) => number;
-/**
- * * Check whether data is object and not array.
- *
- * @param data Data to check if its an object and not array.
- * @returns Boolean: `true` if it's an object, `false` if not.
- */
-export declare const isObject: (data: unknown) => boolean;
 //# sourceMappingURL=basics.d.ts.map

package/dist/object/basics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"basics.d.ts","sourceRoot":"","sources":["../../src/object/basics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE1D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,WAAW,WAChD,CAAC,KACP,MAkCF,CAAC;AACF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,aAAa,OAAO,CAAC,KAAG,CAE7D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,aAAa,OAAO,CAAC,KAAG,OAI/D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,aAAa,OAAO,CAAC,KAAG,MAInE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,SAAU,OAAO,KAAG,OAExC,CAAC"}
+{"version":3,"file":"basics.d.ts","sourceRoot":"","sources":["../../src/object/basics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE1D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,WAAW,WAChD,CAAC,KACP,MAkCF,CAAC;AACF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,aAAa,OAAO,CAAC,KAAG,CAE7D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,aAAa,OAAO,CAAC,KAAG,MAInE,CAAC"}

package/dist/object/basics.js

@@ -40,17 +40,6 @@ export const generateQueryParams = (params = {}) => {
 export const cloneObject = (obj) => {
     return JSON.parse(JSON.stringify(obj));
 };
-/**
- * * Check if an object is empty.
- *
- * @param obj Object to check.
- * @returns Whether the object is empty.
- */
-export const isEmptyObject = (obj) => {
-    if (obj != null)
-        return countObjectFields(obj) === 0;
-    return false;
-};
 /**
  * * Count the number of fields in an object.
  *
@@ -62,12 +51,3 @@ export const countObjectFields = (obj) => {
         return Object.keys(obj).length;
     return 0;
 };
-/**
- * * Check whether data is object and not array.
- *
- * @param data Data to check if its an object and not array.
- * @returns Boolean: `true` if it's an object, `false` if not.
- */
-export const isObject = (data) => {
-    return typeof data === 'object' && !Array.isArray(data);
-};

package/dist/object/objectify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"objectify.d.ts","sourceRoot":"","sources":["../../src/object/objectify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,UAAU,CAAC;AAGhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,aAAa,cAAc,CAAC,EAAE,KAAG,CAuCvE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,aAAa,cACjD,CAAC,EAAE,KACb,aAyBF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,aAAa,UACpD,CAAC,KACP,CAmBF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GAAI,CAAC,SAAS,aAAa,UACvD,CAAC,KACP,aAkCF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,aAAa,cAC/C,CAAC,iBACE,cAAc,CAAC,CAAC,CAAC,KAC9B,cAAc,CAAC,CAAC,CAwBlB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC5B,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,aAAa,cAEX,CAAC,iBACE,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,KAClD,cAAc,CAAC,CAAC,CAsBlB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,GACtC,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,aAAa,cAEX,CAAC,iBACE,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,KAClD,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAwBtC,CAAC"}
+{"version":3,"file":"objectify.d.ts","sourceRoot":"","sources":["../../src/object/objectify.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,UAAU,CAAC;AAEhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,aAAa,cAAc,CAAC,EAAE,KAAG,CAuCvE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,aAAa,cACjD,CAAC,EAAE,KACb,aAyBF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,aAAa,UACpD,CAAC,KACP,CAmBF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GAAI,CAAC,SAAS,aAAa,UACvD,CAAC,KACP,aAkCF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,aAAa,cAC/C,CAAC,iBACE,cAAc,CAAC,CAAC,CAAC,KAC9B,cAAc,CAAC,CAAC,CAwBlB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC5B,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,aAAa,cAEX,CAAC,iBACE,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,KAClD,cAAc,CAAC,CAAC,CAyBlB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,GACtC,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,aAAa,cAEX,CAAC,iBACE,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,KAClD,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAwBtC,CAAC"}

package/dist/object/objectify.js

@@ -1,5 +1,5 @@
+import { isEmptyObject, isNotEmptyObject } from '../guards/non-primitives';
 import { isDeepEqual } from '../utils';
-import { isEmptyObject, isObject } from './basics';
 /**
  * * Deeply merge two or more objects using `Map`.
  *
@@ -136,7 +136,7 @@ export const extractUpdatedFields = (baseObject, updatedObject) => {
     for (const key in updatedObject) {
         if (key in baseObject &&
             !isDeepEqual(updatedObject[key], baseObject[key])) {
-            if (updatedObject[key] && isObject(updatedObject[key])) {
+            if (updatedObject[key] && isNotEmptyObject(updatedObject[key])) {
                 updatedFields[key] = extractUpdatedFields(baseObject[key], updatedObject[key]);
                 if (updatedFields[key] && isEmptyObject(updatedFields[key])) {
                     delete updatedFields[key];
@@ -163,10 +163,11 @@ export const extractNewFields = (baseObject, updatedObject) => {
             // Directly assign new fields
             newFields[key] = updatedObject[key];
         }
-        else if (isObject(updatedObject[key]) && isObject(baseObject[key])) {
+        else if (isNotEmptyObject(updatedObject[key]) &&
+            isNotEmptyObject(baseObject[key])) {
             // Recursively extract new fields inside nested objects
             const nestedNewFields = extractNewFields(baseObject[key], updatedObject[key]);
-            if (!isEmptyObject(nestedNewFields)) {
+            if (isNotEmptyObject(nestedNewFields)) {
                 newFields[key] =
                     nestedNewFields;
             }
@@ -189,7 +190,7 @@ export const extractUpdatedAndNewFields = (baseObject, updatedObject) => {
             newFields[key] = updatedObject[key];
         }
         else if (!isDeepEqual(updatedObject[key], baseObject[key])) {
-            if (updatedObject[key] && isObject(updatedObject[key])) {
+            if (updatedObject[key] && isNotEmptyObject(updatedObject[key])) {
                 updatedFields[key] = extractUpdatedAndNewFields(baseObject[key], updatedObject[key]);
                 if (updatedFields[key] && isEmptyObject(updatedFields[key])) {
                     delete updatedFields[key];

package/dist/object/sanitize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/object/sanitize.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,OAAO,KAAK,EAAkB,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE9E;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,aAAa,EACnD,MAAM,EAAE,CAAC,EACT,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAC1B,cAAc,CAAC,CAAC,CAAC,CAAC;AAErB;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,aAAa,EACnD,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAC1B,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;AAEvB;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC"}
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/object/sanitize.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAkB,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE9E;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,aAAa,EACnD,MAAM,EAAE,CAAC,EACT,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAC1B,cAAc,CAAC,CAAC,CAAC,CAAC;AAErB;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,aAAa,EACnD,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAC1B,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;AAEvB;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC"}

package/dist/object/sanitize.js

@@ -1,5 +1,5 @@
+import { isNotEmptyObject } from '../guards/non-primitives';
 import { trimString } from '../string/basics';
-import { isEmptyObject } from './basics';
 /**
  * * Sanitizes a string, array of strings, an object or array of objects by ignoring specified keys and trimming string values.
  * * Also excludes nullish values (null, undefined) if specified. Always ignores empty nested object(s).
@@ -39,7 +39,7 @@ export function sanitizeData(input, options) {
             // Recursively process nested objects
             const processedValue = _processObject(value, fullKeyPath);
             // Only add the property if it's not an empty object
-            if (!isEmptyObject(processedValue)) {
+            if (isNotEmptyObject(processedValue)) {
                 acc[key] = processedValue;
             }
         }
@@ -62,7 +62,7 @@ export function sanitizeData(input, options) {
         // Process array of objects
         return input
             .map((obj) => _processObject(obj))
-            .filter((obj) => !isEmptyObject(obj));
+            .filter((obj) => isNotEmptyObject(obj));
     }
     // Process object
     if (typeof input === 'object' && input !== null) {

package/dist/object/types.d.ts

@@ -1,6 +1,6 @@
-import type { Primitive } from '../types';
+import type { AdvancedTypes, Primitive } from '../types';
 /** - Generic object with `unknown` value */
-export type GenericObjectStrict = Record<string, unknown>;
+export type StrictObject = Record<string, unknown>;
 /** - Generic object but with `any` value */
 export type GenericObject = Record<string, any>;
 /**
@@ -18,24 +18,28 @@ export type QueryObject = {
 /** - Object type with string or number or boolean as value for each key. */
 export type GenericObjectPrimitive = Record<string, string | number | boolean>;
 /** - Dot-notation keys for nested objects */
-export type DotNotationKeyStrict<T> = T extends unknown[] ? never : T extends GenericObjectStrict ? {
-    [K in keyof T & string]: T[K] extends GenericObjectStrict ? `${K}` | `${K}.${DotNotationKeyStrict<T[K]>}` : `${K}`;
+export type DotNotationKeyStrict<T> = T extends AdvancedTypes ? never : T extends StrictObject ? {
+    [K in keyof T & string]: NonNullable<T[K]> extends StrictObject ? `${K}` | `${K}.${DotNotationKey<NonNullable<T[K]>>}` : `${K}`;
 }[keyof T & string] : never;
 /** - Dot-notation keys for nested objects (including optional properties) */
-export type DotNotationKey<T> = T extends unknown[] ? never : T extends GenericObject ? {
+export type DotNotationKey<T> = T extends AdvancedTypes ? never : T extends GenericObject ? {
     [K in keyof T & string]: NonNullable<T[K]> extends GenericObject ? `${K}` | `${K}.${DotNotationKey<NonNullable<T[K]>>}` : `${K}`;
 }[keyof T & string] : never;
 /** - Dot-notation keys where the value is an array (including optional properties) */
 export type KeyForArray<T> = T extends GenericObject ? {
-    [K in keyof T & string]: NonNullable<T[K]> extends unknown[] ? K : never;
+    [K in keyof T & string]: NonNullable<T[K]> extends Array<unknown> ? K : never;
 }[keyof T & string] : never;
 /** - Dot-notation keys where the value is a non-array object (including optional properties) */
 export type KeyForObject<T> = T extends GenericObject ? {
-    [K in keyof T & string]: NonNullable<T[K]> extends GenericObject ? NonNullable<T[K]> extends unknown[] ? never : K : never;
+    [K in keyof T & string]: NonNullable<T[K]> extends GenericObject ? NonNullable<T[K]> extends Array<unknown> ? never : K : never;
+}[keyof T & string] : never;
+/** - Extract only keys with string values from an object, including nested dot-notation keys. */
+export type NestedKeyString<T> = T extends GenericObject ? {
+    [K in keyof T & string]: NonNullable<T[K]> extends string ? K : NonNullable<T[K]> extends GenericObject ? `${K}.${NestedKeyString<NonNullable<T[K]>>}` : never;
 }[keyof T & string] : never;
 /** - Extract only primitive keys from an object, including nested dot-notation keys. */
 export type NestedPrimitiveKey<T> = T extends GenericObject ? {
-    [K in keyof T & string]: T[K] extends Primitive ? K : T[K] extends GenericObject ? `${K}.${NestedPrimitiveKey<T[K]>}` : never;
+    [K in keyof T & string]: NonNullable<T[K]> extends Primitive ? K : NonNullable<T[K]> extends GenericObject ? `${K}.${NestedPrimitiveKey<NonNullable<T[K]>>}` : never;
 }[keyof T & string] : never;
 /** - Options for `sanitizeData` */
 export interface SanitizeOptions<T extends GenericObject> {
@@ -56,8 +60,8 @@ export type SanitizedData<T> = {
  * - Dot-notation keys for nested objects.
  * ! Unused
  */
-export type KeyConversion<T> = T extends GenericObjectStrict ? {
-    [K in keyof T & string]: K extends string ? T[K] extends GenericObjectStrict ? `${K}` | `${K}.${KeyConversion<T[K]>}` : `${K}` : never;
+export type KeyConversion<T> = T extends StrictObject ? {
+    [K in keyof T & string]: K extends string ? T[K] extends StrictObject ? `${K}` | `${K}.${KeyConversion<T[K]>}` : `${K}` : never;
 }[keyof T & string] : never;
 /**
  * ! Unused

package/dist/object/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/object/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/object/types.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -33,5 +33,7 @@ export type DelayedFn<T extends VoidFunction> = (...args: Parameters<T>) => void
 export type ThrottledFn<T extends VoidFunction> = (...args: Parameters<T>) => void;
 /** Asynchronous function type */
 export type AsyncFunction<T> = (...args: unknown[]) => Promise<T>;
+/** Advanced non-primitive types */
+export type AdvancedTypes = Array<unknown> | File | FileList | Blob | ArrayBuffer | Date | RegExp | WeakMap<any, any> | WeakSet<any> | Map<any, any> | Set<any> | GenericFn | VoidFunction | AsyncFunction<any> | Promise<any> | Error | EvalError | RangeError | ReferenceError | SyntaxError | TypeError | URIError | Intl.Collator | Intl.DateTimeFormat | Intl.ListFormat | Intl.Locale | Intl.NumberFormat | Intl.PluralRules | Intl.RelativeTimeFormat | Intl.Segmenter | bigint | symbol;
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,MAAM,MAAM,eAAe,GAAG,GAAG,CAAC;AAElC,OAAO,CAAC,MAAM,OAAO,EAAE,OAAO,MAAM,CAAC;AACrC,KAAK,KAAK,CAAC,CAAC,IAAI;IAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC;AAEjC,6BAA6B;AAC7B,MAAM,MAAM,OAAO,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;AAEzC,2CAA2C;AAC3C,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,OAAO,CAAC;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC,CAAC;AAElE,2CAA2C;AAG3C,+BAA+B;AAC/B,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAErE,8CAA8C;AAC9C,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;KAC5B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,SAAS,GAAG,CAAC,GAAG,KAAK;CAClD,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX,0EAA0E;AAC1E,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI;KACtC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,CAAC,GAAG,KAAK;CAClE,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX,4BAA4B;AAC5B,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;AAE/D,4BAA4B;AAC5B,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;AAExD,gDAAgD;AAChD,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;AAEpD,kDAAkD;AAClD,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,YAAY,IAAI,CAC/C,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAClB,IAAI,CAAC;AAEV,mDAAmD;AACnD,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,YAAY,IAAI,CACjD,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAClB,IAAI,CAAC;AAEV,iCAAiC;AACjC,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "2.8.9",
+  "version": "2.9.2",
   "description": "A versatile collection of smart, efficient, and reusable utility functions for everyday development needs.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/dist/form/transform.d.ts

@@ -1,12 +0,0 @@
-import type { GenericObject } from '../object/types';
-import type { FormDataConfigs } from './types';
-/**
- * * Utility to convert object into FormData in a controlled way.
- *
- * @param data - The source object to control and convert to FormData.
- * @param configs - Configuration options to control the formData.
- *
- * @returns FormData instance containing the sanitized and transformed data
- */
-export declare const createControlledFormData: <T extends GenericObject>(data: T, configs?: FormDataConfigs<T>) => FormData;
-//# sourceMappingURL=transform.d.ts.map

package/dist/form/transform.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/form/transform.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEX,aAAa,EAEb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;;;GAOG;AAGH,eAAO,MAAM,wBAAwB,GAAI,CAAC,SAAS,aAAa,QACzD,CAAC,YACG,eAAe,CAAC,CAAC,CAAC,KAC1B,QAsMF,CAAC"}

package/dist/form/transform.js

@@ -1,175 +0,0 @@
-import { isInvalidOrEmptyArray } from '../array/basics';
-import { isEmptyObject } from '../object/basics';
-import { isCustomFile, isCustomFileArray, isFileUpload } from './guards';
-/**
- * * Utility to convert object into FormData in a controlled way.
- *
- * @param data - The source object to control and convert to FormData.
- * @param configs - Configuration options to control the formData.
- *
- * @returns FormData instance containing the sanitized and transformed data
- */
-// ... (previous imports remain the same)
-export const createControlledFormData = (data, configs) => {
-    const formData = new FormData();
-    const { stringifyNested = '*' } = configs || {};
-    /** Helper to check if a key should be lowercase */
-    const shouldLowercase = (key) => {
-        return Array.isArray(configs?.lowerCaseKeys) ?
-            configs.lowerCaseKeys.some((path) => key === path || key.startsWith(`${path}.`))
-            : configs?.lowerCaseKeys === '*';
-    };
-    /** Transforms key to lowercase if needed */
-    const transformKey = (key) => {
-        return shouldLowercase(key) ? key.toLowerCase() : key;
-    };
-    /** - 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) => transformedKey === path ||
-                transformedKey.startsWith(`${path}.`))
-            : configs?.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.includes(transformedKey)
-            : configs?.dotNotateNested === '*';
-    };
-    /** - Helper function to check if a key matches a stringifyNested key. */
-    const shouldStringify = (key) => {
-        const transformedKey = transformKey(key);
-        return Array.isArray(stringifyNested) ?
-            stringifyNested.includes(transformedKey)
-            : 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.includes(transformedKey)
-            : configs?.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;
-            // Skip ignored keys (don't include them in the cleaned object)
-            if (configs?.ignoreKeys?.includes(fullKey)) {
-                return acc;
-            }
-            // Keep value if:
-            // 1. It's required OR
-            // 2. It's not null/undefined AND not empty string/object
-            const shouldKeep = isRequiredKey(fullKey) ||
-                (value != null &&
-                    (typeof value !== 'string' || value !== '') &&
-                    (typeof value !== 'object' || !isEmptyObject(value)));
-            if (shouldKeep) {
-                if (typeof value === 'object' &&
-                    value !== null &&
-                    !Array.isArray(value)) {
-                    // Recursively clean nested objects
-                    const cleaned = _cleanObject(value, fullKey);
-                    if (isRequiredKey(fullKey) || !isEmptyObject(cleaned)) {
-                        acc[transformKey(key)] = cleaned;
-                    }
-                }
-                else {
-                    acc[transformKey(key)] = value;
-                }
-            }
-            return acc;
-        }, {});
-    };
-    /** * Helper function to add values to formData */
-    const _addToFormData = (key, value) => {
-        const transformedKey = transformKey(key);
-        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));
-            }
-            else if (value.file) {
-                if (isCustomFile(value.file)) {
-                    formData.append(transformedKey, value.file.originFileObj);
-                }
-                else {
-                    formData.append(transformedKey, value.file);
-                }
-            }
-        }
-        else if (value instanceof Blob || value instanceof File) {
-            formData.append(transformedKey, value);
-        }
-        else if (Array.isArray(value) && !isInvalidOrEmptyArray(value)) {
-            if (shouldBreakArray(key)) {
-                value.forEach((item, index) => {
-                    _addToFormData(`${transformedKey}[${index}]`, item);
-                });
-            }
-            else {
-                formData.append(transformedKey, JSON.stringify(value));
-            }
-        }
-        else if (typeof value === 'object' &&
-            value !== null &&
-            !isEmptyObject(value)) {
-            if (shouldStringify(key) && !shouldDotNotate(key)) {
-                // Clean object before stringifying, preserving required keys
-                const cleanedValue = _cleanObject(value, key);
-                if (!isEmptyObject(cleanedValue) || isRequiredKey(key)) {
-                    formData.append(transformedKey, JSON.stringify(cleanedValue));
-                }
-            }
-            else {
-                Object.entries(value).forEach(([nestedKey, nestedValue]) => {
-                    _addToFormData(`${key}.${nestedKey}`, nestedValue);
-                });
-            }
-        }
-        else {
-            const isNotNullish = value != null && value !== '';
-            if (isNotNullish || isRequiredKey(key)) {
-                formData.append(transformedKey, value);
-            }
-        }
-    };
-    /** - Helper to process object */
-    const _processObject = (obj, parentKey = '') => {
-        Object.entries(obj).forEach(([key, value]) => {
-            const transformedKey = transformKey(key);
-            const fullKey = parentKey ? `${parentKey}.${transformedKey}` : transformedKey;
-            // Skip keys that are in ignoreKeys
-            if (configs?.ignoreKeys?.includes(fullKey))
-                return;
-            // Trim string values if trimStrings is enabled
-            if (configs?.trimStrings && typeof value === 'string') {
-                value = value.trim();
-            }
-            // Check if this key is preserved
-            if (shouldDotNotate(fullKey)) {
-                // If it's a preserved path, append the value directly
-                _addToFormData(fullKey, value);
-            }
-            else if (typeof value === 'object' &&
-                !Array.isArray(value) &&
-                value !== null &&
-                !shouldStringify(fullKey)) {
-                // Process nested objects
-                _processObject(value, key);
-            }
-            else {
-                // For other cases, just append as key-value
-                _addToFormData(key, value);
-            }
-        });
-    };
-    _processObject(data);
-    return formData;
-};