jerkjs 2.5.6 → 2.6.1

package/lib/queue/example.js

@@ -0,0 +1,268 @@
+/**
+ * Ejemplo de uso del sistema de colas para el framework JERK
+ * Archivo de ejemplo: queue/example.js
+ * Demostración con 3 colas distintas
+ */
+
+// Importar el sistema de colas
+const QueueIntegration = require('./integration');
+const { hooks } = require('../../index.js'); // Suponiendo que se está usando dentro del framework
+
+// Crear una instancia de la integración de colas
+const queueIntegration = new QueueIntegration();
+const queueSystem = queueIntegration.getQueueSystem();
+
+// Ejemplo de tarea para la cola de procesamiento de imágenes
+function tareaProcesamientoImagen(datos, taskObj) {
+  return new Promise((resolve, reject) => {
+    console.log(`[IMAGEN] Procesando imagen: ${datos.nombreArchivo}`);
+    
+    // Simular un proceso de procesamiento de imagen
+    setTimeout(() => {
+      if (Math.random() < 0.2) { // 20% de probabilidad de fallo
+        console.error(`[IMAGEN] Falló el procesamiento de: ${datos.nombreArchivo}`);
+        reject(new Error(`Error procesando imagen: ${datos.nombreArchivo}`));
+      } else {
+        console.log(`[IMAGEN] Imagen procesada exitosamente: ${datos.nombreArchivo}`);
+        resolve(`Imagen ${datos.nombreArchivo} procesada con éxito`);
+      }
+    }, 2000);
+  });
+}
+
+// Ejemplo de tarea para la cola de envío de correos
+function tareaEnvioCorreo(datos, taskObj) {
+  return new Promise((resolve, reject) => {
+    console.log(`[CORREO] Enviando correo a: ${datos.destinatario}`);
+    
+    // Simular un proceso de envío de correo
+    setTimeout(() => {
+      if (Math.random() < 0.15) { // 15% de probabilidad de fallo
+        console.error(`[CORREO] Falló el envío a: ${datos.destinatario}`);
+        reject(new Error(`Error enviando correo a: ${datos.destinatario}`));
+      } else {
+        console.log(`[CORREO] Correo enviado exitosamente a: ${datos.destinatario}`);
+        resolve(`Correo enviado a ${datos.destinatario} con éxito`);
+      }
+    }, 1500);
+  });
+}
+
+// Ejemplo de tarea para la cola de procesamiento de pagos
+function tareaProcesamientoPago(datos, taskObj) {
+  return new Promise((resolve, reject) => {
+    console.log(`[PAGO] Procesando pago de: $${datos.monto} para ${datos.usuario}`);
+    
+    // Simular un proceso de procesamiento de pago
+    setTimeout(() => {
+      if (Math.random() < 0.25) { // 25% de probabilidad de fallo
+        console.error(`[PAGO] Falló el procesamiento de pago para: ${datos.usuario}`);
+        reject(new Error(`Error procesando pago para: ${datos.usuario}`));
+      } else {
+        console.log(`[PAGO] Pago procesado exitosamente para: ${datos.usuario}`);
+        resolve(`Pago de $${datos.monto} para ${datos.usuario} procesado con éxito`);
+      }
+    }, 3000);
+  });
+}
+
+// Configurar la cola de procesamiento de imágenes con hooks personalizados
+function setupColaImagenes() {
+  const HookSystem = require('../../lib/core/hooks');
+  const imagenHooks = new HookSystem();
+  
+  // Hook para personalizar la lógica de procesamiento de tareas de imagen
+  imagenHooks.addAction('queue_execute_task', (task, queueName, taskObj) => {
+    console.log(`[IMAGEN] Preparando para procesar tarea de imagen: ${taskObj.id}`);
+    // Aquí puedes modificar la tarea o agregar lógica personalizada
+    const wrappedTask = async (datos, taskObj) => {
+      console.log(`[IMAGEN] Iniciando ejecución de tarea de imagen: ${taskObj.id} con datos:`, datos);
+      try {
+        const result = await task(datos, taskObj);
+        console.log(`[IMAGEN] Tarea de imagen completada: ${taskObj.id}`);
+        return result;
+      } catch (error) {
+        console.log(`[IMAGEN] Error en tarea de imagen: ${taskObj.id} - ${error.message}`);
+        throw error;
+      }
+    };
+    return wrappedTask;
+  });
+  
+  // Hook para manejar la lógica de fallback para tareas de imagen
+  imagenHooks.addAction('queue_task_fallback', (queueName, task, error) => {
+    console.log(`[IMAGEN] Ejecutando lógica de fallback para tarea de imagen:`, error.message);
+    // Aquí puedes implementar la lógica de fallback personalizada para imágenes
+    console.log(`[IMAGEN] Guardando información de error para procesamiento posterior...`);
+  });
+  
+  // Crear la cola de imágenes con los hooks personalizados
+  queueIntegration.createQueue('imagenes', { 
+    concurrency: 3, 
+    retryAttempts: 2, 
+    retryDelay: 1000
+  }, imagenHooks);
+}
+
+// Configurar la cola de envío de correos con hooks personalizados
+function setupColaCorreos() {
+  const HookSystem = require('../../lib/core/hooks');
+  const correoHooks = new HookSystem();
+  
+  // Hook para personalizar la lógica de procesamiento de tareas de correo
+  correoHooks.addAction('queue_execute_task', (task, queueName, taskObj) => {
+    console.log(`[CORREO] Preparando para enviar correo: ${taskObj.id}`);
+    // Aquí puedes modificar la tarea o agregar lógica personalizada
+    const wrappedTask = async (datos, taskObj) => {
+      console.log(`[CORREO] Iniciando ejecución de tarea de correo: ${taskObj.id} con datos:`, datos);
+      try {
+        const result = await task(datos, taskObj);
+        console.log(`[CORREO] Tarea de correo completada: ${taskObj.id}`);
+        return result;
+      } catch (error) {
+        console.log(`[CORREO] Error en tarea de correo: ${taskObj.id} - ${error.message}`);
+        throw error;
+      }
+    };
+    return wrappedTask;
+  });
+  
+  // Hook para manejar la lógica de fallback para tareas de correo
+  correoHooks.addAction('queue_task_fallback', (queueName, task, error) => {
+    console.log(`[CORREO] Ejecutando lógica de fallback para tarea de correo:`, error.message);
+    // Aquí puedes implementar la lógica de fallback personalizada para correos
+    console.log(`[CORREO] Agregando destinatario a lista de reintento...`);
+  });
+  
+  // Crear la cola de correos con los hooks personalizados
+  queueIntegration.createQueue('correos', { 
+    concurrency: 2, 
+    retryAttempts: 3, 
+    retryDelay: 2000
+  }, correoHooks);
+}
+
+// Configurar la cola de procesamiento de pagos con hooks personalizados
+function setupColaPagos() {
+  const HookSystem = require('../../lib/core/hooks');
+  const pagoHooks = new HookSystem();
+  
+  // Hook para personalizar la lógica de procesamiento de tareas de pago
+  pagoHooks.addAction('queue_execute_task', (task, queueName, taskObj) => {
+    console.log(`[PAGO] Preparando para procesar pago: ${taskObj.id}`);
+    // Aquí puedes modificar la tarea o agregar lógica personalizada
+    const wrappedTask = async (datos, taskObj) => {
+      console.log(`[PAGO] Iniciando ejecución de tarea de pago: ${taskObj.id} con datos:`, datos);
+      try {
+        const result = await task(datos, taskObj);
+        console.log(`[PAGO] Tarea de pago completada: ${taskObj.id}`);
+        return result;
+      } catch (error) {
+        console.log(`[PAGO] Error en tarea de pago: ${taskObj.id} - ${error.message}`);
+        throw error;
+      }
+    };
+    return wrappedTask;
+  });
+  
+  // Hook para manejar la lógica de fallback para tareas de pago
+  pagoHooks.addAction('queue_task_fallback', (queueName, task, error) => {
+    console.log(`[PAGO] Ejecutando lógica de fallback para tarea de pago:`, error.message);
+    // Aquí puedes implementar la lógica de fallback personalizada para pagos
+    console.log(`[PAGO] Marcando transacción como pendiente para revisión manual...`);
+  });
+  
+  // Crear la cola de pagos con los hooks personalizados
+  queueIntegration.createQueue('pagos', { 
+    concurrency: 1, 
+    retryAttempts: 5, 
+    retryDelay: 3000
+  }, pagoHooks);
+}
+
+// Ejemplo de uso con 3 colas distintas
+function ejemploDeUso() {
+  // Configurar las 3 colas con sus hooks personalizados
+  setupColaImagenes();
+  setupColaCorreos();
+  setupColaPagos();
+  
+  // Agregar tareas a la cola de imágenes
+  console.log("\nAgregando tareas a la cola de imágenes...");
+  for (let i = 0; i < 5; i++) {
+    const taskId = queueIntegration.addTask('imagenes', tareaProcesamientoImagen, { 
+      id: i, 
+      nombreArchivo: `imagen_${i}.jpg`,
+      tamano: `${Math.floor(Math.random() * 10) + 1}MB`
+    }, i); // Usar el índice como prioridad (0 es la más alta)
+    
+    console.log(`Tarea de imagen agregada con ID: ${taskId}`);
+  }
+  
+  // Agregar tareas a la cola de correos
+  console.log("\nAgregando tareas a la cola de correos...");
+  const destinatarios = ['juan@ejemplo.com', 'maria@ejemplo.com', 'pedro@ejemplo.com', 'ana@ejemplo.com', 'luis@ejemplo.com'];
+  for (let i = 0; i < destinatarios.length; i++) {
+    const taskId = queueIntegration.addTask('correos', tareaEnvioCorreo, { 
+      id: i, 
+      destinatario: destinatarios[i],
+      asunto: `Mensaje de prueba #${i}`
+    }, i);
+    
+    console.log(`Tarea de correo agregada con ID: ${taskId}`);
+  }
+  
+  // Agregar tareas a la cola de pagos
+  console.log("\nAgregando tareas a la cola de pagos...");
+  const usuarios = ['Cliente A', 'Cliente B', 'Cliente C', 'Cliente D', 'Cliente E'];
+  for (let i = 0; i < usuarios.length; i++) {
+    const taskId = queueIntegration.addTask('pagos', tareaProcesamientoPago, { 
+      id: i, 
+      usuario: usuarios[i],
+      monto: (Math.floor(Math.random() * 1000) + 100),
+      metodo: i % 2 === 0 ? 'Tarjeta' : 'PayPal'
+    }, i);
+    
+    console.log(`Tarea de pago agregada con ID: ${taskId}`);
+  }
+  
+  // Iniciar el procesamiento de tareas
+  console.log("\nIniciando el sistema de colas...");
+  queueIntegration.start();
+  
+  // Mostrar estado periódicamente
+  setInterval(() => {
+    console.log('\n--- Estado del sistema de colas ---');
+    const status = queueIntegration.getStatus();
+    for (const [queueName, queueStatus] of Object.entries(status)) {
+      console.log(`${queueName}: Pendientes=${queueStatus.pendingTasks}, En proceso=${queueStatus.runningTasks}, Fallidas=${queueStatus.failedTasks}`);
+    }
+    console.log('------------------------------------\n');
+  }, 5000);
+  
+  // Detener el sistema después de 60 segundos
+  setTimeout(() => {
+    console.log("\nDeteniendo el sistema de colas...");
+    queueIntegration.stop();
+    console.log('Sistema de colas detenido');
+    
+    // Mostrar estado final
+    console.log('\n--- Estado final del sistema de colas ---');
+    const finalStatus = queueIntegration.getStatus();
+    for (const [queueName, queueStatus] of Object.entries(finalStatus)) {
+      console.log(`${queueName}: Pendientes=${queueStatus.pendingTasks}, En proceso=${queueStatus.runningTasks}, Fallidas=${queueStatus.failedTasks}`);
+    }
+    console.log('------------------------------------------\n');
+  }, 60000);
+}
+
+// Exportar para que pueda ser usado en otros lugares
+module.exports = {
+  QueueIntegration,
+  ejemploDeUso
+};
+
+// Si este archivo se ejecuta directamente, correr el ejemplo
+if (require.main === module) {
+  ejemploDeUso();
+}

package/lib/queue/integration.js

@@ -0,0 +1,109 @@
+/**
+ * Integración del Sistema de Colas para el framework JERK
+ * Implementación del componente queue/integration.js
+ * Archivo de integración para usar el sistema de colas como extensión del framework
+ */
+
+const { queueSystem } = require('./GlobalQueueStorage');
+
+class QueueIntegration {
+  /**
+   * Constructor de la integración
+   * @param {Object} options - Opciones de configuración
+   */
+  constructor(options = {}) {
+    // Usar el sistema de colas global
+    this.queueSystem = queueSystem;
+    
+    // Obtener los hooks del framework
+    try {
+      const framework = require('../../index.js');
+      this.globalHooks = framework.hooks;
+    } catch (error) {
+      // Si no está disponible, crear instancia local
+      const HookSystem = require('../core/hooks');
+      this.globalHooks = new HookSystem();
+    }
+  }
+
+  /**
+   * Inicializa la integración con el framework
+   * @param {Object} frameworkInstance - Instancia del framework JERK
+   */
+  initialize(frameworkInstance) {
+    // Registrar el sistema de colas en la instancia del framework
+    frameworkInstance.queueSystem = this.queueSystem;
+    
+    // Disparar hook cuando se inicializa la integración
+    this.globalHooks.doAction('queue_integration_initialized', this.queueSystem);
+  }
+
+  /**
+   * Obtiene el sistema de colas
+   * @returns {QueueSystem} - Instancia del sistema de colas
+   */
+  getQueueSystem() {
+    return this.queueSystem;
+  }
+
+  /**
+   * Crea una cola específica con hooks personalizados
+   * @param {string} queueName - Nombre de la cola
+   * @param {Object} options - Opciones específicas para la cola
+   * @param {Object} hooks - Sistema de hooks específico para esta cola (opcional)
+   * @returns {Object} - Cola creada
+   */
+  createQueue(queueName, options = {}, hooks = null) {
+    // Si se proporcionan hooks específicos para esta cola, usarlos
+    if (hooks) {
+      options.hooks = hooks;
+    }
+
+    // Crear la cola con las opciones
+    return this.queueSystem.getOrCreateQueue(queueName, options);
+  }
+
+  /**
+   * Agrega una tarea a una cola
+   * @param {string} queueName - Nombre de la cola
+   * @param {Function} task - Función que representa la tarea
+   * @param {Object} data - Datos para la tarea
+   * @param {number} priority - Prioridad de la tarea
+   * @returns {string} - ID único de la tarea
+   */
+  addTask(queueName, task, data = {}, priority = 0) {
+    return this.queueSystem.addTask(queueName, task, data, priority);
+  }
+
+  /**
+   * Inicia la ejecución de tareas en todas las colas
+   */
+  start() {
+    this.queueSystem.start();
+  }
+
+  /**
+   * Detiene la ejecución de tareas en todas las colas
+   */
+  stop() {
+    this.queueSystem.stop();
+  }
+
+  /**
+   * Obtiene el estado actual del sistema de colas
+   * @returns {Object} - Estado del sistema de colas
+   */
+  getStatus() {
+    return this.queueSystem.getStatus();
+  }
+
+  /**
+   * Reintenta todas las tareas fallidas en una cola específica
+   * @param {string} queueName - Nombre de la cola
+   */
+  retryFailedTasks(queueName) {
+    this.queueSystem.retryFailedTasks(queueName);
+  }
+}
+
+module.exports = QueueIntegration;