clashofclans.js 2.8.0-dev.f12c8df → 2.8.2

package/dist/client/Client.d.ts

@@ -74,8 +74,10 @@ export declare class Client extends EventEmitter {
         clanTag: string;
         round?: keyof typeof CWL_ROUNDS;
     }, options?: OverrideOptions): Promise<ClanWar | null>;
-    private _getCurrentLeagueWars;
-    private _getClanWars;
+    /** Returns active wars (last 2) of the CWL group. */
+    getLeagueWars(clanTag: string, options?: OverrideOptions): Promise<ClanWar[]>;
+    /** Returns active wars (last 2 for CWL) of the clan. */
+    getWars(clanTag: string, options?: OverrideOptions): Promise<ClanWar[]>;
     /** Get info about clan war league. */
     getClanWarLeagueGroup(clanTag: string, options?: OverrideOptions): Promise<ClanWarLeagueGroup>;
     /** Get info about a CWL round by WarTag. */

package/dist/client/Client.js

@@ -131,20 +131,23 @@ class Client extends events_1.EventEmitter {
         if (args.round && args.round in Constants_1.CWL_ROUNDS) {
             return wars.find((war) => war.clan.tag === args.clanTag && war.state === state) ?? null;
         }
-        return wars.find((war) => war.clan.tag === args.clanTag && war.state === state) ?? wars.at(0) ?? null;
+        return (wars.find((war) => war.clan.tag === args.clanTag && war.state === state) ??
+            wars.find((war) => war.clan.tag === args.clanTag) ??
+            null);
     }
-    async _getCurrentLeagueWars(clanTag, options) {
+    /** Returns active wars (last 2) of the CWL group. */
+    async getLeagueWars(clanTag, options) {
         const data = await this.getClanWarLeagueGroup(clanTag, options);
-        // @ts-expect-error
-        return data._getCurrentWars(clanTag, options);
+        return data.getCurrentWars(clanTag, options);
     }
-    async _getClanWars(clanTag, options) {
+    /** Returns active wars (last 2 for CWL) of the clan. */
+    async getWars(clanTag, options) {
         const date = new Date().getUTCDate();
         if (!(date >= 1 && date <= 10)) {
             return [await this.getClanWar(clanTag, options)];
         }
         try {
-            return this._getCurrentLeagueWars(clanTag, options);
+            return this.getLeagueWars(clanTag, options);
         }
         catch (e) {
             if (e instanceof HTTPError_1.HTTPError && [404].includes(e.status)) {

package/dist/client/EventManager.js

@@ -237,8 +237,7 @@ class EventManager {
     async runWarUpdate(tag) {
         if (this._inMaintenance)
             return null;
-        // @ts-expect-error
-        const clanWars = await this.client._getClanWars(tag).catch(() => null);
+        const clanWars = await this.client.getWars(tag).catch(() => null);
         if (!clanWars?.length)
             return null;
         clanWars.forEach(async (war, index) => {

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/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/Player.d.ts

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

package/dist/struct/Player.js

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

package/dist/types/api.d.ts

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

package/package.json

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