clashofclans.js 2.6.0-dev.3d6d64a → 2.6.1-dev.96383c3

package/CHANGELOG.md

@@ -2,7 +2,14 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
-## 2.6.0
+# 2.6.1 (2022-02-03)
+
+Bug Fixes
+
+-   New value and typings `notInWar` added for `ClanWarLeagueGroup#state` ([#101](https://github.com/clashperk/clashofclans.js/pull/101))
+-   Throw error if `Util.formatTag` / `Util.parseTag` is called with invalid argument ([#102](https://github.com/clashperk/clashofclans.js/pull/101))
+
+## 2.6.0 (2022-01-29)
 
 ## Features
 

package/dist/client/Client.js

@@ -18,7 +18,7 @@ const struct_1 = require("../struct");
 class Client extends events_1.EventEmitter {
     constructor(options) {
         super();
-        this.rest = new RESTManager_1.RESTManager(options);
+        this.rest = new RESTManager_1.RESTManager({ ...options, rejectIfNotValid: true });
         this.events = new EventManager_1.EventManager(this);
     }
     /** Contains various general-purpose utility methods. */

package/dist/struct/Clan.d.ts

@@ -60,4 +60,6 @@ export declare class Clan {
     constructor(client: Client, data: APIClan);
     /** Get {@link Player} info for every Player in the clan. */
     fetchMembers(options?: OverrideOptions): Promise<Player[]>;
+    /** Get clan's formatted link to open clan in-game. */
+    get shareLink(): string;
 }

package/dist/struct/Clan.js

@@ -40,5 +40,9 @@ class Clan {
             .filter((res) => res.status === 'fulfilled')
             .map((res) => res.value);
     }
+    /** Get clan's formatted link to open clan in-game. */
+    get shareLink() {
+        return `https://link.clashofclans.com/en?action=OpenClanProfile&tag=${this.tag.replace(/#/g, '')}`;
+    }
 }
 exports.Clan = Clan;

package/dist/struct/ClanWar.d.ts

@@ -58,6 +58,8 @@ export declare class ClanWarMember {
     get defenses(): ClanWarAttack[];
     /** Best opponent attack on this base. */
     get bestOpponentAttack(): ClanWarAttack | null;
+    /** Get member's formatted link to open member in-game. */
+    get shareLink(): string;
     /**
      * Returns the previous best opponent attack on this village.
      * This is useful for calculating the new stars or destruction for new attacks.
@@ -96,6 +98,8 @@ export declare class WarClan {
     get defenses(): ClanWarAttack[];
     /** Get a member of the clan for the given tag, or `null` if not found. */
     getMember(tag: string): ClanWarMember | null;
+    /** Get clan's formatted link to open clan in-game. */
+    get shareLink(): string;
 }
 /** Represents a Clan War in Clash of Clans. */
 export declare class ClanWar {

package/dist/struct/ClanWar.js

@@ -72,6 +72,10 @@ class ClanWarMember {
             return null;
         return this.war.getAttack(this._bestOpponentAttackerTag, this.tag);
     }
+    /** Get member's formatted link to open member in-game. */
+    get shareLink() {
+        return `https://link.clashofclans.com/en?action=OpenPlayerProfile&tag=${this.tag.replace(/#/g, '')}`;
+    }
     /**
      * Returns the previous best opponent attack on this village.
      * This is useful for calculating the new stars or destruction for new attacks.
@@ -127,6 +131,10 @@ class WarClan {
     getMember(tag) {
         return this.members.find((m) => m.tag === tag) ?? null;
     }
+    /** Get clan's formatted link to open clan in-game. */
+    get shareLink() {
+        return `https://link.clashofclans.com/en?action=OpenClanProfile&tag=${this.tag.replace(/#/g, '')}`;
+    }
 }
 exports.WarClan = WarClan;
 /** Represents a Clan War in Clash of Clans. */

package/dist/struct/ClanWarLeagueGroup.d.ts

@@ -12,6 +12,8 @@ export declare class ClanWarLeagueClanMember {
     /** The member's town hall level. */
     townHallLevel: number;
     constructor(data: APIClanWarLeagueClanMember);
+    /** Get member's formatted link to open member in-game. */
+    get shareLink(): string;
 }
 /** Represents a Clan of CWL Group. */
 export declare class ClanWarLeagueClan {
@@ -29,6 +31,8 @@ export declare class ClanWarLeagueClan {
     constructor(client: Client, data: APIClanWarLeagueClan);
     /** Get {@link Player} info for every members that are in the CWL group. */
     fetchMembers(options?: OverrideOptions): Promise<Player[]>;
+    /** Get clan's formatted link to open clan in-game. */
+    get shareLink(): string;
 }
 /** Represents a Round of CWL Group. */
 export declare class ClanWarLeagueRound {

package/dist/struct/ClanWarLeagueGroup.js

@@ -9,6 +9,10 @@ class ClanWarLeagueClanMember {
         this.tag = data.tag;
         this.townHallLevel = data.townHallLevel;
     }
+    /** Get member's formatted link to open member in-game. */
+    get shareLink() {
+        return `https://link.clashofclans.com/en?action=OpenPlayerProfile&tag=${this.tag.replace(/#/g, '')}`;
+    }
 }
 exports.ClanWarLeagueClanMember = ClanWarLeagueClanMember;
 /** Represents a Clan of CWL Group. */
@@ -27,6 +31,10 @@ class ClanWarLeagueClan {
             .filter((res) => res.status === 'fulfilled')
             .map((res) => res.value);
     }
+    /** Get clan's formatted link to open clan in-game. */
+    get shareLink() {
+        return `https://link.clashofclans.com/en?action=OpenClanProfile&tag=${this.tag.replace(/#/g, '')}`;
+    }
 }
 exports.ClanWarLeagueClan = ClanWarLeagueClan;
 /** Represents a Round of CWL Group. */

package/dist/struct/ClanWarLog.d.ts

@@ -31,6 +31,8 @@ export declare class WarLogClan {
      */
     attackCount: number | null;
     constructor(data: APIWarLogClan);
+    /** Get clan's formatted link to open clan in-game. */
+    get shareLink(): string | null;
 }
 export declare class ClanWarLog {
     client: Client;

package/dist/struct/ClanWarLog.js

@@ -20,6 +20,10 @@ class WarLogClan {
         this.destruction = data.destructionPercentage;
         this.expEarned = data.expEarned ?? null;
     }
+    /** Get clan's formatted link to open clan in-game. */
+    get shareLink() {
+        return this.tag ? `https://link.clashofclans.com/en?action=OpenClanProfile&tag=${this.tag.replace(/#/g, '')}` : null;
+    }
 }
 exports.WarLogClan = WarLogClan;
 class ClanWarLog {

package/dist/struct/Player.d.ts

@@ -74,4 +74,6 @@ export declare class Player {
     get heroPets(): Troop[];
     /** An array of the player's siege machines. */
     get siegeMachines(): Troop[];
+    /** Get player's formatted link to open player in-game. */
+    get shareLink(): string;
 }

package/dist/struct/Player.js

@@ -76,5 +76,9 @@ class Player {
             .filter((entry) => Constants_1.SIEGE_MACHINES.includes(entry.name))
             .sort((a, b) => Constants_1.SIEGE_MACHINES.indexOf(a.name) - Constants_1.SIEGE_MACHINES.indexOf(b.name));
     }
+    /** Get player's formatted link to open player in-game. */
+    get shareLink() {
+        return `https://link.clashofclans.com/en?action=OpenPlayerProfile&tag=${this.tag.replace(/#/g, '')}`;
+    }
 }
 exports.Player = Player;

package/dist/struct/PlayerClan.d.ts

@@ -19,4 +19,6 @@ export declare class PlayerClan {
     constructor(_client: Client, data: APIPlayerClan);
     /** Fetch detailed clan info for the player's clan. */
     fetch(options?: OverrideOptions): Promise<import("./Clan").Clan>;
+    /** Get clan's formatted link to open clan in-game. */
+    get shareLink(): string;
 }

package/dist/struct/PlayerClan.js

@@ -15,5 +15,9 @@ class PlayerClan {
     fetch(options) {
         return this._client.getClan(this.tag, options);
     }
+    /** Get clan's formatted link to open clan in-game. */
+    get shareLink() {
+        return `https://link.clashofclans.com/en?action=OpenClanProfile&tag=${this.tag.replace(/#/g, '')}`;
+    }
 }
 exports.PlayerClan = PlayerClan;

package/dist/struct/Ranking.d.ts

@@ -23,6 +23,8 @@ export declare class SeasonRankedPlayer {
     /** The player's clan. */
     clan: PlayerClan | null;
     constructor(client: Client, data: Omit<APIPlayerRanking, 'league'>);
+    /** Get player's formatted link to open player in-game. */
+    get shareLink(): string;
 }
 /** Represents the Player of location based leader-board ranking. */
 export declare class RankedPlayer {
@@ -51,6 +53,8 @@ export declare class RankedPlayer {
     /** The player's league. If retrieving info for versus leader-boards, this will be `null`. */
     league: League | null;
     constructor(client: Client, data: APIPlayerRanking | APIPlayerVersusRanking);
+    /** Get player's formatted link to open player in-game. */
+    get shareLink(): string;
 }
 /** Represents the Clan of location based leader-board ranking. */
 export declare class RankedClan {
@@ -75,4 +79,6 @@ export declare class RankedClan {
     /** The clan's badge. */
     badge: Badge;
     constructor(data: APIClanRanking | APIClanVersusRanking);
+    /** Get clan's formatted link to open clan in-game. */
+    get shareLink(): string;
 }

package/dist/struct/Ranking.js

@@ -19,6 +19,10 @@ class SeasonRankedPlayer {
         // @ts-expect-error
         this.clan = data.clan ? new PlayerClan_1.PlayerClan(client, data.clan) : null;
     }
+    /** Get player's formatted link to open player in-game. */
+    get shareLink() {
+        return `https://link.clashofclans.com/en?action=OpenPlayerProfile&tag=${this.tag.replace(/#/g, '')}`;
+    }
 }
 exports.SeasonRankedPlayer = SeasonRankedPlayer;
 /** Represents the Player of location based leader-board ranking. */
@@ -44,6 +48,10 @@ class RankedPlayer {
         // @ts-expect-error
         this.league = data.trophies ? new League_1.League(data.league ?? Constants_1.UNRANKED_LEAGUE_DATA) : null; // eslint-disable-line
     }
+    /** Get player's formatted link to open player in-game. */
+    get shareLink() {
+        return `https://link.clashofclans.com/en?action=OpenPlayerProfile&tag=${this.tag.replace(/#/g, '')}`;
+    }
 }
 exports.RankedPlayer = RankedPlayer;
 /** Represents the Clan of location based leader-board ranking. */
@@ -62,5 +70,9 @@ class RankedClan {
         this.previousRank = data.previousRank;
         this.badge = new Badge_1.Badge(data.badgeUrls);
     }
+    /** Get clan's formatted link to open clan in-game. */
+    get shareLink() {
+        return `https://link.clashofclans.com/en?action=OpenClanProfile&tag=${this.tag.replace(/#/g, '')}`;
+    }
 }
 exports.RankedClan = RankedClan;

package/dist/util/Store.d.ts

@@ -15,9 +15,9 @@ export interface CacheOptions {
      */
     ttl?: number;
 }
-export declare class CacheStore<T = any> implements Store<T> {
+export declare class CacheStore<T> implements Store<T> {
     private readonly ttl;
-    private readonly sweepInterval?;
+    private readonly sweepInterval;
     private readonly store;
     constructor(options?: CacheOptions);
     private _sweep;

package/dist/util/Util.js

@@ -28,7 +28,10 @@ class Util extends null {
     }
     /** @internal */
     static parseTag(tag) {
-        return `#${tag.toUpperCase().replace(/O/g, '0').replace(/^#/g, '').replace(/\s/g, '')}`;
+        if (tag && typeof tag === 'string') {
+            return `#${tag.toUpperCase().replace(/O/g, '0').replace(/^#/g, '').replace(/\s/g, '')}`;
+        }
+        throw new TypeError('The "tag" argument must be of type string.');
     }
     /** Encodes a tag as a valid component of a URI. */
     static encodeURI(tag) {
@@ -47,7 +50,7 @@ class Util extends null {
     static encodeTag(tag) {
         const formatted = this.formatTag(tag).substring(1);
         if (!this.isValidTag(formatted)) {
-            throw new Error(`Failed to encode tag ${formatted}. RegExp matching failed.`);
+            throw new TypeError(`Failed to encode tag ${formatted}. RegExp matching failed.`);
         }
         const result = formatted.split('').reduce((sum, char) => sum * BigInt(14) + BigInt(TAG_CHARACTERS.indexOf(char)), BigInt(0));
         return result.toString();

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "clashofclans.js",
-	"version": "2.6.0-dev.3d6d64a",
+	"version": "2.6.1-dev.96383c3",
 	"description": "JavaScript library for interacting with the Clash of Clans API",
 	"author": "SUVAJIT <suvajit.me@gmail.com>",
 	"license": "MIT",