nhb-toolbox 4.10.51 → 4.10.52

package/dist/cjs/array/Finder.js

@@ -130,8 +130,8 @@ class Finder {
             }
         }
         let result;
-        if (source.length < 100 && !forceBinary) {
-            result = source.find((item) => {
+        if (source?.length < 100 && !forceBinary) {
+            result = source?.find((item) => {
                 const key = getKey(item);
                 const value = caseInsensitive && typeof key === 'string' ?
                     key.toLowerCase()
@@ -187,7 +187,7 @@ class Finder {
      * @returns The first matching item if found; otherwise, undefined.
      */
     binarySearch(sorted, matcher, keySelector, caseInsensitive) {
-        let min = 0, max = sorted.length - 1;
+        let min = 0, max = sorted?.length - 1;
         while (min <= max) {
             const mid = Math.floor((min + max) / 2);
             const midKey = keySelector(sorted[mid]);
@@ -232,7 +232,7 @@ class Finder {
     #match(source, target) {
         let i = 0;
         for (const char of target) {
-            i = source.indexOf(char, i);
+            i = source?.indexOf(char, i);
             if (i === -1)
                 return false;
             i++;

package/dist/cjs/array/basics.js

@@ -30,7 +30,7 @@ const filterArrayOfObjects = (array, conditions) => {
     if (!Array.isArray(array)) {
         throw new Error('The provided input is not a valid array!');
     }
-    return array.filter((item) => Object.entries(conditions).every(([key, conditionFn]) => {
+    return array?.filter((item) => Object.entries(conditions)?.every(([key, conditionFn]) => {
         if (typeof conditionFn === 'function') {
             return conditionFn(item[key]);
         }
@@ -47,11 +47,11 @@ exports.filterArrayOfObjects = filterArrayOfObjects;
 const isInvalidOrEmptyArray = (value) => {
     if (!Array.isArray(value))
         return true;
-    if (value.length === 0)
+    if (value?.length === 0)
         return true;
-    return value.every((item) => item == null ||
-        (Array.isArray(item) && item.length === 0) ||
-        (typeof item === 'object' && Object.keys(item || {}).length === 0));
+    return value?.every((item) => item == null ||
+        (Array.isArray(item) && item?.length === 0) ||
+        (typeof item === 'object' && Object.keys(item || {})?.length === 0));
 };
 exports.isInvalidOrEmptyArray = isInvalidOrEmptyArray;
 /**
@@ -64,7 +64,7 @@ const shuffleArray = (array) => {
     if ((0, exports.isInvalidOrEmptyArray)(array))
         return array;
     const shuffled = structuredClone(array);
-    for (let i = shuffled.length - 1; i > 0; i--) {
+    for (let i = shuffled?.length - 1; i > 0; i--) {
         const j = Math.floor(Math.random() * (i + 1));
         [shuffled[i], shuffled[j]] = [shuffled[j], shuffled[i]];
     }

package/dist/cjs/array/transform.js

@@ -56,10 +56,10 @@ function getDuplicates(array) {
         const hasSeen = seen?.find((el) => (0, utils_1.isDeepEqual)(el, item));
         const hasDuplicate = duplicates?.find((el) => (0, utils_1.isDeepEqual)(el, item));
         if (hasSeen && !hasDuplicate) {
-            duplicates.push(item);
+            duplicates?.push(item);
         }
         else if (!hasSeen) {
-            seen.push(item);
+            seen?.push(item);
         }
     }
     return duplicates;

package/dist/cjs/array/utils.js

@@ -25,7 +25,7 @@ function naturalSort(a, b, options) {
         let isNumeric = false;
         for (const char of str) {
             const charIsNum = !Number.isNaN(Number(char));
-            if (current.length === 0) {
+            if (current?.length === 0) {
                 current = char;
                 isNumeric = charIsNum;
                 continue;
@@ -34,27 +34,27 @@ function naturalSort(a, b, options) {
                 current += char;
             }
             else {
-                chunks.push(isNumeric ? Number(current) : current);
+                chunks?.push(isNumeric ? Number(current) : current);
                 current = char;
                 isNumeric = charIsNum;
             }
         }
-        if (current.length > 0) {
-            chunks.push(isNumeric ? Number(current) : current);
+        if (current?.length > 0) {
+            chunks?.push(isNumeric ? Number(current) : current);
         }
         return chunks;
     };
     const aChunks = _createChunks(a);
     const bChunks = _createChunks(b);
-    for (let i = 0; i < Math.min(aChunks.length, bChunks.length); i++) {
+    for (let i = 0; i < Math.min(aChunks?.length, bChunks?.length); i++) {
         let aChunk = aChunks[i];
         let bChunk = bChunks[i];
         // Normalize string chunks if case-insensitive
         if (caseInsensitive &&
             typeof aChunk === 'string' &&
             typeof bChunk === 'string') {
-            aChunk = aChunk.toLowerCase();
-            bChunk = bChunk.toLowerCase();
+            aChunk = aChunk?.toLowerCase();
+            bChunk = bChunk?.toLowerCase();
         }
         // Compare types: number vs string
         if (typeof aChunk !== typeof bChunk) {
@@ -77,5 +77,5 @@ function naturalSort(a, b, options) {
             }
         }
     }
-    return aChunks.length - bChunks.length;
+    return aChunks?.length - bChunks?.length;
 }

package/dist/cjs/colors/convert.js

@@ -94,11 +94,11 @@ exports.convertHslToHex = convertHslToHex;
  */
 const convertHexToHsl = (hex) => {
     let newHex = hex.replace('#', '');
-    if (newHex.length === 3) {
+    if (newHex?.length === 3) {
         newHex = newHex
-            .split('')
-            .map((char) => char + char)
-            .join('');
+            ?.split('')
+            ?.map((char) => char + char)
+            ?.join('');
     }
     const r = parseInt(newHex.slice(0, 2), 16);
     const g = parseInt(newHex.slice(2, 4), 16);
@@ -116,9 +116,9 @@ exports.convertHexToHsl = convertHexToHsl;
  */
 const convertRgbToHex = (r, g, b) => {
     const hex = [r, g, b]
-        .map((v) => v.toString(16).padStart(2, '0'))
-        .join('')
-        .toUpperCase();
+        ?.map((v) => v.toString(16).padStart(2, '0'))
+        ?.join('')
+        ?.toUpperCase();
     return `#${hex}`;
 };
 exports.convertRgbToHex = convertRgbToHex;
@@ -131,11 +131,11 @@ exports.convertRgbToHex = convertRgbToHex;
 const convertHexToRgb = (hex) => {
     // Remove the # if present
     let newHex = hex.replace('#', '');
-    if (newHex.length === 3) {
+    if (newHex?.length === 3) {
         newHex = newHex
-            .split('')
-            .map((char) => char + char)
-            .join('');
+            ?.split('')
+            ?.map((char) => char + char)
+            ?.join('');
     }
     const r = parseInt(newHex.slice(0, 2), 16);
     const g = parseInt(newHex.slice(2, 4), 16);

package/dist/cjs/colors/helpers.js

@@ -57,10 +57,10 @@ exports._generateRandomHSL = _generateRandomHSL;
  * @returns `Boolean` : `true` if the new color is similar to the previous one.
  */
 const _isSimilarToLast = (recentColors, newColor) => {
-    if (recentColors.length === 0)
+    if (recentColors?.length === 0)
         return false;
     const newHSL = newColor.match(/hsl\((\d+), (\d+)%, (\d+)%\)/);
-    const lastHSL = recentColors[recentColors.length - 1].match(/hsl\((\d+), (\d+)%, (\d+)%\)/);
+    const lastHSL = recentColors[recentColors?.length - 1].match(/hsl\((\d+), (\d+)%, (\d+)%\)/);
     if (!newHSL || !lastHSL)
         return false;
     const newHue = parseInt(newHSL[1], 10);

package/dist/cjs/colors/initials.js

@@ -31,7 +31,7 @@ function getColorForInitial(input = '', opacity = 100) {
         const upperInitial = initial.toUpperCase();
         const index = upperInitial.charCodeAt(0) - 'A'.charCodeAt(0);
         // Validate alphabet
-        if (index >= 0 && index < constants_1.alphabetColorPalette.length) {
+        if (index >= 0 && index < constants_1.alphabetColorPalette?.length) {
             return (0, helpers_1._applyOpacity)(constants_1.alphabetColorPalette[index], hexOpacity);
         }
         return (0, helpers_1._applyOpacity)('#010514', hexOpacity);
@@ -46,7 +46,7 @@ function getColorForInitial(input = '', opacity = 100) {
         // Handle array of strings/numbers
     }
     else if (Array.isArray(input)) {
-        if (input.length < 1)
+        if (input?.length < 1)
             return [...constants_1.alphabetColorPalette, ...constants_1.numberColorPalette].map((color) => (0, helpers_1._applyOpacity)(color, hexOpacity));
         return input
             .map((el) => {

package/dist/cjs/colors/random.js

@@ -24,8 +24,8 @@ const generateRandomHSLColor = (maxColors = 16) => {
     generatedColors.add(color);
     recentColors.push(color);
     // Limit the recent colors to the last `maxColors` to avoid excessive memory usage
-    if (recentColors.length > maxColors) {
-        recentColors.shift();
+    if (recentColors?.length > maxColors) {
+        recentColors?.shift();
     }
     return color;
 };

package/dist/cjs/colors/utils.js

@@ -13,7 +13,7 @@ const helpers_1 = require("./helpers");
  */
 const extractSolidColorValues = (color) => {
     if ((0, helpers_1._isHSL)(color) || (0, helpers_1._isRGB)(color)) {
-        return (color.match(/[\d.]+%?/g) || []).map((value) => parseFloat(value));
+        return (color.match(/[\d.]+%?/g) || [])?.map((value) => parseFloat(value));
     }
     return [0, 0, 0];
 };
@@ -29,7 +29,7 @@ exports.extractSolidColorValues = extractSolidColorValues;
  */
 const extractAlphaColorValues = (color) => {
     if ((0, helpers_1._isHSLA)(color) || (0, helpers_1._isRGBA)(color)) {
-        return (color.match(/[\d.]+%?/g) || []).map((value) => parseFloat(value));
+        return (color.match(/[\d.]+%?/g) || [])?.map((value) => parseFloat(value));
     }
     return [0, 0, 0, 0];
 };

package/dist/cjs/date/Chronos.js

@@ -204,19 +204,19 @@ class Chronos {
         };
         let result = '';
         let i = 0;
-        while (i < format.length) {
+        while (i < format?.length) {
             let matched = false;
             for (const token of constants_1.sortedFormats) {
-                const ahead = format.slice(i, i + token.length);
+                const ahead = format?.slice(i, i + token?.length);
                 const prev = i === 0 ? '' : format[i - 1];
-                const next = format[i + token.length] ?? '';
+                const next = format[i + token?.length] ?? '';
                 // Check non-alphanumeric boundaries
                 const prevOk = i === 0 || /[^a-zA-Z0-9]/.test(prev);
-                const nextOk = i + token.length >= format.length ||
+                const nextOk = i + token?.length >= format?.length ||
                     /[^a-zA-Z0-9]/.test(next);
                 if (ahead === token && prevOk && nextOk) {
                     result += dateComponents[token];
-                    i += token.length;
+                    i += token?.length;
                     matched = true;
                     break;
                 }
@@ -832,26 +832,26 @@ class Chronos {
         const lvlIdx = unitOrder.indexOf(level);
         const parts = [];
         if (lvlIdx >= 0 && years > 0 && lvlIdx >= unitOrder.indexOf('year')) {
-            parts.push((0, convert_1.formatUnitWithPlural)(years, 'year'));
+            parts?.push((0, convert_1.formatUnitWithPlural)(years, 'year'));
         }
         if (lvlIdx >= unitOrder.indexOf('month') && months > 0) {
-            parts.push((0, convert_1.formatUnitWithPlural)(months, 'month'));
+            parts?.push((0, convert_1.formatUnitWithPlural)(months, 'month'));
         }
         if (lvlIdx >= unitOrder.indexOf('week') && weeks > 0) {
-            parts.push((0, convert_1.formatUnitWithPlural)(weeks, 'week'));
+            parts?.push((0, convert_1.formatUnitWithPlural)(weeks, 'week'));
         }
         if (lvlIdx >= unitOrder.indexOf('day') && days > 0) {
-            parts.push((0, convert_1.formatUnitWithPlural)(days, 'day'));
+            parts?.push((0, convert_1.formatUnitWithPlural)(days, 'day'));
         }
         if (lvlIdx >= unitOrder.indexOf('hour') && hours > 0) {
-            parts.push((0, convert_1.formatUnitWithPlural)(hours, 'hour'));
+            parts?.push((0, convert_1.formatUnitWithPlural)(hours, 'hour'));
         }
         if (lvlIdx >= unitOrder.indexOf('minute') && minutes > 0) {
-            parts.push((0, convert_1.formatUnitWithPlural)(minutes, 'minute'));
+            parts?.push((0, convert_1.formatUnitWithPlural)(minutes, 'minute'));
         }
         if (lvlIdx >= unitOrder.indexOf('second') &&
-            (seconds > 0 || parts.length === 0)) {
-            parts.push((0, convert_1.formatUnitWithPlural)(seconds, 'second'));
+            (seconds > 0 || parts?.length === 0)) {
+            parts?.push((0, convert_1.formatUnitWithPlural)(seconds, 'second'));
         }
         let prefix = '';
         let suffix = '';
@@ -863,7 +863,7 @@ class Chronos {
                 suffix = ' ago';
             }
         }
-        return `${prefix}${parts.join(' ')}${suffix}`;
+        return `${prefix}${parts?.join(' ')}${suffix}`;
     }
     /**
      * * Returns the part of day (`'midnight', 'lateNight', 'night', 'morning', 'afternoon', 'evening'`) based on the current hour.
@@ -1526,7 +1526,7 @@ class Chronos {
                 parts[key] = num;
             }
         }
-        return new Chronos(new Date(parts.year ?? 1970, (parts.month ?? 1) - 1, parts.date ?? 1, parts.hour ?? 0, parts.minute ?? 0, parts.second ?? 0)).#withOrigin('parse');
+        return new Chronos(new Date(parts?.year ?? 1970, (parts?.month ?? 1) - 1, parts?.date ?? 1, parts?.hour ?? 0, parts?.minute ?? 0, parts?.second ?? 0)).#withOrigin('parse');
     }
     /**
      * * Rounds the current date-time to the nearest specified unit and interval.

package/dist/cjs/dom/query.js

@@ -24,15 +24,15 @@ const generateQueryParams = (params = {}) => {
     const flattenedParams = (0, objectify_1.flattenObjectKeyValue)(params);
     // Generate the query string
     const queryParams = Object.entries(flattenedParams)
-        .filter(([_, value]) => value !== undefined &&
+        ?.filter(([_, value]) => value !== undefined &&
         value !== null &&
-        !(typeof value === 'string' && value.trim() === ''))
-        .flatMap(([key, value]) => Array.isArray(value) ?
+        !(typeof value === 'string' && value?.trim() === ''))
+        ?.flatMap(([key, value]) => Array.isArray(value) ?
         value
-            .filter((v) => v !== undefined &&
+            ?.filter((v) => v !== undefined &&
             v !== null &&
             !(typeof v === 'string' && v.trim() === ''))
-            .map((v) => `${encodeURIComponent(key)}=${encodeURIComponent(typeof v === 'boolean' ? String(v) : String(v))}`)
+            ?.map((v) => `${encodeURIComponent(key)}=${encodeURIComponent(typeof v === 'boolean' ? String(v) : String(v))}`)
         : `${encodeURIComponent(key)}=${encodeURIComponent(typeof value === 'boolean' ? String(value) : String(value))}`)
         .join('&');
     return queryParams ? `?${queryParams}` : '';
@@ -46,7 +46,7 @@ exports.generateQueryParams = generateQueryParams;
  * @returns Query string as key-value paired object. `Record<string, string>`.
  */
 function getQueryParams() {
-    return Object.fromEntries(new URLSearchParams(window.location.search));
+    return Object.fromEntries(new URLSearchParams(window?.location?.search));
 }
 /**
  * * Update query params in the browser URL with given key and value.
@@ -56,7 +56,7 @@ function getQueryParams() {
 function updateQueryParam(key, value) {
     const url = new URL(window.location.href);
     url.searchParams.set(key, value);
-    window.history.replaceState({}, '', url.toString());
+    window.history.replaceState({}, '', url?.toString());
 }
 /**
  * Parses a query string (with optional `?` prefix) into an object.

package/dist/cjs/dom/utils.js

@@ -57,7 +57,7 @@ async function copyToClipboard(text) {
             textArea.style.opacity = '0';
             document.body.appendChild(textArea);
             textArea.select();
-            textArea.setSelectionRange(0, textArea.value.length);
+            textArea.setSelectionRange(0, textArea.value?.length);
             const success = document.execCommand('copy');
             document.body.removeChild(textArea);
             if (!success) {

package/dist/cjs/form/convert.js

@@ -19,13 +19,13 @@ const createControlledFormData = (data, configs) => {
     /** - Helper to check if a key should be lowercase */
     const shouldLowercaseKeys = (key) => {
         return Array.isArray(configs?.lowerCaseKeys) ?
-            configs.lowerCaseKeys.some((path) => key === path || key.startsWith(`${path}.`))
+            configs?.lowerCaseKeys?.some((path) => key === path || key.startsWith(`${path}.`))
             : configs?.lowerCaseKeys === '*';
     };
     /** - Helper to check if a key should be lowercase */
     const shouldLowercaseValue = (key) => {
         return Array.isArray(configs?.lowerCaseValues) ?
-            configs.lowerCaseValues.some((path) => key === path || key.startsWith(`${path}.`))
+            configs.lowerCaseValues?.some((path) => key === path || key?.startsWith(`${path}.`))
             : configs?.lowerCaseValues === '*';
     };
     /** - Transforms key to lowercase if needed */
@@ -36,8 +36,8 @@ const createControlledFormData = (data, configs) => {
     const isRequiredKey = (key) => {
         const transformedKey = _transformKey(key);
         return Array.isArray(configs?.requiredKeys) ?
-            configs.requiredKeys.some((path) => transformedKey === path ||
-                transformedKey.startsWith(`${path}.`))
+            configs?.requiredKeys?.some((path) => transformedKey === path ||
+                transformedKey?.startsWith(`${path}.`))
             : configs?.requiredKeys === '*';
     };
     /** - Helper function to check if a key matches a dotNotation path to preserve. */
@@ -89,7 +89,7 @@ const createControlledFormData = (data, configs) => {
                 }
                 else {
                     if (typeof value === 'string') {
-                        acc[transformedKey] = value.toLowerCase();
+                        acc[transformedKey] = value?.toLowerCase();
                     }
                     else if (Array.isArray(value)) {
                         if (isRequiredKey(fullKey) || (0, non_primitives_1.isValidArray)(value)) {
@@ -113,18 +113,18 @@ const createControlledFormData = (data, configs) => {
     const _addToFormData = (key, value) => {
         const transformedKey = _transformKey(key);
         if ((0, guards_2.isCustomFileArray)(value)) {
-            value.forEach((file) => formData.append(transformedKey, file.originFileObj));
+            value?.forEach((file) => formData.append(transformedKey, file?.originFileObj));
         }
         else if ((0, guards_2.isFileUpload)(value)) {
-            if (value.fileList) {
-                value.fileList.forEach((file) => formData.append(transformedKey, file.originFileObj));
+            if (value?.fileList) {
+                value?.fileList.forEach((file) => formData.append(transformedKey, file?.originFileObj));
             }
-            else if (value.file) {
-                if ((0, guards_2.isCustomFile)(value.file)) {
-                    formData.append(transformedKey, value.file.originFileObj);
+            else if (value?.file) {
+                if ((0, guards_2.isCustomFile)(value?.file)) {
+                    formData.append(transformedKey, value?.file?.originFileObj);
                 }
                 else {
-                    formData.append(transformedKey, value.file);
+                    formData.append(transformedKey, value?.file);
                 }
             }
         }
@@ -132,26 +132,26 @@ const createControlledFormData = (data, configs) => {
             formData.append(transformedKey, value);
         }
         else if ((0, guards_2.isFileList)(value)) {
-            for (let i = 0; i < value.length; i++) {
+            for (let i = 0; i < value?.length; i++) {
                 formData.append(transformedKey, value.item(i));
             }
         }
         else if (Array.isArray(value)) {
             if ((0, guards_2.isFileArray)(value)) {
                 if (shouldBreakArray(key)) {
-                    value.forEach((item, index) => {
+                    value?.forEach((item, index) => {
                         _addToFormData(`${transformedKey}[${index}]`, item);
                     });
                 }
                 else {
-                    value.forEach((item) => {
+                    value?.forEach((item) => {
                         formData.append(transformedKey, item);
                     });
                 }
             }
             else if ((0, non_primitives_1.isValidArray)(value)) {
                 if (shouldBreakArray(key)) {
-                    value.forEach((item, index) => {
+                    value?.forEach((item, index) => {
                         _addToFormData(`${transformedKey}[${index}]`, item);
                     });
                 }
@@ -184,7 +184,7 @@ const createControlledFormData = (data, configs) => {
             const isNotNullish = value != null && value !== '';
             if (isNotNullish || isRequiredKey(key)) {
                 if (typeof value === 'string' && shouldLowercaseValue(key)) {
-                    formData.append(transformedKey, value.toLowerCase());
+                    formData.append(transformedKey, value?.toLowerCase());
                 }
                 else {
                     // ! CONFUSED UNGA-BUNGA
@@ -204,7 +204,7 @@ const createControlledFormData = (data, configs) => {
             }
             // * Trim string values if trimStrings is enabled
             if (configs?.trimStrings && typeof value === 'string') {
-                value = value.trim();
+                value = value?.trim();
             }
             // * Check if this key is preserved as dot-notation
             if (shouldDotNotate(fullKey)) {

package/dist/cjs/form/guards.js

@@ -22,7 +22,7 @@ function isValidFormData(value) {
             console.warn('`FormData.entries()` is not supported!');
             return false;
         }
-        return Array.from(value.entries()).length > 0;
+        return Array.from(value.entries())?.length > 0;
     }
     return false;
 }
@@ -59,7 +59,7 @@ function isCustomFile(value) {
  * @returns `true` if the value is a valid `CustomFile[]`, otherwise `false`.
  */
 function isCustomFileArray(value) {
-    return (Array.isArray(value) && value.length > 0 && value.every(isCustomFile));
+    return (Array.isArray(value) && value?.length > 0 && value?.every(isCustomFile));
 }
 /**
  * * Checks if a given value is an array of `File` objects.
@@ -68,7 +68,7 @@ function isCustomFileArray(value) {
  * @returns `true` if the value is a valid `File[]`, otherwise `false`.
  */
 function isFileArray(value) {
-    return (Array.isArray(value) && value.length > 0 && value.every(isFileOrBlob));
+    return (Array.isArray(value) && value?.length > 0 && value?.every(isFileOrBlob));
 }
 /**
  * * Checks if a given value is an instance of `FileList`.

package/dist/cjs/form/transform.js

@@ -15,7 +15,7 @@ const sanitize_1 = require("../object/sanitize");
 function serializeForm(form, toQueryString = false) {
     const formData = new FormData(form);
     const data = {};
-    formData.forEach((value, key) => {
+    formData?.forEach((value, key) => {
         // If the key already exists, we make it an array to handle multiple selections
         if (data[key]) {
             data[key] =
@@ -44,7 +44,7 @@ function parseFormData(data, parsePrimitives = true) {
     const parsed = {};
     if (typeof data === 'string') {
         const params = new URLSearchParams(data);
-        params.forEach((value, key) => {
+        params?.forEach((value, key) => {
             const existing = parsed[key];
             if (typeof existing === 'string') {
                 parsed[key] = [existing, value];
@@ -58,7 +58,7 @@ function parseFormData(data, parsePrimitives = true) {
         });
     }
     else {
-        data.forEach((value, key) => {
+        data?.forEach((value, key) => {
             const existing = parsed[key];
             if (value instanceof File) {
                 if (Array.isArray(existing)) {

package/dist/cjs/guards/non-primitives.js

@@ -15,7 +15,6 @@ 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");
@@ -33,7 +32,7 @@ function isArray(value) {
  * @returns `true` if the value is an array with length, otherwise `false`.
  */
 function isValidArray(value) {
-    return Array.isArray(value) && value.length > 0;
+    return Array.isArray(value) && value?.length > 0;
 }
 /**
  * * Type guard to check if a value is an object (excluding null).
@@ -49,7 +48,7 @@ function isObject(value) {
  * @returns `true` if the value is an object with valid keys, otherwise `false`.
  */
 function isNotEmptyObject(value) {
-    return isObject(value) && Object.keys(value).length > 0;
+    return isObject(value) && Object.keys(value)?.length > 0;
 }
 /**
  * * Type guard to check if a value is an object with specific keys.
@@ -58,7 +57,7 @@ function isNotEmptyObject(value) {
  * @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);
+    return isObject(value) && keys?.every((key) => key in value);
 }
 /**
  * * Type guard to check if a value is an empty object.
@@ -66,7 +65,7 @@ function isObjectWithKeys(value, keys) {
  * @returns `true` if the value is an empty object, otherwise `false`.
  */
 function isEmptyObject(value) {
-    return isObject(value) && Object.keys(value).length === 0;
+    return isObject(value) && Object.keys(value)?.length === 0;
 }
 /**
  * * Type guard to check if a value is a function.
@@ -83,7 +82,7 @@ function isFunction(value) {
  * @returns `true` if the descriptor is defined and its value is a function; otherwise, `false`.
  */
 const isMethodDescriptor = (descriptor) => {
-    return !!descriptor && typeof descriptor.value === 'function';
+    return !!descriptor && typeof descriptor?.value === 'function';
 };
 exports.isMethodDescriptor = isMethodDescriptor;
 /**
@@ -101,7 +100,7 @@ function isDate(value) {
  * @returns `true` if the value is an array of the specified type, otherwise `false`.
  */
 function isArrayOfType(value, typeCheck) {
-    return isArray(value) && value.every(typeCheck);
+    return isArray(value) && value?.every(typeCheck);
 }
 /**
  * * Type guard to check if a value is a Promise.
@@ -143,14 +142,6 @@ function isRegExp(value) {
 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.
@@ -173,5 +164,5 @@ function isJSON(value) {
  * @returns `true` if the function returns a Promise, otherwise `false`.
  */
 function isReturningPromise(fn) {
-    return isFunction(fn) && fn.constructor.name === 'AsyncFunction';
+    return isFunction(fn) && fn.constructor?.name === 'AsyncFunction';
 }

package/dist/cjs/guards/primitives.js

@@ -8,6 +8,7 @@ exports.isBoolean = isBoolean;
 exports.isNull = isNull;
 exports.isUndefined = isUndefined;
 exports.isSymbol = isSymbol;
+exports.isBigInt = isBigInt;
 exports.isPrimitive = isPrimitive;
 exports.isNormalPrimitive = isNormalPrimitive;
 exports.isNonEmptyString = isNonEmptyString;
@@ -77,6 +78,14 @@ function isUndefined(value) {
 function isSymbol(value) {
     return typeof value === 'symbol';
 }
+/**
+ * * 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 value is a primitive (i.e. `string | number | boolean | symbol | bigint | null | undefined`).
  * @param value - The value to check.

package/dist/cjs/guards/specials.js

@@ -29,7 +29,7 @@ function isEmail(value) {
  * @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);
+    return (0, non_primitives_1.isArray)(value) && value?.every(isEmail);
 }
 /**
  * * Type guard to check if a value is a valid date string.