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

Author: oalders

HISTORY.rst

@@ -5,6 +5,10 @@ History
 
 * Added the following new values to the ``/payment/processor`` validation:
   ``ebs``, ``hipay``, and ``lemon_way``.
+* Added the following new values to the ``/device`` validation:
+  ``session_age`` and ``session_id``.
+* Added the following new values to the ``/email`` validation:
+  ``first_seen``.
 
 1.3.2 (2016-12-08)
 ++++++++++++++++++

minfraud/models.py

@@ -295,6 +295,22 @@ class Device(object):
       This is the date and time of the last sighting of the device. This is an
       RFC 3339 date-time.
 
+      :type: str | None
+
+    .. attribute:: session_age
+
+      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.
+
+      :type: float | None
+
+    .. attribute:: session_id
+
+      A string up to 255 characters in length. This is an ID which uniquely
+      identifies a visitor's session on the site.
+
       :type: str | None
     """
 
@@ -303,6 +319,8 @@ class Device(object):
         'confidence': None,
         'id': None,
         'last_seen': None,
+        'session_age': None,
+        'session_id': None,
     }
 
 
@@ -341,6 +359,14 @@ class Disposition(object):
 class Email(object):
     """Information about the email address passed in the request.
 
+    .. attribute:: first_seen
+
+      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.
+
+      :type: str
+
     .. attribute:: is_free
 
       This field is true if MaxMind believes that this email is hosted by a
@@ -360,6 +386,7 @@ class Email(object):
 
     __slots__ = ()
     _fields = {
+        'first_seen': None,
         'is_free': None,
         'is_high_risk': None,
     }

tests/test_models.py

@@ -83,11 +83,15 @@ def test_credit_card(self):
     def test_device(self):
         id = 'b643d445-18b2-4b9d-bad4-c9c4366e402a'
         last_seen = '2016-06-08T14:16:38Z'
-        device = Device({'confidence': 99, 'id': id, 'last_seen': last_seen})
+        session_age = 3600
+        session_id = 'foobar'
+        device = Device({'confidence': 99, 'id': id, 'last_seen': last_seen, 'session_age': session_age, 'session_id': session_id })
 
         self.assertEqual(99, device.confidence)
         self.assertEqual(id, device.id)
         self.assertEqual(last_seen, device.last_seen)
+        self.assertEqual(session_age, device.session_age)
+        self.assertEqual(session_id, device.session_id)
 
     def test_disposition(self):
         disposition = Disposition({'action': 'accept', 'reason': 'default'})
@@ -96,8 +100,10 @@ def test_disposition(self):
         self.assertEqual('default', disposition.reason)
 
     def test_email(self):
-        email = Email({'is_free': True, 'is_high_risk': False})
+        first_seen = '2016-01-01';
+        email = Email({'first_seen': first_seen, 'is_free': True, 'is_high_risk': False})
 
+        self.assertEqual(first_seen, email.first_seen)
         self.assertEqual(True, email.is_free)
         self.assertEqual(False, email.is_high_risk)