@atcute/uint8array 1.0.5 → 1.1.0

package/dist/index.node.d.ts

@@ -1,11 +1,38 @@
 export declare const alloc: (size: number) => Uint8Array<ArrayBuffer>;
 export declare const allocUnsafe: (size: number) => Uint8Array<ArrayBuffer>;
-export declare const compare: (a: Uint8Array, b: Uint8Array) => number;
-export declare const equals: (a: Uint8Array, b: Uint8Array) => boolean;
-export declare const timingSafeEquals: (a: Uint8Array, b: Uint8Array) => boolean;
-export declare const concat: (arrays: Uint8Array[], size?: number) => Uint8Array<ArrayBuffer>;
+export declare const compare: (a: Uint8Array<ArrayBufferLike>, b: Uint8Array<ArrayBufferLike>) => number;
+export declare const equals: (a: Uint8Array<ArrayBufferLike>, b: Uint8Array<ArrayBufferLike>) => boolean;
+export declare const timingSafeEquals: (a: Uint8Array<ArrayBufferLike>, b: Uint8Array<ArrayBufferLike>) => boolean;
+export declare const concat: (arrays: Uint8Array<ArrayBufferLike>[], size?: number | undefined) => Uint8Array<ArrayBuffer>;
 export declare const encodeUtf8: (str: string) => Uint8Array<ArrayBuffer>;
-export declare const encodeUtf8Into: (to: Uint8Array, str: string, offset?: number, length?: number) => number;
-export declare const decodeUtf8From: (from: Uint8Array, offset?: number, length?: number) => string;
-export declare const toSha256: (buffer: Uint8Array) => Promise<Uint8Array<ArrayBuffer>>;
+export declare const encodeUtf8Into: (to: Uint8Array<ArrayBufferLike>, str: string, offset?: number | undefined, length?: number | undefined) => number;
+/**
+ * decodes a UTF-8 string from a given buffer
+ * @param from source buffer
+ * @param offset byte offset to start reading from
+ * @param length number of bytes to read
+ * @returns decoded string
+ */
+export declare const decodeUtf8From: (from: Uint8Array<ArrayBufferLike>, offset?: number, length?: number) => string;
+/**
+ * calculates the UTF-8 byte length of a string
+ * @param str string to measure
+ * @returns byte length when encoded as UTF-8
+ */
+export declare const getUtf8Length: (str: string) => number;
+/**
+ * checks if a string's UTF-8 byte length is within a given range
+ * @param str string to measure
+ * @param min minimum byte length (inclusive)
+ * @param max maximum byte length (inclusive)
+ * @returns true if byte length is within [min, max]
+ */
+export declare const isUtf8LengthInRange: (str: string, min: number, max: number) => boolean;
+export declare const toSha256: (buffer: Uint8Array<ArrayBufferLike>) => Promise<Uint8Array<ArrayBuffer>>;
+/**
+ * generates cryptographically secure random bytes
+ * @param size number of bytes to generate
+ * @returns buffer filled with random bytes
+ */
+export declare const randomBytes: (size: number) => Uint8Array<ArrayBuffer>;
 //# sourceMappingURL=index.node.d.ts.map

package/dist/index.node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.node.d.ts","sourceRoot":"","sources":["../lib/index.node.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM,KAAG,UAAU,CAAC,WAAW,CAE1D,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,UAAU,CAAC,WAAW,CAEhE,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,GAAG,UAAU,EAAE,GAAG,UAAU,KAAG,MAEtD,CAAC;AAEF,eAAO,MAAM,MAAM,GAAI,GAAG,UAAU,EAAE,GAAG,UAAU,KAAG,OAErD,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,GAAG,UAAU,EAAE,GAAG,UAAU,KAAG,OAE/D,CAAC;AAEF,eAAO,MAAM,MAAM,GAAI,QAAQ,UAAU,EAAE,EAAE,OAAO,MAAM,KAAG,UAAU,CAAC,WAAW,CAElF,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,KAAG,UAAU,CAAC,WAAW,CAE9D,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,IAAI,UAAU,EAAE,KAAK,MAAM,EAAE,SAAS,MAAM,EAAE,SAAS,MAAM,KAAG,MAE9F,CAAC;AAEF,eAAO,MAAM,cAAc,GAC1B,MAAM,UAAU,EAChB,SAAQ,MAAU,EAClB,SAAQ,MAAoB,KAC1B,MAEF,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAU,QAAQ,UAAU,KAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAElF,CAAC"}
+{"version":3,"file":"index.node.d.ts","sourceRoot":"","sources":["../lib/index.node.ts"],"names":[],"mappings":"AAuBA,eAAO,MAAM,KAAK,2CAEjB,CAAC;AAEF,eAAO,MAAM,WAAW,2CAEvB,CAAC;AAEF,eAAO,MAAM,OAAO,4EAEnB,CAAC;AAEF,eAAO,MAAM,MAAM,6EAElB,CAAC;AAEF,eAAO,MAAM,gBAAgB,6EAE5B,CAAC;AAEF,eAAO,MAAM,MAAM,+FAElB,CAAC;AAEF,eAAO,MAAM,UAAU,0CAEtB,CAAC;AAEF,eAAO,MAAM,cAAc,oHAE1B,CAAC;AAyEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,iFAU1B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,yBAEzB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,oDAG/B,CAAC;AAEF,eAAO,MAAM,QAAQ,2EAEpB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,2CAEvB,CAAC"}

package/dist/index.node.js

@@ -1,9 +1,10 @@
 import { Buffer as NodeBuffer } from 'node:buffer';
-import { hash as _hash, timingSafeEqual as _timingSafeEqual } from 'node:crypto';
+import { hash as _hash, randomFillSync as _randomFillSync, timingSafeEqual as _timingSafeEqual, } from 'node:crypto';
 const _alloc = /*#__PURE__*/ NodeBuffer.alloc;
 const _allocUnsafe = /*#__PURE__*/ NodeBuffer.allocUnsafe;
 const _concat = /*#__PURE__*/ NodeBuffer.concat;
 const _from = /*#__PURE__*/ NodeBuffer.from;
+const _byteLength = /*#__PURE__*/ NodeBuffer.byteLength;
 const _compare = /*#__PURE__*/ NodeBuffer.prototype.compare;
 const _equals = /*#__PURE__*/ NodeBuffer.prototype.equals;
 const _utf8Slice = /*#__PURE__*/ NodeBuffer.prototype.utf8Slice;
@@ -35,10 +36,144 @@ export const encodeUtf8 = (str) => {
 export const encodeUtf8Into = (to, str, offset, length) => {
     return _utf8Write.call(to, str, offset, length);
 };
+const _fromCharCode = String.fromCharCode;
+// fully unrolled short string decoder, inspired by cbor-x
+// returns null if non-ASCII byte encountered, signaling fallback to utf8Slice
+const _shortString = (from, p, length) => {
+    if (length < 4) {
+        if (length < 2) {
+            if (length === 0)
+                return '';
+            const a = from[p];
+            if (a & 0x80)
+                return null;
+            return _fromCharCode(a);
+        }
+        const a = from[p];
+        const b = from[p + 1];
+        if ((a | b) & 0x80)
+            return null;
+        if (length === 2)
+            return _fromCharCode(a, b);
+        const c = from[p + 2];
+        if (c & 0x80)
+            return null;
+        return _fromCharCode(a, b, c);
+    }
+    const a = from[p];
+    const b = from[p + 1];
+    const c = from[p + 2];
+    const d = from[p + 3];
+    if ((a | b | c | d) & 0x80)
+        return null;
+    if (length < 8) {
+        if (length === 4)
+            return _fromCharCode(a, b, c, d);
+        const e = from[p + 4];
+        if (e & 0x80)
+            return null;
+        if (length === 5)
+            return _fromCharCode(a, b, c, d, e);
+        const f = from[p + 5];
+        if (f & 0x80)
+            return null;
+        if (length === 6)
+            return _fromCharCode(a, b, c, d, e, f);
+        const g = from[p + 6];
+        if (g & 0x80)
+            return null;
+        return _fromCharCode(a, b, c, d, e, f, g);
+    }
+    const e = from[p + 4];
+    const f = from[p + 5];
+    const g = from[p + 6];
+    const h = from[p + 7];
+    if ((e | f | g | h) & 0x80)
+        return null;
+    if (length < 12) {
+        if (length === 8)
+            return _fromCharCode(a, b, c, d, e, f, g, h);
+        const i = from[p + 8];
+        if (i & 0x80)
+            return null;
+        if (length === 9)
+            return _fromCharCode(a, b, c, d, e, f, g, h, i);
+        const j = from[p + 9];
+        if (j & 0x80)
+            return null;
+        if (length === 10)
+            return _fromCharCode(a, b, c, d, e, f, g, h, i, j);
+        const k = from[p + 10];
+        if (k & 0x80)
+            return null;
+        return _fromCharCode(a, b, c, d, e, f, g, h, i, j, k);
+    }
+    const i = from[p + 8];
+    const j = from[p + 9];
+    const k = from[p + 10];
+    const l = from[p + 11];
+    if ((i | j | k | l) & 0x80)
+        return null;
+    if (length === 12)
+        return _fromCharCode(a, b, c, d, e, f, g, h, i, j, k, l);
+    const m = from[p + 12];
+    if (m & 0x80)
+        return null;
+    if (length === 13)
+        return _fromCharCode(a, b, c, d, e, f, g, h, i, j, k, l, m);
+    const n = from[p + 13];
+    if (n & 0x80)
+        return null;
+    if (length === 14)
+        return _fromCharCode(a, b, c, d, e, f, g, h, i, j, k, l, m, n);
+    const o = from[p + 14];
+    if (o & 0x80)
+        return null;
+    return _fromCharCode(a, b, c, d, e, f, g, h, i, j, k, l, m, n, o);
+};
+/**
+ * decodes a UTF-8 string from a given buffer
+ * @param from source buffer
+ * @param offset byte offset to start reading from
+ * @param length number of bytes to read
+ * @returns decoded string
+ */
 export const decodeUtf8From = (from, offset = 0, length = from.length) => {
+    if (length <= 15) {
+        const result = _shortString(from, offset, length);
+        if (result !== null)
+            return result;
+    }
     return _utf8Slice.call(from, offset, offset + length);
 };
+/**
+ * calculates the UTF-8 byte length of a string
+ * @param str string to measure
+ * @returns byte length when encoded as UTF-8
+ */
+export const getUtf8Length = (str) => {
+    return _byteLength(str, 'utf8');
+};
+/**
+ * checks if a string's UTF-8 byte length is within a given range
+ * @param str string to measure
+ * @param min minimum byte length (inclusive)
+ * @param max maximum byte length (inclusive)
+ * @returns true if byte length is within [min, max]
+ */
+export const isUtf8LengthInRange = (str, min, max) => {
+    const len = _byteLength(str, 'utf8');
+    return len >= min && len <= max;
+};
 export const toSha256 = async (buffer) => {
     return toUint8Array(_hash('sha256', buffer, 'buffer'));
 };
+/**
+ * generates cryptographically secure random bytes
+ * @param size number of bytes to generate
+ * @returns buffer filled with random bytes
+ */
+export const randomBytes = (size) => {
+    return _randomFillSync(toUint8Array(_allocUnsafe(size)));
+};
 //# sourceMappingURL=index.node.js.map

package/dist/index.node.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.node.js","sourceRoot":"","sources":["../lib/index.node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,IAAI,IAAI,KAAK,EAAE,eAAe,IAAI,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEjF,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC;AAC9C,MAAM,YAAY,GAAG,aAAa,CAAC,UAAU,CAAC,WAAW,CAAC;AAC1D,MAAM,OAAO,GAAG,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC;AAChD,MAAM,KAAK,GAAG,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC;AAE5C,MAAM,QAAQ,GAAG,aAAa,CAAC,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC;AAC5D,MAAM,OAAO,GAAG,aAAa,CAAC,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC;AAC1D,MAAM,UAAU,GAAG,aAAa,CAAC,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC;AAChE,MAAM,UAAU,GAAG,aAAa,CAAC,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC;AAEhE,MAAM,YAAY,GAAG,CAAC,MAAkB,EAAE,EAAE;IAC3C,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;AAC5E,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,IAAY,EAA2B,EAAE;IAC9D,OAAO,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAA4B,CAAC;AAC9D,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAY,EAA2B,EAAE;IACpE,OAAO,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,CAA4B,CAAC;AACpE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAa,EAAE,CAAa,EAAU,EAAE;IAC/D,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC5B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAa,EAAE,CAAa,EAAW,EAAE;IAC/D,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC3B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAa,EAAE,CAAa,EAAW,EAAE;IACzE,OAAO,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAAoB,EAAE,IAAa,EAA2B,EAAE;IACtF,OAAO,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAA4B,CAAC;AACvE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAW,EAA2B,EAAE;IAClE,OAAO,YAAY,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAA4B,CAAC;AACpE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,EAAc,EAAE,GAAW,EAAE,MAAe,EAAE,MAAe,EAAU,EAAE;IACvG,OAAO,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACjD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAC7B,IAAgB,EAChB,SAAiB,CAAC,EAClB,SAAiB,IAAI,CAAC,MAAM,EACnB,EAAE;IACX,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AACvD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAkB,EAAoC,EAAE;IACtF,OAAO,YAAY,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAA4B,CAAC;AACnF,CAAC,CAAC"}
+{"version":3,"file":"index.node.js","sourceRoot":"","sources":["../lib/index.node.ts"],"names":[],"mappings":"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"}

package/lib/index.bun.ts

@@ -1,13 +1,14 @@
 import { allocUnsafe as _allocUnsafe, concatArrayBuffers as _concat } from 'bun';
-
 import { Buffer as NodeBuffer } from 'node:buffer';
 import { hash as _hash, timingSafeEqual as _timingSafeEqual } from 'node:crypto';
 
+const _byteLength = /*#__PURE__*/ NodeBuffer.byteLength;
+
 const _compare = /*#__PURE__*/ NodeBuffer.prototype.compare;
 const _equals = /*#__PURE__*/ NodeBuffer.prototype.equals;
+const _utf8Slice = /*#__PURE__*/ NodeBuffer.prototype.utf8Slice;
 
 const textEncoder = new TextEncoder();
-const textDecoder = new TextDecoder();
 
 const toUint8Array = (buffer: NodeBuffer) => {
 	return new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.byteLength);
@@ -54,58 +55,126 @@ export const encodeUtf8Into = (to: Uint8Array, str: string, offset?: number, len
 	return result.written;
 };
 
-const fromCharCode = String.fromCharCode;
+const _fromCharCode = String.fromCharCode;
+
+// fully unrolled short string decoder, inspired by cbor-x
+// returns null if non-ASCII byte encountered, signaling fallback to utf8Slice
+const _shortString = (from: Uint8Array, p: number, length: number): string | null => {
+	if (length < 4) {
+		if (length < 2) {
+			if (length === 0) return '';
+			const a = from[p];
+			if (a & 0x80) return null;
+			return _fromCharCode(a);
+		}
+		const a = from[p];
+		const b = from[p + 1];
+		if ((a | b) & 0x80) return null;
+		if (length === 2) return _fromCharCode(a, b);
+		const c = from[p + 2];
+		if (c & 0x80) return null;
+		return _fromCharCode(a, b, c);
+	}
+	const a = from[p];
+	const b = from[p + 1];
+	const c = from[p + 2];
+	const d = from[p + 3];
+	if ((a | b | c | d) & 0x80) return null;
+	if (length < 8) {
+		if (length === 4) return _fromCharCode(a, b, c, d);
+		const e = from[p + 4];
+		if (e & 0x80) return null;
+		if (length === 5) return _fromCharCode(a, b, c, d, e);
+		const f = from[p + 5];
+		if (f & 0x80) return null;
+		if (length === 6) return _fromCharCode(a, b, c, d, e, f);
+		const g = from[p + 6];
+		if (g & 0x80) return null;
+		return _fromCharCode(a, b, c, d, e, f, g);
+	}
+	const e = from[p + 4];
+	const f = from[p + 5];
+	const g = from[p + 6];
+	const h = from[p + 7];
+	if ((e | f | g | h) & 0x80) return null;
+	if (length < 12) {
+		if (length === 8) return _fromCharCode(a, b, c, d, e, f, g, h);
+		const i = from[p + 8];
+		if (i & 0x80) return null;
+		if (length === 9) return _fromCharCode(a, b, c, d, e, f, g, h, i);
+		const j = from[p + 9];
+		if (j & 0x80) return null;
+		if (length === 10) return _fromCharCode(a, b, c, d, e, f, g, h, i, j);
+		const k = from[p + 10];
+		if (k & 0x80) return null;
+		return _fromCharCode(a, b, c, d, e, f, g, h, i, j, k);
+	}
+	const i = from[p + 8];
+	const j = from[p + 9];
+	const k = from[p + 10];
+	const l = from[p + 11];
+	if ((i | j | k | l) & 0x80) return null;
+	if (length === 12) return _fromCharCode(a, b, c, d, e, f, g, h, i, j, k, l);
+	const m = from[p + 12];
+	if (m & 0x80) return null;
+	if (length === 13) return _fromCharCode(a, b, c, d, e, f, g, h, i, j, k, l, m);
+	const n = from[p + 13];
+	if (n & 0x80) return null;
+	if (length === 14) return _fromCharCode(a, b, c, d, e, f, g, h, i, j, k, l, m, n);
+	const o = from[p + 14];
+	if (o & 0x80) return null;
+	return _fromCharCode(a, b, c, d, e, f, g, h, i, j, k, l, m, n, o);
+};
 
 /**
  * decodes a UTF-8 string from a given buffer
+ * @param from source buffer
+ * @param offset byte offset to start reading from
+ * @param length number of bytes to read
+ * @returns decoded string
  */
-export const decodeUtf8From = (from: Uint8Array, offset?: number, length?: number): string => {
-	let buffer: Uint8Array;
-
-	if (offset === undefined) {
-		buffer = from;
-	} else if (length === undefined) {
-		buffer = from.subarray(offset);
-	} else {
-		buffer = from.subarray(offset, offset + length);
-	}
-
-	const end = buffer.length;
-	if (end > 24) {
-		return textDecoder.decode(buffer);
+export const decodeUtf8From = (
+	from: Uint8Array,
+	offset: number = 0,
+	length: number = from.length,
+): string => {
+	if (length <= 15) {
+		const result = _shortString(from, offset, length);
+		if (result !== null) return result;
 	}
+	return _utf8Slice.call(from, offset, offset + length);
+};
 
-	{
-		let str = '';
-		let idx = 0;
-
-		for (; idx + 3 < end; idx += 4) {
-			const a = buffer[idx];
-			const b = buffer[idx + 1];
-			const c = buffer[idx + 2];
-			const d = buffer[idx + 3];
-
-			if ((a | b | c | d) & 0x80) {
-				return str + textDecoder.decode(buffer.subarray(idx));
-			}
-
-			str += fromCharCode(a, b, c, d);
-		}
-
-		for (; idx < end; idx++) {
-			const x = buffer[idx];
-
-			if (x & 0x80) {
-				return str + textDecoder.decode(buffer.subarray(idx));
-			}
-
-			str += fromCharCode(x);
-		}
+/**
+ * calculates the UTF-8 byte length of a string
+ * @param str string to measure
+ * @returns byte length when encoded as UTF-8
+ */
+export const getUtf8Length = (str: string): number => {
+	return _byteLength(str, 'utf8');
+};
 
-		return str;
-	}
+/**
+ * checks if a string's UTF-8 byte length is within a given range
+ * @param str string to measure
+ * @param min minimum byte length (inclusive)
+ * @param max maximum byte length (inclusive)
+ * @returns true if byte length is within [min, max]
+ */
+export const isUtf8LengthInRange = (str: string, min: number, max: number): boolean => {
+	const len = _byteLength(str, 'utf8');
+	return len >= min && len <= max;
 };
 
 export const toSha256 = async (buffer: Uint8Array): Promise<Uint8Array<ArrayBuffer>> => {
 	return toUint8Array(_hash('sha256', buffer, 'buffer')) as Uint8Array<ArrayBuffer>;
 };
+
+/**
+ * generates cryptographically secure random bytes
+ * @param size number of bytes to generate
+ * @returns buffer filled with random bytes
+ */
+export const randomBytes = (size: number): Uint8Array<ArrayBuffer> => {
+	return crypto.getRandomValues(new Uint8Array(size));
+};

package/lib/index.node.ts

@@ -1,11 +1,17 @@
 import { Buffer as NodeBuffer } from 'node:buffer';
-import { hash as _hash, timingSafeEqual as _timingSafeEqual } from 'node:crypto';
+import {
+	hash as _hash,
+	randomFillSync as _randomFillSync,
+	timingSafeEqual as _timingSafeEqual,
+} from 'node:crypto';
 
 const _alloc = /*#__PURE__*/ NodeBuffer.alloc;
 const _allocUnsafe = /*#__PURE__*/ NodeBuffer.allocUnsafe;
 const _concat = /*#__PURE__*/ NodeBuffer.concat;
 const _from = /*#__PURE__*/ NodeBuffer.from;
 
+const _byteLength = /*#__PURE__*/ NodeBuffer.byteLength;
+
 const _compare = /*#__PURE__*/ NodeBuffer.prototype.compare;
 const _equals = /*#__PURE__*/ NodeBuffer.prototype.equals;
 const _utf8Slice = /*#__PURE__*/ NodeBuffer.prototype.utf8Slice;
@@ -47,14 +53,126 @@ export const encodeUtf8Into = (to: Uint8Array, str: string, offset?: number, len
 	return _utf8Write.call(to, str, offset, length);
 };
 
+const _fromCharCode = String.fromCharCode;
+
+// fully unrolled short string decoder, inspired by cbor-x
+// returns null if non-ASCII byte encountered, signaling fallback to utf8Slice
+const _shortString = (from: Uint8Array, p: number, length: number): string | null => {
+	if (length < 4) {
+		if (length < 2) {
+			if (length === 0) return '';
+			const a = from[p];
+			if (a & 0x80) return null;
+			return _fromCharCode(a);
+		}
+		const a = from[p];
+		const b = from[p + 1];
+		if ((a | b) & 0x80) return null;
+		if (length === 2) return _fromCharCode(a, b);
+		const c = from[p + 2];
+		if (c & 0x80) return null;
+		return _fromCharCode(a, b, c);
+	}
+	const a = from[p];
+	const b = from[p + 1];
+	const c = from[p + 2];
+	const d = from[p + 3];
+	if ((a | b | c | d) & 0x80) return null;
+	if (length < 8) {
+		if (length === 4) return _fromCharCode(a, b, c, d);
+		const e = from[p + 4];
+		if (e & 0x80) return null;
+		if (length === 5) return _fromCharCode(a, b, c, d, e);
+		const f = from[p + 5];
+		if (f & 0x80) return null;
+		if (length === 6) return _fromCharCode(a, b, c, d, e, f);
+		const g = from[p + 6];
+		if (g & 0x80) return null;
+		return _fromCharCode(a, b, c, d, e, f, g);
+	}
+	const e = from[p + 4];
+	const f = from[p + 5];
+	const g = from[p + 6];
+	const h = from[p + 7];
+	if ((e | f | g | h) & 0x80) return null;
+	if (length < 12) {
+		if (length === 8) return _fromCharCode(a, b, c, d, e, f, g, h);
+		const i = from[p + 8];
+		if (i & 0x80) return null;
+		if (length === 9) return _fromCharCode(a, b, c, d, e, f, g, h, i);
+		const j = from[p + 9];
+		if (j & 0x80) return null;
+		if (length === 10) return _fromCharCode(a, b, c, d, e, f, g, h, i, j);
+		const k = from[p + 10];
+		if (k & 0x80) return null;
+		return _fromCharCode(a, b, c, d, e, f, g, h, i, j, k);
+	}
+	const i = from[p + 8];
+	const j = from[p + 9];
+	const k = from[p + 10];
+	const l = from[p + 11];
+	if ((i | j | k | l) & 0x80) return null;
+	if (length === 12) return _fromCharCode(a, b, c, d, e, f, g, h, i, j, k, l);
+	const m = from[p + 12];
+	if (m & 0x80) return null;
+	if (length === 13) return _fromCharCode(a, b, c, d, e, f, g, h, i, j, k, l, m);
+	const n = from[p + 13];
+	if (n & 0x80) return null;
+	if (length === 14) return _fromCharCode(a, b, c, d, e, f, g, h, i, j, k, l, m, n);
+	const o = from[p + 14];
+	if (o & 0x80) return null;
+	return _fromCharCode(a, b, c, d, e, f, g, h, i, j, k, l, m, n, o);
+};
+
+/**
+ * decodes a UTF-8 string from a given buffer
+ * @param from source buffer
+ * @param offset byte offset to start reading from
+ * @param length number of bytes to read
+ * @returns decoded string
+ */
 export const decodeUtf8From = (
 	from: Uint8Array,
 	offset: number = 0,
 	length: number = from.length,
 ): string => {
+	if (length <= 15) {
+		const result = _shortString(from, offset, length);
+		if (result !== null) return result;
+	}
 	return _utf8Slice.call(from, offset, offset + length);
 };
 
+/**
+ * calculates the UTF-8 byte length of a string
+ * @param str string to measure
+ * @returns byte length when encoded as UTF-8
+ */
+export const getUtf8Length = (str: string): number => {
+	return _byteLength(str, 'utf8');
+};
+
+/**
+ * checks if a string's UTF-8 byte length is within a given range
+ * @param str string to measure
+ * @param min minimum byte length (inclusive)
+ * @param max maximum byte length (inclusive)
+ * @returns true if byte length is within [min, max]
+ */
+export const isUtf8LengthInRange = (str: string, min: number, max: number): boolean => {
+	const len = _byteLength(str, 'utf8');
+	return len >= min && len <= max;
+};
+
 export const toSha256 = async (buffer: Uint8Array): Promise<Uint8Array<ArrayBuffer>> => {
 	return toUint8Array(_hash('sha256', buffer, 'buffer')) as Uint8Array<ArrayBuffer>;
 };
+
+/**
+ * generates cryptographically secure random bytes
+ * @param size number of bytes to generate
+ * @returns buffer filled with random bytes
+ */
+export const randomBytes = (size: number): Uint8Array<ArrayBuffer> => {
+	return _randomFillSync(toUint8Array(_allocUnsafe(size))) as Uint8Array<ArrayBuffer>;
+};