Esta versión (v0.7) todavía no se publicó en npm.
Ir al contenido

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.

ts
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 ​

ts
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.

ts
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 ​

ts
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