namespace NeonSprawl.Server.Game.Mastery;

/// <summary>Internal event when a perk becomes unlocked (NEO-47; NEO-49 telemetry).</summary>
public enum PerkUnlockSource
{
    BranchPick,
    LevelUp,
}

/// <param name="BranchId">Chosen branch when relevant; null for edge cases without a branch context.</param>
public sealed record PerkUnlockEvent(
    string PlayerId,
    string PerkId,
    string SkillId,
    int TierIndex,
    string? BranchId,
    PerkUnlockSource Source);