@optable/web-sdk 0.54.1 → 0.55.1

package/lib/dist/addons/abTestAssignment.js

@@ -0,0 +1,117 @@
+import { determineABTest } from "../edge/abTest";
+import { getFlags } from "../core/flags";
+const DEFAULT_STORAGE_KEY = "OPTABLE_SPLIT_TEST";
+function fillTrafficPercentages(variants) {
+    const allocated = variants.reduce((sum, v) => { var _a; return sum + ((_a = v.trafficPercentage) !== null && _a !== void 0 ? _a : 0); }, 0);
+    const unassigned = variants.filter((v) => v.trafficPercentage === undefined);
+    const each = unassigned.length > 0 ? (100 - allocated) / unassigned.length : 0;
+    return variants.map((v) => {
+        var _a;
+        return ({
+            id: v.id,
+            trafficPercentage: (_a = v.trafficPercentage) !== null && _a !== void 0 ? _a : each,
+        });
+    });
+}
+export function setupAB(config) {
+    var _a, _b, _c;
+    const { variants, storageKey = DEFAULT_STORAGE_KEY, controlId = "none", treatmentId = "all", sdk, pbjs } = config;
+    // Process the provided variant config so that every variant has an explicit traffic percentage.
+    // Variants without one share the remaining percentage equally.
+    const filled = fillTrafficPercentages(variants);
+    let selected = null;
+    // Priority 1 — QA/debug override via URL param or sessionStorage flag.
+    // ?optableControlGroup=1 forces the control variant; =0 forces treatment.
+    // This lets QA verify both branches without clearing localStorage.
+    const controlGroupFlag = getFlags().optableControlGroup;
+    if (controlGroupFlag === "1") {
+        selected = (_a = filled.find((v) => v.id === controlId)) !== null && _a !== void 0 ? _a : { id: controlId, trafficPercentage: 0 };
+    }
+    else if (controlGroupFlag === "0") {
+        selected = (_b = filled.find((v) => v.id === treatmentId)) !== null && _b !== void 0 ? _b : { id: treatmentId, trafficPercentage: 0 };
+    }
+    // Priority 2 — sticky assignment from a previous visit.
+    // Once a user is assigned a variant it must not change across page loads or
+    // sessions, otherwise the same user could appear in both groups. We validate
+    // the cached id against the current variant list so a stale cache from an
+    // old experiment config is silently discarded.
+    if (!selected) {
+        try {
+            const cached = localStorage.getItem(storageKey);
+            if (cached) {
+                const parsed = JSON.parse(cached);
+                if ((parsed === null || parsed === void 0 ? void 0 : parsed.id) && filled.some((v) => v.id === parsed.id)) {
+                    selected = parsed;
+                }
+            }
+        }
+        catch (_d) {
+            // localStorage unavailable or invalid JSON
+        }
+    }
+    // Priority 3 — first visit: randomly assign based on traffic weights.
+    // determineABTest returns null when the random bucket falls outside all
+    // defined ranges (i.e. weights sum to less than 100). filled[0] is the
+    // fallback so selected is always non-null after this point.
+    if (!selected) {
+        selected = (_c = determineABTest(filled)) !== null && _c !== void 0 ? _c : filled[0];
+    }
+    // Persist the assignment so subsequent visits return the same variant.
+    try {
+        localStorage.setItem(storageKey, JSON.stringify(selected));
+    }
+    catch (_e) {
+        // localStorage unavailable
+    }
+    const isControl = selected.id !== treatmentId;
+    const assignment = selected.id;
+    // Control group: clear cached targeting data so RTD, PPID and TargetingFromCache
+    // serve nothing for this user. Without this, a user moved into the control group
+    // would still receive Optable targeting from a previous session's cache.
+    if (isControl) {
+        try {
+            localStorage.removeItem("OPTABLE_RESOLVED");
+            if (sdk) {
+                sdk.targetingClearCache();
+            }
+            else {
+                Object.keys(localStorage)
+                    .filter((k) => k.startsWith("OPTABLE_TARGETING_"))
+                    .forEach((k) => localStorage.removeItem(k));
+            }
+        }
+        catch (_f) {
+            // localStorage unavailable
+        }
+    }
+    function applyToAuctionEvent(event) {
+        (event.bidderRequests || []).forEach((br) => {
+            (br.bids || []).forEach((b) => {
+                var _a, _b, _c;
+                if ((_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)
+                    return;
+                b.ortb2Imp = b.ortb2Imp || {};
+                b.ortb2Imp.ext = b.ortb2Imp.ext || {};
+                b.ortb2Imp.ext.optable = b.ortb2Imp.ext.optable || {};
+                b.ortb2Imp.ext.optable.splitTestAssignment = assignment;
+            });
+        });
+    }
+    function setHooks(pbjsInstance) {
+        pbjsInstance.getEvents().forEach((event) => {
+            if (event.eventType === "auctionEnd") {
+                applyToAuctionEvent(event.args);
+            }
+        });
+        pbjsInstance.onEvent("auctionEnd", applyToAuctionEvent);
+    }
+    if (pbjs) {
+        setHooks(pbjs);
+    }
+    return {
+        variant: selected,
+        isControl,
+        splitTestAssignment: assignment,
+        setHooks,
+    };
+}

package/lib/dist/addons/botDetection.d.ts

@@ -0,0 +1,2 @@
+/** True if the current user agent looks like a known bot/crawler. */
+export declare function isBot(userAgent?: string): boolean;

package/lib/dist/addons/botDetection.js

@@ -0,0 +1,29 @@
+const BOT_PATTERN = new RegExp([
+    "bot",
+    "crawler",
+    "spider",
+    "scraper",
+    "headless",
+    "phantomjs",
+    "selenium",
+    "webdriver",
+    "curl",
+    "wget",
+    "python",
+    "java",
+    "perl",
+    "ruby",
+    "go-http-client",
+    "okhttp",
+    "axios",
+    "fetch",
+    "postman",
+    "insomnia",
+    "googleother",
+    "google-extended",
+    "google-inspectiontool",
+].join("|"), "i");
+/** True if the current user agent looks like a known bot/crawler. */
+export function isBot(userAgent = navigator.userAgent) {
+    return BOT_PATTERN.test(userAgent || "");
+}

package/lib/dist/addons/geotargeting.d.ts

@@ -0,0 +1,8 @@
+export type GeoMapEntry = [string, string] | [string, string, string];
+export type GeoMap = Record<string, GeoMapEntry>;
+export interface GeoConfig {
+    host: string;
+    node: string | undefined;
+}
+export declare const DEFAULT_GEO_MAP: GeoMap;
+export declare function getGeoConfig(nodeName: string, geo: string | undefined, geoMap?: GeoMap): GeoConfig | null;

package/lib/dist/addons/geotargeting.js

@@ -0,0 +1,54 @@
+/*
+ * The geotargeting addon maps a visitor's geo (country code) to the Optable
+ * host and node that should serve them, so that a single SDK bundle can route
+ * traffic to region-specific DCNs.
+ *
+ * A GeoMap entry is a tuple of host fragments keyed by country code:
+ *   [0] — host suffix for the standard (non-auth) node
+ *   [1] — host suffix for the auth node
+ *   [2] — optional regional edge host shared by multiple nodes
+ *
+ * When a regional edge host ([2]) is present, it is used as the host and the
+ * node name is derived from the tenant name plus the suffix with ".cloud"
+ * removed (e.g. "acme" + "-ca-auth" → "acme-ca-auth"). Otherwise the tenant
+ * runs on a dedicated cloud host built as `${name}${suffix}.optable.co` and
+ * the node is undefined (the host's default node is used).
+ *
+ * DEFAULT_GEO_MAP reflects one specific provisioning shape: regional edge
+ * nodes in US/CA and dedicated per-tenant cloud hosts in AU and the EU. The
+ * dedicated hosts only exist for tenants provisioned that way — tenants with
+ * a different topology must pass their own GeoMap.
+ */
+const EU_ENTRY = [".cloud.eu", "-auth.cloud.eu"];
+export const DEFAULT_GEO_MAP = {
+    AU: [".cloud.au", "-auth.cloud.au"],
+    CA: ["-ca.cloud", "-ca-auth.cloud", "ca.edge.optable.co"],
+    GB: EU_ENTRY,
+    UK: EU_ENTRY,
+    US: [".cloud", "-auth.cloud", "na.edge.optable.co"],
+};
+/*
+ * getGeoConfig() resolves the host and node for a node name in a given geo.
+ *
+ * nodeName is the tenant name, optionally with an "-auth" suffix selecting the
+ * auth variant of the node (e.g. "acme" or "acme-auth").
+ *
+ * Returns null when the geo is missing or not present in the map, in which
+ * case the caller should skip region-specific initialization.
+ */
+export function getGeoConfig(nodeName, geo, geoMap = DEFAULT_GEO_MAP) {
+    const entry = geo === undefined ? undefined : geoMap[geo];
+    // Array.isArray also rejects inherited Object.prototype members picked up
+    // when an unexpected geo like "constructor" is looked up in the map
+    if (!Array.isArray(entry)) {
+        return null;
+    }
+    const auth = /-auth$/i.test(nodeName);
+    const name = auth ? nodeName.replace(/-auth$/i, "") : nodeName;
+    const suffix = auth ? entry[1] : entry[0];
+    const edgeHost = entry[2];
+    if (edgeHost != null) {
+        return { host: edgeHost, node: name + suffix.replace(/\.cloud/, "") };
+    }
+    return { host: `${name}${suffix}.optable.co`, node: undefined };
+}

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

@@ -22,6 +22,7 @@ declare class OptablePrebidAnalytics {
     private readonly maxAuctionDataSize;
     private auctions;
     private missedAuctionIds;
+    private pendingTimeoutBids;
     private prebidInstance;
     /**
      * Create a new OptablePrebidAnalytics instance.
@@ -29,6 +30,7 @@ declare class OptablePrebidAnalytics {
      * @param config - Optional configuration for sampling, debug and analytics behavior.
      */
     constructor(optableInstance: OptableSDK, config?: OptablePrebidAnalyticsConfig);
+    private handleVisibilityChange;
     /**
      * Log messages to the console when debugging is enabled.
      * @param args - Values to log.

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

@@ -7,6 +7,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+import { buildRequest } from "../../core/network";
 import * as Bowser from "bowser";
 const STATUS = {
     REQUESTED: "REQUESTED",
@@ -30,6 +31,33 @@ class OptablePrebidAnalytics {
         this.maxAuctionDataSize = 50;
         this.auctions = new Map();
         this.missedAuctionIds = new Set();
+        this.pendingTimeoutBids = new Map();
+        this.handleVisibilityChange = () => {
+            if (document.visibilityState !== "hidden")
+                return;
+            if (!this.optableInstance.dcn)
+                return;
+            const witnessUrl = buildRequest("/witness", this.optableInstance.dcn).url;
+            this.auctions.forEach((auction, auctionId) => {
+                if (!auction.auctionEndTimeoutId)
+                    return;
+                if (!auction.sampled)
+                    return;
+                clearTimeout(auction.auctionEndTimeoutId);
+                this.auctions.delete(auctionId);
+                this.toWitness(auction.auctionEnd, auction.bidWonEvents, auction.missed).then((payload) => {
+                    payload["auctionEndAt"] = auction.createdAt.toISOString();
+                    payload["bidWonAt"] =
+                        auction.bidWonEvents.length > 0
+                            ? new Date(Math.min(...auction.bidWonEvents.map((e) => e._receivedAt.getTime()))).toISOString()
+                            : null;
+                    payload["optableLoaded"] = !auction.missed;
+                    navigator.sendBeacon(witnessUrl, new Blob([JSON.stringify({ event: "optable.prebid.auction", properties: payload })], {
+                        type: "application/json",
+                    }));
+                });
+            });
+        };
         if (!optableInstance || typeof optableInstance.witness !== "function") {
             throw new Error("OptablePrebidAnalytics requires a valid optable instance with witness() method");
         }
@@ -47,6 +75,7 @@ class OptablePrebidAnalytics {
         this.isInitialized = true;
         // Store auction data
         this.maxAuctionDataSize = 50;
+        document.addEventListener("visibilitychange", this.handleVisibilityChange);
         this.log("OptablePrebidAnalytics initialized");
     }
     /**
@@ -124,6 +153,13 @@ class OptablePrebidAnalytics {
             if (event.eventType === "auctionInit") {
                 this.missedAuctionIds.add(event.args.auctionId);
             }
+            else if (event.eventType === "bidTimeout") {
+                event.args.forEach((bid) => {
+                    const existing = this.pendingTimeoutBids.get(bid.auctionId) || [];
+                    existing.push(bid);
+                    this.pendingTimeoutBids.set(bid.auctionId, existing);
+                });
+            }
             else if (event.eventType === "auctionEnd") {
                 this.missedAuctionIds.delete(event.args.auctionId);
                 this.log(`auction ${event.args.auctionId} missed (completed before hook)`);
@@ -135,6 +171,14 @@ class OptablePrebidAnalytics {
             }
         });
         this.log("Hooking into Prebid.js events");
+        pbjs.onEvent("bidTimeout", (timedOutBids) => {
+            this.log("bidTimeout event received", timedOutBids);
+            timedOutBids.forEach((bid) => {
+                const existing = this.pendingTimeoutBids.get(bid.auctionId) || [];
+                existing.push(bid);
+                this.pendingTimeoutBids.set(bid.auctionId, existing);
+            });
+        });
         pbjs.onEvent("auctionEnd", (event) => {
             this.log("auctionEnd event received");
             const missed = this.missedAuctionIds.has(event.auctionId);
@@ -180,7 +224,9 @@ class OptablePrebidAnalytics {
      */
     trackAuctionEnd(event_1) {
         return __awaiter(this, arguments, void 0, function* (event, missed = false) {
-            const { auctionId, timeout, bidderRequests = [], bidsReceived = [], noBids = [], timeoutBids = [] } = event;
+            const { auctionId, timeout, bidderRequests = [], bidsReceived = [], noBids = [] } = event;
+            const timeoutBids = this.pendingTimeoutBids.get(auctionId) || [];
+            const sampled = !!this.config.analytics && this.shouldSample();
             this.log(`Processing auction ${auctionId} with ${bidderRequests.length} bidder requests`);
             window.optable = window.optable || {};
             window.optable.pageAuctionsCount = (Number(window.optable.pageAuctionsCount) || 0) + 1;
@@ -307,6 +353,10 @@ class OptablePrebidAnalytics {
                 const storedAuction = this.auctions.get(auctionId);
                 if (!storedAuction)
                     return;
+                if (!storedAuction.sampled) {
+                    this.auctions.delete(auctionId);
+                    return;
+                }
                 const effectiveMissed = storedAuction.missed;
                 const payload = yield this.toWitness(event, storedAuction.bidWonEvents, effectiveMissed);
                 payload["auctionEndAt"] = createdAt.toISOString();
@@ -319,7 +369,16 @@ class OptablePrebidAnalytics {
                 this.auctions.delete(auctionId);
             }), this.config.bidWinTimeout);
             // Store the auction data
-            this.auctions.set(auctionId, { auctionEnd: event, createdAt, missed, auctionEndTimeoutId, bidWonEvents: [] });
+            this.auctions.set(auctionId, {
+                auctionEnd: event,
+                createdAt,
+                missed,
+                auctionEndTimeoutId,
+                bidWonEvents: [],
+                timeoutBids,
+                sampled,
+            });
+            this.pendingTimeoutBids.delete(auctionId);
             // Clean up old auctions
             this.cleanupOldAuctions();
         });
@@ -377,8 +436,9 @@ class OptablePrebidAnalytics {
      */
     toWitness(auctionEndEvent_1, bidWonEvents_1) {
         return __awaiter(this, arguments, void 0, function* (auctionEndEvent, bidWonEvents, missed = false) {
-            var _a, _b, _c, _d, _e, _f;
-            const { auctionId, bidderRequests = [], bidsReceived = [], noBids = [], timeoutBids = [] } = auctionEndEvent;
+            var _a, _b, _c, _d, _e, _f, _g;
+            const { auctionId, bidderRequests = [], bidsReceived = [], noBids = [] } = auctionEndEvent;
+            const timeoutBids = ((_a = this.auctions.get(auctionId)) === null || _a === void 0 ? void 0 : _a.timeoutBids) || [];
             const oMatchersSet = new Set();
             const oSourcesSet = new Set();
             let adUnitCode = "unknown";
@@ -421,16 +481,31 @@ class OptablePrebidAnalytics {
                     }),
                 };
             });
-            // Merge splitTestAssignment from bidsReceived into the requests
             const bidsReceivedMap = new Map(bidsReceived.map((b) => [b.requestId, b]));
+            const noBidRequestIds = new Set(noBids.map((nb) => nb.bidderRequestId));
+            const timedOutRequestIds = new Set(timeoutBids.map((tb) => tb.bidderRequestId));
             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;
+                    if (bidReceived) {
+                        bid.status = STATUS.RECEIVED;
+                        bid.cpm = bidReceived.cpm;
+                        bid.size = `${bidReceived.width}x${bidReceived.height}`;
+                        bid.currency = bidReceived.currency;
+                        if ((_c = (_b = (_a = 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;
+                        }
+                        if (request.status === STATUS.REQUESTED)
+                            request.status = STATUS.RECEIVED;
                     }
                 });
+                if (noBidRequestIds.has(request.bidderRequestId) && request.status === STATUS.REQUESTED) {
+                    request.status = STATUS.NO_BID;
+                }
+                if (timedOutRequestIds.has(request.bidderRequestId)) {
+                    request.status = STATUS.TIMEOUT;
+                }
             });
             const witnessData = {
                 bidderRequests: requests.map((br) => {
@@ -457,14 +532,14 @@ class OptablePrebidAnalytics {
                 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",
+                prebidjsVersion: ((_b = this.prebidInstance) === null || _b === void 0 ? void 0 : _b.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,
-                originSlug: ((_d = (_c = this.optableInstance) === null || _c === void 0 ? void 0 : _c.dcn) === null || _d === void 0 ? void 0 : _d.site) || ((_e = window.optable) === null || _e === void 0 ? void 0 : _e.site) || "unknown",
+                pageAuctionsCount: ((_c = window.optable) === null || _c === void 0 ? void 0 : _c.pageAuctionsCount) || 1,
+                originSlug: ((_e = (_d = this.optableInstance) === null || _d === void 0 ? void 0 : _d.dcn) === null || _e === void 0 ? void 0 : _e.site) || ((_f = window.optable) === null || _f === void 0 ? void 0 : _f.site) || "unknown",
             };
             // 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 ((_f = window.optable) === null || _f === void 0 ? void 0 : _f.customAnalytics) {
+            if ((_g = window.optable) === null || _g === void 0 ? void 0 : _g.customAnalytics) {
                 yield window.optable.customAnalytics().then((response) => {
                     this.log(`Adding custom data to payload ${JSON.stringify(response)}`);
                     Object.assign(witnessData, response);

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

@@ -110,10 +110,10 @@ class OptablePrebidAnalytics {
                 auctionId,
                 timeout,
                 bidderRequests: bidderRequests.map((br) => {
-                    var _a, _b, _c, _d;
+                    var _a, _b, _c, _d, _e, _f;
                     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) || ((_d = ortb2.user) === null || _d === void 0 ? void 0 : _d.eids) || [];
+                    const eids = [...((_d = (_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) !== null && _d !== void 0 ? _d : []), ...((_f = (_e = ortb2 === null || ortb2 === void 0 ? void 0 : ortb2.user) === null || _e === void 0 ? void 0 : _e.eids) !== null && _f !== void 0 ? _f : [])];
                     // Optable EIDs
                     const optableEIDS = eids.filter((e) => e.inserter === "optable.co");
                     const optableMatchers = [...new Set(optableEIDS.map((e) => e.matcher).filter(Boolean))];
@@ -274,7 +274,7 @@ class OptablePrebidAnalytics {
                     prebidjsVersion: ((_a = this.prebidInstance) === null || _a === void 0 ? void 0 : _a.version) || "unknown",
                     sessionDepth: (sessionStorage === null || sessionStorage === void 0 ? void 0 : sessionStorage.optableSessionDepthIndex) || 1,
                     pageAuctionsCount: ((_b = window.optable) === null || _b === void 0 ? void 0 : _b.pageAuctionIndex) || 1,
-                    originSlug: ((_d = (_c = this.optableInstance) === null || _c === void 0 ? void 0 : _c.dcn) === null || _d === void 0 ? void 0 : _d.site) || ((_e = window.optable) === null || _e === void 0 ? void 0 : _e.site) || "unknown",
+                    originSlug: ((_c = window.optable) === null || _c === void 0 ? void 0 : _c.site) || ((_e = (_d = this.optableInstance) === null || _d === void 0 ? void 0 : _d.dcn) === null || _e === void 0 ? void 0 : _e.site) || "unknown", // optable.site first since dcn is analytics always
                 };
                 // 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.54.1"
+    "version": "v0.55.1"
 }

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

@@ -0,0 +1,6 @@
+declare const FLAG_KEYS: readonly ["optableDebug", "optableDisableConsent", "optableResolve1P", "optableResolve3P", "optableEnableAnalytics", "optableControlGroup", "optableForceTargeting", "optableForceGlobalRouting", "optableForceSkipMerge"];
+export type FlagKey = (typeof FLAG_KEYS)[number];
+export type Flags = Partial<Record<FlagKey, string>>;
+export declare function getFlags(): Flags;
+export declare function resetFlags(): void;
+export {};

package/lib/dist/core/flags.js

@@ -0,0 +1,49 @@
+const FLAG_KEYS = [
+    "optableDebug",
+    "optableDisableConsent",
+    "optableResolve1P",
+    "optableResolve3P",
+    "optableEnableAnalytics",
+    "optableControlGroup",
+    "optableForceTargeting",
+    "optableForceGlobalRouting",
+    "optableForceSkipMerge",
+];
+function parseFlags() {
+    const flags = {};
+    try {
+        const params = new URLSearchParams(window.location.search);
+        for (const key of FLAG_KEYS) {
+            if (params.has(key)) {
+                flags[key] = params.get(key) || "1";
+            }
+        }
+    }
+    catch (_a) {
+        // URL params unavailable
+    }
+    try {
+        for (const key of FLAG_KEYS) {
+            if (!(key in flags)) {
+                const val = sessionStorage.getItem(key);
+                if (val !== null) {
+                    flags[key] = val;
+                }
+            }
+        }
+    }
+    catch (_b) {
+        // sessionStorage unavailable
+    }
+    return flags;
+}
+let _flags = null;
+export function getFlags() {
+    if (!_flags) {
+        _flags = parseFlags();
+    }
+    return _flags;
+}
+export function resetFlags() {
+    _flags = null;
+}

package/lib/dist/core/prebid/rtd.js

@@ -1,4 +1,3 @@
-// RTD (Real-Time Data) module for Prebid.js integration
 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) {
@@ -19,6 +18,8 @@ var __rest = (this && this.__rest) || function (s, e) {
         }
     return t;
 };
+// RTD (Real-Time Data) module for Prebid.js integration
+import { getFlags } from "../flags";
 // Merge strategies for EIDs
 function appendMergeStrategy(existingEids, newEids) {
     return [...existingEids, ...newEids];
@@ -241,18 +242,20 @@ function handleRtd(config, reqBidsConfigObj, targetingData, _optableExtraData, _
     let globalEidsCount = 0;
     let bidderEidsCount = 0;
     Object.entries(eidsPerRoute).forEach(([route, ortb2]) => {
-        var _a, _b, _c, _d;
+        var _a, _b, _c;
         const count = ((_c = (_b = (_a = ortb2.user) === null || _a === void 0 ? void 0 : _a.ext) === null || _b === void 0 ? void 0 : _b.eids) === null || _c === void 0 ? void 0 : _c.length) || 0;
         if (route === "global") {
             globalEidsCount += count;
             skippedEids += merge(config, reqBidsConfigObj.ortb2Fragments.global, ortb2);
         }
-        else {
+        else if (route in reqBidsConfigObj.ortb2Fragments.bidder) {
             bidderEidsCount += count;
-            const bidder = (_d = reqBidsConfigObj.ortb2Fragments.bidder[route]) !== null && _d !== void 0 ? _d : {};
-            skippedEids += merge(config, bidder, ortb2);
-            // eslint-disable-next-line no-param-reassign
-            reqBidsConfigObj.ortb2Fragments.bidder[route] = bidder;
+            skippedEids += merge(config, reqBidsConfigObj.ortb2Fragments.bidder[route], ortb2);
+        }
+        else {
+            config.log("info", `Bidder "${route}" not in auction, routing ${count} EID(s) to global`);
+            globalEidsCount += count;
+            skippedEids += merge(config, reqBidsConfigObj.ortb2Fragments.global, ortb2);
         }
     });
     config.log("info", `Processed ${processedEids} EIDs, skipped ${skippedEids} EIDs`);
@@ -265,34 +268,35 @@ function liveIntentUID2(ortb2) {
     return (((_c = (_b = (_a = ortb2.user) === null || _a === void 0 ? void 0 : _a.ext) === null || _b === void 0 ? void 0 : _b.eids) === null || _c === void 0 ? void 0 : _c.some((eid) => eid.source === "uidapi.com" && eid.uids.some((uid) => { var _a; return ((_a = uid.ext) === null || _a === void 0 ? void 0 : _a.provider) === "liveintent.com"; }))) || false);
 }
 function buildRTD(options = {}) {
-    var _a, _b, _c, _d, _e, _f, _g, _h;
-    if (sessionStorage.optableForceGlobalRouting || options.forceGlobalRouting) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    const flags = getFlags();
+    if (flags.optableForceGlobalRouting || options.forceGlobalRouting) {
         forceGlobalRouting();
     }
     return {
-        enableLogging: (_b = (_a = sessionStorage.optableDebug) !== null && _a !== void 0 ? _a : options.enableLogging) !== null && _b !== void 0 ? _b : false,
+        enableLogging: !!flags.optableDebug || ((_a = options.enableLogging) !== null && _a !== void 0 ? _a : false),
         log(level, message, ...args) {
             if (this.enableLogging) {
                 log(level, message, ...args);
             }
         },
-        eidSources: (_c = options.eidSources) !== null && _c !== void 0 ? _c : Object.assign({}, defaultEIDSources),
-        skipMerge: sessionStorage.optableForceSkipMerge
+        eidSources: (_b = options.eidSources) !== null && _b !== void 0 ? _b : Object.assign({}, defaultEIDSources),
+        skipMerge: flags.optableForceSkipMerge
             ? () => true
             : options.skipMerge !== undefined
                 ? options.skipMerge
                 : () => false,
-        optableCacheTargeting: (_d = options.optableCacheTargeting) !== null && _d !== void 0 ? _d : "OPTABLE_RESOLVED",
-        matcherFilter: (_e = options.matcherFilter) !== null && _e !== void 0 ? _e : [],
-        matcherExclude: (_f = options.matcherExclude) !== null && _f !== void 0 ? _f : [],
+        optableCacheTargeting: (_c = options.optableCacheTargeting) !== null && _c !== void 0 ? _c : "OPTABLE_RESOLVED",
+        matcherFilter: (_d = options.matcherFilter) !== null && _d !== void 0 ? _d : [],
+        matcherExclude: (_e = options.matcherExclude) !== null && _e !== void 0 ? _e : [],
         mergeStrategy: options.mergeStrategy,
         appendMergeStrategy,
         prependMergeStrategy,
         replaceMergeStrategy,
         appendNewMergeStrategy,
         targetingFromCache,
-        instance: (_g = options.instance) !== null && _g !== void 0 ? _g : "instance",
-        waitForTargeting: (_h = options.waitForTargeting) !== null && _h !== void 0 ? _h : false,
+        instance: (_f = options.instance) !== null && _f !== void 0 ? _f : "instance",
+        waitForTargeting: (_g = options.waitForTargeting) !== null && _g !== void 0 ? _g : false,
         handleRtd(reqBidsConfigObj, optableExtraData, mergeFn) {
             return __awaiter(this, void 0, void 0, function* () {
                 var _a;

package/lib/dist/edge/abTest.d.ts

@@ -0,0 +1,2 @@
+import type { ABTestConfig } from "../config";
+export declare function determineABTest(abTests?: ABTestConfig[]): ABTestConfig | null;

package/lib/dist/edge/abTest.js

@@ -0,0 +1,19 @@
+export function determineABTest(abTests) {
+    if (!abTests || abTests.length === 0) {
+        return null;
+    }
+    const totalTrafficPercentage = abTests.reduce((sum, test) => sum + test.trafficPercentage, 0);
+    if (totalTrafficPercentage > 100) {
+        console.error(`AB Test Config Error: Traffic Percentage Sum Exceeds 100%`);
+        return null;
+    }
+    const bucket = Math.floor(Math.random() * 100);
+    let cumulative = 0;
+    for (const test of abTests) {
+        cumulative += test.trafficPercentage;
+        if (bucket < cumulative) {
+            return test;
+        }
+    }
+    return null;
+}

package/lib/dist/edge/targeting.d.ts

@@ -1,4 +1,4 @@
-import type { ResolvedConfig, ABTestConfig, MatcherOverride } from "../config";
+import type { ResolvedConfig, MatcherOverride } from "../config";
 import * as ortb2 from "iab-openrtb/v26";
 type Identifier = {
     id: string;
@@ -28,16 +28,21 @@ type TargetingResponse = {
     ab_test_id?: string;
     split_test_assignment?: string;
 };
-declare function determineABTest(abTests?: ABTestConfig[]): ABTestConfig | null;
 declare function Targeting(config: ResolvedConfig, req: TargetingRequest): Promise<TargetingResponse>;
 declare function TargetingFromCache(config: ResolvedConfig): TargetingResponse | null;
 declare function TargetingClearCache(config: ResolvedConfig): void;
+/**
+ * Skip targeting for bots by marking targeting as already done,
+ * so RTD short-circuits and returns null. No-op for real users.
+ * Returns whether the request was identified as a bot.
+ */
+export declare function SkipTargetingForBots(): boolean;
 type PrebidORTB2 = {
     user: ortb2.User;
 };
 declare function PrebidORTB2(tdata: TargetingResponse | null): PrebidORTB2;
 type TargetingKeyValues = Record<string, string[]>;
 declare function TargetingKeyValues(tdata: TargetingResponse | null): TargetingKeyValues;
-export { Targeting, TargetingFromCache, TargetingClearCache, PrebidORTB2, TargetingKeyValues, determineABTest };
+export { Targeting, TargetingFromCache, TargetingClearCache, PrebidORTB2, TargetingKeyValues };
 export default Targeting;
-export type { TargetingResponse, TargetingRequest, ABTestConfig, MatcherOverride };
+export type { TargetingResponse, TargetingRequest, MatcherOverride };