@streamlayer/feature-advertisement 1.1.1-rc.8.pd3aefe41 → 1.2.0

package/lib/classic/cjs/units/external-ad.js

@@ -1,500 +0,0 @@
-'use strict';
-
-var _rollupPluginBabelHelpers = require('../_virtual/_rollupPluginBabelHelpers.js');
-require('core-js/modules/es.symbol.description.js');
-require('core-js/modules/es.error.cause.js');
-require('core-js/modules/es.array.iterator.js');
-require('core-js/modules/es.array.reduce.js');
-require('core-js/modules/es.array.sort.js');
-require('core-js/modules/es.json.stringify.js');
-require('core-js/modules/es.promise.js');
-require('core-js/modules/es.regexp.exec.js');
-require('core-js/modules/es.string.replace.js');
-require('core-js/modules/es.string.replace-all.js');
-require('core-js/modules/esnext.iterator.constructor.js');
-require('core-js/modules/esnext.iterator.filter.js');
-require('core-js/modules/esnext.iterator.find.js');
-require('core-js/modules/esnext.iterator.map.js');
-require('core-js/modules/esnext.iterator.reduce.js');
-require('core-js/modules/web.dom-collections.iterator.js');
-require('core-js/modules/web.url.js');
-require('core-js/modules/web.url.to-json.js');
-require('core-js/modules/web.url-search-params.js');
-require('core-js/modules/web.url-search-params.delete.js');
-require('core-js/modules/web.url-search-params.has.js');
-require('core-js/modules/web.url-search-params.size.js');
-var classic = require('@streamlayer/sdk-web-logger/classic');
-var vastClient = require('@dailymotion/vast-client');
-require('@streamlayer/sdk-web-api/classic');
-var VMAP = require('vmap');
-var gam = require('./gam.js');
-var parseVastExtensions = require('./parse-vast-extensions.js');
-var sponsorLogo = require('./sponsor-logo.js');
-
-function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
-
-var VMAP__default = /*#__PURE__*/_interopDefault(VMAP);
-
-const log = classic.createLogger('ui:gam-external-ad');
-/** Default budget for a single VAST resolution before it is treated as "no ad". */
-const VAST_FETCH_TIMEOUT_MS = 10000;
-/**
- * Resolve `promise`, but fall back to `undefined` if it doesn't settle within `ms`.
- * A slow/unreachable VAST endpoint must degrade to "no ad" instead of leaving the
- * fetcher (and the sidebar) stuck waiting. Uses a timer rather than `AbortController`
- * so it stays safe on the ES5/Chrome-32 target.
- */
-const withTimeout = (promise, ms) => {
-  return Promise.race([promise, new Promise(resolve => {
-    setTimeout(() => resolve(undefined), ms);
-  })]);
-};
-// const preloadImage = (src: string) => {
-//   return new Promise((resolve, reject) => {
-//     const image = new Image()
-//     image.onload = () => resolve(src)
-//     image.onerror = () => reject()
-//     image.src = src
-//   })
-// }
-/**
- * Get the first valid creative from an ad
- */
-const getCreative = ad => {
-  return ad.creatives.find(creative => getMediaFileUrl(creative));
-};
-/**
- * Get the URL of the first media file in the creative
- */
-const getMediaFileUrl = creative => {
-  var _mediaFiles$find;
-  const mediaFiles = creative === null || creative === void 0 ? void 0 : creative.mediaFiles;
-  if (!(mediaFiles !== null && mediaFiles !== void 0 && mediaFiles.length)) {
-    return '';
-  }
-  return ((_mediaFiles$find = mediaFiles.find(mediaFile => mediaFile.fileURL)) === null || _mediaFiles$find === void 0 ? void 0 : _mediaFiles$find.fileURL) || '';
-};
-/**
- * Extract the linear creative's `<ClickThrough>` URL. Sources the sidebar CTA (QR code
- * + click-through). `videoClickThroughURLTemplate` isn't strongly typed in the client lib.
- */
-const getClickThrough = creative => {
-  var _creative$videoClickT;
-  // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-  // @ts-ignore — vast-client types `videoClickThroughURLTemplate` loosely
-  return (creative === null || creative === void 0 || (_creative$videoClickT = creative.videoClickThroughURLTemplate) === null || _creative$videoClickT === void 0 ? void 0 : _creative$videoClickT.url) || undefined;
-};
-/** Product companion mapping: the 300x75 companion is the logo, the banner-sized one the media. */
-const LOGO_COMPANION_WIDTH = 300;
-const LOGO_COMPANION_HEIGHT = 75;
-const isLogoSized = companion => (companion === null || companion === void 0 ? void 0 : companion.width) === LOGO_COMPANION_WIDTH && (companion === null || companion === void 0 ? void 0 : companion.height) === LOGO_COMPANION_HEIGHT;
-const companionArea = companion => (companion.width || 0) * (companion.height || 0);
-/**
- * Split a `<CompanionAds>` creative's variations into the logo and media slots.
- *
- * The pair mapping activates only for a tag that ships an exact 300x75 companion next to at
- * least one other. Deliberately conservative pending broader product sizes: on any other tag
- * no companion is promoted to the logo slot and the first one stays the media/strip candidate.
- *
- * Both halves of that gate are load-bearing and neither is an aspect rule: a 320x80 companion is
- * the same 4:1 shape as 300x75 and is still rejected, and a lone 300x75 companion is rejected too
- * (the Standard Ad Sidebar recovers that one as `AdData.loneLogo` when a Linear / NonLinear is
- * the media, so it is not needed here).
- * This is **narrower than iOS**, which has no size rule at all and fills its logo slot from a
- * single companion — see `docs/wiki/programmatic-ads-display-ios-parity.md`. Exported for
- * `external-ad.spec.ts` only; `src/index.ts` re-exports names explicitly, so this stays out of the
- * package's public API.
- */
-const selectCompanions = companions => {
-  const logo = companions.length > 1 ? companions.find(companion => isLogoSized(companion)) : undefined;
-  if (!logo) {
-    return {
-      logo: undefined,
-      media: companions[0]
-    };
-  }
-  const media = companions.filter(companion => companion !== logo).sort((a, b) => companionArea(a) - companionArea(b)).pop();
-  return {
-    logo,
-    media
-  };
-};
-/**
- * Map a parsed VAST response into our `AdData` shape. Shared by both acquisition
- * paths — the GAM/VMAP tag flow and the Prebid auction flow — so the two always
- * produce identical downstream data.
- *
- * Returns `undefined` for a no-ad, which is two distinct shapes: a response with no ad carrying
- * creatives, and an ad whose creatives carry no RENDERABLE asset — no linear `<MediaFile>`, no
- * `<NonLinear>` still and no `<Companion>` image. Both callers `filter(Boolean)` the result, so a
- * no-ad leaves `ads: []` and the card keeps whatever the server configured for it.
- *
- * Exported for `vast-mapping.spec.ts`, which drives it over the same fixture corpus the iOS suite
- * uses. `src/index.ts` re-exports names explicitly, so this stays out of the package's public API.
- */
-const buildAdData = (parsedVAST, order) => {
-  var _validAd$extensions$f;
-  // Defensive, and unreachable through either production path: `@dailymotion/vast-client` discards
-  // an ad whose creatives all fail to parse (empty `<Linear>`, empty/missing `<Creatives>`, unknown
-  // creative element) before `parseVAST` resolves, so it never yields an Ad with zero creatives.
-  // Kept because it costs nothing and `buildAdData` is also reachable from tests with a hand-built
-  // response — see the `invalid_ad` case in `vast-mapping.spec.ts`, which pins the parser contract
-  // this relies on rather than pretending to exercise the guard.
-  const validAd = parsedVAST.ads.find(ads => ads.creatives.length > 0);
-  if (!validAd) {
-    log.warn({
-      order,
-      ads: parsedVAST.ads.length
-    }, 'vast response carries no ad with creatives — treated as no-ad');
-    return undefined;
-  }
-  const extension = (_validAd$extensions$f = validAd.extensions.find(ext => ext.attributes.type.startsWith('streamlayer'))) === null || _validAd$extensions$f === void 0 ? void 0 : _validAd$extensions$f.children[0];
-  // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-  // @ts-expect-error
-  const parsedExtension = parseVastExtensions.parseVastExtension(extension);
-  const creative = getCreative(validAd);
-  const mediaFileUrl = getMediaFileUrl(creative);
-  const images = sponsorLogo.collectAssets(validAd);
-  const companions = images.filter(asset => asset.origin === 'companion');
-  const nonLinear = images.find(asset => asset.origin === 'nonlinear');
-  // An ad the parser KEPT whose creatives carry nothing any shell can draw is a no-ad, exactly
-  // like a response with no ad at all. vast-client only discards a creative it cannot parse; a
-  // `<NonLinear>` or `<Companion>` whose `<StaticResource>` body is empty parses fine and just
-  // yields no url, so the guard above cannot catch it. Without this the fabricated promotion still
-  // took the slot and drew the ad's TEXT — title and description over an empty media box — which
-  // is a billable impression for a creative that does not exist.
-  //
-  // "Renderable" is the union of the three slots the shells can fill: a linear `<MediaFile>`, a
-  // `<NonLinear>` still, or a `<Companion>` image. `collectAssets` already drops the imageless
-  // ones, so a non-empty `companions` means at least one drawable image. A tag carrying only a
-  // `<Mezzanine>` never reaches here — the parser drops that Linear itself — but it lands in the
-  // same place either way.
-  if (!mediaFileUrl && !nonLinear && companions.length === 0) {
-    log.warn({
-      order,
-      adId: validAd.id,
-      creatives: validAd.creatives.length
-    }, 'vast ad carries no renderable asset (no media file, no nonlinear, no companion) — treated as no-ad');
-    return undefined;
-  }
-  const {
-    logo,
-    media: mediaCompanion
-  } = selectCompanions(companions);
-  const clickThrough = getClickThrough(creative) || (nonLinear === null || nonLinear === void 0 ? void 0 : nonLinear.clickUrl) || (mediaCompanion === null || mediaCompanion === void 0 ? void 0 : mediaCompanion.clickUrl);
-  // Mirror iOS's greedy `pool.select([hero, .cardLogo])`: the hero claims first and a claimed
-  // asset is gone for later roles. Web's hero precedence (`createActiveAdFromVast`) is linear
-  // video → pair media companion (unreachable here: a `logo` short-circuits the whole selection)
-  // → NonLinear still → lone companion, so a companion is only unavailable to the logo slot when
-  // it IS the hero, i.e. when the tag ships neither. `selectCardLogo` already filters to companion
-  // origins, so the NonLinear never needs excluding.
-  //
-  // Excluding `companions[0]` (which is what `mediaCompanion` is when there is no `logo`) rather
-  // than the largest-area asset is a deliberate difference from iOS's `areaDominant` hero: web's
-  // content slot draws the FIRST companion in document order, so document order is the correct
-  // criterion for "what the hero already claimed" on this platform.
-  const companionIsHero = !mediaFileUrl && !nonLinear;
-  const cardLogoAsset = logo ? undefined : sponsorLogo.selectCardLogo(validAd, companionIsHero ? [mediaCompanion] : []);
-  // Share the selected resource wrapper so drawn-companion identity remains stable.
-  const cardLogo = cardLogoAsset ? companions.find(item => item.variation === cardLogoAsset.variation && item.imageUrl === cardLogoAsset.imageUrl) : undefined;
-  // Same collected instance as `companion` (identity matters to `drawnCompanions`). A lone
-  // companion never satisfies the pair rule, so this can only fill a slot `logo` left empty.
-  const loneLogo = companions.length === 1 && !companionIsHero && isLogoSized(companions[0]) ? companions[0] : undefined;
-  log.info({
-    order,
-    adId: validAd.id,
-    title: validAd.title || undefined,
-    found: {
-      linear: !!creative,
-      mediaFile: mediaFileUrl || undefined,
-      nonLinear: nonLinear ? `${nonLinear.width}x${nonLinear.height}` : undefined,
-      companions: companions.map(item => `${item.width}x${item.height}`)
-    },
-    selected: {
-      logo: logo ? {
-        size: `${logo.width}x${logo.height}`,
-        url: logo.imageUrl
-      } : undefined,
-      media: mediaCompanion ? {
-        size: `${mediaCompanion.width}x${mediaCompanion.height}`,
-        url: mediaCompanion.imageUrl
-      } : undefined,
-      cardLogo: cardLogo ? {
-        size: `${cardLogo.width}x${cardLogo.height}`,
-        url: cardLogo.imageUrl
-      } : undefined,
-      loneLogo: loneLogo ? {
-        size: `${loneLogo.width}x${loneLogo.height}`,
-        url: loneLogo.imageUrl
-      } : undefined,
-      clickThrough: !!clickThrough
-    }
-  }, 'vast ad parsed');
-  return {
-    creative,
-    order,
-    mediaFileUrl,
-    companion: companions[0],
-    logo,
-    cardLogo,
-    loneLogo,
-    mediaCompanion,
-    nonLinear,
-    clickThrough,
-    title: validAd.title || undefined,
-    description: validAd.description || undefined,
-    ad: validAd,
-    extension: parsedExtension,
-    raw: parsedVAST
-  };
-};
-/** Path of the self-hosted Prebid Server OpenRTB auction endpoint. */
-const PREBID_AUCTION_PATH = '/openrtb2/auction';
-/**
- * A Prebid link points at our Prebid Server auction endpoint (staging:
- * `https://prebid.next.streamlayer.io/openrtb2/auction`) rather than at a VAST tag.
- * Detected by path so both staging and production hosts match.
- */
-const isPrebidUrl = url => url.pathname.endsWith(PREBID_AUCTION_PATH);
-/** Unique per-auction request id — Prebid responses are never cached/reused (RFC §5). */
-const createRequestId = () => `sl-web-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
-/**
- * Build the OpenRTB request body for a single video auction. Placement config is
- * carried on the Prebid link's query string so the consumer-facing interface stays a
- * single URL string:
- * - `configId` → `imp.ext.prebid.storedrequest.id` (production stored request).
- * - `storedauctionresponse` → `imp.ext.prebid.storedauctionresponse.id` (staging mock).
- * - `test=1` → top-level `test` flag.
- * - `w` / `h` → video dimensions (default 1920×1080).
- *
- * The host's GDPR consent (`AdTagParams`) rides the OpenRTB 2.5 extension fields Prebid Server
- * reads — `regs.ext.gdpr` and `user.ext.consent` — the same signal the `${GDPR}` /
- * `${GDPR_CONSENT}` macros carry for a VAST tag. Each is sent only when the host passed it.
- */
-const buildAuctionRequest = (url, adTagParams) => {
-  var _ref, _params$get, _params$get2;
-  const params = url.searchParams;
-  const width = Number(params.get('w')) || 1920;
-  const height = Number(params.get('h')) || 1080;
-  const configId = (_ref = (_params$get = params.get('configId')) !== null && _params$get !== void 0 ? _params$get : params.get('config_id')) !== null && _ref !== void 0 ? _ref : undefined;
-  const storedAuctionResponse = (_params$get2 = params.get('storedauctionresponse')) !== null && _params$get2 !== void 0 ? _params$get2 : undefined;
-  const prebid = {};
-  if (storedAuctionResponse) {
-    prebid.storedauctionresponse = {
-      id: storedAuctionResponse
-    };
-  }
-  if (configId) {
-    prebid.storedrequest = {
-      id: configId
-    };
-  }
-  prebid.bidder = {
-    appnexus: {
-      placementId: 13144370
-    }
-  };
-  const request = {
-    id: createRequestId(),
-    imp: [{
-      id: '1',
-      video: {
-        mimes: ['video/mp4'],
-        protocols: [2, 3, 5, 6],
-        w: width,
-        h: height,
-        placement: 1,
-        linearity: 1
-      },
-      ext: {
-        prebid
-      }
-    }],
-    site: {
-      page: typeof location !== 'undefined' ? location.href : url.origin
-    },
-    tmax: 500
-  };
-  if (params.get('test') === '1') {
-    request.test = 1;
-  }
-  if ((adTagParams === null || adTagParams === void 0 ? void 0 : adTagParams.gdprApplies) !== undefined) {
-    request.regs = {
-      ext: {
-        gdpr: adTagParams.gdprApplies ? 1 : 0
-      }
-    };
-  }
-  if (adTagParams !== null && adTagParams !== void 0 && adTagParams.tcString) {
-    request.user = {
-      ext: {
-        consent: adTagParams.tcString
-      }
-    };
-  }
-  return request;
-};
-/**
- * Run one Prebid Server auction and turn the winning inline VAST into an `AdStore`.
- * Every bid's `adm` is inline VAST XML (no URL to fetch); bids are ordered by price
- * so the winner plays first (RFC §2). A single bad bid must not drop the batch.
- */
-const fetchPrebidAds = /*#__PURE__*/function () {
-  var _ref2 = _rollupPluginBabelHelpers.asyncToGenerator(function* (prebidUrl, adTagParams) {
-    var _auction$seatbid, _params$get3, _params$get4;
-    const response = yield fetch(prebidUrl.toString(), {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json'
-      },
-      body: JSON.stringify(buildAuctionRequest(prebidUrl, adTagParams))
-    });
-    if (!response.ok) {
-      throw new Error(`prebid auction failed with status ${response.status}`);
-    }
-    const auction = yield response.json();
-    const bids = ((_auction$seatbid = auction.seatbid) !== null && _auction$seatbid !== void 0 ? _auction$seatbid : []).reduce((acc, seat) => {
-      var _seat$bid;
-      return acc.concat((_seat$bid = seat.bid) !== null && _seat$bid !== void 0 ? _seat$bid : []);
-    }, []).filter(bid => !!bid.adm)
-    // Highest price wins — the winner is order 0 (RFC §2).
-    .sort((a, b) => {
-      var _b$price, _a$price;
-      return ((_b$price = b.price) !== null && _b$price !== void 0 ? _b$price : 0) - ((_a$price = a.price) !== null && _a$price !== void 0 ? _a$price : 0);
-    });
-    const parser = new DOMParser();
-    const loadedAds = yield Promise.all(bids.map((bid, i) => {
-      const xmlDoc = parser.parseFromString(bid.adm, 'text/xml');
-      // A fresh `VASTParser` per bid isolates parser state, mirroring the fresh
-      // `VASTClient` per link in the tag flow. `resolveAll: true` follows any
-      // `VASTAdTagURI` wrapper chain the bid's inline VAST may still contain.
-      return new vastClient.VASTParser()
-      // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-      // @ts-ignore
-      .parseVAST(xmlDoc, {
-        resolveAll: true,
-        wrapperLimit: 10,
-        allowMultipleAds: true
-      }).then(parsedVAST => buildAdData(parsedVAST, i)).catch(err => {
-        // A single failing bid must not drop the whole batch.
-        log.error(err, 'failed to parse prebid VAST');
-        return undefined;
-      });
-    }));
-    const params = prebidUrl.searchParams;
-    const autoplay = ((_params$get3 = params.get('vpa')) === null || _params$get3 === void 0 ? void 0 : _params$get3.replaceAll('?', '')) !== 'click';
-    const muted = ((_params$get4 = params.get('vpmute')) === null || _params$get4 === void 0 ? void 0 : _params$get4.replaceAll('?', '')) === '1';
-    return {
-      ads: loadedAds.filter(d => !!d),
-      autoplay,
-      muted
-    };
-  });
-  return function fetchPrebidAds(_x, _x2) {
-    return _ref2.apply(this, arguments);
-  };
-}();
-const externalAd = instance => {
-  return gamUrl => instance.transport.nanoquery.createFetcherStore([gamUrl], {
-    dedupeTime: Infinity,
-    revalidateInterval: 0,
-    fetcher: function () {
-      var _ref3 = _rollupPluginBabelHelpers.asyncToGenerator(function* (adUrl) {
-        var _noncedLink$searchPar, _noncedLink$searchPar2, _noncedLink$searchPar3;
-        if (!adUrl || typeof adUrl !== 'string') {
-          throw new Error('ad url is empty');
-        }
-        const parsedAdUrl = (() => {
-          try {
-            return new URL(adUrl);
-          } catch (_unused) {
-            return undefined;
-          }
-        })();
-        // The host's CURRENT macro values, read per request rather than baked into the store: the
-        // store is cached by url for the session, and consent routinely arrives after the SDK
-        // starts (a CMP answers asynchronously) or changes mid-session.
-        const adTagParams = instance.sdk.options.get().adTagParams;
-        // Prebid links hit our Prebid Server auction endpoint instead of a VAST tag.
-        // Run the OpenRTB auction and parse the winning bid's inline VAST (`adm`) into
-        // the same `AdStore` shape the GAM/VMAP path returns. See rfcs/prebid.
-        if (parsedAdUrl && isPrebidUrl(parsedAdUrl)) {
-          return fetchPrebidAds(parsedAdUrl, adTagParams);
-        }
-        const generateUrl = gam.gam(adUrl, undefined, adTagParams);
-        const generatedUrl = yield generateUrl();
-        const noncedLink = generatedUrl === null || generatedUrl === void 0 ? void 0 : generatedUrl.url;
-        if (!noncedLink) {
-          throw new Error('ad url is not generated');
-        }
-        let links;
-        if (((_noncedLink$searchPar = noncedLink.searchParams.get('output')) === null || _noncedLink$searchPar === void 0 ? void 0 : _noncedLink$searchPar.replaceAll('?', '')) === 'vmap') {
-          const response = yield withTimeout(fetch(noncedLink.toString()), VAST_FETCH_TIMEOUT_MS);
-          if (!response) {
-            throw new Error('vmap fetch timed out');
-          }
-          const parser = new DOMParser();
-          const xmlStr = yield response.text();
-          const xmlDoc = parser.parseFromString(xmlStr, 'text/xml');
-          const vmap = new VMAP__default.default(xmlDoc);
-          links = vmap.adBreaks.map(ad => {
-            // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-            // @ts-expect-error
-            return ad.adSource.adTagURI.uri;
-          });
-        } else {
-          links = [noncedLink.toString()];
-        }
-        const loadedAds = yield Promise.all(links.map((link, i) => {
-          // `resolveAll: true` makes the client follow every `VASTAdTagURI` wrapper chain
-          // (up to the default depth of 10) and resolve all Ads, merging wrapper-level
-          // Impression/tracking URLs into the inline Ad. The default (`resolveAll: false`)
-          // only resolves the first standalone Ad and defers wrappers/remaining Ads to
-          // `getNextAds()`, which this fetcher never calls. A fresh `VASTClient` per link
-          // isolates parser state so concurrent (VMAP) resolutions don't clobber each other.
-          return withTimeout(new vastClient.VASTClient()
-          // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-          // @ts-ignore
-          .get(link, {
-            resolveAll: true,
-            wrapperLimit: 10,
-            allowMultipleAds: true
-          }), VAST_FETCH_TIMEOUT_MS).then(parsedVAST => {
-            // `parsedVAST` is `undefined` when the resolution timed out (see `withTimeout`).
-            if (!parsedVAST) {
-              log.warn({
-                link,
-                timeoutMs: VAST_FETCH_TIMEOUT_MS
-              }, 'vast resolution timed out — treated as no-ad');
-              return undefined;
-            }
-            return buildAdData(parsedVAST, i);
-          }).catch(err => {
-            // A single failing wrapper chain must not drop the whole batch.
-            log.error(err, 'failed to resolve VAST');
-            return undefined;
-          });
-        }));
-        const autoplay = ((_noncedLink$searchPar2 = noncedLink.searchParams.get('vpa')) === null || _noncedLink$searchPar2 === void 0 ? void 0 : _noncedLink$searchPar2.replaceAll('?', '')) !== 'click';
-        const muted = ((_noncedLink$searchPar3 = noncedLink.searchParams.get('vpmute')) === null || _noncedLink$searchPar3 === void 0 ? void 0 : _noncedLink$searchPar3.replaceAll('?', '')) === '1';
-        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-        // @ts-expect-error
-        const nonceManager = generatedUrl.manager;
-        return {
-          ads: loadedAds.filter(d => !!d),
-          autoplay,
-          muted,
-          nonceManager
-        };
-      });
-      return function fetcher(_x3) {
-        return _ref3.apply(this, arguments);
-      };
-    }()
-  });
-};
-
-exports.buildAdData = buildAdData;
-exports.buildAuctionRequest = buildAuctionRequest;
-exports.externalAd = externalAd;
-exports.selectCompanions = selectCompanions;