clashofclans.js 3.3.24-dev.8f08e9a → 3.3.24-dev.a67ca30

package/dist/util/Util.d.ts

@@ -48,4 +48,17 @@ export declare class Util extends null {
     };
     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',
@@ -141,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.8f08e9a",
+	"version": "3.3.24-dev.a67ca30",
 	"description": "JavaScript library for interacting with the Clash of Clans API",
 	"author": "https://clashofclans.js.org",
 	"license": "MIT",