'+ ' ZoomInfo

'+ '

Need help?

'+ '

One of our support members will reach out!

'+ '

'+ ''+ '

'+ '

Thank you!

'+ '

We received your message and a support member will reach out shortly.

'+ '

'; document.body.appendChild(panel); // Toast var toast=document.createElement("div"); toast.id="zi-sw-toast"; document.body.appendChild(toast); var isOpen=false; var form=document.getElementById("zi-sw-form"); var nI=document.getElementById("zi-n"); var eI=document.getElementById("zi-m"); var qI=document.getElementById("zi-q"); var sub=document.getElementById("zi-sw-sub"); var okV=document.getElementById("zi-sw-ok"); function toggle(){ isOpen=!isOpen; panel.classList.toggle("zi-sw-open",isOpen); fab.setAttribute("aria-expanded",isOpen); if(isOpen){fab.innerHTML=icoX;fab.setAttribute("aria-label","Close support form");nI.focus();} else{fab.innerHTML=icoChat;fab.setAttribute("aria-label","Open support form");} } fab.addEventListener("click",toggle); document.addEventListener("keydown",function(e){if(e.key==="Escape"&&isOpen)toggle();}); document.addEventListener("mousedown",function(e){if(isOpen&&!panel.contains(e.target)&&e.target!==fab&&!fab.contains(e.target))toggle();}); function sErr(el,id){el.classList.add("zi-e");document.getElementById(id).style.display="block";} function cErr(el,id){el.classList.remove("zi-e");document.getElementById(id).style.display="none";} [nI,eI,qI].forEach(function(el){el.addEventListener("input",function(){if(el.value.trim())cErr(el,el.id+"-e");});}); function showToast(m){toast.textContent=m;toast.classList.add("zi-show");setTimeout(function(){toast.classList.remove("zi-show");},4000);} function setLoad(l){if(l){sub.disabled=true;sub.innerHTML='

Submitting...';}else{sub.disabled=false;sub.textContent="Submit";}} async function send(p){ try{var r=await fetch(C.webhook,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(p)});if(r.ok||r.status===202)return true;}catch(e){console.error("[ZI Widget] Submission failed.",e);} return false; } form.addEventListener("submit",async function(e){ e.preventDefault(); var v=true; if(!nI.value.trim()){sErr(nI,"zi-n-e");v=false;}else cErr(nI,"zi-n-e"); if(!eI.value.trim()||!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(eI.value.trim())){sErr(eI,"zi-m-e");v=false;}else cErr(eI,"zi-m-e"); if(!qI.value.trim()){sErr(qI,"zi-q-e");v=false;}else cErr(qI,"zi-q-e"); if(!v)return; setLoad(true); var ok=await send({name:nI.value.trim(),email:eI.value.trim(),message:qI.value.trim(),source:"docs-portal",page_url:window.location.href,submitted_at:new Date().toISOString()}); setLoad(false); if(ok){form.style.display="none";okV.style.display="block";setTimeout(function(){form.reset();form.style.display="block";okV.style.display="none";if(isOpen)toggle();},5000);} else showToast("Something went wrong. Please try again or email support directly."); }); })();(function () { const path = window.location.pathname; const isV11 = path.startsWith('/v1.1') || path.startsWith('/v1.1-staging'); if ( window.location.hostname !== 'docs.zoominfo.com' || !isV11 ) return; // ─── CONFIG ─────────────────────────────────────────────── const BASE_URL = 'https://docs.zoominfo.com'; const INDEX_URL = path.startsWith('/v1.1-staging') ? `${BASE_URL}/v1.1-staging/openapi` : `${BASE_URL}/v1.1/openapi`; const BETA_CLASS = 'readme-beta-pill'; const DEPRECATED_CLASS = 'readme-deprecated-pill'; // ─── STATE ─────────────────────────────────────────────── const betaOperations = new Set(); const deprecatedOperations = new Set(); const betaTags = new Set(); const deprecatedTags = new Set(); const allOpIdBySummary = {}; // ─── HELPERS ───────────────────────────────────────────── const normalize = s => (s || '').trim().toLowerCase(); function debounce(fn, delay = 150) { let t; return () => { clearTimeout(t); t = setTimeout(fn, delay); }; } function createPill(type) { const el = document.createElement('span'); if (type === 'beta') { el.className = BETA_CLASS; el.textContent = 'Beta'; el.style.cssText = ` display:inline-block; margin-left:8px; padding:0px 8px; font-size:10px; font-weight:700; border-radius:12px; background:#FFF3CD; color:#856404; border:1px solid #FFEEBA; `; } if (type === 'deprecated') { el.className = DEPRECATED_CLASS; el.textContent = 'Deprecated'; el.style.cssText = ` display:inline-block; margin-left:8px; padding:0px 8px; font-size:10px; font-weight:700; border-radius:12px; background:#F8D7DA; color:#721C24; border:1px solid #F5C6CB; `; } return el; } // ─── FETCH INDEX ───────────────────────────────────────── async function getAllSpecUrls() { const res = await fetch(INDEX_URL); const html = await res.text(); const matches = [...html.matchAll(/href="([^"]+\.yaml)"/g)]; return matches.map(m => BASE_URL + m[1]); } // ─── PARSER ───────────────────────────────────────────── function parseOps(spec) { const paths = spec?.paths || {}; const isGlobalBeta = spec?.['x-beta'] === true || spec?.['x-beta'] === 'true'; const isGlobalDeprecated = spec?.['x-deprecated'] === true || spec?.['x-deprecated'] === 'true'; const tagList = spec?.tags || []; const betaTagSet = new Set(); const deprecatedTagSet = new Set(); for (const tag of tagList) { const name = tag?.name; if (!name) continue; const normalized = normalize(name); if ( tag?.['x-beta'] === true || tag?.['x-beta'] === 'true' ) { betaTags.add(normalized); betaTagSet.add(normalized); } if ( tag?.['x-deprecated'] === true || tag?.['x-deprecated'] === 'true' ) { deprecatedTags.add(normalized); deprecatedTagSet.add(normalized); } } for (const [, pathItem] of Object.entries(paths)) { if (!pathItem || typeof pathItem !== 'object') continue; const methods = Object.keys(pathItem).filter(k => ['get','post','put','patch','delete','head','options'].includes(k) ); for (const method of methods) { const op = pathItem[method]; if (!op?.operationId) continue; const opId = String(op.operationId).toLowerCase(); if (typeof op.summary === 'string') { allOpIdBySummary[op.summary.trim().toLowerCase()] = opId; } const opTags = (op.tags || []).map(normalize); const hasBetaTag = opTags.some(t => betaTagSet.has(t)); const hasDeprecatedTag = opTags.some(t => deprecatedTagSet.has(t) ); const isBeta = isGlobalBeta || hasBetaTag || op?.['x-beta'] === true || op?.['x-beta'] === 'true'; const isDeprecated = isGlobalDeprecated || hasDeprecatedTag || op?.['x-deprecated'] === true || op?.['x-deprecated'] === 'true'; if (isBeta) { betaOperations.add(opId); } if (isDeprecated) { deprecatedOperations.add(opId); } } } } // ─── LOAD SPECS ───────────────────────────────────────── async function loadAllSpecs() { let urls; try { urls = await getAllSpecUrls(); } catch (e) { console.error('[badges] index fetch failed', e); return; } await Promise.all(urls.map(async (url) => { try { const res = await fetch(url); const text = await res.text(); let parsed; try { parsed = JSON.parse(text); } catch { return; } parseOps(parsed); } catch (e) { console.warn('[badges] fetch failed:', url, e); } })); } // ─── BADGE INSERTION ──────────────────────────────────── function appendBadge(link, type) { const target = link.querySelector('[class*="Sidebar-link-meta"]') || link; const firstSpan = target.querySelector('span'); const className = type === 'beta' ? BETA_CLASS : DEPRECATED_CLASS; if (link.querySelector(`.${className}`)) return; const pill = createPill(type); if (firstSpan) { firstSpan.insertAdjacentElement('afterend', pill); } else { target.appendChild(pill); } } function updateSidebarPills() { const links = document.querySelectorAll( 'a.rm-Sidebar-link[href*="/reference/"]' ); links.forEach(link => { const opId = link.href .match(/\/reference\/([^/?#]+)/i)?.[1] ?.toLowerCase(); if (!opId) return; if (betaOperations.has(opId)) { appendBadge(link, 'beta'); } if (deprecatedOperations.has(opId)) { appendBadge(link, 'deprecated'); } }); } function updateH1Pill() { const h1 = document.querySelector('h1'); if (!h1) return; const opId = location.pathname .match(/\/reference\/([^/?#]+)/i)?.[1] ?.toLowerCase(); if (!opId) return; if ( betaOperations.has(opId) && !h1.querySelector(`.${BETA_CLASS}`) ) { h1.appendChild(createPill('beta')); } if ( deprecatedOperations.has(opId) && !h1.querySelector(`.${DEPRECATED_CLASS}`) ) { h1.appendChild(createPill('deprecated')); } } function run() { updateSidebarPills(); updateH1Pill(); } // ─── OBSERVER ─────────────────────────────────────────── function observe() { const debounced = debounce(run, 200); new MutationObserver(() => debounced()) .observe(document.body, { childList: true, subtree: true }); } // ─── INIT ─────────────────────────────────────────────── async function init() { await loadAllSpecs(); run(); observe(); } if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', init); } else { init(); } })(); (function () { /** * ReadMe version-aware top nav visibility * - ReadMe top nav is global across versions. * - This script checks whether a nav item's rendered href actually exists * in the current version. * - If the page exists, show the nav item. * - If the page does not exist, hide the nav item. * This script checks whichever href ReadMe rendered. */ const VERSION_AWARE_NAV_ITEMS = [ { label: 'MCP', pathSuffix: 'docs/connect-zoominfo-mcp-coding-agent', /** * Optional but recommended. * This helps avoid false positives if ReadMe returns a generic app shell * or a soft 404 with a 200 status. * * Set this to text that should only exist on the real page. * If unsure, set to null. */ requiredText: null /** * If you want to be extra strict, use this instead: * requiredText: 'MCP' */ } ]; const CACHE = new Map(); let scheduled = false; function normalizePath(path) { return String(path || '').replace(/\/+$/, ''); } function getPrimaryNav() { return document.querySelector('nav[aria-label="Primary navigation"]'); } function getTopNavLinks() { const nav = getPrimaryNav(); if (!nav) return []; return Array.from(nav.querySelectorAll('a.rm-Header-bottom-link[href]')); } function getLinkText(link) { return link.textContent.trim().replace(/\s+/g, ' '); } function findNavLink(item) { return getTopNavLinks().find((link) => { const href = link.getAttribute('href') || ''; const text = getLinkText(link); return href.endsWith(item.pathSuffix) || text === item.label; }); } function pokeNavMeasure() { const nav = getPrimaryNav(); if (!nav) return; // ReadMe re-measures the active-tab underline on childList mutations // inside this nav; a transient comment node triggers that without // affecting layout. const ping = document.createComment('zi-nav-ping'); nav.appendChild(ping); ping.remove(); } function hideLink(link) { link.removeAttribute('data-version-nav-visible'); link.setAttribute('data-version-nav-hidden', 'true'); pokeNavMeasure(); } function showLink(link) { link.setAttribute('data-version-nav-visible', 'true'); link.removeAttribute('data-version-nav-hidden'); pokeNavMeasure(); } function looksLikeSoft404(html) { const doc = new DOMParser().parseFromString(html, 'text/html'); const title = doc.title || ''; const h1 = doc.querySelector('h1')?.textContent || ''; const bodyText = doc.body?.textContent || ''; const sample = `${title} ${h1} ${bodyText.slice(0, 3000)}`; return /page not found|404 not found|404|we couldn.?t find|could not find|doesn.?t exist|not available/i.test(sample); } async function pageExists(href, requiredText) { const url = new URL(href, window.location.origin); const cacheKey = url.toString(); if (CACHE.has(cacheKey)) { return CACHE.get(cacheKey); } try { const response = await fetch(url.toString(), { method: 'GET', credentials: 'same-origin', cache: 'no-store', redirect: 'follow' }); if (!response.ok) { CACHE.set(cacheKey, false); return false; } const requestedPath = normalizePath(url.pathname); const finalPath = normalizePath(new URL(response.url).pathname); // If the URL redirects somewhere else, treat it as missing. // This helps avoid showing nav items that bounce users away. if (requestedPath !== finalPath) { CACHE.set(cacheKey, false); return false; } const html = await response.text(); if (looksLikeSoft404(html)) { CACHE.set(cacheKey, false); return false; } if (requiredText && !html.includes(requiredText)) { CACHE.set(cacheKey, false); return false; } CACHE.set(cacheKey, true); return true; } catch (error) { // Fail closed: if we cannot confirm the page exists, hide the nav item. CACHE.set(cacheKey, false); return false; } } async function updateVersionAwareNav() { for (const item of VERSION_AWARE_NAV_ITEMS) { const link = findNavLink(item); if (!link) continue; // Hide immediately while checking to avoid showing broken nav briefly. hideLink(link); const href = link.getAttribute('href'); if (!href) continue; const exists = await pageExists(href, item.requiredText); if (exists) { showLink(link); } else { hideLink(link); } } // Helps ReadMe recalculate the active underline/tab position after hide/show. window.dispatchEvent(new Event('resize')); } function scheduleUpdate() { if (scheduled) return; scheduled = true; window.setTimeout(() => { scheduled = false; updateVersionAwareNav(); }, 150); } function patchHistoryMethod(methodName) { const original = history[methodName]; history[methodName] = function () { const result = original.apply(this, arguments); scheduleUpdate(); return result; }; } // Initial run. scheduleUpdate(); // Re-run when ReadMe swaps content/nav during client-side navigation. const observer = new MutationObserver(scheduleUpdate); observer.observe(document.body, { childList: true, subtree: true }); // Re-run on SPA navigation. patchHistoryMethod('pushState'); patchHistoryMethod('replaceState'); window.addEventListener('popstate', scheduleUpdate); // Re-run on normal load just in case. window.addEventListener('load', scheduleUpdate); })(); (function(){ "use strict"; if(window.__ziSupportWidgetInit) return; window.__ziSupportWidgetInit = true; var C={ webhook:"https://hook.us1.make.com/4fo9gm8jw4yxwblvpnwpwvwcp9hrbvwk", red:"#EA1815",navy:"#202B52",dark:"#010D39",sub:"#3F486B", light:"#F8F9FF",border:"#C8C8D8",white:"#FFFFFF", ok:"#128986",err:"#B2100B",purple:"#A109BA", font:"'Figtree',system-ui,-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif", z:2147483647 }; // Load Figtree if(!document.querySelector('link[href*="Figtree"]')){ var p1=document.createElement("link");p1.rel="preconnect";p1.href="https://fonts.googleapis.com";document.head.appendChild(p1); var p2=document.createElement("link");p2.rel="preconnect";p2.href="https://fonts.gstatic.com";p2.crossOrigin="anonymous";document.head.appendChild(p2); var fl=document.createElement("link");fl.rel="stylesheet";fl.href="https://fonts.googleapis.com/css2?family=Figtree:wght@400;500;600;700&display=swap";document.head.appendChild(fl); } var sty=document.createElement("style"); sty.textContent=` #zi-sw-fab{position:fixed;bottom:24px;right:24px;width:56px;height:56px;border-radius:50%;background:linear-gradient(135deg,${C.red},${C.purple});border:none;cursor:pointer;z-index:${C.z};display:flex;align-items:center;justify-content:center;box-shadow:0 4px 16px rgba(234,24,21,.35);transition:transform .2s,box-shadow .2s;outline:none} #zi-sw-fab:hover{transform:scale(1.08);box-shadow:0 6px 24px rgba(234,24,21,.45)} #zi-sw-fab:active{transform:scale(.96)} #zi-sw-fab svg{width:26px;height:26px;fill:${C.white};pointer-events:none} #zi-sw-panel{position:fixed;bottom:92px;right:24px;width:370px;background:${C.white};border-radius:16px;box-shadow:0 12px 48px rgba(0,13,57,.18),0 2px 8px rgba(0,0,0,.08);z-index:${C.z};font-family:${C.font};overflow:hidden;opacity:0;transform:translateY(16px) scale(.96);pointer-events:none;transition:opacity .25s,transform .25s} #zi-sw-panel.zi-sw-open{opacity:1;transform:translateY(0) scale(1);pointer-events:auto} #zi-sw-hdr{background:linear-gradient(135deg,${C.navy} 0%,#000514 100%);padding:24px 24px 20px;position:relative;overflow:hidden} #zi-sw-hdr::after{content:'';position:absolute;top:-30px;right:-30px;width:100px;height:100px;background:radial-gradient(circle,rgba(234,24,21,.25) 0%,transparent 70%);pointer-events:none} #zi-sw-hdr img{height:22px;margin-bottom:12px;display:block} #zi-sw-hdr p:first-of-type{color:${C.white};font-size:16px;font-weight:500;margin:0 0 4px;line-height:1.4} #zi-sw-hdr p:last-of-type{color:rgba(255,255,255,.7);font-size:13px;font-weight:400;margin:0;line-height:1.4} #zi-sw-body{padding:20px 24px 24px} .zi-sw-f{margin-bottom:16px} .zi-sw-f label{display:block;font-size:13px;font-weight:600;color:${C.dark};margin-bottom:6px;font-family:${C.font}} .zi-sw-f label .zi-r{color:${C.red};margin-left:2px} .zi-sw-f input,.zi-sw-f textarea{width:100%;padding:10px 12px;font-size:14px;font-family:${C.font};color:${C.dark};background:${C.light};border:1.5px solid ${C.border};border-radius:6px;outline:none;transition:border-color .15s,box-shadow .15s;box-sizing:border-box;-webkit-appearance:none} .zi-sw-f input:focus,.zi-sw-f textarea:focus{border-color:${C.navy};box-shadow:0 0 0 3px rgba(32,43,82,.1)} .zi-sw-f input.zi-e,.zi-sw-f textarea.zi-e{border-color:${C.err};box-shadow:0 0 0 3px rgba(178,16,11,.08)} .zi-sw-f textarea{resize:vertical;min-height:80px;max-height:140px;overflow-y:auto;scrollbar-width:thin;scrollbar-color:${C.border} transparent} .zi-sw-f textarea::-webkit-scrollbar{width:5px} .zi-sw-f textarea::-webkit-scrollbar-track{background:transparent;border-radius:4px} .zi-sw-f textarea::-webkit-scrollbar-thumb{background:${C.border};border-radius:4px} .zi-sw-f textarea::-webkit-scrollbar-thumb:hover{background:${C.sub}} .zi-em{font-size:12px;color:${C.err};margin-top:4px;display:none} #zi-sw-actions{display:flex;justify-content:flex-end} #zi-sw-sub{padding:10px 28px;font-size:15px;font-weight:600;font-family:${C.font};color:${C.white};background:${C.red};border:none;border-radius:6px;cursor:pointer;transition:background .15s,transform .1s;min-height:42px;line-height:1;display:inline-flex;align-items:center;justify-content:center;gap:8px;white-space:nowrap} #zi-sw-sub:hover{background:#c91412} #zi-sw-sub:active{transform:scale(.98)} #zi-sw-sub:disabled{background:${C.border};cursor:not-allowed;transform:none} .zi-sp{width:16px;height:16px;border:2.5px solid rgba(255,255,255,.3);border-top-color:${C.white};border-radius:50%;animation:zi-spin .6s linear infinite} @keyframes zi-spin{to{transform:rotate(360deg)}} #zi-sw-ok{display:none;text-align:center;padding:40px 24px} #zi-sw-ok .zi-ck{width:56px;height:56px;border-radius:50%;background:${C.ok};display:flex;align-items:center;justify-content:center;margin:0 auto 16px} #zi-sw-ok .zi-ck svg{width:28px;height:28px;fill:none;stroke:${C.white};stroke-width:3;stroke-linecap:round;stroke-linejoin:round} #zi-sw-ok h3{font-size:18px;font-weight:600;color:${C.dark};margin:0 0 8px} #zi-sw-ok p{font-size:14px;color:${C.sub};margin:0;line-height:1.5} #zi-sw-toast{position:fixed;bottom:100px;right:24px;background:${C.err};color:${C.white};font-family:${C.font};font-size:13px;font-weight:500;padding:10px 16px;border-radius:8px;z-index:${C.z+1};opacity:0;transform:translateY(8px);transition:opacity .2s,transform .2s;pointer-events:none;max-width:340px} #zi-sw-toast.zi-show{opacity:1;transform:translateY(0)} @media(max-width:420px){#zi-sw-panel{width:calc(100vw - 32px);right:16px;bottom:84px;max-height:calc(100vh - 120px)}#zi-sw-fab{bottom:16px;right:16px}} `; document.head.appendChild(sty); // FAB var fab=document.createElement("button"); fab.id="zi-sw-fab"; fab.setAttribute("aria-label","Open support form"); fab.setAttribute("title","Need help?"); var icoChat=''; var icoX=''; fab.innerHTML=icoChat; document.body.appendChild(fab); // Panel var panel=document.createElement("div"); panel.id="zi-sw-panel"; panel.setAttribute("role","dialog"); panel.setAttribute("aria-label","Support form"); panel.innerHTML= '

'+ ' ZoomInfo

'+ '

Need help?

'+ '

One of our support members will reach out!

'+ '

'+ ''+ '

'+ '

Thank you!

'+ '

We received your message and a support member will reach out shortly.

'+ '

Submitting...';}else{sub.disabled=false;sub.textContent="Submit";}} async function send(p){ try{var r=await fetch(C.webhook,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(p)});if(r.ok||r.status===202)return true;}catch(e){console.error("[ZI Widget] Submission failed.",e);} return false; } form.addEventListener("submit",async function(e){ e.preventDefault(); var v=true; if(!nI.value.trim()){sErr(nI,"zi-n-e");v=false;}else cErr(nI,"zi-n-e"); if(!eI.value.trim()||!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(eI.value.trim())){sErr(eI,"zi-m-e");v=false;}else cErr(eI,"zi-m-e"); if(!qI.value.trim()){sErr(qI,"zi-q-e");v=false;}else cErr(qI,"zi-q-e"); if(!v)return; setLoad(true); var ok=await send({name:nI.value.trim(),email:eI.value.trim(),message:qI.value.trim(),source:"docs-portal",page_url:window.location.href,submitted_at:new Date().toISOString()}); setLoad(false); if(ok){form.style.display="none";okV.style.display="block";setTimeout(function(){form.reset();form.style.display="block";okV.style.display="none";if(isOpen)toggle();},5000);} else showToast("Something went wrong. Please try again or email support directly."); }); })(); (function () { 'use strict'; // ============================================================ // CONFIG // ============================================================ const BASE_URL = 'https://docs.gtm.ai'; const BETA_CLASS = 'readme-beta-pill'; const DEPRECATED_CLASS = 'readme-deprecated-pill'; const METHODS = [ 'get', 'post', 'put', 'patch', 'delete', 'head', 'options' ]; // ============================================================ // STATE // ============================================================ const betaOperations = new Set(); const deprecatedOperations = new Set(); let specsLoaded = false; let specsLoading = false; let lastOperation = null; let renderTimer = null; // ============================================================ // HELPERS // ============================================================ function normalize(value) { return String(value || '') .trim() .toLowerCase(); } function isTrue(value) { return value === true || value === 'true'; } function getPath() { return window.location.pathname; } function isSupportedPage() { if (window.location.hostname !== 'docs.gtm.ai') { return false; } const path = getPath(); return ( path === '/reference' || path.startsWith('/reference/') || path === '/v1.1/reference' || path.startsWith('/v1.1/reference/') || path === '/v1.1-staging/reference' || path.startsWith('/v1.1-staging/reference/') ); } function isReferenceHome() { const path = getPath(); return ( path === '/reference' || path === '/reference/' || path === '/v1.1/reference' || path === '/v1.1/reference/' || path === '/v1.1-staging/reference' || path === '/v1.1-staging/reference/' ); } function getOperationId() { const match = getPath().match( /\/reference\/([^/?#]+)/i ); if (!match) { return null; } return decodeURIComponent(match[1]) .trim() .toLowerCase(); } // ============================================================ // BADGES // ============================================================ function createBadge(type) { const badge = document.createElement('span'); if (type === 'beta') { badge.className = BETA_CLASS; badge.textContent = 'Beta'; badge.style.cssText = ` display:inline-block; margin-left:8px; padding:0 8px; font-size:10px; font-weight:700; line-height:18px; height:18px; border-radius:12px; background:#FFF3CD; color:#856404; border:1px solid #FFEEBA; vertical-align:middle; white-space:nowrap; box-sizing:border-box; `; } if (type === 'deprecated') { badge.className = DEPRECATED_CLASS; badge.textContent = 'Deprecated'; badge.style.cssText = ` display:inline-block; margin-left:8px; padding:0 8px; font-size:10px; font-weight:700; line-height:18px; height:18px; border-radius:12px; background:#F8D7DA; color:#721C24; border:1px solid #F5C6CB; vertical-align:middle; white-space:nowrap; box-sizing:border-box; `; } return badge; } // ============================================================ // OPENAPI // ============================================================ function getIndexUrl() { if ( getPath().startsWith('/v1.1-staging') ) { return `${BASE_URL}/v1.1-staging/openapi?json=on`; } return `${BASE_URL}/openapi?json=on`; } async function getSpecUrls() { const response = await fetch( getIndexUrl(), { cache: 'no-store' } ); if (!response.ok) { throw new Error( `OpenAPI index failed: ${response.status}` ); } const html = await response.text(); const matches = [ ...html.matchAll( /href=["']([^"']+\.ya?ml[^"']*)["']/gi ) ]; return matches.map(match => new URL( match[1], BASE_URL ).href ); } function parseSpec(spec) { if (!spec || typeof spec !== 'object') { return; } const globalBeta = isTrue(spec['x-beta']); const globalDeprecated = isTrue(spec['x-deprecated']); const betaTags = new Set(); const deprecatedTags = new Set(); // ---------------------------------------------------------- // TAGS // ---------------------------------------------------------- for (const tag of spec.tags || []) { if (!tag || !tag.name) { continue; } const name = normalize(tag.name); if (isTrue(tag['x-beta'])) { betaTags.add(name); } if (isTrue(tag['x-deprecated'])) { deprecatedTags.add(name); } } // ---------------------------------------------------------- // OPERATIONS // ---------------------------------------------------------- const paths = spec.paths || {}; for (const pathItem of Object.values(paths)) { if ( !pathItem || typeof pathItem !== 'object' ) { continue; } for (const method of METHODS) { const operation = pathItem[method]; if ( !operation || typeof operation !== 'object' ) { continue; } if (!operation.operationId) { continue; } const operationId = normalize(operation.operationId); const tags = ( Array.isArray(operation.tags) ? operation.tags : [] ).map(normalize); const beta = globalBeta || tags.some(tag => betaTags.has(tag)) || isTrue(operation['x-beta']); const deprecated = globalDeprecated || tags.some(tag => deprecatedTags.has(tag)) || isTrue(operation['x-deprecated']); if (beta) { betaOperations.add(operationId); } if (deprecated) { deprecatedOperations.add(operationId); } } } } async function loadSpecs() { if (specsLoaded || specsLoading) { return; } specsLoading = true; try { const urls = await getSpecUrls(); console.log( '[badges] Loading', urls.length, 'spec files' ); await Promise.all( urls.map(async url => { try { const response = await fetch( url, { cache: 'no-store' } ); if (!response.ok) { return; } const text = await response.text(); let spec; try { spec = JSON.parse(text); } catch { console.warn( '[badges] Invalid JSON:', url ); return; } parseSpec(spec); } catch (error) { console.warn( '[badges] Failed:', url, error ); } }) ); specsLoaded = true; console.log( '[badges] Beta operations:', [...betaOperations] ); console.log( '[badges] Deprecated operations:', [...deprecatedOperations] ); } catch (error) { console.error( '[badges] Spec loading error:', error ); } finally { specsLoading = false; } } // ============================================================ // H1 // ============================================================ function renderH1() { const h1 = document.querySelector('h1'); if (!h1) { return false; } /* * Remove ONLY our badges. */ h1.querySelectorAll( `.${BETA_CLASS}, .${DEPRECATED_CLASS}` ).forEach(el => { el.remove(); }); /* * Reference landing page. */ if (isReferenceHome()) { h1.appendChild( createBadge('beta') ); return true; } const operationId = getOperationId(); if (!operationId) { return false; } /* * DEBUG */ console.log( '[badges] Rendering H1:', operationId, 'beta:', betaOperations.has(operationId), 'deprecated:', deprecatedOperations.has(operationId) ); if (betaOperations.has(operationId)) { h1.appendChild( createBadge('beta') ); return true; } if ( deprecatedOperations.has(operationId) ) { h1.appendChild( createBadge('deprecated') ); return true; } return true; } // ============================================================ // SIDEBAR // ============================================================ function renderSidebar() { const links = document.querySelectorAll( 'a.rm-Sidebar-link[href*="/reference/"]' ); links.forEach(link => { const href = link.getAttribute('href'); if (!href) { return; } const match = href.match( /\/reference\/([^/?#]+)/i ); if (!match) { return; } const operationId = decodeURIComponent(match[1]) .trim() .toLowerCase(); const target = link.querySelector( '[class*="Sidebar-link-meta"]' ) || link; /* * Remove our existing badges. */ target .querySelectorAll( `.${BETA_CLASS}, .${DEPRECATED_CLASS}` ) .forEach(el => el.remove()); let type = null; if ( betaOperations.has(operationId) ) { type = 'beta'; } else if ( deprecatedOperations.has(operationId) ) { type = 'deprecated'; } if (!type) { return; } const badge = createBadge(type); const span = target.querySelector('span'); if (span) { span.insertAdjacentElement( 'afterend', badge ); } else { target.appendChild(badge); } }); } // ============================================================ // RENDER // ============================================================ function render() { if (!isSupportedPage()) { return; } renderH1(); renderSidebar(); } // ============================================================ // WAIT FOR README // ============================================================ function renderRepeatedly() { /* * ReadMe can take several rendering passes. * * Instead of reacting to every mutation, * render at controlled intervals. */ const delays = [ 0, 100, 250, 500, 800, 1200, 1800, 2500 ]; delays.forEach(delay => { setTimeout(() => { render(); }, delay); }); } // ============================================================ // DETECT PAGE CHANGE // ============================================================ function checkPage() { const operation = isReferenceHome() ? '__REFERENCE_HOME__' : getOperationId(); /* * This is more important than URL detection. * * We care about which operation ReadMe is showing. */ if (operation === lastOperation) { return; } console.log( '[badges] PAGE CHANGED:', lastOperation, '=>', operation ); lastOperation = operation; renderRepeatedly(); } // ============================================================ // POLL THE CURRENT PAGE // ============================================================ /* * We intentionally poll the operation identity. * * This works even when ReadMe's router does not expose * a reliable navigation event. */ setInterval(() => { checkPage(); }, 200); // ============================================================ // CLICK DETECTION // ============================================================ document.addEventListener( 'click', event => { const link = event.target.closest( 'a[href*="/reference/"]' ); if (!link) { return; } /* * Let ReadMe navigate first. */ setTimeout( checkPage, 50 ); setTimeout( checkPage, 200 ); setTimeout( checkPage, 500 ); setTimeout( checkPage, 1000 ); setTimeout( renderRepeatedly, 200 ); }, true ); // ============================================================ // HISTORY // ============================================================ const pushState = history.pushState; history.pushState = function () { const result = pushState.apply( this, arguments ); setTimeout( checkPage, 50 ); return result; }; const replaceState = history.replaceState; history.replaceState = function () { const result = replaceState.apply( this, arguments ); setTimeout( checkPage, 50 ); return result; }; window.addEventListener( 'popstate', () => { setTimeout( checkPage, 50 ); setTimeout( renderRepeatedly, 100 ); } ); // ============================================================ // MUTATION OBSERVER // ============================================================ /* * IMPORTANT: * * We DO NOT render immediately on every mutation. * * ReadMe's React rendering can cause many mutations. */ let observerTimer = null; const observer = new MutationObserver(() => { clearTimeout(observerTimer); observerTimer = setTimeout(() => { checkPage(); /* * If ReadMe just replaced the page, * render after its DOM settles. */ render(); }, 250); }); function startObserver() { if (!document.documentElement) { return; } observer.observe( document.documentElement, { childList: true, subtree: true } ); } // ============================================================ // INIT // ============================================================ async function init() { console.log( '[badges] INIT:', location.href ); startObserver(); await loadSpecs(); /* * Establish current operation. */ lastOperation = isReferenceHome() ? '__REFERENCE_HOME__' : getOperationId(); /* * Initial page. */ renderRepeatedly(); } if ( document.readyState === 'loading' ) { document.addEventListener( 'DOMContentLoaded', init, { once: true } ); } else { init(); } })(); (function () { const SIDEBAR = 'nav.rm-Sidebar'; const HEADING = 'button[class*="Sidebar-heading_collapsible"]'; const isOpen = (el) => /expand/i.test(el.getAttribute('class') || ''); let busy = false; // guard so our own clicks don't cascade function collapseOthers(opened) { if (busy) return; busy = true; const scope = opened.closest(SIDEBAR) || document; scope.querySelectorAll(HEADING).forEach((other) => { if (other === opened || !isOpen(other)) return; if (other.contains(opened) || opened.contains(other)) return; // don't close a parent/child other.click(); // let ReadMe run its own collapse }); // release after the DOM settles requestAnimationFrame(() => { busy = false; }); } new MutationObserver((muts) => { for (const m of muts) { if (m.attributeName !== 'class') continue; const el = m.target; if (!el.matches || !el.matches(HEADING)) continue; if (!isOpen(el)) continue; // only react when a category becomes open const was = /expand/i.test(m.oldValue || ''); if (was) continue; // it was already open; ignore restyle noise collapseOthers(el); } }).observe(document.body, { subtree: true, attributes: true, attributeOldValue: true, // needed to tell "just opened" from "already open" attributeFilter: ['class'], }); })();

Recipes