nestcraftx 0.4.0 → 1.0.0

package/utils/fullModeInput.js

@@ -211,6 +211,8 @@ async function getFullModeInputs(projectName, flags) {
     { name: "auth", default: true, prompt: "Add JWT authentication?" },
 
     { name: "swagger", default: true, prompt: "Install Swagger?" },
+
+    { name: "throttler", default: true, prompt: "Enable Rate Limiting (Throttler)?" },
   ];
 
   const booleanResults = {};
@@ -239,6 +241,7 @@ async function getFullModeInputs(projectName, flags) {
   const useDocker = booleanResults.docker;
   const useAuth = booleanResults.auth;
   const useSwagger = booleanResults.swagger;
+  const useThrottler = booleanResults.throttler;
 
   // --- 5. Swagger Configuration (Prioritize flags) ---
   let swaggerInputs;
@@ -357,6 +360,7 @@ async function getFullModeInputs(projectName, flags) {
     useDocker,
     useAuth,
     useSwagger,
+    useThrottler,
     swaggerInputs,
     packageManager,
     entitiesData,

package/utils/generators/application/dtoGenerator.js

@@ -47,13 +47,30 @@ async function generateDto(
      SWAGGER HELPERS
   =============================== */
   const getFieldDescription = (f) => {
+    if (f.description) return f.description;
+
     const name = f.name.toLowerCase();
     if (name.includes("email")) return "The official email address of the user";
     if (name.includes("password"))
       return "Must contain at least 8 characters, one letter and one number";
     if (name.includes("token")) return "Authentication token";
-    if (name.includes("id") && name !== "id")
-      return `Unique identifier of the related ${name.replace("id", "")}`;
+    if (name.endsWith("id") && name !== "id")
+      return `UUID of the referenced ${capitalize(f.name.slice(0, -2))}`;
+    if (name.endsWith("ids"))
+      return `Array of UUIDs of the referenced ${capitalize(f.name.slice(0, -3))}`;
+
+    const cleanType = f.type.toLowerCase().replace("[]", "");
+    if (cleanType === "date" || name.endsWith("date") || name.endsWith("at")) {
+      return "ISO 8601 date string (e.g. 2026-06-16T15:00:00Z)";
+    }
+    if (name.includes("price") || name.includes("amount")) {
+      return "Decimal value in USD (e.g. 99.99)";
+    }
+    if (cleanType === "boolean") {
+      const defSuffix = f.default !== undefined && f.default !== null ? ` — default: ${f.default}` : "";
+      return `true/false flag${defSuffix}`;
+    }
+
     return `The ${f.name} of the ${entityNameLower}`;
   };
 
@@ -229,7 +246,7 @@ export class Create${entityName}Dto {
 }
 
 /**
- * DTO for updating a ${entityName}
+ * DTO for updating a ${entityName} (All fields are optional)
  */
 ${
   useSwagger

package/utils/generators/cleanModuleGenerator.js

@@ -64,7 +64,7 @@ async function generateCleanModule(name, config, entityData) {
   });
 
   // 4. Génération du Repository (Implementation)
-  await generateRepository(name, config.orm);
+  await generateRepository(name, config.orm, entityData);
 
   // 5. Génération des Use Cases (Create, Get, Update, Delete)
   await generateUseCases(entityPath, entityNameCapitalized, entityNameLower);
@@ -83,10 +83,25 @@ async function generateCleanModule(name, config, entityData) {
     contente: mapperContent,
   });
 
+  if (entityNameLower === "user") {
+    await createDirectory(`${entityPath}/domain/enums`);
+    await createFile({
+      path: `${entityPath}/domain/enums/role.enum.ts`,
+      contente: `// Enumération des rôles utilisateurs
+export enum Role {
+  USER = 'USER',
+  ADMIN = 'ADMIN',
+  SUPER_ADMIN = 'SUPER_ADMIN',
+}
+`,
+    });
+  }
+
   // ÉTAPE RELATIONS : Patching des fichiers si une relation existe
   if (
     entityData.relation &&
-    (entityData.relation.type != "1-n" || entityData.relation.type != "n-n")
+    entityData.relation.type !== "1-n" &&
+    entityData.relation.type !== "n-n"
   ) {
     const { target, type } = entityData.relation;
     logInfo(
@@ -114,6 +129,7 @@ async function generateCleanModule(name, config, entityData) {
     name,
     entityPath,
     config.swagger,
+    config.auth || false,
   );
   await createFile({
     path: `${entityPath}/presentation/controllers/${entityNameLower}.controller.ts`,
@@ -146,6 +162,10 @@ async function generateCleanModule(name, config, entityData) {
 // --- HELPERS DE TEMPLATES (Extraits de ton setup original) ---
 
 function getRepositoryInterfaceTemplate(cap, low) {
+  let findByEmailMethod = "";
+  if (low === "user") {
+    findByEmailMethod = `\n  findByEmail(email: string): Promise<${cap}Entity | null>;`;
+  }
   return `import { Create${cap}Dto, Update${cap}Dto } from 'src/${low}/application/dtos/${low}.dto';
 import { ${cap}Entity } from 'src/${low}/domain/entities/${low}.entity';
 
@@ -154,9 +174,9 @@ export const I${cap}RepositoryName = 'I${cap}Repository';
 export interface I${cap}Repository {
   create(data: Create${cap}Dto): Promise<${cap}Entity>;
   findById(id: string): Promise<${cap}Entity | null>;
-  findAll(): Promise<${cap}Entity[]>;
+  findAll(page?: number, limit?: number, search?: string, sortBy?: string, sortOrder?: string): Promise<{ data: ${cap}Entity[], total: number }>;
   update(id: string, data: Update${cap}Dto): Promise<${cap}Entity | null>;
-  delete(id: string): Promise<void>;
+  delete(id: string): Promise<void>;${findByEmailMethod}
 }`;
 }
 
@@ -237,11 +257,20 @@ export class GetAll${cap}UseCase {
     private readonly repository: I${cap}Repository,
   ) {}
 
-  async execute(): Promise<${cap}Entity[]> {
-    this.logger.log('Requesting all ${cap} records');
-    const results = await this.repository.findAll();
-    this.logger.log(\`Retrieved \${results.length} ${cap}(s)\`);
-    return results;
+  async execute(page: number = 1, limit: number = 10, search?: string, sortBy?: string, sortOrder?: string): Promise<{ data: ${cap}Entity[], meta: { total: number, page: number, limit: number, totalPages: number } }> {
+    this.logger.log(\`Requesting page \${page} of ${cap} records (limit: \${limit}, search: \${search}, sortBy: \${sortBy}, sortOrder: \${sortOrder})\`);
+    const { data, total } = await this.repository.findAll(page, limit, search, sortBy, sortOrder);
+    const totalPages = Math.ceil(total / limit);
+    this.logger.log(\`Retrieved \${data.length} of \${total} ${cap}(s)\`);
+    return {
+      data,
+      meta: {
+        total,
+        page,
+        limit,
+        totalPages,
+      },
+    };
   }
 }`;
         break;
@@ -430,8 +459,8 @@ export class ${entityNameCapitalized}Service {
   async getById(id: string): Promise<${entityNameCapitalized}Entity | null> {
     return await this.getByIdUseCase.execute(id);
   }
-  async getAll(): Promise<${entityNameCapitalized}Entity[]> {
-    return await this.getAllUseCase.execute();
+  async getAll(page: number = 1, limit: number = 10, search?: string, sortBy?: string, sortOrder?: string): Promise<{ data: ${entityNameCapitalized}Entity[], meta: { total: number, page: number, limit: number, totalPages: number } }> {
+    return await this.getAllUseCase.execute(page, limit, search, sortBy, sortOrder);
   }
   async delete(id: string): Promise<void> {
     return await this.deleteUseCase.execute(id);

package/utils/generators/infrastructure/middlewareGenerator.js

@@ -33,42 +33,10 @@ const { createDirectory, createFile, updateFile } = require("../../file-system")
  * @returns {string}
  */
 function getExceptionFilterContent(orm) {
+  let dbSpecificChecks = "";
   if (orm === "prisma") {
-    return `
-import {
-  ExceptionFilter,
-  Catch,
-  ArgumentsHost,
-  HttpException,
-  HttpStatus,
-  Logger,
-} from '@nestjs/common';
-import { Request, Response } from 'express';
-
-@Catch()
-export class AllExceptionsFilter implements ExceptionFilter {
-  private readonly logger = new Logger(AllExceptionsFilter.name);
-
-  catch(exception: unknown, host: ArgumentsHost) {
-    const ctx = host.switchToHttp();
-    const response = ctx.getResponse<Response>();
-    const request = ctx.getRequest<Request>();
-
-    let status = HttpStatus.INTERNAL_SERVER_ERROR;
-    let message: string | string[] = 'Internal server error';
-    let errorDetails: any = null;
-
-    if (exception instanceof HttpException) {
-      status = exception.getStatus();
-      const res = exception.getResponse();
-      if (typeof res === 'string') {
-        message = res;
-      } else if (typeof res === 'object' && res !== null) {
-        const resObj = res as any;
-        message = resObj.message || resObj.error || 'HttpException';
-        errorDetails = resObj;
-      }
-    } else if (
+    dbSpecificChecks = `
+    else if (
       typeof exception === 'object' &&
       exception &&
       exception.constructor &&
@@ -78,75 +46,13 @@ export class AllExceptionsFilter implements ExceptionFilter {
       )
     ) {
       status = HttpStatus.BAD_REQUEST;
-      message = (exception as any).message || 'Prisma error';
+      message = (exception as any).message || 'Prisma database error';
+      errorResponseName = exception.constructor.name;
       errorDetails = exception;
-    } else if (exception instanceof Error) {
-      message = exception.message;
-      errorDetails = {
-        name: exception.name,
-        stack: exception.stack,
-      };
-    } else {
-      message = 'Une erreur inattendue est survenue';
-      errorDetails = exception;
-    }
-
-    if (process.env.NODE_ENV !== 'production') {
-      this.logger.error(
-        \`Exception on \${request.method} \${request.url}\`,
-        JSON.stringify({ message, status, errorDetails, exception }),
-      );
-    }
-
-    response.status(status).json({
-      statusCode: status,
-      timestamp: new Date().toISOString(),
-      path: request.url,
-      method: request.method,
-      message,
-      error: errorDetails,
-    });
-  }
-}
-`.trim();
-  }
-
-  if (orm === "mongoose") {
-    return `
-import {
-  ExceptionFilter,
-  Catch,
-  ArgumentsHost,
-  HttpException,
-  HttpStatus,
-  Logger,
-} from '@nestjs/common';
-import { Request, Response } from 'express';
-
-@Catch()
-export class AllExceptionsFilter implements ExceptionFilter {
-  private readonly logger = new Logger(AllExceptionsFilter.name);
-
-  catch(exception: unknown, host: ArgumentsHost) {
-    const ctx = host.switchToHttp();
-    const response = ctx.getResponse<Response>();
-    const request = ctx.getRequest<Request>();
-
-    let status = HttpStatus.INTERNAL_SERVER_ERROR;
-    let message: string | string[] = 'Internal server error';
-    let errorDetails: any = null;
-
-    if (exception instanceof HttpException) {
-      status = exception.getStatus();
-      const res = exception.getResponse();
-      if (typeof res === 'string') {
-        message = res;
-      } else if (typeof res === 'object' && res !== null) {
-        const resObj = res as any;
-        message = resObj.message || resObj.error || 'HttpException';
-        errorDetails = resObj;
-      }
-    } else if (
+    }`;
+  } else if (orm === "mongoose") {
+    dbSpecificChecks = `
+    else if (
       typeof exception === 'object' &&
       exception &&
       'name' in exception &&
@@ -156,75 +62,78 @@ export class AllExceptionsFilter implements ExceptionFilter {
       )
     ) {
       status = HttpStatus.BAD_REQUEST;
-      message = (exception as any).message || 'MongoDB error';
+      message = (exception as any).message || 'Mongoose database error';
+      errorResponseName = (exception as any).name;
       errorDetails = exception;
-    } else if (exception instanceof Error) {
-      message = exception.message;
-      errorDetails = {
-        name: exception.name,
-        stack: exception.stack,
-      };
-    } else {
-      message = 'Une erreur inattendue est survenue';
+    }`;
+  } else if (orm === "typeorm") {
+    dbSpecificChecks = `
+    else if (
+      typeof exception === 'object' &&
+      exception &&
+      'name' in exception &&
+      (
+        (exception as any).name === 'QueryFailedError' ||
+        (exception as any).name === 'EntityNotFoundError' ||
+        (exception as any).name === 'CannotCreateEntityIdMapError'
+      )
+    ) {
+      status = HttpStatus.BAD_REQUEST;
+      message = (exception as any).message || 'TypeORM database error';
+      errorResponseName = (exception as any).name;
+      errorDetails = exception;
+    }`;
+  } else if (orm === "sequelize") {
+    dbSpecificChecks = `
+    else if (
+      typeof exception === 'object' &&
+      exception &&
+      exception.constructor &&
+      (
+        exception.constructor.name === 'SequelizeDatabaseError' ||
+        exception.constructor.name === 'SequelizeValidationError'
+      )
+    ) {
+      status = HttpStatus.BAD_REQUEST;
+      message = (exception as any).message || 'Sequelize database error';
+      errorResponseName = exception.constructor.name;
+      errorDetails = exception;
+    }`;
+  } else {
+    // fallback global / universal
+    dbSpecificChecks = `
+    // Prisma
+    else if (
+      typeof exception === 'object' &&
+      exception &&
+      exception.constructor &&
+      (
+        exception.constructor.name === 'PrismaClientKnownRequestError' ||
+        exception.constructor.name === 'PrismaClientValidationError'
+      )
+    ) {
+      status = HttpStatus.BAD_REQUEST;
+      message = (exception as any).message || 'Prisma database error';
+      errorResponseName = exception.constructor.name;
       errorDetails = exception;
     }
-
-    if (process.env.NODE_ENV !== 'production') {
-      this.logger.error(
-        \`Exception on \${request.method} \${request.url}\`,
-        JSON.stringify({ message, status, errorDetails, exception }),
-      );
+    // Mongoose/Mongo
+    else if (
+      typeof exception === 'object' &&
+      exception &&
+      'name' in exception &&
+      (
+        (exception as any).name === 'MongoError' ||
+        (exception as any).name === 'MongooseError'
+      )
+    ) {
+      status = HttpStatus.BAD_REQUEST;
+      message = (exception as any).message || 'Mongoose database error';
+      errorResponseName = (exception as any).name;
+      errorDetails = exception;
     }
-
-    response.status(status).json({
-      statusCode: status,
-      timestamp: new Date().toISOString(),
-      path: request.url,
-      method: request.method,
-      message,
-      error: errorDetails,
-    });
-  }
-}
-`.trim();
-  }
-
-  if (orm === "typeorm") {
-    return `
-import {
-  ExceptionFilter,
-  Catch,
-  ArgumentsHost,
-  HttpException,
-  HttpStatus,
-  Logger,
-} from '@nestjs/common';
-import { Request, Response } from 'express';
-
-@Catch()
-export class AllExceptionsFilter implements ExceptionFilter {
-  private readonly logger = new Logger(AllExceptionsFilter.name);
-
-  catch(exception: unknown, host: ArgumentsHost) {
-    const ctx = host.switchToHttp();
-    const response = ctx.getResponse<Response>();
-    const request = ctx.getRequest<Request>();
-
-    let status = HttpStatus.INTERNAL_SERVER_ERROR;
-    let message: string | string[] = 'Internal server error';
-    let errorDetails: any = null;
-
-    if (exception instanceof HttpException) {
-      status = exception.getStatus();
-      const res = exception.getResponse();
-      if (typeof res === 'string') {
-        message = res;
-      } else if (typeof res === 'object' && res !== null) {
-        const resObj = res as any;
-        message = resObj.message || resObj.error || 'HttpException';
-        errorDetails = resObj;
-      }
-    } else if (
+    // TypeORM
+    else if (
       typeof exception === 'object' &&
       exception &&
       'name' in exception &&
@@ -235,75 +144,12 @@ export class AllExceptionsFilter implements ExceptionFilter {
       )
     ) {
       status = HttpStatus.BAD_REQUEST;
-      message = (exception as any).message || 'TypeORM error';
-      errorDetails = exception;
-    } else if (exception instanceof Error) {
-      message = exception.message;
-      errorDetails = {
-        name: exception.name,
-        stack: exception.stack,
-      };
-    } else {
-      message = 'Une erreur inattendue est survenue';
+      message = (exception as any).message || 'TypeORM database error';
+      errorResponseName = (exception as any).name;
       errorDetails = exception;
     }
-
-    if (process.env.NODE_ENV !== 'production') {
-      this.logger.error(
-        \`Exception on \${request.method} \${request.url}\`,
-        JSON.stringify({ message, status, errorDetails, exception }),
-      );
-    }
-
-    response.status(status).json({
-      statusCode: status,
-      timestamp: new Date().toISOString(),
-      path: request.url,
-      method: request.method,
-      message,
-      error: errorDetails,
-    });
-  }
-}
-`.trim();
-  }
-
-  if (orm === "sequelize") {
-    return `
-import {
-  ExceptionFilter,
-  Catch,
-  ArgumentsHost,
-  HttpException,
-  HttpStatus,
-  Logger,
-} from '@nestjs/common';
-import { Request, Response } from 'express';
-
-@Catch()
-export class AllExceptionsFilter implements ExceptionFilter {
-  private readonly logger = new Logger(AllExceptionsFilter.name);
-
-  catch(exception: unknown, host: ArgumentsHost) {
-    const ctx = host.switchToHttp();
-    const response = ctx.getResponse<Response>();
-    const request = ctx.getRequest<Request>();
-
-    let status = HttpStatus.INTERNAL_SERVER_ERROR;
-    let message: string | string[] = 'Internal server error';
-    let errorDetails: any = null;
-
-    if (exception instanceof HttpException) {
-      status = exception.getStatus();
-      const res = exception.getResponse();
-      if (typeof res === 'string') {
-        message = res;
-      } else if (typeof res === 'object' && res !== null) {
-        const resObj = res as any;
-        message = resObj.message || resObj.error || 'HttpException';
-        errorDetails = resObj;
-      }
-    } else if (
+    // Sequelize
+    else if (
       typeof exception === 'object' &&
       exception &&
       exception.constructor &&
@@ -313,40 +159,12 @@ export class AllExceptionsFilter implements ExceptionFilter {
       )
     ) {
       status = HttpStatus.BAD_REQUEST;
-      message = (exception as any).message || 'Sequelize error';
-      errorDetails = exception;
-    } else if (exception instanceof Error) {
-      message = exception.message;
-      errorDetails = {
-        name: exception.name,
-        stack: exception.stack,
-      };
-    } else {
-      message = 'Une erreur inattendue est survenue';
+      message = (exception as any).message || 'Sequelize database error';
+      errorResponseName = exception.constructor.name;
       errorDetails = exception;
-    }
-
-    if (process.env.NODE_ENV !== 'production') {
-      this.logger.error(
-        \`Exception on \${request.method} \${request.url}\`,
-        JSON.stringify({ message, status, errorDetails, exception }),
-      );
-    }
-
-    response.status(status).json({
-      statusCode: status,
-      timestamp: new Date().toISOString(),
-      path: request.url,
-      method: request.method,
-      message,
-      error: errorDetails,
-    });
-  }
-}
-`.trim();
+    }`;
   }
 
-  // Version universelle (multi-ORM / fallback)
   return `
 import {
   ExceptionFilter,
@@ -358,6 +176,15 @@ import {
 } from '@nestjs/common';
 import { Request, Response } from 'express';
 
+export interface ErrorResponse {
+  statusCode: number;
+  timestamp: string;
+  path: string;
+  method: string;
+  message: string | string[];
+  error: string;
+}
+
 @Catch()
 export class AllExceptionsFilter implements ExceptionFilter {
   private readonly logger = new Logger(AllExceptionsFilter.name);
@@ -369,11 +196,13 @@ export class AllExceptionsFilter implements ExceptionFilter {
 
     let status = HttpStatus.INTERNAL_SERVER_ERROR;
     let message: string | string[] = 'Internal server error';
+    let errorResponseName = 'InternalServerError';
     let errorDetails: any = null;
 
     if (exception instanceof HttpException) {
       status = exception.getStatus();
       const res = exception.getResponse();
+      errorResponseName = exception.name || 'HttpException';
       if (typeof res === 'string') {
         message = res;
       } else if (typeof res === 'object' && res !== null) {
@@ -381,51 +210,10 @@ export class AllExceptionsFilter implements ExceptionFilter {
         message = resObj.message || resObj.error || 'HttpException';
         errorDetails = resObj;
       }
-    }
-    // Prisma
-    else if (
-      typeof exception === 'object' &&
-      exception &&
-      exception.constructor &&
-      (
-        exception.constructor.name === 'PrismaClientKnownRequestError' ||
-        exception.constructor.name === 'PrismaClientValidationError'
-      )
-    ) {
-      status = HttpStatus.BAD_REQUEST;
-      message = (exception as any).message || 'Prisma error';
-      errorDetails = exception;
-    }
-    // Mongoose/Mongo
-    else if (
-      typeof exception === 'object' &&
-      exception &&
-      'name' in exception &&
-      (
-        (exception as any).name === 'MongoError' ||
-        (exception as any).name === 'MongooseError'
-      )
-    ) {
-      status = HttpStatus.BAD_REQUEST;
-      message = (exception as any).message || 'MongoDB error';
-      errorDetails = exception;
-    }
-    // Sequelize
-    else if (
-      typeof exception === 'object' &&
-      exception &&
-      exception.constructor &&
-      (
-        exception.constructor.name === 'SequelizeDatabaseError' ||
-        exception.constructor.name === 'SequelizeValidationError'
-      )
-    ) {
-      status = HttpStatus.BAD_REQUEST;
-      message = (exception as any).message || 'Sequelize error';
-      errorDetails = exception;
-    }
+    }${dbSpecificChecks}
     else if (exception instanceof Error) {
       message = exception.message;
+      errorResponseName = exception.name;
       errorDetails = {
         name: exception.name,
         stack: exception.stack,
@@ -436,18 +224,27 @@ export class AllExceptionsFilter implements ExceptionFilter {
     }
 
     this.logger.error(
-      \`Exception on \${request.method} \${request.url}\`,
-      JSON.stringify({ message, status, errorDetails, exception }),
+      \`[\${request.method}] \${request.url} - Error status: \${status}\`,
+      exception instanceof Error ? exception.stack : JSON.stringify(exception),
     );
 
-    response.status(status).json({
+    const isProduction = process.env.NODE_ENV === 'production';
+    const payload: ErrorResponse = {
       statusCode: status,
       timestamp: new Date().toISOString(),
       path: request.url,
       method: request.method,
-      message,
-      error: errorDetails,
-    });
+      message: (status === HttpStatus.INTERNAL_SERVER_ERROR && isProduction)
+        ? 'Internal server error'
+        : message,
+      error: isProduction ? errorResponseName : (errorDetails?.error || errorResponseName),
+    };
+
+    if (!isProduction && errorDetails) {
+      (payload as any).details = errorDetails;
+    }
+
+    response.status(status).json(payload);
   }
 }
 `.trim();