From 699f4ea27e87643577a1002e1498f75ec243f97a Mon Sep 17 00:00:00 2001
From: Alex Patterson <alex@codingcat.dev>
Date: Sat, 10 Oct 2026 15:34:09 -0400
Subject: [PATCH] feat(analytics): add Cloudflare Workers Analytics Engine edge
 telemetry, sendBeacon click tracking, and first-party PostHog /ingest proxy

---
 apps/site/.dev.vars.example                   |   3 +
 .../site/src/components/AnalyticsBeacon.astro | 175 +++++++++++++
 apps/site/src/components/Header.astro         |   2 +
 apps/site/src/components/PodcastListen.astro  |   9 +
 apps/site/src/components/SponsorCard.astro    |   3 +
 apps/site/src/layouts/BaseLayout.astro        |   2 +
 apps/site/src/lib/analytics.ts                | 231 ++++++++++++++++++
 apps/site/src/middleware.ts                   |  22 ++
 apps/site/src/pages/api/event.ts              |  44 ++++
 apps/site/src/pages/ingest/[...path].ts       |  63 +++++
 apps/site/wrangler.jsonc                      |  14 +-
 11 files changed, 567 insertions(+), 1 deletion(-)
 create mode 100644 apps/site/src/components/AnalyticsBeacon.astro
 create mode 100644 apps/site/src/lib/analytics.ts
 create mode 100644 apps/site/src/pages/api/event.ts
 create mode 100644 apps/site/src/pages/ingest/[...path].ts

diff --git a/apps/site/.dev.vars.example b/apps/site/.dev.vars.example
index a90ca9b4c..7f2b277f8 100644
--- a/apps/site/.dev.vars.example
+++ b/apps/site/.dev.vars.example
@@ -1,2 +1,5 @@
 # Local secrets for `wrangler dev` / platformProxy. Copy to .dev.vars (gitignored).
 SANITY_API_READ_TOKEN=
+# Optional: PostHog project key for visitor flows, funnels, and LMS telemetry via /ingest proxy
+PUBLIC_POSTHOG_KEY=
+PUBLIC_POSTHOG_HOST=https://us.i.posthog.com
diff --git a/apps/site/src/components/AnalyticsBeacon.astro b/apps/site/src/components/AnalyticsBeacon.astro
new file mode 100644
index 000000000..e18ddc9c1
--- /dev/null
+++ b/apps/site/src/components/AnalyticsBeacon.astro
@@ -0,0 +1,175 @@
+---
+import { env } from "cloudflare:workers";
+
+const runtimeEnv = env as unknown as Record<string, string | undefined>;
+const posthogKey =
+	runtimeEnv.PUBLIC_POSTHOG_KEY || import.meta.env.PUBLIC_POSTHOG_KEY || "";
+const posthogUiHost =
+	runtimeEnv.PUBLIC_POSTHOG_UI_HOST ||
+	import.meta.env.PUBLIC_POSTHOG_UI_HOST ||
+	"https://us.posthog.com";
+---
+
+<script is:inline define:vars={{ posthogKey, posthogUiHost }}>
+	(function () {
+		function sendBeaconEvent(type, detail) {
+			var payload = JSON.stringify({
+				type: type,
+				path: window.location.pathname,
+				target: (detail && detail.target) || "",
+				label: (detail && detail.label) || "",
+				value: (detail && detail.value) || 1,
+			});
+
+			try {
+				if (navigator.sendBeacon) {
+					navigator.sendBeacon("/api/event", payload);
+				} else {
+					fetch("/api/event", {
+						method: "POST",
+						body: payload,
+						keepalive: true,
+						headers: { "Content-Type": "application/json" },
+					}).catch(function () {});
+				}
+			} catch (_e) {}
+
+			try {
+				if (window.posthog && typeof window.posthog.capture === "function") {
+					window.posthog.capture(type, {
+						path: window.location.pathname,
+						target: detail && detail.target,
+						label: detail && detail.label,
+						value: detail && detail.value,
+					});
+				}
+			} catch (_e) {}
+		}
+
+		// Global helper for future LMS course/lesson components & auth gates
+		window.ccTrack = sendBeaconEvent;
+
+		// Passive click delegation for [data-track], outbound links, search, and chat
+		document.addEventListener(
+			"click",
+			function (e) {
+				var target = e.target;
+				if (!(target instanceof Element)) return;
+
+				var trackedEl = target.closest("[data-track]");
+				if (trackedEl) {
+					var eventType = trackedEl.getAttribute("data-track") || "ui_interaction";
+					var label =
+						trackedEl.getAttribute("data-track-label") ||
+						trackedEl.getAttribute("aria-label") ||
+						(trackedEl.textContent || "").trim().slice(0, 80);
+					var href =
+						trackedEl.getAttribute("data-track-target") ||
+						trackedEl.getAttribute("href") ||
+						"";
+					sendBeaconEvent(eventType, { target: href, label: label });
+					return;
+				}
+
+				var anchor = target.closest("a[href]");
+				if (anchor) {
+					var rawHref = anchor.getAttribute("href") || "";
+					if (rawHref.indexOf("http") === 0) {
+						try {
+							var parsed = new URL(rawHref, window.location.origin);
+							if (parsed.hostname !== window.location.hostname) {
+								var linkLabel =
+									anchor.getAttribute("aria-label") ||
+									(anchor.textContent || "").trim().slice(0, 80) ||
+									parsed.hostname;
+								sendBeaconEvent("outbound_click", {
+									target: rawHref,
+									label: linkLabel,
+								});
+							}
+						} catch (_e) {}
+					}
+				}
+			},
+			{ passive: true, capture: true },
+		);
+
+		// Track podcast audio plays passively
+		document.addEventListener(
+			"play",
+			function (e) {
+				var el = e.target;
+				if (el instanceof HTMLAudioElement) {
+					sendBeaconEvent("podcast_listen", {
+						target: el.currentSrc || el.src || window.location.pathname,
+						label: "html5_audio",
+					});
+				}
+			},
+			{ passive: true, capture: true },
+		);
+
+		// Optional PostHog initialization via first-party /ingest reverse proxy
+		if (posthogKey) {
+			!(function (t, e) {
+				var o, n, p, r;
+				e.__SV ||
+					((window.posthog = e),
+					(e._i = []),
+					(e.init = function (i, s, a) {
+						function g(t, e) {
+							var o = e.split(".");
+							2 == o.length && ((t = t[o[0]]), (e = o[1])),
+								(t[e] = function () {
+									t.push([e].concat(Array.prototype.slice.call(arguments, 0)));
+								});
+						}
+						((p = t.createElement("script")).type = "text/javascript"),
+							(p.crossOrigin = "anonymous"),
+							(p.async = !0),
+							(p.src =
+								s.api_host.replace(".i.posthog.com", "-assets.i.posthog.com") +
+								"/static/array.js"),
+							(r = t.getElementsByTagName("script")[0]).parentNode.insertBefore(
+								p,
+								r,
+							);
+						var u = e;
+						for (
+							void 0 !== a ? (u = e[a] = []) : (a = "posthog"),
+								u.people = u.people || [],
+								u.toString = function (t) {
+									var e = "posthog";
+									return (
+										"posthog" !== a && (e += "." + a), t || (e += " (stub)"), e
+									);
+								},
+								u.people.toString = function () {
+									return u.toString(1) + ".people (stub)";
+								},
+								o =
+									"init capture register register_once register_for_session unregister opt_out_capturing has_opted_out_capturing opt_in_capturing reset isFeatureEnabled onFeatureFlags getFeatureFlag getFeatureFlagPayload reloadFeatureFlags group updateEarlyAccessFeatureEnrollment getEarlyAccessFeatures getActiveMatchingSurveys getSurveys getNextSurveyStep onSessionId setPersonPropertiesForFlags".split(
+										" ",
+									),
+								n = 0;
+							n < o.length;
+							n++
+						)
+							g(u, o[n]);
+						e._i.push([i, s, a]);
+					}),
+					(e.__SV = 1));
+			})(document, window.posthog || []);
+
+			window.posthog.init(posthogKey, {
+				api_host: "/ingest",
+				ui_host: posthogUiHost,
+				person_profiles: "identified_only",
+				capture_pageview: true,
+				capture_pageleave: true,
+				disable_session_recording:
+					window.location.pathname.indexOf("/courses") !== 0,
+			});
+		}
+	})();
+</script>
diff --git a/apps/site/src/components/Header.astro b/apps/site/src/components/Header.astro
index 008031a3c..edc19f647 100644
--- a/apps/site/src/components/Header.astro
+++ b/apps/site/src/components/Header.astro
@@ -29,6 +29,8 @@ const desktopLinks = navLinks.filter((link) => link?.sideOnly !== true);
 		<button
 			type="button"
 			id="search-header-trigger"
+			data-track="search_open"
+			data-track-label="header_search"
 			class="inline-flex items-center justify-center gap-1.5 rounded-md px-2.5 py-1.5 text-xs text-muted-foreground hover:bg-accent hover:text-accent-foreground transition-colors border border-border/60 cursor-pointer"
 			aria-label="Search CodingCat.dev (⌘K)"
 		>
diff --git a/apps/site/src/components/PodcastListen.astro b/apps/site/src/components/PodcastListen.astro
index 36ca8a9a4..d4455d203 100644
--- a/apps/site/src/components/PodcastListen.astro
+++ b/apps/site/src/components/PodcastListen.astro
@@ -42,6 +42,9 @@ const buttonClass =
 					rel="noreferrer noopener"
 					class={buttonClass}
 					aria-label="Search for this episode on Spotify"
+					data-track="podcast_listen"
+					data-track-label="spotify"
+					data-track-target={spotifyUrl}
 				>
 					<svg class="size-5" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true">
 						<path d="M12 0C5.4 0 0 5.4 0 12s5.4 12 12 12 12-5.4 12-12S18.66 0 12 0Zm5.521 17.34c-.24.359-.66.48-1.021.24-2.82-1.74-6.36-2.101-10.561-1.141-.418.122-.779-.179-.899-.539-.12-.421.18-.78.54-.9 4.56-1.021 8.52-.6 11.64 1.32.42.18.479.659.301 1.02Zm1.44-3.3c-.301.42-.841.6-1.262.3-3.239-1.98-8.159-2.58-11.939-1.38-.479.12-1.02-.12-1.14-.6-.12-.48.12-1.021.6-1.141C9.6 9.9 15 10.561 18.72 12.84c.361.181.54.78.241 1.2Zm.12-3.36C15.24 8.4 8.82 8.16 5.16 9.301c-.6.179-1.2-.181-1.38-.721-.18-.601.18-1.2.72-1.381 4.26-1.26 11.28-1.02 15.721 1.621.539.3.719 1.02.419 1.56-.299.421-1.02.599-1.559.3Z" />
@@ -54,6 +57,9 @@ const buttonClass =
 					rel="noreferrer noopener"
 					class={buttonClass}
 					aria-label="Listen on Apple Podcasts"
+					data-track="podcast_listen"
+					data-track-label="apple_podcasts"
+					data-track-target={appleUrl}
 				>
 					<svg class="size-5" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true">
 						<path d="M5.34 0A5.328 5.328 0 0 0 0 5.34v13.32A5.328 5.328 0 0 0 5.34 24h13.32A5.328 5.328 0 0 0 24 18.66V5.34A5.328 5.328 0 0 0 18.66 0Zm6.525 2.568c2.336 0 4.448.902 6.056 2.587 1.224 1.272 1.912 2.619 2.264 4.392.12.59.12 2.2.007 2.864a8.506 8.506 0 0 1-3.24 5.296c-.608.46-2.096 1.261-2.336 1.261-.088 0-.096-.091-.056-.46.072-.592.144-.715.48-.856.535-.224 1.447-.874 2.008-1.435a7.644 7.644 0 0 0 2.008-3.536c.208-.824.184-2.656-.048-3.504-.728-2.672-2.512-4.544-5.096-5.336-.784-.24-2.44-.336-3.384-.2-2.36.32-4.448 1.664-5.616 3.616-1.096 1.832-1.264 4.24-.44 6.224.6 1.448 1.784 2.792 3.048 3.472.28.152.352.28.416.72.048.36.024.44-.056.44-.048 0-.416-.16-.816-.36l-.024-.008c-1.472-.72-2.72-2.032-3.448-3.648-1.472-3.248-.688-7.02 1.928-9.352 1.72-1.53 3.88-2.28 6.344-2.28z" />
@@ -67,6 +73,9 @@ const buttonClass =
 						rel="noreferrer noopener"
 						class={buttonClass}
 						aria-label="Watch on YouTube"
+						data-track="podcast_listen"
+						data-track-label="youtube"
+						data-track-target={youtubeUrl}
 					>
 						<svg class="size-5" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true">
 							<path d="M23.498 6.186a3.016 3.016 0 0 0-2.122-2.136C19.505 3.545 12 3.545 12 3.545s-7.505 0-9.377.505A3.017 3.017 0 0 0 .502 6.186C0 8.07 0 12 0 12s0 3.93.502 5.814a3.016 3.016 0 0 0 2.122 2.136c1.871.505 9.376.505 9.376.505s7.505 0 9.377-.505a3.015 3.015 0 0 0 2.122-2.136C24 15.93 24 12 24 12s0-3.93-.502-5.814ZM9.545 15.568V8.432L15.818 12l-6.273 3.568Z" />
diff --git a/apps/site/src/components/SponsorCard.astro b/apps/site/src/components/SponsorCard.astro
index 49c5b156a..3583d49bd 100644
--- a/apps/site/src/components/SponsorCard.astro
+++ b/apps/site/src/components/SponsorCard.astro
@@ -31,6 +31,9 @@ const items = sponsors ?? [];
 						href={href}
 						target={external ? "_blank" : undefined}
 						rel={external ? "noopener noreferrer sponsored" : undefined}
+						data-track="sponsor_click"
+						data-track-label={sponsor.title}
+						data-track-target={href}
 						class="flex"
 					>
 						<article class="flex max-w-xl grow flex-col overflow-hidden rounded-xl border border-border bg-card shadow-md transition-all hover:scale-[1.02] hover:shadow-lg">
diff --git a/apps/site/src/layouts/BaseLayout.astro b/apps/site/src/layouts/BaseLayout.astro
index 5cf55a5e0..845d0f8a5 100644
--- a/apps/site/src/layouts/BaseLayout.astro
+++ b/apps/site/src/layouts/BaseLayout.astro
@@ -3,6 +3,7 @@ import { Font } from "astro:assets";
 import "@/styles/global.css";
 
 import ChatModal from "@/components/ChatModal.astro";
+import AnalyticsBeacon from "@/components/AnalyticsBeacon.astro";
 import DraftModeToggle from "@/components/DraftModeToggle.astro";
 import Footer from "@/components/Footer.astro";
 import Header from "@/components/Header.astro";
@@ -192,5 +193,6 @@ const graph = buildGraph([
 		</div>
 		{preview && <DraftModeToggle />}
 		<ChatModal />
+		<AnalyticsBeacon />
 	</body>
 </html>
diff --git a/apps/site/src/lib/analytics.ts b/apps/site/src/lib/analytics.ts
new file mode 100644
index 000000000..4437ae361
--- /dev/null
+++ b/apps/site/src/lib/analytics.ts
@@ -0,0 +1,231 @@
+/**
+ * Cloudflare Workers Analytics Engine — Zero-Overhead Edge & Click Telemetry
+ *
+ * Schema Mapping (`codingcat_events_prod` / `codingcat_events_dev`):
+ * - `index1`: `actorCategory` ("ai_bot" | "search_bot" | "social_bot" | "agent_client" | "human" | "client_event")
+ * - `blob1`:  `eventType` ("page_view" | "markdown_read" | "bot_crawl" | "mcp_call" | "search_api" | "chat_api" | "outbound_click" | "podcast_listen" | "sponsor_click" | "ui_interaction" | "lms_event")
+ * - `blob2`:  `pathname` (e.g. "/post/dockerless-serverless-gpus...")
+ * - `blob3`:  `actorName` (e.g. "GPTBot", "ClaudeBot", "PerplexityBot", "browser", etc.)
+ * - `blob4`:  `targetOrDetail` (e.g. clicked URL, MCP tool name, search query, or Referer host)
+ * - `blob5`:  `refererHost` (e.g. "www.google.com", "dev.to", "news.ycombinator.com", "direct")
+ * - `blob6`:  `country` (e.g. "US", "GB", "DE")
+ * - `double1`: `statusCode` (e.g. 200, 404)
+ * - `double2`: `durationMs` (edge response latency in ms or client event value)
+ *
+ * Example Cloudflare Analytics Engine SQL Queries:
+ * 1. Top AI Bots & Agents Crawling CodingCat.dev:
+ *    SELECT blob3 AS bot, blob1 AS event_type, count() AS hits
+ *    FROM codingcat_events_prod
+ *    WHERE index1 IN ('ai_bot', 'agent_client')
+ *    GROUP BY bot, event_type ORDER BY hits DESC
+ *
+ * 2. Most Clicked Outbound / Sponsor / Podcast Links:
+ *    SELECT blob1 AS event_type, blob2 AS page, blob4 AS target_url, count() AS clicks
+ *    FROM codingcat_events_prod
+ *    WHERE index1 = 'client_event'
+ *    GROUP BY event_type, page, target_url ORDER BY clicks DESC
+ */
+
+export type ActorCategory =
+	| "ai_bot"
+	| "search_bot"
+	| "social_bot"
+	| "agent_client"
+	| "human"
+	| "client_event";
+
+export interface AnalyticsEngineDataset {
+	writeDataPoint(event: {
+		indexes?: [string];
+		blobs?: string[];
+		doubles?: number[];
+	}): void;
+}
+
+const AI_BOT_PATTERNS: Array<[RegExp, string]> = [
+	[/GPTBot/i, "GPTBot"],
+	[/OAI-SearchBot/i, "OAI-SearchBot"],
+	[/ChatGPT-User/i, "ChatGPT-User"],
+	[/ClaudeBot/i, "ClaudeBot"],
+	[/Claude-Web/i, "Claude-Web"],
+	[/anthropic-ai/i, "Anthropic-AI"],
+	[/PerplexityBot/i, "PerplexityBot"],
+	[/Perplexity-User/i, "Perplexity-User"],
+	[/Google-Extended/i, "Google-Extended"],
+	[/Applebot-Extended/i, "Applebot-Extended"],
+	[/Meta-ExternalAgent|FacebookBot/i, "Meta-AI"],
+	[/Bytespider/i, "Bytespider"],
+	[/CCBot/i, "CCBot"],
+	[/cohere-ai/i, "Cohere-AI"],
+	[/YouBot/i, "YouBot"],
+	[/Amazonbot/i, "Amazonbot"],
+	[/DuckAssistBot/i, "DuckAssistBot"],
+];
+
+const SEARCH_BOT_PATTERNS: Array<[RegExp, string]> = [
+	[/Googlebot/i, "Googlebot"],
+	[/bingbot/i, "Bingbot"],
+	[/DuckDuckBot/i, "DuckDuckBot"],
+	[/YandexBot/i, "YandexBot"],
+	[/Baiduspider/i, "Baiduspider"],
+];
+
+const SOCIAL_BOT_PATTERNS: Array<[RegExp, string]> = [
+	[/Twitterbot/i, "Twitterbot"],
+	[/LinkedInBot/i, "LinkedInBot"],
+	[/Slackbot/i, "Slackbot"],
+	[/Discordbot/i, "Discordbot"],
+	[/facebookexternalhit/i, "FacebookPreview"],
+	[/WhatsApp/i, "WhatsApp"],
+	[/TelegramBot/i, "TelegramBot"],
+];
+
+export function classifyActor(
+	userAgent: string,
+	wantsMarkdown: boolean,
+	pathname: string,
+): { category: ActorCategory; actorName: string } {
+	for (const [regex, name] of AI_BOT_PATTERNS) {
+		if (regex.test(userAgent)) {
+			return { category: "ai_bot", actorName: name };
+		}
+	}
+	for (const [regex, name] of SEARCH_BOT_PATTERNS) {
+		if (regex.test(userAgent)) {
+			return { category: "search_bot", actorName: name };
+		}
+	}
+	for (const [regex, name] of SOCIAL_BOT_PATTERNS) {
+		if (regex.test(userAgent)) {
+			return { category: "social_bot", actorName: name };
+		}
+	}
+	if (
+		wantsMarkdown ||
+		pathname.startsWith("/api/mcp") ||
+		pathname.startsWith("/.well-known/") ||
+		pathname === "/llms.txt" ||
+		/curl|python|node|undici|axios|got|claude-code|mcp/i.test(userAgent)
+	) {
+		const shortUa = userAgent.split(" ")[0]?.slice(0, 48) || "agent";
+		return { category: "agent_client", actorName: shortUa };
+	}
+	return { category: "human", actorName: "browser" };
+}
+
+function extractHost(urlStr: string | null): string {
+	if (!urlStr) return "direct";
+	try {
+		return new URL(urlStr).hostname || "direct";
+	} catch {
+		return "direct";
+	}
+}
+
+export function trackEdgeRequest(options: {
+	env: Record<string, unknown>;
+	request: Request;
+	pathname: string;
+	statusCode: number;
+	durationMs: number;
+	wantsMarkdown: boolean;
+	detail?: string;
+}): void {
+	const dataset = options.env.ANALYTICS as AnalyticsEngineDataset | undefined;
+	if (!dataset || typeof dataset.writeDataPoint !== "function") return;
+
+	const { request, pathname, statusCode, durationMs, wantsMarkdown } = options;
+
+	// Skip static asset noise (_astro/*, favicons, images)
+	if (
+		pathname.startsWith("/_astro/") ||
+		pathname.startsWith("/favicon") ||
+		pathname.endsWith(".png") ||
+		pathname.endsWith(".ico") ||
+		pathname.endsWith(".svg") ||
+		pathname.endsWith(".woff2")
+	) {
+		return;
+	}
+
+	const userAgent = request.headers.get("user-agent") || "";
+	const { category, actorName } = classifyActor(
+		userAgent,
+		wantsMarkdown,
+		pathname,
+	);
+
+	let eventType = "page_view";
+	if (wantsMarkdown) {
+		eventType = "markdown_read";
+	} else if (pathname.startsWith("/api/mcp")) {
+		eventType = "mcp_call";
+	} else if (pathname.startsWith("/api/search")) {
+		eventType = "search_api";
+	} else if (pathname.startsWith("/api/chat")) {
+		eventType = "chat_api";
+	} else if (category === "ai_bot" || category === "search_bot" || category === "social_bot") {
+		eventType = "bot_crawl";
+	}
+
+	const refererHost = extractHost(request.headers.get("referer"));
+	const cf = (request as Request & { cf?: { country?: string } }).cf;
+	const country =
+		cf?.country || request.headers.get("cf-ipcountry") || "XX";
+	const targetOrDetail =
+		options.detail ||
+		new URL(request.url).searchParams.get("q") ||
+		refererHost;
+
+	try {
+		dataset.writeDataPoint({
+			indexes: [category],
+			blobs: [
+				eventType,
+				pathname.slice(0, 256),
+				actorName.slice(0, 64),
+				targetOrDetail.slice(0, 256),
+				refererHost.slice(0, 128),
+				country.slice(0, 8),
+			],
+			doubles: [statusCode, Math.round(durationMs)],
+		});
+	} catch {
+		// Never fail a user request due to telemetry
+	}
+}
+
+export function trackClientBeaconEvent(options: {
+	env: Record<string, unknown>;
+	request: Request;
+	eventType: string;
+	pathname: string;
+	target?: string;
+	label?: string;
+	value?: number;
+}): void {
+	const dataset = options.env.ANALYTICS as AnalyticsEngineDataset | undefined;
+	if (!dataset || typeof dataset.writeDataPoint !== "function") return;
+
+	const refererHost = extractHost(options.request.headers.get("referer"));
+	const cf = (options.request as Request & { cf?: { country?: string } }).cf;
+	const country =
+		cf?.country || options.request.headers.get("cf-ipcountry") || "XX";
+
+	try {
+		dataset.writeDataPoint({
+			indexes: ["client_event"],
+			blobs: [
+				options.eventType.slice(0, 64),
+				options.pathname.slice(0, 256),
+				(options.label || "interaction").slice(0, 128),
+				(options.target || "").slice(0, 256),
+				refererHost.slice(0, 128),
+				country.slice(0, 8),
+			],
+			doubles: [200, Math.round(options.value ?? 1)],
+		});
+	} catch {
+		// Never fail beacon response
+	}
+}
diff --git a/apps/site/src/middleware.ts b/apps/site/src/middleware.ts
index af6a7a1a8..67c899c9f 100644
--- a/apps/site/src/middleware.ts
+++ b/apps/site/src/middleware.ts
@@ -1,5 +1,6 @@
 import { defineMiddleware } from "astro:middleware";
 import { env } from "cloudflare:workers";
+import { trackEdgeRequest } from "@/lib/analytics";
 import { htmlToMarkdown } from "@/lib/html-to-markdown";
 import { createSanityContext, PREVIEW_COOKIE } from "@/lib/sanity/context";
 import { resolveSiteUrl } from "@/lib/site";
@@ -17,6 +18,7 @@ import { resolveSiteUrl } from "@/lib/site";
  * - Dynamic /index.md and *.md path rewriting to serve markdown versions of all pages
  */
 export const onRequest = defineMiddleware(async (context, next) => {
+	const startTime = performance.now();
 	// `Astro.site` is baked in at build time, but SITE_URL is a per-environment
 	// wrangler var and CI builds once for both. Without this, the dev Worker
 	// would emit canonical and og:url values pointing at production.
@@ -119,6 +121,15 @@ export const onRequest = defineMiddleware(async (context, next) => {
 		headers.set("content-type", "text/markdown; charset=utf-8");
 		headers.delete("content-length");
 
+		trackEdgeRequest({
+			env: env as unknown as Record<string, unknown>,
+			request: context.request,
+			pathname,
+			statusCode: response.status,
+			durationMs: performance.now() - startTime,
+			wantsMarkdown: true,
+		});
+
 		return new Response(markdown, {
 			status: response.status,
 			statusText: response.statusText,
@@ -126,5 +137,16 @@ export const onRequest = defineMiddleware(async (context, next) => {
 		});
 	}
 
+	if (!pathname.startsWith("/ingest") && pathname !== "/api/event") {
+		trackEdgeRequest({
+			env: env as unknown as Record<string, unknown>,
+			request: context.request,
+			pathname,
+			statusCode: response.status,
+			durationMs: performance.now() - startTime,
+			wantsMarkdown: isDedicatedMarkdownEndpoint,
+		});
+	}
+
 	return response;
 });
diff --git a/apps/site/src/pages/api/event.ts b/apps/site/src/pages/api/event.ts
new file mode 100644
index 000000000..3e39ec042
--- /dev/null
+++ b/apps/site/src/pages/api/event.ts
@@ -0,0 +1,44 @@
+import type { APIRoute } from "astro";
+import { env } from "cloudflare:workers";
+import { trackClientBeaconEvent } from "@/lib/analytics";
+
+/**
+ * First-party beacon endpoint (`POST /api/event`) for zero-overhead client click
+ * and LMS interaction tracking via `navigator.sendBeacon`.
+ *
+ * Writes directly to Cloudflare Workers Analytics Engine (`env.ANALYTICS.writeDataPoint`).
+ */
+export const POST: APIRoute = async ({ request }) => {
+	try {
+		const raw = await request.text();
+		if (!raw) {
+			return new Response(null, { status: 204 });
+		}
+		const payload = JSON.parse(raw) as {
+			type?: string;
+			path?: string;
+			target?: string;
+			label?: string;
+			value?: number;
+		};
+
+		trackClientBeaconEvent({
+			env: env as unknown as Record<string, unknown>,
+			request,
+			eventType: payload.type || "ui_interaction",
+			pathname: payload.path || "/",
+			target: payload.target,
+			label: payload.label,
+			value: typeof payload.value === "number" ? payload.value : 1,
+		});
+	} catch {
+		// Always return 204 for beacons
+	}
+
+	return new Response(null, {
+		status: 204,
+		headers: {
+			"cache-control": "no-store",
+		},
+	});
+};
diff --git a/apps/site/src/pages/ingest/[...path].ts b/apps/site/src/pages/ingest/[...path].ts
new file mode 100644
index 000000000..fff354269
--- /dev/null
+++ b/apps/site/src/pages/ingest/[...path].ts
@@ -0,0 +1,63 @@
+import type { APIRoute } from "astro";
+import { env } from "cloudflare:workers";
+
+/**
+ * First-party Cloudflare Worker Reverse Proxy for PostHog (`/ingest/*`).
+ *
+ * Why: ~40%+ of developers use adblockers (uBlock Origin, Brave) that block
+ * `posthog.com` and third-party analytics domains. Routing PostHog through
+ * `https://codingcat.dev/ingest/*` ensures 100% of visitor flows, clicks, and
+ * LMS course conversion funnels are captured over the existing HTTP/3 connection.
+ *
+ * Routes:
+ * - `/ingest/static/*` -> `https://us-assets.i.posthog.com/static/*`
+ * - `/ingest/*`        -> `https://us.i.posthog.com/*`
+ */
+const DEFAULT_API_HOST = "https://us.i.posthog.com";
+const DEFAULT_ASSETS_HOST = "https://us-assets.i.posthog.com";
+
+export const ALL: APIRoute = async ({ request, params }) => {
+	const runtimeEnv = env as unknown as Record<string, string | undefined>;
+	const apiHost = runtimeEnv.PUBLIC_POSTHOG_HOST || DEFAULT_API_HOST;
+	const assetsHost = apiHost.includes("eu.")
+		? "https://eu-assets.i.posthog.com"
+		: DEFAULT_ASSETS_HOST;
+
+	const subPath = params.path || "";
+	const url = new URL(request.url);
+	const isStaticAsset = subPath.startsWith("static/");
+	const targetOrigin = isStaticAsset ? assetsHost : apiHost;
+	const targetUrl = `${targetOrigin}/${subPath}${url.search}`;
+
+	const headers = new Headers(request.headers);
+	headers.delete("cookie");
+	headers.set("host", new URL(targetOrigin).host);
+
+	const clientIp = request.headers.get("cf-connecting-ip");
+	if (clientIp) {
+		headers.set("x-forwarded-for", clientIp);
+	}
+
+	try {
+		const upstreamResponse = await fetch(targetUrl, {
+			method: request.method,
+			headers,
+			body:
+				request.method !== "GET" && request.method !== "HEAD"
+					? await request.arrayBuffer()
+					: undefined,
+			redirect: "manual",
+		});
+
+		const responseHeaders = new Headers(upstreamResponse.headers);
+		responseHeaders.delete("set-cookie");
+
+		return new Response(upstreamResponse.body, {
+			status: upstreamResponse.status,
+			statusText: upstreamResponse.statusText,
+			headers: responseHeaders,
+		});
+	} catch {
+		return new Response(null, { status: 204 });
+	}
+};
diff --git a/apps/site/wrangler.jsonc b/apps/site/wrangler.jsonc
index 05a923560..821c565ab 100644
--- a/apps/site/wrangler.jsonc
+++ b/apps/site/wrangler.jsonc
@@ -11,6 +11,12 @@
   "observability": { "enabled": true, "head_sampling_rate": 1 },
   "workers_dev": true,
   "ai": { "binding": "AI" },
+  "analytics_engine_datasets": [
+    {
+      "binding": "ANALYTICS",
+      "dataset": "codingcat_events_dev"
+    }
+  ],
   "routes": [
     {
       "pattern": "dev.codingcat.dev",
@@ -42,13 +48,19 @@
         }
       ],
       "ai": { "binding": "AI" },
+      "analytics_engine_datasets": [
+        {
+          "binding": "ANALYTICS",
+          "dataset": "codingcat_events_prod"
+        }
+      ],
       "observability": { "enabled": true, "head_sampling_rate": 0.1 },
       "vars": {
         "ENVIRONMENT": "production",
         "PUBLIC_SANITY_PROJECT_ID": "hfh83o0w",
         "PUBLIC_SANITY_DATASET": "production",
         "PUBLIC_SANITY_API_VERSION": "2025-09-30",
-        "PUBLIC_SANITY_STUDIO_URL": "https://codingcat.dev.sanity.studio/production",
+        "PUBLIC_SANITY_STUDIO_URL": "https://codingcat-dev.sanity.studio/production",
         "SITE_URL": "https://codingcat.dev"
       }
     }