jerkjs 2.5.8 → 2.6.1

package/lib/admin/modules/QueueManagementModule.js

@@ -0,0 +1,265 @@
+/**
+ * Módulo de Gestión de Colas para el Sistema CLI
+ * Implementación del componente admin/modules/QueueManagementModule.js
+ * Permite gestionar las colas desde el sistema de administración CLI
+ */
+
+class QueueManagementModule {
+  constructor(adminExtension) {
+    this.name = 'Queue Management Module';
+    this.description = 'Módulo para gestionar las colas del sistema';
+    this.commands = ['queues', 'queue-info', 'queue-pause', 'queue-resume', 'queue-clear', 'queue-retry-failed'];
+    this.adminExtension = adminExtension;
+    
+    // Referencia al sistema de colas global
+    this.queueSystem = null;
+    
+    // Inicializar estructuras de datos compartidas globalmente
+    this.initializeGlobalQueueStorage();
+  }
+
+  /**
+   * Inicializa el almacenamiento global de colas
+   */
+  initializeGlobalQueueStorage() {
+    // Importar el almacenamiento global de colas
+    const { queueSystem } = require('../../queue/GlobalQueueStorage');
+    
+    this.queueSystem = queueSystem;
+  }
+
+  /**
+   * Maneja los comandos del módulo
+   */
+  handleCommand(command, socket) {
+    switch (command) {
+      case 'queues':
+        this.listQueues(socket);
+        break;
+      case 'queue-info':
+        this.promptQueueName(socket, 'info');
+        break;
+      case 'queue-pause':
+        this.promptQueueName(socket, 'pause');
+        break;
+      case 'queue-resume':
+        this.promptQueueName(socket, 'resume');
+        break;
+      case 'queue-clear':
+        this.promptQueueName(socket, 'clear');
+        break;
+      case 'queue-retry-failed':
+        this.promptQueueName(socket, 'retry-failed');
+        break;
+      default:
+        socket.write(`Comando desconocido para el módulo de gestión de colas: ${command}\n`);
+        socket.write(`Comandos disponibles: ${this.commands.join(', ')}\n\n`);
+        socket.write(`> `);
+    }
+  }
+
+  /**
+   * Lista todas las colas
+   */
+  listQueues(socket) {
+    socket.write('\n=== Colas del Sistema ===\n');
+    
+    if (this.queueSystem.queues.size === 0) {
+      socket.write('No hay colas registradas.\n');
+    } else {
+      for (const [queueName, queue] of this.queueSystem.queues.entries()) {
+        const status = this.queueSystem.getStatus()[queueName] || {};
+        socket.write(`${queueName}:\n`);
+        socket.write(`  Concurrencia: ${queue.concurrency}/${queue.maxWorkers}\n`);
+        socket.write(`  Tareas pendientes: ${status.pendingTasks || 0}\n`);
+        socket.write(`  Tareas en proceso: ${status.runningTasks || 0}\n`);
+        socket.write(`  Tareas fallidas: ${status.failedTasks || 0}\n`);
+        socket.write(`  Estado: ${queue.processing ? 'PROCESANDO' : 'INACTIVO'}\n`);
+        socket.write(`  Reintentos: ${queue.retryAttempts}\n`);
+        socket.write(`  Retraso de reintento: ${queue.retryDelay}ms\n`);
+        socket.write('\n');
+      }
+    }
+    
+    socket.write(`> `);
+  }
+
+  /**
+   * Muestra información detallada de una cola específica
+   */
+  showQueueInfo(socket, queueName) {
+    const queue = this.queueSystem.queues.get(queueName);
+    
+    if (!queue) {
+      socket.write(`\n❌ Cola '${queueName}' no encontrada.\n\n`);
+      socket.write(`> `);
+      return;
+    }
+    
+    const status = this.queueSystem.getStatus()[queueName] || {};
+    
+    socket.write(`\n=== Información de la Cola: ${queueName} ===\n`);
+    socket.write(`Concurrencia: ${queue.concurrency}/${queue.maxWorkers}\n`);
+    socket.write(`Tareas pendientes: ${status.pendingTasks || 0}\n`);
+    socket.write(`Tareas en proceso: ${status.runningTasks || 0}\n`);
+    socket.write(`Tareas fallidas: ${status.failedTasks || 0}\n`);
+    socket.write(`Estado: ${queue.processing ? 'PROCESANDO' : 'INACTIVO'}\n`);
+    socket.write(`Reintentos: ${queue.retryAttempts}\n`);
+    socket.write(`Retraso de reintento: ${queue.retryDelay}ms\n`);
+    socket.write(`Total de workers: ${queue.workers}\n`);
+    
+    socket.write('\n> ');
+  }
+
+  /**
+   * Pausa una cola específica
+   */
+  pauseQueue(socket, queueName) {
+    const result = this.queueSystem.pauseQueue(queueName);
+    
+    if (!result) {
+      socket.write(`\n❌ Cola '${queueName}' no encontrada.\n\n`);
+      socket.write(`> `);
+      return;
+    }
+    
+    socket.write(`\n✅ Cola '${queueName}' pausada exitosamente.\n\n`);
+    socket.write(`> `);
+  }
+
+  /**
+   * Reanuda una cola específica
+   */
+  resumeQueue(socket, queueName) {
+    const result = this.queueSystem.resumeQueue(queueName);
+    
+    if (!result) {
+      socket.write(`\n❌ Cola '${queueName}' no encontrada.\n\n`);
+      socket.write(`> `);
+      return;
+    }
+    
+    socket.write(`\n✅ Cola '${queueName}' reanudada exitosamente.\n\n`);
+    socket.write(`> `);
+  }
+
+  /**
+   * Limpia una cola específica (elimina tareas pendientes)
+   */
+  clearQueue(socket, queueName) {
+    const result = this.queueSystem.clearQueue(queueName);
+    
+    if (!result) {
+      socket.write(`\n❌ Cola '${queueName}' no encontrada.\n\n`);
+      socket.write(`> `);
+      return;
+    }
+    
+    socket.write(`\n✅ Cola '${queueName}' limpiada exitosamente (tareas pendientes eliminadas).\n\n`);
+    socket.write(`> `);
+  }
+
+  /**
+   * Reintenta tareas fallidas en una cola específica
+   */
+  retryFailedTasks(socket, queueName) {
+    const queue = this.queueSystem.queues.get(queueName);
+    
+    if (!queue) {
+      socket.write(`\n❌ Cola '${queueName}' no encontrada.\n\n`);
+      socket.write(`> `);
+      return;
+    }
+    
+    // Usar el método existente para reintentar tareas fallidas
+    this.queueSystem.retryFailedTasks(queueName);
+    
+    socket.write(`\n✅ Reintento de tareas fallidas iniciado para la cola '${queueName}'.\n\n`);
+    socket.write(`> `);
+  }
+
+  /**
+   * Solicita el nombre de una cola al usuario
+   */
+  promptQueueName(socket, action) {
+    socket.write(`\nIntroduce el nombre de la cola (o 'cancel' para abortar):\n> `);
+    
+    // Establecer el estado de entrada para este socket
+    if (!this.inputState) {
+      this.inputState = new Map();
+    }
+    
+    // Guardar el estado de entrada para este socket
+    this.inputState.set(socket, { action });
+    
+    // Adjuntar un manejador temporal para esta entrada
+    const originalOnData = socket.listeners('data')[0];
+    if (originalOnData) {
+      socket.removeListener('data', originalOnData);
+    }
+    
+    const tempHandler = (data) => {
+      const input = data.toString().trim();
+      
+      // Recuperar el estado de entrada
+      const state = this.inputState.get(socket);
+      if (state) {
+        this.inputState.delete(socket);
+        
+        // Restaurar el manejador original
+        if (originalOnData) {
+          socket.on('data', originalOnData);
+        }
+        
+        // Procesar la acción
+        this.processQueueAction(socket, state.action, input);
+      }
+    };
+    
+    socket.on('data', tempHandler);
+  }
+
+  /**
+   * Procesa la acción en base al nombre de cola proporcionado
+   */
+  processQueueAction(socket, action, queueName) {
+    // Verificar si la cola existe antes de procesar la acción
+    const queueExists = this.queueSystem.queues.has(queueName);
+    
+    if (!queueExists && queueName !== 'cancel') {
+      socket.write(`\n❌ Cola '${queueName}' no encontrada.\n\n`);
+      // Volver a solicitar el nombre de la cola
+      this.promptQueueName(socket, action);
+      return;
+    }
+    
+    if (queueName === 'cancel') {
+      socket.write(`\nOperación cancelada.\n\n`);
+      socket.write(`> `);
+      return;
+    }
+    
+    switch (action) {
+      case 'info':
+        this.showQueueInfo(socket, queueName);
+        break;
+      case 'pause':
+        this.pauseQueue(socket, queueName);
+        break;
+      case 'resume':
+        this.resumeQueue(socket, queueName);
+        break;
+      case 'clear':
+        this.clearQueue(socket, queueName);
+        break;
+      case 'retry-failed':
+        this.retryFailedTasks(socket, queueName);
+        break;
+      default:
+        socket.write(`\n❌ Acción desconocida: ${action}\n\n`);
+        socket.write(`> `);
+    }
+  }
+}
+
+module.exports = QueueManagementModule;

package/lib/admin/modules/RouteCacheModule.js

@@ -0,0 +1,227 @@
+/**
+ * Módulo CLI para gestionar y visualizar el cache de rutas dinámicas y estáticas
+ * Implementación del componente admin/modules/RouteCacheModule.js
+ */
+
+class RouteCacheModule {
+  constructor(adminExtension) {
+    this.adminExtension = adminExtension;
+    this.name = 'Route Cache Module';
+    this.description = 'Módulo para gestionar y visualizar el cache de rutas dinámicas y estáticas';
+    this.commands = ['route-cache', 'cache-stats', 'cache-view', 'cache-clear', 'cache-dynamic', 'cache-static'];
+  }
+
+  /**
+   * Maneja los comandos del módulo
+   */
+  handleCommand(command, socket) {
+    switch (command) {
+      case 'route-cache':
+      case 'cache-stats':
+        this.showCacheStats(socket);
+        break;
+      case 'cache-view':
+        this.showCacheContents(socket);
+        break;
+      case 'cache-clear':
+        this.clearCache(socket);
+        break;
+      case 'cache-dynamic':
+        this.showDynamicCache(socket);
+        break;
+      case 'cache-static':
+        this.showStaticCache(socket);
+        break;
+      default:
+        socket.write(`\x1b[31mComando desconocido para el módulo de cache de rutas: ${command}\x1b[0m\n`); // Rojo para error
+        socket.write(`\x1b[32mComandos disponibles: route-cache, cache-stats, cache-view, cache-clear, cache-dynamic, cache-static\x1b[0m\n\n`); // Verde para comandos
+        socket.write(`> `);
+    }
+  }
+
+  /**
+   * Muestra estadísticas del cache de rutas
+   */
+  showCacheStats(socket) {
+    const routeMatcher = this.adminExtension.frameworkInstance.routeMatcher;
+    
+    if (!routeMatcher) {
+      socket.write('\n=== Estadísticas del Cache de Rutas ===\n');
+      socket.write('No se encontró el componente RouteMatcher.\n\n');
+      socket.write('> ');
+      return;
+    }
+
+    // Contar rutas dinámicas (parametrizadas) en el cache
+    let dynamicRoutesCount = 0;
+    if (routeMatcher.routeRegexCache) {
+      dynamicRoutesCount = routeMatcher.routeRegexCache.size;
+    }
+
+    // Contar rutas estáticas en los índices
+    let staticRoutesCount = 0;
+    if (routeMatcher.exactRoutes) {
+      staticRoutesCount = routeMatcher.exactRoutes.size;
+    }
+
+    // Calcular el tamaño total de los índices
+    let totalIndexSize = 0;
+    if (routeMatcher.routeBuckets) {
+      for (const method in routeMatcher.routeBuckets) {
+        for (const segmentCount in routeMatcher.routeBuckets[method]) {
+          for (const firstSegment in routeMatcher.routeBuckets[method][segmentCount]) {
+            totalIndexSize += routeMatcher.routeBuckets[method][segmentCount][firstSegment].length;
+          }
+        }
+      }
+    }
+
+    socket.write('\n=== Estadísticas del Cache de Rutas ===\n');
+    socket.write(`Rutas dinámicas (parametrizadas) en cache: ${dynamicRoutesCount}\n`);
+    socket.write(`Rutas estáticas exactas en cache: ${staticRoutesCount}\n`);
+    socket.write(`Tamaño total de índices: ${totalIndexSize}\n`);
+    socket.write(`Índices válidos: ${routeMatcher.indexesValid ? 'Sí' : 'No'}\n\n`);
+    socket.write('> ');
+  }
+
+  /**
+   * Muestra el contenido del cache de rutas
+   */
+  showCacheContents(socket) {
+    const routeMatcher = this.adminExtension.frameworkInstance.routeMatcher;
+    
+    if (!routeMatcher) {
+      socket.write('\n=== Contenido del Cache de Rutas ===\n');
+      socket.write('No se encontró el componente RouteMatcher.\n\n');
+      socket.write('> ');
+      return;
+    }
+
+    socket.write('\n=== Contenido del Cache de Rutas ===\n');
+
+    // Mostrar rutas dinámicas (parametrizadas) en cache
+    socket.write('\n--- Rutas Dinámicas (Parametrizadas) en Cache ---\n');
+    if (routeMatcher.routeRegexCache && routeMatcher.routeRegexCache.size > 0) {
+      let count = 0;
+      for (const [path, regex] of routeMatcher.routeRegexCache) {
+        socket.write(`${++count}. ${path} -> ${regex}\n`);
+      }
+    } else {
+      socket.write('No hay rutas dinámicas en cache.\n');
+    }
+
+    // Mostrar rutas estáticas exactas en cache
+    socket.write('\n--- Rutas Estáticas Exactas en Cache ---\n');
+    if (routeMatcher.exactRoutes && routeMatcher.exactRoutes.size > 0) {
+      let count = 0;
+      for (const [methodPath, route] of routeMatcher.exactRoutes) {
+        socket.write(`${++count}. ${methodPath} -> ${route.handler.name || 'anonymous'}\n`);
+      }
+    } else {
+      socket.write('No hay rutas estáticas exactas en cache.\n');
+    }
+
+    socket.write('\n> ');
+  }
+
+  /**
+   * Muestra solo el cache de rutas dinámicas
+   */
+  showDynamicCache(socket) {
+    const routeMatcher = this.adminExtension.frameworkInstance.routeMatcher;
+    
+    if (!routeMatcher) {
+      socket.write('\n=== Cache de Rutas Dinámicas ===\n');
+      socket.write('No se encontró el componente RouteMatcher.\n\n');
+      socket.write('> ');
+      return;
+    }
+
+    socket.write('\n=== Cache de Rutas Dinámicas (Parametrizadas) ===\n');
+    if (routeMatcher.routeRegexCache && routeMatcher.routeRegexCache.size > 0) {
+      let count = 0;
+      for (const [path, regex] of routeMatcher.routeRegexCache) {
+        socket.write(`${++count}. Ruta: ${path}\n`);
+        socket.write(`   Regex: ${regex}\n\n`);
+      }
+      socket.write(`Total: ${routeMatcher.routeRegexCache.size} rutas dinámicas en cache.\n`);
+    } else {
+      socket.write('No hay rutas dinámicas en cache.\n');
+    }
+
+    socket.write('\n> ');
+  }
+
+  /**
+   * Muestra solo el cache de rutas estáticas
+   */
+  showStaticCache(socket) {
+    const routeMatcher = this.adminExtension.frameworkInstance.routeMatcher;
+    
+    if (!routeMatcher) {
+      socket.write('\n=== Cache de Rutas Estáticas ===\n');
+      socket.write('No se encontró el componente RouteMatcher.\n\n');
+      socket.write('> ');
+      return;
+    }
+
+    socket.write('\n=== Cache de Rutas Estáticas (Exactas) ===\n');
+    if (routeMatcher.exactRoutes && routeMatcher.exactRoutes.size > 0) {
+      let count = 0;
+      for (const [methodPath, route] of routeMatcher.exactRoutes) {
+        socket.write(`${++count}. ${methodPath}\n`);
+        socket.write(`   Handler: ${route.handler.name || 'anonymous'}\n`);
+        socket.write(`   Static: ${!!route.isStatic}\n\n`);
+      }
+      socket.write(`Total: ${routeMatcher.exactRoutes.size} rutas estáticas en cache.\n`);
+    } else {
+      socket.write('No hay rutas estáticas en cache.\n');
+    }
+
+    socket.write('\n> ');
+  }
+
+  /**
+   * Limpia el cache de rutas
+   */
+  clearCache(socket) {
+    const routeMatcher = this.adminExtension.frameworkInstance.routeMatcher;
+    
+    if (!routeMatcher) {
+      socket.write('\n=== Limpieza del Cache de Rutas ===\n');
+      socket.write('No se encontró el componente RouteMatcher.\n\n');
+      socket.write('> ');
+      return;
+    }
+
+    // Obtener tamaños antes de limpiar
+    const dynamicBefore = routeMatcher.routeRegexCache ? routeMatcher.routeRegexCache.size : 0;
+    const staticBefore = routeMatcher.exactRoutes ? routeMatcher.exactRoutes.size : 0;
+
+    // Limpiar caches
+    if (routeMatcher.clearCache) {
+      routeMatcher.clearCache();
+    } else {
+      // Si no existe el método clearCache, limpiar manualmente
+      if (routeMatcher.routeRegexCache) {
+        routeMatcher.routeRegexCache.clear();
+      }
+      if (routeMatcher.exactRoutes) {
+        routeMatcher.exactRoutes.clear();
+      }
+    }
+
+    // Actualizar índices
+    if (routeMatcher.updateIndexes && this.adminExtension.frameworkInstance.routes) {
+      routeMatcher.updateIndexes(this.adminExtension.frameworkInstance.routes);
+    }
+
+    socket.write('\n=== Limpieza del Cache de Rutas ===\n');
+    socket.write(`Rutas dinámicas eliminadas: ${dynamicBefore}\n`);
+    socket.write(`Rutas estáticas eliminadas: ${staticBefore}\n`);
+    socket.write('Cache de rutas limpiado exitosamente.\n\n');
+    socket.write('> ');
+  }
+}
+
+module.exports = RouteCacheModule;