lapeh 2.1.2 → 2.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lapeh",
-  "version": "2.1.2",
+  "version": "2.1.4",
   "description": "Framework API Express yang siap pakai (Standardized)",
   "main": "index.js",
   "bin": {
@@ -9,8 +9,11 @@
   "scripts": {
     "dev": "node scripts/check-update.js && nodemon src/index.ts",
     "first": "node scripts/init-project.js",
+    "prebuild": "npm run prisma:generate",
     "build": "tsc",
+    "prestart": "npm run prisma:generate",
     "start": "node dist/src/index.js",
+    "prestart:prod": "npm run prisma:generate",
     "start:prod": "NODE_ENV=production node dist/src/index.js",
     "typecheck": "tsc --noEmit",
     "prisma:generate": "node scripts/compile-schema.js && prisma generate",

package/prisma/base.prisma.template

@@ -1,8 +1,7 @@
-generator client {
-  provider = "prisma-client-js"
-  output   = "../generated/prisma"
-}
-
-datasource db {
-  provider = "postgresql"
-}
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "postgresql"
+}

package/prisma/schema.prisma

@@ -1,11 +1,10 @@
-generator client {
-  provider = "prisma-client-js"
-  output   = "../generated/prisma"
-}
-
-datasource db {
-  provider = "postgresql"
-}
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "postgresql"
+}
 
 
 model cache {

package/readme.md

@@ -75,25 +75,25 @@ Jika Anda melakukan setup dengan flag `--full`, database akan terisi dengan akun
 
 ---
 
-## 🔄 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.
-
+## 🔄 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.
@@ -223,23 +223,144 @@ npm run config:clear
 
 ---
 
-## 📂 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
+## 📂 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/src/prisma.ts

@@ -1,11 +1,11 @@
-import { PrismaClient } from "../generated/prisma";
+const { PrismaClient } = require("@prisma/client");
 import { PrismaPg } from "@prisma/adapter-pg";
 import { PrismaMariaDb } from "@prisma/adapter-mariadb";
 
 const url = process.env.DATABASE_URL || "";
 const provider = (process.env.DATABASE_PROVIDER || "").toLowerCase();
 
-let prisma: PrismaClient;
+let prisma: any;
 
 if (provider === "postgresql" || url.startsWith("postgres")) {
   const adapter = new PrismaPg({ connectionString: url });

package/tsconfig.json

@@ -1,12 +1,21 @@
 {
   "compilerOptions": {
-    "target": "es2016",
-    "module": "commonjs",
-    "rootDir": "./",
-    "outDir": "./dist",
+    "target": "ES2020",
+    "module": "CommonJS",
+    "outDir": "dist",
+    "rootDir": ".",
     "strict": true,
     "esModuleInterop": true,
     "skipLibCheck": true,
     "forceConsistentCasingInFileNames": true
-  }
-}
+  },
+  "include": [
+    "src",
+    "prisma",
+    "generated"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist"
+  ]
+}