Integrasi Server-Sent Events (SSE) dengan Datastar memindahkan orkestrasi render ke backend via streaming potongan DOM dan reaktifitas signal. Masalah muncul ketika beberapa request paralel memicu mutasi state yang selesai tanpa urutan deterministik (out-of-order execution), atau ketika koneksi stream terputus di tengah transmisi. Tanpa kontrak pengiriman event yang ketat, tampilan UI client dapat terdistorsi ke state yang usang (stale state).
Anatomi Masalah: Out-of-Order Execution dan Broken State
Datastar memproses payload backend menggunakan format SSE standar dengan event spesifik seperti datastar-merge-fragments untuk manipulasi DOM dan datastar-merge-signals untuk update signal reaktif. Ketika user memicu dua aksi secara cepat—misalnya memfilter tabel lalu memperbarui satu baris—dua koneksi HTTP SSE berjalan bersamaan.
Jika response request kedua tiba lebih awal dari request pertama karena latensi query database, browser akan menimpa DOM baru dengan hasil query lama. Untuk mencegahnya, backend harus menerapkan kontrol versi state atau monotonic counter yang divalidasi sebelum DOM di-patch.
Konfigurasi Proxy Buffering
SSE mengandalkan transmisi data seketika tanpa delay. Reverse proxy seperti Nginx secara default menahan buffer respons sebelum dikirim ke client. Jika tidak dinonaktifkan, event Datastar akan menumpuk di buffer dan dikirim sekaligus, merusak urutan transisi visual dan feedback latensi rendah.
# Konfigurasi Nginx untuk endpoint SSE Datastar
location /stream/ {
proxy_pass http://backend_upstream;
proxy_http_version 1.1;
proxy_set_header Connection '';
# Wajib: Matikan buffering proxy
proxy_buffering off;
proxy_cache off;
chunked_transfer_encoding on;
# Mencegah timeout koneksi aktif berdurasi panjang
proxy_read_timeout 24h;
}Header respons dari aplikasi backend juga harus memuat X-Accel-Buffering: no dan Content-Type: text/event-stream untuk memastikan infrastruktur cloud (seperti AWS ALB atau Cloudflare) tidak menahan chunk HTTP.
Implementasi Backend Deterministik (Go)
Contoh backend Go berikut menunjukkan pemancaran event Datastar dengan nomor sekuensial (version lock). Signal versi dikirim sebelum fragment DOM untuk memastikan client mengabaikan rendering jika versi payload lebih rendah dari versi yang sudah aktif di frontend.
package main
import (
"fmt"
"net/http"
"sync/atomic"
"time"
)
var globalVersion atomic.Uint64
func sseHandler(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "text/event-stream")
w.Header().Set("Cache-Control", "no-cache")
w.Header().Set("Connection", "keep-alive")
w.Header().Set("X-Accel-Buffering", "no")
flusher, ok := w.(http.Flusher)
if !ok {
http.Error(w, "Streaming unsupported", http.StatusInternalServerError)
return
}
currentVersion := globalVersion.Add(1)
// 1. Emit signal untuk sinkronisasi state versi
fmt.Fprintf(w, "event: datastar-merge-signals\n")
fmt.Fprintf(w, "data: signals {\"mutationVersion\": %d}\n\n", currentVersion)
flusher.Flush()
// Simulasi pemrosesan backend non-blocking
time.Sleep(50 * time.Millisecond)
// 2. Emit fragment DOM dengan selector target spesifik
fmt.Fprintf(w, "event: datastar-merge-fragments\n")
fmt.Fprintf(w, "data: selector #task-status\n")
fmt.Fprintf(w, "data: merge morph\n")
fmt.Fprintf(w, "data: fragments <div id=\"task-status\" data-version=\"%d\">Status: Selesai (v%d)</div>\n\n", currentVersion, currentVersion)
flusher.Flush()
}Pendekatan ini memisahkan sinkronisasi metadata dari payload view. Datastar akan memperbarui store internal terlebih dahulu, lalu mengaplikasikan DOM diffing via engine morphing internalnya.
Pola Idempotent Retry saat Sambungan Terputus
Koneksi SSE dapat putus sewaktu-waktu akibat degradasi jaringan. Protokol SSE menyediakan mekanisme rekoneksi bawaan menggunakan header Last-Event-ID. Backend harus memproses ID ini untuk mencegah eksekusi ulang aksi mutatif yang non-idempoten.
- Penetapan ID Unik: Kirim field
id: <tx_id>:<seq>pada setiap blok event. - Validasi State pada Reconnect: Saat browser mengirim header
Last-Event-IDpada request rekoneksi, backend memeriksa apakah mutasi sudah committed di database. - Replay atau Re-sync: Jika mutasi sudah selesai, jangan ulangi side-effect (misal: mengirim email atau insert database). Cukup pancarkan snapshot HTML terakhir agar view client kembali konsisten.
Trade-off dan Limitasi
Meskipun arsitektur SSE dengan Datastar menyederhanakan frontend tanpa build step yang kompleks, terdapat batasan yang perlu diperhitungkan:
- Batas Koneksi HTTP/1.1: Browser membatasi maksimal 6 koneksi simultan per domain jika tidak menggunakan HTTP/2. Gunakan HTTP/2 multiplexing agar koneksi stream tidak memblokir resource statis lain.
- Tekanan Memori Server: Koneksi SSE bersifat persistent. Setiap koneksi menahan thread/goroutine dan alokasi buffer HTTP response di server. Pastikan timeout idle diatur secara ketat.
- Kompleksitas Konsistensi: Penggunaan morphing fragment secara paralel tanpa atomic signal versioning akan menyebabkan inkonsistensi layout UI yang sulit di-reproduce pada automated testing.
Komentar
0 komentar
Masuk ke akun kamu untuk ikut berkomentar.
Belum ada komentar
Jadilah yang pertama ikut berdiskusi!