add new error for verification contact blocked

Author: nilo-ms

common/src/main/java/com/microsoft/identity/common/nativeauth/internal/controllers/NativeAuthMsalController.kt

@@ -664,6 +664,16 @@ class NativeAuthMsalController : BaseNativeAuthController() {
                         correlationId = result.correlationId
                     )
                 }
+                is JITChallengeApiResult.BlockedVerificationContact -> {
+                    val customDescription = "Verification contact blocked. " +
+                            "Please try using another email or phone number, or select an alternative authentication method."
+                    JITCommandResult.BlockedVerificationContact(
+                        error = result.error,
+                        errorDescription = customDescription + result.errorDescription,
+                        errorCodes = result.errorCodes,
+                        correlationId = result.correlationId
+                    )
+                }
                 is JITChallengeApiResult.OOBRequired -> {
                     JITCommandResult.VerificationRequired(
                         correlationId = result.correlationId,

common4j/src/main/com/microsoft/identity/common/java/nativeauth/controllers/results/JITCommandResult.kt

@@ -38,6 +38,17 @@ interface JITCommandResult {
         override fun toString(): String = "VerificationRequired(correlationId=$correlationId, codeLength=$codeLength, challengeChannel=$challengeChannel)"
     }
 
+    data class BlockedVerificationContact(
+        override val correlationId: String,
+        val error: String,
+        val errorDescription: String,
+        val errorCodes: List<Int>
+    ) : JITChallengeAuthMethodCommandResult {
+        override fun toUnsanitizedString(): String = "BlockedVerificationContact(correlationId=$correlationId, error=$error, errorDescription=$errorDescription, errorCodes=$errorCodes)"
+
+        override fun toString(): String = "BlockedVerificationContact(correlationId=$correlationId)"
+    }
+
     data class IncorrectVerificationContact(
         override val correlationId: String,
         val error: String,

common4j/src/main/com/microsoft/identity/common/java/nativeauth/providers/responses/jit/JITChallengeApiResponse.kt

@@ -26,6 +26,7 @@ import com.google.gson.annotations.Expose
 import com.google.gson.annotations.SerializedName
 import com.microsoft.identity.common.java.nativeauth.providers.INativeAuthApiResponse
 import com.microsoft.identity.common.java.nativeauth.providers.responses.ApiErrorResult
+import com.microsoft.identity.common.java.nativeauth.util.isBlockedChallengeTarget
 import com.microsoft.identity.common.java.nativeauth.util.isInvalidChallengeTarget
 import com.microsoft.identity.common.java.nativeauth.util.isInvalidRequest
 import com.microsoft.identity.common.java.nativeauth.util.isOOB
@@ -78,7 +79,14 @@ class JITChallengeApiResponse(
                             correlationId = correlationId
                         )
                     }
-
+                    error.isInvalidRequest() && errorCodes?.first().isBlockedChallengeTarget() -> {
+                        JITChallengeApiResult.BlockedVerificationContact(
+                            error = error.orEmpty(),
+                            errorDescription = errorDescription.orEmpty(),
+                            errorCodes = errorCodes.orEmpty(),
+                            correlationId = correlationId
+                        )
+                    }
                     else -> {
                         JITChallengeApiResult.UnknownError(
                             error = error.orEmpty(),

common4j/src/main/com/microsoft/identity/common/java/nativeauth/providers/responses/jit/JITChallengeApiResult.kt

@@ -80,6 +80,23 @@ sealed interface JITChallengeApiResult: ApiResult {
         }
     }
 
+    data class BlockedVerificationContact(
+        override val correlationId: String,
+        override val error: String,
+        override val errorDescription: String,
+        override val errorCodes: List<Int>
+    ) : ApiErrorResult(
+        error = error,
+        errorDescription = errorDescription,
+        errorCodes = errorCodes,
+        correlationId = correlationId
+    ), JITChallengeApiResult {
+        override fun toUnsanitizedString() = "BlockedVerificationContact(correlationId=$correlationId, " +
+                "error=$error, errorDescription=$errorDescription, subError=$subError)"
+
+        override fun toString(): String = "BlockedVerificationContact(correlationId=$correlationId)"
+    }
+
     data class InvalidVerificationContact(
         override val correlationId: String,
         override val error: String,

common4j/src/main/com/microsoft/identity/common/java/nativeauth/util/ApiErrorResponseUtil.kt

@@ -117,6 +117,10 @@ internal fun Int?.isInvalidChallengeTarget(): Boolean {
     return this == 901001
 }
 
+internal fun Int?.isBlockedChallengeTarget(): Boolean {
+    return this == 550024
+}
+
 fun String?.isMFARequired(): Boolean {
     return this.contentEquals(other = "mfa_required", ignoreCase = true)
 }