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.

  1. Penetapan ID Unik: Kirim field id: <tx_id>:<seq> pada setiap blok event.
  2. Validasi State pada Reconnect: Saat browser mengirim header Last-Event-ID pada request rekoneksi, backend memeriksa apakah mutasi sudah committed di database.
  3. 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.