@nexushub/client 0.2.9 → 0.3.0

package/dist/index.cjs

@@ -1626,6 +1626,7 @@ var AnalyticsEngine = class {
   constructor(config) {
     this.cleanupFns = [];
     this.isInitialized = false;
+    this.lastPath = typeof window !== "undefined" ? window.location.pathname : "";
     this.tracker = new Tracker(config);
   }
   start() {
@@ -1641,14 +1642,18 @@ var AnalyticsEngine = class {
       console.log("[NexusHub] \u{1F680} Analytics Engine Started");
     }
   }
-  pageView() {
+  pageView(customReferrer) {
     if (typeof window === "undefined") return;
+    const currentPath = window.location.pathname;
     this.tracker.send("page_view", {
-      path: window.location.pathname,
+      path: currentPath,
       search: window.location.search,
       title: document.title,
-      timezone_offset: (/* @__PURE__ */ new Date()).getTimezoneOffset()
+      timezone_offset: (/* @__PURE__ */ new Date()).getTimezoneOffset(),
+      // Use the virtual path as referrer if navigating internally
+      referrer: customReferrer || (this.lastPath !== currentPath ? this.lastPath : document.referrer)
     });
+    this.lastPath = currentPath;
   }
   // --- SOCIAL / DARK SOCIAL TRACKING ---
   setupShareTracking() {
@@ -1775,7 +1780,8 @@ var AnalyticsEngine = class {
           text: _optionalChain([link, 'access', _29 => _29.innerText, 'optionalAccess', _30 => _30.substring, 'call', _31 => _31(0, 50)]),
           id: link.id,
           classes: link.className,
-          dataset: { ...link.dataset }
+          dataset: { ...link.dataset },
+          coordinates: { x: e.clientX, y: e.clientY }
         });
       }
       const button = target.closest("button");
@@ -1818,13 +1824,20 @@ var AnalyticsEngine = class {
     const originalPushState = history.pushState.bind(history);
     const originalReplaceState = history.replaceState.bind(history);
     history.pushState = (...args) => {
+      const prevPath = window.location.pathname;
       originalPushState(...args);
-      this.pageView();
+      if (!this.isInitializedByReactProvider()) {
+        this.pageView(prevPath);
+      }
     };
     history.replaceState = (...args) => {
       originalReplaceState(...args);
     };
-    const popStateHandler = () => this.pageView();
+    const popStateHandler = () => {
+      if (!this.isInitializedByReactProvider()) {
+        this.pageView();
+      }
+    };
     window.addEventListener("popstate", popStateHandler);
     this.cleanupFns.push(() => {
       history.pushState = originalPushState;
@@ -1832,16 +1845,22 @@ var AnalyticsEngine = class {
       window.removeEventListener("popstate", popStateHandler);
     });
   }
+  // Simple flag to check if NexusProvider is active
+  isInitializedByReactProvider() {
+    return !!document.getElementById("__nexus_react_active");
+  }
   getSessionId() {
     return this.tracker.getSession();
   }
-  stop() {
+  stop(isFinalShutdown = false) {
     this.cleanupFns.forEach((fn) => fn());
     this.cleanupFns = [];
-    this.tracker.send("session_end", {
-      session_id: this.tracker.getSession(),
-      duration: this.tracker.getSessionDuration()
-    });
+    if (isFinalShutdown) {
+      this.tracker.send("session_end", {
+        session_id: this.tracker.getSession(),
+        duration: this.tracker.getSessionDuration()
+      });
+    }
     this.tracker.stop();
     this.isInitialized = false;
   }
@@ -2109,13 +2128,15 @@ function NexusAnalyticsTracker({
 }) {
   const pathname = _navigation.usePathname.call(void 0, );
   const searchParams = _navigation.useSearchParams.call(void 0, );
+  const prevPathRef = _react.useRef.call(void 0, "");
   const searchParamsString = searchParams.toString();
   _react.useEffect.call(void 0, () => {
     if (nexus.analytics && !disableAnalytics) {
-      nexus.analytics.pageView();
+      nexus.analytics.pageView(prevPathRef.current || document.referrer);
+      prevPathRef.current = pathname;
     }
   }, [pathname, searchParamsString, disableAnalytics]);
-  return null;
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { id: "__nexus_react_active", style: { display: "none" } });
 }
 var NexusProvider = ({
   children,

package/dist/index.d.cts

@@ -220,7 +220,8 @@ declare class AnalyticsEngine {
     private isInitialized;
     constructor(config: NexusConfig);
     start(): void;
-    pageView(): void;
+    private lastPath;
+    pageView(customReferrer?: string): void;
     private setupShareTracking;
     identify(userId: string, traits?: Record<string, any>): Promise<boolean>;
     group(groupId: string, traits?: Record<string, any>): Promise<boolean>;
@@ -242,8 +243,9 @@ declare class AnalyticsEngine {
     private setupClickTracking;
     private setupFormTracking;
     private setupRouteTracking;
+    private isInitializedByReactProvider;
     getSessionId(): string;
-    stop(): void;
+    stop(isFinalShutdown?: boolean): void;
 }
 
 declare class NexusClient {

package/dist/index.d.ts

@@ -220,7 +220,8 @@ declare class AnalyticsEngine {
     private isInitialized;
     constructor(config: NexusConfig);
     start(): void;
-    pageView(): void;
+    private lastPath;
+    pageView(customReferrer?: string): void;
     private setupShareTracking;
     identify(userId: string, traits?: Record<string, any>): Promise<boolean>;
     group(groupId: string, traits?: Record<string, any>): Promise<boolean>;
@@ -242,8 +243,9 @@ declare class AnalyticsEngine {
     private setupClickTracking;
     private setupFormTracking;
     private setupRouteTracking;
+    private isInitializedByReactProvider;
     getSessionId(): string;
-    stop(): void;
+    stop(isFinalShutdown?: boolean): void;
 }
 
 declare class NexusClient {

package/dist/index.js

@@ -1626,6 +1626,7 @@ var AnalyticsEngine = class {
   constructor(config) {
     this.cleanupFns = [];
     this.isInitialized = false;
+    this.lastPath = typeof window !== "undefined" ? window.location.pathname : "";
     this.tracker = new Tracker(config);
   }
   start() {
@@ -1641,14 +1642,18 @@ var AnalyticsEngine = class {
       console.log("[NexusHub] \u{1F680} Analytics Engine Started");
     }
   }
-  pageView() {
+  pageView(customReferrer) {
     if (typeof window === "undefined") return;
+    const currentPath = window.location.pathname;
     this.tracker.send("page_view", {
-      path: window.location.pathname,
+      path: currentPath,
       search: window.location.search,
       title: document.title,
-      timezone_offset: (/* @__PURE__ */ new Date()).getTimezoneOffset()
+      timezone_offset: (/* @__PURE__ */ new Date()).getTimezoneOffset(),
+      // Use the virtual path as referrer if navigating internally
+      referrer: customReferrer || (this.lastPath !== currentPath ? this.lastPath : document.referrer)
     });
+    this.lastPath = currentPath;
   }
   // --- SOCIAL / DARK SOCIAL TRACKING ---
   setupShareTracking() {
@@ -1775,7 +1780,8 @@ var AnalyticsEngine = class {
           text: link.innerText?.substring(0, 50),
           id: link.id,
           classes: link.className,
-          dataset: { ...link.dataset }
+          dataset: { ...link.dataset },
+          coordinates: { x: e.clientX, y: e.clientY }
         });
       }
       const button = target.closest("button");
@@ -1818,13 +1824,20 @@ var AnalyticsEngine = class {
     const originalPushState = history.pushState.bind(history);
     const originalReplaceState = history.replaceState.bind(history);
     history.pushState = (...args) => {
+      const prevPath = window.location.pathname;
       originalPushState(...args);
-      this.pageView();
+      if (!this.isInitializedByReactProvider()) {
+        this.pageView(prevPath);
+      }
     };
     history.replaceState = (...args) => {
       originalReplaceState(...args);
     };
-    const popStateHandler = () => this.pageView();
+    const popStateHandler = () => {
+      if (!this.isInitializedByReactProvider()) {
+        this.pageView();
+      }
+    };
     window.addEventListener("popstate", popStateHandler);
     this.cleanupFns.push(() => {
       history.pushState = originalPushState;
@@ -1832,16 +1845,22 @@ var AnalyticsEngine = class {
       window.removeEventListener("popstate", popStateHandler);
     });
   }
+  // Simple flag to check if NexusProvider is active
+  isInitializedByReactProvider() {
+    return !!document.getElementById("__nexus_react_active");
+  }
   getSessionId() {
     return this.tracker.getSession();
   }
-  stop() {
+  stop(isFinalShutdown = false) {
     this.cleanupFns.forEach((fn) => fn());
     this.cleanupFns = [];
-    this.tracker.send("session_end", {
-      session_id: this.tracker.getSession(),
-      duration: this.tracker.getSessionDuration()
-    });
+    if (isFinalShutdown) {
+      this.tracker.send("session_end", {
+        session_id: this.tracker.getSession(),
+        duration: this.tracker.getSessionDuration()
+      });
+    }
     this.tracker.stop();
     this.isInitialized = false;
   }
@@ -2109,13 +2128,15 @@ function NexusAnalyticsTracker({
 }) {
   const pathname = usePathname();
   const searchParams = useSearchParams();
+  const prevPathRef = useRef("");
   const searchParamsString = searchParams.toString();
   useEffect2(() => {
     if (nexus.analytics && !disableAnalytics) {
-      nexus.analytics.pageView();
+      nexus.analytics.pageView(prevPathRef.current || document.referrer);
+      prevPathRef.current = pathname;
     }
   }, [pathname, searchParamsString, disableAnalytics]);
-  return null;
+  return /* @__PURE__ */ jsx2("div", { id: "__nexus_react_active", style: { display: "none" } });
 }
 var NexusProvider = ({
   children,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nexushub/client",
   "private": false,
-  "version": "0.2.9",
+  "version": "0.3.0",
   "description": "The God-Tier NexusHub SDK",
   "type": "module",
   "main": "./dist/index.cjs",