import {Controller, Get, Middleware} from '@overnightjs/core'; import type {NextFunction, Request, Response} from 'express'; import {requireAuth, requireEmailVerified} from '../middleware/auth.js'; import {AnalyticsService} from '../services/AnalyticsService.js'; import {CatchAsync} from '../utils/asyncHandler.js'; @Controller('analytics') export class Analytics { /** * GET /analytics/timeseries * Get time series data for email analytics * * Query params: * - startDate: ISO date string (defaults to 30 days ago, max 90 days) * - endDate: ISO date string (defaults to now) * * Returns daily aggregated email metrics (sent, opened, clicked, bounced, delivered) */ @Get('timeseries') @Middleware([requireAuth, requireEmailVerified]) @CatchAsync public async getTimeSeries(req: Request, res: Response, _next: NextFunction) { const auth = res.locals.auth; const startDate = req.query.startDate ? new Date(req.query.startDate as string) : undefined; const endDate = req.query.endDate ? new Date(req.query.endDate as string) : undefined; const timeSeries = await AnalyticsService.getTimeSeriesData(auth.projectId, startDate, endDate); return res.status(200).json(timeSeries); } /** * GET /analytics/top-campaigns * Get top performing campaigns by open rate * * Query params: * - limit: number (default 10) * - startDate: ISO date string (defaults to 30 days ago) * - endDate: ISO date string (defaults to now) */ @Get('top-campaigns') @Middleware([requireAuth, requireEmailVerified]) @CatchAsync public async getTopCampaigns(req: Request, res: Response, _next: NextFunction) { const auth = res.locals.auth; const limit = Math.min(parseInt(req.query.limit as string) || 10, 50); const startDate = req.query.startDate ? new Date(req.query.startDate as string) : undefined; const endDate = req.query.endDate ? new Date(req.query.endDate as string) : undefined; const topCampaigns = await AnalyticsService.getTopCampaigns(auth.projectId, limit, startDate, endDate); return res.status(200).json(topCampaigns); } /** * GET /analytics/campaign-stats * Get campaign overview statistics * * Query params: * - startDate: ISO date string (defaults to 30 days ago) * - endDate: ISO date string (defaults to now) * * Returns aggregate stats: total campaigns, active, completed, average rates */ @Get('campaign-stats') @Middleware([requireAuth, requireEmailVerified]) @CatchAsync public async getCampaignStats(req: Request, res: Response, _next: NextFunction) { const auth = res.locals.auth; const startDate = req.query.startDate ? new Date(req.query.startDate as string) : undefined; const endDate = req.query.endDate ? new Date(req.query.endDate as string) : undefined; const campaignStats = await AnalyticsService.getCampaignStats(auth.projectId, startDate, endDate); return res.status(200).json(campaignStats); } /** * GET /analytics/top-events * Get most frequently triggered events * * Query params: * - limit: number (default 5, max 20) * - startDate: ISO date string (defaults to 30 days ago) * - endDate: ISO date string (defaults to now) * * Returns events sorted by frequency with trend data */ @Get('top-events') @Middleware([requireAuth, requireEmailVerified]) @CatchAsync public async getTopEvents(req: Request, res: Response, _next: NextFunction) { const auth = res.locals.auth; const limit = Math.min(parseInt(req.query.limit as string) || 5, 20); const startDate = req.query.startDate ? new Date(req.query.startDate as string) : undefined; const endDate = req.query.endDate ? new Date(req.query.endDate as string) : undefined; const topEvents = await AnalyticsService.getTopEvents(auth.projectId, limit, startDate, endDate); return res.status(200).json(topEvents); } }