jerkjs 2.0.0

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 API SDK
+ * Este script demuestra cómo usar directamente los controladores
+ */
+
+const { APISDK, 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 APISDK({
+  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 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/frontend/README.md

@@ -0,0 +1,71 @@
+# Ejemplo Frontend con API SDK JS
+
+Este ejemplo demuestra cómo el Framework API SDK JS puede utilizarse para servir tanto APIs como contenido HTML para frontends, gracias a la nueva funcionalidad de especificación de content-type en el archivo routes.json.
+
+## Características
+
+- API REST y páginas HTML en el mismo servidor
+- Especificación de content-type en routes.json
+- Soporte para diferentes tipos de contenido (HTML, CSS, JavaScript, JSON)
+- Frontend completamente funcional con estilos y scripts
+- Navegación entre páginas HTML
+
+## Configuración
+
+1. Asegúrate de tener instaladas las dependencias del framework API SDK
+2. No se requiere configuración adicional para este ejemplo
+
+## Uso
+
+1. Inicia el servidor:
+   ```bash
+   node app.js
+   ```
+
+2. El servidor escuchará en `http://localhost:8082`
+
+## Endpoints
+
+- `GET /` - Página de inicio HTML
+- `GET /about` - Página Acerca de HTML
+- `GET /contact` - Formulario de contacto HTML
+- `GET /api/users` - API JSON de usuarios
+- `GET /api/users/:id` - API JSON de usuario específico
+- `GET /styles.css` - Archivo CSS
+- `GET /script.js` - Archivo JavaScript
+
+## Nueva funcionalidad: Content-Type en routes.json
+
+Este ejemplo demuestra la nueva funcionalidad que permite especificar el content-type directamente en el archivo routes.json:
+
+```json
+{
+  "path": "/",
+  "method": "GET",
+  "controller": "./controllers/pageController.js",
+  "handler": "homePage",
+  "auth": "none",
+  "contentType": "text/html"
+}
+```
+
+El campo `contentType` permite especificar el header Content-Type que se enviará con la respuesta, lo que permite servir diferentes tipos de contenido desde el mismo servidor.
+
+## Estructura del proyecto
+
+```
+examples/frontend/
+├── app.js              # Punto de entrada de la aplicación
+├── routes.json         # Definición de rutas con content-type
+├── controllers/        # Controladores de las rutas
+│   ├── pageController.js   # Controladores para páginas HTML
+│   ├── apiController.js    # Controladores para endpoints API
+│   └── staticController.js # Controladores para recursos estáticos
+└── README.md
+```
+
+## Seguridad
+
+- CORS configurado para permitir solicitudes desde navegadores
+- No se requiere autenticación para acceder a los endpoints
+- El framework incluye protección WAF por defecto

package/examples/frontend/app.js

@@ -0,0 +1,71 @@
+const {
+  APIServer,
+  RouteLoader,
+  Logger,
+  Cors,
+  SessionManager
+} = require('../../index.js');
+
+async function startServer() {
+  // Crear instancia del servidor
+  const server = new APIServer({
+    port: 8082,
+    host: 'localhost'
+  });
+
+  // Crear instancia del logger
+  const logger = new Logger({ level: 'info' });
+
+  try {
+    // Crear instancia del administrador de sesiones
+    const sessionManager = new SessionManager({
+      cookieName: 'frontend_session',
+      secret: 'frontend-session-secret-change-in-production',
+      timeout: 3600000 // 1 hora
+    });
+
+    // Aplicar middleware de sesión
+    server.use(sessionManager.middleware());
+
+    // Hacer que sessionManager esté disponible en el servidor para el RouteLoader
+    server.sessionManager = sessionManager;
+
+    // Configurar CORS para permitir solicitudes desde navegadores
+    const cors = new Cors({
+      origin: '*',
+      methods: ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS'],
+      allowedHeaders: [
+        'Content-Type',
+        'Authorization',
+        'X-Requested-With',
+        'Accept',
+        'Origin'
+      ]
+    });
+
+    // Aplicar middleware de CORS
+    server.use(cors.middleware());
+
+    // Cargar rutas desde archivo JSON
+    const routeLoader = new RouteLoader();
+    await routeLoader.loadRoutes(server, './routes.json');
+
+    // Iniciar el servidor
+    server.start();
+
+    logger.info('Servidor frontend iniciado en http://localhost:8082');
+    logger.info('Endpoints disponibles:');
+    logger.info('- GET / (Página de inicio HTML)');
+    logger.info('- GET /about (Página Acerca de HTML)');
+    logger.info('- GET /api/users (API JSON)');
+    logger.info('- GET /contact (Formulario de contacto HTML)');
+  } catch (error) {
+    logger.error('Error iniciando el servidor:', error.message);
+    process.exit(1);
+  }
+}
+
+// Iniciar el servidor
+startServer();
+
+module.exports = { startServer };

package/examples/frontend/controllers/apiController.js

@@ -0,0 +1,39 @@
+// Simulación de base de datos en memoria
+const users = [
+  { id: 1, name: 'Juan Pérez', email: 'juan@example.com', age: 30 },
+  { id: 2, name: 'María García', email: 'maria@example.com', age: 25 },
+  { id: 3, name: 'Pedro Rodríguez', email: 'pedro@example.com', age: 35 }
+];
+
+const apiController = {
+  getUsers: (req, res) => {
+    res.writeHead(200);
+    res.end(JSON.stringify({
+      success: true,
+      data: users,
+      count: users.length
+    }));
+  },
+
+  getUserById: (req, res) => {
+    const userId = parseInt(req.params.id);
+    const user = users.find(u => u.id === userId);
+
+    if (!user) {
+      res.writeHead(404);
+      res.end(JSON.stringify({
+        success: false,
+        error: 'Usuario no encontrado'
+      }));
+      return;
+    }
+
+    res.writeHead(200);
+    res.end(JSON.stringify({
+      success: true,
+      data: user
+    }));
+  }
+};
+
+module.exports = apiController;

package/examples/frontend/controllers/authController.js

@@ -0,0 +1,220 @@
+const messageController = require('./messageController');
+
+const authController = {
+  // Mostrar formulario de login
+  showLoginPage: (req, res) => {
+    const html = `
+<!DOCTYPE html>
+<html lang="es">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Login - API Frontend Demo</title>
+    <link rel="stylesheet" href="/styles.css">
+</head>
+<body>
+    <div class="container">
+        <header>
+            <h1>Área de Administración</h1>
+            <nav>
+                <ul>
+                    <li><a href="/">Inicio</a></li>
+                    <li><a href="/about">Acerca de</a></li>
+                    <li><a href="/contact">Contacto</a></li>
+                    <li><a href="/login">Login</a></li>
+                    <li><a href="/api/users">Usuarios (API)</a></li>
+                </ul>
+            </nav>
+        </header>
+        
+        <main>
+            <section class="login-section">
+                <h2>Iniciar Sesión</h2>
+                <form id="loginForm">
+                    <div class="form-group">
+                        <label for="username">Usuario:</label>
+                        <input type="text" id="username" name="username" required>
+                    </div>
+                    
+                    <div class="form-group">
+                        <label for="password">Contraseña:</label>
+                        <input type="password" id="password" name="password" required>
+                    </div>
+                    
+                    <button type="submit">Ingresar</button>
+                </form>
+                
+                <div id="login-response"></div>
+                
+                <p><em>Usuario: admin | Contraseña: password123</em></p>
+            </section>
+        </main>
+        
+        <footer>
+            <p>&copy; 2026 API SDK JS Framework</p>
+        </footer>
+    </div>
+    <script src="/script.js"></script>
+    <script>
+        document.addEventListener('DOMContentLoaded', function() {
+            const loginForm = document.getElementById('loginForm');
+            
+            if (loginForm) {
+                loginForm.addEventListener('submit', function(e) {
+                    e.preventDefault();
+                    
+                    const formData = new FormData(loginForm);
+                    const data = Object.fromEntries(formData);
+                    
+                    fetch('/api/login', {
+                        method: 'POST',
+                        headers: {
+                            'Content-Type': 'application/json'
+                        },
+                        body: JSON.stringify(data)
+                    })
+                    .then(response => response.json())
+                    .then(result => {
+                        const responseDiv = document.getElementById('login-response');
+                        
+                        if (result.success) {
+                            responseDiv.innerHTML = '<p style="color: green;">Inicio de sesión exitoso. Redirigiendo...</p>';
+                            
+                            // Redirigir después de un breve delay
+                            setTimeout(() => {
+                                window.location.href = '/messages';
+                            }, 1500);
+                        } else {
+                            responseDiv.innerHTML = '<p style="color: red;">' + result.message + '</p>';
+                        }
+                    })
+                    .catch(error => {
+                        console.error('Error:', error);
+                        const responseDiv = document.getElementById('login-response');
+                        responseDiv.innerHTML = '<p style="color: red;">Error de conexión</p>';
+                    });
+                });
+            }
+        });
+    </script>
+</body>
+</html>`;
+    
+    res.writeHead(200);
+    res.end(html);
+  },
+
+  // Procesar login
+  processLogin: async (req, res) => {
+    try {
+      // req.body puede ser un string o un objeto, dependiendo de cómo se haya procesado
+      let body;
+      if (typeof req.body === 'string') {
+        body = JSON.parse(req.body);
+      } else {
+        body = req.body;
+      }
+
+      const { username, password } = body;
+
+      // Validar credenciales
+      const user = await messageController.validateUser(username, password);
+
+      if (user) {
+        // Crear sesión de usuario autenticado
+        if (req.session) {
+          req.session.create({
+            authenticated: true,
+            userId: user.id,
+            username: user.username
+          });
+        }
+
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({
+          success: true,
+          message: 'Inicio de sesión exitoso',
+          userId: user.id
+        }));
+      } else {
+        res.writeHead(401, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({
+          success: false,
+          message: 'Credenciales inválidas'
+        }));
+      }
+    } catch (error) {
+      console.error('Error en login:', error);
+      res.writeHead(500, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify({
+        success: false,
+        message: 'Error interno del servidor'
+      }));
+    }
+  },
+
+  // Mostrar mensajes (requiere estar logueado - en este ejemplo simplificado no verificamos sesión)
+  showMessages: async (req, res) => {
+    try {
+      // Obtener mensajes de la base de datos
+      const messages = await messageController.getMessages();
+      
+      const messagesHtml = messages.length > 0 
+        ? messages.map(msg => `
+            <div class="message-item">
+                <h4>${msg.name} (${msg.email})</h4>
+                <p>${msg.message}</p>
+                <small>Fecha: ${msg.created_at}</small>
+            </div>
+          `).join('')
+        : '<p>No hay mensajes aún.</p>';
+
+      const html = `
+<!DOCTYPE html>
+<html lang="es">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Mensajes - API Frontend Demo</title>
+    <link rel="stylesheet" href="/styles.css">
+</head>
+<body>
+    <div class="container">
+        <header>
+            <h1>Mensajes Recibidos</h1>
+            <nav>
+                <ul>
+                    <li><a href="/">Inicio</a></li>
+                    <li><a href="/about">Acerca de</a></li>
+                    <li><a href="/contact">Contacto</a></li>
+                    <li><a href="/login">Login</a></li>
+                    <li><a href="/api/users">Usuarios (API)</a></li>
+                </ul>
+            </nav>
+        </header>
+        
+        <main>
+            <section class="messages-section">
+                ${messagesHtml}
+            </section>
+        </main>
+        
+        <footer>
+            <p>&copy; 2026 API SDK JS Framework</p>
+        </footer>
+    </div>
+    <script src="/script.js"></script>
+</body>
+</html>`;
+    
+      res.writeHead(200);
+      res.end(html);
+    } catch (error) {
+      console.error('Error obteniendo mensajes:', error);
+      res.writeHead(500);
+      res.end('<h1>Error obteniendo mensajes</h1>');
+    }
+  }
+};
+
+module.exports = authController;

package/examples/frontend/controllers/formController.js

@@ -0,0 +1,47 @@
+const messageController = require('./messageController');
+
+const formController = {
+  // Procesar el envío del formulario de contacto
+  processContactForm: async (req, res) => {
+    try {
+      // req.body puede ser un string o un objeto, dependiendo de cómo se haya procesado
+      let body;
+      if (typeof req.body === 'string') {
+        body = JSON.parse(req.body);
+      } else {
+        body = req.body;
+      }
+
+      const { name, email, message } = body;
+
+      // Validar campos
+      if (!name || !email || !message) {
+        res.writeHead(400, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({
+          success: false,
+          message: 'Todos los campos son obligatorios'
+        }));
+        return;
+      }
+
+      // Guardar el mensaje en la base de datos
+      await messageController.saveMessage(name, email, message);
+
+      // Responder con éxito
+      res.writeHead(200, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify({
+        success: true,
+        message: 'Mensaje enviado exitosamente'
+      }));
+    } catch (error) {
+      console.error('Error procesando formulario:', error);
+      res.writeHead(500, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify({
+        success: false,
+        message: 'Error interno del servidor'
+      }));
+    }
+  }
+};
+
+module.exports = formController;