space-game/apps/backend/Contracts/WorldContracts.cs

namespace SpaceGame.Simulation.Api.Contracts;

public sealed record WorldSnapshot(
  string Label,
  int Seed,
  long Sequence,
  int TickIntervalMs,
  DateTimeOffset GeneratedAtUtc,
  IReadOnlyList<SystemSnapshot> Systems,
  IReadOnlyList<ResourceNodeSnapshot> Nodes,
  IReadOnlyList<StationSnapshot> Stations,
  IReadOnlyList<ShipSnapshot> Ships,
  IReadOnlyList<FactionSnapshot> Factions);

public sealed record WorldDelta(
  long Sequence,
  int TickIntervalMs,
  DateTimeOffset GeneratedAtUtc,
  bool RequiresSnapshotRefresh,
  IReadOnlyList<SimulationEventRecord> Events,
  IReadOnlyList<ResourceNodeDelta> Nodes,
  IReadOnlyList<StationDelta> Stations,
  IReadOnlyList<ShipDelta> Ships,
  IReadOnlyList<FactionDelta> Factions);

public sealed record SimulationEventRecord(
  string EntityKind,
  string EntityId,
  string Kind,
  string Message,
  DateTimeOffset OccurredAtUtc);

public sealed record SystemSnapshot(
  string Id,
  string Label,
  Vector3Dto GalaxyPosition,
  string StarKind,
  int StarCount,
  string StarColor,
  float StarSize,
  IReadOnlyList<PlanetSnapshot> Planets);

public sealed record PlanetSnapshot(
  string Label,
  string PlanetType,
  string Shape,
  int MoonCount,
  float OrbitRadius,
  float OrbitSpeed,
  float OrbitEccentricity,
  float OrbitInclination,
  float OrbitLongitudeOfAscendingNode,
  float OrbitArgumentOfPeriapsis,
  float OrbitPhaseAtEpoch,
  float Size,
  string Color,
  bool HasRing);

public sealed record ResourceNodeSnapshot(
  string Id,
  string SystemId,
  Vector3Dto LocalPosition,
  string SourceKind,
  float OreRemaining,
  float MaxOre,
  string ItemId);

public sealed record ResourceNodeDelta(
  string Id,
  string SystemId,
  Vector3Dto LocalPosition,
  string SourceKind,
  float OreRemaining,
  float MaxOre,
  string ItemId);

public sealed record InventoryEntry(
  string ItemId,
  float Amount);

public sealed record StationSnapshot(
  string Id,
  string Label,
  string Category,
  string SystemId,
  Vector3Dto LocalPosition,
  string Color,
  int DockedShips,
  int DockingPads,
  float EnergyStored,
  IReadOnlyList<InventoryEntry> Inventory,
  string FactionId);

public sealed record StationDelta(
  string Id,
  string Label,
  string Category,
  string SystemId,
  Vector3Dto LocalPosition,
  string Color,
  int DockedShips,
  int DockingPads,
  float EnergyStored,
  IReadOnlyList<InventoryEntry> Inventory,
  string FactionId);

public sealed record ShipSnapshot(
  string Id,
  string Label,
  string Role,
  string ShipClass,
  string SystemId,
  Vector3Dto LocalPosition,
  Vector3Dto LocalVelocity,
  Vector3Dto TargetLocalPosition,
  string State,
  string? OrderKind,
  string DefaultBehaviorKind,
  string ControllerTaskKind,
  float CargoCapacity,
  float EnergyStored,
  IReadOnlyList<InventoryEntry> Inventory,
  string FactionId,
  float Health,
  IReadOnlyList<string> History);

public sealed record ShipDelta(
  string Id,
  string Label,
  string Role,
  string ShipClass,
  string SystemId,
  Vector3Dto LocalPosition,
  Vector3Dto LocalVelocity,
  Vector3Dto TargetLocalPosition,
  string State,
  string? OrderKind,
  string DefaultBehaviorKind,
  string ControllerTaskKind,
  float CargoCapacity,
  float EnergyStored,
  IReadOnlyList<InventoryEntry> Inventory,
  string FactionId,
  float Health,
  IReadOnlyList<string> History);

public sealed record FactionSnapshot(
  string Id,
  string Label,
  string Color,
  float Credits,
  float OreMined,
  float GoodsProduced,
  int ShipsBuilt,
  int ShipsLost);

public sealed record FactionDelta(
  string Id,
  string Label,
  string Color,
  float Credits,
  float OreMined,
  float GoodsProduced,
  int ShipsBuilt,
  int ShipsLost);

public sealed record Vector3Dto(float X, float Y, float Z);