brcaua/desafio02-ignite

Desafio 2: Trabalhando com middlewares

“Para quem fica melhor a cada dia, ficar pronto é utopia”!

🚀 Sobre o desafio

Nesse desafio você irá trabalhar mais a fundo com middlewares no Express. Dessa forma você será capaz de fixar mais ainda os conhecimentos obtidos até agora.

Para facilitar um pouco mais do conhecimento da regra de negócio, você irá trabalhar com a mesma aplicação do desafio anterior: uma aplicação para gerenciar tarefas (ou todos) mas com algumas mudanças.

Será permitida a criação de um usuário com name e username, bem como fazer o CRUD de todos:

Criar um novo todo;
Listar todos os todos;
Alterar o title e deadline de um todo existente;
Marcar um todo como feito;
Excluir um todo;

Tudo isso para cada usuário em específico. Além disso, dessa vez teremos um plano grátis onde o usuário só pode criar até dez todos e um plano Pro que irá permitir criar todos ilimitados, isso tudo usando middlewares para fazer as validações necessárias.

A seguir veremos com mais detalhes o que e como precisa ser feito 🚀

Middlewares da aplicação

checksExistsUserAccount

Esse middleware é responsável por receber o username do usuário pelo header e validar se existe ou não um usuário com o username passado. Caso exista, o usuário deve ser repassado para o request e a função next deve ser chamada.

checksCreateTodosUserAvailability

Esse middleware deve receber o usuário já dentro do request e chamar a função next apenas se esse usuário ainda estiver no plano grátis e ainda não possuir 10 todos cadastrados ou se ele já estiver com o plano Pro ativado.

checksTodoExists

Esse middleware deve receber o username de dentro do header e o id de um todo de dentro de request.params. Você deve validar o usuário, validar que o id seja um uuid e também validar que esse id pertence a um todo do usuário informado.

Com todas as validações passando, o todo encontrado deve ser passado para o request assim como o usuário encontrado também e a função next deve ser chamada.

findUserById

Esse middleware possui um funcionamento semelhante ao middleware checksExistsUserAccount mas a busca pelo usuário deve ser feita através do id de um usuário passado por parâmetro na rota. Caso o usuário tenha sido encontrado, o mesmo deve ser repassado para dentro do request.user e a função next deve ser chamada.

Rodar o Projeto

yarn install

yarn dev

Especificação dos testes

Should be able to find user by username in header and pass it to request.user

Para que esse teste passe, você deve permitir que o middleware checksExistsUserAccount receba um username pelo header do request e caso um usuário com o mesmo username exista, ele deve ser colocado dentro de request.user e, ao final, retorne a chamada da função next.

Atente-se bem para o nome da propriedade que armazenará o objeto user no request.
Should not be able to find a non existing user by username in header

Para que esse teste passe, no middleware checksExistsUserAccount você deve retornar uma resposta com status 404 caso o username passado pelo header da requisição não pertença a nenhum usuário. Você pode também retornar uma mensagem de erro mas isso é opcional.
Should be able to let user create a new todo when is in free plan and have less than ten todos

Para que esse teste passe, você deve permitir que o middleware checksCreateTodosUserAvailability receba o objeto user (considere sempre que o objeto existe) da request e chame a função next somente no caso do usuário estar no plano grátis e ainda não possuir 10 todos cadastrados ou se ele já estiver com o plano Pro ativado.

Você pode verificar se o usuário possui um plano Pro ou não a partir da propriedade user.pro. Caso seja true significa que o plano Pro está em uso.
Should not be able to let user create a new todo when is not Pro and already have ten todos

Para que esse teste passe, no middleware checksCreateTodosUserAvailability você deve retornar uma resposta com status 403 caso o usuário recebido pela requisição esteja no plano grátis e já tenha 10 todos cadastrados. Você pode também retornar uma mensagem de erro mas isso é opcional.
Should be able to let user create infinite new todos when is in Pro plan

Para que esse teste passe, você deve permitir que o middleware checksCreateTodosUserAvailability receba o objeto user (considere sempre que o objeto existe) da request e chame a função next caso o usuário já esteja com o plano Pro.

Se você satisfez os dois testes anteriores antes desse, ele já deve passar também.
Should be able to put user and todo in request when both exits

Para que esse teste passe, o middleware checksTodoExists deve receber o username de dentro do header e o id de um todo de dentro de request.params. Você deve validar que o usuário exista, validar que o id seja um uuid e também validar que esse id pertence a um todo do usuário informado.

Com todas as validações passando, o todo encontrado deve ser passado para o request assim como o usuário encontrado também e a função next deve ser chamada.

É importante que você coloque dentro de request.user o usuário encontrado e dentro de request.todo o todo encontrado.
Should not be able to put user and todo in request when user does not exists

Para que esse teste passe, no middleware checksTodoExists você deve retornar uma resposta com status 404 caso não exista um usuário com o username passado pelo header da requisição.
Should not be able to put user and todo in request when todo id is not uuid

Para que esse teste passe, no middleware checksTodoExists você deve retornar uma resposta com status 400 caso o id do todo passado pelos parâmetros da requisição não seja um UUID válido (por exemplo 1234abcd).
Should not be able to put user and todo in request when todo does not exists

Para que esse teste passe, no middleware checksTodoExists você deve retornar uma resposta com status 404 caso o id do todo passado pelos parâmetros da requisição não pertença a nenhum todo do usuário encontrado.
Should be able to find user by id route param and pass it to request.user

Para que esse teste passe, o middleware findUserById deve receber o id de um usuário de dentro do request.params. Você deve validar que o usuário exista, repassar ele para request.user e retornar a chamada da função next.
Should not be able to pass user to request.user when it does not exists

Para que esse teste passe, no middleware findUserById você deve retornar uma resposta com status 404 caso o id do usuário **passado pelos parâmetros da requisição não pertença a nenhum usuário cadastrado.

Rodar os testes

yarn install

yarn test

📅 Entrega

Esse desafio deve ser entregue a partir da plataforma da Rocketseat. Envie o link do repositório que você fez suas alterações. Após concluir o desafio, além de ter mandado o código para o GitHub, fazer um post no LinkedIn é uma boa forma de demonstrar seus conhecimentos e esforços para evoluir na sua carreira para oportunidades futuras.

📝 Licença

Esse projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

brcaua / desafio02-ignite