jerkjs 2.5.8 → 2.6.1

package/RESULTADOS_WAF.md

@@ -0,0 +1,63 @@
+# Demostración del Módulo WAF - Resultados Finales
+
+## ✅ Funcionalidades del Módulo WAF Verificadas
+
+1. **Creación de Reglas**: ✅
+   - Comando `create-x-rule` funciona correctamente
+   - Proceso interactivo paso a paso para crear reglas
+   - Selecciona header, patrón, acción y razón
+
+2. **Remoción de Reglas SIN Reiniciar**: ✅
+   - Comando `remove-x-rule` funciona correctamente
+   - Muestra lista de reglas disponibles para remover
+   - Remueve la regla seleccionada inmediatamente
+   - No requiere reiniciar el servidor
+
+3. **Guardado de Reglas**: ✅
+   - Comando `save-rules` funciona correctamente
+   - Guarda reglas en archivos JSON en el directorio `waf-rules/`
+   - Muestra confirmación de guardado exitoso
+
+4. **Carga de Reglas**: ✅
+   - Comando `load-rules` funciona correctamente
+   - Lista archivos disponibles para cargar
+   - Pregunta confirmación antes de reemplazar reglas
+   - Carga reglas desde archivo JSON exitosamente
+
+5. **Visualización de Estadísticas**: ✅
+   - Comandos `waf-status`, `waf-stats`, `waf-blocked`, `waf-security` funcionan
+   - Muestra solicitudes procesadas con kilobytes
+   - Muestra respuestas enviadas con kilobytes
+   - Muestra accesos a rutas (input/output)
+   - Muestra endpoints y rutas más accedidas
+
+## 🧪 Pruebas Realizadas
+
+1. **Creación de regla**: Se creó regla para `X-Real-IP` con patrón `10.0.0.` y acción `block`
+2. **Verificación**: Se confirmó que la regla estaba registrada
+3. **Guardado**: Se guardó la regla en archivo JSON
+4. **Remoción**: Se removió la regla sin reiniciar el servidor
+5. **Verificación de remoción**: Se confirmó que la regla ya no estaba registrada
+6. **Carga**: Se cargaron las reglas desde el archivo guardado
+7. **Verificación de carga**: Se confirmó que la regla fue restaurada desde el archivo
+
+## 📊 Resultados Finales
+
+- **Cantidad de requests procesados mostrando kilobytes**: ✅ Funciona
+- **Cantidad de responses enviadas mostrando kilobytes**: ✅ Funciona
+- **Accesos a las rutas registradas (input y output)**: ✅ Funciona
+- **Endpoints y rutas más accedidas**: ✅ Funciona
+- **Remoción de reglas sin reiniciar**: ✅ Funciona
+- **Guardado y carga de reglas**: ✅ Funciona
+
+## 🚀 Comandos Disponibles
+
+- `waf-status` / `waf-stats`: Muestra estadísticas generales
+- `waf-blocked` / `waf-security`: Muestra estadísticas de seguridad
+- `waf-x-headers`: Muestra reglas de headers X-
+- `create-x-rule`: Crea nuevas reglas de headers X-
+- `remove-x-rule`: Remueve reglas existentes
+- `save-rules`: Guarda reglas a archivo
+- `load-rules`: Carga reglas desde archivo
+
+El módulo de gestión de rutas del WAF está completamente funcional y proporciona todas las funcionalidades solicitadas con un sistema robusto de estadísticas globales y persistencia de reglas.

package/doc-2.5/MANUAL_MODULOS_ADMIN.md

@@ -0,0 +1,287 @@
+# Manual de Uso: Módulos de Administración de JERK Framework
+
+## Descripción General
+
+Este manual describe el uso de los módulos de administración interactivos para crear controladores y gestionar rutas en JERK Framework.
+
+## Módulo de Generación de Controladores
+
+### Descripción
+El módulo de generación de controladores permite crear nuevos controladores de manera interactiva con una interfaz paso a paso.
+
+### Comandos Disponibles
+- `generate-controller`
+- `gen-ctrl`
+- `new-ctrl`
+
+### Cómo Usar el Módulo
+
+1. **Iniciar el proceso**
+   ```
+   > generate-controller
+   ```
+
+2. **Nombre del controlador**
+   - Ingresa el nombre base del controlador (sin la palabra "Controller")
+   - Ejemplo: "User", "Product", "Home"
+
+3. **Selección de métodos**
+   - Selecciona los métodos que deseas incluir:
+     - 1. index - Método para mostrar lista de elementos
+     - 2. show - Método para mostrar un elemento específico
+     - 3. create - Método para crear un nuevo elemento
+     - 4. update - Método para actualizar un elemento
+     - 5. delete - Método para eliminar un elemento
+     - 6. All - Todos los métodos anteriores
+   - Opciones de entrada:
+     - Números separados por comas: "1,2,3"
+     - Nombres de métodos: "index,show,create"
+     - "All" para todos los métodos
+
+4. **Ruta del archivo**
+   - Indica la ruta donde crear el archivo del controlador
+   - Deja vacío para usar "./controllers/" por defecto
+   - Ejemplo: "./controllers/", "./src/controllers/"
+
+5. **Confirmación**
+   - Se mostrará una vista previa del código generado
+   - Confirma con "sí" para crear el archivo o "no" para cancelar
+
+### Ejemplo Completo
+```
+> generate-controller
+=== Generador de Controladores ===
+Por favor, introduce el nombre del controlador (sin la palabra "Controller"):
+> User
+
+Selecciona los métodos que deseas incluir (separados por comas):
+> 1,2,3
+
+Indica la ruta donde deseas crear el archivo del controlador:
+> 
+
+=== Vista Previa del Controlador ===
+[... código del controlador ...]
+¿Deseas crear este controlador? (sí/no):
+> sí
+
+✅ Controlador "UserController" creado exitosamente en: ./controllers/UserController.js
+```
+
+## Módulo de Gestión de Rutas
+
+### Descripción
+El módulo de gestión de rutas permite crear nuevas rutas, deshabilitar rutas existentes y ver rutas registradas o activas.
+
+### Comandos Disponibles
+- `manage-routes`
+- `route-manager`
+- `route-mgmt`
+
+## Módulo de Cache de Rutas
+
+### Descripción
+El módulo de cache de rutas permite monitorear y gestionar el cache de rutas del sistema, incluyendo visualización de estadísticas, contenido del cache, y limpieza del cache.
+
+### Comandos Disponibles
+- `route-cache`
+- `cache-stats`
+- `cache-view`
+- `cache-dynamic`
+- `cache-static`
+- `cache-clear`
+
+### Cómo Usar el Módulo
+
+1. **Ver estadísticas del cache**
+   ```
+   > route-cache
+   ```
+
+2. **Ver contenido completo del cache**
+   ```
+   > cache-view
+   ```
+
+3. **Ver solo rutas dinámicas (parametrizadas)**
+   ```
+   > cache-dynamic
+   ```
+
+4. **Ver solo rutas estáticas (exactas)**
+   ```
+   > cache-static
+   ```
+
+5. **Limpiar el cache de rutas**
+   ```
+   > cache-clear
+   ```
+
+### Ejemplo de Uso
+```
+> route-cache
+=== Estadísticas del Cache de Rutas ===
+Rutas dinámicas (parametrizadas) en cache: 5
+Rutas estáticas exactas en cache: 10
+Tamaño total de índices: 15
+Índices válidos: Sí
+
+> cache-dynamic
+=== Cache de Rutas Dinámicas (Parametrizadas) ===
+1. Ruta: /users/:id
+   Regex: /^\/users\/([^\/]+?)$/
+
+Total: 1 rutas dinámicas en cache.
+
+> cache-clear
+=== Limpieza del Cache de Rutas ===
+Rutas dinámicas eliminadas: 5
+Rutas estáticas eliminadas: 10
+Cache de rutas limpiado exitosamente.
+```
+
+### Cómo Usar el Módulo
+
+1. **Iniciar el proceso**
+   ```
+   > route-mgmt
+   ```
+
+2. **Menú Principal**
+   El sistema mostrará las opciones disponibles:
+   - 1. Crear nueva ruta
+   - 2. Deshabilitar ruta existente
+   - 3. Ver rutas registradas
+   - 4. Ver rutas activas
+
+### Opción 1: Crear Nueva Ruta
+
+1. **Selecciona el método HTTP**
+   - 1. GET
+   - 2. POST
+   - 3. PUT
+   - 4. DELETE
+   - 5. PATCH
+   - 6. Otro
+   - O ingresa el método directamente (GET, POST, etc.)
+
+2. **Introduce la ruta**
+   - Ejemplo: "/api/users", "/users/:id"
+
+3. **Ruta al archivo del controlador**
+   - Ejemplo: "./controllers/UserController.js"
+
+4. **Nombre del handler**
+   - Nombre del método en el controlador
+   - Ejemplo: "index", "show", "create"
+
+5. **Confirmación**
+   - Se mostrará una vista previa de la entrada para routes.json
+   - Confirma con "sí" para crear la ruta o "no" para cancelar
+
+### Opción 2: Deshabilitar Ruta Existente
+
+1. **Selecciona la ruta**
+   - El sistema mostrará una lista numerada de rutas registradas
+   - Ingresa el número de la ruta que deseas deshabilitar
+
+2. **Confirmación**
+   - Se mostrará la ruta seleccionada
+   - Confirma con "sí" para deshabilitar la ruta o "no" para cancelar
+
+### Opción 3: Ver Rutas Registradas
+
+- Muestra todas las rutas registradas en el sistema
+- Formato: Número. Método HTTP Ruta
+
+### Opción 4: Ver Rutas Activas
+
+- Muestra las rutas que han recibido solicitudes recientemente
+- Formato: Método HTTP Ruta - Fecha y hora de la última solicitud
+
+### Ejemplo de Creación de Ruta
+```
+> route-mgmt
+=== Gestión de Rutas ===
+¿Qué deseas hacer?
+1. Crear nueva ruta
+2. Deshabilitar ruta existente
+3. Ver rutas registradas
+4. Ver rutas activas
+> 1
+
+=== Crear Nueva Ruta ===
+Selecciona el método HTTP:
+1. GET
+2. POST
+3. PUT
+4. DELETE
+5. PATCH
+6. Otro
+> GET
+
+Método seleccionado: GET
+Introduce la ruta (ej: /api/users, /users/:id):
+> /api/demo
+
+Ruta: /api/demo
+Introduce la ruta al archivo del controlador (ej: ./controllers/UserController.js):
+> ./controllers/DemoController.js
+
+Introduce el nombre del handler (método del controlador):
+> index
+
+=== Vista Previa de la Ruta ===
+Método: GET
+Ruta: /api/demo
+Controlador: ./controllers/DemoController.js
+Handler: index
+
+Entrada para routes.json:
+{
+  "path": "/api/demo",
+  "method": "GET",
+  "controller": "./controllers/DemoController.js",
+  "handler": "index",
+  "contentType": "application/json"
+}
+
+¿Deseas crear esta ruta? (sí/no):
+> sí
+
+✅ Ruta "GET /api/demo" creada exitosamente.
+```
+
+## Consejos de Uso
+
+### Para Controladores
+- Usa nombres descriptivos para tus controladores
+- Considera qué métodos necesitas antes de crear el controlador
+- Elige rutas de archivo que sigan la estructura de tu proyecto
+
+### Para Rutas
+- Asegúrate de que el controlador y el handler existan antes de crear la ruta
+- Usa rutas RESTful cuando sea posible
+- Considera el método HTTP adecuado para cada operación
+
+## Errores Comunes y Soluciones
+
+### Controlador
+- **Nombre inválido**: Asegúrate de usar solo letras, números y guiones bajos
+- **Ruta de archivo no encontrada**: Verifica que la ruta sea correcta
+
+### Rutas
+- **Ruta duplicada**: El sistema no impide rutas duplicadas
+- **Controlador o handler no encontrado**: Verifica que existan antes de crear la ruta
+- **Método HTTP inválido**: Usa métodos estándar (GET, POST, PUT, DELETE, PATCH)
+
+## Comandos Generales
+
+- `help`: Muestra la ayuda general
+- `quit` o `exit`: Cierra la conexión
+- `cancel`: Cancela el proceso interactivo actual
+
+## Soporte
+
+Para soporte adicional, consulta la documentación del framework o contacta al equipo de desarrollo.

package/doc-2.5/QUEUE_CLI_MODULE_MANUAL.md

@@ -0,0 +1,289 @@
+# Manual del Módulo CLI de Gestión de Colas para JERK Framework
+
+## Tabla de Contenidos
+1. [Introducción](#introducción)
+2. [Comandos Disponibles](#comandos-disponibles)
+3. [Uso Básico](#uso-básico)
+4. [Uso Avanzado](#uso-avanzado)
+5. [Ejemplos de Uso](#ejemplos-de-uso)
+6. [Solución de Problemas](#solución-de-problemas)
+
+## Introducción
+
+El módulo de Gestión de Colas es una extensión del sistema de administración CLI de JERK Framework que permite monitorear y gestionar las colas de tareas del sistema. Proporciona comandos para ver el estado de las colas, pausarlas, reanudarlas, limpiarlas y gestionar tareas fallidas.
+
+## Comandos Disponibles
+
+### Comandos Generales de Colas
+- `queues`: Muestra el estado de todas las colas del sistema
+- `queue-info`: Muestra información detallada de una cola específica
+- `queue-pause`: Pausa una cola específica
+- `queue-resume`: Reanuda una cola específica
+- `queue-clear`: Limpia las tareas pendientes de una cola específica
+- `queue-retry-failed`: Reintenta las tareas fallidas de una cola específica
+
+## Uso Básico
+
+### Conectar al Sistema de Administración
+
+Para acceder al módulo de gestión de colas, primero debes conectarte al sistema de administración:
+
+```bash
+telnet localhost 9999
+```
+
+O alternativamente:
+
+```bash
+nc localhost 9999
+```
+
+### Ver el estado de todas las colas
+
+Comando: `queues`
+
+Este comando muestra el estado de todas las colas registradas en el sistema:
+
+```
+> queues
+
+=== Colas del Sistema ===
+imagenes:
+  Concurrencia: 3/3
+  Tareas pendientes: 0
+  Tareas en proceso: 0
+  Tareas fallidas: 0
+  Estado: INACTIVO
+  Reintentos: 2
+  Retraso de reintento: 1000ms
+
+correos:
+  Concurrencia: 2/2
+  Tareas pendientes: 1
+  Tareas en proceso: 1
+  Tareas fallidas: 0
+  Estado: PROCESANDO
+  Reintentos: 3
+  Retraso de reintento: 2000ms
+
+pagos:
+  Concurrencia: 1/1
+  Tareas pendientes: 0
+  Tareas en proceso: 0
+  Tareas fallidas: 2
+  Estado: INACTIVO
+  Reintentos: 5
+  Retraso de reintento: 3000ms
+
+backups:
+  Concurrencia: 1/1
+  Tareas pendientes: 0
+  Tareas en proceso: 0
+  Tareas fallidas: 0
+  Estado: INACTIVO
+  Reintentos: 3
+  Retraso de reintento: 5000ms
+
+> 
+```
+
+### Ver información detallada de una cola específica
+
+Comando: `queue-info`
+
+Este comando solicita el nombre de una cola y muestra información detallada:
+
+```
+> queue-info
+
+Introduce el nombre de la cola:
+> pagos
+
+=== Información de la Cola: pagos ===
+Concurrencia: 1/1
+Tareas pendientes: 0
+Tareas en proceso: 0
+Tareas fallidas: 2
+Estado: INACTIVO
+Reintentos: 5
+Retraso de reintento: 3000ms
+Total de workers: 0
+
+> 
+```
+
+## Uso Avanzado
+
+### Pausar una cola
+
+Comando: `queue-pause`
+
+Pausa temporalmente el procesamiento de tareas en una cola específica:
+
+```
+> queue-pause
+
+Introduce el nombre de la cola:
+> correos
+
+✅ Cola 'correos' pausada exitosamente.
+
+> 
+```
+
+Cuando una cola está pausada, no procesará nuevas tareas, pero las tareas que ya estaban en proceso se completarán normalmente.
+
+### Reanudar una cola
+
+Comando: `queue-resume`
+
+Reanuda el procesamiento de tareas en una cola específica:
+
+```
+> queue-resume
+
+Introduce el nombre de la cola:
+> correos
+
+✅ Cola 'correos' reanudada exitosamente.
+
+> 
+```
+
+### Limpiar una cola
+
+Comando: `queue-clear`
+
+Elimina todas las tareas pendientes de una cola específica (no afecta a las tareas que ya están en proceso):
+
+```
+> queue-clear
+
+Introduce el nombre de la cola:
+> imagenes
+
+✅ Cola 'imagenes' limpiada exitosamente (tareas pendientes eliminadas).
+
+> 
+```
+
+### Reintentar tareas fallidas
+
+Comando: `queue-retry-failed`
+
+Reintenta todas las tareas que han fallado definitivamente en una cola específica:
+
+```
+> queue-retry-failed
+
+Introduce el nombre de la cola:
+> pagos
+
+✅ Reintento de tareas fallidas iniciado para la cola 'pagos'.
+
+> 
+```
+
+## Ejemplos de Uso
+
+### Ejemplo 1: Monitoreo de colas
+
+Para monitorear constantemente el estado de las colas, puedes usar el comando `queues` repetidamente:
+
+```
+> queues
+imagenes: Pendientes=0, En proceso=2, Fallidas=0, Pausada=false
+correos: Pendientes=5, En proceso=1, Fallidas=0, Pausada=false
+pagos: Pendientes=0, En proceso=0, Fallidas=1, Pausada=false
+backups: Pendientes=0, En proceso=0, Fallidas=0, Pausada=false
+> 
+```
+
+### Ejemplo 2: Gestión de alta carga
+
+Si una cola está recibiendo demasiadas tareas y necesitas detener temporalmente el procesamiento:
+
+```
+> queue-pause
+Introduce el nombre de la cola:
+> correos
+✅ Cola 'correos' pausada exitosamente.
+
+> queues
+correos: Pendientes=50, En proceso=0, Fallidas=0, Pausada=true
+> 
+```
+
+Luego, cuando la carga disminuya, puedes reanudar:
+
+```
+> queue-resume
+Introduce el nombre de la cola:
+> correos
+✅ Cola 'correos' reanudada exitosamente.
+```
+
+### Ejemplo 3: Manejo de tareas fallidas
+
+Si una cola tiene tareas fallidas que deseas reintentar:
+
+```
+> queues
+pagos: Pendientes=0, En proceso=0, Fallidas=3, Pausada=false
+
+> queue-retry-failed
+Introduce el nombre de la cola:
+> pagos
+✅ Reintento de tareas fallidas iniciado para la cola 'pagos'.
+
+> queues
+pagos: Pendientes=3, En proceso=0, Fallidas=0, Pausada=false
+```
+
+## Solución de Problemas
+
+### Problema: Comando no reconocido
+
+**Síntoma**: El sistema responde con "Comando desconocido para el módulo de gestión de colas"
+
+**Solución**: Verifica que estás usando uno de los comandos válidos: `queues`, `queue-info`, `queue-pause`, `queue-resume`, `queue-clear`, `queue-retry-failed`
+
+### Problema: Cola no encontrada
+
+**Síntoma**: El sistema responde con "❌ Cola 'nombre' no encontrada."
+
+**Solución**: Verifica que el nombre de la cola es correcto. Puedes usar el comando `queues` para ver la lista de colas disponibles.
+
+### Problema: Cola no responde
+
+**Síntoma**: Las tareas no se procesan aunque la cola esté activa
+
+**Solución**: 
+1. Verifica el estado con `queues`
+2. Comprueba si la cola está pausada
+3. Verifica que el sistema de colas esté iniciado en la aplicación
+4. Revisa los logs de la aplicación para posibles errores
+
+### Problema: Tareas acumulándose
+
+**Síntoma**: La cola tiene muchas tareas pendientes que no se procesan
+
+**Soluciones posibles**:
+1. Aumenta la concurrencia de la cola en la configuración de la aplicación
+2. Pausa temporalmente la cola si hay sobrecarga: `queue-pause`
+3. Verifica que las tareas no estén fallando continuamente
+
+## Compatibilidad
+
+- **Versión mínima del framework**: JERK 2.6.0
+- **Puerto de administración**: Por defecto 9999 (configurable)
+- **Acceso**: Solo desde localhost por razones de seguridad
+- **Protocolo**: Conexión TCP con interfaz de línea de comandos
+
+## Autor
+
+JERK Framework Team
+
+## Versión
+
+v2.6.0