add server registry endpoint

Author: RealFascinated

package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcutils-js-api",
-  "version": "2.0.25",
+  "version": "2.0.26",
   "module": "dist/index.js",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

src/index.ts

@@ -7,6 +7,7 @@ import type { CachedPlayer } from "./types/cache/cached-player";
 import type { CachedPlayerName } from "./types/cache/cached-player-name";
 import type { ServerPlatform } from "./types/server/server";
 import type { Cape } from "./types/player/cape/cape";
+import { ServerRegistryEntry } from "./types/server-registry/server-registry-entry";
 
 export class McUtilsAPI {
   private readonly endpoint: string;
@@ -310,6 +311,22 @@ export class McUtilsAPI {
       error: (await response.json()) as ErrorResponse,
     };
   }
+
+  /**
+   * Fetch the list of available server registry entries.
+   *
+   * @param query the query to search for (eg: aetheria)
+   * @returns the list of server registry entries or the error (if one occurred)
+   */
+  async fetchServerRegistryEntries(query: string): Promise<{ entries?: ServerRegistryEntry[]; error?: ErrorResponse }> {
+    const response = await fetch(`${this.endpoint}/servers${this.buildParams({ query: query })}`);
+    if (response.ok) {
+      return { entries: (await response.json()) as ServerRegistryEntry[] };
+    }
+    return {
+      error: (await response.json()) as ErrorResponse,
+    };
+  }
 }
 
 export default McUtilsAPI;

src/test.ts

@@ -2,9 +2,6 @@ import McUtilsAPI from ".";
 
 const api = new McUtilsAPI();
 
-api.fetchJavaServer("aetheria.cc").then((result) => {
+api.fetchServerRegistryEntries("wild").then((result) => {
   console.log(result);
-});
-api.fetchPlayer("ImFascinated").then((result) => {
-  console.log(result.player?.skin?.parts.FULLBODY_FRONT);
 });