clashofclans.js 3.3.24-dev.4a30349 → 3.3.24-dev.a67ca30

package/dist/util/Util.d.ts

@@ -43,9 +43,22 @@ export declare 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?: Date, forward?: boolean): {
-        startTime: Date;
         endTime: Date;
+        startTime: Date;
     };
     static allSettled<T>(values: Promise<T>[]): Promise<T[]>;
     static delay(ms: number): Promise<unknown>;
+    /** Parse in-game army link into troops and spells count with respective Id's. */
+    static parseArmyLink(link: string): {
+        units: {
+            name: string | null;
+            count: number;
+            id: number;
+        }[];
+        spells: {
+            name: string | null;
+            count: number;
+            id: number;
+        }[];
+    };
 }

package/dist/util/Util.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Util = exports.timeoutSignal = void 0;
+const Constants_1 = require("../util/Constants");
 const TAG_CHARACTERS = '0289PYLQGRJCUV';
 const params = [
     'name',
@@ -96,9 +97,6 @@ class Util extends null {
         return query.length ? `?${query}` : query;
     }
     static getSeasonStart(inputDate) {
-        if (inputDate >= new Date('2025-08-25T05:00:00.000Z') && inputDate <= new Date('2025-10-06T05:00:00.000Z')) {
-            return new Date('2025-08-25T05:00:00.000Z');
-        }
         const lastMonthLastDay = new Date(Date.UTC(inputDate.getUTCFullYear(), inputDate.getUTCMonth(), 0));
         const lastMonthLastMonday = new Date(lastMonthLastDay);
         lastMonthLastMonday.setUTCDate(lastMonthLastMonday.getUTCDate() - ((lastMonthLastDay.getUTCDay() + 6) % 7));
@@ -106,9 +104,6 @@ class Util extends null {
         return lastMonthLastMonday;
     }
     static getSeasonEnd(inputDate, forward = true) {
-        if (inputDate >= new Date('2025-08-25T05:00:00.000Z') && inputDate <= new Date('2025-10-06T05:00:00.000Z')) {
-            return forward ? new Date('2025-10-06T05:00:00.000Z') : new Date('2025-08-25T05:00:00.000Z');
-        }
         const lastDayOfMonth = new Date(Date.UTC(inputDate.getUTCFullYear(), inputDate.getUTCMonth() + 1, 0));
         const lastMonday = new Date(lastDayOfMonth);
         lastMonday.setUTCDate(lastMonday.getUTCDate() - ((lastDayOfMonth.getUTCDay() + 6) % 7));
@@ -135,10 +130,6 @@ 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 inputDate = timestamp ?? new Date();
-        if (inputDate >= new Date('2025-08-25T05:00:00.000Z') && inputDate <= 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') };
-        }
         const endTime = this.getSeasonEnd(timestamp ?? new Date(), forward);
         const startTime = this.getSeasonStart(endTime);
         return { endTime, startTime };
@@ -151,5 +142,34 @@ class Util extends null {
     static async delay(ms) {
         return new Promise((res) => setTimeout(res, ms));
     }
+    /** Parse in-game army link into troops and spells count with respective Id's. */
+    static parseArmyLink(link) {
+        const unitsMatches = /u(?<units>[\d+x-]+)/.exec(link);
+        const spellsMatches = /s(?<spells>[\d+x-]+)/.exec(link);
+        const unitsPart = unitsMatches?.groups?.units?.split('-') ?? [];
+        const spellParts = spellsMatches?.groups?.spells?.split('-') ?? [];
+        const units = unitsPart
+            .map((parts) => parts.split(/x/))
+            .map((parts) => ({
+            id: Number(parts[1]),
+            total: Number(parts[0])
+        }));
+        const spells = spellParts
+            .map((parts) => parts.split(/x/))
+            .map((parts) => ({
+            id: Number(parts[1]),
+            total: Number(parts[0])
+        }));
+        return {
+            units: units.map((unit) => {
+                const _unit = Constants_1.RawData.RawUnits.find((raw) => raw.category === 'troop' && raw.id === unit.id);
+                return { name: _unit?.name ?? null, count: unit.total, id: unit.id };
+            }),
+            spells: spells.map((spell) => {
+                const _spell = Constants_1.RawData.RawUnits.find((raw) => raw.category === 'spell' && raw.id === spell.id);
+                return { name: _spell?.name ?? null, count: spell.total, id: spell.id };
+            })
+        };
+    }
 }
 exports.Util = Util;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "clashofclans.js",
-	"version": "3.3.24-dev.4a30349",
+	"version": "3.3.24-dev.a67ca30",
 	"description": "JavaScript library for interacting with the Clash of Clans API",
 	"author": "https://clashofclans.js.org",
 	"license": "MIT",