clashofclans.js 3.4.2-dev.559ce53 → 3.4.3-dev.fd394cc

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.4.3-dev.fd394cc",
 	"description": "JavaScript library for interacting with the Clash of Clans API",
 	"author": "https://clashofclans.js.org",
 	"license": "MIT",