clashofclans.js 3.6.2 → 3.6.3-dev.fb51c0b

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2020 - 2021 ClashPerk
+Copyright (c) 2020 - 2026 clashperk
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/battle-log.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/battle-log.spec.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const Client_1 = require("./client/Client");
+const Util_1 = require("./util/Util");
+describe('root', () => {
+    const client = new Client_1.Client({ baseURL: process.env.BASE_URL });
+    it('should return battle logs', async () => {
+        const { body: result } = await client.rest.getBattleLog('#9JPLU2RJ2');
+        const legendAttacks = result.items.filter((item) => item.battleType === 'legend').slice(-8);
+        console.log(legendAttacks.map((m) => Util_1.Util.calculateTrophies(m.stars, m.destructionPercentage, m.attack, true)));
+        expect(result).toHaveProperty('items');
+    });
+});

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, APILeagueSeasonList, APILeagueTier, APILeagueTierList, APILocation, APILocationList, APIPlayer, APIPlayerBuilderBaseRankingList, APIPlayerRankingList, APIPlayerSeasonRankingList, APIVerifyToken, APIWarLeague, APIWarLeagueList, ClanSearchOptions, LoginOptions, OverrideOptions, RESTOptions, SearchOptions } from '../types';
+import { APIBattleLogEntryList, APIBuilderBaseLeague, APIBuilderBaseLeagueList, APICapitalLeague, APICapitalLeagueList, APICapitalRaidSeasons, APIClan, APIClanBuilderBaseRankingList, APIClanCapitalRankingList, APIClanList, APIClanMemberList, APIClanRankingList, APIClanWar, APIClanWarLeagueGroup, APIClanWarLogList, APIGoldPassSeason, APILabelList, APILeagueGroupList, APILeagueSeasonList, APILeagueSeasonResultList, 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,6 +72,11 @@ 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>>;
+    getLeagueHistory(playerTag: string, options?: OverrideOptions): Promise<import("../types").Result<APILeagueSeasonResultList>>;
+    getBattleLog(playerTag: string, options?: OverrideOptions): Promise<import("../types").Result<APIBattleLogEntryList>>;
+    getLeagueGroup(leagueGroupTag: string, seasonId: string, options?: OverrideOptions & {
+        playerTag?: string;
+    }): Promise<import("../types").Result<APILeagueGroupList>>;
     /** Get a list of League Tiers. */
     getLeagueTiers(options?: SearchOptions): Promise<import("../types").Result<APILeagueTierList>>;
     /** Get a League tier info. */

package/dist/rest/RESTManager.js

@@ -81,6 +81,15 @@ class RESTManager extends node_events_1.EventEmitter {
             ...options
         });
     }
+    getLeagueHistory(playerTag, options) {
+        return this.requestHandler.request(`/players/${Util_1.Util.encodeURI(playerTag)}/leaguehistory`, options);
+    }
+    getBattleLog(playerTag, options) {
+        return this.requestHandler.request(`/players/${Util_1.Util.encodeURI(playerTag)}/battlelog`, options);
+    }
+    getLeagueGroup(leagueGroupTag, seasonId, options) {
+        return this.requestHandler.request(`/leaguegroup/${leagueGroupTag}/${seasonId}`, options);
+    }
     /** Get a list of League Tiers. */
     getLeagueTiers(options) {
         const query = Util_1.Util.queryString(options);

package/dist/struct/Unit.js

@@ -6,6 +6,8 @@ const Constants_1 = require("../util/Constants");
 class Unit {
     // #endregion static
     constructor(data, unit) {
+        /** Training time of this unit. */
+        this.trainingTime = 0;
         this.name = unit.name;
         this.level = unit.level;
         this.maxLevel = unit.maxLevel;

package/dist/types/api.d.ts

@@ -317,6 +317,42 @@ export interface APIVerifyToken {
     token: string;
     status: 'ok' | 'invalid';
 }
+export interface APIBattleLogEntryList {
+    items: APIBattleLogEntry[];
+}
+export interface APILootEntry {
+    name: string;
+    amount: number;
+}
+export interface APIBattleLogEntry {
+    battleType: 'legend' | 'homeVillage' | 'ranked';
+    attack: boolean;
+    armyShareCode: string;
+    opponentPlayerTag: string;
+    stars: number;
+    destructionPercentage: number;
+    lootedResources: APILootEntry[];
+    extraLootedResources: APILootEntry[];
+    availableLoot: APILootEntry[];
+}
+export interface APILeagueSeasonResult {
+    leagueSeasonId: number;
+    leagueTrophies: number;
+    leagueTierId: number;
+    placement: number;
+    attackWins: number;
+    attackLosses: number;
+    attackStars: number;
+    defenseWins: number;
+    defenseLosses: number;
+    defenseStars: number;
+    maxBattles: number;
+}
+export interface APILeagueSeasonResultList {
+    items: APILeagueSeasonResult[];
+}
+export interface APILeagueGroupList {
+}
 /** /locations */
 export interface APILocationList {
     items: APILocation[];

package/dist/util/Constants.d.ts

@@ -70,37 +70,6 @@ export declare const RawData: {
             building: string;
             buildingLevel: number;
         };
-        trainingTime: number;
-        regenerationTimes: never[];
-        dps: number[];
-        upgrade: {
-            cost: number[];
-            time: number[];
-            resource: string;
-            resources: never[];
-        };
-        allowedCharacters: never[];
-        minLevel: number;
-        seasonal: boolean;
-        levels: number[];
-        resourceType?: undefined;
-    } | {
-        tid: string;
-        id: number;
-        name: string;
-        housingSpace: number;
-        village: string;
-        category: string;
-        subCategory: string;
-        unlock: {
-            hall: number;
-            cost: number;
-            time: number;
-            resource: string;
-            building: string;
-            buildingLevel: number;
-        };
-        trainingTime: string;
         regenerationTimes: never[];
         dps: number[];
         upgrade: {
@@ -114,6 +83,7 @@ export declare const RawData: {
         seasonal: boolean;
         levels: number[];
         resourceType?: undefined;
+        trainingTime?: undefined;
     } | {
         tid: string;
         id: number;
@@ -132,7 +102,7 @@ export declare const RawData: {
         };
         resourceType: string;
         trainingTime: number;
-        regenerationTimes: number[];
+        regenerationTimes: null[];
         dps: number[];
         upgrade: {
             cost: number[];

package/dist/util/Util.d.ts

@@ -65,5 +65,6 @@ export declare class Util extends null {
         endTime: Date;
     };
     static allSettled<T>(values: Promise<T>[]): Promise<T[]>;
+    static calculateTrophies(stars: number, destruction: number, isAttack: boolean, isLegendLeague: boolean): number;
     static delay(ms: number): Promise<unknown>;
 }

package/dist/util/Util.js

@@ -226,6 +226,44 @@ class Util extends null {
             .filter((res) => res.status === 'fulfilled')
             .map((res) => res.value);
     }
+    static calculateTrophies(stars, destruction, isAttack, isLegendLeague) {
+        let attackerGain = 0;
+        if (stars === 3) {
+            // 3 stars always awards the full pool
+            attackerGain = 40;
+        }
+        else if (stars === 2) {
+            // 16 base + 1 per 3% over 50%
+            attackerGain = 16 + Math.floor((destruction - 50) / 3);
+        }
+        else if (stars === 1) {
+            // 5 base + 1 per 9% destruction
+            attackerGain = 5 + Math.floor(destruction / 9);
+        }
+        else {
+            // 0 stars: 1 trophy per 10% destruction (minimum 10% required)
+            if (destruction >= 10) {
+                attackerGain = Math.floor(destruction / 10);
+            }
+        }
+        // Cap at 40 (standard trophy pool)
+        if (attackerGain > 40) {
+            attackerGain = 40;
+        }
+        if (isAttack) {
+            return attackerGain;
+        }
+        // In Legend League, the defender LOSES what the attacker gains
+        if (isLegendLeague) {
+            return -attackerGain;
+        }
+        // In Ranked, the defender GAINS the remainder of the 40 pool
+        // 0-star defense always gives full 40 to defender
+        if (stars === 0) {
+            return 40;
+        }
+        return 40 - attackerGain;
+    }
     static async delay(ms) {
         return new Promise((res) => setTimeout(res, ms));
     }