fix(server): repair the initial-connect outbox envelope and unblock dispatch

ApplyInitialConnectPlan wrote a payload of {match_id,state,action},
omitting event, revision, resource_id, occurred_at and player_ids --
every field deliverStateOutboxEvent requires. Delivery rejected the row,
dispatch returned on the first error so it was never acknowledged, and
because reads are ordered oldest-first it was retried ahead of every
later state_changed event on every 100ms poll. One initial-connect
transition therefore blocked lifecycle delivery for all matches, not
just its own.

Two independent fixes, since either alone leaves the system fragile:

Build envelopes through one validating helper (MarshalOutboxEnvelope)
and convert all five writers to it. A writer that omits a required
field now fails its own transaction instead of committing a row that
can only ever poison the queue. The helper takes revision as int64 so
the -1 "nothing matched" sentinel some CTEs return surfaces as an error
rather than wrapping to a huge uint64.

Make dispatch resilient regardless: a delivery failure is now counted
against that row and the batch continues, with the row dead-lettered
after MaxOutboxDeliveryAttempts so a poison event degrades to one lost
notification instead of a stalled queue. Ordering within an aggregate
is still honoured -- later events of a failed match are deferred, so no
client observes that match's newer state before its older state. An ack
failure still stops the batch, being a database rather than a payload
problem.

Initial-connect events now address every participant, not just the
connected ones: a no-show needs to learn their ticket was failed and a
penalty applied.
This commit is contained in:
Josh Creek
2026-09-05 10:14:43 +01:00
parent 2c648514ba
commit 1dd05c75f1
12 changed files with 379 additions and 31 deletions
+4 -5
View File
@@ -3,7 +3,6 @@ package store
import (
"context"
"database/sql"
"encoding/json"
"fmt"
"time"
@@ -160,10 +159,10 @@ func ApplyLiveAbandonments(ctx context.Context, db *sql.DB, matchID string, now
if len(targets) == 0 {
return fmt.Errorf("%w: live match has no active event targets", domain.ErrConflict)
}
payload, err := json.Marshal(map[string]any{
"event": "state_changed", "revision": revision, "resource_id": matchID,
"occurred_at": now, "state": domain.Live, "match_id": matchID,
"player_ids": targets, "abandoned_player_ids": abandonmentIDs(planned),
payload, err := MarshalOutboxEnvelope(OutboxEnvelope{
Event: "state_changed", ResourceID: matchID, Revision: int64(revision),
OccurredAt: now, State: string(domain.Live), MatchID: matchID, PlayerIDs: targets,
Extra: map[string]any{"abandoned_player_ids": abandonmentIDs(planned)},
})
if err != nil {
return err