nhb-toolbox 4.30.0 → 4.30.1

package/CHANGELOG.md

@@ -4,6 +4,10 @@
 
 All notable changes to the package will be documented here.
 
+## [4.30.1] - 2026-04-27
+
+- **Updated** *random hex generation* logic in `randomHex` and `uuid` utilities to use `crypto.getRandomValues` for better performance and security when available, with a fallback to `Math.random` for environments where `crypto` is not available.
+
 ## [4.30.0] - 2026-04-27
 
 - **Added** new utility `getCountryByPhone` to get country details (country name, country code, ISO short code, and ISO code) by matching the country code in the given phone number.

package/README.md

@@ -11,7 +11,7 @@
     <img src="https://img.shields.io/npm/v/nhb-toolbox.svg?label=NPM&style=flat&color=teal&logo=npm" alt="Latest Version" />
   </a>
   <a href="https://bundlejs.com/?q=nhb-toolbox" aria-label="Bundle Size">
-    <img src="https://deno.bundlejs.com/badge?q=nhb-toolbox" alt="Bundle Size" />
+    <img src="https://img.shields.io/bundlejs/size/nhb-toolbox?label=Bundle%20Size&style=flat&color=blue&logo=npm" alt="Bundle Size" />
   </a>
 
   <!-- Project Metadata -->

package/dist/cjs/hash/helpers.js

@@ -5,6 +5,7 @@ exports._stringToNumbers = _stringToNumbers;
 exports._md5cycle = _md5cycle;
 exports._uuidTimestamp = _uuidTimestamp;
 exports._randomNode48 = _randomNode48;
+exports._bytesToRandomHex = _bytesToRandomHex;
 exports._clockSeq14 = _clockSeq14;
 exports._formatUUID = _formatUUID;
 exports._isOptionV3V5 = _isOptionV3V5;
@@ -135,6 +136,21 @@ function _randomNode48() {
     const modified = (firstByte | 0b00000001).toString(16).padStart(2, '0');
     return modified + node.slice(2).join('');
 }
+function _bytesToRandomHex(bytes) {
+    if (crypto?.getRandomValues) {
+        crypto.getRandomValues(bytes);
+    }
+    else {
+        for (let i = 0; i < bytes.length; i++) {
+            bytes[i] = Math.floor(Math.random() * 256);
+        }
+    }
+    let hex = '';
+    for (let i = 0; i < bytes.length; i++) {
+        hex += bytes[i].toString(16).padStart(2, '0');
+    }
+    return hex;
+}
 function _clockSeq14() {
     const seq = parseInt((0, utils_1.randomHex)(4), 16) & 0x3fff;
     return seq.toString(16).padStart(4, '0');

package/dist/cjs/hash/utils.js

@@ -15,9 +15,11 @@ 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('');
-    return uppercase ? hex.toUpperCase() : hex;
+    if (length <= 0)
+        return '';
+    const bytes = new Uint8Array(Math.ceil(length / 2));
+    const expected = (0, helpers_1._bytesToRandomHex)(bytes).slice(0, length);
+    return uppercase ? expected.toUpperCase() : expected;
 }
 function utf8ToBytes(str) {
     const out = [];

package/dist/cjs/hash/uuid.js

@@ -42,19 +42,7 @@ function uuid(options) {
             throw new Error('v3 requires valid namespace (uuid) and name!');
         }
         case 'v4': {
-            const bytes = new Uint8Array(16);
-            if (crypto.getRandomValues) {
-                crypto.getRandomValues(bytes);
-            }
-            else {
-                for (let i = 0; i < 16; i++) {
-                    bytes[i] = Math.floor(Math.random() * 256);
-                }
-            }
-            let hex = '';
-            for (let i = 0; i < 16; i++) {
-                hex += bytes[i].toString(16).padStart(2, '0');
-            }
+            const hex = (0, helpers_1._bytesToRandomHex)(new Uint8Array(16));
             return (0, helpers_1._formatUUID)(hex, 4, uppercase);
         }
         case 'v5': {
@@ -93,18 +81,7 @@ function uuid(options) {
                 bytes[i] = Number(temp & 0xffn);
                 temp >>= 8n;
             }
-            if (crypto.getRandomValues) {
-                crypto.getRandomValues(bytes);
-            }
-            else {
-                for (let i = 6; i < 16; i++) {
-                    bytes[i] = Math.floor(Math.random() * 256);
-                }
-            }
-            let hex = '';
-            for (let i = 0; i < 16; i++) {
-                hex += bytes[i].toString(16).padStart(2, '0');
-            }
+            const hex = (0, helpers_1._bytesToRandomHex)(bytes);
             return (0, helpers_1._formatUUID)(hex, 8, uppercase);
         }
         default:

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

@@ -15,6 +15,12 @@ export declare function _uuidTimestamp(): bigint;
  * LSB of first byte must be 1 to indicate a randomly generated node.
  */
 export declare function _randomNode48(): string;
+/**
+ * Generates random hex string of given byte length using crypto API if available, otherwise falls back to Math.random.
+ * @param bytes Instance of {@link Uint8Array} to fill with random values.
+ * @returns Hex string representation of the random bytes.
+ */
+export declare function _bytesToRandomHex(bytes: Uint8Array<ArrayBuffer>): string;
 /** * Generates a 14-bit clock sequence (2 bytes, but only 14 bits used). */
 export declare function _clockSeq14(): string;
 /** Convert a hex string to UUID format */

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

@@ -2,10 +2,16 @@
  * * Generates a random hexadecimal string of the specified length.
  *
  * @param length - Number of hex characters to generate.
- * @param uppercase - Whether to return uppercase `A–F` characters.
+ * @param uppercase - Whether to return uppercase `A–F` characters. Defaults to `false` (lowercase).
  *
  * @returns A randomly generated hexadecimal string.
  *
+ * @remarks
+ * - This function generates a random hexadecimal string of the specified length.
+ * - It uses {@link crypto.getRandomValues} when available for secure randomness, and falls back to {@link Math.random} if not.
+ * - The output is a string of hex characters (`0–9`, `a–f` or `A–F`) with no prefixes or separators.
+ * - If `length` is `0` or negative, an empty string is returned.
+ *
  * @example
  * // 16-character lowercase hex
  * const id = randomHex(16);

package/dist/esm/hash/helpers.js

@@ -121,6 +121,21 @@ export function _randomNode48() {
     const modified = (firstByte | 0b00000001).toString(16).padStart(2, '0');
     return modified + node.slice(2).join('');
 }
+export function _bytesToRandomHex(bytes) {
+    if (crypto?.getRandomValues) {
+        crypto.getRandomValues(bytes);
+    }
+    else {
+        for (let i = 0; i < bytes.length; i++) {
+            bytes[i] = Math.floor(Math.random() * 256);
+        }
+    }
+    let hex = '';
+    for (let i = 0; i < bytes.length; i++) {
+        hex += bytes[i].toString(16).padStart(2, '0');
+    }
+    return hex;
+}
 export function _clockSeq14() {
     const seq = parseInt(randomHex(4), 16) & 0x3fff;
     return seq.toString(16).padStart(4, '0');

package/dist/esm/hash/utils.js

@@ -1,9 +1,11 @@
 import { isHexString } from '../guards/specials.js';
-import { _splitByCharLength } from './helpers.js';
+import { _bytesToRandomHex, _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('');
-    return uppercase ? hex.toUpperCase() : hex;
+    if (length <= 0)
+        return '';
+    const bytes = new Uint8Array(Math.ceil(length / 2));
+    const expected = _bytesToRandomHex(bytes).slice(0, length);
+    return uppercase ? expected.toUpperCase() : expected;
 }
 export function utf8ToBytes(str) {
     const out = [];

package/dist/esm/hash/uuid.js

@@ -1,6 +1,6 @@
 import { isUUID } from '../guards/specials.js';
 import { md5, sha1 } from './core.js';
-import { _checkUUIDVersion, _clockSeq14, _formatUUID, _isOptionV3V5, _randomNode48, _uuidTimestamp, } from './helpers.js';
+import { _bytesToRandomHex, _checkUUIDVersion, _clockSeq14, _formatUUID, _isOptionV3V5, _randomNode48, _uuidTimestamp, } from './helpers.js';
 import { randomHex } from './utils.js';
 export function uuid(options) {
     const { version = 'v4', uppercase = false } = options || {};
@@ -30,19 +30,7 @@ export function uuid(options) {
             throw new Error('v3 requires valid namespace (uuid) and name!');
         }
         case 'v4': {
-            const bytes = new Uint8Array(16);
-            if (crypto.getRandomValues) {
-                crypto.getRandomValues(bytes);
-            }
-            else {
-                for (let i = 0; i < 16; i++) {
-                    bytes[i] = Math.floor(Math.random() * 256);
-                }
-            }
-            let hex = '';
-            for (let i = 0; i < 16; i++) {
-                hex += bytes[i].toString(16).padStart(2, '0');
-            }
+            const hex = _bytesToRandomHex(new Uint8Array(16));
             return _formatUUID(hex, 4, uppercase);
         }
         case 'v5': {
@@ -81,18 +69,7 @@ export function uuid(options) {
                 bytes[i] = Number(temp & 0xffn);
                 temp >>= 8n;
             }
-            if (crypto.getRandomValues) {
-                crypto.getRandomValues(bytes);
-            }
-            else {
-                for (let i = 6; i < 16; i++) {
-                    bytes[i] = Math.floor(Math.random() * 256);
-                }
-            }
-            let hex = '';
-            for (let i = 0; i < 16; i++) {
-                hex += bytes[i].toString(16).padStart(2, '0');
-            }
+            const hex = _bytesToRandomHex(bytes);
             return _formatUUID(hex, 8, uppercase);
         }
         default:

package/package.json

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