@smartico/public-api 0.0.380 → 0.0.382

package/docs/native/PROTOCOL.md

@@ -72,6 +72,17 @@ This document describes the low-level protocol for communicating with Smartico b
 - [getTournamentsList](#gettournamentslist)
 - [getTournamentInstanceInfo](#gettournamentinstanceinfo)
 - [registerInTournament](#registerintournament)
+- [getClanTournamentPlayers](#getclantournamentplayers)
+
+#### Clans
+- [getClans](#getclans)
+- [getClanInfo](#getclaninfo)
+- [joinClan](#joinclan)
+
+#### Avatars
+- [getAvatarsList](#getavatarslist)
+- [getAvatarsCustomized](#getavatarscustomized)
+- [getAvatarPrompts](#getavatarprompts)
 
 #### Leaderboard
 - [getLeaderBoard](#getleaderboard)
@@ -114,6 +125,7 @@ This document describes the low-level protocol for communicating with Smartico b
 - [getRaffleDrawRunsHistory](#getraffledrawrunshistory)
 - [claimRafflePrize](#claimraffleprize)
 - [requestRaffleOptin](#requestraffleoptin)
+- [getRaffleWonPrizes](#getrafflewonprizes)
 
 ---
 
@@ -1647,6 +1659,213 @@ No method-specific fields. Returns only the common response fields (see [Common
 
 ---
 
+### getClanTournamentPlayers
+
+Get the players of a specific clan within a clan-based tournament instance.
+
+#### Request
+
+**ClassId:** `576` (GET_CLAN_TOURNAMENT_PLAYERS_REQUEST)
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `tournament_instance_id` | `number` | Tournament instance ID |
+| `clan_id` | `number` | Clan ID whose players to fetch |
+| `force_language` | `string` | Optional language override |
+
+#### Response
+
+**ClassId:** `577` (GET_CLAN_TOURNAMENT_PLAYERS_RESPONSE)
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `clan_id` | `number` | The clan ID |
+| `clan_public_meta` | `object` | `{ name: string, image_url: string }` |
+| `players` | [`ClanTournamentPlayerRaw[]`](../api/interfaces/ClanTournamentPlayerRaw.md) | Ranked players of the clan in this tournament |
+
+> **Note:** `players[]` fields are **camelCase** (`userId`, `cleanExtUserId`, `userAltName`, `isMe`), unlike most other responses in this protocol. `userAltName` is the display name; `scores` is the player's tournament score; `position` is the rank within the clan.
+
+---
+
+## Clans
+
+### getClans
+
+Get the list of clans available to the current user, plus the user's own clan membership state.
+
+#### Request
+
+**ClassId:** `570` (GET_CLAN_LIST_REQUEST)
+
+No method-specific fields. Send only the common fields (see [Common Message Fields](#common-message-fields)).
+
+#### Response
+
+**ClassId:** `571` (GET_CLAN_LIST_RESPONSE)
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `clans` | [`Clan[]`](../api/interfaces/Clan.md) | Available clans |
+| `user_clan_id` | `number \| null` | Clan ID the current user belongs to; `null` if clanless |
+| `cooldown_until` | `string \| null` | Cooldown end as a date string (e.g. `"29/03/2026 10:00:00"`); `null` if no cooldown |
+| `join_date` | `number \| null` | Epoch ms when the user joined their clan; `null` if clanless |
+
+**Example:**
+
+```json
+{
+  "cid": 571,
+  "clans": [
+    {
+      "clan_id": 12,
+      "public_meta": { "name": "Wolves", "description": "Top pack", "image_url": "https://.../wolves.png" },
+      "member_count": 18,
+      "capacity_limit": 30,
+      "entry_fee_currency_type_id": 0,
+      "entry_fee_amount": 100,
+      "rating_position": 3,
+      "rating_score": 45200
+    }
+  ],
+  "user_clan_id": 12,
+  "cooldown_until": null,
+  "join_date": 1742212800000
+}
+```
+
+> **Note:** `entry_fee_currency_type_id`: `0` = Points, `1` = Gems, `2` = Diamonds, `3` = Free. `rating_position` is the F1-style clan rank (ascending, `1` = best).
+
+---
+
+### getClanInfo
+
+Get the full details of a single clan, including its member roster.
+
+#### Request
+
+**ClassId:** `572` (GET_CLAN_INFO_REQUEST)
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `clan_id` | `number` | Clan ID to fetch |
+
+#### Response
+
+**ClassId:** `573` (GET_CLAN_INFO_RESPONSE)
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `clanInfo` | [`ClanInfo`](../api/interfaces/ClanInfo.md) | Clan details + `members[]` roster |
+
+> **Note:** `ClanInfo` extends the `Clan` fields and adds `label_id`, `cooldown_until`, and `members` (an array of [`ClanMember`](../api/interfaces/ClanMember.md)). Member `avatar_id` is the raw avatar id — build the image URL from it client-side (the JS SDK adds an `avatar_url`; the raw protocol response does not).
+
+---
+
+### joinClan
+
+Join (or switch to) a clan. On labels with no cooldown, switching clans re-charges the entry fee — guard against accidental re-joins of the user's current clan.
+
+#### Request
+
+**ClassId:** `574` (JOIN_CLAN_REQUEST)
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `clan_id` | `number` | Clan ID to join |
+| `join_source_id` | `number` | Origin of the join action (operator-defined; `0` if unspecified) |
+
+#### Response
+
+**ClassId:** `575` (JOIN_CLAN_RESPONSE)
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `errCode` | `number` | Result code; `0` = success (see Error Codes below) |
+| `errMsg` | `string` | Optional error message on a non-zero `errCode` |
+
+### Error Codes
+
+| Code | Description |
+|------|-------------|
+| `0` | Success — join completed |
+| `1000` | Invalid parameters |
+| `1001` | Clan not found for this label |
+| `1002` | Clan is full (`member_count >= capacity_limit`) |
+| `1003` | Insufficient funds for the entry fee |
+| `1004` | User does not satisfy the clan's entry conditions / segment |
+| `1006` | User is within the clan-switch cooldown window |
+| `1007` | Clan is archived |
+
+---
+
+## Avatars
+
+Avatar selection (`setAvatar`) is documented under [User](#setavatar). The methods below read the avatar catalog and the user's AI-customized avatars.
+
+### getAvatarsList
+
+Get the avatar catalog available to the current user.
+
+#### Request
+
+**ClassId:** `560` (GET_AVATARS_LIST_REQUEST)
+
+No method-specific fields. Send only the common fields (see [Common Message Fields](#common-message-fields)).
+
+#### Response
+
+**ClassId:** `561` (GET_AVATARS_LIST_RESPONSE)
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `avatars` | [`AvatarDefinition[]`](../api/interfaces/AvatarDefinition.md) | Avatar catalog with per-user unlock flags |
+
+> **Note:** The image path is nested at `public_meta.url` (the JS SDK flattens it to `url` / `avatar_url`). `avatar_source_type_id`: `0` = free / always available, non-zero = earned or purchased. Hide entries where `hide_until_achieved === true && is_given === false`.
+
+---
+
+### getAvatarsCustomized
+
+Get the user's previously generated AI-customized avatar variants.
+
+#### Request
+
+**ClassId:** `562` (GET_AVATARS_CUSTOMIZED_REQUEST)
+
+No method-specific fields. Send only the common fields (see [Common Message Fields](#common-message-fields)).
+
+#### Response
+
+**ClassId:** `563` (GET_AVATARS_CUSTOMIZED_RESPONSE)
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `avatars` | [`AvatarCustomized[]`](../api/interfaces/AvatarCustomized.md) | AI-generated variants, each tied to a base avatar by `avatar_real_id` |
+
+---
+
+### getAvatarPrompts
+
+Get the AI style prompts available for avatar customization.
+
+#### Request
+
+**ClassId:** `564` (GET_AVATAR_PROMPTS_REQUEST)
+
+No method-specific fields. Send only the common fields (see [Common Message Fields](#common-message-fields)).
+
+#### Response
+
+**ClassId:** `565` (GET_AVATAR_PROMPTS_RESPONSE)
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `prompts` | [`AvatarPrompt[]`](../api/interfaces/AvatarPrompt.md) | Available AI style prompts |
+
+> **Note:** Prompt name/icon are nested at `public_meta.name` / `public_meta.icon_url`. `cost_currency_type_id`: `0` = points, `1` = gems, `2` = diamonds; `cost_value` is the amount.
+
+---
+
 ## Leaderboard
 
 ### getLeaderBoard
@@ -2455,6 +2674,124 @@ No method-specific fields. Returns only the common response fields (see [Common
 
 ---
 
+### getRaffleWonPrizes
+
+Get every prize the current user has won within a single raffle — across all of that raffle's draws (recurring, one-shot, and grand; all historical runs) — newest-won first, paginated. Requires an authenticated user; visitor/anonymous sessions are rejected.
+
+### Request
+
+**ClassId:** `920`
+
+**Example:**
+
+```json
+{
+  "cid": 920,
+  "uuid": "550e8400-e29b-41d4-a716-446655440000",
+  "ts": 1704067200000,
+  "raffle_id": 123,
+  "offset": 0,
+  "limit": 20
+}
+```
+
+**Fields:**
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `raffle_id` | `number` | ✓ | ID of the raffle |
+| `offset` | `number` | - | Zero-based index of the first row to return. Default `0` |
+| `limit` | `number` | - | Page size. Defaults to a per-label setting when omitted; not clamped server-side, so always send an explicit value |
+| `force_language` | `string` | - | Overrides the language used to localise `won_prizes[].public_meta.name`. Defaults to the user's profile language |
+
+Rate-limited to ~30 requests per 60 s with a ~5 s minimum gap between calls.
+
+---
+
+### Response
+
+**ClassId:** `921`
+
+**Example:**
+
+```json
+{
+  "cid": 921,
+  "errCode": 0,
+  "errMsg": "",
+  "user": {
+    "user_id": 149600373,
+    "avatar_id": "https://cdn.example.com/avatar.webp",
+    "avatar_real_id": 29,
+    "public_username": "32:r*****",
+    "avatar_url": null
+  },
+  "won_prizes": [
+    {
+      "raf_won_id": 9795826,
+      "prize_id": 389,
+      "raffle_run_id": 659016,
+      "draw_id": 272,
+      "public_meta": {
+        "name": "1 $",
+        "hide_chance_to_win": false,
+        "image_url": "https://cdn.example.com/prize.png"
+      },
+      "requires_claim": false,
+      "claimed_date": 1779978607539
+    }
+  ],
+  "total": 103,
+  "offset": 0,
+  "limit": 20
+}
+```
+
+**Fields:**
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `user` | [`RaffleWonPrizeUser`](../api/interfaces/RaffleWonPrizeUser.md) \| `null` | The user the prizes belong to. `null` when `won_prizes` is empty |
+| `won_prizes` | [`RaffleWonPrize[]`](../api/interfaces/RaffleWonPrize.md) | Won prizes for this page, newest-first |
+| `total` | `number` | Full count of the user's won prizes for this raffle across all draws (for pagination) |
+| `offset` | `number` | Echo of the resolved request offset |
+| `limit` | `number` | Echo of the resolved request limit |
+
+`user` sub-object:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `user_id` | `number` | Internal user ID |
+| `avatar_id` | `string` | Full URL for a system avatar, otherwise an avatar token to resolve against the avatar domain |
+| `avatar_real_id` | `number` | Numeric ID of the selected avatar definition |
+| `public_username` | `string` | Server-masked username (e.g. `"32:r*****"`) |
+| `avatar_url` | `null` | Always `null` on the wire — use `avatar_id` |
+
+`won_prizes[]` item:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `raf_won_id` | `number` | Winning-row ID. Pass as `won_id` to [claimRafflePrize](#claimraffleprize) when `requires_claim` is `true` and `claimed_date` is `null` |
+| `prize_id` | `number` | ID of the prize definition |
+| `raffle_run_id` | `number` | Run-instance ID of the awarding draw |
+| `draw_id` | `number` | Schedule ID of the awarding draw |
+| `public_meta.name` | `string` | Prize name (localised; honours `force_language`) |
+| `public_meta.hide_chance_to_win` | `boolean` | Whether to hide the chance-to-win in the UI |
+| `public_meta.image_url` | `string` | CDN URL for the prize artwork |
+| `requires_claim` | `boolean` | Whether the prize requires an explicit claim action |
+| `claimed_date` | `number` \| `null` | Epoch ms when claimed; `null` when not yet claimed |
+
+---
+
+### Error Codes
+
+| Code | Description |
+|------|-------------|
+| `0` | Success. Also returned with an empty `won_prizes[]` / `total: 0` and `user: null` when the user has no wins or is not eligible to see the raffle |
+| `1` | System error (includes unauthenticated/visitor session, unknown raffle, or any server-side failure) |
+
+---
+
 ## Engagement Tracking
 
 ### reportEngagementImpression

package/docs/ui/avatars/UIGuide_getAvatarPrompts.md

@@ -0,0 +1,100 @@
+# UI Guide — `getAvatarPrompts`
+
+## Overview
+- Returns the AI style prompts (e.g. "Cartoon", "Watercolor", "Cyberpunk")
+  available for avatar customization.
+- Each prompt declares a cost in points / gems / diamonds — applying the
+  prompt deducts that cost server-side as part of the AI generation
+  request.
+- Use to power the style-picker list inside the customization modal.
+- 30 s cache; no push subscription; lazy-load on customization-modal
+  open.
+
+## List view organization
+
+Single flat list. No tabs / no sort hint from the server — present in
+the order returned.
+
+The default Smartico UI shows prompts as a vertical scrollable list with
+one row per prompt.
+
+## Item card / row
+
+Fields rendered per row:
+
+| Field | Source | Notes |
+|---|---|---|
+| Style icon | `icon_url` | 1:1, ~48 × 48 px |
+| Name | `name` | Display label of the style |
+| Cost icon | derived from `cost_currency_type_id` | Points / gems / diamonds icon |
+| Cost amount | `cost_value` | Numeric, e.g. "100" |
+
+**Click target**: tap selects the prompt; selection drives the AI
+generation request.
+
+## Affordability check
+
+Compare `cost_value` against the live balance from
+[`getUserProfile`](../../api/classes/WSAPIUser.md#getuserprofile)
+based on `cost_currency_type_id`:
+
+| `cost_currency_type_id` | Balance source |
+|---|---|
+| `0` | `profile.points_balance` |
+| `1` | `profile.gems_balance` |
+| `2` | `profile.diamonds_balance` |
+
+Prompts the user cannot afford should be visually disabled but still
+visible — the server is the source of truth and enforces the balance
+check authoritatively. The default Smartico UI dims unaffordable
+prompts but does NOT hide them.
+
+## Status-specific visual treatments
+
+| Status | Visual |
+|---|---|
+| Affordable | Normal |
+| Unaffordable | Dimmed / desaturated; CTA disabled |
+| Selected | Highlight ring / accent border |
+
+## Empty / loading / error states
+
+- **Empty**: "No customization styles available" — usually means the AI
+  customization feature is disabled on the label.
+- **Loading**: skeleton list (3–4 placeholder rows).
+- **Error**: non-blocking banner; keep prior list.
+
+## Refresh
+
+- 30 s SDK cache.
+- Not invalidated by
+  [`setAvatar`](../../api/classes/WSAPIAvatars.md#setavatar) — prompts
+  are catalog metadata, independent of the user's active avatar.
+- Not invalidated by the AI generation HTTP POST (prompts don't change
+  per-user).
+- No push subscription.
+
+## Triggering AI generation (out of scope for the SDK)
+
+When the user picks a prompt and confirms, the consumer POSTs to the
+operator-configured `avatar-customize` HTTP endpoint with the chosen
+`prompt_id`, the base `avatar_real_id`, and the base avatar URL. The
+server runs the AI generation (synchronous HTTP — the request blocks
+until generation completes) and returns a new CDN URL.
+
+After success, re-call
+[`getAvatarsCustomized`](../../api/classes/WSAPIAvatars.md#getavatarscustomized)
+to surface the new variant, then optionally apply it with
+[`setAvatar`](../../api/classes/WSAPIAvatars.md#setavatar).
+
+## Mobile vs desktop
+
+- **Row density**: identical on both.
+- **Modal layout**: full-screen sheet on mobile; centered dialog on
+  desktop.
+
+## Performance
+
+- 30 s cache absorbs modal re-opens.
+- Lazy-load — call on modal open, not on app boot.
+- Pre-load icon images at modal open time for snappy scrolling.

package/docs/ui/avatars/UIGuide_getAvatarsCustomized.md

@@ -0,0 +1,90 @@
+# UI Guide — `getAvatarsCustomized`
+
+## Overview
+- Returns the user's previously generated AI-customized avatar variants.
+- Each entry is one AI-generated image tied to a base avatar
+  (`avatar_real_id` refers to the base from
+  [`getAvatarsList`](../../api/classes/WSAPIAvatars.md#getavatarslist)).
+- Power the "My variants" carousel inside the customization modal.
+- 30 s cache; no push subscription.
+
+## List view organization
+
+Variants are best grouped client-side by `avatar_real_id`, then sorted
+within each group by `dt_created` descending (newest first):
+
+```ts
+const byBase = new Map<number, TAvatarCustomized[]>();
+for (const v of variants) {
+  const list = byBase.get(v.avatar_real_id) ?? [];
+  list.push(v);
+  byBase.set(v.avatar_real_id, list);
+}
+for (const list of byBase.values()) {
+  list.sort((a, b) => b.dt_created.localeCompare(a.dt_created));
+}
+```
+
+The default Smartico UI presents variants as a horizontally-scrollable
+carousel under each base avatar in the customization modal.
+
+## Item card / row
+
+Fields rendered per variant:
+
+| Field | Source | Notes |
+|---|---|---|
+| Variant image | `url` | 256 × 256 px |
+| Creation date | `dt_created` | Optional — "Generated 2 days ago" |
+| Apply CTA | local | Tap to set as profile avatar via [`setAvatar`](../../api/classes/WSAPIAvatars.md#setavatar) |
+
+**Click target**: tap selects the variant in the preview area; "Apply"
+in the bottom bar calls
+[`setAvatar({ avatar_url: variant.url, avatar_real_id: variant.avatar_real_id })`](../../api/classes/WSAPIAvatars.md#setavatar).
+
+## Image / asset specs
+
+- **Variant**: 256 × 256 px (1:1) — typically rendered larger than
+  catalog tiles to showcase the AI generation.
+- **Format**: WebP when supported; PNG fallback.
+- **Origin**: served from the operator-configured avatar CDN.
+
+## Empty / loading / error states
+
+- **Empty (new user, no variants)**: show only the base avatar preview;
+  do not render an empty carousel. The default Smartico UI shows the
+  selected base avatar as a single-item fallback.
+- **Loading**: skeleton placeholder over the preview area.
+- **Error**: keep the prior list if any; non-blocking error banner.
+
+## Refresh
+
+- 30 s SDK cache.
+- [`setAvatar`](../../api/classes/WSAPIAvatars.md#setavatar) clears this
+  cache as a side effect.
+- **AI generation is outside this SDK.** After the operator-configured
+  `avatar-customize` HTTP POST resolves successfully, re-call
+  `getAvatarsCustomized()` to surface the new variant (the SDK cannot
+  auto-invalidate because the customization request is not WS-based).
+- No push subscription.
+
+## Relation to `getAvatarsList`
+
+AI variants do NOT appear in
+[`getAvatarsList`](../../api/classes/WSAPIAvatars.md#getavatarslist) —
+they're stored separately under the user record. A combined "all my
+avatars" view requires merging both collections client-side.
+
+## Mobile vs desktop
+
+- **Carousel**: horizontal scroll on mobile; arrow navigation + scroll
+  on desktop.
+- **Preview size**: 256 × 256 px on both; mobile fits one variant per
+  screen width.
+
+## Performance
+
+- 30 s cache absorbs picker re-opens.
+- Pre-load variant images at customization-modal open time.
+- Don't poll — variants only change after a customization run, which
+  the consumer controls.

package/docs/ui/avatars/UIGuide_getAvatarsList.md

@@ -0,0 +1,105 @@
+# UI Guide — `getAvatarsList`
+
+## Overview
+- Returns the avatar catalog plus per-user unlock flags (`is_given`, `is_in_use`).
+- Use to power the avatar picker grid in the user profile screen.
+- 30 s cache; no push subscription. Re-call after
+  [`setAvatar`](../../api/classes/WSAPIAvatars.md#setavatar) to refresh
+  `is_in_use`.
+
+## Grid layout
+
+Single flat grid — no tabs / no filter chips in the default Smartico UI.
+
+Pre-render pipeline:
+
+```ts
+const visible = avatars
+  .filter((a) => !a.hide_until_achieved || a.is_given)
+  .sort((a, b) => a.priority - b.priority);
+```
+
+| Property | Value |
+|---|---|
+| Tile aspect ratio | 1:1 (square) |
+| Default tile size | 128 × 128 px |
+| Column count | 3 on mobile (~360 px), 4–5 on desktop |
+| Sort | `priority` ascending (lower = first) |
+| Visibility filter | drop `hide_until_achieved && !is_given` |
+
+## Item card / tile
+
+Fields rendered per tile:
+
+| Field | Source | Notes |
+|---|---|---|
+| Avatar image | `avatar_url` | 128 × 128 px |
+| "In use" overlay | `is_in_use === true` | Checkmark badge top-right |
+| Lock overlay | `!is_given && avatar_source_type_id !== 0` | "?" placeholder instead of image; grayscale/dim |
+| Selection ring | local UI state | Apply ring when user taps but hasn't confirmed |
+
+**Click target**: single tap selects the avatar (local state). A separate
+"Apply" button submits — tap-to-select is NOT tap-to-apply.
+
+## Action button decision matrix
+
+The picker has a bottom bar with an "Apply" button:
+
+| State | Apply button |
+|---|---|
+| Selected avatar `is_in_use` | Label "In Use", disabled |
+| Selected avatar `is_given` (or free) | Label "Apply", enabled |
+| Selected avatar locked | Apply hidden / disabled; show unlock requirement instead |
+| Apply in flight | Disabled with spinner |
+
+## Image / asset specs
+
+- **Tile**: 128 × 128 px (1:1).
+- **Detail / preview**: 256 × 256 px (1:1).
+- **Format**: WebP when supported by the browser; PNG fallback.
+- **CDN resize path**: the `avatar_url` is the full-resolution image; the
+  consumer should request the resize variant for grid tiles to save
+  bandwidth (e.g. `…/resize/128/128/webp/…`). The exact path scheme is
+  operator-configured.
+
+## Status-specific visual treatments
+
+| Status | Visual |
+|---|---|
+| In use | Checkmark overlay top-right |
+| Selected (not yet applied) | Highlight ring around the tile |
+| Locked (earned, not given) | "?" placeholder image; dimmed |
+| `hide_until_achieved` and not given | Filtered out — does NOT render |
+
+## Empty / loading / error states
+
+- **Loading (cold fetch)**: skeleton grid (6–9 placeholder tiles).
+- **Empty**: "No avatars available" — uncommon, suggests label
+  misconfiguration.
+- **Error**: keep the previous catalog if present; non-blocking error
+  banner.
+
+## Refresh
+
+- 30 s SDK cache deduplicates rapid re-fetches.
+- No push subscription. Re-call after a successful
+  [`setAvatar`](../../api/classes/WSAPIAvatars.md#setavatar) (the SDK
+  auto-clears the cache so the next call goes through).
+- When the user earns a new avatar (`is_given` flips server-side), the
+  change surfaces only on the next call after the cache window expires.
+
+## Mobile vs desktop
+
+- **Tile size**: identical; column count adjusts to viewport width.
+- **Picker layout**: full-screen sheet on mobile; centered modal on
+  desktop.
+
+## Performance
+
+- 30 s cache + immediate post-mutation invalidation balances staleness
+  vs. roundtrip count.
+- Pre-load grid images at picker open time (the user almost always opens
+  the picker to scan multiple avatars).
+- AI-customized variants do NOT appear in this list — they live in
+  [`getAvatarsCustomized`](../../api/classes/WSAPIAvatars.md#getavatarscustomized).
+  Combine the two collections client-side if the UI shows them together.