@smartico/public-api 0.0.380 → 0.0.382

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (178) hide show
  1. package/CLAUDE.md +103 -0
  2. package/README.md +32 -10
  3. package/dist/Base/ClassId.d.ts +2 -0
  4. package/dist/Jackpots/JackpotDetails.d.ts +14 -15
  5. package/dist/Jackpots/JackpotPot.d.ts +10 -6
  6. package/dist/MiniGames/SAWGameType.d.ts +3 -1
  7. package/dist/MiniGames/SAWTemplateUI.d.ts +7 -0
  8. package/dist/Raffle/GetRaffleWonPrizesRequest.d.ts +9 -0
  9. package/dist/Raffle/GetRaffleWonPrizesResponse.d.ts +52 -0
  10. package/dist/Raffle/index.d.ts +2 -0
  11. package/dist/SmarticoAPI.d.ts +6 -1
  12. package/dist/SmarticoLib/index.d.ts +5 -1
  13. package/dist/WSAPI/WSAPIAvatars.d.ts +267 -49
  14. package/dist/WSAPI/WSAPIBonuses.d.ts +224 -10
  15. package/dist/WSAPI/WSAPIGamePick.d.ts +538 -253
  16. package/dist/WSAPI/WSAPIGeneral.d.ts +156 -14
  17. package/dist/WSAPI/WSAPIInbox.d.ts +547 -58
  18. package/dist/WSAPI/WSAPIJackpots.d.ts +292 -57
  19. package/dist/WSAPI/WSAPILeaderBoard.d.ts +127 -13
  20. package/dist/WSAPI/WSAPIMiniGames.d.ts +465 -49
  21. package/dist/WSAPI/WSAPIRaffles.d.ts +576 -52
  22. package/dist/WSAPI/WSAPITournaments.d.ts +3 -3
  23. package/dist/WSAPI/WSAPITypes.d.ts +243 -132
  24. package/dist/WSAPI/WSAPIUser.d.ts +193 -43
  25. package/dist/index.js +3412 -616
  26. package/dist/index.js.map +1 -1
  27. package/dist/index.modern.mjs +3395 -609
  28. package/dist/index.modern.mjs.map +1 -1
  29. package/docs/Callbacks.md +162 -0
  30. package/docs/SmarticoObject.md +445 -0
  31. package/docs/Transforms.md +99 -0
  32. package/docs/api/README.md +26 -0
  33. package/docs/api/classes/WSAPIAvatars.md +282 -54
  34. package/docs/api/classes/WSAPIBonuses.md +233 -12
  35. package/docs/api/classes/WSAPIClans.md +380 -10
  36. package/docs/api/classes/WSAPIGamePick.md +555 -26
  37. package/docs/api/classes/WSAPIGeneral.md +165 -16
  38. package/docs/api/classes/WSAPIInbox.md +588 -64
  39. package/docs/api/classes/WSAPIJackpots.md +320 -66
  40. package/docs/api/classes/WSAPILeaderBoard.md +133 -15
  41. package/docs/api/classes/WSAPIMiniGames.md +501 -64
  42. package/docs/api/classes/WSAPIMissions.md +58 -79
  43. package/docs/api/classes/WSAPIRaffles.md +647 -69
  44. package/docs/api/classes/WSAPIStore.md +83 -108
  45. package/docs/api/classes/WSAPITournaments.md +495 -28
  46. package/docs/api/classes/WSAPIUser.md +520 -83
  47. package/docs/api/documents/Callbacks.md +162 -0
  48. package/docs/api/documents/SmarticoObject.md +445 -0
  49. package/docs/api/documents/Transforms.md +99 -0
  50. package/docs/api/enumerations/BonusStatus-1.md +11 -6
  51. package/docs/api/enumerations/JoinClanErrorCode.md +81 -0
  52. package/docs/api/enumerations/TournamentRegistrationError.md +12 -0
  53. package/docs/api/functions/clanTournamentPlayersTransform.md +13 -0
  54. package/docs/api/interfaces/AvatarCustomized.md +25 -0
  55. package/docs/api/interfaces/AvatarDefinition.md +94 -0
  56. package/docs/api/interfaces/AvatarPrompt.md +45 -0
  57. package/docs/api/interfaces/BonusMetaMap-1.md +4 -1
  58. package/docs/api/interfaces/BonusTemplateMetaMap-1.md +9 -4
  59. package/docs/api/interfaces/Clan.md +4 -0
  60. package/docs/api/interfaces/ClanInfo.md +109 -0
  61. package/docs/api/interfaces/ClanMember.md +53 -0
  62. package/docs/api/interfaces/ClanTournamentPlayerRaw.md +67 -0
  63. package/docs/api/interfaces/GemsDiamondsLog.md +43 -0
  64. package/docs/api/interfaces/GetClanInfoResponse.md +61 -0
  65. package/docs/api/interfaces/GetClanTournamentPlayersResponse.md +81 -0
  66. package/docs/api/interfaces/GetRaffleWonPrizesRequest.md +59 -0
  67. package/docs/api/interfaces/GetRaffleWonPrizesResponse.md +95 -0
  68. package/docs/api/interfaces/InboxMarkMessageAction.md +10 -2
  69. package/docs/api/interfaces/JackpotDetails.md +14 -15
  70. package/docs/api/interfaces/JackpotPot.md +9 -6
  71. package/docs/api/interfaces/LeaderBoardDetailsT.md +14 -8
  72. package/docs/api/interfaces/LeaderBoardUserT.md +8 -5
  73. package/docs/api/interfaces/LeaderBoardsRewardsT.md +7 -0
  74. package/docs/api/interfaces/PointsLog.md +43 -0
  75. package/docs/api/interfaces/RaffleWonPrize.md +59 -0
  76. package/docs/api/interfaces/RaffleWonPrizePublicMeta.md +27 -0
  77. package/docs/api/interfaces/RaffleWonPrizeUser.md +43 -0
  78. package/docs/api/interfaces/TAchCategory.md +2 -7
  79. package/docs/api/interfaces/TAvatarCustomized.md +4 -4
  80. package/docs/api/interfaces/TAvatarDefinition.md +13 -14
  81. package/docs/api/interfaces/TAvatarPrompt.md +6 -6
  82. package/docs/api/interfaces/TBonus.md +16 -8
  83. package/docs/api/interfaces/TBuyStoreItemResult.md +4 -29
  84. package/docs/api/interfaces/TClaimBonusResult.md +5 -5
  85. package/docs/api/interfaces/TClan.md +8 -4
  86. package/docs/api/interfaces/TClanInfo.md +47 -0
  87. package/docs/api/interfaces/TClanJoinResult.md +11 -1
  88. package/docs/api/interfaces/TClanTournamentPlayer.md +55 -0
  89. package/docs/api/interfaces/TClanTournamentPlayersResult.md +27 -0
  90. package/docs/api/interfaces/TClans.md +3 -1
  91. package/docs/api/interfaces/TGetTranslations.md +4 -0
  92. package/docs/api/interfaces/TInboxMessage.md +14 -6
  93. package/docs/api/interfaces/TInboxMessageBody.md +18 -12
  94. package/docs/api/interfaces/TLevel.md +17 -20
  95. package/docs/api/interfaces/TLevelCurrent.md +19 -18
  96. package/docs/api/interfaces/TMiniGamePlayBatchResult.md +14 -6
  97. package/docs/api/interfaces/TMiniGamePlayResult.md +9 -4
  98. package/docs/api/interfaces/TMissionClaimRewardResult.md +1 -9
  99. package/docs/api/interfaces/TMissionOptInResult.md +1 -5
  100. package/docs/api/interfaces/TMissionOrBadge.md +4 -7
  101. package/docs/api/interfaces/TRaffleOptinResponse.md +4 -2
  102. package/docs/api/interfaces/TSegmentCheckResult.md +10 -0
  103. package/docs/api/interfaces/TSetAvatarResult.md +3 -3
  104. package/docs/api/interfaces/TStoreItem.md +3 -13
  105. package/docs/api/interfaces/TTournament.md +1 -1
  106. package/docs/api/interfaces/TTournamentDetailed.md +1 -1
  107. package/docs/api/interfaces/TTournamentRegistrationResult.md +4 -2
  108. package/docs/api/interfaces/TUICustomSection.md +23 -19
  109. package/docs/api/interfaces/TUserProfile.md +18 -16
  110. package/docs/api/interfaces/TransformedRaffleClaimPrizeResponse.md +6 -2
  111. package/docs/api/interfaces/UserLevelExtraCountersT.md +9 -2
  112. package/docs/api/type-aliases/ActivityLogEntry.md +3 -0
  113. package/docs/native/ADDING_METHODS.md +7 -2
  114. package/docs/native/PROTOCOL.md +337 -0
  115. package/docs/ui/avatars/UIGuide_getAvatarPrompts.md +100 -0
  116. package/docs/ui/avatars/UIGuide_getAvatarsCustomized.md +90 -0
  117. package/docs/ui/avatars/UIGuide_getAvatarsList.md +105 -0
  118. package/docs/ui/avatars/UIGuide_setAvatar.md +118 -0
  119. package/docs/ui/bonuses/UIGuide_claimBonus.md +144 -0
  120. package/docs/ui/bonuses/UIGuide_getBonuses.md +176 -0
  121. package/docs/ui/gamepick/UIGuide_gamePickGetActiveRound.md +99 -0
  122. package/docs/ui/gamepick/UIGuide_gamePickGetActiveRounds.md +76 -0
  123. package/docs/ui/gamepick/UIGuide_gamePickGetBoard.md +81 -0
  124. package/docs/ui/gamepick/UIGuide_gamePickGetGameInfo.md +78 -0
  125. package/docs/ui/gamepick/UIGuide_gamePickGetHistory.md +55 -0
  126. package/docs/ui/gamepick/UIGuide_gamePickGetRoundInfoForUser.md +71 -0
  127. package/docs/ui/gamepick/UIGuide_gamePickGetUserInfo.md +64 -0
  128. package/docs/ui/gamepick/UIGuide_gamePickSubmitSelection.md +103 -0
  129. package/docs/ui/gamepick/UIGuide_gamePickSubmitSelectionQuiz.md +67 -0
  130. package/docs/ui/general/UIGuide_getCustomSections.md +137 -0
  131. package/docs/ui/general/UIGuide_getRelatedItemsForGame.md +140 -0
  132. package/docs/ui/inbox/UIGuide_deleteInboxMessage.md +135 -0
  133. package/docs/ui/inbox/UIGuide_getInboxMessageBody.md +133 -0
  134. package/docs/ui/inbox/UIGuide_getInboxMessages.md +186 -0
  135. package/docs/ui/inbox/UIGuide_markInboxMessageAsRead.md +122 -0
  136. package/docs/ui/inbox/UIGuide_markUnmarkInboxMessageAsFavorite.md +84 -0
  137. package/docs/ui/jackpots/UIGuide_getJackpotEligibleGames.md +73 -0
  138. package/docs/ui/jackpots/UIGuide_getJackpotWinners.md +83 -0
  139. package/docs/ui/jackpots/UIGuide_jackpotGet.md +138 -0
  140. package/docs/ui/jackpots/UIGuide_jackpotOptIn.md +85 -0
  141. package/docs/ui/jackpots/UIGuide_jackpotOptOut.md +65 -0
  142. package/docs/ui/leaderboard/UIGuide_getLeaderBoard.md +166 -0
  143. package/docs/ui/minigames/UIGuide_getMiniGames.md +153 -0
  144. package/docs/ui/minigames/UIGuide_getMiniGamesHistory.md +90 -0
  145. package/docs/ui/minigames/UIGuide_playMiniGame.md +150 -0
  146. package/docs/ui/minigames/UIGuide_playMiniGameBatch.md +128 -0
  147. package/docs/ui/raffles/UIGuide_claimRafflePrize.md +99 -0
  148. package/docs/ui/raffles/UIGuide_getRaffleDrawRun.md +117 -0
  149. package/docs/ui/raffles/UIGuide_getRaffleDrawRunsHistory.md +92 -0
  150. package/docs/ui/raffles/UIGuide_getRaffleWonPrizes.md +120 -0
  151. package/docs/ui/raffles/UIGuide_getRaffles.md +175 -0
  152. package/docs/ui/raffles/UIGuide_requestRaffleOptin.md +114 -0
  153. package/docs/ui/user/UIGuide_getActivityLog.md +130 -0
  154. package/docs/ui/user/UIGuide_getLevels.md +47 -42
  155. package/package.json +1 -1
  156. package/src/Base/ClassId.ts +2 -0
  157. package/src/Jackpots/JackpotDetails.ts +14 -15
  158. package/src/Jackpots/JackpotPot.ts +10 -6
  159. package/src/MiniGames/SAWGameType.ts +3 -0
  160. package/src/MiniGames/SAWTemplateUI.ts +10 -0
  161. package/src/Raffle/GetRaffleWonPrizesRequest.ts +12 -0
  162. package/src/Raffle/GetRaffleWonPrizesResponse.ts +56 -0
  163. package/src/Raffle/index.ts +3 -1
  164. package/src/SmarticoAPI.ts +14 -1
  165. package/src/SmarticoLib/index.ts +4 -0
  166. package/src/WSAPI/WSAPIAvatars.ts +267 -49
  167. package/src/WSAPI/WSAPIBonuses.ts +224 -10
  168. package/src/WSAPI/WSAPIGamePick.ts +538 -253
  169. package/src/WSAPI/WSAPIGeneral.ts +156 -14
  170. package/src/WSAPI/WSAPIInbox.ts +545 -56
  171. package/src/WSAPI/WSAPIJackpots.ts +297 -61
  172. package/src/WSAPI/WSAPILeaderBoard.ts +127 -13
  173. package/src/WSAPI/WSAPIMiniGames.ts +465 -49
  174. package/src/WSAPI/WSAPIRaffles.ts +592 -64
  175. package/src/WSAPI/WSAPITournaments.ts +3 -3
  176. package/src/WSAPI/WSAPITypes.ts +243 -132
  177. package/src/WSAPI/WSAPIUser.ts +193 -43
  178. package/tsconfig.json +9 -1
@@ -0,0 +1,67 @@
1
+ # Interface: ClanTournamentPlayerRaw
2
+
3
+ ## Properties
4
+
5
+ ### userId
6
+
7
+ > **userId**: `number`
8
+
9
+ ***
10
+
11
+ ### cleanExtUserId
12
+
13
+ > **cleanExtUserId**: `string`
14
+
15
+ ***
16
+
17
+ ### userAltName
18
+
19
+ > **userAltName**: `string`
20
+
21
+ ***
22
+
23
+ ### avatar\_id
24
+
25
+ > **avatar\_id**: `string`
26
+
27
+ ***
28
+
29
+ ### avatar\_real\_id
30
+
31
+ > **avatar\_real\_id**: `number`
32
+
33
+ ***
34
+
35
+ ### position
36
+
37
+ > **position**: `number`
38
+
39
+ ***
40
+
41
+ ### scores
42
+
43
+ > **scores**: `number`
44
+
45
+ ***
46
+
47
+ ### isMe
48
+
49
+ > **isMe**: `boolean`
50
+
51
+ ***
52
+
53
+ ### registration\_status?
54
+
55
+ > `optional` **registration\_status?**: `number`
56
+
57
+ ***
58
+
59
+ ### crmBrandId?
60
+
61
+ > `optional` **crmBrandId?**: `number`
62
+
63
+ ***
64
+
65
+ ### avatar\_url?
66
+
67
+ > `optional` **avatar\_url?**: `string`
@@ -0,0 +1,43 @@
1
+ # Interface: GemsDiamondsLog
2
+
3
+ ## Properties
4
+
5
+ ### create\_date
6
+
7
+ > **create\_date**: `number`
8
+
9
+ ***
10
+
11
+ ### user\_ext\_id
12
+
13
+ > **user\_ext\_id**: `string`
14
+
15
+ ***
16
+
17
+ ### crm\_brand\_id
18
+
19
+ > **crm\_brand\_id**: `number`
20
+
21
+ ***
22
+
23
+ ### type
24
+
25
+ > **type**: [`UserBalanceType`](../enumerations/UserBalanceType.md)
26
+
27
+ ***
28
+
29
+ ### amount
30
+
31
+ > **amount**: `number`
32
+
33
+ ***
34
+
35
+ ### balance
36
+
37
+ > **balance**: `number`
38
+
39
+ ***
40
+
41
+ ### source\_type\_id
42
+
43
+ > **source\_type\_id**: [`PointChangeSourceType`](../enumerations/PointChangeSourceType.md)
@@ -0,0 +1,61 @@
1
+ # Interface: GetClanInfoResponse
2
+
3
+ ## Extends
4
+
5
+ - `ProtocolResponse`
6
+
7
+ ## Properties
8
+
9
+ ### cid
10
+
11
+ > **cid**: `number`
12
+
13
+ #### Inherited from
14
+
15
+ `ProtocolResponse.cid`
16
+
17
+ ***
18
+
19
+ ### ts?
20
+
21
+ > `optional` **ts?**: `number`
22
+
23
+ #### Inherited from
24
+
25
+ `ProtocolResponse.ts`
26
+
27
+ ***
28
+
29
+ ### uuid?
30
+
31
+ > `optional` **uuid?**: `string`
32
+
33
+ #### Inherited from
34
+
35
+ `ProtocolResponse.uuid`
36
+
37
+ ***
38
+
39
+ ### errCode?
40
+
41
+ > `optional` **errCode?**: `number`
42
+
43
+ #### Inherited from
44
+
45
+ `ProtocolResponse.errCode`
46
+
47
+ ***
48
+
49
+ ### errMsg?
50
+
51
+ > `optional` **errMsg?**: `string`
52
+
53
+ #### Inherited from
54
+
55
+ `ProtocolResponse.errMsg`
56
+
57
+ ***
58
+
59
+ ### clanInfo
60
+
61
+ > **clanInfo**: [`ClanInfo`](ClanInfo.md)
@@ -0,0 +1,81 @@
1
+ # Interface: GetClanTournamentPlayersResponse
2
+
3
+ ## Extends
4
+
5
+ - `ProtocolResponse`
6
+
7
+ ## Properties
8
+
9
+ ### cid
10
+
11
+ > **cid**: `number`
12
+
13
+ #### Inherited from
14
+
15
+ `ProtocolResponse.cid`
16
+
17
+ ***
18
+
19
+ ### ts?
20
+
21
+ > `optional` **ts?**: `number`
22
+
23
+ #### Inherited from
24
+
25
+ `ProtocolResponse.ts`
26
+
27
+ ***
28
+
29
+ ### uuid?
30
+
31
+ > `optional` **uuid?**: `string`
32
+
33
+ #### Inherited from
34
+
35
+ `ProtocolResponse.uuid`
36
+
37
+ ***
38
+
39
+ ### errCode?
40
+
41
+ > `optional` **errCode?**: `number`
42
+
43
+ #### Inherited from
44
+
45
+ `ProtocolResponse.errCode`
46
+
47
+ ***
48
+
49
+ ### errMsg?
50
+
51
+ > `optional` **errMsg?**: `string`
52
+
53
+ #### Inherited from
54
+
55
+ `ProtocolResponse.errMsg`
56
+
57
+ ***
58
+
59
+ ### clan\_id
60
+
61
+ > **clan\_id**: `number`
62
+
63
+ ***
64
+
65
+ ### clan\_public\_meta
66
+
67
+ > **clan\_public\_meta**: `object`
68
+
69
+ #### name
70
+
71
+ > **name**: `string`
72
+
73
+ #### image\_url
74
+
75
+ > **image\_url**: `string`
76
+
77
+ ***
78
+
79
+ ### players
80
+
81
+ > **players**: [`ClanTournamentPlayerRaw`](ClanTournamentPlayerRaw.md)[]
@@ -0,0 +1,59 @@
1
+ # Interface: GetRaffleWonPrizesRequest
2
+
3
+ ## Extends
4
+
5
+ - `ProtocolMessage`
6
+
7
+ ## Properties
8
+
9
+ ### cid
10
+
11
+ > **cid**: `number`
12
+
13
+ #### Inherited from
14
+
15
+ `ProtocolMessage.cid`
16
+
17
+ ***
18
+
19
+ ### ts?
20
+
21
+ > `optional` **ts?**: `number`
22
+
23
+ #### Inherited from
24
+
25
+ `ProtocolMessage.ts`
26
+
27
+ ***
28
+
29
+ ### uuid?
30
+
31
+ > `optional` **uuid?**: `string`
32
+
33
+ #### Inherited from
34
+
35
+ `ProtocolMessage.uuid`
36
+
37
+ ***
38
+
39
+ ### raffle\_id
40
+
41
+ > **raffle\_id**: `number`
42
+
43
+ ID of the raffle to fetch the current user's won prizes for.
44
+
45
+ ***
46
+
47
+ ### offset
48
+
49
+ > **offset**: `number`
50
+
51
+ Zero-based index of the first won-prize row to return (pagination).
52
+
53
+ ***
54
+
55
+ ### limit
56
+
57
+ > **limit**: `number`
58
+
59
+ Maximum number of won-prize rows to return (pagination).
@@ -0,0 +1,95 @@
1
+ # Interface: GetRaffleWonPrizesResponse
2
+
3
+ ## Extends
4
+
5
+ - `ProtocolResponse`
6
+
7
+ ## Properties
8
+
9
+ ### cid
10
+
11
+ > **cid**: `number`
12
+
13
+ #### Inherited from
14
+
15
+ `ProtocolResponse.cid`
16
+
17
+ ***
18
+
19
+ ### ts?
20
+
21
+ > `optional` **ts?**: `number`
22
+
23
+ #### Inherited from
24
+
25
+ `ProtocolResponse.ts`
26
+
27
+ ***
28
+
29
+ ### uuid?
30
+
31
+ > `optional` **uuid?**: `string`
32
+
33
+ #### Inherited from
34
+
35
+ `ProtocolResponse.uuid`
36
+
37
+ ***
38
+
39
+ ### errCode?
40
+
41
+ > `optional` **errCode?**: `number`
42
+
43
+ #### Inherited from
44
+
45
+ `ProtocolResponse.errCode`
46
+
47
+ ***
48
+
49
+ ### errMsg?
50
+
51
+ > `optional` **errMsg?**: `string`
52
+
53
+ #### Inherited from
54
+
55
+ `ProtocolResponse.errMsg`
56
+
57
+ ***
58
+
59
+ ### user
60
+
61
+ > **user**: [`RaffleWonPrizeUser`](RaffleWonPrizeUser.md)
62
+
63
+ The user the won prizes belong to; `null` when `won_prizes` is empty.
64
+
65
+ ***
66
+
67
+ ### won\_prizes
68
+
69
+ > **won\_prizes**: [`RaffleWonPrize`](RaffleWonPrize.md)[]
70
+
71
+ Page of won prizes for the requested raffle, newest-first.
72
+
73
+ ***
74
+
75
+ ### total
76
+
77
+ > **total**: `number`
78
+
79
+ Total number of won prizes for this user/raffle across all draws (for pagination).
80
+
81
+ ***
82
+
83
+ ### offset
84
+
85
+ > **offset**: `number`
86
+
87
+ Zero-based offset of this page (echoes the resolved request).
88
+
89
+ ***
90
+
91
+ ### limit
92
+
93
+ > **limit**: `number`
94
+
95
+ Page size (echoes the resolved request).
@@ -1,12 +1,19 @@
1
1
  # Interface: InboxMarkMessageAction
2
2
 
3
+ InboxMarkMessageAction is the response of the five inbox mutation
4
+ methods (`markInboxMessageAsRead`, `markAllInboxMessagesAsRead`,
5
+ `markUnmarkInboxMessageAsFavorite`, `deleteInboxMessage`,
6
+ `deleteAllInboxMessages`).
7
+
3
8
  ## Properties
4
9
 
5
10
  ### err\_code
6
11
 
7
12
  > **err\_code**: `number`
8
13
 
9
- An error code representing the result of marking a message as deleted, favorite or read. Successful marking action if err_code is 0
14
+ Error code. `0` = success. See the calling method's TSDoc for
15
+ the full error semantics (server returns generic codes; the
16
+ five inbox mutations share the same shape).
10
17
 
11
18
  ***
12
19
 
@@ -14,4 +21,5 @@ An error code representing the result of marking a message as deleted, favorite
14
21
 
15
22
  > **err\_message**: `string`
16
23
 
17
- Optional error message
24
+ Optional server-side error message. Present only on non-zero
25
+ `err_code`; may be empty even then.
@@ -1,8 +1,7 @@
1
1
  # Interface: JackpotDetails
2
2
 
3
- JackpotDetails the information about Jackpot template
4
- It also includes JackpotPot object that holds the current value of the jackpot
5
- Flag is_opted_in indicates if the current user is opted in to the jackpot
3
+ One jackpot template the user is eligible for, with its live pot snapshot.
4
+ Returned by `jackpotGet()`.
6
5
 
7
6
  ## Properties
8
7
 
@@ -10,7 +9,7 @@ Flag is_opted_in indicates if the current user is opted in to the jackpot
10
9
 
11
10
  > **jp\_template\_id**: `number`
12
11
 
13
- ID of the jackpot template
12
+ Stable numeric ID of the template; pass to opt-in / opt-out / winners / eligible-games methods.
14
13
 
15
14
  ***
16
15
 
@@ -18,7 +17,7 @@ ID of the jackpot template
18
17
 
19
18
  > **jp\_type\_id**: [`JackpotType`](../enumerations/JackpotType.md)
20
19
 
21
- Type of jackpot logic
20
+ Whether the jackpot has a shared pot or one independent per user; see [JackpotType](../enumerations/JackpotType.md).
22
21
 
23
22
  ***
24
23
 
@@ -26,7 +25,7 @@ Type of jackpot logic
26
25
 
27
26
  > **jp\_public\_meta**: [`JackpotPublicMeta`](JackpotPublicMeta.md)
28
27
 
29
- UI information of jackpot, like name, description, etc.
28
+ Display data: name, description, image_url, winner / not-winner HTML templates, custom_data (JSON-parsed).
30
29
 
31
30
  ***
32
31
 
@@ -34,7 +33,7 @@ UI information of jackpot, like name, description, etc.
34
33
 
35
34
  > **jp\_currency**: `string`
36
35
 
37
- Base currency of the jackpot
36
+ Native jackpot currency (ISO 4217). Used for winner-history amounts.
38
37
 
39
38
  ***
40
39
 
@@ -42,7 +41,7 @@ Base currency of the jackpot
42
41
 
43
42
  > **user\_currency**: `string`
44
43
 
45
- Wallet currency of currently logged in user
44
+ Current user's wallet currency. Used to display the pot via `pot.current_pot_amount_user_currency`.
46
45
 
47
46
  ***
48
47
 
@@ -50,7 +49,7 @@ Wallet currency of currently logged in user
50
49
 
51
50
  > **contribution\_type**: [`JackpotContributionType`](../enumerations/JackpotContributionType.md)
52
51
 
53
- Type of the user contribution to the jackpot
52
+ Whether the contribution is a fixed amount or a percentage of the bet; see [JackpotContributionType](../enumerations/JackpotContributionType.md).
54
53
 
55
54
  ***
56
55
 
@@ -58,7 +57,7 @@ Type of the user contribution to the jackpot
58
57
 
59
58
  > **contribution\_value**: `number`
60
59
 
61
- Value of the user contribution. Fixed amount or percentage of bet depending on the contribution type
60
+ Amount of contribution per qualifying bet — fixed value or percentage depending on `contribution_type`.
62
61
 
63
62
  ***
64
63
 
@@ -66,7 +65,7 @@ Value of the user contribution. Fixed amount or percentage of bet depending on t
66
65
 
67
66
  > **pot**: [`JackpotPot`](JackpotPot.md)
68
67
 
69
- Information of current value of the jackpot
68
+ Live pot snapshot (amount, temperature, last explosion timestamp).
70
69
 
71
70
  ***
72
71
 
@@ -74,7 +73,7 @@ Information of current value of the jackpot
74
73
 
75
74
  > **is\_opted\_in**: `boolean`
76
75
 
77
- Indication if the current user is opted in to the jackpot
76
+ `true` when the current user is currently opted in.
78
77
 
79
78
  ***
80
79
 
@@ -82,7 +81,7 @@ Indication if the current user is opted in to the jackpot
82
81
 
83
82
  > **ach\_related\_game\_allow\_all**: `boolean`
84
83
 
85
- Indicates whether all games are eligible for the jackpot
84
+ `true` when every game in the operator catalog contributes; if `true`, skip `getJackpotEligibleGames`.
86
85
 
87
86
  ***
88
87
 
@@ -90,7 +89,7 @@ Indicates whether all games are eligible for the jackpot
90
89
 
91
90
  > **registration\_count**: `number`
92
91
 
93
- The number of users who have opted in to participate in the jackpot
92
+ Number of users currently opted in; always `1` for `JackpotType.Personal`.
94
93
 
95
94
  ***
96
95
 
@@ -98,4 +97,4 @@ The number of users who have opted in to participate in the jackpot
98
97
 
99
98
  > **expose\_winners\_over\_api**: `boolean`
100
99
 
101
- Show winners in widget and over API
100
+ Operator flag: whether the winners list should be displayed. Enforced client-side only — gate `getJackpotWinners` calls on this.
@@ -1,12 +1,15 @@
1
1
  # Interface: JackpotPot
2
2
 
3
+ Live snapshot of one jackpot pot's value and temperature.
4
+ Embedded on `JackpotDetails.pot`; refreshed at the 1 s SDK cache TTL.
5
+
3
6
  ## Properties
4
7
 
5
8
  ### jp\_template\_id
6
9
 
7
10
  > **jp\_template\_id**: `number`
8
11
 
9
- ID of the jackpot template
12
+ Template ID this pot belongs to.
10
13
 
11
14
  ***
12
15
 
@@ -14,7 +17,7 @@ ID of the jackpot template
14
17
 
15
18
  > **jp\_pot\_id**: `number`
16
19
 
17
- ID of the jackpot pot
20
+ Stable numeric ID of the current pot instance (rotates when the pot explodes).
18
21
 
19
22
  ***
20
23
 
@@ -22,7 +25,7 @@ ID of the jackpot pot
22
25
 
23
26
  > **current\_pot\_amount**: `number`
24
27
 
25
- currency of the jackpot pot in the Jackput base currency
28
+ Current pot amount in the jackpot's native currency (`jp_currency`).
26
29
 
27
30
  ***
28
31
 
@@ -30,7 +33,7 @@ currency of the jackpot pot in the Jackput base currency
30
33
 
31
34
  > **current\_pot\_amount\_user\_currency**: `number`
32
35
 
33
- currency of the jackpot pot in the user wallet currency
36
+ Current pot amount converted to the user's wallet currency (`user_currency`).
34
37
 
35
38
  ***
36
39
 
@@ -38,7 +41,7 @@ currency of the jackpot pot in the user wallet currency
38
41
 
39
42
  > **explode\_date\_ts**: `number`
40
43
 
41
- the date/time when this pot exploded
44
+ Unix ms timestamp of when this pot last exploded; `0` if it has never exploded.
42
45
 
43
46
  ***
44
47
 
@@ -46,4 +49,4 @@ the date/time when this pot exploded
46
49
 
47
50
  > **current\_pot\_temperature**: [`JackPotTemparature`](../enumerations/JackPotTemparature.md)
48
51
 
49
- current pot temperature
52
+ Heat band of the pot relative to its explosion range; see [JackPotTemparature](../enumerations/JackPotTemparature.md).
@@ -1,12 +1,16 @@
1
1
  # Interface: LeaderBoardDetailsT
2
2
 
3
+ LeaderBoardDetailsT describes one period's leaderboard.
4
+ Returned by `_smartico.api.getLeaderBoard(periodType, getPreviousPeriod?)`.
5
+ May be `undefined` at runtime when no board is configured for the requested period.
6
+
3
7
  ## Properties
4
8
 
5
9
  ### board\_id
6
10
 
7
11
  > **board\_id**: `number`
8
12
 
9
- ID of the leaderboard
13
+ Stable ID of the leaderboard.
10
14
 
11
15
  ***
12
16
 
@@ -14,7 +18,7 @@ ID of the leaderboard
14
18
 
15
19
  > **name**: `string`
16
20
 
17
- Name of the leaderboard
21
+ Operator-defined display name.
18
22
 
19
23
  ***
20
24
 
@@ -22,7 +26,7 @@ Name of the leaderboard
22
26
 
23
27
  > **description**: `string`
24
28
 
25
- Description of the leaderboard
29
+ Operator-defined description (HTML allowed).
26
30
 
27
31
  ***
28
32
 
@@ -30,7 +34,7 @@ Description of the leaderboard
30
34
 
31
35
  > **rules**: `string`
32
36
 
33
- Rules of the leaderboard
37
+ Operator-defined rules / terms (HTML allowed).
34
38
 
35
39
  ***
36
40
 
@@ -38,7 +42,7 @@ Rules of the leaderboard
38
42
 
39
43
  > **period\_type\_id**: [`LeaderBoardPeriodType`](../enumerations/LeaderBoardPeriodType.md)
40
44
 
41
- Leaderboard period type ID
45
+ Period type this board is bound to ([LeaderBoardPeriodType](../enumerations/LeaderBoardPeriodType.md)).
42
46
 
43
47
  ***
44
48
 
@@ -46,7 +50,7 @@ Leaderboard period type ID
46
50
 
47
51
  > **rewards**: [`LeaderBoardsRewardsT`](LeaderBoardsRewardsT.md)[]
48
52
 
49
- Leaderboard points rewards
53
+ Per-place prize table; the array length is the number of paid places.
50
54
 
51
55
  ***
52
56
 
@@ -54,7 +58,7 @@ Leaderboard points rewards
54
58
 
55
59
  > **users**: [`LeaderBoardUserT`](LeaderBoardUserT.md)[]
56
60
 
57
- Leaderboard users
61
+ Top-20 ranked entries (server-capped), sorted by `position` ASC.
58
62
 
59
63
  ***
60
64
 
@@ -62,4 +66,6 @@ Leaderboard users
62
66
 
63
67
  > `optional` **me?**: [`LeaderBoardUserT`](LeaderBoardUserT.md)
64
68
 
65
- Info about current user in leaderboard
69
+ Current user's own entry. `undefined` for visitor sessions.
70
+ For authenticated users, `position === -1` means the user is
71
+ unranked / outside the ranked window.