osrs-json-hiscores 2.14.2 → 2.16.0

package/README.md

@@ -110,10 +110,10 @@ Activities consist of all levels of clue scrolls as well as minigames and bosses
 | Bounty Hunter (Legacy - Hunter) |    `hunterBH`     |
 | Bounty Hunter (Rogue)           |    `rogueBHV2`    |
 | Bounty Hunter (Hunter)          |   `hunterBHV2`    |
-| Last Man Standing               | `lastManStanding` |
-| PvP Arena                       |    `pvpArena`     |
+| LMS - Rank                      | `lastManStanding` |
+| PvP Arena - Rank                |    `pvpArena`     |
 | Soul Wars Zeal                  |  `soulWarsZeal`   |
-| Rifts Closed                    |   `riftsClosed`   |
+| Rifts closed                    |   `riftsClosed`   |
 
 ### Leagues
 
@@ -144,6 +144,7 @@ Activities consist of all levels of clue scrolls as well as minigames and bosses
 | Dagannoth Rex                     |         `dagannothRex`         |
 | Dagannoth Supreme                 |       `dagannothSupreme`       |
 | Deranged Archaeologist            |    `derangedArchaeologist`     |
+| Duke Sucellus                     |         `dukeSucellus`         |
 | General Graardor                  |       `generalGraardor`        |
 | Giant Mole                        |          `giantMole`           |
 | Grotesque Guardians               |      `grotesqueGuardians`      |
@@ -155,7 +156,7 @@ Activities consist of all levels of clue scrolls as well as minigames and bosses
 | K'ril Tsutsaroth                  |        `krilTsutsaroth`        |
 | Mimic                             |            `mimic`             |
 | Nex                               |             `nex`              |
-| The Nightmare of Ashihama         |          `nightmare`           |
+| Nightmare                         |          `nightmare`           |
 | Phosani's Nightmare               |      `phosanisNightmare`       |
 | Obor                              |             `obor`             |
 | Phantom Muspah                    |        `phantomMuspah`         |
@@ -166,6 +167,8 @@ Activities consist of all levels of clue scrolls as well as minigames and bosses
 | Tempoross                         |          `tempoross`           |
 | The Gauntlet                      |           `gauntlet`           |
 | The Corrupted Gauntlet            |      `corruptedGauntlet`       |
+| The Leviathan                     |          `leviathan`           |
+| The Whisperer                     |          `whisperer`           |
 | Theatre Of Blood                  |        `theatreOfBlood`        |
 | Theatre Of Blood: Hard Mode       |    `theatreOfBloodHardMode`    |
 | Thermonuclear Smoke Devil         |   `thermonuclearSmokeDevil`    |
@@ -173,6 +176,7 @@ Activities consist of all levels of clue scrolls as well as minigames and bosses
 | Tombs of Amascut: Expert Mode     |   `tombsOfAmascutExpertMode`   |
 | TzKal-Zuk                         |           `tzKalZuk`           |
 | TzTok-Jad                         |           `tzTokJad`           |
+| Vardorvis                         |          `vardorvis`           |
 | Venenatis                         |          `venenatis`           |
 | Vetion                            |            `vetion`            |
 | Vorkath                           |           `vorkath`            |

package/lib/hiscores.d.ts

@@ -1,5 +1,14 @@
 import { AxiosRequestConfig } from 'axios';
-import { Player, Stats, Gamemode, SkillName, PlayerSkillRow, ActivityName, PlayerActivityRow, GetStatsOptions } from './types';
+import { Player, Stats, Gamemode, SkillName, PlayerSkillRow, ActivityName, PlayerActivityRow, GetStatsOptions, HiscoresResponse } from './types';
+/**
+ * Gets a player's stats from the official OSRS JSON endpoint.
+ *
+ * @param rsn Username of the player.
+ * @param mode Gamemode to fetch ranks for.
+ * @param config Optional axios request config object.
+ * @returns Official JSON stats object.
+ */
+export declare function getOfficialStats(rsn: string, mode?: Gamemode, config?: AxiosRequestConfig): Promise<HiscoresResponse>;
 /**
  * Screen scrapes the hiscores to get the formatted rsn of a player.
  *
@@ -8,6 +17,13 @@ import { Player, Stats, Gamemode, SkillName, PlayerSkillRow, ActivityName, Playe
  * @returns Formatted version of the rsn.
  */
 export declare function getRSNFormat(rsn: string, config?: AxiosRequestConfig): Promise<string>;
+/**
+ * Parses official JSON object of raw stats and returns a stats object.
+ *
+ * @param csv Raw JSON from the official OSRS API.
+ * @returns Parsed stats object.
+ */
+export declare function parseJsonStats(json: HiscoresResponse): Stats;
 /**
  * Parses CSV string of raw stats and returns a stats object.
  *

package/lib/hiscores.js

@@ -47,9 +47,42 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
     }
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getActivityPage = exports.getSkillPage = exports.getStatsByGamemode = exports.getStats = exports.parseStats = exports.getRSNFormat = void 0;
+exports.getActivityPage = exports.getSkillPage = exports.getStatsByGamemode = exports.getStats = exports.parseStats = exports.parseJsonStats = exports.getRSNFormat = exports.getOfficialStats = void 0;
 var jsdom_1 = require("jsdom");
 var utils_1 = require("./utils");
+/**
+ * Gets a player's stats from the official OSRS JSON endpoint.
+ *
+ * @param rsn Username of the player.
+ * @param mode Gamemode to fetch ranks for.
+ * @param config Optional axios request config object.
+ * @returns Official JSON stats object.
+ */
+function getOfficialStats(rsn, mode, config) {
+    if (mode === void 0) { mode = 'main'; }
+    return __awaiter(this, void 0, void 0, function () {
+        var url, response, _a;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    (0, utils_1.validateRSN)(rsn);
+                    url = (0, utils_1.getStatsURL)(mode, rsn, true);
+                    _b.label = 1;
+                case 1:
+                    _b.trys.push([1, 3, , 4]);
+                    return [4 /*yield*/, (0, utils_1.httpGet)(url, config)];
+                case 2:
+                    response = _b.sent();
+                    return [2 /*return*/, response.data];
+                case 3:
+                    _a = _b.sent();
+                    throw Error(utils_1.PLAYER_NOT_FOUND_ERROR);
+                case 4: return [2 /*return*/];
+            }
+        });
+    });
+}
+exports.getOfficialStats = getOfficialStats;
 /**
  * Screen scrapes the hiscores to get the formatted rsn of a player.
  *
@@ -76,16 +109,79 @@ function getRSNFormat(rsn, config) {
                     if (anchor) {
                         return [2 /*return*/, (0, utils_1.rsnFromElement)(anchor)];
                     }
-                    throw Error('Player not found');
+                    throw Error(utils_1.PLAYER_NOT_FOUND_ERROR);
                 case 3:
                     _a = _b.sent();
-                    throw Error('Player not found');
+                    throw Error(utils_1.PLAYER_NOT_FOUND_ERROR);
                 case 4: return [2 /*return*/];
             }
         });
     });
 }
 exports.getRSNFormat = getRSNFormat;
+/**
+ * Parses official JSON object of raw stats and returns a stats object.
+ *
+ * @param csv Raw JSON from the official OSRS API.
+ * @returns Parsed stats object.
+ */
+function parseJsonStats(json) {
+    var getActivity = function (formattedName) {
+        var _a, _b;
+        var hiscoresActivity = json.activities.find(
+        // We must match on name here since id is not guaranteed to be the same between updates
+        function (_a) {
+            var name = _a.name;
+            return name.toLowerCase() === formattedName.toLowerCase();
+        });
+        return {
+            rank: (_a = hiscoresActivity === null || hiscoresActivity === void 0 ? void 0 : hiscoresActivity.rank) !== null && _a !== void 0 ? _a : -1,
+            score: (_b = hiscoresActivity === null || hiscoresActivity === void 0 ? void 0 : hiscoresActivity.score) !== null && _b !== void 0 ? _b : -1
+        };
+    };
+    var reduceActivity = function (keys, formattedNames) {
+        return keys.reduce(function (reducer, key) {
+            var _a;
+            return (__assign(__assign({}, reducer), (_a = {}, _a[key] = getActivity(formattedNames[key]), _a)));
+        }, {});
+    };
+    var skills = utils_1.SKILLS.reduce(function (skillsObject, skillName) {
+        var _a;
+        var _b, _c, _d;
+        var hiscoresSkill = json.skills.find(
+        // We must match on name here since id is not guaranteed to be the same between updates
+        function (_a) {
+            var name = _a.name;
+            return name.toLowerCase() === utils_1.FORMATTED_SKILL_NAMES[skillName].toLowerCase();
+        });
+        return __assign(__assign({}, skillsObject), (_a = {}, _a[skillName] = {
+            rank: (_b = hiscoresSkill === null || hiscoresSkill === void 0 ? void 0 : hiscoresSkill.rank) !== null && _b !== void 0 ? _b : -1,
+            level: (_c = hiscoresSkill === null || hiscoresSkill === void 0 ? void 0 : hiscoresSkill.level) !== null && _c !== void 0 ? _c : -1,
+            xp: (_d = hiscoresSkill === null || hiscoresSkill === void 0 ? void 0 : hiscoresSkill.xp) !== null && _d !== void 0 ? _d : -1
+        }, _a));
+    }, {});
+    var bountyHunter = reduceActivity(utils_1.BH_MODES, utils_1.FORMATTED_BH_NAMES);
+    var clues = reduceActivity(utils_1.CLUES, utils_1.FORMATTED_CLUE_NAMES);
+    var bosses = reduceActivity(utils_1.BOSSES, utils_1.FORMATTED_BOSS_NAMES);
+    var leaguePoints = getActivity(utils_1.FORMATTED_LEAGUE_POINTS);
+    var lastManStanding = getActivity(utils_1.FORMATTED_LMS);
+    var pvpArena = getActivity(utils_1.FORMATTED_PVP_ARENA);
+    var soulWarsZeal = getActivity(utils_1.FORMATTED_SOUL_WARS);
+    var riftsClosed = getActivity(utils_1.FORMATTED_RIFTS_CLOSED);
+    var stats = {
+        skills: skills,
+        leaguePoints: leaguePoints,
+        bountyHunter: bountyHunter,
+        lastManStanding: lastManStanding,
+        pvpArena: pvpArena,
+        soulWarsZeal: soulWarsZeal,
+        riftsClosed: riftsClosed,
+        clues: clues,
+        bosses: bosses
+    };
+    return stats;
+}
+exports.parseJsonStats = parseJsonStats;
 /**
  * Parses CSV string of raw stats and returns a stats object.
  *
@@ -185,13 +281,13 @@ function getStats(rsn, options) {
                         'ultimate'
                     ];
                     shouldGetFormattedRsn = (_b = options === null || options === void 0 ? void 0 : options.shouldGetFormattedRsn) !== null && _b !== void 0 ? _b : true;
-                    return [4 /*yield*/, (0, utils_1.httpGet)((0, utils_1.getStatsURL)('main', rsn), (_c = options === null || options === void 0 ? void 0 : options.axiosConfigs) === null || _c === void 0 ? void 0 : _c.main)];
+                    return [4 /*yield*/, (0, utils_1.httpGet)((0, utils_1.getStatsURL)('main', rsn, true), (_c = options === null || options === void 0 ? void 0 : options.axiosConfigs) === null || _c === void 0 ? void 0 : _c.main)];
                 case 1:
                     mainRes = _f.sent();
                     if (!(mainRes.status === 200)) return [3 /*break*/, 9];
                     emptyResponse_1 = {
                         status: 404,
-                        data: '',
+                        data: { skills: [], activities: [] },
                         statusText: '',
                         headers: {},
                         config: {}
@@ -200,7 +296,7 @@ function getStats(rsn, options) {
                         var _a;
                         return __generator(this, function (_b) {
                             return [2 /*return*/, otherGamemodes.includes(mode)
-                                    ? (0, utils_1.httpGet)((0, utils_1.getStatsURL)(mode, rsn), (_a = options === null || options === void 0 ? void 0 : options.axiosConfigs) === null || _a === void 0 ? void 0 : _a[mode]).catch(function (err) { return err; })
+                                    ? (0, utils_1.httpGet)((0, utils_1.getStatsURL)(mode, rsn, true), (_a = options === null || options === void 0 ? void 0 : options.axiosConfigs) === null || _a === void 0 ? void 0 : _a[mode]).catch(function (err) { return err; })
                                     : emptyResponse_1];
                         });
                     }); };
@@ -221,12 +317,12 @@ function getStats(rsn, options) {
                         deulted: false,
                         deironed: false
                     };
-                    player.main = parseStats(mainRes.data);
+                    player.main = parseJsonStats(mainRes.data);
                     return [4 /*yield*/, getModeStats('ironman')];
                 case 5:
                     ironRes = _f.sent();
                     if (!(ironRes.status === 200)) return [3 /*break*/, 8];
-                    player.ironman = parseStats(ironRes.data);
+                    player.ironman = parseJsonStats(ironRes.data);
                     return [4 /*yield*/, getModeStats('hardcore')];
                 case 6:
                     hcRes = _f.sent();
@@ -235,7 +331,7 @@ function getStats(rsn, options) {
                     ultRes = _f.sent();
                     if (hcRes.status === 200) {
                         player.mode = 'hardcore';
-                        player.hardcore = parseStats(hcRes.data);
+                        player.hardcore = parseJsonStats(hcRes.data);
                         if (player.ironman.skills.overall.xp !== player.hardcore.skills.overall.xp) {
                             player.dead = true;
                             player.mode = 'ironman';
@@ -247,7 +343,7 @@ function getStats(rsn, options) {
                     }
                     else if (ultRes.status === 200) {
                         player.mode = 'ultimate';
-                        player.ultimate = parseStats(ultRes.data);
+                        player.ultimate = parseJsonStats(ultRes.data);
                         if (player.ironman.skills.overall.xp !== player.ultimate.skills.overall.xp) {
                             player.deulted = true;
                             player.mode = 'ironman';
@@ -266,7 +362,7 @@ function getStats(rsn, options) {
                     }
                     _f.label = 8;
                 case 8: return [2 /*return*/, player];
-                case 9: throw Error('Player not found');
+                case 9: throw Error(utils_1.PLAYER_NOT_FOUND_ERROR);
             }
         });
     });
@@ -291,13 +387,10 @@ function getStatsByGamemode(rsn, mode, config) {
                     if (!utils_1.GAMEMODES.includes(mode)) {
                         throw Error('Invalid game mode');
                     }
-                    return [4 /*yield*/, (0, utils_1.httpGet)((0, utils_1.getStatsURL)(mode, rsn), config)];
+                    return [4 /*yield*/, getOfficialStats(rsn, mode, config)];
                 case 1:
                     response = _a.sent();
-                    if (response.status !== 200) {
-                        throw Error('Player not found');
-                    }
-                    stats = parseStats(response.data);
+                    stats = parseJsonStats(response);
                     return [2 /*return*/, stats];
             }
         });

package/lib/types.d.ts

@@ -21,7 +21,7 @@ export type BHType = 'rogue' | 'hunter' | 'rogueV2' | 'hunterV2';
 export type BH = {
     [Type in BHType]: Activity;
 };
-export type Boss = 'abyssalSire' | 'alchemicalHydra' | 'artio' | 'barrows' | 'bryophyta' | 'callisto' | 'calvarion' | 'cerberus' | 'chambersOfXeric' | 'chambersOfXericChallengeMode' | 'chaosElemental' | 'chaosFanatic' | 'commanderZilyana' | 'corporealBeast' | 'crazyArchaeologist' | 'dagannothPrime' | 'dagannothRex' | 'dagannothSupreme' | 'derangedArchaeologist' | 'generalGraardor' | 'giantMole' | 'grotesqueGuardians' | 'hespori' | 'kalphiteQueen' | 'kingBlackDragon' | 'kraken' | 'kreeArra' | 'krilTsutsaroth' | 'mimic' | 'nex' | 'nightmare' | 'phosanisNightmare' | 'obor' | 'phantomMuspah' | 'sarachnis' | 'scorpia' | 'skotizo' | 'spindel' | 'tempoross' | 'gauntlet' | 'corruptedGauntlet' | 'theatreOfBlood' | 'theatreOfBloodHardMode' | 'thermonuclearSmokeDevil' | 'tombsOfAmascut' | 'tombsOfAmascutExpertMode' | 'tzKalZuk' | 'tzTokJad' | 'venenatis' | 'vetion' | 'vorkath' | 'wintertodt' | 'zalcano' | 'zulrah';
+export type Boss = 'abyssalSire' | 'alchemicalHydra' | 'artio' | 'barrows' | 'bryophyta' | 'callisto' | 'calvarion' | 'cerberus' | 'chambersOfXeric' | 'chambersOfXericChallengeMode' | 'chaosElemental' | 'chaosFanatic' | 'commanderZilyana' | 'corporealBeast' | 'crazyArchaeologist' | 'dagannothPrime' | 'dagannothRex' | 'dagannothSupreme' | 'derangedArchaeologist' | 'dukeSucellus' | 'generalGraardor' | 'giantMole' | 'grotesqueGuardians' | 'hespori' | 'kalphiteQueen' | 'kingBlackDragon' | 'kraken' | 'kreeArra' | 'krilTsutsaroth' | 'mimic' | 'nex' | 'nightmare' | 'phosanisNightmare' | 'obor' | 'phantomMuspah' | 'sarachnis' | 'scorpia' | 'skotizo' | 'spindel' | 'tempoross' | 'gauntlet' | 'corruptedGauntlet' | 'leviathan' | 'whisperer' | 'theatreOfBlood' | 'theatreOfBloodHardMode' | 'thermonuclearSmokeDevil' | 'tombsOfAmascut' | 'tombsOfAmascutExpertMode' | 'tzKalZuk' | 'tzTokJad' | 'vardorvis' | 'venenatis' | 'vetion' | 'vorkath' | 'wintertodt' | 'zalcano' | 'zulrah';
 export type Bosses = {
     [Type in Boss]: Activity;
 };
@@ -76,3 +76,37 @@ export interface GetStatsOptions {
         rsn?: AxiosRequestConfig;
     };
 }
+export interface HiscoresCommon {
+    /**
+     * This field behaves more like an index than a true unique ID.
+     */
+    id: number;
+    /**
+     * The display name of this skill / activity.
+     */
+    name: string;
+    /**
+     * The player's official hiscores rank in this skill / activity.
+     */
+    rank: number;
+}
+export interface HiscoresSkill extends HiscoresCommon {
+    /**
+     * The player's current level in this skill.
+     */
+    level: number;
+    /**
+     * The player's current experience in this skill.
+     */
+    xp: number;
+}
+export interface HiscoresActivity extends HiscoresCommon {
+    /**
+     * The player's current score in this activity.
+     */
+    score: number;
+}
+export interface HiscoresResponse {
+    skills: HiscoresSkill[];
+    activities: HiscoresActivity[];
+}

package/lib/utils/constants.d.ts

@@ -1,6 +1,7 @@
 import { BHType, Boss, ClueType, Gamemode, SkillName, ActivityName } from '../types';
 export declare const BASE_URL = "https://secure.runescape.com/m=hiscore_oldschool";
 export declare const STATS_URL = "index_lite.ws?player=";
+export declare const JSON_STATS_URL = "index_lite.json?player=";
 export declare const SCORES_URL = "overall.ws?";
 export type GamemodeUrl = {
     [key in Gamemode]: string;
@@ -28,9 +29,10 @@ export type FormattedBHNames = {
     [key in BHType]: string;
 };
 export declare const FORMATTED_BH_NAMES: FormattedBHNames;
-export declare const FORMATTED_LMS = "Last Man Standing";
-export declare const FORMATTED_PVP_ARENA = "PvP Arena";
+export declare const FORMATTED_LMS = "LMS - Rank";
+export declare const FORMATTED_PVP_ARENA = "PvP Arena - Rank";
 export declare const FORMATTED_SOUL_WARS = "Soul Wars Zeal";
 export declare const FORMATTED_LEAGUE_POINTS = "League Points";
-export declare const FORMATTED_RIFTS_CLOSED = "Rifts Closed";
+export declare const FORMATTED_RIFTS_CLOSED = "Rifts closed";
 export declare const INVALID_FORMAT_ERROR = "Invalid hiscores format";
+export declare const PLAYER_NOT_FOUND_ERROR = "Player not found";

package/lib/utils/constants.js

@@ -9,9 +9,10 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
     return to.concat(ar || Array.prototype.slice.call(from));
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.INVALID_FORMAT_ERROR = exports.FORMATTED_RIFTS_CLOSED = exports.FORMATTED_LEAGUE_POINTS = exports.FORMATTED_SOUL_WARS = exports.FORMATTED_PVP_ARENA = exports.FORMATTED_LMS = exports.FORMATTED_BH_NAMES = exports.FORMATTED_CLUE_NAMES = exports.FORMATTED_SKILL_NAMES = exports.FORMATTED_BOSS_NAMES = exports.ACTIVITIES = exports.BOSSES = exports.GAMEMODES = exports.BH_MODES = exports.CLUES = exports.SKILLS = exports.GAMEMODE_URL = exports.SCORES_URL = exports.STATS_URL = exports.BASE_URL = void 0;
+exports.PLAYER_NOT_FOUND_ERROR = exports.INVALID_FORMAT_ERROR = exports.FORMATTED_RIFTS_CLOSED = exports.FORMATTED_LEAGUE_POINTS = exports.FORMATTED_SOUL_WARS = exports.FORMATTED_PVP_ARENA = exports.FORMATTED_LMS = exports.FORMATTED_BH_NAMES = exports.FORMATTED_CLUE_NAMES = exports.FORMATTED_SKILL_NAMES = exports.FORMATTED_BOSS_NAMES = exports.ACTIVITIES = exports.BOSSES = exports.GAMEMODES = exports.BH_MODES = exports.CLUES = exports.SKILLS = exports.GAMEMODE_URL = exports.SCORES_URL = exports.JSON_STATS_URL = exports.STATS_URL = exports.BASE_URL = void 0;
 exports.BASE_URL = 'https://secure.runescape.com/m=hiscore_oldschool';
 exports.STATS_URL = 'index_lite.ws?player=';
+exports.JSON_STATS_URL = 'index_lite.json?player=';
 exports.SCORES_URL = 'overall.ws?';
 exports.GAMEMODE_URL = {
     main: "".concat(exports.BASE_URL, "/"),
@@ -90,6 +91,7 @@ exports.BOSSES = [
     'dagannothRex',
     'dagannothSupreme',
     'derangedArchaeologist',
+    'dukeSucellus',
     'generalGraardor',
     'giantMole',
     'grotesqueGuardians',
@@ -112,6 +114,8 @@ exports.BOSSES = [
     'tempoross',
     'gauntlet',
     'corruptedGauntlet',
+    'leviathan',
+    'whisperer',
     'theatreOfBlood',
     'theatreOfBloodHardMode',
     'thermonuclearSmokeDevil',
@@ -119,6 +123,7 @@ exports.BOSSES = [
     'tombsOfAmascutExpertMode',
     'tzKalZuk',
     'tzTokJad',
+    'vardorvis',
     'venenatis',
     'vetion',
     'vorkath',
@@ -164,6 +169,7 @@ exports.FORMATTED_BOSS_NAMES = {
     dagannothRex: 'Dagannoth Rex',
     dagannothSupreme: 'Dagannoth Supreme',
     derangedArchaeologist: 'Deranged Archaeologist',
+    dukeSucellus: 'Duke Sucellus',
     generalGraardor: 'General Graardor',
     giantMole: 'Giant Mole',
     grotesqueGuardians: 'Grotesque Guardians',
@@ -175,7 +181,7 @@ exports.FORMATTED_BOSS_NAMES = {
     krilTsutsaroth: "K'ril Tsutsaroth",
     mimic: 'Mimic',
     nex: 'Nex',
-    nightmare: 'The Nightmare of Ashihama',
+    nightmare: 'Nightmare',
     phosanisNightmare: "Phosani's Nightmare",
     obor: 'Obor',
     phantomMuspah: 'Phantom Muspah',
@@ -186,6 +192,8 @@ exports.FORMATTED_BOSS_NAMES = {
     tempoross: 'Tempoross',
     gauntlet: 'The Gauntlet',
     corruptedGauntlet: 'The Corrupted Gauntlet',
+    leviathan: 'The Leviathan',
+    whisperer: 'The Whisperer',
     theatreOfBlood: 'Theatre of Blood',
     theatreOfBloodHardMode: 'Theatre of Blood: Hard Mode',
     thermonuclearSmokeDevil: 'Thermonuclear Smoke Devil',
@@ -193,6 +201,7 @@ exports.FORMATTED_BOSS_NAMES = {
     tombsOfAmascutExpertMode: 'Tombs of Amascut: Expert Mode',
     tzKalZuk: 'TzKal-Zuk',
     tzTokJad: 'TzTok-Jad',
+    vardorvis: 'Vardorvis',
     venenatis: 'Venenatis',
     vetion: "Vet'ion",
     vorkath: 'Vorkath',
@@ -241,9 +250,10 @@ exports.FORMATTED_BH_NAMES = {
     rogueV2: 'Bounty Hunter - Rogue',
     hunterV2: 'Bounty Hunter - Hunter'
 };
-exports.FORMATTED_LMS = 'Last Man Standing';
-exports.FORMATTED_PVP_ARENA = 'PvP Arena';
+exports.FORMATTED_LMS = 'LMS - Rank';
+exports.FORMATTED_PVP_ARENA = 'PvP Arena - Rank';
 exports.FORMATTED_SOUL_WARS = 'Soul Wars Zeal';
 exports.FORMATTED_LEAGUE_POINTS = 'League Points';
-exports.FORMATTED_RIFTS_CLOSED = 'Rifts Closed';
+exports.FORMATTED_RIFTS_CLOSED = 'Rifts closed';
 exports.INVALID_FORMAT_ERROR = 'Invalid hiscores format';
+exports.PLAYER_NOT_FOUND_ERROR = 'Player not found';

package/lib/utils/helpers.d.ts

@@ -5,9 +5,10 @@ import { Gamemode, SkillName, ActivityName } from '../types';
  *
  * @param gamemode Gamemode to fetch ranks for.
  * @param rsn Username of the player.
+ * @param json If the JSON endpoint is desired instead of CSV.
  * @returns Encoded stats URL.
  */
-export declare const getStatsURL: (gamemode: Gamemode, rsn: string) => string;
+export declare const getStatsURL: (gamemode: Gamemode, rsn: string, json?: boolean) => string;
 /**
  * Will generate a player table URL for the official OSRS hiscores website.
  *

package/lib/utils/helpers.js

@@ -20,10 +20,12 @@ var constants_1 = require("./constants");
  *
  * @param gamemode Gamemode to fetch ranks for.
  * @param rsn Username of the player.
+ * @param json If the JSON endpoint is desired instead of CSV.
  * @returns Encoded stats URL.
  */
-var getStatsURL = function (gamemode, rsn) {
-    return "".concat(constants_1.GAMEMODE_URL[gamemode]).concat(constants_1.STATS_URL).concat(encodeURIComponent(rsn));
+var getStatsURL = function (gamemode, rsn, json) {
+    if (json === void 0) { json = false; }
+    return "".concat(constants_1.GAMEMODE_URL[gamemode]).concat(json ? constants_1.JSON_STATS_URL : constants_1.STATS_URL).concat(encodeURIComponent(rsn));
 };
 exports.getStatsURL = getStatsURL;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "osrs-json-hiscores",
-  "version": "2.14.2",
+  "version": "2.16.0",
   "description": "The Old School Runescape API wrapper that does more!",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",