Add support for the /device/local_time output

Author: horgh

CHANGELOG.md

@@ -13,6 +13,8 @@ CHANGELOG
   * `ONEY`
   * `POSCONNECT`
 * Added new type to the `Event.Type` enum: `PAYOUT_CHANGE`
+* Added support for new Device output:
+  * `/device/local_time`
 
 1.8.0 (2018-01-19)
 ------------------

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

@@ -17,19 +17,32 @@ public final class Device extends AbstractModel {
     private final Double confidence;
     private final UUID id;
     private final String lastSeen;
+    private final String localTime;
+
+    // This method is for backwards compatibility. We should remove it when we
+    // do a major release.
+    public Device(
+            Double confidence,
+            UUID id,
+            String lastSeen
+    ) {
+        this(confidence, id, lastSeen, null);
+    }
 
     public Device(
             @JsonProperty("confidence") Double confidence,
             @JsonProperty("id") UUID id,
-            @JsonProperty("last_seen") String lastSeen
+            @JsonProperty("last_seen") String lastSeen,
+            @JsonProperty("local_time") String localTime
     ) {
         this.confidence = confidence;
         this.id = id;
         this.lastSeen = lastSeen;
+        this.localTime = localTime;
     }
 
     public Device() {
-        this(null, null, null);
+        this(null, null, null, null);
     }
 
     /**
@@ -59,4 +72,13 @@ public UUID getId() {
     public String getLastSeen() {
         return lastSeen;
     }
+
+    /**
+     * @return The date and time of the transaction at the UTC offset
+     * associated with the device. This is an RFC 3339 date-time.
+     */
+    @JsonProperty("local_time")
+    public String getLocalTime() {
+        return localTime;
+    }
 }

src/test/java/com/maxmind/minfraud/WebServiceClientTest.java

@@ -22,6 +22,7 @@
 import static com.jcabi.matchers.RegexMatchers.matchesPattern;
 import static com.maxmind.minfraud.request.RequestTestHelper.*;
 import static org.hamcrest.core.StringStartsWith.startsWith;
+import static org.junit.Assert.assertEquals;
 import static org.junit.Assert.assertFalse;
 import static org.junit.Assert.assertTrue;
 
@@ -79,6 +80,8 @@ public void testFullInsightsTransaction() throws Exception {
             assertTrue(
                     "response.getIpAddress().getRepresentedCountry().isInEuropeanUnion() does not return true",
                     response.getIpAddress().getRepresentedCountry().isInEuropeanUnion());
+            assertEquals(response.getDevice().getLocalTime(),
+                    "2018-04-05T15:34:40-07:00");
         }
     }
 

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

@@ -19,12 +19,14 @@ public void testDevice() throws Exception {
                         .put("confidence", 99)
                         .put("id", "C8D3BE1A-BE26-11E5-8C50-1B575C37265F")
                         .put("last_seen", "2016-06-08T14:16:38Z")
+                        .put("local_time", "2018-04-05T15:21:00-07:00")
                         .end()
                         .finish()
         );
 
         assertEquals(99.0, device.getConfidence(), 1e-15);
         assertEquals(UUID.fromString("C8D3BE1A-BE26-11E5-8C50-1B575C37265F"), device.getId());
         assertEquals("2016-06-08T14:16:38Z", device.getLastSeen());
+        assertEquals("2018-04-05T15:21:00-07:00", device.getLocalTime());
     }
 }

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

@@ -135,7 +135,8 @@
   "device": {
     "confidence": 99,
     "id": "7835b099-d385-4e5b-969e-7df26181d73b",
-    "last_seen": "2016-06-08T14:16:38Z"
+    "last_seen": "2016-06-08T14:16:38Z",
+    "local_time": "2018-04-05T15:34:40-07:00"
   },
   "disposition": {
     "action": "reject",