feat: implement new use case

As a student, I want to delete a registered task so that I can remove it from my tasks list.

This commit includes:

- Implementation of the use case for deleting a task
- Implementation of unit tests related to the use case and adapters

src/adapters/task/deleteTask/boundaries/deleteTask.controller.input.boundary.ts

@@ -0,0 +1,5 @@
+interface DeleteTaskControllerInputBoundary {
+    delete(id: string): Promise<void>;
+}
+
+export { DeleteTaskControllerInputBoundary };

src/adapters/task/deleteTask/boundaries/index.ts

@@ -0,0 +1 @@
+export * from "./deleteTask.controller.input.boundary";

src/adapters/task/deleteTask/controllers/deleteTask.controller.ts

@@ -0,0 +1,16 @@
+import { DeleteTaskControllerInputBoundary } from "..";
+import { DeleteTaskInputBoundary } from "@/useCases/task";
+
+class DeleteTaskController implements DeleteTaskControllerInputBoundary {
+    private inputBoundary: DeleteTaskInputBoundary;
+
+    constructor(inputBoundary: DeleteTaskInputBoundary) {
+        this.inputBoundary = inputBoundary;
+    }
+
+    async delete(id: string): Promise<void> {
+        return await this.inputBoundary.delete(id);
+    }
+}
+
+export { DeleteTaskController };

src/adapters/task/deleteTask/controllers/index.ts

@@ -0,0 +1 @@
+export * from "./deleteTask.controller";

src/adapters/task/deleteTask/index.ts

@@ -0,0 +1,3 @@
+export * from "./boundaries";
+export * from "./controllers";
+export * from "./presenters";

src/adapters/task/deleteTask/presenters/deleteTask.presenters.ts

@@ -0,0 +1,17 @@
+import { ResourceNotFoundException } from "@/adapters/exceptions";
+import {
+    DeleteTaskNotFoundException,
+    DeleteTaskOutputBoundary,
+} from "@/useCases/task";
+
+class DeleteTaskPresenter implements DeleteTaskOutputBoundary {
+    presentSuccess() {
+        return;
+    }
+
+    presentDeleteTaskNotFound(error: DeleteTaskNotFoundException) {
+        throw new ResourceNotFoundException(error.message);
+    }
+}
+
+export { DeleteTaskPresenter };

src/adapters/task/deleteTask/presenters/index.ts

@@ -0,0 +1 @@
+export * from "./deleteTask.presenters";

src/adapters/task/index.ts

@@ -1,3 +1,4 @@
 export * from "./createTask";
 export * from "./listTaskById";
 export * from "./updateTask";
+export * from "./deleteTask";

src/tests/unit/adapters/task/deleteTask/deleteTask.controller.test.ts

@@ -0,0 +1,19 @@
+import { deleteTaskInputBoundaryMock } from "@/tests/unit/mocks/task";
+
+import { DeleteTaskController } from "@/adapters/task";
+
+describe("DeleteTaskController", () => {
+    let controller: DeleteTaskController;
+
+    beforeEach(() => {
+        jest.clearAllMocks();
+
+        controller = new DeleteTaskController(deleteTaskInputBoundaryMock);
+    });
+
+    describe("delete", () => {
+        it("should return undefined", async () => {
+            expect(await controller.delete("1")).toBeUndefined();
+        });
+    });
+});

src/tests/unit/adapters/task/deleteTask/deleteTask.presenter.test.ts

@@ -0,0 +1,30 @@
+import { DeleteTaskPresenter } from "@/adapters/task";
+import { ResourceNotFoundException } from "@/adapters/exceptions";
+
+import { DeleteTaskNotFoundException } from "@/useCases/task";
+
+describe("DeleteTaskPresenter", () => {
+    let presenter: DeleteTaskPresenter;
+
+    beforeEach(() => {
+        jest.clearAllMocks();
+
+        presenter = new DeleteTaskPresenter();
+    });
+
+    describe("presentSuccess", () => {
+        it("should return undefined", async () => {
+            expect(presenter.presentSuccess()).toBeUndefined();
+        });
+    });
+
+    describe("presentDeleteTaskNotFound", () => {
+        it("should throw ResourceNotFoundException", async () => {
+            const error = new DeleteTaskNotFoundException("Task not found");
+
+            expect(() => presenter.presentDeleteTaskNotFound(error)).toThrow(
+                new ResourceNotFoundException(error.message)
+            );
+        });
+    });
+});

src/tests/unit/mocks/task/deleteTask.ds.gateway.mock.ts

@@ -0,0 +1,6 @@
+const deleteTaskDsGatewayMock = {
+    existsById: jest.fn(),
+    remove: jest.fn(),
+};
+
+export { deleteTaskDsGatewayMock };

src/tests/unit/mocks/task/deleteTask.input.boundary.mock.ts

@@ -0,0 +1,5 @@
+const deleteTaskInputBoundaryMock = {
+    delete: jest.fn(),
+};
+
+export { deleteTaskInputBoundaryMock };

src/tests/unit/mocks/task/deleteTask.output.boundary.mock.ts

@@ -0,0 +1,6 @@
+const deleteTaskOutputBoundaryMock = {
+    presentSuccess: jest.fn(),
+    presentDeleteTaskNotFound: jest.fn(),
+};
+
+export { deleteTaskOutputBoundaryMock };

src/tests/unit/mocks/task/index.ts

@@ -7,3 +7,6 @@ export * from "./listTaskById.input.boundary.mock";
 export * from "./updateTask.ds.gateway.mock";
 export * from "./updateTask.output.boundary.mock";
 export * from "./updateTask.input.boundary.mock";
+export * from "./deleteTask.ds.gateway.mock";
+export * from "./deleteTask.output.boundary.mock";
+export * from "./deleteTask.input.boundary.mock";

src/tests/unit/useCases/task/deleteTask.interactor.test.ts

@@ -0,0 +1,48 @@
+import {
+    deleteTaskDsGatewayMock,
+    deleteTaskOutputBoundaryMock,
+} from "@/tests/unit/mocks/task";
+
+import { DeleteTaskInteractor } from "@/useCases/task";
+
+describe("DeleteTaskInteractor", () => {
+    let interactor: DeleteTaskInteractor;
+
+    beforeEach(() => {
+        jest.clearAllMocks();
+
+        interactor = new DeleteTaskInteractor(
+            deleteTaskDsGatewayMock,
+            deleteTaskOutputBoundaryMock
+        );
+    });
+
+    describe("delete", () => {
+        beforeEach(() => {
+            deleteTaskDsGatewayMock.existsById.mockResolvedValue(true);
+            deleteTaskDsGatewayMock.remove.mockResolvedValue(undefined);
+            deleteTaskOutputBoundaryMock.presentSuccess.mockReturnValue(
+                undefined
+            );
+            deleteTaskOutputBoundaryMock.presentDeleteTaskNotFound.mockImplementation(
+                () => {
+                    throw new Error("Task not found");
+                }
+            );
+        });
+
+        it("should return success", async () => {
+            const result = await interactor.delete("1");
+
+            expect(result).toBeUndefined();
+        });
+
+        it("should return exception when task is not found", async () => {
+            deleteTaskDsGatewayMock.existsById.mockResolvedValue(false);
+
+            await expect(interactor.delete("1")).rejects.toThrow(
+                "Task not found"
+            );
+        });
+    });
+});

src/useCases/task/deleteTask/boundaries/deleteTask.input.boundary.ts

@@ -0,0 +1,5 @@
+interface DeleteTaskInputBoundary {
+    delete(id: string): Promise<void>;
+}
+
+export { DeleteTaskInputBoundary };

src/useCases/task/deleteTask/boundaries/deleteTask.output.boundary.ts

@@ -0,0 +1,9 @@
+import { DeleteTaskNotFoundException } from "..";
+
+interface DeleteTaskOutputBoundary {
+    presentSuccess(): void;
+
+    presentDeleteTaskNotFound(error: DeleteTaskNotFoundException): void;
+}
+
+export { DeleteTaskOutputBoundary };

src/useCases/task/deleteTask/boundaries/index.ts

@@ -0,0 +1,2 @@
+export * from "./deleteTask.input.boundary";
+export * from "./deleteTask.output.boundary";

src/useCases/task/deleteTask/deleteTask.interactor.ts

@@ -0,0 +1,36 @@
+import {
+    DeleteTaskDsGateway,
+    DeleteTaskInputBoundary,
+    DeleteTaskNotFoundException,
+    DeleteTaskOutputBoundary,
+} from ".";
+
+class DeleteTaskInteractor implements DeleteTaskInputBoundary {
+    private dsGateway: DeleteTaskDsGateway;
+
+    private outputBoundary: DeleteTaskOutputBoundary;
+
+    constructor(
+        dsGateway: DeleteTaskDsGateway,
+        outputBoundary: DeleteTaskOutputBoundary
+    ) {
+        this.dsGateway = dsGateway;
+        this.outputBoundary = outputBoundary;
+    }
+
+    async delete(id: string): Promise<void> {
+        if (!(await this.dsGateway.existsById(id))) {
+            return this.outputBoundary.presentDeleteTaskNotFound(
+                new DeleteTaskNotFoundException(
+                    `Tarefa com id ${id} não encontrada`
+                )
+            );
+        }
+
+        await this.dsGateway.remove(id);
+
+        return this.outputBoundary.presentSuccess();
+    }
+}
+
+export { DeleteTaskInteractor };

src/useCases/task/deleteTask/exceptions/deleteTask.notFound.exception.ts

@@ -0,0 +1,8 @@
+class DeleteTaskNotFoundException extends Error {
+    constructor(message: string) {
+        super(message);
+        this.name = "DeleteTaskNotFoundException";
+    }
+}
+
+export { DeleteTaskNotFoundException };

src/useCases/task/deleteTask/exceptions/index.ts

@@ -0,0 +1 @@
+export * from "./deleteTask.notFound.exception";

src/useCases/task/deleteTask/gateways/deleteTask.ds.gateway.ts

@@ -0,0 +1,7 @@
+interface DeleteTaskDsGateway {
+    existsById(id: string): Promise<boolean>;
+
+    remove(id: string): Promise<void>;
+}
+
+export { DeleteTaskDsGateway };

src/useCases/task/deleteTask/gateways/index.ts

@@ -0,0 +1 @@
+export * from "./deleteTask.ds.gateway";

src/useCases/task/deleteTask/index.ts

@@ -0,0 +1,4 @@
+export * from "./boundaries";
+export * from "./exceptions";
+export * from "./gateways";
+export * from "./deleteTask.interactor";

src/useCases/task/index.ts

@@ -1,3 +1,4 @@
 export * from "./createTask";
 export * from "./listTaskById";
 export * from "./updateTask";
+export * from "./deleteTask";