lapeh 3.0.7 → 3.0.8

package/doc/en/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 File ini mencatat semua perubahan, pembaruan, dan perbaikan yang dilakukan pada framework Lapeh, diurutkan berdasarkan tanggal.
 
+## [2025-12-30] - Tuesday, December 30, 2025 - Documentation & CLI (v3.0.7)
+
+### 📚 Documentation
+
+- **Project Structure Guide**: Comprehensive update to `STRUCTURE.md` to accurately reflect the No-ORM architecture and Core folder separation.
+- **Scripts Documentation**: Added detailed explanation for `release.js` and `make-module.js` automation scripts.
+
+### 🛠️ CLI Improvements
+
+- **Cleanup**: Improved `init` and `upgrade` commands to better handle legacy configuration files.
+
 ## [2025-12-30] - Tuesday, December 30, 2025 - Major Release v3.0.0 (No-ORM)
 
 ### ⚠️ Breaking Changes
@@ -18,6 +29,10 @@ File ini mencatat semua perubahan, pembaruan, dan perbaikan yang dilakukan pada
 - **Redis Caching**: Redis caching implementation on Pets controller.
 - **Documentation**: Comprehensive update to documentation to reflect database agnostic philosophy.
 
+## ⚠️ Deprecated Versions
+
+Starting from release v3.0.0, all previous versions (v1.x and v2.x) are considered **DEPRECATED**. There will be no further feature updates or bug fixes for these versions unless for critical security issues. Users are strongly advised to migrate to v3.0.0.
+
 ## [2025-12-29] - Monday, December 29, 2025 - CLI Init Bug Fix (v2.6.7)
 
 ### 🛠️ Bug Fixes

package/doc/en/INTRODUCTION.md

@@ -52,7 +52,7 @@ How does Lapeh handle a single request from a user?
 5.  **Auth Middleware** (Optional): Check JWT token & Role.
 6.  **Validator** (Optional): Validate body/query input.
 7.  **Controller**: Main business logic executed.
-    - Call Database (Prisma).
+    - Call Database (via `db` adapter).
     - Call Cache (Redis).
 8.  **Serializer**: Data formatted & sanitized (e.g., hide password).
 9.  **Response**: JSON sent back to user.

package/doc/id/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 File ini mencatat semua perubahan, pembaruan, dan perbaikan yang dilakukan pada framework Lapeh, diurutkan berdasarkan tanggal.
 
+## [2025-12-30] - Selasa, 30 Desember 2025 - Dokumentasi & CLI (v3.0.7)
+
+### 📚 Dokumentasi
+
+- **Panduan Struktur Proyek**: Pembaruan komprehensif pada `STRUCTURE.md` untuk mencerminkan arsitektur No-ORM dan pemisahan folder Core.
+- **Dokumentasi Scripts**: Penjelasan mendalam untuk script otomatisasi `release.js` dan `make-module.js`.
+
+### 🛠️ Perbaikan CLI
+
+- **Cleanup**: Peningkatan perintah `init` dan `upgrade` untuk menangani file konfigurasi lama dengan lebih baik.
+
 ## [2025-12-30] - Selasa, 30 Desember 2025 - Major Release v3.0.0 (No-ORM)
 
 ### ⚠️ Perubahan Besar (Breaking Changes)
@@ -18,6 +29,10 @@ File ini mencatat semua perubahan, pembaruan, dan perbaikan yang dilakukan pada
 - **Redis Caching**: Implementasi caching Redis pada Pets controller.
 - **Dokumentasi**: Pembaruan menyeluruh pada dokumentasi untuk mencerminkan filosofi agnostik database.
 
+## ⚠️ Versi Usang (Deprecated Versions)
+
+Mulai dari rilis v3.0.0, semua versi sebelumnya (v1.x dan v2.x) dianggap **DEPRECATED** (usang). Tidak akan ada lagi pembaruan fitur atau perbaikan bug untuk versi-versi tersebut kecuali untuk masalah keamanan kritis. Pengguna sangat disarankan untuk bermigrasi ke v3.0.0.
+
 ## [2025-12-29] - Senin, 29 Desember 2025 - Perbaikan Bug CLI Init (v2.6.7)
 
 ### 🛠️ Perbaikan Bug

package/doc/id/INTRODUCTION.md

@@ -19,7 +19,7 @@ Di ekosistem Node.js, developer sering mengalami "Decision Fatigue" (Kelelahan m
 
 Lapeh menjawab semua itu dengan **Opinionated Defaults**:
 
-1.  **ORM**: Prisma (Standar industri saat ini).
+1.  **Database**: Agnostic (Bebas pilih: Prisma, TypeORM, Drizzle, dll).
 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.
@@ -52,7 +52,7 @@ Bagaimana Lapeh menangani satu permintaan dari user?
 5.  **Auth Middleware** (Opsional): Cek token JWT & Role.
 6.  **Validator** (Opsional): Validasi input body/query.
 7.  **Controller**: Logika bisnis utama dijalankan.
-    - Panggil Database (Prisma).
+    - Panggil Database (via `db` adapter).
     - Panggil Cache (Redis).
 8.  **Serializer**: Data diformat & disanitasi (misal: hide password).
 9.  **Response**: JSON dikirim kembali ke user.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lapeh",
-  "version": "3.0.7",
+  "version": "3.0.8",
   "description": "Framework API Express yang siap pakai (Standardized)",
   "engines": {
     "node": ">=18.0.0",

package/scripts/release.js

@@ -103,6 +103,26 @@ function generateAutoCommitMessage() {
     }
 }
 
+// Helper to extract changelog entry
+function extractChangelogEntry(filePath, version) {
+    try {
+        if (!fs.existsSync(filePath)) return null;
+        const content = fs.readFileSync(filePath, 'utf8');
+        // Regex to find the section for the version. 
+        // Matches "## [YYYY-MM-DD] ... vX.X.X ..." until the next "## ["
+        // We allow the version to be anywhere in the header line
+        const regex = new RegExp(`## \\[.*?\\] - .*?v${version}.*?([\\s\\S]*?)(?=\\n## \\[|$)`, 'i');
+        const match = content.match(regex);
+        
+        if (match && match[1]) {
+            return match[1].trim();
+        }
+        return null;
+    } catch (e) {
+        return null;
+    }
+}
+
 async function main() {
     try {
         // 0. Quick Git Update Check
@@ -158,22 +178,48 @@ async function main() {
         let blogTitleEN = '';
 
         if (createBlog.toLowerCase() === 'y') {
-            console.log('\n🤖 Auto-detecting changes from Git...');
+            console.log('\n🤖 Auto-detecting changes from Git & Changelog...');
             const changes = getGitChanges();
             
-            // Heuristics for defaults
-            const defaultTitle = changes.length > 0 ? changes[0] : 'Maintenance Release';
-            const defaultDesc = changes.length > 0 ? `Includes: ${changes.slice(0, 2).join(', ')}` : 'Routine maintenance and updates.';
-            const defaultFeatures = changes.join(', ');
-
-            // Use defaults directly
-            const titleID = defaultTitle;
-            const descriptionID = defaultDesc;
-            const featuresID = defaultFeatures;
-
-            const titleEN = defaultTitle;
-            const descriptionEN = defaultDesc;
-            const featuresEN = defaultFeatures;
+            // Try to read from CHANGELOG.md first
+            const changelogID = extractChangelogEntry(path.join(rootDir, 'doc/id/CHANGELOG.md'), newVersion);
+            const changelogEN = extractChangelogEntry(path.join(rootDir, 'doc/en/CHANGELOG.md'), newVersion);
+
+            let titleID, descriptionID, featuresID, featureListID;
+            let titleEN, descriptionEN, featuresEN, featureListEN;
+
+            if (changelogID) {
+                console.log('✅ Found entry in doc/id/CHANGELOG.md');
+                // Extract title from first line of changelog entry if possible, or use default
+                // Actually usually changelog entry body starts with ### Section.
+                // We'll use a generic title and the full body as content.
+                titleID = `Update Terbaru v${newVersion}`; 
+                // Try to find specific sections for description/features is hard without strict parsing.
+                // We will treat the entire changelog body as the "Features" section.
+                descriptionID = `Rilis versi ${newVersion} hadir dengan berbagai pembaruan dan perbaikan.`;
+                featureListID = changelogID; 
+            } else {
+                console.log('⚠️ No entry in doc/id/CHANGELOG.md, using git logs...');
+                titleID = changes.length > 0 ? changes[0] : 'Maintenance Release';
+                descriptionID = changes.length > 0 ? `Includes: ${changes.slice(0, 2).join(', ')}` : 'Routine maintenance and updates.';
+                featureListID = changes.length > 0 
+                    ? changes.map(f => `*   **${f.trim()}**`).join('\n')
+                    : '*   **Routine maintenance**';
+            }
+
+            if (changelogEN) {
+                console.log('✅ Found entry in doc/en/CHANGELOG.md');
+                titleEN = `Latest Update v${newVersion}`;
+                descriptionEN = `Release version ${newVersion} comes with various updates and improvements.`;
+                featureListEN = changelogEN;
+            } else {
+                console.log('⚠️ No entry in doc/en/CHANGELOG.md, using git logs...');
+                titleEN = changes.length > 0 ? changes[0] : 'Maintenance Release';
+                descriptionEN = changes.length > 0 ? `Includes: ${changes.slice(0, 2).join(', ')}` : 'Routine maintenance and updates.';
+                featureListEN = changes.length > 0
+                    ? changes.map(f => `*   **${f.trim()}**`).join('\n')
+                    : '*   **Routine maintenance**';
+            }
             
             blogTitleEN = titleEN; // Save for commit message
 
@@ -183,33 +229,20 @@ async function main() {
             const dateStringEn = new Date().toLocaleDateString('en-US', { month: 'long', day: 'numeric', year: 'numeric' });
             
             const blogFileName = `release-v${newVersion}.md`;
-            
-            // Generate list items
-            const featureListID = changes.length > 0 
-                ? changes.map(f => `*   **${f.trim()}**`).join('\n')
-                : '*   **Routine maintenance**';
-                
-            const featureListEN = changes.length > 0
-                ? changes.map(f => `*   **${f.trim()}**`).join('\n')
-                : '*   **Routine maintenance**';
 
             // Indonesian Blog Content
             const idContent = `---
-title: "Rilis v${newVersion} - ${titleID.replace(/"/g, '\\"')}"
+title: "Rilis v${newVersion}"
 date: ${date}
 author: Tim Lapeh
 description: "${descriptionID.replace(/"/g, '\\"')}"
 ---
 
-# Rilis v${newVersion}: ${titleID}
-
-Kami dengan senang hati mengumumkan rilis **Lapeh Framework v${newVersion}**!
-
-## Apa yang Baru?
+# Rilis v${newVersion}
 
 ${descriptionID}
 
-### Fitur Utama 🚀
+## Rincian Perubahan 📝
 
 ${featureListID}
 
@@ -224,21 +257,17 @@ Terima kasih telah menggunakan Lapeh Framework!
 
             // English Blog Content
             const enContent = `---
-title: "Release v${newVersion} - ${titleEN.replace(/"/g, '\\"')}"
+title: "Release v${newVersion}"
 date: ${date}
 author: Lapeh Team
 description: "${descriptionEN.replace(/"/g, '\\"')}"
 ---
 
-# Release v${newVersion}: ${titleEN}
-
-We are excited to announce the release of **Lapeh Framework v${newVersion}**!
-
-## What's New?
+# Release v${newVersion}
 
 ${descriptionEN}
 
-### Key Features 🚀
+## Change Details 📝
 
 ${featureListEN}