@optable/web-sdk 0.44.6 → 0.48.0

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,14 +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) => {
-                    const { bidderCode, bidderRequestId, ortb2: { site: { domain }, user: { ext: { eids }, }, }, bids = [], } = br;
+                    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) || ((_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))];
@@ -127,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,
@@ -136,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,
                             });
                         }),
@@ -155,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) {
@@ -170,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 {
@@ -185,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;
@@ -244,6 +254,7 @@ class OptablePrebidAnalytics {
                                     cpm: b.cpm,
                                     size: b.size,
                                     bidId: b.bidId,
+                                    splitTestAssignment: b.splitTestAssignment,
                                 };
                             }),
                         };
@@ -258,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/addons/try-identify.js

@@ -16,5 +16,5 @@ OptableSDK.prototype.tryIdentifyFromParams = function (key, prefix) {
     if (eid == "" || (!prefix && !maybeValidEID(eid))) {
         return;
     }
-    this.identify((prefix || "e") + ":" + eid.toLowerCase());
+    this.identify((prefix || "e") + ":" + eid);
 };

package/lib/dist/build.json

@@ -1,3 +1,3 @@
 {
-    "version": "v0.44.6"
+    "version": "v0.48.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 };

package/lib/dist/core/context.js

@@ -0,0 +1,146 @@
+const DEFAULT_MAX_CONTENT_LENGTH = 5000;
+const DEFAULT_MAX_HTML_LENGTH = 50000;
+const MAX_HEADINGS = 20;
+function extractSemanticContent(config) {
+    var _a;
+    const semantic = {
+        title: document.title || "",
+    };
+    // Extract meta description
+    const descriptionMeta = document.querySelector('meta[name="description"]');
+    if (descriptionMeta) {
+        const content = descriptionMeta.getAttribute("content");
+        if (content) {
+            semantic.description = content;
+        }
+    }
+    // Extract meta keywords
+    const keywordsMeta = document.querySelector('meta[name="keywords"]');
+    if (keywordsMeta) {
+        const content = keywordsMeta.getAttribute("content");
+        if (content) {
+            semantic.keywords = content
+                .split(",")
+                .map((k) => k.trim())
+                .filter(Boolean);
+        }
+    }
+    // Extract canonical URL
+    const canonicalLink = document.querySelector('link[rel="canonical"]');
+    if (canonicalLink) {
+        const href = canonicalLink.getAttribute("href");
+        if (href) {
+            semantic.canonicalUrl = href;
+        }
+    }
+    // Extract Open Graph tags
+    const ogTags = {};
+    document.querySelectorAll('meta[property^="og:"]').forEach((meta) => {
+        const property = meta.getAttribute("property");
+        const content = meta.getAttribute("content");
+        if (property && content) {
+            const key = property.replace("og:", "");
+            ogTags[key] = content;
+        }
+    });
+    if (Object.keys(ogTags).length > 0) {
+        semantic.ogTags = ogTags;
+    }
+    // Extract headings (h1-h3, max 20)
+    const headings = [];
+    document.querySelectorAll("h1, h2, h3").forEach((heading) => {
+        var _a;
+        if (headings.length >= MAX_HEADINGS)
+            return;
+        const level = parseInt(heading.tagName.substring(1), 10);
+        const text = (_a = heading.textContent) === null || _a === void 0 ? void 0 : _a.trim();
+        if (text) {
+            headings.push({ level, text });
+        }
+    });
+    if (headings.length > 0) {
+        semantic.headings = headings;
+    }
+    // Extract main content
+    const maxContentLength = (_a = config.maxContentLength) !== null && _a !== void 0 ? _a : DEFAULT_MAX_CONTENT_LENGTH;
+    const contentElement = findContentElement(config.contentSelector);
+    if (contentElement) {
+        const text = extractTextContent(contentElement);
+        if (text) {
+            semantic.content = text.substring(0, maxContentLength);
+        }
+    }
+    // Extract JSON-LD
+    const jsonLdScripts = document.querySelectorAll('script[type="application/ld+json"]');
+    const jsonLdData = [];
+    jsonLdScripts.forEach((script) => {
+        try {
+            const data = JSON.parse(script.textContent || "");
+            if (data && typeof data === "object") {
+                jsonLdData.push(data);
+            }
+        }
+        catch (_a) {
+            // Ignore invalid JSON-LD
+        }
+    });
+    if (jsonLdData.length > 0) {
+        semantic.jsonLd = jsonLdData;
+    }
+    // Extract language
+    const lang = document.documentElement.getAttribute("lang");
+    if (lang) {
+        semantic.language = lang;
+    }
+    return semantic;
+}
+function findContentElement(selector) {
+    // Use provided selector if available
+    if (selector) {
+        return document.querySelector(selector);
+    }
+    // Fall back to heuristics: main, article, or first large content block
+    const candidates = ["main", "article", '[role="main"]', ".content", "#content", ".post", ".article"];
+    for (const candidate of candidates) {
+        const element = document.querySelector(candidate);
+        if (element) {
+            return element;
+        }
+    }
+    // Last resort: body
+    return document.body;
+}
+function extractTextContent(element) {
+    if (element instanceof HTMLElement && element.innerText) {
+        return element.innerText.trim();
+    }
+    return "";
+}
+function extractContext(config) {
+    var _a;
+    const contextData = {
+        semantic: extractSemanticContent(config),
+        url: window.location.href,
+        extractedAt: Date.now(),
+    };
+    // Include referrer if available
+    if (document.referrer) {
+        contextData.referrer = document.referrer;
+    }
+    // Include HTML if configured
+    if (config.includeHtml) {
+        const maxHtmlLength = (_a = config.maxHtmlLength) !== null && _a !== void 0 ? _a : DEFAULT_MAX_HTML_LENGTH;
+        contextData.html = document.documentElement.outerHTML.substring(0, maxHtmlLength);
+    }
+    return contextData;
+}
+function normalizeContextConfig(config) {
+    if (!config) {
+        return null;
+    }
+    if (config === true) {
+        return {};
+    }
+    return config;
+}
+export { extractContext, extractSemanticContent, normalizeContextConfig };

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

@@ -2,6 +2,6 @@ import type { ResolvedConfig } from "../config";
 type ProfileTraits = {
     [key: string]: string | number | boolean;
 };
-declare function Profile(config: ResolvedConfig, traits: ProfileTraits): Promise<void>;
+declare function Profile(config: ResolvedConfig, traits: ProfileTraits, id?: string | null, neighbors?: string[] | null): Promise<void>;
 export { Profile, ProfileTraits };
 export default Profile;

package/lib/dist/edge/profile.js

@@ -1,8 +1,6 @@
 import { fetch } from "../core/network";
-function Profile(config, traits) {
-    const profile = {
-        traits: traits,
-    };
+function Profile(config, traits, id = null, neighbors = null) {
+    const profile = Object.assign(Object.assign({ traits: traits }, (id && { id: id })), (neighbors && { neighbors: neighbors }));
     return fetch("/profile", config, {
         method: "POST",
         headers: {

package/lib/dist/edge/targeting.js

@@ -52,6 +52,9 @@ function Targeting(config, req) {
             if (abTest.skipMatchers) {
                 searchParams.append("skip_matchers", abTest.skipMatchers.join(","));
             }
+            if (abTest.skipResolvers) {
+                searchParams.append("skip_resolvers", abTest.skipResolvers.join(","));
+            }
         }
         if ((_a = config.additionalTargetingSignals) === null || _a === void 0 ? void 0 : _a.ref) {
             searchParams.append("ref", `${window.location.protocol}//${window.location.host}${window.location.pathname}`);

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

@@ -1,7 +1,10 @@
 import type { ResolvedConfig } from "../config";
+import type { ContextData } from "../core/context";
 type WitnessProperties = {
-    [key: string]: string | number | boolean;
+    [key: string]: string | number | boolean | unknown[] | null | {
+        [key: string]: unknown;
+    };
 };
-declare function Witness(config: ResolvedConfig, event: string, properties: WitnessProperties): Promise<void>;
+declare function Witness(config: ResolvedConfig, event: string, properties: WitnessProperties, context?: ContextData): Promise<void>;
 export { Witness, WitnessProperties };
 export default Witness;

package/lib/dist/edge/witness.js

@@ -1,9 +1,12 @@
 import { fetch } from "../core/network";
-function Witness(config, event, properties) {
+function Witness(config, event, properties, context) {
     const evt = {
         event: event,
         properties: properties,
     };
+    if (context) {
+        evt.pageContext = context;
+    }
     return fetch("/witness", config, {
         method: "POST",
         headers: {

package/lib/dist/sdk.d.ts

@@ -10,6 +10,8 @@ declare class OptableSDK {
     static version: string;
     dcn: ResolvedConfig;
     protected init: Promise<void>;
+    private contextSent;
+    private contextConfig;
     constructor(dcn: InitConfig);
     initialize(): Promise<void>;
     identify(...ids: string[]): Promise<void>;
@@ -23,8 +25,11 @@ declare class OptableSDK {
     prebidORTB2FromCache(): PrebidORTB2;
     targetingKeyValues(): Promise<TargetingKeyValues>;
     targetingKeyValuesFromCache(): TargetingKeyValues;
-    witness(event: string, properties?: WitnessProperties): Promise<void>;
-    profile(traits: ProfileTraits): Promise<void>;
+    witness(event: string, properties?: WitnessProperties, options?: {
+        includeContext?: boolean;
+    }): Promise<void>;
+    resetContext(): void;
+    profile(traits: ProfileTraits, id?: string | null, neighbors?: string[] | null): Promise<void>;
     tokenize(id: string): Promise<TokenizeResponse>;
     resolve(id?: string): Promise<ResolveResponse>;
     static eid(email: string): string;

package/lib/dist/sdk.js

@@ -9,6 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { default as buildInfo } from "./build.json";
 import { getConfig } from "./config";
+import { extractContext, normalizeContextConfig } from "./core/context";
 import { Identify } from "./edge/identify";
 import { Uid2Token } from "./edge/uid2_token";
 import { Resolve } from "./edge/resolve";
@@ -21,7 +22,10 @@ import { sha256 } from "js-sha256";
 import { Tokenize } from "./edge/tokenize";
 class OptableSDK {
     constructor(dcn) {
+        this.contextSent = false;
+        this.contextConfig = null;
         this.dcn = getConfig(dcn);
+        this.contextConfig = normalizeContextConfig(dcn.pageContext);
         this.init = this.initialize();
     }
     initialize() {
@@ -86,15 +90,23 @@ class OptableSDK {
         return TargetingKeyValues(tdata);
     }
     witness(event_1) {
-        return __awaiter(this, arguments, void 0, function* (event, properties = {}) {
+        return __awaiter(this, arguments, void 0, function* (event, properties = {}, options = {}) {
             yield this.init;
-            return Witness(this.dcn, event, properties);
+            let context;
+            if (options.includeContext && this.contextConfig && !this.contextSent) {
+                context = extractContext(this.contextConfig);
+                this.contextSent = true;
+            }
+            return Witness(this.dcn, event, properties, context);
         });
     }
-    profile(traits) {
-        return __awaiter(this, void 0, void 0, function* () {
+    resetContext() {
+        this.contextSent = false;
+    }
+    profile(traits_1) {
+        return __awaiter(this, arguments, void 0, function* (traits, id = null, neighbors = null) {
             yield this.init;
-            return Profile(this.dcn, traits);
+            return Profile(this.dcn, traits, id, neighbors);
         });
     }
     tokenize(id) {

package/package.json

@@ -5,11 +5,11 @@
   "browser": "./lib/dist/sdk.js",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/optable/optable-web-sdk.git"
+    "url": "git+https://github.com/Optable/optable-web-sdk.git"
   },
   "homepage": "https://optable.co",
   "license": "SEE LICENSE IN LICENSE",
-  "version": "v0.44.6",
+  "version": "v0.48.0",
   "devDependencies": {
     "@babel/core": "^7.12.3",
     "@babel/plugin-proposal-class-properties": "^7.12.1",
@@ -18,6 +18,7 @@
     "@babel/preset-typescript": "^7.12.1",
     "@types/googletag": "^3.1.3",
     "@types/jest": "^26.0.15",
+    "@types/node": "^25.0.3",
     "babel-jest": "^29.7.0",
     "babel-loader": "^8.2.2",
     "core-js": "^3.7.0",
@@ -28,13 +29,15 @@
     "prettier": "^3.6.2",
     "shellcheck": "^3.0.0",
     "typescript": "^5.2.2",
-    "webpack": "^5.97.1",
+    "webpack": "^5.104.1",
     "webpack-cli": "^5.1.4",
     "whatwg-fetch": "^3.6.20"
   },
   "dependencies": {
     "@babel/runtime": "^7.27.0",
     "@optable/web-sdk": "^0.40.0",
+    "bowser": "^2.12.1",
+    "iab-adcom": "^1.0.6",
     "iab-openrtb": "^1.0.1",
     "js-sha256": "^0.11.0",
     "regenerator-runtime": "^0.13.7"
@@ -47,12 +50,12 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "npm run build-lib && npm run build-web",
+    "build": "pnpm build-lib && pnpm build-web",
     "start": "tsc -b browser --watch & webpack --config=./browser/webpack.config.js --mode=development --watch --devtool=source-map",
     "build-lib": "tsc -b lib",
     "build-web": "tsc -b browser && webpack --config=./browser/webpack.config.js",
     "test": "jest",
     "format": "prettier . --write",
-    "lint-scripts": "npx shellcheck scripts/*.sh"
+    "lint-scripts": "pnpm exec shellcheck scripts/*.sh"
   }
-}
+}