@streamlayer/feature-advertisement 1.0.0 → 1.1.1-rc.1342

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

@@ -0,0 +1,274 @@
+'use strict';
+
+var _rollupPluginBabelHelpers = require('../_virtual/_rollupPluginBabelHelpers.js');
+require('core-js/modules/es.error.cause.js');
+require('core-js/modules/es.array.iterator.js');
+require('core-js/modules/es.array.sort.js');
+require('core-js/modules/es.promise.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.some.js');
+require('core-js/modules/web.dom-collections.iterator.js');
+var classic$1 = require('@streamlayer/sdk-web-interfaces/classic');
+var classic = require('@streamlayer/sdk-web-logger/classic');
+require('@streamlayer/sdk-web-api/classic');
+var vastClient$1 = require('@dailymotion/vast-client');
+
+const FULLBLEED_VIDEO_TEMPLATES = ['fullbleed-video', 'fullbleed-video-center', 'fullbleed-video-left'];
+/**
+ * `indexOf` rather than `Array.prototype.includes`: this package ships to Chrome 32
+ * TV webviews and must stay ES5-compatible without a polyfill.
+ */
+const isFullbleedVideoTemplate = template => !!template && FULLBLEED_VIDEO_TEMPLATES.indexOf(template) !== -1;
+const MP4_MIME = 'video/mp4';
+// Programmatic spec (Index Exchange): bitrate window for a linear pause-ad MP4.
+const MIN_BITRATE = 5000;
+const MAX_BITRATE = 40000;
+const TARGET_WIDTH = 1920;
+const TARGET_HEIGHT = 1080;
+const bitrateDistanceToWindow = bitrate => {
+  if (bitrate < MIN_BITRATE) return MIN_BITRATE - bitrate;
+  if (bitrate > MAX_BITRATE) return bitrate - MAX_BITRATE;
+  return 0;
+};
+const resolutionDistanceToTarget = file => {
+  var _file$width, _file$height;
+  return Math.abs(((_file$width = file.width) !== null && _file$width !== void 0 ? _file$width : 0) - TARGET_WIDTH) + Math.abs(((_file$height = file.height) !== null && _file$height !== void 0 ? _file$height : 0) - TARGET_HEIGHT);
+};
+/**
+ * Pick the best linear MP4 from a VAST creative's media files: prefer the
+ * highest bitrate inside the 5000–40000 kbps window; if none qualify, pick the
+ * one closest to the window. Ties break toward 1920×1080. Returns `undefined`
+ * when no MP4 is present so image-only VAST keeps working.
+ */
+const selectMp4MediaFile = (mediaFiles = []) => {
+  const mp4s = (mediaFiles !== null && mediaFiles !== void 0 ? mediaFiles : []).filter(file => !!(file !== null && file !== void 0 && file.fileURL) && file.mimeType === MP4_MIME);
+  if (mp4s.length === 0) {
+    return undefined;
+  }
+  const inWindow = mp4s.filter(file => {
+    var _file$bitrate;
+    const bitrate = (_file$bitrate = file.bitrate) !== null && _file$bitrate !== void 0 ? _file$bitrate : 0;
+    return bitrate >= MIN_BITRATE && bitrate <= MAX_BITRATE;
+  });
+  if (inWindow.length > 0) {
+    return [...inWindow].sort((a, b) => {
+      var _b$bitrate, _a$bitrate;
+      const byBitrate = ((_b$bitrate = b.bitrate) !== null && _b$bitrate !== void 0 ? _b$bitrate : 0) - ((_a$bitrate = a.bitrate) !== null && _a$bitrate !== void 0 ? _a$bitrate : 0);
+      return byBitrate !== 0 ? byBitrate : resolutionDistanceToTarget(a) - resolutionDistanceToTarget(b);
+    })[0];
+  }
+  return [...mp4s].sort((a, b) => {
+    var _a$bitrate2, _b$bitrate2;
+    const byWindow = bitrateDistanceToWindow((_a$bitrate2 = a.bitrate) !== null && _a$bitrate2 !== void 0 ? _a$bitrate2 : 0) - bitrateDistanceToWindow((_b$bitrate2 = b.bitrate) !== null && _b$bitrate2 !== void 0 ? _b$bitrate2 : 0);
+    return byWindow !== 0 ? byWindow : resolutionDistanceToTarget(a) - resolutionDistanceToTarget(b);
+  })[0];
+};
+const vastClient = new vastClient$1.VASTClient();
+const log = classic.createLogger('ui:gam-static');
+const preloadImage = src => {
+  return new Promise((resolve, reject) => {
+    const image = new Image();
+    image.onload = () => resolve(src);
+    image.onerror = () => reject();
+    image.src = src;
+  });
+};
+const externalPauseAd = instance => {
+  return (gamUrl, $enabled, options) => {
+    var _options$template;
+    return (
+      // `template` MUST be a key part: nanoquery joins parts with `''` (no separator)
+      // and its `cache` Map is global per transport, so two stores that produce the
+      // same joined key share data AND cross-trigger each other's `revalidate()`.
+      // The `tpl:` prefix keeps the url/template boundary unambiguous. Never let this
+      // part be `undefined` — an undefined part nulls the WHOLE key and permanently
+      // suspends fetching (that is exactly how `$enabled: false` works).
+      instance.transport.nanoquery.createFetcherStore([gamUrl, $enabled, `tpl:${(_options$template = options.template) !== null && _options$template !== void 0 ? _options$template : 'default'}`], {
+        dedupeTime: options.prefetch ? options.refetchInterval : Infinity,
+        revalidateInterval: options.refetchInterval > 0 ? options.refetchInterval : 0,
+        // A creative-type mismatch is DETERMINISTIC: this tag returned no usable linear
+        // MP4 and retrying it can never change that, so cancel nanoquery's BACKOFF RETRY
+        // LOOP (any falsy return does) instead of re-hitting the ad server for the rest of
+        // the session — with the default `pauseAdDelay: 0` the store is enabled from mount.
+        // This only cancels the retry loop: `revalidateInterval` still re-runs the fetcher
+        // on its timer, and `Advertisement.getExternalPauseAd` forces a `revalidate()` on
+        // every `$enabled` false → true edge, so with `pauseAdDelay > 0` the tag is still
+        // re-requested on every pause.
+        // Transient failures (network, CORS, malformed XML, 5xx) still retry; the backoff
+        // below mirrors nanoquery's `defaultOnErrorRetry` so the two templates stay on the
+        // same curve. The jitter is not decorative — it spreads out retries that would
+        // otherwise fire in lockstep when the failure is correlated across stores/clients
+        // (ad-server 5xx, CORS), which the `pauseAdDelay: 0` prefetch-at-mount makes more
+        // likely.
+        // On `default` this is `undefined`, i.e. exactly as if the option were not passed —
+        // true as long as the shared nanoquery instance sets no global `onErrorRetry` (an
+        // explicit `undefined` DOES shadow a global one, and only then does nanoquery's
+        // destructuring default restore `defaultOnErrorRetry`).
+        onErrorRetry: isFullbleedVideoTemplate(options.template) ? ({
+          error,
+          retryCount
+        }) => {
+          if (error instanceof Error && error.message === 'no_valid_ad') {
+            return false;
+          }
+          return ~~((Math.random() + 0.5) * (1 << Math.min(retryCount, 8))) * 2000;
+        } : undefined,
+        fetcher: function () {
+          var _ref = _rollupPluginBabelHelpers.asyncToGenerator(function* (adUrl) {
+            if (!adUrl || typeof adUrl !== 'string') {
+              throw new Error('ad url is empty');
+            }
+            classic$1.eventBus.emit('exposedPauseAd', {
+              action: 'load',
+              payload: {}
+            });
+            try {
+              var _options$template2, _parsedVAST$ads$find;
+              // `resolveAll: true` follows every `VASTAdTagURI` wrapper chain and resolves all
+              // Ads (the default only resolves the first standalone Ad and stops at the wrapper).
+              const parsedVAST = yield vastClient.get(adUrl, {
+                resolveAll: true
+              });
+              const template = (_options$template2 = options.template) !== null && _options$template2 !== void 0 ? _options$template2 : 'default';
+              // `fullbleed-video` needs an ad that actually carries a usable linear MP4. With
+              // `resolveAll: true` the response can be a pod/wrapper chain, so prefer the first
+              // ad that satisfies the template and fall back to the first ad with any creative
+              // (which preserves the existing `no_valid_ad` error and event sequencing).
+              const validAd = isFullbleedVideoTemplate(template) ? (_parsedVAST$ads$find = parsedVAST.ads.find(ad => ad.creatives.some(creative => {
+                var _selectMp4MediaFile;
+                return creative.type === 'linear' && (// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                // @ts-ignore vast-client linear creative carries mediaFiles
+                (_selectMp4MediaFile = selectMp4MediaFile(creative.mediaFiles)) === null || _selectMp4MediaFile === void 0 ? void 0 : _selectMp4MediaFile.fileURL);
+              }))) !== null && _parsedVAST$ads$find !== void 0 ? _parsedVAST$ads$find : parsedVAST.ads.find(ads => ads.creatives.length > 0) : parsedVAST.ads.find(ads => ads.creatives.length > 0);
+              if (validAd) {
+                var _companion$variations, _variation$staticReso;
+                const parentId = validAd.id || '';
+                log.debug(validAd, 'validAd');
+                // The HOST decides which creative wins (SC-322-2). `fullbleed-video` asks
+                // for the linear MP4 explicitly, so it is resolved FIRST and never falls
+                // back to a static image — the nonlinear/companion branches below `return`
+                // early, so without this a VAST carrying BOTH an image and a linear MP4
+                // (e.g. Google `single_ad_samples`) would never reach the linear creative.
+                // `default` keeps the pre-SC-322 nonlinear → companion order below and can
+                // never produce a video.
+                if (isFullbleedVideoTemplate(template)) {
+                  const linear = validAd.creatives.find(creative => {
+                    var _selectMp4MediaFile2;
+                    return creative.type === 'linear' && (// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                    // @ts-ignore vast-client linear creative carries mediaFiles
+                    (_selectMp4MediaFile2 = selectMp4MediaFile(creative.mediaFiles)) === null || _selectMp4MediaFile2 === void 0 ? void 0 : _selectMp4MediaFile2.fileURL);
+                  });
+                  if (linear) {
+                    log.debug(linear, 'linear');
+                    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                    // @ts-ignore vast-client linear creative carries mediaFiles
+                    const mediaFile = selectMp4MediaFile(linear.mediaFiles);
+                    if (mediaFile !== null && mediaFile !== void 0 && mediaFile.fileURL) {
+                      const id = linear.adId || linear.id || parentId;
+                      classic$1.eventBus.emit('exposedPauseAd', {
+                        action: 'loaded',
+                        payload: {
+                          id,
+                          parentId
+                        }
+                      });
+                      return {
+                        id,
+                        parentId,
+                        url: adUrl,
+                        backgroundVideoSrc: mediaFile.fileURL,
+                        ad: validAd,
+                        creative: linear
+                      };
+                    }
+                  }
+                  // Host asked for full-bleed video and this VAST carries no usable linear
+                  // MP4 → fail closed so `ExposedPauseAd`'s error effect auto-closes the ad,
+                  // exactly like any other unusable VAST. See §5 of the brief.
+                  throw new Error('no_valid_ad');
+                }
+                const nonlinear = validAd.creatives.find(creative => creative.type === 'nonlinear');
+                if (nonlinear) {
+                  var _nonlinear$variations;
+                  const id = nonlinear.adId || nonlinear.id || parentId;
+                  log.debug(nonlinear, 'nonlinear');
+                  // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                  // @ts-ignore
+                  const variation = (_nonlinear$variations = nonlinear.variations) === null || _nonlinear$variations === void 0 ? void 0 : _nonlinear$variations[0];
+                  const staticResource = variation === null || variation === void 0 ? void 0 : variation.staticResource;
+                  const adUrlTemplate = variation === null || variation === void 0 ? void 0 : variation.nonlinearClickThroughURLTemplate;
+                  if (staticResource) {
+                    yield preloadImage(staticResource);
+                    classic$1.eventBus.emit('exposedPauseAd', {
+                      action: 'loaded',
+                      payload: {
+                        id,
+                        parentId
+                      }
+                    });
+                    return {
+                      id,
+                      parentId,
+                      url: adUrl,
+                      imageSrc: staticResource,
+                      adUrl: adUrlTemplate,
+                      ad: validAd,
+                      creative: nonlinear,
+                      variation
+                    };
+                  }
+                }
+                const companion = validAd.creatives.find(creative => creative.type === 'companion');
+                log.debug(companion, 'companion');
+                // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                // @ts-ignore
+                const variation = companion === null || companion === void 0 || (_companion$variations = companion.variations) === null || _companion$variations === void 0 ? void 0 : _companion$variations[0];
+                const staticResource = variation === null || variation === void 0 || (_variation$staticReso = variation.staticResources) === null || _variation$staticReso === void 0 || (_variation$staticReso = _variation$staticReso[0]) === null || _variation$staticReso === void 0 ? void 0 : _variation$staticReso.url;
+                const adUrlTemplate = variation === null || variation === void 0 ? void 0 : variation.companionClickThroughURLTemplate;
+                // `&& companion` is for TS narrowing only (companion.adId access below);
+                // it is runtime-redundant since staticResource derives from companion.
+                if (staticResource && companion) {
+                  const id = companion.adId || companion.id || parentId;
+                  yield preloadImage(staticResource);
+                  classic$1.eventBus.emit('exposedPauseAd', {
+                    action: 'loaded',
+                    payload: {
+                      id,
+                      parentId
+                    }
+                  });
+                  return {
+                    id,
+                    parentId,
+                    url: adUrl,
+                    imageSrc: staticResource,
+                    adUrl: adUrlTemplate,
+                    ad: validAd,
+                    creative: companion,
+                    variation
+                  };
+                }
+              }
+              throw new Error('no_valid_ad');
+            } catch (err) {
+              // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+              // @ts-expect-error
+              if (err.message !== 'no_valid_ad' && err.message !== 'ad url is empty') {
+                console.error(err);
+              }
+              throw err;
+            }
+          });
+          return function fetcher(_x) {
+            return _ref.apply(this, arguments);
+          };
+        }()
+      })
+    );
+  };
+};
+
+exports.externalPauseAd = externalPauseAd;
+exports.isFullbleedVideoTemplate = isFullbleedVideoTemplate;

package/lib/classic/cjs/units/gam.js

@@ -0,0 +1,110 @@
+'use strict';
+
+var _rollupPluginBabelHelpers = require('../_virtual/_rollupPluginBabelHelpers.js');
+require('core-js/modules/es.array.iterator.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-storage/classic');
+var uuid = require('uuid');
+
+const urlIsNotGam = url => {
+  return url.origin !== 'https://pubads.g.doubleclick.net';
+};
+const gam = (url, adContainer) => {
+  const parsedUrl = (() => {
+    try {
+      const parsedUrl = new URL(url);
+      return parsedUrl;
+    } catch (_err) {
+      return undefined;
+    }
+  })();
+  // Non-GAM VAST/VMAP URLs carry no GAM ad-request params and need no PAL nonce, so
+  // resolve them directly. PAL is only required for pubads.g.doubleclick.net requests —
+  // raw-VAST consumers (e.g. injected sidebar / l-bar) must not depend on the Google PAL
+  // SDK being loaded, so this must run before touching `goog`.
+  if (parsedUrl && urlIsNotGam(parsedUrl)) {
+    // eslint-disable-next-line require-await
+    return /*#__PURE__*/_rollupPluginBabelHelpers.asyncToGenerator(function* () {
+      return {
+        url: parsedUrl
+      };
+    });
+  }
+  // @ts-expect-error goog is injected by the externally-loaded Google PAL SDK
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const pal = typeof goog === 'undefined' ? undefined : goog.pal;
+  if (!pal || !parsedUrl) {
+    // eslint-disable-next-line require-await
+    return /*#__PURE__*/_rollupPluginBabelHelpers.asyncToGenerator(function* () {
+      return undefined;
+    });
+  }
+  const consentSettings = new pal.ConsentSettings();
+  consentSettings.allowStorage = false;
+  const nonceLoader = new pal.NonceLoader(consentSettings);
+  const generateUrl = /*#__PURE__*/function () {
+    var _ref3 = _rollupPluginBabelHelpers.asyncToGenerator(function* () {
+      try {
+        var _adContainer$clientHe, _adContainer$clientWi;
+        const parsedUrl = new URL(url);
+        const request = new pal.NonceRequest();
+        let deviceId = classic.safeLocalStorage().getItem('sl-device-id') || uuid.v4();
+        let sessionId = classic.safeSessionStorage().getItem('sl-ad-session-id');
+        if (!sessionId) {
+          sessionId = uuid.v4();
+          classic.safeSessionStorage().setItem('sl-ad-session-id', sessionId);
+        }
+        if (!uuid.validate(deviceId)) {
+          deviceId = uuid.v5(`https://${deviceId}`, uuid.v5.URL);
+        }
+        if (!parsedUrl.searchParams.get('url')) {
+          parsedUrl.searchParams.set('url', 'https://streamlayer.io');
+        }
+        if (!parsedUrl.searchParams.get('description_url')) {
+          parsedUrl.searchParams.set('description_url', 'https://streamlayer.io');
+        }
+        request.adWillAutoPlay = parsedUrl.searchParams.get('vpa') === 'auto';
+        request.adWillPlayMuted = parsedUrl.searchParams.get('vpmute') === '1';
+        request.continuousPlayback = true;
+        request.descriptionUrl = parsedUrl.searchParams.get('description_url');
+        request.iconsSupported = true;
+        request.sessionId = deviceId;
+        // Player support for VPAID 2.0, OMID 1.0, and SIMID 1.1
+        request.supportedApiFrameworks = '2,7,9';
+        request.videoHeight = (_adContainer$clientHe = adContainer === null || adContainer === void 0 ? void 0 : adContainer.clientHeight) !== null && _adContainer$clientHe !== void 0 ? _adContainer$clientHe : 0;
+        request.videoWidth = (_adContainer$clientWi = adContainer === null || adContainer === void 0 ? void 0 : adContainer.clientWidth) !== null && _adContainer$clientWi !== void 0 ? _adContainer$clientWi : 0;
+        const nonceManager = yield nonceLoader.loadNonceManager(request);
+        if (parsedUrl.searchParams.get('is_lat') === '[placeholder]') {
+          parsedUrl.searchParams.set('is_lat', '1');
+        }
+        if (parsedUrl.searchParams.get('rdid') === '[placeholder]') {
+          parsedUrl.searchParams.set('rdid', deviceId);
+        }
+        if (parsedUrl.searchParams.get('correlator') === '[placeholder]') {
+          parsedUrl.searchParams.set('correlator', sessionId);
+        }
+        parsedUrl.searchParams.set('wta', '1');
+        parsedUrl.searchParams.set('givn', nonceManager.getNonce());
+        return {
+          url: parsedUrl,
+          manager: nonceManager
+        };
+      } catch (adError) {
+        console.log('AdsManager could not be started', adError);
+        return undefined;
+      }
+    });
+    return function generateUrl() {
+      return _ref3.apply(this, arguments);
+    };
+  }();
+  return generateUrl;
+};
+
+exports.gam = gam;

package/lib/classic/cjs/units/parse-vast-extensions.js

@@ -0,0 +1,56 @@
+'use strict';
+
+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');
+var interactive_common_pb = require('@streamlayer/sl-eslib/interactive/interactive.common_pb');
+
+const MAP_EXTENSION_NAME_AD_TYPE = {
+  DoubleBox: interactive_common_pb.AdType.SIDE_BY_SIDE
+};
+function parseVastExtension(root) {
+  var _child$value2, _child2, _child$value3, _child3, _child$value4, _child4, _backgrounds$find, _backgrounds$find2, _logos$find;
+  if (!root) {
+    return undefined;
+  }
+  const child = (node, name) => node.children.find(c => c.name === name);
+  const childrenByName = (node, name) => node.children.filter(c => c.name === name);
+  const urlOf = node => {
+    var _child$value, _child;
+    return (_child$value = (_child = child(node, 'Url')) === null || _child === void 0 ? void 0 : _child.value) !== null && _child$value !== void 0 ? _child$value : '';
+  };
+  const num = v => v == null ? NaN : Number(v);
+  const adName = (_child$value2 = (_child2 = child(root, 'AdName')) === null || _child2 === void 0 ? void 0 : _child2.value) !== null && _child$value2 !== void 0 ? _child$value2 : '';
+  const backgroundsNode = child(root, 'Backgrounds');
+  const backgrounds = backgroundsNode ? childrenByName(backgroundsNode, 'Background').map(bg => ({
+    orientation: bg.attributes.orientation,
+    width: num(bg.attributes.width),
+    height: num(bg.attributes.height),
+    type: bg.attributes.type,
+    url: urlOf(bg)
+  })) : [];
+  const logosNode = child(root, 'Logos');
+  const logos = logosNode ? childrenByName(logosNode, 'Logo').map(logo => ({
+    role: logo.attributes.role,
+    width: num(logo.attributes.width),
+    height: num(logo.attributes.height),
+    type: logo.attributes.type,
+    url: urlOf(logo)
+  })) : [];
+  const ctaNode = child(root, 'CTA');
+  const cta = {
+    label: ctaNode ? (_child$value3 = (_child3 = child(ctaNode, 'Label')) === null || _child3 === void 0 ? void 0 : _child3.value) !== null && _child$value3 !== void 0 ? _child$value3 : '' : '',
+    type: ctaNode ? (_child$value4 = (_child4 = child(ctaNode, 'Type')) === null || _child4 === void 0 ? void 0 : _child4.value) !== null && _child$value4 !== void 0 ? _child$value4 : '' : ''
+  };
+  return {
+    adName,
+    adType: MAP_EXTENSION_NAME_AD_TYPE[root.name] || interactive_common_pb.AdType.SIDE_BY_SIDE,
+    landscapeBackground: (_backgrounds$find = backgrounds.find(b => b.orientation === 'landscape')) === null || _backgrounds$find === void 0 ? void 0 : _backgrounds$find.url,
+    portraitBackground: (_backgrounds$find2 = backgrounds.find(b => b.orientation === 'portrait')) === null || _backgrounds$find2 === void 0 ? void 0 : _backgrounds$find2.url,
+    sponsorLogo: (_logos$find = logos.find(l => l.role === 'header')) === null || _logos$find === void 0 ? void 0 : _logos$find.url,
+    ctaLabel: cta.label
+  };
+}
+
+exports.parseVastExtension = parseVastExtension;

package/lib/classic/cjs/units/pause-ad-card.js

@@ -0,0 +1,134 @@
+'use strict';
+
+require('core-js/modules/esnext.iterator.constructor.js');
+require('core-js/modules/esnext.iterator.filter.js');
+require('core-js/modules/esnext.iterator.map.js');
+var interactive_common_pb = require('@streamlayer/sl-eslib/interactive/interactive.common_pb');
+
+/**
+ * Insight body cap (SC-353). Studio enforces it on the Additional Content field; the
+ * SDK clamps as well so a card authored before the limit landed cannot overflow the
+ * screen — the format is explicitly designed to fit without scrolling.
+ */
+const INSIGHT_BODY_MAX_LENGTH = 600;
+/**
+ * Sponsor logo for a factoid card. Same General-tab opt-in as the promotion path below,
+ * but the logo lives on `question.promotion.sponsor` (a factoid card carries no
+ * `PromotionOptions`) and Studio writes the uploaded file to `logo`, not `centerLogo`.
+ *
+ * `logo` therefore WINS over `centerLogo`: the latter is an optional field carried over from the
+ * notification/header surfaces, so a card that kept a stale `centerLogo` from an earlier revision
+ * would otherwise render it instead of the Insight logo the author just uploaded.
+ */
+const resolveInsightSponsorLogo = question => {
+  var _question$promotion, _question$promotion2;
+  const sponsor = (_question$promotion = question.promotion) === null || _question$promotion === void 0 ? void 0 : _question$promotion.sponsor;
+  if ((sponsor === null || sponsor === void 0 ? void 0 : sponsor.logoPosition) === interactive_common_pb.NotificationSponsorLogoMode.NOTIFICATION_SPONSOR_LOGO_NONE) {
+    return undefined;
+  }
+  return (sponsor === null || sponsor === void 0 ? void 0 : sponsor.useGeneralLogo) === interactive_common_pb.UseGeneralLogo.ENABLED ? ((_question$promotion2 = question.promotion) === null || _question$promotion2 === void 0 || (_question$promotion2 = _question$promotion2.generalTabMetadata) === null || _question$promotion2 === void 0 ? void 0 : _question$promotion2.advertiserTransparentLogo) || undefined : (sponsor === null || sponsor === void 0 ? void 0 : sponsor.logo) || (sponsor === null || sponsor === void 0 ? void 0 : sponsor.centerLogo) || undefined;
+};
+const MEDIA_MODE_BY_PROTO = {
+  [interactive_common_pb.FactoidMediaMode.IMAGE]: 'image',
+  [interactive_common_pb.FactoidMediaMode.CIRCLE]: 'circle'
+};
+/**
+ * Insight Pause Ad, Full Bleed (SC-353). A factoid card, so none of the promotion
+ * plumbing above applies: the heading is the question subject, the body is
+ * `FactoidOptions.body`, and the sponsor logo comes off `question.promotion.sponsor`.
+ *
+ * `FACTOID_MEDIA_MODE_VIDEO` is deliberately treated as "no media": the full-bleed
+ * format has no player chrome and no way to start playback, unlike the sidebar variant.
+ */
+const parseInsightPauseAdCard = question => {
+  var _question$options, _MEDIA_MODE_BY_PROTO$, _question$backgroundI;
+  const factoidOptions = ((_question$options = question.options) === null || _question$options === void 0 ? void 0 : _question$options.options.case) === 'factoid' ? question.options.options.value : undefined;
+  if (!factoidOptions) {
+    return null;
+  }
+  const mediaMode = (_MEDIA_MODE_BY_PROTO$ = MEDIA_MODE_BY_PROTO[factoidOptions.mode]) !== null && _MEDIA_MODE_BY_PROTO$ !== void 0 ? _MEDIA_MODE_BY_PROTO$ : 'none';
+  const body = factoidOptions.body.slice(0, INSIGHT_BODY_MAX_LENGTH);
+  return {
+    id: question.id,
+    parentId: question.eventId || question.id,
+    // `landscapeUrl` ONLY. `portraitUrl` keeps stale artwork from earlier revisions of the
+    // card that Studio no longer shows in its Background Image slot, so falling back to it
+    // paints a background the author has already removed. Unlike the standard card, an
+    // Insight one renders fine with no background at all — its copy is the ad.
+    backgroundImageSrc: ((_question$backgroundI = question.backgroundImage) === null || _question$backgroundI === void 0 ? void 0 : _question$backgroundI.landscapeUrl) || undefined,
+    kind: 'insight',
+    layout: 'left',
+    isInteractive: false,
+    logoSrc: resolveInsightSponsorLogo(question),
+    title: question.subject || undefined,
+    description: body || undefined,
+    mediaSrc: mediaMode === 'none' ? undefined : factoidOptions.image || undefined,
+    mediaMode
+  };
+};
+const parsePauseAdCard = question => {
+  var _question$options2, _question$backgroundI2, _question$options3, _pauseAdOptions$layou, _question$promotion3, _promotionOptions$ban, _promotionOptions$ban2, _pauseAdOptions$qrCod, _pauseAdOptions$qrCod2;
+  if (((_question$options2 = question.options) === null || _question$options2 === void 0 ? void 0 : _question$options2.options.case) === 'factoid') {
+    return parseInsightPauseAdCard(question);
+  }
+  const backgroundImageSrc = (_question$backgroundI2 = question.backgroundImage) === null || _question$backgroundI2 === void 0 ? void 0 : _question$backgroundI2.landscapeUrl;
+  if (!backgroundImageSrc) {
+    return null;
+  }
+  const promotionOptions = ((_question$options3 = question.options) === null || _question$options3 === void 0 ? void 0 : _question$options3.options.case) === 'promotion' ? question.options.options.value : undefined;
+  const pauseAdOptions = promotionOptions === null || promotionOptions === void 0 ? void 0 : promotionOptions.pauseAdOptions;
+  const optionsSponsor = promotionOptions === null || promotionOptions === void 0 ? void 0 : promotionOptions.sponsor;
+  const layoutProto = (_pauseAdOptions$layou = pauseAdOptions === null || pauseAdOptions === void 0 ? void 0 : pauseAdOptions.layout) !== null && _pauseAdOptions$layou !== void 0 ? _pauseAdOptions$layou : interactive_common_pb.PauseAdLayout.UNSET;
+  const layout = layoutProto === interactive_common_pb.PauseAdLayout.CENTER ? 'center' : layoutProto === interactive_common_pb.PauseAdLayout.IMAGE ? 'image' : 'left';
+  const isInteractive = (promotionOptions === null || promotionOptions === void 0 ? void 0 : promotionOptions.buttonType) === interactive_common_pb.PromotionButtonType.SEND_TO_USER;
+  const hasQr = (pauseAdOptions === null || pauseAdOptions === void 0 ? void 0 : pauseAdOptions.qrCode) === interactive_common_pb.QRCode.QR_CODE_ENABLED && !!(pauseAdOptions !== null && pauseAdOptions !== void 0 && pauseAdOptions.qrCodeUrl);
+  let ctaLabel;
+  let ctaUrl;
+  if (isInteractive && (promotionOptions === null || promotionOptions === void 0 ? void 0 : promotionOptions.buttonOptions.case) === 'sendToUserOptions') {
+    const accountInfo = promotionOptions.buttonOptions.value.userAccountInfo;
+    const isPhone = accountInfo === interactive_common_pb.UserAccountInfo.PHONE;
+    ctaUrl = isPhone ? 'sendToPhone:' : 'sendToEmail:';
+    ctaLabel = isPhone ? 'Send info to account phone' : 'Send info to account email';
+  }
+  const logoSrc = (optionsSponsor === null || optionsSponsor === void 0 ? void 0 : optionsSponsor.logoPosition) === interactive_common_pb.NotificationSponsorLogoMode.NOTIFICATION_SPONSOR_LOGO_NONE ? undefined : (optionsSponsor === null || optionsSponsor === void 0 ? void 0 : optionsSponsor.useGeneralLogo) === interactive_common_pb.UseGeneralLogo.ENABLED ? ((_question$promotion3 = question.promotion) === null || _question$promotion3 === void 0 || (_question$promotion3 = _question$promotion3.generalTabMetadata) === null || _question$promotion3 === void 0 ? void 0 : _question$promotion3.advertiserTransparentLogo) || undefined : (optionsSponsor === null || optionsSponsor === void 0 ? void 0 : optionsSponsor.centerLogo) || undefined;
+  return {
+    id: question.id,
+    parentId: question.eventId || question.id,
+    backgroundImageSrc,
+    layout,
+    logoSrc,
+    title: (promotionOptions === null || promotionOptions === void 0 || (_promotionOptions$ban = promotionOptions.banner) === null || _promotionOptions$ban === void 0 ? void 0 : _promotionOptions$ban.title) || undefined,
+    description: (promotionOptions === null || promotionOptions === void 0 || (_promotionOptions$ban2 = promotionOptions.banner) === null || _promotionOptions$ban2 === void 0 ? void 0 : _promotionOptions$ban2.body) || undefined,
+    isInteractive,
+    ctaLabel: ctaLabel || undefined,
+    ctaUrl: ctaUrl || undefined,
+    qrCodeUrl: hasQr ? (_pauseAdOptions$qrCod = pauseAdOptions === null || pauseAdOptions === void 0 ? void 0 : pauseAdOptions.qrCodeUrl) !== null && _pauseAdOptions$qrCod !== void 0 ? _pauseAdOptions$qrCod : undefined : undefined,
+    qrCodeLabel: hasQr ? (_pauseAdOptions$qrCod2 = pauseAdOptions === null || pauseAdOptions === void 0 ? void 0 : pauseAdOptions.qrCodeLabel) !== null && _pauseAdOptions$qrCod2 !== void 0 ? _pauseAdOptions$qrCod2 : undefined : undefined
+  };
+};
+/**
+ * Which cards from `pauseAdList` the SDK can actually draw. Both renderers are full bleed; a
+ * Sidebar-format pause ad has no chrome yet and is skipped.
+ */
+const isFullBleedPauseAd = question => {
+  var _question$options4, _question$options5;
+  if (((_question$options4 = question.options) === null || _question$options4 === void 0 ? void 0 : _question$options4.options.case) === 'factoid') {
+    // Insight Pause Ad (SC-353). Studio does not write `CardFormat` on these cards yet
+    // (SLW-7062), so an UNSET format is taken as Full Bleed — the only Insight pause-ad chrome
+    // the SDK has. An explicit Sidebar stays out. Drop the UNSET arm once Studio sets the field.
+    return question.format === interactive_common_pb.CardFormat.FULL_BLEED || question.format === interactive_common_pb.CardFormat.UNSET;
+  }
+  const promotionOptions = ((_question$options5 = question.options) === null || _question$options5 === void 0 ? void 0 : _question$options5.options.case) === 'promotion' ? question.options.options.value : undefined;
+  return (promotionOptions === null || promotionOptions === void 0 ? void 0 : promotionOptions.format) === interactive_common_pb.PromotionFormat.FULL_BLEED || question.format === interactive_common_pb.CardFormat.FULL_BLEED;
+};
+/**
+ * The `pauseAdList` response, shaped for the renderers: keep the cards the SDK has chrome for,
+ * turn each into a `PauseAdCard`, drop the ones that cannot be drawn.
+ *
+ * Pure on purpose — `pause-ad.ts` owns the store and the transport, this owns the card shapes,
+ * and only this half needs unit tests.
+ */
+const parsePauseAdCards = questions => questions.filter(isFullBleedPauseAd).map(parsePauseAdCard).filter(card => card !== null);
+
+exports.INSIGHT_BODY_MAX_LENGTH = INSIGHT_BODY_MAX_LENGTH;
+exports.parsePauseAdCards = parsePauseAdCards;

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

@@ -0,0 +1,72 @@
+'use strict';
+
+var _rollupPluginBabelHelpers = require('../_virtual/_rollupPluginBabelHelpers.js');
+var classic = require('@streamlayer/sdk-web-logger/classic');
+var nanostores = require('nanostores');
+require('@streamlayer/sdk-web-api/classic');
+require('@streamlayer/sdk-web-core/classic/store');
+var interactive_feed_pb = require('@streamlayer/sl-eslib/interactive/feed/interactive.feed_pb');
+var pauseAdCard = require('./pause-ad-card.js');
+
+const log = classic.createLogger('advertisement:pause-ad');
+const pauseAdListStore = instance => {
+  const $slStreamId = instance.stores.slStreamId.getAtomStore();
+  return ($enabled, options) => {
+    const {
+      client,
+      queryKey
+    } = instance.transport.createPromiseClient(interactive_feed_pb.Feed, {
+      method: 'pauseAdList',
+      params: [$slStreamId, $enabled]
+    });
+    const $list = instance.transport.nanoquery.createFetcherStore(queryKey, {
+      dedupeTime: 0,
+      revalidateInterval: options.refetchInterval > 0 ? options.refetchInterval : 0,
+      fetcher: function () {
+        var _ref = _rollupPluginBabelHelpers.asyncToGenerator(function* (_, __, eventId, isEnabled) {
+          var _res$data;
+          if (!eventId || typeof eventId !== 'string' || !isEnabled) {
+            return [];
+          }
+          log.debug({
+            eventId
+          }, 'fetching pause ad list');
+          const res = yield client.pauseAdList({
+            eventId
+          });
+          const cards = pauseAdCard.parsePauseAdCards((_res$data = res.data) !== null && _res$data !== void 0 ? _res$data : []);
+          log.debug({
+            count: cards.length
+          }, 'parsed %d fullbleed pause ad cards');
+          return cards;
+        });
+        return function fetcher(_x, _x2, _x3, _x4) {
+          return _ref.apply(this, arguments);
+        };
+      }()
+    });
+    const $index = nanostores.atom(0);
+    const next = () => {
+      const list = $list.get().data;
+      if (!(list !== null && list !== void 0 && list.length)) return;
+      $index.set(($index.get() + 1) % list.length);
+    };
+    const reset = () => {
+      $index.set(0);
+    };
+    const getCurrent = () => {
+      const list = $list.get().data;
+      if (!(list !== null && list !== void 0 && list.length)) return undefined;
+      return list[$index.get()];
+    };
+    return {
+      $list,
+      $index,
+      next,
+      reset,
+      getCurrent
+    };
+  };
+};
+
+exports.pauseAdListStore = pauseAdListStore;

package/lib/classic/cjs/units/ssai-ad-break.js

@@ -0,0 +1,11 @@
+'use strict';
+
+var classic = require('@streamlayer/sdk-web-interfaces/classic');
+
+/**
+ * Imperative atom driven directly by the detector (no nanoquery — the trigger
+ * is push-based, not request/response).
+ */
+const createSsaiAdBreakStore = () => classic.createSingleStore(null);
+
+exports.createSsaiAdBreakStore = createSsaiAdBreakStore;