Saltar al contenido principal

TEC-004 — Compresión de Respuestas

· 2 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

Implementación de la mejora TEC-004 (Compresión de Respuestas), dentro de 6.1 Rendimiento y Escalabilidad. Las respuestas de la API se comprimen con gzip o brotli según lo que pida el cliente, y se deja sin tocar lo que no conviene comprimir.


📋 Alcance​

RFEntregable
RF-TEC-004-01Compresión gzip/brotli en las respuestas
RF-TEC-004-02Negociación del algoritmo según Accept-Encoding
RF-TEC-004-03Exclusión de recursos que no lo requieren

⚙️ Cómo funciona​

  • Middleware propio sobre node:zlib, montado en main.ts con app.use(...). Sin dependencias nuevas.
  • Negociación (RF-02): parsea Accept-Encoding con q-values y comodín *, prioriza brotli cuando ambos se aceptan por igual y añade Vary: Accept-Encoding. deflate no se soporta: quien solo acepte deflate recibe la respuesta sin comprimir.
  • Exclusiones (RF-03): lista blanca de tipos de texto (json, xml, text/*, svg, +json/+xml); quedan fuera imágenes, video, audio, PDF, ZIP, XLSX, octet-stream, fuentes, streams SSE, 204/206/304, HEAD, Cache-Control: no-transform, respuestas ya comprimidas, cuerpos menores a 1 KB y cuerpos mayores al tope de buffer (5 MB).
  • Al comprimir se eliminan Content-Length (Node lo recalcula con chunked) y ETag.

🔧 Configuración​

COMPRESSION_ENABLED=true
COMPRESSION_THRESHOLD=1024
COMPRESSION_GZIP_LEVEL=6
COMPRESSION_BROTLI_QUALITY=4
COMPRESSION_PREFERIR_BROTLI=true

Con un proxy inverso que ya comprima, COMPRESSION_ENABLED=false evita duplicar el trabajo.

✅ Verificación​

  • 35 pruebas nuevas (negociación, clasificación de tipos y middleware con servidor HTTP real).
  • 580 pruebas en 57 suites, 0 fallos en la API; tsc, ESLint y npm run build limpios.
  • Script de integración contra la API real: gzip, brotli, q-values, Vary, identity y exclusión de imagen.

Nota: no requiere cambios en el frontend; el navegador negocia Accept-Encoding solo.