Контекст и типы

MiniAppContext

Полный контекст, который хост передаёт MiniApp при handshake. Возвращается из app.init() и доступен через app.getContext().

interface MiniAppContext {
  user: MiniAppUser
  school: Record<string, unknown>
  theme: MiniAppTheme
  platform: Platform
  config: MiniAppConfig
}

MiniAppUser

number

required

Внутренний идентификатор пользователя в Exode.

string | null

Публичный UUID пользователя.

string | null

Имя пользователя.

string | null

Фамилия пользователя.

object | null

Аватар в трёх размерах: small, medium, maximum.

string | null

Email пользователя.

string | null

Телефон пользователя.

string

required

Роль: Student, Tutor, Parent и др.

string | null

Язык интерфейса: en, ru, uz, qa.

MiniAppTheme

interface MiniAppTheme {
  scheme: 'light' | 'dark'
}

MiniAppConfig

interface MiniAppConfig {
  isDesktop: boolean
  isMobile: boolean
  language: string
}

Platform

type Platform = 'web' | 'native'

native означает, что Exode запущен внутри нативной оболочки (например, iOS/Android-приложение). В остальных случаях web.

school

Поле school — открытый объект Record<string, unknown> со всеми данными школы (название, домен, конфиг и т. п.). Структура зависит от конкретной школы; уточняйте нужные поля у хост-приложения.

События хоста (MiniAppEventMap)

Отправляются хостом при изменении данных. MiniApp подписывается через app.on(event, handler).

Событие	Payload	Когда срабатывает
`theme:changed`	`MiniAppTheme`	Пользователь переключил тему
`user:updated`	`MiniAppUser`	Изменился профиль или сменился аккаунт
`school:updated`	`Record<string, unknown>`	Изменились данные школы
`config:updated`	`MiniAppConfig`	Смена размера окна, языка
`route:changed`	`{ path, params }`	Хост изменил маршрут
`context:updated`	`Partial<MiniAppContext>`	Любое частичное обновление контекста
`visibility:changed`	`{ visible: boolean }`	Iframe стал видимым/невидимым

Событие context:updated применяется к внутреннему кэшу автоматически — app.getContext() всегда вернёт актуальные данные.

Команды MiniApp → хост (MiniAppCommandMap)

Вызываются через namespaces app.route и app.ui.

Команда	Payload	Метод SDK
`navigate`	`{ path, params? }`	`app.route.navigate()`
`navigate:back`	—	`app.route.back()`
`showSnackbar`	`{ message, type? }`	`app.ui.showSnackbar()`
`setTabbarVisible`	`{ visible }`	`app.ui.setTabbarVisible()`
`setHeaderVisible`	`{ visible }`	`app.ui.setHeaderVisible()`
`close`	—	`app.ui.close()`

BridgeMessage

Низкоуровневый формат сообщений postMessage. Обычно разработчику не нужен, но полезен при отладке.

interface BridgeMessage<T = unknown> {
  type: string
  requestId?: string
  payload?: T
  source: 'exode-host' | 'exode-miniapp'
}

Не отправляйте postMessage вручную. Все валидные взаимодействия идут через методы ExodeMiniApp — только они гарантируют корректный handshake, requestId и валидацию origin.

Импорт типов

import type {
  MiniAppContext,
  MiniAppUser,
  MiniAppTheme,
  MiniAppConfig,
  MiniAppEventMap,
  MiniAppCommandMap,
  BridgeMessage,
  Platform,
} from '@exode-team/sdk/miniapp'

Обновлено: 2026-04-20 17:08 UTC

Начало работы

API Client

MiniApp

Контекст и типы

MiniAppContext

MiniAppUser

MiniAppTheme

MiniAppConfig

Platform

school

События хоста (MiniAppEventMap)

Команды MiniApp → хост (MiniAppCommandMap)

BridgeMessage

Импорт типов

​MiniAppContext

​MiniAppUser

​MiniAppTheme

​MiniAppConfig

​Platform

​school

​События хоста (MiniAppEventMap)

​Команды MiniApp → хост (MiniAppCommandMap)

​BridgeMessage

​Импорт типов

MiniAppContext

MiniAppUser

MiniAppTheme

MiniAppConfig

Platform

school

События хоста (MiniAppEventMap)

Команды MiniApp → хост (MiniAppCommandMap)

BridgeMessage

Импорт типов