clashofclans.js 2.0.0-dev.0e51540 → 2.0.0-dev.58f9df9

package/CHANGELOG.md

@@ -2,15 +2,16 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
-## 2.0.0
+## 2.0.0 (2021-11-26)
 
 This new version is a complete TypeScript rewrite to convert everything from plain (literal JSON) objects to class (constructor) objects and support a lot more features.
 
 ### Features
 
--   EventManager and Custom Events ([#37](https://github.com/clashperk/clashofclans.js/issues/37)) ([5027ae6](https://github.com/clashperk/clashofclans.js/commit/5027ae663a8e07175e17384c7e5706f4a1a7afb4)) ([984451d](https://github.com/clashperk/clashofclans.js/commit/30ea3240c11866008d0dae514468c0fdbb34ffd0))
--   Internal Caching Options ([#53](https://github.com/clashperk/clashofclans.js/issues/53))
--   Email Password Login ([#31](https://github.com/clashperk/clashofclans.js/issues/31)) ([4153cd3](https://github.com/clashperk/clashofclans.js/commit/4153cd37ea0e1c71550b9e892105b84d5a407e23))
 -   API Date Parser and Request Retries ([#26](https://github.com/clashperk/clashofclans.js/issues/26)) ([94585f3](https://github.com/clashperk/clashofclans.js/commit/94585f3a84a7175b2d07872f9eb9e42372b95e12))
--   Override Request Options ([#36](https://github.com/clashperk/clashofclans.js/issues/36)) ([42d7fdd](https://github.com/clashperk/clashofclans.js/commit/42d7fdd36262cc46f23b731f8cffb9daea19d3b0))
+-   EventManager and Custom Events ([#37](https://github.com/clashperk/clashofclans.js/issues/37)) ([5027ae6](https://github.com/clashperk/clashofclans.js/commit/5027ae663a8e07175e17384c7e5706f4a1a7afb4))
+-   Email Password Login ([#31](https://github.com/clashperk/clashofclans.js/issues/31)) ([4153cd3](https://github.com/clashperk/clashofclans.js/commit/4153cd37ea0e1c71550b9e892105b84d5a407e23))
 -   QueueThrottler and BatchThrottler ([#34](https://github.com/clashperk/clashofclans.js/issues/34)) ([3a8f051](https://github.com/clashperk/clashofclans.js/commit/3a8f051552e93b98f89bc7d524acdecddf242718))
+-   Override Request Options ([#36](https://github.com/clashperk/clashofclans.js/issues/36)) ([42d7fdd](https://github.com/clashperk/clashofclans.js/commit/42d7fdd36262cc46f23b731f8cffb9daea19d3b0))
+-   Internal Caching Options ([#53](https://github.com/clashperk/clashofclans.js/issues/53)) ([984451d](https://github.com/clashperk/clashofclans.js/commit/30ea3240c11866008d0dae514468c0fdbb34ffd0))
+-   Raw Data for Player Units ([#65](https://github.com/clashperk/clashofclans.js/pull/65)) ([aa1696](https://github.com/clashperk/clashofclans.js/commit/aa1696243d96d4fed0250b4282c60522a6482343))

package/README.md

@@ -39,12 +39,13 @@ const client = new Client();
 ```js
 const { Client, BatchThrottler } = require('clashofclans.js');
 const client = new Client({
+    cache: true,
     retryLimit: 1,
-    restRequestTimeout: 3000,
-    throttler: new BatchThrottler(30)
+    restRequestTimeout: 5000,
+    throttler: new BatchThrottler(20)
 });
 
-client.events.addClans(['#8P2QG08P']);
+client.events.addClans(['#8QU8J9LP', '#8P2QG08P']);
 client.events.setClanEvent({
     name: 'clanDescriptionChange',
     filter: (oldClan, newClan) => {

package/dist/client/Client.d.ts

@@ -21,6 +21,8 @@ export declare class Client extends EventEmitter {
     constructor(options?: ClientOptions);
     /** Contains various general-purpose utility methods. */
     get util(): typeof Util;
+    /** Whether the API is in maintenance break. */
+    get inMaintenance(): boolean;
     /**
      * Initialize the client to create keys.
      * @example
@@ -40,14 +42,34 @@ export declare class Client extends EventEmitter {
     getClanMembers(clanTag: string, options?: SearchOptions): Promise<ClanMember[]>;
     /** Get clan war log. */
     getClanWarLog(clanTag: string, options?: SearchOptions): Promise<ClanWarLog[]>;
-    /** Get info about currently running war (regular or friendly) in the clan. */
-    getClanWar(clanTag: string, options?: OverrideOptions): Promise<ClanWar | null>;
-    /** Get info about currently running war in the clan. */
+    /** Get info about currently running war (normal or friendly) in the clan. */
+    getClanWar(clanTag: string, options?: OverrideOptions): Promise<ClanWar>;
+    /**
+     * Get info about currently running war in the clan.
+     * @example
+     * ```ts
+     * await client.getCurrentWar('#8QU8J9LP');
+     * ```
+     * @example
+     * ```ts
+     * await client.getCurrentWar({ clanTag: '#8QU8J9LP', round: 'PREVIOUS_ROUND' });
+     * ```
+     */
     getCurrentWar(clanTag: string | {
         clanTag: string;
         round?: keyof typeof CWL_ROUNDS;
     }, options?: OverrideOptions): Promise<ClanWar | null>;
-    /** Get info about currently running CWL round. */
+    /**
+     * Get info about currently running CWL round.
+     * @example
+     * ```ts
+     * await client.getLeagueWar('#8QU8J9LP');
+     * ```
+     * @example
+     * ```ts
+     * await client.getLeagueWar({ clanTag: '#8QU8J9LP', round: 'PREVIOUS_ROUND' });
+     * ```
+     */
     getLeagueWar(clanTag: string | {
         clanTag: string;
         round?: keyof typeof CWL_ROUNDS;
@@ -56,11 +78,11 @@ export declare class Client extends EventEmitter {
     private _getClanWars;
     /** Get information about clan war league. */
     getClanWarLeagueGroup(clanTag: string, options?: OverrideOptions): Promise<ClanWarLeagueGroup>;
-    /** Get information about CWL round by WarTag. */
+    /** Get info about a CWL round by WarTag. */
     getClanWarLeagueRound(warTag: string | {
         warTag: string;
         clanTag?: string;
-    }, options?: OverrideOptions): Promise<ClanWar | null>;
+    }, options?: OverrideOptions): Promise<ClanWar>;
     /** Get information about a player by tag. */
     getPlayer(playerTag: string, options?: OverrideOptions): Promise<Player>;
     /** Verify Player API token that can be found from the Game settings. */
@@ -79,9 +101,9 @@ export declare class Client extends EventEmitter {
     getClanRanks(locationId: number | 'global', options?: SearchOptions): Promise<RankedClan[]>;
     /** Get player rankings for a specific location. */
     getPlayerRanks(locationId: number | 'global', options?: SearchOptions): Promise<RankedPlayer[]>;
-    /** Get clan versus rankings for a specific location */
+    /** Get clan versus rankings for a specific location. */
     getVersusClanRanks(locationId: number | 'global', options?: SearchOptions): Promise<RankedClan[]>;
-    /** Get player versus rankings for a specific location */
+    /** Get player versus rankings for a specific location. */
     getVersusPlayerRanks(locationId: number | 'global', options?: SearchOptions): Promise<RankedPlayer[]>;
     /** Get list of clan labels. */
     getClanLabels(options?: SearchOptions): Promise<Label[]>;
@@ -94,8 +116,8 @@ export declare class Client extends EventEmitter {
      *
      * **Parameters**
      *
-     * | Name | Type | Description |
-     * | :--: | :--: | :---------: |
+     * | Name |   Type   | Description           |
+     * | :--: | :------: | :-------------------: |
      * | `id` | `string` | Id of the new season. |
      * @public
      * @event
@@ -112,8 +134,8 @@ export declare class Client extends EventEmitter {
      *
      * **Parameters**
      *
-     * | Name | Type | Description |
-     * | :--: | :--: | :---------: |
+     * |    Name    |   Type   |                    Description                     |
+     * | :--------: | :------: | :------------------------------------------------: |
      * | `duration` | `number` | Duration of the maintenance break in milliseconds. |
      * @public
      * @event
@@ -121,15 +143,21 @@ export declare class Client extends EventEmitter {
     private static maintenanceEnd;
     /** @internal */
     on<K extends keyof ClientEvents>(event: K, listeners: (...args: ClientEvents[K]) => void): this;
+    /** @internal */
+    on<S extends keyof CustomEvents>(event: Exclude<S, keyof ClientEvents>, listeners: (...args: CustomEvents[S]) => void): this;
     /** @internal */ on<S extends string | symbol>(event: Exclude<S, keyof ClientEvents>, listeners: (...args: any[]) => void): this;
     /** @internal */
     once<K extends keyof ClientEvents>(event: K, listeners: (...args: ClientEvents[K]) => void): this;
+    /** @internal */
+    once<S extends keyof CustomEvents>(event: Exclude<S, keyof ClientEvents>, listeners: (...args: CustomEvents[S]) => void): this;
     /** @internal */ once<S extends string | symbol>(event: Exclude<S, keyof ClientEvents>, listeners: (...args: any[]) => void): this;
     /** @internal */
     emit<K extends keyof ClientEvents>(event: K, ...args: ClientEvents[K]): boolean;
+    /** @internal */
+    emit<S extends keyof CustomEvents>(event: Exclude<S, keyof ClientEvents>, ...args: CustomEvents[S]): this;
     /** @internal */ emit<S extends string | symbol>(event: Exclude<S, keyof ClientEvents>, ...args: any[]): boolean;
 }
-export interface ClientEvents {
+interface ClientEvents {
     [EVENTS.NEW_SEASON_START]: [id: string];
     [EVENTS.MAINTENANCE_START]: [];
     [EVENTS.MAINTENANCE_END]: [duration: number];
@@ -141,3 +169,9 @@ export interface ClientEvents {
     [EVENTS.WAR_LOOP_END]: [];
     [EVENTS.ERROR]: [error: unknown];
 }
+interface CustomEvents {
+    [key: `clan${string}`]: [oldClan: Clan, newClan: Clan];
+    [key: `war${string}`]: [oldWar: ClanWar, newWar: ClanWar];
+    [key: `player${string}`]: [oldPlayer: Player, newPlayer: Player];
+}
+export {};

package/dist/client/Client.js

@@ -2,9 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Client = void 0;
 const Constants_1 = require("../util/Constants");
+const HTTPError_1 = require("../rest/HTTPError");
 const RESTManager_1 = require("../rest/RESTManager");
 const EventManager_1 = require("./EventManager");
-const HTTPError_1 = require("../rest/HTTPError");
 const events_1 = require("events");
 const Util_1 = require("../util/Util");
 const struct_1 = require("../struct");
@@ -25,6 +25,11 @@ class Client extends events_1.EventEmitter {
     get util() {
         return Util_1.Util;
     }
+    /** Whether the API is in maintenance break. */
+    get inMaintenance() {
+        // @ts-expect-error
+        return this.events._inMaintenance;
+    }
     /**
      * Initialize the client to create keys.
      * @example
@@ -62,28 +67,48 @@ class Client extends events_1.EventEmitter {
         const { data } = await this.rest.getClanWarLog(clanTag, options);
         return data.items.map((entry) => new struct_1.ClanWarLog(this, entry));
     }
-    /** Get info about currently running war (regular or friendly) in the clan. */
+    /** Get info about currently running war (normal or friendly) in the clan. */
     async getClanWar(clanTag, options) {
-        const { data, maxAge } = await this.rest.getCurrentWar(clanTag, options);
-        if (data.state === 'notInWar')
-            return null;
+        const { data, maxAge, path, status } = await this.rest.getCurrentWar(clanTag, options);
+        if (data.state === 'notInWar') {
+            throw new HTTPError_1.HTTPError(HTTPError_1.NotInWarError, status, path, maxAge);
+        }
         return new struct_1.ClanWar(this, data, { clanTag, maxAge });
     }
-    /** Get info about currently running war in the clan. */
+    /**
+     * Get info about currently running war in the clan.
+     * @example
+     * ```ts
+     * await client.getCurrentWar('#8QU8J9LP');
+     * ```
+     * @example
+     * ```ts
+     * await client.getCurrentWar({ clanTag: '#8QU8J9LP', round: 'PREVIOUS_ROUND' });
+     * ```
+     */
     async getCurrentWar(clanTag, options) {
         const args = typeof clanTag === 'string' ? { clanTag } : { clanTag: clanTag.clanTag, round: clanTag.round };
         try {
-            const data = await this.getClanWar(args.clanTag, options);
-            return data ?? (await this.getLeagueWar({ clanTag: args.clanTag, round: args.round }));
+            return await this.getClanWar(args.clanTag, options);
         }
         catch (e) {
-            if (e instanceof HTTPError_1.HTTPError && e.status === 403) {
-                return this.getLeagueWar({ clanTag: args.clanTag, round: args.round });
+            if (e instanceof HTTPError_1.HTTPError && [200, 403].includes(e.status)) {
+                return this.getLeagueWar({ clanTag: args.clanTag, round: args.round }, options);
             }
+            throw e;
         }
-        return null;
     }
-    /** Get info about currently running CWL round. */
+    /**
+     * Get info about currently running CWL round.
+     * @example
+     * ```ts
+     * await client.getLeagueWar('#8QU8J9LP');
+     * ```
+     * @example
+     * ```ts
+     * await client.getLeagueWar({ clanTag: '#8QU8J9LP', round: 'PREVIOUS_ROUND' });
+     * ```
+     */
     async getLeagueWar(clanTag, options) {
         const args = typeof clanTag === 'string' ? { clanTag } : { clanTag: clanTag.clanTag, round: clanTag.round };
         const state = (args.round && Constants_1.CWL_ROUNDS[args.round]) ?? 'inWar'; // eslint-disable-line
@@ -97,32 +122,30 @@ class Client extends events_1.EventEmitter {
             .map((round) => round.warTags)
             .flat()
             .reverse();
-        const wars = await this.util.allSettled(warTags.map((warTag) => this.getClanWarLeagueRound({ warTag, clanTag: args.clanTag }, { ignoreRateLimit: true })));
+        const wars = await this.util.allSettled(warTags.map((warTag) => this.getClanWarLeagueRound({ warTag, clanTag: args.clanTag }, { ...options, ignoreRateLimit: true })));
         if (args.round && args.round in Constants_1.CWL_ROUNDS) {
-            return wars.find((war) => war?.state === state) ?? null;
+            return wars.find((war) => war.state === state) ?? null;
         }
         return wars.find((war) => war.state === state) ?? wars.at(0) ?? null;
     }
     async _getCurrentLeagueWars(clanTag, options) {
         const data = await this.getClanWarLeagueGroup(clanTag, options);
         // @ts-expect-error
-        return data._getCurrentWars(clanTag);
+        return data._getCurrentWars(clanTag, options);
     }
     async _getClanWars(clanTag, options) {
-        const date = new Date().getDate();
+        const date = new Date().getUTCDate();
+        if (!(date >= 1 && date <= 10)) {
+            return [await this.getClanWar(clanTag, options)];
+        }
         try {
-            const data = await this.getClanWar(clanTag, options);
-            if (!(date >= 1 && date <= 10))
-                return data ? [data] : [];
-            return data ? [data] : await this._getCurrentLeagueWars(clanTag);
+            return this._getCurrentLeagueWars(clanTag, options);
         }
         catch (e) {
-            if (!(date >= 1 && date <= 10))
-                return [];
-            if (e instanceof HTTPError_1.HTTPError && e.status === 403) {
-                return this._getCurrentLeagueWars(clanTag);
+            if (e instanceof HTTPError_1.HTTPError && [404].includes(e.status)) {
+                return [await this.getClanWar(clanTag, options)];
             }
-            return [];
+            throw e;
         }
     }
     /** Get information about clan war league. */
@@ -130,12 +153,13 @@ class Client extends events_1.EventEmitter {
         const { data } = await this.rest.getClanWarLeagueGroup(clanTag, options);
         return new struct_1.ClanWarLeagueGroup(this, data);
     }
-    /** Get information about CWL round by WarTag. */
+    /** Get info about a CWL round by WarTag. */
     async getClanWarLeagueRound(warTag, options) {
         const args = typeof warTag === 'string' ? { warTag } : { warTag: warTag.warTag, clanTag: warTag.clanTag };
-        const { data, maxAge } = await this.rest.getClanWarLeagueRound(args.warTag, options);
-        if (data.state === 'notInWar')
-            return null;
+        const { data, maxAge, status, path } = await this.rest.getClanWarLeagueRound(args.warTag, options);
+        if (data.state === 'notInWar') {
+            throw new HTTPError_1.HTTPError(HTTPError_1.NotInWarError, status, path, maxAge);
+        }
         return new struct_1.ClanWar(this, data, { warTag: args.warTag, clanTag: args.clanTag, maxAge });
     }
     /** Get information about a player by tag. */
@@ -145,7 +169,7 @@ class Client extends events_1.EventEmitter {
     }
     /** Verify Player API token that can be found from the Game settings. */
     async verifyPlayerToken(playerTag, token, options) {
-        const { data } = await this.rest.postPlayerToken(playerTag, token, options);
+        const { data } = await this.rest.verifyPlayerToken(playerTag, token, options);
         return data.status === 'ok';
     }
     /** Get list of Leagues. */
@@ -184,12 +208,12 @@ class Client extends events_1.EventEmitter {
         const { data } = await this.rest.getPlayerRanks(locationId, options);
         return data.items.map((entry) => new struct_1.RankedPlayer(this, entry));
     }
-    /** Get clan versus rankings for a specific location */
+    /** Get clan versus rankings for a specific location. */
     async getVersusClanRanks(locationId, options) {
         const { data } = await this.rest.getVersusClanRanks(locationId, options);
         return data.items.map((entry) => new struct_1.RankedClan(entry));
     }
-    /** Get player versus rankings for a specific location */
+    /** Get player versus rankings for a specific location. */
     async getVersusPlayerRanks(locationId, options) {
         const { data } = await this.rest.getVersusPlayerRanks(locationId, options);
         return data.items.map((entry) => new struct_1.RankedPlayer(this, entry));

package/dist/client/EventManager.d.ts

@@ -1,6 +1,6 @@
 import { Clan, ClanWar, Player } from '../struct';
 import { Client } from './Client';
-/** Represents Event Manager of the {@link Client} class. */
+/** Represents Event Manager of the {@link Client}. */
 export declare class EventManager {
     private readonly client;
     private readonly _clanTags;
@@ -15,18 +15,18 @@ export declare class EventManager {
     constructor(client: Client);
     /** Initialize the Event Manager to start pulling. */
     init(): Promise<string[]>;
-    /** Add a clan tag to clan events. */
-    addClans(...tags: string[]): this;
-    /** Delete a clan tag from clan events. */
-    deleteClans(...tags: string[]): this;
-    /** Add a player tag for player events. */
-    addPlayers(...tags: string[]): this;
-    /** Delete a player tag from player events. */
-    deletePlayers(...tags: string[]): this;
-    /** Add a clan tag for war events. */
-    addWars(...tags: string[]): this;
-    /** Delete a clan tag from war events. */
-    deleteWars(...tags: string[]): this;
+    /** Add clan tags to clan events. */
+    addClans(tags: string[] | string): this;
+    /** Delete clan tags from clan events. */
+    deleteClans(tags: string[] | string): this;
+    /** Add player tags for player events. */
+    addPlayers(tags: string[] | string): this;
+    /** Delete player tags from player events. */
+    deletePlayers(tags: string[] | string): this;
+    /** Add clan tags for war events. */
+    addWars(tags: string[] | string): this;
+    /** Delete clan tags from war events. */
+    deleteWars(tags: string[] | string): this;
     /**
      * Set your own custom clan event.
      *

package/dist/client/EventManager.js

@@ -4,7 +4,7 @@ exports.EventManager = void 0;
 const HTTPError_1 = require("../rest/HTTPError");
 const Constants_1 = require("../util/Constants");
 const Util_1 = require("../util/Util");
-/** Represents Event Manager of the {@link Client} class. */
+/** Represents Event Manager of the {@link Client}. */
 class EventManager {
     constructor(client) {
         this.client = client;
@@ -31,45 +31,52 @@ class EventManager {
         this.warUpdateHandler();
         return Promise.resolve(this.client.eventNames());
     }
-    /** Add a clan tag to clan events. */
-    addClans(...tags) {
-        for (const tag of tags) {
+    /** Add clan tags to clan events. */
+    addClans(tags) {
+        for (const tag of Array.isArray(tags) ? tags : [tags]) {
             this._clanTags.add(this.client.util.parseTag(tag));
         }
         return this;
     }
-    /** Delete a clan tag from clan events. */
-    deleteClans(...tags) {
-        for (const tag of tags) {
-            this._warTags.delete(this.client.util.parseTag(tag));
+    /** Delete clan tags from clan events. */
+    deleteClans(tags) {
+        for (const tag of Array.isArray(tags) ? tags : [tags]) {
+            const key = this.client.util.parseTag(tag);
+            this._clans.delete(key);
+            this._clanTags.delete(key);
         }
         return this;
     }
-    /** Add a player tag for player events. */
-    addPlayers(...tags) {
-        for (const tag of tags) {
+    /** Add player tags for player events. */
+    addPlayers(tags) {
+        for (const tag of Array.isArray(tags) ? tags : [tags]) {
             this._playerTags.add(this.client.util.parseTag(tag));
         }
         return this;
     }
-    /** Delete a player tag from player events. */
-    deletePlayers(...tags) {
-        for (const tag of tags) {
-            this._warTags.delete(this.client.util.parseTag(tag));
+    /** Delete player tags from player events. */
+    deletePlayers(tags) {
+        for (const tag of Array.isArray(tags) ? tags : [tags]) {
+            const key = this.client.util.parseTag(tag);
+            this._players.delete(key);
+            this._playerTags.delete(key);
         }
         return this;
     }
-    /** Add a clan tag for war events. */
-    addWars(...tags) {
-        for (const tag of tags) {
+    /** Add clan tags for war events. */
+    addWars(tags) {
+        for (const tag of Array.isArray(tags) ? tags : [tags]) {
             this._warTags.add(this.client.util.parseTag(tag));
         }
         return this;
     }
-    /** Delete a clan tag from war events. */
-    deleteWars(...tags) {
-        for (const tag of tags) {
-            this._warTags.delete(this.client.util.parseTag(tag));
+    /** Delete clan tags from war events. */
+    deleteWars(tags) {
+        for (const tag of Array.isArray(tags) ? tags : [tags]) {
+            const key = this.client.util.parseTag(tag);
+            this._wars.delete(`${key}:${1}`);
+            this._wars.delete(`${key}:${2}`);
+            this._warTags.delete(key);
         }
         return this;
     }
@@ -100,7 +107,11 @@ class EventManager {
      * @returns
      */
     setClanEvent(event) {
-        this._events.clans.push({ name: event.name, fn: event.filter });
+        if (!event.name)
+            throw new Error('Event name is required.');
+        if (typeof event.filter !== 'function')
+            throw new Error('Filter function is required.');
+        this._events.clans.push(event);
         return this;
     }
     /**
@@ -109,7 +120,11 @@ class EventManager {
      * In order to emit the custom event, you must have this filter function that returns a boolean.
      */
     setWarEvent(event) {
-        this._events.wars.push({ name: event.name, fn: event.filter });
+        if (!event.name)
+            throw new Error('Event name is required.');
+        if (typeof event.filter !== 'function')
+            throw new Error('Filter function is required.');
+        this._events.wars.push(event);
         return this;
     }
     /**
@@ -118,7 +133,11 @@ class EventManager {
      * In order to emit the custom event, you must have this filter function that returns a boolean.
      */
     setPlayerEvent(event) {
-        this._events.players.push({ name: event.name, fn: event.filter });
+        if (!event.name)
+            throw new Error('Event name is required.');
+        if (typeof event.filter !== 'function')
+            throw new Error('Filter function is required.');
+        this._events.players.push(event);
         return this;
     }
     async maintenanceHandler() {
@@ -127,7 +146,7 @@ class EventManager {
             const res = await this.client.rest.getClans({ maxMembers: Math.floor(Math.random() * 40) + 10, limit: 1 });
             if (res.status === 200 && this._inMaintenance) {
                 this._inMaintenance = Boolean(false);
-                const duration = this._maintenanceStartTime.getTime() - Date.now();
+                const duration = Date.now() - this._maintenanceStartTime.getTime();
                 this._maintenanceStartTime = null;
                 this.client.emit(Constants_1.EVENTS.MAINTENANCE_END, duration);
             }
@@ -164,7 +183,7 @@ class EventManager {
         for (const tag of this._playerTags)
             await this.runPlayerUpdate(tag);
         this.client.emit(Constants_1.EVENTS.PLAYER_LOOP_END);
-        setTimeout(this.playerUpdateHandler.bind(this), 100000);
+        setTimeout(this.playerUpdateHandler.bind(this), 10000);
     }
     async warUpdateHandler() {
         this.client.emit(Constants_1.EVENTS.WAR_LOOP_START);
@@ -182,9 +201,9 @@ class EventManager {
         const cached = this._clans.get(clan.tag);
         if (!cached)
             return this._clans.set(clan.tag, clan);
-        for (const { name, fn } of this._events.clans) {
+        for (const { name, filter } of this._events.clans) {
             try {
-                if (!fn(cached, clan))
+                if (!filter(cached, clan))
                     continue;
                 this.client.emit(name, cached, clan);
             }
@@ -203,9 +222,9 @@ class EventManager {
         const cached = this._players.get(player.tag);
         if (!cached)
             return this._players.set(player.tag, player);
-        for (const { name, fn } of this._events.players) {
+        for (const { name, filter } of this._events.players) {
             try {
-                if (!fn(cached, player))
+                if (!filter(cached, player))
                     continue;
                 this.client.emit(name, cached, player);
             }
@@ -222,14 +241,14 @@ class EventManager {
         const clanWars = await this.client._getClanWars(tag).catch(() => null);
         if (!clanWars?.length)
             return null;
-        clanWars.forEach((war, i) => {
-            const key = `WAR:${i}:${tag}`;
+        clanWars.forEach(async (war, index) => {
+            const key = `${tag}:${index}`;
             const cached = this._wars.get(key);
             if (!cached)
                 return this._wars.set(key, war);
-            for (const { name, fn } of this._events.wars) {
+            for (const { name, filter } of this._events.wars) {
                 try {
-                    if (!fn(cached, war))
+                    if (!filter(cached, war))
                         continue;
                     this.client.emit(name, cached, war);
                 }
@@ -237,6 +256,22 @@ class EventManager {
                     this.client.emit(Constants_1.EVENTS.ERROR, error);
                 }
             }
+            // check for war end
+            if (index === 1 && cached.warTag !== war.warTag) {
+                const data = await this.client.getLeagueWar({ clanTag: tag, round: 'PREVIOUS_ROUND' }).catch(() => null);
+                if (data && data.warTag === cached.warTag) {
+                    for (const { name, filter } of this._events.wars) {
+                        try {
+                            if (!filter(cached, data))
+                                continue;
+                            this.client.emit(name, cached, data);
+                        }
+                        catch (error) {
+                            this.client.emit(Constants_1.EVENTS.ERROR, error);
+                        }
+                    }
+                }
+            }
             return this._wars.set(key, war);
         });
     }

package/dist/rest/HTTPError.d.ts

@@ -1,8 +1,24 @@
 /** Represents an HTTP Error. */
 export declare class HTTPError extends Error {
+    /** The message of this error. */
+    message: string;
+    /** The HTTP method of this request. */
     method: string;
+    /** The reason of this error. */
     reason: string;
+    /** The HTTP status code of this request. */
     status: number;
+    /** The path of this request. */
     path: string;
-    constructor(error: any, status: number, path: string, method?: string);
+    /** Maximum number of milliseconds the results can be cached. */
+    maxAge: number;
+    constructor(error: any, status: number, path: string, maxAge: number, method?: string);
 }
+export declare const NotInWarError: {
+    message: string;
+    reason: string;
+};
+export declare const PrivateWarLogError: {
+    message: string;
+    reason: string;
+};

package/dist/rest/HTTPError.js

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HTTPError = void 0;
+exports.PrivateWarLogError = exports.NotInWarError = exports.HTTPError = void 0;
 const messages = {
     500: 'Unknown error happened when handling the request.',
-    504: 'The user aborted a request.',
-    404: 'Resource was not found.',
+    504: 'The user aborted this request.',
+    404: 'Requested resource was not found.',
     400: 'Client provided incorrect parameters for the request.',
     503: 'Service is temporarily unavailable because of maintenance.',
     429: 'Request was throttled, because amount of requests was above the threshold defined for the used API token.',
@@ -21,13 +21,22 @@ const reasons = {
 };
 /** Represents an HTTP Error. */
 class HTTPError extends Error {
-    constructor(error, status, path, method = 'GET') {
+    constructor(error, status, path, maxAge, method) {
         super();
         this.message = error?.message ?? messages[status];
         this.reason = error?.reason ?? reasons[status];
         this.path = path;
-        this.method = method;
+        this.method = method ?? 'GET';
         this.status = status;
+        this.maxAge = maxAge;
     }
 }
 exports.HTTPError = HTTPError;
+exports.NotInWarError = {
+    message: 'Clan is not in war at this moment.',
+    reason: 'notInWar'
+};
+exports.PrivateWarLogError = {
+    message: 'Access denied, clan war log is private.',
+    reason: 'privateWarLog'
+};