jerkjs 2.1.1 → 2.1.2

package/examples/advanced/routes.json

@@ -1,51 +0,0 @@
-[
-  {
-    "path": "/api/users",
-    "method": "GET",
-    "auth": "jwt",
-    "authOptions": {
-      "jwtSecret": "secret-jwt-key"
-    },
-    "controller": "./basic/controllers/userController.js",
-    "handler": "getUsers"
-  },
-  {
-    "path": "/api/users/:id",
-    "method": "GET",
-    "auth": "jwt",
-    "authOptions": {
-      "jwtSecret": "secret-jwt-key"
-    },
-    "controller": "./basic/controllers/userController.js",
-    "handler": "getUserById"
-  },
-  {
-    "path": "/api/users",
-    "method": "POST",
-    "auth": "apiKey",
-    "authOptions": {
-      "apiKeyHeader": "X-API-Key",
-      "apiKeyValues": ["secret-key-123"]
-    },
-    "controller": "./basic/controllers/userController.js",
-    "handler": "createUser"
-  },
-  {
-    "path": "/api/products",
-    "method": "GET",
-    "auth": "none",
-    "controller": "./advanced/controllers/productController.js",
-    "handler": "getProducts"
-  },
-  {
-    "path": "/api/products/:id",
-    "method": "PUT",
-    "auth": "apiKey",
-    "authOptions": {
-      "apiKeyHeader": "X-API-Key",
-      "apiKeyValues": ["secret-key-123"]
-    },
-    "controller": "./advanced/controllers/productController.js",
-    "handler": "updateProduct"
-  }
-]

package/examples/advanced_example.js

@@ -1,93 +0,0 @@
-/**
- * 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

@@ -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
-};

package/examples/basic_example.js

@@ -1,72 +0,0 @@
-/**
- * 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/frontend/README.md

@@ -1,71 +0,0 @@
-# Ejemplo Frontend con JERK JS
-
-Este ejemplo demuestra cómo el Framework JERK 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 JERK
-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

@@ -1,71 +0,0 @@
-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

@@ -1,39 +0,0 @@
-// 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;