Add /device/session_age, /device/session_id and /email/first_seen

Author: oalders

CHANGELOG.md

@@ -1,6 +1,12 @@
 CHANGELOG
 =========
 
+* Added support for new Device inputs. These are:
+    * `/device/session_age`
+    * `/device/session_id`
+* Added support for new Email outputs. These are:
+    * `/email/first_seen`
+
 1.4.0 (2017-02-22)
 ------------------
 

src/main/java/com/maxmind/minfraud/request/Device.java

@@ -12,11 +12,15 @@ public final class Device extends AbstractModel {
     private final InetAddress ipAddress;
     private final String userAgent;
     private final String acceptLanguage;
+    private final Float sessionAge;
+    private final String sessionId;
 
     private Device(Device.Builder builder) {
         ipAddress = builder.ipAddress;
         userAgent = builder.userAgent;
         acceptLanguage = builder.acceptLanguage;
+        sessionAge = builder.sessionAge;
+        sessionId = builder.sessionId;
     }
 
     /**
@@ -27,6 +31,8 @@ public static final class Builder {
         InetAddress ipAddress;
         String userAgent;
         String acceptLanguage;
+        Float sessionAge;
+        String sessionId;
 
         /**
          * The constructor for the {@code Device.Builder} class
@@ -62,6 +68,28 @@ public Device.Builder acceptLanguage(String acceptLanguage) {
             return this;
         }
 
+        /**
+         * @param sessionAge A floating point number. The number of seconds
+         *                   between the creation of the user's session and
+         *                   the time of the transaction. Note that session_age
+         *                   is not the duration of the current visit, but
+         *                   the time since the start of the first visit.
+         * @return The builder object.
+         */
+        public Device.Builder sessionAge(Float sessionAge) { this.sessionAge =
+            sessionAge; return this; }
+
+        /**
+         * @param sessionId A string up to 255 characters in length. This is
+         *                  an ID which uniquely identifies a visitor's
+         *                  session on the site.
+         * @return The builder object.
+         */
+        public Device.Builder sessionId(String sessionId) {
+            this.sessionId = sessionId;
+            return this;
+        }
+
         /**
          * @return An instance of {@code Device} created from the
          * fields set on this builder.
@@ -87,6 +115,22 @@ public String getAcceptLanguage() {
         return acceptLanguage;
     }
 
+    /**
+     * @return The session age.
+     */
+    @JsonProperty("session_age")
+    public Float getSessionAge() {
+        return sessionAge;
+    }
+
+    /**
+     * @return The session id.
+     */
+    @JsonProperty("session_id")
+    public String getSessionId() {
+        return sessionId;
+    }
+
     /**
      * @return The IP address used in the transaction.
      */

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

@@ -9,17 +9,20 @@
 public final class Email extends AbstractModel {
     private final Boolean isFree;
     private final Boolean isHighRisk;
+    private final String firstSeen;
 
     public Email(
             @JsonProperty("is_free") Boolean isFree,
-            @JsonProperty("is_high_risk") Boolean isHighRisk
+            @JsonProperty("is_high_risk") Boolean isHighRisk,
+            @JsonProperty("first_seen") String firstSeen
     ) {
         this.isFree = isFree;
         this.isHighRisk = isHighRisk;
+        this.firstSeen = firstSeen;
     }
 
     public Email() {
-        this(null, null);
+        this(null, null, null);
     }
 
     /**
@@ -37,4 +40,14 @@ public Boolean isFree() {
     public Boolean isHighRisk() {
         return isHighRisk;
     }
+
+    /**
+     * @return A date string (e.g. 2017-04-24) to identify the date an email
+     *         address was first seen by MaxMind. This is expressed using the
+     *         ISO 8601 date format.
+     */
+    @JsonProperty("first_seen")
+    public String firstSeen() {
+        return firstSeen;
+    }
 }

src/test/java/com/maxmind/minfraud/request/DeviceTest.java

@@ -35,4 +35,19 @@ public void testAcceptLanguage() throws Exception {
         Device device = new Builder(ip).acceptLanguage(al).build();
         assertEquals(al, device.getAcceptLanguage());
     }
-}
+
+
+    @Test
+    public void testSessionAge() throws Exception {
+        Float hour = (float) 3600;
+        Device device = new Builder(ip).sessionAge(hour).build();
+        assertEquals(hour, device.getSessionAge());
+    }
+
+    @Test
+    public void testSessionId() throws Exception {
+        String id = "foobar";
+        Device device = new Builder(ip).sessionId(id).build();
+        assertEquals(id, device.getSessionId());
+    }
+}

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

@@ -3,6 +3,7 @@
 import com.fasterxml.jackson.jr.ob.JSON;
 import org.junit.Test;
 
+import static org.junit.Assert.assertEquals;
 import static org.junit.Assert.assertFalse;
 import static org.junit.Assert.assertTrue;
 
@@ -17,11 +18,13 @@ public void testEmail() throws Exception {
                         .startObject()
                         .put("is_free", false)
                         .put("is_high_risk", true)
+                        .put("first_seen", "2017-01-02")
                         .end()
                         .finish()
         );
 
         assertFalse(email.isFree());
         assertTrue(email.isHighRisk());
+        assertEquals(email.firstSeen(),"2017-01-02");
     }
 }