using System;
using System.Collections.Generic;
using System.Linq;
using System.Net;
using Newtonsoft.Json;
using StardewModdingAPI.Toolkit.Serialization;
using StardewModdingAPI.Toolkit.Utilities;
namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
{
/// Provides methods for interacting with the SMAPI web API.
public class WebApiClient
{
/*********
** Fields
*********/
/// The base URL for the web API.
private readonly Uri BaseUrl;
/// The API version number.
private readonly ISemanticVersion Version;
/// The JSON serializer settings to use.
private readonly JsonSerializerSettings JsonSettings = new JsonHelper().JsonSettings;
/*********
** Public methods
*********/
/// Construct an instance.
/// The base URL for the web API.
/// The web API version.
public WebApiClient(string baseUrl, ISemanticVersion version)
{
this.BaseUrl = new Uri(baseUrl);
this.Version = version;
}
/// Get metadata about a set of mods from the web API.
/// The mod keys for which to fetch the latest version.
/// The SMAPI version installed by the player. If this is null, the API won't provide a recommended update.
/// The Stardew Valley version installed by the player.
/// The OS on which the player plays.
/// Whether to include extended metadata for each mod.
public IDictionary GetModInfo(ModSearchEntryModel[] mods, ISemanticVersion apiVersion, ISemanticVersion gameVersion, Platform platform, bool includeExtendedMetadata = false)
{
return this.Post(
$"v{this.Version}/mods",
new ModSearchModel(mods, apiVersion, gameVersion, platform, includeExtendedMetadata)
).ToDictionary(p => p.ID);
}
/*********
** Private methods
*********/
/// Fetch the response from the backend API.
/// The body content type.
/// The expected response type.
/// The request URL, optionally excluding the base URL.
/// The body content to post.
private TResult Post(string url, TBody content)
{
// note: avoid HttpClient for macOS compatibility
using WebClient client = new();
Uri fullUrl = new(this.BaseUrl, url);
string data = JsonConvert.SerializeObject(content);
client.Headers["Content-Type"] = "application/json";
client.Headers["User-Agent"] = $"SMAPI/{this.Version}";
string response = client.UploadString(fullUrl, data);
return JsonConvert.DeserializeObject(response, this.JsonSettings)
?? throw new InvalidOperationException($"Could not parse the response from POST {url}.");
}
}
}