@prodigio-io/sdk 2.1.4 → 2.1.7

package/dist/index.d.mts

@@ -6,6 +6,9 @@ interface ProdigioInitConfig {
     key: string;
     badgeToken?: string;
     baseUrl?: string;
+    /** CSS selector for the element the badge should be appended into.
+     *  e.g. '#careers-footer'. Overrides automatic container detection. */
+    badgeContainer?: string;
     badge?: {
         position?: 'bottom-right' | 'bottom-left';
     };
@@ -116,8 +119,8 @@ declare class Prodigio {
         name: string;
         content: string;
     };
-    static destroy(): void;
     static init(config: ProdigioInitConfig): Promise<void>;
+    static destroy(): void;
 }
 
 export { type Achievement, type Applicant, type ApplicationResult, type BadgeProps, type CVInfo, type Job, type ListJobsParams, type PoweredBy, Prodigio, type ProdigioConfig, ProdigioError, type ProdigioInitConfig, type SalaryRange, type SubmitApplicationParams, type UploadResult, Prodigio as default };

package/dist/index.d.ts

@@ -6,6 +6,9 @@ interface ProdigioInitConfig {
     key: string;
     badgeToken?: string;
     baseUrl?: string;
+    /** CSS selector for the element the badge should be appended into.
+     *  e.g. '#careers-footer'. Overrides automatic container detection. */
+    badgeContainer?: string;
     badge?: {
         position?: 'bottom-right' | 'bottom-left';
     };
@@ -116,8 +119,8 @@ declare class Prodigio {
         name: string;
         content: string;
     };
-    static destroy(): void;
     static init(config: ProdigioInitConfig): Promise<void>;
+    static destroy(): void;
 }
 
 export { type Achievement, type Applicant, type ApplicationResult, type BadgeProps, type CVInfo, type Job, type ListJobsParams, type PoweredBy, Prodigio, type ProdigioConfig, ProdigioError, type ProdigioInitConfig, type SalaryRange, type SubmitApplicationParams, type UploadResult, Prodigio as default };

package/dist/index.js

@@ -92,7 +92,7 @@ async function verifyBadgeToken(token) {
   }
 }
 var BADGE_ELEMENT_ID = "prodigio-badge-widget";
-function injectBadge(_position) {
+function injectBadge(_position, badgeContainer) {
   if (typeof document === "undefined") return;
   if (document.getElementById(BADGE_ELEMENT_ID)) return;
   const wrapper = document.createElement("div");
@@ -134,7 +134,7 @@ function injectBadge(_position) {
     el.style.boxShadow = "0 2px 8px rgba(0,0,0,0.08)";
   });
   wrapper.appendChild(el);
-  document.body.appendChild(wrapper);
+  findBadgeContainer(badgeContainer).appendChild(wrapper);
 }
 function removeBadge() {
   var _a;
@@ -155,16 +155,78 @@ function getCachedToken(apiKey) {
     return null;
   }
 }
+var _initialized = false;
 var _routeWatcherInstalled = false;
-var _routeChangeCallbacks = [];
+var _rafHandle = null;
+var _anchorObserver = null;
+var _anchorTimeout = null;
+var ANCHOR_WAIT_MS = 3e3;
+function normalizePath(p) {
+  return p.replace(/\/$/, "").split("?")[0];
+}
+function pathMatches(current, careersPath) {
+  const c = normalizePath(current);
+  const target = normalizePath(careersPath);
+  return c === target || c.startsWith(target + "/");
+}
+function cancelPending() {
+  if (_rafHandle !== null) {
+    cancelAnimationFrame(_rafHandle);
+    _rafHandle = null;
+  }
+  if (_anchorObserver !== null) {
+    _anchorObserver.disconnect();
+    _anchorObserver = null;
+  }
+  if (_anchorTimeout !== null) {
+    clearTimeout(_anchorTimeout);
+    _anchorTimeout = null;
+  }
+}
+function waitForAnchor(badgeContainer, onFound) {
+  _anchorObserver = new MutationObserver(() => {
+    if (findBadgeAnchor(badgeContainer)) {
+      cancelPending();
+      onFound();
+    }
+  });
+  _anchorObserver.observe(document.body, { childList: true, subtree: true });
+  _anchorTimeout = setTimeout(() => {
+    cancelPending();
+    if (process.env.NODE_ENV !== "production") {
+      console.warn("[Prodigio] Badge anchor not found within 3s. Add <div data-prodigio-badge-anchor></div> to your page.");
+    }
+  }, ANCHOR_WAIT_MS);
+}
+function findBadgeAnchor(badgeContainer) {
+  if (badgeContainer) {
+    const el = document.querySelector(badgeContainer);
+    if (el) return el;
+  }
+  const anchor = document.querySelector("[data-prodigio-badge-anchor]");
+  if (anchor) return anchor;
+  return null;
+}
+function findBadgeContainer(badgeContainer) {
+  const anchor = findBadgeAnchor(badgeContainer);
+  if (anchor) return anchor;
+  const selectors = ["main", '[role="main"]', "#root", "#__next", "#app"];
+  for (const sel of selectors) {
+    const el = document.querySelector(sel);
+    if (el) return el;
+  }
+  return document.body;
+}
 function installRouteWatcher() {
   if (_routeWatcherInstalled || typeof window === "undefined") return;
   _routeWatcherInstalled = true;
-  const dispatch = () => _routeChangeCallbacks.forEach((cb) => cb());
   const orig = {
     push: history.pushState.bind(history),
     replace: history.replaceState.bind(history)
   };
+  const dispatch = () => {
+    _routeChangeCallbacks.forEach((cb) => cb());
+  };
   history.pushState = (...args) => {
     orig.push(...args);
     dispatch();
@@ -176,15 +238,7 @@ function installRouteWatcher() {
   window.addEventListener("popstate", dispatch);
   window.addEventListener("hashchange", dispatch);
 }
-var _initialized = false;
-function normalizePath(p) {
-  return p.replace(/\/$/, "").split("?")[0];
-}
-function pathMatches(current, careersPath) {
-  const c = normalizePath(current);
-  const target = normalizePath(careersPath);
-  return c === target || c.startsWith(target + "/");
-}
+var _routeChangeCallbacks = [];
 var _Prodigio = class _Prodigio {
   constructor(config) {
     // ── Jobs ──────────────────────────────────────────────────────────────────
@@ -268,11 +322,6 @@ var _Prodigio = class _Prodigio {
   static meta() {
     return { name: "prodigio-badge", content: "true" };
   }
-  // ── destroy() ─────────────────────────────────────────────────────────────
-  static destroy() {
-    removeBadge();
-    _initialized = false;
-  }
   // ── init() ────────────────────────────────────────────────────────────────
   static async init(config) {
     var _a;
@@ -282,7 +331,7 @@ var _Prodigio = class _Prodigio {
     if (process.env.NODE_ENV !== "production" && !document.querySelector('meta[name="prodigio-badge"]')) {
       console.warn('[Prodigio] Missing <meta name="prodigio-badge" content="true"> in your page <head>. This is required for compliance detection. See docs.prodigio.io');
     }
-    const { key, badgeToken, baseUrl = DEFAULT_BASE_URL, badge: badgeConfig } = config;
+    const { key, badgeToken, baseUrl = DEFAULT_BASE_URL, badge: badgeConfig, badgeContainer } = config;
     const position = (_a = badgeConfig == null ? void 0 : badgeConfig.position) != null ? _a : "bottom-right";
     const cached = getCachedToken(key);
     const [initClaims, cachedClaims] = await Promise.all([
@@ -299,42 +348,56 @@ var _Prodigio = class _Prodigio {
     const domainAllowed = bestToken ? bestToken.allowedDomains.length === 0 || bestToken.allowedDomains.includes(hostname) : true;
     const isExempt = bestToken !== null && !bestToken.badgeRequired && domainAllowed;
     let careersPath = null;
-    function evaluateBadge() {
+    function reconcile() {
+      cancelPending();
       if (isExempt) {
         removeBadge();
         return;
       }
-      if (careersPath) {
-        if (pathMatches(window.location.pathname, careersPath)) {
-          injectBadge(position);
-        } else {
-          removeBadge();
-        }
-      } else {
-        if (!bestToken && cached) {
+      if (!careersPath) {
+        if (bestToken && cached) {
           const cacheAge = Date.now() - cached.cachedAt;
           if (cacheAge < GRACE_PERIOD_MS) {
             removeBadge();
             return;
           }
         }
-        injectBadge(position);
+        if (!document.getElementById(BADGE_ELEMENT_ID)) {
+          injectBadge(position, badgeContainer);
+        }
+        return;
+      }
+      const routeMatches = pathMatches(window.location.pathname, careersPath);
+      if (!routeMatches) {
+        removeBadge();
+        return;
       }
+      queueMicrotask(() => {
+        _rafHandle = requestAnimationFrame(() => {
+          _rafHandle = null;
+          const anchor = findBadgeAnchor(badgeContainer);
+          if (anchor) {
+            if (!document.getElementById(BADGE_ELEMENT_ID)) injectBadge(position, badgeContainer);
+            return;
+          }
+          waitForAnchor(badgeContainer, () => {
+            if (!document.getElementById(BADGE_ELEMENT_ID)) injectBadge(position, badgeContainer);
+          });
+        });
+      });
     }
-    evaluateBadge();
+    reconcile();
     installRouteWatcher();
-    _routeChangeCallbacks.push(evaluateBadge);
+    _routeChangeCallbacks.push(reconcile);
     setTimeout(async () => {
       var _a2, _b;
       try {
         const res = await fetch(`${baseUrl}/api/sdk/config?key=${encodeURIComponent(key)}`);
         if (!res.ok) return;
         const data = await res.json();
-        if (data.careersPath !== void 0) {
-          careersPath = data.careersPath;
-        }
+        if (data.careersPath !== void 0) careersPath = data.careersPath;
         if (data.badgeRequired) {
-          evaluateBadge();
+          reconcile();
           return;
         }
         if (data.badgeToken) {
@@ -342,13 +405,19 @@ var _Prodigio = class _Prodigio {
           if (refreshedClaims && !refreshedClaims.badgeRequired) {
             cacheToken(key, data.badgeToken, (_a2 = data.badgeExemptUntil) != null ? _a2 : "", (_b = data.configVersion) != null ? _b : 1);
             removeBadge();
+            return;
           }
         }
-        evaluateBadge();
+        reconcile();
       } catch {
       }
     }, 0);
   }
+  static destroy() {
+    cancelPending();
+    removeBadge();
+    _initialized = false;
+  }
 };
 // ── Badge static helpers ──────────────────────────────────────────────────
 _Prodigio.POWERED_BY = {

package/dist/index.mjs

@@ -66,7 +66,7 @@ async function verifyBadgeToken(token) {
   }
 }
 var BADGE_ELEMENT_ID = "prodigio-badge-widget";
-function injectBadge(_position) {
+function injectBadge(_position, badgeContainer) {
   if (typeof document === "undefined") return;
   if (document.getElementById(BADGE_ELEMENT_ID)) return;
   const wrapper = document.createElement("div");
@@ -108,7 +108,7 @@ function injectBadge(_position) {
     el.style.boxShadow = "0 2px 8px rgba(0,0,0,0.08)";
   });
   wrapper.appendChild(el);
-  document.body.appendChild(wrapper);
+  findBadgeContainer(badgeContainer).appendChild(wrapper);
 }
 function removeBadge() {
   var _a;
@@ -129,16 +129,78 @@ function getCachedToken(apiKey) {
     return null;
   }
 }
+var _initialized = false;
 var _routeWatcherInstalled = false;
-var _routeChangeCallbacks = [];
+var _rafHandle = null;
+var _anchorObserver = null;
+var _anchorTimeout = null;
+var ANCHOR_WAIT_MS = 3e3;
+function normalizePath(p) {
+  return p.replace(/\/$/, "").split("?")[0];
+}
+function pathMatches(current, careersPath) {
+  const c = normalizePath(current);
+  const target = normalizePath(careersPath);
+  return c === target || c.startsWith(target + "/");
+}
+function cancelPending() {
+  if (_rafHandle !== null) {
+    cancelAnimationFrame(_rafHandle);
+    _rafHandle = null;
+  }
+  if (_anchorObserver !== null) {
+    _anchorObserver.disconnect();
+    _anchorObserver = null;
+  }
+  if (_anchorTimeout !== null) {
+    clearTimeout(_anchorTimeout);
+    _anchorTimeout = null;
+  }
+}
+function waitForAnchor(badgeContainer, onFound) {
+  _anchorObserver = new MutationObserver(() => {
+    if (findBadgeAnchor(badgeContainer)) {
+      cancelPending();
+      onFound();
+    }
+  });
+  _anchorObserver.observe(document.body, { childList: true, subtree: true });
+  _anchorTimeout = setTimeout(() => {
+    cancelPending();
+    if (process.env.NODE_ENV !== "production") {
+      console.warn("[Prodigio] Badge anchor not found within 3s. Add <div data-prodigio-badge-anchor></div> to your page.");
+    }
+  }, ANCHOR_WAIT_MS);
+}
+function findBadgeAnchor(badgeContainer) {
+  if (badgeContainer) {
+    const el = document.querySelector(badgeContainer);
+    if (el) return el;
+  }
+  const anchor = document.querySelector("[data-prodigio-badge-anchor]");
+  if (anchor) return anchor;
+  return null;
+}
+function findBadgeContainer(badgeContainer) {
+  const anchor = findBadgeAnchor(badgeContainer);
+  if (anchor) return anchor;
+  const selectors = ["main", '[role="main"]', "#root", "#__next", "#app"];
+  for (const sel of selectors) {
+    const el = document.querySelector(sel);
+    if (el) return el;
+  }
+  return document.body;
+}
 function installRouteWatcher() {
   if (_routeWatcherInstalled || typeof window === "undefined") return;
   _routeWatcherInstalled = true;
-  const dispatch = () => _routeChangeCallbacks.forEach((cb) => cb());
   const orig = {
     push: history.pushState.bind(history),
     replace: history.replaceState.bind(history)
   };
+  const dispatch = () => {
+    _routeChangeCallbacks.forEach((cb) => cb());
+  };
   history.pushState = (...args) => {
     orig.push(...args);
     dispatch();
@@ -150,15 +212,7 @@ function installRouteWatcher() {
   window.addEventListener("popstate", dispatch);
   window.addEventListener("hashchange", dispatch);
 }
-var _initialized = false;
-function normalizePath(p) {
-  return p.replace(/\/$/, "").split("?")[0];
-}
-function pathMatches(current, careersPath) {
-  const c = normalizePath(current);
-  const target = normalizePath(careersPath);
-  return c === target || c.startsWith(target + "/");
-}
+var _routeChangeCallbacks = [];
 var _Prodigio = class _Prodigio {
   constructor(config) {
     // ── Jobs ──────────────────────────────────────────────────────────────────
@@ -242,11 +296,6 @@ var _Prodigio = class _Prodigio {
   static meta() {
     return { name: "prodigio-badge", content: "true" };
   }
-  // ── destroy() ─────────────────────────────────────────────────────────────
-  static destroy() {
-    removeBadge();
-    _initialized = false;
-  }
   // ── init() ────────────────────────────────────────────────────────────────
   static async init(config) {
     var _a;
@@ -256,7 +305,7 @@ var _Prodigio = class _Prodigio {
     if (process.env.NODE_ENV !== "production" && !document.querySelector('meta[name="prodigio-badge"]')) {
       console.warn('[Prodigio] Missing <meta name="prodigio-badge" content="true"> in your page <head>. This is required for compliance detection. See docs.prodigio.io');
     }
-    const { key, badgeToken, baseUrl = DEFAULT_BASE_URL, badge: badgeConfig } = config;
+    const { key, badgeToken, baseUrl = DEFAULT_BASE_URL, badge: badgeConfig, badgeContainer } = config;
     const position = (_a = badgeConfig == null ? void 0 : badgeConfig.position) != null ? _a : "bottom-right";
     const cached = getCachedToken(key);
     const [initClaims, cachedClaims] = await Promise.all([
@@ -273,42 +322,56 @@ var _Prodigio = class _Prodigio {
     const domainAllowed = bestToken ? bestToken.allowedDomains.length === 0 || bestToken.allowedDomains.includes(hostname) : true;
     const isExempt = bestToken !== null && !bestToken.badgeRequired && domainAllowed;
     let careersPath = null;
-    function evaluateBadge() {
+    function reconcile() {
+      cancelPending();
       if (isExempt) {
         removeBadge();
         return;
       }
-      if (careersPath) {
-        if (pathMatches(window.location.pathname, careersPath)) {
-          injectBadge(position);
-        } else {
-          removeBadge();
-        }
-      } else {
-        if (!bestToken && cached) {
+      if (!careersPath) {
+        if (bestToken && cached) {
           const cacheAge = Date.now() - cached.cachedAt;
           if (cacheAge < GRACE_PERIOD_MS) {
             removeBadge();
             return;
           }
         }
-        injectBadge(position);
+        if (!document.getElementById(BADGE_ELEMENT_ID)) {
+          injectBadge(position, badgeContainer);
+        }
+        return;
+      }
+      const routeMatches = pathMatches(window.location.pathname, careersPath);
+      if (!routeMatches) {
+        removeBadge();
+        return;
       }
+      queueMicrotask(() => {
+        _rafHandle = requestAnimationFrame(() => {
+          _rafHandle = null;
+          const anchor = findBadgeAnchor(badgeContainer);
+          if (anchor) {
+            if (!document.getElementById(BADGE_ELEMENT_ID)) injectBadge(position, badgeContainer);
+            return;
+          }
+          waitForAnchor(badgeContainer, () => {
+            if (!document.getElementById(BADGE_ELEMENT_ID)) injectBadge(position, badgeContainer);
+          });
+        });
+      });
     }
-    evaluateBadge();
+    reconcile();
     installRouteWatcher();
-    _routeChangeCallbacks.push(evaluateBadge);
+    _routeChangeCallbacks.push(reconcile);
     setTimeout(async () => {
       var _a2, _b;
       try {
         const res = await fetch(`${baseUrl}/api/sdk/config?key=${encodeURIComponent(key)}`);
         if (!res.ok) return;
         const data = await res.json();
-        if (data.careersPath !== void 0) {
-          careersPath = data.careersPath;
-        }
+        if (data.careersPath !== void 0) careersPath = data.careersPath;
         if (data.badgeRequired) {
-          evaluateBadge();
+          reconcile();
           return;
         }
         if (data.badgeToken) {
@@ -316,13 +379,19 @@ var _Prodigio = class _Prodigio {
           if (refreshedClaims && !refreshedClaims.badgeRequired) {
             cacheToken(key, data.badgeToken, (_a2 = data.badgeExemptUntil) != null ? _a2 : "", (_b = data.configVersion) != null ? _b : 1);
             removeBadge();
+            return;
           }
         }
-        evaluateBadge();
+        reconcile();
       } catch {
       }
     }, 0);
   }
+  static destroy() {
+    cancelPending();
+    removeBadge();
+    _initialized = false;
+  }
 };
 // ── Badge static helpers ──────────────────────────────────────────────────
 _Prodigio.POWERED_BY = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prodigio-io/sdk",
-  "version": "2.1.4",
+  "version": "2.1.7",
   "description": "Official JavaScript SDK for the Prodigio hiring API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",