@therealtinhtute/baroiplayer 1.0.8 → 1.1.0

package/src/core/plugins/examples/analytics-plugin.ts

@@ -1,242 +1,241 @@
-import { BasePlugin, type AnalyticsPluginConfig } from '../base-plugin'
+import { type AnalyticsPluginConfig, BasePlugin } from "../base-plugin"
 
 interface AnalyticsEvent {
-  event: string
-  timestamp: number
-  data?: any
+	event: string
+	timestamp: number
+	data?: any
 }
 
 interface AnalyticsConfig extends AnalyticsPluginConfig {
-  trackingId: string
-  events: string[]
-  samplingRate: number
-  debug: boolean
-  endpoint?: string
+	trackingId: string
+	events: string[]
+	samplingRate: number
+	debug: boolean
+	endpoint?: string
 }
 
 export class AnalyticsPlugin extends BasePlugin {
-  private events: AnalyticsEvent[] = []
-  private analyticsConfig!: AnalyticsConfig
-  private cleanupFunctions: Array<() => void> = []
-  private reportTimer?: NodeJS.Timeout
-
-  constructor(config?: AnalyticsPluginConfig) {
-    super({
-      name: 'analytics',
-      description: 'Media player analytics and tracking',
-      category: 'analytics',
-      priority: 'low',
-      author: 'BaroiPlayer Team'
-    })
-  }
-
-  protected onInitialize(): void {
-    this.analyticsConfig = this.createConfig<AnalyticsConfig>({
-      trackingId: '',
-      events: ['play', 'pause', 'seek', 'ended', 'error'],
-      samplingRate: 1.0,
-      debug: false,
-      endpoint: '/api/analytics'
-    })
-
-    if (!this.analyticsConfig.trackingId) {
-      throw new Error('Analytics plugin requires a tracking ID')
-    }
-
-    this.logger?.info('Analytics plugin initialized', { 
-      trackingId: this.analyticsConfig.trackingId,
-      events: this.analyticsConfig.events 
-    })
-  }
-
-  protected onActivate(): void {
-    // Set up event listeners for media events
-    const mediaEventCleanup = this.setupMediaEventListeners()
-    this.cleanupFunctions.push(mediaEventCleanup)
-
-    // Set up periodic reporting
-    if (this.analyticsConfig.endpoint) {
-      this.reportTimer = setInterval(() => {
-        this.reportEvents()
-      }, 30000) // Report every 30 seconds
-
-      this.cleanupFunctions.push(() => {
-        if (this.reportTimer) {
-          clearInterval(this.reportTimer)
-        }
-      })
-    }
-
-    this.trackEvent('plugin_activated', { plugin: 'analytics' })
-    this.logger?.info('Analytics tracking started')
-  }
-
-  protected onDeactivate(): void {
-    // Clean up all event listeners and timers
-    this.cleanupFunctions.forEach(cleanup => cleanup())
-    this.cleanupFunctions = []
-
-    // Report any remaining events
-    if (this.events.length > 0) {
-      this.reportEvents()
-    }
-
-    this.trackEvent('plugin_deactivated', { plugin: 'analytics' })
-    this.logger?.info('Analytics tracking stopped')
-  }
-
-  protected onConfigure(newConfig: AnalyticsConfig): void {
-    // Update tracking configuration  
-    this.analyticsConfig = { ...this.analyticsConfig, ...newConfig }
-    if (newConfig.events) {
-      // Re-setup event listeners if events changed
-      this.cleanupFunctions.forEach(cleanup => cleanup())
-      this.cleanupFunctions = []
-      
-      const mediaEventCleanup = this.setupMediaEventListeners()
-      this.cleanupFunctions.push(mediaEventCleanup)
-    }
-  }
-
-  private setupMediaEventListeners(): () => void {
-    const cleanupFunctions: Array<() => void> = []
-
-    // Listen for media state changes
-    if (this.analyticsConfig.events.includes('play')) {
-      const unsubscribe = this.on('media:play', (data) => {
-        this.trackEvent('play', data)
-      })
-      cleanupFunctions.push(unsubscribe)
-    }
-
-    if (this.analyticsConfig.events.includes('pause')) {
-      const unsubscribe = this.on('media:pause', (data) => {
-        this.trackEvent('pause', data)
-      })
-      cleanupFunctions.push(unsubscribe)
-    }
-
-    if (this.analyticsConfig.events.includes('seek')) {
-      const unsubscribe = this.on('media:seek', (data) => {
-        this.trackEvent('seek', data)
-      })
-      cleanupFunctions.push(unsubscribe)
-    }
-
-    if (this.analyticsConfig.events.includes('ended')) {
-      const unsubscribe = this.on('media:ended', (data) => {
-        this.trackEvent('ended', data)
-      })
-      cleanupFunctions.push(unsubscribe)
-    }
-
-    if (this.analyticsConfig.events.includes('error')) {
-      const unsubscribe = this.on('media:error', (data) => {
-        this.trackEvent('error', data)
-      })
-      cleanupFunctions.push(unsubscribe)
-    }
-
-    // Return cleanup function
-    return () => {
-      cleanupFunctions.forEach(cleanup => cleanup())
-    }
-  }
-
-  private trackEvent(event: string, data?: any): void {
-    // Apply sampling rate
-    if (Math.random() > this.analyticsConfig.samplingRate) {
-      return
-    }
-
-    const analyticsEvent: AnalyticsEvent = {
-      event,
-      timestamp: Date.now(),
-      data: {
-        ...data,
-        trackingId: this.analyticsConfig.trackingId,
-        sessionId: this.generateSessionId(),
-        mediaState: {
-          currentTime: this.state?.currentTime,
-          duration: this.state?.duration,
-          volume: this.state?.volume,
-          isPlaying: this.state?.isPlaying
-        }
-      }
-    }
-
-    this.events.push(analyticsEvent)
-
-    if (this.analyticsConfig.debug) {
-      this.logger?.info('Analytics event tracked', analyticsEvent)
-    }
-
-    // Emit event for other plugins or applications to use
-    this.emit('analytics:event', analyticsEvent)
-  }
-
-  private async reportEvents(): Promise<void> {
-    if (this.events.length === 0 || !this.analyticsConfig.endpoint) {
-      return
-    }
-
-    const eventsToReport = [...this.events]
-    this.events = []
-
-    try {
-      const response = await fetch(this.analyticsConfig.endpoint, {
-        method: 'POST',
-        headers: {
-          'Content-Type': 'application/json'
-        },
-        body: JSON.stringify({
-          trackingId: this.analyticsConfig.trackingId,
-          events: eventsToReport
-        })
-      })
-
-      if (!response.ok) {
-        throw new Error(`Analytics report failed: ${response.status}`)
-      }
-
-      if (this.analyticsConfig.debug) {
-        this.logger?.info(`Reported ${eventsToReport.length} analytics events`)
-      }
-
-    } catch (error) {
-      // Put events back in queue on failure
-      this.events.unshift(...eventsToReport)
-      this.logger?.error('Failed to report analytics events', error)
-    }
-  }
-
-  private generateSessionId(): string {
-    // Simple session ID generation - could be more sophisticated
-    return `session_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`
-  }
-
-  // Public API for manual event tracking
-  public track(event: string, data?: any): void {
-    this.trackEvent(event, data)
-  }
-
-  // Get pending events count
-  public getPendingEventsCount(): number {
-    return this.events.length
-  }
-
-  // Flush all pending events
-  public async flush(): Promise<void> {
-    await this.reportEvents()
-  }
-
-  protected onHealthCheck(): boolean {
-    // Check if we're not accumulating too many events
-    return this.events.length < 1000
-  }
+	private events: AnalyticsEvent[] = []
+	private analyticsConfig!: AnalyticsConfig
+	private cleanupFunctions: Array<() => void> = []
+	private reportTimer?: NodeJS.Timeout
+
+	constructor(config?: AnalyticsPluginConfig) {
+		super({
+			name: "analytics",
+			description: "Media player analytics and tracking",
+			category: "analytics",
+			priority: "low",
+			author: "BaroiPlayer Team"
+		})
+	}
+
+	protected onInitialize(): void {
+		this.analyticsConfig = this.createConfig<AnalyticsConfig>({
+			trackingId: "",
+			events: ["play", "pause", "seek", "ended", "error"],
+			samplingRate: 1.0,
+			debug: false,
+			endpoint: "/api/analytics"
+		})
+
+		if (!this.analyticsConfig.trackingId) {
+			throw new Error("Analytics plugin requires a tracking ID")
+		}
+
+		this.logger?.info("Analytics plugin initialized", {
+			trackingId: this.analyticsConfig.trackingId,
+			events: this.analyticsConfig.events
+		})
+	}
+
+	protected onActivate(): void {
+		// Set up event listeners for media events
+		const mediaEventCleanup = this.setupMediaEventListeners()
+		this.cleanupFunctions.push(mediaEventCleanup)
+
+		// Set up periodic reporting
+		if (this.analyticsConfig.endpoint) {
+			this.reportTimer = setInterval(() => {
+				this.reportEvents()
+			}, 30000) // Report every 30 seconds
+
+			this.cleanupFunctions.push(() => {
+				if (this.reportTimer) {
+					clearInterval(this.reportTimer)
+				}
+			})
+		}
+
+		this.trackEvent("plugin_activated", { plugin: "analytics" })
+		this.logger?.info("Analytics tracking started")
+	}
+
+	protected onDeactivate(): void {
+		// Clean up all event listeners and timers
+		this.cleanupFunctions.forEach((cleanup) => cleanup())
+		this.cleanupFunctions = []
+
+		// Report any remaining events
+		if (this.events.length > 0) {
+			this.reportEvents()
+		}
+
+		this.trackEvent("plugin_deactivated", { plugin: "analytics" })
+		this.logger?.info("Analytics tracking stopped")
+	}
+
+	protected onConfigure(newConfig: AnalyticsConfig): void {
+		// Update tracking configuration
+		this.analyticsConfig = { ...this.analyticsConfig, ...newConfig }
+		if (newConfig.events) {
+			// Re-setup event listeners if events changed
+			this.cleanupFunctions.forEach((cleanup) => cleanup())
+			this.cleanupFunctions = []
+
+			const mediaEventCleanup = this.setupMediaEventListeners()
+			this.cleanupFunctions.push(mediaEventCleanup)
+		}
+	}
+
+	private setupMediaEventListeners(): () => void {
+		const cleanupFunctions: Array<() => void> = []
+
+		// Listen for media state changes
+		if (this.analyticsConfig.events.includes("play")) {
+			const unsubscribe = this.on("media:play", (data) => {
+				this.trackEvent("play", data)
+			})
+			cleanupFunctions.push(unsubscribe)
+		}
+
+		if (this.analyticsConfig.events.includes("pause")) {
+			const unsubscribe = this.on("media:pause", (data) => {
+				this.trackEvent("pause", data)
+			})
+			cleanupFunctions.push(unsubscribe)
+		}
+
+		if (this.analyticsConfig.events.includes("seek")) {
+			const unsubscribe = this.on("media:seek", (data) => {
+				this.trackEvent("seek", data)
+			})
+			cleanupFunctions.push(unsubscribe)
+		}
+
+		if (this.analyticsConfig.events.includes("ended")) {
+			const unsubscribe = this.on("media:ended", (data) => {
+				this.trackEvent("ended", data)
+			})
+			cleanupFunctions.push(unsubscribe)
+		}
+
+		if (this.analyticsConfig.events.includes("error")) {
+			const unsubscribe = this.on("media:error", (data) => {
+				this.trackEvent("error", data)
+			})
+			cleanupFunctions.push(unsubscribe)
+		}
+
+		// Return cleanup function
+		return () => {
+			cleanupFunctions.forEach((cleanup) => cleanup())
+		}
+	}
+
+	private trackEvent(event: string, data?: any): void {
+		// Apply sampling rate
+		if (Math.random() > this.analyticsConfig.samplingRate) {
+			return
+		}
+
+		const analyticsEvent: AnalyticsEvent = {
+			event,
+			timestamp: Date.now(),
+			data: {
+				...data,
+				trackingId: this.analyticsConfig.trackingId,
+				sessionId: this.generateSessionId(),
+				mediaState: {
+					currentTime: this.state?.currentTime,
+					duration: this.state?.duration,
+					volume: this.state?.volume,
+					isPlaying: this.state?.isPlaying
+				}
+			}
+		}
+
+		this.events.push(analyticsEvent)
+
+		if (this.analyticsConfig.debug) {
+			this.logger?.info("Analytics event tracked", analyticsEvent)
+		}
+
+		// Emit event for other plugins or applications to use
+		this.emit("analytics:event", analyticsEvent)
+	}
+
+	private async reportEvents(): Promise<void> {
+		if (this.events.length === 0 || !this.analyticsConfig.endpoint) {
+			return
+		}
+
+		const eventsToReport = [...this.events]
+		this.events = []
+
+		try {
+			const response = await fetch(this.analyticsConfig.endpoint, {
+				method: "POST",
+				headers: {
+					"Content-Type": "application/json"
+				},
+				body: JSON.stringify({
+					trackingId: this.analyticsConfig.trackingId,
+					events: eventsToReport
+				})
+			})
+
+			if (!response.ok) {
+				throw new Error(`Analytics report failed: ${response.status}`)
+			}
+
+			if (this.analyticsConfig.debug) {
+				this.logger?.info(`Reported ${eventsToReport.length} analytics events`)
+			}
+		} catch (error) {
+			// Put events back in queue on failure
+			this.events.unshift(...eventsToReport)
+			this.logger?.error("Failed to report analytics events", error)
+		}
+	}
+
+	private generateSessionId(): string {
+		// Simple session ID generation - could be more sophisticated
+		return `session_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`
+	}
+
+	// Public API for manual event tracking
+	public track(event: string, data?: any): void {
+		this.trackEvent(event, data)
+	}
+
+	// Get pending events count
+	public getPendingEventsCount(): number {
+		return this.events.length
+	}
+
+	// Flush all pending events
+	public async flush(): Promise<void> {
+		await this.reportEvents()
+	}
+
+	protected onHealthCheck(): boolean {
+		// Check if we're not accumulating too many events
+		return this.events.length < 1000
+	}
 }
 
 // Plugin factory
 export const createAnalyticsPlugin = (config?: AnalyticsPluginConfig) => {
-  return new AnalyticsPlugin(config)
-}
+	return new AnalyticsPlugin(config)
+}

package/src/core/plugins/index.ts

@@ -1,39 +1,39 @@
 // Plugin system core exports
 export type {
-  Plugin,
-  PluginFactory,
-  PluginConfig,
-  PluginRegistry as IPluginRegistry,
-  PluginContext,
-  PluginLogger,
-  PluginMetadata,
-  PluginCategory,
-  PluginPriority,
-  PluginPhase,
-  PluginEvents
-} from './types'
+	Plugin,
+	PluginFactory,
+	PluginConfig,
+	PluginRegistry as IPluginRegistry,
+	PluginContext,
+	PluginLogger,
+	PluginMetadata,
+	PluginCategory,
+	PluginPriority,
+	PluginPhase,
+	PluginEvents
+} from "./types"
 
 export {
-  PluginError,
-  PluginDependencyError,
-  PluginConflictError
-} from './types'
+	PluginError,
+	PluginDependencyError,
+	PluginConflictError
+} from "./types"
 
-export { PluginRegistry } from './registry'
+export { PluginRegistry } from "./registry"
 
 export {
-  BasePlugin,
-  createPlugin,
-  type UIPluginConfig,
-  type AnalyticsPluginConfig,
-  type PerformancePluginConfig
-} from './base-plugin'
+	BasePlugin,
+	createPlugin,
+	type UIPluginConfig,
+	type AnalyticsPluginConfig,
+	type PerformancePluginConfig
+} from "./base-plugin"
 
 // Example plugins
-export { AnalyticsPlugin, createAnalyticsPlugin } from './examples/analytics-plugin'
+export { AnalyticsPlugin, createAnalyticsPlugin } from "./examples/analytics-plugin"
 
 // Plugin utilities
-export * from './utils'
+export * from "./utils"
 
 // Version
-export const PLUGIN_SYSTEM_VERSION = '1.0.0'
+export const PLUGIN_SYSTEM_VERSION = "1.0.0"