import { Controller, Get, Post, Delete, Param, Body, HttpCode, HttpStatus } from '@nestjs/common'; import { ApiTags, ApiOperation, ApiResponse, ApiParam } from '@nestjs/swagger'; import { SessionService } from './session.service'; import { CreateSessionDto, SessionResponseDto, QRCodeResponseDto, MarkChatReadDto } from './dto'; import { Session } from './entities/session.entity'; import { ChatSummary } from '../../engine/interfaces/whatsapp-engine.interface'; import { AuditService } from '../audit/audit.service'; import { AuditAction } from '../audit/entities/audit-log.entity'; import { RequireRole } from '../auth/decorators/auth.decorators'; import { ApiKeyRole } from '../auth/entities/api-key.entity'; @ApiTags('sessions') @Controller('sessions') export class SessionController { constructor( private readonly sessionService: SessionService, private readonly auditService: AuditService, ) {} // Transform entity to DTO with lastActive field name private transformSession(session: Session): SessionResponseDto { return { id: session.id, name: session.name, status: session.status, phone: session.phone, pushName: session.pushName, connectedAt: session.connectedAt, lastActive: session.lastActiveAt, createdAt: session.createdAt, updatedAt: session.updatedAt, lastError: session.lastError ?? null, }; } @Post() @RequireRole(ApiKeyRole.OPERATOR) @ApiOperation({ summary: 'Create a new WhatsApp session' }) @ApiResponse({ status: 201, description: 'Session created', type: SessionResponseDto, }) @ApiResponse({ status: 409, description: 'Session name already exists' }) async create(@Body() dto: CreateSessionDto): Promise { const session = await this.sessionService.create(dto); await this.auditService.logInfo(AuditAction.SESSION_CREATED, { sessionId: session.id, sessionName: session.name, }); return session; } @Get() @ApiOperation({ summary: 'List all sessions' }) @ApiResponse({ status: 200, description: 'List of sessions', type: [SessionResponseDto], }) async findAll(): Promise { const sessions = await this.sessionService.findAll(); return sessions.map(s => this.transformSession(s)); } @Get(':id') @ApiOperation({ summary: 'Get session by ID' }) @ApiParam({ name: 'id', description: 'Session ID' }) @ApiResponse({ status: 200, description: 'Session details', type: SessionResponseDto, }) @ApiResponse({ status: 404, description: 'Session not found' }) async findOne(@Param('id') id: string): Promise { const session = await this.sessionService.findOne(id); return this.transformSession(session); } @Delete(':id') @RequireRole(ApiKeyRole.OPERATOR) @HttpCode(HttpStatus.NO_CONTENT) @ApiOperation({ summary: 'Delete a session' }) @ApiParam({ name: 'id', description: 'Session ID' }) @ApiResponse({ status: 204, description: 'Session deleted' }) @ApiResponse({ status: 404, description: 'Session not found' }) async delete(@Param('id') id: string): Promise { const session = await this.sessionService.findOne(id); await this.sessionService.delete(id); await this.auditService.logInfo(AuditAction.SESSION_DELETED, { sessionId: id, sessionName: session.name, }); } @Post(':id/start') @RequireRole(ApiKeyRole.OPERATOR) @ApiOperation({ summary: 'Start a session and initialize WhatsApp connection', }) @ApiParam({ name: 'id', description: 'Session ID' }) @ApiResponse({ status: 200, description: 'Session started', type: SessionResponseDto, }) @ApiResponse({ status: 400, description: 'Session already started' }) @ApiResponse({ status: 404, description: 'Session not found' }) async start(@Param('id') id: string): Promise { const session = await this.sessionService.start(id); await this.auditService.logInfo(AuditAction.SESSION_STARTED, { sessionId: session.id, sessionName: session.name, }); return this.transformSession(session); } @Post(':id/stop') @RequireRole(ApiKeyRole.OPERATOR) @ApiOperation({ summary: 'Stop a session and disconnect WhatsApp' }) @ApiParam({ name: 'id', description: 'Session ID' }) @ApiResponse({ status: 200, description: 'Session stopped', type: SessionResponseDto, }) @ApiResponse({ status: 404, description: 'Session not found' }) async stop(@Param('id') id: string): Promise { const session = await this.sessionService.stop(id); await this.auditService.logInfo(AuditAction.SESSION_STOPPED, { sessionId: session.id, sessionName: session.name, }); return this.transformSession(session); } @Get(':id/qr') @RequireRole(ApiKeyRole.OPERATOR) @ApiOperation({ summary: 'Get QR code for session authentication' }) @ApiParam({ name: 'id', description: 'Session ID' }) @ApiResponse({ status: 200, description: 'QR code data', type: QRCodeResponseDto, }) @ApiResponse({ status: 400, description: 'QR code not ready or session already authenticated', }) @ApiResponse({ status: 404, description: 'Session not found' }) async getQRCode(@Param('id') id: string): Promise { const qrCode = await this.sessionService.getQRCode(id); await this.auditService.logInfo(AuditAction.SESSION_QR_GENERATED, { sessionId: id, }); return qrCode; } @Get(':id/groups') @ApiOperation({ summary: 'Get all groups for a session' }) @ApiParam({ name: 'id', description: 'Session ID' }) @ApiResponse({ status: 200, description: 'List of groups the session is a member of', }) @ApiResponse({ status: 400, description: 'Session not ready' }) @ApiResponse({ status: 404, description: 'Session not found' }) async getGroups(@Param('id') id: string): Promise<{ id: string; name: string; linkedParentJID?: string | null }[]> { return this.sessionService.getGroups(id); } @Get(':id/chats') @ApiOperation({ summary: 'Get active chats for a session' }) @ApiParam({ name: 'id', description: 'Session ID' }) @ApiResponse({ status: 200, description: 'List of active chats' }) @ApiResponse({ status: 400, description: 'Session not ready' }) @ApiResponse({ status: 404, description: 'Session not found' }) async getChats(@Param('id') id: string): Promise { return this.sessionService.getChats(id); } @Post(':id/chats/read') @RequireRole(ApiKeyRole.OPERATOR) @ApiOperation({ summary: 'Mark a chat as read/seen' }) @ApiParam({ name: 'id', description: 'Session ID' }) @ApiResponse({ status: 200, description: 'Chat marked as read successfully' }) @ApiResponse({ status: 400, description: 'Session not ready' }) @ApiResponse({ status: 404, description: 'Session not found' }) async markChatRead(@Param('id') id: string, @Body() dto: MarkChatReadDto): Promise<{ success: boolean }> { const success = await this.sessionService.sendSeen(id, dto.chatId); return { success }; } @Get('stats/overview') @ApiOperation({ summary: 'Get session statistics for multi-session monitoring', }) @ApiResponse({ status: 200, description: 'Session statistics including counts and memory usage', }) async getStats(): Promise<{ total: number; active: number; ready: number; disconnected: number; byStatus: Record; memoryUsage: { heapUsed: number; heapTotal: number; rss: number }; }> { return this.sessionService.getStats(); } }