workers-rcon 1.0.0

package/README.md

@@ -0,0 +1,45 @@
+# workers-rcon
+
+Легкая библиотека для работы с Minecraft RCON в среде **Cloudflare Workers**. 
+Использует нативный API `cloudflare:sockets` (TCP), не требует тяжелых полифиллов Node.js.
+
+## Установка
+
+```bash
+npm install workers-rcon
+```
+
+## Использование в Cloudflare Workers
+
+```javascript
+import { MinecraftRCON } from 'workers-rcon';
+
+export default {
+  async fetch(request, env) {
+    const rcon = new MinecraftRCON({
+      host: 'your-server-ip.com',
+      port: 25575,
+      password: 'your_rcon_password'
+    });
+
+    try {
+      // Выполнение команды
+      const response = await rcon.run('say Привет из Cloudflare Workers!');
+      return new Response(`Ответ сервера: ${response}`);
+    } catch (err) {
+      return new Response(`Ошибка: ${err.message}`, { status: 500 });
+    }
+  }
+};
+```
+
+## Особенности
+- **Zero dependencies**: только чистый TypeScript.
+- **Auto-connect**: библиотека сама управляет открытием и закрытием сокета.
+- **Little-Endian**: корректная обработка бинарного протокола RCON.
+
+## Важно
+Для работы TCP в Workers не забудьте добавить флаг в ваш `wrangler.toml`:
+```toml
+compatibility_flags = [ "tcp_sockets" ]
+```

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export interface RCONConfig {
+    host: string;
+    port: number;
+    password: string;
+}
+export declare class MinecraftRCON {
+    private host;
+    private port;
+    private password;
+    private requestId;
+    constructor(config: RCONConfig);
+    run(command: string): Promise<string>;
+    private writePacket;
+    private readPacket;
+}

package/dist/index.js

@@ -0,0 +1,67 @@
+import { connect } from 'cloudflare:sockets';
+// Типы пакетов RCON
+const SERVERDATA_AUTH = 3;
+const SERVERDATA_EXECCOMMAND = 2;
+const SERVERDATA_RESPONSE_VALUE = 0;
+const SERVERDATA_AUTH_RESPONSE = 2;
+export class MinecraftRCON {
+    host;
+    port;
+    password;
+    requestId = 1;
+    constructor(config) {
+        this.host = config.host;
+        this.port = config.port;
+        this.password = config.password;
+    }
+    async run(command) {
+        const socket = connect({ hostname: this.host, port: this.port });
+        const writer = socket.writable.getWriter();
+        const reader = socket.readable.getReader();
+        try {
+            // 1. Авторизация
+            await this.writePacket(writer, SERVERDATA_AUTH, this.password);
+            // Читаем ответ авторизации
+            let authRes = await this.readPacket(reader);
+            if (authRes.id === -1) {
+                throw new Error('RCON Authentication failed: Invalid password');
+            }
+            // 2. Выполнение команды
+            await this.writePacket(writer, SERVERDATA_EXECCOMMAND, command);
+            const cmdRes = await this.readPacket(reader);
+            return cmdRes.body;
+        }
+        finally {
+            await writer.close();
+            socket.close();
+        }
+    }
+    async writePacket(writer, type, body) {
+        const encoder = new TextEncoder();
+        const bodyBytes = encoder.encode(body);
+        // Длина: 4(id) + 4(type) + body + 2(null terminators)
+        const packetLength = 10 + bodyBytes.length;
+        const buffer = new ArrayBuffer(packetLength + 4); // +4 для самого поля длины
+        const view = new DataView(buffer);
+        view.setInt32(0, packetLength, true);
+        view.setInt32(4, this.requestId, true);
+        view.setInt32(8, type, true);
+        const uint8 = new Uint8Array(buffer);
+        uint8.set(bodyBytes, 12);
+        uint8[buffer.byteLength - 2] = 0;
+        uint8[buffer.byteLength - 1] = 0;
+        await writer.write(buffer);
+    }
+    async readPacket(reader) {
+        const { value, done } = await reader.read();
+        if (done || !value)
+            throw new Error('Connection closed by server');
+        const view = new DataView(value.buffer, value.byteOffset, value.byteLength);
+        const length = view.getInt32(0, true);
+        const id = view.getInt32(4, true);
+        const type = view.getInt32(8, true);
+        const bodyBytes = value.slice(12, 12 + (length - 10));
+        const body = new TextDecoder().decode(bodyBytes);
+        return { id, type, body };
+    }
+}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "workers-rcon",
+  "version": "1.0.0",
+  "description": "Minecraft RCON client for Cloudflare Workers via cloudflare:sockets",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc"
+  },
+  "keywords": [
+    "cloudflare",
+    "workers",
+    "minecraft",
+    "rcon",
+    "tcp"
+  ],
+  "author": "YourName",
+  "license": "MIT",
+  "devDependencies": {
+    "@cloudflare/workers-types": "^4.20240000.0",
+    "typescript": "^5.0.0"
+  }
+}