mcutils-js-api 2.0.17 → 2.0.18

package/dist/index.d.ts

@@ -132,12 +132,24 @@ export declare class McUtilsAPI {
         error?: ErrorResponse;
     }>;
     /**
-     * Fetch a cape texture image by cape texture id.
+     * Fetch a cape texture image.
      *
-     * @param id the cape texture id (eg: from player.cape or a texture hash)
+     * @param query player UUID/username or 64-char cape texture id
      * @returns the cape PNG image or the error (if one occurred)
      */
-    fetchPlayerCapeTexture(id: string): Promise<{
+    fetchCapeTexture(query: string): Promise<{
+        image?: ArrayBuffer;
+        error?: ErrorResponse;
+    }>;
+    /**
+     * Fetch a rendered cape part (e.g. front).
+     *
+     * @param query player UUID/username or 64-char cape texture id
+     * @param type cape part (e.g. front) – see CapeRendererType
+     * @param size image height (default 768)
+     * @returns the cape part PNG image or the error (if one occurred)
+     */
+    fetchCapePart(query: string, type: string, size?: number): Promise<{
         image?: ArrayBuffer;
         error?: ErrorResponse;
     }>;

package/dist/index.js

@@ -195,13 +195,30 @@ export class McUtilsAPI {
         };
     }
     /**
-     * Fetch a cape texture image by cape texture id.
+     * Fetch a cape texture image.
      *
-     * @param id the cape texture id (eg: from player.cape or a texture hash)
+     * @param query player UUID/username or 64-char cape texture id
      * @returns the cape PNG image or the error (if one occurred)
      */
-    async fetchPlayerCapeTexture(id) {
-        const response = await fetch(`${this.endpoint}/cape/${id}/texture.png`);
+    async fetchCapeTexture(query) {
+        const response = await fetch(`${this.endpoint}/cape/${query}/texture.png`);
+        if (response.ok) {
+            return { image: await response.arrayBuffer() };
+        }
+        return {
+            error: (await response.json()),
+        };
+    }
+    /**
+     * Fetch a rendered cape part (e.g. front).
+     *
+     * @param query player UUID/username or 64-char cape texture id
+     * @param type cape part (e.g. front) – see CapeRendererType
+     * @param size image height (default 768)
+     * @returns the cape part PNG image or the error (if one occurred)
+     */
+    async fetchCapePart(query, type, size = 768) {
+        const response = await fetch(`${this.endpoint}/cape/${query}/${type}.png${this.buildParams({ size: String(size) })}`);
         if (response.ok) {
             return { image: await response.arrayBuffer() };
         }

package/dist/types/cape/cape.d.ts

@@ -0,0 +1,5 @@
+export type CapeRendererType = "FRONT";
+export type Cape = {
+    textureUrl: string;
+    parts: Record<string, string>;
+};

package/dist/types/cape/cape.js

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

package/dist/types/player/player.d.ts

@@ -1,3 +1,4 @@
+import { Cape } from "../cape/cape";
 export type SkinModel = "DEFAULT" | "SLIM";
 export type SkinPart = "HEAD" | "FULLBODY_FRONT" | "FULLBODY_BACK" | "FACE" | "BODY";
 export type SkinParts = Record<SkinPart, string>;
@@ -7,9 +8,6 @@ export type Skin = {
     textureUrl: string;
     parts: SkinParts;
 };
-export type Cape = {
-    textureUrl: string;
-};
 export type ProfileProperty = {
     name: string;
     value: string;

package/package.json

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