Add tracking_token to Device request object

This adds the optional tracking_token attribute to the Device request
object for explicit device linking via the Device Tracking Add-on.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: oschwald

CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## v2.11.0
+
+* Added the `tracking_token` attribute to `Minfraud::Components::Device`.
+  This is the token generated by the
+  [Device Tracking Add-on](https://dev.maxmind.com/minfraud/track-devices)
+  for explicit device linking.
+
 ## v2.10.0
 
 * Added the processors `:banquest`, `:summit_payments`, and `:yaadpay` to

README.md

@@ -83,6 +83,7 @@ assessment = Minfraud::Assessments.new(
     accept_language: 'en-US,en;q=0.8',
     session_age:     3600.5,
     session_id:      'foo',
+    tracking_token:  'abc123',
     user_agent:      'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2272.89 Safari/537.36',
   },
   event: {

lib/minfraud/components/device.rb

@@ -40,6 +40,12 @@ class Device < Base
       # @return [String, nil]
       attr_accessor :session_id
 
+      # The token generated by the Device Tracking Add-on for explicit
+      # device linking.
+      #
+      # @return [String, nil]
+      attr_accessor :tracking_token
+
       # @param params [Hash] Hash of parameters. Each key/value should
       #   correspond to one of the available attributes.
       def initialize(params = {})
@@ -48,6 +54,7 @@ def initialize(params = {})
         @accept_language = params[:accept_language]
         @session_age     = params[:session_age]
         @session_id      = params[:session_id]
+        @tracking_token  = params[:tracking_token]
 
         validate
       end
@@ -62,6 +69,7 @@ def validate
         validate_string('accept_language', 255, @accept_language)
         validate_nonnegative_number('session_age', @session_age)
         validate_string('session_id', 255, @session_id)
+        validate_string('tracking_token', 255, @tracking_token)
       end
     end
   end

spec/components/device_spec.rb

@@ -59,5 +59,11 @@
         session_age: 100,
       )
     end
+
+    it 'does not raise an exception for a valid tracking_token' do
+      described_class.new(
+        tracking_token: 'abc123',
+      )
+    end
   end
 end