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

package/lib/classic/cjs/units/ssai-creative.js

@@ -0,0 +1,142 @@
+'use strict';
+
+var _rollupPluginBabelHelpers = require('../_virtual/_rollupPluginBabelHelpers.js');
+require('core-js/modules/es.array.iterator.js');
+require('core-js/modules/es.promise.js');
+require('core-js/modules/esnext.iterator.constructor.js');
+require('core-js/modules/esnext.iterator.for-each.js');
+require('core-js/modules/web.dom-collections.for-each.js');
+require('core-js/modules/web.dom-collections.iterator.js');
+var ssaiProviders = require('./ssai-providers.js');
+
+/**
+ * Per-instance cache + impression-firing wrapper around a SsaiCreativeProvider.
+ * Caches resolved creatives by creativeId so repeated active-ad polls and pod
+ * repeats don't refetch. In-flight fetches are cancellable via AbortController.
+ */
+class SsaiCreativeCache {
+  constructor(provider) {
+    _rollupPluginBabelHelpers.defineProperty(this, "provider", void 0);
+    _rollupPluginBabelHelpers.defineProperty(this, "cache", new Map());
+    _rollupPluginBabelHelpers.defineProperty(this, "inflight", new Map());
+    /**
+     * The already-resolved creative, or undefined — synchronous on purpose: a
+     * prefetched creative lets the ad break flip straight to 'ready' with no
+     * async gap (which the UI would render as a blink between two ads of a pod).
+     */
+    _rollupPluginBabelHelpers.defineProperty(this, "peek", creativeId => this.cache.get(creativeId));
+    _rollupPluginBabelHelpers.defineProperty(this, "resolve", creativeId => {
+      const cached = this.cache.get(creativeId);
+      if (cached) {
+        return Promise.resolve(cached);
+      }
+      const existing = this.inflight.get(creativeId);
+      if (existing) {
+        return existing.promise;
+      }
+      const controller = new AbortController();
+      const promise = this.provider.resolve(creativeId, controller.signal).then(creative => {
+        this.cache.set(creativeId, creative);
+        this.inflight.delete(creativeId);
+        return creative;
+      }).catch(error => {
+        this.inflight.delete(creativeId);
+        throw error;
+      });
+      this.inflight.set(creativeId, {
+        promise,
+        controller
+      });
+      return promise;
+    });
+    /**
+     * Cancel an in-flight fetch (e.g. the break ended before it resolved).
+     */
+    _rollupPluginBabelHelpers.defineProperty(this, "cancel", creativeId => {
+      const existing = this.inflight.get(creativeId);
+      if (existing) {
+        existing.controller.abort();
+        this.inflight.delete(creativeId);
+      }
+    });
+    /**
+     * Fire the impression for a creative. Delegates to the provider's
+     * `fireImpression` when present, otherwise the shared default (first
+     * trackingEvent named 'impression' via sendBeacon/fetch). Called once per
+     * visible appearance of the bar (the UI dedupes the ~250ms active-poll so a
+     * single continuous appearance fires exactly one impression). Each genuine pod
+     * insertion of the same creative is a distinct impression and re-fires.
+     */
+    _rollupPluginBabelHelpers.defineProperty(this, "fireImpression", creative => {
+      if (this.provider.fireImpression) {
+        this.provider.fireImpression(creative);
+        return;
+      }
+      ssaiProviders.fireDefaultImpression(creative);
+    });
+    /**
+     * Fire the impression for an already-resolved creativeId. No-op if the
+     * creative isn't cached yet (the bar only renders once resolved, so by the
+     * time the UI calls this the creative is present).
+     */
+    _rollupPluginBabelHelpers.defineProperty(this, "fireImpressionById", creativeId => {
+      const creative = this.cache.get(creativeId);
+      if (creative) {
+        this.fireImpression(creative);
+      }
+    });
+    /**
+     * Fire a lifecycle / click beacon. Delegates to the provider's `fireTracking`
+     * when it defines one, otherwise fires every matching `trackingEvents` URL.
+     */
+    _rollupPluginBabelHelpers.defineProperty(this, "fireTracking", (creative, event) => {
+      if (this.provider.fireTracking) {
+        this.provider.fireTracking(creative, event);
+        return;
+      }
+      ssaiProviders.fireTrackingEvents(creative, event);
+    });
+    /**
+     * Fire a beacon for a creativeId that may still be resolving.
+     *
+     * `start` in particular lands the instant the break opens, which is usually
+     * BEFORE the metadata request has come back — dropping it would silently lose
+     * the first beacon of every ad. Resolution is already in flight by then and
+     * `resolve` returns that same promise, so this attaches to it rather than
+     * issuing a second request. A creative that never resolves fires nothing,
+     * which is the correct outcome: there are no URLs to fire.
+     */
+    _rollupPluginBabelHelpers.defineProperty(this, "fireTrackingById", (creativeId, event) => {
+      const cached = this.cache.get(creativeId);
+      if (cached) {
+        this.fireTracking(cached, event);
+        return;
+      }
+      this.resolve(creativeId).then(creative => this.fireTracking(creative, event)).catch(() => undefined);
+    });
+    /**
+     * Fire the companion's `clickTracking` beacons. Separate from
+     * {@link fireTracking} because these live on the companion, not in
+     * `trackingEvents` — a provider's `fireTracking` override has no say over them.
+     */
+    _rollupPluginBabelHelpers.defineProperty(this, "fireCompanionClickById", creativeId => {
+      var _this$cache$get;
+      const companion = (_this$cache$get = this.cache.get(creativeId)) === null || _this$cache$get === void 0 ? void 0 : _this$cache$get.companion;
+      if (!companion) {
+        return;
+      }
+      for (const url of companion.clickTracking) {
+        ssaiProviders.fireBeacon(url);
+      }
+    });
+    _rollupPluginBabelHelpers.defineProperty(this, "destroy", () => {
+      this.inflight.forEach(entry => entry.controller.abort());
+      this.inflight.clear();
+      this.cache.clear();
+    });
+    this.provider = provider;
+  }
+}
+
+exports.DEFAULT_CREATIVE_API_BASE = ssaiProviders.DEFAULT_CREATIVE_API_BASE;
+exports.SsaiCreativeCache = SsaiCreativeCache;