103 lines
3.8 KiB
TypeScript
103 lines
3.8 KiB
TypeScript
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);
|
|
}
|
|
}
|