openWa / src /modules /session /session.controller.ts
harsh
Deploy: Initial commit without binaries
525d39f
Raw History Blame Contribute Delete
7.63 kB
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<Session> {
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<SessionResponseDto[]> {
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<SessionResponseDto> {
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<void> {
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<SessionResponseDto> {
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<SessionResponseDto> {
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<QRCodeResponseDto> {
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<ChatSummary[]> {
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<string, number>;
memoryUsage: { heapUsed: number; heapTotal: number; rss: number };
}> {
return this.sessionService.getStats();
}
}