clashofclans.js 3.0.0-dev.392ca4c → 3.0.0-dev.f6ce42f

package/dist/client/Client.d.ts

@@ -1,8 +1,8 @@
 /// <reference types="node" />
+import { EventEmitter } from 'node:events';
 import { ClanSearchOptions, SearchOptions, ClientOptions, LoginOptions, OverrideOptions } from '../types';
 import { CWLRounds } from '../util/Constants';
 import { RESTManager } from '../rest/RESTManager';
-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';
 /**

package/dist/client/Client.js

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Client = void 0;
+const node_events_1 = require("node:events");
 const Constants_1 = require("../util/Constants");
 const HTTPError_1 = require("../rest/HTTPError");
 const RESTManager_1 = require("../rest/RESTManager");
-const events_1 = require("events");
 const Util_1 = require("../util/Util");
 const struct_1 = require("../struct");
 /**
@@ -14,7 +14,7 @@ const struct_1 = require("../struct");
  * const client = new Client({ keys: ['***'] });
  * ```
  */
-class Client extends events_1.EventEmitter {
+class Client extends node_events_1.EventEmitter {
     constructor(options) {
         super();
         this.rest = new RESTManager_1.RESTManager({ ...options, rejectIfNotValid: true });
@@ -140,7 +140,7 @@ class Client extends events_1.EventEmitter {
             return [await this.getClanWar(clanTag, options)];
         }
         try {
-            return this.getLeagueWars(clanTag, options);
+            return await this.getLeagueWars(clanTag, options);
         }
         catch (e) {
             if (e instanceof HTTPError_1.HTTPError && [404].includes(e.status)) {

package/dist/client/PollingClient.d.ts

@@ -2,7 +2,6 @@ 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
@@ -11,11 +10,86 @@ import { PollingEventManager } from './EventManager';
  * ```
  */
 export declare class PollingClient extends Client {
-    /** Polling Event Manager for the client. */
-    pollingEvents: PollingEventManager;
+    private readonly _clanTags;
+    private readonly _playerTags;
+    private readonly _warTags;
+    private readonly _clans;
+    private readonly _players;
+    private readonly _wars;
+    private readonly _pollingEvents;
+    inMaintenance: boolean;
+    private _maintenanceStartTime;
     constructor(options?: ClientOptions);
-    /** Whether the API is in maintenance break. */
-    get inMaintenance(): any;
+    /** Initialize the PollingEvent Manager to start pulling the data by polling api. */
+    init(): Promise<string[]>;
+    /** Add clan tags to clan polling events. */
+    addClans(tags: string[] | string): this;
+    /** Delete clan tags from clan polling events. */
+    deleteClans(tags: string[] | string): this;
+    /** Add player tags for player polling events. */
+    addPlayers(tags: string[] | string): this;
+    /** Delete player tags from player polling events. */
+    deletePlayers(tags: string[] | string): this;
+    /** Add clan tags for war polling events. */
+    addWars(tags: string[] | string): this;
+    /** Delete clan tags from war polling events. */
+    deleteWars(tags: string[] | string): this;
+    /**
+     * Set your own custom clan polling event.
+     *
+     * In order to emit the custom polling event, you must have this filter function that returns a boolean.
+     *
+     * @example
+     * ```js
+     * client.pollingEvents.addClans(['#2PP', '#8QU8J9LP']);
+     *
+     * client.pollingEvents.setClanEvent({
+     *   name: 'clanMemberUpdate',
+     *   filter: (oldClan, newClan) => {
+     *     return oldClan.memberCount !== newClan.memberCount;
+     *   }
+     * });
+     *
+     * client.on('clanMemberUpdate', (oldClan, newClan) => {
+     *   console.log(oldClan.memberCount, newClan.memberCount);
+     * });
+     *
+     * (async function () {
+     *   await client.pollingEvents.init();
+     * })();
+     * ```
+     * @returns
+     */
+    setClanEvent(event: {
+        name: string;
+        filter: (oldClan: Clan, newClan: Clan) => boolean;
+    }): this;
+    /**
+     * Set your own custom war event.
+     *
+     * In order to emit the custom event, you must have this filter function that returns a boolean.
+     */
+    setWarEvent(event: {
+        name: string;
+        filter: (oldWar: ClanWar, newWar: ClanWar) => boolean;
+    }): this;
+    /**
+     * Set your own custom player event.
+     *
+     * In order to emit the custom event, you must have this filter function that returns a boolean.
+     */
+    setPlayerEvent(event: {
+        name: string;
+        filter: (oldPlayer: Player, newPlayer: Player) => boolean;
+    }): this;
+    private maintenanceHandler;
+    private seasonEndHandler;
+    private clanUpdateHandler;
+    private playerUpdateHandler;
+    private warUpdateHandler;
+    private runClanUpdate;
+    private runPlayerUpdate;
+    private runWarUpdate;
     /**
      * Emits when a new season starts.
      *

package/dist/client/PollingClient.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PollingClient = void 0;
+const HTTPError_1 = require("../rest/HTTPError");
 const Constants_1 = require("../util/Constants");
 const Client_1 = require("./Client");
-const EventManager_1 = require("./EventManager");
 /**
  * Represents Clash of Clans Polling Event Client.
  * ```js
@@ -14,12 +14,271 @@ const EventManager_1 = require("./EventManager");
 class PollingClient extends Client_1.Client {
     constructor(options) {
         super(options);
-        this.pollingEvents = new EventManager_1.PollingEventManager(this);
+        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._pollingEvents = {
+            clans: [],
+            wars: [],
+            players: []
+        };
+        this.inMaintenance = Boolean(false);
+        this._maintenanceStartTime = null;
     }
-    /** Whether the API is in maintenance break. */
-    get inMaintenance() {
-        // @ts-expect-error
-        return this.events._inMaintenance;
+    /** 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.eventNames());
+    }
+    /** Add clan tags to clan polling events. */
+    addClans(tags) {
+        for (const tag of Array.isArray(tags) ? tags : [tags]) {
+            this._clanTags.add(this.util.formatTag(tag));
+        }
+        return this;
+    }
+    /** Delete clan tags from clan polling events. */
+    deleteClans(tags) {
+        for (const tag of Array.isArray(tags) ? tags : [tags]) {
+            const key = this.util.formatTag(tag);
+            this._clans.delete(key);
+            this._clanTags.delete(key);
+        }
+        return this;
+    }
+    /** Add player tags for player polling events. */
+    addPlayers(tags) {
+        for (const tag of Array.isArray(tags) ? tags : [tags]) {
+            this._playerTags.add(this.util.formatTag(tag));
+        }
+        return this;
+    }
+    /** Delete player tags from player polling events. */
+    deletePlayers(tags) {
+        for (const tag of Array.isArray(tags) ? tags : [tags]) {
+            const key = this.util.formatTag(tag);
+            this._players.delete(key);
+            this._playerTags.delete(key);
+        }
+        return this;
+    }
+    /** Add clan tags for war polling events. */
+    addWars(tags) {
+        for (const tag of Array.isArray(tags) ? tags : [tags]) {
+            this._warTags.add(this.util.formatTag(tag));
+        }
+        return this;
+    }
+    /** Delete clan tags from war polling events. */
+    deleteWars(tags) {
+        for (const tag of Array.isArray(tags) ? tags : [tags]) {
+            const key = this.util.formatTag(tag);
+            this._wars.delete(`${key}:${1}`);
+            this._wars.delete(`${key}:${2}`);
+            this._warTags.delete(key);
+        }
+        return this;
+    }
+    /**
+     * Set your own custom clan polling event.
+     *
+     * In order to emit the custom polling event, you must have this filter function that returns a boolean.
+     *
+     * @example
+     * ```js
+     * client.pollingEvents.addClans(['#2PP', '#8QU8J9LP']);
+     *
+     * client.pollingEvents.setClanEvent({
+     *   name: 'clanMemberUpdate',
+     *   filter: (oldClan, newClan) => {
+     *     return oldClan.memberCount !== newClan.memberCount;
+     *   }
+     * });
+     *
+     * client.on('clanMemberUpdate', (oldClan, newClan) => {
+     *   console.log(oldClan.memberCount, newClan.memberCount);
+     * });
+     *
+     * (async function () {
+     *   await client.pollingEvents.init();
+     * })();
+     * ```
+     * @returns
+     */
+    setClanEvent(event) {
+        if (!event.name)
+            throw new Error('Event name is required.');
+        if (typeof event.filter !== 'function')
+            throw new Error('Filter function is required.');
+        this._pollingEvents.clans.push(event);
+        return this;
+    }
+    /**
+     * Set your own custom war event.
+     *
+     * In order to emit the custom event, you must have this filter function that returns a boolean.
+     */
+    setWarEvent(event) {
+        if (!event.name)
+            throw new Error('Event name is required.');
+        if (typeof event.filter !== 'function')
+            throw new Error('Filter function is required.');
+        this._pollingEvents.wars.push(event);
+        return this;
+    }
+    /**
+     * Set your own custom player event.
+     *
+     * In order to emit the custom event, you must have this filter function that returns a boolean.
+     */
+    setPlayerEvent(event) {
+        if (!event.name)
+            throw new Error('Event name is required.');
+        if (typeof event.filter !== 'function')
+            throw new Error('Filter function is required.');
+        this._pollingEvents.players.push(event);
+        return this;
+    }
+    async maintenanceHandler() {
+        setTimeout(this.maintenanceHandler.bind(this), 10000).unref();
+        try {
+            const res = await this.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.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.emit(Constants_1.PollingEvents.MaintenanceStart);
+            }
+        }
+    }
+    seasonEndHandler() {
+        const end = this.util.getSeasonEndTime().getTime() - Date.now();
+        // Why this? setTimeout can be up to 24.8 days or 2147483647ms [(2^31 - 1) Max 32bit Integer]
+        if (end > 24 * 60 * 60 * 1000) {
+            setTimeout(this.seasonEndHandler.bind(this), 60 * 60 * 1000);
+        }
+        else if (end > 0) {
+            setTimeout(() => {
+                this.emit(Constants_1.PollingEvents.NewSeasonStart, this.util.getSeasonId());
+            }, end + 100).unref();
+        }
+    }
+    async clanUpdateHandler() {
+        this.emit(Constants_1.PollingEvents.ClanLoopStart);
+        for (const tag of this._clanTags)
+            await this.runClanUpdate(tag);
+        this.emit(Constants_1.PollingEvents.ClanLoopEnd);
+        setTimeout(this.clanUpdateHandler.bind(this), 10000);
+    }
+    async playerUpdateHandler() {
+        this.emit(Constants_1.PollingEvents.PlayerLoopStart);
+        for (const tag of this._playerTags)
+            await this.runPlayerUpdate(tag);
+        this.emit(Constants_1.PollingEvents.PlayerLoopEnd);
+        setTimeout(this.playerUpdateHandler.bind(this), 10000);
+    }
+    async warUpdateHandler() {
+        this.emit(Constants_1.PollingEvents.WarLoopStart);
+        for (const tag of this._warTags)
+            await this.runWarUpdate(tag);
+        this.emit(Constants_1.PollingEvents.WarLoopEnd);
+        setTimeout(this.warUpdateHandler.bind(this), 10000);
+    }
+    async runClanUpdate(tag) {
+        if (this.inMaintenance)
+            return null;
+        const clan = await this.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._pollingEvents.clans) {
+            try {
+                if (!(await filter(cached, clan)))
+                    continue;
+                this.emit(name, cached, clan);
+            }
+            catch (error) {
+                this.emit(Constants_1.PollingEvents.Error, error);
+            }
+        }
+        return this._clans.set(clan.tag, clan);
+    }
+    async runPlayerUpdate(tag) {
+        if (this.inMaintenance)
+            return null;
+        const player = await this.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._pollingEvents.players) {
+            try {
+                if (!(await filter(cached, player)))
+                    continue;
+                this.emit(name, cached, player);
+            }
+            catch (error) {
+                this.emit(Constants_1.PollingEvents.Error, error);
+            }
+        }
+        return this._players.set(player.tag, player);
+    }
+    async runWarUpdate(tag) {
+        if (this.inMaintenance)
+            return null;
+        const clanWars = await this.getWars(tag).catch(() => null);
+        if (!clanWars?.length)
+            return null;
+        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, filter } of this._pollingEvents.wars) {
+                try {
+                    if (!(await filter(cached, war)))
+                        continue;
+                    this.emit(name, cached, war);
+                }
+                catch (error) {
+                    this.emit(Constants_1.PollingEvents.Error, error);
+                }
+            }
+            // check for war end
+            if (index === 1 && cached.warTag !== war.warTag) {
+                const data = await this.getLeagueWar({ clanTag: tag, round: 'PreviousRound' }).catch(() => null);
+                if (data && data.warTag === cached.warTag) {
+                    for (const { name, filter } of this._pollingEvents.wars) {
+                        try {
+                            if (!(await filter(cached, data)))
+                                continue;
+                            this.emit(name, cached, data);
+                        }
+                        catch (error) {
+                            this.emit(Constants_1.PollingEvents.Error, error);
+                        }
+                    }
+                }
+            }
+            return this._wars.set(key, war);
+        });
     }
 }
 exports.PollingClient = PollingClient;

package/dist/index.d.ts

@@ -3,7 +3,6 @@ export * from './client/PollingClient';
 export * from './rest/RESTManager';
 export * from './rest/RequestHandler';
 export * from './rest/HTTPError';
-export * from './client/EventManager';
 export * from './rest/Throttler';
 export * from './util/Util';
 export * from './struct';

package/dist/index.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
@@ -15,7 +19,6 @@ __exportStar(require("./client/PollingClient"), exports);
 __exportStar(require("./rest/RESTManager"), exports);
 __exportStar(require("./rest/RequestHandler"), exports);
 __exportStar(require("./rest/HTTPError"), exports);
-__exportStar(require("./client/EventManager"), exports);
 __exportStar(require("./rest/Throttler"), exports);
 __exportStar(require("./util/Util"), exports);
 __exportStar(require("./struct"), exports);

package/dist/index.mjs

@@ -43,7 +43,6 @@ 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;
@@ -52,6 +51,7 @@ export const RankedClan = mod.RankedClan;
 export const RankedPlayer = mod.RankedPlayer;
 export const RawData = mod.RawData;
 export const RequestHandler = mod.RequestHandler;
+export const RestEvents = mod.RestEvents;
 export const Season = mod.Season;
 export const SeasonRankedPlayer = mod.SeasonRankedPlayer;
 export const SiegeMachines = mod.SiegeMachines;

package/dist/rest/RESTManager.d.ts

@@ -1,6 +1,6 @@
-import { RequestHandler } from './RequestHandler';
 import { Util } from '../util/Util';
 import { APIClan, APIClanList, APIClanMemberList, APIClanRankingList, APIClanVersusRankingList, APIClanWar, APIClanWarLeagueGroup, APIClanWarLog, APIGoldPassSeason, APILabelList, APILeague, APILeagueList, APILeagueSeasonList, APILocation, APILocationList, APIPlayer, APIPlayerRankingList, APIPlayerSeasonRankingList, APIPlayerVersusRankingList, APIVerifyToken, APIWarLeague, APIWarLeagueList, SearchOptions, ClanSearchOptions, RESTOptions, OverrideOptions, LoginOptions } from '../types';
+import { RequestHandler } from './RequestHandler';
 /** Represents a REST Manager of the client. */
 export declare class RESTManager {
     /** Request Handler for the RESTManager. */

package/dist/rest/RESTManager.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RESTManager = void 0;
-const RequestHandler_1 = require("./RequestHandler");
 const Util_1 = require("../util/Util");
+const RequestHandler_1 = require("./RequestHandler");
 /** Represents a REST Manager of the client. */
 class RESTManager {
     constructor(options) {

package/dist/rest/RequestHandler.js

@@ -16,13 +16,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 var _RequestHandler_keyIndex;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RequestHandler = void 0;
+const node_https_1 = __importDefault(require("node:https"));
+const node_fetch_1 = __importDefault(require("node-fetch"));
 const Constants_1 = require("../util/Constants");
-const HTTPError_1 = require("./HTTPError");
 const Store_1 = require("../util/Store");
-const node_fetch_1 = __importDefault(require("node-fetch"));
-const https_1 = __importDefault(require("https"));
+const HTTPError_1 = require("./HTTPError");
 const IP_REGEX = /\d{1,3}.\d{1,3}.\d{1,3}.\d{1,3}/g;
-const agent = new https_1.default.Agent({ keepAlive: true });
+const agent = new node_https_1.default.Agent({ keepAlive: true });
 /** Represents a Request Handler. */
 class RequestHandler {
     constructor(options) {

package/dist/struct/Clan.d.ts

@@ -1,7 +1,7 @@
 import { APIClan, OverrideOptions } from '../types';
+import { Client } from '../client/Client';
 import { ChatLanguage } from './ChatLanguage';
 import { ClanMember } from './ClanMember';
-import { Client } from '../client/Client';
 import { WarLeague } from './WarLeague';
 import type { Player } from './Player';
 import { Location } from './Location';

package/dist/struct/Player.d.ts

@@ -1,9 +1,9 @@
 import { APIPlayer, OverrideOptions } from '../types';
+import { Client } from '../client/Client';
 import { LegendStatistics } from './LegendStatistics';
 import { Achievement } from './Achievement';
 import { Hero, Spell, Troop } from './Unit';
 import { PlayerClan } from './PlayerClan';
-import { Client } from '../client/Client';
 import { League } from './League';
 import { Label } from './Label';
 /** Represents a Clash of Clans Player. */

package/dist/struct/Ranking.d.ts

@@ -1,6 +1,6 @@
 import { APIClanRanking, APIClanVersusRanking, APIPlayerRanking, APIPlayerVersusRanking } from '../types';
-import { PlayerClan } from './PlayerClan';
 import { Client } from '../client/Client';
+import { PlayerClan } from './PlayerClan';
 import { Location } from './Location';
 import { League } from './League';
 import { Badge } from './Badge';

package/dist/struct/index.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/dist/types/index.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/dist/types/lib.d.ts

@@ -1,9 +1,9 @@
 import { QueueThrottler, BatchThrottler } from '../rest/Throttler';
 export interface Store<T = any> {
-    set(key: string, value: T, ttl?: number): boolean | Promise<boolean>;
-    get(key: string): T | null | Promise<T | null>;
-    delete(key: string): boolean | Promise<boolean>;
-    clear(): void | Promise<void>;
+    set: (key: string, value: T, ttl?: number) => boolean | Promise<boolean>;
+    get: (key: string) => T | null | Promise<T | null>;
+    delete: (key: string) => boolean | Promise<boolean>;
+    clear: () => void | Promise<void>;
 }
 /** Options for a {@link Client} */
 export interface ClientOptions {

package/dist/util/Constants.d.ts

@@ -36,6 +36,10 @@ export declare const PollingEvents: {
     readonly Error: "error";
     readonly Debug: "debug";
 };
+export declare const RestEvents: {
+    readonly Error: "error";
+    readonly Debug: "debug";
+};
 export declare const CWLRounds: {
     readonly PreviousRound: "warEnded";
     readonly CurrentRound: "inWar";

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.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;
+exports.RawData = exports.CWLRounds = exports.RestEvents = 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';
@@ -134,6 +134,10 @@ exports.PollingEvents = {
     Error: 'error',
     Debug: 'debug'
 };
+exports.RestEvents = {
+    Error: 'error',
+    Debug: 'debug'
+};
 exports.CWLRounds = {
     PreviousRound: 'warEnded',
     CurrentRound: 'inWar',

package/dist/util/Util.js

@@ -114,8 +114,8 @@ class Util extends null {
     }
     /** Parse in-game army link into troops and spells count with respective Id's. */
     static parseArmyLink(link) {
-        const unitsMatches = link.match(/u(?<units>[\d+x-]+)/);
-        const spellsMatches = link.match(/s(?<spells>[\d+x-]+)/);
+        const unitsMatches = /u(?<units>[\d+x-]+)/.exec(link);
+        const spellsMatches = /s(?<spells>[\d+x-]+)/.exec(link);
         const unitsPart = unitsMatches?.groups?.unit?.split('-') ?? [];
         const spellParts = spellsMatches?.groups?.spells?.split('-') ?? [];
         const units = unitsPart

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "clashofclans.js",
-	"version": "3.0.0-dev.392ca4c",
+	"version": "3.0.0-dev.f6ce42f",
 	"description": "JavaScript library for interacting with the Clash of Clans API",
 	"author": "SUVAJIT <suvajit.me@gmail.com>",
 	"license": "MIT",
@@ -34,61 +34,6 @@
 		"url": "https://github.com/clashperk/clashofclans.js/issues"
 	},
 	"homepage": "https://clashofclans.js.org",
-	"eslintConfig": {
-		"extends": [
-			"marine/prettier/node",
-			"plugin:prettier/recommended"
-		],
-		"plugins": [
-			"prettier"
-		],
-		"ignorePatterns": [
-			"dist/*",
-			"docs/*"
-		],
-		"parser": "@typescript-eslint/parser",
-		"rules": {
-			"no-process-env": 0,
-			"no-inline-comments": 0,
-			"no-warning-comments": 0,
-			"comma-dangle": [
-				"error",
-				"never"
-			],
-			"@typescript-eslint/naming-convention": 0,
-			"@typescript-eslint/no-floating-promises": 0,
-			"@typescript-eslint/no-misused-promises": 0
-		}
-	},
-	"prettier": {
-		"semi": true,
-		"tabWidth": 4,
-		"printWidth": 140,
-		"singleQuote": true,
-		"quoteProps": "consistent",
-		"bracketSpacing": true,
-		"trailingComma": "none",
-		"overrides": [
-			{
-				"files": [
-					"*.md"
-				],
-				"options": {
-					"useTabs": false,
-					"tabWidth": 4
-				}
-			},
-			{
-				"files": [
-					"*.yml"
-				],
-				"options": {
-					"useTabs": false,
-					"tabWidth": 2
-				}
-			}
-		]
-	},
 	"standard-version": {
 		"skip": {
 			"changelog": false,
@@ -100,18 +45,20 @@
 		"node-fetch": "^2.6.7"
 	},
 	"devDependencies": {
-		"@types/node": "^16.10.3",
 		"@types/node-fetch": "^2.5.12",
+		"gen-esm-wrapper": "^1.1.3",
+		"@types/node": "^18.6.4",
 		"@typescript-eslint/eslint-plugin": "^5.4.0",
 		"@typescript-eslint/parser": "^5.4.0",
+		"dotenv": "^16.0.2",
 		"eslint": "^8.3.0",
 		"eslint-config-marine": "^9.0.6",
 		"eslint-config-prettier": "^8.3.0",
+		"eslint-plugin-import": "^2.26.0",
 		"eslint-plugin-prettier": "^4.0.0",
-		"gen-esm-wrapper": "^1.1.3",
 		"prettier": "^2.4.1",
 		"rimraf": "^3.0.2",
-		"typescript": "^4.5.2"
+		"typescript": "^4.7.4"
 	},
 	"engines": {
 		"node": ">=14.x"

package/dist/client/EventManager.d.ts

@@ -1,86 +0,0 @@
-import { Clan, ClanWar, Player } from '../struct';
-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 _pollingEvents;
-    private _inMaintenance;
-    private _maintenanceStartTime;
-    constructor(pollingClient: PollingClient);
-    /** Initialize the PollingEvent Manager to start pulling the data by polling api. */
-    init(): Promise<string[]>;
-    /** Add clan tags to clan polling events. */
-    addClans(tags: string[] | string): this;
-    /** Delete clan tags from clan polling events. */
-    deleteClans(tags: string[] | string): this;
-    /** Add player tags for player polling events. */
-    addPlayers(tags: string[] | string): this;
-    /** Delete player tags from player polling events. */
-    deletePlayers(tags: string[] | string): this;
-    /** Add clan tags for war polling events. */
-    addWars(tags: string[] | string): this;
-    /** Delete clan tags from war polling events. */
-    deleteWars(tags: string[] | string): this;
-    /**
-     * Set your own custom clan polling event.
-     *
-     * In order to emit the custom polling event, you must have this filter function that returns a boolean.
-     *
-     * @example
-     * ```js
-     * client.pollingEvents.addClans(['#2PP', '#8QU8J9LP']);
-     *
-     * client.pollingEvents.setClanEvent({
-     *   name: 'clanMemberUpdate',
-     *   filter: (oldClan, newClan) => {
-     *     return oldClan.memberCount !== newClan.memberCount;
-     *   }
-     * });
-     *
-     * client.on('clanMemberUpdate', (oldClan, newClan) => {
-     *   console.log(oldClan.memberCount, newClan.memberCount);
-     * });
-     *
-     * (async function () {
-     *   await client.pollingEvents.init();
-     * })();
-     * ```
-     * @returns
-     */
-    setClanEvent(event: {
-        name: string;
-        filter: (oldClan: Clan, newClan: Clan) => boolean;
-    }): this;
-    /**
-     * Set your own custom war event.
-     *
-     * In order to emit the custom event, you must have this filter function that returns a boolean.
-     */
-    setWarEvent(event: {
-        name: string;
-        filter: (oldWar: ClanWar, newWar: ClanWar) => boolean;
-    }): this;
-    /**
-     * Set your own custom player event.
-     *
-     * In order to emit the custom event, you must have this filter function that returns a boolean.
-     */
-    setPlayerEvent(event: {
-        name: string;
-        filter: (oldPlayer: Player, newPlayer: Player) => boolean;
-    }): this;
-    private maintenanceHandler;
-    private seasonEndHandler;
-    private clanUpdateHandler;
-    private playerUpdateHandler;
-    private warUpdateHandler;
-    private runClanUpdate;
-    private runPlayerUpdate;
-    private runWarUpdate;
-}

package/dist/client/EventManager.js

@@ -1,278 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PollingEventManager = void 0;
-const HTTPError_1 = require("../rest/HTTPError");
-const Constants_1 = require("../util/Constants");
-const Util_1 = require("../util/Util");
-/** 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._pollingEvents = {
-            clans: [],
-            wars: [],
-            players: []
-        };
-        this._inMaintenance = Boolean(false);
-        this._maintenanceStartTime = null;
-    }
-    /** 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.pollingClient.eventNames());
-    }
-    /** Add clan tags to clan polling events. */
-    addClans(tags) {
-        for (const tag of Array.isArray(tags) ? tags : [tags]) {
-            this._clanTags.add(this.pollingClient.util.formatTag(tag));
-        }
-        return this;
-    }
-    /** Delete clan tags from clan polling events. */
-    deleteClans(tags) {
-        for (const tag of Array.isArray(tags) ? tags : [tags]) {
-            const key = this.pollingClient.util.formatTag(tag);
-            this._clans.delete(key);
-            this._clanTags.delete(key);
-        }
-        return this;
-    }
-    /** Add player tags for player polling events. */
-    addPlayers(tags) {
-        for (const tag of Array.isArray(tags) ? tags : [tags]) {
-            this._playerTags.add(this.pollingClient.util.formatTag(tag));
-        }
-        return this;
-    }
-    /** Delete player tags from player polling events. */
-    deletePlayers(tags) {
-        for (const tag of Array.isArray(tags) ? tags : [tags]) {
-            const key = this.pollingClient.util.formatTag(tag);
-            this._players.delete(key);
-            this._playerTags.delete(key);
-        }
-        return this;
-    }
-    /** Add clan tags for war polling events. */
-    addWars(tags) {
-        for (const tag of Array.isArray(tags) ? tags : [tags]) {
-            this._warTags.add(this.pollingClient.util.formatTag(tag));
-        }
-        return this;
-    }
-    /** Delete clan tags from war polling events. */
-    deleteWars(tags) {
-        for (const tag of Array.isArray(tags) ? tags : [tags]) {
-            const key = this.pollingClient.util.formatTag(tag);
-            this._wars.delete(`${key}:${1}`);
-            this._wars.delete(`${key}:${2}`);
-            this._warTags.delete(key);
-        }
-        return this;
-    }
-    /**
-     * Set your own custom clan polling event.
-     *
-     * In order to emit the custom polling event, you must have this filter function that returns a boolean.
-     *
-     * @example
-     * ```js
-     * client.pollingEvents.addClans(['#2PP', '#8QU8J9LP']);
-     *
-     * client.pollingEvents.setClanEvent({
-     *   name: 'clanMemberUpdate',
-     *   filter: (oldClan, newClan) => {
-     *     return oldClan.memberCount !== newClan.memberCount;
-     *   }
-     * });
-     *
-     * client.on('clanMemberUpdate', (oldClan, newClan) => {
-     *   console.log(oldClan.memberCount, newClan.memberCount);
-     * });
-     *
-     * (async function () {
-     *   await client.pollingEvents.init();
-     * })();
-     * ```
-     * @returns
-     */
-    setClanEvent(event) {
-        if (!event.name)
-            throw new Error('Event name is required.');
-        if (typeof event.filter !== 'function')
-            throw new Error('Filter function is required.');
-        this._pollingEvents.clans.push(event);
-        return this;
-    }
-    /**
-     * Set your own custom war event.
-     *
-     * In order to emit the custom event, you must have this filter function that returns a boolean.
-     */
-    setWarEvent(event) {
-        if (!event.name)
-            throw new Error('Event name is required.');
-        if (typeof event.filter !== 'function')
-            throw new Error('Filter function is required.');
-        this._pollingEvents.wars.push(event);
-        return this;
-    }
-    /**
-     * Set your own custom player event.
-     *
-     * In order to emit the custom event, you must have this filter function that returns a boolean.
-     */
-    setPlayerEvent(event) {
-        if (!event.name)
-            throw new Error('Event name is required.');
-        if (typeof event.filter !== 'function')
-            throw new Error('Filter function is required.');
-        this._pollingEvents.players.push(event);
-        return this;
-    }
-    async maintenanceHandler() {
-        setTimeout(this.maintenanceHandler.bind(this), 10000).unref();
-        try {
-            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.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.pollingClient.emit(Constants_1.PollingEvents.MaintenanceStart);
-            }
-        }
-    }
-    seasonEndHandler() {
-        const end = Util_1.Util.getSeasonEndTime().getTime() - Date.now();
-        // Why this? setTimeout can be up to 24.8 days or 2147483647ms [(2^31 - 1) Max 32bit Integer]
-        if (end > 24 * 60 * 60 * 1000) {
-            setTimeout(this.seasonEndHandler.bind(this), 60 * 60 * 1000);
-        }
-        else if (end > 0) {
-            setTimeout(() => {
-                this.pollingClient.emit(Constants_1.PollingEvents.NewSeasonStart, Util_1.Util.getSeasonId());
-            }, end + 100).unref();
-        }
-    }
-    async clanUpdateHandler() {
-        this.pollingClient.emit(Constants_1.PollingEvents.ClanLoopStart);
-        for (const tag of this._clanTags)
-            await this.runClanUpdate(tag);
-        this.pollingClient.emit(Constants_1.PollingEvents.ClanLoopEnd);
-        setTimeout(this.clanUpdateHandler.bind(this), 10000);
-    }
-    async playerUpdateHandler() {
-        this.pollingClient.emit(Constants_1.PollingEvents.PlayerLoopStart);
-        for (const tag of this._playerTags)
-            await this.runPlayerUpdate(tag);
-        this.pollingClient.emit(Constants_1.PollingEvents.PlayerLoopEnd);
-        setTimeout(this.playerUpdateHandler.bind(this), 10000);
-    }
-    async warUpdateHandler() {
-        this.pollingClient.emit(Constants_1.PollingEvents.WarLoopStart);
-        for (const tag of this._warTags)
-            await this.runWarUpdate(tag);
-        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.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._pollingEvents.clans) {
-            try {
-                if (!(await filter(cached, clan)))
-                    continue;
-                this.pollingClient.emit(name, cached, clan);
-            }
-            catch (error) {
-                this.pollingClient.emit(Constants_1.PollingEvents.Error, error);
-            }
-        }
-        return this._clans.set(clan.tag, clan);
-    }
-    async runPlayerUpdate(tag) {
-        if (this._inMaintenance)
-            return 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._pollingEvents.players) {
-            try {
-                if (!(await filter(cached, player)))
-                    continue;
-                this.pollingClient.emit(name, cached, player);
-            }
-            catch (error) {
-                this.pollingClient.emit(Constants_1.PollingEvents.Error, error);
-            }
-        }
-        return this._players.set(player.tag, player);
-    }
-    async runWarUpdate(tag) {
-        if (this._inMaintenance)
-            return null;
-        const clanWars = await this.pollingClient.getWars(tag).catch(() => null);
-        if (!clanWars?.length)
-            return null;
-        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, filter } of this._pollingEvents.wars) {
-                try {
-                    if (!(await filter(cached, war)))
-                        continue;
-                    this.pollingClient.emit(name, cached, war);
-                }
-                catch (error) {
-                    this.pollingClient.emit(Constants_1.PollingEvents.Error, error);
-                }
-            }
-            // check for war end
-            if (index === 1 && cached.warTag !== war.warTag) {
-                const data = await this.pollingClient.getLeagueWar({ clanTag: tag, round: 'PreviousRound' }).catch(() => null);
-                if (data && data.warTag === cached.warTag) {
-                    for (const { name, filter } of this._pollingEvents.wars) {
-                        try {
-                            if (!(await filter(cached, data)))
-                                continue;
-                            this.pollingClient.emit(name, cached, data);
-                        }
-                        catch (error) {
-                            this.pollingClient.emit(Constants_1.PollingEvents.Error, error);
-                        }
-                    }
-                }
-            }
-            return this._wars.set(key, war);
-        });
-    }
-}
-exports.PollingEventManager = PollingEventManager;