mirrors/hedgedoc
1
0
Fork 0
mirror of https://github.com/hedgedoc/hedgedoc.git synced 2025-05-23 11:37:02 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

UsersService: Add JSDoc to all methods

Browse source 
Signed-off-by: Philip Molares <philip.molares@udo.edu>
This commit is contained in:
Philip Molares 2021-03-05 00:26:57 +01:00 • committed by David Mehren
parent 5a9634400a
commit bce0ca9d74
No known key found for this signature in database
GPG key ID: 185982BA4C42B7C3
1 changed files with 33 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

35
src/users/users.service.ts
View file

@ -7,7 +7,7 @@
import { Injectable } from '@nestjs/common'; import { Injectable } from '@nestjs/common';
import { InjectRepository } from '@nestjs/typeorm'; import { InjectRepository } from '@nestjs/typeorm';
import { Repository } from 'typeorm'; import { Repository } from 'typeorm';
import { NotInDBError } from '../errors/errors'; import { AlreadyInDBError, NotInDBError } from '../errors/errors';
import { ConsoleLoggerService } from '../logger/console-logger.service'; import { ConsoleLoggerService } from '../logger/console-logger.service';
import { UserInfoDto } from './user-info.dto'; import { UserInfoDto } from './user-info.dto';
import { User } from './user.entity'; import { User } from './user.entity';
@ -21,11 +21,25 @@ export class UsersService {
this.logger.setContext(UsersService.name); this.logger.setContext(UsersService.name);
} }
createUser(userName: string, displayName: string): Promise<User> { /**
* @async
* Create a new user with a given userName and displayName
* @param userName - the userName the new user shall have
* @param displayName - the display the new user shall have
* @return {User} the user
* @throws {AlreadyInDBError} the userName is already taken.
*/
async createUser(userName: string, displayName: string): Promise<User> {
const user = User.create(userName, displayName); const user = User.create(userName, displayName);
return this.userRepository.save(user); return this.userRepository.save(user);
} }
/**
* @async
* Delete the user with the specified userName
* @param userName - the username of the user to be delete
* @throws {NotInDBError} the userName has no user associated with it.
*/
async deleteUser(userName: string): Promise<void> { async deleteUser(userName: string): Promise<void> {
// TODO: Handle owned notes and edits // TODO: Handle owned notes and edits
const user = await this.userRepository.findOne({ const user = await this.userRepository.findOne({
@ -34,6 +48,13 @@ export class UsersService {
await this.userRepository.delete(user); await this.userRepository.delete(user);
} }
/**
* @async
* Get the user specified by the username
* @param {string} userName the username by which the user is specified
* @param {boolean} [withTokens=false] if the returned user object should contain authTokens
* @return {User} the specified user
*/
async getUserByUsername(userName: string, withTokens = false): Promise<User> { async getUserByUsername(userName: string, withTokens = false): Promise<User> {
const user = await this.userRepository.findOne({ const user = await this.userRepository.findOne({
where: { userName: userName }, where: { userName: userName },
@ -45,6 +66,11 @@ export class UsersService {
return user; return user;
} }
/**
* Extract the photoUrl of the user or in case no photo url is present generate a deterministic user photo
* @param {User} user - the specified User
* @return the url of the photo
*/
getPhotoUrl(user: User): string { getPhotoUrl(user: User): string {
if (user.photo) { if (user.photo) {
return user.photo; return user.photo;
@ -54,6 +80,11 @@ export class UsersService {
} }
} }
/**
* Build UserInfoDto from a user.
* @param {User=} user - the user to use
* @return {(UserInfoDto|null)} the built UserInfoDto
*/
toUserDto(user: User | null | undefined): UserInfoDto | null { toUserDto(user: User | null | undefined): UserInfoDto | null {
if (!user) { if (!user) {
this.logger.warn(`Recieved ${String(user)} argument!`, 'toUserDto'); this.logger.warn(`Recieved ${String(user)} argument!`, 'toUserDto');