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/v2_oauth/controllers/oauthController.js ADDED Viewed

@@ -0,0 +1,247 @@
+const jwt = require('jsonwebtoken');
+const { Authenticator, TokenManager } = require('../../../index.js');
+// TokenManager para este controlador
+const tokenManager = new TokenManager({
+  storage: 'memory'
+});
+const oauthController = {
+  initiateGoogleAuth: (req, res) => {
+    // Obtener las credenciales de OAuth
+    const clientId = process.env.OAUTH_CLIENT_ID;
+    const clientSecret = process.env.OAUTH_CLIENT_SECRET;
+    // Verificar si las credenciales están configuradas
+    if (!clientId || clientId === 'tu-client-id-aqui' || !clientSecret || clientSecret === 'tu-client-secret-aqui') {
+      res.writeHead(200, { 'Content-Type': 'text/html' });
+      res.end(`
+        <!DOCTYPE html>
+        <html>
+        <head>
+          <title>Configurar OAuth con Google</title>
+          <style>
+            body { font-family: Arial, sans-serif; margin: 40px; text-align: center; }
+            .container { max-width: 800px; margin: 0 auto; }
+            .setup-instructions {
+              margin: 20px 0;
+              padding: 20px;
+              background-color: #fff3cd;
+              border: 1px solid #ffeaa7;
+              border-radius: 4px;
+              text-align: left;
+            }
+            .credentials-form {
+              margin: 20px 0;
+              padding: 20px;
+              background-color: #f8f9fa;
+              border: 1px solid #dee2e6;
+              border-radius: 4px;
+            }
+            input[type="text"], input[type="password"] {
+              width: 100%;
+              padding: 8px;
+              margin: 5px 0;
+              box-sizing: border-box;
+            }
+            button {
+              background-color: #007bff;
+              color: white;
+              border: none;
+              padding: 10px 20px;
+              cursor: pointer;
+              margin: 10px 5px;
+            }
+            button:hover {
+              background-color: #0056b3;
+            }
+          </style>
+        </head>
+        <body>
+          <div class="container">
+            <h1>Configurar OAuth con Google</h1>
+            <div class="setup-instructions">
+              <h3>Para usar la autenticación OAuth real:</h3>
+              <ol>
+                <li>Registra tu aplicación en <a href="https://console.cloud.google.com/" target="_blank">Google Cloud Console</a></li>
+                <li>Ve a "APIs & Services" > "Credentials"</li>
+                <li>Crea un "OAuth 2.0 Client IDs"</li>
+                <li>Configura "Authorized redirect URIs" con: <code>http://localhost:8093/auth/callback</code></li>
+                <li>Copia tu Client ID y Client Secret</li>
+              </ol>
+            </div>
+            <div class="credentials-form">
+              <h3>Ingresa tus credenciales OAuth</h3>
+              <form id="credentialsForm">
+                <label for="clientId">Client ID:</label>
+                <input type="text" id="clientId" name="clientId" placeholder="Ingresa tu Client ID">
+                <label for="clientSecret">Client Secret:</label>
+                <input type="password" id="clientSecret" name="clientSecret" placeholder="Ingresa tu Client Secret">
+                <div style="margin-top: 15px;">
+                  <button type="submit">Guardar Credenciales</button>
+                  <button type="button" onclick="location.href='/'">Volver al inicio</button>
+                </div>
+              </form>
+              <div id="statusMessage" style="margin-top: 15px; display: none;"></div>
+            </div>
+            <script>
+              document.getElementById('credentialsForm').addEventListener('submit', function(e) {
+                e.preventDefault();
+                const clientId = document.getElementById('clientId').value;
+                const clientSecret = document.getElementById('clientSecret').value;
+                // Enviar credenciales al servidor
+                fetch('/auth/setup', {
+                  method: 'POST',
+                  headers: {
+                    'Content-Type': 'application/json'
+                  },
+                  body: JSON.stringify({ clientId, clientSecret })
+                })
+                .then(response => response.json())
+                .then(data => {
+                  const statusDiv = document.getElementById('statusMessage');
+                  statusDiv.style.display = 'block';
+                  if (data.success) {
+                    statusDiv.innerHTML = '<p style="color: green;">Credenciales guardadas exitosamente. <a href="/auth/google">Haz clic aquí para iniciar OAuth</a></p>';
+                    document.getElementById('credentialsForm').reset();
+                  } else {
+                    statusDiv.innerHTML = '<p style="color: red;">Error: ' + data.message + '</p>';
+                  }
+                })
+                .catch(error => {
+                  console.error('Error:', error);
+                  document.getElementById('statusMessage').innerHTML = '<p style="color: red;">Error al guardar credenciales</p>';
+                  document.getElementById('statusMessage').style.display = 'block';
+                });
+              });
+            </script>
+          </div>
+        </body>
+        </html>
+      `);
+      return;
+    }
+    // Si las credenciales están configuradas, crear la URL de autorización OAuth
+    const redirectUri = encodeURIComponent('http://localhost:8093/auth/callback');
+    const scope = encodeURIComponent('email profile');
+    const authUrl = `https://accounts.google.com/o/oauth2/v2/auth?` +
+      `client_id=${clientId}&` +
+      `redirect_uri=${redirectUri}&` +
+      `response_type=code&` +
+      `scope=${scope}&` +
+      `access_type=offline&` +
+      `prompt=consent`;
+    // Redirigir al usuario a la URL de autorización de Google
+    res.writeHead(302, { 'Location': authUrl });
+    res.end();
+  },
+  handleCallback: async (req, res) => {
+    const { code } = req.query;
+    if (!code) {
+      res.writeHead(400, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify({ error: 'No authorization code received' }));
+      return;
+    }
+    try {
+      // En una implementación real, intercambiaríamos el código por tokens de acceso
+      const clientId = process.env.OAUTH_CLIENT_ID;
+      const clientSecret = process.env.OAUTH_CLIENT_SECRET;
+      const redirectUri = 'http://localhost:8093/auth/callback';
+      // Simular la obtención de tokens (en una implementación real, haríamos una solicitud HTTP real)
+      // Aquí es donde el framework realmente haría el trabajo pesado
+      // Simular la obtención de información del usuario desde Google
+      // En una implementación real, usaríamos el access token para llamar a la API de Google
+      const userInfo = {
+        id: 'demo_user_id',
+        email: 'demo@example.com',
+        name: 'Demo User',
+        picture: 'https://via.placeholder.com/150'
+      };
+      // Generar un token JWT para el usuario autenticado
+      const secret = 'super-secret-key-for-oauth-example';
+      const tokenPayload = {
+        userId: userInfo.id,
+        email: userInfo.email,
+        name: userInfo.name,
+        provider: 'google',
+        iat: Math.floor(Date.now() / 1000),
+        exp: Math.floor(Date.now() / 1000) + (60 * 60) // Expira en 1 hora
+      };
+      const token = jwt.sign(tokenPayload, secret);
+      // Enviar respuesta con el token
+      res.writeHead(200, { 'Content-Type': 'text/html' });
+      res.end(`
+        <h2>¡Autenticación OAuth exitosa!</h2>
+        <p>Usuario autenticado: <strong>${userInfo.name}</strong></p>
+        <p>Email: <strong>${userInfo.email}</strong></p>
+        <p>Proveedor: <strong>Google</strong></p>
+        <div style="margin: 20px 0; padding: 15px; background-color: #d4edda; border: 1px solid #c3e6cb; border-radius: 4px;">
+          <p><strong>Token JWT generado:</strong></p>
+          <textarea readonly style="width: 100%; height: 80px; font-family: monospace;">${token}</textarea>
+          <p>Este token puede usarse en el header <code>Authorization: Bearer &lt;token&gt;</code> para acceder a endpoints protegidos</p>
+        </div>
+        <p><a href="/profile">Ir al perfil del usuario</a> | <a href="/">Volver a la página principal</a></p>
+      `);
+    } catch (error) {
+      console.error('Error en el callback OAuth:', error);
+      res.writeHead(500, { 'Content-Type': 'text/html' });
+      res.end(`
+        <h2>Error en el proceso de autenticación</h2>
+        <p>${error.message}</p>
+        <p><a href="/auth/google">Intentar de nuevo</a></p>
+      `);
+    }
+  },
+  setupCredentials: (req, res) => {
+    // Este endpoint es para fines de demostración
+    // En una implementación real, las credenciales se configurarían en variables de entorno
+    let body = '';
+    req.on('data', chunk => {
+      body += chunk.toString();
+    });
+    req.on('end', () => {
+      try {
+        const data = JSON.parse(body);
+        // En una implementación real, esto se haría de forma segura
+        // Aquí solo simulamos el proceso para fines de demostración
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({
+          success: true,
+          message: 'Credenciales recibidas. En una implementación real, estas se configurarían como variables de entorno.'
+        }));
+      } catch (error) {
+        res.writeHead(400, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({
+          success: false,
+          message: 'Error al procesar las credenciales'
+        }));
+      }
+    });
+  }
+};
+module.exports = oauthController;

package/examples/v2_oauth/controllers/protectedController.js ADDED Viewed

@@ -0,0 +1,13 @@
+const protectedController = {
+  getProtectedData: (req, res) => {
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({
+      message: 'Datos protegidos accesados exitosamente',
+      user: req.user,
+      timestamp: new Date().toISOString(),
+      provider: 'Este contenido fue protegido usando autenticación JWT generada tras OAuth'
+    }));
+  }
+};
+module.exports = protectedController;

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

@@ -0,0 +1,17 @@
+const userController = {
+  getProfile: (req, res) => {
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({
+      profile: {
+        id: req.user.userId,
+        email: req.user.email,
+        name: req.user.name,
+        provider: req.user.provider,
+        authenticatedAt: new Date().toISOString()
+      },
+      message: 'Perfil de usuario obtenido exitosamente'
+    }));
+  }
+};
+module.exports = userController;

package/examples/v2_oauth/package.json ADDED Viewed

@@ -0,0 +1,26 @@
+{
+  "name": "api-sdk-oauth-example",
+  "version": "1.0.0",
+  "description": "Ejemplo de API con funcionalidad OAuth 2.0 usando el Framework API SDK",
+  "main": "app.js",
+  "scripts": {
+    "start": "node app.js",
+    "dev": "nodemon app.js"
+  },
+  "keywords": [
+    "api",
+    "sdk",
+    "oauth",
+    "oauth2",
+    "authentication",
+    "framework"
+  ],
+  "author": "API SDK Framework",
+  "license": "MIT",
+  "dependencies": {
+    "jsonwebtoken": "^9.0.0"
+  },
+  "devDependencies": {
+    "nodemon": "^3.0.0"
+  }
+}

package/examples/v2_oauth/routes.json ADDED Viewed

@@ -0,0 +1,44 @@
+[
+  {
+    "path": "/",
+    "method": "GET",
+    "controller": "./controllers/mainController.js",
+    "handler": "home",
+    "auth": "none"
+  },
+  {
+    "path": "/auth/google",
+    "method": "GET",
+    "controller": "./controllers/oauthController.js",
+    "handler": "initiateGoogleAuth",
+    "auth": "none"
+  },
+  {
+    "path": "/auth/callback",
+    "method": "GET",
+    "controller": "./controllers/oauthController.js",
+    "handler": "handleCallback",
+    "auth": "none"
+  },
+  {
+    "path": "/auth/setup",
+    "method": "POST",
+    "controller": "./controllers/oauthController.js",
+    "handler": "setupCredentials",
+    "auth": "none"
+  },
+  {
+    "path": "/profile",
+    "method": "GET",
+    "controller": "./controllers/userController.js",
+    "handler": "getProfile",
+    "auth": "jwt-oauth"
+  },
+  {
+    "path": "/protected",
+    "method": "GET",
+    "controller": "./controllers/protectedController.js",
+    "handler": "getProtectedData",
+    "auth": "jwt-oauth"
+  }
+]

package/examples/v2_openapi/README.md ADDED Viewed

@@ -0,0 +1,77 @@
+# Ejemplo API con Funcionalidad OpenAPI
+Este ejemplo demuestra cómo crear una API con funcionalidad OpenAPI integrada utilizando el Framework API SDK.
+## Características
+- API con autenticación JWT
+- Documentación OpenAPI 3.0 generada automáticamente
+- Interfaz Swagger UI para explorar y probar la API
+- Rutas protegidas y públicas
+- Controladores organizados por funcionalidad
+- Esquemas OpenAPI definidos para modelos de datos
+## Configuración
+No se requieren dependencias adicionales más allá del Framework API SDK.
+## Uso
+1. Inicia el servidor:
+   ```bash
+   node app.js
+   ```
+2. El servidor escuchará en `http://localhost:8092`
+## Endpoints
+- `GET /` - Página de inicio
+- `POST /login` - Iniciar sesión y obtener token
+- `GET /users` - Lista de usuarios (requiere token)
+- `GET /products` - Lista de productos (requiere token)
+- `GET /profile` - Perfil de usuario (requiere token)
+- `GET /docs` - Documentación interactiva OpenAPI/Swagger
+- `GET /openapi.json` - Especificación OpenAPI
+## Ejemplo de uso
+1. Iniciar sesión:
+   ```bash
+   curl -X POST http://localhost:8092/login \
+     -H "Content-Type: application/json" \
+     -d '{"username": "admin", "password": "password"}'
+   ```
+2. Acceder a usuarios con el token:
+   ```bash
+   curl -X GET http://localhost:8092/users \
+     -H "Authorization: Bearer TU_TOKEN_AQUI"
+   ```
+3. Ver documentación interactiva:
+   Visita `http://localhost:8092/docs` en tu navegador
+## Estructura del proyecto
+```
+examples/v2_openapi/
+├── app.js              # Punto de entrada de la aplicación
+├── routes.json         # Definición de rutas
+├── controllers/        # Controladores de las rutas
+│   ├── mainController.js
+│   ├── authController.js
+│   ├── userController.js
+│   └── productController.js
+└── README.md
+```
+## Documentación OpenAPI
+El framework genera automáticamente:
+- Una especificación OpenAPI 3.0 en `/openapi.json`
+- Una interfaz Swagger UI interactiva en `/docs`
+- Esquemas de datos definidos para reutilización
+- Documentación detallada de endpoints, parámetros y respuestas
+- Soporte para diferentes códigos de respuesta HTTP
+- Definición de esquemas de seguridad

package/examples/v2_openapi/app.js ADDED Viewed

@@ -0,0 +1,222 @@
+const {
+  APIServer,
+  Authenticator,
+  RouteLoader,
+  Logger,
+  OpenApiGenerator,
+  TokenManager
+} = require('../../index.js');
+async function startServer() {
+  // Crear instancia del servidor
+  const server = new APIServer({
+    port: 8092,
+    host: 'localhost'
+  });
+  // Crear instancia del logger
+  const logger = new Logger({ level: 'info' });
+  try {
+    // Crear instancia del TokenManager con almacenamiento en memoria
+    const tokenManager = new TokenManager({
+      storage: 'memory'
+    });
+    // Crear instancia del autenticador
+    const authenticator = new Authenticator({ logger });
+    // Registrar estrategia de autenticación JWT
+    authenticator.use('jwt-openapi', async (req, options = {}) => {
+      const authHeader = req.headers.authorization;
+      const token = authHeader && authHeader.split(' ')[1]; // Bearer TOKEN
+      if (!token) {
+        return false;
+      }
+      // Validar el token usando un secreto fijo para este ejemplo
+      const secret = 'super-secret-key-for-openapi-example';
+      const decoded = tokenManager.validateToken(token, secret);
+      if (decoded) {
+        req.user = decoded;
+        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');
+    // Crear instancia del generador de OpenAPI
+    const openApiGenerator = new OpenApiGenerator({
+      title: 'API de Ejemplo con OpenAPI',
+      description: 'Una API de ejemplo que demuestra la funcionalidad OpenAPI del Framework API SDK',
+      version: '1.0.0',
+      servers: [
+        { url: 'http://localhost:8092', description: 'Servidor de desarrollo' }
+      ]
+    });
+    // Agregar esquemas a la documentación
+    openApiGenerator.addSchema('User', {
+      type: 'object',
+      properties: {
+        id: { type: 'integer', example: 1 },
+        name: { type: 'string', example: 'John Doe' },
+        email: { type: 'string', example: 'john@example.com' },
+        role: { type: 'string', example: 'user' }
+      }
+    });
+    openApiGenerator.addSchema('Product', {
+      type: 'object',
+      properties: {
+        id: { type: 'integer', example: 1 },
+        name: { type: 'string', example: 'Laptop' },
+        price: { type: 'number', example: 999.99 },
+        category: { type: 'string', example: 'Electronics' }
+      }
+    });
+    openApiGenerator.addSchema('ApiResponse', {
+      type: 'object',
+      properties: {
+        success: { type: 'boolean', example: true },
+        message: { type: 'string', example: 'Operación exitosa' },
+        data: { type: 'object', description: 'Datos de la respuesta' }
+      }
+    });
+    // Agregar esquema de seguridad
+    openApiGenerator.addSecurityScheme('bearerAuth', {
+      type: 'http',
+      scheme: 'bearer',
+      bearerFormat: 'JWT',
+      description: 'Autenticación por token JWT'
+    });
+    // Agregar rutas a la documentación OpenAPI
+    openApiGenerator.addRoute({
+      path: '/users',
+      method: 'GET',
+      config: {
+        summary: 'Obtener todos los usuarios',
+        description: 'Devuelve una lista de todos los usuarios registrados',
+        security: [{ bearerAuth: [] }],
+        responses: {
+          '200': {
+            description: 'Lista de usuarios',
+            content: {
+              'application/json': {
+                schema: {
+                  type: 'array',
+                  items: {
+                    $ref: '#/components/schemas/User'
+                  }
+                }
+              }
+            }
+          },
+          '401': {
+            description: 'No autorizado - Token inválido o ausente'
+          }
+        }
+      }
+    });
+    openApiGenerator.addRoute({
+      path: '/products',
+      method: 'GET',
+      config: {
+        summary: 'Obtener todos los productos',
+        description: 'Devuelve una lista de todos los productos disponibles',
+        security: [{ bearerAuth: [] }],
+        responses: {
+          '200': {
+            description: 'Lista de productos',
+            content: {
+              'application/json': {
+                schema: {
+                  type: 'array',
+                  items: {
+                    $ref: '#/components/schemas/Product'
+                  }
+                }
+              }
+            }
+          },
+          '401': {
+            description: 'No autorizado - Token inválido o ausente'
+          }
+        }
+      }
+    });
+    openApiGenerator.addRoute({
+      path: '/login',
+      method: 'POST',
+      config: {
+        summary: 'Iniciar sesión',
+        description: 'Autenticación de usuario y obtención de token JWT',
+        requestBody: {
+          content: {
+            'application/json': {
+              schema: {
+                type: 'object',
+                properties: {
+                  username: { type: 'string', example: 'admin' },
+                  password: { type: 'string', example: 'password' }
+                },
+                required: ['username', 'password']
+              }
+            }
+          }
+        },
+        responses: {
+          '200': {
+            description: 'Inicio de sesión exitoso',
+            content: {
+              'application/json': {
+                schema: {
+                  type: 'object',
+                  properties: {
+                    message: { type: 'string', example: 'Inicio de sesión exitoso' },
+                    token: { type: 'string', example: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...' },
+                    user: { $ref: '#/components/schemas/User' }
+                  }
+                }
+              }
+            }
+          },
+          '401': {
+            description: 'Credenciales inválidas'
+          }
+        }
+      }
+    });
+    // Agregar ruta de documentación al servidor
+    openApiGenerator.addDocumentationRoute(server);
+    // Iniciar el servidor
+    server.start();
+    logger.info('Servidor iniciado en http://localhost:8092');
+    logger.info('Documentación OpenAPI disponible en http://localhost:8092/docs');
+  } catch (error) {
+    logger.error('Error iniciando el servidor:', error.message);
+    process.exit(1);
+  }
+}
+// Iniciar el servidor
+startServer();
+module.exports = { startServer };