Kargo: Support for client hints (#9)

* Starting SUA support

* Kargo: Adding support for client hints

modules/kargoBidAdapter.js

@@ -1,4 +1,4 @@
-import { _each, buildUrl, triggerPixel } from '../src/utils.js';
+import { _each, buildUrl, deepAccess, pick, triggerPixel } from '../src/utils.js';
 import { config } from '../src/config.js';
 import { registerBidder } from '../src/adapters/bidderFactory.js';
 import { getStorageManager } from '../src/storageManager.js';
@@ -37,10 +37,9 @@ export const spec = {
       bidSizes[bid.bidId] = bid.sizes;
     });
 
-    let tdid;
-    if (validBidRequests.length > 0 && validBidRequests[0].userId && validBidRequests[0].userId.tdid) {
-      tdid = validBidRequests[0].userId.tdid;
-    }
+    const firstBidRequest = validBidRequests[0];
+
+    const tdid = deepAccess(firstBidRequest, 'userId.tdid')
 
     const transformedParams = Object.assign({}, {
       sessionId: spec._getSessionId(),
@@ -62,10 +61,17 @@ export const spec = {
       prebidRawBidRequests: validBidRequests
     }, spec._getAllMetadata(bidderRequest, tdid));
 
+    // User Agent Client Hints / SUA
+    const uaClientHints = deepAccess(firstBidRequest, 'ortb2.device.sua');
+    if (uaClientHints) {
+      transformedParams.device.sua = pick(uaClientHints, ['browsers', 'platform', 'model']);
+    }
+
     // Pull Social Canvas segments and embed URL
-    if (validBidRequests.length > 0 && validBidRequests[0].params.socialCanvas) {
-      transformedParams.socialCanvasSegments = validBidRequests[0].params.socialCanvas.segments;
-      transformedParams.socialEmbedURL = validBidRequests[0].params.socialCanvas.embedURL;
+    const socialCanvas = deepAccess(firstBidRequest, 'params.socialCanvas');
+    if (socialCanvas) {
+      transformedParams.socialCanvasSegments = socialCanvas.segments;
+      transformedParams.socialEmbedURL = socialCanvas.embedURL;
     }
 
     const encodedParams = encodeURIComponent(JSON.stringify(transformedParams));