import { Security, Route, Tags, Path, Query, Example, Get, Post, Patch, Delete, Body, Hidden } from 'tsoa' import User, { UserPayload } from '../model/User' export interface UserResponse { id: number username: string displayName: string } interface UserDetailsResponse { id: number displayName: string username: string isActive: boolean isAdmin: boolean } @Security('bearerAuth') @Route('SASjsApi/user') @Tags('User') export class UserController { /** * @summary Get list of all users (username, displayname). All users can request this. * */ @Example([ { id: 123, username: 'johnusername', displayName: 'John' }, { id: 456, username: 'starkusername', displayName: 'Stark' } ]) @Get('/') public async getAllUsers(): Promise { return getAllUsers() } /** * @summary Create user with the following attributes: UserId, UserName, Password, isAdmin, isActive. Admin only task. * */ @Example({ id: 1234, displayName: 'John Snow', username: 'johnSnow01', isAdmin: false, isActive: true }) @Post('/') public async createUser( @Body() body: UserPayload ): Promise { return createUser(body) } /** * @summary Get user properties - such as group memberships, userName, displayName. * @param userId The user's identifier * @example userId 1234 */ @Get('{userId}') public async getUser(@Path() userId: number): Promise { return getUser(userId) } /** * @summary Update user properties - such as displayName. Can be performed either by admins, or the user in question. * @param userId The user's identifier * @example userId "1234" */ @Example({ id: 1234, displayName: 'John Snow', username: 'johnSnow01', isAdmin: false, isActive: true }) @Patch('{userId}') public async updateUser( @Path() userId: number, @Body() body: UserPayload ): Promise { return updateUser(userId, body) } /** * @summary Delete a user. Can be performed either by admins, or the user in question. * @param userId The user's identifier * @example userId 1234 */ @Delete('{userId}') public async deleteUser( @Path() userId: number, @Body() body: { password?: string }, @Query() @Hidden() isAdmin: boolean = false ) { return deleteUser(userId, isAdmin, body) } } const getAllUsers = async (): Promise => await User.find({}) .select({ _id: 0, id: 1, username: 1, displayName: 1 }) .exec() const createUser = async (data: UserPayload): Promise => { const { displayName, username, password, isAdmin, isActive } = data // Checking if user is already in the database const usernameExist = await User.findOne({ username }) if (usernameExist) throw new Error('Username already exists.') // Hash passwords const hashPassword = User.hashPassword(password) // Create a new user const user = new User({ displayName, username, password: hashPassword, isAdmin, isActive }) const savedUser = await user.save() return { id: savedUser.id, displayName: savedUser.displayName, username: savedUser.username, isActive: savedUser.isActive, isAdmin: savedUser.isAdmin } } const getUser = async (id: number): Promise => { const user = await User.findOne({ id }) .select({ _id: 0, id: 1, username: 1, displayName: 1, isAdmin: 1, isActive: 1 }) .exec() if (!user) throw new Error('User is not found.') return user } const updateUser = async ( id: number, data: UserPayload ): Promise => { const { displayName, username, password, isAdmin, isActive } = data const params: any = { displayName, isAdmin, isActive } if (username) { // Checking if user is already in the database const usernameExist = await User.findOne({ username }) if (usernameExist?.id != id) throw new Error('Username already exists.') params.username = username } if (password) { // Hash passwords params.password = User.hashPassword(password) } const updatedUser = await User.findOneAndUpdate({ id }, params, { new: true }) .select({ _id: 0, id: 1, username: 1, displayName: 1, isAdmin: 1, isActive: 1 }) .exec() if (!updatedUser) throw new Error('Unable to update user') return updatedUser } const deleteUser = async ( id: number, isAdmin: boolean, { password }: { password?: string } ) => { const user = await User.findOne({ id }) if (!user) throw new Error('User is not found.') if (!isAdmin) { const validPass = user.comparePassword(password!) if (!validPass) throw new Error('Invalid password.') } await User.deleteOne({ id }) }