namespace NeonSprawl.Server.Game.Encounters;

/// <summary>
/// Server-internal encounter completion resolution envelope (NEO-105).
/// Combat wiring promotes via NEO-106; HTTP DTOs via NEO-108.
/// NEO-109 telemetry hook sites live in <see cref="EncounterCompletionOperations.TryCompleteAndGrant"/>.
/// </summary>
/// <param name="GrantsApplied">Item grants on success; empty when denied.</param>
/// <param name="CompleteEvent">Completion payload on success; null when denied.</param>
public readonly record struct EncounterCompletionResult(
    bool Success,
    string? ReasonCode,
    IReadOnlyList<EncounterGrantApplied> GrantsApplied,
    EncounterCompleteEvent? CompleteEvent,
    DateTimeOffset? CompletedAt);