clashofclans.js 2.7.0 → 2.8.0-dev.41c401c

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

@@ -1,12 +1,12 @@
 import mod from "./index.js";
 
 export default mod;
-export const API_BASE_URL = mod.API_BASE_URL;
+export const APIBaseURL = mod.APIBaseURL;
 export const Achievement = mod.Achievement;
-export const BUILDER_TROOPS = mod.BUILDER_TROOPS;
 export const Badge = mod.Badge;
 export const BatchThrottler = mod.BatchThrottler;
-export const CWL_ROUNDS = mod.CWL_ROUNDS;
+export const BuilderTroops = mod.BuilderTroops;
+export const CWLRounds = mod.CWLRounds;
 export const CacheStore = mod.CacheStore;
 export const ChatLanguage = mod.ChatLanguage;
 export const Clan = mod.Clan;
@@ -20,47 +20,49 @@ export const ClanWarLeagueRound = mod.ClanWarLeagueRound;
 export const ClanWarLog = mod.ClanWarLog;
 export const ClanWarMember = mod.ClanWarMember;
 export const Client = mod.Client;
-export const DARK_ELIXIR_SPELLS = mod.DARK_ELIXIR_SPELLS;
-export const DARK_ELIXIR_TROOPS = mod.DARK_ELIXIR_TROOPS;
-export const DEV_SITE_API_BASE_URL = mod.DEV_SITE_API_BASE_URL;
-export const ELIXIR_SPELLS = mod.ELIXIR_SPELLS;
-export const ELIXIR_TROOPS = mod.ELIXIR_TROOPS;
-export const EVENTS = mod.EVENTS;
-export const EventManager = mod.EventManager;
-export const FRIENDLY_WAR_PREPARATION_TIMES = mod.FRIENDLY_WAR_PREPARATION_TIMES;
+export const DarkElixirSpells = mod.DarkElixirSpells;
+export const DarkElixirTroops = mod.DarkElixirTroops;
+export const DevSiteAPIBaseURL = mod.DevSiteAPIBaseURL;
+export const ElixirSpells = mod.ElixirSpells;
+export const ElixirTroops = mod.ElixirTroops;
+export const FriendlyWarPreparationTimes = mod.FriendlyWarPreparationTimes;
 export const GoldPassSeason = mod.GoldPassSeason;
-export const HEROES = mod.HEROES;
-export const HERO_PETS = mod.HERO_PETS;
-export const HOME_TROOPS = mod.HOME_TROOPS;
 export const HTTPError = mod.HTTPError;
 export const Hero = mod.Hero;
+export const HeroPets = mod.HeroPets;
+export const Heroes = mod.Heroes;
+export const HomeTroops = mod.HomeTroops;
 export const Icon = mod.Icon;
-export const LEAGUES = mod.LEAGUES;
-export const LEGEND_LEAGUE_ID = mod.LEGEND_LEAGUE_ID;
 export const Label = mod.Label;
 export const League = mod.League;
+export const Leagues = mod.Leagues;
+export const LegendLeagueId = mod.LegendLeagueId;
 export const LegendStatistics = mod.LegendStatistics;
 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;
 export const RankedClan = mod.RankedClan;
 export const RankedPlayer = mod.RankedPlayer;
+export const RawData = mod.RawData;
 export const RequestHandler = mod.RequestHandler;
-export const SIEGE_MACHINES = mod.SIEGE_MACHINES;
-export const SPELLS = mod.SPELLS;
-export const SUPER_TROOPS = mod.SUPER_TROOPS;
 export const Season = mod.Season;
 export const SeasonRankedPlayer = mod.SeasonRankedPlayer;
+export const SiegeMachines = mod.SiegeMachines;
 export const Spell = mod.Spell;
+export const Spells = mod.Spells;
+export const SuperTroops = mod.SuperTroops;
 export const Troop = mod.Troop;
-export const UNRANKED_LEAGUE_DATA = mod.UNRANKED_LEAGUE_DATA;
 export const Unit = mod.Unit;
+export const UnrankedLeagueData = mod.UnrankedLeagueData;
 export const Util = mod.Util;
-export const WAR_LEAGUES = mod.WAR_LEAGUES;
 export const WarClan = mod.WarClan;
 export const WarLeague = mod.WarLeague;
+export const WarLeagues = mod.WarLeagues;
 export const WarLogClan = mod.WarLogClan;

package/dist/rest/RESTManager.d.ts

@@ -4,7 +4,7 @@ import { APIClan, APIClanList, APIClanMemberList, APIClanRankingList, APIClanVer
 /** Represents a REST Manager of the client. */
 export declare class RESTManager {
     /** Request Handler for the RESTManager. */
-    readonly handler: RequestHandler;
+    handler: RequestHandler;
     constructor(options?: RESTOptions);
     /** Contains various general-purpose utility methods. */
     get util(): typeof Util;

package/dist/rest/RequestHandler.d.ts

@@ -1,4 +1,4 @@
-import { RESTOptions, Response, RequestOptions, LoginOptions } from '../types';
+import { Response, RequestOptions, LoginOptions, RequestHandlerOptions } from '../types';
 /** Represents a Request Handler. */
 export declare class RequestHandler {
     #private;
@@ -14,7 +14,7 @@ export declare class RequestHandler {
     private readonly restRequestTimeout;
     private readonly throttler?;
     private readonly cached;
-    constructor(options?: RESTOptions);
+    constructor(options?: RequestHandlerOptions);
     private get _keys();
     private get _key();
     setKeys(keys: string[]): this;

package/dist/rest/RequestHandler.js

@@ -30,7 +30,7 @@ class RequestHandler {
         this.keys = options?.keys ?? [];
         this.retryLimit = options?.retryLimit ?? 0;
         this.throttler = options?.throttler ?? null;
-        this.baseURL = options?.baseURL ?? Constants_1.API_BASE_URL;
+        this.baseURL = options?.baseURL ?? Constants_1.APIBaseURL;
         this.restRequestTimeout = options?.restRequestTimeout ?? 0;
         this.rejectIfNotValid = options?.rejectIfNotValid ?? true;
         if (typeof options?.cache === 'object')
@@ -54,19 +54,14 @@ class RequestHandler {
         return Boolean(this.email && this.password);
     }
     async request(path, options = {}) {
-        const cached = (await this.cached?.get(path)) ?? null;
+        const cached = this.cached ? (await this.cached.get(path)) ?? null : null;
         if (cached && options.force !== true) {
             return { data: cached.data, maxAge: cached.ttl - Date.now(), status: cached.status, path, ok: cached.status === 200 };
         }
         if (!this.throttler || options.ignoreRateLimit)
             return this.exec(path, options);
         await this.throttler.wait();
-        try {
-            return await this.exec(path, options);
-        }
-        finally {
-            await this.throttler.throttle();
-        }
+        return this.exec(path, options);
     }
     async exec(path, options = {}, retries = 0) {
         const res = await (0, node_fetch_1.default)(`${this.baseURL}${path}`, {
@@ -125,7 +120,7 @@ class RequestHandler {
         }
     }
     async login() {
-        const res = await (0, node_fetch_1.default)(`${Constants_1.DEV_SITE_API_BASE_URL}/login`, {
+        const res = await (0, node_fetch_1.default)(`${Constants_1.DevSiteAPIBaseURL}/login`, {
             method: 'POST',
             timeout: 10000,
             headers: { 'Content-Type': 'application/json' },
@@ -140,7 +135,7 @@ class RequestHandler {
         return this.getKeys(res.headers.get('set-cookie'), ip);
     }
     async getKeys(cookie, ip) {
-        const res = await (0, node_fetch_1.default)(`${Constants_1.DEV_SITE_API_BASE_URL}/apikey/list`, {
+        const res = await (0, node_fetch_1.default)(`${Constants_1.DevSiteAPIBaseURL}/apikey/list`, {
             method: 'POST',
             timeout: 10000,
             headers: { 'Content-Type': 'application/json', cookie }
@@ -182,7 +177,7 @@ class RequestHandler {
         return this.keys;
     }
     async revokeKey(keyId, cookie) {
-        const res = await (0, node_fetch_1.default)(`${Constants_1.DEV_SITE_API_BASE_URL}/apikey/revoke`, {
+        const res = await (0, node_fetch_1.default)(`${Constants_1.DevSiteAPIBaseURL}/apikey/revoke`, {
             method: 'POST',
             timeout: 10000,
             body: JSON.stringify({ id: keyId }),
@@ -191,7 +186,7 @@ class RequestHandler {
         return res.ok;
     }
     async createKey(cookie, ip) {
-        const res = await (0, node_fetch_1.default)(`${Constants_1.DEV_SITE_API_BASE_URL}/apikey/create`, {
+        const res = await (0, node_fetch_1.default)(`${Constants_1.DevSiteAPIBaseURL}/apikey/create`, {
             method: 'POST',
             timeout: 10000,
             headers: { 'Content-Type': 'application/json', cookie },

package/dist/rest/Throttler.d.ts

@@ -6,26 +6,24 @@
  * ```
  */
 export declare class QueueThrottler {
-    private lastRun?;
     private readonly sleepTime;
-    private readonly promises;
+    private readonly generator;
     constructor(sleepTime?: number);
-    get remaining(): number;
-    throttle(): Promise<void>;
-    wait(): Promise<void>;
-    private shift;
+    private init;
+    wait(): Promise<IteratorResult<undefined, void>>;
 }
 /**
  * Represents a throttler that allows x requests per second before sleeping until the next second.
  * ```js
- * const throttler = new BatchThrottler(30);
- * // 30 requests every second.
+ * const throttler = new BatchThrottler(15);
+ * // 15 requests every second.
  * ```
  */
 export declare class BatchThrottler {
-    #private;
     private readonly rateLimit;
-    constructor(rateLimit?: number);
-    wait(): Promise<void>;
-    throttle(): Promise<void>;
+    private readonly sleepTime;
+    private readonly generator;
+    constructor(rateLimit?: number, sleepTime?: number);
+    private init;
+    wait(): Promise<IteratorResult<undefined, void>>;
 }

package/dist/rest/Throttler.js

@@ -1,10 +1,4 @@
 "use strict";
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _BatchThrottler_taskLogs;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BatchThrottler = exports.QueueThrottler = void 0;
 const Util_1 = require("../util/Util");
@@ -17,70 +11,53 @@ const Util_1 = require("../util/Util");
  */
 class QueueThrottler {
     constructor(sleepTime = 100) {
-        this.promises = [];
+        this.generator = this.init();
         this.sleepTime = sleepTime;
     }
-    get remaining() {
-        return this.promises.length;
-    }
-    async throttle() {
-        if (this.lastRun) {
-            const difference = Date.now() - this.lastRun;
+    async *init() {
+        let lastRan = 0;
+        // eslint-disable-next-line
+        while (true) {
+            const difference = Date.now() - lastRan;
             const needToSleep = this.sleepTime - difference;
             if (needToSleep > 0)
                 await Util_1.Util.delay(needToSleep);
+            lastRan = Date.now();
+            yield;
         }
-        this.lastRun = Date.now();
-        return this.shift();
-    }
-    wait() {
-        const next = this.promises.length ? this.promises[this.promises.length - 1].promise : Promise.resolve();
-        let resolve;
-        const promise = new Promise((res) => {
-            resolve = res;
-        });
-        this.promises.push({ resolve: resolve, promise });
-        return next;
     }
-    shift() {
-        const deferred = this.promises.shift();
-        if (typeof deferred !== 'undefined')
-            deferred.resolve();
+    async wait() {
+        return this.generator.next();
     }
 }
 exports.QueueThrottler = QueueThrottler;
 /**
  * Represents a throttler that allows x requests per second before sleeping until the next second.
  * ```js
- * const throttler = new BatchThrottler(30);
- * // 30 requests every second.
+ * const throttler = new BatchThrottler(15);
+ * // 15 requests every second.
  * ```
  */
 class BatchThrottler {
-    constructor(rateLimit = 10) {
-        _BatchThrottler_taskLogs.set(this, []); // eslint-disable-line
+    constructor(rateLimit = 15, sleepTime = 1000) {
+        this.generator = this.init();
         this.rateLimit = rateLimit;
+        this.sleepTime = sleepTime;
     }
-    async wait() {
-        return Promise.resolve();
-    }
-    async throttle() {
-        while (true) { // eslint-disable-line
-            const now = Date.now();
-            while (__classPrivateFieldGet(this, _BatchThrottler_taskLogs, "f").length) {
-                if (now - __classPrivateFieldGet(this, _BatchThrottler_taskLogs, "f")[0] > 1000) {
-                    __classPrivateFieldGet(this, _BatchThrottler_taskLogs, "f").shift();
-                }
-                else {
-                    break;
-                }
+    async *init() {
+        let count = 0;
+        // eslint-disable-next-line
+        while (true) {
+            if (count++ >= this.rateLimit) {
+                if (this.sleepTime > 0)
+                    await Util_1.Util.delay(this.sleepTime);
+                count = 0;
             }
-            if (__classPrivateFieldGet(this, _BatchThrottler_taskLogs, "f").length < this.rateLimit)
-                break;
-            await Util_1.Util.delay(1000);
+            yield;
         }
-        __classPrivateFieldGet(this, _BatchThrottler_taskLogs, "f").push(Date.now());
+    }
+    async wait() {
+        return this.generator.next();
     }
 }
 exports.BatchThrottler = BatchThrottler;
-_BatchThrottler_taskLogs = new WeakMap();

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/ClanMember.js

@@ -12,7 +12,7 @@ class ClanMember {
         this.role = data.role.replace('admin', 'elder');
         this.expLevel = data.expLevel;
         // eslint-disable-next-line
-        this.league = new League_1.League(data.league ?? Constants_1.UNRANKED_LEAGUE_DATA);
+        this.league = new League_1.League(data.league ?? Constants_1.UnrankedLeagueData);
         this.trophies = data.trophies;
         this.versusTrophies = data.versusTrophies ?? null;
         this.clanRank = data.clanRank;

package/dist/struct/ClanWar.js

@@ -201,7 +201,7 @@ class ClanWar {
     /** Whether this is a friendly war. */
     get isFriendly() {
         const preparationTime = this.startTime.getTime() - this.preparationStartTime.getTime();
-        return Constants_1.FRIENDLY_WAR_PREPARATION_TIMES.includes(preparationTime);
+        return Constants_1.FriendlyWarPreparationTimes.includes(preparationTime);
     }
     /** Whether this is a CWL. */
     get isCWL() {

package/dist/struct/ClanWarLeagueGroup.d.ts

@@ -62,7 +62,8 @@ export declare class ClanWarLeagueGroup {
      * @param options Override options for the request.
      */
     getWars(clanTag?: string, options?: OverrideOptions): Promise<ClanWar[]>;
-    private _getCurrentWars;
+    /** Returns active wars (last 2) of the CWL group. */
+    getCurrentWars(clanTag: string, options?: OverrideOptions): Promise<ClanWar[]>;
     /** Returns the index of the round for this specified warTag. */
     getRoundIndex(warTag: string): number | null;
 }

package/dist/struct/ClanWarLeagueGroup.js

@@ -75,7 +75,8 @@ class ClanWarLeagueGroup {
             .map((res) => res.value)
             .filter((war) => (clanTag ? war.clan.tag === clanTag : true));
     }
-    async _getCurrentWars(clanTag, options) {
+    /** Returns active wars (last 2) of the CWL group. */
+    async getCurrentWars(clanTag, options) {
         const rounds = this.rounds.filter((round) => !round.warTags.includes('#0'));
         if (!rounds.length)
             return [];

package/dist/struct/League.js

@@ -12,7 +12,7 @@ class League {
     }
     /** Position of this League. Starting from 0 (Un-ranked) */
     get position() {
-        return Constants_1.LEAGUES.indexOf(this.id);
+        return Constants_1.Leagues.indexOf(this.id);
     }
 }
 exports.League = League;

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,11 +28,12 @@ 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;
         this.clan = data.clan ? new PlayerClan_1.PlayerClan(client, data.clan) : null;
-        this.league = new League_1.League(data.league ?? Constants_1.UNRANKED_LEAGUE_DATA);
+        this.league = new League_1.League(data.league ?? Constants_1.UnrankedLeagueData);
         this.legendStatistics = data.legendStatistics ? new LegendStatistics_1.LegendStatistics(data.legendStatistics) : null;
         this.achievements = data.achievements.map((data) => new Achievement_1.Achievement(data));
         this.labels = data.labels.map((data) => new Label_1.Label(data));
@@ -69,32 +70,32 @@ class Player {
     /** An array of the player's home base troops. */
     get homeTroops() {
         return this.troops
-            .filter((entry) => Constants_1.HOME_TROOPS.includes(entry.name))
-            .sort((a, b) => Constants_1.HOME_TROOPS.indexOf(a.name) - Constants_1.HOME_TROOPS.indexOf(b.name));
+            .filter((entry) => Constants_1.HomeTroops.includes(entry.name))
+            .sort((a, b) => Constants_1.HomeTroops.indexOf(a.name) - Constants_1.HomeTroops.indexOf(b.name));
     }
     /** An array of the player's builder base troops. */
     get builderTroops() {
         return this.troops
-            .filter((entry) => Constants_1.BUILDER_TROOPS.includes(entry.name))
-            .sort((a, b) => Constants_1.BUILDER_TROOPS.indexOf(a.name) - Constants_1.BUILDER_TROOPS.indexOf(b.name));
+            .filter((entry) => Constants_1.BuilderTroops.includes(entry.name))
+            .sort((a, b) => Constants_1.BuilderTroops.indexOf(a.name) - Constants_1.BuilderTroops.indexOf(b.name));
     }
     /** An array of the player's super troops. */
     get superTroops() {
         return this.troops
-            .filter((entry) => Constants_1.SUPER_TROOPS.includes(entry.name))
-            .sort((a, b) => Constants_1.SUPER_TROOPS.indexOf(a.name) - Constants_1.SUPER_TROOPS.indexOf(b.name));
+            .filter((entry) => Constants_1.SuperTroops.includes(entry.name))
+            .sort((a, b) => Constants_1.SuperTroops.indexOf(a.name) - Constants_1.SuperTroops.indexOf(b.name));
     }
     /** An array of the player's hero pets. */
     get heroPets() {
         return this.troops
-            .filter((entry) => Constants_1.HERO_PETS.includes(entry.name))
-            .sort((a, b) => Constants_1.HERO_PETS.indexOf(a.name) - Constants_1.HERO_PETS.indexOf(b.name));
+            .filter((entry) => Constants_1.HeroPets.includes(entry.name))
+            .sort((a, b) => Constants_1.HeroPets.indexOf(a.name) - Constants_1.HeroPets.indexOf(b.name));
     }
     /** An array of the player's siege machines. */
     get siegeMachines() {
         return this.troops
-            .filter((entry) => Constants_1.SIEGE_MACHINES.includes(entry.name))
-            .sort((a, b) => Constants_1.SIEGE_MACHINES.indexOf(a.name) - Constants_1.SIEGE_MACHINES.indexOf(b.name));
+            .filter((entry) => Constants_1.SiegeMachines.includes(entry.name))
+            .sort((a, b) => Constants_1.SiegeMachines.indexOf(a.name) - Constants_1.SiegeMachines.indexOf(b.name));
     }
     /** Get player's formatted link to open player in-game. */
     get shareLink() {

package/dist/struct/Ranking.js

@@ -46,7 +46,7 @@ class RankedPlayer {
         // @ts-expect-error
         this.clan = data.clan ? new PlayerClan_1.PlayerClan(client, data.clan) : null;
         // @ts-expect-error
-        this.league = data.trophies ? new League_1.League(data.league ?? Constants_1.UNRANKED_LEAGUE_DATA) : null; // eslint-disable-line
+        this.league = data.trophies ? new League_1.League(data.league ?? Constants_1.UnrankedLeagueData) : null; // eslint-disable-line
     }
     /** Get player's formatted link to open player in-game. */
     get shareLink() {