@smartico/public-api 0.0.432 → 0.0.434

package/dist/index.modern.mjs

@@ -943,7 +943,9 @@ const InboxMessageBodyTransform = item => {
     icon: item.image,
     title: item.title,
     preview_body: item.body,
-    custom_data: IntUtils.JsonOrText(item == null ? void 0 : item.custom_data)
+    custom_data: IntUtils.JsonOrText(item == null ? void 0 : item.custom_data),
+    show_preview: item.show_preview,
+    show_duration_sec: item.show_duration_sec
   };
   if (item.action === 'dp:inbox') {
     if (item.additional_buttons && item.additional_buttons.length) {
@@ -6062,6 +6064,81 @@ class WSAPIJackpots extends WSAPIClans {
     const cacheKey = `${onUpdateContextKey.JackpotWinners}${jp_template_id}:${limit}:${offset}`;
     return OCache.use(cacheKey, ECacheContext.WSAPI, () => this.api.getJackpotWinnersT(this.userExtId, limit, offset, jp_template_id), JACKPOT_WINNERS_CACHE_SEC);
   }
+  /**
+   * Returns past winners of a specific jackpot template, paginated, together
+   * with the win statistics of that template: total number of wins, the
+   * biggest win and the most recent win. Use it for a jackpot info modal /
+   * tooltip that shows "Total wins", "Highest win" and "Latest win" next to
+   * the winners list.
+   *
+   * @remarks
+   * **Preconditions**
+   * - User must be authenticated. Visitor mode not supported.
+   * - `jp_template_id` is mandatory.
+   * - The consumer SHOULD check
+   *   `JackpotDetails.expose_winners_over_api` before calling, since
+   *   the server does not enforce it.
+   *
+   * **Statistics**
+   * - `win_stats` describes the whole jackpot template and does not depend
+   *   on `limit` / `offset`. Pass `limit: 1` when only the statistics are needed.
+   * - Only issued wins are counted — a pot that exploded but still waits for
+   *   manual approval is not included.
+   * - `highest_win` / `last_win` are `null` while the jackpot has no wins,
+   *   `total_wins` is `0` in that case.
+   * - `public_username` of `highest_win` / `last_win` is masked by the same
+   *   label setting as the winners list, and is `null` when the template
+   *   doesn't expose winners over API.
+   * - The server refreshes the statistics once per minute.
+   *
+   * **Currency caveat**
+   * All amounts (`win_stats.*.winning_amount`,
+   * `winners[].winner.winning_amount_jp_currency`) are in the jackpot's
+   * NATIVE currency, NOT the user's wallet currency.
+   *
+   * **Refresh**
+   * - The SDK caches each page separately (per `jp_template_id` +
+   *   `limit` + `offset`) for 30 seconds.
+   * - Caches clear on jackpot-win push events and on opt-in / opt-out.
+   *
+   * **Error handling**
+   * Non-zero `errCode` on control-group users or generic server errors. The
+   * SDK does NOT enumerate distinct codes — branch on `errCode === 0` and
+   * surface `errMsg` on failure.
+   *
+   * **Visitor mode**: not supported.
+   *
+   * @returns {@link TGetJackpotWinStatsResponse} —
+   * `{ winners: JackpotWinnerHistory[], win_stats: JackpotWinStats }`.
+   *
+   * @example
+   * ```ts
+   * const [jp] = await window._smartico.api.jackpotGet({ jp_template_id: 42 });
+   *
+   * if (!jp || !jp.expose_winners_over_api) {
+   *     console.log('[smartico] winners hidden by operator config — hide the stats');
+   *     return;
+   * }
+   *
+   * const { winners, win_stats } = await window._smartico.api.getJackpotWinStats({
+   *     jp_template_id: 42,
+   *     limit:          10,
+   *     offset:         0,
+   * });
+   * console.log('[smartico] total wins', win_stats.total_wins);
+   * console.log('[smartico] highest win', win_stats.highest_win?.winning_amount, jp.jp_currency);
+   * console.log('[smartico] latest win', win_stats.last_win?.public_username, win_stats.last_win?.win_date_ts);
+   * console.log('[smartico] render', winners.length, 'recent winner rows');
+   * ```
+   */
+  async getJackpotWinStats({
+    limit,
+    offset,
+    jp_template_id
+  }) {
+    const cacheKey = `${onUpdateContextKey.JackpotWinners}stats:${jp_template_id}:${limit}:${offset}`;
+    return OCache.use(cacheKey, ECacheContext.WSAPI, () => this.api.getJackpotWinStatsT(this.userExtId, limit, offset, jp_template_id), JACKPOT_WINNERS_CACHE_SEC);
+  }
   /**
    * Returns the casino games eligible to contribute to a specific jackpot —
    * the catalog the user must play to grow the pot. Use to power an
@@ -9150,6 +9227,16 @@ class WSAPIInbox extends WSAPILeaderBoard {
    * for safe execution — that helper handles URL vs deep-link
    * routing.
    *
+   * **Preview vs silent delivery**
+   * Every message belongs in your inbox list. `show_preview` decides
+   * whether it should also pop up briefly when it arrives:
+   * - `show_preview !== false` → show a preview popup for
+   *   `show_duration_sec ?? 7` seconds.
+   * - `show_preview === false` → store it silently, with no popup.
+   * These fields are returned exactly as the operator configured them;
+   * a missing value means the default above, the same as the default
+   * Smartico UI.
+   *
    * **Idempotency / Side effects**: safe. Read-only HTTP fetch.
    *
    * **UI guidance**: see [UI Guide — `getInboxMessageBody`](../../docs/ui/inbox/UIGuide_getInboxMessageBody.md).
@@ -9175,6 +9262,12 @@ class WSAPIInbox extends WSAPILeaderBoard {
    *   console.log('[smartico] simple message — show preview_body + single CTA wired to:', body.action,
    *     '— execute via _smartico.dp(body.action)');
    * }
+   *
+   * if (body.show_preview !== false) {
+   *   console.log('[smartico] new message — show a preview popup for', body.show_duration_sec ?? 7, 'seconds');
+   * } else {
+   *   console.log('[smartico] new message — store it in the inbox silently, no popup');
+   * }
    * ```
    */
   async getInboxMessageBody(messageGuid) {
@@ -9810,6 +9903,20 @@ const GetJackpotWinnersResponseTransform = items => {
     return winnerInfo;
   });
 };
+/**
+ * @ignore
+ */
+const GetJackpotWinStatsResponseTransform = response => {
+  var _response$winners, _response$win_stats$t, _response$win_stats, _response$win_stats$h, _response$win_stats2, _response$win_stats$l, _response$win_stats3;
+  return {
+    winners: GetJackpotWinnersResponseTransform((_response$winners = response.winners) != null ? _response$winners : []),
+    win_stats: {
+      total_wins: (_response$win_stats$t = (_response$win_stats = response.win_stats) == null ? void 0 : _response$win_stats.total_wins) != null ? _response$win_stats$t : 0,
+      highest_win: (_response$win_stats$h = (_response$win_stats2 = response.win_stats) == null ? void 0 : _response$win_stats2.highest_win) != null ? _response$win_stats$h : null,
+      last_win: (_response$win_stats$l = (_response$win_stats3 = response.win_stats) == null ? void 0 : _response$win_stats3.last_win) != null ? _response$win_stats$l : null
+    }
+  };
+};
 
 /**
  * @ignore
@@ -10146,6 +10253,9 @@ class SmarticoAPI {
   async getJackpotWinnersT(user_ext_id, limit = 20, offset = 0, jp_template_id) {
     return GetJackpotWinnersResponseTransform((await this.getJackpotWinners(user_ext_id, limit, offset, jp_template_id)).winners);
   }
+  async getJackpotWinStatsT(user_ext_id, limit = 20, offset = 0, jp_template_id) {
+    return GetJackpotWinStatsResponseTransform(await this.getJackpotWinners(user_ext_id, limit, offset, jp_template_id));
+  }
   async getJackpotEligibleGames(user_ext_id, {
     jp_template_id
   }) {
@@ -11643,5 +11753,5 @@ var JoinClanErrorCode;
   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, ActivityLogActivities, 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 };
+export { AchCategoryTransform, AchCustomLayoutTheme, AchCustomSectionType, AchMissionsTabsOptions, AchOverviewMissionsFilter, AchievementAvailabilityStatus, AchievementClaimPeriodTypeId, AchievementStatus, AchievementTaskType, AchievementType, ActivityLogActivities, ActivityLogTransform, ActivityTypeLimited, AllRoundsGameBoardID, AnalyticsInboxSubScreenNameId, AnalyticsInterfaceType, AnalyticsScreenNameId, AnalyticsTournamentsLobbySubScreenNameId, AttemptPeriodType, AvatarCustomizeErrorCode, BadgesTimeLimitStates, BonusItemsTransform, BonusStatus, BuyStoreItemErrorCode, ClassId, CookieStore, CoreUtils, ECacheContext, GPRoundStatus, GamePickMarketType, GamePickResolutionType, GamePickScoreType, GamePickSportType, GameRoundOrderType, GetJackpotEligibleGamesResponseTransform, GetJackpotWinStatsResponseTransform, 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