specprotocol 1.4.4 → 1.4.5

package/dist/protocol/version.js

@@ -0,0 +1,137 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_PROTOCOL_VERSION = exports.MAX_SUPPORTED_PROTOCOL_VERSION = exports.MIN_SUPPORTED_PROTOCOL_VERSION = void 0;
+exports.resolvePacketId = resolvePacketId;
+exports.resolveProtocolInfo = resolveProtocolInfo;
+const minecraft_data_1 = __importDefault(require("minecraft-data"));
+exports.MIN_SUPPORTED_PROTOCOL_VERSION = 47; // 1.8.x
+const latestReleaseEntry = minecraft_data_1.default.versions.pc
+    .filter((entry) => entry.usesNetty && isRelease(entry) && entry.version >= exports.MIN_SUPPORTED_PROTOCOL_VERSION)
+    .sort((a, b) => {
+    if (a.version !== b.version)
+        return b.version - a.version;
+    return b.dataVersion - a.dataVersion;
+})[0];
+exports.MAX_SUPPORTED_PROTOCOL_VERSION = latestReleaseEntry?.version ?? 769;
+exports.DEFAULT_PROTOCOL_VERSION = exports.MAX_SUPPORTED_PROTOCOL_VERSION;
+function isRelease(entry) {
+    return entry.releaseType !== 'snapshot' && entry.releaseType !== 'old_snapshot';
+}
+function isPatchVersion(version) {
+    return /^1\.\d+\.\d+$/.test(version);
+}
+function parseMaybeProtocolNumber(input) {
+    if (!/^\d+$/.test(input))
+        return null;
+    const parsed = Number.parseInt(input, 10);
+    return Number.isFinite(parsed) ? parsed : null;
+}
+function findPreferredEntryForProtocol(protocol) {
+    const byProtocol = minecraft_data_1.default.postNettyVersionsByProtocolVersion.pc[String(protocol)] ?? [];
+    const filtered = byProtocol.filter((entry) => entry.usesNetty && isRelease(entry));
+    if (filtered.length === 0)
+        return null;
+    const stablePatch = filtered.find((entry) => isPatchVersion(entry.minecraftVersion));
+    return stablePatch ?? filtered[0] ?? null;
+}
+function resolveVersionInput(input) {
+    if (input === undefined) {
+        const latest = findPreferredEntryForProtocol(exports.DEFAULT_PROTOCOL_VERSION);
+        if (!latest)
+            throw new Error(`Default protocol ${exports.DEFAULT_PROTOCOL_VERSION} could not be resolved`);
+        return latest;
+    }
+    if (typeof input === 'number') {
+        const resolved = findPreferredEntryForProtocol(input);
+        if (!resolved)
+            throw new Error(`Unsupported protocol version: ${input}`);
+        return resolved;
+    }
+    const normalized = input.trim();
+    const maybeProtocol = parseMaybeProtocolNumber(normalized);
+    if (maybeProtocol !== null) {
+        const resolved = findPreferredEntryForProtocol(maybeProtocol);
+        if (!resolved)
+            throw new Error(`Unsupported protocol version: ${normalized}`);
+        return resolved;
+    }
+    const exact = minecraft_data_1.default.versionsByMinecraftVersion.pc[normalized];
+    if (exact && exact.usesNetty && isRelease(exact)) {
+        return exact;
+    }
+    const prefix = normalized.endsWith('.x') ? normalized.slice(0, -2) : normalized;
+    const releases = minecraft_data_1.default.versions.pc.filter((entry) => entry.usesNetty &&
+        isRelease(entry) &&
+        entry.version >= exports.MIN_SUPPORTED_PROTOCOL_VERSION &&
+        entry.version <= exports.MAX_SUPPORTED_PROTOCOL_VERSION);
+    const candidates = releases.filter((entry) => entry.minecraftVersion === prefix ||
+        entry.minecraftVersion.startsWith(`${prefix}.`) ||
+        entry.majorVersion === prefix);
+    if (candidates.length === 0) {
+        throw new Error(`Unsupported Minecraft version: ${input}`);
+    }
+    candidates.sort((a, b) => {
+        if (a.version !== b.version)
+            return b.version - a.version;
+        return b.dataVersion - a.dataVersion;
+    });
+    const stablePatch = candidates.find((entry) => isPatchVersion(entry.minecraftVersion));
+    return stablePatch ?? candidates[0];
+}
+function extractStateMappings(stateDef) {
+    const empty = { toClient: {}, toServer: {} };
+    if (!stateDef)
+        return empty;
+    const extract = (packetDef) => {
+        const mapperNode = packetDef?.[1]?.[0];
+        const mappings = mapperNode?.type?.[1]?.mappings;
+        if (!mappings)
+            return {};
+        const out = {};
+        for (const [hex, name] of Object.entries(mappings)) {
+            if (typeof name !== 'string')
+                continue;
+            const parsed = Number.parseInt(hex, 16);
+            if (!Number.isNaN(parsed))
+                out[name] = parsed;
+        }
+        return out;
+    };
+    return {
+        toClient: extract(stateDef?.toClient?.types?.packet),
+        toServer: extract(stateDef?.toServer?.types?.packet),
+    };
+}
+function resolvePacketId(packetMap, candidates) {
+    for (const name of candidates) {
+        const found = packetMap[name];
+        if (found !== undefined)
+            return found;
+    }
+    return undefined;
+}
+function resolveProtocolInfo(input) {
+    const entry = resolveVersionInput(input);
+    if (entry.version < exports.MIN_SUPPORTED_PROTOCOL_VERSION ||
+        entry.version > exports.MAX_SUPPORTED_PROTOCOL_VERSION) {
+        throw new Error(`Protocol ${entry.version} (${entry.minecraftVersion}) is out of supported range ` +
+            `${exports.MIN_SUPPORTED_PROTOCOL_VERSION}-${exports.MAX_SUPPORTED_PROTOCOL_VERSION}`);
+    }
+    const data = (0, minecraft_data_1.default)(entry.version);
+    const login = extractStateMappings(data.protocol?.login);
+    const play = extractStateMappings(data.protocol?.play);
+    const configuration = data.protocol?.configuration
+        ? extractStateMappings(data.protocol.configuration)
+        : undefined;
+    return {
+        protocolVersion: entry.version,
+        minecraftVersion: entry.minecraftVersion,
+        majorVersion: entry.majorVersion,
+        packetMappings: { login, play, configuration },
+        supportsConfigurationState: configuration !== undefined,
+    };
+}
+//# sourceMappingURL=version.js.map

package/dist/protocol/version.js.map

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

package/docs/README.md

@@ -1,6 +1,6 @@
 # 📚 SpecProtocol Dokümantasyonu
 
-SpecProtocol, Minecraft Java Edition 1.21.4 için sıfırdan yazılmış bir bot framework'üdür.
+SpecProtocol, Minecraft Java Edition 1.8-1.21.x aralığı için sıfırdan yazılmış bir bot framework'üdür.
 
 ## İçindekiler
 

package/docs/api/protocol.md

@@ -95,7 +95,7 @@ import {
 } from 'specprotocol';
 ```
 
-### Play (1.21.4)
+### Play (version-adaptive)
 
 **Serverbound (Client → Server):**
 

package/docs/getting-started.md

@@ -6,7 +6,7 @@
 npm install specprotocol
 ```
 
-> **Gereksinimler:** Node.js ≥ 18, Minecraft Java Edition 1.21.4 sunucusu
+> **Gereksinimler:** Node.js ≥ 18, Minecraft Java Edition 1.8-1.21.x sunucusu
 
 ## Hızlı Başlangıç
 

package/docs/guides/architecture.md

@@ -101,7 +101,7 @@ src/
 │   └── states/
 │       ├── handshake.ts  # Handshake paketi
 │       ├── login.ts      # Login state paketleri
-│       └── play.ts       # Play state paketleri (1.21.4 packet ID'leri)
+│       └── play.ts       # Play state paketleri (version-adaptive packet ID'leri)
 │
 ├── auth/
 │   ├── offline.ts        # Offline UUID generation (MD5-based v3)

package/package.json

@@ -1,15 +1,13 @@
 {
   "name": "specprotocol",
-  "version": "1.4.4",
-  "description": "A Minecraft bot framework built from scratch in TypeScript — Mineflayer alternative with full protocol support for Java Edition 1.21.4",
+  "version": "1.4.5",
+  "description": "A Minecraft bot framework built from scratch in TypeScript with dynamic packet mapping for Java Edition 1.8-1.21.x",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "commonjs",
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
     "lint": "tsc --noEmit",
     "prepublishOnly": "npm run build",
     "example:basic": "npx tsx examples/basic-bot.ts",
@@ -39,13 +37,15 @@
     "@types/node": "^25.3.3",
     "eslint": "^10.0.2",
     "tsx": "^4.7.0",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.18"
+    "typescript": "^5.9.3"
   },
   "files": [
     "dist/",
     "docs/",
     "README.md",
     "LICENSE"
-  ]
+  ],
+  "dependencies": {
+    "minecraft-data": "^3.105.0"
+  }
 }