@optable/web-sdk 0.45.0 → 0.49.0

package/lib/dist/addons/prebid/analytics.js

@@ -0,0 +1,478 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import * as Bowser from "bowser";
+const STATUS = {
+    REQUESTED: "REQUESTED",
+    RECEIVED: "RECEIVED",
+    NO_BID: "NO_BID",
+    TIMEOUT: "TIMEOUT",
+};
+const SESSION_SAMPLE_KEY = "optable:prebid:analytics:sample-number";
+class OptablePrebidAnalytics {
+    /**
+     * Create a new OptablePrebidAnalytics instance.
+     * @param optableInstance - An initialized Optable SDK instance that exposes a `witness()` method.
+     * @param config - Optional configuration for sampling, debug and analytics behavior.
+     */
+    constructor(optableInstance, config = { samplingRate: 1, samplingVolume: "event", bidWinTimeout: 10000 }) {
+        var _a, _b, _c, _d;
+        this.optableInstance = optableInstance;
+        this.config = config;
+        this.isInitialized = false;
+        this.labelStyle = "color: white; background-color: #9198dc; padding: 2px 4px; border-radius: 2px;";
+        this.maxAuctionDataSize = 50;
+        this.auctions = new Map();
+        if (!optableInstance || typeof optableInstance.witness !== "function") {
+            throw new Error("OptablePrebidAnalytics requires a valid optable instance with witness() method");
+        }
+        this.config.debug = (_a = config.debug) !== null && _a !== void 0 ? _a : false;
+        this.config.bidWinTimeout = (_b = config.bidWinTimeout) !== null && _b !== void 0 ? _b : 10000;
+        this.config.samplingRate = (_c = config.samplingRate) !== null && _c !== void 0 ? _c : 1;
+        this.config.samplingVolume = (_d = config.samplingVolume) !== null && _d !== void 0 ? _d : "event";
+        if (this.config.samplingVolume === "session") {
+            sessionStorage.setItem(SESSION_SAMPLE_KEY, Math.random().toFixed(2));
+        }
+        else {
+            sessionStorage.removeItem(SESSION_SAMPLE_KEY);
+        }
+        sessionStorage.optableSessionDepth = (Number(sessionStorage === null || sessionStorage === void 0 ? void 0 : sessionStorage.optableSessionDepth) || 0) + 1;
+        this.isInitialized = true;
+        // Store auction data
+        this.maxAuctionDataSize = 50;
+        this.log("OptablePrebidAnalytics initialized");
+    }
+    /**
+     * Log messages to the console when debugging is enabled.
+     * @param args - Values to log.
+     * @returns void
+     */
+    log(...args) {
+        if (this.config.debug) {
+            console.log("%cOptable%c [OptablePrebidAnalytics]", this.labelStyle, "color: inherit;", ...args);
+        }
+    }
+    /**
+     * Determine whether the current event/session should be sampled according to
+     * the configured sampling rate, seed or function.
+     * @returns true if the event should be sampled and analytics calls may proceed.
+     */
+    shouldSample() {
+        if (this.config.samplingRate <= 0)
+            return false;
+        if (this.config.samplingRate >= 1)
+            return true;
+        if (this.config.samplingRateFn) {
+            return this.config.samplingRateFn();
+        }
+        if (this.config.samplingVolume === "session") {
+            const samplingNumber = Number(sessionStorage.getItem(SESSION_SAMPLE_KEY) || "1");
+            return samplingNumber < this.config.samplingRate;
+        }
+        // Optional: deterministic sampling by seed (e.g., user ID)
+        if (this.config.samplingSeed) {
+            const hash = [...this.config.samplingSeed].reduce((acc, c) => acc + c.charCodeAt(0), 0);
+            const normalized = (hash % 10000) / 10000;
+            return normalized < this.config.samplingRate;
+        }
+        // Random sampling
+        return Math.random() < this.config.samplingRate;
+    }
+    /**
+     * Send an event to the Witness API when analytics are enabled and sampling passes.
+     * @param eventName - The name of the event to send (e.g. "optable.prebid.auction").
+     * @param properties - An object of event properties to include in the payload.
+     * @returns A small result object indicating whether the call was disabled or sent.
+     */
+    sendToWitnessAPI(eventName_1) {
+        return __awaiter(this, arguments, void 0, function* (eventName, properties = {}) {
+            if (!this.config.analytics) {
+                this.log("Witness API calls disabled - would send:", eventName, properties);
+                return { disabled: true, eventName, properties };
+            }
+            if (!this.shouldSample()) {
+                this.log("Event not sampled - skipping Witness API call for:", eventName, properties);
+                return { disabled: true, eventName, properties };
+            }
+            try {
+                yield this.optableInstance.witness(eventName, properties);
+                this.log("Sending to Witness API:", eventName, properties);
+            }
+            catch (error) {
+                this.log("Error sending to Witness API:", eventName, properties, error);
+                throw error;
+            }
+            return { disabled: false, eventName, properties };
+        });
+    }
+    /**
+     * Attach listeners to a Prebid.js instance and process any missed events.
+     * This will replay past `auctionEnd` and `bidWon` events and then register live handlers.
+     * @param pbjs - The Prebid.js global instance (or equivalent) to hook into.
+     * @returns void
+     */
+    setHooks(pbjs) {
+        this.log("Processing missed auctionEnd");
+        pbjs.getEvents().forEach((event) => {
+            if (event.eventType === "auctionEnd") {
+                this.log("auction missed");
+                this.trackAuctionEnd(event.args, true);
+            }
+            if (event.eventType === "bidWon") {
+                this.log("bid won missed");
+                this.trackBidWon(event.args, true);
+            }
+        });
+        this.log("Hooking into Prebid.js events");
+        pbjs.onEvent("auctionEnd", (event) => {
+            this.log("auctionEnd event received");
+            this.trackAuctionEnd(event);
+        });
+        pbjs.onEvent("bidWon", (event) => {
+            this.log("bidWon event received");
+            this.trackBidWon(event);
+        });
+    }
+    /**
+     * Hook into Prebid.js by attaching event hooks either immediately or by
+     * queueing callbacks when `pbjs.onEvent` is not available yet.
+     * @param prebidInstance - Optional Prebid.js instance to use (defaults to `window.pbjs`).
+     * @returns true when a hook has been registered, false when Prebid is not present.
+     */
+    hookIntoPrebid(prebidInstance = window.pbjs) {
+        const pbjs = prebidInstance;
+        this.prebidInstance = pbjs;
+        if (typeof pbjs === "undefined") {
+            this.log("Prebid.js not found");
+            return false;
+        }
+        if (typeof pbjs.onEvent !== "function") {
+            pbjs.que = pbjs.que || [];
+            pbjs.que.push(() => this.setHooks(pbjs));
+        }
+        else {
+            this.setHooks(pbjs);
+        }
+        return true;
+    }
+    /**
+     * Process a Prebid `auctionEnd` event: build an internal representation of
+     * requests, merge in received bids and schedule a delayed Witness API call
+     * (to allow `bidWon` to be received) or mark as missed.
+     * @param event - The raw Prebid auctionEnd event object.
+     * @param missed - True when the event was previously emitted (missed replay).
+     * @returns void
+     */
+    trackAuctionEnd(event_1) {
+        return __awaiter(this, arguments, void 0, function* (event, missed = false) {
+            const { auctionId, timeout, bidderRequests = [], bidsReceived = [], noBids = [], timeoutBids = [] } = event;
+            this.log(`Processing auction ${auctionId} with ${bidderRequests.length} bidder requests`);
+            window.optable = window.optable || {};
+            window.optable.pageAuctionsCount = (Number(window.optable.pageAuctionsCount) || 0) + 1;
+            // Build auction object with bidder requests and EID flags
+            const auction = {
+                auctionId,
+                timeout,
+                bidderRequests: bidderRequests.map((br) => {
+                    var _a, _b, _c, _d, _e, _f, _g;
+                    const { bidderCode, bidderRequestId, bids = [] } = br;
+                    const domain = (_b = (_a = br.ortb2.site) === null || _a === void 0 ? void 0 : _a.domain) !== null && _b !== void 0 ? _b : "unknown";
+                    const allEids = [...((_e = (_d = (_c = br.ortb2.user) === null || _c === void 0 ? void 0 : _c.ext) === null || _d === void 0 ? void 0 : _d.eids) !== null && _e !== void 0 ? _e : []), ...((_g = (_f = br.ortb2.user) === null || _f === void 0 ? void 0 : _f.eids) !== null && _g !== void 0 ? _g : [])];
+                    // Deduplicate EIDs by source
+                    const eids = Array.from(new Map(allEids.map((eid) => [eid.source, eid])).values());
+                    // Optable EIDs
+                    const optableEIDS = eids.filter((e) => e.inserter === "optable.co");
+                    const optableMatchers = [...new Set(optableEIDS.map((e) => e.matcher).filter(Boolean))];
+                    const optableSources = [...new Set(optableEIDS.map((e) => e.source).filter(Boolean))];
+                    return {
+                        bidderCode,
+                        bidderRequestId,
+                        domain,
+                        hasOEids: optableEIDS.length > 0,
+                        optableMatchers,
+                        optableSources,
+                        status: STATUS.REQUESTED,
+                        bids: bids.map((b) => {
+                            var _a, _b, _c, _d;
+                            return ({
+                                bidId: b.bidId,
+                                bidderRequestId,
+                                adUnitCode: b.adUnitCode,
+                                adUnitId: b.adUnitId,
+                                transactionId: b.transactionId,
+                                src: b.src,
+                                floorMin: (_a = b.floorData) === null || _a === void 0 ? void 0 : _a.floorMin,
+                                splitTestAssignment: (_d = (_c = (_b = b.ortb2Imp) === null || _b === void 0 ? void 0 : _b.ext) === null || _c === void 0 ? void 0 : _c.optable) === null || _d === void 0 ? void 0 : _d.splitTestAssignment,
+                                status: STATUS.REQUESTED,
+                            });
+                        }),
+                    };
+                }),
+            };
+            // Build lookup tables for 1:many relationship
+            const requestIndex = {};
+            const bidIndex = {};
+            const bidToRequest = {};
+            auction.bidderRequests.forEach((br) => {
+                requestIndex[br.bidderRequestId] = br;
+                br.bids.forEach((bid) => {
+                    bidIndex[bid.bidId] = bid;
+                    bidToRequest[bid.bidId] = br;
+                });
+            });
+            // Merge in bidsReceived → update individual bids as RECEIVED
+            bidsReceived.forEach((b) => {
+                var _a, _b, _c, _d, _e, _f;
+                const bidId = b.requestId;
+                const br = bidToRequest[bidId];
+                if (!br) {
+                    this.log(`No bidderRequest found for bidId=${bidId}`);
+                    return;
+                }
+                // Find the specific bid to update
+                let bidObj = bidIndex[bidId];
+                if (bidObj) {
+                    // Update existing bid
+                    Object.assign(bidObj, {
+                        status: STATUS.RECEIVED,
+                        cpm: b.cpm,
+                        size: `${b.width}x${b.height}`,
+                        currency: b.currency,
+                        splitTestAssignment: (_c = (_b = (_a = b.ortb2Imp) === null || _a === void 0 ? void 0 : _a.ext) === null || _b === void 0 ? void 0 : _b.optable) === null || _c === void 0 ? void 0 : _c.splitTestAssignment,
+                    });
+                }
+                else {
+                    // Create new bid object for this response
+                    bidObj = {
+                        bidId,
+                        bidderRequestId: br.bidderRequestId,
+                        adUnitCode: b.adUnitCode,
+                        adUnitId: b.adUnitId,
+                        transactionId: b.transactionId,
+                        src: b.src,
+                        cpm: b.cpm,
+                        size: `${b.width}x${b.height}`,
+                        currency: b.currency,
+                        status: STATUS.RECEIVED,
+                        splitTestAssignment: (_f = (_e = (_d = b.ortb2Imp) === null || _d === void 0 ? void 0 : _d.ext) === null || _e === void 0 ? void 0 : _e.optable) === null || _f === void 0 ? void 0 : _f.splitTestAssignment,
+                    };
+                    br.bids.push(bidObj);
+                    bidIndex[bidId] = bidObj;
+                    bidToRequest[bidId] = br;
+                }
+                // Update bidder request status to RECEIVED if any bid was received
+                if (br.status === STATUS.REQUESTED) {
+                    br.status = STATUS.RECEIVED;
+                }
+            });
+            // Handle noBids → mark the entire request as NO_BID
+            noBids.forEach((nb) => {
+                const br = requestIndex[nb.bidderRequestId];
+                if (!br)
+                    return;
+                br.status = STATUS.NO_BID;
+                // Mark all bids in this request as NO_BID
+                br.bids.forEach((bid) => {
+                    bid.status = STATUS.NO_BID;
+                });
+            });
+            // Handle timeoutBids → mark the entire request as TIMEOUT
+            timeoutBids.forEach((tb) => {
+                const br = requestIndex[tb.bidderRequestId];
+                if (!br)
+                    return;
+                br.status = STATUS.TIMEOUT;
+                // Mark all bids in this request as TIMEOUT
+                br.bids.forEach((bid) => {
+                    bid.status = STATUS.TIMEOUT;
+                });
+            });
+            const createdAt = new Date();
+            const auctionEndTimeoutId = setTimeout(() => __awaiter(this, void 0, void 0, function* () {
+                const payload = yield this.toWitness(event, null, missed);
+                payload["auctionEndAt"] = createdAt.toISOString();
+                payload["bidWonAt"] = null;
+                payload["optableLoaded"] = !missed;
+                this.sendToWitnessAPI("optable.prebid.auction", payload);
+            }), this.config.bidWinTimeout);
+            // Store the auction data
+            this.auctions.set(auctionId, { auctionEnd: event, createdAt, missed, auctionEndTimeoutId });
+            // Clean up old auctions
+            this.cleanupOldAuctions();
+        });
+    }
+    /**
+     * Handle a Prebid `bidWon` event by finalizing the matching auction, clearing
+     * the pending timeout and sending the combined payload to Witness.
+     * @param event - The raw Prebid bidWon event object.
+     * @param missed - True when the event was previously emitted (missed replay).
+     * @returns void
+     */
+    trackBidWon(event_1) {
+        return __awaiter(this, arguments, void 0, function* (event, missed = false) {
+            const filteredEvent = {
+                auctionId: event.auctionId,
+                bidderCode: event.bidderCode,
+                bidId: event.requestId,
+                tenant: this.config.tenant,
+                missed,
+            };
+            this.log("bidWon filtered event", filteredEvent);
+            const auction = this.auctions.get(event.auctionId);
+            if (!auction) {
+                this.log("Missing 'auctionEnd' event. Skipping.");
+                return;
+            }
+            if (auction.auctionEndTimeoutId) {
+                clearTimeout(auction.auctionEndTimeoutId);
+            }
+            const payload = yield this.toWitness(auction.auctionEnd, event, missed);
+            payload["auctionEndAt"] = auction.createdAt.toISOString();
+            payload["bidWonAt"] = new Date().toISOString();
+            payload["optableLoaded"] = !missed;
+            this.sendToWitnessAPI("optable.prebid.auction", payload);
+            this.auctions.delete(event.auctionId);
+        });
+    }
+    /**
+     * Clean up old auctions to prevent memory leaks.
+     * Removes the oldest auction when the internal store grows past the configured size.
+     * @returns void
+     */
+    cleanupOldAuctions() {
+        const auctionIds = [...this.auctions.keys()];
+        if (auctionIds.length > this.maxAuctionDataSize) {
+            const oldestAuctionId = auctionIds[0];
+            this.auctions.delete(oldestAuctionId);
+            this.log(`Cleaned up old auction: ${oldestAuctionId}`);
+        }
+    }
+    /**
+     * Clear all stored analytics data (useful for tests).
+     * @returns void
+     */
+    clearData() {
+        this.auctions.clear();
+        this.log("All analytics data cleared");
+    }
+    /**
+     * Convert internal auction state and optional bidWon event into a Witness payload.
+     * This collects matcher/source metadata, bid counts and optional custom analytics.
+     * @param auctionEndEvent - The `auctionEnd` event object from Prebid.js.
+     * @param bidWonEvent - Optional `bidWon` event when a winning bid exists.
+     * @param missed - True when the original events were already emitted (replayed).
+     * @returns A payload object compatible with the Witness API.
+     */
+    toWitness(auctionEndEvent_1, bidWonEvent_1) {
+        return __awaiter(this, arguments, void 0, function* (auctionEndEvent, bidWonEvent, missed = false) {
+            var _a, _b, _c;
+            const { auctionId, bidderRequests = [], bidsReceived = [], noBids = [], timeoutBids = [] } = auctionEndEvent;
+            const oMatchersSet = new Set();
+            const oSourcesSet = new Set();
+            let adUnitCode = "unknown";
+            let totalBids = 0;
+            let device = null;
+            // Process bidder requests
+            const requests = bidderRequests.map((br) => {
+                var _a, _b, _c, _d, _e, _f, _g;
+                const { bidderCode, bidderRequestId, bids = [] } = br;
+                const domain = (_b = (_a = br.ortb2.site) === null || _a === void 0 ? void 0 : _a.domain) !== null && _b !== void 0 ? _b : "unknown";
+                const allEids = [...((_e = (_d = (_c = br.ortb2.user) === null || _c === void 0 ? void 0 : _c.ext) === null || _d === void 0 ? void 0 : _d.eids) !== null && _e !== void 0 ? _e : []), ...((_g = (_f = br.ortb2.user) === null || _f === void 0 ? void 0 : _f.eids) !== null && _g !== void 0 ? _g : [])];
+                // Deduplicate EIDs by source
+                const eids = Array.from(new Map(allEids.map((eid) => [eid.source, eid])).values());
+                // Optable EIDs
+                const optableEIDS = eids.filter((e) => e.inserter === "optable.co");
+                const optableMatchers = [...new Set(optableEIDS.map((e) => e.matcher).filter(Boolean))];
+                const optableSources = [...new Set(optableEIDS.map((e) => e.source).filter(Boolean))];
+                device = br.ortb2.device;
+                return {
+                    bidderCode,
+                    bidderRequestId,
+                    domain,
+                    optableTargetingDone: optableEIDS.length > 0,
+                    optableMatchers,
+                    optableSources,
+                    status: STATUS.REQUESTED,
+                    bids: bids.map((b) => {
+                        var _a, _b, _c, _d;
+                        return ({
+                            bidId: b.bidId,
+                            bidderRequestId,
+                            adUnitCode: b.adUnitCode,
+                            adUnitId: b.adUnitId,
+                            transactionId: b.transactionId,
+                            src: b.src,
+                            floorMin: (_a = b.floorData) === null || _a === void 0 ? void 0 : _a.floorMin,
+                            splitTestAssignment: (_d = (_c = (_b = b.ortb2Imp) === null || _b === void 0 ? void 0 : _b.ext) === null || _c === void 0 ? void 0 : _c.optable) === null || _d === void 0 ? void 0 : _d.splitTestAssignment,
+                            status: STATUS.REQUESTED,
+                        });
+                    }),
+                };
+            });
+            // Merge splitTestAssignment from bidsReceived into the requests
+            const bidsReceivedMap = new Map(bidsReceived.map((b) => [b.requestId, b]));
+            requests.forEach((request) => {
+                request.bids.forEach((bid) => {
+                    var _a, _b, _c;
+                    const bidReceived = bidsReceivedMap.get(bid.bidId);
+                    if ((_c = (_b = (_a = bidReceived === null || bidReceived === void 0 ? void 0 : bidReceived.ortb2Imp) === null || _a === void 0 ? void 0 : _a.ext) === null || _b === void 0 ? void 0 : _b.optable) === null || _c === void 0 ? void 0 : _c.splitTestAssignment) {
+                        bid.splitTestAssignment = bidReceived.ortb2Imp.ext.optable.splitTestAssignment;
+                    }
+                });
+            });
+            const witnessData = {
+                bidderRequests: requests.map((br) => {
+                    br.optableMatchers.forEach((m) => oMatchersSet.add(m));
+                    br.optableSources.forEach((s) => oSourcesSet.add(s));
+                    return br;
+                }),
+                auctionId,
+                adUnitCode,
+                totalRequests: bidderRequests.length,
+                optableSampling: this.config.samplingRate || 1,
+                optableTargetingDone: oMatchersSet.size || oSourcesSet.size,
+                optableMatchers: Array.from(oMatchersSet),
+                optableSources: Array.from(oSourcesSet),
+                bidWon: bidWonEvent
+                    ? {
+                        message: bidWonEvent.bidderCode +
+                            " won the ad server auction for ad unit " +
+                            bidWonEvent.adUnitCode +
+                            " at " +
+                            bidWonEvent.cpm +
+                            " CPM",
+                        bidderCode: bidWonEvent.bidderCode,
+                        adUnitCode: bidWonEvent.adUnitCode,
+                        cpm: bidWonEvent.cpm,
+                    }
+                    : null,
+                missed,
+                url: `${window.location.hostname}${window.location.pathname}`,
+                tenant: this.config.tenant,
+                // eslint-disable-next-line no-undef
+                optableWrapperVersion: SDK_WRAPPER_VERSION || "unknown",
+                userAgent: Bowser.parse(window.navigator.userAgent),
+                device,
+                prebidjsVersion: ((_a = this.prebidInstance) === null || _a === void 0 ? void 0 : _a.version) || "unknown",
+                sessionDepth: (sessionStorage === null || sessionStorage === void 0 ? void 0 : sessionStorage.optableSessionDepth) || 1,
+                pageAuctionsCount: ((_b = window.optable) === null || _b === void 0 ? void 0 : _b.pageAuctionsCount) || 1,
+            };
+            // Log summary with bid counts
+            this.log(`Auction ${auctionId} processed: ${bidderRequests.length} requests, ${totalBids} total bids, ${bidsReceived.length} received, ${noBids.length} no-bids, ${timeoutBids.length} timeouts`);
+            if ((_c = window.optable) === null || _c === void 0 ? void 0 : _c.customAnalytics) {
+                yield window.optable.customAnalytics().then((response) => {
+                    this.log(`Adding custom data to payload ${JSON.stringify(response)}`);
+                    Object.assign(witnessData, response);
+                });
+            }
+            return witnessData;
+        });
+    }
+}
+export default OptablePrebidAnalytics;

package/lib/dist/addons/prototypes/analytics.d.ts

@@ -25,6 +25,7 @@ declare class OptablePrebidAnalytics {
      * Hook into Prebid.js events
      */
     hookIntoPrebid(prebidInstance?: any): boolean;
+    prebidInstance: any;
     trackAuctionEnd(event: any, missed: any): Promise<void>;
     trackBidWon(event: any, missed: any): void;
     /**

package/lib/dist/addons/prototypes/analytics.js

@@ -8,7 +8,6 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 /* eslint-disable no-param-reassign */
-/* eslint-disable no-console */
 const STATUS = {
     REQUESTED: "REQUESTED",
     RECEIVED: "RECEIVED",
@@ -27,6 +26,7 @@ class OptablePrebidAnalytics {
         // Store auction data
         this.auctions = {};
         this.maxAuctionDataSize = 20;
+        sessionStorage.optableSessionDepth = (Number(sessionStorage === null || sessionStorage === void 0 ? void 0 : sessionStorage.optableSessionDepth) || 0) + 1;
         this.log("OptablePrebidAnalytics initialized");
     }
     /**
@@ -34,7 +34,7 @@ class OptablePrebidAnalytics {
      */
     log(...args) {
         if (this.config.debug) {
-            console.log("[OptablePrebidAnalytics]", ...args);
+            console.log("[OptablePrebidAnalytics]", ...args); /* eslint-disable-line no-console */
         }
     }
     /**
@@ -84,6 +84,7 @@ class OptablePrebidAnalytics {
      */
     hookIntoPrebid(prebidInstance = window.pbjs) {
         const pbjs = prebidInstance;
+        this.prebidInstance = pbjs;
         if (typeof pbjs === "undefined") {
             this.log("Prebid.js not found");
             return false;
@@ -99,17 +100,19 @@ class OptablePrebidAnalytics {
     }
     trackAuctionEnd(event, missed) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
             const { auctionId, timeout, bidderRequests = [], bidsReceived = [], noBids = [], timeoutBids = [] } = event;
+            window.optable.pageAuctionsCount = (Number(window.optable.pageAuctionsCount) || 0) + 1;
             this.log(`Processing auction ${auctionId} with ${bidderRequests.length} bidder requests`);
             // Build auction object with bidder requests and EID flags
             const auction = {
                 auctionId,
                 timeout,
                 bidderRequests: bidderRequests.map((br) => {
-                    var _a, _b, _c;
+                    var _a, _b, _c, _d;
                     const { bidderCode, bidderRequestId, ortb2, bids = [] } = br;
                     const domain = (_a = ortb2 === null || ortb2 === void 0 ? void 0 : ortb2.site) === null || _a === void 0 ? void 0 : _a.domain;
-                    const eids = (_c = (_b = ortb2 === null || ortb2 === void 0 ? void 0 : ortb2.user) === null || _b === void 0 ? void 0 : _b.ext) === null || _c === void 0 ? void 0 : _c.eids;
+                    const eids = ((_c = (_b = ortb2 === null || ortb2 === void 0 ? void 0 : ortb2.user) === null || _b === void 0 ? void 0 : _b.ext) === null || _c === void 0 ? void 0 : _c.eids) || ((_d = ortb2.user) === null || _d === void 0 ? void 0 : _d.eids) || [];
                     // Optable EIDs
                     const optableEIDS = eids.filter((e) => e.inserter === "optable.co");
                     const optableMatchers = [...new Set(optableEIDS.map((e) => e.matcher).filter(Boolean))];
@@ -130,7 +133,7 @@ class OptablePrebidAnalytics {
                         liSources,
                         status: STATUS.REQUESTED,
                         bids: bids.map((b) => {
-                            var _a;
+                            var _a, _b, _c, _d;
                             return ({
                                 bidId: b.bidId,
                                 bidderRequestId,
@@ -139,6 +142,7 @@ class OptablePrebidAnalytics {
                                 transactionId: b.transactionId,
                                 src: b.src,
                                 floorMin: (_a = b.floorData) === null || _a === void 0 ? void 0 : _a.floorMin,
+                                splitTestAssignment: (_d = (_c = (_b = b.ortb2Imp) === null || _b === void 0 ? void 0 : _b.ext) === null || _c === void 0 ? void 0 : _c.optable) === null || _d === void 0 ? void 0 : _d.splitTestAssignment,
                                 status: STATUS.REQUESTED,
                             });
                         }),
@@ -158,6 +162,7 @@ class OptablePrebidAnalytics {
             });
             // Merge in bidsReceived → update individual bids as RECEIVED
             bidsReceived.forEach((b) => {
+                var _a, _b, _c, _d, _e, _f;
                 const bidId = b.requestId;
                 const br = bidToRequest[bidId];
                 if (!br) {
@@ -173,6 +178,7 @@ class OptablePrebidAnalytics {
                         cpm: b.cpm,
                         size: `${b.width}x${b.height}`,
                         currency: b.currency,
+                        splitTestAssignment: (_c = (_b = (_a = b.ortb2Imp) === null || _a === void 0 ? void 0 : _a.ext) === null || _b === void 0 ? void 0 : _b.optable) === null || _c === void 0 ? void 0 : _c.splitTestAssignment,
                     });
                 }
                 else {
@@ -188,6 +194,7 @@ class OptablePrebidAnalytics {
                         size: `${b.width}x${b.height}`,
                         currency: b.currency,
                         status: STATUS.RECEIVED,
+                        splitTestAssignment: (_f = (_e = (_d = b.ortb2Imp) === null || _d === void 0 ? void 0 : _d.ext) === null || _e === void 0 ? void 0 : _e.optable) === null || _f === void 0 ? void 0 : _f.splitTestAssignment,
                     };
                     br.bids.push(bidObj);
                     bidIndex[bidId] = bidObj;
@@ -247,6 +254,7 @@ class OptablePrebidAnalytics {
                                     cpm: b.cpm,
                                     size: b.size,
                                     bidId: b.bidId,
+                                    splitTestAssignment: b.splitTestAssignment,
                                 };
                             }),
                         };
@@ -261,8 +269,10 @@ class OptablePrebidAnalytics {
                     missed,
                     url: `${window.location.hostname}${window.location.pathname}`,
                     tenant: this.config.tenant,
-                    // eslint-disable-next-line no-undef
-                    optableWrapperVersion: SDK_WRAPPER_VERSION,
+                    optableWrapperVersion: SDK_WRAPPER_VERSION, // eslint-disable-line no-undef
+                    prebidjsVersion: ((_a = this.prebidInstance) === null || _a === void 0 ? void 0 : _a.version) || "unknown",
+                    sessionDepth: (sessionStorage === null || sessionStorage === void 0 ? void 0 : sessionStorage.optableSessionDepth) || 1,
+                    pageAuctionsCount: ((_b = window.optable) === null || _b === void 0 ? void 0 : _b.pageAuctionsCount) || 1,
                 };
                 // Log summary with bid counts
                 this.log(`Auction ${auctionId} processed: ${bidderRequests.length} requests, ${totalBids} total bids, ${bidsReceived.length} received, ${noBids.length} no-bids, ${timeoutBids.length} timeouts`);

package/lib/dist/build.json

@@ -1,3 +1,3 @@
 {
-    "version": "v0.45.0"
+    "version": "v0.49.0"
 }

package/lib/dist/config.d.ts

@@ -1,4 +1,5 @@
 import type { CMPApiConfig, Consent } from "./core/regs/consent";
+import type { PageContextConfig } from "./core/context";
 type Experiment = never;
 type MatcherOverride = {
     id: string;
@@ -9,6 +10,7 @@ type ABTestConfig = {
     trafficPercentage: number;
     matcher_override?: MatcherOverride[];
     skipMatchers?: string[];
+    skipResolvers?: string[];
 };
 type TargetingSignals = {
     ref?: boolean;
@@ -35,6 +37,7 @@ type InitConfig = {
     abTests?: ABTestConfig[];
     additionalTargetingSignals?: TargetingSignals;
     timeout?: string;
+    pageContext?: PageContextConfig | boolean;
 };
 type ResolvedConfig = {
     site: string;
@@ -70,5 +73,5 @@ declare const DCN_DEFAULTS: {
 };
 declare function getConfig(init: InitConfig): ResolvedConfig;
 declare function generateSessionID(): string;
-export type { InitConsent, CMPApiConfig, InitConfig, ResolvedConfig, ABTestConfig, MatcherOverride, Experiment };
+export type { InitConsent, CMPApiConfig, InitConfig, ResolvedConfig, ABTestConfig, MatcherOverride, Experiment, PageContextConfig, };
 export { getConfig, DCN_DEFAULTS, generateSessionID };

package/lib/dist/core/context.d.ts

@@ -0,0 +1,32 @@
+type SemanticContent = {
+    title: string;
+    description?: string;
+    keywords?: string[];
+    canonicalUrl?: string;
+    ogTags?: Record<string, string>;
+    headings?: Array<{
+        level: number;
+        text: string;
+    }>;
+    content?: string;
+    jsonLd?: object[];
+    language?: string;
+};
+type ContextData = {
+    semantic: SemanticContent;
+    html?: string;
+    url: string;
+    referrer?: string;
+    extractedAt: number;
+};
+type PageContextConfig = {
+    includeHtml?: boolean;
+    contentSelector?: string;
+    maxContentLength?: number;
+    maxHtmlLength?: number;
+};
+declare function extractSemanticContent(config: PageContextConfig): SemanticContent;
+declare function extractContext(config: PageContextConfig): ContextData;
+declare function normalizeContextConfig(config: PageContextConfig | boolean | undefined): PageContextConfig | null;
+export type { SemanticContent, ContextData, PageContextConfig };
+export { extractContext, extractSemanticContent, normalizeContextConfig };