@sanctumterra/raknet 1.4.5 → 1.4.6

package/dist/client/client.d.ts

@@ -12,7 +12,17 @@ export declare class Client extends EventEmitter<ClientEvents> {
     tick: number;
     private session;
     private gotReply1;
+    private proxySocket;
+    private proxyRelayHost;
+    private proxyRelayPort;
+    private resolvedAddress;
+    private proxyReady;
     constructor(options?: Partial<ClientOptions>);
+    private setupProxy;
+    private buildUdpAssociateRequest;
+    private parseRelayAddress;
+    private createSocks5UdpHeader;
+    private parseSocks5UdpHeader;
     connect(): Promise<void>;
     onTick(): void;
     onMessage(data: Buffer, rinfo: RemoteInfo): void;

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,YAAY,EAWZ,QAAQ,EAIR,KAAK,KAAK,EAIV,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EACN,KAAK,aAAa,EAElB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAgB,KAAK,UAAU,EAAe,MAAM,YAAY,CAAC;AAGxE,qBAAa,MAAO,SAAQ,YAAY,CAAC,YAAY,CAAC;IACrD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAA2B;IAC7D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAO;IAE1C,OAAO,EAAE,aAAa,CAAC;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,MAAM,CAAmB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM;IAmBzC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA6CxB,MAAM,IAAI,IAAI;IAYd,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAyDhD,YAAY,CAAC,IAAI,EAAE,MAAM;IAwCzB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,GAAE,QAA0B;IAI5D,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,QAA0B;IAI/D,IAAI,IAAI,IAAI;IAQZ,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIxB,UAAU,IAAI,IAAI;CAIzB"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,YAAY,EAWZ,QAAQ,EAIR,KAAK,KAAK,EAIV,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EACN,KAAK,aAAa,EAElB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAgB,KAAK,UAAU,EAAe,MAAM,YAAY,CAAC;AAKxE,qBAAa,MAAO,SAAQ,YAAY,CAAC,YAAY,CAAC;IACrD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAiC;IACnE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAO;IAE1C,OAAO,EAAE,aAAa,CAAC;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,MAAM,CAAmB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM;YAmBlC,UAAU;IAoGxB,OAAO,CAAC,wBAAwB;IAIhC,OAAO,CAAC,iBAAiB;IAuBzB,OAAO,CAAC,qBAAqB;IA4B7B,OAAO,CAAC,oBAAoB;IA2Bf,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiD9B,MAAM,IAAI,IAAI;IAYd,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IA8DhD,YAAY,CAAC,IAAI,EAAE,MAAM;IAyCzB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,GAAE,QAA0B;IAI5D,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,QAA0B;IAI/D,IAAI,IAAI,IAAI;IAOZ,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAWxB,UAAU,IAAI,IAAI;CAQzB"}

package/dist/client/client.js

@@ -5,8 +5,10 @@ const shared_1 = require("../shared");
 const client_options_1 = require("./types/client-options");
 const node_dgram_1 = require("node:dgram");
 const shared_2 = require("../shared");
+const node_net_1 = require("node:net");
+const promises_1 = require("node:dns/promises");
 class Client extends shared_1.EventEmitter {
-    static MTU_VALUES = [1492, 1400, 1200, 576];
+    static MTU_VALUES = [1492, 1400, 1028, 1200, 576];
     static MTU_RETRY_INTERVAL = 500;
     options;
     socket;
@@ -15,6 +17,11 @@ class Client extends shared_1.EventEmitter {
     tick;
     session;
     gotReply1 = false;
+    proxySocket = null;
+    proxyRelayHost = null;
+    proxyRelayPort = null;
+    resolvedAddress = null;
+    proxyReady = false;
     constructor(options = {}) {
         super();
         this.options = { ...client_options_1.defaultClientOptions, ...options };
@@ -30,10 +37,172 @@ class Client extends shared_1.EventEmitter {
             this.handleOnline(data);
         };
     }
-    connect() {
+    async setupProxy() {
+        if (!this.options.proxy)
+            return;
+        const proxy = this.options.proxy;
+        const isIPv4 = /^\d{1,3}(\.\d{1,3}){3}$/.test(this.options.address);
+        if (!isIPv4) {
+            const result = await (0, promises_1.lookup)(this.options.address, 4);
+            this.resolvedAddress = result.address;
+        }
+        else {
+            this.resolvedAddress = this.options.address;
+        }
+        return new Promise((resolve, reject) => {
+            const socket = (0, node_net_1.connect)(proxy.port, proxy.host, () => {
+                const authMethods = proxy.userId && proxy.password ? [0x00, 0x02] : [0x00];
+                socket.write(Buffer.from([0x05, authMethods.length, ...authMethods]));
+            });
+            let state = "greeting";
+            socket.on("data", (data) => {
+                if (state === "greeting") {
+                    if (data[0] !== 0x05) {
+                        reject(new Error("Invalid SOCKS5 response"));
+                        socket.destroy();
+                        return;
+                    }
+                    const method = data[1];
+                    if (method === 0x02 && proxy.userId && proxy.password) {
+                        const userBuf = Buffer.from(proxy.userId, "utf8");
+                        const passBuf = Buffer.from(proxy.password, "utf8");
+                        socket.write(Buffer.concat([
+                            Buffer.from([0x01, userBuf.length]),
+                            userBuf,
+                            Buffer.from([passBuf.length]),
+                            passBuf,
+                        ]));
+                        state = "auth";
+                    }
+                    else if (method === 0x00) {
+                        socket.write(this.buildUdpAssociateRequest());
+                        state = "request";
+                    }
+                    else {
+                        reject(new Error("SOCKS5 auth method not supported"));
+                        socket.destroy();
+                    }
+                }
+                else if (state === "auth") {
+                    if (data[1] !== 0x00) {
+                        reject(new Error("SOCKS5 authentication failed"));
+                        socket.destroy();
+                        return;
+                    }
+                    socket.write(this.buildUdpAssociateRequest());
+                    state = "request";
+                }
+                else if (state === "request") {
+                    if (data[0] !== 0x05 || data[1] !== 0x00) {
+                        reject(new Error(`SOCKS5 UDP ASSOCIATE failed: ${data[1]}`));
+                        socket.destroy();
+                        return;
+                    }
+                    const relay = this.parseRelayAddress(data);
+                    if (!relay) {
+                        reject(new Error("Failed to parse relay address"));
+                        socket.destroy();
+                        return;
+                    }
+                    this.proxySocket = socket;
+                    this.proxyRelayHost =
+                        relay.host === "0.0.0.0"
+                            ? (this.resolvedAddress ?? proxy.host)
+                            : relay.host;
+                    this.proxyRelayPort = relay.port;
+                    this.proxyReady = true;
+                    state = "done";
+                    resolve();
+                }
+            });
+            socket.on("close", () => {
+                if (state !== "done") {
+                    reject(new Error("SOCKS5 connection closed unexpectedly"));
+                }
+                else {
+                    this.proxySocket = null;
+                    this.proxyRelayHost = null;
+                    this.proxyRelayPort = null;
+                }
+            });
+            socket.on("error", (err) => {
+                reject(new Error(`SOCKS5 proxy error: ${err.message}`));
+            });
+        });
+    }
+    buildUdpAssociateRequest() {
+        return Buffer.from([0x05, 0x03, 0x00, 0x01, 0, 0, 0, 0, 0, 0]);
+    }
+    parseRelayAddress(data) {
+        const atyp = data[3];
+        if (atyp === 0x01) {
+            return {
+                host: `${data[4]}.${data[5]}.${data[6]}.${data[7]}`,
+                port: data.readUInt16BE(8),
+            };
+        }
+        if (atyp === 0x03) {
+            const len = data[4] ?? 0;
+            return {
+                host: data.subarray(5, 5 + len).toString("utf8"),
+                port: data.readUInt16BE(5 + len),
+            };
+        }
+        return null;
+    }
+    createSocks5UdpHeader(host, port) {
+        const isIPv4 = /^\d{1,3}(\.\d{1,3}){3}$/.test(host);
+        if (isIPv4) {
+            const header = Buffer.alloc(10);
+            header.writeUInt16BE(0, 0);
+            header.writeUInt8(0, 2);
+            header.writeUInt8(1, 3);
+            const parts = host.split(".").map(Number);
+            header.writeUInt8(parts[0] ?? 0, 4);
+            header.writeUInt8(parts[1] ?? 0, 5);
+            header.writeUInt8(parts[2] ?? 0, 6);
+            header.writeUInt8(parts[3] ?? 0, 7);
+            header.writeUInt16BE(port, 8);
+            return header;
+        }
+        const domainBuffer = Buffer.from(host, "utf8");
+        const header = Buffer.alloc(7 + domainBuffer.length);
+        header.writeUInt16BE(0, 0);
+        header.writeUInt8(0, 2);
+        header.writeUInt8(3, 3);
+        header.writeUInt8(domainBuffer.length, 4);
+        domainBuffer.copy(header, 5);
+        header.writeUInt16BE(port, 5 + domainBuffer.length);
+        return header;
+    }
+    parseSocks5UdpHeader(data) {
+        if (data.length < 10)
+            return null;
+        const atyp = data.readUInt8(3);
+        if (atyp === 1) {
+            return {
+                host: `${data.readUInt8(4)}.${data.readUInt8(5)}.${data.readUInt8(6)}.${data.readUInt8(7)}`,
+                port: data.readUInt16BE(8),
+                dataOffset: 10,
+            };
+        }
+        if (atyp === 3) {
+            const domainLen = data.readUInt8(4);
+            return {
+                host: data.subarray(5, 5 + domainLen).toString("utf8"),
+                port: data.readUInt16BE(5 + domainLen),
+                dataOffset: 7 + domainLen,
+            };
+        }
+        return null;
+    }
+    async connect() {
+        if (this.options.proxy) {
+            await this.setupProxy();
+        }
+        this.status = shared_1.ConnectionStatus.Connecting;
+        this.gotReply1 = false;
         return new Promise((resolve, reject) => {
-            this.status = shared_1.ConnectionStatus.Connecting;
-            this.gotReply1 = false;
             let mtuIndex = 0;
             let retryTimeout = null;
             const sendRequest = () => {
@@ -42,7 +211,6 @@ class Client extends shared_1.EventEmitter {
                     return;
                 }
                 const mtu = Client.MTU_VALUES[mtuIndex];
-                // Should not happen but for the linter sake
                 if (!mtu)
                     throw new Error("MTU value is undefined");
                 const request = new shared_1.OpenConnectionRequestOne();
@@ -74,7 +242,7 @@ class Client extends shared_1.EventEmitter {
         const isDisconnected = this.status === shared_1.ConnectionStatus.Disconnected;
         const isDisconnecting = this.status === shared_1.ConnectionStatus.Disconnecting;
         const canPing = isDisconnected && this.tick % this.options.pingRate === 0;
-        if (canPing)
+        if (canPing && (!this.options.proxy || this.proxyReady))
             this.ping();
         if (!isDisconnecting || !isDisconnected) {
             this.session.onTick(this.tick);
@@ -82,50 +250,55 @@ class Client extends shared_1.EventEmitter {
         this.tick++;
     }
     onMessage(data, rinfo) {
-        let id = data[0];
+        let actualData = data;
+        if (this.proxyRelayHost && this.proxyRelayPort) {
+            const parsed = this.parseSocks5UdpHeader(data);
+            if (parsed) {
+                actualData = data.subarray(parsed.dataOffset);
+            }
+        }
+        let id = actualData[0];
         const isOnline = (id & 0xf0) === 0x80;
         if (isOnline)
             id = 0x80;
         switch (id) {
             case shared_1.Packets.UnconnectedPong: {
-                const pong = new shared_1.UnconnectedPong(data).deserialize();
+                const pong = new shared_1.UnconnectedPong(actualData).deserialize();
                 this.emit("unconnectedPong", pong);
                 break;
             }
             case shared_1.Packets.OpenConnectionReply1: {
                 this.gotReply1 = true;
-                const reply = new shared_1.OpenConnectionReplyOne(data).deserialize();
+                const reply = new shared_1.OpenConnectionReplyOne(actualData).deserialize();
                 const request = new shared_1.OpenConnectionRequestTwo();
                 request.address = shared_1.Address.fromIdentifier(rinfo);
                 request.mtu = reply.mtu;
                 request.guid = this.options.guid;
                 request.cookie = reply.cookie;
-                // Set to false since we don't support libcat encryption
                 request.clientSupportsecurity = false;
                 this.send(request.serialize());
                 break;
             }
             case shared_1.Packets.OpenConnectionReply2: {
-                const reply = new shared_1.OpenConnectionReplyTwo(data).deserialize();
+                new shared_1.OpenConnectionReplyTwo(actualData).deserialize();
                 const request = new shared_1.ConnectionRequest();
                 request.guid = this.options.guid;
                 request.timestamp = BigInt(Date.now());
-                const serialized = request.serialize();
-                this.frameAndSend(serialized, shared_1.Priority.High);
+                this.frameAndSend(request.serialize(), shared_1.Priority.High);
                 break;
             }
             case shared_1.Packets.FrameSet: {
-                const frameSet = new shared_1.FrameSet(data).deserialize();
+                const frameSet = new shared_1.FrameSet(actualData).deserialize();
                 this.session.onFrameSet(frameSet);
                 break;
             }
             case shared_1.Packets.Ack: {
-                const ack = new shared_1.Ack(data).deserialize();
+                const ack = new shared_1.Ack(actualData).deserialize();
                 this.session.onAck(ack);
                 break;
             }
             case shared_1.Packets.Nack: {
-                const nack = new shared_1.Ack(data).deserialize();
+                const nack = new shared_1.Ack(actualData).deserialize();
                 this.session.onNack(nack);
                 break;
             }
@@ -180,14 +353,25 @@ class Client extends shared_1.EventEmitter {
         const ping = new shared_1.UnconnectedPing();
         ping.guid = this.options.guid;
         ping.timestamp = BigInt(Date.now());
-        const serialized = ping.serialize();
-        this.send(serialized);
+        this.send(ping.serialize());
     }
     send(data) {
-        this.socket.send(data, this.options.port, this.options.address);
+        if (this.proxyRelayHost && this.proxyRelayPort) {
+            const destAddr = this.resolvedAddress || this.options.address;
+            const header = this.createSocks5UdpHeader(destAddr, this.options.port);
+            const packet = Buffer.concat([header, data]);
+            this.socket.send(packet, this.proxyRelayPort, this.proxyRelayHost);
+        }
+        else {
+            this.socket.send(data, this.options.port, this.options.address);
+        }
     }
     disconnect() {
         this.socket.close();
+        if (this.proxySocket) {
+            this.proxySocket.destroy();
+            this.proxySocket = null;
+        }
         if (this.interval)
             clearInterval(this.interval);
     }

package/dist/client/types/client-options.d.ts

@@ -1,3 +1,9 @@
+export type ProxyOptions = {
+    host: string;
+    port: number;
+    userId?: string;
+    password?: string;
+};
 export type ClientOptions = {
     mtu: number;
     address: string;
@@ -6,6 +12,7 @@ export type ClientOptions = {
     tickRate: number;
     pingRate: number;
     timeout: number;
+    proxy?: ProxyOptions;
 };
 export declare const getRandomGuid: () => bigint;
 export declare const defaultClientOptions: ClientOptions;

package/dist/client/types/client-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client-options.d.ts","sourceRoot":"","sources":["../../../src/client/types/client-options.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,aAAa,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CAChB,CAAC;AACF,eAAO,MAAM,aAAa,cACgC,CAAC;AAE3D,eAAO,MAAM,oBAAoB,EAAE,aAQlC,CAAC"}
+{"version":3,"file":"client-options.d.ts","sourceRoot":"","sources":["../../../src/client/types/client-options.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,YAAY,CAAC;CACrB,CAAC;AACF,eAAO,MAAM,aAAa,cACgC,CAAC;AAE3D,eAAO,MAAM,oBAAoB,EAAE,aAQlC,CAAC"}

package/package.json

@@ -1,13 +1,10 @@
 {
   "name": "@sanctumterra/raknet",
-  "version": "1.4.5",
+  "version": "1.4.6",
   "description": "",
-  
   "types": "dist/index.d.ts",
   "main": "dist/index.js",
-  
   "module": "commonjs",
-  
   "scripts": {
     "build": "tsc",
     "watch": "tsc --watch",
@@ -16,18 +13,16 @@
     "lint:write": "npx @biomejs/biome lint --write ./src",
     "format:write": "npx @biomejs/biome format --write ./src"
   },
-  
   "keywords": [],
   "author": "",
   "license": "ISC",
-
   "dependencies": {
     "@serenityjs/binarystream": "^3.0.10"
   },
   "devDependencies": {
-    "@types/bun": "^1.2.21",
-    "typescript": "^5.9.2",
     "@biomejs/biome": "^1.9.4",
-    "@types/node": "^24.3.0"
+    "@types/bun": "^1.2.21",
+    "@types/node": "^24.3.0",
+    "typescript": "^5.9.2"
   }
 }