In tempo reale
WebSocket autonegoziato, SSE e NATS. Presenza, replay, ordine garantito, contropressione. 1 milione di connessioni tramite POP, fanout inferiore a 15 ms p99 tra regioni.
Sincronizzazione, presenza, trasmissione#
Il servizio aura-realtime trasmette tre tipi di eventi: CDC Postgres (INSERT/UPDATE/DELETE filtrato da RLS), Presenza (che è online) e Broadcast (eventi personalizzati indipendente dal database). Tutti passano attraverso lo stesso SDK tramite .channel().
Un canale è identificato da un nome arbitrario (sensors:live, doc:42, room:abc). I messaggi vengono ordinati per canale, deduplicati da message_id e garantiti esattamente una volta all'interno dello stesso canale.
Gli abbonamenti ereditano le policy RLS dal database. Un client può sottoscrivere solo le modifiche che può leggere: il filtro viene valutato lato server sul WAL, non lato client.
Una connessione, N canali#
L'SDK mantiene una singola connessione TCP multiplex tra il client e il POP più vicino. Puoi aprire 100 canali senza aprire 100 socket.
┌──────────────────┐
Client (WS) ────▶ │ aura-realtime │
│ ─ CDC listener │
│ ─ Presence CRDT │
│ ─ Broadcast hub │
└────────┬─────────┘
│ NATS JetStream
┌────────────────────┴────────────────────┐
▼ ▼ ▼
aura-db WAL Presence state autres POPs
Gli eventi vengono partizionati tramite hashing coerente. Un canale risiede sempre sullo stesso POP, ma la sua replica su altri POP è garantita in meno di 15ms p99.
Sei abilità native#
- Trasporto ad alto rendimento. Connessione WebSocket nativa alimentata da interservizi NATS.
- Postgres CDC. Modifiche WAL filtrate sul lato server, RLS applicate al flusso.
- API di presenza. Chi è online, stato arbitrario, eventi di partecipazione/uscita.
- Multiplexing. Diversi canali condividono una connessione WebSocket.
- Consegna evento. Consegna in tempo reale con la massima comodità con riconnessione automatica del client.
- Cursori collaborativi. Primitivo nativo, acceleratore adattivo 60 FPS, interpolazione client.
Quattro modelli essenziali#
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()
Chiama sempre channel.unsubscribe() durante lo smontaggio. In React, esegui questa operazione nella pulizia useEffect: l'hook useChannel sopra lo fa per te.
Ciò che promettiamo, ciò che non promettiamo#
✓ GARANTITO
- Ordinazione per canale
- Esattamente una volta per
message_idin un canale - Fanout p99 < 15ms tra regioni
- Riconnessione automatica con riproduzione anni '60
- Contropressione esplicita (politica di caduta configurabile)
✗ NON GARANTITO
- Ordinamento multicanale
- Cross-channel esattamente una volta (almeno una volta)
- Latenza sub-ms (< 15ms p99 è il nostro limite)
- Riproduci oltre i 60 secondi (usa un registro Postgres)