1 files changed, 87 insertions, 0 deletions
diff --git a/src/StardewModdingAPI.Web/Controllers/ModsController.cs b/src/StardewModdingAPI.Web/Controllers/ModsController.cs
new file mode 100644
index 00000000..bbf1744f
--- /dev/null
+++ b/src/StardewModdingAPI.Web/Controllers/ModsController.cs
@@ -0,0 +1,87 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Mvc;
+using StardewModdingAPI.Web.Framework.ModRepositories;
+using StardewModdingAPI.Web.Models;
+
+namespace StardewModdingAPI.Web.Controllers
+{
+    /// <summary>Provides an API to perform mod update checks.</summary>
+    [Produces("application/json")]
+    public class ModsController : Controller
+    {
+        /*********
+        ** Properties
+        *********/
+        /// <summary>The mod repositories which provide mod metadata.</summary>
+        private readonly IDictionary<string, IModRepository> Repositories =
+            new IModRepository[]
+            {
+                new NexusRepository()
+            }
+            .ToDictionary(p => p.VendorKey, StringComparer.CurrentCultureIgnoreCase);
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Fetch version metadata for the given mods.</summary>
+        /// <param name="search">The mod update search criteria.</param>
+        [HttpPost]
+        [Route("mods")]
+        public async Task<ModInfoModel[]> Post([FromBody] ModSearchModel search)
+        {
+            IList<ModInfoModel> result = new List<ModInfoModel>();
+
+            foreach (string modKey in search.ModKeys)
+            {
+                // parse mod key
+                if (!this.TryParseModKey(modKey, out string vendorKey, out string modID))
+                {
+                    result.Add(new ModInfoModel(modKey, "The mod key isn't in a valid format. It should contain the mod repository key and mod ID like 'Nexus:541'."));
+                    continue;
+                }
+
+                // get matching repository
+                if (!this.Repositories.TryGetValue(vendorKey, out IModRepository repository))
+                {
+                    result.Add(new ModInfoModel(modKey, "There's no mod repository matching this namespaced mod ID."));
+                    continue;
+                }
+
+                // fetch mod info
+                result.Add(await repository.GetModInfoAsync(modID));
+            }
+
+            return result.ToArray();
+        }
+
+
+        /*********
+        ** Private methods
+        *********/
+        /// <summary>Parse a namespaced mod ID.</summary>
+        /// <param name="raw">The raw mod ID to parse.</param>
+        /// <param name="vendorKey">The parsed vendor key.</param>
+        /// <param name="modID">The parsed mod ID.</param>
+        /// <returns>Returns whether the value could be parsed.</returns>
+        private bool TryParseModKey(string raw, out string vendorKey, out string modID)
+        {
+            // split parts
+            string[] parts = raw?.Split(':');
+            if (parts == null || parts.Length != 2)
+            {
+                vendorKey = null;
+                modID = null;
+                return false;
+            }
+
+            // parse
+            vendorKey = parts[0];
+            modID = parts[1];
+            return true;
+        }
+    }
+}