veza/apps/web/src/services/analyticsService.ts

/**
 * Monitor 3: User Analytics Service
 * Tracks feature usage and user interactions
 */

import { apiClient } from './api/client';
import { logger } from '@/utils/logger';

export const analyticsService = {
  /**
   * Monitor 3: Record a user analytics event
   * Tracks feature usage and user interactions
   * @param eventName - Name of the event (e.g., 'feature_used', 'button_clicked')
   * @param payload - Optional event data (e.g., { feature: 'search', query: '...' })
   */
  recordEvent: async (eventName: string, payload?: Record<string, unknown>) => {
    try {
      // Send event to backend analytics endpoint
      await apiClient.post('/analytics/events', {
        event_name: eventName,
        payload: payload || {},
      });

      // Log in development for debugging
      if (import.meta.env.DEV) {
        logger.debug('[Analytics] Event recorded', {
          event_name: eventName,
          payload,
        });
      }
    } catch (error) {
      // Don't throw errors for analytics - fail silently to avoid disrupting user experience
      if (import.meta.env.DEV) {
        logger.warn('[Analytics] Failed to record event', {
          event_name: eventName,
          error: error instanceof Error ? error.message : String(error),
        });
      }
    }
  },

  getGlobalStats: async (range: string = '30d') => {
    try {
      const response = await apiClient.get<{ data?: Record<string, unknown> }>('/analytics', {
        params: { days: range.replace('d', '') }
      });

      const data = response.data?.data ?? response.data;
      if (!data || typeof data !== 'object') {
        return {};
      }

      return {
        total_tracks: data.total_tracks ?? 0,
        total_plays: data.total_plays ?? 0,
        total_revenue: data.total_revenue ?? 0,
        followers: data.followers ?? 0,
        profile_views: data.profile_views ?? 0,
        trends: data.trends ?? { plays: 0, revenue: 0, followers: 0, views: 0 },
        sparklines: data.sparklines ?? { plays: [0], revenue: [0], followers: [0], views: [0] },
      };
    } catch (error) {
      logger.error('[Analytics] Failed to fetch global stats', { error });
      throw error;
    }
  },

  getTopTracks: async (range: string = '30d') => {
    try {
      const response = await apiClient.get<{ data?: { tracks?: { top_tracks?: unknown[] } } }>('/analytics', {
        params: { days: range.replace('d', '') }
      });

      const data = response.data?.data ?? response.data;
      const topTracks = (data as Record<string, unknown>)?.tracks as { top_tracks?: Array<{ id?: string; title?: string; plays?: number; play_count?: number; change?: number; revenue?: number }> } | undefined;
      const tracks = topTracks?.top_tracks ?? [];

      return tracks.map((t) => ({
        id: t.id ?? '',
        title: t.title ?? '',
        plays: t.plays ?? t.play_count ?? 0,
        change: t.change ?? 0,
        revenue: t.revenue ?? 0,
      }));
    } catch (error) {
      logger.error('[Analytics] Failed to fetch top tracks', { error });
      throw error;
    }
  },

  getTrafficSources: async () => {
    // Not implemented in backend - returns empty until backend supports it
    return [];
  },

  getDeviceBreakdown: async () => {
    // Not implemented in backend - returns zeros until backend supports it
    return { mobile: 0, desktop: 0 };
  },
};