nestcraftx 0.3.0 → 1.0.0

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}`;
   };
 
@@ -88,6 +105,7 @@ async function generateDto(
     const name = f.name;
     const cleanType = f.type.toLowerCase().replace("[]", "");
     const isArray = f.type.endsWith("[]");
+    const isOptional = optional || f.nullable;
 
     const SCALAR_TYPES = [
       "string",
@@ -104,7 +122,7 @@ async function generateDto(
     if (!SCALAR_TYPES.includes(cleanType)) return null;
 
     let validators = [];
-    if (optional) validators.push("@IsOptional()");
+    if (isOptional) validators.push("@IsOptional()");
     if (name.toLowerCase().includes("email")) validators.push("@IsEmail()");
     else if (name.toLowerCase().includes("password"))
       validators.push(
@@ -141,7 +159,7 @@ async function generateDto(
 
     let swaggerDecorator = "";
     if (useSwagger && !forceNoSwagger) {
-      const decorator = optional ? "@ApiPropertyOptional" : "@ApiProperty";
+      const decorator = isOptional ? "@ApiPropertyOptional" : "@ApiProperty";
       const options = JSON.stringify(
         {
           example: getExampleForField(f),
@@ -154,7 +172,7 @@ async function generateDto(
     }
 
     return `${swaggerDecorator}${validators.join("\n  ")}\n  ${name}${
-      optional ? "?" : "!"
+      isOptional ? "?" : "!"
     }: ${formatType(f.type)};`;
   };
 
@@ -169,7 +187,7 @@ async function generateDto(
 
     return `import {
   IsString, IsInt, IsBoolean, IsEmail, IsArray,
-  IsUUID, IsDateString, MinLength, IsOptional
+  IsUUID, IsDateString, MinLength, IsOptional, IsNumber
 } from 'class-validator';
 ${useSwagger ? "import { ApiProperty } from '@nestjs/swagger';" : ""}
 
@@ -200,7 +218,7 @@ export class ${entityName}Dto {
   if (entityName === "User") swaggerImports.push("ApiHideProperty");
 
   return `import {
-  IsOptional, IsString, IsInt, IsBoolean, IsEmail,
+  IsOptional, IsString, IsInt, IsNumber, IsBoolean, IsEmail,
   IsArray, IsUUID, IsDateString, MinLength, IsEnum
 } from 'class-validator';
 ${
@@ -228,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/application/dtoUpdater.js

@@ -3,6 +3,11 @@ const fs = require("fs");
 const { updateFile, capitalize } = require("../../userInput");
 
 async function patchDtoWithRelation(source, targetName, useSwagger, mode) {
+  const isDryRun = process.argv.includes("--dry-run");
+  if (isDryRun) {
+    console.log(`[DRY-RUN] Simulated: patch DTO for ${source} with relation to ${targetName}`);
+    return;
+  }
   let dtoPath;
   if (mode === "full") {
     dtoPath = `src/${source.toLowerCase()}/application/dtos/${source.toLowerCase()}.dto.ts`;

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/domain/entityUpdater.js

@@ -8,6 +8,11 @@ async function updateExistingEntityRelation(
   relationType,
   mode,
 ) {
+  const isDryRun = process.argv.includes("--dry-run");
+  if (isDryRun) {
+    console.log(`[DRY-RUN] Simulated: update existing entity relation between ${targetName} and ${newEntityName}`);
+    return;
+  }
   const targetLow = targetName.toLowerCase();
   const newCap = capitalize(newEntityName);
   const newLow = newEntityName.toLowerCase();

package/utils/generators/infrastructure/mapperUpdater.js

@@ -2,6 +2,11 @@ const { updateFile } = require("../../userInput");
 
 // src/utils/generators/infrastructure/mapperUpdater.js
 async function patchMapperWithRelation(source, targetName, mode = "full") {
+  const isDryRun = process.argv.includes("--dry-run");
+  if (isDryRun) {
+    console.log(`[DRY-RUN] Simulated: patch mapper for ${source} with relation to ${targetName}`);
+    return;
+  }
   const targetLow = targetName.toLowerCase();
 
   if (mode === "full") {