// UQPAY Developer Assistant — staging loader (Wave A: right-docked panel). // Mintlify auto-injects every .js file under the content directory on every page. // This loader mounts a right-side panel that the iframe widget renders into. // The Mintlify app gets a transient margin-right so its content reflows instead of // being covered. // // Source / design: 30-product-engineer/05-developer-assistant/ // research/2026-05-09-stripe-ask-ai-clone-feasibility.md (Wave A) (function () { if (window.__UQPAY_ASSISTANT_LOADED__) return; window.__UQPAY_ASSISTANT_LOADED__ = true; // ===== Mintlify native assistant — clear stale "open" state ================= // Mintlify ships a native AI panel; we hide its UI via custom.css // (#assistant-entry, #chat-assistant-sheet, #text-selection-tooltip) so users // only see *our* widget. Side effect: if a user ever clicked Mintlify's pill // *before* we hid it, Mintlify persisted "panel open" in // localStorage['chat-assistant-sheet-open']='true'. On subsequent visits the // SSR HTML lands with `` and Mintlify's React hydration // pins .mdx-content's width to (viewport − 368 px), reserving a 368 px slot // for the panel that we then refuse to render — producing a big empty band // between docs content and our widget iframe. // // Fix in three layers: // 1. Remove the stale localStorage key so future SSR/hydration starts closed. // 2. Reset the SSR-rendered attribute + CSS var immediately (cosmetic; // React width is set from state, not these, so this alone isn't enough // to un-pin .mdx-content for the current page). // 3. If we just removed a stale "true", reload exactly once (session-scoped // guard prevents loops) so React re-hydrates with the closed state and // .mdx-content reclaims the full viewport. Users only ever see one // refresh after this code first ships; subsequent visits are clean. try { var STALE_KEY = 'chat-assistant-sheet-open'; var RELOAD_FLAG = 'uqpay_mintlify_assistant_reset_v1'; var hadStaleOpen = window.localStorage.getItem(STALE_KEY) === 'true'; if (hadStaleOpen) window.localStorage.removeItem(STALE_KEY); document.documentElement.setAttribute('data-assistant-state', 'closed'); document.documentElement.style.setProperty('--assistant-sheet-width', '0px'); if (hadStaleOpen && !window.sessionStorage.getItem(RELOAD_FLAG)) { window.sessionStorage.setItem(RELOAD_FLAG, '1'); window.location.reload(); return; } } catch (e) {} // Resolution order for the iframe URL: // 1. ?da_iframe=URL — ad-hoc per-page override // 2. localStorage.UQPAY_ASSISTANT_IFRAME_URL — sticky override // 3. localhost / 127.0.0.1 — default to local widget (mint dev) // 4. anywhere else — prod widget on Cloudflare Pages // // To use prod widget while on mint dev: // localStorage.setItem('UQPAY_ASSISTANT_IFRAME_URL', 'https://da-poc.pages.dev/iframe') // To clear: // localStorage.removeItem('UQPAY_ASSISTANT_IFRAME_URL') // // Local widget assumes you're running: // cd developer-assistant/web && python3 -m http.server -d public 8765 var DEV_IFRAME_URL = 'http://localhost:8765/iframe.html'; var PROD_IFRAME_URL = 'https://da-poc.pages.dev/iframe'; function resolveIframeUrl() { try { var qs = new URLSearchParams(window.location.search); var fromQs = qs.get('da_iframe'); if (fromQs) return fromQs; var fromLs = window.localStorage.getItem('UQPAY_ASSISTANT_IFRAME_URL'); if (fromLs) return fromLs; } catch (e) {} var host = window.location.hostname; if (host === 'localhost' || host === '127.0.0.1' || host === '0.0.0.0') { // mint dev — log the choice once so content-only authors who don't run // the widget http.server know how to silence the broken-iframe noise. try { console.info( '[uqpay-assistant] dev mode → loading widget from ' + DEV_IFRAME_URL + '\n start it via: cd developer-assistant/web && python3 -m http.server -d public 8765' + "\n or pin to prod: localStorage.setItem('UQPAY_ASSISTANT_IFRAME_URL','" + PROD_IFRAME_URL + "')" ); } catch (e) {} return DEV_IFRAME_URL; } return PROD_IFRAME_URL; } var IFRAME_URL = resolveIframeUrl(); var APP_ROOT_SELECTOR = '.relative.antialiased'; var TRANSITION = 'transform 0.22s ease, width 0.22s ease'; // === Responsive layout (UXR follow-up 2026-05-09) =========================== // The earlier "always push" model assumed viewport ≥ 1500 px and broke docs // responsive layout below that — sidebar + main + sticky cURL panel were all // sized via viewport-based media queries, so the panel reduced docs effective // width from 1280 px down to ~920 px without docs realising it. Result: // headings rendered one letter per line, code panel covered the H1. // // New model picks one of three modes per viewport so docs is *either* in its // own native responsive path or pushed only when there's enough room: // // ≥ 1500 px → push (panel docks right, docs gets margin-right; docs // effective width ≥ 1180 px even at expanded state) // < 1500 → overlay (panel floats over docs with shadow; docs untouched, // its own native breakpoints handle the narrow space) // < 768 → modal (full-screen takeover, the existing mobile behaviour) // // panelWidth scales down with viewport so the panel itself stays comfortable: // a 360 px panel inside a 1500 px window feels different from inside 1920 px. var MOBILE_BREAKPOINT = 768; // < 768 → full-screen modal var OVERLAY_BREAKPOINT = 1500; // 768-1499 → overlay (no push) // ≥ 1500 → push function panelMode() { var vp = window.innerWidth; if (vp < MOBILE_BREAKPOINT) return 'modal'; if (vp < OVERLAY_BREAKPOINT) return 'overlay'; return 'push'; } function isMobile() { return panelMode() === 'modal'; } // Kept as a name alias so any future code that wants "is the panel covering // content vs. flowing alongside it" reads naturally. function isFloatingMode() { var m = panelMode(); return m === 'overlay' || m === 'modal'; } var state = { open: false, expanded: false, iframe: null, iframeReady: false, pendingQuote: null, triggerBtn: null, // floating fallback (only visible if header pill missing) headerBtn: null, // v2-8 header `Ask AI` pill, injected into Mintlify navbar appRoot: null, lastPath: window.location.pathname, selectionTooltip: null, selectionSnapshot: null, }; // ===== Theme ===== function detectTheme() { return document.documentElement.classList.contains('dark') ? 'dark' : 'light'; } function bgFor(theme) { return theme === 'dark' ? '#0f1216' : '#fff'; } // ===== Layout: panel + content shift ===== // Width steps tuned so the panel itself stays comfortable across viewports // and so push mode (≥ 1500 vp) keeps docs effective width ≥ 1180 px in // collapsed and ≥ 1020 px in expanded state — both above the docs `lg` // breakpoint where its three-column layout (sidebar + main + code panel) // is intended to fit. function panelWidth() { var vp = window.innerWidth; if (state.expanded) { if (vp >= 1800) return 520; if (vp >= 1500) return 480; return 460; // overlay default — fits comfortably in 1024-1499 viewports } if (vp >= 1800) return 360; if (vp >= 1500) return 320; return 340; // overlay default — slightly wider than push collapsed because // overlay floats over docs and benefits from a stronger panel } // Stronger shadow in overlay mode so the floating edge is visually obvious // against the docs body (otherwise users mistake it for a glitched layout). var SHADOW_PUSH = '-4px 0 16px rgba(0,0,0,0.06)'; var SHADOW_OVERLAY = '-12px 0 32px rgba(15,22,36,0.18), -2px 0 6px rgba(15,22,36,0.06)'; function applyLayout() { var mode = panelMode(); if (state.iframe) { state.iframe.style.width = (mode === 'modal') ? '100vw' : (panelWidth() + 'px'); state.iframe.style.transform = state.open ? 'translateX(0)' : 'translateX(100%)'; state.iframe.style.boxShadow = (mode === 'overlay') ? SHADOW_OVERLAY : SHADOW_PUSH; } if (state.appRoot) { state.appRoot.style.transition = 'margin-right 0.22s ease'; // Only push mode shifts docs content. Overlay and modal float over it, // so docs renders in its own native responsive path — no margin-right. state.appRoot.style.marginRight = (state.open && mode === 'push') ? (panelWidth() + 'px') : ''; } // Expose mode to docs CSS via data-attribute so custom.css can scope rules // (e.g. hide the right-side TOC only in push mode, where it would compress // to a uselessly narrow column). try { document.body.setAttribute( 'data-uqpay-assistant-mode', state.open ? mode : 'closed' ); } catch (e) {} } // sessionStorage key for panel-open persistence — survives page reloads // (e.g. user clicks a docs link inside the answer, page reloads, panel // restores) but resets on tab close so a fresh visit starts closed. var OPEN_STATE_KEY = 'UQPAY_ASSISTANT_OPEN'; function setOpen(open) { state.open = !!open; applyTriggerVisibility(); applyLayout(); // B6: tell the widget so it can jump focus to composer + activate Tab trap. postToIframe({ type: 'uqpay-assistant.panel-state', open: state.open }); // P2-8 / responsive UXR: legacy class kept for backward-compat selectors; // the precise mode lives in data-uqpay-assistant-mode (set by applyLayout). try { document.body.classList.toggle('uqpay-assistant-open', state.open); } catch (e) {} try { window.sessionStorage.setItem(OPEN_STATE_KEY, state.open ? '1' : '0'); } catch (e) {} } // Floating fallback button is only visible when the panel is closed AND the // header pill is absent or not currently rendered (e.g., Mintlify hides the // header right slot on viewports below `lg` ≈ 1024 px). function applyTriggerVisibility() { if (!state.triggerBtn) return; var headerVisible = state.headerBtn && document.contains(state.headerBtn) && state.headerBtn.offsetParent !== null; state.triggerBtn.style.display = (!state.open && !headerVisible) ? 'flex' : 'none'; } function setExpanded(expanded) { state.expanded = !!expanded; applyLayout(); postToIframe({ type: 'uqpay-assistant.expand-state', expanded: state.expanded }); } // ===== postMessage helpers ===== function postToIframe(msg) { try { if (state.iframe && state.iframe.contentWindow) { state.iframe.contentWindow.postMessage(msg, '*'); } } catch (e) {} } function sendPageContext() { postToIframe({ type: 'uqpay-assistant.page_context', url: window.location.href, pathname: window.location.pathname, }); } var lastTheme = null; function sendTheme() { var t = detectTheme(); if (state.iframe) state.iframe.style.background = bgFor(t); if (t === lastTheme) return; lastTheme = t; postToIframe({ type: 'uqpay-assistant.theme', theme: t }); } // Language sync — Mintlify uses /zh/* for Chinese; everything else is English. // Emit on iframe.load + on SPA path change (deduped via lastLang) so the // widget i18n flips alongside the docs site language switcher. function detectLanguage() { var p = window.location.pathname || ''; return (p === '/zh' || p.indexOf('/zh/') === 0) ? 'zh' : 'en'; } var lastLang = null; function sendLanguage() { var lang = detectLanguage(); if (lang === lastLang) return; lastLang = lang; postToIframe({ type: 'uqpay-assistant.language', lang: lang }); } // ===== Iframe + trigger button ===== function buildIframe() { var iframe = document.createElement('iframe'); iframe.src = IFRAME_URL; iframe.title = 'UQPAY Developer Assistant'; iframe.id = 'uqpay-assistant-frame'; // Cross-origin iframe (developers.uqpay.com → da-poc.pages.dev) needs an // explicit allow=clipboard-write for navigator.clipboard.writeText() to // work — without it the answer/code copy buttons silently fail. iframe.setAttribute('allow', 'clipboard-write'); Object.assign(iframe.style, { position: 'fixed', top: '0', right: '0', bottom: '0', // Initial width is overwritten by applyLayout() per current viewport; // any non-zero value works to avoid a 0-px flash before mount completes. width: panelWidth() + 'px', height: '100vh', border: '0', borderLeft: '1px solid rgba(0,0,0,0.08)', transform: 'translateX(100%)', transition: TRANSITION, zIndex: '999998', background: bgFor(detectTheme()), boxShadow: SHADOW_PUSH, }); iframe.addEventListener('load', function () { state.iframeReady = true; sendPageContext(); lastTheme = null; lastLang = null; sendTheme(); sendLanguage(); // Replay current expand state once the widget is ready. postToIframe({ type: 'uqpay-assistant.expand-state', expanded: state.expanded }); // B6: replay panel open/close state so widget can sync focus trap on first load. postToIframe({ type: 'uqpay-assistant.panel-state', open: state.open }); // Flush a quote selected before the iframe finished loading. if (state.pendingQuote) { var msg = { type: 'uqpay-assistant.quote' }; msg.text = state.pendingQuote.text; msg.sourceTitle = state.pendingQuote.sourceTitle; msg.url = state.pendingQuote.url; postToIframe(msg); state.pendingQuote = null; } }); return iframe; } // Floating fallback launcher — visible when v2-8 header pill is absent (e.g., // mobile viewport below Mintlify's `lg` breakpoint, or Mintlify navbar // missing). On desktop with a successfully injected header pill, this is // hidden via applyTriggerVisibility(). function buildTriggerButton() { var btn = document.createElement('button'); btn.type = 'button'; btn.id = 'uqpay-assistant-trigger'; btn.setAttribute('aria-label', 'Open UQPAY Developer Assistant'); btn.innerHTML = 'Ask AI'; Object.assign(btn.style, { position: 'fixed', right: '20px', bottom: '20px', display: 'flex', alignItems: 'center', padding: '10px 16px', borderRadius: '24px', background: '#1A56DB', color: '#fff', border: 'none', cursor: 'pointer', zIndex: '999999', fontFamily: 'system-ui, -apple-system, sans-serif', fontSize: '13px', fontWeight: '600', boxShadow: '0 4px 12px rgba(0,0,0,0.18)', }); btn.addEventListener('click', function () { setOpen(true); }); return btn; } // ===== v2-8: Mintlify header `Ask AI` pill ===== // Injects a brand-blue filled pill into Mintlify's navbar right slot, before // the Changelog link and theme toggle. Falls back gracefully — the floating // launcher (above) stays visible if injection fails or the slot is hidden // (Mintlify hides the right slot on viewports < `lg` breakpoint). function findHeaderRightSlot() { // Stable hook: theme-toggle has data-component-name (semantic). Walk up // until we hit the right-aligned flex container that holds Changelog + // theme-toggle. var anchor = document.querySelector('#navbar [data-component-name="theme-toggle"]'); if (!anchor) { // Fallback hook: the Changelog link is URL-based and equally stable. anchor = document.querySelector('#navbar a[href="/changelog"]'); } if (!anchor) return null; var node = anchor.parentElement; for (var i = 0; i < 6 && node; i++) { if (node.classList && node.classList.contains('justify-end')) return node; node = node.parentElement; } return null; } function buildHeaderBtn() { var btn = document.createElement('button'); btn.type = 'button'; btn.id = 'uqpay-assistant-header-btn'; btn.setAttribute('aria-label', 'Open UQPAY Developer Assistant'); btn.setAttribute('data-uqpay-assistant', 'header-pill'); btn.innerHTML = 'Ask AI'; Object.assign(btn.style, { display: 'inline-flex', alignItems: 'center', gap: '6px', padding: '6px 12px', borderRadius: '999px', background: '#1A56DB', color: '#fff', border: 'none', cursor: 'pointer', fontFamily: 'inherit', fontSize: '12.5px', fontWeight: '600', lineHeight: '1', whiteSpace: 'nowrap', flexShrink: '0', boxShadow: '0 1px 2px rgba(15,22,36,0.08)', transition: 'background 0.15s ease', }); btn.addEventListener('mouseenter', function () { btn.style.background = '#1748B5'; }); btn.addEventListener('mouseleave', function () { btn.style.background = '#1A56DB'; }); btn.addEventListener('click', function () { setOpen(!state.open); }); return btn; } function tryInjectHeaderBtn() { if (state.headerBtn && document.contains(state.headerBtn)) return true; var slot = findHeaderRightSlot(); if (!slot) return false; if (!state.headerBtn) state.headerBtn = buildHeaderBtn(); // Insert as the first child of the right slot — sits before Changelog + // theme toggle, matching design §4.1 ordering. slot.insertBefore(state.headerBtn, slot.firstChild); return true; } // ===== v2-7: Selection-to-ask ===== // Selecting text inside the docs body shows a small floating "Ask AI" tooltip; // clicking it (or pressing ⌘/Ctrl+I) sends the selection as a quote chip to the // widget and opens the panel. function getSourceTitle() { var h = document.querySelector('main h1, article h1, h1'); var t = h && h.textContent ? h.textContent.trim() : ''; return t || document.title || ''; } function getValidSelection() { var sel = window.getSelection ? window.getSelection() : null; if (!sel || sel.rangeCount === 0 || sel.isCollapsed) return null; var text = sel.toString().trim(); if (text.length < 2) return null; var range; try { range = sel.getRangeAt(0); } catch (e) { return null; } // Constrain to the docs app root — skip selections in header/nav/sidebar. if (!state.appRoot || !state.appRoot.contains(range.commonAncestorContainer)) return null; var rect = range.getBoundingClientRect(); if (!rect || (rect.width === 0 && rect.height === 0)) return null; return { text: text, rect: rect, sourceTitle: getSourceTitle(), url: window.location.href, }; } function buildSelectionTooltip() { var btn = document.createElement('button'); btn.type = 'button'; btn.id = 'uqpay-assistant-selection-tooltip'; btn.setAttribute('aria-label', 'Ask AI about selection'); btn.innerHTML = 'Ask AI'; Object.assign(btn.style, { position: 'fixed', display: 'none', gap: '5px', alignItems: 'center', padding: '6px 10px', borderRadius: '999px', background: '#0F1216', color: '#fff', border: 'none', cursor: 'pointer', zIndex: '999997', fontFamily: 'system-ui, -apple-system, sans-serif', fontSize: '12.5px', fontWeight: '600', lineHeight: '1', whiteSpace: 'nowrap', boxShadow: '0 6px 18px rgba(0,0,0,0.22)', transform: 'translate(-50%, calc(-100% - 8px))', }); // Prevent the click from collapsing the selection before we read it. btn.addEventListener('mousedown', function (e) { e.preventDefault(); }); btn.addEventListener('click', function (e) { e.preventDefault(); if (state.selectionSnapshot) sendQuote(state.selectionSnapshot); hideSelectionTooltip(); }); return btn; } function showSelectionTooltip(info, opts) { if (!state.selectionTooltip) { state.selectionTooltip = buildSelectionTooltip(); document.body.appendChild(state.selectionTooltip); } state.selectionSnapshot = info; var rect = info.rect; var x = rect.left + rect.width / 2; var y = rect.top; var tip = state.selectionTooltip; // Touch devices: always place below selection — iOS / Android native context // menus (Copy / Look Up / Share) appear above by default, so coexist below. // Desktop: above selection unless it's too close to viewport top. var placeBelow = (opts && opts.isTouch) || y < 36; if (placeBelow) { tip.style.transform = 'translate(-50%, 8px)'; y = rect.bottom; } else { tip.style.transform = 'translate(-50%, calc(-100% - 8px))'; } tip.style.left = x + 'px'; tip.style.top = y + 'px'; tip.style.display = 'inline-flex'; } function hideSelectionTooltip() { if (state.selectionTooltip) state.selectionTooltip.style.display = 'none'; state.selectionSnapshot = null; } function sendQuote(info) { setOpen(true); var payload = { text: info.text, sourceTitle: info.sourceTitle || '', url: info.url || window.location.href, }; if (state.iframeReady) { var msg = { type: 'uqpay-assistant.quote' }; msg.text = payload.text; msg.sourceTitle = payload.sourceTitle; msg.url = payload.url; postToIframe(msg); } else { // Defer to the iframe.load handler (above) which flushes pendingQuote. state.pendingQuote = payload; } } // ===== Mount ===== function mount() { state.appRoot = document.querySelector(APP_ROOT_SELECTOR); state.iframe = buildIframe(); state.triggerBtn = buildTriggerButton(); document.body.appendChild(state.iframe); document.body.appendChild(state.triggerBtn); // v2-8: try header pill injection. Floating fallback stays as defense. tryInjectHeaderBtn(); applyTriggerVisibility(); // Restore panel-open state across in-docs navigation (sessionStorage, // tab-scoped). Conversation itself is already persisted in widget's // localStorage, so the user lands back where they were. try { if (window.sessionStorage.getItem(OPEN_STATE_KEY) === '1') { setOpen(true); } } catch (e) {} // Iframe → loader actions: close / expand / collapse / navigate. window.addEventListener('message', function (e) { if (!e.data || typeof e.data !== 'object') return; if (e.data.type !== 'uqpay-assistant.action') return; switch (e.data.action) { case 'close': setOpen(false); break; case 'expand': setExpanded(true); break; case 'collapse': setExpanded(false); break; case 'navigate': { // Widget links arrive with various hosts: // - citation disclosure: full prod URL (developers.uqpay.com) // - markdown rendered in iframe: iframe-relative → da-poc.pages.dev // - rare: actually external (e.g. github.com / SO link in answer) // Treat the first two as "in-docs". Truly external hosts open in a // new tab so users don't lose context. var url = e.data.url; if (!url) break; try { var u = new URL(url, window.location.href); var isDocsHost = ( u.host === window.location.host || u.host === 'developers.uqpay.com' || u.host === 'da-poc.pages.dev' ); if (!isDocsHost) { window.open(url, '_blank', 'noopener,noreferrer'); break; } var localPath = u.pathname + u.search + u.hash; // Flash-free SPA path: find a Mintlify nav already in the DOM // pointing at the same pathname, and synthesize a click on it. // Mintlify links are Next.js Link components with React onClick // bound to the anchor — React's root-level click delegation picks // up the native click() and runs onClick → router.push, so the // page swaps content without reloading. Iframe + loader survive, // panel stays open. // // If no matching nav link exists (target not in sidebar), fall // back to a full reload — panel state is restored from // sessionStorage. var spaLink = document.querySelector( 'a[href="' + u.pathname + '"]' ); if (spaLink && spaLink.target !== '_blank' && spaLink.offsetParent !== null) { spaLink.click(); // Restore hash after SPA route — Mintlify's link doesn't carry it. if (u.hash) { setTimeout(function () { try { var target = document.querySelector(u.hash); if (target) target.scrollIntoView({ behavior: 'smooth' }); } catch (_) {} }, 350); } break; } window.location.href = localPath; } catch (_) { window.location.href = url; } break; } } }); // Mintlify dark-mode toggle on . if (typeof MutationObserver !== 'undefined') { var obs = new MutationObserver(sendTheme); obs.observe(document.documentElement, { attributes: true, attributeFilter: ['class', 'data-theme'], }); } // v2-10: re-apply layout on viewport resize so mobile ↔ desktop transitions // (window resize, device rotation) flip between full-screen modal and right-dock. // Also re-evaluates floating fallback visibility — Mintlify's header right slot // shows/hides at the `lg` breakpoint, and our header pill follows it. window.addEventListener('resize', function () { applyLayout(); applyTriggerVisibility(); }, { passive: true }); // v2-7: selection → tooltip + ⌘/Ctrl+I → quote chip postMessage. document.addEventListener('mouseup', function () { // Defer one tick so getSelection() reflects the final selection. setTimeout(function () { var info = getValidSelection(); if (info) showSelectionTooltip(info); else hideSelectionTooltip(); }, 0); }); // B2: touch devices fire touchend (not mouseup) when finger lifts from a // selection drag handle. iOS Safari may also synth mouseup later — that's // harmless since showSelectionTooltip is idempotent (same snapshot, same // position). 50 ms delay lets iOS finalize the selection range. document.addEventListener('touchend', function () { setTimeout(function () { var info = getValidSelection(); if (info) showSelectionTooltip(info, { isTouch: true }); else hideSelectionTooltip(); }, 50); }, { passive: true }); document.addEventListener('selectionchange', function () { var sel = window.getSelection ? window.getSelection() : null; if (!sel || sel.isCollapsed) hideSelectionTooltip(); }); window.addEventListener('scroll', hideSelectionTooltip, { passive: true }); document.addEventListener('keydown', function (e) { if (e.key === 'Escape') { hideSelectionTooltip(); return; } // ⌘/Ctrl + I — works without the tooltip being visible. var isI = e.key === 'i' || e.key === 'I' || e.code === 'KeyI'; if (isI && (e.metaKey || e.ctrlKey) && !e.altKey && !e.shiftKey) { var info = getValidSelection(); if (info) { e.preventDefault(); hideSelectionTooltip(); sendQuote(info); } } }); // SPA route changes — re-send page context + re-bind app root in case the // Mintlify SPA replaces the layout element. setInterval(function () { if (window.location.pathname !== state.lastPath) { state.lastPath = window.location.pathname; var freshRoot = document.querySelector(APP_ROOT_SELECTOR); if (freshRoot && freshRoot !== state.appRoot) { // Old root probably gone; clean its inline margin (no-op if detached) and // adopt the new one. if (state.appRoot) state.appRoot.style.marginRight = ''; state.appRoot = freshRoot; applyLayout(); } hideSelectionTooltip(); sendPageContext(); sendLanguage(); // path may have crossed /zh/ boundary on SPA route } // v2-8 self-heal: re-inject header pill if Mintlify's SPA re-render // detached it (or the slot was missing on first mount). if (!state.headerBtn || !document.contains(state.headerBtn)) { tryInjectHeaderBtn(); } applyTriggerVisibility(); }, 500); applyLayout(); } // ===== Widget kill switch (M3 / k3 fail-open) ===== // Resolves whether the docs-side widget should render. Pulls from admin // /admin/api/widget-status. Designed to NEVER block widget on transient // admin failures — that's the "fail-open" part: // // - 5s fetch timeout // - localStorage cache, 60s TTL // - On error or timeout → use cached value // - First failure (no cache) → assume enabled=true (don't hide widget // just because admin is misbehaving — better to risk leaving widget // up than to silently kill it across all docs pages) // // The admin base URL is configurable so prod / sandbox / mint-dev each // can point at the right backend: // 1. ?da_admin_base=URL — ad-hoc per-page override // 2. localStorage.UQPAY_ADMIN_BASE — sticky override (set + forget) // 3. localhost / 127.0.0.1 → DEV_ADMIN_BASE // 4. anywhere else → PROD_ADMIN_BASE // 5. empty → skip the check entirely, widget always renders // // To enable kill switch on a sandbox / prod build, set PROD_ADMIN_BASE // below to the named-tunnel URL (e.g. https://da.uqpay.com). var DEV_ADMIN_BASE = 'http://localhost:8001'; var PROD_ADMIN_BASE = ''; // <-- set to admin tunnel URL when ready var WIDGET_STATUS_CACHE_KEY = 'uqpay_widget_status_cache'; var WIDGET_STATUS_TTL_MS = 60 * 1000; var WIDGET_STATUS_TIMEOUT_MS = 5 * 1000; function resolveAdminBase() { try { var qs = new URLSearchParams(window.location.search); var fromQs = qs.get('da_admin_base'); if (fromQs) return fromQs; var fromLs = window.localStorage.getItem('UQPAY_ADMIN_BASE'); if (fromLs) return fromLs; } catch (e) {} var host = window.location.hostname; if (host === 'localhost' || host === '127.0.0.1') return DEV_ADMIN_BASE; return PROD_ADMIN_BASE; } function readCachedStatus() { try { var raw = window.localStorage.getItem(WIDGET_STATUS_CACHE_KEY); if (!raw) return null; var parsed = JSON.parse(raw); if (typeof parsed.enabled !== 'boolean') return null; return parsed; } catch (e) { return null; } } function writeCachedStatus(enabled) { try { window.localStorage.setItem(WIDGET_STATUS_CACHE_KEY, JSON.stringify({ enabled: enabled, ts: Date.now(), })); } catch (e) {} } function widgetEnabledOrTrue(cb) { var adminBase = resolveAdminBase(); if (!adminBase) { cb(true); return; } // no admin configured → always on var cached = readCachedStatus(); var fresh = cached && (Date.now() - cached.ts) < WIDGET_STATUS_TTL_MS; if (fresh) { cb(cached.enabled); return; } var done = false; var timer = setTimeout(function () { if (done) return; done = true; // Timeout → fail-open: use cached if any, else default true cb(cached ? cached.enabled : true); }, WIDGET_STATUS_TIMEOUT_MS); fetch(adminBase + '/admin/api/widget-status', { credentials: 'omit' }) .then(function (r) { if (!r.ok) throw new Error('status ' + r.status); return r.json(); }) .then(function (data) { if (done) return; done = true; clearTimeout(timer); var enabled = !!data.enabled; writeCachedStatus(enabled); cb(enabled); }) .catch(function (e) { if (done) return; done = true; clearTimeout(timer); // Network / parse error → fail-open try { console.debug('[uqpay-assistant] widget-status fetch failed:', e && e.message); } catch (_) {} cb(cached ? cached.enabled : true); }); } function bootstrap() { widgetEnabledOrTrue(function (enabled) { if (!enabled) { try { console.info('[uqpay-assistant] widget disabled by admin — skipping mount'); } catch (_) {} return; } mount(); }); } if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', bootstrap); } else { bootstrap(); } })();

概览

Documentation Index