neon-sprawl/server/NeonSprawl.Server/Game/Encounters/EncounterDefinitionsListDtos.cs

using System.Text.Json.Serialization;

namespace NeonSprawl.Server.Game.Encounters;

/// <summary>JSON body for <c>GET /game/world/encounter-definitions</c> (NEO-103).</summary>
public sealed class EncounterDefinitionsListResponse
{
    public const int CurrentSchemaVersion = 1;

    [JsonPropertyName("schemaVersion")]
    public int SchemaVersion { get; init; } = CurrentSchemaVersion;

    /// <summary>Loaded encounters ordered by stable <c>id</c> (ordinal), matching <see cref="IEncounterDefinitionRegistry.GetDefinitionsInIdOrder"/>.</summary>
    [JsonPropertyName("encounters")]
    public required IReadOnlyList<EncounterDefinitionJson> Encounters { get; init; }
}

/// <summary>One row in the read-only encounter definition projection.</summary>
public sealed class EncounterDefinitionJson
{
    [JsonPropertyName("id")]
    public required string Id { get; init; }

    [JsonPropertyName("displayName")]
    public required string DisplayName { get; init; }

    [JsonPropertyName("completionCriteria")]
    public required EncounterCompletionCriteriaJson CompletionCriteria { get; init; }

    [JsonPropertyName("requiredNpcInstanceIds")]
    public required IReadOnlyList<string> RequiredNpcInstanceIds { get; init; }

    [JsonPropertyName("rewardTable")]
    public required EncounterRewardTableJson RewardTable { get; init; }
}

/// <summary>Completion rule summary for one encounter row.</summary>
public sealed class EncounterCompletionCriteriaJson
{
    [JsonPropertyName("kind")]
    public required string Kind { get; init; }
}

/// <summary>Nested reward table summary linked from an encounter row.</summary>
public sealed class EncounterRewardTableJson
{
    [JsonPropertyName("id")]
    public required string Id { get; init; }

    [JsonPropertyName("displayName")]
    public required string DisplayName { get; init; }

    [JsonPropertyName("fixedGrants")]
    public required IReadOnlyList<EncounterRewardGrantJson> FixedGrants { get; init; }
}

/// <summary>One deterministic item grant in a nested reward table summary.</summary>
public sealed class EncounterRewardGrantJson
{
    [JsonPropertyName("itemId")]
    public required string ItemId { get; init; }

    [JsonPropertyName("quantity")]
    public required int Quantity { get; init; }
}