free-framework 4.4.1 → 4.5.0

package/README.md

@@ -110,7 +110,13 @@ error 404 {
 | `free serve` | Start the development server |
 | `free build` | Build for production (minified) |
 | `free devtools` | Launch the DevTools Dashboard |
-| `free test` | Run the test suite with Vitest |
+| `free doctor` | Run project health diagnostics |
+| `free update` | Update Free Framework to the latest version |
+| `free route:list` | List all registered routes |
+| `free db:seed` | Run database seeders |
+| `free make:crud <name>` | Scaffold full CRUD for a model |
+| `free shell` | Enter interactive Free Shell |
+| `free bench` | Benchmark current app performance |
 | `free install <pkg>` | Install ecosystem plugins |
 | `free make:model <name>` | Scaffold a new model |
 

package/bin/free.js

@@ -117,4 +117,55 @@ program
         require("../cli/commands/doctor")();
     });
 
+program
+    .command("update")
+    .description("Update Free Framework to the latest version")
+    .action(() => {
+        require("../cli/commands/update")();
+    });
+
+program
+    .command("route:list")
+    .description("List all registered routes")
+    .action(() => {
+        require("../cli/commands/route_list")();
+    });
+
+program
+    .command("db:seed")
+    .description("Run database seeders")
+    .action(() => {
+        require("../cli/commands/db_seed")();
+    });
+
+program
+    .command("make:crud <name>")
+    .description("Scaffold full CRUD for a model")
+    .action((name) => {
+        require("../cli/commands/make_crud")(name);
+    });
+
+program
+    .command("shell")
+    .description("Enter interactive Free Shell")
+    .action(() => {
+        require("../cli/commands/shell")();
+    });
+
+program
+    .command("bench")
+    .description("Benchmark current app performance")
+    .option("-u, --url <url>", "URL to benchmark", "http://localhost:3000")
+    .option("-d, --duration <duration>", "Duration in seconds", 5)
+    .action((options) => {
+        require("../cli/commands/bench")(options);
+    });
+
+program
+    .command("update")
+    .description("Update Free Framework to the latest version")
+    .action(() => {
+        require("../cli/commands/update")();
+    });
+
 program.parse(process.argv);

package/cli/commands/bench.js

@@ -0,0 +1,45 @@
+/**
+ * cli/commands/bench.js
+ * Simple performance benchmarking tool.
+ */
+
+const http = require("http");
+
+module.exports = function (options) {
+    const url = options.url || "http://localhost:3000";
+    const duration = options.duration || 5; // seconds
+    console.log(`\n📊 Benchmarking ${url} for ${duration}s...\n`);
+
+    let requests = 0;
+    let errors = 0;
+    const startTime = Date.now();
+    const endTime = startTime + (duration * 1000);
+
+    const runBench = () => {
+        if (Date.now() >= endTime) {
+            const totalTime = (Date.now() - startTime) / 1000;
+            const rps = (requests / totalTime).toFixed(2);
+            console.log(`\n🏁 Results:`);
+            console.log(`   Total Requests: ${requests}`);
+            console.log(`   Total Errors:   ${errors}`);
+            console.log(`   RPS:            ${rps} req/s\n`);
+            return;
+        }
+
+        const req = http.get(url, (res) => {
+            requests++;
+            res.on('data', () => { });
+            res.on('end', runBench);
+        });
+
+        req.on('error', (e) => {
+            errors++;
+            runBench();
+        });
+    };
+
+    // Parallelize with multiple concurrent workers
+    for (let i = 0; i < 10; i++) {
+        runBench();
+    }
+};

package/cli/commands/db_seed.js

@@ -0,0 +1,39 @@
+/**
+ * cli/commands/db_seed.js
+ * Runs database seeders to populate the environment.
+ */
+
+const fs = require("fs-extra");
+const path = require("path");
+
+module.exports = async function () {
+    console.log("\n🌱 Free Framework - Seeding Database...\n");
+
+    const seederDir = path.join(process.cwd(), "database/seeders");
+    if (!fs.existsSync(seederDir)) {
+        console.log("❌ No database/seeders directory found.");
+        return;
+    }
+
+    const files = fs.readdirSync(seederDir).filter(f => f.endsWith(".js"));
+    if (files.length === 0) {
+        console.log("ℹ️  No seeder files found.");
+        return;
+    }
+
+    try {
+        const { ORM } = require("../../database/orm");
+        const knex = new ORM().knex;
+
+        for (const file of files) {
+            console.log(`   🔸 Running seeder: ${file}...`);
+            const seeder = require(path.join(seederDir, file));
+            await seeder.run(knex);
+        }
+
+        console.log("\n✅ Database seeding completed successfully.");
+    } catch (err) {
+        console.error("\n❌ Seeding failed:", err.message);
+    }
+    console.log("");
+};

package/cli/commands/make_crud.js

@@ -0,0 +1,87 @@
+/**
+ * cli/commands/make_crud.js
+ * Scaffolds Model, Controller, Views, and Routes for a resource.
+ */
+
+const fs = require("fs-extra");
+const path = require("path");
+
+module.exports = function (name) {
+    const plural = name.toLowerCase() + "s";
+    const singular = name.toLowerCase();
+    const className = name.charAt(0) + name.slice(1);
+
+    console.log(`\n🏗️  Scaffolding CRUD for resource: ${className}\n`);
+
+    // 1. Create Model
+    const modelPath = path.join(process.cwd(), `app/models/${className}.free`);
+    if (!fs.existsSync(modelPath)) {
+        const modelContent = `model ${className} {
+    title string
+    content text
+    status string
+}\n`;
+        fs.ensureDirSync(path.dirname(modelPath));
+        fs.writeFileSync(modelPath, modelContent);
+        console.log(`   ✅ Created Model: app/models/${className}.free`);
+    }
+
+    // 2. Create Controller
+    const controllerPath = path.join(process.cwd(), `app/Http/Controllers/${className}Controller.free`);
+    const controllerContent = `// ${className} Controller
+action list${plural} {
+    const items = await ${className}.all();
+    return items;
+}
+
+action get${className} {
+    const item = await ${className}.find(params.id);
+    return item;
+}
+
+action create${className} {
+    const item = await ${className}.create(body);
+    return item;
+}
+
+action delete${className} {
+    await ${className}.delete(params.id);
+    return { success: true };
+}
+`;
+    fs.ensureDirSync(path.dirname(controllerPath));
+    fs.writeFileSync(controllerPath, controllerContent);
+    console.log(`   ✅ Created Controller: app/Http/Controllers/${className}Controller.free`);
+
+    // 3. Create Basic View
+    const viewPath = path.join(process.cwd(), `resources/views/${plural}.free`);
+    const viewContent = `page ${plural} {
+    h1 { text "Manage ${plural}" }
+    
+    component ${className}List {
+        onMount {
+            state.items = await actions.list${plural}()
+        }
+
+        loop item in items {
+            div {
+                h3 { text item.title }
+                p { text item.content }
+                button { 
+                    text "Delete" 
+                    on-click { 
+                        await actions.delete${className}(item.id)
+                        state.items = await actions.list${plural}()
+                    }
+                }
+            }
+        }
+    }
+}
+`;
+    fs.ensureDirSync(path.dirname(viewPath));
+    fs.writeFileSync(viewPath, viewContent);
+    console.log(`   ✅ Created View: resources/views/${plural}.free`);
+
+    console.log(`\n🚀 CRUD scaffolded! Don't forget to register the routes in app/routes.free\n`);
+};

package/cli/commands/route_list.js

@@ -0,0 +1,51 @@
+/**
+ * cli/commands/route_list.js
+ * Displays a table of all registered routes in the project.
+ */
+
+const fs = require("fs-extra");
+const path = require("path");
+const { tokenize } = require("../../compiler/lexer");
+const { parse } = require("../../compiler/parser");
+
+module.exports = function () {
+    console.log("\n🗺️  Free Framework - Route Registry\n");
+
+    const baseDir = process.cwd();
+    const routesFile = path.join(baseDir, "app/routes.free");
+
+    // Check multiple possible locations for routes
+    const paths = [
+        path.join(baseDir, "app/routes.free"),
+        path.join(baseDir, "routes/web.free"),
+        path.join(baseDir, "routes/api.free")
+    ];
+
+    const allRoutes = [];
+
+    paths.forEach(p => {
+        if (fs.existsSync(p)) {
+            try {
+                const code = fs.readFileSync(p, "utf8");
+                const tokens = tokenize(code, path.basename(p));
+                const ast = parse(tokens, path.basename(p), code);
+
+                ast.filter(n => n.type === 'route').forEach(r => {
+                    allRoutes.push({
+                        method: r.method.toUpperCase(),
+                        path: r.path,
+                        handler: r.body.some(b => b.type === 'view') ? `View: ${r.body.find(b => b.type === 'view').viewName}` : 'Action/Logic',
+                        file: path.basename(p)
+                    });
+                });
+            } catch (e) { }
+        }
+    });
+
+    if (allRoutes.length === 0) {
+        console.log("ℹ️  No routes found in project.");
+    } else {
+        console.table(allRoutes);
+    }
+    console.log("");
+};

package/cli/commands/shell.js

@@ -0,0 +1,43 @@
+/**
+ * cli/commands/shell.js
+ * Interactive REPL for Free Framework.
+ */
+
+const repl = require("repl");
+const path = require("path");
+const fs = require("fs");
+
+module.exports = function () {
+    console.log("\n🐚 Free Framework Interactive Shell");
+    console.log("Type '.exit' to leave. Global 'Model' and project models are available.\n");
+
+    const r = repl.start({
+        prompt: "free > ",
+        useGlobal: true
+    });
+
+    // Auto-load project context
+    try {
+        const { ORM } = require("../../database/orm");
+        const { Model } = require("../../database/model");
+
+        r.context.ORM = ORM;
+        r.context.Model = Model;
+        r.context.db = new ORM().knex;
+
+        // Try to load models from app/models
+        const modelDir = path.join(process.cwd(), "app/models");
+        if (fs.existsSync(modelDir)) {
+            fs.readdirSync(modelDir).forEach(file => {
+                if (file.endsWith(".free")) {
+                    const modelName = path.basename(file, ".free");
+                    // In a real scenario, we'd need to require the compiled JS version
+                    // For now we expose the base Model class Proxy logic
+                    r.context[modelName] = Model.extend(modelName);
+                }
+            });
+        }
+    } catch (e) {
+        console.log("⚠️  Context partial load: " + e.message);
+    }
+};

package/cli/commands/update.js

@@ -0,0 +1,34 @@
+/**
+ * cli/commands/update.js
+ * Implementation of 'free update' command to keep the framework current.
+ */
+
+const { execSync } = require("child_process");
+const pkg = require("../../package.json");
+
+module.exports = function () {
+    console.log("\n🔄 Checking for Free Framework updates...\n");
+    console.log(`Current version: ${pkg.version}`);
+
+    try {
+        console.log("📡 Fetching latest version from NPM...");
+        // Use npm view to get the latest version
+        const latest = execSync("npm view free-framework version").toString().trim();
+
+        if (latest === pkg.version) {
+            console.log("✅ You are already using the latest version.");
+        } else {
+            console.log(`🚀 New version available: ${latest}`);
+            console.log("🛠️  Updating global Free Framework CLI...");
+
+            // Run global install
+            execSync("npm install -g free-framework@latest", { stdio: "inherit" });
+
+            console.log("\n✅ Update complete! Enjoy the new features.");
+        }
+    } catch (err) {
+        console.error("\n❌ Update failed. Please ensure you have an internet connection and proper permissions.");
+        console.log("💡 Try running: sudo npm install -g free-framework@latest");
+    }
+    console.log("");
+};

package/package.json

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