hive-bedrock-api 3.0.0-alpha.2 → 3.0.0-alpha.20

package/README.md

@@ -3,7 +3,7 @@
 An API wrapper for the Hive Minecraft Bedrock Edition server. Which allows you to get stats for leaderboards, players, cosmetics, unique player counts, maps and metadata.
 
 > [!NOTE]
-> This API responses returnded from this package will differ from the responses returned by the offical Hive API. This due to our preference and needs when using this package on [Hive Backpack](https://hivebackpack.com).
+> This API responses returned from this package will differ from the responses returned by the official Hive API. This due to our preference and needs when using this package on [Hive Backpack](https://hivebackpack.com).
 
 ## Getting started
 
@@ -16,7 +16,7 @@ You should also include `hive-bedrock-data` as it includes useful functions and
 
 ## Usage
 
-To start using this API wrapper you may construct the main class `HiveAPI`. This class can take in seperate options that will be used in every http request.
+To start using the API, construct the main class `HiveAPI`. This class takes in options that will be used in every HTTP request.
 
 ```ts
 const api = new HiveAPI({

package/lib/index.d.ts

@@ -5,9 +5,10 @@ import { ProcessedGlobalStatisticsResponse } from "./processors/global_statistic
 import { ProcessedMapResponse } from "./processors/map";
 import { ProcessedGameMetadata } from "./processors/meta";
 import { ProcessedPlayerSearchResponse } from "./processors/player_search";
-import { ProcessedAllGamesResponse, ProcessedGame } from "./processors/game";
+import { AvailableLeaderboardResponse, ProcessedAllGamesResponse, ProcessedGame, ProcessedMonthlyGamesResponse } from "./processors/game";
 interface Options {
     resolveDynamicTitles?: boolean;
+    useModernLeaderboardSource?: boolean;
     apiBaseEndpoint?: string;
     requestInit?: RequestInit;
 }
@@ -41,14 +42,15 @@ export default class HiveAPI {
     getStatistics(identifier: string, timeframe: Timeframe.Monthly, options?: {
         month?: number;
         year?: number;
-    }): Promise<MethodResponse<ProcessedAllGamesResponse>>;
+    }): Promise<MethodResponse<ProcessedMonthlyGamesResponse>>;
     getStatistics<G extends Game>(identifier: string, timeframe: Timeframe.Monthly, options: {
         game: G;
         month?: number;
         year?: number;
-    }): Promise<MethodResponse<ProcessedGame<Timeframe.AllTime, false>[G]>>;
+    }): Promise<MethodResponse<ProcessedGame<Timeframe.Monthly, false>[G]>>;
     private _getStatisticsAllTime;
     private _getStatisticsMonthly;
+    getAvailableMonthlyLeaderboards<G extends Game>(game: G): Promise<MethodResponse<AvailableLeaderboardResponse>>;
     /**
      * `/game/season/player/{game}/{player}/{season}` Gets seasonal statistics for a player
      * @param identifier Username or UUID of the player
@@ -65,6 +67,10 @@ export default class HiveAPI {
      */
     getLeaderboard<G extends Game>(timeframe: Timeframe.AllTime, game: G): Promise<MethodResponse<ProcessedGame<Timeframe.AllTime, true>[G][] | null>>;
     getLeaderboard<G extends Game>(timeframe: Timeframe.Monthly, game: G): Promise<MethodResponse<ProcessedGame<Timeframe.Monthly, true>[G][] | null>>;
+    getLeaderboard<G extends Game>(timeframe: Timeframe.Monthly, game: G, options: {
+        month?: number;
+        year?: number;
+    }): Promise<MethodResponse<ProcessedGame<Timeframe.Monthly, true>[G][] | null>>;
     private _getLeaderboardAllTime;
     private _getLeaderboardMonthly;
     /**

package/lib/index.js

@@ -72,8 +72,11 @@ var player_search_1 = __importDefault(require("./processors/player_search"));
 var game_1 = __importDefault(require("./processors/game"));
 var HiveAPI = /** @class */ (function () {
     function HiveAPI(options) {
-        if (options === void 0) { options = { resolveDynamicTitles: true, apiBaseEndpoint: hive_bedrock_data_1.API_BASE_ENDPOINT }; }
+        if (options === void 0) { options = {}; }
+        var _a;
         this.options = options;
+        this.options = options;
+        this.options.apiBaseEndpoint = (_a = this.options.apiBaseEndpoint) !== null && _a !== void 0 ? _a : hive_bedrock_data_1.API_BASE_ENDPOINT;
     }
     HiveAPI.prototype._fetchAPI = function (endpoint) {
         return __awaiter(this, void 0, void 0, function () {
@@ -87,7 +90,7 @@ var HiveAPI = /** @class */ (function () {
                     case 1:
                         _c.trys.push([1, 4, , 5]);
                         start = performance.now();
-                        return [4 /*yield*/, fetch(url, __assign(__assign({}, this.options.requestInit), { headers: __assign({ "X-Hive-Resolve-Stat-Track": ((_a = this.options.resolveDynamicTitles) !== null && _a !== void 0 ? _a : true).toString() }, (_b = this.options.requestInit) === null || _b === void 0 ? void 0 : _b.headers) }))];
+                        return [4 /*yield*/, fetch(url, __assign(__assign({}, this.options.requestInit), { headers: __assign({ "X-Hive-Resolve-Stat-Track": ((_a = this.options.resolveDynamicTitles) !== null && _a !== void 0 ? _a : true).toString(), "X-Hive-Leaderboard-Source": this.options.useModernLeaderboardSource ? "modern" : "legacy" }, (_b = this.options.requestInit) === null || _b === void 0 ? void 0 : _b.headers) }))];
                     case 2:
                         request = _c.sent();
                         if (!request.ok)
@@ -232,6 +235,21 @@ var HiveAPI = /** @class */ (function () {
             });
         });
     };
+    HiveAPI.prototype.getAvailableMonthlyLeaderboards = function (game) {
+        return __awaiter(this, void 0, void 0, function () {
+            var _a, response, error, meta;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0: return [4 /*yield*/, this._fetchAPI("/game/monthly/".concat(game, "/available"))];
+                    case 1:
+                        _a = _b.sent(), response = _a.data, error = _a.error, meta = _a.meta;
+                        if (error)
+                            return [2 /*return*/, { data: null, error: error, meta: meta }];
+                        return [2 /*return*/, { data: response, error: null, meta: meta }];
+                }
+            });
+        });
+    };
     /**
      * `/game/season/player/{game}/{player}/{season}` Gets seasonal statistics for a player
      * @param identifier Username or UUID of the player

package/lib/processors/build.d.ts

@@ -1,19 +1,19 @@
 import { Game, Statistics, Timeframe } from "hive-bedrock-data";
 import { OmittedSpecialStatistics } from "../types/types";
-export interface Processed_JustBuild_AllTimeStatistics extends OmittedSpecialStatistics<Game.JustBuild, Timeframe.AllTime> {
-    id: Game.JustBuild;
+export interface Processed_BuildBattle_AllTimeStatistics extends OmittedSpecialStatistics<Game.BuildBattle, Timeframe.AllTime> {
+    id: Game.BuildBattle;
     level: number;
     losses: number;
     win_percentage: number;
     total_ratings: number;
     first_played: number | null;
 }
-export interface Processed_JustBuild_MonthlyStatistics extends Statistics<Game.JustBuild, Timeframe.Monthly> {
-    id: Game.JustBuild;
+export interface Processed_BuildBattle_MonthlyStatistics extends Statistics<Game.BuildBattle, Timeframe.Monthly> {
+    id: Game.BuildBattle;
     level: number;
     total_ratings: number;
     losses: number;
     win_percentage: number;
 }
-export declare function processAllTime_BUILD(statistics: Partial<Statistics<Game.JustBuild, Timeframe.AllTime>>): Processed_JustBuild_AllTimeStatistics | null;
-export declare function processMonthly_BUILD(statistics: Partial<Statistics<Game.JustBuild, Timeframe.Monthly>>): Processed_JustBuild_MonthlyStatistics | null;
+export declare function processAllTime_BUILD(statistics: Partial<Statistics<Game.BuildBattle, Timeframe.AllTime>>): Processed_BuildBattle_AllTimeStatistics | null;
+export declare function processMonthly_BUILD(statistics: Partial<Statistics<Game.BuildBattle, Timeframe.Monthly>>): Processed_BuildBattle_MonthlyStatistics | null;

package/lib/processors/build.js

@@ -24,12 +24,12 @@ function processAllTime_BUILD(statistics) {
     var _a;
     if (!statistics || Array.isArray(statistics))
         return null;
-    return __assign(__assign(__assign(__assign({ UUID: statistics.UUID }, (0, processGameAndXP_1.default)(hive_bedrock_data_1.Game.JustBuild, statistics.xp)), (0, processPlayedAndVictories_1.default)(statistics.played, statistics.victories)), (0, processBuildRatings_1.default)(statistics.rating_love_received, statistics.rating_great_received, statistics.rating_good_received, statistics.rating_okay_received, statistics.rating_meh_received)), { first_played: (_a = statistics.first_played) !== null && _a !== void 0 ? _a : null });
+    return __assign(__assign(__assign(__assign({ UUID: statistics.UUID }, (0, processGameAndXP_1.default)(hive_bedrock_data_1.Game.BuildBattle, statistics.xp)), (0, processPlayedAndVictories_1.default)(statistics.played, statistics.victories)), (0, processBuildRatings_1.default)(statistics.rating_love_received, statistics.rating_great_received, statistics.rating_good_received, statistics.rating_okay_received, statistics.rating_meh_received)), { first_played: (_a = statistics.first_played) !== null && _a !== void 0 ? _a : null });
 }
 function processMonthly_BUILD(statistics) {
     var _a, _b;
     if (!statistics || Array.isArray(statistics))
         return null;
     var index = (_a = statistics.index) !== null && _a !== void 0 ? _a : 0;
-    return __assign(__assign(__assign({ index: (_b = statistics.index) !== null && _b !== void 0 ? _b : 0, human_index: index + 1, username: statistics.username }, (0, processGameAndXP_1.default)(hive_bedrock_data_1.Game.JustBuild, statistics.xp)), (0, processPlayedAndVictories_1.default)(statistics.played, statistics.victories)), (0, processBuildRatings_1.default)(statistics.rating_love_received, statistics.rating_great_received, statistics.rating_good_received, statistics.rating_okay_received, statistics.rating_meh_received));
+    return __assign(__assign(__assign({ index: (_b = statistics.index) !== null && _b !== void 0 ? _b : 0, human_index: index + 1, username: statistics.username }, (0, processGameAndXP_1.default)(hive_bedrock_data_1.Game.BuildBattle, statistics.xp)), (0, processPlayedAndVictories_1.default)(statistics.played, statistics.victories)), (0, processBuildRatings_1.default)(statistics.rating_love_received, statistics.rating_great_received, statistics.rating_good_received, statistics.rating_okay_received, statistics.rating_meh_received));
 }

package/lib/processors/game.d.ts

@@ -88,7 +88,7 @@ export interface ProcessedGameGROUND {
     projectiles_fired: number;
 }
 export interface ProcessedGameBUILD {
-    id: Game.JustBuild;
+    id: Game.BuildBattle;
     xp: number;
     played: number;
     victories: number;
@@ -128,7 +128,7 @@ export interface ProcessedGameMURDER {
     prestige: number;
 }
 export interface ProcessedGameSKY {
-    id: Game.Skywars;
+    id: Game.SkyWars;
     xp: number;
     played: number;
     victories: number;
@@ -140,9 +140,10 @@ export interface ProcessedGameSKY {
     mystery_chests_destroyed: number;
     ores_mined: number;
     spells_used: number;
+    prestige: number;
 }
 export interface ProcessedGameSKYKITS {
-    id: Game.SkywarsKits;
+    id: Game.SkyWarsKits;
     xp: number;
     played: number;
     victories: number;
@@ -157,7 +158,7 @@ export interface ProcessedGameSKYKITS {
     selected_kit: string;
 }
 export interface ProcessedGameSKYCLASSIC {
-    id: Game.SkywarsClassic;
+    id: Game.SkyWarsClassic;
     xp: number;
     played: number;
     victories: number;
@@ -241,7 +242,10 @@ export type AdditionalStatistics<T extends Timeframe, L extends boolean> = (T ex
     level: number;
 } & (L extends true ? {} : {
     first_played: number;
-}) : {}) & (L extends true ? {
+}) : {
+    position: number;
+    username: string;
+}) & (L extends true ? {
     position: number;
     username: string;
     UUID: string;
@@ -254,17 +258,19 @@ export interface ProcessedGame<T extends Timeframe, L extends boolean> {
     [Game.DeathRun]: ProcessedGameDR & AdditionalStatistics<T, L>;
     [Game.Gravity]: ProcessedGameGRAV & AdditionalStatistics<T, L>;
     [Game.GroundWars]: ProcessedGameGROUND & AdditionalStatistics<T, L>;
-    [Game.JustBuild]: ProcessedGameBUILD & AdditionalStatistics<T, L>;
+    [Game.BuildBattle]: ProcessedGameBUILD & AdditionalStatistics<T, L>;
     [Game.HideAndSeek]: ProcessedGameHIDE & AdditionalStatistics<T, L>;
     [Game.MurderMystery]: ProcessedGameMURDER & AdditionalStatistics<T, L>;
+    [Game.SkyWars]: ProcessedGameSKY & AdditionalStatistics<T, L>;
+    [Game.SkyWarsClassic]: ProcessedGameSKYCLASSIC & AdditionalStatistics<T, L>;
+    [Game.SkyWarsKits]: ProcessedGameSKYKITS & AdditionalStatistics<T, L>;
     [Game.SurvivalGames]: ProcessedGameSG & AdditionalStatistics<T, L>;
     [Game.TheBridge]: ProcessedGameBRIDGE & AdditionalStatistics<T, L>;
     [Game.TreasureWars]: ProcessedGameWARS & AdditionalStatistics<T, L>;
-    [Game.ParkourWorlds]: ProcessedGamePARKOUR;
+    [Game.ParkourWorlds]: L extends true ? never : T extends Timeframe.Monthly ? never : ProcessedGamePARKOUR;
 }
 export default function processGame<G extends Game, T extends Timeframe, L extends boolean>(game: G, timeframe: T, isLeaderboard: L, response: any): ProcessedGame<T, L>[G] | null;
 export declare const processors: {
-    [x: number]: ((response: any) => ProcessedGameSKY) | ((response: any) => ProcessedGameSKYCLASSIC);
     bed: (response: any) => ProcessedGameBED;
     drop: (response: any) => ProcessedGameDROP;
     party: (response: any) => ProcessedGamePARTY;
@@ -275,10 +281,13 @@ export declare const processors: {
     build: (response: any) => ProcessedGameBUILD;
     hide: (response: any) => ProcessedGameHIDE;
     murder: (response: any) => ProcessedGameMURDER;
+    sky: (response: any) => ProcessedGameSKY;
+    "sky-kits": (response: any) => ProcessedGameSKYKITS;
+    "sky-classic": (response: any) => ProcessedGameSKYCLASSIC;
     sg: (response: any) => ProcessedGameSG;
     bridge: (response: any) => ProcessedGameBRIDGE;
     wars: (response: any) => ProcessedGameWARS;
-    parkour: (response: any) => ProcessedGamePARKOUR;
+    parkour: (response: any) => ProcessedGamePARKOUR | null;
 };
 export declare function validateNumber(value: number, def?: number): number;
 export declare function calculateKDR(kills: number, deaths: number): number;
@@ -297,3 +306,10 @@ export interface ProcessedMonthlyGamesResponse {
         [G in Game]: ProcessedGame<Timeframe.Monthly, false>[G] | null;
     };
 }
+export interface AvailableLeaderboard {
+    month: string;
+    year: string;
+    month_number: number;
+    resource: string;
+}
+export type AvailableLeaderboardResponse = AvailableLeaderboard[];

package/lib/processors/game.js

@@ -35,15 +35,17 @@ function processGame(game, timeframe, isLeaderboard, response) {
     if (Array.isArray(response))
         return null;
     var data = exports.processors[game](response);
+    if (!data)
+        return null;
     if ("played" in data && data.played === 0)
         return null;
     if (timeframe === hive_bedrock_data_1.Timeframe.AllTime && "xp" in data)
         data.level = (_a = (0, hive_bedrock_data_1.calculateLevelFromXP)(data.xp, game)) !== null && _a !== void 0 ? _a : 1;
-    if (timeframe === hive_bedrock_data_1.Timeframe.AllTime && "first_played" in data)
+    if (timeframe === hive_bedrock_data_1.Timeframe.AllTime && "first_played" in response)
         data.first_played = response.first_played;
-    if (isLeaderboard && data.id !== hive_bedrock_data_1.Game.ParkourWorlds)
+    if ((isLeaderboard || timeframe === hive_bedrock_data_1.Timeframe.Monthly) && data.id !== hive_bedrock_data_1.Game.ParkourWorlds)
         data.position = response.human_index;
-    if (isLeaderboard && data.id !== hive_bedrock_data_1.Game.ParkourWorlds)
+    if ((isLeaderboard || timeframe === hive_bedrock_data_1.Timeframe.Monthly) && data.id !== hive_bedrock_data_1.Game.ParkourWorlds)
         data.username = response.username;
     if (isLeaderboard && data.id !== hive_bedrock_data_1.Game.ParkourWorlds)
         data.UUID = response.UUID;
@@ -158,10 +160,10 @@ exports.processors = (_a = {},
             projectiles_fired: (_h = response.projectiles_fired) !== null && _h !== void 0 ? _h : 0,
         });
     },
-    _a[hive_bedrock_data_1.Game.JustBuild] = function (response) {
+    _a[hive_bedrock_data_1.Game.BuildBattle] = function (response) {
         var _a, _b, _c, _d, _e, _f, _g, _h;
         return ({
-            id: hive_bedrock_data_1.Game.JustBuild,
+            id: hive_bedrock_data_1.Game.BuildBattle,
             xp: (_a = response.xp) !== null && _a !== void 0 ? _a : 0,
             played: (_b = response.played) !== null && _b !== void 0 ? _b : 0,
             victories: (_c = response.victories) !== null && _c !== void 0 ? _c : 0,
@@ -213,10 +215,10 @@ exports.processors = (_a = {},
             prestige: (_h = response.prestige) !== null && _h !== void 0 ? _h : 0,
         });
     },
-    _a[hive_bedrock_data_1.Game.Skywars] = function (response) {
-        var _a, _b, _c, _d, _e, _f, _g, _h;
+    _a[hive_bedrock_data_1.Game.SkyWars] = function (response) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
         return ({
-            id: hive_bedrock_data_1.Game.Skywars,
+            id: hive_bedrock_data_1.Game.SkyWars,
             xp: (_a = response.xp) !== null && _a !== void 0 ? _a : 0,
             played: (_b = response.played) !== null && _b !== void 0 ? _b : 0,
             victories: (_c = response.victories) !== null && _c !== void 0 ? _c : 0,
@@ -228,12 +230,13 @@ exports.processors = (_a = {},
             mystery_chests_destroyed: (_f = response.mystery_chests_destroyed) !== null && _f !== void 0 ? _f : 0,
             ores_mined: (_g = response.ores_mined) !== null && _g !== void 0 ? _g : 0,
             spells_used: (_h = response.spells_used) !== null && _h !== void 0 ? _h : 0,
+            prestige: (_j = response.prestige) !== null && _j !== void 0 ? _j : 0,
         });
     },
-    _a[hive_bedrock_data_1.Game.SkywarsKits] = function (response) {
+    _a[hive_bedrock_data_1.Game.SkyWarsKits] = function (response) {
         var _a, _b, _c, _d, _e, _f, _g, _h;
         return ({
-            id: hive_bedrock_data_1.Game.SkywarsKits,
+            id: hive_bedrock_data_1.Game.SkyWarsKits,
             xp: (_a = response.xp) !== null && _a !== void 0 ? _a : 0,
             played: (_b = response.played) !== null && _b !== void 0 ? _b : 0,
             victories: (_c = response.victories) !== null && _c !== void 0 ? _c : 0,
@@ -248,10 +251,10 @@ exports.processors = (_a = {},
             selected_kit: response.selected_kit,
         });
     },
-    _a[hive_bedrock_data_1.Game.SkywarsClassic] = function (response) {
+    _a[hive_bedrock_data_1.Game.SkyWarsClassic] = function (response) {
         var _a, _b, _c, _d, _e;
         return ({
-            id: hive_bedrock_data_1.Game.SkywarsClassic,
+            id: hive_bedrock_data_1.Game.SkyWarsClassic,
             xp: (_a = response.xp) !== null && _a !== void 0 ? _a : 0,
             played: (_b = response.played) !== null && _b !== void 0 ? _b : 0,
             victories: (_c = response.victories) !== null && _c !== void 0 ? _c : 0,
@@ -317,49 +320,51 @@ exports.processors = (_a = {},
     },
     _a[hive_bedrock_data_1.Game.ParkourWorlds] = function (response) {
         var _a;
-        return ({
-            id: hive_bedrock_data_1.Game.ParkourWorlds,
-            worlds: Object.entries(response.parkours)
-                .filter(function (_a) {
-                var _b = __read(_a, 2), _ = _b[0], value = _b[1];
-                return typeof value === "object";
-            })
-                .map(function (_a) {
-                var _b;
-                var _c = __read(_a, 2), key = _c[0], value = _c[1];
-                return ({
-                    name: key,
-                    parkour_stars: (_b = value.parkour_stars) !== null && _b !== void 0 ? _b : 0,
-                    courses: Object.entries(value)
-                        .filter(function (_a) {
-                        var _b = __read(_a, 2), _ = _b[0], value = _b[1];
-                        return typeof value === "object";
-                    })
-                        .map(function (_a) {
-                        var _b;
-                        var _c = __read(_a, 2), key = _c[0], value = _c[1];
-                        return ({
-                            name: key,
-                            best_run_time: value.best_run_time,
-                            best_checkpoint_times: Object.entries(value.best_checkpoint_times).map(function (_a) {
-                                var _b = __read(_a, 2), key = _b[0], value = _b[1];
-                                return ({
-                                    position: { x: Number(key.split(",")[0]), y: Number(key.split(",")[1]), z: Number(key.split(",")[2]) },
-                                    time: value,
-                                });
-                            }),
-                            collected_stars: value.collected_stars.map(function (value) { return ({
-                                x: Number(value.split(",")[0]),
-                                y: Number(value.split(",")[1]),
-                                z: Number(value.split(",")[2]),
-                            }); }),
-                            course_stars: (_b = value.course_stars) !== null && _b !== void 0 ? _b : 0,
-                        });
-                    }),
-                });
-            }),
-            total_stars: (_a = response.parkours.total_stars) !== null && _a !== void 0 ? _a : 0,
-        });
+        return response.parkours
+            ? {
+                id: hive_bedrock_data_1.Game.ParkourWorlds,
+                worlds: Object.entries(response.parkours)
+                    .filter(function (_a) {
+                    var _b = __read(_a, 2), _ = _b[0], value = _b[1];
+                    return typeof value === "object";
+                })
+                    .map(function (_a) {
+                    var _b;
+                    var _c = __read(_a, 2), key = _c[0], value = _c[1];
+                    return ({
+                        name: key,
+                        parkour_stars: (_b = value.parkour_stars) !== null && _b !== void 0 ? _b : 0,
+                        courses: Object.entries(value)
+                            .filter(function (_a) {
+                            var _b = __read(_a, 2), _ = _b[0], value = _b[1];
+                            return typeof value === "object";
+                        })
+                            .map(function (_a) {
+                            var _b;
+                            var _c = __read(_a, 2), key = _c[0], value = _c[1];
+                            return ({
+                                name: key,
+                                best_run_time: value.best_run_time,
+                                best_checkpoint_times: Object.entries(value.best_checkpoint_times).map(function (_a) {
+                                    var _b = __read(_a, 2), key = _b[0], value = _b[1];
+                                    return ({
+                                        position: { x: Number(key.split(",")[0]), y: Number(key.split(",")[1]), z: Number(key.split(",")[2]) },
+                                        time: value,
+                                    });
+                                }),
+                                collected_stars: value.collected_stars.map(function (value) { return ({
+                                    x: Number(value.split(",")[0]),
+                                    y: Number(value.split(",")[1]),
+                                    z: Number(value.split(",")[2]),
+                                }); }),
+                                course_stars: (_b = value.course_stars) !== null && _b !== void 0 ? _b : 0,
+                            });
+                        }),
+                    });
+                }),
+                total_stars: (_a = response.parkours.total_stars) !== null && _a !== void 0 ? _a : 0,
+            }
+            : null;
     },
     _a);
 function validateNumber(value, def) {

package/lib/processors/index.js

@@ -28,7 +28,7 @@ exports.AllTimeProcessors = (_a = {},
     _a[hive_bedrock_data_1.Game.Gravity] = grav_1.processAllTime_GRAV,
     _a[hive_bedrock_data_1.Game.GroundWars] = ground_1.processAllTime_GROUND,
     _a[hive_bedrock_data_1.Game.HideAndSeek] = hide_1.processAllTime_HIDE,
-    _a[hive_bedrock_data_1.Game.JustBuild] = build_1.processAllTime_BUILD,
+    _a[hive_bedrock_data_1.Game.BuildBattle] = build_1.processAllTime_BUILD,
     _a[hive_bedrock_data_1.Game.MurderMystery] = murder_1.processAllTime_MURDER,
     _a[hive_bedrock_data_1.Game.ParkourWorlds] = parkour_1.processAllTime_PARKOUR,
     _a[hive_bedrock_data_1.Game.Skywars] = sky_1.processAllTime_SKY,
@@ -45,7 +45,7 @@ exports.MonthlyProcessors = (_b = {},
     _b[hive_bedrock_data_1.Game.Gravity] = grav_1.processMonthly_GRAV,
     _b[hive_bedrock_data_1.Game.GroundWars] = ground_1.processMonthly_GROUND,
     _b[hive_bedrock_data_1.Game.HideAndSeek] = hide_1.processMonthly_HIDE,
-    _b[hive_bedrock_data_1.Game.JustBuild] = build_1.processMonthly_BUILD,
+    _b[hive_bedrock_data_1.Game.BuildBattle] = build_1.processMonthly_BUILD,
     _b[hive_bedrock_data_1.Game.MurderMystery] = murder_1.processMonthly_MURDER,
     _b[hive_bedrock_data_1.Game.Skywars] = sky_1.processMonthly_SKY,
     _b[hive_bedrock_data_1.Game.SurvivalGames] = sg_1.processMonthly_SG,
@@ -62,7 +62,7 @@ exports.LeaderboardProcessors = (_c = {},
     _c[hive_bedrock_data_1.Game.Gravity] = grav_1.processMonthly_GRAV,
     _c[hive_bedrock_data_1.Game.GroundWars] = ground_1.processMonthly_GROUND,
     _c[hive_bedrock_data_1.Game.HideAndSeek] = hide_1.processMonthly_HIDE,
-    _c[hive_bedrock_data_1.Game.JustBuild] = build_1.processMonthly_BUILD,
+    _c[hive_bedrock_data_1.Game.BuildBattle] = build_1.processMonthly_BUILD,
     _c[hive_bedrock_data_1.Game.MurderMystery] = murder_1.processMonthly_MURDER,
     _c[hive_bedrock_data_1.Game.Skywars] = sky_1.processMonthly_SKY,
     _c[hive_bedrock_data_1.Game.SurvivalGames] = sg_1.processMonthly_SG,

package/lib/processors/player.d.ts

@@ -13,26 +13,49 @@ export interface ProcessedPlayerResponse {
         quest_count: number;
     };
     equipped_cosmetics: {
-        costume: string;
-        avatar: {
-            name: string;
-            url: string;
-        };
-        hub_title: string;
-        hat: string;
-        backbling: string;
+        costume: CosmeticResponseTypes[CosmeticType.Costume];
+        avatar: CosmeticResponseTypes[CosmeticType.Avatar];
+        hub_title: CosmeticResponseTypes[CosmeticType.HubTitle];
+        hat: CosmeticResponseTypes[CosmeticType.Hat];
+        backbling: CosmeticResponseTypes[CosmeticType.Backbling];
     };
     owned_cosmetics: {
-        costume: string[];
-        avatar: {
-            name: string;
-            url: string;
-        }[];
-        hub_title: string[];
-        hat: string[];
-        pet: string[];
-        mount: string[];
-        backbling: string[];
+        costume: CosmeticResponseTypes[CosmeticType.Costume][];
+        avatar: CosmeticResponseTypes[CosmeticType.Avatar][];
+        hub_title: CosmeticResponseTypes[CosmeticType.HubTitle][];
+        hat: CosmeticResponseTypes[CosmeticType.Hat][];
+        pet: CosmeticResponseTypes[CosmeticType.Pet][];
+        mount: CosmeticResponseTypes[CosmeticType.Mount][];
+        backbling: CosmeticResponseTypes[CosmeticType.Backbling][];
+    };
+}
+export declare enum CosmeticType {
+    Costume = "costume",
+    Avatar = "avatar",
+    HubTitle = "hub_title",
+    Hat = "hat",
+    Pet = "pet",
+    Mount = "mount",
+    Backbling = "backbling"
+}
+export interface CosmeticResponseTypes {
+    [CosmeticType.Costume]: string;
+    [CosmeticType.Avatar]: {
+        name: string;
+        url: string;
+    };
+    [CosmeticType.HubTitle]: string;
+    [CosmeticType.Hat]: {
+        name: string;
+        icon: string;
+        rarity: string;
+    };
+    [CosmeticType.Pet]: string;
+    [CosmeticType.Mount]: string;
+    [CosmeticType.Backbling]: {
+        name: string;
+        icon: string;
+        rarity: string;
     };
 }
 export default function processPlayerInfo(playerResponse: any): ProcessedPlayerResponse | null;

package/lib/processors/player.js

@@ -1,6 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.CosmeticType = void 0;
 exports.default = processPlayerInfo;
+var CosmeticType;
+(function (CosmeticType) {
+    CosmeticType["Costume"] = "costume";
+    CosmeticType["Avatar"] = "avatar";
+    CosmeticType["HubTitle"] = "hub_title";
+    CosmeticType["Hat"] = "hat";
+    CosmeticType["Pet"] = "pet";
+    CosmeticType["Mount"] = "mount";
+    CosmeticType["Backbling"] = "backbling";
+})(CosmeticType || (exports.CosmeticType = CosmeticType = {}));
 function processPlayerInfo(playerResponse) {
     var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
     if (!playerResponse)

package/lib/processors/sky.js

@@ -21,15 +21,15 @@ var processGameAndXP_1 = __importDefault(require("./helpers/processGameAndXP"));
 var processPlayedAndVictories_1 = __importDefault(require("./helpers/processPlayedAndVictories"));
 var processKillsAndDeaths_1 = __importDefault(require("./helpers/processKillsAndDeaths"));
 function processAllTime_SKY(statistics) {
-    var _a, _b, _c, _d;
+    var _a, _b, _c, _d, _e;
     if (!statistics || Array.isArray(statistics))
         return null;
-    return __assign(__assign(__assign(__assign({ UUID: statistics.UUID }, (0, processGameAndXP_1.default)(hive_bedrock_data_1.Game.Skywars, statistics.xp)), (0, processPlayedAndVictories_1.default)(statistics.played, statistics.victories)), (0, processKillsAndDeaths_1.default)(statistics.kills, statistics.deaths)), { mystery_chests_destroyed: (_a = statistics.mystery_chests_destroyed) !== null && _a !== void 0 ? _a : 0, ores_mined: (_b = statistics.ores_mined) !== null && _b !== void 0 ? _b : 0, spells_used: (_c = statistics.spells_used) !== null && _c !== void 0 ? _c : 0, first_played: (_d = statistics.first_played) !== null && _d !== void 0 ? _d : null });
+    return __assign(__assign(__assign(__assign({ UUID: statistics.UUID }, (0, processGameAndXP_1.default)(hive_bedrock_data_1.Game.Skywars, statistics.xp)), (0, processPlayedAndVictories_1.default)(statistics.played, statistics.victories)), (0, processKillsAndDeaths_1.default)(statistics.kills, statistics.deaths)), { mystery_chests_destroyed: (_a = statistics.mystery_chests_destroyed) !== null && _a !== void 0 ? _a : 0, ores_mined: (_b = statistics.ores_mined) !== null && _b !== void 0 ? _b : 0, spells_used: (_c = statistics.spells_used) !== null && _c !== void 0 ? _c : 0, prestige: (_d = statistics.prestige) !== null && _d !== void 0 ? _d : 0, first_played: (_e = statistics.first_played) !== null && _e !== void 0 ? _e : null });
 }
 function processMonthly_SKY(statistics) {
-    var _a, _b, _c, _d, _e;
+    var _a, _b, _c, _d, _e, _f;
     if (!statistics || Array.isArray(statistics))
         return null;
     var index = (_a = statistics.index) !== null && _a !== void 0 ? _a : 0;
-    return __assign(__assign(__assign(__assign({ index: (_b = statistics.index) !== null && _b !== void 0 ? _b : 0, human_index: index + 1, username: statistics.username }, (0, processGameAndXP_1.default)(hive_bedrock_data_1.Game.Skywars, statistics.xp)), (0, processPlayedAndVictories_1.default)(statistics.played, statistics.victories)), (0, processKillsAndDeaths_1.default)(statistics.kills, statistics.deaths)), { mystery_chests_destroyed: (_c = statistics.mystery_chests_destroyed) !== null && _c !== void 0 ? _c : 0, ores_mined: (_d = statistics.ores_mined) !== null && _d !== void 0 ? _d : 0, spells_used: (_e = statistics.spells_used) !== null && _e !== void 0 ? _e : 0 });
+    return __assign(__assign(__assign(__assign({ index: (_b = statistics.index) !== null && _b !== void 0 ? _b : 0, human_index: index + 1, username: statistics.username }, (0, processGameAndXP_1.default)(hive_bedrock_data_1.Game.Skywars, statistics.xp)), (0, processPlayedAndVictories_1.default)(statistics.played, statistics.victories)), (0, processKillsAndDeaths_1.default)(statistics.kills, statistics.deaths)), { mystery_chests_destroyed: (_c = statistics.mystery_chests_destroyed) !== null && _c !== void 0 ? _c : 0, ores_mined: (_d = statistics.ores_mined) !== null && _d !== void 0 ? _d : 0, spells_used: (_e = statistics.spells_used) !== null && _e !== void 0 ? _e : 0, prestige: (_f = statistics.prestige) !== null && _f !== void 0 ? _f : 0 });
 }

package/lib/types/output.d.ts

@@ -7,7 +7,7 @@ import { Processed_DeathRun_AllTimeStatistics, Processed_DeathRun_MonthlyStatist
 import { Processed_Gravity_AllTimeStatistics, Processed_Gravity_MonthlyStatistics } from "../processors/grav";
 import { Processed_GroundWars_AllTimeStatistics, Processed_GroundWars_MonthlyStatistics } from "../processors/ground";
 import { Processed_HideAndSeek_AllTimeStatistics, Processed_HideAndSeek_MonthlyStatistics } from "../processors/hide";
-import { Processed_JustBuild_AllTimeStatistics, Processed_JustBuild_MonthlyStatistics } from "../processors/build";
+import { Processed_BuildBattle_AllTimeStatistics, Processed_BuildBattle_MonthlyStatistics } from "../processors/build";
 import { Processed_MurderMystery_AllTimeStatistics, Processed_MurderMystery_MonthlyStatistics } from "../processors/murder";
 import { Processed_ParkourWorlds_AllTimeStatistics } from "../processors/parkour";
 import { Processed_Skywars_AllTimeStatistics, Processed_Skywars_MonthlyStatistics } from "../processors/sky";
@@ -26,7 +26,7 @@ export interface AllTimeProcessedStatistics {
     [Game.Gravity]: Processed_Gravity_AllTimeStatistics;
     [Game.GroundWars]: Processed_GroundWars_AllTimeStatistics;
     [Game.HideAndSeek]: Processed_HideAndSeek_AllTimeStatistics;
-    [Game.JustBuild]: Processed_JustBuild_AllTimeStatistics;
+    [Game.BuildBattle]: Processed_BuildBattle_AllTimeStatistics;
     [Game.MurderMystery]: Processed_MurderMystery_AllTimeStatistics;
     [Game.Skywars]: Processed_Skywars_AllTimeStatistics;
     [Game.SurvivalGames]: Processed_SurvivalGames_AllTimeStatistics;
@@ -49,7 +49,7 @@ export interface MonthlyProcessedStatistics {
     [Game.Gravity]: Processed_Gravity_MonthlyStatistics;
     [Game.GroundWars]: Processed_GroundWars_MonthlyStatistics;
     [Game.HideAndSeek]: Processed_HideAndSeek_MonthlyStatistics;
-    [Game.JustBuild]: Processed_JustBuild_MonthlyStatistics;
+    [Game.BuildBattle]: Processed_BuildBattle_MonthlyStatistics;
     [Game.MurderMystery]: Processed_MurderMystery_MonthlyStatistics;
     [Game.Skywars]: Processed_Skywars_MonthlyStatistics;
     [Game.SurvivalGames]: Processed_SurvivalGames_MonthlyStatistics;

package/lib/utils.d.ts

@@ -4,7 +4,6 @@ export interface MethodResponseError {
 }
 export type MethodResponse<D extends any> = {
     meta?: {
-        /** sss */
         duration: number;
         ratelimit?: {
             limit: number;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "hive-bedrock-api",
-    "version": "3.0.0-alpha.2",
+    "version": "3.0.0-alpha.20",
     "description": "An API wrapper for the Hive Minecraft Bedrock Edition server.",
     "main": "lib/index.js",
     "types": "lib/index.d.ts",
@@ -11,7 +11,7 @@
     "license": "MIT",
     "author": "Cubeedge Studios",
     "dependencies": {
-        "hive-bedrock-data": "^2.0.0-alpha.0"
+        "hive-bedrock-data": "^2.0.0-alpha.11"
     },
     "scripts": {
         "build": "tsc"