@smartico/public-api 0.0.351 → 0.0.353

package/dist/WSAPI/WSAPI.d.ts

@@ -1,6 +1,7 @@
 import { ActivityTypeLimited } from '../Core';
 import { SmarticoAPI } from '../SmarticoAPI';
 import { InboxMarkMessageAction, LeaderBoardDetailsT, TAchCategory, TBuyStoreItemResult, TGetTranslations, TInboxMessage, TInboxMessageBody, TLevel, TMiniGamePlayResult, TMiniGameTemplate, TMissionClaimRewardResult, TMissionOptInResult, TMissionOrBadge, TSegmentCheckResult, TStoreCategory, TStoreItem, TTournament, TTournamentDetailed, TTournamentRegistrationResult, TUICustomSection, TUserProfile, UserLevelExtraCountersT, TBonus, TClaimBonusResult, TMiniGamePlayBatchResult, TSawHistory, TRaffle, TRaffleDraw, TRaffleDrawRun, TransformedRaffleClaimPrizeResponse, TLevelCurrent, TActivityLog, TRaffleOptinResponse } from './WSAPITypes';
+import { GamesApiResponse, GamePickRound, GamePickRoundBoard, GamePickUserInfo, GamePickGameInfo, GamePickRequestParams, GamePickRoundRequestParams } from '../GamePick';
 import { LeaderBoardPeriodType } from '../Leaderboard';
 import { JackpotDetails, JackpotWinnerHistory, JackpotsOptinResponse, JackpotsOptoutResponse } from '../Jackpots';
 import { GetRelatedAchTourResponse } from '../Missions/GetRelatedAchTourResponse';
@@ -12,8 +13,9 @@ export declare class WSAPI {
     private api;
     private onUpdateCallback;
     private jackpotGetSignature;
+    private userExtId;
     /** @private */
-    constructor(api: SmarticoAPI);
+    constructor(api: SmarticoAPI, userExtId?: string);
     /** @private */
     clearCaches(): void;
     /** Returns information about current user
@@ -582,6 +584,337 @@ export declare class WSAPI {
         to: number;
         onUpdate?: (data: TActivityLog[]) => void;
     }): Promise<TActivityLog[]>;
+    /**
+     * Returns the active rounds for the specified MatchX or Quiz game.
+     * Each round includes its events (matches/questions) along with the current user's selections and scores.
+     *
+     * @param props.saw_template_id - The ID of the MatchX or Quiz game template
+     *
+     * **Response** `GamesApiResponse<GamePickRound[]>`:
+     * - `errCode` - 0 on success
+     * - `data` - Array of rounds, each containing:
+     *   - `round_id`, `round_name` - Round identifier and display name
+     *   - `open_date`, `last_bet_date` - Timestamps (ms) for round open and betting deadline
+     *   - `is_active_now`, `is_resolved` - Round state flags
+     *   - `round_status_id` - Round status: -1 (active), 2 (no more bets), 3 (all events resolved), 4 (round resolved)
+     *   - `score_full_win`, `score_part_win`, `score_lost` - Scoring rules per prediction outcome
+     *   - `user_score` - Current user's total score in this round
+     *   - `user_placed_bet` - Whether the user has submitted predictions
+     *   - `has_open_for_bet_events` - Whether there are events still open for betting
+     *   - `events[]` - Array of events with `gp_event_id`, `market_type_id`, `event_meta` (team names, images, sport), `match_date`, `is_open_for_bets`, `odds_details`, and user selection fields
+     *
+     * **Example**:
+     * ```
+     * _smartico.api.getGamePickActiveRounds({
+     *      saw_template_id: 1083,
+     * }).then((result) => {
+     *      console.log(result.data); // GamePickRound[]
+     *      result.data.forEach(round => {
+     *          console.log(round.round_name, round.events.length);
+     *      });
+     * });
+     * ```
+     *
+     * **Visitor mode: not supported**
+     */
+    getGamePickActiveRounds(props: GamePickRequestParams): Promise<GamesApiResponse<GamePickRound[]>>;
+    /**
+     * Returns a single active round for the specified MatchX or Quiz game.
+     * The round includes full event details with the current user's selections.
+     *
+     * @param props.saw_template_id - The ID of the MatchX or Quiz game template
+     * @param props.round_id - The specific round to retrieve
+     *
+     * **Response** `GamesApiResponse<GamePickRound>`:
+     * - `errCode` - 0 on success
+     * - `data` - Single round object with the same structure as in `getGamePickActiveRounds`,
+     *   including `events[]` with full event details, user selections, and resolution info
+     *
+     * **Example**:
+     * ```
+     * _smartico.api.getGamePickActiveRound({
+     *      saw_template_id: 1083,
+     *      round_id: 31652,
+     * }).then((result) => {
+     *      console.log(result.data.round_name, result.data.events.length);
+     *      console.log(result.data.user_score, result.data.user_placed_bet);
+     * });
+     * ```
+     *
+     * **Visitor mode: not supported**
+     */
+    getGamePickActiveRound(props: GamePickRoundRequestParams): Promise<GamesApiResponse<GamePickRound>>;
+    /**
+     * Returns the history of all rounds (including resolved ones) for the specified MatchX or Quiz game.
+     * Each round contains full event details with results and the current user's predictions.
+     *
+     * @param props.saw_template_id - The ID of the MatchX or Quiz game template
+     *
+     * **Response** `GamesApiResponse<GamePickRound[]>`:
+     * - `errCode` - 0 on success
+     * - `data` - Array of rounds ordered by `round_row_id` descending (newest first).
+     *   Each round has the same structure as in `getGamePickActiveRounds`, including resolved events
+     *   with `resolution_type_id` (0=None, 2=Lost, 3=PartialWin, 4=FullWin) and `resolution_score`
+     *
+     * **Example**:
+     * ```
+     * _smartico.api.getGamePickHistory({
+     *      saw_template_id: 1083,
+     * }).then((result) => {
+     *      result.data.forEach(round => {
+     *          console.log(round.round_name, 'Score:', round.user_score, 'Resolved:', round.is_resolved);
+     *      });
+     * });
+     * ```
+     *
+     * **Visitor mode: not supported**
+     */
+    getGamePickHistory(props: GamePickRequestParams): Promise<GamesApiResponse<GamePickRound[]>>;
+    /**
+     * Returns the leaderboard for a specific round within a MatchX or Quiz game.
+     * Use `round_id = -1` (AllRoundsGameBoardID) to get the season/overall leaderboard across all rounds.
+     *
+     * @param props.saw_template_id - The ID of the MatchX or Quiz game template
+     * @param props.round_id - The round to get the leaderboard for. Use -1 for overall/seasonal leaderboard
+     *
+     * **Response** `GamesApiResponse<GamePickRoundBoard>`:
+     * - `errCode` - 0 on success
+     * - `data` - Leaderboard object containing:
+     *   - Round base fields (`round_id`, `round_name`, `open_date`, `last_bet_date`, etc.)
+     *   - `users[]` - Ranked list of players, each with:
+     *     - `ext_user_id`, `int_user_id` - User identifiers
+     *     - `public_username`, `avatar_url` - Display info (usernames may be masked based on label settings)
+     *     - `gp_position` - Leaderboard rank (null if not yet ranked)
+     *     - `resolution_score` - Total score in this round
+     *     - `full_wins_count`, `part_wins_count`, `lost_count` - Prediction outcome counts
+     *   - `my_user` - Current user's entry (same fields as above), or null if user hasn't participated
+     *
+     * **Example**:
+     * ```
+     * _smartico.api.getGamePickBoard({
+     *      saw_template_id: 1083,
+     *      round_id: 31652,
+     * }).then((result) => {
+     *      console.log('Top players:', result.data.users);
+     *      console.log('My position:', result.data.my_user?.gp_position);
+     * });
+     * ```
+     *
+     * **Visitor mode: not supported**
+     */
+    getGamePickBoard(props: GamePickRoundRequestParams): Promise<GamesApiResponse<GamePickRoundBoard>>;
+    /**
+     * Submits score predictions for a round in a MatchX game.
+     * Sends the round object with user selections for all events at once.
+     * Each event must include `team1_user_selection` and `team2_user_selection` representing predicted scores.
+     * If the user hasn't placed bets before, one game attempt (spin) will be consumed.
+     * Predictions can be edited until each match starts (if `allow_edit_answers` is enabled on the round).
+     *
+     * @param props.saw_template_id - The ID of the MatchX game template
+     * @param props.round - Round object containing `round_id` and `events[]`. Typically obtained from `getGamePickActiveRound`
+     *   and modified with user predictions. Each event needs: `gp_event_id`, `team1_user_selection`, `team2_user_selection`
+     *
+     * **Response** `GamesApiResponse<GamePickRound>`:
+     * - `errCode` - 0 on success. Non-zero codes indicate errors (e.g. not enough points/attempts)
+     * - `data` - Updated round with all events reflecting the submitted selections.
+     *   `user_placed_bet` will be `true`, `has_not_submitted_changes` will be `false`
+     *
+     * **Example**:
+     * ```
+     * _smartico.api.getGamePickActiveRound({
+     *      saw_template_id: 1190,
+     *      round_id: 38665,
+     * }).then((roundData) => {
+     *      const round = roundData.data;
+     *      round.events = round.events.map(e => ({
+     *          gp_event_id: e.gp_event_id,
+     *          team1_user_selection: 1,
+     *          team2_user_selection: 0,
+     *      }));
+     *      _smartico.api.submitGamePickSelection({
+     *          saw_template_id: 1190,
+     *          round: round,
+     *      }).then((result) => {
+     *          console.log(result.data.user_placed_bet); // true
+     *      });
+     * });
+     * ```
+     *
+     * **Visitor mode: not supported**
+     */
+    submitGamePickSelection(props: GamePickRequestParams & {
+        round: Partial<GamePickRound>;
+    }): Promise<GamesApiResponse<GamePickRound>>;
+    /**
+     * Submits answers for a round in a Quiz game.
+     * Sends the round object with user answers for all events at once.
+     * Each event must include `user_selection` with the answer value (e.g. '1', '2', 'x', 'yes', 'no' — depending on the market type).
+     * If the user hasn't placed bets before, one game attempt (spin) will be consumed.
+     * Answers can be edited until each match starts (if `allow_edit_answers` is enabled on the round).
+     *
+     * @param props.saw_template_id - The ID of the Quiz game template
+     * @param props.round - Round object containing `round_id` and `events[]`. Typically obtained from `getGamePickActiveRound`
+     *   and modified with user answers. Each event needs: `gp_event_id`, `user_selection`
+     *
+     * **Response** `GamesApiResponse<GamePickRound>`:
+     * - `errCode` - 0 on success. Non-zero codes indicate errors (e.g. not enough points/attempts)
+     * - `data` - Updated round with all events reflecting the submitted answers.
+     *   `user_placed_bet` will be `true`, `has_not_submitted_changes` will be `false`
+     *
+     * **Example**:
+     * ```
+     * _smartico.api.getGamePickActiveRound({
+     *      saw_template_id: 1183,
+     *      round_id: 37974,
+     * }).then((roundData) => {
+     *      const round = roundData.data;
+     *      round.events = round.events.map(e => ({
+     *          gp_event_id: e.gp_event_id,
+     *          user_selection: 'x',
+     *      }));
+     *      _smartico.api.submitGamePickSelectionQuiz({
+     *          saw_template_id: 1183,
+     *          round: round,
+     *      }).then((result) => {
+     *          console.log(result.data.user_placed_bet); // true
+     *      });
+     * });
+     * ```
+     *
+     * **Visitor mode: not supported**
+     */
+    submitGamePickSelectionQuiz(props: GamePickRequestParams & {
+        round: Partial<GamePickRound>;
+    }): Promise<GamesApiResponse<GamePickRound>>;
+    /**
+     * Returns the current user's profile information within the specified MatchX or Quiz game.
+     * The user record is synced from the Smartico platform into the games DB (synced every 1 minute).
+     * If the user doesn't exist in the games DB yet, it will be created automatically on first call.
+     *
+     * @param props.saw_template_id - The ID of the MatchX or Quiz game template
+     *
+     * **Response** `GamesApiResponse<GamePickUserInfo>`:
+     * - `errCode` - 0 on success
+     * - `data`:
+     *   - `ext_user_id` - External user ID (Smartico internal numeric ID)
+     *   - `int_user_id` - Internal user ID within the games system
+     *   - `public_username` - Display name
+     *   - `avatar_url` - User's avatar image URL
+     *   - `last_wallet_sync_time` - Last time the user's balance was synced from Smartico
+     *   - `ach_points_balance` - User's current points balance
+     *   - `ach_gems_balance` - User's current gems balance
+     *   - `ach_diamonds_balance` - User's current diamonds balance
+     *   - `pubic_username_set` - Whether the user has set a custom username
+     *
+     * **Example**:
+     * ```
+     * _smartico.api.getGamePickUserInfo({
+     *      saw_template_id: 1083,
+     * }).then((result) => {
+     *      console.log(result.data.public_username, result.data.ach_points_balance);
+     * });
+     * ```
+     *
+     * **Visitor mode: not supported**
+     */
+    getGamePickUserInfo(props: GamePickRequestParams): Promise<GamesApiResponse<GamePickUserInfo>>;
+    /**
+     * Returns the game configuration and the list of all rounds for the specified MatchX or Quiz game.
+     * Includes the SAW template definition, label settings, and round metadata (without events).
+     *
+     * @param props.saw_template_id - The ID of the MatchX or Quiz game template
+     *
+     * **Response** `GamesApiResponse<GamePickGameInfo>`:
+     * - `errCode` - 0 on success
+     * - `data`:
+     *   - `sawTemplate` - Game template configuration including:
+     *     - `saw_template_id`, `saw_game_type_id` (6 = MatchX/Quiz)
+     *     - `saw_template_ui_definition` - UI settings (name, ranking options, ask_for_username, etc.)
+     *     - `saw_buyin_type_id` - Cost type (1=Free, 2=Points, 3=Gems, 4=Diamonds, 5=Spins)
+     *     - `buyin_cost_points` - Cost per attempt
+     *     - `spin_count` - Available attempts for the current user
+     *   - `allRounds[]` - List of all rounds (metadata only, no events), each with:
+     *     - `round_id`, `round_name`, `round_description`
+     *     - `open_date`, `last_bet_date` - Timestamps (ms)
+     *     - `is_active_now`, `is_resolved`, `round_status_id`
+     *   - `labelInfo` - Label/brand configuration and settings
+     *
+     * **Example**:
+     * ```
+     * _smartico.api.getGamePickGameInfo({
+     *      saw_template_id: 1189,
+     * }).then((result) => {
+     *      console.log(result.data.sawTemplate.saw_template_ui_definition.name);
+     *      console.log('Rounds:', result.data.allRounds.length);
+     *      console.log('Buy-in type:', result.data.sawTemplate.saw_buyin_type_id);
+     * });
+     * ```
+     *
+     * **Visitor mode: not supported**
+     */
+    getGamePickGameInfo(props: GamePickRequestParams): Promise<GamesApiResponse<GamePickGameInfo>>;
+    /**
+     * Returns translations for the MatchX/Quiz game UI.
+     * Translations are returned as a key-value map for the Gamification and RetentionGames areas,
+     * resolved to the current user's language.
+     *
+     * @param props.saw_template_id - The ID of the MatchX or Quiz game template
+     *
+     * **Response** `GamesApiResponse<any>`:
+     * - `errCode` - 0 on success
+     * - `data`:
+     *   - `translations` - Key-value map of translation strings (e.g. `rgSubmitSelection`, `rgLeaderboardTitle`, `quizConfirmAnswer`, etc.)
+     *   - `hash_code` - Hash for cache invalidation
+     *   - `lang_code` - Resolved language code (e.g. 'EN')
+     *
+     * **Example**:
+     * ```
+     * _smartico.api.getGamePickTranslations({
+     *      saw_template_id: 1083,
+     * }).then((result) => {
+     *      const tr = result.data.translations;
+     *      console.log(tr.rgSubmitSelection);   // "Submit selection"
+     *      console.log(tr.rgLeaderboardTitle);  // "Leaderboard"
+     * });
+     * ```
+     *
+     * **Visitor mode: not supported**
+     */
+    getGamePickTranslations(props: GamePickRequestParams): Promise<GamesApiResponse<any>>;
+    /**
+     * Returns round data with events and picks for a specific user (identified by their internal user ID).
+     * Useful for viewing another user's predictions from the leaderboard.
+     * The `int_user_id` can be obtained from the `getGamePickBoard` response (`users[].int_user_id`).
+     *
+     * @param props.saw_template_id - The ID of the MatchX or Quiz game template
+     * @param props.round_id - The round to get info for
+     * @param props.int_user_id - Internal user ID of the player whose predictions to view (from leaderboard data)
+     *
+     * **Response** `GamesApiResponse<GamePickRound>`:
+     * - `errCode` - 0 on success
+     * - `data` - Round object with the target user's selections.
+     *   Same structure as `getGamePickActiveRound`, but `user_selection`/`team1_user_selection`/`team2_user_selection`
+     *   fields on events reflect the specified user's picks instead of the current user's.
+     *   Events also include `resolution_type_id` (0=None, 2=Lost, 3=PartialWin, 4=FullWin) showing how each prediction was scored
+     *
+     * **Example**:
+     * ```
+     * _smartico.api.getGamePickRoundInfoForUser({
+     *      saw_template_id: 1083,
+     *      round_id: 31652,
+     *      int_user_id: 65653810,
+     * }).then((result) => {
+     *      result.data.events.forEach(e => {
+     *          console.log(e.event_meta.team1_name, 'vs', e.event_meta.team2_name, '→', e.user_selection);
+     *      });
+     * });
+     * ```
+     *
+     * **Visitor mode: not supported**
+     */
+    getGamePickRoundInfoForUser(props: GamePickRoundRequestParams & {
+        int_user_id: number;
+    }): Promise<GamesApiResponse<GamePickRound>>;
     private updateOnSpin;
     private reloadMiniGameTemplate;
     private updateMissions;

package/dist/WSAPI/WSAPITypes.d.ts

@@ -6,9 +6,11 @@ import { LeaderBoardPeriodType } from '../Leaderboard';
 import { AchCustomLayoutTheme, AchCustomSectionType, AchMissionsTabsOptions, AchOverviewMissionsFilter, LiquidEntityData } from '../CustomSections';
 import { PrizeModifiers } from '../MiniGames/PrizeModifiers';
 import { InboxCategories } from '../Inbox/InboxCategories';
-import { RaffleDrawInstanceState, RaffleDrawTypeExecution } from '../Raffle';
+import { RaffleDrawInstanceState, RaffleDrawTypeExecution, RaffleTicketCapVisualization } from '../Raffle';
 import { PointChangeSourceType } from '../ActivityLog/PointChangeSourceType';
 import { UserBalanceType } from '../ActivityLog/UserBalanceType';
+import { SAWGPMarketType } from '../Quiz/MarketsType';
+import { QuizAnswersValueType } from '../Quiz/MarketsAnswers';
 type TRibbon = 'sale' | 'hot' | 'new' | 'vip' | string;
 /**
  * TMiniGamePrize describes the information of prize in the array of prizes in the TMiniGameTemplate
@@ -380,6 +382,8 @@ export interface TTournament {
     min_scores_win?: number;
     /** When enabled, users who don’t meet the minimum qualifying score will be hidden from the Leaderboard */
     hide_leaderboard_min_scores?: boolean;
+    /** Total scores across all participants in the tournament */
+    total_scores?: number;
 }
 /**
  * TTournamentDetailed describes the information of the tournament item and includes list of participants, their scores and position in the tournament leaderboard
@@ -965,6 +969,10 @@ export interface TRaffle {
      * Then the list will always return 3 draws, no matter if the draws are already executed or they are in the future.
      */
     draws: TRaffleDraw[];
+    /**
+     * Ticket cap visualization
+     */
+    ticket_cap_visualization: RaffleTicketCapVisualization;
 }
 export interface TRaffleTicket {
     /**
@@ -1259,4 +1267,4 @@ export interface TRaffleOptinResponse {
     /** Optional error message */
     err_message?: string;
 }
-export { SAWAcknowledgeTypeName, PrizeModifiers, SAWTemplateUI, InboxCategories, AchCustomSectionType, SAWAskForUsername, SAWGameLayout, PointChangeSourceType, UserBalanceType };
+export { SAWAcknowledgeTypeName, PrizeModifiers, SAWTemplateUI, InboxCategories, AchCustomSectionType, SAWAskForUsername, SAWGameLayout, PointChangeSourceType, UserBalanceType, SAWGPMarketType, QuizAnswersValueType };

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export * from './Base/ClassId';
 export * from './ILogger';
 export * from './SmarticoAPI';
+export * from './WSAPI/WSAPI';
 export * from './CookieStore';
 export * from './Analytics';
 export * from './Core';
@@ -19,3 +20,4 @@ export * from './OCache';
 export * from './Bonuses';
 export * from './CustomSections';
 export * from './ActivityLog';
+export * from './GamePick';