gameraRtdProvider.js

import { submodule } from '../src/hook.js';
import { getGlobal } from '../src/prebidGlobal.js';
import {
  isPlainObject,
  logError,
  mergeDeep,
  deepClone,
} from '../src/utils.js';

const MODULE_NAME = 'gamera';
const MODULE = `${MODULE_NAME}RtdProvider`;

/**
 * Initialize the Gamera RTD Module.
 * @param {Object} config
 * @param {Object} userConsent
 * @returns {boolean}
 */
function init(config, userConsent) {
  return true;
}

/**
 * Modify bid request data before auction
 * @param {Object} reqBidsConfigObj - The bid request config object
 * @param {function} callback - Callback function to execute after data handling
 * @param {Object} config - Module configuration
 * @param {Object} userConsent - User consent data
 */
function getBidRequestData(reqBidsConfigObj, callback, config, userConsent) {
  // Check if window.gamera.getPrebidSegments is available
  if (typeof window.gamera?.getPrebidSegments !== 'function') {
    window.gamera = window.gamera || {};
    window.gamera.cmd = window.gamera.cmd || [];
    window.gamera.cmd.push(function () {
      enrichAuction(reqBidsConfigObj, callback, config, userConsent);
    });
    return;
  }

  enrichAuction(reqBidsConfigObj, callback, config, userConsent);
}

/**
 * Enriches the auction with user and content segments from Gamera's on-page script
 * @param {Object} reqBidsConfigObj - The bid request config object
 * @param {Function} callback - Callback function to execute after data handling
 * @param {Object} config - Module configuration
 * @param {Object} userConsent - User consent data
 */
function enrichAuction(reqBidsConfigObj, callback, config, userConsent) {
  try {
    /**
     * @function external:"window.gamera".getPrebidSegments
     * @description Retrieves user and content segments from Gamera's on-page script
     * @param {Function|null} onSegmentsUpdateCallback - Callback for segment updates (not used here)
     * @param {Object} config - Module configuration
     * @param {Object} userConsent - User consent data
     * @returns {Object|undefined} segments - The targeting segments object containing:
     *   @property {Object} [user] - User-level attributes to merge into ortb2.user
     *   @property {Object} [site] - Site-level attributes to merge into ortb2.site
     *   @property {Object.<string, Object>} [adUnits] - Ad unit specific attributes, keyed by adUnitCode,
     *                                                   to merge into each ad unit's ortb2Imp
     */
    const segments = window.gamera.getPrebidSegments(null, deepClone(config || {}), deepClone(userConsent || {})) || {};

    // Initialize ortb2Fragments and its nested objects
    reqBidsConfigObj.ortb2Fragments = reqBidsConfigObj.ortb2Fragments || {};
    reqBidsConfigObj.ortb2Fragments.global = reqBidsConfigObj.ortb2Fragments.global || {};

    // Add user-level data
    if (segments.user && isPlainObject(segments.user)) {
      reqBidsConfigObj.ortb2Fragments.global.user = reqBidsConfigObj.ortb2Fragments.global.user || {};
      mergeDeep(reqBidsConfigObj.ortb2Fragments.global.user, segments.user);
    }

    // Add site-level data
    if (segments.site && isPlainObject(segments.site)) {
      reqBidsConfigObj.ortb2Fragments.global.site = reqBidsConfigObj.ortb2Fragments.global.site || {};
      mergeDeep(reqBidsConfigObj.ortb2Fragments.global.site, segments.site);
    }

    // Add adUnit-level data
    const adUnits = reqBidsConfigObj.adUnits || getGlobal().adUnits || [];
    adUnits.forEach(adUnit => {
      const gameraData = segments.adUnits && segments.adUnits[adUnit.code];
      if (!gameraData || !isPlainObject(gameraData)) {
        return;
      }

      adUnit.ortb2Imp = adUnit.ortb2Imp || {};
      mergeDeep(adUnit.ortb2Imp, gameraData);
    });
  } catch (error) {
    logError(MODULE, 'Error getting segments:', error);
  }

  callback();
}

export const subModuleObj = {
  name: MODULE_NAME,
  init: init,
  getBidRequestData: getBidRequestData,
};

submodule('realTimeData', subModuleObj);