@wfcd/profile-parser 1.0.0 → 1.0.2

package/README.md

@@ -1 +1,29 @@
-# profile-parser
+# profile-parser
+
+Parse warframe profile data into useable javascript objects.
+
+[![Supported by the Warframe Community Developers](https://img.shields.io/badge/Warframe_Comm_Devs-supported-blue.svg?color=2E96EF&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyOTgiIGhlaWdodD0iMTczIiB2aWV3Qm94PSIwIDAgMjk4IDE3MyI%2BPHBhdGggZD0iTTE4NSA2N2MxNSA4IDI4IDE2IDMxIDE5czIzIDE4LTcgNjBjMCAwIDM1LTMxIDI2LTc5LTE0LTctNjItMzYtNzAtNDUtNC01LTEwLTEyLTE1LTIyLTUgMTAtOSAxNC0xNSAyMi0xMyAxMy01OCAzOC03MiA0NS05IDQ4IDI2IDc5IDI2IDc5LTMwLTQyLTEwLTU3LTctNjBsMzEtMTkgMzYtMjIgMzYgMjJ6TTU1IDE3M2wtMTctM2MtOC0xOS0yMC00NC0yNC01MC01LTctNy0xMS0xNC0xNWwxOC0yYzE2LTMgMjItNyAzMi0xMyAxIDYgMCA5IDIgMTQtNiA0LTIxIDEwLTI0IDE2IDMgMTQgNSAyNyAyNyA1M3ptMTYtMTFsLTktMi0xNC0yOWEzMCAzMCAwIDAgMC04LThoN2wxMy00IDQgN2MtMyAyLTcgMy04IDZhODYgODYgMCAwIDAgMTUgMzB6bTE3MiAxMWwxNy0zYzgtMTkgMjAtNDQgMjQtNTAgNS03IDctMTEgMTQtMTVsLTE4LTJjLTE2LTMtMjItNy0zMi0xMy0xIDYgMCA5LTIgMTQgNiA0IDIxIDEwIDI0IDE2LTMgMTQtNSAyNy0yNyA1M3ptLTE2LTExbDktMiAxNC0yOWEzMCAzMCAwIDAgMSA4LThoLTdsLTEzLTQtNCA3YzMgMiA3IDMgOCA2YTg2IDg2IDAgMCAxLTE1IDMwem0tNzktNDBsLTYtNmMtMSAzLTMgNi02IDdsNSA1YTUgNSAwIDAgMSAyIDB6bS0xMy0yYTQgNCAwIDAgMSAxLTJsMi0yYTQgNCAwIDAgMSAyLTFsNC0xNy0xNy0xMC04IDcgMTMgOC0yIDctNyAyLTgtMTItOCA4IDEwIDE3em0xMiAxMWE1IDUgMCAwIDAtNC0yIDQgNCAwIDAgMC0zIDFsLTMwIDI3YTUgNSAwIDAgMCAwIDdsNCA0YTYgNiAwIDAgMCA0IDIgNSA1IDAgMCAwIDMtMWwyNy0zMWMyLTIgMS01LTEtN3ptMzkgMjZsLTMwLTI4LTYgNmE1IDUgMCAwIDEgMCAzbDI2IDI5YTEgMSAwIDAgMCAxIDBsNS0yIDItMmMxLTIgMy01IDItNnptNS00NWEyIDIgMCAwIDAtNCAwbC0xIDEtMi00YzEtMy01LTktNS05LTEzLTE0LTIzLTE0LTI3LTEzLTIgMS0yIDEgMCAyIDE0IDIgMTUgMTAgMTMgMTNhNCA0IDAgMCAwLTEgMyAzIDMgMCAwIDAgMSAxbC0yMSAyMmE3IDcgMCAwIDEgNCAyIDggOCAwIDAgMSAyIDNsMjAtMjFhNyA3IDAgMCAwIDEgMSA0IDQgMCAwIDAgNCAwYzEtMSA2IDMgNyA0aC0xYTMgMyAwIDAgMCAwIDQgMiAyIDAgMCAwIDQgMGw2LTZhMyAzIDAgMCAwIDAtM3oiIGZpbGw9IiMyZTk2ZWYiIGZpbGwtcnVsZT0iZXZlbm9kZCIvPjwvc3ZnPg%3D%3D)](https://github.com/WFCD/banner/blob/master/PROJECTS.md)
+[![Coverage Status](https://coveralls.io/repos/github/WFCD/warframe-worldstate-parser/badge.svg?branch=master)](https://coveralls.io/github/WFCD/profile-parser?branch=master)
+[![Discord](https://img.shields.io/discord/256087517353213954.svg?logo=discord)](https://discord.gg/jGZxH9f)
+[![semantic-release: angular](https://img.shields.io/badge/semantic--release-angular-e10079?logo=semantic-release)](https://github.com/semantic-release/semantic-release)
+
+## Documentation
+
+You can find the documentation [here](https://wfcd.github.io/profile-parser/)
+
+## Installation
+
+```shell
+$ npm i -S profile-parser
+```
+
+## Example usage
+
+```javascript
+import { ProfileParser } from 'profile-parser';
+
+const profileData = await fetch('https://content.warframe.com/dynamic/getProfileViewingData.php?n=${username}');
+const user = new ProfileParser(await profileData.text());
+
+console.log(user.profile.displayName);
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wfcd/profile-parser",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Parser for Digital Extreme's profile data",
   "type": "module",
   "main": "src/ProfileParser.js",
@@ -38,10 +38,9 @@
     "prepublishOnly": "npm run build:types",
     "build:docs": "jsdoc -c .github/docs/conf.json -d docs",
     "build:types": "tsc -p tsconfig.declaration.json",
-    "postinstall": "if [ \"$NODE_ENV\" = \"dev\" ] ; then npx -p install-peerdeps@latest install-peerdeps @wfcd/eslint-config@latest -S ; fi",
-    "prepare": "husky"
+    "prepare": "husky && if [ \"$NODE_ENV\" = \"dev\" ] ; then npx -p install-peerdeps@latest install-peerdeps @wfcd/eslint-config@latest -S ; fi"
   },
-  "author": "",
+  "author": "SlayerOrnstein",
   "license": "MIT",
   "engines": {
     "node": ">=18.0.0"
@@ -97,7 +96,7 @@
       "prettier --write",
       "npm -q --no-progress dedupe"
     ],
-    "*.{json,md,yaml}": [
+    "*.{json,md,yaml},!test/data/*.json": [
       "prettier --write"
     ]
   }

package/src/Ability.js

@@ -1,5 +1,6 @@
 /**
- * Represents an ability used by the player
+ * Represents a players used ability
+ * @module
  */
 export default class Ability {
   /**

package/src/ArchonCrystal.js

@@ -1,8 +1,21 @@
 import { archonShardColor, archonShardUpgradeType } from 'warframe-worldstate-data/utilities';
 
+/**
+ * Represents an Archon shard
+ * @module
+ */
 export default class ArchonCrystal {
   constructor(crystal, local) {
+    /**
+     * Archon shard color
+     * @type {String}
+     */
     this.color = archonShardColor(crystal.Color, local);
+
+    /**
+     * Archon shard modifier
+     * @type {String}
+     */
     this.modifier = archonShardUpgradeType(crystal.Color, crystal.UpgradeType, local);
   }
 }

package/src/ChallengeProgress.js

@@ -1,3 +1,7 @@
+/**
+ * Player completed or in progress challenges
+ * @module
+ */
 export default class ChallengeProgress {
   constructor(challenge) {
     /**

package/src/Enemy.js

@@ -1,5 +1,6 @@
 /**
- * Represents the enemies killed
+ * An enemy killed/executed by player
+ * @module
  */
 export default class Enemy {
   /**
@@ -37,7 +38,7 @@ export default class Enemy {
     this.assists = enemy.assists;
 
     /**
-     * How many times tis enemy type has killed the player
+     * How many times this enemy type has killed the player
      * @type {number}
      */
     this.deaths = enemy.deaths;

package/src/Intrinsics.js

@@ -1,3 +1,7 @@
+/**
+ * Player's intrinsics ranks
+ * @module
+ */
 export default class Intrinsics {
   constructor(skills) {
     // I know this is railjack but I'm not sure what the context is

package/src/ItemConfig.js

@@ -3,7 +3,8 @@ import { colors, find } from 'warframe-items/utilities';
 import mapToHex from './Util.js';
 
 /**
- * Represents the data configuration for an item
+ * Item customizations such as colors and applied skins
+ * @module
  */
 export default class ItemConfig {
   /**

package/src/LoadOutInventory.js

@@ -2,6 +2,10 @@ import LoadOutItem from './LoadOutItem.js';
 import WeaponSkin from './WeaponSkin.js';
 import XpInfo from './XpInfo.js';
 
+/**
+ * Player loudout
+ * @module
+ */
 export default class LoadOutInventory {
   constructor(item) {
     /**
@@ -18,21 +22,21 @@ export default class LoadOutInventory {
 
     /**
      * An array of the player's currently equiped secondary weapon
-     * @type {LoadOutItem}
+     * @type {LoadOutItem | undefined}
      */
-    this.secondary = item.Pistols.map((p) => new LoadOutItem(p));
+    this.secondary = item.Pistols?.map((p) => new LoadOutItem(p));
 
     /**
      * An array of the player's currently equiped primary weapon
-     * @type {LoadOutItem}
+     * @type {LoadOutItem | undefined}
      */
-    this.primary = item.LongGuns.map((lg) => new LoadOutItem(lg));
+    this.primary = item.LongGuns?.map((lg) => new LoadOutItem(lg));
 
     /**
      * An array of the player's currently equiped melee weapon
-     * @type {LoadOutItem}
+     * @type {LoadOutItem | undefined}
      */
-    this.melee = item.Melee.map((m) => new LoadOutItem(m));
+    this.melee = item.Melee?.map((m) => new LoadOutItem(m));
 
     /**
      * Items that have counted towards the players mastery rank

package/src/LoadOutItem.js

@@ -4,6 +4,10 @@ import { parseDate, toTitleCase } from 'warframe-worldstate-data/utilities';
 import ItemConfig from './ItemConfig.js';
 import Polarity from './Polarity.js';
 
+/**
+ * An an item in LoadOutInventory
+ * @module
+ */
 export default class LoadOutItem {
   constructor(weapon) {
     /**
@@ -86,9 +90,9 @@ export default class LoadOutItem {
 
     /**
      * Which polarity types exist on the weapon
-     * @type {Array<Polarity>}
+     * @type {Array<Polarity> | undefined}
      */
-    this.polarity = weapon.Polarity.map((p) => new Polarity(p));
+    this.polarity = weapon.Polarity?.map((p) => new Polarity(p));
 
     /**
      * Focus lens applied

package/src/Mission.js

@@ -1,5 +1,9 @@
 import { node, nodeEnemy, nodeMissionType } from 'warframe-worldstate-data/utilities';
 
+/**
+ * A mission completed by the player
+ * @module
+ */
 export default class Mission {
   constructor(mission, locale) {
     const uniqueName = mission.Type || mission.Tag;

package/src/OperatorLoadOuts.js

@@ -2,6 +2,10 @@ import { colors } from 'warframe-items/utilities';
 
 import mapToHex from './Util.js';
 
+/**
+ * Player's operator loadout
+ * @module
+ */
 export default class OperatorLoadOuts {
   constructor(loadout) {
     /**
@@ -12,9 +16,9 @@ export default class OperatorLoadOuts {
 
     /**
      * Operator amp ID
-     * @type {String}
+     * @type {String | undefined}
      */
-    this.operatorAmp = loadout.OperatorAmp.$oid;
+    this.operatorAmp = loadout.OperatorAmp?.$oid;
 
     /**
      * Applied upgrade IDs

package/src/Polarity.js

@@ -1,5 +1,9 @@
 import { translatePolarity } from 'warframe-worldstate-data/utilities';
 
+/**
+ * A polarity in a LoadOutItem
+ * @module
+ */
 export default class Polarity {
   constructor(polarity) {
     /**

package/src/Profile.js

@@ -7,6 +7,10 @@ import Mission from './Mission.js';
 import OperatorLoadOuts from './OperatorLoadOuts.js';
 import Syndicate from './Syndicate.js';
 
+/**
+ * A player's profile
+ * @module
+ */
 export default class Profile {
   constructor(profile, locale) {
     /**
@@ -176,9 +180,9 @@ export default class Profile {
 
     /**
      * Operator loadout
-     * @type {OperatorLoadOuts}
+     * @type {OperatorLoadOuts | undefined}
      */
-    this.operatorLoadouts = profile.OperatorLoadOuts.map((ol) => new OperatorLoadOuts(ol));
+    this.operatorLoadouts = profile.OperatorLoadOuts?.map((ol) => new OperatorLoadOuts(ol));
 
     /**
      * Player's alignment

package/src/ProfileParser.js

@@ -3,6 +3,10 @@ import { parseDate } from 'warframe-worldstate-data/utilities';
 import Profile from './Profile.js';
 import Stats from './Stats.js';
 
+/**
+ * Parser entry point
+ * @module
+ */
 export default class ProfileParser {
   constructor(data, locale) {
     /**
@@ -11,16 +15,24 @@ export default class ProfileParser {
      */
     this.profile = new Profile(data.Results[0], locale);
 
-    // N/A
+    /**
+     * @type {number}
+     */
     this.techProjects = data.TechProjects;
 
-    // N/A
+    /**
+     * @type {number}
+     */
     this.xpComponents = data.XpCompoents;
 
-    // N/A
+    /**
+     * @type {number}
+     */
     this.xpCacheExpiryDate = parseDate(data.XpCacheExpiryDate);
 
-    // N/A
+    /**
+     * @type {number}
+     */
     this.ceremonyResetDate = parseDate(data.CeremonyResetDate);
 
     /**

package/src/Pvp.js

@@ -1,3 +1,7 @@
+/**
+ * Player's conclave stats
+ * @module
+ */
 export default class Pvp {
   constructor(pvp) {
     /**

package/src/Race.js

@@ -1,3 +1,7 @@
+/**
+ * Represents a k-drive race
+ * @module
+ */
 export default class Race {
   constructor(race) {
     /**

package/src/Scan.js

@@ -1,3 +1,7 @@
+/**
+ * Represents an enemy scanned to the codex
+ * @module
+ */
 export default class Scan {
   constructor(scan) {
     /**

package/src/Stats.js

@@ -7,7 +7,8 @@ import Scan from './Scan.js';
 import Weapon from './Weapon.js';
 
 /**
- * Player stats
+ * A player's overall career stats
+ * @module
  */
 export default class Stats {
   /**

package/src/Syndicate.js

@@ -1,11 +1,15 @@
+import { syndicate } from 'warframe-worldstate-data/utilities';
+
 /**
- * Represents a player's progress with a Syndicate
+ * Represents a syndicate
+ * @module
  */
 export default class Syndicate {
   /**
    * @param {Object} affiliation The syndicate data
+   * @param {string} locale  locale code
    */
-  constructor(affiliation) {
+  constructor(affiliation, locale) {
     // TODO: name is readable but still might want to clean them up
     // i.e "NewLokaSyndicate" can be "New Loka"" instead
 
@@ -13,7 +17,7 @@ export default class Syndicate {
      * Name of the syndicate
      * @type {String}
      */
-    this.name = affiliation.Tag;
+    this.name = syndicate(affiliation.Tag, locale);
 
     /**
      * Current standing the player has with the syndicate

package/src/Util.js

@@ -1,3 +1,5 @@
+/** @module */
+
 /**
  * Map base10 int colors to hex color strings
  * @param {Record<string, number | undefined>} colors color map

package/src/Weapon.js

@@ -1,3 +1,7 @@
+/**
+ * Represents a player's used weapon stats
+ * @module
+ */
 export default class Weapon {
   constructor(weapon) {
     /**

package/src/WeaponSkin.js

@@ -1,3 +1,7 @@
+/**
+ * A weapon skin
+ * @module
+ */
 export default class WeaponSkin {
   constructor(skin) {
     /**

package/src/XpInfo.js

@@ -1,5 +1,9 @@
 import { find } from 'warframe-items/utilities';
 
+/**
+ * An item that has contributed to a player's mastery rank
+ * @module
+ */
 export default class XpInfo {
   constructor(info) {
     /**

package/types/Ability.d.ts

@@ -1,5 +1,6 @@
 /**
- * Represents an ability used by the player
+ * Represents a players used ability
+ * @module
  */
 export default class Ability {
     /**

package/types/ArchonCrystal.d.ts

@@ -1,5 +1,17 @@
+/**
+ * Represents an Archon shard
+ * @module
+ */
 export default class ArchonCrystal {
     constructor(crystal: any, local: any);
-    color: any;
-    modifier: any;
+    /**
+     * Archon shard color
+     * @type {String}
+     */
+    color: string;
+    /**
+     * Archon shard modifier
+     * @type {String}
+     */
+    modifier: string;
 }

package/types/ChallengeProgress.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Player completed or in progress challenges
+ * @module
+ */
 export default class ChallengeProgress {
     constructor(challenge: any);
     /**

package/types/Enemy.d.ts

@@ -1,5 +1,6 @@
 /**
- * Represents the enemies killed
+ * An enemy killed/executed by player
+ * @module
  */
 export default class Enemy {
     /**
@@ -32,7 +33,7 @@ export default class Enemy {
      */
     assists: number;
     /**
-     * How many times tis enemy type has killed the player
+     * How many times this enemy type has killed the player
      * @type {number}
      */
     deaths: number;

package/types/Intrinsics.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Player's intrinsics ranks
+ * @module
+ */
 export default class Intrinsics {
     constructor(skills: any);
     /**

package/types/ItemConfig.d.ts

@@ -1,5 +1,6 @@
 /**
- * Represents the data configuration for an item
+ * Item customizations such as colors and applied skins
+ * @module
  */
 export default class ItemConfig {
     /**

package/types/LoadOutInventory.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Player loudout
+ * @module
+ */
 export default class LoadOutInventory {
     constructor(item: any);
     /**
@@ -12,19 +16,19 @@ export default class LoadOutInventory {
     suits: LoadOutItem;
     /**
      * An array of the player's currently equiped secondary weapon
-     * @type {LoadOutItem}
+     * @type {LoadOutItem | undefined}
      */
-    secondary: LoadOutItem;
+    secondary: LoadOutItem | undefined;
     /**
      * An array of the player's currently equiped primary weapon
-     * @type {LoadOutItem}
+     * @type {LoadOutItem | undefined}
      */
-    primary: LoadOutItem;
+    primary: LoadOutItem | undefined;
     /**
      * An array of the player's currently equiped melee weapon
-     * @type {LoadOutItem}
+     * @type {LoadOutItem | undefined}
      */
-    melee: LoadOutItem;
+    melee: LoadOutItem | undefined;
     /**
      * Items that have counted towards the players mastery rank
      * @type {XpInfo}

package/types/LoadOutItem.d.ts

@@ -1,3 +1,7 @@
+/**
+ * An an item in LoadOutInventory
+ * @module
+ */
 export default class LoadOutItem {
     constructor(weapon: any);
     /**
@@ -56,9 +60,9 @@ export default class LoadOutItem {
     polarized: number;
     /**
      * Which polarity types exist on the weapon
-     * @type {Array<Polarity>}
+     * @type {Array<Polarity> | undefined}
      */
-    polarity: Array<Polarity>;
+    polarity: Array<Polarity> | undefined;
     /**
      * Focus lens applied
      * @type {String}

package/types/Mission.d.ts

@@ -1,3 +1,7 @@
+/**
+ * A mission completed by the player
+ * @module
+ */
 export default class Mission {
     constructor(mission: any, locale: any);
     /**

package/types/OperatorLoadOuts.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Player's operator loadout
+ * @module
+ */
 export default class OperatorLoadOuts {
     constructor(loadout: any);
     /**
@@ -7,9 +11,9 @@ export default class OperatorLoadOuts {
     skins: Array<string>;
     /**
      * Operator amp ID
-     * @type {String}
+     * @type {String | undefined}
      */
-    operatorAmp: string;
+    operatorAmp: string | undefined;
     /**
      * Applied upgrade IDs
      * @type {Array<String>}

package/types/Polarity.d.ts

@@ -1,3 +1,7 @@
+/**
+ * A polarity in a LoadOutItem
+ * @module
+ */
 export default class Polarity {
     constructor(polarity: any);
     /**

package/types/Profile.d.ts

@@ -1,3 +1,7 @@
+/**
+ * A player's profile
+ * @module
+ */
 export default class Profile {
     constructor(profile: any, locale: any);
     /**
@@ -128,9 +132,9 @@ export default class Profile {
     unlockedAlignment: bool;
     /**
      * Operator loadout
-     * @type {OperatorLoadOuts}
+     * @type {OperatorLoadOuts | undefined}
      */
-    operatorLoadouts: OperatorLoadOuts;
+    operatorLoadouts: OperatorLoadOuts | undefined;
     /**
      * Player's alignment
      * @type {Map<String,number>}

package/types/ProfileParser.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Parser entry point
+ * @module
+ */
 export default class ProfileParser {
     constructor(data: any, locale: any);
     /**
@@ -5,10 +9,22 @@ export default class ProfileParser {
      * @type {Profile}
      */
     profile: Profile;
-    techProjects: any;
-    xpComponents: any;
-    xpCacheExpiryDate: any;
-    ceremonyResetDate: any;
+    /**
+     * @type {number}
+     */
+    techProjects: number;
+    /**
+     * @type {number}
+     */
+    xpComponents: number;
+    /**
+     * @type {number}
+     */
+    xpCacheExpiryDate: number;
+    /**
+     * @type {number}
+     */
+    ceremonyResetDate: number;
     /**
      * Player stats
      * @type {Stats}

package/types/Pvp.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Player's conclave stats
+ * @module
+ */
 export default class Pvp {
     constructor(pvp: any);
     /**

package/types/Race.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Represents a k-drive race
+ * @module
+ */
 export default class Race {
     constructor(race: any);
     /**

package/types/Scan.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Represents an enemy scanned to the codex
+ * @module
+ */
 export default class Scan {
     constructor(scan: any);
     /**

package/types/Stats.d.ts

@@ -1,5 +1,6 @@
 /**
- * Player stats
+ * A player's overall career stats
+ * @module
  */
 export default class Stats {
     /**

package/types/Syndicate.d.ts

@@ -1,11 +1,13 @@
 /**
- * Represents a player's progress with a Syndicate
+ * Represents a syndicate
+ * @module
  */
 export default class Syndicate {
     /**
      * @param {Object} affiliation The syndicate data
+     * @param {string} locale  locale code
      */
-    constructor(affiliation: any);
+    constructor(affiliation: any, locale: string);
     /**
      * Name of the syndicate
      * @type {String}

package/types/Util.d.ts

@@ -1,3 +1,4 @@
+/** @module */
 /**
  * Map base10 int colors to hex color strings
  * @param {Record<string, number | undefined>} colors color map

package/types/Weapon.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Represents a player's used weapon stats
+ * @module
+ */
 export default class Weapon {
     constructor(weapon: any);
     /**

package/types/WeaponSkin.d.ts

@@ -1,3 +1,7 @@
+/**
+ * A weapon skin
+ * @module
+ */
 export default class WeaponSkin {
     constructor(skin: any);
     /**

package/types/XpInfo.d.ts

@@ -1,3 +1,7 @@
+/**
+ * An item that has contributed to a player's mastery rank
+ * @module
+ */
 export default class XpInfo {
     constructor(info: any);
     /**