nhb-toolbox 2.8.8 → 2.9.0

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":"AAEA,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,QA2NF,CAAC"}

package/dist/form/convert.js

@@ -1,31 +1,189 @@
 import { isInvalidOrEmptyArray } from '../array/basics';
+import { isEmptyObject } from '../object/basics';
+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;
+            }
+            // * 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 {
+                    if (typeof value === 'string') {
+                        acc[transformKey(key)] = value.toLowerCase();
+                    }
+                    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);
+                }
+            }
         }
-    });
+        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)) {
+                if (typeof value === 'string' && shouldLowercaseValue(key)) {
+                    formData.append(transformedKey, value.toLowerCase());
+                }
+                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
+            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;
 };
-/**
- * * 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;
-    }
-    throw new Error('`FormData.entries()` is not supported in this environment!');
-};

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, DotNotationKeyForArray, DotNotationKeyForObject } from '../object/types';
+import type { DotNotationKey, KeyForArray, KeyForObject, NestedKeyString } from '../object/types';
 /** - Configuration options to control FormData generation behavior. */
 export interface FormDataConfigs<T> {
     /**
@@ -17,25 +17,29 @@ export interface FormDataConfigs<T> {
      */
     lowerCaseKeys?: '*' | DotNotationKey<T>[];
     /**
-     * * An array of dot-notation paths to preserve in their original structure.
-     * - Example: `'user.settings'` ensures `user` remains an object, and `settings` is not flattened.
-     * - Use `*` to preserve all keys in their dot-notation format.
+     * * 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.
      * - If a key exists in both `dotNotateNested` and `stringifyNested`, `dotNotateNested` takes precedence.
      */
-    dotNotateNested?: '*' | DotNotationKeyForObject<T>[];
+    dotNotateNested?: '*' | KeyForObject<T>[];
     /**
-     * * Specifies which nested objects should be stringified instead of being flattened or dot-notated.
-     * - Defaults to `*`, meaning all nested objects will be stringified. Which is standard in modern form submissions.
+     * * Specifies which keys (values must be objects) should be stringified instead of being dot-notated.
+     * - Defaults to `*`, meaning all keys with object values will be stringified. Which is standard in modern form submissions.
      * - Use `*` to stringify all nested objects.
      * - If a key exists in both `dotNotateNested` and `stringifyNested`, `dotNotateNested` takes precedence.
      */
-    stringifyNested?: '*' | DotNotationKeyForObject<T>[];
+    stringifyNested?: '*' | KeyForObject<T>[];
     /**
      * * Controls how arrays should be serialized in FormData.
      * - If a key is included, the array will be broken into individual key-value pairs (`key[0]: value, key[1]: value`).
      * - Use `*` to apply this behavior to all array keys.
      */
-    breakArray?: '*' | DotNotationKeyForArray<T>[];
+    breakArray?: '*' | KeyForArray<T>[];
     /** - Enables automatic trimming of string values before appending them to FormData. */
     trimStrings?: boolean;
 }

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,sBAAsB,EACtB,uBAAuB,EACvB,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;;;;;OAKG;IACH,eAAe,CAAC,EAAE,GAAG,GAAG,uBAAuB,CAAC,CAAC,CAAC,EAAE,CAAC;IAErD;;;;;OAKG;IACH,eAAe,CAAC,EAAE,GAAG,GAAG,uBAAuB,CAAC,CAAC,CAAC,EAAE,CAAC;IAErD;;;;OAIG;IACH,UAAU,CAAC,EAAE,GAAG,GAAG,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAC;IAE/C,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/index.d.ts

@@ -14,9 +14,8 @@ 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 { createControlledFormData as convertIntoFormData, createControlledFormData, } from './form/convert';
+export { isCustomFile, isCustomFileArray, isFileUpload, isOriginFileObj, isValidFormData, } from './form/guards';
 export { cloneObject, countObjectFields, generateQueryParams, isEmptyObject, isObject, } from './object/basics';
 export { extractNewFields, extractUpdatedAndNewFields, extractUpdatedFields, flattenObjectDotNotation, flattenObjectKeyValue, mergeAndFlattenObjects, mergeObjects, } from './object/objectify';
 export { sanitizeData } from './object/sanitize';

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,9 +19,8 @@ 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 { extractNewFields, extractUpdatedAndNewFields, extractUpdatedFields, flattenObjectDotNotation, flattenObjectKeyValue, mergeAndFlattenObjects, mergeObjects, } from './object/objectify';

package/dist/object/types.d.ts

@@ -26,12 +26,16 @@ export type DotNotationKey<T> = T extends unknown[] ? never : T extends GenericO
     [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 DotNotationKeyForArray<T> = T extends GenericObject ? {
-    [K in keyof T & string]: NonNullable<T[K]> extends unknown[] ? `${K}` | `${K}.${DotNotationKeyForArray<NonNullable<T[K]>>}` : never;
+export type KeyForArray<T> = T extends GenericObject ? {
+    [K in keyof T & string]: NonNullable<T[K]> extends unknown[] ? K : never;
 }[keyof T & string] : never;
 /** - Dot-notation keys where the value is a non-array object (including optional properties) */
-export type DotNotationKeyForObject<T> = T extends GenericObject ? {
-    [K in keyof T & string]: NonNullable<T[K]> extends GenericObject ? NonNullable<T[K]> extends (unknown[]) ? never : `${K}` | `${K}.${DotNotationKeyForObject<NonNullable<T[K]>>}` : never;
+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;
+}[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]: T[K] extends unknown[] ? never : T[K] extends string ? K : T[K] extends GenericObject ? `${K}.${NestedKeyString<T[K]>}` extends infer R ? R extends string ? R : never : never : never;
 }[keyof T & string] : never;
 /** - Extract only primitive keys from an object, including nested dot-notation keys. */
 export type NestedPrimitiveKey<T> = T extends GenericObject ? {

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":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,4CAA4C;AAC5C,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1D,4CAA4C;AAC5C,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAEhD;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,EAAE,GAAG,WAAW,CAAC;AAErE;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAAA;CAAE,CAAC;AAE9D,4EAA4E;AAC5E,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AAE/E,6CAA6C;AAC7C,MAAM,MAAM,oBAAoB,CAAC,CAAC,IACjC,CAAC,SAAS,OAAO,EAAE,GAAG,KAAK,GACzB,CAAC,SAAS,mBAAmB,GAC9B;KACE,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,mBAAmB,GACxD,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,IAAI,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAC5C,GAAG,CAAC,EAAE;CACR,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAClB,KAAK,CAAC;AAET,6EAA6E;AAC7E,MAAM,MAAM,cAAc,CAAC,CAAC,IAC3B,CAAC,SAAS,OAAO,EAAE,GAAG,KAAK,GACzB,CAAC,SAAS,aAAa,GACxB;KACE,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,aAAa,GAC/D,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,IAAI,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GACnD,GAAG,CAAC,EAAE;CACR,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAClB,KAAK,CAAC;AAET,sFAAsF;AACtF,MAAM,MAAM,WAAW,CAAC,CAAC,IACxB,CAAC,SAAS,aAAa,GACtB;KACE,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,OAAO,EAAE,GAAG,CAAC,GAC9D,KAAK;CACP,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAClB,KAAK,CAAC;AAET,gGAAgG;AAChG,MAAM,MAAM,YAAY,CAAC,CAAC,IACzB,CAAC,SAAS,aAAa,GACtB;KACE,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,aAAa,GAC/D,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,OAAO,EAAE,GAClC,KAAK,GACJ,CAAC,GACF,KAAK;CACP,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAClB,KAAK,CAAC;AAET,iGAAiG;AACjG,MAAM,MAAM,eAAe,CAAC,CAAC,IAC5B,CAAC,SAAS,aAAa,GACtB;KACE,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,OAAO,EAAE,GAAG,KAAK,GACrD,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,CAAC,GACvB,CAAC,CAAC,CAAC,CAAC,SAAS,aAAa,GAC3B,GAAG,CAAC,IAAI,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,MAAM,CAAC,GAC9C,CAAC,SAAS,MAAM,GACf,CAAC,GACA,KAAK,GACN,KAAK,GACN,KAAK;CACP,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAClB,KAAK,CAAC;AAET,wFAAwF;AACxF,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAC/B,CAAC,SAAS,aAAa,GACtB;KACE,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,SAAS,GAC9C,CAAC,GACA,CAAC,CAAC,CAAC,CAAC,SAAS,aAAa,GAC3B,GAAG,CAAC,IAAI,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GACjC,KAAK;CACP,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAClB,KAAK,CAAC;AAET,mCAAmC;AACnC,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,aAAa;IACvD,qBAAqB;IACrB,YAAY,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IACnC,wDAAwD;IACxD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iFAAiF;IACjF,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;KAC7B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACxE,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAC1B,CAAC,SAAS,mBAAmB,GAC5B;KACE,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,SAAS,MAAM,GACxC,CAAC,CAAC,CAAC,CAAC,SAAS,mBAAmB,GAC/B,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GACrC,GAAG,CAAC,EAAE,GACP,KAAK;CACP,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAClB,KAAK,CAAC;AAET;;;;;GAKG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,EAAE,CAAC,SAAS,QAAQ,GAAG,QAAQ,IACzD,CAAC,SAAS,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;AAElE,iDAAiD;AACjD,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;KAC3B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,GACzD,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAC1D,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,GACrC,CAAC,CAAC,CAAC,CAAC;CACN,CAAC;AAEF,iDAAiD;AACjD,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;KAC3B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,GACzD,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAC1D,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAC5B,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAC1B,MAAM;CACR,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "2.8.8",
+  "version": "2.9.0",
   "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,EAAkB,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,GAAI,CAAC,SAAS,aAAa,QACzD,CAAC,YACG,eAAe,CAAC,CAAC,CAAC,KAC1B,QAkIF,CAAC"}

package/dist/form/transform.js

@@ -1,122 +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
- */
-export const createControlledFormData = (data, configs) => {
-    const formData = new FormData();
-    const { stringifyNested = '*' } = configs || {};
-    /** - Helper function to check if a key matches a dotNotation path to preserve. */
-    const shouldDotNotate = (key) => {
-        return Array.isArray(configs?.dotNotateNested) ?
-            configs.dotNotateNested.some((path) => key === path || key.startsWith(`${path}.`))
-            : configs?.dotNotateNested === '*';
-    };
-    /** - Helper function to check if a key matches a stringifyNested key. */
-    const shouldStringify = (key) => {
-        return Array.isArray(stringifyNested) ?
-            stringifyNested.some((path) => key === path || key.startsWith(`${path}.`))
-            : stringifyNested === '*';
-    };
-    /** - Helper function to check if a key matches a breakArray key. */
-    const shouldBreakArray = (key) => {
-        return Array.isArray(configs?.breakArray) ?
-            configs.breakArray.some((path) => key === path || key.startsWith(`${path}.`))
-            : configs?.breakArray === '*';
-    };
-    /** * Helper function to add values to formData */
-    const _addToFormData = (key, value) => {
-        const transformedKey = (configs?.lowerCaseKeys === '*' ||
-            configs?.lowerCaseKeys?.includes(key)) ?
-            key.toLowerCase()
-            : 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)) {
-                formData.append(transformedKey, JSON.stringify(value));
-            }
-            else {
-                Object.entries(value).forEach(([nestedKey, nestedValue]) => {
-                    _addToFormData(`${key}.${nestedKey}`, nestedValue);
-                });
-            }
-        }
-        else {
-            const isRequired = configs?.requiredKeys === '*' ||
-                configs?.requiredKeys?.includes(key);
-            const isNotNullish = value != null && value !== '';
-            if (isNotNullish || isRequired) {
-                formData.append(transformedKey, value);
-            }
-        }
-    };
-    /** - Helper to process object */
-    const _processObject = (obj, parentKey = '') => {
-        Object.entries(obj).forEach(([key, value]) => {
-            const fullKey = (parentKey ?
-                `${parentKey}.${key}`
-                : key);
-            // 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 &&
-                !stringifyNested) {
-                // Process nested objects
-                _processObject(value, key);
-            }
-            else {
-                // For other cases, just append as key-value
-                _addToFormData(key, value);
-            }
-        });
-    };
-    _processObject(data);
-    return formData;
-};