specprotocol 1.0.0

package/dist/protocol/compression.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Zlib Compression/Decompression for Minecraft packet compression.
+ *
+ * Minecraft uses Zlib (deflate) for packet compression when enabled.
+ * Compression is enabled after Login Success with a threshold value.
+ */
+/**
+ * Compress data using Zlib deflate.
+ */
+export declare function compressSync(data: Buffer): Buffer;
+/**
+ * Decompress data using Zlib inflate.
+ */
+export declare function decompressSync(data: Buffer): Buffer;
+/**
+ * Async compress.
+ */
+export declare function compress(data: Buffer): Promise<Buffer>;
+/**
+ * Async decompress.
+ */
+export declare function decompress(data: Buffer): Promise<Buffer>;
+//# sourceMappingURL=compression.d.ts.map

package/dist/protocol/compression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression.d.ts","sourceRoot":"","sources":["../../src/protocol/compression.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOtD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOxD"}

package/dist/protocol/compression.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * Zlib Compression/Decompression for Minecraft packet compression.
+ *
+ * Minecraft uses Zlib (deflate) for packet compression when enabled.
+ * Compression is enabled after Login Success with a threshold value.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compressSync = compressSync;
+exports.decompressSync = decompressSync;
+exports.compress = compress;
+exports.decompress = decompress;
+const zlib = __importStar(require("zlib"));
+/**
+ * Compress data using Zlib deflate.
+ */
+function compressSync(data) {
+    return zlib.deflateSync(data);
+}
+/**
+ * Decompress data using Zlib inflate.
+ */
+function decompressSync(data) {
+    return zlib.inflateSync(data);
+}
+/**
+ * Async compress.
+ */
+function compress(data) {
+    return new Promise((resolve, reject) => {
+        zlib.deflate(data, (err, result) => {
+            if (err)
+                reject(err);
+            else
+                resolve(result);
+        });
+    });
+}
+/**
+ * Async decompress.
+ */
+function decompress(data) {
+    return new Promise((resolve, reject) => {
+        zlib.inflate(data, (err, result) => {
+            if (err)
+                reject(err);
+            else
+                resolve(result);
+        });
+    });
+}
+//# sourceMappingURL=compression.js.map

package/dist/protocol/compression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression.js","sourceRoot":"","sources":["../../src/protocol/compression.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOH,oCAEC;AAKD,wCAEC;AAKD,4BAOC;AAKD,gCAOC;AAtCD,2CAA6B;AAE7B;;GAEG;AACH,SAAgB,YAAY,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,QAAQ,CAAC,IAAY;IACjC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACnC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;YAC/B,IAAI,GAAG;gBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;;gBAChB,OAAO,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;GAEG;AACH,SAAgB,UAAU,CAAC,IAAY;IACnC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACnC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;YAC/B,IAAI,GAAG;gBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;;gBAChB,OAAO,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/protocol/connection.d.ts

@@ -0,0 +1,73 @@
+/**
+ * TCP Connection Manager for Minecraft protocol.
+ *
+ * Handles:
+ * - TCP socket connection
+ * - Packet framing (length-prefixed)
+ * - Optional compression (Zlib)
+ * - Optional encryption (AES/CFB8)
+ * - Event-based packet receiving
+ */
+import { TypedEventEmitter } from '../utils/events.js';
+import { LogLevel } from '../utils/logger.js';
+import { type RawPacket } from './packet.js';
+export interface ConnectionEvents {
+    /** Fired when a raw packet is received */
+    'packet': (packet: RawPacket) => void;
+    /** Fired when connection is established */
+    'connect': () => void;
+    /** Fired on connection error */
+    'error': (error: Error) => void;
+    /** Fired when connection is closed */
+    'close': () => void;
+}
+export interface ConnectionOptions {
+    host: string;
+    port: number;
+    logLevel?: LogLevel;
+}
+export declare class Connection extends TypedEventEmitter<ConnectionEvents> {
+    private socket;
+    private splitter;
+    private logger;
+    /** Encryption state */
+    private cipher;
+    private decipher;
+    private encrypted;
+    /** Compression state */
+    private compressionThreshold;
+    private readonly host;
+    private readonly port;
+    private _connected;
+    constructor(options: ConnectionOptions);
+    get connected(): boolean;
+    /**
+     * Connect to the Minecraft server.
+     */
+    connect(): Promise<void>;
+    /**
+     * Handle incoming TCP data.
+     */
+    private handleData;
+    /**
+     * Send a packet to the server.
+     */
+    sendPacket(packetId: number, data: Buffer): void;
+    /**
+     * Enable compression with the given threshold.
+     */
+    enableCompression(threshold: number): void;
+    /**
+     * Enable encryption with the given shared secret.
+     */
+    enableEncryption(sharedSecret: Buffer): void;
+    /**
+     * Disconnect from the server.
+     */
+    disconnect(): void;
+    /**
+     * Wait for a specific packet ID (convenience helper).
+     */
+    waitForPacket(packetId: number, timeout?: number): Promise<RawPacket>;
+}
+//# sourceMappingURL=connection.d.ts.map

package/dist/protocol/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/protocol/connection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAU,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAKH,KAAK,SAAS,EACjB,MAAM,aAAa,CAAC;AAKrB,MAAM,WAAW,gBAAgB;IAC7B,0CAA0C;IAC1C,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;IACtC,2CAA2C;IAC3C,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,gCAAgC;IAChC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAChC,sCAAsC;IACtC,OAAO,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACvB;AAED,qBAAa,UAAW,SAAQ,iBAAiB,CAAC,gBAAgB,CAAC;IAC/D,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,MAAM,CAAS;IAEvB,uBAAuB;IACvB,OAAO,CAAC,MAAM,CAAgD;IAC9D,OAAO,CAAC,QAAQ,CAAkD;IAClE,OAAO,CAAC,SAAS,CAAS;IAE1B,wBAAwB;IACxB,OAAO,CAAC,oBAAoB,CAAM;IAElC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,EAAE,iBAAiB;IAOtC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgCxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAuClB;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAqBhD;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAK1C;;OAEG;IACH,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAO5C;;OAEG;IACH,UAAU,IAAI,IAAI;IAQlB;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,SAAS,CAAC;CAkB/E"}

package/dist/protocol/connection.js

@@ -0,0 +1,212 @@
+"use strict";
+/**
+ * TCP Connection Manager for Minecraft protocol.
+ *
+ * Handles:
+ * - TCP socket connection
+ * - Packet framing (length-prefixed)
+ * - Optional compression (Zlib)
+ * - Optional encryption (AES/CFB8)
+ * - Event-based packet receiving
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Connection = void 0;
+const net = __importStar(require("net"));
+const events_js_1 = require("../utils/events.js");
+const logger_js_1 = require("../utils/logger.js");
+const packet_js_1 = require("./packet.js");
+const types_js_1 = require("./types.js");
+const encryption_js_1 = require("./encryption.js");
+const compression_js_1 = require("./compression.js");
+class Connection extends events_js_1.TypedEventEmitter {
+    socket = null;
+    splitter = new packet_js_1.PacketSplitter();
+    logger;
+    /** Encryption state */
+    cipher = null;
+    decipher = null;
+    encrypted = false;
+    /** Compression state */
+    compressionThreshold = -1;
+    host;
+    port;
+    _connected = false;
+    constructor(options) {
+        super();
+        this.host = options.host;
+        this.port = options.port;
+        this.logger = new logger_js_1.Logger('Connection', options.logLevel ?? logger_js_1.LogLevel.INFO);
+    }
+    get connected() {
+        return this._connected;
+    }
+    /**
+     * Connect to the Minecraft server.
+     */
+    connect() {
+        return new Promise((resolve, reject) => {
+            this.socket = net.createConnection({
+                host: this.host,
+                port: this.port,
+            });
+            this.socket.once('connect', () => {
+                this._connected = true;
+                this.logger.info(`Connected to ${this.host}:${this.port}`);
+                this.emit('connect');
+                resolve();
+            });
+            this.socket.once('error', (err) => {
+                this.logger.error('Socket error:', err);
+                this.emit('error', err);
+                if (!this._connected)
+                    reject(err);
+            });
+            this.socket.on('data', (data) => {
+                this.handleData(data);
+            });
+            this.socket.once('close', () => {
+                this._connected = false;
+                this.logger.info('Connection closed');
+                this.emit('close');
+            });
+        });
+    }
+    /**
+     * Handle incoming TCP data.
+     */
+    handleData(rawData) {
+        let data = rawData;
+        // Decrypt if encryption is enabled
+        if (this.encrypted && this.decipher) {
+            data = this.decipher.update(data);
+        }
+        // Split into packet frames
+        const frames = this.splitter.feed(data);
+        for (const frame of frames) {
+            try {
+                let packetPayload;
+                if (this.compressionThreshold >= 0) {
+                    // Compression is enabled — read data length
+                    const { value: dataLength, bytesRead } = (0, types_js_1.readVarInt)(frame, 0);
+                    const compressedData = frame.subarray(bytesRead);
+                    if (dataLength === 0) {
+                        // Not compressed
+                        packetPayload = compressedData;
+                    }
+                    else {
+                        // Decompress
+                        packetPayload = (0, compression_js_1.decompressSync)(compressedData);
+                    }
+                }
+                else {
+                    packetPayload = frame;
+                }
+                const packet = (0, packet_js_1.parseRawPacket)(packetPayload);
+                this.emit('packet', packet);
+            }
+            catch (err) {
+                this.logger.error('Failed to parse packet:', err);
+            }
+        }
+    }
+    /**
+     * Send a packet to the server.
+     */
+    sendPacket(packetId, data) {
+        if (!this.socket || !this._connected) {
+            throw new Error('Not connected');
+        }
+        let frame;
+        if (this.compressionThreshold >= 0) {
+            frame = (0, packet_js_1.framePacketCompressed)(packetId, data, this.compressionThreshold, compression_js_1.compressSync);
+        }
+        else {
+            frame = (0, packet_js_1.framePacket)(packetId, data);
+        }
+        // Encrypt if encryption is enabled
+        if (this.encrypted && this.cipher) {
+            frame = this.cipher.update(frame);
+        }
+        this.socket.write(frame);
+    }
+    /**
+     * Enable compression with the given threshold.
+     */
+    enableCompression(threshold) {
+        this.compressionThreshold = threshold;
+        this.logger.info(`Compression enabled with threshold: ${threshold}`);
+    }
+    /**
+     * Enable encryption with the given shared secret.
+     */
+    enableEncryption(sharedSecret) {
+        this.cipher = (0, encryption_js_1.createCipher)(sharedSecret);
+        this.decipher = (0, encryption_js_1.createDecipher)(sharedSecret);
+        this.encrypted = true;
+        this.logger.info('Encryption enabled');
+    }
+    /**
+     * Disconnect from the server.
+     */
+    disconnect() {
+        if (this.socket) {
+            this.socket.destroy();
+            this.socket = null;
+            this._connected = false;
+        }
+    }
+    /**
+     * Wait for a specific packet ID (convenience helper).
+     */
+    waitForPacket(packetId, timeout = 10000) {
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.off('packet', handler);
+                reject(new Error(`Timeout waiting for packet 0x${packetId.toString(16)}`));
+            }, timeout);
+            const handler = (packet) => {
+                if (packet.id === packetId) {
+                    clearTimeout(timer);
+                    this.off('packet', handler);
+                    resolve(packet);
+                }
+            };
+            this.on('packet', handler);
+        });
+    }
+}
+exports.Connection = Connection;
+//# sourceMappingURL=connection.js.map

package/dist/protocol/connection.js.map

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

package/dist/protocol/encryption.d.ts

@@ -0,0 +1,29 @@
+/**
+ * AES/CFB8 Encryption for Minecraft protocol.
+ *
+ * Minecraft uses AES/CFB8 encryption for all packets after the Encryption Response.
+ * Both the key and IV are the shared secret (16 bytes).
+ */
+import * as crypto from 'crypto';
+/**
+ * Create a cipher transform for encrypting outgoing data.
+ */
+export declare function createCipher(sharedSecret: Buffer): crypto.Cipheriv;
+/**
+ * Create a decipher transform for decrypting incoming data.
+ */
+export declare function createDecipher(sharedSecret: Buffer): crypto.Decipheriv;
+/**
+ * Generate a random shared secret (16 bytes).
+ */
+export declare function generateSharedSecret(): Buffer;
+/**
+ * Encrypt the shared secret with the server's public key (RSA PKCS1).
+ */
+export declare function encryptRSA(publicKeyDer: Buffer, data: Buffer): Buffer;
+/**
+ * Compute the "server hash" for Minecraft authentication.
+ * Minecraft uses a non-standard hex digest (Notch's twos-complement hex).
+ */
+export declare function computeServerHash(serverId: string, sharedSecret: Buffer, publicKey: Buffer): string;
+//# sourceMappingURL=encryption.d.ts.map

package/dist/protocol/encryption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption.d.ts","sourceRoot":"","sources":["../../src/protocol/encryption.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAIjC;;GAEG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,mBAEhD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,qBAElD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAcrE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAQnG"}

package/dist/protocol/encryption.js

@@ -0,0 +1,116 @@
+"use strict";
+/**
+ * AES/CFB8 Encryption for Minecraft protocol.
+ *
+ * Minecraft uses AES/CFB8 encryption for all packets after the Encryption Response.
+ * Both the key and IV are the shared secret (16 bytes).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCipher = createCipher;
+exports.createDecipher = createDecipher;
+exports.generateSharedSecret = generateSharedSecret;
+exports.encryptRSA = encryptRSA;
+exports.computeServerHash = computeServerHash;
+const crypto = __importStar(require("crypto"));
+const ALGORITHM = 'aes-128-cfb8';
+/**
+ * Create a cipher transform for encrypting outgoing data.
+ */
+function createCipher(sharedSecret) {
+    return crypto.createCipheriv(ALGORITHM, sharedSecret, sharedSecret);
+}
+/**
+ * Create a decipher transform for decrypting incoming data.
+ */
+function createDecipher(sharedSecret) {
+    return crypto.createDecipheriv(ALGORITHM, sharedSecret, sharedSecret);
+}
+/**
+ * Generate a random shared secret (16 bytes).
+ */
+function generateSharedSecret() {
+    return crypto.randomBytes(16);
+}
+/**
+ * Encrypt the shared secret with the server's public key (RSA PKCS1).
+ */
+function encryptRSA(publicKeyDer, data) {
+    const publicKey = crypto.createPublicKey({
+        key: publicKeyDer,
+        format: 'der',
+        type: 'spki',
+    });
+    return crypto.publicEncrypt({
+        key: publicKey,
+        padding: crypto.constants.RSA_PKCS1_PADDING,
+    }, data);
+}
+/**
+ * Compute the "server hash" for Minecraft authentication.
+ * Minecraft uses a non-standard hex digest (Notch's twos-complement hex).
+ */
+function computeServerHash(serverId, sharedSecret, publicKey) {
+    const hash = crypto.createHash('sha1');
+    hash.update(serverId);
+    hash.update(sharedSecret);
+    hash.update(publicKey);
+    const digest = hash.digest();
+    return minecraftHexDigest(digest);
+}
+/**
+ * Minecraft's non-standard hex digest.
+ * If the most significant bit is set, the value is negative (two's complement).
+ */
+function minecraftHexDigest(buffer) {
+    const isNegative = (buffer[0] & 0x80) !== 0;
+    if (isNegative) {
+        // Two's complement
+        let carry = true;
+        const flipped = Buffer.alloc(buffer.length);
+        for (let i = buffer.length - 1; i >= 0; i--) {
+            let byte = ~buffer[i] & 0xFF;
+            if (carry) {
+                byte++;
+                carry = byte > 0xFF;
+                byte &= 0xFF;
+            }
+            flipped[i] = byte;
+        }
+        return '-' + flipped.toString('hex').replace(/^0+/, '');
+    }
+    return buffer.toString('hex').replace(/^0+/, '');
+}
+//# sourceMappingURL=encryption.js.map

package/dist/protocol/encryption.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption.js","sourceRoot":"","sources":["../../src/protocol/encryption.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AASH,oCAEC;AAKD,wCAEC;AAKD,oDAEC;AAKD,gCAcC;AAMD,8CAQC;AAxDD,+CAAiC;AAEjC,MAAM,SAAS,GAAG,cAAc,CAAC;AAEjC;;GAEG;AACH,SAAgB,YAAY,CAAC,YAAoB;IAC7C,OAAO,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,YAAoB;IAC/C,OAAO,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;AAC1E,CAAC;AAED;;GAEG;AACH,SAAgB,oBAAoB;IAChC,OAAO,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,UAAU,CAAC,YAAoB,EAAE,IAAY;IACzD,MAAM,SAAS,GAAG,MAAM,CAAC,eAAe,CAAC;QACrC,GAAG,EAAE,YAAY;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,MAAM;KACf,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,aAAa,CACvB;QACI,GAAG,EAAE,SAAS;QACd,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,iBAAiB;KAC9C,EACD,IAAI,CACP,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,QAAgB,EAAE,YAAoB,EAAE,SAAiB;IACvF,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACtB,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACvB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAE7B,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,SAAS,kBAAkB,CAAC,MAAc;IACtC,MAAM,UAAU,GAAG,CAAC,MAAM,CAAC,CAAC,CAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAE7C,IAAI,UAAU,EAAE,CAAC;QACb,mBAAmB;QACnB,IAAI,KAAK,GAAG,IAAI,CAAC;QACjB,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5C,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAE,GAAG,IAAI,CAAC;YAC9B,IAAI,KAAK,EAAE,CAAC;gBACR,IAAI,EAAE,CAAC;gBACP,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC;gBACpB,IAAI,IAAI,IAAI,CAAC;YACjB,CAAC;YACD,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QACtB,CAAC;QACD,OAAO,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACrD,CAAC"}

package/dist/protocol/packet.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Packet definitions and serialization/deserialization.
+ *
+ * Each Minecraft packet has:
+ * - Length (VarInt) — total byte size of packetId + data
+ * - Packet ID (VarInt)
+ * - Data (varies per packet)
+ */
+import { BufferReader } from './types.js';
+/** Protocol states */
+export declare enum ProtocolState {
+    HANDSHAKING = 0,
+    STATUS = 1,
+    LOGIN = 2,
+    CONFIGURATION = 3,
+    PLAY = 4
+}
+/** Packet direction */
+export declare enum PacketDirection {
+    SERVERBOUND = "serverbound",
+    CLIENTBOUND = "clientbound"
+}
+/** Raw packet structure */
+export interface RawPacket {
+    id: number;
+    data: Buffer;
+}
+/**
+ * Frame a packet for sending over the wire.
+ * Format: [Length VarInt][Packet ID VarInt][Data]
+ */
+export declare function framePacket(packetId: number, data: Buffer): Buffer;
+/**
+ * Frame a packet with compression.
+ * Format when compressed:   [Packet Length][Data Length][Compressed(Packet ID + Data)]
+ * Format when uncompressed: [Packet Length][0][Packet ID + Data]
+ */
+export declare function framePacketCompressed(packetId: number, data: Buffer, threshold: number, compress: (data: Buffer) => Buffer): Buffer;
+/**
+ * PacketSplitter — accumulates incoming TCP data and splits into individual packet frames.
+ * Handles the length-prefixed framing used by Minecraft protocol.
+ */
+export declare class PacketSplitter {
+    private buffer;
+    /**
+     * Feed raw TCP data into the splitter.
+     * Returns an array of complete packet buffers (each containing [Packet ID VarInt][Data]).
+     */
+    feed(data: Buffer): Buffer[];
+    /** Reset the internal buffer */
+    reset(): void;
+}
+/**
+ * Parse a raw packet payload into id + data.
+ */
+export declare function parseRawPacket(payload: Buffer): RawPacket;
+/**
+ * PacketRegistry — maps packet IDs to names and handlers.
+ */
+export type PacketHandler = (reader: BufferReader) => Record<string, unknown>;
+export interface PacketDefinition {
+    name: string;
+    state: ProtocolState;
+    direction: PacketDirection;
+    id: number;
+    handler?: PacketHandler;
+}
+export declare class PacketRegistry {
+    private packets;
+    private makeKey;
+    register(def: PacketDefinition): void;
+    get(state: ProtocolState, direction: PacketDirection, id: number): PacketDefinition | undefined;
+    getByName(name: string): PacketDefinition | undefined;
+}
+//# sourceMappingURL=packet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"packet.d.ts","sourceRoot":"","sources":["../../src/protocol/packet.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAqD,MAAM,YAAY,CAAC;AAE7F,sBAAsB;AACtB,oBAAY,aAAa;IACrB,WAAW,IAAI;IACf,MAAM,IAAI;IACV,KAAK,IAAI;IACT,aAAa,IAAI;IACjB,IAAI,IAAI;CACX;AAED,uBAAuB;AACvB,oBAAY,eAAe;IACvB,WAAW,gBAAgB;IAC3B,WAAW,gBAAgB;CAC9B;AAED,2BAA2B;AAC3B,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKlE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,CAmBnI;AAED;;;GAGG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,MAAM,CAA2B;IAEzC;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAoC5B,gCAAgC;IAChC,KAAK,IAAI,IAAI;CAGhB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAIzD;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,YAAY,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9E,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,eAAe,CAAC;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,aAAa,CAAC;CAC3B;AAED,qBAAa,cAAc;IACvB,OAAO,CAAC,OAAO,CAAuC;IAEtD,OAAO,CAAC,OAAO;IAIf,QAAQ,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI;IAKrC,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI/F,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;CAMxD"}