refactor: filter authorization details by type

Author: cgcladeraokta

README.md

@@ -242,7 +242,10 @@ void onSuccess(Rich consentDetails) {
 }
 ```
 
-Or, if you prefer to work with typed objects, you can pass a Class that has been annotated with `@AuthorizationDetailsType("[type]")`.
+Or, if you prefer to work with typed objects, you can use the filter helper passing a Class that has been annotated with `@AuthorizationDetailsType("[type]")`.
+
+> [!WARNING]
+> When using the filter helper, you still need to check if there are other authorization details in the rich consent record to prevent the user giving consent to something they didn't see rendered. 
 
 ```java
 @AuthorizationDetailsType("payment")
@@ -269,7 +272,7 @@ class PaymentDetails {
 void onSuccess(Rich consentDetails) {
     List<PaymentDetails> authorizationDetails = consentDetails
         .getRequestedDetails()
-        .getAuthorizationDetails(PaymentDetails.class);
+        .filterAuthorizationDetailsByType(PaymentDetails.class);
 
     int amount = authorizationDetails.get(0).getAmount();
     ...

app/src/main/java/com/auth0/guardian/sample/NotificationActivity.java

@@ -159,7 +159,7 @@ private void updateUI() {
         } else {
             List<PaymentInitiationDetails> paymentInitiationDetailsList = richConsent
                     .getRequestedDetails()
-                    .getAuthorizationDetails(PaymentInitiationDetails.class);
+                    .filterAuthorizationDetailsByType(PaymentInitiationDetails.class);
 
             if (paymentInitiationDetailsList.isEmpty()) {
                 fragment = ConsentBasicDetailsFragment.newInstance(

guardian/src/main/java/com/auth0/android/guardian/sdk/GuardianRichConsentRequestedDetails.java

@@ -76,7 +76,7 @@ public List<Map<String, Object>> getAuthorizationDetails() {
     }
 
     @Override
-    public <T> List<T> getAuthorizationDetails(@NonNull Class<T> clazz) {
+    public <T> List<T> filterAuthorizationDetailsByType(@NonNull Class<T> clazz) {
         List<T> types = new ArrayList<>();
 
         if (!clazz.isAnnotationPresent(AuthorizationDetailsType.class)) {

guardian/src/main/java/com/auth0/android/guardian/sdk/RichConsentRequestedDetails.java

@@ -36,5 +36,5 @@ public interface RichConsentRequestedDetails {
      * @param clazz Class annotated with @AuthorizationDetailsType to convert the item into.
      * @return The list of types found by the provided type. If none found, returns an empty list.
      */
-    <T> List<T> getAuthorizationDetails(@NonNull Class<T> clazz);
+    <T> List<T> filterAuthorizationDetailsByType(@NonNull Class<T> clazz);
 }

guardian/src/test/java/com/auth0/android/guardian/sdk/GuardianRichConsentRequestedDetailsTest.java

@@ -40,7 +40,7 @@ public void shouldHaveCorrectData() {
 
     @Test(expected = GuardianException.class)
     public void getAuthorizationDetailsShouldFailWhenUsedWithANonAnnotatedType() {
-        subject.getAuthorizationDetails(NotAnnotatedPaymentIntentTestingAuthorizationDetailsType.class);
+        subject.filterAuthorizationDetailsByType(NotAnnotatedPaymentIntentTestingAuthorizationDetailsType.class);
     }
 
 }

guardian/src/test/java/com/auth0/android/guardian/sdk/RichConsentsAPIClientTest.java

@@ -131,7 +131,7 @@ public void shouldFetchRichConsentWithRichAuthorizationDetails() throws Exceptio
 
         PaymentIntentTestingAuthorizationDetailsType paymentIntent = capturedRichConsent
                 .getRequestedDetails()
-                .getAuthorizationDetails(PaymentIntentTestingAuthorizationDetailsType.class)
+                .filterAuthorizationDetailsByType(PaymentIntentTestingAuthorizationDetailsType.class)
                 .get(0);
 
         assertThat(paymentIntent, is(notNullValue()));