feat(backend): move endpoints to FastEndpoints handlers

apps/backend/Handlers/GetWorldHandler.cs

@@ -0,0 +1,16 @@
+using FastEndpoints;
+using SpaceGame.Simulation.Api.Simulation;
+
+namespace SpaceGame.Simulation.Api.Handlers;
+
+public sealed class GetWorldHandler(WorldService worldService) : EndpointWithoutRequest
+{
+  public override void Configure()
+  {
+    Get("/api/world");
+    AllowAnonymous();
+  }
+
+  public override Task HandleAsync(CancellationToken cancellationToken) =>
+    SendOkAsync(worldService.GetSnapshot(), cancellationToken);
+}

apps/backend/Handlers/GetWorldHealthHandler.cs

@@ -0,0 +1,24 @@
+using FastEndpoints;
+using SpaceGame.Simulation.Api.Simulation;
+
+namespace SpaceGame.Simulation.Api.Handlers;
+
+public sealed class GetWorldHealthHandler(WorldService worldService) : EndpointWithoutRequest
+{
+  public override void Configure()
+  {
+    Get("/api/world/health");
+    AllowAnonymous();
+  }
+
+  public override Task HandleAsync(CancellationToken cancellationToken)
+  {
+    var status = worldService.GetStatus();
+    return SendOkAsync(new
+    {
+      ok = true,
+      sequence = status.Sequence,
+      generatedAtUtc = status.GeneratedAtUtc,
+    }, cancellationToken);
+  }
+}

apps/backend/Handlers/ResetWorldHandler.cs

@@ -0,0 +1,16 @@
+using FastEndpoints;
+using SpaceGame.Simulation.Api.Simulation;
+
+namespace SpaceGame.Simulation.Api.Handlers;
+
+public sealed class ResetWorldHandler(WorldService worldService) : EndpointWithoutRequest
+{
+  public override void Configure()
+  {
+    Post("/api/world/reset");
+    AllowAnonymous();
+  }
+
+  public override Task HandleAsync(CancellationToken cancellationToken) =>
+    SendOkAsync(worldService.Reset(), cancellationToken);
+}

apps/backend/Handlers/RootRedirectHandler.cs

@@ -0,0 +1,18 @@
+using FastEndpoints;
+
+namespace SpaceGame.Simulation.Api.Handlers;
+
+public sealed class RootRedirectHandler : EndpointWithoutRequest
+{
+  public override void Configure()
+  {
+    Get("/");
+    AllowAnonymous();
+  }
+
+  public override Task HandleAsync(CancellationToken cancellationToken)
+  {
+    HttpContext.Response.Redirect("/api/world");
+    return Task.CompletedTask;
+  }
+}

apps/backend/Handlers/StreamWorldHandler.cs

@@ -0,0 +1,55 @@
+using System.Text.Json;
+using FastEndpoints;
+using SpaceGame.Simulation.Api.Contracts;
+using SpaceGame.Simulation.Api.Simulation;
+
+namespace SpaceGame.Simulation.Api.Handlers;
+
+public sealed class StreamWorldHandler(WorldService worldService) : EndpointWithoutRequest
+{
+  private static readonly JsonSerializerOptions SseJsonOptions = new(JsonSerializerDefaults.Web);
+
+  public override void Configure()
+  {
+    Get("/api/world/stream");
+    AllowAnonymous();
+  }
+
+  public override async Task HandleAsync(CancellationToken cancellationToken)
+  {
+    HttpContext.Response.Headers.Append("Cache-Control", "no-cache");
+    HttpContext.Response.Headers.Append("Content-Type", "text/event-stream");
+
+    var afterSequenceRaw = HttpContext.Request.Query["afterSequence"].ToString();
+    _ = long.TryParse(afterSequenceRaw, out var afterSequence);
+
+    var scopeKind = HttpContext.Request.Query["scopeKind"].ToString();
+    if (string.IsNullOrWhiteSpace(scopeKind))
+    {
+      scopeKind = HttpContext.Request.Query["scope"].ToString();
+    }
+
+    if (string.IsNullOrWhiteSpace(scopeKind))
+    {
+      scopeKind = "universe";
+    }
+
+    var systemId = HttpContext.Request.Query["systemId"].ToString();
+    var bubbleId = HttpContext.Request.Query["bubbleId"].ToString();
+    var scope = new ObserverScope(
+      scopeKind,
+      string.IsNullOrWhiteSpace(systemId) ? null : systemId,
+      string.IsNullOrWhiteSpace(bubbleId) ? null : bubbleId);
+    var stream = worldService.Subscribe(scope, afterSequence, cancellationToken);
+
+    await HttpContext.Response.WriteAsync(": connected\n\n", cancellationToken);
+    await HttpContext.Response.Body.FlushAsync(cancellationToken);
+
+    await foreach (var delta in stream.ReadAllAsync(cancellationToken))
+    {
+      var payload = JsonSerializer.Serialize(delta, SseJsonOptions);
+      await HttpContext.Response.WriteAsync($"event: world-delta\ndata: {payload}\n\n", cancellationToken);
+      await HttpContext.Response.Body.FlushAsync(cancellationToken);
+    }
+  }
+}