GraphQL Subscriptions + WebSocket: Real-Time Communication dengan Efficient Connection Management

Arsitektur Real-Time GraphQL: Subscription & Koneksi Skala Besar

Menghadirkan fitur interaktif real-time seperti notifikasi live, pembaruan status kurir, atau chat kolaboratif membutuhkan koneksi dua arah yang efisien. GraphQL Subscriptions memanfaatkan protokol WebSocket (atau Server-Sent Events) untuk mendorong data ke klien seketika saat event terjadi.

1. Setup GraphQL Subscription dengan graphql-ws

Hindari library lawas subscriptions-transport-ws yang sudah deprecated. Gunakan pustaka modern graphql-ws yang mematuhi standar WebSocket terbaru:

import { createServer } from 'http';
import { WebSocketServer } from 'ws';
import { useServer } from 'graphql-ws/lib/use/ws';
import { schema } from './schema';

const server = createServer();
const wsServer = new WebSocketServer({ server, path: '/graphql' });

useServer({ schema }, wsServer);
server.listen(4000);

2. Manajemen Koneksi Multi-Node Menggunakan Redis PubSub

Ketika backend diskalakan menjadi beberapa instance di balik load balancer, pengguna yang terhubung di server A tidak akan menerima event yang dipicu di server B tanpa penghubung terpusat. Gunakan Redis Pub/Sub sebagai message broker untuk menyinkronkan event antar node server secara instan.