clashofclans.js 3.0.0-dev.f6ce42f → 3.0.1-dev.e71b7fa

package/dist/rest/HTTPError.d.ts

@@ -19,10 +19,6 @@ export declare class HTTPError extends Error {
     maxAge: number;
     constructor(error: any, status: number, path: string, maxAge: number, method?: string);
 }
-export declare const NotInWarError: {
-    message: string;
-    reason: string;
-};
 export declare const PrivateWarLogError: {
     message: string;
     reason: string;

package/dist/rest/HTTPError.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PrivateWarLogError = exports.NotInWarError = exports.HTTPError = void 0;
+exports.PrivateWarLogError = exports.HTTPError = void 0;
 const messages = {
     500: 'Unknown error happened when handling the request.',
     504: 'The user aborted this request.',
@@ -32,10 +32,6 @@ class HTTPError extends Error {
     }
 }
 exports.HTTPError = HTTPError;
-exports.NotInWarError = {
-    message: 'Clan is not in war at this moment.',
-    reason: 'notInWar'
-};
 exports.PrivateWarLogError = {
     message: 'Access denied, clan war log is private.',
     reason: 'privateWarLog'

package/dist/rest/RESTManager.d.ts

@@ -1,10 +1,43 @@
+/// <reference types="node" />
+import { EventEmitter } from 'node:events';
 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 { APIClan, APIClanList, APIClanMemberList, APICapitalRaidSeasons, APIClanRankingList, APIClanVersusRankingList, APIClanWar, APIClanWarLeagueGroup, APIClanWarLog, APIGoldPassSeason, APILabelList, APILeague, APILeagueList, APILeagueSeasonList, APILocation, APILocationList, APIPlayer, APIPlayerRankingList, APIPlayerSeasonRankingList, APIPlayerVersusRankingList, APIVerifyToken, APIWarLeague, APIWarLeagueList, SearchOptions, ClanSearchOptions, RESTOptions, OverrideOptions, LoginOptions, APICapitalLeagueList, APICapitalLeague, APIClanCapitalRankingList } from '../types';
+import { RestEvents } from '../util/Constants';
 import { RequestHandler } from './RequestHandler';
+export interface IRestEvents {
+    [RestEvents.Error]: [error: unknown];
+    [RestEvents.Debug]: [path: string, status: number, message: string];
+    [RestEvents.RateLimited]: [path: string, status: number, message: string];
+}
+export interface RESTManager {
+    emit: (<K extends keyof IRestEvents>(event: K, ...args: IRestEvents[K]) => boolean) & (<S extends string | symbol>(event: Exclude<S, keyof IRestEvents>, ...args: any[]) => boolean);
+    off: (<K extends keyof IRestEvents>(event: K, listener: (...args: IRestEvents[K]) => void) => this) & (<S extends string | symbol>(event: Exclude<S, keyof IRestEvents>, listener: (...args: any[]) => void) => this);
+    on: (<K extends keyof IRestEvents>(event: K, listener: (...args: IRestEvents[K]) => void) => this) & (<S extends string | symbol>(event: Exclude<S, keyof IRestEvents>, listener: (...args: any[]) => void) => this);
+    once: (<K extends keyof IRestEvents>(event: K, listener: (...args: IRestEvents[K]) => void) => this) & (<S extends string | symbol>(event: Exclude<S, keyof IRestEvents>, listener: (...args: any[]) => void) => this);
+    removeAllListeners: (<K extends keyof IRestEvents>(event?: K) => this) & (<S extends string | symbol>(event?: Exclude<S, keyof IRestEvents>) => this);
+    /**
+     * Emitted for general debugging information.
+     * @public
+     * @event
+     */
+    debug: string;
+    /**
+     * Emitted when the client encounters an error.
+     * @public
+     * @event
+     */
+    error: string;
+    /**
+     * Emitted when the client is rate limited.
+     * @public
+     * @event
+     */
+    rateLimited: string;
+}
 /** Represents a REST Manager of the client. */
-export declare class RESTManager {
+export declare class RESTManager extends EventEmitter {
     /** Request Handler for the RESTManager. */
-    handler: RequestHandler;
+    requestHandler: RequestHandler;
     constructor(options?: RESTOptions);
     /** Contains various general-purpose utility methods. */
     get util(): typeof Util;
@@ -33,14 +66,20 @@ export declare class RESTManager {
     getClanWarLeagueGroup(clanTag: string, options?: OverrideOptions): Promise<import("../types").Response<APIClanWarLeagueGroup>>;
     /** Get info about a CWL round by WarTag. */
     getClanWarLeagueRound(warTag: string, options?: OverrideOptions): Promise<import("../types").Response<APIClanWar>>;
+    /** Retrieve clan's capital raid seasons. */
+    getCapitalRaidSeasons(tag: string, options?: OverrideOptions): Promise<import("../types").Response<APICapitalRaidSeasons>>;
     /** Get info about a player by tag. */
     getPlayer(playerTag: string, options?: OverrideOptions): Promise<import("../types").Response<APIPlayer>>;
     /** Verify Player API token that can be found from the Game settings. */
     verifyPlayerToken(playerTag: string, token: string, options?: OverrideOptions): Promise<import("../types").Response<APIVerifyToken>>;
-    /** Get list of Leagues. */
+    /** Get a list of Leagues. */
     getLeagues(options?: SearchOptions): Promise<import("../types").Response<APILeagueList>>;
     /** Get a League info. */
     getLeague(leagueId: string | number, options?: OverrideOptions): Promise<import("../types").Response<APILeague>>;
+    /** Get a list of Capital leagues. */
+    getCapitalLeagues(options?: SearchOptions): Promise<import("../types").Response<APICapitalLeagueList>>;
+    /** Get a Capital League info. */
+    getCapitalLeague(leagueId: string | number, options?: OverrideOptions): Promise<import("../types").Response<APICapitalLeague>>;
     /** Get Legend League season Ids. */
     getLeagueSeasons(leagueId: number, options?: SearchOptions): Promise<import("../types").Response<APILeagueSeasonList>>;
     /** Get Legend League season rankings by season Id. */
@@ -61,6 +100,8 @@ export declare class RESTManager {
     getVersusClanRanks(locationId: number | string, options?: SearchOptions): Promise<import("../types").Response<APIClanVersusRankingList>>;
     /** Get player versus rankings for a specific location. */
     getVersusPlayerRanks(locationId: number | string, options?: SearchOptions): Promise<import("../types").Response<APIPlayerVersusRankingList>>;
+    /** Get clan capital rankings for a specific location. */
+    getClanCapitalRanks(locationId: number | string, options?: SearchOptions): Promise<import("../types").Response<APIClanCapitalRankingList>>;
     /** Get list of clan labels. */
     getClanLabels(options?: SearchOptions): Promise<import("../types").Response<APILabelList>>;
     /** Get list of player labels. */

package/dist/rest/RESTManager.js

@@ -1,12 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RESTManager = void 0;
+const node_events_1 = require("node:events");
 const Util_1 = require("../util/Util");
+const Constants_1 = require("../util/Constants");
 const RequestHandler_1 = require("./RequestHandler");
 /** Represents a REST Manager of the client. */
-class RESTManager {
+class RESTManager extends node_events_1.EventEmitter {
     constructor(options) {
-        this.handler = new RequestHandler_1.RequestHandler(options);
+        super();
+        this.requestHandler = new RequestHandler_1.RequestHandler(options)
+            .on(Constants_1.RestEvents.Debug, this.emit.bind(this, Constants_1.RestEvents.Debug))
+            .on(Constants_1.RestEvents.Error, this.emit.bind(this, Constants_1.RestEvents.Error))
+            .on(Constants_1.RestEvents.RateLimited, this.emit.bind(this, Constants_1.RestEvents.RateLimited));
     }
     /** Contains various general-purpose utility methods. */
     get util() {
@@ -21,122 +27,141 @@ class RESTManager {
      * ```
      */
     login(options) {
-        return this.handler.init(options);
+        return this.requestHandler.init(options);
     }
     /** Set Clash of Clans API keys. */
     setKeys(keys) {
-        this.handler.setKeys(keys);
+        this.requestHandler.setKeys(keys);
         return this;
     }
     /** Search all clans by name and/or filtering the results using various criteria. */
     getClans(query, options) {
-        return this.handler.request(`/clans${Util_1.Util.queryString(query)}`, options);
+        return this.requestHandler.request(`/clans${Util_1.Util.queryString(query)}`, options);
     }
     /** Get info about a clan. */
     getClan(clanTag, options) {
-        return this.handler.request(`/clans/${Util_1.Util.encodeURI(clanTag)}`, options);
+        return this.requestHandler.request(`/clans/${Util_1.Util.encodeURI(clanTag)}`, options);
     }
     /** Get list of clan members. */
     getClanMembers(clanTag, options) {
         const query = Util_1.Util.queryString(options);
-        return this.handler.request(`/clans/${Util_1.Util.encodeURI(clanTag)}/members${query}`, options);
+        return this.requestHandler.request(`/clans/${Util_1.Util.encodeURI(clanTag)}/members${query}`, options);
     }
     /** Get clan war log. */
     getClanWarLog(clanTag, options) {
         const query = Util_1.Util.queryString(options);
-        return this.handler.request(`/clans/${Util_1.Util.encodeURI(clanTag)}/warlog${query}`, options);
+        return this.requestHandler.request(`/clans/${Util_1.Util.encodeURI(clanTag)}/warlog${query}`, options);
     }
     /** Get info about currently running war in the clan. */
     getCurrentWar(clanTag, options) {
-        return this.handler.request(`/clans/${Util_1.Util.encodeURI(clanTag)}/currentwar`, options);
+        return this.requestHandler.request(`/clans/${Util_1.Util.encodeURI(clanTag)}/currentwar`, options);
     }
     /** Get info about clan war league. */
     getClanWarLeagueGroup(clanTag, options) {
-        return this.handler.request(`/clans/${Util_1.Util.encodeURI(clanTag)}/currentwar/leaguegroup`, options);
+        return this.requestHandler.request(`/clans/${Util_1.Util.encodeURI(clanTag)}/currentwar/leaguegroup`, options);
     }
     /** Get info about a CWL round by WarTag. */
     getClanWarLeagueRound(warTag, options) {
-        return this.handler.request(`/clanwarleagues/wars/${Util_1.Util.encodeURI(warTag)}`, options);
+        return this.requestHandler.request(`/clanwarleagues/wars/${Util_1.Util.encodeURI(warTag)}`, options);
+    }
+    /** Retrieve clan's capital raid seasons. */
+    getCapitalRaidSeasons(tag, options) {
+        const query = Util_1.Util.queryString(options);
+        return this.requestHandler.request(`/clans/${Util_1.Util.encodeURI(tag)}/capitalraidseasons${query}`, options);
     }
     /** Get info about a player by tag. */
     getPlayer(playerTag, options) {
-        return this.handler.request(`/players/${Util_1.Util.encodeURI(playerTag)}`, options);
+        return this.requestHandler.request(`/players/${Util_1.Util.encodeURI(playerTag)}`, options);
     }
     /** Verify Player API token that can be found from the Game settings. */
     verifyPlayerToken(playerTag, token, options) {
         const opts = { method: 'POST', body: JSON.stringify({ token }), ...options };
-        return this.handler.request(`/players/${Util_1.Util.encodeURI(playerTag)}/verifytoken`, opts);
+        return this.requestHandler.request(`/players/${Util_1.Util.encodeURI(playerTag)}/verifytoken`, opts);
     }
-    /** Get list of Leagues. */
+    /** Get a list of Leagues. */
     getLeagues(options) {
         const query = Util_1.Util.queryString(options);
-        return this.handler.request(`/leagues${query}`, options);
+        return this.requestHandler.request(`/leagues${query}`, options);
     }
     /** Get a League info. */
     getLeague(leagueId, options) {
-        return this.handler.request(`/leagues/${leagueId}`, options);
+        return this.requestHandler.request(`/leagues/${leagueId}`, options);
+    }
+    /** Get a list of Capital leagues. */
+    getCapitalLeagues(options) {
+        const query = Util_1.Util.queryString(options);
+        return this.requestHandler.request(`/capitalleagues${query}`, options);
+    }
+    /** Get a Capital League info. */
+    getCapitalLeague(leagueId, options) {
+        return this.requestHandler.request(`/capitalleagues/${leagueId}`, options);
     }
     /** Get Legend League season Ids. */
     getLeagueSeasons(leagueId, options) {
         const query = Util_1.Util.queryString(options);
-        return this.handler.request(`/leagues/${leagueId}/seasons${query}`, options);
+        return this.requestHandler.request(`/leagues/${leagueId}/seasons${query}`, options);
     }
     /** Get Legend League season rankings by season Id. */
     getSeasonRankings(leagueId, seasonId, options) {
         const query = Util_1.Util.queryString(options);
-        return this.handler.request(`/leagues/${leagueId}/seasons/${seasonId}${query}`, options);
+        return this.requestHandler.request(`/leagues/${leagueId}/seasons/${seasonId}${query}`, options);
     }
     /** Get list of Clan War Leagues. */
     getWarLeagues(options) {
         const query = Util_1.Util.queryString(options);
-        return this.handler.request(`/warleagues${query}`, options);
+        return this.requestHandler.request(`/warleagues${query}`, options);
     }
     /** Get info about a Clan War League. */
     getWarLeague(leagueId, options) {
-        return this.handler.request(`/warleagues/${leagueId}`, options);
+        return this.requestHandler.request(`/warleagues/${leagueId}`, options);
     }
     /** Get list of Locations. */
     getLocations(options) {
         const query = Util_1.Util.queryString(options);
-        return this.handler.request(`/locations${query}`, options);
+        return this.requestHandler.request(`/locations${query}`, options);
     }
     /** Get info about a Location. */
     getLocation(locationId, options) {
-        return this.handler.request(`/locations/${locationId}`, options);
+        return this.requestHandler.request(`/locations/${locationId}`, options);
     }
     /** Get clan rankings for a specific location. */
     getClanRanks(locationId, options) {
         const query = Util_1.Util.queryString(options);
-        return this.handler.request(`/locations/${locationId}/rankings/clans${query}`, options);
+        return this.requestHandler.request(`/locations/${locationId}/rankings/clans${query}`, options);
     }
     /** Get player rankings for a specific location. */
     getPlayerRanks(locationId, options) {
         const query = Util_1.Util.queryString(options);
-        return this.handler.request(`/locations/${locationId}/rankings/players${query}`, options);
+        return this.requestHandler.request(`/locations/${locationId}/rankings/players${query}`, options);
     }
     /** Get clan versus rankings for a specific location. */
     getVersusClanRanks(locationId, options) {
         const query = Util_1.Util.queryString(options);
-        return this.handler.request(`/locations/${locationId}/rankings/clans-versus${query}`, options);
+        return this.requestHandler.request(`/locations/${locationId}/rankings/clans-versus${query}`, options);
     }
     /** Get player versus rankings for a specific location. */
     getVersusPlayerRanks(locationId, options) {
         const query = Util_1.Util.queryString(options);
-        return this.handler.request(`/locations/${locationId}/rankings/players-versus${query}`, options);
+        return this.requestHandler.request(`/locations/${locationId}/rankings/players-versus${query}`, options);
+    }
+    /** Get clan capital rankings for a specific location. */
+    getClanCapitalRanks(locationId, options) {
+        const query = Util_1.Util.queryString(options);
+        return this.requestHandler.request(`/locations/${locationId}/rankings/capitals${query}`, options);
     }
     /** Get list of clan labels. */
     getClanLabels(options) {
         const query = Util_1.Util.queryString(options);
-        return this.handler.request(`/labels/clans${query}`, options);
+        return this.requestHandler.request(`/labels/clans${query}`, options);
     }
     /** Get list of player labels. */
     getPlayerLabels(options) {
         const query = Util_1.Util.queryString(options);
-        return this.handler.request(`/labels/players${query}`, options);
+        return this.requestHandler.request(`/labels/players${query}`, options);
     }
     /** Get info about gold pass season. */
     getGoldPassSeason(options) {
-        return this.handler.request('/goldpass/seasons/current', options);
+        return this.requestHandler.request('/goldpass/seasons/current', options);
     }
 }
 exports.RESTManager = RESTManager;

package/dist/rest/RequestHandler.d.ts

@@ -1,6 +1,34 @@
+/// <reference types="node" />
+import { EventEmitter } from 'node:events';
 import { Response, RequestOptions, LoginOptions, RequestHandlerOptions } from '../types';
-/** Represents a Request Handler. */
-export declare class RequestHandler {
+import { IRestEvents } from './RESTManager';
+export interface RequestHandler {
+    emit: (<K extends keyof IRestEvents>(event: K, ...args: IRestEvents[K]) => boolean) & (<S extends string | symbol>(event: Exclude<S, keyof IRestEvents>, ...args: any[]) => boolean);
+    off: (<K extends keyof IRestEvents>(event: K, listener: (...args: IRestEvents[K]) => void) => this) & (<S extends string | symbol>(event: Exclude<S, keyof IRestEvents>, listener: (...args: any[]) => void) => this);
+    on: (<K extends keyof IRestEvents>(event: K, listener: (...args: IRestEvents[K]) => void) => this) & (<S extends string | symbol>(event: Exclude<S, keyof IRestEvents>, listener: (...args: any[]) => void) => this);
+    once: (<K extends keyof IRestEvents>(event: K, listener: (...args: IRestEvents[K]) => void) => this) & (<S extends string | symbol>(event: Exclude<S, keyof IRestEvents>, listener: (...args: any[]) => void) => this);
+    removeAllListeners: (<K extends keyof IRestEvents>(event?: K) => this) & (<S extends string | symbol>(event?: Exclude<S, keyof IRestEvents>) => this);
+    /**
+     * Emitted for general debugging information.
+     * @public
+     * @event
+     */
+    debug: string;
+    /**
+     * Emitted when the client encounters an error.
+     * @public
+     * @event
+     */
+    error: string;
+    /**
+     * Emitted when the client is rate limited.
+     * @public
+     * @event
+     */
+    rateLimited: string;
+}
+/** Represents the class that manages handlers for endpoints. */
+export declare class RequestHandler extends EventEmitter {
     #private;
     private email;
     private password;

package/dist/rest/RequestHandler.js

@@ -1,4 +1,27 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = 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];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 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");
@@ -17,15 +40,17 @@ 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 node_events_1 = require("node:events");
+const node_fetch_1 = __importStar(require("node-fetch"));
 const Constants_1 = require("../util/Constants");
 const Store_1 = require("../util/Store");
 const HTTPError_1 = require("./HTTPError");
 const IP_REGEX = /\d{1,3}.\d{1,3}.\d{1,3}.\d{1,3}/g;
 const agent = new node_https_1.default.Agent({ keepAlive: true });
-/** Represents a Request Handler. */
-class RequestHandler {
+/** Represents the class that manages handlers for endpoints. */
+class RequestHandler extends node_events_1.EventEmitter {
     constructor(options) {
+        super();
         _RequestHandler_keyIndex.set(this, 0); // eslint-disable-line
         this.keys = options?.keys ?? [];
         this.retryLimit = options?.retryLimit ?? 0;
@@ -64,35 +89,46 @@ class RequestHandler {
         return this.exec(path, options);
     }
     async exec(path, options = {}, retries = 0) {
-        const res = await (0, node_fetch_1.default)(`${this.baseURL}${path}`, {
-            agent,
-            body: options.body,
-            method: options.method,
-            timeout: options.restRequestTimeout ?? this.restRequestTimeout,
-            headers: { 'Authorization': `Bearer ${this._key}`, 'Content-Type': 'application/json' }
-        }).catch(() => null);
-        const data = await res?.json().catch(() => null);
-        if (!res && retries < (options.retryLimit ?? this.retryLimit))
-            return this.exec(path, options, ++retries);
-        if (this.creds &&
-            res?.status === 403 &&
-            data?.reason === 'accessDenied.invalidIp' &&
-            retries < (options.retryLimit ?? this.retryLimit)) {
-            const keys = await this.reValidateKeys().then(() => () => this.login());
-            if (keys.length)
-                return this.exec(path, options, ++retries);
-        }
-        const maxAge = Number(res?.headers.get('cache-control')?.split('=')?.[1] ?? 0) * 1000;
-        if (res?.status === 403 && !data?.message && this.rejectIfNotValid) {
-            throw new HTTPError_1.HTTPError(HTTPError_1.PrivateWarLogError, res.status, path, maxAge);
-        }
-        if (!res?.ok && this.rejectIfNotValid) {
-            throw new HTTPError_1.HTTPError(data, res?.status ?? 504, path, maxAge, options.method);
+        try {
+            const res = await (0, node_fetch_1.default)(`${this.baseURL}${path}`, {
+                agent,
+                body: options.body,
+                method: options.method,
+                timeout: options.restRequestTimeout ?? this.restRequestTimeout,
+                headers: { 'Authorization': `Bearer ${this._key}`, 'Content-Type': 'application/json' }
+            });
+            if (res.status === 504 && retries < (options.retryLimit ?? this.retryLimit)) {
+                return await this.exec(path, options, ++retries);
+            }
+            const data = await res.json();
+            if (this.creds &&
+                res.status === 403 &&
+                data.reason === 'accessDenied.invalidIp' &&
+                retries < (options.retryLimit ?? this.retryLimit)) {
+                const keys = await this.reValidateKeys().then(() => () => this.login());
+                if (keys.length)
+                    return await this.exec(path, options, ++retries);
+            }
+            const maxAge = Number(res.headers.get('cache-control')?.split('=')?.[1] ?? 0) * 1000;
+            if (res.status === 403 && !data?.message && this.rejectIfNotValid) {
+                throw new HTTPError_1.HTTPError(HTTPError_1.PrivateWarLogError, res.status, path, maxAge);
+            }
+            if (!res.ok && this.rejectIfNotValid) {
+                throw new HTTPError_1.HTTPError(data, res.status, path, maxAge, options.method);
+            }
+            if (this.cached && maxAge > 0 && options.cache !== false && res.ok) {
+                await this.cached.set(path, { data, ttl: Date.now() + maxAge, status: res.status }, maxAge);
+            }
+            return { data, maxAge, status: res.status, path, ok: res.status === 200 };
         }
-        if (this.cached && maxAge > 0 && options.cache !== false && res?.ok) {
-            await this.cached.set(path, { data, ttl: Date.now() + maxAge, status: res.status }, maxAge);
+        catch (error) {
+            if (error instanceof node_fetch_1.FetchError && error.type === 'request-timeout' && retries < (options.retryLimit ?? this.retryLimit)) {
+                return this.exec(path, options, ++retries);
+            }
+            if (this.rejectIfNotValid)
+                throw error;
+            return { data: { message: error.message }, maxAge: 0, status: 500, path, ok: false };
         }
-        return { data, maxAge, status: res?.status ?? 504, path, ok: res?.status === 200 };
     }
     async init(options) {
         if (!(options.email && options.password))

package/dist/struct/CapitalRaidSeason.d.ts

@@ -0,0 +1,49 @@
+import { Client } from '../client/Client';
+import { APICapitalRaidSeason, APICapitalRaidSeasonAttackLog, APICapitalRaidSeasonDefenseLog, APICapitalRaidSeasonMember, OverrideOptions } from '../types';
+import { Player } from './Player';
+export declare class CapitalRaidSeasonMember {
+    /** The player's tag. */
+    name: string;
+    /** The player's name. */
+    tag: string;
+    /** The number of attacks the player has made. */
+    attacks: number;
+    /** The number of attacks the player can make. */
+    attackLimit: number;
+    /** The number of bonus attacks the player can make. */
+    bonusAttackLimit: number;
+    /** The number of capital resources the player has looted. */
+    capitalResourcesLooted: number;
+    constructor(data: APICapitalRaidSeasonMember);
+}
+/** Represents a Capital Raid Season. */
+export declare class CapitalRaidSeason {
+    private readonly client;
+    /** The state of the raid season. */
+    state: 'ongoing' | 'ended';
+    /** The start time of the raid season. */
+    startTime: Date;
+    /** The end time of the raid season. */
+    endTime: Date;
+    /** The total loot collected from the capital. */
+    capitalTotalLoot: number;
+    /** The number of raids completed. */
+    raidsCompleted: number;
+    /** The total number of attacks. */
+    totalAttacks: number;
+    /** The number of enemy districts destroyed. */
+    enemyDistrictsDestroyed: number;
+    /** The offensive reward. */
+    offensiveReward: number;
+    /** The defensive reward. */
+    defensiveReward: number;
+    /** The members of the raid season. */
+    members: APICapitalRaidSeasonMember[];
+    /** The attack log of the raid season. */
+    attackLog: APICapitalRaidSeasonAttackLog[];
+    /** The defense log of the raid season. */
+    defenseLog: APICapitalRaidSeasonDefenseLog[];
+    constructor(client: Client, data: APICapitalRaidSeason);
+    /** Get {@link Player} info for every Player in the clan. */
+    fetchMembers(options?: OverrideOptions): Promise<Player[]>;
+}

package/dist/struct/CapitalRaidSeason.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CapitalRaidSeason = exports.CapitalRaidSeasonMember = void 0;
+const Util_1 = require("../util/Util");
+class CapitalRaidSeasonMember {
+    constructor(data) {
+        this.tag = data.tag;
+        this.name = data.name;
+        this.attacks = data.attacks;
+        this.attackLimit = data.attackLimit;
+        this.bonusAttackLimit = data.bonusAttackLimit;
+        this.capitalResourcesLooted = data.capitalResourcesLooted;
+    }
+}
+exports.CapitalRaidSeasonMember = CapitalRaidSeasonMember;
+/** Represents a Capital Raid Season. */
+class CapitalRaidSeason {
+    constructor(client, data) {
+        this.client = client;
+        this.state = data.state;
+        this.startTime = Util_1.Util.formatDate(data.startTime);
+        this.endTime = Util_1.Util.formatDate(data.endTime);
+        this.capitalTotalLoot = data.capitalTotalLoot;
+        this.raidsCompleted = data.raidsCompleted;
+        this.totalAttacks = data.totalAttacks;
+        this.enemyDistrictsDestroyed = data.enemyDistrictsDestroyed;
+        this.offensiveReward = data.offensiveReward;
+        this.defensiveReward = data.defensiveReward;
+        this.attackLog = data.attackLog;
+        this.defenseLog = data.defenseLog;
+        this.members = (data.members ?? []).map((member) => new CapitalRaidSeasonMember(member));
+    }
+    /** Get {@link Player} info for every Player in the clan. */
+    async fetchMembers(options) {
+        return (await Promise.allSettled(this.members.map((m) => this.client.getPlayer(m.tag, { ...options, ignoreRateLimit: true }))))
+            .filter((res) => res.status === 'fulfilled')
+            .map((res) => res.value);
+    }
+}
+exports.CapitalRaidSeason = CapitalRaidSeason;

package/dist/struct/Clan.d.ts

@@ -1,4 +1,4 @@
-import { APIClan, OverrideOptions } from '../types';
+import { APICapitalLeague, APIClan, OverrideOptions } from '../types';
 import { Client } from '../client/Client';
 import { ChatLanguage } from './ChatLanguage';
 import { ClanMember } from './ClanMember';
@@ -29,6 +29,8 @@ export declare class Clan {
     level: number;
     /** The clan's trophy count. */
     points: number;
+    /** The clan's capital points. */
+    capitalPoints: number;
     /** The clan's versus trophy count. */
     versusPoints: number;
     /** The minimum trophies required to apply to this clan. */
@@ -57,6 +59,10 @@ export declare class Clan {
     labels: Label[];
     /** The clan's Clan Capital information */
     clanCapital: ClanCapital | null;
+    /** The clan's capital league. */
+    capitalLeague?: APICapitalLeague;
+    /** Whether the clan is family friendly. */
+    isFamilyFriendly: boolean;
     /**
      * List of clan members.
      * - This property returns empty array for {@link Client.getClans} method.

package/dist/struct/Clan.js

@@ -35,6 +35,9 @@ class Clan {
         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.isFamilyFriendly = data.isFamilyFriendly;
+        this.capitalPoints = data.clanCapitalPoints;
+        this.capitalLeague = data.capitalLeague;
         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.js

@@ -4,7 +4,7 @@ exports.ClanCapital = void 0;
 class ClanCapital {
     constructor(data) {
         this.capitalHallLevel = data.capitalHallLevel ?? null;
-        this.districts = data.districts ? data.districts : null;
+        this.districts = data.districts ?? null;
     }
 }
 exports.ClanCapital = ClanCapital;

package/dist/struct/ClanMember.d.ts

@@ -1,4 +1,4 @@
-import { APIClanMember, OverrideOptions } from '../types';
+import { APIClanMember, APIPlayerHouse, OverrideOptions } from '../types';
 import { Client } from '../client/Client';
 import { League } from './League';
 export declare class ClanMember {
@@ -25,6 +25,8 @@ export declare class ClanMember {
     donations: number;
     /** The member's donation received count for this season. */
     received: number;
+    /** The member's player house details. */
+    playerHouse?: APIPlayerHouse | null;
     constructor(client: Client, data: APIClanMember);
     /** Whether this clan member is in the clan. */
     get isMember(): boolean;

package/dist/struct/ClanMember.js

@@ -18,6 +18,7 @@ class ClanMember {
         this.clanRank = data.clanRank;
         this.previousClanRank = data.previousClanRank;
         this.donations = data.donations;
+        this.playerHouse = data.playerHouse ?? null;
         this.received = data.donationsReceived;
     }
     /** Whether this clan member is in the clan. */