Add Javadoc comments to public classes missing documentation

Co-authored-by: Avery-Dunn <62066438+Avery-Dunn@users.noreply.github.com>

Author: Copilot

msal4j-sdk/src/main/java/com/microsoft/aad/msal4j/AppTokenProviderParameters.java

@@ -5,7 +5,10 @@
 
 import java.util.Set;
 
-/// The authentication parameters provided to the app token provider callback.
+/**
+ * Represents the authentication parameters provided to an external app token provider callback.
+ * Contains information about the requested scopes, correlation ID, and claims for token acquisition.
+ */
 public class AppTokenProviderParameters {
 
     /// Specifies which scopes to request.

msal4j-sdk/src/main/java/com/microsoft/aad/msal4j/AuthenticationErrorMessage.java

@@ -3,6 +3,10 @@
 
 package com.microsoft.aad.msal4j;
 
+/**
+ * Contains constant error messages used throughout the authentication process.
+ * Provides standardized error messaging for common authentication scenarios.
+ */
 public class AuthenticationErrorMessage {
 
     /**

msal4j-sdk/src/main/java/com/microsoft/aad/msal4j/AuthorizationRequestUrlParameters.java

@@ -40,6 +40,13 @@ public class AuthorizationRequestUrlParameters {
 
     Logger log = LoggerFactory.getLogger(AuthorizationRequestUrlParameters.class);
 
+    /**
+     * Creates a new builder for authorization request URL parameters.
+     *
+     * @param redirectUri the redirect URI where the authorization response will be sent
+     * @param scopes the set of scopes to request for the access token
+     * @return a new Builder instance
+     */
     public static Builder builder(String redirectUri,
                                   Set<String> scopes) {
 

msal4j-sdk/src/main/java/com/microsoft/aad/msal4j/CIAMAuthority.java

@@ -6,6 +6,10 @@
 import java.net.MalformedURLException;
 import java.net.URL;
 
+/**
+ * Represents a Customer Identity and Access Management (CIAM) authority for Azure AD B2C scenarios.
+ * CIAM authorities are used for customer-facing applications and identity management.
+ */
 public class CIAMAuthority extends Authority {
 
     public static final String CIAM_HOST_SEGMENT = ".ciamlogin.com";

msal4j-sdk/src/main/java/com/microsoft/aad/msal4j/CustomJWTAuthentication.java

@@ -14,6 +14,10 @@
 
 import java.util.*;
 
+/**
+ * Custom JWT-based client authentication implementation for OAuth 2.0 client authentication.
+ * This class handles authentication using client assertions based on JWT tokens.
+ */
 public class CustomJWTAuthentication extends ClientAuthentication {
     private ClientAssertion clientAssertion;
 

msal4j-sdk/src/main/java/com/microsoft/aad/msal4j/ManagedIdentityErrorResponse.java

@@ -5,6 +5,10 @@
 
 import com.fasterxml.jackson.annotation.JsonProperty;
 
+/**
+ * Represents an error response from a managed identity token request.
+ * Contains error details, correlation ID, and error descriptions for debugging purposes.
+ */
 public class ManagedIdentityErrorResponse {
 
     @JsonProperty("message")

msal4j-sdk/src/main/java/com/microsoft/aad/msal4j/ManagedIdentityId.java

@@ -3,6 +3,11 @@
 
 package com.microsoft.aad.msal4j;
 
+/**
+ * Represents the identifier for a managed identity in Azure.
+ * A managed identity provides Azure services with an automatically managed identity in Azure AD.
+ * This class supports both system-assigned and user-assigned managed identities.
+ */
 public class ManagedIdentityId {
 
     private String userAssignedId;

msal4j-sdk/src/main/java/com/microsoft/aad/msal4j/ManagedIdentitySourceType.java

@@ -3,6 +3,10 @@
 
 package com.microsoft.aad.msal4j;
 
+/**
+ * Enumeration of managed identity source types used to identify the specific
+ * Azure service or infrastructure component providing the managed identity token endpoint.
+ */
 public enum ManagedIdentitySourceType {
     // Default.
     NONE,

msal4j-sdk/src/main/java/com/microsoft/aad/msal4j/OSHelper.java

@@ -1,5 +1,9 @@
 package com.microsoft.aad.msal4j;
 
+/**
+ * Utility class for operating system detection and OS-specific operations.
+ * Provides methods to identify the current operating system (Windows, macOS, Linux).
+ */
 public class OSHelper {
     enum OSType{
         MAC,

msal4j-sdk/src/main/java/com/microsoft/aad/msal4j/OidcAuthority.java

@@ -6,6 +6,10 @@
 import java.net.MalformedURLException;
 import java.net.URL;
 
+/**
+ * Represents an OpenID Connect (OIDC) authority that handles authentication and token issuance.
+ * This authority type supports the standard OIDC discovery process.
+ */
 public class OidcAuthority extends Authority {
     //Part of the OpenIdConnect standard, this is appended to the authority to create the endpoint that has OIDC metadata
     private static final String WELL_KNOWN_OPENID_CONFIGURATION = ".well-known/openid-configuration";