lapeh 2.0.0 → 2.0.1

package/.env.example

@@ -3,12 +3,11 @@ DATABASE_PROVIDER="postgresql"
 DATABASE_URL="postgresql://sianu:12341234@localhost:5432/db_example_test?schema=public"   
 JWT_SECRET="replace_this_with_a_secure_random_string"
 
-# Redis Configuration (Optional)
-# If REDIS_URL is not set or connection fails, the framework will automatically 
-# switch to an in-memory Redis mock (bundled). No installation required for development.
-
-
-# REDIS_URL="redis://localhost:6379"
+# Redis Configuration (Optional)
+# If REDIS_URL is not set or connection fails, the framework will automatically 
+# switch to an in-memory Redis mock (bundled). No installation required for development.
+# REDIS_URL="redis://lapeh:12341234@localhost:6379"
+# NO_REDIS="true"
 
 # To force disable Redis and use in-memory mock even if Redis is available:
 # NO_REDIS="true"

package/docker-compose.yml

@@ -2,7 +2,14 @@ version: "3.9"
 services:
   redis:
     image: redis:7-alpine
-    command: ["redis-server", "--appendonly", "yes"]
+    command: 
+      - "redis-server"
+      - "--appendonly"
+      - "yes"
+      - "--user"
+      - "default on >12341234 ~* +@all"
+      - "--user"
+      - "lapeh on >12341234 ~* +@all"
     ports:
       - "6379:6379"
     volumes:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lapeh",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Framework API Express yang siap pakai (Standardized)",
   "main": "index.js",
   "bin": {

package/readme.md

@@ -75,6 +75,44 @@ Jika Anda melakukan setup dengan flag `--full`, database akan terisi dengan akun
 
 ---
 
+## 🧠 Zero-Config Redis
+
+Lapeh otomatis mendeteksi ketersediaan Redis.
+
+1.  **Auto-Discovery**: Mencoba terhubung ke Redis URL di `.env` (`REDIS_URL`).
+2.  **Smart Fallback**: Jika Redis tidak tersedia atau koneksi gagal, otomatis beralih ke **In-Memory Mock**.
+    - Tidak perlu install Redis di local development.
+    - Fitur rate-limiting dan caching tetap berjalan (namun data hilang saat restart).
+3.  **Production Safety**: Memberikan peringatan log jika berjalan di Production menggunakan Mock.
+
+**Force Mock Mode:**
+Anda bisa memaksa menggunakan mock (misal untuk testing) dengan menambahkan env variable:
+
+```env
+NO_REDIS=true
+```
+
+### Optional: Menggunakan Real Redis dengan Docker
+
+Jika Anda ingin menggunakan Redis yang sebenarnya di local environment, kami telah menyertakan konfigurasi `docker-compose.yml` yang aman (menggunakan ACL).
+
+1.  Jalankan Redis container:
+
+    ```bash
+    docker-compose up -d
+    ```
+
+2.  Uncomment konfigurasi Redis di file `.env` Anda:
+
+    ```env
+    REDIS_URL="redis://lapeh:12341234@localhost:6379"
+    ```
+
+    > **Credential Default:**
+    >
+    > - User: `lapeh`
+    > - Password: `12341234`
+
 ## 🛠 Development Tools
 
 API Lapeh menyediakan tools untuk mempercepat development, mirip dengan `artisan` di Laravel.

package/scripts/init-project.js

@@ -122,7 +122,22 @@ const selectOption = async (query, options) => {
     console.log("\n📦 Installing dependencies...");
     execSync("npm install", { stdio: "inherit", cwd: rootDir });
 
-    // 4. Generate JWT Secret
+    // 4. Create .vscode/settings.json
+    console.log("\n🛠️ Configuring VS Code...");
+    const vscodeDir = path.join(rootDir, ".vscode");
+    if (!fs.existsSync(vscodeDir)) {
+      fs.mkdirSync(vscodeDir, { recursive: true });
+    }
+    const settingsFile = path.join(vscodeDir, "settings.json");
+    const settingsContent = {
+      "files.associations": {
+        "*.model": "prisma"
+      }
+    };
+    fs.writeFileSync(settingsFile, JSON.stringify(settingsContent, null, 2));
+    console.log("✅ VS Code configured (.model support added).");
+
+    // 5. Generate JWT Secret
     console.log("\n🔑 Generating JWT Secret...");
     try {
         execSync("node scripts/generate-jwt-secret.js", {

package/src/redis.ts

@@ -38,12 +38,10 @@ redis.on("error", (err) => {
     // Replace the global redis instance with mock
     // Note: This is a runtime switch. Existing listeners might be lost if we don't handle carefully.
     // However, for a simple fallback, we can just use the mock for future calls.
-    
-    // Better approach: Since we exported 'redis' as a const (reference), we can't reassign it easily 
+    // Better approach: Since we exported 'redis' as a const (reference), we can't reassign it easily
     // if other modules already imported it.
     // BUT, ioredis instance itself is an EventEmitter.
-    
-    // Strategy: We keep 'redis' as the main interface. 
+    // Strategy: We keep 'redis' as the main interface.
     // If real redis fails, we just don't set isRedisConnected to true for the *real* one.
     // But wait, the user wants 'bundle redis'.
     // The best way is to detect failure during init and SWAP the implementation.
@@ -63,6 +61,7 @@ let activeRedis = redis; // Start with real redis attempt
 export async function initRedis() {
   if (process.env.NO_REDIS === "true") {
     activeRedis = mockRedis;
+    console.log("✅ Redis: Active (Source: Zero-Config Redis [NO_REDIS=true])");
     if (process.env.NODE_ENV === "production") {
       console.warn(
         "⚠️  WARNING: Running in PRODUCTION with in-memory Redis mock. Data will be lost on restart and not shared between instances."
@@ -75,9 +74,18 @@ export async function initRedis() {
     await redis.connect();
     activeRedis = redis; // Keep using real redis
     isRedisConnected = true;
+
+    // Determine source label
+    const sourceLabel = process.env.REDIS_URL
+      ? redisUrl
+      : "Zero-Config Redis (Localhost)";
+
+    console.log(`✅ Redis: Active (Source: ${sourceLabel})`);
   } catch (err) {
     // Connection failed, switch to mock
-    // console.log("Redis failed, using in-memory mock");
+    console.log(
+      `⚠️  Redis: Connection failed to ${redisUrl}, switching to fallback (Source: Zero-Config Redis [Mock])`
+    );
     activeRedis = mockRedis;
     isRedisConnected = true; // Mock is always "connected"
     if (process.env.NODE_ENV === "production") {
@@ -118,4 +126,4 @@ export async function delCache(key: string) {
 }
 
 // Export the proxy as 'redis' so consumers use it transparently
-export { redisProxy as redis };
+export { redisProxy as redis };