@smartico/public-api 0.0.433 → 0.0.434

package/dist/index.modern.mjs

@@ -943,7 +943,9 @@ const InboxMessageBodyTransform = item => {
     icon: item.image,
     title: item.title,
     preview_body: item.body,
-    custom_data: IntUtils.JsonOrText(item == null ? void 0 : item.custom_data)
+    custom_data: IntUtils.JsonOrText(item == null ? void 0 : item.custom_data),
+    show_preview: item.show_preview,
+    show_duration_sec: item.show_duration_sec
   };
   if (item.action === 'dp:inbox') {
     if (item.additional_buttons && item.additional_buttons.length) {
@@ -9225,6 +9227,16 @@ 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).
@@ -9250,6 +9262,12 @@ 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');
+   * }
    * ```
    */
   async getInboxMessageBody(messageGuid) {