@smartico/public-api 0.0.410 → 0.0.411

package/dist/index.modern.mjs

@@ -535,6 +535,7 @@ const SAWTemplatesTransform = items => {
           sectors: p.saw_prize_ui_definition.sectors,
           acknowledge_type: SAWAcknowledgeTypeNamed(p.saw_prize_ui_definition.acknowledge_type),
           aknowledge_message: p.saw_prize_ui_definition.aknowledge_message,
+          aknowledge_message_lose: p.saw_prize_ui_definition.aknowledge_message_lose,
           acknowledge_dp: p.saw_prize_ui_definition.acknowledge_dp,
           acknowledge_action_title: p.saw_prize_ui_definition.acknowledge_action_title,
           acknowledge_dp_additional: p.saw_prize_ui_definition.acknowledge_dp_additional,
@@ -7199,7 +7200,11 @@ class WSAPIMiniGames extends WSAPIRaffles {
    * true` with no prize attached. Use this for game mechanics where the
    * player can decline or forfeit the drawn prize — e.g. a
    * gamble/discard step, or a client-driven game where the user's final
-   * action decides whether the pre-drawn prize is actually won. It only
+   * action decides whether the pre-drawn prize is actually won (the
+   * default Smartico UI does this for the Voyager game: failing the
+   * star-collection run finalises the spin as lost). When configured,
+   * the prize's `aknowledge_message_lose` is the operator's result copy
+   * for this case — show it instead of `aknowledge_message`. It only
    * works on a spin that is not yet finalised, so it requires playing
    * with `acknowledge: false` and calling promptly — once the automatic
    * acknowledge or the server-side fallback (below) has finalised the
@@ -7229,6 +7234,8 @@ class WSAPIMiniGames extends WSAPIRaffles {
    * - Either way the spin's `is_claimed` flips to `true` on the next
    *   {@link getMiniGamesHistory} fetch.
    *
+   * **UI guidance**: see [UI Guide — `miniGameWinAcknowledgeRequest`](../../docs/ui/minigames/UIGuide_miniGameWinAcknowledgeRequest.md).
+   *
    * **Visitor mode**: not supported.
    *
    * @param request_id  Correlation id of the spin to finalise: the
@@ -9997,6 +10004,7 @@ class SmarticoAPI {
           t.prizes.forEach(p => {
             p.saw_prize_ui_definition.name = IntUtils.replaceAll(p.saw_prize_ui_definition.name, '{{jackpot}}', jackpotValue);
             p.saw_prize_ui_definition.aknowledge_message = IntUtils.replaceAll(p.saw_prize_ui_definition.aknowledge_message, '{{jackpot}}', jackpotValue);
+            p.saw_prize_ui_definition.aknowledge_message_lose = IntUtils.replaceAll(p.saw_prize_ui_definition.aknowledge_message_lose, '{{jackpot}}', jackpotValue);
           });
         }
       });