feat(multiplayer): publish allocation state events

server/api/outbox.go

@@ -64,6 +64,32 @@ func RunResultOutboxDispatcher(ctx context.Context, db *sql.DB, service *Service
 	}
 }
 
+// RunStateOutboxDispatcher delivers committed allocation/no-show lifecycle
+// transitions to each participant without acknowledging proposal or result
+// events owned by the other dispatchers.
+func RunStateOutboxDispatcher(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 deliverStateOutboxEvent(deliveryCtx, event, service)
+	})
+	for {
+		select {
+		case <-ctx.Done():
+			return
+		case <-ticker.C:
+			events, err := store.ReadUnpublishedStateOutbox(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
@@ -136,3 +162,33 @@ func deliverResultOutboxEvent(ctx context.Context, db *sql.DB, event store.Outbo
 	}
 	return nil
 }
+
+func deliverStateOutboxEvent(_ context.Context, event store.OutboxEvent, service *Service) error {
+	if event.EventType != "state_changed" || event.AggregateID == "" || event.Revision == 0 || len(event.Payload) == 0 {
+		return fmt.Errorf("invalid state outbox event")
+	}
+	var envelope struct {
+		Event      string    `json:"event"`
+		Revision   uint64    `json:"revision"`
+		ResourceID string    `json:"resource_id"`
+		OccurredAt time.Time `json:"occurred_at"`
+		State      string    `json:"state"`
+		MatchID    string    `json:"match_id"`
+		PlayerIDs  []string  `json:"player_ids"`
+	}
+	if err := json.Unmarshal(event.Payload, &envelope); err != nil {
+		return fmt.Errorf("decode state outbox event: %w", err)
+	}
+	if envelope.Event != "state_changed" || envelope.ResourceID != event.AggregateID || envelope.Revision != event.Revision || envelope.State == "" || len(envelope.PlayerIDs) == 0 {
+		return fmt.Errorf("invalid state outbox payload")
+	}
+	for _, playerID := range envelope.PlayerIDs {
+		if playerID == "" {
+			return fmt.Errorf("state outbox event has empty participant")
+		}
+		if err := service.PublishControlPlaneEvent(ControlPlaneEvent{Event: "state_changed", Revision: envelope.Revision, ResourceID: envelope.ResourceID, OccurredAt: envelope.OccurredAt, State: envelope.State, MatchID: envelope.MatchID, PlayerID: playerID}); err != nil {
+			return err
+		}
+	}
+	return nil
+}

server/api/outbox_test.go

@@ -61,3 +61,22 @@ func TestDeliverResultOutboxEventRejectsMalformedRows(t *testing.T) {
 		}
 	}
 }
+
+func TestDeliverStateOutboxEventValidatesRevisionAndTargets(t *testing.T) {
+	service := &Service{}
+	first := service.getEventHub().subscribe("player-a")
+	defer service.getEventHub().unsubscribe(first)
+	payload := []byte(`{"event":"state_changed","revision":4,"resource_id":"match-1","occurred_at":"1970-01-01T00:16:40Z","state":"ASSIGNMENT_READY","match_id":"match-1","player_ids":["player-a"]}`)
+	if err := deliverStateOutboxEvent(context.Background(), store.OutboxEvent{EventType: "state_changed", AggregateID: "match-1", Revision: 4, Payload: payload}, service); err != nil {
+		t.Fatalf("valid state event rejected: %v", err)
+	}
+	select {
+	case <-first.queue:
+	case <-time.After(time.Second):
+		t.Fatal("participant did not receive state event")
+	}
+	bad := []byte(`{"event":"state_changed","revision":3,"resource_id":"match-1","state":"LIVE","player_ids":["player-a"]}`)
+	if err := deliverStateOutboxEvent(context.Background(), store.OutboxEvent{EventType: "state_changed", AggregateID: "match-1", Revision: 4, Payload: bad}, service); err == nil {
+		t.Fatal("revision-mismatched state event accepted")
+	}
+}