@smartico/public-api 0.0.433 → 0.0.435

package/docs/ui/inbox/UIGuide_getInboxMessageBody.md

@@ -2,8 +2,9 @@
 
 ## Overview
 - Returns the rich body (title, preview, icon, action, html_body,
-  buttons, custom_data) for one message identified by its
-  `message_guid`.
+  buttons, custom_data) and the preview-popup settings
+  (`show_preview`, `show_duration_sec`) for one message identified
+  by its `message_guid`.
 - Fetched from a CDN, NOT over the WebSocket — latency depends on
   CDN proximity. No SDK-level cache (browser HTTP cache may apply
   via CDN Cache-Control headers).
@@ -42,6 +43,27 @@ payload has `html_body` or `buttons` but the action isn't
 consumer. Don't try to render `html_body` for non-`'dp:inbox'`
 messages — it will be `undefined`.
 
+## Preview popup vs silent delivery
+
+Every message is stored in the inbox list. The preview settings
+decide whether a newly arrived message also pops up briefly (the
+"toast" the default Smartico UI shows while the user is online).
+
+| Field | Value | Behaviour |
+|---|---|---|
+| `show_preview` | `true` or missing | Show a preview popup and store the message in the list |
+| `show_preview` | `false` | Store the message silently, with no popup |
+| `show_duration_sec` | number | Hide the popup after this many seconds |
+| `show_duration_sec` | `null` or missing | Hide the popup after 7 seconds (the default Smartico UI's default) |
+
+Values are returned exactly as the operator configured them, so
+apply the defaults above yourself (e.g. `body.show_preview !== false`,
+`body.show_duration_sec ?? 7`).
+
+Only show the popup for messages that arrive while the user is
+online. Messages loaded from history via {@link getInboxMessages}
+should go straight into the list.
+
 ## Sandboxed iframe (for `html_body`)
 
 `html_body` is operator-supplied HTML. **Render in a sandboxed

package/package.json

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

package/src/Inbox/InboxMessage.ts

@@ -23,7 +23,7 @@ export interface InboxMessageBody {
 	// default is 'true'
 	show_preview?: boolean;
 	// duration in seconds for how long to show preview, default is 7 seconds
-	show_duration_sec?: number;
+	show_duration_sec?: number | null;
 	// indicator if the image in html_body can be zoomed out
 	// default is 'false'
 	enable_zoom_mode?: boolean;
@@ -62,6 +62,8 @@ export const InboxMessageBodyTransform = (item: InboxMessageBody): TInboxMessage
 		title: item.title,
 		preview_body: item.body,
 		custom_data: IntUtils.JsonOrText(item?.custom_data),
+		show_preview: item.show_preview,
+		show_duration_sec: item.show_duration_sec,
 	};
 
 	if (item.action === 'dp:inbox') {

package/src/MiniGames/SAWTemplateUI.ts

@@ -486,6 +486,35 @@ export interface SAWTemplateUI {
      */
     use_custom?: boolean;
 
+    /**
+     * Whether a custom mini-game fills the whole mini-game window instead of
+     * the default fixed-size frame (800×516 on desktop, 400×745 on mobile).
+     *
+     * Applies wherever the game is opened — a spin attempt shown to the user,
+     * a deep link, or `_smartico.miniGame()` in standalone or inline mode.
+     * The `fullscreen` option of `_smartico.miniGame()` overrides it per call.
+     *
+     * When `false` or omitted, the default frame size is used.
+     * Back-Office label: _"Standalone full screen"_.
+     */
+    standalone_fullscreen?: boolean;
+
+    /**
+     * Width of the custom mini-game frame on desktop when opened standalone or inline,
+     * as a CSS size (`800px`, `100%`, `90vw`; a bare number is treated as pixels).
+     * Empty or invalid values fall back to the default 800px. Ignored on mobile.
+     * Back-Office label: _"Standalone width"_.
+     */
+    standalone_width?: string;
+
+    /**
+     * Height of the custom mini-game frame on desktop when opened standalone or inline,
+     * as a CSS size (`516px`, `100%`, `90vh`; a bare number is treated as pixels).
+     * Empty or invalid values fall back to the default 516px. Ignored on mobile.
+     * Back-Office label: _"Standalone height"_.
+     */
+    standalone_height?: string;
+
 	/**
 	 * Minutes for the Voyager seed window.
 	 * The seed window is the range of seeds that can be used to generate the map.

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/SmarticoGlobal.ts

@@ -50,6 +50,24 @@ export interface SmarticoWidgetParams {
 	zoom?: number;
 	/** Force the mobile layout regardless of viewport. */
 	force_mobile?: boolean;
+	/**
+	 * Custom mini-games only ({@link SmarticoGlobal.miniGame}): `true` fills the whole mini-game window,
+	 * `false` keeps the default fixed-size frame. Overrides the template's "Standalone full screen" setting;
+	 * when omitted, the template setting is used.
+	 */
+	fullscreen?: boolean;
+	/**
+	 * Custom mini-games only ({@link SmarticoGlobal.miniGame}): desktop width of the game frame as a CSS size
+	 * (`1000px`, `100%`, `90vw`; a number is treated as pixels). Overrides the template's "Standalone width"
+	 * and "Standalone full screen" settings. Ignored on mobile.
+	 */
+	frame_width?: string | number;
+	/**
+	 * Custom mini-games only ({@link SmarticoGlobal.miniGame}): desktop height of the game frame as a CSS size
+	 * (`600px`, `100%`, `90vh`; a number is treated as pixels). Overrides the template's "Standalone height"
+	 * and "Standalone full screen" settings. Ignored on mobile.
+	 */
+	frame_height?: string | number;
 }
 
 /**

package/src/WSAPI/WSAPIInbox.ts

@@ -363,6 +363,16 @@ export class WSAPIInbox extends WSAPILeaderBoard {
 	 * for safe execution — that helper handles URL vs deep-link
 	 * routing.
 	 *
+	 * **Preview vs silent delivery**
+	 * Every message belongs in your inbox list. `show_preview` decides
+	 * whether it should also pop up briefly when it arrives:
+	 * - `show_preview !== false` → show a preview popup for
+	 *   `show_duration_sec ?? 7` seconds.
+	 * - `show_preview === false` → store it silently, with no popup.
+	 * These fields are returned exactly as the operator configured them;
+	 * a missing value means the default above, the same as the default
+	 * Smartico UI.
+	 *
 	 * **Idempotency / Side effects**: safe. Read-only HTTP fetch.
 	 *
 	 * **UI guidance**: see [UI Guide — `getInboxMessageBody`](../../docs/ui/inbox/UIGuide_getInboxMessageBody.md).
@@ -388,6 +398,12 @@ export class WSAPIInbox extends WSAPILeaderBoard {
 	 *   console.log('[smartico] simple message — show preview_body + single CTA wired to:', body.action,
 	 *     '— execute via _smartico.dp(body.action)');
 	 * }
+	 *
+	 * if (body.show_preview !== false) {
+	 *   console.log('[smartico] new message — show a preview popup for', body.show_duration_sec ?? 7, 'seconds');
+	 * } else {
+	 *   console.log('[smartico] new message — store it in the inbox silently, no popup');
+	 * }
 	 * ```
 	 */
 	public async getInboxMessageBody(messageGuid: string): Promise<TInboxMessageBody> {

package/src/WSAPI/WSAPITypes.ts

@@ -1146,6 +1146,12 @@ export interface TInboxMessageBody {
 	/** Operator-defined custom data. The SDK auto-parses JSON-looking
 	 * strings, so at runtime this is `any` despite the `string` type. */
 	custom_data?: string;
+	/** Whether to show a short preview popup when the message arrives.
+	 * `false` means store it in the inbox silently; missing means `true`. */
+	show_preview?: boolean;
+	/** How long the preview popup stays visible, in seconds.
+	 * `null` or missing means 7 seconds. */
+	show_duration_sec?: number | null;
 }
 
 /**