add statistics endpoint

Author: RealFascinated

package.json

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

src/index.ts

@@ -8,6 +8,7 @@ import type { Cape } from "./types/player/cape/cape";
 import { ServerRegistryEntry } from "./types/server-registry/server-registry-entry";
 import { Player } from "./types/player/player";
 import { CachedPlayerName } from "./types/cache/cached-player-name";
+import { StatisticsResponse } from "./types/response/statistics-response";
 
 export class McUtilsAPI {
   private readonly endpoint: string;
@@ -327,6 +328,21 @@ export class McUtilsAPI {
       error: (await response.json()) as ErrorResponse,
     };
   }
+
+  /**
+   * Fetch the statistics of the API.
+   *
+   * @returns the statistics or the error (if one occurred)
+   */
+  async fetchStatistics(): Promise<{ statistics?: StatisticsResponse; error?: ErrorResponse }> {
+    const response = await fetch(`${this.endpoint}/statistics`);
+    if (response.ok) {
+      return { statistics: (await response.json()) as StatisticsResponse };
+    }
+    return {
+      error: (await response.json()) as ErrorResponse,
+    };
+  }
 }
 
 export default McUtilsAPI;

src/types/response/statistics-response.ts

@@ -0,0 +1,5 @@
+export type StatisticsResponse = {
+    seenPlayers: number;
+    seenSkins: number;
+    seenCapes: number;
+};