insitu-js 1.2.0 → 1.3.0

package/CHANGELOG.md

@@ -5,6 +5,34 @@ El versionado sigue SemVer (MAJOR.MINOR.PATCH).
 
 ---
 
+## [1.3.0] - 2026-02-17
+
+### Soporte para Uploads Binarios y Excepciones en Firewall - Insitu Framework
+
+#### Soporte para Uploads Binarios (`lib/core/server.js`)
+- Implementación de `req.rawBody` para almacenar el cuerpo crudo de la solicitud como Buffer
+- Mantenimiento de compatibilidad con `req.body` para comportamiento original (string)
+- Capacidad de manejar uploads de archivos binarios (.tar.gz, imágenes, etc.)
+- Permite que las rutas que procesan archivos binarios accedan al contenido sin conversión a string
+
+#### Excepción en Firewall para Rutas de Deploy (`lib/middleware/firewall.js`)
+- Exclusión de rutas `POST /api/admin/apps/deploy` del firewall
+- Las solicitudes de deploy ahora saltan las reglas de seguridad del firewall
+- Permite procesos de despliegue automático sin bloqueos por reglas de seguridad
+
+#### Compatibilidad
+- **Retrocompatible:** Sí. Los cambios no afectan funcionalidad existente
+- **Requiere:** Ninguna dependencia adicional
+- **Afecta:** Solo a rutas que acceden a `req.rawBody` y rutas de deploy de administración
+
+#### Beneficios Obtenidos
+- Capacidad de subir archivos binarios de cualquier tipo
+- Flexibilidad para manejar contenido crudo en formatos específicos
+- Despliegue automático sin interferencia del firewall
+- Mejor integración con sistemas de CI/CD
+
+---
+
 ## [1.2.0] - 2026-02-16
 
 ### Custom Static 404 Response Filter - Insitu Framework

package/lib/core/hooks-handlers/app-hooks-handler.js

@@ -0,0 +1,57 @@
+/**
+ * Manejadores de hooks para aplicaciones (App Server)
+ * Implementación para el framework Insitu
+ * 
+ * Este archivo maneja los hooks específicos para la gestión de aplicaciones
+ */
+
+class AppHooksHandler {
+  /**
+   * Dispara el hook antes de registrar las rutas de una aplicación
+   * @param {Object} server - Instancia del servidor
+   * @param {Object} routeConfig - Configuración de la ruta
+   * @param {string} appName - Nombre de la aplicación
+   * @param {string} version - Versión de la aplicación
+   * @returns {Object} - routeConfig modificado
+   */
+  static handleBeforeAppRouteRegister(server, routeConfig, appName, version) {
+    if (server.hooks) {
+      // El filtro puede modificar routeConfig
+      return server.hooks.applyFilters(
+        'before_app_routes_register',
+        routeConfig,
+        appName,
+        version
+      );
+    }
+    return routeConfig;
+  }
+
+  /**
+   * Dispara el hook después de registrar las rutas de una aplicación
+   * @param {Object} server - Instancia del servidor
+   * @param {Array} routes - Lista de rutas registradas
+   * @param {string} appName - Nombre de la aplicación
+   * @param {string} version - Versión de la aplicación
+   */
+  static handleAfterAppRoutesRegister(server, routes, appName, version) {
+    if (server.hooks) {
+      server.hooks.doAction('after_app_routes_register', routes, appName, version);
+    }
+  }
+
+  /**
+   * Dispara el hook cuando una ruta de aplicación es registrada
+   * @param {Object} server - Instancia del servidor
+   * @param {Object} route - Ruta registrada
+   * @param {string} appName - Nombre de la aplicación
+   * @param {string} version - Versión de la aplicación
+   */
+  static handleAppRouteRegistered(server, route, appName, version) {
+    if (server.hooks) {
+      server.hooks.doAction('app_route_registered', route, appName, version);
+    }
+  }
+}
+
+module.exports = AppHooksHandler;

package/lib/core/server.js

@@ -987,7 +987,18 @@ class APIServer {
     req.on('end', async () => {
       try {
         // Concatenar todos los chunks una sola vez
-        req.body = Buffer.concat(bodyChunks).toString();
+        const rawBuffer = Buffer.concat(bodyChunks);
+        
+        // ============================================
+        // BINARY UPLOAD SUPPORT - BlackCoffee
+        // ============================================
+        // Guardar body raw como Buffer para rutas binarias
+        // Esto permite uploads de archivos binarios (.tar.gz, imágenes, etc.)
+        req.rawBody = rawBuffer;
+        // ============================================
+        
+        // Convertir a string para req.body (comportamiento original)
+        req.body = rawBuffer.toString();
 
         // Actualizar estadísticas globales de bytes recibidos
         StatsHooksHandler.updateRequestBytes(bodySize);

package/lib/middleware/firewall.js

@@ -399,6 +399,11 @@ class Firewall {
    */
   middleware() {
     return (req, res, next) => {
+      // Excluir rutas de administración de deploy
+      if (req.method === 'POST' && req.url.startsWith('/api/admin/apps/deploy')) {
+        return next(); // Saltar firewall para deploy
+      }
+    
       // Disparar hook antes de procesar la solicitud
       const hooks = require('../../index.js').hooks;
       if (hooks) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "insitu-js",
-  "version": "1.2.0",
-  "description": "Insitu Framework v1.2.0 - A comprehensive framework for building secure and scalable APIs with frontend support, sessions, template engine, integration with qbuilderjs, complete MVC architecture with models, enhanced route loading from directory, improved model loading system, administration extension, queue management system, route cache management module, fixed routing issues with static and parametrized routes, and custom static 404 response filter for personalized HTML templates",
+  "version": "1.3.0",
+  "description": "Insitu Framework v1.3.0 - A comprehensive framework for building secure and scalable APIs with frontend support, sessions, template engine, integration with qbuilderjs, complete MVC architecture with models, enhanced route loading from directory, improved model loading system, administration extension, queue management system, route cache management module, fixed routing issues with static and parametrized routes, custom static 404 response filter for personalized HTML templates, binary upload support, and firewall exceptions for admin deploy routes",
   "main": "index.js",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",