npm - jerkjs - Versions diffs - 2.0.0 - Mend

jerkjs 2.0.0

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 (177) hide show

package/LICENSE +200 -0
package/README.md +171 -0
package/doc/EXTENSION_MANUAL.md +958 -0
package/doc/FIREWALL_MANUAL.md +419 -0
package/doc/HOOKS_REFERENCE_IMPROVED.md +599 -0
package/doc/MANUAL_API_SDK.md +539 -0
package/doc/MANUAL_MVC.md +397 -0
package/doc/MARIADB_TOKENS_IMPLEMENTATION.md +113 -0
package/doc/MIDDLEWARE_MANUAL.md +521 -0
package/doc/OAUTH2_GOOGLE_MANUAL.md +408 -0
package/doc/frontend-and-sessions.md +356 -0
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/frontend/README.md +71 -0
package/examples/frontend/app.js +71 -0
package/examples/frontend/controllers/apiController.js +39 -0
package/examples/frontend/controllers/authController.js +220 -0
package/examples/frontend/controllers/formController.js +47 -0
package/examples/frontend/controllers/messageController.js +96 -0
package/examples/frontend/controllers/pageController.js +178 -0
package/examples/frontend/controllers/staticController.js +167 -0
package/examples/frontend/routes.json +90 -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/public/README.md +92 -0
package/examples/public/app.js +72 -0
package/examples/public/controllers/healthController.js +20 -0
package/examples/public/controllers/mainController.js +22 -0
package/examples/public/controllers/userController.js +139 -0
package/examples/public/routes.json +51 -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/generate_token.js +10 -0
package/index.js +85 -0
package/jerk.jpg +0 -0
package/lib/core/handler.js +86 -0
package/lib/core/hooks.js +224 -0
package/lib/core/router.js +204 -0
package/lib/core/securityEnhancedServer.js +752 -0
package/lib/core/server.js +369 -0
package/lib/loader/controllerLoader.js +175 -0
package/lib/loader/routeLoader.js +341 -0
package/lib/middleware/auditLogger.js +208 -0
package/lib/middleware/authenticator.js +565 -0
package/lib/middleware/compressor.js +218 -0
package/lib/middleware/cors.js +135 -0
package/lib/middleware/firewall.js +443 -0
package/lib/middleware/rateLimiter.js +210 -0
package/lib/middleware/session.js +301 -0
package/lib/middleware/validator.js +193 -0
package/lib/mvc/controllerBase.js +207 -0
package/lib/mvc/viewEngine.js +752 -0
package/lib/utils/configParser.js +223 -0
package/lib/utils/logger.js +145 -0
package/lib/utils/mariadbTokenAdapter.js +226 -0
package/lib/utils/openapiGenerator.js +140 -0
package/lib/utils/sqliteTokenAdapter.js +224 -0
package/lib/utils/tokenManager.js +254 -0
package/package.json +47 -0
package/v2examplle/v2_json_auth/README.md +83 -0
package/v2examplle/v2_json_auth/app.js +72 -0
package/v2examplle/v2_json_auth/controllers/authController.js +67 -0
package/v2examplle/v2_json_auth/controllers/mainController.js +16 -0
package/v2examplle/v2_json_auth/controllers/protectedController.js +12 -0
package/v2examplle/v2_json_auth/controllers/tokenController.js +28 -0
package/v2examplle/v2_json_auth/controllers/userController.js +15 -0
package/v2examplle/v2_json_auth/package.json +26 -0
package/v2examplle/v2_json_auth/routes.json +37 -0
package/v2examplle/v2_json_auth/tokens.json +20 -0
package/v2examplle/v2_mariadb_auth/README.md +94 -0
package/v2examplle/v2_mariadb_auth/app.js +81 -0
package/v2examplle/v2_mariadb_auth/controllers/authController.js +95 -0
package/v2examplle/v2_mariadb_auth/controllers/mainController.js +31 -0
package/v2examplle/v2_mariadb_auth/controllers/protectedController.js +12 -0
package/v2examplle/v2_mariadb_auth/controllers/userController.js +17 -0
package/v2examplle/v2_mariadb_auth/package.json +27 -0
package/v2examplle/v2_mariadb_auth/routes.json +37 -0
package/v2examplle/v2_sqlite_auth/README.md +72 -0
package/v2examplle/v2_sqlite_auth/app.js +74 -0
package/v2examplle/v2_sqlite_auth/app_fixed.js +74 -0
package/v2examplle/v2_sqlite_auth/controllers/authController.js +64 -0
package/v2examplle/v2_sqlite_auth/controllers/mainController.js +24 -0
package/v2examplle/v2_sqlite_auth/controllers/protectedController.js +12 -0
package/v2examplle/v2_sqlite_auth/controllers/userController.js +16 -0
package/v2examplle/v2_sqlite_auth/package.json +27 -0
package/v2examplle/v2_sqlite_auth/routes.json +30 -0
package/v2examplle/v2_sqlite_auth/test_api.sh +47 -0
package/v2examplle/v2_sqlite_auth/tokens_example.sqlite +0 -0

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

@@ -0,0 +1,23 @@
+<!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; }
+        table { width: 100%; border-collapse: collapse; margin-top: 20px; }
+        th, td { padding: 10px; text-align: left; border-bottom: 1px solid #ddd; }
+        th { background-color: #f2f2f2; }
+        .active { color: green; }
+        .inactive { color: red; }
+    </style>
+</head>
+<body>
+    <div class="container">
+        {{content}}
+    </div>
+</body>
+</html>

package/examples/mvc_example/views/test.html ADDED Viewed

@@ -0,0 +1,3 @@
+<h1>{{title}}</h1>
+<p>{{message}}</p>
+<p>Prueba de variable simple: {{currentTime}}</p>

package/examples/mvc_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_example/views/user/list.html ADDED Viewed

@@ -0,0 +1,36 @@
+<h1>{{title}}</h1>
+{{if users}}
+<table>
+    <thead>
+        <tr>
+            <th>ID</th>
+            <th>Nombre</th>
+            <th>Email</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>
+                {{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 a la página de inicio</a>

package/examples/mvc_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_example/views/user/profile.html ADDED Viewed

@@ -0,0 +1,11 @@
+<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}}</p>
+</div>
+<a href="/users">Volver a la lista de usuarios</a>

package/examples/mvc_routes_example/app.js ADDED Viewed

@@ -0,0 +1,34 @@
+/**
+ * Ejemplo de uso del sistema MVC con definición de rutas desde archivo JSON
+ * Demostración de vistas, helpers y filtros
+ */
+const { APIServer, RouteLoader, ControllerLoader, ViewEngine } = require('../../index');
+// Crear instancia del servidor
+const server = new APIServer({
+  port: 9001,
+  host: 'localhost'
+});
+// Crear instancia del cargador de rutas
+const routeLoader = new RouteLoader();
+// Cargar las rutas desde el archivo JSON
+routeLoader.loadRoutes(server, './examples/mvc_routes_example/routes.json')
+  .then(routes => {
+    console.log(`${routes.length} rutas cargadas exitosamente`);
+    console.log('Rutas disponibles:');
+    console.log('- http://localhost:9001/ (Página de inicio)');
+    console.log('- http://localhost:9001/users (Lista de usuarios)');
+    console.log('- http://localhost:9001/profile?id=1 (Perfil de usuario)');
+    console.log('- http://localhost:9001/products (Catálogo de productos)');
+    // Iniciar el servidor
+    server.start(() => {
+      console.log('Servidor MVC con rutas JSON iniciado en http://localhost:9001');
+    });
+  })
+  .catch(error => {
+    console.error('Error al cargar las rutas:', error);
+  });

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

@@ -0,0 +1,27 @@
+const { ControllerBase } = require('../../../index');
+class MainController extends ControllerBase {
+  constructor(options = {}) {
+    super(options);
+  }
+  index(req, res) {
+    this.set('title', 'Inicio - Ejemplo MVC con Routes');
+    this.set('message', '¡Bienvenido al ejemplo de MVC con definición de rutas!');
+    this.render(res, 'main/index', {
+      currentTime: new Date().toISOString(),
+      version: '2.3.1'
+    });
+  }
+}
+// Exportar métodos directamente para que el RouteLoader pueda acceder a ellos
+const controllerInstance = new MainController({ viewsPath: './examples/mvc_routes_example/views' });
+module.exports = {
+  index: (req, res) => {
+    controllerInstance.setRequestResponse(req, res);
+    controllerInstance.index(req, res);
+  }
+};

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

@@ -0,0 +1,47 @@
+const { ControllerBase } = require('../../../index');
+class ProductController extends ControllerBase {
+  constructor(options = {}) {
+    super(options);
+    // Registrar helpers personalizados para este controlador
+    this.getViewEngine().addHelper('calculateDiscount', (price, discountPercent) => {
+      return price - (price * discountPercent / 100);
+    });
+    this.getViewEngine().addHelper('formatCurrency', (value, symbol = '$') => {
+      return `${symbol}${Number(value).toFixed(2)}`;
+    });
+    this.getViewEngine().addHelper('isOnSale', (product) => {
+      return product.discount > 0;
+    });
+  }
+  catalog(req, res) {
+    const products = [
+      { id: 1, name: 'Laptop Pro', price: 1200, discount: 10, category: 'Electronics' },
+      { id: 2, name: 'Mouse Inalámbrico', price: 25, discount: 15, category: 'Accessories' },
+      { id: 3, name: 'Teclado Mecánico', price: 80, discount: 0, category: 'Accessories' },
+      { id: 4, name: 'Monitor 4K', price: 400, discount: 20, category: 'Electronics' },
+      { id: 5, name: 'Auriculares', price: 150, discount: 5, category: 'Audio' }
+    ];
+    this.set('title', 'Catálogo de Productos');
+    this.set('products', products);
+    this.render(res, 'product/catalog', {
+      currencySymbol: 'USD'
+    });
+  }
+}
+// Exportar métodos directamente para que el RouteLoader pueda acceder a ellos
+const controllerInstance = new ProductController({ viewsPath: './examples/mvc_routes_example/views' });
+module.exports = {
+  catalog: (req, res) => {
+    controllerInstance.setRequestResponse(req, res);
+    controllerInstance.catalog(req, res);
+  }
+};

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/public/README.md ADDED Viewed

@@ -0,0 +1,92 @@
+# 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.
+## Características
+- API REST pública sin autenticación requerida
+- Endpoints para gestión de usuarios (CRUD completo)
+- Protección con CORS para permitir solicitudes desde cualquier origen
+- Rate limiting para prevenir abusos
+- Endpoints de salud del sistema
+- Controladores organizados por funcionalidad
+## Configuración
+1. Asegúrate de tener instaladas las dependencias del framework API SDK
+2. No se requiere configuración adicional para esta API pública
+## Uso
+1. Inicia el servidor:
+   ```bash
+   node app.js
+   ```
+2. El servidor escuchará en `http://localhost:8081`
+## Endpoints
+- `GET /` - Información general de la API (público)
+- `GET /users` - Lista todos los usuarios (público)
+- `GET /users/:id` - Obtiene un usuario específico (público)
+- `POST /users` - Crea un nuevo usuario (público)
+- `PUT /users/:id` - Actualiza un usuario existente (público)
+- `DELETE /users/:id` - Elimina un usuario (público)
+- `GET /health` - Verifica el estado del servicio (público)
+## Ejemplos de uso
+1. Obtener todos los usuarios:
+   ```bash
+   curl -X GET http://localhost:8081/users
+   ```
+2. Obtener un usuario específico:
+   ```bash
+   curl -X GET http://localhost:8081/users/1
+   ```
+3. Crear un nuevo usuario:
+   ```bash
+   curl -X POST http://localhost:8081/users \
+     -H "Content-Type: application/json" \
+     -d '{"name": "Nuevo Usuario", "email": "nuevo@ejemplo.com", "age": 28}'
+   ```
+4. Actualizar un usuario:
+   ```bash
+   curl -X PUT http://localhost:8081/users/1 \
+     -H "Content-Type: application/json" \
+     -d '{"name": "Usuario Actualizado", "email": "actualizado@ejemplo.com"}'
+   ```
+5. Eliminar un usuario:
+   ```bash
+   curl -X DELETE http://localhost:8081/users/1
+   ```
+6. Verificar estado del servicio:
+   ```bash
+   curl -X GET http://localhost:8081/health
+   ```
+## Estructura del proyecto
+```
+examples/public/
+├── app.js              # Punto de entrada de la aplicación
+├── routes.json         # Definición de rutas
+├── controllers/        # Controladores de las rutas
+│   ├── mainController.js
+│   ├── userController.js
+│   └── healthController.js
+└── README.md
+```
+## Seguridad
+- CORS configurado para permitir solicitudes desde cualquier origen
+- Rate limiting configurado para prevenir abusos (100 solicitudes por 15 minutos)
+- No se requiere autenticación para acceder a los endpoints
+- Validación de entrada en endpoints de creación/actualización

package/examples/public/app.js ADDED Viewed

@@ -0,0 +1,72 @@
+const {
+  APIServer,
+  Router,
+  RouteLoader,
+  Logger,
+  Cors,
+  RateLimiter
+} = require('../../index.js');
+async function startServer() {
+  // Crear instancia del servidor
+  const server = new APIServer({
+    port: 8081,
+    host: 'localhost',
+    requestTimeout: 30000, // 30 segundos
+    connectionTimeout: 30000 // 30 segundos
+  });
+  // Crear instancia del logger
+  const logger = new Logger({ level: 'info' });
+  try {
+    // Configurar CORS para permitir solicitudes desde cualquier origen
+    const cors = new Cors({
+      origin: '*',
+      methods: ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS'],
+      allowedHeaders: [
+        'Content-Type',
+        'Authorization',
+        'X-Requested-With',
+        'Accept',
+        'Origin'
+      ]
+    });
+    // Aplicar middleware de CORS
+    server.use(cors.middleware());
+    // Configurar Rate Limiter para prevenir abusos
+    const rateLimiter = new RateLimiter({
+      windowMs: 15 * 60 * 1000, // 15 minutos
+      maxRequests: 100 // Límite de 100 solicitudes por ventana
+    });
+    // Aplicar middleware de rate limiting
+    server.use(rateLimiter.middleware());
+    // Cargar rutas desde archivo JSON
+    const routeLoader = new RouteLoader();
+    await routeLoader.loadRoutes(server, './routes.json');
+    // Iniciar el servidor
+    server.start();
+    logger.info('Servidor público iniciado en http://localhost:8081');
+    logger.info('Endpoints disponibles:');
+    logger.info('- GET / (Información del API)');
+    logger.info('- GET /users (Lista de usuarios)');
+    logger.info('- GET /users/:id (Obtener usuario específico)');
+    logger.info('- POST /users (Crear nuevo usuario)');
+    logger.info('- PUT /users/:id (Actualizar usuario)');
+    logger.info('- DELETE /users/:id (Eliminar usuario)');
+  } catch (error) {
+    logger.error('Error iniciando el servidor:', error.message);
+    process.exit(1);
+  }
+}
+// Iniciar el servidor
+startServer();
+module.exports = { startServer };

package/examples/public/controllers/healthController.js ADDED Viewed

@@ -0,0 +1,20 @@
+const healthController = {
+  checkHealth: (req, res) => {
+    const healthStatus = {
+      status: 'healthy',
+      timestamp: new Date().toISOString(),
+      uptime: process.uptime(),
+      message: 'API Pública de Ejemplo está operando correctamente',
+      version: '1.0.0',
+      endpoints: {
+        total: 7,
+        active: true
+      }
+    };
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify(healthStatus));
+  }
+};
+module.exports = healthController;

package/examples/public/controllers/mainController.js ADDED Viewed

@@ -0,0 +1,22 @@
+const mainController = {
+  home: (req, res) => {
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    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',
+      endpoints: {
+        'GET /': 'Este mensaje',
+        'GET /users': 'Obtener lista de usuarios',
+        'GET /users/:id': 'Obtener usuario específico',
+        'POST /users': 'Crear nuevo usuario',
+        'PUT /users/:id': 'Actualizar usuario',
+        'DELETE /users/:id': 'Eliminar usuario',
+        'GET /health': 'Verificar estado del servicio'
+      },
+      documentation: 'Visita el README para más información sobre cómo usar esta API'
+    }));
+  }
+};
+module.exports = mainController;