@smartico/public-api 0.0.419 → 0.0.421

package/docs/capabilities/getBonuses.md

@@ -2,7 +2,7 @@
 
 > Returns the bonuses awarded to the current user — both pending (player-claim required) and already-redeemed.
 > Import: `import { TBonus } from '@smartico/public-api'`
-> Search terms: getBonuses, bonuses, TBonus, BonusStatus, BonusTemplateMetaMap, BonusMetaMap, onUpdate, subscription, bonus_id, is_redeemable, create_date, redeem_date, label_bonus_template_id, bonus_status_id, label_bonus_template_meta_map, bonus_meta_map
+> Search terms: getBonuses, bonuses, TBonus, BonusStatus, BonusTemplateMetaMap, BonusMetaMap, onUpdate, subscription
 
 ## Signature
 ```ts
@@ -132,22 +132,7 @@ setInterval(async () => {
 > Where this real payload differs from the typed Returns above (TS interface vs raw wire), the REAL shape is the runtime truth.
 ```json
 [
-  {
-    "bonus_id": 910171929,
-    "is_redeemable": false,
-    "create_date": "09/06/2026 23:05:03",
-    "redeem_date": "09/06/2026 23:05:03",
-    "label_bonus_template_id": 2152,
-    "bonus_status_id": 3,
-    "label_bonus_template_meta_map": {
-      "name": "",
-      "description": "100 Euro Free Chip",
-      "image_url": "https://cdn.example/4011a701f070093978f2df-Storeitemcopy12.png"
-    },
-    "bonus_meta_map": {
-      "uiAmount": "100 EUR Big Bonus "
-    }
-  }
+  null
 ]
 ```
 

package/docs/capabilities/getClanInfo.md

@@ -134,22 +134,22 @@ if (isMyClan) {
     "description": "Join the clan if you're a wild card and are completely out of control! Or if you just hate Bruce Wayne very much.\n\nPlay in the tournaments, grab that cash an…",
     "image_url": "https://cdn.example/00000000-0000-0000-0000-000000000000/entity-image-1780057181857-1.png"
   },
-  "member_count": 885,
+  "member_count": 899,
   "capacity_limit": 1000,
   "entry_fee_currency_type_id": 0,
   "entry_fee_amount": 100,
   "rating_position": 1,
-  "rating_score": 90,
+  "rating_score": 56,
   "cooldown_until": null,
   "members": [
     {
-      "user_id": 183751733,
-      "public_username": "Daniel",
-      "avatar_id": "183751733",
-      "avatar_real_id": null,
-      "avatar_url": "https://cdn.example/avatar/183751733",
+      "user_id": 162749132,
+      "public_username": "Toby*****",
+      "avatar_id": "https://cdn.example/avatars/12/00000000-0000-0000-0000-000000000000.png",
+      "avatar_real_id": 12,
+      "avatar_url": "https://cdn.example/avatars/12/00000000-0000-0000-0000-000000000000.png",
       "position": 1,
-      "contribution_score": 456786,
+      "contribution_score": 0,
       "is_me": false,
       "clean_ext_user_id": "0"
     }

package/docs/capabilities/getClans.md

@@ -146,17 +146,17 @@ for (const clan of result.clans) {
         "description": "Join the clan if you're a wild card and are completely out of control! Or if you just hate Bruce Wayne very much.\n\nPlay in the tournaments, grab that cash an…",
         "image_url": "https://cdn.example/00000000-0000-0000-0000-000000000000/entity-image-1780057181857-1.png"
       },
-      "member_count": 885,
+      "member_count": 899,
       "capacity_limit": 1000,
       "entry_fee_currency_type_id": 0,
       "entry_fee_amount": 100,
       "rating_position": 1,
-      "rating_score": 90
+      "rating_score": 56
     }
   ],
-  "user_clan_id": null,
+  "user_clan_id": 5,
   "cooldown_until": null,
-  "join_date": null
+  "join_date": 1783546987268
 }
 ```
 

package/docs/capabilities/getCurrentLevel.md

@@ -93,24 +93,24 @@ window._smartico.on('props_change', async (changed) => {
 > Where this real payload differs from the typed Returns above (TS interface vs raw wire), the REAL shape is the runtime truth.
 ```json
 {
-  "id": 698,
-  "name": "Silver",
-  "description": "Now you’re playing! Enjoy exclusive missions and exciting rewards.",
-  "image": "https://cdn.example/665b45d5a01e2191288091-3silver.png",
-  "required_points": 500,
+  "id": 701,
+  "name": "Ruby",
+  "description": "Top-tier achieved! The ultimate prestige with unmatched privileges.",
+  "image": "https://cdn.example/a403c939ce26b6a42c9f46-6ruby.png",
+  "required_points": 5500,
   "visibility_points": 0,
   "required_level_counter_1": null,
   "required_level_counter_2": null,
   "custom_data": {
-    "reward": "1000 EUR + 300 Free Spins",
-    "image_inactive": "https://cdn.example/bdf58fecfda5a1b9627f8f-LevelLevel3Enabledfalse.png",
-    "image_active": "https://cdn.example/90a40da1c5e201f8fa1d3c-LevelLevel3Enabledtrue.png",
-    "rakeback": 5,
+    "reward": "10000 EUR",
+    "image_inactive": "https://cdn.example/e917989495185e3fed695d-LevelLevel1Enabledfalse.png",
+    "image_active": "https://cdn.example/a961023ab3f6441ac19dfc-LevelLevel1Enabledtrue.png",
+    "rakeback": 6,
     "has_vip_club": true,
-    "cashback": 2
+    "cashback": 6
   },
-  "ordinal_position": 3,
-  "progress": 38
+  "ordinal_position": 6,
+  "progress": 100
 }
 ```
 

package/docs/capabilities/getInboxMessageBody.md

@@ -73,9 +73,9 @@ if (body.action === 'dp:inbox' && body.html_body) {
 ```json
 {
   "action": "dp:close",
-  "icon": "https://cdn.example/d0f46ded3f7c9439fa0239-home-gems.webp",
+  "icon": "https://cdn.example/b6e45cf4ae00002865d406-home-diamonds.webp",
   "title": "Congratulations!",
-  "preview_body": "You have received 10 Gems to your balance!",
+  "preview_body": "You have received 1 Diamonds to your balance!",
   "custom_data": {}
 }
 ```

package/docs/capabilities/getInboxMessages.md

@@ -127,12 +127,12 @@ const onlyUnread = await window._smartico.api.getInboxMessages({ read_status: 1
 ```json
 [
   {
-    "sent_date": "24/06/2026 07:43:31",
+    "sent_date": "04/08/2026 09:00:08",
     "message_guid": "00000000-0000-0000-0000-000000000000",
-    "read": true,
+    "read": false,
     "favorite": false,
     "category_id": 0,
-    "expire_on_dt": 1784879011491
+    "expire_on_dt": 1788426008061
   }
 ]
 ```

package/docs/capabilities/getInboxUnreadCount.md

@@ -47,6 +47,12 @@ await window._smartico.api.getInboxUnreadCount({
 });
 ```
 
+### Example response (REAL shape)
+> Where this real payload differs from the typed Returns above (TS interface vs raw wire), the REAL shape is the runtime truth.
+```json
+8
+```
+
 ## Errors
 See this method's TSDoc / the mutation pages for `err_code` handling.
 

package/docs/capabilities/getJackpotWinners.md

@@ -33,7 +33,8 @@ Array of `JackpotWinnerHistory`. Each item:
   - `winning_amount_jp_currency` (number) — Won amount in the Jackpot currency
   - `winning_amount_wallet_currency` (number) — Won amount in the user Wallet currency
   - `winning_position` (number) — Position of the winner. Relevant for jackpots where there could be multiple winners
-  - `avatar_id` (string) — Avatar of the winner
+  - `avatar_id` (string) — Avatar image URL of the winner
+  - `avatar_real_id` (number | null) — Numeric ID of the winner's avatar; `null` when the winner has not picked one
 
 ## Behavioral contract
 **Preconditions**
@@ -93,15 +94,15 @@ console.log('[smartico] render', winners.length, 'recent winner rows (amounts in
   {
     "winner": {
       "is_me": false,
-      "public_username": "731:*****",
-      "winning_amount_jp_currency": 16.720332488,
-      "winning_amount_wallet_currency": 98.525768722,
+      "public_username": "Asut*****",
+      "winning_amount_jp_currency": 8.32,
+      "winning_amount_wallet_currency": 8.32,
       "winning_position": 1,
-      "avatar_id": "183751796",
-      "avatar_real_id": null
+      "avatar_id": "https://cdn.example/d58c99035fadf00dcfe638-Dragongenderless.webp",
+      "avatar_real_id": 11
     },
-    "win_date_ts": 1782295329703,
-    "jp_pot_id": 306053
+    "win_date_ts": 1785909778120,
+    "jp_pot_id": 321186
   }
 ]
 ```

package/docs/capabilities/getLeaderBoard.md

@@ -160,18 +160,18 @@ console.log('[smartico] previous-week standings — render with greyed-out "ende
   ],
   "users": [
     {
-      "public_username": "Matt*****",
-      "avatar_url": "https://cdn.example/avatar/344499363",
+      "public_username": "Maxi*****",
+      "avatar_url": "https://cdn.example/d1a960365f8a3716aa5a72-Lionmale.webp",
       "level_id": 700,
       "position": 1,
-      "points": 2155,
+      "points": 1200,
       "is_me": false
     }
   ],
   "me": {
     "public_username": "Antonio",
-    "avatar_url": "https://cdn.example/avatars/12/00000000-0000-0000-0000-000000000000.png",
-    "level_id": 698,
+    "avatar_url": "https://cdn.example/avatars/11/00000000-0000-0000-0000-000000000000.png",
+    "level_id": 701,
     "position": -1,
     "points": 0,
     "is_me": true

package/docs/capabilities/getMiniGames.md

@@ -2,7 +2,7 @@
 
 > Returns all mini-game templates ("SAW" = Spin And Win — the umbrella term for wheel-spin, scratch-card, lootbox, gift-box, treasure-hunt, plinko, coin-flip, quiz, and several other formats) configured for the label.
 > Import: `import { TMiniGameTemplate } from '@smartico/public-api'`
-> Search terms: getMiniGames, minigames, getSAW, spins, wheel, SAWPrizeType, TMiniGameTemplate, SAWGameTypeName, SAWBuyInTypeName, TMiniGamePrize, MiniGamePrizeTypeName, SAWAcknowledgeTypeName, PrizeModifiers, AttemptPeriodType, SAWTemplateUI, SAWAskForUsername, SAWGameLayoutName, SAWExposeUserSpinIdName, onUpdate, subscription, id, name, description, thumbnail, visibile_when_can_spin, saw_game_type, saw_buyin_type, jackpot_add_on_attempt
+> Search terms: getMiniGames, minigames, getSAW, spins, wheel, SAWPrizeType, TMiniGameTemplate, SAWGameTypeName, SAWBuyInTypeName, TMiniGamePrize, MiniGamePrizeTypeName, SAWAcknowledgeTypeName, PrizeModifiers, AttemptPeriodType, SAWTemplateUI, SAWAskForUsername, SAWGameLayoutName, SAWExposeUserSpinIdName, onUpdate, subscription, id, name, description, thumbnail, visibile_when_can_spin, over_limit_message, no_attempts_message, jackpot_symbol
 
 ## Signature
 ```ts
@@ -230,77 +230,75 @@ for (const g of visible) {
 ```json
 [
   {
-    "id": 656,
-    "name": "Scratch & Love",
+    "id": 651,
+    "name": "Wheel of Love",
     "description": "This is demo description of mini game. <br/>\n            <hr/>\n\n            You can <b>use tags</b> like {{spins_available}}, to show number of spins that us…",
     "thumbnail": "https://cdn.example/00000000-0000-0000-0000-000000000000/ico.png",
     "visibile_when_can_spin": false,
-    "saw_game_type": "scratch",
-    "saw_buyin_type": "spins",
+    "over_limit_message": "That's enough for today, please come back tomorrow",
+    "no_attempts_message": "You don't have any more attempts on this minigame",
+    "jackpot_symbol": "hugs",
+    "saw_game_type": "wheel",
+    "saw_buyin_type": "free",
     "jackpot_add_on_attempt": 1,
-    "jackpot_current": 1070,
-    "spin_count": 5,
-    "promo_image": "https://cdn.example/d3d65f1bc722a8c66a9493-PromoImagefromTinyPNG.png",
-    "promo_text": "The Scratch of Love is better than any other scratch!",
+    "jackpot_current": 5339,
+    "spin_count": 1,
+    "promo_image": "https://cdn.example/31c0db8a8d3e9888ba009a-promo-image.png",
     "custom_data": {},
     "expose_game_stat_on_api": false,
     "relative_period_timezone": 0,
     "activeFromDate": -9223372036854776000,
     "activeTillDate": 9223372036854776000,
     "next_available_spin_ts": null,
-    "earliest_expiration_dt": 1952155860877,
-    "latest_expiration_dt": 1952155860877,
-    "custom_section_id": 491,
+    "earliest_expiration_dt": null,
+    "latest_expiration_dt": null,
     "saw_template_ui_definition": {
-      "scratch_bg_mobile": "",
-      "promo_text": "The Scratch of Love is better than any other scratch!",
       "thumbnail": "",
-      "only_in_custom_section": false,
-      "scratch_logo": "",
+      "jackpot_symbol": "hugs",
+      "over_limit_message": "That's enough for today, please come back tomorrow",
       "description": "This is demo description of mini game. <br/>\n            <hr/>\n\n            You can <b>use tags</b> like {{spins_available}}, to show number of spins that us…",
       "background_image_mobile": "",
-      "custom_css": ".scratch-card-root-mobile .scratch-area .button-area div {\n    background-image: linear-gradient(180deg,#BD0A42,50%,#BD0A42);\n}\n.scratch-card-root .scratch-a…",
-      "hide_prize_names": false,
-      "scratch_bg_desktop": "",
+      "custom_css": "/* text of the prize on sector */\n.saw-view .wheel-sector-name .sector-text {\n\n}\n\n/* the name of the game shown under the wheel */\n.saw-info-name {\n   \n}\n\n/*…",
       "priority": 1,
-      "scratch_cover": "",
       "background_image": "",
-      "sectors_count": 6,
-      "show_countdown_for_next_availability": false,
-      "promo_image": "https://cdn.example/d3d65f1bc722a8c66a9493-PromoImagefromTinyPNG.png",
-      "disable_background_music": true,
-      "scratch_cursor": "",
+      "wheel_layout": 1,
+      "sectors_count": 7,
+      "show_countdown_for_next_availability": true,
+      "promo_image": "https://cdn.example/31c0db8a8d3e9888ba009a-promo-image.png",
+      "disable_background_music": false,
       "background_sound": "",
-      "name": "Scratch & Love",
-      "spin_animation_duration": 15,
+      "name": "Wheel of Love",
+      "max_spins_period_ms": 60000,
+      "spin_animation_duration": 10,
       "flow_builder_only": false,
-      "custom_section_id": 491,
-      "background_music_volume": 10
+      "wheel_pointer_rotation": 0,
+      "background_music_volume": 10,
+      "no_attempts_message": "You don't have any more attempts on this minigame"
     },
     "show_prize_history": true,
-    "max_number_of_attempts": 0,
+    "max_number_of_attempts": 1,
     "prizes": [
       {
-        "id": 15589,
-        "name": "No luck this time =(",
+        "id": 3272,
+        "name": "Try again!",
         "prize_type": "no-prize",
         "prize_value": 1,
-        "font_size": null,
-        "position": 7,
+        "font_size": 20,
+        "icon": "",
         "sectors": [
-          ""
+          1
         ],
         "acknowledge_type": "silent",
         "acknowledge_dp": "dp:ok",
         "acknowledge_action_title": "OK",
         "pool": null,
-        "pool_initial": 100,
+        "pool_initial": 500,
         "wins_count": null,
         "weekdays": null,
         "active_from_ts": null,
         "active_till_ts": null,
         "relative_period_timezone": 0,
-        "is_surcharge": false,
+        "is_surcharge": true,
         "is_deleted": false,
         "custom_data": {},
         "max_give_period_type_id": 2

package/docs/capabilities/getMiniGamesHistory.md

@@ -2,7 +2,7 @@
 
 > Returns a paginated, newest-first list of the user's past mini-game spins — each row carries the won prize ID, the client-side `request_id` used for the spin, and a server-recorded `is_claimed` flag (`true` if the spin has been acknowledged).
 > Import: `import { TSawHistory } from '@smartico/public-api'`
-> Search terms: getMiniGamesHistory, minigames, getSAWHistory, TSawHistory, SAWTemplate, SAWGameType, SAWTemplateUI, SAWBuyInType, SAWPrize
+> Search terms: getMiniGamesHistory, minigames, getSAWHistory, TSawHistory, SAWTemplate, SAWGameType, SAWTemplateUI, SAWBuyInType, SAWPrize, template, saw_template_id, saw_prize_id, prize_amount, client_request_id, is_claimed, create_date_ts, acknowledge_date_ts
 
 ## Signature
 ```ts
@@ -172,7 +172,88 @@ console.log('[smartico] page 2 loaded —', page2.length, 'more rows;',
 > Where this real payload differs from the typed Returns above (TS interface vs raw wire), the REAL shape is the runtime truth.
 ```json
 [
-  null
+  {
+    "template": {
+      "saw_template_id": 12658,
+      "saw_game_type_id": 13,
+      "saw_template_ui_definition": {
+        "show_countdown_for_next_availability": false,
+        "promo_text": "Guess the shell, grab your iPhone",
+        "promo_image": "https://cdn.example/00000000-0000-0000-0000-000000000000/entity-image-1783600519171-1.png",
+        "custom_game_url": "https://00000000-0000-0000-0000-000000000000.ld-int.dev/index.html",
+        "name": "Pinyata",
+        "description": "Remember that shell with the prize, follow it, and open the right cap to grab it",
+        "flow_builder_only": false,
+        "priority": 1
+      },
+      "saw_buyin_type_id": 1,
+      "buyin_cost_points": 0,
+      "visibile_when_can_spin": false,
+      "spin_count": null,
+      "prizesMap": "…(keyed duplicate of `prizes[]`)",
+      "prizes": [
+        {
+          "saw_prize_id": 75905,
+          "saw_template_id": 12658,
+          "saw_prize_ui_definition": {
+            "aknowledge_message_lose": "Lost",
+            "sectors": [
+              ""
+            ],
+            "name": "3 diamonds",
+            "second_btn": "",
+            "acknowledge_dp": "dp:ok",
+            "sound_type": 2,
+            "aknowledge_message": "You won 3 diamonds!!!",
+            "acknowledge_action_title": "OK",
+            "acknowledge_type": 3,
+            "second_btn_action_title": ""
+          },
+          "prize_value": 1,
+          "prize_type_id": 10,
+          "pool": 98,
+          "wins_count": 7,
+          "pool_initial": 100,
+          "prize_ref_id": 0,
+          "is_surcharge": false,
+          "prize_details_json": {
+            "diamonds": 3,
+            "amount_type": 0,
+            "_gems_diamonds_type": 1
+          },
+          "affects_points_progress": true,
+          "affects_leaderboard_progress": true,
+          "affects_level_progress": true,
+          "affects_current_balance_progress": true,
+          "place_from": null,
+          "place_to": null,
+          "weekdays": null,
+          "active_from": null,
+          "active_till": null,
+          "active_from_ts": null,
+          "active_till_ts": null,
+          "is_deleted": false,
+          "relative_period_timezone": 0,
+          "show_prize_history": true,
+          "needed_tag_replacement": false,
+          "win_segment_id": null,
+          "win_conditions": "[]",
+          "max_give_period_type_id": 2
+        }
+      ],
+      "segment_id": 44162,
+      "label_id": 16018,
+      "maxActiveSpinsAllowed": null,
+      "…": "(+29 more keys)"
+    },
+    "saw_template_id": 12658,
+    "saw_prize_id": 75907,
+    "prize_amount": 1,
+    "client_request_id": "00000000-0000-0000-0000-000000000000",
+    "is_claimed": true,
+    "create_date_ts": 1785917360000,
+    "acknowledge_date_ts": 1785917360000
+  }
 ]
 ```
 

package/docs/capabilities/getMissions.md

@@ -264,7 +264,7 @@ console.log('[smartico] initial mission list ready — render', generalView.leng
     "complete_date_ts": 1780930368099,
     "completed_today": false,
     "completed_this_week": false,
-    "completed_this_month": true,
+    "completed_this_month": false,
     "availability_status": 2,
     "hide_locked_mission": true,
     "prize_claim_expiration_date": null,

package/docs/capabilities/getRaffleDrawRun.md

@@ -176,7 +176,7 @@ if ((detail.winners_total ?? 0) > 20) {
       "min_required_total_tickets": 100,
       "cap_prizes_per_run": 3,
       "priority": 1,
-      "stock_items_per_draw": 9991,
+      "stock_items_per_draw": 9951,
       "should_claim": false,
       "winners": [],
       "requires_claim": false,
@@ -184,14 +184,14 @@ if ((detail.winners_total ?? 0) > 20) {
     }
   ],
   "current_state": 1,
-  "run_id": 775459,
+  "run_id": 947417,
   "execution_type": 2,
-  "execution_ts": 1782378000000,
-  "previous_run_ts": 1782291600000,
-  "previous_run_id": 771353,
-  "ticket_start_ts": 1782291600000,
+  "execution_ts": 1786006800000,
+  "previous_run_ts": 1785920400000,
+  "previous_run_id": 944957,
+  "ticket_start_ts": 1785920400000,
   "allow_multi_prize_per_ticket": false,
-  "total_tickets_count": 93,
+  "total_tickets_count": 44,
   "my_tickets_count": 0,
   "my_last_tickets": [],
   "user_opted_in": true,

package/docs/capabilities/getRaffleDrawRunsHistory.md

@@ -92,7 +92,7 @@ console.log('[smartico] render history rows for the daily draw — newest first:
 [
   {
     "id": 323,
-    "run_id": 688934,
+    "run_id": 861842,
     "name": "Hourly draw",
     "description": "💰 Every hour, the luck could be yours! 🍀 Participate in our hourly draw for a chance to WIN BIG! 💸 Don't miss out!",
     "image_url": "https://cdn.example/5bcd2fd9bf96f3709d96b5-HourlyDraw-Promoimage.png",
@@ -101,8 +101,8 @@ console.log('[smartico] render history rows for the daily draw — newest first:
     "background_image_url": "https://cdn.example/867db7f6791f0a45039608-DrawBackground.png",
     "background_image_url_mobile": "https://cdn.example/d31a8d4708a17723d57b4b-DrawBackgroundMobilecopy.png",
     "is_grand": false,
-    "execution_ts": 1780876800000,
-    "ticket_start_ts": 1780873200000,
+    "execution_ts": 1784012400000,
+    "ticket_start_ts": 1784008800000,
     "is_winner": false,
     "has_unclaimed_prize": false
   }

package/docs/capabilities/getRaffles.md

@@ -184,7 +184,7 @@ for (const raffle of raffles) {
     "start_date": 1780669800000,
     "end_date": 1796157059000,
     "max_tickets_count": 2000000,
-    "current_tickets_count": 13198,
+    "current_tickets_count": 72926,
     "draws": [
       {
         "id": 322,
@@ -207,7 +207,7 @@ for (const raffle of raffles) {
             "min_required_total_tickets": 100,
             "cap_prizes_per_run": 3,
             "priority": 1,
-            "stock_items_per_draw": 9991,
+            "stock_items_per_draw": 9951,
             "should_claim": false,
             "winners": [],
             "requires_claim": false,
@@ -215,14 +215,14 @@ for (const raffle of raffles) {
           }
         ],
         "current_state": 1,
-        "run_id": 775459,
+        "run_id": 947417,
         "execution_type": 2,
-        "execution_ts": 1782378000000,
-        "previous_run_ts": 1782291600000,
-        "previous_run_id": 771353,
-        "ticket_start_ts": 1782291600000,
+        "execution_ts": 1786006800000,
+        "previous_run_ts": 1785920400000,
+        "previous_run_id": 944957,
+        "ticket_start_ts": 1785920400000,
         "allow_multi_prize_per_ticket": false,
-        "total_tickets_count": 93,
+        "total_tickets_count": 44,
         "my_tickets_count": 0,
         "my_last_tickets": [],
         "user_opted_in": true,

package/docs/capabilities/getStorePurchasedItems.md

@@ -259,12 +259,12 @@ try {
     "category_ids": [
       567
     ],
-    "pool": 1000,
+    "pool": 999,
     "purchase_ts": 1781880583706,
     "purchase_points_amount": 25,
     "purchased_today": false,
     "purchased_this_week": false,
-    "purchased_this_month": true,
+    "purchased_this_month": false,
     "show_timer": false,
     "related_games": []
   }