specprotocol 1.0.0

package/dist/protocol/types.js

@@ -0,0 +1,495 @@
+"use strict";
+/**
+ * Minecraft Protocol Data Types
+ *
+ * Based on wiki.vg protocol specification.
+ * Handles VarInt, VarLong, String, and other Minecraft-specific binary encodings.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BufferWriter = exports.BufferReader = void 0;
+exports.readVarInt = readVarInt;
+exports.writeVarInt = writeVarInt;
+exports.varIntSize = varIntSize;
+exports.readVarLong = readVarLong;
+exports.writeVarLong = writeVarLong;
+exports.readString = readString;
+exports.writeString = writeString;
+exports.readUShort = readUShort;
+exports.writeUShort = writeUShort;
+exports.readInt = readInt;
+exports.writeInt = writeInt;
+exports.readLong = readLong;
+exports.writeLong = writeLong;
+exports.readFloat = readFloat;
+exports.writeFloat = writeFloat;
+exports.readDouble = readDouble;
+exports.writeDouble = writeDouble;
+exports.readBool = readBool;
+exports.writeBool = writeBool;
+exports.readUUID = readUUID;
+exports.writeUUID = writeUUID;
+exports.readByteArray = readByteArray;
+exports.writeByteArray = writeByteArray;
+exports.readRestBuffer = readRestBuffer;
+exports.readByte = readByte;
+exports.writeByte = writeByte;
+exports.readUByte = readUByte;
+exports.writeUByte = writeUByte;
+const SEGMENT_BITS = 0x7F;
+const CONTINUE_BIT = 0x80;
+/**
+ * Read a VarInt from a buffer at the given offset.
+ * VarInts are variable-length integers used extensively in Minecraft protocol.
+ * Max 5 bytes, encodes values up to 2^31.
+ */
+function readVarInt(buffer, offset = 0) {
+    let value = 0;
+    let position = 0;
+    let bytesRead = 0;
+    while (true) {
+        if (offset + bytesRead >= buffer.length) {
+            throw new Error('VarInt: buffer underflow — not enough bytes');
+        }
+        const currentByte = buffer[offset + bytesRead];
+        value |= (currentByte & SEGMENT_BITS) << position;
+        bytesRead++;
+        if ((currentByte & CONTINUE_BIT) === 0)
+            break;
+        position += 7;
+        if (position >= 32) {
+            throw new Error('VarInt is too big (> 5 bytes)');
+        }
+    }
+    // Convert to signed 32-bit integer
+    if (value > 0x7FFFFFFF) {
+        value -= 0x100000000;
+    }
+    return { value, bytesRead };
+}
+/**
+ * Write a VarInt to a Buffer.
+ */
+function writeVarInt(value) {
+    const bytes = [];
+    // Handle negative values (two's complement)
+    if (value < 0) {
+        value = value + 0x100000000;
+    }
+    while (true) {
+        if ((value & ~SEGMENT_BITS) === 0) {
+            bytes.push(value);
+            break;
+        }
+        bytes.push((value & SEGMENT_BITS) | CONTINUE_BIT);
+        value >>>= 7;
+    }
+    return Buffer.from(bytes);
+}
+/**
+ * Get the byte size of a VarInt value.
+ */
+function varIntSize(value) {
+    if (value < 0)
+        value += 0x100000000;
+    if (value < 0x80)
+        return 1;
+    if (value < 0x4000)
+        return 2;
+    if (value < 0x200000)
+        return 3;
+    if (value < 0x10000000)
+        return 4;
+    return 5;
+}
+/**
+ * Read a VarLong from a buffer at the given offset.
+ * VarLongs encode 64-bit values, up to 10 bytes.
+ */
+function readVarLong(buffer, offset = 0) {
+    let value = 0n;
+    let position = 0n;
+    let bytesRead = 0;
+    while (true) {
+        if (offset + bytesRead >= buffer.length) {
+            throw new Error('VarLong: buffer underflow');
+        }
+        const currentByte = buffer[offset + bytesRead];
+        value |= BigInt(currentByte & SEGMENT_BITS) << position;
+        bytesRead++;
+        if ((currentByte & CONTINUE_BIT) === 0)
+            break;
+        position += 7n;
+        if (position >= 64n) {
+            throw new Error('VarLong is too big (> 10 bytes)');
+        }
+    }
+    return { value, bytesRead };
+}
+/**
+ * Write a VarLong to a Buffer.
+ */
+function writeVarLong(value) {
+    const bytes = [];
+    while (true) {
+        if ((value & ~BigInt(SEGMENT_BITS)) === 0n) {
+            bytes.push(Number(value));
+            break;
+        }
+        bytes.push(Number((value & BigInt(SEGMENT_BITS)) | BigInt(CONTINUE_BIT)));
+        value >>= 7n;
+    }
+    return Buffer.from(bytes);
+}
+/**
+ * Read a length-prefixed UTF-8 string from a buffer.
+ */
+function readString(buffer, offset = 0) {
+    const { value: length, bytesRead: lenBytes } = readVarInt(buffer, offset);
+    if (length < 0 || length > 32767 * 4) {
+        throw new Error(`String length out of range: ${length}`);
+    }
+    const strStart = offset + lenBytes;
+    if (strStart + length > buffer.length) {
+        throw new Error('String: buffer underflow');
+    }
+    const value = buffer.subarray(strStart, strStart + length).toString('utf-8');
+    return { value, bytesRead: lenBytes + length };
+}
+/**
+ * Write a length-prefixed UTF-8 string to a Buffer.
+ */
+function writeString(value) {
+    const strBuf = Buffer.from(value, 'utf-8');
+    const lenBuf = writeVarInt(strBuf.length);
+    return Buffer.concat([lenBuf, strBuf]);
+}
+/**
+ * Read a 16-bit unsigned short from a buffer (Big Endian).
+ */
+function readUShort(buffer, offset = 0) {
+    if (offset + 2 > buffer.length)
+        throw new Error('UShort: buffer underflow');
+    return { value: buffer.readUInt16BE(offset), bytesRead: 2 };
+}
+/**
+ * Write a 16-bit unsigned short to a Buffer (Big Endian).
+ */
+function writeUShort(value) {
+    const buf = Buffer.alloc(2);
+    buf.writeUInt16BE(value, 0);
+    return buf;
+}
+/**
+ * Read a 32-bit signed integer from a buffer (Big Endian).
+ */
+function readInt(buffer, offset = 0) {
+    if (offset + 4 > buffer.length)
+        throw new Error('Int: buffer underflow');
+    return { value: buffer.readInt32BE(offset), bytesRead: 4 };
+}
+/**
+ * Write a 32-bit signed integer (Big Endian).
+ */
+function writeInt(value) {
+    const buf = Buffer.alloc(4);
+    buf.writeInt32BE(value, 0);
+    return buf;
+}
+/**
+ * Read a 64-bit signed long from a buffer (Big Endian).
+ */
+function readLong(buffer, offset = 0) {
+    if (offset + 8 > buffer.length)
+        throw new Error('Long: buffer underflow');
+    return { value: buffer.readBigInt64BE(offset), bytesRead: 8 };
+}
+/**
+ * Write a 64-bit signed long (Big Endian).
+ */
+function writeLong(value) {
+    const buf = Buffer.alloc(8);
+    buf.writeBigInt64BE(value, 0);
+    return buf;
+}
+/**
+ * Read a 32-bit float from a buffer (Big Endian).
+ */
+function readFloat(buffer, offset = 0) {
+    if (offset + 4 > buffer.length)
+        throw new Error('Float: buffer underflow');
+    return { value: buffer.readFloatBE(offset), bytesRead: 4 };
+}
+/**
+ * Write a 32-bit float (Big Endian).
+ */
+function writeFloat(value) {
+    const buf = Buffer.alloc(4);
+    buf.writeFloatBE(value, 0);
+    return buf;
+}
+/**
+ * Read a 64-bit double from a buffer (Big Endian).
+ */
+function readDouble(buffer, offset = 0) {
+    if (offset + 8 > buffer.length)
+        throw new Error('Double: buffer underflow');
+    return { value: buffer.readDoubleBE(offset), bytesRead: 8 };
+}
+/**
+ * Write a 64-bit double (Big Endian).
+ */
+function writeDouble(value) {
+    const buf = Buffer.alloc(8);
+    buf.writeDoubleBE(value, 0);
+    return buf;
+}
+/**
+ * Read a boolean from a buffer.
+ */
+function readBool(buffer, offset = 0) {
+    if (offset >= buffer.length)
+        throw new Error('Bool: buffer underflow');
+    return { value: buffer[offset] !== 0, bytesRead: 1 };
+}
+/**
+ * Write a boolean to a Buffer.
+ */
+function writeBool(value) {
+    return Buffer.from([value ? 0x01 : 0x00]);
+}
+/**
+ * Read a UUID (128-bit) from a buffer.
+ */
+function readUUID(buffer, offset = 0) {
+    if (offset + 16 > buffer.length)
+        throw new Error('UUID: buffer underflow');
+    const hex = buffer.subarray(offset, offset + 16).toString('hex');
+    const uuid = `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+    return { value: uuid, bytesRead: 16 };
+}
+/**
+ * Write a UUID string to a Buffer (128-bit).
+ */
+function writeUUID(uuid) {
+    const hex = uuid.replace(/-/g, '');
+    if (hex.length !== 32)
+        throw new Error(`Invalid UUID: ${uuid}`);
+    return Buffer.from(hex, 'hex');
+}
+/**
+ * Read a byte array prefixed with VarInt length.
+ */
+function readByteArray(buffer, offset = 0) {
+    const { value: length, bytesRead: lenBytes } = readVarInt(buffer, offset);
+    const start = offset + lenBytes;
+    if (start + length > buffer.length)
+        throw new Error('ByteArray: buffer underflow');
+    return { value: buffer.subarray(start, start + length), bytesRead: lenBytes + length };
+}
+/**
+ * Write a byte array prefixed with VarInt length.
+ */
+function writeByteArray(data) {
+    const lenBuf = writeVarInt(data.length);
+    return Buffer.concat([lenBuf, data]);
+}
+/**
+ * Read remaining bytes from an offset to end of buffer.
+ */
+function readRestBuffer(buffer, offset = 0) {
+    const value = buffer.subarray(offset);
+    return { value, bytesRead: value.length };
+}
+/**
+ * Read a signed byte (-128 to 127).
+ */
+function readByte(buffer, offset = 0) {
+    if (offset >= buffer.length)
+        throw new Error('Byte: buffer underflow');
+    return { value: buffer.readInt8(offset), bytesRead: 1 };
+}
+/**
+ * Write a signed byte.
+ */
+function writeByte(value) {
+    const buf = Buffer.alloc(1);
+    buf.writeInt8(value, 0);
+    return buf;
+}
+/**
+ * Read an unsigned byte (0 to 255).
+ */
+function readUByte(buffer, offset = 0) {
+    if (offset >= buffer.length)
+        throw new Error('UByte: buffer underflow');
+    return { value: buffer.readUInt8(offset), bytesRead: 1 };
+}
+/**
+ * Write an unsigned byte.
+ */
+function writeUByte(value) {
+    const buf = Buffer.alloc(1);
+    buf.writeUInt8(value, 0);
+    return buf;
+}
+/**
+ * BufferReader — a stateful cursor-based reader for sequential reads.
+ */
+class BufferReader {
+    buffer;
+    offset = 0;
+    constructor(buffer) {
+        this.buffer = buffer;
+    }
+    get remaining() {
+        return this.buffer.length - this.offset;
+    }
+    get position() {
+        return this.offset;
+    }
+    readVarInt() {
+        const result = readVarInt(this.buffer, this.offset);
+        this.offset += result.bytesRead;
+        return result.value;
+    }
+    readVarLong() {
+        const result = readVarLong(this.buffer, this.offset);
+        this.offset += result.bytesRead;
+        return result.value;
+    }
+    readString() {
+        const result = readString(this.buffer, this.offset);
+        this.offset += result.bytesRead;
+        return result.value;
+    }
+    readUShort() {
+        const result = readUShort(this.buffer, this.offset);
+        this.offset += result.bytesRead;
+        return result.value;
+    }
+    readInt() {
+        const result = readInt(this.buffer, this.offset);
+        this.offset += result.bytesRead;
+        return result.value;
+    }
+    readLong() {
+        const result = readLong(this.buffer, this.offset);
+        this.offset += result.bytesRead;
+        return result.value;
+    }
+    readFloat() {
+        const result = readFloat(this.buffer, this.offset);
+        this.offset += result.bytesRead;
+        return result.value;
+    }
+    readDouble() {
+        const result = readDouble(this.buffer, this.offset);
+        this.offset += result.bytesRead;
+        return result.value;
+    }
+    readBool() {
+        const result = readBool(this.buffer, this.offset);
+        this.offset += result.bytesRead;
+        return result.value;
+    }
+    readUUID() {
+        const result = readUUID(this.buffer, this.offset);
+        this.offset += result.bytesRead;
+        return result.value;
+    }
+    readByteArray() {
+        const result = readByteArray(this.buffer, this.offset);
+        this.offset += result.bytesRead;
+        return result.value;
+    }
+    readByte() {
+        const result = readByte(this.buffer, this.offset);
+        this.offset += result.bytesRead;
+        return result.value;
+    }
+    readUByte() {
+        const result = readUByte(this.buffer, this.offset);
+        this.offset += result.bytesRead;
+        return result.value;
+    }
+    readBytes(count) {
+        if (this.offset + count > this.buffer.length)
+            throw new Error('readBytes: buffer underflow');
+        const value = this.buffer.subarray(this.offset, this.offset + count);
+        this.offset += count;
+        return value;
+    }
+    readRestBuffer() {
+        const result = readRestBuffer(this.buffer, this.offset);
+        this.offset += result.bytesRead;
+        return result.value;
+    }
+}
+exports.BufferReader = BufferReader;
+/**
+ * BufferWriter — a stateful buffer builder for sequential writes.
+ */
+class BufferWriter {
+    parts = [];
+    writeVarInt(value) {
+        this.parts.push(writeVarInt(value));
+        return this;
+    }
+    writeVarLong(value) {
+        this.parts.push(writeVarLong(value));
+        return this;
+    }
+    writeString(value) {
+        this.parts.push(writeString(value));
+        return this;
+    }
+    writeUShort(value) {
+        this.parts.push(writeUShort(value));
+        return this;
+    }
+    writeInt(value) {
+        this.parts.push(writeInt(value));
+        return this;
+    }
+    writeLong(value) {
+        this.parts.push(writeLong(value));
+        return this;
+    }
+    writeFloat(value) {
+        this.parts.push(writeFloat(value));
+        return this;
+    }
+    writeDouble(value) {
+        this.parts.push(writeDouble(value));
+        return this;
+    }
+    writeBool(value) {
+        this.parts.push(writeBool(value));
+        return this;
+    }
+    writeUUID(uuid) {
+        this.parts.push(writeUUID(uuid));
+        return this;
+    }
+    writeByteArray(data) {
+        this.parts.push(writeByteArray(data));
+        return this;
+    }
+    writeByte(value) {
+        this.parts.push(writeByte(value));
+        return this;
+    }
+    writeUByte(value) {
+        this.parts.push(writeUByte(value));
+        return this;
+    }
+    writeBytes(data) {
+        this.parts.push(data);
+        return this;
+    }
+    toBuffer() {
+        return Buffer.concat(this.parts);
+    }
+}
+exports.BufferWriter = BufferWriter;
+//# sourceMappingURL=types.js.map

package/dist/protocol/types.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Shared types used across modules to avoid circular dependencies.
+ */
+import type { Vec3 } from './utils/vec3.js';
+import type { Entity, EntityManager } from './entity/entity.js';
+import type { World } from './world/world.js';
+import type { PluginManager } from './plugins/plugin-manager.js';
+/**
+ * The interface that plugins see when interacting with the Bot.
+ * This breaks the circular dependency between bot.ts and plugin files.
+ */
+export interface BotAPI {
+    readonly username: string;
+    readonly uuid: string;
+    readonly entityId: number;
+    readonly health: number;
+    readonly food: number;
+    readonly saturation: number;
+    readonly gameMode: number;
+    readonly isAlive: boolean;
+    readonly position: Vec3;
+    readonly entity: Entity;
+    readonly world: World;
+    readonly entities: EntityManager;
+    readonly plugins: PluginManager;
+    sendPacket(packetId: number, data: Buffer): void;
+    onPacket(packetId: number, handler: (data: Buffer) => void): void;
+    chat(message: string): void;
+    attack(entity: Entity): void;
+    lookAt(target: Vec3): void;
+    disconnect(): void;
+    on(event: string, listener: (...args: any[]) => void): any;
+    once(event: string, listener: (...args: any[]) => void): any;
+    emit(event: string, ...args: any[]): boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE;;;GAGG;AACH,MAAM,WAAW,MAAM;IAEnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAGhC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAClE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,CAAC;IAC3B,UAAU,IAAI,IAAI,CAAC;IAGnB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,GAAG,CAAC;IAC3D,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,GAAG,CAAC;IAC7D,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;CAChD"}

package/dist/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Shared types used across modules to avoid circular dependencies.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/utils/events.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Typed event emitter for type-safe event handling.
+ * Usage:
+ *   interface MyEvents {
+ *     'chat': (message: string, sender: string) => void;
+ *     'spawn': (entityId: number) => void;
+ *   }
+ *   const emitter = new TypedEventEmitter<MyEvents>();
+ *   emitter.on('chat', (msg, sender) => { ... }); // fully typed
+ */
+export declare class TypedEventEmitter<TEvents extends {
+    [K in keyof TEvents]: (...args: any[]) => void;
+}> {
+    private emitter;
+    constructor();
+    on<K extends keyof TEvents & string>(event: K, listener: TEvents[K]): this;
+    once<K extends keyof TEvents & string>(event: K, listener: TEvents[K]): this;
+    off<K extends keyof TEvents & string>(event: K, listener: TEvents[K]): this;
+    emit<K extends keyof TEvents & string>(event: K, ...args: Parameters<TEvents[K]>): boolean;
+    removeAllListeners<K extends keyof TEvents & string>(event?: K): this;
+    listenerCount<K extends keyof TEvents & string>(event: K): number;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/utils/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/utils/events.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,qBAAa,iBAAiB,CAC1B,OAAO,SAAS;KAAG,CAAC,IAAI,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI;CAAE;IAElE,OAAO,CAAC,OAAO,CAAsB;;IAMrC,EAAE,CAAC,CAAC,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAK1E,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAK5E,GAAG,CAAC,CAAC,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAK3E,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO;IAI1F,kBAAkB,CAAC,CAAC,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI;IAKrE,aAAa,CAAC,CAAC,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM;CAGpE"}

package/dist/utils/events.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypedEventEmitter = void 0;
+const events_1 = require("events");
+/**
+ * Typed event emitter for type-safe event handling.
+ * Usage:
+ *   interface MyEvents {
+ *     'chat': (message: string, sender: string) => void;
+ *     'spawn': (entityId: number) => void;
+ *   }
+ *   const emitter = new TypedEventEmitter<MyEvents>();
+ *   emitter.on('chat', (msg, sender) => { ... }); // fully typed
+ */
+class TypedEventEmitter {
+    emitter = new events_1.EventEmitter();
+    constructor() {
+        this.emitter.setMaxListeners(100);
+    }
+    on(event, listener) {
+        this.emitter.on(event, listener);
+        return this;
+    }
+    once(event, listener) {
+        this.emitter.once(event, listener);
+        return this;
+    }
+    off(event, listener) {
+        this.emitter.off(event, listener);
+        return this;
+    }
+    emit(event, ...args) {
+        return this.emitter.emit(event, ...args);
+    }
+    removeAllListeners(event) {
+        this.emitter.removeAllListeners(event);
+        return this;
+    }
+    listenerCount(event) {
+        return this.emitter.listenerCount(event);
+    }
+}
+exports.TypedEventEmitter = TypedEventEmitter;
+//# sourceMappingURL=events.js.map

package/dist/utils/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/utils/events.ts"],"names":[],"mappings":";;;AAAA,mCAAsC;AAEtC;;;;;;;;;GASG;AACH,MAAa,iBAAiB;IAGlB,OAAO,GAAG,IAAI,qBAAY,EAAE,CAAC;IAErC;QACI,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IAED,EAAE,CAAmC,KAAQ,EAAE,QAAoB;QAC/D,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAoC,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,CAAmC,KAAQ,EAAE,QAAoB;QACjE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,QAAoC,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,GAAG,CAAmC,KAAQ,EAAE,QAAoB;QAChE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAoC,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,CAAmC,KAAQ,EAAE,GAAG,IAA4B;QAC5E,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,kBAAkB,CAAmC,KAAS;QAC1D,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,aAAa,CAAmC,KAAQ;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;CACJ;AApCD,8CAoCC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,19 @@
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    NONE = 4
+}
+export declare class Logger {
+    private level;
+    private prefix;
+    constructor(prefix: string, level?: LogLevel);
+    setLevel(level: LogLevel): void;
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    private timestamp;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,oBAAY,QAAQ;IAChB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;IACT,IAAI,IAAI;CACX;AAED,qBAAa,MAAM;IACf,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,QAAwB;IAK3D,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMhD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMhD,OAAO,CAAC,SAAS;CAGpB"}