/* ======================================================================================= SPA-SAFE DOM PATCHES (install-once) - Guards against NotFoundError (code 8) crashes from insertBefore/removeChild - Patches Node.prototype (covers Element, Document, DocumentFragment, etc.) - Re-asserts the patch a few times in case other scripts overwrite methods ======================================================================================= */ (function () { if (typeof window === 'undefined' || typeof Node === 'undefined' || !Node.prototype) return; const KEY = '__RM_SPA_SAFE_DOM_PATCHES__'; const state = window[KEY] || (window[KEY] = {}); // Capture originals once (avoid wrapping wrappers) const NP = Node.prototype; if (!state.originalInsertBefore) state.originalInsertBefore = NP.insertBefore; if (!state.originalRemoveChild) state.originalRemoveChild = NP.removeChild; const _insertBefore = state.originalInsertBefore; const _removeChild = state.originalRemoveChild; function isNotFound(err) { return !!(err && (err.name === 'NotFoundError' || err.code === 8)); } function safeInsertBefore(newNode, referenceNode) { if (!newNode) return newNode; if (referenceNode == null) { try { return _insertBefore.call(this, newNode, null); } catch (err) { if (isNotFound(err)) { try { return this.appendChild(newNode); } catch { return newNode; } } throw err; } } if (referenceNode.parentNode !== this) { try { return this.appendChild(newNode); } catch { return newNode; } } try { return _insertBefore.call(this, newNode, referenceNode); } catch (err) { if (isNotFound(err)) { try { return this.appendChild(newNode); } catch { return newNode; } } throw err; } } function safeRemoveChild(child) { if (!child || child.parentNode !== this) return child || null; try { return _removeChild.call(this, child); } catch (err) { if (isNotFound(err)) return child; throw err; } } function install() { if (NP.insertBefore !== safeInsertBefore) NP.insertBefore = safeInsertBefore; if (NP.removeChild !== safeRemoveChild) NP.removeChild = safeRemoveChild; state.installed = true; } install(); setTimeout(install, 0); setTimeout(install, 250); setTimeout(install, 1000); })(); /* ===== No-op debug helpers (silence logs without touching callsites) ===== */ (function () { window.__DBG = function () {}; window.__GROUP = function () {}; window.__END = function () {}; })(); // ---------------- ASK AI Button Changes ---------------- *CONFIRMED REFACTORED $(window).on('pageLoad', function() { __GROUP('ASK_AI', 'pageLoad'); const aiToggle = document.querySelector('.AIDropdowngihKW2xXVnay .Dropdown-toggle'); __DBG('ASK_AI', 'aiToggle found?', !!aiToggle, aiToggle); if (!aiToggle) { __END(); return; } aiToggle.addEventListener('click', () => { __GROUP('ASK_AI', 'aiToggle click'); setTimeout(() => { __GROUP('ASK_AI', 'setTimeout 300ms'); const menu = document.querySelector('.tippy-content .Menu'); __DBG('ASK_AI', 'menu found?', !!menu, menu); __DBG('ASK_AI', '__aiNoticeInjected?', menu?.dataset?.__aiNoticeInjected); if (!menu || menu.dataset.__aiNoticeInjected) { __END(); __END(); __END(); return; } try { const notice = document.createElement('div'); notice.className = 'AskAI_Alert'; notice.style.opacity = '.8'; notice.style.padding = '5px 10px'; notice.style.fontSize = '11px'; notice.style.fontWeight = '300'; notice.textContent = ' Some tools may require login.'; const emoji = document.createElement('span'); emoji.textContent = '⚠︎'; emoji.style.fontSize = '13px'; emoji.style.lineHeight = '1.1'; emoji.style.marginRight = '3px'; __DBG('ASK_AI', 'pre-insertBefore emoji into notice', { notice, emoji }); notice.insertBefore(emoji, notice.firstChild); __DBG('ASK_AI', 'pre-insertBefore notice into menu', { menu, menuFirst: menu.firstChild, notice }); menu.insertBefore(notice, menu.firstChild); menu.dataset.__aiNoticeInjected = 'true'; if (aiToggle._tippy) { __DBG('ASK_AI', 'tippy popperInstance.update()'); aiToggle._tippy.popperInstance.update(); } } finally { __END(); // setTimeout __END(); // click __END(); // pageLoad } }, 300); }); }); // ---------------- Sidebar Button to Expand/Collapse ---------------- *CONFIRMED REFACTORED function fireLocationChange(){ __DBG('EXPAND_SIDEBAR', 'fireLocationChange'); window.dispatchEvent(new Event('locationchange')); } const _pushState = history.pushState; history.pushState = function(){ __DBG('EXPAND_SIDEBAR', 'history.pushState', arguments); _pushState.apply(this, arguments); fireLocationChange(); }; const _replaceState = history.replaceState; history.replaceState = function(){ __DBG('EXPAND_SIDEBAR', 'history.replaceState', arguments); _replaceState.apply(this, arguments); fireLocationChange(); }; window.addEventListener('popstate', () => { __DBG('EXPAND_SIDEBAR', 'popstate'); fireLocationChange(); }); var expandAllInt; var expanded = false; document.addEventListener("DOMContentLoaded", function () { __GROUP('EXPAND_SIDEBAR', 'DOMContentLoaded'); var addExpandAll = $('.hub-sidebar-content').length > 0; __DBG('EXPAND_SIDEBAR', 'addExpandAll?', addExpandAll, 'sidebar count:', $('.hub-sidebar-content').length); if (addExpandAll) { expandAllInt = setInterval(function() { const done = checkExpandUpdate(); __DBG('EXPAND_SIDEBAR', 'interval tick; has pill?', done); if (done) { clearInterval(expandAllInt); } else { addExpandBtn(); } }, 800); } __END(); }); $(window).on('pageLoad', function () { __GROUP('EXPAND_SIDEBAR', 'pageLoad'); expanded = false; __DBG('EXPAND_SIDEBAR', 'reset expanded = false; has pill?', $('.expand-all-pill').length); if (!$('.expand-all-pill').length) { addExpandBtn(); } __END(); }); function checkExpandUpdate() { const exists = $('.expand-all-pill').length > 0; __DBG('EXPAND_SIDEBAR', 'checkExpandUpdate()', exists); return exists; } function addExpandBtn() { __GROUP('EXPAND_SIDEBAR', 'addExpandBtn'); if ($('.expand-all-pill').length) { __END(); return; } const pill = document.createElement('button'); pill.className = 'expand-all-pill'; pill.type = 'button'; pill.setAttribute('aria-expanded', 'false'); pill.innerHTML = `Expand All`; pill.addEventListener('click', (e) => { __GROUP('EXPAND_SIDEBAR', 'pill click'); e.preventDefault(); e.stopPropagation(); updateExpandBtn(); updateSideMenu(); __END(); }); if ($('.hub-sidebar-content').length) { $('.hub-sidebar-content').prepend(pill); } __END(); } function updateExpandBtn() { __GROUP('EXPAND_SIDEBAR', 'updateExpandBtn'); expanded = !expanded; $('.expand-all-pill').attr('aria-expanded', String(expanded)); $('.expand-all-pill i') .toggleClass('fa-expand-alt', !expanded) .toggleClass('fa-compress-alt', expanded); $('.expand-all-pill span').text(expanded ? 'Collapse All' : 'Expand All'); __END(); } function toggleSection(toggleBtn, shouldExpand) { __GROUP('EXPAND_SIDEBAR', 'toggleSection', false); __DBG('EXPAND_SIDEBAR', 'toggleBtn', toggleBtn, 'shouldExpand', shouldExpand); toggleBtn.setAttribute('aria-expanded', String(shouldExpand)); const hdr = toggleBtn.closest('h2'); if (!hdr) { __END(); return; } const next = hdr.nextElementSibling; if (next && next.tagName === 'UL') { next.style.display = shouldExpand ? '' : 'none'; } __END(); } function updateSideMenu() { __GROUP('EXPAND_SIDEBAR', 'updateSideMenu'); const nav = document.getElementById('hub-sidebar') || document.querySelector('.hub-sidebar-content'); if (!nav) { __END(); return; } const headings = nav.querySelectorAll('section h2'); headings.forEach(function(h2){ const btn = h2.querySelector('button[aria-expanded]'); if (!btn) return; const isExpanded = btn.getAttribute('aria-expanded') === 'true'; if (isExpanded !== expanded) { toggleSection(btn, expanded); } }); __END(); } window.addEventListener('locationchange', () => { __DBG('EXPAND_SIDEBAR', 'locationchange -> reset expanded=false'); expanded = false; }); // ---------------- Hide Recipes if version does not match v1.0.0-CMS-SaaS ---------------- *CONFIRMED REFACTORED document.addEventListener('DOMContentLoaded', () => { __GROUP('RECIPES_HIDE', 'DOMContentLoaded'); if (window.location.pathname.includes('/content-management-system/')) { const observer = new MutationObserver(() => { const dropdown = document.querySelector('.Dropdown-content.Dropdown-content_opened'); if (dropdown) { const version = window.location.pathname.split('/')[2]; if (version !== 'v1.0.0-CMS-SaaS') { const recipesLink = dropdown.querySelector('a[href*="recipes"]'); if (recipesLink) { recipesLink.style.display = 'none'; } } } }); observer.observe(document.body, { childList: true, subtree: true }); } __END(); }); /* ---------------- AI CUSTOM SEARCH + SUBMIT TICKET (HARDENED) ---------------- */ (function () { const inIframe = (() => { try { return top !== self; } catch { return true; } })(); const referrer = document.referrer || ""; const refOrigin = (() => { try { return new URL(referrer).origin; } catch { return ""; } })(); const sameOriginParent = refOrigin && refOrigin === location.origin; const isEditorReferrer = /(?:readme\.io|docs\.readme\.com)\/.*(?:editor|project|dashboard)/i.test(referrer); const hasEditorDom = !!document.querySelector('[data-readme-editor], .rm-Editor, .rm-EditorRoot'); if (inIframe && !sameOriginParent && (isEditorReferrer || hasEditorDom)) return; var searchChangeInt; if (window.__AI_SEARCH_INIT__) return; window.__AI_SEARCH_INIT__ = true; document.addEventListener("DOMContentLoaded", function () { __GROUP && __GROUP('AI_SEARCH', 'DOMContentLoaded'); var addSearch = false; if (window.jQuery && jQuery('#enterprise').length > 0) { addSearch = true; } else if (!document.body.classList.contains('hub-is-home')) { addSearch = true; } if (addSearch) { searchChangeInt = setInterval(function () { const ready = checkSearchUpdate(); if (ready) { clearInterval(searchChangeInt); searchChangeInt = null; } else { changeSearch(); } }, 800); } updateSubmitTicket(); __END && __END(); }); })(); /* ---------------- Helpers ---------------- */ function loadGabOnce() { if (window.WIZ_gab_global_data) return; if (document.querySelector('script[data-gab-client]')) return; var s = document.createElement("script"); s.type = "text/javascript"; s.async = true; s.src = "https://cloud.google.com/ai/gen-app-builder/client?hl=en_US"; s.setAttribute('data-gab-client', '1'); s.addEventListener('load', function () { try { if (window.customElements && window.customElements.whenDefined) { customElements.whenDefined('gen-search-widget') .then(function () { try { initNewTabEnforcer(); } catch (e) { console.warn('[AI_SEARCH] initNewTabEnforcer error', e); } }); } else { try { initNewTabEnforcer(); } catch (e) { console.warn('[AI_SEARCH] initNewTabEnforcer error', e); } } } catch (e) { console.warn('[AI_SEARCH] onload handling error', e); } }); document.head.appendChild(s); } function updateSubmitTicket() { __GROUP && __GROUP('AI_SEARCH', 'updateSubmitTicket'); var $a = $("a[href='https://support.optimizely.com/hc/en-us/requests/new']"); var submitLink = $a.attr("href"); submitLink = submitLink + "?tf_360048844131=" + window.location.href; $a.attr("href", submitLink); __END && __END(); } /* ---------------- Main UI injection (idempotent) ---------------- */ function changeSearch() { __GROUP && __GROUP('AI_SEARCH', 'changeSearch'); if (document.getElementById('searchWidgetTrigger') || document.querySelector('gen-search-widget')) { __END && __END(); return; } $('.rm-SearchToggle-placeholder').text("Search developer docs"); $('.Header-searchtb6Foi0-D9Vx').prepend('

'); $('#ssr-top').prepend(''); $('.Header-searchtb6Foi0-D9Vx').prepend('AI OnAI Off'); $('.Header-searchtb6Foi0-D9Vx').prepend('

Optimizely developer documentation

How can we help you?

'); if (localStorage.getItem("aiSearch") === "off") { toggleSearch(); } searchToggleState(); $(document).off('click.aiSearchToggle').on('click.aiSearchToggle', '.search-toggle', function () { toggleSearch(); searchToggleState(); }); loadGabOnce(); __END && __END(); } function checkSearchUpdate() { var hasTrigger = !!document.getElementById('searchWidgetTrigger'); var hasWidget = !!document.querySelector('gen-search-widget'); var updated = hasTrigger && hasWidget; __DBG && __DBG('AI_SEARCH', 'checkSearchUpdate()', updated, 'trigger?', hasTrigger, 'widget?', hasWidget); return updated; } function searchToggleState() { const isOff = $(".search-toggle").hasClass("off"); if (isOff) window.localStorage.setItem("aiSearch", "off"); else window.localStorage.setItem("aiSearch", "on"); } function toggleSearch() { $(".search-toggle").toggleClass("off"); $('.Header-searchtb6Foi0-D9Vx .newSearch').toggle(); $('.Header-searchtb6Foi0-D9Vx .rm-SearchToggle').toggleClass("searchFlex"); } /* =========================== NEW: External link enforcer =========================== */ function initNewTabEnforcer() { const isExternal = (href) => { try { const u = new URL(href, location.href); return u.origin !== location.origin; } catch { return false; } }; const hardenAnchor = (a) => { if (!a || !a.href) return; if (!isExternal(a.href)) return; if (a.dataset.allowIframe != null || a.classList?.contains('allow-iframe')) return; a.target = '_blank'; a.rel = 'noopener noreferrer'; a.__newTabBound = true; }; const scan = (root) => { if (!root) return; root.querySelectorAll?.('a[href]').forEach(hardenAnchor); root.querySelectorAll?.('*').forEach((el) => { if (el.shadowRoot) { try { el.shadowRoot.querySelectorAll('a[href]').forEach(hardenAnchor); } catch {} observe(el.shadowRoot); } }); }; const observe = (root) => { try { const mo = new MutationObserver(() => scan(root)); mo.observe(root, { childList: true, subtree: true, attributes: true, attributeFilter: ['href'] }); window.__aiSearchNewTabMOs = window.__aiSearchNewTabMOs || []; window.__aiSearchNewTabMOs.push(mo); } catch (e) { console.warn('[AI_SEARCH:newtab] observer error', e); } }; const widget = document.querySelector('gen-search-widget'); const containers = [widget, document].filter(Boolean); containers.forEach((c) => { scan(c instanceof Document ? c : (c.shadowRoot || c)); observe(c instanceof Document ? c : (c.shadowRoot || c)); }); if (widget) { const tryLate = () => { scan(widget); if (widget.shadowRoot) scan(widget.shadowRoot); }; setTimeout(tryLate, 250); setTimeout(tryLate, 1000); setTimeout(tryLate, 2000); } try { __DBG && __DBG('AI_SEARCH', 'initNewTabEnforcer attached'); } catch {} } // ---------------- Collapsible left navigation menu ---------------- *CONFIRMED REFACTORED function initializeSidebarToggles() { __GROUP('SIDEBAR_COLLAPSE', 'initializeSidebarToggles'); const categoryHeadings = document.querySelectorAll('.rm-Sidebar-heading'); categoryHeadings.forEach((heading) => { const hasBtn = !!heading.querySelector('button'); if (hasBtn) return; const button = document.createElement('button'); button.className = 'category-toggle'; button.setAttribute('aria-expanded', 'false'); button.textContent = heading.textContent; heading.textContent = ''; heading.appendChild(button); const content = heading.nextElementSibling; if (content) content.style.display = 'none'; button.addEventListener('click', function () { __GROUP('SIDEBAR_COLLAPSE', 'button click'); const isExpanded = button.getAttribute('aria-expanded') === 'true'; button.setAttribute('aria-expanded', String(!isExpanded)); if (content) content.style.display = isExpanded ? 'none' : 'block'; __END(); }); }); markActiveHeadings(); __END(); } function markActiveHeadings() { __GROUP('SIDEBAR_COLLAPSE', 'markActiveHeadings'); const sections = document.querySelectorAll('.rm-Sidebar-section'); sections.forEach((section) => { const heading = section.querySelector('.rm-Sidebar-heading'); const hasActiveLink = section.querySelector('li a.active') !== null; if (heading) { if (hasActiveLink) heading.classList.add('active-heading'); else heading.classList.remove('active-heading'); } }); __END(); } function expandTopLevelCategory() { __GROUP('SIDEBAR_COLLAPSE', 'expandTopLevelCategory'); const activeLink = document.querySelector('.rm-Sidebar-link.active'); if (activeLink) { const categoryToggle = activeLink.closest('.rm-Sidebar-section')?.querySelector('.category-toggle'); if (categoryToggle) { const isExpanded = categoryToggle.getAttribute('aria-expanded') === 'true'; if (!isExpanded) { categoryToggle.dispatchEvent(new MouseEvent('click', { bubbles: true, cancelable: true, view: window })); } } } markActiveHeadings(); __END(); } function monitorRouteChanges() { __GROUP('SIDEBAR_COLLAPSE', 'monitorRouteChanges start'); let t = null; const rerun = () => { if (t) clearTimeout(t); t = setTimeout(() => { requestAnimationFrame(() => { if (location.href.includes('/docs/') || location.href.includes('/reference/')) { initializeSidebarToggles(); expandTopLevelCategory(); } }); }, 80); }; window.addEventListener('locationchange', rerun); window.addEventListener('pageLoad', rerun); } document.addEventListener('DOMContentLoaded', () => { __GROUP('SIDEBAR_COLLAPSE', 'DOMContentLoaded root init'); if (location.href.includes('/docs/') || location.href.includes('/reference/')) { initializeSidebarToggles(); expandTopLevelCategory(); monitorRouteChanges(); } __END(); }); $(window).on('pageLoad', function () { __GROUP('SIDEBAR_COLLAPSE', 'pageLoad init'); if (location.href.includes('/docs/') || location.href.includes('/reference/')) { initializeSidebarToggles(); expandTopLevelCategory(); } __END(); }); // ---------------- Metrics patch ---------------- $(window).on('pageLoad', function(e, state) { __GROUP('METRICS_PATCH', 'pageLoad'); setTimeout(() => { __GROUP('METRICS_PATCH', 'setTimeout 1000ms'); if (window.fetch.__versionPatched) { __END(); __END(); return; } window.fetch.__versionPatched = true; const originalFetch = window.fetch; window.fetch = async (input, init) => { __GROUP('METRICS_PATCH', 'fetch call', false); if (typeof input === 'string' && input.includes('/metrics-proxy/create/thumb')) { try { if (init && init.method === 'POST' && init.body) { const payload = JSON.parse(init.body); let versionRaw = document.querySelector('meta[name="readme-version"]')?.content; if (!versionRaw) { const m = window.location.pathname.match(/\/v([^/]+)\//); versionRaw = m ? m[1] : 'main'; } const version = `v${versionRaw}`; let cleanPath = payload.path .replace(new RegExp(`^(/v[\\w.-]+)+/`), '') .replace(/^\/+/, ''); payload.path = `/${version}/${cleanPath}`; init.body = JSON.stringify(payload); } } catch (err) { console.error('[metrics] error modifying payload', err); __END(); throw err; } } const res = await originalFetch(input, init); __END(); return res; }; __END(); __END(); }, 1000); }); // ---------------- Custom Download Spec File Button ---------------- *CONFIRMED REFACTORED (function () { /* ================= CONFIG ================= */ const DEBUG = /\boasdebug=1\b/i.test(location.search); const ERROR_MIN_DELAY_MS = 5000; const log = (...a) => DEBUG && console.log('[oas-link]', ...a); /* ================= STATE ================= */ if (window.__OAS_DL_INIT__) return; window.__OAS_DL_INIT__ = true; const SPEC_CACHE = new Map(); const BEST_CACHE = new Map(); let currentAbort = null; let runTimer = null; let lastCtxKey = null; let loadSeq = 0; const fbTimers = new Map(); let activeCtxKey = null; let activeLoadId = null; // NEW: Reduce console spam from api-next probes by caching 404 misses. // This doesn't stop the first 404, but it prevents repeating them on every SPA nav. const APINEXT_URL_MISS = new Set(); // url -> 404 seen const APINEXT_BASE_DISABLED = new Map(); // projectRoot -> { v1: bool, v2: bool } function getBaseState(root) { const mem = APINEXT_BASE_DISABLED.get(root); if (mem) return mem; try { const raw = sessionStorage.getItem(`__RM_APINEXT_BASE_DISABLED__:${root}`); if (raw) { const parsed = JSON.parse(raw); APINEXT_BASE_DISABLED.set(root, parsed); return parsed; } } catch {} const init = { v1: false, v2: false }; APINEXT_BASE_DISABLED.set(root, init); return init; } function setBaseDisabled(root, key) { const st = getBaseState(root); if (!st[key]) { st[key] = true; try { sessionStorage.setItem(`__RM_APINEXT_BASE_DISABLED__:${root}`, JSON.stringify(st)); } catch {} } } /* ================= STYLES ================= */ function ensureStyles() { if (document.getElementById('oas-link-style')) return; const s = document.createElement('style'); s.id = 'oas-link-style'; s.textContent = ` #oas-slot{margin-top:10px} @keyframes oasSpin { to { transform: rotate(360deg); } } .oas-inline { display:inline-flex; align-items:center; gap:8px; font-size:13px; color:#4b5563; } .oas-spin { width:14px; height:14px; border-radius:50%; border:2px solid #cbd5e1; border-top-color:#0037ff; animation: oasSpin 0.8s linear infinite; } .oas-link-btn { display:inline-block;background-color:#0037ff!important;color:white!important; text-decoration:none!important;border:none!important;cursor:pointer!important; padding:10px 15px!important;font-size:14px!important; border-radius:5px!important;font-weight:bold!important; } #content-head.oas-loading [data-error-message="true"]{display:none!important} `; document.head.appendChild(s); } /* ================= DOM (single-slot) ================= */ function getHead() { return document.querySelector('#content-head'); } function getH1() { return document.querySelector('#content-head h1'); } function getHeaderRoot() { return document.querySelector('header[data-raycast-oas]') || getHead()?.closest('header') || document.querySelector('header'); } function getSlot() { ensureStyles(); const head = getHead(); if (!head) return null; let slot = head.querySelector('#oas-slot'); if (!slot) { slot = document.createElement('div'); slot.id = 'oas-slot'; const h1 = getH1(); if (h1) h1.insertAdjacentElement('afterend', slot); else head.appendChild(slot); } return slot; } function removeSlot() { const head = getHead(); const slot = head?.querySelector('#oas-slot'); if (slot) slot.remove(); setHeadState(null); } function setHeadState(state) { const head = getHead(); if (!head) return; head.classList.toggle('oas-loading', state === 'loading'); } function renderLoading(loadId) { const slot = getSlot(); if (!slot) return; const curId = slot.querySelector('[data-oas-loading]')?.getAttribute('data-oas-loading'); if (curId === String(loadId)) return; if (slot.querySelector('[data-oas-link],[data-oas-msg]')) return; setHeadState('loading'); slot.innerHTML = `

Resolving API spec…

`; } function renderButton(result) { const slot = getSlot(); if (!slot) return; setHeadState('ready'); slot.innerHTML = ` Download API spec `; } function renderFallback() { const slot = getSlot(); if (!slot) return; setHeadState('fallback'); const link = `${projectRoot()}/openapi`; slot.innerHTML = `

Having trouble finding the proper spec? View all API specs.

`; } function scheduleFallback(loadId) { cancelFallback(loadId); const t = setTimeout(() => { const slot = getSlot(); const cur = slot?.querySelector('[data-oas-loading]')?.getAttribute('data-oas-loading'); if (cur === String(loadId) && !slot.querySelector('[data-oas-link]')) { renderFallback(); } }, ERROR_MIN_DELAY_MS); fbTimers.set(loadId, t); } function cancelFallback(loadId) { const t = fbTimers.get(loadId); if (t) clearTimeout(t); fbTimers.delete(loadId); } /* ================= CONTEXT ================= */ const isInReference = () => location.pathname.includes('/reference/'); const projectRoot = () => location.pathname.replace(/\/reference.*/, ''); const currentSlug = () => (location.pathname.match(/\/reference\/([^/?#]+)/)||[])[1] || null; function readmeVersion() { const v = document.querySelector('meta[name="readme-version"]')?.content || ''; if (!v || v === 'default') return null; return v.startsWith('v') ? v.slice(1) : v; } function isRealEndpoint() { const header = getHeaderRoot(); if (!header) return false; const methodEl = header.querySelector('[data-testid="http-method"]'); const method = methodEl?.textContent?.trim().toLowerCase() || ''; const methodOk = /^(get|post|put|patch|delete|head|options)$/.test(method); const hasUrl = !!header.querySelector('[data-testid="serverurl"], [data-testid="request-url"]'); const hasRay = header.hasAttribute('data-raycast-oas'); return !!(methodOk && (hasUrl || hasRay)); } function getEndpointContext() { const h1 = getH1()?.textContent || ''; const active = document.querySelector('#reference-sidebar a[aria-current="page"], #reference-sidebar a.active'); const side = active?.textContent || ''; const combined = `${h1} ${side}`; let path = null; let m = combined.match(/\/api\/v?\d+\/[A-Za-z0-9._~\-/{}/]+/i); if (!m) m = combined.match(/\s(\/[A-Za-z0-9._~\-/{}/]+)\b/); if (!m) { const raw = document.querySelector('[data-testid="request-url"]')?.textContent || document.querySelector('[data-testid="request-method"] + *')?.textContent || document.querySelector('.rdmd-code, pre, code')?.textContent || ''; const abs = raw.match(/\bhttps?:\/\/[^\s)'"<>]+/i); if (abs) { try { path = new URL(abs[0]).pathname; } catch {} } } else { path = (m[1] || m[0]).trim(); } const header = getHeaderRoot(); let method = header?.querySelector('[data-testid="http-method"]')?.textContent?.toLowerCase() || ''; if (!method) { const mm = combined.toLowerCase().match(/\b(get|post|put|patch|delete|head|options)\b/); method = mm ? mm[1] : ''; } method = method.replace(/[^a-z]/g, ''); if (method === 'del') method = 'delete'; const section = active?.closest('section,[role="group"],nav,div'); const headingEl = section?.querySelector('h2 button, h2, h3'); const heading = (headingEl?.textContent || '').toLowerCase(); const catTokens = heading.replace(/[^a-z0-9]+/g, ' ').split(/\s+/).filter(Boolean); let major = null; const mv = /(\/api\/v|\/v)(\d+)/i.exec(path || ''); if (mv) major = parseInt(mv[2], 10); return { path, method, major, catTokens }; } /* ================= FETCH/SCORING ================= */ // UPDATED: treat 404 as "not available" and cache it so we don't keep probing. async function fetchJson(url, signal, baseKey, root) { if (APINEXT_URL_MISS.has(url)) return null; const res = await fetch(url, { credentials: 'include', headers: { accept: 'application/json' }, signal }); if (res.status === 404) { APINEXT_URL_MISS.add(url); if (baseKey && root) setBaseDisabled(root, baseKey); return null; } if (!res.ok) throw new Error(`${res.status} ${res.statusText} at ${url}`); return res.json(); } async function fetchSpec(url, signal) { if (SPEC_CACHE.has(url)) return SPEC_CACHE.get(url); const p = (async () => { const res = await fetch(url, { credentials: 'include', headers: { accept: 'application/json, application/yaml, */*;q=0.1' }, signal }); if (!res.ok) throw new Error(`Spec ${url} -> ${res.status}`); const ct = res.headers.get('content-type') || ''; const txt = await res.text(); if (/json/i.test(ct) || txt.trim().startsWith('{') || txt.trim().startsWith('[')) { return JSON.parse(txt); } throw new Error(`Spec returned non-JSON (${ct})`); })(); SPEC_CACHE.set(url, p); return p; } async function headOk(url, signal) { try { const r = await fetch(url, { method: 'HEAD', credentials: 'include', signal }); return r.ok; } catch { return false; } } function absoluteUrl(u) { try { return new URL(u, location.origin).href; } catch { return null; } } async function getCandidatesFromApiNext(signal) { const root = projectRoot(); const slug = currentSlug(); if (!slug) return []; const ver = readmeVersion(); const baseState = getBaseState(root); const bases = []; if (!baseState.v2) bases.push({ key: 'v2', base: `${root}/api-next/v2` }); if (!baseState.v1) bases.push({ key: 'v1', base: `${root}/api-next/v1` }); const urls = new Set(); for (const { key, base } of bases) { const tries = []; if (ver) tries.push(`${base}/branches/${encodeURIComponent(ver)}/reference/${slug}?dereference=true&reduce=false`); tries.push(`${base}/reference/${slug}?dereference=true&reduce=false`); for (const u of tries) { try { const data = await fetchJson(u, signal, key, root); if (!data) continue; // 404 miss (cached) (function walk(o) { if (!o || typeof o !== 'object') return; for (const k in o) { const v = o[k]; if (typeof v === 'string') { if (/\/(apis|openapi)\/[^"']+\.json$/i.test(v)) { const abs = absoluteUrl(v); if (abs) urls.add(abs); } } else if (v && typeof v === 'object') { walk(v); } } })(data); if (urls.size) break; } catch (e) { // only log in debug mode log('api-next miss:', e.message); } } if (urls.size) break; } const arr = Array.from(urls); log('api-next candidates:', arr); return arr; } async function getCandidatesFromOpenapiIndex(signal) { const urls = new Set(); try { const res = await fetch(`${projectRoot()}/openapi`, { credentials: 'include', signal }); if (!res.ok) return []; const html = await res.text(); const doc = new DOMParser().parseFromString(html, 'text/html'); doc.querySelectorAll('a[href$=".json"]').forEach(a => { const href = a.getAttribute('href'); const abs = absoluteUrl(href); if (abs) urls.add(abs); }); } catch (e) { log('/openapi scrape miss:', e.message); } const arr = Array.from(urls); log('/openapi candidates:', arr); return arr; } const canon = (p) => String(p || '').toLowerCase().replace(/\{[^}]+\}/g, '{}'); function pathScore(oas, wantPath, method) { if (!oas || !oas.paths) return -Infinity; let best = -Infinity; for (const p in oas.paths) { const ops = oas.paths[p] || {}; let s = 0; if (wantPath) { const wantC = canon(wantPath); const c = canon(p); if (p === wantPath) s += 100; if (c === wantC) s += 80; if (wantPath && p.startsWith(wantPath)) s += 20; } if (!method || ops[method]) s += 15; best = Math.max(best, s); } return best; } function metaScore(oas, catTokens) { let s = 0; const title = (oas?.info?.title || '').toLowerCase(); for (const t of (catTokens || [])) if (title.includes(t)) s += 5; return s; } function majorHint(url, major) { if (major == null) return 0; const low = url.toLowerCase(); const mDash = low.match(/-v(\d+)(?:\.\d+)*/); const mPath = low.match(/\/v(\d+)(?:\/|[^0-9]|$)/); const found = mDash ? parseInt(mDash[1], 10) : (mPath ? parseInt(mPath[1], 10) : null); if (found == null) return 0; return found === major ? 5 : -5; } async function chooseBestSpecProgressive(candidateUrls, ctx, signal) { const prefer = (u) => { let s = 0; const low = u.toLowerCase(); if (ctx.major != null) { const mDash = low.match(/-v(\d+)/); const mPath = low.match(/\/v(\d+)(?:\/|[^0-9]|$)/); const found = mDash ? parseInt(mDash[1], 10) : (mPath ? parseInt(mPath[1], 10) : null); if (found != null) s += (found === ctx.major ? 5 : -2); } if (ctx.method && low.includes(ctx.method)) s += 3; if (ctx.path) { const base = ctx.path.split('/').filter(Boolean).slice(-1)[0]; if (base && low.includes(base.toLowerCase())) s += 3; } return s; }; const sorted = [...candidateUrls].sort((a,b) => prefer(b) - prefer(a)); let top = null; let checked = 0; for (const u of sorted) { checked++; let oas; try { oas = await fetchSpec(u, signal); } catch (e) { log('spec fetch fail:', u, e.message); continue; } const score = pathScore(oas, ctx.path, ctx.method) + metaScore(oas, ctx.catTokens) + majorHint(u, ctx.major); const item = { url: u, filename: u.split('/').pop(), score }; log('scored', item); if (!top || item.score > top.score) top = item; if (top && top.score >= 195) break; if (checked >= 3) break; } if (!top || !Number.isFinite(top.score) || top.score <= 0) return null; const openapiUrl = `${projectRoot()}/openapi/${top.filename}`; const downloadUrl = top.url.includes('/openapi/') || !(await headOk(openapiUrl, signal)) ? top.url : openapiUrl; return { ...top, downloadUrl }; } async function waitForHead(timeoutMs = 3000) { if (getHead()) return true; return await new Promise((resolve) => { const deadline = performance.now() + timeoutMs; const obs = new MutationObserver(() => { if (getHead()) { obs.disconnect(); resolve(true); } else if (performance.now() > deadline) { obs.disconnect(); resolve(false); } }); obs.observe(document.documentElement, { childList: true, subtree: true }); setTimeout(() => { if (getHead()) resolve(true); else { obs.disconnect(); resolve(false); } }, timeoutMs); }); } /* ================= RUN ================= */ async function run() { if (!isInReference()) { moHead.disconnect(); moSide.disconnect(); moHdr.disconnect(); return; } let head = getHead(); if (!head) { const ok = await waitForHead(3000); if (!ok) { scheduleRun('no-head-yet'); return; } head = getHead(); if (!head) { scheduleRun('no-head-postwait'); return; } } bindObservers(); if (!isRealEndpoint()) { removeSlot(); scheduleRun('await-endpoint-hydration'); return; } const start = performance.now(); while (!getH1() && performance.now() - start < 800) { await new Promise(r => requestAnimationFrame(r)); } const ctx = getEndpointContext(); const ver = readmeVersion() || 'default'; const slug = currentSlug() || ''; const ctxKey = `${ver}::${slug}::${ctx.path || ''}::${ctx.method || ''}`; const slot = getSlot(); if (activeCtxKey === ctxKey && currentAbort && !currentAbort.signal.aborted) { if (DEBUG) log('dedupe: fetch in-flight for ctxKey'); return; } if (ctxKey === lastCtxKey && slot && slot.querySelector('[data-oas-link],[data-oas-msg]')) { if (DEBUG) log('skip: already rendered for ctxKey'); return; } lastCtxKey = ctxKey; if (BEST_CACHE.has(ctxKey)) { renderButton(BEST_CACHE.get(ctxKey)); return; } const myLoadId = ++loadSeq; activeCtxKey = ctxKey; activeLoadId = myLoadId; renderLoading(myLoadId); scheduleFallback(myLoadId); if (currentAbort) currentAbort.abort(); currentAbort = new AbortController(); const { signal } = currentAbort; try { let candidates = await getCandidatesFromApiNext(signal); let best = await chooseBestSpecProgressive(candidates, ctx, signal); if (!best) { const more = await getCandidatesFromOpenapiIndex(signal); const union = Array.from(new Set([...(candidates||[]), ...more])); best = await chooseBestSpecProgressive(union, ctx, signal); } if (myLoadId !== activeLoadId) return; if (best) { cancelFallback(myLoadId); BEST_CACHE.set(ctxKey, best); renderButton(best); } } catch (e) { if (DEBUG) log('run error:', e); } finally { if (activeLoadId === myLoadId) { activeCtxKey = null; activeLoadId = null; } } } /* ================= LIFECYCLE ================= */ function scheduleRun(why) { if (DEBUG && why) log('scheduleRun:', why); clearTimeout(runTimer); runTimer = setTimeout(run, 120); } const moHead = new MutationObserver((mutations) => { for (const m of mutations) { if (m.target && (m.target.closest && m.target.closest('#oas-slot'))) return; } scheduleRun('mut:head'); }); const moSide = new MutationObserver(() => scheduleRun('mut:sidebar')); const moHdr = new MutationObserver((mutations) => { for (const m of mutations) { if (m.target && (m.target.closest && m.target.closest('#oas-slot'))) return; } scheduleRun('mut:header'); }); function bindObservers() { moHead.disconnect(); moSide.disconnect(); moHdr.disconnect(); const head = getHead(); if (head) moHead.observe(head, { childList: true, subtree: true }); const side = document.querySelector('#reference-sidebar'); if (side) moSide.observe(side, { childList: true, subtree: true }); const hdr = getHeaderRoot(); if (hdr) moHdr.observe(hdr, { childList: true, subtree: true }); } const onPageLoad = () => scheduleRun('pageLoad'); if (window.jQuery && jQuery(window).on) jQuery(window).on('pageLoad', onPageLoad); window.addEventListener('pageLoad', onPageLoad); if (document.readyState === 'complete' || document.readyState === 'interactive') onPageLoad(); else document.addEventListener('DOMContentLoaded', onPageLoad); bindObservers(); })();