feat(password-reset): implementing password reset request method at t…

…he controller

src/modules/password-reset/presenter/controllers/password-reset.controller.test.ts

@@ -0,0 +1,59 @@
+import { RequestPasswordResetUseCase } from '@modules/password-reset/domain/usecases/request/request-password-reset.usecase';
+import { PasswordResetController } from './password-reset.controller';
+import { faker } from '@faker-js/faker';
+import { ExecutePasswordResetUseCase } from '@modules/password-reset/domain/usecases/execute/execute-password-reset.usecase';
+import { ValidatePasswordResetUseCase } from '@modules/password-reset/domain/usecases/validate/validate-password-reset.usecase';
+import { right, left } from '@shared/helpers/either';
+import { DeepMocked, createMock } from 'test/utils/create-mock';
+import { MockPasswordReset } from 'test/factories/password-reset-mock';
+import { UserNotFoundError } from '@modules/user/domain/errors/user-not-found.error';
+import { InternalServerErrorException } from '@nestjs/common';
+
+describe('PasswordResetController', () => {
+  let controller: PasswordResetController;
+  let requestPasswordResetUseCase: DeepMocked<RequestPasswordResetUseCase>;
+  let validatePasswordResetUseCase: DeepMocked<ValidatePasswordResetUseCase>;
+  let executePasswordResetUseCase: DeepMocked<ExecutePasswordResetUseCase>;
+
+  beforeEach(() => {
+    requestPasswordResetUseCase = createMock<RequestPasswordResetUseCase>();
+    validatePasswordResetUseCase = createMock<ValidatePasswordResetUseCase>();
+    executePasswordResetUseCase = createMock<ExecutePasswordResetUseCase>();
+    controller = new PasswordResetController(
+      requestPasswordResetUseCase,
+      validatePasswordResetUseCase,
+      executePasswordResetUseCase,
+    );
+  });
+
+  describe('request', () => {
+    it('should have no feedback if the reset was successfully requested', async () => {
+      requestPasswordResetUseCase.exec.mockResolvedValueOnce(
+        right({
+          createdPasswordReset: MockPasswordReset.createEntity(),
+        }),
+      );
+
+      const result = await controller.request(faker.internet.email());
+
+      expect(result).toBeUndefined();
+    });
+
+    it('should have no feedback if the user was not found', async () => {
+      requestPasswordResetUseCase.exec.mockResolvedValueOnce(
+        left(new UserNotFoundError()),
+      );
+
+      const result = await controller.request(faker.internet.email());
+
+      expect(result).toBeUndefined();
+    });
+
+    it('should throw an internal server exception when receiving an unknown error', async () => {
+      requestPasswordResetUseCase.exec.mockResolvedValueOnce(left(new Error()));
+
+      const call = async () => await controller.request(faker.internet.email());
+      expect(call).rejects.toThrow(InternalServerErrorException);
+    });
+  });
+});

src/modules/password-reset/presenter/controllers/password-reset.controller.ts

@@ -1,8 +1,40 @@
-import { Controller } from '@nestjs/common';
-import { ApiTags } from '@nestjs/swagger';
+import { ExecutePasswordResetUseCase } from '@modules/password-reset/domain/usecases/execute/execute-password-reset.usecase';
+import { RequestPasswordResetUseCase } from '@modules/password-reset/domain/usecases/request/request-password-reset.usecase';
+import { ValidatePasswordResetUseCase } from '@modules/password-reset/domain/usecases/validate/validate-password-reset.usecase';
+import { UserNotFoundError } from '@modules/user/domain/errors/user-not-found.error';
+import {
+  Controller,
+  InternalServerErrorException,
+  Param,
+  Post,
+} from '@nestjs/common';
+import { ApiHeader, ApiOperation, ApiTags } from '@nestjs/swagger';
 
 @ApiTags('Password Resets')
 @Controller('password-resets')
 export class PasswordResetController {
-  constructor() {}
+  constructor(
+    private readonly requestPasswordResetUseCase: RequestPasswordResetUseCase,
+    private readonly validatePasswordResetUseCase: ValidatePasswordResetUseCase,
+    private readonly executePasswordResetUseCase: ExecutePasswordResetUseCase,
+  ) {}
+
+  @ApiOperation({ summary: 'Requests a password reset' })
+  @ApiHeader({ name: 'Accept-Language', example: 'en', required: false })
+  @Post('request/:email')
+  public async request(@Param('email') email: string): Promise<void> {
+    const result = await this.requestPasswordResetUseCase.exec({
+      email,
+    });
+
+    if (result.isRight()) {
+      return;
+    }
+
+    if (result.value instanceof UserNotFoundError) {
+      return;
+    }
+
+    throw new InternalServerErrorException();
+  }
 }