@smartico/public-api 0.0.421 → 0.0.424

package/README.md

@@ -180,6 +180,17 @@ import { SmarticoAPI, WSAPI } from '@smartico/public-api';
 
 // publicApiUrl is resolved automatically by SmarticoAPI from your label key
 const messageSender = async (message: any, publicApiUrl?: string): Promise<any> => {
+
+    // if label has user hash protection enabled, calculate hash and add in the message, e.g.
+    const hashValidityTimestampMs = ~~(+new Date() / 1000) * 1000 + 24 * 3600 * 1000;
+    const userExtId = message.user_ext_id;
+    const saltKey = 'your_secret_salt_key_setup_on_smartico_side';
+    const hashValue = md5((userExtId + ':' + saltKey + ':' + hashValidityTimestampMs).toLowerCase()) +
+		':' +
+		hashValidityTimestampMs;
+
+	message.hash = hashValue;
+
     const res = await fetch(publicApiUrl, {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
@@ -229,6 +240,9 @@ You can make HTTP calls to the Smartico public endpoint to interact with user da
 
 This example checks whether a user belongs to specific segments. It corresponds to `checkSegmentListMatch` (cid: 161 / response cid: 162) described in [Native Protocol](docs/native/PROTOCOL.md).
 
+Note: in case your label has user hash protection enabled, you need to calculate it using secret salt key and pass it in the data under "hash" value.
+Check for more details here - https://help.smartico.ai/welcome/technical-guides/front-end-integration/extended-integration#protecting-user-identification-on-the-public-front-end
+
 **Request:**
 
 ```bash

package/dist/MiniGames/SAWTemplateUI.d.ts

@@ -374,6 +374,22 @@ export interface SAWTemplateUI {
      * Back-Office label: _"Game URL"_.
      */
     custom_game_url?: string;
+    /**
+     * Whether this template is played as a custom mini-game.
+     *
+     * A template of any regular game type (wheel, scratch card, treasure hunt,
+     * …) can be switched over to a custom game while keeping its own type,
+     * prizes and buy-in settings — only the way it is played changes: the
+     * widget loads `custom_game_url` in an iframe instead of rendering the
+     * built-in game.  `saw_game_type_id` still reports the original type, so
+     * treat this flag — not the type — as the answer to "is this played as a
+     * custom game", together with `SAWGameType.CustomMinigame`, which is always
+     * played that way.
+     *
+     * When `false` or omitted, the template is played as its own game type.
+     * Back-Office label: _"Use Custom Game"_.
+     */
+    use_custom?: boolean;
     /**
      * Minutes for the Voyager seed window.
      * The seed window is the range of seeds that can be used to generate the map.

package/dist/WSAPI/WSAPITypes.d.ts

@@ -205,6 +205,8 @@ export interface TMiniGameTemplate {
     activeTillDate?: number;
     /** Number of steps to complete the game and collect the prize (step games — Voyager / Treasure Hunt) */
     steps_to_finish_game?: number;
+    /** Minimum number of path steps / collectible prizes a session must include before the game can finish (step games — Voyager / Treasure Hunt). `>= 1` and `<= steps_to_finish_game`; when omitted, no minimum is enforced */
+    min_steps_to_finish_game?: number;
     /** ID of the operator-defined custom section (widget menu grouping) the mini-game is assigned to */
     custom_section_id?: number;
     /** Full raw UI definition of the mini-game (skin, colors, per-game visual settings) — see {@link SAWTemplateUI}. The commonly needed values are already lifted onto this template object */

package/dist/index.js

@@ -516,6 +516,7 @@ var SAWTemplatesTransform = function SAWTemplatesTransform(items) {
       earliest_expiration_dt: r.earliest_expiration_dt,
       latest_expiration_dt: r.latest_expiration_dt,
       steps_to_finish_game: r.saw_template_ui_definition.steps_to_finish_game,
+      min_steps_to_finish_game: r.saw_template_ui_definition.min_steps_to_finish_game,
       custom_section_id: r.saw_template_ui_definition.custom_section_id,
       saw_template_ui_definition: r.saw_template_ui_definition
     }, r.saw_game_type_id === exports.SAWGameType.LootboxCalendarDays || r.saw_game_type_id === exports.SAWGameType.LootboxWeekdays ? {