lapeh 2.2.7 → 2.2.9

package/api-testing-tujuhbelas/api-testing-enambelas/framework.md

@@ -0,0 +1,168 @@
+# Lapeh Framework
+
+## Quick Start
+
+Untuk memulai project ini (Setup awal):
+
+```bash
+npm i
+```
+
+```bash
+npm run first
+```
+
+Perintah di atas akan secara otomatis melakukan:
+
+1. Copy `.env.example` ke `.env`
+2. Install dependencies (`npm install`)
+3. Generate JWT Secret baru di `.env`
+4. Setup database (Migrate)
+5. Menjalankan Database Seeder
+
+Setelah selesai, Anda bisa langsung menjalankan project:
+
+```bash
+npm run dev
+```
+
+### Akun Default
+
+Jika seeder dijalankan (via `npm run first` atau `npm run db:seed`), gunakan akun berikut:
+
+- **Super Admin**: `sa@sa.com` / `string`
+- **Admin**: `a@a.com` / `string`
+- **User**: `u@u.com` / `string`
+
+## Code Standards & Best Practices (Baru)
+
+### 1. Import Path Aliases
+Gunakan alias `@/` untuk mengimpor module dari folder `src/`. Hindari relative path yang panjang seperti `../../utils/response`.
+
+**Contoh:**
+```typescript
+// ✅ Benar (Recommended)
+import { prisma } from "@/core/database";
+import { sendSuccess } from "@/utils/response";
+
+// ❌ Salah (Legacy)
+import { prisma } from "../core/database";
+import { sendSuccess } from "../../utils/response";
+```
+
+### 2. Strict Linting (Dead Code Elimination)
+Framework ini menerapkan aturan linter yang ketat untuk menjaga kebersihan kode. Variabel, parameter, atau import yang tidak digunakan akan menyebabkan error.
+
+- **Variabel tidak terpakai**: Hapus atau beri prefix `_` (underscore).
+  ```typescript
+  // ✅ Benar
+  const _unusedVariable = 123;
+  function example(_req: Request, res: Response) { ... }
+  
+  // ❌ Error
+  const unusedVariable = 123;
+  function example(req: Request, res: Response) { ... } // jika req tidak dipakai
+  ```
+
+### 3. High Performance Response (Fastify-Style)
+Untuk endpoint dengan throughput tinggi (GET lists, data besar), gunakan `sendFastSuccess` dengan JSON Schema serializer. Ini 2-3x lebih cepat dari `res.json` standar Express.
+
+**Langkah-langkah:**
+
+1. **Definisikan Schema** (sesuai field Prisma):
+   ```typescript
+   const userSchema = {
+     type: "object",
+     properties: {
+       id: { type: "string" }, // BigInt otomatis dicovert ke string
+       name: { type: "string" },
+       email: { type: "string" }
+     }
+   };
+   ```
+
+2. **Buat Serializer**:
+   ```typescript
+   import { getSerializer, createResponseSchema } from "@/core/serializer";
+   
+   const userSerializer = getSerializer("user-detail", createResponseSchema(userSchema));
+   ```
+
+3. **Gunakan di Controller**:
+   ```typescript
+   import { sendFastSuccess } from "@/utils/response";
+   
+   export async function getUser(req, res) {
+     const user = await prisma.user.findFirst();
+     sendFastSuccess(res, 200, userSerializer, {
+       status: "success",
+       message: "User found",
+       data: user
+     });
+   }
+   ```
+
+## Database Workflow (Prisma)
+
+Framework ini menggunakan **Prisma ORM** dengan struktur schema yang modular (dipecah per file). Berikut adalah panduan lengkap dari Development hingga Deployment.
+
+### 1. Development (Lokal)
+
+Saat mengembangkan aplikasi di local environment:
+
+**a. Mengupdate Schema Database**
+Jika Anda mengubah file schema di `src/models/*.prisma` atau konfigurasi di `prisma/base.prisma.template`:
+
+```bash
+npm run prisma:migrate
+```
+
+_Perintah ini akan menggabungkan semua file schema, membuat file migrasi baru, menerapkan ke database lokal, dan men-generate ulang Prisma Client._
+
+**b. Melihat/Edit Data (GUI)**
+Untuk membuka dashboard visual database:
+
+```bash
+npm run db:studio
+```
+
+**c. Mengisi Data Awal (Seeding)**
+Jika Anda butuh data dummy atau data awal (seperti roles/permissions):
+
+```bash
+npm run db:seed
+```
+
+**d. Reset Database Total**
+Jika database berantakan dan ingin mengulang dari awal (HATI-HATI: Menghapus semua data):
+
+```bash
+npm run db:reset
+```
+
+_Perintah ini akan menghapus database, membuat ulang schema dari awal, dan otomatis menjalankan seeder._
+
+---
+
+### 2. Deployment (Production)
+
+Saat deploy ke server production:
+
+**a. Setup Awal**
+Pastikan `.env` di production sudah disetup dengan benar (DATABASE_URL, dll).
+
+**b. Menerapkan Migrasi**
+Jangan gunakan `migrate dev` di production. Gunakan perintah ini:
+
+```bash
+npm run prisma:deploy
+```
+
+_Perintah ini hanya akan menerapkan file migrasi yang sudah ada ke database production tanpa mereset data atau meminta konfirmasi interaktif._
+
+**c. Generate Client (Opsional)**
+Biasanya dilakukan otomatis saat `npm install` (karena `postinstall`), tapi jika perlu manual:
+
+```bash
+npm run prisma:generate
+```

package/api-testing-tujuhbelas/api-testing-enambelas/nodemon.json

@@ -0,0 +1,6 @@
+{
+  "watch": ["src", ".env"],
+  "ext": "ts,json",
+  "ignore": ["src/**/*.test.ts"],
+  "exec": "ts-node -r tsconfig-paths/register src/index.ts"
+}

package/api-testing-tujuhbelas/api-testing-enambelas/package.json

@@ -0,0 +1,106 @@
+{
+  "name": "api-testing-enambelas",
+  "version": "1.0.0",
+  "description": "Generated by lapeh",
+  "main": "index.js",
+  "homepage": "https://github.com/robyajo/lapeh#readme",
+  "bugs": {
+    "url": "https://github.com/robyajo/lapeh/issues"
+  },
+  "types": "dist/src/index.d.ts",
+  "scripts": {
+    "dev": "lapeh dev",
+    "first": "node scripts/init-project.js",
+    "prebuild": "npm run prisma:generate",
+    "build": "lapeh build",
+    "prestart": "npm run prisma:generate",
+    "start": "lapeh start",
+    "prestart:prod": "npm run prisma:generate",
+    "start:prod": "lapeh start",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "prisma:generate": "node scripts/compile-schema.js && prisma generate",
+    "prisma:migrate": "node scripts/compile-schema.js && prisma migrate dev",
+    "prisma:deploy": "node scripts/compile-schema.js && prisma migrate deploy",
+    "db:seed": "prisma db seed",
+    "db:reset": "prisma migrate reset",
+    "db:rs": "prisma migrate reset --force && prisma db seed",
+    "db:studio": "prisma studio",
+    "generate:jwt": "node scripts/generate-jwt-secret.js",
+    "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",
+    "postinstall": "node scripts/compile-schema.js && prisma generate"
+  },
+  "keywords": [
+    "nodejs-framework",
+    "typescript-framework",
+    "express-framework",
+    "backend-framework",
+    "rest-api",
+    "prisma-orm",
+    "production-ready",
+    "api-generator",
+    "boilerplate",
+    "starter-kit",
+    "mvc",
+    "cli",
+    "lapeh",
+    "roby-ajo",
+    "ajo-roby",
+    "roby-karti-s",
+    "lapeh"
+  ],
+  "author": "Roby Karti S <robyfull.dev@gmail.com>",
+  "license": "MIT",
+  "type": "commonjs",
+  "dependencies": {
+    "@prisma/adapter-mariadb": "7.2.0",
+    "@prisma/adapter-pg": "7.2.0",
+    "@prisma/client": "7.2.0",
+    "bcryptjs": "3.0.3",
+    "compression": "^1.8.1",
+    "cors": "2.8.5",
+    "dotenv": "17.2.3",
+    "express": "5.2.1",
+    "express-rate-limit": "8.2.1",
+    "fast-json-stringify": "^6.1.1",
+    "helmet": "8.1.0",
+    "ioredis": "5.8.2",
+    "ioredis-mock": "^8.13.1",
+    "jsonwebtoken": "9.0.3",
+    "multer": "2.0.2",
+    "pg": "8.16.3",
+    "slugify": "1.6.6",
+    "socket.io": "4.8.3",
+    "ts-node": "^10.9.2",
+    "tsconfig-paths": "^4.2.0",
+    "typescript": "^5.9.3",
+    "uuid": "13.0.0",
+    "winston": "^3.19.0",
+    "winston-daily-rotate-file": "^5.0.0",
+    "zod": "3.23.8",
+    "prisma": "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",
+    "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",
+    "@types/express": "^5.0.0",
+    "@types/compression": "^1.7.5"
+  }
+}

package/api-testing-tujuhbelas/api-testing-enambelas/prisma/base.prisma.template

@@ -0,0 +1,7 @@
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "postgresql"
+}

package/api-testing-tujuhbelas/api-testing-enambelas/prisma/schema.prisma

@@ -0,0 +1,183 @@
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "postgresql"
+}
+
+
+model cache {
+  key        String @id
+  value      String
+  expiration Int
+}
+
+model cache_locks {
+  key        String @id
+  owner      String
+  expiration Int
+}
+
+model failed_jobs {
+  id         BigInt   @id @default(autoincrement())
+  uuid       String   @unique
+  connection String
+  queue      String
+  payload    String
+  exception  String
+  failed_at  DateTime @default(now())
+}
+
+model job_batches {
+  id             String @id
+  name           String
+  total_jobs     Int
+  pending_jobs   Int
+  failed_jobs    Int
+  failed_job_ids String
+  options        String?
+  cancelled_at   Int?
+  created_at     Int
+  finished_at    Int?
+}
+
+model jobs {
+  id           BigInt @id @default(autoincrement())
+  queue        String
+  payload      String
+  attempts     Int
+  reserved_at  Int?
+  available_at Int
+  created_at   Int
+
+  @@index([queue])
+}
+
+model migrations {
+  id        Int    @id @default(autoincrement())
+  migration String
+  batch     Int
+}
+
+model password_reset_tokens {
+  email      String    @id
+  token      String
+  created_at DateTime?
+}
+
+model personal_access_tokens {
+  id             BigInt    @id @default(autoincrement())
+  tokenable_type String
+  tokenable_id   BigInt
+  name           String
+  token          String    @unique
+  abilities      String?
+  last_used_at   DateTime?
+  expires_at     DateTime?
+  created_at     DateTime?
+  updated_at     DateTime?
+
+  @@index([expires_at])
+  @@index([tokenable_type, tokenable_id])
+}
+
+model sessions {
+  id            String  @id
+  user_id       BigInt?
+  ip_address    String?
+  user_agent    String?
+  payload       String
+  last_activity Int
+
+  @@index([last_activity])
+  @@index([user_id])
+}
+
+model users {
+  id                BigInt    @id @default(autoincrement())
+  uuid              String    @unique
+  name              String
+  email             String    @unique
+  avatar            String?
+  avatar_url        String?
+  email_verified_at DateTime?
+  password          String
+  remember_token    String?
+  created_at        DateTime?
+  updated_at        DateTime?
+
+  user_roles       user_roles[]
+  user_permissions user_permissions[]
+}
+
+model roles {
+  id          BigInt    @id @default(autoincrement())
+  name        String
+  slug        String    @unique
+  description String?
+  created_at  DateTime?
+  updated_at  DateTime?
+
+  user_roles       user_roles[]
+  role_permissions role_permissions[]
+}
+
+model permissions {
+  id          BigInt    @id @default(autoincrement())
+  name        String
+  slug        String    @unique
+  description String?
+  created_at  DateTime?
+  updated_at  DateTime?
+
+  role_permissions role_permissions[]
+  user_permissions user_permissions[]
+}
+
+model user_roles {
+  id         BigInt    @id @default(autoincrement())
+  user_id    BigInt
+  role_id    BigInt
+  created_at DateTime?
+
+  user users @relation(fields: [user_id], references: [id], onDelete: Cascade, onUpdate: NoAction)
+  role roles @relation(fields: [role_id], references: [id], onDelete: Cascade, onUpdate: NoAction)
+
+  @@unique([user_id, role_id])
+}
+
+model role_permissions {
+  id            BigInt    @id @default(autoincrement())
+  role_id       BigInt
+  permission_id BigInt
+  created_at    DateTime?
+
+  role       roles       @relation(fields: [role_id], references: [id], onDelete: Cascade, onUpdate: NoAction)
+  permission permissions @relation(fields: [permission_id], references: [id], onDelete: Cascade, onUpdate: NoAction)
+
+  @@unique([role_id, permission_id])
+}
+
+model user_permissions {
+  id            BigInt    @id @default(autoincrement())
+  user_id       BigInt
+  permission_id BigInt
+  created_at    DateTime?
+
+  user       users       @relation(fields: [user_id], references: [id], onDelete: Cascade, onUpdate: NoAction)
+  permission permissions @relation(fields: [permission_id], references: [id], onDelete: Cascade, onUpdate: NoAction)
+
+  @@unique([user_id, permission_id])
+}
+
+
+
+model pets {
+  id         BigInt    @id @default(autoincrement())
+  name       String
+  species    String
+  age        Int
+  created_at DateTime?
+  updated_at DateTime?
+}