Add a function to return active broker package name (#1813)

https://identitydivision.visualstudio.com/Engineering/_workitems/edit/2457616

Author: rpdome

msal/src/main/java/com/microsoft/identity/client/PublicClientApplication.java

@@ -34,6 +34,7 @@
 import static com.microsoft.identity.common.java.authorities.AzureActiveDirectoryAudience.isHomeTenantAlias;
 import static com.microsoft.identity.common.java.eststelemetry.PublicApiId.PCA_GENERATE_SIGNED_HTTP_REQUEST;
 import static com.microsoft.identity.common.java.eststelemetry.PublicApiId.PCA_GENERATE_SIGNED_HTTP_REQUEST_ASYNC;
+import static com.microsoft.identity.common.java.exception.ClientException.NOT_VALID_BROKER_FOUND;
 import static com.microsoft.identity.common.java.exception.ClientException.TOKEN_CACHE_ITEM_NOT_FOUND;
 import static com.microsoft.identity.common.java.exception.ClientException.TOKEN_SHARING_DESERIALIZATION_ERROR;
 import static com.microsoft.identity.common.java.exception.ClientException.TOKEN_SHARING_MSA_PERSISTENCE_ERROR;
@@ -2234,6 +2235,7 @@ private static boolean isAccountHomeTenant(@Nullable final Map<String, ?> claims
 
     /**
      * Returns true if the provided package name is a valid broker app.
+     * NOTE: Expose to Company Portal for Shared Device Mode broker validation.
      *
      * @param context       application context.
      * @param packageName   package name of the app to be verified.
@@ -2242,4 +2244,25 @@ public boolean isValidBrokerPackage(@NonNull final Context context,
                                         @NonNull final String packageName){
         return new BrokerValidator(context).isValidBrokerPackage(packageName);
     }
+
+    /**
+     * Returns active name of the broker app.
+     * NOTE: Expose to Company Portal for telemetry purpose.
+     *
+     * @param context application context.
+     * @return active broker package name. Null if active broker isn't installed.
+     **/
+    @Nullable
+    public String getActiveBrokerPackageName(@NonNull final Context context)
+            throws MsalException {
+        try {
+            return new BrokerValidator(context).getCurrentActiveBrokerPackageName();
+        } catch (final ClientException e){
+            if (NOT_VALID_BROKER_FOUND.equalsIgnoreCase(e.getErrorCode())) {
+                return null;
+            }
+
+            throw MsalExceptionAdapter.msalExceptionFromBaseException(e);
+        }
+    }
 }