namespace NeonSprawl.Server.Game.Mastery;

/// <summary>How the unlock was triggered (branch-pick tier perks vs path-auto after level-up).</summary>
public enum PerkUnlockSource
{
    BranchPick,
    LevelUp,
}

/// <summary>
/// Internal event when a perk becomes unlocked (NEO-47). E9.M1 <c>perk_unlock</c> hook site: <see cref="PerkUnlockEngine"/> <c>TryUnlockPerks</c> (NEO-49).
/// <see cref="BranchId"/> is chosen branch when relevant; null for edge cases without a branch context.
/// </summary>
public sealed record PerkUnlockEvent(
    string PlayerId,
    string PerkId,
    string SkillId,
    int TierIndex,
    string? BranchId,
    PerkUnlockSource Source);