clashofclans.js 2.8.0-dev.73631cc → 2.8.0-dev.d94685e

package/dist/client/Client.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="node" />
 import { ClanSearchOptions, SearchOptions, ClientOptions, LoginOptions, OverrideOptions } from '../types';
-import { EVENTS, CWL_ROUNDS } from '../util/Constants';
+import { Events, CWLRounds } from '../util/Constants';
 import { RESTManager } from '../rest/RESTManager';
 import { EventManager } from './EventManager';
 import { EventEmitter } from 'events';
@@ -57,7 +57,7 @@ export declare class Client extends EventEmitter {
      */
     getCurrentWar(clanTag: string | {
         clanTag: string;
-        round?: keyof typeof CWL_ROUNDS;
+        round?: keyof typeof CWLRounds;
     }, options?: OverrideOptions): Promise<ClanWar | null>;
     /**
      * Get info about currently running CWL round.
@@ -72,7 +72,7 @@ export declare class Client extends EventEmitter {
      */
     getLeagueWar(clanTag: string | {
         clanTag: string;
-        round?: keyof typeof CWL_ROUNDS;
+        round?: keyof typeof CWLRounds;
     }, options?: OverrideOptions): Promise<ClanWar | null>;
     /** Returns active wars (last 2) of the CWL group. */
     getLeagueWars(clanTag: string, options?: OverrideOptions): Promise<ClanWar[]>;
@@ -178,17 +178,17 @@ export declare class Client extends EventEmitter {
     /** @internal */ emit<S extends string | symbol>(event: Exclude<S, keyof ClientEvents>, ...args: any[]): boolean;
 }
 interface ClientEvents {
-    [EVENTS.NEW_SEASON_START]: [id: string];
-    [EVENTS.MAINTENANCE_START]: [];
-    [EVENTS.MAINTENANCE_END]: [duration: number];
-    [EVENTS.CLAN_LOOP_START]: [];
-    [EVENTS.CLAN_LOOP_END]: [];
-    [EVENTS.PLAYER_LOOP_START]: [];
-    [EVENTS.PLAYER_LOOP_END]: [];
-    [EVENTS.WAR_LOOP_START]: [];
-    [EVENTS.WAR_LOOP_END]: [];
-    [EVENTS.ERROR]: [error: unknown];
-    [EVENTS.DEBUG]: [path: string, status: string, message: string];
+    [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];

package/dist/client/Client.js

@@ -116,7 +116,7 @@ class Client extends events_1.EventEmitter {
      */
     async getLeagueWar(clanTag, options) {
         const args = typeof clanTag === 'string' ? { clanTag } : { clanTag: clanTag.clanTag, round: clanTag.round };
-        const state = (args.round && Constants_1.CWL_ROUNDS[args.round]) ?? 'inWar'; // eslint-disable-line
+        const state = (args.round && Constants_1.CWLRounds[args.round]) ?? 'inWar'; // eslint-disable-line
         const data = await this.getClanWarLeagueGroup(args.clanTag, options);
         const rounds = data.rounds.filter((round) => !round.warTags.includes('#0'));
         if (!rounds.length)
@@ -128,7 +128,7 @@ class Client extends events_1.EventEmitter {
             .flat()
             .reverse();
         const wars = await this.util.allSettled(warTags.map((warTag) => this.getClanWarLeagueRound({ warTag, clanTag: args.clanTag }, { ...options, ignoreRateLimit: true })));
-        if (args.round && args.round in Constants_1.CWL_ROUNDS) {
+        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;
@@ -194,12 +194,12 @@ class Client extends events_1.EventEmitter {
     }
     /** Get Legend League season Ids. */
     async getLeagueSeasons(options) {
-        const { data } = await this.rest.getLeagueSeasons(Constants_1.LEGEND_LEAGUE_ID, options);
+        const { data } = await this.rest.getLeagueSeasons(Constants_1.LegendLeagueId, options);
         return data.items.map((league) => league.id);
     }
     /** Get Legend League season rankings by season Id. */
     async getSeasonRankings(seasonId, options) {
-        const { data } = await this.rest.getSeasonRankings(Constants_1.LEGEND_LEAGUE_ID, seasonId, options);
+        const { data } = await this.rest.getSeasonRankings(Constants_1.LegendLeagueId, seasonId, options);
         return data.items.map((entry) => new struct_1.SeasonRankedPlayer(this, entry));
     }
     /** Get list of Clan War Leagues. */

package/dist/client/EventManager.js

@@ -148,14 +148,14 @@ class EventManager {
                 this._inMaintenance = Boolean(false);
                 const duration = Date.now() - this._maintenanceStartTime.getTime();
                 this._maintenanceStartTime = null;
-                this.client.emit(Constants_1.EVENTS.MAINTENANCE_END, duration);
+                this.client.emit(Constants_1.Events.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.MAINTENANCE_START);
+                this.client.emit(Constants_1.Events.MaintenanceStart);
             }
         }
     }
@@ -167,29 +167,29 @@ class EventManager {
         }
         else if (end > 0) {
             setTimeout(() => {
-                this.client.emit(Constants_1.EVENTS.NEW_SEASON_START, Util_1.Util.getSeasonId());
+                this.client.emit(Constants_1.Events.NewSeasonStart, Util_1.Util.getSeasonId());
             }, end + 100).unref();
         }
     }
     async clanUpdateHandler() {
-        this.client.emit(Constants_1.EVENTS.CLAN_LOOP_START);
+        this.client.emit(Constants_1.Events.ClanLoopStart);
         for (const tag of this._clanTags)
             await this.runClanUpdate(tag);
-        this.client.emit(Constants_1.EVENTS.CLAN_LOOP_END);
+        this.client.emit(Constants_1.Events.ClanLoopEnd);
         setTimeout(this.clanUpdateHandler.bind(this), 10000);
     }
     async playerUpdateHandler() {
-        this.client.emit(Constants_1.EVENTS.PLAYER_LOOP_START);
+        this.client.emit(Constants_1.Events.PlayerLoopStart);
         for (const tag of this._playerTags)
             await this.runPlayerUpdate(tag);
-        this.client.emit(Constants_1.EVENTS.PLAYER_LOOP_END);
+        this.client.emit(Constants_1.Events.PlayerLoopEnd);
         setTimeout(this.playerUpdateHandler.bind(this), 10000);
     }
     async warUpdateHandler() {
-        this.client.emit(Constants_1.EVENTS.WAR_LOOP_START);
+        this.client.emit(Constants_1.Events.WarLoopStart);
         for (const tag of this._warTags)
             await this.runWarUpdate(tag);
-        this.client.emit(Constants_1.EVENTS.WAR_LOOP_END);
+        this.client.emit(Constants_1.Events.WarLoopEnd);
         setTimeout(this.warUpdateHandler.bind(this), 10000);
     }
     async runClanUpdate(tag) {
@@ -208,7 +208,7 @@ class EventManager {
                 this.client.emit(name, cached, clan);
             }
             catch (error) {
-                this.client.emit(Constants_1.EVENTS.ERROR, error);
+                this.client.emit(Constants_1.Events.Error, error);
             }
         }
         return this._clans.set(clan.tag, clan);
@@ -229,7 +229,7 @@ class EventManager {
                 this.client.emit(name, cached, player);
             }
             catch (error) {
-                this.client.emit(Constants_1.EVENTS.ERROR, error);
+                this.client.emit(Constants_1.Events.Error, error);
             }
         }
         return this._players.set(player.tag, player);
@@ -252,12 +252,12 @@ class EventManager {
                     this.client.emit(name, cached, war);
                 }
                 catch (error) {
-                    this.client.emit(Constants_1.EVENTS.ERROR, error);
+                    this.client.emit(Constants_1.Events.Error, error);
                 }
             }
             // check for war end
             if (index === 1 && cached.warTag !== war.warTag) {
-                const data = await this.client.getLeagueWar({ clanTag: tag, round: 'PREVIOUS_ROUND' }).catch(() => null);
+                const data = await this.client.getLeagueWar({ clanTag: tag, round: 'PreviousRound' }).catch(() => null);
                 if (data && data.warTag === cached.warTag) {
                     for (const { name, filter } of this._events.wars) {
                         try {
@@ -266,7 +266,7 @@ class EventManager {
                             this.client.emit(name, cached, data);
                         }
                         catch (error) {
-                            this.client.emit(Constants_1.EVENTS.ERROR, error);
+                            this.client.emit(Constants_1.Events.Error, error);
                         }
                     }
                 }

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,25 +20,25 @@ 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 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 EventManager = mod.EventManager;
-export const FRIENDLY_WAR_PREPARATION_TIMES = mod.FRIENDLY_WAR_PREPARATION_TIMES;
+export const Events = mod.Events;
+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;
@@ -46,22 +46,22 @@ export const Player = mod.Player;
 export const PlayerClan = mod.PlayerClan;
 export const PrivateWarLogError = mod.PrivateWarLogError;
 export const QueueThrottler = mod.QueueThrottler;
-export const RAW_DATA = mod.RAW_DATA;
 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/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')
@@ -120,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' },
@@ -135,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 }
@@ -177,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 }),
@@ -186,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/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/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() {

package/dist/struct/Unit.js

@@ -10,14 +10,14 @@ class Unit {
         this.level = unit.level;
         this.maxLevel = unit.maxLevel;
         this.village = unit.village;
-        const rawSuperUnit = Constants_1.RAW_DATA.RAW_SUPER_UNITS.find((unit) => unit.name === this.name && this.isHomeBase);
-        const rawUnit = Constants_1.RAW_DATA.RAW_UNITS.find((unit) => unit.name === this.name && unit.village === this.village);
+        const rawSuperUnit = Constants_1.RawData.RawSuperUnits.find((unit) => unit.name === this.name && this.isHomeBase);
+        const rawUnit = Constants_1.RawData.RawUnits.find((unit) => unit.name === this.name && unit.village === this.village);
         if (rawSuperUnit) {
             this.id = rawSuperUnit.id;
             this.housingSpace = rawSuperUnit.housingSpace;
             this.originalName = rawSuperUnit.original;
             this.minOriginalLevel = rawSuperUnit.minOriginalLevel;
-            const original = Constants_1.RAW_DATA.RAW_UNITS.find((unit) => unit.village === 'home' && unit.name === rawSuperUnit.original);
+            const original = Constants_1.RawData.RawUnits.find((unit) => unit.village === 'home' && unit.name === rawSuperUnit.original);
             this.unlockHallLevel = original.levels.findIndex((level) => level >= rawSuperUnit.minOriginalLevel) + 1;
             this.unlockCost = original.unlock.cost;
             this.unlockTime = original.unlock.time;
@@ -87,7 +87,7 @@ class Troop extends Unit {
     }
     /** Whether this troop is a Super Troop. */
     get isSuperTroop() {
-        return this.isActive || (this.isHomeBase && Constants_1.SUPER_TROOPS.includes(this.name));
+        return this.isActive || (this.isHomeBase && Constants_1.SuperTroops.includes(this.name));
     }
 }
 exports.Troop = Troop;

package/dist/struct/WarLeague.js

@@ -10,7 +10,7 @@ class WarLeague {
     }
     /** Position of this War League. Starting from 0 (Unranked) */
     get position() {
-        return Constants_1.WAR_LEAGUES.indexOf(this.id);
+        return Constants_1.WarLeagues.indexOf(this.id);
     }
 }
 exports.WarLeague = WarLeague;

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

@@ -1,17 +1,17 @@
-export declare const API_BASE_URL = "https://api.clashofclans.com/v1";
-export declare const DEV_SITE_API_BASE_URL = "https://developer.clashofclans.com/api";
-export declare const ELIXIR_TROOPS: string[];
-export declare const DARK_ELIXIR_TROOPS: string[];
-export declare const HOME_TROOPS: string[];
-export declare const SIEGE_MACHINES: string[];
-export declare const SUPER_TROOPS: string[];
-export declare const ELIXIR_SPELLS: string[];
-export declare const DARK_ELIXIR_SPELLS: string[];
-export declare const SPELLS: string[];
-export declare const BUILDER_TROOPS: string[];
-export declare const HEROES: string[];
-export declare const HERO_PETS: string[];
-export declare const UNRANKED_LEAGUE_DATA: {
+export declare const APIBaseURL = "https://api.clashofclans.com/v1";
+export declare const DevSiteAPIBaseURL = "https://developer.clashofclans.com/api";
+export declare const ElixirTroops: string[];
+export declare const DarkElixirTroops: string[];
+export declare const HomeTroops: string[];
+export declare const SiegeMachines: string[];
+export declare const SuperTroops: string[];
+export declare const ElixirSpells: string[];
+export declare const DarkElixirSpells: string[];
+export declare const Spells: string[];
+export declare const BuilderTroops: string[];
+export declare const Heroes: string[];
+export declare const HeroPets: string[];
+export declare const UnrankedLeagueData: {
     id: number;
     name: string;
     iconUrls: {
@@ -19,30 +19,30 @@ export declare const UNRANKED_LEAGUE_DATA: {
         tiny: string;
     };
 };
-export declare const LEGEND_LEAGUE_ID = 29000022;
-export declare const LEAGUES: number[];
-export declare const WAR_LEAGUES: number[];
-export declare const FRIENDLY_WAR_PREPARATION_TIMES: readonly [number, number, number, number, number, number, number, number, number, number, number, number];
-export declare const EVENTS: {
-    readonly NEW_SEASON_START: "newSeasonStart";
-    readonly CLAN_LOOP_START: "clanLoopStart";
-    readonly CLAN_LOOP_END: "clanLoopEnd";
-    readonly PLAYER_LOOP_START: "playerLoopStart";
-    readonly PLAYER_LOOP_END: "playerLoopEnd";
-    readonly WAR_LOOP_START: "warLoopEnd";
-    readonly WAR_LOOP_END: "warLoopEnd";
-    readonly MAINTENANCE_START: "maintenanceStart";
-    readonly MAINTENANCE_END: "maintenanceEnd";
-    readonly ERROR: "error";
-    readonly DEBUG: "debug";
+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: {
+    readonly NewSeasonStart: "newSeasonStart";
+    readonly ClanLoopStart: "clanLoopStart";
+    readonly ClanLoopEnd: "clanLoopEnd";
+    readonly PlayerLoopStart: "playerLoopStart";
+    readonly PlayerLoopEnd: "playerLoopEnd";
+    readonly WarLoopStart: "warLoopEnd";
+    readonly WarLoopEnd: "warLoopEnd";
+    readonly MaintenanceStart: "maintenanceStart";
+    readonly MaintenanceEnd: "maintenanceEnd";
+    readonly Error: "error";
+    readonly Debug: "debug";
 };
-export declare const CWL_ROUNDS: {
-    readonly PREVIOUS_ROUND: "warEnded";
-    readonly CURRENT_ROUND: "inWar";
-    readonly NEXT_ROUND: "preparation";
+export declare const CWLRounds: {
+    readonly PreviousRound: "warEnded";
+    readonly CurrentRound: "inWar";
+    readonly NextRound: "preparation";
 };
-export declare const RAW_DATA: {
-    RAW_UNITS: {
+export declare const RawData: {
+    RawUnits: {
         id: number;
         name: string;
         housingSpace: number;
@@ -69,7 +69,7 @@ export declare const RAW_DATA: {
         seasonal: boolean;
         levels: number[];
     }[];
-    RAW_SUPER_UNITS: {
+    RawSuperUnits: {
         name: string;
         id: number;
         original: string;

package/dist/util/Constants.js

@@ -3,11 +3,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RAW_DATA = exports.CWL_ROUNDS = exports.EVENTS = exports.FRIENDLY_WAR_PREPARATION_TIMES = exports.WAR_LEAGUES = exports.LEAGUES = exports.LEGEND_LEAGUE_ID = exports.UNRANKED_LEAGUE_DATA = exports.HERO_PETS = exports.HEROES = exports.BUILDER_TROOPS = exports.SPELLS = exports.DARK_ELIXIR_SPELLS = exports.ELIXIR_SPELLS = exports.SUPER_TROOPS = exports.SIEGE_MACHINES = exports.HOME_TROOPS = exports.DARK_ELIXIR_TROOPS = exports.ELIXIR_TROOPS = exports.DEV_SITE_API_BASE_URL = exports.API_BASE_URL = void 0;
+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;
 const raw_json_1 = __importDefault(require("../util/raw.json"));
-exports.API_BASE_URL = 'https://api.clashofclans.com/v1';
-exports.DEV_SITE_API_BASE_URL = 'https://developer.clashofclans.com/api';
-exports.ELIXIR_TROOPS = [
+exports.APIBaseURL = 'https://api.clashofclans.com/v1';
+exports.DevSiteAPIBaseURL = 'https://developer.clashofclans.com/api';
+exports.ElixirTroops = [
     'Barbarian',
     'Archer',
     'Giant',
@@ -24,10 +24,10 @@ exports.ELIXIR_TROOPS = [
     'Yeti',
     'Dragon Rider'
 ];
-exports.DARK_ELIXIR_TROOPS = ['Minion', 'Hog Rider', 'Valkyrie', 'Golem', 'Witch', 'Lava Hound', 'Bowler', 'Ice Golem', 'Headhunter'];
-exports.HOME_TROOPS = [...exports.ELIXIR_TROOPS, ...exports.DARK_ELIXIR_TROOPS];
-exports.SIEGE_MACHINES = ['Wall Wrecker', 'Battle Blimp', 'Stone Slammer', 'Siege Barracks', 'Log Launcher', 'Flame Flinger'];
-exports.SUPER_TROOPS = [
+exports.DarkElixirTroops = ['Minion', 'Hog Rider', 'Valkyrie', 'Golem', 'Witch', 'Lava Hound', 'Bowler', 'Ice Golem', 'Headhunter'];
+exports.HomeTroops = [...exports.ElixirTroops, ...exports.DarkElixirTroops];
+exports.SiegeMachines = ['Wall Wrecker', 'Battle Blimp', 'Stone Slammer', 'Siege Barracks', 'Log Launcher', 'Flame Flinger'];
+exports.SuperTroops = [
     'Super Barbarian',
     'Super Archer',
     'Super Giant',
@@ -43,7 +43,7 @@ exports.SUPER_TROOPS = [
     'Ice Hound',
     'Super Bowler'
 ];
-exports.ELIXIR_SPELLS = [
+exports.ElixirSpells = [
     'Lightning Spell',
     'Healing Spell',
     'Rage Spell',
@@ -52,9 +52,9 @@ exports.ELIXIR_SPELLS = [
     'Clone Spell',
     'Invisibility Spell'
 ];
-exports.DARK_ELIXIR_SPELLS = ['Poison Spell', 'Earthquake Spell', 'Haste Spell', 'Skeleton Spell', 'Bat Spell'];
-exports.SPELLS = [...exports.ELIXIR_SPELLS, ...exports.DARK_ELIXIR_SPELLS];
-exports.BUILDER_TROOPS = [
+exports.DarkElixirSpells = ['Poison Spell', 'Earthquake Spell', 'Haste Spell', 'Skeleton Spell', 'Bat Spell'];
+exports.Spells = [...exports.ElixirSpells, ...exports.DarkElixirSpells];
+exports.BuilderTroops = [
     'Raged Barbarian',
     'Sneaky Archer',
     'Boxer Giant',
@@ -67,9 +67,9 @@ exports.BUILDER_TROOPS = [
     'Super P.E.K.K.A',
     'Hog Glider'
 ];
-exports.HEROES = ['Barbarian King', 'Archer Queen', 'Grand Warden', 'Royal Champion', 'Battle Machine'];
-exports.HERO_PETS = ['L.A.S.S.I', 'Electro Owl', 'Mighty Yak', 'Unicorn'];
-exports.UNRANKED_LEAGUE_DATA = {
+exports.Heroes = ['Barbarian King', 'Archer Queen', 'Grand Warden', 'Royal Champion', 'Battle Machine'];
+exports.HeroPets = ['L.A.S.S.I', 'Electro Owl', 'Mighty Yak', 'Unicorn'];
+exports.UnrankedLeagueData = {
     id: 29000000,
     name: 'Unranked',
     iconUrls: {
@@ -77,8 +77,8 @@ exports.UNRANKED_LEAGUE_DATA = {
         tiny: 'https://api-assets.clashofclans.com/leagues/36/e--YMyIexEQQhE4imLoJcwhYn6Uy8KqlgyY3_kFV6t4.png'
     }
 };
-exports.LEGEND_LEAGUE_ID = 29000022;
-exports.LEAGUES = [
+exports.LegendLeagueId = 29000022;
+exports.Leagues = [
     29000000,
     29000001,
     29000002,
@@ -101,13 +101,13 @@ exports.LEAGUES = [
     29000019,
     29000020,
     29000021,
-    exports.LEGEND_LEAGUE_ID
+    exports.LegendLeagueId
 ];
-exports.WAR_LEAGUES = [
+exports.WarLeagues = [
     48000000, 48000001, 48000002, 48000003, 48000004, 48000005, 48000006, 48000007, 48000008, 48000009, 48000010, 48000011, 48000012,
     48000013, 48000014, 48000015, 48000016, 48000017, 48000018
 ];
-exports.FRIENDLY_WAR_PREPARATION_TIMES = [
+exports.FriendlyWarPreparationTimes = [
     1000 * 60 * 60 * 24,
     1000 * 60 * 60 * 20,
     1000 * 60 * 60 * 16,
@@ -121,25 +121,25 @@ exports.FRIENDLY_WAR_PREPARATION_TIMES = [
     1000 * 60 * 15,
     1000 * 60 * 5
 ];
-exports.EVENTS = {
-    NEW_SEASON_START: 'newSeasonStart',
-    CLAN_LOOP_START: 'clanLoopStart',
-    CLAN_LOOP_END: 'clanLoopEnd',
-    PLAYER_LOOP_START: 'playerLoopStart',
-    PLAYER_LOOP_END: 'playerLoopEnd',
-    WAR_LOOP_START: 'warLoopEnd',
-    WAR_LOOP_END: 'warLoopEnd',
-    MAINTENANCE_START: 'maintenanceStart',
-    MAINTENANCE_END: 'maintenanceEnd',
-    ERROR: 'error',
-    DEBUG: 'debug'
+exports.Events = {
+    NewSeasonStart: 'newSeasonStart',
+    ClanLoopStart: 'clanLoopStart',
+    ClanLoopEnd: 'clanLoopEnd',
+    PlayerLoopStart: 'playerLoopStart',
+    PlayerLoopEnd: 'playerLoopEnd',
+    WarLoopStart: 'warLoopEnd',
+    WarLoopEnd: 'warLoopEnd',
+    MaintenanceStart: 'maintenanceStart',
+    MaintenanceEnd: 'maintenanceEnd',
+    Error: 'error',
+    Debug: 'debug'
 };
-exports.CWL_ROUNDS = {
-    PREVIOUS_ROUND: 'warEnded',
-    CURRENT_ROUND: 'inWar',
-    NEXT_ROUND: 'preparation'
+exports.CWLRounds = {
+    PreviousRound: 'warEnded',
+    CurrentRound: 'inWar',
+    NextRound: 'preparation'
 };
-exports.RAW_DATA = {
-    RAW_UNITS: raw_json_1.default.RAW_UNITS,
-    RAW_SUPER_UNITS: raw_json_1.default.RAW_SUPER_UNITS
+exports.RawData = {
+    RawUnits: raw_json_1.default.RAW_UNITS,
+    RawSuperUnits: raw_json_1.default.RAW_SUPER_UNITS
 };

package/dist/util/Util.js

@@ -132,11 +132,11 @@ class Util extends null {
         }));
         return {
             units: units.map((unit) => {
-                const _unit = Constants_1.RAW_DATA.RAW_UNITS.find((raw) => raw.category === 'troop' && raw.id === unit.id);
+                const _unit = Constants_1.RawData.RawUnits.find((raw) => raw.category === 'troop' && raw.id === unit.id);
                 return { name: _unit?.name ?? null, count: unit.total, id: unit.id };
             }),
             spells: spells.map((spell) => {
-                const _spell = Constants_1.RAW_DATA.RAW_UNITS.find((raw) => raw.category === 'spell' && raw.id === spell.id);
+                const _spell = Constants_1.RawData.RawUnits.find((raw) => raw.category === 'spell' && raw.id === spell.id);
                 return { name: _spell?.name ?? null, count: spell.total, id: spell.id };
             })
         };

package/package.json

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