feat: add retry-safe matchmaking queue domain

2026-09-11 00:14:00 +00:00 · 2026-08-31 20:20:42 +01:00
parent b79d358db9
commit 6c0163c3ec
2 changed files with 197 additions and 0 deletions
@@ -0,0 +1,47 @@
+package domain
+
+import (
+	"errors"
+	"testing"
+	"time"
+)
+
+func TestQueueFencesOneActiveTicketPerPlayerAndReplaysCreate(t *testing.T) {
+	q := NewQueue()
+	now := time.Unix(1000, 0)
+	c := Candidate{TicketID: "ticket-a", PlayerID: "player-a", EnqueuedAt: now, PredictedRTT: map[string]float64{"EU": 20}}
+	first, err := q.Create("player-a", "ticket-a", "create-key-123456", c, now)
+	if err != nil { t.Fatal(err) }
+	replay, err := q.Create("player-a", "ticket-a", "create-key-123456", c, now.Add(time.Second))
+	if err != nil || replay != first { t.Fatalf("create replay = %+v, %v", replay, err) }
+	other := c; other.TicketID = "ticket-b"
+	if _, err := q.Create("player-a", "ticket-b", "create-key-654321", other, now); !errors.Is(err, ErrPlayerQueued) { t.Fatalf("second active ticket error = %v", err) }
+}
+
+func TestQueueHeartbeatExtendsExpiryExactlyAndRejectsStaleReplay(t *testing.T) {
+	q := NewQueue(); now := time.Unix(1000, 0)
+	c := Candidate{TicketID: "ticket-a", PlayerID: "player-a", EnqueuedAt: now}
+	if _, err := q.Create("player-a", "ticket-a", "create-key-123456", c, now); err != nil { t.Fatal(err) }
+	updated, err := q.Heartbeat("player-a", "ticket-a", "heartbeat-key-123", 0, now.Add(10*time.Second))
+	if err != nil { t.Fatal(err) }
+	if !updated.ExpiresAt.Equal(now.Add(40 * time.Second)) || updated.Revision != 1 { t.Fatalf("bad heartbeat: %+v", updated) }
+	replay, err := q.Heartbeat("player-a", "ticket-a", "heartbeat-key-123", 0, now.Add(50*time.Second))
+	if err != nil || replay != updated { t.Fatalf("heartbeat replay = %+v, %v", replay, err) }
+	if _, err := q.Heartbeat("player-a", "ticket-a", "heartbeat-key-456", 0, now.Add(20*time.Second)); !errors.Is(err, ErrStaleRevision) { t.Fatalf("stale heartbeat error = %v", err) }
+}
+
+func TestQueueExpiryReleasesOwnershipAndDoesNotReturnExpiredCandidates(t *testing.T) {
+	q := NewQueue(); now := time.Unix(1000, 0)
+	c := Candidate{TicketID: "ticket-a", PlayerID: "player-a", EnqueuedAt: now}
+	if _, err := q.Create("player-a", "ticket-a", "create-key-123456", c, now); err != nil { t.Fatal(err) }
+	if got := q.Candidates(now.Add(QueueExpiryWindow)); len(got) != 0 { t.Fatalf("expired candidate returned: %+v", got) }
+	if _, err := q.Create("player-a", "ticket-b", "create-key-654321", Candidate{TicketID: "ticket-b", PlayerID: "player-a"}, now.Add(QueueExpiryWindow)); err != nil { t.Fatalf("ownership was not released: %v", err) }
+}
+
+func TestQueueCreateIdempotencyIncludesCandidatePayload(t *testing.T) {
+	q := NewQueue(); now := time.Unix(1000, 0)
+	base := Candidate{TicketID: "ticket-a", PlayerID: "player-a", Rating: 1500, EnqueuedAt: now, PredictedRTT: map[string]float64{"EU": 20}}
+	if _, err := q.Create("player-a", "ticket-a", "create-key-123456", base, now); err != nil { t.Fatal(err) }
+	changed := base; changed.Rating = 1800
+	if _, err := q.Create("player-a", "ticket-a", "create-key-123456", changed, now); !errors.Is(err, ErrConflict) { t.Fatalf("changed create payload error = %v", err) }
+}