Add user invite authorisation options (#622)

* Removed redundant merchant role url builders.

* Added user inite authorisation type.

* Added isauthorised flag to the user invite model.

Author: sipsorcery

src/NoFrixion.MoneyMoov/Enums/ApprovalTypesEnum.cs

@@ -35,5 +35,7 @@ public enum ApproveTypesEnum
 
     Payrun = 8,
 
-    MerchantToken = 9
+    MerchantToken = 9,
+
+    UserInvite = 10,
 }

src/NoFrixion.MoneyMoov/Enums/AuthorisationType.cs

@@ -22,5 +22,6 @@ public enum AuthorisationType
     Rule = 2,
     Beneficiary = 3,
     Payrun = 4,
-    MerchantToken = 5
+    MerchantToken = 5,
+    UserInvite = 6
 }

src/NoFrixion.MoneyMoov/Enums/UserInviteStatusEnum.cs

@@ -31,5 +31,10 @@ public enum UserInviteStatusEnum
     /// <summary>
     /// User has accepted the invite but the role is pending.
     /// </summary>
-    Accepted = 2
+    Accepted = 2,
+
+    /// <summary>
+    /// The invite needs to be authorised before being activated.
+    /// </summary>
+    AuthorisationRequired = 3,
 }

src/NoFrixion.MoneyMoov/Models/Token/MerchantToken.cs

@@ -134,11 +134,11 @@ public MerchantTokenPermissionsEnum Permissions
     public bool IsArchived { get; set; }
 
     /// <summary>
-    /// Gets a hash of the critical fields for the beneficiary. This hash is
-    /// used to ensure a beneficiary's details are not modified between the time the
-    /// authorisation is given and the time the beneficiary is enabled.
+    /// Gets a hash of the critical fields for the merhcant token. This hash is
+    /// used to ensure a merchant token's details are not modified between the time the
+    /// authorisation is given and the time the merchant token is enabled.
     /// </summary>
-    /// <returns>A hash of the beneficiary's critical fields.</returns>
+    /// <returns>A hash of the merchant token's critical fields.</returns>
     public string GetApprovalHash()
     {
         var input =

src/NoFrixion.MoneyMoov/Models/UserInvite/UserInvite.cs

@@ -50,10 +50,20 @@ public class UserInvite
     /// </summary>
     public Guid? InitialRoleID { get; set; }
 
+    /// <summary>
+    /// Will be set to true once the invite has met the authorisation requirements.
+    /// </summary>
+    public bool IsAuthorised { get; set; }
+
     public UserInviteStatusEnum Status
     {
         get
         {
+            if(!IsAuthorised)
+            {
+                return UserInviteStatusEnum.AuthorisationRequired;
+            }
+
             if (UserID != null)
             {
                 return UserInviteStatusEnum.Accepted;
@@ -69,4 +79,20 @@ public UserInviteStatusEnum Status
             }
         }
     }
+
+    /// <summary>
+    /// Gets a hash of the critical fields for the user invite. This hash is
+    /// used to ensure a user invite's details are not modified between the time the
+    /// authorisation is given and the time the user invite is enabled.
+    /// </summary>
+    /// <returns>A hash of the user invite's critical fields.</returns>
+    public string GetApprovalHash()
+    {
+        var input =
+            InviteeEmailAddress +
+            MerchantID +
+            InitialRoleID?.ToString();
+
+        return HashHelper.CreateHash(input);
+    }
 }

src/NoFrixion.MoneyMoov/MoneyMoovUrlBuilder.cs

@@ -124,12 +124,6 @@ public static string MerchantTokensUrl(string moneyMoovBaseUrl, Guid merchantID)
 
         public static string MerchantUserInvitesUrl(string moneyMoovBaseUrl, Guid merchantID)
            => $"{moneyMoovBaseUrl}/{MoneyMoovResources.merchants}/{merchantID}/{MoneyMoovResources.userinvites}";
-
-        public static string MerchantUserRolesUrl(string moneyMoovBaseUrl, Guid merchantID)
-            => $"{moneyMoovBaseUrl}/{MoneyMoovResources.merchants}/{merchantID}/{MoneyMoovResources.userroles}";
-
-        public static string MerchantUserRoleUrl(string moneyMoovBaseUrl)
-            => $"{moneyMoovBaseUrl}/{MoneyMoovResources.merchants}/{MoneyMoovResources.userroles}";
 
         public static string MerchantWebHooksUrl(string moneyMoovBaseUrl, Guid merchantID)
             => $"{moneyMoovBaseUrl}/{MoneyMoovResources.merchants}/{merchantID}/{MoneyMoovResources.webhooks}";