Merge pull request #128 from jinaga/interfaces

Inject AuthenticationService by interface

Jinaga.Maui/Authentication/AuthenticationService.cs

@@ -9,7 +9,7 @@ namespace Jinaga.Maui.Authentication;
 /// <summary>
 /// Provides authentication services, including token management and user authentication.
 /// </summary>
-public class AuthenticationService : IHttpAuthenticationProvider
+public class AuthenticationService : IHttpAuthenticationProvider, IAuthenticationService
 {
     private readonly ITokenStorage tokenStorage;
     private readonly UserProvider userProvider;
@@ -103,7 +103,7 @@ public async Task<bool> Initialize()
     /// </summary>
     /// <param name="provider">The identifier of the authentication provider to use</param>
     /// <returns>True if the user successfully authenticated</returns>
-    public async Task<bool> Login(string provider)
+    public async Task<bool> LogIn(string provider)
     {
         lock (stateLock)
         {

Jinaga.Maui/Authentication/IAuthenticationService.cs

@@ -0,0 +1,24 @@
+namespace Jinaga.Maui.Authentication;
+
+/// <summary>
+/// Provides authentication services, including token management and user authentication.
+/// </summary>
+public interface IAuthenticationService
+{
+    /// <summary>
+    /// Initializes the authentication service. Call at application startup.
+    /// </summary>
+    /// <returns>True if the user is authenticated</returns>
+    Task<bool> Initialize();
+    /// <summary>
+    /// Log the user in.
+    /// </summary>
+    /// <param name="provider">The identifier of the authentication provider to use</param>
+    /// <returns>True if the user successfully authenticated</returns>
+    Task<bool> LogIn(string provider);
+    /// <summary>
+    /// Log the user out.
+    /// </summary>
+    /// <returns>Resolves when logout is successful</returns>
+    Task LogOut();
+}

Jinaga.Maui/ConfigurationExtensions.cs

@@ -26,7 +26,7 @@ public static IServiceCollection AddJinagaAuthentication(this IServiceCollection
         services.AddSingleton<IHttpAuthenticationProvider>(
             s => s.GetRequiredService<AuthenticationProviderProxy>());
         services.AddSingleton<OAuthClient>();
-        services.AddSingleton<AuthenticationService>();
+        services.AddSingleton<IAuthenticationService, AuthenticationService>();
         return services;
     }
 

Jinaga/Http/IHttpAuthenticationProvider.cs

@@ -3,9 +3,20 @@
 
 namespace Jinaga.Http
 {
+    /// <summary>
+    /// Adds authentication details to HTTP requests.
+    /// </summary>
     public interface IHttpAuthenticationProvider
     {
+        /// <summary>
+        /// Set the authentication token in the request headers.
+        /// </summary>
+        /// <param name="headers">HTTP headers to modify</param>
         void SetRequestHeaders(HttpRequestHeaders headers);
+        /// <summary>
+        /// Reauthenticate the user. Called when a request fails with a 401 Unauthorized status.
+        /// </summary>
+        /// <returns>True if the token was successfully refreshed</returns>
         Task<JinagaAuthenticationState> Reauthenticate();
     }
 }