[77019][77024] Hosted Authentication Imporovments (#39)

This PR provides two minor improvements to Hosted Authentication.

1. Added in the missing email authentication scope
2. Added support for force_password setting during hosted authentication

Author: mrashed-dev

CHANGELOG.md

@@ -6,8 +6,12 @@ This section contains changes that have been committed but not yet released.
 
 ### Added
 
+- Added support for the `forced_password` Hosted Auth setting
+
 ### Changed
 
+- Added missing `EMAIL` scope
+
 ### Deprecated
 
 ### Fixed

src/examples/java/com/nylas/examples/hostedAuth/HostedAuthUrlExample.java

@@ -19,6 +19,7 @@ public static void main(String[] args) throws Exception {
 			.scopes(Scope.values())
 			.loginHint(conf.get("hosted.login.hint"))
 			.state("example_csrf_token")
+			.forcePassword(true)
 			.buildUrl();
 
 		System.out.println("Forward the user to this URL for hosted authentication:");

src/main/java/com/nylas/HostedAuthentication.java

@@ -62,6 +62,7 @@ public static class UrlBuilder {
 		private String scopes = "";
 		private String loginHint = "";
 		private String state = "";
+		private boolean forcePassword = false;
 
 		UrlBuilder(NylasApplication app) {
 			this.app = app;
@@ -130,6 +131,15 @@ public UrlBuilder state(String state) {
 			this.state = state;
 			return this;
 		}
+
+		/**
+		 * An optional setting for when using a password or wanting to choose a different
+		 * provider than auto selected
+		 */
+		public UrlBuilder forcePassword(boolean forcePassword) {
+			this.forcePassword = forcePassword;
+			return this;
+		}
 
 		private void validate() {
 			assertState(!nullOrEmpty(redirectUri), "Redirection URI is required");
@@ -157,6 +167,9 @@ public String buildUrl() {
 			if (!nullOrEmpty(state)) {
 				urlBuilder.addQueryParameter("state", state);
 			}
+			if (forcePassword) {
+				urlBuilder.addQueryParameter("force_password", "true");
+			}
 
 			return urlBuilder.build().toString();
 		}

src/main/java/com/nylas/Scope.java

@@ -7,6 +7,11 @@
  */
 public enum Scope {
 
+	/**
+	 * Read, modify, and send all messages, threads, file attachments, and read email metadata like headers.
+	 */
+	EMAIL("email"),
+
 	/**
 	 * Read and modify all messages, threads, file attachments, and read email metadata like headers.
 	 * Does not include send.