@smartico/public-api 0.0.404 → 0.0.405

package/dist/MiniGames/SAWTemplateUI.d.ts

@@ -365,8 +365,12 @@ export interface SAWTemplateUI {
     game_difficulty?: SAWGameDifficultyType;
     /**
      * URL of the operator-hosted custom mini-game, loaded inside an iframe by
-     * the widget for `SAWGameType.CustomMinigame`.  The operator is trusted, so
-     * the iframe is rendered without a sandbox.
+     * the widget for `SAWGameType.CustomMinigame`.  The operator is trusted
+     * (the URL resolves to the operator's own published Web Studio game), but
+     * the iframe is still rendered with a restrictive sandbox as defence in
+     * depth: `sandbox="allow-scripts allow-forms allow-same-origin allow-popups
+     * allow-pointer-lock"`. Top-level navigation is intentionally not allowed,
+     * so the game cannot redirect the host page.
      * Back-Office label: _"Game URL"_.
      */
     custom_game_url?: string;

package/docs/api/interfaces/SAWTemplate.md

@@ -110,6 +110,22 @@
 
 ***
 
+### earliest\_expiration\_dt?
+
+> `optional` **earliest\_expiration\_dt?**: `number`
+
+Soonest-expiring spin's expiration time for this user (epoch ms); `null`/absent when no expirable spins.
+
+***
+
+### latest\_expiration\_dt?
+
+> `optional` **latest\_expiration\_dt?**: `number`
+
+Latest-expiring spin's expiration time for this user (epoch ms); `null`/absent when no expirable spins.
+
+***
+
 ### saw\_skin\_key
 
 > **saw\_skin\_key**: `string`

package/docs/api/interfaces/TMiniGameTemplate.md

@@ -103,6 +103,27 @@ Important: this field will not be populated if “Max number of attempts a user
 
 ***
 
+### earliest\_expiration\_dt?
+
+> `optional` **earliest\_expiration\_dt?**: `number`
+
+Soonest-expiring spin's expiration time for the current user, as an epoch-ms timestamp.
+`null` when the user has no expirable spins for this template — spins only expire when the
+template defines a spin-expiration rule (Wheel of Fortune, Loot Boxes, etc.). Pair with
+`latest_expiration_dt` to render a "spins expire between X and Y" window.
+
+***
+
+### latest\_expiration\_dt?
+
+> `optional` **latest\_expiration\_dt?**: `number`
+
+Latest-expiring spin's expiration time for the current user, as an epoch-ms timestamp.
+`null` when the user has no expirable spins; equals `earliest_expiration_dt` when a single
+expiration applies.
+
+***
+
 ### over\_limit\_message
 
 > **over\_limit\_message**: `string`

package/package.json

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

package/src/MiniGames/SAWTemplateUI.ts

@@ -459,8 +459,12 @@ export interface SAWTemplateUI {
 
     /**
      * URL of the operator-hosted custom mini-game, loaded inside an iframe by
-     * the widget for `SAWGameType.CustomMinigame`.  The operator is trusted, so
-     * the iframe is rendered without a sandbox.
+     * the widget for `SAWGameType.CustomMinigame`.  The operator is trusted
+     * (the URL resolves to the operator's own published Web Studio game), but
+     * the iframe is still rendered with a restrictive sandbox as defence in
+     * depth: `sandbox="allow-scripts allow-forms allow-same-origin allow-popups
+     * allow-pointer-lock"`. Top-level navigation is intentionally not allowed,
+     * so the game cannot redirect the host page.
      * Back-Office label: _"Game URL"_.
      */
     custom_game_url?: string;