lapeh 1.0.1 → 1.0.3

package/readme.md

@@ -1,120 +1,126 @@
-# API Lapeh Framework
-
-**API Lapeh** adalah framework berbasis Express.js yang terstandarisasi, dirancang untuk mempercepat pengembangan REST API dengan struktur yang solid, aman, dan scalable. Terinspirasi oleh struktur Laravel dan NestJS, namun tetap menjaga kesederhanaan Express.
-
-## 🚀 Fitur Utama
-
-- **Struktur Modular**: Terorganisir rapi dengan Controllers, Services, Routes, dan Middleware.
-- **TypeScript Ready**: Full TypeScript support untuk type-safety.
-- **Prisma ORM**: Integrasi database yang modern dan type-safe.
-- **Schema Terpisah**: Mendukung pemisahan schema Prisma per model (mirip Eloquent).
-- **Generator Tools**: CLI commands untuk generate Module dan Model dengan cepat.
-- **Security Best Practices**: Dilengkapi dengan Helmet, Rate Limiting, CORS, dan JWT Authentication.
-- **Validasi Data**: Menggunakan Zod untuk validasi request yang kuat.
-
-## 📦 Instalasi & Penggunaan
-
-Buat project baru cukup dengan satu perintah:
-
-```bash
-npx lapeh-cli nama-project-anda
-```
-
-### Apa yang terjadi otomatis?
-
-1. Struktur project dibuat.
-2. Dependencies diinstall.
-3. Environment variable (`.env`) disiapkan.
-4. **JWT Secret** di-generate otomatis.
-
-Masuk ke folder project dan jalankan:
-
-```bash
-cd nama-project-anda
-npm run dev
-```
-
-Server akan berjalan di `http://localhost:4000`.
-
----
-
-## 🛠 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. 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
-
-# Deploy ke Production
-npm run prisma:deploy
-```
-
-> **Catatan:** Script `compile-schema.js` akan otomatis berjalan sebelum perintah prisma di atas dieksekusi.
-
-### 4. Generate JWT Secret
-
-Jika Anda perlu me-refresh secret key JWT:
-
-```bash
-npm run generate:jwt
-```
-
----
-
-## 📂 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      # Konfigurasi Datasource & Generator
-```
-
-## 📝 Lisensi
-
-MIT
+# Lapeh Framework
+
+**Lapeh** adalah framework berbasis Express.js yang terstandarisasi, dirancang untuk mempercepat pengembangan REST API dengan struktur yang solid, aman, dan scalable. Terinspirasi oleh struktur Laravel dan NestJS, namun tetap menjaga kesederhanaan Express.
+
+## 🚀 Fitur Utama
+
+- **Struktur Modular**: Terorganisir rapi dengan Controllers, Services, Routes, dan Middleware.
+- **TypeScript Ready**: Full TypeScript support untuk type-safety.
+- **Prisma ORM**: Integrasi database yang modern dan type-safe.
+- **Schema Terpisah**: Mendukung pemisahan schema Prisma per model (mirip Eloquent).
+- **Generator Tools**: CLI commands untuk generate Module dan Model dengan cepat.
+- **Security Best Practices**: Dilengkapi dengan Helmet, Rate Limiting, CORS, dan JWT Authentication.
+- **Validasi Data**: Menggunakan Zod untuk validasi request yang kuat.
+
+## 📦 Instalasi & Penggunaan
+
+Buat project baru cukup dengan satu perintah:
+
+```bash
+npx lapeh nama-project-anda
+```
+
+### Apa yang terjadi otomatis?
+
+1. Struktur project dibuat.
+2. Dependencies diinstall.
+3. Environment variable (`.env`) disiapkan.
+4. **JWT Secret** di-generate otomatis.
+
+Masuk ke folder project dan jalankan:
+
+```bash
+cd nama-project-anda
+npm run dev
+```
+
+Server akan berjalan di `http://localhost:4000`.
+
+---
+
+## 🛠 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. 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.
+
+### 4. Generate JWT Secret
+
+Jika Anda perlu me-refresh secret key JWT:
+
+```bash
+npm run generate:jwt
+```
+
+---
+
+## 📂 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      # Konfigurasi Datasource & Generator
+```
+
+## 📝 Lisensi
+
+MIT

package/scripts/generate-jwt-secret.js

@@ -1,38 +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);
-}
+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);
+}

package/scripts/init-project.js

@@ -0,0 +1,71 @@
+const fs = require("fs");
+const path = require("path");
+const { execSync } = require("child_process");
+
+const rootDir = path.join(__dirname, "..");
+const envExample = path.join(rootDir, ".env.example");
+const envFile = path.join(rootDir, ".env");
+
+console.log("🚀 Starting project initialization...");
+
+try {
+  // 1. Copy .env
+  if (!fs.existsSync(envFile)) {
+    console.log("📄 Copying .env.example to .env...");
+    fs.copyFileSync(envExample, envFile);
+  } else {
+    console.log("⚠️ .env already exists, skipping copy.");
+  }
+
+  // 2. Install dependencies
+  console.log("📦 Installing dependencies...");
+  execSync("npm install", { stdio: "inherit", cwd: rootDir });
+
+  // 3. Generate JWT Secret
+  console.log("🔑 Generating JWT Secret...");
+  execSync("node scripts/generate-jwt-secret.js", {
+    stdio: "inherit",
+    cwd: rootDir,
+  });
+
+  // 4. Setup Database (Migrate)
+  console.log("🗄️ Setting up database...");
+  // We skip the interactive prompt by providing a name if needed,
+  // or just let it run. However, if it prompts, the script might hang or fail if not interactive.
+  // 'prisma migrate dev' asks for name if there are changes.
+  // We try to run it. If it fails, we inform the user.
+  // We use npx to ensure we use the local binary.
+  try {
+        // We use the script defined in package.json but add --name init to avoid prompt for new migration
+        // However, if migrations already exist, --name might create a new one.
+        // If it's a fresh clone, 'prisma migrate dev' checks existing migrations.
+        // Let's just run the compile-schema first, then migrate.
+        execSync('node scripts/compile-schema.js', { stdio: 'inherit', cwd: rootDir });
+        
+        // Explicitly generate Prisma Client before migration to ensure it exists
+        console.log('⚙️ Generating Prisma Client...');
+        execSync('npx prisma generate', { stdio: 'inherit', cwd: rootDir });
+
+        execSync('npx prisma migrate dev --name init_setup', { stdio: 'inherit', cwd: rootDir });
+    } catch (error) {
+    console.warn(
+      '⚠️ Database migration had an issue. Please check your database connection in .env and run "npm run prisma:migrate" manually.'
+    );
+  }
+
+  // 5. Seed Database
+  console.log("🌱 Seeding database...");
+  try {
+    execSync("npm run db:seed", { stdio: "inherit", cwd: rootDir });
+  } catch (error) {
+    console.warn(
+      '⚠️ Database seeding had an issue. You might need to run "npm run db:seed" manually.'
+    );
+  }
+
+  console.log("\n✅ Setup complete! You can now run:");
+  console.log("   npm run dev");
+} catch (error) {
+  console.error("❌ Setup failed:", error.message);
+  process.exit(1);
+}

package/scripts/make-model.js

@@ -1,42 +1,42 @@
-const fs = require('fs');
-const path = require('path');
-
-const modelName = process.argv[2];
-
-if (!modelName) {
-  console.error('❌ Please specify the model name.');
-  console.error('   Usage: npm run make:model <ModelName>');
-  console.error('   Example: npm run make:model Product');
-  process.exit(1);
-}
-
-const PascalCaseName = modelName.charAt(0).toUpperCase() + modelName.slice(1);
-const tableName = modelName.toLowerCase() + 's'; // simple pluralization
-
-const modelsDir = path.join(__dirname, '..', 'src', 'models');
-const modelPath = path.join(modelsDir, `${PascalCaseName}.prisma`);
-
-if (fs.existsSync(modelPath)) {
-  console.error(`❌ Model ${PascalCaseName} already exists at ${modelPath}`);
-  process.exit(1);
-}
-
-// Ensure models directory exists
-if (!fs.existsSync(modelsDir)) {
-  fs.mkdirSync(modelsDir, { recursive: true });
-}
-
-const content = `model ${tableName} {
-  id        BigInt    @id @default(autoincrement())
-  name      String    @db.VarChar(255)
-  createdAt DateTime? @default(now()) @db.Timestamp(0)
-  updatedAt DateTime? @updatedAt @db.Timestamp(0)
-}
-`;
-
-fs.writeFileSync(modelPath, content);
-
-console.log(`✅ Model created: src/models/${PascalCaseName}.prisma`);
-console.log(`\nNext steps:`);
-console.log(`1. Edit the model file.`);
-console.log(`2. Run 'npm run prisma:migrate' to update the database.`);
+const fs = require('fs');
+const path = require('path');
+
+const modelName = process.argv[2];
+
+if (!modelName) {
+  console.error('❌ Please specify the model name.');
+  console.error('   Usage: npm run make:model <ModelName>');
+  console.error('   Example: npm run make:model Product');
+  process.exit(1);
+}
+
+const PascalCaseName = modelName.charAt(0).toUpperCase() + modelName.slice(1);
+const tableName = modelName.toLowerCase() + 's'; // simple pluralization
+
+const modelsDir = path.join(__dirname, '..', 'src', 'models');
+const modelPath = path.join(modelsDir, `${PascalCaseName}.prisma`);
+
+if (fs.existsSync(modelPath)) {
+  console.error(`❌ Model ${PascalCaseName} already exists at ${modelPath}`);
+  process.exit(1);
+}
+
+// Ensure models directory exists
+if (!fs.existsSync(modelsDir)) {
+  fs.mkdirSync(modelsDir, { recursive: true });
+}
+
+const content = `model ${tableName} {
+  id        BigInt    @id @default(autoincrement())
+  name      String    @db.VarChar(255)
+  createdAt DateTime? @default(now()) @db.Timestamp(0)
+  updatedAt DateTime? @updatedAt @db.Timestamp(0)
+}
+`;
+
+fs.writeFileSync(modelPath, content);
+
+console.log(`✅ Model created: src/models/${PascalCaseName}.prisma`);
+console.log(`\nNext steps:`);
+console.log(`1. Edit the model file.`);
+console.log(`2. Run 'npm run prisma:migrate' to update the database.`);