prebid.js 5.14.0 → 5.18.0

package/modules/criteoBidAdapter.js

@@ -1,8 +1,8 @@
+import { isArray, getUniqueIdentifierStr, parseUrl, deepAccess, logWarn, logError, logInfo } from '../src/utils.js';
 import {loadExternalScript} from '../src/adloader.js';
 import {registerBidder} from '../src/adapters/bidderFactory.js';
 import {config} from '../src/config.js';
 import {BANNER, NATIVE, VIDEO} from '../src/mediaTypes.js';
-import * as utils from '../src/utils.js';
 import find from 'core-js-pure/features/array/find.js';
 import { verify } from 'criteo-direct-rsa-validate/build/verify.js'; // ref#2
 import { getStorageManager } from '../src/storageManager.js';
@@ -123,13 +123,13 @@ export const spec = {
 
     const bids = [];
 
-    if (body && body.slots && utils.isArray(body.slots)) {
+    if (body && body.slots && isArray(body.slots)) {
       body.slots.forEach(slot => {
         const bidRequest = find(request.bidRequests, b => b.adUnitCode === slot.impid && (!b.params.zoneId || parseInt(b.params.zoneId) === slot.zoneid));
         const bidId = bidRequest.bidId;
         const bid = {
           requestId: bidId,
-          adId: slot.bidId || utils.getUniqueIdentifierStr(),
+          adId: slot.bidId || getUniqueIdentifierStr(),
           cpm: slot.cpm,
           currency: slot.currency,
           netRevenue: true,
@@ -219,7 +219,7 @@ function buildContext(bidRequests, bidderRequest) {
   if (bidderRequest && bidderRequest.refererInfo) {
     referrer = bidderRequest.refererInfo.referer;
   }
-  const queryString = utils.parseUrl(referrer).search;
+  const queryString = parseUrl(referrer).search;
 
   const context = {
     url: referrer,
@@ -296,7 +296,7 @@ function buildCdbRequest(context, bidRequests, bidderRequest) {
       if (bidRequest.params.zoneId) {
         slot.zoneid = bidRequest.params.zoneId;
       }
-      if (utils.deepAccess(bidRequest, 'ortb2Imp.ext')) {
+      if (deepAccess(bidRequest, 'ortb2Imp.ext')) {
         slot.ext = bidRequest.ortb2Imp.ext;
       }
       if (bidRequest.params.ext) {
@@ -305,10 +305,10 @@ function buildCdbRequest(context, bidRequests, bidderRequest) {
       if (bidRequest.params.publisherSubId) {
         slot.publishersubid = bidRequest.params.publisherSubId;
       }
-      if (bidRequest.params.nativeCallback || utils.deepAccess(bidRequest, `mediaTypes.${NATIVE}`)) {
+      if (bidRequest.params.nativeCallback || deepAccess(bidRequest, `mediaTypes.${NATIVE}`)) {
         slot.native = true;
         if (!checkNativeSendId(bidRequest)) {
-          utils.logWarn(LOG_PREFIX + 'all native assets containing URL should be sent as placeholders with sendId(icon, image, clickUrl, displayUrl, privacyLink, privacyIcon)');
+          logWarn(LOG_PREFIX + 'all native assets containing URL should be sent as placeholders with sendId(icon, image, clickUrl, displayUrl, privacyLink, privacyIcon)');
         }
         slot.sizes = parseSizes(retrieveBannerSizes(bidRequest), parseNativeSize);
       } else {
@@ -316,7 +316,7 @@ function buildCdbRequest(context, bidRequests, bidderRequest) {
       }
       if (hasVideoMediaType(bidRequest)) {
         const video = {
-          playersizes: parseSizes(utils.deepAccess(bidRequest, 'mediaTypes.video.playerSize'), parseSize),
+          playersizes: parseSizes(deepAccess(bidRequest, 'mediaTypes.video.playerSize'), parseSize),
           mimes: bidRequest.mediaTypes.video.mimes,
           protocols: bidRequest.mediaTypes.video.protocols,
           maxduration: bidRequest.mediaTypes.video.maxduration,
@@ -367,7 +367,7 @@ function buildCdbRequest(context, bidRequests, bidderRequest) {
 }
 
 function retrieveBannerSizes(bidRequest) {
-  return utils.deepAccess(bidRequest, 'mediaTypes.banner.sizes') || bidRequest.sizes;
+  return deepAccess(bidRequest, 'mediaTypes.banner.sizes') || bidRequest.sizes;
 }
 
 function parseSizes(sizes, parser) {
@@ -389,7 +389,7 @@ function parseNativeSize(size) {
 }
 
 function hasVideoMediaType(bidRequest) {
-  return utils.deepAccess(bidRequest, 'mediaTypes.video') !== undefined;
+  return deepAccess(bidRequest, 'mediaTypes.video') !== undefined;
 }
 
 function hasValidVideoMediaType(bidRequest) {
@@ -398,9 +398,9 @@ function hasValidVideoMediaType(bidRequest) {
   var requiredMediaTypesParams = ['mimes', 'playerSize', 'maxduration', 'protocols', 'api', 'skip', 'placement', 'playbackmethod'];
 
   requiredMediaTypesParams.forEach(function(param) {
-    if (utils.deepAccess(bidRequest, 'mediaTypes.video.' + param) === undefined && utils.deepAccess(bidRequest, 'params.video.' + param) === undefined) {
+    if (deepAccess(bidRequest, 'mediaTypes.video.' + param) === undefined && deepAccess(bidRequest, 'params.video.' + param) === undefined) {
       isValid = false;
-      utils.logError('Criteo Bid Adapter: mediaTypes.video.' + param + ' is required');
+      logError('Criteo Bid Adapter: mediaTypes.video.' + param + ' is required');
     }
   });
 
@@ -476,7 +476,7 @@ export function getFastBidUrl(fastBidVersion) {
   } else if (fastBidVersion) {
     let majorVersion = String(fastBidVersion).split('.')[0];
     if (majorVersion < 102) {
-      utils.logWarn('Specifying a Fastbid version which is not supporting version selection.')
+      logWarn('Specifying a Fastbid version which is not supporting version selection.')
     }
     version = '.' + fastBidVersion;
   } else {
@@ -499,7 +499,7 @@ export function tryGetCriteoFastBid() {
       const firstLine = fastBidFromStorage.substr(0, firstLineEndPosition).trim();
 
       if (firstLine.substr(0, hashPrefix.length) !== hashPrefix) {
-        utils.logWarn('No hash found in FastBid');
+        logWarn('No hash found in FastBid');
         storage.removeDataFromLocalStorage(fastBidStorageKey);
       } else {
         // Remove the hash part from the locally stored value
@@ -507,10 +507,10 @@ export function tryGetCriteoFastBid() {
         const publisherTag = fastBidFromStorage.substr(firstLineEndPosition + 1);
 
         if (verify(publisherTag, publisherTagHash, FAST_BID_PUBKEY_N, FAST_BID_PUBKEY_E)) {
-          utils.logInfo('Using Criteo FastBid');
+          logInfo('Using Criteo FastBid');
           eval(publisherTag); // eslint-disable-line no-eval
         } else {
-          utils.logWarn('Invalid Criteo FastBid found');
+          logWarn('Invalid Criteo FastBid found');
           storage.removeDataFromLocalStorage(fastBidStorageKey);
         }
       }

package/modules/criteoIdSystem.js

@@ -5,7 +5,7 @@
  * @requires module:modules/userId
  */
 
-import * as utils from '../src/utils.js'
+import { timestamp, parseUrl, triggerPixel, logError } from '../src/utils.js';
 import { ajax } from '../src/ajax.js';
 import { getRefererInfo } from '../src/refererDetection.js';
 import { submodule } from '../src/hook.js';
@@ -20,10 +20,10 @@ const bundleStorageKey = 'cto_bundle';
 const cookiesMaxAge = 13 * 30 * 24 * 60 * 60 * 1000;
 
 const pastDateString = new Date(0).toString();
-const expirationString = new Date(utils.timestamp() + cookiesMaxAge).toString();
+const expirationString = new Date(timestamp() + cookiesMaxAge).toString();
 
 function extractProtocolHost (url, returnOnlyHost = false) {
-  const parsedUrl = utils.parseUrl(url, {noDecodeWholeURL: true})
+  const parsedUrl = parseUrl(url, {noDecodeWholeURL: true})
   return returnOnlyHost
     ? `${parsedUrl.hostname}`
     : `${parsedUrl.protocol}://${parsedUrl.hostname}${parsedUrl.port ? ':' + parsedUrl.port : ''}/`;
@@ -87,7 +87,7 @@ function callCriteoUserSync(parsedCriteoData, gdprString, callback) {
       const jsonResponse = JSON.parse(response);
       if (jsonResponse.acwsUrl) {
         const urlsToCall = typeof jsonResponse.acwsUrl === 'string' ? [jsonResponse.acwsUrl] : jsonResponse.acwsUrl;
-        urlsToCall.forEach(url => utils.triggerPixel(url));
+        urlsToCall.forEach(url => triggerPixel(url));
       } else if (jsonResponse.bundle) {
         saveOnAllStorages(bundleStorageKey, jsonResponse.bundle);
       }
@@ -102,7 +102,7 @@ function callCriteoUserSync(parsedCriteoData, gdprString, callback) {
       }
     },
     error: error => {
-      utils.logError(`criteoIdSystem: unable to sync user id`, error);
+      logError(`criteoIdSystem: unable to sync user id`, error);
       callback();
     }
   };

package/modules/currency.js

@@ -1,8 +1,8 @@
+import { logInfo, logWarn, logError, logMessage } from '../src/utils.js';
 import { getGlobal } from '../src/prebidGlobal.js';
 import { createBid } from '../src/bidfactory.js';
 import { STATUS } from '../src/constants.json';
 import { ajax } from '../src/ajax.js';
-import * as utils from '../src/utils.js';
 import { config } from '../src/config.js';
 import { getHook } from '../src/hook.js';
 
@@ -70,11 +70,11 @@ export function setConfig(config) {
   }
 
   if (typeof config.adServerCurrency === 'string') {
-    utils.logInfo('enabling currency support', arguments);
+    logInfo('enabling currency support', arguments);
 
     adServerCurrency = config.adServerCurrency;
     if (config.conversionRateFile) {
-      utils.logInfo('currency using override conversionRateFile:', config.conversionRateFile);
+      logInfo('currency using override conversionRateFile:', config.conversionRateFile);
       url = config.conversionRateFile;
     }
 
@@ -99,7 +99,7 @@ export function setConfig(config) {
     initCurrency(url);
   } else {
     // currency support is disabled, setting defaults
-    utils.logInfo('disabling currency support');
+    logInfo('disabling currency support');
     resetCurrency();
   }
   if (typeof config.bidderCurrencyDefault === 'object') {
@@ -110,10 +110,10 @@ config.getConfig('currency', config => setConfig(config.currency));
 
 function errorSettingsRates(msg) {
   if (defaultRates) {
-    utils.logWarn(msg);
-    utils.logWarn('Currency failed loading rates, falling back to currency.defaultRates');
+    logWarn(msg);
+    logWarn('Currency failed loading rates, falling back to currency.defaultRates');
   } else {
-    utils.logError(msg);
+    logError(msg);
   }
 }
 
@@ -121,7 +121,7 @@ function initCurrency(url) {
   conversionCache = {};
   currencySupportEnabled = true;
 
-  utils.logInfo('Installing addBidResponse decorator for currency module', arguments);
+  logInfo('Installing addBidResponse decorator for currency module', arguments);
 
   // Adding conversion function to prebid global for external module and on page use
   getGlobal().convertCurrency = (cpm, fromCurrency, toCurrency) => parseFloat(cpm) * getCurrencyConversion(fromCurrency, toCurrency);
@@ -135,7 +135,7 @@ function initCurrency(url) {
         success: function (response) {
           try {
             currencyRates = JSON.parse(response);
-            utils.logInfo('currencyRates set to ' + JSON.stringify(currencyRates));
+            logInfo('currencyRates set to ' + JSON.stringify(currencyRates));
             currencyRatesLoaded = true;
             processBidResponseQueue();
           } catch (e) {
@@ -149,7 +149,7 @@ function initCurrency(url) {
 }
 
 function resetCurrency() {
-  utils.logInfo('Uninstalling addBidResponse decorator for currency module', arguments);
+  logInfo('Uninstalling addBidResponse decorator for currency module', arguments);
 
   getHook('addBidResponse').getHooks({hook: addBidResponseHook}).remove();
   delete getGlobal().convertCurrency;
@@ -172,7 +172,7 @@ export function addBidResponseHook(fn, adUnitCode, bid) {
   if (bidderCurrencyDefault[bidder]) {
     let currencyDefault = bidderCurrencyDefault[bidder];
     if (bid.currency && currencyDefault !== bid.currency) {
-      utils.logWarn(`Currency default '${bidder}: ${currencyDefault}' ignored. adapter specified '${bid.currency}'`);
+      logWarn(`Currency default '${bidder}: ${currencyDefault}' ignored. adapter specified '${bid.currency}'`);
     } else {
       bid.currency = currencyDefault;
     }
@@ -180,7 +180,7 @@ export function addBidResponseHook(fn, adUnitCode, bid) {
 
   // default to USD if currency not set
   if (!bid.currency) {
-    utils.logWarn('Currency not specified on bid.  Defaulted to "USD"');
+    logWarn('Currency not specified on bid.  Defaulted to "USD"');
     bid.currency = 'USD';
   }
 
@@ -218,7 +218,7 @@ function wrapFunction(fn, context, params) {
           bid.currency = adServerCurrency;
         }
       } catch (e) {
-        utils.logWarn('Returning NO_BID, getCurrencyConversion threw error: ', e);
+        logWarn('Returning NO_BID, getCurrencyConversion threw error: ', e);
         params[1] = createBid(STATUS.NO_BID, {
           bidder: bid.bidderCode || bid.bidder,
           bidId: bid.requestId
@@ -235,7 +235,7 @@ function getCurrencyConversion(fromCurrency, toCurrency = adServerCurrency) {
   let cacheKey = `${fromCurrency}->${toCurrency}`;
   if (cacheKey in conversionCache) {
     conversionRate = conversionCache[cacheKey];
-    utils.logMessage('Using conversionCache value ' + conversionRate + ' for ' + cacheKey);
+    logMessage('Using conversionCache value ' + conversionRate + ' for ' + cacheKey);
   } else if (currencySupportEnabled === false) {
     if (fromCurrency === 'USD') {
       conversionRate = 1;
@@ -253,7 +253,7 @@ function getCurrencyConversion(fromCurrency, toCurrency = adServerCurrency) {
         throw new Error('Specified adServerCurrency in config \'' + toCurrency + '\' not found in the currency rates file');
       }
       conversionRate = rates[toCurrency];
-      utils.logInfo('getCurrencyConversion using direct ' + fromCurrency + ' to ' + toCurrency + ' conversionRate ' + conversionRate);
+      logInfo('getCurrencyConversion using direct ' + fromCurrency + ' to ' + toCurrency + ' conversionRate ' + conversionRate);
     } else if (toCurrency in currencyRates.conversions) {
       // using reciprocal of conversion rate from toCurrency to fromCurrency
       rates = currencyRates.conversions[toCurrency];
@@ -262,7 +262,7 @@ function getCurrencyConversion(fromCurrency, toCurrency = adServerCurrency) {
         throw new Error('Specified fromCurrency \'' + fromCurrency + '\' not found in the currency rates file');
       }
       conversionRate = roundFloat(1 / rates[fromCurrency], CURRENCY_RATE_PRECISION);
-      utils.logInfo('getCurrencyConversion using reciprocal ' + fromCurrency + ' to ' + toCurrency + ' conversionRate ' + conversionRate);
+      logInfo('getCurrencyConversion using reciprocal ' + fromCurrency + ' to ' + toCurrency + ' conversionRate ' + conversionRate);
     } else {
       // first defined currency base used as intermediary
       var anyBaseCurrency = Object.keys(currencyRates.conversions)[0];
@@ -280,11 +280,11 @@ function getCurrencyConversion(fromCurrency, toCurrency = adServerCurrency) {
       var fromIntermediateConversionRate = currencyRates.conversions[anyBaseCurrency][toCurrency];
 
       conversionRate = roundFloat(toIntermediateConversionRate * fromIntermediateConversionRate, CURRENCY_RATE_PRECISION);
-      utils.logInfo('getCurrencyConversion using intermediate ' + fromCurrency + ' thru ' + anyBaseCurrency + ' to ' + toCurrency + ' conversionRate ' + conversionRate);
+      logInfo('getCurrencyConversion using intermediate ' + fromCurrency + ' thru ' + anyBaseCurrency + ' to ' + toCurrency + ' conversionRate ' + conversionRate);
     }
   }
   if (!(cacheKey in conversionCache)) {
-    utils.logMessage('Adding conversionCache value ' + conversionRate + ' for ' + cacheKey);
+    logMessage('Adding conversionCache value ' + conversionRate + ' for ' + cacheKey);
     conversionCache[cacheKey] = conversionRate;
   }
   return conversionRate;

package/modules/cwireBidAdapter.js

@@ -0,0 +1,272 @@
+import {registerBidder} from '../src/adapters/bidderFactory.js';
+import { getRefererInfo } from '../src/refererDetection.js';
+import { getStorageManager } from '../src/storageManager.js';
+import {BANNER, VIDEO} from '../src/mediaTypes.js';
+import { OUTSTREAM } from '../src/video.js';
+import {
+  isArray,
+  isNumber,
+  generateUUID,
+  parseSizesInput,
+  deepAccess,
+  getParameterByName,
+  getValue,
+  getBidIdParameter,
+  logError,
+  logWarn,
+} from '../src/utils.js';
+import { Renderer } from '../src/Renderer.js';
+import find from 'core-js-pure/features/array/find.js';
+
+// ------------------------------------
+const BIDDER_CODE = 'cwire';
+export const ENDPOINT_URL = 'https://embed.cwi.re/delivery/prebid';
+export const RENDERER_URL = 'https://cdn.cwi.re/prebid/renderer/LATEST/renderer.min.js';
+// ------------------------------------
+export const CW_PAGE_VIEW_ID = generateUUID();
+const LS_CWID_KEY = 'cw_cwid';
+const CW_GROUPS_QUERY = 'cwgroups';
+
+const storage = getStorageManager();
+
+/**
+ * ------------------------------------
+ * ------------------------------------
+ * @param bid
+ * @returns {Array<string>}
+ */
+export function getSlotSizes(bid) {
+  return parseSizesInput(getAllMediaSizes(bid));
+}
+
+/**
+ * ------------------------------------
+ * ------------------------------------
+ * @param bid
+ * @returns {*[]}
+ */
+export function getAllMediaSizes(bid) {
+  let playerSizes = deepAccess(bid, 'mediaTypes.video.playerSize');
+  let videoSizes = deepAccess(bid, 'mediaTypes.video.sizes');
+  let bannerSizes = deepAccess(bid, 'mediaTypes.banner.sizes');
+
+  const sizes = [];
+
+  if (isArray(playerSizes)) {
+    playerSizes.forEach((s) => {
+      sizes.push(s);
+    })
+  }
+
+  if (isArray(videoSizes)) {
+    videoSizes.forEach((s) => {
+      sizes.push(s);
+    })
+  }
+
+  if (isArray(bannerSizes)) {
+    bannerSizes.forEach((s) => {
+      sizes.push(s);
+    })
+  }
+  return sizes;
+}
+
+const getQueryVariable = (variable) => {
+  let value = getParameterByName(variable);
+  if (value === '') {
+    value = null;
+  }
+  return value;
+};
+
+/**
+ * ------------------------------------
+ * ------------------------------------
+ * @param validBidRequests
+ * @returns {*[]}
+ */
+export const mapSlotsData = function(validBidRequests) {
+  const slots = [];
+  validBidRequests.forEach(bid => {
+    const bidObj = {};
+    // get the pacement and page ids
+    let placementId = getValue(bid.params, 'placementId');
+    let pageId = getValue(bid.params, 'pageId');
+    let adUnitElementId = getValue(bid.params, 'adUnitElementId');
+    // get the rest of the auction/bid/transaction info
+    bidObj.auctionId = getBidIdParameter('auctionId', bid);
+    bidObj.adUnitCode = getBidIdParameter('adUnitCode', bid);
+    bidObj.adUnitElementId = adUnitElementId;
+    bidObj.bidId = getBidIdParameter('bidId', bid);
+    bidObj.bidderRequestId = getBidIdParameter('bidderRequestId', bid);
+    bidObj.placementId = placementId;
+    bidObj.pageId = pageId;
+    bidObj.mediaTypes = getBidIdParameter('mediaTypes', bid);
+    bidObj.transactionId = getBidIdParameter('transactionId', bid);
+    bidObj.sizes = getSlotSizes(bid);
+    slots.push(bidObj);
+  });
+
+  return slots;
+};
+
+export const spec = {
+  code: BIDDER_CODE,
+  supportedMediaTypes: [BANNER, VIDEO],
+  /**
+   * Determines whether or not the given bid request is valid.
+   *
+   * @param {BidRequest} bid The bid params to validate.
+   * @return boolean True if this is a valid bid, and false otherwise.
+   */
+  isBidRequestValid: function(bid) {
+    bid.params = bid.params || {};
+
+    // if ad unit elemt id not provided - use adUnitCode by default
+    if (!bid.params.adUnitElementId) {
+      bid.params.adUnitElementId = bid.code;
+    }
+
+    if (!bid.params.placementId || !isNumber(bid.params.placementId)) {
+      logError('placementId not provided or invalid');
+      return false;
+    }
+
+    if (!bid.params.pageId || !isNumber(bid.params.pageId)) {
+      logError('pageId not provided');
+      return false;
+    }
+
+    return true;
+  },
+
+  /**
+   * ------------------------------------
+   * Make a server request from the
+   * list of BidRequests.
+   * ------------------------------------
+   * @param {validBidRequests[]} - an array of bids
+   * @return ServerRequest Info describing the request to the server.
+   */
+  buildRequests: function(validBidRequests, bidderRequest) {
+    let slots = [];
+    let referer;
+    try {
+      referer = getRefererInfo().referer;
+      slots = mapSlotsData(validBidRequests);
+    } catch (e) {
+      logWarn(e);
+    }
+
+    let refgroups = [];
+
+    const rgQuery = getQueryVariable(CW_GROUPS_QUERY);
+    if (rgQuery !== null) {
+      refgroups = rgQuery.split(',');
+    }
+
+    const localStorageCWID = storage.localStorageIsEnabled() ? storage.getDataFromLocalStorage(LS_CWID_KEY) : null;
+
+    const payload = {
+      cwid: localStorageCWID,
+      refgroups,
+      slots: slots,
+      httpRef: referer || '',
+      pageViewId: CW_PAGE_VIEW_ID,
+    };
+
+    return {
+      method: 'POST',
+      url: ENDPOINT_URL,
+      data: payload
+    };
+  },
+
+  /**
+   * Unpack the response from the server into a list of bids.
+   *
+   * @param {ServerResponse} serverResponse A successful response from the server.
+   * @return {Bid[]} An array of bids which were nested inside the server.
+   */
+  interpretResponse: function(serverResponse, bidRequest) {
+    const bidResponses = [];
+
+    try {
+      if (typeof bidRequest.data === 'string') {
+        bidRequest.data = JSON.parse(bidRequest.data);
+      }
+      const serverBody = serverResponse.body;
+      serverBody.bids.forEach((br) => {
+        const bidReq = find(bidRequest.data.slots, bid => bid.bidId === br.requestId);
+
+        let mediaType = BANNER;
+
+        const bidResponse = {
+          requestId: br.requestId,
+          cpm: br.cpm,
+          bidderCode: BIDDER_CODE,
+          width: br.dimensions[0],
+          height: br.dimensions[1],
+          creativeId: br.creativeId,
+          currency: br.currency,
+          netRevenue: br.netRevenue,
+          ttl: br.ttl,
+          meta: {
+            advertiserDomains: br.adomains ? br.advertiserDomains : [],
+          },
+
+        };
+
+        // ------------------------------------
+        // IF BANNER
+        // ------------------------------------
+
+        if (deepAccess(bidReq, 'mediaTypes.banner')) {
+          bidResponse.ad = br.html;
+        }
+        // ------------------------------------
+        // IF VIDEO
+        // ------------------------------------
+        if (deepAccess(bidReq, 'mediaTypes.video')) {
+          mediaType = VIDEO;
+          bidResponse.vastXml = br.vastXml;
+          bidResponse.videoScript = br.html;
+          const mediaTypeContext = deepAccess(bidReq, 'mediaTypes.video.context');
+          if (mediaTypeContext === OUTSTREAM) {
+            const r = Renderer.install({
+              id: bidResponse.requestId,
+              adUnitCode: bidReq.adUnitCode,
+              url: RENDERER_URL,
+              loaded: false,
+              config: {
+                ...deepAccess(bidReq, 'mediaTypes.video'),
+                ...deepAccess(br, 'outstream', {})
+              }
+            });
+
+            // set renderer
+            try {
+              bidResponse.renderer = r;
+              bidResponse.renderer.setRender(function(bid) {
+                if (window.CWIRE && window.CWIRE.outstream) {
+                  window.CWIRE.outstream.renderAd(bid);
+                }
+              });
+            } catch (err) {
+              logWarn('Prebid Error calling setRender on newRenderer', err);
+            }
+          }
+        }
+
+        bidResponse.mediaType = mediaType;
+        bidResponses.push(bidResponse);
+      });
+    } catch (e) {
+      logWarn(e);
+    }
+
+    return bidResponses;
+  },
+}
+registerBidder(spec);

package/modules/cwireBidAdapter.md

@@ -0,0 +1,43 @@
+# Overview
+
+Module Name: C-WIRE Bid Adapter
+Module Type: Adagio Adapter
+Maintainer: dragan@cwire.ch
+
+## Description
+
+Connects to C-WIRE demand source to fetch bids.
+
+## Configuration
+
+
+Below, the list of C-WIRE params and where they can be set.
+
+| Param name | Global config | AdUnit config | Type | Required |
+| ---------- | ------------- | ------------- | ---- | ---------|
+| pageId |  | x | number | YES |
+| placementId |  | x | number | YES |
+| adUnitElementId |  | x | string | NO |
+
+### adUnit configuration
+
+```javascript
+var adUnits = [
+  {
+    code: 'target_div_id', // REQUIRED 
+    bids: [{
+      bidder: 'cwire',
+      mediaTypes: {
+        banner: {
+          sizes: [[1, 1]],
+        }
+      },
+      params: {
+        pageId: 1422,                 // required - number
+        placementId: 2211521,         // required - number
+        adUnitElementId: 'other_div', // optional, div id to write to, if not set it will default to ad unit code  
+      }
+    }]
+  }
+];
+```