jerkjs 2.3.0 → 2.4.0

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # CHANGELOG
 
+## v2.3.1 - 21 de enero de 2026
+
+### Fixed
+- **Referencias circulares en QueryBuilder**: Se ha corregido un problema de referencias circulares en queryBuilder.js que podía causar problemas de memoria y dificultades en la carga de módulos. La corrección implica cambiar la forma en que se importa el sistema de hooks para evitar la carga circular entre módulos.
+
 ## v2.3.0 - 21 de enero de 2026
 
 ### Added

package/README.md

@@ -1,10 +1,10 @@
-# JERK Framework v2.3.0
+# JERK Framework v2.3.1
 
-![JERK Framework Logo](jerk.jpg)
+![JERK Framework Logo](jerk.webg)
 
 **¿Nuevo en JERK? Comienza tu proyecto rápidamente con nuestro Starter Kit**
 
-Nuestro Starter Kit en `@standard/server.js` es la forma más rápida de comenzar con JERK. Viene con todas las funcionalidades del framework ya configuradas, permitiéndote concentrarte en desarrollar tu aplicación en lugar de configurar infraestructura.
+Nuestro Starter Kit en `standard/server.js` es la forma más rápida de comenzar con JERK. Viene con todas las funcionalidades del framework ya configuradas, permitiéndote concentrarte en desarrollar tu aplicación en lugar de configurar infraestructura.
 
 **Características del Starter Kit:**
 - Configuración lista para usar con todos los componentes principales

package/index.js

@@ -47,11 +47,10 @@ const ModelControllerExample = require('./lib/mvc/ModelControllerExample');
 
 // Componentes de manejo de errores
 const { ErrorHandler, ValidationError, AuthenticationError, DatabaseError } = require('./lib/utils/errorHandler');
+// Componentes del QueryBuilder (v2.3.0) - MODIFICADO PARA USAR QBUILDERJS
+const QueryBuilder = require('qbuilderjs');
+// No hay middleware ni hooks ya que se eliminó la implementación interna
 
-// Componentes del QueryBuilder (v2.8.0)
-const QueryBuilder = require('./lib/query/queryBuilder');
-const QueryBuilderMiddleware = require('./lib/query/queryBuilderMiddleware');
-const { initializeQueryBuilderHooks, extendQueryBuilderWithHooks } = require('./lib/query/queryBuilderHooks');
 
 // Exportar todos los componentes del framework
 module.exports = {
@@ -96,6 +95,8 @@ module.exports = {
   // Componentes de modelo (v2.4.0)
   ModelBase,
   ModelManager,
+  // Componentes del QueryBuilder (v2.3.0) 
+  QueryBuilder,
   UserModel,
 
   // Adaptadores de modelo (v2.5.0)
@@ -110,13 +111,7 @@ module.exports = {
   ErrorHandler,
   ValidationError,
   AuthenticationError,
-  DatabaseError,
-
-  // Componentes del QueryBuilder (v2.8.0)
-  QueryBuilder,
-  QueryBuilderMiddleware,
-  initializeQueryBuilderHooks,
-  extendQueryBuilderWithHooks
+  DatabaseError
 };
 
 // También exportar clases individuales por conveniencia

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jerkjs",
-  "version": "2.3.0",
-  "description": "JERK Framework v2.3 - A comprehensive framework for building secure and scalable APIs with frontend support, sessions, template engine, QueryBuilder, and complete MVC architecture with models",
+  "version": "2.4.0",
+  "description": "JERK Framework v2.3.1 - A comprehensive framework for building secure and scalable APIs with frontend support, sessions, template engine, QueryBuilder, and complete MVC architecture with models",
   "main": "index.js",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",
@@ -39,6 +39,7 @@
   },
   "homepage": "https://jerk.page.gd/",
   "dependencies": {
+    "qbuilderjs":"^1.0.1",
     "bcrypt": "^6.0.0",
     "jsonwebtoken": "^9.0.3",
     "mariadb": "^3.4.5",

package/README_EN.md

@@ -1,230 +0,0 @@
-# JERK Framework v2.3.0
-
-![JERK Framework Logo](jerk.jpg)
-
-**New to JERK? Start your project quickly with our Starter Kit**
-
-Our Starter Kit at `@standard/server.js` is the fastest way to get started with JERK. It comes with all framework functionalities already configured, allowing you to focus on developing your application instead of setting up infrastructure.
-
-**Features of the Starter Kit:**
-- Ready-to-use configuration with all main components
-- Route loading from JSON file (`routes.json`)
-- Preconfigured controller system
-- Essential middlewares already integrated (authentication, CORS, compression, firewall, etc.)
-- Implemented logging and error handling system
-
-**How to get started:**
-1. Edit the `routes.json` file to define your routes and associate them with your controllers
-
-Basic example of `routes.json`:
-```json
-[
-  {
-    "path": "/",
-    "method": "GET",
-    "controller": "HomeController",
-    "handler": "index",
-    "contentType": "text/html"
-  },
-  {
-    "path": "/api/users",
-    "method": "GET",
-    "controller": "UserController",
-    "handler": "getAllUsers",
-    "contentType": "application/json"
-  }
-]
-```
-
-2. Create your controllers according to the defined routes
-
-For example, for the main route "/", create a `HomeController.js` file:
-```javascript
-class HomeController {
-  index(req, res) {
-    res.render('index.html', { data: 'Hello' });
-  }
-}
-
-module.exports = new HomeController();
-```
-
-3. Your application is ready to use!
-
-The Starter Kit includes sample controllers so you can see how the system works.
-
-Visit our website: https://jerk.page.gd/
-Official repository: https://gitlab.com/bytedogssyndicate1/jerk/
-
-## Features
-
-- **Modular Architecture**: Independent components for greater flexibility
-- **Advanced Security**: Built-in firewall (WAF) with attack detection
-- **Hook System**: Similar to WordPress system for extensibility
-- **Flexible Authentication**: Support for JWT, API Keys, Basic Auth, OAuth2, OpenID Connect
-- **Token Storage**: Support for memory, JSON, SQLite and MariaDB
-- **Advanced Routing**: Support for parameterized and nested routes
-- **Frontend Support**: Ability to serve HTML content and other content types
-- **Content-Type Configuration**: Specification of Content-Type headers in routes.json
-- **Integrated Middlewares**: CORS, rate limiting, compression, firewall, etc.
-- **Controller Management**: Dynamic loading of controllers from files
-- **Route Loading**: Definition of routes from JSON files
-- **Session System**: Complete session management with authentication support
-- **MVC Template Engine**: Professional view system with support for filters, helpers and hooks
-- **Extensibility**: Hook and filter system for customization
-
-## Installation
-
-```bash
-npm install jerkjs
-```
-
-## Basic Usage
-
-```javascript
-const { APIServer, Router, Logger } = require('jerkjs');
-
-// Create server instance
-const server = new APIServer({
-  port: 3000,
-  host: 'localhost'
-});
-
-// Create logger instance
-const logger = new Logger({ level: 'info' });
-
-// Define routes
-server.addRoute('GET', '/', (req, res) => {
-  res.writeHead(200, { 'Content-Type': 'application/json' });
-  res.end(JSON.stringify({ message: 'Hello World!' }));
-});
-
-// Start the server
-server.start();
-```
-
-## Main Components
-
-### APIServer
-Basic HTTP/HTTPS server with support for parameterized routes, middlewares and advanced configuration.
-
-### Router
-Advanced routing system with support for nested routes and prefixes.
-
-### Authenticator
-Authentication middleware with support for multiple methods (JWT, API Keys, Basic Auth, OAuth2, OpenID Connect).
-
-### SecurityEnhancedServer
-Server with integrated advanced security features (WAF).
-
-### RouteLoader
-Loading of routes from JSON files with support for authentication, controllers and content-type specification.
-
-### TokenManager
-JWT token management with different storage types (memory, JSON, SQLite, MariaDB).
-
-### Firewall
-Firewall middleware with attack pattern detection and white/black lists.
-
-### Hooks System
-Hook and filter system similar to WordPress for extensibility.
-
-### SessionManager
-Complete session management system with session-based authentication support.
-
-### ViewEngine
-Professional template engine with support for filters, helpers, conditions, loops and hooks.
-
-### ControllerBase
-Base controller that facilitates the development of MVC controllers with view support.
-
-## Security
-
-The framework includes multiple layers of security:
-
-- **Web Application Firewall (WAF)**: Detection of SQL injection, XSS, path traversal, etc.
-- **Rate Limiting**: Request limitation by IP or user
-- **Firewall**: Automatic blocking by failed attempts
-- **White/Black Lists**: Access control by IP
-- **Security Auditing**: Event logging
-- **Robust Authentication**: Support for multiple authentication methods
-
-## Hook System
-
-The framework includes a hook and filter system similar to WordPress:
-
-```javascript
-const { hooks } = require('jerkjs');
-
-// Register an action
-hooks.addAction('firewall_request_blocked', (rule, clientIP, req, res) => {
-  console.log(`Blocked request: ${rule.name} for IP: ${clientIP}`);
-});
-
-// Register a filter
-hooks.addFilter('session_create_data', (userData, req) => {
-  return {
-    ...userData,
-    ipAddress: req.headers['x-forwarded-for'] || req.connection.remoteAddress,
-    createdAt: new Date().toISOString()
-  };
-});
-```
-
-## MVC Template Engine
-
-The framework includes a professional template engine with support for:
-
-- Variables: `{{variable}}`
-- Conditions: `{{if variable}}content{{endif}}`
-- Loops: `{{foreach:array}}content{{endforeach}}`
-- Includes: `{{include:header}}`
-- Filters: `{{variable|upper}}`
-- Custom helpers
-
-## Session Management
-
-The framework includes a complete session management system:
-
-```javascript
-const { SessionManager } = require('jerkjs');
-
-const sessionManager = new SessionManager({
-  secret: 'your-session-secret',
-  timeout: 3600000 // 1 hour
-});
-
-// Use as middleware
-server.use(sessionManager.middleware());
-```
-
-## Examples
-
-The project includes several complete examples:
-
-- **v2_json_auth**: JWT authentication with tokens stored in JSON
-- **v2_mariadb_auth**: JWT authentication with tokens stored in MariaDB
-- **v2_sqlite_auth**: JWT authentication with tokens stored in SQLite
-- **public**: Sample public API with CORS and rate limiting
-- **frontend**: Server example that combines API and frontend with different content-types
-- **hooks**: Advanced example of hook system usage with logging and request tracking
-
-To see the complete examples, visit the `v2examplle/` and `examples/` directories.
-
-## Documentation
-
-In addition to the documentation in the README, the project includes additional documentation:
-
-- **Quick start guide**: `docs/guia_inicio_rapido_jerkjs.md` - A complete guide to getting started quickly with JERKJS, including file formats, controller structure, template engine and hook system.
-
-## Contributions
-
-Contributions are welcome. Please open an issue or submit a pull request on GitLab.
-
-## License
-
-Apache 2.0
-
-## Framework Documentation
-
-For a detailed description of the framework architecture and components, see the [JERK_FRAMEWORK_DOCUMENTATION.md](JERK_FRAMEWORK_DOCUMENTATION.md) file.

package/README_PT.md

@@ -1,230 +0,0 @@
-# JERK Framework v2.3.0
-
-![JERK Framework Logo](jerk.jpg)
-
-**Novo no JERK? Comece seu projeto rapidamente com nosso Kit Inicial**
-
-Nosso Kit Inicial em `@standard/server.js` é a forma mais rápida de começar com o JERK. Ele vem com todas as funcionalidades do framework já configuradas, permitindo que você se concentre em desenvolver sua aplicação em vez de configurar infraestrutura.
-
-**Recursos do Kit Inicial:**
-- Configuração pronta para uso com todos os componentes principais
-- Carregamento de rotas a partir de arquivo JSON (`routes.json`)
-- Sistema de controladores pré-configurado
-- Middlewares essenciais já integrados (autenticação, CORS, compressão, firewall, etc.)
-- Sistema de logging e tratamento de erros implementado
-
-**Como começar:**
-1. Edite o arquivo `routes.json` para definir suas rotas e associá-las aos seus controladores
-
-Exemplo básico de `routes.json`:
-```json
-[
-  {
-    "path": "/",
-    "method": "GET",
-    "controller": "HomeController",
-    "handler": "index",
-    "contentType": "text/html"
-  },
-  {
-    "path": "/api/users",
-    "method": "GET",
-    "controller": "UserController",
-    "handler": "getAllUsers",
-    "contentType": "application/json"
-  }
-]
-```
-
-2. Crie seus controladores de acordo com as rotas definidas
-
-Por exemplo, para a rota principal "/", crie um arquivo `HomeController.js`:
-```javascript
-class HomeController {
-  index(req, res) {
-    res.render('index.html', { data: 'Olá' });
-  }
-}
-
-module.exports = new HomeController();
-```
-
-3. Sua aplicação está pronta para usar!
-
-O Kit Inicial inclui controladores de exemplo para que você possa ver como o sistema funciona.
-
-Visite nosso site: https://jerk.page.gd/
-Repositório oficial: https://gitlab.com/bytedogssyndicate1/jerk/
-
-## Recursos
-
-- **Arquitetura Modular**: Componentes independentes para maior flexibilidade
-- **Segurança Avançada**: Firewall integrado (WAF) com detecção de ataques
-- **Sistema de Hooks**: Semelhante ao sistema do WordPress para extensibilidade
-- **Autenticação Flexível**: Suporte para JWT, API Keys, Basic Auth, OAuth2, OpenID Connect
-- **Armazenamento de Tokens**: Suporte para memória, JSON, SQLite e MariaDB
-- **Roteamento Avançado**: Suporte para rotas parametrizadas e aninhadas
-- **Suporte para Frontend**: Capacidade de servir conteúdo HTML e outros tipos de conteúdo
-- **Configuração de Content-Type**: Especificação de cabeçalhos Content-Type em routes.json
-- **Middlewares Integrados**: CORS, limitação de taxa, compressão, firewall, etc.
-- **Gerenciamento de Controladores**: Carregamento dinâmico de controladores a partir de arquivos
-- **Carregamento de Rotas**: Definição de rotas a partir de arquivos JSON
-- **Sistema de Sessões**: Gerenciamento completo de sessões com suporte para autenticação
-- **Mecanismo de Templates MVC**: Sistema profissional de visualização com suporte para filtros, helpers e hooks
-- **Extensibilidade**: Sistema de hooks e filtros para personalização
-
-## Instalação
-
-```bash
-npm install jerkjs
-```
-
-## Uso Básico
-
-```javascript
-const { APIServer, Router, Logger } = require('jerkjs');
-
-// Criar instância do servidor
-const server = new APIServer({
-  port: 3000,
-  host: 'localhost'
-});
-
-// Criar instância do logger
-const logger = new Logger({ level: 'info' });
-
-// Definir rotas
-server.addRoute('GET', '/', (req, res) => {
-  res.writeHead(200, { 'Content-Type': 'application/json' });
-  res.end(JSON.stringify({ message: 'Olá Mundo!' }));
-});
-
-// Iniciar o servidor
-server.start();
-```
-
-## Componentes Principais
-
-### APIServer
-Servidor HTTP/HTTPS básico com suporte para rotas parametrizadas, middlewares e configuração avançada.
-
-### Router
-Sistema de roteamento avançado com suporte para rotas aninhadas e prefixos.
-
-### Authenticator
-Middleware de autenticação com suporte para múltiplos métodos (JWT, API Keys, Basic Auth, OAuth2, OpenID Connect).
-
-### SecurityEnhancedServer
-Servidor com recursos de segurança avançada (WAF) integrados.
-
-### RouteLoader
-Carregamento de rotas a partir de arquivos JSON com suporte para autenticação, controladores e especificação de tipo de conteúdo.
-
-### TokenManager
-Gerenciamento de tokens JWT com diferentes tipos de armazenamento (memória, JSON, SQLite, MariaDB).
-
-### Firewall
-Middleware de firewall com detecção de padrões de ataque e listas brancas/negras.
-
-### Sistema de Hooks
-Sistema de hooks e filtros semelhante ao WordPress para extensibilidade.
-
-### SessionManager
-Sistema completo de gerenciamento de sessões com suporte para autenticação baseada em sessões.
-
-### ViewEngine
-Mecanismo de templates profissional com suporte para filtros, helpers, condições, loops e hooks.
-
-### ControllerBase
-Controlador base que facilita o desenvolvimento de controladores MVC com suporte para visualizações.
-
-## Segurança
-
-O framework inclui múltiplas camadas de segurança:
-
-- **Web Application Firewall (WAF)**: Detecção de injeção SQL, XSS, travessia de caminho, etc.
-- **Limitação de Taxa**: Limitação de requisições por IP ou usuário
-- **Firewall**: Bloqueio automático por tentativas falhas
-- **Listas Brancas/Negras**: Controle de acesso por IP
-- **Auditoria de Segurança**: Registro de eventos de segurança
-- **Autenticação Robusta**: Suporte para múltiplos métodos de autenticação
-
-## Sistema de Hooks
-
-O framework inclui um sistema de hooks e filtros semelhante ao WordPress:
-
-```javascript
-const { hooks } = require('jerkjs');
-
-// Registrar uma ação
-hooks.addAction('firewall_request_blocked', (rule, clientIP, req, res) => {
-  console.log(`Solicitação bloqueada: ${rule.name} para IP: ${clientIP}`);
-});
-
-// Registrar um filtro
-hooks.addFilter('session_create_data', (userData, req) => {
-  return {
-    ...userData,
-    ipAddress: req.headers['x-forwarded-for'] || req.connection.remoteAddress,
-    createdAt: new Date().toISOString()
-  };
-});
-```
-
-## Mecanismo de Templates MVC
-
-O framework inclui um mecanismo de templates profissional com suporte para:
-
-- Variáveis: `{{variable}}`
-- Condições: `{{if variable}}conteúdo{{endif}}`
-- Loops: `{{foreach:array}}conteúdo{{endforeach}}`
-- Inclusões: `{{include:header}}`
-- Filtros: `{{variable|upper}}`
-- Helpers personalizados
-
-## Gerenciamento de Sessões
-
-O framework inclui um sistema completo de gerenciamento de sessões:
-
-```javascript
-const { SessionManager } = require('jerkjs');
-
-const sessionManager = new SessionManager({
-  secret: 'your-session-secret',
-  timeout: 3600000 // 1 hora
-});
-
-// Usar como middleware
-server.use(sessionManager.middleware());
-```
-
-## Exemplos
-
-O projeto inclui vários exemplos completos:
-
-- **v2_json_auth**: Autenticação JWT com tokens armazenados em JSON
-- **v2_mariadb_auth**: Autenticação JWT com tokens armazenados em MariaDB
-- **v2_sqlite_auth**: Autenticação JWT com tokens armazenados em SQLite
-- **public**: API pública de exemplo com CORS e limitação de taxa
-- **frontend**: Exemplo de servidor que combina API e frontend com diferentes tipos de conteúdo
-- **hooks**: Exemplo avançado de uso do sistema de hooks com logging e rastreamento de solicitações
-
-Para ver os exemplos completos, visite os diretórios `v2examplle/` e `examples/`.
-
-## Documentação
-
-Além da documentação no README, o projeto inclui documentação adicional:
-
-- **Guia de início rápido**: `docs/guia_inicio_rapido_jerkjs.md` - Um guia completo para começar rapidamente com o JERKJS, incluindo formatos de arquivos, estrutura de controladores, mecanismo de templates e sistema de hooks.
-
-## Contribuições
-
-As contribuições são bem-vindas. Por favor, abra uma issue ou envie um pull request no GitLab.
-
-## Licença
-
-Apache 2.0
-
-## Documentação do Framework
-
-Para uma descrição detalhada da arquitetura e componentes do framework, consulte o arquivo [JERK_FRAMEWORK_DOCUMENTATION.md](JERK_FRAMEWORK_DOCUMENTATION.md).

package/jerk-qbuilder/CHANGELOG.md

@@ -1,71 +0,0 @@
-# Changelog
-
-Todos los cambios importantes en este proyecto se documentarán en este archivo.
-
-El formato está basado en [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-y este proyecto adhiere al [Versionado Semántico](https://semver.org/spec/v2.0.0.html).
-
-## [Versión 1.0.0] - 2026-01-21
-
-### Cambios Importantes
-
-#### 🚀 Características Nuevas
-
-- **QueryBuilder principal**
-  - Implementación completa del QueryBuilder con API fluida
-  - Métodos para SELECT, INSERT, UPDATE, DELETE
-  - Soporte para condiciones WHERE, JOINs, GROUP BY, ORDER BY
-  - Paginación con LIMIT y OFFSET
-  - Funciones de agregación (COUNT, MAX, MIN, SUM, AVG)
-
-- **Método setAdapter()**
-  - Implementación del método `setAdapter(adapter)` para configurar dinámicamente cualquier adaptador
-  - Permite cambiar de base de datos en tiempo de ejecución
-  - Compatible con múltiples sistemas de base de datos
-
-- **Adaptador MariaDB**
-  - Implementación del adaptador para MariaDB/MySQL
-  - Conexión mediante pool de conexiones
-  - Ejecución segura de consultas SQL
-
-- **Adaptador de Consola**
-  - Adaptador de ejemplo para mostrar consultas SQL por consola
-  - Útil para pruebas y desarrollo
-  - Simula resultados de consultas
-
-- **Middleware de Integración**
-  - Sistema completo para inyectar QueryBuilder en solicitudes HTTP
-  - Middleware para configurar adaptadores
-  - Middleware para registrar QueryBuilder con hooks
-  - Middleware para habilitar registro de consultas
-  - Middleware para aplicar reglas de seguridad
-
-- **Sistema de Hooks**
-  - Integración completa con el sistema de hooks de JERK
-  - Acciones y filtros para eventos del QueryBuilder
-  - Sistema de auditoría de consultas
-  - Aplicación de reglas de seguridad
-
-#### 🔧 Cambios Técnicos
-
-- **Arquitectura modular**
-  - Estructura de archivos separados para cada componente
-  - Dependencias claras entre módulos
-  - Código organizado y mantenible
-
-- **Seguridad mejorada**
-  - Prevención de inyección SQL mediante el uso de parámetros
-  - Sistema de validación de consultas
-  - Reglas de seguridad configurables
-
-- **Documentación completa**
-  - README.md con descripción general
-  - HOWTO.md con instrucciones detalladas de uso
-  - Ejemplos prácticos de implementación
-
-#### 📝 Otros Cambios
-
-- **Ejemplos de uso**
-  - Aplicación de demostración completa
-  - Ejemplos de integración con JERK Framework
-  - Casos de uso prácticos con base de datos real