@abejarano/ts-express-server 2.0.0 → 2.0.2

package/README.md

@@ -1,24 +1,22 @@
 # TypeScript Server Framework (Bun)
 
-A modular and extensible TypeScript framework for building 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
+- 🏗️ **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

package/dist/BootstrapStandardServer.d.ts

@@ -1,5 +1,5 @@
 import { BootstrapServer } from "./BootstrapServer";
-import { ControllersModule, RoutesModule } from "./modules";
+import { ControllersModule } from "./modules";
 import { BaseServerModule, BaseServerService, ServerAdapter } from "./abstract";
 export interface BootstrapStandardServerOptions {
     adapter?: ServerAdapter;
@@ -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) {
@@ -67,9 +46,6 @@ function BootstrapStandardServer(port, arg2, arg3, arg4, arg5) {
     const server = new BootstrapServer_1.BootstrapServer(port, {
         adapter: options?.adapter,
     }).addModules(modulesToRegister);
-    if (controllersModule) {
-        server.addModule(controllersModule);
-    }
     if (services) {
         server.addServices(services);
     }

package/dist/adapters/BunAdapter.js

@@ -138,7 +138,8 @@ class BunResponse {
                 ? filename
                 : path_1.default.basename(safePath);
             this.headers.set("content-disposition", `attachment; filename="${sanitizeFilename(resolvedName)}"`);
-            this.rawResponse = new Response(Bun.file(safePath));
+            const fileBuffer = (0, fs_1.readFileSync)(safePath);
+            this.rawResponse = new Response(fileBuffer);
             this.ended = true;
             this.resolveEnd?.();
             callback?.();

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/CorsModule.d.ts

@@ -5,6 +5,7 @@ export declare class CorsModule extends BaseServerModule {
     name: string;
     priority: number;
     private corsOptions;
+    private static defaultCorsOptions;
     constructor(corsOptions?: CorsOptions);
     getModuleName(): string;
     init(app: ServerApp, context?: ServerContext): void;

package/dist/modules/CorsModule.js

@@ -7,12 +7,9 @@ class CorsModule extends abstract_1.BaseServerModule {
         super();
         this.name = "Cors";
         this.priority = -90;
-        this.corsOptions = corsOptions || {
-            origin: "*",
-            allowedHeaders: ["content-type"],
-            methods: ["GET", "HEAD", "PUT", "PATCH", "POST", "DELETE", "OPTIONS"],
-            preflightContinue: false,
-            optionsSuccessStatus: 204,
+        this.corsOptions = {
+            ...CorsModule.defaultCorsOptions,
+            ...(corsOptions || {}),
         };
     }
     getModuleName() {
@@ -23,6 +20,13 @@ class CorsModule extends abstract_1.BaseServerModule {
     }
 }
 exports.CorsModule = CorsModule;
+CorsModule.defaultCorsOptions = {
+    origin: "*",
+    allowedHeaders: ["content-type"],
+    methods: ["GET", "HEAD", "PUT", "PATCH", "POST", "DELETE", "OPTIONS"],
+    preflightContinue: false,
+    optionsSuccessStatus: 204,
+};
 const createCorsMiddleware = (options) => {
     return (req, res, next) => {
         const originHeader = String(req.headers?.origin || "");

package/dist/modules/FileUploadModule.d.ts

@@ -8,7 +8,7 @@ export type FileUploadOptions = {
     maxFieldBytes?: number;
     maxFieldsBytes?: number;
     allowedMimeTypes?: string[];
-    allowedFileSignatures?: Array<"png" | "jpg" | "jpeg" | "pdf">;
+    allowedFileSignatures?: Array<"png" | "jpg" | "jpeg" | "pdf" | "csv">;
     validateFile?: (file: BunMultipartFile) => boolean | Promise<boolean>;
 };
 export declare class FileUploadModule extends BaseServerModule {

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/package.json

@@ -1,27 +1,24 @@
 {
   "name": "@abejarano/ts-express-server",
   "author": "angel bejarano / angel.bejarano@jaspesoft.com",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "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",
@@ -39,17 +36,13 @@
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
     "@types/cors": "^2.8.19",
-    "@types/jest": "^30.0.0",
-    "@types/node": "^25.0.3",
-    "jest": "^30.2.0",
+    "bun-types": "^1.3.5",
     "prettier": "^3.6.2",
-    "rimraf": "^6.0.1",
     "semantic-release": "^25.0.2",
-    "ts-jest": "^29.4.5",
     "typescript": "^5.9.3"
   },
   "engines": {
-    "node": ">=20"
+    "bun": ">=1.3.5"
   },
   "repository": {
     "type": "git",

package/dist/createRouter.d.ts

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

package/dist/createRouter.js

@@ -1,8 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createRouter = void 0;
-const adapters_1 = require("./adapters");
-const createRouter = () => {
-    return new adapters_1.BunAdapter().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,39 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RoutesModule = void 0;
-const abstract_1 = 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) {
-        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;