app.realtime() abre un stream de Server-Sent Events y devuelve el Response sin procesar. El SDK no parsea los frames SSE por ti — te entrega el stream para que lo conectes a tu propio bucle de eventos.
Límites de conexión
- Cada conexión dura hasta 10 minutos (su TTL). El servidor realiza una reconexión interna transparente al alcanzar el TTL, pero el cliente igualmente debe reconectarse cuando el stream termina.
- Una misma cuenta puede mantener como máximo 5 conexiones simultáneas abiertas, con un límite adicional por aplicación. Superar cualquiera de los dos límites falla con
code: "REALTIME_MAX_CONNECTIONS".
app.realtime() devuelve el Response sin procesar; su body es el stream SSE.
El stream emite dos tipos de frames:
event: system — mensajes del ciclo de vida de la conexión como REALTIME_CONNECTING, REALTIME_TIMEOUT, etc.
event: message — la carga útil JSON de la aplicación
Consumir el stream
Cada invocación de app.realtime() devuelve un Response nuevo. Para mantenerte conectado más allá del tiempo de espera de 10 minutos del servidor, vuelve a conectar cuando el stream finalice.