src/modules/settings/controllers/integrations.controller.ts

import {
  Controller,
  Get,
  Post,
  Put,
  Delete,
  Param,
  Body,
  UseGuards,
  Request,
  ParseIntPipe,
} from '@nestjs/common';
import {
  ApiTags,
  ApiBearerAuth,
  ApiOperation,
  ApiResponse,
  ApiParam,
} from '@nestjs/swagger';
import { JwtAuthGuard } from '../../auth/guards/jwt-auth.guard';
import { RolesGuard } from '../../auth/guards/roles.guard';
import { Roles } from '../../../common/decorators/roles.decorator';
import { RoleName } from '../../auth/entities/role.entity';
import { IntegrationsService } from '../services/integrations.service';
import { CreateIntegrationDto, UpdateIntegrationDto } from '../dto/create-integration.dto';

@ApiTags('🔌 Integrations')
@ApiBearerAuth('JWT-auth')
@Controller('api/integrations')
@UseGuards(JwtAuthGuard, RolesGuard)
export class IntegrationsController {
  constructor(private readonly integrationsService: IntegrationsService) {}

  @Get()
  @Roles(RoleName.ADMIN, RoleName.IT_ADMIN)
  @ApiOperation({
    summary: 'Get all API integrations',
    description: 'Retrieves complete list of established interconnected APIs integrations configs mapping provider keys. Access rules: ADMIN, IT_ADMIN. Uses table: `api_integrations`.',
  })
  @ApiResponse({ status: 200, description: 'Integrations returned' })
  async getAll() {
    return this.integrationsService.getAll();
  }

  @Post()
  @Roles(RoleName.IT_ADMIN)
  @ApiOperation({
    summary: 'Create a new API integration',
    description: 'Registers brand new secret external API connections encrypted in storage structure for integrations like SSO/LMS. Access rules: IT_ADMIN. Uses table: `api_integrations`.',
  })
  @ApiResponse({ status: 201, description: 'Integration created' })
  async create(@Body() dto: CreateIntegrationDto, @Request() req) {
    const userId = req.user.userId || req.user.id;
    return this.integrationsService.create(dto, userId);
  }

  @Get(':id')
  @Roles(RoleName.ADMIN, RoleName.IT_ADMIN)
  @ApiOperation({
    summary: 'Get a specific integration',
    description: 'Queries integration specific detail payload configs. Access rules: ADMIN, IT_ADMIN. Uses table: `api_integrations`.',
  })
  @ApiParam({ name: 'id', type: Number })
  @ApiResponse({ status: 200, description: 'Integration returned' })
  async getById(@Param('id', ParseIntPipe) id: number) {
    return this.integrationsService.getById(id);
  }

  @Put(':id')
  @Roles(RoleName.IT_ADMIN)
  @ApiOperation({
    summary: 'Update an integration',
    description: 'Changes values stored to connected integrations structures mappings. Access rules: IT_ADMIN. Uses table: `api_integrations`.',
  })
  @ApiParam({ name: 'id', type: Number })
  @ApiResponse({ status: 200, description: 'Integration updated' })
  async update(
    @Param('id', ParseIntPipe) id: number,
    @Body() dto: UpdateIntegrationDto,
    @Request() req,
  ) {
    const userId = req.user.userId || req.user.id;
    return this.integrationsService.update(id, dto, userId);
  }

  @Delete(':id')
  @Roles(RoleName.IT_ADMIN)
  @ApiOperation({
    summary: 'Delete an integration',
    description: 'Destroy existing integration parameters rendering connected systems unusable instantly. Access rules: IT_ADMIN. Uses table: `api_integrations`.',
  })
  @ApiParam({ name: 'id', type: Number })
  @ApiResponse({ status: 200, description: 'Integration deleted' })
  async delete(@Param('id', ParseIntPipe) id: number) {
    return this.integrationsService.delete(id);
  }

  @Post(':id/test')
  @Roles(RoleName.IT_ADMIN)
  @ApiOperation({
    summary: 'Test integration connection',
    description: 'Force dispatching probe payload confirming health status of external platform. Access rules: IT_ADMIN. Uses table: `api_integrations`.',
  })
  @ApiParam({ name: 'id', type: Number })
  @ApiResponse({ status: 200, description: 'Test result returned' })
  async testConnection(@Param('id', ParseIntPipe) id: number) {
    return this.integrationsService.testConnection(id);
  }

  @Post(':id/sync')
  @Roles(RoleName.IT_ADMIN)
  @ApiOperation({
    summary: 'Trigger integration sync',
    description: 'Starts external pull data mechanisms manually fetching data streams into storage contexts. Access rules: IT_ADMIN. Uses table: `api_integrations`.',
  })
  @ApiParam({ name: 'id', type: Number })
  @ApiResponse({ status: 200, description: 'Sync triggered' })
  async triggerSync(@Param('id', ParseIntPipe) id: number) {
    return this.integrationsService.triggerSync(id);
  }
}