@smartico/public-api 0.0.432 → 0.0.434

package/dist/Inbox/InboxMessage.d.ts

@@ -14,7 +14,7 @@ export interface InboxMessageBody {
         action: string;
     }[];
     show_preview?: boolean;
-    show_duration_sec?: number;
+    show_duration_sec?: number | null;
     enable_zoom_mode?: boolean;
     open_links?: OpenLinksType;
     custom_data?: string;

package/dist/Jackpots/GetJackpotWinnersResponse.d.ts

@@ -5,6 +5,8 @@ export interface GetJackpotWinnersResponse extends ProtocolResponse {
     winners: JackpotWinnerHistory[];
     /** Whether there are more winners to fetch */
     has_more: boolean;
+    /** Win statistics of the jackpot template */
+    win_stats?: JackpotWinStats;
 }
 export interface JackpotWinnerHistory {
     /** Id of the jackpot pot */
@@ -14,7 +16,33 @@ export interface JackpotWinnerHistory {
     /** Info about jackpot winner */
     winner: JackPotWinner;
 }
+export interface JackpotWinStats {
+    /** Total number of issued wins of the jackpot template. Wins waiting for manual approval are not counted */
+    total_wins: number;
+    /** The biggest win of the jackpot template, `null` when there are no wins yet */
+    highest_win: JackpotWin | null;
+    /** The most recent win of the jackpot template, `null` when there are no wins yet */
+    last_win: JackpotWin | null;
+}
+export interface JackpotWin {
+    /** Won amount in the Jackpot currency */
+    winning_amount: number;
+    /** Date of winning in milliseconds */
+    win_date_ts: number;
+    /** Name of the winner, masked by default. `null` when the jackpot template doesn't expose winners over API */
+    public_username: string | null;
+}
+export interface TGetJackpotWinStatsResponse {
+    /** The list of jackpot winners */
+    winners: JackpotWinnerHistory[];
+    /** Win statistics of the jackpot template */
+    win_stats: JackpotWinStats;
+}
 /**
  * @ignore
  */
 export declare const GetJackpotWinnersResponseTransform: (items: JackpotWinnerHistory[]) => JackpotWinnerHistory[];
+/**
+ * @ignore
+ */
+export declare const GetJackpotWinStatsResponseTransform: (response: GetJackpotWinnersResponse) => TGetJackpotWinStatsResponse;

package/dist/MiniGames/SAWTemplateUI.d.ts

@@ -390,6 +390,32 @@ export interface SAWTemplateUI {
      * Back-Office label: _"Use Custom Game"_.
      */
     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/dist/SmarticoAPI.d.ts

@@ -29,7 +29,7 @@ import { GetAvatarsCustomizedResponse } from './Avatars/GetAvatarsCustomizedResp
 import { GetAvatarPromptsResponse } from './Avatars/GetAvatarPromptsResponse';
 import { SetAvatarResponse } from './Avatars';
 import { AvatarCustomizeResponse } from './Avatars/AvatarCustomizeResponse';
-import { GetJackpotWinnersResponse, JackpotWinnerHistory } from './Jackpots/GetJackpotWinnersResponse';
+import { GetJackpotWinnersResponse, JackpotWinnerHistory, TGetJackpotWinStatsResponse } from './Jackpots/GetJackpotWinnersResponse';
 import { GetJackpotEligibleGamesResponse, TGetJackpotEligibleGamesResponse } from './Jackpots/GetJackpotEligibleGamesResponse';
 import { GamePickGameInfo, GamePickRound, GamePickRoundBoard, GamePickUserInfo, GamesApiResponse } from './GamePick';
 interface Tracker {
@@ -113,6 +113,7 @@ declare class SmarticoAPI {
     }): Promise<JackpotsOptoutResponse>;
     getJackpotWinners(user_ext_id: string, limit: number, offset: number, jp_template_id: number): Promise<GetJackpotWinnersResponse>;
     getJackpotWinnersT(user_ext_id: string, limit: number, offset: number, jp_template_id: number): Promise<JackpotWinnerHistory[]>;
+    getJackpotWinStatsT(user_ext_id: string, limit: number, offset: number, jp_template_id: number): Promise<TGetJackpotWinStatsResponse>;
     getJackpotEligibleGames(user_ext_id: string, { jp_template_id }: {
         jp_template_id: number;
     }): Promise<GetJackpotEligibleGamesResponse>;

package/dist/SmarticoGlobal.d.ts

@@ -34,6 +34,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;
 }
 /**
  * Options passed to {@link SmarticoGlobal.init} / {@link SmarticoGlobal.initVisitorMode}.

package/dist/WSAPI/WSAPIInbox.d.ts

@@ -318,6 +318,16 @@ export declare 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).
@@ -343,6 +353,12 @@ export declare 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');
+     * }
      * ```
      */
     getInboxMessageBody(messageGuid: string): Promise<TInboxMessageBody>;

package/dist/WSAPI/WSAPIJackpots.d.ts

@@ -1,5 +1,6 @@
 import { JackpotDetails, JackpotWinnerHistory, JackpotsOptinResponse, JackpotsOptoutResponse } from '../Jackpots';
 import { TGetJackpotEligibleGamesResponse } from '../Jackpots/GetJackpotEligibleGamesResponse';
+import { TGetJackpotWinStatsResponse } from '../Jackpots/GetJackpotWinnersResponse';
 import { WSAPIClans } from './WSAPIClans';
 /** @group Jackpots */
 export declare class WSAPIJackpots extends WSAPIClans {
@@ -288,6 +289,81 @@ export declare class WSAPIJackpots extends WSAPIClans {
         /** Jackpot template ID (required). */
         jp_template_id?: number;
     }): Promise<JackpotWinnerHistory[]>;
+    /**
+     * Returns past winners of a specific jackpot template, paginated, together
+     * with the win statistics of that template: total number of wins, the
+     * biggest win and the most recent win. Use it for a jackpot info modal /
+     * tooltip that shows "Total wins", "Highest win" and "Latest win" next to
+     * the winners list.
+     *
+     * @remarks
+     * **Preconditions**
+     * - User must be authenticated. Visitor mode not supported.
+     * - `jp_template_id` is mandatory.
+     * - The consumer SHOULD check
+     *   `JackpotDetails.expose_winners_over_api` before calling, since
+     *   the server does not enforce it.
+     *
+     * **Statistics**
+     * - `win_stats` describes the whole jackpot template and does not depend
+     *   on `limit` / `offset`. Pass `limit: 1` when only the statistics are needed.
+     * - Only issued wins are counted — a pot that exploded but still waits for
+     *   manual approval is not included.
+     * - `highest_win` / `last_win` are `null` while the jackpot has no wins,
+     *   `total_wins` is `0` in that case.
+     * - `public_username` of `highest_win` / `last_win` is masked by the same
+     *   label setting as the winners list, and is `null` when the template
+     *   doesn't expose winners over API.
+     * - The server refreshes the statistics once per minute.
+     *
+     * **Currency caveat**
+     * All amounts (`win_stats.*.winning_amount`,
+     * `winners[].winner.winning_amount_jp_currency`) are in the jackpot's
+     * NATIVE currency, NOT the user's wallet currency.
+     *
+     * **Refresh**
+     * - The SDK caches each page separately (per `jp_template_id` +
+     *   `limit` + `offset`) for 30 seconds.
+     * - Caches clear on jackpot-win push events and on opt-in / opt-out.
+     *
+     * **Error handling**
+     * Non-zero `errCode` on control-group users or generic server errors. The
+     * SDK does NOT enumerate distinct codes — branch on `errCode === 0` and
+     * surface `errMsg` on failure.
+     *
+     * **Visitor mode**: not supported.
+     *
+     * @returns {@link TGetJackpotWinStatsResponse} —
+     * `{ winners: JackpotWinnerHistory[], win_stats: JackpotWinStats }`.
+     *
+     * @example
+     * ```ts
+     * const [jp] = await window._smartico.api.jackpotGet({ jp_template_id: 42 });
+     *
+     * if (!jp || !jp.expose_winners_over_api) {
+     *     console.log('[smartico] winners hidden by operator config — hide the stats');
+     *     return;
+     * }
+     *
+     * const { winners, win_stats } = await window._smartico.api.getJackpotWinStats({
+     *     jp_template_id: 42,
+     *     limit:          10,
+     *     offset:         0,
+     * });
+     * console.log('[smartico] total wins', win_stats.total_wins);
+     * console.log('[smartico] highest win', win_stats.highest_win?.winning_amount, jp.jp_currency);
+     * console.log('[smartico] latest win', win_stats.last_win?.public_username, win_stats.last_win?.win_date_ts);
+     * console.log('[smartico] render', winners.length, 'recent winner rows');
+     * ```
+     */
+    getJackpotWinStats({ limit, offset, jp_template_id, }: {
+        /** Page size of the winners list (default 20). */
+        limit?: number;
+        /** Pagination offset of the winners list (default 0). */
+        offset?: number;
+        /** Jackpot template ID (required). */
+        jp_template_id?: number;
+    }): Promise<TGetJackpotWinStatsResponse>;
     /**
      * Returns the casino games eligible to contribute to a specific jackpot —
      * the catalog the user must play to grow the pot. Use to power an

package/dist/WSAPI/WSAPITypes.d.ts

@@ -1083,6 +1083,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;
 }
 /**
  * InboxMarkMessageAction is the response of the five inbox mutation