Экшены

Экшен — это JSON-объект с полем actionType, который вешается на колбэки виджетов: onPressed, onTap и т.д. Кроме встроенных экшенов Stac платформа добавляет свои — для навигации по Mirea Ninja и взаимодействия с хостом.

Экшены платформы

openDeepLink

Открывает любой разрешённый экран приложения: расписание, карту, сервисы, другой мини-апп. Локация проверяется по белому списку (см. диплинки).

{ "actionType": "openDeepLink", "location": "/services/map" }

openPage

Пушит новый экран этого же мини-аппа. Для hosted-аппов страница берётся из сохранённых экранов, для remote — запрашивается у твоего сервера через прокси.

{ "actionType": "openPage", "path": "/details", "title": "Детали" }

openMiniApp

Кросс-апп навигация: открывает любой опубликованный мини-апп, опционально сразу на его внутренней странице. Так аппы могут ссылаться друг на друга и собираться в экосистемы.

{ "actionType": "openMiniApp", "slug": "study-timer", "page": "/stats" }

pop

Закрывает верхний экран: внутреннюю страницу, диалог или шторку. На стартовом экране ничего не делает (для выхода — closeMiniApp).

{ "actionType": "pop" }

reload

Перезагружает стартовый экран аппа — удобно для кнопки «Обновить» и ретраев в appErrorState.

{ "actionType": "reload" }

confirm

Диалог подтверждения с кнопками дизайн-системы, запускающий follow-up экшены.

{ "actionType": "confirm", "title": "Удалить запись?",
  "message": "Действие нельзя отменить", "isDanger": true,
  "confirmLabel": "Удалить", "cancelLabel": "Отмена",
  "onConfirm": { "actionType": "networkRequest",
                 "url": "/api/items/1", "method": "delete" },
  "onCancel": { "actionType": "none" } }

openSheet

Фирменная нижняя шторка, внутри — любое дерево виджетов. pop внутри шторки закрывает её.

{ "actionType": "openSheet", "title": "Детали",
  "child": { "type": "column", "children": [] } }

setState

Меняет реактивное локальное состояние ближайшего appStateScope — на месте, без перезагрузки экрана (скролл сохраняется). value задаёт значение, add прибавляет число, action запускает follow-up. Не сохраняется между запусками. Подробно — на странице Состояние и хранилище.

{ "actionType": "setState", "key": "count", "add": 5 }

setStorage

Пишет одно значение в персональное хранилище (своё у каждого пользователя в каждом аппе) и обновляет подстановку {{storage.<key>}}. В отличие от setState, значение переживает перезапуски, но для перерисовки нужен reload/openPage. "value": null удаляет ключ. Лимиты и детали — на странице Состояние и хранилище.

{ "actionType": "multiAction", "actions": [
  { "actionType": "setStorage", "key": "score", "value": 42 },
  { "actionType": "reload" }
]}

closeMiniApp

{ "actionType": "closeMiniApp" }

openUrl

Только https://; ссылка откроется в системном браузере.

{ "actionType": "openUrl", "url": "https://mirea.ru" }

share

{ "actionType": "share", "text": "Смотри, что нашёл!" }

copyToClipboard

{ "actionType": "copyToClipboard",
  "text": "PROMO-2026", "message": "Скопировано!" }

hapticFeedback

Стили: light, medium, heavy, selection, vibrate.

{ "actionType": "hapticFeedback", "style": "light" }

showToast

{ "actionType": "showToast", "message": "Готово!" }

Сетевые запросы: networkRequest

Встроенный экшен Stac для вызова API. В мини-аппах все запросы идут через защищённый прокси, поэтому URL должен быть относительным путём — он будет вызван на твоём зарегистрированном origin-сервере. Абсолютные URL отклоняются.

{
  "actionType": "networkRequest",
  "url": "/api/vote",
  "method": "post",
  "body": {
    "option": "pizza",
    "comment": { "actionType": "getFormValue", "id": "comment" }
  },
  "results": [
    { "statusCode": 200,
      "action": { "actionType": "showToast", "message": "Голос учтён!" } },
    { "statusCode": 500,
      "action": { "actionType": "showToast", "message": "Ошибка, попробуй позже" } }
  ]
}

Hosted-аппам сетевые запросы недоступны

У них нет origin-сервера. Нужны живые данные? Регистрируй апп как remote (свой сервер).

Встроенные экшены Stac

actionType	Что делает
navigate	Навигация Stac (push/pop). Внутри мини-аппов предпочитай openPage
showDialog / showModalBottomSheet	Диалог или шторка с виджетом из widget
showSnackBar	Снэкбар
getFormValue / validateForm	Работа с формами: значение поля по id, валидация
setValue	Записывает значение в реестр для подстановок {{key}}
multiAction	Последовательность экшенов
delay	Пауза перед следующим экшеном
none	Ничего не делает

Пример формы целиком

{
  "type": "form",
  "child": {
    "type": "column",
    "children": [
      { "type": "textFormField", "id": "comment",
        "decoration": { "hintText": "Комментарий" },
        "validatorRules": [
          { "rule": "isLength", "options": { "min": 3 },
            "message": "Минимум 3 символа" }
        ] },
      { "type": "sizedBox", "height": 12 },
      { "type": "appButton", "label": "Отправить", "expanded": true,
        "onPressed": {
          "actionType": "validateForm",
          "isValid": { "actionType": "networkRequest",
                       "url": "/api/comments", "method": "post",
                       "body": { "text": { "actionType": "getFormValue",
                                           "id": "comment" } } }
        } }
    ]
  }
}