@abejarano/ts-express-server 1.7.7 → 2.0.0

package/README.md

@@ -1,22 +1,24 @@
 # TypeScript Server Framework (Bun)
 
-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.
+A modular and extensible TypeScript framework for building Bun servers with a clean architecture pattern that separates concerns between server modules and services.
 
 ## Features
 
-- 🏗️ **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
+- 🏗️ **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
 
 ## Installation
 
 ```bash
-bun add @abejarano/ts-express-server
+npm install @abejarano/ts-express-server
+# or
+yarn add @abejarano/ts-express-server
 ```
 
 ## Documentation

package/dist/BootstrapStandardServer.d.ts

@@ -1,5 +1,5 @@
 import { BootstrapServer } from "./BootstrapServer";
-import { ControllersModule } from "./modules";
+import { ControllersModule, RoutesModule } from "./modules";
 import { BaseServerModule, BaseServerService, ServerAdapter } from "./abstract";
 export interface BootstrapStandardServerOptions {
     adapter?: ServerAdapter;
@@ -13,6 +13,9 @@ export interface BootstrapStandardServerOptions {
     };
     services?: BaseServerService[];
 }
-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;
+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;

package/dist/BootstrapStandardServer.js

@@ -3,11 +3,27 @@ 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) {
+function BootstrapStandardServer(port, arg2, arg3, arg4, arg5) {
+    let routesModule;
     let controllersModule;
     let services;
     let options;
-    controllersModule = arg2;
+    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");
+    }
     const addServices = (value) => {
         if (!value?.length) {
             return;
@@ -18,6 +34,10 @@ function BootstrapStandardServer(port, arg2, arg3, arg4) {
         if (!value) {
             return;
         }
+        if (value instanceof modules_1.ControllersModule) {
+            setControllersModule(value);
+            return;
+        }
         if (Array.isArray(value)) {
             addServices(value);
             return;
@@ -26,8 +46,9 @@ function BootstrapStandardServer(port, arg2, arg3, arg4) {
     };
     processOptionalArg(arg3);
     processOptionalArg(arg4);
+    processOptionalArg(arg5);
     addServices(options?.services);
-    const modulesToRegister = [controllersModule];
+    const modulesToRegister = [routesModule];
     const preset = options?.modules;
     const registerModule = (factory, override) => {
         if (override === false) {
@@ -46,6 +67,9 @@ function BootstrapStandardServer(port, arg2, arg3, arg4) {
     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,8 +138,7 @@ class BunResponse {
                 ? 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.rawResponse = new Response(Bun.file(safePath));
             this.ended = true;
             this.resolveEnd?.();
             callback?.();

package/dist/createRouter.d.ts

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

package/dist/createRouter.js

@@ -0,0 +1,8 @@
+"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/index.d.ts

@@ -4,6 +4,7 @@ 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,6 +21,7 @@ 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/RoutesModule.d.ts

@@ -0,0 +1,17 @@
+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

@@ -0,0 +1,39 @@
+"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;

package/dist/modules/index.d.ts

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

package/dist/modules/index.js

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