@bidkernel/analytics 0.5.0 → 0.7.0

package/dist/index.mjs

@@ -628,6 +628,11 @@ var MAX_QUEUE_SIZE = 200;
 var MAX_SEND_BACKOFF_MS = 5 * 60 * 1e3;
 var MAX_CONSECUTIVE_SEND_FAILURES = 10;
 var MAX_PAYLOAD_BYTES = 32 * 1024;
+var SAFE_CONTENT_TYPE = "text/plain";
+var PENDING_BATCH_KEY_PREFIX = "_bidkernel_pending_";
+var MAX_PENDING_BATCHES = 20;
+var PENDING_BATCH_MAX_AGE_MS = 2 * 60 * 60 * 1e3;
+var PENDING_BATCH_CLEANUP_DELAY_MS = 1e4;
 var EVENT_NAME_TO_TYPE = {
   auctionStart: TraceEventType.AUCTION_START,
   auctionEnd: TraceEventType.AUCTION_END,
@@ -643,6 +648,11 @@ var EVENT_NAME_TO_TYPE = {
   timeInView: TraceEventType.TIME_IN_VIEW,
   viewable: TraceEventType.VIEWABLE
 };
+var IMMEDIATE_FLUSH_TYPES = /* @__PURE__ */ new Set([
+  TraceEventType.IMPRESSION,
+  TraceEventType.BID_WIN,
+  TraceEventType.CLICK
+]);
 var SESSION_KEY = "_bidkernel_session";
 var SESSION_TS_KEY = "_bidkernel_session_ts";
 var THIRTY_MINUTES_MS = 30 * 60 * 1e3;
@@ -658,6 +668,22 @@ function generateUUID() {
     return v.toString(16);
   });
 }
+function bytesToBase64(bytes) {
+  let binary = "";
+  const chunk = 8192;
+  for (let i = 0; i < bytes.length; i += chunk) {
+    binary += String.fromCharCode(...bytes.subarray(i, i + chunk));
+  }
+  return btoa(binary);
+}
+function base64ToBytes(b64) {
+  const binary = atob(b64);
+  const bytes = new Uint8Array(binary.length);
+  for (let i = 0; i < binary.length; i++) {
+    bytes[i] = binary.charCodeAt(i);
+  }
+  return bytes;
+}
 function extendSession() {
   const now = Date.now();
   inMemorySessionTs = now;
@@ -822,12 +848,25 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
   consecutiveSendFailures = 0;
   nextSendAllowedAt = 0;
   replayedEventCount = 0;
+  immediateFlushScheduled = false;
+  // localStorage keys of exit batches this instance persisted, so a page that
+  // survives its own pagehide/hidden (bfcache restore, tab re-focus) can
+  // remove them instead of leaving them for a duplicate resend.
+  persistedBatchKeys = [];
+  persistedCleanupTimer = null;
   // Viewability & refresh tracking
   intersectionObserver = null;
   slotViewabilityRecords = /* @__PURE__ */ new Map();
   elementToSlotId = /* @__PURE__ */ new Map();
   slotRefreshIndices = /* @__PURE__ */ new Map();
+  slotLastAuctionIds = /* @__PURE__ */ new Map();
   pendingThresholdListeners = /* @__PURE__ */ new Map();
+  // Impression deduplication per slot and refresh cycle (strictly 1 impression per cycle)
+  slotEmittedImpressionKeys = /* @__PURE__ */ new Set();
+  // Winning bid cache from bidWon to marry with subsequent render triggers (adRenderSucceeded, video, etc.)
+  cachedWinningBids = /* @__PURE__ */ new Map();
+  // Active video player attachment cleanup routines
+  videoDetachCleanups = /* @__PURE__ */ new Set();
   constructor(config) {
     this.config = {
       endpoint: config.endpoint || "",
@@ -946,6 +985,7 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
         document.addEventListener("visibilitychange", this.boundVisibilityChange);
       }
       this.flushTimer = setInterval(() => this.flush(), FLUSH_INTERVAL_MS);
+      this.resendPersistedBatches();
     }
   }
   disable() {
@@ -972,10 +1012,24 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
     }
     this.slotViewabilityRecords.clear();
     this.elementToSlotId.clear();
+    for (const cleanup of this.videoDetachCleanups) {
+      try {
+        cleanup();
+      } catch {
+      }
+    }
+    this.videoDetachCleanups.clear();
+    this.cachedWinningBids.clear();
+    this.slotEmittedImpressionKeys.clear();
+    this.slotLastAuctionIds.clear();
     if (this.flushTimer) {
       clearInterval(this.flushTimer);
       this.flushTimer = null;
     }
+    if (this.persistedCleanupTimer) {
+      clearTimeout(this.persistedCleanupTimer);
+      this.persistedCleanupTimer = null;
+    }
     if (typeof window !== "undefined") {
       window.removeEventListener("pagehide", this.boundFlushBeacon);
       if (typeof document !== "undefined") {
@@ -1290,6 +1344,9 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
         if (options?.bid !== void 0) existing.bidPayload = options.bid;
         if (options?.metadata !== void 0) existing.metadata = options.metadata;
       }
+      if (options?.auctionId) {
+        this.slotLastAuctionIds.set(resolvedSlotId, options.auctionId);
+      }
       if (el) {
         if (existing.element && existing.element !== el && this.intersectionObserver) {
           this.intersectionObserver.unobserve(existing.element);
@@ -1302,6 +1359,9 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
     } else {
       const initialRefreshIndex = options?.refreshIndex ?? this.slotRefreshIndices.get(resolvedSlotId) ?? 0;
       this.slotRefreshIndices.set(resolvedSlotId, initialRefreshIndex);
+      if (options?.auctionId) {
+        this.slotLastAuctionIds.set(resolvedSlotId, options.auctionId);
+      }
       const listeners = this.pendingThresholdListeners.get(resolvedSlotId) || /* @__PURE__ */ new Set();
       this.pendingThresholdListeners.delete(resolvedSlotId);
       const record = {
@@ -1357,7 +1417,485 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
     this.unobserveSlot(slotId);
     this.slotViewabilityRecords.delete(slotId);
     this.slotRefreshIndices.delete(slotId);
+    this.slotLastAuctionIds.delete(slotId);
     this.pendingThresholdListeners.delete(slotId);
+    const prefix = `${escapeKeyPart(slotId)}:`;
+    for (const key of Array.from(this.slotEmittedImpressionKeys)) {
+      if (key === slotId || key.startsWith(prefix)) {
+        this.slotEmittedImpressionKeys.delete(key);
+      }
+    }
+    this.cachedWinningBids.delete(slotId);
+  }
+  hasImpressionEmitted(slotId, refreshIndex, auctionId, creativeId) {
+    const rIndex = refreshIndex ?? this.slotRefreshIndices.get(slotId) ?? 0;
+    const baseSlotKey = `${escapeKeyPart(slotId)}:${rIndex}`;
+    if (creativeId) {
+      if (auctionId) {
+        return this.slotEmittedImpressionKeys.has(
+          `${baseSlotKey}:auc:${escapeKeyPart(auctionId)}:${escapeKeyPart(creativeId)}`
+        ) || this.slotEmittedImpressionKeys.has(`${baseSlotKey}:${escapeKeyPart(creativeId)}`);
+      }
+      return this.slotEmittedImpressionKeys.has(`${baseSlotKey}:${escapeKeyPart(creativeId)}`);
+    }
+    if (auctionId) {
+      return this.slotEmittedImpressionKeys.has(`${baseSlotKey}:auc:${escapeKeyPart(auctionId)}`);
+    }
+    return this.slotEmittedImpressionKeys.has(baseSlotKey);
+  }
+  markImpressionEmitted(slotId, refreshIndex, auctionId, creativeId) {
+    const baseSlotKey = `${escapeKeyPart(slotId)}:${refreshIndex}`;
+    this.slotEmittedImpressionKeys.add(baseSlotKey);
+    if (creativeId) {
+      this.slotEmittedImpressionKeys.add(`${baseSlotKey}:${escapeKeyPart(creativeId)}`);
+    }
+    if (auctionId) {
+      this.slotEmittedImpressionKeys.add(`${baseSlotKey}:auc:${escapeKeyPart(auctionId)}`);
+      if (creativeId) {
+        this.slotEmittedImpressionKeys.add(
+          `${baseSlotKey}:auc:${escapeKeyPart(auctionId)}:${escapeKeyPart(creativeId)}`
+        );
+      }
+    }
+  }
+  recordImpression(slotId, options) {
+    if (!this.isEnabled) return false;
+    const resolvedSlotId = slotId || options?.adUnitCode || "";
+    const adUnitCode = options?.adUnitCode || resolvedSlotId;
+    const cached = (options?.auctionId && resolvedSlotId ? this.cachedWinningBids.get(`${options.auctionId}:${resolvedSlotId}`) : void 0) || (options?.auctionId && adUnitCode ? this.cachedWinningBids.get(`${options.auctionId}:${adUnitCode}`) : void 0) || (resolvedSlotId ? this.cachedWinningBids.get(resolvedSlotId) : void 0) || (adUnitCode ? this.cachedWinningBids.get(adUnitCode) : void 0);
+    const rawBid = options?.bid || cached?.rawBid || {};
+    const auctionId = options?.auctionId || rawBid.auctionId || cached?.auctionId || "";
+    const transactionId = options?.transactionId || rawBid.transactionId || cached?.transactionId || "";
+    const creativeId = rawBid.creativeId || cached?.bidTrace?.creativeId || options?.bid?.creativeId || "";
+    const mediaType = options?.mediaType || rawBid.mediaType || cached?.bidTrace?.mediaType || "banner";
+    const targetSlot = resolvedSlotId || adUnitCode;
+    const rec = (resolvedSlotId ? this.slotViewabilityRecords.get(resolvedSlotId) : void 0) || (adUnitCode ? this.slotViewabilityRecords.get(adUnitCode) : void 0);
+    const lastAuctionId = targetSlot ? this.slotLastAuctionIds.get(targetSlot) || (rec ? rec.auctionId : void 0) : void 0;
+    const isDifferentAuction = Boolean(
+      targetSlot && auctionId && lastAuctionId && lastAuctionId !== auctionId && options?.refreshIndex === void 0
+    );
+    const bidTrace = {
+      bidder: rawBid.bidderCode || rawBid.bidder || cached?.bidTrace?.bidder || "",
+      cpm: Number.isFinite(rawBid.originalCpm) ? rawBid.originalCpm : Number.isFinite(rawBid.cpm) ? rawBid.cpm : cached?.bidTrace?.cpm ?? 0,
+      currency: rawBid.originalCurrency ?? rawBid.currency ?? cached?.bidTrace?.currency ?? "USD",
+      ...parseBidDimensions(rawBid).width ? parseBidDimensions(rawBid) : cached?.bidTrace ? { width: cached.bidTrace.width, height: cached.bidTrace.height } : parseBidDimensions(rawBid),
+      dealId: rawBid.dealId || cached?.bidTrace?.dealId || "",
+      mediaType,
+      latencyMs: Number.isFinite(rawBid.timeToRespond) ? rawBid.timeToRespond : cached?.bidTrace?.latencyMs ?? 0,
+      advertiserDomain: rawBid.meta?.advertiserDomains?.[0] || cached?.bidTrace?.advertiserDomain || "",
+      creativeId: rawBid.creativeId || cached?.bidTrace?.creativeId || ""
+    };
+    if (isDifferentAuction && targetSlot) {
+      this.flushSlotTimeInView(targetSlot);
+      const nextRefreshIndex = (this.slotRefreshIndices.get(targetSlot) ?? (rec ? rec.refreshIndex : 0)) + 1;
+      this.slotRefreshIndices.set(targetSlot, nextRefreshIndex);
+      this.slotLastAuctionIds.set(targetSlot, auctionId);
+      if (rec) {
+        rec.refreshIndex = nextRefreshIndex;
+        rec.auctionId = auctionId;
+        rec.transactionId = transactionId;
+        rec.bidPayload = bidTrace;
+        rec.viewableFired = false;
+        rec.accumulatedTimeInViewMs = 0;
+      }
+      this.enqueue(TraceEventType.REFRESH, "refresh", {
+        auctionId,
+        transactionId,
+        adUnitCode: targetSlot,
+        bid: bidTrace,
+        metadata: {
+          ...options?.metadata,
+          refresh_index: String(nextRefreshIndex)
+        }
+      });
+    } else if (targetSlot) {
+      if (auctionId) {
+        this.slotLastAuctionIds.set(targetSlot, auctionId);
+      }
+      if (!this.slotRefreshIndices.has(targetSlot)) {
+        this.slotRefreshIndices.set(targetSlot, 0);
+      }
+    }
+    const currentRefreshIndex = options?.refreshIndex ?? (resolvedSlotId ? this.slotRefreshIndices.get(resolvedSlotId) ?? (adUnitCode ? this.slotRefreshIndices.get(adUnitCode) : void 0) ?? (rec ? rec.refreshIndex : 0) : 0);
+    const alreadyEmitted = resolvedSlotId && this.hasImpressionEmitted(resolvedSlotId, currentRefreshIndex, auctionId, creativeId) || adUnitCode && adUnitCode !== resolvedSlotId && this.hasImpressionEmitted(adUnitCode, currentRefreshIndex, auctionId, creativeId);
+    if (alreadyEmitted) {
+      this.log(
+        "DEBUG",
+        `Impression already emitted for slot ${resolvedSlotId || adUnitCode} in cycle ${currentRefreshIndex}`
+      );
+      return false;
+    }
+    if (resolvedSlotId)
+      this.markImpressionEmitted(resolvedSlotId, currentRefreshIndex, auctionId, creativeId);
+    if (adUnitCode && adUnitCode !== resolvedSlotId)
+      this.markImpressionEmitted(adUnitCode, currentRefreshIndex, auctionId, creativeId);
+    this.enqueue(TraceEventType.IMPRESSION, "impression", {
+      auctionId,
+      transactionId,
+      adUnitCode,
+      bid: bidTrace,
+      metadata: {
+        ...options?.metadata,
+        refresh_index: String(currentRefreshIndex)
+      }
+    });
+    if (rec) {
+      if (!rec.bidPayload && bidTrace) rec.bidPayload = bidTrace;
+      if (!rec.auctionId && auctionId) rec.auctionId = auctionId;
+      if (!rec.transactionId && transactionId) rec.transactionId = transactionId;
+    }
+    return true;
+  }
+  /**
+   * Bridges Google IMA SDK AdsManager events to Bidkernel analytics.
+   * Defers IMPRESSION emission until AdEvent.STARTED (or IMPRESSION),
+   * tracks milestones (FIRST_QUARTILE, MIDPOINT, THIRD_QUARTILE, COMPLETE),
+   * and handles AD_ERROR.
+   */
+  attachImaAdsManager(adsManager, options) {
+    if (!adsManager || typeof adsManager.addEventListener !== "function") {
+      this.log("WARN", "Invalid AdsManager passed to attachImaAdsManager");
+      return () => {
+      };
+    }
+    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.cachedWinningBids.get(`${auctionId}:${adUnitCode}`) : void 0) || (auctionId && slotId !== adUnitCode ? this.cachedWinningBids.get(`${auctionId}:${slotId}`) : void 0) || this.cachedWinningBids.get(adUnitCode) || (slotId !== adUnitCode ? this.cachedWinningBids.get(slotId) : void 0);
+    };
+    const onAdStartedOrImpression = (event) => {
+      this.log("DEBUG", "IMA AdEvent.STARTED / IMPRESSION received", event);
+      const ad = typeof event?.getAd === "function" ? event.getAd() : event?.ad;
+      const adData = {};
+      if (ad) {
+        adData.creativeId = (typeof ad.getCreativeId === "function" ? ad.getCreativeId() : ad.creativeId) || "";
+        adData.adId = (typeof ad.getAdId === "function" ? ad.getAdId() : ad.id) || "";
+        adData.title = (typeof ad.getTitle === "function" ? ad.getTitle() : ad.title) || "";
+        adData.duration = typeof ad.getDuration === "function" ? ad.getDuration() : ad.duration;
+        adData.advertiserName = typeof ad.getAdvertiserName === "function" ? ad.getAdvertiserName() : "";
+      }
+      const cached = getWinningBid();
+      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,
+        mediaType: "video",
+        bid: mergedBid,
+        metadata: {
+          ...options?.metadata,
+          media_type: "video",
+          ...adData.title ? { ad_title: adData.title } : {},
+          ...Number.isFinite(adData.duration) ? { ad_duration_s: String(adData.duration) } : {}
+        }
+      });
+      if (emitted && options?.onImpression) {
+        try {
+          options.onImpression(slotId, { ad, bid: mergedBid });
+        } catch (e) {
+          this.log("ERROR", "Error in onImpression callback", e);
+        }
+      }
+    };
+    const onMilestone = (milestone) => {
+      this.log("DEBUG", `IMA AdEvent milestone: ${milestone}`);
+      if (options?.onMilestone) {
+        try {
+          options.onMilestone(milestone, slotId);
+        } catch (e) {
+          this.log("ERROR", "Error in onMilestone callback", e);
+        }
+      }
+    };
+    const onAdClick = (event) => {
+      this.log("DEBUG", "IMA AdEvent.CLICK received", event);
+      const cached = getWinningBid();
+      this.enqueue(TraceEventType.CLICK, "click", {
+        auctionId: auctionId || cached?.auctionId,
+        transactionId: transactionId || cached?.transactionId,
+        adUnitCode,
+        bid: cached?.bidTrace || options?.bid,
+        metadata: {
+          ...options?.metadata,
+          media_type: "video"
+        }
+      });
+    };
+    const onAdError = (event) => {
+      this.log("WARN", "IMA AdErrorEvent received", event);
+      const err = typeof event?.getError === "function" ? event.getError() : event?.error || event;
+      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();
+      this.enqueue(TraceEventType.AD_RENDER_FAILED, "adRenderFailed", {
+        auctionId: auctionId || cached?.auctionId,
+        transactionId: transactionId || cached?.transactionId,
+        adUnitCode,
+        bid: cached?.bidTrace || options?.bid,
+        metadata: {
+          ...options?.metadata,
+          reason: "ima_ad_error",
+          message: msg,
+          ...code ? { ima_error_code: String(code) } : {}
+        },
+        error: typeof err === "object" ? err : new Error(msg)
+      });
+      if (options?.onError) {
+        try {
+          options.onError(err);
+        } catch (e) {
+          this.log("ERROR", "Error in onError callback", e);
+        }
+      }
+    };
+    const googleIma = typeof window !== "undefined" ? window.google?.ima : void 0;
+    const adEventType = googleIma?.AdEvent?.Type || {};
+    const adErrorEventType = googleIma?.AdErrorEvent?.Type || {};
+    const listeners = [
+      { type: adEventType.STARTED || "started", handler: onAdStartedOrImpression },
+      { type: adEventType.IMPRESSION || "impression", handler: onAdStartedOrImpression },
+      {
+        type: adEventType.FIRST_QUARTILE || "firstQuartile",
+        handler: () => onMilestone("firstQuartile")
+      },
+      { type: adEventType.MIDPOINT || "midpoint", handler: () => onMilestone("midpoint") },
+      {
+        type: adEventType.THIRD_QUARTILE || "thirdQuartile",
+        handler: () => onMilestone("thirdQuartile")
+      },
+      { type: adEventType.COMPLETE || "complete", handler: () => onMilestone("complete") },
+      { type: adEventType.CLICK || "click", handler: onAdClick },
+      { type: adErrorEventType.AD_ERROR || "adError", handler: onAdError }
+    ];
+    for (const { type, handler } of listeners) {
+      try {
+        adsManager.addEventListener(type, handler);
+      } catch {
+      }
+    }
+    const cleanup = () => {
+      for (const { type, handler } of listeners) {
+        try {
+          adsManager.removeEventListener(type, handler);
+        } catch {
+        }
+      }
+      this.videoDetachCleanups.delete(cleanup);
+    };
+    this.videoDetachCleanups.add(cleanup);
+    return cleanup;
+  }
+  /**
+   * Attaches render hooks and viewability tracking to a video player.
+   * Supports HTML5 <video> elements, container elements, or Google IMA AdsManager.
+   */
+  attachVideoPlayer(target, options) {
+    if (!target) {
+      this.log("WARN", "attachVideoPlayer called with null/undefined target");
+      return () => {
+      };
+    }
+    let el = null;
+    if (typeof target === "string") {
+      if (typeof document !== "undefined") {
+        try {
+          el = document.querySelector(target) || document.getElementById(target);
+        } catch {
+          el = document.getElementById(target);
+        }
+      }
+    } else if (typeof HTMLElement !== "undefined" && target instanceof HTMLElement) {
+      el = target;
+    } else if (target && typeof target === "object" && target.nodeType === 1) {
+      el = target;
+    } else if (
+      // Check if target is an IMA AdsManager
+      typeof target.addEventListener === "function" && (typeof target.init === "function" || typeof target.start === "function" || typeof target.getCuePoints === "function" || typeof target.getVolume === "function" || target.__imaAdsManager)
+    ) {
+      return this.attachImaAdsManager(target, options);
+    } else if (target && typeof target.addEventListener === "function") {
+      el = target;
+    }
+    const slotId = options?.slotId || options?.adUnitCode || (el ? el.id : "") || "video";
+    const adUnitCode = options?.adUnitCode || slotId;
+    const auctionId = options?.auctionId || "";
+    const transactionId = options?.transactionId || "";
+    const getWinningBid = () => {
+      return (auctionId ? this.cachedWinningBids.get(`${auctionId}:${adUnitCode}`) : void 0) || (auctionId && slotId !== adUnitCode ? this.cachedWinningBids.get(`${auctionId}:${slotId}`) : void 0) || this.cachedWinningBids.get(adUnitCode) || (slotId !== adUnitCode ? this.cachedWinningBids.get(slotId) : void 0);
+    };
+    let videoEl = null;
+    if (el) {
+      if (el.tagName && el.tagName.toLowerCase() === "video") {
+        videoEl = el;
+      } else {
+        videoEl = el.querySelector("video");
+      }
+    }
+    const quartilesFired = {
+      q1: false,
+      q2: false,
+      q3: false,
+      q4: false
+    };
+    const triggerPlaybackImpression = (activeVideo) => {
+      const vEl = activeVideo || videoEl || (el?.querySelector ? el.querySelector("video") : null);
+      const cached = getWinningBid();
+      const mergedBid = {
+        ...cached?.rawBid || options?.bid,
+        mediaType: "video"
+      };
+      const emitted = this.recordImpression(slotId, {
+        adUnitCode,
+        auctionId: auctionId || cached?.auctionId,
+        transactionId: transactionId || cached?.transactionId,
+        mediaType: "video",
+        bid: mergedBid,
+        metadata: {
+          ...options?.metadata,
+          media_type: "video",
+          ...vEl && Number.isFinite(vEl.duration) ? { video_duration_s: String(Math.round(vEl.duration)) } : {}
+        }
+      });
+      if (emitted && options?.onImpression) {
+        try {
+          options.onImpression(slotId, { element: vEl || el, bid: mergedBid });
+        } catch (e) {
+          this.log("ERROR", "Error in onImpression callback", e);
+        }
+      }
+    };
+    const handlePlaying = (e) => {
+      this.log("DEBUG", "HTML5 video playing event received");
+      const targetVideo = e?.target instanceof HTMLVideoElement ? e.target : videoEl;
+      triggerPlaybackImpression(targetVideo);
+    };
+    const handleTimeUpdate = (e) => {
+      const targetVideo = e?.target instanceof HTMLVideoElement ? e.target : videoEl;
+      if (targetVideo && targetVideo.currentTime > 0) {
+        triggerPlaybackImpression(targetVideo);
+        if (Number.isFinite(targetVideo.duration) && targetVideo.duration > 0) {
+          const progress = targetVideo.currentTime / targetVideo.duration;
+          if (progress >= 0.25 && !quartilesFired.q1) {
+            quartilesFired.q1 = true;
+            options?.onMilestone?.("firstQuartile", slotId);
+          }
+          if (progress >= 0.5 && !quartilesFired.q2) {
+            quartilesFired.q2 = true;
+            options?.onMilestone?.("midpoint", slotId);
+          }
+          if (progress >= 0.75 && !quartilesFired.q3) {
+            quartilesFired.q3 = true;
+            options?.onMilestone?.("thirdQuartile", slotId);
+          }
+        }
+      }
+    };
+    const handleEnded = () => {
+      if (!quartilesFired.q4) {
+        quartilesFired.q4 = true;
+        options?.onMilestone?.("complete", slotId);
+      }
+    };
+    const handleError = (e) => {
+      const targetVideo = e?.target instanceof HTMLVideoElement ? e.target : videoEl;
+      const err = targetVideo?.error || videoEl?.error;
+      const cached = getWinningBid();
+      const msg = err ? `HTML5 video error code ${err.code}: ${err.message}` : "Video playback error";
+      this.log("WARN", msg);
+      this.enqueue(TraceEventType.AD_RENDER_FAILED, "adRenderFailed", {
+        auctionId: auctionId || cached?.auctionId,
+        transactionId: transactionId || cached?.transactionId,
+        adUnitCode,
+        bid: cached?.bidTrace || options?.bid,
+        metadata: {
+          ...options?.metadata,
+          reason: "html5_video_error",
+          message: msg,
+          ...err?.code ? { video_error_code: String(err.code) } : {}
+        },
+        error: err ? new Error(msg) : void 0
+      });
+      if (options?.onError) {
+        try {
+          options.onError(err);
+        } catch (e2) {
+          this.log("ERROR", "Error in onError callback", e2);
+        }
+      }
+    };
+    const attachListenersToVideo = (targetVideo) => {
+      targetVideo.addEventListener("playing", handlePlaying);
+      targetVideo.addEventListener("play", handlePlaying);
+      targetVideo.addEventListener("timeupdate", handleTimeUpdate);
+      targetVideo.addEventListener("ended", handleEnded);
+      targetVideo.addEventListener("error", handleError);
+    };
+    const removeListenersFromVideo = (targetVideo) => {
+      targetVideo.removeEventListener("playing", handlePlaying);
+      targetVideo.removeEventListener("play", handlePlaying);
+      targetVideo.removeEventListener("timeupdate", handleTimeUpdate);
+      targetVideo.removeEventListener("ended", handleEnded);
+      targetVideo.removeEventListener("error", handleError);
+    };
+    let mutationObserver = null;
+    if (el && el !== videoEl) {
+      el.addEventListener("playing", handlePlaying, true);
+      el.addEventListener("play", handlePlaying, true);
+      el.addEventListener("timeupdate", handleTimeUpdate, true);
+      el.addEventListener("ended", handleEnded, true);
+      el.addEventListener("error", handleError, true);
+    }
+    if (videoEl) {
+      attachListenersToVideo(videoEl);
+    }
+    if (el && el.tagName?.toLowerCase() !== "video" && typeof MutationObserver !== "undefined") {
+      mutationObserver = new MutationObserver(() => {
+        const found = el.querySelector("video");
+        if (found && found !== videoEl) {
+          if (videoEl) removeListenersFromVideo(videoEl);
+          videoEl = found;
+          if (videoEl) attachListenersToVideo(videoEl);
+        }
+      });
+      mutationObserver.observe(el, { childList: true, subtree: true });
+    }
+    const cachedInitial = getWinningBid();
+    if (options?.trackViewability !== false && el) {
+      this.observeSlot(el, slotId, {
+        adUnitCode,
+        auctionId: auctionId || cachedInitial?.auctionId,
+        transactionId: transactionId || cachedInitial?.transactionId,
+        mediaType: "video",
+        bid: cachedInitial?.bidTrace || options?.bid,
+        metadata: options?.metadata,
+        emitRefreshEvent: false
+      });
+    }
+    const cleanup = () => {
+      if (mutationObserver) {
+        mutationObserver.disconnect();
+        mutationObserver = null;
+      }
+      if (el && el !== videoEl) {
+        el.removeEventListener("playing", handlePlaying, true);
+        el.removeEventListener("play", handlePlaying, true);
+        el.removeEventListener("timeupdate", handleTimeUpdate, true);
+        el.removeEventListener("ended", handleEnded, true);
+        el.removeEventListener("error", handleError, true);
+      }
+      if (videoEl) {
+        removeListenersFromVideo(videoEl);
+      }
+      this.videoDetachCleanups.delete(cleanup);
+    };
+    this.videoDetachCleanups.add(cleanup);
+    return cleanup;
   }
   onTimeInViewThreshold(slotId, thresholdMs, callback) {
     const listener = {
@@ -1570,21 +2108,45 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
   handleBidWon(data) {
     if (this.isDuplicate("bidWon", data)) return;
     this.log("DEBUG", "bidWon", data);
-    this.enqueue(TraceEventType.BID_WIN, "bidWon", {
-      auctionId: data.auctionId || "",
-      transactionId: data.transactionId || "",
-      adUnitCode: data.adUnitCode || "",
-      bid: {
-        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",
-        latencyMs: Number.isFinite(data.timeToRespond) ? data.timeToRespond : 0,
-        advertiserDomain: data.meta?.advertiserDomains?.[0] || "",
-        creativeId: data.creativeId || ""
+    const auctionId = data.auctionId || "";
+    const transactionId = data.transactionId || "";
+    const adUnitCode = data.adUnitCode || data.adId || "";
+    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",
+      latencyMs: Number.isFinite(data.timeToRespond) ? data.timeToRespond : 0,
+      advertiserDomain: data.meta?.advertiserDomains?.[0] || "",
+      creativeId: data.creativeId || ""
+    };
+    if (adUnitCode) {
+      const cachedEntry = {
+        bidTrace,
+        auctionId,
+        transactionId,
+        adUnitCode,
+        rawBid: data,
+        timestamp: Date.now()
+      };
+      this.cachedWinningBids.set(adUnitCode, cachedEntry);
+      if (data.adId && data.adId !== adUnitCode) {
+        this.cachedWinningBids.set(data.adId, cachedEntry);
+      }
+      if (auctionId) {
+        this.cachedWinningBids.set(`${auctionId}:${adUnitCode}`, cachedEntry);
+        if (data.adId && data.adId !== adUnitCode) {
+          this.cachedWinningBids.set(`${auctionId}:${data.adId}`, cachedEntry);
+        }
       }
+    }
+    this.enqueue(TraceEventType.BID_WIN, "bidWon", {
+      auctionId,
+      transactionId,
+      adUnitCode,
+      bid: bidTrace
     });
   }
   handleNoBid(data) {
@@ -1623,44 +2185,81 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
     if (this.isDuplicate("adRenderSucceeded", data)) return;
     this.log("DEBUG", "adRenderSucceeded", data);
     const bid = data.bid || data || {};
-    const adUnitCode = data.adUnitCode || bid.adUnitCode || "";
+    const adUnitCode = data.adUnitCode || bid.adUnitCode || data.adId || bid.adId || "";
     const auctionId = bid.auctionId || data.auctionId || "";
     const transactionId = bid.transactionId || data.transactionId || "";
     const mediaType = bid.mediaType || "banner";
+    const slotKey = data.adUnitCode || bid.adUnitCode || "";
+    const altKey = data.adId || bid.adId || "";
+    const cached = (auctionId && slotKey ? this.cachedWinningBids.get(`${auctionId}:${slotKey}`) : void 0) || (auctionId && altKey ? this.cachedWinningBids.get(`${auctionId}:${altKey}`) : void 0) || (slotKey ? this.cachedWinningBids.get(slotKey) : void 0) || (altKey ? this.cachedWinningBids.get(altKey) : void 0);
     const bidTrace = {
-      bidder: bid.bidderCode || bid.bidder || "",
-      cpm: Number.isFinite(bid.originalCpm) ? bid.originalCpm : Number.isFinite(bid.cpm) ? bid.cpm : 0,
-      currency: bid.originalCurrency ?? bid.currency ?? "USD",
-      ...parseBidDimensions(bid),
-      dealId: bid.dealId || "",
-      mediaType,
-      latencyMs: Number.isFinite(bid.timeToRespond) ? bid.timeToRespond : 0,
-      advertiserDomain: bid.meta?.advertiserDomains?.[0] || "",
-      creativeId: bid.creativeId || ""
+      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",
+      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 || ""
     };
-    const isRefresh = adUnitCode && (this.slotViewabilityRecords.has(adUnitCode) || this.slotRefreshIndices.has(adUnitCode) && this.slotRefreshIndices.get(adUnitCode) > 0);
+    const resolvedAuctionId = auctionId || cached?.auctionId || "";
+    const resolvedTransactionId = transactionId || cached?.transactionId || "";
+    const record = adUnitCode ? this.slotViewabilityRecords.get(adUnitCode) : void 0;
+    const isDifferentAuction = record && resolvedAuctionId && record.auctionId && record.auctionId !== resolvedAuctionId;
+    const isRefresh = Boolean(adUnitCode && record && isDifferentAuction);
     if (isRefresh) {
       this.flushSlotTimeInView(adUnitCode);
-      const nextRefreshIndex = (this.slotRefreshIndices.get(adUnitCode) ?? 0) + 1;
+      const nextRefreshIndex = (this.slotRefreshIndices.get(adUnitCode) ?? (record ? record.refreshIndex : 0)) + 1;
       this.slotRefreshIndices.set(adUnitCode, nextRefreshIndex);
+      this.slotLastAuctionIds.set(adUnitCode, resolvedAuctionId);
+      if (record) {
+        record.refreshIndex = nextRefreshIndex;
+        record.auctionId = resolvedAuctionId;
+        record.transactionId = resolvedTransactionId;
+        record.bidPayload = bidTrace;
+        record.viewableFired = false;
+        record.accumulatedTimeInViewMs = 0;
+      }
       this.enqueue(TraceEventType.REFRESH, "refresh", {
-        auctionId,
-        transactionId,
+        auctionId: resolvedAuctionId,
+        transactionId: resolvedTransactionId,
         adUnitCode,
         bid: bidTrace,
         metadata: { refresh_index: String(nextRefreshIndex) }
       });
-    } else if (adUnitCode && !this.slotRefreshIndices.has(adUnitCode)) {
-      this.slotRefreshIndices.set(adUnitCode, 0);
+    } else if (adUnitCode) {
+      if (resolvedAuctionId) {
+        this.slotLastAuctionIds.set(adUnitCode, resolvedAuctionId);
+      }
+      if (!this.slotRefreshIndices.has(adUnitCode)) {
+        this.slotRefreshIndices.set(adUnitCode, 0);
+      }
     }
-    const currentRefreshIndex = adUnitCode ? this.slotRefreshIndices.get(adUnitCode) ?? 0 : 0;
-    this.enqueue(TraceEventType.IMPRESSION, "impression", {
-      auctionId,
-      transactionId,
+    const currentRefreshIndex = adUnitCode ? this.slotRefreshIndices.get(adUnitCode) ?? (record ? record.refreshIndex : 0) : 0;
+    const alreadyEmitted = adUnitCode ? this.hasImpressionEmitted(
       adUnitCode,
-      bid: bidTrace,
-      metadata: { refresh_index: String(currentRefreshIndex) }
-    });
+      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,
+        bid: bidTrace,
+        metadata: { refresh_index: String(currentRefreshIndex) }
+      });
+    }
     if (this.config.viewabilityEnabled && typeof document !== "undefined") {
       let el = null;
       const targetId = adUnitCode || data.adId || bid.adId;
@@ -1688,8 +2287,8 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
       if (el) {
         this.observeSlot(el, adUnitCode || targetId, {
           adUnitCode,
-          auctionId,
-          transactionId,
+          auctionId: resolvedAuctionId,
+          transactionId: resolvedTransactionId,
           mediaType,
           bid: bidTrace,
           refreshIndex: currentRefreshIndex,
@@ -1754,6 +2353,12 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
     }
     if (this.queue.length >= BATCH_SIZE) {
       this.flush();
+    } else if (IMMEDIATE_FLUSH_TYPES.has(type) && !this.immediateFlushScheduled) {
+      this.immediateFlushScheduled = true;
+      setTimeout(() => {
+        this.immediateFlushScheduled = false;
+        this.flush();
+      }, 0);
     }
   }
   shouldSample(type, level) {
@@ -1810,10 +2415,11 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
       events
     };
   }
-  sendFetch(payload, useKeepalive = false) {
+  sendFetch(payload, useKeepalive = false, onDelivered) {
     const fetchOpts = {
       method: "POST",
-      headers: { "Content-Type": "application/x-protobuf" },
+      // Safelisted content type: no CORS preflight (see SAFE_CONTENT_TYPE).
+      headers: { "Content-Type": SAFE_CONTENT_TYPE },
       body: payload.encoded
     };
     if (useKeepalive) {
@@ -1822,7 +2428,7 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
     fetch(payload.url, fetchOpts).then((res) => {
       if (!res.ok) {
         this.log("WARN", `Failed to send batch: HTTP ${res.status}`);
-        if (res.status >= 400 && res.status < 500) {
+        if (res.status >= 400 && res.status < 500 && res.status !== 429 && res.status !== 408) {
           this.log("WARN", `Dropping batch due to non-retryable client error HTTP ${res.status}`);
           return;
         }
@@ -1830,14 +2436,16 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
       } else {
         this.consecutiveSendFailures = 0;
         this.nextSendAllowedAt = 0;
+        if (onDelivered) onDelivered();
       }
     }).catch((err) => {
       this.log("ERROR", "Failed to send batch", err);
       this.handleSendFailure(payload.events);
     });
-    if (typeof process !== "undefined" && typeof process._tickCallback === "function") {
+    const proc = typeof globalThis !== "undefined" ? globalThis.process : void 0;
+    if (proc && typeof proc._tickCallback === "function") {
       try {
-        process._tickCallback();
+        proc._tickCallback();
       } catch {
       }
     }
@@ -1873,19 +2481,99 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
       let sent = false;
       if (typeof navigator !== "undefined" && typeof navigator.sendBeacon === "function") {
         try {
-          const blob = new Blob([payload.encoded], {
-            type: "application/x-protobuf"
-          });
+          const blob = new Blob([payload.encoded], { type: SAFE_CONTENT_TYPE });
           sent = navigator.sendBeacon(payload.url, blob);
         } catch {
           sent = false;
         }
       }
       if (!sent) {
-        this.sendFetch(payload, true);
+        const persistKey = this.persistBatch(payload.encoded);
+        this.sendFetch(payload, true, () => this.removePersistedBatch(persistKey));
       }
       payload = this.drainBatch();
     }
+    this.schedulePersistedCleanup();
+  }
+  // --- Exit-batch persistence -----------------------------------------------
+  persistBatch(encoded) {
+    try {
+      if (typeof localStorage === "undefined") return null;
+      let pendingCount = 0;
+      for (let i = 0; i < localStorage.length; i++) {
+        const k = localStorage.key(i);
+        if (k && k.startsWith(PENDING_BATCH_KEY_PREFIX)) pendingCount++;
+      }
+      if (pendingCount >= MAX_PENDING_BATCHES) return null;
+      const key = `${PENDING_BATCH_KEY_PREFIX}${Date.now()}_${Math.floor(Math.random() * 1e6)}`;
+      localStorage.setItem(key, bytesToBase64(encoded));
+      this.persistedBatchKeys.push(key);
+      return key;
+    } catch {
+      return null;
+    }
+  }
+  removePersistedBatch(key) {
+    if (!key) return;
+    try {
+      if (typeof localStorage !== "undefined") localStorage.removeItem(key);
+    } catch {
+    }
+    const idx = this.persistedBatchKeys.indexOf(key);
+    if (idx !== -1) this.persistedBatchKeys.splice(idx, 1);
+  }
+  // A page that is still running PENDING_BATCH_CLEANUP_DELAY_MS after an exit
+  // flush was never torn down, so its beacons have long since gone out; drop
+  // the persisted copies rather than letting a later pageview resend them.
+  schedulePersistedCleanup() {
+    if (this.persistedBatchKeys.length === 0) return;
+    if (this.persistedCleanupTimer) clearTimeout(this.persistedCleanupTimer);
+    this.persistedCleanupTimer = setTimeout(() => {
+      this.persistedCleanupTimer = null;
+      for (const key of Array.from(this.persistedBatchKeys)) {
+        this.removePersistedBatch(key);
+      }
+    }, PENDING_BATCH_CLEANUP_DELAY_MS);
+  }
+  // Resend batches a previous pageview persisted at exit but could not
+  // confirm. Keys are claimed (removed) before sending so concurrent tabs
+  // don't double-send; the batch bytes carry their original pageview, session,
+  // and event timestamps, so late rows attribute correctly.
+  resendPersistedBatches() {
+    try {
+      if (typeof localStorage === "undefined" || !this.config.endpoint) return;
+      const keys = [];
+      for (let i = 0; i < localStorage.length; i++) {
+        const k = localStorage.key(i);
+        if (k && k.startsWith(PENDING_BATCH_KEY_PREFIX)) keys.push(k);
+      }
+      for (const key of keys) {
+        let value = null;
+        try {
+          value = localStorage.getItem(key);
+          localStorage.removeItem(key);
+        } catch {
+          continue;
+        }
+        if (!value) continue;
+        const ts = parseInt(key.slice(PENDING_BATCH_KEY_PREFIX.length), 10);
+        if (!Number.isFinite(ts) || Date.now() - ts > PENDING_BATCH_MAX_AGE_MS) continue;
+        let encoded;
+        try {
+          encoded = base64ToBytes(value);
+        } catch {
+          continue;
+        }
+        if (encoded.byteLength === 0) continue;
+        this.log("DEBUG", `Resending persisted exit batch (${encoded.byteLength} bytes)`);
+        this.sendFetch({
+          url: `${this.config.endpoint}/${this.config.propertyId}`,
+          encoded,
+          events: []
+        });
+      }
+    } catch {
+    }
   }
   log(level, msg, ...args) {
     const levels = { DEBUG: 10, INFO: 20, WARN: 30, ERROR: 40 };
@@ -2012,7 +2700,28 @@ function getbidkernel(alias = "bidkernel") {
   }
   const win = window;
   win[alias] = win[alias] || { q: [] };
-  return win[alias];
+  const sdk = win[alias];
+  if (!sdk.attachVideoPlayer) {
+    sdk.attachVideoPlayer = (target, options) => {
+      const inst = win._bidkernelPrebidAnalytics;
+      return inst?.attachVideoPlayer ? inst.attachVideoPlayer(target, options) : () => {
+      };
+    };
+  }
+  if (!sdk.attachImaAdsManager) {
+    sdk.attachImaAdsManager = (adsManager, options) => {
+      const inst = win._bidkernelPrebidAnalytics;
+      return inst?.attachImaAdsManager ? inst.attachImaAdsManager(adsManager, options) : () => {
+      };
+    };
+  }
+  if (!sdk.recordImpression) {
+    sdk.recordImpression = (slotId, options) => {
+      const inst = win._bidkernelPrebidAnalytics;
+      return inst?.recordImpression ? inst.recordImpression(slotId, options) : false;
+    };
+  }
+  return sdk;
 }
 export {
   BidkernelPrebidAnalytics,