jerkjs 2.1.7 → 2.2.0

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # CHANGELOG
 
+## v2.2.0 - 20 de enero de 2026
+
+### Added
+- **Arquitectura completa de modelos (MVC)**: Se ha implementado la capa de modelos para completar el patrón MVC, incluyendo ModelBase, ModelManager y modelos específicos
+- **Sistema de adaptadores de base de datos**: Se ha creado un sistema flexible de adaptadores que permite conectar con diferentes tipos de bases de datos (MariaDB, MySQL, memoria, etc.)
+- **Nuevo adaptador MariaDB**: Se ha implementado un adaptador específico para conexión a bases de datos MariaDB/MySQL
+- **Modelos específicos**: Se han creado modelos específicos para diferentes entidades con métodos especializados para consultas complejas
+- **Integración con sistema de hooks**: Los modelos participan en el sistema de hooks del framework para extensibilidad
+- **Comunicación bidireccional entre modelos y controladores**: Se ha implementado un sistema para que modelos y controladores se comuniquen entre sí
+- **Soporte para consultas avanzadas**: Los modelos incluyen soporte para paginación, filtros, búsqueda global y operaciones CRUD completas
+- **Validación de datos en modelos**: Se ha implementado un sistema de validación de datos específico para cada modelo
+
+### Changed
+- **Actualización de la versión a 2.2.0**: Debido a la implementación significativa de la arquitectura de modelos
+- **Refactorización de componentes existentes**: Se han actualizado controladores y otros componentes para integrarse con la nueva arquitectura de modelos
+- **Mejora en la estructura interna**: La arquitectura ahora sigue completamente el patrón MVC
+
+## v2.1.8 - 20 de enero de 2026
+
+### Added
+- **Soporte completo para rutas estáticas**: Se ha implementado soporte completo para servir archivos estáticos desde rutas definidas en `routes.json` o mediante el método `addRoute()`
+- **Sistema de hooks para rutas estáticas**: Se han añadido múltiples hooks para rastrear el flujo completo de archivos estáticos
+- **Sistema de logging para hooks**: Se ha implementado un sistema de logging que registra todos los eventos de hooks en un archivo
+- **Soporte para layouts en ViewEngine**: Se ha añadido soporte para layouts con placeholder `{{content}}` en el sistema de vistas
+- **Mejoras en el sistema de enrutamiento**: Se han añadido mejoras para reconocer correctamente rutas estáticas como prefijos
+
+### Changed
+- **Actualización de documentación**: Se ha actualizado la documentación para reflejar las nuevas funcionalidades de rutas estáticas
+- **Optimización del sistema de rutas**: Mejora en la lógica de coincidencia de rutas para soportar rutas estáticas como prefijos
+
 ## v2.1.7 - 19 de enero de 2026
 
 ### Correcciones

package/README.md

@@ -1,4 +1,4 @@
-# JERK Framework v2.1.7
+# JERK Framework v2.2.0
 
 ![JERK Framework Logo](jerk.jpg)
 
@@ -12,6 +12,7 @@ Nuestro Starter Kit en `@standard/server.js` es la forma más rápida de comenza
 - Sistema de controladores preconfigurado
 - Middlewares esenciales ya integrados (autenticación, CORS, compresión, firewall, etc.)
 - Sistema de logging y manejo de errores implementado
+- **NUEVO: Arquitectura completa MVC con modelos y soporte para bases de datos**
 
 **Cómo comenzar:**
 1. Edita el archivo `routes.json` para definir tus rutas y asociarlas a tus controladores
@@ -49,10 +50,61 @@ class HomeController {
 module.exports = new HomeController();
 ```
 
-3. ¡Tu aplicación estará lista para usar!
+3. ¡Tu aplicación estará listo para usar!
 
 El Starter Kit incluye controladores de ejemplo para que puedas ver cómo funciona el sistema.
 
+## Ejemplo de Rutas Estáticas
+
+Desde la versión 2.1.8, JERK Framework soporta rutas estáticas para servir archivos desde directorios locales:
+
+### En routes.json:
+```json
+[
+  {
+    "path": "/static",
+    "method": "GET",
+    "static": {
+      "dir": "./public",
+      "index": ["index.html", "index.htm"],
+      "cacheControl": "public, max-age=3600"
+    }
+  },
+  {
+    "path": "/assets",
+    "method": "GET",
+    "static": {
+      "dir": "./public",
+      "index": [],
+      "cacheControl": "public, max-age=86400"
+    }
+  }
+]
+```
+
+### Usando addRoute():
+```javascript
+// Ruta estática para servir archivos desde ./public
+server.addRoute({
+  method: 'GET',
+  path: '/static',
+  static: {
+    dir: './public',
+    index: ['index.html'],
+    cacheControl: 'public, max-age=3600'
+  }
+});
+
+// Ruta estática para servir archivos JS, CSS e imágenes
+server.addRoute('GET', '/assets', {
+  static: {
+    dir: './public/assets',
+    index: [],
+    cacheControl: 'public, max-age=86400'
+  }
+});
+```
+
 Visita nuestra página web: https://jerk.page.gd/
 Repositorio oficial: https://gitlab.com/bytedogssyndicate1/jerk/
 
@@ -60,10 +112,10 @@ Repositorio oficial: https://gitlab.com/bytedogssyndicate1/jerk/
 
 - **Arquitectura Modular**: Componentes independientes para mayor flexibilidad
 - **Seguridad Avanzada**: Firewall integrado (WAF) con detección de ataques
-- **Sistema de Hooks**: Similar al sistema de WordPress para extensibilidad
+- **Sistema de Hooks**: Similar al sistema de WordPress para extensibility
 - **Autenticación Flexible**: Soporte para JWT, API Keys, Basic Auth, OAuth2, OpenID Connect
 - **Almacenamiento de Tokens**: Soporte para memoria, JSON, SQLite y MariaDB
-- **Enrutamiento Avanzado**: Soporte para rutas parametrizadas y anidadas
+- **Enrutamiento Avanzado**: Soporte para rutas parametrizadas, anidadas y estáticas
 - **Soporte para Frontend**: Capacidad de servir contenido HTML y otros tipos de contenido
 - **Configuración de Content-Type**: Especificación de headers Content-Type en routes.json
 - **Middlewares Integrados**: CORS, rate limiting, compresión, firewall, etc.
@@ -71,6 +123,9 @@ Repositorio oficial: https://gitlab.com/bytedogssyndicate1/jerk/
 - **Carga de Rutas**: Definición de rutas desde archivos JSON
 - **Sistema de Sesiones**: Gestión completa de sesiones con soporte para autenticación
 - **Motor de Plantillas MVC**: Sistema profesional de vistas con soporte para filtros, helpers y hooks
+- **Arquitectura de Modelos Completa (MVC)**: Capa de modelos para la lógica de negocio y acceso a datos
+- **Sistema de Adaptadores de Base de Datos**: Soporte para múltiples motores de base de datos (MariaDB, MySQL, etc.)
+- **Servicio de Archivos Estáticos**: Soporte para servir archivos desde directorios locales con configuración flexible
 - **Extensibilidad**: Sistema de hooks y filters para personalización
 
 ## Instalación
@@ -226,6 +281,148 @@ Las contribuciones son bienvenidas. Por favor, abre un issue o envía un pull re
 
 Apache 2.0
 
+## Arquitectura de Modelos (MVC)
+
+JERK Framework v2.2.0 introduce una arquitectura completa de modelos que completa el patrón MVC. Los modelos permiten encapsular la lógica de negocio y el acceso a datos en componentes reutilizables.
+
+### Ejemplo de Modelo Simple con MariaDB
+
+```javascript
+const { ModelBase, MariaDBAdapter } = require('jerkjs');
+
+// Definir un modelo para usuarios
+class UserModel extends ModelBase {
+  constructor(options = {}) {
+    super({
+      ...options,
+      tableName: options.tableName || 'users'
+    });
+
+    // Definir campos del modelo
+    this.fields = {
+      id: { type: 'integer', primaryKey: true, autoIncrement: true },
+      username: { type: 'string', required: true },
+      email: { type: 'string', required: true },
+      password: { type: 'string', required: true },
+      createdAt: { type: 'datetime', default: 'CURRENT_TIMESTAMP' }
+    };
+  }
+
+  // Método personalizado para encontrar usuario por email
+  async findByEmail(email) {
+    return await this.findOne({ email });
+  }
+
+  // Método personalizado para crear usuario con validación
+  async createUser(userData) {
+    // Validar datos antes de crear
+    const validation = this.validate('create', userData);
+    if (!validation.isValid) {
+      throw new Error(`Validación fallida: ${validation.errors.join(', ')}`);
+    }
+
+    return await this.create(userData);
+  }
+}
+
+// Configurar el adaptador de MariaDB
+const dbConfig = {
+  host: 'localhost',
+  user: 'tu_usuario',
+  password: 'tu_contraseña',
+  database: 'tu_base_de_datos'
+};
+
+const mariaDBAdapter = new MariaDBAdapter(dbConfig);
+
+// Crear instancia del modelo con el adaptador
+const userModel = new UserModel({
+  adapter: mariaDBAdapter,
+  tableName: 'users'
+});
+
+// Uso del modelo
+async function ejemploUsoModelo() {
+  try {
+    // Crear un nuevo usuario
+    const nuevoUsuario = await userModel.createUser({
+      username: 'juan.perez',
+      email: 'juan@example.com',
+      password: 'contraseña_segura'
+    });
+
+    console.log('Usuario creado:', nuevoUsuario);
+
+    // Buscar usuario por email
+    const usuario = await userModel.findByEmail('juan@example.com');
+    console.log('Usuario encontrado:', usuario);
+  } catch (error) {
+    console.error('Error:', error.message);
+  }
+}
+```
+
+### Uso de Modelos en Controladores con loadModel
+
+JERK Framework proporciona un helper `loadModel` en el ControllerBase para facilitar la carga y uso de modelos en los controladores:
+
+```javascript
+const ControllerBase = require('jerkjs').ControllerBase;
+
+class UserController extends ControllerBase {
+  constructor() {
+    super();
+
+    // Cargar el modelo de usuario
+    this.userModel = this.loadModel('UserModel', {
+      // Opciones del modelo
+    });
+  }
+
+  async getAllUsers(req, res) {
+    try {
+      // Usar el modelo para obtener usuarios
+      const users = await this.userModel.find({});
+
+      this.json(res, { success: true, data: users });
+    } catch (error) {
+      this.json(res, { success: false, error: error.message }, 500);
+    }
+  }
+
+  async getUserById(req, res) {
+    try {
+      const userId = req.params.id;
+
+      // Usar el modelo para encontrar un usuario específico
+      const user = await this.userModel.findOne({ id: userId });
+
+      if (!user) {
+        this.json(res, { success: false, error: 'Usuario no encontrado' }, 404);
+        return;
+      }
+
+      this.json(res, { success: true, data: user });
+    } catch (error) {
+      this.json(res, { success: false, error: error.message }, 500);
+    }
+  }
+
+  async createUser(req, res) {
+    try {
+      // Usar el modelo para crear un nuevo usuario
+      const newUser = await this.userModel.createUser(req.body);
+
+      this.json(res, { success: true, data: newUser }, 201);
+    } catch (error) {
+      this.json(res, { success: false, error: error.message }, 400);
+    }
+  }
+}
+
+module.exports = new UserController();
+```
+
 ## Documentación del Framework
 
 Para una descripción detallada de la arquitectura y componentes del framework, consulta el archivo [JERK_FRAMEWORK_DOCUMENTATION.md](JERK_FRAMEWORK_DOCUMENTATION.md).

package/index.js

@@ -1,8 +1,12 @@
 /**
  * Punto de entrada del framework JERK
- * JERK Framework v2.1.2
+ * JERK Framework 2.1.8
  */
 
+// Mostrar mensaje de versión al iniciar
+const packageInfo = require('./package.json');
+console.log(`JERK Framework v${packageInfo.version}`);
+
 const APIServer = require('./lib/core/server');
 const Router = require('./lib/core/router');
 const HandlerManager = require('./lib/core/handler');
@@ -33,6 +37,13 @@ const { SessionManager, sessionAuth } = require('./lib/middleware/session');
 // Componentes MVC
 const ViewEngine = require('./lib/mvc/viewEngine');
 const ControllerBase = require('./lib/mvc/controllerBase');
+const ModelBase = require('./lib/mvc/modelBase');
+const ModelManager = require('./lib/mvc/modelManager');
+const UserModel = require('./lib/mvc/userModel');
+const GenericAdapter = require('./lib/mvc/GenericAdapter');
+const MemoryAdapter = require('./lib/mvc/MemoryAdapter');
+const MariaDBAdapter = require('./lib/mvc/MariaDBAdapter');
+const ModelControllerExample = require('./lib/mvc/ModelControllerExample');
 
 // Componentes de manejo de errores
 const { ErrorHandler, ValidationError, AuthenticationError, DatabaseError } = require('./lib/utils/errorHandler');
@@ -77,7 +88,20 @@ module.exports = {
   ViewEngine,
   ControllerBase,
 
-  // Componentes de manejo de errores (v2.4.0)
+  // Componentes de modelo (v2.4.0)
+  ModelBase,
+  ModelManager,
+  UserModel,
+
+  // Adaptadores de modelo (v2.5.0)
+  GenericAdapter,
+  MemoryAdapter,
+  MariaDBAdapter,
+
+  // Ejemplo de controlador con modelos (v2.6.0)
+  ModelControllerExample,
+
+  // Componentes de manejo de errores (v2.7.0)
   ErrorHandler,
   ValidationError,
   AuthenticationError,
@@ -88,7 +112,8 @@ module.exports = {
 module.exports.JERK = APIServer;
 
 // Crear instancia global del sistema de hooks
-module.exports.hooks = new HookSystem();
+const hooksInstance = new HookSystem();
+module.exports.hooks = hooksInstance;
 
 // Disparar hooks de inicio del framework
-module.exports.hooks.doAction('framework_init');
+hooksInstance.doAction('framework_init');