Guia Prático: Arquitetura RESTful & Testes com Express.js e Thunder Client

// OBRIGATÓRIO: Habilitar o parser de corpo JSON no Express
app.use(express.json());

// Rota para Cadastrar um Novo Produto
app.post('/produtos', (req, res) => {
  // Extrai as informações enviadas pelo cliente no corpo (body) da requisição
  const { nome, preco } = req.body;

  // Validação simples dos dados recebidos
  if (!nome || preco === undefined) {
    return res.status(400).json({ mensagem: 'Nome e Preço são obrigatórios.' });
  }

  // Criação do novo registro com identificador único incremental
  const novoProduto = {
    id: produtos.length > 0 ? produtos[produtos.length - 1].id + 1 : 1,
    nome,
    preco: Number(preco)
  };

  produtos.push(novoProduto);

  // RESTful: Retorna HTTP Status 201 Created + Objeto Criado
  return res.status(201).json({
    mensagem: 'Produto cadastrado com sucesso!',
    produto: novoProduto
  });
});

// Rota para Atualizar um Produto Existente
app.put('/produtos/:id', (req, res) => {
  const { id } = req.params;             // ID na URL
  const { nome, preco } = req.body;      // Novos dados no Body

  // Localiza a posição do produto no array
  const index = produtos.findIndex(p => p.id === parseInt(id));

  // Caso o produto não exista no banco/memória
  if (index === -1) {
    return res.status(404).json({ mensagem: 'Produto não encontrado para atualização.' });
  }

  // Atualiza os dados mantendo o ID original
  produtos[index] = {
    ...produtos[index],
    nome: nome || produtos[index].nome,
    preco: preco !== undefined ? Number(preco) : produtos[index].preco
  };

  // Retorna HTTP Status 200 OK com o registro atualizado
  return res.status(200).json({
    mensagem: 'Produto atualizado com sucesso!',
    produto: produtos[index]
  });
});

// Rota para Deletar um Produto pelo ID
app.delete('/produtos/:id', (req, res) => {
  const { id } = req.params;

  // Encontra a posição do item
  const index = produtos.findIndex(p => p.id === parseInt(id));

  // Se não existir, retorna 404 Not Found
  if (index === -1) {
    return res.status(404).json({ mensagem: 'Produto não encontrado para exclusão.' });
  }

  // Remove o elemento do array em memória
  produtos.splice(index, 1);

  // Retorna HTTP Status 200 OK com mensagem de confirmação
  return res.status(200).json({
    mensagem: `Produto com ID ${id} removido com sucesso!`
  });
});