jerkjs 2.5.6 → 2.6.1

package/lib/cache/CacheHooks.js

@@ -0,0 +1,141 @@
+/**
+ * Sistema de Hooks y Filters para el Manejo de Caché en JERK Framework
+ * Implementación del componente cache/cacheHooks.js
+ */
+
+class CacheHooks {
+  /**
+   * Constructor del sistema de hooks de caché
+   * @param {Object} hooksSystem - Instancia del sistema de hooks principal
+   */
+  constructor(hooksSystem) {
+    this.hooks = hooksSystem;
+    this.initializeCacheHooks();
+  }
+
+  /**
+   * Inicializa los hooks relacionados con el sistema de caché
+   */
+  initializeCacheHooks() {
+    // Hook para cuando se añade una entrada al caché de rutas
+    this.hooks.addAction('route_regex_cached', (path, regex) => {
+      console.log(`[CACHE] Expresión regular cacheada para ruta: ${path}`);
+    });
+
+    // Hook para cuando se añade una vista al caché
+    this.hooks.addAction('view_cached', (viewPath, content) => {
+      console.log(`[CACHE] Vista cacheada: ${viewPath}`);
+    });
+
+    // Hook para cuando se limpia el caché de rutas
+    this.hooks.addAction('route_cache_cleared', () => {
+      console.log('[CACHE] Caché de rutas limpiado');
+    });
+
+    // Hook para cuando se limpia el caché de vistas
+    this.hooks.addAction('view_cache_cleared', () => {
+      console.log('[CACHE] Caché de vistas limpiado');
+    });
+
+    // Filter para permitir modificar el contenido antes de ser cacheado
+    this.hooks.addFilter('before_view_cache', (content, viewPath) => {
+      // Permitir a otros módulos modificar el contenido antes de cachear
+      return content;
+    });
+
+    // Filter para permitir modificar la decisión de si se debe cachear una vista
+    this.hooks.addFilter('should_cache_view', (shouldCache, viewPath, content) => {
+      // Por defecto, se cachea si está habilitado globalmente
+      return shouldCache;
+    });
+
+    // Filter para permitir modificar la decisión de si se debe cachear una expresión regular
+    this.hooks.addFilter('should_cache_route_regex', (shouldCache, path, regex) => {
+      // Por defecto, se cachea si está habilitado globalmente
+      return shouldCache;
+    });
+  }
+
+  /**
+   * Dispara el hook cuando se añade una entrada al caché de rutas
+   * @param {string} path - Ruta que se está cacheando
+   * @param {RegExp} regex - Expresión regular que se está cacheando
+   */
+  triggerRouteRegexCached(path, regex) {
+    if (this.hooks) {
+      this.hooks.doAction('route_regex_cached', path, regex);
+    }
+  }
+
+  /**
+   * Dispara el hook cuando se añade una vista al caché
+   * @param {string} viewPath - Ruta de la vista que se está cacheando
+   * @param {string} content - Contenido de la vista que se está cacheando
+   */
+  triggerViewCached(viewPath, content) {
+    if (this.hooks) {
+      this.hooks.doAction('view_cached', viewPath, content);
+    }
+  }
+
+  /**
+   * Dispara el hook cuando se limpia el caché de rutas
+   */
+  triggerRouteCacheCleared() {
+    if (this.hooks) {
+      this.hooks.doAction('route_cache_cleared');
+    }
+  }
+
+  /**
+   * Dispara el hook cuando se limpia el caché de vistas
+   */
+  triggerViewCacheCleared() {
+    if (this.hooks) {
+      this.hooks.doAction('view_cache_cleared');
+    }
+  }
+
+  /**
+   * Aplica el filter antes de cachear una vista
+   * @param {string} content - Contenido de la vista
+   * @param {string} viewPath - Ruta de la vista
+   * @returns {string} - Contenido procesado por los filters
+   */
+  applyBeforeViewCacheFilter(content, viewPath) {
+    if (this.hooks) {
+      return this.hooks.applyFilters('before_view_cache', content, viewPath);
+    }
+    return content;
+  }
+
+  /**
+   * Aplica el filter para decidir si se debe cachear una vista
+   * @param {boolean} shouldCache - Valor por defecto
+   * @param {string} viewPath - Ruta de la vista
+   * @param {string} content - Contenido de la vista
+   * @returns {boolean} - Decisión final de si se debe cachear
+   */
+  applyShouldCacheViewFilter(shouldCache, viewPath, content) {
+    if (this.hooks) {
+      return this.hooks.applyFilters('should_cache_view', shouldCache, viewPath, content);
+    }
+    return shouldCache;
+  }
+
+  /**
+   * Aplica el filter para decidir si se debe cachear una expresión regular
+   * @param {boolean} shouldCache - Valor por defecto
+   * @param {string} path - Ruta para la que se va a cachear la expresión regular
+   * @param {RegExp} regex - Expresión regular a cachear
+   * @returns {boolean} - Decisión final de si se debe cachear
+   */
+  applyShouldCacheRouteRegexFilter(shouldCache, path, regex) {
+    if (this.hooks) {
+      return this.hooks.applyFilters('should_cache_route_regex', shouldCache, path, regex);
+    }
+    return shouldCache;
+  }
+}
+
+module.exports = CacheHooks;