@abejarano/ts-express-server 1.7.5 → 1.7.7

package/README.md

@@ -1,25 +1,22 @@
-# TypeScript Server Framework (Express + Bun)
+# TypeScript Server Framework (Bun)
 
-A modular and extensible TypeScript framework for building Express or Bun servers with a clean architecture pattern that separates concerns between server modules and services.
+Un framework TypeScript moderno y modular para construir APIs en Bun con una arquitectura limpia, extensible y enfocada en productividad. Separa responsabilidades en modulos, servicios y controladores con decoradores, incluye middlewares esenciales listos para usar y mantiene una experiencia tipada end-to-end.
 
 ## Features
 
-- 🏗️ **Modular Architecture**: Build your server using reusable modules
-- 🚀 **Service Management**: Integrate background services that start with your server
-- 📦 **Built-in Modules**: Pre-configured modules for common functionality
-- 🔄 **Graceful Shutdown**: Proper cleanup and shutdown handling
-- ⚡ **Priority System**: Control module initialization order
-- 🛡️ **Type Safety**: Full TypeScript support with strong typing
-- 🔧 **Configurable**: Highly customizable modules and services
-- 🎨 **Decorators**: Clean and declarative controller definition
-- ⚙️ **Runtime Choice**: Run on Express (Node) or Bun via `ServerRuntime`
+- 🏗️ **Arquitectura modular**: arma el servidor con modulos reutilizables y reemplazables
+- 🚀 **Servicios de fondo**: inicia procesos y workers junto al servidor
+- 📦 **Modulos incluidos**: CORS, seguridad, rate limit, uploads y contexto de request
+- 🔄 **Apagado limpio**: shutdown ordenado y seguro para modulos/servicios
+- ⚡ **Prioridades**: control total del orden de inicializacion
+- 🛡️ **Type safety real**: tipado fuerte en request, response y decoradores
+- 🔧 **Configurable**: cambia o desactiva piezas sin romper el core
+- 🎨 **Decoradores**: controladores claros, declarativos y faciles de testear
 
 ## Installation
 
 ```bash
-npm install @abejarano/ts-express-server
-# or
-yarn add @abejarano/ts-express-server
+bun add @abejarano/ts-express-server
 ```
 
 ## Documentation
@@ -33,17 +30,21 @@ yarn add @abejarano/ts-express-server
 - [API Reference](docs/api-reference.md)
 - [Examples](docs/examples.md)
 
-## Runtime Selection
+## File uploads
 
-```typescript
-import { BootstrapServer } from "@abejarano/ts-express-server";
+Uploads are disabled unless `FileUploadModule` is registered. Configure limits and MIME allowlists through the module:
 
-const server = new BootstrapServer(3000, { runtime: "bun" });
-server.start();
+```typescript
+import { FileUploadModule } from "@abejarano/ts-express-server";
+
+const fileUpload = new FileUploadModule({
+  maxBodyBytes: 10 * 1024 * 1024,
+  maxFileBytes: 10 * 1024 * 1024,
+  maxFiles: 10,
+  allowedMimeTypes: ["image/*", "application/pdf"],
+});
 ```
 
-You can also use `ServerRuntime.Bun` and `ServerRuntime.Express` if you prefer the enum.
-
 ## Contributing
 
 1. Fork the repository

package/dist/BootstrapServer.d.ts

@@ -1,7 +1,6 @@
 import { BaseServerModule, BaseServerService } from "./abstract";
-import { ServerAdapter, ServerApp, ServerInstance, ServerRuntime } from "./abstract";
+import { ServerAdapter, ServerApp, ServerInstance } from "./abstract";
 export interface BootstrapServerOptions {
-    runtime?: ServerRuntime;
     adapter?: ServerAdapter;
 }
 export declare class BootstrapServer {
@@ -29,5 +28,4 @@ export declare class BootstrapServer {
     private initializeServices;
     private initializeServerModules;
     private setupGracefulShutdown;
-    private createAdapter;
 }

package/dist/BootstrapServer.js

@@ -1,14 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BootstrapServer = void 0;
-const abstract_1 = require("./abstract");
 const adapters_1 = require("./adapters");
 class BootstrapServer {
     constructor(port, options) {
         this.modules = [];
         this.services = [];
         this.port = port;
-        this.adapter = options?.adapter ?? this.createAdapter(options?.runtime);
+        this.adapter = options?.adapter ?? new adapters_1.BunAdapter();
         this.runtime = this.adapter.runtime;
         this.app = this.adapter.createApp();
         this.adapter.configure(this.app, port);
@@ -170,11 +169,5 @@ class BootstrapServer {
         process.on("SIGINT", () => shutdown("SIGINT"));
         process.on("SIGTERM", () => shutdown("SIGTERM"));
     }
-    createAdapter(runtime) {
-        if (runtime === abstract_1.ServerRuntime.Bun) {
-            return new adapters_1.BunAdapter();
-        }
-        return new adapters_1.ExpressAdapter();
-    }
 }
 exports.BootstrapServer = BootstrapServer;

package/dist/BootstrapStandardServer.d.ts

@@ -1,8 +1,8 @@
 import { BootstrapServer } from "./BootstrapServer";
-import { ControllersModule, RoutesModule } from "./modules";
-import { BaseServerModule, BaseServerService, ServerRuntime } from "./abstract";
+import { ControllersModule } from "./modules";
+import { BaseServerModule, BaseServerService, ServerAdapter } from "./abstract";
 export interface BootstrapStandardServerOptions {
-    runtime?: ServerRuntime;
+    adapter?: ServerAdapter;
     modules?: {
         cors?: BaseServerModule | false;
         security?: BaseServerModule | false;
@@ -13,9 +13,6 @@ export interface BootstrapStandardServerOptions {
     };
     services?: BaseServerService[];
 }
-export declare function BootstrapStandardServer(port: number, module: RoutesModule | ControllersModule, services?: BaseServerService[]): BootstrapServer;
-export declare function BootstrapStandardServer(port: number, module: RoutesModule | ControllersModule, services: BaseServerService[], options: BootstrapStandardServerOptions): BootstrapServer;
-export declare function BootstrapStandardServer(port: number, module: RoutesModule | ControllersModule, options: BootstrapStandardServerOptions): BootstrapServer;
-export declare function BootstrapStandardServer(port: number, routes: RoutesModule, controllersModule: ControllersModule, services?: BaseServerService[]): BootstrapServer;
-export declare function BootstrapStandardServer(port: number, routes: RoutesModule, controllersModule: ControllersModule, services: BaseServerService[], options: BootstrapStandardServerOptions): BootstrapServer;
-export declare function BootstrapStandardServer(port: number, routes: RoutesModule, controllersModule: ControllersModule, options: BootstrapStandardServerOptions): BootstrapServer;
+export declare function BootstrapStandardServer(port: number, module: ControllersModule, services?: BaseServerService[]): BootstrapServer;
+export declare function BootstrapStandardServer(port: number, module: ControllersModule, services: BaseServerService[], options: BootstrapStandardServerOptions): BootstrapServer;
+export declare function BootstrapStandardServer(port: number, module: ControllersModule, options: BootstrapStandardServerOptions): BootstrapServer;

package/dist/BootstrapStandardServer.js

@@ -3,27 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BootstrapStandardServer = BootstrapStandardServer;
 const BootstrapServer_1 = require("./BootstrapServer");
 const modules_1 = require("./modules");
-function BootstrapStandardServer(port, arg2, arg3, arg4, arg5) {
-    let routesModule;
+function BootstrapStandardServer(port, arg2, arg3, arg4) {
     let controllersModule;
     let services;
     let options;
-    const setControllersModule = (module) => {
-        if (controllersModule && controllersModule !== module) {
-            throw new Error("ControllersModule provided multiple times. Pass a single instance only.");
-        }
-        controllersModule = module;
-    };
-    if (arg2 instanceof modules_1.RoutesModule) {
-        routesModule = arg2;
-    }
-    else if (arg2 instanceof modules_1.ControllersModule) {
-        setControllersModule(arg2);
-        routesModule = new modules_1.RoutesModule();
-    }
-    else {
-        throw new Error("Invalid second argument. Must be RoutesModule or ControllersModule");
-    }
+    controllersModule = arg2;
     const addServices = (value) => {
         if (!value?.length) {
             return;
@@ -34,10 +18,6 @@ function BootstrapStandardServer(port, arg2, arg3, arg4, arg5) {
         if (!value) {
             return;
         }
-        if (value instanceof modules_1.ControllersModule) {
-            setControllersModule(value);
-            return;
-        }
         if (Array.isArray(value)) {
             addServices(value);
             return;
@@ -46,9 +26,8 @@ function BootstrapStandardServer(port, arg2, arg3, arg4, arg5) {
     };
     processOptionalArg(arg3);
     processOptionalArg(arg4);
-    processOptionalArg(arg5);
     addServices(options?.services);
-    const modulesToRegister = [routesModule];
+    const modulesToRegister = [controllersModule];
     const preset = options?.modules;
     const registerModule = (factory, override) => {
         if (override === false) {
@@ -65,11 +44,8 @@ function BootstrapStandardServer(port, arg2, arg3, arg4, arg5) {
         modulesToRegister.push(...preset.extra);
     }
     const server = new BootstrapServer_1.BootstrapServer(port, {
-        runtime: options?.runtime,
+        adapter: options?.adapter,
     }).addModules(modulesToRegister);
-    if (controllersModule) {
-        server.addModule(controllersModule);
-    }
     if (services) {
         server.addServices(services);
     }

package/dist/abstract/ServerTypes.d.ts

@@ -1,6 +1,4 @@
-import type fileUpload from "express-fileupload";
 export declare enum ServerRuntime {
-    Express = "express",
     Bun = "bun"
 }
 export type NextFunction = (err?: unknown) => void;
@@ -25,6 +23,7 @@ export interface ServerResponse {
     send(body: unknown): void | Promise<void>;
     set(name: string, value: string): this;
     header(name: string, value: string): this;
+    setHeader?(name: string, value: string): this;
     cookie?(name: string, value: string, options?: {
         maxAge?: number;
         domain?: string;
@@ -47,7 +46,7 @@ export type BunMultipartFile = {
     arrayBuffer(): Promise<ArrayBuffer>;
     lastModified?: number;
 };
-export type ServerFile = BunMultipartFile | fileUpload.UploadedFile;
+export type ServerFile = BunMultipartFile;
 export type ServerFiles = Record<string, ServerFile | ServerFile[]>;
 export type ServerHandlerInput = ServerHandler | ServerHandler[] | ServerRouter;
 export interface ServerRouter {

package/dist/abstract/ServerTypes.js

@@ -3,6 +3,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ServerRuntime = void 0;
 var ServerRuntime;
 (function (ServerRuntime) {
-    ServerRuntime["Express"] = "express";
     ServerRuntime["Bun"] = "bun";
 })(ServerRuntime || (exports.ServerRuntime = ServerRuntime = {}));

package/dist/adapters/BunAdapter.js

@@ -1,11 +1,16 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BunAdapter = void 0;
 exports.getFiles = getFiles;
 exports.getFile = getFile;
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
 const ServerTypes_1 = require("../abstract/ServerTypes");
 class BunResponse {
-    constructor(cookieJar, handlerTimeoutMs, cookieDefaults) {
+    constructor(cookieJar, handlerTimeoutMs, cookieDefaults, downloadRoot) {
         this.statusCode = 200;
         this.statusExplicitlySet = false;
         this.headers = new Headers();
@@ -15,6 +20,7 @@ class BunResponse {
         this.cookieJar = cookieJar;
         this.handlerTimeoutMs = handlerTimeoutMs;
         this.cookieDefaults = cookieDefaults;
+        this.downloadRoot = downloadRoot ?? DEFAULT_DOWNLOAD_ROOT;
         this.endPromise = new Promise((resolve) => {
             this.resolveEnd = resolve;
         });
@@ -44,6 +50,9 @@ class BunResponse {
     header(name, value) {
         return this.set(name, value);
     }
+    setHeader(name, value) {
+        return this.set(name, value);
+    }
     cookie(name, value, options = {}) {
         if (this.ended) {
             return this;
@@ -110,6 +119,40 @@ class BunResponse {
         this.ended = true;
         this.resolveEnd?.();
     }
+    download(filePath, filename, callback) {
+        if (this.ended) {
+            return this;
+        }
+        try {
+            const safePath = resolveSafeDownloadPath(this.downloadRoot, filePath);
+            const stat = (0, fs_1.statSync)(safePath);
+            if (!stat.isFile()) {
+                const error = new Error("File not found");
+                callback?.(error);
+                if (!this.ended) {
+                    this.status(404).json({ message: "File not found" });
+                }
+                return this;
+            }
+            const resolvedName = filename && filename.trim().length > 0
+                ? filename
+                : path_1.default.basename(safePath);
+            this.headers.set("content-disposition", `attachment; filename="${sanitizeFilename(resolvedName)}"`);
+            const fileBuffer = (0, fs_1.readFileSync)(safePath);
+            this.rawResponse = new Response(fileBuffer);
+            this.ended = true;
+            this.resolveEnd?.();
+            callback?.();
+            return this;
+        }
+        catch (error) {
+            callback?.(error);
+            if (!this.ended) {
+                this.status(500).json({ message: "File download failed" });
+            }
+            return this;
+        }
+    }
     isEnded() {
         return this.ended;
     }
@@ -324,7 +367,7 @@ class BunApp extends BunRouter {
                 : typeof handlerTimeoutSetting === "number"
                     ? handlerTimeoutSetting
                     : undefined;
-            const trustProxy = resolveTrustProxySetting(this.get("trustProxy"));
+            const trustProxy = resolveTrustProxySetting(this);
             const maxConcurrentRequests = Number(this.get("maxConcurrentRequests") ?? 0);
             if (maxConcurrentRequests > 0 && this.activeRequests >= maxConcurrentRequests) {
                 return new Response(JSON.stringify({ message: "Server busy" }), {
@@ -334,7 +377,7 @@ class BunApp extends BunRouter {
             }
             this.activeRequests += 1;
             const req = createRequest(request, client?.address, trustProxy);
-            const res = new BunResponse(cookieJar, handlerTimeoutMs, resolveCookieDefaults(this.get("cookieDefaults")));
+            const res = new BunResponse(cookieJar, handlerTimeoutMs, resolveCookieDefaults(this.get("cookieDefaults")), resolveDownloadRoot(this.get("downloadRoot")));
             try {
                 await this.handle(req, res, () => undefined);
             }
@@ -470,6 +513,12 @@ const createMultipartBodyParser = (app) => {
         if (!contentType.includes("multipart/form-data")) {
             return next();
         }
+        if (app.get("fileUploadEnabled") !== true) {
+            res
+                .status(415)
+                .json({ message: "File uploads are disabled. Enable FileUploadModule." });
+            return;
+        }
         const options = normalizeMultipartOptions(app.get("multipart"));
         const lengthHeader = req.headers["content-length"];
         const contentLength = parseContentLength(lengthHeader);
@@ -487,6 +536,8 @@ const createMultipartBodyParser = (app) => {
             const fields = {};
             const files = {};
             let fileCount = 0;
+            let fieldCount = 0;
+            let fieldBytes = 0;
             for (const [key, value] of formData.entries()) {
                 if (isFile(value)) {
                     if (value.size > options.maxFileBytes) {
@@ -530,6 +581,17 @@ const createMultipartBodyParser = (app) => {
                 }
                 const existing = fields[key];
                 const textValue = String(value);
+                fieldCount += 1;
+                if (fieldCount > options.maxFields) {
+                    res.status(413).json({ message: "Payload too large" });
+                    return;
+                }
+                const textBytes = Buffer.byteLength(textValue, "utf8");
+                fieldBytes += textBytes;
+                if (textBytes > options.maxFieldBytes || fieldBytes > options.maxFieldsBytes) {
+                    res.status(413).json({ message: "Payload too large" });
+                    return;
+                }
                 if (existing === undefined) {
                     fields[key] = textValue;
                 }
@@ -598,6 +660,9 @@ const DEFAULT_MULTIPART_OPTIONS = {
     maxBodyBytes: 10 * 1024 * 1024,
     maxFileBytes: 10 * 1024 * 1024,
     maxFiles: 10,
+    maxFields: 200,
+    maxFieldBytes: 64 * 1024,
+    maxFieldsBytes: 512 * 1024,
 };
 function serializeCookie(name, value, options) {
     const parts = [`${name}=${encodeURIComponent(value)}`];
@@ -670,6 +735,9 @@ function normalizeMultipartOptions(input) {
         maxBodyBytes: value.maxBodyBytes ?? DEFAULT_MULTIPART_OPTIONS.maxBodyBytes,
         maxFileBytes: value.maxFileBytes ?? DEFAULT_MULTIPART_OPTIONS.maxFileBytes,
         maxFiles: value.maxFiles ?? DEFAULT_MULTIPART_OPTIONS.maxFiles,
+        maxFields: value.maxFields ?? DEFAULT_MULTIPART_OPTIONS.maxFields,
+        maxFieldBytes: value.maxFieldBytes ?? DEFAULT_MULTIPART_OPTIONS.maxFieldBytes,
+        maxFieldsBytes: value.maxFieldsBytes ?? DEFAULT_MULTIPART_OPTIONS.maxFieldsBytes,
         allowedMimeTypes: value.allowedMimeTypes,
         allowedFileSignatures: value.allowedFileSignatures,
         validateFile: value.validateFile,
@@ -734,6 +802,7 @@ function parseContentLength(header) {
     return Number.isNaN(parsed) ? undefined : parsed;
 }
 const DEFAULT_HANDLER_TIMEOUT_MS = 30000;
+const DEFAULT_DOWNLOAD_ROOT = process.cwd();
 function readSetCookieHeaders(headers) {
     const bunHeaders = headers;
     const setCookieFromApi = bunHeaders.getSetCookie?.() ??
@@ -909,18 +978,23 @@ function applyCookieDefaults(options, defaults) {
     return { ...defaults.options, ...options };
 }
 function resolveCookieDefaults(input) {
+    const baseDefaults = getDefaultCookieDefaults();
     if (!input || typeof input !== "object") {
-        return undefined;
+        return baseDefaults;
     }
     const defaults = input;
     if (!defaults.options || typeof defaults.options !== "object") {
-        return undefined;
+        return baseDefaults;
     }
-    return defaults;
+    return {
+        applyTo: defaults.applyTo ?? baseDefaults.applyTo,
+        options: { ...baseDefaults.options, ...defaults.options },
+    };
 }
-function resolveTrustProxySetting(input) {
-    if (input === true || input === false) {
-        return input;
+function resolveTrustProxySetting(app) {
+    const input = app.get("trustProxy");
+    if (typeof input === "boolean") {
+        throw new Error("Invalid trustProxy boolean. Use a CIDR allowlist or a custom trust function instead.");
     }
     if (Array.isArray(input) && input.every((entry) => typeof entry === "string")) {
         return input;
@@ -937,6 +1011,19 @@ function shouldEnableSecurityHeaders(setting) {
     if (typeof setting === "boolean") {
         return setting;
     }
+    return isProduction();
+}
+function getDefaultCookieDefaults() {
+    return {
+        applyTo: "session",
+        options: {
+            httpOnly: true,
+            sameSite: "lax",
+            secure: isProduction(),
+        },
+    };
+}
+function isProduction() {
     return process?.env?.NODE_ENV === "production";
 }
 function createSecurityHeadersMiddleware(_app) {
@@ -1019,6 +1106,26 @@ function matchesSignature(buffer, kind) {
 function isValidCookieName(name) {
     return /^[!#$%&'*+\-.^_|~0-9A-Za-z]+$/.test(name);
 }
+function sanitizeFilename(value) {
+    return value.replace(/[/\\"]/g, "_");
+}
+function resolveDownloadRoot(input) {
+    if (typeof input === "string" && input.trim().length > 0) {
+        return path_1.default.resolve(input);
+    }
+    return DEFAULT_DOWNLOAD_ROOT;
+}
+function resolveSafeDownloadPath(root, inputPath) {
+    const resolvedRoot = path_1.default.resolve(root);
+    const resolved = path_1.default.resolve(resolvedRoot, inputPath);
+    const rootPrefix = resolvedRoot === path_1.default.parse(resolvedRoot).root
+        ? resolvedRoot
+        : `${resolvedRoot}${path_1.default.sep}`;
+    if (!resolved.startsWith(rootPrefix)) {
+        throw new Error("Invalid path");
+    }
+    return resolved;
+}
 async function runHandlers(handlers, req, res) {
     let index = 0;
     const dispatch = async () => {

package/dist/adapters/index.d.ts

@@ -1,2 +1 @@
 export * from "./BunAdapter";
-export * from "./ExpressAdapter";

package/dist/adapters/index.js

@@ -15,4 +15,3 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./BunAdapter"), exports);
-__exportStar(require("./ExpressAdapter"), exports);

package/dist/index.d.ts

@@ -4,7 +4,6 @@ export type { BootstrapServerOptions } from "./BootstrapServer";
 export { BootstrapStandardServer } from "./BootstrapStandardServer";
 export type { BootstrapStandardServerOptions } from "./BootstrapStandardServer";
 export * from "./adapters";
-export * from "./createRouter";
 export * from "./modules";
 export * from "./abstract";
 export * from "./decorators";

package/dist/index.js

@@ -21,7 +21,6 @@ Object.defineProperty(exports, "BootstrapServer", { enumerable: true, get: funct
 var BootstrapStandardServer_1 = require("./BootstrapStandardServer");
 Object.defineProperty(exports, "BootstrapStandardServer", { enumerable: true, get: function () { return BootstrapStandardServer_1.BootstrapStandardServer; } });
 __exportStar(require("./adapters"), exports);
-__exportStar(require("./createRouter"), exports);
 __exportStar(require("./modules"), exports);
 __exportStar(require("./abstract"), exports);
 __exportStar(require("./decorators"), exports);

package/dist/modules/ControllersModule.js

@@ -24,7 +24,7 @@ class ControllersModule extends abstract_1.BaseServerModule {
             if (!basePath) {
                 return;
             }
-            const adapter = context?.adapter ?? new adapters_1.ExpressAdapter();
+            const adapter = context?.adapter ?? new adapters_1.BunAdapter();
             const router = adapter.createRouter();
             // Create a single controller instance per controller class (singleton pattern)
             const controllerInstance = new ControllerClass();
@@ -109,7 +109,7 @@ class ControllersModule extends abstract_1.BaseServerModule {
                                 break;
                         }
                     });
-                    // Fallbacks for common Express arguments when not explicitly decorated
+                    // Fallbacks for common handler arguments when not explicitly decorated
                     if (args[0] === undefined) {
                         args[0] = req;
                     }

package/dist/modules/CorsModule.d.ts

@@ -1,11 +1,11 @@
 import { BaseServerModule } from "../abstract";
 import { ServerApp, ServerContext } from "../abstract";
-import cors from "cors";
+import type { CorsOptions } from "cors";
 export declare class CorsModule extends BaseServerModule {
     name: string;
     priority: number;
     private corsOptions;
-    constructor(corsOptions?: cors.CorsOptions);
+    constructor(corsOptions?: CorsOptions);
     getModuleName(): string;
     init(app: ServerApp, context?: ServerContext): void;
 }

package/dist/modules/CorsModule.js

@@ -1,12 +1,7 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CorsModule = void 0;
 const abstract_1 = require("../abstract");
-const abstract_2 = require("../abstract");
-const cors_1 = __importDefault(require("cors"));
 class CorsModule extends abstract_1.BaseServerModule {
     constructor(corsOptions) {
         super();
@@ -24,11 +19,6 @@ class CorsModule extends abstract_1.BaseServerModule {
         return this.name;
     }
     init(app, context) {
-        const runtime = context?.runtime ?? abstract_2.ServerRuntime.Express;
-        if (runtime === abstract_2.ServerRuntime.Express) {
-            app.use((0, cors_1.default)(this.corsOptions));
-            return;
-        }
         app.use(createCorsMiddleware(this.corsOptions));
     }
 }

package/dist/modules/FileUploadModule.d.ts

@@ -1,6 +1,16 @@
 import { BaseServerModule } from "../abstract";
-import { ServerApp, ServerContext } from "../abstract";
-import type { Options as FileUploadOptions } from "express-fileupload";
+import { BunMultipartFile, ServerApp, ServerContext } from "../abstract";
+export type FileUploadOptions = {
+    maxBodyBytes?: number;
+    maxFileBytes?: number;
+    maxFiles?: number;
+    maxFields?: number;
+    maxFieldBytes?: number;
+    maxFieldsBytes?: number;
+    allowedMimeTypes?: string[];
+    allowedFileSignatures?: Array<"png" | "jpg" | "jpeg" | "pdf">;
+    validateFile?: (file: BunMultipartFile) => boolean | Promise<boolean>;
+};
 export declare class FileUploadModule extends BaseServerModule {
     name: string;
     priority: number;

package/dist/modules/FileUploadModule.js

@@ -2,28 +2,19 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FileUploadModule = void 0;
 const abstract_1 = require("../abstract");
-const abstract_2 = require("../abstract");
 class FileUploadModule extends abstract_1.BaseServerModule {
     constructor(fileUploadOptions) {
         super();
         this.name = "FileUpload";
         this.priority = -60;
-        this.fileUploadOptions = fileUploadOptions || {
-            limits: { fileSize: 50 * 1024 * 1024 },
-            useTempFiles: true,
-            tempFileDir: "/tmp/",
-        };
+        this.fileUploadOptions = fileUploadOptions ?? {};
     }
     getModuleName() {
         return this.name;
     }
     init(app, context) {
-        const runtime = context?.runtime ?? abstract_2.ServerRuntime.Express;
-        if (runtime === abstract_2.ServerRuntime.Express) {
-            const fileUpload = require("express-fileupload");
-            app.use(fileUpload(this.fileUploadOptions));
-            return;
-        }
+        app.set?.("fileUploadEnabled", true);
+        app.set?.("multipart", this.fileUploadOptions);
     }
 }
 exports.FileUploadModule = FileUploadModule;

package/dist/modules/RateLimitModule.d.ts

@@ -1,6 +1,13 @@
 import { BaseServerModule } from "../abstract";
 import { ServerApp, ServerContext } from "../abstract";
-import type { Options as RateLimitOptions } from "express-rate-limit";
+export type RateLimitOptions = {
+    windowMs?: number;
+    limit?: number;
+    max?: number;
+    standardHeaders?: boolean;
+    legacyHeaders?: boolean;
+    message?: string | Record<string, unknown>;
+};
 export declare class RateLimitModule extends BaseServerModule {
     name: string;
     priority: number;

package/dist/modules/RateLimitModule.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RateLimitModule = void 0;
 const abstract_1 = require("../abstract");
-const abstract_2 = require("../abstract");
 class RateLimitModule extends abstract_1.BaseServerModule {
     constructor(limiterOptions) {
         super();
@@ -19,14 +18,6 @@ class RateLimitModule extends abstract_1.BaseServerModule {
         return this.name;
     }
     init(app, context) {
-        const runtime = context?.runtime ?? abstract_2.ServerRuntime.Express;
-        if (runtime === abstract_2.ServerRuntime.Express) {
-            const rateLimitModule = require("express-rate-limit");
-            const rateLimit = rateLimitModule.default ?? rateLimitModule;
-            const limiter = rateLimit(this.limiterOptions);
-            app.use(limiter);
-            return;
-        }
         app.use(createRateLimitMiddleware(this.limiterOptions));
     }
 }

package/dist/modules/SecurityModule.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SecurityModule = void 0;
 const abstract_1 = require("../abstract");
-const abstract_2 = require("../abstract");
 class SecurityModule extends abstract_1.BaseServerModule {
     constructor(helmetOptions) {
         super();
@@ -27,13 +26,6 @@ class SecurityModule extends abstract_1.BaseServerModule {
         return this.name;
     }
     init(app, context) {
-        const runtime = context?.runtime ?? abstract_2.ServerRuntime.Express;
-        if (runtime === abstract_2.ServerRuntime.Express) {
-            const helmetModule = require("helmet");
-            const helmet = helmetModule.default ?? helmetModule;
-            app.use(helmet(this.helmetOptions));
-            return;
-        }
         app.use(createSecurityMiddleware(this.helmetOptions));
     }
 }

package/dist/modules/index.d.ts

@@ -3,5 +3,4 @@ export * from "./ControllersModule";
 export * from "./FileUploadModule";
 export * from "./RateLimitModule";
 export * from "./RequestContextModule";
-export * from "./RoutesModule";
 export * from "./SecurityModule";

package/dist/modules/index.js

@@ -19,5 +19,4 @@ __exportStar(require("./ControllersModule"), exports);
 __exportStar(require("./FileUploadModule"), exports);
 __exportStar(require("./RateLimitModule"), exports);
 __exportStar(require("./RequestContextModule"), exports);
-__exportStar(require("./RoutesModule"), exports);
 __exportStar(require("./SecurityModule"), exports);

package/dist/testing/createDecoratedTestApp.d.ts

@@ -1,6 +1,6 @@
 import type { BootstrapServer } from "../BootstrapServer";
 import { ControllersModule } from "../modules";
-import { BaseServerService, ServerApp, ServerRuntime } from "../abstract";
+import { BaseServerService, ServerApp } from "../abstract";
 import { BootstrapStandardServerOptions } from "../BootstrapStandardServer";
 type ControllerClass<T = any> = new (...args: any[]) => T;
 export interface DecoratedTestAppOptions {
@@ -9,7 +9,6 @@ export interface DecoratedTestAppOptions {
     port?: number;
     services?: BaseServerService[];
     standardOptions?: BootstrapStandardServerOptions;
-    runtime?: ServerRuntime;
 }
 export interface DecoratedTestAppResult {
     app: ServerApp;

package/dist/testing/createDecoratedTestApp.js

@@ -12,7 +12,7 @@ const mergeOptions = (base, override) => {
         ...(override.services ?? []),
     ];
     return {
-        runtime: override.runtime ?? base.runtime,
+        adapter: override.adapter ?? base.adapter,
         services: mergedServices.length ? mergedServices : undefined,
         modules: {
             ...(base.modules ?? {}),
@@ -34,7 +34,6 @@ async function createDecoratedTestApp(options) {
     const mergedOptions = mergeOptions(baseOptions, standardOptions);
     const server = (0, BootstrapStandardServer_1.BootstrapStandardServer)(port, moduleInstance, {
         ...mergedOptions,
-        runtime: options.runtime ?? mergedOptions.runtime,
     });
     await server.initialize();
     return {

package/package.json

@@ -1,41 +1,33 @@
 {
   "name": "@abejarano/ts-express-server",
   "author": "angel bejarano / angel.bejarano@jaspesoft.com",
-  "version": "1.7.5",
+  "version": "1.7.7",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
     "dist"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "clean": "rimraf dist",
-    "prepare": "yarn build",
-    "prebuild": "yarn clean",
-    "format": "prettier --write .",
-    "format:check": "prettier --check .",
-    "typecheck": "tsc --noEmit",
-    "prepack": "yarn build",
-    "version:patch": "npm version patch",
-    "version:minor": "npm version minor",
-    "version:major": "npm version major",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage"
+    "build": "bun run tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "prepare": "bun run build",
+    "prebuild": "bun run clean",
+    "format": "bun run prettier --write .",
+    "format:check": "bun run prettier --check .",
+    "typecheck": "bun run tsc --noEmit",
+    "prepack": "bun run build",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "test:coverage": "bun test --coverage"
   },
   "keywords": [
     "server",
     "modular",
-    "express"
+    "bun"
   ],
   "license": "MIT",
   "dependencies": {
-    "body-parser": "^2.2.1",
-    "cookie-parser": "^1.4.7",
     "cors": "^2.8.5",
-    "express": "^5.2.1",
-    "express-fileupload": "^1.5.2",
-    "express-rate-limit": "^8.2.1",
     "helmet": "^8.1.0",
     "reflect-metadata": "^0.2.2",
     "uuid": "^13.0.0"
@@ -43,24 +35,14 @@
   "devDependencies": {
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
-    "@types/body-parser": "^1.19.6",
-    "@types/cookie-parser": "^1.4.9",
     "@types/cors": "^2.8.19",
-    "@types/express": "^5.0.6",
-    "@types/express-fileupload": "^1.5.1",
-    "@types/jest": "^30.0.0",
-    "@types/node": "^25.0.3",
-    "@types/supertest": "^6.0.3",
-    "jest": "^30.2.0",
+    "bun-types": "^1.3.5",
     "prettier": "^3.6.2",
-    "rimraf": "^6.0.1",
     "semantic-release": "^25.0.2",
-    "supertest": "^7.1.4",
-    "ts-jest": "^29.4.5",
     "typescript": "^5.9.3"
   },
   "engines": {
-    "node": ">=20"
+    "bun": ">=1.3.5"
   },
   "repository": {
     "type": "git",

package/dist/adapters/ExpressAdapter.d.ts

@@ -1,8 +0,0 @@
-import { ServerAdapter, ServerApp, ServerInstance, ServerRouter, ServerRuntime } from "../abstract/ServerTypes";
-export declare class ExpressAdapter implements ServerAdapter {
-    runtime: ServerRuntime;
-    createApp(): ServerApp;
-    createRouter(): ServerRouter;
-    configure(app: ServerApp, port: number): void;
-    listen(app: ServerApp, port: number, onListen: () => void): ServerInstance;
-}

package/dist/adapters/ExpressAdapter.js

@@ -1,65 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExpressAdapter = void 0;
-const ServerTypes_1 = require("../abstract/ServerTypes");
-let expressModule = null;
-const getExpressModule = () => {
-    if (!expressModule) {
-        expressModule = require("express");
-    }
-    return expressModule;
-};
-class ExpressAdapter {
-    constructor() {
-        this.runtime = ServerTypes_1.ServerRuntime.Express;
-    }
-    createApp() {
-        const express = getExpressModule();
-        return express();
-    }
-    createRouter() {
-        const express = getExpressModule();
-        return express.Router();
-    }
-    configure(app, port) {
-        const expressApp = app;
-        const express = getExpressModule();
-        const bodyParser = require("body-parser");
-        const cookieParser = require("cookie-parser");
-        const jsonParser = express.json();
-        expressApp.use((req, res, next) => {
-            if (!shouldParseJson(req)) {
-                return next();
-            }
-            return jsonParser(req, res, next);
-        });
-        expressApp.use(bodyParser.urlencoded({ extended: true }));
-        expressApp.use(cookieParser());
-        expressApp.set("port", port);
-        expressApp.set("trust proxy", 1);
-    }
-    listen(app, port, onListen) {
-        const expressApp = app;
-        return expressApp.listen(port, onListen);
-    }
-}
-exports.ExpressAdapter = ExpressAdapter;
-const shouldParseJson = (req) => {
-    const method = String(req.method || "").toUpperCase();
-    if (method === "GET" || method === "HEAD") {
-        return false;
-    }
-    const lengthHeader = req.headers?.["content-length"];
-    if (lengthHeader === undefined) {
-        return true;
-    }
-    const value = Array.isArray(lengthHeader) ? lengthHeader[0] : lengthHeader;
-    if (!value) {
-        return true;
-    }
-    const parsed = Number.parseInt(value, 10);
-    if (Number.isNaN(parsed)) {
-        return true;
-    }
-    return parsed > 0;
-};

package/dist/createRouter.d.ts

@@ -1,2 +0,0 @@
-import { ServerRuntime, ServerRouter } from "./abstract";
-export declare const createRouter: (runtime?: ServerRuntime) => ServerRouter;

package/dist/createRouter.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createRouter = void 0;
-const abstract_1 = require("./abstract");
-const adapters_1 = require("./adapters");
-const createRouter = (runtime = abstract_1.ServerRuntime.Express) => {
-    if (runtime === abstract_1.ServerRuntime.Bun) {
-        return new adapters_1.BunAdapter().createRouter();
-    }
-    return new adapters_1.ExpressAdapter().createRouter();
-};
-exports.createRouter = createRouter;

package/dist/modules/RoutesModule.d.ts

@@ -1,17 +0,0 @@
-import { BaseServerModule } from "../abstract";
-import { ServerApp, ServerContext, ServerHandler, ServerRouter } from "../abstract";
-export interface RouteConfig {
-    path: string;
-    router: ServerRouter;
-    middleware?: ServerHandler[] | ServerHandler;
-}
-export declare class RoutesModule extends BaseServerModule {
-    name: string;
-    priority: number;
-    private routes;
-    constructor(routes?: RouteConfig[]);
-    getModuleName(): string;
-    addRoute(route: RouteConfig): void;
-    addRoutes(routes: RouteConfig[]): void;
-    init(app: ServerApp, context?: ServerContext): void;
-}

package/dist/modules/RoutesModule.js

@@ -1,43 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RoutesModule = void 0;
-const abstract_1 = require("../abstract");
-const abstract_2 = require("../abstract");
-class RoutesModule extends abstract_1.BaseServerModule {
-    constructor(routes = []) {
-        super();
-        this.name = "Routes";
-        this.priority = 10; // Executed after basic middlewares
-        this.routes = routes;
-    }
-    getModuleName() {
-        return this.name;
-    }
-    addRoute(route) {
-        this.routes.push({
-            ...route,
-        });
-    }
-    addRoutes(routes) {
-        this.routes.push(...routes);
-    }
-    init(app, context) {
-        if (context?.runtime === abstract_2.ServerRuntime.Bun) {
-            console.warn("[RoutesModule] Express routers are not supported on Bun. Migrate to decorated controllers for Bun runtime.");
-        }
-        this.routes.forEach(({ path, router, middleware }) => {
-            const middlewareList = Array.isArray(middleware)
-                ? middleware
-                : middleware
-                    ? [middleware]
-                    : [];
-            if (middlewareList.length > 0) {
-                app.use(path, ...middlewareList, router);
-            }
-            else {
-                app.use(path, router);
-            }
-        });
-    }
-}
-exports.RoutesModule = RoutesModule;