@syntay/fastay 0.1.8 → 0.1.9

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');

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/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.8",
+  "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,6 +28,7 @@
     "access": "public"
   },
   "dependencies": {
+    "busboy": "^1.6.0",
     "chokidar": "^4.0.3",
     "express": "^5.1.0",
     "import-fresh": "^3.3.1",
@@ -35,6 +36,7 @@
     "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
@@ -248,6 +249,9 @@ export async function createApp(opts?: CreateAppOptions) {
     }
   }
 
+  // FormData middleware
+  app.use(formDataMiddleware());
+
   // Fastay middlewares
   if (opts?.middlewares) {
     logger.group('Fastay Middlewares');
@@ -261,7 +265,7 @@ 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);
 

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/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 },
+  };
+}