@bidkernel/analytics 0.3.0 → 0.5.0

package/dist/index.js

@@ -657,6 +657,7 @@ var MAX_ERRORS_PER_SESSION = 50;
 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 EVENT_NAME_TO_TYPE = {
   auctionStart: TraceEventType.AUCTION_START,
   auctionEnd: TraceEventType.AUCTION_END,
@@ -723,47 +724,73 @@ function getOrCreateSessionId() {
   inMemorySessionTs = now;
   return inMemorySessionId;
 }
+function escapeKeyPart(str) {
+  return String(str ?? "").replace(/%/g, "%25").replace(/:/g, "%3A");
+}
 function getPrebidEventKey(eventName, data) {
   switch (eventName) {
     case "auctionInit":
-      return `auctionInit:${data?.auctionId || ""}`;
+      return `auctionInit:${escapeKeyPart(data?.auctionId)}`;
     case "auctionEnd":
-      return `auctionEnd:${data?.auctionId || ""}`;
-    case "bidRequested":
-      return `bidRequested:${data?.auctionId || ""}:${data?.bidderCode || ""}:${Array.isArray(data?.bids) ? data.bids.map((b) => b?.bidId || b?.adUnitCode || "").join(",") : ""}`;
-    case "bidResponse":
-      return `bidResponse:${data?.auctionId || ""}:${data?.adUnitCode || ""}:${data?.bidderCode || data?.bidder || ""}:${data?.creativeId || data?.adId || data?.requestId || ""}:${data?.originalCpm ?? data?.cpm ?? ""}`;
-    case "bidTimeout":
-      if (Array.isArray(data)) {
-        return "bidTimeout:" + data.map(
-          (t) => `${t?.auctionId || ""}:${t?.bidder || t?.bidderCode || ""}:${t?.bidId || t?.adUnitCode || ""}`
-        ).join(",");
-      }
-      return `bidTimeout:${data?.auctionId || ""}:${data?.bidder || data?.bidderCode || ""}:${data?.bidId || data?.adUnitCode || ""}`;
-    case "bidWon":
-      return `bidWon:${data?.auctionId || ""}:${data?.adUnitCode || ""}:${data?.bidderCode || data?.bidder || ""}:${data?.creativeId || data?.adId || data?.requestId || ""}:${data?.originalCpm ?? data?.cpm ?? ""}`;
+      return `auctionEnd:${escapeKeyPart(data?.auctionId)}`;
+    case "bidRequested": {
+      const bids = Array.isArray(data?.bids) ? data.bids.map((b) => escapeKeyPart(b?.bidId || b?.transactionId || b?.adUnitCode)).join(",") : "";
+      return `bidRequested:${escapeKeyPart(data?.auctionId)}:${escapeKeyPart(data?.bidderCode || data?.bidder)}:${bids}`;
+    }
+    case "bidResponse": {
+      const bid = data || {};
+      const uniqueBidId = bid.creativeId || bid.adId || bid.requestId || bid.bidId || "";
+      const price = bid.originalCpm ?? bid.cpm ?? "";
+      return `bidResponse:${escapeKeyPart(bid.auctionId)}:${escapeKeyPart(bid.adUnitCode)}:${escapeKeyPart(bid.bidderCode || bid.bidder)}:${escapeKeyPart(uniqueBidId)}:${escapeKeyPart(price)}`;
+    }
+    case "bidTimeout": {
+      const items = Array.isArray(data) ? data : data ? [data] : [];
+      return "bidTimeout:" + items.map(
+        (t) => `${escapeKeyPart(t?.auctionId)}:${escapeKeyPart(t?.bidderCode || t?.bidder)}:${escapeKeyPart(t?.bidId || t?.transactionId || t?.adUnitCode)}`
+      ).join(",");
+    }
+    case "bidWon": {
+      const bid = data || {};
+      const uniqueBidId = bid.creativeId || bid.adId || bid.requestId || bid.bidId || "";
+      const price = bid.originalCpm ?? bid.cpm ?? "";
+      return `bidWon:${escapeKeyPart(bid.auctionId)}:${escapeKeyPart(bid.adUnitCode)}:${escapeKeyPart(bid.bidderCode || bid.bidder)}:${escapeKeyPart(uniqueBidId)}:${escapeKeyPart(price)}`;
+    }
     case "noBid":
-      return `noBid:${data?.auctionId || ""}:${data?.adUnitCode || ""}:${data?.bidderCode || data?.bidder || ""}:${data?.bidId || ""}`;
-    case "adRenderFailed":
-      return `adRenderFailed:${data?.bid?.auctionId || data?.auctionId || ""}:${data?.bid?.adUnitCode || data?.adUnitCode || ""}:${data?.bid?.bidderCode || data?.bid?.bidder || ""}:${data?.reason || ""}:${data?.message || ""}`;
-    case "adRenderSucceeded":
-      return `adRenderSucceeded:${data?.bid?.auctionId || data?.auctionId || ""}:${data?.bid?.adUnitCode || data?.adUnitCode || ""}:${data?.bid?.bidderCode || data?.bid?.bidder || ""}`;
+      return `noBid:${escapeKeyPart(data?.auctionId)}:${escapeKeyPart(data?.adUnitCode)}:${escapeKeyPart(data?.bidderCode || data?.bidder)}:${escapeKeyPart(data?.bidId || data?.transactionId)}`;
+    case "adRenderFailed": {
+      const bid = data?.bid || {};
+      return `adRenderFailed:${escapeKeyPart(bid.auctionId || data?.auctionId)}:${escapeKeyPart(bid.adUnitCode || data?.adUnitCode)}:${escapeKeyPart(bid.bidderCode || bid.bidder || data?.bidderCode || data?.bidder)}:${escapeKeyPart(data?.reason)}:${escapeKeyPart(data?.message)}`;
+    }
+    case "adRenderSucceeded": {
+      const bid = data?.bid || data || {};
+      const uniqueId = bid.creativeId || bid.adId || data?.adId || "";
+      const price = bid.originalCpm ?? bid.cpm ?? "";
+      return `adRenderSucceeded:${escapeKeyPart(bid.auctionId || data?.auctionId)}:${escapeKeyPart(bid.adUnitCode || data?.adUnitCode)}:${escapeKeyPart(bid.bidderCode || bid.bidder)}:${escapeKeyPart(uniqueId)}:${escapeKeyPart(price)}`;
+    }
     case "setTargeting":
-      return `setTargeting:${Object.keys(data || {}).sort().join(",")}`;
+      return `setTargeting:${Object.keys(data || {}).sort().map(escapeKeyPart).join(",")}`;
     case "auctionDebug":
-      return `auctionDebug:${data?.type || ""}:${String(data?.arguments?.[0] ?? "").slice(0, 50)}`;
+      return `auctionDebug:${escapeKeyPart(data?.type)}:${escapeKeyPart(String(data?.arguments?.[0] ?? "").slice(0, 50))}`;
     default:
       return "";
   }
 }
 var PrebidEventDeduper = class {
-  seenObjects = /* @__PURE__ */ new WeakSet();
+  // Object identity is tracked per event name: Prebid passes the SAME bid
+  // object to bidResponse and later to bidWon, so a bare WeakSet would drop
+  // every bidWon as a duplicate of its own bidResponse.
+  seenObjects = /* @__PURE__ */ new WeakMap();
   seenKeys = /* @__PURE__ */ new Set();
   isDuplicate(eventName, data) {
     if (!data) return false;
     if (typeof data === "object") {
-      if (this.seenObjects.has(data)) return true;
-      this.seenObjects.add(data);
+      const seenEvents = this.seenObjects.get(data);
+      if (seenEvents) {
+        if (seenEvents.has(eventName)) return true;
+        seenEvents.add(eventName);
+      } else {
+        this.seenObjects.set(data, /* @__PURE__ */ new Set([eventName]));
+      }
     }
     const key = getPrebidEventKey(eventName, data);
     if (key) {
@@ -793,7 +820,23 @@ function parseSize(raw) {
   }
   return { width: 0, height: 0 };
 }
-var BidkernelPrebidAnalytics = class {
+function parseBidDimensions(bid) {
+  if (Number.isFinite(bid?.width) && Number.isFinite(bid?.height)) {
+    return { width: bid.width, height: bid.height };
+  }
+  if (typeof bid?.size === "string") {
+    const match = bid.size.match(/^(\d+)x(\d+)$/);
+    if (match) {
+      return { width: Number(match[1]), height: Number(match[2]) };
+    }
+  }
+  return {
+    width: Number.isFinite(bid?.width) ? bid.width : 0,
+    height: Number.isFinite(bid?.height) ? bid.height : 0
+  };
+}
+var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
+  static activeInstances = /* @__PURE__ */ new Set();
   config;
   queue = [];
   errorCount = 0;
@@ -808,6 +851,13 @@ var BidkernelPrebidAnalytics = class {
   deduper = new PrebidEventDeduper();
   consecutiveSendFailures = 0;
   nextSendAllowedAt = 0;
+  replayedEventCount = 0;
+  // Viewability & refresh tracking
+  intersectionObserver = null;
+  slotViewabilityRecords = /* @__PURE__ */ new Map();
+  elementToSlotId = /* @__PURE__ */ new Map();
+  slotRefreshIndices = /* @__PURE__ */ new Map();
+  pendingThresholdListeners = /* @__PURE__ */ new Map();
   constructor(config) {
     this.config = {
       endpoint: config.endpoint || "",
@@ -821,19 +871,36 @@ var BidkernelPrebidAnalytics = class {
       auctionEnabled: config.auctionEnabled ?? true,
       warningsEnabled: config.warningsEnabled ?? true,
       errorsEnabled: config.errorsEnabled ?? true,
+      viewabilityEnabled: config.viewabilityEnabled ?? true,
       logLevel: config.logLevel || "INFO",
       pbjsGlobalName: config.pbjsGlobalName || "pbjs",
       attachPbjsListeners: config.attachPbjsListeners ?? true
     };
-    this.boundFlushBeacon = () => this.flushBeacon();
+    this.boundFlushBeacon = () => {
+      this.flushAllSlotsTimeInView();
+      this.flushBeacon();
+    };
     this.boundVisibilityChange = () => this.handleVisibilityChange();
   }
   enable() {
     if (this.isEnabled) return;
     this.isEnabled = true;
+    _BidkernelPrebidAnalytics.activeInstances.add(this);
     if (!this.config.endpoint) {
       this.log("WARN", "Endpoint is empty. Analytics events will not be transmitted.");
     }
+    if (this.config.viewabilityEnabled) {
+      if (typeof IntersectionObserver !== "undefined") {
+        this.intersectionObserver = new IntersectionObserver(this.handleIntersection.bind(this), {
+          threshold: [0.5]
+        });
+        for (const record of this.slotViewabilityRecords.values()) {
+          if (record.element) {
+            this.intersectionObserver.observe(record.element);
+          }
+        }
+      }
+    }
     if (this.config.attachPbjsListeners) {
       const win = typeof window !== "undefined" ? window : {};
       const pbjs = win[this.config.pbjsGlobalName] || {};
@@ -861,28 +928,32 @@ var BidkernelPrebidAnalytics = class {
         try {
           const pastEvents = pbjs.getEvents();
           if (Array.isArray(pastEvents)) {
-            this.log(
-              "DEBUG",
-              `Replaying ${pastEvents.length} historical events from pbjs.getEvents()`
-            );
-            const handlerMap = {
-              auctionInit: this.handleAuctionInit.bind(this),
-              auctionEnd: this.handleAuctionEnd.bind(this),
-              bidRequested: this.handleBidRequested.bind(this),
-              bidResponse: this.handleBidResponse.bind(this),
-              bidTimeout: this.handleBidTimeout.bind(this),
-              bidWon: this.handleBidWon.bind(this),
-              noBid: this.handleNoBid.bind(this),
-              adRenderFailed: this.handleAdRenderFailed.bind(this),
-              adRenderSucceeded: this.handleAdRenderSucceeded.bind(this)
-            };
-            for (const ev of pastEvents) {
-              if (!ev) continue;
-              const eventType = ev.eventType || ev.event || ev.name;
-              const args = ev.args !== void 0 ? ev.args : ev.data !== void 0 ? ev.data : ev;
-              const handler = handlerMap[eventType];
-              if (handler) {
-                handler(args);
+            const newPastEvents = pastEvents.slice(this.replayedEventCount);
+            this.replayedEventCount = pastEvents.length;
+            if (newPastEvents.length > 0) {
+              this.log(
+                "DEBUG",
+                `Replaying ${newPastEvents.length} historical events from pbjs.getEvents()`
+              );
+              const handlerMap = {
+                auctionInit: this.handleAuctionInit.bind(this),
+                auctionEnd: this.handleAuctionEnd.bind(this),
+                bidRequested: this.handleBidRequested.bind(this),
+                bidResponse: this.handleBidResponse.bind(this),
+                bidTimeout: this.handleBidTimeout.bind(this),
+                bidWon: this.handleBidWon.bind(this),
+                noBid: this.handleNoBid.bind(this),
+                adRenderFailed: this.handleAdRenderFailed.bind(this),
+                adRenderSucceeded: this.handleAdRenderSucceeded.bind(this)
+              };
+              for (const ev of newPastEvents) {
+                if (!ev) continue;
+                const eventType = ev.eventType || ev.event || ev.name;
+                const args = ev.args !== void 0 ? ev.args : ev.data !== void 0 ? ev.data : ev;
+                const handler = handlerMap[eventType];
+                if (handler) {
+                  handler(args);
+                }
               }
             }
           }
@@ -909,7 +980,28 @@ var BidkernelPrebidAnalytics = class {
   }
   disable() {
     if (!this.isEnabled) return;
+    this.flushAllSlotsTimeInView();
     this.isEnabled = false;
+    _BidkernelPrebidAnalytics.activeInstances.delete(this);
+    for (const record of this.slotViewabilityRecords.values()) {
+      if (record.dwellTimer) {
+        clearTimeout(record.dwellTimer);
+        record.dwellTimer = null;
+        record.dwellStartedAt = null;
+      }
+      for (const l of record.thresholdListeners) {
+        if (l.timer) {
+          clearTimeout(l.timer);
+          l.timer = null;
+        }
+      }
+    }
+    if (this.intersectionObserver) {
+      this.intersectionObserver.disconnect();
+      this.intersectionObserver = null;
+    }
+    this.slotViewabilityRecords.clear();
+    this.elementToSlotId.clear();
     if (this.flushTimer) {
       clearInterval(this.flushTimer);
       this.flushTimer = null;
@@ -933,8 +1025,443 @@ var BidkernelPrebidAnalytics = class {
     this.flush();
   }
   handleVisibilityChange() {
-    if (typeof document !== "undefined" && document.visibilityState === "hidden") {
+    if (typeof document === "undefined") return;
+    if (document.visibilityState === "hidden") {
+      const now = typeof performance !== "undefined" && performance.now ? performance.now() : Date.now();
+      for (const record of this.slotViewabilityRecords.values()) {
+        if (record.inView && record.lastEnteredViewAt !== null) {
+          record.accumulatedTimeInViewMs += Math.max(0, now - record.lastEnteredViewAt);
+          record.lastEnteredViewAt = null;
+          this.checkThresholdListeners(record);
+        }
+        if (record.dwellTimer) {
+          clearTimeout(record.dwellTimer);
+          record.dwellTimer = null;
+          record.dwellStartedAt = null;
+        }
+        for (const l of record.thresholdListeners) {
+          if (l.timer) {
+            clearTimeout(l.timer);
+            l.timer = null;
+          }
+        }
+        const durationMs = Math.round(record.accumulatedTimeInViewMs);
+        if (durationMs > 0) {
+          this.enqueue(TraceEventType.TIME_IN_VIEW, "timeInView", {
+            auctionId: record.auctionId,
+            transactionId: record.transactionId,
+            adUnitCode: record.adUnitCode,
+            viewableDurationMs: durationMs,
+            bid: record.bidPayload,
+            metadata: {
+              ...record.metadata,
+              refresh_index: String(record.refreshIndex)
+            }
+          });
+        }
+      }
       this.flushBeacon();
+    } else if (document.visibilityState === "visible") {
+      const now = typeof performance !== "undefined" && performance.now ? performance.now() : Date.now();
+      for (const record of this.slotViewabilityRecords.values()) {
+        if (record.inView) {
+          record.lastEnteredViewAt = now;
+          if (!record.viewableFired && record.dwellTimer === null) {
+            const dwellTarget = record.mediaType === "video" ? 2e3 : 1e3;
+            record.dwellStartedAt = now;
+            record.dwellTimer = setTimeout(() => {
+              this.handleDwellComplete(record);
+            }, dwellTarget);
+          }
+          this.scheduleThresholdTimers(record);
+        }
+      }
+    }
+  }
+  handleIntersection(entries) {
+    for (const entry of entries) {
+      let slotId = this.elementToSlotId.get(entry.target);
+      if (!slotId) {
+        for (const instance of _BidkernelPrebidAnalytics.activeInstances) {
+          if (instance !== this && instance.elementToSlotId.has(entry.target)) {
+            instance.handleIntersection([entry]);
+            break;
+          }
+        }
+        continue;
+      }
+      const record = this.slotViewabilityRecords.get(slotId);
+      if (!record) continue;
+      const isViewableRatio = entry.isIntersecting && (entry.intersectionRatio === void 0 || entry.intersectionRatio >= 0.5);
+      const isDocVisible = typeof document === "undefined" || document.visibilityState === "visible";
+      const now = typeof performance !== "undefined" && performance.now ? performance.now() : Date.now();
+      if (isViewableRatio) {
+        if (!record.inView) {
+          record.inView = true;
+          if (isDocVisible) {
+            record.lastEnteredViewAt = now;
+            if (!record.viewableFired && record.dwellTimer === null) {
+              const dwellTarget = record.mediaType === "video" ? 2e3 : 1e3;
+              record.dwellStartedAt = now;
+              record.dwellTimer = setTimeout(() => {
+                this.handleDwellComplete(record);
+              }, dwellTarget);
+            }
+            this.scheduleThresholdTimers(record);
+          }
+        }
+      } else {
+        if (record.inView) {
+          if (record.lastEnteredViewAt !== null) {
+            record.accumulatedTimeInViewMs += Math.max(0, now - record.lastEnteredViewAt);
+            record.lastEnteredViewAt = null;
+          }
+          record.inView = false;
+          this.checkThresholdListeners(record);
+        }
+        if (record.dwellTimer !== null) {
+          clearTimeout(record.dwellTimer);
+          record.dwellTimer = null;
+          record.dwellStartedAt = null;
+        }
+        for (const l of record.thresholdListeners) {
+          if (l.timer) {
+            clearTimeout(l.timer);
+            l.timer = null;
+          }
+        }
+      }
+    }
+  }
+  handleDwellComplete(record) {
+    record.dwellTimer = null;
+    record.dwellStartedAt = null;
+    if (!record.inView) return;
+    if (typeof document !== "undefined" && document.visibilityState === "hidden") return;
+    if (!record.viewableFired) {
+      record.viewableFired = true;
+      this.enqueue(TraceEventType.VIEWABLE, "viewable", {
+        auctionId: record.auctionId,
+        transactionId: record.transactionId,
+        adUnitCode: record.adUnitCode,
+        bid: record.bidPayload,
+        metadata: {
+          ...record.metadata,
+          refresh_index: String(record.refreshIndex)
+        }
+      });
+    }
+  }
+  scheduleThresholdTimers(record) {
+    if (!record.inView || typeof document !== "undefined" && document.visibilityState === "hidden") {
+      return;
+    }
+    const currentTotal = this.getCurrentTimeInView(record);
+    for (const listener of record.thresholdListeners) {
+      if (listener.fired) continue;
+      if (currentTotal >= listener.thresholdMs) {
+        listener.fired = true;
+        if (listener.timer) {
+          clearTimeout(listener.timer);
+          listener.timer = null;
+        }
+        try {
+          listener.callback(record.slotId, currentTotal);
+        } catch (e) {
+          this.log("ERROR", "Error in threshold listener callback", e);
+        }
+      } else {
+        if (listener.timer) {
+          clearTimeout(listener.timer);
+        }
+        const remaining = listener.thresholdMs - currentTotal;
+        listener.timer = setTimeout(() => {
+          listener.timer = null;
+          if (!listener.fired && record.inView && (typeof document === "undefined" || document.visibilityState === "visible")) {
+            const nowTotal = this.getCurrentTimeInView(record);
+            if (nowTotal >= listener.thresholdMs) {
+              listener.fired = true;
+              try {
+                listener.callback(record.slotId, nowTotal);
+              } catch (e) {
+                this.log("ERROR", "Error in threshold listener callback", e);
+              }
+            }
+          }
+        }, remaining);
+      }
+    }
+  }
+  checkThresholdListeners(record) {
+    const currentTotal = this.getCurrentTimeInView(record);
+    for (const listener of record.thresholdListeners) {
+      if (!listener.fired && currentTotal >= listener.thresholdMs) {
+        listener.fired = true;
+        if (listener.timer) {
+          clearTimeout(listener.timer);
+          listener.timer = null;
+        }
+        try {
+          listener.callback(record.slotId, currentTotal);
+        } catch (e) {
+          this.log("ERROR", "Error in threshold listener callback", e);
+        }
+      }
+    }
+  }
+  getCurrentTimeInView(record) {
+    let total = record.accumulatedTimeInViewMs;
+    if (record.inView && record.lastEnteredViewAt !== null) {
+      const now = typeof performance !== "undefined" && performance.now ? performance.now() : Date.now();
+      total += Math.max(0, now - record.lastEnteredViewAt);
+    }
+    return total;
+  }
+  flushSlotTimeInView(slotId) {
+    const record = this.slotViewabilityRecords.get(slotId);
+    if (!record) return;
+    if (record.inView && record.lastEnteredViewAt !== null) {
+      const now = typeof performance !== "undefined" && performance.now ? performance.now() : Date.now();
+      record.accumulatedTimeInViewMs += Math.max(0, now - record.lastEnteredViewAt);
+      record.lastEnteredViewAt = null;
+    }
+    const durationMs = Math.round(record.accumulatedTimeInViewMs);
+    if (durationMs > 0) {
+      this.enqueue(TraceEventType.TIME_IN_VIEW, "timeInView", {
+        auctionId: record.auctionId,
+        transactionId: record.transactionId,
+        adUnitCode: record.adUnitCode,
+        viewableDurationMs: durationMs,
+        bid: record.bidPayload,
+        metadata: {
+          ...record.metadata,
+          refresh_index: String(record.refreshIndex)
+        }
+      });
+    }
+    record.accumulatedTimeInViewMs = 0;
+  }
+  flushAllSlotsTimeInView() {
+    for (const slotId of Array.from(this.slotViewabilityRecords.keys())) {
+      this.flushSlotTimeInView(slotId);
+    }
+  }
+  observeSlot(element, slotId, options) {
+    if (!this.config.viewabilityEnabled) return;
+    let el = null;
+    if (typeof element === "string") {
+      if (typeof document !== "undefined") {
+        try {
+          el = document.querySelector(element) || document.getElementById(element);
+        } catch {
+          el = document.getElementById(element);
+        }
+        if (!el) {
+          el = document.getElementById(element);
+        }
+      }
+    } else {
+      el = element;
+    }
+    const resolvedSlotId = slotId || options?.adUnitCode || (el ? el.id : "") || generateUUID();
+    const existing = this.slotViewabilityRecords.get(resolvedSlotId);
+    if (existing) {
+      const isNewRefreshCycle = options?.refreshIndex === void 0 || options.refreshIndex > existing.refreshIndex;
+      if (isNewRefreshCycle) {
+        this.flushSlotTimeInView(resolvedSlotId);
+        const nextRefreshIndex = options?.refreshIndex !== void 0 ? options.refreshIndex : (this.slotRefreshIndices.get(resolvedSlotId) ?? existing.refreshIndex) + 1;
+        this.slotRefreshIndices.set(resolvedSlotId, nextRefreshIndex);
+        if (options?.emitRefreshEvent !== false) {
+          this.enqueue(TraceEventType.REFRESH, "refresh", {
+            auctionId: options?.auctionId || existing.auctionId,
+            transactionId: options?.transactionId || existing.transactionId,
+            adUnitCode: resolvedSlotId,
+            bid: options?.bid ?? existing.bidPayload,
+            metadata: {
+              ...options?.metadata,
+              refresh_index: String(nextRefreshIndex)
+            }
+          });
+        }
+        if (existing.dwellTimer) {
+          clearTimeout(existing.dwellTimer);
+          existing.dwellTimer = null;
+          existing.dwellStartedAt = null;
+        }
+        for (const l of existing.thresholdListeners) {
+          l.fired = false;
+          if (l.timer) {
+            clearTimeout(l.timer);
+            l.timer = null;
+          }
+        }
+        existing.viewableFired = false;
+        existing.accumulatedTimeInViewMs = 0;
+        const now = typeof performance !== "undefined" && performance.now ? performance.now() : Date.now();
+        existing.lastEnteredViewAt = existing.inView ? now : null;
+        existing.refreshIndex = nextRefreshIndex;
+        existing.auctionId = options?.auctionId || existing.auctionId;
+        existing.transactionId = options?.transactionId || existing.transactionId;
+        existing.mediaType = options?.mediaType || existing.mediaType || "banner";
+        existing.bidPayload = options?.bid !== void 0 ? options.bid : existing.bidPayload;
+        existing.metadata = options?.metadata ?? existing.metadata;
+        if (existing.inView && (typeof document === "undefined" || document.visibilityState === "visible")) {
+          const dwellTarget = existing.mediaType === "video" ? 2e3 : 1e3;
+          existing.dwellStartedAt = now;
+          existing.dwellTimer = setTimeout(() => {
+            this.handleDwellComplete(existing);
+          }, dwellTarget);
+          this.scheduleThresholdTimers(existing);
+        }
+      } else {
+        existing.auctionId = options?.auctionId || existing.auctionId;
+        existing.transactionId = options?.transactionId || existing.transactionId;
+        existing.mediaType = options?.mediaType || existing.mediaType;
+        if (options?.bid !== void 0) existing.bidPayload = options.bid;
+        if (options?.metadata !== void 0) existing.metadata = options.metadata;
+      }
+      if (el) {
+        if (existing.element && existing.element !== el && this.intersectionObserver) {
+          this.intersectionObserver.unobserve(existing.element);
+          this.elementToSlotId.delete(existing.element);
+        }
+        existing.element = el;
+        this.elementToSlotId.set(el, resolvedSlotId);
+        this.intersectionObserver?.observe(el);
+      }
+    } else {
+      const initialRefreshIndex = options?.refreshIndex ?? this.slotRefreshIndices.get(resolvedSlotId) ?? 0;
+      this.slotRefreshIndices.set(resolvedSlotId, initialRefreshIndex);
+      const listeners = this.pendingThresholdListeners.get(resolvedSlotId) || /* @__PURE__ */ new Set();
+      this.pendingThresholdListeners.delete(resolvedSlotId);
+      const record = {
+        slotId: resolvedSlotId,
+        element: el,
+        adUnitCode: options?.adUnitCode || resolvedSlotId,
+        auctionId: options?.auctionId || "",
+        transactionId: options?.transactionId || "",
+        mediaType: options?.mediaType || "banner",
+        bidPayload: options?.bid,
+        metadata: options?.metadata,
+        refreshIndex: initialRefreshIndex,
+        inView: false,
+        lastEnteredViewAt: null,
+        accumulatedTimeInViewMs: 0,
+        viewableFired: false,
+        dwellTimer: null,
+        dwellStartedAt: null,
+        thresholdListeners: listeners
+      };
+      this.slotViewabilityRecords.set(resolvedSlotId, record);
+      if (el) {
+        this.elementToSlotId.set(el, resolvedSlotId);
+        this.intersectionObserver?.observe(el);
+      }
+    }
+  }
+  unobserveSlot(slotId) {
+    const record = this.slotViewabilityRecords.get(slotId);
+    if (!record) return;
+    this.flushSlotTimeInView(slotId);
+    if (record.dwellTimer) {
+      clearTimeout(record.dwellTimer);
+      record.dwellTimer = null;
+      record.dwellStartedAt = null;
+    }
+    for (const l of record.thresholdListeners) {
+      if (l.timer) {
+        clearTimeout(l.timer);
+        l.timer = null;
+      }
+    }
+    record.thresholdListeners = /* @__PURE__ */ new Set();
+    if (record.element && this.intersectionObserver) {
+      this.intersectionObserver.unobserve(record.element);
+      this.elementToSlotId.delete(record.element);
+      record.element = null;
+    }
+    record.inView = false;
+    record.lastEnteredViewAt = null;
+  }
+  destroySlot(slotId) {
+    this.unobserveSlot(slotId);
+    this.slotViewabilityRecords.delete(slotId);
+    this.slotRefreshIndices.delete(slotId);
+    this.pendingThresholdListeners.delete(slotId);
+  }
+  onTimeInViewThreshold(slotId, thresholdMs, callback) {
+    const listener = {
+      thresholdMs,
+      callback,
+      timer: null,
+      fired: false
+    };
+    const record = this.slotViewabilityRecords.get(slotId);
+    if (record) {
+      record.thresholdListeners.add(listener);
+      const currentTotal = this.getCurrentTimeInView(record);
+      if (currentTotal >= thresholdMs) {
+        listener.fired = true;
+        try {
+          callback(slotId, currentTotal);
+        } catch (e) {
+          this.log("ERROR", "Error in threshold callback", e);
+        }
+      } else if (record.inView && (typeof document === "undefined" || document.visibilityState === "visible")) {
+        const remaining = thresholdMs - currentTotal;
+        listener.timer = setTimeout(() => {
+          listener.timer = null;
+          if (!listener.fired && record.inView && (typeof document === "undefined" || document.visibilityState === "visible")) {
+            const nowTotal = this.getCurrentTimeInView(record);
+            if (nowTotal >= thresholdMs) {
+              listener.fired = true;
+              try {
+                callback(slotId, nowTotal);
+              } catch (e) {
+                this.log("ERROR", "Error in threshold callback", e);
+              }
+            }
+          }
+        }, remaining);
+      }
+    } else {
+      if (!this.pendingThresholdListeners.has(slotId)) {
+        this.pendingThresholdListeners.set(slotId, /* @__PURE__ */ new Set());
+      }
+      this.pendingThresholdListeners.get(slotId).add(listener);
+    }
+    return () => {
+      if (listener.timer) {
+        clearTimeout(listener.timer);
+        listener.timer = null;
+      }
+      if (record) {
+        record.thresholdListeners.delete(listener);
+      }
+      const pending = this.pendingThresholdListeners.get(slotId);
+      if (pending) {
+        pending.delete(listener);
+      }
+    };
+  }
+  getViewabilityState(slotId) {
+    const record = this.slotViewabilityRecords.get(slotId);
+    if (!record) return void 0;
+    const timeInViewMs = Math.round(this.getCurrentTimeInView(record));
+    return {
+      inView: record.inView,
+      viewable: record.viewableFired,
+      timeInViewMs,
+      refreshIndex: record.refreshIndex
+    };
+  }
+  getRefreshIndex(slotId) {
+    return this.slotRefreshIndices.get(slotId) ?? 0;
+  }
+  triggerSlotRefresh(slotId, options) {
+    const record = this.slotViewabilityRecords.get(slotId);
+    if (record && record.element) {
+      this.observeSlot(record.element, slotId, options);
     }
   }
   trackRawEvent(level, eventName, data) {
@@ -949,6 +1476,8 @@ var BidkernelPrebidAnalytics = class {
   }
   navigate(pageviewId, pageUrl) {
     this.disable();
+    this.slotRefreshIndices.clear();
+    this.pendingThresholdListeners.clear();
     this.config.pageviewId = pageviewId || generateUUID();
     if (pageUrl) {
       try {
@@ -967,30 +1496,34 @@ var BidkernelPrebidAnalytics = class {
     if (this.isDuplicate("auctionInit", data)) return;
     this.log("DEBUG", "auctionInit", data);
     this.enqueue(TraceEventType.AUCTION_START, "auctionStart", {
-      auctionId: data.auctionId || ""
+      auctionId: data.auctionId || "",
+      transactionId: data.transactionId || ""
     });
   }
   handleAuctionEnd(data) {
     if (this.isDuplicate("auctionEnd", data)) return;
     this.log("DEBUG", "auctionEnd", data);
     this.enqueue(TraceEventType.AUCTION_END, "auctionEnd", {
-      auctionId: data.auctionId || ""
+      auctionId: data.auctionId || "",
+      transactionId: data.transactionId || ""
     });
   }
   handleBidRequested(data) {
     if (this.isDuplicate("bidRequested", data)) return;
     this.log("DEBUG", "bidRequested", data);
     const auctionId = data.auctionId || "";
-    const bidder = data.bidderCode || "";
+    const bidder = data.bidderCode || data.bidder || "";
     if (Array.isArray(data.bids)) {
       data.bids.forEach((bid) => {
         const mediaTypes = Object.keys(bid.mediaTypes || {});
         const gpid = bid.ortb2Imp?.ext?.gpid || bid.gpid || data.gpid || "";
+        const transactionId = bid.transactionId || bid.ortb2Imp?.id || data.transactionId || "";
         if (mediaTypes.length === 0) {
           const mediaType = bid.mediaType || "banner";
           const { width, height } = parseSize(bid.sizes || bid.playerSize);
           this.enqueue(TraceEventType.BID_REQUEST, "bidRequest", {
             auctionId,
+            transactionId,
             adUnitCode: bid.adUnitCode || "",
             gpid,
             bid: {
@@ -1014,6 +1547,7 @@ var BidkernelPrebidAnalytics = class {
           const { width, height } = parseSize(rawSize);
           this.enqueue(TraceEventType.BID_REQUEST, "bidRequest", {
             auctionId,
+            transactionId,
             adUnitCode: bid.adUnitCode || "",
             gpid,
             bid: {
@@ -1032,13 +1566,13 @@ var BidkernelPrebidAnalytics = class {
     this.log("DEBUG", "bidResponse", data);
     this.enqueue(TraceEventType.BID_RESPONSE, "bidResponse", {
       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",
-        width: Number.isFinite(data.width) ? data.width : 0,
-        height: Number.isFinite(data.height) ? data.height : 0,
+        ...parseBidDimensions(data),
         dealId: data.dealId || "",
         mediaType: data.mediaType || "banner",
         latencyMs: Number.isFinite(data.timeToRespond) ? data.timeToRespond : 0,
@@ -1050,15 +1584,16 @@ var BidkernelPrebidAnalytics = class {
   handleBidTimeout(data) {
     if (this.isDuplicate("bidTimeout", data)) return;
     this.log("DEBUG", "bidTimeout", data);
-    if (Array.isArray(data)) {
-      data.forEach((t) => {
-        this.enqueue(TraceEventType.BID_TIMEOUT, "bidTimeout", {
-          auctionId: t.auctionId || "",
-          adUnitCode: t.adUnitCode || "",
-          bid: {
-            bidder: t.bidder || ""
-          }
-        });
+    const items = Array.isArray(data) ? data : data ? [data] : [];
+    for (const t of items) {
+      this.enqueue(TraceEventType.BID_TIMEOUT, "bidTimeout", {
+        auctionId: t.auctionId || "",
+        transactionId: t.transactionId || "",
+        adUnitCode: t.adUnitCode || "",
+        bid: {
+          bidder: t.bidderCode || t.bidder || "",
+          latencyMs: Number.isFinite(t.timeout) ? t.timeout : 0
+        }
       });
     }
   }
@@ -1067,13 +1602,13 @@ var BidkernelPrebidAnalytics = class {
     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",
-        width: Number.isFinite(data.width) ? data.width : 0,
-        height: Number.isFinite(data.height) ? data.height : 0,
+        ...parseBidDimensions(data),
         dealId: data.dealId || "",
         mediaType: data.mediaType || "banner",
         latencyMs: Number.isFinite(data.timeToRespond) ? data.timeToRespond : 0,
@@ -1087,6 +1622,7 @@ var BidkernelPrebidAnalytics = class {
     this.log("DEBUG", "noBid", data);
     this.enqueue(TraceEventType.NO_BID, "noBid", {
       auctionId: data.auctionId || "",
+      transactionId: data.transactionId || "",
       adUnitCode: data.adUnitCode || "",
       bid: {
         bidder: data.bidderCode || data.bidder || ""
@@ -1096,16 +1632,19 @@ var BidkernelPrebidAnalytics = class {
   handleAdRenderFailed(data) {
     if (this.isDuplicate("adRenderFailed", data)) return;
     this.log("DEBUG", "adRenderFailed", data);
+    const bid = data.bid || {};
     this.enqueue(TraceEventType.AD_RENDER_FAILED, "adRenderFailed", {
-      auctionId: data.bid?.auctionId || "",
-      adUnitCode: data.bid?.adUnitCode || "",
+      auctionId: bid.auctionId || data.auctionId || "",
+      transactionId: bid.transactionId || data.transactionId || "",
+      adUnitCode: bid.adUnitCode || data.adUnitCode || "",
       bid: {
-        bidder: data.bid?.bidderCode || data.bid?.bidder || ""
+        bidder: bid.bidderCode || bid.bidder || data.bidderCode || data.bidder || ""
       },
       metadata: {
         reason: String(data.reason || ""),
-        message: String(data.message || "")
-      }
+        message: String(data.message || data.error?.message || "")
+      },
+      error: data.error || (data.message ? new Error(String(data.message)) : void 0)
     });
   }
   // Prebid's adRenderSucceeded payload is { doc, bid, adId }: the winning bid
@@ -1113,23 +1652,81 @@ var BidkernelPrebidAnalytics = class {
   handleAdRenderSucceeded(data) {
     if (this.isDuplicate("adRenderSucceeded", data)) return;
     this.log("DEBUG", "adRenderSucceeded", data);
-    const bid = data.bid || {};
+    const bid = data.bid || data || {};
+    const adUnitCode = data.adUnitCode || bid.adUnitCode || "";
+    const auctionId = bid.auctionId || data.auctionId || "";
+    const transactionId = bid.transactionId || data.transactionId || "";
+    const mediaType = bid.mediaType || "banner";
+    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 || ""
+    };
+    const isRefresh = adUnitCode && (this.slotViewabilityRecords.has(adUnitCode) || this.slotRefreshIndices.has(adUnitCode) && this.slotRefreshIndices.get(adUnitCode) > 0);
+    if (isRefresh) {
+      this.flushSlotTimeInView(adUnitCode);
+      const nextRefreshIndex = (this.slotRefreshIndices.get(adUnitCode) ?? 0) + 1;
+      this.slotRefreshIndices.set(adUnitCode, nextRefreshIndex);
+      this.enqueue(TraceEventType.REFRESH, "refresh", {
+        auctionId,
+        transactionId,
+        adUnitCode,
+        bid: bidTrace,
+        metadata: { refresh_index: String(nextRefreshIndex) }
+      });
+    } else if (adUnitCode && !this.slotRefreshIndices.has(adUnitCode)) {
+      this.slotRefreshIndices.set(adUnitCode, 0);
+    }
+    const currentRefreshIndex = adUnitCode ? this.slotRefreshIndices.get(adUnitCode) ?? 0 : 0;
     this.enqueue(TraceEventType.IMPRESSION, "impression", {
-      auctionId: bid.auctionId || "",
-      adUnitCode: data.adUnitCode || bid.adUnitCode || "",
-      bid: {
-        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",
-        width: Number.isFinite(bid.width) ? bid.width : 0,
-        height: Number.isFinite(bid.height) ? bid.height : 0,
-        dealId: bid.dealId || "",
-        mediaType: bid.mediaType || "banner",
-        latencyMs: Number.isFinite(bid.timeToRespond) ? bid.timeToRespond : 0,
-        advertiserDomain: bid.meta?.advertiserDomains?.[0] || "",
-        creativeId: bid.creativeId || ""
-      }
+      auctionId,
+      transactionId,
+      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;
+      if (targetId) {
+        el = document.getElementById(targetId);
+      }
+      if (!el && typeof window !== "undefined" && window.googletag?.pubads) {
+        try {
+          const slots = window.googletag.pubads().getSlots();
+          for (const slot of slots) {
+            if (slot.getAdUnitPath?.() === adUnitCode || slot.getSlotElementId?.() === adUnitCode) {
+              el = document.getElementById(slot.getSlotElementId());
+              if (el) break;
+            }
+          }
+        } catch {
+        }
+      }
+      if (!el && targetId) {
+        try {
+          el = document.querySelector(`[data-ad-slot="${targetId}"]`) || document.querySelector(`#${targetId}`);
+        } catch {
+        }
+      }
+      if (el) {
+        this.observeSlot(el, adUnitCode || targetId, {
+          adUnitCode,
+          auctionId,
+          transactionId,
+          mediaType,
+          bid: bidTrace,
+          refreshIndex: currentRefreshIndex,
+          emitRefreshEvent: false
+        });
+      }
+    }
   }
   isDuplicate(eventName, data) {
     return this.deduper.isDuplicate(eventName, data);
@@ -1137,6 +1734,7 @@ var BidkernelPrebidAnalytics = class {
   enqueue(type, eventName, data, level) {
     if (!this.isEnabled) return;
     if (!this.shouldSample(type, level)) return;
+    extendSession();
     const protoEvent = {
       eventId: generateUUID(),
       timestampMs: Date.now(),
@@ -1151,11 +1749,14 @@ var BidkernelPrebidAnalytics = class {
       protoEvent.bid = {
         bidder: data.bid.bidder || "",
         cpm: Number.isFinite(data.bid.cpm) ? data.bid.cpm : 0,
-        currency: data.bid.currency || "USD",
+        // No defaults here: handlers with a priced bid (bidResponse, bidWon,
+        // impression) set currency/mediaType themselves. Defaulting for the
+        // rest would stamp fake "USD"/"banner" on noBid and bidRequest rows.
+        currency: data.bid.currency || "",
         width: Number.isFinite(data.bid.width) ? data.bid.width : 0,
         height: Number.isFinite(data.bid.height) ? data.bid.height : 0,
         dealId: data.bid.dealId || "",
-        mediaType: data.bid.mediaType || "banner",
+        mediaType: data.bid.mediaType || "",
         latencyMs: Number.isFinite(data.bid.latencyMs) ? data.bid.latencyMs : 0,
         advertiserDomain: data.bid.advertiserDomain || "",
         creativeId: data.bid.creativeId || ""
@@ -1171,6 +1772,9 @@ var BidkernelPrebidAnalytics = class {
     if (data.gpid) {
       metadata.gpid = String(data.gpid);
     }
+    if (data.refreshIndex !== void 0 && metadata.refresh_index === void 0) {
+      metadata.refresh_index = String(data.refreshIndex);
+    }
     if (Object.keys(metadata).length > 0) {
       protoEvent.metadata = metadata;
     }
@@ -1200,14 +1804,13 @@ var BidkernelPrebidAnalytics = class {
       this.queue.splice(0, this.queue.length - MAX_QUEUE_SIZE);
     }
   }
-  // Drains the queue and returns the encoded batch plus target URL and event list,
-  // or null if there is nothing to send. Shared by flush() and flushBeacon().
+  // Drains a batch (up to MAX_PAYLOAD_BYTES) from the queue.
+  // Shared by flush() and flushBeacon().
   drainBatch() {
     if (this.queue.length === 0 || !this.config.endpoint) return null;
-    const events = this.queue;
-    this.queue = [];
+    let events = this.queue;
     const domain = typeof window !== "undefined" ? window.location.hostname : "";
-    const batch = {
+    const buildBatch = (evts) => ({
       propertyId: this.config.propertyId,
       pageviewId: this.config.pageviewId,
       sessionId: this.config.sessionId,
@@ -1217,25 +1820,42 @@ var BidkernelPrebidAnalytics = class {
       deviceType: this.config.deviceType,
       userId: this.config.userId,
       domain,
-      events
-    };
+      events: evts
+    });
+    let encoded = TraceEventBatch.encode(
+      buildBatch(events)
+    ).finish();
+    while (events.length > 1 && encoded.byteLength > MAX_PAYLOAD_BYTES) {
+      events = events.slice(0, Math.floor(events.length / 2));
+      encoded = TraceEventBatch.encode(
+        buildBatch(events)
+      ).finish();
+    }
+    this.queue = this.queue.slice(events.length);
     return {
       url: `${this.config.endpoint}/${this.config.propertyId}`,
       // protobufjs types finish() as Uint8Array<ArrayBufferLike>; the buffer is
       // always a plain ArrayBuffer, so narrow for fetch/Blob compatibility.
-      encoded: TraceEventBatch.encode(batch).finish(),
+      encoded,
       events
     };
   }
-  sendFetch(payload) {
-    fetch(payload.url, {
+  sendFetch(payload, useKeepalive = false) {
+    const fetchOpts = {
       method: "POST",
       headers: { "Content-Type": "application/x-protobuf" },
-      body: payload.encoded,
-      keepalive: true
-    }).then((res) => {
+      body: payload.encoded
+    };
+    if (useKeepalive) {
+      fetchOpts.keepalive = true;
+    }
+    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) {
+          this.log("WARN", `Dropping batch due to non-retryable client error HTTP ${res.status}`);
+          return;
+        }
         this.handleSendFailure(payload.events);
       } else {
         this.consecutiveSendFailures = 0;
@@ -1245,6 +1865,12 @@ var BidkernelPrebidAnalytics = class {
       this.log("ERROR", "Failed to send batch", err);
       this.handleSendFailure(payload.events);
     });
+    if (typeof process !== "undefined" && typeof process._tickCallback === "function") {
+      try {
+        process._tickCallback();
+      } catch {
+      }
+    }
   }
   handleSendFailure(events) {
     this.consecutiveSendFailures++;
@@ -1264,24 +1890,31 @@ var BidkernelPrebidAnalytics = class {
   }
   flush() {
     if (Date.now() < this.nextSendAllowedAt) return;
-    const payload = this.drainBatch();
-    if (!payload) return;
-    this.sendFetch(payload);
+    let payload = this.drainBatch();
+    while (payload) {
+      this.sendFetch(payload, false);
+      if (Date.now() < this.nextSendAllowedAt) break;
+      payload = this.drainBatch();
+    }
   }
   flushBeacon() {
-    const payload = this.drainBatch();
-    if (!payload) return;
-    let sent = false;
-    if (typeof navigator !== "undefined" && typeof navigator.sendBeacon === "function") {
-      try {
-        const blob = new Blob([payload.encoded], { type: "application/x-protobuf" });
-        sent = navigator.sendBeacon(payload.url, blob);
-      } catch {
-        sent = false;
+    let payload = this.drainBatch();
+    while (payload) {
+      let sent = false;
+      if (typeof navigator !== "undefined" && typeof navigator.sendBeacon === "function") {
+        try {
+          const blob = new Blob([payload.encoded], {
+            type: "application/x-protobuf"
+          });
+          sent = navigator.sendBeacon(payload.url, blob);
+        } catch {
+          sent = false;
+        }
       }
-    }
-    if (!sent) {
-      this.sendFetch(payload);
+      if (!sent) {
+        this.sendFetch(payload, true);
+      }
+      payload = this.drainBatch();
     }
   }
   log(level, msg, ...args) {