nhb-toolbox 4.28.24 → 4.28.40

package/CHANGELOG.md

@@ -6,6 +6,15 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [4.28.40] - 2025-12-15
+
+- **Added** *new class* `TextCodec` with only *static methods* to convert between `text`, `hex`, `binary`, and `Base64` representations using *byte-level transformations*.
+- **Added** *new utility* `hexToBytes` with 2 new special *type guards:* `isHexString` and `isBinaryString`.
+
+## [4.28.30] - 2025-12-13
+
+- **Updated** *tsdoc* for `Chronos` and *signature* of `Currency` class with generic `CurrencyCode`.
+
 ## [4.28.24] - 2025-12-11
 
 - **Updated** *type names* `VoidFunction` to `VoidFn`. `DelayedFn<T>` is used for both *debounced* and *throttled* functions.

package/dist/cjs/constants.js

@@ -34,7 +34,7 @@ Object.defineProperty(exports, "CSS_COLORS", { enumerable: true, get: function (
 var constants_3 = require("./number/constants");
 Object.defineProperty(exports, "CURRENCY_CODES", { enumerable: true, get: function () { return constants_3.CURRENCY_CODES; } });
 Object.defineProperty(exports, "CURRENCY_LOCALES", { enumerable: true, get: function () { return constants_3.CURRENCY_LOCALES; } });
-Object.defineProperty(exports, "FRANKFURTER_CURRENCIES", { enumerable: true, get: function () { return constants_3.SUPPORTED_CURRENCIES; } });
+Object.defineProperty(exports, "FRANKFURTER_CURRENCIES", { enumerable: true, get: function () { return constants_3.FRANKFURTER_CURRENCIES; } });
 Object.defineProperty(exports, "GENERAL_UNITS", { enumerable: true, get: function () { return constants_3.UNITS; } });
 Object.defineProperty(exports, "LOCALE_CODES", { enumerable: true, get: function () { return constants_3.LOCALE_CODES; } });
 var constants_4 = require("./string/constants");

package/dist/cjs/guards/specials.js

@@ -8,6 +8,8 @@ exports.isBrowser = isBrowser;
 exports.isNode = isNode;
 exports.isURL = isURL;
 exports.isBase64 = isBase64;
+exports.isHexString = isHexString;
+exports.isBinaryString = isBinaryString;
 exports.isPhoneNumber = isPhoneNumber;
 exports.isIPAddress = isIPAddress;
 exports.isEnvironment = isEnvironment;
@@ -49,6 +51,14 @@ 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));
 }
+function isHexString(value) {
+    return ((0, primitives_1.isString)(value) &&
+        /^[\da-fA-F\s]+$/.test(value) &&
+        value.replace(/\s+/g, '').length % 2 === 0);
+}
+function isBinaryString(value) {
+    return ((0, primitives_1.isString)(value) && /^[01\s]+$/.test(value) && value.replace(/\s+/g, '').length % 8 === 0);
+}
 function isPhoneNumber(value) {
     return (0, primitives_1.isString)(value) && /^\+?[1-9]\d{1,14}$/.test(value);
 }

package/dist/cjs/hash/TextCodec.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TextCodec = void 0;
+const primitives_1 = require("../guards/primitives");
+const specials_1 = require("../guards/specials");
+const helpers_1 = require("./helpers");
+const utils_1 = require("./utils");
+class TextCodec {
+    constructor() { }
+    static isValidHex(hex) {
+        return (0, specials_1.isHexString)(hex);
+    }
+    static isValidBinary(binary) {
+        return (0, specials_1.isBinaryString)(binary);
+    }
+    static isValidBase64(b64) {
+        return (0, specials_1.isBase64)(b64);
+    }
+    static utf8ToHex(text, spaced = true) {
+        return [...(0, utils_1.utf8ToBytes)(text)]
+            .map((b) => (0, helpers_1._padStartWith0)(b, 'hex'))
+            .join(spaced ? ' ' : '');
+    }
+    static utf8ToBinary(text, spaced = true) {
+        return [...(0, utils_1.utf8ToBytes)(text)]
+            .map((b) => (0, helpers_1._padStartWith0)(b, 'binary'))
+            .join(spaced ? ' ' : '');
+    }
+    static hexToUtf8(hex) {
+        return (0, utils_1.bytesToUtf8)((0, utils_1.hexToBytes)(hex));
+    }
+    static binaryToUtf8(binary) {
+        if (!(0, specials_1.isBinaryString)(binary))
+            return '';
+        const bytes = (0, helpers_1._splitByCharLength)(binary, 8).map((b) => parseInt(b, 2));
+        return (0, utils_1.bytesToUtf8)(new Uint8Array(bytes));
+    }
+    static hexToBinary(hex, spaced = true) {
+        if (!(0, specials_1.isHexString)(hex))
+            return '';
+        return (0, helpers_1._splitByCharLength)(hex, 2)
+            .map((h) => (0, helpers_1._padStartWith0)(parseInt(h, 16), 'binary'))
+            .join(spaced ? ' ' : '');
+    }
+    static binaryToHex(binary, spaced = true) {
+        if (!(0, specials_1.isBinaryString)(binary))
+            return '';
+        return (0, helpers_1._splitByCharLength)(binary, 8)
+            .map((b) => (0, helpers_1._padStartWith0)(parseInt(b, 2), 'hex'))
+            .join(spaced ? ' ' : '');
+    }
+    static base64ToUtf8(b64) {
+        if (!(0, specials_1.isBase64)(b64))
+            return '';
+        return (0, utils_1.bytesToUtf8)((0, utils_1.base64ToBytes)(b64));
+    }
+    static utf8ToBase64(text) {
+        if (!(0, primitives_1.isNonEmptyString)(text))
+            return '';
+        return (0, utils_1.bytesToBase64)((0, utils_1.utf8ToBytes)(text));
+    }
+    static base64ToHex(b64, spaced = true) {
+        return this.utf8ToHex(this.base64ToUtf8(b64), spaced);
+    }
+    static base64ToBinary(b64, spaced = true) {
+        return this.utf8ToBinary(this.base64ToUtf8(b64), spaced);
+    }
+    static hexToBase64(hex) {
+        return this.utf8ToBase64(this.hexToUtf8(hex));
+    }
+    static binaryToBase64(binary) {
+        return this.utf8ToBase64(this.binaryToUtf8(binary));
+    }
+}
+exports.TextCodec = TextCodec;

package/dist/cjs/hash/helpers.js

@@ -10,6 +10,8 @@ exports._formatUUID = _formatUUID;
 exports._isOptionV3V5 = _isOptionV3V5;
 exports._checkUUIDVersion = _checkUUIDVersion;
 exports._constantTimeEquals = _constantTimeEquals;
+exports._splitByCharLength = _splitByCharLength;
+exports._padStartWith0 = _padStartWith0;
 const non_primitives_1 = require("../guards/non-primitives");
 const primitives_1 = require("../guards/primitives");
 const specials_1 = require("../guards/specials");
@@ -168,3 +170,16 @@ function _constantTimeEquals(a, b) {
     }
     return res === 0;
 }
+function _splitByCharLength(str, splitByChars = 2) {
+    if (!(0, primitives_1.isNonEmptyString)(str))
+        return [];
+    const sanitized = str.replace(/\s+/g, '');
+    const result = [];
+    for (let i = 0; i < sanitized.length; i += splitByChars) {
+        result.push(sanitized.slice(i, i + splitByChars));
+    }
+    return result;
+}
+function _padStartWith0(byte, type) {
+    return byte.toString(type === 'hex' ? 16 : 2).padStart(type === 'hex' ? 2 : 8, '0');
+}

package/dist/cjs/hash/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.uuid = exports.isUUIDv8 = exports.isUUIDv7 = exports.isUUIDv6 = exports.isUUIDv5 = exports.isUUIDv4 = exports.isUUIDv3 = exports.isUUIDv2 = exports.isUUIDv1 = exports.decodeUUID = exports.utf8ToBytes = exports.uint8To32ArrayBE = exports.sha256Bytes = exports.randomHex = exports.intTo4BytesBE = exports.hmacSha256 = exports.concatBytes = exports.bytesToUtf8 = exports.bytesToHex = exports.bytesToBase64 = exports.base64ToBytes = exports.Signet = exports.sha256 = exports.sha1 = exports.md5 = exports.Cipher = exports.randomID = exports.generateRandomID = exports.isUUID = void 0;
+exports.uuid = exports.isUUIDv8 = exports.isUUIDv7 = exports.isUUIDv6 = exports.isUUIDv5 = exports.isUUIDv4 = exports.isUUIDv3 = exports.isUUIDv2 = exports.isUUIDv1 = exports.decodeUUID = exports.utf8ToBytes = exports.uint8To32ArrayBE = exports.sha256Bytes = exports.randomHex = exports.intTo4BytesBE = exports.hmacSha256 = exports.hexToBytes = exports.concatBytes = exports.bytesToUtf8 = exports.bytesToHex = exports.bytesToBase64 = exports.base64ToBytes = exports.TextCodec = exports.Signet = exports.sha256 = exports.sha1 = exports.md5 = exports.Cipher = exports.randomID = exports.generateRandomID = exports.isUUID = void 0;
 var specials_1 = require("../guards/specials");
 Object.defineProperty(exports, "isUUID", { enumerable: true, get: function () { return specials_1.isUUID; } });
 var basics_1 = require("../string/basics");
@@ -14,12 +14,15 @@ Object.defineProperty(exports, "sha1", { enumerable: true, get: function () { re
 Object.defineProperty(exports, "sha256", { enumerable: true, get: function () { return core_1.sha256; } });
 var Signet_1 = require("./Signet");
 Object.defineProperty(exports, "Signet", { enumerable: true, get: function () { return Signet_1.Signet; } });
+var TextCodec_1 = require("./TextCodec");
+Object.defineProperty(exports, "TextCodec", { enumerable: true, get: function () { return TextCodec_1.TextCodec; } });
 var utils_1 = require("./utils");
 Object.defineProperty(exports, "base64ToBytes", { enumerable: true, get: function () { return utils_1.base64ToBytes; } });
 Object.defineProperty(exports, "bytesToBase64", { enumerable: true, get: function () { return utils_1.bytesToBase64; } });
 Object.defineProperty(exports, "bytesToHex", { enumerable: true, get: function () { return utils_1.bytesToHex; } });
 Object.defineProperty(exports, "bytesToUtf8", { enumerable: true, get: function () { return utils_1.bytesToUtf8; } });
 Object.defineProperty(exports, "concatBytes", { enumerable: true, get: function () { return utils_1.concatBytes; } });
+Object.defineProperty(exports, "hexToBytes", { enumerable: true, get: function () { return utils_1.hexToBytes; } });
 Object.defineProperty(exports, "hmacSha256", { enumerable: true, get: function () { return utils_1.hmacSha256; } });
 Object.defineProperty(exports, "intTo4BytesBE", { enumerable: true, get: function () { return utils_1.intTo4BytesBE; } });
 Object.defineProperty(exports, "randomHex", { enumerable: true, get: function () { return utils_1.randomHex; } });

package/dist/cjs/hash/utils.js

@@ -11,6 +11,9 @@ exports.hmacSha256 = hmacSha256;
 exports.uint8To32ArrayBE = uint8To32ArrayBE;
 exports.intTo4BytesBE = intTo4BytesBE;
 exports.bytesToHex = bytesToHex;
+exports.hexToBytes = hexToBytes;
+const specials_1 = require("../guards/specials");
+const helpers_1 = require("./helpers");
 function randomHex(length, uppercase = false) {
     const genHex = () => Math.floor(Math.random() * 16).toString(16);
     const hex = Array.from({ length }, genHex).join('');
@@ -250,3 +253,9 @@ function bytesToHex(bytes) {
     }
     return hex;
 }
+function hexToBytes(hex) {
+    if (!(0, specials_1.isHexString)(hex))
+        return new Uint8Array();
+    const bytes = (0, helpers_1._splitByCharLength)(hex, 2).map((h) => parseInt(h, 16));
+    return new Uint8Array(bytes);
+}

package/dist/cjs/index.js

@@ -7,7 +7,7 @@ exports.formatDateTime = exports.formatDate = exports.extractTotalMinutesFromTim
 exports.convertIntoFormData = exports.splitArrayByProperty = exports.splitArray = exports.rotateArray = exports.removeDuplicatesFromArray = exports.removeDuplicates = exports.moveArrayElement = exports.groupArrayByProperty = exports.getMissingElements = exports.getDuplicatesFromArray = exports.getDuplicates = exports.findMissingElements = exports.extractMissingElements = exports.extractDuplicatesFromArray = exports.extractDuplicates = exports.createOptionsArray = exports.sortAnArray = exports.naturalSortForString = exports.naturalSort = exports.compareSorter = exports.compareNaturally = exports.Finder = exports.totalDeltaByField = exports.sumFieldDifference = exports.sumByField = exports.groupAndSumByField = exports.groupAndAvgByField = exports.groupAndAverageByField = exports.avgByField = exports.averageByField = exports.shuffleArray = exports.isValidEmptyArray = exports.isInvalidOrEmptyArray = exports.getLastArrayElement = exports.flattenArray = exports.filterArrayOfObjects = exports.minutesToUTCOffset = exports.getTotalMinutesFromUTC = exports.getTotalMinutesFromTime = exports.getTotalMinutes = exports.getTimeZoneIds = exports.getTimeZoneDetails = exports.getTimeStringFromUTC = exports.getTimeFromMinutes = exports.getNativeTimeZoneId = exports.getMinutesFromUTC = exports.getHourMinutesFromMinutes = exports.getCurrentTime = exports.getCurrentDateTime = exports.formatUTCOffset = void 0;
 exports.parseQueryStringLiteral = exports.parseQueryString = exports.literalQueryStringToObject = exports.getQueryStringAsObject = exports.getQueryParams = exports.generateQueryParams = exports.formatQueryParams = exports.createQueryParams = exports.removeObjectFields = exports.removeFields = exports.remapObjectFields = exports.remapFields = exports.pickObjectFieldsByCondition = exports.pickObjectFields = exports.pickFieldsByCondition = exports.pickFields = exports.omitObjectFields = exports.omitFields = exports.deleteObjectFields = exports.deleteFields = exports.convertObjectValues = exports.sanitizeData = exports.parseStringifiedObjectValues = exports.parseObjectValues = exports.parseJsonToObject = exports.mergeObjects = exports.mergeAndFlattenObjects = exports.flattenObjectKeyValue = exports.flattenObjectDotNotation = exports.extractUpdatedFields = exports.extractUpdatedAndNewFields = exports.extractNewFields = exports.extractObjectKeysDeep = exports.extractObjectKeys = exports.extractKeysDeep = exports.extractKeys = exports.countObjectFields = exports.cloneObject = exports.isValidFormData = exports.isOriginFileObj = exports.isFileUpload = exports.isFileOrBlob = exports.isFileList = exports.isFileArray = exports.isCustomFileArray = exports.isCustomFile = exports.serializeForm = exports.parseFormData = exports.createFormData = exports.createControlledFormData = void 0;
 exports.isArrayOfType = exports.isArray = exports.doesReturnPromise = exports.isUndefined = exports.isTruthy = exports.isSymbol = exports.isString = exports.isPrimitive = exports.isPositiveInteger = exports.isNumber = exports.isNull = exports.isNormalPrimitive = exports.isNonEmptyString = exports.isInteger = exports.isFalsy = exports.isBoolean = exports.isBigInt = exports.Paginator = exports.throttleAction = exports.stripJsonEdgeGarbage = exports.stableStringify = exports.parsePrimitivesDeep = exports.parseJsonDeep = exports.parseJSON = exports.joinArrayElements = exports.isDeepEqual = exports.getStaticMethodsCount = exports.getStaticMethodNames = exports.getStaticGetterNames = exports.getInstanceMethodsCount = exports.getInstanceMethodNames = exports.getInstanceGetterNames = exports.getClassDetails = exports.definePrototypeMethod = exports.deepParsePrimitives = exports.debounceAction = exports.countStaticMethods = exports.countInstanceMethods = exports.convertArrayToString = exports.saveToSessionStorage = exports.saveToLocalStorage = exports.removeFromSessionStorage = exports.removeFromLocalStorage = exports.getFromSessionStorage = exports.getFromLocalStorage = exports.toggleFullScreen = exports.smoothScrollTo = exports.copyToClipboard = exports.updateQueryParam = exports.queryStringToObject = void 0;
-exports.isValidURL = exports.isValidEmail = exports.isUUID = exports.isURL = exports.isPhoneNumber = exports.isNumericString = exports.isNodeEnvironment = exports.isNodeENV = exports.isNode = exports.isIPAddress = exports.isExpectedNodeENV = exports.isEnvironment = exports.isEmailArray = exports.isEmail = exports.isDateString = exports.isBrowser = exports.isBase64 = exports.httpStatus = exports.HttpStatus = exports.isValidSet = exports.isValidObject = exports.isValidMap = exports.isValidJSON = exports.isValidArray = exports.isSet = exports.isReturningPromise = exports.isRegularExpression = exports.isRegExp = exports.isPromise = exports.isObjectWithKeys = exports.isObjectEmpty = exports.isObject = exports.isNotEmptyObject = exports.isMethodDescriptor = exports.isMethod = exports.isMap = exports.isJSONObject = exports.isJSON = exports.isFunction = exports.isError = exports.isEmptyObjectGuard = exports.isEmptyObject = exports.isDate = exports.isArrayWithLength = void 0;
+exports.isValidURL = exports.isValidEmail = exports.isUUID = exports.isURL = exports.isPhoneNumber = exports.isNumericString = exports.isNodeEnvironment = exports.isNodeENV = exports.isNode = exports.isIPAddress = exports.isHexString = exports.isExpectedNodeENV = exports.isEnvironment = exports.isEmailArray = exports.isEmail = exports.isDateString = exports.isBrowser = exports.isBinaryString = exports.isBase64 = exports.httpStatus = exports.HttpStatus = exports.isValidSet = exports.isValidObject = exports.isValidMap = exports.isValidJSON = exports.isValidArray = exports.isSet = exports.isReturningPromise = exports.isRegularExpression = exports.isRegExp = exports.isPromise = exports.isObjectWithKeys = exports.isObjectEmpty = exports.isObject = exports.isNotEmptyObject = exports.isMethodDescriptor = exports.isMethod = exports.isMap = exports.isJSONObject = exports.isJSON = exports.isFunction = exports.isError = exports.isEmptyObjectGuard = exports.isEmptyObject = exports.isDate = exports.isArrayWithLength = void 0;
 var basics_1 = require("./string/basics");
 Object.defineProperty(exports, "generateRandomID", { enumerable: true, get: function () { return basics_1.generateRandomID; } });
 Object.defineProperty(exports, "trimString", { enumerable: true, get: function () { return basics_1.trimString; } });
@@ -439,12 +439,14 @@ Object.defineProperty(exports, "HttpStatus", { enumerable: true, get: function (
 Object.defineProperty(exports, "httpStatus", { enumerable: true, get: function () { return HttpStatus_1.httpStatus; } });
 var specials_1 = require("./guards/specials");
 Object.defineProperty(exports, "isBase64", { enumerable: true, get: function () { return specials_1.isBase64; } });
+Object.defineProperty(exports, "isBinaryString", { enumerable: true, get: function () { return specials_1.isBinaryString; } });
 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, "isEmailArray", { enumerable: true, get: function () { return specials_1.isEmailArray; } });
 Object.defineProperty(exports, "isEnvironment", { enumerable: true, get: function () { return specials_1.isEnvironment; } });
 Object.defineProperty(exports, "isExpectedNodeENV", { enumerable: true, get: function () { return specials_1.isEnvironment; } });
+Object.defineProperty(exports, "isHexString", { enumerable: true, get: function () { return specials_1.isHexString; } });
 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, "isNodeENV", { enumerable: true, get: function () { return specials_1.isEnvironment; } });

package/dist/cjs/number/Currency.js

@@ -11,37 +11,37 @@ class Currency {
         this.#code = code;
         this.currency = this.format('en-US');
     }
-    static #rateCache = new Map();
+    static #RATE_CACHE = new Map();
     static clearRateCache() {
-        Currency.#rateCache.clear();
+        Currency.#RATE_CACHE.clear();
     }
     format(locale, code) {
         return (0, utilities_1.formatCurrency)(this.#amount, code ?? this.#code, locale);
     }
     async convert(to, options) {
         const key = `${this.#code}->${to}`;
-        if (!options?.forceRefresh && Currency.#rateCache.has(key)) {
-            const cachedRate = Currency.#rateCache.get(key);
+        if (!options?.forceRefresh && Currency.#RATE_CACHE.has(key)) {
+            const cachedRate = Currency.#RATE_CACHE.get(key);
             return new Currency(this.#amount * cachedRate, to);
         }
         try {
             const rate = await this.#fetchFromFrankfurter(to);
-            Currency.#rateCache.set(key, rate);
+            Currency.#RATE_CACHE.set(key, rate);
             return new Currency(this.#amount * rate, to);
         }
         catch (error) {
             if (options?.fallbackRate != null) {
-                console.warn(`Currency conversion failed (${this.#code} → ${to}): ${error.message}. Using fallback rate...`);
+                console.warn(`Currency conversion failed (${this.#code} → ${to}): ${error?.message}. Using fallback rate...`);
                 return new Currency(this.#amount * options.fallbackRate, to);
             }
             else {
-                throw new Error(`Currency conversion failed (${this.#code} → ${to}): ${error.message}`);
+                throw new Error(`Currency conversion failed (${this.#code} → ${to}): ${error?.message}`);
             }
         }
     }
     convertSync(to, rate) {
         const key = `${this.#code}->${to}`;
-        const cachedRate = Currency.#rateCache.get(key);
+        const cachedRate = Currency.#RATE_CACHE.get(key);
         if (cachedRate) {
             return new Currency(this.#amount * cachedRate, to);
         }
@@ -53,7 +53,7 @@ class Currency {
         }
     }
     async #fetchFromFrankfurter(to) {
-        const url = `https://api.frankfurter.app/latest?amount=${this.#amount}&from=${this.#code}`;
+        const url = `https://api.frankfurter.app/latest?amount=1&from=${this.#code}`;
         try {
             const res = await fetch(url, { redirect: 'error' });
             if (!res.ok) {
@@ -61,12 +61,12 @@ class Currency {
             }
             const data = await res.json();
             if (!data.rates?.[to]) {
-                throw new Error(`Currency "${to}" not allowed or not found in FrankFurter Database!`);
+                throw new Error(`Currency "${to}" is not found in FrankFurter Database!`);
             }
-            return data.rates[to] / this.#amount;
+            return data.rates[to];
         }
         catch (error) {
-            throw new Error(error.message || `Failed to fetch data from FrankFurter API`);
+            throw new Error(error?.message || `Failed to fetch data from FrankFurter API`);
         }
     }
 }

package/dist/cjs/number/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PREFIX_MULTIPLIERS = exports.UNITS = exports.SUPPORTED_CURRENCIES = exports.CURRENCY_LOCALES = exports.LOCALE_CODES = exports.CURRENCY_CODES = exports.ORDINAL_TO_CARDINAL = exports.ORDINAL_UNDER_TEEN = exports.THOUSANDS = exports.TENS = exports.TEENS = exports.ONES = void 0;
+exports.PREFIX_MULTIPLIERS = exports.UNITS = exports.FRANKFURTER_CURRENCIES = exports.CURRENCY_LOCALES = exports.LOCALE_CODES = exports.CURRENCY_CODES = exports.ORDINAL_TO_CARDINAL = exports.ORDINAL_UNDER_TEEN = exports.THOUSANDS = exports.TENS = exports.TEENS = exports.ONES = void 0;
 exports.ONES = /* @__PURE__ */ Object.freeze([
     '',
     'one',
@@ -541,7 +541,7 @@ exports.CURRENCY_LOCALES = /* @__PURE__ */ Object.freeze({
     ZMW: 'en-ZM',
     ZWL: 'en-ZW',
 });
-exports.SUPPORTED_CURRENCIES = /* @__PURE__ */ Object.freeze([
+exports.FRANKFURTER_CURRENCIES = /* @__PURE__ */ Object.freeze([
     'AUD',
     'BGN',
     'BRL',

package/dist/dts/constants.d.ts

@@ -3,7 +3,7 @@ export { IANA_TZ_IDS, NATIVE_TZ_IDS, TIME_ZONE_IDS, TIME_ZONE_LABELS, TIME_ZONES
 export { AUSTRALIA_SEASONS, BANGLADESH_SEASONS, ETHIOPIA_SEASONS, INDIA_IMD_SEASONS, INDIA_TAMIL_SEASONS, INDIA_VEDIC_SEASONS, JAPAN_SEASONS, PHILIPPINES_SEASONS, SEASON_PRESETS, US_ACADEMIC_SEASONS, DEFAULT_SEASONS as WESTERN_SEASONS, } from './date/seasons';
 export { ALPHABET_COLOR_PALETTE, NUMBER_COLOR_PALETTE } from './colors/constants';
 export { CSS_COLORS } from './colors/css-colors';
-export { CURRENCY_CODES, CURRENCY_LOCALES, SUPPORTED_CURRENCIES as FRANKFURTER_CURRENCIES, UNITS as GENERAL_UNITS, LOCALE_CODES, } from './number/constants';
+export { CURRENCY_CODES, CURRENCY_LOCALES, FRANKFURTER_CURRENCIES, UNITS as GENERAL_UNITS, LOCALE_CODES, } from './number/constants';
 export { LOWERCASE as LOWERCASED_WORDS } from './string/constants';
 export { UNITS as CATEGORIZED_UNITS } from './converter/constants';
 export { COUNTRIES } from './object/countries';

package/dist/dts/date/Chronos.d.ts

@@ -3,16 +3,17 @@ import type { LooseLiteral, TupleOf } from '../utils/types';
 import { INTERNALS } from './constants';
 import type { $NativeTzNameOrId, $TimeZoneIdentifier, $UTCOffset, ChronosInput, ChronosInternals, ChronosMethods, ChronosObject, ChronosPlugin, ChronosWithOptions, DateRangeOptions, DateTimeFormatOptions, FormatOptions, LocalesArguments, Milliseconds, MonthName, Quarter, RangeWithDates, RelativeDateRange, RelativeRangeOptions, StrictFormat, TimeParts, TimeUnit, TimeUnitValue, TimeZone, TimeZoneId, TimeZoneIdNative, TimeZoneName, UTCOffset, WeekDay } from './types';
 /**
- * * Creates a new immutable local-aware `Chronos` instance.
+ * * Creates a new immutable `Chronos` instance.
  *
- * **Note**: *If a date is provided **without a time component**, the instance will default to `00:00:00.000` UTC
- * and convert it to the **equivalent local time** using the current environment's UTC offset.*
+ * **Note**:
+ * - *If a date is provided **without a time component**, the instance will default to `00:00:00.000` UTC and convert it to the **equivalent local time** using the current environment's UTC offset.*
  *
  * @param value - A date value (`number`, `string`, `Date`, or `Chronos` object).
- * - If a string is provided, it should be in a format that can be parsed by the `Date` constructor.
+ *
+ * @remarks
+ * - If a string is provided, it should be in a format that can be parsed by the {@link Date} constructor.
  * - If a number is provided, it should be a timestamp (milliseconds since the Unix epoch).
- * - If a `Date` object is provided, it will be used as is.
- * - If a `Chronos` object is provided, it will be converted to a `Date` object.
+ * - If a `Date` or `Chronos` object is provided, it will be handled internally to parse the date value.
  *
  * **It also accepts number values as following:**
  * - **`year, month, date, hours, minutes, seconds, milliseconds`**: Individual components of a date-time to construct a `Chronos` instance.
@@ -68,7 +69,7 @@ export declare class Chronos {
     /** Tracker to identify the instance created by {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/conversion#timezone timeZone} method */
     protected $tzTracker?: $TimeZoneIdentifier | TimeZone | UTCOffset;
     /**
-     * * Creates a new immutable local-aware `Chronos` instance.
+     * * Creates a new immutable `Chronos` instance.
      *
      * Accepts no arguments (defaults to now).
      *
@@ -76,7 +77,7 @@ export declare class Chronos {
      */
     constructor();
     /**
-     * * Creates a new immutable local-aware `Chronos` instance.
+     * * Creates a new immutable `Chronos` instance.
      *
      * @param value - A date value in `number`, it should be a timestamp (milliseconds since the Unix epoch).
      *
@@ -84,26 +85,25 @@ export declare class Chronos {
      */
     constructor(value: number);
     /**
-     * * Creates a new immutable local-aware `Chronos` instance.
+     * * Creates a new immutable `Chronos` instance.
      *
-     * **Note**: *If a date is provided **without a time component**, the instance will default to `00:00:00.000` UTC
-     * and convert it to the **equivalent local time** using the current environment's UTC offset.*
+     * **Note**: *If a date is provided **without a time component**, the instance will default to `00:00:00.000` UTC and convert it to the **equivalent local time** using the current environment's UTC offset.*
      *
-     * @param value - A date value in `string`, it should be in a format that can be parsed by the `Date` constructor.
+     * @param value - A date value in `string`, it should be in a format that can be parsed by the {@link Date} constructor.
      *
      * @returns Instance of `Chronos` with all methods and properties.
      */
     constructor(value: string);
     /**
-     * * Creates a new immutable local-aware `Chronos` instance.
+     * * Creates a new immutable `Chronos` instance.
      *
-     * @param value - A date value as `Date` object, it will be used as is.
+     * @param value - A date value as {@link Date} object.
      *
      * @returns Instance of `Chronos` with all methods and properties.
      */
     constructor(value: Date);
     /**
-     * * Creates a new immutable local-aware `Chronos` instance.
+     * * Creates a new immutable `Chronos` instance.
      *
      * @param value - A date value as `Chronos` object.
      *
@@ -111,10 +111,9 @@ export declare class Chronos {
      */
     constructor(value: Chronos);
     /**
-     * * Creates a new immutable local-aware `Chronos` instance.
+     * * Creates a new immutable `Chronos` instance.
      *
-     * **Note**: *If a date is provided **without a time component**, the instance will default to `00:00:00.000` UTC
-     * and convert it to the **equivalent local time** using the current environment's UTC offset.*
+     * **Note**: *If a date is provided **without a time component**, the instance will default to `00:00:00.000` UTC and convert it to the **equivalent local time** using the current environment's UTC offset.*
      *
      * @param year The full year designation is required for cross-century date accuracy. If year is between 0 and 99, year is assumed to be 1900 + year.
      * @param month The month as a `number` between 1 and 12 (January to December).
@@ -128,10 +127,9 @@ export declare class Chronos {
      */
     constructor(year: number, month: number, date?: number, hours?: number, minutes?: number, seconds?: number, ms?: number);
     /**
-     * * Creates a new immutable local-aware `Chronos` instance.
+     * * Creates a new immutable `Chronos` instance.
      *
-     * **Note**: *If a date is provided **without a time component**, the instance will default to `00:00:00.000` UTC
-     * and convert it to the **equivalent local time** using the current environment's UTC offset.*
+     * **Note**: *If a date is provided **without a time component**, the instance will default to `00:00:00.000` UTC and convert it to the **equivalent local time** using the current environment's UTC offset.*
      *
      * @param value - A date value (`number`, `string`, `Date`, or `Chronos` object).
      * - If a `string` is provided, it should be in a format that can be parsed by the `Date` constructor.

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

@@ -45,6 +45,18 @@ export declare function isURL(value: unknown): value is string;
  * @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 hexadecimal byte sequence.
+ * @param value - The value to check, spaced between bytes or un-spaced.
+ * @returns `true` if the value is a valid hexadecimal byte sequence, otherwise `false`.
+ */
+export declare function isHexString(value: unknown): value is string;
+/**
+ * * Type guard to check if a value is a valid binary byte sequence.
+ * @param value - The value to check, spaced between bytes or un-spaced.
+ * @returns `true` if the value is a valid binary byte sequence, otherwise `false`.
+ */
+export declare function isBinaryString(value: unknown): value is string;
 /**
  * * Type guard to check if a value is a valid phone number.
  * @param value - The value to check.
@@ -66,8 +78,9 @@ export declare function isEnvironment(env: string): boolean;
 /**
  * * Type guard to check if a value is a string representing a finite number.
  *
- * Accepts strings like: `"42"`, `"  -5.5 "`, `"0.123"`, `"-0"`, `"1e5"`.
- * Rejects strings like: `"NaN"`, `"Infinity"`, `"-Infinity"`, `"abc"`, `""`, `"42abc"`.
+ * @remarks
+ * - Accepts strings like: `"42"`, `"  -5.5 "`, `"0.123"`, `"-0"`, `"1e5"`.
+ * - Rejects strings like: `"NaN"`, `"Infinity"`, `"-Infinity"`, `"abc"`, `""`, `"42abc"`.
  *
  * @param value - The value to test.
  * @returns `true` if the value is a string that fully represents a finite number.

package/dist/dts/hash/TextCodec.d.ts

@@ -0,0 +1,166 @@
+/**
+ * @class `TextCodec` provides **UTF-8–safe** conversions between `text`, `hex`, `binary`, and `Base64` representations using byte-level transformations.
+ *
+ * @example
+ * TextCodec.utf8ToHex('ভাষা'); // 'e0 a6 ad e0 a6 be e0 a6 b7 e0 a6 be'
+ * TextCodec.hexToUtf8('e0 a6 ad e0 a6 be'); // 'ভা'
+ */
+export declare class TextCodec {
+    private constructor();
+    /**
+     * @static Validates whether a string represents a valid hexadecimal byte sequence.
+     *
+     * @param hex - Hex string, spaced or un-spaced (e.g. "ff 0a" or "ff0a")
+     * @returns `true` if the input is valid hex byte string
+     *
+     * @example
+     * TextCodec.isValidHex('ff 0a');
+     */
+    static isValidHex(hex: string): boolean;
+    /**
+     * @static Validates whether a string represents a valid binary byte sequence.
+     *
+     * @param binary - Binary string, spaced or un-spaced
+     * @returns `true` if the input is valid binary byte string
+     *
+     * @example
+     * TextCodec.isValidBinary('01000001');
+     */
+    static isValidBinary(binary: string): boolean;
+    /**
+     * @static Validates whether a string represents a valid Base64-encoded string.
+     *
+     * @param b64 - Base64 string to check
+     * @returns `true` if the input is valid Base64-encoded string
+     *
+     * @example
+     * TextCodec.isValidBase64('SGVsbG8=');
+     */
+    static isValidBase64(b64: string): boolean;
+    /**
+     * @static Converts UTF-8 text into hexadecimal byte representation.
+     *
+     * @param text - UTF-8 text to convert
+     * @param spaced - Whether to separate bytes with spaces, defaults to `true`
+     * @returns Hexadecimal byte string
+     *
+     * @example
+     * TextCodec.utf8ToHex('Hi');
+     */
+    static utf8ToHex(text: string, spaced?: boolean): string;
+    /**
+     * @static Converts UTF-8 text into binary byte representation.
+     *
+     * @param text - UTF-8 text to convert
+     * @param spaced - Whether to separate bytes with spaces, defaults to `true`
+     * @returns Binary byte string
+     *
+     * @example
+     * TextCodec.utf8ToBinary('A');
+     */
+    static utf8ToBinary(text: string, spaced?: boolean): string;
+    /**
+     * @static Converts hexadecimal byte string into UTF-8 text.
+     *
+     * @param hex - Hexadecimal byte string
+     * @returns Decoded UTF-8 text
+     *
+     * @example
+     * TextCodec.hexToUtf8('48 69');
+     */
+    static hexToUtf8(hex: string): string;
+    /**
+     * @static Converts binary byte string into UTF-8 text.
+     *
+     * @param binary - Binary byte string
+     * @returns Decoded UTF-8 text
+     *
+     * @example
+     * TextCodec.binaryToUtf8('01001000 01101001');
+     */
+    static binaryToUtf8(binary: string): string;
+    /**
+     * @static Converts hexadecimal byte string into binary byte string.
+     *
+     * @param hex - Hexadecimal byte string
+     * @param spaced - Whether to separate bytes with spaces, defaults to `true`
+     * @returns Binary byte string
+     *
+     * @example
+     * TextCodec.hexToBinary('ff');
+     */
+    static hexToBinary(hex: string, spaced?: boolean): string;
+    /**
+     * @static Converts binary byte string into hexadecimal byte string.
+     *
+     * @param binary - Binary byte string
+     * @param spaced - Whether to separate bytes with spaces, defaults to `true`
+     * @returns Hexadecimal byte string
+     *
+     * @example
+     * TextCodec.binaryToHex('00000001');
+     */
+    static binaryToHex(binary: string, spaced?: boolean): string;
+    /**
+     * @static Converts a Base64-encoded string into UTF-8 text.
+     *
+     * @param b64 - Base64 encoded string
+     * @returns Decoded UTF-8 text
+     *
+     * @example
+     * TextCodec.base64ToUtf8('SGVsbG8=');
+     */
+    static base64ToUtf8(b64: string): string;
+    /**
+     * @static Converts UTF-8 text into a Base64-encoded string.
+     *
+     * @param text - UTF-8 text to encode
+     * @returns Base64 encoded string
+     *
+     * @example
+     * TextCodec.utf8ToBase64('Hello');
+     */
+    static utf8ToBase64(text: string): string;
+    /**
+     * @static Converts Base64 directly into hexadecimal byte string.
+     *
+     * @param b64 - Base64 encoded string
+     * @param spaced - Whether to separate bytes with spaces, defaults to `true`
+     * @returns Hexadecimal byte string
+     *
+     * @example
+     * TextCodec.base64ToHex('SGVsbG8=');
+     */
+    static base64ToHex(b64: string, spaced?: boolean): string;
+    /**
+     * @static Converts Base64 directly into binary byte string.
+     *
+     * @param b64 - Base64 encoded string
+     * @param spaced - Whether to separate bytes with spaces, defaults to `true`
+     * @returns Binary byte string
+     *
+     * @example
+     * TextCodec.base64ToBinary('SGVsbG8=');
+     */
+    static base64ToBinary(b64: string, spaced?: boolean): string;
+    /**
+     * @static Converts hexadecimal byte string into a Base64 string.
+     *
+     * @param hex - Hexadecimal byte string
+     * @returns Base64 encoded string
+     *
+     * @example
+     * TextCodec.hexToBase64('48 69');
+     */
+    static hexToBase64(hex: string): string;
+    /**
+     * @static Converts binary byte string into a Base64 string.
+     *
+     * @param binary - Binary byte string
+     * @returns Base64 encoded string
+     *
+     * @example
+     * TextCodec.binaryToBase64('01001000 01101001');
+     */
+    static binaryToBase64(binary: string): string;
+}

package/dist/dts/hash/helpers.d.ts

@@ -28,3 +28,7 @@ export declare function _checkUUIDVersion(value: unknown, v: `${$UUIDVersion}`):
  * Prevents timing attacks by ensuring equal-time checks regardless of data differences.
  */
 export declare function _constantTimeEquals(a: string | Uint8Array, b: string | Uint8Array): boolean;
+/** Split string by substring length */
+export declare function _splitByCharLength(str: string, splitByChars?: number): string[];
+/** Pad start of a byte with 0 for `hex` or `binary` */
+export declare function _padStartWith0(byte: number, type: 'hex' | 'binary'): string;

package/dist/dts/hash/index.d.ts

@@ -3,5 +3,6 @@ export { generateRandomID, generateRandomID as randomID } from '../string/basics
 export { Cipher } from './Cipher';
 export { md5, sha1, sha256 } from './core';
 export { Signet } from './Signet';
-export { base64ToBytes, bytesToBase64, bytesToHex, bytesToUtf8, concatBytes, hmacSha256, intTo4BytesBE, randomHex, sha256Bytes, uint8To32ArrayBE, utf8ToBytes, } from './utils';
+export { TextCodec } from './TextCodec';
+export { base64ToBytes, bytesToBase64, bytesToHex, bytesToUtf8, concatBytes, hexToBytes, hmacSha256, intTo4BytesBE, randomHex, sha256Bytes, uint8To32ArrayBE, utf8ToBytes, } from './utils';
 export { decodeUUID, isUUIDv1, isUUIDv2, isUUIDv3, isUUIDv4, isUUIDv5, isUUIDv6, isUUIDv7, isUUIDv8, uuid, } from './uuid';

package/dist/dts/hash/utils.d.ts

@@ -343,6 +343,48 @@ export declare function intTo4BytesBE(n: number): Uint8Array;
  * - Converting binary data for JSON serialization
  * - Creating hex-encoded strings for APIs and protocols
  *
+ * @see {@link hexToBytes} for reverse process
  * @see {@link sha256Bytes} for raw byte hash results
  */
 export declare function bytesToHex(bytes: Uint8Array): string;
+/**
+ * * Converts a hexadecimal string to a `Uint8Array`.
+ *   - This function decodes a hexadecimal-encoded string into its raw byte representation, where every two hexadecimal characters (00–ff) are converted into one byte.
+ *
+ * @example
+ * ```ts
+ * // Convert hex to bytes
+ * const hex = '12abff00';
+ * const bytes = hexToBytes(hex);
+ * // Returns: Uint8Array(4) [18, 171, 255, 0]
+ *
+ * // Empty string
+ * const emptyBytes = hexToBytes('');
+ * // Returns: Uint8Array []
+ *
+ * // Decode SHA-256 hash from hex
+ * const hashHex =
+ *   '2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824';
+ * const hashBytes = hexToBytes(hashHex);
+ * // Returns: Uint8Array(32)
+ * ```
+ *
+ * @param hex - A hexadecimal string where each byte is represented by two characters (00–ff).
+ * @returns A `Uint8Array` containing the decoded bytes. Returns an empty array for invalid input.
+ *
+ * @remarks
+ * - Accepts lowercase and uppercase hexadecimal characters (0–9, a–f, A–F) with or without space between bytes
+ * - Ignores no prefixes (e.g., does not support "0x")
+ * - Requires an even number of hexadecimal characters
+ * - Efficient O(n) implementation with direct byte parsing
+ *
+ * **Common use cases:**
+ * - Decoding cryptographic hashes and signatures
+ * - Parsing hex-encoded binary payloads
+ * - Reconstructing binary data from storage or transport formats
+ * - Working with low-level protocols and binary APIs
+ *
+ * @see {@link bytesToHex} for the reverse process
+ * @see {@link isHexString} for input validation
+ */
+export declare function hexToBytes(hex: string): Uint8Array;

package/dist/dts/index.d.ts

@@ -65,4 +65,4 @@ export { Paginator } from './utils/Paginator';
 export { isBigInt, isBoolean, isFalsy, isInteger, isNonEmptyString, isNormalPrimitive, isNull, isNumber, isPositiveInteger, isPrimitive, isString, isSymbol, isTruthy, isUndefined, } from './guards/primitives';
 export { isReturningPromise as doesReturnPromise, isArray, isArrayOfType, isValidArray as isArrayWithLength, isDate, isEmptyObject, isEmptyObject as isEmptyObjectGuard, isError, isFunction, isJSON, isJSON as isJSONObject, isMap, isMethodDescriptor as isMethod, isMethodDescriptor, isNotEmptyObject, isObject, isEmptyObject as isObjectEmpty, isObjectWithKeys, isPromise, isRegExp, isRegExp as isRegularExpression, isReturningPromise, isSet, isValidArray, isJSON as isValidJSON, isMap as isValidMap, isNotEmptyObject as isValidObject, isSet as isValidSet, } from './guards/non-primitives';
 export { HttpStatus, httpStatus } from './http-status/HttpStatus';
-export { isBase64, isBrowser, isDateString, isEmail, isEmailArray, isEnvironment, isEnvironment as isExpectedNodeENV, isIPAddress, isNode, isEnvironment as isNodeENV, isEnvironment as isNodeEnvironment, isNumericString, isPhoneNumber, isURL, isUUID, isEmail as isValidEmail, isURL as isValidURL, } from './guards/specials';
+export { isBase64, isBinaryString, isBrowser, isDateString, isEmail, isEmailArray, isEnvironment, isEnvironment as isExpectedNodeENV, isHexString, isIPAddress, isNode, isEnvironment as isNodeENV, isEnvironment as isNodeEnvironment, isNumericString, isPhoneNumber, isURL, isUUID, isEmail as isValidEmail, isURL as isValidURL, } from './guards/specials';

package/dist/dts/number/Currency.d.ts

@@ -1,5 +1,5 @@
 import type { Numeric } from '../types/index';
-import type { ConvertOptions, CurrencyCode, LocaleCode, SupportedCurrency } from './types';
+import type { ConvertOptions, CurrencyCode, FrankFurterCurrency, LocaleCode } from './types';
 /**
  * * A utility class for handling currency operations like formatting and conversion.
  *
@@ -8,7 +8,7 @@ import type { ConvertOptions, CurrencyCode, LocaleCode, SupportedCurrency } from
  * - Automatically caches conversion rates to reduce redundant API calls.
  * - Intended for use with numeric inputs (number or numeric string).
  */
-export declare class Currency {
+export declare class Currency<Code extends CurrencyCode> {
     #private;
     /**
      * * The formatted currency string (e.g., `$1,000.00`).
@@ -24,7 +24,7 @@ export declare class Currency {
      * @param amount - The numeric amount of currency (e.g., `100`, `'99.99'`).
      * @param code - The ISO 4217 currency code representing the currency (e.g., `'USD'`, `'EUR'`).
      */
-    constructor(amount: Numeric, code: CurrencyCode);
+    constructor(amount: Numeric, code: Code);
     /** * Clears cached rates that were fetched previously. */
     static clearRateCache(): void;
     /**
@@ -39,12 +39,13 @@ export declare class Currency {
     /**
      * @instance Converts the current currency amount to a target currency using real-time exchange rates.
      *
-     * - Uses `api.frankfurter.app` to fetch live exchange rates.
+     * - Uses {@link https://api.frankfurter.app/latest api.frankfurter.app} to fetch live exchange rates.
      * - Supports **only the following fiat currencies**:
      *   `AUD`, `BGN`, `BRL`, `CAD`, `CHF`, `CNY`, `CZK`, `DKK`, `EUR`, `GBP`, `HKD`, `HUF`, `IDR`, `ILS`, `INR`, `ISK`, `JPY`,
      *   `KRW`, `MXN`, `MYR`, `NOK`, `NZD`, `PHP`, `PLN`, `RON`, `SEK`, `SGD`, `THB`, `TRY`, `USD`, `ZAR`.
      * - Uses cached rates unless `forceRefresh` is set to `true`.
      * - If API fails or currency not supported, falls back to `fallbackRate` if provided.
+     * - Use {@link convertSync} method to convert to other currencies using custom exchange rate.
      *
      * @param to - The target currency code (must be one of the supported ones, e.g., `'EUR'`, `'USD'`).
      * @param options - Optional settings:
@@ -56,7 +57,7 @@ export declare class Currency {
      * @example
      * await new Currency(100, 'USD').convert('EUR');
      */
-    convert(to: SupportedCurrency | CurrencyCode, options?: ConvertOptions): Promise<Currency>;
+    convert<To extends FrankFurterCurrency>(to: To, options?: ConvertOptions): Promise<Currency<To>>;
     /**
      * @instance Converts the current currency amount to a target currency using either a cached rate or a manual exchange rate.
      *
@@ -75,5 +76,5 @@ export declare class Currency {
      *
      * console.log(eur.currency); // €92.00
      */
-    convertSync(to: CurrencyCode, rate: number): Currency;
+    convertSync<To extends CurrencyCode>(to: To, rate: number): Currency<To>;
 }

package/dist/dts/number/constants.d.ts

@@ -174,7 +174,7 @@ export declare const CURRENCY_LOCALES: Readonly<{
     readonly ZWL: "en-ZW";
 }>;
 /** * Fiat currencies supported by Frankfurter API */
-export declare const SUPPORTED_CURRENCIES: readonly ["AUD", "BGN", "BRL", "CAD", "CHF", "CNY", "CZK", "DKK", "EUR", "GBP", "HKD", "HUF", "IDR", "ILS", "INR", "ISK", "JPY", "KRW", "MXN", "MYR", "NOK", "NZD", "PHP", "PLN", "RON", "SEK", "SGD", "THB", "TRY", "USD", "ZAR"];
+export declare const FRANKFURTER_CURRENCIES: readonly ["AUD", "BGN", "BRL", "CAD", "CHF", "CNY", "CZK", "DKK", "EUR", "GBP", "HKD", "HUF", "IDR", "ILS", "INR", "ISK", "JPY", "KRW", "MXN", "MYR", "NOK", "NZD", "PHP", "PLN", "RON", "SEK", "SGD", "THB", "TRY", "USD", "ZAR"];
 /** * Unit names and their full readable labels. */
 export declare const UNITS: Readonly<{
     readonly m: "Meter";

package/dist/dts/number/types.d.ts

@@ -1,6 +1,6 @@
 import type { Maybe } from '../types/index';
 import type { LooseLiteral } from '../utils/types';
-import type { CURRENCY_CODES, CURRENCY_LOCALES, LOCALE_CODES, PREFIX_MULTIPLIERS, SUPPORTED_CURRENCIES, UNITS } from './constants';
+import type { CURRENCY_CODES, CURRENCY_LOCALES, FRANKFURTER_CURRENCIES, LOCALE_CODES, PREFIX_MULTIPLIERS, UNITS } from './constants';
 import type { Unit } from './Unit';
 /** Enumerate & Enumerate Internal: builds a union of all numbers from 0 to N - 1 */
 type $EnumerateInternal<N extends number, Acc extends number[] = []> = Acc['length'] extends N ? Acc[number] : $EnumerateInternal<N, [...Acc, Acc['length']]>;
@@ -74,7 +74,8 @@ export type CurrencyCode = keyof typeof CURRENCY_LOCALES | (typeof CURRENCY_CODE
 /** - List of all supported BCP 47 locales */
 export type LocaleCode = (typeof CURRENCY_LOCALES)[keyof typeof CURRENCY_LOCALES] | (typeof LOCALE_CODES)[number];
 /** * Fiat currencies supported by Frankfurter API */
-export type SupportedCurrency = (typeof SUPPORTED_CURRENCIES)[number];
+export type FrankFurterCurrency = (typeof FRANKFURTER_CURRENCIES)[number];
+export type { FrankFurterCurrency as SupportedCurrency };
 /** - Options for `convert` method in `Currency` class */
 export interface ConvertOptions {
     /** A manual exchange rate to use if the API call fails. */
@@ -85,9 +86,9 @@ export interface ConvertOptions {
 /** Type Interface for API Response from `api.frankfurter.app` */
 export interface FrankFurter {
     amount: number;
-    base: CurrencyCode;
+    base: FrankFurterCurrency;
     date: string;
-    rates: Record<CurrencyCode, number>;
+    rates: Record<FrankFurterCurrency, number>;
 }
 /** * Options to calculate what percentage a `part` is of a `total`. */
 export interface GetPercentOptions {
@@ -212,4 +213,3 @@ export type RomanNumeral = RomanCapital | Lowercase<RomanCapital>;
  * - The {@link LooseLiteral} wrapper allows non-literal strings (e.g., variables) without losing IntelliSense for literals.
  */
 export type LooseRomanNumeral = LooseLiteral<RomanNumeral>;
-export {};

package/dist/esm/constants.js

@@ -3,7 +3,7 @@ export { IANA_TZ_IDS, NATIVE_TZ_IDS, TIME_ZONE_IDS, TIME_ZONE_LABELS, TIME_ZONES
 export { AUSTRALIA_SEASONS, BANGLADESH_SEASONS, ETHIOPIA_SEASONS, INDIA_IMD_SEASONS, INDIA_TAMIL_SEASONS, INDIA_VEDIC_SEASONS, JAPAN_SEASONS, PHILIPPINES_SEASONS, SEASON_PRESETS, US_ACADEMIC_SEASONS, DEFAULT_SEASONS as WESTERN_SEASONS, } from './date/seasons.js';
 export { ALPHABET_COLOR_PALETTE, NUMBER_COLOR_PALETTE } from './colors/constants.js';
 export { CSS_COLORS } from './colors/css-colors.js';
-export { CURRENCY_CODES, CURRENCY_LOCALES, SUPPORTED_CURRENCIES as FRANKFURTER_CURRENCIES, UNITS as GENERAL_UNITS, LOCALE_CODES, } from './number/constants.js';
+export { CURRENCY_CODES, CURRENCY_LOCALES, FRANKFURTER_CURRENCIES, UNITS as GENERAL_UNITS, LOCALE_CODES, } from './number/constants.js';
 export { LOWERCASE as LOWERCASED_WORDS } from './string/constants.js';
 export { UNITS as CATEGORIZED_UNITS } from './converter/constants.js';
 export { COUNTRIES } from './object/countries.js';

package/dist/esm/guards/specials.js

@@ -35,6 +35,14 @@ export function isBase64(value) {
     return (isString(value) &&
         /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.test(value));
 }
+export function isHexString(value) {
+    return (isString(value) &&
+        /^[\da-fA-F\s]+$/.test(value) &&
+        value.replace(/\s+/g, '').length % 2 === 0);
+}
+export function isBinaryString(value) {
+    return (isString(value) && /^[01\s]+$/.test(value) && value.replace(/\s+/g, '').length % 8 === 0);
+}
 export function isPhoneNumber(value) {
     return isString(value) && /^\+?[1-9]\d{1,14}$/.test(value);
 }

package/dist/esm/hash/TextCodec.js

@@ -0,0 +1,71 @@
+import { isNonEmptyString } from '../guards/primitives.js';
+import { isBase64, isBinaryString, isHexString } from '../guards/specials.js';
+import { _padStartWith0, _splitByCharLength } from './helpers.js';
+import { base64ToBytes, bytesToBase64, bytesToUtf8, hexToBytes, utf8ToBytes } from './utils.js';
+export class TextCodec {
+    constructor() { }
+    static isValidHex(hex) {
+        return isHexString(hex);
+    }
+    static isValidBinary(binary) {
+        return isBinaryString(binary);
+    }
+    static isValidBase64(b64) {
+        return isBase64(b64);
+    }
+    static utf8ToHex(text, spaced = true) {
+        return [...utf8ToBytes(text)]
+            .map((b) => _padStartWith0(b, 'hex'))
+            .join(spaced ? ' ' : '');
+    }
+    static utf8ToBinary(text, spaced = true) {
+        return [...utf8ToBytes(text)]
+            .map((b) => _padStartWith0(b, 'binary'))
+            .join(spaced ? ' ' : '');
+    }
+    static hexToUtf8(hex) {
+        return bytesToUtf8(hexToBytes(hex));
+    }
+    static binaryToUtf8(binary) {
+        if (!isBinaryString(binary))
+            return '';
+        const bytes = _splitByCharLength(binary, 8).map((b) => parseInt(b, 2));
+        return bytesToUtf8(new Uint8Array(bytes));
+    }
+    static hexToBinary(hex, spaced = true) {
+        if (!isHexString(hex))
+            return '';
+        return _splitByCharLength(hex, 2)
+            .map((h) => _padStartWith0(parseInt(h, 16), 'binary'))
+            .join(spaced ? ' ' : '');
+    }
+    static binaryToHex(binary, spaced = true) {
+        if (!isBinaryString(binary))
+            return '';
+        return _splitByCharLength(binary, 8)
+            .map((b) => _padStartWith0(parseInt(b, 2), 'hex'))
+            .join(spaced ? ' ' : '');
+    }
+    static base64ToUtf8(b64) {
+        if (!isBase64(b64))
+            return '';
+        return bytesToUtf8(base64ToBytes(b64));
+    }
+    static utf8ToBase64(text) {
+        if (!isNonEmptyString(text))
+            return '';
+        return bytesToBase64(utf8ToBytes(text));
+    }
+    static base64ToHex(b64, spaced = true) {
+        return this.utf8ToHex(this.base64ToUtf8(b64), spaced);
+    }
+    static base64ToBinary(b64, spaced = true) {
+        return this.utf8ToBinary(this.base64ToUtf8(b64), spaced);
+    }
+    static hexToBase64(hex) {
+        return this.utf8ToBase64(this.hexToUtf8(hex));
+    }
+    static binaryToBase64(binary) {
+        return this.utf8ToBase64(this.binaryToUtf8(binary));
+    }
+}

package/dist/esm/hash/helpers.js

@@ -156,3 +156,16 @@ export function _constantTimeEquals(a, b) {
     }
     return res === 0;
 }
+export function _splitByCharLength(str, splitByChars = 2) {
+    if (!isNonEmptyString(str))
+        return [];
+    const sanitized = str.replace(/\s+/g, '');
+    const result = [];
+    for (let i = 0; i < sanitized.length; i += splitByChars) {
+        result.push(sanitized.slice(i, i + splitByChars));
+    }
+    return result;
+}
+export function _padStartWith0(byte, type) {
+    return byte.toString(type === 'hex' ? 16 : 2).padStart(type === 'hex' ? 2 : 8, '0');
+}

package/dist/esm/hash/index.js

@@ -3,5 +3,6 @@ export { generateRandomID, generateRandomID as randomID } from '../string/basics
 export { Cipher } from './Cipher.js';
 export { md5, sha1, sha256 } from './core.js';
 export { Signet } from './Signet.js';
-export { base64ToBytes, bytesToBase64, bytesToHex, bytesToUtf8, concatBytes, hmacSha256, intTo4BytesBE, randomHex, sha256Bytes, uint8To32ArrayBE, utf8ToBytes, } from './utils.js';
+export { TextCodec } from './TextCodec.js';
+export { base64ToBytes, bytesToBase64, bytesToHex, bytesToUtf8, concatBytes, hexToBytes, hmacSha256, intTo4BytesBE, randomHex, sha256Bytes, uint8To32ArrayBE, utf8ToBytes, } from './utils.js';
 export { decodeUUID, isUUIDv1, isUUIDv2, isUUIDv3, isUUIDv4, isUUIDv5, isUUIDv6, isUUIDv7, isUUIDv8, uuid, } from './uuid.js';

package/dist/esm/hash/utils.js

@@ -1,3 +1,5 @@
+import { isHexString } from '../guards/specials.js';
+import { _splitByCharLength } from './helpers.js';
 export function randomHex(length, uppercase = false) {
     const genHex = () => Math.floor(Math.random() * 16).toString(16);
     const hex = Array.from({ length }, genHex).join('');
@@ -237,3 +239,9 @@ export function bytesToHex(bytes) {
     }
     return hex;
 }
+export function hexToBytes(hex) {
+    if (!isHexString(hex))
+        return new Uint8Array();
+    const bytes = _splitByCharLength(hex, 2).map((h) => parseInt(h, 16));
+    return new Uint8Array(bytes);
+}

package/dist/esm/index.js

@@ -50,4 +50,4 @@ export { Paginator } from './utils/Paginator.js';
 export { isBigInt, isBoolean, isFalsy, isInteger, isNonEmptyString, isNormalPrimitive, isNull, isNumber, isPositiveInteger, isPrimitive, isString, isSymbol, isTruthy, isUndefined, } from './guards/primitives.js';
 export { isReturningPromise as doesReturnPromise, isArray, isArrayOfType, isValidArray as isArrayWithLength, isDate, isEmptyObject, isEmptyObject as isEmptyObjectGuard, isError, isFunction, isJSON, isJSON as isJSONObject, isMap, isMethodDescriptor as isMethod, isMethodDescriptor, isNotEmptyObject, isObject, isEmptyObject as isObjectEmpty, isObjectWithKeys, isPromise, isRegExp, isRegExp as isRegularExpression, isReturningPromise, isSet, isValidArray, isJSON as isValidJSON, isMap as isValidMap, isNotEmptyObject as isValidObject, isSet as isValidSet, } from './guards/non-primitives.js';
 export { HttpStatus, httpStatus } from './http-status/HttpStatus.js';
-export { isBase64, isBrowser, isDateString, isEmail, isEmailArray, isEnvironment, isEnvironment as isExpectedNodeENV, isIPAddress, isNode, isEnvironment as isNodeENV, isEnvironment as isNodeEnvironment, isNumericString, isPhoneNumber, isURL, isUUID, isEmail as isValidEmail, isURL as isValidURL, } from './guards/specials.js';
+export { isBase64, isBinaryString, isBrowser, isDateString, isEmail, isEmailArray, isEnvironment, isEnvironment as isExpectedNodeENV, isHexString, isIPAddress, isNode, isEnvironment as isNodeENV, isEnvironment as isNodeEnvironment, isNumericString, isPhoneNumber, isURL, isUUID, isEmail as isValidEmail, isURL as isValidURL, } from './guards/specials.js';

package/dist/esm/number/Currency.js

@@ -8,37 +8,37 @@ export class Currency {
         this.#code = code;
         this.currency = this.format('en-US');
     }
-    static #rateCache = new Map();
+    static #RATE_CACHE = new Map();
     static clearRateCache() {
-        Currency.#rateCache.clear();
+        Currency.#RATE_CACHE.clear();
     }
     format(locale, code) {
         return formatCurrency(this.#amount, code ?? this.#code, locale);
     }
     async convert(to, options) {
         const key = `${this.#code}->${to}`;
-        if (!options?.forceRefresh && Currency.#rateCache.has(key)) {
-            const cachedRate = Currency.#rateCache.get(key);
+        if (!options?.forceRefresh && Currency.#RATE_CACHE.has(key)) {
+            const cachedRate = Currency.#RATE_CACHE.get(key);
             return new Currency(this.#amount * cachedRate, to);
         }
         try {
             const rate = await this.#fetchFromFrankfurter(to);
-            Currency.#rateCache.set(key, rate);
+            Currency.#RATE_CACHE.set(key, rate);
             return new Currency(this.#amount * rate, to);
         }
         catch (error) {
             if (options?.fallbackRate != null) {
-                console.warn(`Currency conversion failed (${this.#code} → ${to}): ${error.message}. Using fallback rate...`);
+                console.warn(`Currency conversion failed (${this.#code} → ${to}): ${error?.message}. Using fallback rate...`);
                 return new Currency(this.#amount * options.fallbackRate, to);
             }
             else {
-                throw new Error(`Currency conversion failed (${this.#code} → ${to}): ${error.message}`);
+                throw new Error(`Currency conversion failed (${this.#code} → ${to}): ${error?.message}`);
             }
         }
     }
     convertSync(to, rate) {
         const key = `${this.#code}->${to}`;
-        const cachedRate = Currency.#rateCache.get(key);
+        const cachedRate = Currency.#RATE_CACHE.get(key);
         if (cachedRate) {
             return new Currency(this.#amount * cachedRate, to);
         }
@@ -50,7 +50,7 @@ export class Currency {
         }
     }
     async #fetchFromFrankfurter(to) {
-        const url = `https://api.frankfurter.app/latest?amount=${this.#amount}&from=${this.#code}`;
+        const url = `https://api.frankfurter.app/latest?amount=1&from=${this.#code}`;
         try {
             const res = await fetch(url, { redirect: 'error' });
             if (!res.ok) {
@@ -58,12 +58,12 @@ export class Currency {
             }
             const data = await res.json();
             if (!data.rates?.[to]) {
-                throw new Error(`Currency "${to}" not allowed or not found in FrankFurter Database!`);
+                throw new Error(`Currency "${to}" is not found in FrankFurter Database!`);
             }
-            return data.rates[to] / this.#amount;
+            return data.rates[to];
         }
         catch (error) {
-            throw new Error(error.message || `Failed to fetch data from FrankFurter API`);
+            throw new Error(error?.message || `Failed to fetch data from FrankFurter API`);
         }
     }
 }

package/dist/esm/number/constants.js

@@ -538,7 +538,7 @@ export const CURRENCY_LOCALES = /* @__PURE__ */ Object.freeze({
     ZMW: 'en-ZM',
     ZWL: 'en-ZW',
 });
-export const SUPPORTED_CURRENCIES = /* @__PURE__ */ Object.freeze([
+export const FRANKFURTER_CURRENCIES = /* @__PURE__ */ Object.freeze([
     'AUD',
     'BGN',
     'BRL',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.28.24",
+  "version": "4.28.40",
   "description": "A versatile collection of smart, efficient, and reusable utility functions, classes and types for everyday development needs.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -39,12 +39,12 @@
   },
   "license": "Apache-2.0",
   "devDependencies": {
-    "@eslint/js": "^9.39.1",
+    "@eslint/js": "^9.39.2",
     "@types/jest": "^30.0.0",
-    "@types/node": "^25.0.0",
+    "@types/node": "^25.0.1",
     "@typescript-eslint/eslint-plugin": "^8.49.0",
     "@typescript-eslint/parser": "^8.49.0",
-    "eslint": "^9.39.1",
+    "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",
     "globals": "^16.5.0",