clashofclans.js 3.4.0-dev.c71cfc8 → 3.4.2-dev.40758b1

package/dist/client/Client.d.ts

@@ -112,8 +112,8 @@ export declare class Client extends EventEmitter {
     getPlayers(playerTags: string[], options?: OverrideOptions): Promise<Player[]>;
     /** Verify Player API token that can be found from the Game settings. */
     verifyPlayerToken(playerTag: string, token: string, options?: OverrideOptions): Promise<boolean>;
-    /** Get a list of Leagues. */
-    getLeagues(options?: SearchOptions): Promise<import("../types").APILeague[]>;
+    /** Get a list of League Tiers. */
+    getLeaguesTiers(options?: SearchOptions): Promise<import("../types").APILeagueTier[]>;
     /** Get a list of Leagues. */
     getBuilderBaseLeagues(options?: SearchOptions): Promise<import("../types").APIBuilderBaseLeague[]>;
     /** Get a list of Capital Leagues. */

package/dist/client/Client.js

@@ -185,9 +185,9 @@ class Client extends node_events_1.EventEmitter {
         const { body } = await this.rest.verifyPlayerToken(playerTag, token, options);
         return body.status === 'ok';
     }
-    /** Get a list of Leagues. */
-    async getLeagues(options) {
-        const { body } = await this.rest.getLeagues(options);
+    /** Get a list of League Tiers. */
+    async getLeaguesTiers(options) {
+        const { body } = await this.rest.getLeagueTiers(options);
         return body.items;
     }
     /** Get a list of Leagues. */

package/dist/rest/RESTManager.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="node" />
 import { EventEmitter } from 'node:events';
-import { APIBuilderBaseLeague, APIBuilderBaseLeagueList, APICapitalLeague, APICapitalLeagueList, APICapitalRaidSeasons, APIClan, APIClanBuilderBaseRankingList, APIClanCapitalRankingList, APIClanList, APIClanMemberList, APIClanRankingList, APIClanWar, APIClanWarLeagueGroup, APIClanWarLogList, APIGoldPassSeason, APILabelList, APILeague, APILeagueList, APILeagueSeasonList, APILocation, APILocationList, APIPlayer, APIPlayerBuilderBaseRankingList, APIPlayerRankingList, APIPlayerSeasonRankingList, APIVerifyToken, APIWarLeague, APIWarLeagueList, ClanSearchOptions, LoginOptions, OverrideOptions, RESTOptions, SearchOptions } from '../types';
+import { APIBuilderBaseLeague, APIBuilderBaseLeagueList, APICapitalLeague, APICapitalLeagueList, APICapitalRaidSeasons, APIClan, APIClanBuilderBaseRankingList, APIClanCapitalRankingList, APIClanList, APIClanMemberList, APIClanRankingList, APIClanWar, APIClanWarLeagueGroup, APIClanWarLogList, APIGoldPassSeason, APILabelList, APILeagueSeasonList, APILeagueTier, APILeagueTierList, APILocation, APILocationList, APIPlayer, APIPlayerBuilderBaseRankingList, APIPlayerRankingList, APIPlayerSeasonRankingList, APIVerifyToken, APIWarLeague, APIWarLeagueList, ClanSearchOptions, LoginOptions, OverrideOptions, RESTOptions, SearchOptions } from '../types';
 import { RestEvents } from '../util/Constants';
 import { Util } from '../util/Util';
 import { RequestHandler } from './RequestHandler';
@@ -72,10 +72,10 @@ export declare class RESTManager extends EventEmitter {
     getPlayer(playerTag: string, options?: OverrideOptions): Promise<import("../types").Result<APIPlayer>>;
     /** Verify Player API token that can be found from the Game settings. */
     verifyPlayerToken(playerTag: string, token: string, options?: OverrideOptions): Promise<import("../types").Result<APIVerifyToken>>;
-    /** Get a list of Leagues. */
-    getLeagues(options?: SearchOptions): Promise<import("../types").Result<APILeagueList>>;
-    /** Get a League info. */
-    getLeague(leagueId: string | number, options?: OverrideOptions): Promise<import("../types").Result<APILeague>>;
+    /** Get a list of League Tiers. */
+    getLeagueTiers(options?: SearchOptions): Promise<import("../types").Result<APILeagueTierList>>;
+    /** Get a League tier info. */
+    getLeagueTier(leagueId: string | number, options?: OverrideOptions): Promise<import("../types").Result<APILeagueTier>>;
     /** Get a list of builder base leagues. */
     getBuilderBaseLeagues(options?: SearchOptions): Promise<import("../types").Result<APIBuilderBaseLeagueList>>;
     /** Get a builder base league info. */

package/dist/rest/RESTManager.js

@@ -81,14 +81,14 @@ class RESTManager extends node_events_1.EventEmitter {
             ...options
         });
     }
-    /** Get a list of Leagues. */
-    getLeagues(options) {
+    /** Get a list of League Tiers. */
+    getLeagueTiers(options) {
         const query = Util_1.Util.queryString(options);
-        return this.requestHandler.request(`/leagues${query}`, options);
+        return this.requestHandler.request(`/leaguetiers${query}`, options);
     }
-    /** Get a League info. */
-    getLeague(leagueId, options) {
-        return this.requestHandler.request(`/leagues/${leagueId}`, options);
+    /** Get a League tier info. */
+    getLeagueTier(leagueId, options) {
+        return this.requestHandler.request(`/leaguetiers/${leagueId}`, options);
     }
     /** Get a list of builder base leagues. */
     getBuilderBaseLeagues(options) {

package/dist/struct/ClanMember.d.ts

@@ -1,5 +1,5 @@
 import { Client } from '../client/Client';
-import { APIClanMember, APILeague, APIPlayerHouse, OverrideOptions } from '../types';
+import { APIClanMember, APILeagueTier, APIPlayerHouse, OverrideOptions } from '../types';
 import { League } from './League';
 export declare class ClanMember {
     /** The member's name. */
@@ -15,7 +15,7 @@ export declare class ClanMember {
     /** The member's current League. */
     league: League;
     /** The member's current Builder Base League. */
-    builderBaseLeague: Omit<APILeague, 'iconUrls'> | null;
+    builderBaseLeague: Omit<APILeagueTier, 'iconUrls'> | null;
     /** The member's trophy count. */
     trophies: number;
     /** The member's builder base trophy count. */

package/dist/struct/ClanMember.js

@@ -19,7 +19,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.UnrankedLeagueData);
+        this.league = new League_1.League(data.leagueTier ?? Constants_1.UnrankedLeagueData);
         this.trophies = data.trophies;
         this.builderBaseTrophies = data.builderBaseTrophies ?? null;
         this.clanRank = data.clanRank;

package/dist/struct/League.d.ts

@@ -1,4 +1,4 @@
-import { APILeague } from '../types';
+import { APILeagueTier } from '../types';
 import { Icon } from './Icon';
 /** Represents a Player's League. */
 export declare class League {
@@ -8,7 +8,7 @@ export declare class League {
     name: string;
     /** The League Icon. */
     icon: Icon;
-    constructor(data: APILeague);
+    constructor(data: APILeagueTier);
     /** Position of this League. Starting from 0 (Un-ranked) */
     get position(): number;
 }

package/dist/struct/Player.js

@@ -39,7 +39,7 @@ class Player {
         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.UnrankedLeagueData);
+        this.league = new League_1.League(data.leagueTier ?? 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));

package/dist/types/api.d.ts

@@ -12,6 +12,10 @@ export interface APIIcon {
     /** Medium Icon is not available for Unranked Icon. */
     medium?: string;
 }
+export interface APILeagueTierIcon {
+    small: string;
+    large: string;
+}
 export interface APIBadge {
     small: string;
     large: string;
@@ -68,8 +72,8 @@ export interface APIClanMember {
     role: 'member' | 'admin' | 'coLeader' | 'leader';
     expLevel: number;
     townHallLevel: number;
-    league: APILeague;
-    builderBaseLeague?: Omit<APILeague, 'iconUrls'>;
+    leagueTier?: APILeagueTier;
+    builderBaseLeague?: Omit<APILeagueTier, 'iconUrls'>;
     trophies: number;
     builderBaseTrophies?: number;
     clanRank: number;
@@ -262,7 +266,7 @@ export interface APIPlayer {
     role?: string;
     warPreference?: 'in' | 'out';
     clan?: APIPlayerClan;
-    league?: APILeague;
+    leagueTier?: APILeagueTier;
     builderBaseLeague?: {
         id: number;
         name: string;
@@ -357,7 +361,7 @@ export interface APIPlayerRanking {
     rank: number;
     previousRank: number;
     clan?: Omit<APIPlayerClan, 'clanLevel'>;
-    league: APILeague;
+    leagueTier?: APILeagueTier;
 }
 /** /locations/{locationId}/rankings/clans-builder-base */
 export interface APIClanBuilderBaseRankingList {
@@ -409,9 +413,9 @@ export interface APIClanCapitalRankingList {
     items: APIClanCapitalRanking[];
     paging: APIPaging;
 }
-/** /leagues */
-export interface APILeagueList {
-    items: APILeague[];
+/** /leaguetiers */
+export interface APILeagueTierList {
+    items: APILeagueTier[];
     paging: APIPaging;
 }
 export interface APIBuilderBaseLeagueList {
@@ -422,15 +426,14 @@ export interface APIBuilderBaseLeague {
     id: number;
     name: string;
 }
-/** /leagues/{leagueId} */
-export interface APILeague {
+export interface APILeagueTier {
     id: number;
     name: string;
-    iconUrls: APIIcon;
+    iconUrls: APILeagueTierIcon;
 }
 /** /leagues/{leagueId}/seasons/{seasonId} */
 export interface APIPlayerSeasonRankingList {
-    items: Omit<APIPlayerRanking, 'league'>[];
+    items: Omit<APIPlayerRanking, 'leagueTier'>[];
     paging: APIPaging;
 }
 /** /leagues/{leagueId}/seasons */

package/dist/util/Constants.d.ts

@@ -17,7 +17,7 @@ export declare const UnrankedLeagueData: {
     name: string;
     iconUrls: {
         small: string;
-        tiny: string;
+        large: string;
     };
 };
 export declare const UnrankedLeagueId = 29000000;

package/dist/util/Constants.js

@@ -20,11 +20,11 @@ exports.BuilderTroops = raw_json_1.default.RAW_UNITS.filter((unit) => unit.subCa
 exports.Heroes = raw_json_1.default.RAW_UNITS.filter((unit) => unit.subCategory === 'hero').map((unit) => unit.name);
 exports.HeroPets = raw_json_1.default.RAW_UNITS.filter((unit) => unit.subCategory === 'pet').map((unit) => unit.name);
 exports.UnrankedLeagueData = {
-    id: 29000000,
+    id: 105000000,
     name: 'Unranked',
     iconUrls: {
-        small: 'https://api-assets.clashofclans.com/leagues/72/e--YMyIexEQQhE4imLoJcwhYn6Uy8KqlgyY3_kFV6t4.png',
-        tiny: 'https://api-assets.clashofclans.com/leagues/36/e--YMyIexEQQhE4imLoJcwhYn6Uy8KqlgyY3_kFV6t4.png'
+        small: 'https://api-assets.clashofclans.com/leaguetiers/125/yyYo5DUFeFBZvmMEQh0ZxvG-1sUOZ_S3kDMB7RllXX0.png',
+        large: 'https://api-assets.clashofclans.com/leaguetiers/326/yyYo5DUFeFBZvmMEQh0ZxvG-1sUOZ_S3kDMB7RllXX0.png'
     }
 };
 exports.UnrankedLeagueId = 29000000;

package/dist/util/Util.d.ts

@@ -33,7 +33,9 @@ export declare class Util extends null {
     static formatDate(date: string): Date;
     /** Returns a string containing a query string suitable for use in a URL. */
     static queryString(options?: SearchOptions | ClanSearchOptions): string;
+    /** @deprecated Use getSeason instead */
     static getSeasonStart(inputDate: Date): Date;
+    /** @deprecated Use getSeason instead */
     static getSeasonEnd(inputDate: Date, forward?: boolean): Date;
     /** Get the current season ID. */
     static getSeasonId(): string;
@@ -45,6 +47,7 @@ export declare class Util extends null {
     static getSeason(timestamp?: Date, forward?: boolean): {
         endTime: Date;
         startTime: Date;
+        seasonId: string;
     };
     static allSettled<T>(values: Promise<T>[]): Promise<T[]>;
     static delay(ms: number): Promise<unknown>;

package/dist/util/Util.js

@@ -95,6 +95,7 @@ class Util extends null {
         const query = new URLSearchParams(Object.entries(options).filter(([key]) => params.includes(key))).toString();
         return query.length ? `?${query}` : query;
     }
+    /** @deprecated Use getSeason instead */
     static getSeasonStart(inputDate) {
         const lastMonthLastDay = new Date(Date.UTC(inputDate.getUTCFullYear(), inputDate.getUTCMonth(), 0));
         const lastMonthLastMonday = new Date(lastMonthLastDay);
@@ -102,6 +103,7 @@ class Util extends null {
         lastMonthLastMonday.setUTCHours(5, 0, 0, 0);
         return lastMonthLastMonday;
     }
+    /** @deprecated Use getSeason instead */
     static getSeasonEnd(inputDate, forward = true) {
         const lastDayOfMonth = new Date(Date.UTC(inputDate.getUTCFullYear(), inputDate.getUTCMonth() + 1, 0));
         const lastMonday = new Date(lastDayOfMonth);
@@ -121,7 +123,7 @@ class Util extends null {
     }
     /** Get the current season ID. */
     static getSeasonId() {
-        return this.getSeasonEnd(new Date()).toISOString().slice(0, 7);
+        return this.getSeason(new Date()).seasonId;
     }
     /**
      * Get the season start and end timestamp.
@@ -129,9 +131,34 @@ class Util extends null {
      * @param {boolean} forward - Whether to forward to the next month if the returned date is in the past relative to the given timestamp. Defaults to true.
      */
     static getSeason(timestamp, forward = true) {
-        const endTime = this.getSeasonEnd(timestamp ?? new Date(), forward);
-        const startTime = this.getSeasonStart(endTime);
-        return { endTime, startTime };
+        const target = timestamp ?? new Date();
+        if (target < new Date('2025-08-25T05:00:00.000Z')) {
+            const endTime = this.getSeasonEnd(timestamp ?? new Date(), forward);
+            const startTime = this.getSeasonStart(endTime);
+            return { endTime, startTime, seasonId: endTime.toISOString().slice(0, 7) };
+        }
+        if (target > new Date('2025-08-25T05:00:00.000Z') && target <= new Date('2025-10-06T05:00:00.000Z')) {
+            return {
+                startTime: new Date('2025-08-25T05:00:00.000Z'),
+                endTime: new Date('2025-10-06T05:00:00.000Z'),
+                seasonId: '2025-09'
+            };
+        }
+        // After 6th October 2025, season ends every 4 weeks
+        const seasonDuration = 7 * 4 * 24 * 60 * 60 * 1000;
+        const referenceDate = new Date('2025-10-06T05:00:00.000Z');
+        const timeDifference = target.getTime() - referenceDate.getTime();
+        const seasonsPassed = Math.floor(timeDifference / seasonDuration);
+        const startTime = new Date(referenceDate.getTime() + seasonsPassed * seasonDuration);
+        const endTime = new Date(startTime.getTime() + seasonDuration);
+        // "month" increments by 1 each season starting from referenceDate's month
+        const refYear = referenceDate.getUTCFullYear();
+        const refMonthIndex = referenceDate.getUTCMonth(); // 0-based (Oct -> 9)
+        const totalMonths = refYear * 12 + refMonthIndex + seasonsPassed;
+        const year = Math.floor(totalMonths / 12);
+        const month = totalMonths - year * 12 + 1; // 1..12
+        const seasonId = `${year}-${String(month).padStart(2, '0')}`;
+        return { startTime, endTime, seasonId };
     }
     static async allSettled(values) {
         return (await Promise.allSettled(values))

package/dist/util.spec.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+process.env.TZ = 'UTC';
 const Util_1 = require("./util/Util");
 describe('util', () => {
     it('should always be UTC', () => {
@@ -31,10 +32,56 @@ describe('util', () => {
     });
     it('should forward to the next year at the end of the year', async () => {
         const timestamp = new Date('2024-12-30T05:01');
-        const { endTime, startTime } = Util_1.Util.getSeason(timestamp);
-        const expectedEndTime = new Date('2025-01-27T05:00').toISOString();
+        const { endTime, startTime, seasonId } = Util_1.Util.getSeason(timestamp);
         const expectedStartTime = new Date('2024-12-30T05:00').toISOString();
+        const expectedEndTime = new Date('2025-01-27T05:00').toISOString();
+        expect(endTime.toISOString()).toBe(expectedEndTime);
+        expect(startTime.toISOString()).toBe(expectedStartTime);
+        expect(seasonId).toBe('2025-01');
+    });
+    it('should pass October 2025', async () => {
+        const timestamp = new Date('2025-10-20T05:00');
+        const { endTime, startTime, seasonId } = Util_1.Util.getSeason(timestamp);
+        const expectedEndTime = new Date('2025-11-03T05:00').toISOString();
+        const expectedStartTime = new Date('2025-10-06T05:00').toISOString();
+        expect(endTime.toISOString()).toBe(expectedEndTime);
+        expect(startTime.toISOString()).toBe(expectedStartTime);
+        expect(seasonId).toBe('2025-10');
+    });
+    it('should pass November 2025', async () => {
+        const timestamp = new Date('2025-11-20T05:00');
+        const { endTime, startTime, seasonId } = Util_1.Util.getSeason(timestamp);
+        const expectedStartTime = new Date('2025-11-03T05:00').toISOString();
+        const expectedEndTime = new Date('2025-12-01T05:00').toISOString();
+        expect(startTime.toISOString()).toBe(expectedStartTime);
         expect(endTime.toISOString()).toBe(expectedEndTime);
+        expect(seasonId).toBe('2025-11');
+    });
+    it('should pass December 2025', async () => {
+        const timestamp = new Date('2025-12-01T05:00');
+        const { endTime, startTime, seasonId } = Util_1.Util.getSeason(timestamp);
+        const expectedStartTime = new Date('2025-12-01T05:00').toISOString();
+        const expectedEndTime = new Date('2025-12-29T05:00').toISOString();
+        expect(startTime.toISOString()).toBe(expectedStartTime);
+        expect(endTime.toISOString()).toBe(expectedEndTime);
+        expect(seasonId).toBe('2025-12');
+    });
+    it('should pass Jan 2026', async () => {
+        const timestamp = new Date('2026-01-01T05:00');
+        const { endTime, startTime, seasonId } = Util_1.Util.getSeason(timestamp);
+        const expectedStartTime = new Date('2025-12-29T05:00').toISOString();
+        const expectedEndTime = new Date('2026-01-26T05:00').toISOString();
         expect(startTime.toISOString()).toBe(expectedStartTime);
+        expect(endTime.toISOString()).toBe(expectedEndTime);
+        expect(seasonId).toBe('2026-01');
+    });
+    it('should pass Feb 2026', async () => {
+        const timestamp = new Date('2026-01-27T05:00');
+        const { endTime, startTime, seasonId } = Util_1.Util.getSeason(timestamp);
+        const expectedStartTime = new Date('2026-01-26T05:00').toISOString();
+        const expectedEndTime = new Date('2026-02-23T05:00').toISOString();
+        expect(startTime.toISOString()).toBe(expectedStartTime);
+        expect(endTime.toISOString()).toBe(expectedEndTime);
+        expect(seasonId).toBe('2026-02');
     });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "clashofclans.js",
-	"version": "3.4.0-dev.c71cfc8",
+	"version": "3.4.2-dev.40758b1",
 	"description": "JavaScript library for interacting with the Clash of Clans API",
 	"author": "https://clashofclans.js.org",
 	"license": "MIT",