mk9-prebid/modules/merkleIdSystem.js

Header Bidding Management Library

/**
 * This module adds merkleId to the User ID module
 * The {@link module:modules/userId} module is required
 * @module modules/merkleIdSystem
 * @requires module:modules/userId
 */

import * as utils from '../src/utils.js'
import {ajax} from '../src/ajax.js';
import {submodule} from '../src/hook.js'
import {getStorageManager} from '../src/storageManager.js';

const MODULE_NAME = 'merkleId';
const ID_URL = 'https://id2.sv.rkdms.com/identity/';
const DEFAULT_REFRESH = 7 * 3600;
const SESSION_COOKIE_NAME = '_svsid';

export const storage = getStorageManager();

function getSession(configParams) {
  let session = null;
  if (typeof configParams.sv_session === 'string') {
    session = configParams.sv_session;
  } else {
    session = storage.getCookie(SESSION_COOKIE_NAME);
  }
  return session;
}

function setCookie(name, value, expires) {
  let expTime = new Date();
  expTime.setTime(expTime.getTime() + expires * 1000 * 60);
  storage.setCookie(name, value, expTime.toUTCString());
}

function setSession(storage, response) {
  utils.logInfo('Merkle setting session ');
  if (response && response.c && response.c.value && typeof response.c.value === 'string') {
    setCookie(SESSION_COOKIE_NAME, response.c.value, storage.expires);
  }
}

function constructUrl(configParams) {
  const session = getSession(configParams);
  let url = ID_URL + `?vendor=${configParams.vendor}&sv_cid=${configParams.sv_cid}&sv_domain=${configParams.sv_domain}&sv_pubid=${configParams.sv_pubid}`;
  if (session) {
    url = `${url}&sv_session=${session}`;
  }
  utils.logInfo('Merkle url :' + url);
  return url;
}

function generateId(configParams, configStorage) {
  const url = constructUrl(configParams);

  const resp = function (callback) {
    const callbacks = {
      success: response => {
        let responseObj;
        if (response) {
          try {
            responseObj = JSON.parse(response);
            setSession(configStorage, responseObj)
            utils.logInfo('Merkle responseObj ' + JSON.stringify(responseObj));
          } catch (error) {
            utils.logError(error);
          }
        }

        const date = new Date().toUTCString();
        responseObj.date = date;
        utils.logInfo('Merkle responseObj with date ' + JSON.stringify(responseObj));
        callback(responseObj);
      },
      error: error => {
        utils.logError(`${MODULE_NAME}: merkleId fetch encountered an error`, error);
        callback();
      }
    };
    ajax(url, callbacks, undefined, {method: 'GET', withCredentials: true});
  };
  return resp;
}

/** @type {Submodule} */
export const merkleIdSubmodule = {
  /**
   * used to link submodule with config
   * @type {string}
   */
  name: MODULE_NAME,
  /**
   * decode the stored id value for passing to bid requests
   * @function
   * @param {string} value
   * @returns {{merkleId:string}}
   */
  decode(value) {
    const id = (value && value.pam_id && typeof value.pam_id.id === 'string') ? value.pam_id : undefined;
    utils.logInfo('Merkle id ' + JSON.stringify(id));
    return id ? {'merkleId': id} : undefined;
  },
  /**
   * performs action to obtain id and return a value in the callback's response argument
   * @function
   * @param {SubmoduleConfig} [config]
   * @param {ConsentData} [consentData]
   * @returns {IdResponse|undefined}
   */
  getId(config, consentData) {
    utils.logInfo('User ID - merkleId generating id');

    const configParams = (config && config.params) || {};

    if (!configParams || typeof configParams.vendor !== 'string') {
      utils.logError('User ID - merkleId submodule requires a valid vendor to be defined');
      return;
    }

    if (typeof configParams.sv_cid !== 'string') {
      utils.logError('User ID - merkleId submodule requires a valid sv_cid string to be defined');
      return;
    }

    if (typeof configParams.sv_pubid !== 'string') {
      utils.logError('User ID - merkleId submodule requires a valid sv_pubid string to be defined');
      return;
    }
    if (consentData && typeof consentData.gdprApplies === 'boolean' && consentData.gdprApplies) {
      utils.logError('User ID - merkleId submodule does not currently handle consent strings');
      return;
    }

    if (typeof configParams.sv_domain !== 'string') {
      configParams.sv_domain = merkleIdSubmodule.findRootDomain();
    }

    const configStorage = (config && config.storage) || {};
    const resp = generateId(configParams, configStorage)
    return {callback: resp};
  },
  extendId: function (config = {}, consentData, storedId) {
    utils.logInfo('User ID - merkleId stored id ' + storedId);
    const configParams = (config && config.params) || {};

    if (consentData && typeof consentData.gdprApplies === 'boolean' && consentData.gdprApplies) {
      utils.logError('User ID - merkleId submodule does not currently handle consent strings');
      return;
    }

    if (typeof configParams.sv_domain !== 'string') {
      configParams.sv_domain = merkleIdSubmodule.findRootDomain();
    }
    const configStorage = (config && config.storage) || {};
    if (configStorage && configStorage.refreshInSeconds && typeof configParams.refreshInSeconds === 'number') {
      return {id: storedId};
    }
    let refreshInSeconds = DEFAULT_REFRESH;
    if (configParams && configParams.refreshInSeconds && typeof configParams.refreshInSeconds === 'number') {
      refreshInSeconds = configParams.refreshInSeconds;
      utils.logInfo('User ID - merkleId param refreshInSeconds' + refreshInSeconds);
    }
    const storedDate = new Date(storedId.date);
    let refreshNeeded = false;
    if (storedDate) {
      refreshNeeded = storedDate && (Date.now() - storedDate.getTime() > refreshInSeconds * 1000);
      if (refreshNeeded) {
        utils.logInfo('User ID - merkleId needs refreshing id');
        const resp = generateId(configParams, configStorage)
        return {callback: resp};
      }
    }
    utils.logInfo('User ID - merkleId not refreshed');
    return {id: storedId};
  }

};

submodule('userId', merkleIdSubmodule);