@arthurreira/analytics 0.8.0 → 0.10.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

@@ -124,6 +124,60 @@ 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;
+  let targetUrl;
+  try {
+    const u = new URL(wsUrl);
+    u.searchParams.set("api_key", apiKey);
+    u.searchParams.set("session_id", sessionId);
+    targetUrl = u.toString();
+  } catch {
+    return { disconnect: () => {
+    } };
+  }
+  function connect() {
+    try {
+      ws = new WebSocket(targetUrl);
+    } 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,24 +196,33 @@ 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);
+    let cancelled = false;
     getOrCreateSession(apiUrl, apiKey, visitor_id).then((id) => {
+      if (cancelled) return;
       sessionId.current = id;
+      presence.current = connectPresence(apiKey, id, options?.wsUrl);
       pendingEvents.current.forEach((fn) => fn());
       pendingEvents.current = [];
     });
+    return () => {
+      cancelled = true;
+    };
   }, []);
   useEffect(() => {
     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 +272,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.d.ts

@@ -7,4 +7,10 @@ declare function trackSearch(apiUrl: string, apiKey: string, sessionId: string,
 declare function trackError(apiUrl: string, apiKey: string, sessionId: string, path: string, error: Error): Promise<void>;
 declare function trackCTA(apiUrl: string, apiKey: string, sessionId: string, path: string, ctaId: string, ctaVariant?: string): Promise<void>;
 
-export { createSession, trackCTA, trackClick, trackCopy, trackError, trackPageview, trackScroll, trackSearch };
+declare const DEFAULT_WS_URL = "wss://edge.arthurreira.dev/realtime";
+interface PresenceConnection {
+    disconnect: () => void;
+}
+declare function connectPresence(apiKey: string, sessionId: string, wsUrl?: string): PresenceConnection;
+
+export { DEFAULT_WS_URL, type PresenceConnection, connectPresence, createSession, trackCTA, trackClick, trackCopy, trackError, trackPageview, trackScroll, trackSearch };

package/dist/index.js

@@ -114,7 +114,63 @@ async function trackCTA(apiUrl, apiKey, sessionId, path, ctaId, ctaVariant) {
     cta_variant: ctaVariant || null
   });
 }
+
+// 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;
+  let targetUrl;
+  try {
+    const u = new URL(wsUrl);
+    u.searchParams.set("api_key", apiKey);
+    u.searchParams.set("session_id", sessionId);
+    targetUrl = u.toString();
+  } catch {
+    return { disconnect: () => {
+    } };
+  }
+  function connect() {
+    try {
+      ws = new WebSocket(targetUrl);
+    } 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;
+      }
+    }
+  };
+}
 export {
+  DEFAULT_WS_URL,
+  connectPresence,
   createSession,
   trackCTA,
   trackClick,

package/package.json

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