minecraft-toolkit 0.1.4 → 1.0.1

package/README.md

@@ -81,9 +81,10 @@ import {
 
 isValidUsername("26bz"); // true
 uuidWithDashes("069a79f444e94726a5befca90e38aaf5");
-const skinUrl = getSkinURL(await fetchPlayerProfile("26bz"));
+const profile = await fetchPlayerProfile("26bz");
+const skinUrl = getSkinURL(profile);
 const hash = extractTextureHash(skinUrl);
-const model = getSkinModel(skinUrl); // "slim" | "classic"
+const model = getSkinModel(profile); // "slim" | "default"
 ```
 
 ## Skin Metadata & Color Sampling
@@ -139,13 +140,13 @@ import {
   fetchBedrockServerStatus,
 } from "minecraft-toolkit";
 
-const javaStatus = await fetchJavaServerStatus({ host: "mc.hypixel.net", port: 25565 });
-const bedrockStatus = await fetchBedrockServerStatus({ host: "play.example.net", port: 19132 });
+const javaStatus = await fetchJavaServerStatus("mc.hypixel.net", { port: 25565 });
+const bedrockStatus = await fetchBedrockServerStatus("play.example.net", { port: 19132 });
 
 // fetchServerStatus picks the right probe based on the `edition` field
-const autoStatus = await fetchServerStatus({ host: "my.realm.net", edition: "bedrock" });
+const autoStatus = await fetchServerStatus("my.realm.net", { edition: "bedrock" });
 
-console.log(javaStatus.players.online, bedrockStatus.motd.text);
+console.log(javaStatus.players.online, bedrockStatus.motd);
 ```
 
 Both helpers normalize MOTD text, favicon/Base64 icons, latency, and version info. Errors surface as
@@ -179,7 +180,7 @@ import { sendVotifierVote } from "minecraft-toolkit";
 const result = await sendVotifierVote({
   host: "votifier.myserver.net",
   port: 8192, // defaults to 8192 if omitted
-  publicKey: process.env.VOTIFIER_PUBLIC_KEY!, // v1 servers
+  publicKey: process.env.VOTIFIER_PUBLIC_KEY, // v1 servers
   serviceName: "MyTopList",
   username: "26bz",
   address: "198.51.100.42",

package/index.d.ts

@@ -71,7 +71,7 @@ export function fetchSkinMetadata(
     sampleRegion?: { x?: number; y?: number; width?: number; height?: number };
   },
 ): Promise<SkinMetadataResult>;
-export function fetchSkinDominantColor(
+export function computeSkinDominantColor(
   url: string,
   region?: { x?: number; y?: number; width?: number; height?: number },
 ): Promise<string | null>;
@@ -136,6 +136,7 @@ export interface BedrockServerStatusOptions {
 
 export interface ServerStatusOptions extends JavaServerStatusOptions {
   edition?: ServerEdition;
+  /** @deprecated Use `edition` instead. */
   type?: ServerEdition;
 }
 
@@ -231,11 +232,20 @@ export interface VotifierVoteResult {
 export function sendVotifierVote(options: VotifierVoteOptions): Promise<VotifierVoteResult>;
 
 export interface PlayerHandlers {
-  profileHandler: any;
-  skinHandler: any;
-  summaryHandler: any;
-  uuidHandler: any;
-  resolverHandler: any;
+  profileHandler: import("h3").EventHandler;
+  skinHandler: import("h3").EventHandler;
+  summaryHandler: import("h3").EventHandler;
+  uuidHandler: import("h3").EventHandler;
+  resolverHandler: import("h3").EventHandler;
+  nameHistoryHandler: import("h3").EventHandler;
+  existsHandler: import("h3").EventHandler;
+  batchHandler: import("h3").EventHandler;
+  nameChangeInfoHandler: import("h3").EventHandler;
+  nameAvailabilityHandler: import("h3").EventHandler;
+  giftCodeValidationHandler: import("h3").EventHandler;
+  blockedServersHandler: import("h3").EventHandler;
+  serverStatusHandler: import("h3").EventHandler;
+  serverIconHandler: import("h3").EventHandler;
 }
 
 export function createPlayerHandlers(): PlayerHandlers;

package/index.js

@@ -10,7 +10,13 @@ export {
   hasSkinChanged,
 } from "./src/player/profile/index.js";
 export { fetchSkinMetadata, computeSkinDominantColor } from "./src/player/skin.js";
-export { isValidUsername } from "./src/player/identity/index.js";
+export {
+  isValidUsername,
+  isUUID,
+  normalizeUUID,
+  uuidWithDashes,
+  uuidWithoutDashes,
+} from "./src/player/identity/index.js";
 export { getSkinURL, getCapeURL, getSkinModel, extractTextureHash } from "./src/player/textures.js";
 export { resolvePlayer } from "./src/player/resolve.js";
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minecraft-toolkit",
-  "version": "0.1.4",
+  "version": "1.0.1",
   "description": "Minecraft toolkit for Mojang player data, server status probes, and Votifier v1/v2 clients.",
   "keywords": [
     "minecraft",
@@ -47,28 +47,17 @@
       "default": "./index.js"
     }
   },
-  "scripts": {
-    "test": "vitest",
-    "test:watch": "vitest watch",
-    "test:coverage": "vitest run --coverage",
-    "lint": "oxlint",
-    "lint:fix": "oxlint --fix",
-    "fmt": "oxfmt",
-    "fmt:check": "oxfmt --check",
-    "prepare": "husky install",
-    "docs:sync": "automd"
-  },
   "dependencies": {
-    "h3": "2.0.1-rc.14",
+    "h3": "2.0.1-rc.20",
     "pngjs": "^7.0.0"
   },
   "devDependencies": {
-    "automd": "^0.3.2",
+    "automd": "^0.4.3",
     "husky": "^9.1.7",
-    "lint-staged": "^16.3.2",
-    "oxfmt": "^0.36.0",
-    "oxlint": "^1.51.0",
-    "vitest": "^4.0.18"
+    "lint-staged": "^16.4.0",
+    "oxfmt": "^0.42.0",
+    "oxlint": "^1.57.0",
+    "vitest": "^4.1.2"
   },
   "lint-staged": {
     "*.{js,jsx,ts,tsx,mjs,cjs}": "pnpm run lint"
@@ -76,5 +65,14 @@
   "engines": {
     "node": ">=18"
   },
-  "packageManager": "pnpm@10.30.2"
-}
+  "scripts": {
+    "test": "vitest",
+    "test:watch": "vitest watch",
+    "test:coverage": "vitest run --coverage",
+    "lint": "oxlint",
+    "lint:fix": "oxlint --fix",
+    "fmt": "oxfmt",
+    "fmt:check": "oxfmt --check",
+    "docs:sync": "automd"
+  }
+}

package/src/errors.js

@@ -1,8 +1,7 @@
 export class MinecraftToolkitError extends Error {
   constructor(message, { statusCode = 500, cause } = {}) {
-    super(message);
+    super(message, { cause });
     this.name = "MinecraftToolkitError";
     this.statusCode = statusCode;
-    this.cause = cause;
   }
 }

package/src/player/resolve.js

@@ -1,5 +1,5 @@
 import { isUUID, normalizeUUID, uuidWithDashes } from "./identity/index.js";
-import { fetchPlayerProfile, fetchPlayerUUID, fetchUsernameByUUID } from "./profile/index.js";
+import { fetchPlayerProfile, fetchUsernameByUUID } from "./profile/index.js";
 
 export async function resolvePlayer(input) {
   if (typeof input !== "string" || input.trim().length === 0) {
@@ -21,9 +21,8 @@ export async function resolvePlayer(input) {
   }
 
   const profile = await fetchPlayerProfile(raw);
-  const { id } = await fetchPlayerUUID(raw);
   return {
-    id: uuidWithDashes(id),
+    id: uuidWithDashes(profile.id),
     name: profile.name,
     skin: profile.skin ?? null,
     cape: profile.cape ?? null,

package/src/server/java/status.js

@@ -218,17 +218,18 @@ function parseStatusPayload(payload) {
 }
 
 function buildJavaStatus(payload, host, port, latencyMs) {
+  const { version, players, description, favicon, ...rest } = payload;
   return {
     edition: "java",
     online: true,
     host,
     port,
-    version: payload.version ?? null,
-    players: payload.players ?? null,
-    motd: stringifyDescription(payload.description) ?? null,
-    favicon: payload.favicon ?? null,
+    version: version ?? null,
+    players: players ?? null,
+    motd: stringifyDescription(description) ?? null,
+    favicon: favicon ?? null,
     latencyMs,
-    raw: payload,
+    raw: rest,
   };
 }
 

package/src/utils/network.js

@@ -5,10 +5,14 @@ export function resolveAddress(address, overridePort, fallbackPort) {
     return { host: address, port: validatePort(overridePort) };
   }
 
-  const parts = address.split(":");
-  if (parts.length > 1 && parts[parts.length - 1] !== "") {
-    const extractedPort = parts.pop();
-    return { host: parts.join(":"), port: validatePort(extractedPort) };
+  // Only treat as "host:port" when there is exactly one colon.
+  const colonCount = (address.match(/:/g) ?? []).length;
+  if (colonCount === 1) {
+    const lastColon = address.lastIndexOf(":");
+    const potentialPort = address.slice(lastColon + 1);
+    if (potentialPort !== "") {
+      return { host: address.slice(0, lastColon), port: validatePort(potentialPort) };
+    }
   }
 
   return { host: address, port: fallbackPort };