@smartico/public-api 0.0.282 → 0.0.284

package/dist/service/index.d.ts

@@ -0,0 +1,5 @@
+import { ErrorCodes, ErrorCodesGame } from './types/ErrorCodes';
+import { GBaseRequest } from './types/GRequest';
+import { GResponseBase, GResponse } from './types/GResponse';
+import { SAWSpinErrorCode } from './types/SmarticoProto/SAW/SAWDoSpinResponse';
+export { ErrorCodes, ErrorCodesGame, SAWSpinErrorCode, GBaseRequest, GResponseBase, GResponse, };

package/dist/service/types/ErrorCodes.d.ts

@@ -0,0 +1,13 @@
+import { SAWSpinErrorCode } from "./SmarticoProto/SAW/SAWDoSpinResponse";
+export declare const ErrorCodes_FatalStartingRange = 100000;
+export declare enum ErrorCodesGame {
+    OK = 0,
+    NoBetsUpdatedOnSubmit = 3,
+    RepeatRequest_Unhandled = 4,
+    Fatal_NotValidHash,
+    Fatal_WrongCustomerID,
+    Fatal_TemplateNotFound,
+    Fatal_NoOpenRounds,
+    Fatal_Unhandled
+}
+export type ErrorCodes = SAWSpinErrorCode | ErrorCodesGame;

package/dist/service/types/GRequest.d.ts

@@ -0,0 +1,16 @@
+interface GBaseRequest {
+    customer_id: string;
+    ext_user_id: string;
+    int_user_id: number;
+    smartico_ext_user_id: string;
+    ext_game_id: number;
+    lang: string;
+    hash: string;
+    zoom?: number;
+    label_api_key?: string;
+    brand_key?: string;
+    bridgeId?: string;
+    height?: 'auto' | string;
+    theme?: string;
+}
+export { GBaseRequest };

package/dist/service/types/GResponse.d.ts

@@ -0,0 +1,10 @@
+import { ErrorCodes } from "./ErrorCodes";
+interface GResponseBase {
+    errCode: ErrorCodes;
+    errMessage?: string;
+}
+interface GResponse<T> extends GResponseBase {
+    data?: T;
+}
+declare const SMX = 1;
+export { GResponseBase, GResponse, SMX };

package/dist/service/types/Game/GameAttemptType.d.ts

@@ -0,0 +1,6 @@
+declare enum GameAttemptType {
+    Free = 1,
+    Points = 2,
+    Attempts = 3
+}
+export { GameAttemptType };

package/dist/service/types/Game/GameCanPlayType.d.ts

@@ -0,0 +1,10 @@
+declare enum GameCanPlayType {
+    Yes = 1,
+    NotEnoughPoints = 2,
+    NotEnoughAttempts = 3,
+    InactiveGame = 4,
+    TimeRestrictions = 5,
+    SegmentRestrictions = 6,
+    GameNotFound = 7
+}
+export { GameCanPlayType };

package/dist/service/types/Game/GameExternalStatus.d.ts

@@ -0,0 +1,6 @@
+declare enum GameExternalStatus {
+    Draft = 1,
+    Active = 2,
+    Archived = 3
+}
+export { GameExternalStatus };

package/dist/service/types/Game/GameInfo.d.ts

@@ -0,0 +1,9 @@
+import { ResponseIdentifyLabelInfo } from "../SmarticoProto/PublicLabelInfo";
+import { GamePickRoundBase } from "./GamePick";
+import { SAWTemplate } from "../SmarticoProto/SAW/SAWTemplate";
+interface GameInfo {
+    sawTemplate: SAWTemplate;
+    allRounds: GamePickRoundBase[];
+    labelInfo: ResponseIdentifyLabelInfo;
+}
+export { GameInfo };

package/dist/service/types/Game/GamePick.d.ts

@@ -0,0 +1,90 @@
+declare enum GamePickMarketType {
+    Goals = 1,
+    Winner = 2
+}
+declare enum GamePickResolutionType {
+    None = 0,
+    Lost = 2,
+    PartialWin = 3,
+    FullWin = 4
+}
+declare enum GPRoundStatus {
+    Other = -1,
+    NoEventsDefined = 1,
+    NoMoreBetsAllowed = 2,
+    AllEventsResolved_ButNotRound = 3,
+    RoundResolved = 4
+}
+interface GamePickEventMeta {
+    event_name?: string;
+    team1_name: string;
+    team1_image: string;
+    team2_name: string;
+    team2_image: string;
+    team1_result?: number;
+    team2_result?: number;
+}
+interface GamePickEvent {
+    gp_event_id: number;
+    event_resolution_date: number;
+    match_date: number;
+    market_type_id: GamePickMarketType;
+    event_meta: GamePickEventMeta;
+    user_placed_bet: boolean;
+    team1_user_selection: number;
+    team2_user_selection: number;
+    resolution_type_id: GamePickResolutionType;
+    resolution_score?: number;
+    is_open_for_bets?: boolean;
+}
+interface GamePickRoundBase {
+    round_id: number;
+    round_row_id: number;
+    round_name: string;
+    round_description: string;
+    open_date: number;
+    last_bet_date: number;
+    resolution_date: number;
+    score_full_win: number;
+    score_part_win: number;
+    score_lost: number;
+    is_active_now: boolean;
+    is_resolved: boolean;
+    round_status_id: GPRoundStatus;
+    events_total: number;
+    events_resolved: number;
+    public_meta: {
+        round_name: string;
+        round_description: string;
+        _translations: {
+            [key: string]: {
+                round_name: string;
+                round_description: string;
+            };
+        };
+    };
+    next_round_open_date: number;
+}
+interface GamePickRoundBoard extends GamePickRoundBase {
+    my_user: GamePickBoardUser;
+    users: GamePickBoardUser[];
+}
+interface GamePickRound extends GamePickRoundBase {
+    events: GamePickEvent[];
+    user_score: number;
+    user_placed_bet: boolean;
+    has_open_for_bet_events?: boolean;
+    has_not_submitted_changes?: boolean;
+}
+interface GamePickBoardUser {
+    ext_user_id: string;
+    int_user_id: number;
+    public_username: string;
+    avatar_url: string;
+    gp_position: number;
+    resolution_score: number;
+    full_wins_count: number;
+    part_wins_count: number;
+    lost_count: number;
+}
+export { GamePickRoundBase, GamePickRound, GamePickEvent, GamePickMarketType, GamePickResolutionType, GamePickEventMeta, GPRoundStatus, GamePickRoundBoard, GamePickBoardUser };

package/dist/service/types/Game/GameUtil.d.ts

@@ -0,0 +1,7 @@
+import { GameInfo } from "./GameInfo";
+import { GamePickRound, GamePickRoundBase } from "./GamePick";
+declare class GameUtil {
+    static getRoundName(round: GamePickRoundBase, gameInfo: GameInfo): string;
+    static getRoundDescription(round: GamePickRound, gameInfo: GameInfo): string;
+}
+export { GameUtil };

package/dist/service/types/SmarticoProto/GetTranslationsRequest.d.ts

@@ -0,0 +1,7 @@
+import { ProtocolRequest } from "./ProtocolRequest";
+import { TranslationArea } from "./TranslationArea";
+export interface GetTranslationsRequest extends ProtocolRequest {
+    hash_code: number;
+    areas: TranslationArea[];
+    lang_code: string;
+}

package/dist/service/types/SmarticoProto/GetTranslationsResponse.d.ts

@@ -0,0 +1,7 @@
+import { ProtocolResponse } from "./ProtocolResponse";
+export interface GetTranslationsResponse extends ProtocolResponse {
+    hash_code: number;
+    translations: {
+        [key: string]: string;
+    };
+}

package/dist/service/types/SmarticoProto/ProtocolMessage.d.ts

@@ -0,0 +1,5 @@
+export interface ProtocolMessage {
+    cid: number;
+    ts?: number;
+    uuid?: string;
+}

package/dist/service/types/SmarticoProto/ProtocolRequest.d.ts

@@ -0,0 +1,6 @@
+import { ProtocolMessage } from "./ProtocolMessage";
+export interface ProtocolRequest extends ProtocolMessage {
+    api_key: string;
+    brand_key: string;
+    ext_user_id: string;
+}

package/dist/service/types/SmarticoProto/ProtocolResponse.d.ts

@@ -0,0 +1,5 @@
+import { ProtocolMessage } from "./ProtocolMessage";
+export interface ProtocolResponse extends ProtocolMessage {
+    errCode?: number;
+    errMsg?: string;
+}

package/dist/service/types/SmarticoProto/PublicLabelInfo.d.ts

@@ -0,0 +1,34 @@
+export declare enum PublicLabelSettings {
+    FCM_SENDER_ID = "FCM_SENDER_ID",
+    PUBLIC_API_URL = "PUBLIC_API_URL",
+    FCM_SW_URL = "FCM_SW_URL",
+    RECORDING_ENABLED_FOR_ALL_USERS = "RECORDING_ENABLED_FOR_ALL_USERS",
+    JS_INJECTION = "JS_INJECTION",
+    GAMIFICATION_UI_MAIN = "GAMIFICATION_UI_MAIN",
+    GAMIFICATION_UI_WIDGET = "GAMIFICATION_UI_WIDGET",
+    GAMIFICATION_UI_MINI_GAME = "GAMIFICATION_UI_MINI_GAME",
+    GAMIFICATION_UI_SETTINGS = "GAMIFICATION_UI_SETTINGS",
+    GAMIFICATION_UI_MAIN_TEST = "GAMIFICATION_UI_MAIN_TEST",
+    GAMIFICATION_UI_WIDGET_TEST = "GAMIFICATION_UI_WIDGET_TEST",
+    GAMIFICATION_UI_SETTINGS_TEST = "GAMIFICATION_UI_SETTINGS_TEST",
+    FRONT_END_ALLOWED_LANGUAGES = "FRONT_END_ALLOWED_LANGUAGES",
+    FRONT_END_ALLOW_DOMAINS = "FRONT_END_ALLOW_DOMAINS",
+    DELAY_ENGAGEMENT_EXECUTION_ON_LOGIN_MS = "DELAY_ENGAGEMENT_EXECUTION_ON_LOGIN_MS",
+    SHADOW_LABEL_PUBLIC_KEY = "SHADOW_LABEL_PUBLIC_KEY",
+    DYNAMIC_IMAGE_DOMAIN = "DYNAMIC_IMAGE_DOMAIN",
+    GAMIFICATION_UI_LEVEL_ENABLED = "GAMIFICATION_UI_LEVEL_ENABLED",
+    GAMIFICATION_UI_LEVEL_IMAGE_MOB = "GAMIFICATION_UI_LEVEL_IMAGE_MOB",
+    GAMIFICATION_UI_LEVEL_IMAGE_DESK = "GAMIFICATION_UI_LEVEL_IMAGE_DESK",
+    GAMIFICATION_LEVELS_LOGIC2 = "GAMIFICATION_LEVELS_LOGIC2",
+    AVATAR_CUSTOM_IMAGE_MAX_ID = "AVATAR_CUSTOM_IMAGE_MAX_ID",
+    AVATAR_CUSTOM_IMAGE_FOLDER = "AVATAR_CUSTOM_IMAGE_FOLDER",
+    RETENTION_GAMES_CUSTOMER_ID = "RETENTION_GAMES_CUSTOMER_ID",
+    GAMIFICATION_SHOW_POWERED_BY = "GAMIFICATION_SHOW_POWERED_BY",
+    _system_leader_board_mask_username = "_system_leader_board_mask_username"
+}
+export interface ResponseIdentifyLabelInfo {
+    settings: {
+        [key: string]: string;
+    };
+    label_id: string;
+}

package/dist/service/types/SmarticoProto/PublicProperties.d.ts

@@ -0,0 +1,11 @@
+export interface PublicProperties {
+    core_user_language?: string;
+    ach_points_balance?: number;
+    ach_points_ever?: number;
+    ach_points_board_period_type_1?: number;
+    ach_points_board_period_type_2?: number;
+    ach_level_current_id?: number;
+    ach_level_current?: string;
+    core_is_test_account?: boolean;
+    ach_gamification_in_control_group?: boolean;
+}

package/dist/service/types/SmarticoProto/ResponseIdentify.d.ts

@@ -0,0 +1,12 @@
+import { ProtocolResponse } from "./ProtocolResponse";
+import { PublicProperties } from "./PublicProperties";
+interface ResponseIdentify extends ProtocolResponse {
+    user_id: number;
+    ext_user_id: string;
+    public_username: string;
+    avatar_id: string;
+    job: boolean;
+    props?: PublicProperties;
+    pubic_username_set: boolean;
+}
+export { ResponseIdentify };

package/dist/service/types/SmarticoProto/SAW/SAWAcknowledgeType.d.ts

@@ -0,0 +1,5 @@
+export declare enum SAWAcknowledgeType {
+    Silent = 1,
+    QuickMessage = 2,
+    FullMessage = 3
+}

package/dist/service/types/SmarticoProto/SAW/SAWBuyInType.d.ts

@@ -0,0 +1,5 @@
+export declare enum SAWBuyInType {
+    Free = 1,
+    Points = 2,
+    Spins = 3
+}

package/dist/service/types/SmarticoProto/SAW/SAWDoSpinRequest.d.ts

@@ -0,0 +1,5 @@
+import { ProtocolRequest } from "./ProtocolRequest";
+export interface SAWDoSpinRequest extends ProtocolRequest {
+    request_id: string;
+    saw_template_id: number;
+}

package/dist/service/types/SmarticoProto/SAW/SAWDoSpinResponse.d.ts

@@ -0,0 +1,15 @@
+import { ProtocolResponse } from "../ProtocolResponse";
+export declare enum SAWSpinErrorCode {
+    SAW_OK = 0,
+    SAW_NO_SPINS = 40001,
+    SAW_PRIZE_POOL_EMPTY = 40002,
+    SAW_NOT_ENOUGH_POINTS = 40003,
+    SAW_FAILED_MAX_SPINS_REACHED = 40004
+}
+export interface SAWDoSpinResponse extends ProtocolResponse {
+    errCode: SAWSpinErrorCode;
+    errMsg?: string;
+    request_id: string;
+    saw_prize_id: number;
+    first_spin_in_period: number;
+}

package/dist/service/types/SmarticoProto/SAW/SAWGameType.d.ts

@@ -0,0 +1,10 @@
+export declare enum SAWGameType {
+    SpinAWheel = 1,
+    ScratchCard = 2,
+    SportPick = 3
+}
+export declare const SAWGameTypeName: {
+    1: string;
+    2: string;
+    3: string;
+};

package/dist/service/types/SmarticoProto/SAW/SAWGetTemplatesRequest.d.ts

@@ -0,0 +1,3 @@
+import { ProtocolRequest } from "../ProtocolRequest";
+export interface SAWGetTemplatesRequest extends ProtocolRequest {
+}

package/dist/service/types/SmarticoProto/SAW/SAWGetTemplatesResponse.d.ts

@@ -0,0 +1,5 @@
+import { ProtocolResponse } from "../ProtocolResponse";
+import { SAWTemplate } from "./SAWTemplate";
+export interface SAWGetTemplatesResponse extends ProtocolResponse {
+    templates: SAWTemplate[];
+}

package/dist/service/types/SmarticoProto/SAW/SAWPrize.d.ts

@@ -0,0 +1,11 @@
+import { SAWPrizeType } from "./SAWPrizeType";
+import { SAWPrizeUI } from "./SAWPrizeUI";
+export interface SAWPrize {
+    saw_prize_id: number;
+    saw_prize_ui_definition: SAWPrizeUI;
+    prize_value?: number;
+    prize_type_id: SAWPrizeType;
+    place_from?: number;
+    place_to?: number;
+    sawUniqueWinId?: string;
+}

package/dist/service/types/SmarticoProto/SAW/SAWPrizeType.d.ts

@@ -0,0 +1,8 @@
+export declare enum SAWPrizeType {
+    NO_PRIZE = 1,
+    POINTS = 2,
+    BONUS = 3,
+    MANUAL = 4,
+    SPIN = 5,
+    JACKPOT = 6
+}

package/dist/service/types/SmarticoProto/SAW/SAWPrizeUI.d.ts

@@ -0,0 +1,13 @@
+import { SAWAcknowledgeType } from "./SAWAcknowledgeType";
+import { SAWWinSoundType } from "./SAWWinSoundType";
+export interface SAWPrizeUI {
+    position?: number;
+    name: string;
+    aknowledge_message: string;
+    sectors: number[];
+    acknowledge_type: SAWAcknowledgeType;
+    acknowledge_dp?: string;
+    font_size?: number;
+    sound_type: SAWWinSoundType;
+    icon?: string;
+}

package/dist/service/types/SmarticoProto/SAW/SAWTemplate.d.ts

@@ -0,0 +1,21 @@
+import { SAWBuyInType } from "./SAWBuyInType";
+import { SAWGameType } from "./SAWGameType";
+import { SAWPrize } from "./SAWPrize";
+import { SAWTemplateUI } from "./SAWTemplateUI";
+export interface SAWTemplate {
+    saw_template_id: number;
+    saw_game_type_id: SAWGameType;
+    saw_template_ui_definition: SAWTemplateUI;
+    saw_buyin_type_id: SAWBuyInType;
+    buyin_cost_points?: number;
+    visibile_when_can_spin: boolean;
+    spin_count?: number;
+    prizes: SAWPrize[];
+    is_visible: boolean;
+    jackpot_add_on_attempt: number;
+    jackpot_current: number;
+    jackpot_guaranteed: number;
+    maxActiveSpinsAllowed: number;
+    maxSpinsCount: number;
+    maxSpinsPediodMs: number;
+}

package/dist/service/types/SmarticoProto/SAW/SAWTemplateUI.d.ts

@@ -0,0 +1,31 @@
+export declare enum AskForUsername {
+    NOASK = "no-ask",
+    ONSUMBIT = "on-submit"
+}
+export interface SAWTemplateUI {
+    skin: string;
+    name: string;
+    description?: string;
+    over_limit_message?: string;
+    no_attempts_message?: string;
+    thumbnail?: string;
+    sectors_count: number;
+    priority: number;
+    flow_builder_only: boolean;
+    background_image?: string;
+    background_image_mobile?: string;
+    background_sound?: string;
+    scratch_logo?: string;
+    scratch_cover?: string;
+    scratch_bg_desktop?: string;
+    scratch_bg_mobile?: string;
+    scratch_cursor?: string;
+    custom_css?: string;
+    custom_skin_folder?: string;
+    jackpot_symbol?: string;
+    promo_image?: string;
+    promo_text?: string;
+    ask_for_username?: AskForUsername;
+    show_prize_board?: boolean;
+    max_spins_period_ms?: number;
+}

package/dist/service/types/SmarticoProto/SAW/SAWWinSoundType.d.ts

@@ -0,0 +1,12 @@
+export declare enum SAWWinSoundType {
+    Disappointing = 1,
+    Positive = 2,
+    HighlyPositive = 3,
+    NoSound = 4
+}
+export declare const SAWWinSoundFiles: {
+    4: any;
+    1: string;
+    2: string;
+    3: string;
+};

package/dist/service/types/SmarticoProto/TranslationArea.d.ts

@@ -0,0 +1,9 @@
+declare enum TranslationArea {
+    Casino = 1,
+    Gamification = 2,
+    Trading = 3,
+    Archived = 4,
+    Affiliation = 5,
+    RetentionGames = 6
+}
+export { TranslationArea };

package/dist/service/types/User/UserInfo.d.ts

@@ -0,0 +1,10 @@
+interface UserInfo {
+    ext_user_id: string;
+    int_user_id: number;
+    public_username: string;
+    avatar_url: string;
+    last_wallet_sync_time?: Date;
+    ach_points_balance?: number;
+    pubic_username_set?: boolean;
+}
+export { UserInfo };

package/dist/util/Util.d.ts

@@ -0,0 +1,51 @@
+import { TSMap } from "typescript-map";
+declare class Util {
+    private constructor();
+    static isNumber(value: string): boolean;
+    static parseNumber(v: string): number | null;
+    static parseBoolean(v: string | boolean): boolean | null;
+    static escapeRegExp(v: string): string;
+    static nullToEmpty(val: string): string;
+    static nullTo0(val: number): number;
+    static isNotEmpty(val: string): boolean;
+    static isNotNull(val: any): boolean;
+    static isNull(val: any): boolean;
+    static isArrayNotEmpty(val: any[]): boolean;
+    static isArrayEmpty(val: any[]): boolean;
+    static isObjectEmpty(val: any): boolean;
+    static isMapNotEmpty(val: TSMap<any, any>): boolean;
+    static isMapEmpty(val: TSMap<any, any>): boolean;
+    static objectToMap<K, V>(obj: any): TSMap<K, V> | null;
+    static keyByValue(obj: any, value: any): string | null;
+    static greaterThen0(val: number): boolean;
+    static not0(val: number): boolean;
+    static lessThen0(val: number): boolean;
+    static compareUndefined(o1: any, o2: any): number;
+    static compareArrayLength<T>(o1: T[], o2: T[]): number;
+    static compareObject(a: {
+        [key: string]: any;
+    }, b: {
+        [key: string]: any;
+    }): boolean;
+    static compareArrays<T>(arr1: T[], arr2: T[], comparator: (t1: T, t2: T) => number): number;
+    static compareBool(o1: boolean, o2: boolean): number;
+    static compareNumber(o1: number, o2: number): number;
+    static compareString(o1: string, o2: string): number;
+    static range(from: number, to: number): number[];
+    static has(array: any[], val: any): boolean;
+    static isEmpty(val: string): boolean;
+    static checkNotNull<T>(reference: T, msg?: string): T;
+    static randomInt(min: number, max: number): number;
+    static randomArr<T>(arr: T[]): T | undefined;
+    static remove<T>(arr: T[], item: T): boolean;
+    static replaceAll(value: string, regex: string, replacement: string | number): string;
+    static to<T, U = any>(promise: Promise<T>, errorExt?: object): Promise<[U | null, T | undefined]>;
+    static isObject(item: any): boolean;
+    static merge(target: any, ...sources: any[]): any;
+    static deepCopy(source: object): object;
+    static uuid: () => string;
+    static getStackTrace(): string | undefined;
+    static shuffleArray(array: any[]): any[];
+    static buildValidationHash(ext_user_id: string, ext_game_id: number, customer_id: string, secretKey: string): string;
+}
+export { Util };

package/docs/README.md

@@ -106,6 +106,7 @@
 - [TMiniGameTemplate](interfaces/TMiniGameTemplate.md)
 - [TUserProfile](interfaces/TUserProfile.md)
 - [TLevel](interfaces/TLevel.md)
+- [TLevelCurrent](interfaces/TLevelCurrent.md)
 - [TTournament](interfaces/TTournament.md)
 - [TTournamentDetailed](interfaces/TTournamentDetailed.md)
 - [TStoreCategory](interfaces/TStoreCategory.md)

package/docs/classes/WSAPI.md

@@ -98,6 +98,27 @@ _smartico.vapi('EN').getLevels().then((result) => {
 
 ___
 
+### getCurrentLevel
+
+▸ **getCurrentLevel**(): `Promise`\<[`TLevelCurrent`](../interfaces/TLevelCurrent.md)\>
+
+Returns the current level of the user with extended information including ordinal position and progress.
+
+**Example**:
+```
+_smartico.api.getCurrentLevel().then((result) => {
+     console.log(result);
+});
+```
+
+**Visitor mode: not supported**
+
+#### Returns
+
+`Promise`\<[`TLevelCurrent`](../interfaces/TLevelCurrent.md)\>
+
+___
+
 ### getMissions
 
 ▸ **getMissions**(`«destructured»?`): `Promise`\<[`TMissionOrBadge`](../interfaces/TMissionOrBadge.md)[]\>

package/docs/interfaces/JackpotPublicMeta.md

@@ -64,4 +64,4 @@ ___
 
 Custom data as string or JSON string that can be used in API to build custom UI
 You can request from Smartico to define fields for your specific case that will be managed from Smartico BackOffice
-Read more here - https://help.smartico.ai/welcome/products/general-concepts/custom-fields-attributes
+Read more here - <https://help.smartico.ai/welcome/products/general-concepts/custom-fields-attributes>

package/docs/interfaces/RaffleDraw.md

@@ -48,6 +48,7 @@ ___
 • **execution\_type**: [`RaffleDrawTypeExecution`](../enums/RaffleDrawTypeExecution.md)
 
 Type of the draw execution, indicating how and when the draw is executed.
+
 - ExecDate: Draw is executed only once at a specific date and time.
 - Recurring: Draw is executed on a recurring basis (e.g., daily, weekly).
 - Grand: Draw is executed once and is marked as grand, often with larger prizes or more importance.
@@ -83,9 +84,9 @@ ___
 • **ticket\_start\_ts**: `number`
 
 Date/time starting from which the tickets will participate in the upcoming draw
- This value need to be taken into account with next_execute_ts field value, for example
- Next draw is at 10:00, ticket_start_date is 9:00, so all tickets that are collected after 9:00 will participate in the draw at 10:00
- (internally this value is calculated as next_execute_ts - ticket_start_date)
+This value need to be taken into account with next_execute_ts field value, for example
+Next draw is at 10:00, ticket_start_date is 9:00, so all tickets that are collected after 9:00 will participate in the draw at 10:00
+(internally this value is calculated as next_execute_ts - ticket_start_date)
 
 ___
 
@@ -93,13 +94,13 @@ ___
 
 • **allow\_multi\_prize\_per\_ticket**: `boolean`
 
-Field is indicating if same ticket can win multiple prizes in the same draw 
- For example there are 3 types of prizes in the draw - iPhone, iPad, MacBook
- If this field is true, then one ticket can win all 3 prizes (depending on the chances of course), 
- if false, then one ticket can win only one prize. 
- The distribution of the prizes is start from top (assuming on top are the most valuable prizes) to bottom (less valuable prizes)
- If specific prize has multiple values, e.g. we have 3 iPhones, 
- then the same ticket can win only one prize of a kind, but can win multiple prizes of different kind (if allow_multi_prize_per_ticket is true)
+Field is indicating if same ticket can win multiple prizes in the same draw
+For example there are 3 types of prizes in the draw - iPhone, iPad, MacBook
+If this field is true, then one ticket can win all 3 prizes (depending on the chances of course),
+if false, then one ticket can win only one prize.
+The distribution of the prizes is start from top (assuming on top are the most valuable prizes) to bottom (less valuable prizes)
+If specific prize has multiple values, e.g. we have 3 iPhones,
+then the same ticket can win only one prize of a kind, but can win multiple prizes of different kind (if allow_multi_prize_per_ticket is true)
 
 ___
 
@@ -123,3 +124,5 @@ ___
 ### my\_last\_tickets
 
 • **my\_last\_tickets**: [`RaffleTicket`](RaffleTicket.md)[]
+
+List of last 5 tickets are collected by current user for this instance of draw.