nestforge-generator 0.3.0 → 0.4.0

package/templates/prisma/src/common/filters/http-exception.filter.ts

@@ -1,34 +1,34 @@
-import {
-  ArgumentsHost,
-  Catch,
-  ExceptionFilter,
-  HttpException,
-  HttpStatus,
-} from '@nestjs/common';
-import { Request, Response } from 'express';
-
-@Catch()
-export class HttpExceptionFilter implements ExceptionFilter {
-  catch(exception: unknown, host: ArgumentsHost) {
-    const ctx = host.switchToHttp();
-    const response = ctx.getResponse<Response>();
-    const request = ctx.getRequest<Request>();
-
-    const status =
-      exception instanceof HttpException
-        ? exception.getStatus()
-        : HttpStatus.INTERNAL_SERVER_ERROR;
-
-    const message =
-      exception instanceof HttpException
-        ? exception.getResponse()
-        : 'Erro interno do servidor';
-
-    response.status(status).json({
-      statusCode: status,
-      path: request.url,
-      timestamp: new Date().toISOString(),
-      message,
-    });
-  }
-}
+import {
+  ArgumentsHost,
+  Catch,
+  ExceptionFilter,
+  HttpException,
+  HttpStatus,
+} from '@nestjs/common';
+import { Request, Response } from 'express';
+
+@Catch()
+export class HttpExceptionFilter implements ExceptionFilter {
+  catch(exception: unknown, host: ArgumentsHost) {
+    const ctx = host.switchToHttp();
+    const response = ctx.getResponse<Response>();
+    const request = ctx.getRequest<Request>();
+
+    const status =
+      exception instanceof HttpException
+        ? exception.getStatus()
+        : HttpStatus.INTERNAL_SERVER_ERROR;
+
+    const message =
+      exception instanceof HttpException
+        ? exception.getResponse()
+        : 'Internal server error';
+
+    response.status(status).json({
+      statusCode: status,
+      path: request.url,
+      timestamp: new Date().toISOString(),
+      message,
+    });
+  }
+}

package/templates/prisma/src/common/guards/permissions.guard.spec.ts

@@ -15,14 +15,14 @@ function createContext(user?: { role: Role }): ExecutionContext {
 }
 
 describe('PermissionsGuard', () => {
-    it('libera acesso quando a rota não exige nenhuma permissão', () => {
+    it('allows access when the route requires no permission', () => {
         const reflector = { getAllAndOverride: vi.fn().mockReturnValue(undefined) } as unknown as Reflector;
         const guard = new PermissionsGuard(reflector);
 
         expect(guard.canActivate(createContext({ role: Role.USER }))).toBe(true);
     });
 
-    it('libera acesso quando a role do usuário tem a permissão exigida', () => {
+    it('allows access when the user role has the required permission', () => {
         const reflector = {
             getAllAndOverride: vi.fn().mockReturnValue([Permission.UserRead]),
         } as unknown as Reflector;
@@ -31,7 +31,7 @@ describe('PermissionsGuard', () => {
         expect(guard.canActivate(createContext({ role: Role.USER }))).toBe(true);
     });
 
-    it('bloqueia acesso quando a role do usuário não tem a permissão exigida', () => {
+    it('blocks access when the user role lacks the required permission', () => {
         const reflector = {
             getAllAndOverride: vi.fn().mockReturnValue([Permission.UserDelete]),
         } as unknown as Reflector;
@@ -40,15 +40,15 @@ describe('PermissionsGuard', () => {
         expect(guard.canActivate(createContext({ role: Role.USER }))).toBe(false);
     });
 
-    it('exige todas as permissões quando mais de uma é requisitada', () => {
+    it('requires all permissions when more than one is requested', () => {
         const reflector = {
             getAllAndOverride: vi.fn().mockReturnValue([Permission.UserRead, Permission.UserUpdate]),
         } as unknown as Reflector;
         const guard = new PermissionsGuard(reflector);
 
-        // MANAGER tem user:read e user:update
+        // MANAGER has user:read and user:update
         expect(guard.canActivate(createContext({ role: Role.MANAGER }))).toBe(true);
-        // USER só tem user:read
+        // USER only has user:read
         expect(guard.canActivate(createContext({ role: Role.USER }))).toBe(false);
     });
-});
+});

package/templates/prisma/src/common/guards/roles.guard.spec.ts

@@ -14,24 +14,24 @@ function createContext(user?: { role: Role }): ExecutionContext {
 }
 
 describe('RolesGuard', () => {
-    it('libera acesso quando a rota não exige nenhuma role', () => {
+    it('allows access when the route requires no role', () => {
         const reflector = { getAllAndOverride: vi.fn().mockReturnValue(undefined) } as unknown as Reflector;
         const guard = new RolesGuard(reflector);
 
         expect(guard.canActivate(createContext({ role: Role.USER }))).toBe(true);
     });
 
-    it('libera acesso quando o usuário tem a role exigida', () => {
+    it('allows access when the user has the required role', () => {
         const reflector = { getAllAndOverride: vi.fn().mockReturnValue([Role.ADMIN]) } as unknown as Reflector;
         const guard = new RolesGuard(reflector);
 
         expect(guard.canActivate(createContext({ role: Role.ADMIN }))).toBe(true);
     });
 
-    it('bloqueia acesso quando o usuário não tem a role exigida', () => {
+    it('blocks access when the user does not have the required role', () => {
         const reflector = { getAllAndOverride: vi.fn().mockReturnValue([Role.ADMIN]) } as unknown as Reflector;
         const guard = new RolesGuard(reflector);
 
         expect(guard.canActivate(createContext({ role: Role.USER }))).toBe(false);
     });
-});
+});

package/templates/prisma/src/common/middleware/csrf.middleware.spec.ts

@@ -36,7 +36,7 @@ describe('CsrfMiddleware', () => {
     }
 
     it.each(['GET', 'HEAD', 'OPTIONS'])(
-        'permite o método seguro %s sem token',
+        'allows the safe %s method without a token',
         (method) => {
             const request = createRequest(method);
 
@@ -50,7 +50,7 @@ describe('CsrfMiddleware', () => {
         },
     );
 
-    it('rejeita uma requisição sem token CSRF', () => {
+    it('rejects a request without a CSRF token', () => {
         const request = createRequest('POST');
 
         expect(() =>
@@ -64,7 +64,7 @@ describe('CsrfMiddleware', () => {
         expect(next).not.toHaveBeenCalled();
     });
 
-    it('rejeita quando o token do header é diferente da sessão', () => {
+    it('rejects when the header token differs from the session token', () => {
         const request = createRequest(
             'PATCH',
             'session-token',
@@ -82,7 +82,7 @@ describe('CsrfMiddleware', () => {
         expect(next).not.toHaveBeenCalled();
     });
 
-    it('permite quando o token corresponde ao valor da sessão', () => {
+    it('allows the request when the token matches the session value', () => {
         const token = 'a'.repeat(64);
         const request = createRequest('DELETE', token, token);
 
@@ -94,4 +94,4 @@ describe('CsrfMiddleware', () => {
 
         expect(next).toHaveBeenCalledOnce();
     });
-});
+});

package/templates/prisma/src/common/middleware/csrf.middleware.ts

@@ -27,7 +27,7 @@ export class CsrfMiddleware implements NestMiddleware {
             !this.tokensMatch(sessionToken, headerToken)
         ) {
             throw new ForbiddenException(
-                'Token CSRF inválido ou ausente',
+                'Invalid or missing CSRF token',
             );
         }
 
@@ -43,4 +43,4 @@ export class CsrfMiddleware implements NestMiddleware {
             timingSafeEqual(expectedBuffer, receivedBuffer)
         );
     }
-}
+}

package/templates/prisma/src/common/utils/avatar-storage.util.ts

@@ -1,32 +1,32 @@
-import { BadRequestException } from '@nestjs/common';
-import { randomUUID } from 'crypto';
-import { diskStorage } from 'multer';
-import { extname } from 'path';
-
-const ALLOWED_MIME_TYPES = ['image/png', 'image/jpeg', 'image/webp'];
-
-export const avatarStorage = diskStorage({
-    destination: './uploads/avatars',
-    filename: (_req, file, callback) => {
-        const uniqueName = `${randomUUID()}${extname(file.originalname)}`;
-        callback(null, uniqueName);
-    },
-});
-
-export function avatarFileFilter(
-    _req: unknown,
-    file: Express.Multer.File,
-    callback: (error: Error | null, acceptFile: boolean) => void,
-) {
-    if (!ALLOWED_MIME_TYPES.includes(file.mimetype)) {
-        callback(
-            new BadRequestException('Formato de imagem não suportado (use PNG, JPEG ou WEBP)'),
-            false,
-        );
-        return;
-    }
-
-    callback(null, true);
-}
-
-export const AVATAR_MAX_SIZE_BYTES = 2 * 1024 * 1024; // 2MB
+import { BadRequestException } from '@nestjs/common';
+import { randomUUID } from 'crypto';
+import { diskStorage } from 'multer';
+import { extname } from 'path';
+
+const ALLOWED_MIME_TYPES = ['image/png', 'image/jpeg', 'image/webp'];
+
+export const avatarStorage = diskStorage({
+    destination: './uploads/avatars',
+    filename: (_req, file, callback) => {
+        const uniqueName = `${randomUUID()}${extname(file.originalname)}`;
+        callback(null, uniqueName);
+    },
+});
+
+export function avatarFileFilter(
+    _req: unknown,
+    file: Express.Multer.File,
+    callback: (error: Error | null, acceptFile: boolean) => void,
+) {
+    if (!ALLOWED_MIME_TYPES.includes(file.mimetype)) {
+        callback(
+            new BadRequestException('Unsupported image format (use PNG, JPEG, or WEBP)'),
+            false,
+        );
+        return;
+    }
+
+    callback(null, true);
+}
+
+export const AVATAR_MAX_SIZE_BYTES = 2 * 1024 * 1024; // 2MB

package/templates/prisma/src/config/env.validation.ts

@@ -42,7 +42,7 @@ export function validateEnv(config: Record<string, unknown>): EnvConfig {
     const issues = parsed.error.issues
       .map((issue) => `${issue.path.join('.')}: ${issue.message}`)
       .join('\n');
-    throw new Error(`Variáveis de ambiente inválidas:\n${issues}`);
+    throw new Error(`Invalid environment variables:\n${issues}`);
   }
 
   return parsed.data;

package/templates/prisma/src/health/health.controller.ts

@@ -33,7 +33,7 @@ export class HealthController {
     @Get()
     @HealthCheck()
     // nestforge:feature:swagger
-    @ApiOperation({ summary: 'Verifica a saúde da API (banco, memória, disco e demais dependências configuradas)' })
+    @ApiOperation({ summary: 'Checks API health (database, memory, disk, and other configured dependencies)' })
     // nestforge:feature:swagger:end
     check() {
         return this.health.check([
@@ -46,4 +46,4 @@ export class HealthController {
             () => this.disk.checkStorage('disk', { path: '/', thresholdPercent: 0.9 }),
         ]);
     }
-}
+}

package/templates/prisma/src/health/indicators/prisma-health.indicator.spec.ts

@@ -4,7 +4,7 @@ import { PrismaHealthIndicator } from './prisma-health.indicator';
 import { PrismaService } from '../../database/prisma.service';
 
 describe('PrismaHealthIndicator', () => {
-    it('retorna status up quando a query executa com sucesso', async () => {
+    it('returns an up status when the query succeeds', async () => {
         const prisma = {
             // nestforge:feature:database:relational
             $queryRaw: vi.fn().mockResolvedValue([{ '?column?': 1 }]),
@@ -23,13 +23,13 @@ describe('PrismaHealthIndicator', () => {
         // nestforge:feature:database:mongodb:end
     });
 
-    it('lança HealthCheckError quando a query falha', async () => {
+    it('throws HealthCheckError when the query fails', async () => {
         const prisma = {
             // nestforge:feature:database:relational
-            $queryRaw: vi.fn().mockRejectedValue(new Error('conexão recusada')),
+            $queryRaw: vi.fn().mockRejectedValue(new Error('connection refused')),
             // nestforge:feature:database:relational:end
             // nestforge:feature:database:mongodb
-            $runCommandRaw: vi.fn().mockRejectedValue(new Error('conexão recusada')),
+            $runCommandRaw: vi.fn().mockRejectedValue(new Error('connection refused')),
             // nestforge:feature:database:mongodb:end
         };
         const indicator = new PrismaHealthIndicator(prisma as unknown as PrismaService);

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

@@ -16,7 +16,7 @@ export class PrismaHealthIndicator {
             // nestforge:feature:database:mongodb:end
             return { [key]: { status: 'up' } };
         } catch (error) {
-            throw new HealthCheckError('Banco de dados indisponível', {
+            throw new HealthCheckError('Database unavailable', {
                 [key]: { status: 'down', message: (error as Error).message },
             });
         }

package/templates/prisma/src/health/indicators/redis-health.indicator.spec.ts

@@ -14,7 +14,7 @@ vi.mock('ioredis', () => ({
     })),
 }));
 
-// precisa ser importado depois do vi.mock, senão pega o ioredis real
+// Must be imported after vi.mock; otherwise it loads the real ioredis package.
 const { RedisHealthIndicator } = await import('./redis-health.indicator');
 
 describe('RedisHealthIndicator', () => {
@@ -24,7 +24,7 @@ describe('RedisHealthIndicator', () => {
         disconnectMock.mockReset();
     });
 
-    it('retorna status up quando o PING responde PONG', async () => {
+    it('returns an up status when PING returns PONG', async () => {
         connectMock.mockResolvedValue(undefined);
         pingMock.mockResolvedValue('PONG');
 
@@ -35,7 +35,7 @@ describe('RedisHealthIndicator', () => {
         expect(disconnectMock).toHaveBeenCalled();
     });
 
-    it('lança HealthCheckError quando o PING não responde PONG', async () => {
+    it('throws HealthCheckError when PING does not return PONG', async () => {
         connectMock.mockResolvedValue(undefined);
         pingMock.mockResolvedValue('ALGO_INESPERADO');
 
@@ -44,11 +44,11 @@ describe('RedisHealthIndicator', () => {
         await expect(indicator.isHealthy('redis')).rejects.toBeInstanceOf(HealthCheckError);
     });
 
-    it('lança HealthCheckError quando a conexão falha', async () => {
+    it('throws HealthCheckError when the connection fails', async () => {
         connectMock.mockRejectedValue(new Error('ECONNREFUSED'));
 
         const indicator = new RedisHealthIndicator();
 
         await expect(indicator.isHealthy('redis')).rejects.toBeInstanceOf(HealthCheckError);
     });
-});
+});

package/templates/prisma/src/health/indicators/redis-health.indicator.ts

@@ -18,16 +18,16 @@ export class RedisHealthIndicator {
             const response = await client.ping();
 
             if (response !== 'PONG') {
-                throw new Error('Resposta inesperada do Redis');
+                throw new Error('Unexpected Redis response');
             }
 
             return { [key]: { status: 'up' } };
         } catch (error) {
-            throw new HealthCheckError('Redis indisponível', {
+            throw new HealthCheckError('Redis unavailable', {
                 [key]: { status: 'down', message: (error as Error).message },
             });
         } finally {
             client.disconnect();
         }
     }
-}
+}

package/templates/prisma/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/prisma/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/prisma/src/metrics/metrics.service.ts

@@ -1,34 +1,34 @@
-import { Injectable } from '@nestjs/common';
-import * as client from 'prom-client';
-
-@Injectable()
-export class MetricsService {
-    readonly registry = new client.Registry();
-
-    readonly httpRequestDuration = new client.Histogram({
-        name: 'http_request_duration_seconds',
-        help: 'Duração das requisições HTTP em segundos',
-        labelNames: ['method', 'route', 'status_code'],
-        buckets: [0.05, 0.1, 0.3, 0.5, 1, 2, 5],
-        registers: [this.registry],
-    });
-
-    readonly httpRequestsTotal = new client.Counter({
-        name: 'http_requests_total',
-        help: 'Total de requisições HTTP recebidas',
-        labelNames: ['method', 'route', 'status_code'],
-        registers: [this.registry],
-    });
-
-    constructor() {
-        client.collectDefaultMetrics({ register: this.registry });
-    }
-
-    async getMetrics(): Promise<string> {
-        return this.registry.metrics();
-    }
-
-    getContentType(): string {
-        return this.registry.contentType;
-    }
-}
+import { Injectable } from '@nestjs/common';
+import * as client from 'prom-client';
+
+@Injectable()
+export class MetricsService {
+    readonly registry = new client.Registry();
+
+    readonly httpRequestDuration = new client.Histogram({
+        name: 'http_request_duration_seconds',
+        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],
+    });
+
+    readonly httpRequestsTotal = new client.Counter({
+        name: 'http_requests_total',
+        help: 'Total number of HTTP requests received',
+        labelNames: ['method', 'route', 'status_code'],
+        registers: [this.registry],
+    });
+
+    constructor() {
+        client.collectDefaultMetrics({ register: this.registry });
+    }
+
+    async getMetrics(): Promise<string> {
+        return this.registry.metrics();
+    }
+
+    getContentType(): string {
+        return this.registry.contentType;
+    }
+}

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

@@ -1,12 +1,12 @@
-import { z } from 'zod';
-import { createZodDto } from 'nestjs-zod';
-import { Role } from '@prisma/client';
-
-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)'),
-});
-
-export class CreateUserDto extends createZodDto(createUserSchema) { }
+import { z } from 'zod';
+import { createZodDto } from 'nestjs-zod';
+import { Role } from '@prisma/client';
+
+export const createUserSchema = z.object({
+  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) { }

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

@@ -1,12 +1,12 @@
-import { z } from 'zod';
-import { createZodDto } from 'nestjs-zod';
-import { Role } from '@prisma/client';
-
-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)'),
-    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) { }
+import { z } from 'zod';
+import { createZodDto } from 'nestjs-zod';
+import { Role } from '@prisma/client';
+
+export const findUsersQuerySchema = z.object({
+    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) { }