nhb-toolbox 4.28.4 → 4.28.7

package/CHANGELOG.md

@@ -6,6 +6,15 @@ 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`.
+
 ## [4.28.4] - 2025-12-02
 
 - **Updated** *implementation* and *tsdoc* for:
@@ -32,7 +41,7 @@ All notable changes to the package will be documented here.
 
 ## [4.27.10] - 2025-11-28
 
-- **Updated** type augmentation for `String` methods: `toLowerCase` and `toUpperCase` (type level only, implementation remains intact).
+- **Updated** *type augmentation* for `String` methods: `toLowerCase` and `toUpperCase` (type level only, implementation remains intact).
 
 ## [4.27.1] - 2025-11-28
 

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/string/types.d.ts

@@ -4,9 +4,27 @@ import type { LOWERCASE } from './constants';
 declare global {
     interface String {
         toLowerCase(): string;
-        toLowerCase<C extends 'T' | string>(): C extends 'T' ? Lowercase<string> : Lowercase<C>;
+        /**
+         * * Converts all the alphabetic characters in a string to lowercase.
+         *
+         * @typeParam `Lower` - A type-level flag. If `'T'`, returns the lowercase string type (`Lowercase<string>`). Otherwise, returns literal `Lower` (must be Lowercase type).
+         *
+         * @remarks
+         * - This augmentation only affects TypeScript type inference.
+         * - Runtime behavior remains identical to the standard `toLowerCase()` method.
+         */
+        toLowerCase<Lower extends 'T' | Lowercase<string>>(): Lower extends 'T' ? Lowercase<string> : Lower;
         toUpperCase(): string;
-        toUpperCase<C extends 'T' | string>(): C extends 'T' ? Uppercase<string> : Uppercase<C>;
+        /**
+         * * Converts all the alphabetic characters in a string to uppercase.
+         *
+         * @typeParam `Upper` - A type-level flag. If `'T'`, returns the uppercase string type (`Uppercase<string>`). Otherwise, returns literal `Upper` (must be Uppercase type).
+         *
+         * @remarks
+         * - This augmentation only affects TypeScript type inference.
+         * - Runtime behavior remains identical to the standard `toUpperCase()` method.
+         */
+        toUpperCase<Upper extends 'T' | Uppercase<string>>(): Upper extends 'T' ? Uppercase<string> : Upper;
     }
 }
 /** - Options for generating anagrams. */

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

@@ -122,8 +122,7 @@ export declare function getStaticGetterNames(cls: Constructor): string[];
 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.
- *
+ *   - The output format matches standard JSON but with guaranteed sorted keys.
  *
  * @remarks
  * - This function guarantees **stable, repeatable output** by:
@@ -131,7 +130,7 @@ export declare function getClassDetails(cls: Constructor): ClassDetails;
  * 	 - Recursively stabilizing nested objects and arrays.
  * 	 - Converting all `undefined` values into `null` so the output remains valid JSON.
  *   - Converting date-like objects (`Date`, `Chronos`, `Moment.js`, `Day.js`, `Luxon`, `JS-Joda`, `Temporal`) **in the same way that {@link JSON.stringify} would serialize them**, ensuring predictable and JSON-compliant output.
- * 	 - Falling back to native JSON serialization for primitives.
+ *   - Falling back to native JSON serialization for primitives.
  *
  * - **Useful for:**
  *   - Hash generation (e.g., signatures, cache keys)

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.4",
+  "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",