jerkjs 2.0.1 → 2.0.2

package/examples/advanced_example.js

@@ -0,0 +1,93 @@
+/**
+ * Ejemplo real de uso del framework JERK
+ * Este script demuestra cómo cargar rutas desde un archivo JSON
+ * y usar los controladores definidos en el archivo de rutas
+ */
+
+const path = require('path');
+const { JERK, RouteLoader, Authenticator, Logger } = require('../index');
+
+// Crear instancia del logger
+const logger = new Logger({ level: 'info', timestamp: true });
+
+logger.info('Iniciando ejemplo real de carga de rutas desde JSON');
+
+// Crear instancia del servidor
+const server = new JERK({
+  port: 6000,
+  host: 'localhost'
+});
+
+// Crear instancia del autenticador
+const authenticator = new Authenticator();
+
+// Registrar estrategias de autenticación que se usan en routes.json
+authenticator.use('apiKey', authenticator.apiKeyStrategy('X-API-Key', ['secret-key-123']));
+authenticator.use('jwt', authenticator.jwtStrategy('secret-jwt-key'));
+
+// Cargar rutas desde el archivo JSON
+const routeLoader = new RouteLoader();
+
+// Middleware de logging
+server.use((req, res, next) => {
+  logger.info(`${req.method} ${req.url} - IP: ${req.connection.remoteAddress}`);
+  next();
+});
+
+logger.info('Cargando rutas desde advanced/routes.json...');
+
+// Cargar las rutas desde el archivo JSON
+// Cambiamos temporalmente el directorio de trabajo para que las rutas relativas funcionen correctamente
+const originalCwd = process.cwd();
+process.chdir(__dirname); // Cambiar al directorio actual (examples)
+
+routeLoader.loadRoutes(server, './advanced/routes.json')
+  .then(routes => {
+    process.chdir(originalCwd); // Restaurar directorio original
+    
+    logger.info(`Cargadas ${routes.length} rutas desde el archivo JSON:`);
+    routes.forEach((route, index) => {
+      logger.info(`  ${index + 1}. ${route.method} ${route.path} -> ${route.controller}#${route.handler}`);
+    });
+    
+    logger.info('\nIniciando servidor en http://localhost:6000');
+    
+    // Iniciar el servidor
+    const httpServer = server.start();
+    
+    logger.info('\nENDPOINTS DISPONIBLES (cargados desde routes.json):');
+    logger.info('GET    /api/users                    - Obtener todos los usuarios (JWT req)');
+    logger.info('GET    /api/users/:id               - Obtener usuario por ID (JWT req)');
+    logger.info('POST   /api/users                    - Crear usuario (API Key req)');
+    logger.info('GET    /api/products                 - Obtener productos (sin auth)');
+    logger.info('PUT    /api/products/:id            - Actualizar producto (API Key req)');
+    
+    logger.info('\nEJEMPLOS DE USO:');
+    logger.info('# Obtener productos (sin autenticación):');
+    logger.info('curl -X GET http://localhost:6000/api/products');
+    
+    logger.info('\nEl servidor se detendrá automáticamente en 120 segundos...');
+    
+    // Programar apagado automático para la demostración
+    setTimeout(() => {
+      logger.info('Finalizando ejemplo...');
+      httpServer.close(() => {
+        logger.info('Servidor detenido. Ejemplo completado.');
+        console.log('\nEjemplo real completado exitosamente!');
+        console.log('El framework JERK ha demostrado su capacidad para:');
+        console.log('  - Cargar rutas dinámicamente desde archivos JSON');
+        console.log('  - Usar controladores definidos externamente');
+        console.log('  - Aplicar diferentes tipos de autenticación');
+        process.exit(0);
+      });
+    }, 120000);
+    
+  })
+  .catch(error => {
+    process.chdir(originalCwd); // Asegurarse de restaurar el directorio en caso de error
+    logger.error('Error cargando rutas:', error.message);
+    process.exit(1);
+  });
+
+// Mantener el proceso activo
+process.stdin.resume();

package/examples/basic/controllers/userController.js

@@ -0,0 +1,85 @@
+/**
+ * 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
+};

package/examples/basic_example.js

@@ -0,0 +1,72 @@
+/**
+ * Ejemplo basico de uso del framework JERK
+ * Este script demuestra cómo usar directamente los controladores
+ */
+
+const { JERK, Logger } = require('../index');
+const userController = require('./basic/controllers/userController');
+
+// Crear instancia del logger
+const logger = new Logger({ level: 'info', timestamp: true });
+
+logger.info('Iniciando ejemplo basico con controladores');
+
+// Crear instancia del servidor
+const server = new JERK({
+  port: 6001,
+  host: 'localhost'
+});
+
+// Middleware de logging
+server.use((req, res, next) => {
+  logger.info(`${req.method} ${req.url}`);
+  next();
+});
+
+// Usar los handlers directamente desde el controlador
+server.addRoute('GET', '/api/users', userController.getUsers);
+server.addRoute('GET', '/api/users/:id', userController.getUserById);
+server.addRoute('POST', '/api/users', userController.createUser);
+
+logger.info('Agregando rutas usando handlers del controlador userController');
+
+logger.info('\nIniciando servidor en http://localhost:6001');
+
+// Iniciar el servidor
+const httpServer = server.start();
+
+logger.info('\nENDPOINTS DISPONIBLES:');
+logger.info('GET    /api/users     - Obtener todos los usuarios');
+logger.info('GET    /api/users/:id - Obtener usuario por ID');
+logger.info('POST   /api/users     - Crear nuevo usuario');
+
+logger.info('\nEJEMPLOS DE USO:');
+logger.info('# Obtener todos los usuarios:');
+logger.info('curl -X GET http://localhost:6001/api/users');
+logger.info('');
+logger.info('# Obtener usuario por ID:');
+logger.info('curl -X GET http://localhost:6001/api/users/1');
+logger.info('');
+logger.info('# Crear nuevo usuario:');
+logger.info('curl -X POST -H "Content-Type: application/json" \\');
+logger.info('     -d \'{"name":"Juan Perez", "email":"juan@example.com"}\' \\');
+logger.info('     http://localhost:6001/api/users');
+
+logger.info('\nEl servidor se detendrá automáticamente en 60 segundos...');
+
+// Programar apagado automático para la demostración
+setTimeout(() => {
+  logger.info('Finalizando ejemplo basico...');
+  httpServer.close(() => {
+    logger.info('Servidor detenido. Ejemplo basico completado.');
+    console.log('\nEjemplo basico completado exitosamente!');
+    console.log('El framework JERK ha demostrado su capacidad para:');
+    console.log('  - Usar controladores directamente');
+    console.log('  - Manejar rutas parametrizadas');
+    console.log('  - Procesar solicitudes POST con cuerpo JSON');
+    process.exit(0);
+  });
+}, 60000);
+
+// Mantener el proceso activo
+process.stdin.resume();

package/examples/mvc_example/app.js

@@ -0,0 +1,138 @@
+/**
+ * Ejemplo de uso del sistema MVC para el framework JERK
+ * Demostración de vistas y controladores MVC
+ */
+
+const { APIServer, Router, ControllerBase } = require('../../index');
+
+// Crear un controlador personalizado que extienda ControllerBase
+class HomeController extends ControllerBase {
+  constructor(options = {}) {
+    super(options);
+  }
+
+  // Acción para mostrar la página de inicio
+  index(req, res) {
+    // Establecer variables para la vista
+    this.set('title', 'Página de Inicio');
+    this.set('message', '¡Bienvenido al framework JERK!');
+    this.set('users', [
+      { name: 'Juan', email: 'juan@example.com' },
+      { name: 'María', email: 'maria@example.com' },
+      { name: 'Pedro', email: 'pedro@example.com' }
+    ]);
+    
+    // Renderizar la vista
+    this.render(res, 'home/index', {
+      currentTime: new Date().toISOString()
+    });
+  }
+
+  // Acción para mostrar el perfil de un usuario
+  profile(req, res) {
+    // Obtener el ID del usuario de los parámetros
+    const userIdParam = this.input('id', '1');
+
+    // Validar que el ID sea un número entero positivo (no solo que empiece con un número)
+    if (!/^\d+$/.test(userIdParam) || parseInt(userIdParam) <= 0) {
+      // Si no es un ID válido, mostrar error
+      this.set('title', 'ID de usuario inválido');
+      this.render(res, 'user/invalid', {
+        userId: userIdParam
+      });
+      return;
+    }
+
+    const userId = parseInt(userIdParam);
+
+    // Array real de usuarios
+    const users = [
+      { id: 1, name: 'Ana García', email: 'ana@example.com', registered: '2026-01-01T10:00:00Z', active: true },
+      { id: 2, name: 'Carlos López', email: 'carlos@example.com', registered: '2026-01-02T11:30:00Z', active: false },
+      { id: 3, name: 'Laura Martínez', email: 'laura@example.com', registered: '2026-01-03T14:20:00Z', active: true },
+      { id: 4, name: 'Pedro Rodríguez', email: 'pedro@example.com', registered: '2026-01-04T09:15:00Z', active: true },
+      { id: 5, name: 'María Sánchez', email: 'maria@example.com', registered: '2026-01-05T16:45:00Z', active: false }
+    ];
+
+    // Buscar el usuario por ID
+    const user = users.find(u => u.id === userId);
+
+    if (!user) {
+      // Si no se encuentra el usuario, mostrar error
+      this.set('title', 'Usuario no encontrado');
+      this.render(res, 'user/notfound', {
+        userId: userId
+      });
+      return;
+    }
+
+    // Establecer variables para la vista
+    this.set('title', `Perfil de ${user.name}`);
+    this.set('user', user);
+
+    // Renderizar la vista de perfil
+    this.render(res, 'user/profile');
+  }
+
+  // Acción para mostrar la lista de usuarios
+  users(req, res) {
+    // Array real de usuarios (el mismo que en profile para consistencia)
+    const users = [
+      { id: 1, name: 'Ana García', email: 'ana@example.com', registered: '2026-01-01T10:00:00Z', active: true },
+      { id: 2, name: 'Carlos López', email: 'carlos@example.com', registered: '2026-01-02T11:30:00Z', active: false },
+      { id: 3, name: 'Laura Martínez', email: 'laura@example.com', registered: '2026-01-03T14:20:00Z', active: true },
+      { id: 4, name: 'Pedro Rodríguez', email: 'pedro@example.com', registered: '2026-01-04T09:15:00Z', active: true },
+      { id: 5, name: 'María Sánchez', email: 'maria@example.com', registered: '2026-01-05T16:45:00Z', active: false }
+    ];
+
+    // Establecer variables para la vista
+    this.set('title', 'Lista de Usuarios');
+    this.set('users', users);
+
+    // Renderizar la vista de usuarios
+    this.render(res, 'user/list');
+  }
+}
+
+// Crear instancia del servidor
+const server = new APIServer({
+  port: 9000,
+  host: 'localhost'
+});
+
+// Crear instancia del router
+const router = new Router();
+
+// Crear instancia del controlador
+const homeController = new HomeController({ viewsPath: './examples/mvc_example/views' });
+
+// Definir rutas
+router
+  .get('/', (req, res) => {
+    // Establecer la solicitud y respuesta en el controlador
+    homeController.setRequestResponse(req, res);
+    homeController.index(req, res);
+  })
+  .get('/profile', (req, res) => {
+    homeController.setRequestResponse(req, res);
+    homeController.profile(req, res);
+  })
+  .get('/users', (req, res) => {
+    homeController.setRequestResponse(req, res);
+    homeController.users(req, res);
+  });
+
+// Agregar las rutas del router al servidor
+const routes = router.getRoutes();
+for (const route of routes) {
+  server.addRoute(route.method, route.path, route.handler);
+}
+
+// Iniciar el servidor
+server.start(() => {
+  console.log('Servidor MVC iniciado en http://localhost:9000');
+  console.log('Rutas disponibles:');
+  console.log('- http://localhost:9000/ (Página de inicio)');
+  console.log('- http://localhost:9000/profile?id=1 (Perfil de usuario)');
+  console.log('- http://localhost:9000/users (Lista de usuarios)');
+});

package/examples/mvc_example/views/home/index.html

@@ -0,0 +1,26 @@
+<h1>{{title}}</h1>
+<p>{{message}}</p>
+
+<h2>Usuarios Registrados</h2>
+{{if users}}
+<table>
+    <thead>
+        <tr>
+            <th>Nombre</th>
+            <th>Email</th>
+        </tr>
+    </thead>
+    <tbody>
+        {{foreach:users}}
+        <tr>
+            <td>{{item.name}}</td>
+            <td>{{item.email}}</td>
+        </tr>
+        {{endforeach}}
+    </tbody>
+</table>
+{{else}}
+<p>No hay usuarios registrados.</p>
+{{endif}}
+
+<p>Hora actual: {{currentTime}}</p>

package/examples/mvc_example/views/home/simple.html

@@ -0,0 +1,3 @@
+<h1>{{title}}</h1>
+<p>{{message}}</p>
+<p>Hora actual: {{currentTime}}</p>

package/examples/mvc_example/views/layout.html

@@ -0,0 +1,23 @@
+<!DOCTYPE html>
+<html lang="es">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>{{title}}</title>
+    <style>
+        body { font-family: Arial, sans-serif; margin: 40px; background-color: #f5f5f5; }
+        .container { max-width: 800px; margin: 0 auto; background: white; padding: 20px; border-radius: 8px; box-shadow: 0 2px 10px rgba(0,0,0,0.1); }
+        h1 { color: #333; }
+        table { width: 100%; border-collapse: collapse; margin-top: 20px; }
+        th, td { padding: 10px; text-align: left; border-bottom: 1px solid #ddd; }
+        th { background-color: #f2f2f2; }
+        .active { color: green; }
+        .inactive { color: red; }
+    </style>
+</head>
+<body>
+    <div class="container">
+        {{content}}
+    </div>
+</body>
+</html>

package/examples/mvc_example/views/test.html

@@ -0,0 +1,3 @@
+<h1>{{title}}</h1>
+<p>{{message}}</p>
+<p>Prueba de variable simple: {{currentTime}}</p>

package/examples/mvc_example/views/user/invalid.html

@@ -0,0 +1,6 @@
+<h1>{{title}}</h1>
+
+<div>
+    <p>El ID proporcionado no es válido: {{userId}}</p>
+    <a href="/users">Volver a la lista de usuarios</a>
+</div>

package/examples/mvc_example/views/user/list.html

@@ -0,0 +1,36 @@
+<h1>{{title}}</h1>
+
+{{if users}}
+<table>
+    <thead>
+        <tr>
+            <th>ID</th>
+            <th>Nombre</th>
+            <th>Email</th>
+            <th>Estado</th>
+            <th>Acciones</th>
+        </tr>
+    </thead>
+    <tbody>
+        {{foreach:users}}
+        <tr>
+            <td>{{item.id}}</td>
+            <td>{{item.name}}</td>
+            <td>{{item.email}}</td>
+            <td>
+                {{if item.active}}
+                <span class="active">Activo</span>
+                {{else}}
+                <span class="inactive">Inactivo</span>
+                {{endif}}
+            </td>
+            <td><a href="/profile?id={{item.id}}">Ver Perfil</a></td>
+        </tr>
+        {{endforeach}}
+    </tbody>
+</table>
+{{else}}
+<p>No hay usuarios registrados.</p>
+{{endif}}
+
+<a href="/">Volver a la página de inicio</a>

package/examples/mvc_example/views/user/notfound.html

@@ -0,0 +1,6 @@
+<h1>{{title}}</h1>
+
+<div>
+    <p>No se encontró el usuario con ID: {{userId}}</p>
+    <a href="/users">Volver a la lista de usuarios</a>
+</div>

package/examples/mvc_example/views/user/profile.html

@@ -0,0 +1,11 @@
+<h1>{{title}}</h1>
+
+<div>
+    <h2>Información del Usuario</h2>
+    <p><strong>ID:</strong> {{user.id}}</p>
+    <p><strong>Nombre:</strong> {{user.name}}</p>
+    <p><strong>Email:</strong> {{user.email}}</p>
+    <p><strong>Registrado:</strong> {{user.registered}}</p>
+</div>
+
+<a href="/users">Volver a la lista de usuarios</a>

package/examples/mvc_routes_example/app.js

@@ -0,0 +1,34 @@
+/**
+ * Ejemplo de uso del sistema MVC con definición de rutas desde archivo JSON
+ * Demostración de vistas, helpers y filtros
+ */
+
+const { APIServer, RouteLoader, ControllerLoader, ViewEngine } = require('../../index');
+
+// Crear instancia del servidor
+const server = new APIServer({
+  port: 9001,
+  host: 'localhost'
+});
+
+// Crear instancia del cargador de rutas
+const routeLoader = new RouteLoader();
+
+// Cargar las rutas desde el archivo JSON
+routeLoader.loadRoutes(server, './examples/mvc_routes_example/routes.json')
+  .then(routes => {
+    console.log(`${routes.length} rutas cargadas exitosamente`);
+    console.log('Rutas disponibles:');
+    console.log('- http://localhost:9001/ (Página de inicio)');
+    console.log('- http://localhost:9001/users (Lista de usuarios)');
+    console.log('- http://localhost:9001/profile?id=1 (Perfil de usuario)');
+    console.log('- http://localhost:9001/products (Catálogo de productos)');
+    
+    // Iniciar el servidor
+    server.start(() => {
+      console.log('Servidor MVC con rutas JSON iniciado en http://localhost:9001');
+    });
+  })
+  .catch(error => {
+    console.error('Error al cargar las rutas:', error);
+  });

package/examples/mvc_routes_example/controllers/mainController.js

@@ -0,0 +1,27 @@
+const { ControllerBase } = require('../../../index');
+
+class MainController extends ControllerBase {
+  constructor(options = {}) {
+    super(options);
+  }
+
+  index(req, res) {
+    this.set('title', 'Inicio - Ejemplo MVC con Routes');
+    this.set('message', '¡Bienvenido al ejemplo de MVC con definición de rutas!');
+
+    this.render(res, 'main/index', {
+      currentTime: new Date().toISOString(),
+      version: '2.3.1'
+    });
+  }
+}
+
+// Exportar métodos directamente para que el RouteLoader pueda acceder a ellos
+const controllerInstance = new MainController({ viewsPath: './examples/mvc_routes_example/views' });
+
+module.exports = {
+  index: (req, res) => {
+    controllerInstance.setRequestResponse(req, res);
+    controllerInstance.index(req, res);
+  }
+};

package/examples/mvc_routes_example/controllers/productController.js

@@ -0,0 +1,47 @@
+const { ControllerBase } = require('../../../index');
+
+class ProductController extends ControllerBase {
+  constructor(options = {}) {
+    super(options);
+
+    // Registrar helpers personalizados para este controlador
+    this.getViewEngine().addHelper('calculateDiscount', (price, discountPercent) => {
+      return price - (price * discountPercent / 100);
+    });
+
+    this.getViewEngine().addHelper('formatCurrency', (value, symbol = '$') => {
+      return `${symbol}${Number(value).toFixed(2)}`;
+    });
+
+    this.getViewEngine().addHelper('isOnSale', (product) => {
+      return product.discount > 0;
+    });
+  }
+
+  catalog(req, res) {
+    const products = [
+      { id: 1, name: 'Laptop Pro', price: 1200, discount: 10, category: 'Electronics' },
+      { id: 2, name: 'Mouse Inalámbrico', price: 25, discount: 15, category: 'Accessories' },
+      { id: 3, name: 'Teclado Mecánico', price: 80, discount: 0, category: 'Accessories' },
+      { id: 4, name: 'Monitor 4K', price: 400, discount: 20, category: 'Electronics' },
+      { id: 5, name: 'Auriculares', price: 150, discount: 5, category: 'Audio' }
+    ];
+
+    this.set('title', 'Catálogo de Productos');
+    this.set('products', products);
+
+    this.render(res, 'product/catalog', {
+      currencySymbol: 'USD'
+    });
+  }
+}
+
+// Exportar métodos directamente para que el RouteLoader pueda acceder a ellos
+const controllerInstance = new ProductController({ viewsPath: './examples/mvc_routes_example/views' });
+
+module.exports = {
+  catalog: (req, res) => {
+    controllerInstance.setRequestResponse(req, res);
+    controllerInstance.catalog(req, res);
+  }
+};