jerkjs 2.1.1 → 2.1.2

package/examples/performance_demo_with_hooks/app.js

@@ -1,290 +0,0 @@
-const Jerk = require('../../index.js');
-const fs = require('fs');
-const path = require('path');
-
-// Función para verificar la disponibilidad del puerto
-const checkPortAvailability = async (port) => {
-  const net = require('net');
-  
-  return new Promise((resolve) => {
-    const server = net.createServer();
-    
-    server.listen(port, () => {
-      server.close(() => {
-        resolve(true); // Puerto disponible
-      });
-    });
-    
-    server.on('error', (err) => {
-      if (err.code === 'EADDRINUSE') {
-        resolve(false); // Puerto ocupado
-      } else {
-        resolve(false);
-      }
-    });
-  });
-};
-
-// Buscar un puerto disponible entre 3000 y 3100
-const findAvailablePort = async () => {
-  for (let port = 3000; port <= 3100; port++) {
-    const isAvailable = await checkPortAvailability(port);
-    if (isAvailable) {
-      return port;
-    }
-  }
-  throw new Error('No se encontró un puerto disponible entre 3000 y 3100');
-};
-
-// Función para obtener todas las rutas registradas
-const getAllRoutes = (app) => {
-  // Acceder a las rutas desde la instancia de Jerk
-  return app.routes || [];
-};
-
-// Crear instancia del servidor con configuraciones de rendimiento
-const createApp = async () => {
-  const availablePort = await findAvailablePort();
-  
-  const app = new Jerk({
-    port: availablePort,
-    host: 'localhost',
-    enableCompression: true, // Habilitar compresión
-    maxBodySize: '50mb', // Permitir bodies extensos
-    enableNestedRoutes: true // Habilitar rutas anidadas
-  });
-
-  // Middleware de compresión
-  app.use(require('../../lib/middleware/compressor')());
-
-  // Hook para registrar las rutas después de definirlas
-  const routesInfo = [];
-
-  // Sobreescribir métodos para capturar rutas
-  const originalGet = app.get;
-  const originalPost = app.post;
-  const originalPut = app.put;
-  const originalDelete = app.delete;
-
-  app.get = function(path, handler) {
-    routesInfo.push({ method: 'GET', path, description: 'Ruta registrada' });
-    return originalGet.call(this, path, handler);
-  };
-
-  app.post = function(path, handler) {
-    routesInfo.push({ method: 'POST', path, description: 'Ruta registrada' });
-    return originalPost.call(this, path, handler);
-  };
-
-  app.put = function(path, handler) {
-    routesInfo.push({ method: 'PUT', path, description: 'Ruta registrada' });
-    return originalPut.call(this, path, handler);
-  };
-
-  app.delete = function(path, handler) {
-    routesInfo.push({ method: 'DELETE', path, description: 'Ruta registrada' });
-    return originalDelete.call(this, path, handler);
-  };
-
-  // Ruta para probar compresión con respuesta grande
-  app.get('/api/compression-test', (req, res) => {
-    // Generar una respuesta grande para demostrar compresión
-    const largeData = {
-      message: 'Esta es una respuesta grande para demostrar compresión',
-      data: Array.from({ length: 1000 }, (_, i) => ({
-        id: i,
-        title: `Item ${i}`,
-        description: `Este es un elemento de prueba número ${i} con información detallada`,
-        metadata: {
-          created: new Date().toISOString(),
-          category: `categoria-${i % 10}`,
-          tags: [`tag${i % 5}`, `etiqueta${i % 7}`]
-        }
-      }))
-    };
-
-    res.json(largeData);
-  });
-
-  // Ruta para probar bodies extensos
-  app.post('/api/large-body', (req, res) => {
-    const bodySize = JSON.stringify(req.body).length;
-    
-    res.json({
-      message: 'Body recibido exitosamente',
-      size: bodySize,
-      status: 'success'
-    });
-  });
-
-  // Rutas anidadas para demostrar jerarquía
-  app.get('/api/users/:userId/posts', (req, res) => {
-    const { userId } = req.params;
-    
-    res.json({
-      message: `Posts del usuario ${userId}`,
-      posts: Array.from({ length: 5 }, (_, i) => ({
-        id: i + 1,
-        title: `Post ${i + 1} de usuario ${userId}`,
-        content: 'Contenido del post...'
-      }))
-    });
-  });
-
-  app.get('/api/users/:userId/posts/:postId/comments', (req, res) => {
-    const { userId, postId } = req.params;
-    
-    res.json({
-      message: `Comentarios del post ${postId} del usuario ${userId}`,
-      comments: Array.from({ length: 3 }, (_, i) => ({
-        id: i + 1,
-        author: `Usuario${i + 1}`,
-        content: `Comentario ${i + 1} en el post ${postId}`
-      }))
-    });
-  });
-
-  // Ruta para probar diferentes tipos de payloads grandes
-  app.post('/api/upload-large-data', (req, res) => {
-    const { dataType, dataSize } = req.body || {};
-    
-    let response;
-    switch(dataType) {
-      case 'text':
-        response = {
-          type: 'text',
-          content: 'x'.repeat(dataSize || 10000),
-          message: 'Texto largo generado para pruebas de compresión'
-        };
-        break;
-      case 'json':
-        response = {
-          type: 'json',
-          data: Array.from({ length: dataSize || 1000 }, (_, i) => ({
-            id: i,
-            value: Math.random(),
-            label: `Elemento ${i}`
-          })),
-          message: 'JSON grande generado para pruebas de compresión'
-        };
-        break;
-      default:
-        response = {
-          type: 'default',
-          message: 'Tipo de dato no especificado, usando valores por defecto',
-          sample: Array(100).fill().map((_, i) => `dato_${i}`)
-        };
-    }
-    
-    res.json(response);
-  });
-
-  // Endpoint para medir tiempo de respuesta
-  app.get('/api/performance-test', (req, res) => {
-    const startTime = Date.now();
-    
-    // Simular procesamiento intensivo
-    const processData = () => {
-      return Array.from({ length: 50000 }, (_, i) => ({
-        id: i,
-        computedValue: Math.sqrt(i) * Math.sin(i),
-        timestamp: Date.now()
-      }));
-    };
-    
-    const processedData = processData();
-    const endTime = Date.now();
-    
-    res.json({
-      message: 'Prueba de rendimiento completada',
-      processingTime: endTime - startTime,
-      dataSize: processedData.length,
-      status: 'success'
-    });
-  });
-
-  // Ruta para mostrar todas las rutas disponibles usando hooks
-  app.get('/routes', (req, res) => {
-    const routesHtml = `
-      <html>
-        <head>
-          <title>Rutas Disponibles - Demo de Rendimiento</title>
-          <style>
-            body { font-family: Arial, sans-serif; margin: 40px; }
-            table { border-collapse: collapse; width: 100%; }
-            th, td { border: 1px solid #ddd; padding: 12px; text-align: left; }
-            th { background-color: #f2f2f2; }
-            .method-get { color: green; }
-            .method-post { color: orange; }
-            .method-put { color: blue; }
-            .method-delete { color: red; }
-          </style>
-        </head>
-        <body>
-          <h1>Rutas Disponibles - Demo de Rendimiento</h1>
-          <p>Puerto: ${availablePort}</p>
-          <table>
-            <tr>
-              <th>Método</th>
-              <th>Ruta</th>
-              <th>Descripción</th>
-            </tr>
-            ${routesInfo.map(route => `
-              <tr>
-                <td class="method-${route.method.toLowerCase()}">${route.method}</td>
-                <td>${route.path}</td>
-                <td>${route.description}</td>
-              </tr>
-            `).join('')}
-          </table>
-          <br>
-          <a href="/">← Volver a la página principal</a>
-        </body>
-      </html>
-    `;
-    
-    res.send(routesHtml);
-  });
-
-  // Ruta raíz para instrucciones
-  app.get('/', (req, res) => {
-    res.send(`
-      <html>
-        <head><title>Demo de Rendimiento - JERK Framework</title></head>
-        <body>
-          <h1>Demo de Rendimiento - JERK Framework</h1>
-          <p>Puerto: ${availablePort}</p>
-          <p>Esta demostración muestra las capacidades de rendimiento del framework:</p>
-          <ul>
-            <li><strong>Compresión</strong>: <a href="/api/compression-test">/api/compression-test</a> - Respuesta grande comprimida</li>
-            <li><strong>Body Extensos</strong>: POST a <code>/api/large-body</code> con grandes cantidades de datos</li>
-            <li><strong>Rutas Anidadas</strong>: 
-              <ul>
-                <li><a href="/api/users/123/posts">/api/users/:userId/posts</a></li>
-                <li><a href="/api/users/123/posts/456/comments">/api/users/:userId/posts/:postId/comments</a></li>
-              </ul>
-            </li>
-            <li><strong>Upload de Datos Grandes</strong>: POST a <code>/api/upload-large-data</code> con diferentes tipos de datos</li>
-            <li><strong>Prueba de Rendimiento</strong>: <a href="/api/performance-test">/api/performance-test</a> - Medición de tiempo de procesamiento</li>
-          </ul>
-          <p>Para ver todas las rutas disponibles: <a href="/routes">/routes</a></p>
-          <p>Para probar bodies extensos, usa curl o Postman para hacer POST requests a los endpoints correspondientes.</p>
-        </body>
-      </html>
-    `);
-  });
-
-  // Iniciar el servidor
-  app.listen(() => {
-    console.log(`Demo de rendimiento iniciado en http://localhost:${availablePort}`);
-    console.log('Puerto asignado automáticamente para evitar conflictos');
-    console.log('Visita http://localhost:' + availablePort + '/routes para ver todas las rutas disponibles');
-  });
-
-  return app;
-};
-
-// Ejecutar la aplicación
-createApp().catch(console.error);
-
-module.exports = createApp;

package/examples/public/README.md

@@ -1,92 +0,0 @@
-# API Pública de Ejemplo
-
-Este ejemplo demuestra cómo crear una API pública usando el Framework JERK JS. La API incluye endpoints para gestionar usuarios y está protegida con CORS y rate limiting.
-
-## Características
-
-- API REST pública sin autenticación requerida
-- Endpoints para gestión de usuarios (CRUD completo)
-- Protección con CORS para permitir solicitudes desde cualquier origen
-- Rate limiting para prevenir abusos
-- Endpoints de salud del sistema
-- Controladores organizados por funcionalidad
-
-## Configuración
-
-1. Asegúrate de tener instaladas las dependencias del framework JERK
-2. No se requiere configuración adicional para esta API pública
-
-## Uso
-
-1. Inicia el servidor:
-   ```bash
-   node app.js
-   ```
-
-2. El servidor escuchará en `http://localhost:8081`
-
-## Endpoints
-
-- `GET /` - Información general de la API (público)
-- `GET /users` - Lista todos los usuarios (público)
-- `GET /users/:id` - Obtiene un usuario específico (público)
-- `POST /users` - Crea un nuevo usuario (público)
-- `PUT /users/:id` - Actualiza un usuario existente (público)
-- `DELETE /users/:id` - Elimina un usuario (público)
-- `GET /health` - Verifica el estado del servicio (público)
-
-## Ejemplos de uso
-
-1. Obtener todos los usuarios:
-   ```bash
-   curl -X GET http://localhost:8081/users
-   ```
-
-2. Obtener un usuario específico:
-   ```bash
-   curl -X GET http://localhost:8081/users/1
-   ```
-
-3. Crear un nuevo usuario:
-   ```bash
-   curl -X POST http://localhost:8081/users \
-     -H "Content-Type: application/json" \
-     -d '{"name": "Nuevo Usuario", "email": "nuevo@ejemplo.com", "age": 28}'
-   ```
-
-4. Actualizar un usuario:
-   ```bash
-   curl -X PUT http://localhost:8081/users/1 \
-     -H "Content-Type: application/json" \
-     -d '{"name": "Usuario Actualizado", "email": "actualizado@ejemplo.com"}'
-   ```
-
-5. Eliminar un usuario:
-   ```bash
-   curl -X DELETE http://localhost:8081/users/1
-   ```
-
-6. Verificar estado del servicio:
-   ```bash
-   curl -X GET http://localhost:8081/health
-   ```
-
-## Estructura del proyecto
-
-```
-examples/public/
-├── app.js              # Punto de entrada de la aplicación
-├── routes.json         # Definición de rutas
-├── controllers/        # Controladores de las rutas
-│   ├── mainController.js
-│   ├── userController.js
-│   └── healthController.js
-└── README.md
-```
-
-## Seguridad
-
-- CORS configurado para permitir solicitudes desde cualquier origen
-- Rate limiting configurado para prevenir abusos (100 solicitudes por 15 minutos)
-- No se requiere autenticación para acceder a los endpoints
-- Validación de entrada en endpoints de creación/actualización

package/examples/public/app.js

@@ -1,72 +0,0 @@
-const {
-  APIServer,
-  Router,
-  RouteLoader,
-  Logger,
-  Cors,
-  RateLimiter
-} = require('../../index.js');
-
-async function startServer() {
-  // Crear instancia del servidor
-  const server = new APIServer({
-    port: 8081,
-    host: 'localhost',
-    requestTimeout: 30000, // 30 segundos
-    connectionTimeout: 30000 // 30 segundos
-  });
-
-  // Crear instancia del logger
-  const logger = new Logger({ level: 'info' });
-
-  try {
-    // Configurar CORS para permitir solicitudes desde cualquier origen
-    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());
-
-    // Configurar Rate Limiter para prevenir abusos
-    const rateLimiter = new RateLimiter({
-      windowMs: 15 * 60 * 1000, // 15 minutos
-      maxRequests: 100 // Límite de 100 solicitudes por ventana
-    });
-
-    // Aplicar middleware de rate limiting
-    server.use(rateLimiter.middleware());
-
-    // Cargar rutas desde archivo JSON
-    const routeLoader = new RouteLoader();
-    await routeLoader.loadRoutes(server, './routes.json');
-
-    // Iniciar el servidor
-    server.start();
-
-    logger.info('Servidor público iniciado en http://localhost:8081');
-    logger.info('Endpoints disponibles:');
-    logger.info('- GET / (Información del API)');
-    logger.info('- GET /users (Lista de usuarios)');
-    logger.info('- GET /users/:id (Obtener usuario específico)');
-    logger.info('- POST /users (Crear nuevo usuario)');
-    logger.info('- PUT /users/:id (Actualizar usuario)');
-    logger.info('- DELETE /users/:id (Eliminar usuario)');
-  } catch (error) {
-    logger.error('Error iniciando el servidor:', error.message);
-    process.exit(1);
-  }
-}
-
-// Iniciar el servidor
-startServer();
-
-module.exports = { startServer };

package/examples/public/controllers/healthController.js

@@ -1,20 +0,0 @@
-const healthController = {
-  checkHealth: (req, res) => {
-    const healthStatus = {
-      status: 'healthy',
-      timestamp: new Date().toISOString(),
-      uptime: process.uptime(),
-      message: 'API Pública de Ejemplo está operando correctamente',
-      version: '1.0.0',
-      endpoints: {
-        total: 7,
-        active: true
-      }
-    };
-
-    res.writeHead(200, { 'Content-Type': 'application/json' });
-    res.end(JSON.stringify(healthStatus));
-  }
-};
-
-module.exports = healthController;

package/examples/public/controllers/mainController.js

@@ -1,22 +0,0 @@
-const mainController = {
-  home: (req, res) => {
-    res.writeHead(200, { 'Content-Type': 'application/json' });
-    res.end(JSON.stringify({
-      message: 'Bienvenido a la API Pública de Ejemplo',
-      version: '1.0.0',
-      description: 'Esta es una API pública de ejemplo creada con el Framework JERK JS',
-      endpoints: {
-        'GET /': 'Este mensaje',
-        'GET /users': 'Obtener lista de usuarios',
-        'GET /users/:id': 'Obtener usuario específico',
-        'POST /users': 'Crear nuevo usuario',
-        'PUT /users/:id': 'Actualizar usuario',
-        'DELETE /users/:id': 'Eliminar usuario',
-        'GET /health': 'Verificar estado del servicio'
-      },
-      documentation: 'Visita el README para más información sobre cómo usar esta API'
-    }));
-  }
-};
-
-module.exports = mainController;

package/examples/public/controllers/userController.js

@@ -1,139 +0,0 @@
-// Simulación de base de datos en memoria
-let 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 }
-];
-
-let nextId = 4;
-
-const userController = {
-  getAllUsers: (req, res) => {
-    res.writeHead(200, { 'Content-Type': 'application/json' });
-    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, { 'Content-Type': 'application/json' });
-      res.end(JSON.stringify({
-        success: false,
-        error: 'Usuario no encontrado'
-      }));
-      return;
-    }
-
-    res.writeHead(200, { 'Content-Type': 'application/json' });
-    res.end(JSON.stringify({
-      success: true,
-      data: user
-    }));
-  },
-
-  createUser: (req, res) => {
-    try {
-      const { name, email, age } = req.body;
-
-      // Validación simple
-      if (!name || !email) {
-        res.writeHead(400, { 'Content-Type': 'application/json' });
-        res.end(JSON.stringify({
-          success: false,
-          error: 'Nombre y correo electrónico son obligatorios'
-        }));
-        return;
-      }
-
-      // Crear nuevo usuario
-      const newUser = {
-        id: nextId++,
-        name,
-        email,
-        age: age || null
-      };
-
-      users.push(newUser);
-
-      res.writeHead(201, { 'Content-Type': 'application/json' });
-      res.end(JSON.stringify({
-        success: true,
-        data: newUser,
-        message: 'Usuario creado exitosamente'
-      }));
-    } catch (error) {
-      res.writeHead(500, { 'Content-Type': 'application/json' });
-      res.end(JSON.stringify({
-        success: false,
-        error: 'Error interno del servidor'
-      }));
-    }
-  },
-
-  updateUser: (req, res) => {
-    try {
-      const userId = parseInt(req.params.id);
-      const { name, email, age } = req.body;
-
-      const userIndex = users.findIndex(u => u.id === userId);
-
-      if (userIndex === -1) {
-        res.writeHead(404, { 'Content-Type': 'application/json' });
-        res.end(JSON.stringify({
-          success: false,
-          error: 'Usuario no encontrado'
-        }));
-        return;
-      }
-
-      // Actualizar usuario
-      if (name) users[userIndex].name = name;
-      if (email) users[userIndex].email = email;
-      if (age !== undefined) users[userIndex].age = age;
-
-      res.writeHead(200, { 'Content-Type': 'application/json' });
-      res.end(JSON.stringify({
-        success: true,
-        data: users[userIndex],
-        message: 'Usuario actualizado exitosamente'
-      }));
-    } catch (error) {
-      res.writeHead(500, { 'Content-Type': 'application/json' });
-      res.end(JSON.stringify({
-        success: false,
-        error: 'Error interno del servidor'
-      }));
-    }
-  },
-
-  deleteUser: (req, res) => {
-    const userId = parseInt(req.params.id);
-    const userIndex = users.findIndex(u => u.id === userId);
-
-    if (userIndex === -1) {
-      res.writeHead(404, { 'Content-Type': 'application/json' });
-      res.end(JSON.stringify({
-        success: false,
-        error: 'Usuario no encontrado'
-      }));
-      return;
-    }
-
-    const deletedUser = users.splice(userIndex, 1)[0];
-
-    res.writeHead(200, { 'Content-Type': 'application/json' });
-    res.end(JSON.stringify({
-      success: true,
-      data: deletedUser,
-      message: 'Usuario eliminado exitosamente'
-    }));
-  }
-};
-
-module.exports = userController;

package/examples/public/routes.json

@@ -1,51 +0,0 @@
-[
-  {
-    "path": "/",
-    "method": "GET",
-    "controller": "./controllers/mainController.js",
-    "handler": "home",
-    "auth": "none"
-  },
-  {
-    "path": "/users",
-    "method": "GET",
-    "controller": "./controllers/userController.js",
-    "handler": "getAllUsers",
-    "auth": "none"
-  },
-  {
-    "path": "/users/:id",
-    "method": "GET",
-    "controller": "./controllers/userController.js",
-    "handler": "getUserById",
-    "auth": "none"
-  },
-  {
-    "path": "/users",
-    "method": "POST",
-    "controller": "./controllers/userController.js",
-    "handler": "createUser",
-    "auth": "none"
-  },
-  {
-    "path": "/users/:id",
-    "method": "PUT",
-    "controller": "./controllers/userController.js",
-    "handler": "updateUser",
-    "auth": "none"
-  },
-  {
-    "path": "/users/:id",
-    "method": "DELETE",
-    "controller": "./controllers/userController.js",
-    "handler": "deleteUser",
-    "auth": "none"
-  },
-  {
-    "path": "/health",
-    "method": "GET",
-    "controller": "./controllers/healthController.js",
-    "handler": "checkHealth",
-    "auth": "none"
-  }
-]