nhb-toolbox 1.0.4 → 1.1.3

package/dist/array/index.d.ts

@@ -51,4 +51,14 @@ export declare function sortAnArray(array: boolean[], options?: OrderOption): bo
  * @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.
+ *
+ * @template T - The type of objects in the array.
+ * @param array - The array of objects to filter.
+ * @param conditions - An object where keys represent the property names and values represent the filter conditions.
+ *                     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[];
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/array/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createOptionsArray = exports.flattenArray = void 0;
+exports.filterArrayOfObjects = exports.createOptionsArray = exports.flattenArray = void 0;
 exports.sortAnArray = sortAnArray;
 /**
  * * Flattens a nested array recursively or wraps any non-array data type in an array.
@@ -98,3 +98,27 @@ function sortAnArray(array, options) {
     }
     throw new Error('Invalid array or missing "sortByField" for objects.');
 }
+/**
+ * * Filters an array of objects based on multiple conditions for specified keys.
+ *
+ * @template T - The type of objects in the array.
+ * @param array - The array of objects to filter.
+ * @param conditions - An object where keys represent the property names and values represent the filter conditions.
+ *                     The conditions can be a value, a range, or a function.
+ * @returns The filtered array of objects.
+ */
+const filterArrayOfObjects = (array, conditions) => {
+    if (!Array.isArray(array)) {
+        throw new Error('The provided input is not an array!');
+    }
+    return array.filter((item) => Object.entries(conditions).every(([key, conditionFn]) => {
+        // Ensure only check the key in the object if the condition function is provided
+        if (conditionFn) {
+            // Type assertion for the value since it's unknown
+            return conditionFn(item[key]);
+        }
+        // If no condition function, include all values for the key
+        return true;
+    }));
+};
+exports.filterArrayOfObjects = filterArrayOfObjects;

package/dist/array/types.d.ts

@@ -38,7 +38,7 @@ export interface ConfigOptions<T extends Record<string, string | number | null |
      */
     secondFieldName?: K2;
 }
-/** - Object type with string or number as value for each key. */
+/** - Object type with string or number or boolean as value for each key. */
 export type InputObject = Record<string, string | number | boolean>;
 /** - Option for sorting order. */
 export interface OrderOption {
@@ -53,7 +53,7 @@ export interface OrderOption {
  * * Options for sorting an array of objects.
  * @template T - The type of objects in the array.
  */
-export interface SortOptions<T extends InputObject> extends OrderOption {
+export interface SortOptions<T extends Record<string, unknown>> extends OrderOption {
     /** The field by which to sort the objects in the array. */
     sortByField?: keyof T;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/array/types.ts"],"names":[],"mappings":"AAAA;;;;MAIM;AACN,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAEpE,wCAAwC;AACxC,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAE7E;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa,CAC7B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAC5D,EAAE,SAAS,MAAM,GAAG,OAAO,EAC3B,EAAE,SAAS,MAAM,GAAG,OAAO;IAE3B;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC,CAAC;IAEvB;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC,CAAC;IAExB;;;;OAIG;IACH,cAAc,CAAC,EAAE,EAAE,CAAC;IAEpB;;;;OAIG;IACH,eAAe,CAAC,EAAE,EAAE,CAAC;CACrB;AAED,iEAAiE;AACjE,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AAEpE,kCAAkC;AAClC,MAAM,WAAW,WAAW;IAC3B;;;;OAIG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,WAAW,CAAE,SAAQ,WAAW;IACtE,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/array/types.ts"],"names":[],"mappings":"AAAA;;;;MAIM;AACN,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAEpE,wCAAwC;AACxC,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAE7E;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa,CAC7B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAC5D,EAAE,SAAS,MAAM,GAAG,OAAO,EAC3B,EAAE,SAAS,MAAM,GAAG,OAAO;IAE3B;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC,CAAC;IAEvB;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC,CAAC;IAExB;;;;OAIG;IACH,cAAc,CAAC,EAAE,EAAE,CAAC;IAEpB;;;;OAIG;IACH,eAAe,CAAC,EAAE,EAAE,CAAC;CACrB;AAED,4EAA4E;AAC5E,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AAEpE,kCAAkC;AAClC,MAAM,WAAW,WAAW;IAC3B;;;;OAIG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAC7D,SAAQ,WAAW;IACnB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC;CACtB"}

package/dist/colors/index.js

@@ -4,8 +4,7 @@ exports.getColorForInitial = getColorForInitial;
 const helpers_1 = require("./helpers");
 const constants_1 = require("./constants");
 /**
- *  * Generates a hex color based on the first character (initial) of a string or number;
- * or an array of hex colors based on the first character (initial) of an array of strings/numbers or even nested arrays of strings/numbers.
+ *  * Generates a hex color based on the first character (initial) of a string or number; or an array of hex colors based on the first character (initial) of an array of strings/numbers or even nested arrays of strings/numbers.
  *
  * - For numbers, it uses 10 predefined colors (0-9).
  * - For letters, it uses 26 predefined colors (A-Z).

package/dist/index.d.ts

@@ -1,8 +1,9 @@
-export { capitalizeString, truncateString, generateRandomID } from './string';
+export { capitalizeString, truncateString, generateRandomID, trimString, } from './string';
 export { getRandomNumber, convertToDecimal } from './number';
 export { getColorForInitial } from './colors';
 export { generateRandomColor } from './colors/random';
 export { convertHexToHsl, convertHexToRgb, convertHslToHex, convertHslToRgb, convertRgbToHex, convertRgbToHsl, } from './colors/convert';
-export { flattenArray, createOptionsArray, sortAnArray } from './array';
+export { flattenArray, createOptionsArray, sortAnArray, filterArrayOfObjects, } from './array';
 export { generateQueryParams, cloneObject, isDeepEqual, mergeObjects, flattenObject, mergeAndFlattenObjects, isEmptyObject, countObjectFields, } from './object';
+export { sanitizeData } from './object/sanitize';
 //# 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":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE9E,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,EACN,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,GACf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAExE,OAAO,EACN,mBAAmB,EACnB,WAAW,EACX,WAAW,EACX,YAAY,EACZ,aAAa,EACb,sBAAsB,EACtB,aAAa,EACb,iBAAiB,GACjB,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,UAAU,GACV,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,EACN,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,GACf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACN,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,oBAAoB,GACpB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACN,mBAAmB,EACnB,WAAW,EACX,WAAW,EACX,YAAY,EACZ,aAAa,EACb,sBAAsB,EACtB,aAAa,EACb,iBAAiB,GACjB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.countObjectFields = exports.isEmptyObject = exports.mergeAndFlattenObjects = exports.flattenObject = exports.mergeObjects = exports.isDeepEqual = exports.cloneObject = exports.generateQueryParams = exports.sortAnArray = exports.createOptionsArray = exports.flattenArray = exports.convertRgbToHsl = exports.convertRgbToHex = exports.convertHslToRgb = exports.convertHslToHex = exports.convertHexToRgb = exports.convertHexToHsl = exports.generateRandomColor = exports.getColorForInitial = exports.convertToDecimal = exports.getRandomNumber = exports.generateRandomID = exports.truncateString = exports.capitalizeString = void 0;
+exports.sanitizeData = exports.countObjectFields = exports.isEmptyObject = exports.mergeAndFlattenObjects = exports.flattenObject = exports.mergeObjects = exports.isDeepEqual = exports.cloneObject = exports.generateQueryParams = exports.filterArrayOfObjects = exports.sortAnArray = exports.createOptionsArray = exports.flattenArray = exports.convertRgbToHsl = exports.convertRgbToHex = exports.convertHslToRgb = exports.convertHslToHex = exports.convertHexToRgb = exports.convertHexToHsl = exports.generateRandomColor = exports.getColorForInitial = exports.convertToDecimal = exports.getRandomNumber = exports.trimString = exports.generateRandomID = exports.truncateString = exports.capitalizeString = void 0;
 var string_1 = require("./string");
 Object.defineProperty(exports, "capitalizeString", { enumerable: true, get: function () { return string_1.capitalizeString; } });
 Object.defineProperty(exports, "truncateString", { enumerable: true, get: function () { return string_1.truncateString; } });
 Object.defineProperty(exports, "generateRandomID", { enumerable: true, get: function () { return string_1.generateRandomID; } });
+Object.defineProperty(exports, "trimString", { enumerable: true, get: function () { return string_1.trimString; } });
 var number_1 = require("./number");
 Object.defineProperty(exports, "getRandomNumber", { enumerable: true, get: function () { return number_1.getRandomNumber; } });
 Object.defineProperty(exports, "convertToDecimal", { enumerable: true, get: function () { return number_1.convertToDecimal; } });
@@ -23,6 +24,7 @@ var array_1 = require("./array");
 Object.defineProperty(exports, "flattenArray", { enumerable: true, get: function () { return array_1.flattenArray; } });
 Object.defineProperty(exports, "createOptionsArray", { enumerable: true, get: function () { return array_1.createOptionsArray; } });
 Object.defineProperty(exports, "sortAnArray", { enumerable: true, get: function () { return array_1.sortAnArray; } });
+Object.defineProperty(exports, "filterArrayOfObjects", { enumerable: true, get: function () { return array_1.filterArrayOfObjects; } });
 var object_1 = require("./object");
 Object.defineProperty(exports, "generateQueryParams", { enumerable: true, get: function () { return object_1.generateQueryParams; } });
 Object.defineProperty(exports, "cloneObject", { enumerable: true, get: function () { return object_1.cloneObject; } });
@@ -32,3 +34,5 @@ Object.defineProperty(exports, "flattenObject", { enumerable: true, get: functio
 Object.defineProperty(exports, "mergeAndFlattenObjects", { enumerable: true, get: function () { return object_1.mergeAndFlattenObjects; } });
 Object.defineProperty(exports, "isEmptyObject", { enumerable: true, get: function () { return object_1.isEmptyObject; } });
 Object.defineProperty(exports, "countObjectFields", { enumerable: true, get: function () { return object_1.countObjectFields; } });
+var sanitize_1 = require("./object/sanitize");
+Object.defineProperty(exports, "sanitizeData", { enumerable: true, get: function () { return sanitize_1.sanitizeData; } });

package/dist/object/index.d.ts

@@ -1,5 +1,6 @@
+import type { GenericObject } from './types';
 /**
- * * Utility function to generate query parameters from an object.
+ * * Utility to generate query parameters from an object.
  *
  * @template T - A generic type extending `Record<string, string | number | string[] | number[]>`.
  * @param params - Object containing query parameters.
@@ -16,28 +17,28 @@ export declare const generateQueryParams: <T extends Record<string, string | num
  * @param obj Object to clone.
  * @returns Deep cloned object.
  */
-export declare const cloneObject: <T extends Record<string, unknown>>(obj: T) => T;
+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 Record<string, unknown>>(obj: T) => boolean;
+export declare const isEmptyObject: <T extends GenericObject>(obj: T) => boolean;
 /**
  * * Count the number of fields in an object.
  *
  * @param obj Object to check.
  * @returns Number of fields in the object.
  */
-export declare const countObjectFields: <T extends Record<string, unknown>>(obj: T) => number;
+export declare const countObjectFields: <T extends GenericObject>(obj: T) => number;
 /**
  * * Deeply merge two or more objects using `Map`.
  *
  * @param objects Objects to merge.
  * @returns Merged object.
  */
-export declare const mergeObjects: <T extends Record<string, unknown>>(...objects: T[]) => T;
+export declare const mergeObjects: <T extends GenericObject>(...objects: T[]) => T;
 /**
  * * Deeply merge objects and flatten nested objects.
  * * Useful for flattening a single object or merging multiple objects with duplicate key(s).
@@ -46,14 +47,14 @@ export declare const mergeObjects: <T extends Record<string, unknown>>(...object
  * @param objects Objects to merge.
  * @returns Merged object with flattened structure.
  */
-export declare const mergeAndFlattenObjects: <T extends Record<string, unknown>>(...objects: T[]) => Record<string, unknown>;
+export declare const mergeAndFlattenObjects: <T extends GenericObject>(...objects: T[]) => GenericObject;
 /**
  * * Flattens a nested object into a dot notation format.
  *
  * @param object - The `object` to flatten.
  * @returns A `flattened object` with dot notation keys.
  */
-export declare const flattenObject: <T extends Record<string, unknown>>(object: T) => Record<string, unknown>;
+export declare const flattenObject: <T extends GenericObject>(object: T) => GenericObject;
 /**
  * * Deeply compare two values (arrays, objects, or primitive values).
  *

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/object/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,GAC/B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,WAEvD,CAAC,KACP,MAkBF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,KAAG,CAEvE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,OACzD,CAAC,KACJ,OAEF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,OAC7D,CAAC,KACJ,MAEF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,cACjD,CAAC,EAAE,KACb,CAuCF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,cAC3D,CAAC,EAAE,KACb,MAAM,CAAC,MAAM,EAAE,OAAO,CA4BxB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,UACtD,CAAC,KACP,MAAM,CAAC,MAAM,EAAE,OAAO,CAgCxB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAG,OAgC3C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/object/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,GAC/B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,WAEvD,CAAC,KACP,MAkBF,CAAC;AAEF;;;;;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,OAE/D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,aAAa,OAAO,CAAC,KAAG,MAEnE,CAAC;AAEF;;;;;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,aAAa,GAAI,CAAC,SAAS,aAAa,UAC5C,CAAC,KACP,aA6BF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAG,OA6B3C,CAAC"}

package/dist/object/index.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isDeepEqual = exports.flattenObject = exports.mergeAndFlattenObjects = exports.mergeObjects = exports.countObjectFields = exports.isEmptyObject = exports.cloneObject = exports.generateQueryParams = void 0;
 /**
- * * Utility function to generate query parameters from an object.
+ * * Utility to generate query parameters from an object.
  *
  * @template T - A generic type extending `Record<string, string | number | string[] | number[]>`.
  * @param params - Object containing query parameters.
@@ -39,7 +39,7 @@ exports.cloneObject = cloneObject;
  * @returns Whether the object is empty.
  */
 const isEmptyObject = (obj) => {
-    return Object.keys(obj).length === 0;
+    return Object.keys(obj).length === 0 && obj.constructor === Object;
 };
 exports.isEmptyObject = isEmptyObject;
 /**

package/dist/object/sanitize.d.ts

@@ -0,0 +1,27 @@
+import type { GenericObject, SanitizeOptions } from './types';
+/**
+ * * Processes an object by ignoring specified keys and trimming string values based on options provided.
+ * * Also excludes nullish values (null, undefined) if specified. Always ignores empty nested object(s).
+ *
+ * @param object - The object to process.
+ * @param options - Options that define which keys to ignore, whether to trim string values, and whether to exclude nullish values.
+ * @returns A new object with the specified modifications.
+ */
+export declare function sanitizeData<T extends GenericObject>(object: T, options?: SanitizeOptions<T>): T;
+/**
+ * * Processes an array of objects by ignoring specified keys and trimming string values based on options provided.
+ * * Also excludes nullish values (null, undefined) if specified. Always ignores empty nested object(s).
+ *
+ * @param object - The object to process.
+ * @param options - Options that define which keys to ignore, whether to trim string values, and whether to exclude nullish values.
+ * @returns A new array of objects with the specified modifications.
+ */
+export declare function sanitizeData<T extends GenericObject>(array: T[], options?: SanitizeOptions<T>): T[];
+/**
+ * * Trims all the words in a string or an array of strings.
+ *
+ * @param input String or array of strings.
+ * @returns Trimmed string or array of strings.
+ */
+export declare function sanitizeData(input: string | string[]): string | string[];
+//# sourceMappingURL=sanitize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/object/sanitize.ts"],"names":[],"mappings":"AAEA,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;AAEL;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,aAAa,EACnD,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAC1B,CAAC,EAAE,CAAC;AAEP;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC"}

package/dist/object/sanitize.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeData = sanitizeData;
+const index_1 = require("./index");
+const string_1 = require("../string");
+/**
+ * * Processes 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).
+ *
+ * @param input - The object or array of objects to process.
+ * @param options - Options for processing.
+ * @returns A new string, array of strings, object or array of objects with the specified modifications.
+ */
+function sanitizeData(input, options) {
+    const { ignoreKeys = [], trimStrings = true, ignoreNullish = false, } = options || {};
+    // Flatten the object keys and use the keys for comparison
+    const ignoreKeySet = new Set(ignoreKeys);
+    /**
+     * * Helper function to process a single object.
+     *
+     * @param object The object to process.
+     * @param parentPath The parent path of a key.
+     *  */
+    const _processObject = (object, parentPath = '') => Object.entries(object).reduce((acc, [key, value]) => {
+        // Compute the full key path
+        const fullKeyPath = parentPath ? `${parentPath}.${key}` : key;
+        // Skip ignored keys
+        if (ignoreKeySet.has(fullKeyPath)) {
+            return acc;
+        }
+        // Exclude nullish values if specified
+        if (ignoreNullish && (value === null || value === undefined)) {
+            return acc;
+        }
+        // Trim string values if enabled
+        if (typeof value === 'string' && trimStrings) {
+            acc[key] = (0, string_1.trimString)(value);
+        }
+        else if (value &&
+            typeof value === 'object' &&
+            !Array.isArray(value)) {
+            // Recursively process nested objects
+            const processedValue = _processObject(value, fullKeyPath);
+            // Only add the property if it's not an empty object
+            if (!(0, index_1.isEmptyObject)(processedValue)) {
+                acc[key] = processedValue;
+            }
+        }
+        else {
+            // Add other values as-is
+            acc[key] = value;
+        }
+        return acc;
+    }, {});
+    // Process strings
+    if (typeof input === 'string') {
+        return (0, string_1.trimString)(input);
+    }
+    // Process array of strings and objects
+    if (Array.isArray(input)) {
+        // Process array of strings
+        if (typeof input[0] === 'string') {
+            return (0, string_1.trimString)(input);
+        }
+        // Process array of objects
+        return input
+            .map((obj) => _processObject(obj))
+            .filter((obj) => !(0, index_1.isEmptyObject)(obj));
+    }
+    // Process object
+    if (typeof input === 'object' && input !== null) {
+        return _processObject(input);
+    }
+    return input;
+}

package/dist/object/types.d.ts

@@ -0,0 +1,16 @@
+/** - Generic object type */
+export type GenericObject = Record<string, unknown>;
+/** - Recursive type to generate dot-notation keys for nested objects. */
+export type DotNotationKey<T> = T extends object ? {
+    [K in keyof T & string]: T[K] extends object ? K | `${K}.${DotNotationKey<T[K]>}` : K;
+}[keyof T & string] : never;
+/** - Options for `sanitizeData` */
+export interface SanitizeOptions<T extends GenericObject> {
+    /** Keys to ignore */
+    ignoreKeys?: DotNotationKey<T>[];
+    /** Whether to trim string values. Defaults to `true` */
+    trimStrings?: boolean;
+    /** Whether to exclude nullish (null or undefined) values. Defaults to `false` */
+    ignoreNullish?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/object/types.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpD,yEAAyE;AACzE,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GAC7C;KACC,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GACzC,CAAC,GAAG,GAAG,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAClC,CAAC;CACJ,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAClB,KAAK,CAAC;AAET,mCAAmC;AACnC,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,aAAa;IACvD,qBAAqB;IACrB,UAAU,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IACjC,wDAAwD;IACxD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iFAAiF;IACjF,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB"}

package/dist/object/types.js

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

package/dist/string/index.d.ts

@@ -17,10 +17,24 @@ export declare const capitalizeString: (string: string, options?: CapitalizeOpti
  */
 export declare const truncateString: (string: string, maxLength: number) => string;
 /**
- * * Generates a unique ID string composed of an optional `prefix`, `suffix`, a `timestamp`, `separator`, and a random alphanumeric string, separated by a customizable separator.
+ * * Generates a random alphanumeric (16 characters long, this length is customizable in the options) ID string composed of an optional `prefix`, `suffix`, a `timestamp`, and a customizable separator.
  *
  * @param options Configuration options for random ID generation.
- * @returns The generated ID string composed of the random alphanumeric string, timestamp, prefix, and suffix, separated by the specified separator.
+ * @returns The generated ID string composed of the random alphanumeric string of specified length with optional `timeStamp`, `prefix`, and `suffix`, `caseOption` and `separator`.
  */
 export declare const generateRandomID: (options?: RandomIdOptions) => string;
+/**
+ * * Trims all the words in a string.
+ *
+ * @param input The string to trim.
+ * @returns Trimmed string.
+ */
+export declare function trimString(input: string): string;
+/**
+ * * Trims all the words in an array of strings.
+ *
+ * @param input The array of strings to trim.
+ * @returns Trimmed array of strings.
+ */
+export declare function trimString(input: string[]): string[];
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/string/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAElE;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,WACpB,MAAM,YACJ,iBAAiB,KACzB,MA0CF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,WAAY,MAAM,aAAa,MAAM,KAAG,MAYlE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,aAAc,eAAe,KAAG,MAkC5D,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/string/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAElE;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,WACpB,MAAM,YACJ,iBAAiB,KACzB,MA0CF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,WAAY,MAAM,aAAa,MAAM,KAAG,MAYlE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,aAAc,eAAe,KAAG,MAkC5D,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;AAElD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC"}

package/dist/string/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateRandomID = exports.truncateString = exports.capitalizeString = void 0;
+exports.trimString = trimString;
 /**
  * * Utility to convert the first letter of any string to uppercase and the rest lowercase (unless specified).
  * Handles surrounding symbols like quotes or parentheses.
@@ -61,10 +62,10 @@ const truncateString = (string, maxLength) => {
 };
 exports.truncateString = truncateString;
 /**
- * * Generates a unique ID string composed of an optional `prefix`, `suffix`, a `timestamp`, `separator`, and a random alphanumeric string, separated by a customizable separator.
+ * * Generates a random alphanumeric (16 characters long, this length is customizable in the options) ID string composed of an optional `prefix`, `suffix`, a `timestamp`, and a customizable separator.
  *
  * @param options Configuration options for random ID generation.
- * @returns The generated ID string composed of the random alphanumeric string, timestamp, prefix, and suffix, separated by the specified separator.
+ * @returns The generated ID string composed of the random alphanumeric string of specified length with optional `timeStamp`, `prefix`, and `suffix`, `caseOption` and `separator`.
  */
 const generateRandomID = (options) => {
     const { prefix = '', suffix = '', timeStamp = false, length = 16, separator = '', caseOption = null, } = options || {};
@@ -91,3 +92,22 @@ const generateRandomID = (options) => {
     }
 };
 exports.generateRandomID = generateRandomID;
+/**
+ * * Trims all the words in a string or an array of strings.
+ *
+ * @param input String or array of strings.
+ * @returns Trimmed string or array of strings.
+ */
+function trimString(input) {
+    if (!input)
+        return '';
+    // If the input is a string, trim each word
+    if (typeof input === 'string' && !Array.isArray(input)) {
+        return input.trim().replace(/\s+/g, ' ');
+    }
+    // If the input is an array of strings, trim each string in the array
+    if (Array.isArray(input)) {
+        return input.map((str) => typeof str === 'string' ? str.trim().replace(/\s+/g, ' ') : str);
+    }
+    throw new Error('Invalid input type. Expected string or array of strings!');
+}

package/dist/string/types.d.ts

@@ -1,4 +1,4 @@
-/** - Options for capitalizeString function. */
+/** - Options for `capitalizeString` function. */
 export interface CapitalizeOptions {
     /** If true, capitalizes the first letter of each word (space separated). Defaults to `false`. */
     capitalizeEachFirst?: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/string/types.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,MAAM,WAAW,iBAAiB;IACjC,iGAAiG;IACjG,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,kFAAkF;IAClF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qFAAqF;IACrF,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC/B,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC;CACtC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/string/types.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IACjC,iGAAiG;IACjG,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,kFAAkF;IAClF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qFAAqF;IACrF,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC/B,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC;CACtC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "1.0.4",
+  "version": "1.1.3",
   "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/types/index.d.ts

@@ -1 +0,0 @@
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/types/index.js

@@ -1 +0,0 @@
-"use strict";