jerkjs 2.3.1 → 2.4.0

package/lib/query/queryBuilderHooks.js

@@ -1,455 +0,0 @@
-/**
- * Sistema de Hooks y Filters para QueryBuilder en el framework JERK
- * Implementación del componente query/queryBuilderHooks.js
- * Proporciona integración completa con el sistema de hooks y filters de JERK
- */
-
-// Función para inicializar los hooks del QueryBuilder
-function initializeQueryBuilderHooks(hooks) {
-  if (!hooks) {
-    console.error('No se proporcionó un sistema de hooks para el QueryBuilder');
-    return;
-  }
-
-  // Hook para antes de crear una instancia del QueryBuilder
-  hooks.addAction('query_builder_before_create', (config) => {
-    console.log('[HOOK] QueryBuilder antes de crear instancia', config);
-  });
-
-  // Hook para después de crear una instancia del QueryBuilder
-  hooks.addAction('query_builder_after_create', (queryBuilder, config) => {
-    console.log('[HOOK] QueryBuilder instancia creada', { tableName: queryBuilder.tableName });
-  });
-
-  // Filter para modificar la configuración antes de crear el QueryBuilder
-  hooks.addFilter('query_builder_config', (config) => {
-    // Añadir valores por defecto si no están presentes
-    return {
-      logQueries: false,
-      cacheResults: false,
-      ...config
-    };
-  });
-
-  // Hook para antes de ejecutar una consulta SELECT
-  hooks.addAction('query_builder_before_select', (sql, params, queryBuilder) => {
-    console.log('[HOOK] QueryBuilder antes de SELECT', { sql, params });
-  });
-
-  // Hook para después de ejecutar una consulta SELECT
-  hooks.addAction('query_builder_after_select', (results, sql, params, queryBuilder) => {
-    console.log('[HOOK] QueryBuilder después de SELECT', { rowCount: results.length });
-  });
-
-  // Hook para antes de ejecutar una inserción
-  hooks.addAction('query_builder_before_insert', (sql, data, queryBuilder) => {
-    console.log('[HOOK] QueryBuilder antes de INSERT', { sql, dataKeys: Object.keys(data) });
-  });
-
-  // Hook para después de ejecutar una inserción
-  hooks.addAction('query_builder_after_insert', (result, sql, data, queryBuilder) => {
-    console.log('[HOOK] QueryBuilder después de INSERT', { insertId: result.insertId });
-  });
-
-  // Hook para antes de ejecutar una actualización
-  hooks.addAction('query_builder_before_update', (sql, data, queryBuilder) => {
-    console.log('[HOOK] QueryBuilder antes de UPDATE', { sql, dataKeys: Object.keys(data) });
-  });
-
-  // Hook para después de ejecutar una actualización
-  hooks.addAction('query_builder_after_update', (result, sql, data, queryBuilder) => {
-    console.log('[HOOK] QueryBuilder después de UPDATE', { affectedRows: result });
-  });
-
-  // Hook para antes de ejecutar una eliminación
-  hooks.addAction('query_builder_before_delete', (sql, params, queryBuilder) => {
-    console.log('[HOOK] QueryBuilder antes de DELETE', { sql, params });
-  });
-
-  // Hook para después de ejecutar una eliminación
-  hooks.addAction('query_builder_after_delete', (result, sql, params, queryBuilder) => {
-    console.log('[HOOK] QueryBuilder después de DELETE', { affectedRows: result });
-  });
-
-  // Filter para modificar la consulta antes de ejecutarla
-  hooks.addFilter('query_builder_modify_query', (queryData, operation) => {
-    const { sql, params } = queryData;
-    
-    // Ejemplo: añadir comentario con la operación realizada
-    const modifiedSql = `${sql} /* JERK QueryBuilder: ${operation} */`;
-    
-    return { sql: modifiedSql, params };
-  });
-
-  // Filter para transformar resultados antes de devolverlos
-  hooks.addFilter('query_builder_transform_results', (results, operation, queryBuilder) => {
-    // Añadir metadatos a los resultados si es una operación de selección
-    if (operation === 'select' && Array.isArray(results)) {
-      return {
-        data: results,
-        metadata: {
-          count: results.length,
-          operation: operation,
-          timestamp: new Date().toISOString()
-        }
-      };
-    }
-    
-    return results;
-  });
-
-  // Hook para cuando ocurre un error en una consulta
-  hooks.addAction('query_builder_error', (error, sql, params, queryBuilder, operation) => {
-    console.error('[HOOK] QueryBuilder error en operación', { 
-      operation, 
-      error: error.message, 
-      sql, 
-      params 
-    });
-  });
-
-  // Hook para auditoría de consultas
-  hooks.addAction('query_builder_audit', (operation, sql, params, queryBuilder, executionTime) => {
-    console.log('[AUDIT] QueryBuilder operación auditada', {
-      operation,
-      executionTime: `${executionTime}ms`,
-      sqlPreview: sql.substring(0, 100) + (sql.length > 100 ? '...' : '')
-    });
-  });
-
-  // Filter para aplicar reglas de seguridad a las consultas
-  hooks.addFilter('query_builder_security_check', (queryData, operation, queryBuilder) => {
-    const { sql, params } = queryData;
-    
-    // Verificar si la consulta contiene patrones potencialmente peligrosos
-    const dangerousPatterns = ['DROP ', 'TRUNCATE ', 'ALTER ', '--', '/*'];
-    
-    for (const pattern of dangerousPatterns) {
-      if (sql.toUpperCase().includes(pattern)) {
-        throw new Error(`Consulta bloqueada por seguridad: contiene '${pattern}'`);
-      }
-    }
-    
-    return queryData;
-  });
-
-  // Filter para aplicar límites de rendimiento
-  hooks.addFilter('query_builder_performance_limit', (queryData, operation, queryBuilder) => {
-    // Este filter podría ser usado para aplicar límites de rendimiento
-    // basados en la complejidad de la consulta
-    return queryData;
-  });
-}
-
-// Función para extender el QueryBuilder con funcionalidad de hooks
-function extendQueryBuilderWithHooks(QueryBuilder, hooks) {
-  if (!QueryBuilder || !hooks) {
-    throw new Error('Se requieren QueryBuilder y hooks para extender funcionalidad');
-  }
-
-  // Guardar métodos originales
-  const originalGet = QueryBuilder.prototype.get;
-  const originalFirst = QueryBuilder.prototype.first;
-  const originalInsert = QueryBuilder.prototype.insert;
-  const originalUpdate = QueryBuilder.prototype.update;
-  const originalDelete = QueryBuilder.prototype.delete;
-
-  // Extender el método get con hooks
-  QueryBuilder.prototype.get = async function() {
-    const startTime = Date.now();
-    
-    // Disparar hook antes de la consulta
-    hooks.doAction('query_builder_before_select', this.toSQL().sql, this.toSQL().params, this);
-    
-    try {
-      // Modificar la consulta si es necesario usando filters
-      const originalSQLData = this.toSQL();
-      const modifiedSQLData = hooks.applyFilters(
-        'query_builder_modify_query', 
-        originalSQLData, 
-        'select'
-      );
-      
-      // Ejecutar la consulta original
-      const results = await originalGet.call(this);
-      
-      // Transformar resultados si es necesario
-      const transformedResults = hooks.applyFilters(
-        'query_builder_transform_results', 
-        results, 
-        'select', 
-        this
-      );
-      
-      // Calcular tiempo de ejecución
-      const executionTime = Date.now() - startTime;
-      
-      // Disparar hook después de la consulta
-      hooks.doAction(
-        'query_builder_after_select', 
-        results, 
-        modifiedSQLData.sql, 
-        modifiedSQLData.params, 
-        this
-      );
-      
-      // Disparar hook de auditoría
-      hooks.doAction(
-        'query_builder_audit', 
-        'select', 
-        modifiedSQLData.sql, 
-        modifiedSQLData.params, 
-        this, 
-        executionTime
-      );
-      
-      return transformedResults;
-    } catch (error) {
-      // Disparar hook de error
-      hooks.doAction(
-        'query_builder_error', 
-        error, 
-        this.toSQL().sql, 
-        this.toSQL().params, 
-        this, 
-        'select'
-      );
-      
-      throw error;
-    }
-  };
-
-  // Extender el método first con hooks
-  QueryBuilder.prototype.first = async function() {
-    const startTime = Date.now();
-    
-    // Disparar hook antes de la consulta
-    hooks.doAction('query_builder_before_select', this.toSQL().sql, this.toSQL().params, this);
-    
-    try {
-      // Modificar la consulta si es necesario usando filters
-      const originalSQLData = this.toSQL();
-      const modifiedSQLData = hooks.applyFilters(
-        'query_builder_modify_query', 
-        originalSQLData, 
-        'select_first'
-      );
-      
-      // Ejecutar la consulta original
-      const result = await originalFirst.call(this);
-      
-      // Transformar resultados si es necesario
-      const transformedResult = hooks.applyFilters(
-        'query_builder_transform_results', 
-        result, 
-        'select_first', 
-        this
-      );
-      
-      // Calcular tiempo de ejecución
-      const executionTime = Date.now() - startTime;
-      
-      // Disparar hook después de la consulta
-      hooks.doAction(
-        'query_builder_after_select', 
-        [result], 
-        modifiedSQLData.sql, 
-        modifiedSQLData.params, 
-        this
-      );
-      
-      // Disparar hook de auditoría
-      hooks.doAction(
-        'query_builder_audit', 
-        'select_first', 
-        modifiedSQLData.sql, 
-        modifiedSQLData.params, 
-        this, 
-        executionTime
-      );
-      
-      return transformedResult;
-    } catch (error) {
-      // Disparar hook de error
-      hooks.doAction(
-        'query_builder_error', 
-        error, 
-        this.toSQL().sql, 
-        this.toSQL().params, 
-        this, 
-        'select_first'
-      );
-      
-      throw error;
-    }
-  };
-
-  // Extender el método insert con hooks
-  QueryBuilder.prototype.insert = async function(data) {
-    const startTime = Date.now();
-    
-    // Aplicar chequeo de seguridad
-    const queryData = {
-      sql: `INSERT INTO \`${this.tableName}\``, 
-      params: Object.values(data)
-    };
-    
-    const secureQueryData = hooks.applyFilters(
-      'query_builder_security_check', 
-      queryData, 
-      'insert', 
-      this
-    );
-    
-    // Disparar hook antes de la inserción
-    hooks.doAction('query_builder_before_insert', secureQueryData.sql, data, this);
-    
-    try {
-      // Ejecutar la inserción original
-      const result = await originalInsert.call(this, data);
-      
-      // Calcular tiempo de ejecución
-      const executionTime = Date.now() - startTime;
-      
-      // Disparar hook después de la inserción
-      hooks.doAction('query_builder_after_insert', result, secureQueryData.sql, data, this);
-      
-      // Disparar hook de auditoría
-      hooks.doAction(
-        'query_builder_audit', 
-        'insert', 
-        secureQueryData.sql, 
-        secureQueryData.params, 
-        this, 
-        executionTime
-      );
-      
-      return result;
-    } catch (error) {
-      // Disparar hook de error
-      hooks.doAction(
-        'query_builder_error', 
-        error, 
-        secureQueryData.sql, 
-        secureQueryData.params, 
-        this, 
-        'insert'
-      );
-      
-      throw error;
-    }
-  };
-
-  // Extender el método update con hooks
-  QueryBuilder.prototype.update = async function(data) {
-    const startTime = Date.now();
-    
-    // Aplicar chequeo de seguridad
-    const queryData = {
-      sql: `UPDATE \`${this.tableName}\``, 
-      params: [...Object.values(data), ...this.parameters]
-    };
-    
-    const secureQueryData = hooks.applyFilters(
-      'query_builder_security_check', 
-      queryData, 
-      'update', 
-      this
-    );
-    
-    // Disparar hook antes de la actualización
-    hooks.doAction('query_builder_before_update', secureQueryData.sql, data, this);
-    
-    try {
-      // Ejecutar la actualización original
-      const result = await originalUpdate.call(this, data);
-      
-      // Calcular tiempo de ejecución
-      const executionTime = Date.now() - startTime;
-      
-      // Disparar hook después de la actualización
-      hooks.doAction('query_builder_after_update', result, secureQueryData.sql, data, this);
-      
-      // Disparar hook de auditoría
-      hooks.doAction(
-        'query_builder_audit', 
-        'update', 
-        secureQueryData.sql, 
-        secureQueryData.params, 
-        this, 
-        executionTime
-      );
-      
-      return result;
-    } catch (error) {
-      // Disparar hook de error
-      hooks.doAction(
-        'query_builder_error', 
-        error, 
-        secureQueryData.sql, 
-        secureQueryData.params, 
-        this, 
-        'update'
-      );
-      
-      throw error;
-    }
-  };
-
-  // Extender el método delete con hooks
-  QueryBuilder.prototype.delete = async function() {
-    const startTime = Date.now();
-    
-    // Aplicar chequeo de seguridad
-    const originalSQLData = this.toSQL();
-    const secureQueryData = hooks.applyFilters(
-      'query_builder_security_check', 
-      originalSQLData, 
-      'delete', 
-      this
-    );
-    
-    // Disparar hook antes de la eliminación
-    hooks.doAction('query_builder_before_delete', secureQueryData.sql, secureQueryData.params, this);
-    
-    try {
-      // Ejecutar la eliminación original
-      const result = await originalDelete.call(this);
-      
-      // Calcular tiempo de ejecución
-      const executionTime = Date.now() - startTime;
-      
-      // Disparar hook después de la eliminación
-      hooks.doAction('query_builder_after_delete', result, secureQueryData.sql, secureQueryData.params, this);
-      
-      // Disparar hook de auditoría
-      hooks.doAction(
-        'query_builder_audit', 
-        'delete', 
-        secureQueryData.sql, 
-        secureQueryData.params, 
-        this, 
-        executionTime
-      );
-      
-      return result;
-    } catch (error) {
-      // Disparar hook de error
-      hooks.doAction(
-        'query_builder_error', 
-        error, 
-        secureQueryData.sql, 
-        secureQueryData.params, 
-        this, 
-        'delete'
-      );
-      
-      throw error;
-    }
-  };
-}
-
-module.exports = {
-  initializeQueryBuilderHooks,
-  extendQueryBuilderWithHooks
-};