mkdir tdd-product-api
cd tdd-product-api
npm init -y

📋 Copiar

npm install express
npm install --save-dev mocha chai supertest

📋 Copiar

{
  "name": "tdd-product-api",
  "version": "1.0.0",
  "description": "",
  "main": "src/server.js",
  "scripts": {
    "start": "node src/server.js",
    "test": "mocha --recursive tests/*/.test.js --timeout 5000",
    "dev": "nodemon src/server.js"
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  "dependencies": {
    "express": "^4.19.2"
  },
  "devDependencies": {
    "chai": "^4.4.1",
    "mocha": "^10.4.0",
    "supertest": "^7.0.0",
    "nodemon": "^3.1.0"
  }
}

📋 Copiar

npm install --save-dev nodemon

📋 Copiar

.
├── src/
│   ├── app.js
│   ├── server.js
│   ├── services/
│   │   └── productService.js
│   ├── controllers/
│   │   └── productController.js
│   └── routes/
│       └── productRoutes.js
└── tests/
    ├── unit/
    │   └── productService.test.js
    └── integration/
        └── productIntegration.test.js

📋 Copiar

// tests/unit/productService.test.js
const chai = require('chai');
const expect = chai.expect;
const productService = require('../../src/services/productService'); // O serviço ainda não existe!

describe('Product Service Unit Tests', () => {
    // Limpa a "base de dados" em memória antes de cada teste para garantir isolamento
    beforeEach(() => {
        productService.clearProducts(); // Esta função ainda não existe!
    });
    it('deve criar um novo produto com um nome e preço válidos', () => {
        // Cenário: Tentando criar um produto válido
        const productData = { name: 'Teclado Mecânico', price: 150.00 };
        const newProduct = productService.createProduct(productData); // O método ainda não existe!
        // Asserção: Verifique se o produto foi criado corretamente
        expect(newProduct).to.be.an('object');
        expect(newProduct).to.have.property('id'); // Deve ter um ID gerado
        expect(newProduct.name).to.equal('Teclado Mecânico');
        expect(newProduct.price).to.equal(150.00);
        expect(productService.getAllProducts()).to.have.lengthOf(1); // Deve haver um produto na lista
    });
    it('não deve criar um produto sem nome', () => {
        // Cenário: Tentando criar um produto sem nome
        const productData = { price: 100.00 };
        // Esperamos que a criação de um produto inválido lance um erro
        expect(() => productService.createProduct(productData)).to.throw('O nome do produto é obrigatório.');
        expect(productService.getAllProducts()).to.have.lengthOf(0); // Nenhum produto deve ser adicionado
    });
    it('não deve criar um produto com preço inválido (negativo ou zero)', () => {
        // Cenário: Tentando criar um produto com preço negativo
        const productData = { name: 'Mouse Gamer', price: -50.00 };
        expect(() => productService.createProduct(productData)).to.throw('O preço do produto deve ser um número positivo.');
        expect(productService.getAllProducts()).to.have.lengthOf(0); // Nenhum produto deve ser adicionado
        // Cenário: Tentando criar um produto com preço zero
        const productDataZero = { name: 'Mouse Gamer', price: 0 };
        expect(() => productService.createProduct(productDataZero)).to.throw('O preço do produto deve ser um número positivo.');
        expect(productService.getAllProducts()).to.have.lengthOf(0); // Nenhum produto deve ser adicionado
    });
});

📋 Copiar

npm test

📋 Copiar

// src/services/productService.js
let products = []; // Nosso "banco de dados" em memória
let nextProductId = 1; // Para simular IDs únicos

/* @function createProduct
  @description Cria um novo produto após validação.
  @param {object} productData - Dados do produto (name, price).
  @returns {object} O produto recém-criado.
  @throws {Error} Se os dados do produto forem inválidos.
 /
function createProduct(productData) {
    // Validação de entrada robusta
    if (!productData.name || typeof productData.name !== 'string' || productData.name.trim() === '') {
        console.error('Erro de validação: Nome do produto é inválido.');
        throw new Error('O nome do produto é obrigatório.');
    }
    if (typeof productData.price !== 'number' || productData.price <= 0) {
        console.error('Erro de validação: Preço do produto é inválido.');
        throw new Error('O preço do produto deve ser um número positivo.');
    }

    const newProduct = {
        id: nextProductId++,
        name: productData.name,
        price: productData.price
    };
    products.push(newProduct);
    console.log(Produto criado: ${JSON.stringify(newProduct)}); // Logging profissional básico
    return newProduct;
}
/ @function getAllProducts
  @description Retorna todos os produtos armazenados.
  @returns {Array