Class TokenHttpController

web/crux/src/app/token/token.http.controller.ts:35–110

@UseGuards(TokenAccessGuard)
@DisableTeamAccessGuard()
export default class TokenHttpController {
  constructor(private service: TokenService) {}

  @Get()
  @HttpCode(HttpStatus.OK)
  @ApiOperation({
    description: "Access token's support is to provide secure access to the HTTP api without a cookie.",
    summary: 'List of tokens.',
  })
  @ApiOkResponse({
    type: TokenDto,
    isArray: true,
    description: 'Token list fetched.',
  })
  @ApiForbiddenResponse({ description: 'Unauthorized request for tokens.' })
  async getTokens(@IdentityFromRequest() identity: Identity): Promise<TokenDto[]> {
    return this.service.getTokenList(identity)
  }

  @Get(ROUTE_TOKEN_ID)
  @HttpCode(HttpStatus.OK)
  @ApiOperation({
    description:
      "Access token's details are `name`, `id`, and the time of creation and expiration. Request must include `tokenId`.",
    summary: 'Fetch token details.',
  })
  @ApiOkResponse({ type: TokenDto, description: 'Token details listed.' })
  @ApiBadRequestResponse({ description: 'Bad request for token details.' })
  @ApiForbiddenResponse({ description: 'Unauthorized request for token details.' })
  @ApiNotFoundResponse({ description: 'Token not found.' })
  @UuidParams(PARAM_TOKEN_ID)
  async getToken(@TokenId() id: string, @IdentityFromRequest() identity: Identity): Promise<TokenDto> {
    return this.service.getToken(id, identity)
  }

  @Post()
  @HttpCode(HttpStatus.CREATED)
  @CreatedWithLocation()
  @ApiOperation({
    description: 'Request must include `name` and `expirationInDays`.',
    summary: 'Create access token.',
  })
  @ApiBody({ type: GenerateTokenDto, description: 'Token created.' })
  @ApiCreatedResponse({
    type: GeneratedTokenDto,
    headers: API_CREATED_LOCATION_HEADERS,
  })
  @ApiBadRequestResponse({ description: 'Bad request for token creation.' })
  @ApiForbiddenResponse({ description: 'Unauthorized request for token creation.' })
  @ApiConflictResponse({ description: 'Token name taken.' })
  async generateToken(
    @Body(TokenValidationPipe) request: GenerateTokenDto,
    @IdentityFromRequest() identity: Identity,
  ): Promise<CreatedResponse<GeneratedTokenDto>> {
    const token = await this.service.generateToken(request, identity)

    return {
      url: `/tokens/${token.id}`,