@smartico/public-api 0.0.420 → 0.0.422

package/docs/capabilities/getTournamentInstanceInfo.md

@@ -2,7 +2,7 @@
 
 > Returns the full detail of a single tournament instance — adds the player leaderboard, the full prize structure, and (for clan tournaments) the clan leaderboard and per-clan prize structure on top of everything already in `TTournament`.
 > Import: `import { TTournamentDetailed } from '@smartico/public-api'`
-> Search terms: getTournamentInstanceInfo, tournaments, getTournament, TTournamentDetailed, TRibbon, TANGIBLE, POINTS_ADD, POINTS_DEDUCT, POINTS_RESET, MINI_GAME_ATTEMPT, BONUS, TournamentRegistrationTypeName, TournamentRegistrationStatusName, AchRelatedGame, Fixed, Dynamic, instance_id, tournament_id, name, description, image1, image2, image2_mobile, prize_pool_short
+> Search terms: getTournamentInstanceInfo, tournaments, getTournament, TTournamentDetailed, TRibbon, TANGIBLE, POINTS_ADD, POINTS_DEDUCT, POINTS_RESET, MINI_GAME_ATTEMPT, BONUS, TournamentRegistrationTypeName, TournamentRegistrationStatusName, AchRelatedGame, Fixed, Dynamic, instance_id, tournament_id, name, description, image1, image2, custom_data, is_featured
 
 ## Signature
 ```ts
@@ -237,58 +237,66 @@ if (detail.me) {
 > Where this real payload differs from the typed Returns above (TS interface vs raw wire), the REAL shape is the runtime truth.
 ```json
 {
-  "instance_id": 585461,
-  "tournament_id": 4450,
-  "name": "Old Dragon's Hoard",
-  "description": "   <style>\n        /* Add your CSS here */\n        .custom-rules {\n            font-family: inherit;\n            background-color: #2c295c !important;\n      …",
-  "image1": "https://cdn.example/00000000-0000-0000-0000-000000000000/entity-image-1773753066010-1.png",
-  "image2": "https://cdn.example/00000000-0000-0000-0000-000000000000/entity-image-1773755039087-0.png",
-  "image2_mobile": "https://cdn.example/00000000-0000-0000-0000-000000000000/entity-image-1773755761006-0.png",
-  "prize_pool_short": "The Dragon's treasure",
+  "instance_id": 589587,
+  "tournament_id": 5285,
+  "name": "Lucky Charm Tournament",
+  "description": "    <style>\n        /* Add your CSS here */\n        .custom-rules {\n            font-family: inherit;\n            background-color: #1b193e !important;\n     …",
+  "image1": "https://cdn.example/00000000-0000-0000-0000-000000000000/entity-image-1780497274026-2.png",
+  "image2": "https://cdn.example/00000000-0000-0000-0000-000000000000/entity-image-1780498012321-2.png",
   "custom_data": {},
   "is_featured": false,
-  "start_time": 1782216000000,
-  "end_time": 1782302400000,
+  "start_time": 1786004100000,
+  "end_time": 1786090500000,
   "registration_count": 0,
   "is_user_registered": false,
   "players_min_count": 0,
-  "players_max_count": 200,
+  "players_max_count": 5000,
   "registration_status": "UNKNOWN",
-  "registration_type": "BUY_IN_GEMS",
-  "registration_cost_gems": 3,
+  "registration_type": "AUTO",
   "duration_ms": 86400000,
   "is_active": true,
   "is_can_register": false,
   "is_cancelled": false,
   "is_finished": false,
-  "is_in_progress": true,
-  "is_upcoming": false,
+  "is_in_progress": false,
+  "is_upcoming": true,
   "min_scores_win": 1,
   "hide_leaderboard_min_scores": false,
   "total_scores": null,
-  "is_clan_based": false,
-  "related_games": [
-    {
-      "ext_game_id": "dragon-fortune",
-      "game_public_meta": {
-        "name": "Dragon Fortune",
-        "link": "/game/dragon-fortune",
-        "image": "https://cdn.example/e93b87dfd94d462de49bc3-china.png",
-        "enabled": true,
-        "priority": 1
-      }
-    }
-  ],
+  "is_clan_based": true,
+  "related_games": [],
   "players": [],
-  "prizes": [
+  "prizes": [],
+  "user_clan_id": 5,
+  "clan_leaderboard": [],
+  "clan_prize_structure": [
     {
-      "gems": 10,
-      "image_url": "https://cdn.example/ecec44e4c2d0555b4d8a32-Gems10.webp",
-      "name": "10 gems",
-      "id": 38778,
-      "type": "GEMS_AND_DIAMONDS_ADD",
-      "place_from": 1,
-      "place_to": 1
+      "clan_place": 1,
+      "prize_type_id": 2,
+      "prize_pool_amount": 200,
+      "prize_pool_currency_code": null,
+      "activity_type_id": 25,
+      "details_json": {
+        "gems_diamonds_type": 0
+      },
+      "public_meta": {
+        "prize_name": ""
+      },
+      "tiers": [
+        {
+          "player_place_from": 1,
+          "player_place_to": 3,
+          "pool_amount": 100,
+          "distribution_type": 1,
+          "activity_type_id": 25,
+          "details_json": {
+            "gems_diamonds_type": 0
+          },
+          "public_meta": {
+            "name": "100 Gems"
+          }
+        }
+      ]
     }
   ]
 }

package/docs/capabilities/getTournamentsList.md

@@ -191,7 +191,7 @@ if (featured) {
 ```json
 [
   {
-    "instance_id": 585461,
+    "instance_id": 589489,
     "tournament_id": 4450,
     "name": "Old Dragon's Hoard",
     "description": "   <style>\n        /* Add your CSS here */\n        .custom-rules {\n            font-family: inherit;\n            background-color: #2c295c !important;\n      …",
@@ -201,8 +201,8 @@ if (featured) {
     "prize_pool_short": "The Dragon's treasure",
     "custom_data": {},
     "is_featured": false,
-    "start_time": 1782216000000,
-    "end_time": 1782302400000,
+    "start_time": 1785844800000,
+    "end_time": 1785931200000,
     "registration_count": 0,
     "is_user_registered": false,
     "players_min_count": 0,
@@ -211,11 +211,11 @@ if (featured) {
     "registration_type": "BUY_IN_GEMS",
     "registration_cost_gems": 3,
     "duration_ms": 86400000,
-    "is_active": true,
+    "is_active": false,
     "is_can_register": false,
     "is_cancelled": false,
-    "is_finished": false,
-    "is_in_progress": true,
+    "is_finished": true,
+    "is_in_progress": false,
     "is_upcoming": false,
     "min_scores_win": 1,
     "hide_leaderboard_min_scores": false,

package/docs/capabilities/getTranslations.md

@@ -83,7 +83,7 @@ console.log('[smartico] localized label "missions_title" →', t('missions_title
     "totalPool": "total pool",
     "placesPaid": "Places paid",
     "sawSpinCostSpins": "{value} spins available",
-    "…": "(+804 more keys)"
+    "…": "(+842 more keys)"
   }
 }
 ```

package/docs/capabilities/getUserProfile.md

@@ -144,24 +144,24 @@ if (balance < price) {
   "core_public_tags": [
     "SMARTICO.DEV"
   ],
-  "ach_points_ever": 690,
+  "ach_points_ever": 12700,
   "core_clan_is_kicked": null,
   "user_last_session_push_state": "BLOCKED",
   "aff_referred_by_friend_ext_user_id": null,
-  "core_inbox_unread_count": 0,
+  "core_inbox_unread_count": 8,
   "core_user_language": "EN",
-  "ach_level_current": "Silver",
-  "ach_gems_balance": 10,
-  "ach_level_current_id": 698,
+  "ach_level_current": "Ruby",
+  "ach_gems_balance": 57,
+  "ach_level_current_id": 701,
   "user_country": "BG",
-  "ach_points_balance": 326,
+  "ach_points_balance": 12286,
   "core_registration_date": 0,
   "core_recommended_deposit_amount": 0,
   "core_recommended_casino_bet_amount": 0,
   "ach_gamification_in_control_group": false,
   "core_avatar_real_id": null,
   "core_wallet_currency": "UNKNOWN",
-  "ach_diamonds_balance": 1,
+  "ach_diamonds_balance": 40,
   "aff_refer_friend_url": null,
   "acc_bonus_abuser": false,
   "aff_refered_friends_count": 0,
@@ -169,10 +169,10 @@ if (balance < price) {
   "core_clan_id": "",
   "core_is_test_account": false,
   "user_id": 361368543,
-  "avatar_id": "https://cdn.example/avatars/12/00000000-0000-0000-0000-000000000000.png",
-  "avatar_real_id": 12,
+  "avatar_id": "https://cdn.example/avatars/11/00000000-0000-0000-0000-000000000000.png",
+  "avatar_real_id": 11,
   "public_username": "Antonio",
-  "avatar_url": "https://cdn.example/avatars/12/00000000-0000-0000-0000-000000000000.png"
+  "avatar_url": "https://cdn.example/avatars/11/00000000-0000-0000-0000-000000000000.png"
 }
 ```
 

package/docs/capabilities/jackpotGet.md

@@ -2,7 +2,7 @@
 
 > Returns the user-eligible jackpots active for the label, fused with their live pot values.
 > Import: `import { JackpotDetails } from '@smartico/public-api'`
-> Search terms: jackpotGet, jackpots, JackpotDetails, JackpotType, JackpotPublicMeta, JackpotHtmlTemplate, JackpotContributionType, JackpotPot, JackPotTemparature, jp_template_id, jp_type_id, jp_public_meta, jp_currency, user_currency, related_games, contribution_type, contribution_value
+> Search terms: jackpotGet, jackpots, JackpotDetails, JackpotType, JackpotPublicMeta, JackpotHtmlTemplate, JackpotContributionType, JackpotContributionRule, AchRelatedGame, JackpotPot, JackPotTemparature, jp_template_id, jp_type_id, jp_public_meta, jp_currency, user_currency, related_games, contribution_type, contribution_value
 
 ## Signature
 ```ts
@@ -30,19 +30,48 @@ Array of `JackpotDetails`. Each item:
     - `content` (string)
   - `placeholder1` (string) — custom value of placeholder1 defined by operator and can be used in the HTML templates
   - `placeholder2` (string) — custom value of placeholder2 defined by operator and can be used in the HTML templates
-  - `custom_data` (string) — 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/tools-and-guides/custom-fields-attributes>
+  - `priority` (string) — operator-defined display order, ascending; sent as a string
+  - `custom_data` (any) — Custom data that can be used in API to build custom UI. `jackpotGet()` returns this already parsed — an object when the operator stored JSON, otherwise the raw string. Elsewhere (e.g. the jackpot-win push) it arrives unparsed. 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/tools-and-guides/custom-fields-attributes>
 - `jp_currency` (string) — Native jackpot currency (ISO 4217). Used for winner-history amounts.
 - `user_currency` (string) — Current user's wallet currency. Used to display the pot via `pot.current_pot_amount_user_currency`.
 - `contribution_type` (JackpotContributionType) — Whether the contribution is a fixed amount or a percentage of the bet; see `JackpotContributionType`.
 - `contribution_value` (number) — Amount of contribution per qualifying bet — fixed value or percentage depending on `contribution_type`.
+- `contribution_rules` (JackpotContributionRule[]) — Per-game / per-provider overrides of `contribution_type` + `contribution_value`; see `JackpotContributionRule`. Empty when the template contributes at a flat rate.
+  - `ruleId` (number) — Stable ID of the rule within its template
+  - `jpTemplateId` (number) — Template this rule belongs to
+  - `type` (JackpotContributionType) — Whether `contributionValue` is a fixed amount or a percentage; see `JackpotContributionType`
+  - `extEntityIds` (string[]) — Operator-side game or provider IDs this rule applies to
+  - `contributionValue` (number) — Contribution to apply for matching bets — fixed amount or percentage depending on `type`
+- `related_games` (AchRelatedGame[]) — Reserved — the server currently always sends an empty array. Use `getJackpotEligibleGames()` for the eligible-games list.
+  - `ext_game_id` (string) — The ID of the related game
+  - `game_public_meta` ({
+		/** The name of the game */
+		name: string;
+		/** The URL to the game */
+		link: string;
+		/** The URL to the image of the game, 1:1 aspect ratio */
+		image: string;
+		/** The indicator if the game is enabled */
+		enabled: boolean;
+		/** The list of categories of the game */
+		game_categories: string[];
+		/** The name of the game provider */
+		game_provider: string;
+		/** The URL to the mobile game */
+		mobile_spec_link: string;
+		/** The priority of the game */
+		priority?: number;
+	}) — Game public meta information
 - `pot` (JackpotPot) — Live pot snapshot (amount, temperature, last explosion timestamp).
   - `jp_template_id` (number) — Template ID this pot belongs to.
   - `jp_pot_id` (number) — Stable numeric ID of the current pot instance (rotates when the pot explodes).
   - `current_pot_amount` (number) — Current pot amount in the jackpot's native currency (`jp_currency`).
   - `current_pot_amount_user_currency` (number) — Current pot amount converted to the user's wallet currency (`user_currency`).
-  - `explode_date_ts` (number) — Unix ms timestamp of when this pot last exploded; `0` if it has never exploded.
+  - `explode_date_ts` (number | null) — Unix ms timestamp of when this pot last exploded; `null` while the pot is still running.
+  - `user_id` (number | null) — Owning user for `JackpotType.Personal` pots; `null` for shared `MultiUser` pots.
   - `current_pot_temperature` (JackPotTemparature) — Heat band of the pot relative to its explosion range; see `JackPotTemparature`.
 - `is_opted_in` (boolean) — `true` when the current user is currently opted in.
+- `is_auto_opt_in` (boolean) — `true` when eligible users are opted in automatically, so no opt-in CTA is needed; `false` means `jackpotOptIn()` must be called explicitly.
 - `ach_related_game_allow_all` (boolean) — `true` when every game in the operator catalog contributes; if `true`, skip `getJackpotEligibleGames`.
 - `registration_count` (number) — Number of users currently opted in; always `1` for `JackpotType.Personal`.
 - `expose_winners_over_api` (boolean) — Operator flag: whether the winners list should be displayed. Enforced client-side only — gate `getJackpotWinners` calls on this.
@@ -112,22 +141,21 @@ console.log('[smartico] linked jackpots for game:', linked.length);
 ```json
 [
   {
-    "jp_template_id": 6,
-    "jp_type_id": 1,
+    "jp_template_id": 8,
+    "jp_type_id": 2,
     "jp_public_meta": {
       "image_url": "https://cdn.example/f8b68a18473c437e32a860-Jackpot1.jpg",
-      "placeholder1": null,
-      "placeholder2": null,
-      "name": "Minor",
-      "description": "1% on top of your bet amount will be contributed to the Jackpot",
+      "placeholder1": "111111111111111111",
+      "placeholder2": "XXXXXXXXXXXXXXXXX",
+      "name": "Personal Jackpot For All Games",
+      "description": "For every bet, 2% is added to the jackpot pot—split 50/50 between the player’s contribution and the house. Plus, 20% of each jackpot goes toward seeding the …",
       "not_winner_template": {
-        "id": "0",
-        "content": ""
+        "content": "\n<style>\n    @keyframes reveal {\n        0% {\n            transform: translateX(100%);\n        }\n        100% {\n            transform: translateX(0%);\n      …",
+        "id": "1"
       },
-      "priority": "1",
       "winner_template": {
-        "id": "0",
-        "content": ""
+        "content": "\n<script>\n    document.addEventListener('DOMContentLoaded', () => {\n        const counter = document.getElementById('counter'); \n        const duration = 200…",
+        "id": "1"
       },
       "custom_data": {}
     },
@@ -135,32 +163,32 @@ console.log('[smartico] linked jackpots for game:', linked.length);
     "user_currency": "EUR",
     "related_games": [],
     "contribution_type": 2,
-    "contribution_value": 0.2,
+    "contribution_value": 2,
     "pot": {
-      "jp_template_id": 6,
-      "jp_pot_id": 306140,
+      "jp_template_id": 8,
+      "jp_pot_id": null,
       "user_id": null,
-      "current_pot_amount": 12.28367028,
-      "current_pot_amount_user_currency": 12.28367028,
+      "current_pot_amount": 0,
+      "current_pot_amount_user_currency": 0,
       "explode_date_ts": null,
-      "current_pot_temperature": 2
+      "current_pot_temperature": 0
     },
-    "is_opted_in": false,
-    "is_auto_opt_in": true,
+    "is_opted_in": true,
+    "is_auto_opt_in": false,
     "ach_related_game_allow_all": true,
-    "registration_count": 17262,
+    "registration_count": 1,
     "contribution_rules": [
       {
-        "ruleId": 1,
-        "jpTemplateId": 6,
+        "ruleId": 4,
+        "jpTemplateId": 8,
         "type": 2,
         "extEntityIds": [
-          "1111"
+          "123"
         ],
-        "contributionValue": 4
+        "contributionValue": 12
       }
     ],
-    "expose_winners_over_api": false
+    "expose_winners_over_api": true
   }
 ]
 ```

package/docs/capabilities/jackpotOptIn.md

@@ -27,6 +27,8 @@ _smartico.api.jackpotOptIn(filter: { jp_template_id: number }): Promise<Jackpots
 - The jackpot must currently be active and the user must be in its
  eligibility segment. Ineligible jackpots are filtered out of
  `jackpotGet` entirely, so a card the user sees is opt-in-able.
+- Skip the opt-in CTA when the template reports `is_auto_opt_in: true` —
+ eligible users are enrolled automatically and there is nothing to join.
 
 **Error handling**
 The server returns a non-zero `errCode` with a human-readable `errMsg`

package/docs/capabilities/smarticoCallbacks.md

@@ -91,7 +91,7 @@ strings below.
 | Event key | Fires when | Handler arguments |
 |---|---|---|
 | `mini_game_win` | A mini-game spin finishes and a prize is determined. Fires for both real and visitor-mode plays. | `({ prize_id, name, visitor_win_uuid })` — `name` is the prize display name. In visitor mode, `visitor_win_uuid` can be passed to `_smartico.convertVisitorGame(uuid)` to attach the win to a real account on registration. |
-| `jackpot_win` | A jackpot the user participates in is hit (the pot explodes and the user is among the recipients). | `(message)` — the win payload (winner details + jackpot info). See the Jackpots UI guide (`docs/ui/jackpots/`) for how the default Smartico UI surfaces wins. |
+| `jackpot_win` | A jackpot the user participates in is hit (the pot explodes). Fires both for the winner and for other players taking part in the same jackpot. | `(message)` — the win payload: `jackpot` (template + live `pot`, where `pot.explode_date_ts` is the explosion time) and `winners` (currently a single entry). `winners[0].is_me` tells you whether the recipient is the winner; `winning_game_id` / `winning_provider_id` / `bet_original_date` describe the bet that triggered the win and are `null` when unavailable. See the Jackpots UI guide (`docs/ui/jackpots/`) for how the default Smartico UI surfaces wins. |
 | `ach_game_opening` | The user taps a related / eligible casino game tile from inside the gamification widget (mission, tournament, jackpot, or store context). Use this to launch the game in your own casino lobby. | `(game)` — the game object (catalog id, name, launch links, plus a `context` field naming where it was opened from). If you do not handle this event, the default Smartico UI opens the game's configured link itself. |
 
 ### Errors

package/docs/native/PROTOCOL.md

@@ -558,39 +558,102 @@ Sent as a trigger to display a mini-game to the user (Spin-A-Wheel, Scratch Card
 
 ## JP_WIN_PUSH
 
-Sent when a jackpot is won (can be the current user or another player).
+Sent when a jackpot is won. Delivered both to the winner and to other players taking
+part in the same jackpot — `winners[].is_me` distinguishes the two, and the copy sent
+to other players has its `public_username` masked.
 
 **ClassId:** `808`
 
+**Fields:**
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `cid` | `number` | Message type identifier |
+| `jackpot` | [`JackpotDetails`](../api/interfaces/JackpotDetails.md) | The jackpot that exploded, including its live `pot` snapshot. `pot.explode_date_ts` is the explosion time (epoch ms). `jp_public_meta.custom_data` arrives here as a raw JSON string |
+| `winners` | [`JackPotWinPushWinner[]`](../api/interfaces/JackPotWinPushWinner.md) | Winner entries — currently always a single entry |
+
+**`winners[]` entry:**
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `user_id` | `number` | Smartico user ID of the winner |
+| `ext_user_id` | `string` | Operator's external user ID of the winner |
+| `is_me` | `boolean` | `true` when this copy was delivered to the winner themselves |
+| `public_username` | `string` | Winner display name; masked unless `is_me` (masking can be disabled per brand on request) |
+| `public_username_custom` | `string` | Custom display name; falls back to `public_username` when not set |
+| `winning_amount_jp_currency` | `number` | Won amount in the jackpot currency (real + bonus combined) |
+| `winning_amount_wallet_currency` | `number` | Won amount in the user's wallet currency (real + bonus combined) |
+| `winning_position` | `number` | Winner position; currently always `1` |
+| `winning_game_id` | `string \| null` | External game ID of the game whose bet triggered the win. `null` when the triggering bet context is unavailable |
+| `winning_provider_id` | `string \| null` | External provider ID of that game's provider. `null` when the triggering bet context is unavailable |
+| `bet_original_date` | `number \| null` | Placement time of the triggering bet as reported by the operator (epoch ms) — not the time Smartico processed it. `null` when unavailable |
+| `pending_approve` | `boolean` | Present only on the `is_me: true` copy; `true` while the win awaits manual approval before payout |
+
 **Example:**
 
 ```json
 {
   "cid": 808,
   "jackpot": {
-    "jp_id": 456,
-    "name": "Mega Jackpot",
-    "current_value": 10000
+    "jp_template_id": 1183,
+    "jp_type_id": 1,
+    "jp_public_meta": {
+      "name": "Major",
+      "description": "1% on top of your bet amount will be contributed to the Jackpot",
+      "image_url": "https://cdn.example/Jackpot2.jpg",
+      "winner_template": { "id": "0", "content": "" },
+      "not_winner_template": { "id": "0", "content": "" },
+      "placeholder1": null,
+      "placeholder2": null,
+      "priority": "2",
+      "custom_data": "{}"
+    },
+    "jp_currency": "EUR",
+    "user_currency": "USD",
+    "related_games": [],
+    "contribution_type": 2,
+    "contribution_value": 0.5,
+    "contribution_rules": [],
+    "pot": {
+      "jp_template_id": 1183,
+      "jp_pot_id": 306053,
+      "user_id": null,
+      "current_pot_amount": 0,
+      "current_pot_amount_user_currency": 0,
+      "explode_date_ts": 1782295329703,
+      "current_pot_temperature": 0
+    },
+    "is_opted_in": true,
+    "is_auto_opt_in": true,
+    "ach_related_game_allow_all": true,
+    "registration_count": 412,
+    "expose_winners_over_api": true
   },
   "winners": [
     {
-      "user_id": "user123",
-      "amount": 10000,
-      "won_at": 1704067200000
+      "user_id": 731,
+      "ext_user_id": "player-731",
+      "is_me": true,
+      "public_username": "LuckyPlayer",
+      "public_username_custom": "LuckyPlayer",
+      "winning_amount_jp_currency": 16.720332488,
+      "winning_amount_wallet_currency": 98.525768722,
+      "winning_position": 1,
+      "winning_game_id": "book-of-ra-deluxe",
+      "winning_provider_id": "novomatic",
+      "bet_original_date": 1782295327112,
+      "pending_approve": false
     }
   ]
 }
 ```
 
-**Fields:**
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `cid` | `number` | Message type identifier |
-| `jackpot` | [`JackpotDetails`](../api/interfaces/JackpotDetails.md) | Jackpot information |
-| `winners` | [`JackPotWinner[]`](../api/interfaces/JackPotWinner.md) | Array of winners |
-
-**Recommended action:** Show jackpot win notification/celebration. Re-fetch jackpot data to update UI.
+**Recommended action:** Show the jackpot win notification / celebration. Use
+`winners[0].is_me` to pick the winner vs. other-player presentation, and
+`jackpot.jp_public_meta.winner_template` / `not_winner_template` for the HTML.
+`winning_game_id` / `winning_provider_id` let you link back to the triggering game in
+your lobby — treat both, and `bet_original_date`, as optional. Re-fetch jackpot data
+afterwards to refresh the pot amount.
 
 ---
 
@@ -2158,6 +2221,64 @@ Get all available jackpots.
 |-------|------|-------------|
 | `items` | [`JackpotDetails[]`](../api/interfaces/JackpotDetails.md) | Array of jackpots |
 
+Note for native clients: `jp_public_meta.custom_data` arrives as a **JSON-encoded
+string** and must be parsed by the client. `related_games` is reserved and is always
+sent empty — use `getJackpotEligibleGames` for the eligible-games list.
+
+**Example:**
+
+```json
+{
+  "cid": 801,
+  "errCode": 0,
+  "items": [
+    {
+      "jp_template_id": 6,
+      "jp_type_id": 1,
+      "jp_public_meta": {
+        "name": "Minor",
+        "description": "1% on top of your bet amount will be contributed to the Jackpot",
+        "image_url": "https://cdn.example/Jackpot1.jpg",
+        "winner_template": { "id": "0", "content": "" },
+        "not_winner_template": { "id": "0", "content": "" },
+        "placeholder1": null,
+        "placeholder2": null,
+        "priority": "1",
+        "custom_data": "{}"
+      },
+      "jp_currency": "EUR",
+      "user_currency": "EUR",
+      "related_games": [],
+      "contribution_type": 2,
+      "contribution_value": 0.2,
+      "contribution_rules": [
+        { "ruleId": 1, "jpTemplateId": 6, "type": 2, "extEntityIds": ["1111"], "contributionValue": 4 },
+        { "ruleId": 2, "jpTemplateId": 6, "type": 1, "extEntityIds": ["666666"], "contributionValue": 3 }
+      ],
+      "pot": {
+        "jp_template_id": 6,
+        "jp_pot_id": 306140,
+        "user_id": null,
+        "current_pot_amount": 12.28367028,
+        "current_pot_amount_user_currency": 12.28367028,
+        "explode_date_ts": null,
+        "current_pot_temperature": 2
+      },
+      "is_opted_in": false,
+      "is_auto_opt_in": true,
+      "ach_related_game_allow_all": true,
+      "registration_count": 17262,
+      "expose_winners_over_api": false
+    }
+  ]
+}
+```
+
+`contribution_rules` override `contribution_type` / `contribution_value` for the
+operator-side game or provider IDs listed in `extEntityIds`; the server applies them,
+so clients only need them to explain rates in the UI. Note these entries are camelCase
+while the rest of the payload is snake_case.
+
 ---
 
 ### jackpotOptIn
@@ -2285,7 +2406,8 @@ Each `JackpotPot`:
 | `jp_pot_id` | `number` | Jackpot pot ID |
 | `current_pot_amount` | `number` | Current pot amount in base currency |
 | `current_pot_amount_user_currency` | `number` | Current pot amount in user's currency |
-| `explode_date_ts` | `number` | Timestamp when pot exploded (0 if not yet) |
+| `explode_date_ts` | `number \| null` | Timestamp (epoch ms) when the pot exploded; `null` while the pot is still running |
+| `user_id` | `number \| null` | Owning user for Personal pots; `null` for shared MultiUser pots |
 | `current_pot_temperature` | `number` | Temperature: 0=Cold, 1=Warm, 2=Hot, 3=Burning |
 
 **Example:**
@@ -2301,7 +2423,8 @@ Each `JackpotPot`:
       "jp_pot_id": 100,
       "current_pot_amount": 50000,
       "current_pot_amount_user_currency": 50000,
-      "explode_date_ts": 0,
+      "explode_date_ts": null,
+      "user_id": null,
       "current_pot_temperature": 2
     }
   ]

package/docs/ui/jackpots/UIGuide_jackpotGet.md

@@ -31,7 +31,7 @@ stagger-fade in at 100 ms per index.
 | Currency symbol | `user_currency` | Looked up by translation key |
 | Status pill | derived | "Opted in" if `is_opted_in`, otherwise nothing |
 | Registration count | `registration_count` | Shown on the home-card variant only |
-| CTA button | derived | "Join Jackpot" if `!is_opted_in`, otherwise "Details" |
+| CTA button | derived | "Join Jackpot" if `!is_opted_in`, otherwise "Details" — but skip the join CTA entirely when `is_auto_opt_in` is `true`; eligible users are enrolled automatically and have nothing to join |
 
 **Click target**: whole-card tap → open detail modal.
 

package/docs/ui/user/UIGuide_getActivityLog.md

@@ -1,8 +1,10 @@
 # UI Guide — `getActivityLog`
 
 ## Overview
-- Returns the user's unified balance-change history — every points / gems /
-  diamonds transaction in the requested window, newest-first.
+- Returns the user's activity history in the requested window, newest-first.
+  Wallet rows (points / gems / diamonds) are always available; richer activity
+  rows (missions, badges, levels, …) appear on the same method when the
+  server starts emitting them — optional fields on `TActivityLog`.
 - Power an "Activity" / "History" tab showing wins, claims, purchases,
   level-up rewards, and operator adjustments.
 - 30 s SDK cache + push refresh on every wallet change (with a caveat —

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@smartico/public-api",
-	"version": "0.0.420",
+	"version": "0.0.422",
 	"description": "Smartico public API",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -34,13 +34,14 @@
 		"typescript-map": "^0.1.0"
 	},
 	"devDependencies": {
+		"@types/node": "^22.9.0",
 		"@types/node-fetch": "^2.6.2",
 		"microbundle": "0.15.0",
 		"npm-run-all": "4.1.5",
+		"playwright": "^1.62.1",
 		"typedoc": "^0.28.17",
 		"typedoc-plugin-markdown": "^4.11.0",
 		"typedoc-plugin-merge-modules": "^7.0.0",
-		"typescript": "~5.1.0",
-		"@types/node": "^22.9.0"
+		"typescript": "~5.1.0"
 	}
 }

package/scripts/capture-responses-browser.mjs

@@ -196,7 +196,14 @@ const bound = (v) => {
 		await safe('getCurrentLevel', () => api.getCurrentLevel(), clip);
 		await safe('getLevels', () => api.getLevels());
 		await safe('getUserLevelExtraCounters', () => api.getUserLevelExtraCounters(), clip);
-		await safe('getActivityLog', () => api.getActivityLog({ startTimeSeconds: now - 2592000, endTimeSeconds: now, from: 0, to: 20 }));
+		// Comes back [] today, on env4 and env8 alike, and it is NOT the request: the outbound 545
+		// frame carries api_key, ext_user_id, startTimeSeconds, endTimeSeconds, limit and offset,
+		// yet the server answers errCode 0 with an empty logHistory for users that demonstrably
+		// have rows (verified on env8 label 2283 against a session bound to the right user_id).
+		// Server-side gap — re-capture once it is fixed. Wide window so a sparse account still
+		// yields a shape.
+		const activityWindow = { startTimeSeconds: now - 63072000, endTimeSeconds: now, from: 0, to: 20 };
+		await safe('getActivityLog', () => api.getActivityLog({ ...activityWindow }));
 
 		// ---- detail / param methods — every id harvested from the lists above (no hardcodes) ----
 		const ids = {};

package/src/ActivityLog/ActivityLogActivities.ts

@@ -1,4 +1,4 @@
-/** Activity-log entry type as returned on the v2 wire (`type_id`). */
+/** Activity-log entry type as returned on the wire (`type_id`). */
 export enum ActivityLogActivities {
 	Gems = 1,
 	Diamonds = 2,