@smartico/public-api 0.0.434 → 0.0.436

package/docs/ui/minigames/UIGuide_getMiniGamesHistory.md

@@ -25,7 +25,7 @@ Fields rendered per row:
 |---|---|---|
 | Template icon | `template.thumbnail` (or similar) | 1:1 |
 | Prize name | Look up `template.prizes[i]` by `saw_prize_id` | Display the prize's `name`. A spin finalised as lost (`miniGameWinAcknowledgeRequest` with `lose: true`) has no prize attached — render it as a loss. |
-| Prize amount | `template.prizes[i].prize_value` or `prize_amount` | E.g. "100 points" |
+| Prize amount | `template.prizes[i].prize_value` or `prize_amount`; for gems/diamonds prizes `prize_details_json.gems` / `.diamonds`, for raffle-ticket prizes `prize_details_json.tickets_count` | E.g. "100 points", "50 Diamonds". The history row carries the template as sent by the server, where `prize_value` of a gems/diamonds or raffle-ticket prize is only a default — `getMiniGames()` already resolves it into `prize_value` |
 | Spin date | `create_date_ts` | Format as user-local relative time ("2h ago") or short date |
 | Claim status | `is_claimed` | Show check-mark when true; "Pending claim" CTA when false |
 | Acknowledge date | `acknowledge_date_ts` | Only when `is_claimed === true` |

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@smartico/public-api",
-	"version": "0.0.434",
+	"version": "0.0.436",
 	"description": "Smartico public API",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",

package/src/MiniGames/SAWGetTemplatesResponse.ts

@@ -6,13 +6,31 @@ import { SAWBuyInType, SAWBuyInTypeNamed } from './SAWBuyInType';
 import { SAWExposeUserSpinIdNamed } from './SAWExposeUserSpinId';
 import { SAWGameLayoutNamed } from './SAWGameLayout';
 import { SAWGameType, SAWGameTypeNamed } from './SAWGameType';
-import { MiniGamePrizeTypeNamed } from './SAWPrizeType';
+import { SAWPrize } from './SAWPrize';
+import { MiniGamePrizeTypeNamed, SAWPrizeType } from './SAWPrizeType';
 import { SAWTemplate } from './SAWTemplate';
 
 export interface SAWGetTemplatesResponse extends ProtocolResponse {
 	templates: SAWTemplate[];
 }
 
+/**
+ * The amount a prize gives. Gems/diamonds and raffle-ticket prizes carry it in
+ * `prize_details_json` (their `prize_value` is only a default), the same way the
+ * default Smartico UI reads it; every other type keeps `prize_value`.
+ */
+const sawPrizeValue = (p: SAWPrize): number => {
+	const d = p.prize_details_json;
+	let n = 0;
+	if (p.prize_type_id === SAWPrizeType.GEMS_AND_DIAMONDS && d) {
+		// _gems_diamonds_type: 0 gems, 1 diamonds, 2 both
+		n = (d._gems_diamonds_type === 1 ? 0 : d.gems || 0) + (d._gems_diamonds_type === 0 ? 0 : d.diamonds || 0);
+	} else if (p.prize_type_id === SAWPrizeType.RAFFLE_TICKET && d) {
+		n = d.tickets_count || 0;
+	}
+	return n > 0 ? n : p.prize_value;
+};
+
 export const SAWTemplatesTransform = (items: SAWTemplate[]): TMiniGameTemplate[] => {
 	return items.map((r) => {
 		const x: TMiniGameTemplate = {
@@ -66,7 +84,7 @@ export const SAWTemplatesTransform = (items: SAWTemplate[]): TMiniGameTemplate[]
 					id: p.saw_prize_id,
 					name: p.saw_prize_ui_definition.name,
 					prize_type: MiniGamePrizeTypeNamed(p.prize_type_id),
-					prize_value: p.prize_value,
+					prize_value: sawPrizeValue(p),
 					font_size: p.saw_prize_ui_definition.font_size,
 					font_size_mobile: p.saw_prize_ui_definition.font_size_mobile,
 					icon: p.saw_prize_ui_definition.icon,

package/src/Missions/MissionsUtils.ts

@@ -1,12 +1,19 @@
-import { IntUtils } from "../IntUtils";
 import { AchievementAvailabilityStatus } from "./AchievementAvailabilityStatus";
 import { AchievementStatus } from "./AchievementStatus";
 import { UserAchievement } from "./UserAchievement";
 import { UserAchievementTask } from "./UserAchievementTask";
 import { BadgesTimeLimitStates } from "./BadgesTimeLimitStates";
 
-type UserStateParamsKeys = 'core_fav_game_top3' | 'core_fav_game_type_top3' | 'core_fav_game_provider_top3' | 'core_recommended_deposit_amount' | 'core_recommended_casino_bet_amount' | 'core_recommended_sport_bet_amount';
-const USER_STATE_PARAMS_KEYS_GAMES: UserStateParamsKeys[] = ['core_fav_game_top3', 'core_fav_game_type_top3', 'core_fav_game_provider_top3'];
+type UserStateParamsKeys =
+    | 'core_fav_game_top3' | 'core_fav_game_type_top3' | 'core_fav_game_provider_top3'
+    | 'core_fav_sport_type_top3' | 'core_fav_sport_league_top3'
+    | 'core_recommended_deposit_amount' | 'core_recommended_casino_bet_amount' | 'core_recommended_sport_bet_amount';
+
+// tag -> favorites (top 3 arrays) that fill it; a task has at most one condition per tag (enforced in the BO)
+const FAV_TAGS: [string, UserStateParamsKeys[]][] = [
+    ['{{suggested_games}}', ['core_fav_game_top3', 'core_fav_game_type_top3', 'core_fav_game_provider_top3']],
+    ['{{suggested_sport}}', ['core_fav_sport_type_top3', 'core_fav_sport_league_top3']],
+];
 const USER_STATE_PARAMS_KEYS_BET_AMOUNT: UserStateParamsKeys[] = [
     'core_recommended_deposit_amount',
     'core_recommended_casino_bet_amount',
@@ -212,64 +219,47 @@ export class MissionUtils {
 
         const userStateParams = (task.user_state_params || {});
         const userStateOperator = task.task_public_meta?.user_state_operations;
-        const userStateParamsKeys = Object.keys(userStateParams);
-
-        if (userStateParamsKeys.length === 0 || !userStateOperator) {
+        if (Object.keys(userStateParams).length === 0 || !userStateOperator) {
             return result;
         }
 
-        const operatorsMulti = ['has', '!has'];
-        const operatorsPos = ['pos1', 'pos2', 'pos3'];
-
-        let suggestedGames: string = '';
-        let suggestedValue: string = '';
-
-        userStateParamsKeys.forEach((k: UserStateParamsKeys) => {
-            const operator = userStateOperator[k]?.op;
-
-            if (USER_STATE_PARAMS_KEYS_GAMES.includes(k)) {
-                if (operatorsMulti.includes(operator)) {
-                    const value = userStateParams[k]?.filter(v => Boolean(v));
-                    if (value && value.length > 0) {
-                        suggestedGames = value.map((v: string) => {
-                            const cleaned = v.replace(/_/g, ' ');
-                            return toGameTitleCase(cleaned);
-                        }).join(', ');
-                    }
-                }
-
-                if (operatorsPos.includes(operator)) {
-                    const value = userStateParams[k];
-                    const pos = Number(operator.replace('pos', '')) - 1;
+        const formatFav = (v: string): string => toGameTitleCase(v.replace(/_/g, ' '));
 
-                    if (IntUtils.isNotNull(pos) && value && value[pos]) {
-                        suggestedGames = value[pos];
+        // 'has' / '!has' -> all favorites, 'posN' -> the N-th one
+        const favValue = (k: UserStateParamsKeys): string => {
+            const values = userStateParams[k];
+            const operator: string = userStateOperator[k]?.op;
 
-                        if (suggestedGames) {
-                            suggestedGames = toGameTitleCase(suggestedGames.replace(/_/g, ' '));
-                        }
+            if (!Array.isArray(values)) {
+                return '';
+            }
 
-                    }
-                }
+            if (operator === 'has' || operator === '!has') {
+                return values.filter(Boolean).map(formatFav).join(', ');
             }
 
-            if (USER_STATE_PARAMS_KEYS_BET_AMOUNT.includes(k)) { 
-                suggestedValue = userStateParams[k];
+            const pos = /^pos[1-3]$/.test(operator) ? values[Number(operator.substring(3)) - 1] : null;
 
-                if (suggestedValue) {
-                    const currencyFromTheTask = userStateParams?.core_wallet_currency;
+            return pos ? formatFav(pos) : '';
+        };
 
-                    suggestedValue = `${suggestedValue} ${currencySymbol || currencyFromTheTask || ''}`;
-                }
+        // split/join replaces every occurrence of the tag, not only the first one
+        const replaceTag = (tag: string, value: string) => {
+            if (value && result) {
+                result = result.split(tag).join(value);
             }
+        };
+
+        FAV_TAGS.forEach(([tag, keys]) => {
+            replaceTag(tag, keys.map(favValue).find(Boolean));
         });
 
-        if (suggestedGames && result) {
-            result = result.replace('{{suggested_games}}', suggestedGames);
-        }
+        const amountKey = USER_STATE_PARAMS_KEYS_BET_AMOUNT.find((k) => userStateParams[k]);
+
+        if (amountKey) {
+            const currencyFromTheTask = userStateParams.core_wallet_currency;
 
-        if (suggestedValue && result) {
-            result = result.replace('{{suggested_value}}', suggestedValue);
+            replaceTag('{{suggested_value}}', `${userStateParams[amountKey]} ${currencySymbol || currencyFromTheTask || ''}`);
         }
 
         return result;

package/src/Missions/UserAchievement.ts

@@ -76,13 +76,13 @@ export const UserAchievementTransform = (items: UserAchievement[]): TMissionOrBa
 			if (missionName?.includes('{{suggested_') || missionSubHeader?.includes('{{suggested_') || missionDescription?.includes('{{suggested_')) {
 				r.achievementTasks.forEach(t => {
 					if (r.ach_public_meta.name?.includes('{{suggested_')) {
-						missionName = MissionUtils.replaceTagsFavMissionTask({ task: t, valueToReplace: r.ach_public_meta.name });
+						missionName = MissionUtils.replaceTagsFavMissionTask({ task: t, valueToReplace: missionName });
 					}
 					if (r.ach_public_meta.sub_header?.includes('{{suggested_')) {
-						missionSubHeader = MissionUtils.replaceTagsFavMissionTask({ task: t, valueToReplace: r.ach_public_meta.sub_header });
+						missionSubHeader = MissionUtils.replaceTagsFavMissionTask({ task: t, valueToReplace: missionSubHeader });
 					}
 					if (r.ach_public_meta.description?.includes('{{suggested_')) {
-						missionDescription = MissionUtils.replaceTagsFavMissionTask({ task: t, valueToReplace: r.ach_public_meta.description });
+						missionDescription = MissionUtils.replaceTagsFavMissionTask({ task: t, valueToReplace: missionDescription });
 					}
 				});
 			}

package/src/WSAPI/WSAPITypes.ts

@@ -29,8 +29,8 @@ export interface TMiniGamePrize {
 	name: string;
 	/** The type of the prize — see {@link MiniGamePrizeTypeName} ('no-prize', 'points', 'gems-and-diamonds', 'spin', 'bonus', 'jackpot', 'raffle-ticket', 'mission', 'change-level', 'manual') */
 	prize_type: MiniGamePrizeTypeName;
-	/** Numeric value of the prize in case it's 'points' or 'spin' type. For other types of prizes this value is not relevant.
-	 * For example for prize  '100 points' the prize_value will be 100. For '100 free spins' the prize_value will be 100.
+	/** Amount of the prize: points for 'points', attempts for 'spin', gems or diamonds for 'gems-and-diamonds' (their sum when the prize gives both), tickets for 'raffle-ticket'. Not relevant for other types.
+	 * For example for prize '100 points' the prize_value will be 100, for '100 free spins' 100, for '50 Diamonds' 50.
 	*/
 	prize_value?: number;
 	/** Custom font size in px for rendering the prize name on the game surface (e.g. a wheel sector), desktop */