Saldo ao vivo
Carregando a demo interativa…
A demo acima roda o SDK de verdade (createEnginexClient, createRealtime) com fetch: createMockFetch(...) e webSocket: createMockRealtime().webSocket de @getenginex/sdk/testing: nenhuma chamada sai para a rede. A base do saldo vem de wallet.getBalance() e cada balance_update ajusta a tela sem polling; os botões fazem o papel do gateway (publicam a mensagem com emit). Drop the connection perde um crédito de propósito: ao reconectar, o onResync recarrega o saldo por HTTP e a tela volta a bater. O cenário Topic rejected mostra o gateway respondendo unauthorized ao tópico privado (status closed e UNAUTHENTICATED). O painel Under the hood mostra o status da conexão, a URL do WebSocket com o token mascarado e a última mensagem como o handler a recebeu.
coreTopics.balance() avisa cada mudança no saldo do jogador (depósito confirmado, aposta, saque) sem polling. Exige login: o tópico é o do usuário da sessão. Os conceitos (conexão, status, onResync) estão em Realtime.
import { createRealtime, coreTopics } from '@getenginex/sdk/realtime'
const realtime = createRealtime(enginex)
async function loadBalance() {
const balance = await enginex.wallet.getBalance()
render(balance.realBalance)
}
await loadBalance() // initial balance, over HTTP
let off = realtime.subscribe(coreTopics.balance(), (update) => {
render(update.available) // already in minor units (cents), like the rest of the SDK
})
// after a drop, reload over HTTP: same descriptor as subscribe, no text comparison
const offResync = realtime.onResync(coreTopics.balance(), () => void loadBalance())
// when leaving the screen
off()
offResync()O que chega
interface BalanceUpdate {
available: number // available balance after the change
change: number // delta (negative on a debit)
changeType: string // 'credit', 'debit', 'reserve', 'release'
description?: string
updatedAt: string
}Por que reserved, bonus e total não vêm
O gateway define esses campos no balance_update, mas o produtor só preenche available, change, changeType, description e updatedAt: os demais chegam sempre 0. Expô-los levaria a mostrar um bônus ou um total zerados. Por isso o SDK os omite: para o saldo completo (real, bônus, saques em andamento), use wallet.getBalance(), na carga inicial e no onResync.
Perda de mensagem
O gateway de produção não numera as mensagens, então uma atualização perdida numa queda não é detectável. É o onResync (recarregar por HTTP) que garante a tela certa depois de reconectar. Em single-tenant o snapshot de saldo tem outro formato e o SDK o ignora; a base continua vindo do wallet.getBalance().
Trocar de usuário
O tópico é do usuário que estava logado ao assinar. No logout ou no login de outra conta, a inscrição é descartada: assine de novo para o novo usuário.
let userId = enginex.session.get().userId
enginex.session.subscribe((session) => {
if (session.userId === userId) return // a token refresh does not need a new subscription
userId = session.userId
off()
if (session.status === 'authenticated') off = realtime.subscribe(coreTopics.balance(), render)
})Testando
import { createMockRealtime } from '@getenginex/sdk/testing'
const mock = createMockRealtime()
const enginex = createEnginexClient({ /* ... */ webSocket: mock.webSocket })
// ... subscribe, wait for the connection to open
mock.emit('balance:mock-user-1', 'balance_update', {
available: 5_000,
change: 5_000,
change_type: 'credit',
updated_at: new Date().toISOString(),
})
mock.drop() // reconnects and fires onResync