@nexushub/client 0.2.6 → 0.2.8

package/dist/index.cjs

@@ -349,18 +349,21 @@ var RateLimiter = class {
     this.config = config;
   }
   async checkLimit() {
-    const now = Date.now();
-    const windowStart = now - this.config.timeWindow;
-    this.requests = this.requests.filter((time) => time > windowStart);
-    if (this.requests.length >= this.config.maxRequests) {
+    while (true) {
+      const now = Date.now();
+      const windowStart = now - this.config.timeWindow;
+      this.requests = this.requests.filter((time) => time > windowStart);
+      if (this.requests.length < this.config.maxRequests) {
+        this.requests.push(now);
+        return;
+      }
       const oldestRequest = this.requests[0];
-      const waitTime = windowStart + this.config.timeWindow - now;
+      const waitTime = oldestRequest + this.config.timeWindow - now;
       if (waitTime > 0) {
         await new Promise((resolve) => setTimeout(resolve, waitTime));
-        return this.checkLimit();
+      } else {
       }
     }
-    this.requests.push(now);
   }
   getStats() {
     const now = Date.now();
@@ -368,21 +371,15 @@ var RateLimiter = class {
     const currentRequests = this.requests.filter(
       (time) => time > windowStart
     ).length;
-    return {
-      currentRequests,
-      limit: this.config.maxRequests
-    };
+    return { currentRequests, limit: this.config.maxRequests };
   }
 };
 var ExponentialBackoff = class {
   constructor(config) {
-    this.config = {
-      jitter: true,
-      ...config
-    };
+    this.config = { jitter: true, ...config };
   }
   async execute(fn, onRetry) {
-    let lastError;
+    let lastError = new Error("Unknown error");
     for (let attempt = 0; attempt <= this.config.maxRetries; attempt++) {
       try {
         return await fn();
@@ -391,13 +388,9 @@ var ExponentialBackoff = class {
         if (this.isClientError(error) && !this.isRateLimitError(error)) {
           throw error;
         }
-        if (attempt === this.config.maxRetries) {
-          break;
-        }
+        if (attempt === this.config.maxRetries) break;
         const delay = this.calculateDelay(attempt);
-        if (onRetry) {
-          onRetry(attempt + 1, delay, error);
-        }
+        if (onRetry) onRetry(attempt + 1, delay, error);
         await new Promise((resolve) => setTimeout(resolve, delay));
       }
     }
@@ -429,8 +422,7 @@ var CircuitBreaker = class {
   // 30 seconds
   isOpen() {
     if (this.state === 1 /* OPEN */) {
-      const now = Date.now();
-      if (now - this.lastFailureTime > this.resetTimeout) {
+      if (Date.now() - this.lastFailureTime > this.resetTimeout) {
         this.state = 2 /* HALF_OPEN */;
         return false;
       }
@@ -449,14 +441,11 @@ var CircuitBreaker = class {
       this.state = 1 /* OPEN */;
       if (process.env.NODE_ENV === "development") {
         console.warn(
-          `[NexusHub] \u{1F50C} Circuit Breaker OPEN. Pausing network requests.`
+          "[NexusHub] \u{1F50C} Circuit Breaker OPEN. Pausing network requests."
         );
       }
     }
   }
-  isIgnorableError(error) {
-    return _optionalChain([error, 'optionalAccess', _13 => _13.status]) === 401 || _optionalChain([error, 'optionalAccess', _14 => _14.status]) === 404;
-  }
 };
 var RequestBatcher = class {
   constructor(batchWindow = 10, maxBatchSize = 20) {
@@ -489,13 +478,9 @@ var RequestBatcher = class {
     this.batch = [];
     try {
       const result = await request();
-      currentBatch.forEach((item) => {
-        item.resolve(result);
-      });
+      currentBatch.forEach((item) => item.resolve(result));
     } catch (error) {
-      currentBatch.forEach((item) => {
-        item.reject(error);
-      });
+      currentBatch.forEach((item) => item.reject(error));
     } finally {
       this.processing = false;
       if (this.batch.length > 0) {
@@ -534,10 +519,10 @@ function buildQueryString(query) {
   if (query.sort) params.append("sort", query.sort);
   if (query.order) params.append("order", query.order);
   if (query.search) params.append("search", query.search);
-  if (_optionalChain([query, 'access', _15 => _15.include, 'optionalAccess', _16 => _16.length])) {
+  if (_optionalChain([query, 'access', _13 => _13.include, 'optionalAccess', _14 => _14.length])) {
     params.append("include", query.include.join(","));
   }
-  if (_optionalChain([query, 'access', _17 => _17.fields, 'optionalAccess', _18 => _18.length])) {
+  if (_optionalChain([query, 'access', _15 => _15.fields, 'optionalAccess', _16 => _16.length])) {
     params.append("fields", query.fields.join(","));
   }
   if (query.filter) {
@@ -819,7 +804,7 @@ var ContentEngine = class {
     }
     return this.requestBatcher.schedule(cacheKey, async () => {
       const params = new URLSearchParams();
-      if (_optionalChain([options, 'access', _19 => _19.include, 'optionalAccess', _20 => _20.length])) {
+      if (_optionalChain([options, 'access', _17 => _17.include, 'optionalAccess', _18 => _18.length])) {
         params.append("include", options.include.join(","));
       }
       const url = `${this.config.apiUrl}/content/${this.config.projectId}/collection/${collectionId}/${itemId}?${params}`;
@@ -852,10 +837,10 @@ var ContentEngine = class {
       q: query,
       limit: (options.limit || 20).toString()
     });
-    if (_optionalChain([options, 'access', _21 => _21.collections, 'optionalAccess', _22 => _22.length])) {
+    if (_optionalChain([options, 'access', _19 => _19.collections, 'optionalAccess', _20 => _20.length])) {
       params.append("collections", options.collections.join(","));
     }
-    if (_optionalChain([options, 'access', _23 => _23.fields, 'optionalAccess', _24 => _24.length])) {
+    if (_optionalChain([options, 'access', _21 => _21.fields, 'optionalAccess', _22 => _22.length])) {
       params.append("fields", options.fields.join(","));
     }
     const url = `${this.config.apiUrl}/content/${this.config.projectId}/search?${params}`;
@@ -916,7 +901,7 @@ var ContentEngine = class {
         }
       };
       eventSource.onerror = () => {
-        _optionalChain([eventSource, 'optionalAccess', _25 => _25.close, 'call', _26 => _26()]);
+        _optionalChain([eventSource, 'optionalAccess', _23 => _23.close, 'call', _24 => _24()]);
         if (isClosed) return;
         const timeout = Math.min(1e3 * Math.pow(2, retryCount), 1e4);
         retryCount++;
@@ -929,7 +914,7 @@ var ContentEngine = class {
     connect();
     return () => {
       isClosed = true;
-      _optionalChain([eventSource, 'optionalAccess', _27 => _27.close, 'call', _28 => _28()]);
+      _optionalChain([eventSource, 'optionalAccess', _25 => _25.close, 'call', _26 => _26()]);
     };
   }
   // --- CACHE MANAGEMENT ---
@@ -1255,23 +1240,25 @@ var ContentEngine = class {
 };
 
 // src/analytics/fingerprint.ts
+var cachedEntropy = null;
 var getDeviceEntropy = async () => {
+  if (cachedEntropy) return cachedEntropy;
   if (typeof window === "undefined") return {};
   const nav = window.navigator;
-  return {
+  cachedEntropy = {
     screen_resolution: `${window.screen.width}x${window.screen.height}`,
     color_depth: window.screen.colorDepth,
     pixel_ratio: window.devicePixelRatio || 1,
     hardware_concurrency: nav.hardwareConcurrency,
     device_memory: nav.deviceMemory,
-    // Only available in Chrome/Edge
+    // Chrome/Edge only
     timezone_offset: (/* @__PURE__ */ new Date()).getTimezoneOffset(),
     platform: nav.platform,
     language: nav.language,
     touch_support: "ontouchstart" in window || nav.maxTouchPoints > 0,
-    // Optional: Calculate Canvas Fingerprint for high-security modes
     canvas_hash: await generateCanvasHash()
   };
+  return cachedEntropy;
 };
 var generateCanvasHash = async () => {
   try {
@@ -1389,6 +1376,7 @@ var initVitals = (tracker) => {
 var DB_NAME = "NexusHub_Analytics";
 var STORE_NAME = "events_queue";
 var DB_VERSION = 2;
+var MAX_QUEUE_SIZE = 500;
 var EventStorage = class {
   constructor() {
     this.db = null;
@@ -1398,7 +1386,7 @@ var EventStorage = class {
     if (typeof window === "undefined" || !window.indexedDB) {
       return Promise.resolve();
     }
-    return new Promise((resolve, reject) => {
+    return new Promise((resolve) => {
       const request = indexedDB.open(DB_NAME, DB_VERSION);
       request.onerror = () => {
         console.warn(
@@ -1423,11 +1411,19 @@ var EventStorage = class {
     });
   }
   /**
-   * Add an event to the persistent queue
+   * Add an event to the persistent queue.
+   * Evicts the oldest entry if the queue is already at MAX_QUEUE_SIZE.
    */
   async enqueue(payload) {
     await this.isReady;
     if (!this.db) return;
+    const currentCount = await this.count();
+    if (currentCount >= MAX_QUEUE_SIZE) {
+      const oldest = await this.peek(1);
+      if (oldest.length > 0 && oldest[0].id !== void 0) {
+        await this.remove([oldest[0].id]);
+      }
+    }
     return new Promise((resolve, reject) => {
       const transaction = this.db.transaction([STORE_NAME], "readwrite");
       const store = transaction.objectStore(STORE_NAME);
@@ -1441,7 +1437,7 @@ var EventStorage = class {
     });
   }
   /**
-   * Get a batch of oldest events
+   * Get a batch of the oldest events without removing them.
    */
   async peek(limit = 20) {
     await this.isReady;
@@ -1455,7 +1451,7 @@ var EventStorage = class {
     });
   }
   /**
-   * Remove events after successful upload
+   * Remove events by ID after a successful upload.
    */
   async remove(ids) {
     await this.isReady;
@@ -1463,17 +1459,16 @@ var EventStorage = class {
     return new Promise((resolve, reject) => {
       const transaction = this.db.transaction([STORE_NAME], "readwrite");
       const store = transaction.objectStore(STORE_NAME);
-      let processed = 0;
-      let errors = 0;
       transaction.oncomplete = () => resolve();
       transaction.onerror = () => reject(transaction.error);
+      transaction.onabort = () => reject(new Error("Delete transaction aborted"));
       ids.forEach((id) => {
-        const req = store.delete(id);
+        store.delete(id);
       });
     });
   }
   /**
-   * Count pending events
+   * Count pending events in the queue.
    */
   async count() {
     await this.isReady;
@@ -1491,14 +1486,11 @@ var eventStorage = new EventStorage();
 
 // src/analytics/tracker.ts
 var Tracker = class {
-  // 🆕
   constructor(config) {
     this.sessionId = "";
     this.visitorId = "";
-    // FIX: Add this property
     this.isFlushing = false;
     this.config = config;
-    const baseUrl = this.config.apiUrl.replace("/v1", "").replace(/\/$/, "");
     this.endpoint = `${this.config.analyticsUrl}/api/collect`;
     this.circuitBreaker = new CircuitBreaker();
     this.sessionStart = Date.now();
@@ -1510,11 +1502,13 @@ var Tracker = class {
   async initSession() {
     this.visitorId = await getVisitorId();
     let sid = localStorage.getItem("nexus_sid");
-    let lastActivity = localStorage.getItem("nexus_last_active");
+    const lastActivity = localStorage.getItem("nexus_last_active");
     const now = Date.now();
     const SESSION_TIMEOUT = 30 * 60 * 1e3;
-    if (!sid || !lastActivity || now - parseInt(lastActivity) > SESSION_TIMEOUT) {
-      sid = `sess_${Math.random().toString(36).substring(2, 9)}_${now}`;
+    const isExpired = !sid || !lastActivity || now - parseInt(lastActivity, 10) > SESSION_TIMEOUT;
+    if (isExpired) {
+      const uuid = crypto.randomUUID().replace(/-/g, "").substring(0, 16);
+      sid = `sess_${uuid}_${now}`;
       localStorage.setItem("nexus_sid", sid);
       this.sessionStart = now;
     }
@@ -1543,7 +1537,6 @@ var Tracker = class {
       context: {
         device: {
           hardwareConcurrency: entropy.hardware_concurrency,
-          // Match Rust sub-struct too if needed
           deviceMemory: entropy.device_memory,
           pixelRatio: entropy.pixel_ratio,
           canvasFingerprint: entropy.canvas_hash,
@@ -1567,9 +1560,7 @@ var Tracker = class {
   }
   async flushQueue(useBeacon = false) {
     if (this.isFlushing) return;
-    if (this.circuitBreaker.isOpen()) {
-      return;
-    }
+    if (this.circuitBreaker.isOpen()) return;
     this.isFlushing = true;
     try {
       const storedEvents = await eventStorage.peek(20);
@@ -1619,11 +1610,9 @@ var Tracker = class {
   getSession() {
     return this.sessionId;
   }
-  // FIX: Add this method to satisfy AnalyticsEngine
   getSessionDuration() {
     return Date.now() - this.sessionStart;
   }
-  // FIX: Add this method to satisfy AnalyticsEngine
   stop() {
     if (this.flushInterval) {
       clearInterval(this.flushInterval);
@@ -1648,7 +1637,9 @@ var AnalyticsEngine = class {
     this.setupFormTracking();
     this.setupRouteTracking();
     this.setupShareTracking();
-    console.log("[NexusHub] \u{1F680} Analytics Engine Started");
+    if (process.env.NODE_ENV === "development") {
+      console.log("[NexusHub] \u{1F680} Analytics Engine Started");
+    }
   }
   pageView() {
     if (typeof window === "undefined") return;
@@ -1659,7 +1650,7 @@ var AnalyticsEngine = class {
       timezone_offset: (/* @__PURE__ */ new Date()).getTimezoneOffset()
     });
   }
-  // 🆕 PRIVATE: Track "Dark Social" Intent
+  // --- SOCIAL / DARK SOCIAL TRACKING ---
   setupShareTracking() {
     if (typeof window === "undefined") return;
     const copyHandler = () => {
@@ -1668,58 +1659,38 @@ var AnalyticsEngine = class {
         url: window.location.href
       });
     };
-    if (navigator.share) {
-      const originalShare = navigator.share;
+    window.addEventListener("copy", copyHandler, { passive: true });
+    this.cleanupFns.push(() => window.removeEventListener("copy", copyHandler));
+    if (typeof navigator !== "undefined" && navigator.share) {
+      const originalShare = navigator.share.bind(navigator);
       navigator.share = (data) => {
         this.tracker.send("social_share", {
           method: "native_share_menu",
-          url: _optionalChain([data, 'optionalAccess', _29 => _29.url]) || window.location.href,
-          title: _optionalChain([data, 'optionalAccess', _30 => _30.title])
+          url: _optionalChain([data, 'optionalAccess', _27 => _27.url]) || window.location.href,
+          title: _optionalChain([data, 'optionalAccess', _28 => _28.title])
         });
-        return originalShare.apply(navigator, [data]);
+        return originalShare(data);
       };
+      this.cleanupFns.push(() => {
+        navigator.share = originalShare;
+      });
     }
-    window.addEventListener("copy", copyHandler, { passive: true });
-    this.cleanupFns.push(() => window.removeEventListener("copy", copyHandler));
   }
-  // --- IDENTITY & B2B (The Missing Pieces) ---
-  /**
-   * 1. IDENTIFY: Link anonymous session to a User ID
-   */
+  // --- IDENTITY & B2B ---
   async identify(userId, traits = {}) {
-    return this.sendIdentityRequest("identify", {
-      user_id: userId,
-      traits
-    });
+    return this.sendIdentityRequest("identify", { user_id: userId, traits });
   }
-  /**
-   * 2. GROUP: Link the current user to a Company/Organization (B2B)
-   * Required for the /api/group Rust route.
-   */
   async group(groupId, traits = {}) {
-    return this.sendIdentityRequest("group", {
-      group_id: groupId,
-      // The Rust backend handles looking up the user from the session if not provided,
-      // but passing the user_id if known is safer.
-      traits
-    });
+    return this.sendIdentityRequest("group", { group_id: groupId, traits });
   }
-  /**
-   * 3. ALIAS: Merge two identities (e.g. "Guest_123" -> "User_99")
-   * Required for the /api/alias Rust route.
-   */
   async alias(newId) {
     return this.sendIdentityRequest("alias", {
       previous_id: this.tracker.getSession(),
-      // Or the old visitor_id
       user_id: newId
     });
   }
-  /**
-   * 4. RESET: Clear local data and (optionally) request GDPR scrub
-   */
   reset(performGdprScrub = false) {
-    const config = this.tracker["config"];
+    const config = this.tracker.config;
     this.tracker.stop();
     localStorage.removeItem("nexus_sid");
     localStorage.removeItem("nexus_vid");
@@ -1763,10 +1734,10 @@ var AnalyticsEngine = class {
       url: typeof window !== "undefined" ? window.location.href : ""
     });
   }
-  // --- INTERNAL HELPER ---
+  // --- INTERNAL ---
   async sendIdentityRequest(type, data) {
     try {
-      const config = this.tracker["config"];
+      const config = this.tracker.config;
       const endpoint = `${config.analyticsUrl}/api/${type}`;
       const payload = {
         projectId: config.projectId,
@@ -1775,18 +1746,15 @@ var AnalyticsEngine = class {
         timestamp: (/* @__PURE__ */ new Date()).toISOString(),
         ...data
       };
-      if (type === "group" && !payload.user_id) {
-      }
       const response = await fetch(endpoint, {
         method: "POST",
         headers: {
           "Content-Type": "application/json",
-          Authorization: `Bearer ${this.tracker["config"].apiKey}`
+          Authorization: `Bearer ${config.apiKey}`
         },
         body: JSON.stringify(payload)
       });
       if (response.ok) {
-        this.tracker.send(type, data);
         return true;
       }
       return false;
@@ -1795,7 +1763,6 @@ var AnalyticsEngine = class {
       return false;
     }
   }
-  // --- PRIVATE EVENT LISTENERS (Keep existing setupClickTracking, setupFormTracking, setupRouteTracking) ---
   setupClickTracking() {
     if (typeof window === "undefined") return;
     const clickHandler = (e) => {
@@ -1805,7 +1772,7 @@ var AnalyticsEngine = class {
         this.tracker.send("click", {
           element_type: "link",
           href: link.href,
-          text: _optionalChain([link, 'access', _31 => _31.innerText, 'optionalAccess', _32 => _32.substring, 'call', _33 => _33(0, 50)]),
+          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 }
@@ -1815,7 +1782,7 @@ var AnalyticsEngine = class {
       if (button) {
         this.tracker.send("click", {
           element_type: "button",
-          text: _optionalChain([button, 'access', _34 => _34.innerText, 'optionalAccess', _35 => _35.substring, 'call', _36 => _36(0, 50)]),
+          text: _optionalChain([button, 'access', _32 => _32.innerText, 'optionalAccess', _33 => _33.substring, 'call', _34 => _34(0, 50)]),
           id: button.id,
           classes: button.className,
           coordinates: { x: e.clientX, y: e.clientY }
@@ -1848,21 +1815,22 @@ var AnalyticsEngine = class {
   setupRouteTracking() {
     if (typeof window === "undefined" || typeof window.history === "undefined")
       return;
-    const originalPushState = history.pushState;
-    const originalReplaceState = history.replaceState;
+    const originalPushState = history.pushState.bind(history);
+    const originalReplaceState = history.replaceState.bind(history);
     history.pushState = (...args) => {
-      originalPushState.apply(history, args);
+      originalPushState(...args);
       this.pageView();
     };
     history.replaceState = (...args) => {
-      originalReplaceState.apply(history, args);
-      this.pageView();
+      originalReplaceState(...args);
     };
     const popStateHandler = () => this.pageView();
     window.addEventListener("popstate", popStateHandler);
-    this.cleanupFns.push(
-      () => window.removeEventListener("popstate", popStateHandler)
-    );
+    this.cleanupFns.push(() => {
+      history.pushState = originalPushState;
+      history.replaceState = originalReplaceState;
+      window.removeEventListener("popstate", popStateHandler);
+    });
   }
   getSessionId() {
     return this.tracker.getSession();
@@ -1881,44 +1849,60 @@ var AnalyticsEngine = class {
 
 // src/client.ts
 var NexusClient = class {
-  // Make this public/accessible
   constructor(config) {
     const fullConfig = getFullConfig(config);
     this.config = {
-      debug: _optionalChain([config, 'optionalAccess', _37 => _37.debug]) || false,
-      cacheStrategy: _optionalChain([config, 'optionalAccess', _38 => _38.cacheStrategy]) || "memory",
-      revalidateTime: _optionalChain([config, 'optionalAccess', _39 => _39.revalidateTime]) || 60,
-      timeout: _optionalChain([config, 'optionalAccess', _40 => _40.timeout]) || 1e4,
-      retries: _optionalChain([config, 'optionalAccess', _41 => _41.retries]) || 3,
+      debug: _nullishCoalesce(_optionalChain([config, 'optionalAccess', _35 => _35.debug]), () => ( false)),
+      cacheStrategy: _nullishCoalesce(_optionalChain([config, 'optionalAccess', _36 => _36.cacheStrategy]), () => ( "memory")),
+      revalidateTime: _nullishCoalesce(_optionalChain([config, 'optionalAccess', _37 => _37.revalidateTime]), () => ( 60)),
+      timeout: _nullishCoalesce(_optionalChain([config, 'optionalAccess', _38 => _38.timeout]), () => ( 1e4)),
+      retries: _nullishCoalesce(_optionalChain([config, 'optionalAccess', _39 => _39.retries]), () => ( 3)),
       ...fullConfig
     };
-    this.content = new ContentEngine(this.config);
-    if (typeof window !== "undefined") {
-      this.analytics = new AnalyticsEngine(this.config);
-      this.analytics.start();
-    }
     const errors = validateConfig(this.config);
     if (errors.length > 0) {
       console.warn("\u26A0\uFE0F NexusHub: Configuration issues:", errors.join(", "));
       if (!this.config.projectId) {
-        console.warn("\u26A0\uFE0F NexusHub: No Project ID found. Content fetching will fail.");
+        console.warn("\u26A0\uFE0F NexusHub: No Project ID found. Tracking will fail.");
       }
     }
     this.content = new ContentEngine(this.config);
+    if (typeof window !== "undefined") {
+      this.analytics = new AnalyticsEngine(this.config);
+      this.analytics.start();
+    }
   }
-  // Helper alias for cleaner code
+  /**
+   * Helper alias for cleaner content fetching.
+   */
   getPage(slug, options) {
     return this.content.getPage(slug, options);
   }
-  // Get current config (readonly)
+  /**
+   * Returns a readonly snapshot of the current config.
+   */
   getConfig() {
     return { ...this.config };
   }
+  /**
+   * Updates specific config fields at runtime.
+   * Replaces the previous pattern of `(nexus as any).config.projectId = x`
+   * which bypassed TypeScript and mutated internal state unsafely.
+   */
+  updateConfig(updates) {
+    this.config = { ...this.config, ...updates };
+  }
 };
 var nexus = new NexusClient();
 var createNexusClient = (config) => new NexusClient(config);
 
 // src/components/NexusProvider.tsx
+
+
+
+
+
+
 var _react = require('react'); var _react2 = _interopRequireDefault(_react);
 var _navigation = require('next/navigation');
 
@@ -2120,18 +2104,28 @@ async function parseError(res) {
 // src/components/NexusProvider.tsx
 
 var NexusContext = _react.createContext.call(void 0, nexus);
+function NexusAnalyticsTracker({
+  disableAnalytics
+}) {
+  const pathname = _navigation.usePathname.call(void 0, );
+  const searchParams = _navigation.useSearchParams.call(void 0, );
+  const searchParamsString = searchParams.toString();
+  _react.useEffect.call(void 0, () => {
+    if (nexus.analytics && !disableAnalytics) {
+      nexus.analytics.pageView();
+    }
+  }, [pathname, searchParamsString, disableAnalytics]);
+  return null;
+}
 var NexusProvider = ({
   children,
   projectId,
   disableAnalytics = false
 }) => {
-  const pathname = _navigation.usePathname.call(void 0, );
-  const searchParams = _navigation.useSearchParams.call(void 0, );
   const isInitialized = _react.useRef.call(void 0, false);
   const config = _react.useMemo.call(void 0, () => {
-    const currentConfig = nexus.getConfig();
-    if (projectId && currentConfig.projectId !== projectId) {
-      nexus.config.projectId = projectId;
+    if (projectId && nexus.getConfig().projectId !== projectId) {
+      nexus.updateConfig({ projectId });
     }
     return nexus.getConfig();
   }, [projectId]);
@@ -2154,12 +2148,17 @@ var NexusProvider = ({
       }
     };
   }, [disableAnalytics]);
-  _react.useEffect.call(void 0, () => {
-    if (nexus.analytics && !disableAnalytics) {
-      nexus.analytics.pageView();
-    }
-  }, [pathname, searchParams, disableAnalytics]);
-  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, NexusContext.Provider, { value: nexus, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, AuthProvider, { config, children }) });
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, NexusContext.Provider, { value: nexus, children: /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, AuthProvider, { config, children: [
+    /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _react.Suspense, { fallback: null, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, NexusAnalyticsTracker, { disableAnalytics }) }),
+    children
+  ] }) });
+};
+var useNexus = () => {
+  const context = _react2.default.useContext(NexusContext);
+  if (!context) {
+    throw new Error("useNexus must be used within a NexusProvider");
+  }
+  return context;
 };
 
 // src/index.ts
@@ -2186,4 +2185,5 @@ var VERSION = "0.0.1";
 
 
 
-exports.AnalyticsEngine = AnalyticsEngine; exports.AuthProvider = AuthProvider; exports.BrowserCache = BrowserCache; exports.CacheTags = CacheTags; exports.ContentEngine = ContentEngine; exports.DEFAULT_ANALYTICS_URL = DEFAULT_ANALYTICS_URL; exports.DEFAULT_API_URL = DEFAULT_API_URL; exports.LOCAL_NEST_URL = LOCAL_NEST_URL; exports.LOCAL_RUST_URL = LOCAL_RUST_URL; exports.LocalCache = LocalCacheProxy; exports.MemoryCache = MemoryCache; exports.NexusClient = NexusClient; exports.NexusProvider = NexusProvider; exports.VERSION = VERSION; exports.createNexusClient = createNexusClient; exports.getEnvConfig = getEnvConfig; exports.getFullConfig = getFullConfig; exports.mergeConfigs = mergeConfigs; exports.nexus = nexus; exports.useNexusAuth = useNexusAuth; exports.validateConfig = validateConfig;
+
+exports.AnalyticsEngine = AnalyticsEngine; exports.AuthProvider = AuthProvider; exports.BrowserCache = BrowserCache; exports.CacheTags = CacheTags; exports.ContentEngine = ContentEngine; exports.DEFAULT_ANALYTICS_URL = DEFAULT_ANALYTICS_URL; exports.DEFAULT_API_URL = DEFAULT_API_URL; exports.LOCAL_NEST_URL = LOCAL_NEST_URL; exports.LOCAL_RUST_URL = LOCAL_RUST_URL; exports.LocalCache = LocalCacheProxy; exports.MemoryCache = MemoryCache; exports.NexusClient = NexusClient; exports.NexusProvider = NexusProvider; exports.VERSION = VERSION; exports.createNexusClient = createNexusClient; exports.getEnvConfig = getEnvConfig; exports.getFullConfig = getFullConfig; exports.mergeConfigs = mergeConfigs; exports.nexus = nexus; exports.useNexus = useNexus; exports.useNexusAuth = useNexusAuth; exports.validateConfig = validateConfig;