clashofclans.js 2.8.0-dev.53b06d3 → 2.8.0-dev.a3d3797

package/dist/client/Client.d.ts

@@ -1,8 +1,7 @@
 /// <reference types="node" />
 import { ClanSearchOptions, SearchOptions, ClientOptions, LoginOptions, OverrideOptions } from '../types';
-import { Events, CWLRounds } from '../util/Constants';
+import { CWLRounds } from '../util/Constants';
 import { RESTManager } from '../rest/RESTManager';
-import { EventManager } from './EventManager';
 import { EventEmitter } from 'events';
 import { Util } from '../util/Util';
 import { Clan, ClanMember, ClanWar, ClanWarLog, League, Location, Player, WarLeague, RankedClan, RankedPlayer, Label, SeasonRankedPlayer, GoldPassSeason, ClanWarLeagueGroup } from '../struct';
@@ -14,15 +13,11 @@ import { Clan, ClanMember, ClanWar, ClanWarLog, League, Location, Player, WarLea
  * ```
  */
 export declare class Client extends EventEmitter {
-    /** Event Manager for the client. */
-    events: EventManager;
     /** REST Handler of the client. */
     rest: RESTManager;
     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
@@ -131,68 +126,4 @@ export declare class Client extends EventEmitter {
     getPlayerLabels(options?: SearchOptions): Promise<Label[]>;
     /** Get info about gold pass season. */
     getGoldPassSeason(options?: OverrideOptions): Promise<GoldPassSeason>;
-    /**
-     * Emits when a new season starts.
-     *
-     * **Parameters**
-     *
-     * | Name |   Type   | Description           |
-     * | :--: | :------: | :-------------------: |
-     * | `id` | `string` | Id of the new season. |
-     * @public
-     * @event
-     */
-    private static newSeasonStart;
-    /**
-     * Emits when maintenance break starts in the API.
-     * @public
-     * @event
-     */
-    private static maintenanceStart;
-    /**
-     * Emits when maintenance break ends in the API.
-     *
-     * **Parameters**
-     *
-     * |    Name    |   Type   |                    Description                     |
-     * | :--------: | :------: | :------------------------------------------------: |
-     * | `duration` | `number` | Duration of the maintenance break in milliseconds. |
-     * @public
-     * @event
-     */
-    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;
-}
-interface ClientEvents {
-    [Events.NewSeasonStart]: [id: string];
-    [Events.MaintenanceStart]: [];
-    [Events.MaintenanceEnd]: [duration: number];
-    [Events.ClanLoopStart]: [];
-    [Events.ClanLoopEnd]: [];
-    [Events.PlayerLoopStart]: [];
-    [Events.PlayerLoopEnd]: [];
-    [Events.WarLoopStart]: [];
-    [Events.WarLoopEnd]: [];
-    [Events.Error]: [error: unknown];
-    [Events.Debug]: [path: string, status: string, message: string];
-}
-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

@@ -4,7 +4,6 @@ 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 events_1 = require("events");
 const Util_1 = require("../util/Util");
 const struct_1 = require("../struct");
@@ -19,17 +18,11 @@ class Client extends events_1.EventEmitter {
     constructor(options) {
         super();
         this.rest = new RESTManager_1.RESTManager({ ...options, rejectIfNotValid: true });
-        this.events = new EventManager_1.EventManager(this);
     }
     /** Contains various general-purpose utility methods. */
     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
@@ -131,7 +124,7 @@ class Client extends events_1.EventEmitter {
         if (args.round && args.round in Constants_1.CWLRounds) {
             return wars.find((war) => war.clan.tag === args.clanTag && war.state === state) ?? null;
         }
-        return wars.find((war) => war.clan.tag === args.clanTag && war.state === state) ?? wars.at(0) ?? null;
+        return wars.find((war) => war.clan.tag === args.clanTag) ?? null;
     }
     /** Returns active wars (last 2) of the CWL group. */
     async getLeagueWars(clanTag, options) {

package/dist/client/EventManager.d.ts

@@ -1,42 +1,42 @@
 import { Clan, ClanWar, Player } from '../struct';
-import { Client } from './Client';
-/** Represents Event Manager of the {@link Client}. */
-export declare class EventManager {
-    private readonly client;
+import { PollingClient } from './PollingClient';
+/** Represents PollingEvent Manager of the {@link PollingClient}. */
+export declare class PollingEventManager {
+    private readonly pollingClient;
     private readonly _clanTags;
     private readonly _playerTags;
     private readonly _warTags;
     private readonly _clans;
     private readonly _players;
     private readonly _wars;
-    private readonly _events;
+    private readonly _pollingEvents;
     private _inMaintenance;
     private _maintenanceStartTime;
-    constructor(client: Client);
-    /** Initialize the Event Manager to start pulling. */
+    constructor(pollingClient: PollingClient);
+    /** Initialize the PollingEvent Manager to start pulling the data by polling api. */
     init(): Promise<string[]>;
-    /** Add clan tags to clan events. */
+    /** Add clan tags to clan polling events. */
     addClans(tags: string[] | string): this;
-    /** Delete clan tags from clan events. */
+    /** Delete clan tags from clan polling events. */
     deleteClans(tags: string[] | string): this;
-    /** Add player tags for player events. */
+    /** Add player tags for player polling events. */
     addPlayers(tags: string[] | string): this;
-    /** Delete player tags from player events. */
+    /** Delete player tags from player polling events. */
     deletePlayers(tags: string[] | string): this;
-    /** Add clan tags for war events. */
+    /** Add clan tags for war polling events. */
     addWars(tags: string[] | string): this;
-    /** Delete clan tags from war events. */
+    /** Delete clan tags from war polling events. */
     deleteWars(tags: string[] | string): this;
     /**
-     * Set your own custom clan event.
+     * Set your own custom clan polling event.
      *
-     * In order to emit the custom event, you must have this filter function that returns a boolean.
+     * In order to emit the custom polling event, you must have this filter function that returns a boolean.
      *
      * @example
      * ```js
-     * client.events.addClans(['#2PP', '#8QU8J9LP']);
+     * client.pollingEvents.addClans(['#2PP', '#8QU8J9LP']);
      *
-     * client.events.setClanEvent({
+     * client.pollingEvents.setClanEvent({
      *   name: 'clanMemberUpdate',
      *   filter: (oldClan, newClan) => {
      *     return oldClan.memberCount !== newClan.memberCount;
@@ -48,7 +48,7 @@ export declare class EventManager {
      * });
      *
      * (async function () {
-     *   await client.events.init();
+     *   await client.pollingEvents.init();
      * })();
      * ```
      * @returns

package/dist/client/EventManager.js

@@ -1,20 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EventManager = void 0;
+exports.PollingEventManager = 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 EventManager {
-    constructor(client) {
-        this.client = client;
+/** Represents PollingEvent Manager of the {@link PollingClient}. */
+class PollingEventManager {
+    constructor(pollingClient) {
+        this.pollingClient = pollingClient;
         this._clanTags = new Set();
         this._playerTags = new Set();
         this._warTags = new Set();
         this._clans = new Map();
         this._players = new Map();
         this._wars = new Map();
-        this._events = {
+        this._pollingEvents = {
             clans: [],
             wars: [],
             players: []
@@ -22,58 +22,58 @@ class EventManager {
         this._inMaintenance = Boolean(false);
         this._maintenanceStartTime = null;
     }
-    /** Initialize the Event Manager to start pulling. */
+    /** Initialize the PollingEvent Manager to start pulling the data by polling api. */
     async init() {
         this.seasonEndHandler();
         this.maintenanceHandler();
         this.clanUpdateHandler();
         this.playerUpdateHandler();
         this.warUpdateHandler();
-        return Promise.resolve(this.client.eventNames());
+        return Promise.resolve(this.pollingClient.eventNames());
     }
-    /** Add clan tags to clan events. */
+    /** Add clan tags to clan polling events. */
     addClans(tags) {
         for (const tag of Array.isArray(tags) ? tags : [tags]) {
-            this._clanTags.add(this.client.util.formatTag(tag));
+            this._clanTags.add(this.pollingClient.util.formatTag(tag));
         }
         return this;
     }
-    /** Delete clan tags from clan events. */
+    /** Delete clan tags from clan polling events. */
     deleteClans(tags) {
         for (const tag of Array.isArray(tags) ? tags : [tags]) {
-            const key = this.client.util.formatTag(tag);
+            const key = this.pollingClient.util.formatTag(tag);
             this._clans.delete(key);
             this._clanTags.delete(key);
         }
         return this;
     }
-    /** Add player tags for player events. */
+    /** Add player tags for player polling events. */
     addPlayers(tags) {
         for (const tag of Array.isArray(tags) ? tags : [tags]) {
-            this._playerTags.add(this.client.util.formatTag(tag));
+            this._playerTags.add(this.pollingClient.util.formatTag(tag));
         }
         return this;
     }
-    /** Delete player tags from player events. */
+    /** Delete player tags from player polling events. */
     deletePlayers(tags) {
         for (const tag of Array.isArray(tags) ? tags : [tags]) {
-            const key = this.client.util.formatTag(tag);
+            const key = this.pollingClient.util.formatTag(tag);
             this._players.delete(key);
             this._playerTags.delete(key);
         }
         return this;
     }
-    /** Add clan tags for war events. */
+    /** Add clan tags for war polling events. */
     addWars(tags) {
         for (const tag of Array.isArray(tags) ? tags : [tags]) {
-            this._warTags.add(this.client.util.formatTag(tag));
+            this._warTags.add(this.pollingClient.util.formatTag(tag));
         }
         return this;
     }
-    /** Delete clan tags from war events. */
+    /** Delete clan tags from war polling events. */
     deleteWars(tags) {
         for (const tag of Array.isArray(tags) ? tags : [tags]) {
-            const key = this.client.util.formatTag(tag);
+            const key = this.pollingClient.util.formatTag(tag);
             this._wars.delete(`${key}:${1}`);
             this._wars.delete(`${key}:${2}`);
             this._warTags.delete(key);
@@ -81,15 +81,15 @@ class EventManager {
         return this;
     }
     /**
-     * Set your own custom clan event.
+     * Set your own custom clan polling event.
      *
-     * In order to emit the custom event, you must have this filter function that returns a boolean.
+     * In order to emit the custom polling event, you must have this filter function that returns a boolean.
      *
      * @example
      * ```js
-     * client.events.addClans(['#2PP', '#8QU8J9LP']);
+     * client.pollingEvents.addClans(['#2PP', '#8QU8J9LP']);
      *
-     * client.events.setClanEvent({
+     * client.pollingEvents.setClanEvent({
      *   name: 'clanMemberUpdate',
      *   filter: (oldClan, newClan) => {
      *     return oldClan.memberCount !== newClan.memberCount;
@@ -101,7 +101,7 @@ class EventManager {
      * });
      *
      * (async function () {
-     *   await client.events.init();
+     *   await client.pollingEvents.init();
      * })();
      * ```
      * @returns
@@ -111,7 +111,7 @@ class EventManager {
             throw new Error('Event name is required.');
         if (typeof event.filter !== 'function')
             throw new Error('Filter function is required.');
-        this._events.clans.push(event);
+        this._pollingEvents.clans.push(event);
         return this;
     }
     /**
@@ -124,7 +124,7 @@ class EventManager {
             throw new Error('Event name is required.');
         if (typeof event.filter !== 'function')
             throw new Error('Filter function is required.');
-        this._events.wars.push(event);
+        this._pollingEvents.wars.push(event);
         return this;
     }
     /**
@@ -137,25 +137,25 @@ class EventManager {
             throw new Error('Event name is required.');
         if (typeof event.filter !== 'function')
             throw new Error('Filter function is required.');
-        this._events.players.push(event);
+        this._pollingEvents.players.push(event);
         return this;
     }
     async maintenanceHandler() {
         setTimeout(this.maintenanceHandler.bind(this), 10000).unref();
         try {
-            const res = await this.client.rest.getClans({ maxMembers: Math.floor(Math.random() * 40) + 10, limit: 1 });
+            const res = await this.pollingClient.rest.getClans({ maxMembers: Math.floor(Math.random() * 40) + 10, limit: 1 });
             if (res.status === 200 && this._inMaintenance) {
                 this._inMaintenance = Boolean(false);
                 const duration = Date.now() - this._maintenanceStartTime.getTime();
                 this._maintenanceStartTime = null;
-                this.client.emit(Constants_1.Events.MaintenanceEnd, duration);
+                this.pollingClient.emit(Constants_1.PollingEvents.MaintenanceEnd, duration);
             }
         }
         catch (error) {
             if (error instanceof HTTPError_1.HTTPError && error.status === 503 && !this._inMaintenance) {
                 this._inMaintenance = Boolean(true);
                 this._maintenanceStartTime = new Date();
-                this.client.emit(Constants_1.Events.MaintenanceStart);
+                this.pollingClient.emit(Constants_1.PollingEvents.MaintenanceStart);
             }
         }
     }
@@ -167,48 +167,48 @@ class EventManager {
         }
         else if (end > 0) {
             setTimeout(() => {
-                this.client.emit(Constants_1.Events.NewSeasonStart, Util_1.Util.getSeasonId());
+                this.pollingClient.emit(Constants_1.PollingEvents.NewSeasonStart, Util_1.Util.getSeasonId());
             }, end + 100).unref();
         }
     }
     async clanUpdateHandler() {
-        this.client.emit(Constants_1.Events.ClanLoopStart);
+        this.pollingClient.emit(Constants_1.PollingEvents.ClanLoopStart);
         for (const tag of this._clanTags)
             await this.runClanUpdate(tag);
-        this.client.emit(Constants_1.Events.ClanLoopEnd);
+        this.pollingClient.emit(Constants_1.PollingEvents.ClanLoopEnd);
         setTimeout(this.clanUpdateHandler.bind(this), 10000);
     }
     async playerUpdateHandler() {
-        this.client.emit(Constants_1.Events.PlayerLoopStart);
+        this.pollingClient.emit(Constants_1.PollingEvents.PlayerLoopStart);
         for (const tag of this._playerTags)
             await this.runPlayerUpdate(tag);
-        this.client.emit(Constants_1.Events.PlayerLoopEnd);
+        this.pollingClient.emit(Constants_1.PollingEvents.PlayerLoopEnd);
         setTimeout(this.playerUpdateHandler.bind(this), 10000);
     }
     async warUpdateHandler() {
-        this.client.emit(Constants_1.Events.WarLoopStart);
+        this.pollingClient.emit(Constants_1.PollingEvents.WarLoopStart);
         for (const tag of this._warTags)
             await this.runWarUpdate(tag);
-        this.client.emit(Constants_1.Events.WarLoopEnd);
+        this.pollingClient.emit(Constants_1.PollingEvents.WarLoopEnd);
         setTimeout(this.warUpdateHandler.bind(this), 10000);
     }
     async runClanUpdate(tag) {
         if (this._inMaintenance)
             return null;
-        const clan = await this.client.getClan(tag).catch(() => null);
+        const clan = await this.pollingClient.getClan(tag).catch(() => null);
         if (!clan)
             return null;
         const cached = this._clans.get(clan.tag);
         if (!cached)
             return this._clans.set(clan.tag, clan);
-        for (const { name, filter } of this._events.clans) {
+        for (const { name, filter } of this._pollingEvents.clans) {
             try {
                 if (!(await filter(cached, clan)))
                     continue;
-                this.client.emit(name, cached, clan);
+                this.pollingClient.emit(name, cached, clan);
             }
             catch (error) {
-                this.client.emit(Constants_1.Events.Error, error);
+                this.pollingClient.emit(Constants_1.PollingEvents.Error, error);
             }
         }
         return this._clans.set(clan.tag, clan);
@@ -216,20 +216,20 @@ class EventManager {
     async runPlayerUpdate(tag) {
         if (this._inMaintenance)
             return null;
-        const player = await this.client.getPlayer(tag).catch(() => null);
+        const player = await this.pollingClient.getPlayer(tag).catch(() => null);
         if (!player)
             return null;
         const cached = this._players.get(player.tag);
         if (!cached)
             return this._players.set(player.tag, player);
-        for (const { name, filter } of this._events.players) {
+        for (const { name, filter } of this._pollingEvents.players) {
             try {
                 if (!(await filter(cached, player)))
                     continue;
-                this.client.emit(name, cached, player);
+                this.pollingClient.emit(name, cached, player);
             }
             catch (error) {
-                this.client.emit(Constants_1.Events.Error, error);
+                this.pollingClient.emit(Constants_1.PollingEvents.Error, error);
             }
         }
         return this._players.set(player.tag, player);
@@ -237,7 +237,7 @@ class EventManager {
     async runWarUpdate(tag) {
         if (this._inMaintenance)
             return null;
-        const clanWars = await this.client.getWars(tag).catch(() => null);
+        const clanWars = await this.pollingClient.getWars(tag).catch(() => null);
         if (!clanWars?.length)
             return null;
         clanWars.forEach(async (war, index) => {
@@ -245,28 +245,28 @@ class EventManager {
             const cached = this._wars.get(key);
             if (!cached)
                 return this._wars.set(key, war);
-            for (const { name, filter } of this._events.wars) {
+            for (const { name, filter } of this._pollingEvents.wars) {
                 try {
                     if (!(await filter(cached, war)))
                         continue;
-                    this.client.emit(name, cached, war);
+                    this.pollingClient.emit(name, cached, war);
                 }
                 catch (error) {
-                    this.client.emit(Constants_1.Events.Error, error);
+                    this.pollingClient.emit(Constants_1.PollingEvents.Error, error);
                 }
             }
             // check for war end
             if (index === 1 && cached.warTag !== war.warTag) {
-                const data = await this.client.getLeagueWar({ clanTag: tag, round: 'PreviousRound' }).catch(() => null);
+                const data = await this.pollingClient.getLeagueWar({ clanTag: tag, round: 'PreviousRound' }).catch(() => null);
                 if (data && data.warTag === cached.warTag) {
-                    for (const { name, filter } of this._events.wars) {
+                    for (const { name, filter } of this._pollingEvents.wars) {
                         try {
                             if (!(await filter(cached, data)))
                                 continue;
-                            this.client.emit(name, cached, data);
+                            this.pollingClient.emit(name, cached, data);
                         }
                         catch (error) {
-                            this.client.emit(Constants_1.Events.Error, error);
+                            this.pollingClient.emit(Constants_1.PollingEvents.Error, error);
                         }
                     }
                 }
@@ -275,4 +275,4 @@ class EventManager {
         });
     }
 }
-exports.EventManager = EventManager;
+exports.PollingEventManager = PollingEventManager;

package/dist/client/PollingClient.d.ts

@@ -0,0 +1,83 @@
+import { Clan, ClanWar, Player } from '../struct';
+import { ClientOptions } from '../types';
+import { PollingEvents } from '../util/Constants';
+import { Client } from './Client';
+import { PollingEventManager } from './EventManager';
+/**
+ * Represents Clash of Clans Polling Event Client.
+ * ```js
+ * const { PollingClient } = require('clashofclans.js');
+ * const client = new PollingClient({ keys: ['***'] });
+ * ```
+ */
+export declare class PollingClient extends Client {
+    /** Polling Event Manager for the client. */
+    pollingEvents: PollingEventManager;
+    constructor(options?: ClientOptions);
+    /** Whether the API is in maintenance break. */
+    get inMaintenance(): any;
+    /**
+     * Emits when a new season starts.
+     *
+     * **Parameters**
+     *
+     * | Name |   Type   | Description           |
+     * | :--: | :------: | :-------------------: |
+     * | `id` | `string` | Id of the new season. |
+     * @public
+     * @event
+     */
+    private static newSeasonStart;
+    /**
+     * Emits when maintenance break starts in the API.
+     * @public
+     * @event
+     */
+    private static maintenanceStart;
+    /**
+     * Emits when maintenance break ends in the API.
+     *
+     * **Parameters**
+     *
+     * |    Name    |   Type   |                    Description                     |
+     * | :--------: | :------: | :------------------------------------------------: |
+     * | `duration` | `number` | Duration of the maintenance break in milliseconds. |
+     * @public
+     * @event
+     */
+    private static maintenanceEnd;
+    /** @internal */
+    on<K extends keyof ClientPollingEvents>(event: K, listeners: (...args: ClientPollingEvents[K]) => void): this;
+    /** @internal */
+    on<S extends keyof CustomEvents>(event: Exclude<S, keyof ClientPollingEvents>, listeners: (...args: CustomEvents[S]) => void): this;
+    /** @internal */ on<S extends string | symbol>(event: Exclude<S, keyof ClientPollingEvents>, listeners: (...args: any[]) => void): this;
+    /** @internal */
+    once<K extends keyof ClientPollingEvents>(event: K, listeners: (...args: ClientPollingEvents[K]) => void): this;
+    /** @internal */
+    once<S extends keyof CustomEvents>(event: Exclude<S, keyof ClientPollingEvents>, listeners: (...args: CustomEvents[S]) => void): this;
+    /** @internal */ once<S extends string | symbol>(event: Exclude<S, keyof ClientPollingEvents>, listeners: (...args: any[]) => void): this;
+    /** @internal */
+    emit<K extends keyof ClientPollingEvents>(event: K, ...args: ClientPollingEvents[K]): boolean;
+    /** @internal */
+    emit<S extends keyof CustomEvents>(event: Exclude<S, keyof ClientPollingEvents>, ...args: CustomEvents[S]): this;
+    /** @internal */ emit<S extends string | symbol>(event: Exclude<S, keyof ClientPollingEvents>, ...args: any[]): boolean;
+}
+interface ClientPollingEvents {
+    [PollingEvents.NewSeasonStart]: [id: string];
+    [PollingEvents.MaintenanceStart]: [];
+    [PollingEvents.MaintenanceEnd]: [duration: number];
+    [PollingEvents.ClanLoopStart]: [];
+    [PollingEvents.ClanLoopEnd]: [];
+    [PollingEvents.PlayerLoopStart]: [];
+    [PollingEvents.PlayerLoopEnd]: [];
+    [PollingEvents.WarLoopStart]: [];
+    [PollingEvents.WarLoopEnd]: [];
+    [PollingEvents.Error]: [error: unknown];
+    [PollingEvents.Debug]: [path: string, status: string, message: string];
+}
+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/PollingClient.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PollingClient = void 0;
+const Constants_1 = require("../util/Constants");
+const Client_1 = require("./Client");
+const EventManager_1 = require("./EventManager");
+/**
+ * Represents Clash of Clans Polling Event Client.
+ * ```js
+ * const { PollingClient } = require('clashofclans.js');
+ * const client = new PollingClient({ keys: ['***'] });
+ * ```
+ */
+class PollingClient extends Client_1.Client {
+    constructor(options) {
+        super(options);
+        this.pollingEvents = new EventManager_1.PollingEventManager(this);
+    }
+    /** Whether the API is in maintenance break. */
+    get inMaintenance() {
+        // @ts-expect-error
+        return this.events._inMaintenance;
+    }
+}
+exports.PollingClient = PollingClient;

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './client/Client';
+export * from './client/PollingClient';
 export * from './rest/RESTManager';
 export * from './rest/RequestHandler';
 export * from './rest/HTTPError';

package/dist/index.js

@@ -11,6 +11,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./client/Client"), exports);
+__exportStar(require("./client/PollingClient"), exports);
 __exportStar(require("./rest/RESTManager"), exports);
 __exportStar(require("./rest/RequestHandler"), exports);
 __exportStar(require("./rest/HTTPError"), exports);

package/dist/index.mjs

@@ -25,8 +25,6 @@ export const DarkElixirTroops = mod.DarkElixirTroops;
 export const DevSiteAPIBaseURL = mod.DevSiteAPIBaseURL;
 export const ElixirSpells = mod.ElixirSpells;
 export const ElixirTroops = mod.ElixirTroops;
-export const EventManager = mod.EventManager;
-export const Events = mod.Events;
 export const FriendlyWarPreparationTimes = mod.FriendlyWarPreparationTimes;
 export const GoldPassSeason = mod.GoldPassSeason;
 export const HTTPError = mod.HTTPError;
@@ -44,6 +42,9 @@ export const Location = mod.Location;
 export const NotInWarError = mod.NotInWarError;
 export const Player = mod.Player;
 export const PlayerClan = mod.PlayerClan;
+export const PollingClient = mod.PollingClient;
+export const PollingEventManager = mod.PollingEventManager;
+export const PollingEvents = mod.PollingEvents;
 export const PrivateWarLogError = mod.PrivateWarLogError;
 export const QueueThrottler = mod.QueueThrottler;
 export const RESTManager = mod.RESTManager;

package/dist/struct/Clan.d.ts

@@ -7,6 +7,7 @@ import type { Player } from './Player';
 import { Location } from './Location';
 import { Label } from './Label';
 import { Badge } from './Badge';
+import { ClanCapital } from './ClanCapital';
 /** Represents a Clan. */
 export declare class Clan {
     client: Client;
@@ -54,6 +55,8 @@ export declare class Clan {
     memberCount: number;
     /** An array of {@link Label} that the clan has. */
     labels: Label[];
+    /** The clan's Clan Capital information */
+    clanCapital: ClanCapital | null;
     /**
      * List of clan members.
      * - This property returns empty array for {@link Client.getClans} method.

package/dist/struct/Clan.js

@@ -7,6 +7,7 @@ const WarLeague_1 = require("./WarLeague");
 const Location_1 = require("./Location");
 const Label_1 = require("./Label");
 const Badge_1 = require("./Badge");
+const ClanCapital_1 = require("./ClanCapital");
 /** Represents a Clan. */
 class Clan {
     constructor(client, data) {
@@ -33,6 +34,7 @@ class Clan {
         this.warLeague = data.warLeague ? new WarLeague_1.WarLeague(data.warLeague) : null;
         this.memberCount = data.members;
         this.labels = data.labels.map((label) => new Label_1.Label(label));
+        this.clanCapital = Object.keys(data.clanCapital).length > 0 ? new ClanCapital_1.ClanCapital(data.clanCapital) : null;
         this.members = data.memberList?.map((mem) => new ClanMember_1.ClanMember(this.client, mem)) ?? []; // eslint-disable-line
     }
     /** Get {@link Player} info for every Player in the clan. */

package/dist/struct/ClanCapital.d.ts

@@ -0,0 +1,12 @@
+import { APIClanCapital } from '../types';
+export declare class ClanCapital {
+    /** The clan capital hall level */
+    capitalHallLevel: number | null;
+    /** The clan capital districts */
+    districts: {
+        id: number;
+        name: string;
+        districtHallLevel: number;
+    }[] | null;
+    constructor(data: APIClanCapital);
+}

package/dist/struct/ClanCapital.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClanCapital = void 0;
+class ClanCapital {
+    constructor(data) {
+        this.capitalHallLevel = data.capitalHallLevel ?? null;
+        this.districts = data.districts ? data.districts : null;
+    }
+}
+exports.ClanCapital = ClanCapital;

package/dist/struct/Player.d.ts

@@ -41,6 +41,8 @@ export declare class Player {
     donations: number;
     /** The player's donation received count for this season. */
     received: number;
+    /** The player's total Clan Capital contribution */
+    clanCapitalContributions: number;
     /** The player's role in the clan or `null` if not in a clan. */
     role: 'member' | 'elder' | 'coLeader' | 'leader' | null;
     /** Whether the player has selected that they are opted in. This will be `null` if the player is not in a clan. */

package/dist/struct/Player.js

@@ -28,6 +28,7 @@ class Player {
         this.versusBattleWins = data.versusBattleWins ?? null;
         this.donations = data.donations;
         this.received = data.donationsReceived;
+        this.clanCapitalContributions = data.clanCapitalContributions;
         // @ts-expect-error
         this.role = data.role?.replace('admin', 'elder') ?? null;
         this.warOptedIn = data.warPreference ? data.warPreference === 'in' : null;

package/dist/types/api.d.ts

@@ -57,6 +57,7 @@ export interface APIClan {
     members: number;
     labels: APILabel[];
     memberList: APIClanMember[];
+    clanCapital: APIClanCapital;
 }
 export interface APIClanMember {
     name: string;
@@ -71,6 +72,14 @@ export interface APIClanMember {
     donations: number;
     donationsReceived: number;
 }
+export interface APIClanCapital {
+    capitalHallLevel?: number;
+    districts?: {
+        id: number;
+        name: string;
+        districtHallLevel: number;
+    }[];
+}
 /** /clans/{clanTag}/members */
 export interface APIClanMemberList {
     items: APIClanMember[];
@@ -179,6 +188,7 @@ export interface APIPlayer {
     versusBattleWinCount?: number;
     donations: number;
     donationsReceived: number;
+    clanCapitalContributions: number;
     role?: string;
     warPreference?: 'in' | 'out';
     clan?: APIPlayerClan;

package/dist/util/Constants.d.ts

@@ -23,7 +23,7 @@ export declare const LegendLeagueId = 29000022;
 export declare const Leagues: number[];
 export declare const WarLeagues: number[];
 export declare const FriendlyWarPreparationTimes: readonly [number, number, number, number, number, number, number, number, number, number, number, number];
-export declare const Events: {
+export declare const PollingEvents: {
     readonly NewSeasonStart: "newSeasonStart";
     readonly ClanLoopStart: "clanLoopStart";
     readonly ClanLoopEnd: "clanLoopEnd";

package/dist/util/Constants.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RawData = exports.CWLRounds = exports.Events = exports.FriendlyWarPreparationTimes = exports.WarLeagues = exports.Leagues = exports.LegendLeagueId = exports.UnrankedLeagueData = exports.HeroPets = exports.Heroes = exports.BuilderTroops = exports.Spells = exports.DarkElixirSpells = exports.ElixirSpells = exports.SuperTroops = exports.SiegeMachines = exports.HomeTroops = exports.DarkElixirTroops = exports.ElixirTroops = exports.DevSiteAPIBaseURL = exports.APIBaseURL = void 0;
+exports.RawData = exports.CWLRounds = exports.PollingEvents = exports.FriendlyWarPreparationTimes = exports.WarLeagues = exports.Leagues = exports.LegendLeagueId = exports.UnrankedLeagueData = exports.HeroPets = exports.Heroes = exports.BuilderTroops = exports.Spells = exports.DarkElixirSpells = exports.ElixirSpells = exports.SuperTroops = exports.SiegeMachines = exports.HomeTroops = exports.DarkElixirTroops = exports.ElixirTroops = exports.DevSiteAPIBaseURL = exports.APIBaseURL = void 0;
 const raw_json_1 = __importDefault(require("../util/raw.json"));
 exports.APIBaseURL = 'https://api.clashofclans.com/v1';
 exports.DevSiteAPIBaseURL = 'https://developer.clashofclans.com/api';
@@ -121,7 +121,7 @@ exports.FriendlyWarPreparationTimes = [
     1000 * 60 * 15,
     1000 * 60 * 5
 ];
-exports.Events = {
+exports.PollingEvents = {
     NewSeasonStart: 'newSeasonStart',
     ClanLoopStart: 'clanLoopStart',
     ClanLoopEnd: 'clanLoopEnd',

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "clashofclans.js",
-	"version": "2.8.0-dev.53b06d3",
+	"version": "2.8.0-dev.a3d3797",
 	"description": "JavaScript library for interacting with the Clash of Clans API",
 	"author": "SUVAJIT <suvajit.me@gmail.com>",
 	"license": "MIT",