create-backlist 3.0.0 → 4.0.0

package/bin/index.js

@@ -34,19 +34,26 @@ async function main() {
       ],
     },
     {
-        type: 'input',
-        name: 'srcPath',
-        message: 'Enter the path to your frontend `src` directory:',
-        default: 'src',
+      type: 'input',
+      name: 'srcPath',
+      message: 'Enter the path to your frontend `src` directory:',
+      default: 'src',
     },
-    // --- NEW QUESTION FOR V3.0 ---
     {
       type: 'confirm',
       name: 'addAuth',
       message: 'Do you want to add basic JWT authentication? (generates a User model, login/register routes)',
       default: true,
-      // This question will only be asked if the user selects the Node.js stack
       when: (answers) => answers.stack === 'node-ts-express'
+    },
+    // --- NEW QUESTION FOR V4.0 ---
+    {
+      type: 'confirm',
+      name: 'addSeeder',
+      message: 'Do you want to add a database seeder with sample user data?',
+      default: true,
+      // Only ask this if Node.js is selected AND authentication is being added
+      when: (answers) => answers.stack === 'node-ts-express' && answers.addAuth
     }
   ]);
 
@@ -71,7 +78,6 @@ async function main() {
           throw new Error('.NET SDK is not installed. Please install it from https://dotnet.microsoft.com/download');
         }
         await generateDotnetProject(options);
-
         break;
       
       default:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-backlist",
-  "version": "3.0.0",
+  "version": "4.0.0",
   "description": "An advanced, multi-language backend generator based on frontend analysis.",
   "type": "commonjs",
   "bin": {

package/src/generators/node.js

@@ -6,7 +6,8 @@ const { analyzeFrontend } = require('../analyzer');
 const { renderAndWrite, getTemplatePath } = require('./template');
 
 async function generateNodeProject(options) {
-  const { projectDir, projectName, frontendSrcDir, addAuth } = options;
+  // v4.0: Destructure the new 'addSeeder' option
+  const { projectDir, projectName, frontendSrcDir, addAuth, addSeeder } = options;
 
   try {
     // --- Step 1: Analyze Frontend to get Endpoints and Schema Info ---
@@ -26,7 +27,6 @@ async function generateNodeProject(options) {
       }
     });
 
-    // If auth is enabled, we MUST have a 'User' model.
     if (addAuth && !modelsToGenerate.has('User')) {
       console.log(chalk.yellow('  -> Authentication requires a "User" model. Creating a default one.'));
       modelsToGenerate.set('User', { name: 'String', email: 'String', password: 'String' });
@@ -39,7 +39,7 @@ async function generateNodeProject(options) {
     await fs.copy(getTemplatePath('node-ts-express/base/server.ts'), path.join(destSrcDir, 'server.ts'));
     await fs.copy(getTemplatePath('node-ts-express/base/tsconfig.json'), path.join(projectDir, 'tsconfig.json'));
     
-    // --- Step 4: Prepare and Write package.json ---
+    // --- Step 4: Prepare and Write package.json with all conditional dependencies ---
     const packageJsonContent = JSON.parse(
       await ejs.renderFile(getTemplatePath('node-ts-express/partials/package.json.ejs'), { projectName })
     );
@@ -53,112 +53,90 @@ async function generateNodeProject(options) {
       packageJsonContent.devDependencies['@types/jsonwebtoken'] = '^9.0.2';
       packageJsonContent.devDependencies['@types/bcryptjs'] = '^2.4.2';
     }
+    // v4.0: Add seeder dependencies and scripts
+    if (addSeeder) {
+      packageJsonContent.devDependencies['@faker-js/faker'] = '^8.2.0';
+      // We also need chalk for the seeder script's console logs
+      packageJsonContent.dependencies['chalk'] = '^4.1.2';
+      packageJsonContent.scripts['seed'] = 'ts-node scripts/seeder.ts';
+      packageJsonContent.scripts['destroy'] = 'ts-node scripts/seeder.ts -d';
+    }
     await fs.writeJson(path.join(projectDir, 'package.json'), packageJsonContent, { spaces: 2 });
     
-    // --- Step 5: Generate Models and Controllers ---
+    // --- Step 5 & 6: Generate Models, Controllers, and Auth boilerplate ---
     if (modelsToGenerate.size > 0) {
-      console.log(chalk.blue('  -> Generating database models and controllers...'));
-      await fs.ensureDir(path.join(destSrcDir, 'models'));
-      await fs.ensureDir(path.join(destSrcDir, 'controllers'));
-
-      for (let [modelName, schema] of modelsToGenerate.entries()) {
-        if (addAuth && modelName === 'User') {
-          schema = { name: 'String', email: 'String', password: 'String', ...schema };
+        console.log(chalk.blue('  -> Generating database models and controllers...'));
+        await fs.ensureDir(path.join(destSrcDir, 'models'));
+        await fs.ensureDir(path.join(destSrcDir, 'controllers'));
+        for (let [modelName, schema] of modelsToGenerate.entries()) {
+            if (addAuth && modelName === 'User') {
+                schema = { name: 'String', email: 'String', password: 'String', ...schema };
+            }
+            await renderAndWrite(getTemplatePath('node-ts-express/partials/Model.ts.ejs'), path.join(destSrcDir, 'models', `${modelName}.model.ts`), { modelName, schema });
+            await renderAndWrite(getTemplatePath('node-ts-express/partials/Controller.ts.ejs'), path.join(destSrcDir, 'controllers', `${modelName}.controller.ts`), { modelName });
         }
-        await renderAndWrite(
-          getTemplatePath('node-ts-express/partials/Model.ts.ejs'),
-          path.join(destSrcDir, 'models', `${modelName}.model.ts`),
-          { modelName, schema }
-        );
-        await renderAndWrite(
-          getTemplatePath('node-ts-express/partials/Controller.ts.ejs'),
-          path.join(destSrcDir, 'controllers', `${modelName}.controller.ts`),
-          { modelName }
-        );
-      }
     }
-    
-    // --- Step 6 (v3.0): Generate Authentication Boilerplate ---
     if (addAuth) {
         console.log(chalk.blue('  -> Generating authentication boilerplate...'));
         await fs.ensureDir(path.join(destSrcDir, 'routes'));
         await fs.ensureDir(path.join(destSrcDir, 'middleware'));
-
         await renderAndWrite(getTemplatePath('node-ts-express/partials/Auth.controller.ts.ejs'), path.join(destSrcDir, 'controllers', 'Auth.controller.ts'), {});
         await renderAndWrite(getTemplatePath('node-ts-express/partials/Auth.routes.ts.ejs'), path.join(destSrcDir, 'routes', 'Auth.routes.ts'), {});
         await renderAndWrite(getTemplatePath('node-ts-express/partials/Auth.middleware.ts.ejs'), path.join(destSrcDir, 'middleware', 'Auth.middleware.ts'), {});
 
-        // Modify the User model to add password hashing
         const userModelPath = path.join(destSrcDir, 'models', 'User.model.ts');
         if (await fs.pathExists(userModelPath)) {
             let userModelContent = await fs.readFile(userModelPath, 'utf-8');
             if (!userModelContent.includes('bcryptjs')) {
                 userModelContent = userModelContent.replace(`import mongoose, { Schema, Document } from 'mongoose';`, `import mongoose, { Schema, Document } from 'mongoose';\nimport bcrypt from 'bcryptjs';`);
-                const preSaveHook = `
-// Hash password before saving
-UserSchema.pre('save', async function(next) {
-  if (!this.isModified('password')) {
-    return next();
-  }
-  const salt = await bcrypt.genSalt(10);
-  this.password = await bcrypt.hash(this.password, salt);
-  next();
-});
-`;
+                const preSaveHook = `\n// Hash password before saving\nUserSchema.pre('save', async function(next) {\n  if (!this.isModified('password')) {\n    return next();\n  }\n  const salt = await bcrypt.genSalt(10);\n  this.password = await bcrypt.hash(this.password, salt);\n  next();\n});\n`;
                 userModelContent = userModelContent.replace(`// Create and export the Model`, `${preSaveHook}\n// Create and export the Model`);
                 await fs.writeFile(userModelPath, userModelContent);
             }
         }
     }
 
-    // --- Step 7: Generate the Main Route File ---
+    // --- Step 7 (v4.0): Generate Seeder Script ---
+    if (addSeeder) {
+      console.log(chalk.blue('  -> Generating database seeder script...'));
+      await fs.ensureDir(path.join(projectDir, 'scripts'));
+      await renderAndWrite(
+        getTemplatePath('node-ts-express/partials/Seeder.ts.ejs'),
+        path.join(projectDir, 'scripts', 'seeder.ts'),
+        { projectName }
+      );
+    }
+
+    // --- Step 8: Generate the Main Route File ---
     console.log(chalk.gray('    -> Generating dynamic API routes...'));
     await renderAndWrite(getTemplatePath('node-ts-express/partials/routes.ts.ejs'), path.join(destSrcDir, 'routes.ts'), { endpoints, addAuth });
     
-    // --- Step 8: Inject Logic into Main Server File ---
+    // --- Step 9: Inject Logic into Main Server File ---
     let serverFileContent = await fs.readFile(path.join(destSrcDir, 'server.ts'), 'utf-8');
-    
     let dbConnectionCode = '';
     if (modelsToGenerate.size > 0 || addAuth) {
-      dbConnectionCode = `
-// --- Database Connection ---
-import mongoose from 'mongoose';
-const MONGO_URI = process.env.MONGO_URI || 'mongodb://127.0.0.1:27017/${projectName}';
-mongoose.connect(MONGO_URI)
-  .then(() => console.log('MongoDB Connected...'))
-  .catch(err => console.error('MongoDB Connection Error:', err));
-// -------------------------
-`;
+      dbConnectionCode = `\n// --- Database Connection ---\nimport mongoose from 'mongoose';\nconst MONGO_URI = process.env.MONGO_URI || 'mongodb://127.0.0.1:27017/${projectName}';\nmongoose.connect(MONGO_URI)\n  .then(() => console.log('MongoDB Connected...'))\n  .catch(err => console.error('MongoDB Connection Error:', err));\n// -------------------------\n`;
     }
-
     let authRoutesInjector = '';
     if (addAuth) {
-        authRoutesInjector = `import authRoutes from './routes/Auth.routes';\napp.use('/api/auth', authRoutes);\n\n`;
+      authRoutesInjector = `import authRoutes from './routes/Auth.routes';\napp.use('/api/auth', authRoutes);\n\n`;
     }
-
     serverFileContent = serverFileContent
-      .replace("dotenv.config();", `dotenv.config();\n${dbConnectionCode}`)
-      .replace('// INJECT:ROUTES', `${authRoutesInjector}import apiRoutes from './routes';\napp.use('/api', apiRoutes);`); // Changed to /api
-      
+      .replace("dotenv.config();", `dotenv.config();${dbConnectionCode}`)
+      .replace('// INJECT:ROUTES', `${authRoutesInjector}import apiRoutes from './routes';\napp.use('/api', apiRoutes);`);
     await fs.writeFile(path.join(destSrcDir, 'server.ts'), serverFileContent);
 
-    // --- Step 9: Install All Dependencies ---
+    // --- Step 10: Install All Dependencies ---
     console.log(chalk.magenta('  -> Installing all dependencies... This might take a moment.'));
     await execa('npm', ['install'], { cwd: projectDir });
 
-    // --- Step 10: Generate Final Files (README, .env.example) ---
-    await renderAndWrite(
-      getTemplatePath('node-ts-express/partials/README.md.ejs'),
-      path.join(projectDir, 'README.md'),
-      { projectName }
-    );
-    
+    // --- Step 11: Generate Final Files (README, .env.example) ---
+    await renderAndWrite(getTemplatePath('node-ts-express/partials/README.md.ejs'), path.join(projectDir, 'README.md'), { projectName });
     if (addAuth) {
-        const envExampleContent = `PORT=8000\nMONGO_URI=mongodb://127.0.0.1:27017/${projectName}\nJWT_SECRET=your_super_secret_jwt_key_123`;
-        await fs.writeFile(path.join(projectDir, '.env.example'), envExampleContent);
+      const envExampleContent = `PORT=8000\nMONGO_URI=mongodb://127.0.0.1:27017/${projectName}\nJWT_SECRET=your_super_secret_jwt_key_123`;
+      await fs.writeFile(path.join(projectDir, '.env.example'), envExampleContent);
     }
 
-
   } catch (error) {
     throw error;
   }

package/src/templates/node-ts-express/partials/Controller.ts.ejs

@@ -9,6 +9,9 @@ export const create<%= modelName %> = async (req: Request, res: Response) => {
     await newDoc.save();
     res.status(201).json(newDoc);
   } catch (error) {
+    if (error.name === 'ValidationError') {
+        return res.status(400).json({ message: 'Validation Error', errors: error.errors });
+    }
     res.status(500).json({ message: 'Error creating document', error });
   }
 };
@@ -41,6 +44,9 @@ export const update<%= modelName %>ById = async (req: Request, res: Response) =>
     if (!doc) return res.status(404).json({ message: 'Document not found' });
     res.status(200).json(doc);
   } catch (error) {
+    if (error.name === 'ValidationError') {
+        return res.status(400).json({ message: 'Validation Error', errors: error.errors });
+    }
     res.status(500).json({ message: 'Error updating document', error });
   }
 };
@@ -50,6 +56,7 @@ export const delete<%= modelName %>ById = async (req: Request, res: Response) =>
   try {
     const doc = await <%= modelName %>.findByIdAndDelete(req.params.id);
     if (!doc) return res.status(404).json({ message: 'Document not found' });
+    // For DELETE, it's common to return a success message or just a 204 No Content status.
     res.status(200).json({ message: 'Document deleted successfully' });
   } catch (error) {
     res.status(500).json({ message: 'Error deleting document', error });

package/src/templates/node-ts-express/partials/Seeder.ts.ejs

@@ -0,0 +1,83 @@
+// Auto-generated by create-backlist v4.0 on <%= new Date().toISOString() %>
+import mongoose from 'mongoose';
+import dotenv from 'dotenv';
+import { faker } from '@faker-js/faker';
+import chalk from 'chalk'; // For colorful console logs
+
+// Load env vars
+dotenv.config();
+
+// We assume a User model exists for seeding.
+// The path is relative to the generated 'backend' project root.
+import User from '../src/models/User.model';
+
+// --- Connect to DB ---
+const connectDB = async () => {
+  try {
+    const MONGO_URI = process.env.MONGO_URI || 'mongodb://127.0.0.1:27017/<%= projectName %>';
+    if (!MONGO_URI) {
+        throw new Error('MONGO_URI is not defined in your .env file');
+    }
+    await mongoose.connect(MONGO_URI);
+    console.log(chalk.green('MongoDB Connected for Seeder...'));
+  } catch (err) {
+    console.error(chalk.red(`Seeder DB Connection Error: ${err.message}`));
+    process.exit(1);
+  }
+};
+
+// --- Import Data ---
+const importData = async () => {
+  try {
+    // Clear existing data
+    await User.deleteMany();
+
+    const sampleUsers = [];
+    const userCount = 10; // Number of sample users to create
+
+    for (let i = 0; i < userCount; i++) {
+      sampleUsers.push({
+        name: faker.person.fullName(),
+        email: faker.internet.email().toLowerCase(),
+        password: 'password123', // All sample users will have the same password for easy testing
+      });
+    }
+
+    await User.insertMany(sampleUsers);
+
+    console.log(chalk.green.bold('✅ Data Imported Successfully!'));
+    process.exit();
+  } catch (error) {
+    console.error(chalk.red(`Error with data import: ${error.message}`));
+    process.exit(1);
+  }
+};
+
+// --- Destroy Data ---
+const destroyData = async () => {
+  try {
+    await User.deleteMany();
+    // If you have other models, you can add them here for destruction
+    // e.g., await Product.deleteMany();
+
+    console.log(chalk.red.bold('🔥 Data Destroyed Successfully!'));
+    process.exit();
+  } catch (error) {
+    console.error(chalk.red(`Error with data destruction: ${error.message}`));
+    process.exit(1);
+  }
+};
+
+// --- CLI Logic to run the seeder ---
+const runSeeder = async () => {
+  await connectDB();
+
+  // process.argv[2] will be '-d' if the script is run with `npm run destroy`
+  if (process.argv[2] === '-d') {
+    await destroyData();
+  } else {
+    await importData();
+  }
+};
+
+runSeeder();