CosmicClash/server/cmd/control-plane/main.go

package main

import (
	"context"
	"database/sql"
	"flag"
	"fmt"
	"net/http"
	"os"
	"os/signal"
	"strconv"
	"syscall"
	"time"

	"github.com/cosmic-clash/cosmic-clash/server/api"
	"github.com/cosmic-clash/cosmic-clash/server/domain"
	"github.com/cosmic-clash/cosmic-clash/server/migrations"
	"github.com/cosmic-clash/cosmic-clash/server/observability"
	"github.com/cosmic-clash/cosmic-clash/server/steam"
	"github.com/cosmic-clash/cosmic-clash/server/store"
	_ "github.com/jackc/pgx/v5/stdlib"
	"github.com/redis/go-redis/v9"
)

func main() {
	listen := flag.String("listen", ":8080", "HTTP listen address")
	role := flag.String("role", "api", "control-plane role; currently api")
	dsn := flag.String("dsn", os.Getenv("COSMIC_CLASH_POSTGRES_DSN"), "PostgreSQL connection string")
	migrationDir := flag.String("migrations", "migrations", "directory containing numbered SQL migrations")
	redisAddr := flag.String("redis-addr", os.Getenv("COSMIC_CLASH_REDIS_ADDR"), "optional Redis address for the candidate projection")
	redisPrefix := flag.String("redis-prefix", envOrDefault("COSMIC_CLASH_REDIS_PREFIX", "cosmic-clash"), "Redis key prefix")
	redisTTL := flag.Duration("redis-ttl", 60*time.Second, "TTL for transient candidate projection entries")
	workloadSecret := flag.String("workload-secret", os.Getenv("COSMIC_CLASH_WORKLOAD_SECRET"), "HMAC secret for control-plane-issued workload tokens (see workload/signed_token.go); server registration/result submission return 503 until this is set")
	degraded := flag.Bool("degraded", false, "start with new login, queue, and proposal mutations rejected; SIGUSR1 enables and SIGUSR2 disables this mode")
	rateLimit := flag.Int("rate-limit", 120, "maximum requests per per-credential/IP fixed window")
	rateWindow := flag.Duration("rate-limit-window", time.Minute, "fixed window for the per-replica request limiter")
	rateMaxKeys := flag.Int("rate-limit-max-keys", 10000, "maximum credential/IP keys retained by the per-replica request limiter")
	trustedProxyCIDRs := flag.String("trusted-proxy-cidrs", os.Getenv("COSMIC_CLASH_TRUSTED_PROXY_CIDRS"), "comma-separated immediate proxy CIDRs allowed to supply X-Forwarded-For")
	steamPublisherKey := flag.String("steam-publisher-key", os.Getenv("COSMIC_CLASH_STEAM_PUBLISHER_KEY"), "Steamworks publisher Web API key. Required for player sign-in; POST /v1/session/steam returns 503 until it and --steam-app-id are set. Never expose this to clients")
	steamAppID := flag.Uint64("steam-app-id", 0, "Steamworks App ID this build authenticates tickets for; may also be set via COSMIC_CLASH_STEAM_APP_ID")
	steamRejectBanned := flag.Bool("steam-reject-banned", true, "refuse sign-in for VAC- or publisher-banned accounts")
	minProtocolVersion := flag.Int("min-protocol-version", 0, "reject queue_create below this protocol_version with 426 Upgrade Required instead of queueing a client the matcher can never pair with anyone; zero disables the floor")
	flag.Parse()
	if *role != "api" {
		fatalf("unsupported role %q (only api is implemented)", *role)
	}
	if *dsn == "" {
		fatalf("--dsn or COSMIC_CLASH_POSTGRES_DSN is required")
	}
	if *redisTTL <= 0 {
		fatalf("--redis-ttl must be positive")
	}
	if *minProtocolVersion < 0 {
		fatalf("--min-protocol-version must be non-negative")
	}
	rateLimiter, err := api.NewRateLimiter(*rateLimit, *rateWindow, *rateMaxKeys)
	if err != nil {
		fatalf("invalid request limiter configuration: %v", err)
	}
	clientIPs, err := api.NewClientIPResolver(*trustedProxyCIDRs)
	if err != nil {
		fatalf("invalid trusted proxy configuration: %v", err)
	}
	db, err := sql.Open("pgx", *dsn)
	if err != nil {
		fatalf("open PostgreSQL: %v", err)
	}
	defer db.Close()
	startupCtx, startupCancel := context.WithTimeout(context.Background(), 30*time.Second)
	defer startupCancel()
	if err := db.PingContext(startupCtx); err != nil {
		fatalf("ping PostgreSQL: %v", err)
	}
	if err := migrations.Apply(startupCtx, db, *migrationDir); err != nil {
		fatalf("apply migrations: %v", err)
	}
	var candidateIndex api.CandidateIndex
	var redisClient *redis.Client
	if *redisAddr != "" {
		redisClient = redis.NewClient(&redis.Options{Addr: *redisAddr})
		defer redisClient.Close()
		candidateIndex = store.RedisCandidateIndex{Client: redisClient, Prefix: *redisPrefix, TTL: *redisTTL}
	}
	if *workloadSecret == "" {
		fmt.Fprintln(os.Stderr, "control-plane: warning: --workload-secret / COSMIC_CLASH_WORKLOAD_SECRET is unset; server registration and result submission will return 503")
	}
	if *steamAppID == 0 {
		if value := os.Getenv("COSMIC_CLASH_STEAM_APP_ID"); value != "" {
			parsed, parseErr := strconv.ParseUint(value, 10, 64)
			if parseErr != nil {
				fatalf("COSMIC_CLASH_STEAM_APP_ID must be a positive integer")
			}
			*steamAppID = parsed
		}
	}
	service := newAPIService(db, *workloadSecret, candidateIndex)
	// Player sign-in is configuration-gated rather than always-on: without a
	// publisher key there is no safe way to verify a ticket, and silently
	// accepting one would be worse than refusing to authenticate at all. The
	// endpoint keeps returning 503 until both values are supplied.
	if *steamPublisherKey != "" && *steamAppID != 0 {
		service.SteamLogin = api.SteamLogin{
			DB: db,
			Verifier: steam.WebAPIVerifier{
				PublisherKey: *steamPublisherKey,
				AppID:        *steamAppID,
				RejectBanned: *steamRejectBanned,
			},
		}
	} else {
		fmt.Fprintln(os.Stderr, "control-plane: warning: --steam-publisher-key and --steam-app-id are unset; player sign-in will return 503")
	}
	service.RateLimiter = rateLimiter
	service.ClientIPs = clientIPs
	service.MinProtocolVersion = *minProtocolVersion
	admission := api.NewAdmissionGate(*degraded)
	service.Admission = admission
	server := &http.Server{Addr: *listen, Handler: service.Handler(), ReadHeaderTimeout: 5 * time.Second}
	serveErr := make(chan error, 1)
	go func() { serveErr <- server.ListenAndServe() }()
	ctx, stop := signal.NotifyContext(context.Background(), os.Interrupt, syscall.SIGTERM)
	defer stop()
	operatorSignals := make(chan os.Signal, 2)
	signal.Notify(operatorSignals, syscall.SIGUSR1, syscall.SIGUSR2)
	defer signal.Stop(operatorSignals)
	go func() {
		for sig := range operatorSignals {
			switch sig {
			case syscall.SIGUSR1:
				admission.SetDegraded(true)
				fmt.Fprintln(os.Stderr, "control-plane: degraded admission enabled")
			case syscall.SIGUSR2:
				admission.SetDegraded(false)
				fmt.Fprintln(os.Stderr, "control-plane: degraded admission disabled")
			}
		}
	}()
	// Fan committed outbox events out to every replica. Subscribers live in
	// each process's in-memory hub, but any replica may drain a given outbox
	// row, so without this a client connected elsewhere never sees the event
	// and delivery degrades as replicas are added.
	service.EventFanout = func(event api.ControlPlaneEvent) error {
		payload, err := api.EncodeFannedOutEvent(event)
		if err != nil {
			return err
		}
		return store.NotifyControlPlaneEvent(ctx, db, payload)
	}
	go store.ListenControlPlaneEvents(ctx, *dsn, func(payload []byte) {
		event, err := api.DecodeFannedOutEvent(payload)
		if err != nil {
			return
		}
		// Publishing to a player with no local subscriber is a no-op, so every
		// replica can handle every notification.
		_ = service.PublishControlPlaneEvent(event)
	}, func(err error) {
		fmt.Fprintf(os.Stderr, "control-plane: event fan-out listener: %v\n", err)
	})
	go api.RunProposalOutboxDispatcher(ctx, db, service)
	go api.RunResultOutboxDispatcher(ctx, db, service)
	go api.RunStateOutboxDispatcher(ctx, db, service)
	select {
	case err := <-serveErr:
		if err != nil && err != http.ErrServerClosed {
			fatalf("serve API: %v", err)
		}
	case <-ctx.Done():
		shutdownCtx, shutdownCancel := context.WithTimeout(context.Background(), 10*time.Second)
		defer shutdownCancel()
		if err := server.Shutdown(shutdownCtx); err != nil {
			fatalf("shutdown API: %v", err)
		}
	}
}

func newAPIHandler(db *sql.DB, workloadSecret string, indexes ...api.CandidateIndex) http.Handler {
	return newAPIService(db, workloadSecret, indexes...).Handler()
}

func newAPIService(db *sql.DB, workloadSecret string, indexes ...api.CandidateIndex) *api.Service {
	var candidateIndex api.CandidateIndex
	if len(indexes) > 0 {
		candidateIndex = indexes[0]
	}
	return &api.Service{
		SessionBackend:        store.PostgresSessions{DB: db},
		SessionIssuer:         store.PostgresSessions{DB: db},
		QueueBackend:          store.PostgresQueue{DB: db},
		ProposalBackend:       api.ProposalProviderFromStore(db),
		ProposalPromoter:      api.ProposalPromoterFromStore(db),
		ServerRegistrar:       api.ServerRegistrarFromStore(db),
		ServerShutdowner:      api.ServerShutdownerFromStore(db),
		ServerConnections:     api.ServerConnectionsFromStore(db),
		ResultSubmitter:       store.PostgresResults{DB: db},
		RankedProfileProvider: store.PostgresRankedProfiles{DB: db},
		TierPolicy:            domain.DefaultTierPolicy(),
		Assignment:            api.AssignmentProviderFromStore(db),
		Roster: func(ctx context.Context, binding domain.WorkloadBinding, now time.Time) ([][]byte, error) {
			return store.GetAssignmentRoster(ctx, db, binding.MatchID, binding.ServerID, now)
		},
		CandidateIndex: candidateIndex,
		ProbeRecorder:  store.PostgresQueue{DB: db},
		// Regional latency placement. Without both of these the probe endpoint
		// is unreachable, queue_tickets.predicted_rtt stays empty, and
		// domain.validCandidate rejects every client-created ticket -- so the
		// matcher can never form a match from real traffic.
		ProbeChallenger: func(ctx context.Context, playerID, region string, now time.Time) ([]byte, error) {
			return store.IssueProbeChallenge(ctx, db, playerID, region, now)
		},
		Probe: func(ctx context.Context, playerID, region string, opaqueLocation, nonce []byte, receivedAt time.Time) (domain.ProbeEvidence, []byte, error) {
			return store.ProbeEvidenceFromChallenge(ctx, db, playerID, region, opaqueLocation, nonce, receivedAt)
		},
		// Repairs the transient index after a probe changes the durable RTT;
		// the candidate inserted at enqueue time has an empty map.
		CandidateRefresh: func(ctx context.Context, playerID string, now time.Time) (domain.Candidate, bool, error) {
			return store.FindQueuedCandidateByPlayer(ctx, db, playerID, now)
		},
		WorkloadVerify: api.WorkloadVerifierFromSignedToken([]byte(workloadSecret), db),
		ReadinessCheck: db.PingContext,
		Now:            func() time.Time { return time.Now().UTC() },
		Log:            logEvent,
		Metrics:        observability.NewMetrics(),
	}
}

// logEvent writes one credential-safe structured event per line to stderr.
// Best-effort: a logging failure must never fail or block the request it
// describes, so encode errors are swallowed rather than surfaced.
func logEvent(event observability.Event) {
	payload, err := observability.Encode(event)
	if err != nil {
		return
	}
	fmt.Fprintln(os.Stderr, string(payload))
}

func envOrDefault(name, fallback string) string {
	if value := os.Getenv(name); value != "" {
		return value
	}
	return fallback
}

func fatalf(format string, args ...any) {
	fmt.Fprintf(os.Stderr, "control-plane: "+format+"\n", args...)
	os.Exit(1)
}