@vaitosoi/minejs 0.2.1 → 0.3.1

package/dist/client/tcp.d.ts

@@ -0,0 +1,84 @@
+import { Socket, SocketConstructorOpts } from "node:net";
+import { TypedEmmiter } from "../base/event";
+import { BinaryDecoder } from "../packet/decoder";
+import { AuthOption } from "./auth";
+import { SharedState } from "../world/state";
+import { EncodeResult } from "../version/codec";
+import { TextComponent } from "../base/typing";
+export interface TCPClientOption {
+    /** Server host */
+    host: string;
+    /** Server port */
+    port: number;
+    /**
+     * Server protocol version.
+     *
+     * Currentlt support `776` or version `26.2`
+     *
+     * @see https://minecraft.wiki/w/Minecraft_Wiki:Projects/wiki.vg_merge/Protocol_version_numbers
+     */
+    protocolVersion: number;
+    /** Player name */
+    playerName: string;
+    /**
+     * Set to true only if you are playing in offline server or crack server
+     */
+    isOffline?: boolean;
+    /**
+     * Send empty `Known Packet` to let server send all Registry data, which may consume a lot of bandwith
+     */
+    loadRegistry?: boolean;
+    debug?: {
+        /** Log the incoming packet */
+        packetLogger: boolean;
+    };
+    auth?: AuthOption;
+}
+export interface TCPClientEvents {
+    connect: [];
+    raw: [buffer: Buffer];
+    destroy: [];
+}
+export interface Message {
+    sender: string;
+    target: string | undefined;
+    content: string;
+    raw: {
+        sender: TextComponent;
+        target: TextComponent | undefined;
+        content: TextComponent | undefined;
+    };
+}
+declare const TCPClient_base: new () => TypedEmmiter<TCPClientEvents>;
+/**
+ * Low-level client. You SHOULD NOT use this client unless you know what are you doing
+ *
+ * @see https://minecraft.wiki/w/Java_Edition_protocol/Packets?oldid=3445844
+ */
+export declare class TCPClient extends TCPClient_base {
+    private state;
+    readonly option: TCPClientOption;
+    readonly socket: Socket;
+    /**
+     * | Value | Meaning |
+     * |-------|---------|
+     * | 0     |  not set yet |
+     * | -1    | dont compress |
+     * | > 0   | compression threshold |
+     */
+    private bufferPool;
+    constructor(state: SharedState, option: TCPClientOption, socketOption?: SocketConstructorOpts);
+    sendInitPacket: () => void;
+    forwardPacket: (packetId: number, decoder: BinaryDecoder) => void;
+    parsePacket: (packetId: string | number, data: object) => EncodeResult;
+    /**
+     * Connect to server
+     */
+    connect(): Promise<void>;
+    disconnect(): void;
+    private handlePacket;
+    write(buf: Buffer): void;
+    sendPacket(packetId: number | string, data: Record<string, any>): void;
+}
+export {};
+//# sourceMappingURL=tcp.d.ts.map

package/dist/client/tcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tcp.d.ts","sourceRoot":"","sources":["../../src/client/tcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAIzD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAiC,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAQ/C,MAAM,WAAW,eAAe;IAC5B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,KAAK,CAAC,EAAE;QACJ,8BAA8B;QAC9B,YAAY,EAAE,OAAO,CAAA;KACxB,CAAC;IAGF,IAAI,CAAC,EAAE,UAAU,CAAA;CACpB;AAED,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,EAAE,CAAC;IACZ,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrB,OAAO,EAAE,EAAE,CAAC;CACf;AAED,MAAM,WAAW,OAAO;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE;QACD,MAAM,EAAE,aAAa,CAAC;QACtB,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC;QAClC,OAAO,EAAE,aAAa,GAAG,SAAS,CAAA;KACrC,CAAA;CACJ;wCAcyD,YAAY,CAAC,eAAe,CAAC;AALvF;;;;GAIG;AACH,qBAAa,SAAU,SAAQ,cAAyD;IAchF,OAAO,CAAC,KAAK;aACG,MAAM,EAAE,eAAe;IAd3C,SAAgB,MAAM,EAAE,MAAM,CAAC;IAG/B;;;;;;OAMG;IACH,OAAO,CAAC,UAAU,CAA2B;IAE7C,YACY,KAAK,EAAE,WAAW,EACV,MAAM,EAAE,eAAe,EACvC,YAAY,CAAC,EAAE,qBAAqB,EAOvC;IAEM,cAAc,EAAE,MAAM,IAAI,CAAwD;IAClF,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,KAAK,IAAI,CAA+D;IAChI,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,YAAY,CAA+D;IAE5I;;OAEG;IACU,OAAO,kBAkCnB;IAEM,UAAU,SAGhB;IAMD,OAAO,CAAC,YAAY;IAyCb,KAAK,CAAC,GAAG,EAAE,MAAM,QASvB;IAEM,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,QAiCrE;CAEJ"}

package/dist/client/tcp.js

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TCPClient = void 0;
+const node_net_1 = require("node:net");
+const node_events_1 = require("node:events");
+const node_zlib_1 = require("node:zlib");
+const decoder_1 = require("../packet/decoder");
+const encoder_1 = require("../packet/encoder");
+const state_1 = require("../world/state");
+const error_1 = require("../base/error");
+// export enum TCPServerIntent {
+//     Status = 1,
+//     Login = 2,
+//     Transfer = 3,
+// }
+/**
+ * Low-level client. You SHOULD NOT use this client unless you know what are you doing
+ *
+ * @see https://minecraft.wiki/w/Java_Edition_protocol/Packets?oldid=3445844
+ */
+class TCPClient extends node_events_1.EventEmitter {
+    state;
+    option;
+    socket;
+    // Internal var
+    /**
+     * | Value | Meaning |
+     * |-------|---------|
+     * | 0     |  not set yet |
+     * | -1    | dont compress |
+     * | > 0   | compression threshold |
+     */
+    bufferPool = Buffer.alloc(0);
+    constructor(state, option, socketOption) {
+        super();
+        this.state = state;
+        this.option = option;
+        this.socket = new node_net_1.Socket(socketOption);
+        if (!option.isOffline && !option.auth)
+            throw new error_1.MissingAuthOption();
+    }
+    sendInitPacket = () => { throw new Error("method not implemented"); };
+    forwardPacket = (...args) => { throw new Error("method not implemented"); };
+    parsePacket = (...args) => { throw new Error("method not implemented"); };
+    /**
+     * Connect to server
+     */
+    async connect() {
+        this.state.status = state_1.ClientStatus.Connecting;
+        const connection = this.socket.connect({
+            host: this.option.host,
+            port: this.option.port
+        });
+        connection.on("connect", () => {
+            this.emit("connect");
+            this.sendInitPacket();
+        });
+        connection.on("data", (data) => {
+            let buf = Buffer.from(data);
+            if (this.state.decipher) {
+                buf = this.state.decipher.update(buf);
+            }
+            this.emit("raw", Buffer.from(buf));
+            this.bufferPool = Buffer.concat([this.bufferPool, buf]);
+            this.handlePacket();
+        });
+        connection.once("end", () => {
+            this.emit("destroy");
+            if (this.state.status === state_1.ClientStatus.Disconnected)
+                return;
+            this.state.status = state_1.ClientStatus.Disconnected;
+            this.state.state = state_1.ConnectionState.Disconnected;
+            // this.emit("disconnect", "socket close");
+        });
+        connection.once("close", () => {
+            this.emit("destroy");
+            if (this.state.status === state_1.ClientStatus.Disconnected)
+                return;
+            this.state.status = state_1.ClientStatus.Disconnected;
+            this.state.state = state_1.ConnectionState.Disconnected;
+            // this.emit("disconnect", "socket close");
+        });
+    }
+    disconnect() {
+        if (!this.socket.closed)
+            this.socket.destroy();
+    }
+    /*
+    * Read packet
+    */
+    handlePacket() {
+        while (true) {
+            if (this.bufferPool.length === 0)
+                break;
+            let decoder = new decoder_1.BinaryDecoder(this.bufferPool);
+            let packetLength;
+            try {
+                packetLength = decoder.readVarInt();
+            }
+            catch (e) {
+                break; // Not enough data to read VarInt
+            }
+            if (this.bufferPool.length - decoder.offset < packetLength)
+                break;
+            const expectedPacketEnd = decoder.offset + packetLength;
+            let packetID;
+            if (this.state.compressionThreshold === 0)
+                packetID = decoder.readVarInt();
+            else if (this.state.compressionThreshold === -1) {
+                decoder.readVarInt();
+                packetID = decoder.readVarInt();
+            }
+            else {
+                const dataLength = decoder.readVarInt();
+                if (dataLength === 0) {
+                    packetID = decoder.readVarInt();
+                }
+                else {
+                    const dataBuffer = this.bufferPool.subarray(decoder.offset, expectedPacketEnd);
+                    const decompressed = (0, node_zlib_1.inflateSync)(dataBuffer);
+                    decoder = new decoder_1.BinaryDecoder(decompressed);
+                    packetID = decoder.readVarInt();
+                }
+            }
+            this.forwardPacket(packetID, decoder);
+            this.bufferPool = this.bufferPool.subarray(expectedPacketEnd);
+        }
+    }
+    /*
+     * Send packet
+     */
+    write(buf) {
+        if (!this.socket.writable)
+            throw new error_1.SockerIsNotWritable();
+        let sendBuffer = buf;
+        if (this.state.cipher)
+            sendBuffer = this.state.cipher.update(sendBuffer);
+        this.socket.write(sendBuffer);
+    }
+    sendPacket(packetId, data) {
+        const { buffer: content, packet } = this.parsePacket(packetId, data);
+        const encodePacketId = new encoder_1.BinaryEncoder();
+        encodePacketId.writeVarInt(packet.id);
+        const sendData = Buffer.concat([encodePacketId.getBuffer(), content]);
+        let sendingPacket;
+        if (this.state.compressionThreshold !== 0) {
+            let data;
+            let uncompressedLength;
+            if (this.state.compressionThreshold > 0 && sendData.length > this.state.compressionThreshold) {
+                uncompressedLength = sendData.length;
+                data = (0, node_zlib_1.deflateSync)(sendData);
+            }
+            else {
+                uncompressedLength = 0;
+                data = sendData;
+            }
+            const dataLengthEncoder = new encoder_1.BinaryEncoder();
+            dataLengthEncoder.writeVarInt(uncompressedLength);
+            const dataLengthBuf = dataLengthEncoder.getBuffer();
+            const packetLengthEncoder = new encoder_1.BinaryEncoder();
+            packetLengthEncoder.writeVarInt(dataLengthBuf.length + data.length);
+            sendingPacket = Buffer.concat([packetLengthEncoder.getBuffer(), dataLengthBuf, data]);
+        }
+        else {
+            const packetLengthEncoder = new encoder_1.BinaryEncoder();
+            packetLengthEncoder.writeVarInt(sendData.length);
+            sendingPacket = Buffer.concat([packetLengthEncoder.getBuffer(), sendData]);
+        }
+        this.write(sendingPacket);
+    }
+}
+exports.TCPClient = TCPClient;
+//# sourceMappingURL=tcp.js.map

package/dist/client/tcp.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export * from "./base/bitset";
+export * from "./base/error";
+export * from "./base/event";
+export * from "./base/math";
+export * from "./base/typing";
+export * from "./client/auth";
+export * from "./client/client";
+export * from "./client/tcp";
+export * from "./packet/decoder";
+export * from "./packet/encoder";
+export * from "./packet/dispatcher";
+export * from "./physics/aabb";
+export * from "./physics/direction";
+export * from "./physics/player";
+export * from "./version/codec";
+export * from "./version/registry";
+export * from "./world/block";
+export * from "./world/entity";
+export * from "./world/state";
+export * from "./world/tick";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -14,24 +14,24 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./base/aabb"), exports);
 __exportStar(require("./base/bitset"), exports);
-__exportStar(require("./base/block"), exports);
-__exportStar(require("./base/block"), exports);
-__exportStar(require("./base/direction"), exports);
-__exportStar(require("./base/entity"), exports);
 __exportStar(require("./base/error"), exports);
 __exportStar(require("./base/event"), exports);
 __exportStar(require("./base/math"), exports);
-__exportStar(require("./base/player"), exports);
-__exportStar(require("./base/registry"), exports);
-__exportStar(require("./base/tick"), exports);
 __exportStar(require("./base/typing"), exports);
 __exportStar(require("./client/auth"), exports);
 __exportStar(require("./client/client"), exports);
-__exportStar(require("./client/static"), exports);
 __exportStar(require("./client/tcp"), exports);
-__exportStar(require("./translator/decoder"), exports);
-__exportStar(require("./translator/encoder"), exports);
-__exportStar(require("./translator/static"), exports);
+__exportStar(require("./packet/decoder"), exports);
+__exportStar(require("./packet/encoder"), exports);
+__exportStar(require("./packet/dispatcher"), exports);
+__exportStar(require("./physics/aabb"), exports);
+__exportStar(require("./physics/direction"), exports);
+__exportStar(require("./physics/player"), exports);
+__exportStar(require("./version/codec"), exports);
+__exportStar(require("./version/registry"), exports);
+__exportStar(require("./world/block"), exports);
+__exportStar(require("./world/entity"), exports);
+__exportStar(require("./world/state"), exports);
+__exportStar(require("./world/tick"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,+CAA6B;AAC7B,+CAA6B;AAC7B,8CAA4B;AAC5B,gDAA8B;AAC9B,gDAA8B;AAC9B,kDAAgC;AAChC,+CAA6B;AAC7B,mDAAiC;AACjC,mDAAiC;AACjC,sDAAoC;AACpC,iDAA+B;AAC/B,sDAAoC;AACpC,mDAAiC;AACjC,kDAAgC;AAChC,qDAAmC;AACnC,gDAA8B;AAC9B,iDAA+B;AAC/B,gDAA8B;AAC9B,+CAA6B"}

package/dist/packet/decoder.d.ts

@@ -0,0 +1,293 @@
+import { Vec3 } from "../physics/direction";
+export declare function getTextFromTextComponent(component: any): string;
+export declare class BinaryDecoder {
+    buffer: Buffer;
+    offset: number;
+    constructor(buffer: Buffer, needDecompress?: boolean);
+    /**
+     * Read shortcut
+     *
+     * Read `size` bytes, use readFunc, then add `size` to internal offset
+     */
+    read<T>(size: number, readFunc: (buffer: Buffer) => ((offset?: number) => T)): T;
+    /**
+     * Read 1 byte
+     * @returns signed 1-byte integer
+     */
+    readByte(): number;
+    /**
+     * Read 1 byte
+     * @returns unsigned 1-byte integer
+     */
+    readUByte(): number;
+    /**
+     * Read 2 bytes
+     * @returns signed 2-byte integer
+     */
+    readShort(): number;
+    /**
+     * Read 2 bytes
+     * @returns unsigned 2-byte integer
+     */
+    readUShort(): number;
+    /**
+     * Read 4 bytes
+     * @returns signed 4-byte integer
+     */
+    readInt(): number;
+    /**
+     * Read 8 bytes
+     * @returns signed 8-byte integer
+     */
+    readLong(): bigint;
+    /**
+     * Read 4 bytes
+     * @returns signed 4-bytes decimal
+     */
+    readFloat(): number;
+    /**
+     * Read 8 bytes
+     * @returns signed 8-byte decimal
+     */
+    readDouble(): number;
+    /**
+     * Read 1 byte
+     * @returns a boolean
+     */
+    readBoolean(): boolean;
+    /**
+     * Read n bytes of integer
+     *
+     * A VarInt packet would look like this:
+     *
+     * `[7 bits of data][1 bit indicate if the VarInt ended here]`
+     *
+     * @returns signed n-bit integer
+     */
+    readVarInt(): number;
+    /**
+     * Read n bytes of integer
+     *
+     * Similar to VarInt, A VarLong packet would look like this:
+     *
+     * `[7 bits of data][1 bit indicate if the VarLong ended here]`
+     *
+     * @returns signed n-bit integer
+     */
+    readVarLong(): bigint;
+    /**
+     * Read a string
+     *
+     * A string packet would look like this:
+     *
+     * `[VarInt as length, if not provided][N bits of data]`
+     *
+     * @returns a string
+     */
+    readString(length?: number): string;
+    /**
+     * Read a 16-byte UUID
+     */
+    readUUID(): string;
+    /**
+     * Read a Position
+     *
+     * A position packet is a 64-bit value, split into three signed integer parts:
+     * ```
+     * x: 26 MSBs
+     * z: 26 middle bits
+     * y: 12 LSBs
+     * ```
+     *
+     * @returns a Position
+     */
+    readPosition(): {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /**
+     * Read an array with known length
+     *
+     * @returns an array
+     */
+    readArray<T>(length: number, readFunc: (decoder: BinaryDecoder, ind: number) => T): T[];
+    /**
+     * Read a length-prefixed array
+     *
+     * An array packet would look like this:
+     * `[VarInt as length][N bytes of data]`
+     *
+     * @returns a length-prefixed array
+     */
+    readPrefixedArray<T>(readFunc: (decoder: BinaryDecoder, ind: number) => T): T[];
+    /**
+     * Read an array with known length and return Buffer
+     *
+     * @param size size of the item, in byte
+     * @returns an array
+     */
+    readRawArray(length: number, size: number): Buffer<ArrayBufferLike>;
+    /**
+     * Read a length-prefixed array and return the raw buffer
+     *
+     * An array packet would look like this:
+     * `[VarInt as length][N bytes of data]`
+     *
+     * @param size size of the item, in byte
+     * @returns a length-prefixed array
+     */
+    readRawPrefixedArray(size: number): Buffer<ArrayBufferLike>;
+    /**
+     * Read a Teleport Flag packet
+     *
+     * A Teleport Flag packet, which is bit mask represented as an int, would look like this:
+     * | Hex Mask | Field                  |
+     * |----------|------------------------|
+     * | 0x0001   | Is X relative          |
+     * | 0x0002   | Is Y relative          |
+     * | 0x0004   | Is Z relative          |
+     * | 0x0008   | Is Yaw relative        |
+     * | 0x0010   | Is Pitch relative      |
+     * | 0x0020   | Is Velocity X relative |
+     * | 0x0040   | Is Velocity Y relative |
+     * | 0x0080   | Is Velocity Z relative |
+     * | 0x0100   | Rotate velocity        |
+     */
+    readTeleportFlag(): {
+        x: boolean;
+        y: boolean;
+        z: boolean;
+        yaw: boolean;
+        pitch: boolean;
+        velX: boolean;
+        velY: boolean;
+        velZ: boolean;
+        rotateVelocity: boolean;
+    };
+    /**
+     * Read a Prefixed Optional field
+     *
+     * A Prefixed Optional would look like this:
+     * `[Boolean to indicate whenether the following field is presented][N bytes of data if the boolean before is true, or else empty]`
+     *
+     * @returns
+     */
+    readPrefixedOptional<T>(readFunc: (decoder: BinaryDecoder) => T): T | null;
+    /**
+     * Read a NBT
+     */
+    readNBT(): any;
+    private unpack;
+    /**
+     * Read LpVec3
+     *
+     * Read this article for more information: https://minecraft.wiki/w/Java_Edition_protocol/Data_types#LpVec3
+     */
+    readLpVec3(): Vec3;
+    /**
+     * Resolve a fixed point to a double
+     *
+     * A fixed point is a certain number of bits represent the signed integer part (number to the left of the decimal point)
+     * and the rest represent the fractional part (to the right).
+     *
+     * @param x number to resole
+     * @param n n fraction bits
+     */
+    readFixedPoint(x: number, n: number): number;
+    /**
+     * Read an angle.
+     *
+     * An angle is a rotation angle in steps of 1/256 of a full turn
+     */
+    readAngle(): number;
+    /**
+     * Represents a data record of type X, either inline, or by reference to a registry implied by context
+     */
+    readIdOrX(readX: (decoder: BinaryDecoder) => any): any;
+    /**
+     * Read Chat Type Decoration
+     *
+     * The chat type decorations look like:
+     * | Name            | Type                          | Description                      |
+     * |-----------------|-------------------------------|----------------------------------|
+     * | Translation Key | String                        |                                  |
+     * | Parameters      | Prefixed Array of VarInt Enum | 0: sender, 1: target, 2: content |
+     * | Style           | NBT                           |                                  |
+     */
+    readChatTypeDecoration(): {
+        translationKey: string;
+        parameters: number[];
+        style: any;
+    };
+    /**
+     * Read Chat Type
+     */
+    readChatType(): {
+        chat: {
+            translationKey: string;
+            parameters: number[];
+            style: any;
+        };
+        narration: {
+            translationKey: string;
+            parameters: number[];
+            style: any;
+        };
+    };
+}
+export declare class NBTDecoder extends BinaryDecoder {
+    /**
+     * Read a Compound string
+     *
+     * A string packet would look like this:
+     *
+     * `[2 bytes as length][N bits of data]`
+     *
+     * @returns a string
+     */
+    readCompoundString(): string;
+    /**
+     * Read a list / array of tag
+     *
+     * A list / array packet should look like this:
+     * [1 byte of type, if not provided][4 bytes of length][N bits of data]
+     *
+     * @returns
+     */
+    readCompoundList(type?: number): any[];
+    /**
+     * Read compound value base on provided tag
+     */
+    readCompoundValue(tag: number): any;
+    /**
+     * Read n bits
+     *
+     * A Compound entry would look like this:
+     *
+     * [1 byte of Type][2 byte of field name length][N bits of field length][N bits of data]
+     *
+     * @returns signed n-bit integer
+     */
+    readCompound(): Record<string, any>;
+    /**
+     * Read an NBT
+     *
+     * Note that Network NBT slice some root data so I have to specified it through `isNetwork` param
+     *
+     * @param isNetwork
+     * @returns
+     */
+    decode(isNetwork?: boolean): any;
+}
+export declare class SNBTDecoder {
+    private readonly source;
+    private offset;
+    constructor(source: string);
+    private skipWhiteSpace;
+    private convertValue;
+    private seek;
+    private obj;
+    decode(): Record<string, any>;
+}
+//# sourceMappingURL=decoder.d.ts.map

package/dist/packet/decoder.d.ts.map

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