@syntay/fastay 0.1.7 → 0.1.9

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

@@ -5,6 +5,7 @@ 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.
  *
@@ -81,6 +82,8 @@ export async function createApp(opts) {
             app.use(mw);
         }
     }
+    // FormData middleware
+    app.use(formDataMiddleware());
     // Fastay middlewares
     if (opts?.middlewares) {
         logger.group('Fastay Middlewares');
@@ -95,6 +98,34 @@ export async function createApp(opts) {
     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/types/index.d.ts

@@ -26,6 +26,7 @@ export interface Request extends ExpressRequest {
      * Represents the cookies sent in a request.
      */
     cookies: RequestCookies;
+    formData: () => Promise<FormData>;
 }
 export type Response = ExpressResponse;
 export type Next = NextFunction;

package/dist/utils/cookies.d.ts

@@ -7,3 +7,4 @@ export declare class RequestCookies {
     has(name: string): boolean;
     all(): Record<string, string>;
 }
+export declare const cookies: typeof RequestCookies;

package/dist/utils/cookies.js

@@ -25,3 +25,4 @@ export class RequestCookies {
         return obj;
     }
 }
+export const cookies = RequestCookies;

package/dist/utils/formDataMiddleware.d.ts

@@ -0,0 +1,17 @@
+type FileInfo = {
+    filename: string;
+    encoding: string;
+    mimeType: string;
+    size: number;
+    buffer: Buffer;
+};
+export declare class File {
+    name: string;
+    type: string;
+    size: number;
+    buffer: Buffer;
+    constructor(file: FileInfo);
+    arrayBuffer(): ArrayBuffer | SharedArrayBuffer;
+}
+export declare function formDataMiddleware(): (req: any, res: any, next: any) => any;
+export {};

package/dist/utils/formDataMiddleware.js

@@ -0,0 +1,122 @@
+import Busboy from 'busboy';
+// Classe File compatível com a do browser
+export class File {
+    constructor(file) {
+        this.name = file.filename;
+        this.type = file.mimeType;
+        this.size = file.size;
+        this.buffer = file.buffer;
+    }
+    arrayBuffer() {
+        return this.buffer.buffer.slice(this.buffer.byteOffset, this.buffer.byteOffset + this.buffer.byteLength);
+    }
+}
+export function formDataMiddleware() {
+    return function (req, res, next) {
+        if (typeof req.formData === 'function')
+            return next();
+        req.formData = () => new Promise((resolve, reject) => {
+            const bb = Busboy({ headers: req.headers });
+            const fields = {};
+            const files = {};
+            bb.on('field', (name, value) => {
+                if (name.endsWith('[]')) {
+                    const key = name.slice(0, -2);
+                    if (!fields[key])
+                        fields[key] = [];
+                    fields[key].push(value);
+                }
+                else {
+                    fields[name] = value;
+                }
+            });
+            bb.on('file', (name, file, info) => {
+                const chunks = [];
+                file.on('data', (chunk) => chunks.push(chunk));
+                file.on('end', () => {
+                    const buffer = Buffer.concat(chunks);
+                    const fileObj = new File({
+                        filename: info.filename,
+                        encoding: info.encoding,
+                        mimeType: info.mimeType,
+                        size: buffer.length,
+                        buffer,
+                    });
+                    if (!files[name])
+                        files[name] = [];
+                    files[name].push(fileObj);
+                });
+            });
+            bb.on('finish', () => {
+                resolve(createFormDataLike(fields, files));
+            });
+            bb.on('error', reject);
+            req.pipe(bb);
+        });
+        next();
+    };
+}
+function createFormDataLike(fields, files) {
+    return {
+        get(key) {
+            if (files[key])
+                return files[key][0];
+            return fields[key] ?? null;
+        },
+        getAll(key) {
+            if (files[key])
+                return files[key];
+            const val = fields[key];
+            return Array.isArray(val) ? val : val ? [val] : [];
+        },
+        has(key) {
+            return !!fields[key] || !!files[key];
+        },
+        append(key, value) {
+            if (value instanceof File) {
+                if (!files[key])
+                    files[key] = [];
+                files[key].push(value);
+                return;
+            }
+            if (!fields[key]) {
+                fields[key] = value;
+            }
+            else if (Array.isArray(fields[key])) {
+                fields[key].push(value);
+            }
+            else {
+                fields[key] = [fields[key], value];
+            }
+        },
+        set(key, value) {
+            if (value instanceof File) {
+                files[key] = [value];
+                delete fields[key];
+                return;
+            }
+            fields[key] = value;
+            delete files[key];
+        },
+        delete(key) {
+            delete fields[key];
+            delete files[key];
+        },
+        *entries() {
+            for (const [k, v] of Object.entries(fields)) {
+                if (Array.isArray(v)) {
+                    for (const item of v)
+                        yield [k, item];
+                }
+                else {
+                    yield [k, v];
+                }
+            }
+            for (const [k, arr] of Object.entries(files)) {
+                for (const file of arr)
+                    yield [k, file];
+            }
+        },
+        raw: { fields, files },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syntay/fastay",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Framework backend moderno baseado em Express.js, para criar APIs rapidamente",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -28,11 +28,15 @@
     "access": "public"
   },
   "dependencies": {
+    "busboy": "^1.6.0",
+    "chokidar": "^4.0.3",
     "express": "^5.1.0",
+    "import-fresh": "^3.3.1",
     "pino": "^10.1.0",
     "pino-pretty": "^13.1.2"
   },
   "devDependencies": {
+    "@types/busboy": "^1.5.4",
     "@types/express": "^5.0.5",
     "@types/node": "^20.19.25",
     "ts-node": "^10.9.2",

package/src/app.ts

@@ -1,4 +1,4 @@
-import express from 'express';
+import express, { Request, Response, NextFunction } from 'express';
 import path from 'path';
 import { loadApiRoutes } from './router.js';
 import {
@@ -9,8 +9,9 @@ import {
 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';
+import { formDataMiddleware } from './utils/formDataMiddleware.js';
 
 /**
  * Express configuration options applied automatically by Fastay
@@ -96,6 +97,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
@@ -202,6 +249,9 @@ export async function createApp(opts?: CreateAppOptions) {
     }
   }
 
+  // FormData middleware
+  app.use(formDataMiddleware());
+
   // Fastay middlewares
   if (opts?.middlewares) {
     logger.group('Fastay Middlewares');
@@ -215,9 +265,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: NextFunction) => {
     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/types/index.ts

@@ -35,6 +35,7 @@ export interface Request extends ExpressRequest {
    * Represents the cookies sent in a request.
    */
   cookies: RequestCookies;
+  formData: () => Promise<FormData>;
   // params:
   // query:
 }

package/src/utils/cookies.ts

@@ -30,3 +30,5 @@ export class RequestCookies {
     return obj;
   }
 }
+
+export const cookies = RequestCookies;

package/src/utils/formDataMiddleware.ts

@@ -0,0 +1,155 @@
+import Busboy from 'busboy';
+
+type FieldMap = Record<string, string | string[]>;
+type FileInfo = {
+  filename: string;
+  encoding: string;
+  mimeType: string;
+  size: number;
+  buffer: Buffer;
+};
+type FileMap = Record<string, File[]>;
+
+// Classe File compatível com a do browser
+export class File {
+  name: string;
+  type: string;
+  size: number;
+  buffer: Buffer;
+
+  constructor(file: FileInfo) {
+    this.name = file.filename;
+    this.type = file.mimeType;
+    this.size = file.size;
+    this.buffer = file.buffer;
+  }
+
+  arrayBuffer() {
+    return this.buffer.buffer.slice(
+      this.buffer.byteOffset,
+      this.buffer.byteOffset + this.buffer.byteLength
+    );
+  }
+}
+
+export function formDataMiddleware() {
+  return function (req: any, res: any, next: any) {
+    if (typeof req.formData === 'function') return next();
+
+    req.formData = () =>
+      new Promise((resolve, reject) => {
+        const bb = Busboy({ headers: req.headers });
+
+        const fields: FieldMap = {};
+        const files: FileMap = {};
+
+        bb.on('field', (name, value) => {
+          if (name.endsWith('[]')) {
+            const key = name.slice(0, -2);
+            if (!fields[key]) fields[key] = [];
+            (fields[key] as string[]).push(value);
+          } else {
+            fields[name] = value;
+          }
+        });
+
+        bb.on('file', (name, file, info) => {
+          const chunks: Buffer[] = [];
+
+          file.on('data', (chunk) => chunks.push(chunk));
+
+          file.on('end', () => {
+            const buffer = Buffer.concat(chunks);
+
+            const fileObj = new File({
+              filename: info.filename,
+              encoding: info.encoding,
+              mimeType: info.mimeType,
+              size: buffer.length,
+              buffer,
+            });
+
+            if (!files[name]) files[name] = [];
+            files[name].push(fileObj);
+          });
+        });
+
+        bb.on('finish', () => {
+          resolve(createFormDataLike(fields, files));
+        });
+
+        bb.on('error', reject);
+
+        req.pipe(bb);
+      });
+
+    next();
+  };
+}
+
+function createFormDataLike(fields: FieldMap, files: FileMap) {
+  return {
+    get(key: string) {
+      if (files[key]) return files[key][0];
+      return fields[key] ?? null;
+    },
+
+    getAll(key: string) {
+      if (files[key]) return files[key];
+      const val = fields[key];
+      return Array.isArray(val) ? val : val ? [val] : [];
+    },
+
+    has(key: string) {
+      return !!fields[key] || !!files[key];
+    },
+
+    append(key: string, value: any) {
+      if (value instanceof File) {
+        if (!files[key]) files[key] = [];
+        files[key].push(value);
+        return;
+      }
+
+      if (!fields[key]) {
+        fields[key] = value;
+      } else if (Array.isArray(fields[key])) {
+        (fields[key] as string[]).push(value);
+      } else {
+        fields[key] = [fields[key] as string, value];
+      }
+    },
+
+    set(key: string, value: any) {
+      if (value instanceof File) {
+        files[key] = [value];
+        delete fields[key];
+        return;
+      }
+
+      fields[key] = value;
+      delete files[key];
+    },
+
+    delete(key: string) {
+      delete fields[key];
+      delete files[key];
+    },
+
+    *entries() {
+      for (const [k, v] of Object.entries(fields)) {
+        if (Array.isArray(v)) {
+          for (const item of v) yield [k, item];
+        } else {
+          yield [k, v];
+        }
+      }
+
+      for (const [k, arr] of Object.entries(files)) {
+        for (const file of arr) yield [k, file];
+      }
+    },
+
+    raw: { fields, files },
+  };
+}