// --- BASE CONFIG --- window.projectSlug = window.location.pathname.split("/").find(Boolean) || ""; const TechDocsConfig = { debug: true, selectors: { superHub: "#ssr-main > div > div[class^='SuperHub']", pageNotFound: "div[class^='PageNotFound'].rm-Container", ssrProps: "#ssr-props", searchModal: ".rm-SearchModal, [class*='SearchModal']", primaryNav: 'nav[aria-label="Primary navigation"]' }, projects: { onlyAuthHelp: [ "aura-secret-mgmt", "aura-lcdn-services", "aura-network-policy", "aura-lcdn-mapping", "aura-log-streaming", "aura-infrastructure", "aura-lcdn-deployment", "aura-lcdn-content-delivery", "aura-lcdn-content-control", "linode-api", "cloudtest", "msl5-harmonic" ], mutualAuth: ["iot-edge-message-stream", "iot-edge-connect-msg-store"], skipCodeComments: ["mpulse", "aura-secret-mgmt", "aura-lcdn-services", "aura-network-policy"], // Extracted dynamically if needed authLinks: ["mpulse", "cloudtest", "identity-cloud", "netstorage-usage", "iot-edge-message-stream", "iot-edge-connect-msg-store"] }, trackedButtons: new Set(['Copy Page', 'Open in ChatGPT', 'Open in Claude', 'View as Markdown']) }; // --- UTILITY RUNTIME TOOLS --- const Logger = { log: (msg, ...args) => TechDocsConfig.debug && console.log(`[PAGE INIT] ${msg}`, ...args), error: (msg, ...args) => console.error(`[PAGE ERROR] ${msg}`, ...args) }; const Utils = { debounce(func, wait) { let timeout; return function (...args) { clearTimeout(timeout); timeout = setTimeout(() => func.apply(this, args), wait); }; }, async fetchData(url, isText = false) { try { const response = await fetch(url, { method: "GET", headers: { Accept: "application/json" } }); return isText ? await response.text() : await response.json(); } catch (e) { Logger.error(`Fetch failure on ${url}`, e); return null; } }, isExternalLink(link) { if (!link || link.startsWith("/") || link.startsWith("#")) return false; const isSameSite = link.startsWith(window.location.origin); const isPdf = link.endsWith(".pdf") || link.includes(".pdf#"); return (isSameSite && isPdf) || !isSameSite; } }; // --- MODULE 1: DATA CONTEXT REGISTRY --- const ContextManager = { init() { try { const element = document.getElementById("ssr-props"); if (element) { window.initialProps = JSON.parse(element.innerHTML); window.initialPropsData = window.initialProps.context?.variables || {}; window.glossaryPropsData = window.initialProps.context?.terms || {}; } } catch (e) { Logger.log("initialProps parse failed — fallback defaults used.", e); window.initialProps = {}; window.initialPropsData = {}; window.glossaryPropsData = {}; } window.projectLabel = (document.querySelector('meta[property="og:site_name"]') ?.getAttribute("content") || window.projContentName || "").trim(); }, isHomePage() { const path = window.location.pathname; return path.includes("home") || path.includes("home-old"); }, isSection(type) { return window.location.pathname.includes(`/${type}/`); } }; // --- MODULE 2: ANALYTICS TRACKING ENGINE --- const AnalyticsEngine = { init() { this.bindStaticClickTrackers(); }, trackInteraction(linkValue) { if (window._satellite?.track) { window._satellite.track("click_interaction", { linkValue, adobeDataLayer: window.adobeDataLayer }); } }, getLanguageSelection(isDefault = true, isRef = true) { const classSelector = isRef ? ".rm-LanguageButton_active" : "section[aria-hidden='false'] button[class*='TutorialEditor-Nav-Tab_active']"; const langText = $(classSelector).text(); if (!langText?.trim()) return ""; const clickedText = isDefault ? '(Default)' : '(Clicked)'; const isSection = isRef ? "api:reference" : "recipes:recipe"; return `${isSection} language:${langText.trim()} ${clickedText}`; }, triggerLytics() { if (!window.lyticsTagFunction || typeof window.lyticsTagFunction !== "function" || navigator.userAgent.includes("Sinequa")) return; const groups = window.OptanonActiveGroups; const hasRequiredConsent = groups?.includes("C0002") && groups?.includes("C0004"); if (!hasRequiredConsent) return; if (typeof window.setNewSlug === "function" && window.setNewSlug()) { window.lyticsTagFunction(); } }, bindStaticClickTrackers() { // Track AI / Copy Interactions const COPY_AI_SELECTORS = 'button, a.Menu-Item[role="button"], div.Menu-Item[role="button"]'; document.addEventListener('click', (event) => { const targetElement = event.target.closest(COPY_AI_SELECTORS); if (!targetElement) return; const elementText = (targetElement.textContent || '').trim(); if (TechDocsConfig.trackedButtons.has(elementText)) { window._satellite?.track("click_interaction", { linkValue: `ai:${elementText}`, adobeDataLayer }); } }, { capture: true }); } }; // --- MODULE 3: INTERFACE ELEMENT MANAGER (UI) --- const UIManager = { resetScroll() { const hub = document.querySelector(TechDocsConfig.selectors.superHub); if (hub) hub.scrollTop = 0; }, check404ErrorPage() { const is404 = !!document.querySelector(TechDocsConfig.selectors.pageNotFound); if (is404) { document.documentElement.classList.add("err"); Logger.log("PageNotFound handled - 'err' added to DOM."); } }, addSidebarErrorIndicators() { $(".rm-Sidebar-link > span").each(function () { const parentCode = $(this).children().first().text(); const statusGroup = /^(\d)\d{2}$/.exec(parentCode)?.[1]; let iconClass = null; if (statusGroup === "5") { iconClass = "server-type"; } if (statusGroup === "4") { iconClass = "error-type"; } if (iconClass && !$(this).find('.status-code').length) { const icon = $(``); $(this).prepend(icon); } }); } }; $(window).on("pageLoad", UIManager.resetScroll); UIManager.check404ErrorPage(); ContextManager.init(); AnalyticsEngine.init(); function updateLoggedInDetailsOverride(duration = 200) { const isLoggedIn = document.documentElement.classList.contains("userLoggedIn"); const replaceLink = (element, loggedIn = false) => { if (!element) return; element.href = loggedIn ? element.href.replace("?redirect_uri=/home", "?redirect_uri=" + window.location.pathname) : element.href.replace("?redirect=/home", "?redirect=" + window.location.pathname); }; let ele; if (!privateProjects.includes(productSlugName)) { ele = document.querySelector("a.td-logout"); replaceLink(ele, true); ele = document.querySelector("div.td-logout a"); replaceLink(ele, true); } if (!isLoggedIn || !initialPropsData.user.email) { setTimeout(() => { ele = document.querySelector(".td-login"); replaceLink(ele); ele = document.querySelector(".td-mobile-login"); replaceLink(ele); }, duration); } if (isLoggedIn) { setTimeout(() => { let email = initialPropsData?.user?.email; if (!email) { try { email = JSON.parse(document.querySelector("#hub-me").dataset.json).user.email; } catch (e) { console.error("Error parsing user email", e.message); } } $(".td-user-icon").show(); $(".td-login .td-login-text").text(email).addClass("td-user"); $(".td-login").attr("data-tooltip", email); $(".td-mobile-login .td-login-text").text(email).addClass("td-user"); $(".td-login").attr("href", ""); $(".td-mobile-login").attr("href", ""); }, duration); } } $(window).on("pageLoad", function () { updateLoggedInDetailsOverride(); if (window.reWriteTags) { window.reWriteTags(); } if (perfCookieEnabled()) { if (!isMultipleSlug()) { _satellite.track("page_view", { url: window.location.href, adobeDataLayer }); } setTimeout(() => { if (window.location.pathname.includes("/reference/")) { const selectorValue = AnalyticsEngine.getLanguageSelection(); const trigger = isMultipleRefLangClicked(selectorValue); if (!trigger) { _satellite.track("click_interaction", { linkValue: selectorValue, adobeDataLayer }); } } if (window.location.pathname.includes("/recipes/")) { const selectorValue = AnalyticsEngine.getLanguageSelection(true, false); const trigger = isMultipleRefLangClicked(selectorValue); if (!trigger) { _satellite.track("click_interaction", { linkValue: selectorValue, adobeDataLayer }); } } }, 5); } AnalyticsEngine.triggerLytics(); }); $(window).on("click", ".rm-LanguageButton", function () { const selectorValue = AnalyticsEngine.getLanguageSelection(false); if (!isMultipleRefLangClicked(selectorValue)) { _satellite.track("click_interaction", { linkValue: selectorValue, adobeDataLayer }); } }); $(window).on("click", ".postman-run-button", function () { const selectorValue = `api:${document.querySelector("title").innerText}:run in postman`; _satellite.track("click_interaction", { linkValue: selectorValue, adobeDataLayer }); }); $(window).on("click", "a.rm-Header-link.rm-Header-bottom-link", function (e) { const selectorValue = `navigation:${e.target.textContent}`; _satellite.track("click_interaction", { linkValue: selectorValue, adobeDataLayer }); }); $(document).on("click", ".rm-LanguagePicker div[class*='LanguagePicker-MenuItem']", function () { setTimeout(() => { const selectorValue = AnalyticsEngine.getLanguageSelection(false); if (!isMultipleRefLangClicked(selectorValue)) { _satellite.track("click_interaction", { linkValue: selectorValue, adobeDataLayer }); } }, 5); }); $(window).on("click", ".TutorialEditor-Nav button", function () { const selectorValue = AnalyticsEngine.getLanguageSelection(false, false); if (!isMultipleRecipeLang(selectorValue)) { _satellite.track("click_interaction", { linkValue: selectorValue, adobeDataLayer }); } }); $(document).on("keyup", ".docsearch-wrapper input", function (e) { if (e.keyCode === 13) { const searchInputs = document.querySelectorAll(".docsearch-wrapper input"); let searchTerm = searchInputs[1]?.value; if (searchTerm == undefined || searchTerm === "") searchTerm = searchInputs[0]?.value; if (!searchTerm?.trim()) return ""; _satellite.track("site_search", { "search term": searchTerm, "search type": "project search", url: window.location.href, adobeDataLayer, }); } }); function removeBetaAndPillClasses() { const tocBetas = [ "li.toc-children a", "span[class*='Sidebar-link-text'] span" ]; tocBetas.forEach(selector => { const elements = document.querySelectorAll(selector); elements.forEach(element => { element.querySelectorAll("span.beta").forEach(span => span.classList.remove("beta")); element.querySelectorAll("span.toc-beta").forEach(span => span.classList.remove("toc-beta")); element.querySelectorAll("span.pill").forEach(span => span.classList.remove("pill")); }); }); } document.addEventListener("DOMContentLoaded", function () { if (window.location.href.includes("reference")) { setTimeout(removeBetaAndPillClasses, 100); } const ob_beta = new MutationObserver(function () { if (window.location.href.includes("reference")) { setTimeout(removeBetaAndPillClasses, 100); } }); const config = { childList: true, subtree: true, characterData: true }; ob_beta.observe(document.body, config); }); // DOCHUB 4302 (function () { let currentUrl = location.href; function isExactMatchLocal(element, txt) { return element.innerText.trim() === txt; } function upgradeApiStatusLabelsLocal(isParameterOption = true) { if (window.location.href.includes("/docs/")) { return; } const selector = isParameterOption ? ".param-type" : ""; document.querySelectorAll(`#content.rm-Article ${selector} strong`).forEach((strongElement) => { strongElement.classList.remove("deprecated", "beta", "la"); if (isExactMatchLocal(strongElement, "Deprecated")) { strongElement.classList.add("deprecated"); } if (isExactMatchLocal(strongElement, "Beta")) { strongElement.classList.add("beta"); } if (isExactMatchLocal(strongElement, "Limited availability")) { strongElement.classList.add("la"); } }); } function waitForApiResponseSchemaAndRun() { const targetClass = "APIResponseSchemaPicker-items2bs6Pzrheef_"; const observer = new MutationObserver((mutations, obs) => { const el = document.querySelector(`[class*="${targetClass}"]`); if (el) { obs.disconnect(); setTimeout(upgradeApiStatusLabelsLocal, 200); } }); observer.observe(document.body, { childList: true, subtree: true, }); } function hookHistoryChanges() { const originalPush = history.pushState; const originalReplace = history.replaceState; const onChange = () => { if (location.href !== currentUrl) { currentUrl = location.href; console.log("[Router] URL changed to", currentUrl); waitForApiResponseSchemaAndRun(); } }; history.pushState = function () { originalPush.apply(this, arguments); onChange(); }; history.replaceState = function () { originalReplace.apply(this, arguments); onChange(); }; window.addEventListener("popstate", onChange); } const cancelUpgradeApiStatusLabels = () => { if (typeof window.upgradeApiStatusLabelsInSchema === "function") { window.upgradeApiStatusLabelsInSchema = function () {}; } else { setTimeout(cancelUpgradeApiStatusLabels, 10); } }; cancelUpgradeApiStatusLabels(); hookHistoryChanges(); waitForApiResponseSchemaAndRun(); })(); $(window).on("pageLoad", function () { if (window.location.hostname.includes("techdocs.akamai.com")) { setTimeout(updateSearchBar, 200); } }); /* * init:migration: Only execute for refactored projects */ if (!window.location.pathname.includes("home") && !window.location.pathname.includes("home-old")) { window.updateSearchBar = function () {}; function isExternal(link) { if (!link || link.startsWith("/") || link.startsWith("#")) return false; const isSameSiteLink = link.startsWith(location.origin); const isPdfLink = link.endsWith(".pdf") || link.includes(".pdf#"); if (isSameSiteLink && isPdfLink) return true; return !isSameSiteLink; } function isPrivateLink(href, privateProjects = []) { return privateProjects.some(p => href.includes(p)); } window.openNewTab = function () { const list = document.querySelectorAll("a[href]:not(.external-link)"); list.forEach(function (a) { const href = a.getAttribute("href"); if (isExternal(href) && !isPrivateLink(href, privateProjects)) { a.setAttribute("target", "_blank"); a.classList.add("external-link"); } }); }; const isReferenceSection = () => window.location.pathname.includes("/reference/"); const isChangelogSection = () => window.location.pathname.includes("/changelog"); const onlyAuthHelpTxt = [ "aura-secret-mgmt", "aura-lcdn-services", "aura-network-policy", "aura-lcdn-mapping", "aura-log-streaming", "aura-infrastructure", "aura-lcdn-deployment", "aura-lcdn-content-delivery", "aura-lcdn-content-control", "linode-api", "cloudtest", "msl5-harmonic" ]; const projectsForMutualAuth = ["iot-edge-message-stream", "iot-edge-connect-msg-store"]; const projectsToSkipForCodeComment = ["mpulse", ...onlyAuthHelpTxt]; const authLink = new Set([ "mpulse", "cloudtest", "identity-cloud", "netstorage-usage", "iot-edge-message-stream", "iot-edge-connect-msg-store", ]); function debounce(func, wait) { let timeout; return function executedFunction(...args) { clearTimeout(timeout); timeout = setTimeout(() => func.apply(this, args), wait); }; } async function getData(url, isText = false) { const fetchOptions = { method: "GET", cache: "default", headers: { Accept: "application/json" }, redirect: "follow" }; const response = await fetch(url, fetchOptions); return isText ? await response.text() : await response.json(); } async function getDataFromEKV(groupId, itemId) { const url = `https://techdocs.akamai.com/api/ew?groupId=${groupId}&itemId=${itemId}`; return await getData(url, true); } function commentCodeLine(commentText = "") { return `

${commentText}

`; } function injectCodeComment() { if (!isReferenceSection()) return; const projName = location.pathname.split("/", 2)[1]; if (projectsToSkipForCodeComment?.includes(projName)) return; const codeHeaderExists = $(".CodeSnippet").text().includes("header"); const languageCommentSymbol = $(".rm-LanguageButton_active").text() === "Node" ? "//" : "#"; const authDiv = $("div.auth-code-comment"); if (authDiv.length) return; const commentText = projectsForMutualAuth?.includes(projName) ? "Use mutual auth or add JWT to this snippet" : "Add Authorization header to this snippet"; const commentLine = commentCodeLine(`${languageCommentSymbol} ${commentText}`); const codeLines = document.querySelectorAll(".CodeSnippet .CodeMirror-code > div"); for (let index = 0; index < codeLines.length; index++) { const codeElement = codeLines[index]; const txt = codeElement.textContent; const addElementBefore = txt.includes("options") || txt.includes("header") || txt.includes("sdk.") || txt.includes("sdk["); if (addElementBefore) { $(codeElement).before(commentLine); break; } if (!codeHeaderExists && txt.includes("url") && !txt.includes("curl")) { $(commentLine).insertAfter($(codeElement)); break; } } } $(document).on("focus", ".CodeSnippet, .rm-ParamInput, .ServerVars-form .ServerVars-input", function () { injectCodeComment(); }); $(document).on("change", ".CodeMirror-code", function () { injectCodeComment(); }); $(document).on("blur", ".CodeSnippet, .rm-ParamInput, .ServerVars-form .ServerVars-input", function () { injectCodeComment(); }); $(document).on("click", ".rm-PlaygroundRequest div[class*='APIRequest-menu-item'], div[class*='LanguagePicker-MenuItem']", function () { setTimeout(injectCodeComment, 200); }); $(document).on("click", ".rm-LanguagePicker .rm-LanguageButton", function () { setTimeout(injectCodeComment, 200); }); $(window).on("resize", debounce(function () { if (isReferenceSection() && !$("div.auth-code-comment").length) { injectCodeComment(); } }, 250)); function addPostmanButton(pmApiUrl, docsUrl, target) { const infoEle = `To run this code or try it in Postman, set up your authentication credentials.`; const auth = `

Not familiar with Postman? Learn how to use collections.

`; const button = `

`; const ele = $( `

AUTHENTICATE & TRY IT

${infoEle}${auth}${button}

` ); ele.insertAfter($("#ReferencePlayground > section:nth-child(1)")); } async function postmanAuth() { if (!isReferenceSection()) return false; const postmanSessionItem = "akam_pm_info"; const apiTitle = document.querySelector(".rm-Sidebar-section .rm-Sidebar-link:not([class*='Sidebar-link_hidden'])")?.innerText; console.log("[DEBUG] apiTitle", apiTitle); if (!apiTitle) return false; let pmInfo = sessionStorage.getItem(postmanSessionItem); pmInfo = pmInfo ? JSON.parse(pmInfo) : null; if (!pmInfo) { pmInfo = await getData("https://techdocs.akamai.com/assets/postman.json"); sessionStorage.setItem(postmanSessionItem, JSON.stringify(pmInfo)); } const { collections, collectionBaseUrl } = pmInfo; if (!collections?.hasOwnProperty(apiTitle)) return false; const groupId = apiTitle.replace(/ /g, "_"); await new Promise(r => setTimeout(r, 350)); const itemId = document.querySelector("title")?.innerText ?.replace(/ /g, "_") .replace(/'/g, "") .replace(/\//g, ""); if (!itemId) return false; const ssKey = `${groupId}-${itemId}`; let eId = sessionStorage.getItem(ssKey); if (!eId) { const endpointId = await getDataFromEKV(groupId, itemId); if (!endpointId || endpointId.includes("Error")) { $("section.PostmanSection").remove(); return false; } eId = endpointId.replace(/"/g, ""); sessionStorage.setItem(ssKey, eId); } $("span.auth-section-info").parent().remove(); const partialUrl = collections[apiTitle][0]; const pmApiUrlToUse = `${collectionBaseUrl}/${partialUrl}${eId}`; let target = "_blank"; let docsUrl = "https://techdocs.akamai.com/developer/docs/set-up-authentication-credentials"; if (!partialUrl.startsWith("akamai-apis/")) { document.querySelectorAll(".rm-Sidebar-section:first-child .rm-Sidebar-link").forEach(x => { if (x.textContent?.toLowerCase().includes("get started")) { docsUrl = x.href; target = "_self"; } }); } addPostmanButton(pmApiUrlToUse, docsUrl, target); return true; } async function authHelp() { if (!isReferenceSection()) return; const projName = location.pathname.split("/", 2)[1]; function credentialElementLink() { const isIncluded = authLink.has(projName) || onlyAuthHelpTxt.includes(projName); const target = isIncluded ? "_self" : "_blank"; let link = isIncluded ? `${projName}/reference/get-started` : "developer/docs/set-up-authentication-credentials"; let txt = onlyAuthHelpTxt.includes(projName) ? "authorization token" : "authentication credentials"; if (projName === "mpulse") { const category = $(".rm-Sidebar-section .subnav-expanded .rm-Sidebar-link.active") .first() .parents(".rm-Sidebar-section") .children() .first() .text(); if (["Beacons"].includes(category)) { link = "mpulse/reference/beacons#getting-started"; txt = "API key"; } else { txt = "authentication token"; } } return `${txt}`; } function addAuthSection() { const authHeaderText = onlyAuthHelpTxt.includes(projName) ? `Remember to get your ${credentialElementLink()} to run this code.` : `Remember to add your ${credentialElementLink()} to run this code.`; const infoEle = `${authHeaderText}`; const header = $(".APIAuth [class*='APISectionHeader3LN'] [class*='APISectionHeader']"); if (header.length > 0) { if (header.text() === "Authorization") { header.text("Authentication"); if (!header.parent().next().hasClass("auth-section-info")) { header.parent().after(infoEle); } } } else if (projName !== "linode-api") { if ($("span.auth-section-info").length === 0) { const authEleSection = `

Authentication

${infoEle}

`; $("#ReferencePlayground").children().eq(1).before(authEleSection); } } } if (!onlyAuthHelpTxt.includes(projName)) { $("section.InputGroup").hide(); } const hasPostman = await postmanAuth(); $("span.auth-section-info").show(); if (!hasPostman) { addAuthSection(); } if (!$("div.auth-code-comment").length) { injectCodeComment(); } } function readMore() { if (!isChangelogSection()) return; const hasTxt = document.querySelectorAll(".ch-release-note").length; if (hasTxt) return; document.querySelectorAll(".rm-Changelog article[class*='ChangelogPostExcerpt']").forEach(post => { const href = post.querySelectorAll("h2 a")[0]?.getAttribute("href"); if (!href) return; const span = document.createElement("span"); span.classList.add("ch-release-note"); span.innerText = "Read full release note"; post.querySelectorAll("section.markdown-body")[0]?.append(span); }); } $(window).on("click", "a.rm-Header-bottom-link, a[class*='Pagination-link']", function () { if (this.getAttribute("href")?.includes("changelog")) readMore(); }); $(document).on("click", ".ch-release-note", function () { $(this).parent().siblings("h2").children("a").trigger("click"); }); function releaseNotesBackButton() { if (!isChangelogSection()) return; const backBtnDiv = document.querySelector(".rm-Changelog article.rm-Changelog-post > div"); if (!backBtnDiv) return; const projContentName = document.querySelector("meta[property='og:site_name']").content; const btnText = projContentName + " release notes"; const span = backBtnDiv.querySelectorAll("button span")[1]; if (span) { span.innerText = btnText; } else { const firstLink = backBtnDiv.querySelectorAll("a")[0]; const spanIcon = firstLink.querySelectorAll("span")[0].outerHTML; firstLink.innerHTML = spanIcon + `${btnText}`; firstLink.style.display = "flex"; } const backToAllBtn = document.querySelector(".rm-Changelog a.to_all_notes"); if (!backToAllBtn) { const anchor = document.createElement("a"); anchor.className = "Button Button_sm Button Button_sm Button_text to_all_notes ChangelogPost_backVFYixWm1Jvy7 Button_primary"; anchor.type = "button"; anchor.href = "/release-notes/docs"; anchor.innerHTML = 'All release notes'; anchor.style.display = "flex"; backBtnDiv.appendChild(anchor); } const div = document.querySelector("article.rm-Changelog-post div[class*='ChangelogPage_back']"); if (div) div.style.display = "flex"; } function collapsibleTableRows() { const tables = document.querySelectorAll("table"); if (!tables.length) return; const expandableRows = document.querySelectorAll("tr.expand"); if (expandableRows.length) return; $("table").each(function () { const colLength = $(this).children().first().children().first().children().length; const tRows = $(this).children().find("tr"); tRows.each(function (j, tRow) { if (j === tRows.length - 1) return; const rowChilds = $(this).children(); let len = 0; rowChilds.length && rowChilds.each(function () { if ($(this).html() === "") len += 1; }); if (len === rowChilds.length - 1 && $(rowChilds[0]).html() !== "") { if ($(this).hasClass("expand")) return; $(this).addClass("expand"); rowChilds.first().siblings().remove().wrapInner(""); rowChilds .prepend('') .wrapInner(''); tRow.firstElementChild.setAttribute("colspan", colLength); tRow.firstElementChild.style.fontWeight = "600"; } }); }); console.log("Collapsible table rows initialized"); } $(document).on("click", ".clickable-triangle", function () { const triangleSpan = $(this).children().first(); triangleSpan.toggleClass("triangle-right"); triangleSpan.toggleClass("triangle-bottom"); $(this).parent().parent().nextUntil("tr.expand").toggle(); }); function waitForElement(selector) { return new Promise(resolve => { const existingElement = document.querySelector(selector); if (existingElement) { return resolve(existingElement); } const observer = new MutationObserver((mutations, obs) => { const element = document.querySelector(selector); if (element) { resolve(element); obs.disconnect(); } }); observer.observe(document.body, { childList: true, subtree: true, }); }); } function waitForAllElements(selector, callback, settleTime = 100, maxWait = 4000) { const initialElements = document.querySelectorAll(selector); if (initialElements.length > 0) { callback(); return; } let settleTimer; // Fail-safe: Give up after maxWait (e.g., 4 seconds) so it doesn't run forever on pages const failSafeTimer = setTimeout(() => { observer.disconnect(); }, maxWait); const observer = new MutationObserver((mutations, obs) => { const elements = document.querySelectorAll(selector); if (elements.length > 0) { clearTimeout(failSafeTimer); clearTimeout(settleTimer); settleTimer = setTimeout(() => { obs.disconnect(); callback(); }, settleTime); } }); observer.observe(document.body, { childList: true, subtree: true }); } function retryUntilReady(checkAndApply, { interval = 100, maxTries = 30 } = {}) { let tries = 0; const id = setInterval(() => { tries++; const done = checkAndApply(); if (done || tries >= maxTries) clearInterval(id); }, interval); } function tryReadMore() { if (!isChangelogSection()) return true; const articles = document.querySelectorAll(".rm-Changelog article[class*='ChangelogPostExcerpt']"); if (!articles.length) return false; readMore(); return true; } function tryReleaseNotesBackButton() { if (!isChangelogSection()) return true; const backBtnDiv = document.querySelector(".rm-Changelog article.rm-Changelog-post > div"); if (!backBtnDiv) return false; releaseNotesBackButton(); return true; } $(window).on("pageLoad", async () => { setTimeout(() => { document .querySelectorAll(".rm-SearchToggle-placeholder") .forEach(x => (x.innerHTML = "Search this doc set")); updateLoggedInDetailsOverride(); }, 100); if (isChangelogSection()) { waitForAllElements(".rm-Changelog article[class*='ChangelogPostExcerpt']", readMore, 150); waitForElement(".rm-Changelog article.rm-Changelog-post > div").then(releaseNotesBackButton); } if (isReferenceSection()) { setTimeout(async () => { await postmanAuth(); }, 500); injectCodeComment(); } UIManager.addSidebarErrorIndicators(); waitForAllElements("table", collapsibleTableRows, 100); }); $(window).on("click", "a.td-contact", function () { $("a.td-contact .td-icon-nav-up").toggleClass("td-icon-down"); $(".td-contact-dropdown-content").toggle(); $(".td-login-dropdown-content").hide(); }); $(window).on("click", ".td-login", function (e) { if (!$(".td-login").attr("href")) { e.preventDefault(); } $(".td-login-dropdown-content").toggle(); $(".td-contact-dropdown-content").hide(); $(".td-contact .td-icon").removeClass("td-icon-down"); }); $(window).on("click", ".td-mobile-nav-icons .td-icon-menu", function () { $(".td-mobile").toggle(); $(".td-search-flyout").hide(); $(".td-mobile-nav-icons .icon-search1").removeClass("td-active"); $(".td-icon-menu").toggleClass("td-icon-hover"); }); $(window).on("click", ".err .td-mobile-nav-icons-1 .td-icon-menu", function () { $(".td-mobile").toggle(); $(".err .td-search-flyout-1").hide(); $(".err .td-mobile-nav-icons-1 .icon-search1").removeClass("td-active"); $(".td-icon-menu").toggleClass("td-icon-hover"); }); $(window).on("blur", ".td-contact-dropdown", function (e) { if (!e.relatedTarget) { $(".td-contact-dropdown-content").hide(); $(".td-contact .td-icon").removeClass("td-icon-down"); } }); $(window).on("blur", ".td-login", function (e) { if (!e.relatedTarget) { $(".td-login-dropdown-content").hide(); } }); $(window).on("click", ".td-mobile-nav-icons .icon-search1", function () { $(".td-search-flyout").toggle(); $(".td-mobile").hide(); $(".td-icon-menu").removeClass("td-icon-hover"); $(".td-mobile-nav-icons .icon-search1").toggleClass("td-active"); }); $(window).on("click", ".err .td-mobile-nav-icons-1 .icon-search1", function () { $(".err .td-search-flyout-1").toggle(); $(".td-mobile").hide(); $(".td-icon-menu").removeClass("td-icon-hover"); $(".err .td-mobile-nav-icons-1 .icon-search1").toggleClass("td-active"); }); window.addEventListener("load", () => { setTimeout(() => { document.querySelectorAll(".rm-SearchToggle-placeholder")?.forEach(x => (x.innerHTML = "Search this doc set")); setTimeout(collapsibleTableRows, 1000); isChangelogSection() && readMore(); }, 1000); }); } // Beta pills upgrade for refactored $(document).on("click", ".Button_slate_text.Button_md.rm-Header-bottom-link", function () { setTimeout(function () { const spans = document.querySelectorAll('span[class^="VersionBadge"]'); spans.forEach((span) => { console.log(span); if (span.textContent.trim() === "Beta") { span.classList.add("beta"); } }); }, 100); }); // README-532 do not create beta pills in text content function isExactMatch(element, txt) { return element.innerText.trim() === txt; } function upgradeApiStatusLabels(isParameterOption = true) { if (window.location.href.includes("/docs/")) { return; } const selector = isParameterOption ? ".param-type" : ""; document.querySelectorAll(`#content.rm-Article ${selector} strong`).forEach((strongElement) => { strongElement.classList.remove("deprecated"); strongElement.classList.remove("beta"); strongElement.classList.remove("la"); if (isExactMatch(strongElement, "Deprecated")) { strongElement.classList.add("deprecated"); } if (isExactMatch(strongElement, "Beta")) { strongElement.classList.add("beta"); } if (isExactMatch(strongElement, "Limited availability")) { strongElement.classList.add("la"); } }); } function upgradeApiStatusLabelsInSchema() { const buttons = document.querySelectorAll('[class*="APIResponseSchemaPicker-option"]'); buttons.forEach(function (button) { button.addEventListener("click", () => { setTimeout(upgradeApiStatusLabels, 5); }); }); } function upgradeApiStatusLabelsInNav() { function replaceNavStatus(labelType, element, text) { const remainingText = text.substring(labelType.length); const strongTag = document.createElement("strong"); strongTag.textContent = labelType.charAt(0).toUpperCase() + labelType.slice(1); strongTag.className = labelType; element.innerHTML = ""; element.appendChild(strongTag); element.appendChild(document.createTextNode(`${remainingText}`)); } const swaggerTitlesNav = document.querySelectorAll(".rm-Sidebar h3"); swaggerTitlesNav.forEach((title) => { const text = title.textContent.trim(); if (text.startsWith("Beta")) { replaceNavStatus("beta", title, text); } if (text.startsWith("Deprecated")) { replaceNavStatus("deprecated", title, text); } if (text.startsWith("Limited availability")) { replaceNavStatus("la", title, text); } }); } // README-468 Beta labels nested in clickable properties in schemas function schemaNestedStatusLabels() { document.querySelectorAll("button[class*='Param-expand']").forEach(button => { button.addEventListener("click", function () { setTimeout(() => { const container = this.parentElement.querySelector("[class*='Param-children']"); if (container && container.style.display !== "none" && getComputedStyle(container).display !== "none") { container.querySelectorAll("p strong").forEach(strongElement => { if (isExactMatch(strongElement, "Deprecated")) { strongElement.classList.add("deprecated"); } if (isExactMatch(strongElement, "Beta")) { strongElement.classList.add("beta"); } if (isExactMatch(strongElement, "Limited availability")) { strongElement.classList.add("la"); } }); } }, 200); }); }); } // README-408 Beta labels in guides function handleBetaInHeadings(heading, size, isApi = false) { if (!isApi && window.location.href.includes("/docs/")) { const headingTextDivs = document.querySelectorAll(heading); headingTextDivs.forEach(div => { const betaRegex = /$Beta$/i; const laRegex = /$Limited availability$/i; const deprecatedRegex = /$Deprecated$/i; if (betaRegex.test(div.innerHTML)) { div.innerHTML = div.innerHTML.replace( betaRegex, `(Beta)` ); } if (laRegex.test(div.innerHTML)) { div.innerHTML = div.innerHTML.replace( laRegex, `(Limited availability)` ); } if (deprecatedRegex.test(div.innerHTML)) { div.innerHTML = div.innerHTML.replace( deprecatedRegex, `(Deprecated)` ); } }); } } function applyBetaChanges() { const bodyBetas = [ "h1.heading .heading-text", "h2.heading .heading-text", "h3.heading .heading-text", ".col-xs-9 h1" ]; const tocBetas = [ "li.toc-children a", "span[class*='Sidebar-link-text'] span" ]; bodyBetas.forEach(selector => { handleBetaInHeadings(selector, "super-text"); }); tocBetas.forEach(selector => { handleBetaInHeadings(selector, "toc-beta"); }); } function applyAllBetaChanges() { applyBetaChanges(); upgradeApiStatusLabels(false); setTimeout(() => upgradeApiStatusLabels(true), 50); upgradeApiStatusLabelsInNav(); setTimeout(upgradeApiStatusLabelsInSchema, 200); setTimeout(schemaNestedStatusLabels, 100); } document.addEventListener("DOMContentLoaded", function () { applyAllBetaChanges(); let labelTimer = null; const config = { childList: true, subtree: true, characterData: true }; const observer = new MutationObserver(function () { observer.disconnect(); clearTimeout(labelTimer); labelTimer = setTimeout(() => { applyAllBetaChanges(); observer.observe(document.body, config); }, 50); }); observer.observe(document.body, config); }); $(window).on("pageLoad", function () { setTimeout(applyAllBetaChanges, 200); }); // ======================================== // SEARCH DEBUG + BEHAVIOR // ======================================== // GOALS // 1) Top/global search input opens modal and clears project filters // 2) Native header search button opens modal and auto-checks current project // 3) Invalid tabs remain visible, but are fully blocked when scoped to a project // 4) If current project is manually unchecked, tabs behave normally again // 5) Debug logging included // ======================================== (function () { const HEADER_SEARCH_BUTTON_SELECTOR = ".rm-Header-search .rm-SearchToggle"; const TOP_SEARCH_INPUT_SELECTOR = ".docsearch-bar input, .docsearch-wrapper input"; const SEARCH_MODAL_SELECTOR = ".rm-SearchModal, [class*='SearchModal']"; const PRIMARY_NAV_SELECTOR = 'nav[aria-label="Primary navigation"]'; const PROJECT_SLUG = window.location.pathname.split("/").filter(Boolean)[0] || ""; const LOCAL_PROJECT_PREFIX = PROJECT_SLUG ? `/${PROJECT_SLUG}/` : ""; const PROJECT_LABEL = ( document.querySelector('meta[property="og:site_name"]')?.getAttribute("content") || window.projContentName || "").trim(); if (!PROJECT_LABEL || !PROJECT_SLUG) { console.warn("[SEARCH DEBUG] Missing PROJECT_LABEL or PROJECT_SLUG", { PROJECT_LABEL, PROJECT_SLUG }); return; } let pendingProjectScope = false; let appliedForCurrentOpen = false; let pollTimer = null; let activeModal = null; let isProgrammaticOpen = false; function dbg(label, data) { try { // console.log(`[SEARCH DEBUG] ${label}`, data || ""); } catch (e) {} } function normalizeText(value) { return (value || "").replace(/\s+/g, " ").trim().toLowerCase(); } function clearPoll() { if (pollTimer) { clearInterval(pollTimer); pollTimer = null; dbg("clearPoll()"); } } function getModal() { return document.querySelector(SEARCH_MODAL_SELECTOR); } function isModalVisible(modal) { return !!(modal && (modal.classList.contains("show-modal") || modal.offsetParent !== null)); } function getSearchProjectInputs(modal) { if (!modal) return []; return [...modal.querySelectorAll("label")] .map((label) => { const textEl = label.querySelector(".Toggle-label, .Toggle-label_md, [class*='Toggle-label']"); const input = label.querySelector('input[type="checkbox"]'); if (!textEl || !input) return null; return { label, input, text: normalizeText(textEl.textContent), rawText: textEl.textContent }; }) .filter(Boolean); } function getCurrentProjectInput(modal) { const target = normalizeText(PROJECT_LABEL); const options = getSearchProjectInputs(modal); dbg("getCurrentProjectInput() options", options.map(o => ({ rawText: o.rawText, normalized: o.text, checked: o.input.checked }))); const match = options.find((option) => option.text === target); dbg("getCurrentProjectInput() match", match ? { rawText: match.rawText, normalized: match.text, checked: match.input.checked } : null); return match?.input || null; } function getHubMeData() { try { const el = document.querySelector("#hub-me"); if (!el?.dataset?.json) return null; return JSON.parse(el.dataset.json); } catch (e) { dbg("getHubMeData() parse failed", e); return null; } } function getCurrentProjectMeta() { const hubMe = getHubMeData(); const meta = hubMe?.search?.metaData || []; if (!Array.isArray(meta)) return null; const found = meta.find((p) => normalizeText(p.subdomain) === normalizeText(PROJECT_SLUG)) || meta.find((p) => normalizeText(p.name) === normalizeText(PROJECT_LABEL)); dbg("getCurrentProjectMeta()", found ? { name: found.name, subdomain: found.subdomain, modules: found.modules, nav_names: found.nav_names } : null); return found || null; } function getCurrentProjectNavState() { const nav = document.querySelector(PRIMARY_NAV_SELECTOR); if (!nav) { dbg("getCurrentProjectNavState() no nav found"); return null; } const links = [...nav.querySelectorAll("a.rm-Header-bottom-link")]; const state = { enabled: new Set(), disabled: new Set() }; links.forEach((link) => { const href = link.getAttribute("href") || ""; const isLocalProjectLink = href.startsWith(LOCAL_PROJECT_PREFIX); if (!isLocalProjectLink) return; const text = normalizeText(link.textContent); if (!text) return; const isDisabled = link.classList.contains("NavItem_muted2-OqeulnYimX") || !!link.querySelector('[aria-label="Section Disabled"]') || !!link.querySelector('[class*="DisabledSectionBadge"]'); if (isDisabled) { state.disabled.add(text); } else { state.enabled.add(text); } }); dbg("getCurrentProjectNavState()", { enabled: [...state.enabled], disabled: [...state.disabled] }); return state; } function tryCheckProjectBox(modal) { if (!modal || !pendingProjectScope || appliedForCurrentOpen) { dbg("tryCheckProjectBox() skipped", { hasModal: !!modal, pendingProjectScope, appliedForCurrentOpen }); return false; } const matchedInput = getCurrentProjectInput(modal); if (!matchedInput) { dbg("tryCheckProjectBox() no matched input"); return false; } dbg("tryCheckProjectBox() before", { checked: matchedInput.checked, project: PROJECT_LABEL }); if (!matchedInput.checked) { matchedInput.click(); dbg("tryCheckProjectBox() clicked checkbox"); } appliedForCurrentOpen = true; pendingProjectScope = false; clearPoll(); return true; } function startProjectScopePolling(modal) { clearPoll(); let attempts = 0; const maxAttempts = 30; dbg("startProjectScopePolling()", { maxAttempts }); pollTimer = setInterval(() => { attempts += 1; dbg("poll tick", { attempts }); const worked = tryCheckProjectBox(modal); if (worked || attempts >= maxAttempts) { dbg("poll finished", { worked, attempts }); clearPoll(); } }, 100); } function clearAllProjectFilters(modal) { if (!modal) return; const inputs = getSearchProjectInputs(modal) .map(option => option.input) .filter(Boolean); dbg("clearAllProjectFilters()", { checkedCount: inputs.filter(input => input.checked).length }); inputs.forEach((input) => { if (input.checked) { input.click(); } }); } function clearAllProjectFiltersWhenReady() { let attempts = 0; const maxAttempts = 20; dbg("clearAllProjectFiltersWhenReady() start"); const interval = setInterval(() => { attempts += 1; const modal = getModal(); dbg("clearAllProjectFiltersWhenReady() tick", { attempts, modalVisible: isModalVisible(modal) }); if (!isModalVisible(modal)) { if (attempts >= maxAttempts) clearInterval(interval); return; } const inputs = getSearchProjectInputs(modal); if (inputs.length) { clearAllProjectFilters(modal); clearInterval(interval); dbg("clearAllProjectFiltersWhenReady() done"); return; } if (attempts >= maxAttempts) { clearInterval(interval); } }, 100); } function resetModalState() { dbg("resetModalState()"); appliedForCurrentOpen = false; pendingProjectScope = false; clearPoll(); activeModal = null; isProgrammaticOpen = false; } // Native header search button: SHOULD project-scope $(document).off("click.searchDebugHeader", HEADER_SEARCH_BUTTON_SELECTOR); $(document).on("click.searchDebugHeader", HEADER_SEARCH_BUTTON_SELECTOR, function (e) { dbg("HEADER SEARCH BUTTON click", { isProgrammaticOpen, target: e.target }); if (isProgrammaticOpen) { dbg("HEADER SEARCH BUTTON ignored because programmatic"); return; } pendingProjectScope = true; appliedForCurrentOpen = false; }); // Top/global search input: SHOULD open only, clear all project filters $(document).off("mousedown.searchDebugTop", TOP_SEARCH_INPUT_SELECTOR); $(document).on("mousedown.searchDebugTop", TOP_SEARCH_INPUT_SELECTOR, function (e) { dbg("TOP SEARCH mousedown", { selector: TOP_SEARCH_INPUT_SELECTOR, target: e.target }); e.preventDefault(); e.stopImmediatePropagation(); pendingProjectScope = false; appliedForCurrentOpen = false; if (typeof this.blur === "function") { this.blur(); } const btn = document.querySelector(HEADER_SEARCH_BUTTON_SELECTOR); dbg("TOP SEARCH forcing native button click", { foundButton: !!btn }); if (btn) { isProgrammaticOpen = true; btn.click(); setTimeout(() => { isProgrammaticOpen = false; dbg("TOP SEARCH cleared isProgrammaticOpen"); clearAllProjectFiltersWhenReady(); }, 0); } }); $(document).off("click.searchDebugTop", TOP_SEARCH_INPUT_SELECTOR); $(document).on("click.searchDebugTop", TOP_SEARCH_INPUT_SELECTOR, function (e) { dbg("TOP SEARCH click", { selector: TOP_SEARCH_INPUT_SELECTOR, target: e.target }); e.preventDefault(); e.stopImmediatePropagation(); }); // Observer const observer = new MutationObserver(() => { const modal = getModal(); if (!isModalVisible(modal)) { resetModalState(); return; } if (modal !== activeModal) { activeModal = modal; appliedForCurrentOpen = false; dbg("new modal detected", modal); } if (pendingProjectScope && !appliedForCurrentOpen) { dbg("observer starting project scope polling"); startProjectScopePolling(modal); } else { } }); observer.observe(document.body, { childList: true, subtree: true }); dbg("initialized", { PROJECT_LABEL, PROJECT_SLUG, LOCAL_PROJECT_PREFIX }); })();

201An HTTP 201 will be returned if the request is successfully processed, and a new shared-secret-set object is created. The location of the new object will be specified in the location header.

400An HTTP 400 will be returned if the request is badly formed or has constraint violations

403An HTTP 403 will be returned if the principal is not authorized to access the instance of blocklist that the request was made against.

409An HTTP 409 will be returned if the blocklist offered for create/update would lead to a conflicting state.