skin route

Author: RealFascinated

package.json

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

src/index.ts

@@ -12,7 +12,8 @@ import { StatisticsResponse } from "./types/response/statistics-response";
 import { Skin } from "./types/player/skin/skin";
 import { Page } from "./types/pagination/pagination";
 import { PlayerSearchEntry } from "./types/player/player-search-entry";
-import { SkinsResponsePage } from "./types/response/skins-response";
+import { SkinsResponsePage } from "./types/response/skin/skins-response";
+import { SkinDTO } from "./types/response/skin/skin-dto";
 
 type RequestOptions = RequestInit & { responseType?: "json" | "arrayBuffer" };
 
@@ -333,6 +334,17 @@ export class McUtilsAPI {
     const { data, error } = await this.request<PlayerSearchEntry[]>(`/players${this.buildParams({ query: query })}`);
     return error ? { error } : { entries: data };
   }
+
+  /**
+   * Fetch the details of a specific skin.
+   *
+   * @param id the ID of the skin (UUID)
+   * @returns the skin details or the error (if one occurred)
+   */
+  async fetchSkin(id: string): Promise<{ skin?: SkinDTO; error?: ErrorResponse }> {
+    const { data, error } = await this.request<SkinDTO>(`/skins/${id}`);
+    return error ? { error } : { skin: data };
+  }
 }
 
 export default McUtilsAPI;

src/types/response/skin/skin-dto.ts

@@ -0,0 +1,7 @@
+export type SkinDTO = {
+    id: string;
+    imageUrl: string;
+    accountsUsed: number;
+    firstSeenUsing: string;
+    accountsSeenUsing: string[];
+};

src/types/response/skins-response.ts src/types/response/skin/skins-response.tssrc/types/response/skins-response.ts renamed to src/types/response/skin/skins-response.ts

@@ -1,4 +1,4 @@
-import { Page } from "../pagination/pagination";
+import { Page } from "../../pagination/pagination";
 
 export type SkinsResponse = {
     id: string;