create-backlist 7.3.0 → 7.4.0

package/src/generators/nestjs.js

@@ -1,278 +1,278 @@
-import chalk from 'chalk';
-import { execa } from 'execa';
-import fs from 'fs-extra';
-import path from 'node:path';
-import ejs from 'ejs';
-import { analyzeFrontend } from '../analyzer.js';
-import { renderAndWrite, getTemplatePath } from './template.js';
-
-function safePascalName(name) {
-  const cleaned = String(name || 'Default')
-    .split('?')[0]
-    .replace(/[^a-zA-Z0-9]/g, '');
-  if (!cleaned) return 'Default';
-  return cleaned.charAt(0).toUpperCase() + cleaned.slice(1);
-}
-
-function sanitizeEndpoints(endpoints) {
-  if (!Array.isArray(endpoints)) return [];
-  return endpoints.map((ep) => {
-    const rawPath = String(ep.path || ep.route || '/').split('?')[0];
-    const parts = rawPath.split('/').filter(Boolean).filter((p) => p !== 'api' && !/^v\d+$/i.test(p));
-    const resource = parts[0] || 'Default';
-    const controllerName = safePascalName(resource);
-    return { ...ep, path: rawPath, controllerName };
-  });
-}
-
-export async function generateNestProject(options) {
-  const {
-    projectDir,
-    projectName,
-    frontendSrcDir,
-    dbType,
-    addAuth,
-    addSeeder,
-    extraFeatures = [],
-  } = options;
-
-  try {
-    console.log(chalk.blue('  -> Analyzing frontend for NestJS backend...'));
-    let endpoints = await analyzeFrontend(frontendSrcDir);
-
-    if (Array.isArray(endpoints) && endpoints.length > 0) {
-      console.log(chalk.green(`  -> Found ${endpoints.length} endpoints.`));
-      endpoints = sanitizeEndpoints(endpoints);
-    } else {
-      endpoints = [];
-      console.log(chalk.yellow('  -> No API endpoints found. A basic project will be created.'));
-    }
-
-    // --- Identify Models ---
-    const modelsToGenerate = new Map();
-    endpoints.forEach((ep) => {
-      if (!ep) return;
-      const ctrl = safePascalName(ep.controllerName);
-      if (ctrl === 'Default' || ctrl === 'Auth') return;
-      if (!modelsToGenerate.has(ctrl)) {
-        let fields = [];
-        if (ep.schemaFields) {
-          fields = Object.entries(ep.schemaFields).map(([key, type]) => ({
-            name: key,
-            type,
-            isUnique: key === 'email',
-          }));
-        }
-        modelsToGenerate.set(ctrl, { name: ctrl, fields });
-      }
-    });
-
-    if (addAuth && !modelsToGenerate.has('User')) {
-      modelsToGenerate.set('User', {
-        name: 'User',
-        fields: [
-          { name: 'name', type: 'String' },
-          { name: 'email', type: 'String', isUnique: true },
-          { name: 'password', type: 'String' },
-        ],
-      });
-    }
-
-    // --- Base Scaffolding ---
-    console.log(chalk.blue('  -> Scaffolding NestJS project...'));
-    const srcDir = path.join(projectDir, 'src');
-    await fs.ensureDir(srcDir);
-
-    await fs.copy(getTemplatePath('nestjs/base/main.ts'), path.join(srcDir, 'main.ts'));
-    await fs.copy(getTemplatePath('nestjs/base/app.module.ts'), path.join(srcDir, 'app.module.ts'));
-    await fs.copy(getTemplatePath('nestjs/base/tsconfig.json'), path.join(projectDir, 'tsconfig.json'));
-
-    // --- package.json ---
-    const pkgTpl = await fs.readFile(getTemplatePath('nestjs/partials/package.json.ejs'), 'utf-8');
-    const packageJsonContent = JSON.parse(ejs.render(pkgTpl, { projectName }));
-
-    if (dbType === 'mongoose') {
-      packageJsonContent.dependencies['@nestjs/mongoose'] = '^10.0.2';
-      packageJsonContent.dependencies.mongoose = '^7.6.3';
-    }
-    if (dbType === 'prisma') {
-      packageJsonContent.dependencies['@prisma/client'] = '^5.6.0';
-      packageJsonContent.devDependencies.prisma = '^5.6.0';
-    }
-    if (addAuth) {
-      packageJsonContent.dependencies['@nestjs/jwt'] = '^10.2.0';
-      packageJsonContent.dependencies.bcryptjs = '^2.4.3';
-      packageJsonContent.devDependencies['@types/bcryptjs'] = '^2.4.6';
-    }
-    if (addSeeder) {
-      packageJsonContent.devDependencies['@faker-js/faker'] = '^8.3.1';
-      packageJsonContent.scripts.seed = 'ts-node scripts/seeder.ts';
-    }
-
-    await fs.writeJson(path.join(projectDir, 'package.json'), packageJsonContent, { spaces: 2 });
-
-    // --- nest-cli.json ---
-    await fs.writeJson(path.join(projectDir, 'nest-cli.json'), {
-      "$schema": "https://json.schemastore.org/nest-cli",
-      "collection": "@nestjs/schematics",
-      "sourceRoot": "src",
-      "compilerOptions": { "deleteOutDir": true }
-    }, { spaces: 2 });
-
-    // --- Generate Modules ---
-    const moduleImports = [];
-    const moduleNames = [];
-
-    if (modelsToGenerate.size > 0) {
-      console.log(chalk.blue('  -> Generating NestJS modules (Controller, Service, DTO)...'));
-
-      for (const [modelName, modelData] of modelsToGenerate.entries()) {
-        if (modelName === 'Auth') continue;
-
-        const moduleDir = path.join(srcDir, modelName.toLowerCase());
-        const dtoDir = path.join(moduleDir, 'dto');
-        await fs.ensureDir(dtoDir);
-
-        const tplData = { modelName, dbType, fields: modelData.fields || [] };
-
-        await renderAndWrite(
-          getTemplatePath('nestjs/partials/module.ts.ejs'),
-          path.join(moduleDir, `${modelName.toLowerCase()}.module.ts`),
-          tplData
-        );
-        await renderAndWrite(
-          getTemplatePath('nestjs/partials/controller.ts.ejs'),
-          path.join(moduleDir, `${modelName.toLowerCase()}.controller.ts`),
-          tplData
-        );
-        await renderAndWrite(
-          getTemplatePath('nestjs/partials/service.ts.ejs'),
-          path.join(moduleDir, `${modelName.toLowerCase()}.service.ts`),
-          tplData
-        );
-        await renderAndWrite(
-          getTemplatePath('nestjs/partials/create-dto.ts.ejs'),
-          path.join(dtoDir, `create-${modelName.toLowerCase()}.dto.ts`),
-          tplData
-        );
-        await renderAndWrite(
-          getTemplatePath('nestjs/partials/update-dto.ts.ejs'),
-          path.join(dtoDir, `update-${modelName.toLowerCase()}.dto.ts`),
-          tplData
-        );
-
-        if (dbType === 'mongoose') {
-          await renderAndWrite(
-            getTemplatePath('nestjs/partials/schema.ts.ejs'),
-            path.join(moduleDir, `${modelName.toLowerCase()}.schema.ts`),
-            tplData
-          );
-        }
-
-        moduleImports.push(`import { ${modelName}Module } from './${modelName.toLowerCase()}/${modelName.toLowerCase()}.module';`);
-        moduleNames.push(`${modelName}Module`);
-      }
-    }
-
-    // --- Prisma module ---
-    if (dbType === 'prisma') {
-      const prismaDir = path.join(srcDir, 'prisma');
-      await fs.ensureDir(prismaDir);
-      await renderAndWrite(
-        getTemplatePath('nestjs/partials/prisma.service.ts.ejs'),
-        path.join(prismaDir, 'prisma.service.ts'),
-        {}
-      );
-      const prismaModuleContent = `import { Global, Module } from '@nestjs/common';
-import { PrismaService } from './prisma.service';
-
-@Global()
-@Module({
-  providers: [PrismaService],
-  exports: [PrismaService],
-})
-export class PrismaModule {}
-`;
-      await fs.writeFile(path.join(prismaDir, 'prisma.module.ts'), prismaModuleContent);
-      moduleImports.unshift("import { PrismaModule } from './prisma/prisma.module';");
-      moduleNames.unshift('PrismaModule');
-
-      await fs.ensureDir(path.join(projectDir, 'prisma'));
-      await renderAndWrite(
-        getTemplatePath('js-express/partials/prisma.schema.ejs'),
-        path.join(projectDir, 'prisma', 'schema.prisma'),
-        { models: Array.from(modelsToGenerate.values()) }
-      );
-    }
-
-    // --- Mongoose config in AppModule ---
-    if (dbType === 'mongoose') {
-      moduleImports.unshift("import { MongooseModule } from '@nestjs/mongoose';");
-      moduleNames.unshift(`MongooseModule.forRoot(process.env.MONGO_URI || 'mongodb://127.0.0.1:27017/${projectName}')`);
-    }
-
-    // --- Auth Module ---
-    if (addAuth) {
-      console.log(chalk.blue('  -> Generating Auth module...'));
-      const authDir = path.join(srcDir, 'auth');
-      await fs.ensureDir(authDir);
-
-      await renderAndWrite(
-        getTemplatePath('nestjs/partials/auth.module.ts.ejs'),
-        path.join(authDir, 'auth.module.ts'),
-        { dbType }
-      );
-      await renderAndWrite(
-        getTemplatePath('nestjs/partials/auth.controller.ts.ejs'),
-        path.join(authDir, 'auth.controller.ts'),
-        { dbType }
-      );
-      await renderAndWrite(
-        getTemplatePath('nestjs/partials/auth.service.ts.ejs'),
-        path.join(authDir, 'auth.service.ts'),
-        { dbType }
-      );
-      await renderAndWrite(
-        getTemplatePath('nestjs/partials/jwt-guard.ts.ejs'),
-        path.join(authDir, 'jwt-auth.guard.ts'),
-        {}
-      );
-
-      moduleImports.push("import { AuthModule } from './auth/auth.module';");
-      moduleNames.push('AuthModule');
-    }
-
-    // --- Inject into app.module.ts ---
-    let appModuleContent = await fs.readFile(path.join(srcDir, 'app.module.ts'), 'utf-8');
-    appModuleContent = appModuleContent.replace(
-      '// INJECT:IMPORTS',
-      moduleImports.join('\n')
-    );
-    appModuleContent = appModuleContent.replace(
-      '// INJECT:MODULES',
-      moduleNames.join(',\n    ')
-    );
-    await fs.writeFile(path.join(srcDir, 'app.module.ts'), appModuleContent);
-
-    // --- Install deps ---
-    console.log(chalk.magenta('  -> Installing dependencies... This may take a moment.'));
-    await execa('npm', ['install'], { cwd: projectDir });
-
-    if (dbType === 'prisma') {
-      console.log(chalk.blue('  -> Running `prisma generate`...'));
-      await execa('npx', ['prisma', 'generate'], { cwd: projectDir });
-    }
-
-    // --- .env.example ---
-    let envContent = `PORT=8000\n`;
-    if (dbType === 'mongoose') envContent += `MONGO_URI=mongodb://127.0.0.1:27017/${projectName}\n`;
-    if (dbType === 'prisma') envContent += `DATABASE_URL="postgresql://user:password@localhost:5432/${projectName}?schema=public"\n`;
-    if (addAuth) envContent += 'JWT_SECRET=your_super_secret_jwt_key_12345\nJWT_EXPIRES_IN=5h\n';
-
-    await fs.writeFile(path.join(projectDir, '.env.example'), envContent);
-
-    console.log(chalk.green('  -> NestJS backend generation complete.'));
-  } catch (error) {
-    throw error;
-  }
+import chalk from 'chalk';
+import { execa } from 'execa';
+import fs from 'fs-extra';
+import path from 'node:path';
+import ejs from 'ejs';
+import { analyzeFrontend } from '../analyzer.js';
+import { renderAndWrite, getTemplatePath } from './template.js';
+
+function safePascalName(name) {
+  const cleaned = String(name || 'Default')
+    .split('?')[0]
+    .replace(/[^a-zA-Z0-9]/g, '');
+  if (!cleaned) return 'Default';
+  return cleaned.charAt(0).toUpperCase() + cleaned.slice(1);
+}
+
+function sanitizeEndpoints(endpoints) {
+  if (!Array.isArray(endpoints)) return [];
+  return endpoints.map((ep) => {
+    const rawPath = String(ep.path || ep.route || '/').split('?')[0];
+    const parts = rawPath.split('/').filter(Boolean).filter((p) => p !== 'api' && !/^v\d+$/i.test(p));
+    const resource = parts[0] || 'Default';
+    const controllerName = safePascalName(resource);
+    return { ...ep, path: rawPath, controllerName };
+  });
+}
+
+export async function generateNestProject(options) {
+  const {
+    projectDir,
+    projectName,
+    frontendSrcDir,
+    dbType,
+    addAuth,
+    addSeeder,
+    extraFeatures = [],
+  } = options;
+
+  try {
+    console.log(chalk.blue('  -> Analyzing frontend for NestJS backend...'));
+    let endpoints = await analyzeFrontend(frontendSrcDir);
+
+    if (Array.isArray(endpoints) && endpoints.length > 0) {
+      console.log(chalk.green(`  -> Found ${endpoints.length} endpoints.`));
+      endpoints = sanitizeEndpoints(endpoints);
+    } else {
+      endpoints = [];
+      console.log(chalk.yellow('  -> No API endpoints found. A basic project will be created.'));
+    }
+
+    // --- Identify Models ---
+    const modelsToGenerate = new Map();
+    endpoints.forEach((ep) => {
+      if (!ep) return;
+      const ctrl = safePascalName(ep.controllerName);
+      if (ctrl === 'Default' || ctrl === 'Auth') return;
+      if (!modelsToGenerate.has(ctrl)) {
+        let fields = [];
+        if (ep.schemaFields) {
+          fields = Object.entries(ep.schemaFields).map(([key, type]) => ({
+            name: key,
+            type,
+            isUnique: key === 'email',
+          }));
+        }
+        modelsToGenerate.set(ctrl, { name: ctrl, fields });
+      }
+    });
+
+    if (addAuth && !modelsToGenerate.has('User')) {
+      modelsToGenerate.set('User', {
+        name: 'User',
+        fields: [
+          { name: 'name', type: 'String' },
+          { name: 'email', type: 'String', isUnique: true },
+          { name: 'password', type: 'String' },
+        ],
+      });
+    }
+
+    // --- Base Scaffolding ---
+    console.log(chalk.blue('  -> Scaffolding NestJS project...'));
+    const srcDir = path.join(projectDir, 'src');
+    await fs.ensureDir(srcDir);
+
+    await fs.copy(getTemplatePath('nestjs/base/main.ts'), path.join(srcDir, 'main.ts'));
+    await fs.copy(getTemplatePath('nestjs/base/app.module.ts'), path.join(srcDir, 'app.module.ts'));
+    await fs.copy(getTemplatePath('nestjs/base/tsconfig.json'), path.join(projectDir, 'tsconfig.json'));
+
+    // --- package.json ---
+    const pkgTpl = await fs.readFile(getTemplatePath('nestjs/partials/package.json.ejs'), 'utf-8');
+    const packageJsonContent = JSON.parse(ejs.render(pkgTpl, { projectName }));
+
+    if (dbType === 'mongoose') {
+      packageJsonContent.dependencies['@nestjs/mongoose'] = '^10.0.2';
+      packageJsonContent.dependencies.mongoose = '^7.6.3';
+    }
+    if (dbType === 'prisma') {
+      packageJsonContent.dependencies['@prisma/client'] = '^5.6.0';
+      packageJsonContent.devDependencies.prisma = '^5.6.0';
+    }
+    if (addAuth) {
+      packageJsonContent.dependencies['@nestjs/jwt'] = '^10.2.0';
+      packageJsonContent.dependencies.bcryptjs = '^2.4.3';
+      packageJsonContent.devDependencies['@types/bcryptjs'] = '^2.4.6';
+    }
+    if (addSeeder) {
+      packageJsonContent.devDependencies['@faker-js/faker'] = '^8.3.1';
+      packageJsonContent.scripts.seed = 'ts-node scripts/seeder.ts';
+    }
+
+    await fs.writeJson(path.join(projectDir, 'package.json'), packageJsonContent, { spaces: 2 });
+
+    // --- nest-cli.json ---
+    await fs.writeJson(path.join(projectDir, 'nest-cli.json'), {
+      "$schema": "https://json.schemastore.org/nest-cli",
+      "collection": "@nestjs/schematics",
+      "sourceRoot": "src",
+      "compilerOptions": { "deleteOutDir": true }
+    }, { spaces: 2 });
+
+    // --- Generate Modules ---
+    const moduleImports = [];
+    const moduleNames = [];
+
+    if (modelsToGenerate.size > 0) {
+      console.log(chalk.blue('  -> Generating NestJS modules (Controller, Service, DTO)...'));
+
+      for (const [modelName, modelData] of modelsToGenerate.entries()) {
+        if (modelName === 'Auth') continue;
+
+        const moduleDir = path.join(srcDir, modelName.toLowerCase());
+        const dtoDir = path.join(moduleDir, 'dto');
+        await fs.ensureDir(dtoDir);
+
+        const tplData = { modelName, dbType, fields: modelData.fields || [] };
+
+        await renderAndWrite(
+          getTemplatePath('nestjs/partials/module.ts.ejs'),
+          path.join(moduleDir, `${modelName.toLowerCase()}.module.ts`),
+          tplData
+        );
+        await renderAndWrite(
+          getTemplatePath('nestjs/partials/controller.ts.ejs'),
+          path.join(moduleDir, `${modelName.toLowerCase()}.controller.ts`),
+          tplData
+        );
+        await renderAndWrite(
+          getTemplatePath('nestjs/partials/service.ts.ejs'),
+          path.join(moduleDir, `${modelName.toLowerCase()}.service.ts`),
+          tplData
+        );
+        await renderAndWrite(
+          getTemplatePath('nestjs/partials/create-dto.ts.ejs'),
+          path.join(dtoDir, `create-${modelName.toLowerCase()}.dto.ts`),
+          tplData
+        );
+        await renderAndWrite(
+          getTemplatePath('nestjs/partials/update-dto.ts.ejs'),
+          path.join(dtoDir, `update-${modelName.toLowerCase()}.dto.ts`),
+          tplData
+        );
+
+        if (dbType === 'mongoose') {
+          await renderAndWrite(
+            getTemplatePath('nestjs/partials/schema.ts.ejs'),
+            path.join(moduleDir, `${modelName.toLowerCase()}.schema.ts`),
+            tplData
+          );
+        }
+
+        moduleImports.push(`import { ${modelName}Module } from './${modelName.toLowerCase()}/${modelName.toLowerCase()}.module';`);
+        moduleNames.push(`${modelName}Module`);
+      }
+    }
+
+    // --- Prisma module ---
+    if (dbType === 'prisma') {
+      const prismaDir = path.join(srcDir, 'prisma');
+      await fs.ensureDir(prismaDir);
+      await renderAndWrite(
+        getTemplatePath('nestjs/partials/prisma.service.ts.ejs'),
+        path.join(prismaDir, 'prisma.service.ts'),
+        {}
+      );
+      const prismaModuleContent = `import { Global, Module } from '@nestjs/common';
+import { PrismaService } from './prisma.service';
+
+@Global()
+@Module({
+  providers: [PrismaService],
+  exports: [PrismaService],
+})
+export class PrismaModule {}
+`;
+      await fs.writeFile(path.join(prismaDir, 'prisma.module.ts'), prismaModuleContent);
+      moduleImports.unshift("import { PrismaModule } from './prisma/prisma.module';");
+      moduleNames.unshift('PrismaModule');
+
+      await fs.ensureDir(path.join(projectDir, 'prisma'));
+      await renderAndWrite(
+        getTemplatePath('js-express/partials/prisma.schema.ejs'),
+        path.join(projectDir, 'prisma', 'schema.prisma'),
+        { models: Array.from(modelsToGenerate.values()) }
+      );
+    }
+
+    // --- Mongoose config in AppModule ---
+    if (dbType === 'mongoose') {
+      moduleImports.unshift("import { MongooseModule } from '@nestjs/mongoose';");
+      moduleNames.unshift(`MongooseModule.forRoot(process.env.MONGO_URI || 'mongodb://127.0.0.1:27017/${projectName}')`);
+    }
+
+    // --- Auth Module ---
+    if (addAuth) {
+      console.log(chalk.blue('  -> Generating Auth module...'));
+      const authDir = path.join(srcDir, 'auth');
+      await fs.ensureDir(authDir);
+
+      await renderAndWrite(
+        getTemplatePath('nestjs/partials/auth.module.ts.ejs'),
+        path.join(authDir, 'auth.module.ts'),
+        { dbType }
+      );
+      await renderAndWrite(
+        getTemplatePath('nestjs/partials/auth.controller.ts.ejs'),
+        path.join(authDir, 'auth.controller.ts'),
+        { dbType }
+      );
+      await renderAndWrite(
+        getTemplatePath('nestjs/partials/auth.service.ts.ejs'),
+        path.join(authDir, 'auth.service.ts'),
+        { dbType }
+      );
+      await renderAndWrite(
+        getTemplatePath('nestjs/partials/jwt-guard.ts.ejs'),
+        path.join(authDir, 'jwt-auth.guard.ts'),
+        {}
+      );
+
+      moduleImports.push("import { AuthModule } from './auth/auth.module';");
+      moduleNames.push('AuthModule');
+    }
+
+    // --- Inject into app.module.ts ---
+    let appModuleContent = await fs.readFile(path.join(srcDir, 'app.module.ts'), 'utf-8');
+    appModuleContent = appModuleContent.replace(
+      '// INJECT:IMPORTS',
+      moduleImports.join('\n')
+    );
+    appModuleContent = appModuleContent.replace(
+      '// INJECT:MODULES',
+      moduleNames.join(',\n    ')
+    );
+    await fs.writeFile(path.join(srcDir, 'app.module.ts'), appModuleContent);
+
+    // --- Install deps ---
+    console.log(chalk.magenta('  -> Installing dependencies... This may take a moment.'));
+    await execa('npm', ['install'], { cwd: projectDir });
+
+    if (dbType === 'prisma') {
+      console.log(chalk.blue('  -> Running `prisma generate`...'));
+      await execa('npx', ['prisma', 'generate'], { cwd: projectDir });
+    }
+
+    // --- .env.example ---
+    let envContent = `PORT=8000\n`;
+    if (dbType === 'mongoose') envContent += `MONGO_URI=mongodb://127.0.0.1:27017/${projectName}\n`;
+    if (dbType === 'prisma') envContent += `DATABASE_URL="postgresql://user:password@localhost:5432/${projectName}?schema=public"\n`;
+    if (addAuth) envContent += 'JWT_SECRET=your_super_secret_jwt_key_12345\nJWT_EXPIRES_IN=5h\n';
+
+    await fs.writeFile(path.join(projectDir, '.env.example'), envContent);
+
+    console.log(chalk.green('  -> NestJS backend generation complete.'));
+  } catch (error) {
+    throw error;
+  }
 }