free-framework 4.5.7 → 4.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "free-framework",
-  "version": "4.5.7",
+  "version": "4.6.0",
   "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, next) {
+module.exports = function maintenanceMiddleware(req, res) {
     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 next();
+        return;
     }
 
     // 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, next) {
+module.exports = function securityMiddleware(req, res) {
     // 1. Core Security Headers
     res.setHeader('X-Powered-By', 'Free-Ultra/Enterprise');
     res.setHeader('X-Content-Type-Options', 'nosniff');
@@ -25,6 +25,4 @@ module.exports = function securityMiddleware(req, res, next) {
 
     // 4. Permissions Policy (Hardware restrictions)
     res.setHeader('Permissions-Policy', 'camera=(), microphone=(), geolocation=(), interest-cohort=()');
-
-    next();
 };

package/runtime/server.js

@@ -21,11 +21,11 @@ class FreeServer {
         this.plugins = [];
         this.viewsPath = process.env.VIEWS_PATH || nodePath.join(process.cwd(), 'views');
 
-        // Static Asset Serving - GET fallback for priority
+        // Static Asset Serving Middleware
         const publicPath = nodePath.join(process.cwd(), 'public');
-        this.app.get('/*', (req, res, next) => {
+        this.app.use((req, res) => {
             const lookupPath = req.path.startsWith('/') ? req.path.substring(1) : req.path;
-            if (!lookupPath) return next();
+            if (!lookupPath) return;
 
             const fullPath = nodePath.join(publicPath, lookupPath);
             if (fs.existsSync(fullPath) && fs.statSync(fullPath).isFile()) {
@@ -34,7 +34,6 @@ class FreeServer {
                 const mimes = { '.js': 'application/javascript', '.css': 'text/css', '.png': 'image/png' };
                 return res.type(mimes[ext] || 'application/javascript').send(content);
             }
-            next();
         });
 
         this.app.get('/test-static', (req, res) => res.send('Static serving test'));
@@ -55,7 +54,7 @@ class FreeServer {
         this.app.use(maintenanceMiddleware);
         this.app.use(securityMiddleware);
 
-        this.app.use((req, res, next) => {
+        this.app.use((req, res) => {
             const ip = req.ip || req.headers['x-forwarded-for'] || 'unknown';
             const reqCount = this.rateLimits.get(ip) || 0;
 
@@ -66,7 +65,6 @@ class FreeServer {
             }
 
             this.rateLimits.set(ip, reqCount + 1);
-            next();
         });
     }
 
@@ -98,8 +96,58 @@ class FreeServer {
 
                 await handler(req, res);
             } catch (e) {
-                console.error(`[Free Engine] Error ${method} ${path}:`, e);
-                res.status(e.status || 500).header('Content-Type', 'text/html').send('Internal Error');
+                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>`);
+                    }
+                }
             }
         };
 
@@ -122,7 +170,9 @@ class FreeServer {
     start(port = 3000) {
         this.app.get('/health', (req, res) => res.send('OK'));
         this.app.listen(port).then(() => {
-            console.log(`⚡ Free Engine Ignite: http://localhost:${port}`);
+            const blueUnderline = "\x1b[34m\x1b[4m";
+            const reset = "\x1b[0m";
+            console.log(`⚡ Free Engine Ignite: ${blueUnderline}http://localhost:${port}${reset}`);
         });
     }
 }

package/runtime/views/debug.html

@@ -0,0 +1,273 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Free Engine | Runtime Exception</title>
+    <link
+        href="https://fonts.googleapis.com/css2?family=Outfit:wght@300;400;700;900&family=JetBrains+Mono:wght@400;700&display=swap"
+        rel="stylesheet">
+    <style>
+        :root {
+            --primary: #ff3e3e;
+            --primary-bg: #1a0b0b;
+            --bg: #050505;
+            --surface: #121212;
+            --text: #ffffff;
+            --text-dim: #888888;
+            --border: rgba(255, 255, 255, 0.1);
+            --code: #00ff88;
+        }
+
+        * {
+            box-sizing: border-box;
+        }
+
+        body {
+            margin: 0;
+            font-family: 'Outfit', sans-serif;
+            background: var(--bg);
+            color: var(--text);
+            line-height: 1.6;
+            overflow-x: hidden;
+        }
+
+        header {
+            background: var(--primary-bg);
+            border-bottom: 2px solid var(--primary);
+            padding: 3rem 2rem;
+            position: relative;
+            overflow: hidden;
+        }
+
+        .glow {
+            position: absolute;
+            top: -100px;
+            right: -100px;
+            width: 400px;
+            height: 400px;
+            background: radial-gradient(circle, rgba(255, 62, 62, 0.2) 0%, transparent 70%);
+            z-index: 0;
+            pointer-events: none;
+        }
+
+        .container {
+            max-width: 1200px;
+            margin: 0 auto;
+            position: relative;
+            z-index: 1;
+        }
+
+        .badge {
+            display: inline-block;
+            background: var(--primary);
+            color: white;
+            padding: 0.2rem 0.8rem;
+            border-radius: 4px;
+            font-weight: 900;
+            font-size: 0.7rem;
+            letter-spacing: 1px;
+            text-transform: uppercase;
+            margin-bottom: 1rem;
+        }
+
+        h1 {
+            margin: 0;
+            font-size: 2.5rem;
+            font-weight: 900;
+            letter-spacing: -1px;
+        }
+
+        .message {
+            font-size: 1.3rem;
+            color: var(--text-dim);
+            margin-top: 0.5rem;
+        }
+
+        nav {
+            background: var(--surface);
+            border-bottom: 1px solid var(--border);
+            padding: 0;
+            display: flex;
+            position: sticky;
+            top: 0;
+            z-index: 100;
+        }
+
+        nav button {
+            background: transparent;
+            border: none;
+            color: var(--text-dim);
+            padding: 1rem 2rem;
+            font-family: inherit;
+            font-weight: 700;
+            cursor: pointer;
+            transition: 0.3s;
+            border-bottom: 2px solid transparent;
+        }
+
+        nav button.active {
+            color: var(--primary);
+            border-bottom-color: var(--primary);
+            background: rgba(255, 62, 62, 0.05);
+        }
+
+        section {
+            padding: 2rem;
+            display: none;
+        }
+
+        section.active {
+            display: block;
+        }
+
+        .stack-trace {
+            background: #000;
+            border-radius: 8px;
+            padding: 1rem;
+            overflow-x: auto;
+            border: 1px solid var(--border);
+        }
+
+        .stack-trace pre {
+            margin: 0;
+            font-family: 'JetBrains Mono', monospace;
+            font-size: 0.9rem;
+            color: #ddd;
+        }
+
+        .stack-line {
+            display: block;
+            padding: 0.2rem 0;
+            border-bottom: 1px solid rgba(255, 255, 255, 0.03);
+        }
+
+        .stack-line.highlight {
+            background: rgba(255, 62, 62, 0.1);
+            color: var(--primary);
+            font-weight: 700;
+        }
+
+        table {
+            width: 100%;
+            border-collapse: collapse;
+            margin-top: 1rem;
+        }
+
+        th,
+        td {
+            text-align: left;
+            padding: 1rem;
+            border-bottom: 1px solid var(--border);
+        }
+
+        th {
+            color: var(--text-dim);
+            width: 200px;
+            text-transform: uppercase;
+            font-size: 0.75rem;
+            letter-spacing: 1px;
+        }
+
+        .val-text {
+            font-family: 'JetBrains Mono', monospace;
+            color: var(--code);
+        }
+
+        .card {
+            background: var(--surface);
+            border: 1px solid var(--border);
+            border-radius: 12px;
+            padding: 2rem;
+            margin-bottom: 2rem;
+        }
+
+        h2 {
+            font-size: 1.5rem;
+            margin-top: 0;
+        }
+    </style>
+</head>
+
+<body>
+    <header>
+        <div class="glow"></div>
+        <div class="container">
+            <div class="badge">Runtime Exception</div>
+            <h1>{{errorName}}</h1>
+            <div class="message">{{errorMessage}}</div>
+        </div>
+    </header>
+
+    <nav>
+        <button onclick="showTab('stack')" id="btn-stack" class="active">Stack Trace</button>
+        <button onclick="showTab('request')" id="btn-request">Request</button>
+        <button onclick="showTab('env')" id="btn-env">Environment</button>
+        <button onclick="showTab('app')" id="btn-app">Engine</button>
+    </nav>
+
+    <div class="container">
+        <section id="tab-stack" class="active">
+            <div class="card">
+                <h2>Trace Analysis</h2>
+                <div class="stack-trace">
+                    <pre>{{stackTrace}}</pre>
+                </div>
+            </div>
+        </section>
+
+        <section id="tab-request">
+            <div class="card">
+                <h2>HTTP Details</h2>
+                <table>
+                    {{requestDetails}}
+                </table>
+            </div>
+        </section>
+
+        <section id="tab-env">
+            <div class="card">
+                <h2>Environment Variables</h2>
+                <table>
+                    {{envDetails}}
+                </table>
+            </div>
+        </section>
+
+        <section id="tab-app">
+            <div class="card">
+                <h2>Engine Statistics</h2>
+                <table>
+                    <tr>
+                        <th>Engine</th>
+                        <td class="val-text">Free Enterprise v{{version}}</td>
+                    </tr>
+                    <tr>
+                        <th>Node Version</th>
+                        <td class="val-text">{{nodeVersion}}</td>
+                    </tr>
+                    <tr>
+                        <th>OS</th>
+                        <td class="val-text">{{osInfo}}</td>
+                    </tr>
+                    <tr>
+                        <th>Memory Usage</th>
+                        <td class="val-text">{{memoryUsage}}</td>
+                    </tr>
+                </table>
+            </div>
+        </section>
+    </div>
+
+    <script>
+        function showTab(id) {
+            document.querySelectorAll('section').forEach(s => s.classList.remove('active'));
+            document.querySelectorAll('nav button').forEach(b => b.classList.remove('active'));
+            document.getElementById('tab-' + id).classList.add('active');
+            document.getElementById('btn-' + id).classList.add('active');
+        }
+    </script>
+</body>
+
+</html>

package/templates/app-template/.env

@@ -1,13 +1,17 @@
 # Free Framework Core Template Configuration
 # Production-ready defaults for Database, Security, and Routing
 
-# ── Database (MySQL Recommended) ──────────────────────────────────────────
-DB_CLIENT=mysql2
-DB_HOST=127.0.0.1
-DB_PORT=3306
-DB_USER=root
-DB_PASS=
-DB_NAME=free_db_default
+# ── Database (SQLite Default - Change as needed) ───────────────────────────
+DB_CLIENT=sqlite3
+DB_PATH=database/database.sqlite
+
+# MySQL (Recommended for Production)
+# DB_CLIENT=mysql2
+# DB_HOST=127.0.0.1
+# DB_PORT=3306
+# DB_USER=root
+# DB_PASS=
+# DB_NAME=free_db_default
 
 # Connection Pooling Settings
 DB_POOL_MIN=5

package/templates/app-template/config/database.js

@@ -14,7 +14,7 @@
 
 module.exports = {
     // The default database connection to use.
-    default: process.env.DB_CLIENT || 'mysql2',
+    default: process.env.DB_CLIENT || 'sqlite3',
 
     connections: {
         // High-performance MySQL connection settings