free-framework 4.6.0 → 4.6.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "free-framework",
-  "version": "4.6.0",
+  "version": "4.6.2",
   "description": "Professional Node.js engine for the .free language. Blazing-fast SSR, Islands Architecture, and built-in ORM.",
   "main": "index.js",
   "bin": {

package/runtime/middleware/maintenance.js

@@ -3,13 +3,13 @@
  * Enterprise Maintenance Mode Guard.
  */
 
-module.exports = function maintenanceMiddleware(req, res) {
+module.exports = function maintenanceMiddleware(req, res, next) {
     const isMaintenance = process.env.MAINTENANCE_MODE === 'true';
     const bypassToken = process.env.MAINTENANCE_BYPASS;
 
     // Allow bypassing with a specific query token or if disabled
     if (!isMaintenance || (bypassToken && req.query.bypass === bypassToken)) {
-        return;
+        return next();
     }
 
     // Identify if it's an API request or HTML

package/runtime/middleware/security.js

@@ -3,7 +3,7 @@
  * Enterprise-grade Security Headers Middleware.
  */
 
-module.exports = function securityMiddleware(req, res) {
+module.exports = function securityMiddleware(req, res, next) {
     // 1. Core Security Headers
     res.setHeader('X-Powered-By', 'Free-Ultra/Enterprise');
     res.setHeader('X-Content-Type-Options', 'nosniff');
@@ -25,4 +25,6 @@ module.exports = function securityMiddleware(req, res) {
 
     // 4. Permissions Policy (Hardware restrictions)
     res.setHeader('Permissions-Policy', 'camera=(), microphone=(), geolocation=(), interest-cohort=()');
+
+    next();
 };

package/runtime/server.js

@@ -16,24 +16,36 @@ const { LRUCache } = require('lru-cache');
 class FreeServer {
     constructor() {
         this.app = new HyperExpress.Server();
+        this.viewsPath = process.env.VIEWS_PATH || nodePath.join(process.cwd(), 'views');
         this.namedMiddlewares = {};
         this.errorViews = {};
         this.plugins = [];
-        this.viewsPath = process.env.VIEWS_PATH || nodePath.join(process.cwd(), 'views');
+
+        // Global Request Logger & Error Handler Initialization
+        this.app.set_error_handler((req, res, error) => {
+            console.error(`[Free Engine] 🔥 Global Uncaught Error:`, error);
+            this.handleError(req, res, error);
+        });
+
+        this.app.use((req, res, next) => {
+            console.log(`[Free Engine] 📥 Request: ${req.method} ${req.url}`);
+            if (next) next();
+        });
 
         // Static Asset Serving Middleware
         const publicPath = nodePath.join(process.cwd(), 'public');
-        this.app.use((req, res) => {
+        this.app.use((req, res, next) => {
             const lookupPath = req.path.startsWith('/') ? req.path.substring(1) : req.path;
-            if (!lookupPath) return;
+            if (!lookupPath) return next ? next() : null;
 
             const fullPath = nodePath.join(publicPath, lookupPath);
             if (fs.existsSync(fullPath) && fs.statSync(fullPath).isFile()) {
-                const content = fs.readFileSync(fullPath);
                 const ext = nodePath.extname(fullPath);
-                const mimes = { '.js': 'application/javascript', '.css': 'text/css', '.png': 'image/png' };
-                return res.type(mimes[ext] || 'application/javascript').send(content);
+                const mimes = { '.js': 'application/javascript', '.css': 'text/css', '.png': 'image/png', '.jpg': 'image/jpeg', '.svg': 'image/svg+xml' };
+                res.type(mimes[ext] || 'text/plain');
+                return res.send(fs.readFileSync(fullPath));
             }
+            if (next) next();
         });
 
         this.app.get('/test-static', (req, res) => res.send('Static serving test'));
@@ -54,17 +66,18 @@ class FreeServer {
         this.app.use(maintenanceMiddleware);
         this.app.use(securityMiddleware);
 
-        this.app.use((req, res) => {
-            const ip = req.ip || req.headers['x-forwarded-for'] || 'unknown';
+        this.app.use((req, res, next) => {
+            const ip = req.ip || req.headers['x-forwarded-for'] || '127.0.0.1';
             const reqCount = this.rateLimits.get(ip) || 0;
 
             if (reqCount >= 5000) {
                 res.status(429);
                 res.setHeader('Retry-After', '60');
-                return res.send('Too Many Requests - Under DDoS Protection');
+                return res.send('Too Many Requests');
             }
 
             this.rateLimits.set(ip, reqCount + 1);
+            if (next) next();
         });
     }
 
@@ -96,58 +109,7 @@ class FreeServer {
 
                 await handler(req, res);
             } catch (e) {
-                if (process.env.NODE_ENV === 'production') {
-                    console.error(`[Free Engine] Error ${method} ${path}:`, e);
-                    res.status(e.status || 500).header('Content-Type', 'text/html').send('Internal Error');
-                } else {
-                    // Premium Debug Page (Ignition Style)
-                    const os = require('os');
-                    const pkg = require('../package.json');
-                    const debugTplPath = nodePath.join(__dirname, 'views/debug.html');
-
-                    if (fs.existsSync(debugTplPath)) {
-                        let html = fs.readFileSync(debugTplPath, 'utf8');
-
-                        // Error Details
-                        html = html.replace('{{errorName}}', e.name || 'Error');
-                        html = html.replace('{{errorMessage}}', e.message || 'No message provided');
-
-                        // Stack Trace with highlighting
-                        const stack = (e.stack || '').split('\n').map(line => {
-                            const isUserFile = line.includes(process.cwd()) && !line.includes('node_modules');
-                            return `<span class="stack-line ${isUserFile ? 'highlight' : ''}">${line.replace(/&/g, '&amp;').replace(/</g, '&lt;')}</span>`;
-                        }).join('');
-                        html = html.replace('{{stackTrace}}', stack);
-
-                        // Request Details
-                        let reqHtml = `<tr><th>Method</th><td class="val-text">${req.method}</td></tr>`;
-                        reqHtml += `<tr><th>URL</th><td class="val-text">${req.url}</td></tr>`;
-                        Object.keys(req.headers).forEach(k => {
-                            reqHtml += `<tr><th>Header: ${k}</th><td class="val-text">${req.headers[k]}</td></tr>`;
-                        });
-                        html = html.replace('{{requestDetails}}', reqHtml);
-
-                        // Env details (Mask secrets)
-                        let envHtml = '';
-                        Object.keys(process.env).forEach(k => {
-                            const isSecret = k.includes('KEY') || k.includes('SECRET') || k.includes('PASS');
-                            const val = isSecret ? '********' : process.env[k];
-                            envHtml += `<tr><th>${k}</th><td class="val-text">${val}</td></tr>`;
-                        });
-                        html = html.replace('{{envDetails}}', envHtml);
-
-                        // Engine Stats
-                        html = html.replace('{{version}}', pkg.version);
-                        html = html.replace('{{nodeVersion}}', process.version);
-                        html = html.replace('{{osInfo}}', `${os.type()} ${os.release()} (${os.arch()})`);
-                        const mem = process.memoryUsage();
-                        html = html.replace('{{memoryUsage}}', `${Math.round(mem.heapUsed / 1024 / 1024)}MB / ${Math.round(mem.heapTotal / 1024 / 1024)}MB`);
-
-                        res.status(500).header('Content-Type', 'text/html').send(html);
-                    } else {
-                        res.status(500).send(`<h1>${e.name || 'Error'}</h1><pre>${e.stack}</pre>`);
-                    }
-                }
+                this.handleError(req, res, e);
             }
         };
 
@@ -155,6 +117,54 @@ class FreeServer {
         if (routeMethod === 'get') this.app.head(path, ...mwFns, routeHandler);
     }
 
+    handleError(req, res, e) {
+        if (process.env.NODE_ENV === 'production') {
+            res.status(500).header('Content-Type', 'text/html').send('Internal Error');
+        } else {
+            // Premium Debug Page (Ignition Style) logic moved here
+            const os = require('os');
+            const pkg = require('../package.json');
+            const debugTplPath = nodePath.join(__dirname, 'views/debug.html');
+
+            if (fs.existsSync(debugTplPath)) {
+                let html = fs.readFileSync(debugTplPath, 'utf8');
+                html = html.replace('{{errorName}}', e.name || 'Error');
+                html = html.replace('{{errorMessage}}', e.message || 'No message provided');
+
+                const stack = (e.stack || '').split('\n').map(line => {
+                    const isUserFile = line.includes(process.cwd()) && !line.includes('node_modules');
+                    return `<span class="stack-line ${isUserFile ? 'highlight' : ''}">${line.replace(/&/g, '&amp;').replace(/</g, '&lt;')}</span>`;
+                }).join('');
+                html = html.replace('{{stackTrace}}', stack);
+
+                let reqHtml = `<tr><th>Method</th><td class="val-text">${req.method}</td></tr>`;
+                reqHtml += `<tr><th>URL</th><td class="val-text">${req.url}</td></tr>`;
+                Object.keys(req.headers).forEach(k => {
+                    reqHtml += `<tr><th>Header: ${k}</th><td class="val-text">${req.headers[k]}</td></tr>`;
+                });
+                html = html.replace('{{requestDetails}}', reqHtml);
+
+                let envHtml = '';
+                Object.keys(process.env).forEach(k => {
+                    const isSecret = k.includes('KEY') || k.includes('SECRET') || k.includes('PASS');
+                    const val = isSecret ? '********' : process.env[k];
+                    envHtml += `<tr><th>${k}</th><td class="val-text">${val}</td></tr>`;
+                });
+                html = html.replace('{{envDetails}}', envHtml);
+
+                html = html.replace('{{version}}', pkg.version);
+                html = html.replace('{{nodeVersion}}', process.version);
+                html = html.replace('{{osInfo}}', `${os.type()} ${os.release()} (${os.arch()})`);
+                const mem = process.memoryUsage();
+                html = html.replace('{{memoryUsage}}', `${Math.round(mem.heapUsed / 1024 / 1024)}MB / ${Math.round(mem.heapTotal / 1024 / 1024)}MB`);
+
+                res.status(500).header('Content-Type', 'text/html').send(html);
+            } else {
+                res.status(500).send(`<h1>${e.name || 'Error'}</h1><pre>${e.stack}</pre>`);
+            }
+        }
+    }
+
     middleware(fn) { this.app.use(fn); }
     registerMiddleware(name, fn) { this.namedMiddlewares[name] = fn; }
     use(plugin) { plugin.install(this); this.plugins.push(plugin); }