osrs-tools 2.3.0 → 2.3.5

package/dist/runescape/model/account/OsrsAccount.js

@@ -0,0 +1,168 @@
+class OsrsAccount {
+    #name;
+    #combatLevel;
+    #questPoints;
+    #skills;
+    #skillsDetail;
+    #bosses;
+    #clues;
+    #bountyHunter;
+    #lastManStanding;
+    #pvpArena;
+    #soulWarsZeal;
+    #riftsClosed;
+    #colosseumGlory;
+    #collectionsLogged;
+    #leaguePoints;
+    #deadmanPoints;
+    constructor(data) {
+        this.#name = data.name;
+        this.#combatLevel = data.combatLevel;
+        this.#questPoints = data.questPoints;
+        this.#skills = data.skills;
+        this.#skillsDetail = data.skillsDetail;
+        this.#bosses = data.bosses;
+        this.#clues = data.clues;
+        this.#bountyHunter = data.bountyHunter;
+        this.#lastManStanding = data.lastManStanding;
+        this.#pvpArena = data.pvpArena;
+        this.#soulWarsZeal = data.soulWarsZeal;
+        this.#riftsClosed = data.riftsClosed;
+        this.#colosseumGlory = data.colosseumGlory;
+        this.#collectionsLogged = data.collectionsLogged;
+        this.#leaguePoints = data.leaguePoints;
+        this.#deadmanPoints = data.deadmanPoints;
+    }
+    static fromJson(json) {
+        const name = json.name || '';
+        const combatLevel = json.main?.combatLevel ?? json.combatLevel ?? 3;
+        const questPoints = json.main?.questPoints ?? json.questPoints ?? 0;
+        // Accept both lower and upper case skill keys
+        const skills = {};
+        const skillsDetail = {};
+        const srcSkills = json.main?.skills || json.skills || {};
+        for (const key of Object.keys(srcSkills)) {
+            skills[key.toLowerCase()] = { level: srcSkills[key].level };
+            skillsDetail[key.toLowerCase()] = {
+                level: srcSkills[key].level,
+                rank: srcSkills[key].rank,
+                xp: srcSkills[key].xp,
+            };
+        }
+        const bosses = json.bosses ? { ...json.bosses } : undefined;
+        const clues = json.clues ? { ...json.clues } : undefined;
+        const bountyHunter = json.bountyHunter
+            ? { ...json.bountyHunter }
+            : undefined;
+        const lastManStanding = json.lastManStanding;
+        const pvpArena = json.pvpArena;
+        const soulWarsZeal = json.soulWarsZeal;
+        const riftsClosed = json.riftsClosed;
+        const colosseumGlory = json.colosseumGlory;
+        const collectionsLogged = json.collectionsLogged;
+        const leaguePoints = json.leaguePoints;
+        const deadmanPoints = json.deadmanPoints;
+        return new OsrsAccount({
+            bosses,
+            bountyHunter,
+            clues,
+            collectionsLogged,
+            colosseumGlory,
+            combatLevel,
+            deadmanPoints,
+            lastManStanding,
+            leaguePoints,
+            name,
+            pvpArena,
+            questPoints,
+            riftsClosed,
+            skills,
+            skillsDetail,
+            soulWarsZeal,
+        });
+    }
+    get name() {
+        return this.#name;
+    }
+    get combatLevel() {
+        return this.#combatLevel;
+    }
+    get questPoints() {
+        return this.#questPoints;
+    }
+    get skills() {
+        return this.#skills;
+    }
+    get skillsDetail() {
+        return this.#skillsDetail;
+    }
+    get bosses() {
+        return this.#bosses;
+    }
+    get clues() {
+        return this.#clues;
+    }
+    get bountyHunter() {
+        return this.#bountyHunter;
+    }
+    get lastManStanding() {
+        return this.#lastManStanding;
+    }
+    get pvpArena() {
+        return this.#pvpArena;
+    }
+    get soulWarsZeal() {
+        return this.#soulWarsZeal;
+    }
+    get riftsClosed() {
+        return this.#riftsClosed;
+    }
+    get colosseumGlory() {
+        return this.#colosseumGlory;
+    }
+    get collectionsLogged() {
+        return this.#collectionsLogged;
+    }
+    get leaguePoints() {
+        return this.#leaguePoints;
+    }
+    get deadmanPoints() {
+        return this.#deadmanPoints;
+    }
+    getSkill(skillName) {
+        return this.#skills[skillName.toLowerCase()];
+    }
+    getSkillDetail(skillName) {
+        return this.#skillsDetail?.[skillName.toLowerCase()];
+    }
+    getBossScore(bossName) {
+        return this.#bosses?.[bossName];
+    }
+    getClueScore(clueType) {
+        return this.#clues?.[clueType];
+    }
+    toString() {
+        return `${this.#name}:\nCombat Level: ${this.#combatLevel}\nQuestPoints: ${this.#questPoints}`;
+    }
+    toJson() {
+        return {
+            bosses: this.#bosses,
+            bountyHunter: this.#bountyHunter,
+            clues: this.#clues,
+            collectionsLogged: this.#collectionsLogged,
+            colosseumGlory: this.#colosseumGlory,
+            combatLevel: this.#combatLevel,
+            deadmanPoints: this.#deadmanPoints,
+            lastManStanding: this.#lastManStanding,
+            leaguePoints: this.#leaguePoints,
+            name: this.#name,
+            pvpArena: this.#pvpArena,
+            questPoints: this.#questPoints,
+            riftsClosed: this.#riftsClosed,
+            skills: this.#skills,
+            skillsDetail: this.#skillsDetail,
+            soulWarsZeal: this.#soulWarsZeal,
+        };
+    }
+}
+export { OsrsAccount };

package/dist/runescape/model/account/Skill.js

@@ -0,0 +1,35 @@
+/**
+ * Enumeration of possible skills in the game.
+ * Used for accessing skill-related data in accounts.
+ * See:: https://oldschool.runescape.wiki/w/Skills
+ * @enum {string}
+ * @readonly
+ * @reference Skill names from OSRS APIv1
+ */
+export var Skill;
+(function (Skill) {
+    Skill["Agility"] = "Agility";
+    Skill["Attack"] = "Attack";
+    Skill["Construction"] = "Construction";
+    Skill["Cooking"] = "Cooking";
+    Skill["Crafting"] = "Crafting";
+    Skill["Defence"] = "Defence";
+    Skill["Farming"] = "Farming";
+    Skill["Firemaking"] = "Firemaking";
+    Skill["Fishing"] = "Fishing";
+    Skill["Fletching"] = "Fletching";
+    Skill["Herblore"] = "Herblore";
+    Skill["Hitpoints"] = "Hitpoints";
+    Skill["Hunter"] = "Hunter";
+    Skill["Magic"] = "Magic";
+    Skill["Mining"] = "Mining";
+    Skill["Prayer"] = "Prayer";
+    Skill["Ranged"] = "Ranged";
+    Skill["Runecraft"] = "Runecraft";
+    Skill["Sailing"] = "Sailing";
+    Skill["Slayer"] = "Slayer";
+    Skill["Smithing"] = "Smithing";
+    Skill["Strength"] = "Strength";
+    Skill["Thieving"] = "Thieving";
+    Skill["Woodcutting"] = "Woodcutting";
+})(Skill || (Skill = {}));

package/dist/runescape/model/account/skills/unlocks/AttackUnlocks.js

@@ -0,0 +1,172 @@
+/**
+ * 1		Bronze	None.[1]
+1		Iron	None.[1]
+1		Machetes	None.
+5		Steel	None.[1]
+10		Black	None.[1]
+10		White	Completion of the Wanted! quest.
+15		Ancient mace	Prayer 25 and partial completion of Another Slice of H.A.M.
+20		Mithril	None.[1]
+30		Adamant	None.[1]
+30		Battlestaves	Magic 30
+30		Swamp lizard	Ranged 30 Magic 30
+40		Brine sabre	None.
+40		Mystic staves	Magic 40
+40		Rune	None.[1]
+42		Void knight mace	Attack 42,Strength,Defence,Hitpoints,Ranged,Magic, and Prayer 22
+50		Ancient staff	Magic 50 and completion of Desert Treasure I.
+50		Granite maul	Strength 50
+50		Granite hammer	Strength 50
+50		Granite longsword	Strength 50
+50		Iban's staff	Magic 50 and completion of Underground Pass.
+50		Purging staff	Magic 77
+50		Leaf-bladed spear	Slayer 55
+50		Leaf-bladed sword	Slayer 55
+50		Orange salamander	Ranged 50 Magic 50
+55		Sulphur blades	None.
+60		Arkan blade	Completion of The Final Dawn.
+60		Barrelchest anchor	Strength 40 and completion of Great Brain Robbery.
+60		Burning claws	None.
+60		Colossal blade	Completion of Sleeping Giants.
+60		Dragon	The dragon longsword and dragon dagger require completion of the Lost City quest.
+The dragon mace and dragon battleaxe require completion of the Heroes' Quest.
+The dragon halberd requires completion of Regicide.[1]
+The dragon scimitar requires completion of Monkey Madness I.
+60		Obsidian	The Obsidian maul (Tzhaar-ket-om) instead requires Strength 60, with no attack requirement.
+The Obsidian staff also requires Magic 60
+60		Red salamander	Ranged 60 Magic 60
+60		Viggora's chainmace	None.
+65		3rd age longsword	None.
+65		Keris partisan	Completion of Beneath Cursed Sands.
+65		Leaf-bladed battleaxe	Slayer 55
+65		Sarachnis cudgel	None.
+65		Zombie axe	None.
+70		Abyssal bludgeon	Strength 70
+70		Abyssal dagger	None.
+70		Abyssal whip	None.
+70		Avernic defender	Defence 70
+70		Barrows	Strength 70 for Dharok's greataxe and Torag's hammers.
+Magic 70 for Ahrim's staff.
+70		Black salamander	Ranged 70 Magic 70
+70		Blue moon spear	Magic 75
+70		Crystal halberd	Strength 35 Agility 50 and completion of the Hard Western Provinces Diary.
+70		Dual macuahuitl	Strength 75
+70		Saradomin sword	None.
+70		Ursine chainmace	None.
+70		Zamorakian spear (Hasta)	None.
+75		Abyssal tentacle	None.
+75		Arclight	Completion of Shadow of the Storm.
+75		Elder maul	Strength 75
+75		Godswords	None.
+75		Saradomin's blessed sword	None.
+75		Staff of the dead	Magic 75
+75		Voidwaker	None.
+77		Emberlight	Smithing 74 (boostable).
+Completion of While Guthix Sleeps.
+78		Dragon hunter lance	Barbarian firemaking (excl. pyre step), fishing, and smithing training.
+80		Blade of Saeldor	None.
+80		Ghrazi rapier	None.
+80		Inquisitor's mace	None.
+80		Keris partisan of breaching (corruption) (the sun)	Completion of Tombs of Amascut.
+80		Noxious halberd	None.
+80		Scythe of vitur	Strength 90
+80		Soulreaper axe	Strength 80
+80		Tecu salamander	Ranged 80 Magic 80
+82		Osmumten's fang	None.
+ */
+import { QuestRequirement } from "../../../Requirement";
+import { Skill } from "../../Skill";
+/** Attack skill unlocks */
+export const AttackUnlocks = [
+    {
+        level: 1,
+        name: "Bronze",
+        description: "None.",
+        skill: Skill.Attack,
+    },
+    {
+        level: 1,
+        name: "Iron",
+        description: "None.",
+        skill: Skill.Attack,
+    },
+    {
+        level: 1,
+        name: "Machetes",
+        description: "None.",
+        skill: Skill.Attack,
+    },
+    {
+        level: 5,
+        name: "Steel",
+        description: "None.[1]",
+        skill: Skill.Attack,
+    },
+    {
+        level: 10,
+        name: "Black",
+        description: "None.[1]",
+        skill: Skill.Attack,
+    },
+    {
+        level: 10,
+        name: "White",
+        description: "Completion of the Wanted! quest.",
+        requirements: [QuestRequirement.fromQuestName("Wanted!")],
+        skill: Skill.Attack,
+    },
+    {
+        level: 15,
+        name: "Ancient mace",
+        description: "Prayer 25 and partial completion of Another Slice of H.A.M.",
+        skill: Skill.Attack,
+    },
+    {
+        level: 20,
+        name: "Mithril",
+        description: "None.[1]",
+        skill: Skill.Attack,
+    },
+    {
+        level: 30,
+        name: "Adamant",
+        description: "None.[1]",
+        skill: Skill.Attack,
+    },
+    {
+        level: 30,
+        name: "Battlestaves",
+        description: "Magic 30",
+        skill: Skill.Attack,
+    },
+    {
+        level: 30,
+        name: "Swamp lizard",
+        description: "Ranged 30 Magic 30",
+        skill: Skill.Attack,
+    },
+    {
+        level: 40,
+        name: "Brine sabre",
+        description: "None.",
+        skill: Skill.Attack,
+    },
+    {
+        level: 40,
+        name: "Mystic staves",
+        description: "Magic 40",
+        skill: Skill.Attack,
+    },
+    {
+        level: 40,
+        name: "Rune",
+        description: "None.[1]",
+        skill: Skill.Attack,
+    },
+    {
+        level: 42,
+        name: "Void knight mace",
+        description: "Attack 42,Strength,Defence,Hitpoints,Ranged,Magic, and Prayer 22",
+        skill: Skill.Attack,
+    },
+];

package/dist/runescape/model/account/skills/unlocks/SkillUnlock.js

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

package/dist/runescape/model/diaries/Ardougne.js

@@ -0,0 +1,3 @@
+import { getDiaryByName } from './Diary';
+export const ArdougneDiary = getDiaryByName('Ardougne Diary');
+export default ArdougneDiary;

package/dist/runescape/model/diaries/Desert.js

@@ -0,0 +1,3 @@
+import { getDiaryByName } from './Diary';
+export const DesertDiary = getDiaryByName('Desert Diary');
+export default DesertDiary;

package/dist/runescape/model/diaries/Diary.js

@@ -0,0 +1,111 @@
+import { LevelRequirement, QuestRequirement, ItemRequirement } from '../Requirement';
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const diariesData = require('../../resources/diary/diaries.json');
+function mapSkillReq(skillReq) {
+    // skillReq: { skill: string, level: number, boostable: boolean }
+    if (!skillReq || !skillReq.skill)
+        return null;
+    return new LevelRequirement(skillReq.skill, skillReq.level ?? 1, !!skillReq.boostable);
+}
+function mapTask(task) {
+    const requirements = [];
+    if (task.requirements) {
+        // quests
+        if (Array.isArray(task.requirements.quests)) {
+            for (const q of task.requirements.quests) {
+                if (q && typeof q === 'string')
+                    requirements.push(new QuestRequirement(q));
+            }
+        }
+        // skills
+        if (Array.isArray(task.requirements.skills)) {
+            for (const s of task.requirements.skills) {
+                const lr = mapSkillReq(s);
+                if (lr)
+                    requirements.push(lr);
+            }
+        }
+    }
+    // items are stored as freeform notes in the resource file
+    const notes = task.other?.itemsNeeded || task.other?.itemsNeeded === '' ? task.other.itemsNeeded : undefined;
+    return {
+        description: task.description || '',
+        requirements,
+        notes,
+    };
+}
+function mapLevel(level) {
+    if (!level)
+        return { tasks: [] };
+    const tasks = Array.isArray(level.tasks) ? level.tasks.map(mapTask) : [];
+    return {
+        itemReward: level.itemReward,
+        rewards: level.rewards,
+        tasks,
+        itemsRequired: level.itemsRequired,
+        itemRequirements: Array.isArray(level.itemsRequired)
+            ? level.itemsRequired.map((s) => mapItemString(s)).filter(Boolean)
+            : undefined,
+        questsRequired: level.questsRequired,
+        skillsRequired: level.skillsRequired,
+    };
+}
+function mapItemString(s) {
+    if (!s || typeof s !== 'string')
+        return null;
+    // Try to extract a leading quantity: "3 strawberry seeds" or "2x item"
+    const qtyMatch = s.trim().match(/^(\d+)\s*(?:x|×)?\s*(.+)$/i);
+    let qty = 1;
+    let name = s.trim();
+    if (qtyMatch) {
+        qty = parseInt(qtyMatch[1], 10) || 1;
+        name = qtyMatch[2].trim();
+    }
+    // detect notes like '(noted)' or '(not consumed)'
+    const noted = /noted/i.test(name);
+    const notConsumed = /not consumed/i.test(name);
+    // strip parenthetical notes from name
+    name = name.replace(/\(.+\)/g, '').trim();
+    return new ItemRequirement(name, qty, { consumed: !notConsumed, noted, notes: s });
+}
+function buildDiary(key, raw) {
+    return {
+        name: raw.name || key,
+        itemReward: raw.itemReward,
+        rewards: raw.rewards,
+        easy: mapLevel(raw.easy),
+        medium: mapLevel(raw.medium),
+        hard: mapLevel(raw.hard),
+        elite: mapLevel(raw.elite),
+    };
+}
+export function getDiaryByName(name) {
+    // exact match first
+    if (diaries[name])
+        return diaries[name];
+    // try case-insensitive
+    const found = Object.keys(diaries).find(k => k.toLowerCase() === name.toLowerCase());
+    return found ? diaries[found] : undefined;
+}
+export function getAllDiaries() {
+    return Object.values(diaries);
+}
+//Build the Diaries for Export
+const diaries = {};
+for (const k of Object.keys(diariesData)) {
+    diaries[k] = buildDiary(k, diariesData[k]);
+}
+export default diaries;
+// Named exports for convenient imports
+export const ArdougneDiary = diaries['Ardougne Diary'];
+export const DesertDiary = diaries['Desert Diary'];
+export const FaladorDiary = diaries['Falador Diary'];
+export const FremennikDiary = diaries['Fremennik Diary'];
+export const KandarinDiary = diaries['Kandarin Diary'];
+export const KaramjaDiary = diaries['Karamja Diary'];
+export const KourendKebosDiary = diaries['Kourend & Kebos Diary'];
+export const LumbridgeDraynorDiary = diaries['Lumbridge & Draynor Diary'];
+export const MorytaniaDiary = diaries['Morytania Diary'];
+export const VarrockDiary = diaries['Varrock Diary'];
+export const WesternProvincesDiary = diaries['Western Provinces Diary'];
+export const WildernessDiary = diaries['Wilderness Diary'];

package/dist/runescape/model/diaries/Fremennik.js

@@ -0,0 +1,3 @@
+import { getDiaryByName } from './Diary';
+export const FremennikDiary = getDiaryByName('Fremennik Diary');
+export default FremennikDiary;

package/dist/runescape/model/diaries/Kandarin.js

@@ -0,0 +1,3 @@
+import { getDiaryByName } from './Diary';
+export const KandarinDiary = getDiaryByName('Kandarin Diary');
+export default KandarinDiary;

package/dist/runescape/model/diaries/Karamja.js

@@ -0,0 +1,3 @@
+import { getDiaryByName } from './Diary';
+export const KaramjaDiary = getDiaryByName('Karamja Diary');
+export default KaramjaDiary;

package/dist/runescape/model/diaries/KourendKebos.js

@@ -0,0 +1,3 @@
+import { getDiaryByName } from './Diary';
+export const KourendKebosDiary = getDiaryByName('Kourend & Kebos Diary');
+export default KourendKebosDiary;

package/dist/runescape/model/diaries/LumbridgeDraynor.js

@@ -0,0 +1,3 @@
+import { getDiaryByName } from './Diary';
+export const LumbridgeDraynorDiary = getDiaryByName('Lumbridge & Draynor Diary');
+export default LumbridgeDraynorDiary;

package/dist/runescape/model/diaries/Morytania.js

@@ -0,0 +1,3 @@
+import { getDiaryByName } from './Diary';
+export const MorytaniaDiary = getDiaryByName('Morytania Diary');
+export default MorytaniaDiary;

package/dist/runescape/model/diaries/Wilderness.js

@@ -0,0 +1,3 @@
+import { getDiaryByName } from './Diary';
+export const WildernessDiary = getDiaryByName('Wilderness Diary');
+export default WildernessDiary;

package/dist/runescape/model/diaries/ardougne/Ardougne.js

@@ -0,0 +1,3 @@
+import { getDiaryByName } from '../Diary';
+export const ArdougneDiary = getDiaryByName('Ardougne Diary');
+export default ArdougneDiary;

package/dist/runescape/model/diaries/desert/Desert.js

@@ -0,0 +1,3 @@
+import { getDiaryByName } from '../Diary';
+export const DesertDiary = getDiaryByName('Desert Diary');
+export default DesertDiary;

package/dist/runescape/model/diaries/index.js

@@ -0,0 +1 @@
+export { default as diaries, getDiaryByName, getAllDiaries } from './Diary';

package/dist/runescape/model/diaries/karamja/Karamja.js

@@ -0,0 +1,3 @@
+import { getDiaryByName } from '../Diary';
+export const KaramjaDiary = getDiaryByName('Karamja Diary');
+export default KaramjaDiary;

package/dist/runescape/model/diaries/varrock/Varrock.js

@@ -0,0 +1,3 @@
+import { getDiaryByName } from '../Diary';
+export const VarrockDiary = getDiaryByName('Varrock Diary');
+export default VarrockDiary;

package/dist/runescape/model/npc/Npc.js

@@ -0,0 +1,82 @@
+/**
+ * Represents a non-player character (NPC) in the game.
+ * @property {number} id - Unique identifier for the NPC.
+ * @property {string} name - Name of the NPC.
+ * @property {string} examine - Description of the NPC.
+ * @property {boolean} members - Indicates if the NPC is a members-only NPC.
+ * @property {number} combatLevel - Combat level of the NPC.
+ * @property {string} officialWikiUrl - URL to the official wiki page for the NPC.
+ * @property {string} [iconUrl] - Optional URL for the NPC's icon.
+ * @property {number} hitpoints - Hitpoints of the NPC.
+ * @property {boolean} aggressive - Indicates if the NPC is aggressive.
+ * @property {string} attackType - The type of attack the NPC uses (e.g., "melee", "ranged", "magic").
+ * @property {string[]} attackStyles - The primary attack style of the NPC (e.g., "melee", "ranged", "magic").
+ * @property {number} maxHit - The maximum hit the NPC can deal.
+ * @property {number} attackSpeed - The attack speed of the NPC in ticks.
+ * @property {number} respawnTime - The time in seconds before the NPC respawns after being killed.
+ * @property {string[]} location - Locations where the NPC can be found.
+ * @property {NpcDrop[]} drops - List of items that the NPC can drop upon death.
+ * @property {string[]} weaknesses - List of weaknesses of the NPC (e.g., "slash", "stab", "crush").
+ * @property {string[]} [products] - List of products/services the NPC offers (e.g., runes, house teleport, etc.).
+ * @property {string[]} [dialogue] - List of notable dialogue lines or dialogue options.
+ * @property {string[]} [changes] - List of notable changes/updates to the NPC.
+ */
+export class Npc {
+    id;
+    name;
+    examine;
+    members;
+    combatLevel;
+    officialWikiUrl;
+    iconUrl;
+    hitpoints;
+    aggressive;
+    attackable;
+    canPoison;
+    poisonous;
+    canCannon;
+    canThrall;
+    canVenom;
+    attackStyles;
+    maxHit;
+    attackSpeed;
+    respawnTime;
+    locations;
+    drops;
+    weaknesses;
+    products;
+    dialogue;
+    changes;
+    trivia;
+    constructor(id, name, examine, members, combatLevel, officialWikiUrl, hitpoints, aggressive, attackable, canPoison, poisonous, canCannon, canThrall, canVenom, attackStyles, maxHit, attackSpeed, respawnTime, locations, drops, weaknesses, iconUrl, products, dialogue, changes, trivia) {
+        this.id = id;
+        this.name = name;
+        this.examine = examine;
+        this.members = members;
+        this.combatLevel = combatLevel;
+        this.officialWikiUrl = officialWikiUrl;
+        this.iconUrl = iconUrl;
+        this.hitpoints = hitpoints;
+        this.aggressive = aggressive;
+        this.attackable = attackable;
+        this.canPoison = canPoison;
+        this.poisonous = poisonous;
+        this.canCannon = canCannon;
+        this.canThrall = canThrall;
+        this.canVenom = canVenom;
+        this.attackStyles = attackStyles;
+        this.maxHit = maxHit;
+        this.attackSpeed = attackSpeed;
+        this.respawnTime = respawnTime;
+        this.locations = locations;
+        this.drops = drops;
+        this.weaknesses = weaknesses;
+        this.products = products;
+        this.dialogue = dialogue;
+        this.changes = changes;
+        this.trivia = trivia;
+    }
+    static createBasicNpc(name) {
+        return new Npc(0, name, '', false, 0, '', 0, false, false, false, false, false, false, false, [''], 0, 0, 0, [], [], [], undefined, [], [], []);
+    }
+}

package/dist/runescape/model/npc/NpcDrop.js

@@ -0,0 +1,23 @@
+export class NpcDrop {
+    item;
+    quantity;
+    rarity;
+    rarityFraction;
+    constructor(item, quantity, // single or range
+    rarity) {
+        this.item = item;
+        this.quantity = quantity;
+        this.rarity = rarity;
+        this.rarityFraction = NpcDrop.parseRarity(rarity);
+    }
+    static parseRarity(rarity) {
+        if (rarity.toLowerCase() === 'always')
+            return 1;
+        const match = rarity.match(/^(\d+)\/(\d+)$/);
+        if (match) {
+            const [, num, denom] = match;
+            return Number(num) / Number(denom);
+        }
+        return undefined;
+    }
+}