@bidkernel/analytics 0.9.0 → 0.11.0

package/dist/index.mjs

@@ -1,3 +1,289 @@
+// ../logger/src/index.ts
+var LogLevel = {
+  DEBUG: "DEBUG",
+  INFO: "INFO",
+  WARN: "WARN",
+  ERROR: "ERROR"
+};
+var LOG_LEVEL_MAP = {
+  [LogLevel.DEBUG]: 10,
+  [LogLevel.INFO]: 20,
+  [LogLevel.WARN]: 30,
+  [LogLevel.ERROR]: 40
+};
+var COLORS = {
+  badge: "color: #2dd4bf; font-weight: bold",
+  // teal - [ads] badge
+  badgeWarn: "background: #f59e0b; color: #fff; padding: 2px 4px; border-radius: 3px; font-weight: bold",
+  // amber - [ads] badge (warning)
+  badgeError: "background: #ef4444; color: #fff; padding: 2px 4px; border-radius: 3px; font-weight: bold",
+  // red - [ads] badge (error)
+  dim: "color: #6b7280",
+  // gray - timestamp
+  event: "color: #38bdf8; font-weight: bold",
+  // blue - event name
+  eventWarn: "color: #f59e0b; font-weight: bold",
+  // amber - event name (warning)
+  eventError: "color: #ef4444; font-weight: bold",
+  // red - event name (error)
+  reset: "color: inherit"
+  // back to default
+};
+var logCounter = 0;
+var localGlobalListeners = /* @__PURE__ */ new Set();
+function getGlobalListeners() {
+  if (typeof window !== "undefined") {
+    const win = window;
+    if (!win.__bidkernelLogListeners) {
+      win.__bidkernelLogListeners = /* @__PURE__ */ new Set();
+    }
+    return win.__bidkernelLogListeners;
+  }
+  return localGlobalListeners;
+}
+function formatTime(ms) {
+  if (ms < 0 || !Number.isFinite(ms)) ms = 0;
+  if (ms < 1e3) return `${ms.toFixed(2)}ms`;
+  const s = ms / 1e3;
+  if (s < 60) return `${s.toFixed(2)}s`;
+  const m = Math.floor(s / 60);
+  if (m < 60) return `${m}m ${(s % 60).toFixed(2)}s`;
+  const h = Math.floor(m / 60);
+  return `${h}h ${m % 60}m ${(s % 60).toFixed(2)}s`;
+}
+function normalizeLogLevel(level) {
+  if (typeof level === "string") {
+    const upper = level.toUpperCase();
+    if (upper === "DEBUG" || upper === "INFO" || upper === "WARN" || upper === "ERROR") {
+      return upper;
+    }
+  }
+  return LogLevel.INFO;
+}
+var Logger = class _Logger {
+  _prefix;
+  _level;
+  _loadedAt;
+  _now;
+  _console;
+  _customFormatTime;
+  _listeners = /* @__PURE__ */ new Set();
+  constructor(options = {}) {
+    this._prefix = options.prefix ?? "[bidkernel]";
+    this._level = normalizeLogLevel(options.logLevel ?? LogLevel.INFO);
+    this._now = options.now;
+    this._console = options.console;
+    this._customFormatTime = options.formatTime;
+    if (options.onLog) {
+      this._listeners.add(options.onLog);
+    }
+    this._loadedAt = options.loadedAt ?? (this._now ? this._now() : typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now());
+  }
+  get prefix() {
+    return this._prefix;
+  }
+  set prefix(val) {
+    this._prefix = val;
+  }
+  get logLevel() {
+    return this._level;
+  }
+  set logLevel(val) {
+    this._level = normalizeLogLevel(val);
+  }
+  getLevel() {
+    return this._level;
+  }
+  setLevel(level) {
+    this._level = normalizeLogLevel(level);
+  }
+  getPrefix() {
+    return this._prefix;
+  }
+  setPrefix(prefix) {
+    this._prefix = prefix;
+  }
+  resetTiming(loadedAt) {
+    this._loadedAt = loadedAt ?? (this._now ? this._now() : typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now());
+  }
+  getLoadedAt() {
+    return this._loadedAt;
+  }
+  addListener(listener) {
+    this._listeners.add(listener);
+    return () => {
+      this._listeners.delete(listener);
+    };
+  }
+  removeListener(listener) {
+    this._listeners.delete(listener);
+  }
+  isEnabled(level) {
+    const target = normalizeLogLevel(level);
+    return (LOG_LEVEL_MAP[target] ?? 20) >= (LOG_LEVEL_MAP[this._level] ?? 20);
+  }
+  formatTime(ms) {
+    if (this._customFormatTime) {
+      return this._customFormatTime(ms);
+    }
+    return formatTime(ms);
+  }
+  _getConsole() {
+    if (this._console) return this._console;
+    if (typeof console !== "undefined") return console;
+    return void 0;
+  }
+  _getElapsed() {
+    const current = this._now ? this._now() : typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now();
+    return Math.max(0, current - this._loadedAt);
+  }
+  _dispatchRecord(record) {
+    for (const l of this._listeners) {
+      try {
+        l(record);
+      } catch {
+      }
+    }
+    const globalListeners = getGlobalListeners();
+    for (const gl of globalListeners) {
+      if (!this._listeners.has(gl)) {
+        try {
+          gl(record);
+        } catch {
+        }
+      }
+    }
+    if (typeof window !== "undefined" && typeof window.dispatchEvent === "function") {
+      try {
+        window.dispatchEvent(new CustomEvent("__bidkernel_log__", { detail: record }));
+      } catch {
+      }
+    }
+  }
+  log(level, nameOrMsg, ...args) {
+    const normLevel = normalizeLogLevel(level);
+    if (!this.isEnabled(normLevel)) {
+      return;
+    }
+    const elapsed = this._getElapsed();
+    const formattedTimeStr = this.formatTime(elapsed);
+    const nowEpoch = Date.now();
+    const recordId = `bk_log_${nowEpoch}_${++logCounter}`;
+    const record = {
+      id: recordId,
+      timestamp: nowEpoch,
+      elapsedMs: elapsed,
+      level: normLevel,
+      prefix: this._prefix,
+      message: nameOrMsg,
+      args,
+      data: args.length === 1 ? args[0] : args.length > 1 ? args : void 0
+    };
+    this._dispatchRecord(record);
+    const c = this._getConsole();
+    if (!c) return;
+    let badgeStyle = COLORS.badge;
+    let eventStyle = COLORS.event;
+    if (normLevel === LogLevel.WARN) {
+      badgeStyle = COLORS.badgeWarn;
+      eventStyle = COLORS.eventWarn;
+    } else if (normLevel === LogLevel.ERROR) {
+      badgeStyle = COLORS.badgeError;
+      eventStyle = COLORS.eventError;
+    }
+    const fmt = `%c${this._prefix}%c ${formattedTimeStr} %c${nameOrMsg}%c`;
+    const styles = [badgeStyle, COLORS.dim, eventStyle, COLORS.reset];
+    const callArgs = [fmt, ...styles];
+    if (args.length > 0) {
+      callArgs.push(...args);
+    }
+    switch (normLevel) {
+      case LogLevel.DEBUG:
+        if (typeof c.log === "function") {
+          c.log(...callArgs);
+        } else if (typeof c.debug === "function") {
+          c.debug(...callArgs);
+        }
+        break;
+      case LogLevel.INFO:
+        if (typeof c.info === "function") {
+          c.info(...callArgs);
+        } else if (typeof c.log === "function") {
+          c.log(...callArgs);
+        }
+        break;
+      case LogLevel.WARN:
+        if (typeof c.warn === "function") {
+          c.warn(...callArgs);
+        } else if (typeof c.log === "function") {
+          c.log(...callArgs);
+        }
+        break;
+      case LogLevel.ERROR:
+        if (typeof c.error === "function") {
+          c.error(...callArgs);
+        } else if (typeof c.log === "function") {
+          c.log(...callArgs);
+        }
+        break;
+      default:
+        if (typeof c.log === "function") {
+          c.log(...callArgs);
+        }
+        break;
+    }
+  }
+  debug(nameOrMsg, ...args) {
+    this.log(LogLevel.DEBUG, nameOrMsg, ...args);
+  }
+  info(nameOrMsg, ...args) {
+    this.log(LogLevel.INFO, nameOrMsg, ...args);
+  }
+  warn(nameOrMsg, ...args) {
+    this.log(LogLevel.WARN, nameOrMsg, ...args);
+  }
+  error(nameOrMsg, ...args) {
+    this.log(LogLevel.ERROR, nameOrMsg, ...args);
+  }
+  logEvent(event) {
+    if (!event) return;
+    if (event.data !== void 0) {
+      this.log(event.level, event.eventName, event.data);
+    } else {
+      this.log(event.level, event.eventName);
+    }
+  }
+  child(subNamespace, options = {}) {
+    let childPrefix = this._prefix;
+    if (subNamespace) {
+      const formattedSub = subNamespace.startsWith("[") && subNamespace.endsWith("]") ? subNamespace : `[${subNamespace}]`;
+      childPrefix = `${this._prefix}${formattedSub}`;
+    }
+    return new _Logger({
+      prefix: childPrefix,
+      logLevel: options.logLevel ?? this._level,
+      loadedAt: options.loadedAt ?? this._loadedAt,
+      now: options.now ?? this._now,
+      console: options.console ?? this._console,
+      formatTime: options.formatTime ?? this._customFormatTime,
+      ...options
+    });
+  }
+  withPrefix(prefix) {
+    return new _Logger({
+      prefix,
+      logLevel: this._level,
+      loadedAt: this._loadedAt,
+      now: this._now,
+      console: this._console,
+      formatTime: this._customFormatTime
+    });
+  }
+};
+function createLogger(options) {
+  return new Logger(options);
+}
+
 // ../../protogen/trace_event.ts
 import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
 var TraceEventType = {
@@ -967,8 +1253,264 @@ function parseBidDimensions(bid) {
     height: Number.isFinite(bid?.height) ? bid.height : 0
   };
 }
+var adsLoaderListenerMap = /* @__PURE__ */ new WeakMap();
+function hookAdsManagerLoadedEvent(loadedEventCtor) {
+  if (!loadedEventCtor) return;
+  try {
+    const loadedProto = loadedEventCtor.prototype;
+    if (loadedProto && typeof loadedProto.getAdsManager === "function" && !loadedProto.getAdsManager.__bidkernelHooked) {
+      const originalGetAdsManager = loadedProto.getAdsManager;
+      const hookedGetAdsManager = function(...args) {
+        const adsManager = originalGetAdsManager.apply(this, args);
+        if (adsManager) {
+          for (const instance of BidkernelPrebidAnalytics.getActiveInstances()) {
+            try {
+              instance.attachImaAdsManager(adsManager);
+            } catch {
+            }
+          }
+        }
+        return adsManager;
+      };
+      hookedGetAdsManager.__bidkernelHooked = true;
+      loadedProto.getAdsManager = hookedGetAdsManager;
+    }
+  } catch {
+  }
+}
+function hookAdsManagerPrototype(adsManagerCtorOrProto) {
+  if (!adsManagerCtorOrProto) return;
+  try {
+    const proto = adsManagerCtorOrProto.prototype || adsManagerCtorOrProto;
+    if (proto && typeof proto.init === "function" && !proto.init.__bidkernelHooked) {
+      const origInit = proto.init;
+      const hookedInit = function(...args) {
+        for (const instance of BidkernelPrebidAnalytics.getActiveInstances()) {
+          try {
+            instance.attachImaAdsManager(this);
+          } catch {
+          }
+        }
+        return origInit.apply(this, args);
+      };
+      hookedInit.__bidkernelHooked = true;
+      proto.init = hookedInit;
+    }
+    if (proto && typeof proto.start === "function" && !proto.start.__bidkernelHooked) {
+      const origStart = proto.start;
+      const hookedStart = function(...args) {
+        for (const instance of BidkernelPrebidAnalytics.getActiveInstances()) {
+          try {
+            instance.attachImaAdsManager(this);
+          } catch {
+          }
+        }
+        return origStart.apply(this, args);
+      };
+      hookedStart.__bidkernelHooked = true;
+      proto.start = hookedStart;
+    }
+  } catch {
+  }
+}
+function hookAdsLoader(adsLoaderCtor) {
+  if (!adsLoaderCtor) return;
+  try {
+    const proto = adsLoaderCtor.prototype;
+    if (!proto) return;
+    if (typeof proto.addEventListener === "function" && !proto.addEventListener.__bidkernelHooked) {
+      const origAddEventListener = proto.addEventListener;
+      const hookedAddEventListener = function(type, listener, ...rest) {
+        if ((type === "adsManagerLoaded" || type === (this?.AdsManagerLoadedEvent?.Type?.ADS_MANAGER_LOADED || "adsManagerLoaded")) && typeof listener === "function") {
+          let wrappedListener = adsLoaderListenerMap.get(listener);
+          if (!wrappedListener) {
+            wrappedListener = function(event) {
+              if (event && typeof event.getAdsManager === "function" && !event.getAdsManager.__bidkernelHooked) {
+                const origGetAdsManager = event.getAdsManager;
+                event.getAdsManager = function(...args) {
+                  const adsManager = origGetAdsManager.apply(this, args);
+                  if (adsManager) {
+                    for (const sdk of BidkernelPrebidAnalytics.getActiveInstances()) {
+                      try {
+                        sdk.attachImaAdsManager(adsManager);
+                      } catch {
+                      }
+                    }
+                  }
+                  return adsManager;
+                };
+                event.getAdsManager.__bidkernelHooked = true;
+              }
+              return listener.apply(this, arguments);
+            };
+            adsLoaderListenerMap.set(listener, wrappedListener);
+          }
+          return origAddEventListener.call(this, type, wrappedListener, ...rest);
+        }
+        return origAddEventListener.call(this, type, listener, ...rest);
+      };
+      hookedAddEventListener.__bidkernelHooked = true;
+      proto.addEventListener = hookedAddEventListener;
+    }
+    if (typeof proto.removeEventListener === "function" && !proto.removeEventListener.__bidkernelHooked) {
+      const origRemoveEventListener = proto.removeEventListener;
+      const hookedRemoveEventListener = function(type, listener, ...rest) {
+        const wrapped = typeof listener === "function" ? adsLoaderListenerMap.get(listener) : void 0;
+        return origRemoveEventListener.call(this, type, wrapped || listener, ...rest);
+      };
+      hookedRemoveEventListener.__bidkernelHooked = true;
+      proto.removeEventListener = hookedRemoveEventListener;
+    }
+  } catch {
+  }
+}
+function hookImaPrototype(ima) {
+  if (!ima || typeof ima !== "object") return;
+  try {
+    if (ima.AdsManagerLoadedEvent) {
+      hookAdsManagerLoadedEvent(ima.AdsManagerLoadedEvent);
+    }
+    const loadedDesc = Object.getOwnPropertyDescriptor(ima, "AdsManagerLoadedEvent");
+    if (!loadedDesc || loadedDesc.configurable) {
+      let _loadedEvent = ima.AdsManagerLoadedEvent;
+      try {
+        Object.defineProperty(ima, "AdsManagerLoadedEvent", {
+          configurable: true,
+          enumerable: true,
+          get() {
+            return _loadedEvent;
+          },
+          set(val) {
+            _loadedEvent = val;
+            hookAdsManagerLoadedEvent(val);
+          }
+        });
+      } catch {
+      }
+    }
+    if (ima.AdsLoader) {
+      hookAdsLoader(ima.AdsLoader);
+    }
+    const loaderDesc = Object.getOwnPropertyDescriptor(ima, "AdsLoader");
+    if (!loaderDesc || loaderDesc.configurable) {
+      let _loader = ima.AdsLoader;
+      try {
+        Object.defineProperty(ima, "AdsLoader", {
+          configurable: true,
+          enumerable: true,
+          get() {
+            return _loader;
+          },
+          set(val) {
+            _loader = val;
+            hookAdsLoader(val);
+          }
+        });
+      } catch {
+      }
+    }
+    if (ima.AdsManager) {
+      hookAdsManagerPrototype(ima.AdsManager);
+    }
+    const mgrDesc = Object.getOwnPropertyDescriptor(ima, "AdsManager");
+    if (!mgrDesc || mgrDesc.configurable) {
+      let _mgr = ima.AdsManager;
+      try {
+        Object.defineProperty(ima, "AdsManager", {
+          configurable: true,
+          enumerable: true,
+          get() {
+            return _mgr;
+          },
+          set(val) {
+            _mgr = val;
+            hookAdsManagerPrototype(val);
+          }
+        });
+      } catch {
+      }
+    }
+  } catch {
+  }
+}
+function initImaInterception() {
+  if (typeof window === "undefined") return;
+  const win = window;
+  if (win.google?.ima) {
+    hookImaPrototype(win.google.ima);
+  }
+  if (win.google && typeof win.google === "object") {
+    const imaDesc = Object.getOwnPropertyDescriptor(win.google, "ima");
+    if (!imaDesc || imaDesc.configurable) {
+      let _ima = win.google.ima;
+      try {
+        Object.defineProperty(win.google, "ima", {
+          configurable: true,
+          enumerable: true,
+          get() {
+            return _ima;
+          },
+          set(val) {
+            _ima = val;
+            hookImaPrototype(val);
+          }
+        });
+      } catch {
+      }
+    }
+  }
+  const googleDesc = Object.getOwnPropertyDescriptor(win, "google");
+  if (!googleDesc || googleDesc.configurable) {
+    let _google = win.google;
+    try {
+      Object.defineProperty(win, "google", {
+        configurable: true,
+        enumerable: true,
+        get() {
+          return _google;
+        },
+        set(val) {
+          _google = val;
+          if (_google && typeof _google === "object") {
+            if (_google.ima) {
+              hookImaPrototype(_google.ima);
+            }
+            const iDesc = Object.getOwnPropertyDescriptor(_google, "ima");
+            if (!iDesc || iDesc.configurable) {
+              let _i = _google.ima;
+              try {
+                Object.defineProperty(_google, "ima", {
+                  configurable: true,
+                  enumerable: true,
+                  get() {
+                    return _i;
+                  },
+                  set(iv) {
+                    _i = iv;
+                    hookImaPrototype(iv);
+                  }
+                });
+              } catch {
+              }
+            }
+          }
+        }
+      });
+    } catch {
+    }
+  }
+}
+if (typeof window !== "undefined") {
+  initImaInterception();
+}
 var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
   static activeInstances = /* @__PURE__ */ new Set();
+  static getActiveInstances() {
+    return _BidkernelPrebidAnalytics.activeInstances;
+  }
+  static initImaInterception() {
+    initImaInterception();
+  }
   config;
   queue = [];
   errorCount = 0;
@@ -1005,6 +1547,7 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
   videoDetachCleanups = /* @__PURE__ */ new Set();
   // Compacted bidder participation map per auction: auctionId -> Map<`${bidder}:${adUnitCode}`, BidderOutcomeEntry>
   auctionBidderOutcomes = /* @__PURE__ */ new Map();
+  logger;
   constructor(config) {
     const requestedEndpoint = config.endpoint || "";
     const endpoint = !requestedEndpoint || isTrustedEndpoint(requestedEndpoint) ? requestedEndpoint : "";
@@ -1025,6 +1568,10 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
       pbjsGlobalName: config.pbjsGlobalName || "pbjs",
       attachPbjsListeners: config.attachPbjsListeners ?? true
     };
+    this.logger = createLogger({
+      prefix: "[bidkernel][prebid-analytics]",
+      logLevel: this.config.logLevel
+    });
     if (requestedEndpoint && !endpoint) {
       this.log(
         "ERROR",
@@ -1041,6 +1588,7 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
     if (this.isEnabled) return;
     this.isEnabled = true;
     _BidkernelPrebidAnalytics.activeInstances.add(this);
+    this.logger.setLevel(this.config.logLevel);
     if (!this.config.endpoint) {
       this.log("WARN", "Endpoint is empty. Analytics events will not be transmitted.");
     }
@@ -1132,6 +1680,10 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
       }
       this.flushTimer = setInterval(() => this.flush(), FLUSH_INTERVAL_MS);
       this.resendPersistedBatches();
+      initImaInterception();
+      if (window.google?.ima) {
+        hookImaPrototype(window.google.ima);
+      }
     }
   }
   disable() {
@@ -1612,6 +2164,72 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
       this.cachedWinningBids.delete(oldest.value);
     }
   }
+  /**
+   * Searches cached winning bids for an entry matching the given filters (creativeId,
+   * adId, or mediaType), falling back to the most recent winning video bid.
+   */
+  findCachedWinningBid(filter) {
+    const now = Date.now();
+    const isConsumed = (entry) => {
+      return this.hasImpressionEmitted(
+        entry.adUnitCode,
+        void 0,
+        entry.auctionId,
+        entry.bidTrace.creativeId
+      );
+    };
+    if (filter?.creativeId || filter?.adId) {
+      for (const entry of Array.from(this.cachedWinningBids.values())) {
+        if (now - entry.timestamp > CACHED_BID_TTL_MS) continue;
+        if (filter.creativeId && (entry.bidTrace.creativeId === filter.creativeId || entry.rawBid?.creativeId === filter.creativeId) || filter.adId && (entry.rawBid?.adId === filter.adId || entry.adUnitCode === filter.adId)) {
+          return entry;
+        }
+      }
+    }
+    let bestUnconsumedMatch;
+    if (filter?.mediaType) {
+      for (const entry of Array.from(this.cachedWinningBids.values())) {
+        if (now - entry.timestamp > CACHED_BID_TTL_MS) continue;
+        const isEntryVideo = entry.bidTrace.mediaType === filter.mediaType || entry.rawBid?.mediaType === filter.mediaType || filter.mediaType === "video" && entry.rawBid?.mediaTypes?.video !== void 0;
+        if (isEntryVideo) {
+          if (!isConsumed(entry)) {
+            if (!bestUnconsumedMatch || entry.timestamp < bestUnconsumedMatch.timestamp) {
+              bestUnconsumedMatch = entry;
+            }
+          }
+        }
+      }
+      if (bestUnconsumedMatch) return bestUnconsumedMatch;
+      let bestFallbackMatch;
+      for (const entry of Array.from(this.cachedWinningBids.values())) {
+        if (now - entry.timestamp > CACHED_BID_TTL_MS) continue;
+        const isEntryVideo = entry.bidTrace.mediaType === filter.mediaType || entry.rawBid?.mediaType === filter.mediaType || filter.mediaType === "video" && entry.rawBid?.mediaTypes?.video !== void 0;
+        if (isEntryVideo) {
+          if (!bestFallbackMatch || entry.timestamp > bestFallbackMatch.timestamp) {
+            bestFallbackMatch = entry;
+          }
+        }
+      }
+      if (bestFallbackMatch) return bestFallbackMatch;
+    }
+    for (const entry of Array.from(this.cachedWinningBids.values())) {
+      if (now - entry.timestamp > CACHED_BID_TTL_MS) continue;
+      if (!isConsumed(entry)) {
+        if (!bestUnconsumedMatch || entry.timestamp > bestUnconsumedMatch.timestamp) {
+          bestUnconsumedMatch = entry;
+        }
+      }
+    }
+    if (bestUnconsumedMatch) return bestUnconsumedMatch;
+    let bestRecent;
+    for (const entry of Array.from(this.cachedWinningBids.values())) {
+      if (now - entry.timestamp > CACHED_BID_TTL_MS) continue;
+      if (!bestRecent || entry.timestamp > bestRecent.timestamp) {
+        bestRecent = entry;
+      }
+    }
+    return bestRecent;
+  }
   /** Records a dedup key, evicting oldest-first at the cap. */
   addImpressionKey(key) {
     if (this.slotEmittedImpressionKeys.has(key)) return;
@@ -1771,14 +2389,40 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
       return () => {
       };
     }
+    if (!adsManager.__bidkernelAttachedInstances) {
+      try {
+        Object.defineProperty(adsManager, "__bidkernelAttachedInstances", {
+          value: /* @__PURE__ */ new Set(),
+          configurable: true,
+          writable: true
+        });
+      } catch {
+        adsManager.__bidkernelAttachedInstances = /* @__PURE__ */ new Set();
+      }
+    }
+    if (adsManager.__bidkernelAttachedInstances.has(this)) {
+      return () => {
+      };
+    }
+    adsManager.__bidkernelAttachedInstances.add(this);
     const slotId = options?.slotId || options?.adUnitCode || "video";
     const adUnitCode = options?.adUnitCode || slotId;
     const auctionId = options?.auctionId || "";
     const transactionId = options?.transactionId || "";
-    const getWinningBid = () => {
-      return (auctionId ? this.getCachedBid(`${auctionId}:${adUnitCode}`) : void 0) || (auctionId && slotId !== adUnitCode ? this.getCachedBid(`${auctionId}:${slotId}`) : void 0) || this.getCachedBid(adUnitCode) || (slotId !== adUnitCode ? this.getCachedBid(slotId) : void 0);
+    const getWinningBid = (adData) => {
+      let cached = (auctionId ? this.getCachedBid(`${auctionId}:${adUnitCode}`) : void 0) || (auctionId && slotId !== adUnitCode ? this.getCachedBid(`${auctionId}:${slotId}`) : void 0) || (adUnitCode !== "video" ? this.getCachedBid(adUnitCode) : void 0) || (slotId !== adUnitCode && slotId !== "video" ? this.getCachedBid(slotId) : void 0);
+      if (!cached) {
+        cached = this.findCachedWinningBid({
+          creativeId: adData?.creativeId,
+          adId: adData?.adId,
+          mediaType: "video"
+        });
+      }
+      return cached;
     };
+    let adStarted = false;
     const onAdStartedOrImpression = (event) => {
+      adStarted = true;
       this.log("DEBUG", "IMA AdEvent.STARTED / IMPRESSION received", event);
       const ad = typeof event?.getAd === "function" ? event.getAd() : event?.ad;
       const adData = {};
@@ -1789,16 +2433,20 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
         adData.duration = typeof ad.getDuration === "function" ? ad.getDuration() : ad.duration;
         adData.advertiserName = typeof ad.getAdvertiserName === "function" ? ad.getAdvertiserName() : "";
       }
-      const cached = getWinningBid();
+      const cached = getWinningBid(adData);
+      const resolvedSlotId = options?.slotId && options.slotId !== "video" ? options.slotId : options?.adUnitCode && options.adUnitCode !== "video" ? options.adUnitCode : cached?.adUnitCode || options?.slotId || options?.adUnitCode || "video";
+      const resolvedAdUnitCode = options?.adUnitCode && options.adUnitCode !== "video" ? options.adUnitCode : cached?.adUnitCode || resolvedSlotId;
+      const resolvedAuctionId = auctionId || cached?.auctionId || "";
+      const resolvedTransactionId = transactionId || cached?.transactionId || "";
       const mergedBid = {
         ...cached?.rawBid || options?.bid,
         mediaType: "video",
         creativeId: adData.creativeId || cached?.bidTrace?.creativeId || options?.bid?.creativeId || ""
       };
-      const emitted = this.recordImpression(slotId, {
-        adUnitCode,
-        auctionId: auctionId || cached?.auctionId,
-        transactionId: transactionId || cached?.transactionId,
+      const emitted = this.recordImpression(resolvedSlotId, {
+        adUnitCode: resolvedAdUnitCode,
+        auctionId: resolvedAuctionId,
+        transactionId: resolvedTransactionId,
         mediaType: "video",
         bid: mergedBid,
         metadata: {
@@ -1810,7 +2458,7 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
       });
       if (emitted && options?.onImpression) {
         try {
-          options.onImpression(slotId, { ad, bid: mergedBid });
+          options.onImpression(resolvedSlotId, { ad, bid: mergedBid });
         } catch (e) {
           this.log("ERROR", "Error in onImpression callback", e);
         }
@@ -1829,10 +2477,11 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
     const onAdClick = (event) => {
       this.log("DEBUG", "IMA AdEvent.CLICK received", event);
       const cached = getWinningBid();
+      const resolvedAdUnitCode = options?.adUnitCode && options.adUnitCode !== "video" ? options.adUnitCode : cached?.adUnitCode || slotId;
       this.enqueue(TraceEventType.CLICK, "click", {
         auctionId: auctionId || cached?.auctionId,
         transactionId: transactionId || cached?.transactionId,
-        adUnitCode,
+        adUnitCode: resolvedAdUnitCode,
         bid: cached?.bidTrace || options?.bid,
         metadata: {
           ...options?.metadata,
@@ -1846,14 +2495,16 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
       const msg = (err && typeof err.getMessage === "function" ? err.getMessage() : err?.message) || String(err || "IMA ad error");
       const code = (err && typeof err.getErrorCode === "function" ? err.getErrorCode() : err?.code) || "";
       const cached = getWinningBid();
+      const resolvedAdUnitCode = options?.adUnitCode && options.adUnitCode !== "video" ? options.adUnitCode : cached?.adUnitCode || slotId;
       this.enqueue(TraceEventType.AD_RENDER_FAILED, "adRenderFailed", {
         auctionId: auctionId || cached?.auctionId,
         transactionId: transactionId || cached?.transactionId,
-        adUnitCode,
+        adUnitCode: resolvedAdUnitCode,
         bid: cached?.bidTrace || options?.bid,
         metadata: {
           ...options?.metadata,
-          reason: "ima_ad_error",
+          reason: adStarted ? "ima_playback_error" : "ima_ad_error",
+          playback_phase: adStarted ? "post_start" : "pre_start",
           message: msg,
           ...code ? { ima_error_code: String(code) } : {}
         },
@@ -1870,7 +2521,7 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
     const googleIma = typeof window !== "undefined" ? window.google?.ima : void 0;
     const adEventType = googleIma?.AdEvent?.Type || {};
     const adErrorEventType = googleIma?.AdErrorEvent?.Type || {};
-    const listeners = [
+    const rawListeners = [
       { type: adEventType.STARTED || "started", handler: onAdStartedOrImpression },
       { type: adEventType.IMPRESSION || "impression", handler: onAdStartedOrImpression },
       {
@@ -1886,6 +2537,14 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
       { type: adEventType.CLICK || "click", handler: onAdClick },
       { type: adErrorEventType.AD_ERROR || "adError", handler: onAdError }
     ];
+    const seenListenerTypes = /* @__PURE__ */ new Set();
+    const listeners = [];
+    for (const l of rawListeners) {
+      if (!seenListenerTypes.has(l.type)) {
+        seenListenerTypes.add(l.type);
+        listeners.push(l);
+      }
+    }
     for (const { type, handler } of listeners) {
       try {
         adsManager.addEventListener(type, handler);
@@ -1893,6 +2552,7 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
       }
     }
     const cleanup = () => {
+      adsManager.__bidkernelAttachedInstances?.delete(this);
       for (const { type, handler } of listeners) {
         try {
           adsManager.removeEventListener(type, handler);
@@ -2214,6 +2874,7 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
     } else {
       this.pageUrl = "";
     }
+    this.logger.resetTiming();
     extendSession();
     this.enable();
   }
@@ -2278,7 +2939,8 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
     const adUnitCode = data.adUnitCode || "";
     const cpm = Number.isFinite(data.originalCpm) ? data.originalCpm : Number.isFinite(data.cpm) ? data.cpm : 0;
     const latencyMs = Number.isFinite(data.timeToRespond) ? data.timeToRespond : 0;
-    const mediaType = data.mediaType || "banner";
+    const resMediaTypes = Object.keys(data.mediaTypes || {});
+    const mediaType = data.mediaType || (data.mediaTypes?.video ? "video" : resMediaTypes.length > 0 ? resMediaTypes[0] : "banner");
     if (auctionId && bidder) {
       const auctionMap = this.getOrCreateAuctionOutcomes(auctionId);
       const key = `${bidder}:${adUnitCode}`;
@@ -2351,13 +3013,15 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
     const auctionId = data.auctionId || "";
     const transactionId = data.transactionId || "";
     const adUnitCode = data.adUnitCode || data.adId || "";
+    const wonMediaTypes = Object.keys(data.mediaTypes || {});
+    const resolvedMediaType = data.mediaType || (data.mediaTypes?.video ? "video" : wonMediaTypes.length > 0 ? wonMediaTypes[0] : "banner");
     const bidTrace = {
       bidder: data.bidderCode || data.bidder || "",
       cpm: Number.isFinite(data.originalCpm) ? data.originalCpm : Number.isFinite(data.cpm) ? data.cpm : 0,
       currency: data.originalCurrency ?? data.currency ?? "USD",
       ...parseBidDimensions(data),
       dealId: data.dealId || "",
-      mediaType: data.mediaType || "banner",
+      mediaType: resolvedMediaType,
       latencyMs: Number.isFinite(data.timeToRespond) ? data.timeToRespond : 0,
       advertiserDomain: data.meta?.advertiserDomains?.[0] || "",
       creativeId: data.creativeId || ""
@@ -2446,13 +3110,15 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
     const slotKey = data.adUnitCode || bid.adUnitCode || "";
     const altKey = data.adId || bid.adId || "";
     const cached = (auctionId && slotKey ? this.getCachedBid(`${auctionId}:${slotKey}`) : void 0) || (auctionId && altKey ? this.getCachedBid(`${auctionId}:${altKey}`) : void 0) || (slotKey ? this.getCachedBid(slotKey) : void 0) || (altKey ? this.getCachedBid(altKey) : void 0);
+    const isVideo = mediaType === "video" || bid.mediaType === "video" || bid.mediaTypes?.video !== void 0 || cached?.bidTrace?.mediaType === "video" || cached?.rawBid?.mediaType === "video" || adUnitCode && this.slotViewabilityRecords.get(adUnitCode)?.mediaType === "video";
+    const resolvedMediaType = isVideo ? "video" : mediaType || cached?.bidTrace?.mediaType || "banner";
     const bidTrace = {
       bidder: bid.bidderCode || bid.bidder || cached?.bidTrace?.bidder || "",
       cpm: Number.isFinite(bid.originalCpm) ? bid.originalCpm : Number.isFinite(bid.cpm) ? bid.cpm : cached?.bidTrace?.cpm ?? 0,
       currency: bid.originalCurrency ?? bid.currency ?? cached?.bidTrace?.currency ?? "USD",
       ...parseBidDimensions(bid).width ? parseBidDimensions(bid) : cached?.bidTrace ? { width: cached.bidTrace.width, height: cached.bidTrace.height } : parseBidDimensions(bid),
       dealId: bid.dealId || cached?.bidTrace?.dealId || "",
-      mediaType: mediaType || cached?.bidTrace?.mediaType || "banner",
+      mediaType: resolvedMediaType,
       latencyMs: Number.isFinite(bid.timeToRespond) ? bid.timeToRespond : cached?.bidTrace?.latencyMs ?? 0,
       advertiserDomain: bid.meta?.advertiserDomains?.[0] || cached?.bidTrace?.advertiserDomain || "",
       creativeId: bid.creativeId || cached?.bidTrace?.creativeId || ""
@@ -2491,28 +3157,35 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
       }
     }
     const currentRefreshIndex = adUnitCode ? this.slotRefreshIndices.get(adUnitCode) ?? (record ? record.refreshIndex : 0) : 0;
-    const alreadyEmitted = adUnitCode ? this.hasImpressionEmitted(
-      adUnitCode,
-      currentRefreshIndex,
-      resolvedAuctionId,
-      bidTrace.creativeId
-    ) : false;
-    if (!alreadyEmitted) {
-      if (adUnitCode) {
-        this.markImpressionEmitted(
+    if (!isVideo) {
+      const alreadyEmitted = adUnitCode ? this.hasImpressionEmitted(
+        adUnitCode,
+        currentRefreshIndex,
+        resolvedAuctionId,
+        bidTrace.creativeId
+      ) : false;
+      if (!alreadyEmitted) {
+        if (adUnitCode) {
+          this.markImpressionEmitted(
+            adUnitCode,
+            currentRefreshIndex,
+            resolvedAuctionId,
+            bidTrace.creativeId
+          );
+        }
+        this.enqueue(TraceEventType.IMPRESSION, "impression", {
+          auctionId: resolvedAuctionId,
+          transactionId: resolvedTransactionId,
           adUnitCode,
-          currentRefreshIndex,
-          resolvedAuctionId,
-          bidTrace.creativeId
-        );
+          bid: bidTrace,
+          metadata: { refresh_index: String(currentRefreshIndex) }
+        });
       }
-      this.enqueue(TraceEventType.IMPRESSION, "impression", {
-        auctionId: resolvedAuctionId,
-        transactionId: resolvedTransactionId,
-        adUnitCode,
-        bid: bidTrace,
-        metadata: { refresh_index: String(currentRefreshIndex) }
-      });
+    } else {
+      this.log(
+        "DEBUG",
+        `adRenderSucceeded received for video ad unit ${adUnitCode || "unknown"}: suppressing IMPRESSION until verified video lifecycle event`
+      );
     }
     if (this.config.viewabilityEnabled && typeof document !== "undefined") {
       let el = null;
@@ -2548,7 +3221,7 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
           adUnitCode,
           auctionId: resolvedAuctionId,
           transactionId: resolvedTransactionId,
-          mediaType,
+          mediaType: resolvedMediaType,
           bid: bidTrace,
           refreshIndex: currentRefreshIndex,
           emitRefreshEvent: false
@@ -2881,25 +3554,13 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
     }
   }
   log(level, msg, ...args) {
-    const levels = { DEBUG: 10, INFO: 20, WARN: 30, ERROR: 40 };
-    if (levels[level] < levels[this.config.logLevel]) return;
-    const prefix = `[bidkernel][prebid-analytics][${level}]`;
-    switch (level) {
-      case "DEBUG":
-        console.debug(prefix, msg, ...args);
-        break;
-      case "INFO":
-        console.info(prefix, msg, ...args);
-        break;
-      case "WARN":
-        console.warn(prefix, msg, ...args);
-        break;
-      case "ERROR":
-        console.error(prefix, msg, ...args);
-        break;
-    }
+    this.logger.log(level, msg, ...args);
   }
 };
+var defaultLogger = createLogger({
+  prefix: "[bidkernel]",
+  logLevel: "INFO"
+});
 function extractAnalyticsOptions(config, allowProviderless = true) {
   if (!config) return null;
   if (Array.isArray(config)) {
@@ -2956,8 +3617,8 @@ function registerPrebidAnalytics(pbjsGlobalName = "pbjs", defaults) {
       ...options
     };
     if (pinnedEndpoint && !sameEndpointOrigin(merged.endpoint || "", pinnedEndpoint)) {
-      console.warn(
-        `[bidkernel] Ignoring analytics endpoint change to ${merged.endpoint || "(empty)"}: this page is pinned to ${pinnedEndpoint}. Reload to change the ingest endpoint.`
+      defaultLogger.warn(
+        `Ignoring analytics endpoint change to ${merged.endpoint || "(empty)"}: this page is pinned to ${pinnedEndpoint}. Reload to change the ingest endpoint.`
       );
       merged.endpoint = pinnedEndpoint;
     }
@@ -2965,7 +3626,7 @@ function registerPrebidAnalytics(pbjsGlobalName = "pbjs", defaults) {
       try {
         previous.disable();
       } catch (e) {
-        console.warn("[bidkernel] Failed to disable previous analytics instance:", e);
+        defaultLogger.warn("Failed to disable previous analytics instance:", e);
       }
     }
     const analytics = new BidkernelPrebidAnalytics(merged);
@@ -2998,7 +3659,7 @@ function registerPrebidAnalytics(pbjsGlobalName = "pbjs", defaults) {
         enableInstance(stashed);
       }
     } catch (e) {
-      console.warn("[bidkernel] Failed to register standard Prebid analytics adapter:", e);
+      defaultLogger.warn("Failed to register standard Prebid analytics adapter:", e);
     }
   };
   if (pbjs.adapterManager && typeof pbjs.adapterManager.registerAnalyticsAdapter === "function") {
@@ -3044,6 +3705,8 @@ export {
   PrebidEventDeduper,
   getPrebidEventKey,
   getbidkernel,
+  hookImaPrototype,
+  initImaInterception,
   isTrustedEndpoint,
   registerPrebidAnalytics
 };