cubyz-node-client 1.0.1 → 1.2.0

package/dist/connectionTypes.d.ts

@@ -0,0 +1,141 @@
+import type { Buffer } from "node:buffer";
+export declare const DEG_TO_RAD: number;
+export declare const LOG_LEVEL_ORDER: {
+    readonly debug: 0;
+    readonly info: 1;
+    readonly warn: 2;
+    readonly error: 3;
+    readonly silent: 4;
+};
+export declare const ENTITY_POSITION_TYPE: {
+    readonly NO_VELOCITY_ENTITY: 0;
+    readonly F16_VELOCITY_ENTITY: 1;
+    readonly F32_VELOCITY_ENTITY: 2;
+    readonly NO_VELOCITY_ITEM: 3;
+    readonly F16_VELOCITY_ITEM: 4;
+    readonly F32_VELOCITY_ITEM: 5;
+};
+export type EntityPositionType = (typeof ENTITY_POSITION_TYPE)[keyof typeof ENTITY_POSITION_TYPE];
+export type LogLevel = keyof typeof LOG_LEVEL_ORDER;
+export interface Vector3 {
+    x: number;
+    y: number;
+    z: number;
+}
+export interface PlayerState {
+    position: Vector3;
+    velocity: Vector3;
+    rotation: Vector3;
+}
+export interface EntitySnapshot {
+    id: number;
+    position: Vector3;
+    velocity: Vector3;
+    rotation: Vector3;
+    timestamp: number;
+}
+export interface ItemSnapshot {
+    index: number;
+    position: Vector3;
+    velocity: Vector3;
+    timestamp: number;
+}
+export interface BlockUpdate {
+    position: Vector3;
+    block: number;
+    blockEntityData: Buffer;
+}
+export declare const GENERIC_UPDATE_TYPE: {
+    readonly GAMEMODE: 0;
+    readonly TELEPORT: 1;
+    readonly WORLD_EDIT_POS: 2;
+    readonly TIME: 3;
+    readonly BIOME: 4;
+};
+export type GenericUpdateType = (typeof GENERIC_UPDATE_TYPE)[keyof typeof GENERIC_UPDATE_TYPE];
+export declare const GAMEMODE: {
+    readonly SURVIVAL: 0;
+    readonly CREATIVE: 1;
+};
+export type Gamemode = (typeof GAMEMODE)[keyof typeof GAMEMODE];
+export declare const WORLD_EDIT_POSITION: {
+    readonly SELECTED_POS1: 0;
+    readonly SELECTED_POS2: 1;
+    readonly CLEAR: 2;
+};
+export type WorldEditPositionType = (typeof WORLD_EDIT_POSITION)[keyof typeof WORLD_EDIT_POSITION];
+export interface GamemodeUpdate {
+    type: "gamemode";
+    gamemode: Gamemode;
+}
+export interface TeleportUpdate {
+    type: "teleport";
+    position: Vector3;
+}
+export interface WorldEditPosUpdate {
+    type: "worldEditPos";
+    positionType: WorldEditPositionType;
+    position: Vector3 | null;
+}
+export interface TimeUpdate {
+    type: "time";
+    time: bigint;
+}
+export interface BiomeUpdate {
+    type: "biome";
+    biomeId: number;
+}
+export type GenericUpdate = GamemodeUpdate | TeleportUpdate | WorldEditPosUpdate | TimeUpdate | BiomeUpdate;
+export interface EntityPositionPacket {
+    timestamp: number;
+    basePosition: Vector3;
+    entities: EntitySnapshot[];
+    items: ItemSnapshot[];
+}
+export interface ProtocolEvent {
+    channelId: number;
+    protocolId: number;
+    payload: Buffer;
+}
+export interface CubyzConnectionLogger {
+    info?: (...args: unknown[]) => void;
+    warn?: (...args: unknown[]) => void;
+    error?: (...args: unknown[]) => void;
+    debug?: (...args: unknown[]) => void;
+}
+export interface CubyzConnectionOptions {
+    host: string;
+    port: number;
+    name: string;
+    version?: string;
+    logger?: CubyzConnectionLogger;
+    logLevel?: LogLevel;
+}
+export interface CloseOptions {
+    notify?: boolean;
+}
+export type ConnectionState = "awaitingServer" | "connected" | "closing" | "closed";
+export interface PendingConfirmation {
+    channelId: number;
+    start: number;
+    timestamp: number;
+}
+export type CubyzConnectionEvents = {
+    connected: [];
+    handshakeComplete: [string];
+    chat: [string];
+    blockUpdate: [BlockUpdate[]];
+    players: [PlayersEvent];
+    entityPositions: [EntityPositionPacket];
+    genericUpdate: [GenericUpdate];
+    protocol: [ProtocolEvent];
+    disconnect: [DisconnectEvent];
+};
+export interface DisconnectEvent {
+    reason: "server" | "timeout";
+}
+export type PlayersEvent = PlayerData[];
+export interface PlayerData {
+    id: number;
+    name: string;
+}

package/dist/connectionTypes.js

@@ -0,0 +1,33 @@
+export const DEG_TO_RAD = Math.PI / 180;
+export const LOG_LEVEL_ORDER = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    silent: 4,
+};
+export const ENTITY_POSITION_TYPE = {
+    NO_VELOCITY_ENTITY: 0,
+    F16_VELOCITY_ENTITY: 1,
+    F32_VELOCITY_ENTITY: 2,
+    NO_VELOCITY_ITEM: 3,
+    F16_VELOCITY_ITEM: 4,
+    F32_VELOCITY_ITEM: 5,
+};
+export const GENERIC_UPDATE_TYPE = {
+    GAMEMODE: 0,
+    TELEPORT: 1,
+    WORLD_EDIT_POS: 2,
+    TIME: 3,
+    BIOME: 4,
+};
+export const GAMEMODE = {
+    SURVIVAL: 0,
+    CREATIVE: 1,
+};
+export const WORLD_EDIT_POSITION = {
+    SELECTED_POS1: 0,
+    SELECTED_POS2: 1,
+    CLEAR: 2,
+};
+//# sourceMappingURL=connectionTypes.js.map

package/dist/connectionTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectionTypes.js","sourceRoot":"","sources":["../src/connectionTypes.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC;AAExC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;CACD,CAAC;AAEX,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,kBAAkB,EAAE,CAAC;IACrB,mBAAmB,EAAE,CAAC;IACtB,mBAAmB,EAAE,CAAC;IACtB,gBAAgB,EAAE,CAAC;IACnB,iBAAiB,EAAE,CAAC;IACpB,iBAAiB,EAAE,CAAC;CACZ,CAAC;AAwCX,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,CAAC;IACX,cAAc,EAAE,CAAC;IACjB,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACA,CAAC;AAKX,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,CAAC;CACH,CAAC;AAIX,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,aAAa,EAAE,CAAC;IAChB,aAAa,EAAE,CAAC;IAChB,KAAK,EAAE,CAAC;CACA,CAAC"}

package/dist/constants.d.ts

@@ -11,9 +11,11 @@ export type ChannelId = (typeof CHANNEL)[keyof typeof CHANNEL];
 export type SequencedChannelId = typeof CHANNEL.LOSSY | typeof CHANNEL.FAST | typeof CHANNEL.SLOW;
 export declare const PROTOCOL: {
     readonly HANDSHAKE: 1;
+    readonly PLAYER_STATE: 4;
     readonly ENTITY_POSITION: 6;
+    readonly BLOCK_UPDATE: 7;
     readonly ENTITY: 8;
-    readonly PLAYER_STATE: 4;
+    readonly GENERIC_UPDATE: 9;
     readonly CHAT: 10;
 };
 export type ProtocolId = (typeof PROTOCOL)[keyof typeof PROTOCOL];

package/dist/constants.js

@@ -9,9 +9,11 @@ export const CHANNEL = {
 };
 export const PROTOCOL = {
     HANDSHAKE: 1,
+    PLAYER_STATE: 4,
     ENTITY_POSITION: 6,
+    BLOCK_UPDATE: 7,
     ENTITY: 8,
-    PLAYER_STATE: 4,
+    GENERIC_UPDATE: 9,
     CHAT: 10,
 };
 export const HANDSHAKE_STATE = {

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,YAAY,EAAE,CAAC;IACf,IAAI,EAAE,CAAC;IACP,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,CAAC;CACL,CAAC;AAQX,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,SAAS,EAAE,CAAC;IACZ,eAAe,EAAE,CAAC;IAClB,MAAM,EAAE,CAAC;IACT,YAAY,EAAE,CAAC;IACf,IAAI,EAAE,EAAE;CACA,CAAC;AAIX,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,KAAK,EAAE,CAAC;IACR,SAAS,EAAE,CAAC;IACZ,MAAM,EAAE,CAAC;IACT,WAAW,EAAE,CAAC;IACd,QAAQ,EAAE,GAAG;CACL,CAAC;AAKX,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC;AAClC,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AAEvC,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AACrC,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAC3C,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAC1C,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAC3C,MAAM,CAAC,MAAM,qBAAqB,GAAG,sBAAsB,GAAG,CAAC,CAAC;AAChE,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC;AACjD,MAAM,CAAC,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,6CAA6C"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,YAAY,EAAE,CAAC;IACf,IAAI,EAAE,CAAC;IACP,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,CAAC;CACL,CAAC;AAQX,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,SAAS,EAAE,CAAC;IACZ,YAAY,EAAE,CAAC;IACf,eAAe,EAAE,CAAC;IAClB,YAAY,EAAE,CAAC;IACf,MAAM,EAAE,CAAC;IACT,cAAc,EAAE,CAAC;IACjB,IAAI,EAAE,EAAE;CACA,CAAC;AAIX,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,KAAK,EAAE,CAAC;IACR,SAAS,EAAE,CAAC;IACZ,MAAM,EAAE,CAAC;IACT,WAAW,EAAE,CAAC;IACd,QAAQ,EAAE,GAAG;CACL,CAAC;AAKX,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC;AAClC,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AAEvC,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AACrC,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAC3C,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAC1C,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAC3C,MAAM,CAAC,MAAM,qBAAqB,GAAG,sBAAsB,GAAG,CAAC,CAAC;AAChE,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC;AACjD,MAAM,CAAC,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,6CAA6C"}

package/dist/entityParser.d.ts

@@ -0,0 +1,4 @@
+import type { Buffer } from "node:buffer";
+import { type EntityPositionPacket, type LogLevel } from "./connectionTypes.js";
+export type EntityParserLogger = (level: LogLevel, ...args: unknown[]) => void;
+export declare function parseEntityPositionPacket(payload: Buffer, log: EntityParserLogger): EntityPositionPacket | null;

package/dist/entityParser.js

@@ -0,0 +1,143 @@
+import { readFloat16BE } from "./binary.js";
+import { ENTITY_POSITION_TYPE, } from "./connectionTypes.js";
+export function parseEntityPositionPacket(payload, log) {
+    const headerSize = 2 + 8 * 3;
+    if (payload.length < headerSize) {
+        log("warn", "Entity position payload too short", {
+            length: payload.length,
+        });
+        return null;
+    }
+    let offset = 0;
+    const ensure = (size) => {
+        if (offset + size > payload.length) {
+            throw new Error(`Entity position packet truncated, needed ${size} bytes at offset ${offset}`);
+        }
+    };
+    const readVec3f32 = () => {
+        ensure(12);
+        const vector = {
+            x: payload.readFloatBE(offset),
+            y: payload.readFloatBE(offset + 4),
+            z: payload.readFloatBE(offset + 8),
+        };
+        offset += 12;
+        return vector;
+    };
+    const readVec3f16 = () => {
+        ensure(6);
+        const vector = {
+            x: readFloat16BE(payload, offset),
+            y: readFloat16BE(payload, offset + 2),
+            z: readFloat16BE(payload, offset + 4),
+        };
+        offset += 6;
+        return vector;
+    };
+    try {
+        ensure(2);
+        const timestamp = payload.readInt16BE(offset);
+        offset += 2;
+        ensure(24);
+        const basePosition = {
+            x: payload.readDoubleBE(offset),
+            y: payload.readDoubleBE(offset + 8),
+            z: payload.readDoubleBE(offset + 16),
+        };
+        offset += 24;
+        const nextEntityStates = new Map();
+        const nextItemStates = new Map();
+        const entitiesForEvent = [];
+        const itemsForEvent = [];
+        while (offset < payload.length) {
+            ensure(1);
+            const type = payload[offset];
+            offset += 1;
+            let velocity = { x: 0, y: 0, z: 0 };
+            if (type === ENTITY_POSITION_TYPE.F16_VELOCITY_ENTITY ||
+                type === ENTITY_POSITION_TYPE.F16_VELOCITY_ITEM) {
+                velocity = readVec3f16();
+            }
+            else if (type === ENTITY_POSITION_TYPE.F32_VELOCITY_ENTITY ||
+                type === ENTITY_POSITION_TYPE.F32_VELOCITY_ITEM) {
+                velocity = readVec3f32();
+            }
+            switch (type) {
+                case ENTITY_POSITION_TYPE.NO_VELOCITY_ENTITY:
+                case ENTITY_POSITION_TYPE.F16_VELOCITY_ENTITY:
+                case ENTITY_POSITION_TYPE.F32_VELOCITY_ENTITY: {
+                    ensure(4);
+                    const id = payload.readUInt32BE(offset);
+                    offset += 4;
+                    const delta = readVec3f32();
+                    const rotation = readVec3f32();
+                    const position = {
+                        x: basePosition.x + delta.x,
+                        y: basePosition.y + delta.y,
+                        z: basePosition.z + delta.z,
+                    };
+                    const state = {
+                        id,
+                        position,
+                        velocity,
+                        rotation,
+                        timestamp,
+                    };
+                    nextEntityStates.set(id, state);
+                    entitiesForEvent.push({
+                        id,
+                        position: { ...position },
+                        velocity: { ...velocity },
+                        rotation: { ...rotation },
+                        timestamp,
+                    });
+                    break;
+                }
+                case ENTITY_POSITION_TYPE.NO_VELOCITY_ITEM:
+                case ENTITY_POSITION_TYPE.F16_VELOCITY_ITEM:
+                case ENTITY_POSITION_TYPE.F32_VELOCITY_ITEM: {
+                    ensure(2);
+                    const index = payload.readUInt16BE(offset);
+                    offset += 2;
+                    const delta = readVec3f32();
+                    const position = {
+                        x: basePosition.x + delta.x,
+                        y: basePosition.y + delta.y,
+                        z: basePosition.z + delta.z,
+                    };
+                    const state = {
+                        index,
+                        position,
+                        velocity,
+                        timestamp,
+                    };
+                    nextItemStates.set(index, state);
+                    itemsForEvent.push({
+                        index,
+                        position: { ...position },
+                        velocity: { ...velocity },
+                        timestamp,
+                    });
+                    break;
+                }
+                default: {
+                    log("warn", "Unknown entity position entry type", { type });
+                    return null;
+                }
+            }
+        }
+        return {
+            timestamp,
+            basePosition: { ...basePosition },
+            entities: entitiesForEvent,
+            items: itemsForEvent,
+            _entityStates: nextEntityStates,
+            _itemStates: nextItemStates,
+        };
+    }
+    catch (err) {
+        log("warn", "Failed to decode entity position payload", err);
+        return null;
+    }
+}
+//# sourceMappingURL=entityParser.js.map

package/dist/entityParser.js.map

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

package/dist/handshakeUtils.d.ts

@@ -0,0 +1,10 @@
+import { Buffer } from "node:buffer";
+import { type HandshakeState } from "./constants.js";
+export declare function randomSequence(): number;
+export declare function escapeZonString(value: string): string;
+export declare function buildHandshakePayload(name: string, version: string): Buffer;
+export interface HandshakeMessage {
+    state: HandshakeState;
+    data: Buffer;
+}
+export declare function parseHandshake(payload: Buffer): HandshakeMessage;

package/dist/handshakeUtils.js

@@ -0,0 +1,24 @@
+import { Buffer } from "node:buffer";
+import { randomInt } from "node:crypto";
+import { HANDSHAKE_STATE } from "./constants.js";
+export function randomSequence() {
+    return randomInt(0, 0x7fffffff);
+}
+export function escapeZonString(value) {
+    return value.replaceAll("\\", "\\\\").replaceAll('"', '\\"');
+}
+export function buildHandshakePayload(name, version) {
+    const safeName = escapeZonString(name);
+    const safeVersion = escapeZonString(version);
+    const zon = `.{.version = "${safeVersion}", .name = "${safeName}"}`;
+    const prefix = Buffer.from([HANDSHAKE_STATE.USER_DATA]);
+    return Buffer.concat([prefix, Buffer.from(zon, "utf8")]);
+}
+export function parseHandshake(payload) {
+    if (!payload || payload.length === 0) {
+        throw new Error("Handshake payload empty");
+    }
+    const state = payload[0];
+    return { state, data: payload.slice(1) };
+}
+//# sourceMappingURL=handshakeUtils.js.map

package/dist/handshakeUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handshakeUtils.js","sourceRoot":"","sources":["../src/handshakeUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,eAAe,EAAuB,MAAM,gBAAgB,CAAC;AAEtE,MAAM,UAAU,cAAc;IAC5B,OAAO,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,OAAe;IACjE,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,iBAAiB,WAAW,eAAe,QAAQ,IAAI,CAAC;IACpE,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC;IACxD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC;AAOD,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAmB,CAAC;IAC3C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3C,CAAC"}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { addSeq, decodeVarInt, encodeVarInt, seqLessThan } from "./binary.js";
-export type { CloseOptions, CubyzConnectionLogger, CubyzConnectionOptions, DisconnectEvent, EntityPositionPacket, EntitySnapshot, ItemSnapshot, LogLevel, PlayerState, ProtocolEvent, Vector3, } from "./connection.js";
-export { CubyzConnection } from "./connection.js";
+export { countVisibleCharacters, prepareChatMessage } from "./chatFormat.js";
+export type { BiomeUpdate, BlockUpdate, CloseOptions, CubyzConnectionLogger, CubyzConnectionOptions, DisconnectEvent, EntityPositionPacket, EntitySnapshot, Gamemode, GamemodeUpdate, GenericUpdate, ItemSnapshot, LogLevel, PlayerState, ProtocolEvent, TeleportUpdate, TimeUpdate, Vector3, WorldEditPosUpdate, } from "./connection.js";
+export { CubyzConnection, GAMEMODE } from "./connection.js";
 export * from "./constants.js";
 export { ReceiveChannel } from "./receiveChannel.js";
 export { SendChannel } from "./sendChannel.js";

package/dist/index.js

@@ -1,5 +1,6 @@
 export { addSeq, decodeVarInt, encodeVarInt, seqLessThan } from "./binary.js";
-export { CubyzConnection } from "./connection.js";
+export { countVisibleCharacters, prepareChatMessage } from "./chatFormat.js";
+export { CubyzConnection, GAMEMODE } from "./connection.js";
 export * from "./constants.js";
 export { ReceiveChannel } from "./receiveChannel.js";
 export { SendChannel } from "./sendChannel.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAc9E,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAsB7E,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC5D,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cubyz-node-client",
-  "version": "1.0.1",
+  "version": "1.2.0",
   "description": "Cubyz Node.js Client Library",
   "type": "module",
   "main": "./dist/index.js",