npm i @hazae41/bytes

Features

Usage

Sized bytes

constbytes8=Bytes.alloc(8)// Bytes<8>

Unsafe-allocated sized bytes

constbytes8=Bytes.allocUnsafe(8)// Bytes<8>

Random sized bytes

constbytes8=Bytes.random(8)// Bytes<8>

Unknown-sized bytes

constbytesX=newUint8Array(8)// Bytes<number>

Runtime type-guarding

if(Bytes.is(bytesX,8))bytesX// Bytes<8>elsebytesX// Bytes<number>

Type-guarded runtime equality check

if(Bytes.equals(bytesX,bytes8))bytesX// Bytes<8>elsebytesX// Bytes<number>

Runtime casting with Result pattern

constbytes16=Bytes.tryCast(bytesX,16).unwrap()// Bytes<16>

Conversion from sized arrays

constsized4=Sized.cast([1,2,3,4],4).unwrap()// Sized<4>constbytes4=Bytes.from(sized4)// Bytes<4>

Utf8, Hex, Base64, Ascii encoding

Bytes.fromUtf8(Bytes.toUtf8(bytesX))

Bytes.fromHex(Bytes.toHex(bytesX))

Bytes.fromBase64(Bytes.toBase64(bytesX))

Bytes.fromAscii(Bytes.toAscii(bytesX))

BigInt conversion

Bytes.fromBigInt(Bytes.toBigInt(bytesX))

Sized slicing and padding

constbytes8=Bytes.sliceOrPadStart(bytesX,8)// Bytes<8>