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

package/dist/packet/request.d.ts

@@ -0,0 +1,8 @@
+/** RakNet magic used by unconnected ping packets. */
+export declare const rakNetMagic: Buffer<ArrayBuffer>;
+/** Builds a Minecraft Bedrock/RakNet unconnected ping packet. */
+export declare const buildUnconnectedPingPacket: ({ timestamp, clientGuid, }: {
+    timestamp: bigint;
+    clientGuid?: Buffer;
+}) => 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":"AAEA,qDAAqD;AACrD,eAAO,MAAM,WAAW,qBAAyD,CAAC;AAElF,iEAAiE;AACjE,eAAO,MAAM,0BAA0B,+BAGpC;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,KAAG,MAQH,CAAC"}

package/dist/packet/response.d.ts

@@ -0,0 +1,15 @@
+/** Parses a RakNet unconnected pong and its semicolon-delimited MOTD. */
+export declare const parseUnconnectedPongPacket: (packet: Buffer) => {
+    edition: string;
+    motd: string;
+    protocol: string;
+    version: string;
+    onlinePlayers: string;
+    maxPlayers: string;
+    serverId: string;
+    map: string;
+    gameMode: string;
+    portV4: string;
+    portV6: string;
+};
+//# sourceMappingURL=response.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/packet/response.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,eAAO,MAAM,0BAA0B,WAAY,MAAM;IAerD,OAAO;IACP,IAAI;IACJ,QAAQ;IACR,OAAO;IACP,aAAa;IACb,UAAU;IACV,QAAQ;IACR,GAAG;IACH,QAAQ;IACR,MAAM;IACN,MAAM;CAET,CAAC"}

package/dist/packet/schema.d.ts

@@ -0,0 +1,18 @@
+import z from "zod";
+/** Validates a Minecraft Bedrock server status response. */
+export declare const MinecraftBedrockServerStatusSchema: z.ZodObject<{
+    edition: z.ZodString;
+    motd: z.ZodString;
+    protocol: z.ZodCoercedNumber<unknown>;
+    version: z.ZodString;
+    onlinePlayers: z.ZodCoercedNumber<unknown>;
+    maxPlayers: z.ZodCoercedNumber<unknown>;
+    serverId: z.ZodString;
+    map: z.ZodString;
+    gameMode: z.ZodString;
+    portV4: z.ZodCoercedNumber<unknown>;
+    portV6: z.ZodCoercedNumber<unknown>;
+}, z.core.$strip>;
+/** Server status returned by a Minecraft Bedrock unconnected ping. */
+export type MinecraftBedrockServerStatus = z.infer<typeof MinecraftBedrockServerStatusSchema>;
+//# 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,4DAA4D;AAC5D,eAAO,MAAM,kCAAkC;;;;;;;;;;;;iBAY7C,CAAC;AAEH,sEAAsE;AACtE,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC"}

package/dist/protocol.d.ts

@@ -0,0 +1,24 @@
+import { type CreateUdpSocketOptions, type CreateUdpSocketParams, type RetryOptions } from "@srvquery/core";
+import { type MinecraftBedrockServerStatus } from "./packet/schema";
+/** Default UDP port used by Minecraft Bedrock servers. */
+export declare const defaultMinecraftBedrockPort = 19132;
+/** Connection and retry settings used to create a Minecraft Bedrock client. */
+export type CreateMinecraftBedrockProtocolParams = Omit<CreateUdpSocketParams, "port"> & {
+    port?: number;
+    retry?: RetryOptions;
+} & Omit<CreateUdpSocketOptions, "retry">;
+/** Query operations supported by Minecraft Bedrock. */
+export type MinecraftBedrockProtocolRequestOpcode = "STATUS" | "PING";
+type MinecraftBedrockResponseMap = {
+    STATUS: MinecraftBedrockServerStatus;
+    PING: number;
+};
+/** Client for querying Minecraft Bedrock servers directly over RakNet UDP. */
+export interface MinecraftBedrockProtocol {
+    query<Opcode extends MinecraftBedrockProtocolRequestOpcode>({ opcode, }: {
+        opcode: Opcode;
+    }): Promise<MinecraftBedrockResponseMap[Opcode]>;
+}
+export declare const createMinecraftBedrockProtocol: ({ host, port, retry, timeout, ...socketOptions }: CreateMinecraftBedrockProtocolParams) => MinecraftBedrockProtocol;
+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,EAC3B,KAAK,qBAAqB,EAI1B,KAAK,YAAY,EAElB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,iBAAiB,CAAC;AAIzB,0DAA0D;AAC1D,eAAO,MAAM,2BAA2B,QAAQ,CAAC;AAEjD,+EAA+E;AAC/E,MAAM,MAAM,oCAAoC,GAAG,IAAI,CAAC,qBAAqB,EAAE,MAAM,CAAC,GAAG;IACvF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB,GAAG,IAAI,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC;AAE1C,uDAAuD;AACvD,MAAM,MAAM,qCAAqC,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEtE,KAAK,2BAA2B,GAAG;IACjC,MAAM,EAAE,4BAA4B,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,8EAA8E;AAC9E,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,MAAM,SAAS,qCAAqC,EAAE,EAC1D,MAAM,GACP,EAAE;QACD,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,2BAA2B,CAAC,MAAM,CAAC,CAAC,CAAC;CAClD;AAED,eAAO,MAAM,8BAA8B,qDAMxC,oCAAoC,KAAG,wBAmCzC,CAAC"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@srvquery/protocol-minecraft-bedrock",
+  "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"
+  }
+}