@manototh/do11y 0.0.4 → 0.1.1

package/README.md

@@ -2,7 +2,7 @@
 
 > Originally derived from [github.com/axiomhq/do11y](https://github.com/axiomhq/do11y)
 
-Do11y is a documentation observability tool. It streams behavioral events from your docs site to [Supabase](https://supabase.com) (or any HTTP endpoint) in real time:
+Do11y is a documentation observability tool. It streams behavioral events from your docs site to [Supabase](https://supabase.com) (or any HTTP endpoint or OpenTelemetry-compatible backend) in real time:
 
 - Page views
 - Scroll depth
@@ -42,6 +42,8 @@ Do11y supports the latest versions of the following frameworks:
 - Nextra
 - MkDocs Material
 - VitePress
+- Starlight (Astro)
+- Docsy (Hugo)
 
 For other frameworks, use manual setup with custom selectors.
 

package/dist/do11y.js

@@ -1,15 +1,89 @@
 (function() {
 	//#region src/do11y.ts
-	const VERSION = "0.0.4";
+	/**
+	* OTel semantic convention attribute keys.
+	* Standard attrs from https://opentelemetry.io/docs/specs/semconv/.
+	* Custom do11y attrs use the `browser.do11y.*` namespace.
+	*/
+	const ATTR_SESSION_ID = "session.id";
+	const ATTR_URL_PATH = "url.path";
+	const ATTR_URL_FRAGMENT = "url.fragment";
+	const ATTR_URL_QUERY = "url.query";
+	const ATTR_DEVICE_TYPE = "device.type";
+	const ATTR_BROWSER_FAMILY = "browser.family";
+	const ATTR_BROWSER_LANGUAGE = "browser.language";
+	const ATTR_DO11Y_SESSION_PAGE_COUNT = "browser.do11y.session_page_count";
+	const ATTR_DO11Y_PAGE_TITLE = "browser.do11y.page_title";
+	const ATTR_DO11Y_VIEWPORT_CATEGORY = "browser.do11y.viewport_category";
+	const ATTR_DO11Y_TIMEZONE_OFFSET = "browser.do11y.timezone_offset";
+	const ATTR_DO11Y_REFERRER_CATEGORY = "browser.do11y.referrer_category";
+	const ATTR_DO11Y_AI_PLATFORM = "browser.do11y.ai_platform";
+	const ATTR_DO11Y_DO11Y_VERSION = "browser.do11y.version";
+	const ATTR_DO11Y_IS_FIRST_PAGE = "browser.do11y.is_first_page";
+	const ATTR_DO11Y_PREVIOUS_PATH = "browser.do11y.previous_path";
+	const ATTR_DO11Y_REFERRER_DOMAIN = "browser.do11y.referrer_domain";
+	const ATTR_DO11Y_LINK_TYPE = "browser.do11y.link.type";
+	const ATTR_DO11Y_LINK_TARGET_URL = "browser.do11y.link.target_url";
+	const ATTR_DO11Y_LINK_TARGET_DOMAIN = "browser.do11y.link.target_domain";
+	const ATTR_DO11Y_LINK_TEXT = "browser.do11y.link.text";
+	const ATTR_DO11Y_LINK_CONTEXT = "browser.do11y.link.context";
+	const ATTR_DO11Y_LINK_SECTION = "browser.do11y.link.section";
+	const ATTR_DO11Y_LINK_INDEX = "browser.do11y.link.index";
+	const ATTR_DO11Y_SCROLL_THRESHOLD = "browser.do11y.scroll.threshold";
+	const ATTR_DO11Y_SCROLL_PERCENT = "browser.do11y.scroll.percent";
+	const ATTR_DO11Y_TOTAL_TIME_SECONDS = "browser.do11y.page_exit.total_time_seconds";
+	const ATTR_DO11Y_ACTIVE_TIME_SECONDS = "browser.do11y.page_exit.active_time_seconds";
+	const ATTR_DO11Y_ENGAGEMENT_RATIO = "browser.do11y.page_exit.engagement_ratio";
+	const ATTR_DO11Y_MAX_SCROLL_DEPTH = "browser.do11y.page_exit.max_scroll_depth";
+	const ATTR_DO11Y_SEARCH_TRIGGER = "browser.do11y.search.trigger";
+	const ATTR_DO11Y_CODE_LANGUAGE = "browser.do11y.code.language";
+	const ATTR_DO11Y_CODE_SECTION = "browser.do11y.code.section";
+	const ATTR_DO11Y_CODE_INDEX = "browser.do11y.code.index";
+	const ATTR_DO11Y_SECTION_HEADING = "browser.do11y.section.heading";
+	const ATTR_DO11Y_SECTION_HEADING_LEVEL = "browser.do11y.section.heading_level";
+	const ATTR_DO11Y_SECTION_VISIBLE_SECONDS = "browser.do11y.section.visible_seconds";
+	const ATTR_DO11Y_TAB_LABEL = "browser.do11y.tab.label";
+	const ATTR_DO11Y_TAB_GROUP = "browser.do11y.tab.group";
+	const ATTR_DO11Y_TAB_IS_DEFAULT = "browser.do11y.tab.is_default";
+	const ATTR_DO11Y_TOC_HEADING = "browser.do11y.toc.heading";
+	const ATTR_DO11Y_TOC_HEADING_LEVEL = "browser.do11y.toc.heading_level";
+	const ATTR_DO11Y_TOC_POSITION = "browser.do11y.toc.position";
+	const ATTR_DO11Y_FEEDBACK_RATING = "browser.do11y.feedback.rating";
+	const ATTR_DO11Y_EXPAND_SUMMARY = "browser.do11y.expand.summary";
+	const ATTR_DO11Y_EXPAND_ACTION = "browser.do11y.expand.action";
+	const ATTR_DO11Y_EXPAND_SECTION = "browser.do11y.expand.section";
+	/**
+	* OTel event names for do11y events (browser.do11y.* namespace).
+	*/
+	const EVENT_PAGE_VIEW = "browser.do11y.page_view";
+	const EVENT_PAGE_EXIT = "browser.do11y.page_exit";
+	const EVENT_SCROLL_DEPTH = "browser.do11y.scroll_depth";
+	const EVENT_LINK_CLICK = "browser.do11y.link_click";
+	const EVENT_SEARCH_OPENED = "browser.do11y.search_opened";
+	const EVENT_CODE_COPIED = "browser.do11y.code_copied";
+	const EVENT_SECTION_VISIBLE = "browser.do11y.section_visible";
+	const EVENT_TAB_SWITCH = "browser.do11y.tab_switch";
+	const EVENT_TOC_CLICK = "browser.do11y.toc_click";
+	const EVENT_FEEDBACK = "browser.do11y.feedback";
+	const EVENT_EXPAND_COLLAPSE = "browser.do11y.expand_collapse";
+	const VERSION = "0.1.1";
 	const _alreadyLoaded = !!window.__do11yInitialized;
 	window.__do11yInitialized = true;
+	const _isInIframe = window.self !== window.top;
+	if (_isInIframe && !_alreadyLoaded) window.__do11yInitialized = false;
 	const config = {
 		destination: "supabase",
 		supabaseUrl: "",
 		supabaseKey: "",
 		supabaseTable: "do11y_events",
-		httpEndpoint: "",
-		httpHeaders: {},
+		endpoint: "",
+		headers: {},
+		bodyTransform: void 0,
+		otelSdkEndpoint: "",
+		otelSdkHeaders: {},
+		otelSdkServiceName: "do11y",
+		otelSdkResourceAttributes: {},
+		otelSdkCdnUrl: "https://esm.sh/",
 		debug: false,
 		flushInterval: 5e3,
 		maxBatchSize: 10,
@@ -42,7 +116,8 @@
 		codeBlockSelector: null,
 		navigationSelector: null,
 		footerSelector: null,
-		contentSelector: null
+		contentSelector: null,
+		useOtelBrowserInstrumentations: false
 	};
 	const FRAMEWORK_PRESETS = {
 		mintlify: {
@@ -110,6 +185,17 @@
 			tabContainerSelector: "starlight-tabs [role=\"tablist\"], [role=\"tablist\"]",
 			tocSelector: ".right-sidebar-panel, starlight-toc, mobile-starlight-toc",
 			feedbackSelector: "[class*=\"feedback\"], [class*=\"helpful\"]"
+		},
+		docsy: {
+			searchSelector: ".td-search input, .td-search__input, #docsearch-0, #docsearch-1",
+			copyButtonSelector: "button[aria-label*=\"copy\" i], button[title*=\"copy\" i], .td-click-to-copy",
+			codeBlockSelector: ".highlight, pre.chroma, pre",
+			navigationSelector: "nav, [role=\"navigation\"], .td-sidebar, .td-navbar, [class*=\"sidebar\"]",
+			footerSelector: "footer, [role=\"contentinfo\"], .td-footer, [class*=\"footer\"]",
+			contentSelector: "main, article, [role=\"main\"], .td-content, [class*=\"content\"]",
+			tabContainerSelector: ".nav-tabs[role=\"tablist\"], [role=\"tablist\"], .tab-content",
+			tocSelector: ".td-toc, nav[id=\"TableOfContents\"], [class*=\"toc\"]",
+			feedbackSelector: ".feedback--answer, [class*=\"feedback\"], [class*=\"helpful\"]"
 		}
 	};
 	const SELECTOR_KEYS = [
@@ -175,12 +261,6 @@
 			return null;
 		}
 	}
-	/** Paths that are not documentation pages (for example tracking pixels). */
-	const ENGAGEMENT_EXCLUDED_PATH_PREFIXES = ["/pixel/"];
-	function isEngagementExcludedPath(path) {
-		const p = path ?? window.location.pathname;
-		return ENGAGEMENT_EXCLUDED_PATH_PREFIXES.some((prefix) => p.startsWith(prefix));
-	}
 	function getElementClassName(el) {
 		if (typeof el.className === "string") return el.className;
 		const svgClass = el.className;
@@ -307,11 +387,11 @@
 	}
 	function getBrowserContext() {
 		return {
-			viewportCategory: categorizeViewport(),
-			browserFamily: getBrowserFamily(),
-			deviceType: getDeviceType(),
-			language: (navigator.language || "").split("-")[0] || "unknown",
-			timezoneOffset: (/* @__PURE__ */ new Date()).getTimezoneOffset() / 60
+			[ATTR_DO11Y_VIEWPORT_CATEGORY]: categorizeViewport(),
+			[ATTR_BROWSER_FAMILY]: getBrowserFamily(),
+			[ATTR_DEVICE_TYPE]: getDeviceType(),
+			[ATTR_BROWSER_LANGUAGE]: (navigator.language || "").split("-")[0] || "unknown",
+			[ATTR_DO11Y_TIMEZONE_OFFSET]: (/* @__PURE__ */ new Date()).getTimezoneOffset() / 60
 		};
 	}
 	function categorizeViewport() {
@@ -460,38 +540,47 @@
 	}
 	function getPageInfo() {
 		return {
-			path: window.location.pathname,
-			hash: window.location.hash || null,
-			search: window.location.search ? "has_params" : null,
-			title: sanitizeText(document.title, 150)
+			[ATTR_URL_PATH]: window.location.pathname,
+			[ATTR_URL_FRAGMENT]: window.location.hash || null,
+			[ATTR_URL_QUERY]: window.location.search ? "has_params" : null,
+			[ATTR_DO11Y_PAGE_TITLE]: sanitizeText(document.title, 150)
 		};
 	}
 	let eventQueue = [];
 	let flushTimeout = null;
 	const lastEventTime = {};
 	let isDisabled = false;
-	function queueEvent(eventType, eventData) {
+	function queueEvent(eventName, eventData) {
 		if (isDisabled) return;
 		const now = Date.now();
-		if (config.rateLimitMs > 0 && lastEventTime[eventType]) {
-			if (now - lastEventTime[eventType] < config.rateLimitMs) {
-				if (config.debug) console.log("[Do11y] Rate limited:", eventType);
+		if (config.rateLimitMs > 0 && lastEventTime[eventName]) {
+			if (now - lastEventTime[eventName] < config.rateLimitMs) {
+				if (config.debug) console.log("[Do11y] Rate limited:", eventName);
 				return;
 			}
 		}
-		lastEventTime[eventType] = now;
+		lastEventTime[eventName] = now;
 		const session = getSession();
 		const event = {
 			_time: (/* @__PURE__ */ new Date()).toISOString(),
-			eventType,
-			"do11y_version": VERSION,
-			sessionId: session.id,
-			sessionPageCount: session.pageCount,
+			eventName,
+			[ATTR_DO11Y_DO11Y_VERSION]: VERSION,
+			[ATTR_SESSION_ID]: session.id,
+			[ATTR_DO11Y_SESSION_PAGE_COUNT]: session.pageCount,
 			...getPageInfo(),
 			...getBrowserContext(),
 			...eventData
 		};
-		if (config.debug) console.log("[Do11y] Event queued:", event);
+		if (config.debug) console.log("[Do11y] Event queued:", eventName, event);
+		if (config.destination === "otlp" && _otelLogger) {
+			_otelLogger.emit({
+				eventName,
+				severityNumber: 9,
+				attributes: event,
+				body: ""
+			});
+			return;
+		}
 		eventQueue.push(event);
 		if (eventQueue.length > 100) {
 			eventQueue = eventQueue.slice(-100);
@@ -504,6 +593,7 @@
 		if (flushTimeout) return;
 		flushTimeout = setTimeout(flush, config.flushInterval);
 	}
+	let _otelLogger = null;
 	function validateSupabaseUrl(url) {
 		try {
 			const parsed = new URL(url);
@@ -514,7 +604,7 @@
 			return false;
 		}
 	}
-	function validateHttpEndpoint(url) {
+	function validateEndpoint(url) {
 		try {
 			const parsed = new URL(url);
 			if (parsed.protocol !== "https:") return false;
@@ -547,37 +637,90 @@
 			return true;
 		}
 		if (config.destination === "http") {
-			if (!config.httpEndpoint) {
+			if (!config.endpoint) {
 				if (config.debug) console.warn("[Do11y] No HTTP endpoint configured");
 				return false;
 			}
-			if (!validateHttpEndpoint(config.httpEndpoint)) {
+			if (!validateEndpoint(config.endpoint)) {
 				if (config.debug) console.warn("[Do11y] Invalid HTTP endpoint. Must be HTTPS and not a private address.");
 				return false;
 			}
 			return true;
 		}
+		if (config.destination === "otlp") {
+			if (!config.otelSdkEndpoint) {
+				if (config.debug) console.warn("[Do11y] No OTLP endpoint configured");
+				return false;
+			}
+			initOtelSdk().catch((err) => {
+				if (config.debug) console.warn("[Do11y] OTel SDK initialization failed:", err);
+			});
+			return true;
+		}
 		if (config.debug) console.warn("[Do11y] Unknown destination:", config.destination);
 		return false;
 	}
-	function buildRequest(events) {
-		if (config.destination === "supabase") return {
-			url: config.supabaseUrl.replace(/\/$/, "") + "/rest/v1/" + config.supabaseTable,
-			headers: {
-				"apikey": config.supabaseKey,
-				"Authorization": "Bearer " + config.supabaseKey,
-				"Content-Type": "application/json",
-				"Prefer": "return=minimal"
-			},
-			body: JSON.stringify(events.map((e) => ({ payload: e })))
+	/**
+	* Dynamically import the OTel Browser SDK and set up the LoggerProvider.
+	* Only called when destination is 'otlp'.
+	*/
+	async function initOtelSdk() {
+		if (_otelLogger) return;
+		const cdnBase = config.otelSdkCdnUrl.replace(/\/+$/, "") + "/";
+		const apiLogs = await import(
+			/* @vite-ignore */
+			`${cdnBase}@opentelemetry/api-logs`
+);
+		const sdkLogs = await import(
+			/* @vite-ignore */
+			`${cdnBase}@opentelemetry/sdk-logs`
+);
+		const otlpExporter = await import(
+			/* @vite-ignore */
+			`${cdnBase}@opentelemetry/exporter-logs-otlp-http`
+);
+		const resourceAttrs = {
+			"service.name": config.otelSdkServiceName || "do11y",
+			"service.version": VERSION,
+			"telemetry.sdk.name": "do11y",
+			"telemetry.sdk.language": "webjs",
+			"telemetry.sdk.version": VERSION,
+			...config.otelSdkResourceAttributes
 		};
+		const loggerProvider = new sdkLogs.LoggerProvider({
+			resource: { attributes: resourceAttrs },
+			processors: [new sdkLogs.BatchLogRecordProcessor({ exporter: new otlpExporter.OTLPLogExporter({
+				url: config.otelSdkEndpoint.replace(/\/$/, "") + "/v1/logs",
+				headers: config.otelSdkHeaders
+			}) })]
+		});
+		apiLogs.logs.setGlobalLoggerProvider(loggerProvider);
+		_otelLogger = loggerProvider.getLogger("do11y");
+		if (config.debug) console.log("[Do11y] OTel SDK initialized with endpoint:", config.otelSdkEndpoint);
+	}
+	function buildRequest(events) {
+		if (config.destination === "supabase") {
+			const url = config.supabaseUrl.replace(/\/$/, "") + "/rest/v1/" + config.supabaseTable;
+			const bodyTransform = config.bodyTransform ?? ((evts) => evts.map((e) => ({ payload: e })));
+			return {
+				url,
+				headers: {
+					"apikey": config.supabaseKey,
+					"Authorization": "Bearer " + config.supabaseKey,
+					"Content-Type": "application/json",
+					"Prefer": "return=minimal"
+				},
+				body: JSON.stringify(bodyTransform(events))
+			};
+		}
+		const bodyTransform = config.bodyTransform ?? ((evts) => evts);
 		return {
-			url: config.httpEndpoint,
+			url: config.endpoint,
 			headers: {
 				"Content-Type": "application/json",
-				...config.httpHeaders
+				...config.headers
 			},
-			body: JSON.stringify(events)
+			body: JSON.stringify(bodyTransform(events))
 		};
 	}
 	function flush(retriesLeft) {
@@ -592,12 +735,25 @@
 		eventQueue = [];
 		sendEvents(buildRequest(events), events, retries);
 	}
+	/**
+	* Check whether a request URL is cross-origin relative to the current page.
+	*/
+	function isCrossOrigin(url) {
+		try {
+			return new URL(url).origin !== window.location.origin;
+		} catch {
+			return false;
+		}
+	}
 	function sendEvents(req, events, retriesLeft) {
+		const crossOrigin = isCrossOrigin(req.url);
+		if (config.debug && crossOrigin) console.log("[Do11y] Cross-origin request to", new URL(req.url).origin, "- requires CORS headers on the server");
 		fetch(req.url, {
 			method: "POST",
 			headers: req.headers,
 			body: req.body,
-			keepalive: true
+			keepalive: true,
+			mode: crossOrigin ? "cors" : "same-origin"
 		}).then((response) => {
 			if (response.ok) {
 				if (config.debug) console.log("[Do11y] Flushed", events.length, "events");
@@ -612,19 +768,29 @@
 				return;
 			}
 			if (config.debug) response.text().then((text) => {
-				console.error("[Do11y] Ingest failed:", response.status, text);
+				const msg = `[Do11y] Ingest failed: ${response.status}`;
+				if (response.status === 0 && response.type === "opaque") console.error(msg, "- CORS error: server did not return Access-Control-Allow-Origin");
+				else console.error(msg, text);
 			}).catch(() => {});
 		}).catch((err) => {
 			if (retriesLeft > 0) {
-				if (config.debug) console.log("[Do11y] Network error, retrying:", err.message);
+				if (config.debug) {
+					const hint = crossOrigin ? " (this may be a CORS issue — try using an OTel Collector proxy)" : "";
+					console.log("[Do11y] Network error, retrying:", err.message + hint);
+				}
 				eventQueue = events.concat(eventQueue);
 				setTimeout(() => {
 					flush(retriesLeft - 1);
 				}, config.retryDelay * (config.maxRetries - retriesLeft + 1));
-			} else if (config.debug) console.error("[Do11y] Failed to send events:", err);
+			} else if (config.debug) console.error("[Do11y] Failed to send events:", err.message);
 		});
 	}
+	/**
+	* Synchronous flush used on `beforeunload`. For OTLP mode the SDK
+	* handles flush on its own; for HTTP/Supabase we use fetch with keepalive.
+	*/
 	function flushSync() {
+		if (config.destination === "otlp") return;
 		if (eventQueue.length === 0) return;
 		if (!validateConfig()) return;
 		const events = eventQueue;
@@ -641,6 +807,7 @@
 		if (config.debug) console.log("[Do11y] Sync flushed", events.length, "events");
 	}
 	function trackPageView() {
+		pageExited = false;
 		const session = updatePageSequence(window.location.pathname);
 		const referrerDomain = getReferrerDomain();
 		const referrerInfo = classifyReferrer(referrerDomain);
@@ -649,12 +816,12 @@
 			session.aiPlatform = referrerInfo.aiPlatform;
 			saveSession(session);
 		}
-		queueEvent("page_view", {
-			referrerDomain,
-			referrerCategory: referrerInfo.referrerCategory,
-			aiPlatform: referrerInfo.aiPlatform,
-			isFirstPage: session.pageCount === 1,
-			previousPath: session.pageSequence.length > 1 ? session.pageSequence[session.pageSequence.length - 2].path : null
+		queueEvent(EVENT_PAGE_VIEW, {
+			[ATTR_DO11Y_REFERRER_DOMAIN]: referrerDomain,
+			[ATTR_DO11Y_REFERRER_CATEGORY]: referrerInfo.referrerCategory,
+			[ATTR_DO11Y_AI_PLATFORM]: referrerInfo.aiPlatform,
+			[ATTR_DO11Y_IS_FIRST_PAGE]: session.pageCount === 1,
+			[ATTR_DO11Y_PREVIOUS_PATH]: session.pageSequence.length > 1 ? session.pageSequence[session.pageSequence.length - 2].path : null
 		});
 	}
 	function setupLinkTracking() {
@@ -679,14 +846,14 @@
 			} catch {}
 			if (linkType === "internal" && !config.trackInternalLinks) return;
 			if (linkType === "external" && !config.trackOutboundLinks) return;
-			queueEvent("link_click", {
-				linkType,
-				targetUrl: href,
-				targetDomain,
-				linkText: sanitizeText(link.textContent, 100),
-				linkContext: getLinkContext(link),
-				linkSection: sanitizeText(getNearestHeading(link), 100),
-				linkIndex: getLinkIndex(link, href)
+			queueEvent(EVENT_LINK_CLICK, {
+				[ATTR_DO11Y_LINK_TYPE]: linkType,
+				[ATTR_DO11Y_LINK_TARGET_URL]: href,
+				[ATTR_DO11Y_LINK_TARGET_DOMAIN]: targetDomain,
+				[ATTR_DO11Y_LINK_TEXT]: sanitizeText(link.textContent, 100),
+				[ATTR_DO11Y_LINK_CONTEXT]: getLinkContext(link),
+				[ATTR_DO11Y_LINK_SECTION]: sanitizeText(getNearestHeading(link), 100),
+				[ATTR_DO11Y_LINK_INDEX]: getLinkIndex(link, href)
 			});
 			flush();
 		}, true);
@@ -774,7 +941,6 @@
 	* the content without scrolling.
 	*/
 	function checkScrollDepth() {
-		if (isEngagementExcludedPath()) return;
 		let scrollTop;
 		let totalHeight;
 		let viewportHeight;
@@ -792,9 +958,9 @@
 			config.scrollThresholds.forEach((threshold) => {
 				if (!trackedScrollDepths.has(threshold)) {
 					trackedScrollDepths.add(threshold);
-					queueEvent("scroll_depth", {
-						threshold,
-						scrollPercent: 100
+					queueEvent(EVENT_SCROLL_DEPTH, {
+						[ATTR_DO11Y_SCROLL_THRESHOLD]: threshold,
+						[ATTR_DO11Y_SCROLL_PERCENT]: 100
 					});
 				}
 			});
@@ -804,9 +970,9 @@
 		config.scrollThresholds.forEach((threshold) => {
 			if (scrollPercent >= threshold && !trackedScrollDepths.has(threshold)) {
 				trackedScrollDepths.add(threshold);
-				queueEvent("scroll_depth", {
-					threshold,
-					scrollPercent
+				queueEvent(EVENT_SCROLL_DEPTH, {
+					[ATTR_DO11Y_SCROLL_THRESHOLD]: threshold,
+					[ATTR_DO11Y_SCROLL_PERCENT]: scrollPercent
 				});
 			}
 		});
@@ -815,8 +981,10 @@
 	let lastActivityTime = Date.now();
 	let totalActiveTime = 0;
 	let isPageVisible = true;
+	let pageExited = false;
 	function emitPageExit() {
-		if (isEngagementExcludedPath()) return;
+		if (pageExited) return;
+		pageExited = true;
 		if (isPageVisible) totalActiveTime += Date.now() - lastActivityTime;
 		const totalTime = Date.now() - pageLoadTime;
 		const engagementRatio = totalTime > 0 ? totalActiveTime / totalTime : 0;
@@ -826,13 +994,13 @@
 		});
 		flushVisibleSections();
 		const session = getSession();
-		queueEvent("page_exit", {
-			totalTimeSeconds: Math.round(totalTime / 1e3),
-			activeTimeSeconds: Math.round(totalActiveTime / 1e3),
-			engagementRatio: Math.round(engagementRatio * 100) / 100,
-			maxScrollDepth: maxScroll,
-			referrerCategory: session.referrerCategory,
-			aiPlatform: session.aiPlatform
+		queueEvent(EVENT_PAGE_EXIT, {
+			[ATTR_DO11Y_TOTAL_TIME_SECONDS]: Math.round(totalTime / 1e3),
+			[ATTR_DO11Y_ACTIVE_TIME_SECONDS]: Math.round(totalActiveTime / 1e3),
+			[ATTR_DO11Y_ENGAGEMENT_RATIO]: Math.round(engagementRatio * 100) / 100,
+			[ATTR_DO11Y_MAX_SCROLL_DEPTH]: maxScroll,
+			[ATTR_DO11Y_REFERRER_CATEGORY]: session.referrerCategory,
+			[ATTR_DO11Y_AI_PLATFORM]: session.aiPlatform
 		});
 	}
 	function setupEngagementTracking() {
@@ -854,10 +1022,10 @@
 	}
 	function setupSearchTracking() {
 		document.addEventListener("click", (e) => {
-			if (e.target.closest(config.searchSelector)) queueEvent("search_opened", {});
+			if (e.target.closest(config.searchSelector)) queueEvent(EVENT_SEARCH_OPENED, {});
 		}, true);
 		document.addEventListener("keydown", (e) => {
-			if ((e.metaKey || e.ctrlKey) && e.key === "k") queueEvent("search_opened", { trigger: "keyboard" });
+			if ((e.metaKey || e.ctrlKey) && e.key === "k") queueEvent(EVENT_SEARCH_OPENED, { [ATTR_DO11Y_SEARCH_TRIGGER]: "keyboard" });
 		});
 	}
 	function getCodeBlockIndex(codeBlock) {
@@ -873,10 +1041,11 @@
 			const copyButton = e.target.closest(config.copyButtonSelector);
 			if (copyButton) {
 				const codeBlock = copyButton.closest("[class*=\"language-\"], [language]") ?? copyButton.closest(config.codeBlockSelector) ?? copyButton.closest(".expressive-code")?.querySelector("pre") ?? copyButton.closest("div, section")?.querySelector("pre") ?? copyButton.parentElement?.querySelector("pre") ?? null;
-				queueEvent("code_copied", {
-					language: extractCodeLanguage((codeBlock ? codeBlock.tagName === "PRE" ? codeBlock.querySelector("code") : codeBlock.querySelector("code[class*=\"language-\"], code[language]") ?? codeBlock.querySelector("code") : null) ?? codeBlock ?? copyButton),
-					codeSection: sanitizeText(getNearestHeading(codeBlock ?? copyButton), 100),
-					codeBlockIndex: getCodeBlockIndex(codeBlock)
+				const language = extractCodeLanguage((codeBlock ? codeBlock.tagName === "PRE" ? codeBlock.querySelector("code") : codeBlock.querySelector("code[class*=\"language-\"], code[language]") ?? codeBlock.querySelector("code") : null) ?? codeBlock ?? copyButton);
+				queueEvent(EVENT_CODE_COPIED, {
+					[ATTR_DO11Y_CODE_LANGUAGE]: language,
+					[ATTR_DO11Y_CODE_SECTION]: sanitizeText(getNearestHeading(codeBlock ?? copyButton), 100),
+					[ATTR_DO11Y_CODE_INDEX]: getCodeBlockIndex(codeBlock)
 				});
 			}
 		}, true);
@@ -900,10 +1069,11 @@
 					if (sectionTimers[id] && !sectionTimers[id].reported) {
 						const elapsed = Date.now() - sectionTimers[id].start;
 						if (elapsed >= threshold) {
-							queueEvent("section_visible", {
-								heading: sanitizeText(entry.target.textContent?.trim() ?? "", 100),
-								headingLevel: parseInt(entry.target.tagName.charAt(1), 10),
-								visibleSeconds: Math.round(elapsed / 1e3)
+							const heading = entry.target.textContent?.trim() ?? "";
+							queueEvent(EVENT_SECTION_VISIBLE, {
+								[ATTR_DO11Y_SECTION_HEADING]: sanitizeText(heading, 100),
+								[ATTR_DO11Y_SECTION_HEADING_LEVEL]: parseInt(entry.target.tagName.charAt(1), 10),
+								[ATTR_DO11Y_SECTION_VISIBLE_SECONDS]: Math.round(elapsed / 1e3)
 							});
 							sectionTimers[id].reported = true;
 						}
@@ -932,10 +1102,10 @@
 				if (elapsed >= threshold) {
 					const escapedId = typeof CSS !== "undefined" && typeof CSS.escape === "function" ? CSS.escape(id) : id.replace(/["\\]/g, "\\$&");
 					const el = document.querySelector("[data-do11y-section-id=\"" + escapedId + "\"]");
-					if (el) queueEvent("section_visible", {
-						heading: sanitizeText(el.textContent?.trim() ?? "", 100),
-						headingLevel: parseInt(el.tagName.charAt(1), 10),
-						visibleSeconds: Math.round(elapsed / 1e3)
+					if (el) queueEvent(EVENT_SECTION_VISIBLE, {
+						[ATTR_DO11Y_SECTION_HEADING]: sanitizeText(el.textContent?.trim() ?? "", 100),
+						[ATTR_DO11Y_SECTION_HEADING_LEVEL]: parseInt(el.tagName.charAt(1), 10),
+						[ATTR_DO11Y_SECTION_VISIBLE_SECONDS]: Math.round(elapsed / 1e3)
 					});
 				}
 			}
@@ -953,10 +1123,11 @@
 			if (tab.getAttribute("aria-selected") === "true" || tab.classList.contains("active") || tab.classList.contains("is-active")) return;
 			const label = sanitizeText(tab.textContent, 50);
 			if (!label) return;
-			queueEvent("tab_switch", {
-				tabLabel: label,
-				tabGroup: sanitizeText(getNearestHeading(tab), 100),
-				isDefault: false
+			const section = sanitizeText(getNearestHeading(tab), 100);
+			queueEvent(EVENT_TAB_SWITCH, {
+				[ATTR_DO11Y_TAB_LABEL]: label,
+				[ATTR_DO11Y_TAB_GROUP]: section,
+				[ATTR_DO11Y_TAB_IS_DEFAULT]: false
 			});
 		});
 	}
@@ -983,10 +1154,10 @@
 				tocPosition = i + 1;
 				break;
 			}
-			queueEvent("toc_click", {
-				heading: headingText,
-				headingLevel,
-				tocPosition
+			queueEvent(EVENT_TOC_CLICK, {
+				[ATTR_DO11Y_TOC_HEADING]: headingText,
+				[ATTR_DO11Y_TOC_HEADING_LEVEL]: headingLevel,
+				[ATTR_DO11Y_TOC_POSITION]: tocPosition
 			});
 		}, true);
 	}
@@ -1006,7 +1177,7 @@
 			else if (/\byes\b|👍|thumbs.?up|helpful/i.test(buttonText + " " + ariaLabel + " " + titleAttr)) rating = "yes";
 			else if (/\bno\b|👎|thumbs.?down|not.?helpful/i.test(buttonText + " " + ariaLabel + " " + titleAttr)) rating = "no";
 			if (!rating) return;
-			queueEvent("feedback", { rating });
+			queueEvent(EVENT_FEEDBACK, { [ATTR_DO11Y_FEEDBACK_RATING]: rating });
 		});
 	}
 	function setupExpandCollapseTracking() {
@@ -1015,10 +1186,11 @@
 			const details = e.target;
 			if (details.tagName !== "DETAILS") return;
 			const summary = details.querySelector("summary");
-			queueEvent("expand_collapse", {
-				summary: sanitizeText(summary ? summary.textContent : "", 100),
-				action: details.open ? "expand" : "collapse",
-				section: sanitizeText(getNearestHeading(details), 100)
+			const label = sanitizeText(summary ? summary.textContent : "", 100);
+			queueEvent(EVENT_EXPAND_COLLAPSE, {
+				[ATTR_DO11Y_EXPAND_SUMMARY]: label,
+				[ATTR_DO11Y_EXPAND_ACTION]: details.open ? "expand" : "collapse",
+				[ATTR_DO11Y_EXPAND_SECTION]: sanitizeText(getNearestHeading(details), 100)
 			});
 		}, true);
 		document.addEventListener("click", (e) => {
@@ -1027,10 +1199,10 @@
 			if (trigger.closest("details")) return;
 			if (trigger.closest("nav, [role=\"navigation\"], header")) return;
 			const wasExpanded = trigger.getAttribute("aria-expanded") === "true";
-			queueEvent("expand_collapse", {
-				summary: sanitizeText(trigger.textContent, 100),
-				action: wasExpanded ? "collapse" : "expand",
-				section: sanitizeText(getNearestHeading(trigger), 100)
+			queueEvent(EVENT_EXPAND_COLLAPSE, {
+				[ATTR_DO11Y_EXPAND_SUMMARY]: sanitizeText(trigger.textContent, 100),
+				[ATTR_DO11Y_EXPAND_ACTION]: wasExpanded ? "collapse" : "expand",
+				[ATTR_DO11Y_EXPAND_SECTION]: sanitizeText(getNearestHeading(trigger), 100)
 			});
 		});
 	}
@@ -1042,7 +1214,7 @@
 		const metaDestination = document.querySelector("meta[name=\"do11y-destination\"]");
 		if (metaDestination) {
 			const dest = metaDestination.getAttribute("content");
-			if (dest === "supabase" || dest === "http") config.destination = dest;
+			if (dest === "supabase" || dest === "http" || dest === "otlp") config.destination = dest;
 		}
 		const metaUrl = document.querySelector("meta[name=\"do11y-url\"]");
 		if (metaUrl) config.supabaseUrl = metaUrl.getAttribute("content") ?? config.supabaseUrl;
@@ -1050,8 +1222,15 @@
 		if (metaKey) config.supabaseKey = metaKey.getAttribute("content") ?? config.supabaseKey;
 		const metaTable = document.querySelector("meta[name=\"do11y-table\"]");
 		if (metaTable) config.supabaseTable = metaTable.getAttribute("content") ?? config.supabaseTable;
-		const metaHttpEndpoint = document.querySelector("meta[name=\"do11y-http-endpoint\"]");
-		if (metaHttpEndpoint) config.httpEndpoint = metaHttpEndpoint.getAttribute("content") ?? config.httpEndpoint;
+		const metaEndpoint = document.querySelector("meta[name=\"do11y-endpoint\"]");
+		if (metaEndpoint) config.endpoint = metaEndpoint.getAttribute("content") ?? config.endpoint;
+		const metaOtlpEndpoint = document.querySelector("meta[name=\"do11y-otlp-endpoint\"]");
+		if (metaOtlpEndpoint) config.otelSdkEndpoint = metaOtlpEndpoint.getAttribute("content") ?? config.otelSdkEndpoint;
+		const metaOtlpHeaders = document.querySelector("meta[name=\"do11y-otlp-headers\"]");
+		if (metaOtlpHeaders) try {
+			const parsed = JSON.parse(metaOtlpHeaders.getAttribute("content") ?? "{}");
+			if (typeof parsed === "object" && parsed !== null) config.otelSdkHeaders = parsed;
+		} catch {}
 		const metaDebug = document.querySelector("meta[name=\"do11y-debug\"]");
 		if (metaDebug && metaDebug.getAttribute("content") === "true") config.debug = true;
 		const metaDomains = document.querySelector("meta[name=\"do11y-domains\"]");
@@ -1061,23 +1240,30 @@
 		}
 		const metaFramework = document.querySelector("meta[name=\"do11y-framework\"]");
 		if (metaFramework) config.framework = metaFramework.getAttribute("content") ?? config.framework;
+		const metaUseOtelInstrumentations = document.querySelector("meta[name=\"do11y-use-otel-instrumentations\"]");
+		if (metaUseOtelInstrumentations && metaUseOtelInstrumentations.getAttribute("content") === "true") config.useOtelBrowserInstrumentations = true;
 		applyFrameworkSelectors();
-		if (config.debug) console.log("[Do11y] Initializing with config:", {
-			destination: config.destination,
-			hasCredentials: config.destination === "supabase" ? !!config.supabaseKey : !!config.httpEndpoint,
-			framework: config.framework,
-			allowedDomains: config.allowedDomains,
-			respectDNT: config.respectDNT
-		});
+		if (config.debug) {
+			const hasCreds = config.destination === "supabase" ? !!config.supabaseKey : config.destination === "otlp" ? !!config.otelSdkEndpoint : !!config.endpoint;
+			console.log("[Do11y] Initializing with config:", {
+				destination: config.destination,
+				hasCredentials: hasCreds,
+				framework: config.framework,
+				allowedDomains: config.allowedDomains,
+				respectDNT: config.respectDNT
+			});
+		}
 		if (shouldDisableTracking()) {
 			isDisabled = true;
 			if (config.debug) console.log("[Do11y] Tracking disabled");
 			return;
 		}
-		if (!(config.destination === "supabase" ? !!config.supabaseKey : !!config.httpEndpoint)) {
+		if (!(config.destination === "supabase" ? !!config.supabaseKey : config.destination === "otlp" ? !!config.otelSdkEndpoint : !!config.endpoint)) {
 			if (config.debug) {
 				console.warn("[Do11y] No destination configured. Events will not be sent.");
-				console.warn("[Do11y] Add <meta name=\"do11y-url\"> and <meta name=\"do11y-key\"> to enable.");
+				if (config.destination === "supabase") console.warn("[Do11y] Add <meta name=\"do11y-url\"> and <meta name=\"do11y-key\"> to enable.");
+				else if (config.destination === "otlp") console.warn("[Do11y] Add <meta name=\"do11y-otlp-endpoint\"> to enable.");
+				else console.warn("[Do11y] Add <meta name=\"do11y-endpoint\"> to enable.");
 			}
 		}
 		trackPageView();
@@ -1143,18 +1329,23 @@
 		}
 		flushSync();
 	}
-	if (!_alreadyLoaded) if (document.readyState === "loading") document.addEventListener("DOMContentLoaded", init);
+	if (!_alreadyLoaded && !_isInIframe) if (document.readyState === "loading") document.addEventListener("DOMContentLoaded", init);
 	else init();
 	window.Do11y = window.Do11y ?? {
 		getConfig: () => ({
 			destination: config.destination,
-			hasCredentials: config.destination === "supabase" ? !!config.supabaseKey : !!config.httpEndpoint,
+			hasCredentials: config.destination === "supabase" ? !!config.supabaseKey : config.destination === "otlp" ? !!config.otelSdkEndpoint : !!config.endpoint,
 			isDisabled,
 			allowedDomains: config.allowedDomains,
 			respectDNT: config.respectDNT
 		}),
 		flush,
-		isEnabled: () => !isDisabled && (config.destination === "supabase" ? !!config.supabaseKey : !!config.httpEndpoint),
+		isEnabled: () => {
+			if (isDisabled) return false;
+			if (config.destination === "supabase") return !!config.supabaseKey;
+			if (config.destination === "otlp") return !!config.otelSdkEndpoint;
+			return !!config.endpoint;
+		},
 		getQueueSize: () => eventQueue.length,
 		version: VERSION
 	};

package/dist/do11y.min.js

@@ -1 +1 @@
-(function(){let e=`0.0.4`,t=!!window.__do11yInitialized;window.__do11yInitialized=!0;let n={destination:`supabase`,supabaseUrl:``,supabaseKey:``,supabaseTable:`do11y_events`,httpEndpoint:``,httpHeaders:{},debug:!1,flushInterval:5e3,maxBatchSize:10,trackOutboundLinks:!0,trackInternalLinks:!0,trackScrollDepth:!0,scrollThresholds:[25,50,75,90],allowedDomains:null,respectDNT:!0,maxRetries:2,retryDelay:1e3,rateLimitMs:100,framework:`mintlify`,trackSectionVisibility:!0,sectionVisibleThreshold:3,trackTabSwitches:!0,trackTocClicks:!0,trackExpandCollapse:!0,trackFeedback:!0,tabContainerSelector:null,tocSelector:null,feedbackSelector:null,searchSelector:null,copyButtonSelector:null,codeBlockSelector:null,navigationSelector:null,footerSelector:null,contentSelector:null},r={mintlify:{searchSelector:`#search-bar-entry, #search-bar-entry-mobile, [class*="search"]`,copyButtonSelector:`button[class*="copy"], button[aria-label*="copy" i]`,codeBlockSelector:`pre, [class*="code"]`,navigationSelector:`nav, [role="navigation"], #navbar, #sidebar, [class*="nav"], [class*="sidebar"]`,footerSelector:`footer, [role="contentinfo"], [class*="footer"]`,contentSelector:`main, article, [role="main"], [class*="content"]`,tabContainerSelector:`[role="tablist"], [class*="tab"]`,tocSelector:`#table-of-contents, [data-testid="table-of-contents"], [class*="table-of-contents"], [class*="toc"]`,feedbackSelector:`[class*="feedback"], [class*="helpful"]`},docusaurus:{searchSelector:`.DocSearch, .DocSearch-Button`,copyButtonSelector:`button.clean-btn[aria-label*="copy" i], button[class*="copyButton"]`,codeBlockSelector:`pre, [class*="code"]`,navigationSelector:`nav, [role="navigation"], .navbar, .sidebar, [class*="nav"], [class*="sidebar"]`,footerSelector:`footer, [role="contentinfo"], [class*="footer"]`,contentSelector:`main, article, [role="main"], [class*="content"]`,tabContainerSelector:`.tabs[role="tablist"], [class*="tabs"]`,tocSelector:`.table-of-contents, [class*="toc"]`,feedbackSelector:`[class*="feedback"], [class*="helpful"]`},nextra:{searchSelector:`.nextra-search input, input[placeholder*="search" i], button[aria-label*="search" i]`,copyButtonSelector:`button[class*="copy"], button[aria-label*="copy" i], button[title*="copy" i]`,codeBlockSelector:`pre, [class*="code"]`,navigationSelector:`nav, [role="navigation"], [class*="nav"], [class*="sidebar"]`,footerSelector:`footer, [role="contentinfo"], [class*="footer"]`,contentSelector:`main, article, [role="main"], [class*="content"]`,tabContainerSelector:`[role="tablist"], [class*="tab"]`,tocSelector:`.nextra-toc, [class*="toc"]`,feedbackSelector:`[class*="feedback"], [class*="helpful"]`},"mkdocs-material":{searchSelector:`.md-search__input`,copyButtonSelector:`.md-clipboard, .md-code__button[title="Copy to clipboard"]`,codeBlockSelector:`pre, code, [class*="code"]`,navigationSelector:`nav, [role="navigation"], .md-nav, .md-sidebar`,footerSelector:`footer, [role="contentinfo"], .md-footer`,contentSelector:`main, article, [role="main"], .md-content`,tabContainerSelector:`.tabbed-labels, .md-typeset .tabbed-set`,tocSelector:`.md-sidebar--secondary .md-nav, [class*="toc"]`,feedbackSelector:`[class*="feedback"], [class*="helpful"]`},vitepress:{searchSelector:`.VPNavBarSearch button, .VPNavBarSearchButton, #local-search`,copyButtonSelector:`button.copy, .vp-code-copy, button.copy[title*="Copy"]`,codeBlockSelector:`div[class*="language-"], pre, [class*="code"]`,navigationSelector:`nav, [role="navigation"], .VPNav, .VPSidebar, [class*="nav"], [class*="sidebar"]`,footerSelector:`footer, [role="contentinfo"], .VPFooter, [class*="footer"]`,contentSelector:`main, article, [role="main"], .VPContent, [class*="content"]`,tabContainerSelector:`.vp-code-group .tabs, [role="tablist"]`,tocSelector:`.VPDocAsideOutline, .VPLocalNavOutlineDropdown, a.outline-link`,feedbackSelector:`[class*="feedback"], [class*="helpful"]`},starlight:{searchSelector:`site-search button[data-open-modal], sl-doc-search .DocSearch-Button, button[aria-label*="search" i]`,copyButtonSelector:`.expressive-code .copy button, .copy button[data-code]`,codeBlockSelector:`.expressive-code pre, pre`,navigationSelector:`nav, [role="navigation"], [class*="sidebar"]`,footerSelector:`footer, [role="contentinfo"], [class*="footer"]`,contentSelector:`main, .sl-markdown-content, [role="main"]`,tabContainerSelector:`starlight-tabs [role="tablist"], [role="tablist"]`,tocSelector:`.right-sidebar-panel, starlight-toc, mobile-starlight-toc`,feedbackSelector:`[class*="feedback"], [class*="helpful"]`}},i=[`searchSelector`,`copyButtonSelector`,`codeBlockSelector`,`navigationSelector`,`footerSelector`,`contentSelector`,`tabContainerSelector`,`tocSelector`,`feedbackSelector`];function a(){let e=r[n.framework];e?i.forEach(t=>{n[t]||(n[t]=e[t])}):n.framework!==`custom`&&n.debug&&console.warn(`[Do11y] Unknown framework "${n.framework}". Falling back to generic selectors. Supported: `+Object.keys(r).join(`, `)+`, custom`);let t=r.mintlify;t&&i.forEach(e=>{n[e]||(n[e]=t[e])})}function o(){if(n.respectDNT&&(navigator.doNotTrack===`1`||navigator.doNotTrack===`yes`||window.doNotTrack===`1`))return n.debug&&console.log(`[Do11y] Disabled: Do Not Track is enabled`),!0;if(n.allowedDomains&&n.allowedDomains.length>0){let e=window.location.hostname;if(!n.allowedDomains.some(t=>e===t||e.endsWith(`.`+t)))return n.debug&&console.log(`[Do11y] Disabled: Domain not allowed:`,e),!0}return!1}function s(e){if(!e||typeof e!=`string`)return null;try{return document.querySelector(e),e}catch{return n.debug&&console.warn(`[Do11y] Invalid CSS selector rejected:`,e),null}}let c=[`/pixel/`];function l(e){let t=e??window.location.pathname;return c.some(e=>t.startsWith(e))}function u(e){if(typeof e.className==`string`)return e.className;let t=e.className;return t&&typeof t.baseVal==`string`?t.baseVal:``}function d(e){let t=e.match(/(?:^|\s)language-([\w-]+)(?:\s|$)/);return t?t[1]:null}function f(e){if(!e)return`unknown`;let t=e;for(let e=0;t&&e<12;e++,t=t.parentElement){for(let e of[`language`,`data-language`,`data-lang`,`data-code-lang`]){let n=t.getAttribute(e);if(n)return n}let e=d(u(t));if(e)return e;let n=t.querySelector(`:scope > span.lang`)?.textContent?.trim();if(n)return n;let r=t.querySelector(`[data-language], [data-lang], [data-code-lang], [class*="language-"], [language]`);if(r){let e=r.getAttribute(`language`)??r.getAttribute(`data-language`)??r.getAttribute(`data-lang`)??r.getAttribute(`data-code-lang`)??d(u(r));if(e)return e}}return`unknown`}function ee(e){if(e.startsWith(`#`))return e;let t=e.indexOf(`#`);if(t===-1)return null;let n=e.slice(0,t);return!n||n===window.location.pathname||n===`${window.location.pathname}${window.location.search}`?e.slice(t):null}function te(e){let t=s(n.tocSelector)??`.table-of-contents, .VPDocAsideOutline, .VPLocalNavOutlineDropdown, [class*="toc"], [class*="TableOfContents"], [class*="page-outline"], .right-sidebar-panel, starlight-toc`,r=e.closest(t);return r?((r===e||r.tagName===`A`)&&(r=e.closest(`.VPDocAsideOutline, .VPLocalNavOutlineDropdown, nav, aside, .right-sidebar-panel, starlight-toc`)??r.parentElement),r):null}function p(e,t){if(!e||typeof e!=`string`)return null;let n=t??100,r=e;return r=r.replace(/[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}/g,`[email]`),r=r.replace(/\b\d{3}[-.]?\d{3}[-.]?\d{4}\b/g,`[phone]`),r=r.replace(/\b\d{3}-\d{2}-\d{4}\b/g,`[redacted]`),r=r.replace(/\b(?:\d[ -]?){13,19}\b/g,`[card]`),r=r.replace(/eyJ[A-Za-z0-9_-]+\.eyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+/g,`[token]`),r=r.replace(/\bxa[a-z]{2}-[A-Za-z0-9_-]{20,}/g,`[token]`),r=r.replace(/\b[0-9a-fA-F]{32,}\b/g,`[redacted]`),r.trim().substring(0,n)}function m(){if(window.crypto&&typeof window.crypto.randomUUID==`function`)return window.crypto.randomUUID();if(window.crypto&&typeof window.crypto.getRandomValues==`function`){let e=new Uint8Array(16);window.crypto.getRandomValues(e),e[6]=e[6]&15|64,e[8]=e[8]&63|128;let t=Array.from(e,e=>e.toString(16).padStart(2,`0`)).join(``);return t.slice(0,8)+`-`+t.slice(8,12)+`-`+t.slice(12,16)+`-`+t.slice(16,20)+`-`+t.slice(20)}return`no-crypto-00-0000-0000-000000000000`}function ne(e){if(!e||typeof e!=`object`)return!1;let t=e;return typeof t.id==`string`&&t.id.length>0&&typeof t.startTime==`string`&&Array.isArray(t.pageSequence)&&typeof t.pageCount==`number`}function h(){let e=null;try{let t=sessionStorage.getItem(`do11y_session`);if(t){let n=JSON.parse(t);ne(n)&&(e=n)}}catch{}return e||(e={id:m(),startTime:new Date().toISOString(),pageSequence:[],pageCount:0,referrerCategory:null,aiPlatform:null},g(e)),e}function g(e){try{sessionStorage.setItem(`do11y_session`,JSON.stringify(e))}catch{}}function re(e){let t=h();return t.pageCount++,t.pageSequence.push({path:e,timestamp:new Date().toISOString(),index:t.pageCount}),t.pageSequence.length>50&&(t.pageSequence=t.pageSequence.slice(-50)),g(t),t}function ie(){return{viewportCategory:ae(),browserFamily:_(),deviceType:v(),language:(navigator.language||``).split(`-`)[0]||`unknown`,timezoneOffset:new Date().getTimezoneOffset()/60}}function ae(){let e=window.innerWidth;return e<640?`mobile`:e<1024?`tablet`:e<1440?`desktop`:`large-desktop`}function _(){let e=navigator.userAgent;return e.includes(`Firefox`)?`Firefox`:e.includes(`Edg`)?`Edge`:e.includes(`Chrome`)?`Chrome`:e.includes(`Safari`)?`Safari`:`Other`}function v(){let e=navigator.userAgent;return/Mobile|Android|iPhone|iPad/.test(e)?/iPad|Tablet/.test(e)?`tablet`:`mobile`:`desktop`}let y=[{match:`chatgpt`,platform:`ChatGPT`},{match:`chat.com`,platform:`ChatGPT`},{match:`openai`,platform:`ChatGPT`},{match:`perplexity`,platform:`Perplexity`},{match:`claude.ai`,platform:`Claude`},{match:`anthropic`,platform:`Claude`},{match:`gemini`,platform:`Gemini`},{match:`copilot`,platform:`Copilot`},{match:`deepseek`,platform:`DeepSeek`},{match:`meta.ai`,platform:`Meta AI`},{match:`grok`,platform:`Grok`},{match:`x.ai`,platform:`Grok`},{match:`mistral`,platform:`Mistral`},{match:`you.com`,platform:`You.com`},{match:`phind`,platform:`Phind`}];function b(e){if(!e||e===`direct`)return{referrerCategory:`direct`,aiPlatform:null};if(e===`internal`)return{referrerCategory:`internal`,aiPlatform:null};if(e===`unknown`)return{referrerCategory:`unknown`,aiPlatform:null};let t=e.toLowerCase();for(let e of y)if(t.indexOf(e.match)!==-1)return{referrerCategory:`ai`,aiPlatform:e.platform};return/google\.|bing\.|baidu\.|yandex\.|duckduckgo\.|yahoo\./.test(t)?{referrerCategory:`search-engine`,aiPlatform:null}:/github\.|gitlab\.|bitbucket\./.test(t)?{referrerCategory:`code-host`,aiPlatform:null}:/stackoverflow\.|stackexchange\.|reddit\.|news\.ycombinator\./.test(t)?{referrerCategory:`community`,aiPlatform:null}:/twitter\.|x\.com|linkedin\.|facebook\.|threads\.net/.test(t)?{referrerCategory:`social`,aiPlatform:null}:{referrerCategory:`other`,aiPlatform:null}}function x(){try{if(!document.referrer)return`direct`;let e=new URL(document.referrer);return e.hostname===window.location.hostname?`internal`:e.hostname}catch{return`unknown`}}function S(){return{path:window.location.pathname,hash:window.location.hash||null,search:window.location.search?`has_params`:null,title:p(document.title,150)}}let C=[],w=null,T={},E=!1;function D(t,r){if(E)return;let i=Date.now();if(n.rateLimitMs>0&&T[t]&&i-T[t]<n.rateLimitMs){n.debug&&console.log(`[Do11y] Rate limited:`,t);return}T[t]=i;let a=h(),o={_time:new Date().toISOString(),eventType:t,do11y_version:e,sessionId:a.id,sessionPageCount:a.pageCount,...S(),...ie(),...r};n.debug&&console.log(`[Do11y] Event queued:`,o),C.push(o),C.length>100&&(C=C.slice(-100),n.debug&&console.warn(`[Do11y] Event queue capped at 100 events`)),C.length>=n.maxBatchSize?A():oe()}function oe(){w||=setTimeout(A,n.flushInterval)}function se(e){try{let t=new URL(e);return!(t.protocol!==`https:`||!t.hostname.endsWith(`.supabase.co`))}catch{return!1}}function ce(e){try{let t=new URL(e);if(t.protocol!==`https:`)return!1;let n=t.hostname;return!(n===`localhost`||n===`127.0.0.1`||n===`::1`||/^(10\.|172\.(1[6-9]|2\d|3[01])\.|192\.168\.)/.test(n))}catch{return!1}}function O(){return n.destination===`supabase`?n.supabaseUrl?se(n.supabaseUrl)?!n.supabaseKey||typeof n.supabaseKey!=`string`||n.supabaseKey.length<10?(n.debug&&console.warn(`[Do11y] Invalid or missing Supabase publishable key`),!1):/^[a-zA-Z0-9_-]+$/.test(n.supabaseTable)?!0:(n.debug&&console.warn(`[Do11y] Invalid table name`),!1):(n.debug&&console.warn(`[Do11y] Invalid Supabase URL. Must be https://<project>.supabase.co`),!1):(n.debug&&console.warn(`[Do11y] No Supabase URL configured`),!1):n.destination===`http`?n.httpEndpoint?ce(n.httpEndpoint)?!0:(n.debug&&console.warn(`[Do11y] Invalid HTTP endpoint. Must be HTTPS and not a private address.`),!1):(n.debug&&console.warn(`[Do11y] No HTTP endpoint configured`),!1):(n.debug&&console.warn(`[Do11y] Unknown destination:`,n.destination),!1)}function k(e){return n.destination===`supabase`?{url:n.supabaseUrl.replace(/\/$/,``)+`/rest/v1/`+n.supabaseTable,headers:{apikey:n.supabaseKey,Authorization:`Bearer `+n.supabaseKey,"Content-Type":`application/json`,Prefer:`return=minimal`},body:JSON.stringify(e.map(e=>({payload:e})))}:{url:n.httpEndpoint,headers:{"Content-Type":`application/json`,...n.httpHeaders},body:JSON.stringify(e)}}function A(e){if(w&&=(clearTimeout(w),null),C.length===0||!O())return;let t=typeof e==`number`?e:n.maxRetries,r=C.slice();C=[],le(k(r),r,t)}function le(e,t,r){fetch(e.url,{method:`POST`,headers:e.headers,body:e.body,keepalive:!0}).then(e=>{if(e.ok){n.debug&&console.log(`[Do11y] Flushed`,t.length,`events`);return}if(r>0&&(e.status>=500||e.status===429)){n.debug&&console.log(`[Do11y] Retrying after error:`,e.status),C=t.concat(C),setTimeout(()=>{A(r-1)},n.retryDelay*(n.maxRetries-r+1));return}n.debug&&e.text().then(t=>{console.error(`[Do11y] Ingest failed:`,e.status,t)}).catch(()=>{})}).catch(e=>{r>0?(n.debug&&console.log(`[Do11y] Network error, retrying:`,e.message),C=t.concat(C),setTimeout(()=>{A(r-1)},n.retryDelay*(n.maxRetries-r+1))):n.debug&&console.error(`[Do11y] Failed to send events:`,e)})}function j(){if(C.length===0||!O())return;let e=C;C=[];let t=k(e);try{fetch(t.url,{method:`POST`,headers:t.headers,body:t.body,keepalive:!0})}catch{}n.debug&&console.log(`[Do11y] Sync flushed`,e.length,`events`)}function M(){let e=re(window.location.pathname),t=x(),n=b(t);e.pageCount===1&&(e.referrerCategory=n.referrerCategory,e.aiPlatform=n.aiPlatform,g(e)),D(`page_view`,{referrerDomain:t,referrerCategory:n.referrerCategory,aiPlatform:n.aiPlatform,isFirstPage:e.pageCount===1,previousPath:e.pageSequence.length>1?e.pageSequence[e.pageSequence.length-2].path:null})}function N(){document.addEventListener(`click`,e=>{let t=e.target.closest(`a`);if(!t)return;let r=t.getAttribute(`href`);if(!r)return;let i=`other`,a=null;try{if(r.startsWith(`#`))i=`anchor`;else if(r.startsWith(`/`)||r.startsWith(`./`)||r.startsWith(`../`))i=`internal`;else if(r.startsWith(`http`)){let e=new URL(r);e.hostname===window.location.hostname?i=`internal`:(i=`external`,a=e.hostname)}else r.startsWith(`mailto:`)&&(i=`email`)}catch{}i===`internal`&&!n.trackInternalLinks||i===`external`&&!n.trackOutboundLinks||(D(`link_click`,{linkType:i,targetUrl:r,targetDomain:a,linkText:p(t.textContent,100),linkContext:P(t),linkSection:p(F(t),100),linkIndex:I(t,r)}),A())},!0)}function P(e){return e.closest(n.navigationSelector)?`navigation`:e.closest(n.footerSelector)?`footer`:e.closest(n.contentSelector)?`content`:`other`}function F(e){let t=e;for(;t&&t!==document.body;){let e=t.previousElementSibling;for(;e;){if(/^H[1-6]$/.test(e.tagName))return e.textContent?.trim().substring(0,100)??null;let t=e.querySelectorAll(`h1, h2, h3, h4, h5, h6`);if(t.length>0)return t[t.length-1].textContent?.trim().substring(0,100)??null;e=e.previousElementSibling}t=t.parentElement}return null}function I(e,t){if(typeof CSS>`u`||typeof CSS.escape!=`function`)return 1;try{let n=document.querySelectorAll(`a[href="`+CSS.escape(t)+`"]`);for(let t=0;t<n.length;t++)if(n[t]===e)return t+1}catch{}return 1}let L=new Set,R=null;function z(e){let t=e;for(;t&&t!==document.body&&t!==document.documentElement;){let e=window.getComputedStyle(t).overflowY;if((e===`auto`||e===`scroll`)&&t.scrollHeight>t.clientHeight)return t;t=t.parentElement}return null}function B(){if(!n.trackScrollDepth)return;if(n.contentSelector){let e=document.querySelector(n.contentSelector);e&&(R=z(e))}let e=!1;function t(){e||=(window.requestAnimationFrame(()=>{V(),e=!1}),!0)}if(window.addEventListener(`scroll`,t),R&&(R.addEventListener(`scroll`,t),n.debug)){let e=R;console.log(`[do11y] Using container-based scroll tracking:`,e.className||e.tagName)}V()}function V(){if(l())return;let e,t,r;R&&R.scrollHeight>R.clientHeight?(e=R.scrollTop,t=R.scrollHeight,r=R.clientHeight):(e=window.scrollY||document.documentElement.scrollTop,t=document.documentElement.scrollHeight,r=window.innerHeight);let i=t-r;if(i<=0){n.scrollThresholds.forEach(e=>{L.has(e)||(L.add(e),D(`scroll_depth`,{threshold:e,scrollPercent:100}))});return}let a=Math.round(e/i*100);n.scrollThresholds.forEach(e=>{a>=e&&!L.has(e)&&(L.add(e),D(`scroll_depth`,{threshold:e,scrollPercent:a}))})}let H=Date.now(),U=Date.now(),W=0,G=!0;function K(){if(l())return;G&&(W+=Date.now()-U);let e=Date.now()-H,t=e>0?W/e:0,n=0;L.forEach(e=>{e>n&&(n=e)}),X();let r=h();D(`page_exit`,{totalTimeSeconds:Math.round(e/1e3),activeTimeSeconds:Math.round(W/1e3),engagementRatio:Math.round(t*100)/100,maxScrollDepth:n,referrerCategory:r.referrerCategory,aiPlatform:r.aiPlatform})}function ue(){document.addEventListener(`visibilitychange`,()=>{document.hidden?G&&=(W+=Date.now()-U,!1):(U=Date.now(),G=!0)}),window.addEventListener(`beforeunload`,()=>{K(),ve()})}function de(){document.addEventListener(`click`,e=>{e.target.closest(n.searchSelector)&&D(`search_opened`,{})},!0),document.addEventListener(`keydown`,e=>{(e.metaKey||e.ctrlKey)&&e.key===`k`&&D(`search_opened`,{trigger:`keyboard`})})}function fe(e){if(!e)return 1;try{let t=document.querySelectorAll(n.codeBlockSelector);for(let n=0;n<t.length;n++)if(t[n]===e)return n+1}catch{}return 1}function pe(){document.addEventListener(`click`,e=>{let t=e.target.closest(n.copyButtonSelector);if(t){let e=t.closest(`[class*="language-"], [language]`)??t.closest(n.codeBlockSelector)??t.closest(`.expressive-code`)?.querySelector(`pre`)??t.closest(`div, section`)?.querySelector(`pre`)??t.parentElement?.querySelector(`pre`)??null;D(`code_copied`,{language:f((e?e.tagName===`PRE`?e.querySelector(`code`):e.querySelector(`code[class*="language-"], code[language]`)??e.querySelector(`code`):null)??e??t),codeSection:p(F(e??t),100),codeBlockIndex:fe(e)})}},!0)}let q=null,J={};function me(){if(!n.trackSectionVisibility||typeof IntersectionObserver>`u`)return;let e=n.sectionVisibleThreshold*1e3;q=new IntersectionObserver(t=>{t.forEach(t=>{let n=t.target.getAttribute(`data-do11y-section-id`);if(n)if(t.isIntersecting)J[n]||(J[n]={start:Date.now(),reported:!1});else{if(J[n]&&!J[n].reported){let r=Date.now()-J[n].start;r>=e&&(D(`section_visible`,{heading:p(t.target.textContent?.trim()??``,100),headingLevel:parseInt(t.target.tagName.charAt(1),10),visibleSeconds:Math.round(r/1e3)}),J[n].reported=!0)}delete J[n]}})},{threshold:.5}),Y()}function Y(){q&&document.querySelectorAll(`h2, h3`).forEach((e,t)=>{e.setAttribute(`data-do11y-section-id`,`section-`+t),q.observe(e)})}function X(){if(!q)return;let e=Date.now(),t=n.sectionVisibleThreshold*1e3;Object.keys(J).forEach(n=>{let r=J[n];if(r&&!r.reported){let i=e-r.start;if(i>=t){let e=typeof CSS<`u`&&typeof CSS.escape==`function`?CSS.escape(n):n.replace(/["\\]/g,`\\$&`),t=document.querySelector(`[data-do11y-section-id="`+e+`"]`);t&&D(`section_visible`,{heading:p(t.textContent?.trim()??``,100),headingLevel:parseInt(t.tagName.charAt(1),10),visibleSeconds:Math.round(i/1e3)})}}}),J={}}function he(){n.trackTabSwitches&&document.addEventListener(`click`,e=>{let t=`[role="tab"], .tabs button, .tabs a, .tabbed-labels label`,r=s(n.tabContainerSelector);r&&(t+=`, `+r+` button, `+r+` a, `+r+` label`);let i=e.target.closest(t);if(!i||i.getAttribute(`aria-selected`)===`true`||i.classList.contains(`active`)||i.classList.contains(`is-active`))return;let a=p(i.textContent,50);a&&D(`tab_switch`,{tabLabel:a,tabGroup:p(F(i),100),isDefault:!1})})}function Z(){n.trackTocClicks&&document.addEventListener(`click`,e=>{let t=e.target.closest(`a`);if(!t)return;let n=te(t);if(!n)return;let r=t.getAttribute(`href`),i=r?ee(r):null;if(!i)return;let a=p(t.textContent,100),o=null;try{let e=i.slice(1),t=document.getElementById(e);t&&/^H[1-6]$/.test(t.tagName)&&(o=parseInt(t.tagName.charAt(1),10))}catch{}let s=n.querySelectorAll(`a[href*="#"]`),c=1;for(let e=0;e<s.length;e++)if(s[e]===t){c=e+1;break}D(`toc_click`,{heading:a,headingLevel:o,tocPosition:c})},!0)}function ge(){n.trackFeedback&&document.addEventListener(`click`,e=>{let t=e.target.closest(`button, [role="button"], a`);if(!t||!t.closest(s(n.feedbackSelector)??`[class*="feedback"], [class*="helpful"], [class*="rating"], [class*="was-this"], [data-feedback]`))return;let r=(t.textContent??``).trim().toLowerCase(),i=(t.getAttribute(`aria-label`)??``).toLowerCase(),a=(t.getAttribute(`title`)??``).toLowerCase(),o=t.getAttribute(`data-value`)??t.getAttribute(`data-md-value`)??t.getAttribute(`data-feedback`),c=o&&/^[\w\s.,!?-]{1,50}$/.test(o)?o:null,l=null;c?l=c:/\byes\b|👍|thumbs.?up|helpful/i.test(r+` `+i+` `+a)?l=`yes`:/\bno\b|👎|thumbs.?down|not.?helpful/i.test(r+` `+i+` `+a)&&(l=`no`),l&&D(`feedback`,{rating:l})})}function _e(){n.trackExpandCollapse&&(document.addEventListener(`toggle`,e=>{let t=e.target;if(t.tagName!==`DETAILS`)return;let n=t.querySelector(`summary`);D(`expand_collapse`,{summary:p(n?n.textContent:``,100),action:t.open?`expand`:`collapse`,section:p(F(t),100)})},!0),document.addEventListener(`click`,e=>{let t=e.target.closest(`[aria-expanded], [class*="accordion"] button, [class*="collapsible"] button`);if(!t||t.closest(`details`)||t.closest(`nav, [role="navigation"], header`))return;let n=t.getAttribute(`aria-expanded`)===`true`;D(`expand_collapse`,{summary:p(t.textContent,100),action:n?`collapse`:`expand`,section:p(F(t),100)})}))}let Q=null;function $(){if(window.Do11yConfig&&typeof window.Do11yConfig==`object`)for(let e in window.Do11yConfig)Object.prototype.hasOwnProperty.call(window.Do11yConfig,e)&&Object.prototype.hasOwnProperty.call(n,e)&&(n[e]=window.Do11yConfig[e]);let e=document.querySelector(`meta[name="do11y-destination"]`);if(e){let t=e.getAttribute(`content`);(t===`supabase`||t===`http`)&&(n.destination=t)}let t=document.querySelector(`meta[name="do11y-url"]`);t&&(n.supabaseUrl=t.getAttribute(`content`)??n.supabaseUrl);let r=document.querySelector(`meta[name="do11y-key"]`);r&&(n.supabaseKey=r.getAttribute(`content`)??n.supabaseKey);let i=document.querySelector(`meta[name="do11y-table"]`);i&&(n.supabaseTable=i.getAttribute(`content`)??n.supabaseTable);let s=document.querySelector(`meta[name="do11y-http-endpoint"]`);s&&(n.httpEndpoint=s.getAttribute(`content`)??n.httpEndpoint);let c=document.querySelector(`meta[name="do11y-debug"]`);c&&c.getAttribute(`content`)===`true`&&(n.debug=!0);let l=document.querySelector(`meta[name="do11y-domains"]`);if(l){let e=l.getAttribute(`content`);e&&(n.allowedDomains=e.split(`,`).map(e=>e.trim()))}let u=document.querySelector(`meta[name="do11y-framework"]`);if(u&&(n.framework=u.getAttribute(`content`)??n.framework),a(),n.debug&&console.log(`[Do11y] Initializing with config:`,{destination:n.destination,hasCredentials:n.destination===`supabase`?!!n.supabaseKey:!!n.httpEndpoint,framework:n.framework,allowedDomains:n.allowedDomains,respectDNT:n.respectDNT}),o()){E=!0,n.debug&&console.log(`[Do11y] Tracking disabled`);return}(n.destination===`supabase`?n.supabaseKey:n.httpEndpoint)||n.debug&&(console.warn(`[Do11y] No destination configured. Events will not be sent.`),console.warn(`[Do11y] Add <meta name="do11y-url"> and <meta name="do11y-key"> to enable.`)),M(),N(),B(),ue(),de(),pe(),me(),he(),Z(),ge(),_e();let d=window.location.pathname;Q=new MutationObserver(()=>{window.location.pathname!==d&&(d=window.location.pathname,K(),L=new Set,H=Date.now(),U=Date.now(),W=0,G=!0,M(),Y(),V())}),Q.observe(document.body,{childList:!0,subtree:!0}),window.addEventListener(`popstate`,()=>{window.location.pathname!==d&&(d=window.location.pathname,K(),L=new Set,H=Date.now(),U=Date.now(),W=0,G=!0,M(),Y(),V())}),Object.freeze(n),n.debug&&console.log(`[Do11y] Initialized successfully`)}function ve(){Q&&=(Q.disconnect(),null),q&&=(X(),q.disconnect(),null),w&&=(clearTimeout(w),null),j()}t||(document.readyState===`loading`?document.addEventListener(`DOMContentLoaded`,$):$()),window.Do11y=window.Do11y??{getConfig:()=>({destination:n.destination,hasCredentials:n.destination===`supabase`?!!n.supabaseKey:!!n.httpEndpoint,isDisabled:E,allowedDomains:n.allowedDomains,respectDNT:n.respectDNT}),flush:A,isEnabled:()=>!E&&(n.destination===`supabase`?!!n.supabaseKey:!!n.httpEndpoint),getQueueSize:()=>C.length,version:e}})();
+(function(){let e=`browser.do11y.referrer_category`,t=`browser.do11y.ai_platform`,n=`browser.do11y.scroll.threshold`,r=`browser.do11y.scroll.percent`,i=`browser.do11y.section.heading`,a=`browser.do11y.section.heading_level`,o=`browser.do11y.section.visible_seconds`,s=`browser.do11y.expand.summary`,c=`browser.do11y.expand.action`,l=`browser.do11y.expand.section`,u=`browser.do11y.scroll_depth`,d=`browser.do11y.search_opened`,f=`browser.do11y.section_visible`,p=`browser.do11y.expand_collapse`,m=`0.1.1`,h=!!window.__do11yInitialized;window.__do11yInitialized=!0;let g=window.self!==window.top;g&&!h&&(window.__do11yInitialized=!1);let _={destination:`supabase`,supabaseUrl:``,supabaseKey:``,supabaseTable:`do11y_events`,endpoint:``,headers:{},bodyTransform:void 0,otelSdkEndpoint:``,otelSdkHeaders:{},otelSdkServiceName:`do11y`,otelSdkResourceAttributes:{},otelSdkCdnUrl:`https://esm.sh/`,debug:!1,flushInterval:5e3,maxBatchSize:10,trackOutboundLinks:!0,trackInternalLinks:!0,trackScrollDepth:!0,scrollThresholds:[25,50,75,90],allowedDomains:null,respectDNT:!0,maxRetries:2,retryDelay:1e3,rateLimitMs:100,framework:`mintlify`,trackSectionVisibility:!0,sectionVisibleThreshold:3,trackTabSwitches:!0,trackTocClicks:!0,trackExpandCollapse:!0,trackFeedback:!0,tabContainerSelector:null,tocSelector:null,feedbackSelector:null,searchSelector:null,copyButtonSelector:null,codeBlockSelector:null,navigationSelector:null,footerSelector:null,contentSelector:null,useOtelBrowserInstrumentations:!1},v={mintlify:{searchSelector:`#search-bar-entry, #search-bar-entry-mobile, [class*="search"]`,copyButtonSelector:`button[class*="copy"], button[aria-label*="copy" i]`,codeBlockSelector:`pre, [class*="code"]`,navigationSelector:`nav, [role="navigation"], #navbar, #sidebar, [class*="nav"], [class*="sidebar"]`,footerSelector:`footer, [role="contentinfo"], [class*="footer"]`,contentSelector:`main, article, [role="main"], [class*="content"]`,tabContainerSelector:`[role="tablist"], [class*="tab"]`,tocSelector:`#table-of-contents, [data-testid="table-of-contents"], [class*="table-of-contents"], [class*="toc"]`,feedbackSelector:`[class*="feedback"], [class*="helpful"]`},docusaurus:{searchSelector:`.DocSearch, .DocSearch-Button`,copyButtonSelector:`button.clean-btn[aria-label*="copy" i], button[class*="copyButton"]`,codeBlockSelector:`pre, [class*="code"]`,navigationSelector:`nav, [role="navigation"], .navbar, .sidebar, [class*="nav"], [class*="sidebar"]`,footerSelector:`footer, [role="contentinfo"], [class*="footer"]`,contentSelector:`main, article, [role="main"], [class*="content"]`,tabContainerSelector:`.tabs[role="tablist"], [class*="tabs"]`,tocSelector:`.table-of-contents, [class*="toc"]`,feedbackSelector:`[class*="feedback"], [class*="helpful"]`},nextra:{searchSelector:`.nextra-search input, input[placeholder*="search" i], button[aria-label*="search" i]`,copyButtonSelector:`button[class*="copy"], button[aria-label*="copy" i], button[title*="copy" i]`,codeBlockSelector:`pre, [class*="code"]`,navigationSelector:`nav, [role="navigation"], [class*="nav"], [class*="sidebar"]`,footerSelector:`footer, [role="contentinfo"], [class*="footer"]`,contentSelector:`main, article, [role="main"], [class*="content"]`,tabContainerSelector:`[role="tablist"], [class*="tab"]`,tocSelector:`.nextra-toc, [class*="toc"]`,feedbackSelector:`[class*="feedback"], [class*="helpful"]`},"mkdocs-material":{searchSelector:`.md-search__input`,copyButtonSelector:`.md-clipboard, .md-code__button[title="Copy to clipboard"]`,codeBlockSelector:`pre, code, [class*="code"]`,navigationSelector:`nav, [role="navigation"], .md-nav, .md-sidebar`,footerSelector:`footer, [role="contentinfo"], .md-footer`,contentSelector:`main, article, [role="main"], .md-content`,tabContainerSelector:`.tabbed-labels, .md-typeset .tabbed-set`,tocSelector:`.md-sidebar--secondary .md-nav, [class*="toc"]`,feedbackSelector:`[class*="feedback"], [class*="helpful"]`},vitepress:{searchSelector:`.VPNavBarSearch button, .VPNavBarSearchButton, #local-search`,copyButtonSelector:`button.copy, .vp-code-copy, button.copy[title*="Copy"]`,codeBlockSelector:`div[class*="language-"], pre, [class*="code"]`,navigationSelector:`nav, [role="navigation"], .VPNav, .VPSidebar, [class*="nav"], [class*="sidebar"]`,footerSelector:`footer, [role="contentinfo"], .VPFooter, [class*="footer"]`,contentSelector:`main, article, [role="main"], .VPContent, [class*="content"]`,tabContainerSelector:`.vp-code-group .tabs, [role="tablist"]`,tocSelector:`.VPDocAsideOutline, .VPLocalNavOutlineDropdown, a.outline-link`,feedbackSelector:`[class*="feedback"], [class*="helpful"]`},starlight:{searchSelector:`site-search button[data-open-modal], sl-doc-search .DocSearch-Button, button[aria-label*="search" i]`,copyButtonSelector:`.expressive-code .copy button, .copy button[data-code]`,codeBlockSelector:`.expressive-code pre, pre`,navigationSelector:`nav, [role="navigation"], [class*="sidebar"]`,footerSelector:`footer, [role="contentinfo"], [class*="footer"]`,contentSelector:`main, .sl-markdown-content, [role="main"]`,tabContainerSelector:`starlight-tabs [role="tablist"], [role="tablist"]`,tocSelector:`.right-sidebar-panel, starlight-toc, mobile-starlight-toc`,feedbackSelector:`[class*="feedback"], [class*="helpful"]`},docsy:{searchSelector:`.td-search input, .td-search__input, #docsearch-0, #docsearch-1`,copyButtonSelector:`button[aria-label*="copy" i], button[title*="copy" i], .td-click-to-copy`,codeBlockSelector:`.highlight, pre.chroma, pre`,navigationSelector:`nav, [role="navigation"], .td-sidebar, .td-navbar, [class*="sidebar"]`,footerSelector:`footer, [role="contentinfo"], .td-footer, [class*="footer"]`,contentSelector:`main, article, [role="main"], .td-content, [class*="content"]`,tabContainerSelector:`.nav-tabs[role="tablist"], [role="tablist"], .tab-content`,tocSelector:`.td-toc, nav[id="TableOfContents"], [class*="toc"]`,feedbackSelector:`.feedback--answer, [class*="feedback"], [class*="helpful"]`}},y=[`searchSelector`,`copyButtonSelector`,`codeBlockSelector`,`navigationSelector`,`footerSelector`,`contentSelector`,`tabContainerSelector`,`tocSelector`,`feedbackSelector`];function ee(){let e=v[_.framework];e?y.forEach(t=>{_[t]||(_[t]=e[t])}):_.framework!==`custom`&&_.debug&&console.warn(`[Do11y] Unknown framework "${_.framework}". Falling back to generic selectors. Supported: `+Object.keys(v).join(`, `)+`, custom`);let t=v.mintlify;t&&y.forEach(e=>{_[e]||(_[e]=t[e])})}function b(){if(_.respectDNT&&(navigator.doNotTrack===`1`||navigator.doNotTrack===`yes`||window.doNotTrack===`1`))return _.debug&&console.log(`[Do11y] Disabled: Do Not Track is enabled`),!0;if(_.allowedDomains&&_.allowedDomains.length>0){let e=window.location.hostname;if(!_.allowedDomains.some(t=>e===t||e.endsWith(`.`+t)))return _.debug&&console.log(`[Do11y] Disabled: Domain not allowed:`,e),!0}return!1}function x(e){if(!e||typeof e!=`string`)return null;try{return document.querySelector(e),e}catch{return _.debug&&console.warn(`[Do11y] Invalid CSS selector rejected:`,e),null}}function S(e){if(typeof e.className==`string`)return e.className;let t=e.className;return t&&typeof t.baseVal==`string`?t.baseVal:``}function C(e){let t=e.match(/(?:^|\s)language-([\w-]+)(?:\s|$)/);return t?t[1]:null}function te(e){if(!e)return`unknown`;let t=e;for(let e=0;t&&e<12;e++,t=t.parentElement){for(let e of[`language`,`data-language`,`data-lang`,`data-code-lang`]){let n=t.getAttribute(e);if(n)return n}let e=C(S(t));if(e)return e;let n=t.querySelector(`:scope > span.lang`)?.textContent?.trim();if(n)return n;let r=t.querySelector(`[data-language], [data-lang], [data-code-lang], [class*="language-"], [language]`);if(r){let e=r.getAttribute(`language`)??r.getAttribute(`data-language`)??r.getAttribute(`data-lang`)??r.getAttribute(`data-code-lang`)??C(S(r));if(e)return e}}return`unknown`}function ne(e){if(e.startsWith(`#`))return e;let t=e.indexOf(`#`);if(t===-1)return null;let n=e.slice(0,t);return!n||n===window.location.pathname||n===`${window.location.pathname}${window.location.search}`?e.slice(t):null}function re(e){let t=x(_.tocSelector)??`.table-of-contents, .VPDocAsideOutline, .VPLocalNavOutlineDropdown, [class*="toc"], [class*="TableOfContents"], [class*="page-outline"], .right-sidebar-panel, starlight-toc`,n=e.closest(t);return n?((n===e||n.tagName===`A`)&&(n=e.closest(`.VPDocAsideOutline, .VPLocalNavOutlineDropdown, nav, aside, .right-sidebar-panel, starlight-toc`)??n.parentElement),n):null}function w(e,t){if(!e||typeof e!=`string`)return null;let n=t??100,r=e;return r=r.replace(/[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}/g,`[email]`),r=r.replace(/\b\d{3}[-.]?\d{3}[-.]?\d{4}\b/g,`[phone]`),r=r.replace(/\b\d{3}-\d{2}-\d{4}\b/g,`[redacted]`),r=r.replace(/\b(?:\d[ -]?){13,19}\b/g,`[card]`),r=r.replace(/eyJ[A-Za-z0-9_-]+\.eyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+/g,`[token]`),r=r.replace(/\bxa[a-z]{2}-[A-Za-z0-9_-]{20,}/g,`[token]`),r=r.replace(/\b[0-9a-fA-F]{32,}\b/g,`[redacted]`),r.trim().substring(0,n)}function ie(){if(window.crypto&&typeof window.crypto.randomUUID==`function`)return window.crypto.randomUUID();if(window.crypto&&typeof window.crypto.getRandomValues==`function`){let e=new Uint8Array(16);window.crypto.getRandomValues(e),e[6]=e[6]&15|64,e[8]=e[8]&63|128;let t=Array.from(e,e=>e.toString(16).padStart(2,`0`)).join(``);return t.slice(0,8)+`-`+t.slice(8,12)+`-`+t.slice(12,16)+`-`+t.slice(16,20)+`-`+t.slice(20)}return`no-crypto-00-0000-0000-000000000000`}function ae(e){if(!e||typeof e!=`object`)return!1;let t=e;return typeof t.id==`string`&&t.id.length>0&&typeof t.startTime==`string`&&Array.isArray(t.pageSequence)&&typeof t.pageCount==`number`}function T(){let e=null;try{let t=sessionStorage.getItem(`do11y_session`);if(t){let n=JSON.parse(t);ae(n)&&(e=n)}}catch{}return e||(e={id:ie(),startTime:new Date().toISOString(),pageSequence:[],pageCount:0,referrerCategory:null,aiPlatform:null},E(e)),e}function E(e){try{sessionStorage.setItem(`do11y_session`,JSON.stringify(e))}catch{}}function oe(e){let t=T();return t.pageCount++,t.pageSequence.push({path:e,timestamp:new Date().toISOString(),index:t.pageCount}),t.pageSequence.length>50&&(t.pageSequence=t.pageSequence.slice(-50)),E(t),t}function se(){return{"browser.do11y.viewport_category":ce(),"browser.family":le(),"device.type":ue(),"browser.language":(navigator.language||``).split(`-`)[0]||`unknown`,"browser.do11y.timezone_offset":new Date().getTimezoneOffset()/60}}function ce(){let e=window.innerWidth;return e<640?`mobile`:e<1024?`tablet`:e<1440?`desktop`:`large-desktop`}function le(){let e=navigator.userAgent;return e.includes(`Firefox`)?`Firefox`:e.includes(`Edg`)?`Edge`:e.includes(`Chrome`)?`Chrome`:e.includes(`Safari`)?`Safari`:`Other`}function ue(){let e=navigator.userAgent;return/Mobile|Android|iPhone|iPad/.test(e)?/iPad|Tablet/.test(e)?`tablet`:`mobile`:`desktop`}let de=[{match:`chatgpt`,platform:`ChatGPT`},{match:`chat.com`,platform:`ChatGPT`},{match:`openai`,platform:`ChatGPT`},{match:`perplexity`,platform:`Perplexity`},{match:`claude.ai`,platform:`Claude`},{match:`anthropic`,platform:`Claude`},{match:`gemini`,platform:`Gemini`},{match:`copilot`,platform:`Copilot`},{match:`deepseek`,platform:`DeepSeek`},{match:`meta.ai`,platform:`Meta AI`},{match:`grok`,platform:`Grok`},{match:`x.ai`,platform:`Grok`},{match:`mistral`,platform:`Mistral`},{match:`you.com`,platform:`You.com`},{match:`phind`,platform:`Phind`}];function fe(e){if(!e||e===`direct`)return{referrerCategory:`direct`,aiPlatform:null};if(e===`internal`)return{referrerCategory:`internal`,aiPlatform:null};if(e===`unknown`)return{referrerCategory:`unknown`,aiPlatform:null};let t=e.toLowerCase();for(let e of de)if(t.indexOf(e.match)!==-1)return{referrerCategory:`ai`,aiPlatform:e.platform};return/google\.|bing\.|baidu\.|yandex\.|duckduckgo\.|yahoo\./.test(t)?{referrerCategory:`search-engine`,aiPlatform:null}:/github\.|gitlab\.|bitbucket\./.test(t)?{referrerCategory:`code-host`,aiPlatform:null}:/stackoverflow\.|stackexchange\.|reddit\.|news\.ycombinator\./.test(t)?{referrerCategory:`community`,aiPlatform:null}:/twitter\.|x\.com|linkedin\.|facebook\.|threads\.net/.test(t)?{referrerCategory:`social`,aiPlatform:null}:{referrerCategory:`other`,aiPlatform:null}}function pe(){try{if(!document.referrer)return`direct`;let e=new URL(document.referrer);return e.hostname===window.location.hostname?`internal`:e.hostname}catch{return`unknown`}}function me(){return{"url.path":window.location.pathname,"url.fragment":window.location.hash||null,"url.query":window.location.search?`has_params`:null,"browser.do11y.page_title":w(document.title,150)}}let D=[],O=null,k={},A=!1;function j(e,t){if(A)return;let n=Date.now();if(_.rateLimitMs>0&&k[e]&&n-k[e]<_.rateLimitMs){_.debug&&console.log(`[Do11y] Rate limited:`,e);return}k[e]=n;let r=T(),i={_time:new Date().toISOString(),eventName:e,"browser.do11y.version":m,"session.id":r.id,"browser.do11y.session_page_count":r.pageCount,...me(),...se(),...t};if(_.debug&&console.log(`[Do11y] Event queued:`,e,i),_.destination===`otlp`&&M){M.emit({eventName:e,severityNumber:9,attributes:i,body:``});return}D.push(i),D.length>100&&(D=D.slice(-100),_.debug&&console.warn(`[Do11y] Event queue capped at 100 events`)),D.length>=_.maxBatchSize?F():he()}function he(){O||=setTimeout(F,_.flushInterval)}let M=null;function ge(e){try{let t=new URL(e);return!(t.protocol!==`https:`||!t.hostname.endsWith(`.supabase.co`))}catch{return!1}}function _e(e){try{let t=new URL(e);if(t.protocol!==`https:`)return!1;let n=t.hostname;return!(n===`localhost`||n===`127.0.0.1`||n===`::1`||/^(10\.|172\.(1[6-9]|2\d|3[01])\.|192\.168\.)/.test(n))}catch{return!1}}function N(){return _.destination===`supabase`?_.supabaseUrl?ge(_.supabaseUrl)?!_.supabaseKey||typeof _.supabaseKey!=`string`||_.supabaseKey.length<10?(_.debug&&console.warn(`[Do11y] Invalid or missing Supabase publishable key`),!1):/^[a-zA-Z0-9_-]+$/.test(_.supabaseTable)?!0:(_.debug&&console.warn(`[Do11y] Invalid table name`),!1):(_.debug&&console.warn(`[Do11y] Invalid Supabase URL. Must be https://<project>.supabase.co`),!1):(_.debug&&console.warn(`[Do11y] No Supabase URL configured`),!1):_.destination===`http`?_.endpoint?_e(_.endpoint)?!0:(_.debug&&console.warn(`[Do11y] Invalid HTTP endpoint. Must be HTTPS and not a private address.`),!1):(_.debug&&console.warn(`[Do11y] No HTTP endpoint configured`),!1):_.destination===`otlp`?_.otelSdkEndpoint?(ve().catch(e=>{_.debug&&console.warn(`[Do11y] OTel SDK initialization failed:`,e)}),!0):(_.debug&&console.warn(`[Do11y] No OTLP endpoint configured`),!1):(_.debug&&console.warn(`[Do11y] Unknown destination:`,_.destination),!1)}async function ve(){if(M)return;let e=_.otelSdkCdnUrl.replace(/\/+$/,``)+`/`,t=await import(`${e}@opentelemetry/api-logs`),n=await import(`${e}@opentelemetry/sdk-logs`),r=await import(`${e}@opentelemetry/exporter-logs-otlp-http`),i={"service.name":_.otelSdkServiceName||`do11y`,"service.version":m,"telemetry.sdk.name":`do11y`,"telemetry.sdk.language":`webjs`,"telemetry.sdk.version":m,..._.otelSdkResourceAttributes},a=new n.LoggerProvider({resource:{attributes:i},processors:[new n.BatchLogRecordProcessor({exporter:new r.OTLPLogExporter({url:_.otelSdkEndpoint.replace(/\/$/,``)+`/v1/logs`,headers:_.otelSdkHeaders})})]});t.logs.setGlobalLoggerProvider(a),M=a.getLogger(`do11y`),_.debug&&console.log(`[Do11y] OTel SDK initialized with endpoint:`,_.otelSdkEndpoint)}function P(e){if(_.destination===`supabase`){let t=_.supabaseUrl.replace(/\/$/,``)+`/rest/v1/`+_.supabaseTable,n=_.bodyTransform??(e=>e.map(e=>({payload:e})));return{url:t,headers:{apikey:_.supabaseKey,Authorization:`Bearer `+_.supabaseKey,"Content-Type":`application/json`,Prefer:`return=minimal`},body:JSON.stringify(n(e))}}let t=_.bodyTransform??(e=>e);return{url:_.endpoint,headers:{"Content-Type":`application/json`,..._.headers},body:JSON.stringify(t(e))}}function F(e){if(O&&=(clearTimeout(O),null),D.length===0||!N())return;let t=typeof e==`number`?e:_.maxRetries,n=D.slice();D=[],be(P(n),n,t)}function ye(e){try{return new URL(e).origin!==window.location.origin}catch{return!1}}function be(e,t,n){let r=ye(e.url);_.debug&&r&&console.log(`[Do11y] Cross-origin request to`,new URL(e.url).origin,`- requires CORS headers on the server`),fetch(e.url,{method:`POST`,headers:e.headers,body:e.body,keepalive:!0,mode:r?`cors`:`same-origin`}).then(e=>{if(e.ok){_.debug&&console.log(`[Do11y] Flushed`,t.length,`events`);return}if(n>0&&(e.status>=500||e.status===429)){_.debug&&console.log(`[Do11y] Retrying after error:`,e.status),D=t.concat(D),setTimeout(()=>{F(n-1)},_.retryDelay*(_.maxRetries-n+1));return}_.debug&&e.text().then(t=>{let n=`[Do11y] Ingest failed: ${e.status}`;e.status===0&&e.type===`opaque`?console.error(n,`- CORS error: server did not return Access-Control-Allow-Origin`):console.error(n,t)}).catch(()=>{})}).catch(e=>{if(n>0){if(_.debug){let t=r?` (this may be a CORS issue — try using an OTel Collector proxy)`:``;console.log(`[Do11y] Network error, retrying:`,e.message+t)}D=t.concat(D),setTimeout(()=>{F(n-1)},_.retryDelay*(_.maxRetries-n+1))}else _.debug&&console.error(`[Do11y] Failed to send events:`,e.message)})}function xe(){if(_.destination===`otlp`||D.length===0||!N())return;let e=D;D=[];let t=P(e);try{fetch(t.url,{method:`POST`,headers:t.headers,body:t.body,keepalive:!0})}catch{}_.debug&&console.log(`[Do11y] Sync flushed`,e.length,`events`)}function I(){K=!1;let n=oe(window.location.pathname),r=pe(),i=fe(r);n.pageCount===1&&(n.referrerCategory=i.referrerCategory,n.aiPlatform=i.aiPlatform,E(n)),j(`browser.do11y.page_view`,{"browser.do11y.referrer_domain":r,[e]:i.referrerCategory,[t]:i.aiPlatform,"browser.do11y.is_first_page":n.pageCount===1,"browser.do11y.previous_path":n.pageSequence.length>1?n.pageSequence[n.pageSequence.length-2].path:null})}function Se(){document.addEventListener(`click`,e=>{let t=e.target.closest(`a`);if(!t)return;let n=t.getAttribute(`href`);if(!n)return;let r=`other`,i=null;try{if(n.startsWith(`#`))r=`anchor`;else if(n.startsWith(`/`)||n.startsWith(`./`)||n.startsWith(`../`))r=`internal`;else if(n.startsWith(`http`)){let e=new URL(n);e.hostname===window.location.hostname?r=`internal`:(r=`external`,i=e.hostname)}else n.startsWith(`mailto:`)&&(r=`email`)}catch{}r===`internal`&&!_.trackInternalLinks||r===`external`&&!_.trackOutboundLinks||(j(`browser.do11y.link_click`,{"browser.do11y.link.type":r,"browser.do11y.link.target_url":n,"browser.do11y.link.target_domain":i,"browser.do11y.link.text":w(t.textContent,100),"browser.do11y.link.context":Ce(t),"browser.do11y.link.section":w(L(t),100),"browser.do11y.link.index":we(t,n)}),F())},!0)}function Ce(e){return e.closest(_.navigationSelector)?`navigation`:e.closest(_.footerSelector)?`footer`:e.closest(_.contentSelector)?`content`:`other`}function L(e){let t=e;for(;t&&t!==document.body;){let e=t.previousElementSibling;for(;e;){if(/^H[1-6]$/.test(e.tagName))return e.textContent?.trim().substring(0,100)??null;let t=e.querySelectorAll(`h1, h2, h3, h4, h5, h6`);if(t.length>0)return t[t.length-1].textContent?.trim().substring(0,100)??null;e=e.previousElementSibling}t=t.parentElement}return null}function we(e,t){if(typeof CSS>`u`||typeof CSS.escape!=`function`)return 1;try{let n=document.querySelectorAll(`a[href="`+CSS.escape(t)+`"]`);for(let t=0;t<n.length;t++)if(n[t]===e)return t+1}catch{}return 1}let R=new Set,z=null;function B(e){let t=e;for(;t&&t!==document.body&&t!==document.documentElement;){let e=window.getComputedStyle(t).overflowY;if((e===`auto`||e===`scroll`)&&t.scrollHeight>t.clientHeight)return t;t=t.parentElement}return null}function Te(){if(!_.trackScrollDepth)return;if(_.contentSelector){let e=document.querySelector(_.contentSelector);e&&(z=B(e))}let e=!1;function t(){e||=(window.requestAnimationFrame(()=>{V(),e=!1}),!0)}if(window.addEventListener(`scroll`,t),z&&(z.addEventListener(`scroll`,t),_.debug)){let e=z;console.log(`[do11y] Using container-based scroll tracking:`,e.className||e.tagName)}V()}function V(){let e,t,i;z&&z.scrollHeight>z.clientHeight?(e=z.scrollTop,t=z.scrollHeight,i=z.clientHeight):(e=window.scrollY||document.documentElement.scrollTop,t=document.documentElement.scrollHeight,i=window.innerHeight);let a=t-i;if(a<=0){_.scrollThresholds.forEach(e=>{R.has(e)||(R.add(e),j(u,{[n]:e,[r]:100}))});return}let o=Math.round(e/a*100);_.scrollThresholds.forEach(e=>{o>=e&&!R.has(e)&&(R.add(e),j(u,{[n]:e,[r]:o}))})}let H=Date.now(),U=Date.now(),W=0,G=!0,K=!1;function q(){if(K)return;K=!0,G&&(W+=Date.now()-U);let n=Date.now()-H,r=n>0?W/n:0,i=0;R.forEach(e=>{e>i&&(i=e)}),Z();let a=T();j(`browser.do11y.page_exit`,{"browser.do11y.page_exit.total_time_seconds":Math.round(n/1e3),"browser.do11y.page_exit.active_time_seconds":Math.round(W/1e3),"browser.do11y.page_exit.engagement_ratio":Math.round(r*100)/100,"browser.do11y.page_exit.max_scroll_depth":i,[e]:a.referrerCategory,[t]:a.aiPlatform})}function Ee(){document.addEventListener(`visibilitychange`,()=>{document.hidden?G&&=(W+=Date.now()-U,!1):(U=Date.now(),G=!0)}),window.addEventListener(`beforeunload`,()=>{q(),Fe()})}function De(){document.addEventListener(`click`,e=>{e.target.closest(_.searchSelector)&&j(d,{})},!0),document.addEventListener(`keydown`,e=>{(e.metaKey||e.ctrlKey)&&e.key===`k`&&j(d,{"browser.do11y.search.trigger":`keyboard`})})}function Oe(e){if(!e)return 1;try{let t=document.querySelectorAll(_.codeBlockSelector);for(let n=0;n<t.length;n++)if(t[n]===e)return n+1}catch{}return 1}function ke(){document.addEventListener(`click`,e=>{let t=e.target.closest(_.copyButtonSelector);if(t){let e=t.closest(`[class*="language-"], [language]`)??t.closest(_.codeBlockSelector)??t.closest(`.expressive-code`)?.querySelector(`pre`)??t.closest(`div, section`)?.querySelector(`pre`)??t.parentElement?.querySelector(`pre`)??null,n=te((e?e.tagName===`PRE`?e.querySelector(`code`):e.querySelector(`code[class*="language-"], code[language]`)??e.querySelector(`code`):null)??e??t);j(`browser.do11y.code_copied`,{"browser.do11y.code.language":n,"browser.do11y.code.section":w(L(e??t),100),"browser.do11y.code.index":Oe(e)})}},!0)}let J=null,Y={};function Ae(){if(!_.trackSectionVisibility||typeof IntersectionObserver>`u`)return;let e=_.sectionVisibleThreshold*1e3;J=new IntersectionObserver(t=>{t.forEach(t=>{let n=t.target.getAttribute(`data-do11y-section-id`);if(n)if(t.isIntersecting)Y[n]||(Y[n]={start:Date.now(),reported:!1});else{if(Y[n]&&!Y[n].reported){let r=Date.now()-Y[n].start;if(r>=e){let e=t.target.textContent?.trim()??``;j(f,{[i]:w(e,100),[a]:parseInt(t.target.tagName.charAt(1),10),[o]:Math.round(r/1e3)}),Y[n].reported=!0}}delete Y[n]}})},{threshold:.5}),X()}function X(){J&&document.querySelectorAll(`h2, h3`).forEach((e,t)=>{e.setAttribute(`data-do11y-section-id`,`section-`+t),J.observe(e)})}function Z(){if(!J)return;let e=Date.now(),t=_.sectionVisibleThreshold*1e3;Object.keys(Y).forEach(n=>{let r=Y[n];if(r&&!r.reported){let s=e-r.start;if(s>=t){let e=typeof CSS<`u`&&typeof CSS.escape==`function`?CSS.escape(n):n.replace(/["\\]/g,`\\$&`),t=document.querySelector(`[data-do11y-section-id="`+e+`"]`);t&&j(f,{[i]:w(t.textContent?.trim()??``,100),[a]:parseInt(t.tagName.charAt(1),10),[o]:Math.round(s/1e3)})}}}),Y={}}function je(){_.trackTabSwitches&&document.addEventListener(`click`,e=>{let t=`[role="tab"], .tabs button, .tabs a, .tabbed-labels label`,n=x(_.tabContainerSelector);n&&(t+=`, `+n+` button, `+n+` a, `+n+` label`);let r=e.target.closest(t);if(!r||r.getAttribute(`aria-selected`)===`true`||r.classList.contains(`active`)||r.classList.contains(`is-active`))return;let i=w(r.textContent,50);if(!i)return;let a=w(L(r),100);j(`browser.do11y.tab_switch`,{"browser.do11y.tab.label":i,"browser.do11y.tab.group":a,"browser.do11y.tab.is_default":!1})})}function Me(){_.trackTocClicks&&document.addEventListener(`click`,e=>{let t=e.target.closest(`a`);if(!t)return;let n=re(t);if(!n)return;let r=t.getAttribute(`href`),i=r?ne(r):null;if(!i)return;let a=w(t.textContent,100),o=null;try{let e=i.slice(1),t=document.getElementById(e);t&&/^H[1-6]$/.test(t.tagName)&&(o=parseInt(t.tagName.charAt(1),10))}catch{}let s=n.querySelectorAll(`a[href*="#"]`),c=1;for(let e=0;e<s.length;e++)if(s[e]===t){c=e+1;break}j(`browser.do11y.toc_click`,{"browser.do11y.toc.heading":a,"browser.do11y.toc.heading_level":o,"browser.do11y.toc.position":c})},!0)}function Ne(){_.trackFeedback&&document.addEventListener(`click`,e=>{let t=e.target.closest(`button, [role="button"], a`);if(!t||!t.closest(x(_.feedbackSelector)??`[class*="feedback"], [class*="helpful"], [class*="rating"], [class*="was-this"], [data-feedback]`))return;let n=(t.textContent??``).trim().toLowerCase(),r=(t.getAttribute(`aria-label`)??``).toLowerCase(),i=(t.getAttribute(`title`)??``).toLowerCase(),a=t.getAttribute(`data-value`)??t.getAttribute(`data-md-value`)??t.getAttribute(`data-feedback`),o=a&&/^[\w\s.,!?-]{1,50}$/.test(a)?a:null,s=null;o?s=o:/\byes\b|👍|thumbs.?up|helpful/i.test(n+` `+r+` `+i)?s=`yes`:/\bno\b|👎|thumbs.?down|not.?helpful/i.test(n+` `+r+` `+i)&&(s=`no`),s&&j(`browser.do11y.feedback`,{"browser.do11y.feedback.rating":s})})}function Pe(){_.trackExpandCollapse&&(document.addEventListener(`toggle`,e=>{let t=e.target;if(t.tagName!==`DETAILS`)return;let n=t.querySelector(`summary`),r=w(n?n.textContent:``,100);j(p,{[s]:r,[c]:t.open?`expand`:`collapse`,[l]:w(L(t),100)})},!0),document.addEventListener(`click`,e=>{let t=e.target.closest(`[aria-expanded], [class*="accordion"] button, [class*="collapsible"] button`);if(!t||t.closest(`details`)||t.closest(`nav, [role="navigation"], header`))return;let n=t.getAttribute(`aria-expanded`)===`true`;j(p,{[s]:w(t.textContent,100),[c]:n?`collapse`:`expand`,[l]:w(L(t),100)})}))}let Q=null;function $(){if(window.Do11yConfig&&typeof window.Do11yConfig==`object`)for(let e in window.Do11yConfig)Object.prototype.hasOwnProperty.call(window.Do11yConfig,e)&&Object.prototype.hasOwnProperty.call(_,e)&&(_[e]=window.Do11yConfig[e]);let e=document.querySelector(`meta[name="do11y-destination"]`);if(e){let t=e.getAttribute(`content`);(t===`supabase`||t===`http`||t===`otlp`)&&(_.destination=t)}let t=document.querySelector(`meta[name="do11y-url"]`);t&&(_.supabaseUrl=t.getAttribute(`content`)??_.supabaseUrl);let n=document.querySelector(`meta[name="do11y-key"]`);n&&(_.supabaseKey=n.getAttribute(`content`)??_.supabaseKey);let r=document.querySelector(`meta[name="do11y-table"]`);r&&(_.supabaseTable=r.getAttribute(`content`)??_.supabaseTable);let i=document.querySelector(`meta[name="do11y-endpoint"]`);i&&(_.endpoint=i.getAttribute(`content`)??_.endpoint);let a=document.querySelector(`meta[name="do11y-otlp-endpoint"]`);a&&(_.otelSdkEndpoint=a.getAttribute(`content`)??_.otelSdkEndpoint);let o=document.querySelector(`meta[name="do11y-otlp-headers"]`);if(o)try{let e=JSON.parse(o.getAttribute(`content`)??`{}`);typeof e==`object`&&e&&(_.otelSdkHeaders=e)}catch{}let s=document.querySelector(`meta[name="do11y-debug"]`);s&&s.getAttribute(`content`)===`true`&&(_.debug=!0);let c=document.querySelector(`meta[name="do11y-domains"]`);if(c){let e=c.getAttribute(`content`);e&&(_.allowedDomains=e.split(`,`).map(e=>e.trim()))}let l=document.querySelector(`meta[name="do11y-framework"]`);l&&(_.framework=l.getAttribute(`content`)??_.framework);let u=document.querySelector(`meta[name="do11y-use-otel-instrumentations"]`);if(u&&u.getAttribute(`content`)===`true`&&(_.useOtelBrowserInstrumentations=!0),ee(),_.debug){let e=_.destination===`supabase`?!!_.supabaseKey:_.destination===`otlp`?!!_.otelSdkEndpoint:!!_.endpoint;console.log(`[Do11y] Initializing with config:`,{destination:_.destination,hasCredentials:e,framework:_.framework,allowedDomains:_.allowedDomains,respectDNT:_.respectDNT})}if(b()){A=!0,_.debug&&console.log(`[Do11y] Tracking disabled`);return}(_.destination===`supabase`?_.supabaseKey:_.destination===`otlp`?_.otelSdkEndpoint:_.endpoint)||_.debug&&(console.warn(`[Do11y] No destination configured. Events will not be sent.`),_.destination===`supabase`?console.warn(`[Do11y] Add <meta name="do11y-url"> and <meta name="do11y-key"> to enable.`):_.destination===`otlp`?console.warn(`[Do11y] Add <meta name="do11y-otlp-endpoint"> to enable.`):console.warn(`[Do11y] Add <meta name="do11y-endpoint"> to enable.`)),I(),Se(),Te(),Ee(),De(),ke(),Ae(),je(),Me(),Ne(),Pe();let d=window.location.pathname;Q=new MutationObserver(()=>{window.location.pathname!==d&&(d=window.location.pathname,q(),R=new Set,H=Date.now(),U=Date.now(),W=0,G=!0,I(),X(),V())}),Q.observe(document.body,{childList:!0,subtree:!0}),window.addEventListener(`popstate`,()=>{window.location.pathname!==d&&(d=window.location.pathname,q(),R=new Set,H=Date.now(),U=Date.now(),W=0,G=!0,I(),X(),V())}),Object.freeze(_),_.debug&&console.log(`[Do11y] Initialized successfully`)}function Fe(){Q&&=(Q.disconnect(),null),J&&=(Z(),J.disconnect(),null),O&&=(clearTimeout(O),null),xe()}!h&&!g&&(document.readyState===`loading`?document.addEventListener(`DOMContentLoaded`,$):$()),window.Do11y=window.Do11y??{getConfig:()=>({destination:_.destination,hasCredentials:_.destination===`supabase`?!!_.supabaseKey:_.destination===`otlp`?!!_.otelSdkEndpoint:!!_.endpoint,isDisabled:A,allowedDomains:_.allowedDomains,respectDNT:_.respectDNT}),flush:F,isEnabled:()=>A?!1:_.destination===`supabase`?!!_.supabaseKey:_.destination===`otlp`?!!_.otelSdkEndpoint:!!_.endpoint,getQueueSize:()=>D.length,version:m}})();

package/examples/do11y-config.example.js

@@ -2,7 +2,7 @@
  * Do11y configuration example.
  *
  * Copy this file alongside do11y.js in your docs site and rename it to
- * do11y-config.js. Set the values below to match your Supabase setup.
+ * do11y-config.js. Set the values below to match your setup.
  *
  * This file must load before do11y.js. For frameworks that auto-include
  * all .js files (like Mintlify), alphabetical ordering handles this
@@ -10,20 +10,41 @@
  *
  * Any option from the config object in do11y.js can be set here.
  * See the README for the full list.
+ *
+ * All events use OpenTelemetry semantic convention attribute naming.
  */
 window.Do11yConfig = {
-  // Destination: 'supabase' (default) or 'http'
+  // Destination: 'supabase' (default), 'http', or 'otlp'
   destination: 'supabase',
 
-  // Required: Supabase project URL.
+  // ── Supabase (default) ─────────────────────────────────────────────────
+  // Required for Supabase destination:
   supabaseUrl: 'https://YOUR_PROJECT.supabase.co',
-
-  // Required: Supabase publishable key (starts with sb_publishable_).
   supabaseKey: 'sb_publishable_YOUR_KEY',
 
   // Optional: Table name (default: 'do11y_events').
   supabaseTable: 'do11y_events',
 
+  // ── Generic HTTP ───────────────────────────────────────────────────────
+  // destination: 'http',
+  // endpoint: 'https://your-endpoint.com/events',
+  // headers: { 'Authorization': 'Bearer your-token' },
+  //
+  // Optional: transform the event array before sending.
+  // Default: sends [event, event, ...]
+  // bodyTransform: (events) => events.map(e => ({ payload: e })),
+
+  // ── OTLP (OpenTelemetry SDK) ──────────────────────────────────────────
+  // destination: 'otlp',
+  // otelSdkEndpoint: 'https://otlp.grafana.com/otlp',
+  // otelSdkHeaders: { 'Authorization': 'Bearer your-token' },
+  // otelSdkServiceName: 'my-docs',
+  //
+  // ⚠️ CORS: Cloud OTLP endpoints (Grafana, Datadoc, etc.) do not
+  // return CORS headers, so browsers block direct cross-origin POSTs.
+  // To use from a browser, run an OTel Collector or CORS proxy in front.
+  // See https://docservable.com/configuration#otlp for details.
+
   // Documentation framework. Supported values:
   // 'mintlify', 'docusaurus', 'nextra', 'starlight', 'mkdocs-material',
   // 'vitepress', 'custom'
@@ -32,9 +53,4 @@ window.Do11yConfig = {
   // Optional: restrict which domains may send data.
   // Set to null to allow any domain.
   // allowedDomains: ['docs.example.com'],
-
-  // --- Alternative: Generic HTTP destination ---
-  // destination: 'http',
-  // httpEndpoint: 'https://your-endpoint.com/events',
-  // httpHeaders: { 'Authorization': 'Bearer your-token' },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@manototh/do11y",
-  "version": "0.0.4",
+  "version": "0.1.1",
   "description": "Documentation observability",
   "type": "module",
   "main": "./dist/do11y.min.js",