@arthurreira/analytics 0.18.0 → 0.20.0

package/dist/af-analytics.umd.js

@@ -38,20 +38,47 @@ var AfAnalytics = (() => {
   // src/vanilla.ts
   var vanilla_exports = {};
   __export(vanilla_exports, {
-    init: () => init
+    consent: () => consent,
+    init: () => init,
+    isOptedOut: () => isOptedOut,
+    optIn: () => optIn,
+    optOut: () => optOut
   });
+
+  // src/lib/consent.ts
+  var CONSENT_KEY = "af_analytics_opted_out";
+  function optOut() {
+    if (typeof localStorage === "undefined") return;
+    localStorage.setItem(CONSENT_KEY, "1");
+  }
+  function optIn() {
+    if (typeof localStorage === "undefined") return;
+    localStorage.removeItem(CONSENT_KEY);
+  }
+  function isOptedOut() {
+    if (typeof localStorage !== "undefined" && localStorage.getItem(CONSENT_KEY) === "1") return true;
+    if (typeof navigator !== "undefined" && navigator.doNotTrack === "1") return true;
+    return false;
+  }
+  function consent(enabled) {
+    if (enabled) optIn();
+    else optOut();
+  }
+
+  // src/vanilla.ts
   var _currentScript = document.currentScript;
   var SESSION_EXPIRY_MS = 30 * 60 * 1e3;
   var IDLE_TOUCH_INTERVAL_MS = 5 * 60 * 1e3;
   var BC_CHANNEL = "af_analytics_session";
   var BC_ADOPT_TIMEOUT_MS = 50;
   function readConfig() {
-    var _a, _b, _c, _d;
+    var _a, _b, _c, _d, _e, _f;
     const script = _currentScript != null ? _currentScript : document.querySelector("script[data-api-key]");
     const apiKey = (_b = (_a = script == null ? void 0 : script.dataset.apiKey) == null ? void 0 : _a.trim()) != null ? _b : "";
     const apiUrl = ((_d = (_c = script == null ? void 0 : script.dataset.url) == null ? void 0 : _c.trim()) != null ? _d : "").replace(/\/$/, "");
     if (!apiKey || !apiUrl) return null;
-    return { apiKey, apiUrl };
+    const wsUrl = (_f = (_e = script == null ? void 0 : script.dataset.wsUrl) == null ? void 0 : _e.trim()) != null ? _f : apiUrl.replace(/^https:\/\//, "wss://").replace(/^http:\/\//, "ws://") + "/realtime";
+    return { apiKey, apiUrl, wsUrl };
   }
   function generateId() {
     if (typeof crypto !== "undefined" && crypto.randomUUID) {
@@ -97,6 +124,7 @@ var AfAnalytics = (() => {
     }
   }
   function send(apiUrl, apiKey, payload) {
+    if (isOptedOut()) return;
     fetch(`${apiUrl}/events`, {
       method: "POST",
       headers: { "X-API-Key": apiKey, "Content-Type": "application/json" },
@@ -157,7 +185,7 @@ var AfAnalytics = (() => {
     return () => channel.close();
   }
   async function createRemoteSession(apiUrl, apiKey, visitorId) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o;
     const nav = navigator;
     const conn = (_c = (_b = (_a = nav["connection"]) != null ? _a : nav["mozConnection"]) != null ? _b : nav["webkitConnection"]) != null ? _c : null;
     const params = new URLSearchParams(window.location.search);
@@ -182,14 +210,22 @@ var AfAnalytics = (() => {
       utm_term: params.get("utm_term"),
       utm_content: params.get("utm_content")
     };
-    const res = await fetch(`${apiUrl}/sessions`, {
-      method: "POST",
-      headers: { "X-API-Key": apiKey, "Content-Type": "application/json" },
-      body: JSON.stringify(body)
-    });
-    if (!res.ok) return "";
-    const data = await res.json();
-    return data.id;
+    for (let attempt = 0; attempt < 3; attempt++) {
+      try {
+        const res = await fetch(`${apiUrl}/sessions`, {
+          method: "POST",
+          headers: { "X-API-Key": apiKey, "Content-Type": "application/json" },
+          body: JSON.stringify(body)
+        });
+        if (res.ok) {
+          const data = await res.json();
+          return (_o = (_n = data.session_id) != null ? _n : data.id) != null ? _o : "";
+        }
+      } catch (e) {
+      }
+      if (attempt < 2) await new Promise((r) => setTimeout(r, 500 * 2 ** attempt));
+    }
+    return "";
   }
   async function getOrCreateSession(apiUrl, apiKey) {
     const stored = getStoredSession();
@@ -235,6 +271,7 @@ var AfAnalytics = (() => {
     send(apiUrl, apiKey, __spreadValues(__spreadValues({}, baseFields(sessionId, "js_exception")), fields));
   }
   function init() {
+    if (isOptedOut()) return;
     const config = readConfig();
     if (!config) return;
     const { apiKey, apiUrl } = config;

package/dist/client.js

@@ -8,6 +8,14 @@ import { usePathname } from "next/navigation";
 // src/hooks/useAnalytics.ts
 import { useEffect, useRef } from "react";
 
+// src/lib/consent.ts
+var CONSENT_KEY = "af_analytics_opted_out";
+function isOptedOut() {
+  if (typeof localStorage !== "undefined" && localStorage.getItem(CONSENT_KEY) === "1") return true;
+  if (typeof navigator !== "undefined" && navigator.doNotTrack === "1") return true;
+  return false;
+}
+
 // src/lib/api.ts
 var BASE_FIELDS = (sessionId, eventType, path) => ({
   session_id: sessionId,
@@ -28,6 +36,7 @@ function getGpu() {
   }
 }
 async function createSession(apiUrl, apiKey, visitorId) {
+  if (isOptedOut()) return null;
   const sessionData = { visitor_id: visitorId };
   if (typeof window !== "undefined") {
     const nav = navigator;
@@ -77,6 +86,7 @@ async function createSession(apiUrl, apiKey, visitorId) {
   }
 }
 async function sendEvent(apiUrl, apiKey, payload) {
+  if (isOptedOut()) return;
   await fetch(`${apiUrl}/events`, {
     method: "POST",
     headers: {
@@ -144,8 +154,7 @@ 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) {
+function connectPresence(apiKey, sessionId, wsUrl) {
   if (typeof WebSocket === "undefined") {
     return { disconnect: () => {
     } };

package/dist/index.d.ts

@@ -1,3 +1,12 @@
+declare function optOut(): void;
+declare function optIn(): void;
+/**
+ * Returns true when the user has opted out via localStorage flag OR
+ * the browser-level DNT header is set to "1".
+ */
+declare function isOptedOut(): boolean;
+declare function consent(enabled: boolean): void;
+
 declare function createSession(apiUrl: string, apiKey: string, visitorId?: string): Promise<string | null>;
 declare function trackPageview(apiUrl: string, apiKey: string, sessionId: string, path: string): Promise<void>;
 declare function trackClick(apiUrl: string, apiKey: string, sessionId: string, path: string, e: MouseEvent, element: HTMLElement): Promise<void>;
@@ -13,10 +22,9 @@ declare function trackException(apiUrl: string, apiKey: string, sessionId: strin
 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>;
 
-declare const DEFAULT_WS_URL = "wss://edge.arthurreira.dev/realtime";
 interface PresenceConnection {
     disconnect: () => void;
 }
-declare function connectPresence(apiKey: string, sessionId: string, wsUrl?: string): PresenceConnection;
+declare function connectPresence(apiKey: string, sessionId: string, wsUrl: string): PresenceConnection;
 
-export { DEFAULT_WS_URL, type ExceptionFields, type PresenceConnection, connectPresence, createSession, trackCTA, trackClick, trackCopy, trackError, trackException, trackPageview, trackScroll, trackSearch };
+export { type ExceptionFields, type PresenceConnection, connectPresence, consent, createSession, isOptedOut, optIn, optOut, trackCTA, trackClick, trackCopy, trackError, trackException, trackPageview, trackScroll, trackSearch };

package/dist/index.js

@@ -1,3 +1,23 @@
+// src/lib/consent.ts
+var CONSENT_KEY = "af_analytics_opted_out";
+function optOut() {
+  if (typeof localStorage === "undefined") return;
+  localStorage.setItem(CONSENT_KEY, "1");
+}
+function optIn() {
+  if (typeof localStorage === "undefined") return;
+  localStorage.removeItem(CONSENT_KEY);
+}
+function isOptedOut() {
+  if (typeof localStorage !== "undefined" && localStorage.getItem(CONSENT_KEY) === "1") return true;
+  if (typeof navigator !== "undefined" && navigator.doNotTrack === "1") return true;
+  return false;
+}
+function consent(enabled) {
+  if (enabled) optIn();
+  else optOut();
+}
+
 // src/lib/api.ts
 var BASE_FIELDS = (sessionId, eventType, path) => ({
   session_id: sessionId,
@@ -18,6 +38,7 @@ function getGpu() {
   }
 }
 async function createSession(apiUrl, apiKey, visitorId) {
+  if (isOptedOut()) return null;
   const sessionData = { visitor_id: visitorId };
   if (typeof window !== "undefined") {
     const nav = navigator;
@@ -67,6 +88,7 @@ async function createSession(apiUrl, apiKey, visitorId) {
   }
 }
 async function sendEvent(apiUrl, apiKey, payload) {
+  if (isOptedOut()) return;
   await fetch(`${apiUrl}/events`, {
     method: "POST",
     headers: {
@@ -134,8 +156,7 @@ 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) {
+function connectPresence(apiKey, sessionId, wsUrl) {
   if (typeof WebSocket === "undefined") {
     return { disconnect: () => {
     } };
@@ -204,9 +225,12 @@ function connectPresence(apiKey, sessionId, wsUrl = DEFAULT_WS_URL) {
   };
 }
 export {
-  DEFAULT_WS_URL,
   connectPresence,
+  consent,
   createSession,
+  isOptedOut,
+  optIn,
+  optOut,
   trackCTA,
   trackClick,
   trackCopy,

package/package.json

@@ -1,12 +1,7 @@
 {
   "name": "@arthurreira/analytics",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "type": "module",
-  "scripts": {
-    "build": "tsup",
-    "prepare": "tsup",
-    "dev": "tsup src/index.ts --format esm --dts --watch"
-  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -37,5 +32,9 @@
   "peerDependencies": {
     "next": "^14.0.0 || ^15.0.0 || ^16.0.0",
     "react": "^18.0.0 || ^19.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup src/index.ts --format esm --dts --watch"
   }
 }