Added account recovery options.

Author: AlexMeesters

Assets/Plugins/Lowscope/Appwrite/Runtime/Accounts/Account.cs

@@ -15,8 +15,8 @@ namespace Lowscope.AppwritePlugin.Accounts
 {
 	public class Account
 	{
-		public Action<User> OnLogin = delegate {  };
-		public Action OnLogout = delegate {  };
+		public Action<User> OnLogin = delegate { };
+		public Action OnLogout = delegate { };
 
 		private readonly AppwriteConfig config;
 		private readonly Dictionary<string, string> headers;
@@ -25,7 +25,7 @@ public class Account
 		private DateTime lastRegisterRequestDate;
 
 		private bool validatedSession = false;
-		
+
 		private string UserPath => Path.Combine(Application.persistentDataPath, "user.json");
 
 		internal Account(AppwriteConfig config)
@@ -46,11 +46,11 @@ private void StoreUserToDisk()
 		{
 			FileUtilities.Write(user, UserPath, config);
 
-			if (validatedSession) 
+			if (validatedSession)
 				return;
-			
+
 			validatedSession = true;
-			
+
 			OnLogin(user);
 		}
 
@@ -90,7 +90,7 @@ private async UniTask<bool> RequestUserInfo()
 						ClearUserDataFromDisk();
 						break;
 				}
-				
+
 				return false;
 			}
 
@@ -142,7 +142,7 @@ or HttpStatusCode.InternalServerError
 						or HttpStatusCode.TooManyRequests:
 						return (null, ELoginResponse.ServerBusy);
 				}
-				
+
 				Debug.Log($"Unimplemented: {httpStatusCode} {body}");
 				return (null, ELoginResponse.Failed);
 			}
@@ -173,7 +173,7 @@ or HttpStatusCode.InternalServerError
 		{
 			if (!WebUtilities.IsEmailValid(email))
 				return (null, ERegisterResponse.InvalidEmail);
-				
+
 			if (string.IsNullOrEmpty(id) || string.IsNullOrEmpty(name) || string.IsNullOrEmpty(email))
 				return (null, ERegisterResponse.MissingCredentials);
 
@@ -215,7 +215,7 @@ or HttpStatusCode.InternalServerError
 							return (null, ERegisterResponse.InvalidEmail);
 						break;
 				}
-				
+
 				Debug.Log($"Unimplemented: {httpStatusCode} {body}");
 				return (null, ERegisterResponse.Failed);
 			}
@@ -298,7 +298,7 @@ public async UniTask<EEmailVerifyResponse> RequestVerificationMail()
 			string url = $"{config.AppwriteURL}/account/verification";
 			using var request = new WebRequest(EWebRequestType.POST, url, headers, user.Cookie, bytes);
 			var (json, httpStatusCode) = await request.Send();
-			
+
 			// Session has become invalid, not able to utilize session anymore.
 			switch (httpStatusCode)
 			{
@@ -314,6 +314,33 @@ public async UniTask<EEmailVerifyResponse> RequestVerificationMail()
 			return httpStatusCode == HttpStatusCode.Created ? EEmailVerifyResponse.Sent : EEmailVerifyResponse.Failed;
 		}
 
+		public async UniTask<EAccountRecoverResponse> RequestPasswordRecovery(string email)
+		{
+			if (!WebUtilities.IsEmailValid(email))
+				return EAccountRecoverResponse.InvalidEmail;
+			
+			if (user != null)
+				return EAccountRecoverResponse.AlreadyLoggedIn;
+
+			JObject obj = new JObject(new JProperty("email", email), new JProperty("url", config.RecoverPasswordURL));
+			byte[] bytes = Encoding.UTF8.GetBytes(obj.ToString());
+
+			string url = $"{config.AppwriteURL}/account/recovery";
+			using var request = new WebRequest(EWebRequestType.POST, url, headers, "", bytes);
+			var (json, httpStatusCode) = await request.Send();
+
+			switch (httpStatusCode)
+			{
+				case HttpStatusCode.Unauthorized:
+				case HttpStatusCode.NotFound:
+					return EAccountRecoverResponse.Failed;
+			}
+
+			return httpStatusCode == HttpStatusCode.Created
+				? EAccountRecoverResponse.Sent
+				: EAccountRecoverResponse.Failed;
+		}
+
 		/// <summary>
 		/// Obtains user information
 		/// </summary>

Assets/Plugins/Lowscope/Appwrite/Runtime/Accounts/Enums/EAccountRecoverResponse.cs

@@ -0,0 +1,10 @@
+namespace Lowscope.AppwritePlugin.Accounts.Enums
+{
+	public enum EAccountRecoverResponse
+	{
+		AlreadyLoggedIn,
+		Failed,
+		Sent,
+		InvalidEmail
+	}
+}

Assets/Plugins/Lowscope/Appwrite/Runtime/AppwriteConfig.cs

@@ -11,7 +11,8 @@ public class AppwriteConfig : ScriptableObject
 		public string AppwriteProjectID = "MyAppwriteProjectID";
 
 		[Header("Account")]
-		public string VerifyEmailURL = "MyVerifyMailEndpoint";
+		public string VerifyEmailURL = "https://myfrontendwebsitehere.com/verifymail";
+		public string RecoverPasswordURL = "https://myfrontendwebsitehere.com/recover";
 
 		public float JwtExpireMinutes = 15;
 		public float VerifyEmailTimeoutMinutes = 5;

Assets/Plugins/Lowscope/Appwrite/Samples/LoginRegisterMenu/AppwriteExampleUI.cs

@@ -5,6 +5,7 @@
 using Lowscope.AppwritePlugin.Accounts.Model;
 using TMPro;
 using UnityEngine;
+using UnityEngine.Serialization;
 using UnityEngine.UI;
 
 public class AppwriteExampleUI : MonoBehaviour
@@ -21,6 +22,7 @@ public class AppwriteExampleUI : MonoBehaviour
 	[SerializeField] private Button buttonRefreshInfo;
 	[SerializeField] private Button buttonRegister;
 	[SerializeField] private Button buttonVerifyMail;
+	[SerializeField] private Button buttonRecoverAccount;
 
 	[SerializeField] private TextMeshProUGUI infoText;
 
@@ -34,11 +36,25 @@ private async void Start()
 		buttonRefreshInfo.onClick.AddListener(OnButtonRefreshInfo);
 		buttonVerifyMail.onClick.AddListener(OnButtonVerifyMail);
 		buttonRegister.onClick.AddListener(OnButtonRegister);
-
+		buttonRecoverAccount.onClick.AddListener(OnButtonRecoverAccount);
+		inputFieldEmail.onValueChanged.AddListener(OnChangedEmailValue);
+		
 		// Attempts to get/validate (saved) information from server
 		await UpdateInfo(true);
 	}
 
+	private void OnChangedEmailValue(string email)
+	{
+		buttonRecoverAccount.interactable = !string.IsNullOrEmpty(email);
+	}
+
+	private async void OnButtonRecoverAccount()
+	{
+		string email = inputFieldEmail.text;
+		var response = await Appwrite.Account.RequestPasswordRecovery(email);
+		Debug.Log($"Email recovery. Response: {response}");
+	}
+
 	private async void OnButtonLogin()
 	{
 		string email = inputFieldEmail.text;
@@ -60,7 +76,7 @@ private async void OnButtonLogout()
 		bool hasLoggedOut = await Appwrite.Account.Logout();
 		Debug.Log(!hasLoggedOut ? "Unable to logout. No session active." : "User logged out. Cookies cleared.");
 		user = null;
-		
+
 		await UpdateInfo(false);
 	}
 
@@ -104,7 +120,7 @@ private async UniTask UpdateInfo(bool refreshFromServer)
 			user = await Appwrite.Account.GetUser(true);
 
 		bool hasUser = user != null;
-		
+
 		if (hasUser)
 		{
 			StringBuilder sb = new StringBuilder();