From 3190646cd069bc7f0c73a2662dd3e8e535561c95 Mon Sep 17 00:00:00 2001
From: TetrisGG <dmiller2606@gmail.com>
Date: Wed, 5 Mar 2025 20:28:25 +0100
Subject: [PATCH] Add Router Comments

Add missing Router comments.
---
 Libraries/Core/Routers/EventOutputHolder.cs | 29 ++++++++++++++++++---
 Libraries/Core/Routers/ItemEventRouter.cs   |  8 +++++-
 2 files changed, 33 insertions(+), 4 deletions(-)

diff --git a/Libraries/Core/Routers/EventOutputHolder.cs b/Libraries/Core/Routers/EventOutputHolder.cs
index 90023dfb..c3ba8932 100644
--- a/Libraries/Core/Routers/EventOutputHolder.cs
+++ b/Libraries/Core/Routers/EventOutputHolder.cs
@@ -81,7 +81,10 @@ public class EventOutputHolder
             }
         );
     }
-
+    /// <summary>
+    /// Update output object with most recent values from player profile
+    /// </summary>
+    /// <param name="sessionId"> Session id </param>
     public void UpdateOutputProperties(string sessionId)
     {
         var pmcData = _profileHelper.GetPmcProfile(sessionId);
@@ -107,6 +110,10 @@ public class EventOutputHolder
         CleanUpCompleteCraftsInProfile(pmcData.Hideout.Production);
     }
 
+    /// <summary>
+    /// Required as continuous productions don't reset and stay at 100% completion but client thinks it hasn't started
+    /// </summary>
+    /// <param name="productions"> Productions in a profile </param>
     private void CleanUpCompleteCraftsInProfile(Dictionary<string, Production>? productions)
     {
         foreach (var production in productions)
@@ -123,7 +130,12 @@ public class EventOutputHolder
                 productions.Remove(production.Key);
             }
     }
-
+    
+    /// <summary>
+    /// Return all hideout Improvements from player profile, adjust completed Improvements' completed property to be true
+    /// </summary>
+    /// <param name="pmcData"> Player profile </param>
+    /// <returns> Dictionary of hideout improvements </returns>
     private Dictionary<string, HideoutImprovement>? GetImprovementsFromProfileAndFlagComplete(PmcData pmcData)
     {
         foreach (var improvementKey in pmcData.Hideout.Improvements)
@@ -139,6 +151,12 @@ public class EventOutputHolder
         return pmcData.Hideout.Improvements;
     }
 
+    /// <summary>
+    /// Return productions from player profile except those completed crafts the client has already seen
+    /// </summary>
+    /// <param name="productions"> Productions from player profile </param>
+    /// <param name="sessionId"> Player session ID</param>
+    /// <returns> Dictionary of hideout productions </returns>
     private Dictionary<string, Production>? GetProductionsFromProfileAndFlagComplete(Dictionary<string, Production>? productions, string sessionId)
     {
         foreach (var production in productions)
@@ -185,7 +203,12 @@ public class EventOutputHolder
             limit.RemainingLimit = limit.TotalLimit;
         }
     }
-
+    
+    /// <summary>
+    /// Convert the internal trader data object into an object we can send to the client
+    /// </summary>
+    /// <param name="traderData"> Server data for traders </param>
+    /// <returns> Dict of trader id + TraderData </returns>
     private Dictionary<string, TraderData> ConstructTraderRelations(Dictionary<string, TraderInfo> traderData)
     {
         return traderData.ToDictionary(
diff --git a/Libraries/Core/Routers/ItemEventRouter.cs b/Libraries/Core/Routers/ItemEventRouter.cs
index 823ebe52..02c30235 100644
--- a/Libraries/Core/Routers/ItemEventRouter.cs
+++ b/Libraries/Core/Routers/ItemEventRouter.cs
@@ -42,7 +42,13 @@ public class ItemEventRouter
         _itemEventRouters = itemEventRouters.ToList();
         _cloner = cloner;
     }
-
+    
+    /// <summary>
+    /// Handles ItemEventRouter Requests and processes them.
+    /// </summary>
+    /// <param name="info"> Event request </param>
+    /// <param name="sessionID"> Session ID </param>
+    /// <returns> Item response </returns>
     public ItemEventRouterResponse HandleEvents(ItemEventRouterRequest info, string sessionID)
     {
         var output = _eventOutputHolder.GetOutput(sessionID);