@smartico/public-api 0.0.356 → 0.0.358

package/dist/index.modern.mjs

@@ -2260,7 +2260,7 @@ class WSAPI {
    * Pay attention that this method is synchronous and returns the user profile object immediately, not a promise.
    * **Example**:
    * ```
-   * var p = _smartico.api.getUserProfile);
+   * var p = _smartico.api.getUserProfile();
    * console.log(p);
    * ```
    * **Visitor mode: not supported**
@@ -2304,7 +2304,7 @@ class WSAPI {
   async checkSegmentListMatch(segment_ids) {
     return await this.api.coreCheckSegments(this.userExtId, Array.isArray(segment_ids) ? segment_ids : [segment_ids]);
   }
-  /** Returns all the levels available the current user
+  /** Returns all the levels available to the current user
    * **Example**:
    * ```
    * _smartico.api.getLevels().then((result) => {
@@ -2365,7 +2365,7 @@ class WSAPI {
     return OCache.use(onUpdateContextKey.Missions, ECacheContext.WSAPI, () => this.api.missionsGetItemsT(this.userExtId), CACHE_DATA_SEC);
   }
   /**
-   * Returns all the badges available the current user
+   * Returns all the badges available to the current user
    *
    * **Visitor mode: not supported**
    */
@@ -2374,7 +2374,7 @@ class WSAPI {
   }
   /**
    * Returns all the bonuses for the current user
-   * The returned bonuss are cached for 30 seconds. But you can pass the onUpdate callback as a parameter.
+   * The returned bonuses are cached for 30 seconds. But you can pass the onUpdate callback as a parameter.
    * Note that each time you call getBonuses with a new onUpdate callback, the old one will be overwritten by the new one.
    * The onUpdate callback will be called on bonus claimed and the updated bonuses will be passed to it.
    *
@@ -2407,7 +2407,7 @@ class WSAPI {
   }
   /**
    * Returns the extra counters for the current user level.
-   * These are counters that are configured for each Smartico client separatly by request.
+   * These are counters that are configured for each Smartico client separately by request.
    * For example 1st counter could be total wagering amount, 2nd counter could be total deposit amount, etc.
    *
    * **Example**:
@@ -2424,7 +2424,7 @@ class WSAPI {
   }
   /**
    *
-   * Returns all the store items available the current user
+   * Returns all the store items available to the current user
    * The returned store items are cached for 30 seconds. But you can pass the onUpdate callback as a parameter.
    * Note that each time you call getStoreItems with a new onUpdate callback, the old one will be overwritten by the new one.
    * The onUpdate callback will be called on purchase of the store item.
@@ -2564,7 +2564,7 @@ class WSAPI {
   /**
    * Returns the list of mini-games configured for the current user (not filtered by spin availability or Widget visibility).
    * The returned list of mini-games is cached for 30 seconds. But you can pass the onUpdate callback as a parameter. Note that each time you call getMiniGames with a new onUpdate callback, the old one will be overwritten by the new one.
-   * The onUpdate callback will be called on available spin count change, if mini-game has increasing jackpot per spin or wined prize is spin/jackpot and if max count of the available user spin equal one, also if the spins were issued to the user manually in the BO. Updated templates will be passed to onUpdate callback.
+   * The onUpdate callback will be called on available spin count change, if mini-game has increasing jackpot per spin or won prize is spin/jackpot and if max count of the available user spins equals one, also if the spins were issued to the user manually in the BO. Updated templates will be passed to onUpdate callback.
    *
    * **Example**:
    * ```
@@ -2614,7 +2614,7 @@ class WSAPI {
   /**
    * Plays the specified by template_id mini-game on behalf of user and returns prize_id or err_code
    * After playMiniGame is called, you can call getMiniGames to get the list of mini-games.The returned list of mini-games is cached for 30 seconds. But you can pass the onUpdate callback as a parameter. Note that each time you call playMiniGame with a new onUpdate callback, the old one will be overwritten by the new one.
-   * The onUpdate callback will be called on available spin count change, if mini-game has increasing jackpot per spin or wined prize is spin/jackpot and if max count of the available user spin equal one, also if the spins were issued to the user manually in the BO. Updated templates will be passed to onUpdate callback.
+   * The onUpdate callback will be called on available spin count change, if mini-game has increasing jackpot per spin or won prize is spin/jackpot and if max count of the available user spins equals one, also if the spins were issued to the user manually in the BO. Updated templates will be passed to onUpdate callback.
    *
    * **Example**:
    * ```
@@ -2655,7 +2655,7 @@ class WSAPI {
   /**
    * Plays the specified by template_id mini-game on behalf of user spin_count times and returns array of the prizes
    * After playMiniGameBatch is called, you can call getMiniGames to get the list of mini-games. The returned list of mini-games is cached for 30 seconds. But you can pass the onUpdate callback as a parameter. Note that each time you call playMiniGameBatch with a new onUpdate callback, the old one will be overwritten by the new one.
-   * The onUpdate callback will be called on available spin count change, if mini-game has increasing jackpot per spin or wined prize is spin/jackpot and if max count of the available user spin equal one, also if the spins were issued to the user manually in the BO. Updated templates will be passed to onUpdate callback.
+   * The onUpdate callback will be called on available spin count change, if mini-game has increasing jackpot per spin or won prize is spin/jackpot and if max count of the available user spins equals one, also if the spins were issued to the user manually in the BO. Updated templates will be passed to onUpdate callback.
    *
    * **Example**:
    * ```
@@ -2736,7 +2736,7 @@ class WSAPI {
     return OCache.use(onUpdateContextKey.TournamentList, ECacheContext.WSAPI, () => this.api.tournamentsGetLobbyT(this.userExtId), CACHE_DATA_SEC);
   }
   /**
-   * Returns details information of specific tournament instance, the response will include tournament info and the leaderboard of players
+   * Returns detailed information for a specific tournament instance; the response includes tournament info and the leaderboard of players
    *
    * **Example**:
    * ```
@@ -2802,7 +2802,7 @@ class WSAPI {
    * An indicator "onlyFavorite" can be passed to get only messages marked as favorites.
    * An indicator "read_status" can be passed to get only messages marked as read or unread.
    * You can leave this params empty and by default it will return list of messages ranging from 0 to 20.
-   * This functions return list of messages without the body of the message.
+   * This function returns a list of messages without the body of each message.
    * To get the body of the message you need to call getInboxMessageBody function and pass the message guid contained in each message of this request.
    * All other action like mark as read, favorite, delete, etc. can be done using this message GUID.
    * The "onUpdate" callback will be triggered when the user receives a new message. It will provide an updated list of messages, ranging from 0 to 20, to the onUpdate callback function.
@@ -2859,7 +2859,7 @@ class WSAPI {
     };
   }
   /**
-   * Requests to mark all inbox messages as rea
+   * Requests to mark all inbox messages as read
    *
    * **Visitor mode: not supported**
    */
@@ -2949,7 +2949,7 @@ class WSAPI {
    * ```
    * _smartico.api.reportClickEvent({
    *      engagement_uid: 'abc123-def456',
-   *      activityType: 31 // Inbox,
+   *      activityType: 31 // Inbox
    *      action: 'dp:gf_missions'
    * });
    * ```
@@ -3031,7 +3031,7 @@ class WSAPI {
    *
    * **Example**:
    * ```
-   * _smartico.api.getGamePickActiveRounds({
+   * _smartico.api.gamePickGetActiveRounds({
    *      saw_template_id: 1083,
    * }).then((result) => {
    *      console.log(result.data); // GamePickRound[]
@@ -3043,7 +3043,7 @@ class WSAPI {
    *
    * **Visitor mode: not supported**
    */
-  async getGamePickActiveRounds(props) {
+  async gamePickGetActiveRounds(props) {
     if (!props.saw_template_id) {
       throw new Error('saw_template_id is required');
     }
@@ -3058,12 +3058,12 @@ class WSAPI {
    *
    * **Response** `GamesApiResponse<GamePickRound>`:
    * - `errCode` - 0 on success
-   * - `data` - Single round object with the same structure as in `getGamePickActiveRounds`,
+   * - `data` - Single round object with the same structure as in `gamePickGetActiveRounds`,
    *   including `events[]` with full event details, user selections, and resolution info
    *
    * **Example**:
    * ```
-   * _smartico.api.getGamePickActiveRound({
+   * _smartico.api.gamePickGetActiveRound({
    *      saw_template_id: 1083,
    *      round_id: 31652,
    * }).then((result) => {
@@ -3074,7 +3074,7 @@ class WSAPI {
    *
    * **Visitor mode: not supported**
    */
-  async getGamePickActiveRound(props) {
+  async gamePickGetActiveRound(props) {
     if (!props.saw_template_id) {
       throw new Error('saw_template_id is required');
     }
@@ -3092,12 +3092,12 @@ class WSAPI {
    * **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
+   *   Each round has the same structure as in `gamePickGetActiveRounds`, including resolved events
    *   with `resolution_type_id` (0=None, 2=Lost, 3=PartialWin, 4=FullWin) and `resolution_score`
    *
    * **Example**:
    * ```
-   * _smartico.api.getGamePickHistory({
+   * _smartico.api.gamePickGetHistory({
    *      saw_template_id: 1083,
    * }).then((result) => {
    *      result.data.forEach(round => {
@@ -3108,7 +3108,7 @@ class WSAPI {
    *
    * **Visitor mode: not supported**
    */
-  async getGamePickHistory(props) {
+  async gamePickGetHistory(props) {
     if (!props.saw_template_id) {
       throw new Error('saw_template_id is required');
     }
@@ -3135,7 +3135,7 @@ class WSAPI {
    *
    * **Example**:
    * ```
-   * _smartico.api.getGamePickBoard({
+   * _smartico.api.gamePickGetBoard({
    *      saw_template_id: 1083,
    *      round_id: 31652,
    * }).then((result) => {
@@ -3146,7 +3146,7 @@ class WSAPI {
    *
    * **Visitor mode: not supported**
    */
-  async getGamePickBoard(props) {
+  async gamePickGetBoard(props) {
     if (!props.saw_template_id) {
       throw new Error('saw_template_id is required');
     }
@@ -3163,7 +3163,7 @@ class WSAPI {
    * 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`
+   * @param props.round - Round object containing `round_id` and `events[]`. Typically obtained from `gamePickGetActiveRound`
    *   and modified with user predictions. Each event needs: `gp_event_id`, `team1_user_selection`, `team2_user_selection`
    *
    * **Response** `GamesApiResponse<GamePickRound>`:
@@ -3173,7 +3173,7 @@ class WSAPI {
    *
    * **Example**:
    * ```
-   * _smartico.api.getGamePickActiveRound({
+   * _smartico.api.gamePickGetActiveRound({
    *      saw_template_id: 1190,
    *      round_id: 38665,
    * }).then((roundData) => {
@@ -3183,7 +3183,7 @@ class WSAPI {
    *          team1_user_selection: 1,
    *          team2_user_selection: 0,
    *      }));
-   *      _smartico.api.submitGamePickSelection({
+   *      _smartico.api.gamePickSubmitSelection({
    *          saw_template_id: 1190,
    *          round: round,
    *      }).then((result) => {
@@ -3194,7 +3194,7 @@ class WSAPI {
    *
    * **Visitor mode: not supported**
    */
-  async submitGamePickSelection(props) {
+  async gamePickSubmitSelection(props) {
     var _props$round;
     if (!props.saw_template_id) {
       throw new Error('saw_template_id is required');
@@ -3212,7 +3212,7 @@ class WSAPI {
    * 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`
+   * @param props.round - Round object containing `round_id` and `events[]`. Typically obtained from `gamePickGetActiveRound`
    *   and modified with user answers. Each event needs: `gp_event_id`, `user_selection`
    *
    * **Response** `GamesApiResponse<GamePickRound>`:
@@ -3222,7 +3222,7 @@ class WSAPI {
    *
    * **Example**:
    * ```
-   * _smartico.api.getGamePickActiveRound({
+   * _smartico.api.gamePickGetActiveRound({
    *      saw_template_id: 1183,
    *      round_id: 37974,
    * }).then((roundData) => {
@@ -3231,7 +3231,7 @@ class WSAPI {
    *          gp_event_id: e.gp_event_id,
    *          user_selection: 'x',
    *      }));
-   *      _smartico.api.submitGamePickSelectionQuiz({
+   *      _smartico.api.gamePickSubmitSelectionQuiz({
    *          saw_template_id: 1183,
    *          round: round,
    *      }).then((result) => {
@@ -3242,7 +3242,7 @@ class WSAPI {
    *
    * **Visitor mode: not supported**
    */
-  async submitGamePickSelectionQuiz(props) {
+  async gamePickSubmitSelectionQuiz(props) {
     var _props$round2;
     if (!props.saw_template_id) {
       throw new Error('saw_template_id is required');
@@ -3274,7 +3274,7 @@ class WSAPI {
    *
    * **Example**:
    * ```
-   * _smartico.api.getGamePickUserInfo({
+   * _smartico.api.gamePickGetUserInfo({
    *      saw_template_id: 1083,
    * }).then((result) => {
    *      console.log(result.data.public_username, result.data.ach_points_balance);
@@ -3283,7 +3283,7 @@ class WSAPI {
    *
    * **Visitor mode: not supported**
    */
-  async getGamePickUserInfo(props) {
+  async gamePickGetUserInfo(props) {
     if (!props.saw_template_id) {
       throw new Error('saw_template_id is required');
     }
@@ -3312,7 +3312,7 @@ class WSAPI {
    *
    * **Example**:
    * ```
-   * _smartico.api.getGamePickGameInfo({
+   * _smartico.api.gamePickGetGameInfo({
    *      saw_template_id: 1189,
    * }).then((result) => {
    *      console.log(result.data.sawTemplate.saw_template_ui_definition.name);
@@ -3323,7 +3323,7 @@ class WSAPI {
    *
    * **Visitor mode: not supported**
    */
-  async getGamePickGameInfo(props) {
+  async gamePickGetGameInfo(props) {
     if (!props.saw_template_id) {
       throw new Error('saw_template_id is required');
     }
@@ -3332,7 +3332,7 @@ class WSAPI {
   /**
    * 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`).
+   * The `int_user_id` can be obtained from the `gamePickGetBoard` 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
@@ -3341,13 +3341,13 @@ class WSAPI {
    * **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`
+   *   Same structure as `gamePickGetActiveRound`, 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({
+   * _smartico.api.gamePickGetRoundInfoForUser({
    *      saw_template_id: 1083,
    *      round_id: 31652,
    *      int_user_id: 65653810,
@@ -3360,7 +3360,7 @@ class WSAPI {
    *
    * **Visitor mode: not supported**
    */
-  async getGamePickRoundInfoForUser(props) {
+  async gamePickGetRoundInfoForUser(props) {
     if (!props.saw_template_id) {
       throw new Error('saw_template_id is required');
     }
@@ -3431,7 +3431,7 @@ class WSAPI {
     OCache.clear(ECacheContext.WSAPI, onUpdateContextKey.Pots);
     OCache.clear(ECacheContext.WSAPI, onUpdateContextKey.JackpotWinners);
   }
-  /** Returns list of Jackpots that are active in the systen and matching to the filter definition.
+  /** Returns list of Jackpots that are active in the system and matching to the filter definition.
    * If filter is not provided, all active jackpots will be returned.
    * Filter can be used to get jackpots related to specific game or specific jackpot template.
    * You can call this method every second in order to get up to date information about current value of the jackpot(s) and present them to the end-users
@@ -3526,7 +3526,9 @@ class WSAPI {
     return result;
   }
   /**
-   * Returns the winners of the jackpot with the specified jp_template_id.
+   * Returns jackpot winners for the given `jp_template_id` (paginated on the server).
+   * Default page size on the wire is 20; use `limit`, `offset`, and repeated calls to load more.
+   * The full protocol response also includes `has_more`; this method returns only the `winners` array.
    *
    * **Example**:
    * ```
@@ -3539,6 +3541,9 @@ class WSAPI {
    *
    * **Visitor mode: not supported**
    *
+   * @param params.jp_template_id - Jackpot template id (required; throws if missing)
+   * @param params.limit - Page size (server default 20 when omitted)
+   * @param params.offset - Offset into the winner list
    */
   async getJackpotWinners({
     limit,
@@ -3659,7 +3664,7 @@ class WSAPI {
    * **Example**:
    *
    * ```javascript
-   * _smartico.api.getRaffleDrawRunHistory({raffle_id:156, draw_id: 432}).then((result) => {
+   * _smartico.api.getRaffleDrawRunsHistory({ raffle_id: 156, draw_id: 432 }).then((result) => {
    *      console.log(result);
    * });
    * ```
@@ -3667,7 +3672,7 @@ class WSAPI {
    * **Example in the Visitor mode**:
    *
    * ```javascript
-   * _smartico.vapi('EN').getRaffleDrawRunHistory({ raffle_id: 156, draw_id: 432 }).then((result) => {
+   * _smartico.vapi('EN').getRaffleDrawRunsHistory({ raffle_id: 156, draw_id: 432 }).then((result) => {
    *      console.log(result);
    * });
    * ```
@@ -3681,7 +3686,7 @@ class WSAPI {
     return drawRunHistoryTransform(res);
   }
   /**
-   * Returns error code, and error Message after calling the function, error message 0 - means that the request was successful
+   * Returns `err_code` and `err_message` after the call; `err_code` 0 means the request succeeded.
    *
    *
    * **Example**: