npm - free-framework - Versions diffs - 4.4.0 - Mend

free-framework 4.4.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 (72) hide show

package/LICENSE +21 -0
package/README.md +198 -0
package/bin/free.js +118 -0
package/cli/commands/build.js +124 -0
package/cli/commands/deploy.js +143 -0
package/cli/commands/devtools.js +210 -0
package/cli/commands/doctor.js +72 -0
package/cli/commands/install.js +28 -0
package/cli/commands/make.js +74 -0
package/cli/commands/migrate.js +67 -0
package/cli/commands/new.js +54 -0
package/cli/commands/serve.js +73 -0
package/cli/commands/test.js +57 -0
package/compiler/analyzer.js +102 -0
package/compiler/generator.js +386 -0
package/compiler/lexer.js +166 -0
package/compiler/parser.js +410 -0
package/database/model.js +6 -0
package/database/orm.js +379 -0
package/database/query-builder.js +179 -0
package/index.js +51 -0
package/package.json +80 -0
package/plugins/auth.js +212 -0
package/plugins/cache.js +85 -0
package/plugins/chat.js +32 -0
package/plugins/mail.js +53 -0
package/plugins/metrics.js +126 -0
package/plugins/payments.js +59 -0
package/plugins/queue.js +139 -0
package/plugins/search.js +51 -0
package/plugins/storage.js +123 -0
package/plugins/upload.js +62 -0
package/router/router.js +57 -0
package/runtime/app.js +14 -0
package/runtime/client.js +254 -0
package/runtime/cluster.js +35 -0
package/runtime/edge.js +62 -0
package/runtime/middleware/maintenance.js +54 -0
package/runtime/middleware/security.js +30 -0
package/runtime/server.js +130 -0
package/runtime/validator.js +102 -0
package/runtime/views/error.free +104 -0
package/runtime/views/maintenance.free +0 -0
package/template-engine/renderer.js +24 -0
package/templates/app-template/.env +23 -0
package/templates/app-template/app/Exceptions/Handler.js +65 -0
package/templates/app-template/app/Http/Controllers/AuthController.free +91 -0
package/templates/app-template/app/Http/Middleware/AuthGuard.js +46 -0
package/templates/app-template/app/Services/Storage.js +75 -0
package/templates/app-template/app/Services/Validator.js +91 -0
package/templates/app-template/app/controllers/AuthController.free +42 -0
package/templates/app-template/app/middleware/auth.js +25 -0
package/templates/app-template/app/models/User.free +32 -0
package/templates/app-template/app/routes.free +12 -0
package/templates/app-template/app/styles.css +23 -0
package/templates/app-template/app/views/counter.free +23 -0
package/templates/app-template/app/views/header.free +13 -0
package/templates/app-template/config/app.js +32 -0
package/templates/app-template/config/auth.js +39 -0
package/templates/app-template/config/database.js +54 -0
package/templates/app-template/package.json +28 -0
package/templates/app-template/resources/css/app.css +11 -0
package/templates/app-template/resources/views/dashboard.free +25 -0
package/templates/app-template/resources/views/home.free +26 -0
package/templates/app-template/routes/api.free +22 -0
package/templates/app-template/routes/web.free +25 -0
package/templates/app-template/tailwind.config.js +21 -0
package/templates/app-template/views/about.ejs +47 -0
package/templates/app-template/views/home.ejs +52 -0
package/templates/auth/login.html +144 -0
package/templates/auth/register.html +146 -0
package/utils/logger.js +20 -0

package/cli/commands/devtools.js ADDED Viewed

@@ -0,0 +1,210 @@
+/**
+ * cli/commands/devtools.js
+ * Free DevTools Dashboard – Enhanced with live system telemetry.
+ */
+const path = require("path");
+const fs = require("fs");
+const http = require("http");
+const { tokenize } = require("../../compiler/lexer");
+const { parse } = require("../../compiler/parser");
+module.exports = function () {
+    const appDir = path.join(process.cwd(), "app");
+    if (!fs.existsSync(appDir)) {
+        console.error("❌ Not inside a Free Framework project. 'app' directory missing.");
+        process.exit(1);
+    }
+    console.log("🔍 Scanning .free project for DevTools...");
+    const freeFiles = fs.readdirSync(appDir).filter(f => f.endsWith(".free"));
+    let combinedAST = [];
+    freeFiles.forEach(file => {
+        try {
+            const code = fs.readFileSync(path.join(appDir, file), "utf-8");
+            const tokens = tokenize(code, file);
+            combinedAST = combinedAST.concat(parse(tokens, file));
+        } catch (e) {
+            console.warn(`⚠️  [DevTools] Skipped ${file}: ${e.message}`);
+        }
+    });
+    const routes = combinedAST.filter(n => n.type === 'route');
+    const components = combinedAST.filter(n => n.type === 'component');
+    const models = combinedAST.filter(n => n.type === 'model');
+    const actions = combinedAST.filter(n => n.type === 'action');
+    const stores = combinedAST.filter(n => n.type === 'store');
+    // Serve the dashboard using Node's built-in http (no HyperExpress needed)
+    const server = http.createServer(async (req, res) => {
+        if (req.url === '/api/stats') {
+            // Attempt to fetch live structural telemetry from the running Free instance
+            try {
+                const appPort = process.env.PORT || 3000;
+                const telemetryRes = await fetch(`http://127.0.0.1:${appPort}/_free/telemetry`);
+                if (telemetryRes.ok) {
+                    const stats = await telemetryRes.json();
+                    res.writeHead(200, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({
+                        status: 'online',
+                        memory: stats.memory,
+                        uptime: stats.uptime,
+                        cache: stats.cache,
+                        queue: stats.queue,
+                        freeFiles: freeFiles.length,
+                        nodeVersion: process.version,
+                    }));
+                    return;
+                }
+            } catch (err) {
+                // If the app is offline, fallback
+            }
+            const mem = process.memoryUsage();
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({
+                status: 'offline',
+                memory: {
+                    heapUsed: (mem.heapUsed / 1024 / 1024).toFixed(1) + ' MB',
+                    heapTotal: (mem.heapTotal / 1024 / 1024).toFixed(1) + ' MB',
+                    rss: (mem.rss / 1024 / 1024).toFixed(1) + ' MB',
+                },
+                uptime: process.uptime().toFixed(0) + 's',
+                cache: 'Offline',
+                queue: 'Offline',
+                freeFiles: freeFiles.length,
+                nodeVersion: process.version,
+            }));
+            return;
+        }
+        res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+        res.end(`<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <title>Free DevTools</title>
+    <style>
+        * { box-sizing: border-box; margin: 0; padding: 0; }
+        body { font-family: system-ui, sans-serif; background: #0a0a0a; color: #e0e0e0; }
+        header { background: #111; padding: 1rem 2rem; border-bottom: 1px solid #222; display: flex; align-items: center; gap: 1rem; }
+        header h1 { font-size: 1.4rem; color: #00ffcc; }
+        header span { font-size: 0.8rem; color: #666; }
+        .container { padding: 2rem; display: grid; grid-template-columns: repeat(auto-fit, minmax(340px, 1fr)); gap: 1.5rem; }
+        .card { background: #111; border-radius: 10px; padding: 1.5rem; border-left: 4px solid #333; }
+        .card h2 { font-size: 1rem; margin-bottom: 1rem; display: flex; align-items: center; gap: 0.5rem; }
+        .badge { background: #00ffcc22; color: #00ffcc; padding: 2px 8px; border-radius: 4px; font-size: 0.75rem; }
+        .item { padding: 0.4rem 0; border-bottom: 1px solid #1a1a1a; font-size: 0.85rem; display: flex; gap: 0.5rem; align-items: center; }
+        .item:last-child { border-bottom: none; }
+        .method { font-weight: bold; color: #00ffcc; font-size: 0.75rem; background: #00ffcc11; padding: 1px 6px; border-radius: 3px; }
+        .mw { font-size: 0.72rem; color: #888; background: #222; padding: 1px 5px; border-radius: 3px; }
+        code { color: #ff9f0a; font-size: 0.82rem; }
+        .stat { font-size: 1.6rem; color: #00ffcc; font-weight: bold; }
+        .stat-label { font-size: 0.75rem; color: #666; margin-top: 0.2rem; }
+        .stats-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 1rem; }
+        #live { font-size: 0.78rem; color: #555; }
+        pre { background: #000; padding: 0.75rem; border-radius: 6px; overflow-x: auto; color: #00ffcc; font-size: 0.75rem; margin-top: 0.5rem; }
+    </style>
+</head>
+<body>
+<header>
+    <h1>🛠️ Free DevTools</h1>
+    <span id="live">Loading live stats...</span>
+</header>
+<div class="container">
+    <!-- Routes -->
+    <div class="card" style="border-color: #00ffcc;">
+        <h2>🌐 Routes <span class="badge">${routes.length}</span></h2>
+        ${routes.map(r => `<div class="item">
+            <span class="method">${r.method}</span>
+            <code>${r.path}</code>
+            → ${r.view || '?'}
+            ${(r.middlewares || []).map(m => `<span class="mw">🔒 ${m}</span>`).join('')}
+        </div>`).join('') || '<div class="item">No routes found</div>'}
+    </div>
+    <!-- Server Actions -->
+    <div class="card" style="border-color: #ffff00;">
+        <h2>⚡ Server Actions <span class="badge">${actions.length}</span></h2>
+        ${actions.map(a => `<div class="item"><code>POST /_free/action/${a.name}</code></div>`).join('') || '<div class="item">No actions found</div>'}
+    </div>
+    <!-- Components -->
+    <div class="card" style="border-color: #ff00cc;">
+        <h2>🧩 Components <span class="badge">${components.length}</span></h2>
+        ${components.map(c => `<div class="item">
+            <strong>${c.name}</strong>
+            ${(c.states || []).map(s => `<span class="mw">${s.name}=${s.value}</span>`).join('')}
+        </div>`).join('') || '<div class="item">No components found</div>'}
+    </div>
+    <!-- Models -->
+    <div class="card" style="border-color: #00ccff;">
+        <h2>📦 Models <span class="badge">${models.length}</span></h2>
+        ${models.map(m => `<div class="item">
+            <strong>${m.name}</strong>
+            <span class="mw">${(m.fields || []).length} fields</span>
+            <pre>${(m.fields || []).map(f => `${f.name}: ${f.type}`).join('\n')}</pre>
+        </div>`).join('') || '<div class="item">No models found</div>'}
+    </div>
+    <!-- Stores -->
+    <div class="card" style="border-color: #ff6600;">
+        <h2>🗂 Global Stores <span class="badge">${stores.length}</span></h2>
+        ${stores.map(s => `<div class="item"><code>store ${s.name}</code>
+            <pre>${JSON.stringify(s.fields, null, 2)}</pre>
+        </div>`).join('') || '<div class="item">No stores defined</div>'}
+    </div>
+    <!-- Live Telemetry Card -->
+    <div class="card" style="border-color: #9945ff;" id="memory-card">
+        <h2>🧠 Live Engine Telemetry <span id="engine-status" class="badge">Checking...</span></h2>
+        <div class="stats-grid" id="mem-stats">
+            <div><div class="stat">—</div><div class="stat-label">Heap Used</div></div>
+            <div><div class="stat">—</div><div class="stat-label">RSS Memory</div></div>
+            <div><div class="stat">—</div><div class="stat-label">Cache System</div></div>
+            <div><div class="stat">—</div><div class="stat-label">Job Queue</div></div>
+        </div>
+    </div>
+</div>
+<script>
+async function fetchStats() {
+    try {
+        const r = await fetch('/api/stats');
+        const d = await r.json();
+        document.getElementById('live').textContent = 'Last sync · ' + new Date().toLocaleTimeString();
+        document.getElementById('engine-status').textContent = d.status === 'online' ? 'ONLINE (Port 3000)' : 'APP OFFLINE';
+        document.getElementById('engine-status').style.color = d.status === 'online' ? '#00ffcc' : '#ff3366';
+        document.getElementById('engine-status').style.background = d.status === 'online' ? '#00ffcc22' : '#ff336622';
+        // Format cache and queue safely
+        const cacheStat = typeof d.cache === 'object' ? \`Hits: \${d.cache.hits} | Miss: \${d.cache.misses}\` : d.cache;
+        const queueStat = typeof d.queue === 'object' ? \`\${d.queue.active} active | \${d.queue.pending} pending\` : d.queue;
+        const grid = document.getElementById('mem-stats');
+        grid.innerHTML = [
+            [d.memory.heapUsed, 'Heap Used'],
+            [d.memory.rss, 'RSS Memory'],
+            [cacheStat, 'Cache System'],
+            [queueStat, 'Job Queue'],
+        ].map(([v,l]) => '<div><div class="stat" style="font-size: 1.2rem;">' + v + '</div><div class="stat-label">' + l + '</div></div>').join('');
+    } catch(e) {}
+}
+fetchStats();
+setInterval(fetchStats, 2000);
+</script>
+</body>
+</html>`);
+    });
+    const port = 4000;
+    server.listen(port, () => {
+        console.log(`\n🚀 Free DevTools running at http://localhost:${port}`);
+        console.log(`   Live memory stats auto-refresh every 2 seconds.\n`);
+    });
+};

package/cli/commands/doctor.js ADDED Viewed

@@ -0,0 +1,72 @@
+/**
+ * cli/commands/doctor.js
+ * Implementation of 'free doctor' command.
+ */
+const fs = require("fs-extra");
+const path = require("path");
+const { execSync } = require("child_process");
+module.exports = function () {
+    console.log("\n🩺 Free Framework Doctor - Diagnostic Report\n");
+    const checks = [
+        { name: "Node.js Version", fn: checkNodeVersion },
+        { name: "Environment File (.env)", fn: checkEnvFile },
+        { name: "Database Connectivity", fn: checkDatabase },
+        { name: "Project Structure", fn: checkStructure },
+        { name: "Dependencies", fn: checkDependencies }
+    ];
+    let passed = 0;
+    checks.forEach(check => {
+        try {
+            const result = check.fn();
+            if (result) {
+                console.log(`✅ ${check.name}: OK`);
+                passed++;
+            } else {
+                console.log(`❌ ${check.name}: Failed`);
+            }
+        } catch (err) {
+            console.log(`❌ ${check.name}: Error - ${err.message}`);
+        }
+    });
+    console.log(`\n📊 Status: ${passed}/${checks.length} checks passed.\n`);
+};
+function checkNodeVersion() {
+    const version = process.version;
+    const major = parseInt(version.slice(1).split('.')[0]);
+    if (major < 16) {
+        throw new Error(`Node.js version must be 16 or higher. Current: ${version}`);
+    }
+    return true;
+}
+function checkEnvFile() {
+    return fs.existsSync(path.join(process.cwd(), ".env"));
+}
+function checkDatabase() {
+    // This is a shallow check, ideally would attempt a knex connection
+    const envPath = path.join(process.cwd(), ".env");
+    if (!fs.existsSync(envPath)) return false;
+    const env = fs.readFileSync(envPath, 'utf8');
+    return env.includes("DB_CLIENT");
+}
+function checkStructure() {
+    const essentialDirs = ["app", "resources/views", "routes"];
+    essentialDirs.forEach(dir => {
+        if (!fs.existsSync(path.join(process.cwd(), dir))) {
+            throw new Error(`Missing essential directory: ${dir}`);
+        }
+    });
+    return true;
+}
+function checkDependencies() {
+    return fs.existsSync(path.join(process.cwd(), "node_modules"));
+}

package/cli/commands/install.js ADDED Viewed

@@ -0,0 +1,28 @@
+/**
+ * cli/commands/install.js
+ * Wrapper around 'npm install' to auto-register Free Framework plugins.
+ */
+const { execSync } = require("child_process");
+const fs = require("fs-extra");
+const path = require("path");
+module.exports = function (packages) {
+    if (!packages || packages.length === 0) {
+        console.error("❌ Please specify a package to install. Example: free install free-auth");
+        process.exit(1);
+    }
+    const packageNames = packages.join(" ");
+    console.log(`\n📦 Installing NPM packages: ${packageNames}...\n`);
+    try {
+        execSync(`npm install ${packageNames}`, { stdio: "inherit", cwd: process.cwd() });
+        console.log(`\n✅ Packages installed successfully.`);
+        // Potential auto-config logic can go here (e.g., adding to config.free)
+        console.log(`💡 Remember to add any required .free directive block to app/config.free if applicable.`);
+    } catch (e) {
+        console.error("\n❌ Installation failed.");
+        process.exit(1);
+    }
+};

package/cli/commands/make.js ADDED Viewed

@@ -0,0 +1,74 @@
+/**
+ * cli/commands/make.js
+ * Implementation of 'free make:*' scaffold commands.
+ */
+const fs = require("fs-extra");
+const path = require("path");
+function guard(filePath, label) {
+    if (fs.existsSync(filePath)) {
+        console.error(`❌ ${label} already exists: ${filePath}`);
+        process.exit(1);
+    }
+    fs.ensureFileSync(filePath);
+}
+const make = {
+    model: (name) => {
+        const dir = path.join(process.cwd(), "app/models");
+        fs.ensureDirSync(dir);
+        const filePath = path.join(dir, `${name}.free`);
+        guard(filePath, `Model ${name}`);
+        fs.writeFileSync(filePath, `model ${name} {\n    name string\n    created_at string\n}\n`);
+        console.log(`✅ Created model: app/models/${name}.free`);
+    },
+    controller: (name) => {
+        const dir = path.join(process.cwd(), "app/controllers");
+        fs.ensureDirSync(dir);
+        const filePath = path.join(dir, `${name}Controller.free`);
+        guard(filePath, `Controller ${name}`);
+        fs.writeFileSync(filePath, `/**\n * ${name} Controller\n */\n\naction get${name} {\n    return { success: true };\n}\n`);
+        console.log(`✅ Created controller: app/controllers/${name}Controller.free`);
+    },
+    middleware: (name) => {
+        const dir = path.join(process.cwd(), "app/middleware");
+        fs.ensureDirSync(dir);
+        const filePath = path.join(dir, `${name}.js`);
+        guard(filePath, `Middleware ${name}`);
+        fs.writeFileSync(filePath, `/**\n * app/middleware/${name}.js\n */\nmodule.exports = async function ${name}Middleware(req, res, next) {\n    // Security/Auth logic here\n    next();\n};\n`);
+        console.log(`✅ Created middleware: app/middleware/${name}.js`);
+    },
+    migration: (name) => {
+        const dir = path.join(process.cwd(), "database/migrations");
+        fs.ensureDirSync(dir);
+        const timestamp = Date.now();
+        const filePath = path.join(dir, `${timestamp}_${name}.js`);
+        guard(filePath, `Migration ${name}`);
+        fs.writeFileSync(filePath, `exports.up = function(knex) {\n  return knex.schema.createTable('${name}', table => {\n    table.increments('id');\n    table.timestamps(true, true);\n  });\n};\n\nexports.down = function(knex) {\n  return knex.schema.dropTable('${name}');\n};\n`);
+        console.log(`✅ Created migration: database/migrations/${timestamp}_${name}.js`);
+    },
+    page: (name) => {
+        const dir = path.join(process.cwd(), "app/views");
+        fs.ensureDirSync(dir);
+        const filePath = path.join(dir, `${name}.free`);
+        guard(filePath, `Page ${name}`);
+        fs.writeFileSync(filePath, `component ${name} {\n    div class="container mx-auto p-4" {\n        h1 class="text-2xl font-bold" { text "${name} View" }\n    }\n}\n`);
+        console.log(`✅ Created view: app/views/${name}.free`);
+    },
+    service: (name) => {
+        const dir = path.join(process.cwd(), "app/services");
+        fs.ensureDirSync(dir);
+        const filePath = path.join(dir, `${name}.js`);
+        guard(filePath, `Service ${name}`);
+        fs.writeFileSync(filePath, `/**\n * app/services/${name}.js\n * Enterprise service layer logic.\n */\nclass ${name} {\n    static async perform() {\n        // Your complex logic here\n    }\n}\n\nmodule.exports = ${name};\n`);
+        console.log(`✅ Created service: app/services/${name}.js`);
+    },
+};
+module.exports = make;

package/cli/commands/migrate.js ADDED Viewed

@@ -0,0 +1,67 @@
+/**
+ * cli/commands/migrate.js
+ * Implementation of 'free migrate' command.
+ */
+const fs = require("fs-extra");
+const path = require("path");
+const knex = require("knex");
+module.exports = async function () {
+    console.log("🚀 Starting Database Migrations...");
+    // Create connection config dynamically just like ORM
+    const client = process.env.DB_CLIENT || 'mysql2';
+    let connection = {};
+    if (client === 'mysql2' || client === 'pg') {
+        connection = {
+            host: process.env.DB_HOST || '127.0.0.1',
+            port: process.env.DB_PORT || (client === 'pg' ? 5432 : 3306),
+            user: process.env.DB_USER || (client === 'pg' ? 'postgres' : 'root'),
+            password: process.env.DB_PASS || '',
+            database: process.env.DB_NAME || 'free_db',
+        };
+        if (client === 'pg' && process.env.DB_SSL === 'true') {
+            connection.ssl = { rejectUnauthorized: false };
+        }
+    } else {
+        const dbPath = process.env.DB_PATH || 'database.sqlite';
+        const fullPath = path.isAbsolute(dbPath) ? dbPath : path.join(process.cwd(), dbPath);
+        connection = { filename: fullPath };
+        const dbDir = path.dirname(fullPath);
+        if (!fs.existsSync(dbDir)) {
+            fs.mkdirSync(dbDir, { recursive: true });
+        }
+    }
+    const migrationsDir = path.join(process.cwd(), "database", "migrations");
+    if (!fs.existsSync(migrationsDir)) {
+        console.warn("⚠️ No migrations directory found. Run 'free make:migration create_users_table' first.");
+        process.exit(0);
+    }
+    const db = knex({
+        client,
+        connection,
+        useNullAsDefault: client === 'sqlite3',
+        migrations: {
+            directory: migrationsDir
+        }
+    });
+    try {
+        const [batchNo, log] = await db.migrate.latest();
+        if (log.length === 0) {
+            console.log("✅ Database is already up to date.");
+        } else {
+            console.log(`✅ Batch ${batchNo} run: ${log.length} migrations`);
+            log.forEach(m => console.log(`   👉 ${m}`));
+        }
+    } catch (err) {
+        console.error("❌ Migration failed:", err.message);
+        process.exit(1);
+    } finally {
+        await db.destroy();
+    }
+};

package/cli/commands/new.js ADDED Viewed

@@ -0,0 +1,54 @@
+/**
+ * cli/commands/new.js
+ * Implementation of 'free new <name>' command.
+ */
+const fs = require("fs-extra");
+const path = require("path");
+const { execSync } = require("child_process");
+module.exports = function (name) {
+    const targetDir = path.join(process.cwd(), name);
+    const templateDir = path.join(__dirname, "../../templates/app-template");
+    console.log(`\n✨ Creating a new Free project in: ${targetDir}`);
+    if (fs.existsSync(targetDir)) {
+        console.error("Error: Target directory already exists.");
+        process.exit(1);
+    }
+    // Copy template
+    fs.copySync(templateDir, targetDir);
+    // Initialize the massive enterprise directory scaffolding dynamically
+    const dirsToCreate = [
+        "app/Http/Controllers",
+        "app/Http/Middleware",
+        "app/Models",
+        "app/Services",
+        "config",
+        "database/migrations",
+        "database/seeders",
+        "public/assets",
+        "public/css",
+        "public/js",
+        "public/images",
+        "resources/views",
+        "resources/css",
+        "routes",
+        "storage/logs",
+        "storage/framework"
+    ];
+    dirsToCreate.forEach(dir => {
+        fs.ensureDirSync(path.join(targetDir, dir));
+        // Add a .gitkeep to ensure the folder is trackable in version control
+        fs.writeFileSync(path.join(targetDir, dir, ".gitkeep"), "");
+    });
+    // Wrap up
+    console.log("\n✅ Enterprise Project Scaffolded Successfully!");
+    console.log(`\nTo get started, run:\n  cd ${name}\n  npm install\n  free serve\n`);
+};

package/cli/commands/serve.js ADDED Viewed

@@ -0,0 +1,73 @@
+/**
+ * cli/commands/serve.js
+ * Implementation of 'free serve' command.
+ */
+const { spawn } = require("child_process");
+const path = require("path");
+const chokidar = require("chokidar");
+const build = require("./build");
+module.exports = function (options) {
+    const port = options.port || 3000;
+    let serverProcess = null;
+    const startServer = () => {
+        if (serverProcess) {
+            serverProcess.kill();
+        }
+        console.log("🚀 Starting server...");
+        // Set view directory to the current project's views
+        process.env.VIEWS_PATH = path.join(process.cwd(), "views");
+        process.env.PORT = port;
+        process.env.FREE_PATH = path.join(__dirname, "../../");
+        const args = [path.join(process.cwd(), ".free/app.js")];
+        if (options.cluster) args.push("--cluster");
+        serverProcess = spawn("node", args, {
+            stdio: "inherit",
+            env: process.env
+        });
+        serverProcess.on("close", (code) => {
+            if (code && code !== 0) {
+                console.error(`Server process exited with code ${code}`);
+            }
+        });
+    };
+    startServer();
+    const appDir = path.join(process.cwd(), "app");
+    let isRebuilding = false;
+    // The Fast Refresh / Auto-Rebuild logic
+    chokidar.watch(appDir, { ignoreInitial: true }).on("all", (event, file) => {
+        if (isRebuilding) return;
+        isRebuilding = true;
+        console.log(`\n🔄 ${path.basename(file)} changed. Fast-refreshing...`);
+        try {
+            build(); // Rebuild AST and Generators
+            // Graceful restart: Only restart if build succeeds
+            setTimeout(() => {
+                startServer();
+                console.log(`✅ Ready.`);
+                isRebuilding = false;
+            }, 100);
+        } catch (err) {
+            console.error(`❌ Fast-refresh failed:`, err.message);
+            isRebuilding = false;
+        }
+    });
+    process.on("SIGINT", () => {
+        if (serverProcess) serverProcess.kill();
+        process.exit();
+    });
+};

package/cli/commands/test.js ADDED Viewed

@@ -0,0 +1,57 @@
+/**
+ * cli/commands/test.js
+ * Implementation of 'free test' command wrapped around Vitest.
+ */
+const { execSync } = require("child_process");
+const fs = require("fs-extra");
+const path = require("path");
+module.exports = function () {
+    const projectRoot = process.cwd();
+    // Check if Vitest is installed in the project
+    const packageJsonPath = path.join(projectRoot, "package.json");
+    if (!fs.existsSync(packageJsonPath)) {
+        console.error("❌ No package.json found. Make sure you are in a valid Free project.");
+        process.exit(1);
+    }
+    let packageJson;
+    try {
+        packageJson = require(packageJsonPath);
+    } catch (e) {
+        console.error("❌ Error reading package.json.");
+        process.exit(1);
+    }
+    const hasVitest = (packageJson.devDependencies && packageJson.devDependencies.vitest) ||
+        (packageJson.dependencies && packageJson.dependencies.vitest);
+    if (!hasVitest) {
+        console.log("📦 Vitest not detected. Installing Vitest specifically for Free Testing Suite...");
+        try {
+            execSync("npm install vitest --save-dev", { stdio: "inherit", cwd: projectRoot });
+            console.log("✅ Vitest installed successfully.");
+        } catch (e) {
+            console.error("❌ Failed to install Vitest.");
+            process.exit(1);
+        }
+    }
+    // Zero-Config: Create vitest.config.js if missing
+    const configPath = path.join(projectRoot, "vitest.config.js");
+    if (!fs.existsSync(configPath)) {
+        console.log("📝 Generating default vitest.config.js...");
+        const configContent = `import { defineConfig } from 'vitest/config';\n\nexport default defineConfig({\n  test: {\n    environment: 'node',\n    globals: true,\n    include: ['**/*.{test,spec}.{js,ts}'],\n  },\n});\n`;
+        fs.writeFileSync(configPath, configContent);
+    }
+    console.log("\n🧪 Running Free Testing Suite (Vitest)...\n");
+    try {
+        // Execute Vitest on all files containing '.test.' or '.spec.'
+        execSync("npx vitest run", { stdio: "inherit", cwd: projectRoot });
+    } catch (error) {
+        console.error("\n❌ Tests failed. Please review the output above.");
+        process.exit(1);
+    }
+};