Merge wied03/ENG-2158/change-password (#144)

* add new overload case

* fix comment capitalization

Author: wied03

fusionauth-netcore-client/src/io/fusionauth/FusionAuthClient.cs

@@ -205,7 +205,17 @@ public Task<ClientResponse<RESTVoid>> CheckChangePasswordUsingJWTAsync(string en
     public Task<ClientResponse<RESTVoid>> CheckChangePasswordUsingLoginIdAsync(string loginId) {
       return buildClient()
           .withUri("/api/user/change-password")
-          .withParameter("username", loginId)
+          .withParameter("loginId", loginId)
+          .withMethod("Get")
+          .goAsync<RESTVoid>();
+    }
+
+    /// <inheritdoc/>
+    public Task<ClientResponse<RESTVoid>> CheckChangePasswordUsingLoginIdAndLoginIdTypesAsync(string loginId, List<string> loginIdTypes) {
+      return buildClient()
+          .withUri("/api/user/change-password")
+          .withParameter("loginId", loginId)
+          .withParameter("loginIdTypes", loginIdTypes)
           .withMethod("Get")
           .goAsync<RESTVoid>();
     }

fusionauth-netcore-client/src/io/fusionauth/FusionAuthSyncClient.cs

@@ -117,6 +117,11 @@ public ClientResponse<RESTVoid> CheckChangePasswordUsingLoginId(string loginId)
       return client.CheckChangePasswordUsingLoginIdAsync(loginId).GetAwaiter().GetResult();
     }
 
+    /// <inheritdoc/>
+    public ClientResponse<RESTVoid> CheckChangePasswordUsingLoginIdAndLoginIdTypes(string loginId, List<string> loginIdTypes) {
+      return client.CheckChangePasswordUsingLoginIdAndLoginIdTypesAsync(loginId, loginIdTypes).GetAwaiter().GetResult();
+    }
+
     /// <inheritdoc/>
     public ClientResponse<AccessToken> ClientCredentialsGrant(string client_id, string client_secret, string scope) {
       return client.ClientCredentialsGrantAsync(client_id, client_secret, scope).GetAwaiter().GetResult();

fusionauth-netcore-client/src/io/fusionauth/IFusionAuthClient.cs

@@ -216,7 +216,7 @@ public interface IFusionAuthAsyncClient {
     /// An HTTP status code of 400 with a general error code of [TrustTokenRequired] indicates that a Trust Token is required to make a POST request to this API.
     /// This is an asynchronous method.
     /// </summary>
-    /// <param name="loginId"> The loginId of the User that you intend to change the password for.</param>
+    /// <param name="loginId"> The loginId (email or username) of the User that you intend to change the password for.</param>
     /// <returns>
     /// When successful, the response will contain the log of the action. If there was a validation error or any
     /// other type of error, this will return the Errors object in the response. Additionally, if FusionAuth could not be
@@ -225,6 +225,24 @@ public interface IFusionAuthAsyncClient {
     /// </returns>
     Task<ClientResponse<RESTVoid>> CheckChangePasswordUsingLoginIdAsync(string loginId);
 
+    /// <summary>
+    /// Check to see if the user must obtain a Trust Request Id in order to complete a change password request.
+    /// When a user has enabled Two-Factor authentication, before you are allowed to use the Change Password API to change
+    /// your password, you must obtain a Trust Request Id by completing a Two-Factor Step-Up authentication.
+    /// 
+    /// An HTTP status code of 400 with a general error code of [TrustTokenRequired] indicates that a Trust Token is required to make a POST request to this API.
+    /// This is an asynchronous method.
+    /// </summary>
+    /// <param name="loginId"> The loginId of the User that you intend to change the password for.</param>
+    /// <param name="loginIdTypes"> The identity types that FusionAuth will compare the loginId to.</param>
+    /// <returns>
+    /// When successful, the response will contain the log of the action. If there was a validation error or any
+    /// other type of error, this will return the Errors object in the response. Additionally, if FusionAuth could not be
+    /// contacted because it is down or experiencing a failure, the response will contain an Exception, which could be an
+    /// IOException.
+    /// </returns>
+    Task<ClientResponse<RESTVoid>> CheckChangePasswordUsingLoginIdAndLoginIdTypesAsync(string loginId, List<string> loginIdTypes);
+
     /// <summary>
     /// Make a Client Credentials grant request to obtain an access token.
     /// This is an asynchronous method.
@@ -3510,7 +3528,7 @@ public interface IFusionAuthAsyncClient {
     /// This is an asynchronous method.
     /// </summary>
     /// <param name="loginId"> The email or username of the user.</param>
-    /// <param name="loginIdTypes"> the identity types that FusionAuth will compare the loginId to.</param>
+    /// <param name="loginIdTypes"> The identity types that FusionAuth will compare the loginId to.</param>
     /// <returns>
     /// When successful, the response will contain the log of the action. If there was a validation error or any
     /// other type of error, this will return the Errors object in the response. Additionally, if FusionAuth could not be
@@ -3704,7 +3722,7 @@ public interface IFusionAuthAsyncClient {
     /// <param name="loginId"> The userId id.</param>
     /// <param name="start"> The start instant as UTC milliseconds since Epoch.</param>
     /// <param name="end"> The end instant as UTC milliseconds since Epoch.</param>
-    /// <param name="loginIdTypes"> the identity types that FusionAuth will compare the loginId to.</param>
+    /// <param name="loginIdTypes"> The identity types that FusionAuth will compare the loginId to.</param>
     /// <returns>
     /// When successful, the response will contain the log of the action. If there was a validation error or any
     /// other type of error, this will return the Errors object in the response. Additionally, if FusionAuth could not be
@@ -5263,7 +5281,7 @@ public interface IFusionAuthSyncClient {
    /// 
    /// An HTTP status code of 400 with a general error code of [TrustTokenRequired] indicates that a Trust Token is required to make a POST request to this API.
    /// </summary>
-   /// <param name="loginId"> The loginId of the User that you intend to change the password for.</param>
+   /// <param name="loginId"> The loginId (email or username) of the User that you intend to change the password for.</param>
    /// <returns>
    /// When successful, the response will contain the log of the action. If there was a validation error or any
    /// other type of error, this will return the Errors object in the response. Additionally, if FusionAuth could not be
@@ -5272,6 +5290,23 @@ public interface IFusionAuthSyncClient {
    /// </returns>
    ClientResponse<RESTVoid> CheckChangePasswordUsingLoginId(string loginId);
 
+   /// <summary>
+   /// Check to see if the user must obtain a Trust Request Id in order to complete a change password request.
+   /// When a user has enabled Two-Factor authentication, before you are allowed to use the Change Password API to change
+   /// your password, you must obtain a Trust Request Id by completing a Two-Factor Step-Up authentication.
+   /// 
+   /// An HTTP status code of 400 with a general error code of [TrustTokenRequired] indicates that a Trust Token is required to make a POST request to this API.
+   /// </summary>
+   /// <param name="loginId"> The loginId of the User that you intend to change the password for.</param>
+   /// <param name="loginIdTypes"> The identity types that FusionAuth will compare the loginId to.</param>
+   /// <returns>
+   /// When successful, the response will contain the log of the action. If there was a validation error or any
+   /// other type of error, this will return the Errors object in the response. Additionally, if FusionAuth could not be
+   /// contacted because it is down or experiencing a failure, the response will contain an Exception, which could be an
+   /// IOException.
+   /// </returns>
+   ClientResponse<RESTVoid> CheckChangePasswordUsingLoginIdAndLoginIdTypes(string loginId, List<string> loginIdTypes);
+
    /// <summary>
    /// Make a Client Credentials grant request to obtain an access token.
    /// </summary>
@@ -8320,7 +8355,7 @@ public interface IFusionAuthSyncClient {
    /// Retrieves the user for the loginId, using specific loginIdTypes.
    /// </summary>
    /// <param name="loginId"> The email or username of the user.</param>
-   /// <param name="loginIdTypes"> the identity types that FusionAuth will compare the loginId to.</param>
+   /// <param name="loginIdTypes"> The identity types that FusionAuth will compare the loginId to.</param>
    /// <returns>
    /// When successful, the response will contain the log of the action. If there was a validation error or any
    /// other type of error, this will return the Errors object in the response. Additionally, if FusionAuth could not be
@@ -8501,7 +8536,7 @@ public interface IFusionAuthSyncClient {
    /// <param name="loginId"> The userId id.</param>
    /// <param name="start"> The start instant as UTC milliseconds since Epoch.</param>
    /// <param name="end"> The end instant as UTC milliseconds since Epoch.</param>
-   /// <param name="loginIdTypes"> the identity types that FusionAuth will compare the loginId to.</param>
+   /// <param name="loginIdTypes"> The identity types that FusionAuth will compare the loginId to.</param>
    /// <returns>
    /// When successful, the response will contain the log of the action. If there was a validation error or any
    /// other type of error, this will return the Errors object in the response. Additionally, if FusionAuth could not be