lumpiajs 1.0.5 → 1.0.7

package/README.md

@@ -1,196 +1,151 @@
 # 🥟 LumpiaJS
 
 **Bahasa Pemrograman Web dengan Kearifan Lokal Semarangan.**  
-_Framework ini dibuat untuk seru-seruan (have fun) dan biar bikin web jadi lebih cepat dan menyenangkan!_ (Rencananya sih gitu... wkwkwk)
+Framework ini hadir sebagai solusi "Have Fun" bagi developer. Meskipun gayanya santai, LumpiaJS mengadopsi arsitektur **MVC (Model-View-Controller)** yang mirip banget sama framework sebelah (uhuk, Laravel). Jadi kamu bisa pakai struktur yang profesional!
 
-## 🚀 Cara Pakai (Quick Start)
-
-Kamu bisa pilih cara yang paling enak buat mulai bikin (masak) web:
+---
 
-### 1. Langsung Gas (Tanpa Install)
+## 🚀 Panduan Instalasi & Penggunaan (Lengkap)
 
-Kalau malas install-install, pastikan komputer kamu sudah ada Node.js, lalu langsung aja pakai `npx`:
+### Opsi A: Menggunakan Command `lumpia` (Disarankan)
 
-**Langkah 1: Buat Project**
+**1. Install Secara Global**
 
 ```bash
-npx lumpiajs create-project warung-ku
+npm install -g lumpiajs
 ```
 
-_(Atau pakai istilah lokal: `npx lumpiajs buka-cabang warung-ku`)_
-
-**Langkah 2: Masuk & Install Bumbu (Dependencies)**
-Penting! Kamu harus install dependencies biar `import` framework-nya jalan.
+**2. Buat Project Baru**
 
 ```bash
-cd warung-ku
-npm install
+lumpia create-project warung-ku
 ```
 
-**Langkah 3: Nyalakan Kompor (Server)**
+**3. Masuk & Install Dependencies (Wajib)**
 
 ```bash
-npm start
+cd warung-ku && npm install
 ```
 
-_(Atau manual: `npx lumpia dodolan`)_
-Websitemu bakal jalan di `http://localhost:3000`.
-
----
-
-### 2. Install Global (Biar Bisa Dipakai Terus)
-
-Kalau kamu pengen perintah `lumpia` bisa dipanggil dari mana saja di terminal:
+**4. Jalankan Server**
 
 ```bash
-# 1. Install dulu secara global
-npm install -g lumpiajs
+lumpia kukus
+```
 
-# 2. Bikin project baru
-lumpia create-project toko-lumpia
+_(Alias: `lumpia serve`)_
 
-# 3. Masuk folder & install npm
-cd toko-lumpia
-npm install
+---
 
-# 4. Jalanin server
-lumpia dodolan
-```
+## ⚙️ Konfigurasi Environment (.env)
 
-**Cara Update ke Versi Terbaru:**
+Setiap project LumpiaJS dilengkapi file `.env` di root folder.
 
-```bash
-npm install -g lumpiajs@latest
+```env
+BASE_URL="http://localhost:3000"
+APP_ENV="local"
+APP_DEBUG="true"
 ```
 
 ---
 
 ## 🏗️ Struktur Project (Standar MVC)
 
-LumpiaJS sekarang menggunakan arsitektur **MVC (Model-View-Controller)** yang mengikuti standar internasional, jadi developer Laravel atau Express pasti langsung paham.
-
 ```
 warung-ku/
 ├── app/
 │   ├── controllers/ # Otak Logika (Controller)
 │   └── models/      # Pengolah Data (Model)
 ├── routes/
-│   └── web.js       # Rute URL
+│   └── web.js       # Rute URL (Jalur Akses)
 ├── views/           # Tampilan (.lmp)
+├── .env             # File Konfigurasi (Environment)
 ├── package.json
 └── ...
 ```
 
 ### 1. Routes (`routes/web.js`)
 
-Tempat mengatur alamat URL web kamu.
+Mengatur jalur URL. Sekarang sudah support parameter dinamis seperti Laravel!
 
 ```javascript
 import { Jalan } from "lumpiajs";
 
-// Jalan.gawe(url, 'NamaController@method')
-Jalan.gawe("/", "HomeController@index");
-Jalan.gawe("/api/products", "ProductController@index");
+// Basic GET
+Jalan.get("/", "HomeController@index");
+
+// API (POST/PUT/DELETE)
+Jalan.post("/api/products", "ProductController@store");
+Jalan.put("/api/products/{id}", "ProductController@update");
+Jalan.delete("/api/products/{id}", "ProductController@destroy");
+
+// Dynamic Route dengan Parameter
+Jalan.get("/produk/{id}", "ProductController@show");
+Jalan.get("/kategori/{slug}", "CategoryController@index");
 ```
 
 ### 2. Controllers (`app/controllers`)
 
-Otak dari aplikasimu. Class harus meng-extend `Controller`.
+Otak dari aplikasimu. Parameter dari route (misal `{id}`) otomatis masuk jadi argumen fungsi.
 
 ```javascript
 import { Controller } from "lumpiajs";
 
-export default class HomeController extends Controller {
-  index() {
-    // Tampilkan file di folder views/home.lmp
-    // Kirim data 'pesan' ke view
-    return this.tampil("home", {
-      pesan: "Halo Dunia!",
-      tanggal: new Date().toLocaleDateString(),
+export default class ProductController extends Controller {
+  // Menangkap parameter {id} dari route
+  show(id) {
+    return this.json({
+      pesan: "Menampilkan produk dengan ID: " + id,
+      id: id,
     });
   }
+
+  index() {
+    return this.tampil("home", { env: this.env.APP_ENV });
+  }
 }
 ```
 
 ### 3. Views (`views`)
 
-File `.lmp` adalah tempat kamu menulis HTML, CSS, dan JS Semarangan dalam satu file.
-Gunakan `{{ nama_variabel }}` untuk menampilkan data dari Controller.
+File berekstensi `.lmp`.
 
 ```html
 <lump>
-  <klambi> /* CSS di sini */ h1 { color: #d35400; } </klambi>
-
-  <kulit>
-    <!-- HTML di sini -->
-    <h1>{{ pesan }}</h1>
-    <p>Tanggal server: {{ tanggal }}</p>
-  </kulit>
-
-  <isi>
-    // JavaScript Client-side (Bahasa Semarangan) gawe sapa() { alert("Halo,
-    Lur!"); }
-  </isi>
+  <klambi> h1 { color: red; } </klambi>
+  <kulit> <h1>{{ pesan }}</h1> </kulit>
+  <isi> gawe sapa() { alert("Halo!"); } </isi>
 </lump>
 ```
 
 ### 4. Models (`app/models`)
 
-Tempat mengolah data (Database/API). Mendukung gaya penulisan ala Eloquent.
-
 ```javascript
 import { Model } from "lumpiajs";
-
-// Contoh penggunaan di Controller:
-// Model.use(dataProduk).dimana('harga', '<', 5000).kabeh();
+// Model.use(data).dimana('harga', '<', 5000).kabeh();
 ```
 
 ---
 
 ## 🧐 Kamus Bahasa (Transpiler)
 
-Khusus di dalam tag **`<isi>`** (pada file `.lmp`), kamu bisa menggunakan sintaks unik ini:
+Gunakan istilah Semarangan ini di dalam tag `<isi>` file `.lmp`:
 
-- `ono` ➔ `let`
-- `paten` ➔ `const`
-- `gawe` ➔ `function`
-- `yen` ➔ `if`
-- `liyane` ➔ `else`
-- `mandek` ➔ `return`
-- `ora` ➔ `!`
-- `panjang()` ➔ `.length`
+| Bahasa Semarangan | JavaScript Asli |
+| :---------------- | :-------------- |
+| `ono`             | `let`           |
+| `paten`           | `const`         |
+| `gawe`            | `function`      |
+| `yen`             | `if`            |
+| `liyane`          | `else`          |
+| `mandek`          | `return`        |
+| `ora`             | `!`             |
 
 ---
 
-## 🤝 Cara Lapor Masalah atau Kasih Saran
-
-Baru nemu bug? Atau punya ide jenius biar LumpiaJS makin jos? Sampaikan saja!
-
-Caranya gampang:
-
-1. Buka link ini: [https://github.com/fastroware/lumpiajs/issues](https://github.com/fastroware/lumpiajs/issues)
-2. Klik tombol warna hijau bertuliskan **"New Issue"**.
-3. Isi Judul dengan jelas.
-4. Jelaskan masalah atau saranmu di kolom deskripsi.
-5. Klik **"Submit new issue"**.
-
-Selesai! Masukanmu akan saya baca pas lagi senggang.
+## ⚠️ DISCLAIMER
 
----
-
-## ⚠️ DISCLAIMER (PENTING BANGET, WAJIB DIBACA!) ⚠️
-
-**LumpiaJS ini 100% project _Have Fun_ & Eksperimen.**
-
-Kami **TIDAK BERTANGGUNG JAWAB** atas segala bentuk kerugian yang mungkin terjadi akibat penggunaan software ini, termasuk tapi tidak terbatas pada:
-
-- Kebocoran data.
-- Hilangnya file penting.
-- Komputer meledak (lebay, tapi tetap saja hati-hati).
-- Kerugian materiil maupun immateriil lainnya.
-
-Gunakan framework ini dengan resiko ditanggung sendiri (_Use at your own risk_). Kalau ada error di production karena nekat pakai ini, jangan nyalahin kami ya! 🙏
-
----
+**LumpiaJS ini adalah project "Have Fun" & Eksperimen Semata.**
+Gunakan dengan resiko ditanggung sendiri (_Use at your own risk_).
 
 _Dibuat dengan ❤️ dan 🥟 dari Semarang._

package/bin/lumpia.js

@@ -7,21 +7,27 @@ async function main() {
     const perintah = args[0];
     const parameter = args[1];
 
+    // ALIAS LIST
+    // create-project : buka-cabang
+    // serve : dodolan, kukus
+    // build : goreng
+
     if (perintah === 'create-project' || perintah === 'buka-cabang') {
         createProject(parameter);
     } 
-    else if (perintah === 'dodolan' || perintah === 'serve') {
+    else if (perintah === 'dodolan' || perintah === 'serve' || perintah === 'kukus') {
         serveProject();
     }
-    else if (perintah === 'goreng') {
-        console.log("🚧 Fitur 'goreng' saiki wis otomatis digabung karo 'dodolan' via JIT Compiler MVC.");
-        console.log("   Silakan gunake: lumpia dodolan");
+    else if (perintah === 'goreng' || perintah === 'build') {
+        console.log("🚧 Fitur 'goreng' (build) saiki wis otomatis digabung karo 'kukus' (serve) via JIT Compiler MVC.");
+        console.log("   Silakan gunake: lumpia kukus (atau lumpia serve)");
     }
     else {
-        console.log('Perintah ora dikenal.');
+        console.log('Perintah ora dikenal / Command not recognized.');
         console.log('------------------------------------------------');
-        console.log('1. lumpia create-project <nama> (Bikin project)');
-        console.log('2. lumpia dodolan               (Jalanin server)');
+        console.log('1. lumpia create-project <nama>  (Alias: buka-cabang)');
+        console.log('2. lumpia serve                  (Alias: kukus, dodolan)');
+        console.log('3. lumpia build                  (Alias: goreng)');
         console.log('------------------------------------------------');
     }
 }

package/index.js

@@ -2,3 +2,4 @@
 export { Jalan, routes } from './lib/core/Router.js';
 export { LumpiaModel as Model } from './lib/core/Model.js';
 export { Controller } from './lib/core/Controller.js'; 
+export { loadEnv } from './lib/core/Env.js';

package/lib/commands/create.js

@@ -14,10 +14,12 @@ const controllerTemplate = `import { Controller } from 'lumpiajs';
 
 export default class HomeController extends Controller {
     index() {
-        // Render view in 'views' folder
+        // Tampilkan halaman home
+        // this.env bisa diakses di sini
         return this.tampil('home', { 
             message: 'Welcome to LumpiaJS MVC!',
-            author: 'Pakdhe Koding'
+            author: 'Pakdhe Koding',
+            env: this.env.APP_ENV
         });
     }
 
@@ -42,14 +44,14 @@ import ProductData from '../../app/models/Product.js';
 
 export default class ProductController extends Controller {
     index() {
-        // Eloquent-style: Model.use(data).dimana(...).jupuk()
         const result = Model.use(ProductData)
                         .dimana('price', '>', 5500)
                         .jupuk();
 
         return this.json({
             status: 'success',
-            data: result
+            data: result,
+            debug_mode: this.env.APP_DEBUG
         });
     }
 }
@@ -59,11 +61,13 @@ const viewHomeTemplate = `<lump>
   <klambi>
     h1 { color: #d35400; text-align: center; }
     .box { border: 1px solid #ddd; padding: 20px; text-align: center; margin-top: 20px; }
+    .badge { background: #eee; padding: 5px; border-radius: 4px; font-size: 12px; }
   </klambi>
 
   <kulit>
     <h1>{{ message }}</h1>
     <div class="box">
+        <span class="badge">Environment: {{ env }}</span>
         <p>Created with love by: <strong>{{ author }}</strong></p>
         <button onclick="checkPrice()">Check Price API</button>
         <br><br>
@@ -96,8 +100,8 @@ const packageJsonTemplate = (name) => `{
   "main": "routes/web.js",
   "type": "module",
   "scripts": {
-    "start": "lumpia dodolan",
-    "serve": "lumpia dodolan"
+    "start": "lumpia kukus",
+    "serve": "lumpia kukus"
   },
   "dependencies": {
     "lumpiajs": "latest"
@@ -105,6 +109,14 @@ const packageJsonTemplate = (name) => `{
 }
 `;
 
+const envTemplate = `
+BASE_URL="http://localhost:3000"
+APP_ENV="local"        
+# Pilihan: 'local', 'development', 'production'
+APP_DEBUG="true"
+# Pilihan: 'true', 'false'
+`;
+
 export function createProject(parameter) {
     const projectName = parameter;
     if (!projectName) {
@@ -120,12 +132,6 @@ export function createProject(parameter) {
     
     fs.mkdirSync(root);
     
-    // STANDARD MVC STRUCTURE:
-    // app/controllers
-    // app/models
-    // views
-    // routes
-    
     fs.mkdirSync(path.join(root, 'app', 'controllers'), { recursive: true });
     fs.mkdirSync(path.join(root, 'app', 'models'), { recursive: true });
     fs.mkdirSync(path.join(root, 'routes'));
@@ -133,6 +139,7 @@ export function createProject(parameter) {
 
     // Write files
     fs.writeFileSync(path.join(root, 'package.json'), packageJsonTemplate(projectName));
+    fs.writeFileSync(path.join(root, '.env'), envTemplate); // Create .env
     fs.writeFileSync(path.join(root, 'routes', 'web.js'), routesTemplate);
     fs.writeFileSync(path.join(root, 'app', 'controllers', 'HomeController.js'), controllerTemplate);
     fs.writeFileSync(path.join(root, 'app', 'controllers', 'ProductController.js'), productControllerTemplate);
@@ -140,10 +147,10 @@ export function createProject(parameter) {
     fs.writeFileSync(path.join(root, 'views', 'home.lmp'), viewHomeTemplate);
     fs.writeFileSync(path.join(root, 'views', 'profile.lmp'), viewProfileTemplate);
 
-    console.log('✅ Project ready! Standard MVC Structure.');
+    console.log('✅ Project ready! Standard MVC Structure with .env Support.');
     console.log('----------------------------------------------------');
     console.log(`cd ${projectName}`);
     console.log('npm install');
-    console.log('npm start');
+    console.log('lumpia kukus');
     console.log('----------------------------------------------------');
 }

package/lib/commands/serve.js

@@ -3,21 +3,78 @@ import path from 'path';
 import http from 'http';
 import { routes } from '../core/Router.js';
 import { renderLumpia } from '../core/View.js';
+import { loadEnv } from '../core/Env.js';
+
+// Baca versi LumpiaJS global (CLI ini)
+const cliPackageJson = JSON.parse(fs.readFileSync(new URL('../../package.json', import.meta.url)));
+
+// Helper untuk mencocokkan Route dengan Parameter {id} dll
+function matchRoute(definedRoute, method, pathname) {
+    if (definedRoute.method !== method) return null;
+
+    // 1. Exact Match
+    if (definedRoute.path === pathname) return { params: {} };
+
+    // 2. Dynamic Match (Regex)
+    // Convert /produk/{id}/{slug} -> ^\/produk\/([^\/]+)\/([^\/]+)$
+    const paramNames = [];
+    const regexPath = definedRoute.path.replace(/\{([a-zA-Z0-9_]+)\}/g, (match, name) => {
+        paramNames.push(name);
+        return '([^/]+)';
+    });
+
+    // Skip if no params found in definition (optimization)
+    if (regexPath === definedRoute.path) return null;
+
+    const regex = new RegExp(`^${regexPath}$`);
+    const match = pathname.match(regex);
+
+    if (match) {
+        const params = {};
+        paramNames.forEach((name, index) => {
+            params[name] = match[index + 1]; // capture groups start at 1
+        });
+        return { params };
+    }
+
+    return null;
+}
 
 export async function serveProject() {
     const root = process.cwd();
-    const routesFile = path.join(root, 'routes', 'web.js');
+    
+    // --- 1. Version Check ---
+    const userPackageJsonPath = path.join(root, 'package.json');
+    if (fs.existsSync(userPackageJsonPath)) {
+        const userPkg = JSON.parse(fs.readFileSync(userPackageJsonPath, 'utf-8'));
+        const userLumpiaVer = (userPkg.dependencies && userPkg.dependencies.lumpiajs) || 'unknown';
+        
+        console.log(`ℹ️  LumpiaJS CLI Version: ${cliPackageJson.version}`);
+        console.log(`ℹ️  Project Dependency Version: ${userLumpiaVer}`);
 
+        const cleanUserVer = userLumpiaVer.replace(/[^0-9.]/g, '');
+        if (cleanUserVer !== cliPackageJson.version && userLumpiaVer !== 'latest') {
+             console.log('\n⚠️  PERINGATAN BEDA VERSI!');
+             console.log(`   Versi CLI kamu (${cliPackageJson.version}) beda dengan versi di project (${userLumpiaVer}).`);
+             console.log('   Saran: Update project dependencies agar sinkron.');
+             console.log('   Cara update: npm install lumpiajs@latest\n');
+        }
+    }
+
+    const routesFile = path.join(root, 'routes', 'web.js');
     if (!fs.existsSync(routesFile)) return console.log("❌ This is not a LumpiaJS MVC project! (Cannot find routes/web.js)");
 
-    console.log('🔄 Loading core framework...');
-    
+    // --- 2. Load ENV ---
+    const env = loadEnv(root);
+    console.log(`🌍 Environment: ${env.APP_ENV}`);
+    console.log(`🐛 Debug Mode: ${env.APP_DEBUG}`);
+
     try {
         // Load User Routes
         const userRouteUrl =  path.join(root, 'routes', 'web.js');
         await import('file://' + userRouteUrl);
 
-        console.log(`🛣️  Routes found: ${routes.length}`);
+        console.log(`🛣️  Routes registered: ${routes.length}`);
 
         // Start Server
         const server = http.createServer(async (req, res) => {
@@ -25,29 +82,51 @@ export async function serveProject() {
             const url = new URL(req.url, `http://${req.headers.host}`);
             const pathname = url.pathname;
 
-            console.log(`📥 ${method} ${pathname}`);
+            if (env.APP_DEBUG === 'true') {
+                 console.log(`📥 ${method} ${pathname}`);
+            }
+
+            // FIND MATCHING ROUTE
+            let match = null;
+            let params = {};
 
-            const match = routes.find(r => r.path === pathname && r.method === method);
+            for (const route of routes) {
+                const result = matchRoute(route, method, pathname);
+                if (result) {
+                    match = route;
+                    params = result.params;
+                    break;
+                }
+            }
             
             if (match) {
                 try {
-                    // Action format: 'ControllerName@method'
                     const [controllerName, methodName] = match.action.split('@');
-                    
-                    // Path to 'app/controllers'
                     const controllerPath = path.join(root, 'app', 'controllers', controllerName + '.js');
                     
                     if (!fs.existsSync(controllerPath)) throw new Error(`Controller ${controllerName} not found in app/controllers!`);
                     
-                    const module = await import('file://' + controllerPath + '?update=' + Date.now()); 
+                    // In Development/Local, always invalidate cache
+                    let importUrl = 'file://' + controllerPath;
+                    if (env.APP_ENV === 'local' || env.APP_ENV === 'development') {
+                        importUrl += '?update=' + Date.now();
+                    }
+
+                    const module = await import(importUrl); 
                     const ControllerClass = module.default;
                     const instance = new ControllerClass();
                     
+                    // Inject ENV & Params to Controller
+                    instance.env = env;
+                    instance.params = params; // Available as this.params
+
                     if (typeof instance[methodName] !== 'function') {
                         throw new Error(`Method ${methodName} does not exist in ${controllerName}`);
                     }
 
-                    const result = await instance[methodName](); 
+                    // Pass params as spread arguments to the method: index(id, slug)
+                    const args = Object.values(params);
+                    const result = await instance[methodName](...args); 
 
                     if (result.type === 'html') {
                         res.writeHead(200, {'Content-Type': 'text/html'});
@@ -61,8 +140,12 @@ export async function serveProject() {
                     }
                 } catch (e) {
                     console.error(e);
+                    const errorMsg = env.APP_DEBUG === 'true' 
+                        ? `<h1>500: Server Error</h1><pre>${e.message}\n${e.stack}</pre>`
+                        : `<h1>500: Server Error</h1><p>Something went wrong.</p>`;
+                        
                     res.writeHead(500, {'Content-Type': 'text/html'});
-                    res.end(`<h1>500: Server Error</h1><pre>${e.message}\n${e.stack}</pre>`);
+                    res.end(errorMsg);
                 }
             } else {
                 res.writeHead(404, {'Content-Type': 'text/html'});
@@ -72,7 +155,7 @@ export async function serveProject() {
 
         const port = 3000;
         server.listen(port, () => {
-            console.log(`🚀 Server running at http://localhost:${port}`);
+            console.log(`🚀 Server running at ${env.BASE_URL || 'http://localhost:3000'}`);
             console.log(`(Press Ctrl+C to stop)`);
         });
 

package/lib/core/Env.js

@@ -0,0 +1,23 @@
+import fs from 'fs';
+import path from 'path';
+
+export function loadEnv(root) {
+    const envPath = path.join(root, '.env');
+    const env = {};
+    
+    if (fs.existsSync(envPath)) {
+        const content = fs.readFileSync(envPath, 'utf-8');
+        content.split('\n').forEach(line => {
+            if(line.includes('=')) {
+                const [key, val] = line.split('=');
+                env[key.trim()] = val.trim().replace(/"/g, '');
+            }
+        });
+    } else {
+        // Default values if .env not found
+        env.BASE_URL = "http://localhost:3000";
+        env.APP_ENV = "local";
+        env.APP_DEBUG = "true";
+    }
+    return env;
+}

package/lib/core/Router.js

@@ -3,12 +3,19 @@
 export const routes = [];
 
 export const Jalan = {
-    gawe: (path, action) => routes.push({ path, action, method: 'GET' }), // GET
-    jupuk: (path, action) => routes.push({ path, action, method: 'GET' }), // Alias GET
+    // Semarangan
+    gawe: (path, action) => routes.push({ path, action, method: 'GET' }), 
+    jupuk: (path, action) => routes.push({ path, action, method: 'GET' }), 
     kirim: (path, action) => routes.push({ path, action, method: 'POST' }),
     anyar: (path, action) => routes.push({ path, action, method: 'PUT' }),
     bucak: (path, action) => routes.push({ path, action, method: 'DELETE' }),
+
+    // Internasional (Laravel-like)
+    get: (path, action) => routes.push({ path, action, method: 'GET' }),
+    post: (path, action) => routes.push({ path, action, method: 'POST' }),
+    put: (path, action) => routes.push({ path, action, method: 'PUT' }),
+    delete: (path, action) => routes.push({ path, action, method: 'DELETE' }),
 };
 
-// Global Router Container (for easy access in runtime)
+// Global Router Container
 global.LumpiaRouter = routes;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lumpiajs",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "Bahasa Pemrograman Semarangan",
   "type": "module",
   "main": "index.js",

package/templates/.env.example

@@ -0,0 +1,6 @@
+
+BASE_URL="http://localhost:3000"
+APP_ENV="local"        
+# Pilihan: 'local', 'development', 'production'
+APP_DEBUG="true"
+# Pilihan: 'true', 'false'