lapeh 2.6.6 → 2.6.7

package/bin/index.js

@@ -95,8 +95,12 @@ switch (command) {
       await upgradeProject();
     })();
     break;
+  case 'init':
+  case 'create':
+    createProject(true);
+    break;
   default:
-    createProject();
+    createProject(false);
     break;
 }
 
@@ -425,8 +429,9 @@ async function upgradeProject() {
   console.log('   Please check your .env file against .env.example for any new required variables.');
 }
 
-function createProject() {
-  const projectName = args.find(arg => !arg.startsWith('-'));
+function createProject(skipFirstArg = false) {
+  const searchArgs = skipFirstArg ? args.slice(1) : args;
+  const projectName = searchArgs.find(arg => !arg.startsWith('-'));
   const isFull = args.includes('--full');
   const useDefaults = args.includes('--defaults') || args.includes('--default') || args.includes('-y');
 

package/doc/en/CHANGELOG.md

@@ -2,17 +2,38 @@
 
 File ini mencatat semua perubahan, pembaruan, dan perbaikan yang dilakukan pada framework Lapeh, diurutkan berdasarkan tanggal.
 
+## [2025-12-29] - Monday, December 29, 2025 - Upgrade CLI Improvements & MongoDB Support (v2.6.6)
+
+### 🚀 Features & Improvements
+
+- **Enhanced CLI `upgrade` Command**:
+
+  - The `upgrade` command now intelligently detects and preserves local `file:` dependencies in `package.json`. This is critical for framework contributors and local testing, ensuring that upgrading doesn't overwrite local links with npm versions.
+  - Standard users will still receive the latest npm version updates automatically.
+
+- **MongoDB & Prisma Compatibility**:
+
+  - **BigInt Fixes**: Resolved serialization issues where `BigInt` IDs (common in SQL) caused crashes in MongoDB environments. All IDs in `auth` and `rbac` controllers now safely convert to `String` before response.
+  - **RBAC Schema**: Added missing RBAC models (`roles`, `permissions`, `user_roles`, `role_permissions`) to the core `prisma/schema.prisma` generation pipeline. This ensures `npx prisma generate` works flawlessly without manual schema adjustments.
+
+- **CLI Initialization Flags**:
+  - Added new flags to `npx lapeh init` for faster setup:
+    - `--full`: Sets up a complete project with dummy data (users/roles).
+    - `--default` (or `--y`): Skips interactive prompts and uses default settings (PostgreSQL).
+
 ## [2025-12-28] - Sunday, December 28, 2025 - Multi-Database & Cleanup (v2.4.10)
 
 ### 🚀 Features & Improvements
 
 - **Multi-Database Support (CLI)**:
+
   - Added full support for project initialization with **MongoDB** and **MySQL**, alongside **PostgreSQL**.
   - Fixed database provider replacement logic in `schema.prisma` templates for better accuracy.
   - Added `--db-type=mongo|pgsql|mysql` CLI argument for zero-interaction automated installation.
   - Handled MongoDB migration differences by conditionally using `prisma db push`.
 
 - **Package Cleanup**:
+
   - Removed unnecessary development files/folders (`test-local-run`, `init`, `framework.md`, etc.) from the public NPM package.
   - Explicitly added the `LICENSE` (MIT) file to the package.
   - Ensured `dist` folder is cleanly regenerated during publication.

package/doc/en/CLI.md

@@ -10,7 +10,42 @@ All commands are executed using `npm run <command>`.
 
 Main commands to run the application:
 
-### 1. Development Server (`dev`)
+### 1. Initialize Project (`init`)
+Creates a new project from scratch.
+
+```bash
+npx lapeh@latest init <project-name> [flags]
+```
+
+**Available Flags:**
+- `--full`: Initialize with full setup (includes dummy users, roles, permissions).
+- `--default`: Initialize with default configuration (PostgreSQL) skipping interactive prompts.
+- `--y`: Alias for `--default`.
+
+**Examples:**
+```bash
+# Interactive Mode
+npx lapeh init my-app
+
+# Full Setup (Recommended for learning)
+npx lapeh init my-app --full
+
+# Fast Setup (Default Postgres)
+npx lapeh init my-app --y
+```
+
+### 2. Upgrade Framework (`upgrade`)
+Upgrades the Lapeh framework to the latest version in your existing project.
+
+```bash
+npx lapeh upgrade
+```
+**Features:**
+- Automatically updates `package.json` dependencies.
+- Syncs core framework files while preserving your custom code.
+- **Smart Dependency Handling**: Preserves local `file:` dependencies if you are developing the framework locally, otherwise updates to the latest npm version.
+
+### 3. Development Server (`dev`)
 Runs the server in development mode with hot-reload feature.
 
 ```bash

package/doc/en/GETTING_STARTED.md

@@ -19,14 +19,21 @@ The easiest way to start is by using the `npx` CLI generator.
 Run the following command in your terminal:
 
 ```bash
-npx lapeh@latest your-project-name
+# Standard Interactive Setup
+npx lapeh@latest init your-project-name
 ```
 
-Or for a full setup (with dummy user & role data):
+**Alternative Quick Setup Flags:**
 
-```bash
-npx lapeh@latest your-project-name --full
-```
+- **Full Setup** (Includes dummy data, recommended for learning):
+  ```bash
+  npx lapeh@latest init your-project-name --full
+  ```
+
+- **Default Setup** (Skips questions, uses PostgreSQL):
+  ```bash
+  npx lapeh@latest init your-project-name --y
+  ```
 
 ### 2. Initial Setup
 

package/doc/id/CHANGELOG.md

@@ -2,17 +2,38 @@
 
 File ini mencatat semua perubahan, pembaruan, dan perbaikan yang dilakukan pada framework Lapeh, diurutkan berdasarkan tanggal.
 
+## [2025-12-29] - Senin, 29 Desember 2025 - Perbaikan CLI Upgrade & Dukungan MongoDB (v2.6.6)
+
+### 🚀 Fitur & Perbaikan
+
+- **Peningkatan Perintah CLI `upgrade`**:
+
+  - Perintah `upgrade` sekarang secara cerdas mendeteksi dan mempertahankan dependensi lokal (`file:`) di `package.json`. Ini sangat penting bagi kontributor framework dan pengujian lokal, memastikan proses upgrade tidak menimpa link lokal dengan versi npm.
+  - Pengguna standar tetap akan mendapatkan pembaruan versi npm terbaru secara otomatis.
+
+- **Kompatibilitas MongoDB & Prisma**:
+
+  - **Perbaikan BigInt**: Mengatasi masalah serialisasi di mana ID bertipe `BigInt` (umum di SQL) menyebabkan crash di lingkungan MongoDB. Semua ID di controller `auth` dan `rbac` kini dikonversi menjadi `String` sebelum dikirim sebagai respons.
+  - **Schema RBAC**: Menambahkan model RBAC yang hilang (`roles`, `permissions`, `user_roles`, `role_permissions`) ke dalam pipeline generasi `prisma/schema.prisma`. Ini memastikan `npx prisma generate` berjalan lancar tanpa perlu penyesuaian schema manual.
+
+- **Flag Inisialisasi CLI**:
+  - Menambahkan flag baru pada `npx lapeh init` untuk setup yang lebih cepat:
+    - `--full`: Menyiapkan proyek lengkap dengan data dummy (user/role).
+    - `--default` (atau `--y`): Melewati pertanyaan interaktif dan menggunakan pengaturan default (PostgreSQL).
+
 ## [2025-12-28] - Minggu, 28 Desember 2025 - Multi-Database & Cleanup (v2.4.10)
 
 ### 🚀 Fitur & Perbaikan
 
 - **Dukungan Multi-Database (CLI)**:
+
   - Menambahkan dukungan penuh untuk inisialisasi proyek dengan **MongoDB** dan **MySQL** selain **PostgreSQL**.
   - Memperbaiki logika penggantian provider database pada template `schema.prisma` agar lebih akurat.
   - Menambahkan argumen CLI `--db-type=mongo|pgsql|mysql` untuk otomatisasi instalasi tanpa interaksi.
   - Mengatasi masalah migrasi pada MongoDB dengan menggunakan `prisma db push` secara kondisional.
 
 - **Pembersihan Paket (Cleanup)**:
+
   - Menghapus file dan folder development yang tidak diperlukan (`test-local-run`, `init`, `framework.md`, dll) dari paket publik NPM.
   - Menambahkan file `LICENSE` (MIT) secara eksplisit ke dalam paket.
   - Memastikan folder `dist` di-generate ulang dengan bersih saat publikasi.

package/doc/id/CLI.md

@@ -10,7 +10,42 @@ Semua perintah dijalankan menggunakan `npm run <command>`.
 
 Perintah utama untuk menjalankan aplikasi:
 
-### 1. Development Server (`dev`)
+### 1. Inisialisasi Project (`init`)
+Membuat project baru dari awal.
+
+```bash
+npx lapeh@latest init <nama-project> [flags]
+```
+
+**Flag Tersedia:**
+- `--full`: Inisialisasi dengan setup lengkap (termasuk dummy user, role, permission).
+- `--default`: Inisialisasi dengan konfigurasi default (PostgreSQL) melewati prompt interaktif.
+- `--y`: Alias untuk `--default`.
+
+**Contoh:**
+```bash
+# Mode Interaktif
+npx lapeh init my-app
+
+# Setup Lengkap (Disarankan untuk belajar)
+npx lapeh init my-app --full
+
+# Setup Cepat (Default Postgres)
+npx lapeh init my-app --y
+```
+
+### 2. Upgrade Framework (`upgrade`)
+Memperbarui framework Lapeh ke versi terbaru di project yang sudah ada.
+
+```bash
+npx lapeh upgrade
+```
+**Fitur:**
+- Secara otomatis memperbarui dependensi `package.json`.
+- Menyinkronkan file inti framework sambil menjaga kode kustom Anda.
+- **Smart Dependency Handling**: Mempertahankan dependensi `file:` lokal jika Anda mengembangkan framework secara lokal, jika tidak akan mengupdate ke versi npm terbaru.
+
+### 3. Development Server (`dev`)
 Menjalankan server dalam mode development dengan fitur hot-reload.
 
 ```bash

package/doc/id/GETTING_STARTED.md

@@ -19,14 +19,21 @@ Cara termudah untuk memulai adalah menggunakan CLI generator `npx`.
 Jalankan perintah berikut di terminal Anda:
 
 ```bash
-npx lapeh@latest nama-project-anda
+# Setup Interaktif Standar
+npx lapeh@latest init nama-project-anda
 ```
 
-Atau untuk setup lengkap (dengan data dummy user & role):
+**Opsi Setup Cepat (Flags):**
 
-```bash
-npx lapeh@latest nama-project-anda --full
-```
+- **Setup Lengkap** (Termasuk data dummy, disarankan untuk belajar):
+  ```bash
+  npx lapeh@latest init nama-project-anda --full
+  ```
+
+- **Setup Default** (Melewati pertanyaan, menggunakan PostgreSQL):
+  ```bash
+  npx lapeh@latest init nama-project-anda --y
+  ```
 
 ### 2. Setup Awal
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lapeh",
-  "version": "2.6.6",
+  "version": "2.6.7",
   "description": "Framework API Express yang siap pakai (Standardized)",
   "engines": {
     "node": ">=18.0.0",