@leo-h/create-nodejs-app 1.0.13 → 1.0.15

package/dist/package.json.js

@@ -1 +1 @@
-Object.defineProperty(exports,"__esModule",{value:!0});const name="@leo-h/create-nodejs-app",version="1.0.13",packageManager="pnpm@9.1.1",author="Leonardo Henrique <leonardo0507.business@gmail.com>",description="Create a modern Node.js app with TypeScript using one command.",license="MIT",keywords=["node","node.js","typescript"],bin={"create-nodejs-app":"./dist/index.js"},files=["./dist","./templates"],repository={type:"git",url:"https://github.com/Leo-Henrique/create-nodejs-app"},scripts={prepare:"husky",start:"node ./dist/index.js","start:dev":"tsx ./src/index.ts","start:dev:watch":"tsx watch ./src/index.ts",typecheck:"tsc --noEmit",lint:"eslint . --ext .ts --max-warnings 0 --cache","lint:fix":"pnpm lint --fix",format:"prettier . --write --cache","test:unit":"vitest run","test:unit:watch":"vitest","test:e2e":"vitest run --config ./vitest.config.e2e.mts","test:e2e:watch":"vitest --config ./vitest.config.e2e.mts","test:coverage":"vitest run --coverage.enabled=true",template:"tsx ./scripts/template-cli.ts",prebuild:"rimraf ./dist",build:"unbuild",prepublishOnly:"pnpm build"},dependencies={commander:"12.1.0",picocolors:"1.0.1",prompts:"2.4.2","validate-npm-package-name":"5.0.1",zod:"3.23.8"},devDependencies={"@faker-js/faker":"8.4.1","@types/node":"20.12.12","@types/prompts":"2.4.9","@types/validate-npm-package-name":"4.0.2","@typescript-eslint/eslint-plugin":"7.10.0","@typescript-eslint/parser":"7.10.0","conventional-changelog-conventionalcommits":"8.0.0",eslint:"8.57.0","eslint-config-prettier":"9.1.0","eslint-plugin-vitest":"0.4.0",husky:"9.0.11","lint-staged":"15.2.2","npm-run-all":"4.1.5",prettier:"3.2.5",rimraf:"5.0.7",tsx:"4.10.5",typescript:"5.4.5",unbuild:"2.0.0","vite-tsconfig-paths":"4.3.2",vitest:"1.6.0"},d={name,version,packageManager,author,description,license,keywords,bin,files,repository,scripts,dependencies,devDependencies};exports.author=author;exports.bin=bin;exports.default=d;exports.dependencies=dependencies;exports.description=description;exports.devDependencies=devDependencies;exports.files=files;exports.keywords=keywords;exports.license=license;exports.name=name;exports.packageManager=packageManager;exports.repository=repository;exports.scripts=scripts;exports.version=version;
+Object.defineProperty(exports,"__esModule",{value:!0});const name="@leo-h/create-nodejs-app",version="1.0.15",packageManager="pnpm@9.1.1",author="Leonardo Henrique <leonardo0507.business@gmail.com>",description="Create a modern Node.js app with TypeScript using one command.",license="MIT",keywords=["node","node.js","typescript"],bin={"create-nodejs-app":"./dist/index.js"},files=["./dist","./templates"],repository={type:"git",url:"https://github.com/Leo-Henrique/create-nodejs-app"},scripts={prepare:"husky",start:"node ./dist/index.js","start:dev":"tsx ./src/index.ts","start:dev:watch":"tsx watch ./src/index.ts",typecheck:"tsc --noEmit",lint:"eslint . --ext .ts --max-warnings 0 --cache","lint:fix":"pnpm lint --fix",format:"prettier . --write --cache","test:unit":"vitest run","test:unit:watch":"vitest","test:e2e":"vitest run --config ./vitest.config.e2e.mts","test:e2e:watch":"vitest --config ./vitest.config.e2e.mts","test:coverage":"vitest run --coverage.enabled=true",template:"tsx ./scripts/template-cli.ts",prebuild:"rimraf ./dist",build:"unbuild",prepublishOnly:"pnpm build"},dependencies={commander:"12.1.0",picocolors:"1.0.1",prompts:"2.4.2","validate-npm-package-name":"5.0.1",zod:"3.23.8"},devDependencies={"@faker-js/faker":"8.4.1","@types/node":"20.12.12","@types/prompts":"2.4.9","@types/validate-npm-package-name":"4.0.2","@typescript-eslint/eslint-plugin":"7.10.0","@typescript-eslint/parser":"7.10.0","conventional-changelog-conventionalcommits":"8.0.0",eslint:"8.57.0","eslint-config-prettier":"9.1.0","eslint-plugin-vitest":"0.4.0",husky:"9.0.11","lint-staged":"15.2.2","npm-run-all":"4.1.5",prettier:"3.2.5",rimraf:"5.0.7",tsx:"4.10.5",typescript:"5.4.5",unbuild:"2.0.0","vite-tsconfig-paths":"4.3.2",vitest:"1.6.0"},d={name,version,packageManager,author,description,license,keywords,bin,files,repository,scripts,dependencies,devDependencies};exports.author=author;exports.bin=bin;exports.default=d;exports.dependencies=dependencies;exports.description=description;exports.devDependencies=devDependencies;exports.files=files;exports.keywords=keywords;exports.license=license;exports.name=name;exports.packageManager=packageManager;exports.repository=repository;exports.scripts=scripts;exports.version=version;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leo-h/create-nodejs-app",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "packageManager": "pnpm@9.1.1",
   "author": "Leonardo Henrique <leonardo0507.business@gmail.com>",
   "description": "Create a modern Node.js app with TypeScript using one command.",

package/templates/fastify/package.json

@@ -13,9 +13,9 @@
     "test:unit": "vitest run",
     "test:unit:watch": "vitest",
     "test:unit:coverage": "vitest run --coverage.enabled=true",
-    "test:e2e": "vitest run --config ./vitest.config.e2e.mts",
-    "test:e2e:watch": "vitest --config ./vitest.config.e2e.mts",
-    "test:e2e:coverage": "vitest run --config ./vitest.config.e2e.mts --coverage.enabled=true",
+    "test:integration": "vitest run --config ./vitest.config.integration.mts",
+    "test:integration:watch": "vitest --config ./vitest.config.integration.mts",
+    "test:integration:coverage": "vitest run --config ./vitest.config.integration.mts --coverage.enabled=true",
     "prebuild": "rimraf ./dist",
     "build": "unbuild"
   },

package/templates/fastify/src/core/domain-error.ts

@@ -0,0 +1,17 @@
+export type DomainErrorCoreProperties = Pick<
+  DomainError,
+  "error" | "message" | "debug"
+>;
+
+export abstract class DomainError extends Error {
+  public abstract error: string;
+  public abstract debug: unknown;
+
+  constructor(public message: string) {
+    super(message);
+  }
+}
+
+export abstract class HttpError extends DomainError {
+  public abstract statusCode: number;
+}

package/templates/fastify/src/infra/http/controllers/hello/{hello-multipart.controller.e2e-spec.ts → hello-multipart.controller.integration-spec.ts}

@@ -4,18 +4,19 @@ import { lookup } from "mime-types";
 import { basename, extname } from "path";
 import request from "supertest";
 import { describe, expect, it } from "vitest";
+import { HelloMultipartControllerBody } from "./hello-multipart.controller";
 
-const SAMPLE_UPLOAD_PATH = "./test/e2e/sample-upload.jpg";
+const SAMPLE_UPLOAD_PATH = "./test/integration/sample-upload.jpg";
 
-describe("[Controller] Hello multipart", () => {
-  it("[POST] /hello/multipart", async () => {
+describe("[Controller] POST /hello/multipart", () => {
+  it("should be able to upload a image", async () => {
     const fieldName = "attachment";
     const description = faker.lorem.sentence();
 
     const response = await request(app.server)
       .post("/hello/multipart")
       .attach(fieldName, SAMPLE_UPLOAD_PATH)
-      .field({ description });
+      .field({ description } satisfies HelloMultipartControllerBody);
 
     expect(response.statusCode).toEqual(200);
     expect(response.body).toEqual(

package/templates/fastify/src/infra/http/controllers/hello/hello-multipart.controller.ts

@@ -7,7 +7,7 @@ const helloMultipartControllerBodySchema = z.object({
   description: z.string().min(2),
 });
 
-type HelloMultipartControllerBody = z.infer<
+export type HelloMultipartControllerBody = z.infer<
   typeof helloMultipartControllerBodySchema
 >;
 

package/templates/fastify/src/infra/http/controllers/hello/hello.controller.integration-spec.ts

@@ -0,0 +1,38 @@
+import { app } from "@/infra/http/app";
+import request from "supertest";
+import { describe, expect, it } from "vitest";
+import { HelloControllerQuery } from "./hello.controller";
+
+describe("[Controller] GET /hello", () => {
+  it("should be able to show hello world when setting true in the query parameter", async () => {
+    const response = await request(app.server)
+      .get("/hello")
+      .query({ show: true } satisfies HelloControllerQuery);
+
+    expect(response.statusCode).toEqual(200);
+    expect(response.body).toStrictEqual({ message: "Hello world!" });
+  });
+
+  it("should not be able to show hello world when setting false in the query parameter", async () => {
+    const response = await request(app.server)
+      .get("/hello")
+      .query({ show: false } satisfies HelloControllerQuery);
+
+    expect(response.statusCode).toEqual(400);
+    expect(response.body.error).toEqual("BAD_REQUEST_ERROR");
+  });
+
+  describe("Input data validations", () => {
+    it("with invalid show property", async () => {
+      const response = await request(app.server)
+        .get("/hello")
+        .query({
+          // @ts-expect-error the value must be a boolean
+          show: 0,
+        } satisfies HelloControllerQuery);
+
+      expect(response.statusCode).toEqual(400);
+      expect(response.body.error).toEqual("VALIDATION_ERROR");
+    });
+  });
+});

package/templates/fastify/src/infra/http/controllers/hello/hello.controller.ts

@@ -10,6 +10,8 @@ const helloControllerQuerySchema = z.object({
     .default("true"),
 });
 
+export type HelloControllerQuery = z.infer<typeof helloControllerQuerySchema>;
+
 export async function helloController(app: FastifyInstance) {
   app.withTypeProvider<ZodTypeProvider>().route({
     method: "GET",

package/templates/fastify/src/infra/http/errors/bad-request.error.ts

@@ -1,9 +1,9 @@
-import { HttpError } from "./http-error";
+import { HttpError } from "@/core/domain-error";
 
 export class BadRequestError extends HttpError {
-  public error = "BadRequestError";
-  public statusCode = 400;
-  public debug = null;
+  readonly error = "BAD_REQUEST_ERROR";
+  readonly statusCode = 400;
+  readonly debug = null;
 
   constructor(public message: string) {
     super(message);

package/templates/fastify/src/infra/http/errors/internal-server.error.ts

@@ -0,0 +1,13 @@
+import { HttpError } from "@/core/domain-error";
+
+const message = "Desculpe, um erro inesperado ocorreu.";
+
+export class InternalServerError extends HttpError {
+  readonly statusCode = 500;
+  readonly error = "INTERNAL_SERVER_ERROR";
+  readonly message = message;
+
+  constructor(public debug: unknown) {
+    super(message);
+  }
+}

package/templates/fastify/src/infra/http/errors/upload-validation.error.ts

@@ -1,15 +1,21 @@
-import { HttpError } from "./http-error";
+import { HttpError } from "@/core/domain-error";
+
+const message = "Os dados enviados são inválidos.";
 
 export class UploadValidationError extends HttpError {
-  public error = "UploadValidationError";
-  public debug = { multerError: null };
+  readonly error = "UPLOAD_VALIDATION_ERROR";
+  readonly message = message;
+  public debug: object;
 
   constructor(
     public statusCode = 400,
-    debug: object = {},
+    debug = {},
   ) {
-    super("Os dados enviados são inválidos.");
+    super(message);
 
-    this.debug = { ...this.debug, ...debug };
+    this.debug = {
+      multerError: null,
+      ...debug,
+    };
   }
 }

package/templates/fastify/src/infra/http/errors/validation.error.ts

@@ -0,0 +1,13 @@
+import { HttpError } from "@/core/domain-error";
+
+export class ValidationError extends HttpError {
+  readonly statusCode = 400;
+  readonly error = "VALIDATION_ERROR";
+
+  constructor(
+    public debug: unknown = null,
+    public message = "Os dados enviados são inválidos.",
+  ) {
+    super(message);
+  }
+}

package/templates/fastify/src/infra/http/plugins/error-handler.plugin.ts

@@ -1,45 +1,31 @@
-import { ValidationError } from "@/core/errors/errors";
-import { env } from "@/infra/env";
+import { HttpError } from "@/core/domain-error";
 import { ErrorPresenter } from "@/infra/presenters/error.presenter";
-import { FastifyError, FastifyReply, FastifyRequest } from "fastify";
+import { FastifyReply, FastifyRequest } from "fastify";
 import { ZodError } from "zod";
-import { HttpError } from "../errors/http-error";
+import { InternalServerError } from "../errors/internal-server.error";
+import { ValidationError } from "../errors/validation.error";
 
 export async function errorHandlerPlugin(
-  error: FastifyError,
+  error: unknown,
   _req: FastifyRequest,
   res: FastifyReply,
 ) {
-  console.error(error);
-
-  let httpResponse: ReturnType<typeof ErrorPresenter.toHttp> =
-    ErrorPresenter.toHttp(500, {
-      error: "InternalServerError",
-      message: "Desculpe, um erro inesperado ocorreu.",
-      debug: error.message,
-    });
-
-  if (error.statusCode)
-    httpResponse = ErrorPresenter.toHttp(error.statusCode, {
-      error: error.name,
-      message: error.message,
-      debug: null,
-    });
-
-  if (error instanceof ValidationError)
-    httpResponse = ErrorPresenter.toHttp(400, error);
-
-  if (error instanceof ZodError)
-    httpResponse = ErrorPresenter.toHttp(
-      400,
-      new ValidationError(error.flatten().fieldErrors),
-    );
-
-  if (error instanceof HttpError)
-    httpResponse = ErrorPresenter.toHttp(error.statusCode, error);
-
-  if (env.NODE_ENV === "production" && "debug" in httpResponse)
-    delete httpResponse.debug;
+  let httpError: HttpError;
+
+  if (error instanceof HttpError) httpError = error;
+  else if (error instanceof ZodError)
+    httpError = new ValidationError(error.flatten().fieldErrors);
+  else {
+    const debugFromUnknownError =
+      error && typeof error === "object" && "message" in error
+        ? error.message
+        : null;
+
+    httpError = new InternalServerError(debugFromUnknownError);
+    console.error(httpError);
+  }
+
+  const httpResponse = ErrorPresenter.toHttp(httpError.statusCode, httpError);
 
   res.status(httpResponse.statusCode).send(httpResponse);
 }

package/templates/fastify/src/infra/http/routes.ts

@@ -0,0 +1,8 @@
+import { FastifyInstance } from "fastify";
+import { helloController } from "./controllers/hello/hello.controller";
+import { helloMultipartController } from "./controllers/hello/hello-multipart.controller";
+
+export async function routes(app: FastifyInstance) {
+  app.register(helloController);
+  app.register(helloMultipartController);
+}

package/templates/fastify/src/infra/presenters/error.presenter.ts

@@ -1,14 +1,13 @@
-import { DomainError } from "@/core/errors/domain-error";
-
-type CustomError = Pick<DomainError, "error" | "message" | "debug">;
+import { DomainErrorCoreProperties } from "@/core/domain-error";
+import { env } from "../env";
 
 export class ErrorPresenter {
-  public static toHttp(statusCode: number, error: DomainError | CustomError) {
+  public static toHttp(statusCode: number, error: DomainErrorCoreProperties) {
     return {
       error: error.error,
       message: error.message,
       statusCode,
-      debug: error.debug,
+      debug: env.NODE_ENV !== "production" ? error.debug : null,
     };
   }
 }

package/templates/fastify/{vitest.config.e2e.mts → vitest.config.integration.mts}

@@ -3,7 +3,7 @@ import defaultConfig from "./vitest.config.mjs";
 
 export default mergeConfig(defaultConfig, {
   test: {
-    include: ["./**/*.e2e-spec.ts"],
-    setupFiles: ["./test/e2e/setup.ts"],
+    include: ["./**/*.integration-spec.ts"],
+    setupFiles: ["./test/integration/setup.ts"],
   },
 });

package/templates/nest/package.json

@@ -13,9 +13,9 @@
     "test:unit": "vitest run",
     "test:unit:watch": "vitest",
     "test:unit:coverage": "vitest run --coverage.enabled=true",
-    "test:e2e": "vitest run --config ./vitest.config.e2e.mts",
-    "test:e2e:watch": "vitest --config ./vitest.config.e2e.mts",
-    "test:e2e:coverage": "vitest run --config ./vitest.config.e2e.mts --coverage.enabled=true",
+    "test:integration": "vitest run --config ./vitest.config.integration.mts",
+    "test:integration:watch": "vitest --config ./vitest.config.integration.mts",
+    "test:integration:coverage": "vitest run --config ./vitest.config.integration.mts --coverage.enabled=true",
     "build": "nest build"
   },
   "dependencies": {
@@ -30,6 +30,7 @@
     "fastify-multer": "2.0.3",
     "mime-types": "2.1.35",
     "pretty-bytes": "5.6.0",
+    "rxjs": "7.8.1",
     "zod": "3.23.8"
   },
   "devDependencies": {

package/templates/nest/pnpm-lock.yaml

@@ -41,6 +41,9 @@ importers:
       pretty-bytes:
         specifier: 5.6.0
         version: 5.6.0
+      rxjs:
+        specifier: 7.8.1
+        version: 7.8.1
       zod:
         specifier: 3.23.8
         version: 3.23.8

package/templates/{fastify/src/core/errors → nest/src/core}/domain-error.ts

@@ -1,3 +1,8 @@
+export type DomainErrorCoreProperties = Pick<
+  DomainError,
+  "error" | "message" | "debug"
+>;
+
 export abstract class DomainError extends Error {
   public abstract error: string;
   public abstract debug: unknown;

package/templates/nest/src/infra/http/controllers/hello/{hello-multipart.controller.e2e-spec.ts → hello-multipart.controller.integration-spec.ts}

@@ -9,10 +9,11 @@ import { lookup } from "mime-types";
 import { basename, extname } from "path";
 import request from "supertest";
 import { afterAll, beforeAll, describe, expect, it } from "vitest";
+import { HelloMultipartControllerBody } from "./hello-multipart.controller";
 
-const SAMPLE_UPLOAD_PATH = "./test/e2e/sample-upload.jpg";
+const SAMPLE_UPLOAD_PATH = "./test/integration/sample-upload.jpg";
 
-describe("[Controller] Hello multipart", () => {
+describe("[Controller] POST /hello/multipart", () => {
   let app: NestFastifyApplication;
 
   beforeAll(async () => {
@@ -32,14 +33,14 @@ describe("[Controller] Hello multipart", () => {
     await app.close();
   });
 
-  it("[POST] /hello/multipart", async () => {
+  it("should be able to upload a image", async () => {
     const fieldName = "attachment";
     const description = faker.lorem.sentence();
 
     const response = await request(app.getHttpServer())
       .post("/hello/multipart")
       .attach(fieldName, SAMPLE_UPLOAD_PATH)
-      .field({ description });
+      .field({ description } satisfies HelloMultipartControllerBody);
 
     expect(response.statusCode).toEqual(200);
     expect(response.body).toEqual(

package/templates/nest/src/infra/http/controllers/hello/hello-multipart.controller.ts

@@ -9,10 +9,6 @@ const helloMultipartControllerBodySchema = z.object({
   description: z.string().min(2),
 });
 
-type HelloMultipartControllerBody = z.infer<
-  typeof helloMultipartControllerBodySchema
->;
-
 const helloMultipartControllerResponseSchema = z.object({
   message: z.literal("Hello world!"),
   description: z.string().min(2),
@@ -25,6 +21,10 @@ const helloMultipartControllerResponseSchema = z.object({
   }),
 });
 
+export type HelloMultipartControllerBody = z.infer<
+  typeof helloMultipartControllerBodySchema
+>;
+
 type HelloMultipartControllerResponse = z.infer<
   typeof helloMultipartControllerResponseSchema
 >;

package/templates/nest/src/infra/http/controllers/hello/hello.controller.integration-spec.ts

@@ -0,0 +1,62 @@
+import { AppModule } from "@/infra/app.module";
+import {
+  FastifyAdapter,
+  NestFastifyApplication,
+} from "@nestjs/platform-fastify";
+import { Test } from "@nestjs/testing";
+import request from "supertest";
+import { afterAll, beforeAll, describe, expect, it } from "vitest";
+import { HelloControllerQuery } from "./hello.controller";
+
+describe("[Controller] GET /hello", () => {
+  let app: NestFastifyApplication;
+
+  beforeAll(async () => {
+    const moduleRef = await Test.createTestingModule({
+      imports: [AppModule],
+    }).compile();
+
+    app = moduleRef.createNestApplication<NestFastifyApplication>(
+      new FastifyAdapter(),
+    );
+
+    await app.init();
+    await app.getHttpAdapter().getInstance().ready();
+  });
+
+  afterAll(async () => {
+    await app.close();
+  });
+
+  it("should be able to show hello world when setting true in the query parameter", async () => {
+    const response = await request(app.getHttpServer())
+      .get("/hello")
+      .query({ show: true } satisfies HelloControllerQuery);
+
+    expect(response.statusCode).toEqual(200);
+    expect(response.body).toStrictEqual({ message: "Hello world!" });
+  });
+
+  it("should not be able to show hello world when setting false in the query parameter", async () => {
+    const response = await request(app.getHttpServer())
+      .get("/hello")
+      .query({ show: false } satisfies HelloControllerQuery);
+
+    expect(response.statusCode).toEqual(400);
+    expect(response.body.error).toEqual("BAD_REQUEST_ERROR");
+  });
+
+  describe("Input data validations", () => {
+    it("with invalid show property", async () => {
+      const response = await request(app.getHttpServer())
+        .get("/hello")
+        .query({
+          // @ts-expect-error the value must be a boolean
+          show: 0,
+        } satisfies HelloControllerQuery);
+
+      expect(response.statusCode).toEqual(400);
+      expect(response.body.error).toEqual("VALIDATION_ERROR");
+    });
+  });
+});

package/templates/nest/src/infra/http/controllers/hello/hello.controller.ts

@@ -1,12 +1,7 @@
-import {
-  BadRequestException,
-  Controller,
-  Get,
-  HttpCode,
-  Query,
-} from "@nestjs/common";
+import { Controller, Get, HttpCode, Query } from "@nestjs/common";
 import { ApiOperation, ApiTags } from "@nestjs/swagger";
 import { z } from "zod";
+import { BadRequestError } from "../../errors/bad-request.error";
 import { ZodSchemaPipe } from "../../middlewares/zod-schema-pipe";
 
 export const helloControllerQuerySchema = z.object({
@@ -16,12 +11,12 @@ export const helloControllerQuerySchema = z.object({
     .transform<boolean>(val => JSON.parse(val)),
 });
 
-type HelloControllerQuery = z.infer<typeof helloControllerQuerySchema>;
-
 const helloControllerResponseSchema = z.object({
   message: z.literal("Hello world!"),
 });
 
+export type HelloControllerQuery = z.infer<typeof helloControllerQuerySchema>;
+
 type HelloControllerResponse = z.infer<typeof helloControllerResponseSchema>;
 
 @Controller()
@@ -42,9 +37,7 @@ export class HelloController {
     const { show } = query;
 
     if (!show)
-      throw new BadRequestException(
-        `You don't want to display the "hello world"!`,
-      );
+      throw new BadRequestError(`You don't want to display the "hello world"!`);
 
     return { message: "Hello world!" };
   }

package/templates/nest/src/infra/http/errors/bad-request.error.ts

@@ -0,0 +1,18 @@
+import { ErrorPresenter } from "@/infra/presenters/error.presenter";
+import { HttpException } from "@nestjs/common";
+
+export class BadRequestError extends HttpException {
+  static readonly statusCode = 400;
+  static readonly error = "BAD_REQUEST_ERROR";
+  static readonly debug = null;
+
+  constructor(public message: string) {
+    super(
+      ErrorPresenter.toHttp(BadRequestError.statusCode, {
+        ...BadRequestError,
+        message,
+      }),
+      BadRequestError.statusCode,
+    );
+  }
+}

package/templates/nest/src/infra/http/errors/filters/all-exception.filter.ts

@@ -13,19 +13,19 @@ export class AllExceptionFilter implements ExceptionFilter {
     const ctx = host.switchToHttp();
     const response = ctx.getResponse<FastifyReply>();
 
-    const debug =
-      exception && typeof exception === "object" && "message" in exception
-        ? exception.message
-        : null;
+    let httpError: HttpException;
 
-    let httpException: HttpException = new InternalServerError(debug);
+    if (exception instanceof HttpException) httpError = exception;
+    else {
+      const debugFromUnknownError =
+        exception && typeof exception === "object" && "message" in exception
+          ? exception.message
+          : null;
 
-    if (exception instanceof HttpException) httpException = exception;
+      httpError = new InternalServerError(debugFromUnknownError);
+      console.error(httpError);
+    }
 
-    console.error(exception);
-
-    response
-      .status(httpException.getStatus())
-      .send(httpException.getResponse());
+    response.status(httpError.getStatus()).send(httpError.getResponse());
   }
 }

package/templates/nest/src/infra/http/errors/internal-server.error.ts

@@ -2,14 +2,17 @@ import { ErrorPresenter } from "@/infra/presenters/error.presenter";
 import { HttpException } from "@nestjs/common";
 
 export class InternalServerError extends HttpException {
-  constructor(debug: unknown) {
-    const statusCode = 500;
-    const presenter = ErrorPresenter.toHttp(statusCode, {
-      error: "InternalServerError",
-      message: "Desculpe, um erro inesperado ocorreu.",
-      debug,
-    });
+  static readonly statusCode = 500;
+  static readonly error = "INTERNAL_SERVER_ERROR";
+  static readonly message = "Desculpe, um erro inesperado ocorreu.";
 
-    super(presenter, statusCode);
+  constructor(debug: unknown) {
+    super(
+      ErrorPresenter.toHttp(InternalServerError.statusCode, {
+        ...InternalServerError,
+        debug,
+      }),
+      InternalServerError.statusCode,
+    );
   }
 }

package/templates/nest/src/infra/http/errors/upload-validation.error.ts

@@ -2,16 +2,22 @@ import { ErrorPresenter } from "@/infra/presenters/error.presenter";
 import { HttpException } from "@nestjs/common";
 
 export class UploadValidationError extends HttpException {
-  constructor(statusCode = 400, debug: object = {}) {
-    const presenter = ErrorPresenter.toHttp(statusCode, {
-      error: "UploadValidationError",
-      message: "Os dados enviados são inválidos.",
-      debug: {
-        multerError: null,
-        ...debug,
-      },
-    });
+  static readonly error = "UPLOAD_VALIDATION_ERROR";
 
-    super(presenter, statusCode);
+  constructor(
+    public statusCode = 400,
+    public debug = {},
+  ) {
+    super(
+      ErrorPresenter.toHttp(statusCode, {
+        ...UploadValidationError,
+        message: "Os dados enviados são inválidos.",
+        debug: {
+          multerError: null,
+          ...debug,
+        },
+      }),
+      statusCode,
+    );
   }
 }

package/templates/nest/src/infra/http/errors/validation.error.ts

@@ -0,0 +1,21 @@
+import { ErrorPresenter } from "@/infra/presenters/error.presenter";
+import { HttpException } from "@nestjs/common";
+
+export class ValidationError extends HttpException {
+  static readonly statusCode = 400;
+  static readonly error = "VALIDATION_ERROR";
+
+  constructor(
+    public debug: unknown = null,
+    public message = "Os dados enviados são inválidos.",
+  ) {
+    super(
+      ErrorPresenter.toHttp(ValidationError.statusCode, {
+        ...ValidationError,
+        message,
+        debug,
+      }),
+      ValidationError.statusCode,
+    );
+  }
+}

package/templates/nest/src/infra/http/http.module.ts

@@ -3,7 +3,6 @@ import { APP_FILTER } from "@nestjs/core";
 import { HelloMultipartController } from "./controllers/hello/hello-multipart.controller";
 import { HelloController } from "./controllers/hello/hello.controller";
 import { AllExceptionFilter } from "./errors/filters/all-exception.filter";
-import { DomainExceptionFilter } from "./errors/filters/domain-exception.filter";
 import { FastifyMulterEventModule } from "./events/fastify-multer.event.module";
 
 @Module({
@@ -13,10 +12,6 @@ import { FastifyMulterEventModule } from "./events/fastify-multer.event.module";
       provide: APP_FILTER,
       useClass: AllExceptionFilter,
     },
-    {
-      provide: APP_FILTER,
-      useClass: DomainExceptionFilter,
-    },
   ],
   controllers: [HelloController, HelloMultipartController],
 })

package/templates/nest/src/infra/http/middlewares/upload-interceptor.ts

@@ -15,9 +15,11 @@ import multer, {
   memoryStorage,
 } from "fastify-multer";
 import { File, FileFilter, StorageEngine } from "fastify-multer/lib/interfaces";
+import { unlink } from "fs/promises";
 import { extension } from "mime-types";
 import { extname } from "path";
 import prettyBytes from "pretty-bytes";
+import { finalize } from "rxjs";
 import { ZodObject, ZodRawShape, z } from "zod";
 import { UploadValidationError } from "../errors/upload-validation.error";
 import { zodSchemaToSwaggerSchema } from "./zod-schema-pipe";
@@ -108,6 +110,12 @@ type UploadInterceptorOptions = Storage & {
    * Infinity
    */
   maxNonFileFieldSize?: number;
+  /**
+   * Removes all uploaded files after handler execution.
+   *
+   * @default true
+   */
+  removeFilesAfterHandlerExecution?: boolean;
 };
 
 /**
@@ -123,6 +131,7 @@ export function UploadInterceptor(options: UploadInterceptorOptions) {
     maxFileSize,
     nonFileFieldsZodSchema,
     maxNonFileFieldSize,
+    removeFilesAfterHandlerExecution,
     ...restOptions
   } = {
     destination: "./tmp",
@@ -132,6 +141,7 @@ export function UploadInterceptor(options: UploadInterceptorOptions) {
     maxFileSize: 50,
     nonFileFieldsZodSchema: z.object({}),
     maxNonFileFieldSize: 1,
+    removeFilesAfterHandlerExecution: true,
     ...options,
   };
   const nonFileFieldsSwaggerSchema = zodSchemaToSwaggerSchema(
@@ -211,24 +221,28 @@ export function UploadInterceptor(options: UploadInterceptorOptions) {
   };
 
   const megabytesToBytes = (mb: number) => mb * 1000 * 1000;
+  const interceptors: NestInterceptor[] = [
+    new ExecuteUploadInterceptor({
+      multerInstance: multer({
+        storage: getMulterStorage(),
+        fileFilter: setMulterFileFilter,
+        limits: {
+          files: maxFileCount,
+          fileSize: megabytesToBytes(maxFileSize),
+          fields: Infinity,
+          fieldSize: megabytesToBytes(maxNonFileFieldSize),
+        },
+      }),
+      fieldName,
+      required,
+    }),
+  ];
+
+  if (removeFilesAfterHandlerExecution)
+    interceptors.push(new RemoveUploadsInterceptor());
 
   return applyDecorators(
-    UseInterceptors(
-      new ExecuteUploadInterceptor({
-        multerInstance: multer({
-          storage: getMulterStorage(),
-          fileFilter: setMulterFileFilter,
-          limits: {
-            files: maxFileCount,
-            fileSize: megabytesToBytes(maxFileSize),
-            fields: Object.keys(nonFileFieldsZodSchema.shape).length,
-            fieldSize: megabytesToBytes(maxNonFileFieldSize),
-          },
-        }),
-        fieldName,
-        required,
-      }),
-    ),
+    UseInterceptors(...interceptors),
     ApiConsumes("multipart/form-data"),
     ApiBody({
       schema: {
@@ -366,3 +380,26 @@ export class ExecuteUploadInterceptor implements NestInterceptor {
     return next.handle();
   }
 }
+
+export class RemoveUploadsInterceptor implements NestInterceptor {
+  intercept(context: ExecutionContext, next: CallHandler) {
+    const ctx = context.switchToHttp();
+    const request = ctx.getRequest<FastifyRequestWithFile>();
+
+    return next.handle().pipe(
+      finalize(async () => {
+        const { file, files } = request;
+
+        if (file && file.path) await unlink(file.path);
+
+        if (files) {
+          await Promise.all(
+            files.map(async file => {
+              if (file.path) return unlink(file.path);
+            }),
+          );
+        }
+      }),
+    );
+  }
+}

package/templates/nest/src/infra/http/middlewares/zod-validation-pipe.ts

@@ -1,6 +1,6 @@
-import { ValidationError } from "@/core/errors/validation.error";
 import { ArgumentMetadata, PipeTransform } from "@nestjs/common";
 import { ZodError, ZodObject, ZodRawShape, ZodType } from "zod";
+import { ValidationError } from "../errors/validation.error";
 
 export interface ZodValidationPipeSchemas {
   routeParams?: ZodObject<ZodRawShape>;

package/templates/nest/src/infra/presenters/error.presenter.ts

@@ -1,10 +1,8 @@
-import { DomainError } from "@/core/errors/domain-error";
+import { DomainErrorCoreProperties } from "@/core/domain-error";
 import { env } from "../env";
 
-type CustomError = Pick<DomainError, "error" | "message" | "debug">;
-
 export class ErrorPresenter {
-  public static toHttp(statusCode: number, error: DomainError | CustomError) {
+  public static toHttp(statusCode: number, error: DomainErrorCoreProperties) {
     return {
       error: error.error,
       message: error.message,

package/templates/nest/{vitest.config.e2e.mts → vitest.config.integration.mts}

@@ -3,6 +3,6 @@ import defaultConfig from "./vitest.config.mjs";
 
 export default mergeConfig(defaultConfig, {
   test: {
-    include: ["./**/*.e2e-spec.ts"],
+    include: ["./**/*.integration-spec.ts"],
   },
 });

package/templates/fastify/src/core/errors/errors.ts

@@ -1,9 +0,0 @@
-import { DomainError } from "./domain-error";
-
-export class ValidationError extends DomainError {
-  public error = "ValidationError";
-
-  constructor(public debug: object | null = null) {
-    super("Os dados enviados são inválidos.");
-  }
-}

package/templates/fastify/src/infra/http/controllers/hello/hello.controller.e2e-spec.ts

@@ -1,14 +0,0 @@
-import { app } from "@/infra/http/app";
-import request from "supertest";
-import { describe, expect, it } from "vitest";
-
-describe("[Controller] Hello", () => {
-  it("[GET] /hello", async () => {
-    const response = await request(app.server)
-      .get("/hello")
-      .query({ show: true });
-
-    expect(response.statusCode).toEqual(200);
-    expect(response.body).toEqual({ message: "Hello world!" });
-  });
-});

package/templates/fastify/src/infra/http/errors/http-error.ts

@@ -1,9 +0,0 @@
-export abstract class HttpError extends Error {
-  public abstract error: string;
-  public abstract statusCode: number;
-  public abstract debug: unknown;
-
-  constructor(public message: string) {
-    super(message);
-  }
-}

package/templates/fastify/src/infra/http/routes/hello.routes.ts

@@ -1,8 +0,0 @@
-import { helloMultipartController } from "@/infra/http/controllers/hello/hello-multipart.controller";
-import { helloController } from "@/infra/http/controllers/hello/hello.controller";
-import { FastifyInstance } from "fastify";
-
-export async function helloRoutes(app: FastifyInstance) {
-  app.register(helloController);
-  app.register(helloMultipartController);
-}

package/templates/fastify/src/infra/http/routes/index.ts

@@ -1,6 +0,0 @@
-import { FastifyInstance } from "fastify";
-import { helloRoutes } from "./hello.routes";
-
-export async function routes(app: FastifyInstance) {
-  app.register(helloRoutes);
-}

package/templates/nest/src/core/errors/domain-error.ts

@@ -1,8 +0,0 @@
-export abstract class DomainError extends Error {
-  public abstract error: string;
-  public abstract debug: unknown;
-
-  constructor(public message: string) {
-    super(message);
-  }
-}

package/templates/nest/src/core/errors/validation.error.ts

@@ -1,12 +0,0 @@
-import { DomainError } from "./domain-error";
-
-export class ValidationError extends DomainError {
-  public error = "ValidationError" as const;
-  public debug: object | null;
-
-  constructor(debug?: object) {
-    super("Os dados recebidos são inválidos.");
-
-    this.debug = debug ?? null;
-  }
-}

package/templates/nest/src/infra/http/controllers/hello/hello.controller.e2e-spec.ts

@@ -1,38 +0,0 @@
-import { AppModule } from "@/infra/app.module";
-import {
-  FastifyAdapter,
-  NestFastifyApplication,
-} from "@nestjs/platform-fastify";
-import { Test } from "@nestjs/testing";
-import request from "supertest";
-import { afterAll, beforeAll, describe, expect, it } from "vitest";
-
-describe("[Controller] Hello", () => {
-  let app: NestFastifyApplication;
-
-  beforeAll(async () => {
-    const moduleRef = await Test.createTestingModule({
-      imports: [AppModule],
-    }).compile();
-
-    app = moduleRef.createNestApplication<NestFastifyApplication>(
-      new FastifyAdapter(),
-    );
-
-    await app.init();
-    await app.getHttpAdapter().getInstance().ready();
-  });
-
-  afterAll(async () => {
-    await app.close();
-  });
-
-  it("[GET] /hello", async () => {
-    const response = await request(app.getHttpServer())
-      .get("/hello")
-      .query({ show: true });
-
-    expect(response.statusCode).toEqual(200);
-    expect(response.body).toEqual({ message: "Hello world!" });
-  });
-});

package/templates/nest/src/infra/http/errors/filters/domain-exception.filter.ts

@@ -1,39 +0,0 @@
-import { DomainError } from "@/core/errors/domain-error";
-import { ValidationError } from "@/core/errors/validation.error";
-import { ErrorPresenter } from "@/infra/presenters/error.presenter";
-import {
-  ArgumentsHost,
-  BadRequestException,
-  Catch,
-  ExceptionFilter,
-  HttpException,
-} from "@nestjs/common";
-import { FastifyReply } from "fastify";
-import { InternalServerError } from "../internal-server.error";
-
-@Catch(DomainError)
-export class DomainExceptionFilter implements ExceptionFilter {
-  catch(exception: DomainError, host: ArgumentsHost): void {
-    const ctx = host.switchToHttp();
-    const response = ctx.getResponse<FastifyReply>();
-
-    let httpException: HttpException;
-
-    switch (exception.constructor) {
-      case ValidationError:
-        httpException = new BadRequestException(
-          ErrorPresenter.toHttp(400, exception),
-        );
-        break;
-
-      default:
-        httpException = new InternalServerError(exception.message);
-    }
-
-    console.error(exception);
-
-    response
-      .status(httpException.getStatus())
-      .send(httpException.getResponse());
-  }
-}