npm - jerkjs - Versions diffs - 2.0.1 → 2.0.2 - Mend

jerkjs 2.0.1 → 2.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (131) hide show

package/README.md +4 -6
package/docs/EXTENSION_MANUAL.md +955 -0
package/docs/FIREWALL_MANUAL.md +416 -0
package/docs/HOOKS_REFERENCE_IMPROVED.md +596 -0
package/docs/MANUAL_API_SDK.md +536 -0
package/docs/MARIADB_TOKENS_IMPLEMENTATION.md +110 -0
package/docs/MIDDLEWARE_MANUAL.md +518 -0
package/docs/OAUTH2_GOOGLE_MANUAL.md +405 -0
package/docs/frontend-and-sessions.md +6 -6
package/examples/advanced/controllers/productController.js +64 -0
package/examples/advanced/controllers/userController.js +85 -0
package/examples/advanced/routes.json +51 -0
package/examples/advanced_example.js +93 -0
package/examples/basic/controllers/userController.js +85 -0
package/examples/basic_example.js +72 -0
package/examples/mvc_example/app.js +138 -0
package/examples/mvc_example/views/home/index.html +26 -0
package/examples/mvc_example/views/home/simple.html +3 -0
package/examples/mvc_example/views/layout.html +23 -0
package/examples/mvc_example/views/test.html +3 -0
package/examples/mvc_example/views/user/invalid.html +6 -0
package/examples/mvc_example/views/user/list.html +36 -0
package/examples/mvc_example/views/user/notfound.html +6 -0
package/examples/mvc_example/views/user/profile.html +11 -0
package/examples/mvc_routes_example/app.js +34 -0
package/examples/mvc_routes_example/controllers/mainController.js +27 -0
package/examples/mvc_routes_example/controllers/productController.js +47 -0
package/examples/mvc_routes_example/controllers/userController.js +76 -0
package/examples/mvc_routes_example/routes.json +30 -0
package/examples/mvc_routes_example/views/layout.html +31 -0
package/examples/mvc_routes_example/views/main/index.html +11 -0
package/examples/mvc_routes_example/views/product/catalog.html +24 -0
package/examples/mvc_routes_example/views/user/invalid.html +6 -0
package/examples/mvc_routes_example/views/user/list.html +40 -0
package/examples/mvc_routes_example/views/user/notfound.html +6 -0
package/examples/mvc_routes_example/views/user/profile.html +18 -0
package/examples/mvc_welcome/README.md +34 -0
package/examples/mvc_welcome/app.js +50 -0
package/examples/mvc_welcome/controllers/welcomeController.js +41 -0
package/examples/mvc_welcome/package.json +26 -0
package/examples/mvc_welcome/views/home/welcome.html +82 -0
package/examples/v2/README.md +72 -0
package/examples/v2/app.js +74 -0
package/examples/v2/app_fixed.js +74 -0
package/examples/v2/controllers/authController.js +64 -0
package/examples/v2/controllers/mainController.js +24 -0
package/examples/v2/controllers/protectedController.js +12 -0
package/examples/v2/controllers/userController.js +16 -0
package/examples/v2/package.json +27 -0
package/examples/v2/routes.json +30 -0
package/examples/v2/test_api.sh +47 -0
package/examples/v2/tokens_example.sqlite +0 -0
package/examples/v2.1_firewall_demo/README.md +113 -0
package/examples/v2.1_firewall_demo/app.js +182 -0
package/examples/v2.1_firewall_demo/package.json +27 -0
package/examples/v2.1_hooks_demo/README.md +85 -0
package/examples/v2.1_hooks_demo/app.js +101 -0
package/examples/v2.1_hooks_demo/controllers/hooksController.js +29 -0
package/examples/v2.1_hooks_demo/controllers/mainController.js +18 -0
package/examples/v2.1_hooks_demo/package.json +27 -0
package/examples/v2.1_hooks_demo/routes.json +16 -0
package/examples/v2.1_openapi_demo/README.md +82 -0
package/examples/v2.1_openapi_demo/app.js +296 -0
package/examples/v2.1_openapi_demo/package.json +26 -0
package/examples/v2_cors/README.md +82 -0
package/examples/v2_cors/app.js +108 -0
package/examples/v2_cors/package.json +23 -0
package/examples/v2_json_auth/README.md +83 -0
package/examples/v2_json_auth/app.js +72 -0
package/examples/v2_json_auth/controllers/authController.js +67 -0
package/examples/v2_json_auth/controllers/mainController.js +16 -0
package/examples/v2_json_auth/controllers/protectedController.js +12 -0
package/examples/v2_json_auth/controllers/tokenController.js +28 -0
package/examples/v2_json_auth/controllers/userController.js +15 -0
package/examples/v2_json_auth/package.json +26 -0
package/examples/v2_json_auth/routes.json +37 -0
package/examples/v2_json_auth/tokens.json +20 -0
package/examples/v2_mariadb_auth/README.md +94 -0
package/examples/v2_mariadb_auth/app.js +81 -0
package/examples/v2_mariadb_auth/controllers/authController.js +95 -0
package/examples/v2_mariadb_auth/controllers/mainController.js +31 -0
package/examples/v2_mariadb_auth/controllers/protectedController.js +12 -0
package/examples/v2_mariadb_auth/controllers/userController.js +17 -0
package/examples/v2_mariadb_auth/package.json +27 -0
package/examples/v2_mariadb_auth/routes.json +37 -0
package/examples/v2_no_auth/README.md +75 -0
package/examples/v2_no_auth/app.js +72 -0
package/examples/v2_no_auth/controllers/healthController.js +14 -0
package/examples/v2_no_auth/controllers/mainController.js +19 -0
package/examples/v2_no_auth/controllers/productController.js +31 -0
package/examples/v2_no_auth/controllers/publicController.js +16 -0
package/examples/v2_no_auth/package.json +22 -0
package/examples/v2_no_auth/routes.json +37 -0
package/examples/v2_oauth/README.md +70 -0
package/examples/v2_oauth/app.js +90 -0
package/examples/v2_oauth/controllers/mainController.js +45 -0
package/examples/v2_oauth/controllers/oauthController.js +247 -0
package/examples/v2_oauth/controllers/protectedController.js +13 -0
package/examples/v2_oauth/controllers/userController.js +17 -0
package/examples/v2_oauth/package.json +26 -0
package/examples/v2_oauth/routes.json +44 -0
package/examples/v2_openapi/README.md +77 -0
package/examples/v2_openapi/app.js +222 -0
package/examples/v2_openapi/controllers/authController.js +52 -0
package/examples/v2_openapi/controllers/mainController.js +26 -0
package/examples/v2_openapi/controllers/productController.js +17 -0
package/examples/v2_openapi/controllers/userController.js +27 -0
package/examples/v2_openapi/package.json +26 -0
package/examples/v2_openapi/routes.json +37 -0
package/index.js +11 -3
package/lib/core/handler.js +1 -1
package/lib/core/hooks.js +1 -1
package/lib/core/router.js +1 -1
package/lib/core/server.js +1 -1
package/lib/loader/controllerLoader.js +1 -1
package/lib/loader/routeLoader.js +1 -1
package/lib/middleware/auditLogger.js +1 -1
package/lib/middleware/authenticator.js +1 -1
package/lib/middleware/compressor.js +1 -1
package/lib/middleware/cors.js +1 -1
package/lib/middleware/firewall.js +1 -1
package/lib/middleware/rateLimiter.js +1 -1
package/lib/middleware/session.js +1 -1
package/lib/middleware/validator.js +1 -1
package/lib/mvc/controllerBase.js +207 -0
package/lib/mvc/viewEngine.js +752 -0
package/lib/utils/configParser.js +1 -1
package/lib/utils/logger.js +1 -1
package/lib/utils/openapiGenerator.js +1 -1
package/lib/utils/tokenManager.js +1 -1
package/package.json +1 -1

package/examples/mvc_routes_example/controllers/userController.js ADDED Viewed

@@ -0,0 +1,76 @@
+const { ControllerBase } = require('../../../index');
+class UserController extends ControllerBase {
+  constructor(options = {}) {
+    super(options);
+  }
+  list(req, res) {
+    const users = [
+      { id: 1, name: 'Ana García', email: 'ana@example.com', registered: '2026-01-01', active: true },
+      { id: 2, name: 'Carlos López', email: 'carlos@example.com', registered: '2026-01-02', active: false },
+      { id: 3, name: 'Laura Martínez', email: 'laura@example.com', registered: '2026-01-03', active: true },
+      { id: 4, name: 'Pedro Rodríguez', email: 'pedro@example.com', registered: '2026-01-04', active: true },
+      { id: 5, name: 'María Sánchez', email: 'maria@example.com', registered: '2026-01-05', active: false }
+    ];
+    this.set('title', 'Lista de Usuarios');
+    this.set('users', users);
+    this.render(res, 'user/list', {
+      totalUsers: users.length
+    });
+  }
+  profile(req, res) {
+    const userIdParam = this.input('id', '1');
+    // Validar que el ID sea un número entero positivo
+    if (!/^\d+$/.test(userIdParam) || parseInt(userIdParam) <= 0) {
+      this.set('title', 'ID de usuario inválido');
+      this.render(res, 'user/invalid', {
+        userId: userIdParam
+      });
+      return;
+    }
+    const userId = parseInt(userIdParam);
+    const users = [
+      { id: 1, name: 'Ana García', email: 'ana@example.com', registered: '2026-01-01', active: true },
+      { id: 2, name: 'Carlos López', email: 'carlos@example.com', registered: '2026-01-02', active: false },
+      { id: 3, name: 'Laura Martínez', email: 'laura@example.com', registered: '2026-01-03', active: true },
+      { id: 4, name: 'Pedro Rodríguez', email: 'pedro@example.com', registered: '2026-01-04', active: true },
+      { id: 5, name: 'María Sánchez', email: 'maria@example.com', registered: '2026-01-05', active: false }
+    ];
+    const user = users.find(u => u.id === userId);
+    if (!user) {
+      this.set('title', 'Usuario no encontrado');
+      this.render(res, 'user/notfound', {
+        userId: userId
+      });
+      return;
+    }
+    this.set('title', `Perfil de ${user.name}`);
+    this.set('user', user);
+    this.render(res, 'user/profile');
+  }
+}
+// Exportar métodos directamente para que el RouteLoader pueda acceder a ellos
+const controllerInstance = new UserController({ viewsPath: './examples/mvc_routes_example/views' });
+module.exports = {
+  list: (req, res) => {
+    controllerInstance.setRequestResponse(req, res);
+    controllerInstance.list(req, res);
+  },
+  profile: (req, res) => {
+    controllerInstance.setRequestResponse(req, res);
+    controllerInstance.profile(req, res);
+  }
+};

package/examples/mvc_routes_example/routes.json ADDED Viewed

@@ -0,0 +1,30 @@
+[
+  {
+    "method": "GET",
+    "path": "/",
+    "controller": "./examples/mvc_routes_example/controllers/mainController.js",
+    "handler": "index",
+    "auth": "none"
+  },
+  {
+    "method": "GET",
+    "path": "/users",
+    "controller": "./examples/mvc_routes_example/controllers/userController.js",
+    "handler": "list",
+    "auth": "none"
+  },
+  {
+    "method": "GET",
+    "path": "/profile",
+    "controller": "./examples/mvc_routes_example/controllers/userController.js",
+    "handler": "profile",
+    "auth": "none"
+  },
+  {
+    "method": "GET",
+    "path": "/products",
+    "controller": "./examples/mvc_routes_example/controllers/productController.js",
+    "handler": "catalog",
+    "auth": "none"
+  }
+]

package/examples/mvc_routes_example/views/layout.html ADDED Viewed

@@ -0,0 +1,31 @@
+<!DOCTYPE html>
+<html lang="es">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>{{title}}</title>
+    <style>
+        body { font-family: Arial, sans-serif; margin: 40px; background-color: #f5f5f5; }
+        .container { max-width: 800px; margin: 0 auto; background: white; padding: 20px; border-radius: 8px; box-shadow: 0 2px 10px rgba(0,0,0,0.1); }
+        h1 { color: #333; }
+        nav { margin: 20px 0; }
+        nav a { margin-right: 15px; text-decoration: none; color: #007bff; }
+        nav a:hover { text-decoration: underline; }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <h1>{{title}}</h1>
+        <p>{{message}}</p>
+        <nav>
+            <a href="/">Inicio</a>
+            <a href="/users">Usuarios</a>
+            <a href="/products">Productos</a>
+        </nav>
+        <p>Versión: {{version}}</p>
+        <p>Hora actual: {{currentTime}}</p>
+    </div>
+</body>
+</html>

package/examples/mvc_routes_example/views/main/index.html ADDED Viewed

@@ -0,0 +1,11 @@
+<h1>{{title}}</h1>
+<p>{{message}}</p>
+<nav>
+    <a href="/">Inicio</a>
+    <a href="/users">Usuarios</a>
+    <a href="/products">Productos</a>
+</nav>
+<p>Versión: {{version}}</p>
+<p>Hora actual: {{currentTime}}</p>

package/examples/mvc_routes_example/views/product/catalog.html ADDED Viewed

@@ -0,0 +1,24 @@
+<h1>{{title}}</h1>
+{{if products}}
+  <div class="product-grid">
+    {{foreach:products}}
+      <div class="product-card">
+        <h3>{{item.name}}</h3>
+        <p>Categoría: {{item.category}}</p>
+        <p>Precio original: {{formatCurrency(item.price)}}</p>
+        <p>Descuento: {{item.discount}}%</p>
+        {{if item.discount > 0}}
+          <p>Precio con descuento: {{formatCurrency(calculateDiscount(item.price, item.discount))}}</p>
+          <p class="onsale">¡En oferta!</p>
+        {{else}}
+          <p class="regular">Precio regular</p>
+        {{endif}}
+      </div>
+    {{endforeach}}
+  </div>
+{{else}}
+  <p>No hay productos disponibles.</p>
+{{endif}}
+<a href="/">Volver al inicio</a>

package/examples/mvc_routes_example/views/user/invalid.html ADDED Viewed

@@ -0,0 +1,6 @@
+<h1>{{title}}</h1>
+<div>
+  <p>El ID proporcionado no es válido: {{userId}}</p>
+  <a href="/users">Volver a la lista de usuarios</a>
+</div>

package/examples/mvc_routes_example/views/user/list.html ADDED Viewed

@@ -0,0 +1,40 @@
+<h1>{{title}}</h1>
+{{if users}}
+  <p>Total de usuarios: {{totalUsers}}</p>
+  <table>
+    <thead>
+      <tr>
+        <th>ID</th>
+        <th>Nombre</th>
+        <th>Email</th>
+        <th>Registrado</th>
+        <th>Estado</th>
+        <th>Acciones</th>
+      </tr>
+    </thead>
+    <tbody>
+      {{foreach:users}}
+      <tr>
+        <td>{{item.id}}</td>
+        <td>{{item.name}}</td>
+        <td>{{item.email}}</td>
+        <td>{{item.registered|date:'DD/MM/YYYY'}}</td>
+        <td>
+          {{if item.active}}
+            <span class="active">Activo</span>
+          {{else}}
+            <span class="inactive">Inactivo</span>
+          {{endif}}
+        </td>
+        <td><a href="/profile?id={{item.id}}">Ver Perfil</a></td>
+      </tr>
+      {{endforeach}}
+    </tbody>
+  </table>
+{{else}}
+  <p>No hay usuarios registrados.</p>
+{{endif}}
+<a href="/">Volver al inicio</a>

package/examples/mvc_routes_example/views/user/notfound.html ADDED Viewed

@@ -0,0 +1,6 @@
+<h1>{{title}}</h1>
+<div>
+  <p>No se encontró el usuario con ID: {{userId}}</p>
+  <a href="/users">Volver a la lista de usuarios</a>
+</div>

package/examples/mvc_routes_example/views/user/profile.html ADDED Viewed

@@ -0,0 +1,18 @@
+<h1>{{title}}</h1>
+<div>
+  <h2>Información del Usuario</h2>
+  <p><strong>ID:</strong> {{user.id}}</p>
+  <p><strong>Nombre:</strong> {{user.name}}</p>
+  <p><strong>Email:</strong> {{user.email}}</p>
+  <p><strong>Registrado:</strong> {{user.registered|date:'DD/MM/YYYY'}}</p>
+  <p><strong>Estado:</strong>
+    {{if user.active}}
+      <span class="active">Activo</span>
+    {{else}}
+      <span class="inactive">Inactivo</span>
+    {{endif}}
+  </p>
+</div>
+<a href="/users">Volver a la lista de usuarios</a>

package/examples/mvc_welcome/README.md ADDED Viewed

@@ -0,0 +1,34 @@
+# Ejemplo de Página de Bienvenida con Motor MVC
+Este ejemplo demuestra cómo usar el motor de plantillas MVC del framework JERK para crear una página de bienvenida atractiva y funcional.
+## Características
+- **Sistema MVC**: Uso completo del sistema de vistas, controladores y modelos
+- **Motor de Plantillas**: Uso del motor de plantillas con soporte para variables, condicionales y bucles
+- **Vistas Dinámicas**: Renderizado de contenido dinámico desde el controlador
+- **Estilos Modernos**: Diseño responsive y atractivo
+## Componentes
+- `app.js`: Archivo principal que configura el servidor y las rutas
+- `controllers/welcomeController.js`: Controlador que maneja la lógica del sitio
+- `views/home/welcome.html`: Vista principal con el diseño de la página de bienvenida
+## Uso
+1. Inicia el servidor:
+   ```bash
+   node examples/mvc_welcome/app.js
+   ```
+2. Visita http://localhost:9002 para ver la página de bienvenida
+## Características del Framework
+Este ejemplo muestra algunas de las características clave del framework JERK:
+- Motor de plantillas MVC profesional
+- Sistema de vistas con soporte para variables, condicionales y bucles
+- Controladores MVC con acceso fácil a vistas
+- Arquitectura modular y extensible

package/examples/mvc_welcome/app.js ADDED Viewed

@@ -0,0 +1,50 @@
+/**
+ * Ejemplo de página de bienvenida usando el motor de plantillas MVC de JERK
+ * Demostración del sistema MVC con vistas y controladores
+ */
+const { APIServer, Router, Logger } = require('../../index');
+const WelcomeController = require('./controllers/welcomeController');
+async function startServer() {
+  // Crear instancia del servidor
+  const server = new APIServer({
+    port: 9002,
+    host: 'localhost'
+  });
+  // Crear instancia del logger
+  const logger = new Logger({ level: 'info' });
+  // Crear instancia del controlador
+  const welcomeController = new WelcomeController({
+    viewsPath: './examples/mvc_welcome/views'
+  });
+  // Definir rutas
+  const router = new Router();
+  router
+    .get('/', (req, res) => {
+      welcomeController.setRequestResponse(req, res);
+      welcomeController.index(req, res);
+    });
+  // Agregar las rutas del router al servidor
+  const routes = router.getRoutes();
+  for (const route of routes) {
+    server.addRoute(route.method, route.path, route.handler);
+  }
+  // Iniciar el servidor
+  server.start(() => {
+    logger.info('Servidor de bienvenida MVC iniciado en http://localhost:9002');
+    logger.info('Ruta disponible:');
+    logger.info('- http://localhost:9002/ (Página de bienvenida)');
+  });
+}
+// Iniciar el servidor
+startServer();
+module.exports = { startServer };

package/examples/mvc_welcome/controllers/welcomeController.js ADDED Viewed

@@ -0,0 +1,41 @@
+const { ControllerBase } = require('../../../index');
+class WelcomeController extends ControllerBase {
+  constructor(options = {}) {
+    super(options);
+  }
+  index(req, res) {
+    // Establecer variables para la vista
+    this.set('title', 'Bienvenido a JERK Framework');
+    this.set('message', 'El poderoso framework para construir aplicaciones web completas con Node.js');
+    // Datos de características del framework
+    this.set('features', [
+      {
+        name: 'Motor MVC',
+        description: 'Sistema completo de vistas, controladores y modelos'
+      },
+      {
+        name: 'Seguridad',
+        description: 'Firewall integrado y protección contra ataques'
+      },
+      {
+        name: 'Autenticación',
+        description: 'Soporte para JWT, OAuth, sesiones y más'
+      },
+      {
+        name: 'Flexibilidad',
+        description: 'Arquitectura modular y altamente configurable'
+      }
+    ]);
+    this.set('documentationUrl', 'https://jerk.page.gd/');
+    this.set('examplesUrl', 'https://gitlab.com/bytedogssyndicate1/jerk');
+    // Renderizar la vista
+    this.render(res, 'home/welcome');
+  }
+}
+module.exports = WelcomeController;

package/examples/mvc_welcome/package.json ADDED Viewed

@@ -0,0 +1,26 @@
+{
+  "name": "jerk-mvc-welcome-example",
+  "version": "1.0.0",
+  "description": "Ejemplo de página de bienvenida usando el motor de plantillas MVC del framework JERK",
+  "main": "app.js",
+  "scripts": {
+    "start": "node app.js",
+    "dev": "nodemon app.js"
+  },
+  "keywords": [
+    "jerk",
+    "mvc",
+    "template-engine",
+    "welcome-page",
+    "nodejs",
+    "framework"
+  ],
+  "author": "JERK Framework Team",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "jerkjs": "^2.0.0"
+  },
+  "devDependencies": {
+    "nodemon": "^3.0.0"
+  }
+}

package/examples/mvc_welcome/views/home/welcome.html ADDED Viewed

@@ -0,0 +1,82 @@
+<!DOCTYPE html>
+<html lang="es">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>{{title}}</title>
+    <style>
+        body {
+            font-family: Arial, sans-serif;
+            margin: 0;
+            padding: 0;
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            min-height: 100vh;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+        }
+        .container {
+            background: white;
+            padding: 2rem;
+            border-radius: 10px;
+            box-shadow: 0 10px 30px rgba(0,0,0,0.2);
+            text-align: center;
+            max-width: 600px;
+            width: 90%;
+        }
+        h1 {
+            color: #333;
+            margin-bottom: 1rem;
+        }
+        .message {
+            font-size: 1.2rem;
+            color: #666;
+            margin-bottom: 2rem;
+        }
+        .features {
+            display: grid;
+            grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
+            gap: 1rem;
+            margin: 2rem 0;
+        }
+        .feature {
+            background: #f8f9fa;
+            padding: 1rem;
+            border-radius: 5px;
+            border-left: 4px solid #667eea;
+        }
+        .btn {
+            display: inline-block;
+            background: #667eea;
+            color: white;
+            padding: 0.75rem 1.5rem;
+            text-decoration: none;
+            border-radius: 5px;
+            margin-top: 1rem;
+            transition: background 0.3s;
+        }
+        .btn:hover {
+            background: #5a6fd8;
+        }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <h1>{{title}}</h1>
+        <div class="message">{{message}}</div>
+        <div class="features">
+            {{foreach:features}}
+            <div class="feature">
+                <h3>{{item.name}}</h3>
+                <p>{{item.description}}</p>
+            </div>
+            {{endforeach}}
+        </div>
+        <p>¡Comienza a construir tu aplicación con JERK!</p>
+        <a href="{{documentationUrl}}" class="btn">Documentación</a>
+        <a href="{{examplesUrl}}" class="btn">Ejemplos</a>
+    </div>
+</body>
+</html>

package/examples/v2/README.md ADDED Viewed

@@ -0,0 +1,72 @@
+# 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 JERK.
+## Características
+- Autenticación JWT con tokens almacenados en SQLite
+- Rutas protegidas y públicas
+- Sistema de login para obtener tokens
+- Controladores organizados por funcionalidad
+## Configuración
+1. Asegúrate de tener instaladas las dependencias del framework JERK
+2. Instala sqlite3 si aún no está instalado: `npm install sqlite3`
+## Uso
+1. Inicia el servidor:
+   ```bash
+   node app.js
+   ```
+2. El servidor escuchará en `http://localhost:8088`
+## Endpoints
+- `GET /` - Página de inicio (público)
+- `POST /login` - Iniciar sesión y obtener token (público)
+- `GET /protected` - Contenido protegido (requiere token)
+- `GET /profile` - Perfil de usuario (requiere token)
+## Ejemplo de uso
+1. Iniciar sesión:
+   ```bash
+   curl -X POST http://localhost:8088/login \
+     -H "Content-Type: application/json" \
+     -d '{"username": "admin", "password": "password"}'
+   ```
+2. Acceder a contenido protegido:
+   ```bash
+   curl -X GET http://localhost:8088/protected \
+     -H "Authorization: Bearer TU_TOKEN_AQUI"
+   ```
+3. Ver perfil de usuario:
+   ```bash
+   curl -X GET http://localhost:8088/profile \
+     -H "Authorization: Bearer TU_TOKEN_AQUI"
+   ```
+## Estructura del proyecto
+```
+examples/v2/
+├── app.js              # Punto de entrada de la aplicación
+├── routes.json         # Definición de rutas
+├── controllers/        # Controladores de las rutas
+│   ├── mainController.js
+│   ├── authController.js
+│   ├── protectedController.js
+│   └── userController.js
+└── tokens_example.sqlite  # Base de datos SQLite para tokens (generada automáticamente)
+```
+## Seguridad
+- Los tokens se almacenan en una base de datos SQLite
+- Los tokens expiran después de 1 hora
+- Las rutas protegidas requieren un token válido en el header Authorization

package/examples/v2/app.js ADDED Viewed

@@ -0,0 +1,74 @@
+const {
+  APIServer,
+  Authenticator,
+  RouteLoader,
+  Logger,
+  SQLiteTokenAdapter
+} = require('../../index.js');
+async function startServer() {
+  // Crear instancia del servidor
+  const server = new APIServer({
+    port: 8088,
+    host: 'localhost'
+  });
+  // Crear instancia del logger
+  const logger = new Logger({ level: 'info' });
+  try {
+    // Crear instancia del adaptador de tokens SQLite
+    const tokenAdapter = new SQLiteTokenAdapter({
+      dbPath: './tokens_example.sqlite',
+      tableName: 'example_tokens'
+    });
+    // Inicializar el adaptador de tokens
+    await tokenAdapter.initialize();
+    logger.info('SQLite Token Adapter inicializado correctamente');
+    // Crear instancia del autenticador
+    const authenticator = new Authenticator({ logger });
+    // Registrar estrategia de autenticación JWT que utiliza el adaptador SQLite
+    authenticator.use('jwt-sqlite', async (req, options = {}) => {
+      const authHeader = req.headers.authorization;
+      const token = authHeader && authHeader.split(' ')[1]; // Bearer TOKEN
+      if (!token) {
+        return false;
+      }
+      // Validar el token contra la base de datos SQLite
+      const tokenRecord = await tokenAdapter.validateToken(token);
+      if (tokenRecord) {
+        // Agregar información del usuario a la solicitud
+        req.user = { userId: tokenRecord.user_id, tokenType: tokenRecord.token_type };
+        return true;
+      }
+      return false;
+    });
+    // Agregar el autenticador al servidor para que pueda ser usado por el RouteLoader
+    server.authenticator = authenticator;
+    // Cargar rutas desde archivo JSON
+    const routeLoader = new RouteLoader();
+    await routeLoader.loadRoutes(server, './routes.json');
+    // Iniciar el servidor
+    server.start();
+    logger.info('Servidor iniciado en http://localhost:8088');
+  } catch (error) {
+    logger.error('Error iniciando el servidor:', error.message);
+    process.exit(1);
+  }
+}
+// Iniciar el servidor
+startServer();
+module.exports = { startServer };