nhb-toolbox 4.28.6 → 4.28.8

package/CHANGELOG.md

@@ -6,9 +6,18 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [4.28.8] - 2025-12-03
+
+- **Fixed** a *tree-shaking issue* affecting `Chronos` and other *date/time utilities* by removing a *pre-compiled* `RegExp` instance from **date/constants**.
+
+## [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/date/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MS_MAP = exports.TIME_UNIT_REGEX = exports.TIME_UNIT_VARIANTS = exports.ZODIAC_PRESETS = exports.VEDIC_ZODIAC_SIGNS = exports.WESTERN_ZODIAC_SIGNS = exports.DATE_PART_RANGES = exports.SORTED_TIME_FORMATS = exports.TIME_FORMATS = exports.MILLISECOND_FORMATS = exports.ZONE_FORMATS = exports.SECOND_FORMATS = exports.MINUTE_FORMATS = exports.HOUR_FORMATS = exports.DAY_FORMATS = exports.DATE_FORMATS = exports.MONTH_FORMATS = exports.YEAR_FORMATS = exports.MONTHS = exports.DAYS = exports.INTERNALS = void 0;
+exports.MS_MAP = exports.TIME_UNIT_VARIANTS = exports.ZODIAC_PRESETS = exports.VEDIC_ZODIAC_SIGNS = exports.WESTERN_ZODIAC_SIGNS = exports.DATE_PART_RANGES = exports.SORTED_TIME_FORMATS = exports.TIME_FORMATS = exports.MILLISECOND_FORMATS = exports.ZONE_FORMATS = exports.SECOND_FORMATS = exports.MINUTE_FORMATS = exports.HOUR_FORMATS = exports.DAY_FORMATS = exports.DATE_FORMATS = exports.MONTH_FORMATS = exports.YEAR_FORMATS = exports.MONTHS = exports.DAYS = exports.INTERNALS = void 0;
 exports.INTERNALS = Symbol('Internals');
 exports.DAYS = /* @__PURE__ */ Object.freeze([
     'Sunday',
@@ -106,11 +106,6 @@ exports.TIME_UNIT_VARIANTS = /* @__PURE__ */ Object.freeze({
     second: ['s', 'sec', 'secs', 'second', 'seconds'],
     millisecond: ['ms', 'msec', 'msecs', 'millisecond', 'milliseconds'],
 });
-const TIME_UNIT_REGEX_STR = /* @__PURE__ */ Object.freeze(Object.values(exports.TIME_UNIT_VARIANTS)
-    .flat()
-    .sort((a, b) => b.length - a.length)
-    .join('|'));
-exports.TIME_UNIT_REGEX = /* @__PURE__ */ Object.freeze(new RegExp(`^(?<value>-?\\d*\\.?\\d+) *(?<unit>${TIME_UNIT_REGEX_STR})?$`, 'i'));
 exports.MS_MAP = /* @__PURE__ */ Object.freeze((() => {
     const s = 1000;
     const m = s * 60;

package/dist/cjs/date/guards.js

@@ -10,7 +10,6 @@ exports.isTimeWithUnit = isTimeWithUnit;
 const primitives_1 = require("../guards/primitives");
 const specials_1 = require("../guards/specials");
 const utilities_1 = require("../number/utilities");
-const constants_1 = require("./constants");
 const timezone_1 = require("./timezone");
 function isValidTime(value) {
     if (!(0, primitives_1.isNonEmptyString)(value))
@@ -67,5 +66,6 @@ function isDateLike(value) {
     return false;
 }
 function isTimeWithUnit(value) {
-    return (0, primitives_1.isNonEmptyString)(value) && constants_1.TIME_UNIT_REGEX.test(value);
+    return ((0, primitives_1.isNonEmptyString)(value) &&
+        /^-?\d*\.?\d+ *(milliseconds?|msecs?|ms|seconds?|secs?|s|minutes?|mins?|m|hours?|hrs?|h|days?|d|weeks?|w|months?|mo|years?|yrs?|y)?$/i.test(value));
 }

package/dist/cjs/date/parse.js

@@ -21,7 +21,7 @@ function _parse(str, sec = false) {
     if (!(0, primitives_1.isNonEmptyString)(str) || str.length > 100) {
         throw new RangeError(`Value must be a string with length between 1 and 99!`);
     }
-    const match = constants_1.TIME_UNIT_REGEX.exec(str);
+    const match = /^(?<value>-?\d*\.?\d+) *(?<unit>milliseconds?|msecs?|ms|seconds?|secs?|s|minutes?|mins?|m|hours?|hrs?|h|days?|d|weeks?|w|months?|mo|years?|yrs?|y)?$/i.exec(str);
     if (!match?.groups)
         return NaN;
     const unit = (match.groups.unit ?? 'ms').toLowerCase();

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/date/constants.d.ts

@@ -40,7 +40,5 @@ export declare const TIME_UNIT_VARIANTS: Readonly<{
     readonly second: readonly ["s", "sec", "secs", "second", "seconds"];
     readonly millisecond: readonly ["ms", "msec", "msecs", "millisecond", "milliseconds"];
 }>;
-/** `RegExp` for time unit variants */
-export declare const TIME_UNIT_REGEX: Readonly<RegExp>;
 /** Map to different time units to milliseconds */
 export declare const MS_MAP: Readonly<Record<"year" | "y" | "yr" | "yrs" | "years" | "month" | "mo" | "months" | "week" | "w" | "weeks" | "day" | "d" | "days" | "hour" | "h" | "hr" | "hrs" | "hours" | "minute" | "m" | "min" | "mins" | "minutes" | "second" | "s" | "sec" | "secs" | "seconds" | "millisecond" | "ms" | "msec" | "msecs" | "milliseconds", number>>;

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

@@ -486,8 +486,12 @@ export type ChronosWithOptions = Partial<{
     /** Milliseconds of the second, from 0 to 999. */
     millisecond: Milliseconds;
 }>;
+/** Mapped type to {@link TIME_UNIT_VARIANTS} */
+export type $TimeUnitVarMap = typeof TIME_UNIT_VARIANTS;
+/** Key of {@link TIME_UNIT_VARIANTS} */
+export type $TimeUnitKey = keyof typeof TIME_UNIT_VARIANTS;
 /** Variants of different time units in lowercase */
-export type $TimeUnitVar = (typeof TIME_UNIT_VARIANTS)[keyof typeof TIME_UNIT_VARIANTS][number];
+export type $TimeUnitVar<U extends $TimeUnitKey = $TimeUnitKey> = $TimeUnitVarMap[U][number];
 /** Variants of different time units in lowercase, uppercase  and capitalized */
 export type $UnitAnyCase = Capitalize<$TimeUnitVar> | Uppercase<$TimeUnitVar> | $TimeUnitVar;
 /** Number (time value) with variants of different time units */

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/date/constants.js

@@ -103,11 +103,6 @@ export const TIME_UNIT_VARIANTS = /* @__PURE__ */ Object.freeze({
     second: ['s', 'sec', 'secs', 'second', 'seconds'],
     millisecond: ['ms', 'msec', 'msecs', 'millisecond', 'milliseconds'],
 });
-const TIME_UNIT_REGEX_STR = /* @__PURE__ */ Object.freeze(Object.values(TIME_UNIT_VARIANTS)
-    .flat()
-    .sort((a, b) => b.length - a.length)
-    .join('|'));
-export const TIME_UNIT_REGEX = /* @__PURE__ */ Object.freeze(new RegExp(`^(?<value>-?\\d*\\.?\\d+) *(?<unit>${TIME_UNIT_REGEX_STR})?$`, 'i'));
 export const MS_MAP = /* @__PURE__ */ Object.freeze((() => {
     const s = 1000;
     const m = s * 60;

package/dist/esm/date/guards.js

@@ -1,7 +1,6 @@
 import { isNonEmptyString, isString } from '../guards/primitives.js';
 import { isNumericString } from '../guards/specials.js';
 import { normalizeNumber } from '../number/utilities.js';
-import { TIME_UNIT_REGEX } from './constants.js';
 import { IANA_TZ_IDS } from './timezone.js';
 export function isValidTime(value) {
     if (!isNonEmptyString(value))
@@ -58,5 +57,6 @@ export function isDateLike(value) {
     return false;
 }
 export function isTimeWithUnit(value) {
-    return isNonEmptyString(value) && TIME_UNIT_REGEX.test(value);
+    return (isNonEmptyString(value) &&
+        /^-?\d*\.?\d+ *(milliseconds?|msecs?|ms|seconds?|secs?|s|minutes?|mins?|m|hours?|hrs?|h|days?|d|weeks?|w|months?|mo|years?|yrs?|y)?$/i.test(value));
 }

package/dist/esm/date/parse.js

@@ -1,6 +1,6 @@
 import { isNonEmptyString, isNumber } from '../guards/primitives.js';
 import { isNumericString } from '../guards/specials.js';
-import { MS_MAP, TIME_UNIT_REGEX } from './constants.js';
+import { MS_MAP } from './constants.js';
 import { isTimeWithUnit } from './guards.js';
 export function parseMSec(value, sec = false) {
     if (isNumericString(value)) {
@@ -18,7 +18,7 @@ function _parse(str, sec = false) {
     if (!isNonEmptyString(str) || str.length > 100) {
         throw new RangeError(`Value must be a string with length between 1 and 99!`);
     }
-    const match = TIME_UNIT_REGEX.exec(str);
+    const match = /^(?<value>-?\d*\.?\d+) *(?<unit>milliseconds?|msecs?|ms|seconds?|secs?|s|minutes?|mins?|m|hours?|hrs?|h|days?|d|weeks?|w|months?|mo|years?|yrs?|y)?$/i.exec(str);
     if (!match?.groups)
         return NaN;
     const unit = (match.groups.unit ?? 'ms').toLowerCase();

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.8",
   "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",