Initial checkin with submodule support for DigiTrust.

modules/digiTrustIdSystem.js

@@ -0,0 +1,225 @@
+/**
+ * This module adds DigiTrust ID support to the User ID module
+ * The {@link module:modules/userId} module is required
+ * If the full DigiTrust Id library is included the standard functions
+ * will be invoked to obtain the user's DigiTrust Id.
+ * When the full library is not included this will fall back to the
+ * DigiTrust Identity API and generate a mock DigiTrust object.
+ * @module modules/digiTrustIdSystem
+ * @requires module:modules/userId
+ */
+
+import { config } from 'src/config';
+import * as utils from '../src/utils'
+import { ajax } from 'src/ajax';
+import { getGlobal } from 'src/prebidGlobal';
+
+/**
+ * Checks to see if the DigiTrust framework is initialized.
+ * @function
+ */
+function isInitialized() {
+  if (window.DigiTrust == null) {
+    return false;
+  }
+  return DigiTrust.isClient; // this is set to true after init
+}
+
+let retries = 0;
+let retryId = 0;
+var isMock = false;
+var noop = function () {
+};
+
+const MAX_RETRIES = 4;
+const DT_ID_SVC = 'https://cdn-cf.digitru.st/id/v1';
+
+var isFunc = function (fn) {
+  return typeof (fn) === 'function';
+}
+
+function callApi(options) {
+  ajax(
+    DT_ID_SVC,
+    {
+      success: options.success,
+      error: options.fail
+    },
+    null,
+    {
+      method: 'GET'
+    }
+  );
+}
+
+/**
+ * Encode the Id per DigiTrust lib
+ * @param {any} id
+ */
+function encId(id) {
+  try {
+    if (typeof (id) !== 'string') {
+      id = JSON.stringify(id);
+    }
+    return encodeURIComponent(btoa(id));
+  } catch (ex) {
+    return id;
+  }
+}
+
+/**
+ * Writes the Identity into the expected DigiTrust cookie
+ * @param {any} id
+ */
+function writeDigiId(id) {
+  var key = 'DigiTrust.v1.identity';
+  var date = new Date();
+  date.setTime(date.getTime() + 604800000);
+  var exp = 'expires=' + date.toUTCString();
+  document.cookie = key + '=' + encId(id) + '; ' + exp + '; path=/;';
+}
+
+/**
+ * Set up a mock DigiTrust object
+ *
+ */
+function initMockDigitrust() {
+  isMock = true;
+  var _savedId = null; // closure variable for storing Id to avoid additional requests
+  var mock = {
+    isClient: true,
+    isMock: true,
+    getUser: function (obj, callback) {
+      var cb = callback || noop;
+      if (_savedId != null) {
+        cb(_savedId);
+        return;
+      }
+
+      var opts = {
+        success: function (respText, result) {
+          var idResult = {
+            success: true
+          }
+          try {
+            writeDigiId(respText);
+            idResult.identity = JSON.parse(respText);
+            _savedId = idResult;
+          } catch (ex) {
+            idResult.success = false;
+          }
+          cb(idResult);
+        },
+        fail: function (statusErr, result) {
+          utils.logError('DigiTrustId API error: ' + statusErr);
+        }
+      }
+
+      callApi(opts);
+    }
+  }
+
+  if (window) {
+    window.DigiTrust = mock;
+  }
+}
+
+/*
+ * Internal implementation to get the Id and trigger callback
+ */
+function getDigiTrustId(data, consentData, syncDelay, callback) {
+  if (!isInitialized()) {
+    if (retries >= MAX_RETRIES) {
+      utils.logInfo('DigiTrust framework timeout. Fallback to API and mock.');
+      initMockDigitrust();
+    } else {
+      // use expanding envelope
+      if (retryId != 0) {
+        clearTimeout(retryId);
+      }
+
+      retryId = setTimeout(function () {
+        getDigiTrustId(data, consentData, syncDelay, callback);
+      }, 100 * (1 + retries++));
+      return;
+    }
+  }
+
+  var executeIdRequest = function (data, callback) {
+    DigiTrust.getUser({ member: 'prebid' }, function (idResult) {
+      var exp = (data && data.storage && data.storage.expires) || 60;
+      var rslt = {
+        data: null,
+        expires: exp
+      };
+      if (idResult && idResult.success && idResult.identity) {
+        if (isMock) {
+          // plug in the mock ID
+        }
+
+        if (isFunc(callback)) {
+          rslt.data = idResult.identity;
+          callback(rslt);
+        }
+      } else {
+        // failed
+        if (isFunc(callback)) {
+          rslt.err = 'Failure getting id';
+          callback(rslt);
+        }
+      }
+    });
+  }
+
+  executeIdRequest(data, callback);
+}
+
+function initializeDigiTrust(config) {
+  var dt = window.DigiTrust;
+  if (dt && !dt.isClient && config != null) {
+    dt.initialize(config.init, config.callback);
+  } else if (dt == null) {
+    // Assume we are already on a delay and DigiTrust is not on page
+    initMockDigitrust();
+  }
+}
+
+var testHook = {};
+
+/**
+ * Exposes the test hook object by attaching to the digitrustIdModule.
+ * This method is called in the unit tests to surface internals.
+ */
+function surfaceTestHook() {
+  digitrustIdModule['_testHook'] = testHook;
+}
+
+testHook.exposeLoader = exposeLoader;
+testHook.initMockDigitrust = initMockDigitrust;
+
+
+
+/** @type {Submodule} */
+export const digiTrustIdSubmodule = {
+  /**
+   * used to link submodule with config
+   * @type {string}
+   */
+  name: 'digiTrust',
+  /**
+   * decode the stored id value for passing to bid requests
+   * @function
+   * @param {string} value
+   * @returns {{pubcid:string}}
+   */
+  decode: function (idData) {
+    try {
+      return { 'digitrustid': idData };
+    } catch (e) {
+      utils.logError('DigiTrust ID submodule decode error');
+    }
+  },
+  getId: getDigiTrustId,
+  init: initializeDigiTrust,
+  _testInit: surfaceTestHook
+};

modules/digiTrustIdSystem.md

@@ -0,0 +1,74 @@
+## DigiTrust Universal Id Integration
+
+Setup
+-----
+The DigiTrust Id integration for Prebid may be used with or without the full
+DigiTrust library. This is an optional module that must be used in conjunction
+with the userId module.
+
+The full DigiTrust integration requires the DigiTrust package be included.
+DigiTrust may be initialized in the standard manner or through the params
+object. 
+
+You can use npm or reference the script on the cdn.
+
+npm install digitrust
+
+or
+
+<script src="https://cdn.digitru.st/prod/1.5.20/digitrust.min.js"></script>
+
+Please note that version 1.5.20 or better is required.
+
+
+See the [Prebid Integration Guide for DigiTrust](https://github.com/digi-trust/dt-cdn/wiki/Prebid-Integration-for-DigiTrust-Id)
+and the [DigiTrust wiki](https://github.com/digi-trust/dt-cdn/wiki)
+for further instructions.
+
+
+## Example Prebid Configuration for Digitrust Id
+```
+        pbjs.que.push(function() {
+            pbjs.setConfig({
+                usersync: {
+                    userIds: [{
+						name: "digitrust",
+						params: {
+							init: {
+								member: 'example_member_id',
+								site: 'example_site_id'
+							},
+							callback: function (digiTrustResult) {
+								if (digiTrustResult.success) {
+									console.log('Success in Digitrust init');
+									if (digiTrustResult.identity && digiTrustResult.identity.id != null) {
+										console.log('DigiTrust Id (encrypted): ' + digiTrustResult.identity.id);
+									}
+									else {
+										console.error('Digitrust gave success, but no identity returned');
+									}
+								}
+								else {
+									console.error('Digitrust init failed');
+								}
+							}
+						},
+						storage: {
+							type: "html5",
+							name: "pbjsdigitrust",
+							expires: 60
+						}
+					}]
+                }
+            });
+            pbjs.addAdUnits(adUnits);
+            pbjs.requestBids({
+                bidsBackHandler: sendAdserverRequest
+            });
+        });
+
+```
+
+
+
+