feat(multiplayer): dispatch completed result events

server/api/outbox.go

@@ -38,6 +38,32 @@ func RunProposalOutboxDispatcher(ctx context.Context, db *sql.DB, service *Servi
 	}
 }
 
+// RunResultOutboxDispatcher delivers committed match results as targeted
+// COMPLETED state events. It owns only match_completed rows; proposal rows
+// remain with RunProposalOutboxDispatcher.
+func RunResultOutboxDispatcher(ctx context.Context, db *sql.DB, service *Service) {
+	if db == nil || service == nil {
+		return
+	}
+	ticker := time.NewTicker(100 * time.Millisecond)
+	defer ticker.Stop()
+	dispatcher := store.NewOutboxDispatcher(db, func(deliveryCtx context.Context, event store.OutboxEvent) error {
+		return deliverResultOutboxEvent(deliveryCtx, db, event, service)
+	})
+	for {
+		select {
+		case <-ctx.Done():
+			return
+		case <-ticker.C:
+			events, err := store.ReadUnpublishedResultOutbox(ctx, db, 100)
+			if err != nil {
+				continue
+			}
+			_ = dispatchOutboxEvents(ctx, dispatcher, events)
+		}
+	}
+}
+
 func dispatchOutboxEvents(ctx context.Context, dispatcher *store.OutboxDispatcher, events []store.OutboxEvent) error {
 	if len(events) == 0 {
 		return nil
@@ -83,3 +109,30 @@ func deliverProposalOutboxEvent(_ context.Context, event store.OutboxEvent, serv
 	}
 	return nil
 }
+
+func deliverResultOutboxEvent(ctx context.Context, db *sql.DB, event store.OutboxEvent, service *Service) error {
+	if event.EventType != "match_completed" || event.AggregateID == "" || event.Revision == 0 || len(event.Payload) == 0 {
+		return fmt.Errorf("invalid result outbox event")
+	}
+	var payload map[string]any
+	if err := json.Unmarshal(event.Payload, &payload); err != nil || payload == nil {
+		return fmt.Errorf("decode result outbox event: %w", err)
+	}
+	players, err := store.ReadMatchParticipantIDs(ctx, db, event.AggregateID)
+	if err != nil {
+		return err
+	}
+	if len(players) == 0 {
+		return fmt.Errorf("result outbox event has no participants")
+	}
+	for _, playerID := range players {
+		if err := service.PublishControlPlaneEvent(ControlPlaneEvent{
+			Event: "state_changed", Revision: event.Revision, ResourceID: event.AggregateID,
+			OccurredAt: event.CreatedAt, State: "COMPLETED", MatchID: event.AggregateID,
+			PlayerID: playerID,
+		}); err != nil {
+			return err
+		}
+	}
+	return nil
+}

server/api/outbox_test.go

@@ -49,3 +49,15 @@ func TestDeliverProposalOutboxEventRejectsMalformedOrUntargetedRows(t *testing.T
 		})
 	}
 }
+
+func TestDeliverResultOutboxEventRejectsMalformedRows(t *testing.T) {
+	for _, event := range []store.OutboxEvent{
+		{EventType: "proposal_changed", AggregateID: "match-1", Revision: 1, Payload: []byte(`{}`)},
+		{EventType: "match_completed", AggregateID: "", Revision: 1, Payload: []byte(`{}`)},
+		{EventType: "match_completed", AggregateID: "match-1", Revision: 1, Payload: []byte(`not-json`)},
+	} {
+		if err := deliverResultOutboxEvent(nil, nil, event, &Service{}); err == nil {
+			t.Fatalf("invalid result event accepted: %+v", event)
+		}
+	}
+}