@smartico/public-api 0.0.357 → 0.0.359

package/dist/WSAPI/WSAPI.d.ts

@@ -21,7 +21,7 @@ export declare 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**
@@ -48,7 +48,7 @@ export declare class WSAPI {
      * **Visitor mode: not supported**
      */
     checkSegmentListMatch(segment_ids: number[]): Promise<TSegmentCheckResult[]>;
-    /** Returns all the levels available the current user
+    /** Returns all the levels available to the current user
      * **Example**:
      * ```
      * _smartico.api.getLevels().then((result) => {
@@ -100,14 +100,14 @@ export declare class WSAPI {
         onUpdate?: (data: TMissionOrBadge[]) => void;
     }): Promise<TMissionOrBadge[]>;
     /**
-     * Returns all the badges available the current user
+     * Returns all the badges available to the current user
      *
      * **Visitor mode: not supported**
      */
     getBadges(): Promise<TMissionOrBadge[]>;
     /**
      * 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.
      *
@@ -127,7 +127,7 @@ export declare class WSAPI {
     claimBonus(bonus_id: number): Promise<TClaimBonusResult>;
     /**
      * 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**:
@@ -142,7 +142,7 @@ export declare class WSAPI {
     getUserLevelExtraCounters(): Promise<UserLevelExtraCountersT>;
     /**
      *
-     * 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.
@@ -259,7 +259,7 @@ export declare 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**:
      * ```
@@ -302,7 +302,7 @@ export declare 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**:
      * ```
@@ -329,7 +329,7 @@ export declare 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**:
      * ```
@@ -340,7 +340,7 @@ export declare class WSAPI {
      * **Visitor mode: not supported**
      */
     playMiniGameBatch(template_id: number, spin_count: number, { onUpdate }?: {
-        onUpdate?: (data: TMissionOrBadge[]) => void;
+        onUpdate?: (data: TMiniGameTemplate[]) => void;
     }): Promise<TMiniGamePlayBatchResult[]>;
     /**
      * Requests an opt-in for the specified mission_id. Returns the err_code.
@@ -376,7 +376,7 @@ export declare class WSAPI {
         onUpdate?: (data: TTournament[]) => void;
     }): Promise<TTournament[]>;
     /**
-     * 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**:
      * ```
@@ -431,7 +431,7 @@ export declare 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.
@@ -470,7 +470,7 @@ export declare class WSAPI {
      */
     markInboxMessageAsRead(messageGuid: string): Promise<InboxMarkMessageAction>;
     /**
-     * Requests to mark all inbox messages as rea
+     * Requests to mark all inbox messages as read
      *
      * **Visitor mode: not supported**
      */
@@ -529,7 +529,7 @@ export declare class WSAPI {
      * ```
      * _smartico.api.reportClickEvent({
      *      engagement_uid: 'abc123-def456',
-     *      activityType: 31 // Inbox,
+     *      activityType: 31 // Inbox
      *      action: 'dp:gf_missions'
      * });
      * ```
@@ -899,7 +899,7 @@ export declare class WSAPI {
     private notifyActivityLogUpdate;
     private updateEntity;
     private jackpotClearCache;
-    /** 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
@@ -957,7 +957,9 @@ export declare class WSAPI {
         jp_template_id: number;
     }): Promise<JackpotsOptoutResponse>;
     /**
-     * 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**:
      * ```
@@ -970,6 +972,9 @@ export declare 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
      */
     getJackpotWinners({ limit, offset, jp_template_id, }: {
         limit?: number;
@@ -1073,7 +1078,7 @@ export declare 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);
      * });
      * ```
@@ -1081,7 +1086,7 @@ export declare 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);
      * });
      * ```
@@ -1092,7 +1097,7 @@ export declare class WSAPI {
         draw_id?: number;
     }): Promise<TRaffleDrawRun[]>;
     /**
-     * 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**:

package/dist/index.js

@@ -1211,6 +1211,8 @@ exports.BadgesTimeLimitStates = void 0;
 })(exports.BadgesTimeLimitStates || (exports.BadgesTimeLimitStates = {}));
 
 var _MissionUtils;
+var USER_STATE_PARAMS_KEYS_GAMES = ['core_fav_game_top3', 'core_fav_game_type_top3', 'core_fav_game_provider_top3'];
+var USER_STATE_PARAMS_KEYS_BET_AMOUNT = ['core_recommended_deposit_amount', 'core_recommended_casino_bet_amount', 'casino_last_bet_amount', 'casino_last_bet_amount_real', 'casino_last_bet_amount_bonus', 'acc_last_deposit_amount'];
 var MissionUtils = function MissionUtils() {};
 _MissionUtils = MissionUtils;
 MissionUtils.getAvailabilityStatus = function (mission) {
@@ -1379,7 +1381,7 @@ MissionUtils.replaceTagsFavMissionTask = function (_ref) {
   userStateParamsKeys.forEach(function (k) {
     var _userStateOperator$k;
     var operator = (_userStateOperator$k = userStateOperator[k]) == null ? void 0 : _userStateOperator$k.op;
-    if (k === 'core_fav_game_top3' || k === 'core_fav_game_type_top3' || k === 'core_fav_game_provider_top3') {
+    if (USER_STATE_PARAMS_KEYS_GAMES.includes(k)) {
       if (operatorsMulti.includes(operator)) {
         var _userStateParams$k;
         var value = (_userStateParams$k = userStateParams[k]) == null ? void 0 : _userStateParams$k.filter(function (v) {
@@ -1404,7 +1406,7 @@ MissionUtils.replaceTagsFavMissionTask = function (_ref) {
         }
       }
     }
-    if (k === 'core_recommended_deposit_amount' || k === 'core_recommended_casino_bet_amount') {
+    if (USER_STATE_PARAMS_KEYS_BET_AMOUNT.includes(k)) {
       suggestedValue = userStateParams[k];
       if (suggestedValue) {
         var currencyFromTheTask = userStateParams == null ? void 0 : userStateParams.core_wallet_currency;
@@ -2293,7 +2295,7 @@ var WSAPI = /*#__PURE__*/function () {
    * 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**
@@ -2351,7 +2353,7 @@ var WSAPI = /*#__PURE__*/function () {
       return Promise.reject(e);
     }
   }
-  /** Returns all the levels available the current user
+  /** Returns all the levels available to the current user
    * **Example**:
    * ```
    * _smartico.api.getLevels().then((result) => {
@@ -2436,7 +2438,7 @@ var WSAPI = /*#__PURE__*/function () {
     }
   }
   /**
-   * Returns all the badges available the current user
+   * Returns all the badges available to the current user
    *
    * **Visitor mode: not supported**
    */
@@ -2453,7 +2455,7 @@ var WSAPI = /*#__PURE__*/function () {
   }
   /**
    * 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.
    *
@@ -2501,7 +2503,7 @@ var WSAPI = /*#__PURE__*/function () {
   }
   /**
    * 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**:
@@ -2526,7 +2528,7 @@ var WSAPI = /*#__PURE__*/function () {
   }
   /**
    *
-   * 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.
@@ -2713,7 +2715,7 @@ var WSAPI = /*#__PURE__*/function () {
   /**
    * 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**:
    * ```
@@ -2778,7 +2780,7 @@ var WSAPI = /*#__PURE__*/function () {
   /**
    * 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**:
    * ```
@@ -2832,7 +2834,7 @@ var WSAPI = /*#__PURE__*/function () {
   /**
    * 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**:
    * ```
@@ -2946,7 +2948,7 @@ var WSAPI = /*#__PURE__*/function () {
     }
   }
   /**
-   * 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**:
    * ```
@@ -3033,7 +3035,7 @@ var WSAPI = /*#__PURE__*/function () {
    * 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.
@@ -3117,7 +3119,7 @@ var WSAPI = /*#__PURE__*/function () {
     }
   }
   /**
-   * Requests to mark all inbox messages as rea
+   * Requests to mark all inbox messages as read
    *
    * **Visitor mode: not supported**
    */
@@ -3242,7 +3244,7 @@ var WSAPI = /*#__PURE__*/function () {
    * ```
    * _smartico.api.reportClickEvent({
    *      engagement_uid: 'abc123-def456',
-   *      activityType: 31 // Inbox,
+   *      activityType: 31 // Inbox
    *      action: 'dp:gf_missions'
    * });
    * ```
@@ -3864,7 +3866,7 @@ var WSAPI = /*#__PURE__*/function () {
       return Promise.reject(e);
     }
   }
-  /** 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
@@ -4000,7 +4002,9 @@ var WSAPI = /*#__PURE__*/function () {
     }
   }
   /**
-   * 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**:
    * ```
@@ -4013,6 +4017,9 @@ var WSAPI = /*#__PURE__*/function () {
    *
    * **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
    */
   ;
   _proto.getJackpotWinners = function getJackpotWinners(_ref13) {
@@ -4166,7 +4173,7 @@ var WSAPI = /*#__PURE__*/function () {
    * **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);
    * });
    * ```
@@ -4174,7 +4181,7 @@ var WSAPI = /*#__PURE__*/function () {
    * **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);
    * });
    * ```
@@ -4195,7 +4202,7 @@ var WSAPI = /*#__PURE__*/function () {
     }
   }
   /**
-   * 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**: