lapeh 1.0.1

package/prisma/seed.ts

@@ -0,0 +1,350 @@
+import { prisma } from "../src/prisma";
+import bcrypt from "bcryptjs";
+import { v4 as uuidv4 } from "uuid";
+import slugify from "slugify";
+
+async function main() {
+  console.log("Start seeding...");
+
+  // 1. Create Users (Super Admin, Admin & User)
+  const passwordHash = await bcrypt.hash("string", 10);
+
+  const superAdmin = await prisma.users.upsert({
+    where: { email: "sa@sa.com" },
+    update: {},
+    create: {
+      uuid: uuidv4(),
+      name: "Super Admin",
+      email: "sa@sa.com",
+      password: passwordHash,
+      created_at: new Date(),
+      updated_at: new Date(),
+    },
+  });
+  console.log(`Created super admin: ${superAdmin.name}`);
+
+  const admin = await prisma.users.upsert({
+    where: { email: "a@a.com" },
+    update: {},
+    create: {
+      uuid: uuidv4(),
+      name: "Admin User",
+      email: "a@a.com",
+      password: passwordHash,
+      created_at: new Date(),
+      updated_at: new Date(),
+    },
+  });
+  console.log(`Created admin: ${admin.name}`);
+
+  const user = await prisma.users.upsert({
+    where: { email: "u@u.com" },
+    update: {},
+    create: {
+      uuid: uuidv4(),
+      name: "Regular User",
+      email: "u@u.com",
+      password: passwordHash,
+      created_at: new Date(),
+      updated_at: new Date(),
+    },
+  });
+  console.log(`Created user: ${user.name}`);
+
+  // 2. Seed Roles
+  const superAdminRole = await prisma.roles.upsert({
+    where: { slug: "super_admin" },
+    update: {},
+    create: {
+      name: "Super Admin",
+      slug: "super_admin",
+      description: "Full access to all resources",
+      created_at: new Date(),
+      updated_at: new Date(),
+    },
+  });
+
+  const adminRole = await prisma.roles.upsert({
+    where: { slug: "admin" },
+    update: {},
+    create: {
+      name: "Admin",
+      slug: "admin",
+      description: "Administrator",
+      created_at: new Date(),
+      updated_at: new Date(),
+    },
+  });
+
+  const userRole = await prisma.roles.upsert({
+    where: { slug: "user" },
+    update: {},
+    create: {
+      name: "User",
+      slug: "user",
+      description: "Regular user",
+      created_at: new Date(),
+      updated_at: new Date(),
+    },
+  });
+
+  console.log("Seeded roles");
+
+  // 3. Seed Permissions
+  const manageUsers = await prisma.permissions.upsert({
+    where: { slug: "users.manage" },
+    update: {},
+    create: {
+      name: "Manage Users",
+      slug: "users.manage",
+      description: "Create, update, and delete users",
+      created_at: new Date(),
+      updated_at: new Date(),
+    },
+  });
+  const manageUsersCreate = await prisma.permissions.upsert({
+    where: { slug: "users.create" },
+    update: {},
+    create: {
+      name: "Create Users",
+      slug: "users.create",
+      description: "Create users",
+      created_at: new Date(),
+      updated_at: new Date(),
+    },
+  });
+  const manageUsersView = await prisma.permissions.upsert({
+    where: { slug: "users.view" },
+    update: {},
+    create: {
+      name: "View Users",
+      slug: "users.view",
+      description: "View users",
+      created_at: new Date(),
+      updated_at: new Date(),
+    },
+  });
+  const manageUsersUpdate = await prisma.permissions.upsert({
+    where: { slug: "users.update" },
+    update: {},
+    create: {
+      name: "Update Users",
+      slug: "users.update",
+      description: "Update users",
+      created_at: new Date(),
+      updated_at: new Date(),
+    },
+  });
+  const manageUsersDelete = await prisma.permissions.upsert({
+    where: { slug: "users.delete" },
+    update: {},
+    create: {
+      name: "Delete Users",
+      slug: "users.delete",
+      description: "Delete users",
+      created_at: new Date(),
+      updated_at: new Date(),
+    },
+  });
+
+  const manageRoles = await prisma.permissions.upsert({
+    where: { slug: "roles.manage" },
+    update: {},
+    create: {
+      name: "Manage Roles",
+      slug: "roles.manage",
+      description: "Create, update, and delete roles",
+      created_at: new Date(),
+      updated_at: new Date(),
+    },
+  });
+
+  const managePermissions = await prisma.permissions.upsert({
+    where: { slug: "permissions.manage" },
+    update: {},
+    create: {
+      name: "Manage Permissions",
+      slug: "permissions.manage",
+      description: "Create, update, and delete permissions",
+      created_at: new Date(),
+      updated_at: new Date(),
+    },
+  });
+
+  const manageProfiles = await prisma.permissions.upsert({
+    where: { slug: "profiles.manage" },
+    update: {},
+    create: {
+      name: "Manage Profiles",
+      slug: "profiles.manage",
+      description: "Manage user profiles",
+      created_at: new Date(),
+      updated_at: new Date(),
+    },
+  });
+
+  console.log("Seeded permissions");
+
+  // 4. Assign permissions to roles
+  const postsCreate = await prisma.permissions.upsert({
+    where: { slug: "posts.create" },
+    update: {},
+    create: {
+      name: "Create Posts",
+      slug: "posts.create",
+      description: "Create posts",
+      created_at: new Date(),
+      updated_at: new Date(),
+    },
+  });
+
+  const postsUpdate = await prisma.permissions.upsert({
+    where: { slug: "posts.update" },
+    update: {},
+    create: {
+      name: "Update Posts",
+      slug: "posts.update",
+      description: "Update posts",
+      created_at: new Date(),
+      updated_at: new Date(),
+    },
+  });
+
+  const postsDelete = await prisma.permissions.upsert({
+    where: { slug: "posts.delete" },
+    update: {},
+    create: {
+      name: "Delete Posts",
+      slug: "posts.delete",
+      description: "Delete posts",
+      created_at: new Date(),
+      updated_at: new Date(),
+    },
+  });
+
+  const postsView = await prisma.permissions.upsert({
+    where: { slug: "posts.view" },
+    update: {},
+    create: {
+      name: "View Posts",
+      slug: "posts.view",
+      description: "View posts",
+      created_at: new Date(),
+      updated_at: new Date(),
+    },
+  });
+
+  const categoriesManage = await prisma.permissions.upsert({
+    where: { slug: "categories.manage" },
+    update: {},
+    create: {
+      name: "Manage Categories",
+      slug: "categories.manage",
+      description: "Manage categories",
+      created_at: new Date(),
+      updated_at: new Date(),
+    },
+  });
+
+  const commentsManage = await prisma.permissions.upsert({
+    where: { slug: "comments.manage" },
+    update: {},
+    create: {
+      name: "Manage Comments",
+      slug: "comments.manage",
+      description: "Manage comments",
+      created_at: new Date(),
+      updated_at: new Date(),
+    },
+  });
+
+  console.log("Seeded resource permissions");
+
+  // 4. Assign permissions to roles
+  const rolePermPairs: { roleId: bigint; permId: bigint }[] = [
+    // super_admin gets all users permissions + other management permissions
+    { roleId: superAdminRole.id, permId: manageUsers.id },
+    { roleId: superAdminRole.id, permId: manageUsersCreate.id },
+    { roleId: superAdminRole.id, permId: manageUsersView.id },
+    { roleId: superAdminRole.id, permId: manageUsersUpdate.id },
+    { roleId: superAdminRole.id, permId: manageUsersDelete.id },
+    { roleId: superAdminRole.id, permId: manageRoles.id },
+    { roleId: superAdminRole.id, permId: managePermissions.id },
+    { roleId: superAdminRole.id, permId: manageProfiles.id },
+    { roleId: superAdminRole.id, permId: postsCreate.id },
+    { roleId: superAdminRole.id, permId: postsUpdate.id },
+    { roleId: superAdminRole.id, permId: postsDelete.id },
+    { roleId: superAdminRole.id, permId: postsView.id },
+    { roleId: superAdminRole.id, permId: categoriesManage.id },
+    { roleId: superAdminRole.id, permId: commentsManage.id },
+    // admin gets users permissions except delete
+    { roleId: adminRole.id, permId: manageUsersCreate.id },
+    { roleId: adminRole.id, permId: manageUsersView.id },
+    { roleId: adminRole.id, permId: manageUsersUpdate.id },
+    // admin gets other management permissions
+    { roleId: adminRole.id, permId: manageRoles.id },
+    { roleId: adminRole.id, permId: managePermissions.id },
+    { roleId: adminRole.id, permId: postsCreate.id },
+    { roleId: adminRole.id, permId: postsUpdate.id },
+    { roleId: adminRole.id, permId: postsDelete.id },
+    { roleId: adminRole.id, permId: postsView.id },
+    { roleId: adminRole.id, permId: categoriesManage.id },
+    { roleId: adminRole.id, permId: commentsManage.id },
+    // user gets read-only posts
+    { roleId: userRole.id, permId: postsView.id },
+  ];
+
+  for (const pair of rolePermPairs) {
+    await prisma.role_permissions.upsert({
+      where: {
+        role_id_permission_id: {
+          role_id: pair.roleId,
+          permission_id: pair.permId,
+        },
+      },
+      create: {
+        role_id: pair.roleId,
+        permission_id: pair.permId,
+        created_at: new Date(),
+      },
+      update: {},
+    });
+  }
+
+  console.log("Assigned permissions to roles");
+
+  // 5. Assign roles to users
+  const userRolePairs: { userId: bigint; roleId: bigint }[] = [
+    { userId: superAdmin.id, roleId: superAdminRole.id },
+    { userId: admin.id, roleId: adminRole.id },
+    { userId: user.id, roleId: userRole.id },
+  ];
+
+  for (const pair of userRolePairs) {
+    await prisma.user_roles.upsert({
+      where: {
+        user_id_role_id: {
+          user_id: pair.userId,
+          role_id: pair.roleId,
+        },
+      },
+      create: {
+        user_id: pair.userId,
+        role_id: pair.roleId,
+        created_at: new Date(),
+      },
+      update: {},
+    });
+  }
+
+  console.log("Assigned roles to users");
+}
+
+main()
+  .catch((e) => {
+    console.error(e);
+    process.exit(1);
+  })
+  .finally(async () => {
+    await prisma.$disconnect();
+  });

package/prisma.config.ts

@@ -0,0 +1,15 @@
+// This file was generated by Prisma, and assumes you have installed the following:
+// npm install --save-dev prisma dotenv
+import "dotenv/config";
+import { defineConfig, env } from "prisma/config";
+
+export default defineConfig({
+  schema: "prisma/schema.prisma",
+  migrations: {
+    path: "prisma/migrations",
+    seed: "ts-node prisma/seed.ts",
+  },
+  datasource: {
+    url: env("DATABASE_URL"),
+  },
+});

package/readme.md

@@ -0,0 +1,120 @@
+# 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

package/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');
+
+// 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/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);
+}

package/scripts/make-model.js

@@ -0,0 +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.`);