lapeh 2.2.7 → 2.2.9

package/{api-testing-sepuluh → api-testing-enambelas}/package-lock.json

@@ -1,17 +1,27 @@
 {
-  "name": "api-testing-sepuluh",
+  "name": "api-testing-enambelas",
   "version": "1.0.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
-      "name": "api-testing-sepuluh",
+      "name": "api-testing-enambelas",
       "version": "1.0.0",
+      "hasInstallScript": true,
       "license": "MIT",
       "dependencies": {
         "@prisma/adapter-mariadb": "7.2.0",
         "@prisma/adapter-pg": "7.2.0",
         "@prisma/client": "7.2.0",
+        "@types/bcryptjs": "2.4.6",
+        "@types/compression": "^1.8.1",
+        "@types/cors": "2.8.19",
+        "@types/express": "5.0.6",
+        "@types/jsonwebtoken": "9.0.10",
+        "@types/multer": "^2.0.0",
+        "@types/node": "25.0.3",
+        "@types/pg": "8.16.0",
+        "@types/uuid": "10.0.0",
         "bcryptjs": "3.0.3",
         "compression": "^1.8.1",
         "cors": "2.8.5",
@@ -39,15 +49,8 @@
       },
       "devDependencies": {
         "@eslint/js": "^9.39.2",
-        "@types/bcryptjs": "2.4.6",
         "@types/compression": "^1.7.5",
-        "@types/cors": "2.8.19",
         "@types/express": "^5.0.0",
-        "@types/jsonwebtoken": "9.0.10",
-        "@types/multer": "^2.0.0",
-        "@types/node": "25.0.3",
-        "@types/pg": "8.16.0",
-        "@types/uuid": "10.0.0",
         "eslint": "^9.39.2",
         "globals": "^16.5.0",
         "prisma": "7.2.0",
@@ -55,12 +58,21 @@
       }
     },
     "..": {
-      "version": "2.2.6",
+      "version": "2.2.8",
       "license": "MIT",
       "dependencies": {
         "@prisma/adapter-mariadb": "7.2.0",
         "@prisma/adapter-pg": "7.2.0",
         "@prisma/client": "7.2.0",
+        "@types/bcryptjs": "2.4.6",
+        "@types/compression": "^1.8.1",
+        "@types/cors": "2.8.19",
+        "@types/express": "5.0.6",
+        "@types/jsonwebtoken": "9.0.10",
+        "@types/multer": "^2.0.0",
+        "@types/node": "25.0.3",
+        "@types/pg": "8.16.0",
+        "@types/uuid": "10.0.0",
         "bcryptjs": "3.0.3",
         "compression": "^1.8.1",
         "cors": "2.8.5",
@@ -90,15 +102,6 @@
       },
       "devDependencies": {
         "@eslint/js": "^9.39.2",
-        "@types/bcryptjs": "2.4.6",
-        "@types/compression": "^1.8.1",
-        "@types/cors": "2.8.19",
-        "@types/express": "5.0.6",
-        "@types/jsonwebtoken": "9.0.10",
-        "@types/multer": "^2.0.0",
-        "@types/node": "25.0.3",
-        "@types/pg": "8.16.0",
-        "@types/uuid": "10.0.0",
         "eslint": "^9.39.2",
         "globals": "^16.5.0",
         "typescript-eslint": "^8.50.1"
@@ -790,14 +793,12 @@
       "version": "2.4.6",
       "resolved": "https://registry.npmjs.org/@types/bcryptjs/-/bcryptjs-2.4.6.tgz",
       "integrity": "sha512-9xlo6R2qDs5uixm0bcIqCeMCE6HiQsIyel9KQySStiyqNl2tnj2mP3DX1Nf56MD6KMenNNlBBsy3LJ7gUEQPXQ==",
-      "dev": true,
       "license": "MIT"
     },
     "node_modules/@types/body-parser": {
       "version": "1.19.6",
       "resolved": "https://registry.npmjs.org/@types/body-parser/-/body-parser-1.19.6.tgz",
       "integrity": "sha512-HLFeCYgz89uk22N5Qg3dvGvsv46B8GLvKKo1zKG4NybA8U2DiEO3w9lqGg29t/tfLRJpJ6iQxnVw4OnB7MoM9g==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "@types/connect": "*",
@@ -819,7 +820,6 @@
       "version": "3.4.38",
       "resolved": "https://registry.npmjs.org/@types/connect/-/connect-3.4.38.tgz",
       "integrity": "sha512-K6uROf1LD88uDQqJCktA4yzL1YYAK6NgfsI0v/mTgyPKWsX1CnJ0XPSDhViejru1GcRkLWb8RlzFYJRqGUbaug==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "@types/node": "*"
@@ -845,7 +845,6 @@
       "version": "5.0.6",
       "resolved": "https://registry.npmjs.org/@types/express/-/express-5.0.6.tgz",
       "integrity": "sha512-sKYVuV7Sv9fbPIt/442koC7+IIwK5olP1KWeD88e/idgoJqDm3JV/YUiPwkoKK92ylff2MGxSz1CSjsXelx0YA==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "@types/body-parser": "*",
@@ -857,7 +856,6 @@
       "version": "5.1.0",
       "resolved": "https://registry.npmjs.org/@types/express-serve-static-core/-/express-serve-static-core-5.1.0.tgz",
       "integrity": "sha512-jnHMsrd0Mwa9Cf4IdOzbz543y4XJepXrbia2T4b6+spXC2We3t1y6K44D3mR8XMFSXMCf3/l7rCgddfx7UNVBA==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "@types/node": "*",
@@ -876,7 +874,6 @@
       "version": "2.0.5",
       "resolved": "https://registry.npmjs.org/@types/http-errors/-/http-errors-2.0.5.tgz",
       "integrity": "sha512-r8Tayk8HJnX0FztbZN7oVqGccWgw98T/0neJphO91KkmOzug1KkofZURD4UaD5uH8AqcFLfdPErnBod0u71/qg==",
-      "dev": true,
       "license": "MIT"
     },
     "node_modules/@types/ioredis-mock": {
@@ -900,7 +897,6 @@
       "version": "9.0.10",
       "resolved": "https://registry.npmjs.org/@types/jsonwebtoken/-/jsonwebtoken-9.0.10.tgz",
       "integrity": "sha512-asx5hIG9Qmf/1oStypjanR7iKTv0gXQ1Ov/jfrX6kS/EO0OFni8orbmGCn0672NHR3kXHwpAwR+B368ZGN/2rA==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "@types/ms": "*",
@@ -911,14 +907,12 @@
       "version": "2.1.0",
       "resolved": "https://registry.npmjs.org/@types/ms/-/ms-2.1.0.tgz",
       "integrity": "sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA==",
-      "dev": true,
       "license": "MIT"
     },
     "node_modules/@types/multer": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/@types/multer/-/multer-2.0.0.tgz",
       "integrity": "sha512-C3Z9v9Evij2yST3RSBktxP9STm6OdMc5uR1xF1SGr98uv8dUlAL2hqwrZ3GVB3uyMyiegnscEK6PGtYvNrjTjw==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "@types/express": "*"
@@ -937,7 +931,6 @@
       "version": "8.16.0",
       "resolved": "https://registry.npmjs.org/@types/pg/-/pg-8.16.0.tgz",
       "integrity": "sha512-RmhMd/wD+CF8Dfo+cVIy3RR5cl8CyfXQ0tGgW6XBL8L4LM/UTEbNXYRbLwU6w+CgrKBNbrQWt4FUtTfaU5jSYQ==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "@types/node": "*",
@@ -949,14 +942,12 @@
       "version": "6.14.0",
       "resolved": "https://registry.npmjs.org/@types/qs/-/qs-6.14.0.tgz",
       "integrity": "sha512-eOunJqu0K1923aExK6y8p6fsihYEn/BYuQ4g0CxAAgFc4b/ZLN4CrsRZ55srTdqoiLzU2B2evC+apEIxprEzkQ==",
-      "dev": true,
       "license": "MIT"
     },
     "node_modules/@types/range-parser": {
       "version": "1.2.7",
       "resolved": "https://registry.npmjs.org/@types/range-parser/-/range-parser-1.2.7.tgz",
       "integrity": "sha512-hKormJbkJqzQGhziax5PItDUTMAM9uE2XXQmM37dyd4hVM+5aVl7oVxMVUiVQn2oCQFN/LKCZdvSM0pFRqbSmQ==",
-      "dev": true,
       "license": "MIT"
     },
     "node_modules/@types/react": {
@@ -974,7 +965,6 @@
       "version": "1.2.1",
       "resolved": "https://registry.npmjs.org/@types/send/-/send-1.2.1.tgz",
       "integrity": "sha512-arsCikDvlU99zl1g69TcAB3mzZPpxgw0UQnaHeC1Nwb015xp8bknZv5rIfri9xTOcMuaVgvabfIRA7PSZVuZIQ==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "@types/node": "*"
@@ -984,7 +974,6 @@
       "version": "2.2.0",
       "resolved": "https://registry.npmjs.org/@types/serve-static/-/serve-static-2.2.0.tgz",
       "integrity": "sha512-8mam4H1NHLtu7nmtalF7eyBH14QyOASmcxHhSfEoRyr0nP/YdoesEtU+uSRvMe96TW/HPTtkoKqQLl53N7UXMQ==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "@types/http-errors": "*",
@@ -1001,7 +990,6 @@
       "version": "10.0.0",
       "resolved": "https://registry.npmjs.org/@types/uuid/-/uuid-10.0.0.tgz",
       "integrity": "sha512-7gqG38EyHgyP1S+7+xomFtL+ZNHcKv6DwNaCZmJmo1vgMugyF3TCnXVg4t1uk89mLNwnLtnY3TpOpCOyp1/xHQ==",
-      "dev": true,
       "license": "MIT"
     },
     "node_modules/@typescript-eslint/eslint-plugin": {

package/{api-testing-sepuluh → api-testing-enambelas}/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "api-testing-sepuluh",
+  "name": "api-testing-enambelas",
   "version": "1.0.0",
   "description": "Generated by lapeh",
   "main": "index.js",
@@ -31,7 +31,8 @@
     "make:module": "node scripts/make-module.js",
     "make:model": "node scripts/make-model.js",
     "make:controller": "node scripts/make-controller.js",
-    "config:clear": "node scripts/config-clear.js"
+    "config:clear": "node scripts/config-clear.js",
+    "postinstall": "node scripts/compile-schema.js && prisma generate"
   },
   "keywords": [
     "nodejs-framework",
@@ -82,22 +83,24 @@
     "winston-daily-rotate-file": "^5.0.0",
     "zod": "3.23.8",
     "prisma": "7.2.0",
-    "lapeh": "file:../"
-  },
-  "devDependencies": {
-    "@eslint/js": "^9.39.2",
     "@types/bcryptjs": "2.4.6",
-    "@types/compression": "^1.7.5",
+    "@types/compression": "^1.8.1",
     "@types/cors": "2.8.19",
-    "@types/express": "^5.0.0",
+    "@types/express": "5.0.6",
     "@types/jsonwebtoken": "9.0.10",
     "@types/multer": "^2.0.0",
     "@types/node": "25.0.3",
     "@types/pg": "8.16.0",
     "@types/uuid": "10.0.0",
+    "lapeh": "file:../"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
     "eslint": "^9.39.2",
     "globals": "^16.5.0",
     "typescript-eslint": "^8.50.1",
-    "prisma": "7.2.0"
+    "prisma": "7.2.0",
+    "@types/express": "^5.0.0",
+    "@types/compression": "^1.7.5"
   }
 }

package/{api-testing-sepuluh → api-testing-enambelas}/tsconfig.json

@@ -18,8 +18,12 @@
       ],
       "@/*": [
         "./src/*"
+      ],
+      "@lapeh/core/database": [
+        "./node_modules/lapeh/lib/prisma.ts"
       ]
-    }
+    },
+    "baseUrl": "."
   },
   "include": [
     "lib",

package/api-testing-tujuhbelas/.env.example

@@ -0,0 +1,19 @@
+PORT=8000
+DATABASE_PROVIDER="postgresql"
+DATABASE_URL="postgresql://sianu:12341234@localhost:5432/db_example_test?schema=public"   
+
+# Used for all encryption-related tasks in the framework (JWT, etc.)
+JWT_SECRET="replace_this_with_a_secure_random_string"
+
+# Framework Timezone
+TZ="Asia/Jakarta"
+
+# Redis Configuration (Optional)
+# If REDIS_URL is not set or connection fails, the framework will automatically 
+# switch to an in-memory Redis mock (bundled). No installation required for development.
+# REDIS_URL="redis://lapeh:12341234@localhost:6379"
+# NO_REDIS="true"
+
+# To force disable Redis and use in-memory mock even if Redis is available:
+# NO_REDIS="true"
+

package/api-testing-tujuhbelas/api-testing-enambelas/.env.example

@@ -0,0 +1,19 @@
+PORT=8000
+DATABASE_PROVIDER="postgresql"
+DATABASE_URL="postgresql://sianu:12341234@localhost:5432/db_example_test?schema=public"   
+
+# Used for all encryption-related tasks in the framework (JWT, etc.)
+JWT_SECRET="replace_this_with_a_secure_random_string"
+
+# Framework Timezone
+TZ="Asia/Jakarta"
+
+# Redis Configuration (Optional)
+# If REDIS_URL is not set or connection fails, the framework will automatically 
+# switch to an in-memory Redis mock (bundled). No installation required for development.
+# REDIS_URL="redis://lapeh:12341234@localhost:6379"
+# NO_REDIS="true"
+
+# To force disable Redis and use in-memory mock even if Redis is available:
+# NO_REDIS="true"
+

package/api-testing-tujuhbelas/api-testing-enambelas/doc/ARCHITECTURE_GUIDE.md

@@ -0,0 +1,73 @@
+# Panduan Arsitektur: Menuju "Framework as a Dependency" (Next.js Style)
+
+Saat ini, Lapeh menggunakan pendekatan **Boilerplate** (seperti Laravel), di mana pengguna mendapatkan seluruh kode sumber (`src/`) dan bertanggung jawab atas `express`, `prisma`, dll.
+
+Untuk mengubahnya menjadi seperti **Next.js** (di mana pengguna hanya menginstall `lapeh` dan `package.json` mereka bersih), kita perlu mengubah arsitektur menjadi **Library**.
+
+## 1. Perbedaan Utama
+
+| Fitur | Boilerplate (Lapeh Saat Ini) | Library (Next.js Style) |
+| :--- | :--- | :--- |
+| **Instalasi** | `git clone` / `npx create-lapeh` | `npm install lapeh` |
+| **package.json** | Banyak dependency (`express`, `cors`, dll) | Sedikit (`lapeh`, `react`) |
+| **Scripts** | Panjang (`nodemon src/index.ts`) | Pendek (`lapeh dev`) |
+| **Core Code** | Terbuka di `src/core/` | Tersembunyi di `node_modules/lapeh` |
+| **Update** | Susah (harus merge manual) | Mudah (`npm update lapeh`) |
+
+## 2. Langkah Implementasi
+
+Saya telah memulai langkah pertama dengan menambahkan **CLI Runner** di `bin/index.js`.
+
+### A. Update CLI (`bin/index.js`) ✅ (Sudah Dilakukan)
+Saya sudah menambahkan command `dev`, `start`, dan `build` ke dalam CLI Lapeh. Ini memungkinkan pengguna menjalankan server tanpa tahu perintah aslinya.
+
+```javascript
+// Contoh penggunaan nanti:
+"scripts": {
+  "dev": "lapeh dev",
+  "build": "lapeh build",
+  "start": "lapeh start"
+}
+```
+
+### B. Struktur Project Pengguna (Target)
+Nantinya, project pengguna Lapeh hanya akan berisi file bisnis mereka:
+
+```text
+my-app/
+├── src/
+│   ├── controllers/
+│   ├── routes/
+│   └── models/
+├── lapeh.config.ts  <-- Konfigurasi framework (pengganti edit core)
+└── package.json
+```
+
+Dan `package.json` mereka akan terlihat seperti ini:
+
+```json
+{
+  "name": "my-app",
+  "dependencies": {
+    "lapeh": "^2.0.0"
+  },
+  "scripts": {
+    "dev": "lapeh dev",
+    "build": "lapeh build",
+    "start": "lapeh start"
+  }
+}
+```
+
+### C. Apa yang Harus Dilakukan Selanjutnya?
+
+1.  **Publish Package**: Anda perlu mempublish folder framework ini ke NPM (atau private registry).
+    *   Pastikan `express`, `cors`, `helmet`, dll ada di `dependencies` (bukan `devDependencies`).
+2.  **Abstraksi `src/index.ts`**:
+    *   Saat ini `src/index.ts` adalah entry point yang diedit user.
+    *   Ubah agar `lapeh dev` menjalankan server internal yang **mengimpor** routes/controller user secara dinamis (seperti Next.js pages router).
+3.  **Config Loader**:
+    *   Buat sistem pembacaan `lapeh.config.ts` untuk mengatur Port, Database URL, dll tanpa mengedit kode core.
+
+## 3. Kesimpulan
+Perubahan yang saya lakukan di `bin/index.js` adalah fondasi untuk CLI style. Untuk mencapai "Clean package.json" sepenuhnya, Anda harus memisahkan **Framework Core** (repo ini) dengan **User Project** (repo baru yang menginstall framework ini).

package/api-testing-tujuhbelas/api-testing-enambelas/doc/CHANGELOG.md

@@ -0,0 +1,77 @@
+# Dokumentasi Perubahan Lapeh Framework
+
+File ini mencatat semua perubahan, pembaruan, dan perbaikan yang dilakukan pada framework Lapeh, diurutkan berdasarkan tanggal.
+
+## [2025-12-27] - Code Quality & Standardization Update
+
+### 🚀 Fitur & Standarisasi
+
+- **Standardized Import Paths**:
+  - Implementasi path alias `@/` untuk import yang lebih bersih (e.g., `import { prisma } from "@/core/database"`).
+  - Penghapusan penggunaan relative paths yang dalam (`../../../`).
+  - Konfigurasi `tsconfig.json` tanpa `baseUrl` (mengikuti standar TypeScript 6.0+).
+- **Strict Linting & Code Quality**:
+  - Implementasi aturan **ESLint** ketat untuk mencegah "Dead Code".
+  - Error otomatis untuk variabel, parameter, dan import yang tidak digunakan (`no-unused-vars`).
+  - Script `npm run lint` dan `npm run lint:fix` untuk pembersihan kode otomatis.
+- **Fastify-Style Standardization**:
+  - Penerapan standar respon cepat (`sendFastSuccess`) di seluruh controller (`AuthController`, `RbacController`, `PetController`).
+  - Penggunaan **Schema-based Serialization** untuk performa JSON maksimal.
+  - Konversi otomatis `BigInt` ke `string` dalam respon JSON.
+
+## [2025-12-27] - High Performance & Scalability Update
+
+### 🚀 Fitur Baru
+
+- **High Performance Serialization (Fastify-Style)**:
+  - Implementasi `fast-json-stringify` untuk serialisasi JSON super cepat (2x-3x lebih cepat dari `JSON.stringify`).
+  - Helper `sendFastSuccess` di `src/utils/response.ts` untuk mem-bypass overhead Express.
+  - Caching schema serializer otomatis di `src/core/serializer.ts`.
+- **Scalability & Clustering**:
+  - Dukungan **Load Balancing** dengan Nginx.
+  - Dukungan **Redis Clustering** untuk Rate Limiter (`rate-limit-redis`).
+  - File konfigurasi `docker-compose.cluster.yml` untuk simulasi cluster lokal (1 Nginx + 2 App Instances + 1 Redis).
+- **Smart Error Handling**:
+  - Deteksi otomatis port bentrok (`EADDRINUSE`) saat startup.
+  - Memberikan saran command _copy-paste_ untuk mematikan process yang memblokir port (support Windows, Mac, Linux).
+- **SEO Optimization**:
+  - Update metadata `package.json` dan `README.md` agar framework lebih mudah ditemukan di Google/NPM.
+
+## [2025-12-27] - Pembaruan Struktur & Validasi
+
+### 🚀 Fitur Baru
+
+- **Laravel-style Validator**:
+  - Implementasi utility `Validator` baru di `src/utils/validator.ts` yang meniru gaya validasi Laravel.
+  - Mendukung rule string seperti `required|string|min:3|email`.
+  - Penambahan rule `unique` untuk pengecekan database otomatis (Prisma).
+  - Penambahan rule `mimes`, `image`, `max` (file size) untuk validasi upload file.
+  - Penambahan rule `sometimes` untuk field opsional.
+- **Framework Hardening (Keamanan & Stabilitas)**:
+  - **Rate Limiting**: Middleware anti-spam/brute-force di `src/middleware/rateLimit.ts`.
+  - **Request Logger**: Pencatatan log request masuk di `src/middleware/requestLogger.ts`.
+  - **Health Check**: Endpoint `/` kini mengembalikan status kesehatan server.
+  - **Graceful Shutdown**: Penanganan penutupan koneksi Database dan Redis yang aman saat server berhenti (`SIGTERM`/`SIGINT`).
+  - **Environment Validation**: Validasi variabel `.env` wajib (seperti `DATABASE_URL`, `JWT_SECRET`) saat startup.
+- **Struktur Folder Baru**:
+  - Pemisahan konfigurasi inti ke `src/core/` (`server.ts`, `database.ts`, `redis.ts`, `realtime.ts`) agar folder `src` lebih bersih.
+  - Sentralisasi route di `src/routes/index.ts` (WIP).
+- **CLI Improvements**:
+  - `npx lapeh <project-name> --full` kini otomatis menjalankan server dev setelah instalasi selesai, sehingga user bisa langsung melihat hasil tanpa mengetik perintah tambahan.
+
+### 🛠️ Perbaikan & Refactoring
+
+- **Controller Refactoring**:
+  - `AuthController`: Migrasi ke `Validator` baru, termasuk validasi upload avatar.
+  - `PetController`: Migrasi ke `Validator` baru.
+  - `RbacController`: Migrasi sebagian ke `Validator` baru.
+- **Pembersihan**:
+  - Penghapusan folder `src/schema/` (Zod schema lama) karena sudah digantikan oleh `Validator` utility.
+  - Penghapusan file duplikat/lama di root `src/` setelah migrasi ke `src/core/`.
+
+### 📝 Catatan Teknis
+
+- **Validator Async**: Method `fails()`, `passes()`, dan `validated()` kini bersifat `async` untuk mendukung pengecekan database (`unique`).
+- **Type Safety**: Semua perubahan telah diverifikasi dengan `npm run typecheck`.
+
+---

package/api-testing-tujuhbelas/api-testing-enambelas/doc/CHEATSHEET.md

@@ -0,0 +1,94 @@
+# Lapeh Framework Cheatsheet
+
+Referensi cepat untuk perintah dan kode yang sering digunakan.
+
+## 💻 CLI Commands
+
+| Perintah                             | Fungsi                                       |
+| :----------------------------------- | :------------------------------------------- |
+| **`npm run dev`**                    | Menjalankan server development (hot-reload). |
+| **`npm run typecheck`**              | Cek error TypeScript (tanpa compile).        |
+| **`npm run lint`**                   | Cek kode kotor/variabel tidak terpakai.      |
+| **`npm run lint:fix`**               | Perbaiki kode kotor otomatis.                |
+| **`npm run make:module <Name>`**     | Buat Controller, Route, & Model sekaligus.   |
+| **`npm run make:controller <Name>`** | Buat Controller saja.                        |
+| **`npm run make:model <Name>`**      | Buat Model Prisma saja.                      |
+| **`npm run prisma:migrate`**         | Apply perubahan schema ke DB lokal.          |
+| **`npm run db:studio`**              | Buka GUI Database.                           |
+| **`npm run db:seed`**                | Isi data dummy.                              |
+| **`npm run db:reset`**               | Hapus DB & mulai dari nol.                   |
+
+## 🛡️ Validator Rules (Laravel-Style)
+
+Gunakan di `Validator.make(data, rules)`.
+
+| Rule               | Deskripsi               | Contoh                              |
+| :----------------- | :---------------------- | :---------------------------------- | -------- |
+| `required`         | Wajib ada & tidak null. | `"required"`                        |
+| `string`           | Harus text.             | `"required                          | string"` |
+| `number`           | Harus angka.            | `"required                          | number"` |
+| `email`            | Format email valid.     | `"required                          | email"`  |
+| `min:X`            | Min panjang/nilai.      | `"min:8"` (pass), `"min:18"` (umur) |
+| `max:X`            | Max panjang/nilai.      | `"max:255"`                         |
+| `unique:table,col` | Cek unik di DB.         | `"unique:users,email"`              |
+| `exists:table,col` | Cek exist di DB.        | `"exists:roles,id"`                 |
+| `image`            | File harus gambar.      | `"required                          | image"`  |
+| `mimes:types`      | File extension.         | `"mimes:pdf,docx"`                  |
+
+## 🔑 Authentication
+
+**Middleware di Route:**
+
+```typescript
+import { requireAuth, requireAdmin } from "@/middleware/auth";
+
+router.get("/profile", requireAuth, getProfile); // Login User
+router.delete("/user", requireAuth, requireAdmin, del); // Admin Only
+```
+
+**Akses User di Controller:**
+
+```typescript
+// (req as any).user tersedia setelah requireAuth
+const userId = (req as any).user.userId;
+const role = (req as any).user.role;
+```
+
+## ⚡ Fast Response (Serializer)
+
+**1. Schema:**
+
+```typescript
+const schema = {
+  type: "object",
+  properties: {
+    id: { type: "string" },
+    name: { type: "string" },
+  },
+};
+```
+
+**2. Serializer:**
+
+```typescript
+const serializer = getSerializer("key-name", createResponseSchema(schema));
+```
+
+**3. Send:**
+
+```typescript
+sendFastSuccess(res, 200, serializer, { ...data });
+```
+
+## 📦 Redis (Cache)
+
+```typescript
+import { redis } from "@lapeh/core/redis";
+
+// Set Cache (Key, Value, Mode, Detik)
+await redis.set("profile:1", JSON.stringify(data), "EX", 3600);
+
+// Get Cache
+const cached = await redis.get("profile:1");
+if (cached) return JSON.parse(cached);
+```

package/api-testing-tujuhbelas/api-testing-enambelas/doc/CLI.md

@@ -0,0 +1,106 @@
+# CLI Tools & Scripts
+
+Lapeh Framework dilengkapi dengan berbagai script CLI untuk mempercepat proses development, mulai dari generate code hingga manajemen database.
+
+Semua perintah dijalankan menggunakan `npm run <command>`.
+
+## Code Generators
+
+Gunakan perintah ini untuk membuat file boilerplate secara otomatis.
+
+### 1. Membuat Module Lengkap (`make:module`)
+Membuat Controller, Route, dan Model (Schema) sekaligus.
+
+```bash
+npm run make:module <nama-module>
+```
+**Contoh:** `npm run make:module Product`
+
+Output:
+- `src/controllers/productController.ts`
+- `src/routes/product.ts`
+- `src/models/product.prisma`
+
+### 2. Membuat Controller (`make:controller`)
+Hanya membuat file controller dengan method CRUD dasar.
+
+```bash
+npm run make:controller <nama-controller>
+```
+**Contoh:** `npm run make:controller Order` (Akan membuat `src/controllers/orderController.ts`)
+
+### 3. Membuat Model Database (`make:model`)
+Hanya membuat file schema Prisma baru.
+
+```bash
+npm run make:model <nama-model>
+```
+**Contoh:** `npm run make:model Transaction` (Akan membuat `src/models/transaction.prisma`)
+
+## Database Management (Prisma)
+
+Framework ini menggunakan sistem **Multi-File Schema**. Anda tidak mengedit `schema.prisma` secara langsung, melainkan mengedit file kecil di `src/models/*.prisma`.
+
+### 1. Migrasi Database (`prisma:migrate`)
+Jalankan setiap kali Anda mengubah definisi model di `src/models/*.prisma`.
+
+```bash
+npm run prisma:migrate
+```
+Perintah ini akan:
+1. Menggabungkan semua file `.prisma` di `src/models/` menjadi satu `prisma/schema.prisma`.
+2. Membuat file migrasi SQL.
+3. Menerapkan perubahan ke database lokal.
+4. Men-generate ulang Prisma Client (Type Definitions).
+
+### 2. Deploy ke Production (`prisma:deploy`)
+Gunakan di server production. Hanya menerapkan migrasi yang sudah ada tanpa reset data.
+
+```bash
+npm run prisma:deploy
+```
+
+### 3. Database Studio (`db:studio`)
+Membuka GUI di browser untuk melihat dan mengedit data database.
+
+```bash
+npm run db:studio
+```
+
+### 4. Seeding Data (`db:seed`)
+Mengisi database dengan data awal yang didefinisikan di `prisma/seed.ts`.
+
+```bash
+npm run db:seed
+```
+
+### 5. Reset Database (`db:reset`)
+**PERINGATAN:** Menghapus semua data dan tabel, lalu menjalankan migrasi dari awal.
+
+```bash
+npm run db:reset
+```
+
+## Code Quality & Utilities
+
+### 1. Linting (`lint`)
+Memeriksa kode dari error, variabel tidak terpakai, dan gaya penulisan.
+
+```bash
+npm run lint
+```
+Gunakan `npm run lint:fix` untuk memperbaiki error otomatis.
+
+### 2. Type Check (`typecheck`)
+Memeriksa error tipe data TypeScript tanpa melakukan compile.
+
+```bash
+npm run typecheck
+```
+
+### 3. Generate JWT Secret (`generate:jwt`)
+Membuat random string aman untuk `JWT_SECRET` di file `.env`.
+
+```bash
+npm run generate:jwt
+```