@arthurreira/analytics 0.7.0 → 0.9.0

package/dist/client.d.ts

@@ -1,10 +1,13 @@
 interface AnalyticsProps {
     apiKey: string;
     apiUrl: string;
+    wsUrl?: string;
 }
-declare function Analytics({ apiKey, apiUrl }: AnalyticsProps): null;
+declare function Analytics({ apiKey, apiUrl, wsUrl }: AnalyticsProps): null;
 
-declare function useAnalytics(apiUrl: string, apiKey: string): {
+declare function useAnalytics(apiUrl: string, apiKey: string, options?: {
+    wsUrl?: string;
+}): {
     trackPageview: (path: string) => void;
     trackClick: (e: MouseEvent, element: HTMLElement) => void;
     trackScroll: (depth: number) => void;

package/dist/client.js

@@ -54,7 +54,7 @@ async function createSession(apiUrl, apiKey, visitorId) {
   const response = await fetch(`${apiUrl}/sessions`, {
     method: "POST",
     headers: {
-      "Authorization": `Bearer ${apiKey}`,
+      "X-API-Key": apiKey,
       "Content-Type": "application/json"
     },
     body: JSON.stringify(sessionData)
@@ -66,7 +66,7 @@ async function sendEvent(apiUrl, apiKey, payload) {
   await fetch(`${apiUrl}/events`, {
     method: "POST",
     headers: {
-      "Authorization": `Bearer ${apiKey}`,
+      "X-API-Key": apiKey,
       "Content-Type": "application/json"
     },
     body: JSON.stringify(payload)
@@ -124,6 +124,50 @@ async function trackCTA(apiUrl, apiKey, sessionId, path, ctaId, ctaVariant) {
   });
 }
 
+// src/lib/presence.ts
+var DEFAULT_WS_URL = "wss://edge.arthurreira.dev/realtime";
+function connectPresence(apiKey, sessionId, wsUrl = DEFAULT_WS_URL) {
+  if (typeof WebSocket === "undefined") {
+    return { disconnect: () => {
+    } };
+  }
+  let ws = null;
+  let attempts = 0;
+  let intentionalClose = false;
+  let retryTimer = null;
+  function connect() {
+    try {
+      ws = new WebSocket(wsUrl);
+    } catch {
+      return;
+    }
+    ws.onopen = () => {
+      attempts = 0;
+      ws.send(JSON.stringify({ type: "join", api_key: apiKey, session_id: sessionId }));
+    };
+    ws.onclose = () => {
+      if (intentionalClose || attempts >= 3) return;
+      const delay = Math.pow(2, attempts) * 1e3;
+      attempts++;
+      retryTimer = setTimeout(connect, delay);
+    };
+  }
+  connect();
+  return {
+    disconnect: () => {
+      intentionalClose = true;
+      if (retryTimer !== null) {
+        clearTimeout(retryTimer);
+        retryTimer = null;
+      }
+      if (ws) {
+        ws.close();
+        ws = null;
+      }
+    }
+  };
+}
+
 // src/hooks/useAnalytics.ts
 var SESSION_EXPIRY_MINUTES = 30;
 async function getOrCreateSession(apiUrl, apiKey, visitorId) {
@@ -142,16 +186,18 @@ async function getOrCreateSession(apiUrl, apiKey, visitorId) {
   localStorage.setItem("af_session_last_activity", String(now));
   return newSessionId;
 }
-function useAnalytics(apiUrl, apiKey) {
+function useAnalytics(apiUrl, apiKey, options) {
   const sessionId = useRef(null);
   const pendingEvents = useRef([]);
   const pathname = useRef(typeof window !== "undefined" ? window?.location?.pathname ?? "" : "");
+  const presence = useRef(null);
   useEffect(() => {
     if (typeof window === "undefined") return;
     const visitor_id = localStorage.getItem("af_analytics_visitor_id") || crypto.randomUUID();
     localStorage.setItem("af_analytics_visitor_id", visitor_id);
     getOrCreateSession(apiUrl, apiKey, visitor_id).then((id) => {
       sessionId.current = id;
+      presence.current = connectPresence(apiKey, id, options?.wsUrl);
       pendingEvents.current.forEach((fn) => fn());
       pendingEvents.current = [];
     });
@@ -160,6 +206,8 @@ function useAnalytics(apiUrl, apiKey) {
     if (typeof window === "undefined") return;
     const sendEnd = () => {
       if (!sessionId.current) return;
+      presence.current?.disconnect();
+      presence.current = null;
       navigator.sendBeacon(`${apiUrl}/sessions/${sessionId.current}/end`);
       localStorage.removeItem("af_session_id");
       localStorage.removeItem("af_session_last_activity");
@@ -209,8 +257,8 @@ function useAnalytics(apiUrl, apiKey) {
 }
 
 // src/components/Analytics.tsx
-function Analytics({ apiKey, apiUrl }) {
-  const { trackPageview: trackPageview2, trackClick: trackClick2, trackScroll: trackScroll2, trackCopy: trackCopy2, trackError: trackError2 } = useAnalytics(apiUrl, apiKey);
+function Analytics({ apiKey, apiUrl, wsUrl }) {
+  const { trackPageview: trackPageview2, trackClick: trackClick2, trackScroll: trackScroll2, trackCopy: trackCopy2, trackError: trackError2 } = useAnalytics(apiUrl, apiKey, { wsUrl });
   const lastTracked = useRef2(null);
   const lastScrollDepth = useRef2(0);
   const pathname = typeof window !== "undefined" ? window.location.pathname : "";

package/dist/index.js

@@ -45,7 +45,7 @@ async function createSession(apiUrl, apiKey, visitorId) {
   const response = await fetch(`${apiUrl}/sessions`, {
     method: "POST",
     headers: {
-      "Authorization": `Bearer ${apiKey}`,
+      "X-API-Key": apiKey,
       "Content-Type": "application/json"
     },
     body: JSON.stringify(sessionData)
@@ -57,7 +57,7 @@ async function sendEvent(apiUrl, apiKey, payload) {
   await fetch(`${apiUrl}/events`, {
     method: "POST",
     headers: {
-      "Authorization": `Bearer ${apiKey}`,
+      "X-API-Key": apiKey,
       "Content-Type": "application/json"
     },
     body: JSON.stringify(payload)

package/package.json

@@ -1,5 +1,5 @@
   {  "name": "@arthurreira/analytics",
-    "version": "0.7.0",
+    "version": "0.9.0",
     "type": "module",
     "scripts": {
       "build": "tsup",