nestcraftx 0.2.5 → 0.3.0

package/utils/generators/application/dtoGenerator.js

@@ -0,0 +1,251 @@
+/**
+ * utils/generators/application/dtoGenerator.js
+ *
+ * Générateur des DTOs (Data Transfer Objects) Create/Update.
+ * Extrait de utils.js — Phase 1B.
+ *
+ * Supporte les modes "full" et "light" via le paramètre `mode` :
+ *   - full  : import Role depuis src/user/domain/enums/role.enum
+ *   - light : import Role depuis src/common/enums/role.enum
+ *
+ * Génère deux classes : Create{Entity}Dto et Update{Entity}Dto
+ * Gère optionnellement les décorateurs Swagger (@ApiProperty etc.)
+ */
+
+const { capitalize, formatType } = require("../../helpers");
+
+/**
+ * Génère le contenu TypeScript des DTOs pour une entité.
+ *
+ * @param {object} entity - L'objet entité { name, fields[] }
+ * @param {boolean} useSwagger - Inclure les décorateurs Swagger
+ * @param {boolean} isAuthDto - Mode Auth DTO (classe unique sans CRUD)
+ * @param {"full"|"light"} mode - Mode d'architecture (impacte l'import de Role)
+ * @returns {Promise<string>} Le code TypeScript des DTOs
+ */
+async function generateDto(
+  entity,
+  useSwagger,
+  isAuthDto = false,
+  mode = "full",
+) {
+  const entityName = capitalize(entity.name);
+  const entityNameLower = entity.name.toLowerCase();
+
+  /* ===============================
+     ENUM IMPORT
+  =============================== */
+  let enumImport = "";
+  if (entityName === "User") {
+    enumImport =
+      mode === "light"
+        ? "\nimport { Role } from 'src/common/enums/role.enum';"
+        : "\nimport { Role } from 'src/user/domain/enums/role.enum';";
+  }
+
+  /* ===============================
+     SWAGGER HELPERS
+  =============================== */
+  const getFieldDescription = (f) => {
+    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", "")}`;
+    return `The ${f.name} of the ${entityNameLower}`;
+  };
+
+  const getExampleForField = (f) => {
+    const fieldName = f.name.toLowerCase();
+    const isArray = f.type.endsWith("[]");
+    const cleanType = f.type.toLowerCase().replace("[]", "");
+
+    const getBaseExample = () => {
+      if (fieldName.includes("email")) return "user@example.com";
+      if (fieldName.includes("password")) return "SecurePass@2024";
+      if (fieldName.includes("token")) return "eyJhbGciOi...";
+      if (fieldName.includes("id") && fieldName !== "id")
+        return "550e8400-e29b-41d4-a716-446655440000";
+      if (fieldName.includes("title") || fieldName.includes("name"))
+        return `${capitalize(entityName)} Example`;
+      if (cleanType === "boolean") return true;
+      if (cleanType === "number" || cleanType === "int") return 42;
+      return `${f.name.toLowerCase()}_val`;
+    };
+
+    const base = getBaseExample();
+    return isArray ? [base, base] : base;
+  };
+
+  /* ===============================
+     FIELD GENERATOR
+  =============================== */
+  const generateFieldLine = (f, optional = false, forceNoSwagger = false) => {
+    if (entityName === "User" && f.name.toLowerCase() === "role") return null;
+
+    const name = f.name;
+    const cleanType = f.type.toLowerCase().replace("[]", "");
+    const isArray = f.type.endsWith("[]");
+
+    const SCALAR_TYPES = [
+      "string",
+      "text",
+      "uuid",
+      "json",
+      "number",
+      "decimal",
+      "int",
+      "float",
+      "boolean",
+      "date",
+    ];
+    if (!SCALAR_TYPES.includes(cleanType)) return null;
+
+    let validators = [];
+    if (optional) validators.push("@IsOptional()");
+    if (name.toLowerCase().includes("email")) validators.push("@IsEmail()");
+    else if (name.toLowerCase().includes("password"))
+      validators.push(
+        "@MinLength(8, { message: 'Password is too short (min 8 characters)' })",
+      );
+
+    switch (cleanType) {
+      case "string":
+      case "text":
+        validators.push(isArray ? "@IsString({ each: true })" : "@IsString()");
+        if (!isArray && !name.toLowerCase().includes("password"))
+          validators.push("@MinLength(2)");
+        break;
+      case "number":
+      case "int":
+      case "float":
+        validators.push(
+          isArray ? "@IsNumber({}, { each: true })" : "@IsNumber()",
+        );
+        break;
+      case "boolean":
+        validators.push(
+          isArray ? "@IsBoolean({ each: true })" : "@IsBoolean()",
+        );
+        break;
+      case "uuid":
+        validators.push("@IsUUID()");
+        break;
+      case "date":
+        validators.push("@IsDateString()");
+        break;
+    }
+    if (isArray) validators.push("@IsArray()");
+
+    let swaggerDecorator = "";
+    if (useSwagger && !forceNoSwagger) {
+      const decorator = optional ? "@ApiPropertyOptional" : "@ApiProperty";
+      const options = JSON.stringify(
+        {
+          example: getExampleForField(f),
+          description: getFieldDescription(f),
+        },
+        null,
+        2,
+      ).replace(/"([^"]+)":/g, "$1:");
+      swaggerDecorator = `${decorator}(${options})\n  `;
+    }
+
+    return `${swaggerDecorator}${validators.join("\n  ")}\n  ${name}${
+      optional ? "?" : "!"
+    }: ${formatType(f.type)};`;
+  };
+
+  /* ======================================================
+      AUTH DTO (Strict & Clean)
+  ====================================================== */
+  if (isAuthDto) {
+    const authFields = entity.fields
+      .map((f) => generateFieldLine(f, false))
+      .filter(Boolean)
+      .join("\n\n  ");
+
+    return `import {
+  IsString, IsInt, IsBoolean, IsEmail, IsArray,
+  IsUUID, IsDateString, MinLength, IsOptional
+} from 'class-validator';
+${useSwagger ? "import { ApiProperty } from '@nestjs/swagger';" : ""}
+
+/**
+ * Auth DTO - Strict contract for authentication
+ */
+export class ${entityName}Dto {
+  ${authFields}
+}
+`;
+  }
+
+  /* ======================================================
+      CRUD DTOs (Create / Update)
+  ====================================================== */
+  const createFields = entity.fields
+    .map((f) => generateFieldLine(f, false))
+    .filter(Boolean)
+    .join("\n\n  ");
+
+  const updateFields = entity.fields
+    .map((f) => generateFieldLine(f, true))
+    .filter(Boolean)
+    .join("\n\n  ");
+
+  // Imports Swagger dynamiques
+  let swaggerImports = ["ApiProperty", "ApiPropertyOptional", "PartialType"];
+  if (entityName === "User") swaggerImports.push("ApiHideProperty");
+
+  return `import {
+  IsOptional, IsString, IsInt, IsBoolean, IsEmail,
+  IsArray, IsUUID, IsDateString, MinLength, IsEnum
+} from 'class-validator';
+${
+  useSwagger
+    ? `import { ${swaggerImports.join(", ")} } from '@nestjs/swagger';`
+    : ""
+}
+${enumImport}
+
+/**
+ * DTO for creating a ${entityName}
+ */
+export class Create${entityName}Dto {
+  ${createFields}
+
+  ${
+    entityName === "User"
+      ? `
+  ${useSwagger ? "@ApiHideProperty()" : ""}
+  @IsOptional()
+  @IsEnum(Role)
+  role: Role = Role.USER;`
+      : ""
+  }
+}
+
+/**
+ * DTO for updating a ${entityName}
+ */
+${
+  useSwagger
+    ? `export class Update${entityName}Dto extends PartialType(Create${entityName}Dto) {}`
+    : `export class Update${entityName}Dto {
+  ${updateFields}
+
+  ${
+    entityName === "User"
+      ? `@IsEnum(Role)
+  @IsOptional()
+  role?: Role;`
+      : ""
+  }
+}`
+}
+`;
+}
+
+module.exports = { generateDto };

package/utils/generators/application/dtoUpdater.js

@@ -0,0 +1,54 @@
+// src/utils/generators/application/dtoUpdater.js
+const fs = require("fs");
+const { updateFile, capitalize } = require("../../userInput");
+
+async function patchDtoWithRelation(source, targetName, useSwagger, mode) {
+  let dtoPath;
+  if (mode === "full") {
+    dtoPath = `src/${source.toLowerCase()}/application/dtos/${source.toLowerCase()}.dto.ts`;
+  } else {
+    dtoPath = `src/${source.toLowerCase()}/dtos/${source.toLowerCase()}.dto.ts`;
+  }
+  const targetLow = targetName.toLowerCase();
+  const targetCap = capitalize(targetName);
+
+  // 1. Préparation du bloc de code selon Swagger
+  let fieldCode = "";
+
+  if (useSwagger) {
+    fieldCode = `
+  @ApiProperty({
+    example: '550e8400-e29b-41d4-a716-446655440000',
+    description: 'The unique identifier of the related ${targetCap}',
+  })
+  @IsUUID()
+  ${targetLow}Id!: string;`;
+  } else {
+    fieldCode = `
+  @IsUUID()
+  ${targetLow}Id!: string;`;
+  }
+
+  // 2. Injection dans CreateDto
+  // On injecte juste après l'ouverture de la classe
+  await updateFile({
+    path: dtoPath,
+    pattern: new RegExp(`export class Create${capitalize(source)}Dto {`),
+    replacement: `export class Create${capitalize(source)}Dto {${fieldCode}\n`,
+  });
+
+  // 3. Injection dans UpdateDto (Optionnel mais recommandé si non géré par PartialType)
+  // Si ton UpdateDto n'utilise pas PartialType(CreateDto), il faut aussi patcher l'Update
+  const fileContent = fs.readFileSync(dtoPath, "utf8");
+  if (!fileContent.includes("extends PartialType")) {
+    const updateFieldCode = fieldCode
+      .replace("@IsUUID()", "@IsOptional()\n  @IsUUID()")
+      .replace("Id!: string", "Id?: string");
+    await updateFile({
+      path: dtoPath,
+      pattern: new RegExp(`export class Update${capitalize(source)}Dto {`),
+      replacement: `export class Update${capitalize(source)}Dto {${updateFieldCode}\n`,
+    });
+  }
+}
+module.exports = { patchDtoWithRelation };