Saldo en vivo
Cargando la demo interactiva…
La demo de arriba ejecuta el SDK real (createEnginexClient, createRealtime) con fetch: createMockFetch(...) y webSocket: createMockRealtime().webSocket de @getenginex/sdk/testing: ninguna llamada sale a la red. La base del saldo viene de wallet.getBalance() y cada balance_update ajusta la pantalla sin polling; los botones hacen el papel del gateway (publican el mensaje con emit). Drop the connection pierde un crédito a propósito: al reconectar, onResync recarga el saldo por HTTP y la pantalla vuelve a cuadrar. El escenario Topic rejected muestra al gateway respondiendo unauthorized al tópico privado (estado closed y UNAUTHENTICATED). El panel Under the hood muestra el estado de la conexión, la URL del WebSocket con el token enmascarado y el último mensaje tal como lo recibió el handler.
coreTopics.balance() avisa de cada cambio en el saldo del jugador (depósito confirmado, apuesta, retiro) sin polling. Requiere inicio de sesión: el tópico es el del usuario de la sesión. Los conceptos (conexión, estado, onResync) están en 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()Qué llega
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 qué reserved, bonus y total no llegan
El gateway define esos campos en balance_update, pero el productor solo completa available, change, changeType, description y updatedAt: los demás llegan siempre en 0. Exponerlos llevaría a mostrar un bono o un total en cero. Por eso el SDK los omite: para el saldo completo (real, bono, retiros en curso), usa wallet.getBalance(), en la carga inicial y en onResync.
Pérdida de mensajes
El gateway de producción no numera los mensajes, así que una actualización perdida en una caída no es detectable. Es onResync (recargar por HTTP) lo que garantiza la pantalla correcta tras reconectar. En single-tenant el snapshot de saldo tiene otro formato y el SDK lo ignora; la base sigue viniendo de wallet.getBalance().
Cambiar de usuario
El tópico pertenece al usuario que tenía la sesión iniciada al suscribirse. Al cerrar sesión o al iniciar sesión con otra cuenta, la suscripción se descarta: suscríbete de nuevo para el nuevo usuario.
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)
})Pruebas
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