jerkjs 2.1.6 → 2.2.0

package/standard/routes.json

@@ -1,65 +0,0 @@
-[
-  {
-    "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"
-  },
-  {
-    "path": "/test-compression-hooks",
-    "method": "GET",
-    "controller": "CompressionTestController",
-    "handler": "testCompressionHooks",
-    "contentType": "application/json"
-  }
-]

package/standard/server.js

@@ -1,140 +0,0 @@
-/**
- * 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({ hooks: hooks });
-    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/standardA/controllers/AuthController.js

@@ -1,82 +0,0 @@
-const ControllerBase = require('../../lib/mvc/controllerBase');
-
-class AuthController extends ControllerBase {
-  constructor(options = {}) {
-    super(options);
-    this.viewsPath = './standardA/views'; // Ruta a las vistas
-  }
-
-  // Mostrar formulario de login
-  showLogin(req, res) {
-    this.set('title', 'Iniciar Sesión');
-    this.render(res, 'auth/login');
-  }
-
-  // Manejar el proceso de login con sesiones
-  async handleLogin(req, res) {
-    const { username, password } = req.body;
-
-    // Validación básica
-    if (!username || !password) {
-      this.set('title', 'Error de Login');
-      this.set('error', 'Por favor, proporciona usuario y contraseña');
-      this.render(res, 'auth/login');
-      return;
-    }
-
-    // Lógica de autenticación simulada (en una aplicación real, esto sería contra una base de datos)
-    if (username === 'admin' && password === 'password123') {
-      // Crear sesión para el usuario
-      if (req.session) {
-        req.session.create({
-          authenticated: true,
-          userId: 1,
-          username: 'admin',
-          role: 'admin',
-          loginTime: new Date().toISOString()
-        });
-      }
-
-      // Redirigir al dashboard
-      res.writeHead(302, { 'Location': '/dashboard' });
-      res.end();
-    } else {
-      this.set('title', 'Error de Login');
-      this.set('error', 'Credenciales inválidas');
-      this.render(res, 'auth/login');
-    }
-  }
-
-  // Manejar logout con sesiones
-  handleLogout(req, res) {
-    // Destruir la sesión
-    if (req.session) {
-      req.session.destroy();
-    }
-
-    res.writeHead(302, { 'Location': '/' });
-    res.end();
-  }
-
-  // Mostrar el dashboard (requiere autenticación por sesión)
-  showDashboard(req, res) {
-    // Esta ruta está protegida por el middleware de sesión
-    this.set('title', 'Panel de Control');
-    this.set('user', req.session?.data || { username: 'Invitado' });
-    this.render(res, 'auth/dashboard');
-  }
-
-  // Endpoint protegido con JWT (este endpoint se protege con el middleware de autenticación JWT)
-  protectedApiEndpoint(req, res) {
-    // Esta ruta está protegida por el middleware de autenticación JWT
-    // La información del usuario autenticado está disponible en req.user
-    res.writeHead(200, { 'Content-Type': 'application/json' });
-    res.end(JSON.stringify({
-      message: 'Acceso concedido a recurso protegido',
-      user: req.user,
-      timestamp: new Date().toISOString()
-    }));
-  }
-}
-
-module.exports = new AuthController();

package/standardA/controllers/HomeController.js

@@ -1,19 +0,0 @@
-const ControllerBase = require('../../lib/mvc/controllerBase');
-
-class HomeController extends ControllerBase {
-  constructor(options = {}) {
-    super(options);
-    this.viewsPath = './standardA/views'; // Ruta a las vistas
-  }
-
-  index(req, res) {
-    // Establecer variables para la vista
-    this.set('title', 'Página de Inicio');
-    this.set('message', 'Bienvenido al ejemplo sin routes.json');
-
-    // Renderizar la vista
-    this.render(res, 'index');
-  }
-}
-
-module.exports = new HomeController();

package/standardA/controllers/UserController.js

@@ -1,41 +0,0 @@
-const ControllerBase = require('../../lib/mvc/controllerBase');
-
-class UserController extends ControllerBase {
-  constructor(options = {}) {
-    super(options);
-    this.viewsPath = './standardA/views'; // Ruta a las vistas
-  }
-
-  getAll(req, res) {
-    const users = [
-      { id: 1, name: 'Juan Pérez', email: 'juan@example.com' },
-      { id: 2, name: 'Ana García', email: 'ana@example.com' },
-      { id: 3, name: 'Luis Rodríguez', email: 'luis@example.com' }
-    ];
-
-    // Establecer variables para la vista
-    this.set('title', 'Lista de Usuarios');
-    this.set('users', users);
-
-    // Renderizar la vista
-    this.render(res, 'users/list');
-  }
-
-  getById(req, res) {
-    const userId = req.params.id;
-    const user = {
-      id: userId,
-      name: `Usuario ${userId}`,
-      email: `usuario${userId}@example.com`,
-      registered: new Date().toISOString()
-    };
-
-    // Establecer variables para la vista
-    this.set('user', user);
-
-    // Renderizar la vista
-    this.render(res, 'users/detail');
-  }
-}
-
-module.exports = new UserController();

package/standardA/server.js

@@ -1,311 +0,0 @@
-const { APIServer, Logger, Authenticator, Cors, RateLimiter, Compressor, Firewall, SessionManager, ViewEngine, ControllerBase, hooks } = require('../index.js');
-
-class StandardAServer {
-  constructor() {
-    // Obtener puerto de variable de entorno, obligatorio
-    this.port = parseInt(process.env.PORT) || 3000;
-    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({ hooks: hooks });
-    this.firewall = new Firewall({ logger: this.logger });
-    this.sessionManager = new SessionManager();
-    // Inicializar ViewEngine con hooks para diagnóstico
-    this.viewEngine = new ViewEngine({ hooks: hooks });
-
-    // Registrar hooks para diagnóstico del sistema de vistas
-    this.setupViewEngineDiagnostics();
-
-    // Registrar hooks para mostrar información al iniciar
-    this.setupHooks();
-  }
-
-  setupViewEngineDiagnostics() {
-    // Hook para diagnosticar la obtención de rutas de vistas
-    hooks.addFilter('view_get_path_before_processing', (viewName, viewEngine) => {
-      console.log(`[DIAGNÓSTICO VIEW] getViewPath llamado con: "${viewName}"`);
-      return viewName;
-    });
-
-    // Hook para diagnosticar la detección de extensión
-    hooks.addAction('view_extension_detection', (viewName, hasExtension, viewEngine) => {
-      console.log(`[DIAGNÓSTICO VIEW] Nombre: "${viewName}", Tiene extensión: ${hasExtension}`);
-    });
-
-    // Hook para diagnosticar la normalización del path
-    hooks.addFilter('view_normalized_path', (normalizedPath, viewName, hasExtension, viewEngine) => {
-      console.log(`[DIAGNÓSTICO VIEW] Path normalizado: "${normalizedPath}", Original: "${viewName}", Tiene extensión: ${hasExtension}`);
-      return normalizedPath;
-    });
-
-    // Hook para diagnosticar la ruta final
-    hooks.addFilter('view_get_path_after_processing', (viewPath, viewName, normalizedPath, viewEngine) => {
-      console.log(`[DIAGNÓSTICO VIEW] Ruta final: "${viewPath}", Nombre original: "${viewName}", Path normalizado: "${normalizedPath}"`);
-      return viewPath;
-    });
-  }
-
-  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 (Sin routes.json) ===');
-      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');
-
-      // Configurar rutas sin usar routes.json
-      this.configureRoutes();
-    });
-
-    // 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}`);
-    });
-  }
-
-  configureRoutes() {
-    // Importar controladores
-    const HomeController = require('./controllers/HomeController');
-    const UserController = require('./controllers/UserController');
-    const AuthController = require('./controllers/AuthController');
-
-    // Ruta principal
-    this.server.addRoute('GET', '/', (req, res) => {
-      HomeController.setRequestResponse(req, res);
-      HomeController.index(req, res);
-    });
-
-    // Rutas de usuarios
-    this.server.addRoute('GET', '/users', (req, res) => {
-      UserController.setRequestResponse(req, res);
-      UserController.getAll(req, res);
-    });
-
-    this.server.addRoute('GET', '/users/:id', (req, res) => {
-      UserController.setRequestResponse(req, res);
-      UserController.getById(req, res);
-    });
-
-    // Rutas de autenticación con sesiones
-    this.server.addRoute('GET', '/login', (req, res) => {
-      AuthController.setRequestResponse(req, res);
-      AuthController.showLogin(req, res);
-    });
-
-    this.server.addRoute('POST', '/auth/login', (req, res) => {
-      AuthController.setRequestResponse(req, res);
-      AuthController.handleLogin(req, res);
-    }, {
-      contentType: 'application/json'
-    });
-
-    this.server.addRoute('POST', '/auth/logout', (req, res) => {
-      AuthController.setRequestResponse(req, res);
-      AuthController.handleLogout(req, res);
-    }, {
-      contentType: 'application/json'
-    });
-
-    // Ruta protegida con autenticación por sesión
-    this.server.addRoute('GET', '/dashboard', (req, res) => {
-      // Verificar si el usuario está autenticado a través de sesión
-      if (!req.session || !req.session.data || !req.session.data.authenticated) {
-        res.writeHead(302, { 'Location': '/login' });
-        res.end();
-        return;
-      }
-
-      AuthController.setRequestResponse(req, res);
-      AuthController.showDashboard(req, res);
-    });
-
-    // Ruta protegida con autenticación JWT - usando middleware de autenticación
-    // Verificar que JWT_SECRET esté definido antes de crear la ruta
-    const jwtSecret = process.env.JWT_SECRET;
-    if (!jwtSecret) {
-      this.logger.warn('Advertencia: JWT_SECRET no está definido. La ruta /api/protected no estará disponible.');
-    } else {
-      // Registrar estrategia JWT en el authenticator como se hace en los ejemplos
-      this.authenticator.use('jwt-standardA', async (req, options = {}) => {
-        const authHeader = req.headers.authorization;
-        const token = authHeader && authHeader.split(' ')[1]; // Bearer TOKEN
-
-        if (!token) {
-          return false;
-        }
-
-        try {
-          // Usar jsonwebtoken para validar el token como en los ejemplos
-          const jwt = require('jsonwebtoken');
-          const decoded = jwt.verify(token, jwtSecret);
-
-          // Agregar información del usuario a la solicitud
-          req.user = decoded;
-          return true;
-        } catch (error) {
-          // Token inválido o expirado
-          return false;
-        }
-      });
-
-      this.server.addRoute('GET', '/api/protected', (req, res) => {
-        // Aplicar autenticación JWT manualmente
-        const authHeader = req.headers.authorization;
-        const token = authHeader && authHeader.split(' ')[1]; // Bearer TOKEN
-
-        if (!token) {
-          res.writeHead(401, { 'Content-Type': 'application/json' });
-          res.end(JSON.stringify({ error: 'Token no proporcionado' }));
-          return;
-        }
-
-        try {
-          // Usar jsonwebtoken para validar el token como en los ejemplos
-          const jwt = require('jsonwebtoken');
-          const decoded = jwt.verify(token, process.env.JWT_SECRET);
-
-          // Agregar información del usuario a la solicitud
-          req.user = decoded;
-
-          // Continuar con la lógica del controlador
-          AuthController.setRequestResponse(req, res);
-          AuthController.protectedApiEndpoint(req, res);
-        } catch (error) {
-          res.writeHead(401, { 'Content-Type': 'application/json' });
-          res.end(JSON.stringify({ error: 'Token inválido o expirado' }));
-        }
-      }, {
-        contentType: 'application/json'
-      });
-    }
-
-    // Endpoint para login JWT
-    this.server.addRoute('POST', '/api/login', (req, res) => {
-      const { username, password } = req.body;
-
-      // Validación básica
-      if (!username || !password) {
-        res.writeHead(400, { 'Content-Type': 'application/json' });
-        res.end(JSON.stringify({
-          success: false,
-          message: 'Usuario y contraseña son requeridos'
-        }));
-        return;
-      }
-
-      // Lógica de autenticación simulada
-      if (username === 'admin' && password === 'password123') {
-        // Verificar que JWT_SECRET esté definido en las variables de entorno
-        const jwtSecret = process.env.JWT_SECRET;
-        if (!jwtSecret) {
-          this.logger.error('ERROR: JWT_SECRET no está definido en las variables de entorno');
-          res.writeHead(500, { 'Content-Type': 'application/json' });
-          res.end(JSON.stringify({
-            success: false,
-            message: 'Configuración de seguridad incompleta - JWT_SECRET no definido'
-          }));
-          return;
-        }
-
-        // Generar un token JWT usando jsonwebtoken directamente como en los ejemplos
-        const jwt = require('jsonwebtoken');
-        const payload = {
-          userId: 1,
-          username: username,
-          role: 'admin'
-        };
-
-        const token = jwt.sign(payload, jwtSecret, { expiresIn: '1h' });
-
-        res.writeHead(200, { 'Content-Type': 'application/json' });
-        res.end(JSON.stringify({
-          success: true,
-          token,
-          user: { id: 1, username: 'admin', role: 'admin' }
-        }));
-      } else {
-        res.writeHead(401, { 'Content-Type': 'application/json' });
-        res.end(JSON.stringify({
-          success: false,
-          message: 'Credenciales inválidas'
-        }));
-      }
-    }, {
-      contentType: 'application/json'
-    });
-
-    // Ruta de API con content-type JSON
-    this.server.addRoute('GET', '/api/data', (req, res) => {
-      res.end(JSON.stringify({ message: 'Datos de la API', timestamp: new Date().toISOString() }));
-    }, {
-      contentType: 'application/json'
-    });
-
-    this.logger.info('Rutas configuradas sin usar routes.json');
-  }
-
-  // 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());
-
-    // Configurar el motor de vistas en el servidor
-    this.server.viewEngine = this.viewEngine;
-    const path = require('path');
-    this.viewEngine.viewsPath = path.resolve(__dirname, 'views');
-  }
-
-  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 standardAServer = new StandardAServer();
-standardAServer.start();
-
-module.exports = StandardAServer;