nhb-toolbox 1.6.9 → 1.7.1

package/dist/array/basics.d.ts

@@ -1,4 +1,5 @@
-import type { Flattened, ConfigOptions, OptionInput, SortOptions, InputObject, OrderOption } from './types';
+import type { GenericObject } from '../object/types';
+import type { Flattened } from './types';
 /**
  * * Flattens a nested array recursively or wraps any non-array data type in an array.
  *
@@ -7,50 +8,6 @@ import type { Flattened, ConfigOptions, OptionInput, SortOptions, InputObject, O
  * @returns A fully flattened array of type `Flatten<T>`. If the input is not an array, it wraps it in a single-element array.
  */
 export declare const flattenArray: <T>(input: T | T[]) => Flattened<T>[];
-/**
- * * Converts an array of objects into a formatted array of options.
- *
- * @typeParam T - The type of each object in the `data` array.
- * @param data - An array of objects to convert into options.
- * @param config - The configuration object to specify the keys for the `value` (firstFieldName) and `label` (secondFieldName) fields and rename as needed.
- * @returns An array of options, where each option has `value` and `label` fields as default or as specified by user in the config options.
- */
-export declare const createOptionsArray: <T extends OptionInput, K1 extends string = "value", K2 extends string = "label">(data: T[], config: ConfigOptions<T, K1, K2>) => { [P in K1 | K2]: string; }[];
-/**
- * * Sorts an array of strings.
- *
- * @param array - The array of strings to sort.
- * @param options - Sorting options.
- * @returns  The sorted array.
- */
-export declare function sortAnArray(array: string[], options?: OrderOption): string[];
-/**
- * * Sorts an array of numbers.
- *
- * @param array - The array of numbers to sort.
- * @param options - Sorting options.
- * @returns The sorted array.
- */
-export declare function sortAnArray(array: number[], options?: OrderOption): number[];
-/**
- * * Sorts an array of booleans.
- *
- * @param array - The array of booleans to sort.
- * @param options - Sorting options.
- * @returns The sorted array.
- */
-export declare function sortAnArray(array: boolean[], options?: OrderOption): boolean[];
-/**
- * * Sorts an array of objects.
- *
- * - Sorts array by the specified field.
- *
- * @template T - The type of objects in the array.
- * @param array - The array of objects to sort.
- * @param options - Sorting options.
- * @returns The sorted array.
- */
-export declare function sortAnArray<T extends InputObject>(array: T[], options: SortOptions<T>): T[];
 /**
  * * Filters an array of objects based on multiple conditions for specified keys.
  *
@@ -60,5 +17,12 @@ export declare function sortAnArray<T extends InputObject>(array: T[], options:
  *                     The conditions can be a value, a range, or a function.
  * @returns The filtered array of objects.
  */
-export declare const filterArrayOfObjects: <T extends Record<string, unknown>>(array: T[], conditions: { [K in keyof T]?: (value: T[K]) => boolean; }) => T[];
+export declare const filterArrayOfObjects: <T extends GenericObject>(array: T[], conditions: { [K in keyof T]?: (value: T[K]) => boolean; }) => T[];
+/**
+ * * Check if an array is empty.
+ *
+ * @param array Array to check.
+ * @returns Whether the array is empty.
+ */
+export declare const isValidButEmptyArray: <T>(array: T[] | unknown) => boolean;
 //# sourceMappingURL=basics.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"basics.d.ts","sourceRoot":"","sources":["../../src/array/basics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,SAAS,EACT,aAAa,EACb,WAAW,EACX,WAAW,EACX,WAAW,EACX,WAAW,EACX,MAAM,SAAS,CAAC;AAEjB;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,KAAG,SAAS,CAAC,CAAC,CAAC,EAO5D,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAC9B,CAAC,SAAS,WAAW,EACrB,EAAE,SAAS,MAAM,YACjB,EAAE,SAAS,MAAM,kBAEX,CAAC,EAAE,UACD,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,KAC9B,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,GAAE,EAe5B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,EAAE,CAAC;AAE9E;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,EAAE,CAAC;AAE9E;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,EAAE,CAAC;AAEhF;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,WAAW,EAChD,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GACrB,CAAC,EAAE,CAAC;AAiFP;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,SAC9D,CAAC,EAAE,cACE,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,GAAE,KACvD,CAAC,EAgBH,CAAC"}
+{"version":3,"file":"basics.d.ts","sourceRoot":"","sources":["../../src/array/basics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,KAAG,SAAS,CAAC,CAAC,CAAC,EAO5D,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,aAAa,SACpD,CAAC,EAAE,cACE,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,GAAE,KACvD,CAAC,EAgBH,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,CAAC,EAAE,GAAG,OAAO,KAAG,OAE9D,CAAC"}

package/dist/array/basics.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.filterArrayOfObjects = exports.createOptionsArray = exports.flattenArray = void 0;
-exports.sortAnArray = sortAnArray;
+exports.isValidButEmptyArray = exports.filterArrayOfObjects = exports.flattenArray = void 0;
 /**
  * * Flattens a nested array recursively or wraps any non-array data type in an array.
  *
@@ -18,86 +17,6 @@ const flattenArray = (input) => {
     }, []);
 };
 exports.flattenArray = flattenArray;
-/**
- * * Converts an array of objects into a formatted array of options.
- *
- * @typeParam T - The type of each object in the `data` array.
- * @param data - An array of objects to convert into options.
- * @param config - The configuration object to specify the keys for the `value` (firstFieldName) and `label` (secondFieldName) fields and rename as needed.
- * @returns An array of options, where each option has `value` and `label` fields as default or as specified by user in the config options.
- */
-const createOptionsArray = (data, config) => {
-    const { firstFieldKey, secondFieldKey, firstFieldName = 'value', secondFieldName = 'label', } = config || {};
-    if (data && data.length) {
-        return data.map((datum) => ({
-            [firstFieldName]: String(datum[firstFieldKey] ?? ''),
-            [secondFieldName]: String(datum[secondFieldKey] ?? ''),
-        }));
-    }
-    else {
-        return [];
-    }
-};
-exports.createOptionsArray = createOptionsArray;
-/**
- * * Sorts an array of strings, numbers, booleans, or objects based on the provided options.
- *
- * - If the array contains strings, it sorts them alphabetically.
- * - If the array contains numbers, it sorts them numerically.
- * - If the array contains booleans, it sorts them by their boolean value.
- * - If the array contains objects, it sorts them by the specified field.
- * @template T - The type of objects in the array.
- * @param array - The array to sort.
- * @param options - Sorting options for objects.
- * @returns The sorted array.
- */
-function sortAnArray(array, options) {
-    if (!Array.isArray(array) || array.length === 0)
-        return array;
-    // Check if the array contains strings
-    if (typeof array[0] === 'string') {
-        return [...array].sort((a, b) => options?.sortOrder === 'desc' ?
-            b.localeCompare(a)
-            : a.localeCompare(b));
-    }
-    // Check if the array contains numbers
-    if (typeof array[0] === 'number') {
-        return [...array].sort((a, b) => options?.sortOrder === 'desc' ?
-            b - a
-            : a - b);
-    }
-    // Check if the array contains booleans
-    if (typeof array[0] === 'boolean') {
-        return [...array].sort((a, b) => options?.sortOrder === 'desc' ?
-            Number(b) - Number(a)
-            : Number(a) - Number(b));
-    }
-    // Handle object arrays
-    if (options?.sortByField) {
-        return [...array].sort((a, b) => {
-            const key = options.sortByField;
-            const keyA = a[key];
-            const keyB = b[key];
-            if (typeof keyA === 'string' && typeof keyB === 'string') {
-                return options?.sortOrder === 'desc' ?
-                    keyB.localeCompare(keyA)
-                    : keyA.localeCompare(keyB);
-            }
-            if (typeof keyA === 'number' && typeof keyB === 'number') {
-                return options?.sortOrder === 'desc' ?
-                    keyB - keyA
-                    : keyA - keyB;
-            }
-            if (typeof keyA === 'boolean' && typeof keyB === 'boolean') {
-                return options?.sortOrder === 'desc' ?
-                    Number(keyB) - Number(keyA)
-                    : Number(keyA) - Number(keyB);
-            }
-            throw new Error('Cannot compare non-string/non-number/non-boolean properties.');
-        });
-    }
-    throw new Error('Invalid array or missing "sortByField" for objects.');
-}
 /**
  * * Filters an array of objects based on multiple conditions for specified keys.
  *
@@ -122,3 +41,13 @@ const filterArrayOfObjects = (array, conditions) => {
     }));
 };
 exports.filterArrayOfObjects = filterArrayOfObjects;
+/**
+ * * Check if an array is empty.
+ *
+ * @param array Array to check.
+ * @returns Whether the array is empty.
+ */
+const isValidButEmptyArray = (array) => {
+    return Array.isArray(array) && array.length === 0;
+};
+exports.isValidButEmptyArray = isValidButEmptyArray;

package/dist/array/sort.d.ts

@@ -0,0 +1,37 @@
+import type { InputObject, OrderOption, SortOptions } from "./types";
+/**
+ * * Sorts an array of strings.
+ *
+ * @param array - The array of strings to sort.
+ * @param options - Sorting options.
+ * @returns  The sorted array.
+ */
+export declare function sortAnArray(array: string[], options?: OrderOption): string[];
+/**
+ * * Sorts an array of numbers.
+ *
+ * @param array - The array of numbers to sort.
+ * @param options - Sorting options.
+ * @returns The sorted array.
+ */
+export declare function sortAnArray(array: number[], options?: OrderOption): number[];
+/**
+ * * Sorts an array of booleans.
+ *
+ * @param array - The array of booleans to sort.
+ * @param options - Sorting options.
+ * @returns The sorted array.
+ */
+export declare function sortAnArray(array: boolean[], options?: OrderOption): boolean[];
+/**
+ * * Sorts an array of objects.
+ *
+ * - Sorts array by the specified field.
+ *
+ * @template T - The type of objects in the array.
+ * @param array - The array of objects to sort.
+ * @param options - Sorting options.
+ * @returns The sorted array.
+ */
+export declare function sortAnArray<T extends InputObject>(array: T[], options: SortOptions<T>): T[];
+//# sourceMappingURL=sort.d.ts.map

package/dist/array/sort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort.d.ts","sourceRoot":"","sources":["../../src/array/sort.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAErE;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,EAAE,CAAC;AAE9E;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,EAAE,CAAC;AAE9E;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,EAAE,CAAC;AAEhF;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,WAAW,EAChD,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GACrB,CAAC,EAAE,CAAC"}

package/dist/array/sort.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sortAnArray = sortAnArray;
+/**
+ * * Sorts an array of strings, numbers, booleans, or objects based on the provided options.
+ *
+ * - If the array contains strings, it sorts them alphabetically.
+ * - If the array contains numbers, it sorts them numerically.
+ * - If the array contains booleans, it sorts them by their boolean value.
+ * - If the array contains objects, it sorts them by the specified field.
+ * @template T - The type of objects in the array.
+ * @param array - The array to sort.
+ * @param options - Sorting options for objects.
+ * @returns The sorted array.
+ */
+function sortAnArray(array, options) {
+    if (!Array.isArray(array) || array.length === 0)
+        return array;
+    // Check if the array contains strings
+    if (typeof array[0] === 'string') {
+        return [...array].sort((a, b) => options?.sortOrder === 'desc' ?
+            b.localeCompare(a)
+            : a.localeCompare(b));
+    }
+    // Check if the array contains numbers
+    if (typeof array[0] === 'number') {
+        return [...array].sort((a, b) => options?.sortOrder === 'desc' ?
+            b - a
+            : a - b);
+    }
+    // Check if the array contains booleans
+    if (typeof array[0] === 'boolean') {
+        return [...array].sort((a, b) => options?.sortOrder === 'desc' ?
+            Number(b) - Number(a)
+            : Number(a) - Number(b));
+    }
+    // Handle object arrays
+    if (options?.sortByField) {
+        return [...array].sort((a, b) => {
+            const key = options.sortByField;
+            const keyA = a[key];
+            const keyB = b[key];
+            if (typeof keyA === 'string' && typeof keyB === 'string') {
+                return options?.sortOrder === 'desc' ?
+                    keyB.localeCompare(keyA)
+                    : keyA.localeCompare(keyB);
+            }
+            if (typeof keyA === 'number' && typeof keyB === 'number') {
+                return options?.sortOrder === 'desc' ?
+                    keyB - keyA
+                    : keyA - keyB;
+            }
+            if (typeof keyA === 'boolean' && typeof keyB === 'boolean') {
+                return options?.sortOrder === 'desc' ?
+                    Number(keyB) - Number(keyA)
+                    : Number(keyA) - Number(keyB);
+            }
+            throw new Error('Cannot compare non-string/non-number/non-boolean properties.');
+        });
+    }
+    throw new Error('Invalid array or missing "sortByField" for objects.');
+}

package/dist/array/transform.d.ts

@@ -0,0 +1,11 @@
+import type { OptionInput, OptionsConfig } from './types';
+/**
+ * * Converts an array of objects into a formatted array of options.
+ *
+ * @typeParam T - The type of each object in the `data` array.
+ * @param data - An array of objects to convert into options.
+ * @param config - The configuration object to specify the keys for the `value` (firstFieldName) and `label` (secondFieldName) fields and rename as needed.
+ * @returns An array of options, where each option has `value` and `label` fields as default or as specified by user in the config options.
+ */
+export declare const createOptionsArray: <T extends OptionInput, K1 extends string = "value", K2 extends string = "label">(data: T[], config: OptionsConfig<T, K1, K2>) => { [P in K1 | K2]: string; }[];
+//# sourceMappingURL=transform.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/array/transform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE1D;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAC9B,CAAC,SAAS,WAAW,EACrB,EAAE,SAAS,MAAM,YACjB,EAAE,SAAS,MAAM,kBAEX,CAAC,EAAE,UACD,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,KAC9B,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,GAAE,EAe5B,CAAC"}

package/dist/array/transform.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOptionsArray = void 0;
+/**
+ * * Converts an array of objects into a formatted array of options.
+ *
+ * @typeParam T - The type of each object in the `data` array.
+ * @param data - An array of objects to convert into options.
+ * @param config - The configuration object to specify the keys for the `value` (firstFieldName) and `label` (secondFieldName) fields and rename as needed.
+ * @returns An array of options, where each option has `value` and `label` fields as default or as specified by user in the config options.
+ */
+const createOptionsArray = (data, config) => {
+    const { firstFieldKey, secondFieldKey, firstFieldName = 'value', secondFieldName = 'label', } = config || {};
+    if (data && data.length) {
+        return data.map((datum) => ({
+            [firstFieldName]: String(datum[firstFieldKey] ?? ''),
+            [secondFieldName]: String(datum[secondFieldKey] ?? ''),
+        }));
+    }
+    else {
+        return [];
+    }
+};
+exports.createOptionsArray = createOptionsArray;

package/dist/array/types.d.ts

@@ -14,7 +14,7 @@ export type OptionInput = Record<string, string | number | null | undefined>;
  * @typeParam K1 - The name of the key for the first field in the output (default: `'value'`).
  * @typeParam K2 - The name of the key for the second field in the output (default: `'label'`).
  */
-export interface ConfigOptions<T extends Record<string, string | number | null | undefined>, K1 extends string = 'value', K2 extends string = 'label'> {
+export interface OptionsConfig<T extends Record<string, string | number | null | undefined>, K1 extends string = 'value', K2 extends string = 'label'> {
     /**
      * - The key in the input objects to use for the first field of the option.
      * @example If the input objects have an `id` field and you want to use it as the `value` field in the output, set createOptionsArray(data, {firstFieldKey: 'id'}).

package/dist/form/convert.d.ts

@@ -0,0 +1,15 @@
+/**
+ * * Utility to convert object into FormData.
+ *
+ * @param data Data to convert into FormData.
+ * @returns Converted FormData.
+ */
+export declare const convertIntoFormData: <T extends object>(data: T) => FormData;
+/**
+ * * Check if a formdata object is empty.
+ *
+ * @param obj FormData to check.
+ * @returns Whether the formdata is empty.
+ */
+export declare const isEmptyFormData: (data: FormData) => boolean;
+//# sourceMappingURL=convert.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../src/form/convert.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,MAAM,QAAQ,CAAC,KAAG,QAY/D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,SAAU,QAAQ,KAAG,OAOhD,CAAC"}

package/dist/form/convert.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isEmptyFormData = exports.convertIntoFormData = void 0;
+const basics_1 = require("../array/basics");
+/**
+ * * Utility to convert object into FormData.
+ *
+ * @param data Data to convert into FormData.
+ * @returns Converted FormData.
+ */
+const convertIntoFormData = (data) => {
+    const formData = new FormData();
+    Object.entries(data).forEach(([key, value]) => {
+        if (!(0, basics_1.isValidButEmptyArray)(value) && value[0]?.originFileObj) {
+            formData.append(key, value[0].originFileObj);
+        }
+        else if (value !== undefined && value !== null && value !== '') {
+            formData.append(key, value);
+        }
+    });
+    return formData;
+};
+exports.convertIntoFormData = convertIntoFormData;
+/**
+ * * Check if a formdata object is empty.
+ *
+ * @param obj FormData to check.
+ * @returns Whether the formdata is empty.
+ */
+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.');
+};
+exports.isEmptyFormData = isEmptyFormData;

package/dist/form/transform.d.ts

@@ -0,0 +1,12 @@
+import type { LooseObject } 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 LooseObject>(data: T, configs?: FormDataConfigs<T>) => FormData;
+//# sourceMappingURL=transform.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/form/transform.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,GAAI,CAAC,SAAS,WAAW,QACvD,CAAC,YACG,eAAe,CAAC,CAAC,CAAC,KAC1B,QAkDF,CAAC"}

package/dist/form/transform.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createControlledFormData = void 0;
+const basics_1 = require("../object/basics");
+/**
+ * * 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
+ */
+const createControlledFormData = (data, configs) => {
+    const formData = new FormData();
+    const addToFormData = (key, value) => {
+        if (value instanceof File) {
+            formData.append(key, value);
+        }
+        else if (Array.isArray(value)) {
+            value.forEach((item, index) => {
+                addToFormData(`${key}[${index}]`, item);
+            });
+        }
+        else if (typeof value === 'object' && !(0, basics_1.isEmptyObject)(value)) {
+            Object.entries(value).forEach(([nestedKey, nestedValue]) => {
+                addToFormData(`${key}.${nestedKey}`, nestedValue);
+            });
+        }
+        else {
+            formData.append(key, value);
+        }
+    };
+    const isPathPreserved = (key) => {
+        return configs?.preservePaths?.some((path) => key.startsWith(path));
+    };
+    Object.entries(data).forEach(([key, value]) => {
+        // 1. Skip keys that are in ignoreKeys
+        if (configs?.ignoreKeys?.includes(key))
+            return;
+        // 2. Trim string values if trimStrings is enabled
+        if (configs?.trimStrings && typeof value === 'string') {
+            value = value.trim();
+        }
+        // 3. Ensure requiredKeys are included even if falsy
+        if (configs?.requiredKeys?.includes(key) && value == null) {
+            value = ''; // Make sure it's an empty string for falsy values
+        }
+        // 4. Check preservePaths, if true, preserve values for nested paths
+        if (isPathPreserved(key)) {
+            addToFormData(key, value);
+        }
+        else {
+            const transformedKey = configs?.lowerCaseKeys?.includes(key) ?
+                key.toLowerCase()
+                : key;
+            addToFormData(transformedKey, value);
+        }
+    });
+    return formData;
+};
+exports.createControlledFormData = createControlledFormData;

package/dist/form/types.d.ts

@@ -0,0 +1,8 @@
+export interface FormDataConfigs<T> {
+    ignoreKeys?: (keyof T)[];
+    requiredKeys?: (keyof T)[];
+    lowerCaseKeys?: (keyof T)[];
+    preservePaths?: string[];
+    trimStrings?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/form/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe,CAAC,CAAC;IAEjC,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IAEzB,YAAY,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IAE3B,aAAa,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IAE5B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB"}

package/dist/form/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/index.d.ts

@@ -7,7 +7,11 @@ export { getColorForInitial } from './colors/initials';
 export { generateRandomColorInHexRGB, generateRandomHSLColor, } from './colors/random';
 export { convertColorCode, convertHexToHsl, convertHexToRgb, convertHslToHex, convertHslToRgb, convertRgbToHex, convertRgbToHsl, } from './colors/convert';
 export { extractNumbersFromColor } from './colors/helpers';
-export { createOptionsArray, filterArrayOfObjects, flattenArray, sortAnArray, } from './array/basics';
+export { filterArrayOfObjects, flattenArray, isValidButEmptyArray, } from './array/basics';
+export { sortAnArray } from './array/sort';
+export { createOptionsArray } from './array/transform';
+export { convertIntoFormData, isEmptyFormData } from './form/convert';
+export { createControlledFormData } from './form/transform';
 export { cloneObject, countObjectFields, generateQueryParams, isEmptyObject, isObject, } from './object/basics';
 export { extractNewFields, extractUpdatedAndNewFields, extractUpdatedFields, flattenObject, 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":"AAAA,OAAO,EACN,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,cAAc,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EACN,2BAA2B,EAC3B,sBAAsB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,GACf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EACN,kBAAkB,EAClB,oBAAoB,EACpB,YAAY,EACZ,WAAW,GACX,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACN,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,QAAQ,GACR,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,gBAAgB,EAChB,0BAA0B,EAC1B,oBAAoB,EACpB,aAAa,EACb,sBAAsB,EACtB,YAAY,GACZ,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,cAAc,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EACN,2BAA2B,EAC3B,sBAAsB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,GACf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EACN,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,GACpB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EACN,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,QAAQ,GACR,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,gBAAgB,EAChB,0BAA0B,EAC1B,oBAAoB,EACpB,aAAa,EACb,sBAAsB,EACtB,YAAY,GACZ,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isDeepEqual = exports.convertObjectValues = exports.sanitizeData = exports.mergeObjects = exports.mergeAndFlattenObjects = exports.flattenObject = exports.extractUpdatedFields = exports.extractUpdatedAndNewFields = exports.extractNewFields = exports.isObject = exports.isEmptyObject = exports.generateQueryParams = exports.countObjectFields = exports.cloneObject = exports.sortAnArray = exports.flattenArray = exports.filterArrayOfObjects = exports.createOptionsArray = exports.extractNumbersFromColor = exports.convertRgbToHsl = exports.convertRgbToHex = exports.convertHslToRgb = exports.convertHslToHex = exports.convertHexToRgb = exports.convertHexToHsl = exports.convertColorCode = exports.generateRandomHSLColor = exports.generateRandomColorInHexRGB = exports.getColorForInitial = exports.isPrime = exports.findPrimeNumbers = exports.numberToWords = exports.getRandomNumber = exports.convertToDecimal = exports.generateAnagrams = exports.truncateString = exports.trimString = exports.generateRandomID = exports.capitalizeString = void 0;
+exports.isDeepEqual = exports.convertObjectValues = exports.sanitizeData = exports.mergeObjects = exports.mergeAndFlattenObjects = exports.flattenObject = exports.extractUpdatedFields = exports.extractUpdatedAndNewFields = exports.extractNewFields = exports.isObject = exports.isEmptyObject = exports.generateQueryParams = exports.countObjectFields = exports.cloneObject = exports.createControlledFormData = exports.isEmptyFormData = exports.convertIntoFormData = exports.createOptionsArray = exports.sortAnArray = exports.isValidButEmptyArray = exports.flattenArray = exports.filterArrayOfObjects = exports.extractNumbersFromColor = exports.convertRgbToHsl = exports.convertRgbToHex = exports.convertHslToRgb = exports.convertHslToHex = exports.convertHexToRgb = exports.convertHexToHsl = exports.convertColorCode = exports.generateRandomHSLColor = exports.generateRandomColorInHexRGB = exports.getColorForInitial = exports.isPrime = exports.findPrimeNumbers = exports.numberToWords = exports.getRandomNumber = exports.convertToDecimal = exports.generateAnagrams = exports.truncateString = exports.trimString = exports.generateRandomID = exports.capitalizeString = void 0;
 var basics_1 = require("./string/basics");
 Object.defineProperty(exports, "capitalizeString", { enumerable: true, get: function () { return basics_1.capitalizeString; } });
 Object.defineProperty(exports, "generateRandomID", { enumerable: true, get: function () { return basics_1.generateRandomID; } });
@@ -32,10 +32,18 @@ Object.defineProperty(exports, "convertRgbToHsl", { enumerable: true, get: funct
 var helpers_1 = require("./colors/helpers");
 Object.defineProperty(exports, "extractNumbersFromColor", { enumerable: true, get: function () { return helpers_1.extractNumbersFromColor; } });
 var basics_3 = require("./array/basics");
-Object.defineProperty(exports, "createOptionsArray", { enumerable: true, get: function () { return basics_3.createOptionsArray; } });
 Object.defineProperty(exports, "filterArrayOfObjects", { enumerable: true, get: function () { return basics_3.filterArrayOfObjects; } });
 Object.defineProperty(exports, "flattenArray", { enumerable: true, get: function () { return basics_3.flattenArray; } });
-Object.defineProperty(exports, "sortAnArray", { enumerable: true, get: function () { return basics_3.sortAnArray; } });
+Object.defineProperty(exports, "isValidButEmptyArray", { enumerable: true, get: function () { return basics_3.isValidButEmptyArray; } });
+var sort_1 = require("./array/sort");
+Object.defineProperty(exports, "sortAnArray", { enumerable: true, get: function () { return sort_1.sortAnArray; } });
+var transform_1 = require("./array/transform");
+Object.defineProperty(exports, "createOptionsArray", { enumerable: true, get: function () { return transform_1.createOptionsArray; } });
+var convert_3 = require("./form/convert");
+Object.defineProperty(exports, "convertIntoFormData", { enumerable: true, get: function () { return convert_3.convertIntoFormData; } });
+Object.defineProperty(exports, "isEmptyFormData", { enumerable: true, get: function () { return convert_3.isEmptyFormData; } });
+var transform_2 = require("./form/transform");
+Object.defineProperty(exports, "createControlledFormData", { enumerable: true, get: function () { return transform_2.createControlledFormData; } });
 var basics_4 = require("./object/basics");
 Object.defineProperty(exports, "cloneObject", { enumerable: true, get: function () { return basics_4.cloneObject; } });
 Object.defineProperty(exports, "countObjectFields", { enumerable: true, get: function () { return basics_4.countObjectFields; } });
@@ -51,7 +59,7 @@ Object.defineProperty(exports, "mergeAndFlattenObjects", { enumerable: true, get
 Object.defineProperty(exports, "mergeObjects", { enumerable: true, get: function () { return objectify_1.mergeObjects; } });
 var sanitize_1 = require("./object/sanitize");
 Object.defineProperty(exports, "sanitizeData", { enumerable: true, get: function () { return sanitize_1.sanitizeData; } });
-var convert_3 = require("./object/convert");
-Object.defineProperty(exports, "convertObjectValues", { enumerable: true, get: function () { return convert_3.convertObjectValues; } });
+var convert_4 = require("./object/convert");
+Object.defineProperty(exports, "convertObjectValues", { enumerable: true, get: function () { return convert_4.convertObjectValues; } });
 var utils_1 = require("./utils");
 Object.defineProperty(exports, "isDeepEqual", { enumerable: true, get: function () { return utils_1.isDeepEqual; } });

package/package.json

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