unified-video-framework 1.4.159 → 1.4.160

package/src/analytics/examples/DynamicAnalyticsExample.ts

@@ -1,324 +0,0 @@
-/**
- * Example: Dynamic Analytics Integration
- * Shows how to integrate your existing player analytics API with the video framework
- */
-
-import {
-  DynamicAnalyticsManager,
-  createDynamicAnalyticsManager,
-  createPlayerAnalyticsProviderConfig,
-  AnalyticsProviderType,
-  DynamicAnalyticsConfig
-} from '../index';
-
-// Example 1: Basic Player Analytics Integration
-export function createBasicPlayerAnalytics() {
-  const config: DynamicAnalyticsConfig = {
-    enabled: true,
-    providers: [
-      {
-        name: 'flicknexs-analytics',
-        type: AnalyticsProviderType.PLAYER_ANALYTICS,
-        enabled: true,
-        priority: 1,
-        config: createPlayerAnalyticsProviderConfig(
-          'https://api.flicknexs.com', // Your base URL
-          'your-api-key-here',          // Your API key
-          'video-player-main',          // Player ID
-          {
-            tenantId: 'flicknexs-tenant', // Optional tenant ID
-            heartbeatInterval: 10,         // 10 seconds
-            batchSize: 10,                // 10 events per batch
-            flushInterval: 30             // 30 seconds
-          }
-        )
-      }
-    ],
-    globalSettings: {
-      enableConsoleLogging: true,
-      enableErrorReporting: true,
-      sessionTimeout: 60 // 60 minutes
-    }
-  };
-
-  return createDynamicAnalyticsManager(config);
-}
-
-// Example 2: Multiple Analytics Providers
-export function createMultiProviderAnalytics() {
-  const config: DynamicAnalyticsConfig = {
-    enabled: true,
-    providers: [
-      // Primary: Your Player Analytics API
-      {
-        name: 'player-analytics',
-        type: AnalyticsProviderType.PLAYER_ANALYTICS,
-        enabled: true,
-        priority: 1,
-        config: createPlayerAnalyticsProviderConfig(
-          process.env.ANALYTICS_BASE_URL || 'https://api.flicknexs.com',
-          process.env.ANALYTICS_API_KEY || 'your-api-key',
-          'main-player',
-          {
-            tenantId: process.env.TENANT_ID,
-            heartbeatInterval: 10,
-            batchSize: 10,
-            flushInterval: 30
-          }
-        )
-      },
-      // Secondary: Custom Analytics Provider (e.g., Google Analytics)
-      {
-        name: 'google-analytics',
-        type: AnalyticsProviderType.CUSTOM,
-        enabled: true,
-        priority: 2,
-        config: {
-          factory: (config: any) => new CustomGoogleAnalyticsProvider(config),
-          measurementId: 'G-XXXXXXXXXX',
-          apiSecret: 'your-ga4-secret'
-        }
-      }
-    ],
-    globalSettings: {
-      enableConsoleLogging: process.env.NODE_ENV !== 'production',
-      enableErrorReporting: true,
-      sessionTimeout: 90 // 90 minutes
-    }
-  };
-
-  return createDynamicAnalyticsManager(config);
-}
-
-// Example 3: Usage with Video Player
-export class VideoPlayerWithAnalytics {
-  private analyticsManager: DynamicAnalyticsManager;
-  private currentVideoInfo: any = null;
-
-  constructor(analyticsConfig: DynamicAnalyticsConfig) {
-    this.analyticsManager = createDynamicAnalyticsManager(analyticsConfig);
-    this.setupAnalyticsEvents();
-  }
-
-  public loadVideo(videoInfo: {
-    id: string;
-    title: string;
-    type: 'video' | 'series' | 'episode' | 'live';
-    duration: number;
-    url: string;
-    isLive?: boolean;
-    metadata?: Record<string, any>;
-  }): void {
-    this.currentVideoInfo = videoInfo;
-    
-    // Start analytics session
-    const sessionId = this.analyticsManager.startSession(videoInfo, {
-      userId: this.getCurrentUserId(),
-      appVersion: '1.0.0',
-      platform: 'web'
-    });
-    
-    console.log(`Started analytics session: ${sessionId}`);
-  }
-
-  public play(): void {
-    // Your player play logic here
-    // ...
-
-    // Track analytics
-    this.analyticsManager.trackEvent('play', this.getPlayerState());
-  }
-
-  public pause(): void {
-    // Your player pause logic here
-    // ...
-
-    // Track analytics
-    this.analyticsManager.trackEvent('pause', this.getPlayerState());
-  }
-
-  public seek(time: number): void {
-    const currentTime = this.getPlayerState().currentTime;
-    
-    // Your player seek logic here
-    // ...
-
-    // Track analytics
-    this.analyticsManager.trackEvent('seeking', this.getPlayerState(), {
-      seekFrom: currentTime,
-      seekTo: time
-    });
-  }
-
-  public onError(error: any): void {
-    // Track error
-    this.analyticsManager.trackCustomEvent('error', {
-      errorCode: error.code,
-      errorMessage: error.message,
-      errorType: 'player_error',
-      currentTime: this.getPlayerState().currentTime
-    });
-  }
-
-  public onQualityChange(newQuality: string, previousQuality: string): void {
-    this.analyticsManager.trackCustomEvent('quality_change', {
-      newQuality,
-      previousQuality,
-      reason: 'user_selected'
-    });
-  }
-
-  public onChapterSkip(chapterId: string, chapterType: string): void {
-    this.analyticsManager.trackCustomEvent('custom_chapter_skip', {
-      chapterId,
-      chapterType,
-      skipReason: 'manual'
-    });
-  }
-
-  public destroy(): void {
-    // End analytics session before destroying
-    this.analyticsManager.endSession();
-    this.analyticsManager.destroy();
-  }
-
-  private setupAnalyticsEvents(): void {
-    // Listen to analytics events
-    this.analyticsManager.on('sessionStart', (data) => {
-      console.log('Analytics session started:', data);
-    });
-
-    this.analyticsManager.on('sessionEnd', (data) => {
-      console.log('Analytics session ended:', data);
-    });
-
-    this.analyticsManager.on('error', (error) => {
-      console.error('Analytics error:', error);
-    });
-  }
-
-  private getPlayerState(): any {
-    // Return current player state
-    // This should come from your actual player implementation
-    return {
-      currentTime: 120, // current playback time in seconds
-      duration: 3600,   // total duration in seconds
-      volume: 0.8,      // volume level 0-1
-      muted: false,     // is muted
-      paused: false,    // is paused
-      ended: false,     // has ended
-      fullscreen: false, // is fullscreen
-      playbackRate: 1,   // playback rate
-      qualityLevel: '1080p', // current quality
-      buffered: null,    // buffered ranges
-      seekable: null,    // seekable ranges
-      networkState: 2,   // network state
-      readyState: 4      // ready state
-    };
-  }
-
-  private getCurrentUserId(): string {
-    // Get current user ID from your auth system
-    return 'user123';
-  }
-}
-
-// Example 4: Custom Analytics Provider Implementation
-class CustomGoogleAnalyticsProvider {
-  private config: any;
-  private sessionId: string | null = null;
-
-  constructor(config: any) {
-    this.config = config;
-  }
-
-  startSession(videoInfo: any, customData?: any): string {
-    this.sessionId = `ga_${Date.now()}`;
-    
-    // Send to Google Analytics
-    gtag('event', 'video_start', {
-      video_title: videoInfo.title,
-      video_id: videoInfo.id,
-      custom_parameter_1: customData?.userId
-    });
-
-    return this.sessionId;
-  }
-
-  async endSession(): Promise<void> {
-    if (this.sessionId) {
-      gtag('event', 'video_end', {
-        session_id: this.sessionId
-      });
-      this.sessionId = null;
-    }
-  }
-
-  trackEvent(event: any, playerState?: any, videoInfo?: any): void {
-    gtag('event', `video_${event.eventType}`, {
-      video_id: event.videoId,
-      current_time: event.currentTime,
-      session_id: this.sessionId
-    });
-  }
-
-  trackCustomEvent(eventType: string, data?: any): void {
-    gtag('event', eventType, {
-      ...data,
-      session_id: this.sessionId
-    });
-  }
-
-  async flush(): Promise<void> {
-    // Google Analytics doesn't require explicit flushing
-  }
-
-  getCurrentSession(): any {
-    return { sessionId: this.sessionId };
-  }
-
-  destroy(): void {
-    this.sessionId = null;
-  }
-}
-
-// Example 5: Environment-based Configuration
-export function createEnvironmentAnalytics() {
-  const isDevelopment = process.env.NODE_ENV === 'development';
-  const isProduction = process.env.NODE_ENV === 'production';
-
-  const config: DynamicAnalyticsConfig = {
-    enabled: !isDevelopment || process.env.ENABLE_DEV_ANALYTICS === 'true',
-    providers: [
-      {
-        name: 'player-analytics',
-        type: AnalyticsProviderType.PLAYER_ANALYTICS,
-        enabled: true,
-        priority: 1,
-        config: createPlayerAnalyticsProviderConfig(
-          process.env.ANALYTICS_BASE_URL || 'https://api.flicknexs.com',
-          process.env.ANALYTICS_API_KEY || '',
-          process.env.PLAYER_ID || 'default-player',
-          {
-            tenantId: process.env.TENANT_ID,
-            heartbeatInterval: isDevelopment ? 5 : 10, // More frequent in dev
-            batchSize: isDevelopment ? 5 : 10,         // Smaller batches in dev
-            flushInterval: isDevelopment ? 15 : 30     // More frequent flushing in dev
-          }
-        )
-      }
-    ],
-    globalSettings: {
-      enableConsoleLogging: isDevelopment,
-      enableErrorReporting: true,
-      sessionTimeout: isProduction ? 120 : 30 // Longer timeout in production
-    }
-  };
-
-  return createDynamicAnalyticsManager(config);
-}
-
-// Global gtag function declaration for TypeScript
-declare global {
-  function gtag(...args: any[]): void;
-}

package/src/analytics/index.ts

@@ -1,60 +0,0 @@
-/**
- * Video Player Analytics - Main module exports
- * Comprehensive analytics tracking for video players with dynamic provider support
- */
-
-// Core classes
-export { PlayerAnalytics } from './core/PlayerAnalytics';
-export { EventBatcher } from './core/EventBatcher';
-export { AnalyticsProvider, createAnalyticsProvider, getDefaultAnalyticsConfig } from './core/AnalyticsProvider';
-
-// Dynamic Analytics System
-export { 
-  DynamicAnalyticsManager, 
-  createDynamicAnalyticsManager,
-  createPlayerAnalyticsProviderConfig,
-  AnalyticsProviderType
-} from './core/DynamicAnalyticsManager';
-export type {
-  BaseAnalyticsProvider,
-  DynamicAnalyticsConfig
-} from './core/DynamicAnalyticsManager';
-
-// Analytics Adapters
-export { 
-  PlayerAnalyticsAdapter, 
-  createPlayerAnalyticsAdapter
-} from './adapters/PlayerAnalyticsAdapter';
-export type {
-  PlayerAnalyticsConfig,
-  AnalyticsSession,
-  VideoInfo,
-  DeviceData,
-  PlayerData,
-  EngagementData,
-  ErrorData,
-  AnalyticsEventData,
-  AnalyticsPayload
-} from './adapters/PlayerAnalyticsAdapter';
-
-// Types and interfaces
-export * from './types/AnalyticsTypes';
-
-// Utilities
-export { DeviceDetection, deviceDetection } from './utils/DeviceDetection';
-
-// Re-export commonly used types for convenience
-export type {
-  AnalyticsEvent,
-  PlayerSessionInfo,
-  AnalyticsConfig,
-  DeviceInfo,
-  PlayerState,
-  PlayerEventType,
-  UserInteractionType,
-  QualityLevel,
-  VideoType,
-  AnalyticsEventHandler,
-  UseAnalyticsReturn,
-  AnalyticsContextValue
-} from './types/AnalyticsTypes';