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/frontend/controllers/messageController.js ADDED Viewed

@@ -0,0 +1,96 @@
+const sqlite3 = require('sqlite3').verbose();
+const path = require('path');
+class MessageController {
+  constructor() {
+    // Usar una base de datos SQLite en memoria para este ejemplo
+    // En una aplicación real, usarías una ruta a un archivo
+    this.db = new sqlite3.Database(':memory:');
+    this.initDatabase();
+  }
+  initDatabase() {
+    // Crear tabla de mensajes
+    this.db.serialize(() => {
+      this.db.run(`
+        CREATE TABLE messages (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          name TEXT NOT NULL,
+          email TEXT NOT NULL,
+          message TEXT NOT NULL,
+          created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+        )
+      `);
+      // Crear tabla de usuarios para login
+      this.db.run(`
+        CREATE TABLE users (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          username TEXT UNIQUE NOT NULL,
+          password TEXT NOT NULL,
+          created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+        )
+      `);
+      // Insertar un usuario de ejemplo para pruebas
+      this.db.run("INSERT OR IGNORE INTO users (username, password) VALUES (?, ?)", ['admin', 'password123']);
+    });
+  }
+  // Guardar un mensaje en la base de datos
+  saveMessage(name, email, message) {
+    return new Promise((resolve, reject) => {
+      const stmt = this.db.prepare("INSERT INTO messages (name, email, message) VALUES (?, ?, ?)");
+      stmt.run([name, email, message], function(err) {
+        if (err) {
+          console.error('Error guardando mensaje:', err);
+          reject(err);
+        } else {
+          console.log(`Mensaje guardado con ID: ${this.lastID}`);
+          resolve(this.lastID);
+        }
+      });
+      stmt.finalize();
+    });
+  }
+  // Obtener todos los mensajes
+  getMessages() {
+    return new Promise((resolve, reject) => {
+      this.db.all("SELECT * FROM messages ORDER BY created_at DESC", [], (err, rows) => {
+        if (err) {
+          console.error('Error obteniendo mensajes:', err);
+          reject(err);
+        } else {
+          resolve(rows);
+        }
+      });
+    });
+  }
+  // Validar credenciales de usuario
+  validateUser(username, password) {
+    return new Promise((resolve, reject) => {
+      this.db.get("SELECT * FROM users WHERE username = ?", [username], (err, row) => {
+        if (err) {
+          console.error('Error validando usuario:', err);
+          reject(err);
+        } else if (row && row.password === password) {
+          resolve(row);
+        } else {
+          resolve(null);
+        }
+      });
+    });
+  }
+  // Cerrar la base de datos
+  close() {
+    this.db.close();
+  }
+}
+// Instancia global para compartir la base de datos
+const messageController = new MessageController();
+module.exports = messageController;

package/examples/frontend/controllers/pageController.js ADDED Viewed

@@ -0,0 +1,178 @@
+const messageController = require('./messageController');
+const pageController = {
+  homePage: (req, res) => {
+    const html = `
+<!DOCTYPE html>
+<html lang="es">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Inicio - API Frontend Demo</title>
+    <link rel="stylesheet" href="/styles.css">
+</head>
+<body>
+    <div class="container">
+        <header>
+            <h1>Bienvenido a la API Frontend Demo</h1>
+            <nav>
+                <ul>
+                    <li><a href="/">Inicio</a></li>
+                    <li><a href="/about">Acerca de</a></li>
+                    <li><a href="/contact">Contacto</a></li>
+                    <li><a href="/login">Login</a></li>
+                    <li><a href="/api/users">Usuarios (API)</a></li>
+                </ul>
+            </nav>
+        </header>
+        <main>
+            <section class="hero">
+                <h2>Framework API SDK 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>
+            <section class="features">
+                <h3>Características</h3>
+                <ul>
+                    <li>Soporte para múltiples content-types</li>
+                    <li>Rutas parametrizadas</li>
+                    <li>Middleware de seguridad</li>
+                    <li>CORS configurado</li>
+                </ul>
+            </section>
+        </main>
+        <footer>
+            <p>&copy; 2026 API SDK JS Framework</p>
+        </footer>
+    </div>
+    <script src="/script.js"></script>
+</body>
+</html>`;
+    res.writeHead(200);
+    res.end(html);
+  },
+  aboutPage: (req, res) => {
+    const html = `
+<!DOCTYPE html>
+<html lang="es">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Acerca de - API Frontend Demo</title>
+    <link rel="stylesheet" href="/styles.css">
+</head>
+<body>
+    <div class="container">
+        <header>
+            <h1>Acerca de API Frontend Demo</h1>
+            <nav>
+                <ul>
+                    <li><a href="/">Inicio</a></li>
+                    <li><a href="/about">Acerca de</a></li>
+                    <li><a href="/contact">Contacto</a></li>
+                    <li><a href="/login">Login</a></li>
+                    <li><a href="/api/users">Usuarios (API)</a></li>
+                </ul>
+            </nav>
+        </header>
+        <main>
+            <section>
+                <h2>Nuestro Framework</h2>
+                <p>El Framework API SDK 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>
+                <h3>Características Técnicas</h3>
+                <ul>
+                    <li>Arquitectura modular</li>
+                    <li>Sistema de hooks y filtros</li>
+                    <li>Seguridad avanzada (WAF)</li>
+                    <li>Soporte para múltiples métodos de autenticación</li>
+                    <li>Almacenamiento de tokens flexible</li>
+                </ul>
+            </section>
+        </main>
+        <footer>
+            <p>&copy; 2026 API SDK JS Framework</p>
+        </footer>
+    </div>
+    <script src="/script.js"></script>
+</body>
+</html>`;
+    res.writeHead(200);
+    res.end(html);
+  },
+  contactPage: (req, res) => {
+    const html = `
+<!DOCTYPE html>
+<html lang="es">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Contacto - API Frontend Demo</title>
+    <link rel="stylesheet" href="/styles.css">
+</head>
+<body>
+    <div class="container">
+        <header>
+            <h1>Formulario de Contacto</h1>
+            <nav>
+                <ul>
+                    <li><a href="/">Inicio</a></li>
+                    <li><a href="/about">Acerca de</a></li>
+                    <li><a href="/contact">Contacto</a></li>
+                    <li><a href="/login">Login</a></li>
+                    <li><a href="/api/users">Usuarios (API)</a></li>
+                </ul>
+            </nav>
+        </header>
+        <main>
+            <section>
+                <form id="contactForm">
+                    <div class="form-group">
+                        <label for="name">Nombre:</label>
+                        <input type="text" id="name" name="name" required>
+                    </div>
+                    <div class="form-group">
+                        <label for="email">Email:</label>
+                        <input type="email" id="email" name="email" required>
+                    </div>
+                    <div class="form-group">
+                        <label for="message">Mensaje:</label>
+                        <textarea id="message" name="message" rows="5" required></textarea>
+                    </div>
+                    <button type="submit">Enviar</button>
+                </form>
+                <div id="response"></div>
+            </section>
+        </main>
+        <footer>
+            <p>&copy; 2026 API SDK JS Framework</p>
+        </footer>
+    </div>
+    <script src="/script.js"></script>
+</body>
+</html>`;
+    res.writeHead(200);
+    res.end(html);
+  }
+};
+module.exports = pageController;

package/examples/frontend/controllers/staticController.js ADDED Viewed

@@ -0,0 +1,167 @@
+const staticController = {
+  getCSS: (req, res) => {
+    const css = `
+body {
+    font-family: Arial, sans-serif;
+    margin: 0;
+    padding: 0;
+    background-color: #f5f5f5;
+}
+.container {
+    max-width: 1200px;
+    margin: 0 auto;
+    padding: 20px;
+}
+header {
+    background-color: #333;
+    color: white;
+    padding: 1rem;
+    border-radius: 5px;
+}
+header h1 {
+    margin: 0;
+}
+nav ul {
+    list-style-type: none;
+    padding: 0;
+    margin: 10px 0 0 0;
+}
+nav ul li {
+    display: inline;
+    margin-right: 20px;
+}
+nav ul li a {
+    color: white;
+    text-decoration: none;
+    padding: 5px 10px;
+    border-radius: 3px;
+    transition: background-color 0.3s;
+}
+nav ul li a:hover {
+    background-color: #555;
+}
+main {
+    margin-top: 20px;
+}
+.hero {
+    background-color: white;
+    padding: 2rem;
+    border-radius: 5px;
+    box-shadow: 0 2px 5px rgba(0,0,0,0.1);
+}
+.features {
+    background-color: white;
+    padding: 2rem;
+    margin-top: 20px;
+    border-radius: 5px;
+    box-shadow: 0 2px 5px rgba(0,0,0,0.1);
+}
+.form-group {
+    margin-bottom: 15px;
+}
+.form-group label {
+    display: block;
+    margin-bottom: 5px;
+    font-weight: bold;
+}
+.form-group input,
+.form-group textarea {
+    width: 100%;
+    padding: 8px;
+    border: 1px solid #ccc;
+    border-radius: 4px;
+    box-sizing: border-box;
+}
+button {
+    background-color: #007bff;
+    color: white;
+    padding: 10px 20px;
+    border: none;
+    border-radius: 4px;
+    cursor: pointer;
+    font-size: 16px;
+}
+button:hover {
+    background-color: #0056b3;
+}
+footer {
+    margin-top: 30px;
+    text-align: center;
+    padding: 20px;
+    color: #666;
+    border-top: 1px solid #ddd;
+}`;
+    res.writeHead(200);
+    res.end(css);
+  },
+  getJS: (req, res) => {
+    const js = `
+document.addEventListener('DOMContentLoaded', function() {
+    const contactForm = document.getElementById('contactForm');
+    if (contactForm) {
+        contactForm.addEventListener('submit', function(e) {
+            e.preventDefault();
+            const formData = new FormData(contactForm);
+            const data = Object.fromEntries(formData);
+            // Enviar datos al servidor
+            fetch('/api/contact', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify(data)
+            })
+            .then(response => response.json())
+            .then(result => {
+                const responseDiv = document.getElementById('response');
+                if (result.success) {
+                    responseDiv.innerHTML = '<p style="color: green;">' + result.message + '</p>';
+                    contactForm.reset();
+                } else {
+                    responseDiv.innerHTML = '<p style="color: red;">Error: ' + result.message + '</p>';
+                }
+                // Ocultar mensaje después de 5 segundos
+                setTimeout(() => {
+                    responseDiv.innerHTML = '';
+                }, 5000);
+            })
+            .catch(error => {
+                console.error('Error:', error);
+                const responseDiv = document.getElementById('response');
+                responseDiv.innerHTML = '<p style="color: red;">Error de conexión</p>';
+            });
+        });
+    }
+    console.log('API Frontend Demo cargado correctamente');
+});`;
+    res.writeHead(200);
+    res.end(js);
+  }
+};
+module.exports = staticController;

package/examples/frontend/routes.json ADDED Viewed

@@ -0,0 +1,90 @@
+[
+  {
+    "path": "/",
+    "method": "GET",
+    "controller": "./controllers/pageController.js",
+    "handler": "homePage",
+    "auth": "none",
+    "contentType": "text/html"
+  },
+  {
+    "path": "/about",
+    "method": "GET",
+    "controller": "./controllers/pageController.js",
+    "handler": "aboutPage",
+    "auth": "none",
+    "contentType": "text/html"
+  },
+  {
+    "path": "/contact",
+    "method": "GET",
+    "controller": "./controllers/pageController.js",
+    "handler": "contactPage",
+    "auth": "none",
+    "contentType": "text/html"
+  },
+  {
+    "path": "/login",
+    "method": "GET",
+    "controller": "./controllers/authController.js",
+    "handler": "showLoginPage",
+    "auth": "none",
+    "contentType": "text/html"
+  },
+  {
+    "path": "/messages",
+    "method": "GET",
+    "controller": "./controllers/authController.js",
+    "handler": "showMessages",
+    "auth": "session",
+    "contentType": "text/html"
+  },
+  {
+    "path": "/api/login",
+    "method": "POST",
+    "controller": "./controllers/authController.js",
+    "handler": "processLogin",
+    "auth": "none",
+    "contentType": "application/json"
+  },
+  {
+    "path": "/api/contact",
+    "method": "POST",
+    "controller": "./controllers/formController.js",
+    "handler": "processContactForm",
+    "auth": "none",
+    "contentType": "application/json"
+  },
+  {
+    "path": "/api/users",
+    "method": "GET",
+    "controller": "./controllers/apiController.js",
+    "handler": "getUsers",
+    "auth": "none",
+    "contentType": "application/json"
+  },
+  {
+    "path": "/api/users/:id",
+    "method": "GET",
+    "controller": "./controllers/apiController.js",
+    "handler": "getUserById",
+    "auth": "none",
+    "contentType": "application/json"
+  },
+  {
+    "path": "/styles.css",
+    "method": "GET",
+    "controller": "./controllers/staticController.js",
+    "handler": "getCSS",
+    "auth": "none",
+    "contentType": "text/css"
+  },
+  {
+    "path": "/script.js",
+    "method": "GET",
+    "controller": "./controllers/staticController.js",
+    "handler": "getJS",
+    "auth": "none",
+    "contentType": "application/javascript"
+  }
+]

package/examples/mvc_example/app.js ADDED Viewed

@@ -0,0 +1,138 @@
+/**
+ * Ejemplo de uso del sistema MVC para el framework API SDK
+ * Demostración de vistas y controladores MVC
+ */
+const { APIServer, Router, ControllerBase } = require('../../index');
+// Crear un controlador personalizado que extienda ControllerBase
+class HomeController extends ControllerBase {
+  constructor(options = {}) {
+    super(options);
+  }
+  // Acción para mostrar la página de inicio
+  index(req, res) {
+    // Establecer variables para la vista
+    this.set('title', 'Página de Inicio');
+    this.set('message', '¡Bienvenido al framework API SDK!');
+    this.set('users', [
+      { name: 'Juan', email: 'juan@example.com' },
+      { name: 'María', email: 'maria@example.com' },
+      { name: 'Pedro', email: 'pedro@example.com' }
+    ]);
+    // Renderizar la vista
+    this.render(res, 'home/index', {
+      currentTime: new Date().toISOString()
+    });
+  }
+  // Acción para mostrar el perfil de un usuario
+  profile(req, res) {
+    // Obtener el ID del usuario de los parámetros
+    const userIdParam = this.input('id', '1');
+    // Validar que el ID sea un número entero positivo (no solo que empiece con un número)
+    if (!/^\d+$/.test(userIdParam) || parseInt(userIdParam) <= 0) {
+      // Si no es un ID válido, mostrar error
+      this.set('title', 'ID de usuario inválido');
+      this.render(res, 'user/invalid', {
+        userId: userIdParam
+      });
+      return;
+    }
+    const userId = parseInt(userIdParam);
+    // Array real de usuarios
+    const users = [
+      { id: 1, name: 'Ana García', email: 'ana@example.com', registered: '2026-01-01T10:00:00Z', active: true },
+      { id: 2, name: 'Carlos López', email: 'carlos@example.com', registered: '2026-01-02T11:30:00Z', active: false },
+      { id: 3, name: 'Laura Martínez', email: 'laura@example.com', registered: '2026-01-03T14:20:00Z', active: true },
+      { id: 4, name: 'Pedro Rodríguez', email: 'pedro@example.com', registered: '2026-01-04T09:15:00Z', active: true },
+      { id: 5, name: 'María Sánchez', email: 'maria@example.com', registered: '2026-01-05T16:45:00Z', active: false }
+    ];
+    // Buscar el usuario por ID
+    const user = users.find(u => u.id === userId);
+    if (!user) {
+      // Si no se encuentra el usuario, mostrar error
+      this.set('title', 'Usuario no encontrado');
+      this.render(res, 'user/notfound', {
+        userId: userId
+      });
+      return;
+    }
+    // Establecer variables para la vista
+    this.set('title', `Perfil de ${user.name}`);
+    this.set('user', user);
+    // Renderizar la vista de perfil
+    this.render(res, 'user/profile');
+  }
+  // Acción para mostrar la lista de usuarios
+  users(req, res) {
+    // Array real de usuarios (el mismo que en profile para consistencia)
+    const users = [
+      { id: 1, name: 'Ana García', email: 'ana@example.com', registered: '2026-01-01T10:00:00Z', active: true },
+      { id: 2, name: 'Carlos López', email: 'carlos@example.com', registered: '2026-01-02T11:30:00Z', active: false },
+      { id: 3, name: 'Laura Martínez', email: 'laura@example.com', registered: '2026-01-03T14:20:00Z', active: true },
+      { id: 4, name: 'Pedro Rodríguez', email: 'pedro@example.com', registered: '2026-01-04T09:15:00Z', active: true },
+      { id: 5, name: 'María Sánchez', email: 'maria@example.com', registered: '2026-01-05T16:45:00Z', active: false }
+    ];
+    // Establecer variables para la vista
+    this.set('title', 'Lista de Usuarios');
+    this.set('users', users);
+    // Renderizar la vista de usuarios
+    this.render(res, 'user/list');
+  }
+}
+// Crear instancia del servidor
+const server = new APIServer({
+  port: 9000,
+  host: 'localhost'
+});
+// Crear instancia del router
+const router = new Router();
+// Crear instancia del controlador
+const homeController = new HomeController({ viewsPath: './examples/mvc_example/views' });
+// Definir rutas
+router
+  .get('/', (req, res) => {
+    // Establecer la solicitud y respuesta en el controlador
+    homeController.setRequestResponse(req, res);
+    homeController.index(req, res);
+  })
+  .get('/profile', (req, res) => {
+    homeController.setRequestResponse(req, res);
+    homeController.profile(req, res);
+  })
+  .get('/users', (req, res) => {
+    homeController.setRequestResponse(req, res);
+    homeController.users(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(() => {
+  console.log('Servidor MVC iniciado en http://localhost:9000');
+  console.log('Rutas disponibles:');
+  console.log('- http://localhost:9000/ (Página de inicio)');
+  console.log('- http://localhost:9000/profile?id=1 (Perfil de usuario)');
+  console.log('- http://localhost:9000/users (Lista de usuarios)');
+});

package/examples/mvc_example/views/home/index.html ADDED Viewed

@@ -0,0 +1,26 @@
+<h1>{{title}}</h1>
+<p>{{message}}</p>
+<h2>Usuarios Registrados</h2>
+{{if users}}
+<table>
+    <thead>
+        <tr>
+            <th>Nombre</th>
+            <th>Email</th>
+        </tr>
+    </thead>
+    <tbody>
+        {{foreach:users}}
+        <tr>
+            <td>{{item.name}}</td>
+            <td>{{item.email}}</td>
+        </tr>
+        {{endforeach}}
+    </tbody>
+</table>
+{{else}}
+<p>No hay usuarios registrados.</p>
+{{endif}}
+<p>Hora actual: {{currentTime}}</p>

package/examples/mvc_example/views/home/simple.html ADDED Viewed

@@ -0,0 +1,3 @@
+<h1>{{title}}</h1>
+<p>{{message}}</p>
+<p>Hora actual: {{currentTime}}</p>