@nexushub/client 0.3.1 → 0.3.2

package/dist/index.d.cts

@@ -210,19 +210,27 @@ declare class ContentEngine {
     private cleanup;
 }
 
-/**
- * NexusHub Analytics Engine
- * Orchestrates automatic event capture, performance monitoring, and user tracking.
- */
 declare class AnalyticsEngine {
     private tracker;
     private cleanupFns;
     private isInitialized;
+    private maxScrollDepth;
+    private scrollThresholdsFired;
+    private scrollTimer?;
     constructor(config: NexusConfig);
     start(): void;
     private lastPath;
     pageView(customReferrer?: string): void;
     private setupShareTracking;
+    private setupScrollTracking;
+    private clickBuffer;
+    private setupClickTracking;
+    private setupFormTracking;
+    private setupOutboundTracking;
+    private setupVideoTracking;
+    private setupErrorTracking;
+    private setupRouteTracking;
+    private isInitializedByReactProvider;
     identify(userId: string, traits?: Record<string, any>): Promise<boolean>;
     group(groupId: string, traits?: Record<string, any>): Promise<boolean>;
     alias(newId: string): Promise<boolean>;
@@ -231,19 +239,18 @@ declare class AnalyticsEngine {
     trackPurchase(orderData: {
         orderId: string;
         total: number;
+        revenue?: number;
         currency?: string;
         products: Array<{
             id: string;
+            name: string;
             price: number;
             quantity: number;
+            sku?: string;
         }>;
     }): void;
     trackError(error: Error, context?: Record<string, any>): void;
     private sendIdentityRequest;
-    private setupClickTracking;
-    private setupFormTracking;
-    private setupRouteTracking;
-    private isInitializedByReactProvider;
     getSessionId(): string;
     stop(isFinalShutdown?: boolean): void;
 }
@@ -273,33 +280,32 @@ declare const createNexusClient: (config: Partial<NexusConfig>) => NexusClient;
 
 interface NexusProviderProps {
     children: React.ReactNode;
-    /**
-     * Optional project ID override.
-     * Overrides the NEXT_PUBLIC_NEXUS_ID environment variable.
-     */
     projectId?: string;
-    /**
-     * Set true to disable analytics (e.g. for GDPR opt-out).
-     */
     disableAnalytics?: boolean;
+    hasConsent?: boolean;
+    enableLiveFeed?: boolean;
+    onLiveEvent?: (event: LiveAnalyticsEvent) => void;
 }
-/**
- * NexusHub Provider.
- * Manages the Analytics lifecycle, automates page view tracking on route
- * changes, and exposes the NexusClient singleton via React Context.
- *
- * Usage in app/layout.tsx:
- *
- *   <NexusProvider projectId="your_id">
- *     {children}
- *   </NexusProvider>
- *
- * No manual <Suspense> wrapper needed — the provider handles it internally.
- */
-declare const NexusProvider: ({ children, projectId, disableAnalytics, }: NexusProviderProps) => react_jsx_runtime.JSX.Element;
-/**
- * Access the raw NexusClient instance from any component inside the provider.
- */
+interface LiveAnalyticsEvent {
+    eventType: string;
+    projectId: string;
+    sessionId: string;
+    visitorId: string;
+    userId?: string;
+    data: {
+        event_id: string;
+        event_name?: string;
+        url: string;
+        timestamp: string;
+        geo?: Record<string, any>;
+        device?: Record<string, any>;
+        performance?: Record<string, any>;
+        ecommerce?: Record<string, any>;
+    };
+    timestamp: string;
+    sequence: number;
+}
+declare const NexusProvider: ({ children, projectId, disableAnalytics, hasConsent, enableLiveFeed, onLiveEvent, }: NexusProviderProps) => react_jsx_runtime.JSX.Element;
 declare const useNexus: () => NexusClient;
 
 interface SiteUser {

package/dist/index.d.ts

@@ -210,19 +210,27 @@ declare class ContentEngine {
     private cleanup;
 }
 
-/**
- * NexusHub Analytics Engine
- * Orchestrates automatic event capture, performance monitoring, and user tracking.
- */
 declare class AnalyticsEngine {
     private tracker;
     private cleanupFns;
     private isInitialized;
+    private maxScrollDepth;
+    private scrollThresholdsFired;
+    private scrollTimer?;
     constructor(config: NexusConfig);
     start(): void;
     private lastPath;
     pageView(customReferrer?: string): void;
     private setupShareTracking;
+    private setupScrollTracking;
+    private clickBuffer;
+    private setupClickTracking;
+    private setupFormTracking;
+    private setupOutboundTracking;
+    private setupVideoTracking;
+    private setupErrorTracking;
+    private setupRouteTracking;
+    private isInitializedByReactProvider;
     identify(userId: string, traits?: Record<string, any>): Promise<boolean>;
     group(groupId: string, traits?: Record<string, any>): Promise<boolean>;
     alias(newId: string): Promise<boolean>;
@@ -231,19 +239,18 @@ declare class AnalyticsEngine {
     trackPurchase(orderData: {
         orderId: string;
         total: number;
+        revenue?: number;
         currency?: string;
         products: Array<{
             id: string;
+            name: string;
             price: number;
             quantity: number;
+            sku?: string;
         }>;
     }): void;
     trackError(error: Error, context?: Record<string, any>): void;
     private sendIdentityRequest;
-    private setupClickTracking;
-    private setupFormTracking;
-    private setupRouteTracking;
-    private isInitializedByReactProvider;
     getSessionId(): string;
     stop(isFinalShutdown?: boolean): void;
 }
@@ -273,33 +280,32 @@ declare const createNexusClient: (config: Partial<NexusConfig>) => NexusClient;
 
 interface NexusProviderProps {
     children: React.ReactNode;
-    /**
-     * Optional project ID override.
-     * Overrides the NEXT_PUBLIC_NEXUS_ID environment variable.
-     */
     projectId?: string;
-    /**
-     * Set true to disable analytics (e.g. for GDPR opt-out).
-     */
     disableAnalytics?: boolean;
+    hasConsent?: boolean;
+    enableLiveFeed?: boolean;
+    onLiveEvent?: (event: LiveAnalyticsEvent) => void;
 }
-/**
- * NexusHub Provider.
- * Manages the Analytics lifecycle, automates page view tracking on route
- * changes, and exposes the NexusClient singleton via React Context.
- *
- * Usage in app/layout.tsx:
- *
- *   <NexusProvider projectId="your_id">
- *     {children}
- *   </NexusProvider>
- *
- * No manual <Suspense> wrapper needed — the provider handles it internally.
- */
-declare const NexusProvider: ({ children, projectId, disableAnalytics, }: NexusProviderProps) => react_jsx_runtime.JSX.Element;
-/**
- * Access the raw NexusClient instance from any component inside the provider.
- */
+interface LiveAnalyticsEvent {
+    eventType: string;
+    projectId: string;
+    sessionId: string;
+    visitorId: string;
+    userId?: string;
+    data: {
+        event_id: string;
+        event_name?: string;
+        url: string;
+        timestamp: string;
+        geo?: Record<string, any>;
+        device?: Record<string, any>;
+        performance?: Record<string, any>;
+        ecommerce?: Record<string, any>;
+    };
+    timestamp: string;
+    sequence: number;
+}
+declare const NexusProvider: ({ children, projectId, disableAnalytics, hasConsent, enableLiveFeed, onLiveEvent, }: NexusProviderProps) => react_jsx_runtime.JSX.Element;
 declare const useNexus: () => NexusClient;
 
 interface SiteUser {