jerkjs 2.1.1 → 2.1.2

package/examples/mvc_example/app.js

@@ -1,138 +0,0 @@
-/**
- * Ejemplo de uso del sistema MVC para el framework JERK
- * 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 JERK!');
-    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

@@ -1,26 +0,0 @@
-<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

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

package/examples/mvc_example/views/layout.html

@@ -1,23 +0,0 @@
-<!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

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

package/examples/mvc_example/views/user/invalid.html

@@ -1,6 +0,0 @@
-<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

@@ -1,36 +0,0 @@
-<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

@@ -1,6 +0,0 @@
-<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

@@ -1,11 +0,0 @@
-<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

@@ -1,34 +0,0 @@
-/**
- * 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

@@ -1,27 +0,0 @@
-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

@@ -1,47 +0,0 @@
-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

@@ -1,76 +0,0 @@
-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

@@ -1,30 +0,0 @@
-[
-  {
-    "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

@@ -1,31 +0,0 @@
-<!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

@@ -1,11 +0,0 @@
-<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

@@ -1,24 +0,0 @@
-<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

@@ -1,6 +0,0 @@
-<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

@@ -1,40 +0,0 @@
-<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

@@ -1,6 +0,0 @@
-<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

@@ -1,18 +0,0 @@
-<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

@@ -1,34 +0,0 @@
-# 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