@smartico/public-api 0.0.363 → 0.0.365

package/dist/Base/ClassId.d.ts

@@ -76,6 +76,14 @@ export declare enum ClassId {
     GET_AVATARS_CUSTOMIZED_RESPONSE = 563,
     GET_AVATAR_PROMPTS_REQUEST = 564,
     GET_AVATAR_PROMPTS_RESPONSE = 565,
+    GET_CLAN_LIST_REQUEST = 570,
+    GET_CLAN_LIST_RESPONSE = 571,
+    GET_CLAN_INFO_REQUEST = 572,
+    GET_CLAN_INFO_RESPONSE = 573,
+    JOIN_CLAN_REQUEST = 574,
+    JOIN_CLAN_RESPONSE = 575,
+    GET_CLAN_TOURNAMENT_PLAYERS_REQUEST = 576,
+    GET_CLAN_TOURNAMENT_PLAYERS_RESPONSE = 577,
     GET_BONUSES_REQUEST = 600,
     GET_BONUSES_RESPONSE = 601,
     CLAIM_BONUS_REQUEST = 602,

package/dist/Clans/Clan.d.ts

@@ -0,0 +1,17 @@
+export interface ClanPublicMeta {
+    name: string;
+    description: string;
+    image_url: string;
+}
+export interface Clan {
+    clan_id: number;
+    public_meta: ClanPublicMeta;
+    member_count: number;
+    capacity_limit: number;
+    /** ShopPurchaseType: 0=Points, 1=Gems, 2=Diamonds, 3=Free */
+    entry_fee_currency_type_id: number;
+    entry_fee_amount: number;
+    /** F1 rank ASC, 1=best */
+    rating_position: number;
+    rating_score: number;
+}

package/dist/Clans/GetClanInfoRequest.d.ts

@@ -0,0 +1,5 @@
+import { ProtocolMessage } from '../Base/ProtocolMessage';
+export interface GetClanInfoRequest extends ProtocolMessage {
+    clan_id: number;
+    force_language?: string;
+}

package/dist/Clans/GetClanInfoResponse.d.ts

@@ -0,0 +1,22 @@
+import { ProtocolResponse } from '../Base/ProtocolResponse';
+import { Clan } from './Clan';
+export interface ClanMember {
+    user_id: number;
+    public_username: string;
+    avatar_id: string;
+    avatar_real_id: number;
+    /** Rank within clan */
+    position: number;
+    /** Aggregated tournament contribution */
+    contribution_score: number;
+    is_me?: boolean;
+    clean_ext_user_id?: string;
+}
+export interface GetClanInfoResponse extends ProtocolResponse {
+    clan_info: Clan;
+    members: ClanMember[];
+    entry_fee_currency_type_id: number;
+    entry_fee_amount: number;
+    /** Cooldown until date string; null if no cooldown active */
+    cooldown_until: string | null;
+}

package/dist/Clans/GetClanListRequest.d.ts

@@ -0,0 +1,4 @@
+import { ProtocolMessage } from '../Base/ProtocolMessage';
+export interface GetClanListRequest extends ProtocolMessage {
+    force_language?: string;
+}

package/dist/Clans/GetClanListResponse.d.ts

@@ -0,0 +1,9 @@
+import { ProtocolResponse } from '../Base/ProtocolResponse';
+import { Clan } from './Clan';
+export interface GetClanListResponse extends ProtocolResponse {
+    clans: Clan[];
+    /** The clan ID the current user belongs to; null if clanless */
+    user_clan_id: number | null;
+    /** Cooldown until date string (e.g. "29/03/2026 10:00:00"); null if no cooldown */
+    cooldown_until: string | null;
+}

package/dist/Clans/JoinClanRequest.d.ts

@@ -0,0 +1,5 @@
+import { ProtocolMessage } from '../Base/ProtocolMessage';
+export interface JoinClanRequest extends ProtocolMessage {
+    clan_id: number;
+    join_source_id: number;
+}

package/dist/Clans/JoinClanResponse.d.ts

@@ -0,0 +1,5 @@
+import { ProtocolResponse } from '../Base/ProtocolResponse';
+export interface JoinClanResponse extends ProtocolResponse {
+    errCode?: number;
+    errMsg?: string;
+}

package/dist/Clans/index.d.ts

@@ -0,0 +1,7 @@
+export * from './Clan';
+export * from './GetClanListRequest';
+export * from './GetClanListResponse';
+export * from './GetClanInfoRequest';
+export * from './GetClanInfoResponse';
+export * from './JoinClanRequest';
+export * from './JoinClanResponse';

package/dist/SmarticoAPI.d.ts

@@ -11,7 +11,7 @@ import { GetTournamentInfoResponse, GetTournamentsResponse, TournamentRegisterRe
 import { LeaderBoardDetails, LeaderBoardPeriodType } from './Leaderboard';
 import { GetLevelMapResponse } from './Level';
 import { WSAPI } from './WSAPI/WSAPI';
-import { TInboxMessage, TInboxMessageBody, TLevel, TMiniGameTemplate, TMissionOrBadge, TStoreCategory, TAchCategory, TStoreItem, TTournament, TTournamentDetailed, LeaderBoardDetailsT, UserLevelExtraCountersT, TSegmentCheckResult, TUICustomSection, TBonus, TRaffle, TLevelCurrent, TActivityLog, TRaffleDraw, TAvatarDefinition, TAvatarCustomized, TAvatarPrompt } from './WSAPI/WSAPITypes';
+import { TInboxMessage, TInboxMessageBody, TLevel, TMiniGameTemplate, TMissionOrBadge, TStoreCategory, TAchCategory, TStoreItem, TTournament, TTournamentDetailed, LeaderBoardDetailsT, UserLevelExtraCountersT, TSegmentCheckResult, TUICustomSection, TBonus, TRaffle, TLevelCurrent, TActivityLog, TRaffleDraw, TAvatarDefinition, TAvatarCustomized, TAvatarPrompt, TClans, TClanInfo, TClanJoinResult, TClanTournamentPlayers } from './WSAPI/WSAPITypes';
 import { GetAchievementsUserInfoResponse } from './Core/GetAchievementsUserInfoResponse';
 import { GetJackpotsPotsResponse, GetJackpotsResponse, JackpotsOptinResponse, JackpotsOptoutResponse } from './Jackpots';
 import { GetCustomSectionsResponse } from './CustomSections';
@@ -21,6 +21,7 @@ import { SAWDoAcknowledgeBatchResponse } from './MiniGames/SAWDoAcknowledgeBatch
 import { GetRelatedAchTourResponse } from './Missions/GetRelatedAchTourResponse';
 import { GetRafflesResponse } from './Raffle/GetRafflesResponse';
 import { GetActivityLogResponse } from './ActivityLog';
+import { GetClanListResponse, GetClanInfoResponse } from './Clans';
 import { InboxCategories } from './Inbox/InboxCategories';
 import { GetDrawRunResponse, GetRaffleDrawRunsHistoryResponse, RaffleClaimPrizeResponse, RaffleOptinResponse } from './Raffle';
 import { GetAvatarsListResponse } from './Avatars/GetAvatarsListResponse';
@@ -146,8 +147,14 @@ declare class SmarticoAPI {
     badgetsGetItemsT(user_ext_id: string): Promise<TMissionOrBadge[]>;
     tournamentsGetLobby(user_ext_id: string, force_language?: string): Promise<GetTournamentsResponse>;
     tournamentsGetLobbyT(user_ext_id: string): Promise<TTournament[]>;
+    clansGetList(user_ext_id: string, force_language?: string): Promise<GetClanListResponse>;
+    clansGetListT(user_ext_id: string): Promise<TClans>;
+    clansGetInfo(user_ext_id: string, clanId: number, force_language?: string): Promise<GetClanInfoResponse>;
+    clansGetInfoT(user_ext_id: string, clanId: number, force_language?: string): Promise<TClanInfo>;
+    clanJoin(user_ext_id: string, clanId: number, joinSourceId?: number): Promise<TClanJoinResult>;
     tournamentsGetInfo(user_ext_id: string, tournamentInstanceId: number, force_language?: string): Promise<GetTournamentInfoResponse>;
     tournamentsGetInfoT(user_ext_id: string, tournamentInstanceId: number): Promise<TTournamentDetailed>;
+    clanTournamentGetPlayers(user_ext_id: string, tournamentInstanceId: number, clanId: number, force_language?: string): Promise<TClanTournamentPlayers>;
     leaderboardGet(user_ext_id: string, period_type_id?: LeaderBoardPeriodType, prevPeriod?: boolean, force_language?: string): Promise<LeaderBoardDetails>;
     leaderboardsGetT(user_ext_id: string, period_type_id?: LeaderBoardPeriodType, prevPeriod?: boolean): Promise<LeaderBoardDetailsT>;
     levelsGet(user_ext_id: string, force_language?: string): Promise<GetLevelMapResponse>;

package/dist/SmarticoLib/index.d.ts

@@ -1011,6 +1011,186 @@ export interface TTournamentDetailed extends TTournament {
         /** if the prize is points related, indicates amount of points */
         points?: number;
     }[];
+    /** True when this tournament groups participants by clan */
+    is_clan_based?: boolean;
+    /** Ranked list of clans in this tournament; null for non-clan tournaments */
+    clan_leaderboard?: {
+        clan_id: number;
+        public_meta: {
+            name: string;
+            description: string;
+            image_url: string;
+        };
+        position: number;
+        total_score: number;
+        contributing_members: number;
+    }[] | null;
+    /** The clan ID the current user belongs to; null when clanless or non-clan tournament */
+    user_clan_id?: number | null;
+    /** The user's rank within their own clan; null when clanless or not registered */
+    user_position_in_clan?: number | null;
+    /** The user's score contribution to their clan; null when clanless or not registered */
+    user_score_in_clan?: number | null;
+    /** Per-clan prize structure; null for non-clan tournaments */
+    clan_prize_structure?: {
+        clan_place: number;
+        /** 1 = Fixed, 2 = Dynamic */
+        prize_type_id: number;
+        prize_pool_amount: number | null;
+        activity_type_id: number | null;
+        details_json: Record<string, any>;
+        public_meta: {
+            name: string;
+            description: string;
+            image_url: string;
+        } | null;
+        tiers: {
+            player_place_from: number;
+            player_place_to: number;
+            pool_amount: number | null;
+            /** 1 = ScoreWeighted, 2 = EqualSplit; null for Fixed */
+            distribution_type: number | null;
+            activity_type_id: number;
+            details_json: Record<string, any>;
+            public_meta: {
+                name: string;
+                description: string;
+                image_url: string;
+            } | null;
+        }[];
+    }[] | null;
+}
+/**
+ * TClanTournamentPlayers describes the players of a specific clan in a clan-based tournament.
+ */
+export interface TClanTournamentPlayers {
+    /** Clan ID */
+    clan_id: number;
+    /** Clan display metadata */
+    public_meta: {
+        name: string;
+        image_url: string;
+    };
+    /** Top players of this clan ranked by score DESC */
+    players: {
+        user_id: number;
+        public_username: string;
+        avatar_id: string;
+        avatar_real_id: number;
+        avatar_url?: string;
+        position: number;
+        scores: number;
+        is_me: boolean;
+        clean_ext_user_id: string;
+    }[];
+}
+export interface GetClanListResponse extends ProtocolResponse {
+    clans: {
+        clan_id: number;
+        public_meta: {
+            name: string;
+            description: string;
+            image_url: string;
+        };
+        member_count: number;
+        capacity_limit: number;
+        entry_fee_currency_type_id: number;
+        entry_fee_amount: number;
+        rating_position: number;
+        rating_score: number;
+    }[];
+    user_clan_id?: number | null;
+    cooldown_until?: string | null;
+}
+export interface GetClanInfoResponse extends ProtocolResponse {
+    clan_info: {
+        clan_id: number;
+        public_meta: {
+            name: string;
+            description: string;
+            image_url: string;
+        };
+        member_count: number;
+        capacity_limit: number;
+        entry_fee_currency_type_id: number;
+        entry_fee_amount: number;
+        rating_position: number;
+        rating_score: number;
+    };
+    members: {
+        user_id: number;
+        public_username: string;
+        avatar_id: string;
+        avatar_real_id: number;
+        position: number;
+        contribution_score: number;
+        is_me?: boolean;
+        clean_ext_user_id?: string;
+    }[];
+    entry_fee_currency_type_id: number;
+    entry_fee_amount: number;
+    cooldown_until: string | null;
+}
+/**
+ * TClan describes one clan item from the clans list.
+ */
+export interface TClan {
+    clan_id: number;
+    public_meta: {
+        name: string;
+        description: string;
+        image_url: string;
+    };
+    member_count: number;
+    capacity_limit: number;
+    entry_fee_currency_type_id: number;
+    entry_fee_amount: number;
+    rating_position: number;
+    rating_score: number;
+}
+/**
+ * TClans describes the clans payload returned by the API.
+ */
+export interface TClans {
+    clans: TClan[];
+    user_clan_id: number | null;
+    cooldown_until: string | null;
+}
+/**
+ * TClanInfo describes the detailed info of a single clan including its members.
+ */
+export interface TClanInfo {
+    clan_id: number;
+    public_meta: {
+        name: string;
+        description: string;
+        image_url: string;
+    };
+    member_count: number;
+    capacity_limit: number;
+    entry_fee_currency_type_id: number;
+    entry_fee_amount: number;
+    rating_position: number;
+    rating_score: number;
+    cooldown_until: string | null;
+    members: {
+        user_id: number;
+        public_username: string;
+        avatar_id: string;
+        avatar_real_id: number;
+        avatar_url?: string;
+        position: number;
+        contribution_score: number;
+        is_me?: boolean;
+        clean_ext_user_id?: string;
+    }[];
+}
+/**
+ * TClanJoinResult describes the result of a join clan request.
+ */
+export interface TClanJoinResult {
+    errCode: number;
+    errMsg: string;
 }
 /**
  * TStoreCategory describes the store category item. Each store item can be assigned to 1 or more categories
@@ -1735,8 +1915,18 @@ declare class WSAPI {
     }): Promise<TTournament[]>;
     /** Returns details information of specific tournament instance, the response will include tournament info and the leaderboard of players */
     getTournamentInstanceInfo(tournamentInstanceId: number): Promise<TTournamentDetailed>;
+    /** Returns the players of a specific clan in a clan-based tournament */
+    getClanTournamentPlayers(tournamentInstanceId: number, clanId: number): Promise<TClanTournamentPlayers>;
     /** Requests registration for the specified tournament instance. Returns the err_code. */
     registerInTournament(tournamentInstanceId: number): Promise<TTournamentRegistrationResult>;
+    /** Returns clans list */
+    getClans({ onUpdate }?: {
+        onUpdate?: (data: TClans) => void;
+    }): Promise<TClans>;
+    /** Returns detailed info for a specific clan including its members */
+    getClanInfo(clanId: number): Promise<TClanInfo>;
+    /** Joins a clan on behalf of the current user */
+    joinClan(clanId: number): Promise<TClanJoinResult>;
     /** Returns the leaderboard for the current type (default is Daily). If getPreviousPeriod is passed as true, a leaderboard for the previous period for the current type will be returned.
         For example, if the type is Weekly and getPreviousPeriod is true, a leaderboard for the previous week will be returned.
      */
@@ -1853,6 +2043,12 @@ declare class SmarticoAPI {
     tournamentsGetLobbyT(user_ext_id: string): Promise<TTournament[]>;
     tournamentsGetInfo(user_ext_id: string, tournamentInstanceId: number): Promise<GetTournamentInfoResponse>;
     tournamentsGetInfoT(user_ext_id: string, tournamentInstanceId: number): Promise<TTournamentDetailed>;
+    clanTournamentGetPlayers(user_ext_id: string, tournamentInstanceId: number, clanId: number, force_language?: string): Promise<TClanTournamentPlayers>;
+    clansGetList(user_ext_id: string, force_language?: string): Promise<GetClanListResponse>;
+    clansGetListT(user_ext_id: string): Promise<TClans>;
+    clansGetInfo(user_ext_id: string, clanId: number, force_language?: string): Promise<GetClanInfoResponse>;
+    clansGetInfoT(user_ext_id: string, clanId: number, force_language?: string): Promise<TClanInfo>;
+    clanJoin(user_ext_id: string, clanId: number, joinSourceId?: number): Promise<TClanJoinResult>;
     leaderboardGet(user_ext_id: string, period_type_id?: LeaderBoardPeriodType, prevPeriod?: boolean): Promise<LeaderBoardDetails>;
     leaderboardsGetT(user_ext_id: string, period_type_id?: LeaderBoardPeriodType, prevPeriod?: boolean): Promise<LeaderBoardDetailsT>;
     levelsGet(user_ext_id: string): Promise<GetLevelMapResponse>;

package/dist/Tournaments/GetClanTournamentPlayersRequest.d.ts

@@ -0,0 +1,6 @@
+import { ProtocolMessage } from '../Base/ProtocolMessage';
+export interface GetClanTournamentPlayersRequest extends ProtocolMessage {
+    tournamentInstanceId: number;
+    clanId: number;
+    forceLanguage?: string;
+}

package/dist/Tournaments/GetClanTournamentPlayersResponse.d.ts

@@ -0,0 +1,40 @@
+import { ProtocolResponse } from '../Base/ProtocolResponse';
+export interface ClanTournamentPlayerRaw {
+    user_id: number;
+    public_username: string;
+    avatar_id: string;
+    avatar_real_id: number;
+    position: number;
+    scores: number;
+    is_me: boolean;
+    clean_ext_user_id: string;
+    avatar_url?: string;
+}
+export interface GetClanTournamentPlayersResponse extends ProtocolResponse {
+    clan_id: number;
+    clan_public_meta: {
+        name: string;
+        image_url: string;
+    };
+    players: ClanTournamentPlayerRaw[];
+}
+export interface TClanTournamentPlayer {
+    user_id: number;
+    public_username: string;
+    avatar_id: string;
+    avatar_real_id: number;
+    avatar_url?: string;
+    position: number;
+    scores: number;
+    is_me: boolean;
+    clean_ext_user_id: string;
+}
+export interface TClanTournamentPlayersResult {
+    clan_id: number;
+    clan_public_meta: {
+        name: string;
+        image_url: string;
+    };
+    players: TClanTournamentPlayer[];
+}
+export declare const clanTournamentPlayersTransform: (response: GetClanTournamentPlayersResponse) => TClanTournamentPlayersResult;

package/dist/Tournaments/GetTournamentInfoResponse.d.ts

@@ -3,6 +3,7 @@ import { TournamentPlayer } from './TournamentPlayer';
 import { ProtocolResponse } from '../Base/ProtocolResponse';
 import { TournamentPrize } from './TournamentPrize';
 import { TTournamentDetailed } from '../WSAPI/WSAPITypes';
+import { ClanLeaderboardEntry, ClanPrizeStructureEntry } from './TournamentClan';
 export interface GetTournamentInfoResponse extends ProtocolResponse {
     /** tournament info */
     tournamentInfo: {
@@ -18,5 +19,15 @@ export interface GetTournamentInfoResponse extends ProtocolResponse {
     prizeStructure?: {
         prizes: TournamentPrize[];
     };
+    /** Ranked list of clans in this tournament. Empty/null for non-clan tournaments. */
+    clanLeaderboard?: ClanLeaderboardEntry[] | null;
+    /**
+     * The clan ID the current user belongs to.
+     * null when the user has no clan or the tournament is not clan-based.
+     * Match against clanLeaderboard[i].clan_id to highlight the user's clan row.
+     */
+    userClanId?: number | null;
+    /** Per-clan prize structure. Empty/null for non-clan tournaments. */
+    clanPrizes?: ClanPrizeStructureEntry[] | null;
 }
 export declare const tournamentInfoItemTransform: (t: GetTournamentInfoResponse) => TTournamentDetailed;

package/dist/Tournaments/Tournament.d.ts

@@ -62,5 +62,7 @@ export interface Tournament {
     hideLeaderboardsMinScores?: boolean;
     /** Total scores across all participants in the tournament */
     totalScores?: number;
+    /** Indicates if the tournament is clan-based */
+    isClanBased?: boolean;
 }
 export declare const TournamentItemsTransform: (items: Tournament[]) => TTournament[];

package/dist/Tournaments/TournamentClan.d.ts

@@ -0,0 +1,27 @@
+import { ClanPublicMeta } from '../Clans/Clan';
+export interface ClanLeaderboardEntry {
+    clan_id: number;
+    public_meta: ClanPublicMeta;
+    position: number;
+    total_score: number;
+    contributing_members: number;
+}
+export interface ClanPrizeTier {
+    player_place_from: number;
+    player_place_to: number;
+    pool_amount: number | null;
+    distribution_type: number | null;
+    activity_type_id: number;
+    details_json: Record<string, any>;
+    public_meta: ClanPublicMeta | null;
+}
+export interface ClanPrizeStructureEntry {
+    clan_place: number;
+    /** 1 = Fixed, 2 = Dynamic */
+    prize_type_id: number;
+    prize_pool_amount: number | null;
+    activity_type_id: number | null;
+    details_json: Record<string, any>;
+    public_meta: ClanPublicMeta;
+    tiers: ClanPrizeTier[];
+}

package/dist/Tournaments/index.d.ts

@@ -1,8 +1,11 @@
+export * from './GetClanTournamentPlayersRequest';
+export * from './GetClanTournamentPlayersResponse';
 export * from './GetTournamentInfoRequest';
 export * from './GetTournamentInfoResponse';
 export * from './GetTournamentsRequest';
 export * from './GetTournamentsResponse';
 export * from './Tournament';
+export * from './TournamentClan';
 export * from './TournamentInstanceStatus';
 export * from './TournamentPlayer';
 export * from './TournamentPrize';

package/dist/WSAPI/WSAPI.d.ts

@@ -1,6 +1,6 @@
 import { ActivityTypeLimited } from '../Core';
 import { SmarticoAPI } from '../SmarticoAPI';
-import { InboxMarkMessageAction, LeaderBoardDetailsT, TAchCategory, TBuyStoreItemResult, TGetTranslations, TInboxMessage, TInboxMessageBody, TLevel, TMiniGamePlayResult, TMiniGameTemplate, TMissionClaimRewardResult, TMissionOptInResult, TMissionOrBadge, TSegmentCheckResult, TStoreCategory, TStoreItem, TTournament, TTournamentDetailed, TTournamentRegistrationResult, TUICustomSection, TUserProfile, UserLevelExtraCountersT, TBonus, TClaimBonusResult, TMiniGamePlayBatchResult, TSawHistory, TRaffle, TRaffleDraw, TRaffleDrawRun, TransformedRaffleClaimPrizeResponse, TLevelCurrent, TActivityLog, TRaffleOptinResponse, GamesApiResponse, GamePickRound, GamePickRoundBoard, GamePickUserInfo, GamePickGameInfo, GamePickRequestParams, GamePickRoundRequestParams, TAvatarDefinition, TAvatarCustomized, TAvatarPrompt, TSetAvatarResult } from './WSAPITypes';
+import { InboxMarkMessageAction, LeaderBoardDetailsT, TAchCategory, TBuyStoreItemResult, TGetTranslations, TInboxMessage, TInboxMessageBody, TLevel, TMiniGamePlayResult, TMiniGameTemplate, TMissionClaimRewardResult, TMissionOptInResult, TMissionOrBadge, TSegmentCheckResult, TStoreCategory, TStoreItem, TTournament, TTournamentDetailed, TTournamentRegistrationResult, TUICustomSection, TUserProfile, UserLevelExtraCountersT, TBonus, TClaimBonusResult, TMiniGamePlayBatchResult, TSawHistory, TRaffle, TRaffleDraw, TRaffleDrawRun, TransformedRaffleClaimPrizeResponse, TLevelCurrent, TActivityLog, TRaffleOptinResponse, TClans, TClanInfo, TClanJoinResult, TClanTournamentPlayers, GamesApiResponse, GamePickRound, GamePickRoundBoard, GamePickUserInfo, GamePickGameInfo, GamePickRequestParams, GamePickRoundRequestParams, TAvatarDefinition, TAvatarCustomized, TAvatarPrompt, TSetAvatarResult } from './WSAPITypes';
 import { LeaderBoardPeriodType } from '../Leaderboard';
 import { JackpotDetails, JackpotWinnerHistory, JackpotsOptinResponse, JackpotsOptoutResponse } from '../Jackpots';
 import { GetRelatedAchTourResponse } from '../Missions/GetRelatedAchTourResponse';
@@ -375,6 +375,28 @@ export declare class WSAPI {
     getTournamentsList({ onUpdate }?: {
         onUpdate?: (data: TTournament[]) => void;
     }): Promise<TTournament[]>;
+    /**
+     * Returns clans list payload for the current user.
+     * The returned payload is cached for 30 seconds.
+     * If onUpdate is passed, it will be called when clans response is received.
+     *
+     * **Visitor mode: not supported**
+     */
+    getClans({ onUpdate }?: {
+        onUpdate?: (data: TClans) => void;
+    }): Promise<TClans>;
+    /**
+     * Returns detailed information for a specific clan including its members.
+     *
+     * **Visitor mode: not supported**
+     */
+    getClanInfo(clanId: number): Promise<TClanInfo>;
+    /**
+     * Joins a clan on behalf of the current user.
+     *
+     * **Visitor mode: not supported**
+     */
+    joinClan(clanId: number): Promise<TClanJoinResult>;
     /**
      * Returns detailed information for a specific tournament instance; the response includes tournament info and the leaderboard of players
      *
@@ -401,6 +423,12 @@ export declare class WSAPI {
      * ```
      */
     getTournamentInstanceInfo(tournamentInstanceId: number): Promise<TTournamentDetailed>;
+    /**
+     * Returns the players of a specific clan in a clan-based tournament.
+     *
+     * **Visitor mode: not supported**
+     */
+    getClanTournamentPlayers(tournamentInstanceId: number, clanId: number): Promise<TClanTournamentPlayers>;
     /**
      * Requests registration for the specified tournament instance. Returns the err_code.
      *
@@ -512,6 +540,7 @@ export declare class WSAPI {
      *
      * **Visitor mode: not supported**
      *
+     * @param params - Event parameters
      * @param params.engagement_uid - Unique identifier for the engagement
      * @param params.activityType - Type of engagement activity (Popup=30, Inbox=31)
      */
@@ -536,6 +565,7 @@ export declare class WSAPI {
      *
      * **Visitor mode: not supported**
      *
+     * @param params - Event parameters
      * @param params.engagement_uid - Unique identifier for the engagement
      * @param params.activityType - Type of engagement activity (Popup=30, Inbox=31)
      * @param params.action - Optional action/deeplink that was triggered by the user interaction
@@ -570,6 +600,7 @@ export declare class WSAPI {
      *
      * **Visitor mode: not supported**
      *
+     * @param params - Activity log parameters
      * @param params.startTimeSeconds - Start time in seconds (epoch timestamp)
      * @param params.endTimeSeconds - End time in seconds (epoch timestamp)
      * @param params.from - Start index of records to return
@@ -964,6 +995,7 @@ export declare class WSAPI {
     private updateMissions;
     private updateBonuses;
     private updateTournaments;
+    private updateClans;
     private updateStorePurchasedItems;
     private updateStoreItems;
     private updateInboxUnreadCount;
@@ -1045,6 +1077,7 @@ export declare class WSAPI {
      *
      * **Visitor mode: not supported**
      *
+     * @param params - Jackpot winners parameters
      * @param params.jp_template_id - Jackpot template id (required; throws if missing)
      * @param params.limit - Page size (server default 20 when omitted)
      * @param params.offset - Offset into the winner list