create-zerra-app 1.0.2 → 1.2.0

package/index.js

@@ -12,7 +12,7 @@ program
   .action(async (projectName) => {
     const targetPath = path.join(process.cwd(), projectName);
 
-    // 1. Ask for Database Preference
+    // 1. Ask for Database Preference and CLI features
     const answers = await inquirer.prompt([
       {
         type: "list",
@@ -26,25 +26,169 @@ program
           { name: "Firebase", value: "js-firebase" },
         ],
       },
+      {
+        type: "confirm",
+        name: "includeAuth",
+        message: "Include Authentication Starter (JWT + Bcrypt)?",
+        default: true,
+      },
+      {
+        type: "checkbox",
+        name: "features",
+        message: "Select advanced features to enable:",
+        choices: [
+          { name: "Beautiful Request Logging", value: "logging", checked: true },
+          { name: "Dynamic Routing ([id].js)", value: "dynamicRouting", checked: true },
+          { name: "File-Based Middleware (_middleware.js)", value: "middleware", checked: true },
+          { name: "Auto-load Environment Variables (.env)", value: "dotenv", checked: true },
+          { name: "Automatic Input Validation (Schema)", value: "validation", checked: true },
+          { name: "Multipart File Uploads (req.files)", value: "multipart", checked: true },
+          { name: "Smart Error Handling (_error.js)", value: "errors", checked: true },
+          { name: "Dev Dashboard (/__zerra)", value: "dashboard", checked: true }
+        ]
+      },
+      {
+        type: "confirm",
+        name: "installDeps",
+        message: "Install dependencies automatically?",
+        default: true,
+      },
+      {
+        type: "confirm",
+        name: "initGit",
+        message: "Initialize git repository?",
+        default: true,
+      }
     ]);
 
-    const templatePath = path.join(__dirname, "templates", answers.database);
+    // 2. Project Preview Summary
+    console.log(`\n📋  Project Configuration:`);
+    console.log(`   - Project Name: \x1b[36m${projectName}\x1b[0m`);
+    console.log(`   - Database:     \x1b[33m${answers.database.replace('js-', '')}\x1b[0m`);
+    console.log(`   - Auth Starter: \x1b[32m${answers.includeAuth ? 'Enabled' : 'Disabled'}\x1b[0m`);
+    console.log(`   - Features:     \x1b[35m${answers.features.join(', ') || 'None'}\x1b[0m`);
+    console.log(`   - Auto-Install: \x1b[32m${answers.installDeps ? 'Yes' : 'No'}\x1b[0m`);
+    console.log(`   - Git Init:     \x1b[32m${answers.initGit ? 'Yes' : 'No'}\x1b[0m`);
 
-    console.log(`\n🏗️  Generating Zerra project: ${projectName}...`);
+    const { confirmProceed } = await inquirer.prompt([
+      {
+        type: "confirm",
+        name: "confirmProceed",
+        message: "Does this look correct?",
+        default: true,
+      }
+    ]);
+
+    if (!confirmProceed) {
+      console.log("\n❌  Project creation cancelled.\n");
+      return;
+    }
+
+    const baseTemplatePath = path.join(__dirname, "templates", "js-base");
+    const dbTemplatePath = path.join(__dirname, "templates", answers.database);
+    const authTemplatePath = path.join(__dirname, "templates", "js-auth");
+
+    console.log(`\n🏗️  Building your Zerra application...`);
 
     try {
-      if (!fs.existsSync(templatePath)) {
-        // Fallback to base if specific template isn't ready yet
-        console.warn(`⚠️  Template ${answers.database} not found, falling back to base.`);
-        await fs.copy(path.join(__dirname, "templates", "js-base"), targetPath);
-      } else {
-        await fs.copy(templatePath, targetPath);
+      // 1. Copy the Base Template (Foundation)
+      if (fs.existsSync(baseTemplatePath)) {
+        await fs.copy(baseTemplatePath, targetPath);
+      }
+
+      // 2. Overlay Database-Specific Template (if not base)
+      if (answers.database !== "js-base" && fs.existsSync(dbTemplatePath)) {
+        // We use a custom copy to handle package.json merging
+        await fs.copy(dbTemplatePath, targetPath, {
+          overwrite: true,
+          filter: (src) => !src.endsWith("package.json"), // Handle package.json separately
+        });
+
+        const dbPkgPath = path.join(dbTemplatePath, "package.json");
+        const targetPkgPath = path.join(targetPath, "package.json");
+
+        if (fs.existsSync(dbPkgPath) && fs.existsSync(targetPkgPath)) {
+          const basePkg = await fs.readJson(targetPkgPath);
+          const dbPkg = await fs.readJson(dbPkgPath);
+
+          // Merge dependencies and scripts
+          basePkg.dependencies = { ...(basePkg.dependencies || {}), ...(dbPkg.dependencies || {}) };
+          basePkg.scripts = { ...(basePkg.scripts || {}), ...(dbPkg.scripts || {}) };
+
+          await fs.writeJson(targetPkgPath, basePkg, { spaces: 2 });
+        }
+      }
+
+      // 2.5 Overlay Auth Starter (if selected)
+      if (answers.includeAuth && fs.existsSync(authTemplatePath)) {
+        console.log(`   🔐 Adding Auth Starter...`);
+        await fs.copy(authTemplatePath, targetPath, {
+          overwrite: true,
+          filter: (src) => !src.endsWith("package.json"),
+        });
+
+        const authPkgPath = path.join(authTemplatePath, "package.json");
+        const targetPkgPath = path.join(targetPath, "package.json");
+
+        if (fs.existsSync(authPkgPath) && fs.existsSync(targetPkgPath)) {
+          const basePkg = await fs.readJson(targetPkgPath);
+          const authPkg = await fs.readJson(authPkgPath);
+          basePkg.dependencies = { ...(basePkg.dependencies || {}), ...(authPkg.dependencies || {}) };
+          await fs.writeJson(targetPkgPath, basePkg, { spaces: 2 });
+        }
       }
 
-      console.log(`🚀 Zerra project created at ${targetPath}`);
+      // 3. Customize project name in package.json
+      const pkgPath = path.join(targetPath, "package.json");
+      if (fs.existsSync(pkgPath)) {
+        const pkg = await fs.readJson(pkgPath);
+        pkg.name = projectName;
+        await fs.writeJson(pkgPath, pkg, { spaces: 2 });
+      }
+
+      // 4. Generate zerra.config.json based on feature selection
+      const featureConfig = {
+        logging: answers.features.includes('logging'),
+        dynamicRouting: answers.features.includes('dynamicRouting'),
+        middleware: answers.features.includes('middleware'),
+        dotenv: answers.features.includes('dotenv'),
+        validation: answers.features.includes('validation'),
+        multipart: answers.features.includes('multipart'),
+        errors: answers.features.includes('errors'),
+        dashboard: answers.features.includes('dashboard')
+      };
+      
+      const configJsonPath = path.join(targetPath, 'zerra.config.json');
+      await fs.writeJson(configJsonPath, { features: featureConfig, plugins: [] }, { spaces: 2 });
+
+      const { execSync } = require("child_process");
+      
+      if (answers.installDeps) {
+        console.log(`\n📦 Installing dependencies...`);
+        try {
+          execSync("npm install", { cwd: targetPath, stdio: "inherit" });
+        } catch (installErr) {
+          console.warn(`⚠️  Failed to install dependencies automatically. You may need to run 'npm install' manually.`);
+        }
+      }
+
+      if (answers.initGit) {
+        try {
+          execSync("git init", { cwd: targetPath, stdio: "ignore" });
+          execSync("git add .", { cwd: targetPath, stdio: "ignore" });
+          execSync('git commit -m "Initial commit from create-zerra-app"', { cwd: targetPath, stdio: "ignore" });
+          console.log(`🌱 Initialized a git repository.`);
+        } catch (gitErr) {
+          // Ignore git errors
+        }
+      }
+
+      console.log(`\n🚀 Zerra project created successfully at ${targetPath}`);
       console.log(`\nNext steps:`);
       console.log(`  cd ${projectName}`);
-      console.log(`  npm install`);
+      if (!answers.installDeps) {
+        console.log(`  npm install`);
+      }
       console.log(`  npm run dev\n`);
     } catch (err) {
       console.error("❌ Error creating project:", err);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-zerra-app",
-  "version": "1.0.2",
+  "version": "1.2.0",
   "description": "",
   "main": "index.js",
   "bin": {

package/templates/js-auth/api/auth/login.js

@@ -0,0 +1,15 @@
+const auth = require('../../services/auth');
+
+module.exports = async (req, res) => {
+  const { email, password } = req.body;
+
+  // Mock user for the starter
+  const mockUser = { id: 1, email: 'user@example.com', password: auth.hashPassword('password123') };
+
+  if (email === mockUser.email && auth.comparePassword(password, mockUser.password)) {
+    const token = auth.generateToken(mockUser);
+    return res.json({ token, message: "Login successful" });
+  }
+
+  res.status(401).json({ error: "Invalid credentials" });
+};

package/templates/js-auth/api/auth/register.js

@@ -0,0 +1,24 @@
+const auth = require('../../services/auth');
+
+// Note: This is a starter. In a real app, you would save the user to your database.
+module.exports = async (req, res) => {
+  const { email, password } = req.body;
+
+  if (!email || !password) {
+    return res.status(400).json({ error: "Email and password are required" });
+  }
+
+  const hashedPassword = auth.hashPassword(password);
+  
+  // Here you would: await db.users.create({ email, password: hashedPassword })
+
+  res.status(201).json({ 
+    message: "User registered successfully (Starter Mock)",
+    user: { email }
+  });
+};
+
+module.exports.schema = {
+  email: 'string',
+  password: 'string'
+};

package/templates/js-auth/api/protected/_middleware.js

@@ -0,0 +1,17 @@
+const auth = require('../../services/auth');
+
+module.exports = async (req, res, next) => {
+  const token = req.headers.authorization?.split(' ')[1];
+
+  if (!token) {
+    return res.status(401).json({ error: "No token provided" });
+  }
+
+  try {
+    const decoded = auth.verifyToken(token);
+    req.user = decoded;
+    await next();
+  } catch (e) {
+    res.status(401).json({ error: "Invalid or expired token" });
+  }
+};

package/templates/js-auth/api/protected/secret.js

@@ -0,0 +1,6 @@
+module.exports = async (req, res) => {
+  res.json({ 
+    message: "Welcome to the secret area!",
+    user: req.user 
+  });
+};

package/templates/js-auth/package.json

@@ -0,0 +1,6 @@
+{
+  "dependencies": {
+    "jsonwebtoken": "^9.0.2",
+    "bcryptjs": "^2.4.3"
+  }
+}

package/templates/js-auth/services/auth.js

@@ -0,0 +1,11 @@
+const jwt = require('jsonwebtoken');
+const bcrypt = require('bcryptjs');
+
+const JWT_SECRET = process.env.JWT_SECRET || 'zerra-secret-key';
+
+module.exports = {
+  hashPassword: (password) => bcrypt.hashSync(password, 10),
+  comparePassword: (password, hash) => bcrypt.compareSync(password, hash),
+  generateToken: (user) => jwt.sign({ id: user.id, email: user.email }, JWT_SECRET, { expiresIn: '1d' }),
+  verifyToken: (token) => jwt.verify(token, JWT_SECRET)
+};

package/templates/js-base/api/hello.js

@@ -1,3 +1,10 @@
+const logger = require("../services/logger");
+
 module.exports = (req, res) => {
-  res.end("Hello from Zerra! 🚀");
+  logger.info("Hello endpoint was hit!");
+  res.json({
+    message: "Hello from Zerra! 🚀",
+    timestamp: new Date().toISOString(),
+    query: req.query
+  });
 };

package/templates/js-base/package.json

@@ -5,6 +5,6 @@
     "dev": "node server.js"
   },
   "dependencies": {
-    "zerra-core": "^1.0.0"
+    "zerra-core": "^1.2.0"
   }
 }

package/templates/js-base/services/logger.js

@@ -0,0 +1,4 @@
+module.exports = {
+  info: (message) => console.log(`[INFO] ${new Date().toISOString()}: ${message}`),
+  error: (message) => console.error(`[ERROR] ${new Date().toISOString()}: ${message}`),
+};

package/templates/js-firebase/api/hello.js

@@ -1,3 +1,9 @@
-module.exports = (req, res) => {
-  res.end("Hello from Zerra! 🚀");
+const firebase = require("../services/firebase");
+
+module.exports = async (req, res) => {
+  const snapshot = await firebase.firestore().collection("users").get();
+  res.json({
+    message: "Hello from Zerra! Firebase is ready.",
+    userCount: snapshot.docs.length
+  });
 };

package/templates/js-firebase/package.json

@@ -1,10 +1,5 @@
 {
-  "name": "zerra-app",
-  "version": "1.0.0",
-  "scripts": {
-    "dev": "node server.js"
-  },
   "dependencies": {
-    "zerra-core": "^1.0.0"
+    "firebase-admin": "^11.0.0"
   }
 }

package/templates/js-firebase/services/firebase.js

@@ -0,0 +1,11 @@
+// This is a stub for your Firebase Admin SDK
+module.exports = {
+  firestore: () => ({
+    collection: (name) => ({
+      get: async () => {
+        console.log(`[FIREBASE] Getting collection: ${name}`);
+        return { docs: [] };
+      }
+    })
+  })
+};

package/templates/js-mongo/api/hello.js

@@ -1,3 +1,10 @@
-module.exports = (req, res) => {
-  res.end("Hello from Zerra! 🚀");
+const db = require("../services/db");
+
+module.exports = async (req, res) => {
+  const users = await db.find("users", {});
+  res.json({
+    message: "Hello from Zerra! MongoDB is connected.",
+    count: users.length,
+    users: users
+  });
 };

package/templates/js-mongo/package.json

@@ -1,10 +1,5 @@
 {
-  "name": "zerra-app",
-  "version": "1.0.0",
-  "scripts": {
-    "dev": "node server.js"
-  },
   "dependencies": {
-    "zerra-core": "^1.0.0"
+    "mongodb": "^6.0.0"
   }
 }

package/templates/js-mongo/services/db.js

@@ -0,0 +1,7 @@
+// This is a stub for your MongoDB connection (e.g., using Mongoose or mongodb driver)
+module.exports = {
+  find: async (collection, query) => {
+    console.log(`[MONGO] Finding in ${collection}:`, query);
+    return []; // Return mock results
+  }
+};

package/templates/js-sql/api/hello.js

@@ -1,3 +1,6 @@
-module.exports = (req, res) => {
-  res.end("Hello from Zerra! 🚀");
+const db = require("../services/db");
+
+module.exports = async (req, res) => {
+  const users = await db.query("SELECT * FROM users");
+  res.end(`Hello from Zerra! Database is connected. Found ${users.length} users.`);
 };

package/templates/js-sql/package.json

@@ -1,10 +1,6 @@
 {
-  "name": "zerra-app",
-  "version": "1.0.0",
-  "scripts": {
-    "dev": "node server.js"
-  },
   "dependencies": {
-    "zerra-core": "^1.0.0"
+    "pg": "^8.0.0",
+    "mysql2": "^3.0.0"
   }
 }

package/templates/js-sql/services/db.js

@@ -0,0 +1,7 @@
+// This is a stub for your SQL database connection (e.g., using Knex, Sequelize, or pg)
+module.exports = {
+  query: async (sql, params) => {
+    console.log(`[DB QUERY] Executing: ${sql} with params:`, params);
+    return []; // Return mock results
+  }
+};

package/templates/js-supabase/api/hello.js

@@ -1,3 +1,10 @@
-module.exports = (req, res) => {
-  res.end("Hello from Zerra! 🚀");
+const supabase = require("../services/supabase");
+
+module.exports = async (req, res) => {
+  const { data, error } = await supabase.from("profiles").select("*");
+  res.json({
+    message: "Hello from Zerra! Supabase is ready.",
+    profiles: data,
+    error: error
+  });
 };

package/templates/js-supabase/package.json

@@ -1,10 +1,5 @@
 {
-  "name": "zerra-app",
-  "version": "1.0.0",
-  "scripts": {
-    "dev": "node server.js"
-  },
   "dependencies": {
-    "zerra-core": "^1.0.0"
+    "@supabase/supabase-js": "^2.0.0"
   }
 }

package/templates/js-supabase/services/supabase.js

@@ -0,0 +1,9 @@
+// This is a stub for your Supabase client
+module.exports = {
+  from: (table) => ({
+    select: () => {
+      console.log(`[SUPABASE] Selecting from ${table}`);
+      return { data: [], error: null };
+    }
+  })
+};

package/templates/js-base/index.js

@@ -1 +0,0 @@
-console.log("Welcome to your new Zerra application!");

package/templates/js-firebase/server.js

@@ -1,3 +0,0 @@
-const { startServer } = require("zerra-core");
-
-startServer(3000);

package/templates/js-mongo/server.js

@@ -1,3 +0,0 @@
-const { startServer } = require("zerra-core");
-
-startServer(3000);

package/templates/js-sql/server.js

@@ -1,3 +0,0 @@
-const { startServer } = require("zerra-core");
-
-startServer(3000);

package/templates/js-supabase/server.js

@@ -1,3 +0,0 @@
-const { startServer } = require("zerra-core");
-
-startServer(3000);