@knsdev/node-utils 1.0.1 → 2.0.0

package/dist/JwtUtils.d.ts

@@ -0,0 +1,51 @@
+declare class jwtUtils {
+    /**
+     * Signs a JWT (HS256) and returns the compact token.
+     * @template PayloadType - The type of the payload to sign.
+     * @param secret - Symmetric signing secret.
+     * @param data - Payload (object, string, or Buffer).
+     * @param expiresMs - Milliseconds until expiry (ignored if payload already sets `exp`).
+     * @returns Compact JWT string.
+     * @throws {InternalServerError} If signing fails.
+     */
+    readonly signOrThrow: <PayloadType extends object | string | Buffer = "Error: a type template is required">(secret: string, data: NoInfer<PayloadType>, expiresMs: number) => string;
+    /**
+     * Signs a JWT (HS256); returns result or error object.
+     * @template PayloadType - The type of the payload to sign.
+     */
+    readonly sign: <PayloadType extends object | string | Buffer = "Error: a type template is required">(secret: string, data: NoInfer<PayloadType>, expiresMs: number) => {
+        data: PayloadType;
+        error: null;
+    } | {
+        data: null;
+        error: Error;
+    };
+    /**
+     * Verifies a JWT (HS256) and returns the payload.
+     * @template PayloadType - Expected payload shape after verification.
+     * @param secret - Symmetric signing secret.
+     * @param token - Compact JWT string.
+     * @returns Decoded payload.
+     * @throws {BadRequest} If `token` is not a string.
+     * @throws {Unauthorized} If the token is invalid or expired.
+     */
+    readonly verifyOrThrow: <PayloadType extends object | string | Buffer = "Error: a type template is required">(secret: string, token: unknown) => PayloadType;
+    /**
+     * Verifies a JWT (HS256); returns payload or error object.
+     * @template PayloadType - Expected payload shape after verification.
+     */
+    readonly verify: <PayloadType extends object | string | Buffer = "Error: a type template is required">(secret: string, token: unknown) => {
+        data: PayloadType;
+        error: null;
+    } | {
+        data: null;
+        error: Error;
+    };
+}
+/**
+ * JWT utilities for use across projects.
+ * Import via: @sajjat/utils/JwtUtils
+ */
+export declare const JwtUtils: jwtUtils;
+export {};
+//# sourceMappingURL=JwtUtils.d.ts.map

package/dist/JwtUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JwtUtils.d.ts","sourceRoot":"","sources":["../src/JwtUtils.ts"],"names":[],"mappings":"AAIA,cAAM,QAAQ;IAEb;;;;;;;;OAQG;IACH,QAAQ,CAAC,WAAW,GAAI,WAAW,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,oCAAoC,EAC1G,QAAQ,MAAM,EACd,MAAM,OAAO,CAAC,WAAW,CAAC,EAC1B,WAAW,MAAM,KACf,MAAM,CAaR;IAED;;;OAGG;IACH,QAAQ,CAAC,IAAI,GAAI,WAAW,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,oCAAoC,EACnG,QAAQ,MAAM,EACd,MAAM,OAAO,CAAC,WAAW,CAAC,EAC1B,WAAW,MAAM,KACf;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,KAAK,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAOnE;IAED;;;;;;;;OAQG;IACH,QAAQ,CAAC,aAAa,GAAI,WAAW,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,oCAAoC,EAAE,QAAQ,MAAM,EAAE,OAAO,OAAO,KAC1I,WAAW,CAWb;IAED;;;OAGG;IACH,QAAQ,CAAC,MAAM,GAAI,WAAW,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,oCAAoC,EAAE,QAAQ,MAAM,EAAE,OAAO,OAAO,KACnI;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,KAAK,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAOnE;CACD;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,UAAiB,CAAC"}

package/dist/JwtUtils.js

@@ -0,0 +1,78 @@
+import { BadRequest, InternalServerError, Unauthorized } from "./ErrorClasses.js";
+import JWT from "jsonwebtoken";
+class jwtUtils {
+    /**
+     * Signs a JWT (HS256) and returns the compact token.
+     * @template PayloadType - The type of the payload to sign.
+     * @param secret - Symmetric signing secret.
+     * @param data - Payload (object, string, or Buffer).
+     * @param expiresMs - Milliseconds until expiry (ignored if payload already sets `exp`).
+     * @returns Compact JWT string.
+     * @throws {InternalServerError} If signing fails.
+     */
+    signOrThrow = (secret, data, expiresMs) => {
+        try {
+            const payload = data;
+            const options = { algorithm: 'HS256' };
+            // Do not pass expiresIn when payload already has exp (jsonwebtoken v9 throws otherwise)
+            if (payload.exp === undefined) {
+                options.expiresIn = `${expiresMs}ms`;
+            }
+            return JWT.sign(data, secret, options);
+        }
+        catch {
+            throw new InternalServerError('JWT__ENCRYPTION_FAILED');
+        }
+    };
+    /**
+     * Signs a JWT (HS256); returns result or error object.
+     * @template PayloadType - The type of the payload to sign.
+     */
+    sign = (secret, data, expiresMs) => {
+        try {
+            return { data: this.signOrThrow(secret, data, expiresMs), error: null };
+        }
+        catch (error) {
+            return { data: null, error: error };
+        }
+    };
+    /**
+     * Verifies a JWT (HS256) and returns the payload.
+     * @template PayloadType - Expected payload shape after verification.
+     * @param secret - Symmetric signing secret.
+     * @param token - Compact JWT string.
+     * @returns Decoded payload.
+     * @throws {BadRequest} If `token` is not a string.
+     * @throws {Unauthorized} If the token is invalid or expired.
+     */
+    verifyOrThrow = (secret, token) => {
+        if (typeof token !== 'string')
+            throw new BadRequest('JWT__INVALID_OR_EXPIRED');
+        try {
+            return JWT.verify(token, secret, {
+                algorithms: ['HS256'],
+            });
+        }
+        catch {
+            throw new Unauthorized('JWT__INVALID_OR_EXPIRED');
+        }
+    };
+    /**
+     * Verifies a JWT (HS256); returns payload or error object.
+     * @template PayloadType - Expected payload shape after verification.
+     */
+    verify = (secret, token) => {
+        try {
+            return { data: this.verifyOrThrow(secret, token), error: null };
+        }
+        catch (error) {
+            return { data: null, error: error };
+        }
+    };
+}
+/**
+ * JWT utilities for use across projects.
+ * Import via: @sajjat/utils/JwtUtils
+ */
+export const JwtUtils = new jwtUtils();
+//# sourceMappingURL=JwtUtils.js.map

package/dist/JwtUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JwtUtils.js","sourceRoot":"","sources":["../src/JwtUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAClF,OAAO,GAAG,MAAM,cAAc,CAAC;AAG/B,MAAM,QAAQ;IAEb;;;;;;;;OAQG;IACM,WAAW,GAAG,CACtB,MAAc,EACd,IAA0B,EAC1B,SAAiB,EACR,EAAE;QACX,IAAI,CAAC;YACJ,MAAM,OAAO,GAAG,IAA+B,CAAC;YAChD,MAAM,OAAO,GAAoB,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;YACxD,wFAAwF;YACxF,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;gBAC/B,OAAO,CAAC,SAAS,GAAG,GAAG,SAAS,IAAI,CAAC;YACtC,CAAC;YACD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACxC,CAAC;QACD,MAAM,CAAC;YACN,MAAM,IAAI,mBAAmB,CAAC,wBAAwB,CAAC,CAAC;QACzD,CAAC;IACF,CAAC,CAAA;IAED;;;OAGG;IACM,IAAI,GAAG,CACf,MAAc,EACd,IAA0B,EAC1B,SAAiB,EACmD,EAAE;QACtE,IAAI,CAAC;YACJ,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,CAAc,MAAM,EAAE,IAAI,EAAE,SAAS,CAAgB,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACrG,CAAC;QACD,OAAO,KAAK,EAAE,CAAC;YACd,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC;QAC9C,CAAC;IACF,CAAC,CAAA;IAED;;;;;;;;OAQG;IACM,aAAa,GAAG,CAAsF,MAAc,EAAE,KAAc,EAC9H,EAAE;QAChB,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,MAAM,IAAI,UAAU,CAAC,yBAAyB,CAAC,CAAC;QAE/E,IAAI,CAAC;YACJ,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE;gBAChC,UAAU,EAAE,CAAC,OAAO,CAAC;aACO,CAAgB,CAAC;QAC/C,CAAC;QACD,MAAM,CAAC;YACN,MAAM,IAAI,YAAY,CAAC,yBAAyB,CAAC,CAAC;QACnD,CAAC;IACF,CAAC,CAAA;IAED;;;OAGG;IACM,MAAM,GAAG,CAAsF,MAAc,EAAE,KAAc,EACjE,EAAE;QACtE,IAAI,CAAC;YACJ,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,aAAa,CAAc,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC9E,CAAC;QACD,OAAO,KAAK,EAAE,CAAC;YACd,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC;QAC9C,CAAC;IACF,CAAC,CAAA;CACD;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC"}

package/dist/Nums.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Clamp a number to an inclusive range.
+ * @param value - Input number.
+ * @param min - Inclusive lower bound.
+ * @param max - Inclusive upper bound.
+ * @returns `value` constrained to `[min, max]`.
+ */
+export declare const clamp: (value: number, min: number, max: number) => number;
+/**
+ * Check whether a number falls within an inclusive range.
+ * @param value - Number to test.
+ * @param min - Inclusive lower bound.
+ * @param max - Inclusive upper bound.
+ * @returns `true` when `min <= value <= max`; otherwise `false`.
+ */
+export declare const isBetween: (value: number, min: number, max: number) => boolean;
+/**
+ * Round a number to a fixed number of decimal places.
+ * @param value - Number to round.
+ * @param decimals - Decimal places to keep.
+ * @returns Rounded number.
+ */
+export declare const roundTo: (value: number, decimals: number) => number;
+/**
+ * Round a number down to a fixed number of decimal places.
+ * @param value - Number to floor.
+ * @param decimals - Decimal places to keep.
+ * @returns Floored number.
+ */
+export declare const floorTo: (value: number, decimals: number) => number;
+/**
+ * Round a number up to a fixed number of decimal places.
+ * @param value - Number to ceil.
+ * @param decimals - Decimal places to keep.
+ * @returns Ceiled number.
+ */
+export declare const ceilTo: (value: number, decimals: number) => number;
+/**
+ * Parse a value into an integer safely.
+ * @param value - Value to parse.
+ * @param radix - Numeric base for parsing string inputs.
+ * @returns Parsed integer, or `null` for `null`/`undefined`/`NaN`.
+ */
+export declare const parseIntSafe: (value: string | number | null | undefined, radix?: number) => number | null;
+/**
+ * Parse a value into a floating-point number safely.
+ * @param value - Value to parse.
+ * @returns Parsed number, or `null` for `null`/`undefined`/`NaN`.
+ */
+export declare const parseFloatSafe: (value: string | number | null | undefined) => number | null;
+/**
+ * Type guard for finite numbers.
+ * @param value - Unknown input.
+ * @returns `true` when `value` is a finite `number`.
+ */
+export declare const isFiniteNumber: (value: unknown) => value is number;
+/**
+ * Type guard for integer numbers.
+ * @param value - Unknown input.
+ * @returns `true` when `value` is an integer `number`.
+ */
+export declare const isInteger: (value: unknown) => value is number;
+/**
+ * Format a number using `Intl.NumberFormat`.
+ * @param value - Number to format.
+ * @param locale - BCP47 locale string.
+ * @param options - Number format options.
+ * @returns Formatted number string.
+ */
+export declare const formatNumber: (value: number, locale?: string, options?: Intl.NumberFormatOptions) => string;
+/**
+ * Format a number with group separators.
+ * @param value - Number to format.
+ * @param locale - BCP47 locale string. (default: 'en')
+ * @param decimals - Optional fixed fraction digits.
+ * @returns Formatted string with commas/grouping.
+ */
+export declare const formatWithCommas: (value: number, locale?: string, decimals?: number) => string;
+/**
+ * Calculate percentage of `part` out of `total`.
+ * @param part - Numerator.
+ * @param total - Denominator.
+ * @param decimals - Decimal places in the result.
+ * @returns Percentage value. Returns `0` if `total` is `0`.
+ */
+export declare const percentage: (part: number, total: number, decimals?: number) => number;
+/**
+ * Convert unknown input to a finite number with fallback.
+ * @param value - Value to convert.
+ * @param fallback - Value used when conversion is not finite.
+ * @returns Finite number from input, or `fallback`.
+ */
+export declare const toNumber: (value: unknown, fallback: number) => number;
+/**
+ * Convert unknown input to an integer with fallback.
+ * @param value - Value to convert.
+ * @param fallback - Value used when conversion is not an integer.
+ * @returns Integer from input, or `fallback`.
+ */
+export declare const toInt: (value: unknown, fallback: number) => number;
+//# sourceMappingURL=Nums.d.ts.map

package/dist/Nums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Nums.d.ts","sourceRoot":"","sources":["../src/Nums.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,GAAI,OAAO,MAAM,EAAE,KAAK,MAAM,EAAE,KAAK,MAAM,KAAG,MAC5B,CAAC;AAErC;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,EAAE,KAAK,MAAM,EAAE,KAAK,MAAM,KAAG,OACvC,CAAC;AAE9B;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,MAAM,EAAE,UAAU,MAAM,KAAG,MAGzD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,MAAM,EAAE,UAAU,MAAM,KAAG,MAGzD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,MAAM,GAAI,OAAO,MAAM,EAAE,UAAU,MAAM,KAAG,MAGxD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GACxB,OAAO,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EACzC,cAAU,KACR,MAAM,GAAG,IAIX,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,MAAM,GAAG,IAInF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MACL,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MACC,CAAC;AAEtD;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GACxB,OAAO,MAAM,EACb,eAAa,EACb,UAAU,IAAI,CAAC,mBAAmB,KAChC,MAKc,CAAC;AAElB;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,EAAE,eAAa,EAAE,WAAW,MAAM,KAAG,MAOlF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,EAAE,OAAO,MAAM,EAAE,iBAAY,KAAG,MAGtE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,EAAE,UAAU,MAAM,KAAG,MAG3D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,KAAK,GAAI,OAAO,OAAO,EAAE,UAAU,MAAM,KAAG,MAGxD,CAAC"}

package/dist/Nums.js

@@ -0,0 +1,141 @@
+/**
+ * Clamp a number to an inclusive range.
+ * @param value - Input number.
+ * @param min - Inclusive lower bound.
+ * @param max - Inclusive upper bound.
+ * @returns `value` constrained to `[min, max]`.
+ */
+export const clamp = (value, min, max) => Math.min(Math.max(value, min), max);
+/**
+ * Check whether a number falls within an inclusive range.
+ * @param value - Number to test.
+ * @param min - Inclusive lower bound.
+ * @param max - Inclusive upper bound.
+ * @returns `true` when `min <= value <= max`; otherwise `false`.
+ */
+export const isBetween = (value, min, max) => value >= min && value <= max;
+/**
+ * Round a number to a fixed number of decimal places.
+ * @param value - Number to round.
+ * @param decimals - Decimal places to keep.
+ * @returns Rounded number.
+ */
+export const roundTo = (value, decimals) => {
+    const factor = 10 ** decimals;
+    return Math.round(value * factor) / factor;
+};
+/**
+ * Round a number down to a fixed number of decimal places.
+ * @param value - Number to floor.
+ * @param decimals - Decimal places to keep.
+ * @returns Floored number.
+ */
+export const floorTo = (value, decimals) => {
+    const factor = 10 ** decimals;
+    return Math.floor(value * factor) / factor;
+};
+/**
+ * Round a number up to a fixed number of decimal places.
+ * @param value - Number to ceil.
+ * @param decimals - Decimal places to keep.
+ * @returns Ceiled number.
+ */
+export const ceilTo = (value, decimals) => {
+    const factor = 10 ** decimals;
+    return Math.ceil(value * factor) / factor;
+};
+/**
+ * Parse a value into an integer safely.
+ * @param value - Value to parse.
+ * @param radix - Numeric base for parsing string inputs.
+ * @returns Parsed integer, or `null` for `null`/`undefined`/`NaN`.
+ */
+export const parseIntSafe = (value, radix = 10) => {
+    if (value === null || value === undefined)
+        return null;
+    const n = typeof value === 'number' ? value : parseInt(String(value), radix);
+    return Number.isNaN(n) ? null : n;
+};
+/**
+ * Parse a value into a floating-point number safely.
+ * @param value - Value to parse.
+ * @returns Parsed number, or `null` for `null`/`undefined`/`NaN`.
+ */
+export const parseFloatSafe = (value) => {
+    if (value === null || value === undefined)
+        return null;
+    const n = typeof value === 'number' ? value : parseFloat(String(value));
+    return Number.isNaN(n) ? null : n;
+};
+/**
+ * Type guard for finite numbers.
+ * @param value - Unknown input.
+ * @returns `true` when `value` is a finite `number`.
+ */
+export const isFiniteNumber = (value) => typeof value === 'number' && Number.isFinite(value);
+/**
+ * Type guard for integer numbers.
+ * @param value - Unknown input.
+ * @returns `true` when `value` is an integer `number`.
+ */
+export const isInteger = (value) => typeof value === 'number' && Number.isInteger(value);
+/**
+ * Format a number using `Intl.NumberFormat`.
+ * @param value - Number to format.
+ * @param locale - BCP47 locale string.
+ * @param options - Number format options.
+ * @returns Formatted number string.
+ */
+export const formatNumber = (value, locale = 'en', options) => new Intl.NumberFormat(locale, {
+    minimumFractionDigits: 0,
+    maximumFractionDigits: 2,
+    ...options,
+}).format(value);
+/**
+ * Format a number with group separators.
+ * @param value - Number to format.
+ * @param locale - BCP47 locale string. (default: 'en')
+ * @param decimals - Optional fixed fraction digits.
+ * @returns Formatted string with commas/grouping.
+ */
+export const formatWithCommas = (value, locale = 'en', decimals) => {
+    const opts = {};
+    if (decimals !== undefined) {
+        opts.minimumFractionDigits = decimals;
+        opts.maximumFractionDigits = decimals;
+    }
+    return new Intl.NumberFormat(locale, opts).format(value);
+};
+/**
+ * Calculate percentage of `part` out of `total`.
+ * @param part - Numerator.
+ * @param total - Denominator.
+ * @param decimals - Decimal places in the result.
+ * @returns Percentage value. Returns `0` if `total` is `0`.
+ */
+export const percentage = (part, total, decimals = 0) => {
+    if (total === 0)
+        return 0;
+    return roundTo((part / total) * 100, decimals);
+};
+/**
+ * Convert unknown input to a finite number with fallback.
+ * @param value - Value to convert.
+ * @param fallback - Value used when conversion is not finite.
+ * @returns Finite number from input, or `fallback`.
+ */
+export const toNumber = (value, fallback) => {
+    const n = typeof value === 'number' ? value : parseFloat(String(value));
+    return Number.isFinite(n) ? n : fallback;
+};
+/**
+ * Convert unknown input to an integer with fallback.
+ * @param value - Value to convert.
+ * @param fallback - Value used when conversion is not an integer.
+ * @returns Integer from input, or `fallback`.
+ */
+export const toInt = (value, fallback) => {
+    const n = typeof value === 'number' ? value : parseInt(String(value), 10);
+    return Number.isInteger(n) ? n : fallback;
+};
+//# sourceMappingURL=Nums.js.map

package/dist/Nums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Nums.js","sourceRoot":"","sources":["../src/Nums.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW,EAAU,EAAE,CACxE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;AAErC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW,EAAW,EAAE,CAC7E,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,GAAG,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAa,EAAE,QAAgB,EAAU,EAAE;IAClE,MAAM,MAAM,GAAG,EAAE,IAAI,QAAQ,CAAC;IAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC;AAC5C,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAa,EAAE,QAAgB,EAAU,EAAE;IAClE,MAAM,MAAM,GAAG,EAAE,IAAI,QAAQ,CAAC;IAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC;AAC5C,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,QAAgB,EAAU,EAAE;IACjE,MAAM,MAAM,GAAG,EAAE,IAAI,QAAQ,CAAC;IAC9B,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC;AAC3C,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC3B,KAAyC,EACzC,KAAK,GAAG,EAAE,EACM,EAAE;IAClB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACvD,MAAM,CAAC,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IAC7E,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAyC,EAAiB,EAAE;IAC1F,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACvD,MAAM,CAAC,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACxE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAc,EAAmB,EAAE,CACjE,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAErD;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAc,EAAmB,EAAE,CAC5D,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC3B,KAAa,EACb,MAAM,GAAG,IAAI,EACb,OAAkC,EACzB,EAAE,CACX,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE;IAC7B,qBAAqB,EAAE,CAAC;IACxB,qBAAqB,EAAE,CAAC;IACxB,GAAG,OAAO;CACV,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAElB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAE,MAAM,GAAG,IAAI,EAAE,QAAiB,EAAU,EAAE;IAC3F,MAAM,IAAI,GAA6B,EAAE,CAAC;IAC1C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC5B,IAAI,CAAC,qBAAqB,GAAG,QAAQ,CAAC;QACtC,IAAI,CAAC,qBAAqB,GAAG,QAAQ,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,KAAa,EAAE,QAAQ,GAAG,CAAC,EAAU,EAAE;IAC/E,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC1B,OAAO,OAAO,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,GAAG,EAAE,QAAQ,CAAC,CAAC;AAChD,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAE,QAAgB,EAAU,EAAE;IACpE,MAAM,CAAC,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACxE,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC1C,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAc,EAAE,QAAgB,EAAU,EAAE;IACjE,MAAM,CAAC,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1E,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC3C,CAAC,CAAC"}

package/dist/PassUtils.d.ts

@@ -0,0 +1,59 @@
+declare class passwordUtils {
+    /**
+     * Hash a password with bcrypt and return result as success/error object.
+     * @param password - Plain-text password.
+     * @param saltRounds - BCrypt salt rounds.
+     * @returns Success object with hash, or failure object with error.
+     */
+    readonly hashPassword: (password: string, saltRounds?: number) => Promise<{
+        success: true;
+        hashedPassword: string;
+    } | {
+        success: false;
+        error: Error;
+    }>;
+    /**
+     * Hash a password with bcrypt and throw on failure.
+     * @param password - Plain-text password.
+     * @param saltRounds - BCrypt salt rounds.
+     * @returns Hashed password string.
+     * @throws {InternalServerError} If hashing fails.
+     */
+    readonly hashPasswordOrThrow: (password: string, saltRounds?: number) => Promise<string>;
+    /**
+     * Compare plain-text password with bcrypt hash.
+     * @param password - Plain-text password.
+     * @param hashedPassword - BCrypt hash.
+     * @returns `true`/`false` comparison result, or `false` if comparison throws.
+     */
+    readonly comparePassword: (password: string, hashedPassword: string) => Promise<boolean | null>;
+    /**
+     * Compare plain-text password with bcrypt hash and throw on failure.
+     * @param password - Plain-text password.
+     * @param hashedPassword - BCrypt hash.
+     * @returns `true` when password matches hash, otherwise `false`.
+     * @throws {InternalServerError} If comparison fails unexpectedly.
+     */
+    readonly comparePasswordOrThrow: (password: string, hashedPassword: string) => Promise<boolean>;
+    /**
+     * Validate password length boundaries.
+     * @param password - Plain-text password.
+     * @param minLength - Inclusive minimum length.
+     * @param maxLength - Inclusive maximum length.
+     * @returns `true` when password length is within bounds.
+     */
+    readonly validateStrength: (password: string, minLength: number, maxLength: number) => boolean;
+    /**
+     * Check whether a string appears to be a bcrypt hash.
+     * @param value - Input string.
+     * @returns `true` when input matches bcrypt hash pattern.
+     */
+    readonly isBcryptHash: (value: string) => boolean;
+}
+/**
+ * Singleton instance of password utilities.
+ */
+export declare const PasswordUtils: passwordUtils;
+export declare const bbbb = 1;
+export {};
+//# sourceMappingURL=PassUtils.d.ts.map

package/dist/PassUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PassUtils.d.ts","sourceRoot":"","sources":["../src/PassUtils.ts"],"names":[],"mappings":"AAMA,cAAM,aAAa;IAClB;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,GACpB,UAAU,MAAM,EAChB,mBAAgC,KAC9B,OAAO,CAAC;QAAE,OAAO,EAAE,IAAI,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,OAAO,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAOtF;IAEF;;;;;;OAMG;IACH,QAAQ,CAAC,mBAAmB,GAC3B,UAAU,MAAM,EAChB,mBAAgC,KAC9B,OAAO,CAAC,MAAM,CAAC,CAOhB;IAEF;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,GACvB,UAAU,MAAM,EAChB,gBAAgB,MAAM,KACpB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAOxB;IAEF;;;;;;OAMG;IACH,QAAQ,CAAC,sBAAsB,GAC9B,UAAU,MAAM,EAChB,gBAAgB,MAAM,KACpB,OAAO,CAAC,OAAO,CAAC,CAOjB;IAEF;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,EAAE,WAAW,MAAM,KAAG,OAAO,CAC/B;IAE9D;;;;OAIG;IACH,QAAQ,CAAC,YAAY,GAAI,OAAO,MAAM,KAAG,OAAO,CACI;CACpD;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,eAAsB,CAAC;AAEjD,eAAO,MAAM,IAAI,IAAM,CAAC"}

package/dist/PassUtils.js

@@ -0,0 +1,84 @@
+import bcrypt from "bcrypt";
+import { InternalServerError } from "./ErrorClasses.js";
+import { aaa } from "./HMACUtils.js";
+const DEFAULT_SALT_ROUNDS = 10;
+class passwordUtils {
+    /**
+     * Hash a password with bcrypt and return result as success/error object.
+     * @param password - Plain-text password.
+     * @param saltRounds - BCrypt salt rounds.
+     * @returns Success object with hash, or failure object with error.
+     */
+    hashPassword = async (password, saltRounds = DEFAULT_SALT_ROUNDS) => {
+        try {
+            return { success: true, hashedPassword: await bcrypt.hash(password, saltRounds) };
+        }
+        catch (error) {
+            return { success: false, error: error };
+        }
+    };
+    /**
+     * Hash a password with bcrypt and throw on failure.
+     * @param password - Plain-text password.
+     * @param saltRounds - BCrypt salt rounds.
+     * @returns Hashed password string.
+     * @throws {InternalServerError} If hashing fails.
+     */
+    hashPasswordOrThrow = async (password, saltRounds = DEFAULT_SALT_ROUNDS) => {
+        try {
+            return await bcrypt.hash(password, saltRounds);
+        }
+        catch {
+            throw new InternalServerError();
+        }
+    };
+    /**
+     * Compare plain-text password with bcrypt hash.
+     * @param password - Plain-text password.
+     * @param hashedPassword - BCrypt hash.
+     * @returns `true`/`false` comparison result, or `false` if comparison throws.
+     */
+    comparePassword = async (password, hashedPassword) => {
+        try {
+            return await bcrypt.compare(password, hashedPassword);
+        }
+        catch {
+            return false;
+        }
+    };
+    /**
+     * Compare plain-text password with bcrypt hash and throw on failure.
+     * @param password - Plain-text password.
+     * @param hashedPassword - BCrypt hash.
+     * @returns `true` when password matches hash, otherwise `false`.
+     * @throws {InternalServerError} If comparison fails unexpectedly.
+     */
+    comparePasswordOrThrow = async (password, hashedPassword) => {
+        try {
+            return await bcrypt.compare(password, hashedPassword);
+        }
+        catch {
+            throw new InternalServerError();
+        }
+    };
+    /**
+     * Validate password length boundaries.
+     * @param password - Plain-text password.
+     * @param minLength - Inclusive minimum length.
+     * @param maxLength - Inclusive maximum length.
+     * @returns `true` when password length is within bounds.
+     */
+    validateStrength = (password, minLength, maxLength) => password.length >= minLength && password.length <= maxLength;
+    /**
+     * Check whether a string appears to be a bcrypt hash.
+     * @param value - Input string.
+     * @returns `true` when input matches bcrypt hash pattern.
+     */
+    isBcryptHash = (value) => /^\$2[aby]\$\d{2}\$[./A-Za-z0-9]{53}$/.test(value);
+}
+/**
+ * Singleton instance of password utilities.
+ */
+export const PasswordUtils = new passwordUtils();
+export const bbbb = aaa;
+//# sourceMappingURL=PassUtils.js.map

package/dist/PassUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PassUtils.js","sourceRoot":"","sources":["../src/PassUtils.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAErC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B,MAAM,aAAa;IAClB;;;;;OAKG;IACM,YAAY,GAAG,KAAK,EAC5B,QAAgB,EAChB,UAAU,GAAG,mBAAmB,EACwD,EAAE;QAC1F,IAAI,CAAC;YACJ,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC;QACnF,CAAC;QACD,OAAO,KAAK,EAAE,CAAC;YACd,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC;QAClD,CAAC;IACF,CAAC,CAAC;IAEF;;;;;;OAMG;IACM,mBAAmB,GAAG,KAAK,EACnC,QAAgB,EAChB,UAAU,GAAG,mBAAmB,EACd,EAAE;QACpB,IAAI,CAAC;YACJ,OAAO,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAChD,CAAC;QACD,MAAM,CAAC;YACN,MAAM,IAAI,mBAAmB,EAAE,CAAC;QACjC,CAAC;IACF,CAAC,CAAC;IAEF;;;;;OAKG;IACM,eAAe,GAAG,KAAK,EAC/B,QAAgB,EAChB,cAAsB,EACI,EAAE;QAC5B,IAAI,CAAC;YACJ,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,CAAC;YACN,OAAO,KAAK,CAAC;QACd,CAAC;IACF,CAAC,CAAC;IAEF;;;;;;OAMG;IACM,sBAAsB,GAAG,KAAK,EACtC,QAAgB,EAChB,cAAsB,EACH,EAAE;QACrB,IAAI,CAAC;YACJ,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,CAAC;YACN,MAAM,IAAI,mBAAmB,EAAE,CAAC;QACjC,CAAC;IACF,CAAC,CAAC;IAEF;;;;;;OAMG;IACM,gBAAgB,GAAG,CAAC,QAAgB,EAAE,SAAiB,EAAE,SAAiB,EAAW,EAAE,CAC/F,QAAQ,CAAC,MAAM,IAAI,SAAS,IAAI,QAAQ,CAAC,MAAM,IAAI,SAAS,CAAC;IAE9D;;;;OAIG;IACM,YAAY,GAAG,CAAC,KAAa,EAAW,EAAE,CAClD,sCAAsC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;CACpD;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;AAEjD,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,CAAC"}

package/dist/Rand.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Pseudo-random integer between `min` and `max` (inclusive) using `Math.random()`.
+ * @param min - Inclusive lower bound.
+ * @param max - Inclusive upper bound.
+ * @returns A pseudo-random integer `n` such that `min <= n <= max`.
+ */
+export declare const srandInt: (min: number, max: number) => number;
+/**
+ * Crypto-random integer between `min` and `max` (inclusive).
+ * @param min - Inclusive lower bound. Must be a safe integer.
+ * @param max - Inclusive upper bound. Must be a safe integer.
+ * @returns A crypto-random integer `n` such that `min <= n <= max`.
+ * @throws {TypeError} If `min` or `max` are not safe integers.
+ * @throws {RangeError} If `max < min`.
+ */
+export declare const randInt: (min: number, max: number) => number;
+/**
+ * Pseudo-random float between `min` and `max`.
+ * Note: uses `Math.random()`, so the result is effectively in `[min, max)` (with `max` excluded).
+ * @param min - Inclusive lower bound.
+ * @param max - Upper bound (effectively exclusive).
+ * @returns A pseudo-random number `x` such that `min <= x < max`.
+ */
+export declare const srandFloat: (min: number, max: number) => number;
+/**
+ * Crypto-random float between `min` and `max` (inclusive).
+ * @param min - Inclusive lower bound.
+ * @param max - Inclusive upper bound.
+ * @returns A crypto-random number `x` such that `min <= x <= max` (subject to normal floating-point rounding).
+ */
+export declare const randFloat: (min: number, max: number) => number;
+/**
+ * Generates a crypto-random RFC4122 v4 UUID.
+ * @returns A UUID string (e.g. `xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx`).
+ */
+export declare const randUuid: () => string;
+/**
+ * Crypto-random Base58 string.
+ * Uses `randInt(0, max)` with an inclusive `max` contract.
+ * @param length - Number of characters to generate.
+ * @returns A Base58 string of length `length` (or `""` if `length <= 0`).
+ */
+export declare const randStr: (length: number) => string;
+//# sourceMappingURL=Rand.d.ts.map

package/dist/Rand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Rand.d.ts","sourceRoot":"","sources":["../src/Rand.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,EAAE,KAAK,MAAM,WACC,CAAC;AAEnD;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,EAAE,KAAK,MAAM,WAW/C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,EAAE,KAAK,MAAM,WAAsC,CAAC;AAE1F;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,EAAE,KAAK,MAAM,WAUjD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,QAAQ,QAAO,MAAsB,CAAC;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,QAAQ,MAAM,WAOrC,CAAA"}

package/dist/Rand.js

@@ -0,0 +1,72 @@
+import { randomUUID, randomInt as cryptoRandomInt } from "crypto";
+const BASE58_CHARS = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
+/**
+ * Pseudo-random integer between `min` and `max` (inclusive) using `Math.random()`.
+ * @param min - Inclusive lower bound.
+ * @param max - Inclusive upper bound.
+ * @returns A pseudo-random integer `n` such that `min <= n <= max`.
+ */
+export const srandInt = (min, max) => Math.floor(Math.random() * (max - min + 1)) + min;
+/**
+ * Crypto-random integer between `min` and `max` (inclusive).
+ * @param min - Inclusive lower bound. Must be a safe integer.
+ * @param max - Inclusive upper bound. Must be a safe integer.
+ * @returns A crypto-random integer `n` such that `min <= n <= max`.
+ * @throws {TypeError} If `min` or `max` are not safe integers.
+ * @throws {RangeError} If `max < min`.
+ */
+export const randInt = (min, max) => {
+    // Node's `crypto.randomInt` uses an exclusive upper bound.
+    // We keep the previous inclusive `max` contract.
+    if (!Number.isSafeInteger(min) || !Number.isSafeInteger(max)) {
+        throw new TypeError("randInt(min, max) requires safe integers");
+    }
+    if (max < min) {
+        throw new RangeError("randInt(min, max): max must be >= min");
+    }
+    return cryptoRandomInt(min, max + 1);
+};
+/**
+ * Pseudo-random float between `min` and `max`.
+ * Note: uses `Math.random()`, so the result is effectively in `[min, max)` (with `max` excluded).
+ * @param min - Inclusive lower bound.
+ * @param max - Upper bound (effectively exclusive).
+ * @returns A pseudo-random number `x` such that `min <= x < max`.
+ */
+export const srandFloat = (min, max) => Math.random() * (max - min) + min;
+/**
+ * Crypto-random float between `min` and `max` (inclusive).
+ * @param min - Inclusive lower bound.
+ * @param max - Inclusive upper bound.
+ * @returns A crypto-random number `x` such that `min <= x <= max` (subject to normal floating-point rounding).
+ */
+export const randFloat = (min, max) => {
+    const range = max - min;
+    if (range === 0)
+        return min;
+    // Uniform value in [0, 1] using 48 random bits (inclusive upper endpoint).
+    // `crypto.randomInt(min, max)` treats `max` as exclusive.
+    const maxInclusiveInt = 2 ** 48 - 2;
+    const uInt = cryptoRandomInt(0, maxInclusiveInt + 1); // -> [0, maxInclusiveInt]
+    const u = uInt / maxInclusiveInt; // -> [0, 1]
+    return min + u * range;
+};
+/**
+ * Generates a crypto-random RFC4122 v4 UUID.
+ * @returns A UUID string (e.g. `xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx`).
+ */
+export const randUuid = () => randomUUID();
+/**
+ * Crypto-random Base58 string.
+ * Uses `randInt(0, max)` with an inclusive `max` contract.
+ * @param length - Number of characters to generate.
+ * @returns A Base58 string of length `length` (or `""` if `length <= 0`).
+ */
+export const randStr = (length) => {
+    let result = '';
+    for (let i = 0; i < length; i++) {
+        result += BASE58_CHARS[randInt(0, BASE58_CHARS.length - 1)];
+    }
+    return result;
+};
+//# sourceMappingURL=Rand.js.map