jerkjs 2.1.0 → 2.1.2

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # CHANGELOG
 
-## v2.1.0 - 17 de enero de 2026
+## v2.1.2 - 17 de enero de 2026
 
 ### Nuevas características
 
@@ -28,4 +28,5 @@
 - Corrección de ineficiencia en el procesamiento de cuerpos de solicitud grandes
 - Mejora en la gestión de memoria durante el procesamiento de solicitudes
 - Corrección de posibles problemas de rendimiento en aplicaciones con muchas rutas parametrizadas
-- Mejora en la estabilidad del servidor bajo carga prolongada
+- Mejora en la estabilidad del servidor bajo carga prolongada
+- **Corrección crítica del middleware de compresión**: Se resolvió el error "ERR_HTTP_HEADERS_SENT" que ocurría cuando el middleware intentaba modificar encabezados después de que ya habían sido enviados al cliente. Se añadió verificación de `res.headersSent` antes de manipular encabezados.

package/README.md

@@ -1,4 +1,4 @@
-# JERK Framework v2.0
+# JERK Framework v2.1.2
 
 ![JERK Framework Logo](jerk.jpg)
 

package/index.js

@@ -1,6 +1,6 @@
 /**
  * Punto de entrada del framework JERK
- * JERK Framework v2.1
+ * JERK Framework v2.1.2
  */
 
 const APIServer = require('./lib/core/server');

package/lib/middleware/compressor.js

@@ -1,7 +1,7 @@
 /**
  * Middleware de compresión para el framework JERK
  * Implementación del componente middleware/compressor.js
- * JERK Framework v2.1 - Con optimizaciones de eficiencia
+ * JERK Framework v2.1.1 - Con optimizaciones de eficiencia y corrección de errores
  */
 
 const zlib = require('zlib');
@@ -76,8 +76,11 @@ class Compressor {
 
         // Si el cuerpo es menor que el umbral, enviar sin comprimir
         if (Buffer.byteLength(responseBody) < this.threshold) {
-          res.removeHeader('Content-Encoding'); // Asegurar que no haya encabezado de codificación
-          originalWriteHead.call(res);
+          // Solo establecer encabezados si no se han enviado aún
+          if (!res.headersSent) {
+            res.removeHeader('Content-Encoding'); // Asegurar que no haya encabezado de codificación
+            originalWriteHead.call(res);
+          }
           originalEnd.call(res, responseBody, encoding);
           return;
         }
@@ -111,12 +114,15 @@ class Compressor {
         // Esperar a que se complete la compresión y enviar la respuesta
         compressPromise
           .then(compressed => {
-            // Establecer encabezados apropiados
-            res.setHeader('Content-Encoding', compressionMethod);
-            res.removeHeader('Content-Length'); // Eliminar Content-Length original
+            // Solo establecer encabezados si no se han enviado aún
+            if (!res.headersSent) {
+              // Establecer encabezados apropiados
+              res.setHeader('Content-Encoding', compressionMethod);
+              res.removeHeader('Content-Length'); // Eliminar Content-Length original
 
-            // Llamar al writeHead original
-            originalWriteHead.call(res);
+              // Llamar al writeHead original
+              originalWriteHead.call(res);
+            }
 
             // Enviar el cuerpo comprimido
             originalEnd.call(res, compressed, encoding);
@@ -124,8 +130,10 @@ class Compressor {
           .catch(err => {
             console.error('Error comprimiendo la respuesta:', err);
             // Si ocurre un error, enviar sin comprimir
-            res.removeHeader('Content-Encoding');
-            originalWriteHead.call(res);
+            if (!res.headersSent) {
+              res.removeHeader('Content-Encoding');
+              originalWriteHead.call(res);
+            }
             originalEnd.call(res, responseBody, encoding);
           });
       };
@@ -185,12 +193,16 @@ class Compressor {
             zlib.gzip(jsonString, this.gzipOptions, (err, compressed) => {
               if (err) {
                 console.error('Error comprimiendo JSON:', err);
-                res.setHeader('Content-Type', 'application/json');
+                if (!res.headersSent) {
+                  res.setHeader('Content-Type', 'application/json');
+                }
                 originalSend.call(res, jsonString);
               } else {
-                res.setHeader('Content-Encoding', compressionMethod);
-                res.removeHeader('Content-Length');
-                res.setHeader('Content-Type', 'application/json');
+                if (!res.headersSent) {
+                  res.setHeader('Content-Encoding', compressionMethod);
+                  res.removeHeader('Content-Length');
+                  res.setHeader('Content-Type', 'application/json');
+                }
                 originalSend.call(res, compressed);
               }
             });
@@ -198,12 +210,16 @@ class Compressor {
             zlib.deflate(jsonString, this.deflateOptions, (err, compressed) => {
               if (err) {
                 console.error('Error comprimiendo JSON:', err);
-                res.setHeader('Content-Type', 'application/json');
+                if (!res.headersSent) {
+                  res.setHeader('Content-Type', 'application/json');
+                }
                 originalSend.call(res, jsonString);
               } else {
-                res.setHeader('Content-Encoding', compressionMethod);
-                res.removeHeader('Content-Length');
-                res.setHeader('Content-Type', 'application/json');
+                if (!res.headersSent) {
+                  res.setHeader('Content-Encoding', compressionMethod);
+                  res.removeHeader('Content-Length');
+                  res.setHeader('Content-Type', 'application/json');
+                }
                 originalSend.call(res, compressed);
               }
             });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jerkjs",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "description": "JERK Framework v2.1 - A comprehensive framework for building secure and scalable APIs with frontend support, sessions, and template engine with performance optimizations",
   "main": "index.js",
   "scripts": {

package/standard/CompressionTestController.js

@@ -0,0 +1,38 @@
+/**
+ * Controlador para probar compresión
+ */
+
+class CompressionTestController {
+  // Endpoint que devuelve datos grandes para probar compresión
+  getLargeData(req, res) {
+    // Crear un objeto grande con datos repetidos
+    const largeData = {
+      message: 'Datos grandes para probar compresión',
+      timestamp: new Date().toISOString(),
+      data: []
+    };
+
+    // Agregar muchos elementos para aumentar el tamaño
+    for (let i = 0; i < 1000; i++) {
+      largeData.data.push({
+        id: i,
+        title: `Elemento ${i}`,
+        description: `Esta es una descripción larga para el elemento ${i} que ayuda a aumentar el tamaño de la respuesta`,
+        metadata: {
+          created: new Date().toISOString(),
+          tags: [`tag-${i % 10}`, `category-${i % 5}`],
+          properties: {
+            prop1: `value-${i}`,
+            prop2: `another-value-${i}`,
+            prop3: `third-value-${i}`
+          }
+        }
+      });
+    }
+
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify(largeData));
+  }
+}
+
+module.exports = new CompressionTestController();

package/standard/HealthController.js

@@ -0,0 +1,16 @@
+/**
+ * Controlador de salud del sistema
+ */
+
+class HealthController {
+  checkHealth(req, res) {
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ 
+      status: 'healthy', 
+      timestamp: new Date().toISOString(),
+      uptime: process.uptime()
+    }));
+  }
+}
+
+module.exports = new HealthController();

package/standard/HomeController.js

@@ -0,0 +1,12 @@
+/**
+ * Controlador de ejemplo para la ruta raíz
+ */
+
+class HomeController {
+  index(req, res) {
+    res.writeHead(200, { 'Content-Type': 'text/html' });
+    res.end('<h1>Bienvenido al servidor estándar de JERK</h1>');
+  }
+}
+
+module.exports = new HomeController();

package/standard/ProductController.js

@@ -0,0 +1,18 @@
+/**
+ * Controlador de productos
+ */
+
+class ProductController {
+  getAllProducts(req, res) {
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ products: [] }));
+  }
+
+  getProductById(req, res) {
+    const productId = req.params.id;
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ id: productId, name: `Producto ${productId}` }));
+  }
+}
+
+module.exports = new ProductController();

package/standard/README.md

@@ -0,0 +1,47 @@
+# Servidor Estándar JERK
+
+Este es el servidor estándar para JERK Framework v2.1. Implementa todas las características del framework y carga rutas desde un archivo `routes.json`.
+
+## Características
+
+- Carga de rutas desde `routes.json`
+- Puerto configurable mediante variable de entorno `PORT`
+- Todas las características del framework habilitadas:
+  - Autenticación (JWT, API Key, Basic, OAuth2, OIDC)
+  - CORS
+  - Rate Limiting
+  - Compresión
+  - Firewall
+  - Sesiones
+  - Sistema de Hooks/Filters
+  - MVC (Modelo-Vista-Controlador)
+  - Motor de plantillas
+  - Manejo de errores
+
+## Variables de Entorno
+
+- `PORT`: Puerto en el que escuchará el servidor (por defecto: 3000)
+- `HOST`: Host en el que escuchará el servidor (por defecto: localhost)
+- `USE_HTTPS`: Habilitar HTTPS (por defecto: false)
+- `HTTPS_KEY_PATH`: Ruta al archivo de clave privada para HTTPS
+- `HTTPS_CERT_PATH`: Ruta al archivo de certificado para HTTPS
+- `REQUEST_TIMEOUT`: Timeout para solicitudes en milisegundos (por defecto: 120000)
+- `CONNECTION_TIMEOUT`: Timeout para conexiones en milisegundos (por defecto: 120000)
+- `MAX_BODY_SIZE`: Tamaño máximo del cuerpo de la solicitud en bytes (por defecto: 10MB)
+
+## Uso
+
+```bash
+# Instalar dependencias
+npm install
+
+# Iniciar el servidor
+npm start
+
+# Iniciar el servidor en modo desarrollo con puerto diferente
+npm run dev
+```
+
+## Rutas
+
+Las rutas se definen en el archivo `routes.json` y se cargan automáticamente al iniciar el servidor. El servidor mostrará las rutas y características cargadas al iniciar mediante el sistema de hooks.

package/standard/UserController.js

@@ -0,0 +1,23 @@
+/**
+ * Controlador de usuarios
+ */
+
+class UserController {
+  getAllUsers(req, res) {
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ users: [] }));
+  }
+
+  getUserById(req, res) {
+    const userId = req.params.id;
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ id: userId, name: `Usuario ${userId}` }));
+  }
+
+  createUser(req, res) {
+    res.writeHead(201, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ message: 'Usuario creado', data: req.body }));
+  }
+}
+
+module.exports = new UserController();

package/standard/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "jerk-standard-server",
+  "version": "2.1.0",
+  "description": "Servidor estándar para JERK Framework v2.1",
+  "main": "server.js",
+  "scripts": {
+    "start": "node server.js",
+    "dev": "PORT=3001 node server.js"
+  },
+  "keywords": [
+    "jerk",
+    "framework",
+    "api",
+    "server",
+    "standard"
+  ],
+  "author": "JERK Framework Team",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "jerkjs": "file:.."
+  }
+}

package/standard/routes.json

@@ -0,0 +1,58 @@
+[
+  {
+    "path": "/",
+    "method": "GET",
+    "controller": "HomeController",
+    "handler": "index",
+    "contentType": "text/html"
+  },
+  {
+    "path": "/api/users",
+    "method": "GET",
+    "controller": "UserController",
+    "handler": "getAllUsers",
+    "contentType": "application/json"
+  },
+  {
+    "path": "/api/users/:id",
+    "method": "GET",
+    "controller": "UserController",
+    "handler": "getUserById",
+    "contentType": "application/json"
+  },
+  {
+    "path": "/api/users",
+    "method": "POST",
+    "controller": "UserController",
+    "handler": "createUser",
+    "contentType": "application/json"
+  },
+  {
+    "path": "/api/products",
+    "method": "GET",
+    "controller": "ProductController",
+    "handler": "getAllProducts",
+    "contentType": "application/json"
+  },
+  {
+    "path": "/api/products/:id",
+    "method": "GET",
+    "controller": "ProductController",
+    "handler": "getProductById",
+    "contentType": "application/json"
+  },
+  {
+    "path": "/health",
+    "method": "GET",
+    "controller": "HealthController",
+    "handler": "checkHealth",
+    "contentType": "application/json"
+  },
+  {
+    "path": "/test-compression",
+    "method": "GET",
+    "controller": "CompressionTestController",
+    "handler": "getLargeData",
+    "contentType": "application/json"
+  }
+]

package/standard/server.js

@@ -0,0 +1,140 @@
+/**
+ * Servidor estándar para JERK Framework v2.1
+ * Este servidor implementa todas las características del framework
+ * y carga rutas desde routes.json
+ */
+
+const {
+  APIServer,
+  ControllerLoader,
+  Logger,
+  Authenticator,
+  Cors,
+  RateLimiter,
+  Compressor,
+  Firewall,
+  SessionManager,
+  hooks
+} = require('../index.js');
+
+const RouteLoader = require('../lib/loader/routeLoader');
+
+class StandardServer {
+  constructor() {
+    // Obtener puerto de variable de entorno, obligatorio
+    this.port = parseInt(process.env.PORT);
+    if (isNaN(this.port)) {
+      throw new Error('La variable de entorno PORT es obligatoria');
+    }
+    this.host = process.env.HOST || 'localhost';
+    
+    // Inicializar componentes
+    this.server = new APIServer({
+      port: this.port,
+      host: this.host,
+      https: process.env.USE_HTTPS === 'true',
+      key: process.env.HTTPS_KEY_PATH,
+      cert: process.env.HTTPS_CERT_PATH,
+      requestTimeout: parseInt(process.env.REQUEST_TIMEOUT) || 120000,
+      connectionTimeout: parseInt(process.env.CONNECTION_TIMEOUT) || 120000,
+      maxBodySize: parseInt(process.env.MAX_BODY_SIZE) || 10 * 1024 * 1024
+    });
+    
+    this.logger = new Logger();
+    this.authenticator = new Authenticator({ logger: this.logger });
+    this.cors = new Cors();
+    this.rateLimiter = new RateLimiter();
+    this.compressor = new Compressor();
+    this.firewall = new Firewall({ logger: this.logger });
+    this.sessionManager = new SessionManager();
+    
+    // Registrar hooks para mostrar información al iniciar
+    this.setupHooks();
+  }
+
+  setupHooks() {
+    // Hook para mostrar información antes de iniciar el servidor
+    hooks.addAction('pre_server_start', (server) => {
+      this.logger.info('=== INICIANDO SERVIDOR ESTÁNDAR JERK ===');
+      this.logger.info(`Puerto: ${this.port}`);
+      this.logger.info('Características habilitadas:');
+      this.logger.info('- Autenticación (JWT, API Key, Basic, OAuth2, OIDC)');
+      this.logger.info('- CORS');
+      this.logger.info('- Rate Limiting');
+      this.logger.info('- Compresión');
+      this.logger.info('- Firewall');
+      this.logger.info('- Sesiones');
+      this.logger.info('- Sistema de Hooks/Filters');
+      this.logger.info('- MVC (Modelo-Vista-Controlador)');
+      this.logger.info('- Motor de plantillas');
+      this.logger.info('- Manejo de errores');
+      
+      // Cargar rutas antes de iniciar el servidor
+      this.loadRoutes();
+    });
+
+    // Hook para mostrar información después de iniciar el servidor
+    hooks.addAction('post_server_start', (server) => {
+      this.logger.info(`Servidor estándar JERK escuchando en http://${this.host}:${this.port}`);
+      this.displayLoadedRoutes();
+    });
+  }
+
+  loadRoutes() {
+    try {
+      // Instanciar RouteLoader y cargar rutas desde routes.json
+      const routeLoader = new RouteLoader();
+      routeLoader.loadRoutes(this.server, './routes.json');
+      this.logger.info('Rutas cargadas desde routes.json');
+    } catch (error) {
+      this.logger.error('Error al cargar rutas:', error.message);
+    }
+  }
+
+  displayLoadedRoutes() {
+    if (this.server.routes && this.server.routes.length > 0) {
+      this.logger.info('=== RUTAS CARGADAS ===');
+      this.server.routes.forEach((route, index) => {
+        this.logger.info(`${index + 1}. ${route.method} ${route.path}`);
+      });
+    } else {
+      this.logger.warn('No se encontraron rutas para mostrar');
+    }
+  }
+
+  // Método para configurar middlewares estándar
+  configureStandardMiddlewares() {
+    // Middleware de firewall (debe ir primero)
+    this.server.use(this.firewall.middleware());
+    
+    // Middleware de compresión
+    this.server.use(this.compressor.middleware());
+    
+    // Middleware de CORS
+    this.server.use(this.cors.middleware());
+    
+    // Middleware de limitación de tasa
+    this.server.use(this.rateLimiter.middleware());
+    
+    // Middleware de sesión
+    this.server.use(this.sessionManager.middleware());
+  }
+
+  start() {
+    // Configurar middlewares estándar
+    this.configureStandardMiddlewares();
+    
+    // Iniciar el servidor
+    this.server.start();
+  }
+
+  stop() {
+    this.server.stop();
+  }
+}
+
+// Crear e iniciar el servidor estándar
+const standardServer = new StandardServer();
+standardServer.start();
+
+module.exports = StandardServer;

package/cookies.txt

@@ -1,5 +0,0 @@
-# Netscape HTTP Cookie File
-# https://curl.se/docs/http-cookies.html
-# This file was generated by libcurl! Edit at your own risk.
-
-#HttpOnly_localhost	FALSE	/	FALSE	1768539037	frontend_session	29d7cb4e270ec66c0c7aa5d7ebe08bb8014432b8fb7746edd3895fe176fccee0

package/examples/advanced/controllers/productController.js

@@ -1,64 +0,0 @@
-/**
- * Controlador de ejemplo para productos
- * Archivo: examples/advanced/controllers/productController.js
- */
-
-// Simulación de base de datos de productos
-let products = [
-  { id: 1, name: 'Laptop', price: 1000, category: 'Electronics' },
-  { id: 2, name: 'Mouse', price: 25, category: 'Accessories' }
-];
-
-// Obtener todos los productos
-function getProducts(req, res) {
-  res.writeHead(200, { 'Content-Type': 'application/json' });
-  res.end(JSON.stringify({ 
-    success: true,
-    data: products
-  }));
-}
-
-// Actualizar un producto por ID
-function updateProduct(req, res) {
-  try {
-    const productId = parseInt(req.params.id);
-    const { name, price, category } = req.body;
-
-    const productIndex = products.findIndex(p => p.id === productId);
-
-    if (productIndex === -1) {
-      res.writeHead(404, { 'Content-Type': 'application/json' });
-      res.end(JSON.stringify({ 
-        success: false,
-        message: 'Producto no encontrado'
-      }));
-      return;
-    }
-
-    // Actualizar producto
-    products[productIndex] = {
-      ...products[productIndex],
-      ...(name && { name }),
-      ...(price && { price }),
-      ...(category && { category })
-    };
-
-    res.writeHead(200, { 'Content-Type': 'application/json' });
-    res.end(JSON.stringify({ 
-      success: true,
-      data: products[productIndex]
-    }));
-  } catch (error) {
-    res.writeHead(500, { 'Content-Type': 'application/json' });
-    res.end(JSON.stringify({ 
-      success: false,
-      message: 'Error al actualizar producto'
-    }));
-  }
-}
-
-// Exportar handlers
-module.exports = {
-  getProducts,
-  updateProduct
-};

package/examples/advanced/controllers/userController.js

@@ -1,85 +0,0 @@
-/**
- * Controlador de ejemplo para usuarios
- * Archivo: examples/basic/controllers/userController.js
- */
-
-// Simulación de base de datos
-let users = [
-  { id: 1, name: 'John Doe', email: 'john@example.com' },
-  { id: 2, name: 'Jane Smith', email: 'jane@example.com' }
-];
-
-// Obtener todos los usuarios
-function getUsers(req, res) {
-  res.writeHead(200, { 'Content-Type': 'application/json' });
-  res.end(JSON.stringify({
-    success: true,
-    data: users
-  }));
-}
-
-// Obtener un usuario por ID
-function getUserById(req, res) {
-  const userId = parseInt(req.params.id);
-  const user = users.find(u => u.id === userId);
-
-  if (!user) {
-    res.writeHead(404, { 'Content-Type': 'application/json' });
-    res.end(JSON.stringify({
-      success: false,
-      message: 'Usuario no encontrado'
-    }));
-    return;
-  }
-
-  res.writeHead(200, { 'Content-Type': 'application/json' });
-  res.end(JSON.stringify({
-    success: true,
-    data: user
-  }));
-}
-
-// Crear un nuevo usuario
-function createUser(req, res) {
-  try {
-    const { name, email } = req.body;
-
-    // Validar datos
-    if (!name || !email) {
-      res.writeHead(400, { 'Content-Type': 'application/json' });
-      res.end(JSON.stringify({
-        success: false,
-        message: 'Nombre y correo electrónico son requeridos'
-      }));
-      return;
-    }
-
-    // Crear nuevo usuario
-    const newUser = {
-      id: users.length + 1,
-      name,
-      email
-    };
-
-    users.push(newUser);
-
-    res.writeHead(201, { 'Content-Type': 'application/json' });
-    res.end(JSON.stringify({
-      success: true,
-      data: newUser
-    }));
-  } catch (error) {
-    res.writeHead(500, { 'Content-Type': 'application/json' });
-    res.end(JSON.stringify({
-      success: false,
-      message: 'Error al crear usuario'
-    }));
-  }
-}
-
-// Exportar handlers
-module.exports = {
-  getUsers,
-  getUserById,
-  createUser
-};