jerkjs 2.0.0 → 2.0.1

package/LICENSE

@@ -1,4 +1,4 @@
-                                 Apache License
+Apache License
                            Version 2.0, January 2004
                         http://www.apache.org/licenses/
 
@@ -100,24 +100,25 @@
       (c) You must retain, in the Source form of any Derivative Works
           that You distribute, all copyright, patent, trademark, and
           attribution notices from the Source form of the Work,
-          excluding those notices that relate to any part of the
-          Derivative Works; and
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
 
       (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You create must
+          distribution, then any Derivative Works that You distribute must
           include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that relate to
-          any part of the Derivative Works, in at least one of the following
-          places: within a NOTICE text file distributed as part of the
-          Derivative Works; within the Source form or documentation,
-          if provided along with the Derivative Works; or, within a display
-          generated by the Derivative Works, if and wherever such third-party
-          notices normally appear. The contents of the NOTICE file are for
-          informational purposes only and do not modify the License. You
-          may add Your own attribution notices within Derivative Works that
-          You distribute, alongside or as an addendum to the NOTICE text
-          from the Work, provided that such additional attribution notices
-          cannot be construed as modifying the License.
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
 
       You may add Your own copyright statement to Your modifications and
       may provide additional or different license terms and conditions

package/README.md.backup

@@ -0,0 +1,169 @@
+# JERK Framework v2.0
+
+![JERK Framework Logo](jerk.jpg)
+
+Visita nuestra página web: https://jerk.page.gd/
+Repositorio oficial: https://gitlab.com/bytedogssyndicate1/jerk/
+
+## Características
+
+- **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
+- **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
+- **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.
+- **Gestión de Controladores**: Carga dinámica de controladores desde archivos
+- **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
+- **Extensibilidad**: Sistema de hooks y filters para personalización
+
+## Instalación
+
+```bash
+npm install jerkjs
+```
+
+## Uso Básico
+
+```javascript
+const { APIServer, Router, Logger } = require('jerkjs');
+
+// Crear instancia del servidor
+const server = new APIServer({
+  port: 3000,
+  host: 'localhost'
+});
+
+// Crear instancia del logger
+const logger = new Logger({ level: 'info' });
+
+// Definir rutas
+server.addRoute('GET', '/', (req, res) => {
+  res.writeHead(200, { 'Content-Type': 'application/json' });
+  res.end(JSON.stringify({ message: '¡Hola Mundo!' }));
+});
+
+// Iniciar el servidor
+server.start();
+```
+
+## Componentes Principales
+
+### APIServer
+Servidor HTTP/HTTPS básico con soporte para rutas parametrizadas, middlewares y configuración avanzada.
+
+### Router
+Sistema de enrutamiento avanzado con soporte para rutas anidadas y prefijos.
+
+### Authenticator
+Middleware de autenticación con soporte para múltiples métodos (JWT, API Keys, Basic Auth, OAuth2, OpenID Connect).
+
+### SecurityEnhancedServer
+Servidor con funcionalidades de seguridad avanzada (WAF) integradas.
+
+### RouteLoader
+Carga de rutas desde archivos JSON con soporte para autenticación, controladores y especificación de content-type.
+
+### TokenManager
+Gestión de tokens JWT con diferentes tipos de almacenamiento (memoria, JSON, SQLite, MariaDB).
+
+### Firewall
+Middleware de firewall con detección de patrones de ataque y listas blancas/negras.
+
+### Hooks System
+Sistema de hooks y filters similar al de WordPress para extensibilidad.
+
+### SessionManager
+Sistema completo de gestión de sesiones con soporte para autenticación basada en sesiones.
+
+### ViewEngine
+Motor de plantillas profesional con soporte para filtros, helpers, condiciones, bucles y hooks.
+
+### ControllerBase
+Controlador base que facilita el desarrollo de controladores MVC con soporte para vistas.
+
+## Seguridad
+
+El framework incluye múltiples capas de seguridad:
+
+- **Web Application Firewall (WAF)**: Detección de SQL injection, XSS, path traversal, etc.
+- **Rate Limiting**: Limitación de peticiones por IP o usuario
+- **Firewall**: Bloqueo automático por intentos fallidos
+- **Listas Blancas/Negras**: Control de acceso por IP
+- **Auditoría de Seguridad**: Registro de eventos de seguridad
+- **Autenticación Robusta**: Soporte para múltiples métodos de autenticación
+
+## Sistema de Hooks
+
+El framework incluye un sistema de hooks y filters similar al de WordPress:
+
+```javascript
+const { hooks } = require('jerkjs');
+
+// Registrar una acción
+hooks.addAction('firewall_request_blocked', (rule, clientIP, req, res) => {
+  console.log(`Solicitud bloqueada: ${rule.name} para IP: ${clientIP}`);
+});
+
+// Registrar un filtro
+hooks.addFilter('session_create_data', (userData, req) => {
+  return {
+    ...userData,
+    ipAddress: req.headers['x-forwarded-for'] || req.connection.remoteAddress,
+    createdAt: new Date().toISOString()
+  };
+});
+```
+
+## Motor de Plantillas MVC
+
+El framework incluye un motor de plantillas profesional con soporte para:
+
+- Variables: `{{variable}}`
+- Condiciones: `{{if variable}}contenido{{endif}}`
+- Bucles: `{{foreach:array}}contenido{{endforeach}}`
+- Inclusiones: `{{include:header}}`
+- Filtros: `{{variable|upper}}`
+- Helpers personalizados
+
+## Gestión de Sesiones
+
+El framework incluye un sistema completo de gestión de sesiones:
+
+```javascript
+const { SessionManager } = require('jerkjs');
+
+const sessionManager = new SessionManager({
+  secret: 'your-session-secret',
+  timeout: 3600000 // 1 hora
+});
+
+// Usar como middleware
+server.use(sessionManager.middleware());
+```
+
+## Ejemplos
+
+El proyecto incluye varios ejemplos completos:
+
+- **v2_json_auth**: Autenticación JWT con tokens almacenados en JSON
+- **v2_mariadb_auth**: Autenticación JWT con tokens almacenados en MariaDB
+- **v2_sqlite_auth**: Autenticación JWT con tokens almacenados en SQLite
+- **public**: API pública de ejemplo con CORS y rate limiting
+- **frontend**: Ejemplo de servidor que combina API y frontend con diferentes content-types
+- **hooks**: Ejemplo de uso del sistema de hooks
+
+Para ver los ejemplos completos, visita los directorios `v2examplle/` y `examples/`.
+
+## Contribuciones
+
+Las contribuciones son bienvenidas. Por favor, abre un issue o envía un pull request en GitHub.
+
+## Licencia
+
+Apache 2.0

package/cookies.txt

@@ -0,0 +1,5 @@
+# Netscape HTTP Cookie File
+# https://curl.se/docs/http-cookies.html
+# This file was generated by libcurl! Edit at your own risk.
+
+#HttpOnly_localhost	FALSE	/	FALSE	1768539037	frontend_session	29d7cb4e270ec66c0c7aa5d7ebe08bb8014432b8fb7746edd3895fe176fccee0

package/{doc → docs}/frontend-and-sessions.md

@@ -1,8 +1,5 @@
 # Frontend y Sesiones con API SDK JS
 
-Visita nuestra página web: https://jerk.page.gd/
-Repositorio oficial: https://gitlab.com/bytedogssyndicate1/jerk/
-
 ## Introducción
 
 API SDK JS no solo es un framework para crear APIs, sino que ahora también soporta la creación de aplicaciones web completas con frontend y sistema de sesiones. Esta funcionalidad permite a los desarrolladores crear aplicaciones web completas con autenticación basada en sesiones, almacenamiento de datos y mucho más.
@@ -50,7 +47,7 @@ El framework ahora puede servir diferentes tipos de contenido:
 Para usar el sistema de sesiones, primero debes configurar el middleware en tu aplicación:
 
 ```javascript
-const { APIServer, SessionManager, Cors } = require('@jerkjs/jerk');
+const { APIServer, SessionManager, Cors } = require('jerkjs');
 
 async function startServer() {
   const server = new APIServer({
@@ -190,7 +187,7 @@ El sistema de sesiones está completamente integrado con el sistema de hooks, fi
 #### Registrar actividad de sesión
 
 ```javascript
-const { hooks } = require('@jerkjs/jerk');
+const { hooks } = require('jerkjs');
 
 // Registrar cuando se crea una sesión
 hooks.addAction('session_created', (sessionId, sessionData) => {
@@ -206,7 +203,7 @@ hooks.addAction('session_destroyed', (sessionId, sessionData) => {
 #### Modificar datos de sesión antes de crearla
 
 ```javascript
-const { hooks } = require('@jerkjs/jerk');
+const { hooks } = require('jerkjs');
 
 // Añadir información de IP y fecha a los datos de sesión
 hooks.addFilter('session_create_data', (userData, req) => {
@@ -221,7 +218,7 @@ hooks.addFilter('session_create_data', (userData, req) => {
 #### Personalizar el manejo de autenticación fallida
 
 ```javascript
-const { hooks } = require('@jerkjs/jerk');
+const { hooks } = require('jerkjs');
 
 // Registrar intentos de acceso no autorizado
 hooks.addAction('session_auth_failed', (req, res, redirectTo) => {
@@ -238,7 +235,7 @@ hooks.addAction('session_auth_failed', (req, res, redirectTo) => {
 #### Extender datos de sesión durante la actualización
 
 ```javascript
-const { hooks } = require('@jerkjs/jerk');
+const { hooks } = require('jerkjs');
 
 // Añadir marca de tiempo a cada actualización de sesión
 hooks.addFilter('session_update_data', (newData, req, sessionId) => {
@@ -262,7 +259,7 @@ const {
   Logger,
   Cors,
   SessionManager
-} = require('@jerkjs/jerk');
+} = require('jerkjs');
 
 async function startServer() {
   const server = new APIServer({

package/examples/frontend/README.md

@@ -1,6 +1,6 @@
-# Ejemplo Frontend con API SDK JS
+# Ejemplo Frontend con JERK JS
 
-Este ejemplo demuestra cómo el Framework API SDK JS puede utilizarse para servir tanto APIs como contenido HTML para frontends, gracias a la nueva funcionalidad de especificación de content-type en el archivo routes.json.
+Este ejemplo demuestra cómo el Framework JERK JS puede utilizarse para servir tanto APIs como contenido HTML para frontends, gracias a la nueva funcionalidad de especificación de content-type en el archivo routes.json.
 
 ## Características
 
@@ -12,7 +12,7 @@ Este ejemplo demuestra cómo el Framework API SDK JS puede utilizarse para servi
 
 ## Configuración
 
-1. Asegúrate de tener instaladas las dependencias del framework API SDK
+1. Asegúrate de tener instaladas las dependencias del framework JERK
 2. No se requiere configuración adicional para este ejemplo
 
 ## Uso

package/examples/frontend/controllers/authController.js

@@ -51,7 +51,7 @@ const authController = {
         </main>
         
         <footer>
-            <p>&copy; 2026 API SDK JS Framework</p>
+            <p>&copy; 2026 JERK JS Framework</p>
         </footer>
     </div>
     <script src="/script.js"></script>
@@ -200,7 +200,7 @@ const authController = {
         </main>
         
         <footer>
-            <p>&copy; 2026 API SDK JS Framework</p>
+            <p>&copy; 2026 JERK JS Framework</p>
         </footer>
     </div>
     <script src="/script.js"></script>

package/examples/frontend/controllers/pageController.js

@@ -28,7 +28,7 @@ const pageController = {
 
         <main>
             <section class="hero">
-                <h2>Framework API SDK JS</h2>
+                <h2>Framework JERK JS</h2>
                 <p>Esta es una demostración de cómo el framework puede servir tanto APIs como contenido HTML para frontends.</p>
                 <p>El content-type de esta página se establece desde el archivo routes.json.</p>
             </section>
@@ -45,7 +45,7 @@ const pageController = {
         </main>
 
         <footer>
-            <p>&copy; 2026 API SDK JS Framework</p>
+            <p>&copy; 2026 JERK JS Framework</p>
         </footer>
     </div>
     <script src="/script.js"></script>
@@ -84,7 +84,7 @@ const pageController = {
         <main>
             <section>
                 <h2>Nuestro Framework</h2>
-                <p>El Framework API SDK JS es una solución completa para construir APIs seguras y escalables.</p>
+                <p>El Framework JERK JS es una solución completa para construir APIs seguras y escalables.</p>
 
                 <h3>Capacidades Extendidas</h3>
                 <p>Ahora también puede servir contenido HTML y otros tipos de contenido gracias a la nueva funcionalidad de especificación de content-type en routes.json.</p>
@@ -101,7 +101,7 @@ const pageController = {
         </main>
 
         <footer>
-            <p>&copy; 2026 API SDK JS Framework</p>
+            <p>&copy; 2026 JERK JS Framework</p>
         </footer>
     </div>
     <script src="/script.js"></script>
@@ -163,7 +163,7 @@ const pageController = {
         </main>
 
         <footer>
-            <p>&copy; 2026 API SDK JS Framework</p>
+            <p>&copy; 2026 JERK JS Framework</p>
         </footer>
     </div>
     <script src="/script.js"></script>

package/examples/public/README.md

@@ -1,6 +1,6 @@
 # API Pública de Ejemplo
 
-Este ejemplo demuestra cómo crear una API pública usando el Framework API SDK JS. La API incluye endpoints para gestionar usuarios y está protegida con CORS y rate limiting.
+Este ejemplo demuestra cómo crear una API pública usando el Framework JERK JS. La API incluye endpoints para gestionar usuarios y está protegida con CORS y rate limiting.
 
 ## Características
 
@@ -13,7 +13,7 @@ Este ejemplo demuestra cómo crear una API pública usando el Framework API SDK
 
 ## Configuración
 
-1. Asegúrate de tener instaladas las dependencias del framework API SDK
+1. Asegúrate de tener instaladas las dependencias del framework JERK
 2. No se requiere configuración adicional para esta API pública
 
 ## Uso

package/examples/public/controllers/mainController.js

@@ -4,7 +4,7 @@ const mainController = {
     res.end(JSON.stringify({
       message: 'Bienvenido a la API Pública de Ejemplo',
       version: '1.0.0',
-      description: 'Esta es una API pública de ejemplo creada con el Framework API SDK JS',
+      description: 'Esta es una API pública de ejemplo creada con el Framework JERK JS',
       endpoints: {
         'GET /': 'Este mensaje',
         'GET /users': 'Obtener lista de usuarios',

package/index.js

@@ -30,10 +30,6 @@ const SecurityEnhancedServer = require('./lib/core/securityEnhancedServer');
 const Firewall = require('./lib/middleware/firewall');
 const { SessionManager, sessionAuth } = require('./lib/middleware/session');
 
-// Componentes MVC
-const ViewEngine = require('./lib/mvc/viewEngine');
-const ControllerBase = require('./lib/mvc/controllerBase');
-
 // Exportar todos los componentes del framework
 module.exports = {
   // Componentes fundamentales (v1.0)
@@ -68,15 +64,11 @@ module.exports = {
 
   // Componentes de sesión (v2.2.0)
   SessionManager,
-  sessionAuth,
-
-  // Componentes MVC (v2.3.0)
-  ViewEngine,
-  ControllerBase
+  sessionAuth
 };
 
 // También exportar clases individuales por conveniencia
-module.exports.APISDK = APIServer;
+module.exports.JERK = APIServer;
 
 // Crear instancia global del sistema de hooks
 module.exports.hooks = new HookSystem();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jerkjs",
-  "version": "2.0.0",
-  "description": "JERK Framework v2.0 - A comprehensive framework for building secure and scalable APIs",
+  "version": "2.0.1",
+  "description": "JERK Framework v2.0 - A comprehensive framework for building secure and scalable APIs with frontend support, sessions, and template engine",
   "main": "index.js",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
@@ -20,11 +20,11 @@
     "firewall",
     "waf"
   ],
-  "author": "JERK Team",
+  "author": "JERK Framework Team",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "git+https://gitlab.com/bytedogssyndicate1/jerk.git"
+    "url": "https://gitlab.com/bytedogssyndicate1/jerk.git"
   },
   "bugs": {
     "url": "https://gitlab.com/bytedogssyndicate1/jerk/issues"
@@ -38,10 +38,5 @@
   },
   "engines": {
     "node": ">=14.0.0"
-  },
-  "directories": {
-    "doc": "doc",
-    "example": "examples",
-    "lib": "lib"
   }
 }

package/v2examplle/v2_json_auth/README.md

@@ -1,6 +1,6 @@
 # Ejemplo API con Autenticación JSON
 
-Este ejemplo demuestra cómo crear una API con autenticación basada en tokens estáticos almacenados en un archivo JSON utilizando el Framework API SDK.
+Este ejemplo demuestra cómo crear una API con autenticación basada en tokens estáticos almacenados en un archivo JSON utilizando el Framework JERK.
 
 ## Características
 
@@ -12,7 +12,7 @@ Este ejemplo demuestra cómo crear una API con autenticación basada en tokens e
 
 ## Configuración
 
-1. Asegúrate de tener instaladas las dependencias del framework API SDK
+1. Asegúrate de tener instaladas las dependencias del framework JERK
 2. El archivo de tokens `tokens.json` se creará automáticamente al iniciar la aplicación
 
 ## Uso

package/v2examplle/v2_json_auth/package.json

@@ -1,7 +1,7 @@
 {
-  "name": "api-sdk-json-auth-example",
+  "name": "jerk-json-auth-example",
   "version": "1.0.0",
-  "description": "Ejemplo de API con autenticación JSON usando el Framework API SDK",
+  "description": "Ejemplo de API con autenticación JSON usando el Framework JERK",
   "main": "app.js",
   "scripts": {
     "start": "node app.js",
@@ -15,8 +15,8 @@
     "jwt",
     "framework"
   ],
-  "author": "API SDK Framework",
-  "license": "MIT",
+  "author": "JERK Framework",
+  "license": "Apache-2.0",
   "dependencies": {
     "jsonwebtoken": "^9.0.0"
   },

package/v2examplle/v2_mariadb_auth/README.md

@@ -1,6 +1,6 @@
 # Ejemplo API con Autenticación MariaDB
 
-Este ejemplo demuestra cómo crear una API con autenticación basada en tokens almacenados en MariaDB utilizando el Framework API SDK.
+Este ejemplo demuestra cómo crear una API con autenticación basada en tokens almacenados en MariaDB utilizando el Framework JERK.
 
 ## Características
 
@@ -12,7 +12,7 @@ Este ejemplo demuestra cómo crear una API con autenticación basada en tokens a
 
 ## Configuración
 
-1. Asegúrate de tener instaladas las dependencias del framework API SDK
+1. Asegúrate de tener instaladas las dependencias del framework JERK
 2. Instala mariadb si aún no está instalado: `npm install mariadb`
 3. Asegúrate de tener MariaDB instalado y en ejecución
 4. Crea la base de datos `token_db` en MariaDB

package/v2examplle/v2_mariadb_auth/package.json

@@ -1,7 +1,7 @@
 {
-  "name": "api-sdk-mariadb-example",
+  "name": "jerk-mariadb-example",
   "version": "1.0.0",
-  "description": "Ejemplo de API con autenticación MariaDB usando el Framework API SDK",
+  "description": "Ejemplo de API con autenticación MariaDB usando el Framework JERK",
   "main": "app.js",
   "scripts": {
     "start": "node app.js",
@@ -15,8 +15,8 @@
     "jwt",
     "framework"
   ],
-  "author": "API SDK Framework",
-  "license": "MIT",
+  "author": "JERK Framework",
+  "license": "Apache-2.0",
   "dependencies": {
     "jsonwebtoken": "^9.0.0",
     "mariadb": "^3.0.0"

package/v2examplle/v2_sqlite_auth/README.md

@@ -1,6 +1,6 @@
 # Ejemplo API con Autenticación SQLite
 
-Este ejemplo demuestra cómo crear una API con autenticación basada en tokens almacenados en SQLite utilizando el Framework API SDK.
+Este ejemplo demuestra cómo crear una API con autenticación basada en tokens almacenados en SQLite utilizando el Framework JERK.
 
 ## Características
 
@@ -11,7 +11,7 @@ Este ejemplo demuestra cómo crear una API con autenticación basada en tokens a
 
 ## Configuración
 
-1. Asegúrate de tener instaladas las dependencias del framework API SDK
+1. Asegúrate de tener instaladas las dependencias del framework JERK
 2. Instala sqlite3 si aún no está instalado: `npm install sqlite3`
 
 ## Uso

package/v2examplle/v2_sqlite_auth/package.json

@@ -1,7 +1,7 @@
 {
-  "name": "api-sdk-example-v2",
+  "name": "jerk-example-v2",
   "version": "1.0.0",
-  "description": "Ejemplo de API con autenticación SQLite usando el Framework API SDK",
+  "description": "Ejemplo de API con autenticación SQLite usando el Framework JERK",
   "main": "app.js",
   "scripts": {
     "start": "node app.js",
@@ -15,8 +15,8 @@
     "jwt",
     "framework"
   ],
-  "author": "API SDK Framework",
-  "license": "MIT",
+  "author": "JERK Framework",
+  "license": "Apache-2.0",
   "dependencies": {
     "jsonwebtoken": "^9.0.0",
     "sqlite3": "^5.1.6"