lapeh 2.2.6 → 2.2.7

package/api-testing-sepuluh/readme.md

@@ -0,0 +1,414 @@
+# Lapeh Framework - Modern Node.js & TypeScript API Framework
+
+**Lapeh** adalah framework **Node.js** berbasis **Express** dan **TypeScript** yang dirancang untuk kecepatan dan skalabilitas. Menggabungkan fleksibilitas Express dengan struktur solid ala **Laravel** dan **NestJS**, Lapeh memberikan pengalaman development **REST API** yang cepat, terstandarisasi, dan siap produksi.
+
+Cocok untuk developer yang mencari **Express boilerplate** dengan fitur lengkap: Prisma ORM, Authentication, RBAC, dan Zero-Config Redis.
+
+## 🚀 Fitur Utama
+
+- **Production Ready**: Struktur folder modular (MVC) yang mudah dikembangkan.
+- **TypeScript First**: Full type-safety untuk mengurangi runtime error.
+- **Prisma ORM Integration**: Database modern dengan dukungan PostgreSQL dan MySQL.
+- **Laravel-style Structure**: Controller, Service, dan Route yang terpisah rapi.
+- **Auto CLI Generator**: Buat modul, model, dan controller dengan satu perintah.
+- **Smart Caching**: Otomatis menggunakan Redis jika tersedia, fallback ke in-memory jika tidak.
+- **Secure by Default**: Dilengkapi Helmet, Rate Limiting, CORS, dan JWT Auth.
+- **Robust Validation**: Validasi request otomatis menggunakan Zod.
+- **High Performance**: Mendukung Fast-Serialization (Fastify-style) untuk response JSON super cepat.
+- **Scalable**: Siap untuk deployment Cluster/Load Balancer dengan Redis Store.
+
+## 🔮 Roadmap (Rencana Masa Depan)
+
+Lapeh Framework akan terus berkembang menjadi solusi Enterprise yang lengkap. Kami memiliki rencana besar untuk fitur-fitur seperti **Job Queues**, **Storage Abstraction (S3)**, **Mailer**, dan **OpenAPI Generator**.
+
+Lihat detail rencana pengembangan di **[ROADMAP.md](doc/ROADMAP.md)**.
+
+## 🤝 Berkontribusi (Open Source)
+
+Lapeh adalah proyek Open Source dan kami sangat terbuka untuk kontribusi dari komunitas! Baik itu perbaikan bug, penambahan fitur, atau perbaikan dokumentasi.
+
+Ingin ikut berkontribusi? Silakan baca **[Panduan Kontribusi (CONTRIBUTING.md)](doc/CONTRIBUTING.md)** untuk memulai.
+
+## 📚 Dokumentasi Lengkap
+
+Kami menyusun "Learning Path" agar Anda bisa memahami framework ini dari nol hingga mahir.
+
+### 🐣 Level 1: Pemula (Wajib Baca)
+
+- **[Pengenalan Framework](doc/INTRODUCTION.md)**: Mengapa framework ini ada? Apa bedanya dengan yang lain?
+- **[Getting Started](doc/GETTING_STARTED.md)**: Instalasi dan setup awal.
+- **[Bedah Struktur Folder](doc/STRUCTURE.md)**: Pahami fungsi setiap file dan direktori.
+- **[Referensi Package](doc/PACKAGES.md)**: Penjelasan kegunaan setiap library yang terinstall.
+- **[Cheatsheet (Contekan)](doc/CHEATSHEET.md)**: Daftar perintah & kode cepat.
+
+### 🔨 Level 2: Membangun Aplikasi
+
+- **[CLI Tools](doc/CLI.md)**: Percepat kerja dengan generator kode (`make:module`, dll).
+- **[Tutorial Studi Kasus](doc/TUTORIAL.md)**: Bikin API "Perpustakaan" dari nol sampai jadi.
+- **[Fitur & Konsep Inti](doc/FEATURES.md)**: Validasi, Auth, RBAC, dan Serializer.
+
+### 🚀 Level 3: Mahir & Production
+
+- **[Performance Guide](doc/PERFORMANCE.md)**: Tips optimasi high-scale app.
+- **[Security Best Practices](doc/SECURITY.md)**: Panduan mengamankan aplikasi.
+- **[Deployment Guide](doc/DEPLOYMENT.md)**: Cara deploy ke VPS, Docker, atau Cloud.
+- **[FAQ & Troubleshooting](doc/FAQ.md)**: Solusi masalah umum.
+- **[Changelog](doc/CHANGELOG.md)**: Riwayat versi.
+
+## 📦 Instalasi & Penggunaan
+
+Anda dapat menginstall framework ini menggunakan versi terbaru atau versi spesifik agar lebih fleksibel:
+
+### 1. Menggunakan Versi Terbaru (Recommended)
+
+```bash
+npx lapeh@latest nama-project-anda
+```
+
+Atau gunakan flag `--full` untuk setup lengkap (termasuk seeding data default user & roles):
+
+```bash
+npx lapeh@latest nama-project-anda --full
+```
+
+### 2. Menggunakan Versi Spesifik
+
+Jika Anda membutuhkan versi tertentu (misalnya untuk kompatibilitas):
+
+```bash
+npx lapeh@1.0.8 nama-project-anda
+```
+
+Atau dengan setup lengkap:
+
+```bash
+npx lapeh@1.0.8 nama-project-anda --full
+```
+
+### Apa yang terjadi otomatis?
+
+1. Struktur project dibuat.
+2. Dependencies diinstall.
+3. Database dipilih & dikonfigurasi secara interaktif.
+4. **Database** dibuat dan dimigrasi otomatis.
+5. **JWT Secret** di-generate otomatis.
+6. **Seeding Data** (jika menggunakan `--full`).
+
+Masuk ke folder project dan jalankan:
+
+```bash
+cd nama-project-anda
+npm run dev
+```
+
+Server akan berjalan di `http://localhost:4000`.
+
+### 🔑 Akun Default (Jika menggunakan `--full` atau `npm run db:seed`)
+
+Jika Anda melakukan setup dengan flag `--full`, database akan terisi dengan akun default berikut:
+
+| Role            | Email       | Password |
+| :-------------- | :---------- | :------- |
+| **Super Admin** | `sa@sa.com` | `string` |
+| **Admin**       | `a@a.com`   | `string` |
+| **User**        | `u@u.com`   | `string` |
+
+> **Catatan:** Segera ubah password akun-akun ini jika Anda mendeploy ke production!
+
+---
+
+## 🔄 Upgrade Project
+
+Jika Anda memiliki project lama yang dibuat dengan versi Lapeh sebelumnya dan ingin memperbarui struktur, scripts, dan konfigurasi ke standar terbaru (termasuk keamanan Redis baru), Anda tidak perlu membuat project ulang.
+
+Cukup jalankan perintah ini di dalam folder project Anda:
+
+```bash
+npx lapeh@latest upgrade
+```
+
+Perintah ini akan secara otomatis:
+
+1.  Mengupdate `scripts/` (termasuk generator controller baru).
+2.  Mengupdate `docker-compose.yml` (keamanan Redis).
+3.  Mengupdate dependencies di `package.json`.
+4.  Menambahkan konfigurasi `.vscode` dan `tsconfig` terbaru.
+
+> **Catatan:** File `.env` Anda **tidak akan ditimpa**, namun kami akan mengupdate `.env.example` sebagai referensi konfigurasi terbaru.
+
+## 🧠 Zero-Config Redis
+
+Lapeh otomatis mendeteksi ketersediaan Redis.
+
+1.  **Auto-Discovery**: Mencoba terhubung ke Redis URL di `.env` (`REDIS_URL`).
+2.  **Smart Fallback**: Jika Redis tidak tersedia atau koneksi gagal, otomatis beralih ke **In-Memory Mock**.
+    - Tidak perlu install Redis di local development.
+    - Fitur rate-limiting dan caching tetap berjalan (namun data hilang saat restart).
+3.  **Production Safety**: Memberikan peringatan log jika berjalan di Production menggunakan Mock.
+
+**Force Mock Mode:**
+Anda bisa memaksa menggunakan mock (misal untuk testing) dengan menambahkan env variable:
+
+```env
+NO_REDIS=true
+```
+
+### Optional: Menggunakan Real Redis dengan Docker
+
+Jika Anda ingin menggunakan Redis yang sebenarnya di local environment, kami telah menyertakan konfigurasi `docker-compose.yml` yang aman (menggunakan ACL).
+
+1.  Jalankan Redis container:
+
+    ```bash
+    docker-compose up -d
+    ```
+
+2.  Uncomment konfigurasi Redis di file `.env` Anda:
+
+    ```env
+    REDIS_URL="redis://lapeh:12341234@localhost:6379"
+    ```
+
+    > **Credential Default:**
+    >
+    > - User: `lapeh`
+    > - Password: `12341234`
+
+## 🛠 Development Tools
+
+API Lapeh menyediakan tools untuk mempercepat development, mirip dengan `artisan` di Laravel.
+
+### 1. Membuat Module (Resource)
+
+Membuat Controller, Service, dan Route sekaligus.
+
+```bash
+npm run make:module NamaResource
+# Contoh: npm run make:module Product
+```
+
+Command ini akan membuat:
+
+- `src/controllers/product.controller.ts`
+- `src/services/product.service.ts`
+- `src/routes/product.route.ts` (dan otomatis didaftarkan di `src/routes/index.ts` jika memungkinkan)
+
+### 2. Membuat Model Database
+
+Membuat file model Prisma baru di dalam folder `src/models/` (atau `prisma/models` tergantung konfigurasi).
+
+```bash
+npm run make:model NamaModel
+# Contoh: npm run make:model User
+```
+
+Ini akan membuat file `src/models/User.prisma`.
+
+### 3. Membuat Controller
+
+Membuat file Controller baru. Gunakan flag `-r` untuk membuat controller lengkap dengan method CRUD (index, show, store, update, destroy).
+
+```bash
+npm run make:controller NamaController
+# Contoh Basic: npm run make:controller PaymentController
+
+# Contoh Resource (CRUD Lengkap):
+npm run make:controller PaymentController -r
+```
+
+### 4. Workflow Database (Prisma)
+
+Karena framework ini menggunakan **Schema Terpisah** (split schema), Anda **TIDAK BOLEH** mengedit `prisma/schema.prisma` secara manual.
+
+- **Edit Models**: Lakukan perubahan di `src/models/*.prisma`.
+- **Apply Changes**: Jalankan perintah migrasi standar, sistem akan otomatis menggabungkan (compile) schema Anda.
+
+```bash
+# Generate Prisma Client (setiap ada perubahan model)
+npm run prisma:generate
+
+# Migrasi Database (Development)
+npm run prisma:migrate
+
+# Membuka GUI Database (Prisma Studio)
+npm run db:studio
+
+# Migrasi Database Dan Seed (Development - Reset Total default option for development)
+npm run db:reset
+
+# Deploy ke Production
+npm run prisma:deploy
+```
+
+> **Catatan:** Script `compile-schema.js` akan otomatis berjalan sebelum perintah prisma di atas dieksekusi.
+
+### 5. Generate JWT Secret
+
+Jika Anda perlu me-refresh secret key JWT:
+
+```bash
+npm run generate:jwt
+```
+
+### 6. Maintenance (Clear Config)
+
+Membersihkan cache framework, NPM, build artifacts, dan temporary files (sangat berguna jika mengalami isu cache aneh atau ingin reset environment development).
+
+```bash
+npm run config:clear
+```
+
+- Menghapus `node_modules/.cache`
+- Menghapus `dist/`
+- Menghapus `dump.rdb` (Redis Persistence)
+- Membersihkan `npm cache`
+
+---
+
+## 📂 Struktur Folder
+
+```text
+src/
+├── controllers/     # Logika Request & Response
+├── services/        # Business Logic
+├── routes/          # Definisi Route API
+├── models/          # Definisi Schema Prisma per Model
+├── middleware/      # Auth, Validation, Error Handling
+├── schema/          # Zod Validation Schemas
+├── utils/           # Helper Functions
+└── index.ts         # App Entry Point
+prisma/
+├── schema.prisma    # [GENERATED] Jangan edit file ini
+└── base.prisma.template # Konfigurasi Datasource & Generator
+```
+
+## 📝 Lisensi
+
+MIT
+
+---
+
+## 🚀 Deployment Guide
+
+### 1) Build & Generate Prisma Client (Otomatis)
+
+- Build: `npm run build`
+- Start (dev): `npm run start`
+- Start (prod): `npm run start:prod`
+- Hooks otomatis:
+  - `prebuild`, `prestart`, dan `prestart:prod` akan memanggil `npm run prisma:generate` sehingga Prisma Client selalu tersedia tanpa error.
+
+### 2) Production Environment
+
+- Pastikan `.env` berisi kredensial production:
+  - `DATABASE_URL` dan `DATABASE_PROVIDER` (mysql/postgresql)
+  - `JWT_SECRET` (gunakan `npm run generate:jwt` untuk mengganti)
+- Terapkan migrasi production (tanpa reset data):
+
+```bash
+npm run prisma:deploy
+```
+
+### 3) Menjalankan dengan PM2
+
+- Install PM2:
+
+```bash
+npm i -g pm2
+```
+
+- Jalankan aplikasi:
+
+```bash
+pm2 start dist/src/index.js --name lapeh-api --time
+```
+
+- Simpan proses agar auto-start saat reboot:
+
+```bash
+pm2 save
+pm2 startup
+```
+
+- Monitoring:
+
+```bash
+pm2 status
+pm2 logs lapeh-api
+pm2 restart lapeh-api
+```
+
+### 4) Nginx Reverse Proxy (Recommended)
+
+- Buat server block `/etc/nginx/sites-available/lapeh`:
+
+```nginx
+server {
+  listen 80;
+  server_name example.com;
+
+  location / {
+    proxy_set_header Host $host;
+    proxy_set_header X-Real-IP $remote_addr;
+    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    proxy_set_header X-Forwarded-Proto $scheme;
+    proxy_pass http://127.0.0.1:4000;
+  }
+}
+```
+
+- Aktifkan:
+
+```bash
+sudo ln -s /etc/nginx/sites-available/lapeh /etc/nginx/sites-enabled/lapeh
+sudo nginx -t
+sudo systemctl reload nginx
+```
+
+- SSL (opsional, Certbot):
+
+```bash
+sudo apt install certbot python3-certbot-nginx -y
+sudo certbot --nginx -d example.com
+```
+
+### 5) Apache 2 Reverse Proxy (Alternatif)
+
+- Enable modul proxy:
+
+```bash
+sudo a2enmod proxy proxy_http headers
+sudo systemctl reload apache2
+```
+
+- Buat vhost `/etc/apache2/sites-available/lapeh.conf`:
+
+```apache
+<VirtualHost *:80>
+  ServerName example.com
+  ProxyPreserveHost On
+  ProxyRequests Off
+  <Proxy *>
+    Require all granted
+  </Proxy>
+  ProxyPass / http://127.0.0.1:4000/
+  ProxyPassReverse / http://127.0.0.1:4000/
+  ErrorLog ${APACHE_LOG_DIR}/lapeh-error.log
+  CustomLog ${APACHE_LOG_DIR}/lapeh-access.log combined
+</VirtualHost>
+```
+
+- Aktifkan:
+
+```bash
+sudo a2ensite lapeh.conf
+sudo apachectl configtest
+sudo systemctl reload apache2
+```
+
+### 6) Checklist Produksi
+
+- `npm run prisma:deploy` sukses dan tabel terbentuk
+- `pm2 status` menunjukkan proses hidup
+- Proxy (Nginx/Apache) menuju port aplikasi (default 4000)
+- `.env` aman dan tidak di-commit ke repository

package/api-testing-sepuluh/scripts/check-update.js

@@ -0,0 +1,92 @@
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+
+// --- KONFIGURASI ---
+// Ganti URL ini dengan URL raw package.json dari repository GitHub/GitLab Anda
+// Contoh: 'https://raw.githubusercontent.com/username/project-name/main/package.json'
+// Jika package dipublish ke NPM, Anda bisa menggunakan registry NPM.
+const REPO_VERSION_URL = 'https://registry.npmjs.org/lapeh/latest'; 
+const TIMEOUT = 2000; // Timeout 2 detik agar tidak terlalu lama menunggu
+
+const packageJson = require('../package.json');
+// Cek apakah ada key "lapeh" di dependencies (project user)
+// Jika tidak ada, fallback ke version package.json (mungkin ini repo framework itu sendiri)
+const currentVersion = packageJson.dependencies?.['lapeh'] || packageJson.version;
+
+function checkForUpdates() {
+  if (!REPO_VERSION_URL) return;
+
+  const req = https.get(REPO_VERSION_URL, { 
+    headers: { 'User-Agent': 'NodeJS Update Checker' },
+    timeout: TIMEOUT 
+  }, (res) => {
+    let data = '';
+
+    if (res.statusCode !== 200) {
+      // Silent fail jika URL tidak bisa diakses
+      return;
+    }
+
+    res.on('data', (chunk) => {
+      data += chunk;
+    });
+
+    res.on('end', () => {
+      try {
+        const remoteJson = JSON.parse(data);
+        // Jika cek ke NPM, version ada di root object atau 'version'
+        // Jika cek ke raw github, structure sama dengan package.json
+        const latestVersion = remoteJson.version || remoteJson['dist-tags']?.latest;
+
+        if (latestVersion && isNewer(latestVersion, currentVersion)) {
+          showUpdateMessage(latestVersion, currentVersion);
+        }
+      } catch (e) {
+        // Ignore parsing errors
+      }
+    });
+  });
+
+  req.on('error', (e) => {
+    // Ignore network errors
+  });
+
+  req.end();
+}
+
+function isNewer(latest, current) {
+  const lParts = latest.split('.').map(Number);
+  const cParts = current.split('.').map(Number);
+  
+  for (let i = 0; i < 3; i++) {
+    if (lParts[i] > cParts[i]) return true;
+    if (lParts[i] < cParts[i]) return false;
+  }
+  return false;
+}
+
+function showUpdateMessage(latest, current) {
+    const reset = "\x1b[0m";
+    const bright = "\x1b[1m";
+    const fgYellow = "\x1b[33m";
+    const fgCyan = "\x1b[36m";
+    
+    console.log('\n');
+    console.log(`${fgYellow}┌─────────────────────────────────────────────────────────────┐${reset}`);
+    console.log(`${fgYellow}│                                                             │${reset}`);
+    console.log(`${fgYellow}│   ${bright}UPDATE FRAMEWORK TERSEDIA!${reset}${fgYellow}                                │${reset}`);
+    console.log(`${fgYellow}│                                                             │${reset}`);
+    console.log(`${fgYellow}│   Versi Lokal   : ${fgCyan}${current}${reset}${fgYellow}                                      │${reset}`);
+    console.log(`${fgYellow}│   Versi Terbaru : ${fgCyan}${latest}${reset}${fgYellow}                                      │${reset}`);
+    console.log(`${fgYellow}│                                                             │${reset}`);
+    console.log(`${fgYellow}│   Silakan cek repository untuk melihat perubahan terbaru.   │${reset}`);
+    console.log(`${fgYellow}│                                                             │${reset}`);
+    console.log(`${fgYellow}│   Untuk upgrade jalankan:                                   │${reset}`);
+    console.log(`${fgYellow}│   ${fgCyan}npm install lapeh@latest${reset}${fgYellow}                                    │${reset}`);
+    console.log(`${fgYellow}│                                                             │${reset}`);
+    console.log(`${fgYellow}└─────────────────────────────────────────────────────────────┘${reset}`);
+    console.log('\n');
+}
+
+checkForUpdates();

package/api-testing-sepuluh/scripts/compile-schema.js

@@ -0,0 +1,29 @@
+const fs = require('fs');
+const path = require('path');
+
+const prismaDir = path.join(__dirname, '..', 'prisma');
+const modelsDir = path.join(__dirname, '..', 'src', 'models');
+const schemaFile = path.join(prismaDir, 'schema.prisma');
+const baseFile = path.join(prismaDir, 'base.prisma.template');
+
+// Ensure models directory exists
+if (!fs.existsSync(modelsDir)) {
+  fs.mkdirSync(modelsDir, { recursive: true });
+}
+
+// Read base schema (datasource & generator)
+let schemaContent = fs.readFileSync(baseFile, 'utf8');
+
+// Read all .prisma files in src/models
+const modelFiles = fs.readdirSync(modelsDir).filter(file => file.endsWith('.prisma'));
+
+modelFiles.forEach(file => {
+  const content = fs.readFileSync(path.join(modelsDir, file), 'utf8');
+  schemaContent += '\n\n' + content;
+});
+
+// Write concatenated content to prisma/schema.prisma
+fs.writeFileSync(schemaFile, schemaContent);
+
+console.log('✅ Prisma schema compiled successfully!');
+console.log(`   Merged ${modelFiles.length} model files from src/models/ into prisma/schema.prisma`);

package/api-testing-sepuluh/scripts/config-clear.js

@@ -0,0 +1,45 @@
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+const rootDir = path.join(__dirname, '..');
+
+console.log('🧹 Starting cleanup process...');
+
+// 1. Remove dist folder (Build artifacts)
+const distDir = path.join(rootDir, 'dist');
+if (fs.existsSync(distDir)) {
+  console.log('🗑️  Removing dist/ folder...');
+  fs.rmSync(distDir, { recursive: true, force: true });
+}
+
+// 2. Remove node_modules/.cache (Framework caches: ts-node, eslint, etc)
+const nmCacheDir = path.join(rootDir, 'node_modules', '.cache');
+if (fs.existsSync(nmCacheDir)) {
+  console.log('🗑️  Removing node_modules/.cache...');
+  fs.rmSync(nmCacheDir, { recursive: true, force: true });
+}
+
+// 3. Remove Redis local persistence file (dump.rdb)
+const dumpRdb = path.join(rootDir, 'dump.rdb');
+if (fs.existsSync(dumpRdb)) {
+  console.log('🗑️  Removing dump.rdb (Redis persistence)...');
+  fs.unlinkSync(dumpRdb);
+}
+
+// 4. Remove Coverage folder (if exists)
+const coverageDir = path.join(rootDir, 'coverage');
+if (fs.existsSync(coverageDir)) {
+  console.log('🗑️  Removing coverage/ folder...');
+  fs.rmSync(coverageDir, { recursive: true, force: true });
+}
+
+// 5. Clear NPM Cache
+try {
+  console.log('📦 Clearing NPM cache...');
+  execSync('npm cache clean --force', { stdio: 'inherit' });
+} catch (error) {
+  console.warn('⚠️  Warning: Could not clear NPM cache. You might need admin privileges.');
+}
+
+console.log('✨ Cleanup complete! Project is fresh.');

package/api-testing-sepuluh/scripts/generate-jwt-secret.js

@@ -0,0 +1,38 @@
+const fs = require('fs');
+const path = require('path');
+const crypto = require('crypto');
+
+const envPath = path.join(__dirname, '..', '.env');
+
+function generateSecret() {
+  return crypto.randomBytes(64).toString('hex');
+}
+
+try {
+  const secret = generateSecret();
+  let envContent = '';
+
+  if (fs.existsSync(envPath)) {
+    envContent = fs.readFileSync(envPath, 'utf8');
+  } else {
+    console.log('.env file not found, creating one...');
+  }
+
+  // Check if JWT_SECRET exists
+  if (envContent.match(/^JWT_SECRET=/m)) {
+    envContent = envContent.replace(/^JWT_SECRET=.*/m, `JWT_SECRET="${secret}"`);
+  } else {
+    // Ensure there is a newline before appending if the file is not empty
+    if (envContent && !envContent.endsWith('\n')) {
+      envContent += '\n';
+    }
+    envContent += `JWT_SECRET="${secret}"\n`;
+  }
+
+  fs.writeFileSync(envPath, envContent);
+  console.log('✅ JWT Secret generated and updated in .env file.');
+  console.log('🔑 New Secret has been set.');
+} catch (error) {
+  console.error('❌ Error updating .env file:', error);
+  process.exit(1);
+}