@smartico/public-api 0.0.425 → 0.0.427

package/dist/Core/PublicLabelSettings.d.ts

@@ -6,6 +6,8 @@ export declare enum PublicLabelSettings {
     GAMIFICATION_UI_WIDGET = "GAMIFICATION_UI_WIDGET",
     GAMIFICATION_UI_MINI_GAME = "GAMIFICATION_UI_MINI_GAME",
     GAMIFICATION_UI_SETTINGS = "GAMIFICATION_UI_SETTINGS",
+    GAMIFICATION_UI_SETTINGS_V2 = "GAMIFICATION_UI_SETTINGS_V2",
+    GAMIFICATION_UI_SETTINGS_TEST_V2 = "GAMIFICATION_UI_SETTINGS_TEST_V2",
     GAMIFICATION_UI_MAIN_TEST = "GAMIFICATION_UI_MAIN_TEST",
     GAMIFICATION_UI_WIDGET_TEST = "GAMIFICATION_UI_WIDGET_TEST",
     GAMIFICATION_UI_SETTINGS_TEST = "GAMIFICATION_UI_SETTINGS_TEST",

package/dist/Missions/BadgesTimeLimitStates.d.ts

@@ -10,5 +10,10 @@ export declare enum BadgesTimeLimitStates {
     /** After End Date (not started) */
     AfterEndDateNotStarted = 4,
     /** After End Date (player has some progress, but not completed) */
-    AfterEndDateWithProgress = 5
+    AfterEndDateWithProgress = 5,
+    /**
+     * After Start Date, player has some progress, and the badge has no End Date.
+     * The badge is still earnable — do not render it as expired.
+     */
+    AfterStartDateWithProgress = 6
 }

package/dist/Raffle/RaffleDraw.d.ts

@@ -7,19 +7,25 @@ export declare enum RaffleDrawInstanceState {
     /** Winner selection is in progress */
     WinnerSelection = 2,
     /** Draw is executed and the winners are selected */
-    Executed = 3
+    Executed = 3,
+    /**
+     * Draw was cancelled and will never be executed.
+     * Treat it as a terminal state: stop any polling of the draw run
+     * and do not show the winner-selection progress UI.
+     */
+    Cancelled = 4
 }
 export declare enum RaffleDrawTypeExecution {
     /** Draw is executed only once */
-    ExecDate = 0,
+    ExecDate = 1,
     /** Draw is executed on a recurring basis */
-    Recurring = 1,
+    Recurring = 2,
     /**
      * Draw is executed once and is marked as grand.
      * This means it is a special or significant draw,
      * often with larger prizes or more importance.
      */
-    Grand = 2
+    Grand = 3
 }
 interface RaffleDraw {
     /**

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, TClans, TClanInfo, TClanJoinResult, TClanTournamentPlayers } from './WSAPI/WSAPITypes';
+import { TInboxMessage, TInboxMessageBody, TLevel, TMiniGameTemplate, TMissionOrBadge, TStoreCategory, TAchCategory, TStoreItem, TTournament, TTournamentDetailed, LeaderBoardDetailsT, LeaderBoardSettingsT, 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';
@@ -162,6 +162,8 @@ declare class SmarticoAPI {
     leaderboardsGetT(user_ext_id: string, period_type_id?: LeaderBoardPeriodType, prevPeriod?: boolean | number): Promise<LeaderBoardDetailsT>;
     leaderboardsGetList(user_ext_id: string, force_language?: string): Promise<LeaderBoardDetails[]>;
     leaderboardsGetListT(user_ext_id: string): Promise<LeaderBoardDetailsT[]>;
+    leaderboardsGetSettings(): LeaderBoardSettingsT;
+    private getGamificationUISettings;
     levelsGet(user_ext_id: string, force_language?: string): Promise<GetLevelMapResponse>;
     levelsGetT(user_ext_id: string): Promise<TLevel[]>;
     getLevelCurrent(user_ext_id: string): Promise<TLevelCurrent>;

package/dist/SmarticoGlobal.d.ts

@@ -154,6 +154,8 @@ export interface SmarticoGlobal {
     suspendInbox(flag: boolean): void;
     /** Temporarily suspend/resume mini-games. */
     suspendMiniGames(flag: boolean): void;
+    /** Temporarily suspend/resume forms. */
+    suspendForms(flag: boolean): void;
     /** Show a visitor-mode game. */
     showVisitorGame(params: Record<string, unknown>): void;
     /** Convert a visitor-mode win into an identified reward. */

package/dist/WSAPI/WSAPILeaderBoard.d.ts

@@ -1,4 +1,4 @@
-import { LeaderBoardDetailsT } from './WSAPITypes';
+import { LeaderBoardDetailsT, LeaderBoardSettingsT } from './WSAPITypes';
 import { LeaderBoardPeriodType } from '../Leaderboard';
 import { WSAPIGamePick } from './WSAPIGamePick';
 /** @group LeaderBoard */
@@ -194,4 +194,52 @@ export declare class WSAPILeaderBoard extends WSAPIGamePick {
      * ```
      */
     getLeaderBoards(): Promise<LeaderBoardDetailsT[]>;
+    /**
+     * Returns the operator's privacy configuration for leaderboard rendering.
+     * Apply it to every leaderboard row you draw — the standings returned by
+     * {@link getLeaderBoard} always carry `avatar_url`, `level_id` and
+     * `points`, so honouring these flags is the consumer's responsibility.
+     * Ignoring them surfaces data the operator asked to keep private.
+     *
+     * @remarks
+     * **Flags** — each is `true` when the corresponding data must be hidden:
+     * - `hide_avatars` — draw rows without the player avatar.
+     * - `hide_levels` — draw rows without the player's level name.
+     * - `hide_other_points` — hide `points` for every row except the current
+     *   user's. The current user always sees their own points.
+     *
+     * **Defaults on an unconfigured label** — `hide_avatars` and
+     * `hide_levels` default to `false` (show), while `hide_other_points`
+     * defaults to `true` (hide) unless the operator explicitly turned it off.
+     * The asymmetry is intentional: it matches the default Smartico UI, so a
+     * consumer rendering its own leaderboard next to the built-in one agrees
+     * with it rather than exposing points the built-in surface hides.
+     *
+     * **Synchronous** — the settings arrive with the session handshake, so
+     * this returns immediately and never issues a round-trip. Call it on
+     * every render rather than caching the result yourself.
+     *
+     * **Idempotency / Side effects**: safe. Read-only.
+     *
+     * **Visitor mode**: supported. Returns the same label-level configuration.
+     *
+     * @returns The resolved leaderboard privacy flags. Never `null`.
+     *
+     * @example
+     * ```ts
+     * import { LeaderBoardPeriodType } from '@smartico/public-api';
+     *
+     * const settings = window._smartico.api.getLeaderBoardSettings();
+     * const board = await window._smartico.api.getLeaderBoard(LeaderBoardPeriodType.WEEKLY);
+     *
+     * for (const row of board?.users ?? []) {
+     *   const showPoints = row.is_me || !settings.hide_other_points;
+     *
+     *   console.log('[smartico] render row', row.position, row.public_username,
+     *     settings.hide_avatars ? '(no avatar)' : row.avatar_url,
+     *     showPoints ? row.points : '(points hidden)');
+     * }
+     * ```
+     */
+    getLeaderBoardSettings(): LeaderBoardSettingsT;
 }

package/dist/WSAPI/WSAPIMissions.d.ts

@@ -195,7 +195,11 @@ export declare class WSAPIMissions extends WSAPIGeneral {
      * as undefined / default. Time windows are absolute calendar timestamps
      * (`active_from_ts` / `active_till_ts`), not opt-in-relative durations —
      * drive availability chips from the SDK-computed `badgeTimeLimitState`
-     * (enum {@link BadgesTimeLimitStates}), not `time_limit_ms`. Locking for
+     * (enum {@link BadgesTimeLimitStates}), not `time_limit_ms`. A badge
+     * with no `active_till_ts` is open-ended and never reaches the
+     * "after end date" states — it reports `AfterStartDateNoProgress`
+     * or `AfterStartDateWithProgress` — so it must never be rendered as
+     * expired. Locking for
      * badges is purely time-based: `is_locked` is `true` only when
      * `badgeTimeLimitState === BadgesTimeLimitStates.BeforeStartDate` (the
      * time window hasn't started yet). The primary navigation field is

package/dist/WSAPI/WSAPIRaffles.d.ts

@@ -48,8 +48,12 @@ export declare class WSAPIRaffles extends WSAPIJackpots {
      *   sold-out message).
      * - Within each draw, `current_state`
      *   ({@link RaffleDrawInstanceState}) buckets the draw into Open
-     *   (accepting tickets), WinnerSelection (currently drawing), or
-     *   Executed (winners selected).
+     *   (accepting tickets), WinnerSelection (currently drawing),
+     *   Executed (winners selected), or Cancelled (will never run).
+     *   Treat every state other than Open and WinnerSelection as
+     *   terminal — stop polling the draw run and clear any
+     *   "drawing in progress" indicator, otherwise a cancelled draw
+     *   leaves the UI spinning forever.
      * - `execution_type` ({@link RaffleDrawTypeExecution}) distinguishes
      *   one-shot (`ExecDate`), repeating (`Recurring`), or special
      *   one-shot (`Grand`) draws. Recurring draws share a stable

package/dist/WSAPI/WSAPITournaments.d.ts

@@ -41,6 +41,12 @@ export declare class WSAPITournaments extends WSAPIStore {
      * tournaments not yet published. SDK consumers receive only items
      * the user is eligible to see; no client-side gating is required.
      *
+     * Client-side filtering you may still want: tournaments with
+     * `only_in_custom_section: true` are intended for their custom-section
+     * view only and should be hidden from the main lobby list — including
+     * from any per-tab counters rendered next to the tab labels, otherwise
+     * the counts disagree with the number of cards the user can see.
+     *
      * **Reading state from the returned item**
      * Drive list bucketing and CTA labels from the SDK-computed booleans
      * (`is_active`, `is_can_register`, `is_cancelled`, `is_finished`,
@@ -105,19 +111,22 @@ export declare class WSAPITournaments extends WSAPIStore {
      *   },
      * });
      *
+     * // Main lobby list — custom-section-only tournaments belong to that section's own view.
+     * const lobby = tournaments.filter(t => !t.only_in_custom_section);
+     *
      * // Bucket items by lifecycle state for a tabbed UI.
-     * const live = tournaments.filter(t => t.is_in_progress);
-     * const upcoming = tournaments
+     * const live = lobby.filter(t => t.is_in_progress);
+     * const upcoming = lobby
      *   .filter(t => t.is_upcoming && !t.is_user_registered)
      *   .sort((a, b) => a.start_time - b.start_time);
-     * const mine = tournaments.filter(t => t.is_user_registered);
-     * const finished = tournaments.filter(t => t.is_finished);
+     * const mine = lobby.filter(t => t.is_user_registered);
+     * const finished = lobby.filter(t => t.is_finished);
      *
      * console.log('[smartico] render lobby tabs with these counts: live=', live.length,
      *   'upcoming=', upcoming.length, 'mine=', mine.length, 'finished=', finished.length);
      *
      * // Featured tournament: pin to position 0 of the Overview/Top tabs.
-     * const featured = tournaments.find(t => t.is_featured && !t.is_cancelled);
+     * const featured = lobby.find(t => t.is_featured && !t.is_cancelled);
      * if (featured) {
      *   console.log('[smartico] featured tournament — pin to position 0 of the Overview tab:', featured.name);
      * }

package/dist/WSAPI/WSAPITypes.d.ts

@@ -364,6 +364,8 @@ export interface TTournament {
      * The list of custom sections can be retrieved using _smartico.api.getCustomSections() method
      */
     custom_section_id: number;
+    /** The indicator if the tournament is visible only in the custom section and should be hidden from the main overview of tournaments */
+    only_in_custom_section?: boolean;
     /** The custom data of the tournament defined by operator. Can be a JSON object, string or number */
     custom_data: any;
     /** The indicator if the tournament is 'Featured' */
@@ -1126,6 +1128,21 @@ export interface LeaderBoardDetailsT {
      * unranked / outside the ranked window. */
     me?: LeaderBoardUserT;
 }
+/**
+ * LeaderBoardSettingsT carries the operator's privacy configuration for
+ * leaderboard rendering. Every flag means "hide" when `true`.
+ */
+export interface LeaderBoardSettingsT {
+    /** When `true`, render leaderboard rows without player avatars. */
+    hide_avatars: boolean;
+    /** When `true`, render leaderboard rows without player level names. */
+    hide_levels: boolean;
+    /**
+     * When `true`, hide the points of every player except the current user.
+     * The current user's own points are always shown, regardless of this flag.
+     */
+    hide_other_points: boolean;
+}
 /**
  * LeaderBoardsRewardsT describes one place's prize on a leaderboard.
  * Leaderboard prizes are always gamification points (never gems / diamonds / items).
@@ -1346,6 +1363,13 @@ export interface TRaffle {
     image_url: string;
     /** URL of the mobile image that represents the raffle, 300x142px */
     image_url_mobile: string;
+    /**
+     * Terms and Conditions text configured by the operator for this raffle.
+     * Render it as the raffle rules. It is absent or empty when the operator
+     * configured none — hide the rules section in that case rather than
+     * substituting your own copy.
+     */
+    hint_text?: string;
     /**
      * Custom data as string or JSON string that can be used in API to build custom UI
      * You can request from Smartico to define fields for your specific case that will be managed from Smartico BackOffice
@@ -1399,6 +1423,12 @@ export interface TRafflePrize {
      * Can be used to build custom UI for gamification.
      */
     custom_data?: string;
+    /**
+     * Indicates whether the chance to win should be hidden in the UI.
+     * When `true`, do not render `chances_to_win_perc` for this prize.
+     * Absent means "not hidden".
+     */
+    hide_chance_to_win?: boolean;
     /**
      * The number of prizes available per run of the draw.
      * E.g. if the draw is run daily, this is the number of prizes available each day, for example 3 iPhones.

package/dist/index.d.ts

@@ -4,7 +4,7 @@ export * from './SmarticoAPI';
 export * from './WSAPI/WSAPI';
 export * from './SmarticoGlobal';
 export * from './CookieStore';
-export type { TAchCategory, TActivityLog, TActivityLogEntry, TAvatarCustomized, TAvatarDefinition, TAvatarPrompt, TBonus, TBuyStoreItemResult, TClaimBonusResult, TClan, TClanInfo, TClanJoinResult, TClanTournamentPlayers, TClans, TGetTranslations, TInboxMessage, TInboxMessageBody, TLevel, TLevelCurrent, TMiniGamePlayBatchResult, TMiniGamePlayResult, TMiniGamePrize, TMiniGameTemplate, TMissionClaimRewardResult, TMissionOptInResult, TMissionOrBadge, TMissionOrBadgeTask, TRaffle, TRaffleDraw, TRaffleDrawRun, TRaffleOptinResponse, TRafflePrize, TRafflePrizeWinner, TRaffleTicket, TSawHistory, TSegmentCheckResult, TSetAvatarResult, TStoreCategory, TStoreItem, TTournament, TTournamentDetailed, TTournamentRegistrationResult, TUICustomSection, TUserProfile, TransformedRaffleClaimPrizeResponse, InboxMarkMessageAction, LeaderBoardDetailsT, LeaderBoardUserT, LeaderBoardsRewardsT, UserLevelExtraCountersT, } from './WSAPI/WSAPITypes';
+export type { TAchCategory, TActivityLog, TActivityLogEntry, TAvatarCustomized, TAvatarDefinition, TAvatarPrompt, TBonus, TBuyStoreItemResult, TClaimBonusResult, TClan, TClanInfo, TClanJoinResult, TClanTournamentPlayers, TClans, TGetTranslations, TInboxMessage, TInboxMessageBody, TLevel, TLevelCurrent, TMiniGamePlayBatchResult, TMiniGamePlayResult, TMiniGamePrize, TMiniGameTemplate, TMissionClaimRewardResult, TMissionOptInResult, TMissionOrBadge, TMissionOrBadgeTask, TRaffle, TRaffleDraw, TRaffleDrawRun, TRaffleOptinResponse, TRafflePrize, TRafflePrizeWinner, TRaffleTicket, TSawHistory, TSegmentCheckResult, TSetAvatarResult, TStoreCategory, TStoreItem, TTournament, TTournamentDetailed, TTournamentRegistrationResult, TUICustomSection, TUserProfile, TransformedRaffleClaimPrizeResponse, InboxMarkMessageAction, LeaderBoardDetailsT, LeaderBoardUserT, LeaderBoardsRewardsT, LeaderBoardSettingsT, UserLevelExtraCountersT, } from './WSAPI/WSAPITypes';
 export * from './Analytics';
 export * from './Core';
 export * from './UserProfile';

package/dist/index.js

@@ -904,6 +904,8 @@ exports.PublicLabelSettings = void 0;
   PublicLabelSettings["GAMIFICATION_UI_WIDGET"] = "GAMIFICATION_UI_WIDGET";
   PublicLabelSettings["GAMIFICATION_UI_MINI_GAME"] = "GAMIFICATION_UI_MINI_GAME";
   PublicLabelSettings["GAMIFICATION_UI_SETTINGS"] = "GAMIFICATION_UI_SETTINGS";
+  PublicLabelSettings["GAMIFICATION_UI_SETTINGS_V2"] = "GAMIFICATION_UI_SETTINGS_V2";
+  PublicLabelSettings["GAMIFICATION_UI_SETTINGS_TEST_V2"] = "GAMIFICATION_UI_SETTINGS_TEST_V2";
   PublicLabelSettings["GAMIFICATION_UI_MAIN_TEST"] = "GAMIFICATION_UI_MAIN_TEST";
   PublicLabelSettings["GAMIFICATION_UI_WIDGET_TEST"] = "GAMIFICATION_UI_WIDGET_TEST";
   PublicLabelSettings["GAMIFICATION_UI_SETTINGS_TEST"] = "GAMIFICATION_UI_SETTINGS_TEST";
@@ -1314,6 +1316,11 @@ exports.BadgesTimeLimitStates = void 0;
   BadgesTimeLimitStates[BadgesTimeLimitStates["AfterEndDateNotStarted"] = 4] = "AfterEndDateNotStarted";
   /** After End Date (player has some progress, but not completed) */
   BadgesTimeLimitStates[BadgesTimeLimitStates["AfterEndDateWithProgress"] = 5] = "AfterEndDateWithProgress";
+  /**
+   * After Start Date, player has some progress, and the badge has no End Date.
+   * The badge is still earnable — do not render it as expired.
+   */
+  BadgesTimeLimitStates[BadgesTimeLimitStates["AfterStartDateWithProgress"] = 6] = "AfterStartDateWithProgress";
 })(exports.BadgesTimeLimitStates || (exports.BadgesTimeLimitStates = {}));
 
 var _MissionUtils;
@@ -1580,8 +1587,7 @@ MissionUtils.determineBadgeState = function (badge) {
     if (progress === 0) {
       return exports.BadgesTimeLimitStates.AfterStartDateNoProgress;
     }
-    // If infinite and with progress → this state does not exist in enum
-    // (but if needed we can add one)
+    return exports.BadgesTimeLimitStates.AfterStartDateWithProgress;
   }
   // 3. AFTER START, BEFORE END DATE
   if (now < active_till_ts) {
@@ -1936,6 +1942,7 @@ var TournamentItemsTransform = function TournamentItemsTransform(items) {
       prize_pool_short: r.publicMeta.prize_pool_short,
       custom_price_text: r.publicMeta.custom_price_text,
       custom_section_id: r.publicMeta.custom_section_id,
+      only_in_custom_section: r.publicMeta.only_in_custom_section,
       custom_data: IntUtils.JsonOrText(r.publicMeta.custom_data),
       is_featured: r.publicMeta.featured,
       ribbon: r.publicMeta.label_tag === 'custom' ? r.publicMeta.custom_label_tag : r.publicMeta.label_tag,
@@ -2328,6 +2335,7 @@ var prizeTransform = function prizeTransform(items) {
       description: item.public_meta.description,
       image_url: item.public_meta.image_url,
       custom_data: item.public_meta.custom_data,
+      hide_chance_to_win: item.public_meta.hide_chance_to_win,
       prizes_per_run: item.prizes_per_run,
       prizes_per_run_actual: item.prizes_per_run_actual,
       chances_to_win_perc: item.chances_to_win_perc,
@@ -2386,6 +2394,7 @@ var raffleTransform = function raffleTransform(items) {
       custom_section_id: item.public_meta.custom_section_id,
       image_url: item.public_meta.image_url,
       image_url_mobile: item.public_meta.image_url_mobile,
+      hint_text: item.public_meta.hint_text,
       custom_data: item.public_meta.custom_data,
       start_date: item.start_date_ts,
       end_date: item.end_date_ts,
@@ -2449,19 +2458,25 @@ exports.RaffleDrawInstanceState = void 0;
   RaffleDrawInstanceState[RaffleDrawInstanceState["WinnerSelection"] = 2] = "WinnerSelection";
   /** Draw is executed and the winners are selected */
   RaffleDrawInstanceState[RaffleDrawInstanceState["Executed"] = 3] = "Executed";
+  /**
+   * Draw was cancelled and will never be executed.
+   * Treat it as a terminal state: stop any polling of the draw run
+   * and do not show the winner-selection progress UI.
+   */
+  RaffleDrawInstanceState[RaffleDrawInstanceState["Cancelled"] = 4] = "Cancelled";
 })(exports.RaffleDrawInstanceState || (exports.RaffleDrawInstanceState = {}));
 exports.RaffleDrawTypeExecution = void 0;
 (function (RaffleDrawTypeExecution) {
   /** Draw is executed only once */
-  RaffleDrawTypeExecution[RaffleDrawTypeExecution["ExecDate"] = 0] = "ExecDate";
+  RaffleDrawTypeExecution[RaffleDrawTypeExecution["ExecDate"] = 1] = "ExecDate";
   /** Draw is executed on a recurring basis */
-  RaffleDrawTypeExecution[RaffleDrawTypeExecution["Recurring"] = 1] = "Recurring";
+  RaffleDrawTypeExecution[RaffleDrawTypeExecution["Recurring"] = 2] = "Recurring";
   /**
    * Draw is executed once and is marked as grand.
    * This means it is a special or significant draw,
    * often with larger prizes or more importance.
    */
-  RaffleDrawTypeExecution[RaffleDrawTypeExecution["Grand"] = 2] = "Grand";
+  RaffleDrawTypeExecution[RaffleDrawTypeExecution["Grand"] = 3] = "Grand";
 })(exports.RaffleDrawTypeExecution || (exports.RaffleDrawTypeExecution = {}));
 
 /** @hidden */
@@ -3579,7 +3594,11 @@ var WSAPIMissions = /*#__PURE__*/function (_WSAPIGeneral) {
    * as undefined / default. Time windows are absolute calendar timestamps
    * (`active_from_ts` / `active_till_ts`), not opt-in-relative durations —
    * drive availability chips from the SDK-computed `badgeTimeLimitState`
-   * (enum {@link BadgesTimeLimitStates}), not `time_limit_ms`. Locking for
+   * (enum {@link BadgesTimeLimitStates}), not `time_limit_ms`. A badge
+   * with no `active_till_ts` is open-ended and never reaches the
+   * "after end date" states — it reports `AfterStartDateNoProgress`
+   * or `AfterStartDateWithProgress` — so it must never be rendered as
+   * expired. Locking for
    * badges is purely time-based: `is_locked` is `true` only when
    * `badgeTimeLimitState === BadgesTimeLimitStates.BeforeStartDate` (the
    * time window hasn't started yet). The primary navigation field is
@@ -5075,6 +5094,12 @@ var WSAPITournaments = /*#__PURE__*/function (_WSAPIStore) {
    * tournaments not yet published. SDK consumers receive only items
    * the user is eligible to see; no client-side gating is required.
    *
+   * Client-side filtering you may still want: tournaments with
+   * `only_in_custom_section: true` are intended for their custom-section
+   * view only and should be hidden from the main lobby list — including
+   * from any per-tab counters rendered next to the tab labels, otherwise
+   * the counts disagree with the number of cards the user can see.
+   *
    * **Reading state from the returned item**
    * Drive list bucketing and CTA labels from the SDK-computed booleans
    * (`is_active`, `is_can_register`, `is_cancelled`, `is_finished`,
@@ -5139,19 +5164,22 @@ var WSAPITournaments = /*#__PURE__*/function (_WSAPIStore) {
    *   },
    * });
    *
+   * // Main lobby list — custom-section-only tournaments belong to that section's own view.
+   * const lobby = tournaments.filter(t => !t.only_in_custom_section);
+   *
    * // Bucket items by lifecycle state for a tabbed UI.
-   * const live = tournaments.filter(t => t.is_in_progress);
-   * const upcoming = tournaments
+   * const live = lobby.filter(t => t.is_in_progress);
+   * const upcoming = lobby
    *   .filter(t => t.is_upcoming && !t.is_user_registered)
    *   .sort((a, b) => a.start_time - b.start_time);
-   * const mine = tournaments.filter(t => t.is_user_registered);
-   * const finished = tournaments.filter(t => t.is_finished);
+   * const mine = lobby.filter(t => t.is_user_registered);
+   * const finished = lobby.filter(t => t.is_finished);
    *
    * console.log('[smartico] render lobby tabs with these counts: live=', live.length,
    *   'upcoming=', upcoming.length, 'mine=', mine.length, 'finished=', finished.length);
    *
    * // Featured tournament: pin to position 0 of the Overview/Top tabs.
-   * const featured = tournaments.find(t => t.is_featured && !t.is_cancelled);
+   * const featured = lobby.find(t => t.is_featured && !t.is_cancelled);
    * if (featured) {
    *   console.log('[smartico] featured tournament — pin to position 0 of the Overview tab:', featured.name);
    * }
@@ -6552,8 +6580,12 @@ var WSAPIRaffles = /*#__PURE__*/function (_WSAPIJackpots) {
    *   sold-out message).
    * - Within each draw, `current_state`
    *   ({@link RaffleDrawInstanceState}) buckets the draw into Open
-   *   (accepting tickets), WinnerSelection (currently drawing), or
-   *   Executed (winners selected).
+   *   (accepting tickets), WinnerSelection (currently drawing),
+   *   Executed (winners selected), or Cancelled (will never run).
+   *   Treat every state other than Open and WinnerSelection as
+   *   terminal — stop polling the draw run and clear any
+   *   "drawing in progress" indicator, otherwise a cancelled draw
+   *   leaves the UI spinning forever.
    * - `execution_type` ({@link RaffleDrawTypeExecution}) distinguishes
    *   one-shot (`ExecDate`), repeating (`Recurring`), or special
    *   one-shot (`Grand`) draws. Recurring draws share a stable
@@ -9365,6 +9397,57 @@ var WSAPILeaderBoard = /*#__PURE__*/function (_WSAPIGamePick) {
     } catch (e) {
       return Promise.reject(e);
     }
+  }
+  /**
+   * Returns the operator's privacy configuration for leaderboard rendering.
+   * Apply it to every leaderboard row you draw — the standings returned by
+   * {@link getLeaderBoard} always carry `avatar_url`, `level_id` and
+   * `points`, so honouring these flags is the consumer's responsibility.
+   * Ignoring them surfaces data the operator asked to keep private.
+   *
+   * @remarks
+   * **Flags** — each is `true` when the corresponding data must be hidden:
+   * - `hide_avatars` — draw rows without the player avatar.
+   * - `hide_levels` — draw rows without the player's level name.
+   * - `hide_other_points` — hide `points` for every row except the current
+   *   user's. The current user always sees their own points.
+   *
+   * **Defaults on an unconfigured label** — `hide_avatars` and
+   * `hide_levels` default to `false` (show), while `hide_other_points`
+   * defaults to `true` (hide) unless the operator explicitly turned it off.
+   * The asymmetry is intentional: it matches the default Smartico UI, so a
+   * consumer rendering its own leaderboard next to the built-in one agrees
+   * with it rather than exposing points the built-in surface hides.
+   *
+   * **Synchronous** — the settings arrive with the session handshake, so
+   * this returns immediately and never issues a round-trip. Call it on
+   * every render rather than caching the result yourself.
+   *
+   * **Idempotency / Side effects**: safe. Read-only.
+   *
+   * **Visitor mode**: supported. Returns the same label-level configuration.
+   *
+   * @returns The resolved leaderboard privacy flags. Never `null`.
+   *
+   * @example
+   * ```ts
+   * import { LeaderBoardPeriodType } from '@smartico/public-api';
+   *
+   * const settings = window._smartico.api.getLeaderBoardSettings();
+   * const board = await window._smartico.api.getLeaderBoard(LeaderBoardPeriodType.WEEKLY);
+   *
+   * for (const row of board?.users ?? []) {
+   *   const showPoints = row.is_me || !settings.hide_other_points;
+   *
+   *   console.log('[smartico] render row', row.position, row.public_username,
+   *     settings.hide_avatars ? '(no avatar)' : row.avatar_url,
+   *     showPoints ? row.points : '(points hidden)');
+   * }
+   * ```
+   */
+  ;
+  _proto.getLeaderBoardSettings = function getLeaderBoardSettings() {
+    return this.api.leaderboardsGetSettings();
   };
   return WSAPILeaderBoard;
 }(WSAPIGamePick);
@@ -11639,6 +11722,43 @@ var SmarticoAPI = /*#__PURE__*/function () {
       return Promise.reject(e);
     }
   };
+  _proto.leaderboardsGetSettings = function leaderboardsGetSettings() {
+    // Defaults match the default Smartico UI when the operator has not
+    // configured the gamification UI settings: avatars and levels are
+    // shown, other players' points are not.
+    var settings = this.getGamificationUISettings();
+    return {
+      hide_avatars: (settings == null ? void 0 : settings.hide_avatars_leaderboards) === true,
+      hide_levels: (settings == null ? void 0 : settings.leaderboard_hide_levels) === true,
+      // Deliberately asymmetric: points stay hidden unless the operator
+      // explicitly opted in by setting the flag to false. This mirrors the
+      // default Smartico UI, so a consumer rendering both surfaces agrees
+      // with it on an unconfigured label.
+      hide_other_points: (settings == null ? void 0 : settings.leaderboard_hide_other_points) !== false
+    };
+  };
+  _proto.getGamificationUISettings = function getGamificationUISettings() {
+    var _this$tracker$userPub;
+    if (!this.tracker) {
+      return null;
+    }
+    var parse = function parse(raw) {
+      if (typeof raw !== 'string' || raw.length === 0) {
+        return null;
+      }
+      try {
+        var parsed = JSON.parse(raw);
+        return parsed && Object.keys(parsed).length ? parsed : null;
+      } catch (e) {
+        return null;
+      }
+    };
+    // Test accounts read the operator's test variant when one is configured;
+    // everyone else reads the live settings.
+    var isTestAccount = ((_this$tracker$userPub = this.tracker.userPublicProps) == null ? void 0 : _this$tracker$userPub.core_is_test_account) === true;
+    var testSettings = isTestAccount ? parse(this.tracker.getLabelSetting(exports.PublicLabelSettings.GAMIFICATION_UI_SETTINGS_TEST_V2)) : null;
+    return testSettings || parse(this.tracker.getLabelSetting(exports.PublicLabelSettings.GAMIFICATION_UI_SETTINGS_V2));
+  };
   _proto.levelsGet = function levelsGet(user_ext_id, force_language) {
     try {
       var _this58 = this;
@@ -11866,11 +11986,11 @@ var SmarticoAPI = /*#__PURE__*/function () {
     }
   };
   _proto.buildGamesApiParams = function buildGamesApiParams() {
-    var _this$tracker$userPub, _this$tracker$userPub2;
+    var _this$tracker$userPub2, _this$tracker$userPub3;
     var params = Object.assign({}, this.baseRgApiParams, {
-      ext_user_id: (_this$tracker$userPub = this.tracker.userPublicProps) == null ? void 0 : _this$tracker$userPub.user_id,
+      ext_user_id: (_this$tracker$userPub2 = this.tracker.userPublicProps) == null ? void 0 : _this$tracker$userPub2.user_id,
       smartico_ext_user_id: this.tracker.getExtUserId(),
-      lang: (_this$tracker$userPub2 = this.tracker.userPublicProps) == null ? void 0 : _this$tracker$userPub2.core_user_language
+      lang: (_this$tracker$userPub3 = this.tracker.userPublicProps) == null ? void 0 : _this$tracker$userPub3.core_user_language
     });
     return params;
   };