feat(analytics): add integration for external page entry tracking via Cloudflare Workers

Author: Keshav-writes-code

astro.config.mjs

@@ -1,6 +1,7 @@
 // @ts-check
 import { defineConfig } from "astro/config";
 import starlight from "@astrojs/starlight";
+import { analytics } from "./src/integrations/analytics";
 
 // https://astro.build/config
 export default defineConfig({
@@ -36,6 +37,7 @@ export default defineConfig({
         "./src/styles/custom.css",
       ],
     }),
+    analytics(),
   ],
   site: "https://keshav.is-a.dev",
   base: "FreqKnow",

src/integrations/analytics.ts

@@ -0,0 +1,35 @@
+import type { AstroIntegration } from "astro";
+
+export function analytics(): AstroIntegration {
+  return {
+    name: "analytics",
+    hooks: {
+      "astro:config:setup": ({ injectScript }) => {
+        injectScript(
+          "page",
+          `
+const API_URL = "https://freq-know-analytics.dhimankeshav201.workers.dev/track/";
+
+export function trackPageEntry() {
+  // Don't track in development
+  if (window.location.hostname === "localhost") return;
+
+  const referrer = document.referrer;
+  const currentDomain = window.location.hostname;
+
+  // Check if referrer is from a different domain (or no referrer = direct visit)
+  const isExternalEntry =
+    !referrer || (referrer && new URL(referrer).hostname !== currentDomain);
+
+  if (isExternalEntry) {
+    fetch(API_URL, {
+      method: "GET",
+    }).catch(() => {}); // Silent fail
+  }
+}
+        `,
+        );
+      },
+    },
+  };
+}