@syntay/fastay 0.2.8 → 1.0.0

package/dist/app.d.ts

@@ -1,6 +1,7 @@
-import express from 'express';
-import { MiddlewareMap } from './middleware.js';
-import type { ServeStaticOptions } from 'serve-static';
+import express from "express";
+import { Server } from "node:http";
+import { MiddlewareMap } from "./middleware.js";
+import type { ServeStaticOptions } from "serve-static";
 /**
  * Express configuration options applied automatically by Fastay
  * before internal middleware and route loading.
@@ -85,32 +86,32 @@ export type CreateAppOptions = {
          */
         allowAnyOrigin?: boolean;
         /**
-         * Lista de origens específicas permitidas para envio de cookies.
-         * Exemplo: ["http://localhost:3000", "https://meusite.com"]
+         * List of specific origins allowed for sending cookies.
+         * Example: ["http://localhost:3000", "https://mysite.com"]
          */
         cookieOrigins?: string[];
         /**
-         * Se true, habilita envio de cookies cross-origin.
+         * If true, enables cross-origin cookie sending.
          * Default: false
          */
         credentials?: boolean;
         /**
-         * Lista de métodos HTTP permitidos, separados por vírgula.
+         * List of allowed HTTP methods, separated by commas.
          * Default: "GET,POST,PUT,PATCH,DELETE,OPTIONS"
          */
         methods?: string;
         /**
-         * Lista de cabeçalhos permitidos na requisição.
+         * List of headers allowed in the request.
          * Default: "Content-Type, Authorization"
          */
         headers?: string;
         /**
-         * Cabeçalhos expostos ao cliente.
-         * Exemplo: ["X-Custom-Header"]
+         * Headers displayed to the customer.
+         * Example: ["X-Custom-Header"]
          */
         exposedHeaders?: string;
         /**
-         * Tempo máximo de cache para requisições prévias (preflight), em segundos.
+         * Maximum cache time for preflight requests, in seconds.
          */
         maxAge?: number;
     };
@@ -129,35 +130,15 @@ export type CreateAppOptions = {
      * but before route mounting.
      */
     middlewares?: MiddlewareMap;
+    /**
+     * Controls the display of the X-Powered-By header in HTTP responses.
+     *
+     * **With `powered: true` (default):
+     **/
+    powered?: boolean;
 };
-/**
- * Bootstraps and configures a Fastay application.
- *
- * Fastay automatically:
- * - Discovers and registers routes defined in `apiDir`.
- * - Applies both built-in and user-provided middlewares.
- * - Exposes a health-check endpoint at `/_health`.
- *
- * @param opts - Configuration options for the Fastay application.
- * @returns A Promise that resolves to an Express `Application` instance.
- *
- * @example
- * ```ts
- * import { createApp } from '@syntay/fastay';
- * import cors from 'cors';
- * import helmet from 'helmet';
- *
- * void (async () => {
- *   await createApp({
- *     apiDir: './src/api',
- *     baseRoute: '/api',
- *     port: 5555,
- *     expressOptions: {
- *       middlewares: [cors(), helmet()],
- *     },
- *   });
- * })();
- * ```
- */
-export declare function createApp(opts?: CreateAppOptions): Promise<import("express-serve-static-core").Express>;
+export declare function createApp(opts?: CreateAppOptions): Promise<{
+    app: import("express-serve-static-core").Express;
+    server: Server<typeof import("http").IncomingMessage, typeof import("http").ServerResponse>;
+}>;
 //# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,OAA4C,MAAM,SAAS,CAAC;AAGnE,OAAO,EACL,aAAa,EAGd,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAKvD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC;IAEvC;;;OAGG;IACH,WAAW,CAAC,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAEjD;;;OAGG;IACH,iBAAiB,CAAC,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7D;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAE3C;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,kBAAkB,CAAC;KAC9B,CAAC;IAEF;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IAEF;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,CAAC,EAAE;QACX;;;WAGG;QACH,cAAc,CAAC,EAAE,OAAO,CAAC;QAEzB;;;WAGG;QACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QAEzB;;;WAGG;QACH,WAAW,CAAC,EAAE,OAAO,CAAC;QAEtB;;;WAGG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;QAEjB;;;WAGG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;QAEjB;;;WAGG;QACH,cAAc,CAAC,EAAE,MAAM,CAAC;QAExB;;WAEG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;OAGG;IACH,WAAW,CAAC,EAAE,aAAa,CAAC;CAC7B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,SAAS,CAAC,IAAI,CAAC,EAAE,gBAAgB,wDAsItD"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,OAA4C,MAAM,SAAS,CAAC;AACnE,OAAO,EAAgB,MAAM,EAAE,MAAM,WAAW,CAAC;AAGjD,OAAO,EACL,aAAa,EAGd,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAKvD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC;IAEvC;;;OAGG;IACH,WAAW,CAAC,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAEjD;;;OAGG;IACH,iBAAiB,CAAC,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7D;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAE3C;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,kBAAkB,CAAC;KAC9B,CAAC;IAEF;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IAEF;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,CAAC,EAAE;QACX;;;WAGG;QACH,cAAc,CAAC,EAAE,OAAO,CAAC;QAEzB;;;WAGG;QACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QAEzB;;;WAGG;QACH,WAAW,CAAC,EAAE,OAAO,CAAC;QAEtB;;;WAGG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;QAEjB;;;WAGG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;QAEjB;;;WAGG;QACH,cAAc,CAAC,EAAE,MAAM,CAAC;QAExB;;WAEG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;OAGG;IACH,WAAW,CAAC,EAAE,aAAa,CAAC;IAE5B;;;;QAII;IACJ,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAwFF,wBAAsB,SAAS,CAAC,IAAI,CAAC,EAAE,gBAAgB;;;GAqMtD"}

package/dist/app.js

@@ -1,11 +1,12 @@
-import express from 'express';
-import path from 'path';
-import { loadApiRoutes } from './router.js';
-import { loadFastayMiddlewares, createMiddleware, } from './middleware.js';
-import { logger } from './logger.js';
-import { printBanner } from './banner.js';
-import { RequestCookies } from './utils/cookies.js';
-import { formDataMiddleware } from './utils/formDataMiddleware.js';
+import express from "express";
+import { createServer } from "node:http";
+import path from "path";
+import { loadApiRoutes } from "./router.js";
+import { loadFastayMiddlewares, createMiddleware, } from "./middleware.js";
+import { logger } from "./logger.js";
+import { printBanner } from "./banner.js";
+import { RequestCookies } from "./utils/cookies.js";
+import { formDataMiddleware } from "./utils/formDataMiddleware.js";
 /**
  * Bootstraps and configures a Fastay application.
  *
@@ -35,50 +36,109 @@ import { formDataMiddleware } from './utils/formDataMiddleware.js';
  * })();
  * ```
  */
+/** pre-compiled CORS */
+function createCorsHandler(opts) {
+    if (!opts)
+        return null;
+    const { allowAnyOrigin = false, cookieOrigins = [], credentials = false, methods = "GET,POST,PUT,PATCH,DELETE,OPTIONS", headers = "Content-Type, Authorization", exposedHeaders, maxAge, } = opts;
+    return (req, res, next) => {
+        // Determine the origin in an optimized way.
+        let origin = "*";
+        if (credentials && cookieOrigins.length > 0) {
+            const requestOrigin = req.headers.origin;
+            if (requestOrigin && cookieOrigins.includes(requestOrigin)) {
+                origin = requestOrigin;
+            }
+            else {
+                origin = "";
+            }
+        }
+        else if (!credentials && allowAnyOrigin) {
+            origin = "*";
+        }
+        const corsHeaders = {
+            "Access-Control-Allow-Origin": origin,
+            "Access-Control-Allow-Credentials": credentials ? "true" : "false",
+            "Access-Control-Allow-Methods": methods,
+            "Access-Control-Allow-Headers": headers,
+        };
+        if (exposedHeaders) {
+            corsHeaders["Access-Control-Expose-Headers"] = exposedHeaders;
+        }
+        if (maxAge) {
+            corsHeaders["Access-Control-Max-Age"] = maxAge.toString();
+        }
+        for (const [key, value] of Object.entries(corsHeaders)) {
+            res.setHeader(key, value);
+        }
+        if (req.method === "OPTIONS") {
+            return res.sendStatus(204);
+        }
+        next();
+    };
+}
 export async function createApp(opts) {
     const start = logger.timeStart();
     printBanner();
     // logger.group('Fastay');
-    logger.info('Initializing server...');
-    const apiDir = opts?.apiDir ?? path.resolve(process.cwd(), 'src', 'api');
-    const baseRoute = opts?.baseRoute ?? '/api';
+    logger.info("Initializing server...");
+    const apiDir = opts?.apiDir ?? path.resolve(process.cwd(), "src", "api");
+    const baseRoute = opts?.baseRoute ?? "/api";
+    const port = opts?.port ?? 5000;
     logger.success(`API directory: ${apiDir}`);
     logger.success(`Base route: ${baseRoute}`);
     const app = express();
+    const server = createServer(app);
     if (opts?.expressOptions) {
         for (const [key, value] of Object.entries(opts.expressOptions)) {
-            // Se for array → assume middleware global
             if (Array.isArray(value)) {
                 value.forEach((mw) => app.use(mw));
             }
-            // Se o app tiver método com esse nome
-            else if (typeof app[key] === 'function') {
+            else if (typeof app[key] === "function") {
                 // TS-safe
                 app[key](value);
             }
             // special cases
-            else if (key === 'static' && value && typeof value === 'object') {
+            else if (key === "static" && value && typeof value === "object") {
                 const v = value;
                 app.use(express.static(v.path, v.options));
             }
-            else if (key === 'jsonOptions') {
+            else if (key === "jsonOptions") {
                 app.use(express.json(value));
             }
-            else if (key === 'urlencodedOptions') {
+            else if (key === "urlencodedOptions") {
                 app.use(express.urlencoded(value));
             }
         }
     }
-    app.use(express.json());
-    const defaltPort = opts?.port ? opts.port : 6000;
-    app.listen(defaltPort, () => {
-        logger.success(`Server running at http://localhost:${defaltPort}${baseRoute}`);
+    server.listen(port, () => {
+        logger.success(`Server running at http://localhost:${port}${baseRoute}`);
+    });
+    // CORS handler
+    const corsHandler = createCorsHandler(opts?.enableCors);
+    if (corsHandler) {
+        app.use(corsHandler);
+    }
+    // FormData middleware
+    app.use(formDataMiddleware());
+    // Fastay middlewares
+    if (opts?.middlewares) {
+        logger.group("Fastay Middlewares");
+        const apply = createMiddleware(opts.middlewares);
+        apply(app);
+    }
+    // Auto middlewares
+    await loadFastayMiddlewares(app);
+    // Health check
+    app.get("/health", (_, res) => {
+        res.setHeader("Content-Type", "application/json");
+        res.send('{"ok":true}');
     });
-    // external middlewares
+    // External middlewares
     if (opts?.expressOptions?.middlewares) {
-        logger.group('Express Middlewares');
+        logger.group("Express Middlewares");
         for (const mw of opts.expressOptions.middlewares) {
-            logger.gear(`Loaded: ${mw.name || 'anonymous'}`);
+            logger.gear(`Loaded: ${mw.name || "anonymous"}`);
             app.use(mw);
         }
     }
@@ -86,54 +146,91 @@ export async function createApp(opts) {
     app.use(formDataMiddleware());
     // Fastay middlewares
     if (opts?.middlewares) {
-        logger.group('Fastay Middlewares');
+        logger.group("Fastay Middlewares");
         const apply = createMiddleware(opts.middlewares);
         apply(app);
     }
     // automatic middlewares
     // logger.group('Fastay Auto-Middlewares');
     const isMiddleware = await loadFastayMiddlewares(app);
+    if (!opts?.expressOptions?.jsonOptions) {
+        app.use(express.json({ limit: "10mb" }));
+    }
     // health check
-    app.get('/_health', (_, res) => res.json({ ok: true }));
+    app.get("/_health", (_, res) => res.json({ ok: true }));
     app.use((req, res, next) => {
-        res.setHeader('X-Powered-By', 'Syntay Engine');
+        res.setHeader("X-Powered-By", "Syntay Engine");
         req.cookies = new RequestCookies(req.headers.cookie);
         const corsOpts = opts?.enableCors || {};
-        // Determina a origem
-        let origin = '*';
+        // Determine the origin
+        let origin = "*";
         if (corsOpts.credentials && corsOpts.cookieOrigins?.length) {
-            // Se a origem estiver na lista de cookieOrigins, permite cookies
+            // If the origin is in the cookieOrigins list, cookies are allowed.
             if (req.headers.origin &&
                 corsOpts.cookieOrigins.includes(req.headers.origin)) {
                 origin = req.headers.origin;
             }
             else {
-                origin = ''; // bloqueia cookies para outras origens
+                origin = ""; // blocks cookies from other sources
             }
         }
         else if (!corsOpts.credentials && corsOpts.allowAnyOrigin) {
-            origin = '*';
+            origin = "*";
         }
-        res.setHeader('Access-Control-Allow-Origin', origin);
-        res.setHeader('Access-Control-Allow-Credentials', corsOpts.credentials ? 'true' : 'false');
-        res.setHeader('Access-Control-Allow-Methods', corsOpts.methods || 'GET,POST,PUT,PATCH,DELETE,OPTIONS');
-        res.setHeader('Access-Control-Allow-Headers', corsOpts.headers || 'Content-Type, Authorization');
+        res.setHeader("Access-Control-Allow-Origin", origin);
+        res.setHeader("Access-Control-Allow-Credentials", corsOpts.credentials ? "true" : "false");
+        res.setHeader("Access-Control-Allow-Methods", corsOpts.methods || "GET,POST,PUT,PATCH,DELETE,OPTIONS");
+        res.setHeader("Access-Control-Allow-Headers", corsOpts.headers || "Content-Type, Authorization");
         if (corsOpts.exposedHeaders) {
-            res.setHeader('Access-Control-Expose-Headers', corsOpts.exposedHeaders);
+            res.setHeader("Access-Control-Expose-Headers", corsOpts.exposedHeaders);
         }
         if (corsOpts.maxAge) {
-            res.setHeader('Access-Control-Max-Age', corsOpts.maxAge.toString());
+            res.setHeader("Access-Control-Max-Age", corsOpts.maxAge.toString());
         }
-        if (req.method === 'OPTIONS')
+        if (req.method === "OPTIONS")
             return res.sendStatus(204);
         next();
     });
-    // load routes
-    // logger.group('Routes Loaded');
+    app.use((req, res, next) => {
+        opts?.powered && res.setHeader("X-Powered-By", "Syntay Engine");
+        // Optimized cookie parsing
+        req.cookies = new RequestCookies(req.headers.cookie);
+        next();
+    });
+    // Route loading
     const totalRoutes = await loadApiRoutes(app, baseRoute, apiDir);
-    logger.success(`Total routes loaded: ${totalRoutes}`);
+    // The error handler should come after the routes.
+    if (opts?.expressOptions?.errorHandler) {
+        app.use(opts.expressOptions.errorHandler);
+    }
+    else {
+        // Optimized default error handler
+        app.use((err, req, res, next) => {
+            logger.error(`Unhandled Error [${req.method} ${req.path}]: ${err.message}`);
+            res.status(500).json({
+                error: "Internal Server Error",
+                ...(process.env.NODE_ENV === "development" && { detail: err.message }),
+            });
+        });
+    }
+    // // load routes
+    // // logger.group('Routes Loaded');
+    // const totalRoutes = await loadApiRoutes(app, baseRoute, apiDir);
+    // 404 handler
+    app.use((req, res) => {
+        res.status(404).json({
+            error: "Not Found",
+            path: req.originalUrl,
+        });
+    });
+    // server.listen(port);
     // app.use(errorHandler);
     const time = logger.timeEnd(start);
+    logger.success(`Total routes loaded: ${totalRoutes}`);
     logger.success(`Boot completed in ${time}ms`);
-    return app;
+    if (process.env.NODE_ENV === "development") {
+        const used = process.memoryUsage();
+        // logger.info(`Memory: ${Math.round(used.heapUsed / 1024 / 1024)}MB`);
+    }
+    return { app, server };
 }

package/dist/error-handler.d.ts

@@ -1,3 +1,14 @@
-import { Request, Response, NextFunction } from 'express';
-export declare function errorHandler(err: any, req: Request, res: Response, next: NextFunction): Response<any, Record<string, any>>;
+import { Request, Response, NextFunction } from "express";
+/**
+ * Handler error
+ */
+export declare function errorHandler(err: any, req: Request, res: Response, next: NextFunction): void | Response<any, Record<string, any>>;
+/**
+ * Factory
+ */
+export declare function createErrorHandler(options?: {
+    logDetails?: boolean;
+    includeStack?: boolean;
+    customMessages?: Record<string, string>;
+}): (err: any, req: Request, res: Response, next: NextFunction) => void;
 //# sourceMappingURL=error-handler.d.ts.map

package/dist/error-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../src/error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAI1D,wBAAgB,YAAY,CAC1B,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,YAAY,sCAuCnB"}
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../src/error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AA4G1D;;GAEG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,YAAY,6CAoEnB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE;IAC3C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC,IAQS,KAAK,GAAG,EAAE,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,UAwBlE"}

package/dist/error-handler.js

@@ -1,36 +1,170 @@
-import { logger } from './logger';
-import fs from 'fs';
+import { logger } from "./logger.js";
+import fs from "fs/promises";
+import path from "path";
+// Cache for read files
+const fileCache = new Map();
+/**
+ * Extracts information from the stack trace in an optimized way.
+ */
+function extractErrorInfo(err) {
+    if (!err.stack)
+        return null;
+    // Get the first relevant line from the stack.
+    const stackLines = err.stack.split("\n");
+    const relevantLine = stackLines.find((line) => line.includes("(") &&
+        line.includes(".ts:") &&
+        !line.includes("node_modules") &&
+        !line.includes("Error:"));
+    if (!relevantLine)
+        return null;
+    // Optimized regex to capture file, line and column.
+    const match = relevantLine.match(/\((.*?):(\d+):(\d+)\)/);
+    if (!match)
+        return null;
+    const [, file, line, column] = match;
+    return { file, line, column, snippet: "" };
+}
+/**
+ * Reads code snippets in an optimized way with caching.
+ */
+async function getCodeSnippet(filePath, lineNumber) {
+    try {
+        // Normalize file path
+        const normalizedPath = path.resolve(filePath);
+        // Check cache
+        if (fileCache.has(normalizedPath)) {
+            const content = fileCache.get(normalizedPath);
+            const lines = content.split("\n");
+            return lines[lineNumber - 1]?.trim() || "";
+        }
+        // Read the file only if it is a .ts/.js file from the project.
+        if (!normalizedPath.includes("node_modules") &&
+            (normalizedPath.endsWith(".ts") || normalizedPath.endsWith(".js"))) {
+            const content = await fs.readFile(normalizedPath, "utf-8");
+            // Cache only in development
+            if (process.env.NODE_ENV === "development") {
+                fileCache.set(normalizedPath, content);
+            }
+            const lines = content.split("\n");
+            return lines[lineNumber - 1]?.trim() || "";
+        }
+    }
+    catch {
+        // Ignore reading errors
+    }
+    return "";
+}
+/**
+ * Optimized error logging
+ */
+function logError(err, route, fileInfo) {
+    const isDev = process.env.NODE_ENV === "development";
+    if (isDev) {
+        logger.group(`✗ Error [${route}]`);
+        logger.error(`${err.name}: ${err.message}`);
+        if (fileInfo) {
+            logger.error(`Location: ${fileInfo}`);
+        }
+        // Stack trace only for unexpected errors
+        if (err instanceof TypeError || err instanceof ReferenceError) {
+            logger.raw(err.stack?.split("\n").slice(0, 5).join("\n") || "");
+        }
+    }
+    else {
+        // Minimalist log in production
+        logger.error(`[${route}] ${err.name}: ${err.message}`);
+        // Detailed log for critical errors only
+        if (err instanceof SyntaxError || err.message?.includes("Unexpected")) {
+            logger.raw(err.stack?.split("\n")[0] || "");
+        }
+    }
+}
+/**
+ * Handler error
+ */
 export function errorHandler(err, req, res, next) {
-    const isSyntaxError = err.name === 'SyntaxError' || err.message?.includes('Unexpected');
+    // If headers have already been sent, delegate to the next handler.
+    if (res.headersSent) {
+        return next(err);
+    }
     const route = `${req.method} ${req.originalUrl}`;
-    // Tenta extrair arquivo, linha e coluna (quando stack estiver presente)
-    let fileInfo = '';
-    if (err.stack) {
-        const stackLine = err.stack.split('\n')[1]; // pega primeira linha depois do erro
-        const match = stackLine.match(/\((.*):(\d+):(\d+)\)/);
-        if (match) {
-            const [_, file, line, col] = match;
-            fileInfo = `${file}:${line}:${col}`;
-            // Tenta mostrar o trecho da linha que deu erro
-            if (fs.existsSync(file)) {
-                const codeLines = fs.readFileSync(file, 'utf-8').split('\n');
-                const codeSnippet = codeLines[parseInt(line) - 1].trim();
-                fileInfo += ` → ${codeSnippet}`;
-            }
+    const error = err instanceof Error ? err : new Error(String(err));
+    let fileInfo = "";
+    if (process.env.NODE_ENV === "development") {
+        const errorInfo = extractErrorInfo(error);
+        if (errorInfo) {
+            fileInfo = `${path.basename(errorInfo.file)}:${errorInfo.line}:${errorInfo.column}`;
+            // Load snippet asynchronously
+            getCodeSnippet(errorInfo.file, parseInt(errorInfo.line))
+                .then((snippet) => {
+                if (snippet) {
+                    logger.error(`Code: ${snippet}`);
+                }
+            })
+                .catch(() => { }); // Ignore reading errors
         }
     }
-    logger.group(`✗ Runtime Error in route [${route}]`);
-    logger.error(`${err.name}: ${err.message}`);
-    if (fileInfo)
-        logger.error(`Location: ${fileInfo}`);
-    if (process.env.NODE_ENV === 'production') {
-        return res.status(500).json({
-            error: 'Internal server error',
-        });
+    logError(error, route, fileInfo);
+    let statusCode = 500;
+    let errorMessage = "Internal Server Error";
+    if (error instanceof SyntaxError || error.message?.includes("Unexpected")) {
+        statusCode = 400;
+        errorMessage = "Invalid Request";
+    }
+    else if (error.name === "ValidationError") {
+        statusCode = 422;
+        errorMessage = "Validation Failed";
+    }
+    const isDev = process.env.NODE_ENV === "development";
+    res.status(statusCode);
+    const response = {
+        error: errorMessage,
+        status: statusCode,
+        path: req.originalUrl,
+    };
+    if (isDev) {
+        response.message = error.message;
+        if (error.stack && statusCode === 500) {
+            response.stack = error.stack.split("\n").slice(0, 3);
+        }
+        if (fileInfo) {
+            response.location = fileInfo;
+        }
     }
-    return res.status(500).json({
-        error: err.message,
-        stack: err.stack,
-        file: fileInfo || undefined,
-    });
+    res.setHeader("Content-Type", "application/json");
+    res.setHeader("X-Error-Type", error.name);
+    res.setHeader("Cache-Control", "no-store, no-cache, must-revalidate");
+    return res.json(response);
+}
+/**
+ * Factory
+ */
+export function createErrorHandler(options) {
+    const opts = {
+        logDetails: process.env.NODE_ENV === "development",
+        includeStack: process.env.NODE_ENV === "development",
+        customMessages: {},
+        ...options,
+    };
+    return (err, req, res, next) => {
+        if (res.headersSent)
+            return next(err);
+        const error = err instanceof Error ? err : new Error(String(err));
+        const route = `${req.method} ${req.originalUrl}`;
+        if (opts.logDetails) {
+            logger.error(`[${route}] ${error.name}: ${error.message}`);
+        }
+        let statusCode = 500;
+        if (error.name in opts.customMessages) {
+            statusCode = 400;
+        }
+        // Response
+        res.status(statusCode).json({
+            error: opts.customMessages[error.name] || "Internal Server Error",
+            ...(opts.includeStack && {
+                details: error.message,
+                ...(statusCode === 500 && { stack: error.stack?.split("\n")[0] }),
+            }),
+        });
+    };
 }

package/dist/error-hanler2.d.ts

@@ -0,0 +1,14 @@
+import { Request, Response, NextFunction } from "express";
+/**
+ * Handler de erros otimizado para Fastay
+ */
+export declare function errorHandler(err: any, req: Request, res: Response, next: NextFunction): void | Response<any, Record<string, any>>;
+/**
+ * Factory para criar error handlers customizados
+ */
+export declare function createErrorHandler(options?: {
+    logDetails?: boolean;
+    includeStack?: boolean;
+    customMessages?: Record<string, string>;
+}): (err: any, req: Request, res: Response, next: NextFunction) => void;
+//# sourceMappingURL=error-hanler2.d.ts.map

package/dist/error-hanler2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-hanler2.d.ts","sourceRoot":"","sources":["../src/error-hanler2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AA4G1D;;GAEG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,YAAY,6CA4EnB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE;IAC3C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC,IAQS,KAAK,GAAG,EAAE,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,UA0BlE"}