nhb-toolbox 2.7.5 → 2.8.0

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

@@ -0,0 +1,94 @@
+import type { AsyncFunction, GenericFn } from '../types';
+/**
+ * Type guard to check if a value is an array.
+ * @param value - The value to check.
+ * @returns `true` if the value is an array, otherwise `false`.
+ */
+export declare function isArray<T>(value: unknown): value is Array<T>;
+/**
+ * Type guard to check if a value is an object (excluding null).
+ * @param value - The value to check.
+ * @returns `true` if the value is an object, otherwise `false`.
+ */
+export declare function isObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Type guard to check if a value is a function.
+ * @param value - The value to check.
+ * @returns `true` if the value is a function, otherwise `false`.
+ */
+export declare function isFunction(value: unknown): value is GenericFn;
+/**
+ * Type guard to check if a value is a Date object.
+ * @param value - The value to check.
+ * @returns `true` if the value is a Date object, otherwise `false`.
+ */
+export declare function isDate(value: unknown): value is Date;
+/**
+ * Type guard to check if a value is an object with specific keys.
+ * @param value - The value to check.
+ * @param keys - The set of keys the object should contain.
+ * @returns `true` if the value is an object with the specified keys, otherwise `false`.
+ */
+export declare function isObjectWithKeys<T extends Record<string, unknown>>(value: unknown, keys: (keyof T)[]): value is T;
+/**
+ * Type guard to check if a value is an empty object.
+ * @param value - The value to check.
+ * @returns `true` if the value is an empty object, otherwise `false`.
+ */
+export declare function isEmptyObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Type guard to check if a value is an array of a specific type.
+ * @param value - The value to check.
+ * @param typeCheck - The type guard function to check each item of the array.
+ * @returns `true` if the value is an array of the specified type, otherwise `false`.
+ */
+export declare function isArrayOfType<T>(value: unknown, typeCheck: (item: unknown) => item is T): value is T[];
+/**
+ * Type guard to check if a value is a Promise.
+ * @param value - The value to check.
+ * @returns `true` if the value is a Promise, otherwise `false`.
+ */
+export declare function isPromise(value: unknown): value is Promise<unknown>;
+/**
+ * Type guard to check if a value is a Set.
+ * @param value - The value to check.
+ * @returns `true` if the value is a Set, otherwise `false`.
+ */
+export declare function isSet<T>(value: unknown): value is Set<T>;
+/**
+ * Type guard to check if a value is a Map.
+ * @param value - The value to check.
+ * @returns `true` if the value is a Map, otherwise `false`.
+ */
+export declare function isMap<K, V>(value: unknown): value is Map<K, V>;
+/**
+ * Type guard to check if a value is a RegExp.
+ * @param value - The value to check.
+ * @returns `true` if the value is a RegExp, otherwise `false`.
+ */
+export declare function isRegExp(value: unknown): value is RegExp;
+/**
+ * Type guard to check if a value is an Error object.
+ * @param value - The value to check.
+ * @returns `true` if the value is an Error object, otherwise `false`.
+ */
+export declare function isError(value: unknown): value is Error;
+/**
+ * Type guard to check if a value is a BigInt.
+ * @param value - The value to check.
+ * @returns `true` if the value is a BigInt, otherwise `false`.
+ */
+export declare function isBigInt(value: unknown): value is bigint;
+/**
+ * Type guard to check if a string is valid JSON.
+ * @param value - The value to check.
+ * @returns `true` if the value is valid JSON, otherwise `false`.
+ */
+export declare function isJSON(value: unknown): value is string;
+/**
+ * Type guard to check if a function returns a Promise.
+ * @param fn - The function to check.
+ * @returns `true` if the function returns a Promise, otherwise `false`.
+ */
+export declare function isReturningPromise<T>(fn: unknown): fn is AsyncFunction<T>;
+//# sourceMappingURL=non-primitives.d.ts.map

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

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

package/dist/guards/non-primitives.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isArray = isArray;
+exports.isObject = isObject;
+exports.isFunction = isFunction;
+exports.isDate = isDate;
+exports.isObjectWithKeys = isObjectWithKeys;
+exports.isEmptyObject = isEmptyObject;
+exports.isArrayOfType = isArrayOfType;
+exports.isPromise = isPromise;
+exports.isSet = isSet;
+exports.isMap = isMap;
+exports.isRegExp = isRegExp;
+exports.isError = isError;
+exports.isBigInt = isBigInt;
+exports.isJSON = isJSON;
+exports.isReturningPromise = isReturningPromise;
+const primitives_1 = require("./primitives");
+/**
+ * Type guard to check if a value is an array.
+ * @param value - The value to check.
+ * @returns `true` if the value is an array, otherwise `false`.
+ */
+function isArray(value) {
+    return Array.isArray(value);
+}
+/**
+ * Type guard to check if a value is an object (excluding null).
+ * @param value - The value to check.
+ * @returns `true` if the value is an object, otherwise `false`.
+ */
+function isObject(value) {
+    return value !== null && typeof value === 'object' && !isArray(value);
+}
+/**
+ * Type guard to check if a value is a function.
+ * @param value - The value to check.
+ * @returns `true` if the value is a function, otherwise `false`.
+ */
+function isFunction(value) {
+    return typeof value === 'function';
+}
+/**
+ * Type guard to check if a value is a Date object.
+ * @param value - The value to check.
+ * @returns `true` if the value is a Date object, otherwise `false`.
+ */
+function isDate(value) {
+    return value instanceof Date;
+}
+/**
+ * Type guard to check if a value is an object with specific keys.
+ * @param value - The value to check.
+ * @param keys - The set of keys the object should contain.
+ * @returns `true` if the value is an object with the specified keys, otherwise `false`.
+ */
+function isObjectWithKeys(value, keys) {
+    return isObject(value) && keys.every((key) => key in value);
+}
+/**
+ * Type guard to check if a value is an empty object.
+ * @param value - The value to check.
+ * @returns `true` if the value is an empty object, otherwise `false`.
+ */
+function isEmptyObject(value) {
+    return isObject(value) && Object.keys(value).length === 0;
+}
+/**
+ * Type guard to check if a value is an array of a specific type.
+ * @param value - The value to check.
+ * @param typeCheck - The type guard function to check each item of the array.
+ * @returns `true` if the value is an array of the specified type, otherwise `false`.
+ */
+function isArrayOfType(value, typeCheck) {
+    return isArray(value) && value.every(typeCheck);
+}
+/**
+ * Type guard to check if a value is a Promise.
+ * @param value - The value to check.
+ * @returns `true` if the value is a Promise, otherwise `false`.
+ */
+function isPromise(value) {
+    return isObject(value) && isFunction(value.then);
+}
+/**
+ * Type guard to check if a value is a Set.
+ * @param value - The value to check.
+ * @returns `true` if the value is a Set, otherwise `false`.
+ */
+function isSet(value) {
+    return value instanceof Set;
+}
+/**
+ * Type guard to check if a value is a Map.
+ * @param value - The value to check.
+ * @returns `true` if the value is a Map, otherwise `false`.
+ */
+function isMap(value) {
+    return value instanceof Map;
+}
+/**
+ * Type guard to check if a value is a RegExp.
+ * @param value - The value to check.
+ * @returns `true` if the value is a RegExp, otherwise `false`.
+ */
+function isRegExp(value) {
+    return value instanceof RegExp;
+}
+/**
+ * Type guard to check if a value is an Error object.
+ * @param value - The value to check.
+ * @returns `true` if the value is an Error object, otherwise `false`.
+ */
+function isError(value) {
+    return value instanceof Error;
+}
+/**
+ * Type guard to check if a value is a BigInt.
+ * @param value - The value to check.
+ * @returns `true` if the value is a BigInt, otherwise `false`.
+ */
+function isBigInt(value) {
+    return typeof value === 'bigint';
+}
+/**
+ * Type guard to check if a string is valid JSON.
+ * @param value - The value to check.
+ * @returns `true` if the value is valid JSON, otherwise `false`.
+ */
+function isJSON(value) {
+    if (!(0, primitives_1.isString)(value))
+        return false;
+    try {
+        JSON.parse(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Type guard to check if a function returns a Promise.
+ * @param fn - The function to check.
+ * @returns `true` if the function returns a Promise, otherwise `false`.
+ */
+function isReturningPromise(fn) {
+    return isFunction(fn) && fn.constructor.name === 'AsyncFunction';
+}

package/dist/guards/primitives.d.ts

@@ -0,0 +1,74 @@
+import type { FalsyPrimitive } from '../types';
+/**
+ * Type guard to check if a value is a number.
+ * @param value - The value to check.
+ * @returns `true` if the value is a number, otherwise `false`.
+ */
+export declare function isNumber(value: unknown): value is number;
+/**
+ * Type guard to check if a value is a string.
+ * @param value - The value to check.
+ * @returns `true` if the value is a string, otherwise `false`.
+ */
+export declare function isString(value: unknown): value is string;
+/**
+ * Type guard to check if a value is an integer.
+ * @param value - The value to check.
+ * @returns `true` if the value is an integer, otherwise `false`.
+ */
+export declare function isInteger(value: unknown): value is number;
+/**
+ * Type guard to check if a value is a positive integer.
+ * @param value - The value to check.
+ * @returns `true` if the value is a positive integer, otherwise `false`.
+ */
+export declare function isPositiveInteger(value: unknown): value is number;
+/**
+ * Type guard to check if a value is a boolean.
+ * @param value - The value to check.
+ * @returns `true` if the value is a boolean, otherwise `false`.
+ */
+export declare function isBoolean(value: unknown): value is boolean;
+/**
+ * Type guard to check if a value is null.
+ * @param value - The value to check.
+ * @returns `true` if the value is null, otherwise `false`.
+ */
+export declare function isNull(value: unknown): value is null;
+/**
+ * Type guard to check if a value is undefined.
+ * @param value - The value to check.
+ * @returns `true` if the value is undefined, otherwise `false`.
+ */
+export declare function isUndefined(value: unknown): value is undefined;
+/**
+ * Type guard to check if a value is a symbol.
+ * @param value - The value to check.
+ * @returns `true` if the value is a symbol, otherwise `false`.
+ */
+export declare function isSymbol(value: unknown): value is symbol;
+/**
+ * Type guard to check if a value is a primitive.
+ * @param value - The value to check.
+ * @returns `true` if the value is a primitive, otherwise `false`.
+ */
+export declare function isPrimitive(value: unknown): value is string | number | boolean | symbol | null | undefined;
+/**
+ * Type guard to check if a value is a non-empty string.
+ * @param value - The value to check.
+ * @returns `true` if the value is a non-empty string, otherwise `false`.
+ */
+export declare function isNonEmptyString(value: unknown): value is string;
+/**
+ * Type guard to check if a value is falsy.
+ * @param value - The value to check.
+ * @returns `true` if the value is falsy, otherwise `false`.
+ */
+export declare function isFalsy(value: unknown): value is FalsyPrimitive;
+/**
+ * Type guard to check if a value is truthy.
+ * @param value - The value to check.
+ * @returns `true` if the value is truthy (not null or undefined), otherwise `false`.
+ */
+export declare function isTruthy<T>(value: T): value is Exclude<T, FalsyPrimitive>;
+//# sourceMappingURL=primitives.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../src/guards/primitives.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAC1B,KAAK,EAAE,OAAO,GACZ,KAAK,IAAI,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAOhE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,IAAI,OAAO,CAAC,CAAC,EAAE,cAAc,CAAC,CAEzE"}

package/dist/guards/primitives.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isNumber = isNumber;
+exports.isString = isString;
+exports.isInteger = isInteger;
+exports.isPositiveInteger = isPositiveInteger;
+exports.isBoolean = isBoolean;
+exports.isNull = isNull;
+exports.isUndefined = isUndefined;
+exports.isSymbol = isSymbol;
+exports.isPrimitive = isPrimitive;
+exports.isNonEmptyString = isNonEmptyString;
+exports.isFalsy = isFalsy;
+exports.isTruthy = isTruthy;
+/**
+ * Type guard to check if a value is a number.
+ * @param value - The value to check.
+ * @returns `true` if the value is a number, otherwise `false`.
+ */
+function isNumber(value) {
+    return typeof value === 'number' && !isNaN(value);
+}
+/**
+ * Type guard to check if a value is a string.
+ * @param value - The value to check.
+ * @returns `true` if the value is a string, otherwise `false`.
+ */
+function isString(value) {
+    return typeof value === 'string';
+}
+/**
+ * Type guard to check if a value is an integer.
+ * @param value - The value to check.
+ * @returns `true` if the value is an integer, otherwise `false`.
+ */
+function isInteger(value) {
+    return isNumber(value) && Number.isInteger(value);
+}
+/**
+ * Type guard to check if a value is a positive integer.
+ * @param value - The value to check.
+ * @returns `true` if the value is a positive integer, otherwise `false`.
+ */
+function isPositiveInteger(value) {
+    return isInteger(value) && value > 0;
+}
+/**
+ * Type guard to check if a value is a boolean.
+ * @param value - The value to check.
+ * @returns `true` if the value is a boolean, otherwise `false`.
+ */
+function isBoolean(value) {
+    return typeof value === 'boolean';
+}
+/**
+ * Type guard to check if a value is null.
+ * @param value - The value to check.
+ * @returns `true` if the value is null, otherwise `false`.
+ */
+function isNull(value) {
+    return value === null;
+}
+/**
+ * Type guard to check if a value is undefined.
+ * @param value - The value to check.
+ * @returns `true` if the value is undefined, otherwise `false`.
+ */
+function isUndefined(value) {
+    return value === undefined;
+}
+/**
+ * Type guard to check if a value is a symbol.
+ * @param value - The value to check.
+ * @returns `true` if the value is a symbol, otherwise `false`.
+ */
+function isSymbol(value) {
+    return typeof value === 'symbol';
+}
+/**
+ * Type guard to check if a value is a primitive.
+ * @param value - The value to check.
+ * @returns `true` if the value is a primitive, otherwise `false`.
+ */
+function isPrimitive(value) {
+    return (value === null ||
+        ['string', 'number', 'boolean', 'symbol', 'undefined'].includes(typeof value));
+}
+/**
+ * Type guard to check if a value is a non-empty string.
+ * @param value - The value to check.
+ * @returns `true` if the value is a non-empty string, otherwise `false`.
+ */
+function isNonEmptyString(value) {
+    return isString(value) && value?.trim().length > 0;
+}
+/**
+ * Type guard to check if a value is falsy.
+ * @param value - The value to check.
+ * @returns `true` if the value is falsy, otherwise `false`.
+ */
+function isFalsy(value) {
+    return !value;
+}
+/**
+ * Type guard to check if a value is truthy.
+ * @param value - The value to check.
+ * @returns `true` if the value is truthy (not null or undefined), otherwise `false`.
+ */
+function isTruthy(value) {
+    return Boolean(value);
+}

package/dist/guards/specials.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Type guard to check if a value is a valid email string.
+ * @param value - The value to check.
+ * @returns `true` if the value is a valid email, otherwise `false`.
+ */
+export declare function isEmail(value: unknown): value is string;
+/**
+ * Type guard to check if a value is an array of valid email strings.
+ * @param value - The value to check.
+ * @returns `true` if the value is an array of valid email strings, otherwise `false`.
+ */
+export declare function isEmailArray(value: unknown): value is string[];
+/**
+ * Type guard to check if a value is a valid date string.
+ * @param value - The value to check.
+ * @returns `true` if the value is a valid date string, otherwise `false`.
+ */
+export declare function isDateString(value: unknown): value is string;
+/**
+ * Type guard to check if a value is a valid UUID (v4).
+ * @param value - The value to check.
+ * @returns `true` if the value is a valid UUID, otherwise `false`.
+ */
+export declare function isUUID(value: unknown): value is string;
+/**
+ * Type guard to check if the code is running in a browser environment.
+ * @returns `true` if the code is running in a browser, otherwise `false`.
+ */
+export declare function isBrowser(): boolean;
+/**
+ * Type guard to check if the code is running in a Node.js environment.
+ * @returns `true` if the code is running in Node.js, otherwise `false`.
+ */
+export declare function isNode(): boolean;
+/**
+ * Type guard to check if a value is a valid URL.
+ * @param value - The value to check.
+ * @returns `true` if the value is a valid URL, otherwise `false`.
+ */
+export declare function isURL(value: unknown): value is string;
+/**
+ * Type guard to check if a value is a valid Base64 encoded string.
+ * @param value - The value to check.
+ * @returns `true` if the value is a valid Base64 string, otherwise `false`.
+ */
+export declare function isBase64(value: unknown): value is string;
+/**
+ * Type guard to check if a value is a valid phone number.
+ * @param value - The value to check.
+ * @returns `true` if the value is a valid phone number, otherwise `false`.
+ */
+export declare function isPhoneNumber(value: unknown): value is string;
+/**
+ * Type guard to check if a value is a valid IP address (IPv4 or IPv6).
+ * @param value - The value to check.
+ * @returns `true` if the value is a valid IP address, otherwise `false`.
+ */
+export declare function isIPAddress(value: unknown): value is string;
+/**
+ * Type guard to check if the current environment matches a given string.
+ * @param env - The expected environment (e.g., "production", "development").
+ * @returns `true` if the current environment matches, otherwise `false`.
+ */
+export declare function isEnvironment(env: string): boolean;
+/**
+ * Type guard to check if a value is a numeric string.
+ * @param value - The value to check.
+ * @returns `true` if the value is a numeric string, otherwise `false`.
+ */
+export declare function isNumericString(value: unknown): value is `${number}`;
+//# sourceMappingURL=specials.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"specials.d.ts","sourceRoot":"","sources":["../../src/guards/specials.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAKvD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,EAAE,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAOtD;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;;GAGG;AACH,wBAAgB,MAAM,IAAI,OAAO,CAMhC;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAOrD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAOxD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAK3D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,GAAG,MAAM,EAAE,CAEpE"}

package/dist/guards/specials.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isEmail = isEmail;
+exports.isEmailArray = isEmailArray;
+exports.isDateString = isDateString;
+exports.isUUID = isUUID;
+exports.isBrowser = isBrowser;
+exports.isNode = isNode;
+exports.isURL = isURL;
+exports.isBase64 = isBase64;
+exports.isPhoneNumber = isPhoneNumber;
+exports.isIPAddress = isIPAddress;
+exports.isEnvironment = isEnvironment;
+exports.isNumericString = isNumericString;
+const non_primitives_1 = require("./non-primitives");
+const primitives_1 = require("./primitives");
+/**
+ * Type guard to check if a value is a valid email string.
+ * @param value - The value to check.
+ * @returns `true` if the value is a valid email, otherwise `false`.
+ */
+function isEmail(value) {
+    return ((0, primitives_1.isString)(value) &&
+        /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/.test(value));
+}
+/**
+ * Type guard to check if a value is an array of valid email strings.
+ * @param value - The value to check.
+ * @returns `true` if the value is an array of valid email strings, otherwise `false`.
+ */
+function isEmailArray(value) {
+    return (0, non_primitives_1.isArray)(value) && value.every(isEmail);
+}
+/**
+ * Type guard to check if a value is a valid date string.
+ * @param value - The value to check.
+ * @returns `true` if the value is a valid date string, otherwise `false`.
+ */
+function isDateString(value) {
+    return (0, primitives_1.isString)(value) && !isNaN(Date.parse(value));
+}
+/**
+ * Type guard to check if a value is a valid UUID (v4).
+ * @param value - The value to check.
+ * @returns `true` if the value is a valid UUID, otherwise `false`.
+ */
+function isUUID(value) {
+    return ((0, primitives_1.isString)(value) &&
+        /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value));
+}
+/**
+ * Type guard to check if the code is running in a browser environment.
+ * @returns `true` if the code is running in a browser, otherwise `false`.
+ */
+function isBrowser() {
+    return typeof window !== 'undefined' && typeof document !== 'undefined';
+}
+/**
+ * Type guard to check if the code is running in a Node.js environment.
+ * @returns `true` if the code is running in Node.js, otherwise `false`.
+ */
+function isNode() {
+    return (typeof process !== 'undefined' &&
+        process.versions != null &&
+        process.versions.node != null);
+}
+/**
+ * Type guard to check if a value is a valid URL.
+ * @param value - The value to check.
+ * @returns `true` if the value is a valid URL, otherwise `false`.
+ */
+function isURL(value) {
+    try {
+        new URL((0, primitives_1.isString)(value) ? value : '');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Type guard to check if a value is a valid Base64 encoded string.
+ * @param value - The value to check.
+ * @returns `true` if the value is a valid Base64 string, otherwise `false`.
+ */
+function isBase64(value) {
+    return ((0, primitives_1.isString)(value) &&
+        /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.test(value));
+}
+/**
+ * Type guard to check if a value is a valid phone number.
+ * @param value - The value to check.
+ * @returns `true` if the value is a valid phone number, otherwise `false`.
+ */
+function isPhoneNumber(value) {
+    return (0, primitives_1.isString)(value) && /^\+?[1-9]\d{1,14}$/.test(value);
+}
+/**
+ * Type guard to check if a value is a valid IP address (IPv4 or IPv6).
+ * @param value - The value to check.
+ * @returns `true` if the value is a valid IP address, otherwise `false`.
+ */
+function isIPAddress(value) {
+    return ((0, primitives_1.isString)(value) &&
+        /^(?:\d{1,3}\.){3}\d{1,3}$|^([a-f0-9:]+:+)+[a-f0-9]+$/i.test(value));
+}
+/**
+ * Type guard to check if the current environment matches a given string.
+ * @param env - The expected environment (e.g., "production", "development").
+ * @returns `true` if the current environment matches, otherwise `false`.
+ */
+function isEnvironment(env) {
+    return process.env.NODE_ENV === env;
+}
+/**
+ * Type guard to check if a value is a numeric string.
+ * @param value - The value to check.
+ * @returns `true` if the value is a numeric string, otherwise `false`.
+ */
+function isNumericString(value) {
+    return (0, primitives_1.isString)(value) && /^\d+(\.\d+)?$/.test(value);
+}

package/dist/index.d.ts

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

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACN,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,cAAc,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGzE,OAAO,EACN,YAAY,IAAI,YAAY,EAC5B,YAAY,EACZ,YAAY,IAAI,YAAY,EAC5B,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,MAAM,EACN,UAAU,EACV,KAAK,GACL,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EACN,2BAA2B,EAC3B,sBAAsB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,gBAAgB,GAChB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGvC,OAAO,EACN,oBAAoB,EACpB,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,IAAI,iBAAiB,EAC1C,YAAY,GACZ,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EACN,kBAAkB,EAClB,yBAAyB,GACzB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAG5D,OAAO,EACN,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,QAAQ,GACR,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,gBAAgB,EAChB,0BAA0B,EAC1B,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,YAAY,GACZ,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,EACN,oBAAoB,EACpB,cAAc,EACd,WAAW,EACX,cAAc,GACd,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createControlledFormData = exports.isEmptyFormData = exports.convertIntoFormData = exports.removeDuplicatesFromArray = exports.createOptionsArray = exports.sortAnArray = exports.shuffleArray = exports.isValidEmptyArray = exports.isInvalidOrEmptyArray = exports.getLastArrayElement = exports.flattenArray = exports.filterArrayOfObjects = exports.Color = exports.convertRgbToRgba = exports.convertRgbToHsl = exports.convertRgbToHex = exports.convertRgbaToHsla = exports.convertRgbaToHex8 = exports.convertHslToRgb = exports.convertHslToHex = exports.convertHslaToRgba = exports.convertHslaToHex8 = exports.convertHexToRgb = exports.convertHexToHsl = exports.convertHex8ToRgba = exports.convertHex8ToHsla = exports.convertColorCode = exports.generateRandomHSLColor = exports.generateRandomColorInHexRGB = exports.getColorForInitial = exports.getNumbersInRange = exports.isPrime = exports.findPrimeNumbers = exports.numberToWords = exports.isOdd = exports.isMultiple = exports.isEven = exports.getRandomNumber = exports.convertToDecimal = exports.calculateLCM = exports.calculateLCD = exports.calculateHCF = exports.calculateGCD = exports.replaceAllInString = exports.convertStringCase = exports.generateAnagrams = exports.truncateString = exports.trimString = exports.generateRandomID = exports.capitalizeString = void 0;
-exports.throttleAction = exports.isDeepEqual = exports.debounceAction = exports.convertArrayToString = exports.convertObjectValues = exports.sanitizeData = exports.mergeObjects = exports.mergeAndFlattenObjects = exports.flattenObjectKeyValue = exports.flattenObjectDotNotation = exports.extractUpdatedFields = exports.extractUpdatedAndNewFields = exports.extractNewFields = exports.isObject = exports.isEmptyObject = exports.generateQueryParams = exports.countObjectFields = exports.cloneObject = void 0;
+exports.isReturningPromise = exports.isRegExp = exports.isPromise = exports.isObjectWithKeys = exports.isObjectEmpty = exports.isValidMap = exports.isMap = exports.isJSONObject = exports.isValidJSON = exports.isJSON = exports.isFunction = exports.isError = exports.isDate = exports.isBigInt = exports.isArrayOfType = exports.isArray = exports.isUndefined = exports.isTruthy = exports.isSymbol = exports.isString = exports.isPrimitive = exports.isPositiveInteger = exports.isNumber = exports.isNull = exports.isNonEmptyString = exports.isInteger = exports.isFalsy = exports.isBoolean = exports.throttleAction = exports.isDeepEqual = exports.debounceAction = exports.convertArrayToString = exports.convertObjectValues = exports.sanitizeData = exports.mergeObjects = exports.mergeAndFlattenObjects = exports.flattenObjectKeyValue = exports.flattenObjectDotNotation = exports.extractUpdatedFields = exports.extractUpdatedAndNewFields = exports.extractNewFields = exports.isObject = exports.isEmptyObject = exports.generateQueryParams = exports.countObjectFields = exports.cloneObject = exports.isOriginFileObj = exports.isFileUpload = exports.isCustomFileArray = exports.isCustomFile = void 0;
+exports.isValidURL = exports.isURL = exports.isPhoneNumber = exports.isNumericString = exports.isNode = exports.isIPAddress = exports.isEnvironment = exports.isBase64 = exports.isUUID = exports.isEmailArray = exports.isValidEmail = exports.isEmail = exports.isDateString = exports.isBrowser = exports.isValidObject = exports.isValidSet = exports.isSet = void 0;
 // ! String Utilities
 var basics_1 = require("./string/basics");
 Object.defineProperty(exports, "capitalizeString", { enumerable: true, get: function () { return basics_1.capitalizeString; } });
@@ -73,6 +74,11 @@ Object.defineProperty(exports, "convertIntoFormData", { enumerable: true, get: f
 Object.defineProperty(exports, "isEmptyFormData", { enumerable: true, get: function () { return convert_4.isEmptyFormData; } });
 var transform_2 = require("./form/transform");
 Object.defineProperty(exports, "createControlledFormData", { enumerable: true, get: function () { return transform_2.createControlledFormData; } });
+var guards_1 = require("./form/guards");
+Object.defineProperty(exports, "isCustomFile", { enumerable: true, get: function () { return guards_1.isCustomFile; } });
+Object.defineProperty(exports, "isCustomFileArray", { enumerable: true, get: function () { return guards_1.isCustomFileArray; } });
+Object.defineProperty(exports, "isFileUpload", { enumerable: true, get: function () { return guards_1.isFileUpload; } });
+Object.defineProperty(exports, "isOriginFileObj", { enumerable: true, get: function () { return guards_1.isOriginFileObj; } });
 // ! Object Utilities
 var basics_4 = require("./object/basics");
 Object.defineProperty(exports, "cloneObject", { enumerable: true, get: function () { return basics_4.cloneObject; } });
@@ -98,3 +104,54 @@ Object.defineProperty(exports, "convertArrayToString", { enumerable: true, get:
 Object.defineProperty(exports, "debounceAction", { enumerable: true, get: function () { return utils_1.debounceAction; } });
 Object.defineProperty(exports, "isDeepEqual", { enumerable: true, get: function () { return utils_1.isDeepEqual; } });
 Object.defineProperty(exports, "throttleAction", { enumerable: true, get: function () { return utils_1.throttleAction; } });
+// ! Primitive Type Guards
+var primitives_1 = require("./guards/primitives");
+Object.defineProperty(exports, "isBoolean", { enumerable: true, get: function () { return primitives_1.isBoolean; } });
+Object.defineProperty(exports, "isFalsy", { enumerable: true, get: function () { return primitives_1.isFalsy; } });
+Object.defineProperty(exports, "isInteger", { enumerable: true, get: function () { return primitives_1.isInteger; } });
+Object.defineProperty(exports, "isNonEmptyString", { enumerable: true, get: function () { return primitives_1.isNonEmptyString; } });
+Object.defineProperty(exports, "isNull", { enumerable: true, get: function () { return primitives_1.isNull; } });
+Object.defineProperty(exports, "isNumber", { enumerable: true, get: function () { return primitives_1.isNumber; } });
+Object.defineProperty(exports, "isPositiveInteger", { enumerable: true, get: function () { return primitives_1.isPositiveInteger; } });
+Object.defineProperty(exports, "isPrimitive", { enumerable: true, get: function () { return primitives_1.isPrimitive; } });
+Object.defineProperty(exports, "isString", { enumerable: true, get: function () { return primitives_1.isString; } });
+Object.defineProperty(exports, "isSymbol", { enumerable: true, get: function () { return primitives_1.isSymbol; } });
+Object.defineProperty(exports, "isTruthy", { enumerable: true, get: function () { return primitives_1.isTruthy; } });
+Object.defineProperty(exports, "isUndefined", { enumerable: true, get: function () { return primitives_1.isUndefined; } });
+// ! Non-Primitive Type Guards
+var non_primitives_1 = require("./guards/non-primitives");
+Object.defineProperty(exports, "isArray", { enumerable: true, get: function () { return non_primitives_1.isArray; } });
+Object.defineProperty(exports, "isArrayOfType", { enumerable: true, get: function () { return non_primitives_1.isArrayOfType; } });
+Object.defineProperty(exports, "isBigInt", { enumerable: true, get: function () { return non_primitives_1.isBigInt; } });
+Object.defineProperty(exports, "isDate", { enumerable: true, get: function () { return non_primitives_1.isDate; } });
+Object.defineProperty(exports, "isError", { enumerable: true, get: function () { return non_primitives_1.isError; } });
+Object.defineProperty(exports, "isFunction", { enumerable: true, get: function () { return non_primitives_1.isFunction; } });
+Object.defineProperty(exports, "isJSON", { enumerable: true, get: function () { return non_primitives_1.isJSON; } });
+Object.defineProperty(exports, "isValidJSON", { enumerable: true, get: function () { return non_primitives_1.isJSON; } });
+Object.defineProperty(exports, "isJSONObject", { enumerable: true, get: function () { return non_primitives_1.isJSON; } });
+Object.defineProperty(exports, "isMap", { enumerable: true, get: function () { return non_primitives_1.isMap; } });
+Object.defineProperty(exports, "isValidMap", { enumerable: true, get: function () { return non_primitives_1.isMap; } });
+Object.defineProperty(exports, "isObjectEmpty", { enumerable: true, get: function () { return non_primitives_1.isEmptyObject; } });
+Object.defineProperty(exports, "isObjectWithKeys", { enumerable: true, get: function () { return non_primitives_1.isObjectWithKeys; } });
+Object.defineProperty(exports, "isPromise", { enumerable: true, get: function () { return non_primitives_1.isPromise; } });
+Object.defineProperty(exports, "isRegExp", { enumerable: true, get: function () { return non_primitives_1.isRegExp; } });
+Object.defineProperty(exports, "isReturningPromise", { enumerable: true, get: function () { return non_primitives_1.isReturningPromise; } });
+Object.defineProperty(exports, "isSet", { enumerable: true, get: function () { return non_primitives_1.isSet; } });
+Object.defineProperty(exports, "isValidSet", { enumerable: true, get: function () { return non_primitives_1.isSet; } });
+Object.defineProperty(exports, "isValidObject", { enumerable: true, get: function () { return non_primitives_1.isObject; } });
+// ! Special Type Guards
+var specials_1 = require("./guards/specials");
+Object.defineProperty(exports, "isBrowser", { enumerable: true, get: function () { return specials_1.isBrowser; } });
+Object.defineProperty(exports, "isDateString", { enumerable: true, get: function () { return specials_1.isDateString; } });
+Object.defineProperty(exports, "isEmail", { enumerable: true, get: function () { return specials_1.isEmail; } });
+Object.defineProperty(exports, "isValidEmail", { enumerable: true, get: function () { return specials_1.isEmail; } });
+Object.defineProperty(exports, "isEmailArray", { enumerable: true, get: function () { return specials_1.isEmailArray; } });
+Object.defineProperty(exports, "isUUID", { enumerable: true, get: function () { return specials_1.isUUID; } });
+Object.defineProperty(exports, "isBase64", { enumerable: true, get: function () { return specials_1.isBase64; } });
+Object.defineProperty(exports, "isEnvironment", { enumerable: true, get: function () { return specials_1.isEnvironment; } });
+Object.defineProperty(exports, "isIPAddress", { enumerable: true, get: function () { return specials_1.isIPAddress; } });
+Object.defineProperty(exports, "isNode", { enumerable: true, get: function () { return specials_1.isNode; } });
+Object.defineProperty(exports, "isNumericString", { enumerable: true, get: function () { return specials_1.isNumericString; } });
+Object.defineProperty(exports, "isPhoneNumber", { enumerable: true, get: function () { return specials_1.isPhoneNumber; } });
+Object.defineProperty(exports, "isURL", { enumerable: true, get: function () { return specials_1.isURL; } });
+Object.defineProperty(exports, "isValidURL", { enumerable: true, get: function () { return specials_1.isURL; } });

package/dist/types/index.d.ts

@@ -21,11 +21,17 @@ export type PrimitiveKey<T> = {
 export type NonNullishPrimitiveKey<T> = {
     [K in keyof T]: T[K] extends string | number | boolean ? K : never;
 }[keyof T];
+/** Falsy primitive type  */
+export type FalsyPrimitive = false | 0 | '' | null | undefined;
 /** Generic function type */
-export type GenericFn = (...args: any[]) => void;
+export type GenericFn = (...args: unknown[]) => unknown;
+/** Generic function type that returns `void` */
+export type VoidFunction = (...args: any[]) => void;
 /** Debounced function type after certain delay */
-export type DelayedFn<T extends GenericFn> = (...args: Parameters<T>) => void;
+export type DelayedFn<T extends VoidFunction> = (...args: Parameters<T>) => void;
 /** Throttled function type after specific delay */
-export type ThrottledFn<T extends GenericFn> = (...args: Parameters<T>) => void;
+export type ThrottledFn<T extends VoidFunction> = (...args: Parameters<T>) => void;
+/** Asynchronous function type */
+export type AsyncFunction<T> = (...args: unknown[]) => Promise<T>;
 export {};
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/utils/index.d.ts

@@ -1,4 +1,4 @@
-import type { DelayedFn, GenericFn, ThrottledFn } from '../types';
+import type { DelayedFn, ThrottledFn, VoidFunction } from '../types';
 /**
  * * Deeply compare two values (arrays, objects, or primitive values).
  *
@@ -29,7 +29,7 @@ export declare const convertArrayToString: <T>(array: T[], separator?: string) =
  *
  * debouncedSearch('laptop'); // Executes after 300ms of inactivity.
  */
-export declare const debounceAction: <T extends GenericFn>(callback: T, delay?: number) => DelayedFn<T>;
+export declare const debounceAction: <T extends VoidFunction>(callback: T, delay?: number) => DelayedFn<T>;
 /**
  * * A generic throttle function that ensures a callback is executed at most once per specified interval.
  *
@@ -44,5 +44,5 @@ export declare const debounceAction: <T extends GenericFn>(callback: T, delay?:
  *
  * window.addEventListener('resize', throttledResize);
  */
-export declare const throttleAction: <T extends GenericFn>(callback: T, delay?: number) => ThrottledFn<T>;
+export declare const throttleAction: <T extends VoidFunction>(callback: T, delay?: number) => ThrottledFn<T>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAElE;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAG,OA6B3C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAC9B,CAAC,EAAE,cACC,MAAM,KACf,MAKF,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,SAAS,YACvC,CAAC,qBAET,SAAS,CAAC,CAAC,CAYb,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,SAAS,YACvC,CAAC,qBAET,WAAW,CAAC,CAAC,CAWf,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAErE;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAG,OA6B3C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAC9B,CAAC,EAAE,cACC,MAAM,KACf,MAKF,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,YAAY,YAC1C,CAAC,qBAET,SAAS,CAAC,CAAC,CAYb,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,YAAY,YAC1C,CAAC,qBAET,WAAW,CAAC,CAAC,CAWf,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "2.7.5",
+  "version": "2.8.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",