@srvquery/protocol-minecraft-java 0.0.1-next.0

package/dist/packet/request.d.ts

@@ -0,0 +1,12 @@
+/** Builds the Java Edition status handshake packet. */
+export declare const buildHandshakePacket: ({ host, port }: {
+    host: string;
+    port: number;
+}) => Buffer;
+/** Builds a Java Edition status request packet. */
+export declare const buildStatusRequestPacket: () => Buffer;
+/** Builds a Java Edition ping packet. */
+export declare const buildPingPacket: ({ payload }: {
+    payload: bigint;
+}) => Buffer;
+//# sourceMappingURL=request.d.ts.map

package/dist/packet/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/packet/request.ts"],"names":[],"mappings":"AAOA,uDAAuD;AACvD,eAAO,MAAM,oBAAoB,mBAAoB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KAAG,MASlF,CAAC;AAEL,mDAAmD;AACnD,eAAO,MAAM,wBAAwB,QAAO,MACU,CAAC;AAEvD,yCAAyC;AACzC,eAAO,MAAM,eAAe,gBAAiB;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,KAAG,MAIlE,CAAC"}

package/dist/packet/schema.d.ts

@@ -0,0 +1,47 @@
+import z from "zod";
+/** Validates the version information returned by a Minecraft status query. */
+export declare const MinecraftVersionSchema: z.ZodObject<{
+    name: z.ZodString;
+    protocol: z.ZodNumber;
+}, z.core.$strip>;
+/** A sample player returned by a Minecraft status query. */
+export declare const MinecraftPlayerSchema: z.ZodObject<{
+    name: z.ZodString;
+    id: z.ZodString;
+}, z.core.$strip>;
+/** Validates the player counts and optional samples in a Minecraft status response. */
+export declare const MinecraftPlayersSchema: z.ZodObject<{
+    max: z.ZodNumber;
+    online: z.ZodNumber;
+    sample: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        id: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/** Validates a Minecraft status description, which may be plain text or a chat component. */
+export declare const MinecraftDescriptionSchema: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>;
+/** Validates the response to a Minecraft Java Server List Ping status request. */
+export declare const MinecraftServerStatusSchema: z.ZodObject<{
+    version: z.ZodObject<{
+        name: z.ZodString;
+        protocol: z.ZodNumber;
+    }, z.core.$strip>;
+    players: z.ZodObject<{
+        max: z.ZodNumber;
+        online: z.ZodNumber;
+        sample: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            id: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+    description: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>;
+    favicon: z.ZodOptional<z.ZodString>;
+    enforcesSecureChat: z.ZodOptional<z.ZodBoolean>;
+    previewsChat: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type MinecraftVersion = z.infer<typeof MinecraftVersionSchema>;
+export type MinecraftPlayer = z.infer<typeof MinecraftPlayerSchema>;
+export type MinecraftPlayers = z.infer<typeof MinecraftPlayersSchema>;
+export type MinecraftDescription = z.infer<typeof MinecraftDescriptionSchema>;
+export type MinecraftServerStatus = z.infer<typeof MinecraftServerStatusSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/packet/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/packet/schema.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB;;;iBAA6D,CAAC;AAEjG,4DAA4D;AAC5D,eAAO,MAAM,qBAAqB;;;iBAAiD,CAAC;AAEpF,uFAAuF;AACvF,eAAO,MAAM,sBAAsB;;;;;;;iBAIjC,CAAC;AAEH,6FAA6F;AAC7F,eAAO,MAAM,0BAA0B,4EAA2D,CAAC;AAEnG,kFAAkF;AAClF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;iBAOtC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}

package/dist/packet/varint.d.ts

@@ -0,0 +1,17 @@
+/** Encodes a signed Minecraft protocol VarInt. */
+export declare const encodeVarInt: ({ value }: {
+    value: number;
+}) => Buffer;
+/** Decodes a Minecraft protocol VarInt. */
+export declare const decodeVarInt: ({ buffer, offset, }: {
+    buffer: Buffer;
+    offset?: number;
+}) => {
+    value: number;
+    bytes: number;
+};
+/** Prefixes a payload with its Minecraft packet length. */
+export declare const framePacket: ({ payload }: {
+    payload: Buffer;
+}) => Buffer;
+//# sourceMappingURL=varint.d.ts.map

package/dist/packet/varint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"varint.d.ts","sourceRoot":"","sources":["../../src/packet/varint.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,eAAO,MAAM,YAAY,cAAe;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,KAAG,MAY3D,CAAC;AAEF,2CAA2C;AAC3C,eAAO,MAAM,YAAY,wBAGtB;IACD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,KAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAWjC,CAAC;AAEF,2DAA2D;AAC3D,eAAO,MAAM,WAAW,gBAAiB;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,KAAG,MACI,CAAC"}

package/dist/protocol.d.ts

@@ -0,0 +1,30 @@
+import { type CreateHttpClientParams, type RetryOptions } from "@srvquery/core";
+import { type MinecraftServerStatus } from "./packet/schema";
+/** Connection and retry settings used to create a Minecraft Java protocol client. */
+export type CreateMinecraftJavaProtocolParams = Omit<CreateHttpClientParams, "port"> & {
+    /** Minecraft Java Edition's default server port. */
+    port?: number;
+    /** Time in milliseconds to wait for a response to a single query attempt. */
+    timeout?: number;
+    /** Retry behavior for a query. */
+    retry?: RetryOptions;
+};
+/** Default TCP port used by Minecraft Java Edition servers. */
+export declare const defaultMinecraftJavaPort = 25565;
+/** Query operations supported by the Minecraft Java Server List Ping protocol. */
+export type MinecraftJavaProtocolRequestOpcode = "STATUS" | "PING";
+type MinecraftJavaProtocolResponseMap = {
+    STATUS: MinecraftServerStatus;
+    PING: number;
+};
+/** Client for querying Minecraft Java Edition servers. */
+export interface MinecraftJavaProtocol {
+    /** Queries one Minecraft Java status opcode. */
+    query<Opcode extends MinecraftJavaProtocolRequestOpcode>(params: {
+        opcode: Opcode;
+    }): Promise<MinecraftJavaProtocolResponseMap[Opcode]>;
+}
+/** Creates a client for querying a Minecraft Java Edition server. */
+export declare const createMinecraftJavaProtocol: ({ host, port, retry, timeout, }: CreateMinecraftJavaProtocolParams) => MinecraftJavaProtocol;
+export {};
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,sBAAsB,EAK3B,KAAK,YAAY,EAElB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAA+B,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAG1F,qFAAqF;AACrF,MAAM,MAAM,iCAAiC,GAAG,IAAI,CAAC,sBAAsB,EAAE,MAAM,CAAC,GAAG;IACrF,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,wBAAwB,QAAQ,CAAC;AAE9C,kFAAkF;AAClF,MAAM,MAAM,kCAAkC,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEnE,KAAK,gCAAgC,GAAG;IACtC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,0DAA0D;AAC1D,MAAM,WAAW,qBAAqB;IACpC,gDAAgD;IAChD,KAAK,CAAC,MAAM,SAAS,kCAAkC,EAAE,MAAM,EAAE;QAC/D,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,gCAAgC,CAAC,MAAM,CAAC,CAAC,CAAC;CACvD;AA+ED,qEAAqE;AACrE,eAAO,MAAM,2BAA2B,oCAKrC,iCAAiC,KAAG,qBAuDtC,CAAC"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@srvquery/protocol-minecraft-java",
+  "version": "0.0.1-next.0",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "zod": "^4.5.4"
+  },
+  "devDependencies": {
+    "@internal/typescript-config": "0.0.0",
+    "@srvquery/core": "0.0.1-next.0",
+    "@types/node": "^26.4.1",
+    "rolldown": "^1.2.7",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.0"
+  },
+  "peerDependencies": {
+    "@srvquery/core": "0.0.1-next.0"
+  },
+  "scripts": {
+    "build": "rolldown -c rolldown.config.ts && tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}