Eventos

A plataforma emite CustomEvents do navegador em window. Todos os eventos usam o prefixo mindtraining: e o payload está sempre disponível em event.detail.

---

mindtraining:ready

Disparado quando: o script terminou de carregar e a API global MindtrainingPlatform está disponível em window.

Quando usar: este é o hook recomendado para chamar init. Ao escutar esse evento, você evita condições de corrida entre o carregamento do script e a execução do seu código de inicialização.

event.detail

Campo	Tipo	Descrição
api	object	Referência a window.MindtrainingPlatform

window.addEventListener('mindtraining:ready', function (event) {
  // event.detail.api === window.MindtrainingPlatform
  MindtrainingPlatform.init('mindtraining', {
    viewer: { loggedIn: false },
  })
})

O script já carregou? Se o listener for registrado depois que o script já tiver sido executado, o evento não será disparado novamente. Use este padrão de guarda:

function initializeMindtraining() {
  MindtrainingPlatform.init('mindtraining', {
    viewer: { loggedIn: false },
  })
}

if (window.MindtrainingPlatform) {
  initializeMindtraining()
} else {
  window.addEventListener('mindtraining:ready', initializeMindtraining, { once: true })
}

---

mindtraining:config

Disparado quando: a configuração da plataforma é atualizada, tanto após a chamada inicial de init() quanto após qualquer updateConfig() subsequente.

Quando usar: use este evento para reagir a mudanças de configuração feitas fora da plataforma, por exemplo para sincronizar o estado da sua própria UI.

event.detail

O objeto PlatformInitConfig normalizado completo no momento da mudança.

Campo	Tipo	Descrição
viewer	object	Configurações atuais do visualizador/usuário
viewer.userId	string | null	ID do usuário ativo
viewer.loggedIn	boolean	Se o usuário está autenticado
viewer.subscribed	boolean	Se o usuário tem uma assinatura ativa
ui	object	Configurações atuais de UI
ui.mode	'web' | 'app'	Modo de renderização
ui.actions	object	Callbacks de ações registradas
access	object	Regras atuais de acesso por tipo de jogo

window.addEventListener('mindtraining:config', function (event) {
  const config = event.detail

  console.log('Usuário autenticado:', config.viewer?.loggedIn)
  console.log('Usuário assinante:', config.viewer?.subscribed)
  console.log('Regras de acesso ativas:', config.access?.games)
})

---

Eventos de jogo e navegação

Os eventos a seguir são emitidos durante a jogabilidade e a navegação. Use-os para analytics, tracking, integrações do host e observabilidade.

---

mindtraining:game:loaded

Disparado quando: uma sessão ou tela de jogo está pronta para interação.

Quando usar: use este evento para acompanhar pageviews internas do jogo, medir quais jogos realmente carregam ou acionar lógica do host com base no tipo de jogo.

event.detail

Campo	Tipo	Descrição
gameType	string	Tipo de jogo (ex. crossword, sudoku)
gameId	string	Identificador único do jogo
variant	string	Variante do jogo (ex. default, mini)
route	string	Rota interna
source	string	Origem do jogo (ex. today, archive)

window.addEventListener('mindtraining:game:loaded', function (event) {
  Analytics.track('mindtraining_game_loaded', event.detail)
})

---

mindtraining:game:playing

Disparado quando: o usuário começa a interagir de verdade com o jogo (por exemplo, primeiro movimento ou primeira entrada).

Quando usar: use este evento para diferenciar um jogo carregado de um jogo realmente jogado, medir ativação ou acompanhar engajamento.

event.detail

Campo	Tipo	Descrição
gameType	string	Tipo de jogo
gameId	string	Identificador único do jogo
variant	string	Variante do jogo
startedAt	string	Timestamp ISO 8601 do início

window.addEventListener('mindtraining:game:playing', function (event) {
  Analytics.track('mindtraining_game_playing', event.detail)
})

---

mindtraining:game:completed

Disparado quando: o usuário conclui um jogo com sucesso.

Quando usar: use este evento para funis completos, analytics de dificuldade ou ranking/gamificação do lado host.

event.detail

Campo	Tipo	Descrição
gameType	string	Tipo de jogo
gameId	string	Identificador único do jogo
variant	string	Variante do jogo
completedAt	string	Timestamp ISO 8601 de término
durationMs	number	Duração da sessão em milissegundos
score	number	Pontuação final (quando aplicável)

window.addEventListener('mindtraining:game:completed', function (event) {
  Analytics.track('mindtraining_game_completed', event.detail)
})

---

mindtraining:game:abandoned

Disparado quando: o usuário abandona uma sessão ativa sem concluir o jogo.

Quando usar: use este evento para detectar atrito, medir abandono por jogo ou variante, ou melhorar fluxos de retenção.

event.detail

Campo	Tipo	Descrição
gameType	string	Tipo de jogo
gameId	string	Identificador único do jogo
variant	string	Variante do jogo
durationMs	number	Tempo gasto antes do abandono
progress	number	Progresso (0–1) no momento do abandono

window.addEventListener('mindtraining:game:abandoned', function (event) {
  Analytics.track('mindtraining_game_abandoned', event.detail)
})

---

mindtraining:game:state:saved

Disparado quando: o estado do jogo é persistido (por exemplo, para a funcionalidade de “continuar jogando”).

Quando usar: use este evento para acompanhar retenção, fluxos de continuação ou verificar se o estado salvo está funcionando.

event.detail

window.addEventListener('mindtraining:game:state:saved', function (event) {
  Analytics.track('mindtraining_game_state_saved', event.detail)
})

---

mindtraining:access:blocked

Disparado quando: a plataforma detecta que uma superfície (jogo de hoje, arquivo etc.) está bloqueada para o usuário.

Quando usar: use este evento para acionar paywalls contextuais, medir demanda não atendida ou personalizar mensagens do host com base no motivo do bloqueio.

event.detail

window.addEventListener('mindtraining:access:blocked', function (event) {
  Analytics.track('mindtraining_access_blocked', event.detail)
  if (event.detail.blockedReason === 'subscription_required') {
    Paywall.show({ context: 'game_archive' })
  }
})

---

mindtraining:route:changed

Disparado quando: a rota interna da plataforma muda (por exemplo, navegação dentro da SPA).

Quando usar: use este evento para pageviews virtuais ou para sincronizar analytics com a navegação interna da plataforma.

event.detail

window.addEventListener('mindtraining:route:changed', function (event) {
  Analytics.track('mindtraining_route_changed', event.detail)
})

---

mindtraining:pageview

Disparado quando: a plataforma registra uma visualização navegável relevante para analytics.

Quando usar: use este evento para pageview tracking, relatórios por seção e tipo de jogo ou atribuição da navegação interna da SPA.

event.detail