toolbox-x 2.2.5 → 2.3.0

package/dist/{hash.cjs → hash/index.cjs}

@@ -15,10 +15,10 @@
  */
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_primitives = require('./primitives-CBGICrDR.cjs');
-const require_specials = require('./specials-DU8u108m.cjs');
-const require_parse = require('./parse-jh637S25.cjs');
-const require_basics = require('./basics-byj0VH1c.cjs');
+const require_primitives = require('../primitives-CBGICrDR.cjs');
+const require_utils = require('../utils-DR9g0Sef.cjs');
+const require_specials = require('../specials-DU8u108m.cjs');
+const require_parse = require('../parse-CffWYCuy.cjs');
 
 //#region src/hash/Cipher.ts
 /**
@@ -45,9 +45,9 @@ var Cipher = class {
 	*/
 	constructor(secret) {
 		if (!require_primitives.isNonEmptyString(secret)) throw new Error("Secret must be non-empty string!");
-		this.#secretBytes = require_basics.utf8ToBytes(secret);
-		this.#encKey = require_basics.hmacSha256(this.#secretBytes, require_basics.utf8ToBytes("enc"));
-		this.#macKey = require_basics.hmacSha256(this.#secretBytes, require_basics.utf8ToBytes("mac"));
+		this.#secretBytes = require_utils.utf8ToBytes(secret);
+		this.#encKey = require_utils.hmacSha256(this.#secretBytes, require_utils.utf8ToBytes("enc"));
+		this.#macKey = require_utils.hmacSha256(this.#secretBytes, require_utils.utf8ToBytes("mac"));
 	}
 	/**
 	* Generates a keystream of the same length as the provided data using a `HMAC`-based counter mode.
@@ -60,8 +60,8 @@ var Cipher = class {
 	#genKeystream(target, iv) {
 		const blocks = Math.ceil(target.length / 32);
 		const keystreamParts = [];
-		for (let counter = 0; counter < blocks; counter++) keystreamParts.push(require_basics.hmacSha256(this.#encKey, require_basics.concatBytes(iv, require_basics.intTo4BytesBE(counter))));
-		return require_basics.concatBytes(...keystreamParts).subarray(0, target.length);
+		for (let counter = 0; counter < blocks; counter++) keystreamParts.push(require_utils.hmacSha256(this.#encKey, require_utils.concatBytes(iv, require_utils.intTo4BytesBE(counter))));
+		return require_utils.concatBytes(...keystreamParts).subarray(0, target.length);
 	}
 	/**
 	* * Encrypts a UTF-8 string.
@@ -71,12 +71,12 @@ var Cipher = class {
 	* @returns A base64-encoded encrypted token.
 	*/
 	encrypt(text) {
-		const plain = require_basics.utf8ToBytes(text);
-		const iv = require_basics.sha256Bytes(require_basics.utf8ToBytes(String(Date.now()) + "-" + String(Math.random()))).subarray(0, 16);
+		const plain = require_utils.utf8ToBytes(text);
+		const iv = require_utils.sha256Bytes(require_utils.utf8ToBytes(String(Date.now()) + "-" + String(Math.random()))).subarray(0, 16);
 		const keystream = this.#genKeystream(plain, iv);
 		const ct = new Uint8Array(plain.length);
 		for (let i = 0; i < plain.length; i++) ct[i] = plain[i] ^ keystream[i];
-		return require_basics.bytesToBase64(require_basics.concatBytes(iv, ct, require_basics.hmacSha256(this.#macKey, require_basics.concatBytes(iv, ct))));
+		return require_utils.bytesToBase64(require_utils.concatBytes(iv, ct, require_utils.hmacSha256(this.#macKey, require_utils.concatBytes(iv, ct))));
 	}
 	/**
 	* * Checks if a token is structurally valid and contains a matching MAC using the same secret.
@@ -86,12 +86,12 @@ var Cipher = class {
 	*/
 	isValid(token) {
 		if (!require_specials.isBase64(token)) return false;
-		const blob = require_basics.base64ToBytes(token);
+		const blob = require_utils.base64ToBytes(token);
 		if (blob.length < 48) return false;
 		const iv = blob.subarray(0, 16);
 		const tag = blob.subarray(blob.length - 32);
 		const ct = blob.subarray(16, blob.length - 32);
-		return require_basics._constantTimeEquals(require_basics.hmacSha256(this.#macKey, require_basics.concatBytes(iv, ct)), tag);
+		return require_utils._constantTimeEquals(require_utils.hmacSha256(this.#macKey, require_utils.concatBytes(iv, ct)), tag);
 	}
 	/**
 	* * Decrypts a previously encrypted token.
@@ -102,16 +102,16 @@ var Cipher = class {
 	*/
 	decrypt(token) {
 		if (!require_specials.isBase64(token)) throw new Error("Token must be a base64 string!");
-		const blob = require_basics.base64ToBytes(token);
+		const blob = require_utils.base64ToBytes(token);
 		if (blob.length < 48) throw new Error("Malformed or tampered token!");
 		const iv = blob.subarray(0, 16);
 		const tag = blob.subarray(blob.length - 32);
 		const ct = blob.subarray(16, blob.length - 32);
-		if (!require_basics._constantTimeEquals(require_basics.hmacSha256(this.#macKey, require_basics.concatBytes(iv, ct)), tag)) throw new Error("Key in the token is tampered or invalid!)");
+		if (!require_utils._constantTimeEquals(require_utils.hmacSha256(this.#macKey, require_utils.concatBytes(iv, ct)), tag)) throw new Error("Key in the token is tampered or invalid!)");
 		const keystream = this.#genKeystream(ct, iv);
 		const pt = new Uint8Array(ct.length);
 		for (let i = 0; i < ct.length; i++) pt[i] = ct[i] ^ keystream[i];
-		return require_basics.bytesToUtf8(pt);
+		return require_utils.bytesToUtf8(pt);
 	}
 };
 
@@ -195,7 +195,7 @@ var Signet = class {
 	*/
 	constructor(secret) {
 		if (!require_primitives.isNonEmptyString(secret)) throw new Error("Secret must be a non-empty string!");
-		this.#secretBytes = require_basics.utf8ToBytes(secret);
+		this.#secretBytes = require_utils.utf8ToBytes(secret);
 	}
 	/** Decodes a token without verifying its signature. */
 	#decode(token) {
@@ -203,10 +203,10 @@ var Signet = class {
 		const parts = token.split(".");
 		if (parts.length !== 3) throw new Error("Token is tampered or malformed!");
 		const [hdr, pld, signature] = parts;
-		const headerBytes = require_basics.base64ToBytes(hdr);
-		const payloadBytes = require_basics.base64ToBytes(pld);
-		const headerStr = require_basics.stripJsonEdgeGarbage(require_basics.bytesToUtf8(headerBytes));
-		const payloadStr = require_basics.stripJsonEdgeGarbage(require_basics.bytesToUtf8(payloadBytes));
+		const headerBytes = require_utils.base64ToBytes(hdr);
+		const payloadBytes = require_utils.base64ToBytes(pld);
+		const headerStr = require_utils.stripJsonEdgeGarbage(require_utils.bytesToUtf8(headerBytes));
+		const payloadStr = require_utils.stripJsonEdgeGarbage(require_utils.bytesToUtf8(payloadBytes));
 		let header;
 		try {
 			header = JSON.parse(headerStr);
@@ -301,15 +301,15 @@ var Signet = class {
 			...issuer && { iss: issuer },
 			...payload
 		};
-		const headerJson = require_basics.stableStringify({
+		const headerJson = require_utils.stableStringify({
 			alg: "HS256",
 			typ: "SIGNET+JWT"
 		});
-		const payloadJson = require_basics.stableStringify($payload);
-		const headerB = require_basics.utf8ToBytes(headerJson);
-		const payloadB = require_basics.utf8ToBytes(payloadJson);
-		const signingInput = `${require_basics.bytesToBase64(headerB)}.${require_basics.bytesToBase64(payloadB)}`;
-		return `${signingInput}.${require_basics.bytesToBase64(require_basics.hmacSha256(this.#secretBytes, require_basics.utf8ToBytes(signingInput)))}`;
+		const payloadJson = require_utils.stableStringify($payload);
+		const headerB = require_utils.utf8ToBytes(headerJson);
+		const payloadB = require_utils.utf8ToBytes(payloadJson);
+		const signingInput = `${require_utils.bytesToBase64(headerB)}.${require_utils.bytesToBase64(payloadB)}`;
+		return `${signingInput}.${require_utils.bytesToBase64(require_utils.hmacSha256(this.#secretBytes, require_utils.utf8ToBytes(signingInput)))}`;
 	}
 	/**
 	* * Decodes a token without verifying its signature.
@@ -573,7 +573,7 @@ var Signet = class {
 		try {
 			const { signature, signingInput, payload } = this.#decode(token);
 			const { audience, issuer, subject } = options || {};
-			if (!require_basics._constantTimeEquals(signature, require_basics.bytesToBase64(require_basics.hmacSha256(this.#secretBytes, require_basics.utf8ToBytes(signingInput))))) throw new Error("Invalid or tampered signature!");
+			if (!require_utils._constantTimeEquals(signature, require_utils.bytesToBase64(require_utils.hmacSha256(this.#secretBytes, require_utils.utf8ToBytes(signingInput))))) throw new Error("Invalid or tampered signature!");
 			if (this.hasExpired(token)) throw new Error("Token has expired!");
 			if (this.isTooEarly(token)) throw new Error("Token is not active yet!");
 			if (this.isInvalidIssuer(token, issuer)) throw new Error("Invalid token issuer!");
@@ -740,7 +740,7 @@ var TextCodec = class TextCodec {
 	* TextCodec.utf8ToHex('Hi');
 	*/
 	static utf8ToHex(text, spaced = true) {
-		return [...require_basics.utf8ToBytes(text)].map((b) => require_basics._padStartWith0(b, "hex")).join(spaced ? " " : "");
+		return [...require_utils.utf8ToBytes(text)].map((b) => require_utils._padStartWith0(b, "hex")).join(spaced ? " " : "");
 	}
 	/**
 	* @static Converts UTF-8 text into binary byte representation.
@@ -753,7 +753,7 @@ var TextCodec = class TextCodec {
 	* TextCodec.utf8ToBinary('A');
 	*/
 	static utf8ToBinary(text, spaced = true) {
-		return [...require_basics.utf8ToBytes(text)].map((b) => require_basics._padStartWith0(b, "binary")).join(spaced ? " " : "");
+		return [...require_utils.utf8ToBytes(text)].map((b) => require_utils._padStartWith0(b, "binary")).join(spaced ? " " : "");
 	}
 	/**
 	* @static Converts hexadecimal byte string into UTF-8 text.
@@ -765,7 +765,7 @@ var TextCodec = class TextCodec {
 	* TextCodec.hexToUtf8('48 69');
 	*/
 	static hexToUtf8(hex) {
-		return require_basics.bytesToUtf8(require_basics.hexToBytes(hex));
+		return require_utils.bytesToUtf8(require_utils.hexToBytes(hex));
 	}
 	/**
 	* @static Converts binary byte string into UTF-8 text.
@@ -778,8 +778,8 @@ var TextCodec = class TextCodec {
 	*/
 	static binaryToUtf8(binary) {
 		if (!require_specials.isBinaryString(binary)) return "";
-		const bytes = require_basics._splitByCharLength(binary, 8).map((b) => parseInt(b, 2));
-		return require_basics.bytesToUtf8(new Uint8Array(bytes));
+		const bytes = require_utils._splitByCharLength(binary, 8).map((b) => parseInt(b, 2));
+		return require_utils.bytesToUtf8(new Uint8Array(bytes));
 	}
 	/**
 	* @static Converts hexadecimal byte string into binary byte string.
@@ -793,7 +793,7 @@ var TextCodec = class TextCodec {
 	*/
 	static hexToBinary(hex, spaced = true) {
 		if (!require_specials.isHexString(hex)) return "";
-		return require_basics._splitByCharLength(hex, 2).map((h) => require_basics._padStartWith0(parseInt(h, 16), "binary")).join(spaced ? " " : "");
+		return require_utils._splitByCharLength(hex, 2).map((h) => require_utils._padStartWith0(parseInt(h, 16), "binary")).join(spaced ? " " : "");
 	}
 	/**
 	* @static Converts binary byte string into hexadecimal byte string.
@@ -807,7 +807,7 @@ var TextCodec = class TextCodec {
 	*/
 	static binaryToHex(binary, spaced = true) {
 		if (!require_specials.isBinaryString(binary)) return "";
-		return require_basics._splitByCharLength(binary, 8).map((b) => require_basics._padStartWith0(parseInt(b, 2), "hex")).join(spaced ? " " : "");
+		return require_utils._splitByCharLength(binary, 8).map((b) => require_utils._padStartWith0(parseInt(b, 2), "hex")).join(spaced ? " " : "");
 	}
 	/**
 	* @static Converts a Base64-encoded string into UTF-8 text.
@@ -820,7 +820,7 @@ var TextCodec = class TextCodec {
 	*/
 	static base64ToUtf8(b64) {
 		if (!require_specials.isBase64(b64)) return "";
-		return require_basics.bytesToUtf8(require_basics.base64ToBytes(b64));
+		return require_utils.bytesToUtf8(require_utils.base64ToBytes(b64));
 	}
 	/**
 	* @static Converts UTF-8 text into a Base64-encoded string.
@@ -833,7 +833,7 @@ var TextCodec = class TextCodec {
 	*/
 	static utf8ToBase64(text) {
 		if (!require_primitives.isNonEmptyString(text)) return "";
-		return require_basics.bytesToBase64(require_basics.utf8ToBytes(text));
+		return require_utils.bytesToBase64(require_utils.utf8ToBytes(text));
 	}
 	/**
 	* @static Converts Base64 directly into hexadecimal byte string.
@@ -891,32 +891,35 @@ var TextCodec = class TextCodec {
 exports.Cipher = Cipher;
 exports.Signet = Signet;
 exports.TextCodec = TextCodec;
-exports.base64ToBytes = require_basics.base64ToBytes;
-exports.bytesToBase64 = require_basics.bytesToBase64;
-exports.bytesToHex = require_basics.bytesToHex;
-exports.bytesToUtf8 = require_basics.bytesToUtf8;
-exports.concatBytes = require_basics.concatBytes;
-exports.decodeUUID = require_basics.decodeUUID;
-exports.generateRandomID = require_basics.generateRandomID;
-exports.getRandomID = require_basics.generateRandomID;
-exports.hexToBytes = require_basics.hexToBytes;
-exports.hmacSha256 = require_basics.hmacSha256;
-exports.intTo4BytesBE = require_basics.intTo4BytesBE;
+exports.base64ToBytes = require_utils.base64ToBytes;
+exports.bytesToBase64 = require_utils.bytesToBase64;
+exports.bytesToHex = require_utils.bytesToHex;
+exports.bytesToUtf8 = require_utils.bytesToUtf8;
+exports.concatBytes = require_utils.concatBytes;
+exports.decodeUUID = require_utils.decodeUUID;
+exports.generateRandomID = require_utils.generateRandomID;
+exports.getRandomID = require_utils.generateRandomID;
+exports.hexToBytes = require_utils.hexToBytes;
+exports.hmacSha256 = require_utils.hmacSha256;
+exports.intTo4BytesBE = require_utils.intTo4BytesBE;
 exports.isUUID = require_specials.isUUID;
-exports.isUUIDv1 = require_basics.isUUIDv1;
-exports.isUUIDv2 = require_basics.isUUIDv2;
-exports.isUUIDv3 = require_basics.isUUIDv3;
-exports.isUUIDv4 = require_basics.isUUIDv4;
-exports.isUUIDv5 = require_basics.isUUIDv5;
-exports.isUUIDv6 = require_basics.isUUIDv6;
-exports.isUUIDv7 = require_basics.isUUIDv7;
-exports.isUUIDv8 = require_basics.isUUIDv8;
-exports.md5 = require_basics.md5;
-exports.randomHex = require_basics.randomHex;
-exports.randomID = require_basics.generateRandomID;
-exports.sha1 = require_basics.sha1;
-exports.sha256 = require_basics.sha256;
-exports.sha256Bytes = require_basics.sha256Bytes;
-exports.uint8To32ArrayBE = require_basics.uint8To32ArrayBE;
-exports.utf8ToBytes = require_basics.utf8ToBytes;
-exports.uuid = require_basics.uuid;
+exports.isUUIDv1 = require_utils.isUUIDv1;
+exports.isUUIDv2 = require_utils.isUUIDv2;
+exports.isUUIDv3 = require_utils.isUUIDv3;
+exports.isUUIDv4 = require_utils.isUUIDv4;
+exports.isUUIDv5 = require_utils.isUUIDv5;
+exports.isUUIDv6 = require_utils.isUUIDv6;
+exports.isUUIDv7 = require_utils.isUUIDv7;
+exports.isUUIDv8 = require_utils.isUUIDv8;
+exports.md5 = require_utils.md5;
+exports.randomAlphaNumeric = require_utils.randomAlphaNumeric;
+exports.randomBytes = require_utils.randomBytes;
+exports.randomHex = require_utils.randomHex;
+exports.randomID = require_utils.generateRandomID;
+exports.randomNumeric = require_utils.randomNumeric;
+exports.sha1 = require_utils.sha1;
+exports.sha256 = require_utils.sha256;
+exports.sha256Bytes = require_utils.sha256Bytes;
+exports.uint8To32ArrayBE = require_utils.uint8To32ArrayBE;
+exports.utf8ToBytes = require_utils.utf8ToBytes;
+exports.uuid = require_utils.uuid;

package/dist/{hash.d.cts → hash/index.d.cts}

@@ -14,10 +14,10 @@
  * limitations under the License.
  */
 
-import { nt as Maybe, y as GenericObject } from "./object-DyVg8BFt.cjs";
-import { _ as VerifiedToken, d as SignetPayload, l as SignOptions, p as TokenString, s as DecodedToken, v as VerifyOptions } from "./hash-DHawpylk.cjs";
-import { a as isUUIDv4, c as isUUIDv7, i as isUUIDv3, l as isUUIDv8, n as isUUIDv1, o as isUUIDv5, r as isUUIDv2, s as isUUIDv6, t as decodeUUID, u as uuid, w as isUUID } from "./uuid-CMNRM9NO.cjs";
-import { t as generateRandomID } from "./basics-DlwGpXu-.cjs";
+import { nt as Maybe, y as GenericObject } from "../object-DyVg8BFt.cjs";
+import { _ as VerifiedToken, d as SignetPayload, l as SignOptions, p as TokenString, s as DecodedToken, v as VerifyOptions } from "../hash-DHawpylk.cjs";
+import { a as isUUIDv4, c as isUUIDv7, i as isUUIDv3, l as isUUIDv8, n as isUUIDv1, o as isUUIDv5, r as isUUIDv2, s as isUUIDv6, t as decodeUUID, u as uuid, w as isUUID } from "../uuid-CMNRM9NO.cjs";
+import { t as generateRandomID } from "../basics-DlwGpXu-.cjs";
 
 //#region src/hash/Cipher.d.ts
 /**
@@ -751,6 +751,35 @@ declare class TextCodec {
 }
 //#endregion
 //#region src/hash/utils.d.ts
+/**
+ * * Generates random bytes in the {@link Uint8Array} format.
+ *
+ * @param size - The length of the byte array to generate. Defaults to `8`.
+ * @returns A random array of bytes.
+ *
+ * @example
+ * ```typescript
+ * const bytes = randomBytes(16);
+ * // Returns something like: Uint8Array(16) [104, 101, 108, 108, 111, 32, 119, 111, 114, 108, 100, 224, 166, 170, 224, 167, 131]
+ *
+ * // Empty array
+ * const empty = randomBytes(0);
+ * // Returns: Uint8Array(0) []
+ *
+ * // Zero or negative values are treated as 0
+ * const zero = randomBytes(-5);
+ * // Returns: Uint8Array(0) []
+ * ```
+ *
+ * @remarks
+ * - It uses {@link crypto.getRandomValues} when available for secure randomness, and falls back to {@link Math.random} if not.
+ * - If {@link crypto.getRandomValues} is available (supported environments include browser and Node.js), it is used for cryptographically secure random number generation.
+ * - In environments where {@link crypto.getRandomValues} is not available, the function falls back to {@link Math.random}, which is **not** cryptographically secure.
+ * - {@link crypto.getRandomValues} fills the array with random values in the range [0, 255] (inclusive).
+ * - {@link Math.random} returns values in the range [0, 1) (exclusive of 1), so the values are scaled to [0, 255].
+ * - If `size` is 0 or negative, an empty `Uint8Array` is returned.
+ */
+declare function randomBytes(size?: number): Uint8Array;
 /**
  * * Generates a random hexadecimal string of the specified length.
  *
@@ -774,6 +803,49 @@ declare class TextCodec {
  * const token = randomHex(8, true);
  */
 declare function randomHex(length: number, uppercase?: boolean): string;
+/**
+ * * Generates a random numeric string of the specified length.
+ *
+ * @param length - Length of the numeric string. Defaults to `6`.
+ * @returns A randomly generated numeric string.
+ *
+ * @example
+ * ```typescript
+ * const otp = randomNumeric(6);
+ * // Returns something like: '123456'
+ * ```
+ *
+ * @remarks
+ * - If `length` is `0` or negative, an empty string is returned.
+ */
+declare function randomNumeric(length?: number): `${number}`;
+/**
+ * * Generates a random alphanumeric string (letters and numbers) of the specified length.
+ *
+ * @param length - The desired length of the random string. Defaults to `8`.
+ * @param uppercase - If `true`, the string will contain uppercase letters (A-Z). Defaults to `false` (lowercase).
+ *
+ * @returns A random string composed of alphanumeric characters.
+ *
+ * @example
+ * ```typescript
+ * // Generate a random 8-character alphanumeric string (default: lowercase)
+ * const randomStr = randomAlphaNumeric(8);
+ * // Example output: "a7b2f9d1"
+ *
+ * // Generate a 12-character uppercase alphanumeric string
+ * const randomUpper = randomAlphaNumeric(12, true);
+ * // Example output: "X5K9P2M7H4L3"
+ *
+ * // Generate a 6-character string
+ * const shortStr = randomAlphaNumeric(6);
+ * ```
+ *
+ * @remarks
+ * - The function generates random bytes and converts them to base-36 (0-9, a-z) characters.
+ * - If `length` is `0` or negative, an empty string is returned.
+ */
+declare function randomAlphaNumeric(length?: number, uppercase?: boolean): string;
 /**
  * * Converts a UTF-8 string to a byte array (`Uint8Array`).
  *
@@ -1143,4 +1215,4 @@ declare function bytesToHex(bytes: Uint8Array): string;
  */
 declare function hexToBytes(hex: string): Uint8Array;
 //#endregion
-export { Cipher, Signet, TextCodec, base64ToBytes, bytesToBase64, bytesToHex, bytesToUtf8, concatBytes, decodeUUID, generateRandomID, generateRandomID as getRandomID, generateRandomID as randomID, hexToBytes, hmacSha256, intTo4BytesBE, isUUID, isUUIDv1, isUUIDv2, isUUIDv3, isUUIDv4, isUUIDv5, isUUIDv6, isUUIDv7, isUUIDv8, md5, randomHex, sha1, sha256, sha256Bytes, uint8To32ArrayBE, utf8ToBytes, uuid };
+export { Cipher, Signet, TextCodec, base64ToBytes, bytesToBase64, bytesToHex, bytesToUtf8, concatBytes, decodeUUID, generateRandomID, generateRandomID as getRandomID, generateRandomID as randomID, hexToBytes, hmacSha256, intTo4BytesBE, isUUID, isUUIDv1, isUUIDv2, isUUIDv3, isUUIDv4, isUUIDv5, isUUIDv6, isUUIDv7, isUUIDv8, md5, randomAlphaNumeric, randomBytes, randomHex, randomNumeric, sha1, sha256, sha256Bytes, uint8To32ArrayBE, utf8ToBytes, uuid };

package/dist/{hash.d.mts → hash/index.d.mts}

@@ -14,10 +14,10 @@
  * limitations under the License.
  */
 
-import { nt as Maybe, y as GenericObject } from "./object-DyVg8BFt.mjs";
-import { _ as VerifiedToken, d as SignetPayload, l as SignOptions, p as TokenString, s as DecodedToken, v as VerifyOptions } from "./hash-2mygGWLk.mjs";
-import { a as isUUIDv4, c as isUUIDv7, i as isUUIDv3, l as isUUIDv8, n as isUUIDv1, o as isUUIDv5, r as isUUIDv2, s as isUUIDv6, t as decodeUUID, u as uuid, w as isUUID } from "./uuid-DvQsIl9p.mjs";
-import { t as generateRandomID } from "./basics-DY7AX7D4.mjs";
+import { nt as Maybe, y as GenericObject } from "../object-DyVg8BFt.mjs";
+import { _ as VerifiedToken, d as SignetPayload, l as SignOptions, p as TokenString, s as DecodedToken, v as VerifyOptions } from "../hash-2mygGWLk.mjs";
+import { a as isUUIDv4, c as isUUIDv7, i as isUUIDv3, l as isUUIDv8, n as isUUIDv1, o as isUUIDv5, r as isUUIDv2, s as isUUIDv6, t as decodeUUID, u as uuid, w as isUUID } from "../uuid-DvQsIl9p.mjs";
+import { t as generateRandomID } from "../basics-DY7AX7D4.mjs";
 
 //#region src/hash/Cipher.d.ts
 /**
@@ -751,6 +751,35 @@ declare class TextCodec {
 }
 //#endregion
 //#region src/hash/utils.d.ts
+/**
+ * * Generates random bytes in the {@link Uint8Array} format.
+ *
+ * @param size - The length of the byte array to generate. Defaults to `8`.
+ * @returns A random array of bytes.
+ *
+ * @example
+ * ```typescript
+ * const bytes = randomBytes(16);
+ * // Returns something like: Uint8Array(16) [104, 101, 108, 108, 111, 32, 119, 111, 114, 108, 100, 224, 166, 170, 224, 167, 131]
+ *
+ * // Empty array
+ * const empty = randomBytes(0);
+ * // Returns: Uint8Array(0) []
+ *
+ * // Zero or negative values are treated as 0
+ * const zero = randomBytes(-5);
+ * // Returns: Uint8Array(0) []
+ * ```
+ *
+ * @remarks
+ * - It uses {@link crypto.getRandomValues} when available for secure randomness, and falls back to {@link Math.random} if not.
+ * - If {@link crypto.getRandomValues} is available (supported environments include browser and Node.js), it is used for cryptographically secure random number generation.
+ * - In environments where {@link crypto.getRandomValues} is not available, the function falls back to {@link Math.random}, which is **not** cryptographically secure.
+ * - {@link crypto.getRandomValues} fills the array with random values in the range [0, 255] (inclusive).
+ * - {@link Math.random} returns values in the range [0, 1) (exclusive of 1), so the values are scaled to [0, 255].
+ * - If `size` is 0 or negative, an empty `Uint8Array` is returned.
+ */
+declare function randomBytes(size?: number): Uint8Array;
 /**
  * * Generates a random hexadecimal string of the specified length.
  *
@@ -774,6 +803,49 @@ declare class TextCodec {
  * const token = randomHex(8, true);
  */
 declare function randomHex(length: number, uppercase?: boolean): string;
+/**
+ * * Generates a random numeric string of the specified length.
+ *
+ * @param length - Length of the numeric string. Defaults to `6`.
+ * @returns A randomly generated numeric string.
+ *
+ * @example
+ * ```typescript
+ * const otp = randomNumeric(6);
+ * // Returns something like: '123456'
+ * ```
+ *
+ * @remarks
+ * - If `length` is `0` or negative, an empty string is returned.
+ */
+declare function randomNumeric(length?: number): `${number}`;
+/**
+ * * Generates a random alphanumeric string (letters and numbers) of the specified length.
+ *
+ * @param length - The desired length of the random string. Defaults to `8`.
+ * @param uppercase - If `true`, the string will contain uppercase letters (A-Z). Defaults to `false` (lowercase).
+ *
+ * @returns A random string composed of alphanumeric characters.
+ *
+ * @example
+ * ```typescript
+ * // Generate a random 8-character alphanumeric string (default: lowercase)
+ * const randomStr = randomAlphaNumeric(8);
+ * // Example output: "a7b2f9d1"
+ *
+ * // Generate a 12-character uppercase alphanumeric string
+ * const randomUpper = randomAlphaNumeric(12, true);
+ * // Example output: "X5K9P2M7H4L3"
+ *
+ * // Generate a 6-character string
+ * const shortStr = randomAlphaNumeric(6);
+ * ```
+ *
+ * @remarks
+ * - The function generates random bytes and converts them to base-36 (0-9, a-z) characters.
+ * - If `length` is `0` or negative, an empty string is returned.
+ */
+declare function randomAlphaNumeric(length?: number, uppercase?: boolean): string;
 /**
  * * Converts a UTF-8 string to a byte array (`Uint8Array`).
  *
@@ -1143,4 +1215,4 @@ declare function bytesToHex(bytes: Uint8Array): string;
  */
 declare function hexToBytes(hex: string): Uint8Array;
 //#endregion
-export { Cipher, Signet, TextCodec, base64ToBytes, bytesToBase64, bytesToHex, bytesToUtf8, concatBytes, decodeUUID, generateRandomID, generateRandomID as getRandomID, generateRandomID as randomID, hexToBytes, hmacSha256, intTo4BytesBE, isUUID, isUUIDv1, isUUIDv2, isUUIDv3, isUUIDv4, isUUIDv5, isUUIDv6, isUUIDv7, isUUIDv8, md5, randomHex, sha1, sha256, sha256Bytes, uint8To32ArrayBE, utf8ToBytes, uuid };
+export { Cipher, Signet, TextCodec, base64ToBytes, bytesToBase64, bytesToHex, bytesToUtf8, concatBytes, decodeUUID, generateRandomID, generateRandomID as getRandomID, generateRandomID as randomID, hexToBytes, hmacSha256, intTo4BytesBE, isUUID, isUUIDv1, isUUIDv2, isUUIDv3, isUUIDv4, isUUIDv5, isUUIDv6, isUUIDv7, isUUIDv8, md5, randomAlphaNumeric, randomBytes, randomHex, randomNumeric, sha1, sha256, sha256Bytes, uint8To32ArrayBE, utf8ToBytes, uuid };

package/dist/{hash.mjs → hash/index.mjs}

@@ -14,10 +14,10 @@
  * limitations under the License.
  */
 
-import { a as isNonEmptyString } from "./primitives-Djsevc69.mjs";
-import { c as isHexString, m as isUUID, n as isBinaryString, t as isBase64, w as isNotEmptyObject } from "./specials-krf7zsqI.mjs";
-import { c as _toSeconds, s as _secToDate, t as parseMSec } from "./parse-TuFyLeVH.mjs";
-import { A as uint8To32ArrayBE, C as bytesToUtf8, D as intTo4BytesBE, E as hmacSha256, G as stableStringify, K as stripJsonEdgeGarbage, O as randomHex, S as bytesToHex, T as hexToBytes, _ as _constantTimeEquals, a as isUUIDv1, b as base64ToBytes, c as isUUIDv4, d as isUUIDv7, f as isUUIDv8, g as sha256, h as sha1, i as decodeUUID, j as utf8ToBytes, k as sha256Bytes, l as isUUIDv5, m as md5, o as isUUIDv2, p as uuid, s as isUUIDv3, t as generateRandomID, u as isUUIDv6, v as _padStartWith0, w as concatBytes, x as bytesToBase64, y as _splitByCharLength } from "./basics-20lm69yy.mjs";
+import { a as isNonEmptyString } from "../primitives-Djsevc69.mjs";
+import { A as uuid, B as bytesToUtf8, C as isUUIDv2, D as isUUIDv6, E as isUUIDv5, F as _padStartWith0, G as randomAlphaNumeric, H as hexToBytes, I as _splitByCharLength, J as randomNumeric, K as randomBytes, L as base64ToBytes, M as sha1, N as sha256, O as isUUIDv7, P as _constantTimeEquals, Q as generateRandomID, R as bytesToBase64, S as isUUIDv1, T as isUUIDv4, U as hmacSha256, V as concatBytes, W as intTo4BytesBE, X as uint8To32ArrayBE, Y as sha256Bytes, Z as utf8ToBytes, h as stripJsonEdgeGarbage, j as md5, k as isUUIDv8, m as stableStringify, q as randomHex, w as isUUIDv3, x as decodeUUID, z as bytesToHex } from "../utils-BO5CcsjK.mjs";
+import { c as isHexString, m as isUUID, n as isBinaryString, t as isBase64, w as isNotEmptyObject } from "../specials-krf7zsqI.mjs";
+import { c as _toSeconds, s as _secToDate, t as parseMSec } from "../parse-CILDG7TG.mjs";
 
 //#region src/hash/Cipher.ts
 /**
@@ -887,4 +887,4 @@ var TextCodec = class TextCodec {
 };
 
 //#endregion
-export { Cipher, Signet, TextCodec, base64ToBytes, bytesToBase64, bytesToHex, bytesToUtf8, concatBytes, decodeUUID, generateRandomID, generateRandomID as getRandomID, generateRandomID as randomID, hexToBytes, hmacSha256, intTo4BytesBE, isUUID, isUUIDv1, isUUIDv2, isUUIDv3, isUUIDv4, isUUIDv5, isUUIDv6, isUUIDv7, isUUIDv8, md5, randomHex, sha1, sha256, sha256Bytes, uint8To32ArrayBE, utf8ToBytes, uuid };
+export { Cipher, Signet, TextCodec, base64ToBytes, bytesToBase64, bytesToHex, bytesToUtf8, concatBytes, decodeUUID, generateRandomID, generateRandomID as getRandomID, generateRandomID as randomID, hexToBytes, hmacSha256, intTo4BytesBE, isUUID, isUUIDv1, isUUIDv2, isUUIDv3, isUUIDv4, isUUIDv5, isUUIDv6, isUUIDv7, isUUIDv8, md5, randomAlphaNumeric, randomBytes, randomHex, randomNumeric, sha1, sha256, sha256Bytes, uint8To32ArrayBE, utf8ToBytes, uuid };

package/dist/{http-status.cjs → http-status/index.cjs}

@@ -15,7 +15,7 @@
  */
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_constants = require('./constants-ZnFGKd7G.cjs');
+const require_constants = require('../constants-ZnFGKd7G.cjs');
 
 //#region src/http-status/HttpStatus.ts
 /**

package/dist/{http-status.d.mts → http-status/index.d.cts}

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-import { nt as Maybe } from "./object-DyVg8BFt.mjs";
-import { a as HttpStatusCode, c as StatusCode, l as StatusEntry, o as HttpStatusName, s as StatusCategory, u as StatusName } from "./http-status-BXNuC-33.mjs";
+import { nt as Maybe } from "../object-DyVg8BFt.cjs";
+import { a as HttpStatusCode, c as StatusCode, l as StatusEntry, o as HttpStatusName, s as StatusCategory, u as StatusName } from "../http-status-CpYDj2wq.cjs";
 
 //#region src/http-status/HttpStatus.d.ts
 /**

package/dist/{http-status.d.cts → http-status/index.d.mts}

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-import { nt as Maybe } from "./object-DyVg8BFt.cjs";
-import { a as HttpStatusCode, c as StatusCode, l as StatusEntry, o as HttpStatusName, s as StatusCategory, u as StatusName } from "./http-status-CpYDj2wq.cjs";
+import { nt as Maybe } from "../object-DyVg8BFt.mjs";
+import { a as HttpStatusCode, c as StatusCode, l as StatusEntry, o as HttpStatusName, s as StatusCategory, u as StatusName } from "../http-status-BXNuC-33.mjs";
 
 //#region src/http-status/HttpStatus.d.ts
 /**

package/dist/{http-status.mjs → http-status/index.mjs}

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { n as HTTP_STATUS_DATA } from "./constants-BLAcLxOu.mjs";
+import { n as HTTP_STATUS_DATA } from "../constants-BLAcLxOu.mjs";
 
 //#region src/http-status/HttpStatus.ts
 /**