/* ======================================================================================= Refactored-safe OAS Download Button (multi-project aware) - Shows a "Download API spec" button on *endpoint* pages in /reference/ - Builds the OpenAPI file index from: /openapi - Caches parsed index in sessionStorage (6h) unless DISABLE_CACHE is true - Works in Refactored SPA + (optionally) iframe-rendered reference IMPORTANT BEHAVIOR (per your requirement): - We NEVER show customer-facing errors. - If the button already exists, we NEVER remove it just because resolution fails. - If we can resolve a better spec, we update the existing button link in-place. - If we cannot resolve (or index fetch fails), we keep the existing button and stay silent. DEBUGGING (dev-only): - DEBUG=true logs context + index + resolve decisions - DEBUG_SHOW_PANEL=true shows debug JSON under the H1 ======================================================================================= */ (function () { if (window.__RM_OAS_DOWNLOAD_BTN__) return; window.__RM_OAS_DOWNLOAD_BTN__ = true; // ===== DEBUG TOGGLES ===== const DEBUG = false; const DISABLE_CACHE = true; const DEBUG_SHOW_PANEL = false; // ===== AUTH GATE ===== // true → only show button to logged-in ReadMe users (teammates/editors) // false → show button to everyone, including logged-out public visitors const REQUIRE_LOGIN = false; const TAG = 'OAS-BTN'; const log = (...a) => DEBUG && console.log(`[${TAG}]`, ...a); const warn = (...a) => DEBUG && console.warn(`[${TAG}]`, ...a); const CACHE_TTL_MS = 6 * 60 * 60 * 1000; // 6h const POLL_MS = 500; // Content-scan controls const SPEC_FETCH_TIMEOUT_MS = 20000; const MAX_SPECS_TO_SCAN = 25; // safety cap // ---------- helpers: doc + selectors ---------- function findDocWith(sel) { try { if (document.querySelector(sel)) return document; for (const ifr of document.querySelectorAll('iframe')) { try { const d = ifr.contentDocument; if (d && d.querySelector(sel)) return d; } catch (e) {} } } catch (e) {} return null; } function $q(doc, sel) { try { return doc && doc.querySelector(sel); } catch { return null; } } function $qa(doc, sel) { try { return doc ? Array.from(doc.querySelectorAll(sel)) : []; } catch { return []; } } function isReferencePath(pathname) { return (pathname || '').includes('/reference/'); } function getPathname(doc) { try { return doc?.defaultView?.location?.pathname || window.location.pathname; } catch { return window.location.pathname; } } function getOrigin(doc) { try { return doc?.defaultView?.location?.origin || window.location.origin; } catch { return window.location.origin; } } // ---------- auth gate ---------- function isReadmeLoggedIn() { // Script may run inside an iframe; #hub-me lives in the top-level document const docs = [document]; try { if (window.top && window.top.document !== document) docs.push(window.top.document); } catch (e) {} for (const d of docs) { try { const el = d.getElementById('hub-me'); if (!el) continue; const raw = el.getAttribute('data-json') || el.textContent || '{}'; const data = JSON.parse(raw); if (data.loggedIn) return true; } catch (e) { warn('Failed to parse hub-me JSON', e?.message || e); } } return false; } // ---------- compute projectPrefix + optional unversioned fallback ---------- function getProjectPrefixAndRoot(pathname) { const beforeRef = (pathname.split('/reference')[0] || '').replace(/\/$/, ''); const projectPrefix = beforeRef || ''; const parts = projectPrefix.split('/').filter(Boolean); const last = parts[parts.length - 1] || ''; const looksVersioned = /^v\d[\d.-]*$/i.test(last); const projectRoot = looksVersioned ? '/' + parts.slice(0, -1).join('/') : projectPrefix; return { projectPrefix, projectRoot }; } // ---------- endpoint detection ---------- function isEndpointPage(doc) { if ($q(doc, '#ReferencePlayground')) return true; const active = $q(doc, '#reference-sidebar a[aria-current="page"]'); if (active && active.querySelector('[data-testid="http-method"]')) return true; // SuperHub layout if ($q(doc, 'a[aria-current="page"][class*="Sidebar-link"]') && $q(doc, '.rm-APISectionHeader')) return true; return false; } // ---------- UI helpers ---------- function getExistingButton(doc) { return $q(doc, 'button[data-oas-link="true"]'); } // Finds the page H1 in both legacy (/reference/) and SuperHub layouts function findContentH1(doc) { return $q(doc, '#content-head h1') || $q(doc, 'h1.Title'); } function clearErrorsOnly(doc) { try { const h1 = findContentH1(doc); if (!h1) return; h1.parentNode?.querySelectorAll('[data-oas-error]').forEach((n) => n.remove()); } catch (e) {} } function clearTransientUI(doc) { // DO NOT remove the button. Only remove transient panels/messages. const h1 = findContentH1(doc); if (!h1) return; const parent = h1.parentNode; if (!parent) return; parent.querySelectorAll('[data-oas-loading],[data-oas-error],[data-oas-debug]').forEach((n) => n.remove()); } // NO-OP loading (but still clears any old loading node if it exists) function showLoading(doc) { try { const h1 = findContentH1(doc); if (!h1) return; h1.parentNode?.querySelectorAll('[data-oas-loading]').forEach((n) => n.remove()); } catch (e) {} } // Dev-only error rendering (never called unless DEBUG=true) function showError(doc, msg) { if (!DEBUG) return; const h1 = findContentH1(doc); if (!h1) return; h1.parentNode?.querySelectorAll('[data-oas-loading]').forEach((n) => n.remove()); h1.parentNode?.querySelectorAll('[data-oas-error]').forEach((n) => n.remove()); const d = doc.createElement('div'); d.textContent = msg; d.style.color = 'red'; d.style.fontSize = '14px'; d.setAttribute('data-oas-error', 'true'); h1.insertAdjacentElement('afterend', d); } function showDebugPanel(doc, obj) { if (!DEBUG || !DEBUG_SHOW_PANEL) return; const h1 = findContentH1(doc); if (!h1) return; h1.parentNode?.querySelectorAll('[data-oas-debug]').forEach((n) => n.remove()); const pre = doc.createElement('pre'); pre.setAttribute('data-oas-debug', 'true'); pre.style.cssText = [ 'margin-top:10px;padding:10px;border:1px solid #ddd;background:#fafafa;', 'font-size:12px;white-space:pre-wrap;word-break:break-word;border-radius:8px;', ].join(''); try { pre.textContent = JSON.stringify(obj, null, 2); } catch { pre.textContent = String(obj); } h1.insertAdjacentElement('afterend', pre); } function renderButton(doc, rec) { const h1 = findContentH1(doc); if (!h1) return; // remove loading + old errors (errors should never persist if we have a button) h1.parentNode?.querySelectorAll('[data-oas-loading]').forEach((n) => n.remove()); h1.parentNode?.querySelectorAll('[data-oas-error]').forEach((n) => n.remove()); let btn = getExistingButton(doc); if (!btn) { btn = doc.createElement('button'); btn.type = 'button'; btn.setAttribute('data-oas-link', 'true'); btn.style.cssText = [ 'display:inline-flex;align-items:center;justify-content:center;', 'gap:8px;', 'margin:10px 0 12px 0;', 'height:36px;', 'padding:0 12px;', 'border-radius:10px;', 'border:1px solid rgba(0,0,0,.12);', 'background:#fff;', 'color:#111;', 'font-size:13px;', 'font-weight:600;', 'letter-spacing:.2px;', 'cursor:pointer;', 'box-shadow:0 1px 2px rgba(0,0,0,.06);', 'transition:transform .06s ease, box-shadow .12s ease, background .12s ease, border-color .12s ease;', 'user-select:none;', '-webkit-font-smoothing:antialiased;', ].join(''); btn.addEventListener('mouseenter', () => { btn.style.background = '#f7f7f8'; btn.style.borderColor = 'rgba(0,0,0,.18)'; btn.style.boxShadow = '0 2px 8px rgba(0,0,0,.10)'; }); btn.addEventListener('mouseleave', () => { btn.style.background = '#fff'; btn.style.borderColor = 'rgba(0,0,0,.12)'; btn.style.boxShadow = '0 1px 2px rgba(0,0,0,.06)'; btn.style.transform = 'translateY(0)'; }); btn.addEventListener('mousedown', () => { btn.style.transform = 'translateY(1px)'; btn.style.boxShadow = '0 1px 2px rgba(0,0,0,.06)'; }); btn.addEventListener('mouseup', () => { btn.style.transform = 'translateY(0)'; btn.style.boxShadow = '0 2px 8px rgba(0,0,0,.10)'; }); h1.insertAdjacentElement('afterend', btn); } // (Re)render the inner HTML every time btn.innerHTML = [ '', '', 'Download API spec', '', ].join(''); const filename = (function () { try { const u = new URL(rec.url); const last = (u.pathname.split('/').pop() || '').trim(); if (last) return last.replace(/\.(ya?ml)$/i, '.json'); } catch {} const base = (rec.text || 'openapi').trim() || 'openapi'; return base.replace(/[^\w.-]+/g, '_') + '.json'; })(); // Update what click does WITHOUT stacking handlers btn.__oas = btn.__oas || {}; btn.__oas.url = rec.url; btn.__oas.filename = filename; if (!btn.__oas.bound) { btn.__oas.bound = true; btn.addEventListener('click', (e) => { e.preventDefault(); e.stopPropagation(); const url = btn.__oas?.url; const fname = btn.__oas?.filename || 'openapi.json'; if (!url) return; forcedDownload(url, fname, doc); }); } } // ---------- slug + version helpers ---------- const slugify = (s = '') => s .toLowerCase() .replace(/&/g, 'and') .replace(/[\s_]+/g, '-') .replace(/[^a-z0-9-]/g, '') .replace(/-+/g, '-') .replace(/^-|-$/g, ''); function normV(v) { if (v == null) return null; let s = String(v).trim().replace(/^v/i, '').replace(/-/g, '.'); return s.replace(/(?:\.0)+$/, ''); } function cmpV(a, b) { const A = String(a ?? '') .split('.') .map((x) => +x || 0); const B = String(b ?? '') .split('.') .map((x) => +x || 0); const L = Math.max(A.length, B.length); for (let i = 0; i < L; i++) { if ((A[i] ?? 0) > (B[i] ?? 0)) return 1; if ((A[i] ?? 0) < (B[i] ?? 0)) return -1; } return 0; } function uniq(arr) { return Array.from(new Set((arr || []).filter(Boolean))); } // ---------- index parsing + caching ---------- async function attemptFetchIndex(doc, indexUrl) { const out = { records: [], map: {}, indexUrl, debug: {} }; try { const ctrl = new AbortController(); const timer = setTimeout(() => ctrl.abort(), 15000); const resp = await fetch(indexUrl, { signal: ctrl.signal, cache: 'no-store', credentials: 'same-origin', }); clearTimeout(timer); out.debug.httpOk = resp.ok; out.debug.status = resp.status; out.debug.finalUrl = resp.url; if (!resp.ok) throw new Error(resp.statusText || `HTTP ${resp.status}`); const html = await resp.text(); out.debug.htmlHead = (html || '').slice(0, 300); const d = new DOMParser().parseFromString(html, 'text/html'); const add = (slug, vr, filename, url, text) => { const version = normV(vr); const rec = { slug, version, filename, url, text }; out.records.push(rec); if (version) { out.map[`${slug}-v${version}`] = rec; out.map[`${slug}_${version}`] = rec; } else { out.map[slug] = rec; } }; let kept = 0; let skipped = 0; d.querySelectorAll('a').forEach((a) => { const txt = (a.textContent || '').trim(); let url; try { url = new URL(a.getAttribute('href') || '', indexUrl).toString(); } catch { skipped++; return; } try { const u = new URL(url); if (!/\/openapi\/?/i.test(u.pathname)) { skipped++; return; } } catch { skipped++; return; } kept++; // Pattern 1: link text like "Payments - v1.2" const m = txt.match(/(.*?)\s*-\s*v(\d+(?:[.-]\d+)?)/i); if (m) { const [, cat, vr] = m; const slug = slugify(cat); add(slug, vr, `${slug}-v${normV(vr)}.json`, url, txt); return; } // Pattern 2: filename like "payments-v1.2.json" let file = ''; try { file = new URL(url).pathname.split('/').pop() || ''; } catch {} const base = file.replace(/\.(json|ya?ml)$/i, ''); const m2 = base.match(/^(.*?)-v(\d+(?:[.-]\d+)?)$/i); if (m2) { const [, cat2, vr2] = m2; const slug = slugify(cat2); add(slug, vr2, file || `${slug}-v${normV(vr2)}.json`, url, file || txt); } else { const slug = slugify(base || txt); if (!slug) return; add(slug, null, file || `${slug}.json`, url, file || txt); } }); out.debug.linksKept = kept; out.debug.linksSkipped = skipped; log('Parsed openapi index', { indexUrl, count: out.records.length, debug: out.debug }); return out; } catch (e) { warn('Index fetch failed', { indexUrl, error: e?.message || e, debug: out.debug }); return out; } } async function fetchMergedSpecIndex(doc, origin, projectPrefix, projectRoot) { const preferred = `${origin}${projectPrefix}/openapi`; const alt = projectRoot && projectRoot !== projectPrefix ? `${origin}${projectRoot}/openapi` : null; const cacheKey = `oas-index::${preferred}::${alt || ''}`; const cached = readCache(cacheKey); if (cached) return cached; const idxPref = await attemptFetchIndex(doc, preferred); let merged = idxPref; if (alt) { const idxAlt = await attemptFetchIndex(doc, alt); const key = (r) => `${r.slug}::${r.version ?? 'none'}::${r.filename}`; const seen = new Set(idxPref.records.map(key)); const mergedRecords = [...idxPref.records, ...idxAlt.records.filter((r) => !seen.has(key(r)))]; const mergedMap = { ...idxAlt.map, ...idxPref.map }; merged = { records: mergedRecords, map: mergedMap, indexUrl: preferred, __merged: true, __debug: { preferred, alt, preferredDebug: idxPref.debug, altDebug: idxAlt.debug }, }; } else { merged.__debug = { preferred, alt: null, preferredDebug: idxPref.debug }; } writeCache(cacheKey, merged); return merged; } function readCache(key) { if (DISABLE_CACHE) return null; try { const raw = sessionStorage.getItem(key); if (!raw) return null; const parsed = JSON.parse(raw); if (!parsed || !parsed.at || !parsed.value) return null; if (Date.now() - parsed.at > CACHE_TTL_MS) return null; return parsed.value; } catch { return null; } } function writeCache(key, value) { if (DISABLE_CACHE) return; try { sessionStorage.setItem(key, JSON.stringify({ at: Date.now(), value })); } catch {} } // ---------- category + version detection ---------- function getCategoryFromSidebar(doc) { // SuperHub layout const activeSuper = $q(doc, 'a[aria-current="page"][class*="Sidebar-link"]'); if (activeSuper) { const section = activeSuper.closest('.rm-Sidebar-section'); if (section) { const h = section.querySelector('.rm-Sidebar-heading'); const t = (h?.textContent || '').trim(); if (t) return t; } } // Legacy layout const sidebar = $q(doc, '#reference-sidebar'); const active = sidebar?.querySelector?.('a[aria-current="page"]'); if (!active) return null; const section = active.closest('section'); if (!section) return null; const h = section.querySelector('h2') || section.querySelector('[role="heading"]') || section.querySelector('h3'); const t = (h?.textContent || '').trim(); return t ? t : null; } function getCategoryFromURL(doc) { try { const path = getPathname(doc); const parts = path.split('/').filter(Boolean); const idx = parts.findIndex((p) => p.toLowerCase() === 'reference'); if (idx >= 0 && parts[idx + 1]) return parts[idx + 1].replace(/-/g, ' ').trim(); } catch {} return null; } function getDocsVersion(doc) { const meta = $q(doc, 'meta[name="readme-version"]') || document.querySelector('meta[name="readme-version"]'); const mv = (meta?.content || '').trim(); if (!mv || mv === 'default') return null; return mv.startsWith('v') ? mv.slice(1) : mv; } // ---------- slug-based matching ---------- function pickBest(pool, targetV) { if (!pool || !pool.length) return null; if (targetV != null) { const exact = pool.find((r) => r.version === targetV); if (exact) return exact; } const vers = pool.filter((r) => r.version != null); return vers.length ? vers.sort((a, b) => cmpV(b.version, a.version))[0] : pool[0]; } function resolveSpecRecordBySlugs(idx, categoryText, docsVersionRaw, projectNameFallback) { const recs = idx?.records || []; if (!recs.length) return null; try { const oasId = document.querySelector('[data-raycast-oas]')?.getAttribute('data-raycast-oas'); if (oasId && oasId !== '[object Object]') { const hit = recs.find((r) => (r.url || '').includes(oasId)); if (hit) return hit; } } catch {} const catSlug = slugify(categoryText || ''); const targetV = normV(docsVersionRaw); log('Resolve(slug)', { categoryText, catSlug, docsVersionRaw, targetV, projectNameFallback }); const variants = uniq([ catSlug, catSlug.replace(/-api$/, ''), catSlug.endsWith('-api') ? catSlug : `${catSlug}-api`, catSlug.replace(/s\b/, ''), `${catSlug}s`, ]); log('Resolve variants', variants); for (const s of variants) { if (targetV && idx.map[`${s}-v${targetV}`]) return idx.map[`${s}-v${targetV}`]; if (targetV && idx.map[`${s}_${targetV}`]) return idx.map[`${s}_${targetV}`]; const pool = recs.filter((r) => r.slug === s); const best = pickBest(pool, targetV); if (best) return best; } if (targetV) { const anyV = recs.filter((r) => r.version === targetV); if (anyV.length) return anyV[0]; } if (projectNameFallback) { const p = slugify(projectNameFallback); const pool = recs.filter((r) => r.slug === p); const best = pickBest(pool, targetV); if (best) return best; } // Word-overlap fallback: "Partner API" → ["partner"] must appear in spec slug // Handles cases like "partner-api" matching "partnerapi-doc-staging" const catWords = catSlug.split('-').filter((w) => w.length > 3 && w !== 'api'); if (catWords.length) { const hits = recs.filter((r) => catWords.every((w) => r.slug.includes(w))); if (hits.length === 1) return hits[0]; if (hits.length > 1) { const best = pickBest(hits, targetV); if (best) return best; } } return null; } // ---------- content-based matching fallback ---------- function textFrom(el) { try { return (el?.textContent || '').trim(); } catch { return ''; } } function normalizeCandidateToOasPath(raw) { if (!raw) return null; let s = String(raw).trim(); if (s.startsWith('//')) { try { const u = new URL('https:' + s); s = u.pathname || s; } catch {} } if (/^https?:\/\//i.test(s)) { try { const u = new URL(s); s = u.pathname || s; } catch {} } if (s.startsWith('/')) { const parts = s.split('/').filter(Boolean); if (parts[0] && parts[0].includes('.')) s = '/' + parts.slice(1).join('/'); } const idxApi = s.toLowerCase().indexOf('/api/'); if (idxApi >= 0) s = s.slice(idxApi); if (!s.startsWith('/')) s = '/' + s; s = s.split('?')[0].replace(/\/{2,}/g, '/'); if (s.length < 2) return null; return s; } function extractMethodAndPath(doc) { const methodEl = $q(doc, '#reference-sidebar a[aria-current="page"] [data-testid="http-method"]') || $q(doc, '[data-testid="http-method"]') || $q(doc, '#ReferencePlayground [data-testid="http-method"]'); const method = textFrom(methodEl).toLowerCase() || null; const PATH_REGEX = /(^|[\s(])((?:\/(?!\/))[A-Za-z0-9\-._~%!$&'()*+,;=:@\/{}]+)(?=\s|$)/; const candidates = [ '#ReferencePlayground [data-testid="endpoint-path"]', '#ReferencePlayground [data-testid="request-path"]', '#ReferencePlayground [data-testid="endpoint-url"]', '#ReferencePlayground code', '#ReferencePlayground pre', '#content-head code', '[data-testid="endpoint-path"]', '[data-testid="endpoint-url"]', ]; let rawPath = null; for (const sel of candidates) { const el = $q(doc, sel); const t = textFrom(el); if (!t) continue; const m = t.match(PATH_REGEX); if (m && m[2]) { rawPath = m[2]; break; } const tt = t.trim(); if (/^https?:\/\//i.test(tt) || tt.startsWith('//')) { rawPath = tt; break; } } if (!rawPath) { const nodes = $qa(doc, '#ReferencePlayground *').slice(0, 250); for (const n of nodes) { const t = textFrom(n); if (!t) continue; const m = t.match(PATH_REGEX); if (m && m[2]) { rawPath = m[2]; break; } const tt = t.trim(); if (/^https?:\/\//i.test(tt) || tt.startsWith('//')) { rawPath = tt; break; } } } const normPath = normalizeCandidateToOasPath(rawPath); if (DEBUG) log('Extract(method,path)', { method, path: rawPath, normPath }); return { method, path: normPath }; } function buildPathVariants(path) { if (!path) return []; const base = String(path).trim(); const out = new Set(); function add(p) { if (!p) return; let s = p.trim(); if (!s.startsWith('/')) s = '/' + s; s = s.replace(/\/{2,}/g, '/'); out.add(s); if (s.endsWith('/')) out.add(s.slice(0, -1)); else out.add(s + '/'); } add(base); const parts = base.split('/').filter(Boolean); if (parts[0] && parts[0].toLowerCase() === 'api') add('/' + parts.slice(1).join('/')); if (parts[0] && parts[0].toLowerCase() === 'api' && parts[1] && /^v\d+(\.\d+)?$/i.test(parts[1])) { add('/' + parts.slice(2).join('/')); } if (parts[0] && /^v\d+(\.\d+)?$/i.test(parts[0])) add('/' + parts.slice(1).join('/')); for (let n = 1; n <= 3; n++) { if (parts.length > n) add('/' + parts.slice(n).join('/')); } return Array.from(out); } function escapeRegex(s) { return String(s).replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); } function matchesPathMethodBlock(specText, pathVariant, method) { if (!specText || !pathVariant || !method) return false; const p = String(pathVariant).trim(); const m = String(method).trim().toLowerCase(); const pRe = escapeRegex(p); const reJson = new RegExp( `"${pRe}"\\s*:\\s*\\{[\\s\\S]{0,8000}?"${escapeRegex(m)}"\\s*:`, 'i' ); const reYaml = new RegExp( `(^|\\n)\\s*['"]?${pRe}['"]?\\s*:\\s*(\\r?\\n)([\\s\\S]{0,8000}?)(\\n\\s*${escapeRegex(m)}\\s*:)`, 'i' ); const reLoose = new RegExp( `"${pRe}"\\s*:\\s*[\\s\\S]{0,8000}?"${escapeRegex(m)}"\\s*:`, 'i' ); return reJson.test(specText) || reYaml.test(specText) || reLoose.test(specText); } function specCacheKey(url) { return `oas-spec-text::${url}`; } async function fetchSpecText(url) { const key = specCacheKey(url); const cached = readCache(key); if (cached && typeof cached === 'string') return cached; const ctrl = new AbortController(); const timer = setTimeout(() => ctrl.abort(), SPEC_FETCH_TIMEOUT_MS); try { const resp = await fetch(url, { credentials: 'same-origin', cache: 'no-store', signal: ctrl.signal }); if (!resp.ok) throw new Error(`HTTP ${resp.status}`); const txt = await resp.text(); writeCache(key, txt); return txt; } finally { clearTimeout(timer); } } async function resolveSpecRecordByContent(idx, doc) { const extracted = extractMethodAndPath(doc); const method = extracted.method; const path = extracted.path; if (!method || !path) { log('Content-resolve skipped (missing method/path)', { method, path }); return null; } const variants = buildPathVariants(path); log('Content-resolve variants', variants); const recs = (idx.records || []).slice(0, MAX_SPECS_TO_SCAN); for (const rec of recs) { let txt = ''; try { txt = await fetchSpecText(rec.url); } catch (e) { warn('Spec fetch failed', { url: rec.url, error: e?.message || e }); continue; } for (const pv of variants) { try { if (matchesPathMethodBlock(txt, pv, method)) { log('Content-resolve HIT', { specSlug: rec.slug, url: rec.url, method, matchedPath: pv, originalPath: path }); return rec; } } catch (e) {} } } log('Content-resolve MISS', { method, path, variantsTried: variants.length, scanned: recs.length }); return null; } // ---------- download ---------- async function forcedDownload(url, filename, doc) { let topDoc = doc; let topWin = doc?.defaultView || window; try { if (window.top && window.top.document) { void window.top.document.body; topDoc = window.top.document; topWin = window.top; } } catch (e) {} try { const fetchFn = (topWin.fetch || fetch).bind(topWin); const res = await fetchFn(url, { credentials: 'same-origin' }); if (!res.ok) throw new Error('HTTP ' + res.status); const blob = await res.blob(); const URLapi = topWin.URL || URL; const blobUrl = URLapi.createObjectURL(blob); const a = topDoc.createElement('a'); a.href = blobUrl; a.download = filename || 'openapi.json'; a.style.display = 'none'; (topDoc.body || topDoc.documentElement).appendChild(a); a.click(); a.remove(); setTimeout(() => { try { URLapi.revokeObjectURL(blobUrl); } catch {} }, 1000); } catch (e) { try { (topWin.open || window.open).call(topWin, url, '_blank', 'noopener'); } catch {} } } // ---------- refresh orchestration ---------- function debounce(fn, wait) { let t; return (...args) => { clearTimeout(t); t = setTimeout(() => fn(...args), wait); }; } const refresh = debounce(async () => { if (REQUIRE_LOGIN && !isReadmeLoggedIn()) { log('Not logged in, skipping'); return; } const doc = findDocWith('#reference-sidebar') || findDocWith('#content-head h1') || findDocWith('.rm-Sidebar-section') || findDocWith('h1.Title') || document; const pathname = getPathname(doc); // Not in /reference/: remove transient UI but never aggressively remove a button if (!isReferencePath(pathname)) { const uiDoc = findDocWith('#content-head h1') || findDocWith('h1.Title') || document; clearTransientUI(uiDoc); return; } // Must be endpoint page to show/maintain button if (!isEndpointPage(doc)) { clearTransientUI(doc); return; } // Always clear any stray error if we’re on an endpoint (customer should never see it) clearErrorsOnly(doc); const origin = getOrigin(doc); const { projectPrefix, projectRoot } = getProjectPrefixAndRoot(pathname); const projectName = (projectPrefix || '').replace(/^\//, '').split('/')[0] || null; let idx; try { idx = await fetchMergedSpecIndex(doc, origin, projectPrefix, projectRoot); } catch (e) { // If index fetch blows up, keep any existing button and stay silent warn('fetchMergedSpecIndex exception', e?.message || e); return; } if (!idx.records || !idx.records.length) { // No records: keep any existing button and stay silent if (DEBUG) showError(doc, 'No API spec files are available.'); return; } const catSidebar = getCategoryFromSidebar(doc); const catURL = getCategoryFromURL(doc); const cat = catSidebar || catURL; if (!cat) { // Cannot determine category: keep any existing button and stay silent if (DEBUG) showError(doc, 'Cannot determine the current API category.'); return; } const docsVersion = getDocsVersion(doc); const debugBlob = { origin, pathname, projectPrefix, projectRoot, projectName, categoryUsed: cat, categoryFromSidebar: catSidebar, categoryFromURL: catURL, docsVersionRaw: docsVersion, docsVersionNorm: normV(docsVersion), indexUrl: idx.indexUrl, merged: !!idx.__merged, recordCount: idx.records?.length || 0, slugsSample: Array.from(new Set((idx.records || []).map((r) => r.slug))).slice(0, 60), indexDebug: idx.__debug || null, }; log('Context', debugBlob); showDebugPanel(doc, debugBlob); let rec = resolveSpecRecordBySlugs(idx, cat, docsVersion, projectName); if (!rec) { log('Slug-resolve failed; attempting content-resolve'); try { rec = await resolveSpecRecordByContent(idx, doc); } catch (e) { warn('Content-resolve exception', e?.message || e); rec = null; } } if (!rec) { // THIS IS THE BIG FIX: // Never show the error; never remove a working button; just keep the current button and stay silent. if (DEBUG) showError(doc, 'Cannot find corresponding spec file for this API page.'); return; } // If we resolved successfully, update or create button in-place renderButton(doc, rec); }, 150); // ---------- SPA hooks ---------- let lastPath = window.location.pathname; let _retryCount = 0; const MAX_RETRIES = 12; // ~6 seconds at 500ms intervals function tick() { const p = window.location.pathname; if (p !== lastPath) { lastPath = p; _retryCount = 0; refresh(); return; } // Retry on reference pages until the button appears (handles SPA render timing) if (isReferencePath(p) && !getExistingButton(document) && _retryCount < MAX_RETRIES) { _retryCount++; refresh(); } } refresh(); setInterval(tick, POLL_MS); window.addEventListener('pageLoad', () => refresh()); function attachSidebarObserver() { // Legacy layout const legacyDoc = findDocWith('#reference-sidebar'); const sidebar = $q(legacyDoc, '#reference-sidebar'); if (sidebar && !sidebar.__oasObserved) { sidebar.__oasObserved = true; new MutationObserver(() => refresh()).observe(sidebar, { childList: true, subtree: true }); } // SuperHub layout const superDoc = findDocWith('.rm-Sidebar-section') || document; const superSidebar = $q(superDoc, '.rm-Sidebar-section'); if (superSidebar && !superSidebar.__oasObserved) { superSidebar.__oasObserved = true; new MutationObserver(() => refresh()).observe(superSidebar, { childList: true, subtree: true }); } } setInterval(attachSidebarObserver, 1000); })();

400Bad Request

401Unauthorized

403Forbidden

404Not Found

422Unprocessable Content

500Internal Server Error