Adkernel Bid Adapter: DSA support

modules/adkernelBidAdapter.js

@@ -29,6 +29,7 @@
  * @typedef {import('../src/adapters/bidderFactory.js').Bid} Bid
  * @typedef {import('../src/adapters/bidderFactory.js').ServerRequest} ServerRequest
  * @typedef {import('../src/adapters/bidderFactory.js').UserSync} UserSync
+ * @typedef {import('../src/types/ortb/ext/dsa.d.ts').DSARequest} DSARequest
  */
 
 const VIDEO_PARAMS = ['pos', 'context', 'placement', 'plcmt', 'api', 'mimes', 'protocols', 'playbackmethod', 'minduration', 'maxduration',
@@ -124,9 +125,10 @@
       'zoneId' in bidRequest.params &&
       !isNaN(Number(bidRequest.params.zoneId)) &&
       bidRequest.params.zoneId > 0 &&
-      bidRequest.mediaTypes &&
-      (bidRequest.mediaTypes.banner || bidRequest.mediaTypes.video ||
-        (bidRequest.mediaTypes.native && validateNativeAdUnit(bidRequest.mediaTypes.native))
+      (
+        isPlainObject(bidRequest?.mediaTypes?.banner) ||
+        isPlainObject(bidRequest?.mediaTypes?.video) ||
+        (isPlainObject(bidRequest?.mediaTypes?.native) && validateNativeAdUnit(bidRequest.mediaTypes.native))
       );
   },
 
@@ -224,6 +226,9 @@
         if (isStr(rtbBid.ext.agency_name)) {
           deepSetValue(prBid, 'meta.agencyName', rtbBid.ext.agency_name);
         }
+        if (isPlainObject(rtbBid.ext.dsa)) {
+          deepSetValue(prBid, 'meta.dsa', rtbBid.ext.dsa);
+        }
       }
 
       return prBid;
@@ -332,9 +337,9 @@
     if (pbVideo.playerSize) {
       sizes = pbVideo.playerSize[0];
       typedImp.video = Object.assign(typedImp.video, parseGPTSingleSizeArrayToRtbSize(sizes) || {});
     } else if (pbVideo.w && pbVideo.h) {
       typedImp.video.w = pbVideo.w;
       typedImp.video.h = pbVideo.h;
     }
     initImpBidfloor(typedImp, bidRequest, sizes, isMultiformat ? '*' : VIDEO);
     result.push(typedImp);
@@ -342,8 +347,8 @@
 
   if (mediaTypes?.native) {
     if (isMultiformat) {
       typedImp = { ...imp };
       typedImp.id = typedImp.id + MULTI_FORMAT_SUFFIX_NATIVE;
     } else {
       typedImp = imp;
     }
@@ -431,7 +436,7 @@
   if (isEmpty(appConfig)) {
     return { site: createSite(refererInfo, fpd) };
   } else {
     return { app: appConfig };
   }
 }
 
@@ -499,10 +504,10 @@
     'tmax': parseInt(bidderRequest.timeout)
   };
   if (!isEmpty(fpd.bcat)) {
     request.bcat = fpd.bcat;
   }
   if (!isEmpty(fpd.badv)) {
     request.badv = fpd.badv;
   }
   return request;
 }
@@ -521,6 +526,42 @@
   }
 }
 
+/**
+ * Initialize DSA request
+ * @param fpd {Object}
+ */
+function makeDSARequest(fpd) {
+  /**
+   * @type {DSARequest}
+   */
+  const pubDsa = fpd?.regs?.ext?.dsa;
+  if (!isPlainObject(pubDsa)) {
+    return;
+  }
+  const dsaObj = {};
+  ['dsarequired', 'pubrender', 'datatopub'].forEach((dsaKey) => {
+    if (isNumber(pubDsa[dsaKey])) {
+      dsaObj[dsaKey] = pubDsa[dsaKey];
+    }
+  });
+  if (isArray(pubDsa.transparency) && pubDsa.transparency.every((v) => isPlainObject(v))) {
+    const tpData = [];
+    pubDsa.transparency.forEach((tpObj) => {
+      if (isStr(tpObj.domain) && tpObj.domain !== '' && isArray(tpObj.dsaparams) && tpObj.dsaparams.every((v) => isNumber(v))) {
+        tpData.push(tpObj);
+      }
+    });
+    if (tpData.length > 0) {
+      dsaObj.transparency = tpData;
+    }
+  }
+  if (!isEmpty(dsaObj)) {
+    let res = {};
+    deepSetValue(res, 'regs.ext.dsa', dsaObj);
+    return res;
+  }
+}
+
 /**
  * Builds complete rtb request
  * @param imps {Object} Collection of rtb impressions
@@ -537,10 +578,11 @@
     makeSiteOrApp(bidderRequest, fpd),
     makeUser(bidderRequest, fpd),
     makeRegulations(bidderRequest),
-    makeSyncInfo(bidderRequest)
+    makeSyncInfo(bidderRequest),
+    makeDSARequest(fpd)
   );
   if (schain) {
     deepSetValue(req, 'source.ext.schain', schain);
   }
   return req;
 }
@@ -564,7 +606,7 @@
   };
   mergeDeep(site, fpd.site);
   if (refInfo.ref != null) {
     site.ref = refInfo.ref;
   } else {
     delete site.ref;
   }
@@ -594,7 +636,7 @@
  * Basic validates to comply with platform requirements
  */
 function validateNativeAdUnit(adUnit) {
   return validateNativeImageSize(adUnit.image) && validateNativeImageSize(adUnit.icon) &&
     !deepAccess(adUnit, 'privacyLink.required') && // not supported yet
     !deepAccess(adUnit, 'privacyIcon.required'); // not supported yet
 }
@@ -603,11 +645,11 @@
  * Validates image asset size definition
  */
 function validateNativeImageSize(img) {
   if (!img) {
     return true;
   }
   if (img.sizes) {
     return isArrayOfNums(img.sizes, 2);
   }
   if (isArray(img.aspect_ratios)) {
     return img.aspect_ratios.length > 0 && img.aspect_ratios[0].min_height && img.aspect_ratios[0].min_width;