En tiempo real
WebSocket, SSE y NATS autonegociados. Presencia, repetición, pedido garantizado, contrapresión. 1 millón de conexiones por POP, distribución en abanico por debajo de 15 ms p99 entre regiones.
Sincronización, presencia, transmisión#
El servicio aura-realtime transmite tres tipos de eventos: CDC Postgres (INSERT/UPDATE/DELETE filtrado por RLS), Presencia (que está en línea) y Broadcast (eventos personalizados independientes de la base de datos). Todos pasan por el mismo SDK a través de .channel().
Un canal se identifica con un nombre arbitrario (sensors:live, doc:42, room:abc). Los mensajes se ordenan por canal, se deduplican mediante message_id y se garantizan exactamente una vez dentro del mismo canal.
Las suscripciones heredan las políticas RLS de la base de datos. Un cliente solo puede suscribirse a los cambios que puede leer: el filtro se evalúa en el lado del servidor en WAL, no en el lado del cliente.
Una conexión, N canales#
El SDK mantiene una única conexión TCP multiplexada entre el cliente y el POP más cercano. Puedes abrir 100 canales sin abrir 100 enchufes.
┌──────────────────┐
Client (WS) ────▶ │ aura-realtime │
│ ─ CDC listener │
│ ─ Presence CRDT │
│ ─ Broadcast hub │
└────────┬─────────┘
│ NATS JetStream
┌────────────────────┴────────────────────┐
▼ ▼ ▼
aura-db WAL Presence state autres POPs
Los eventos se dividen mediante hash consistente. Un canal siempre vive en el mismo POP, pero se garantiza su replicación a otros POP en menos de 15ms p99.
Seis habilidades nativas#
- Transporte de alto rendimiento. Conexión WebSocket nativa impulsada por NATS entre servicios.
- Postgres CDC. Cambios de WAL filtrados en el lado del servidor, RLS aplicados al flujo.
- API de presencia. Quién está en línea, estado arbitrario, unirse/abandonar eventos.
- Multiplexación. Varios canales comparten una conexión WebSocket.
- Entrega de eventos. Entrega en vivo con el mejor esfuerzo y reconexión automática del cliente.
- Cursores colaborativos. Primitivo nativo, acelerador adaptativo 60 FPS, interpolación del cliente.
Cuatro patrones esenciales#
const channel = aura.channel('db:public.devices')
.on('postgres_changes', {
event: '*',
schema: 'public',
table: 'devices',
filter: `tenant_id=eq.${tid}`,
}, ({ new: row }) => render(row))
.subscribe()
Llame siempre a channel.unsubscribe() al desmontar. En React, haga esto en la limpieza useEffect; el gancho useChannel de arriba lo hace por usted.
Lo que prometemos, lo que no prometemos#
✓ GARANTIZADO
- Ordenar por canal
- Exactamente una vez por
message_iden un canal - Fanout p99 <15 ms entre regiones
- Reconexión automática con repetición de los 60
- Contrapresión explícita (política de caída configurable)
✗ NO GARANTIZADO
- Pedidos multicanal
- Exactamente una vez entre canales (al menos una vez)
- Latencia sub-ms (< 15 ms p99 es nuestro piso)
- Reproduzca más allá de los 60 (use un registro Postgres)