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/lib/utils/openapiGenerator.js ADDED Viewed

@@ -0,0 +1,140 @@
+/**
+ * Generador de documentación OpenAPI para el framework API SDK
+ * Componente: lib/utils/openapiGenerator.js
+ */
+class OpenApiGenerator {
+  /**
+   * Constructor del generador de OpenAPI
+   * @param {Object} options - Opciones de configuración
+   * @param {string} options.title - Título de la API
+   * @param {string} options.description - Descripción de la API
+   * @param {string} options.version - Versión de la API
+   * @param {Array} options.servers - Servidores donde se aloja la API
+   */
+  constructor(options = {}) {
+    this.spec = {
+      openapi: '3.0.0',
+      info: {
+        title: options.title || 'API Documentation',
+        description: options.description || 'Generated by API SDK Framework',
+        version: options.version || '1.0.0'
+      },
+      servers: options.servers || [{ url: 'http://localhost:3000' }],
+      paths: {},
+      components: {
+        schemas: {},
+        securitySchemes: {}
+      }
+    };
+  }
+  /**
+   * Agrega una ruta a la documentación OpenAPI
+   * @param {Object} route - Definición de la ruta
+   * @param {string} route.path - Ruta del endpoint
+   * @param {string} route.method - Método HTTP
+   * @param {Object} route.config - Configuración del endpoint
+   */
+  addRoute(route) {
+    const { path, method, config = {} } = route;
+    if (!this.spec.paths[path]) {
+      this.spec.paths[path] = {};
+    }
+    this.spec.paths[path][method.toLowerCase()] = {
+      summary: config.summary || '',
+      description: config.description || '',
+      parameters: config.parameters || [],
+      requestBody: config.requestBody,
+      responses: config.responses || {
+        '200': {
+          description: 'Operación exitosa'
+        }
+      },
+      security: config.security || []
+    };
+  }
+  /**
+   * Agrega un esquema a la documentación
+   * @param {string} name - Nombre del esquema
+   * @param {Object} schema - Definición del esquema
+   */
+  addSchema(name, schema) {
+    this.spec.components.schemas[name] = schema;
+  }
+  /**
+   * Agrega un esquema de seguridad
+   * @param {string} name - Nombre del esquema de seguridad
+   * @param {Object} scheme - Definición del esquema de seguridad
+   */
+  addSecurityScheme(name, scheme) {
+    this.spec.components.securitySchemes[name] = scheme;
+  }
+  /**
+   * Agrega un requisito de seguridad global
+   * @param {Array} securityRequirement - Requisitos de seguridad
+   */
+  addGlobalSecurity(securityRequirement) {
+    if (!this.spec.security) {
+      this.spec.security = [];
+    }
+    this.spec.security.push(securityRequirement);
+  }
+  /**
+   * Genera la especificación OpenAPI completa
+   * @returns {Object} - Especificación OpenAPI
+   */
+  generateSpec() {
+    return this.spec;
+  }
+  /**
+   * Agrega rutas de documentación OpenAPI al servidor
+   * @param {Object} server - Instancia del servidor
+   */
+  addDocumentationRoute(server) {
+    // Ruta para obtener la especificación OpenAPI en formato JSON
+    server.addRoute('GET', '/openapi.json', (req, res) => {
+      const spec = this.generateSpec();
+      res.writeHead(200, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify(spec, null, 2));
+    });
+    // Ruta para la documentación interactiva con Swagger UI
+    server.addRoute('GET', '/docs', (req, res) => {
+      const swaggerHtml = `
+<!DOCTYPE html>
+<html>
+<head>
+  <title>API Documentation</title>
+  <link rel="stylesheet" type="text/css" href="https://unpkg.com/swagger-ui-dist@latest/swagger-ui.css" />
+</head>
+<body>
+  <div id="swagger-ui"></div>
+  <script src="https://unpkg.com/swagger-ui-dist@latest/swagger-ui-bundle.js"></script>
+  <script>
+    SwaggerUIBundle({
+      url: '/openapi.json',
+      dom_id: '#swagger-ui',
+      presets: [
+        SwaggerUIBundle.presets.apis,
+        SwaggerUIBundle.presets.standalone
+      ]
+    });
+  </script>
+</body>
+</html>`;
+      res.writeHead(200, { 'Content-Type': 'text/html' });
+      res.end(swaggerHtml);
+    });
+  }
+}
+module.exports = OpenApiGenerator;

package/lib/utils/sqliteTokenAdapter.js ADDED Viewed

@@ -0,0 +1,224 @@
+// lib/utils/sqliteTokenAdapter.js
+const sqlite3 = require('sqlite3').verbose();
+const path = require('path');
+class SQLiteTokenAdapter {
+  /**
+   * Constructor del adaptador
+   * @param {Object} config - Configuración de conexión
+   * @param {string} config.dbPath - Ruta a la base de datos SQLite
+   * @param {string} config.tableName - Nombre de la tabla de tokens
+   */
+  constructor(config) {
+    this.dbPath = config.dbPath || './tokens.sqlite';
+    this.tableName = config.tableName || 'tokens';
+    this.db = null;
+  }
+  /**
+   * Inicializa la conexión y la tabla de tokens
+   */
+  async initialize() {
+    return new Promise((resolve, reject) => {
+      this.db = new sqlite3.Database(this.dbPath, (err) => {
+        if (err) {
+          console.error('Error conectando a SQLite:', err.message);
+          reject(err);
+          return;
+        }
+        console.log(`✅ Conexión a SQLite establecida: ${this.dbPath}`);
+        // Crear tabla de tokens si no existe
+        this.initializeTable()
+          .then(() => {
+            console.log(`✅ Tabla ${this.tableName} inicializada correctamente`);
+            resolve();
+          })
+          .catch(reject);
+      });
+    });
+  }
+  /**
+   * Inicializa la tabla de tokens en la base de datos
+   */
+  async initializeTable() {
+    const createTableQuery = `
+      CREATE TABLE IF NOT EXISTS ${this.tableName} (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        token TEXT UNIQUE NOT NULL,
+        user_id INTEGER NOT NULL,
+        token_type TEXT DEFAULT 'access',
+        expires_at DATETIME NOT NULL,
+        created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+        revoked BOOLEAN DEFAULT 0
+      );
+      CREATE INDEX IF NOT EXISTS idx_user_id ON ${this.tableName} (user_id);
+      CREATE INDEX IF NOT EXISTS idx_token ON ${this.tableName} (token);
+      CREATE INDEX IF NOT EXISTS idx_expires_at ON ${this.tableName} (expires_at);
+    `;
+    return new Promise((resolve, reject) => {
+      this.db.run(createTableQuery, (err) => {
+        if (err) {
+          console.error('Error inicializando tabla de tokens:', err.message);
+          reject(err);
+        } else {
+          resolve();
+        }
+      });
+    });
+  }
+  /**
+   * Guarda un token en la base de datos
+   * @param {string} token - Token a guardar
+   * @param {Object} userData - Datos del usuario
+   * @param {string} tokenType - Tipo de token ('access' o 'refresh')
+   * @param {Date} expiresAt - Fecha de expiración
+   */
+  async saveToken(token, userData, tokenType = 'access', expiresAt) {
+    const insertQuery = `
+      INSERT INTO ${this.tableName} (token, user_id, token_type, expires_at)
+      VALUES (?, ?, ?, ?)
+    `;
+    return new Promise((resolve, reject) => {
+      this.db.run(insertQuery, [
+        token,
+        userData.userId || userData.id,
+        tokenType,
+        expiresAt.toISOString()
+      ], function(err) {
+        if (err) {
+          console.error('Error guardando token:', err.message);
+          reject(err);
+        } else {
+          console.log(`✅ Token ${tokenType} guardado para usuario ${userData.userId || userData.id}`);
+          resolve();
+        }
+      });
+    });
+  }
+  /**
+   * Verifica si un token existe y es válido
+   * @param {string} token - Token a verificar
+   * @returns {Object|null} - Datos del token o null si no es válido
+   */
+  async validateToken(token) {
+    const selectQuery = `
+      SELECT * FROM ${this.tableName}
+      WHERE token = ? AND revoked = 0 AND expires_at > datetime('now')
+    `;
+    return new Promise((resolve, reject) => {
+      this.db.get(selectQuery, [token], (err, row) => {
+        if (err) {
+          console.error('Error validando token:', err.message);
+          reject(err);
+        } else {
+          resolve(row || null);
+        }
+      });
+    });
+  }
+  /**
+   * Revoca un token
+   * @param {string} token - Token a revocar
+   * @returns {boolean} - True si se revocó exitosamente
+   */
+  async revokeToken(token) {
+    const updateQuery = `
+      UPDATE ${this.tableName}
+      SET revoked = 1
+      WHERE token = ?
+    `;
+    return new Promise((resolve, reject) => {
+      this.db.run(updateQuery, [token], function(err) {
+        if (err) {
+          console.error('Error revocando token:', err.message);
+          reject(err);
+        } else {
+          const revoked = this.changes > 0;
+          if (revoked) {
+            console.log(`✅ Token revocado: ${token.substring(0, 20)}...`);
+          } else {
+            console.log(`⚠️  Token no encontrado o ya revocado: ${token.substring(0, 20)}...`);
+          }
+          resolve(revoked);
+        }
+      });
+    });
+  }
+  /**
+   * Obtiene tokens de un usuario
+   * @param {number} userId - ID del usuario
+   * @returns {Array} - Array de tokens del usuario
+   */
+  async getUserTokens(userId) {
+    const selectQuery = `
+      SELECT * FROM ${this.tableName}
+      WHERE user_id = ? AND revoked = 0 AND expires_at > datetime('now')
+    `;
+    return new Promise((resolve, reject) => {
+      this.db.all(selectQuery, [userId], (err, rows) => {
+        if (err) {
+          console.error('Error obteniendo tokens de usuario:', err.message);
+          reject(err);
+        } else {
+          resolve(rows || []);
+        }
+      });
+    });
+  }
+  /**
+   * Limpia tokens expirados
+   */
+  async cleanupExpiredTokens() {
+    const deleteQuery = `
+      DELETE FROM ${this.tableName}
+      WHERE expires_at <= datetime('now')
+    `;
+    return new Promise((resolve, reject) => {
+      this.db.run(deleteQuery, function(err) {
+        if (err) {
+          console.error('Error limpiando tokens expirados:', err.message);
+          reject(err);
+        } else {
+          console.log(`✅ Eliminados ${this.changes} tokens expirados`);
+          resolve(this.changes);
+        }
+      });
+    });
+  }
+  /**
+   * Cierra la conexión a la base de datos
+   */
+  async close() {
+    if (this.db) {
+      return new Promise((resolve, reject) => {
+        this.db.close((err) => {
+          if (err) {
+            console.error('Error cerrando conexión a SQLite:', err.message);
+            reject(err);
+          } else {
+            console.log('🔒 Conexión a SQLite cerrada');
+            resolve();
+          }
+        });
+      });
+    }
+  }
+}
+module.exports = SQLiteTokenAdapter;

package/lib/utils/tokenManager.js ADDED Viewed

@@ -0,0 +1,254 @@
+/**
+ * Sistema de gestión de tokens para el framework API SDK
+ * Implementación del componente utils/tokenManager.js
+ */
+const fs = require('fs');
+const jwt = require('jsonwebtoken');
+class TokenManager {
+  /**
+   * Constructor del gestor de tokens
+   * @param {Object} options - Opciones de configuración
+   * @param {string} options.storage - Tipo de almacenamiento ('memory', 'json', 'database')
+   * @param {string} options.tokenFile - Ruta al archivo JSON para almacenamiento
+   * @param {Object} options.dbConfig - Configuración para base de datos (si aplica)
+   */
+  constructor(options = {}) {
+    this.storage = options.storage || 'memory';
+    this.tokenFile = options.tokenFile || './tokens.json';
+    this.dbConfig = options.dbConfig;
+    // Inicializar almacenamiento
+    this.tokens = new Map();
+    if (this.storage === 'json') {
+      this.initJsonStorage();
+    }
+  }
+  /**
+   * Inicializa el almacenamiento JSON
+   */
+  initJsonStorage() {
+    try {
+      if (fs.existsSync(this.tokenFile)) {
+        const data = fs.readFileSync(this.tokenFile, 'utf8');
+        const jsonData = JSON.parse(data);
+        // Convertir objeto a Map
+        for (const [key, value] of Object.entries(jsonData)) {
+          this.tokens.set(key, value);
+        }
+      } else {
+        // Crear archivo con estructura vacía
+        fs.writeFileSync(this.tokenFile, JSON.stringify({}, null, 2));
+      }
+    } catch (error) {
+      console.error('Error inicializando almacenamiento JSON:', error.message);
+      // Inicializar con estructura vacía
+      this.tokens = new Map();
+      fs.writeFileSync(this.tokenFile, JSON.stringify({}, null, 2));
+    }
+  }
+  /**
+   * Guarda tokens en almacenamiento JSON
+   */
+  saveToJson() {
+    if (this.storage === 'json') {
+      const jsonObj = {};
+      for (const [key, value] of this.tokens) {
+        jsonObj[key] = value;
+      }
+      fs.writeFileSync(this.tokenFile, JSON.stringify(jsonObj, null, 2));
+    }
+  }
+  /**
+   * Genera un nuevo token JWT
+   * @param {Object} payload - Payload del token
+   * @param {string} secret - Secreto para firmar el token
+   * @param {string|number} expiresIn - Tiempo de expiración
+   * @returns {string} - Token generado
+   */
+  generateToken(payload, secret, expiresIn = '1h') {
+    return jwt.sign(payload, secret, { expiresIn });
+  }
+  /**
+   * Genera un par de tokens (access y refresh)
+   * @param {Object} userData - Datos del usuario
+   * @param {Object} options - Opciones de generación
+   * @returns {Object} - Objeto con ambos tokens
+   */
+  generateTokenPair(userData, options = {}) {
+    const {
+      jwtSecret,
+      refreshSecret,
+      accessExpiresIn = '15m',
+      refreshExpiresIn = '7d'
+    } = options;
+    // Validar que los secrets estén definidos
+    if (!jwtSecret) {
+      throw new Error('Se requiere jwtSecret para generar el token de acceso');
+    }
+    if (!refreshSecret) {
+      throw new Error('Se requiere refreshSecret para generar el token de refresco');
+    }
+    const accessToken = this.generateToken(
+      { ...userData, tokenType: 'access' },
+      jwtSecret,
+      accessExpiresIn
+    );
+    const refreshToken = this.generateToken(
+      { ...userData, tokenType: 'refresh' },
+      refreshSecret,
+      refreshExpiresIn
+    );
+    // Almacenar refresh token si es necesario para revocación
+    if (this.storage !== 'memory') {
+      this.tokens.set(refreshToken, {
+        userId: userData.userId || userData.id,
+        createdAt: new Date().toISOString(),
+        expiresAt: new Date(Date.now() + this.parseTimeToMs(refreshExpiresIn)).toISOString(),
+        revoked: false
+      });
+      if (this.storage === 'json') {
+        this.saveToJson();
+      }
+    }
+    return {
+      accessToken,
+      refreshToken
+    };
+  }
+  /**
+   * Valida un token JWT
+   * @param {string} token - Token a validar
+   * @param {string} secret - Secreto para verificar el token
+   * @returns {Object|null} - Payload decodificado o null si inválido
+   */
+  validateToken(token, secret) {
+    try {
+      return jwt.verify(token, secret);
+    } catch (error) {
+      return null;
+    }
+  }
+  /**
+   * Renueva un token de acceso usando un refresh token
+   * @param {string} refreshToken - Refresh token
+   * @param {string} jwtSecret - Secreto JWT
+   * @param {string} refreshSecret - Secreto refresh
+   * @param {string} accessExpiresIn - Tiempo expiración access token
+   * @returns {Object|null} - Nuevo par de tokens o null si inválido
+   */
+  refreshToken(refreshToken, jwtSecret, refreshSecret, accessExpiresIn = '15m') {
+    // Primero verificar si el refresh token es válido
+    const decoded = this.validateToken(refreshToken, refreshSecret);
+    if (!decoded) {
+      return null;
+    }
+    // Si usamos almacenamiento persistente, verificar si el token está revocado
+    if (this.storage !== 'memory') {
+      const storedToken = this.tokens.get(refreshToken);
+      if (!storedToken || storedToken.revoked) {
+        return null;
+      }
+    }
+    // Crear un nuevo payload sin las propiedades de expiración del refresh token
+    const newPayload = { ...decoded };
+    delete newPayload.exp;  // Eliminar expiración del refresh token
+    delete newPayload.iat;  // Eliminar emisión del refresh token
+    delete newPayload.tokenType; // Asegurarse de que sea un token de acceso
+    // Generar nuevo token de acceso con los datos del usuario
+    const newAccessToken = this.generateToken(
+      { ...newPayload, tokenType: 'access' },
+      jwtSecret,
+      accessExpiresIn
+    );
+    return {
+      accessToken: newAccessToken,
+      refreshToken // Devolver el mismo refresh token (o generar uno nuevo si se implementa rotación)
+    };
+  }
+  /**
+   * Revoca un refresh token
+   * @param {string} refreshToken - Refresh token a revocar
+   * @returns {boolean} - True si se revocó exitosamente
+   */
+  revokeToken(refreshToken) {
+    if (this.storage !== 'memory') {
+      const storedToken = this.tokens.get(refreshToken);
+      if (storedToken) {
+        storedToken.revoked = true;
+        storedToken.revokedAt = new Date().toISOString();
+        if (this.storage === 'json') {
+          this.saveToJson();
+        }
+        return true;
+      }
+    }
+    return false;
+  }
+  /**
+   * Parsea una duración de tiempo a milisegundos
+   * @param {string|number} time - Tiempo en formato legible (ej: '1h', '7d', '30m')
+   * @returns {number} - Milisegundos
+   */
+  parseTimeToMs(time) {
+    if (typeof time === 'number') return time;
+    const timeStr = time.toString();
+    const num = parseInt(timeStr.match(/\d+/)[0]);
+    const unit = timeStr.match(/[a-z]+/i)[0].toLowerCase();
+    switch (unit) {
+      case 's': return num * 1000;
+      case 'm': return num * 60 * 1000;
+      case 'h': return num * 60 * 60 * 1000;
+      case 'd': return num * 24 * 60 * 60 * 1000;
+      default: return num * 1000; // Por defecto segundos
+    }
+  }
+  /**
+   * Obtiene tokens válidos para un usuario
+   * @param {string|number} userId - ID del usuario
+   * @returns {Array} - Array de tokens asociados al usuario
+   */
+  getUserTokens(userId) {
+    const userTokens = [];
+    for (const [token, data] of this.tokens) {
+      if (data.userId == userId && !data.revoked) {
+        userTokens.push({
+          token,
+          ...data
+        });
+      }
+    }
+    return userTokens;
+  }
+}
+module.exports = TokenManager;

package/package.json ADDED Viewed

@@ -0,0 +1,47 @@
+{
+  "name": "jerkjs",
+  "version": "2.0.0",
+  "description": "JERK Framework v2.0 - A comprehensive framework for building secure and scalable APIs",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "api",
+    "sdk",
+    "framework",
+    "server",
+    "router",
+    "middleware",
+    "security",
+    "authentication",
+    "cors",
+    "rate-limiter",
+    "firewall",
+    "waf"
+  ],
+  "author": "JERK Team",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/bytedogssyndicate1/jerk.git"
+  },
+  "bugs": {
+    "url": "https://gitlab.com/bytedogssyndicate1/jerk/issues"
+  },
+  "homepage": "https://jerk.page.gd/",
+  "dependencies": {
+    "bcrypt": "^6.0.0",
+    "jsonwebtoken": "^9.0.3",
+    "mariadb": "^3.0.0",
+    "sqlite3": "^5.1.7"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "directories": {
+    "doc": "doc",
+    "example": "examples",
+    "lib": "lib"
+  }
+}