clashofclans.js 3.4.2-dev.559ce53 → 3.5.0-dev.3cbb1a6

package/dist/client/Client.js

@@ -203,7 +203,7 @@ class Client extends node_events_1.EventEmitter {
     /** Get Legend League season Ids. */
     async getLeagueSeasons(options) {
         const { body } = await this.rest.getLeagueSeasons(Constants_1.LegendLeagueId, options);
-        return body.items.map((league) => league.id);
+        return body.items.map((item) => item.id);
     }
     /** Get Legend League season rankings by season Id. */
     async getSeasonRankings(seasonId, options) {

package/dist/struct/ClanMember.d.ts

@@ -1,6 +1,6 @@
 import { Client } from '../client/Client';
 import { APIClanMember, APILeagueTier, APIPlayerHouse, OverrideOptions } from '../types';
-import { League } from './League';
+import { LeagueTier } from './LeagueTier';
 export declare class ClanMember {
     /** The member's name. */
     name: string;
@@ -13,7 +13,7 @@ export declare class ClanMember {
     /** The member's Town Hall level. */
     townHallLevel: number;
     /** The member's current League. */
-    league: League;
+    leagueTier: LeagueTier;
     /** The member's current Builder Base League. */
     builderBaseLeague: Omit<APILeagueTier, 'iconUrls'> | null;
     /** The member's trophy count. */

package/dist/struct/ClanMember.js

@@ -9,7 +9,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ClanMember = void 0;
 const Constants_1 = require("../util/Constants");
 const Decorators_1 = require("../util/Decorators");
-const League_1 = require("./League");
+const LeagueTier_1 = require("./LeagueTier");
 class ClanMember {
     constructor(client, data) {
         this.client = client;
@@ -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.leagueTier ?? Constants_1.UnrankedLeagueData);
+        this.leagueTier = new LeagueTier_1.LeagueTier(data.leagueTier ?? Constants_1.UnrankedLeagueData);
         this.trophies = data.trophies;
         this.builderBaseTrophies = data.builderBaseTrophies ?? null;
         this.clanRank = data.clanRank;

package/dist/struct/{League.d.ts → LeagueTier.d.ts}

@@ -1,7 +1,7 @@
 import { APILeagueTier } from '../types';
 import { Icon } from './Icon';
 /** Represents a Player's League. */
-export declare class League {
+export declare class LeagueTier {
     /** The league Id. */
     id: number;
     /** The league name. */

package/dist/struct/{League.js → LeagueTier.js}

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.League = void 0;
+exports.LeagueTier = void 0;
 const Constants_1 = require("../util/Constants");
 const Icon_1 = require("./Icon");
 /** Represents a Player's League. */
-class League {
+class LeagueTier {
     constructor(data) {
         this.id = data.id;
         this.name = data.name;
@@ -15,4 +15,4 @@ class League {
         return Constants_1.Leagues.indexOf(this.id);
     }
 }
-exports.League = League;
+exports.LeagueTier = LeagueTier;

package/dist/struct/Player.d.ts

@@ -2,7 +2,7 @@ import { Client } from '../client/Client';
 import { APIPlayer, APIPlayerHouse, OverrideOptions } from '../types';
 import { Achievement } from './Achievement';
 import { Label } from './Label';
-import { League } from './League';
+import { LeagueTier } from './LeagueTier';
 import { LegendStatistics } from './LegendStatistics';
 import { PlayerClan } from './PlayerClan';
 import { Equipment, Hero, Spell, Troop } from './Unit';
@@ -47,7 +47,7 @@ export declare class Player {
     /** The player's clan. */
     clan: PlayerClan | null;
     /** The player's current League. */
-    league: League;
+    leagueTier: LeagueTier;
     /** The player's legend statistics, or `null` if they have never been in the legend league. */
     legendStatistics: LegendStatistics | null;
     /** An array of the player's achievements. */

package/dist/struct/Player.js

@@ -11,7 +11,7 @@ const Constants_1 = require("../util/Constants");
 const Decorators_1 = require("../util/Decorators");
 const Achievement_1 = require("./Achievement");
 const Label_1 = require("./Label");
-const League_1 = require("./League");
+const LeagueTier_1 = require("./LeagueTier");
 const LegendStatistics_1 = require("./LegendStatistics");
 const PlayerClan_1 = require("./PlayerClan");
 const Unit_1 = require("./Unit");
@@ -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.leagueTier ?? Constants_1.UnrankedLeagueData);
+        this.leagueTier = new LeagueTier_1.LeagueTier(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/struct/Ranking.d.ts

@@ -1,7 +1,7 @@
 import { Client } from '../client/Client';
 import { APIClanBuilderBaseRanking, APIClanRanking, APIPlayerBuilderBaseRanking, APIPlayerRanking } from '../types';
 import { Badge } from './Badge';
-import { League } from './League';
+import { LeagueTier } from './LeagueTier';
 import { Location } from './Location';
 import { PlayerClan } from './PlayerClan';
 /** Represents the Player of seasonal legend league leader-board ranking. */
@@ -22,7 +22,7 @@ export declare class SeasonRankedPlayer {
     rank: number;
     /** The player's clan. */
     clan: PlayerClan | null;
-    constructor(client: Client, data: Omit<APIPlayerRanking, 'league'>);
+    constructor(client: Client, data: Omit<APIPlayerRanking, 'leagueTier'>);
     /** Get player's formatted link to open player in-game. */
     get shareLink(): string;
 }
@@ -49,7 +49,7 @@ export declare class RankedPlayer {
     /** The player's clan. */
     clan: PlayerClan | null;
     /** The player's league. If retrieving info for builder base leader-boards, this will be `null`. */
-    league: League | null;
+    leagueTier: LeagueTier | null;
     constructor(client: Client, data: APIPlayerRanking | APIPlayerBuilderBaseRanking);
     /** Get player's formatted link to open player in-game. */
     get shareLink(): string;

package/dist/struct/Ranking.js

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.RankedClan = exports.RankedPlayer = exports.SeasonRankedPlayer = void 0;
 const Constants_1 = require("../util/Constants");
 const Badge_1 = require("./Badge");
-const League_1 = require("./League");
 const Location_1 = require("./Location");
 const PlayerClan_1 = require("./PlayerClan");
 /** Represents the Player of seasonal legend league leader-board ranking. */
@@ -44,7 +43,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.UnrankedLeagueData) : null; // eslint-disable-line
+        this.leagueTier = data.trophies ? new League(data.leagueTier ?? Constants_1.UnrankedLeagueData) : null; // eslint-disable-line
     }
     /** Get player's formatted link to open player in-game. */
     get shareLink() {

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.2-dev.559ce53",
+	"version": "3.5.0-dev.3cbb1a6",
 	"description": "JavaScript library for interacting with the Clash of Clans API",
 	"author": "https://clashofclans.js.org",
 	"license": "MIT",