nhb-toolbox 4.28.6 → 4.28.7

package/CHANGELOG.md

@@ -6,9 +6,14 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [4.28.7] - 2025-12-02
+
+- **Updated** *invalid links* in *tsdoc* of the *hash utilities*.
+- **Implemented** input type *validation* for `sha256` utility.
+
 ## [4.28.6] - 2025-12-02
 
-- **Updated** *tsdoc* for `stableStringify` + *type augmentation* for `String` methods: `toLowerCase` and `toUpperCase`
+- **Updated** *tsdoc* for `stableStringify` + *type augmentation* for `String` methods: `toLowerCase` and `toUpperCase`.
 
 ## [4.28.4] - 2025-12-02
 

package/dist/cjs/hash/core.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.md5 = md5;
 exports.sha1 = sha1;
 exports.sha256 = sha256;
+const primitives_1 = require("../guards/primitives");
 const helpers_1 = require("./helpers");
 const utils_1 = require("./utils");
 function md5(str) {
@@ -85,5 +86,7 @@ function sha1(msg) {
     return h.map(toHex).join('');
 }
 function sha256(msg) {
+    if (!(0, primitives_1.isString)(msg))
+        throw new TypeError('Input must be of type string!');
     return (0, utils_1.bytesToHex)((0, utils_1.sha256Bytes)((0, utils_1.utf8ToBytes)(msg)));
 }

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

@@ -59,8 +59,8 @@ export declare function sha1(msg: string): string;
  * // Returns: '7037e204b825b83553ba336a6ec35b796d505599286ae864729ed6cb33ae9fe1'
  * ```
  *
- * @see {@link https://toolbox.nazmul-nhb.dev/docs/utilities/hash/sha256Bytes sha256Bytes} for hashing raw bytes
+ * @see {@link https://toolbox.nazmul-nhb.dev/docs/utilities/hash/encoding#sha256bytes sha256Bytes} for hashing raw bytes
  * @see {@link https://toolbox.nazmul-nhb.dev/docs/utilities/hash/encoding#utf8tobytes utf8ToBytes} for converting string to bytes
- * @see {@link https://toolbox.nazmul-nhb.dev/docs/utilities/hash/encoding#bytestotex bytesToHex} for converting bytes to a hexadecimal string
+ * @see {@link https://toolbox.nazmul-nhb.dev/docs/utilities/hash/encoding#bytestohex bytesToHex} for converting bytes to a hexadecimal string
  */
 export declare function sha256(msg: string): string;

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

@@ -124,7 +124,6 @@ export declare function getClassDetails(cls: Constructor): ClassDetails;
  * * Create a deterministic JSON string representation of any value.
  *   - The output format matches standard JSON but with guaranteed sorted keys.
  *
- *
  * @remarks
  * - This function guarantees **stable, repeatable output** by:
  * 	 - Sorting all object keys alphabetically.

package/dist/esm/hash/core.js

@@ -1,3 +1,4 @@
+import { isString } from '../guards/primitives.js';
 import { _md5cycle, _numToHex, _stringToNumbers } from './helpers.js';
 import { bytesToHex, sha256Bytes, utf8ToBytes } from './utils.js';
 export function md5(str) {
@@ -80,5 +81,7 @@ export function sha1(msg) {
     return h.map(toHex).join('');
 }
 export function sha256(msg) {
+    if (!isString(msg))
+        throw new TypeError('Input must be of type string!');
     return bytesToHex(sha256Bytes(utf8ToBytes(msg)));
 }

package/package.json

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