Tempo real
WebSocket, SSE e NATS autonegociados. Presença, repetição, ordem garantida, contrapressão. Conexões de 1M por POP, fanout sub-15ms p99 entre regiões.
Sincronização, presença, transmissão#
O serviço aura-realtime transmite três tipos de eventos: CDC Postgres (INSERT/UPDATE/DELETE filtrado por RLS), Presence (que está online) e Broadcast (eventos personalizados independentes do banco de dados). Todos passam pelo mesmo SDK via .channel().
Um canal é identificado por um nome arbitrário (sensors:live, doc:42, room:abc). As mensagens são ordenadas por canal, desduplicadas por message_id e garantidas exatamente uma vez no mesmo canal.
As assinaturas herdam as políticas RLS do banco de dados. Um cliente só pode assinar alterações que pode ler – o filtro é avaliado no lado do servidor no WAL, não no lado do cliente.
Uma conexão, N canais#
O SDK mantém uma única conexão TCP multiplexada entre o cliente e o POP mais próximo. Você pode abrir 100 canais sem abrir 100 soquetes.
┌──────────────────┐
Client (WS) ────▶ │ aura-realtime │
│ ─ CDC listener │
│ ─ Presence CRDT │
│ ─ Broadcast hub │
└────────┬─────────┘
│ NATS JetStream
┌────────────────────┴────────────────────┐
▼ ▼ ▼
aura-db WAL Presence state autres POPs
Os eventos são particionados por hashing consistente. Um canal vive sempre no mesmo POP, mas a sua replicação para outros POPs é garantida em menos de 15ms p99.
Seis habilidades nativas#
- Transporte de alto rendimento. Conexão WebSocket nativa alimentada por interserviços NATS.
- Postgres CDC. alterações WAL filtradas no lado do servidor, RLS aplicadas ao fluxo.
- API de presença. Quem está online, estado arbitrário, entrar/sair de eventos.
- Multiplexação. Vários canais compartilham uma conexão WebSocket.
- Entrega de eventos. Entrega ao vivo de melhor esforço com reconexão automática do cliente.
- Cursores colaborativos. Primitivo nativo, acelerador adaptativo 60 FPS, interpolação do cliente.
Quatro padrões essenciais#
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()
Sempre chame channel.unsubscribe() ao desmontar. No React, faça isso na limpeza useEffect — o gancho useChannel acima faz isso para você.
O que prometemos, o que não prometemos#
✓ GARANTIDO
- Ordenação por canal
- Exatamente uma vez por
message_idem um canal - Fanout p99 <15ms entre regiões
- Reconexão automática com replay dos anos 60
- Contrapressão explícita (política de queda configurável)
✗ NÃO GARANTIDO
- Ordenação entre canais
- Exatamente uma vez entre canais (pelo menos uma vez)
- Latência sub-ms (<15ms p99 é o nosso piso)
- Replay além dos 60s (use um log Postgres)