Add support for /email/is_disposable

Author: oschwald

CHANGELOG.md

@@ -1,6 +1,13 @@
 CHANGELOG
 =========
 
+1.11.0
+-------------------
+
+* Added support for the new email output `/email/is_disposable`. This can
+  be accessed via the `isDisposable()` method on the `Email` response
+  object.
+
 1.10.0 (2019-12-19)
 -------------------
 

src/main/java/com/maxmind/minfraud/response/Email.java

@@ -7,32 +7,57 @@
  * This class contains minFraud response data related to the email address.
  */
 public final class Email extends AbstractModel {
+    private final Boolean isDisposable;
     private final Boolean isFree;
     private final Boolean isHighRisk;
     private final String firstSeen;
 
     public Email(
+            @JsonProperty("is_disposable") Boolean isDisposable,
             @JsonProperty("is_free") Boolean isFree,
             @JsonProperty("is_high_risk") Boolean isHighRisk,
             @JsonProperty("first_seen") String firstSeen
     ) {
+        this.isDisposable = isDisposable;
         this.isFree = isFree;
         this.isHighRisk = isHighRisk;
         this.firstSeen = firstSeen;
     }
 
+    // The following constructors are for backward compatibility and
+    // can be removed as part of a major release
+    public Email(
+            Boolean isFree,
+            Boolean isHighRisk,
+            String firstSeen
+    ) {
+        this(null, isFree, isHighRisk, firstSeen);
+    }
+
     public Email(
             Boolean isFree,
             Boolean isHighRisk
     ) {
-        this(isFree, isHighRisk, null);
+        this(null, isFree, isHighRisk, null);
     }
 
     public Email() {
         this(null, null, null);
     }
 
+
+    /**
+     * @return Whether the email address is from a disposable email provider.
+     * If no email address was passed, this will be {@code null}.
+     */
+    @JsonProperty("is_disposable")
+    public Boolean isDisposable() {
+        return isDisposable;
+    }
+
     /**
+     * /**
+     *
      * @return True if the email address is for a free email service provider.
      */
     @JsonProperty("is_free")

src/test/java/com/maxmind/minfraud/response/EmailTest.java

@@ -14,13 +14,15 @@ public void testEmail() throws Exception {
                 JSON.std
                         .composeString()
                         .startObject()
+                        .put("is_disposable", false)
                         .put("is_free", false)
                         .put("is_high_risk", true)
                         .put("first_seen", "2017-01-02")
                         .end()
                         .finish()
         );
 
+        assertFalse(email.isDisposable());
         assertFalse(email.isFree());
         assertTrue(email.isHighRisk());
         assertEquals(email.getFirstSeen(), "2017-01-02");
@@ -39,6 +41,7 @@ public void testEmailWithoutFirstSeen() throws Exception {
                         .finish()
         );
 
+        assertNull(email.isDisposable());
         assertFalse(email.isFree());
         assertTrue(email.isHighRisk());
         assertNull(email.getFirstSeen());

src/test/resources/test-data/factors-response.json

@@ -130,6 +130,7 @@
   },
   "email": {
     "first_seen": "2017-01-02",
+    "is_disposable": true,
     "is_free": true,
     "is_high_risk": true
   },

src/test/resources/test-data/insights-response.json

@@ -146,6 +146,7 @@
   },
   "email": {
     "first_seen": "2017-01-02",
+    "is_disposable": true,
     "is_free": true,
     "is_high_risk": true
   },