using System; using System.Collections.Generic; using System.Linq; using System.Net; using Jellyfin.Data.Enums; using MediaBrowser.Controller.Net; using MediaBrowser.Controller.Session; using MediaBrowser.Model.Querying; using Microsoft.AspNetCore.Http; namespace Jellyfin.Api.Helpers { /// /// Request Extensions. /// public static class RequestHelpers { /// /// Get Order By. /// /// Sort By. Comma delimited string. /// Sort Order. Comma delimited string. /// Order By. public static ValueTuple[] GetOrderBy(string? sortBy, string? requestedSortOrder) { var val = sortBy; if (string.IsNullOrEmpty(val)) { return Array.Empty>(); } var vals = val.Split(','); if (string.IsNullOrWhiteSpace(requestedSortOrder)) { requestedSortOrder = "Ascending"; } var sortOrders = requestedSortOrder.Split(','); var result = new ValueTuple[vals.Length]; for (var i = 0; i < vals.Length; i++) { var sortOrderIndex = sortOrders.Length > i ? i : 0; var sortOrderValue = sortOrders.Length > sortOrderIndex ? sortOrders[sortOrderIndex] : null; var sortOrder = string.Equals(sortOrderValue, "Descending", StringComparison.OrdinalIgnoreCase) ? SortOrder.Descending : SortOrder.Ascending; result[i] = new ValueTuple(vals[i], sortOrder); } return result; } /// /// Get parsed filters. /// /// The filters. /// Item filters. public static IEnumerable GetFilters(string? filters) { return string.IsNullOrEmpty(filters) ? Array.Empty() : filters.Split(',').Select(v => Enum.Parse(v, true)); } /// /// Splits a string at a separating character into an array of substrings. /// /// The string to split. /// The char that separates the substrings. /// Option to remove empty substrings from the array. /// An array of the substrings. internal static string[] Split(string? value, char separator, bool removeEmpty) { if (string.IsNullOrWhiteSpace(value)) { return Array.Empty(); } return removeEmpty ? value.Split(new[] { separator }, StringSplitOptions.RemoveEmptyEntries) : value.Split(separator); } /// /// Checks if the user can update an entry. /// /// Instance of the interface. /// The . /// The user id. /// Whether to restrict the user preferences. /// A whether the user can update the entry. internal static bool AssertCanUpdateUser(IAuthorizationContext authContext, HttpRequest requestContext, Guid userId, bool restrictUserPreferences) { var auth = authContext.GetAuthorizationInfo(requestContext); var authenticatedUser = auth.User; // If they're going to update the record of another user, they must be an administrator if ((!userId.Equals(auth.UserId) && !authenticatedUser.HasPermission(PermissionKind.IsAdministrator)) || (restrictUserPreferences && !authenticatedUser.EnableUserPreferenceAccess)) { return false; } return true; } internal static SessionInfo GetSession(ISessionManager sessionManager, IAuthorizationContext authContext, HttpRequest request) { var authorization = authContext.GetAuthorizationInfo(request); var user = authorization.User; var session = sessionManager.LogSessionActivity( authorization.Client, authorization.Version, authorization.DeviceId, authorization.Device, request.HttpContext.Connection.RemoteIpAddress.ToString(), user); if (session == null) { throw new ArgumentException("Session not found."); } return session; } /// /// Get Guid array from string. /// /// String value. /// Guid array. internal static Guid[] GetGuids(string? value) { if (value == null) { return Array.Empty(); } return Split(value, ',', true) .Select(i => new Guid(i)) .ToArray(); } /// /// Gets the item fields. /// /// The fields string. /// IEnumerable{ItemFields}. internal static ItemFields[] GetItemFields(string? fields) { if (string.IsNullOrEmpty(fields)) { return Array.Empty(); } return Split(fields, ',', true) .Select(v => { if (Enum.TryParse(v, true, out ItemFields value)) { return (ItemFields?)value; } return null; }).Where(i => i.HasValue) .Select(i => i!.Value) .ToArray(); } internal static IPAddress NormalizeIp(IPAddress ip) { return ip.IsIPv4MappedToIPv6 ? ip.MapToIPv4() : ip; } } }