/** * Custom Analytics for Mintlify - Adds storage properties to Mixpanel events * * This script collects data from localStorage, sessionStorage, cookies, and browser properties * and automatically includes them in all Mixpanel events. * * To inject this script into Mintlify: * 1. Add this file to your Mintlify repository * 2. In docs.json, add: * { * "custom": { * "scripts": [ * "/custom-analytics.js" * ] * } * } */ (function() { 'use strict'; // Mixpanel token for Mintlify docs.base44.com const MIXPANEL_TOKEN = 'cc6e9e106e4b833fc3a3819c11b74138'; // CRITICAL: Set up early interception of mixpanel.track() and fetch/XHR/sendBeacon BEFORE anything else // This must be done immediately to catch Mixpanel SDK even if it's already loaded (function() { // Helper function to get storage properties (will be defined later, but we'll call it when needed) let getAllStoragePropertiesFunc = null; // Helper function to check if URL is a Mixpanel API URL function isMixpanelURL(url) { if (!url || typeof url !== 'string') return false; return url.includes('mixpanel.com/track') || url.includes('mixpanel.com/engage') || url.includes('mixpanel.com/api'); } // Helper function to get storage properties (with fallback) function getStorageProps() { try { if (getAllStoragePropertiesFunc && typeof getAllStoragePropertiesFunc === 'function') { return getAllStoragePropertiesFunc(); } // Fallback: try to read cookies directly if function not available yet const props = {}; try { document.cookie.split(';').forEach(cookie => { const [name, value] = cookie.trim().split('='); if (name && value) { props[`cookie_${name}`] = value; } }); } catch (e) { // Ignore } return props; } catch (e) { return {}; } } function setupEarlyInterception() { if (!window.mixpanel) { return false; } // Intercept track() if not already intercepted if (typeof window.mixpanel.track === 'function' && !window.mixpanel.track._mintlifyIntercepted) { const originalTrack = window.mixpanel.track; window.mixpanel.track = function(eventName, properties, callback) { try { // Get storage properties (with fallback) const storageProps = getStorageProps(); // Merge storage properties into event properties const mergedProperties = properties || {}; Object.assign(mergedProperties, storageProps); // Call original track with merged properties return originalTrack.call(this, eventName, mergedProperties, callback); } catch (e) { console.warn('[Mintlify Analytics] Error in early interception:', e); // Fallback: call original track without modification return originalTrack.call(this, eventName, properties, callback); } }; window.mixpanel.track._mintlifyIntercepted = true; console.log('[Mintlify Analytics] Early interception of mixpanel.track() set up'); } return true; } // Intercept fetch early (before interceptMixpanelAPI is called) // Mark it so the main interception knows it's already intercepted const originalFetch = window.fetch; if (!window.fetch._mintlifyIntercepted) { window.fetch._mintlifyOriginalFetch = originalFetch; window.fetch._mintlifyIntercepted = true; } window.fetch = function(...args) { const url = args[0]; if (isMixpanelURL(url)) { console.log('[Mintlify Analytics] EARLY fetch interception: Mixpanel event detected', { url: url, hasBody: !!(args[1] && args[1].body), storageFuncAvailable: !!(getAllStoragePropertiesFunc && typeof getAllStoragePropertiesFunc === 'function'), timestamp: new Date().toISOString() }); if (args[1] && args[1].body) { try { const body = args[1].body; let bodyStr = ''; if (typeof body === 'string') { bodyStr = body; } else if (body instanceof FormData) { bodyStr = body.get('data') || ''; } if (bodyStr && bodyStr.startsWith('data=')) { const decoded = decodeURIComponent(bodyStr.substring(5)); const events = JSON.parse(decoded); const storageProps = getStorageProps(); const cookieCount = Object.keys(storageProps).filter(k => k.startsWith('cookie_')).length; console.log('[Mintlify Analytics] EARLY fetch interception: Adding storage props', { eventCount: Array.isArray(events) ? events.length : 0, cookieCount: cookieCount, hasStorageFunc: !!(getAllStoragePropertiesFunc && typeof getAllStoragePropertiesFunc === 'function'), eventNames: Array.isArray(events) ? events.map(e => e.event || e.name || 'unknown') : [] }); if (Array.isArray(events)) { events.forEach(function(event) { if (event.properties) { Object.assign(event.properties, storageProps); } }); const newData = 'data=' + encodeURIComponent(JSON.stringify(events)); const newArgs = [...args]; newArgs[1] = { ...args[1], body: newData }; return originalFetch.apply(this, newArgs); } } } catch (e) { console.warn('[Mintlify Analytics] Error in early fetch interception:', e); } } } return originalFetch.apply(this, args); }; console.log('[Mintlify Analytics] Early fetch interception set up at', new Date().toISOString()); // Intercept XMLHttpRequest early const originalXHROpen = XMLHttpRequest.prototype.open; const originalXHRSend = XMLHttpRequest.prototype.send; XMLHttpRequest.prototype.open = function(method, url, ...rest) { this._url = url; return originalXHROpen.apply(this, [method, url, ...rest]); }; XMLHttpRequest.prototype.send = function(data) { if (this._url && isMixpanelURL(this._url)) { console.log('[Mintlify Analytics] EARLY XHR interception: Mixpanel event detected', { url: this._url, hasData: !!(data && typeof data === 'string'), storageFuncAvailable: !!(getAllStoragePropertiesFunc && typeof getAllStoragePropertiesFunc === 'function'), timestamp: new Date().toISOString() }); if (data && typeof data === 'string' && data.startsWith('data=')) { try { const decoded = decodeURIComponent(data.substring(5)); const events = JSON.parse(decoded); const storageProps = getStorageProps(); const cookieCount = Object.keys(storageProps).filter(k => k.startsWith('cookie_')).length; console.log('[Mintlify Analytics] EARLY XHR interception: Adding storage props', { eventCount: Array.isArray(events) ? events.length : 0, cookieCount: cookieCount, hasStorageFunc: !!(getAllStoragePropertiesFunc && typeof getAllStoragePropertiesFunc === 'function'), eventNames: Array.isArray(events) ? events.map(e => e.event || e.name || 'unknown') : [] }); if (Array.isArray(events)) { events.forEach(function(event) { if (event.properties) { Object.assign(event.properties, storageProps); } }); data = 'data=' + encodeURIComponent(JSON.stringify(events)); } } catch (e) { console.warn('[Mintlify Analytics] Error in early XHR interception:', e); } } } return originalXHRSend.apply(this, [data]); }; console.log('[Mintlify Analytics] Early XHR interception set up at', new Date().toISOString()); // Try immediately setupEarlyInterception(); // Also check periodically (in case Mixpanel loads later) const earlyCheckInterval = setInterval(function() { if (setupEarlyInterception()) { clearInterval(earlyCheckInterval); } }, 50); // Store reference to getAllStorageProperties function when it's defined // This will be set later in the code window._mintlifySetStorageFunction = function(func) { getAllStoragePropertiesFunc = func; console.log('[Mintlify Analytics] Storage function registered for early interception'); }; // Stop checking after 5 seconds setTimeout(function() { clearInterval(earlyCheckInterval); }, 5000); })(); /** * Collect all storage properties * @returns {Object} Object with all storage properties */ function getAllStorageProperties() { const properties = {}; // Collect localStorage properties (excluding sensitive credentials) try { Object.keys(localStorage).forEach(key => { if (!key.includes('_creds') && !key.includes('auth_creds') && !key.includes('kfm_creds') && !key.includes('uam_creds')) { try { const value = localStorage.getItem(key); if (value) { properties[`localStorage_${key}`] = value; } } catch (e) { // Skip if can't read } } }); } catch (e) { // Ignore errors } // Collect sessionStorage properties try { Object.keys(sessionStorage).forEach(key => { try { const value = sessionStorage.getItem(key); if (value) { properties[`sessionStorage_${key}`] = value; } } catch (e) { // Skip if can't read } }); } catch (e) { // Ignore errors } // Collect all cookies - SIMPLE VERSION (like original code) try { document.cookie.split(';').forEach(cookie => { const [name, value] = cookie.trim().split('='); if (name && value) { properties[`cookie_${name}`] = value; } }); } catch (e) { // Ignore errors } return addOtherProperties(properties); } // Set the storage function reference for early interception if (window._mintlifySetStorageFunction) { window._mintlifySetStorageFunction(getAllStorageProperties); console.log('[Mintlify Analytics] Registered getAllStorageProperties for early interception at', new Date().toISOString()); } else { console.warn('[Mintlify Analytics] _mintlifySetStorageFunction not found - early interception may not have cookies!'); } /** * Add other properties (browser language, search results, etc.) */ function addOtherProperties(properties) { try { // Add browser language (navigator.language) if (navigator.language) { properties['browser_language'] = navigator.language; } else if (navigator.userLanguage) { // Fallback for older browsers (IE) properties['browser_language'] = navigator.userLanguage; } } catch (e) { console.warn('[Mintlify Analytics] Error reading browser language:', e); } try { // Count search results (if search is active) // Mintlify uses HeadlessUI combobox - find it by aria-controls from search-input let searchListbox = null; const searchInput = document.getElementById('search-input'); if (searchInput) { // Get the aria-controls attribute which points to the listbox const ariaControls = searchInput.getAttribute('aria-controls'); if (ariaControls) { searchListbox = document.getElementById(ariaControls); } } // Fallback: try to find by role="listbox" if (!searchListbox) { searchListbox = document.querySelector('[role="listbox"]'); } if (searchListbox) { // Get all options within the listbox const allOptions = Array.from(searchListbox.querySelectorAll('[role="option"]')); // Filter out "Ask AI assistant" and other non-result items // Mintlify search results have a specific structure - they contain links to articles const actualResults = allOptions.filter(function(el) { const text = el.textContent || ''; const lowerText = text.toLowerCase().trim(); // Skip empty items if (lowerText.length === 0) { return false; } // Skip "Ask AI assistant" - check for various patterns // This is the button at the bottom that says "Ask AI assistant" or "Can you tell me about..." if (lowerText.includes('ask ai assistant') || lowerText.startsWith('ask ai') || lowerText === 'ask ai' || lowerText.includes('can you tell me')) { return false; } // Search results MUST have a link (they link to articles) // "Ask AI assistant" doesn't have a link to an article, so we can filter it out this way const hasLink = el.querySelector('a') !== null || el.closest('a') !== null; if (!hasLink) { return false; } // If it has a link and it's not "Ask AI assistant", it's a search result return true; }); // Take only the first 6 results (as per user's requirement) // Mintlify shows max 6 search results, so we only count those const first6Results = actualResults.slice(0, 6); const numResults = first6Results.length; if (numResults > 0) { properties['num_search_results'] = numResults; // Save to sessionStorage for future events try { sessionStorage.setItem('_mintlify_num_search_results', numResults.toString()); } catch (e) { // Ignore } } } } catch (e) { console.warn('[Mintlify Analytics] Error counting search results:', e); } try { // Get num_search_results from sessionStorage (more reliable than DOM) // This is set by monitorSearchResults when results appear const numResults = sessionStorage.getItem('_mintlify_num_search_results'); if (numResults) { const numResultsInt = parseInt(numResults, 10); if (!isNaN(numResultsInt) && numResultsInt > 0) { properties['num_search_results'] = numResultsInt; } } } catch (e) { console.warn('[Mintlify Analytics] Error reading num_search_results:', e); } return properties; } /** * Get mintlify_session_id with retry logic * This function tries multiple methods to get the session ID * @returns {string|null} The session ID or null if not found */ function getMintlifySessionId() { // Try method 1: sessionStorage.getItem (standard method) try { const sessionId = sessionStorage.getItem('mintlify_session_id'); if (sessionId) { return sessionId; } } catch (e) { // Continue to next method } // Try method 2: Direct property access (for browsers that block getItem) try { if (window.sessionStorage && window.sessionStorage.mintlify_session_id) { return window.sessionStorage.mintlify_session_id; } } catch (e) { // Continue to next method } // Try method 3: Iterate through sessionStorage keys try { for (let i = 0; i < sessionStorage.length; i++) { const key = sessionStorage.key(i); if (key === 'mintlify_session_id') { const value = sessionStorage.getItem(key); if (value) { return value; } } } } catch (e) { // Continue to next method } // Try method 4: Check if it's in the properties we already collected // (This is a fallback if sessionStorage access is blocked) try { const allProps = getAllStorageProperties(); if (allProps && allProps['sessionStorage_mintlify_session_id']) { return allProps['sessionStorage_mintlify_session_id']; } } catch (e) { // Ignore } return null; } /** * Intercept Mixpanel API calls and add storage properties to all events */ function interceptMixpanelAPI() { // REMOVED: Cache was causing issues - cookies weren't being read fresh // Now we always call getAllStorageProperties() directly to get fresh data // Helper function to determine assistant location from DOM (uses same logic as getAssistantLocation) // This is called from fetch/XHR interceptors when they detect assistant events function getAssistantLocationFromDOM() { try { // Priority 1: Check for sidebar textarea FIRST (most reliable indicator) // Once the chat is open, the sidebar textarea exists and is the active input const textareaWithId = document.querySelector('textarea#chat-assistant-textarea'); if (textareaWithId) { // Check if it's visible (not hidden) const rect = textareaWithId.getBoundingClientRect(); const isVisible = rect.width > 0 && rect.height > 0 && window.getComputedStyle(textareaWithId).display !== 'none' && window.getComputedStyle(textareaWithId).visibility !== 'hidden'; if (isVisible) { // Use the main getAssistantLocation function if available if (typeof getAssistantLocation === 'function') { return getAssistantLocation(textareaWithId); } // Fallback: if function not available yet, return sidebar (most likely) return 'assistant_sidebar'; } } // Priority 2: Check for bottom input (only if sidebar not found) // The bottom input exists initially, and only after clicking Enter does it move to sidebar const allInputs = document.querySelectorAll('input, textarea'); for (let i = 0; i < allInputs.length; i++) { const input = allInputs[i]; let current = input; let depth = 0; const maxDepth = 5; // Check if this input has a parent with chat-assistant-floating-input class while (current && depth < maxDepth) { const classes = (current.className || '').toString(); const classStr = classes.toLowerCase(); // Bottom indicator: parent has 'chat-assistant-floating-input' class if (classStr.includes('chat-assistant-floating-input')) { // Check if it's visible (not hidden) const rect = input.getBoundingClientRect(); const isVisible = rect.width > 0 && rect.height > 0 && window.getComputedStyle(input).display !== 'none' && window.getComputedStyle(input).visibility !== 'hidden'; if (isVisible) { // Use the main getAssistantLocation function if available if (typeof getAssistantLocation === 'function') { return getAssistantLocation(input); } // Fallback: return bottom return 'bottom_of_page'; } } // Move up the DOM tree current = current.parentElement; depth++; } } // Priority 3: Try to find elements with chat-assistant-input class const assistantInputs = document.querySelectorAll('.chat-assistant-input, [class*="chat-assistant"]'); for (let i = 0; i < assistantInputs.length; i++) { const input = assistantInputs[i]; // Use the main getAssistantLocation function if available if (typeof getAssistantLocation === 'function') { return getAssistantLocation(input); } // Fallback: check position const rect = input.getBoundingClientRect(); if (rect.left > window.innerWidth * 0.5) { return 'assistant_sidebar'; } } // Priority 4: Try to find by placeholder (less reliable, but might work) const placeholderInputs = document.querySelectorAll('input[placeholder*="ask" i], textarea[placeholder*="ask" i], input[placeholder*="question" i], textarea[placeholder*="question" i]'); for (let i = 0; i < placeholderInputs.length; i++) { const input = placeholderInputs[i]; // Use the main getAssistantLocation function if available if (typeof getAssistantLocation === 'function') { return getAssistantLocation(input); } // Fallback: check for floating-input parent let current = input; let depth = 0; const maxDepth = 5; while (current && depth < maxDepth) { const classes = (current.className || '').toString(); const classStr = classes.toLowerCase(); if (classStr.includes('chat-assistant-floating-input')) { return 'bottom_of_page'; } current = current.parentElement; depth++; } } // Fallback: default to bottom_of_page (initial position) return 'bottom_of_page'; } catch (e) { console.warn('[Mintlify Analytics] Error determining assistant location:', e); return 'bottom_of_page'; } } // Helper function to check if URL is a Mixpanel API URL function isMixpanelURL(url) { if (!url || typeof url !== 'string') return false; return url.includes('mixpanel.com/track') || url.includes('mixpanel.com/engage') || url.includes('mixpanel.com/api'); } // Intercept fetch (this will override the early interception, but that's OK - it has more features) // Make sure we get the original fetch (not the early intercepted one) const originalFetch = window.fetch._mintlifyOriginalFetch || window.fetch; if (!window.fetch._mintlifyIntercepted) { window.fetch._mintlifyOriginalFetch = originalFetch; window.fetch._mintlifyIntercepted = true; } window.fetch = function(...args) { const url = args[0]; if (isMixpanelURL(url)) { console.log('[Mintlify Analytics] MAIN fetch interception: Mixpanel event detected', { url: url, hasBody: !!(args[1] && args[1].body), timestamp: new Date().toISOString() }); if (args[1] && args[1].body) { try { const body = args[1].body; let bodyStr = ''; let modified = false; if (typeof body === 'string') { bodyStr = body; } else if (body instanceof FormData) { bodyStr = body.get('data') || ''; } else if (body instanceof Blob) { // For Blob, read it asynchronously return new Promise(function(resolve, reject) { const reader = new FileReader(); reader.onload = function() { try { const blobStr = reader.result; if (blobStr && blobStr.startsWith('data=')) { const decoded = decodeURIComponent(blobStr.substring(5)); const events = JSON.parse(decoded); const storageProps = getAllStorageProperties(); if (Array.isArray(events)) { // Log how many cookies are being sent (for debugging) const cookieKeys = Object.keys(storageProps).filter(k => k.startsWith('cookie_')); console.log('[Mintlify Analytics] MAIN fetch interception (Blob): Adding storage props', { eventCount: events.length, cookieCount: cookieKeys.length, eventNames: events.map(e => e.event || e.name || 'unknown'), timestamp: new Date().toISOString() }); if (cookieKeys.length === 0) { console.warn('[Mintlify Analytics] No cookies found when intercepting event:', events[0]?.event || 'unknown'); } events.forEach(function(event) { if (event.properties) { Object.assign(event.properties, storageProps); // Add location property for assistant events if not already present if ((event.event === 'docs.assistant.completed' || event.event === 'docs.assistant.enter' || event.event === 'chat_enter' || event.event === 'docs.assistant.starter_question_clicked') && !event.properties.location) { event.properties.location = getAssistantLocationFromDOM(); } // Add type property for navigation click events if not already present if (event.event === 'docs.navitem.cta_click' && !event.properties.type) { const url = event.properties.url || event.properties.$current_url || ''; // Check if it's next/previous based on text first const text = (event.properties.text || '').toLowerCase(); if (text === 'next' || text.includes('next article')) { event.properties.type = 'next'; } else if (text === 'previous' || text.includes('previous article')) { event.properties.type = 'previous'; } else if (url) { // Check if it's an external link (starts with http:// or https:// and NOT docs.base44.com) const isExternalLink = (url.startsWith('http://') || url.startsWith('https://')) && !url.includes('docs.base44.com'); const isBase44Link = url.includes('docs.base44.com'); if (isExternalLink) { event.properties.type = 'external'; } else if (isBase44Link) { // Default to article link for Base44 links event.properties.type = 'article'; } // If URL is relative or empty, leave type empty - SQL will handle it } } // Add current_url to navigation click events if not already present // This indicates where the user was when they clicked if (event.event === 'docs.navitem.cta_click' && !event.properties.current_url) { event.properties.current_url = window.location.href; } } }); const newData = 'data=' + encodeURIComponent(JSON.stringify(events)); const newBlob = new Blob([newData], { type: 'application/x-www-form-urlencoded' }); originalFetch(url, { ...args[1], body: newBlob }).then(resolve).catch(reject); return; } } } catch (e) { console.warn('[Mintlify Analytics] Error intercepting fetch Blob:', e); } originalFetch.apply(this, args).then(resolve).catch(reject); }; reader.onerror = function() { originalFetch.apply(this, args).then(resolve).catch(reject); }; reader.readAsText(body); }); } if (bodyStr && bodyStr.startsWith('data=')) { const decoded = decodeURIComponent(bodyStr.substring(5)); const events = JSON.parse(decoded); const storageProps = getAllStorageProperties(); if (Array.isArray(events)) { // Log how many cookies are being sent (for debugging) const cookieKeys = Object.keys(storageProps).filter(k => k.startsWith('cookie_')); console.log('[Mintlify Analytics] MAIN fetch interception (string): Adding storage props', { eventCount: events.length, cookieCount: cookieKeys.length, eventNames: events.map(e => e.event || e.name || 'unknown'), timestamp: new Date().toISOString() }); if (cookieKeys.length === 0) { console.warn('[Mintlify Analytics] No cookies found when intercepting event (string body):', events[0]?.event || 'unknown'); } events.forEach(function(event) { if (event.properties) { Object.assign(event.properties, storageProps); // Add location property for assistant events if not already present if ((event.event === 'docs.assistant.completed' || event.event === 'docs.assistant.enter' || event.event === 'chat_enter') && !event.properties.location) { // If there's a sidebar textarea visible, it's definitely sidebar const sidebarTextarea = document.querySelector('textarea#chat-assistant-textarea'); if (sidebarTextarea) { const rect = sidebarTextarea.getBoundingClientRect(); const isVisible = rect.width > 0 && rect.height > 0 && window.getComputedStyle(sidebarTextarea).display !== 'none' && window.getComputedStyle(sidebarTextarea).visibility !== 'hidden'; if (isVisible) { event.properties.location = 'assistant_sidebar'; } else { event.properties.location = getAssistantLocationFromDOM(); } } else { event.properties.location = getAssistantLocationFromDOM(); } } modified = true; } }); if (modified) { const newData = 'data=' + encodeURIComponent(JSON.stringify(events)); const newArgs = [...args]; newArgs[1] = { ...args[1], body: newData }; return originalFetch.apply(this, newArgs); } } } } catch (e) { console.warn('[Mintlify Analytics] Error intercepting fetch:', e); } } } return originalFetch.apply(this, args); }; // Intercept XMLHttpRequest const originalXHROpen = XMLHttpRequest.prototype.open; const originalXHRSend = XMLHttpRequest.prototype.send; XMLHttpRequest.prototype.open = function(method, url, ...rest) { this._url = url; return originalXHROpen.apply(this, [method, url, ...rest]); }; XMLHttpRequest.prototype.send = function(data) { if (this._url && isMixpanelURL(this._url)) { if (data && typeof data === 'string' && data.startsWith('data=')) { try { const decoded = decodeURIComponent(data.substring(5)); const events = JSON.parse(decoded); const storageProps = getAllStorageProperties(); if (Array.isArray(events)) { // Log how many cookies are being sent (for debugging) const cookieKeys = Object.keys(storageProps).filter(k => k.startsWith('cookie_')); console.log('[Mintlify Analytics] MAIN XHR interception: Adding storage props', { eventCount: events.length, cookieCount: cookieKeys.length, eventNames: events.map(e => e.event || e.name || 'unknown'), timestamp: new Date().toISOString() }); if (cookieKeys.length === 0) { console.warn('[Mintlify Analytics] No cookies found when intercepting event (XHR):', events[0]?.event || 'unknown'); } events.forEach(function(event) { if (event.properties) { Object.assign(event.properties, storageProps); // Add location property for assistant events if not already present if ((event.event === 'docs.assistant.completed' || event.event === 'docs.assistant.enter' || event.event === 'chat_enter') && !event.properties.location) { // If there's a sidebar textarea visible, it's definitely sidebar const sidebarTextarea = document.querySelector('textarea#chat-assistant-textarea'); if (sidebarTextarea) { const rect = sidebarTextarea.getBoundingClientRect(); const isVisible = rect.width > 0 && rect.height > 0 && window.getComputedStyle(sidebarTextarea).display !== 'none' && window.getComputedStyle(sidebarTextarea).visibility !== 'hidden'; if (isVisible) { event.properties.location = 'assistant_sidebar'; } else { event.properties.location = getAssistantLocationFromDOM(); } } else { event.properties.location = getAssistantLocationFromDOM(); } } } }); data = 'data=' + encodeURIComponent(JSON.stringify(events)); } } catch (e) { console.warn('[Mintlify Analytics] Error intercepting XHR:', e); } } } return originalXHRSend.apply(this, [data]); }; // Intercept sendBeacon const originalSendBeacon = navigator.sendBeacon; navigator.sendBeacon = function(url, data) { if (isMixpanelURL(url)) { try { let bodyStr = ''; if (data instanceof Blob) { // Try to read and modify Blob asynchronously // This is a fallback - we'll try to read the Blob, modify it, and send it // But sendBeacon is synchronous, so we need to use a workaround try { const reader = new FileReader(); reader.onload = function() { try { const blobStr = reader.result; if (blobStr && typeof blobStr === 'string' && blobStr.startsWith('data=')) { const decoded = decodeURIComponent(blobStr.substring(5)); const events = JSON.parse(decoded); const storageProps = getAllStorageProperties(); if (Array.isArray(events)) { const cookieKeys = Object.keys(storageProps).filter(k => k.startsWith('cookie_')); if (cookieKeys.length === 0) { console.warn('[Mintlify Analytics] No cookies found when intercepting sendBeacon Blob:', events[0]?.event || 'unknown'); } events.forEach(function(event) { if (event.properties) { Object.assign(event.properties, storageProps); // Add location property for assistant events if not already present if ((event.event === 'docs.assistant.completed' || event.event === 'docs.assistant.enter' || event.event === 'chat_enter') && !event.properties.location) { // If there's a sidebar textarea visible, it's definitely sidebar const sidebarTextarea = document.querySelector('textarea#chat-assistant-textarea'); if (sidebarTextarea) { const rect = sidebarTextarea.getBoundingClientRect(); const isVisible = rect.width > 0 && rect.height > 0 && window.getComputedStyle(sidebarTextarea).display !== 'none' && window.getComputedStyle(sidebarTextarea).visibility !== 'hidden'; if (isVisible) { event.properties.location = 'assistant_sidebar'; } else { event.properties.location = getAssistantLocationFromDOM(); } } else { event.properties.location = getAssistantLocationFromDOM(); } } } }); // Send modified event via fetch (since sendBeacon is synchronous) const newData = 'data=' + encodeURIComponent(JSON.stringify(events)); const encodedData = encodeURIComponent(JSON.stringify(events)); fetch('https://api-js.mixpanel.com/track/?data=' + encodedData, { method: 'GET', mode: 'no-cors' }).catch(function(e) { console.warn('[Mintlify Analytics] Failed to send modified sendBeacon event:', e); }); } } } catch (e) { console.warn('[Mintlify Analytics] Error processing sendBeacon Blob:', e); } }; reader.onerror = function() { // If we can't read the Blob, send as-is originalSendBeacon.call(navigator, url, data); }; reader.readAsText(data); // Return true to indicate we're handling it (even though we'll send via fetch) // Note: This means the original sendBeacon won't be called, but we'll send via fetch instead return true; } catch (e) { console.warn('[Mintlify Analytics] Error setting up Blob reader for sendBeacon:', e); // Fallback: send as-is return originalSendBeacon.call(navigator, url, data); } } else if (typeof data === 'string' && data.startsWith('data=')) { bodyStr = data; } else { return originalSendBeacon.call(navigator, url, data); } if (bodyStr && bodyStr.startsWith('data=')) { const decoded = decodeURIComponent(bodyStr.substring(5)); const events = JSON.parse(decoded); const storageProps = getAllStorageProperties(); if (Array.isArray(events)) { // Log how many cookies are being sent (for debugging) const cookieKeys = Object.keys(storageProps).filter(k => k.startsWith('cookie_')); if (cookieKeys.length === 0) { console.warn('[Mintlify Analytics] No cookies found when intercepting event (sendBeacon):', events[0]?.event || 'unknown'); } let modified = false; events.forEach(function(event) { if (event.properties) { Object.assign(event.properties, storageProps); // Add location property for assistant events if not already present if ((event.event === 'docs.assistant.completed' || event.event === 'docs.assistant.enter' || event.event === 'chat_enter') && !event.properties.location) { // If there's a sidebar textarea visible, it's definitely sidebar const sidebarTextarea = document.querySelector('textarea#chat-assistant-textarea'); if (sidebarTextarea) { const rect = sidebarTextarea.getBoundingClientRect(); const isVisible = rect.width > 0 && rect.height > 0 && window.getComputedStyle(sidebarTextarea).display !== 'none' && window.getComputedStyle(sidebarTextarea).visibility !== 'hidden'; if (isVisible) { event.properties.location = 'assistant_sidebar'; } else { event.properties.location = getAssistantLocationFromDOM(); } } else { event.properties.location = getAssistantLocationFromDOM(); } } modified = true; } }); if (modified) { const newData = 'data=' + encodeURIComponent(JSON.stringify(events)); const blob = new Blob([newData], { type: 'application/x-www-form-urlencoded' }); return originalSendBeacon.call(navigator, url, blob); } } } } catch (e) { console.warn('[Mintlify Analytics] Error intercepting sendBeacon:', e); } } return originalSendBeacon.call(navigator, url, data); }; // Intercept mixpanel.track() directly to ensure cookies are always added // This catches events sent directly through mixpanel.track() that might bypass fetch/XHR/sendBeacon function interceptMixpanelTrack() { function setupInterception() { if (!window.mixpanel) { return false; } // Intercept track() if (typeof window.mixpanel.track === 'function' && !window.mixpanel.track._mintlifyIntercepted) { const originalTrack = window.mixpanel.track; window.mixpanel.track = function(eventName, properties, callback) { try { // Get fresh storage properties (including cookies) - call getAllStorageProperties directly const storageProps = getAllStorageProperties(); // Merge storage properties into event properties const mergedProperties = properties || {}; Object.assign(mergedProperties, storageProps); // Call original track with merged properties return originalTrack.call(this, eventName, mergedProperties, callback); } catch (e) { console.warn('[Mintlify Analytics] Error intercepting mixpanel.track():', e); // Fallback: call original track without modification return originalTrack.call(this, eventName, properties, callback); } }; window.mixpanel.track._mintlifyIntercepted = true; console.log('[Mintlify Analytics] Intercepted mixpanel.track() - cookies will be added to all events'); } // Intercept track_batch() if it exists (Mixpanel sometimes batches events) if (typeof window.mixpanel.track_batch === 'function' && !window.mixpanel.track_batch._mintlifyIntercepted) { const originalTrackBatch = window.mixpanel.track_batch; window.mixpanel.track_batch = function(events, callback) { try { // Get fresh storage properties (including cookies) - call getAllStorageProperties directly const storageProps = getAllStorageProperties(); // Merge storage properties into each event if (Array.isArray(events)) { events.forEach(function(event) { if (event && event.properties) { Object.assign(event.properties, storageProps); } }); } // Call original track_batch with merged events return originalTrackBatch.call(this, events, callback); } catch (e) { console.warn('[Mintlify Analytics] Error intercepting mixpanel.track_batch():', e); // Fallback: call original track_batch without modification return originalTrackBatch.call(this, events, callback); } }; window.mixpanel.track_batch._mintlifyIntercepted = true; console.log('[Mintlify Analytics] Intercepted mixpanel.track_batch() - cookies will be added to all events'); } return true; } // Try to set up interception immediately (in case Mixpanel is already loaded) if (setupInterception()) { console.log('[Mintlify Analytics] Mixpanel SDK already loaded - interception set up immediately'); } // Also wait for Mixpanel SDK to load (in case it loads later) const checkMixpanel = setInterval(function() { if (setupInterception()) { clearInterval(checkMixpanel); } }, 100); // Stop checking after 10 seconds (Mixpanel should be loaded by then) setTimeout(function() { clearInterval(checkMixpanel); if (!window.mixpanel) { console.warn('[Mintlify Analytics] Mixpanel SDK not found after 10 seconds - track() interception may not work'); } }, 10000); } // Start intercepting mixpanel.track() immediately interceptMixpanelTrack(); // Log initialization const initialProps = getAllStorageProperties(); const propCount = Object.keys(initialProps).length; const hasSessionId = initialProps['sessionStorage_mintlify_session_id'] ? 'YES' : 'NO'; console.log('[Mintlify Analytics] Initialized - adding', propCount, 'storage properties to all Mixpanel events'); console.log('[Mintlify Analytics] mintlify_session_id found:', hasSessionId); } /** * Monitor search results and save count to sessionStorage */ function monitorSearchResults() { // Helper function to find search input (same logic as in setupSearchInputListener) function findSearchInput() { // Method 1: Try by ID let searchInput = document.getElementById('search-input'); if (searchInput) { return searchInput; } // Method 2: Try to find input that has aria-controls pointing to a listbox const allInputs = document.querySelectorAll('input[type="text"], input[type="search"]'); for (let i = 0; i < allInputs.length; i++) { const input = allInputs[i]; const ariaControls = input.getAttribute('aria-controls'); if (ariaControls) { const listbox = document.getElementById(ariaControls); if (listbox && listbox.getAttribute('role') === 'listbox') { return input; } } } // Method 3: Try to find input with placeholder containing "search" for (let i = 0; i < allInputs.length; i++) { const input = allInputs[i]; const placeholder = (input.getAttribute('placeholder') || '').toLowerCase(); if (placeholder.includes('search')) { return input; } } // Method 4: Try to find input that is part of a combobox for (let i = 0; i < allInputs.length; i++) { const input = allInputs[i]; const parent = input.closest('[role="combobox"]'); if (parent) { return input; } } return null; } // Function to update num_search_results (can be called from multiple places) function updateNumSearchResults() { try { // Find the search listbox using the search-input's aria-controls let searchListbox = null; const searchInput = findSearchInput(); if (searchInput) { const ariaControls = searchInput.getAttribute('aria-controls'); if (ariaControls) { searchListbox = document.getElementById(ariaControls); console.log('[Mintlify Analytics] Found listbox via aria-controls:', ariaControls); } } // Fallback: try to find by role="listbox" if (!searchListbox) { searchListbox = document.querySelector('[role="listbox"]'); if (searchListbox) { console.log('[Mintlify Analytics] Found listbox via role="listbox"'); } } if (searchListbox) { console.log('[Mintlify Analytics] Updating num_search_results, found listbox'); const allOptions = Array.from(searchListbox.querySelectorAll('[role="option"]')); console.log('[Mintlify Analytics] Found', allOptions.length, 'options in listbox'); // Debug: log first few options to see their structure and IDs if (allOptions.length > 0) { console.log('[Mintlify Analytics] === OPTION STRUCTURE DEBUG ==='); allOptions.slice(0, 3).forEach(function(option, idx) { const textContent = option.textContent || ''; const innerHTML = option.innerHTML || ''; const allAttributes = {}; if (option.attributes) { for (let i = 0; i < option.attributes.length; i++) { const attr = option.attributes[i]; allAttributes[attr.name] = attr.value; } } console.log('[Mintlify Analytics] Option', idx, ':', { id: option.id, allAttributes: allAttributes, text: textContent.substring(0, 100), tagName: option.tagName, className: option.className, innerHTML: innerHTML.substring(0, 300) }); // Check for links inside const link = option.querySelector('a'); if (link) { console.log('[Mintlify Analytics] Option', idx, 'has link:', { href: link.href, id: link.id, text: link.textContent?.substring(0, 50) }); } // Check for buttons inside const button = option.querySelector('button'); if (button) { const buttonAttrs = {}; if (button.attributes) { for (let i = 0; i < button.attributes.length; i++) { const attr = button.attributes[i]; buttonAttrs[attr.name] = attr.value; } } console.log('[Mintlify Analytics] Option', idx, 'has button:', { id: button.id, allAttributes: buttonAttrs, text: button.textContent?.substring(0, 50) }); } }); console.log('[Mintlify Analytics] === END OPTION STRUCTURE DEBUG ==='); } const actualResults = allOptions.filter(function(el) { const text = el.textContent || ''; const lowerText = text.toLowerCase().trim(); if (lowerText.length === 0) { return false; } // Filter out "Ask AI assistant" options if (lowerText.includes('ask ai assistant') || lowerText.startsWith('ask ai') || lowerText === 'ask ai' || lowerText.includes('can you tell me')) { return false; } // Search results in Mintlify have a div with "cursor-pointer" class // This is the actual clickable element inside the option const hasCursorPointer = el.querySelector('div[class*="cursor-pointer"]') !== null; if (!hasCursorPointer) { return false; } return true; }); console.log('[Mintlify Analytics] Filtered to', actualResults.length, 'actual results'); const first6Results = actualResults.slice(0, 6); const numResults = first6Results.length; if (numResults > 0) { sessionStorage.setItem('_mintlify_num_search_results', numResults.toString()); console.log('[Mintlify Analytics] Saved num_search_results to sessionStorage:', numResults); } else { // Also save 0 if there are no results sessionStorage.setItem('_mintlify_num_search_results', '0'); } } else { console.log('[Mintlify Analytics] No listbox found when updating num_search_results'); } } catch (e) { console.warn('[Mintlify Analytics] Error updating num_search_results:', e); } } // Use MutationObserver to watch for search results appearing const observer = new MutationObserver(function(mutations) { // console.log('[Mintlify Analytics] DOM mutation detected, updating num_search_results'); updateNumSearchResults(); }); // Observe the document body for changes try { observer.observe(document.body, { childList: true, subtree: true }); } catch (e) { console.warn('[Mintlify Analytics] Error setting up search results observer:', e); } // Also listen to input events on search input // Try to find search input with multiple methods (it might not be loaded yet or have different ID) function findSearchInput() { // Method 1: Try by ID let searchInput = document.getElementById('search-input'); if (searchInput) { return searchInput; } // Method 2: Try to find input that has aria-controls pointing to a listbox const allInputs = document.querySelectorAll('input[type="text"], input[type="search"]'); for (let i = 0; i < allInputs.length; i++) { const input = allInputs[i]; const ariaControls = input.getAttribute('aria-controls'); if (ariaControls) { const listbox = document.getElementById(ariaControls); if (listbox && listbox.getAttribute('role') === 'listbox') { return input; } } } // Method 3: Try to find input with placeholder containing "search" for (let i = 0; i < allInputs.length; i++) { const input = allInputs[i]; const placeholder = (input.getAttribute('placeholder') || '').toLowerCase(); if (placeholder.includes('search')) { return input; } } // Method 4: Try to find input that is part of a combobox for (let i = 0; i < allInputs.length; i++) { const input = allInputs[i]; const parent = input.closest('[role="combobox"]'); if (parent) { return input; } } return null; } function setupSearchInputListener() { try { const searchInput = findSearchInput(); if (searchInput) { console.log('[Mintlify Analytics] Search input found, setting up listener'); // Use debounce to avoid too many updates let timeoutId = null; searchInput.addEventListener('input', function() { console.log('[Mintlify Analytics] Search input changed'); clearTimeout(timeoutId); timeoutId = setTimeout(function() { console.log('[Mintlify Analytics] Updating num_search_results after input'); updateNumSearchResults(); // Use the shared function // Send search event to Mixpanel when user stops typing try { const query = searchInput.value || ''; if (query.trim().length > 0) { // Get num_search_results from sessionStorage (set by updateNumSearchResults) const numResults = sessionStorage.getItem('_mintlify_num_search_results'); const numResultsInt = numResults ? parseInt(numResults, 10) : 0; // Helper function to send the event function sendSearchEvent() { try { // Always add storage properties (including cookies) before sending const storageProps = getAllStorageProperties(); const eventProperties = { query: query.trim(), num_search_results: numResultsInt }; Object.assign(eventProperties, storageProps); if (window.mixpanel && typeof window.mixpanel.track === 'function') { window.mixpanel.track('docs.search', eventProperties); console.log('[Mintlify Analytics] Sent docs.search event with query:', query.trim(), 'results:', numResultsInt); return true; } return false; } catch (e) { console.warn('[Mintlify Analytics] Error sending search event:', e); return false; } } // Try to send immediately if (!sendSearchEvent()) { // If Mixpanel not ready, wait for it (up to 5 seconds) let attempts = 0; const maxAttempts = 50; // 50 attempts * 100ms = 5 seconds const checkInterval = setInterval(function() { attempts++; if (sendSearchEvent()) { clearInterval(checkInterval); } else if (attempts >= maxAttempts) { // Last resort: try to send via fetch directly (bypass Mixpanel SDK) // This ensures the event is sent even if Mixpanel SDK is not loaded console.warn('[Mintlify Analytics] Mixpanel SDK not available after 5s, trying direct fetch'); try { // Get all storage properties (same as in interceptMixpanelAPI) const storageProps = getAllStorageProperties(); // Try multiple methods to find Mixpanel token let mixpanelToken = MIXPANEL_TOKEN; // Use hardcoded token first let distinctId = null; // Method 1: Check window.mixpanel.config (if Mixpanel is partially loaded) try { if (window.mixpanel && window.mixpanel.config && window.mixpanel.config.token) { mixpanelToken = window.mixpanel.config.token; } } catch (e) { // Ignore } // Method 2: Check window.mixpanel._get_config (if Mixpanel is partially loaded) try { if (window.mixpanel && typeof window.mixpanel._get_config === 'function') { const config = window.mixpanel._get_config(); if (config && config.token) { mixpanelToken = config.token; } } } catch (e) { // Ignore } // Method 3: Search in all script tags if (!mixpanelToken) { const scripts = document.querySelectorAll('script'); for (let i = 0; i < scripts.length; i++) { const scriptText = scripts[i].textContent || ''; // Try various patterns const patterns = [ /mixpanel\.init\(['"]([^'"]+)['"]/, /token['"]?\s*[:=]\s*['"]([^'"]+)['"]/, /['"]token['"]\s*:\s*['"]([^'"]+)['"]/, /mixpanelToken['"]?\s*[:=]\s*['"]([^'"]+)['"]/ ]; for (let j = 0; j < patterns.length; j++) { const match = scriptText.match(patterns[j]); if (match && match[1] && match[1].length > 10) { // Token should be long mixpanelToken = match[1]; break; } } if (mixpanelToken) break; } } // Method 4: Check localStorage for Mixpanel token (sometimes stored there) if (!mixpanelToken) { try { for (let i = 0; i < localStorage.length; i++) { const key = localStorage.key(i); if (key && key.includes('mixpanel') && key.includes('token')) { const value = localStorage.getItem(key); if (value && value.length > 10) { mixpanelToken = value; break; } } } } catch (e) { // Ignore } } // Method 5: Extract token from localStorage keys like __mpq__ev if (!mixpanelToken) { try { for (let i = 0; i < localStorage.length; i++) { const key = localStorage.key(i); if (key && key.startsWith('__mpq_') && key.endsWith('_ev')) { // Extract token from key: __mpq__ev const tokenMatch = key.match(/^__mpq_([a-f0-9]+)_ev$/); if (tokenMatch && tokenMatch[1] && tokenMatch[1].length > 10) { mixpanelToken = tokenMatch[1]; break; } } } } catch (e) { // Ignore } } // Get distinct_id try { if (window.mixpanel && typeof window.mixpanel.get_distinct_id === 'function') { distinctId = window.mixpanel.get_distinct_id(); } else if (window.mixpanel && window.mixpanel.get_distinct_id) { distinctId = window.mixpanel.get_distinct_id; } } catch (e) { // Ignore } // Try to get distinct_id from localStorage if (!distinctId && mixpanelToken) { try { const mpDistinctId = localStorage.getItem('mp_' + mixpanelToken + '_distinct_id'); if (mpDistinctId) { distinctId = mpDistinctId; } } catch (e) { // Ignore } } // If still no distinct_id, try to find it in localStorage if (!distinctId) { try { for (let i = 0; i < localStorage.length; i++) { const key = localStorage.key(i); if (key && (key.includes('distinct_id') || key.includes('mixpanel'))) { const value = localStorage.getItem(key); if (value && value.length > 5) { distinctId = value; break; } } } } catch (e) { // Ignore } } if (mixpanelToken) { // Build event with all properties const eventData = { event: 'docs.search', properties: { token: mixpanelToken, time: Math.floor(Date.now() / 1000), distinct_id: distinctId || 'anonymous', query: query.trim(), num_search_results: numResultsInt, ...storageProps // Include all storage properties } }; // Send via fetch to Mixpanel API (same format as Mixpanel SDK) const encodedData = encodeURIComponent(JSON.stringify([eventData])); fetch('https://api-js.mixpanel.com/track/?data=' + encodedData, { method: 'GET', mode: 'no-cors' // Use no-cors to avoid CORS issues }).then(function() { console.log('[Mintlify Analytics] Sent docs.search event via direct fetch (token found)'); }).catch(function(e) { console.warn('[Mintlify Analytics] Failed to send via direct fetch:', e); }); } else { // If token not found, log all localStorage keys for debugging console.warn('[Mintlify Analytics] Could not find Mixpanel token. Available localStorage keys:', Array.from({length: localStorage.length}, (_, i) => localStorage.key(i)).filter(k => k && (k.includes('mix') || k.includes('mp')))); console.warn('[Mintlify Analytics] Event not sent - Mixpanel token required'); } } catch (e) { console.warn('[Mintlify Analytics] Error in fallback send:', e); } clearInterval(checkInterval); } }, 100); } } } catch (e) { console.warn('[Mintlify Analytics] Error sending search event:', e); } }, 300); // Wait 300ms after typing stops to allow results to render }); return true; } else { return false; } } catch (e) { console.warn('[Mintlify Analytics] Error setting up search input listener:', e); return false; } } // Try to set up listener immediately if (!setupSearchInputListener()) { // If not found, try again after delays (search input might load later) const retryDelays = [500, 1000, 2000, 3000]; retryDelays.forEach(function(delay) { setTimeout(function() { if (!setupSearchInputListener()) { if (delay === retryDelays[retryDelays.length - 1]) { console.warn('[Mintlify Analytics] Search input not found after all retries'); } } }, delay); }); } // Also use MutationObserver to watch for search input being added to DOM const inputObserver = new MutationObserver(function(mutations) { const searchInput = findSearchInput(); if (searchInput && !searchInput.hasAttribute('data-mintlify-listener-attached')) { // Mark as attached to avoid duplicate listeners searchInput.setAttribute('data-mintlify-listener-attached', 'true'); setupSearchInputListener(); } }); try { inputObserver.observe(document.body, { childList: true, subtree: true }); } catch (e) { console.warn('[Mintlify Analytics] Error setting up input observer:', e); } } /** * Helper function to send assistant event (with fallback to direct fetch) * Defined outside functions so it can be used by multiple event handlers */ function sendAssistantEvent(eventName, properties) { // Log what we're sending for debugging console.log('[Mintlify Analytics] Sending assistant event:', eventName, 'with properties:', properties); // Always add storage properties (including cookies) before sending // This ensures cookies are included even if interception doesn't work const storageProps = getAllStorageProperties(); const mergedProperties = properties || {}; Object.assign(mergedProperties, storageProps); // Try to send immediately if Mixpanel is available if (window.mixpanel && typeof window.mixpanel.track === 'function') { try { window.mixpanel.track(eventName, mergedProperties); console.log('[Mintlify Analytics] Tracked', eventName, 'via Mixpanel SDK'); return true; } catch (e) { console.warn('[Mintlify Analytics] Error sending event:', e); } } // If Mixpanel is not available, try direct fetch (same as search events) // Note: mergedProperties already includes storageProps from above try { const eventData = { event: eventName, properties: { token: MIXPANEL_TOKEN, time: Math.floor(Date.now() / 1000), distinct_id: 'anonymous', ...mergedProperties // Use mergedProperties which already includes storageProps } }; console.log('[Mintlify Analytics] Sending via direct fetch, eventData:', JSON.stringify(eventData, null, 2)); const encodedData = encodeURIComponent(JSON.stringify([eventData])); fetch('https://api-js.mixpanel.com/track/?data=' + encodedData, { method: 'GET', mode: 'no-cors' }).then(function() { console.log('[Mintlify Analytics] Sent', eventName, 'via direct fetch with properties:', properties); }).catch(function(e) { console.warn('[Mintlify Analytics] Failed to send via direct fetch:', e); }); return true; } catch (e) { console.warn('[Mintlify Analytics] Error in fallback send:', e); return false; } } /** * Track navigation clicks (next/previous/sidebar) */ function trackNavigationClicks() { // Helper function to send event (waits for Mixpanel if needed, with fallback to direct fetch) function sendNavigationEvent(eventName, properties) { // Always add storage properties (including cookies) before sending // This ensures cookies are included even if interception doesn't work const storageProps = getAllStorageProperties(); const mergedProperties = properties || {}; Object.assign(mergedProperties, storageProps); // Try to send immediately if Mixpanel is available if (window.mixpanel && typeof window.mixpanel.track === 'function') { try { window.mixpanel.track(eventName, mergedProperties); console.log('[Mintlify Analytics] Tracked', eventName, 'with type:', mergedProperties.type); return true; } catch (e) { console.warn('[Mintlify Analytics] Error sending event:', e); } } // If Mixpanel is not available, wait for it (up to 2 seconds) let attempts = 0; const maxAttempts = 20; // 20 attempts * 100ms = 2 seconds const checkInterval = setInterval(function() { attempts++; if (window.mixpanel && typeof window.mixpanel.track === 'function') { try { window.mixpanel.track(eventName, mergedProperties); console.log('[Mintlify Analytics] Tracked', eventName, 'with type:', mergedProperties.type, '(after wait)'); clearInterval(checkInterval); } catch (e) { console.warn('[Mintlify Analytics] Error sending event:', e); } } else if (attempts >= maxAttempts) { // Fallback: send via direct fetch if Mixpanel is not available // Note: mergedProperties already includes storageProps from above console.warn('[Mintlify Analytics] Mixpanel not available after', attempts * 100, 'ms, trying direct fetch'); try { const eventData = { event: eventName, properties: { token: MIXPANEL_TOKEN, time: Math.floor(Date.now() / 1000), distinct_id: 'anonymous', ...mergedProperties // Use mergedProperties which already includes storageProps } }; const encodedData = encodeURIComponent(JSON.stringify([eventData])); fetch('https://api-js.mixpanel.com/track/?data=' + encodedData, { method: 'GET', mode: 'no-cors' }).then(function() { console.log('[Mintlify Analytics] Sent', eventName, 'via direct fetch with type:', mergedProperties.type); }).catch(function(e) { console.warn('[Mintlify Analytics] Failed to send via direct fetch:', e); }); } catch (e) { console.warn('[Mintlify Analytics] Error in fallback send:', e); } clearInterval(checkInterval); } }, 100); return false; } // Use event delegation to catch clicks on navigation elements and assistant document.addEventListener('click', function(event) { try { const clickedElement = event.target; const text = (clickedElement.textContent || '').trim(); const lowerText = text.toLowerCase(); console.log('[Mintlify Analytics] Click detected:', { tagName: clickedElement.tagName, text: text.substring(0, 50), hasLink: !!(clickedElement.closest('a') || clickedElement.tagName === 'A') }); // Check if it's an assistant-related click // Look for assistant sidebar (right side) or assistant button at bottom of page const parentElement = clickedElement.closest('button') || clickedElement.closest('div') || clickedElement; const parentText = parentElement ? (parentElement.textContent || '').trim().toLowerCase() : ''; // Check if it's an assistant input field or button const isAssistantInput = clickedElement.tagName === 'INPUT' || clickedElement.tagName === 'TEXTAREA'; const isAssistantButton = clickedElement.tagName === 'BUTTON' || clickedElement.closest('button') !== null; const hasAssistantText = lowerText.includes('ask a question') || lowerText.includes('ask ai assistant') || lowerText.includes('can you tell me') || parentText.includes('ask a question') || parentText.includes('ask ai assistant') || parentText.includes('can you tell me'); const isInAssistantSidebar = clickedElement.closest('[class*="assistant"]') !== null || clickedElement.closest('[class*="chat"]') !== null || clickedElement.closest('[aria-label*="assistant" i]') !== null || clickedElement.closest('[aria-label*="chat" i]') !== null || clickedElement.closest('[id*="assistant"]') !== null || clickedElement.closest('[id*="chat"]') !== null; // Check if it's at the bottom of the page (footer area) - original assistant button const rect = clickedElement.getBoundingClientRect(); const isAtBottom = rect.bottom > window.innerHeight - 100; // Within 100px of bottom const isInFooter = clickedElement.closest('footer') !== null || clickedElement.closest('[class*="footer"]') !== null; // FIRST: Check if it's in search results (listbox with role="listbox") // This must be checked BEFORE checking hasAssistantText, because the button in search results // might not be detected as assistant button initially const listbox = clickedElement.closest('[role="listbox"]'); const isInListbox = listbox !== null; const isInOption = clickedElement.closest('[role="option"]') !== null; // Check if search input is active (has focus or has value) const searchInput = document.getElementById('search-input') || document.querySelector('input[type="search"]') || document.querySelector('input[aria-controls]'); const hasSearchValue = searchInput && searchInput.value && searchInput.value.trim().length > 0; const isSearchFocused = searchInput && document.activeElement === searchInput; // Check if the clicked element is the "Ask AI assistant" button in search results // This button appears at the bottom of search results listbox // It can be identified by: being in a listbox/option AND having assistant text const isSearchResultsButton = (isInListbox || isInOption) && (hasAssistantText || hasSearchValue); console.log('[Mintlify Analytics] Checking if click is from search results:', { isInListbox: isInListbox, isInOption: isInOption, hasSearchValue: hasSearchValue, isSearchFocused: isSearchFocused, hasAssistantText: hasAssistantText, searchValue: searchInput ? searchInput.value : null, clickedText: text.substring(0, 50), parentText: parentText.substring(0, 50) }); if (isSearchResultsButton) { // Get the search query value const searchQuery = searchInput ? searchInput.value.trim() : ''; // Send event for assistant click from search results sendAssistantEvent('docs.assistant.starter_question_clicked', { text: text || parentText, location: 'search_results', element_type: isAssistantButton ? 'button' : 'other', query: searchQuery }); console.log('[Mintlify Analytics] Tracked assistant click from search results, query:', searchQuery); return; // Don't process as navigation click } // Get link element first (needed for all checks) const linkElement = clickedElement.tagName === 'A' ? clickedElement : clickedElement.closest('a'); const isLink = linkElement && linkElement.href; // Check if it's a search result click (link inside listbox/option, but NOT assistant button) // This must be checked AFTER assistant button check, but BEFORE other navigation checks const isSearchResultClick = (isInListbox || isInOption) && isLink && linkElement.href && !hasAssistantText && // Not assistant button hasSearchValue; // Search input has value if (isSearchResultClick) { // Get the search query value const searchQuery = searchInput ? searchInput.value.trim() : ''; const numResults = sessionStorage.getItem('_mintlify_num_search_results'); const numResultsInt = numResults ? parseInt(numResults, 10) : null; // Get clicked text (from link or option) const clickedText = (linkElement.textContent || clickedElement.textContent || '').trim(); // IMPORTANT: Send search event first (if not already sent) // This ensures search event is sent even if user clicked quickly before debounce if (searchQuery && searchQuery.length > 0) { try { const storageProps = getAllStorageProperties(); const searchEventProperties = { query: searchQuery, num_search_results: numResultsInt || 0 }; Object.assign(searchEventProperties, storageProps); if (window.mixpanel && typeof window.mixpanel.track === 'function') { window.mixpanel.track('docs.search', searchEventProperties); console.log('[Mintlify Analytics] Sent docs.search event (triggered by result click)'); } } catch (e) { console.warn('[Mintlify Analytics] Error sending search event from result click:', e); } } // Send search result click event sendNavigationEvent('docs.search.result_click', { query: searchQuery, text: clickedText, url: linkElement.href, num_search_results: numResultsInt }); console.log('[Mintlify Analytics] ✅ Tracked search result click:', { query: searchQuery, url: linkElement.href, numResults: numResultsInt }); return; // Don't process as other navigation click } // Skip assistant input clicks here - they're handled by trackAssistantInput() // to avoid duplicate events. Only handle non-input assistant elements here. if (hasAssistantText || isInAssistantSidebar) { // Only handle non-input assistant elements (buttons, etc.) if (!isAssistantInput) { // Check if it's at the bottom of the page (footer area) if (isAtBottom || isInFooter) { // Send event for assistant click at bottom of page sendAssistantEvent('docs.assistant.starter_question_clicked', { text: text || parentText, location: 'bottom_of_page', element_type: isAssistantButton ? 'button' : 'other' }); console.log('[Mintlify Analytics] Tracked assistant click at bottom of page'); return; // Don't process as navigation click } } } // Check if it's an image click (img tag or click on image inside a link) const imageElement = clickedElement.tagName === 'IMG' ? clickedElement : clickedElement.closest('img'); const isImage = imageElement !== null; // linkElement and isLink are already defined above const linkUrl = isLink ? linkElement.href : ''; const isBase44Link = linkUrl.includes('docs.base44.com'); // If it's an image click, send event with type: 'image' if (isImage) { const imageUrl = imageElement.src || (isLink ? linkUrl : ''); sendNavigationEvent('docs.navitem.cta_click', { type: 'image', text: (clickedElement.alt || imageElement.alt || '').trim(), url: imageUrl, // Add current_url to indicate where the user was when they clicked current_url: window.location.href }); console.log('[Mintlify Analytics] ✅ Detected image click:', { url: imageUrl, alt: imageElement.alt }); return; // Don't process as other click types } // Identify by DOM structure and classes (more reliable than position) // Based on actual DOM inspection: // - Next: linkElement has "ml-auto" class (margin-left auto = right side) // - Previous: linkElement has "space-x-3 group" but NOT "ml-auto" (left side) // - Sidebar: linkElement has "w-full" and "rounded-xl" classes // - Article: linkElement has "link" class let detectedType = null; if (isLink && linkElement && isBase44Link) { const linkClasses = linkElement.className || ''; const linkClassStr = linkClasses.toLowerCase(); // Check for sidebar (most specific pattern) if (linkClassStr.includes('w-full') && linkClassStr.includes('rounded-xl')) { detectedType = 'sidebar'; } // Check for next (has ml-auto = right side) else if (linkClassStr.includes('ml-auto') && linkClassStr.includes('space-x-3')) { detectedType = 'next'; } // Check for previous (has space-x-3 group but NOT ml-auto = left side) else if (linkClassStr.includes('space-x-3') && linkClassStr.includes('group') && !linkClassStr.includes('ml-auto')) { detectedType = 'previous'; } // Check for article (has "link" class) else if (linkClassStr.includes('link') || linkClassStr.trim() === 'link') { detectedType = 'article'; } // If we found a type via DOM structure, use it if (detectedType) { const eventProperties = { type: detectedType, text: (clickedElement.textContent || '').trim() || (linkElement.textContent || '').trim(), url: linkUrl, // Add current_url to indicate where the user was when they clicked current_url: window.location.href }; // For article link clicks, add clicked_url (SQL will extract article_title from it) if (detectedType === 'article' && linkUrl) { eventProperties.clicked_url = linkUrl; } sendNavigationEvent('docs.navitem.cta_click', eventProperties); console.log(`[Mintlify Analytics] ✅ Detected ${detectedType} click via DOM classes: ${linkClasses}`); return; } } // Fallback: If we couldn't identify by classes, default to article for Base44 links if (isLink && isBase44Link) { const eventProperties = { type: 'article', text: (clickedElement.textContent || '').trim() || (linkElement.textContent || '').trim(), url: linkUrl, // Add current_url to indicate where the user was when they clicked current_url: window.location.href }; // For article link clicks, add clicked_url (SQL will extract article_title from it) if (linkUrl) { eventProperties.clicked_url = linkUrl; } sendNavigationEvent('docs.navitem.cta_click', eventProperties); console.log('[Mintlify Analytics] ✅ Detected article link click (fallback)'); } else if (isLink && linkElement && linkElement.href) { // Check if it's an external link (not docs.base44.com) const linkUrl = linkElement.href; const isExternalLink = (linkUrl.startsWith('http://') || linkUrl.startsWith('https://')) && !linkUrl.includes('docs.base44.com'); if (isExternalLink) { // Send event for external link click sendNavigationEvent('docs.navitem.cta_click', { type: 'external', text: (clickedElement.textContent || '').trim() || (linkElement.textContent || '').trim(), url: linkUrl, // Add current_url to indicate where the user was when they clicked current_url: window.location.href }); console.log('[Mintlify Analytics] ✅ Detected external link click:', { url: linkUrl }); } } } catch (e) { console.warn('[Mintlify Analytics] Error tracking click:', e); } }, true); // Use capture phase to catch events early } /** * Track assistant input field interactions */ function trackAssistantInput() { // Helper function to determine assistant location using DOM structure // The assistant starts at the bottom (center) and moves to the right sidebar after a question is asked function getAssistantLocation(element) { try { // DEBUG: Always log DOM structure to help identify patterns // TODO: Remove or make conditional after we identify the correct DOM patterns console.log('[Mintlify Analytics] DEBUG: Analyzing DOM structure for assistant location', { element: element, tagName: element.tagName, classes: element.className, id: element.id, rect: element.getBoundingClientRect() }); const rect = element.getBoundingClientRect(); const computedStyle = window.getComputedStyle(element); // Check if the assistant is on the right side (moved to sidebar after question) // The sidebar is typically on the right side of the screen (more than 50% from left) const isOnRightSide = rect.left > window.innerWidth * 0.5; // Check if it's at the bottom of the viewport (initial position) // Bottom assistant is usually within 200px of the bottom const isAtBottom = rect.bottom > window.innerHeight - 200; // Check if it's in the center-bottom area (initial position before moving) const isInCenterBottom = !isOnRightSide && isAtBottom; // Check for specific DOM patterns that distinguish bottom vs sidebar // IMPORTANT: Check the ACTUAL element that has focus, not other elements in DOM // Priority 1: Sidebar indicator - textarea with id 'chat-assistant-textarea' // This is the most reliable indicator for sidebar (after Enter is pressed) if (element.id === 'chat-assistant-textarea') { console.log('[Mintlify Analytics] DEBUG: Detected sidebar by ID'); return 'assistant_sidebar'; } // Priority 2: Bottom indicator - check if THIS element has a parent with 'chat-assistant-floating-input' // This means we're still in the initial state (before Enter) let current = element; let depth = 0; const maxDepth = 5; // DEBUG: Log parent structure while (current && depth < 5) { console.log(`[Mintlify Analytics] DEBUG: Parent ${depth}:`, { tagName: current.tagName, classes: current.className, id: current.id, position: window.getComputedStyle(current).position, rect: current.getBoundingClientRect() }); current = current.parentElement; depth++; } // Reset for actual logic current = element; depth = 0; // Check if THIS element (the one with focus) has a parent with 'chat-assistant-floating-input' while (current && depth < maxDepth) { const classes = (current.className || '').toString(); const classStr = classes.toLowerCase(); // Bottom indicator: parent has 'chat-assistant-floating-input' class // This is the initial position at the bottom (before Enter) if (classStr.includes('chat-assistant-floating-input')) { console.log('[Mintlify Analytics] DEBUG: Detected bottom by floating-input parent'); return 'bottom_of_page'; } // Move up the DOM tree current = current.parentElement; depth++; } // Second pass: check if it's sidebar (textarea/input with chat-assistant-input class on right side) current = element; depth = 0; const elementClasses = (element.className || '').toString().toLowerCase(); if ((element.tagName === 'TEXTAREA' || element.tagName === 'INPUT') && elementClasses.includes('chat-assistant-input')) { // Check if it's actually on the right side if (isOnRightSide) { console.log('[Mintlify Analytics] DEBUG: Detected sidebar by position and class'); return 'assistant_sidebar'; } } // Fallback: use position-based detection // If on right side and not at bottom = sidebar (moved after question) // If at bottom and not on right side = bottom (initial position) if (isOnRightSide && !isInCenterBottom) { console.log('[Mintlify Analytics] DEBUG: Detected sidebar by position (fallback)'); return 'assistant_sidebar'; } else if (isInCenterBottom || isAtBottom) { console.log('[Mintlify Analytics] DEBUG: Detected bottom by position (fallback)'); return 'bottom_of_page'; } } catch (e) { console.warn('[Mintlify Analytics] Error determining assistant location:', e); } // Default to bottom_of_page (initial position) if we can't determine return 'bottom_of_page'; } // Track focus events on assistant input fields document.addEventListener('focus', function(event) { try { const focusedElement = event.target; if (focusedElement.tagName === 'INPUT' || focusedElement.tagName === 'TEXTAREA') { const placeholder = (focusedElement.getAttribute('placeholder') || '').toLowerCase(); const text = (focusedElement.value || '').toLowerCase(); // Check if it's the assistant input field const isAssistantInput = placeholder.includes('ask a question') || placeholder.includes('ask ai') || placeholder.includes('question'); if (isAssistantInput && !focusedElement.hasAttribute('data-mintlify-assistant-tracked')) { // Mark as tracked to avoid duplicate events focusedElement.setAttribute('data-mintlify-assistant-tracked', 'true'); // Check if this is coming from search results (before determining location) // If the search input is active and has a value, and this is the sidebar textarea, // it means the user clicked "Ask AI assistant" from search results const searchInput = document.getElementById('search-input') || document.querySelector('input[type="search"]') || document.querySelector('input[aria-controls]'); const hasSearchValue = searchInput && searchInput.value && searchInput.value.trim().length > 0; const searchQuery = searchInput ? searchInput.value.trim() : ''; const isInSearchResults = hasSearchValue && focusedElement.id === 'chat-assistant-textarea'; // Determine location based on the ACTUAL element that has focus // If it's the bottom input (with floating-input parent) → bottom_of_page // If it's the sidebar textarea (with chat-assistant-textarea ID) → assistant_sidebar // BUT: if it's from search results, use 'search_results' instead let location = getAssistantLocation(focusedElement); if (isInSearchResults) { location = 'search_results'; } // Prepare event properties const eventProperties = { text: text || placeholder, location: location, element_type: 'input_focus' }; // Add query if it's from search results if (isInSearchResults && searchQuery) { eventProperties.query = searchQuery; } // Send event for assistant input focus sendAssistantEvent('docs.assistant.starter_question_clicked', eventProperties); console.log('[Mintlify Analytics] Tracked assistant input focus, location:', location, 'isInSearchResults:', isInSearchResults, 'query:', searchQuery); } } } catch (e) { console.warn('[Mintlify Analytics] Error tracking assistant input:', e); } }, true); // Use capture phase // Also use MutationObserver to watch for assistant input fields being added to DOM // This catches cases where the input is created after the sidebar moves const assistantInputObserver = new MutationObserver(function(mutations) { try { // Find all input/textarea elements that might be assistant inputs const allInputs = document.querySelectorAll('input[placeholder*="ask" i], textarea[placeholder*="ask" i], input[placeholder*="question" i], textarea[placeholder*="question" i]'); allInputs.forEach(function(input) { if (!input.hasAttribute('data-mintlify-assistant-listener')) { // Mark as having listener to avoid duplicates input.setAttribute('data-mintlify-assistant-listener', 'true'); // Check if it's an assistant input (by placeholder or DOM structure) const placeholder = (input.getAttribute('placeholder') || '').toLowerCase(); const isAssistantInput = placeholder.includes('ask a question') || placeholder.includes('ask ai') || placeholder.includes('question'); // Only track if it's actually an assistant input if (isAssistantInput) { // Determine location using DOM structure (similar to next/previous detection) const location = getAssistantLocation(input); // Add focus listener directly to this input // Note: We only track focus, not click, to avoid duplicate events // The global focus listener also handles this, but this ensures we catch // inputs that are added to DOM after page load input.addEventListener('focus', function() { if (!input.hasAttribute('data-mintlify-assistant-tracked')) { input.setAttribute('data-mintlify-assistant-tracked', 'true'); const placeholder = (input.getAttribute('placeholder') || '').toLowerCase(); const text = (input.value || '').toLowerCase(); // Determine location based on the ACTUAL element that has focus const currentLocation = getAssistantLocation(input); sendAssistantEvent('docs.assistant.starter_question_clicked', { text: text || placeholder, location: currentLocation, element_type: 'input_focus' }); console.log('[Mintlify Analytics] Tracked assistant input focus (via observer), location:', currentLocation); } }, true); } } }); } catch (e) { console.warn('[Mintlify Analytics] Error in assistant input observer:', e); } }); try { assistantInputObserver.observe(document.body, { childList: true, subtree: true }); } catch (e) { console.warn('[Mintlify Analytics] Error setting up assistant input observer:', e); } } /** * Track assistant message responses * Detects when the assistant returns a response and sends an event with the message content */ function trackAssistantMessages() { console.log('[Mintlify Analytics] trackAssistantMessages() called'); // Track messages that have already been sent to avoid duplicates // Key: messageId, Value: timestamp when it was sent const sentMessages = new Map(); // Debounce timer for sending messages (wait 1 second after last change before sending) let debounceTimer = null; const DEBOUNCE_DELAY = 1000; // 1 second (reduced from 2 seconds) // Helper function to create a simple hash from text function simpleHash(text) { let hash = 0; for (let i = 0; i < text.length; i++) { const char = text.charCodeAt(i); hash = ((hash << 5) - hash) + char; hash = hash & hash; // Convert to 32bit integer } return Math.abs(hash).toString(36); } // Helper function to extract text from a message element function extractMessageText(element) { try { // Try to get text content, excluding input/textarea elements const clone = element.cloneNode(true); const inputs = clone.querySelectorAll('input, textarea, button'); inputs.forEach(function(input) { input.remove(); }); const text = (clone.textContent || '').trim(); return text; } catch (e) { console.warn('[Mintlify Analytics] Error extracting message text:', e); return (element.textContent || '').trim(); } } // Helper function to check if an element is an assistant message function isAssistantMessage(element) { try { // Check if element is inside assistant/chat container const assistantContainer = element.closest('[class*="assistant" i], [class*="chat" i], [id*="assistant" i], [id*="chat" i]'); if (!assistantContainer) { return false; } // Check if it's not the input field itself if (element.tagName === 'INPUT' || element.tagName === 'TEXTAREA') { return false; } // Check if it contains text (not empty) const text = extractMessageText(element); if (!text || text.length < 10) { return false; } // Check if it's likely a message (not a button, input, etc.) const tagName = element.tagName.toLowerCase(); if (tagName === 'button' || tagName === 'input' || tagName === 'textarea') { return false; } return true; } catch (e) { console.warn('[Mintlify Analytics] Error in isAssistantMessage:', e); return false; } } // Helper function to generate a unique ID for a message based on text content function getMessageId(element) { try { const text = extractMessageText(element); if (!text || text.length < 10) { return null; } // Use text hash as ID (more reliable than position) // Take first 200 chars for hash to ensure uniqueness const textForHash = text.substring(0, 200); const hash = simpleHash(textForHash); return hash; } catch (e) { return null; } } // Helper function to send message event (with debounce) function sendMessageEvent(messageText, messageId, source) { // Clear existing timer if (debounceTimer) { clearTimeout(debounceTimer); } // Set new timer - wait 1.5 seconds after last change before sending debounceTimer = setTimeout(function() { // Check again if message was already sent (in case of race condition) if (!sentMessages.has(messageId)) { sentMessages.set(messageId, Date.now()); // Send event with message content in used_keyword field sendAssistantEvent('docs.assistant.message', { used_keyword: messageText, message_length: messageText.length, location: 'assistant_sidebar' }); console.log('[Mintlify Analytics] ✅ Tracked assistant message:', { messageId: messageId, length: messageText.length, preview: messageText.substring(0, 100) }); } }, 1500); // 1.5 seconds debounce } // Use MutationObserver to watch for new assistant messages const messageObserver = new MutationObserver(function(mutations) { try { // Process all mutations mutations.forEach(function(mutation) { // Check for new nodes if (mutation.type === 'childList' && mutation.addedNodes.length > 0) { mutation.addedNodes.forEach(function(node) { // Only process element nodes if (node.nodeType !== 1) { return; } // Check if this node or any of its children is an assistant message const checkElement = function(element) { if (isAssistantMessage(element)) { const messageId = getMessageId(element); if (messageId && !sentMessages.has(messageId)) { const messageText = extractMessageText(element); if (messageText && messageText.length > 10) { // Use debounced send function sendMessageEvent(messageText, messageId, 'childList'); } } } // Also check children const children = element.querySelectorAll('> *'); children.forEach(function(child) { checkElement(child); }); }; checkElement(node); }); } // Check for text changes in existing elements (for streaming responses) if (mutation.type === 'characterData') { const target = mutation.target; if (target && target.parentElement) { const element = target.parentElement; if (element && isAssistantMessage(element)) { const messageId = getMessageId(element); if (messageId && !sentMessages.has(messageId)) { const messageText = extractMessageText(element); if (messageText && messageText.length > 10) { // Use debounced send function sendMessageEvent(messageText, messageId, 'characterData'); } } } } } }); } catch (e) { console.warn('[Mintlify Analytics] Error in message observer:', e); } }); // Start observing - use document.body to catch all changes try { messageObserver.observe(document.body, { childList: true, subtree: true, characterData: true }); console.log('[Mintlify Analytics] ✅ Assistant message tracking observer set up'); } catch (e) { console.warn('[Mintlify Analytics] Error setting up message observer:', e); } } /** * Initialize when page loads */ function init() { console.log('[Mintlify Analytics] Initializing...'); // Monitor search results monitorSearchResults(); console.log('[Mintlify Analytics] Search results monitoring set up'); // Track navigation clicks (next/previous/sidebar) trackNavigationClicks(); console.log('[Mintlify Analytics] Navigation click tracking set up'); // Track assistant input interactions trackAssistantInput(); console.log('[Mintlify Analytics] Assistant input tracking set up'); // Track assistant message responses trackAssistantMessages(); console.log('[Mintlify Analytics] Assistant message tracking set up'); } // CRITICAL: Set up API interception IMMEDIATELY (before DOMContentLoaded) // This ensures we intercept Mixpanel events even if they're sent early interceptMixpanelAPI(); console.log('[Mintlify Analytics] API interception set up (early) at', new Date().toISOString()); // Start rest of initialization when DOM is ready if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', init); } else { init(); } })();

Overview

JavaScript SDK

Monitoring API

CLI

​Usage

​Requirements

​See also

Usage

Requirements

See also