lapeh 2.4.7 → 2.4.9

package/bin/index.js

@@ -231,7 +231,7 @@ function runBuild() {
 
   // Compile TS
   try {
-      execSync('npx tsc && npx tsc-alias', { stdio: 'inherit' });
+      execSync('npx tsc -p tsconfig.build.json && npx tsc-alias -p tsconfig.build.json', { stdio: 'inherit' });
   } catch (e) {
       console.error('❌ Build failed.');
       process.exit(1);
@@ -255,7 +255,7 @@ async function upgradeProject() {
 
   // Files/Folders to overwrite/copy
   const filesToSync = [
-    'bin', // Ensure CLI script is updated
+    // 'bin', // Removed: CLI script is managed by package
     'lib', // Ensure core framework files are updated
     'scripts',
     'docker-compose.yml',
@@ -268,7 +268,47 @@ async function upgradeProject() {
     'src/prisma.ts', // Core framework file
   ];
 
-  // Helper to copy recursive
+  // Helper to sync directory (copy new/updated, delete removed)
+  function syncDirectory(src, dest) {
+    if (!fs.existsSync(src)) return;
+    
+    // Ensure dest exists
+    if (!fs.existsSync(dest)) {
+      fs.mkdirSync(dest, { recursive: true });
+    }
+
+    // 1. Copy/Update files from src to dest
+    const srcEntries = fs.readdirSync(src, { withFileTypes: true });
+    const srcEntryNames = new Set();
+
+    for (const entry of srcEntries) {
+      srcEntryNames.add(entry.name);
+      const srcPath = path.join(src, entry.name);
+      const destPath = path.join(dest, entry.name);
+
+      if (entry.isDirectory()) {
+        syncDirectory(srcPath, destPath);
+      } else {
+        fs.copyFileSync(srcPath, destPath);
+      }
+    }
+
+    // 2. Delete files in dest that are not in src (only if we are syncing a folder)
+    const destEntries = fs.readdirSync(dest, { withFileTypes: true });
+    for (const entry of destEntries) {
+        if (!srcEntryNames.has(entry.name)) {
+            const destPath = path.join(dest, entry.name);
+            console.log(`🗑️  Removing obsolete file/directory: ${destPath}`);
+            if (entry.isDirectory()) {
+                fs.rmSync(destPath, { recursive: true, force: true });
+            } else {
+                fs.unlinkSync(destPath);
+            }
+        }
+    }
+  }
+
+  // Helper to copy recursive (legacy, kept for other uses if any, but replaced by syncDirectory for upgrade)
   function copyRecursive(src, dest) {
     if (!fs.existsSync(src)) return;
     const stats = fs.statSync(src);
@@ -309,8 +349,17 @@ async function upgradeProject() {
     const destPath = path.join(currentDir, item);
     
     if (fs.existsSync(srcPath)) {
-      console.log(`🔄 Updating ${item}...`);
-      copyRecursive(srcPath, destPath);
+      const stats = fs.statSync(srcPath);
+      if (stats.isDirectory()) {
+          console.log(`🔄 Syncing directory ${item}...`);
+          syncDirectory(srcPath, destPath);
+      } else {
+          console.log(`🔄 Updating file ${item}...`);
+          // Ensure dir exists
+          const destDir = path.dirname(destPath);
+          if (!fs.existsSync(destDir)) fs.mkdirSync(destDir, { recursive: true });
+          fs.copyFileSync(srcPath, destPath);
+      }
     }
   }
 

package/dist/lib/bootstrap.d.ts

@@ -1,2 +1,3 @@
+export declare function createApp(): Promise<import("express-serve-static-core").Express>;
 export declare function bootstrap(): Promise<void>;
 //# sourceMappingURL=bootstrap.d.ts.map

package/dist/lib/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../lib/bootstrap.ts"],"names":[],"mappings":"AAmBA,wBAAsB,SAAS,kBAmI9B"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../lib/bootstrap.ts"],"names":[],"mappings":"AAmBA,wBAAsB,SAAS,yDAyG9B;AAED,wBAAsB,SAAS,kBAwD9B"}

package/dist/lib/bootstrap.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.createApp = createApp;
 exports.bootstrap = bootstrap;
 const dotenv_1 = __importDefault(require("dotenv"));
 dotenv_1.default.config();
@@ -21,18 +22,11 @@ const error_1 = require("./middleware/error");
 const rateLimit_1 = require("./middleware/rateLimit");
 const requestLogger_1 = require("./middleware/requestLogger");
 const response_1 = require("./utils/response");
-async function bootstrap() {
+async function createApp() {
     // Register aliases for production runtime
     // Since user code (compiled JS) uses require('@lapeh/...')
     // We map '@lapeh' to the directory containing this file (lib/ or dist/lib/)
     module_alias_1.default.addAlias("@lapeh", __dirname);
-    // Validasi Environment Variables
-    const requiredEnvs = ["DATABASE_URL", "JWT_SECRET"];
-    const missingEnvs = requiredEnvs.filter((key) => !process.env[key]);
-    if (missingEnvs.length > 0) {
-        console.error(`❌ Missing required environment variables: ${missingEnvs.join(", ")}`);
-        process.exit(1);
-    }
     const app = (0, express_1.default)();
     app.disable("x-powered-by");
     app.use((0, compression_1.default)());
@@ -76,15 +70,48 @@ async function bootstrap() {
             ? path_1.default.join(process.cwd(), "dist", "src", "routes")
             : path_1.default.join(process.cwd(), "src", "routes");
         // Gunakan require agar sinkron dan mudah dicatch
-        const { apiRouter } = require(userRoutesPath);
-        app.use("/api", apiRouter);
-        console.log(`✅ User routes loaded successfully from ${isProduction ? "dist/" : ""}src/routes`);
+        // Check if file exists before requiring to avoid crash in tests/clean env
+        try {
+            // In test environment, we might need to point to src/routes explicitly if not compiled
+            // const routesPath = process.env.NODE_ENV === 'test'
+            //    ? path.join(process.cwd(), "src", "routes", "index.ts")
+            //    : userRoutesPath;
+            // Note: For TS files in jest, we rely on ts-jest handling 'require' if it points to .ts or we need to use 'import'
+            // But 'require' in jest with ts-jest should work if configured.
+            // However, require(path) with .ts extension might be tricky.
+            // Let's stick to userRoutesPath but maybe adjust for test env.
+            // Check if we are in test environment and using ts-jest
+            // If so, we might need to import the TS file directly via relative path if alias is not working for require
+            const { apiRouter } = require(userRoutesPath);
+            app.use("/api", apiRouter);
+            console.log(`✅ User routes loaded successfully from ${isProduction ? "dist/" : ""}src/routes`);
+        }
+        catch (e) {
+            // If it's just missing module, maybe we are in test mode or fresh install
+            if (process.env.NODE_ENV !== "test") {
+                console.warn(`⚠️  Could not load user routes from ${userRoutesPath}. (This is expected during initial setup or if src/routes is missing)`);
+            }
+            else {
+                // In test mode, we really want to know if it failed to load
+                console.error(`Error loading routes in test mode from ${userRoutesPath}:`, e);
+            }
+        }
     }
     catch (error) {
-        console.warn("⚠️  Could not load user routes. Make sure you export 'apiRouter'.");
         console.error(error);
     }
     app.use(error_1.errorHandler);
+    return app;
+}
+async function bootstrap() {
+    // Validasi Environment Variables
+    const requiredEnvs = ["DATABASE_URL", "JWT_SECRET"];
+    const missingEnvs = requiredEnvs.filter((key) => !process.env[key]);
+    if (missingEnvs.length > 0) {
+        console.error(`❌ Missing required environment variables: ${missingEnvs.join(", ")}`);
+        process.exit(1);
+    }
+    const app = await createApp();
     const port = process.env.PORT ? Number(process.env.PORT) : 4000;
     const server = http_1.default.createServer(app);
     (0, realtime_1.initRealtime)(server);

package/dist/lib/utils/validator.d.ts

@@ -10,11 +10,11 @@ export declare class Validator {
     /**
      * Create a new Validator instance
      * @param data The input data to validate
-     * @param schema Zod schema or object of Zod schemas / Laravel-style rules
-     * @param messages Optional custom error messages (Laravel style: 'field.rule' => 'message')
+     * @param schema Zod schema or object of Zod schemas / string-based rules
+     * @param messages Optional custom error messages (style: 'field.rule' => 'message')
      */
     static make(data: any, schema: ZodSchema<any> | Record<string, any>, messages?: Record<string, string>): Validator;
-    private static parseLaravelRule;
+    private static parseStringRule;
     /**
      * Check if validation fails
      */

package/dist/lib/utils/validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../lib/utils/validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,SAAS,EAAsB,MAAM,KAAK,CAAC;AAGvD,qBAAa,SAAS;IACpB,OAAO,CAAC,IAAI,CAAM;IAClB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,MAAM,CAAkB;gBAG9B,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5C,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;IAavC;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CACT,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5C,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;IAiDvC,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAyN/B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAK/B;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAIhC;;OAEG;IACH,MAAM;IAKN;;OAEG;IACG,SAAS;YAUD,GAAG;IAgBjB,OAAO,CAAC,YAAY;IAuBpB,OAAO,CAAC,gBAAgB;CAoDzB"}
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../lib/utils/validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,SAAS,EAAsB,MAAM,KAAK,CAAC;AAGvD,qBAAa,SAAS;IACpB,OAAO,CAAC,IAAI,CAAM;IAClB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,MAAM,CAAkB;gBAG9B,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5C,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;IAavC;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CACT,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5C,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;IAiDvC,OAAO,CAAC,MAAM,CAAC,eAAe;IAyN9B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAK/B;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAIhC;;OAEG;IACH,MAAM;IAKN;;OAEG;IACG,SAAS;YAUD,GAAG;IAgBjB,OAAO,CAAC,YAAY;IAuBpB,OAAO,CAAC,gBAAgB;CAoDzB"}

package/dist/lib/utils/validator.js

@@ -21,8 +21,8 @@ class Validator {
     /**
      * Create a new Validator instance
      * @param data The input data to validate
-     * @param schema Zod schema or object of Zod schemas / Laravel-style rules
-     * @param messages Optional custom error messages (Laravel style: 'field.rule' => 'message')
+     * @param schema Zod schema or object of Zod schemas / string-based rules
+     * @param messages Optional custom error messages (style: 'field.rule' => 'message')
      */
     static make(data, schema, messages = {}) {
         if (schema instanceof zod_1.ZodSchema) {
@@ -44,7 +44,7 @@ class Validator {
                         sameRules.push({ field: key, target: args });
                     }
                 }
-                parsedSchema[key] = Validator.parseLaravelRule(rule);
+                parsedSchema[key] = Validator.parseStringRule(rule);
             }
             else {
                 parsedSchema[key] = rule;
@@ -66,7 +66,7 @@ class Validator {
         }
         return new Validator(data, objectSchema, messages);
     }
-    static parseLaravelRule(rule) {
+    static parseStringRule(rule) {
         const rules = Array.isArray(rule)
             ? rule
             : rule.split("|").map((r) => r.trim());

package/dist/src/controllers/authController.js

@@ -107,7 +107,7 @@ async function register(req, res) {
             },
         });
     }
-    (0, response_1.sendFastSuccess)(res, 200, registerSerializer, {
+    (0, response_1.sendFastSuccess)(res, 201, registerSerializer, {
         status: "success",
         message: "Registration successful",
         data: {

package/doc/en/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 File ini mencatat semua perubahan, pembaruan, dan perbaikan yang dilakukan pada framework Lapeh, diurutkan berdasarkan tanggal.
 
+## [2025-12-28] - Sunday, December 28, 2025 - Upgrade & Testing Improvements (v2.4.9)
+
+### 🚀 Features & Fixes
+
+- **Smart Upgrade CLI**:
+
+  - Updated `npx lapeh upgrade` to perform full synchronization (mirroring).
+  - Files removed in the latest framework version are now automatically removed from user projects, keeping them clean.
+  - Removed `bin` folder from synchronization as it is managed by the package.
+
+- **Comprehensive Testing Support**:
+  - Updated `tsconfig.json` to support `@lapeh/*` path aliases within the `tests` folder.
+  - The `tests` folder is now excluded from production builds (via `tsconfig.build.json`), resulting in a cleaner `dist/` folder.
+  - Jest documentation and configuration have been adjusted for seamless integration.
+
 ## [2025-12-28] - Minggu, 28 Desember 2025 - Perbaikan Kompatibilitas & Automasi
 
 ### 🛠️ Perbaikan Bug (Bug Fixes)
@@ -61,8 +76,8 @@ File ini mencatat semua perubahan, pembaruan, dan perbaikan yang dilakukan pada
 
 ### 🚀 Fitur Baru
 
-- **Laravel-style Validator**:
-  - Implementasi utility `Validator` baru di `src/utils/validator.ts` yang meniru gaya validasi Laravel.
+- **Expressive Validator**:
+  - Implementasi utility `Validator` baru di `src/utils/validator.ts` dengan gaya validasi yang lebih ekspresif.
   - Mendukung rule string seperti `required|string|min:3|email`.
   - Penambahan rule `unique` untuk pengecekan database otomatis (Prisma).
   - Penambahan rule `mimes`, `image`, `max` (file size) untuk validasi upload file.

package/doc/en/CHEATSHEET.md

@@ -18,7 +18,7 @@ Referensi cepat untuk perintah dan kode yang sering digunakan.
 | **`npm run db:seed`**                | Isi data dummy.                              |
 | **`npm run db:reset`**               | Hapus DB & mulai dari nol.                   |
 
-## 🛡️ Validator Rules (Laravel-Style)
+## 🛡️ Validator Rules (Simple Syntax)
 
 Gunakan di `Validator.make(data, rules)`.
 

package/doc/en/FEATURES.md

@@ -2,9 +2,9 @@
 
 This document explains the key features of Lapeh Framework and how to use them in depth.
 
-## 1. Data Validation (Laravel-Style)
+## 1. Data Validation (Simple & Powerful)
 
-The framework provides a `Validator` utility inspired by Laravel, using `zod` behind the scenes but with an API that is more string-based and readable.
+The framework provides a `Validator` utility inspired by expressive modern validation styles, using `zod` behind the scenes but with an API that is more string-based and readable.
 
 **Location:** `@lapeh/utils/validator`
 
@@ -42,7 +42,7 @@ export async function createProduct(req: Request, res: Response) {
 - `image`: File must be an image (jpg, png, webp, etc).
 - `mimes:types`: File must be a specific type (e.g., `mimes:pdf,docx`).
 
-## 2. High Performance Response (Fastify-Style)
+## 2. High Performance Response (Fastify-Like)
 
 For endpoints requiring high performance (e.g., large data lists), use schema-based serialization. This is much faster than standard Express `res.json`.
 

package/doc/en/INTRODUCTION.md

@@ -4,33 +4,35 @@
 
 **Lapeh** is a Backend Framework for Node.js built on top of **Express** and **TypeScript**.
 
-If you have ever used **Laravel** (PHP) or **NestJS** (Node.js), you will feel very familiar. Lapeh adopts the philosophy of ease-of-use & clean structure from Laravel, while maintaining the flexibility and speed of Express.
+If you have ever used other modern frameworks, you will feel very familiar. Lapeh adopts the philosophy of ease-of-use & clean structure, while maintaining the flexibility and speed of Express.
 
 The name "Lapeh" comes from the Minang language which means "Loose" or "Free", symbolizing the freedom for developers to build applications quickly without being burdened by complicated configurations.
 
 ## Why was Lapeh Created?
 
 In the Node.js ecosystem, developers often experience "Decision Fatigue":
+
 - "Which ORM to use? Prisma, TypeORM, or Drizzle?"
 - "Validation using Joi, Zod, or express-validator?"
 - "How about the folder structure? MVC? Clean Architecture?"
 - "How to handle Auth?"
 
 Lapeh answers all of that with **Opinionated Defaults**:
+
 1.  **ORM**: Prisma (Current industry standard).
-2.  **Validation**: Zod (with Laravel-style wrapper syntax).
+2.  **Validation**: Zod (Powerful and readable schema validation).
 3.  **Structure**: Modular MVC (Controller, Model, Route separated but cohesive).
 4.  **Auth**: Ready-to-use JWT + RBAC (Role Based Access Control).
 
 ## Comparison with Other Frameworks
 
-| Feature | Express (Raw) | NestJS | Lapeh Framework |
-| :--- | :--- | :--- | :--- |
+| Feature            | Express (Raw)                 | NestJS                           | Lapeh Framework                        |
+| :----------------- | :---------------------------- | :------------------------------- | :------------------------------------- |
 | **Learning Curve** | Low (but confusing structure) | High (Angular-style, Decorators) | **Medium** (Express + Clear Structure) |
-| **Boilerplate** | Empty | Very Heavy | **Just Right (Ready to use)** |
-| **Type Safety** | Manual | Strict | **Strict (Native TypeScript)** |
-| **Dev Speed** | Slow (manual setup) | Medium | **Fast (CLI Generator)** |
-| **Flexibility** | Very High | Rigid | **High** |
+| **Boilerplate**    | Empty                         | Very Heavy                       | **Just Right (Ready to use)**          |
+| **Type Safety**    | Manual                        | Strict                           | **Strict (Native TypeScript)**         |
+| **Dev Speed**      | Slow (manual setup)           | Medium                           | **Fast (CLI Generator)**               |
+| **Flexibility**    | Very High                     | Rigid                            | **High**                               |
 
 ## "The Lapeh Way" Philosophy
 

package/doc/en/STRUCTURE.md

@@ -67,7 +67,7 @@ Built-in framework middleware.
 
 Built-in Helper functions.
 
-- `validator.ts`: Laravel-style input validation.
+- `validator.ts`: Powerful and expressive input validation.
 - `response.ts`: Standard JSON response format (`sendFastSuccess`, `sendError`).
 - `logger.ts`: Logging system (Winston).
 

package/doc/id/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 File ini mencatat semua perubahan, pembaruan, dan perbaikan yang dilakukan pada framework Lapeh, diurutkan berdasarkan tanggal.
 
+## [2025-12-28] - Minggu, 28 Desember 2025 - Perbaikan Upgrade & Testing (v2.4.9)
+
+### 🚀 Fitur & Perbaikan
+
+- **Smart Upgrade CLI**:
+
+  - Memperbarui perintah `npx lapeh upgrade` agar melakukan sinkronisasi penuh (mirroring).
+  - File yang dihapus di versi terbaru framework sekarang akan otomatis dihapus juga dari proyek pengguna, menjaga proyek tetap bersih.
+  - Menghapus folder `bin` dari proses sinkronisasi ke proyek pengguna karena folder tersebut dikelola oleh paket.
+
+- **Dukungan Testing Komprehensif**:
+  - Konfigurasi `tsconfig.json` diperbarui untuk mendukung path alias `@lapeh/*` di dalam folder `tests`.
+  - Folder `tests` sekarang dikecualikan dari proses build produksi (via `tsconfig.build.json`), menghasilkan folder `dist/` yang lebih bersih.
+  - Dokumentasi dan konfigurasi Jest telah disesuaikan untuk integrasi yang mulus.
+
 ## [2025-12-28] - Minggu, 28 Desember 2025 - Perbaikan Kompatibilitas & Automasi
 
 ### 🛠️ Perbaikan Bug (Bug Fixes)
@@ -61,8 +76,8 @@ File ini mencatat semua perubahan, pembaruan, dan perbaikan yang dilakukan pada
 
 ### 🚀 Fitur Baru
 
-- **Laravel-style Validator**:
-  - Implementasi utility `Validator` baru di `src/utils/validator.ts` yang meniru gaya validasi Laravel.
+- **Expressive Validator**:
+  - Implementasi utility `Validator` baru di `src/utils/validator.ts` dengan gaya validasi yang lebih ekspresif.
   - Mendukung rule string seperti `required|string|min:3|email`.
   - Penambahan rule `unique` untuk pengecekan database otomatis (Prisma).
   - Penambahan rule `mimes`, `image`, `max` (file size) untuk validasi upload file.

package/doc/id/CHEATSHEET.md

@@ -18,7 +18,7 @@ Referensi cepat untuk perintah dan kode yang sering digunakan.
 | **`npm run db:seed`**                | Isi data dummy.                              |
 | **`npm run db:reset`**               | Hapus DB & mulai dari nol.                   |
 
-## 🛡️ Validator Rules (Laravel-Style)
+## 🛡️ Validator Rules (Simple Syntax)
 
 Gunakan di `Validator.make(data, rules)`.
 

package/doc/id/FEATURES.md

@@ -2,9 +2,11 @@
 
 Dokumen ini menjelaskan fitur-fitur utama Lapeh Framework dan cara penggunaannya secara mendalam.
 
-## 1. Validasi Data (Laravel-Style)
+3. **Explicit is Better than Implicit**: Tidak ada "sihir" yang terlalu gelap. Kode controller Anda adalah kode Express biasa yang Anda mengerti.
 
-Framework ini menyediakan utility `Validator` yang terinspirasi dari Laravel, menggunakan `zod` di belakang layar namun dengan API yang lebih string-based dan mudah dibaca.
+## 1. Validasi Data (Simple & Powerful)
+
+Framework ini menyediakan utility `Validator` yang terinspirasi dari gaya validasi modern yang ekspresif, menggunakan `zod` di belakang layar namun dengan API yang lebih string-based dan mudah dibaca.
 
 **Lokasi:** `@lapeh/utils/validator`
 
@@ -42,7 +44,7 @@ export async function createProduct(req: Request, res: Response) {
 - `image`: File harus berupa gambar (jpg, png, webp, dll).
 - `mimes:types`: File harus tipe tertentu (misal: `mimes:pdf,docx`).
 
-## 2. High Performance Response (Fastify-Style)
+## 2. High Performance Response (Fastify-Like)
 
 Untuk endpoint yang membutuhkan performa tinggi (misalnya list data besar), gunakan serialisasi berbasis schema. Ini jauh lebih cepat daripada `res.json` standar Express.
 

package/doc/id/INTRODUCTION.md

@@ -4,33 +4,35 @@
 
 **Lapeh** adalah framework Backend untuk Node.js yang dibangun di atas **Express** dan **TypeScript**.
 
-Jika Anda pernah menggunakan **Laravel** (PHP) atau **NestJS** (Node.js), Anda akan merasa sangat familiar. Lapeh mengambil filosofi kemudahan & struktur rapi dari Laravel, namun tetap mempertahankan fleksibilitas dan kecepatan Express.
+Jika Anda pernah menggunakan framework modern lainnya, Anda akan merasa sangat familiar. Lapeh mengambil filosofi kemudahan & struktur rapi, namun tetap mempertahankan fleksibilitas dan kecepatan Express.
 
 Nama "Lapeh" diambil dari bahasa Minang yang berarti "Lepas" atau "Bebas", melambangkan kebebasan developer untuk membangun aplikasi dengan cepat tanpa terbebani konfigurasi yang rumit.
 
 ## Mengapa Lapeh Dibuat?
 
 Di ekosistem Node.js, developer sering mengalami "Decision Fatigue" (Kelelahan memilih):
+
 - "Pakai ORM apa? Prisma, TypeORM, atau Drizzle?"
 - "Validasi pakai Joi, Zod, atau express-validator?"
 - "Struktur foldernya gimana? MVC? Clean Architecture?"
 - "Auth-nya gimana?"
 
 Lapeh menjawab semua itu dengan **Opinionated Defaults**:
+
 1.  **ORM**: Prisma (Standar industri saat ini).
-2.  **Validasi**: Zod (dengan wrapper syntax ala Laravel).
+2.  **Validasi**: Zod (Validasi skema yang kuat dan mudah dibaca).
 3.  **Struktur**: MVC Modular (Controller, Model, Route terpisah tapi kohesif).
 4.  **Auth**: JWT + RBAC (Role Based Access Control) siap pakai.
 
 ## Perbandingan dengan Framework Lain
 
-| Fitur | Express (Raw) | NestJS | Lapeh Framework |
-| :--- | :--- | :--- | :--- |
+| Fitur              | Express (Raw)                  | NestJS                             | Lapeh Framework                       |
+| :----------------- | :----------------------------- | :--------------------------------- | :------------------------------------ |
 | **Learning Curve** | Rendah (tapi bingung struktur) | Tinggi (Angular-style, Decorators) | **Sedang** (Express + Struktur Jelas) |
-| **Boilerplate** | Kosong | Sangat Banyak | **Pas (Ready to use)** |
-| **Type Safety** | Manual | Strict | **Strict (TypeScript Native)** |
-| **Kecepatan Dev** | Lambat (setup manual) | Sedang | **Cepat (CLI Generator)** |
-| **Fleksibilitas** | Sangat Tinggi | Kaku | **Tinggi** |
+| **Boilerplate**    | Kosong                         | Sangat Banyak                      | **Pas (Ready to use)**                |
+| **Type Safety**    | Manual                         | Strict                             | **Strict (TypeScript Native)**        |
+| **Kecepatan Dev**  | Lambat (setup manual)          | Sedang                             | **Cepat (CLI Generator)**             |
+| **Fleksibilitas**  | Sangat Tinggi                  | Kaku                               | **Tinggi**                            |
 
 ## Filosofi "The Lapeh Way"
 

package/doc/id/STRUCTURE.md

@@ -67,7 +67,7 @@ Middleware bawaan framework.
 
 Fungsi bantuan (Helper) bawaan.
 
-- `validator.ts`: Validasi input ala Laravel.
+- `validator.ts`: Validasi input yang kuat dan ekspresif.
 - `response.ts`: Standar format JSON response (`sendFastSuccess`, `sendError`).
 - `logger.ts`: Sistem logging (Winston).
 

package/lib/bootstrap.ts

@@ -17,22 +17,12 @@ import { apiLimiter } from "./middleware/rateLimit";
 import { requestLogger } from "./middleware/requestLogger";
 import { sendSuccess } from "./utils/response";
 
-export async function bootstrap() {
+export async function createApp() {
   // Register aliases for production runtime
   // Since user code (compiled JS) uses require('@lapeh/...')
   // We map '@lapeh' to the directory containing this file (lib/ or dist/lib/)
   moduleAlias.addAlias("@lapeh", __dirname);
 
-  // Validasi Environment Variables
-  const requiredEnvs = ["DATABASE_URL", "JWT_SECRET"];
-  const missingEnvs = requiredEnvs.filter((key) => !process.env[key]);
-  if (missingEnvs.length > 0) {
-    console.error(
-      `❌ Missing required environment variables: ${missingEnvs.join(", ")}`
-    );
-    process.exit(1);
-  }
-
   const app = express();
 
   app.disable("x-powered-by");
@@ -88,22 +78,64 @@ export async function bootstrap() {
       : path.join(process.cwd(), "src", "routes");
 
     // Gunakan require agar sinkron dan mudah dicatch
-    const { apiRouter } = require(userRoutesPath);
-    app.use("/api", apiRouter);
-    console.log(
-      `✅ User routes loaded successfully from ${
-        isProduction ? "dist/" : ""
-      }src/routes`
-    );
+    // Check if file exists before requiring to avoid crash in tests/clean env
+    try {
+      // In test environment, we might need to point to src/routes explicitly if not compiled
+      // const routesPath = process.env.NODE_ENV === 'test'
+      //    ? path.join(process.cwd(), "src", "routes", "index.ts")
+      //    : userRoutesPath;
+
+      // Note: For TS files in jest, we rely on ts-jest handling 'require' if it points to .ts or we need to use 'import'
+      // But 'require' in jest with ts-jest should work if configured.
+
+      // However, require(path) with .ts extension might be tricky.
+      // Let's stick to userRoutesPath but maybe adjust for test env.
+
+      // Check if we are in test environment and using ts-jest
+      // If so, we might need to import the TS file directly via relative path if alias is not working for require
+
+      const { apiRouter } = require(userRoutesPath);
+      app.use("/api", apiRouter);
+      console.log(
+        `✅ User routes loaded successfully from ${
+          isProduction ? "dist/" : ""
+        }src/routes`
+      );
+    } catch (e) {
+      // If it's just missing module, maybe we are in test mode or fresh install
+      if (process.env.NODE_ENV !== "test") {
+        console.warn(
+          `⚠️  Could not load user routes from ${userRoutesPath}. (This is expected during initial setup or if src/routes is missing)`
+        );
+      } else {
+        // In test mode, we really want to know if it failed to load
+        console.error(
+          `Error loading routes in test mode from ${userRoutesPath}:`,
+          e
+        );
+      }
+    }
   } catch (error) {
-    console.warn(
-      "⚠️  Could not load user routes. Make sure you export 'apiRouter'."
-    );
     console.error(error);
   }
 
   app.use(errorHandler);
 
+  return app;
+}
+
+export async function bootstrap() {
+  // Validasi Environment Variables
+  const requiredEnvs = ["DATABASE_URL", "JWT_SECRET"];
+  const missingEnvs = requiredEnvs.filter((key) => !process.env[key]);
+  if (missingEnvs.length > 0) {
+    console.error(
+      `❌ Missing required environment variables: ${missingEnvs.join(", ")}`
+    );
+    process.exit(1);
+  }
+
+  const app = await createApp();
   const port = process.env.PORT ? Number(process.env.PORT) : 4000;
   const server = http.createServer(app);
 

package/lib/utils/validator.ts

@@ -28,8 +28,8 @@ export class Validator {
   /**
    * Create a new Validator instance
    * @param data The input data to validate
-   * @param schema Zod schema or object of Zod schemas / Laravel-style rules
-   * @param messages Optional custom error messages (Laravel style: 'field.rule' => 'message')
+   * @param schema Zod schema or object of Zod schemas / string-based rules
+   * @param messages Optional custom error messages (style: 'field.rule' => 'message')
    */
   static make(
     data: any,
@@ -58,7 +58,7 @@ export class Validator {
           }
         }
 
-        parsedSchema[key] = Validator.parseLaravelRule(rule);
+        parsedSchema[key] = Validator.parseStringRule(rule);
       } else {
         parsedSchema[key] = rule as ZodSchema;
       }
@@ -83,7 +83,7 @@ export class Validator {
     return new Validator(data, objectSchema, messages);
   }
 
-  private static parseLaravelRule(rule: string | string[]): ZodSchema {
+  private static parseStringRule(rule: string | string[]): ZodSchema {
     const rules = Array.isArray(rule)
       ? rule
       : rule.split("|").map((r) => r.trim());