@smartico/public-api 0.0.385 → 0.0.387

package/dist/index.modern.mjs

@@ -1616,6 +1616,8 @@ const UserAchievementTransform = items => {
           id: t.task_id,
           name: (_t$task_public_meta = t.task_public_meta) == null ? void 0 : _t$task_public_meta.name,
           points_reward: t.points_reward,
+          gems_reward: t.gems_reward,
+          diamonds_reward: t.diamonds_reward,
           is_completed: t.isCompleted,
           progress: t.userProgress,
           execution_count_expected: t.executionCount,
@@ -2009,20 +2011,50 @@ const tournamentInfoItemTransform = t => {
   return response;
 };
 
+/**
+ * Error codes returned in `err_code` by the `registerInTournament` method.
+ *
+ * These are terse value definitions for lookup. The full per-code narrative —
+ * when each fires and how the consumer's UI should react — lives in the
+ * `registerInTournament` method TSDoc, which owns the error table.
+ *
+ * Note the numbering break: the gems / diamonds codes are 6-digit
+ * (`300010` / `300011`) while the rest of the tournament block is 5-digit;
+ * they were appended after the original `30001`–`30009` range was occupied.
+ * Branch on the exact numeric value, not on digit count.
+ */
 var TournamentRegistrationError;
 (function (TournamentRegistrationError) {
+  /** Success — registration persisted; buy-in (if any) deducted. */
   TournamentRegistrationError[TournamentRegistrationError["NO_ERROR"] = 0] = "NO_ERROR";
+  /** Clan-based tournament and the user does not belong to a clan yet. */
   TournamentRegistrationError[TournamentRegistrationError["TOURNAMENT_USER_CANNOT_JOIN_WITHOUT_CLAN"] = 1010] = "TOURNAMENT_USER_CANNOT_JOIN_WITHOUT_CLAN";
+  /** Instance id is invalid or the tournament was deleted. */
   TournamentRegistrationError[TournamentRegistrationError["TOURNAMENT_INSTANCE_NOT_FOUND"] = 30001] = "TOURNAMENT_INSTANCE_NOT_FOUND";
+  /** Insufficient points balance for a points-priced buy-in. */
   TournamentRegistrationError[TournamentRegistrationError["TOURNAMENT_REGISTRATION_NOT_ENOUGH_POINTS"] = 30002] = "TOURNAMENT_REGISTRATION_NOT_ENOUGH_POINTS";
+  /** Tournament is no longer in a registerable state (finished, cancelled, finalizing, or not yet open). */
   TournamentRegistrationError[TournamentRegistrationError["TOURNAMENT_INSTANCE_NOT_IN_STATE"] = 30003] = "TOURNAMENT_INSTANCE_NOT_IN_STATE";
+  /** User is already registered; treat as an idempotent success. */
   TournamentRegistrationError[TournamentRegistrationError["TOURNAMENT_ALREADY_REGISTERED"] = 30004] = "TOURNAMENT_ALREADY_REGISTERED";
+  /** User does not satisfy the tournament's segment / entry conditions. */
   TournamentRegistrationError[TournamentRegistrationError["TOURNAMENT_USER_DONT_MATCH_CONDITIONS"] = 30005] = "TOURNAMENT_USER_DONT_MATCH_CONDITIONS";
+  /** User is not registered; anomalous on a register call (usually a server-side race). */
   TournamentRegistrationError[TournamentRegistrationError["TOURNAMENT_USER_NOT_REGISTERED"] = 30006] = "TOURNAMENT_USER_NOT_REGISTERED";
+  /** Registration status transition is not allowed (e.g. re-registering a finished tournament). */
   TournamentRegistrationError[TournamentRegistrationError["TOURNAMENT_CANT_CHANGE_REGISTRATION_STATUS"] = 30007] = "TOURNAMENT_CANT_CHANGE_REGISTRATION_STATUS";
+  /** Tournament filled up — maximum registrations reached. */
   TournamentRegistrationError[TournamentRegistrationError["TOURNAMENT_MAX_REGISTRATIONS_REACHED"] = 30008] = "TOURNAMENT_MAX_REGISTRATIONS_REACHED";
-  TournamentRegistrationError[TournamentRegistrationError["TOURNAMENT_REGISTRATION_NOT_ENOUGH_GEMS"] = 30010] = "TOURNAMENT_REGISTRATION_NOT_ENOUGH_GEMS";
-  TournamentRegistrationError[TournamentRegistrationError["TOURNAMENT_REGISTRATION_NOT_ENOUGH_DIAMONDS"] = 30011] = "TOURNAMENT_REGISTRATION_NOT_ENOUGH_DIAMONDS";
+  /**
+   * The user's wallet currency could not be resolved. Emitted server-side
+   * during tournament score processing, NOT during registration — it is
+   * never returned by `registerInTournament`. Included for completeness.
+   */
+  TournamentRegistrationError[TournamentRegistrationError["TOURNAMENT_INVALID_USER_CURRENCY"] = 30009] = "TOURNAMENT_INVALID_USER_CURRENCY";
+  /** Insufficient gems balance for a gems-priced buy-in. */
+  TournamentRegistrationError[TournamentRegistrationError["TOURNAMENT_REGISTRATION_NOT_ENOUGH_GEMS"] = 300010] = "TOURNAMENT_REGISTRATION_NOT_ENOUGH_GEMS";
+  /** Insufficient diamonds balance for a diamonds-priced buy-in. */
+  TournamentRegistrationError[TournamentRegistrationError["TOURNAMENT_REGISTRATION_NOT_ENOUGH_DIAMONDS"] = 300011] = "TOURNAMENT_REGISTRATION_NOT_ENOUGH_DIAMONDS";
 })(TournamentRegistrationError || (TournamentRegistrationError = {}));
 
 var TournamentType;
@@ -2744,12 +2776,25 @@ class WSAPIUser extends WSAPIBase {
    * `ach_points_ever` and {@link getLevels} would also work, but
    * `progress` saves the math.
    *
-   * **Cache TTL**: the SDK caches the response for 30 seconds. There is
-   * no push event that refreshes this cache; a server-side level change
-   * (visible immediately on {@link getUserProfile}'s `ach_level_current_id`
-   * via the user-properties update channel) becomes visible on this
-   * method only after the cache TTL expires, or after
-   * `_smartico.api.clearCaches()` is called.
+   * **Cache TTL & freshness**
+   * The response is cached for 30 seconds, but the SDK automatically
+   * drops that cache whenever a user-properties update arrives — the
+   * same live channel that backs {@link getUserProfile}. The practical
+   * effect depends on the label's leveling logic:
+   * - **Points-based or operator-manual leveling**: a points or level
+   *   change flows through the user-properties channel, so the cache is
+   *   busted at that moment and the next `getCurrentLevel()` call
+   *   returns up-to-date data without waiting out the TTL.
+   * - **Counter-based leveling** (level driven by sliding-window
+   *   counters such as deposit or wagering totals over a recent window —
+   *   see {@link getUserLevelExtraCounters}): ordinary progress changes
+   *   are recomputed by a periodic server job and do NOT emit a
+   *   user-properties update, so they become visible on this method only
+   *   after the 30 s TTL expires (or after `_smartico.api.clearCaches()`).
+   *
+   * Avoid calling `clearCaches()` on the points/manual path — it's
+   * unnecessary there (the cache is already refreshed on the property
+   * update) and forces a slower extra round-trip.
    *
    * **Leveling logic**
    * The semantics of how a user advances depends on the label's
@@ -2777,10 +2822,10 @@ class WSAPIUser extends WSAPIBase {
    * console.log('[smartico] render level badge — name:', level.name,
    *   'progress:', Math.round(level.progress), '%');
    *
-   * // Detect level-up via getUserProfile's push channel.
+   * // Detect level-up via getUserProfile's push channel. No clearCaches()
+   * // needed — the SDK already drops the level cache on this update.
    * window._smartico.on('props_change', async (changed) => {
    *   if ('ach_level_current_id' in changed) {
-   *     await window._smartico.api.clearCaches();   // bust the 30 s cache
    *     const fresh = await window._smartico.api.getCurrentLevel();
    *     console.log('[smartico] user levelled up — animate badge to new level:', fresh.name);
    *   }
@@ -2815,14 +2860,12 @@ class WSAPIUser extends WSAPIBase {
    * `levelsCounter2Name`.
    *
    * **Refresh cadence**
-   * Sliding-window counters are recomputed by a server-side job that
-   * runs roughly every 60 seconds against the operator's BigQuery
-   * dataset; level transitions driven by counter changes have a
-   * latency of up to several minutes after the underlying activity
-   * (e.g. a deposit). The SDK caches the response for 30 seconds; no
-   * push event refreshes this cache. After a level change visible on
-   * {@link getUserProfile}'s `ach_level_current_id`, call
-   * `_smartico.api.clearCaches()` to force a fresh fetch.
+   * Sliding-window counters are recomputed by a periodic server-side
+   * job. Its rebuild cadence is operator-configured per brand —
+   * commonly daily, though it can be set more frequent — so level
+   * transitions driven by counter changes surface with a latency tied
+   * to that rebuild schedule after the underlying activity (e.g. a
+   * deposit), not in real time.
    *
    * **Idempotency**: safe. Read-only. Repeated calls within the cache
    * window return a deep-cloned cached value without a network
@@ -3313,8 +3356,14 @@ class WSAPIMissions extends WSAPIGeneral {
    * **Idempotency / Side effects**: fetch-only; safe to call repeatedly.
    * The cache layer deduplicates concurrent calls within the TTL window.
    *
+   * **Visitor mode**: not supported. Badges are an authenticated-only
+   * feature; calling this on the visitor-mode handle (`_smartico.vapi`)
+   * throws synchronously rather than silently returning an empty list.
+   *
    * **UI guidance**: see [UI Guide — `getBadges`](../../docs/ui/missions/UIGuide_getBadges.md).
    *
+   * @throws `Error("getBadges is not available in visitor mode")` when
+   *         called from a visitor-mode session.
    * @returns Promise resolving to `TMissionOrBadge[]`. Every item has
    *          `type === 'badge'`. Cached for 30 s under the `Badges` key.
    *
@@ -3356,6 +3405,12 @@ class WSAPIMissions extends WSAPIGeneral {
    * ```
    */
   async getBadges() {
+    // Badges are an authenticated-only feature. The visitor-mode WSAPI
+    // instance (`_smartico.vapi`) is constructed without a tracker, so the
+    // server would silently return nothing; throw a clear error instead.
+    if (!this.api.tracker) {
+      throw new Error('getBadges is not available in visitor mode');
+    }
     return OCache.use(onUpdateContextKey.Badges, ECacheContext.WSAPI, () => this.api.badgetsGetItemsT(this.userExtId), CACHE_DATA_SEC);
   }
   /**
@@ -5434,12 +5489,10 @@ class WSAPIClans extends WSAPITournaments {
    *   tournament requires the user to be in a clan first.
    * - `1006` (`JOIN_CLAN_COOLDOWN_ACTIVE`) — user is inside the
    *   switch-cooldown window from a previous clan join (default
-   *   7 days, configurable per label). Surface the
+   *   7 days, configurable per label). Only reachable when the user is
+   *   already in a *different* clan (this call is then a clan switch);
+   *   a first-time join never returns `1006`. Surface the
    *   `TClans.cooldown_until` expiry in the disabled CTA.
-   * - `1007` (`JOIN_CLAN_ARCHIVED`) — defined on the public enum but
-   *   the server does NOT emit this code in practice (archived clans
-   *   are reported as `1001`). Handle it as a synonym for `1001`
-   *   defensively, but do not rely on it.
    * - `1011` (`JOIN_CLAN_JOINED_AFTER_TOURNAMENT_START`) — this
    *   method does NOT return `1011` directly. The code fires on
    *   {@link registerInTournament} responses when the user joined
@@ -7480,6 +7533,116 @@ class WSAPIAvatars extends WSAPIMiniGames {
       err_message: r.errMsg
     };
   }
+  /**
+   * Generates an AI-customized variant of a base avatar by applying an
+   * operator-defined style prompt, returning the CDN URL of the result.
+   * This is a paid, generate-only step: it does NOT change the user's
+   * active avatar — pass the returned `cdn_url` to {@link setAvatar} to
+   * activate it.
+   *
+   * @remarks
+   * **Preconditions**
+   * - Authenticated session required; not available in visitor mode (throws).
+   * - All five fields are mandatory — the SDK throws synchronously
+   *   (`Error("<field> is required")`) if any is missing or zero.
+   * - `prompt_id` must be one of the prompts from {@link getAvatarPrompts};
+   *   `avatar_url` / `avatar_real_id` identify the base avatar to style.
+   *
+   * **Cost**
+   * Each generation costs the currency the operator configured on the
+   * chosen prompt (points, gems, or diamonds — some prompts are free; read
+   * `cost_currency_type_id` / `cost_value` from the {@link getAvatarPrompts}
+   * entry to gate the UI before calling). The cost is charged only on
+   * success; if the user can't afford it the call fails with `errCode -1`
+   * and nothing is generated or charged.
+   *
+   * **Latency**
+   * Generation runs server-side AI image synthesis and is synchronous from
+   * the caller's side — expect several seconds (roughly 5–20 s) before the
+   * promise resolves. There is no SDK cache and no push/subscription; show
+   * a loading state for the full duration and disable the trigger to
+   * prevent duplicate submissions.
+   *
+   * **Result & error codes**
+   * On success the result has `cdn_url` set; on failure it has `errCode` /
+   * `errMessage` set and no `cdn_url`. Branch on `errCode` — the generic
+   * message is fixed text, not cause-specific:
+   * - `12001` (`AvatarCustomizeErrorCode.AVATAR_USER_LIMIT`) — the user hit
+   *   their monthly per-user generation cap. Nothing is generated or charged.
+   * - `12002` (`AvatarCustomizeErrorCode.AVATAR_LABEL_LIMIT`) — the brand's
+   *   shared monthly pool is exhausted. Nothing is generated or charged;
+   *   surface a "try again later" message.
+   * - `-1` — generic failure: insufficient balance, an unavailable prompt,
+   *   or a generation error. Nothing is charged. Allow the user to retry.
+   *
+   * Both monthly caps are operator-configured and reset at the start of
+   * each calendar month.
+   *
+   * **Side effects (on success)**
+   * The generated variant is persisted to the user's customization history
+   * and counts toward the monthly caps **whether or not** it is later
+   * activated — generation is not reversible. The SDK clears the
+   * {@link getAvatarsCustomized} cache so the next call surfaces the new
+   * variant. The user's active avatar is unchanged until you call
+   * {@link setAvatar} with the returned `cdn_url`.
+   *
+   * **Idempotency**: not idempotent — each successful call generates (and
+   * charges for) a new variant. Guard the call site against double-clicks.
+   *
+   * **UI guidance**: see [UI Guide — `avatarsCustomize`](../../docs/ui/avatars/UIGuide_avatarsCustomize.md).
+   *
+   * **Visitor mode**: not supported (throws).
+   *
+   * @param props.label_id        Numeric Smartico label (brand) ID the user belongs to.
+   * @param props.user_id         Numeric Smartico user ID.
+   * @param props.prompt_id       Style-prompt ID (`prompt_id`) from {@link getAvatarPrompts}.
+   * @param props.avatar_url      CDN URL of the base avatar to customize.
+   * @param props.avatar_real_id  `avatar_real_id` of the base avatar.
+   * @returns {@link AvatarCustomizeResponse} — `cdn_url` set on success;
+   *          `errCode` / `errMessage` set on failure.
+   *
+   * @example
+   * ```ts
+   * // label_id / user_id identify the Smartico user being customized.
+   * const prompts = await window._smartico.api.getAvatarPrompts();
+   * const prompt = prompts[0];
+   *
+   * console.log('[smartico] generating avatar — show a spinner for ~5-20s and disable the Generate button');
+   * const result = await window._smartico.api.avatarsCustomize({
+   *   label_id,
+   *   user_id,
+   *   prompt_id: prompt.prompt_id,
+   *   avatar_url: baseAvatar.avatar_url,
+   *   avatar_real_id: baseAvatar.avatar_real_id,
+   * });
+   *
+   * if (result.cdn_url) {
+   *   console.log('[smartico] generation succeeded — preview this URL, then call setAvatar to apply it:', result.cdn_url);
+   *   // await window._smartico.api.setAvatar({ avatar_url: result.cdn_url, avatar_real_id: baseAvatar.avatar_real_id });
+   * } else if (result.errCode === 12001) {
+   *   console.error('[smartico] user monthly limit reached — show "you have used all your custom avatars this month"');
+   * } else if (result.errCode === 12002) {
+   *   console.error('[smartico] brand monthly pool exhausted — show "custom avatars are unavailable right now, try later"');
+   * } else {
+   *   console.error('[smartico] generation failed (e.g. not enough balance) — let the user retry:', result.errMessage);
+   * }
+   * ```
+   */
+  async avatarsCustomize(props) {
+    const required = ['label_id', 'user_id', 'prompt_id', 'avatar_url', 'avatar_real_id'];
+    for (const field of required) {
+      if (!props[field]) {
+        throw new Error(`${field} is required`);
+      }
+    }
+    const r = await this.api.avatarsCustomize(props);
+    // On success a new variant is persisted server-side — drop the cached
+    // list so the next getAvatarsCustomized() surfaces it.
+    if (r.cdn_url) {
+      OCache.clear(ECacheContext.WSAPI, onUpdateContextKey.AvatarsCustomized);
+    }
+    return r;
+  }
 }
 
 /** @group GamePick */
@@ -8180,15 +8343,8 @@ class WSAPILeaderBoard extends WSAPIGamePick {
    * the array is the prize for place 1, the second for place 2, and
    * so on. The array length is the number of paid places.
    *
-   * **Cache TTL — single shared key (known limitation)**
-   * The SDK caches the response for 30 seconds under a SINGLE shared
-   * key — calling `getLeaderBoard(DAILY)` followed by
-   * `getLeaderBoard(WEEKLY)` within the same 30 s window returns the
-   * cached DAILY result for the WEEKLY call. Same applies to
-   * switching `getPreviousPeriod`. To force a fresh fetch when
-   * switching periods or current/previous, call
-   * `_smartico.api.clearCaches()` before the second call, or simply
-   * wait out the TTL.
+   * **Cache TTL**
+   * The SDK caches each response for 30 seconds.
    *
    * **Period boundaries**
    * The server finalizes each period on a server-configurable
@@ -8258,8 +8414,7 @@ class WSAPILeaderBoard extends WSAPIGamePick {
    *   }
    * }
    *
-   * // Switch to previous period view — but bust the cache first to avoid the shared-key collision.
-   * await window._smartico.api.clearCaches();
+   * // Switch to previous period view — cached separately from the current period.
    * const prev = await window._smartico.api.getLeaderBoard(LeaderBoardPeriodType.WEEKLY, true);
    * console.log('[smartico] previous-week standings — render with greyed-out "ended" treatment:', prev?.users.length, 'finalists');
    *
@@ -8268,7 +8423,10 @@ class WSAPILeaderBoard extends WSAPIGamePick {
    * ```
    */
   async getLeaderBoard(periodType, getPreviousPeriod) {
-    return OCache.use(onUpdateContextKey.LeaderBoards, ECacheContext.WSAPI, () => this.api.leaderboardsGetT(this.userExtId, periodType, getPreviousPeriod), CACHE_DATA_SEC);
+    // Cache per (periodType, current/previous) so switching tabs or
+    // current↔previous within the TTL doesn't return a colliding board.
+    const cacheKey = `${onUpdateContextKey.LeaderBoards}:${periodType}:${getPreviousPeriod ? 1 : 0}`;
+    return OCache.use(cacheKey, ECacheContext.WSAPI, () => this.api.leaderboardsGetT(this.userExtId, periodType, getPreviousPeriod), CACHE_DATA_SEC);
   }
 }
 
@@ -8993,6 +9151,7 @@ class WSAPI extends WSAPIInbox {
         if ((data == null || (_data$props3 = data.props) == null ? void 0 : _data$props3.ach_points_balance) !== undefined || (data == null || (_data$props4 = data.props) == null ? void 0 : _data$props4.ach_gems_balance) !== undefined || (data == null || (_data$props5 = data.props) == null ? void 0 : _data$props5.ach_diamonds_balance) !== undefined) {
           this.notifyActivityLogUpdate();
         }
+        OCache.clear(ECacheContext.WSAPI, onUpdateContextKey.CurrentLevel);
       });
       on(ClassId.RAF_OPTIN_RESPONSE, () => this.updateRaffles());
     }
@@ -9250,7 +9409,7 @@ const AVATAR_DOMAIN = 'https://img{ENV_ID}.smr.vc';
 const DEFAULT_LANG_EN = 'EN';
 class SmarticoAPI {
   constructor(label_api_key, brand_api_key, messageSender, options = {}) {
-    var _options$tracker;
+    var _options$tracker, _options$tracker2;
     this.label_api_key = void 0;
     this.brand_api_key = void 0;
     this.messageSender = void 0;
@@ -9261,6 +9420,7 @@ class SmarticoAPI {
     this.gamesApiUrl = void 0;
     this.baseRgApiParams = void 0;
     this.avatarDomain = void 0;
+    this.avatarOriginDomain = void 0;
     this.envId = void 0;
     this.logger = void 0;
     this.logCIDs = void 0;
@@ -9288,6 +9448,7 @@ class SmarticoAPI {
       };
     }
     this.avatarDomain = SmarticoAPI.getAvatarUrl(label_api_key || ((_options$tracker = options.tracker) == null ? void 0 : _options$tracker.label_api_key));
+    this.avatarOriginDomain = SmarticoAPI.getAvatarOriginUrl(label_api_key || ((_options$tracker2 = options.tracker) == null ? void 0 : _options$tracker2.label_api_key));
     this.label_api_key = SmarticoAPI.getCleanLabelApiKey(label_api_key);
   }
   static getEnvDnsSuffix(label_api_key) {
@@ -9344,6 +9505,9 @@ class SmarticoAPI {
     const avatarUrl = AVATAR_DOMAIN.replace('{ENV_ID}', SmarticoAPI.getEnvDnsSuffix(label_api_key));
     return SmarticoAPI.replaceSmrDomainsWithCloudfront(avatarUrl);
   }
+  static getAvatarOriginUrl(label_api_key) {
+    return AVATAR_DOMAIN.replace('{ENV_ID}', SmarticoAPI.getEnvDnsSuffix(label_api_key));
+  }
   async send(message, expectCID, force_language) {
     if (this.logCIDs.includes(message.cid)) {
       this.logger.info('REQ', message);
@@ -10098,6 +10262,33 @@ class SmarticoAPI {
       throw new Error(`Failed to call games API: ${method}. ${e.message}`);
     }
   }
+  async sendAvatarApi({
+    method,
+    body
+  }) {
+    if (!this.tracker) {
+      throw new Error(`Avatar APIs are not available in the visitor mode`);
+    }
+    const url = `${this.avatarOriginDomain}/${method}`;
+    try {
+      const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+          'Accept': 'application/json',
+          'Content-Type': 'application/json'
+        },
+        body: JSON.stringify(body)
+      });
+      const data = await response.json();
+      return SmarticoAPI.replaceSmrDomainsWithCloudfront(data);
+    } catch (e) {
+      this.logger.error(`Failed to call avatar API: ${method}`, {
+        url,
+        error: e.message
+      });
+      throw new Error(`Failed to call avatar API: ${method}. ${e.message}`);
+    }
+  }
   async gpGetActiveRounds(saw_template_id) {
     const params = {
       ext_game_id: saw_template_id
@@ -10205,6 +10396,21 @@ class SmarticoAPI {
     });
     return await this.send(message, ClassId.CLIENT_SET_AVATAR_RESPONSE);
   }
+  async avatarsCustomize(params) {
+    var _this$tracker, _this$tracker2;
+    return this.sendAvatarApi({
+      method: 'avatar-customize',
+      body: {
+        label_id: params.label_id,
+        user_id: params.user_id,
+        user_ext_id: (_this$tracker = this.tracker) == null ? void 0 : _this$tracker.getExtUserId(),
+        brand_key: this.brand_api_key || ((_this$tracker2 = this.tracker) == null || (_this$tracker2 = _this$tracker2.params) == null ? void 0 : _this$tracker2.brand_key),
+        prompt_id: params.prompt_id,
+        avatar_url: params.avatar_url,
+        avatar_real_id: params.avatar_real_id
+      }
+    });
+  }
   async avatarsGetListT(user_ext_id) {
     var _await$this$avatarsGe;
     return avatarDefinitionTransform((_await$this$avatarsGe = (await this.avatarsGetList(user_ext_id)).avatars) != null ? _await$this$avatarsGe : [], this.avatarDomain);
@@ -10878,43 +11084,52 @@ var JackpotType;
   JackpotType[JackpotType["Personal"] = 2] = "Personal";
 })(JackpotType || (JackpotType = {}));
 
+/**
+ * Limit error codes returned in `errCode` by the `avatarsCustomize` method.
+ * See the `avatarsCustomize` TSDoc for the full table (including the generic
+ * `-1` failure, which has no named member here).
+ */
 var AvatarCustomizeErrorCode;
 (function (AvatarCustomizeErrorCode) {
+  /** The user has reached the operator-configured per-user monthly cap on custom-avatar generations. */
   AvatarCustomizeErrorCode[AvatarCustomizeErrorCode["AVATAR_USER_LIMIT"] = 12001] = "AVATAR_USER_LIMIT";
+  /** The brand's operator-configured shared monthly pool of custom-avatar generations is exhausted. */
   AvatarCustomizeErrorCode[AvatarCustomizeErrorCode["AVATAR_LABEL_LIMIT"] = 12002] = "AVATAR_LABEL_LIMIT";
 })(AvatarCustomizeErrorCode || (AvatarCustomizeErrorCode = {}));
-const AvatarCustomizeErrorMessage = {
-  [AvatarCustomizeErrorCode.AVATAR_USER_LIMIT]: 'You have exceeded number of custom avatars creation, please try later',
-  [AvatarCustomizeErrorCode.AVATAR_LABEL_LIMIT]: 'The custom avatars are not available, please try again later'
-};
 
-/*
- *  Possible error codes returned in JOIN_CLAN_RESPONSE.errCode (cid: 575).
- *  Clan-protocol-specific numeric codes defined in the handler spec.
+/**
+ * Error codes returned in `errCode` by the `joinClan` method (also carried
+ * on `TClanJoinResult`). These are terse value definitions for lookup; the
+ * full per-code narrative and UI handling lives in the `joinClan` method
+ * TSDoc, which owns the error table.
  */
 var JoinClanErrorCode;
 (function (JoinClanErrorCode) {
-  /** No error, join completed */
+  /** Success — join completed; entry fee (if any) deducted. */
   JoinClanErrorCode[JoinClanErrorCode["JOIN_CLAN_OK"] = 0] = "JOIN_CLAN_OK";
-  /** Invalid parameters */
+  /** Request was malformed (missing or invalid parameters). */
   JoinClanErrorCode[JoinClanErrorCode["JOIN_CLAN_INVALID_PARAMETERS"] = 1000] = "JOIN_CLAN_INVALID_PARAMETERS";
-  /** clan_id doesn't exist for this label */
+  /** Clan doesn't exist for this label. Archived clans are also reported as `1001`. */
   JoinClanErrorCode[JoinClanErrorCode["JOIN_CLAN_NOT_FOUND"] = 1001] = "JOIN_CLAN_NOT_FOUND";
-  /** members_count >= capacity_limit */
+  /** Clan is full — member capacity reached. */
   JoinClanErrorCode[JoinClanErrorCode["JOIN_CLAN_FULL"] = 1002] = "JOIN_CLAN_FULL";
-  /** Not enough Points / Gems / Diamonds for entry fee */
+  /** Insufficient balance for the entry fee (points / gems / diamonds). */
   JoinClanErrorCode[JoinClanErrorCode["JOIN_CLAN_INSUFFICIENT_FUNDS"] = 1003] = "JOIN_CLAN_INSUFFICIENT_FUNDS";
-  /** User doesn't satisfy entry_conditions / entry_segment_id */
+  /** User doesn't meet the clan's entry segment or conditions. */
   JoinClanErrorCode[JoinClanErrorCode["JOIN_CLAN_SEGMENT_MISMATCH"] = 1004] = "JOIN_CLAN_SEGMENT_MISMATCH";
-  /** User is not in a clan */
+  /**
+   * User is not in a clan. Note: a `registerInTournament` response code
+   * that shares this enum — never returned by `joinClan`.
+   */
   JoinClanErrorCode[JoinClanErrorCode["JOIN_CLAN_USER_IS_NOT_IN_CLAN"] = 1005] = "JOIN_CLAN_USER_IS_NOT_IN_CLAN";
-  /** User is within the CLAN_COOLDOWN_DAYS window */
+  /** User is within the clan-switch cooldown window (switch only). */
   JoinClanErrorCode[JoinClanErrorCode["JOIN_CLAN_COOLDOWN_ACTIVE"] = 1006] = "JOIN_CLAN_COOLDOWN_ACTIVE";
-  /** clan_status_id != 1 (clan is archived) */
-  JoinClanErrorCode[JoinClanErrorCode["JOIN_CLAN_ARCHIVED"] = 1007] = "JOIN_CLAN_ARCHIVED";
-  /** Clan joined after tournament start */
+  /**
+   * Clan joined after tournament start. Note: a `registerInTournament`
+   * response code that shares this enum — never returned by `joinClan`.
+   */
   JoinClanErrorCode[JoinClanErrorCode["JOIN_CLAN_JOINED_AFTER_TOURNAMENT_START"] = 1011] = "JOIN_CLAN_JOINED_AFTER_TOURNAMENT_START";
 })(JoinClanErrorCode || (JoinClanErrorCode = {}));
 
-export { AchCategoryTransform, AchCustomLayoutTheme, AchCustomSectionType, AchMissionsTabsOptions, AchOverviewMissionsFilter, AchievementAvailabilityStatus, AchievementClaimPeriodTypeId, AchievementStatus, AchievementTaskType, AchievementType, ActivityLogTransform, ActivityTypeLimited, AllRoundsGameBoardID, AnalyticsInboxSubScreenNameId, AnalyticsInterfaceType, AnalyticsScreenNameId, AnalyticsTournamentsLobbySubScreenNameId, AttemptPeriodType, AvatarCustomizeErrorCode, AvatarCustomizeErrorMessage, BadgesTimeLimitStates, BonusItemsTransform, BonusStatus, BuyStoreItemErrorCode, ClassId, CookieStore, CoreUtils, ECacheContext, GPRoundStatus, GamePickMarketType, GamePickResolutionType, GamePickScoreType, GamePickSportType, GameRoundOrderType, GetJackpotEligibleGamesResponseTransform, GetJackpotWinnersResponseTransform, GetLevelMapResponseTransform, InboxCategories, InboxMessageBodyTransform, InboxMessageType, InboxMessagesTransform, InboxReadStatus, JackPotTemparature, JackpotContributionType, JackpotType, JoinClanErrorCode, LeaderBoardPeriodType, LiquidEntityData, MiniGamePrizeTypeName, MiniGamePrizeTypeNamed, MissionCategory, MissionUtils, OCache, OpenLinksType, PointChangeSourceType, PrizeModifiers, PrizeModifiersKeysNames, PublicLabelSettings, QuizAnswersValueType, QuizMarketPerSport, QuizSportType, RaffleDrawInstanceState, RaffleDrawTypeExecution, RaffleTicketCapVisualization, SAWAcknowledgeType, SAWAcknowledgeTypeName, SAWAcknowledgeTypeNamed, SAWAskForUsername, SAWBuyInType, SAWBuyInTypeName, SAWBuyInTypeNamed, SAWExposeUserSpinId, SAWExposeUserSpinIdName, SAWExposeUserSpinIdNamed, SAWGPMarketType, SAWGameDifficultyType, SAWGameDifficultyTypeName, SAWGameLayout, SAWGameLayoutName, SAWGameLayoutNamed, SAWGameType, SAWGameTypeName, SAWGameTypeNamed, SAWHistoryTransform, SAWPrizeType, SAWSpinErrorCode, SAWTemplatesTransform, SAWUtils, SAWWheelLayout, SAWWinSoundFiles, SAWWinSoundType, SawGameDifficultyTypeNamed, ScheduledMissionType, SmarticoAPI, StoreCategoryTransform, StoreItemPurchaseType, StoreItemPurchasedTransform, StoreItemTransform, StoreItemType, StoreItemTypeName, StoreItemTypeNamed, TournamentInstanceStatus, TournamentInstanceStatusName, TournamentItemsTransform, TournamentRegistrationError, TournamentRegistrationStatus, TournamentRegistrationStatusName, TournamentRegistrationStatusNamed, TournamentRegistrationType, TournamentRegistrationTypeGetName, TournamentType, TournamentUtils, TranslationArea, UICustomSectionTransform, UserAchievementTransform, UserBalanceType, WSAPI, avatarCustomizedTransform, avatarDefinitionTransform, avatarPromptTransform, clanTournamentPlayersTransform, drawRunHistoryTransform, drawRunTransform, drawTransform, enrichUserAchievementsWithBadgeState, getLeaderBoardTransform, marketsInfo, prizeTransform, quizAnswerAwayTeamReplacementText, quizAnswerHomeTeamReplacementText, quizAnswersTrKeys, quizDrawReplacementText, quizEvenReplacementText, quizNoGoalsReplacementText, quizNoReplacementText, quizOddReplacementText, quizOrReplacementText, quizSupportedSports, quizYesReplacementText, raffleClaimPrizeResponseTransform, raffleTransform, ticketsTransform, tournamentInfoItemTransform, winnersTransform };
+export { AchCategoryTransform, AchCustomLayoutTheme, AchCustomSectionType, AchMissionsTabsOptions, AchOverviewMissionsFilter, AchievementAvailabilityStatus, AchievementClaimPeriodTypeId, AchievementStatus, AchievementTaskType, AchievementType, ActivityLogTransform, ActivityTypeLimited, AllRoundsGameBoardID, AnalyticsInboxSubScreenNameId, AnalyticsInterfaceType, AnalyticsScreenNameId, AnalyticsTournamentsLobbySubScreenNameId, AttemptPeriodType, AvatarCustomizeErrorCode, BadgesTimeLimitStates, BonusItemsTransform, BonusStatus, BuyStoreItemErrorCode, ClassId, CookieStore, CoreUtils, ECacheContext, GPRoundStatus, GamePickMarketType, GamePickResolutionType, GamePickScoreType, GamePickSportType, GameRoundOrderType, GetJackpotEligibleGamesResponseTransform, GetJackpotWinnersResponseTransform, GetLevelMapResponseTransform, InboxCategories, InboxMessageBodyTransform, InboxMessageType, InboxMessagesTransform, InboxReadStatus, JackPotTemparature, JackpotContributionType, JackpotType, JoinClanErrorCode, LeaderBoardPeriodType, LiquidEntityData, MiniGamePrizeTypeName, MiniGamePrizeTypeNamed, MissionCategory, MissionUtils, OCache, OpenLinksType, PointChangeSourceType, PrizeModifiers, PrizeModifiersKeysNames, PublicLabelSettings, QuizAnswersValueType, QuizMarketPerSport, QuizSportType, RaffleDrawInstanceState, RaffleDrawTypeExecution, RaffleTicketCapVisualization, SAWAcknowledgeType, SAWAcknowledgeTypeName, SAWAcknowledgeTypeNamed, SAWAskForUsername, SAWBuyInType, SAWBuyInTypeName, SAWBuyInTypeNamed, SAWExposeUserSpinId, SAWExposeUserSpinIdName, SAWExposeUserSpinIdNamed, SAWGPMarketType, SAWGameDifficultyType, SAWGameDifficultyTypeName, SAWGameLayout, SAWGameLayoutName, SAWGameLayoutNamed, SAWGameType, SAWGameTypeName, SAWGameTypeNamed, SAWHistoryTransform, SAWPrizeType, SAWSpinErrorCode, SAWTemplatesTransform, SAWUtils, SAWWheelLayout, SAWWinSoundFiles, SAWWinSoundType, SawGameDifficultyTypeNamed, ScheduledMissionType, SmarticoAPI, StoreCategoryTransform, StoreItemPurchaseType, StoreItemPurchasedTransform, StoreItemTransform, StoreItemType, StoreItemTypeName, StoreItemTypeNamed, TournamentInstanceStatus, TournamentInstanceStatusName, TournamentItemsTransform, TournamentRegistrationError, TournamentRegistrationStatus, TournamentRegistrationStatusName, TournamentRegistrationStatusNamed, TournamentRegistrationType, TournamentRegistrationTypeGetName, TournamentType, TournamentUtils, TranslationArea, UICustomSectionTransform, UserAchievementTransform, UserBalanceType, WSAPI, avatarCustomizedTransform, avatarDefinitionTransform, avatarPromptTransform, clanTournamentPlayersTransform, drawRunHistoryTransform, drawRunTransform, drawTransform, enrichUserAchievementsWithBadgeState, getLeaderBoardTransform, marketsInfo, prizeTransform, quizAnswerAwayTeamReplacementText, quizAnswerHomeTeamReplacementText, quizAnswersTrKeys, quizDrawReplacementText, quizEvenReplacementText, quizNoGoalsReplacementText, quizNoReplacementText, quizOddReplacementText, quizOrReplacementText, quizSupportedSports, quizYesReplacementText, raffleClaimPrizeResponseTransform, raffleTransform, ticketsTransform, tournamentInfoItemTransform, winnersTransform };
 //# sourceMappingURL=index.modern.mjs.map