lapeh 2.0.0 → 2.0.2

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/bin/index.js

@@ -6,228 +6,330 @@ const { execSync } = require('child_process');
 const readline = require('readline');
 
 const args = process.argv.slice(2);
-const projectName = args.find(arg => !arg.startsWith('-'));
-const isFull = args.includes('--full');
 
-if (!projectName) {
-  console.error('❌ Please specify the project name:');
-  console.error('   npx lapeh-cli <project-name> [--full]');
-  process.exit(1);
+// --- UPGRADE MODE ---
+if (args[0] === 'upgrade') {
+  (async () => {
+    await upgradeProject();
+  })();
+} else {
+  // --- CREATE MODE ---
+  createProject();
 }
 
-const currentDir = process.cwd();
-const projectDir = path.join(currentDir, projectName);
-const templateDir = path.join(__dirname, '..');
-
-if (fs.existsSync(projectDir)) {
-  console.error(`❌ Directory ${projectName} already exists.`);
-  process.exit(1);
-}
-
-// Setup readline interface
-const rl = readline.createInterface({
-  input: process.stdin,
-  output: process.stdout,
-});
-
-const ask = (query, defaultVal) => {
-  return new Promise((resolve) => {
-    rl.question(`${query} ${defaultVal ? `[${defaultVal}]` : ""}: `, (answer) => {
-      resolve(answer.trim() || defaultVal);
-    });
-  });
-};
-
-const selectOption = async (query, options) => {
-  console.log(query);
-  options.forEach((opt, idx) => {
-    console.log(`   [${opt.key}] ${opt.label}`);
-  });
+async function upgradeProject() {
+  const currentDir = process.cwd();
+  const templateDir = path.join(__dirname, '..');
   
-  while (true) {
-    const answer = await ask(">", options[0].key);
-    const selected = options.find(o => o.key.toLowerCase() === answer.toLowerCase());
-    if (selected) return selected;
-    
-    const byLabel = options.find(o => o.label.toLowerCase().includes(answer.toLowerCase()));
-    if (byLabel) return byLabel;
+  console.log(`🚀 Upgrading Lapeh project in ${currentDir}...`);
 
-    console.log("Pilihan tidak valid. Silakan coba lagi.");
+  // Check if package.json exists
+  const packageJsonPath = path.join(currentDir, 'package.json');
+  if (!fs.existsSync(packageJsonPath)) {
+    console.error('❌ No package.json found. Are you in the root of a Lapeh project?');
+    process.exit(1);
   }
-};
-
-(async () => {
-  console.log(`🚀 Creating a new API Lapeh project in ${projectDir}...`);
-  fs.mkdirSync(projectDir);
-
-  // --- DATABASE SELECTION ---
-  console.log("\n--- Database Configuration ---");
-  const dbType = await selectOption("Database apa yang akan digunakan?", [
-    { key: "pgsql", label: "PostgreSQL", provider: "postgresql", defaultPort: "5432" },
-    { key: "mysql", label: "MySQL", provider: "mysql", defaultPort: "3306" },
-    { key: "mariadb", label: "MariaDB", provider: "mysql", defaultPort: "3306" },
-    { key: "sqlite", label: "SQLite", provider: "sqlite", defaultPort: "" },
-  ]);
-
-  let dbUrl = "";
-  let dbProvider = dbType.provider;
-
-  if (dbType.key === "sqlite") {
-    dbUrl = "file:./dev.db";
-  } else {
-    const host = await ask("Database Host", "localhost");
-    const port = await ask("Database Port", dbType.defaultPort);
-    const user = await ask("Database User", "root");
-    const password = await ask("Database Password", "");
-    const dbName = await ask("Database Name", projectName.replace(/-/g, '_')); // Default db name based on project name
-
-    if (dbType.key === "pgsql") {
-      dbUrl = `postgresql://${user}:${password}@${host}:${port}/${dbName}?schema=public`;
+
+  // Files/Folders to overwrite/copy
+  const filesToSync = [
+    'scripts',
+    'docker-compose.yml',
+    '.env.example',
+    '.vscode',
+    'tsconfig.json',
+  ];
+
+  // Helper to copy recursive
+  function copyRecursive(src, dest) {
+    if (!fs.existsSync(src)) return;
+    const stats = fs.statSync(src);
+    if (stats.isDirectory()) {
+      if (!fs.existsSync(dest)) fs.mkdirSync(dest);
+      fs.readdirSync(src).forEach(childItemName => {
+        copyRecursive(path.join(src, childItemName), path.join(dest, childItemName));
+      });
     } else {
-      dbUrl = `mysql://${user}:${password}@${host}:${port}/${dbName}`;
+      fs.copyFileSync(src, dest);
     }
   }
 
-  rl.close();
-
-  // List of files/folders to exclude
-  const ignoreList = [
-    'node_modules',
-    'dist',
-    '.git',
-    '.env',
-    'bin', // Don't copy the CLI script itself
-    'package-lock.json',
-    '.DS_Store',
-    projectName // Don't copy the destination folder itself if creating inside the template
-  ];
+  for (const item of filesToSync) {
+    const srcPath = path.join(templateDir, item);
+    const destPath = path.join(currentDir, item);
+    
+    if (fs.existsSync(srcPath)) {
+      console.log(`🔄 Updating ${item}...`);
+      copyRecursive(srcPath, destPath);
+    }
+  }
 
-  function copyDir(src, dest) {
-    const entries = fs.readdirSync(src, { withFileTypes: true });
+  // Merge package.json
+  console.log('📝 Updating package.json...');
+  const currentPackageJson = require(packageJsonPath);
+  const templatePackageJson = require(path.join(templateDir, 'package.json'));
+
+  // Update scripts
+  currentPackageJson.scripts = {
+    ...currentPackageJson.scripts,
+    ...templatePackageJson.scripts
+  };
+
+  // Update dependencies
+  currentPackageJson.dependencies = {
+    ...currentPackageJson.dependencies,
+    ...templatePackageJson.dependencies
+  };
+  
+  // Update devDependencies
+  currentPackageJson.devDependencies = {
+    ...currentPackageJson.devDependencies,
+    ...templatePackageJson.devDependencies
+  };
 
-    for (const entry of entries) {
-      const srcPath = path.join(src, entry.name);
-      const destPath = path.join(dest, entry.name);
+  // Update Lapeh version tag
+  currentPackageJson.dependencies["lapeh"] = templatePackageJson.version;
 
-      if (ignoreList.includes(entry.name)) {
-        continue;
-      }
+  fs.writeFileSync(packageJsonPath, JSON.stringify(currentPackageJson, null, 2));
 
-      if (entry.isDirectory()) {
-        fs.mkdirSync(destPath);
-        copyDir(srcPath, destPath);
-      } else {
-        fs.copyFileSync(srcPath, destPath);
-      }
-    }
+  // Run npm install
+  console.log('📦 Installing updated dependencies...');
+  try {
+    execSync('npm install', { cwd: currentDir, stdio: 'inherit' });
+  } catch (error) {
+    console.error('❌ Error installing dependencies.');
+    process.exit(1);
   }
 
-  console.log('\n📂 Copying template files...');
-  copyDir(templateDir, projectDir);
+  console.log('\n✅ Upgrade completed successfully!');
+  console.log('   Please check your .env file against .env.example for any new required variables.');
+}
 
-  // Update package.json
-  console.log('📝 Updating package.json...');
-  const packageJsonPath = path.join(projectDir, 'package.json');
-  const packageJson = require(packageJsonPath);
+function createProject() {
+  const projectName = args.find(arg => !arg.startsWith('-'));
+  const isFull = args.includes('--full');
 
-  packageJson.name = projectName;
-  // Add lapeh framework version to dependencies to track it like react-router
-  packageJson.dependencies = packageJson.dependencies || {};
-  packageJson.dependencies["lapeh"] = packageJson.version; 
-  
-  packageJson.version = '1.0.0';
-  packageJson.description = 'Generated by lapeh';
-  delete packageJson.bin; // Remove the bin entry from the generated project
-  delete packageJson.repository; // Remove repository info if specific to the template
+  if (!projectName) {
+    console.error('❌ Please specify the project name:');
+    console.error('   npx lapeh-cli <project-name> [--full]');
+    console.error('   OR');
+    console.error('   npx lapeh-cli upgrade (inside existing project)');
+    process.exit(1);
+  }
 
-  fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
+  const currentDir = process.cwd();
+  const projectDir = path.join(currentDir, projectName);
+  const templateDir = path.join(__dirname, '..');
 
-  // Create .env from .env.example with correct DB config
-  console.log('⚙️  Configuring environment...');
-  const envExamplePath = path.join(projectDir, '.env.example');
-  const envPath = path.join(projectDir, '.env');
-  const prismaBaseFile = path.join(projectDir, "prisma", "base.prisma.template");
+  if (fs.existsSync(projectDir)) {
+    console.error(`❌ Directory ${projectName} already exists.`);
+    process.exit(1);
+  }
+
+  // Setup readline interface
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  const ask = (query, defaultVal) => {
+    return new Promise((resolve) => {
+      rl.question(`${query} ${defaultVal ? `[${defaultVal}]` : ""}: `, (answer) => {
+        resolve(answer.trim() || defaultVal);
+      });
+    });
+  };
 
-  if (fs.existsSync(envExamplePath)) {
-    let envContent = fs.readFileSync(envExamplePath, 'utf8');
+  const selectOption = async (query, options) => {
+    console.log(query);
+    options.forEach((opt, idx) => {
+      console.log(`   [${opt.key}] ${opt.label}`);
+    });
     
-    // Replace DATABASE_URL and DATABASE_PROVIDER
-    if (envContent.includes("DATABASE_URL=")) {
-      envContent = envContent.replace(/DATABASE_URL=".+"/g, `DATABASE_URL="${dbUrl}"`);
-      envContent = envContent.replace(/DATABASE_URL=.+/g, `DATABASE_URL="${dbUrl}"`); 
+    while (true) {
+      const answer = await ask(">", options[0].key);
+      const selected = options.find(o => o.key.toLowerCase() === answer.toLowerCase());
+      if (selected) return selected;
+      
+      const byLabel = options.find(o => o.label.toLowerCase().includes(answer.toLowerCase()));
+      if (byLabel) return byLabel;
+
+      console.log("Pilihan tidak valid. Silakan coba lagi.");
+    }
+  };
+
+  (async () => {
+    console.log(`🚀 Creating a new API Lapeh project in ${projectDir}...`);
+    fs.mkdirSync(projectDir);
+
+    // --- DATABASE SELECTION ---
+    console.log("\n--- Database Configuration ---");
+    const dbType = await selectOption("Database apa yang akan digunakan?", [
+      { key: "pgsql", label: "PostgreSQL", provider: "postgresql", defaultPort: "5432" },
+      { key: "mysql", label: "MySQL", provider: "mysql", defaultPort: "3306" },
+      { key: "mariadb", label: "MariaDB", provider: "mysql", defaultPort: "3306" },
+      { key: "sqlite", label: "SQLite", provider: "sqlite", defaultPort: "" },
+    ]);
+
+    let dbUrl = "";
+    let dbProvider = dbType.provider;
+
+    if (dbType.key === "sqlite") {
+      dbUrl = "file:./dev.db";
     } else {
-      envContent += `\nDATABASE_URL="${dbUrl}"`;
+      const host = await ask("Database Host", "localhost");
+      const port = await ask("Database Port", dbType.defaultPort);
+      const user = await ask("Database User", "root");
+      const password = await ask("Database Password", "");
+      const dbName = await ask("Database Name", projectName.replace(/-/g, '_')); // Default db name based on project name
+
+      if (dbType.key === "pgsql") {
+        dbUrl = `postgresql://${user}:${password}@${host}:${port}/${dbName}?schema=public`;
+      } else {
+        dbUrl = `mysql://${user}:${password}@${host}:${port}/${dbName}`;
+      }
     }
 
-    if (envContent.includes("DATABASE_PROVIDER=")) {
-      envContent = envContent.replace(/DATABASE_PROVIDER=".+"/g, `DATABASE_PROVIDER="${dbProvider}"`);
-      envContent = envContent.replace(/DATABASE_PROVIDER=.+/g, `DATABASE_PROVIDER="${dbProvider}"`);
-    } else {
-      envContent += `\nDATABASE_PROVIDER="${dbProvider}"`;
+    rl.close();
+
+    // List of files/folders to exclude
+    const ignoreList = [
+      'node_modules',
+      'dist',
+      '.git',
+      '.env',
+      'bin', // Don't copy the CLI script itself
+      'package-lock.json',
+      '.DS_Store',
+      projectName // Don't copy the destination folder itself if creating inside the template
+    ];
+
+    function copyDir(src, dest) {
+      const entries = fs.readdirSync(src, { withFileTypes: true });
+
+      for (const entry of entries) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+
+        if (ignoreList.includes(entry.name)) {
+          continue;
+        }
+
+        if (entry.isDirectory()) {
+          fs.mkdirSync(destPath);
+          copyDir(srcPath, destPath);
+        } else {
+          fs.copyFileSync(srcPath, destPath);
+        }
+      }
     }
 
-    fs.writeFileSync(envPath, envContent);
-  }
-  
-  // Update prisma/base.prisma.template
-  console.log("📄 Updating prisma/base.prisma.template...");
-  if (fs.existsSync(prismaBaseFile)) {
-    let baseContent = fs.readFileSync(prismaBaseFile, "utf8");
-    // Replace provider in datasource block
-    baseContent = baseContent.replace(
-      /(datasource\s+db\s+\{[\s\S]*?provider\s*=\s*")([^"]+)(")/, 
-      `$1${dbProvider}$3`
-    );
-    fs.writeFileSync(prismaBaseFile, baseContent);
-  }
+    console.log('\n📂 Copying template files...');
+    copyDir(templateDir, projectDir);
 
-  // Install dependencies
-  console.log('📦 Installing dependencies (this might take a while)...');
-  try {
-    execSync('npm install', { cwd: projectDir, stdio: 'inherit' });
-  } catch (error) {
-    console.error('❌ Error installing dependencies.');
-    process.exit(1);
-  }
+    // Update package.json
+    console.log('📝 Updating package.json...');
+    const packageJsonPath = path.join(projectDir, 'package.json');
+    const packageJson = require(packageJsonPath);
 
-  // Generate JWT Secret
-  console.log('🔑 Generating JWT Secret...');
-  try {
-    execSync('npm run generate:jwt', { cwd: projectDir, stdio: 'inherit' });
-  } catch (error) {
-    console.warn('⚠️  Could not generate JWT secret automatically.');
-  }
-
-  // Generate Prisma Client & Migrate
-  console.log('🗄️ Setting up database...');
-  try {
-    console.log('   Compiling schema...');
-    execSync('node scripts/compile-schema.js', { cwd: projectDir, stdio: 'inherit' });
+    packageJson.name = projectName;
+    // Add lapeh framework version to dependencies to track it like react-router
+    packageJson.dependencies = packageJson.dependencies || {};
+    packageJson.dependencies["lapeh"] = packageJson.version; 
     
-    console.log('   Generating Prisma Client...');
-    execSync('npx prisma generate', { cwd: projectDir, stdio: 'inherit' });
+    packageJson.version = '1.0.0';
+    packageJson.description = 'Generated by lapeh';
+    delete packageJson.bin; // Remove the bin entry from the generated project
+    delete packageJson.repository; // Remove repository info if specific to the template
+
+    fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
+
+    // Create .env from .env.example with correct DB config
+    console.log('⚙️  Configuring environment...');
+    const envExamplePath = path.join(projectDir, '.env.example');
+    const envPath = path.join(projectDir, '.env');
+    const prismaBaseFile = path.join(projectDir, "prisma", "base.prisma.template");
+
+    if (fs.existsSync(envExamplePath)) {
+      let envContent = fs.readFileSync(envExamplePath, 'utf8');
+      
+      // Replace DATABASE_URL and DATABASE_PROVIDER
+      if (envContent.includes("DATABASE_URL=")) {
+        envContent = envContent.replace(/DATABASE_URL=".+"/g, `DATABASE_URL="${dbUrl}"`);
+        envContent = envContent.replace(/DATABASE_URL=.+/g, `DATABASE_URL="${dbUrl}"`); 
+      } else {
+        envContent += `\nDATABASE_URL="${dbUrl}"`;
+      }
+
+      if (envContent.includes("DATABASE_PROVIDER=")) {
+        envContent = envContent.replace(/DATABASE_PROVIDER=".+"/g, `DATABASE_PROVIDER="${dbProvider}"`);
+        envContent = envContent.replace(/DATABASE_PROVIDER=.+/g, `DATABASE_PROVIDER="${dbProvider}"`);
+      } else {
+        envContent += `\nDATABASE_PROVIDER="${dbProvider}"`;
+      }
 
-    // Try to migrate (this will create the DB if it doesn't exist)
-    console.log('   Running migration (creates DB if missing)...');
-    execSync('npx prisma migrate dev --name init_setup', { cwd: projectDir, stdio: 'inherit' });
+      fs.writeFileSync(envPath, envContent);
+    }
     
-    // Seed
-    if (isFull) {
-      console.log('   Seeding database...');
-      execSync('npm run db:seed', { cwd: projectDir, stdio: 'inherit' });
-    } else {
-      console.log('   ℹ️  Skipping database seeding (use --full to seed default data)...');
+    // Update prisma/base.prisma.template
+    console.log("📄 Updating prisma/base.prisma.template...");
+    if (fs.existsSync(prismaBaseFile)) {
+      let baseContent = fs.readFileSync(prismaBaseFile, "utf8");
+      // Replace provider in datasource block
+      baseContent = baseContent.replace(
+        /(datasource\s+db\s+\{[\s\S]*?provider\s*=\s*")([^"]+)(")/, 
+        `$1${dbProvider}$3`
+      );
+      fs.writeFileSync(prismaBaseFile, baseContent);
     }
 
-  } catch (error) {
-    console.warn('⚠️  Database setup encountered an issue.');
-    console.warn('   You may need to check your .env credentials and run:');
-    console.warn('   cd ' + projectName);
-    console.warn('   npm run prisma:migrate');
-  }
+    // Install dependencies
+    console.log('📦 Installing dependencies (this might take a while)...');
+    try {
+      execSync('npm install', { cwd: projectDir, stdio: 'inherit' });
+    } catch (error) {
+      console.error('❌ Error installing dependencies.');
+      process.exit(1);
+    }
+
+    // Generate JWT Secret
+    console.log('🔑 Generating JWT Secret...');
+    try {
+      execSync('npm run generate:jwt', { cwd: projectDir, stdio: 'inherit' });
+    } catch (error) {
+      console.warn('⚠️  Could not generate JWT secret automatically.');
+    }
 
-  console.log(`\n✅ Project ${projectName} created successfully!`);
-  console.log(`\nNext steps:`);
-  console.log(`  cd ${projectName}`);
-  console.log(`  npm run dev`);
-})();
+    // Generate Prisma Client & Migrate
+    console.log('🗄️ Setting up database...');
+    try {
+      console.log('   Compiling schema...');
+      execSync('node scripts/compile-schema.js', { cwd: projectDir, stdio: 'inherit' });
+      
+      console.log('   Generating Prisma Client...');
+      execSync('npx prisma generate', { cwd: projectDir, stdio: 'inherit' });
+
+      // Try to migrate (this will create the DB if it doesn't exist)
+      console.log('   Running migration (creates DB if missing)...');
+      execSync('npx prisma migrate dev --name init_setup', { cwd: projectDir, stdio: 'inherit' });
+      
+      // Seed
+      if (isFull) {
+        console.log('   Seeding database...');
+        execSync('npm run db:seed', { cwd: projectDir, stdio: 'inherit' });
+      } else {
+        console.log('   ℹ️  Skipping database seeding (use --full to seed default data)...');
+      }
+
+    } catch (error) {
+      console.warn('⚠️  Database setup encountered an issue.');
+      console.warn('   You may need to check your .env credentials and run:');
+      console.warn('   cd ' + projectName);
+      console.warn('   npm run prisma:migrate');
+    }
+
+    console.log(`\n✅ Project ${projectName} created successfully!`);
+    console.log(`\nNext steps:`);
+    console.log(`  cd ${projectName}`);
+    console.log(`  npm run dev`);
+  })();
+}

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.2",
   "description": "Framework API Express yang siap pakai (Standardized)",
   "main": "index.js",
   "bin": {

package/readme.md

@@ -75,6 +75,63 @@ Jika Anda melakukan setup dengan flag `--full`, database akan terisi dengan akun
 
 ---
 
+## 🔄 Upgrade Project
+
+Jika Anda memiliki project lama yang dibuat dengan versi Lapeh sebelumnya dan ingin memperbarui struktur, scripts, dan konfigurasi ke standar terbaru (termasuk keamanan Redis baru), Anda tidak perlu membuat project ulang.
+
+Cukup jalankan perintah ini di dalam folder project Anda:
+
+```bash
+npx lapeh@latest upgrade
+```
+
+Perintah ini akan secara otomatis:
+
+1.  Mengupdate `scripts/` (termasuk generator controller baru).
+2.  Mengupdate `docker-compose.yml` (keamanan Redis).
+3.  Mengupdate dependencies di `package.json`.
+4.  Menambahkan konfigurasi `.vscode` dan `tsconfig` terbaru.
+
+> **Catatan:** File `.env` Anda **tidak akan ditimpa**, namun kami akan mengupdate `.env.example` sebagai referensi konfigurasi terbaru.
+
+## 🧠 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 };