@jsprismarine/jsbinaryutils - npm Package Compare versions

Comparing version

3.2.3

4.2.3

+340

dist/cjs/BinaryStream.d.ts

		/// <reference types="node" />
		export default class BinaryStream {
		private binary;
		private buffer;
		private readIndex;
		private writeIndex;
		/**
		* Creates a new BinaryStream instance.
		* @param {Buffer\|null\|undefined} buffer - The array or Buffer containing binary data.
		* @param {number} offset - The initial pointer position.
		*/
		constructor(buffer?: Buffer, offset?: number);
		/**
		* Reads a slice of buffer by the given length.
		* @param {number} len
		*/
		read(len: number): Buffer;
		/**
		* Appends a buffer to the main buffer.
		* @param {Buffer\|Uint8Array} buf
		*/
		write(buf: Uint8Array): void;
		/**
		* Reads an unsigned byte (0 to 255).
		* @returns {number}
		*/
		readByte(): number;
		/**
		* Writes an unsigned byte (0 to 255).
		* @param {number} v
		*/
		writeByte(v: number): void;
		/**
		* Reads a signed byte (-128 to 127).
		* @returns {number}
		*/
		readSignedByte(): number;
		/**
		* Writes a signed byte (-128 to 127).
		* @param {number} v
		*/
		writeSignedByte(v: number): void;
		/**
		* Reads a boolean (true or false).
		* @returns {boolean}
		*/
		readBoolean(): boolean;
		/**
		* Writes a boolean (true or false).
		* @param {boolean} v
		*/
		writeBoolean(v: boolean): void;
		/**
		* Reads a 16 bit (2 bytes) signed big-endian number.
		* @returns {number}
		*/
		readShort(): number;
		/**
		* Writes a 16 bit (2 bytes) signed big-endian number.
		* @param {number} v
		*/
		writeShort(v: number): void;
		/**
		* Reads a 16 bit (2 bytes) signed little-endian number.
		* @returns {number}
		*/
		readShortLE(): number;
		/**
		* Writes a 16 bit (2 bytes) signed big-endian number.
		* @param {number} v
		*/
		writeShortLE(v: number): void;
		/**
		* Reads a 16 bit (2 bytes) unsigned big-endian number.
		* @returns {number}
		*/
		readUnsignedShort(): number;
		/**
		* Writes a 16 bit (2 bytes) unsigned big-endian number.
		* @param {number} v
		*/
		writeUnsignedShort(v: number): void;
		/**
		* Reads a 16 bit (2 bytes) unsigned little-endian number.
		* @returns {number}
		*/
		readUnsignedShortLE(): number;
		/**
		* Writes a 16 bit (2 bytes) unsigned little-endian number.
		* @param {number} v
		*/
		writeUnsignedShortLE(v: number): void;
		/**
		* Reads a 24 bit (3 bytes) signed big-endian number.
		* @returns {number}
		*/
		readTriad(): number;
		/**
		* Writes a 24 bit (3 bytes) signed big-endian number.
		* @param {number} v
		*/
		writeTriad(v: number): void;
		/**
		* Reads a 24 bit (3 bytes) little-endian number.
		* @returns {number}
		*/
		readTriadLE(): number;
		/**
		* Writes a 24 bit (3 bytes) signed little-endian number.
		* @param {number} v
		*/
		writeTriadLE(v: number): void;
		/**
		* Reads a 24 bit (3 bytes) unsigned big-endian number.
		* @returns {number}
		*/
		readUnsignedTriad(): number;
		/**
		* Writes a 24 bit (3 bytes) unsigned big-endian number.
		* @param {number} v
		*/
		writeUnsignedTriad(v: number): void;
		/**
		* Reads a 24 bit (3 bytes) unsigned little-endian number.
		* @returns {number}
		*/
		readUnsignedTriadLE(): number;
		/**
		* Writes a 24 bit (3 bytes) unsigned little-endian number.
		* @param {number} v
		*/
		writeUnsignedTriadLE(v: number): void;
		/**
		* Reads a 32 bit (4 bytes) big-endian signed number.
		* @returns {number}
		*/
		readInt(): number;
		/**
		* Writes a 32 bit (4 bytes) big-endian signed number.
		* @param {number} v
		*/
		writeInt(v: number): void;
		/**
		* Reads a 32 bit (4 bytes) signed number.
		* @returns {number}
		*/
		readIntLE(): number;
		/**
		* Writes a 32 bit (4 bytes) little-endian signed number.
		* @param {number} v
		*/
		writeIntLE(v: number): void;
		/**
		* Reads a 32 bit (4 bytes) big-endian unsigned number.
		* @returns {number}
		*/
		readUnsignedInt(): number;
		/**
		* Writes a 32 bit (4 bytes) big-endian unsigned number.
		* @param {number} v
		*/
		writeUnsignedInt(v: number): void;
		/**
		* Reads a 32 bit (4 bytes) little-endian unsigned number.
		* @returns {number}
		*/
		readUnsignedIntLE(): number;
		/**
		* Writes a 32 bit (4 bytes) little-endian unsigned number.
		* @param {number} v
		*/
		writeUnsignedIntLE(v: number): void;
		/**
		* Returns a 32 bit (4 bytes) big-endian flating point number.
		* @returns {number}
		*/
		readFloat(): number;
		/**
		* Writes a 32 bit (4 bytes) big-endian floating point number.
		* @param {number} v
		*/
		writeFloat(v: number): void;
		/**
		* Returns a 32 bit (4 bytes) big-endian flating point number.
		* @returns {number}
		*/
		readFloatLE(): number;
		/**
		* Writes a 32 bit (4 bytes) little-endian floating point number.
		* @param {number} v
		*/
		writeFloatLE(v: number): void;
		/**
		* Returns a 64 bit (8 bytes) big-endian flating point number.
		* @returns {number}
		*/
		readDouble(): number;
		/**
		* Writes a 64 bit (8 bytes) big-endian floating point number.
		* @param {number} v
		*/
		writeDouble(v: number): void;
		/**
		* Returns a 64 bit (8 bytes) little-endian flating point number.
		* @returns {number}
		*/
		readDoubleLE(): number;
		/**
		* Writes a 64 bit (8 bytes) little-endian floating point number.
		* @param {number} v
		*/
		writeDoubleLE(v: number): void;
		/**
		* Returns a 64 bit (8 bytes) signed big-endian number.
		* @returns {bigint}
		*/
		readLong(): bigint;
		/**
		* Writes a 64 bit (8 bytes) signed big-endian number.
		* @param {bigint} v
		*/
		writeLong(v: bigint): void;
		/**
		* Returns a 64 bit (8 bytes) signed little-endian number.
		* @returns {bigint}
		*/
		readLongLE(): bigint;
		/**
		* Writes a 64 bit (8 bytes) signed big-endian number.
		* @param {bigint} v
		*/
		writeLongLE(v: bigint): void;
		/**
		* Returns a 64 bit (8 bytes) unsigned big-endian number.
		* @returns {bigint}
		*/
		readUnsignedLong(): bigint;
		/**
		* Writes a 64 bit (8 bytes) unsigned big-endian number.
		* @param {bigint} v
		*/
		writeUnsignedLong(v: bigint): void;
		/**
		* Returns a 64 bit (8 bytes) unsigned little-endian number.
		* @returns {bigint}
		*/
		readUnsignedLongLE(): bigint;
		/**
		* Writes a 64 bit (8 bytes) unsigned big-endian number.
		* @param {bigint} v
		*/
		writeUnsignedLongLE(v: bigint): void;
		/**
		* Reads a 32 bit (4 bytes) zigzag-encoded number.
		* @returns {number}
		*/
		readVarInt(): number;
		/**
		* Writes a 32 bit (4 bytes) zigzag-encoded number.
		* @param {number} v
		*/
		writeVarInt(v: number): void;
		/**
		* Reads a 32 bit unsigned number.
		* @returns {number}
		*/
		readUnsignedVarInt(): number;
		/**
		* Writes a 32 bit unsigned number with variable-length.
		* @param {number} v
		*/
		writeUnsignedVarInt(v: number): void;
		/**
		* Reads a 64 bit zigzag-encoded variable-length number.
		* @returns {bigint}
		*/
		readVarLong(): bigint;
		/**
		* Writes a 64 bit unsigned zigzag-encoded number.
		* @param {bigint} v
		*/
		writeVarLong(v: bigint): void;
		/**
		* Reads a 64 bit unsigned variable-length number.
		* @returns {bigint}
		*/
		readUnsignedVarLong(): bigint;
		/**
		* Writes a 64 bit unsigned variable-length number.
		* @param {bigint} v
		*/
		writeUnsignedVarLong(v: bigint): void;
		/**
		* Increases the write offset by the given length.
		* @param {number} length
		*/
		private addOffset;
		/**
		* Returns whatever or not the read offset is at end of line.
		* @returns {number}
		*/
		feof(): boolean;
		/**
		* Reads the remaining bytes and returns the buffer slice.
		* @returns {Buffer}
		*/
		readRemaining(): Buffer;
		/**
		* Skips len bytes on the buffer.
		* @param {number} len
		*/
		skip(len: number): void;
		/**
		* Returns the encoded buffer.
		* @returns {Buffer}
		*/
		getBuffer(): Buffer;
		/**
		* Retuns the read index.
		* @returns {number}
		*/
		getReadIndex(): number;
		/**
		* Returns the write index.
		* @returns {number}
		*/
		getWriteIndex(): number;
		/**
		* Do read assertions, check if the read buffer is null.
		* @param {number} byteLength
		*/
		private doReadAssertions;
		/**
		* Do read assertions, check if the read buffer is null.
		* @param {number\|bigint} num
		* @param {number\|bigint} minVal
		* @param {number\|bigint} maxVal
		*/
		private doWriteAssertions;
		}

+630

dist/cjs/BinaryStream.js

		"use strict";
		Object.defineProperty(exports, "__esModule", { value: true });
		const assert_1 = require("assert");
		class BinaryStream {
		/**
		* Creates a new BinaryStream instance.
		* @param {Buffer\|null\|undefined} buffer - The array or Buffer containing binary data.
		* @param {number} offset - The initial pointer position.
		*/
		constructor(buffer, offset = 0) {
		this.binary = [];
		this.buffer = null;
		this.writeIndex = 0;
		this.buffer = buffer ?? null; // Keep this instance for reading
		this.readIndex = offset;
		}
		/**
		* Reads a slice of buffer by the given length.
		* @param {number} len
		*/
		read(len) {
		this.doReadAssertions(len);
		return this.buffer.slice(this.readIndex, (this.readIndex += len));
		}
		write(buf) {
		this.binary.push(...buf);
		this.writeIndex += buf.byteLength;
		}
		/**
		* Reads an unsigned byte (0 to 255).
		* @returns {number}
		*/
		readByte() {
		this.doReadAssertions(1);
		return this.buffer.readUInt8(this.readIndex++);
		}
		/**
		* Writes an unsigned byte (0 to 255).
		* @param {number} v
		*/
		writeByte(v) {
		v &= 0xff;
		this.binary[this.writeIndex++] = v;
		}
		/**
		* Reads a signed byte (-128 to 127).
		* @returns {number}
		*/
		readSignedByte() {
		this.doReadAssertions(1);
		return this.buffer.readInt8(this.readIndex++);
		}
		/**
		* Writes a signed byte (-128 to 127).
		* @param {number} v
		*/
		writeSignedByte(v) {
		if (v < 0)
		v = 0xff + v + 1;
		this.binary[this.writeIndex++] = v & 0xff;
		}
		/**
		* Reads a boolean (true or false).
		* @returns {boolean}
		*/
		readBoolean() {
		this.doReadAssertions(1);
		return !!this.readByte();
		}
		/**
		* Writes a boolean (true or false).
		* @param {boolean} v
		*/
		writeBoolean(v) {
		this.writeByte(+v);
		}
		/**
		* Reads a 16 bit (2 bytes) signed big-endian number.
		* @returns {number}
		*/
		readShort() {
		this.doReadAssertions(2);
		return this.buffer.readInt16BE(this.addOffset(2));
		}
		/**
		* Writes a 16 bit (2 bytes) signed big-endian number.
		* @param {number} v
		*/
		writeShort(v) {
		this.doWriteAssertions(v, -32768, 32767);
		this.writeByte(v >> 8);
		this.writeByte(v);
		}
		/**
		* Reads a 16 bit (2 bytes) signed little-endian number.
		* @returns {number}
		*/
		readShortLE() {
		this.doReadAssertions(2);
		return this.buffer.readInt16LE(this.addOffset(2));
		}
		/**
		* Writes a 16 bit (2 bytes) signed big-endian number.
		* @param {number} v
		*/
		writeShortLE(v) {
		this.doWriteAssertions(v, -32768, 32767);
		this.writeByte(v);
		this.writeByte(v >> 8);
		}
		/**
		* Reads a 16 bit (2 bytes) unsigned big-endian number.
		* @returns {number}
		*/
		readUnsignedShort() {
		this.doReadAssertions(2);
		return this.buffer.readUInt16BE(this.addOffset(2));
		}
		/**
		* Writes a 16 bit (2 bytes) unsigned big-endian number.
		* @param {number} v
		*/
		writeUnsignedShort(v) {
		this.doWriteAssertions(v, 0, 65535);
		this.writeByte(v >>> 8);
		this.writeByte(v);
		}
		/**
		* Reads a 16 bit (2 bytes) unsigned little-endian number.
		* @returns {number}
		*/
		readUnsignedShortLE() {
		this.doReadAssertions(2);
		return this.buffer.readUInt16LE(this.addOffset(2));
		}
		/**
		* Writes a 16 bit (2 bytes) unsigned little-endian number.
		* @param {number} v
		*/
		writeUnsignedShortLE(v) {
		this.doWriteAssertions(v, 0, 65535);
		this.writeByte(v);
		this.writeByte(v >>> 8);
		}
		/**
		* Reads a 24 bit (3 bytes) signed big-endian number.
		* @returns {number}
		*/
		readTriad() {
		this.doReadAssertions(3);
		return this.buffer.readIntBE(this.addOffset(3), 3);
		}
		/**
		* Writes a 24 bit (3 bytes) signed big-endian number.
		* @param {number} v
		*/
		writeTriad(v) {
		this.doWriteAssertions(v, -8388608, 8388607);
		this.writeByte((v & 0xff0000) >> 16); // msb
		this.writeByte((v & 0x00ff00) >> 8); // mib
		this.writeByte(v & 0x0000ff); // lsb
		}
		/**
		* Reads a 24 bit (3 bytes) little-endian number.
		* @returns {number}
		*/
		readTriadLE() {
		this.doReadAssertions(3);
		return this.buffer.readIntLE(this.addOffset(3), 3);
		}
		/**
		* Writes a 24 bit (3 bytes) signed little-endian number.
		* @param {number} v
		*/
		writeTriadLE(v) {
		this.doWriteAssertions(v, -8388608, 8388607);
		this.writeByte(v & 0x0000ff);
		this.writeByte((v & 0x00ff00) >> 8);
		this.writeByte((v & 0xff0000) >> 16);
		}
		/**
		* Reads a 24 bit (3 bytes) unsigned big-endian number.
		* @returns {number}
		*/
		readUnsignedTriad() {
		this.doReadAssertions(3);
		return this.buffer.readUIntBE(this.addOffset(3), 3);
		}
		/**
		* Writes a 24 bit (3 bytes) unsigned big-endian number.
		* @param {number} v
		*/
		writeUnsignedTriad(v) {
		this.doWriteAssertions(v, 0, 16777215);
		this.writeByte((v & 0xff0000) >>> 16); // msb
		this.writeByte((v & 0x00ff00) >>> 8); // mib
		this.writeByte(v & 0x0000ff); // lsb
		}
		/**
		* Reads a 24 bit (3 bytes) unsigned little-endian number.
		* @returns {number}
		*/
		readUnsignedTriadLE() {
		this.doReadAssertions(3);
		return this.buffer.readUIntLE(this.addOffset(3), 3);
		}
		/**
		* Writes a 24 bit (3 bytes) unsigned little-endian number.
		* @param {number} v
		*/
		writeUnsignedTriadLE(v) {
		this.doWriteAssertions(v, 0, 16777215);
		this.writeByte(v & 0x0000ff);
		this.writeByte((v & 0x00ff00) >>> 8);
		this.writeByte((v & 0xff0000) >>> 16);
		}
		/**
		* Reads a 32 bit (4 bytes) big-endian signed number.
		* @returns {number}
		*/
		readInt() {
		this.doReadAssertions(4);
		return this.buffer.readInt32BE(this.addOffset(4));
		}
		/**
		* Writes a 32 bit (4 bytes) big-endian signed number.
		* @param {number} v
		*/
		writeInt(v) {
		if (v < 0)
		v = v & (0xffffffff + v + 1);
		this.doWriteAssertions(v, -2147483648, 2147483647);
		this.writeByte(v >> 24);
		this.writeByte(v >> 16);
		this.writeByte(v >> 8);
		this.writeByte(v);
		}
		/**
		* Reads a 32 bit (4 bytes) signed number.
		* @returns {number}
		*/
		readIntLE() {
		this.doReadAssertions(4);
		return this.buffer.readIntLE(this.addOffset(4), 4);
		}
		/**
		* Writes a 32 bit (4 bytes) little-endian signed number.
		* @param {number} v
		*/
		writeIntLE(v) {
		if (v < 0)
		v = v & (0xffffffff + v + 1);
		this.doWriteAssertions(v, -2147483648, 2147483647);
		this.writeByte(v);
		this.writeByte(v >> 8);
		this.writeByte(v >> 16);
		this.writeByte(v >> 24);
		}
		/**
		* Reads a 32 bit (4 bytes) big-endian unsigned number.
		* @returns {number}
		*/
		readUnsignedInt() {
		this.doReadAssertions(4);
		return this.buffer.readUInt32BE(this.addOffset(4));
		}
		/**
		* Writes a 32 bit (4 bytes) big-endian unsigned number.
		* @param {number} v
		*/
		writeUnsignedInt(v) {
		this.doWriteAssertions(v, 0, 4294967295);
		this.writeByte(v >>> 24);
		this.writeByte(v >>> 16);
		this.writeByte(v >>> 8);
		this.writeByte(v);
		}
		/**
		* Reads a 32 bit (4 bytes) little-endian unsigned number.
		* @returns {number}
		*/
		readUnsignedIntLE() {
		this.doReadAssertions(4);
		return this.buffer.readUInt32LE(this.addOffset(4));
		}
		/**
		* Writes a 32 bit (4 bytes) little-endian unsigned number.
		* @param {number} v
		*/
		writeUnsignedIntLE(v) {
		this.doWriteAssertions(v, 0, 4294967295);
		this.writeByte(v);
		this.writeByte(v >>> 8);
		this.writeByte(v >>> 16);
		this.writeByte(v >>> 24);
		}
		/**
		* Returns a 32 bit (4 bytes) big-endian flating point number.
		* @returns {number}
		*/
		readFloat() {
		this.doReadAssertions(4);
		return this.buffer.readFloatBE(this.addOffset(4));
		}
		/**
		* Writes a 32 bit (4 bytes) big-endian floating point number.
		* @param {number} v
		*/
		writeFloat(v) {
		this.doWriteAssertions(v, -3.4028234663852886e38, +3.4028234663852886e38);
		this.write(new Uint8Array(new Float32Array([v]).buffer).reverse());
		}
		/**
		* Returns a 32 bit (4 bytes) big-endian flating point number.
		* @returns {number}
		*/
		readFloatLE() {
		this.doReadAssertions(4);
		return this.buffer.readFloatLE(this.addOffset(4));
		}
		/**
		* Writes a 32 bit (4 bytes) little-endian floating point number.
		* @param {number} v
		*/
		writeFloatLE(v) {
		this.doWriteAssertions(v, -3.4028234663852886e38, +3.4028234663852886e38);
		this.write(new Uint8Array(new Float32Array([v]).buffer));
		}
		/**
		* Returns a 64 bit (8 bytes) big-endian flating point number.
		* @returns {number}
		*/
		readDouble() {
		this.doReadAssertions(8);
		return this.buffer.readDoubleBE(this.addOffset(8));
		}
		/**
		* Writes a 64 bit (8 bytes) big-endian floating point number.
		* @param {number} v
		*/
		writeDouble(v) {
		this.doWriteAssertions(v, -1.7976931348623157e308, +1.7976931348623157e308);
		this.write(new Uint8Array(new Float64Array([v]).buffer).reverse());
		}
		/**
		* Returns a 64 bit (8 bytes) little-endian flating point number.
		* @returns {number}
		*/
		readDoubleLE() {
		this.doReadAssertions(8);
		return this.buffer.readDoubleLE(this.addOffset(8));
		}
		/**
		* Writes a 64 bit (8 bytes) little-endian floating point number.
		* @param {number} v
		*/
		writeDoubleLE(v) {
		this.doWriteAssertions(v, -1.7976931348623157e308, +1.7976931348623157e308);
		this.write(new Uint8Array(new Float64Array([v]).buffer));
		}
		/**
		* Returns a 64 bit (8 bytes) signed big-endian number.
		* @returns {bigint}
		*/
		readLong() {
		this.doReadAssertions(8);
		return this.buffer.readBigInt64BE(this.addOffset(8));
		}
		/**
		* Writes a 64 bit (8 bytes) signed big-endian number.
		* @param {bigint} v
		*/
		writeLong(v) {
		const lo = Number(v & BigInt(0xffffffff));
		this.binary[this.writeIndex + 7] = lo;
		this.binary[this.writeIndex + 6] = lo >> 8;
		this.binary[this.writeIndex + 5] = lo >> 16;
		this.binary[this.writeIndex + 4] = lo >> 24;
		const hi = Number((v >> BigInt(32)) & BigInt(0xffffffff));
		this.binary[this.writeIndex + 3] = hi;
		this.binary[this.writeIndex + 2] = hi >> 8;
		this.binary[this.writeIndex + 1] = hi >> 16;
		this.binary[this.writeIndex] = hi >> 24;
		this.writeIndex += 8;
		}
		/**
		* Returns a 64 bit (8 bytes) signed little-endian number.
		* @returns {bigint}
		*/
		readLongLE() {
		this.doReadAssertions(8);
		return this.buffer.readBigInt64LE(this.addOffset(8));
		}
		/**
		* Writes a 64 bit (8 bytes) signed big-endian number.
		* @param {bigint} v
		*/
		writeLongLE(v) {
		const lo = Number(v & BigInt(0xffffffff));
		this.binary[this.writeIndex++] = lo;
		this.binary[this.writeIndex++] = lo >> 8;
		this.binary[this.writeIndex++] = lo >> 16;
		this.binary[this.writeIndex++] = lo >> 24;
		const hi = Number((v >> BigInt(32)) & BigInt(0xffffffff));
		this.binary[this.writeIndex++] = hi;
		this.binary[this.writeIndex++] = hi >> 8;
		this.binary[this.writeIndex++] = hi >> 16;
		this.binary[this.writeIndex++] = hi >> 24;
		}
		/**
		* Returns a 64 bit (8 bytes) unsigned big-endian number.
		* @returns {bigint}
		*/
		readUnsignedLong() {
		this.doReadAssertions(8);
		return this.buffer.readBigUInt64BE(this.addOffset(8));
		}
		/**
		* Writes a 64 bit (8 bytes) unsigned big-endian number.
		* @param {bigint} v
		*/
		writeUnsignedLong(v) {
		const lo = Number(v & BigInt(0xffffffff));
		this.binary[this.writeIndex + 7] = lo;
		this.binary[this.writeIndex + 6] = lo >> 8;
		this.binary[this.writeIndex + 5] = lo >> 16;
		this.binary[this.writeIndex + 4] = lo >> 24;
		const hi = Number((v >> BigInt(32)) & BigInt(0xffffffff));
		this.binary[this.writeIndex + 3] = hi;
		this.binary[this.writeIndex + 2] = hi >> 8;
		this.binary[this.writeIndex + 1] = hi >> 16;
		this.binary[this.writeIndex] = hi >> 24;
		this.writeIndex += 8;
		}
		/**
		* Returns a 64 bit (8 bytes) unsigned little-endian number.
		* @returns {bigint}
		*/
		readUnsignedLongLE() {
		this.doReadAssertions(8);
		return this.buffer.readBigUInt64LE(this.addOffset(8));
		}
		/**
		* Writes a 64 bit (8 bytes) unsigned big-endian number.
		* @param {bigint} v
		*/
		writeUnsignedLongLE(v) {
		const lo = Number(v & BigInt(0xffffffff));
		this.binary[this.writeIndex++] = lo;
		this.binary[this.writeIndex++] = lo >> 8;
		this.binary[this.writeIndex++] = lo >> 16;
		this.binary[this.writeIndex++] = lo >> 24;
		const hi = Number((v >> BigInt(32)) & BigInt(0xffffffff));
		this.binary[this.writeIndex++] = hi;
		this.binary[this.writeIndex++] = hi >> 8;
		this.binary[this.writeIndex++] = hi >> 16;
		this.binary[this.writeIndex++] = hi >> 24;
		}
		/**
		* Reads a 32 bit (4 bytes) zigzag-encoded number.
		* @returns {number}
		*/
		readVarInt() {
		const raw = this.readUnsignedVarInt();
		const temp = (((raw << 63) >> 63) ^ raw) >> 1;
		return temp ^ (raw & (1 << 63));
		}
		/**
		* Writes a 32 bit (4 bytes) zigzag-encoded number.
		* @param {number} v
		*/
		writeVarInt(v) {
		v = (v << 32) >> 32;
		return this.writeUnsignedVarInt((v << 1) ^ (v >> 31));
		}
		/**
		* Reads a 32 bit unsigned number.
		* @returns {number}
		*/
		readUnsignedVarInt() {
		(0, assert_1.default)(this.buffer != null, 'Reading on empty buffer!');
		let value = 0;
		for (let i = 0; i <= 28; i += 7) {
		if (typeof this.buffer[this.readIndex] === 'undefined') {
		throw new Error('No bytes left in buffer');
		}
		let b = this.readByte();
		value \|= (b & 0x7f) << i;
		if ((b & 0x80) === 0) {
		return value;
		}
		}
		throw new Error('VarInt did not terminate after 5 bytes!');
		}
		/**
		* Writes a 32 bit unsigned number with variable-length.
		* @param {number} v
		*/
		writeUnsignedVarInt(v) {
		while ((v & 0xffffff80) !== 0) {
		this.writeByte((v & 0x7f) \| 0x80);
		v >>>= 7;
		}
		this.writeByte(v & 0x7f);
		}
		/**
		* Reads a 64 bit zigzag-encoded variable-length number.
		* @returns {bigint}
		*/
		readVarLong() {
		const raw = this.readUnsignedVarLong();
		return raw >> 1n;
		}
		/**
		* Writes a 64 bit unsigned zigzag-encoded number.
		* @param {bigint} v
		*/
		writeVarLong(v) {
		return this.writeUnsignedVarLong((v << 1n) ^ (v >> 63n));
		}
		/**
		* Reads a 64 bit unsigned variable-length number.
		* @returns {bigint}
		*/
		readUnsignedVarLong() {
		let value = 0n;
		for (let i = 0; i <= 63; i += 7) {
		if (this.feof()) {
		throw new Error('No bytes left in buffer');
		}
		const b = this.readByte();
		value \|= (BigInt(b) & 0x7fn) << BigInt(i);
		if ((b & 0x80) === 0) {
		return value;
		}
		}
		throw new Error('VarLong did not terminate after 10 bytes!');
		}
		/**
		* Writes a 64 bit unsigned variable-length number.
		* @param {bigint} v
		*/
		writeUnsignedVarLong(v) {
		for (let i = 0; i < 10; ++i) {
		if (v >> 7n !== 0n) {
		this.writeByte(Number(v \| 0x80n));
		}
		else {
		this.writeByte(Number(v & 0x7fn));
		break;
		}
		v >>= 7n;
		}
		}
		/**
		* Increases the write offset by the given length.
		* @param {number} length
		*/
		addOffset(length) {
		return (this.readIndex += length) - length;
		}
		/**
		* Returns whatever or not the read offset is at end of line.
		* @returns {number}
		*/
		feof() {
		if (!this.buffer)
		throw new Error('Buffer is write only!');
		return typeof this.buffer[this.readIndex] === 'undefined';
		}
		/**
		* Reads the remaining bytes and returns the buffer slice.
		* @returns {Buffer}
		*/
		readRemaining() {
		if (!this.buffer)
		throw new Error('Buffer is write only!');
		const buf = this.buffer.slice(this.readIndex);
		this.readIndex = this.buffer.byteLength;
		return buf;
		}
		/**
		* Skips len bytes on the buffer.
		* @param {number} len
		*/
		skip(len) {
		(0, assert_1.default)(Number.isInteger(len), 'Cannot skip a float amount of bytes');
		this.readIndex += len;
		}
		/**
		* Returns the encoded buffer.
		* @returns {Buffer}
		*/
		getBuffer() {
		return this.buffer !== null ? this.buffer : Buffer.from(this.binary);
		}
		/**
		* Retuns the read index.
		* @returns {number}
		*/
		getReadIndex() {
		return this.readIndex;
		}
		/**
		* Returns the write index.
		* @returns {number}
		*/
		getWriteIndex() {
		return this.writeIndex;
		}
		/**
		* Do read assertions, check if the read buffer is null.
		* @param {number} byteLength
		*/
		doReadAssertions(byteLength) {
		(0, assert_1.default)(this.buffer !== null, 'Cannot read without buffer data!');
		(0, assert_1.default)(this.buffer.byteLength >= byteLength, 'Cannot read without buffer data!');
		}
		/**
		* Do read assertions, check if the read buffer is null.
		* @param {number\|bigint} num
		* @param {number\|bigint} minVal
		* @param {number\|bigint} maxVal
		*/
		doWriteAssertions(num, minVal, maxVal) {
		(0, assert_1.default)(num >= minVal && num <= maxVal, `Value out of bounds: value=${num}, min=${minVal}, max=${maxVal}`);
		}
		}
		exports.default = BinaryStream;
		//# sourceMappingURL=BinaryStream.js.map

+1

dist/cjs/BinaryStream.js.map

+627

dist/esm/BinaryStream.js

		import assert from 'assert';
		export default class BinaryStream {
		/**
		* Creates a new BinaryStream instance.
		* @param {Buffer\|null\|undefined} buffer - The array or Buffer containing binary data.
		* @param {number} offset - The initial pointer position.
		*/
		constructor(buffer, offset = 0) {
		this.binary = [];
		this.buffer = null;
		this.writeIndex = 0;
		this.buffer = buffer ?? null; // Keep this instance for reading
		this.readIndex = offset;
		}
		/**
		* Reads a slice of buffer by the given length.
		* @param {number} len
		*/
		read(len) {
		this.doReadAssertions(len);
		return this.buffer.slice(this.readIndex, (this.readIndex += len));
		}
		write(buf) {
		this.binary.push(...buf);
		this.writeIndex += buf.byteLength;
		}
		/**
		* Reads an unsigned byte (0 to 255).
		* @returns {number}
		*/
		readByte() {
		this.doReadAssertions(1);
		return this.buffer.readUInt8(this.readIndex++);
		}
		/**
		* Writes an unsigned byte (0 to 255).
		* @param {number} v
		*/
		writeByte(v) {
		v &= 0xff;
		this.binary[this.writeIndex++] = v;
		}
		/**
		* Reads a signed byte (-128 to 127).
		* @returns {number}
		*/
		readSignedByte() {
		this.doReadAssertions(1);
		return this.buffer.readInt8(this.readIndex++);
		}
		/**
		* Writes a signed byte (-128 to 127).
		* @param {number} v
		*/
		writeSignedByte(v) {
		if (v < 0)
		v = 0xff + v + 1;
		this.binary[this.writeIndex++] = v & 0xff;
		}
		/**
		* Reads a boolean (true or false).
		* @returns {boolean}
		*/
		readBoolean() {
		this.doReadAssertions(1);
		return !!this.readByte();
		}
		/**
		* Writes a boolean (true or false).
		* @param {boolean} v
		*/
		writeBoolean(v) {
		this.writeByte(+v);
		}
		/**
		* Reads a 16 bit (2 bytes) signed big-endian number.
		* @returns {number}
		*/
		readShort() {
		this.doReadAssertions(2);
		return this.buffer.readInt16BE(this.addOffset(2));
		}
		/**
		* Writes a 16 bit (2 bytes) signed big-endian number.
		* @param {number} v
		*/
		writeShort(v) {
		this.doWriteAssertions(v, -32768, 32767);
		this.writeByte(v >> 8);
		this.writeByte(v);
		}
		/**
		* Reads a 16 bit (2 bytes) signed little-endian number.
		* @returns {number}
		*/
		readShortLE() {
		this.doReadAssertions(2);
		return this.buffer.readInt16LE(this.addOffset(2));
		}
		/**
		* Writes a 16 bit (2 bytes) signed big-endian number.
		* @param {number} v
		*/
		writeShortLE(v) {
		this.doWriteAssertions(v, -32768, 32767);
		this.writeByte(v);
		this.writeByte(v >> 8);
		}
		/**
		* Reads a 16 bit (2 bytes) unsigned big-endian number.
		* @returns {number}
		*/
		readUnsignedShort() {
		this.doReadAssertions(2);
		return this.buffer.readUInt16BE(this.addOffset(2));
		}
		/**
		* Writes a 16 bit (2 bytes) unsigned big-endian number.
		* @param {number} v
		*/
		writeUnsignedShort(v) {
		this.doWriteAssertions(v, 0, 65535);
		this.writeByte(v >>> 8);
		this.writeByte(v);
		}
		/**
		* Reads a 16 bit (2 bytes) unsigned little-endian number.
		* @returns {number}
		*/
		readUnsignedShortLE() {
		this.doReadAssertions(2);
		return this.buffer.readUInt16LE(this.addOffset(2));
		}
		/**
		* Writes a 16 bit (2 bytes) unsigned little-endian number.
		* @param {number} v
		*/
		writeUnsignedShortLE(v) {
		this.doWriteAssertions(v, 0, 65535);
		this.writeByte(v);
		this.writeByte(v >>> 8);
		}
		/**
		* Reads a 24 bit (3 bytes) signed big-endian number.
		* @returns {number}
		*/
		readTriad() {
		this.doReadAssertions(3);
		return this.buffer.readIntBE(this.addOffset(3), 3);
		}
		/**
		* Writes a 24 bit (3 bytes) signed big-endian number.
		* @param {number} v
		*/
		writeTriad(v) {
		this.doWriteAssertions(v, -8388608, 8388607);
		this.writeByte((v & 0xff0000) >> 16); // msb
		this.writeByte((v & 0x00ff00) >> 8); // mib
		this.writeByte(v & 0x0000ff); // lsb
		}
		/**
		* Reads a 24 bit (3 bytes) little-endian number.
		* @returns {number}
		*/
		readTriadLE() {
		this.doReadAssertions(3);
		return this.buffer.readIntLE(this.addOffset(3), 3);
		}
		/**
		* Writes a 24 bit (3 bytes) signed little-endian number.
		* @param {number} v
		*/
		writeTriadLE(v) {
		this.doWriteAssertions(v, -8388608, 8388607);
		this.writeByte(v & 0x0000ff);
		this.writeByte((v & 0x00ff00) >> 8);
		this.writeByte((v & 0xff0000) >> 16);
		}
		/**
		* Reads a 24 bit (3 bytes) unsigned big-endian number.
		* @returns {number}
		*/
		readUnsignedTriad() {
		this.doReadAssertions(3);
		return this.buffer.readUIntBE(this.addOffset(3), 3);
		}
		/**
		* Writes a 24 bit (3 bytes) unsigned big-endian number.
		* @param {number} v
		*/
		writeUnsignedTriad(v) {
		this.doWriteAssertions(v, 0, 16777215);
		this.writeByte((v & 0xff0000) >>> 16); // msb
		this.writeByte((v & 0x00ff00) >>> 8); // mib
		this.writeByte(v & 0x0000ff); // lsb
		}
		/**
		* Reads a 24 bit (3 bytes) unsigned little-endian number.
		* @returns {number}
		*/
		readUnsignedTriadLE() {
		this.doReadAssertions(3);
		return this.buffer.readUIntLE(this.addOffset(3), 3);
		}
		/**
		* Writes a 24 bit (3 bytes) unsigned little-endian number.
		* @param {number} v
		*/
		writeUnsignedTriadLE(v) {
		this.doWriteAssertions(v, 0, 16777215);
		this.writeByte(v & 0x0000ff);
		this.writeByte((v & 0x00ff00) >>> 8);
		this.writeByte((v & 0xff0000) >>> 16);
		}
		/**
		* Reads a 32 bit (4 bytes) big-endian signed number.
		* @returns {number}
		*/
		readInt() {
		this.doReadAssertions(4);
		return this.buffer.readInt32BE(this.addOffset(4));
		}
		/**
		* Writes a 32 bit (4 bytes) big-endian signed number.
		* @param {number} v
		*/
		writeInt(v) {
		if (v < 0)
		v = v & (0xffffffff + v + 1);
		this.doWriteAssertions(v, -2147483648, 2147483647);
		this.writeByte(v >> 24);
		this.writeByte(v >> 16);
		this.writeByte(v >> 8);
		this.writeByte(v);
		}
		/**
		* Reads a 32 bit (4 bytes) signed number.
		* @returns {number}
		*/
		readIntLE() {
		this.doReadAssertions(4);
		return this.buffer.readIntLE(this.addOffset(4), 4);
		}
		/**
		* Writes a 32 bit (4 bytes) little-endian signed number.
		* @param {number} v
		*/
		writeIntLE(v) {
		if (v < 0)
		v = v & (0xffffffff + v + 1);
		this.doWriteAssertions(v, -2147483648, 2147483647);
		this.writeByte(v);
		this.writeByte(v >> 8);
		this.writeByte(v >> 16);
		this.writeByte(v >> 24);
		}
		/**
		* Reads a 32 bit (4 bytes) big-endian unsigned number.
		* @returns {number}
		*/
		readUnsignedInt() {
		this.doReadAssertions(4);
		return this.buffer.readUInt32BE(this.addOffset(4));
		}
		/**
		* Writes a 32 bit (4 bytes) big-endian unsigned number.
		* @param {number} v
		*/
		writeUnsignedInt(v) {
		this.doWriteAssertions(v, 0, 4294967295);
		this.writeByte(v >>> 24);
		this.writeByte(v >>> 16);
		this.writeByte(v >>> 8);
		this.writeByte(v);
		}
		/**
		* Reads a 32 bit (4 bytes) little-endian unsigned number.
		* @returns {number}
		*/
		readUnsignedIntLE() {
		this.doReadAssertions(4);
		return this.buffer.readUInt32LE(this.addOffset(4));
		}
		/**
		* Writes a 32 bit (4 bytes) little-endian unsigned number.
		* @param {number} v
		*/
		writeUnsignedIntLE(v) {
		this.doWriteAssertions(v, 0, 4294967295);
		this.writeByte(v);
		this.writeByte(v >>> 8);
		this.writeByte(v >>> 16);
		this.writeByte(v >>> 24);
		}
		/**
		* Returns a 32 bit (4 bytes) big-endian flating point number.
		* @returns {number}
		*/
		readFloat() {
		this.doReadAssertions(4);
		return this.buffer.readFloatBE(this.addOffset(4));
		}
		/**
		* Writes a 32 bit (4 bytes) big-endian floating point number.
		* @param {number} v
		*/
		writeFloat(v) {
		this.doWriteAssertions(v, -3.4028234663852886e38, +3.4028234663852886e38);
		this.write(new Uint8Array(new Float32Array([v]).buffer).reverse());
		}
		/**
		* Returns a 32 bit (4 bytes) big-endian flating point number.
		* @returns {number}
		*/
		readFloatLE() {
		this.doReadAssertions(4);
		return this.buffer.readFloatLE(this.addOffset(4));
		}
		/**
		* Writes a 32 bit (4 bytes) little-endian floating point number.
		* @param {number} v
		*/
		writeFloatLE(v) {
		this.doWriteAssertions(v, -3.4028234663852886e38, +3.4028234663852886e38);
		this.write(new Uint8Array(new Float32Array([v]).buffer));
		}
		/**
		* Returns a 64 bit (8 bytes) big-endian flating point number.
		* @returns {number}
		*/
		readDouble() {
		this.doReadAssertions(8);
		return this.buffer.readDoubleBE(this.addOffset(8));
		}
		/**
		* Writes a 64 bit (8 bytes) big-endian floating point number.
		* @param {number} v
		*/
		writeDouble(v) {
		this.doWriteAssertions(v, -1.7976931348623157e308, +1.7976931348623157e308);
		this.write(new Uint8Array(new Float64Array([v]).buffer).reverse());
		}
		/**
		* Returns a 64 bit (8 bytes) little-endian flating point number.
		* @returns {number}
		*/
		readDoubleLE() {
		this.doReadAssertions(8);
		return this.buffer.readDoubleLE(this.addOffset(8));
		}
		/**
		* Writes a 64 bit (8 bytes) little-endian floating point number.
		* @param {number} v
		*/
		writeDoubleLE(v) {
		this.doWriteAssertions(v, -1.7976931348623157e308, +1.7976931348623157e308);
		this.write(new Uint8Array(new Float64Array([v]).buffer));
		}
		/**
		* Returns a 64 bit (8 bytes) signed big-endian number.
		* @returns {bigint}
		*/
		readLong() {
		this.doReadAssertions(8);
		return this.buffer.readBigInt64BE(this.addOffset(8));
		}
		/**
		* Writes a 64 bit (8 bytes) signed big-endian number.
		* @param {bigint} v
		*/
		writeLong(v) {
		const lo = Number(v & BigInt(0xffffffff));
		this.binary[this.writeIndex + 7] = lo;
		this.binary[this.writeIndex + 6] = lo >> 8;
		this.binary[this.writeIndex + 5] = lo >> 16;
		this.binary[this.writeIndex + 4] = lo >> 24;
		const hi = Number((v >> BigInt(32)) & BigInt(0xffffffff));
		this.binary[this.writeIndex + 3] = hi;
		this.binary[this.writeIndex + 2] = hi >> 8;
		this.binary[this.writeIndex + 1] = hi >> 16;
		this.binary[this.writeIndex] = hi >> 24;
		this.writeIndex += 8;
		}
		/**
		* Returns a 64 bit (8 bytes) signed little-endian number.
		* @returns {bigint}
		*/
		readLongLE() {
		this.doReadAssertions(8);
		return this.buffer.readBigInt64LE(this.addOffset(8));
		}
		/**
		* Writes a 64 bit (8 bytes) signed big-endian number.
		* @param {bigint} v
		*/
		writeLongLE(v) {
		const lo = Number(v & BigInt(0xffffffff));
		this.binary[this.writeIndex++] = lo;
		this.binary[this.writeIndex++] = lo >> 8;
		this.binary[this.writeIndex++] = lo >> 16;
		this.binary[this.writeIndex++] = lo >> 24;
		const hi = Number((v >> BigInt(32)) & BigInt(0xffffffff));
		this.binary[this.writeIndex++] = hi;
		this.binary[this.writeIndex++] = hi >> 8;
		this.binary[this.writeIndex++] = hi >> 16;
		this.binary[this.writeIndex++] = hi >> 24;
		}
		/**
		* Returns a 64 bit (8 bytes) unsigned big-endian number.
		* @returns {bigint}
		*/
		readUnsignedLong() {
		this.doReadAssertions(8);
		return this.buffer.readBigUInt64BE(this.addOffset(8));
		}
		/**
		* Writes a 64 bit (8 bytes) unsigned big-endian number.
		* @param {bigint} v
		*/
		writeUnsignedLong(v) {
		const lo = Number(v & BigInt(0xffffffff));
		this.binary[this.writeIndex + 7] = lo;
		this.binary[this.writeIndex + 6] = lo >> 8;
		this.binary[this.writeIndex + 5] = lo >> 16;
		this.binary[this.writeIndex + 4] = lo >> 24;
		const hi = Number((v >> BigInt(32)) & BigInt(0xffffffff));
		this.binary[this.writeIndex + 3] = hi;
		this.binary[this.writeIndex + 2] = hi >> 8;
		this.binary[this.writeIndex + 1] = hi >> 16;
		this.binary[this.writeIndex] = hi >> 24;
		this.writeIndex += 8;
		}
		/**
		* Returns a 64 bit (8 bytes) unsigned little-endian number.
		* @returns {bigint}
		*/
		readUnsignedLongLE() {
		this.doReadAssertions(8);
		return this.buffer.readBigUInt64LE(this.addOffset(8));
		}
		/**
		* Writes a 64 bit (8 bytes) unsigned big-endian number.
		* @param {bigint} v
		*/
		writeUnsignedLongLE(v) {
		const lo = Number(v & BigInt(0xffffffff));
		this.binary[this.writeIndex++] = lo;
		this.binary[this.writeIndex++] = lo >> 8;
		this.binary[this.writeIndex++] = lo >> 16;
		this.binary[this.writeIndex++] = lo >> 24;
		const hi = Number((v >> BigInt(32)) & BigInt(0xffffffff));
		this.binary[this.writeIndex++] = hi;
		this.binary[this.writeIndex++] = hi >> 8;
		this.binary[this.writeIndex++] = hi >> 16;
		this.binary[this.writeIndex++] = hi >> 24;
		}
		/**
		* Reads a 32 bit (4 bytes) zigzag-encoded number.
		* @returns {number}
		*/
		readVarInt() {
		const raw = this.readUnsignedVarInt();
		const temp = (((raw << 63) >> 63) ^ raw) >> 1;
		return temp ^ (raw & (1 << 63));
		}
		/**
		* Writes a 32 bit (4 bytes) zigzag-encoded number.
		* @param {number} v
		*/
		writeVarInt(v) {
		v = (v << 32) >> 32;
		return this.writeUnsignedVarInt((v << 1) ^ (v >> 31));
		}
		/**
		* Reads a 32 bit unsigned number.
		* @returns {number}
		*/
		readUnsignedVarInt() {
		assert(this.buffer != null, 'Reading on empty buffer!');
		let value = 0;
		for (let i = 0; i <= 28; i += 7) {
		if (typeof this.buffer[this.readIndex] === 'undefined') {
		throw new Error('No bytes left in buffer');
		}
		let b = this.readByte();
		value \|= (b & 0x7f) << i;
		if ((b & 0x80) === 0) {
		return value;
		}
		}
		throw new Error('VarInt did not terminate after 5 bytes!');
		}
		/**
		* Writes a 32 bit unsigned number with variable-length.
		* @param {number} v
		*/
		writeUnsignedVarInt(v) {
		while ((v & 0xffffff80) !== 0) {
		this.writeByte((v & 0x7f) \| 0x80);
		v >>>= 7;
		}
		this.writeByte(v & 0x7f);
		}
		/**
		* Reads a 64 bit zigzag-encoded variable-length number.
		* @returns {bigint}
		*/
		readVarLong() {
		const raw = this.readUnsignedVarLong();
		return raw >> 1n;
		}
		/**
		* Writes a 64 bit unsigned zigzag-encoded number.
		* @param {bigint} v
		*/
		writeVarLong(v) {
		return this.writeUnsignedVarLong((v << 1n) ^ (v >> 63n));
		}
		/**
		* Reads a 64 bit unsigned variable-length number.
		* @returns {bigint}
		*/
		readUnsignedVarLong() {
		let value = 0n;
		for (let i = 0; i <= 63; i += 7) {
		if (this.feof()) {
		throw new Error('No bytes left in buffer');
		}
		const b = this.readByte();
		value \|= (BigInt(b) & 0x7fn) << BigInt(i);
		if ((b & 0x80) === 0) {
		return value;
		}
		}
		throw new Error('VarLong did not terminate after 10 bytes!');
		}
		/**
		* Writes a 64 bit unsigned variable-length number.
		* @param {bigint} v
		*/
		writeUnsignedVarLong(v) {
		for (let i = 0; i < 10; ++i) {
		if (v >> 7n !== 0n) {
		this.writeByte(Number(v \| 0x80n));
		}
		else {
		this.writeByte(Number(v & 0x7fn));
		break;
		}
		v >>= 7n;
		}
		}
		/**
		* Increases the write offset by the given length.
		* @param {number} length
		*/
		addOffset(length) {
		return (this.readIndex += length) - length;
		}
		/**
		* Returns whatever or not the read offset is at end of line.
		* @returns {number}
		*/
		feof() {
		if (!this.buffer)
		throw new Error('Buffer is write only!');
		return typeof this.buffer[this.readIndex] === 'undefined';
		}
		/**
		* Reads the remaining bytes and returns the buffer slice.
		* @returns {Buffer}
		*/
		readRemaining() {
		if (!this.buffer)
		throw new Error('Buffer is write only!');
		const buf = this.buffer.slice(this.readIndex);
		this.readIndex = this.buffer.byteLength;
		return buf;
		}
		/**
		* Skips len bytes on the buffer.
		* @param {number} len
		*/
		skip(len) {
		assert(Number.isInteger(len), 'Cannot skip a float amount of bytes');
		this.readIndex += len;
		}
		/**
		* Returns the encoded buffer.
		* @returns {Buffer}
		*/
		getBuffer() {
		return this.buffer !== null ? this.buffer : Buffer.from(this.binary);
		}
		/**
		* Retuns the read index.
		* @returns {number}
		*/
		getReadIndex() {
		return this.readIndex;
		}
		/**
		* Returns the write index.
		* @returns {number}
		*/
		getWriteIndex() {
		return this.writeIndex;
		}
		/**
		* Do read assertions, check if the read buffer is null.
		* @param {number} byteLength
		*/
		doReadAssertions(byteLength) {
		assert(this.buffer !== null, 'Cannot read without buffer data!');
		assert(this.buffer.byteLength >= byteLength, 'Cannot read without buffer data!');
		}
		/**
		* Do read assertions, check if the read buffer is null.
		* @param {number\|bigint} num
		* @param {number\|bigint} minVal
		* @param {number\|bigint} maxVal
		*/
		doWriteAssertions(num, minVal, maxVal) {
		assert(num >= minVal && num <= maxVal, `Value out of bounds: value=${num}, min=${minVal}, max=${maxVal}`);
		}
		}
		//# sourceMappingURL=BinaryStream.js.map

+1

dist/esm/BinaryStream.js.map

+340

dist/types/BinaryStream.d.ts

		/// <reference types="node" />
		export default class BinaryStream {
		private binary;
		private buffer;
		private readIndex;
		private writeIndex;
		/**
		* Creates a new BinaryStream instance.
		* @param {Buffer\|null\|undefined} buffer - The array or Buffer containing binary data.
		* @param {number} offset - The initial pointer position.
		*/
		constructor(buffer?: Buffer, offset?: number);
		/**
		* Reads a slice of buffer by the given length.
		* @param {number} len
		*/
		read(len: number): Buffer;
		/**
		* Appends a buffer to the main buffer.
		* @param {Buffer\|Uint8Array} buf
		*/
		write(buf: Uint8Array): void;
		/**
		* Reads an unsigned byte (0 to 255).
		* @returns {number}
		*/
		readByte(): number;
		/**
		* Writes an unsigned byte (0 to 255).
		* @param {number} v
		*/
		writeByte(v: number): void;
		/**
		* Reads a signed byte (-128 to 127).
		* @returns {number}
		*/
		readSignedByte(): number;
		/**
		* Writes a signed byte (-128 to 127).
		* @param {number} v
		*/
		writeSignedByte(v: number): void;
		/**
		* Reads a boolean (true or false).
		* @returns {boolean}
		*/
		readBoolean(): boolean;
		/**
		* Writes a boolean (true or false).
		* @param {boolean} v
		*/
		writeBoolean(v: boolean): void;
		/**
		* Reads a 16 bit (2 bytes) signed big-endian number.
		* @returns {number}
		*/
		readShort(): number;
		/**
		* Writes a 16 bit (2 bytes) signed big-endian number.
		* @param {number} v
		*/
		writeShort(v: number): void;
		/**
		* Reads a 16 bit (2 bytes) signed little-endian number.
		* @returns {number}
		*/
		readShortLE(): number;
		/**
		* Writes a 16 bit (2 bytes) signed big-endian number.
		* @param {number} v
		*/
		writeShortLE(v: number): void;
		/**
		* Reads a 16 bit (2 bytes) unsigned big-endian number.
		* @returns {number}
		*/
		readUnsignedShort(): number;
		/**
		* Writes a 16 bit (2 bytes) unsigned big-endian number.
		* @param {number} v
		*/
		writeUnsignedShort(v: number): void;
		/**
		* Reads a 16 bit (2 bytes) unsigned little-endian number.
		* @returns {number}
		*/
		readUnsignedShortLE(): number;
		/**
		* Writes a 16 bit (2 bytes) unsigned little-endian number.
		* @param {number} v
		*/
		writeUnsignedShortLE(v: number): void;
		/**
		* Reads a 24 bit (3 bytes) signed big-endian number.
		* @returns {number}
		*/
		readTriad(): number;
		/**
		* Writes a 24 bit (3 bytes) signed big-endian number.
		* @param {number} v
		*/
		writeTriad(v: number): void;
		/**
		* Reads a 24 bit (3 bytes) little-endian number.
		* @returns {number}
		*/
		readTriadLE(): number;
		/**
		* Writes a 24 bit (3 bytes) signed little-endian number.
		* @param {number} v
		*/
		writeTriadLE(v: number): void;
		/**
		* Reads a 24 bit (3 bytes) unsigned big-endian number.
		* @returns {number}
		*/
		readUnsignedTriad(): number;
		/**
		* Writes a 24 bit (3 bytes) unsigned big-endian number.
		* @param {number} v
		*/
		writeUnsignedTriad(v: number): void;
		/**
		* Reads a 24 bit (3 bytes) unsigned little-endian number.
		* @returns {number}
		*/
		readUnsignedTriadLE(): number;
		/**
		* Writes a 24 bit (3 bytes) unsigned little-endian number.
		* @param {number} v
		*/
		writeUnsignedTriadLE(v: number): void;
		/**
		* Reads a 32 bit (4 bytes) big-endian signed number.
		* @returns {number}
		*/
		readInt(): number;
		/**
		* Writes a 32 bit (4 bytes) big-endian signed number.
		* @param {number} v
		*/
		writeInt(v: number): void;
		/**
		* Reads a 32 bit (4 bytes) signed number.
		* @returns {number}
		*/
		readIntLE(): number;
		/**
		* Writes a 32 bit (4 bytes) little-endian signed number.
		* @param {number} v
		*/
		writeIntLE(v: number): void;
		/**
		* Reads a 32 bit (4 bytes) big-endian unsigned number.
		* @returns {number}
		*/
		readUnsignedInt(): number;
		/**
		* Writes a 32 bit (4 bytes) big-endian unsigned number.
		* @param {number} v
		*/
		writeUnsignedInt(v: number): void;
		/**
		* Reads a 32 bit (4 bytes) little-endian unsigned number.
		* @returns {number}
		*/
		readUnsignedIntLE(): number;
		/**
		* Writes a 32 bit (4 bytes) little-endian unsigned number.
		* @param {number} v
		*/
		writeUnsignedIntLE(v: number): void;
		/**
		* Returns a 32 bit (4 bytes) big-endian flating point number.
		* @returns {number}
		*/
		readFloat(): number;
		/**
		* Writes a 32 bit (4 bytes) big-endian floating point number.
		* @param {number} v
		*/
		writeFloat(v: number): void;
		/**
		* Returns a 32 bit (4 bytes) big-endian flating point number.
		* @returns {number}
		*/
		readFloatLE(): number;
		/**
		* Writes a 32 bit (4 bytes) little-endian floating point number.
		* @param {number} v
		*/
		writeFloatLE(v: number): void;
		/**
		* Returns a 64 bit (8 bytes) big-endian flating point number.
		* @returns {number}
		*/
		readDouble(): number;
		/**
		* Writes a 64 bit (8 bytes) big-endian floating point number.
		* @param {number} v
		*/
		writeDouble(v: number): void;
		/**
		* Returns a 64 bit (8 bytes) little-endian flating point number.
		* @returns {number}
		*/
		readDoubleLE(): number;
		/**
		* Writes a 64 bit (8 bytes) little-endian floating point number.
		* @param {number} v
		*/
		writeDoubleLE(v: number): void;
		/**
		* Returns a 64 bit (8 bytes) signed big-endian number.
		* @returns {bigint}
		*/
		readLong(): bigint;
		/**
		* Writes a 64 bit (8 bytes) signed big-endian number.
		* @param {bigint} v
		*/
		writeLong(v: bigint): void;
		/**
		* Returns a 64 bit (8 bytes) signed little-endian number.
		* @returns {bigint}
		*/
		readLongLE(): bigint;
		/**
		* Writes a 64 bit (8 bytes) signed big-endian number.
		* @param {bigint} v
		*/
		writeLongLE(v: bigint): void;
		/**
		* Returns a 64 bit (8 bytes) unsigned big-endian number.
		* @returns {bigint}
		*/
		readUnsignedLong(): bigint;
		/**
		* Writes a 64 bit (8 bytes) unsigned big-endian number.
		* @param {bigint} v
		*/
		writeUnsignedLong(v: bigint): void;
		/**
		* Returns a 64 bit (8 bytes) unsigned little-endian number.
		* @returns {bigint}
		*/
		readUnsignedLongLE(): bigint;
		/**
		* Writes a 64 bit (8 bytes) unsigned big-endian number.
		* @param {bigint} v
		*/
		writeUnsignedLongLE(v: bigint): void;
		/**
		* Reads a 32 bit (4 bytes) zigzag-encoded number.
		* @returns {number}
		*/
		readVarInt(): number;
		/**
		* Writes a 32 bit (4 bytes) zigzag-encoded number.
		* @param {number} v
		*/
		writeVarInt(v: number): void;
		/**
		* Reads a 32 bit unsigned number.
		* @returns {number}
		*/
		readUnsignedVarInt(): number;
		/**
		* Writes a 32 bit unsigned number with variable-length.
		* @param {number} v
		*/
		writeUnsignedVarInt(v: number): void;
		/**
		* Reads a 64 bit zigzag-encoded variable-length number.
		* @returns {bigint}
		*/
		readVarLong(): bigint;
		/**
		* Writes a 64 bit unsigned zigzag-encoded number.
		* @param {bigint} v
		*/
		writeVarLong(v: bigint): void;
		/**
		* Reads a 64 bit unsigned variable-length number.
		* @returns {bigint}
		*/
		readUnsignedVarLong(): bigint;
		/**
		* Writes a 64 bit unsigned variable-length number.
		* @param {bigint} v
		*/
		writeUnsignedVarLong(v: bigint): void;
		/**
		* Increases the write offset by the given length.
		* @param {number} length
		*/
		private addOffset;
		/**
		* Returns whatever or not the read offset is at end of line.
		* @returns {number}
		*/
		feof(): boolean;
		/**
		* Reads the remaining bytes and returns the buffer slice.
		* @returns {Buffer}
		*/
		readRemaining(): Buffer;
		/**
		* Skips len bytes on the buffer.
		* @param {number} len
		*/
		skip(len: number): void;
		/**
		* Returns the encoded buffer.
		* @returns {Buffer}
		*/
		getBuffer(): Buffer;
		/**
		* Retuns the read index.
		* @returns {number}
		*/
		getReadIndex(): number;
		/**
		* Returns the write index.
		* @returns {number}
		*/
		getWriteIndex(): number;
		/**
		* Do read assertions, check if the read buffer is null.
		* @param {number} byteLength
		*/
		private doReadAssertions;
		/**
		* Do read assertions, check if the read buffer is null.
		* @param {number\|bigint} num
		* @param {number\|bigint} minVal
		* @param {number\|bigint} maxVal
		*/
		private doWriteAssertions;
		}

+18

-11

package.json

		{
		"name": "@jsprismarine/jsbinaryutils",
		"version": "3.2.3",
		"version": "4.2.3",
		"description": "Basic binary data managing tool written in TypeScript.",
		"main": "./dist/BinaryStream.js",
		"types": "./dist/BinaryStream.d.ts",
		"main": "./dist/cjs/index.cjs",
		"exports": {
		".": {
		"types": "./dist/types/BinaryStream.d.ts",
		"import": "./dist/esm/index.js",
		"require": "./dist/cjs/index.cjs"
		}
		},
		"types": "./dist/types/BinaryStream.d.ts",
		"scripts": {
		@@ -11,3 +18,3 @@ "test": "jest",
		"prepublishOnly": "npm run test && npm run build",
		"build": "tsc"
		"build": "tsc --project tsconfig.esm.json & tsc --project tsconfig.cjs.json"
		},
		@@ -32,9 +39,9 @@ "files": [
		"devDependencies": {
		"@types/jest": "^27.0.2",
		"@types/node": "14.11.5",
		"husky": "^4.3.8",
		"jest": "^27.3.1",
		"prettier": "2.4.1",
		"ts-jest": "^27.0.7",
		"typescript": "4.0.3"
		"@types/jest": "^29.2.5",
		"@types/node": "^18.11.3",
		"husky": "^8.0.3",
		"jest": "^29.3.1",
		"prettier": "2.8.1",
		"ts-jest": "^29.0.3",
		"typescript": "4.9.4"
		},
		@@ -41,0 +48,0 @@ "husky": {

-340

dist/BinaryStream.d.ts

		/// <reference types="node" />
		export default class BinaryStream {
		private binary;
		private buffer;
		private readIndex;
		private writeIndex;
		/**
		* Creates a new BinaryStream instance.
		* @param {Buffer\|null\|undefined} buffer - The array or Buffer containing binary data.
		* @param {number} offset - The initial pointer position.
		*/
		constructor(buffer?: Buffer, offset?: number);
		/**
		* Reads a slice of buffer by the given length.
		* @param {number} len
		*/
		read(len: number): Buffer;
		/**
		* Appends a buffer to the main buffer.
		* @param {Buffer\|Uint8Array} buf
		*/
		write(buf: Uint8Array): void;
		/**
		* Reads an unsigned byte (0 to 255).
		* @returns {number}
		*/
		readByte(): number;
		/**
		* Writes an unsigned byte (0 to 255).
		* @param {number} v
		*/
		writeByte(v: number): void;
		/**
		* Reads a signed byte (-128 to 127).
		* @returns {number}
		*/
		readSignedByte(): number;
		/**
		* Writes a signed byte (-128 to 127).
		* @param {number} v
		*/
		writeSignedByte(v: number): void;
		/**
		* Reads a boolean (true or false).
		* @returns {boolean}
		*/
		readBoolean(): boolean;
		/**
		* Writes a boolean (true or false).
		* @param {boolean} v
		*/
		writeBoolean(v: boolean): void;
		/**
		* Reads a 16 bit (2 bytes) signed big-endian number.
		* @returns {number}
		*/
		readShort(): number;
		/**
		* Writes a 16 bit (2 bytes) signed big-endian number.
		* @param {number} v
		*/
		writeShort(v: number): void;
		/**
		* Reads a 16 bit (2 bytes) signed little-endian number.
		* @returns {number}
		*/
		readShortLE(): number;
		/**
		* Writes a 16 bit (2 bytes) signed big-endian number.
		* @param {number} v
		*/
		writeShortLE(v: number): void;
		/**
		* Reads a 16 bit (2 bytes) unsigned big-endian number.
		* @returns {number}
		*/
		readUnsignedShort(): number;
		/**
		* Writes a 16 bit (2 bytes) unsigned big-endian number.
		* @param {number} v
		*/
		writeUnsignedShort(v: number): void;
		/**
		* Reads a 16 bit (2 bytes) unsigned little-endian number.
		* @returns {number}
		*/
		readUnsignedShortLE(): number;
		/**
		* Writes a 16 bit (2 bytes) unsigned little-endian number.
		* @param {number} v
		*/
		writeUnsignedShortLE(v: number): void;
		/**
		* Reads a 24 bit (3 bytes) signed big-endian number.
		* @returns {number}
		*/
		readTriad(): number;
		/**
		* Writes a 24 bit (3 bytes) signed big-endian number.
		* @param {number} v
		*/
		writeTriad(v: number): void;
		/**
		* Reads a 24 bit (3 bytes) little-endian number.
		* @returns {number}
		*/
		readTriadLE(): number;
		/**
		* Writes a 24 bit (3 bytes) signed little-endian number.
		* @param {number} v
		*/
		writeTriadLE(v: number): void;
		/**
		* Reads a 24 bit (3 bytes) unsigned big-endian number.
		* @returns {number}
		*/
		readUnsignedTriad(): number;
		/**
		* Writes a 24 bit (3 bytes) unsigned big-endian number.
		* @param {number} v
		*/
		writeUnsignedTriad(v: number): void;
		/**
		* Reads a 24 bit (3 bytes) unsigned little-endian number.
		* @returns {number}
		*/
		readUnsignedTriadLE(): number;
		/**
		* Writes a 24 bit (3 bytes) unsigned little-endian number.
		* @param {number} v
		*/
		writeUnsignedTriadLE(v: number): void;
		/**
		* Reads a 32 bit (4 bytes) big-endian signed number.
		* @returns {number}
		*/
		readInt(): number;
		/**
		* Writes a 32 bit (4 bytes) big-endian signed number.
		* @param {number} v
		*/
		writeInt(v: number): void;
		/**
		* Reads a 32 bit (4 bytes) signed number.
		* @returns {number}
		*/
		readIntLE(): number;
		/**
		* Writes a 32 bit (4 bytes) little-endian signed number.
		* @param {number} v
		*/
		writeIntLE(v: number): void;
		/**
		* Reads a 32 bit (4 bytes) big-endian unsigned number.
		* @returns {number}
		*/
		readUnsignedInt(): number;
		/**
		* Writes a 32 bit (4 bytes) big-endian unsigned number.
		* @param {number} v
		*/
		writeUnsignedInt(v: number): void;
		/**
		* Reads a 32 bit (4 bytes) little-endian unsigned number.
		* @returns {number}
		*/
		readUnsignedIntLE(): number;
		/**
		* Writes a 32 bit (4 bytes) little-endian unsigned number.
		* @param {number} v
		*/
		writeUnsignedIntLE(v: number): void;
		/**
		* Returns a 32 bit (4 bytes) big-endian flating point number.
		* @returns {number}
		*/
		readFloat(): number;
		/**
		* Writes a 32 bit (4 bytes) big-endian floating point number.
		* @param {number} v
		*/
		writeFloat(v: number): void;
		/**
		* Returns a 32 bit (4 bytes) big-endian flating point number.
		* @returns {number}
		*/
		readFloatLE(): number;
		/**
		* Writes a 32 bit (4 bytes) little-endian floating point number.
		* @param {number} v
		*/
		writeFloatLE(v: number): void;
		/**
		* Returns a 64 bit (8 bytes) big-endian flating point number.
		* @returns {number}
		*/
		readDouble(): number;
		/**
		* Writes a 64 bit (8 bytes) big-endian floating point number.
		* @param {number} v
		*/
		writeDouble(v: number): void;
		/**
		* Returns a 64 bit (8 bytes) little-endian flating point number.
		* @returns {number}
		*/
		readDoubleLE(): number;
		/**
		* Writes a 64 bit (8 bytes) little-endian floating point number.
		* @param {number} v
		*/
		writeDoubleLE(v: number): void;
		/**
		* Returns a 64 bit (8 bytes) signed big-endian number.
		* @returns {bigint}
		*/
		readLong(): bigint;
		/**
		* Writes a 64 bit (8 bytes) signed big-endian number.
		* @param {bigint} v
		*/
		writeLong(v: bigint): void;
		/**
		* Returns a 64 bit (8 bytes) signed little-endian number.
		* @returns {bigint}
		*/
		readLongLE(): bigint;
		/**
		* Writes a 64 bit (8 bytes) signed big-endian number.
		* @param {bigint} v
		*/
		writeLongLE(v: bigint): void;
		/**
		* Returns a 64 bit (8 bytes) unsigned big-endian number.
		* @returns {bigint}
		*/
		readUnsignedLong(): bigint;
		/**
		* Writes a 64 bit (8 bytes) unsigned big-endian number.
		* @param {bigint} v
		*/
		writeUnsignedLong(v: bigint): void;
		/**
		* Returns a 64 bit (8 bytes) unsigned little-endian number.
		* @returns {bigint}
		*/
		readUnsignedLongLE(): bigint;
		/**
		* Writes a 64 bit (8 bytes) unsigned big-endian number.
		* @param {bigint} v
		*/
		writeUnsignedLongLE(v: bigint): void;
		/**
		* Reads a 32 bit (4 bytes) zigzag-encoded number.
		* @returns {number}
		*/
		readVarInt(): number;
		/**
		* Writes a 32 bit (4 bytes) zigzag-encoded number.
		* @param {number} v
		*/
		writeVarInt(v: number): void;
		/**
		* Reads a 32 bit unsigned number.
		* @returns {number}
		*/
		readUnsignedVarInt(): number;
		/**
		* Writes a 32 bit unsigned number with variable-length.
		* @param {number} v
		*/
		writeUnsignedVarInt(v: number): void;
		/**
		* Reads a 64 bit zigzag-encoded variable-length number.
		* @returns {bigint}
		*/
		readVarLong(): bigint;
		/**
		* Writes a 64 bit unsigned zigzag-encoded number.
		* @param {bigint} v
		*/
		writeVarLong(v: bigint): void;
		/**
		* Reads a 64 bit unsigned variable-length number.
		* @returns {bigint}
		*/
		readUnsignedVarLong(): bigint;
		/**
		* Writes a 64 bit unsigned variable-length number.
		* @param {bigint} v
		*/
		writeUnsignedVarLong(v: bigint): void;
		/**
		* Increases the write offset by the given length.
		* @param {number} length
		*/
		private addOffset;
		/**
		* Returns whatever or not the read offset is at end of line.
		* @returns {number}
		*/
		feof(): boolean;
		/**
		* Reads the remaining bytes and returns the buffer slice.
		* @returns {Buffer}
		*/
		readRemaining(): Buffer;
		/**
		* Skips len bytes on the buffer.
		* @param {number} len
		*/
		skip(len: number): void;
		/**
		* Returns the encoded buffer.
		* @returns {Buffer}
		*/
		getBuffer(): Buffer;
		/**
		* Retuns the read index.
		* @returns {number}
		*/
		getReadIndex(): number;
		/**
		* Returns the write index.
		* @returns {number}
		*/
		getWriteIndex(): number;
		/**
		* Do read assertions, check if the read buffer is null.
		* @param {number} byteLength
		*/
		private doReadAssertions;
		/**
		* Do read assertions, check if the read buffer is null.
		* @param {number\|bigint} num
		* @param {number\|bigint} minVal
		* @param {number\|bigint} maxVal
		*/
		private doWriteAssertions;
		}

-632

dist/BinaryStream.js

		"use strict";
		var __importDefault = (this && this.__importDefault) \|\| function (mod) {
		return (mod && mod.__esModule) ? mod : { "default": mod };
		};
		Object.defineProperty(exports, "__esModule", { value: true });
		const assert_1 = __importDefault(require("assert"));
		class BinaryStream {
		/**
		* Creates a new BinaryStream instance.
		* @param {Buffer\|null\|undefined} buffer - The array or Buffer containing binary data.
		* @param {number} offset - The initial pointer position.
		*/
		constructor(buffer, offset = 0) {
		this.binary = [];
		this.buffer = null;
		this.writeIndex = 0;
		this.buffer = buffer ?? null; // Keep this instance for reading
		this.readIndex = offset;
		}
		/**
		* Reads a slice of buffer by the given length.
		* @param {number} len
		*/
		read(len) {
		this.doReadAssertions(len);
		return this.buffer.slice(this.readIndex, (this.readIndex += len));
		}
		write(buf) {
		this.binary.push(...buf);
		this.writeIndex += buf.byteLength;
		}
		/**
		* Reads an unsigned byte (0 to 255).
		* @returns {number}
		*/
		readByte() {
		this.doReadAssertions(1);
		return this.buffer.readUInt8(this.readIndex++);
		}
		/**
		* Writes an unsigned byte (0 to 255).
		* @param {number} v
		*/
		writeByte(v) {
		v &= 0xff;
		this.binary[this.writeIndex++] = v;
		}
		/**
		* Reads a signed byte (-128 to 127).
		* @returns {number}
		*/
		readSignedByte() {
		this.doReadAssertions(1);
		return this.buffer.readInt8(this.readIndex++);
		}
		/**
		* Writes a signed byte (-128 to 127).
		* @param {number} v
		*/
		writeSignedByte(v) {
		if (v < 0)
		v = 0xff + v + 1;
		this.binary[this.writeIndex++] = v & 0xff;
		}
		/**
		* Reads a boolean (true or false).
		* @returns {boolean}
		*/
		readBoolean() {
		this.doReadAssertions(1);
		return !!this.readByte();
		}
		/**
		* Writes a boolean (true or false).
		* @param {boolean} v
		*/
		writeBoolean(v) {
		this.writeByte(+v);
		}
		/**
		* Reads a 16 bit (2 bytes) signed big-endian number.
		* @returns {number}
		*/
		readShort() {
		this.doReadAssertions(2);
		return this.buffer.readInt16BE(this.addOffset(2));
		}
		/**
		* Writes a 16 bit (2 bytes) signed big-endian number.
		* @param {number} v
		*/
		writeShort(v) {
		this.doWriteAssertions(v, -32768, 32767);
		this.writeByte(v >> 8);
		this.writeByte(v);
		}
		/**
		* Reads a 16 bit (2 bytes) signed little-endian number.
		* @returns {number}
		*/
		readShortLE() {
		this.doReadAssertions(2);
		return this.buffer.readInt16LE(this.addOffset(2));
		}
		/**
		* Writes a 16 bit (2 bytes) signed big-endian number.
		* @param {number} v
		*/
		writeShortLE(v) {
		this.doWriteAssertions(v, -32768, 32767);
		this.writeByte(v);
		this.writeByte(v >> 8);
		}
		/**
		* Reads a 16 bit (2 bytes) unsigned big-endian number.
		* @returns {number}
		*/
		readUnsignedShort() {
		this.doReadAssertions(2);
		return this.buffer.readUInt16BE(this.addOffset(2));
		}
		/**
		* Writes a 16 bit (2 bytes) unsigned big-endian number.
		* @param {number} v
		*/
		writeUnsignedShort(v) {
		this.doWriteAssertions(v, 0, 65535);
		this.writeByte(v >>> 8);
		this.writeByte(v);
		}
		/**
		* Reads a 16 bit (2 bytes) unsigned little-endian number.
		* @returns {number}
		*/
		readUnsignedShortLE() {
		this.doReadAssertions(2);
		return this.buffer.readUInt16LE(this.addOffset(2));
		}
		/**
		* Writes a 16 bit (2 bytes) unsigned little-endian number.
		* @param {number} v
		*/
		writeUnsignedShortLE(v) {
		this.doWriteAssertions(v, 0, 65535);
		this.writeByte(v);
		this.writeByte(v >>> 8);
		}
		/**
		* Reads a 24 bit (3 bytes) signed big-endian number.
		* @returns {number}
		*/
		readTriad() {
		this.doReadAssertions(3);
		return this.buffer.readIntBE(this.addOffset(3), 3);
		}
		/**
		* Writes a 24 bit (3 bytes) signed big-endian number.
		* @param {number} v
		*/
		writeTriad(v) {
		this.doWriteAssertions(v, -8388608, 8388607);
		this.writeByte((v & 0xff0000) >> 16); // msb
		this.writeByte((v & 0x00ff00) >> 8); // mib
		this.writeByte(v & 0x0000ff); // lsb
		}
		/**
		* Reads a 24 bit (3 bytes) little-endian number.
		* @returns {number}
		*/
		readTriadLE() {
		this.doReadAssertions(3);
		return this.buffer.readIntLE(this.addOffset(3), 3);
		}
		/**
		* Writes a 24 bit (3 bytes) signed little-endian number.
		* @param {number} v
		*/
		writeTriadLE(v) {
		this.doWriteAssertions(v, -8388608, 8388607);
		this.writeByte(v & 0x0000ff);
		this.writeByte((v & 0x00ff00) >> 8);
		this.writeByte((v & 0xff0000) >> 16);
		}
		/**
		* Reads a 24 bit (3 bytes) unsigned big-endian number.
		* @returns {number}
		*/
		readUnsignedTriad() {
		this.doReadAssertions(3);
		return this.buffer.readUIntBE(this.addOffset(3), 3);
		}
		/**
		* Writes a 24 bit (3 bytes) unsigned big-endian number.
		* @param {number} v
		*/
		writeUnsignedTriad(v) {
		this.doWriteAssertions(v, 0, 16777215);
		this.writeByte((v & 0xff0000) >>> 16); // msb
		this.writeByte((v & 0x00ff00) >>> 8); // mib
		this.writeByte(v & 0x0000ff); // lsb
		}
		/**
		* Reads a 24 bit (3 bytes) unsigned little-endian number.
		* @returns {number}
		*/
		readUnsignedTriadLE() {
		this.doReadAssertions(3);
		return this.buffer.readUIntLE(this.addOffset(3), 3);
		}
		/**
		* Writes a 24 bit (3 bytes) unsigned little-endian number.
		* @param {number} v
		*/
		writeUnsignedTriadLE(v) {
		this.doWriteAssertions(v, 0, 16777215);
		this.writeByte(v & 0x0000ff);
		this.writeByte((v & 0x00ff00) >>> 8);
		this.writeByte((v & 0xff0000) >>> 16);
		}
		/**
		* Reads a 32 bit (4 bytes) big-endian signed number.
		* @returns {number}
		*/
		readInt() {
		this.doReadAssertions(4);
		return this.buffer.readInt32BE(this.addOffset(4));
		}
		/**
		* Writes a 32 bit (4 bytes) big-endian signed number.
		* @param {number} v
		*/
		writeInt(v) {
		if (v < 0)
		v = v & (0xffffffff + v + 1);
		this.doWriteAssertions(v, -2147483648, 2147483647);
		this.writeByte(v >> 24);
		this.writeByte(v >> 16);
		this.writeByte(v >> 8);
		this.writeByte(v);
		}
		/**
		* Reads a 32 bit (4 bytes) signed number.
		* @returns {number}
		*/
		readIntLE() {
		this.doReadAssertions(4);
		return this.buffer.readIntLE(this.addOffset(4), 4);
		}
		/**
		* Writes a 32 bit (4 bytes) little-endian signed number.
		* @param {number} v
		*/
		writeIntLE(v) {
		if (v < 0)
		v = v & (0xffffffff + v + 1);
		this.doWriteAssertions(v, -2147483648, 2147483647);
		this.writeByte(v);
		this.writeByte(v >> 8);
		this.writeByte(v >> 16);
		this.writeByte(v >> 24);
		}
		/**
		* Reads a 32 bit (4 bytes) big-endian unsigned number.
		* @returns {number}
		*/
		readUnsignedInt() {
		this.doReadAssertions(4);
		return this.buffer.readUInt32BE(this.addOffset(4));
		}
		/**
		* Writes a 32 bit (4 bytes) big-endian unsigned number.
		* @param {number} v
		*/
		writeUnsignedInt(v) {
		this.doWriteAssertions(v, 0, 4294967295);
		this.writeByte(v >>> 24);
		this.writeByte(v >>> 16);
		this.writeByte(v >>> 8);
		this.writeByte(v);
		}
		/**
		* Reads a 32 bit (4 bytes) little-endian unsigned number.
		* @returns {number}
		*/
		readUnsignedIntLE() {
		this.doReadAssertions(4);
		return this.buffer.readUInt32LE(this.addOffset(4));
		}
		/**
		* Writes a 32 bit (4 bytes) little-endian unsigned number.
		* @param {number} v
		*/
		writeUnsignedIntLE(v) {
		this.doWriteAssertions(v, 0, 4294967295);
		this.writeByte(v);
		this.writeByte(v >>> 8);
		this.writeByte(v >>> 16);
		this.writeByte(v >>> 24);
		}
		/**
		* Returns a 32 bit (4 bytes) big-endian flating point number.
		* @returns {number}
		*/
		readFloat() {
		this.doReadAssertions(4);
		return this.buffer.readFloatBE(this.addOffset(4));
		}
		/**
		* Writes a 32 bit (4 bytes) big-endian floating point number.
		* @param {number} v
		*/
		writeFloat(v) {
		this.doWriteAssertions(v, -3.4028234663852886e38, +3.4028234663852886e38);
		this.write(new Uint8Array(new Float32Array([v]).buffer).reverse());
		}
		/**
		* Returns a 32 bit (4 bytes) big-endian flating point number.
		* @returns {number}
		*/
		readFloatLE() {
		this.doReadAssertions(4);
		return this.buffer.readFloatLE(this.addOffset(4));
		}
		/**
		* Writes a 32 bit (4 bytes) little-endian floating point number.
		* @param {number} v
		*/
		writeFloatLE(v) {
		this.doWriteAssertions(v, -3.4028234663852886e38, +3.4028234663852886e38);
		this.write(new Uint8Array(new Float32Array([v]).buffer));
		}
		/**
		* Returns a 64 bit (8 bytes) big-endian flating point number.
		* @returns {number}
		*/
		readDouble() {
		this.doReadAssertions(8);
		return this.buffer.readDoubleBE(this.addOffset(8));
		}
		/**
		* Writes a 64 bit (8 bytes) big-endian floating point number.
		* @param {number} v
		*/
		writeDouble(v) {
		this.doWriteAssertions(v, -1.7976931348623157e308, +1.7976931348623157e308);
		this.write(new Uint8Array(new Float64Array([v]).buffer).reverse());
		}
		/**
		* Returns a 64 bit (8 bytes) little-endian flating point number.
		* @returns {number}
		*/
		readDoubleLE() {
		this.doReadAssertions(8);
		return this.buffer.readDoubleLE(this.addOffset(8));
		}
		/**
		* Writes a 64 bit (8 bytes) little-endian floating point number.
		* @param {number} v
		*/
		writeDoubleLE(v) {
		this.doWriteAssertions(v, -1.7976931348623157e308, +1.7976931348623157e308);
		this.write(new Uint8Array(new Float64Array([v]).buffer));
		}
		/**
		* Returns a 64 bit (8 bytes) signed big-endian number.
		* @returns {bigint}
		*/
		readLong() {
		this.doReadAssertions(8);
		return this.buffer.readBigInt64BE(this.addOffset(8));
		}
		/**
		* Writes a 64 bit (8 bytes) signed big-endian number.
		* @param {bigint} v
		*/
		writeLong(v) {
		const lo = Number(v & BigInt(0xffffffff));
		this.binary[this.writeIndex + 7] = lo;
		this.binary[this.writeIndex + 6] = lo >> 8;
		this.binary[this.writeIndex + 5] = lo >> 16;
		this.binary[this.writeIndex + 4] = lo >> 24;
		const hi = Number((v >> BigInt(32)) & BigInt(0xffffffff));
		this.binary[this.writeIndex + 3] = hi;
		this.binary[this.writeIndex + 2] = hi >> 8;
		this.binary[this.writeIndex + 1] = hi >> 16;
		this.binary[this.writeIndex] = hi >> 24;
		this.writeIndex += 8;
		}
		/**
		* Returns a 64 bit (8 bytes) signed little-endian number.
		* @returns {bigint}
		*/
		readLongLE() {
		this.doReadAssertions(8);
		return this.buffer.readBigInt64LE(this.addOffset(8));
		}
		/**
		* Writes a 64 bit (8 bytes) signed big-endian number.
		* @param {bigint} v
		*/
		writeLongLE(v) {
		const lo = Number(v & BigInt(0xffffffff));
		this.binary[this.writeIndex++] = lo;
		this.binary[this.writeIndex++] = lo >> 8;
		this.binary[this.writeIndex++] = lo >> 16;
		this.binary[this.writeIndex++] = lo >> 24;
		const hi = Number((v >> BigInt(32)) & BigInt(0xffffffff));
		this.binary[this.writeIndex++] = hi;
		this.binary[this.writeIndex++] = hi >> 8;
		this.binary[this.writeIndex++] = hi >> 16;
		this.binary[this.writeIndex++] = hi >> 24;
		}
		/**
		* Returns a 64 bit (8 bytes) unsigned big-endian number.
		* @returns {bigint}
		*/
		readUnsignedLong() {
		this.doReadAssertions(8);
		return this.buffer.readBigUInt64BE(this.addOffset(8));
		}
		/**
		* Writes a 64 bit (8 bytes) unsigned big-endian number.
		* @param {bigint} v
		*/
		writeUnsignedLong(v) {
		const lo = Number(v & BigInt(0xffffffff));
		this.binary[this.writeIndex + 7] = lo;
		this.binary[this.writeIndex + 6] = lo >> 8;
		this.binary[this.writeIndex + 5] = lo >> 16;
		this.binary[this.writeIndex + 4] = lo >> 24;
		const hi = Number((v >> BigInt(32)) & BigInt(0xffffffff));
		this.binary[this.writeIndex + 3] = hi;
		this.binary[this.writeIndex + 2] = hi >> 8;
		this.binary[this.writeIndex + 1] = hi >> 16;
		this.binary[this.writeIndex] = hi >> 24;
		this.writeIndex += 8;
		}
		/**
		* Returns a 64 bit (8 bytes) unsigned little-endian number.
		* @returns {bigint}
		*/
		readUnsignedLongLE() {
		this.doReadAssertions(8);
		return this.buffer.readBigUInt64LE(this.addOffset(8));
		}
		/**
		* Writes a 64 bit (8 bytes) unsigned big-endian number.
		* @param {bigint} v
		*/
		writeUnsignedLongLE(v) {
		const lo = Number(v & BigInt(0xffffffff));
		this.binary[this.writeIndex++] = lo;
		this.binary[this.writeIndex++] = lo >> 8;
		this.binary[this.writeIndex++] = lo >> 16;
		this.binary[this.writeIndex++] = lo >> 24;
		const hi = Number((v >> BigInt(32)) & BigInt(0xffffffff));
		this.binary[this.writeIndex++] = hi;
		this.binary[this.writeIndex++] = hi >> 8;
		this.binary[this.writeIndex++] = hi >> 16;
		this.binary[this.writeIndex++] = hi >> 24;
		}
		/**
		* Reads a 32 bit (4 bytes) zigzag-encoded number.
		* @returns {number}
		*/
		readVarInt() {
		const raw = this.readUnsignedVarInt();
		const temp = (((raw << 63) >> 63) ^ raw) >> 1;
		return temp ^ (raw & (1 << 63));
		}
		/**
		* Writes a 32 bit (4 bytes) zigzag-encoded number.
		* @param {number} v
		*/
		writeVarInt(v) {
		v = (v << 32) >> 32;
		return this.writeUnsignedVarInt((v << 1) ^ (v >> 31));
		}
		/**
		* Reads a 32 bit unsigned number.
		* @returns {number}
		*/
		readUnsignedVarInt() {
		assert_1.default(this.buffer != null, 'Reading on empty buffer!');
		let value = 0;
		for (let i = 0; i <= 28; i += 7) {
		if (typeof this.buffer[this.readIndex] === 'undefined') {
		throw new Error('No bytes left in buffer');
		}
		let b = this.readByte();
		value \|= (b & 0x7f) << i;
		if ((b & 0x80) === 0) {
		return value;
		}
		}
		throw new Error('VarInt did not terminate after 5 bytes!');
		}
		/**
		* Writes a 32 bit unsigned number with variable-length.
		* @param {number} v
		*/
		writeUnsignedVarInt(v) {
		while ((v & 0xffffff80) !== 0) {
		this.writeByte((v & 0x7f) \| 0x80);
		v >>>= 7;
		}
		this.writeByte(v & 0x7f);
		}
		/**
		* Reads a 64 bit zigzag-encoded variable-length number.
		* @returns {bigint}
		*/
		readVarLong() {
		const raw = this.readUnsignedVarLong();
		return raw >> 1n;
		}
		/**
		* Writes a 64 bit unsigned zigzag-encoded number.
		* @param {bigint} v
		*/
		writeVarLong(v) {
		return this.writeUnsignedVarLong((v << 1n) ^ (v >> 63n));
		}
		/**
		* Reads a 64 bit unsigned variable-length number.
		* @returns {bigint}
		*/
		readUnsignedVarLong() {
		let value = 0n;
		for (let i = 0; i <= 63; i += 7) {
		if (this.feof()) {
		throw new Error('No bytes left in buffer');
		}
		const b = this.readByte();
		value \|= (BigInt(b) & 0x7fn) << BigInt(i);
		if ((b & 0x80) === 0) {
		return value;
		}
		}
		throw new Error('VarLong did not terminate after 10 bytes!');
		}
		/**
		* Writes a 64 bit unsigned variable-length number.
		* @param {bigint} v
		*/
		writeUnsignedVarLong(v) {
		for (let i = 0; i < 10; ++i) {
		if (v >> 7n !== 0n) {
		this.writeByte(Number(v \| 0x80n));
		}
		else {
		this.writeByte(Number(v & 0x7fn));
		break;
		}
		v >>= 7n;
		}
		}
		/**
		* Increases the write offset by the given length.
		* @param {number} length
		*/
		addOffset(length) {
		return (this.readIndex += length) - length;
		}
		/**
		* Returns whatever or not the read offset is at end of line.
		* @returns {number}
		*/
		feof() {
		if (!this.buffer)
		throw new Error('Buffer is write only!');
		return typeof this.buffer[this.readIndex] === 'undefined';
		}
		/**
		* Reads the remaining bytes and returns the buffer slice.
		* @returns {Buffer}
		*/
		readRemaining() {
		if (!this.buffer)
		throw new Error('Buffer is write only!');
		const buf = this.buffer.slice(this.readIndex);
		this.readIndex = this.buffer.byteLength;
		return buf;
		}
		/**
		* Skips len bytes on the buffer.
		* @param {number} len
		*/
		skip(len) {
		assert_1.default(Number.isInteger(len), 'Cannot skip a float amount of bytes');
		this.readIndex += len;
		}
		/**
		* Returns the encoded buffer.
		* @returns {Buffer}
		*/
		getBuffer() {
		return this.buffer !== null ? this.buffer : Buffer.from(this.binary);
		}
		/**
		* Retuns the read index.
		* @returns {number}
		*/
		getReadIndex() {
		return this.readIndex;
		}
		/**
		* Returns the write index.
		* @returns {number}
		*/
		getWriteIndex() {
		return this.writeIndex;
		}
		/**
		* Do read assertions, check if the read buffer is null.
		* @param {number} byteLength
		*/
		doReadAssertions(byteLength) {
		assert_1.default(this.buffer !== null, 'Cannot read without buffer data!');
		assert_1.default(this.buffer.byteLength >= byteLength, 'Cannot read without buffer data!');
		}
		/**
		* Do read assertions, check if the read buffer is null.
		* @param {number\|bigint} num
		* @param {number\|bigint} minVal
		* @param {number\|bigint} maxVal
		*/
		doWriteAssertions(num, minVal, maxVal) {
		assert_1.default(num >= minVal && num <= maxVal, `Value out of bounds: value=${num}, min=${minVal}, max=${maxVal}`);
		}
		}
		exports.default = BinaryStream;

@jsprismarine/jsbinaryutils - npm Package Compare versions

New alerts

Improved metrics

Worsened metrics