hypixel-api-reborn 11.1.0 → 11.2.1

package/.prettierrc

@@ -5,9 +5,9 @@
   "bracketSpacing": true,
   "proseWrap": "always",
   "singleQuote": true,
-  "printWidth": 210,
+  "printWidth": 120,
+  "endOfLine": "lf",
   "useTabs": false,
   "tabWidth": 2,
-  "semi": true,
-  "endOfLine": "lf"
+  "semi": true
 }

package/README.md

@@ -15,12 +15,15 @@
 
 ### Links
 
-[Discord Support](https://discord.gg/NSEBNMM) | [Documentation](https://hypixel-api-reborn.github.io/) | [NPM](https://www.npmjs.com/package/hypixel-api-reborn) |
-[GitHub](https://github.com/Hypixel-API-Reborn/hypixel-api-reborn) | [ToDo](https://github.com/Hypixel-API-Reborn/hypixel-api-reborn/projects/1) | [CLI](https://github.com/Hypixel-API-Reborn/cli)
+[Discord Support](https://discord.gg/NSEBNMM) | [Documentation](https://hypixel-api-reborn.github.io/) |
+[NPM](https://www.npmjs.com/package/hypixel-api-reborn) |
+[GitHub](https://github.com/Hypixel-API-Reborn/hypixel-api-reborn) |
+[ToDo](https://github.com/Hypixel-API-Reborn/hypixel-api-reborn/projects/1) |
+[CLI](https://github.com/Hypixel-API-Reborn/cli)
 
 #### Requirements
 
-**For Node.js users >= v14.x.x** <br> **For TypeScript users >= v3.5**
+**For Node.js users >= v18.18.0** <br> **For TypeScript users >= v3.5**
 
 ### Installation & Usage
 
@@ -31,7 +34,6 @@ npm i hypixel-api-reborn
 ```js
 const Hypixel = require('hypixel-api-reborn');
 const hypixel = new Hypixel.Client('API-KEY');
-// https://stavzdev.is-inside.me/cCMiZdoy.gif
 
 // getPlayer
 hypixel

package/eslint.config.mjs

@@ -0,0 +1,71 @@
+import jsdoc from 'eslint-plugin-jsdoc';
+import globals from 'globals';
+import js from '@eslint/js';
+
+export default [
+  js.configs.recommended,
+  {
+    ignores: ['docs/**', 'tests/**', 'node_modules/*'],
+    plugins: { jsdoc: jsdoc },
+    languageOptions: {
+      ecmaVersion: 2021,
+      sourceType: 'commonjs',
+      globals: {
+        ...globals.commonjs,
+        ...globals.es2021,
+        ...globals.node
+      }
+    },
+    rules: {
+      'max-len': ['error', { code: 120, ignoreUrls: true, ignoreComments: true }],
+      'no-constant-condition': ['error', { checkLoops: false }],
+      'prefer-const': ['warn', { destructuring: 'all' }],
+      'no-unused-vars': ['error', { args: 'none' }],
+      curly: ['warn', 'multi-line', 'consistent'],
+      'logical-assignment-operators': 'warn',
+      'no-template-curly-in-string': 'error',
+      'quote-props': ['error', 'as-needed'],
+      'jsdoc/no-undefined-types': 'warn',
+      'comma-dangle': ['error', 'never'],
+      'no-useless-constructor': 'error',
+      'no-useless-assignment': 'error',
+      'no-inner-declarations': 'error',
+      'no-implicit-coercion': 'error',
+      'jsdoc/require-jsdoc': 'error',
+      'no-use-before-define': 'warn',
+      'no-underscore-dangle': 'warn',
+      'no-unneeded-ternary': 'error',
+      'jsdoc/check-values': 'error',
+      'default-param-last': 'error',
+      'one-var': ['warn', 'never'],
+      'no-inline-comments': 'warn',
+      'jsdoc/valid-types': 'error',
+      'no-empty-function': 'error',
+      'no-useless-return': 'error',
+      'no-useless-rename': 'warn',
+      'no-useless-concat': 'warn',
+      'no-throw-literal': 'error',
+      'no-extend-native': 'error',
+      'default-case-last': 'warn',
+      'no-self-compare': 'error',
+      'no-new-wrappers': 'error',
+      'no-lone-blocks': 'error',
+      'no-undef-init': 'error',
+      'no-else-return': 'warn',
+      'no-extra-semi': 'error',
+      'require-await': 'warn',
+      yoda: ['error', 'always'],
+      'default-case': 'error',
+      'dot-notation': 'error',
+      'no-sequences': 'warn',
+      'no-multi-str': 'warn',
+      'no-lonely-if': 'warn',
+      'no-new-func': 'error',
+      'no-console': 'error',
+      camelcase: 'warn',
+      'no-var': 'warn',
+      eqeqeq: 'warn',
+      semi: 'error'
+    }
+  }
+];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hypixel-api-reborn",
-  "version": "11.1.0",
+  "version": "11.2.1",
   "description": "Feature-rich Hypixel API wrapper for Node.js",
   "main": "./src/index.js",
   "types": "./typings/index.d.ts",
@@ -16,25 +16,23 @@
     "url": "https://github.com/Hypixel-API-Reborn/hypixel-api-reborn/issues"
   },
   "scripts": {
-    "eslint": "npx eslint src/ typings/",
-    "eslint:fix": "npx eslint src/ typings/ --fix",
-    "lint:dev": "npm run eslint && npm run dtslint",
-    "test": "npx mocha tests --exit",
-    "docgen": "npx docgen -s src -o ../docs/master.json",
-    "docgen:custom": "npx docgen -s src --custom docs/index.yml -o ../docs/master.json",
-    "dtslint": "npx dtslint typings",
-    "prettier": "npx prettier --write src/ typings/",
-    "prettier:check": "npx prettier --check src/ typings/"
+    "lint": "npx eslint --cache src/",
+    "lint:fix": "npx eslint --cache src/ --fix",
+    "tests": "npx mocha tests --exit --recursive",
+    "docgen": " npx docgen -s src/ --custom docs/index.yml -o ./master.json",
+    "prettier": "npx prettier --cache --write src/ typings/",
+    "prettier:check": "npx prettier --cache --check src/ typings/"
   },
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=18.18.0"
   },
   "author": "StavZ",
   "dependencies": {
-    "node-fetch": "^2.6.1",
-    "object-path": "^0.11.8",
-    "prismarine-nbt": "^2.1.0",
-    "rss-parser": "^3.13.0"
+    "node-cache": "^5.1.2",
+    "node-fetch": "^3.3.2",
+    "prismarine-nbt": "^2.5.0",
+    "rss-parser": "^3.13.0",
+    "skyhelper-networth": "latest"
   },
   "license": "MIT",
   "readme": "https://hypixel.stavzdev.me/",
@@ -43,18 +41,16 @@
   },
   "publisher": "StavZ",
   "devDependencies": {
-    "@types/node": "^20.6.5",
-    "@typescript-eslint/eslint-plugin": "^4.33.0",
-    "@typescript-eslint/parser": "^4.33.0",
+    "@discordjs/docgen": "github:discordjs/docgen",
+    "@types/node": "^20.11.19",
     "chai": "^4.3.4",
-    "dtslint": "^4.1.6",
-    "eslint": "^7.32.0",
-    "eslint-config-google": "^0.14.0",
-    "eslint-config-prettier": "^9.0.0",
-    "mocha": "^9.1.2",
+    "eslint": "^9.3.0",
+    "eslint-plugin-jsdoc": "^48.2.7",
+    "globals": "^15.3.0",
+    "mocha": "^10.4.0",
     "node-env-run": "^4.0.2",
     "path": "^0.12.7",
-    "prettier": "^3.0.3",
-    "typescript": "^4.3.3"
+    "prettier": "^3.2.5",
+    "typescript": "^5.3.3"
   }
 }

package/src/API/getAchievements.js

@@ -0,0 +1,7 @@
+module.exports = async function () {
+  const Achievements = require('../structures/Static/Achievements');
+  // eslint-disable-next-line no-underscore-dangle
+  const res = await this._makeRequest('/resources/achievements');
+  if (res.raw) return res;
+  return new Achievements(res);
+};

package/src/API/getBoosters.js

@@ -1,5 +1,6 @@
 module.exports = async function () {
   const Booster = require('../structures/Boosters/Booster');
+  // eslint-disable-next-line no-underscore-dangle
   const res = await this._makeRequest('/boosters');
   if (res.raw) return res;
   return res.boosters.length ? res.boosters.map((b) => new Booster(b)).reverse() : [];

package/src/API/getChallenges.js

@@ -0,0 +1,7 @@
+module.exports = async function () {
+  const Challenges = require('../structures/Static/Challenges');
+  // eslint-disable-next-line no-underscore-dangle
+  const res = await this._makeRequest('/resources/challenges');
+  if (res.raw) return res;
+  return new Challenges(res);
+};

package/src/API/getGameCounts.js

@@ -1,5 +1,6 @@
 const GameCounts = require('../structures/GameCounts');
 module.exports = async function () {
+  // eslint-disable-next-line no-underscore-dangle
   const res = await this._makeRequest('/counts');
   if (res.raw) return res;
   return new GameCounts(res);

package/src/API/getGuild.js

@@ -4,13 +4,14 @@ const isGuildID = require('../utils/isGuildID');
 module.exports = async function (searchParameter, query) {
   if (!query) throw new Error(Errors.NO_GUILD_QUERY);
   const Guild = require('../structures/Guild/Guild');
-  if (searchParameter === 'id' && !isGuildID(query)) throw new Error(Errors.INVALID_GUILD_ID);
-  const isPlayerQuery = searchParameter === 'player';
-  if (isPlayerQuery) query = await toUuid(query);
+  if ('id' === searchParameter && !isGuildID(query)) throw new Error(Errors.INVALID_GUILD_ID);
+  const isPlayerQuery = 'player' === searchParameter;
+  if (isPlayerQuery) query = await toUuid(query, this.options.mojangCacheTime, this.options.useThirdPartyAPI);
   if (!['id', 'name', 'player'].includes(searchParameter)) throw new Error(Errors.INVALID_GUILD_SEARCH_PARAMETER);
+  // eslint-disable-next-line no-underscore-dangle
   const res = await this._makeRequest(`/guild?${searchParameter}=${encodeURI(query)}`);
   if (res.raw) return res;
-  if (!res.guild && searchParameter !== 'player') {
+  if (!res.guild && 'player' !== searchParameter) {
     throw new Error(Errors.GUILD_DOES_NOT_EXIST);
   }
 

package/src/API/getGuildAchievements.js

@@ -0,0 +1,7 @@
+module.exports = async function () {
+  const GuildAchievements = require('../structures/Static/GuildAchievements');
+  // eslint-disable-next-line no-underscore-dangle
+  const res = await this._makeRequest('/resources/guilds/achievements');
+  if (res.raw) return res;
+  return new GuildAchievements(res);
+};

package/src/API/getLeaderboards.js

@@ -1,13 +1,15 @@
 const Errors = require('../Errors');
 module.exports = async function () {
   const Leaderboard = require('../structures/Leaderboard');
+  // eslint-disable-next-line no-underscore-dangle
   const res = await this._makeRequest('/leaderboards');
   if (res.raw) return res;
   if (!res.leaderboards) throw new Error(Errors.SOMETHING_WENT_WRONG.replace(/{cause}/, 'Try again.'));
   const lbnames = Object.create(require('../utils/Constants').leaderboardNames);
-  // eslint-disable-next-line guard-for-in
   for (const name in lbnames) {
-    lbnames[name] = res.leaderboards[lbnames[name]].length ? res.leaderboards[lbnames[name]].map((lb) => new Leaderboard(lb)) : [];
+    lbnames[name] = res.leaderboards[lbnames[name]].length
+      ? res.leaderboards[lbnames[name]].map((lb) => new Leaderboard(lb))
+      : [];
   }
   return lbnames;
 };

package/src/API/getPlayer.js

@@ -5,7 +5,8 @@ const getRecentGames = require('./getRecentGames');
 module.exports = async function (query, options = { guild: false, recentGames: false }) {
   if (!query) throw new Error(Errors.NO_NICKNAME_UUID);
   const Player = require('../structures/Player');
-  query = await toUuid(query);
+  query = await toUuid(query, this.options.mojangCacheTime, this.options.useThirdPartyAPI);
+  // eslint-disable-next-line no-underscore-dangle
   const res = await this._makeRequest(`/player?uuid=${query}`);
   if (res.raw) return res;
   if (query && !res.player) throw new Error(Errors.PLAYER_HAS_NEVER_LOGGED);

package/src/API/getQuests.js

@@ -0,0 +1,7 @@
+module.exports = async function () {
+  const Quests = require('../structures/Static/Quests');
+  // eslint-disable-next-line no-underscore-dangle
+  const res = await this._makeRequest('/resources/quests');
+  if (res.raw) return res;
+  return new Quests(res);
+};

package/src/API/getRecentGames.js

@@ -1,18 +1,14 @@
-const Errors = require('../Errors');
 const toUuid = require('../utils/toUuid');
-const day3 = 1000 * 60 * 60 * 24 * 3;
-module.exports = async function (query, playerData) {
+const Errors = require('../Errors');
+module.exports = async function (query) {
   if (!query) throw new Error(Errors.NO_NICKNAME_UUID);
   const RecentGame = require('../structures/RecentGame');
-
-  query = await toUuid(query);
-
+  query = await toUuid(query, this.options.mojangCacheTime, this.options.useThirdPartyAPI);
+  // eslint-disable-next-line no-underscore-dangle
   const res = await this._makeRequest(`/recentgames?uuid=${query}`);
   if (res.raw) return res;
-  if (res.games === []) {
-    if (!playerData) throw new Error(Errors.PLAYER_IS_INACTIVE);
-    if (Date.now() - playerData.lastLogoutTimestamp < day3) throw new Error(Errors.PLAYER_DISABLED_ENDPOINT);
-    throw new Error(Errors.PLAYER_IS_INACTIVE);
+  if (0 === res.games.length) {
+    return [];
   }
   return res.games.map((x) => new RecentGame(x));
 };

package/src/API/getServerInfo.js

@@ -1,11 +1,43 @@
-const net = require('net');
-const Errors = require('../Errors');
+/* eslint-disable jsdoc/require-jsdoc */
 const ServerInfo = require('../structures/ServerInfo');
 const varInt = require('../utils/varInt');
-const packetsToSend = ['1500E0050E6D632E6879706978656C2E6E657463DD01', '0100', '09010000000000000000'].map((x) => Buffer.from(x, 'hex')); // To avoid dependency hell, these are precompiled as hex.
+const Errors = require('../Errors');
+const net = require('net');
+const packetsToSend = ['1500E0050E6D632E6879706978656C2E6E657463DD01', '0100', '09010000000000000000'].map((x) =>
+  // To avoid dependency hell, these are precompiled as hex.
+  Buffer.from(x, 'hex')
+);
+
+async function ping(cli) {
+  await cli.write(packetsToSend[2]);
+  const time = Date.now();
+  return new Promise((resolve) => {
+    cli.once('data', () => {
+      resolve(Date.now() - time);
+    });
+  });
+}
+
+async function getPing(amount, cli) {
+  let pingSum = 0;
+  for (let i = 0; i < amount; i++) {
+    pingSum += await ping(cli);
+  }
+  cli.destroy();
+  return Math.round(pingSum / amount);
+}
+
+function parseData(stringJson, ping) {
+  try {
+    return new ServerInfo(JSON.parse(stringJson), ping);
+  } catch {
+    return undefined;
+  }
+}
+
 module.exports = async function (repeats) {
-  if (repeats < 0 || typeof repeats !== 'number') repeats = 3;
-  if (repeats > 10) repeats = 10;
+  if (0 > repeats || 'number' !== typeof repeats) repeats = 3;
+  if (10 < repeats) repeats = 10;
   let aggregatedData = '';
   let dataLength = 0;
   return await new Promise((resolve, reject) => {
@@ -18,7 +50,7 @@ module.exports = async function (repeats) {
     });
     cli.on('data', async (data) => {
       if (!aggregatedData) {
-        const varIntBorder = data.findIndex((x) => x === 0x00) + 1;
+        const varIntBorder = data.findIndex((x) => 0x00 === x) + 1;
         dataLength = varInt(
           data
             .toString('hex', 0, varIntBorder)
@@ -27,40 +59,13 @@ module.exports = async function (repeats) {
         );
         dataLength -= varIntBorder * 8;
         aggregatedData += data.toString('utf-8', 5);
-      } else aggregatedData += data.toString('utf-8');
+      } else {
+        aggregatedData += data.toString('utf-8');
+      }
 
       if (dataLength >= aggregatedData.length) return;
-      cli.removeAllListeners('data'); // Remove this listener
+      cli.removeAllListeners('data');
       resolve(parseData(aggregatedData, await getPing(repeats, cli)));
     });
   });
 };
-// eslint-disable-next-line require-jsdoc
-async function getPing(amount, cli) {
-  let pingSum = 0;
-  for (let i = 0; i < amount; i++) {
-    pingSum += await ping(cli);
-  }
-  cli.destroy();
-  return Math.round(pingSum / amount);
-}
-
-// eslint-disable-next-line require-jsdoc
-async function ping(cli) {
-  await cli.write(packetsToSend[2]);
-  const time = Date.now();
-  return new Promise((resolve) => {
-    cli.once('data', () => {
-      resolve(Date.now() - time);
-    });
-  });
-}
-
-// eslint-disable-next-line require-jsdoc
-function parseData(stringJson, ping) {
-  try {
-    return new ServerInfo(JSON.parse(stringJson), ping);
-  } catch (e) {
-    return undefined;
-  }
-}

package/src/API/getStatus.js

@@ -1,7 +1,8 @@
 const toUuid = require('../utils/toUuid');
 module.exports = async function (query) {
   const Status = require('../structures/Status');
-  query = await toUuid(query);
+  query = await toUuid(query, this.options.mojangCacheTime, this.options.useThirdPartyAPI);
+  // eslint-disable-next-line no-underscore-dangle
   const res = await this._makeRequest(`/status?uuid=${query}`);
   if (res.raw) return res;
   return new Status(res.session);

package/src/API/getWatchdogStats.js

@@ -1,5 +1,6 @@
 module.exports = async function () {
   const WatchdogStats = require('../structures/Watchdog/Stats');
+  // eslint-disable-next-line no-underscore-dangle
   const res = await this._makeRequest('/punishmentstats');
   if (res.raw) return res;
   return new WatchdogStats(res);

package/src/API/index.js

@@ -1,19 +1,30 @@
 module.exports = {
-  getAPIStatus: require('./getAPIStatus'),
-  getBoosters: require('./getBoosters'),
-  getGameCounts: require('./getGameCounts'),
-  getGuild: require('./getGuild'),
-  getLeaderboards: require('./getLeaderboards'),
-  getPlayer: require('./getPlayer'),
-  getRecentGames: require('./getRecentGames'),
-  getServerInfo: require('./getServerInfo'),
-  getStatus: require('./getStatus'),
-  getWatchdogStats: require('./getWatchdogStats'),
-  getEndedSkyblockAuctions: require('./skyblock/getEndedSkyblockAuctions'),
-  getSkyblockAuctions: require('./skyblock/getSkyblockAuctions'),
-  getSkyblockAuctionsByPlayer: require('./skyblock/getSkyblockAuctionsByPlayer'),
-  getSkyblockBazaar: require('./skyblock/getSkyblockBazaar'),
-  getSkyblockMember: require('./skyblock/getSkyblockMember'),
-  getSkyblockNews: require('./skyblock/getSkyblockNews'),
-  getSkyblockProfiles: require('./skyblock/getSkyblockProfiles')
+  getAchievements: require('./getAchievements.js'),
+  getAPIStatus: require('./getAPIStatus.js'),
+  getBoosters: require('./getBoosters.js'),
+  getChallenges: require('./getChallenges.js'),
+  getGameCounts: require('./getGameCounts.js'),
+  getGuild: require('./getGuild.js'),
+  getGuildAchievements: require('./getGuildAchievements.js'),
+  getLeaderboards: require('./getLeaderboards.js'),
+  getPlayer: require('./getPlayer.js'),
+  getQuests: require('./getQuests.js'),
+  getRecentGames: require('./getRecentGames.js'),
+  getServerInfo: require('./getServerInfo.js'),
+  getStatus: require('./getStatus.js'),
+  getWatchdogStats: require('./getWatchdogStats.js'),
+
+  getSkyblockAuction: require('./skyblock/getAuction.js'),
+  getSkyblockAuctions: require('./skyblock/getAuctions.js'),
+  getSkyblockAuctionsByPlayer: require('./skyblock/getAuctionsByPlayer.js'),
+  getSkyblockBazaar: require('./skyblock/getBazaar.js'),
+  getSkyblockBingo: require('./skyblock/getBingo.js'),
+  getSkyblockBingoByPlayer: require('./skyblock/getBingoByPlayer.js'),
+  getSkyblockEndedAuctions: require('./skyblock/getEndedAuctions.js'),
+  getSkyblockFireSales: require('./skyblock/getFireSales.js'),
+  getSkyblockGovernment: require('./skyblock/getGovernment.js'),
+  getSkyblockMember: require('./skyblock/getMember.js'),
+  getSkyblockMuseum: require('./skyblock/getMuseum.js'),
+  getSkyblockNews: require('./skyblock/getNews.js'),
+  getSkyblockProfiles: require('./skyblock/getProfiles.js')
 };

package/src/API/skyblock/getAuction.js

@@ -0,0 +1,21 @@
+const Errors = require('../../Errors');
+const toUuid = require('../../utils/toUuid');
+module.exports = async function (type, query, includeItemBytes = false) {
+  if (!query) throw new Error(Errors.NO_NICKNAME_UUID);
+  const Auction = require('../../structures/SkyBlock/Auctions/Auction');
+  let filter;
+  if ('PROFILE' === type) {
+    filter = 'profile';
+  } else if ('PLAYER' === type) {
+    query = await toUuid(query, this.options.mojangCacheTime, this.options.useThirdPartyAPI);
+    filter = 'player';
+  } else if ('AUCTION' === type) {
+    filter = 'uuid';
+  } else {
+    throw new Error(Errors.BAD_AUCTION_FILTER);
+  }
+  // eslint-disable-next-line no-underscore-dangle
+  const res = await this._makeRequest(`/skyblock/auction?${filter}=${query}`);
+  if (res.raw) return res;
+  return res.auctions.length ? res.auctions.map((a) => new Auction(a, includeItemBytes)) : [];
+};

package/src/API/skyblock/{getSkyblockAuctions.js → getAuctions.js}

@@ -1,10 +1,10 @@
-/* eslint-disable require-jsdoc */
+/* eslint-disable jsdoc/require-jsdoc */
 const Auction = require('../../structures/SkyBlock/Auctions/Auction');
 const AuctionInfo = require('../../structures/SkyBlock/Auctions/AuctionInfo');
 const Errors = require('../../Errors');
-let _makeRequest;
 async function getPage(page = 0, options = {}) {
-  const content = await _makeRequest(`/skyblock/auctions?page=${page}`, false);
+  // eslint-disable-next-line no-underscore-dangle
+  const content = await this._makeRequest(`/skyblock/auctions?page=${page}`, false);
   const result = {};
   if (!options.noInfo) result.info = new AuctionInfo(content);
   if (options.raw) result.auctions = content.auctions;
@@ -16,22 +16,26 @@ async function noReject(promise, args = [], retries = 3, cooldown = 100) {
   try {
     const result = await promise.call(null, ...args);
     return result;
-  } catch (e) {
+  } catch {
     if (retries) {
       await new Promise((resolve) => setTimeout(resolve, cooldown));
       return await noReject(promise, args, retries - 1, cooldown);
-    } else return null;
+    }
+    return null;
   }
 }
 module.exports = async function (range, options = {}) {
-  _makeRequest = this._makeRequest;
-  options.retries = options.retries || 3;
-  options.cooldown = options.cooldown || 100;
-  if (range == null || range === '*') range = [0, (await getPage(0, { noAuctions: true })).info.totalPages];
+  options.retries ||= 3;
+  options.cooldown ||= 100;
+  if (null === range || '*' === range) range = [0, (await getPage(0, { noAuctions: true })).info.totalPages];
   if (!Array.isArray(range)) range = [parseInt(range), parseInt(range)];
   if (isNaN(range[0])) throw new Error(Errors.PAGE_INDEX_ERROR);
-  if (parseInt(options.retries) !== options.retries || options.retries > 10 || options.retries < 0) throw new Error(Errors.INVALID_OPTION_VALUE);
-  if (parseInt(options.cooldown) !== options.cooldown || options.cooldown > 3000 || options.cooldown < 0) throw new Error(Errors.INVALID_OPTION_VALUE);
+  if (parseInt(options.retries) !== options.retries || 10 < options.retries || 0 > options.retries) {
+    throw new Error(Errors.INVALID_OPTION_VALUE);
+  }
+  if (parseInt(options.cooldown) !== options.cooldown || 3000 < options.cooldown || 0 > options.cooldown) {
+    throw new Error(Errors.INVALID_OPTION_VALUE);
+  }
   range = range.sort();
   const result = { auctions: [] };
   const fetches = [];
@@ -45,7 +49,9 @@ module.exports = async function (range, options = {}) {
       if (resp) {
         result.auctions = result.auctions.concat(resp.auctions);
         if (resp.info) result.info = resp.info;
-      } else failedPages.push(i);
+      } else {
+        failedPages.push(i);
+      }
     }
   }
   if (fetches.length) {
@@ -59,6 +65,7 @@ module.exports = async function (range, options = {}) {
       return pV;
     }, []);
   }
+  // eslint-disable-next-line no-underscore-dangle
   result.info = result.info ? result.info._extend('failedPages', failedPages) : { failedPages };
   return result;
 };

package/src/API/skyblock/{getSkyblockAuctionsByPlayer.js → getAuctionsByPlayer.js}

@@ -3,9 +3,9 @@ const toUuid = require('../../utils/toUuid');
 module.exports = async function (query, includeItemBytes = false) {
   if (!query) throw new Error(Errors.NO_NICKNAME_UUID);
   const Auction = require('../../structures/SkyBlock/Auctions/Auction');
-  query = await toUuid(query);
+  query = await toUuid(query, this.options.mojangCacheTime, this.options.useThirdPartyAPI);
+  // eslint-disable-next-line no-underscore-dangle
   const res = await this._makeRequest(`/skyblock/auction?player=${query}`);
   if (res.raw) return res;
-
   return res.auctions.length ? res.auctions.map((a) => new Auction(a, includeItemBytes)) : [];
 };

package/src/API/skyblock/{getSkyblockBazaar.js → getBazaar.js}

@@ -1,10 +1,8 @@
 module.exports = async function () {
   const Product = require('../../structures/SkyBlock/Bazzar/Product');
-
+  // eslint-disable-next-line no-underscore-dangle
   const res = await this._makeRequest('/skyblock/bazaar');
   if (res.raw) return res;
-
   const productsKeys = Object.keys(res.products);
-
   return productsKeys.map((x) => new Product(res.products[x]));
 };

package/src/API/skyblock/getBingo.js

@@ -0,0 +1,7 @@
+module.exports = async function () {
+  const BingoData = require('../../structures/SkyBlock/Static/BingoData');
+  // eslint-disable-next-line no-underscore-dangle
+  const res = await this._makeRequest('/resources/skyblock/bingo');
+  if (res.raw) return res;
+  return new BingoData(res);
+};

package/src/API/skyblock/getBingoByPlayer.js

@@ -0,0 +1,14 @@
+const toUuid = require('../../utils/toUuid');
+const getBingo = require('./getBingo');
+const Errors = require('../../Errors');
+module.exports = async function (query, { fetchBingoData = false }) {
+  if (!query) throw new Error(Errors.NO_NICKNAME_UUID);
+  const PlayerBingo = require('../../structures/SkyBlock/PlayerBingo');
+  query = await toUuid(query, this.options.mojangCacheTime, this.options.useThirdPartyAPI);
+  // eslint-disable-next-line no-underscore-dangle
+  const res = await this._makeRequest(`/skyblock/uuid?player=${query}`);
+  if (res.raw) return res;
+  let bingoData = null;
+  if (fetchBingoData) bingoData = await getBingo.call(this);
+  return new PlayerBingo(res, bingoData);
+};

package/src/API/skyblock/{getEndedSkyblockAuctions.js → getEndedAuctions.js}

@@ -1,6 +1,7 @@
 const PartialAuction = require('../../structures/SkyBlock/Auctions/PartialAuction');
 const AuctionInfo = require('../../structures/SkyBlock/Auctions/AuctionInfo');
 module.exports = async function (includeItemBytes = false) {
+  // eslint-disable-next-line no-underscore-dangle
   const res = await this._makeRequest('/skyblock/auctions_ended', false);
   if (res.raw) return res;
   return {

package/src/API/skyblock/getFireSales.js

@@ -0,0 +1,7 @@
+module.exports = async function () {
+  const FireSale = require('../../structures/SkyBlock/Static/FireSale');
+  // eslint-disable-next-line no-underscore-dangle
+  const res = await this._makeRequest('/skyblock/firesales');
+  if (res.raw) return res;
+  return res.sales.length ? res.sales.map((a) => new FireSale(a)) : [];
+};