@bidkernel/analytics 0.1.0

package/dist/index.js

@@ -0,0 +1,1396 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  BidkernelPrebidAnalytics: () => BidkernelPrebidAnalytics,
+  PrebidEventDeduper: () => PrebidEventDeduper,
+  getPrebidEventKey: () => getPrebidEventKey,
+  getbidkernel: () => getbidkernel,
+  registerPrebidAnalytics: () => registerPrebidAnalytics
+});
+module.exports = __toCommonJS(src_exports);
+
+// ../../protogen/trace_event.ts
+var import_wire = require("@bufbuild/protobuf/wire");
+var TraceEventType = {
+  TRACE_EVENT_TYPE_UNSPECIFIED: 0,
+  AUCTION_START: 1,
+  AUCTION_END: 2,
+  BID_REQUEST: 3,
+  BID_RESPONSE: 4,
+  BID_WIN: 5,
+  BID_TIMEOUT: 6,
+  /** IMPRESSION - ad rendered into DOM */
+  IMPRESSION: 7,
+  /** VIEWABLE - IAB viewability threshold met (boolean, once per render cycle) */
+  VIEWABLE: 8,
+  /** TIME_IN_VIEW - accumulated in-viewport duration (once per render cycle end) */
+  TIME_IN_VIEW: 14,
+  REFRESH: 9,
+  ERROR: 10,
+  SLOT_DEFINED: 11,
+  SLOT_DESTROYED: 12,
+  /** CLICK - ad click-through */
+  CLICK: 13,
+  /** NO_BID - bidder responded with no bid */
+  NO_BID: 15,
+  /** AD_RENDER_FAILED - Prebid failed to render the winning ad */
+  AD_RENDER_FAILED: 16,
+  UNRECOGNIZED: -1
+};
+function createBaseTraceEventBatch() {
+  return {
+    propertyId: "",
+    pageviewId: "",
+    sessionId: "",
+    pageUrl: "",
+    country: "",
+    region: "",
+    deviceType: "",
+    userId: "",
+    domain: "",
+    events: [],
+    browser: "",
+    deviceManufacturer: "",
+    deviceModel: "",
+    city: "",
+    postalCode: ""
+  };
+}
+var TraceEventBatch = {
+  encode(message, writer = new import_wire.BinaryWriter()) {
+    if (message.propertyId !== void 0 && message.propertyId !== "") {
+      writer.uint32(10).string(message.propertyId);
+    }
+    if (message.pageviewId !== void 0 && message.pageviewId !== "") {
+      writer.uint32(18).string(message.pageviewId);
+    }
+    if (message.sessionId !== void 0 && message.sessionId !== "") {
+      writer.uint32(26).string(message.sessionId);
+    }
+    if (message.pageUrl !== void 0 && message.pageUrl !== "") {
+      writer.uint32(34).string(message.pageUrl);
+    }
+    if (message.country !== void 0 && message.country !== "") {
+      writer.uint32(42).string(message.country);
+    }
+    if (message.region !== void 0 && message.region !== "") {
+      writer.uint32(50).string(message.region);
+    }
+    if (message.deviceType !== void 0 && message.deviceType !== "") {
+      writer.uint32(58).string(message.deviceType);
+    }
+    if (message.userId !== void 0 && message.userId !== "") {
+      writer.uint32(66).string(message.userId);
+    }
+    if (message.domain !== void 0 && message.domain !== "") {
+      writer.uint32(74).string(message.domain);
+    }
+    if (message.events !== void 0 && message.events.length !== 0) {
+      for (const v of message.events) {
+        TraceEvent.encode(v, writer.uint32(82).fork()).join();
+      }
+    }
+    if (message.browser !== void 0 && message.browser !== "") {
+      writer.uint32(90).string(message.browser);
+    }
+    if (message.deviceManufacturer !== void 0 && message.deviceManufacturer !== "") {
+      writer.uint32(98).string(message.deviceManufacturer);
+    }
+    if (message.deviceModel !== void 0 && message.deviceModel !== "") {
+      writer.uint32(106).string(message.deviceModel);
+    }
+    if (message.city !== void 0 && message.city !== "") {
+      writer.uint32(114).string(message.city);
+    }
+    if (message.postalCode !== void 0 && message.postalCode !== "") {
+      writer.uint32(122).string(message.postalCode);
+    }
+    return writer;
+  },
+  decode(input, length) {
+    const reader = input instanceof import_wire.BinaryReader ? input : new import_wire.BinaryReader(input);
+    const end = length === void 0 ? reader.len : reader.pos + length;
+    const message = createBaseTraceEventBatch();
+    while (reader.pos < end) {
+      const tag = reader.uint32();
+      switch (tag >>> 3) {
+        case 1: {
+          if (tag !== 10) {
+            break;
+          }
+          message.propertyId = reader.string();
+          continue;
+        }
+        case 2: {
+          if (tag !== 18) {
+            break;
+          }
+          message.pageviewId = reader.string();
+          continue;
+        }
+        case 3: {
+          if (tag !== 26) {
+            break;
+          }
+          message.sessionId = reader.string();
+          continue;
+        }
+        case 4: {
+          if (tag !== 34) {
+            break;
+          }
+          message.pageUrl = reader.string();
+          continue;
+        }
+        case 5: {
+          if (tag !== 42) {
+            break;
+          }
+          message.country = reader.string();
+          continue;
+        }
+        case 6: {
+          if (tag !== 50) {
+            break;
+          }
+          message.region = reader.string();
+          continue;
+        }
+        case 7: {
+          if (tag !== 58) {
+            break;
+          }
+          message.deviceType = reader.string();
+          continue;
+        }
+        case 8: {
+          if (tag !== 66) {
+            break;
+          }
+          message.userId = reader.string();
+          continue;
+        }
+        case 9: {
+          if (tag !== 74) {
+            break;
+          }
+          message.domain = reader.string();
+          continue;
+        }
+        case 10: {
+          if (tag !== 82) {
+            break;
+          }
+          const el = TraceEvent.decode(reader, reader.uint32());
+          if (el !== void 0) {
+            message.events.push(el);
+          }
+          continue;
+        }
+        case 11: {
+          if (tag !== 90) {
+            break;
+          }
+          message.browser = reader.string();
+          continue;
+        }
+        case 12: {
+          if (tag !== 98) {
+            break;
+          }
+          message.deviceManufacturer = reader.string();
+          continue;
+        }
+        case 13: {
+          if (tag !== 106) {
+            break;
+          }
+          message.deviceModel = reader.string();
+          continue;
+        }
+        case 14: {
+          if (tag !== 114) {
+            break;
+          }
+          message.city = reader.string();
+          continue;
+        }
+        case 15: {
+          if (tag !== 122) {
+            break;
+          }
+          message.postalCode = reader.string();
+          continue;
+        }
+      }
+      if ((tag & 7) === 4 || tag === 0) {
+        break;
+      }
+      reader.skip(tag & 7);
+    }
+    return message;
+  },
+  create(base) {
+    return TraceEventBatch.fromPartial(base ?? {});
+  },
+  fromPartial(object) {
+    const message = createBaseTraceEventBatch();
+    message.propertyId = object.propertyId ?? "";
+    message.pageviewId = object.pageviewId ?? "";
+    message.sessionId = object.sessionId ?? "";
+    message.pageUrl = object.pageUrl ?? "";
+    message.country = object.country ?? "";
+    message.region = object.region ?? "";
+    message.deviceType = object.deviceType ?? "";
+    message.userId = object.userId ?? "";
+    message.domain = object.domain ?? "";
+    message.events = object.events?.map((e) => TraceEvent.fromPartial(e)) || [];
+    message.browser = object.browser ?? "";
+    message.deviceManufacturer = object.deviceManufacturer ?? "";
+    message.deviceModel = object.deviceModel ?? "";
+    message.city = object.city ?? "";
+    message.postalCode = object.postalCode ?? "";
+    return message;
+  }
+};
+function createBaseTraceEvent() {
+  return {
+    timestampMs: 0,
+    type: 0,
+    eventName: "",
+    auctionId: "",
+    transactionId: "",
+    adUnitCode: "",
+    bid: void 0,
+    namespace: "",
+    eventId: "",
+    metadata: {},
+    viewableDurationMs: void 0
+  };
+}
+var TraceEvent = {
+  encode(message, writer = new import_wire.BinaryWriter()) {
+    if (message.timestampMs !== void 0 && message.timestampMs !== 0) {
+      writer.uint32(9).double(message.timestampMs);
+    }
+    if (message.type !== void 0 && message.type !== 0) {
+      writer.uint32(16).int32(message.type);
+    }
+    if (message.eventName !== void 0 && message.eventName !== "") {
+      writer.uint32(26).string(message.eventName);
+    }
+    if (message.auctionId !== void 0 && message.auctionId !== "") {
+      writer.uint32(34).string(message.auctionId);
+    }
+    if (message.transactionId !== void 0 && message.transactionId !== "") {
+      writer.uint32(42).string(message.transactionId);
+    }
+    if (message.adUnitCode !== void 0 && message.adUnitCode !== "") {
+      writer.uint32(50).string(message.adUnitCode);
+    }
+    if (message.bid !== void 0) {
+      BidTrace.encode(message.bid, writer.uint32(58).fork()).join();
+    }
+    if (message.namespace !== void 0 && message.namespace !== "") {
+      writer.uint32(66).string(message.namespace);
+    }
+    if (message.eventId !== void 0 && message.eventId !== "") {
+      writer.uint32(74).string(message.eventId);
+    }
+    globalThis.Object.entries(message.metadata || {}).forEach(([key, value]) => {
+      TraceEvent_MetadataEntry.encode({ key, value }, writer.uint32(82).fork()).join();
+    });
+    if (message.viewableDurationMs !== void 0) {
+      writer.uint32(89).double(message.viewableDurationMs);
+    }
+    return writer;
+  },
+  decode(input, length) {
+    const reader = input instanceof import_wire.BinaryReader ? input : new import_wire.BinaryReader(input);
+    const end = length === void 0 ? reader.len : reader.pos + length;
+    const message = createBaseTraceEvent();
+    while (reader.pos < end) {
+      const tag = reader.uint32();
+      switch (tag >>> 3) {
+        case 1: {
+          if (tag !== 9) {
+            break;
+          }
+          message.timestampMs = reader.double();
+          continue;
+        }
+        case 2: {
+          if (tag !== 16) {
+            break;
+          }
+          message.type = reader.int32();
+          continue;
+        }
+        case 3: {
+          if (tag !== 26) {
+            break;
+          }
+          message.eventName = reader.string();
+          continue;
+        }
+        case 4: {
+          if (tag !== 34) {
+            break;
+          }
+          message.auctionId = reader.string();
+          continue;
+        }
+        case 5: {
+          if (tag !== 42) {
+            break;
+          }
+          message.transactionId = reader.string();
+          continue;
+        }
+        case 6: {
+          if (tag !== 50) {
+            break;
+          }
+          message.adUnitCode = reader.string();
+          continue;
+        }
+        case 7: {
+          if (tag !== 58) {
+            break;
+          }
+          message.bid = BidTrace.decode(reader, reader.uint32());
+          continue;
+        }
+        case 8: {
+          if (tag !== 66) {
+            break;
+          }
+          message.namespace = reader.string();
+          continue;
+        }
+        case 9: {
+          if (tag !== 74) {
+            break;
+          }
+          message.eventId = reader.string();
+          continue;
+        }
+        case 10: {
+          if (tag !== 82) {
+            break;
+          }
+          const entry10 = TraceEvent_MetadataEntry.decode(reader, reader.uint32());
+          if (entry10.value !== void 0) {
+            message.metadata[entry10.key] = entry10.value;
+          }
+          continue;
+        }
+        case 11: {
+          if (tag !== 89) {
+            break;
+          }
+          message.viewableDurationMs = reader.double();
+          continue;
+        }
+      }
+      if ((tag & 7) === 4 || tag === 0) {
+        break;
+      }
+      reader.skip(tag & 7);
+    }
+    return message;
+  },
+  create(base) {
+    return TraceEvent.fromPartial(base ?? {});
+  },
+  fromPartial(object) {
+    const message = createBaseTraceEvent();
+    message.timestampMs = object.timestampMs ?? 0;
+    message.type = object.type ?? 0;
+    message.eventName = object.eventName ?? "";
+    message.auctionId = object.auctionId ?? "";
+    message.transactionId = object.transactionId ?? "";
+    message.adUnitCode = object.adUnitCode ?? "";
+    message.bid = object.bid !== void 0 && object.bid !== null ? BidTrace.fromPartial(object.bid) : void 0;
+    message.namespace = object.namespace ?? "";
+    message.eventId = object.eventId ?? "";
+    message.metadata = globalThis.Object.entries(object.metadata ?? {}).reduce(
+      (acc, [key, value]) => {
+        if (value !== void 0) {
+          acc[key] = globalThis.String(value);
+        }
+        return acc;
+      },
+      {}
+    );
+    message.viewableDurationMs = object.viewableDurationMs ?? void 0;
+    return message;
+  }
+};
+function createBaseTraceEvent_MetadataEntry() {
+  return { key: "", value: "" };
+}
+var TraceEvent_MetadataEntry = {
+  encode(message, writer = new import_wire.BinaryWriter()) {
+    if (message.key !== "") {
+      writer.uint32(10).string(message.key);
+    }
+    if (message.value !== "") {
+      writer.uint32(18).string(message.value);
+    }
+    return writer;
+  },
+  decode(input, length) {
+    const reader = input instanceof import_wire.BinaryReader ? input : new import_wire.BinaryReader(input);
+    const end = length === void 0 ? reader.len : reader.pos + length;
+    const message = createBaseTraceEvent_MetadataEntry();
+    while (reader.pos < end) {
+      const tag = reader.uint32();
+      switch (tag >>> 3) {
+        case 1: {
+          if (tag !== 10) {
+            break;
+          }
+          message.key = reader.string();
+          continue;
+        }
+        case 2: {
+          if (tag !== 18) {
+            break;
+          }
+          message.value = reader.string();
+          continue;
+        }
+      }
+      if ((tag & 7) === 4 || tag === 0) {
+        break;
+      }
+      reader.skip(tag & 7);
+    }
+    return message;
+  },
+  create(base) {
+    return TraceEvent_MetadataEntry.fromPartial(base ?? {});
+  },
+  fromPartial(object) {
+    const message = createBaseTraceEvent_MetadataEntry();
+    message.key = object.key ?? "";
+    message.value = object.value ?? "";
+    return message;
+  }
+};
+function createBaseBidTrace() {
+  return {
+    bidder: "",
+    cpm: 0,
+    currency: "",
+    width: 0,
+    height: 0,
+    dealId: "",
+    mediaType: "",
+    latencyMs: 0,
+    advertiserDomain: "",
+    creativeId: ""
+  };
+}
+var BidTrace = {
+  encode(message, writer = new import_wire.BinaryWriter()) {
+    if (message.bidder !== void 0 && message.bidder !== "") {
+      writer.uint32(10).string(message.bidder);
+    }
+    if (message.cpm !== void 0 && message.cpm !== 0) {
+      writer.uint32(17).double(message.cpm);
+    }
+    if (message.currency !== void 0 && message.currency !== "") {
+      writer.uint32(26).string(message.currency);
+    }
+    if (message.width !== void 0 && message.width !== 0) {
+      writer.uint32(32).int32(message.width);
+    }
+    if (message.height !== void 0 && message.height !== 0) {
+      writer.uint32(40).int32(message.height);
+    }
+    if (message.dealId !== void 0 && message.dealId !== "") {
+      writer.uint32(50).string(message.dealId);
+    }
+    if (message.mediaType !== void 0 && message.mediaType !== "") {
+      writer.uint32(58).string(message.mediaType);
+    }
+    if (message.latencyMs !== void 0 && message.latencyMs !== 0) {
+      writer.uint32(65).double(message.latencyMs);
+    }
+    if (message.advertiserDomain !== void 0 && message.advertiserDomain !== "") {
+      writer.uint32(74).string(message.advertiserDomain);
+    }
+    if (message.creativeId !== void 0 && message.creativeId !== "") {
+      writer.uint32(82).string(message.creativeId);
+    }
+    return writer;
+  },
+  decode(input, length) {
+    const reader = input instanceof import_wire.BinaryReader ? input : new import_wire.BinaryReader(input);
+    const end = length === void 0 ? reader.len : reader.pos + length;
+    const message = createBaseBidTrace();
+    while (reader.pos < end) {
+      const tag = reader.uint32();
+      switch (tag >>> 3) {
+        case 1: {
+          if (tag !== 10) {
+            break;
+          }
+          message.bidder = reader.string();
+          continue;
+        }
+        case 2: {
+          if (tag !== 17) {
+            break;
+          }
+          message.cpm = reader.double();
+          continue;
+        }
+        case 3: {
+          if (tag !== 26) {
+            break;
+          }
+          message.currency = reader.string();
+          continue;
+        }
+        case 4: {
+          if (tag !== 32) {
+            break;
+          }
+          message.width = reader.int32();
+          continue;
+        }
+        case 5: {
+          if (tag !== 40) {
+            break;
+          }
+          message.height = reader.int32();
+          continue;
+        }
+        case 6: {
+          if (tag !== 50) {
+            break;
+          }
+          message.dealId = reader.string();
+          continue;
+        }
+        case 7: {
+          if (tag !== 58) {
+            break;
+          }
+          message.mediaType = reader.string();
+          continue;
+        }
+        case 8: {
+          if (tag !== 65) {
+            break;
+          }
+          message.latencyMs = reader.double();
+          continue;
+        }
+        case 9: {
+          if (tag !== 74) {
+            break;
+          }
+          message.advertiserDomain = reader.string();
+          continue;
+        }
+        case 10: {
+          if (tag !== 82) {
+            break;
+          }
+          message.creativeId = reader.string();
+          continue;
+        }
+      }
+      if ((tag & 7) === 4 || tag === 0) {
+        break;
+      }
+      reader.skip(tag & 7);
+    }
+    return message;
+  },
+  create(base) {
+    return BidTrace.fromPartial(base ?? {});
+  },
+  fromPartial(object) {
+    const message = createBaseBidTrace();
+    message.bidder = object.bidder ?? "";
+    message.cpm = object.cpm ?? 0;
+    message.currency = object.currency ?? "";
+    message.width = object.width ?? 0;
+    message.height = object.height ?? 0;
+    message.dealId = object.dealId ?? "";
+    message.mediaType = object.mediaType ?? "";
+    message.latencyMs = object.latencyMs ?? 0;
+    message.advertiserDomain = object.advertiserDomain ?? "";
+    message.creativeId = object.creativeId ?? "";
+    return message;
+  }
+};
+
+// src/prebid-analytics.ts
+var BATCH_SIZE = 20;
+var FLUSH_INTERVAL_MS = 1e4;
+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 EVENT_NAME_TO_TYPE = {
+  auctionStart: TraceEventType.AUCTION_START,
+  auctionEnd: TraceEventType.AUCTION_END,
+  bidRequest: TraceEventType.BID_REQUEST,
+  bidResponse: TraceEventType.BID_RESPONSE,
+  bidTimeout: TraceEventType.BID_TIMEOUT,
+  bidWin: TraceEventType.BID_WIN,
+  noBid: TraceEventType.NO_BID,
+  adRenderFailed: TraceEventType.AD_RENDER_FAILED,
+  click: TraceEventType.CLICK,
+  impression: TraceEventType.IMPRESSION,
+  refresh: TraceEventType.REFRESH,
+  timeInView: TraceEventType.TIME_IN_VIEW,
+  viewable: TraceEventType.VIEWABLE
+};
+var SESSION_KEY = "_bidkernel_session";
+var SESSION_TS_KEY = "_bidkernel_session_ts";
+var THIRTY_MINUTES_MS = 30 * 60 * 1e3;
+var inMemorySessionId = null;
+var inMemorySessionTs = 0;
+function generateUUID() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    const v = c === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
+function extendSession() {
+  const now = Date.now();
+  inMemorySessionTs = now;
+  try {
+    if (typeof localStorage !== "undefined") {
+      localStorage.setItem(SESSION_TS_KEY, now.toString());
+    }
+  } catch {
+  }
+}
+function getOrCreateSessionId() {
+  const now = Date.now();
+  try {
+    if (typeof localStorage !== "undefined") {
+      const storedId = localStorage.getItem(SESSION_KEY);
+      const tsStr = localStorage.getItem(SESSION_TS_KEY);
+      const storedTs = tsStr ? parseInt(tsStr, 10) || 0 : 0;
+      if (storedId && storedTs && now - storedTs <= THIRTY_MINUTES_MS) {
+        localStorage.setItem(SESSION_TS_KEY, now.toString());
+        return storedId;
+      }
+      const newId = generateUUID();
+      localStorage.setItem(SESSION_KEY, newId);
+      localStorage.setItem(SESSION_TS_KEY, now.toString());
+      return newId;
+    }
+  } catch {
+  }
+  if (inMemorySessionId && inMemorySessionTs && now - inMemorySessionTs <= THIRTY_MINUTES_MS) {
+    inMemorySessionTs = now;
+    return inMemorySessionId;
+  }
+  inMemorySessionId = generateUUID();
+  inMemorySessionTs = now;
+  return inMemorySessionId;
+}
+function getPrebidEventKey(eventName, data) {
+  switch (eventName) {
+    case "auctionInit":
+      return `auctionInit:${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 ?? ""}`;
+    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 || ""}`;
+    case "setTargeting":
+      return `setTargeting:${Object.keys(data || {}).sort().join(",")}`;
+    case "auctionDebug":
+      return `auctionDebug:${data?.type || ""}:${String(data?.arguments?.[0] ?? "").slice(0, 50)}`;
+    default:
+      return "";
+  }
+}
+var PrebidEventDeduper = class {
+  seenObjects = /* @__PURE__ */ new WeakSet();
+  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 key = getPrebidEventKey(eventName, data);
+    if (key) {
+      if (this.seenKeys.has(key)) return true;
+      if (this.seenKeys.size >= 1e3) {
+        const first = this.seenKeys.values().next().value;
+        if (first !== void 0) this.seenKeys.delete(first);
+      }
+      this.seenKeys.add(key);
+    }
+    return false;
+  }
+};
+function parseSize(raw) {
+  if (!raw) return { width: 0, height: 0 };
+  let cur = raw;
+  while (Array.isArray(cur) && cur.length > 0 && Array.isArray(cur[0])) {
+    cur = cur[0];
+  }
+  if (Array.isArray(cur) && cur.length >= 2) {
+    const w = Number(cur[0]);
+    const h = Number(cur[1]);
+    return {
+      width: Number.isFinite(w) ? w : 0,
+      height: Number.isFinite(h) ? h : 0
+    };
+  }
+  return { width: 0, height: 0 };
+}
+var BidkernelPrebidAnalytics = class {
+  config;
+  queue = [];
+  errorCount = 0;
+  flushTimer = null;
+  boundFlushBeacon;
+  boundVisibilityChange;
+  isEnabled = false;
+  boundPbjsHandlers = [];
+  // Captured at enable()/navigate() so events queued before an SPA route
+  // change flush with the page they occurred on, not the new URL.
+  pageUrl = "";
+  deduper = new PrebidEventDeduper();
+  consecutiveSendFailures = 0;
+  nextSendAllowedAt = 0;
+  constructor(config) {
+    this.config = {
+      endpoint: config.endpoint || "",
+      propertyId: config.propertyId || "",
+      pageviewId: config.pageviewId || generateUUID(),
+      sessionId: config.sessionId || getOrCreateSessionId(),
+      userId: config.userId || "",
+      deviceType: config.deviceType || "desktop",
+      country: config.country || "",
+      region: config.region || "",
+      auctionEnabled: config.auctionEnabled ?? true,
+      warningsEnabled: config.warningsEnabled ?? true,
+      errorsEnabled: config.errorsEnabled ?? true,
+      logLevel: config.logLevel || "INFO",
+      pbjsGlobalName: config.pbjsGlobalName || "pbjs",
+      attachPbjsListeners: config.attachPbjsListeners ?? true
+    };
+    this.boundFlushBeacon = () => this.flushBeacon();
+    this.boundVisibilityChange = () => this.handleVisibilityChange();
+  }
+  enable() {
+    if (this.isEnabled) return;
+    this.isEnabled = true;
+    if (!this.config.endpoint) {
+      this.log("WARN", "Endpoint is empty. Analytics events will not be transmitted.");
+    }
+    if (this.config.attachPbjsListeners) {
+      const win = typeof window !== "undefined" ? window : {};
+      const pbjs = win[this.config.pbjsGlobalName] || {};
+      if (typeof pbjs.onEvent === "function") {
+        this.log("DEBUG", "Attaching event listeners to pbjs");
+        const events = [
+          ["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)]
+        ];
+        for (const [name, fn] of events) {
+          pbjs.onEvent(name, fn);
+          this.boundPbjsHandlers.push({ event: name, handler: fn });
+        }
+      } else {
+        this.log("WARN", "pbjs.onEvent is not defined. Prebid analytics will not function.");
+      }
+      if (typeof pbjs.getEvents === "function") {
+        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)
+            };
+            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);
+              }
+            }
+          }
+        } catch (e) {
+          this.log("WARN", "Failed to replay historical events from pbjs.getEvents()", e);
+        }
+      }
+    }
+    if (typeof window !== "undefined") {
+      if (!this.pageUrl) {
+        try {
+          const u = new URL(window.location.href);
+          this.pageUrl = u.origin + u.pathname;
+        } catch {
+          this.pageUrl = window.location.href;
+        }
+      }
+      window.addEventListener("pagehide", this.boundFlushBeacon);
+      if (typeof document !== "undefined") {
+        document.addEventListener("visibilitychange", this.boundVisibilityChange);
+      }
+      this.flushTimer = setInterval(() => this.flush(), FLUSH_INTERVAL_MS);
+    }
+  }
+  disable() {
+    if (!this.isEnabled) return;
+    this.isEnabled = false;
+    if (this.flushTimer) {
+      clearInterval(this.flushTimer);
+      this.flushTimer = null;
+    }
+    if (typeof window !== "undefined") {
+      window.removeEventListener("pagehide", this.boundFlushBeacon);
+      if (typeof document !== "undefined") {
+        document.removeEventListener("visibilitychange", this.boundVisibilityChange);
+      }
+    }
+    if (this.boundPbjsHandlers.length > 0) {
+      const win = typeof window !== "undefined" ? window : {};
+      const pbjs = win[this.config.pbjsGlobalName] || {};
+      if (typeof pbjs.offEvent === "function") {
+        for (const { event, handler } of this.boundPbjsHandlers) {
+          pbjs.offEvent(event, handler);
+        }
+      }
+      this.boundPbjsHandlers = [];
+    }
+    this.flush();
+  }
+  handleVisibilityChange() {
+    if (typeof document !== "undefined" && document.visibilityState === "hidden") {
+      this.flushBeacon();
+    }
+  }
+  trackRawEvent(level, eventName, data) {
+    const eventType = EVENT_NAME_TO_TYPE[eventName] ?? (level === "ERROR" ? TraceEventType.ERROR : TraceEventType.TRACE_EVENT_TYPE_UNSPECIFIED);
+    this.enqueue(eventType, eventName, data, level);
+  }
+  setUserId(userId) {
+    this.config.userId = userId;
+  }
+  setSessionId(sessionId) {
+    this.config.sessionId = sessionId;
+  }
+  navigate(pageviewId, pageUrl) {
+    this.disable();
+    this.config.pageviewId = pageviewId || generateUUID();
+    if (pageUrl) {
+      try {
+        const u = new URL(pageUrl);
+        this.pageUrl = u.origin + u.pathname;
+      } catch {
+        this.pageUrl = pageUrl;
+      }
+    } else {
+      this.pageUrl = "";
+    }
+    extendSession();
+    this.enable();
+  }
+  handleAuctionInit(data) {
+    if (this.isDuplicate("auctionInit", data)) return;
+    this.log("DEBUG", "auctionInit", data);
+    this.enqueue(TraceEventType.AUCTION_START, "auctionStart", {
+      auctionId: data.auctionId || ""
+    });
+  }
+  handleAuctionEnd(data) {
+    if (this.isDuplicate("auctionEnd", data)) return;
+    this.log("DEBUG", "auctionEnd", data);
+    this.enqueue(TraceEventType.AUCTION_END, "auctionEnd", {
+      auctionId: data.auctionId || ""
+    });
+  }
+  handleBidRequested(data) {
+    if (this.isDuplicate("bidRequested", data)) return;
+    this.log("DEBUG", "bidRequested", data);
+    const auctionId = data.auctionId || "";
+    const bidder = data.bidderCode || "";
+    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 || "";
+        if (mediaTypes.length === 0) {
+          const mediaType = bid.mediaType || "banner";
+          const { width, height } = parseSize(bid.sizes || bid.playerSize);
+          this.enqueue(TraceEventType.BID_REQUEST, "bidRequest", {
+            auctionId,
+            adUnitCode: bid.adUnitCode || "",
+            gpid,
+            bid: {
+              bidder,
+              mediaType,
+              width,
+              height
+            }
+          });
+          return;
+        }
+        mediaTypes.forEach((mediaType) => {
+          let rawSize = null;
+          if (mediaType === "banner") {
+            rawSize = bid.mediaTypes?.banner?.sizes || bid.sizes;
+          } else if (mediaType === "video") {
+            rawSize = bid.mediaTypes?.video?.playerSize || bid.mediaTypes?.video?.sizes || bid.playerSize;
+          } else {
+            rawSize = bid.mediaTypes?.[mediaType]?.sizes;
+          }
+          const { width, height } = parseSize(rawSize);
+          this.enqueue(TraceEventType.BID_REQUEST, "bidRequest", {
+            auctionId,
+            adUnitCode: bid.adUnitCode || "",
+            gpid,
+            bid: {
+              bidder,
+              mediaType,
+              width,
+              height
+            }
+          });
+        });
+      });
+    }
+  }
+  handleBidResponse(data) {
+    if (this.isDuplicate("bidResponse", data)) return;
+    this.log("DEBUG", "bidResponse", data);
+    this.enqueue(TraceEventType.BID_RESPONSE, "bidResponse", {
+      auctionId: data.auctionId || "",
+      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,
+        dealId: data.dealId || "",
+        mediaType: data.mediaType || "banner",
+        latencyMs: Number.isFinite(data.timeToRespond) ? data.timeToRespond : 0,
+        advertiserDomain: data.meta?.advertiserDomains?.[0] || "",
+        creativeId: data.creativeId || ""
+      }
+    });
+  }
+  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 || ""
+          }
+        });
+      });
+    }
+  }
+  handleBidWon(data) {
+    if (this.isDuplicate("bidWon", data)) return;
+    this.log("DEBUG", "bidWon", data);
+    this.enqueue(TraceEventType.BID_WIN, "bidWon", {
+      auctionId: data.auctionId || "",
+      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,
+        dealId: data.dealId || "",
+        mediaType: data.mediaType || "banner",
+        latencyMs: Number.isFinite(data.timeToRespond) ? data.timeToRespond : 0,
+        advertiserDomain: data.meta?.advertiserDomains?.[0] || "",
+        creativeId: data.creativeId || ""
+      }
+    });
+  }
+  handleNoBid(data) {
+    if (this.isDuplicate("noBid", data)) return;
+    this.log("DEBUG", "noBid", data);
+    this.enqueue(TraceEventType.NO_BID, "noBid", {
+      auctionId: data.auctionId || "",
+      adUnitCode: data.adUnitCode || "",
+      bid: {
+        bidder: data.bidderCode || data.bidder || ""
+      }
+    });
+  }
+  handleAdRenderFailed(data) {
+    if (this.isDuplicate("adRenderFailed", data)) return;
+    this.log("DEBUG", "adRenderFailed", data);
+    this.enqueue(TraceEventType.AD_RENDER_FAILED, "adRenderFailed", {
+      auctionId: data.bid?.auctionId || "",
+      adUnitCode: data.bid?.adUnitCode || "",
+      bid: {
+        bidder: data.bid?.bidderCode || data.bid?.bidder || ""
+      },
+      metadata: {
+        reason: String(data.reason || ""),
+        message: String(data.message || "")
+      }
+    });
+  }
+  isDuplicate(eventName, data) {
+    return this.deduper.isDuplicate(eventName, data);
+  }
+  enqueue(type, eventName, data, level) {
+    if (!this.isEnabled) return;
+    if (!this.shouldSample(type, level)) return;
+    const protoEvent = {
+      eventId: generateUUID(),
+      timestampMs: Date.now(),
+      type,
+      eventName,
+      auctionId: data.auctionId || "",
+      transactionId: data.transactionId || "",
+      adUnitCode: data.adUnitCode || data.elementId || "",
+      namespace: data.ns || data.namespace || ""
+    };
+    if (data.bid) {
+      protoEvent.bid = {
+        bidder: data.bid.bidder || "",
+        cpm: Number.isFinite(data.bid.cpm) ? data.bid.cpm : 0,
+        currency: data.bid.currency || "USD",
+        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",
+        latencyMs: Number.isFinite(data.bid.latencyMs) ? data.bid.latencyMs : 0,
+        advertiserDomain: data.bid.advertiserDomain || "",
+        creativeId: data.bid.creativeId || ""
+      };
+    }
+    if (data.viewableDurationMs !== void 0) {
+      protoEvent.viewableDurationMs = Number.isFinite(data.viewableDurationMs) ? data.viewableDurationMs : 0;
+    }
+    const metadata = { ...data.metadata };
+    if (data.error !== void 0 && data.error !== null) {
+      metadata.error = typeof data.error === "object" && data.error.message ? String(data.error.message) : String(data.error);
+    }
+    if (data.gpid) {
+      metadata.gpid = String(data.gpid);
+    }
+    if (Object.keys(metadata).length > 0) {
+      protoEvent.metadata = metadata;
+    }
+    this.queue.push(protoEvent);
+    if (this.queue.length > MAX_QUEUE_SIZE) {
+      this.queue.splice(0, this.queue.length - MAX_QUEUE_SIZE);
+    }
+    if (this.queue.length >= BATCH_SIZE) {
+      this.flush();
+    }
+  }
+  shouldSample(type, level) {
+    if (type === TraceEventType.ERROR) {
+      this.errorCount++;
+      if (this.errorCount > MAX_ERRORS_PER_SESSION) return false;
+      return this.config.errorsEnabled;
+    }
+    if (level === "WARN") {
+      return this.config.warningsEnabled;
+    }
+    return this.config.auctionEnabled;
+  }
+  requeue(events) {
+    if (!events.length) return;
+    this.queue = events.concat(this.queue);
+    if (this.queue.length > MAX_QUEUE_SIZE) {
+      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().
+  drainBatch() {
+    if (this.queue.length === 0 || !this.config.endpoint) return null;
+    const events = this.queue;
+    this.queue = [];
+    const domain = typeof window !== "undefined" ? window.location.hostname : "";
+    const batch = {
+      propertyId: this.config.propertyId,
+      pageviewId: this.config.pageviewId,
+      sessionId: this.config.sessionId,
+      pageUrl: this.pageUrl,
+      country: this.config.country,
+      region: this.config.region,
+      deviceType: this.config.deviceType,
+      userId: this.config.userId,
+      domain,
+      events
+    };
+    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(),
+      events
+    };
+  }
+  sendFetch(payload) {
+    fetch(payload.url, {
+      method: "POST",
+      headers: { "Content-Type": "application/x-protobuf" },
+      body: payload.encoded,
+      keepalive: true
+    }).then((res) => {
+      if (!res.ok) {
+        this.log("WARN", `Failed to send batch: HTTP ${res.status}`);
+        this.handleSendFailure(payload.events);
+      } else {
+        this.consecutiveSendFailures = 0;
+        this.nextSendAllowedAt = 0;
+      }
+    }).catch((err) => {
+      this.log("ERROR", "Failed to send batch", err);
+      this.handleSendFailure(payload.events);
+    });
+  }
+  handleSendFailure(events) {
+    this.consecutiveSendFailures++;
+    const backoff = Math.min(
+      FLUSH_INTERVAL_MS * 2 ** (this.consecutiveSendFailures - 1),
+      MAX_SEND_BACKOFF_MS
+    );
+    this.nextSendAllowedAt = Date.now() + backoff;
+    if (this.consecutiveSendFailures <= MAX_CONSECUTIVE_SEND_FAILURES) {
+      this.requeue(events);
+    } else {
+      this.log(
+        "WARN",
+        `Dropping ${events.length} events after ${this.consecutiveSendFailures} consecutive send failures`
+      );
+    }
+  }
+  flush() {
+    if (Date.now() < this.nextSendAllowedAt) return;
+    const payload = this.drainBatch();
+    if (!payload) return;
+    this.sendFetch(payload);
+  }
+  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;
+      }
+    }
+    if (!sent) {
+      this.sendFetch(payload);
+    }
+  }
+  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;
+    }
+  }
+};
+function extractAnalyticsOptions(config) {
+  if (!config) return null;
+  if (Array.isArray(config)) {
+    const matched = config.find((item) => item?.provider === "bidkernel") ?? config.find((item) => item && typeof item === "object" && item.provider === void 0);
+    return matched ? extractAnalyticsOptions(matched) : null;
+  }
+  if (typeof config === "object") {
+    if (config.options && typeof config.options === "object") {
+      return config.options;
+    }
+    if (config.config && typeof config.config === "object") {
+      return config.config;
+    }
+    if (config.propertyId || config.endpoint) {
+      return config;
+    }
+  }
+  return null;
+}
+function getStashedConfig(win) {
+  if (!win) return null;
+  if (win._bidkernelAnalyticsConfig) {
+    const extracted = extractAnalyticsOptions(win._bidkernelAnalyticsConfig);
+    if (extracted) return extracted;
+  }
+  if (win.bidkernelPrebidAnalytics) {
+    const bpa = win.bidkernelPrebidAnalytics;
+    if (bpa.options) {
+      const extracted = extractAnalyticsOptions(bpa.options);
+      if (extracted) return extracted;
+    }
+    if (bpa.config) {
+      const extracted = extractAnalyticsOptions(bpa.config);
+      if (extracted) return extracted;
+    }
+    if (bpa.propertyId) {
+      return extractAnalyticsOptions(bpa);
+    }
+  }
+  return null;
+}
+function registerPrebidAnalytics(pbjsGlobalName = "pbjs", defaults) {
+  const win = typeof window !== "undefined" ? window : {};
+  win[pbjsGlobalName] = win[pbjsGlobalName] || {};
+  const pbjs = win[pbjsGlobalName];
+  const enableInstance = (options) => {
+    if (win._bidkernelPrebidAnalytics) {
+      try {
+        win._bidkernelPrebidAnalytics.disable();
+      } catch (e) {
+        console.warn("[bidkernel] Failed to disable previous analytics instance:", e);
+      }
+    }
+    const analytics = new BidkernelPrebidAnalytics({
+      pbjsGlobalName,
+      ...defaults,
+      ...options
+    });
+    analytics.enable();
+    win._bidkernelPrebidAnalytics = analytics;
+    return analytics;
+  };
+  const doRegister = () => {
+    try {
+      if (pbjs.adapterManager && typeof pbjs.adapterManager.registerAnalyticsAdapter === "function") {
+        pbjs.adapterManager.registerAnalyticsAdapter({
+          adapter: {
+            enableAnalytics: (config) => {
+              const options = extractAnalyticsOptions(config);
+              if (options) {
+                enableInstance(options);
+              }
+            },
+            disableAnalytics: () => {
+              if (win._bidkernelPrebidAnalytics) {
+                win._bidkernelPrebidAnalytics.disable();
+              }
+            }
+          },
+          code: "bidkernel"
+        });
+      }
+      const stashed = getStashedConfig(win);
+      if (stashed && (stashed.propertyId || defaults?.propertyId)) {
+        enableInstance(stashed);
+      }
+    } catch (e) {
+      console.warn("[bidkernel] Failed to register standard Prebid analytics adapter:", e);
+    }
+  };
+  if (pbjs.adapterManager && typeof pbjs.adapterManager.registerAnalyticsAdapter === "function") {
+    doRegister();
+  } else {
+    pbjs.que = pbjs.que || [];
+    pbjs.que.push(doRegister);
+  }
+}
+
+// src/index.ts
+function getbidkernel(alias = "bidkernel") {
+  if (typeof window === "undefined") {
+    return { q: [] };
+  }
+  const win = window;
+  win[alias] = win[alias] || { q: [] };
+  return win[alias];
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BidkernelPrebidAnalytics,
+  PrebidEventDeduper,
+  getPrebidEventKey,
+  getbidkernel,
+  registerPrebidAnalytics
+});