@smartico/public-api 0.0.405 → 0.0.408

package/docs/api/classes/WSAPITournaments.md

@@ -330,16 +330,13 @@ non-clan tournament typically returns an empty `players` array.
   polling cadence.
 
 **Returned shape**
-`TClanTournamentPlayers` carries the requested clan's identity
-(`clan_id`, `clan_public_meta.name`, `clan_public_meta.image_url`)
+`TClanTournamentPlayers` carries the `tournament_instance_id`
 alongside the `players[]` array — each entry has `position`,
 `scores`, `public_username`, `clean_ext_user_id`, `avatar_id`,
 `avatar_real_id`, the resolved `avatar_url`, `user_id`, and the
-`is_me` flag identifying the current user's row. The `clan_id` and
-`clan_public_meta` on the response echo the input clan — the
-default Smartico UI ignores them and renders the header from the
-caller-side `ClanLeaderboardEntry` object, but they're available
-for consumers that don't already have that context.
+`is_me` flag identifying the current user's row. The response does
+NOT echo the clan's identity — render the clan header from the
+caller-side `ClanLeaderboardEntry` object you passed in.
 
 **Username display**: prefer `clean_ext_user_id` when set, falling
 back to `public_username`. The default Smartico UI uses

package/docs/api/interfaces/GetClanTournamentPlayersResponse.md

@@ -56,23 +56,9 @@
 
 ***
 
-### clan\_id
+### tournament\_instance\_id
 
-> **clan\_id**: `number`
-
-***
-
-### clan\_public\_meta
-
-> **clan\_public\_meta**: `object`
-
-#### name
-
-> **name**: `string`
-
-#### image\_url
-
-> **image\_url**: `string`
+> **tournament\_instance\_id**: `number`
 
 ***
 

package/docs/api/interfaces/SAWTemplateUI.md

@@ -571,8 +571,12 @@ controlling obstacle frequency and game speed.
 > `optional` **custom\_game\_url?**: `string`
 
 URL of the operator-hosted custom mini-game, loaded inside an iframe by
-the widget for `SAWGameType.CustomMinigame`.  The operator is trusted, so
-the iframe is rendered without a sandbox.
+the widget for `SAWGameType.CustomMinigame`.  The operator is trusted
+(the URL resolves to the operator's own published Web Studio game), but
+the iframe is still rendered with a restrictive sandbox as defence in
+depth: `sandbox="allow-scripts allow-forms allow-same-origin allow-popups
+allow-pointer-lock"`. Top-level navigation is intentionally not allowed,
+so the game cannot redirect the host page.
 Back-Office label: _"Game URL"_.
 
 ***

package/docs/api/interfaces/TClanTournamentPlayers.md

@@ -4,27 +4,11 @@ TClanTournamentPlayers describes the players of a specific clan in a clan-based
 
 ## Properties
 
-### clan\_id
+### tournament\_instance\_id
 
-> **clan\_id**: `number`
+> **tournament\_instance\_id**: `number`
 
-Clan ID
-
-***
-
-### clan\_public\_meta
-
-> **clan\_public\_meta**: `object`
-
-Clan display metadata
-
-#### name
-
-> **name**: `string`
-
-#### image\_url
-
-> **image\_url**: `string`
+Tournament instance ID
 
 ***
 
@@ -38,34 +22,52 @@ Top players of this clan ranked by score DESC
 
 > **user\_id**: `number`
 
+Smartico User ID
+
+#### clean\_ext\_user\_id
+
+> **clean\_ext\_user\_id**: `string`
+
+External User ID
+
 #### public\_username
 
 > **public\_username**: `string`
 
+Public username
+
 #### avatar\_id
 
 > **avatar\_id**: `string`
 
+Avatar ID
+
 #### avatar\_real\_id
 
 > **avatar\_real\_id**: `number`
 
+Avatar real ID
+
 #### avatar\_url?
 
 > `optional` **avatar\_url?**: `string`
 
+Avatar URL
+
 #### position
 
 > **position**: `number`
 
+Position in the leaderboard
+
 #### scores
 
 > **scores**: `number`
 
+Score of the player
+
 #### is\_me
 
 > **is\_me**: `boolean`
 
-#### clean\_ext\_user\_id
-
-> **clean\_ext\_user\_id**: `string`
+Indicator if record is the current user

package/docs/api/interfaces/TClanTournamentPlayersResult.md

@@ -2,23 +2,9 @@
 
 ## Properties
 
-### clan\_id
+### tournament\_instance\_id
 
-> **clan\_id**: `number`
-
-***
-
-### clan\_public\_meta
-
-> **clan\_public\_meta**: `object`
-
-#### name
-
-> **name**: `string`
-
-#### image\_url
-
-> **image\_url**: `string`
+> **tournament\_instance\_id**: `number`
 
 ***
 

package/docs/capabilities/getClanTournamentPlayers.md

@@ -2,7 +2,7 @@
 
 > Returns the ranked players of a specific clan within a clan-based tournament instance.
 > Import: `import { TClanTournamentPlayers } from '@smartico/public-api'`
-> Search terms: getClanTournamentPlayers, tournaments, TClanTournamentPlayers
+> Search terms: getClanTournamentPlayers, tournaments, TClanTournamentPlayers, Smartico, User, External, Public, Avatar, Position, Score, Indicator
 
 ## Signature
 ```ts
@@ -15,18 +15,26 @@ _smartico.api.getClanTournamentPlayers(tournamentInstanceId: number, clanId: num
 
 ## Returns — `Promise<TClanTournamentPlayers>`
 `TClanTournamentPlayers`:
-- `clan_id` (number) — Clan ID
-- `clan_public_meta` ({ name: string; image_url: string }) — Clan display metadata
+- `tournament_instance_id` (number) — Tournament instance ID
 - `players` ({
+		/** Smartico User ID */
 		user_id: number;
+		/** External User ID */
+		clean_ext_user_id: string;
+		/** Public username */
 		public_username: string;
+		/** Avatar ID */
 		avatar_id: string;
+		/** Avatar real ID */
 		avatar_real_id: number;
+		/** Avatar URL */
 		avatar_url?: string;
+		/** Position in the leaderboard */
 		position: number;
+		/** Score of the player */
 		scores: number;
+		/** Indicator if record is the current user */
 		is_me: boolean;
-		clean_ext_user_id: string;
 	}[]) — Top players of this clan ranked by score DESC
 
 ## Behavioral contract
@@ -51,16 +59,13 @@ non-clan tournament typically returns an empty `players` array.
  polling cadence.
 
 **Returned shape**
-`TClanTournamentPlayers` carries the requested clan's identity
-(`clan_id`, `clan_public_meta.name`, `clan_public_meta.image_url`)
+`TClanTournamentPlayers` carries the `tournament_instance_id`
 alongside the `players[]` array — each entry has `position`,
 `scores`, `public_username`, `clean_ext_user_id`, `avatar_id`,
 `avatar_real_id`, the resolved `avatar_url`, `user_id`, and the
-`is_me` flag identifying the current user's row. The `clan_id` and
-`clan_public_meta` on the response echo the input clan — the
-default Smartico UI ignores them and renders the header from the
-caller-side `ClanLeaderboardEntry` object, but they're available
-for consumers that don't already have that context.
+`is_me` flag identifying the current user's row. The response does
+NOT echo the clan's identity — render the clan header from the
+caller-side `ClanLeaderboardEntry` object you passed in.
 
 **Username display**: prefer `clean_ext_user_id` when set, falling
 back to `public_username`. The default Smartico UI uses

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@smartico/public-api",
-	"version": "0.0.405",
+	"version": "0.0.408",
 	"description": "Smartico public API",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",

package/src/Tournaments/GetClanTournamentPlayersResponse.ts

@@ -15,8 +15,7 @@ export interface ClanTournamentPlayerRaw {
 }
 
 export interface GetClanTournamentPlayersResponse extends ProtocolResponse {
-	clan_id: number;
-	clan_public_meta: { name: string; image_url: string };
+	tournament_instance_id: number;
 	players: ClanTournamentPlayerRaw[];
 }
 
@@ -33,18 +32,13 @@ export interface TClanTournamentPlayer {
 }
 
 export interface TClanTournamentPlayersResult {
-	clan_id: number;
-	clan_public_meta: { name: string; image_url: string };
+	tournament_instance_id: number;
 	players: TClanTournamentPlayer[];
 }
 
 export const clanTournamentPlayersTransform = (response: GetClanTournamentPlayersResponse): TClanTournamentPlayersResult => {
 	return {
-		clan_id: response.clan_id,
-		clan_public_meta: {
-			name: response.clan_public_meta.name,
-			image_url: response.clan_public_meta.image_url,
-		},
+		tournament_instance_id: response.tournament_instance_id,
 		players: (response.players || []).map((p) => ({
 			user_id: p.userId,
 			clean_ext_user_id: p.cleanExtUserId,

package/src/WSAPI/WSAPITournaments.ts

@@ -288,16 +288,13 @@ export class WSAPITournaments extends WSAPIStore {
 	 *   polling cadence.
 	 *
 	 * **Returned shape**
-	 * `TClanTournamentPlayers` carries the requested clan's identity
-	 * (`clan_id`, `clan_public_meta.name`, `clan_public_meta.image_url`)
+	 * `TClanTournamentPlayers` carries the `tournament_instance_id`
 	 * alongside the `players[]` array — each entry has `position`,
 	 * `scores`, `public_username`, `clean_ext_user_id`, `avatar_id`,
 	 * `avatar_real_id`, the resolved `avatar_url`, `user_id`, and the
-	 * `is_me` flag identifying the current user's row. The `clan_id` and
-	 * `clan_public_meta` on the response echo the input clan — the
-	 * default Smartico UI ignores them and renders the header from the
-	 * caller-side `ClanLeaderboardEntry` object, but they're available
-	 * for consumers that don't already have that context.
+	 * `is_me` flag identifying the current user's row. The response does
+	 * NOT echo the clan's identity — render the clan header from the
+	 * caller-side `ClanLeaderboardEntry` object you passed in.
 	 *
 	 * **Username display**: prefer `clean_ext_user_id` when set, falling
 	 * back to `public_username`. The default Smartico UI uses

package/src/WSAPI/WSAPITypes.ts

@@ -574,21 +574,28 @@ export interface TTournamentDetailed extends TTournament {
  * TClanTournamentPlayers describes the players of a specific clan in a clan-based tournament.
  */
 export interface TClanTournamentPlayers {
-	/** Clan ID */
-	clan_id: number;
-	/** Clan display metadata */
-	clan_public_meta: { name: string; image_url: string };
+	/** Tournament instance ID */
+	tournament_instance_id: number;
 	/** Top players of this clan ranked by score DESC */
 	players: {
+		/** Smartico User ID */
 		user_id: number;
+		/** External User ID */
+		clean_ext_user_id: string;
+		/** Public username */
 		public_username: string;
+		/** Avatar ID */
 		avatar_id: string;
+		/** Avatar real ID */
 		avatar_real_id: number;
+		/** Avatar URL */
 		avatar_url?: string;
+		/** Position in the leaderboard */
 		position: number;
+		/** Score of the player */
 		scores: number;
+		/** Indicator if record is the current user */
 		is_me: boolean;
-		clean_ext_user_id: string;
 	}[];
 }