vortez-io 1.0.0

package/build/support/UTF8Codec.js

@@ -0,0 +1,155 @@
+/**
+ * @module vortez-io
+ * @author NetFeez <netfeez.dev@netfeez.dev>
+ * @license Apache-2.0
+ * @description UTF-8 encoder/decoder optimized for:
+ *              - predictable memory usage (pre-allocation)
+ *              - safe decoding (malformed/truncated input)
+ *              - zero external dependencies
+ *
+ * ⚠️ Fully standards-compliant behavior for replacement (U+FFFD)
+ */
+export class UTF8Codec {
+    static REPLACEMENT_CHAR = '\uFFFD';
+    /**
+     * Encodes a string into a UTF-8 byte array.
+     * @param text The string to encode.
+     * @returns A Uint8Array containing the UTF-8 encoded bytes of the input string.
+     */
+    static encode(text) {
+        const len = text.length;
+        let byteLength = 0;
+        for (let i = 0; i < len; i++) {
+            const code = text.charCodeAt(i);
+            if (code < 0x80) {
+                byteLength += 1;
+            }
+            else if (code < 0x800) {
+                byteLength += 2;
+            }
+            else if (code >= 0xd800 && code <= 0xdbff) {
+                const next = i + 1 < len ? text.charCodeAt(i + 1) : 0;
+                if (next >= 0xdc00 && next <= 0xdfff) {
+                    byteLength += 4;
+                    i++;
+                }
+                else {
+                    byteLength += 3;
+                }
+            }
+            else {
+                byteLength += 3;
+            }
+        }
+        const out = new Uint8Array(byteLength);
+        let offset = 0;
+        for (let i = 0; i < len; i++) {
+            const code = text.charCodeAt(i);
+            if (code < 0x80) {
+                out[offset++] = code;
+                continue;
+            }
+            if (code < 0x800) {
+                out[offset++] = 0xc0 | (code >> 6);
+                out[offset++] = 0x80 | (code & 0x3f);
+                continue;
+            }
+            if (code >= 0xd800 && code <= 0xdbff) {
+                const next = i + 1 < len ? text.charCodeAt(i + 1) : 0;
+                if (next >= 0xdc00 && next <= 0xdfff) {
+                    const cp = 0x10000 + ((code & 0x3ff) << 10) + (next & 0x3ff);
+                    out[offset++] = 0xf0 | (cp >> 18);
+                    out[offset++] = 0x80 | ((cp >> 12) & 0x3f);
+                    out[offset++] = 0x80 | ((cp >> 6) & 0x3f);
+                    out[offset++] = 0x80 | (cp & 0x3f);
+                    i++;
+                    continue;
+                }
+                offset = this.writeReplacement(out, offset);
+                continue;
+            }
+            out[offset++] = 0xe0 | (code >> 12);
+            out[offset++] = 0x80 | ((code >> 6) & 0x3f);
+            out[offset++] = 0x80 | (code & 0x3f);
+        }
+        return out;
+    }
+    /**
+     * Decodes a UTF-8 byte array into a string. Malformed sequences are replaced with the Unicode replacement character (U+FFFD).
+     * @param bytes The Uint8Array containing the UTF-8 encoded bytes to decode.
+     * @returns The decoded string, with any malformed sequences replaced by U+FFFD.
+     */
+    static decode(bytes) {
+        let out = '';
+        let i = 0;
+        const len = bytes.length;
+        while (i < len) {
+            const b1 = bytes[i++];
+            if (b1 < 0x80) {
+                out += String.fromCharCode(b1);
+                continue;
+            }
+            if ((b1 & 0xe0) === 0xc0) {
+                if (i >= len) {
+                    out += this.REPLACEMENT_CHAR;
+                    break;
+                }
+                const b2 = bytes[i++];
+                if ((b2 & 0xc0) !== 0x80) {
+                    out += this.REPLACEMENT_CHAR;
+                    continue;
+                }
+                const code = ((b1 & 0x1f) << 6) | (b2 & 0x3f);
+                out += String.fromCharCode(code);
+                continue;
+            }
+            if ((b1 & 0xf0) === 0xe0) {
+                if (i + 1 >= len) {
+                    out += this.REPLACEMENT_CHAR;
+                    break;
+                }
+                const b2 = bytes[i++];
+                const b3 = bytes[i++];
+                if ((b2 & 0xc0) !== 0x80 || (b3 & 0xc0) !== 0x80) {
+                    out += this.REPLACEMENT_CHAR;
+                    continue;
+                }
+                const code = ((b1 & 0x0f) << 12) | ((b2 & 0x3f) << 6) | (b3 & 0x3f);
+                out += String.fromCharCode(code);
+                continue;
+            }
+            if ((b1 & 0xf8) === 0xf0) {
+                if (i + 2 >= len) {
+                    out += this.REPLACEMENT_CHAR;
+                    break;
+                }
+                const b2 = bytes[i++];
+                const b3 = bytes[i++];
+                const b4 = bytes[i++];
+                if ((b2 & 0xc0) !== 0x80 || (b3 & 0xc0) !== 0x80 || (b4 & 0xc0) !== 0x80) {
+                    out += this.REPLACEMENT_CHAR;
+                    continue;
+                }
+                const cp = ((b1 & 0x07) << 18) | ((b2 & 0x3f) << 12) | ((b3 & 0x3f) << 6) | (b4 & 0x3f);
+                out += String.fromCodePoint(cp);
+                continue;
+            }
+            out += this.REPLACEMENT_CHAR;
+        }
+        return out;
+    }
+    /**
+     * Writes the UTF-8 encoding of the replacement character (U+FFFD) to the output buffer at the specified offset.
+     * @param out The output buffer to write to.
+     * @param offset The offset in the buffer where the replacement character should be written.
+     * @returns The new offset after writing the replacement character.
+     */
+    static writeReplacement(out, offset) {
+        out[offset++] = 0xef;
+        out[offset++] = 0xbf;
+        out[offset++] = 0xbd;
+        return offset;
+    }
+}
+export default UTF8Codec;
+//# sourceMappingURL=UTF8Codec.js.map

package/build/support/UTF8Codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UTF8Codec.js","sourceRoot":"","sources":["../../src/support/UTF8Codec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,SAAS;IACV,MAAM,CAAU,gBAAgB,GAAG,QAAQ,CAAC;IACpD;;;;OAIG;IACI,MAAM,CAAC,MAAM,CAAC,IAAY;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;QACxB,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAEhC,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;gBAAC,UAAU,IAAI,CAAC,CAAC;YAAC,CAAC;iBAChC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;gBAAC,UAAU,IAAI,CAAC,CAAC;YAAC,CAAC;iBACtC,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACxC,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAEtD,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;oBACnC,UAAU,IAAI,CAAC,CAAC;oBAChB,CAAC,EAAE,CAAC;gBACR,CAAC;qBAAM,CAAC;oBAAC,UAAU,IAAI,CAAC,CAAC;gBAAC,CAAC;YAC/B,CAAC;iBAAM,CAAC;gBAAC,UAAU,IAAI,CAAC,CAAC;YAAC,CAAC;QAC/B,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC;QACvC,IAAI,MAAM,GAAG,CAAC,CAAC;QAEf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAChC,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;gBACd,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;gBACrB,SAAS;YACb,CAAC;YACD,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;gBACf,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;gBACnC,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;gBACrC,SAAS;YACb,CAAC;YACD,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACnC,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAEtD,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;oBACnC,MAAM,EAAE,GAAG,OAAO,GAAG,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;oBAE7D,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;oBAClC,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;oBAC3C,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;oBAC1C,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;oBAEnC,CAAC,EAAE,CAAC;oBACJ,SAAS;gBACb,CAAC;gBACD,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;gBAC5C,SAAS;YACb,CAAC;YACD,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YACpC,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YAC5C,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,GAAG,CAAC;IACf,CAAC;IACD;;;;OAIG;IACI,MAAM,CAAC,MAAM,CAAC,KAAiB;QAClC,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;QAEzB,OAAO,CAAC,GAAG,GAAG,EAAE,CAAC;YACb,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;YACtB,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;gBACZ,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;gBAC/B,SAAS;YACb,CAAC;YACD,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;gBACvB,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;oBACX,GAAG,IAAI,IAAI,CAAC,gBAAgB,CAAC;oBAC7B,MAAM;gBACV,CAAC;gBAED,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;gBAEtB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;oBACvB,GAAG,IAAI,IAAI,CAAC,gBAAgB,CAAC;oBAC7B,SAAS;gBACb,CAAC;gBAED,MAAM,IAAI,GAAG,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;gBAC9C,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;gBACjC,SAAS;YACb,CAAC;YACD,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;gBACvB,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;oBACf,GAAG,IAAI,IAAI,CAAC,gBAAgB,CAAC;oBAC7B,MAAM;gBACV,CAAC;gBAED,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;gBACtB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;gBAEtB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;oBAC/C,GAAG,IAAI,IAAI,CAAC,gBAAgB,CAAC;oBAC7B,SAAS;gBACb,CAAC;gBAED,MAAM,IAAI,GAAG,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;gBAEpE,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;gBACjC,SAAS;YACb,CAAC;YACD,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;gBACvB,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;oBACf,GAAG,IAAI,IAAI,CAAC,gBAAgB,CAAC;oBAC7B,MAAM;gBACV,CAAC;gBAED,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;gBACtB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;gBACtB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;gBAEtB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;oBACvE,GAAG,IAAI,IAAI,CAAC,gBAAgB,CAAC;oBAC7B,SAAS;gBACb,CAAC;gBAED,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;gBAExF,GAAG,IAAI,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;gBAChC,SAAS;YACb,CAAC;YACD,GAAG,IAAI,IAAI,CAAC,gBAAgB,CAAC;QACjC,CAAC;QAED,OAAO,GAAG,CAAC;IACf,CAAC;IACD;;;;;OAKG;IACO,MAAM,CAAC,gBAAgB,CAAC,GAAe,EAAE,MAAc;QAC7D,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;QACrB,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;QACrB,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;QACrB,OAAO,MAAM,CAAC;IAClB,CAAC;;AAGL,eAAe,SAAS,CAAC"}

package/build/support/UUID.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @module vortez-io
+ * @author NetFeez <netfeez.dev@gemail.com>
+ * @license Apache-2.0
+ * @description Isomorphic UUID v4 generator.
+ *
+ *              ⚠️ IMPORTANT: READ THIS BEFORE USING.
+ *
+ *              IS NO LONGER CRYPTOGRAPHICALLY SECURE.
+ *              This module provides a fallback implementation of UUID v4 generation using a Linear Congruential Generator (LCG) algorithm
+ *              The generated UUIDs are suitable for non-cryptographic use cases, such as generating unique identifiers for events or requests within the Vortez IO protocol, but should not be used in security-sensitive contexts.
+ */
+export declare class UUID {
+    private static seed;
+    private static readonly HEX_TABLE;
+    /**
+     * Initialize the seed for the LCG fallback using a combination of current time and random value.
+     * This ensures that the generated UUIDs are not the same across different runs of the application, even in fallback mode.
+     * @returns A 32-bit unsigned integer to be used as the initial seed for the LCG.
+     */
+    private static initSeed;
+    /**
+     * Generate the next 32-bit unsigned integer using a Linear Congruential Generator (LCG) algorithm.
+     * This method is used as a fallback for generating random values when crypto APIs are not available.
+     * The LCG parameters are chosen to provide a reasonable period and distribution for non-cryptographic use cases.
+     * @returns A 32-bit unsigned integer generated by the LCG algorithm.
+     */
+    private static next32;
+    /**
+     * Generate a UUID v4 string in the format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
+     * This method uses the createRaw() method to generate a 16-byte Uint8Array and then converts it to the standard UUID string format.
+     * @returns A string representation of the generated UUID.
+     */
+    static create(): string;
+    /**
+     * Generate a 16-byte Uint8Array containing a UUID v4.
+     * This method uses the LCG fallback to generate random values when crypto APIs are not available.
+     * @returns A Uint8Array containing the 16 bytes of the UUID.
+     */
+    static createRaw(): Uint8Array;
+    /**
+     * Convert a 16-byte Uint8Array to a UUID string in the format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
+     * @param bin A Uint8Array containing the 16 bytes of the UUID.
+     * @returns A string representation of the UUID.
+     */
+    static binToUuid(bin: Uint8Array): string;
+    /**
+     * Convert a UUID string in the format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx to a 16-byte Uint8Array.
+     * @param uuid A string representation of the UUID.
+     * @returns A Uint8Array containing the 16 bytes of the UUID.
+     */
+    static uuidToBin(uuid: string): Uint8Array;
+    /**
+     * Validate whether a given string is a valid UUID v4 according to the standard format and version/type bits.
+     * This method checks that the string matches the expected pattern for UUID v4, including the correct placement of hyphens and the specific bits that indicate version 4 and the variant.
+     * @param uuid The string to validate as a UUID v4.
+     * @returns True if the input string is a valid UUID v4, false otherwise.
+     */
+    static isValid(uuid: string): boolean;
+}
+export declare namespace UUID { }
+export default UUID;

package/build/support/UUID.js

@@ -0,0 +1,109 @@
+/**
+ * @module vortez-io
+ * @author NetFeez <netfeez.dev@gemail.com>
+ * @license Apache-2.0
+ * @description Isomorphic UUID v4 generator.
+ *
+ *              ⚠️ IMPORTANT: READ THIS BEFORE USING.
+ *
+ *              IS NO LONGER CRYPTOGRAPHICALLY SECURE.
+ *              This module provides a fallback implementation of UUID v4 generation using a Linear Congruential Generator (LCG) algorithm
+ *              The generated UUIDs are suitable for non-cryptographic use cases, such as generating unique identifiers for events or requests within the Vortez IO protocol, but should not be used in security-sensitive contexts.
+ */
+export class UUID {
+    static seed = UUID.initSeed();
+    static HEX_TABLE = Array.from({ length: 256 }, (_, i) => i.toString(16).padStart(2, '0'));
+    /**
+     * Initialize the seed for the LCG fallback using a combination of current time and random value.
+     * This ensures that the generated UUIDs are not the same across different runs of the application, even in fallback mode.
+     * @returns A 32-bit unsigned integer to be used as the initial seed for the LCG.
+     */
+    static initSeed() {
+        return (Date.now() ^ Math.floor(Math.random() * 0xffffffff)) >>> 0;
+    }
+    /**
+     * Generate the next 32-bit unsigned integer using a Linear Congruential Generator (LCG) algorithm.
+     * This method is used as a fallback for generating random values when crypto APIs are not available.
+     * The LCG parameters are chosen to provide a reasonable period and distribution for non-cryptographic use cases.
+     * @returns A 32-bit unsigned integer generated by the LCG algorithm.
+     */
+    static next32() {
+        UUID.seed = (1664525 * UUID.seed + 1013904223) >>> 0;
+        return UUID.seed;
+    }
+    /**
+     * Generate a UUID v4 string in the format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
+     * This method uses the createRaw() method to generate a 16-byte Uint8Array and then converts it to the standard UUID string format.
+     * @returns A string representation of the generated UUID.
+     */
+    static create() {
+        return this.binToUuid(this.createRaw());
+    }
+    /**
+     * Generate a 16-byte Uint8Array containing a UUID v4.
+     * This method uses the LCG fallback to generate random values when crypto APIs are not available.
+     * @returns A Uint8Array containing the 16 bytes of the UUID.
+     */
+    static createRaw() {
+        const bytes = new Uint8Array(16);
+        for (let i = 0; i < 16; i += 4) {
+            const n = UUID.next32();
+            bytes[i] = (n >>> 24) & 0xff;
+            bytes[i + 1] = (n >>> 16) & 0xff;
+            bytes[i + 2] = (n >>> 8) & 0xff;
+            bytes[i + 3] = n & 0xff;
+        }
+        bytes[6] = (bytes[6] & 0x0f) | 0x40;
+        bytes[8] = (bytes[8] & 0x3f) | 0x80;
+        return bytes;
+    }
+    /**
+     * Convert a 16-byte Uint8Array to a UUID string in the format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
+     * @param bin A Uint8Array containing the 16 bytes of the UUID.
+     * @returns A string representation of the UUID.
+     */
+    static binToUuid(bin) {
+        const hex = UUID.HEX_TABLE;
+        return (hex[bin[0]] + hex[bin[1]] + hex[bin[2]] + hex[bin[3]] + "-" +
+            hex[bin[4]] + hex[bin[5]] + "-" +
+            hex[bin[6]] + hex[bin[7]] + "-" +
+            hex[bin[8]] + hex[bin[9]] + "-" +
+            hex[bin[10]] + hex[bin[11]] + hex[bin[12]] +
+            hex[bin[13]] + hex[bin[14]] + hex[bin[15]]);
+    }
+    /**
+     * Convert a UUID string in the format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx to a 16-byte Uint8Array.
+     * @param uuid A string representation of the UUID.
+     * @returns A Uint8Array containing the 16 bytes of the UUID.
+     */
+    static uuidToBin(uuid) {
+        const hex = UUID.HEX_TABLE;
+        const bin = new Uint8Array(16);
+        const parts = uuid.split('-');
+        if (parts.length !== 5)
+            throw new Error(`Invalid UUID format: ${uuid}`);
+        const hexStr = parts.join('');
+        if (hexStr.length !== 32)
+            throw new Error(`Invalid UUID format: ${uuid}`);
+        for (let i = 0; i < 16; i++) {
+            const byteHex = hexStr.substr(i * 2, 2);
+            const byteValue = parseInt(byteHex, 16);
+            if (isNaN(byteValue))
+                throw new Error(`Invalid UUID format: ${uuid}`);
+            bin[i] = byteValue;
+        }
+        return bin;
+    }
+    /**
+     * Validate whether a given string is a valid UUID v4 according to the standard format and version/type bits.
+     * This method checks that the string matches the expected pattern for UUID v4, including the correct placement of hyphens and the specific bits that indicate version 4 and the variant.
+     * @param uuid The string to validate as a UUID v4.
+     * @returns True if the input string is a valid UUID v4, false otherwise.
+     */
+    static isValid(uuid) {
+        const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+        return uuidRegex.test(uuid);
+    }
+}
+export default UUID;
+//# sourceMappingURL=UUID.js.map

package/build/support/UUID.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UUID.js","sourceRoot":"","sources":["../../src/support/UUID.ts"],"names":[],"mappings":"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"}

package/build/support/Varint.d.ts

@@ -0,0 +1,26 @@
+export declare class Varint {
+    /**
+     * Reads a varint-encoded integer from the given Uint8Array starting at the specified offset.
+     * Varints are a compact way to encode integers, where smaller numbers take fewer bytes.
+     * Each byte uses the lower 7 bits to store data and the highest bit as a continuation flag (1 if more bytes follow, 0 if this is the last byte).
+     * @param view The Uint8Array to read from.
+     * @param offset The starting index in the array to read the varint from.
+     * @returns An object containing the decoded integer value and the new offset after reading the varint.
+     */
+    static readVarint(view: Uint8Array, offset: number): Varint.Result;
+    /**
+     * Encodes a number into a varint format (base-128 encoding) and returns it as a Uint8Array.
+     * Varints are a compact way to encode integers, where smaller numbers take fewer bytes.
+     * Each byte uses the lower 7 bits to store data and the highest bit as a continuation flag (1 if more bytes follow, 0 if this is the last byte).
+     * @param value The number to encode as a varint. Must be a non-negative integer.
+     * @returns A Uint8Array containing the varint-encoded bytes of the input number.
+     */
+    static writeVarint(value: number): Uint8Array;
+}
+export declare namespace Varint {
+    interface Result {
+        value: number;
+        offset: number;
+    }
+}
+export default Varint;

package/build/support/Varint.js

@@ -0,0 +1,61 @@
+/**
+ * @module vortez-io
+ * @author NetFeez <netfeez.dev@gemail.com>
+ * @license Apache-2.0
+ * @description Provides encoding and decoding functionality for variable-length integers (varints) used in the Vortez IO protocol.
+ *              Varints are a compact way to encode integers, where smaller numbers take fewer bytes. Each byte uses the lower 7 bits to store data and the highest bit as a continuation flag (1 if more bytes follow, 0 if this is the last byte).
+ *              This module includes methods for reading varints from a Uint8Array and writing numbers as varints into a Uint8Array, with error handling for invalid input and buffer overflows.
+ */
+import VIOError from "../VIOError.js";
+export class Varint {
+    /**
+     * Reads a varint-encoded integer from the given Uint8Array starting at the specified offset.
+     * Varints are a compact way to encode integers, where smaller numbers take fewer bytes.
+     * Each byte uses the lower 7 bits to store data and the highest bit as a continuation flag (1 if more bytes follow, 0 if this is the last byte).
+     * @param view The Uint8Array to read from.
+     * @param offset The starting index in the array to read the varint from.
+     * @returns An object containing the decoded integer value and the new offset after reading the varint.
+     */
+    static readVarint(view, offset) {
+        let value = 0;
+        let shift = 0;
+        let pos = offset;
+        while (true) {
+            if (pos >= view.length)
+                throw new VIOError(VIOError.Code.BUFFER_TOO_SHORT, 'Varint truncated');
+            const byte = view[pos++];
+            value |= (byte & 0x7F) << shift;
+            if ((byte & 0x80) === 0)
+                break;
+            shift += 7;
+            if (shift > 35)
+                throw new VIOError(VIOError.Code.INVALID_DATA, 'Varint too large');
+        }
+        return { value, offset: pos };
+    }
+    /**
+     * Encodes a number into a varint format (base-128 encoding) and returns it as a Uint8Array.
+     * Varints are a compact way to encode integers, where smaller numbers take fewer bytes.
+     * Each byte uses the lower 7 bits to store data and the highest bit as a continuation flag (1 if more bytes follow, 0 if this is the last byte).
+     * @param value The number to encode as a varint. Must be a non-negative integer.
+     * @returns A Uint8Array containing the varint-encoded bytes of the input number.
+     */
+    static writeVarint(value) {
+        if (value < 0)
+            throw new VIOError(VIOError.Code.INVALID_DATA, 'Varint cannot be negative');
+        const bytes = [];
+        while (true) {
+            let byte = value & 0x7F;
+            value >>>= 7;
+            if (value !== 0) {
+                byte |= 0x80;
+            }
+            bytes.push(byte);
+            if (value === 0)
+                break;
+        }
+        return new Uint8Array(bytes);
+    }
+}
+export default Varint;
+//# sourceMappingURL=Varint.js.map

package/build/support/Varint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Varint.js","sourceRoot":"","sources":["../../src/support/Varint.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,MAAM,OAAO,MAAM;IACf;;;;;;;OAOG;IACI,MAAM,CAAC,UAAU,CAAC,IAAgB,EAAE,MAAc;QACrD,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,GAAG,GAAG,MAAM,CAAC;QAEjB,OAAO,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;YAC/F,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YACzB,KAAK,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,CAAC;YAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;gBAAE,MAAM;YAC/B,KAAK,IAAI,CAAC,CAAC;YACX,IAAI,KAAK,GAAG,EAAE;gBAAE,MAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;QACvF,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAClC,CAAC;IACD;;;;;;OAMG;IACI,MAAM,CAAC,WAAW,CAAC,KAAa;QACnC,IAAI,KAAK,GAAG,CAAC;YAAE,MAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,2BAA2B,CAAC,CAAC;QAC3F,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,OAAO,IAAI,EAAE,CAAC;YACV,IAAI,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC;YACxB,KAAK,MAAM,CAAC,CAAC;YACb,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBAAC,IAAI,IAAI,IAAI,CAAC;YAAC,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,IAAI,KAAK,KAAK,CAAC;gBAAE,MAAM;QAC3B,CAAC;QACD,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;CACJ;AAOD,eAAe,MAAM,CAAC"}