@akson/cortex-analytics-react 2.0.1 → 2.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akson/cortex-analytics-react",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "description": "Reusable React analytics components and hooks for @cortex ecosystem",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -22,8 +22,8 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "dependencies": {
-    "@akson/cortex-gtm": "^3.0.0",
-    "@akson/cortex-posthog": "^0.4.0",
+    "@akson/cortex-gtm": "^3.1.0",
+    "@akson/cortex-posthog": "^0.5.0",
     "@akson/cortex-utilities": "^0.3.0"
   },
   "devDependencies": {

package/dist/index.d.mts

@@ -1,304 +0,0 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import React from 'react';
-export { ECOMMERCE_EVENTS, LEAD_GENERATION_EVENTS, LEAD_SCORES } from '@akson/cortex-utilities';
-
-/**
- * @akson/cortex-analytics-react - Type Definitions
- * Reusable types for analytics tracking across React applications
- */
-
-/**
- * Analytics configuration for projects
- */
-interface AnalyticsConfig {
-    platforms: {
-        gtm?: {
-            containerId: string;
-            workspaceId?: number;
-            publicId?: string;
-        };
-        posthog?: {
-            apiKey: string;
-            host?: string;
-        };
-        ga4?: {
-            measurementId: string;
-        };
-        googleAds?: {
-            accountId: string;
-        };
-        meta?: {
-            pixelId: string;
-        };
-    };
-    conversions?: Record<string, string>;
-    funnel?: FunnelConfig;
-    debug?: boolean;
-    enableEnhancedConversions?: boolean;
-}
-/**
- * Funnel configuration
- */
-interface FunnelConfig {
-    stages?: Record<string, string[]>;
-    scoring?: (stage: string) => number;
-    abandonmentTracking?: boolean;
-    sessionTimeout?: number;
-}
-/**
- * Event data for tracking
- */
-interface EventData {
-    [key: string]: any;
-    event_category?: string;
-    event_label?: string;
-    event_value?: number;
-    standardized_event?: boolean;
-    timestamp?: string;
-    sessionId?: string;
-}
-/**
- * Lead event data
- */
-interface LeadEventData extends EventData {
-    lead_score: number;
-    funnel_stage?: string;
-    contact_method?: string;
-    source?: string;
-    language?: string;
-    device?: "mobile" | "desktop" | "tablet";
-}
-/**
- * E-commerce event data
- */
-interface EcommerceEventData extends EventData {
-    value: number;
-    currency: string;
-    transaction_id?: string;
-    items?: Array<{
-        item_id?: string;
-        item_name: string;
-        price: number;
-        quantity?: number;
-    }>;
-}
-/**
- * Funnel stage data
- */
-interface FunnelStageData {
-    stage: string;
-    previousStage?: string;
-    timeOnStage?: number;
-    totalTimeInFunnel?: number;
-    experimentVariants?: Record<string, string>;
-    formData?: FormData;
-    scrollData?: ScrollData;
-    performanceData?: PerformanceData;
-    source?: string;
-    language?: string;
-    device?: "mobile" | "desktop" | "tablet";
-    sessionId?: string;
-    userAgent?: string;
-    viewport?: string;
-    screenResolution?: string;
-}
-/**
- * Form tracking data
- */
-interface FormData {
-    step?: number;
-    stepName?: string;
-    fieldsCompleted?: number;
-    totalFields?: number;
-    completionPercentage?: number;
-    filledFields?: string[];
-    emptyFields?: string[];
-}
-/**
- * Scroll tracking data
- */
-interface ScrollData {
-    maxScrollPercent?: number;
-    timeToMaxScroll?: number;
-}
-/**
- * Performance tracking data
- */
-interface PerformanceData {
-    pageLoadTime?: number;
-    timeToInteraction?: number;
-    dns?: number;
-    tcp?: number;
-    ttfb?: number;
-}
-/**
- * User data for enhanced conversions
- */
-interface UserData {
-    email?: string;
-    phone?: string;
-    firstName?: string;
-    lastName?: string;
-    street?: string;
-    city?: string;
-    postalCode?: string;
-    country?: string;
-}
-/**
- * Analytics context value
- */
-interface AnalyticsContextValue {
-    config: AnalyticsConfig;
-    isReady: boolean;
-    track: (event: string, properties?: EventData) => void;
-    trackPageView: (pagePath: string, pageTitle?: string) => void;
-    trackInteraction: (category: string, action: string, label?: string, value?: number) => void;
-    trackLead: (event: string, data?: Partial<LeadEventData>) => void;
-    trackEcommerce: (event: string, data: Partial<EcommerceEventData>) => void;
-    trackFunnelStage: (stage: string, data?: Partial<FunnelStageData>) => void;
-    trackFunnelAbandonment: (lastStage: string, reason?: string, data?: Record<string, any>) => void;
-    trackFunnelConversion: (type: string, value?: number, data?: Record<string, any>) => void;
-    trackExperiment: (experimentName: string, variant: string, userId?: string) => void;
-    trackFeatureFlag: (flagName: string, value: boolean | string, userId?: string) => void;
-    identify: (userId: string, traits?: Record<string, any>) => void;
-    sendUserData: (userData: UserData) => void;
-    getSessionId: () => string;
-    getFunnelPath: () => string[];
-    getTimeInFunnel: () => number;
-    clearSession: () => void;
-}
-/**
- * Storage utility functions
- */
-interface StorageUtils {
-    safeGetStorage: (storageType: "localStorage" | "sessionStorage", key: string) => string | null;
-    safeSetStorage: (storageType: "localStorage" | "sessionStorage", key: string, value: string) => void;
-    safeRemoveStorage: (storageType: "localStorage" | "sessionStorage", key: string) => void;
-}
-/**
- * Platform adapters interface
- */
-interface PlatformAdapter {
-    isReady(): boolean;
-    track(event: string, properties?: Record<string, any>): void;
-    identify?(userId: string, traits?: Record<string, any>): void;
-    reset?(): void;
-}
-/**
- * GTM adapter interface
- */
-interface GTMAdapter extends PlatformAdapter {
-    dataLayer: any[];
-}
-/**
- * PostHog adapter interface
- */
-interface PostHogAdapter extends PlatformAdapter {
-    posthog: any;
-}
-
-declare const AnalyticsContext: React.Context<AnalyticsContextValue | null>;
-interface AnalyticsProviderProps {
-    config: AnalyticsConfig;
-    children: React.ReactNode;
-}
-declare function AnalyticsProvider({ config, children, }: AnalyticsProviderProps): react_jsx_runtime.JSX.Element;
-
-/**
- * Hook to access analytics functionality
- * @throws Error if used outside of AnalyticsProvider
- */
-declare function useAnalytics(): AnalyticsContextValue;
-/**
- * Hook for simplified tracking
- */
-declare function useTrack(): {
-    track: (event: string, properties?: EventData) => void;
-    isReady: boolean;
-};
-/**
- * Hook for funnel tracking
- */
-declare function useFunnelTracking(): {
-    trackStage: (stage: string, data?: Partial<FunnelStageData>) => void;
-    trackAbandonment: (lastStage: string, reason?: string, data?: Record<string, any>) => void;
-    trackConversion: (type: string, value?: number, data?: Record<string, any>) => void;
-    getFunnelPath: () => string[];
-    getTimeInFunnel: () => number;
-    clearSession: () => void;
-    isReady: boolean;
-};
-/**
- * Hook for lead tracking
- */
-declare function useLeadTracking(): {
-    trackLead: (event: string, data?: Partial<LeadEventData>) => void;
-    sendUserData: (userData: UserData) => void;
-    isReady: boolean;
-};
-/**
- * Hook for e-commerce tracking
- */
-declare function useEcommerceTracking(): {
-    trackEcommerce: (event: string, data: Partial<EcommerceEventData>) => void;
-    isReady: boolean;
-};
-/**
- * Hook for experiment tracking
- */
-declare function useExperimentTracking(): {
-    trackExperiment: (experimentName: string, variant: string, userId?: string) => void;
-    trackFeatureFlag: (flagName: string, value: boolean | string, userId?: string) => void;
-    isReady: boolean;
-};
-
-/**
- * Get or create session ID
- */
-declare function getSessionId(): string;
-/**
- * Get funnel path
- */
-declare function getFunnelPath(): string[];
-/**
- * Get time in funnel (seconds)
- */
-declare function getTimeInFunnel(): number;
-/**
- * Clear session data
- */
-declare function clearSession(): void;
-/**
- * Get device type based on viewport
- */
-declare function getDeviceType(): 'mobile' | 'desktop' | 'tablet';
-/**
- * Get performance data
- */
-declare function getPerformanceData(): {
-    pageLoadTime: number;
-    timeToInteraction: number;
-    dns: number;
-    tcp: number;
-    ttfb: number;
-} | undefined;
-
-/**
- * Safe storage utilities for browser environments
- * Handles storage access errors gracefully
- */
-
-/**
- * Safely get value from storage
- */
-declare const safeGetStorage: StorageUtils['safeGetStorage'];
-/**
- * Safely set value in storage
- */
-declare const safeSetStorage: StorageUtils['safeSetStorage'];
-/**
- * Safely remove value from storage
- */
-declare const safeRemoveStorage: StorageUtils['safeRemoveStorage'];
-
-export { type AnalyticsConfig, AnalyticsContext, type AnalyticsContextValue, AnalyticsProvider, type EcommerceEventData, type EventData, type FormData, type FunnelConfig, type FunnelStageData, type GTMAdapter, type LeadEventData, type PerformanceData, type PlatformAdapter, type PostHogAdapter, type ScrollData, type UserData, clearSession, getDeviceType, getFunnelPath, getPerformanceData, getSessionId, getTimeInFunnel, safeGetStorage, safeRemoveStorage, safeSetStorage, useAnalytics, useEcommerceTracking, useExperimentTracking, useFunnelTracking, useLeadTracking, useTrack };

package/dist/index.d.ts

@@ -1,304 +0,0 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import React from 'react';
-export { ECOMMERCE_EVENTS, LEAD_GENERATION_EVENTS, LEAD_SCORES } from '@akson/cortex-utilities';
-
-/**
- * @akson/cortex-analytics-react - Type Definitions
- * Reusable types for analytics tracking across React applications
- */
-
-/**
- * Analytics configuration for projects
- */
-interface AnalyticsConfig {
-    platforms: {
-        gtm?: {
-            containerId: string;
-            workspaceId?: number;
-            publicId?: string;
-        };
-        posthog?: {
-            apiKey: string;
-            host?: string;
-        };
-        ga4?: {
-            measurementId: string;
-        };
-        googleAds?: {
-            accountId: string;
-        };
-        meta?: {
-            pixelId: string;
-        };
-    };
-    conversions?: Record<string, string>;
-    funnel?: FunnelConfig;
-    debug?: boolean;
-    enableEnhancedConversions?: boolean;
-}
-/**
- * Funnel configuration
- */
-interface FunnelConfig {
-    stages?: Record<string, string[]>;
-    scoring?: (stage: string) => number;
-    abandonmentTracking?: boolean;
-    sessionTimeout?: number;
-}
-/**
- * Event data for tracking
- */
-interface EventData {
-    [key: string]: any;
-    event_category?: string;
-    event_label?: string;
-    event_value?: number;
-    standardized_event?: boolean;
-    timestamp?: string;
-    sessionId?: string;
-}
-/**
- * Lead event data
- */
-interface LeadEventData extends EventData {
-    lead_score: number;
-    funnel_stage?: string;
-    contact_method?: string;
-    source?: string;
-    language?: string;
-    device?: "mobile" | "desktop" | "tablet";
-}
-/**
- * E-commerce event data
- */
-interface EcommerceEventData extends EventData {
-    value: number;
-    currency: string;
-    transaction_id?: string;
-    items?: Array<{
-        item_id?: string;
-        item_name: string;
-        price: number;
-        quantity?: number;
-    }>;
-}
-/**
- * Funnel stage data
- */
-interface FunnelStageData {
-    stage: string;
-    previousStage?: string;
-    timeOnStage?: number;
-    totalTimeInFunnel?: number;
-    experimentVariants?: Record<string, string>;
-    formData?: FormData;
-    scrollData?: ScrollData;
-    performanceData?: PerformanceData;
-    source?: string;
-    language?: string;
-    device?: "mobile" | "desktop" | "tablet";
-    sessionId?: string;
-    userAgent?: string;
-    viewport?: string;
-    screenResolution?: string;
-}
-/**
- * Form tracking data
- */
-interface FormData {
-    step?: number;
-    stepName?: string;
-    fieldsCompleted?: number;
-    totalFields?: number;
-    completionPercentage?: number;
-    filledFields?: string[];
-    emptyFields?: string[];
-}
-/**
- * Scroll tracking data
- */
-interface ScrollData {
-    maxScrollPercent?: number;
-    timeToMaxScroll?: number;
-}
-/**
- * Performance tracking data
- */
-interface PerformanceData {
-    pageLoadTime?: number;
-    timeToInteraction?: number;
-    dns?: number;
-    tcp?: number;
-    ttfb?: number;
-}
-/**
- * User data for enhanced conversions
- */
-interface UserData {
-    email?: string;
-    phone?: string;
-    firstName?: string;
-    lastName?: string;
-    street?: string;
-    city?: string;
-    postalCode?: string;
-    country?: string;
-}
-/**
- * Analytics context value
- */
-interface AnalyticsContextValue {
-    config: AnalyticsConfig;
-    isReady: boolean;
-    track: (event: string, properties?: EventData) => void;
-    trackPageView: (pagePath: string, pageTitle?: string) => void;
-    trackInteraction: (category: string, action: string, label?: string, value?: number) => void;
-    trackLead: (event: string, data?: Partial<LeadEventData>) => void;
-    trackEcommerce: (event: string, data: Partial<EcommerceEventData>) => void;
-    trackFunnelStage: (stage: string, data?: Partial<FunnelStageData>) => void;
-    trackFunnelAbandonment: (lastStage: string, reason?: string, data?: Record<string, any>) => void;
-    trackFunnelConversion: (type: string, value?: number, data?: Record<string, any>) => void;
-    trackExperiment: (experimentName: string, variant: string, userId?: string) => void;
-    trackFeatureFlag: (flagName: string, value: boolean | string, userId?: string) => void;
-    identify: (userId: string, traits?: Record<string, any>) => void;
-    sendUserData: (userData: UserData) => void;
-    getSessionId: () => string;
-    getFunnelPath: () => string[];
-    getTimeInFunnel: () => number;
-    clearSession: () => void;
-}
-/**
- * Storage utility functions
- */
-interface StorageUtils {
-    safeGetStorage: (storageType: "localStorage" | "sessionStorage", key: string) => string | null;
-    safeSetStorage: (storageType: "localStorage" | "sessionStorage", key: string, value: string) => void;
-    safeRemoveStorage: (storageType: "localStorage" | "sessionStorage", key: string) => void;
-}
-/**
- * Platform adapters interface
- */
-interface PlatformAdapter {
-    isReady(): boolean;
-    track(event: string, properties?: Record<string, any>): void;
-    identify?(userId: string, traits?: Record<string, any>): void;
-    reset?(): void;
-}
-/**
- * GTM adapter interface
- */
-interface GTMAdapter extends PlatformAdapter {
-    dataLayer: any[];
-}
-/**
- * PostHog adapter interface
- */
-interface PostHogAdapter extends PlatformAdapter {
-    posthog: any;
-}
-
-declare const AnalyticsContext: React.Context<AnalyticsContextValue | null>;
-interface AnalyticsProviderProps {
-    config: AnalyticsConfig;
-    children: React.ReactNode;
-}
-declare function AnalyticsProvider({ config, children, }: AnalyticsProviderProps): react_jsx_runtime.JSX.Element;
-
-/**
- * Hook to access analytics functionality
- * @throws Error if used outside of AnalyticsProvider
- */
-declare function useAnalytics(): AnalyticsContextValue;
-/**
- * Hook for simplified tracking
- */
-declare function useTrack(): {
-    track: (event: string, properties?: EventData) => void;
-    isReady: boolean;
-};
-/**
- * Hook for funnel tracking
- */
-declare function useFunnelTracking(): {
-    trackStage: (stage: string, data?: Partial<FunnelStageData>) => void;
-    trackAbandonment: (lastStage: string, reason?: string, data?: Record<string, any>) => void;
-    trackConversion: (type: string, value?: number, data?: Record<string, any>) => void;
-    getFunnelPath: () => string[];
-    getTimeInFunnel: () => number;
-    clearSession: () => void;
-    isReady: boolean;
-};
-/**
- * Hook for lead tracking
- */
-declare function useLeadTracking(): {
-    trackLead: (event: string, data?: Partial<LeadEventData>) => void;
-    sendUserData: (userData: UserData) => void;
-    isReady: boolean;
-};
-/**
- * Hook for e-commerce tracking
- */
-declare function useEcommerceTracking(): {
-    trackEcommerce: (event: string, data: Partial<EcommerceEventData>) => void;
-    isReady: boolean;
-};
-/**
- * Hook for experiment tracking
- */
-declare function useExperimentTracking(): {
-    trackExperiment: (experimentName: string, variant: string, userId?: string) => void;
-    trackFeatureFlag: (flagName: string, value: boolean | string, userId?: string) => void;
-    isReady: boolean;
-};
-
-/**
- * Get or create session ID
- */
-declare function getSessionId(): string;
-/**
- * Get funnel path
- */
-declare function getFunnelPath(): string[];
-/**
- * Get time in funnel (seconds)
- */
-declare function getTimeInFunnel(): number;
-/**
- * Clear session data
- */
-declare function clearSession(): void;
-/**
- * Get device type based on viewport
- */
-declare function getDeviceType(): 'mobile' | 'desktop' | 'tablet';
-/**
- * Get performance data
- */
-declare function getPerformanceData(): {
-    pageLoadTime: number;
-    timeToInteraction: number;
-    dns: number;
-    tcp: number;
-    ttfb: number;
-} | undefined;
-
-/**
- * Safe storage utilities for browser environments
- * Handles storage access errors gracefully
- */
-
-/**
- * Safely get value from storage
- */
-declare const safeGetStorage: StorageUtils['safeGetStorage'];
-/**
- * Safely set value in storage
- */
-declare const safeSetStorage: StorageUtils['safeSetStorage'];
-/**
- * Safely remove value from storage
- */
-declare const safeRemoveStorage: StorageUtils['safeRemoveStorage'];
-
-export { type AnalyticsConfig, AnalyticsContext, type AnalyticsContextValue, AnalyticsProvider, type EcommerceEventData, type EventData, type FormData, type FunnelConfig, type FunnelStageData, type GTMAdapter, type LeadEventData, type PerformanceData, type PlatformAdapter, type PostHogAdapter, type ScrollData, type UserData, clearSession, getDeviceType, getFunnelPath, getPerformanceData, getSessionId, getTimeInFunnel, safeGetStorage, safeRemoveStorage, safeSetStorage, useAnalytics, useEcommerceTracking, useExperimentTracking, useFunnelTracking, useLeadTracking, useTrack };