nestforge-generator 0.3.0 → 0.4.0

package/templates/typeorm/src/health/indicators/typeorm-health.indicator.ts

@@ -24,7 +24,7 @@ export class TypeOrmHealthIndicator {
             };
         } catch (error) {
             throw new HealthCheckError(
-                'Banco de dados indisponível',
+                'Database unavailable',
                 {
                     [key]: {
                         status: 'down',
@@ -34,4 +34,4 @@ export class TypeOrmHealthIndicator {
             );
         }
     }
-}
+}

package/templates/typeorm/src/mail/mail.processor.ts

@@ -27,13 +27,13 @@ export class MailProcessor extends WorkerHost {
 
         switch (job.name) {
             case MailJob.VerifyEmail:
-                await this.send(to, 'Confirme seu e-mail', verifyEmailTemplate(name, token));
+                await this.send(to, 'Confirm your email', verifyEmailTemplate(name, token));
                 break;
             case MailJob.ResetPassword:
-                await this.send(to, 'Redefinição de senha', resetPasswordTemplate(name, token));
+                await this.send(to, 'Password reset', resetPasswordTemplate(name, token));
                 break;
             default:
-                this.logger.warn(`Job de e-mail desconhecido: ${job.name}`);
+                this.logger.warn(`Unknown email job: ${job.name}`);
         }
     }
 
@@ -45,4 +45,4 @@ export class MailProcessor extends WorkerHost {
             html,
         });
     }
-}
+}

package/templates/typeorm/src/mail/templates/email-templates.ts

@@ -6,10 +6,10 @@ export function verifyEmailTemplate(name: string, token: string): string {
 
     return `
     <div style="font-family: sans-serif; line-height: 1.5;">
-      <h2>Olá, ${name}!</h2>
-      <p>Confirme seu e-mail clicando no link abaixo:</p>
+      <h2>Hello, ${name}!</h2>
+      <p>Confirm your email by clicking the link below:</p>
       <p><a href="${link}">${link}</a></p>
-      <p>Esse link expira em 24 horas.</p>
+      <p>This link expires in 24 hours.</p>
     </div>
   `;
 }
@@ -19,10 +19,10 @@ export function resetPasswordTemplate(name: string, token: string): string {
 
     return `
     <div style="font-family: sans-serif; line-height: 1.5;">
-      <h2>Olá, ${name}!</h2>
-      <p>Recebemos um pedido para redefinir sua senha. Clique no link abaixo para continuar:</p>
+      <h2>Hello, ${name}!</h2>
+      <p>We received a request to reset your password. Click the link below to continue:</p>
       <p><a href="${link}">${link}</a></p>
-      <p>Se você não pediu isso, pode ignorar este e-mail. O link expira em 1 hora.</p>
+      <p>If you did not request this, you can ignore this email. The link expires in 1 hour.</p>
     </div>
   `;
-}
+}

package/templates/typeorm/src/metrics/metrics.service.ts

@@ -7,7 +7,7 @@ export class MetricsService {
 
     readonly httpRequestDuration = new client.Histogram({
         name: 'http_request_duration_seconds',
-        help: 'Duração das requisições HTTP em segundos',
+        help: 'HTTP request duration in seconds',
         labelNames: ['method', 'route', 'status_code'],
         buckets: [0.05, 0.1, 0.3, 0.5, 1, 2, 5],
         registers: [this.registry],
@@ -15,7 +15,7 @@ export class MetricsService {
 
     readonly httpRequestsTotal = new client.Counter({
         name: 'http_requests_total',
-        help: 'Total de requisições HTTP recebidas',
+        help: 'Total number of HTTP requests received',
         labelNames: ['method', 'route', 'status_code'],
         registers: [this.registry],
     });
@@ -31,4 +31,4 @@ export class MetricsService {
     getContentType(): string {
         return this.registry.contentType;
     }
-}
+}

package/templates/typeorm/src/users/dto/create-user.dto.ts

@@ -3,10 +3,10 @@ import { createZodDto } from 'nestjs-zod';
 import { Role } from '../../common/constants/role.enum';
 
 export const createUserSchema = z.object({
-  name: z.string().min(2).describe('Nome completo'),
-  email: z.string().email().describe('E-mail do usuário'),
-  password: z.string().min(8).describe('Senha (mínimo 8 caracteres)'),
-  role: z.nativeEnum(Role).optional().describe('Role do usuário (padrão: USER)'),
+  name: z.string().min(2).describe('Full name'),
+  email: z.string().email().describe('User email'),
+  password: z.string().min(8).describe('Password (minimum 8 characters)'),
+  role: z.nativeEnum(Role).optional().describe('User role (default: USER)'),
 });
 
-export class CreateUserDto extends createZodDto(createUserSchema) { }
+export class CreateUserDto extends createZodDto(createUserSchema) { }

package/templates/typeorm/src/users/dto/find-users-query.dto.ts

@@ -3,10 +3,10 @@ import { createZodDto } from 'nestjs-zod';
 import { Role } from '../../common/constants/role.enum';
 
 export const findUsersQuerySchema = z.object({
-    page: z.coerce.number().int().min(1).default(1).describe('Página atual'),
-    limit: z.coerce.number().int().min(1).max(100).default(10).describe('Itens por página (máx. 100)'),
+    page: z.coerce.number().int().min(1).default(1).describe('Current page'),
+    limit: z.coerce.number().int().min(1).max(100).default(10).describe('Items per page (maximum 100)'),
     search: z.string().optional().describe('Busca por nome ou e-mail'),
     role: z.nativeEnum(Role).optional().describe('Filtra por role'),
 });
 
-export class FindUsersQueryDto extends createZodDto(findUsersQuerySchema) { }
+export class FindUsersQueryDto extends createZodDto(findUsersQuerySchema) { }

package/templates/typeorm/src/users/users.controller.ts

@@ -57,9 +57,9 @@ export class UsersController {
   @Permissions(Permission.UserCreate)
   // nestforge:feature:rbac:end
   // nestforge:feature:swagger
-  @ApiOperation({ summary: 'Cria um usuário (requer permissão user:create)' })
-  @ApiResponse({ status: 201, description: 'Usuário criado', schema: { example: USER_EXAMPLE } })
-  @ApiResponse({ status: 403, description: 'Sem a permissão user:create', schema: { example: FORBIDDEN_EXAMPLE } })
+  @ApiOperation({ summary: 'Creates a user (requires the user:create permission)' })
+  @ApiResponse({ status: 201, description: 'User created', schema: { example: USER_EXAMPLE } })
+  @ApiResponse({ status: 403, description: 'Missing the user:create permission', schema: { example: FORBIDDEN_EXAMPLE } })
   // nestforge:feature:swagger:end
   create(@Body() dto: CreateUserDto) {
     return this.usersService.create(dto);
@@ -70,10 +70,10 @@ export class UsersController {
   @Permissions(Permission.UserRead)
   // nestforge:feature:rbac:end
   // nestforge:feature:swagger
-  @ApiOperation({ summary: 'Lista usuários com paginação e filtros (requer permissão user:read)' })
+  @ApiOperation({ summary: 'Lists users with pagination and filters (requires the user:read permission)' })
   @ApiResponse({
     status: 200,
-    description: 'Lista paginada',
+    description: 'Paginated list',
     schema: {
       example: {
         data: [USER_EXAMPLE],
@@ -88,8 +88,8 @@ export class UsersController {
 
   @Get('me')
   // nestforge:feature:swagger
-  @ApiOperation({ summary: 'Retorna o usuário autenticado' })
-  @ApiResponse({ status: 200, description: 'Usuário autenticado', schema: { example: USER_EXAMPLE } })
+  @ApiOperation({ summary: 'Returns the authenticated user' })
+  @ApiResponse({ status: 200, description: 'Authenticated user', schema: { example: USER_EXAMPLE } })
   // nestforge:feature:swagger:end
   findMe(@CurrentUser() user: { id: string }) {
     return this.usersService.findOne(user.id);
@@ -97,17 +97,17 @@ export class UsersController {
 
   @Post('me/avatar')
   // nestforge:feature:swagger
-  @ApiOperation({ summary: 'Faz upload do avatar do usuário autenticado' })
+  @ApiOperation({ summary: 'Uploads an avatar for the authenticated user' })
   @ApiConsumes('multipart/form-data')
   @ApiResponse({
     status: 201,
-    description: 'Avatar atualizado',
+    description: 'Avatar updated',
     schema: { example: { ...USER_EXAMPLE, avatarUrl: '/uploads/avatars/f47ac10b.png' } },
   })
   @ApiResponse({
     status: 400,
-    description: 'Formato de imagem não suportado ou arquivo maior que 2MB',
-    schema: { example: { statusCode: 400, message: 'Formato de imagem não suportado (use PNG, JPEG ou WEBP)' } },
+    description: 'Unsupported image format or file larger than 2 MB',
+    schema: { example: { statusCode: 400, message: 'Unsupported image format (use PNG, JPEG, or WEBP)' } },
   })
   // nestforge:feature:swagger:end
   @UseInterceptors(
@@ -129,9 +129,9 @@ export class UsersController {
   @Permissions(Permission.UserRead)
   // nestforge:feature:rbac:end
   // nestforge:feature:swagger
-  @ApiOperation({ summary: 'Busca um usuário por id (requer permissão user:read)' })
-  @ApiResponse({ status: 200, description: 'Usuário encontrado', schema: { example: USER_EXAMPLE } })
-  @ApiResponse({ status: 404, description: 'Usuário não encontrado', schema: { example: { statusCode: 404, message: 'Usuário não encontrado' } } })
+  @ApiOperation({ summary: 'Finds a user by ID (requires the user:read permission)' })
+  @ApiResponse({ status: 200, description: 'User found', schema: { example: USER_EXAMPLE } })
+  @ApiResponse({ status: 404, description: 'User not found', schema: { example: { statusCode: 404, message: 'User not found' } } })
   // nestforge:feature:swagger:end
   findOne(@Param('id') id: string) {
     return this.usersService.findOne(id);
@@ -142,9 +142,9 @@ export class UsersController {
   @Permissions(Permission.UserUpdate)
   // nestforge:feature:rbac:end
   // nestforge:feature:swagger
-  @ApiOperation({ summary: 'Atualiza um usuário (requer permissão user:update)' })
-  @ApiResponse({ status: 200, description: 'Usuário atualizado', schema: { example: USER_EXAMPLE } })
-  @ApiResponse({ status: 403, description: 'Sem a permissão user:update', schema: { example: FORBIDDEN_EXAMPLE } })
+  @ApiOperation({ summary: 'Updates a user (requires the user:update permission)' })
+  @ApiResponse({ status: 200, description: 'User updated', schema: { example: USER_EXAMPLE } })
+  @ApiResponse({ status: 403, description: 'Missing the user:update permission', schema: { example: FORBIDDEN_EXAMPLE } })
   // nestforge:feature:swagger:end
   update(@Param('id') id: string, @Body() dto: UpdateUserDto) {
     return this.usersService.update(id, dto);
@@ -155,11 +155,11 @@ export class UsersController {
   @Permissions(Permission.UserDelete)
   // nestforge:feature:rbac:end
   // nestforge:feature:swagger
-  @ApiOperation({ summary: 'Remove um usuário (requer permissão user:delete)' })
-  @ApiResponse({ status: 200, description: 'Usuário removido', schema: { example: { message: 'Usuário removido com sucesso' } } })
-  @ApiResponse({ status: 403, description: 'Sem a permissão user:delete', schema: { example: FORBIDDEN_EXAMPLE } })
+  @ApiOperation({ summary: 'Deletes a user (requires the user:delete permission)' })
+  @ApiResponse({ status: 200, description: 'User deleted', schema: { example: { message: 'User deleted successfully' } } })
+  @ApiResponse({ status: 403, description: 'Missing the user:delete permission', schema: { example: FORBIDDEN_EXAMPLE } })
   // nestforge:feature:swagger:end
   remove(@Param('id') id: string) {
     return this.usersService.remove(id);
   }
-}
+}

package/templates/typeorm/src/users/users.service.spec.ts

@@ -49,19 +49,19 @@ describe('UsersService', () => {
         );
     });
 
-    it('deve lançar ConflictException se o e-mail já existir ao criar', async () => {
+    it('throws ConflictException when the email already exists during creation', async () => {
         usersRepository.findOne.mockResolvedValue(mockUser);
 
         await expect(
             usersService.create({
                 name: 'Jeiel',
                 email: 'jeiel@example.com',
-                password: 'senhaForte123',
+                password: 'strongPassword123',
             }),
         ).rejects.toBeInstanceOf(ConflictException);
     });
 
-    it('deve criar um usuário e esconder o passwordHash na serialização', async () => {
+    it('creates a user and hides passwordHash during serialization', async () => {
         usersRepository.findOne.mockResolvedValue(null);
         usersRepository.create.mockReturnValue(mockUser);
         usersRepository.save.mockResolvedValue(mockUser);
@@ -69,7 +69,7 @@ describe('UsersService', () => {
         const result = await usersService.create({
             name: 'Jeiel',
             email: 'jeiel@example.com',
-            password: 'senhaForte123',
+            password: 'strongPassword123',
         });
 
         expect(result.email).toBe('jeiel@example.com');
@@ -78,7 +78,7 @@ describe('UsersService', () => {
         expect(usersRepository.save).toHaveBeenCalledWith(mockUser);
     });
 
-    it('deve lançar NotFoundException se o usuário não existir', async () => {
+    it('throws NotFoundException when the user does not exist', async () => {
         usersRepository.findOne.mockResolvedValue(null);
 
         await expect(
@@ -86,7 +86,7 @@ describe('UsersService', () => {
         ).rejects.toBeInstanceOf(NotFoundException);
     });
 
-    it('deve retornar dados paginados em findAll', async () => {
+    it('returns paginated data from findAll', async () => {
         queryBuilder.getManyAndCount.mockResolvedValue([[mockUser], 1]);
 
         const result = await usersService.findAll({
@@ -105,7 +105,7 @@ describe('UsersService', () => {
         expect(queryBuilder.take).toHaveBeenCalledWith(10);
     });
 
-    it('deve aplicar busca e filtro por role em findAll', async () => {
+    it('applies search and role filters in findAll', async () => {
         queryBuilder.getManyAndCount.mockResolvedValue([[mockUser], 1]);
 
         await usersService.findAll({
@@ -126,7 +126,7 @@ describe('UsersService', () => {
         );
     });
 
-    it('deve atualizar um usuário existente', async () => {
+    it('updates an existing user', async () => {
         usersRepository.findOne.mockResolvedValue(mockUser);
         usersRepository.save.mockImplementation(
             async (user: UserEntity) => user,
@@ -147,7 +147,7 @@ describe('UsersService', () => {
         );
     });
 
-    it('deve remover um usuário existente', async () => {
+    it('deletes an existing user', async () => {
         usersRepository.findOne.mockResolvedValue(mockUser);
         usersRepository.remove.mockResolvedValue(mockUser);
 
@@ -155,11 +155,11 @@ describe('UsersService', () => {
 
         expect(usersRepository.remove).toHaveBeenCalledWith(mockUser);
         expect(result).toEqual({
-            message: 'Usuário removido com sucesso',
+            message: 'User deleted successfully',
         });
     });
 
-    it('deve atualizar o avatar de um usuário', async () => {
+    it('updates a user avatar', async () => {
         usersRepository.findOne.mockResolvedValue(mockUser);
         usersRepository.save.mockImplementation(
             async (user: UserEntity) => user,
@@ -180,4 +180,4 @@ describe('UsersService', () => {
             }),
         );
     });
-});
+});

package/templates/typeorm/src/users/users.service.ts

@@ -24,7 +24,7 @@ export class UsersService {
     });
 
     if (existing) {
-      throw new ConflictException('E-mail já cadastrado');
+      throw new ConflictException('Email already registered');
     }
 
     const passwordHash = await bcrypt.hash(dto.password, 10);
@@ -83,7 +83,7 @@ export class UsersService {
     });
 
     if (!user) {
-      throw new NotFoundException('Usuário não encontrado');
+      throw new NotFoundException('User not found');
     }
 
     return new UserEntity(user);
@@ -109,7 +109,7 @@ export class UsersService {
 
     await this.usersRepository.remove(user);
 
-    return { message: 'Usuário removido com sucesso' };
+    return { message: 'User deleted successfully' };
   }
 
   async updateAvatar(id: string, avatarUrl: string) {
@@ -121,4 +121,4 @@ export class UsersService {
 
     return new UserEntity(updatedUser);
   }
-}
+}

package/templates/typeorm/test/auth.e2e-spec.ts

@@ -22,7 +22,7 @@ describe('Auth (e2e)', () => {
         await app.close();
     });
 
-    it('deve registrar, logar, renovar e revogar o token', async () => {
+    it('registers, logs in, refreshes, and revokes the token', async () => {
         const server = app.getHttpServer();
 
         const registerResponse = await request(server)
@@ -30,7 +30,7 @@ describe('Auth (e2e)', () => {
             .send({
                 name: 'Jeiel',
                 email: 'jeiel.e2e@example.com',
-                password: 'senhaForte123',
+                password: 'strongPassword123',
             })
             .expect(201);
 
@@ -46,7 +46,7 @@ describe('Auth (e2e)', () => {
             .post('/auth/login')
             .send({
                 email: 'jeiel.e2e@example.com',
-                password: 'senhaForte123',
+                password: 'strongPassword123',
             })
             .expect(200);
 
@@ -79,13 +79,13 @@ describe('Auth (e2e)', () => {
             .expect(401);
     });
 
-    it('não deve permitir cadastro com e-mail duplicado', async () => {
+    it('rejects registration with a duplicate email', async () => {
         const server = app.getHttpServer();
 
         const payload = {
             name: 'Jeiel',
-            email: 'duplicado.e2e@example.com',
-            password: 'senhaForte123',
+            email: 'duplicate.e2e@example.com',
+            password: 'strongPassword123',
         };
 
         await request(server)
@@ -99,7 +99,7 @@ describe('Auth (e2e)', () => {
             .expect(409);
     });
 
-    it('deve rejeitar login com credenciais inválidas', async () => {
+    it('rejects login with invalid credentials', async () => {
         await request(app.getHttpServer())
             .post('/auth/login')
             .send({
@@ -108,4 +108,4 @@ describe('Auth (e2e)', () => {
             })
             .expect(401);
     });
-});
+});

package/templates/typeorm/test/session-auth.e2e-spec.ts

@@ -24,7 +24,7 @@ describe('Session auth (e2e)', () => {
         }
     });
 
-    it('registra, autentica e encerra uma sessão protegida por CSRF', async () => {
+    it('registers, authenticates, and closes a CSRF-protected session', async () => {
         const agent = request.agent(app.getHttpServer());
 
         await agent
@@ -39,13 +39,13 @@ describe('Session auth (e2e)', () => {
 
         expect(csrfToken).toMatch(/^[a-f0-9]{64}$/);
 
-        // Requisições que alteram estado devem ser rejeitadas sem o token.
+        // State-changing requests must be rejected without the token.
         await agent
             .post('/auth/register')
             .send({
                 name: 'Jeiel',
                 email: 'jeiel.session@example.com',
-                password: 'senhaForte123',
+                password: 'strongPassword123',
             })
             .expect(403);
 
@@ -55,7 +55,7 @@ describe('Session auth (e2e)', () => {
             .send({
                 name: 'Jeiel',
                 email: 'jeiel.session@example.com',
-                password: 'senhaForte123',
+                password: 'strongPassword123',
             })
             .expect(201);
 
@@ -93,7 +93,7 @@ describe('Session auth (e2e)', () => {
             .expect(401);
     });
 
-    it('realiza login e renova o token CSRF da sessão', async () => {
+    it('logs in and refreshes the session CSRF token', async () => {
         const registrationAgent = request.agent(
             app.getHttpServer(),
         );
@@ -109,9 +109,9 @@ describe('Session auth (e2e)', () => {
             .post('/auth/register')
             .set('x-csrf-token', registrationCsrfToken)
             .send({
-                name: 'Usuário de sessão',
+                name: 'Session User',
                 email: 'login.session@example.com',
-                password: 'senhaForte123',
+                password: 'strongPassword123',
             })
             .expect(201);
 
@@ -137,7 +137,7 @@ describe('Session auth (e2e)', () => {
             .set('x-csrf-token', loginCsrfToken)
             .send({
                 email: 'login.session@example.com',
-                password: 'senhaForte123',
+                password: 'strongPassword123',
             })
             .expect(200);
 
@@ -156,4 +156,4 @@ describe('Session auth (e2e)', () => {
             .get('/users/me')
             .expect(200);
     });
-});
+});

package/templates/typeorm/test/users.e2e-spec.ts

@@ -27,7 +27,7 @@ describe('Users (e2e)', () => {
         );
 
         const user = usersRepository.create({
-            name: 'Usuário de teste',
+            name: 'Test User',
             email,
             passwordHash,
             role,
@@ -66,22 +66,22 @@ describe('Users (e2e)', () => {
         await app.close();
     });
 
-    it('rejeita acesso sem token', async () => {
+    it('rejects access without a token', async () => {
         await request(app.getHttpServer())
             .get('/users')
             .expect(401);
     });
 
-    it('ADMIN consegue criar, listar, atualizar e remover um usuário', async () => {
+    it('allows ADMIN to create, list, update, and delete a user', async () => {
         await createUserWithRole(
             'admin.e2e@example.com',
-            'senhaForte123',
+            'strongPassword123',
             Role.ADMIN,
         );
 
         const token = await loginAndGetToken(
             'admin.e2e@example.com',
-            'senhaForte123',
+            'strongPassword123',
         );
 
         const server = app.getHttpServer();
@@ -90,9 +90,9 @@ describe('Users (e2e)', () => {
             .post('/users')
             .set('Authorization', `Bearer ${token}`)
             .send({
-                name: 'Novo Usuário',
-                email: 'novo.e2e@example.com',
-                password: 'senhaForte123',
+                name: 'New User',
+                email: 'new.e2e@example.com',
+                password: 'strongPassword123',
             })
             .expect(201);
 
@@ -126,16 +126,16 @@ describe('Users (e2e)', () => {
     });
 
     // nestforge:feature:rbac
-    it('USER consegue ler mas não consegue criar usuário', async () => {
+    it('allows USER to read but not create users', async () => {
         await createUserWithRole(
             'user.e2e@example.com',
-            'senhaForte123',
+            'strongPassword123',
             Role.USER,
         );
 
         const token = await loginAndGetToken(
             'user.e2e@example.com',
-            'senhaForte123',
+            'strongPassword123',
         );
 
         const server = app.getHttpServer();
@@ -149,24 +149,24 @@ describe('Users (e2e)', () => {
             .post('/users')
             .set('Authorization', `Bearer ${token}`)
             .send({
-                name: 'Não deveria criar',
-                email: 'bloqueado.e2e@example.com',
-                password: 'senhaForte123',
+                name: 'Should Not Be Created',
+                email: 'blocked.e2e@example.com',
+                password: 'strongPassword123',
             })
             .expect(403);
     });
     // nestforge:feature:rbac:end
 
-    it('GET /users/me retorna o usuário autenticado', async () => {
+    it('returns the authenticated user from GET /users/me', async () => {
         await createUserWithRole(
             'me.e2e@example.com',
-            'senhaForte123',
+            'strongPassword123',
             Role.USER,
         );
 
         const token = await loginAndGetToken(
             'me.e2e@example.com',
-            'senhaForte123',
+            'strongPassword123',
         );
 
         const response = await request(
@@ -180,4 +180,4 @@ describe('Users (e2e)', () => {
             'me.e2e@example.com',
         );
     });
-});
+});