mcutils-js-api 2.0.41 → 2.0.43

package/dist/index.d.ts

@@ -9,7 +9,8 @@ import { Player } from "./types/player/player";
 import { CachedPlayerName } from "./types/cache/cached-player-name";
 import { StatisticsResponse } from "./types/response/statistics-response";
 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";
 export declare class McUtilsAPI {
     private readonly endpoint;
     private readonly fetchOptions?;
@@ -215,5 +216,15 @@ export declare class McUtilsAPI {
         entries?: PlayerSearchEntry[];
         error?: ErrorResponse;
     }>;
+    /**
+     * 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)
+     */
+    fetchSkin(id: string): Promise<{
+        skin?: SkinDTO;
+        error?: ErrorResponse;
+    }>;
 }
 export default McUtilsAPI;

package/dist/index.js

@@ -217,5 +217,15 @@ export class McUtilsAPI {
         const { data, error } = await this.request(`/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) {
+        const { data, error } = await this.request(`/skins/${id}`);
+        return error ? { error } : { skin: data };
+    }
 }
 export default McUtilsAPI;

package/dist/types/response/skin/skin-dto.d.ts

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

package/dist/types/response/{skins-response.d.ts → skin/skins-response.d.ts}

@@ -1,5 +1,6 @@
-import { Page } from "../pagination/pagination";
+import { Page } from "../../pagination/pagination";
 export type SkinsResponse = {
+    id: string;
     imageUrl: string;
     accountsUsed: number;
 };

package/dist/types/response/skin/skins-response.js

@@ -0,0 +1 @@
+export {};

package/package.json

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