nhb-toolbox 2.8.1 → 2.8.3

package/dist/object/convert.js

@@ -1,6 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.convertObjectValues = convertObjectValues;
 /**
  * * Converts the values of specified keys in an object or array of objects to either string or number.
  * * Supports nested objects using dot-notation keys.
@@ -11,7 +8,7 @@ exports.convertObjectValues = convertObjectValues;
  *   - `convertTo`: The target type, either "string" or "number".
  * @returns The modified object or array of objects with the converted values, with updated types.
  */
-function convertObjectValues(data, options) {
+export function convertObjectValues(data, options) {
     const { keys, convertTo } = options;
     /** * Helper function to determine if value should be preserved. */
     const _shouldPreserveValue = (value) => convertTo === 'number' &&

package/dist/object/objectify.js

@@ -1,15 +1,12 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.extractUpdatedAndNewFields = exports.extractNewFields = exports.extractUpdatedFields = exports.flattenObjectDotNotation = exports.flattenObjectKeyValue = exports.mergeAndFlattenObjects = exports.mergeObjects = void 0;
-const utils_1 = require("../utils");
-const basics_1 = require("./basics");
+import { isDeepEqual } from '../utils';
+import { isEmptyObject, isObject } from './basics';
 /**
  * * Deeply merge two or more objects using `Map`.
  *
  * @param objects Objects to merge.
  * @returns Merged object.
  */
-const mergeObjects = (...objects) => {
+export const mergeObjects = (...objects) => {
     const map = new Map();
     objects.forEach((obj) => {
         for (const key in obj) {
@@ -19,7 +16,7 @@ const mergeObjects = (...objects) => {
                 if (existingValue &&
                     existingValue instanceof Object &&
                     !Array.isArray(existingValue)) {
-                    map.set(key, (0, exports.mergeObjects)(existingValue, obj[key]));
+                    map.set(key, mergeObjects(existingValue, obj[key]));
                 }
                 else {
                     // Otherwise, just set the value
@@ -38,7 +35,6 @@ const mergeObjects = (...objects) => {
     });
     return result;
 };
-exports.mergeObjects = mergeObjects;
 /**
  * * Deeply merge objects and flatten nested objects.
  * * Useful for flattening a single object or merging multiple objects with duplicate key(s).
@@ -47,7 +43,7 @@ exports.mergeObjects = mergeObjects;
  * @param objects Objects to merge.
  * @returns Merged object with flattened structure.
  */
-const mergeAndFlattenObjects = (...objects) => {
+export const mergeAndFlattenObjects = (...objects) => {
     const map = new Map();
     const _flattenObject = (obj, parentKey = '') => {
         for (const key in obj) {
@@ -69,21 +65,20 @@ const mergeAndFlattenObjects = (...objects) => {
     });
     return result;
 };
-exports.mergeAndFlattenObjects = mergeAndFlattenObjects;
 /**
  * * Flattens a nested object into key-value format.
  *
  * @param object - The `object` to flatten.
  * @returns A `flattened object` in key-value format.
  */
-const flattenObjectKeyValue = (object) => {
+export const flattenObjectKeyValue = (object) => {
     const flattened = {};
     for (const [key, value] of Object.entries(object)) {
         if (typeof value === 'object' &&
             value !== null &&
             !Array.isArray(value)) {
             // Recursively flatten nested objects
-            const nestedFlattened = (0, exports.flattenObjectKeyValue)(value);
+            const nestedFlattened = flattenObjectKeyValue(value);
             Object.assign(flattened, nestedFlattened);
         }
         else {
@@ -93,14 +88,13 @@ const flattenObjectKeyValue = (object) => {
     }
     return flattened;
 };
-exports.flattenObjectKeyValue = flattenObjectKeyValue;
 /**
  * * Flattens a nested object into a dot notation format.
  *
  * @param object - The `object` to flatten.
  * @returns A `flattened object` with dot notation keys.
  */
-const flattenObjectDotNotation = (object) => {
+export const flattenObjectDotNotation = (object) => {
     /**
      * * Recursively flattens an object, transforming nested structures into dot-notation keys.
      *
@@ -130,7 +124,6 @@ const flattenObjectDotNotation = (object) => {
     // Call the recursive function with an empty prefix initially
     return _flattenObject(object);
 };
-exports.flattenObjectDotNotation = flattenObjectDotNotation;
 /**
  * * Extracts only the fields that have changed between the original and updated object.
  *
@@ -138,14 +131,14 @@ exports.flattenObjectDotNotation = flattenObjectDotNotation;
  * @param updatedObject The modified object containing potential updates.
  * @returns A new object containing only the changed fields.
  */
-const extractUpdatedFields = (baseObject, updatedObject) => {
+export const extractUpdatedFields = (baseObject, updatedObject) => {
     const updatedFields = {};
     for (const key in updatedObject) {
         if (key in baseObject &&
-            !(0, utils_1.isDeepEqual)(updatedObject[key], baseObject[key])) {
-            if (updatedObject[key] && (0, basics_1.isObject)(updatedObject[key])) {
-                updatedFields[key] = (0, exports.extractUpdatedFields)(baseObject[key], updatedObject[key]);
-                if (updatedFields[key] && (0, basics_1.isEmptyObject)(updatedFields[key])) {
+            !isDeepEqual(updatedObject[key], baseObject[key])) {
+            if (updatedObject[key] && isObject(updatedObject[key])) {
+                updatedFields[key] = extractUpdatedFields(baseObject[key], updatedObject[key]);
+                if (updatedFields[key] && isEmptyObject(updatedFields[key])) {
                     delete updatedFields[key];
                 }
             }
@@ -156,7 +149,6 @@ const extractUpdatedFields = (baseObject, updatedObject) => {
     }
     return updatedFields;
 };
-exports.extractUpdatedFields = extractUpdatedFields;
 /**
  * * Extracts only new fields that exist in updatedObject but not in baseObject.
  *
@@ -164,17 +156,17 @@ exports.extractUpdatedFields = extractUpdatedFields;
  * @param updatedObject The modified object containing potential new fields.
  * @returns A new object containing only the new fields.
  */
-const extractNewFields = (baseObject, updatedObject) => {
+export const extractNewFields = (baseObject, updatedObject) => {
     const newFields = {};
     for (const key in updatedObject) {
         if (!(key in baseObject)) {
             // Directly assign new fields
             newFields[key] = updatedObject[key];
         }
-        else if ((0, basics_1.isObject)(updatedObject[key]) && (0, basics_1.isObject)(baseObject[key])) {
+        else if (isObject(updatedObject[key]) && isObject(baseObject[key])) {
             // Recursively extract new fields inside nested objects
-            const nestedNewFields = (0, exports.extractNewFields)(baseObject[key], updatedObject[key]);
-            if (!(0, basics_1.isEmptyObject)(nestedNewFields)) {
+            const nestedNewFields = extractNewFields(baseObject[key], updatedObject[key]);
+            if (!isEmptyObject(nestedNewFields)) {
                 newFields[key] =
                     nestedNewFields;
             }
@@ -182,7 +174,6 @@ const extractNewFields = (baseObject, updatedObject) => {
     }
     return newFields;
 };
-exports.extractNewFields = extractNewFields;
 /**
  * * Extracts changed fields from the updated object while also identifying newly added keys.
  *
@@ -190,17 +181,17 @@ exports.extractNewFields = extractNewFields;
  * @param updatedObject The modified object containing potential updates.
  * @returns An object containing modified fields and new fields separately.
  */
-const extractUpdatedAndNewFields = (baseObject, updatedObject) => {
+export const extractUpdatedAndNewFields = (baseObject, updatedObject) => {
     const updatedFields = {};
     const newFields = {};
     for (const key in updatedObject) {
         if (!(key in baseObject)) {
             newFields[key] = updatedObject[key];
         }
-        else if (!(0, utils_1.isDeepEqual)(updatedObject[key], baseObject[key])) {
-            if (updatedObject[key] && (0, basics_1.isObject)(updatedObject[key])) {
-                updatedFields[key] = (0, exports.extractUpdatedAndNewFields)(baseObject[key], updatedObject[key]);
-                if (updatedFields[key] && (0, basics_1.isEmptyObject)(updatedFields[key])) {
+        else if (!isDeepEqual(updatedObject[key], baseObject[key])) {
+            if (updatedObject[key] && isObject(updatedObject[key])) {
+                updatedFields[key] = extractUpdatedAndNewFields(baseObject[key], updatedObject[key]);
+                if (updatedFields[key] && isEmptyObject(updatedFields[key])) {
                     delete updatedFields[key];
                 }
             }
@@ -211,4 +202,3 @@ const extractUpdatedAndNewFields = (baseObject, updatedObject) => {
     }
     return { ...updatedFields, ...newFields };
 };
-exports.extractUpdatedAndNewFields = extractUpdatedAndNewFields;

package/dist/object/sanitize.js

@@ -1,8 +1,5 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.sanitizeData = sanitizeData;
-const basics_1 = require("../string/basics");
-const basics_2 = require("./basics");
+import { trimString } from '../string/basics';
+import { isEmptyObject } from './basics';
 /**
  * * Sanitizes a string, array of strings, an object or array of objects by ignoring specified keys and trimming string values.
  * * Also excludes nullish values (null, undefined) if specified. Always ignores empty nested object(s).
@@ -11,7 +8,7 @@ const basics_2 = require("./basics");
  * @param options - Options for processing.
  * @returns A new string, object or array of strings or objects with the specified modifications.
  */
-function sanitizeData(input, options) {
+export function sanitizeData(input, options) {
     const { keysToIgnore: ignoreKeys = [], trimStrings = true, ignoreNullish = false, } = options || {};
     // Flatten the object keys and use the keys for comparison
     const ignoreKeySet = new Set(ignoreKeys);
@@ -34,7 +31,7 @@ function sanitizeData(input, options) {
         }
         // Trim string values if enabled
         if (typeof value === 'string' && trimStrings) {
-            acc[key] = (0, basics_1.trimString)(value);
+            acc[key] = trimString(value);
         }
         else if (value &&
             typeof value === 'object' &&
@@ -42,7 +39,7 @@ function sanitizeData(input, options) {
             // Recursively process nested objects
             const processedValue = _processObject(value, fullKeyPath);
             // Only add the property if it's not an empty object
-            if (!(0, basics_2.isEmptyObject)(processedValue)) {
+            if (!isEmptyObject(processedValue)) {
                 acc[key] = processedValue;
             }
         }
@@ -54,18 +51,18 @@ function sanitizeData(input, options) {
     }, {});
     // Process strings
     if (typeof input === 'string') {
-        return (0, basics_1.trimString)(input);
+        return trimString(input);
     }
     // Process array of strings and objects
     if (Array.isArray(input)) {
         // Process array of strings
         if (typeof input[0] === 'string') {
-            return (0, basics_1.trimString)(input);
+            return trimString(input);
         }
         // Process array of objects
         return input
             .map((obj) => _processObject(obj))
-            .filter((obj) => !(0, basics_2.isEmptyObject)(obj));
+            .filter((obj) => !isEmptyObject(obj));
     }
     // Process object
     if (typeof input === 'object' && input !== null) {

package/dist/object/types.js

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

package/dist/string/anagram.js

@@ -1,13 +1,10 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateAnagrams = generateAnagrams;
 /**
  * * Utility to generate unique anagrams of a word.
  * @param word The word for generating anagrams.
  * @param limit The maximum number of anagrams to return ('all' for unlimited). Default is `100`.
  * @returns An array of generated anagrams. The first element is always the given word.
  */
-function generateAnagrams(word, limit = 100) {
+export function generateAnagrams(word, limit = 100) {
     if (word.length <= 1)
         return [word];
     const uniqueAnagrams = new Set();

package/dist/string/basics.js

@@ -1,8 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateRandomID = exports.truncateString = void 0;
-exports.capitalizeString = capitalizeString;
-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.
@@ -11,7 +6,7 @@ exports.trimString = trimString;
  * @param options Options to customize the capitalization.
  * @returns Capitalized string or fully uppercased string depending on `capitalizeAll` option.
  */
-function capitalizeString(string, options) {
+export function capitalizeString(string, options) {
     if (typeof string !== 'string' || !string)
         return '';
     const trimmedString = string.trim();
@@ -48,7 +43,7 @@ function capitalizeString(string, options) {
  * @param maxLength The maximum length of the truncated string.
  * @returns Truncated string with ellipsis (`...`) (only if it has more length than `maxLength`).
  */
-const truncateString = (string, maxLength) => {
+export const truncateString = (string, maxLength) => {
     if (typeof string !== 'string' || !string)
         return '';
     const trimmedString = string.trim();
@@ -58,14 +53,13 @@ const truncateString = (string, maxLength) => {
         return trimmedString;
     return trimmedString.slice(0, maxLength).concat('...');
 };
-exports.truncateString = truncateString;
 /**
  * * Generates a random alphanumeric (16 characters long, this length is customizable in the options) ID string composed of an optional `prefix`, `suffix`, a `timestamp`, `caseOption` and a customizable `separator`.
  *
  * @param options Configuration options for random ID generation.
  * @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) => {
+export const generateRandomID = (options) => {
     const { prefix = '', suffix = '', timeStamp = false, length = 16, separator = '', caseOption = null, } = options || {};
     // generate timestamp
     const date = timeStamp ? Date.now() : '';
@@ -88,14 +82,13 @@ const generateRandomID = (options) => {
             return ID;
     }
 };
-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) {
+export function trimString(input) {
     if (!input)
         return '';
     // If the input is a string, trim each word

package/dist/string/constants.js

@@ -1,7 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LOWERCASE = void 0;
-exports.LOWERCASE = [
+export const LOWERCASE = [
     // Conjunctions
     'and',
     'but',

package/dist/string/convert.js

@@ -1,8 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.replaceAllInString = void 0;
-exports.convertStringCase = convertStringCase;
-const constants_1 = require("./constants");
+import { LOWERCASE } from './constants';
 /**
  * Converts a string to a specified case format such as `camelCase`, `snake_case`, `kebab-case`, `PascalCase`, `Title Case`, `lowercase`, or `UPPERCASE`.
  *
@@ -27,7 +23,7 @@ const constants_1 = require("./constants");
  * convertStringCase('my example string', 'lowercase'); // returns 'my example string'
  * convertStringCase('my example string', 'UPPERCASE'); // returns 'MY EXAMPLE STRING'
  */
-function convertStringCase(string, format) {
+export function convertStringCase(string, format) {
     if (!string || typeof string !== 'string')
         return '';
     const start = string.match(/^[^\d\w\s]+/)?.[0] || '';
@@ -39,7 +35,7 @@ function convertStringCase(string, format) {
         const startSymbol = part.match(/^[^\d\w\s]+/)?.[0] || ''; // Capture leading symbols
         const endSymbol = part.match(/[^\d\w\s]+$/)?.[0] || ''; // Capture trailing symbols
         const coreWord = part.replace(/^[^\d\w\s]+|[^\d\w\s]+$/g, ''); // Remove them for processing
-        if (constants_1.LOWERCASE.includes(coreWord.toLowerCase())) {
+        if (LOWERCASE.includes(coreWord.toLowerCase())) {
             return startSymbol + coreWord.toLowerCase() + endSymbol;
         }
         return (startSymbol +
@@ -98,7 +94,7 @@ function convertStringCase(string, format) {
  * @param replace - The string to replace matches with.
  * @returns The modified/refined string with replacements applied.
  */
-const replaceAllInString = (input, find, replace) => {
+export const replaceAllInString = (input, find, replace) => {
     if (!input)
         return '';
     const trimmedString = input?.trim();
@@ -109,4 +105,3 @@ const replaceAllInString = (input, find, replace) => {
         : new RegExp(find, find.flags.includes('g') ? find.flags : find.flags + 'g');
     return trimmedString?.replace(regex, replace);
 };
-exports.replaceAllInString = replaceAllInString;

package/dist/string/types.js

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

package/dist/types/index.js

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

package/dist/utils/index.js

@@ -1,7 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.throttleAction = exports.debounceAction = exports.convertArrayToString = exports.isDeepEqual = void 0;
-const basics_1 = require("../array/basics");
+import { isInvalidOrEmptyArray } from '../array/basics';
 /**
  * * Deeply compare two values (arrays, objects, or primitive values).
  *
@@ -9,7 +6,7 @@ const basics_1 = require("../array/basics");
  * @param b Second value to compare.
  * @returns Whether the values are deeply equal.
  */
-const isDeepEqual = (a, b) => {
+export const isDeepEqual = (a, b) => {
     // If both values are strictly equal (handles primitive types and same references)
     if (a === b)
         return true;
@@ -23,7 +20,7 @@ const isDeepEqual = (a, b) => {
     if (Array.isArray(a) && Array.isArray(b)) {
         if (a.length !== b.length)
             return false;
-        return a.every((element, index) => (0, exports.isDeepEqual)(element, b[index]));
+        return a.every((element, index) => isDeepEqual(element, b[index]));
     }
     // Check for object equality
     if (typeof a === 'object' && typeof b === 'object') {
@@ -31,11 +28,10 @@ const isDeepEqual = (a, b) => {
         const bKeys = Object.keys(b);
         if (aKeys.length !== bKeys.length)
             return false;
-        return aKeys.every((key) => (0, exports.isDeepEqual)(a[key], b[key]));
+        return aKeys.every((key) => isDeepEqual(a[key], b[key]));
     }
     return false;
 };
-exports.isDeepEqual = isDeepEqual;
 /**
  * * Utility to convert an array to string with custom separator.
  *
@@ -43,13 +39,12 @@ exports.isDeepEqual = isDeepEqual;
  * @param separator Separate each element of the array. Can be `,`, `-`, `|` etc. Default is `,`.
  * @returns Converted array in string format with the separator.
  */
-const convertArrayToString = (array, separator = ',') => {
-    if (!basics_1.isInvalidOrEmptyArray) {
+export const convertArrayToString = (array, separator = ',') => {
+    if (!isInvalidOrEmptyArray) {
         throw new Error('Please, provide a valid array!');
     }
     return array.join(separator);
 };
-exports.convertArrayToString = convertArrayToString;
 /**
  * * A generic debounce function that delays the execution of a callback.
  *
@@ -64,7 +59,7 @@ exports.convertArrayToString = convertArrayToString;
  *
  * debouncedSearch('laptop'); // Executes after 300ms of inactivity.
  */
-const debounceAction = (callback, delay = 300) => {
+export const debounceAction = (callback, delay = 300) => {
     let timeoutId = undefined;
     return (...args) => {
         // Clear the previous timeout
@@ -75,7 +70,6 @@ const debounceAction = (callback, delay = 300) => {
         }, delay);
     };
 };
-exports.debounceAction = debounceAction;
 /**
  * * A generic throttle function that ensures a callback is executed at most once per specified interval.
  *
@@ -90,7 +84,7 @@ exports.debounceAction = debounceAction;
  *
  * window.addEventListener('resize', throttledResize);
  */
-const throttleAction = (callback, delay = 150) => {
+export const throttleAction = (callback, delay = 150) => {
     let lastCall = 0;
     return (...args) => {
         const now = Date.now();
@@ -100,4 +94,3 @@ const throttleAction = (callback, delay = 150) => {
         }
     };
 };
-exports.throttleAction = throttleAction;

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "nhb-toolbox",
-  "version": "2.8.1",
+  "version": "2.8.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",
+  "sideEffects": false,
   "publishConfig": {
     "access": "public"
   },