Analytics Plugin

interface PageView {
  path: string           // URL path visited
  title?: string         // Page title
  referrer?: string      // HTTP referrer
  userAgent?: string     // Browser user agent
  ipAddress?: string     // Visitor IP address
  sessionId?: string     // Unique session ID
  userId?: number        // User ID (if authenticated)
  duration?: number      // Time on page (milliseconds)
}

import { analyticsService } from '@sonicjs-cms/core/plugins'

// Track a page view
const result = await analyticsService.trackPageView({
  path: '/products/item-123',
  title: 'Product Detail - Widget Pro',
  sessionId: 'session-xyz',
  userId: 456
})

console.log('View tracked:', result.viewId)

interface AnalyticsEvent {
  eventType: string      // Category: 'auth', 'content', 'conversion', etc.
  eventName: string      // Specific event: 'user_login', 'purchase', etc.
  eventData?: object     // Additional metadata
  path?: string          // Page where event occurred
  sessionId?: string     // Associated session
  userId?: number        // Associated user
}

import { analyticsService } from '@sonicjs-cms/core/plugins'

// Track a conversion event
await analyticsService.trackEvent({
  eventType: 'conversion',
  eventName: 'purchase_completed',
  eventData: {
    orderId: 'order-12345',
    amount: 99.99,
    currency: 'USD',
    items: 3
  },
  sessionId: 'session-xyz',
  userId: 456
})

// Track a feature usage event
await analyticsService.trackEvent({
  eventType: 'feature',
  eventName: 'export_clicked',
  eventData: {
    format: 'csv',
    recordCount: 150
  }
})

// Track a content event
await analyticsService.trackEvent({
  eventType: 'content',
  eventName: 'article_shared',
  eventData: {
    articleId: 'post-789',
    platform: 'twitter'
  },
  path: '/blog/my-article'
})

// In hooks or middleware with context
const analyticsService = context.services?.analyticsService

// Track page view
const view = await analyticsService?.trackPageView({
  path: '/my-page',
  title: 'My Page'
})

// Track event
const event = await analyticsService?.trackEvent({
  eventType: 'custom',
  eventName: 'button_clicked'
})

// Get statistics
const stats = await analyticsService?.getStats('7d')
console.log(`${stats.pageviews} views this week`)

// Generate report
const report = await analyticsService?.generateReport('traffic', {
  start: '2024-01-01',
  end: '2024-01-31'
})

// The plugin automatically tracks logins
// You can also manually track with hooks

hooks.register('content:view', async (data, context) => {
  const analyticsService = context.services?.analyticsService

  await analyticsService?.trackEvent({
    eventType: 'content',
    eventName: 'content_viewed',
    eventData: {
      contentId: data.id,
      contentType: data.type,
      title: data.title
    }
  })

  return data
})