feat: mulligan instrumentation

Author: beheh

Hearthstone Deck Tracker/GameEventHandler.cs

@@ -1023,7 +1023,19 @@ public void HandlePlayerMulliganDone()
 				Core.Overlay.BattlegroundsHeroPickingViewModel.Reset();
 			}
 			else if(_game.IsConstructedMatch)
+			{
 				Core.Overlay.HideMulliganPanel(false);
+				_game.SnapshotOpeningHand();
+				CaptureMulliganGuideFeedback();
+			}
+		}
+
+		public void HandlePlayerSendChoices(Choice choice)
+		{
+			if(choice.ChoiceType == ChoiceType.MULLIGAN)
+			{
+				_game.SnapshotMulliganChoices(choice);
+			}
 		}
 
 		private async void HandleConstructedStart()
@@ -1042,25 +1054,15 @@ private async void HandleConstructedStart()
 					// Wait for the game to fade in
 					await Task.Delay(3000);
 
+					_game.SnapshotMulligan();
 
 					var shortId = DeckList.Instance.ActiveDeckVersion?.ShortId;
 					if(!string.IsNullOrEmpty(shortId))
 					{
-						var cards = Core.Game.Player.PlayerEntities.Where(x => x.IsInHand && !x.Info.Created).Select(x => x.Card.DbfId);
-						var opponentClass = Core.Game.Opponent.PlayerEntities.FirstOrDefault(x => x.IsHero && x.IsInPlay)?.Card.CardClass ?? CardClass.INVALID;
-						var hasCoin = Core.Game.Player.HasCoin;
-
-						var isWild = _game.CurrentFormat == Format.Wild;
-						var isClassic = _game.CurrentFormat == Format.Classic;
-						var isTwist = _game.CurrentFormat == Format.Twist;
-
-						var playerStarLevel = 0;
-						if (_game.MatchInfo != null)
-						{
-							var localPlayer = _game.MatchInfo.LocalPlayer;
-							var playerInfo = isClassic ? localPlayer.Classic : isWild ? localPlayer.Wild : isTwist ? localPlayer.Twist : localPlayer.Standard;
-							playerStarLevel = playerInfo?.StarLevel ?? 0;
-						}
+						var cards = _game.Player.PlayerEntities.Where(x => x.IsInHand && !x.Info.Created).Select(x => x.Card.DbfId);
+						var opponentClass = _game.Opponent.PlayerEntities.FirstOrDefault(x => x.IsHero && x.IsInPlay)?.Card.CardClass ?? CardClass.INVALID;
+						var hasCoin = _game.Player.HasCoin;
+						var playerStarLevel = _game.PlayerMedalInfo?.StarLevel ?? 0;
 
 						Core.Overlay.ShowMulliganPanel(shortId!, cards.ToArray(), opponentClass, hasCoin, playerStarLevel);
 					}
@@ -1070,6 +1072,18 @@ private async void HandleConstructedStart()
 			}
 		}
 
+		private async Task CaptureMulliganGuideFeedback()
+		{
+			if(!Config.Instance.GoogleAnalytics || _game.Spectator)
+				return;
+
+			var parameters = _game.GetMulliganStatsParams();
+			if (parameters is null)
+				return;
+
+			await ApiWrapper.PostMulliganGuideFeedback(parameters);
+		}
+
 		private async void HandleBattlegroundsStart()
 		{
 			if(Config.Instance.ShowBattlegroundsToast)
@@ -1732,7 +1746,7 @@ public void HandleQuestRewardDatabaseId(int id, int value)
 		void IGameHandler.SetOpponentHero(string? cardId) => SetOpponentHero(cardId);
 		void IGameHandler.SetPlayerHero(string? cardId) => SetPlayerHero(cardId);
 		void IGameHandler.HandleOpponentHeroPower(string cardId, int turn) => HandleOpponentHeroPower(cardId, turn);
-		void IGameHandler.HandlePlayerSendChoices(Choice choice) {}
+		void IGameHandler.HandlePlayerSendChoices(Choice choice) => HandlePlayerSendChoices(choice);
 		void IGameHandler.TurnStart(ActivePlayer player, int turnNumber) => TurnStart(player, turnNumber);
 		void IGameHandler.HandleGameStart(DateTime timestamp) => HandleGameStart(timestamp);
 		void IGameHandler.HandleGameEnd(bool stateComplete) => HandleGameEnd(stateComplete);

Hearthstone Deck Tracker/Hearthstone/GameV2.cs

@@ -4,6 +4,7 @@
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading.Tasks;
+using HearthDb.Deckstrings;
 using HearthDb.Enums;
 using HearthMirror.Objects;
 using Hearthstone_Deck_Tracker.Controls.Overlay.Battlegrounds.HeroPicking;
@@ -20,6 +21,7 @@
 using Hearthstone_Deck_Tracker.Utility.ValueMoments.Utility;
 using HSReplay;
 using HSReplay.OAuth.Data;
+using HSReplay.Requests;
 
 #endregion
 
@@ -36,6 +38,7 @@ public class GameV2 : IGame
 		private BattlegroundRatingInfo? _battlegroundsRatingInfo;
 		private MercenariesRatingInfo? _mercenariesRatingInfo;
 		private BattlegroundsBoardState? _battlegroundsBoardState;
+		private MulliganState? _mulliganState;
 		private Dictionary<int, Dictionary<int, int>> _battlegroundsHeroLatestTavernUpTurn;
 		private Dictionary<int, Dictionary<int, int>> _battlegroundsHeroTriplesByTier;
 		internal QueueEvents QueueEvents { get; }
@@ -51,6 +54,7 @@ public GameV2()
 			_battlegroundsBoardState = new BattlegroundsBoardState(this);
 			_battlegroundsHeroLatestTavernUpTurn = new Dictionary<int, Dictionary<int, int>>();
 			_battlegroundsHeroTriplesByTier = new Dictionary<int, Dictionary<int, int>>();
+			_mulliganState = new MulliganState(this);
 			QueueEvents = new(this);
 			Reset();
 			LiveDataManager.OnStreamingChecked += async streaming =>
@@ -209,6 +213,25 @@ public GameType CurrentGameType
 		public MatchInfo MatchInfo => _matchInfo ?? (_matchInfo = HearthMirror.Reflection.Client.GetMatchInfo());
 		private bool _matchInfoCacheInvalid = true;
 
+		public MatchInfo.MedalInfo? PlayerMedalInfo
+		{
+			get
+			{
+				var localPlayer = MatchInfo?.LocalPlayer;
+				if(localPlayer is null || CurrentGameType != GameType.GT_RANKED)
+					return null;
+
+				return CurrentFormat switch
+				{
+					Format.Wild => localPlayer.Wild,
+					Format.Classic => localPlayer.Classic,
+					Format.Twist => localPlayer.Twist,
+					Format.Standard => localPlayer.Standard,
+					_ => null,
+				};
+			}
+		}
+
 		public BrawlInfo BrawlInfo => _brawlInfo ?? (_brawlInfo = HearthMirror.Reflection.Client.GetBrawlInfo());
 
 		public BattlegroundRatingInfo BattlegroundsRatingInfo => _battlegroundsRatingInfo ?? (_battlegroundsRatingInfo = HearthMirror.Reflection.Client.GetBattlegroundRatingInfo());
@@ -376,5 +399,32 @@ public void UpdateBattlegroundsPlayerTriples(int id, int value)
 		{
 			return _battlegroundsHeroTriplesByTier.TryGetValue(id, out var data) ? data : null;
 		}
+
+		public void SnapshotOpeningHand() => _mulliganState?.SnapshotOpeningHand();
+		public void SnapshotMulliganChoices(Choice choice) => _mulliganState?.SnapshotMulliganChoices(choice);
+		public void SnapshotMulligan() => _mulliganState?.SnapshotMulligan();
+
+		public MulliganGuideFeedbackParams? GetMulliganStatsParams()
+		{
+			var activeDeck = DeckList.Instance.ActiveDeck;
+			if(activeDeck == null)
+				return null;
+
+			var opponentClass = Opponent.PlayerEntities.FirstOrDefault(x => x.IsHero && x.IsInPlay)?.Card.CardClass ?? CardClass.INVALID;
+			var starLevel = PlayerMedalInfo?.StarLevel ?? 0;
+
+			return new MulliganGuideFeedbackParams
+			{
+				Deckstring = DeckSerializer.Serialize(HearthDbConverter.ToHearthDbDeck(activeDeck), false),
+				OpponentClass = opponentClass.ToString(),
+				PlayerInitiative = Player.HasCoin ? "COIN" : "FIRST",
+				PlayerRegion = CurrentRegion != Region.UNKNOWN ? "REGION_" + CurrentRegion : null,
+				PlayerStarLevel = starLevel > 0 ? starLevel : null,
+				GameType = (int)HearthDbConverter.GetBnetGameType(CurrentGameType, CurrentFormat),
+				OfferedCards = _mulliganState?.OfferedCards.Select(x => x.Card.DbfId).ToArray(),
+				KeptCards = _mulliganState?.KeptCards.Select(x => x.Card.DbfId).ToArray(),
+				FinalCardsInHand = _mulliganState?.FinalCardsInHand.Select(x => x.Card.DbfId).ToArray(),
+			};
+		}
 	}
 }

Hearthstone Deck Tracker/Hearthstone/MulliganState.cs

@@ -0,0 +1,39 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using HearthDb.CardDefs;
+using Entity = Hearthstone_Deck_Tracker.Hearthstone.Entities.Entity;
+
+namespace Hearthstone_Deck_Tracker.Hearthstone
+{
+	internal class MulliganState
+	{
+		public List<Entity> OfferedCards { get; private set; } = new List<Entity>();
+		public List<Entity> KeptCards { get; private set; } = new List<Entity>();
+		public List<Entity> FinalCardsInHand { get; private set; } = new List<Entity>();
+
+		private GameV2 _game;
+
+		public MulliganState(GameV2 game)
+		{
+			_game = game;
+		}
+
+		public void SnapshotMulligan()
+		{
+			OfferedCards = _game.Player.PlayerEntities.Where(x => x.IsInHand && !x.Info.Created).OrderBy(x => x.ZonePosition).ToList();
+		}
+
+		public void SnapshotMulliganChoices(Choice choice)
+		{
+			KeptCards = choice.ChosenEntities.ToList();
+		}
+
+		public void SnapshotOpeningHand()
+		{
+			FinalCardsInHand = _game.Player.PlayerEntities.Where(x => x.IsInHand && !x.Info.Created).OrderBy(x => x.ZonePosition).ToList();
+		}
+	}
+}

Hearthstone Deck Tracker/HsReplay/ApiWrapper.cs

@@ -209,5 +209,19 @@ public static async Task UploadLog(LogUploadRequest uploadRequest, string[] logL
 				return null;
 			}
 		}
+
+		public static async Task PostMulliganGuideFeedback(MulliganGuideFeedbackParams parameters)
+		{
+			try
+			{
+				await Client.PostMulliganGuideFeedback(parameters);
+			}
+			catch(Exception e)
+			{
+#if(DEBUG)
+				Log.Error(e);
+#endif
+			}
+		}
 	}
 }