@leo-h/create-nodejs-app 1.0.70 → 1.0.72

package/package.json

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

package/templates/elysia/.env.example

@@ -5,4 +5,4 @@ API_NAME=
 API_PORT=
 
 # example: "https://my-client-app.com" (url - only constraint | regex - specific constraint | "*" - not constraint)
-API_ACCESS_PERMISSION_CLIENT_SIDE=
+API_CORS_ALLOW_ORIGIN=

package/templates/elysia/.env.test

@@ -0,0 +1,6 @@
+# example: "app-name"
+API_NAME="app-name"
+
+# example: "3333"
+API_PORT="3333"
+

package/templates/elysia/biome.json

@@ -8,7 +8,12 @@
     "indentStyle": "space"
   },
   "linter": {
-    "enabled": true
+    "enabled": true,
+    "rules": {
+      "style": {
+        "noNonNullAssertion": "off"
+      }
+    }
   },
   "assist": {
     "enabled": false

package/templates/elysia/package.json

@@ -3,8 +3,8 @@
   "version": "1.0.0",
   "private": true,
   "scripts": {
-    "start": "node --env-file=.env ./dist/src/http/server.js",
-    "start:dev": "tsx watch --env-file=.env.development ./src/http/server.ts",
+    "start": "node ./dist/src/http/server.js",
+    "start:dev": "tsx watch ./src/http/server.ts",
     "typecheck": "tsc --noEmit",
     "lint": "biome lint",
     "lint:fix": "biome lint --write",
@@ -21,12 +21,13 @@
     "@elysiajs/cors": "1.4.0",
     "@elysiajs/node": "1.4.2",
     "@elysiajs/openapi": "1.4.11",
+    "dotenv": "17.2.3",
     "elysia": "1.4.16",
     "zod": "4.1.12"
   },
   "devDependencies": {
     "@biomejs/biome": "2.3.5",
-    "@elysiajs/eden": "^1.4.4",
+    "@elysiajs/eden": "^1.4.5",
     "@faker-js/faker": "^10.1.0",
     "@swc/cli": "0.7.8",
     "@types/node": "24.9.1",

package/templates/elysia/pnpm-lock.yaml

@@ -17,6 +17,9 @@ importers:
       '@elysiajs/openapi':
         specifier: 1.4.11
         version: 1.4.11(elysia@1.4.16(@sinclair/typebox@0.34.41)(exact-mirror@0.2.2(@sinclair/typebox@0.34.41))(file-type@20.5.0)(openapi-types@12.1.3)(typescript@5.9.3))
+      dotenv:
+        specifier: 17.2.3
+        version: 17.2.3
       elysia:
         specifier: 1.4.16
         version: 1.4.16(@sinclair/typebox@0.34.41)(exact-mirror@0.2.2(@sinclair/typebox@0.34.41))(file-type@20.5.0)(openapi-types@12.1.3)(typescript@5.9.3)
@@ -28,8 +31,8 @@ importers:
         specifier: 2.3.5
         version: 2.3.5
       '@elysiajs/eden':
-        specifier: ^1.4.4
-        version: 1.4.4(elysia@1.4.16(@sinclair/typebox@0.34.41)(exact-mirror@0.2.2(@sinclair/typebox@0.34.41))(file-type@20.5.0)(openapi-types@12.1.3)(typescript@5.9.3))
+        specifier: ^1.4.5
+        version: 1.4.5(elysia@1.4.16(@sinclair/typebox@0.34.41)(exact-mirror@0.2.2(@sinclair/typebox@0.34.41))(file-type@20.5.0)(openapi-types@12.1.3)(typescript@5.9.3))
       '@faker-js/faker':
         specifier: ^10.1.0
         version: 10.1.0
@@ -121,10 +124,10 @@ packages:
     peerDependencies:
       elysia: '>= 1.4.0'
 
-  '@elysiajs/eden@1.4.4':
-    resolution: {integrity: sha512-/LVqflmgUcCiXb8rz1iRq9Rx3SWfIV/EkoNqDFGMx+TvOyo8QHAygFXAVQz7RHs+jk6n6mEgpI6KlKBANoErsQ==}
+  '@elysiajs/eden@1.4.5':
+    resolution: {integrity: sha512-hIOeH+S5NU/84A7+t8yB1JjxqjmzRkBF9fnLn6y+AH8EcF39KumOAnciMhIOkhhThVZvXZ3d+GsizRc+Fxoi8g==}
     peerDependencies:
-      elysia: '>= 1.4.0-exp.0'
+      elysia: '>= 1.4.0'
 
   '@elysiajs/node@1.4.2':
     resolution: {integrity: sha512-zqeBAV4/faCcmIEjCp3g6jRwsbaWsd5HqmlEf3CirD9HkTWQNo4T+GN/qGZi7zgd84D3Kzxsny7ZTMXEfrDSXQ==}
@@ -848,6 +851,10 @@ packages:
     resolution: {integrity: sha512-4tvttepXG1VaYGrRibk5EwJd1t4udunSOVMdLSAL6mId1ix438oPwPZMALY41FCijukO1L0twNcGsdzS7dHgDg==}
     engines: {node: '>=10'}
 
+  dotenv@17.2.3:
+    resolution: {integrity: sha512-JVUnt+DUIzu87TABbhPmNfVdBDt18BLOWjMUFJMSi/Qqg7NTYtabbvSNJGOJ7afbRuv9D/lngizHtP7QyLQ+9w==}
+    engines: {node: '>=12'}
+
   eastasianwidth@0.2.0:
     resolution: {integrity: sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==}
 
@@ -1466,7 +1473,7 @@ snapshots:
     dependencies:
       elysia: 1.4.16(@sinclair/typebox@0.34.41)(exact-mirror@0.2.2(@sinclair/typebox@0.34.41))(file-type@20.5.0)(openapi-types@12.1.3)(typescript@5.9.3)
 
-  '@elysiajs/eden@1.4.4(elysia@1.4.16(@sinclair/typebox@0.34.41)(exact-mirror@0.2.2(@sinclair/typebox@0.34.41))(file-type@20.5.0)(openapi-types@12.1.3)(typescript@5.9.3))':
+  '@elysiajs/eden@1.4.5(elysia@1.4.16(@sinclair/typebox@0.34.41)(exact-mirror@0.2.2(@sinclair/typebox@0.34.41))(file-type@20.5.0)(openapi-types@12.1.3)(typescript@5.9.3))':
     dependencies:
       elysia: 1.4.16(@sinclair/typebox@0.34.41)(exact-mirror@0.2.2(@sinclair/typebox@0.34.41))(file-type@20.5.0)(openapi-types@12.1.3)(typescript@5.9.3)
 
@@ -2049,6 +2056,8 @@ snapshots:
 
   defer-to-connect@2.0.1: {}
 
+  dotenv@17.2.3: {}
+
   eastasianwidth@0.2.0: {}
 
   elysia@1.4.16(@sinclair/typebox@0.34.41)(exact-mirror@0.2.2(@sinclair/typebox@0.34.41))(file-type@20.5.0)(openapi-types@12.1.3)(typescript@5.9.3):

package/templates/elysia/src/env.ts

@@ -1,14 +1,48 @@
 import packageJson from "@/../package.json";
+import { config } from "dotenv";
 import { existsSync, mkdirSync } from "node:fs";
 import { resolve } from "node:path";
 import { z } from "zod";
 
-const nodeEnv = ["production", "development", "test"] as const;
+const envFilesForEachEnvironment = {
+  production: ".env",
+  development: ".env.development",
+  test: ".env.test",
+} as const;
+
+if (process.env?.npm_lifecycle_event === "start")
+  process.env.NODE_ENV = "production";
+
+if (
+  [":dev", "dev:"].some((subcommand) =>
+    process.env.npm_lifecycle_event?.includes(subcommand),
+  )
+)
+  process.env.NODE_ENV = "development";
+
+if (
+  [":test", "test:"].some((subcommand) =>
+    process.env.npm_lifecycle_event?.includes(subcommand),
+  )
+)
+  process.env.NODE_ENV = "test";
+
+const nodeEnvEnum = ["production", "development", "test"] as const;
+const nodeEnv = process.env.NODE_ENV as (typeof nodeEnvEnum)[number];
+const envFilePath = resolve(process.cwd(), envFilesForEachEnvironment[nodeEnv]);
+
+if (!existsSync(envFilePath))
+  throw new Error(
+    `Cannot find environment variables file in "${envFilePath}".`,
+  );
+
+config({
+  path: envFilePath,
+  quiet: nodeEnv === "test",
+});
 
 const schema = z.object({
-  NODE_ENV: z
-    .enum(nodeEnv)
-    .default(process.env.NODE_ENV as (typeof nodeEnv)[number]),
+  NODE_ENV: z.enum(nodeEnvEnum).default(nodeEnv),
   API_NAME: z.string().default(packageJson.name),
   API_PORT: z.coerce.number().default(3333),
   API_CORS_ALLOW_ORIGIN: z.string().default("*"),
@@ -27,7 +61,7 @@ const schema = z.object({
 const parsedEnv = schema.safeParse(process.env);
 
 if (!parsedEnv.success) {
-  console.error(parsedEnv.error.flatten().fieldErrors);
+  console.error(z.treeifyError(parsedEnv.error).properties);
 
   throw new Error("Invalid environment variables.");
 }

package/templates/elysia/src/http/app.ts

@@ -6,8 +6,7 @@ import openapi, { fromTypes } from "@elysiajs/openapi";
 import { Elysia } from "elysia";
 import z from "zod";
 import { controllers } from "./controllers";
-import "./controllers/hello.controller";
-import { globalErrorHandlerPlugin } from "./plugins/global-error-handler.plugin";
+import { NotFoundError } from "./errors";
 
 export const openApiUrlPathname = "/openapi";
 
@@ -37,5 +36,8 @@ export const app = new Elysia({
       references: fromTypes(`.${__filename.replace(process.cwd(), "")}`),
     }),
   )
-  .use(globalErrorHandlerPlugin.plugin())
+  .onError(({ code }) => {
+    if (code === "NOT_FOUND")
+      return new NotFoundError().setCode("NONEXISTENT_ROUTE").toController();
+  })
   .use(controllers);

package/templates/elysia/src/http/controllers/hello-multipart.controller.spec.ts

@@ -1,7 +1,7 @@
 import { faker } from "@faker-js/faker";
 import { apiTestClient } from "test/integration/api-test-client";
 import { beforeEach, describe, expect, test } from "vitest";
-import { ValidationError } from "../errors";
+import { UnprocessableEntityError } from "../errors";
 import { helloController } from "./hello.controller";
 
 const [route] = helloController.routes;
@@ -27,7 +27,7 @@ describe(`[Controller] ${route.method} ${route.path}`, () => {
 
   describe("should not be able to get hello world", () => {
     describe("if invalid input", () => {
-      const error = new ValidationError();
+      const error = new UnprocessableEntityError().setCode("VALIDATION");
 
       test("with invalid property show", async () => {
         const result = await sut(defaultInput, {
@@ -54,9 +54,9 @@ describe(`[Controller] ${route.method} ${route.path}`, () => {
         },
       });
 
-      const error = new ValidationError().setMessage(
-        "Você não quer exibir o 'Hello world' :(",
-      );
+      const error = new UnprocessableEntityError()
+        .setCode("VALIDATION")
+        .setMessage("Você não quer exibir o 'Hello world' :(");
 
       expect(result.status).toEqual(error.statusCode);
       expect(result.error).toMatchObject({ value: error.toSerialize() });

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

@@ -1,51 +1,66 @@
 import Elysia, { status } from "elysia";
 import z from "zod";
-import { ValidationError } from "../errors";
-import { globalErrorHandlerPlugin } from "../plugins/global-error-handler.plugin";
+import { UnprocessableEntityError } from "../errors";
+import { controllerErrorHandlerPlugin } from "../plugins/controller-error-handler.plugin";
 
-export const helloMultipartController = new Elysia().post(
-  "/hello/multipart",
-  ({ query, body }) => {
-    const { show } = query;
-    const { attachment } = body;
+export const helloMultipartController = new Elysia()
+  .use(controllerErrorHandlerPlugin.plugin())
+  .post(
+    "/hello/multipart",
+    ({ query, body }) => {
+      const { show } = query;
+      const attachment = body.attachment as z.core.File;
 
-    if (!show)
-      return new ValidationError()
-        .setMessage("Você não quer exibir o 'Hello world' :(")
-        .setDebug(
-          "Utilize o parâmetro de consulta 'show' com o valor 'true' para exibir o 'Hello world'.",
-        )
-        .toController();
+      if (!show)
+        return new UnprocessableEntityError()
+          .setCode("VALIDATION")
+          .setMessage("Você não quer exibir o 'Hello world' :(")
+          .setDebug(
+            "Utilize o parâmetro de consulta 'show' com o valor 'true' para exibir o 'Hello world'.",
+          )
+          .toController();
 
-    return status(200, {
-      message: "Hello world!",
-      attachment: {
-        name: attachment.name,
-        mimetype: attachment.type,
-        size: attachment.size,
-      },
-    });
-  },
-  {
-    query: z.object({
-      show: z
-        .enum(["true", "false"])
-        .transform<boolean>((val) => JSON.parse(val)),
-    }),
-    body: z.object({
-      attachment: z
-        .file()
-        .max(1024 * 1024 * 50) // 50MB
-        .mime("text/plain"),
-    }),
-    parse: "multipart/form-data",
-    response: {
-      ...globalErrorHandlerPlugin.getErrorSchemas(),
+      return status(200, {
+        message: "Hello world!",
+        attachment: {
+          name: attachment.name,
+          mimetype: attachment.type,
+          size: attachment.size,
+        },
+      });
     },
-    detail: {
-      operationId: "helloMultipartController",
-      tags: ["Hello"],
-      summary: "Hello world multipart!",
+    {
+      query: z.object({
+        show: z
+          .enum(["true", "false"])
+          .transform<boolean>((val) => JSON.parse(val)),
+      }),
+      body: z.object({
+        attachment: z
+          .file()
+          .max(1024 * 1024 * 50) // 50MB
+          .mime("text/plain")
+          // BUG(@elysiajs/openapi 1.4.11): Elysia stops generating the open API response with "fromTypes" function for the current route when using z.file()
+          // biome-ignore lint/suspicious/noExplicitAny: ↑
+          .transform((val) => val as any),
+      }),
+      response: {
+        // BUG(@elysiajs/openapi 1.4.11): Elysia is automatically inserting properties that it shouldn't for this class
+        422: new UnprocessableEntityError()
+          .setCode("VALIDATION")
+          .toZodSchema()
+          .or(
+            new UnprocessableEntityError()
+              .setCode("VALIDATION")
+              .setMessage("Você não quer exibir o 'Hello world' :(")
+              .toZodSchema(),
+          ),
+      },
+      parse: "multipart/form-data",
+      detail: {
+        operationId: "helloMultipartController",
+        tags: ["Hello"],
+        summary: "Hello world multipart!",
+      },
     },
-  },
-);
+  );

package/templates/elysia/src/http/controllers/hello.controller.spec.ts

@@ -1,6 +1,6 @@
 import { apiTestClient } from "test/integration/api-test-client";
 import { describe, expect, test } from "vitest";
-import { ValidationError } from "../errors";
+import { UnprocessableEntityError } from "../errors";
 import { helloController } from "./hello.controller";
 
 const [route] = helloController.routes;
@@ -9,7 +9,7 @@ const sut = apiTestClient.hello.get;
 describe(`[Controller] ${route.method} ${route.path}`, () => {
   describe("should not be able to get hello world", () => {
     describe("if invalid input", () => {
-      const error = new ValidationError();
+      const error = new UnprocessableEntityError().setCode("VALIDATION");
 
       test("with invalid property show", async () => {
         const result = await sut({
@@ -36,9 +36,9 @@ describe(`[Controller] ${route.method} ${route.path}`, () => {
         },
       });
 
-      const error = new ValidationError().setMessage(
-        "Você não quer exibir o 'Hello world' :(",
-      );
+      const error = new UnprocessableEntityError()
+        .setCode("VALIDATION")
+        .setMessage("Você não quer exibir o 'Hello world' :(");
 
       expect(result.status).toEqual(error.statusCode);
       expect(result.error).toMatchObject({ value: error.toSerialize() });

package/templates/elysia/src/http/controllers/hello.controller.ts

@@ -1,36 +1,36 @@
 import Elysia, { status } from "elysia";
 import z from "zod";
-import { ValidationError } from "../errors";
-import { globalErrorHandlerPlugin } from "../plugins/global-error-handler.plugin";
+import { UnprocessableEntityError } from "../errors";
+import { controllerErrorHandlerPlugin } from "../plugins/controller-error-handler.plugin";
 
-export const helloController = new Elysia().get(
-  "/hello",
-  ({ query }) => {
-    const { show } = query;
+export const helloController = new Elysia()
+  .use(controllerErrorHandlerPlugin.plugin())
+  .get(
+    "/hello",
+    ({ query }) => {
+      const { show } = query;
 
-    if (!show)
-      return new ValidationError()
-        .setMessage("Você não quer exibir o 'Hello world' :(")
-        .setDebug(
-          "Utilize o parâmetro de consulta 'show' com o valor 'true' para exibir o 'Hello world'.",
-        )
-        .toController();
+      if (!show)
+        return new UnprocessableEntityError()
+          .setCode("VALIDATION")
+          .setMessage("Você não quer exibir o 'Hello world' :(")
+          .setDebug(
+            "Utilize o parâmetro de consulta 'show' com o valor 'true' para exibir o 'Hello world'.",
+          )
+          .toController();
 
-    return status(200, { message: "Hello world!" });
-  },
-  {
-    query: z.object({
-      show: z
-        .enum(["true", "false"])
-        .transform<boolean>((val) => JSON.parse(val)),
-    }),
-    response: {
-      ...globalErrorHandlerPlugin.getErrorSchemas(),
+      return status(200, { message: "Hello world!" });
     },
-    detail: {
-      operationId: "helloController",
-      tags: ["Hello"],
-      summary: "Hello world!",
+    {
+      query: z.object({
+        show: z
+          .enum(["true", "false"])
+          .transform<boolean>((val) => JSON.parse(val)),
+      }),
+      detail: {
+        operationId: "helloController",
+        tags: ["Hello"],
+        summary: "Hello world!",
+      },
     },
-  },
-);
+  );

package/templates/elysia/src/http/errors.ts

@@ -7,16 +7,23 @@ export abstract class BaseError<
   Name extends string = string,
   StatusCode extends number = number,
   Message extends string = string, // It cannot be undefined because of the native Error type.
+  Code extends string | null = null,
   Debug = undefined,
 > extends Error {
   public abstract name: Name;
   public abstract statusCode: StatusCode;
   public message!: Message;
+  public code!: Code;
   public debug!: Debug;
 
+  // biome-ignore lint/complexity/noUselessConstructor: this is necessary to prevent arguments when instantiating.
+  public constructor() {
+    super();
+  }
+
   private getUnbuildInstance<
-    StatusCode extends number,
     Message extends string,
+    Code extends string | null,
     Debug,
   >() {
     return this as unknown as BaseError<
@@ -24,34 +31,34 @@ export abstract class BaseError<
       Name,
       StatusCode,
       Message,
+      Code,
       Debug
     >;
   }
 
-  public setStatusCode<const StatusCodeInput extends number>(
-    statusCode: StatusCodeInput,
-  ) {
-    this.statusCode = statusCode as unknown as StatusCode;
+  public setCode<const CodeInput extends string>(code: CodeInput) {
+    this.code = code as unknown as Code;
 
-    return this.getUnbuildInstance<StatusCodeInput, Message, Debug>();
+    return this.getUnbuildInstance<Message, CodeInput, Debug>();
   }
 
   public setMessage<const MessageInput extends string>(message: MessageInput) {
     this.message = message as unknown as Message;
 
-    return this.getUnbuildInstance<StatusCode, MessageInput, Debug>();
+    return this.getUnbuildInstance<MessageInput, Code, Debug>();
   }
 
   public setDebug<const DebugInput>(debug: DebugInput) {
     this.debug = debug as unknown as Debug;
 
-    return this.getUnbuildInstance<StatusCode, Message, DebugInput>();
+    return this.getUnbuildInstance<Message, Code, DebugInput>();
   }
 
   public toSerialize() {
     return {
       name: this.name,
       statusCode: this.statusCode,
+      code: this.code,
       message: this.message,
       ...(env.NODE_ENV !== "production" &&
         this.debug && {
@@ -65,22 +72,32 @@ export abstract class BaseError<
     {
       name: Name;
       statusCode: StatusCode;
-      message: string;
+      code: Code;
+      message: Message;
+      debug?: unknown;
     }
   > {
     return status(this.statusCode, this.toSerialize());
   }
 
-  public toZodSchema(options?: { isMessageLiteral?: boolean }) {
-    const { isMessageLiteral } = {
-      isMessageLiteral: false,
-      ...options,
+  public toZodSchema(
+    { nonLiteral }: { nonLiteral: ("code" | "message")[] } = { nonLiteral: [] },
+  ) {
+    const getCodeSchema = () => {
+      if (nonLiteral.includes("code")) return z.string();
+
+      if (this.code) return z.literal(this.code);
+
+      return z.null();
     };
 
     return z.object({
       name: z.literal(this.name),
       statusCode: z.literal(this.statusCode),
-      message: isMessageLiteral ? z.literal(this.message) : z.string(),
+      code: getCodeSchema(),
+      message: nonLiteral.includes("message")
+        ? z.string()
+        : z.literal(this.message),
     });
   }
 }
@@ -101,32 +118,86 @@ export class InternalServerError extends BaseError<
   public readonly message = InternalServerError.message;
 }
 
-export class ValidationError extends BaseError<
-  ValidationError,
-  typeof ValidationError.name,
-  typeof ValidationError.statusCode,
-  typeof ValidationError.message
+export class BadRequestError extends BaseError<
+  BadRequestError,
+  typeof BadRequestError.name,
+  typeof BadRequestError.statusCode
 > {
-  public static readonly name = "VALIDATION_ERROR";
+  public static readonly name = "BAD_REQUEST_ERROR";
+  public static readonly statusCode = 400;
+
+  public readonly name = BadRequestError.name;
+  public readonly statusCode = BadRequestError.statusCode;
+}
+
+export class UnprocessableEntityError extends BaseError<
+  UnprocessableEntityError,
+  typeof UnprocessableEntityError.name,
+  typeof UnprocessableEntityError.statusCode,
+  typeof UnprocessableEntityError.message
+> {
+  public static readonly name = "UNPROCESSABLE_ENTITY";
   public static readonly statusCode = 422;
   public static readonly message = "Os dados enviados são inválidos.";
 
-  public readonly name = ValidationError.name;
-  public readonly statusCode = ValidationError.statusCode;
-  public readonly message = ValidationError.message;
+  public readonly name = UnprocessableEntityError.name;
+  public readonly statusCode = UnprocessableEntityError.statusCode;
+  public readonly message = UnprocessableEntityError.message;
 }
 
-export class ResourceNotFoundError extends BaseError<
-  ResourceNotFoundError,
-  typeof ResourceNotFoundError.name,
-  typeof ResourceNotFoundError.statusCode,
-  typeof ResourceNotFoundError.message
+export class NotFoundError extends BaseError<
+  NotFoundError,
+  typeof NotFoundError.name,
+  typeof NotFoundError.statusCode,
+  typeof NotFoundError.message
 > {
-  public static readonly name = "RESOURCE_NOT_FOUND_ERROR";
+  public static readonly name = "NOT_FOUND";
   public static readonly statusCode = 404;
   public static readonly message = "Recurso não encontrado.";
 
-  public readonly name = ResourceNotFoundError.name;
-  public readonly statusCode = ResourceNotFoundError.statusCode;
-  public readonly message = ResourceNotFoundError.message;
+  public readonly name = NotFoundError.name;
+  public readonly statusCode = NotFoundError.statusCode;
+  public readonly message = NotFoundError.message;
+}
+
+export class ConflictError extends BaseError<
+  ConflictError,
+  typeof ConflictError.name,
+  typeof ConflictError.statusCode
+> {
+  public static readonly name = "CONFLICT";
+  public static readonly statusCode = 409;
+
+  public readonly name = ConflictError.name;
+  public readonly statusCode = ConflictError.statusCode;
+}
+
+export class ForbiddenError extends BaseError<
+  ForbiddenError,
+  typeof ForbiddenError.name,
+  typeof ForbiddenError.statusCode,
+  typeof ForbiddenError.message
+> {
+  public static readonly name = "FORBIDDEN";
+  public static readonly statusCode = 403;
+  public static readonly message = "Acesso negado.";
+
+  public readonly name = ForbiddenError.name;
+  public readonly statusCode = ForbiddenError.statusCode;
+  public readonly message = ForbiddenError.message;
+}
+
+export class UnauthorizedError extends BaseError<
+  UnauthorizedError,
+  typeof UnauthorizedError.name,
+  typeof UnauthorizedError.statusCode,
+  typeof UnauthorizedError.message
+> {
+  public static readonly name = "UNAUTHORIZED";
+  public static readonly statusCode = 401;
+  public static readonly message = "Não autorizado.";
+
+  public readonly name = UnauthorizedError.name;
+  public readonly statusCode = UnauthorizedError.statusCode;
+  public readonly message = UnauthorizedError.message;
 }

package/templates/elysia/src/http/plugins/{global-error-handler.plugin.ts → controller-error-handler.plugin.ts}

@@ -1,34 +1,20 @@
-import type { ZodRestrictFieldsShape } from "@/@types/zod-utils";
 import Elysia, {
   InternalServerError as ElysiaInternalServerError,
 } from "elysia";
 import {
+  BadRequestError,
   InternalServerError,
-  ResourceNotFoundError,
-  ValidationError,
+  UnprocessableEntityError,
 } from "../errors";
 
-type MetadataResponse = ReturnType<typeof plugin> extends Elysia<
-  // biome-ignore-start lint/suspicious/noExplicitAny: unused generics
-  any,
-  any,
-  any,
-  // biome-ignore-end lint/suspicious/noExplicitAny: unused generics
-  infer Metadata
->
-  ? Metadata["response"]
-  : never;
-
 function plugin() {
-  return new Elysia({ name: "global-error-handler-plugin" }).onError(
-    { as: "global" },
+  return new Elysia({ name: "controller-error-handler-plugin" }).onError(
+    { as: "scoped" },
     ({ code, error }) => {
       switch (code) {
-        case "NOT_FOUND": {
-          return new ResourceNotFoundError().toController();
-        }
         case "VALIDATION": {
-          return new ValidationError()
+          return new UnprocessableEntityError()
+            .setCode("VALIDATION")
             .setDebug({
               elysiaCode: code,
               name: error.name,
@@ -40,8 +26,9 @@ function plugin() {
         case "PARSE":
         case "INVALID_COOKIE_SIGNATURE":
         case "INVALID_FILE_TYPE":
-          return new ValidationError()
-            .setStatusCode(400)
+          return new BadRequestError()
+            .setCode("VALIDATION")
+            .setMessage(UnprocessableEntityError.message)
             .setDebug({
               elysiaCode: code,
               name: error.name,
@@ -68,15 +55,6 @@ function plugin() {
   );
 }
 
-function getErrorSchemas() {
-  return {
-    "422": new ValidationError().toZodSchema(),
-    "400": new ValidationError().setStatusCode(400).toZodSchema(),
-    "500": new InternalServerError().toZodSchema(),
-  } satisfies Omit<ZodRestrictFieldsShape<MetadataResponse>, 404>;
-}
-
-export const globalErrorHandlerPlugin = Object.freeze({
+export const controllerErrorHandlerPlugin = Object.freeze({
   plugin,
-  getErrorSchemas,
 });

package/templates/elysia/vitest.config.mts

@@ -4,6 +4,9 @@ import { defineConfig } from "vitest/config";
 export default defineConfig({
   plugins: [viteTsconfigPaths()],
   test: {
+    env: {
+      NODE_ENV: "test",
+    },
     fakeTimers: {
       toFake: [
         "Date",

package/templates/elysia/.env.development

@@ -1,3 +0,0 @@
-API_NAME="app-name-development"
-API_PORT="3333"
-API_ACCESS_PERMISSION_CLIENT_SIDE="https://my-client-app.com"