warframe-worldstate-parser 2.23.0 → 2.24.0

package/lib/SyndicateJob.js

@@ -5,7 +5,7 @@ const fetch = require('node-fetch');
 const WorldstateObject = require('./WorldstateObject');
 
 const apiBase = process.env.API_BASE_URL || 'https://api.warframestat.us';
-const bountyRewardRegex = /Tier([ABCDE])Table([ABC])Rewards/i;
+const bountyRewardRegex = /(?:Tier([ABCDE])|Narmer)Table([ABC])Rewards/i;
 const ghoulRewardRegex = /GhoulBountyTable([AB])Rewards/i;
 
 /**
@@ -63,7 +63,9 @@ const getBountyRewards = async (i18n, isVault, raw) => {
     ({ location, locationWRot } = determineLocation(i18n, isVault, raw));
   }
   const url = `${apiBase}/drops/search/${encodeURIComponent(location)}?grouped_by=location`;
-  const reply = await fetch(url).then((res) => res.json()).catch(() => {}); // swallow errors
+  const reply = await fetch(url)
+    .then((res) => res.json())
+    .catch(() => {}); // swallow errors
   const pool = (reply || {})[locationWRot];
   if (!pool) {
     return ['Pattern Mismatch. Results inaccurate.'];
@@ -75,41 +77,50 @@ const getBountyRewards = async (i18n, isVault, raw) => {
   return [];
 };
 
+const FIFTY_MINUTES = 3000000;
+
 /**
  * Represents a syndicate daily mission
  * @extends {WorldstateObject}
  */
 class SyndicateJob extends WorldstateObject {
   /**
-   * @param   {Object}             data            The syndicate mission data
-   * @param   {Date}               expiry          The syndicate job expiration
-   * @param   {Object}             deps            The dependencies object
-   * @param   {Translator}         deps.translator The string translator
-   * @param   {string}             deps.locale     Locale to use for translations
+   * @param {Object} data The syndicate mission data
+   * @param {Date} expiry The syndicate job expiration
+   * @param {Object} deps The dependencies object
+   * @param {Object} timeDate Time/Date functions
+   * @param {Translator} translator The string translator
+   * @param {string} locale Locale to use for translations
    */
   constructor(data, expiry, { translator, timeDate, locale }) {
-    super({ _id: { $oid: data.JobCurrentVersion ? data.JobCurrentVersion.$oid : `${(data.jobType || '').split('/').slice(-1)[0]}${expiry.getTime()}` } }, { timeDate });
+    super(
+      {
+        _id: {
+          $oid: data.JobCurrentVersion
+            ? data.JobCurrentVersion.$oid
+            : `${(data.jobType || '').split('/').slice(-1)[0]}${expiry.getTime()}`,
+        },
+      },
+      { timeDate }
+    );
 
     /**
      * Array of strings describing rewards
      * @type {Array.<String>}
      */
     this.rewardPool = [];
-    getBountyRewards(data.rewards, data.isVault, data)
-      .then((rewards) => {
-        this.rewardPool = rewards;
-      });
+    getBountyRewards(data.rewards, data.isVault, data).then((rewards) => {
+      this.rewardPool = rewards;
+    });
 
-    const chamber = ((data.locationTag || '')
-      .match(/[A-Z]+(?![a-z])|[A-Z]?[a-z]+|\d+/g) || [])
-      .join(' ');
+    const chamber = ((data.locationTag || '').match(/[A-Z]+(?![a-z])|[A-Z]?[a-z]+|\d+/g) || []).join(' ');
 
     /**
      * The type of job this is
      * @type {String}
      */
-    this.type = translator.languageString(data.jobType, locale)
-      || `${data.isVault ? 'Isolation Vault' : ''} ${chamber}`;
+    this.type =
+      translator.languageString(data.jobType, locale) || `${data.isVault ? 'Isolation Vault' : ''} ${chamber}`;
 
     /**
      * Array of enemy levels
@@ -141,6 +152,27 @@ class SyndicateJob extends WorldstateObject {
      * @type {string|null}
      */
     this.locationTag = data.locationTag;
+
+    /**
+     * End time for the syndicate mission.
+     * Should be inherited from the Syndicate, but some are timebound.
+     * @type {Date}
+     */
+    this.expiry = expiry;
+
+    /**
+     * What time phase this bounty is bound to
+     * @type {string}
+     */
+    this.timeBound = undefined;
+    if (data.jobType && data.jobType.toLowerCase().includes('narmer')) {
+      if (data.jobType.toLowerCase().includes('eidolon')) {
+        this.timeBound = 'day';
+        this.expiry = new Date(this.expiry.getTime() - FIFTY_MINUTES);
+      } else {
+        this.timeBoound = 'night';
+      }
+    }
   }
 }
 

package/lib/SyndicateMission.js

@@ -16,13 +16,14 @@ class SyndicateMission extends WorldstateObject {
    * @param   {TimeDateFunctions}  deps.timeDate   The time and date functions
    * @param   {string}             deps.locale     Locale to use for translations
    */
-  constructor(data, {
-    mdConfig, translator, timeDate, locale,
-  }) {
+  constructor(data, { mdConfig, translator, timeDate, locale }) {
     super(data, { timeDate });
 
     const deps = {
-      mdConfig, translator, timeDate, locale,
+      mdConfig,
+      translator,
+      timeDate,
+      locale,
     };
 
     /**
@@ -113,8 +114,7 @@ class SyndicateMission extends WorldstateObject {
   toString() {
     if (this.nodes.length > 0) {
       const missions = this.nodes.map((n) => `  \u2022${n.toString()}`).join(this.mdConfig.lineEnd);
-      return `[${this.getETAString()}] ${this.syndicate} currently has missions on: `
-        + `${this.mdConfig.lineEnd}${missions}`;
+      return `[${this.getETAString()}] ${this.syndicate} currently has missions on:${this.mdConfig.lineEnd}${missions}`;
     }
 
     return `No missions available for ${this.syndicate}`;

package/lib/VallisCycle.js

@@ -21,7 +21,7 @@ function getCurrentCycle() {
     toNextMinor = toNextFull - coldTime;
   }
   const milliAtNext = Date.now() + toNextMinor;
-  const milliAtPrev = (Date.now() + toNextFull) - (state === 'warm' ? loopTime : coldTime);
+  const milliAtPrev = Date.now() + toNextFull - (state === 'warm' ? loopTime : coldTime);
   const timeAtPrevious = new Date(milliAtPrev);
   timeAtPrevious.setSeconds(0);
 
@@ -104,7 +104,7 @@ class VallisCycle extends WorldstateObject {
 
     this.id = `vallisCycle${ec.timeAtPrevious.getTime()}`;
 
-    this.shortString = `${this.timeLeft.replace(/\s\d*s/ig, '')} to ${this.isWarm ? 'Cold' : 'Warm'}`;
+    this.shortString = `${this.timeLeft.replace(/\s\d*s/gi, '')} to ${this.isWarm ? 'Cold' : 'Warm'}`;
   }
 
   /**

package/lib/VoidTrader.js

@@ -17,9 +17,7 @@ class VoidTrader extends WorldstateObject {
    * @param   {TimeDateFunctions}  deps.timeDate   The time and date functions
    * @param   {string}             deps.locale     Locale to use for translations
    */
-  constructor(data, {
-    mdConfig, translator, timeDate, locale,
-  }) {
+  constructor(data, { mdConfig, translator, timeDate, locale }) {
     super(data, { timeDate });
 
     /**
@@ -54,7 +52,7 @@ class VoidTrader extends WorldstateObject {
      * The void trader's name
      * @type {string}
      */
-    this.character = data.Character ? data.Character.replace('Baro\'Ki Teel', 'Baro Ki\'Teer') : '';
+    this.character = data.Character ? data.Character.replace("Baro'Ki Teel", "Baro Ki'Teer") : '';
 
     /**
      * The node at which the Void Trader appears
@@ -66,9 +64,7 @@ class VoidTrader extends WorldstateObject {
      * The trader's inventory
      * @type {VoidTraderItem[]}
      */
-    this.inventory = data.Manifest
-      ? data.Manifest.map((i) => new VoidTraderItem(i, { translator, locale }))
-      : [];
+    this.inventory = data.Manifest ? data.Manifest.map((i) => new VoidTraderItem(i, { translator, locale })) : [];
 
     /**
      * Pseudo Identifier for identifying changes in inventory
@@ -99,8 +95,7 @@ class VoidTrader extends WorldstateObject {
     this.initialStart = timeDate.parseDate(data.InitialStartDate);
     this.completed = data.Completed;
     this.schedule = data.ScheduleInfo
-      ? data.ScheduleInfo
-        .map((i) => new VoidTraderSchedule(i, { timeDate, translator, locale }))
+      ? data.ScheduleInfo.map((i) => new VoidTraderSchedule(i, { timeDate, translator, locale }))
       : [];
   }
 
@@ -109,8 +104,7 @@ class VoidTrader extends WorldstateObject {
    * @returns {boolean}
    */
   isActive() {
-    return (this.timeDate.fromNow(this.activation) < 0)
-      && (this.timeDate.fromNow(this.expiry) > 0);
+    return this.timeDate.fromNow(this.activation) < 0 && this.timeDate.fromNow(this.expiry) > 0;
   }
 
   /**
@@ -137,8 +131,10 @@ class VoidTrader extends WorldstateObject {
     if (!this.isActive()) {
       const timeDelta = this.timeDate.fromNow(this.activation);
       const nextArrivalTime = this.timeDate.timeDeltaToString(timeDelta);
-      return `${this.mdConfig.codeMulti}${this.character} is not here yet, he will arrive in `
-        + `${nextArrivalTime} at ${this.location}${this.mdConfig.blockEnd}`;
+      return (
+        `${this.mdConfig.codeMulti}${this.character} is not here yet, he will arrive in ` +
+        `${nextArrivalTime} at ${this.location}${this.mdConfig.blockEnd}`
+      );
     }
 
     const inventoryString = this.inventory

package/lib/WeeklyChallenge.js

@@ -18,8 +18,7 @@ class WeeklyChallenge extends WorldstateObject {
   constructor(data, { timeDate, translator }) {
     super(data, { timeDate });
 
-    this.challenges = data.Challenges
-      .map((challengeData) => new ChallengeInstance(challengeData, { translator }));
+    this.challenges = data.Challenges.map((challengeData) => new ChallengeInstance(challengeData, { translator }));
   }
 
   /**
@@ -27,7 +26,9 @@ class WeeklyChallenge extends WorldstateObject {
    * @returns {string}
    */
   toString() {
-    return `Starts: ${this.getStartString()}\nEnds: ${this.getEndString()}\nChallenges:\n${this.challenges.map((challenge) => `\t${challenge.toString()}`).join('\n')}`;
+    return `Starts: ${this.getStartString()}\nEnds: ${this.getEndString()}\nChallenges:\n${this.challenges
+      .map((challenge) => `\t${challenge.toString()}`)
+      .join('\n')}`;
   }
 }
 

package/lib/WorldEvent.js

@@ -36,13 +36,15 @@ class WorldEvent extends WorldstateObject {
    * @param   {Reward}            deps.Reward     The Reward parser
    * @param   {string}            deps.locale     Locale to use for translations
    */
-  constructor(data, {
-    mdConfig, translator, timeDate, Reward, locale,
-  }) {
+  constructor(data, { mdConfig, translator, timeDate, Reward, locale }) {
     super(data, { timeDate });
 
     const opts = {
-      translator, mdConfig, Reward, timeDate, locale,
+      translator,
+      mdConfig,
+      Reward,
+      timeDate,
+      locale,
     };
 
     /**
@@ -118,9 +120,7 @@ class WorldEvent extends WorldstateObject {
      * The other nodes where the event takes place
      * @type {string[]}
      */
-    this.concurrentNodes = data.ConcurrentNodes
-      ? data.ConcurrentNodes.map((n) => translator.node(n), locale)
-      : [];
+    this.concurrentNodes = data.ConcurrentNodes ? data.ConcurrentNodes.map((n) => translator.node(n), locale) : [];
 
     /**
      * The victim node
@@ -132,16 +132,14 @@ class WorldEvent extends WorldstateObject {
      * The score description
      * @type {?string}
      */
-    this.scoreLocTag = data.Fomorian
-      ? 'Fomorian Assault Score'
-      : translator.languageString(data.ScoreLocTag, locale);
+    this.scoreLocTag = data.Fomorian ? 'Fomorian Assault Score' : translator.languageString(data.ScoreLocTag, locale);
 
     /**
      * The event's rewards
      * @type {Reward[]}
      */
     this.rewards = Object.keys(data)
-      .filter((k) => (k.includes('Reward') || k.includes('reward')))
+      .filter((k) => k.includes('Reward') || k.includes('reward'))
       .map((k) => new Reward(data[k], opts));
 
     /**
@@ -154,16 +152,14 @@ class WorldEvent extends WorldstateObject {
      * Health remaining for the target
      * @type {Number}
      */
-    this.health = typeof data.HealthPct !== 'undefined'
-      ? Number.parseFloat(((data.HealthPct || 0.00) * 100).toFixed(2))
-      : undefined;
+    this.health =
+      typeof data.HealthPct !== 'undefined' ? Number.parseFloat(((data.HealthPct || 0.0) * 100).toFixed(2)) : undefined;
 
     if (data.JobAffiliationTag) {
       this.affiliatedWith = translator.syndicate(data.JobAffiliationTag, locale);
       if (data.Jobs) {
         this.jobs = (data.Jobs || []).map((j) => new SyndicateJob(j, this.expiry, opts));
-        this.previousJobs = (data.PreviousJobs || [])
-          .map((j) => new SyndicateJob(j, this.expiry, opts));
+        this.previousJobs = (data.PreviousJobs || []).map((j) => new SyndicateJob(j, this.expiry, opts));
       }
     }
 
@@ -180,7 +176,7 @@ class WorldEvent extends WorldstateObject {
     this.interimSteps = [];
 
     (data.InterimRewards || []).forEach((reward, index) => {
-      const msg = ((data.InterimRewardMessages || [])[index] || {});
+      const msg = (data.InterimRewardMessages || [])[index] || {};
       this.interimSteps[index] = {
         goal: Number.parseInt(data.InterimGoals[index], 10),
         reward: reward ? new Reward(reward, opts) : undefined,
@@ -191,13 +187,14 @@ class WorldEvent extends WorldstateObject {
           senderIcon: msg.senderIcon,
           attachments: msg.attachments,
         },
+        // eslint-disable-next-line no-underscore-dangle
         winnerCount: (data._interimWinnerCounts || [])[index],
       };
     });
 
     /**
      * Progress Steps, if any are present
-     * @type {ProgessStep[]}
+     * @type {ProgressStep[]}
      */
     this.progressSteps = [];
 
@@ -213,8 +210,7 @@ class WorldEvent extends WorldstateObject {
        * Total of all MultiProgress
        * @type {Number}
        */
-      this.progressTotal = Number.parseFloat(data.MultiProgress
-        .reduce((accumulator, val) => accumulator + val));
+      this.progressTotal = Number.parseFloat(data.MultiProgress.reduce((accumulator, val) => accumulator + val));
     }
 
     /**
@@ -237,15 +233,13 @@ class WorldEvent extends WorldstateObject {
      * Affectors for this mission
      * @type {string[]}
      */
-    this.regionDrops = (data.RegionDrops || [])
-      .map((drop) => translator.languageString(drop, locale));
+    this.regionDrops = (data.RegionDrops || []).map((drop) => translator.languageString(drop, locale));
 
     /**
      * Archwing Drops in effect while this event is active
      * @type {string[]}
      */
-    this.archwingDrops = (data.ArchwingDrops || [])
-      .map((drop) => translator.languageString(drop, locale));
+    this.archwingDrops = (data.ArchwingDrops || []).map((drop) => translator.languageString(drop, locale));
 
     this.asString = this.toString();
 
@@ -285,9 +279,7 @@ class WorldEvent extends WorldstateObject {
    * @returns {string}
    */
   toString() {
-    let lines = [
-      `${this.description} : ${this.faction}`,
-    ];
+    let lines = [`${this.description} : ${this.faction}`];
 
     if (this.scoreLocTag && this.maximumScore) {
       lines.push(`${this.scoreLocTag} : ${this.maximumScore}`);
@@ -307,9 +299,11 @@ class WorldEvent extends WorldstateObject {
       lines.push(`${this.health}% Remaining`);
     }
 
-    if (this.affiliatedWith) {
-      lines.push(`${this.affiliatedWith} will reward you for performing `
-        + `${this.jobs.map((job) => job.type).join(', ')} job${this.jobs.length > 1 ? 's' : ''}`);
+    if (this.affiliatedWith && this.jobs) {
+      lines.push(
+        `${this.affiliatedWith} will reward you for performing ` +
+          `${this.jobs.map((job) => job.type).join(', ')} job${this.jobs.length > 1 ? 's' : ''}`
+      );
     }
 
     return lines.join(this.mdConfig.lineEnd);

package/lib/WorldState.js

@@ -27,6 +27,7 @@ const EarthCycle = require('./EarthCycle');
 const CetusCycle = require('./CetusCycle');
 const ConstructionProgress = require('./ConstructionProgress');
 const VallisCycle = require('./VallisCycle');
+const ZarimanCycle = require('./ZarimanCycle');
 const WeeklyChallenge = require('./WeeklyChallenge');
 const Nightwave = require('./Nightwave');
 const Kuva = require('./Kuva');
@@ -41,8 +42,8 @@ const ExternalMission = require('./supporting/ExternalMission');
 const MarkdownSettings = require('./supporting/MarkdownSettings');
 /* eslint-enable no-unused-vars */
 
-const safeArray = (arr) => (arr || []);
-const safeObj = (obj) => (obj || {});
+const safeArray = (arr) => arr || [];
+const safeObj = (obj) => obj || {};
 
 /**
  * Default Dependency object
@@ -81,7 +82,7 @@ function parseArray(ParserClass, dataArray, deps, uniqueField) {
   const arr = (dataArray || []).map((d) => new ParserClass(d, deps));
   if (uniqueField) {
     const utemp = {};
-    arr.sort((a, b) => a.id.localeCompare((b.id)));
+    arr.sort((a, b) => a.id.localeCompare(b.id));
     arr.forEach((obj) => {
       utemp[obj[uniqueField]] = obj;
     });
@@ -126,9 +127,13 @@ module.exports = class WorldState {
      * The in-game news
      * @type {Array.<News>}
      */
-    this.news = parseArray(deps.News, (data.Events
-      ? data.Events.filter((e) => typeof e.Messages.find((msg) => msg.LanguageCode === deps.locale) !== 'undefined')
-      : []), deps);
+    this.news = parseArray(
+      deps.News,
+      data.Events
+        ? data.Events.filter((e) => typeof e.Messages.find((msg) => msg.LanguageCode === deps.locale) !== 'undefined')
+        : [],
+      deps
+    );
 
     /**
      * The current events
@@ -158,8 +163,9 @@ module.exports = class WorldState {
      * The current fissures: 'ActiveMissions' & 'VoidStorms'
      * @type {Array.<News>}
      */
-    this.fissures = parseArray(deps.Fissure, data.ActiveMissions, deps)
-      .concat(parseArray(deps.Fissure, data.VoidStorms, deps));
+    this.fissures = parseArray(deps.Fissure, data.ActiveMissions, deps).concat(
+      parseArray(deps.Fissure, data.VoidStorms, deps)
+    );
 
     /**
      * The current global upgrades
@@ -221,10 +227,8 @@ module.exports = class WorldState {
      */
     this.earthCycle = new EarthCycle(deps);
 
-    const cetusSynd = safeArray(data.SyndicateMissions)
-      .filter((syndicate) => syndicate.Tag === 'CetusSyndicate');
-    const cetusBountyEnd = timeDate
-      .parseDate(cetusSynd.length > 0 ? cetusSynd[0].Expiry : { $date: 0 });
+    const cetusSynd = safeArray(data.SyndicateMissions).filter((syndicate) => syndicate.Tag === 'CetusSyndicate');
+    const cetusBountyEnd = timeDate.parseDate(cetusSynd.length > 0 ? cetusSynd[0].Expiry : { $date: 0 });
 
     /**
      * The current Cetus cycle
@@ -238,28 +242,32 @@ module.exports = class WorldState {
      */
     this.cambionCycle = new CambionCycle(this.cetusCycle, deps);
 
+    /**
+     * The current Zariman cycle based off current time
+     * @type {ZarimanCycle}
+     */
+    this.zarimanCycle = new ZarimanCycle(Date.now(), deps);
+
     /**
      * Weekly challenges
      * @type {Array.<WeeklyChallenge>}
      */
-    this.weeklyChallenges = data.WeeklyChallenges
-      ? new deps.WeeklyChallenge(data.WeeklyChallenges, deps)
-      : [];
+    this.weeklyChallenges = data.WeeklyChallenges ? new deps.WeeklyChallenge(data.WeeklyChallenges, deps) : [];
 
-    const projectPCTwithOid = data.ProjectPct ? {
-      ProjectPct: data.ProjectPct,
-      _id: {
-        $oid: `${Date.now()}${data.ProjectPct[0]}`,
-      },
-    } : undefined;
+    const projectPCTwithOid = data.ProjectPct
+      ? {
+          ProjectPct: data.ProjectPct,
+          _id: {
+            $oid: `${Date.now()}${data.ProjectPct[0]}`,
+          },
+        }
+      : undefined;
 
     /**
      * The Current construction progress for Fomorians/Razorback/etc.
      * @type {ConstructionProgress}
      */
-    this.constructionProgress = projectPCTwithOid
-      ? new ConstructionProgress(projectPCTwithOid, deps)
-      : {};
+    this.constructionProgress = projectPCTwithOid ? new ConstructionProgress(projectPCTwithOid, deps) : {};
 
     /**
      * The current Orb Vallis cycle state

package/lib/WorldstateObject.js

@@ -12,7 +12,8 @@ class WorldstateObject {
      * The object's id field
      * @type {string}
      */
-    this.id = data._id ? (data._id.$oid || data._id.$id) : undefined;
+    // eslint-disable-next-line no-underscore-dangle
+    this.id = data._id ? data._id.$oid || data._id.$id : undefined;
 
     /**
      * The time and date functions
@@ -67,8 +68,7 @@ class WorldstateObject {
    * @returns {boolean}
    */
   isActive() {
-    return (this.timeDate.fromNow(this.activation) < 0)
-      && (this.timeDate.fromNow(this.expiry) > 0);
+    return this.timeDate.fromNow(this.activation) < 0 && this.timeDate.fromNow(this.expiry) > 0;
   }
 
   /**

package/lib/ZarimanCycle.js

@@ -0,0 +1,136 @@
+'use strict';
+
+const WorldstateObject = require('./WorldstateObject');
+
+// This is a confirmed starting time for Corpus (in millis)
+// All faction operation should use this as a calculation point
+// Unless there's a better logic
+const corpusTimeMillis = 1654725600000;
+const fullCycle = 28800000;
+const stateMaximum = 14400000;
+
+/**
+ * Represents the current Zariman Corpus/Grineer Cycle
+ * @extends {WorldstateObject}
+ */
+module.exports = class ZarimanCycle extends WorldstateObject {
+  /**
+   * @param   {Date}              currentTime     The current time to calculate Zariman cycle for
+   * @param   {Object}            deps            The dependencies object
+   * @param   {MarkdownSettings}  deps.mdConfig   The markdown settings
+   * @param   {TimeDateFunctions} deps.timeDate   The time and date functions
+   */
+  constructor(currentTime, { mdConfig, timeDate }) {
+    super({ _id: { $oid: 'zarimanCycle0' } }, { timeDate });
+
+    /**
+     * The markdown settings
+     * @type {MarkdownSettings}
+     * @private
+     */
+    this.mdConfig = mdConfig;
+    Object.defineProperty(this, 'mdConfig', { enumerable: false, configurable: false });
+
+    /**
+     * The end of the Zariman bounties timer, the faction changes exactly half way through
+     * @type {Date}
+     * @private
+     */
+    this.currentTime = currentTime;
+    Object.defineProperty(this, 'currentTime', { enumerable: false, configurable: false });
+
+    /**
+     * The time and date functions
+     * @type {TimeDateFunctions}
+     * @private
+     */
+    this.timeDate = timeDate;
+    Object.defineProperty(this, 'timeDate', { enumerable: false, configurable: false });
+
+    /**
+     * The current zariman cycle, for calculating the other fields
+     * @type {Object}
+     * @private
+     */
+    const ec = this.getCurrentZarimanCycle();
+    Object.defineProperty(this, 'ec', { enumerable: false, configurable: false });
+
+    /**
+     * The date and time at which the event ends
+     * @type {Date}
+     */
+    this.expiry = ec.expiry;
+
+    /**
+     * The date and time at which the event started
+     * @type {Date}
+     */
+    this.activation = new Date(ec.start);
+
+    /**
+     * Whether or not this it's daytime
+     * @type {boolean}
+     */
+    this.isCorpus = ec.corpusTime;
+
+    /**
+     * Current cycle state. One of `corpus`, `grineer`
+     * @type {string}
+     */
+    this.state = ec.state;
+
+    /**
+     * Time remaining string
+     * @type {string}
+     */
+    this.timeLeft = ec.timeLeft;
+
+    this.id = `zarimanCycle${this.expiry.getTime()}`;
+
+    this.shortString = `${this.timeLeft.replace(/\s\d*s/gi, '')} to ${this.isCorpus ? 'grineer' : 'corpus'}`;
+  }
+
+  /**
+   * Get whether or not the event has expired
+   * @returns {boolean}
+   */
+  getExpired() {
+    return this.timeDate.fromNow(this.expiry) < 0;
+  }
+
+  getCurrentZarimanCycle() {
+    // determine if it is corpus cycle or grineer cycle
+    const timeInCycle = (this.currentTime - corpusTimeMillis) % fullCycle;
+    // if timeInCycle is less than 4 hours, it is corpus, otherwise it is grineer
+    const corpusTime = timeInCycle <= stateMaximum;
+
+    // cycles are offset by 2 hours from bounties
+    const millisLeft = fullCycle - timeInCycle;
+
+    const minutesCoef = 1000 * 60;
+    const expiry = new Date(Math.round((this.currentTime + millisLeft) / minutesCoef) * minutesCoef);
+    const state = corpusTime ? 'corpus' : 'grineer';
+
+    return {
+      corpusTime,
+      timeLeft: this.timeDate.timeDeltaToString(millisLeft),
+      expiry,
+      expiresIn: millisLeft,
+      state,
+      start: expiry.getTime() - stateMaximum,
+    };
+  }
+
+  /**
+   * The event's string representation
+   * @returns {string}
+   */
+  toString() {
+    const lines = [
+      `Operator, Zariman Ten Zero is currently occupied by ${this.state}`,
+      `Time remaining until ${this.isCorpus ? 'grineer' : 'corpus'} takeover: ${this.timeLeft}`,
+    ];
+
+    return lines.join(this.mdConfig.lineEnd);
+  }
+};

package/lib/timeDate.js

@@ -74,8 +74,8 @@ function toNow(d, now = Date.now) {
  * @returns {Date}
  */
 function parseDate(d) {
-  const safeD = (d || epochZero);
-  const dt = (safeD.$date || epochZero.$date);
+  const safeD = d || epochZero;
+  const dt = safeD.$date || epochZero.$date;
   return new Date(safeD.$date ? Number(dt.$numberLong) : 1000 * d.sec);
 }