Spaces:
Sleeping
Sleeping
File size: 4,470 Bytes
990c0e8 828d8a4 990c0e8 828d8a4 990c0e8 828d8a4 990c0e8 828d8a4 990c0e8 828d8a4 990c0e8 828d8a4 990c0e8 828d8a4 990c0e8 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 | 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);
}
}
|