GH-87: Request handling improvements

- Fix type in name of AuthorizationRefreshRequest
- Add handler for authentication requests
- Add handler for response errors
- Add helper for reading response content streams

Source/Lib/TraktApiSharp/Requests/Authentication/ÁuthorizationRefreshRequest.cs → Source/Lib/TraktApiSharp/Requests/Authentication/AuthorizationRefreshRequest.cs

@@ -2,7 +2,7 @@
 {
     using Objects.Authentication;
 
-    internal sealed class ÁuthorizationRefreshRequest : AAuthorizationRequest<ITraktAuthorization, AuthorizationRefreshRequestBody>
+    internal sealed class AuthorizationRefreshRequest : AAuthorizationRequest<ITraktAuthorization, AuthorizationRefreshRequestBody>
     {
         public override string UriTemplate => "oauth/token";
     }

Source/Lib/TraktApiSharp/Requests/Handler/IAuthenticationRequestHandler.cs

@@ -0,0 +1,32 @@
+namespace TraktApiSharp.Requests.Handler
+{
+    using Authentication;
+    using Objects.Authentication;
+    using Responses;
+    using System.Threading;
+    using System.Threading.Tasks;
+    using Utils;
+
+    internal interface IAuthenticationRequestHandler
+    {
+        string CreateAuthorizationUrl(string clientId, string redirectUri, string state);
+
+        string CreateAuthorizationUrlWithDefaultState(string clientId, string redirectUri);
+
+        Task<Pair<bool, TraktResponse<ITraktAuthorization>>> CheckIfAuthorizationIsExpiredOrWasRevokedAsync(bool autoRefresh = false, CancellationToken cancellationToken = default);
+
+        Task<Pair<bool, TraktResponse<ITraktAuthorization>>> CheckIfAuthorizationIsExpiredOrWasRevokedAsync(ITraktAuthorization authorization, bool autoRefresh = false, CancellationToken cancellationToken = default);
+
+        Task<bool> CheckIfAccessTokenWasRevokedOrIsNotValidAsync(string accessToken, CancellationToken cancellationToken = default);
+
+        Task<TraktResponse<ITraktDevice>> GetDeviceAsync(DeviceRequest request, CancellationToken cancellationToken = default);
+
+        Task<TraktResponse<ITraktAuthorization>> GetAuthorizationAsync(AuthorizationRequest request, CancellationToken cancellationToken = default);
+
+        Task<TraktResponse<ITraktAuthorization>> PollForAuthorizationAsync(AuthorizationPollRequest request, CancellationToken cancellationToken = default);
+
+        Task<TraktResponse<ITraktAuthorization>> RefreshAuthorizationAsync(AuthorizationRefreshRequest request, CancellationToken cancellationToken = default);
+
+        Task<TraktNoContentResponse> RevokeAuthorizationAsync(AuthorizationRevokeRequest request, string clientId, CancellationToken cancellationToken = default);
+    }
+}

Source/Lib/TraktApiSharp/Requests/Handler/ResponseErrorParameters.cs

@@ -0,0 +1,36 @@
+namespace TraktApiSharp.Requests.Handler
+{
+    using Base;
+    using System.Net;
+
+    internal sealed class ResponseErrorParameters
+    {
+        public string Url { get; set; }
+
+        public string RequestBody { get; set; }
+
+        public string ResponseBody { get; set; }
+
+        public string ServerReasonPhrase { get; set; }
+
+        public HttpStatusCode StatusCode { get; set; }
+
+        public RequestObjectType RequestObjectType { get; set; }
+
+        public string ObjectId { get; set; }
+
+        public uint SeasonNumber { get; set; }
+
+        public uint EpisodeNumber { get; set; }
+
+        public bool IsCheckinRequest { get; set; }
+
+        public bool IsDeviceRequest { get; set; }
+
+        public bool IsInAuthorizationPolling { get; set; }
+
+        public bool IsAuthorizationRequest { get; set; }
+
+        public bool IsAuthorizationRevoke { get; set; }
+    }
+}

Source/Lib/TraktApiSharp/Requests/Handler/ResponseMessageHelper.cs

@@ -0,0 +1,17 @@
+namespace TraktApiSharp.Requests.Handler
+{
+    using Core;
+    using System.IO;
+    using System.Net.Http;
+    using System.Threading.Tasks;
+
+    internal static class ResponseMessageHelper
+    {
+        internal static async Task<Stream> GetResponseContentStreamAsync(HttpResponseMessage responseMessage)
+        {
+            Stream responseContentStream = responseMessage.Content != null ? await responseMessage.Content.ReadAsStreamAsync().ConfigureAwait(false) : default;
+            DebugAsserter.AssertResponseContentStreamIsNotNull(responseContentStream);
+            return responseContentStream;
+        }
+    }
+}

Source/Lib/TraktApiSharp/TraktApiSharp.csproj

@@ -922,7 +922,7 @@
     <Compile Include="Requests\Authentication\AuthorizationRevokeRequestBody.cs" />
     <Compile Include="Requests\Authentication\DeviceRequest.cs" />
     <Compile Include="Requests\Authentication\DeviceRequestBody.cs" />
-    <Compile Include="Requests\Authentication\ÁuthorizationRefreshRequest.cs" />
+    <Compile Include="Requests\Authentication\AuthorizationRefreshRequest.cs" />
     <Compile Include="Requests\Base\ABodylessPostRequest%271.cs" />
     <Compile Include="Requests\Base\ABodylessPostRequest.cs" />
     <Compile Include="Requests\Base\ADeleteRequest.cs" />
@@ -939,11 +939,16 @@
     <Compile Include="Requests\Episodes\AEpisodeRequest%271.cs" />
     <Compile Include="Requests\Episodes\EpisodeListsRequest.cs" />
     <Compile Include="Requests\Episodes\EpisodeTranslationsRequest.cs" />
+    <Compile Include="Requests\Handler\AuthenticationRequestHandler.cs" />
     <Compile Include="Requests\Handler\ExtendedHttpRequestMessage.cs" />
     <Compile Include="Requests\Handler\HttpClientProvider.cs" />
+    <Compile Include="Requests\Handler\IAuthenticationRequestHandler.cs" />
     <Compile Include="Requests\Handler\IHttpClientProvider.cs" />
     <Compile Include="Requests\Handler\RequestMessageBuilder.cs" />
+    <Compile Include="Requests\Handler\ResponseErrorHandler.cs" />
+    <Compile Include="Requests\Handler\ResponseErrorParameters.cs" />
     <Compile Include="Requests\Handler\ResponseHeaderParser.cs" />
+    <Compile Include="Requests\Handler\ResponseMessageHelper.cs" />
     <Compile Include="Requests\Interfaces\Base\IBodylessPostRequest%271.cs" />
     <Compile Include="Requests\Interfaces\Base\IBodylessPostRequest.cs" />
     <Compile Include="Requests\Interfaces\Base\IDeleteRequest.cs" />