Snippets Node.js

Piezas listas para construir APIs con Node.js + Express en proyectos reales: estructura de carpetas, conexión a MySQL y PostgreSQL, autenticación con JWT, manejo de errores, subida de archivos, correos, seguridad, paginación y validación.

Todos los ejemplos usan módulos ES (import/export), Node 20 o superior y async/await. Están pensados para encajar entre sí: el servidor base define la estructura y los demás snippets añaden archivos dentro de ella.

Estructura común

mi-api/
├── .env
├── package.json          ← "type": "module"
└── src/
    ├── server.js         ← arranca el servidor
    ├── app.js            ← configura Express
    ├── config/env.js     ← variables de entorno validadas
    ├── db/               ← conexión MySQL o PostgreSQL
    ├── routes/           ← rutas por recurso
    ├── controllers/      ← lógica de cada ruta
    ├── middlewares/      ← auth, errores, validación, subida
    └── utils/            ← correo, helpers

Temario

1. Servidor Express base — estructura profesional, dotenv y arranque.
2. CRUD con MySQL — pool de mysql2/promise y consultas preparadas.
3. CRUD con PostgreSQL — pg Pool y RETURNING.
4. Autenticación JWT — registro, login, access + refresh token.
5. Middleware de errores — AppError, asyncHandler y 404.
6. Subida de archivos con multer — límites, filtros y nombres seguros.
7. Correos con nodemailer — SMTP y plantillas HTML.
8. Helmet, CORS y rate limit — cabeceras seguras y límites de peticiones.
9. Paginación — offset, cursor y metadatos.
10. Validación con zod — esquemas y middleware reutilizable.

Arranque rápido

mkdir mi-api && cd mi-api
npm init -y
npm pkg set type=module
npm install express dotenv
npm install -D nodemon

Requisito previo: el curso de Node.js.