@smartico/public-api 0.0.141 → 0.0.142

package/dist/OCache.d.ts

@@ -11,4 +11,5 @@ export declare class OCache {
     static use<T>(oKey: any, cacheContext: ECacheContext, f: () => Promise<T>, ttlSeconds?: number): Promise<T>;
     static clear(cacheContext: ECacheContext, oKey: any): Promise<void>;
     static clearContext(cacheContext: ECacheContext): Promise<void>;
+    static clearAll(): Promise<void>;
 }

package/dist/SmarticoAPI.d.ts

@@ -13,7 +13,7 @@ import { GetLevelMapResponse } from "./Level";
 import { WSAPI } from "./WSAPI/WSAPI";
 import { TInboxMessage, TInboxMessageBody, TLevel, TMiniGameTemplate, TMissionOrBadge, TStoreCategory, TAchCategory, TStoreItem, TTournament, TTournamentDetailed, LeaderBoardDetailsT, UserLevelExtraCountersT, TSegmentCheckResult } from "./WSAPI/WSAPITypes";
 import { GetAchievementsUserInfoResponse } from "./Core/GetAchievementsUserInfoResponse";
-import { JackpotDetails, JackpotPot, JackpotsOptinResponse, JackpotsOptoutResponse } from "./Jackpots";
+import { GetJackpotsPotsResponse, GetJackpotsResponse, JackpotsOptinResponse, JackpotsOptoutResponse } from "./Jackpots";
 interface Tracker {
     label_api_key: string;
     userPublicProps: any;
@@ -60,17 +60,17 @@ declare class SmarticoAPI {
     jackpotGet(user_ext_id: string, filter?: {
         related_game_id?: string;
         jp_template_id?: number;
-    }): Promise<JackpotDetails[]>;
+    }, force_language?: string): Promise<GetJackpotsResponse>;
     potGet(user_ext_id: string, filter: {
         jp_template_ids: number[];
-    }): Promise<JackpotPot[]>;
+    }): Promise<GetJackpotsPotsResponse>;
     jackpotOptIn(user_ext_id: string, payload: {
         jp_template_id: number;
     }): Promise<JackpotsOptinResponse>;
     jackpotOptOut(user_ext_id: string, payload: {
         jp_template_id: number;
     }): Promise<JackpotsOptoutResponse>;
-    sawGetTemplates(user_ext_id: string, lang?: string, is_visitor_mode?: boolean): Promise<SAWGetTemplatesResponse>;
+    sawGetTemplates(user_ext_id: string, force_language?: string, is_visitor_mode?: boolean): Promise<SAWGetTemplatesResponse>;
     sawGetTemplatesT(user_ext_id: string): Promise<TMiniGameTemplate[]>;
     doAcknowledgeRequest(user_ext_id: string, request_id: string): Promise<SAWDoAknowledgeResponse>;
     sawSpinRequest(user_ext_id: string, saw_template_id: number, round_id?: number): Promise<SAWDoSpinResponse>;
@@ -79,27 +79,27 @@ declare class SmarticoAPI {
     registerInTournament(user_ext_id: string, tournamentInstanceId: number): Promise<TournamentRegisterResponse>;
     buyStoreItem(user_ext_id: string, itemId: number): Promise<BuyStoreItemResponse>;
     inboxGetMessages(user_ext_id: string, limit?: number, offset?: number): Promise<GetInboxMessagesResponse>;
-    storeGetItems(user_ext_id: string): Promise<GetStoreItemsResponse>;
+    storeGetItems(user_ext_id: string, force_language?: string): Promise<GetStoreItemsResponse>;
     storeGetItemsT(user_ext_id: string): Promise<TStoreItem[]>;
-    storeGetCategories(user_ext_id: string): Promise<GetCategoriesStoreResponse>;
+    storeGetCategories(user_ext_id: string, force_language?: string): Promise<GetCategoriesStoreResponse>;
     storeGetCategoriesT(user_ext_id: string): Promise<TStoreCategory[]>;
     storeGetPurchasedItems(user_ext_id: string, limit?: number, offset?: number): Promise<GetStoreHistoryResponse>;
     storeGetPurchasedItemsT(user_ext_id: string, limit?: number, offset?: number): Promise<TStoreItem[]>;
-    missionsGetItems(user_ext_id: string): Promise<GetAchievementMapResponse>;
+    missionsGetItems(user_ext_id: string, force_language?: string): Promise<GetAchievementMapResponse>;
     missionsGetItemsT(user_ext_id: string): Promise<TMissionOrBadge[]>;
     getUserGamificationInfo(user_ext_id: string): Promise<GetAchievementsUserInfoResponse>;
     getUserGamificationInfoT(user_ext_id: string): Promise<UserLevelExtraCountersT>;
-    achGetCategories(user_ext_id: string): Promise<GetAchCategoriesResponse>;
+    achGetCategories(user_ext_id: string, force_language?: string): Promise<GetAchCategoriesResponse>;
     achGetCategoriesT(user_ext_id: string): Promise<TAchCategory[]>;
-    badgetsGetItems(user_ext_id: string): Promise<GetAchievementMapResponse>;
+    badgetsGetItems(user_ext_id: string, force_language?: string): Promise<GetAchievementMapResponse>;
     badgetsGetItemsT(user_ext_id: string): Promise<TMissionOrBadge[]>;
-    tournamentsGetLobby(user_ext_id: string): Promise<GetTournamentsResponse>;
+    tournamentsGetLobby(user_ext_id: string, force_language?: string): Promise<GetTournamentsResponse>;
     tournamentsGetLobbyT(user_ext_id: string): Promise<TTournament[]>;
-    tournamentsGetInfo(user_ext_id: string, tournamentInstanceId: number): Promise<GetTournamentInfoResponse>;
+    tournamentsGetInfo(user_ext_id: string, tournamentInstanceId: number, force_language?: string): Promise<GetTournamentInfoResponse>;
     tournamentsGetInfoT(user_ext_id: string, tournamentInstanceId: number): Promise<TTournamentDetailed>;
-    leaderboardGet(user_ext_id: string, period_type_id?: LeaderBoardPeriodType, prevPeriod?: boolean): Promise<LeaderBoardDetails>;
+    leaderboardGet(user_ext_id: string, period_type_id?: LeaderBoardPeriodType, prevPeriod?: boolean, force_language?: string): Promise<LeaderBoardDetails>;
     leaderboardsGetT(user_ext_id: string, period_type_id?: LeaderBoardPeriodType, prevPeriod?: boolean): Promise<LeaderBoardDetailsT>;
-    levelsGet(user_ext_id: string): Promise<GetLevelMapResponse>;
+    levelsGet(user_ext_id: string, force_language?: string): Promise<GetLevelMapResponse>;
     levelsGetT(user_ext_id: string): Promise<TLevel[]>;
     getTranslationsT(user_ext_id: string, lang_code: string, areas: TranslationArea[], cacheSec?: number): Promise<GetTranslationsResponse>;
     getInboxMessages(user_ext_id: string, limit: number, offset: number, starred_only: boolean): Promise<GetInboxMessagesResponse>;

package/dist/WSAPI/WSAPI.d.ts

@@ -10,37 +10,49 @@ export declare class WSAPI {
     /** @private */
     constructor(api: SmarticoAPI);
     /** Returns information about current user
-     * Example usage:
+     *
+     * **Example**:
      * ```
      * _smartico.api.getUserProfile().then((result) => {
      *  console.log(result);
      * });
      * ```
+     * **Visitor mode: not supported**
      * */
     getUserProfile(): TUserProfile;
     /** Check if user belongs to specific segments
-     * Example usage:
+     * **Example**:
      * ```
      * _smartico.api.checkSegmentMatch(1).then((result) => {
      *   console.log(result);
      * });
      * ```
+     *
+     * **Visitor mode: not supported**
     */
     checkSegmentMatch(segment_id: number): Promise<boolean>;
     /** Check if user belongs to specific list of segments
-     * Example usage:
+     * **Example**:
      * ```
      * _smartico.api.checkSegmentListMatch([1, 2, 3]).then((result) => {
      *    console.log(result);
      * });
      * ```
+     * **Visitor mode: not supported**
     */
     checkSegmentListMatch(segment_ids: number[]): Promise<TSegmentCheckResult[]>;
     /** Returns all the levels available the current user
-     * Example usage:
+     * **Example**:
      * ```
      * _smartico.api.getLevels().then((result) => {
-     *   console.log(result);
+     *      console.log(result);
+     * });
+     * ```
+     *
+     * **Example in the Visitor mode**:
+     * ```
+     * _smartico.vapi('EN').getLevels().then((result) => {
+     *      console.log(result);
      * });
      * ```
     */
@@ -49,98 +61,241 @@ export declare class WSAPI {
      * The returned missions are cached for 30 seconds. But you can pass the onUpdate callback as a parameter.
      * Note that each time you call getMissions with a new onUpdate callback, the old one will be overwritten by the new one.
      * The onUpdate callback will be called on mission OptIn and the updated missions will be passed to it.
-     * Example usage:
+     *
+     * **Example**:
      * ```
      * _smartico.api.getMissions().then((result) => {
-     *  console.log(result);
+     *      console.log(result);
+     * });
+     * ```
+     *
+     * **Example in the Visitor mode**:
+     * ```
+     * _smartico.vapi('EN').getMissions().then((result) => {
+     *      console.log(result);
      * });
      * ```
-     /**
-     * @param params
      */
     getMissions({ onUpdate }?: {
         onUpdate?: (data: TMissionOrBadge[]) => void;
     }): Promise<TMissionOrBadge[]>;
-    /** Returns all the badges available the current user */
+    /**
+     * Returns all the badges available the current user
+     *
+     * **Visitor mode: not supported**
+    */
     getBadges(): Promise<TMissionOrBadge[]>;
     /**
      * Returns the extra counters for the current user level.
      * These are counters that are configured for each Smartico client separatly by request.
      * For example 1st counter could be total wagering amount, 2nd counter could be total deposit amount, etc.
-     * Example usage:
+     *
+     * **Example**:
      * ```
      * _smartico.api.getUserLevelExtraCounters().then((result) => {
      *      console.log(result);
      * });
      * ```
+     *
+     * **Visitor mode: not supported**
     */
     getUserLevelExtraCounters(): Promise<UserLevelExtraCountersT>;
-    /** Returns all the store items available the current user
-     * Example usage:
+    /**
+     *
+     * Returns all the store items available the current user
+     *
+     * **Example**:
      * ```
      * _smartico.api.getStoreItems().then((result) => {
      *      console.log(result);
      * });
+     * ```
+     *
+     * **Example in the Visitor mode**:
+     * ```
+     * _smartico.vapi('EN').getStoreItems().then((result) => {
+     *      console.log(result);
+     * });
     */
     getStoreItems(): Promise<TStoreItem[]>;
     /** Buy the specific shop item by item_id. Returns the err_code in case of success or error.
-     * Example usage:
+     * **Example**:
      * ```
      * _smartico.api.buyStoreItem(1).then((result) => {
      *     console.log(result);
      * });
+     * ```
+     *
+     * **Visitor mode: not supported**
     */
     buyStoreItem(item_id: number): Promise<TBuyStoreItemResult>;
-    /** Returns store categories */
+    /**
+     *
+     * Returns store categories
+     *
+     * **Example**:
+     * ```
+     * _smartico.api.getStoreCategories().then((result) => {
+     *      console.log(result);
+     * });
+     * ```
+     *
+     * **Example in the Visitor mode**:
+     * ```
+     * _smartico.vapi('EN').getStoreCategories().then((result) => {
+     *      console.log(result);
+     * });
+     */
     getStoreCategories(): Promise<TStoreCategory[]>;
-    /** Returns purchased items based on the provided parameters. "Limit" and "offset" indicate the range of items to be fetched.
+    /**
+    * Returns purchased items based on the provided parameters. "Limit" and "offset" indicate the range of items to be fetched.
     * The maximum number of items per request is limited to 20.
     * You can leave this params empty and by default it will return list of purchased items ranging from 0 to 20.
-    * Example usage:
+    *
+    * **Example**:
     * ```
     * _smartico.api.getStorePurchasedItems().then((result) => {
     *      console.log(result);
     * });
     * ```
+    *
+    * **Visitor mode: not supported**
    */
     getStorePurchasedItems({ limit, offset, onUpdate }?: {
         limit?: number;
         offset?: number;
         onUpdate?: (data: TStoreItem[]) => void;
     }): Promise<TStoreItem[]>;
-    /** Returns missions & badges categories */
-    getAchCategories(): Promise<TAchCategory[]>;
-    /** Returns the list of mini-games available for user
-     * 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. */
     /**
+     * Returns missions & badges categories
+     *
+     * **Example**:
+     * ```
+     * _smartico.api.getAchCategories().then((result) => {
+     *      console.log(result);
+     * });
+     * ```
+     *
+     * **Example in the Visitor mode**:
+     * ```
+     * _smartico.vapi('EN').getAchCategories().then((result) => {
+     *      console.log(result);
+     * });
+     * ```
+     *
+     * */
+    getAchCategories(): Promise<TAchCategory[]>;
     /**
-     * @param params
+     * Returns the list of mini-games available for user
+     * 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.
+     *
+     * **Example**:
+     * ```
+     * _smartico.api.getMiniGames().then((result) => {
+     *      console.log(result);
+     * });
+     * ```
+     *
+     * **Example in the Visitor mode**:
+     * ```
+     * _smartico.vapi('EN').getMiniGames().then((result) => {
+     *      console.log(result);
+     * });
+     * ```
+     *
      */
     getMiniGames({ onUpdate }?: {
         onUpdate?: (data: TMiniGameTemplate[]) => void;
     }): Promise<TMiniGameTemplate[]>;
-    /** Plays the specified by template_id mini-game on behalf of user and returns prize_id or err_code  */
+    /**
+     * Plays the specified by template_id mini-game on behalf of user and returns prize_id or err_code
+     *
+     * **Visitor mode: not supported**
+    */
     playMiniGame(template_id: number): Promise<TMiniGamePlayResult>;
-    /** Requests an opt-in for the specified mission_id. Returns the err_code. */
+    /**
+     * Requests an opt-in for the specified mission_id. Returns the err_code.
+     *
+     * **Visitor mode: not supported**
+    */
     requestMissionOptIn(mission_id: number): Promise<TMissionOptInResult>;
-    /** Request for claim reward for the specified mission id. Returns the err_code. */
+    /**
+     * Request for claim reward for the specified mission id. Returns the err_code.
+     *
+     * **Visitor mode: not supported**
+    */
     requestMissionClaimReward(mission_id: number, ach_completed_id: number): Promise<TMissionClaimRewardResult>;
     /** Returns all the active instances of tournaments
      * The returned list is cached for 30 seconds. But you can pass the onUpdate callback as a parameter. Note that each time you call getTournamentsList with a new onUpdate callback, the old one will be overwritten by the new one.
-     * The onUpdate callback will be called when the user has registered in a tournament. Updated list will be passed to onUpdate callback.*/
-    /**
-     * @param params
-     */
+     * The onUpdate callback will be called when the user has registered in a tournament. Updated list will be passed to onUpdate callback.
+     *
+     * **Example**:
+     * ```
+     * _smartico.api.getTournamentsList().then((result) => {
+     *      console.log(result);
+     * });
+     * ```
+     *
+     * **Example in the Visitor mode**:
+     * ```
+     * _smartico.vapi('EN').getTournamentsList().then((result) => {
+     *      console.log(result);
+     * });
+     * ```
+     * */
     getTournamentsList({ onUpdate }?: {
         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 details information of specific tournament instance, the response will include tournament info and the leaderboard of players
+     *
+    * **Example**:
+     * ```
+     * _smartico.api.getTournamentsList().then((result) => {
+     *      if (result.length > 0) {
+     *         _smartico.api.getTournamentInstanceInfo(result[0].instance_id).then((result) => {
+     *             console.log(result);
+     *        });
+     *     }
+     * });
+     * ```
+     *
+     * **Example in the Visitor mode**:
+     * ```
+     * _smartico.vapi('EN').getTournamentsList().then((result) => {
+     *      if (result.length > 0) {
+     *         _smartico.vapi('EN').getTournamentInstanceInfo(result[0].instance_id).then((result) => {
+     *             console.log(result);
+     *        });
+     *     }
+     * });
+     * ```
+     */
     getTournamentInstanceInfo(tournamentInstanceId: number): Promise<TTournamentDetailed>;
-    /** Requests registration for the specified tournament instance. Returns the err_code. */
+    /**
+     * Requests registration for the specified tournament instance. Returns the err_code.
+     *
+     * **Visitor mode: not supported**
+    */
     registerInTournament(tournamentInstanceId: number): Promise<TTournamentRegistrationResult>;
-    /** Returns the leaderboard for the current type (default is Daily). If getPreviousPeriod is passed as true, a leaderboard for the previous period for the current type will be returned.
-        For example, if the type is Weekly and getPreviousPeriod is true, a leaderboard for the previous week will be returned.
+    /**
+     * Returns the leaderboard for the current type (default is Daily). If getPreviousPeriod is passed as true, a leaderboard for the previous period for the current type will be returned.
+     * For example, if the type is Weekly and getPreviousPeriod is true, a leaderboard for the previous week will be returned.
+     *
+     * **Example**:
+     * ```
+     * _smartico.api.getLeaderBoard(1).then((result) => {
+     *     console.log(result);
+     * });
+     * ```
+     *
+     * **Example in the Visitor mode**:
+     * ```
+     * _smartico.vapi('EN').getLeaderBoard(1).then((result) => {
+     *    console.log(result);
+     * });
+     * ```
      */
     getLeaderBoard(periodType: LeaderBoardPeriodType, getPreviousPeriod?: boolean): Promise<LeaderBoardDetailsT>;
     /** Returns inbox messages based on the provided parameters. "From" and "to" indicate the range of messages to be fetched.
@@ -149,8 +304,10 @@ export declare class WSAPI {
     * This functions return list of messages without the body of the 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. */
-    /**
+    * 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.
+    *
+    * **Visitor mode: not supported**
+    *
     * @param params
     */
     getInboxMessages({ from, to, onlyFavorite, onUpdate }?: {
@@ -159,19 +316,45 @@ export declare class WSAPI {
         onlyFavorite?: boolean;
         onUpdate?: (data: TInboxMessage[]) => void;
     }): Promise<TInboxMessage[]>;
-    /** Returns the message body of the specified message guid. */
+    /**
+     * Returns the message body of the specified message guid.
+    *
+    * **Visitor mode: not supported**
+    */
     getInboxMessageBody(messageGuid: string): Promise<TInboxMessageBody>;
-    /** Requests to mark inbox message with specified guid as read */
+    /**
+     * Requests to mark inbox message with specified guid as read
+     *
+     * **Visitor mode: not supported**
+     */
     markInboxMessageAsRead(messageGuid: string): Promise<InboxMarkMessageAction>;
-    /** Requests to mark all inbox messages as read */
+    /**
+     * Requests to mark all inbox messages as rea
+     *
+     * **Visitor mode: not supported**
+    */
     markAllInboxMessagesAsRead(): Promise<InboxMarkMessageAction>;
-    /** Requests to mark inbox message with specified guid as favorite. Pass mark true to add message to favorite and false to remove. */
+    /**
+     * Requests to mark inbox message with specified guid as favorite. Pass mark true to add message to favorite and false to remove.
+     *
+     * **Visitor mode: not supported**
+     */
     markUnmarkInboxMessageAsFavorite(messageGuid: string, mark: boolean): Promise<InboxMarkMessageAction>;
-    /** Requests to delete inbox message */
+    /**
+     * Requests to delete inbox message
+     *
+     * **Visitor mode: not supported**
+     */
     deleteInboxMessage(messageGuid: string): Promise<InboxMarkMessageAction>;
-    /** Requests to delete all inbox messages */
+    /**
+     * Requests to delete all inbox messages
+     *
+     * **Visitor mode: not supported**
+     */
     deleteAllInboxMessages(): Promise<InboxMarkMessageAction>;
-    /** Requests translations for the given language. Returns the object including translation key/translation value pairs. All possible translation keys defined in the back office. */
+    /**
+     * Requests translations for the given language. Returns the object including translation key/translation value pairs. All possible translation keys defined in the back office.
+    */
     getTranslations(lang_code: string): Promise<TGetTranslations>;
     private updateOnSpin;
     private updateOnAddSpin;
@@ -185,37 +368,55 @@ export declare class WSAPI {
      * 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
-     * Example usage:
+     *
+     * **Example**:
      * ```
      * _smartico.api.jackpotGet({ related_game_id: 'wooko-slot' }).then((result) => {
      *      console.log(result);
      * });
      * ```
+     *
+     * **Example in the Visitor mode**:
+     * ```
+     * _smartico.vapi('EN').jackpotGet({ related_game_id: 'wooko-slot' }).then((result) => {
+     *      console.log(result);
+     * });
+     * ```
     */
     jackpotGet(filter?: {
         related_game_id?: string;
         jp_template_id?: number;
     }): Promise<JackpotDetails[]>;
-    /** Opt-in currently logged in user to the jackpot with the specified jp_template_id.
+    /**
+     * Opt-in currently logged in user to the jackpot with the specified jp_template_id.
      * You may call jackpotGet method after doing optin to see that user is opted in to the jackpot.
-     * Example usage:
+     *
+     * **Example**:
      * ```
      * _smartico.api.jackpotOptIn({ jp_template_id: 123 }).then((result) => {
      *      console.log('Opted in to the jackpot');
      * });
      * ```
+     *
+     * **Visitor mode: not supported**
+     *
     */
     jackpotOptIn(filter: {
         jp_template_id: number;
     }): Promise<JackpotsOptinResponse>;
-    /** Opt-out currently logged in user from the jackpot with the specified jp_template_id.
+    /**
+     * Opt-out currently logged in user from the jackpot with the specified jp_template_id.
      * You may call jackpotGet method after doing optout to see that user is not opted in to the jackpot.
-     * Example usage:
+     *
+     * **Example**:
      * ```
      * _smartico.api.jackpotOptOut({ jp_template_id: 123 }).then((result) => {
      *      console.log('Opted out from the jackpot');
      * });
      * ```
+     *
+     * **Visitor mode: not supported**
+     *
     */
     jackpotOptOut(filter: {
         jp_template_id: number;