Realtime
Zelfonderhandelde WebSocket, SSE en NATS. Aanwezigheid, herhaling, gegarandeerde bestelling, tegendruk. 1M-verbindingen via POP, fanout sub-15ms p99 tussen regio's.
Synchronisatie, aanwezigheid, uitzending#
De aura-realtime-service zendt drie soorten gebeurtenissen uit: CDC Postgres (INSERT/UPDATE/DELETE gefilterd door RLS), Aanwezigheid (die online is) en Uitzending (aangepaste gebeurtenissen onafhankelijk van de database). Ze gaan allemaal via dezelfde SDK via .channel().
Een kanaal wordt geïdentificeerd door een willekeurige naam (sensors:live, doc:42, room:abc). Berichten worden geordend per kanaal, gededupliceerd door message_id en gegarandeerd precies één keer binnen hetzelfde kanaal.
Abonnementen nemen het beleid RLS over van de database. Een client kan zich alleen abonneren op wijzigingen die hij kan lezen; het filter wordt aan de serverzijde op de WAL geëvalueerd, niet aan de clientzijde.
Eén verbinding, N kanalen#
De SDK onderhoudt een enkele gemultiplexte TCP-verbinding tussen de client en de dichtstbijzijnde POP. Je kunt 100 kanalen openen zonder 100 stopcontacten te openen.
┌──────────────────┐
Client (WS) ────▶ │ aura-realtime │
│ ─ CDC listener │
│ ─ Presence CRDT │
│ ─ Broadcast hub │
└────────┬─────────┘
│ NATS JetStream
┌────────────────────┴────────────────────┐
▼ ▼ ▼
aura-db WAL Presence state autres POPs
Gebeurtenissen worden gepartitioneerd door consistente hashing. Een kanaal leeft altijd op dezelfde POP, maar de replicatie ervan naar andere POP's is gegarandeerd in minder dan 15 ms p99.
Zes inheemse vaardigheden#
- Transport met hoge doorvoer. Native WebSocket-verbinding mogelijk gemaakt door inter-service NATS.
- Postgres CDC. WAL-wijzigingen gefilterd aan de serverzijde, RLS toegepast op de stroom.
- Aanwezigheids-API. Wie is online, willekeurige status, deelname aan/verlaat evenementen.
- Multiplexen. Verschillende kanalen delen één WebSocket-verbinding.
- Levering van evenement. Beste live-levering met automatische herverbinding met de klant.
- Samenwerkende cursors. Native primitief, adaptief gaspedaal 60 FPS, clientinterpolatie.
Vier essentiële patronen#
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()
Bel altijd channel.unsubscribe() bij het ontkoppelen. In React doe je dit tijdens het opschonen van useEffect - de useChannel hook hierboven doet het voor je.
Wat we beloven, wat we niet beloven#
✓ GEGARANDEERD
- Bestellen per kanaal
- Precies één keer per
message_idin een kanaal - Fanout p99 < 15 ms cross-regio
- Automatische herverbinding met herhaling uit de jaren 60
- Expliciete tegendruk (configureerbaar drop-beleid)
✗ NIET GEGARANDEERD
- Cross-channel bestellen
- Precies één keer cross-channel (minstens één keer)
- Latentie onder ms (< 15 ms p99 is onze minimum)
- Herhaling na 60 seconden (gebruik een Postgres log)