@syntay/fastay 0.1.6 → 0.1.8

package/dist/app.d.ts

@@ -75,6 +75,45 @@ export type CreateAppOptions = {
      * Default: "/api"
      */
     baseRoute?: string;
+    /**
+     * Configuration to enable CORS (Cross-Origin Resource Sharing) in Fastay.
+     */
+    enableCors?: {
+        /**
+         * If true, permite requisições de qualquer origem.
+         * Default: false
+         */
+        allowAnyOrigin?: boolean;
+        /**
+         * Lista de origens específicas permitidas para envio de cookies.
+         * Exemplo: ["http://localhost:3000", "https://meusite.com"]
+         */
+        cookieOrigins?: string[];
+        /**
+         * Se true, habilita envio de cookies cross-origin.
+         * Default: false
+         */
+        credentials?: boolean;
+        /**
+         * Lista de métodos HTTP permitidos, separados por vírgula.
+         * Default: "GET,POST,PUT,PATCH,DELETE,OPTIONS"
+         */
+        methods?: string;
+        /**
+         * Lista de cabeçalhos permitidos na requisição.
+         * Default: "Content-Type, Authorization"
+         */
+        headers?: string;
+        /**
+         * Cabeçalhos expostos ao cliente.
+         * Exemplo: ["X-Custom-Header"]
+         */
+        exposedHeaders?: string;
+        /**
+         * Tempo máximo de cache para requisições prévias (preflight), em segundos.
+         */
+        maxAge?: number;
+    };
     /**
      * Port on which `.listen()` will run the server.
      * Default: 3000

package/dist/app.js

@@ -4,6 +4,7 @@ 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';
 /**
  * Bootstraps and configures a Fastay application.
  *
@@ -91,8 +92,37 @@ export async function createApp(opts) {
     const isMiddleware = await loadFastayMiddlewares(app);
     // health check
     app.get('/_health', (_, res) => res.json({ ok: true }));
-    app.use((_req, res, next) => {
+    app.use((req, res, next) => {
         res.setHeader('X-Powered-By', 'Syntay Engine');
+        req.cookies = new RequestCookies(req.headers.cookie);
+        const corsOpts = opts?.enableCors || {};
+        // Determina a origem
+        let origin = '*';
+        if (corsOpts.credentials && corsOpts.cookieOrigins?.length) {
+            // Se a origem estiver na lista de cookieOrigins, permite cookies
+            if (req.headers.origin &&
+                corsOpts.cookieOrigins.includes(req.headers.origin)) {
+                origin = req.headers.origin;
+            }
+            else {
+                origin = ''; // bloqueia cookies para outras origens
+            }
+        }
+        else if (!corsOpts.credentials && corsOpts.allowAnyOrigin) {
+            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');
+        if (corsOpts.exposedHeaders) {
+            res.setHeader('Access-Control-Expose-Headers', corsOpts.exposedHeaders);
+        }
+        if (corsOpts.maxAge) {
+            res.setHeader('Access-Control-Max-Age', corsOpts.maxAge.toString());
+        }
+        if (req.method === 'OPTIONS')
+            return res.sendStatus(204);
         next();
     });
     // load routes

package/dist/index.d.ts

@@ -2,3 +2,4 @@ export { createApp } from './app.js';
 export { createMiddleware } from './middleware.js';
 export type { CreateAppOptions } from './app.js';
 export type { Request, Response, Next } from './types';
+export { cookies } from './utils/cookies.js';

package/dist/index.js

@@ -1,2 +1,3 @@
 export { createApp } from './app.js';
 export { createMiddleware } from './middleware.js';
+export { cookies } from './utils/cookies.js';

package/dist/router.js

@@ -92,10 +92,9 @@ function wrapHandler(fn, routePath, filePath) {
                         res.cookie(name, data.value, data.options || {});
                     }
                 }
-                if (typeof typedResult.status === 'number') {
-                    return res.status(typedResult.status).json(typedResult.body ?? {});
-                }
-                return res.json(result);
+                const statusCode = typeof result.status === 'number' ? result.status : 200;
+                const body = result.body ?? result; // se não existir body, retorna o objeto inteiro
+                return res.status(statusCode).json(body);
             }
             // Suporte a retorno simples
             if (typeof result === 'string')

package/dist/types/index.d.ts

@@ -1,11 +1,34 @@
 import { Request as ExpressRequest, Response as ExpressResponse, NextFunction } from 'express';
-/**
- * Tipos do Express reexportados para os usuários
- */
-export type Request = ExpressRequest;
+export interface CookieItem {
+    value: string;
+}
+export interface RequestCookies {
+    /**
+     * Retrieves a cookie by its name.
+     * @param name - The name of the cookie to retrieve.
+     * @returns An object containing the cookie's value, or undefined if not found.
+     */
+    get(name: string): CookieItem | undefined;
+    /**
+     * Checks if a cookie with the given name exists.
+     * @param name - The name of the cookie to check.
+     * @returns True if the cookie exists, false otherwise.
+     */
+    has(name: string): boolean;
+    /**
+     * Returns all cookies as a key-value object.
+     * @returns An object where keys are cookie names and values are cookie values.
+     */
+    all(): Record<string, string>;
+}
+export interface Request extends ExpressRequest {
+    /**
+     * Represents the cookies sent in a request.
+     */
+    cookies: RequestCookies;
+}
 export type Response = ExpressResponse;
 export type Next = NextFunction;
-export {};
 declare global {
     type FastayResponse = {
         status?: number;
@@ -26,3 +49,11 @@ declare global {
     };
 }
 export type RouteHandler = (() => FastayResponse | any) | ((req: Request) => FastayResponse | any) | ((req: Request, res: Response) => FastayResponse | any);
+export interface CookieItem {
+    value: string;
+}
+declare module 'express-serve-static-core' {
+    interface Request {
+        typedCookies: RequestCookies | any;
+    }
+}

package/dist/utils/cookies.d.ts

@@ -0,0 +1,10 @@
+export declare class RequestCookies {
+    private cookies;
+    constructor(cookieHeader: string | undefined);
+    get(name: string): {
+        value: string;
+    } | undefined;
+    has(name: string): boolean;
+    all(): Record<string, string>;
+}
+export declare const cookies: typeof RequestCookies;

package/dist/utils/cookies.js

@@ -0,0 +1,28 @@
+export class RequestCookies {
+    constructor(cookieHeader) {
+        this.cookies = new Map();
+        if (!cookieHeader)
+            return;
+        cookieHeader.split(';').forEach((cookie) => {
+            const [name, ...rest] = cookie.trim().split('=');
+            if (!name)
+                return;
+            this.cookies.set(name, decodeURIComponent(rest.join('=')));
+        });
+    }
+    get(name) {
+        const value = this.cookies.get(name);
+        if (!value)
+            return undefined;
+        return { value };
+    }
+    has(name) {
+        return this.cookies.has(name);
+    }
+    all() {
+        const obj = {};
+        this.cookies.forEach((v, k) => (obj[k] = v));
+        return obj;
+    }
+}
+export const cookies = RequestCookies;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syntay/fastay",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Framework backend moderno baseado em Express.js, para criar APIs rapidamente",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -28,7 +28,9 @@
     "access": "public"
   },
   "dependencies": {
+    "chokidar": "^4.0.3",
     "express": "^5.1.0",
+    "import-fresh": "^3.3.1",
     "pino": "^10.1.0",
     "pino-pretty": "^13.1.2"
   },

package/src/app.ts

@@ -10,6 +10,7 @@ import { logger } from './logger.js';
 import { printBanner } from './banner.js';
 import type { ServeStaticOptions } from 'serve-static';
 import { Next, Request, Response } from './types/index.js';
+import { RequestCookies } from './utils/cookies.js';
 
 /**
  * Express configuration options applied automatically by Fastay
@@ -95,6 +96,52 @@ export type CreateAppOptions = {
    */
   baseRoute?: string;
 
+  /**
+   * Configuration to enable CORS (Cross-Origin Resource Sharing) in Fastay.
+   */
+  enableCors?: {
+    /**
+     * If true, permite requisições de qualquer origem.
+     * Default: false
+     */
+    allowAnyOrigin?: boolean;
+
+    /**
+     * Lista de origens específicas permitidas para envio de cookies.
+     * Exemplo: ["http://localhost:3000", "https://meusite.com"]
+     */
+    cookieOrigins?: string[];
+
+    /**
+     * Se true, habilita envio de cookies cross-origin.
+     * Default: false
+     */
+    credentials?: boolean;
+
+    /**
+     * Lista de métodos HTTP permitidos, separados por vírgula.
+     * Default: "GET,POST,PUT,PATCH,DELETE,OPTIONS"
+     */
+    methods?: string;
+
+    /**
+     * Lista de cabeçalhos permitidos na requisição.
+     * Default: "Content-Type, Authorization"
+     */
+    headers?: string;
+
+    /**
+     * Cabeçalhos expostos ao cliente.
+     * Exemplo: ["X-Custom-Header"]
+     */
+    exposedHeaders?: string;
+
+    /**
+     * Tempo máximo de cache para requisições prévias (preflight), em segundos.
+     */
+    maxAge?: number;
+  };
+
   /**
    * Port on which `.listen()` will run the server.
    * Default: 3000
@@ -214,8 +261,52 @@ export async function createApp(opts?: CreateAppOptions) {
 
   // health check
   app.get('/_health', (_, res) => res.json({ ok: true }));
-  app.use((_req: Request, res: Response, next: Next) => {
+  app.use((req: Request, res: Response, next: Next) => {
     res.setHeader('X-Powered-By', 'Syntay Engine');
+    (req as any).cookies = new RequestCookies(req.headers.cookie);
+
+    const corsOpts = opts?.enableCors || {};
+
+    // Determina a origem
+    let origin = '*';
+
+    if (corsOpts.credentials && corsOpts.cookieOrigins?.length) {
+      // Se a origem estiver na lista de cookieOrigins, permite cookies
+      if (
+        req.headers.origin &&
+        corsOpts.cookieOrigins.includes(req.headers.origin)
+      ) {
+        origin = req.headers.origin;
+      } else {
+        origin = ''; // bloqueia cookies para outras origens
+      }
+    } else if (!corsOpts.credentials && corsOpts.allowAnyOrigin) {
+      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'
+    );
+
+    if (corsOpts.exposedHeaders) {
+      res.setHeader('Access-Control-Expose-Headers', corsOpts.exposedHeaders);
+    }
+
+    if (corsOpts.maxAge) {
+      res.setHeader('Access-Control-Max-Age', corsOpts.maxAge.toString());
+    }
+
+    if (req.method === 'OPTIONS') return res.sendStatus(204);
     next();
   });
 

package/src/index.ts

@@ -2,3 +2,4 @@ export { createApp } from './app.js';
 export { createMiddleware } from './middleware.js';
 export type { CreateAppOptions } from './app.js';
 export type { Request, Response, Next } from './types';
+export { cookies } from './utils/cookies.js';

package/src/router.ts

@@ -64,7 +64,6 @@ function wrapHandler(fn: Function, routePath: string, filePath: string) {
         const typedResult = result as {
           status?: number;
           body?: any;
-
           cookies?: Record<string, { value: string; options?: any }>;
           headers?: Record<string, string>;
           redirect?: string;
@@ -124,11 +123,11 @@ function wrapHandler(fn: Function, routePath: string, filePath: string) {
           }
         }
 
-        if (typeof typedResult.status === 'number') {
-          return res.status(typedResult.status).json(typedResult.body ?? {});
-        }
+        const statusCode =
+          typeof result.status === 'number' ? result.status : 200;
 
-        return res.json(result);
+        const body = result.body ?? result; // se não existir body, retorna o objeto inteiro
+        return res.status(statusCode).json(body);
       }
 
       // Suporte a retorno simples

package/src/types/fastay-global.d.ts

@@ -0,0 +1,7 @@
+import { RequestCookies } from '../src/utils/cookies';
+
+declare module 'express-serve-static-core' {
+  interface Request {
+    cookies: RequestCookies;
+  }
+}

package/src/types/fastay.d.ts

@@ -0,0 +1,9 @@
+export interface CookieItem {
+  value: string;
+}
+
+export interface RequestCookies {
+  get(name: string): CookieItem | undefined;
+  has(name: string): boolean;
+  all(): Record<string, string>;
+}

package/src/types/index.ts

@@ -4,30 +4,52 @@ import {
   NextFunction,
 } from 'express';
 
-/**
- * Tipos do Express reexportados para os usuários
- */
-export type Request = ExpressRequest;
+export interface CookieItem {
+  value: string;
+}
+
+export interface RequestCookies {
+  /**
+   * Retrieves a cookie by its name.
+   * @param name - The name of the cookie to retrieve.
+   * @returns An object containing the cookie's value, or undefined if not found.
+   */
+  get(name: string): CookieItem | undefined;
+
+  /**
+   * Checks if a cookie with the given name exists.
+   * @param name - The name of the cookie to check.
+   * @returns True if the cookie exists, false otherwise.
+   */
+  has(name: string): boolean;
+
+  /**
+   * Returns all cookies as a key-value object.
+   * @returns An object where keys are cookie names and values are cookie values.
+   */
+  all(): Record<string, string>;
+}
+
+export interface Request extends ExpressRequest {
+  /**
+   * Represents the cookies sent in a request.
+   */
+  cookies: RequestCookies;
+  // params:
+  // query:
+}
+
 export type Response = ExpressResponse;
 export type Next = NextFunction;
 
-export {};
-
 declare global {
   type FastayResponse = {
     status?: number;
     body?: any;
-
     cookies?: Record<string, { value: string; options?: any }>;
     headers?: Record<string, string>;
     redirect?: string;
-
-    file?: {
-      path: string;
-      filename?: string;
-      options?: any;
-    };
-
+    file?: { path: string; filename?: string; options?: any };
     stream?: NodeJS.ReadableStream;
     raw?: Buffer | string;
   };
@@ -37,3 +59,13 @@ export type RouteHandler =
   | (() => FastayResponse | any)
   | ((req: Request) => FastayResponse | any)
   | ((req: Request, res: Response) => FastayResponse | any);
+
+export interface CookieItem {
+  value: string;
+}
+
+declare module 'express-serve-static-core' {
+  interface Request {
+    typedCookies: RequestCookies | any;
+  }
+}

package/src/utils/cookies.ts

@@ -0,0 +1,34 @@
+// utils/cookies.ts
+import { IncomingMessage } from 'http';
+
+export class RequestCookies {
+  private cookies: Map<string, string> = new Map();
+
+  constructor(cookieHeader: string | undefined) {
+    if (!cookieHeader) return;
+
+    cookieHeader.split(';').forEach((cookie) => {
+      const [name, ...rest] = cookie.trim().split('=');
+      if (!name) return;
+      this.cookies.set(name, decodeURIComponent(rest.join('=')));
+    });
+  }
+
+  public get(name: string) {
+    const value = this.cookies.get(name);
+    if (!value) return undefined;
+    return { value };
+  }
+
+  public has(name: string) {
+    return this.cookies.has(name);
+  }
+
+  public all() {
+    const obj: Record<string, string> = {};
+    this.cookies.forEach((v, k) => (obj[k] = v));
+    return obj;
+  }
+}
+
+export const cookies = RequestCookies;

package/tsconfig.json

@@ -4,14 +4,16 @@
     "module": "CommonJS",
     "rootDir": "src",
     "outDir": "dist",
+    "baseUrl": ".",
     "strict": true,
     "esModuleInterop": true,
     "forceConsistentCasingInFileNames": true,
     "skipLibCheck": true,
     "moduleResolution": "node",
     "resolveJsonModule": true,
-    "allowSyntheticDefaultImports": true
+    "allowSyntheticDefaultImports": true,
+    "typeRoots": ["./node_modules/@types", "./types"]
   },
-  "include": ["src"],
+  "include": ["src", "types"],
   "exclude": ["node_modules", "dist"]
 }