@asenajs/asena 0.3.3 → 0.5.0

package/dist/lib/server/AsenaServer.js

@@ -1,92 +1,89 @@
-import { IocEngine } from '../ioc';
-import { readConfigFile } from '../ioc/helper/fileHelper';
-import { ComponentType } from '../ioc/types';
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { ComponentType, CoreBootstrapPhase, CoreService, ICoreServiceNames, } from '../ioc';
 import * as path from 'node:path';
 import { ComponentConstants } from '../ioc/constants';
 import * as bun from 'bun';
-import { green, yellow } from '../logger';
+import { blue, green, yellow } from '../logger';
 import { getOwnTypedMetadata, getTypedMetadata } from '../utils/typedMetadata';
-import { PrepareMiddlewareService } from './src/services/PrepareMiddlewareService';
-import { PrepareConfigService } from './src/services/PrepareConfigService';
-import { PrepareWebsocketService } from './src/services/PrepareWebsocketService';
-import { PrepareValidatorService } from './src/services/PrepareValidatorService';
-import { PrepareStaticServeConfigService } from './src/services/PrepareStaticServeConfigService';
-export class AsenaServer {
-    _port;
-    controllers = [];
-    _components = [];
-    _ioc;
-    _logger;
+import { Inject, PostConstruct } from '../ioc/component';
+/**
+ * @description AsenaServer - Main server class for Asena framework
+ * Now a core service managed by IoC container with field injection
+ */
+let AsenaServer = class AsenaServer {
+    serviceName = 'AsenaServer';
+    _coreContainer;
     _adapter;
+    _logger;
     prepareMiddleware;
     prepareConfigService;
     prepareWebsocketService;
     prepareValidatorService;
     prepareStaticServeConfigService;
-    constructor(adapter, logger) {
-        this._adapter = adapter;
-        this._logger = logger;
-        this._logger.info(`
-    ___    _____  ______ _   __ ___ 
-   /   |  / ___/ / ____// | / //   |
-  / /| |  \\__ \\ / __/  /  |/ // /| |
- / ___ | ___/ // /___ / /|  // ___ |
-/_/  |_|/____//_____//_/ |_//_/  |_|  
-                            `);
-    }
-    async initialize() {
-        const config = await readConfigFile();
-        if (!config) {
-            this._logger.warn('asena-config file not found');
-        }
-        this._ioc = new IocEngine(config);
-        await this._ioc.searchAndRegister(this._components);
-        this.prepareMiddleware = new PrepareMiddlewareService(this._ioc.container, this._logger);
-        this.prepareConfigService = new PrepareConfigService(this._ioc.container, this._logger);
-        this.prepareWebsocketService = new PrepareWebsocketService(this._ioc.container, this._logger);
-        this.prepareValidatorService = new PrepareValidatorService(this._ioc.container, this._logger);
-        this.prepareStaticServeConfigService = new PrepareStaticServeConfigService(this._ioc.container, this._logger);
-        return this._ioc.container;
+    // Instance state
+    _port;
+    _gc = false;
+    controllers = [];
+    /**
+     * @description Lifecycle hook - called after dependencies are injected
+     * @returns {void}
+     */
+    onInit() {
+        this._logger.info(`${blue('[AsenaServer]')} is initialized`);
     }
-    async start(gc = false) {
-        await this.initialize();
+    /**
+     * @description Start the server
+     * Main entry point after factory creation
+     * @returns {Promise<void>}
+     */
+    async start() {
         this._logger.info(`Adapter: ${green(this._adapter.name)} implemented`);
         this._adapter.setPort(this._port);
         this._logger.info('All components registered and ready to use');
+        // Phase 7: Application setup
+        this._coreContainer.setPhase(CoreBootstrapPhase.APPLICATION_SETUP);
         await this.prepareConfigs();
         await this.initializeControllers();
         await this.prepareWebSocket();
-        this._logger.info('Server started on port ' + this._port);
+        // Phase 8: Server ready
+        this._coreContainer.setPhase(CoreBootstrapPhase.SERVER_READY);
         await this._adapter.start();
-        // TODO: this is wierd but when we call gc asena uses less memory rest of the time
-        if (gc) {
+        if (this._gc) {
             bun.gc(true);
         }
     }
-    components(components) {
-        this._components = components.map((_component) => {
-            const face = getTypedMetadata(ComponentConstants.InterfaceKey, _component);
-            const component = {
-                Class: _component,
-                interface: face,
-            };
-            return component;
-        });
-        return this;
-    }
+    /**
+     * @description Configure server port
+     * Builder pattern for API compatibility
+     * @param {number} port - Port number
+     * @returns {this}
+     */
     port(port) {
         this._port = port;
         return this;
     }
-    logger(value) {
-        this._logger = value;
-        return this;
+    /**
+     * @description Get current CoreContainer instance
+     * @returns {CoreContainer}
+     */
+    get coreContainer() {
+        return this._coreContainer;
     }
+    /**
+     * @description Initialize and register all controllers
+     * @returns {Promise<void>}
+     */
     async initializeControllers() {
         await this.validateAndSetControllers();
         for (const controller of this.controllers) {
-            const name = getTypedMetadata(ComponentConstants.NameKey, controller.constructor);
-            this._logger.info(`Controller: ${green(name)} found:`);
             const routes = getOwnTypedMetadata(ComponentConstants.RouteKey, controller.constructor) || {};
             const routePath = getOwnTypedMetadata(ComponentConstants.PathKey, controller.constructor) || '';
             await this.prepareTopMiddlewares({ controller, routePath });
@@ -101,13 +98,18 @@ export class AsenaServer {
                     handler: controller[name].bind(controller),
                     staticServe: await this.prepareStaticServeConfig(params.staticServe),
                     validator: validatorInstance,
+                    controllerName: getTypedMetadata(ComponentConstants.NameKey, controller.constructor),
+                    controllerBasePath: routePath,
                 });
             }
-            this._logger.info(`Controller: ${green(name)} successfully registered.`);
         }
     }
+    /**
+     * @description Validate and set controllers from container
+     * @returns {Promise<void>}
+     */
     async validateAndSetControllers() {
-        const controllers = await this._ioc.container.resolveAll(ComponentType.CONTROLLER);
+        const controllers = await this._coreContainer.container.resolveAll(ComponentType.CONTROLLER);
         if (controllers !== null) {
             // check if any controller is array or not
             if (controllers.find((controller) => Array.isArray(controller))) {
@@ -116,29 +118,62 @@ export class AsenaServer {
             this.controllers = controllers;
         }
     }
+    /**
+     * @description Prepare static serve configuration
+     * @param {StaticServeClass} staticServeClass - Static serve class
+     * @returns {Promise<BaseStaticServeParams>}
+     */
     async prepareStaticServeConfig(staticServeClass) {
         return await this.prepareStaticServeConfigService.prepare(staticServeClass);
     }
+    /**
+     * @description Prepare top-level middlewares for controller or websocket
+     * @param {PrepareMiddlewareParams} params - Middleware parameters
+     * @param {boolean} websocket - Whether this is for websocket
+     * @returns {Promise<BaseMiddleware[]>}
+     */
     async prepareTopMiddlewares({ controller, routePath }, websocket = false) {
         const topMiddlewares = getTypedMetadata(ComponentConstants.MiddlewaresKey, controller.constructor) || [];
         const middlewares = await this.prepareMiddlewares(topMiddlewares);
         if (websocket) {
             return middlewares;
         }
+        // Register controller-level middlewares with pattern matching
+        // Convert routePath to pattern: /api → /api/*
+        const routePattern = routePath ? `${routePath}/*` : undefined;
         for (const middleware of middlewares) {
-            await this._adapter.use(middleware, routePath);
+            await this._adapter.use(middleware, routePattern ? { include: [routePattern] } : undefined);
         }
     }
+    /**
+     * @description Prepare validator instance
+     * @param {ValidatorClass<any>} Validator - Validator class
+     * @returns {Promise<BaseValidator>}
+     */
     async prepareValidator(Validator) {
         return await this.prepareValidatorService.prepare(Validator);
     }
+    /**
+     * @description Prepare route-level middlewares
+     * @param {ApiParams} middlewareParams - Middleware parameters
+     * @returns {Promise<BaseMiddleware[]>}
+     */
     async prepareRouteMiddleware(middlewareParams) {
         const routeMiddlewares = middlewareParams?.middlewares || [];
         return this.prepareMiddlewares(routeMiddlewares);
     }
+    /**
+     * @description Prepare middlewares from classes
+     * @param {MiddlewareClass[]} middlewares - Middleware classes
+     * @returns {Promise<BaseMiddleware[]>}
+     */
     async prepareMiddlewares(middlewares) {
         return this.prepareMiddleware.prepare(middlewares);
     }
+    /**
+     * @description Prepare and register WebSocket routes
+     * @returns {Promise<void>}
+     */
     async prepareWebSocket() {
         const websockets = await this.prepareWebsocketService.prepare();
         if (!websockets) {
@@ -151,9 +186,33 @@ export class AsenaServer {
                 path: path,
                 middlewares: middlewares,
                 websocketService: websocket,
+                controllerName: getTypedMetadata(ComponentConstants.NameKey, websocket.constructor),
             });
         }
     }
+    /**
+     * @description Normalizes global middleware entry to config format
+     * Handles backward compatibility (MiddlewareClass → GlobalMiddlewareConfig)
+     *
+     * @param entry - Middleware entry (class or config object)
+     * @returns Normalized config object
+     */
+    normalizeMiddlewareEntry(entry) {
+        // If it's already a config object, return as-is
+        if (typeof entry === 'object' && 'middleware' in entry) {
+            return entry;
+        }
+        // If it's a class (old format), convert to config format
+        return {
+            middleware: entry,
+            routes: undefined, // No route config = apply to all routes
+        };
+    }
+    /**
+     * @description Prepare and apply configuration
+     * Updated to support pattern-based global middlewares
+     * @returns {Promise<void>}
+     */
     async prepareConfigs() {
         const configInstance = await this.prepareConfigService.prepare();
         if (!configInstance) {
@@ -165,15 +224,64 @@ export class AsenaServer {
         if (typeof configInstance.onError === 'function') {
             await this._adapter.onError(configInstance.onError.bind(configInstance));
         }
+        // Pattern-based global middleware registration
         if (typeof configInstance.globalMiddlewares === 'function') {
-            const middlewares = await configInstance.globalMiddlewares();
-            const preparedMiddlewares = await this.prepareMiddlewares(middlewares);
-            for (const middleware of preparedMiddlewares) {
-                await this._adapter.use(middleware);
+            const middlewareEntries = await configInstance.globalMiddlewares();
+            for (const entry of middlewareEntries) {
+                // Normalize entry to config format (handles backward compatibility)
+                const config = this.normalizeMiddlewareEntry(entry);
+                // Prepare middleware instances
+                const preparedMiddlewares = await this.prepareMiddlewares([config.middleware]);
+                // Register with adapter (pass route config)
+                for (const middleware of preparedMiddlewares) {
+                    await this._adapter.use(middleware, config.routes);
+                }
             }
         }
         const name = getOwnTypedMetadata(ComponentConstants.NameKey, configInstance.constructor);
         this._logger.info(`Config ${yellow(name)} applied`);
     }
-}
+};
+__decorate([
+    Inject(ICoreServiceNames.CORE_CONTAINER),
+    __metadata("design:type", Function)
+], AsenaServer.prototype, "_coreContainer", void 0);
+__decorate([
+    Inject(ICoreServiceNames.ASENA_ADAPTER),
+    __metadata("design:type", Object)
+], AsenaServer.prototype, "_adapter", void 0);
+__decorate([
+    Inject(ICoreServiceNames.SERVER_LOGGER),
+    __metadata("design:type", Object)
+], AsenaServer.prototype, "_logger", void 0);
+__decorate([
+    Inject(ICoreServiceNames.PREPARE_MIDDLEWARE_SERVICE),
+    __metadata("design:type", Function)
+], AsenaServer.prototype, "prepareMiddleware", void 0);
+__decorate([
+    Inject(ICoreServiceNames.PREPARE_CONFIG_SERVICE),
+    __metadata("design:type", Function)
+], AsenaServer.prototype, "prepareConfigService", void 0);
+__decorate([
+    Inject(ICoreServiceNames.PREPARE_WEBSOCKET_SERVICE),
+    __metadata("design:type", Function)
+], AsenaServer.prototype, "prepareWebsocketService", void 0);
+__decorate([
+    Inject(ICoreServiceNames.PREPARE_VALIDATOR_SERVICE),
+    __metadata("design:type", Function)
+], AsenaServer.prototype, "prepareValidatorService", void 0);
+__decorate([
+    Inject(ICoreServiceNames.PREPARE_STATIC_SERVE_CONFIG_SERVICE),
+    __metadata("design:type", Function)
+], AsenaServer.prototype, "prepareStaticServeConfigService", void 0);
+__decorate([
+    PostConstruct(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", void 0)
+], AsenaServer.prototype, "onInit", null);
+AsenaServer = __decorate([
+    CoreService(ICoreServiceNames.ASENA_SERVER)
+], AsenaServer);
+export { AsenaServer };
 //# sourceMappingURL=AsenaServer.js.map

package/dist/lib/server/AsenaServer.js.map

@@ -1 +1 @@
-{"version":3,"file":"AsenaServer.js","sourceRoot":"","sources":["../../../lib/server/AsenaServer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AsenaServer.js","sourceRoot":"","sources":["../../../lib/server/AsenaServer.ts"],"names":[],"mappings":";;;;;;;;;AACA,OAAO,EACL,aAAa,EACb,kBAAkB,EAElB,WAAW,EAEX,iBAAiB,GAClB,MAAM,QAAQ,CAAC;AAUhB,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,GAAG,MAAM,KAAK,CAAC;AAC3B,OAAO,EAAE,IAAI,EAAE,KAAK,EAAqB,MAAM,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAM/E,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGzD;;;GAGG;AAEI,IAAM,WAAW,GAAjB,MAAM,WAAW;IAEf,WAAW,GAAG,aAAa,CAAC;IAG3B,cAAc,CAAiB;IAG/B,QAAQ,CAAK;IAGb,OAAO,CAAgB;IAGvB,iBAAiB,CAA4B;IAG7C,oBAAoB,CAAwB;IAG5C,uBAAuB,CAA2B;IAGlD,uBAAuB,CAA2B;IAGlD,+BAA+B,CAAmC;IAE1E,iBAAiB;IACT,KAAK,CAAU;IAEf,GAAG,GAAG,KAAK,CAAC;IAEZ,WAAW,GAAY,EAAE,CAAC;IAElC;;;OAGG;IAEI,MAAM;QACX,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC;IAC/D,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,KAAK;QAChB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACvE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;QAEhE,6BAA6B;QAC7B,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;QACnE,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC5B,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACnC,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAE9B,wBAAwB;QACxB,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC;QAE9D,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QAE5B,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACI,IAAI,CAAC,IAAY;QACtB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,IAAW,aAAa;QACtB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,qBAAqB;QACjC,MAAM,IAAI,CAAC,yBAAyB,EAAE,CAAC;QAEvC,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC1C,MAAM,MAAM,GAAG,mBAAmB,CAAQ,kBAAkB,CAAC,QAAQ,EAAE,UAAU,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;YAErG,MAAM,SAAS,GAAW,mBAAmB,CAAS,kBAAkB,CAAC,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;YAEhH,MAAM,IAAI,CAAC,qBAAqB,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;YAE5D,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,SAAS,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;gBAEzD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC;gBAC9D,MAAM,iBAAiB,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBAExE,MAAM,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;oBAChC,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,WAAW;oBACxB,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;oBAC1C,WAAW,EAAE,MAAM,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,WAAW,CAAC;oBACpE,SAAS,EAAE,iBAAiB;oBAC5B,cAAc,EAAE,gBAAgB,CAAS,kBAAkB,CAAC,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC;oBAC5F,kBAAkB,EAAE,SAAS;iBAC9B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,yBAAyB;QACrC,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,UAAU,CAAQ,aAAa,CAAC,UAAU,CAAC,CAAC;QAEpG,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACzB,0CAA0C;YAC1C,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;gBAChE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;YAChD,CAAC;YAED,IAAI,CAAC,WAAW,GAAG,WAAsB,CAAC;QAC5C,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,wBAAwB,CAAC,gBAAkC;QACvE,OAAO,MAAM,IAAI,CAAC,+BAA+B,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,qBAAqB,CACjC,EAAE,UAAU,EAAE,SAAS,EAA2B,EAClD,SAAS,GAAG,KAAK;QAEjB,MAAM,cAAc,GAClB,gBAAgB,CAAoB,kBAAkB,CAAC,cAAc,EAAE,UAAU,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAEvG,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC;QAElE,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,8DAA8D;QAC9D,8CAA8C;QAC9C,MAAM,YAAY,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QAE9D,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC9F,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,gBAAgB,CAAC,SAA8B;QAC3D,OAAO,MAAM,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/D,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,sBAAsB,CAAC,gBAA2B;QAC9D,MAAM,gBAAgB,GAAG,gBAAgB,EAAE,WAAW,IAAI,EAAE,CAAC;QAE7D,OAAO,IAAI,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;IACnD,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,kBAAkB,CAAC,WAA8B;QAC7D,OAAO,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACrD,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,gBAAgB;QAC5B,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAAC,OAAO,EAAE,CAAC;QAEhE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QAED,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,gBAAgB,CAAS,kBAAkB,CAAC,OAAO,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;YACzF,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,EAAE,UAAU,EAAE,SAA6B,EAAE,EAAE,IAAI,CAAC,CAAC;YAE1G,MAAM,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC;gBACzC,IAAI,EAAE,IAAI;gBACV,WAAW,EAAE,WAAW;gBACxB,gBAAgB,EAAE,SAAS;gBAC3B,cAAc,EAAE,gBAAgB,CAAS,kBAAkB,CAAC,OAAO,EAAE,SAAS,CAAC,WAAW,CAAC;aAC5F,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,wBAAwB,CAAC,KAA4B;QAC3D,gDAAgD;QAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,YAAY,IAAI,KAAK,EAAE,CAAC;YACvD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,yDAAyD;QACzD,OAAO;YACL,UAAU,EAAE,KAAwB;YACpC,MAAM,EAAE,SAAS,EAAE,wCAAwC;SAC5D,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,cAAc;QAC1B,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,CAAC;QAEjE,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QAED,IAAI,OAAO,cAAc,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;YACtD,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,cAAc,CAAC,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;QACrF,CAAC;QAED,IAAI,OAAO,cAAc,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YACjD,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;QAC3E,CAAC;QAED,+CAA+C;QAC/C,IAAI,OAAO,cAAc,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;YAC3D,MAAM,iBAAiB,GAAG,MAAM,cAAc,CAAC,iBAAiB,EAAE,CAAC;YAEnE,KAAK,MAAM,KAAK,IAAI,iBAAiB,EAAE,CAAC;gBACtC,oEAAoE;gBACpE,MAAM,MAAM,GAAG,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC;gBAEpD,+BAA+B;gBAC/B,MAAM,mBAAmB,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;gBAE/E,4CAA4C;gBAC5C,KAAK,MAAM,UAAU,IAAI,mBAAmB,EAAE,CAAC;oBAC7C,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;gBACrD,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,IAAI,GAAG,mBAAmB,CAAS,kBAAkB,CAAC,OAAO,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC;QAEjG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtD,CAAC;CAEF,CAAA;AAhSS;IADP,MAAM,CAAC,iBAAiB,CAAC,cAAc,CAAC;;mDACF;AAG/B;IADP,MAAM,CAAC,iBAAiB,CAAC,aAAa,CAAC;;6CACnB;AAGb;IADP,MAAM,CAAC,iBAAiB,CAAC,aAAa,CAAC;;4CACT;AAGvB;IADP,MAAM,CAAC,iBAAiB,CAAC,0BAA0B,CAAC;;sDACA;AAG7C;IADP,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,CAAC;;yDACG;AAG5C;IADP,MAAM,CAAC,iBAAiB,CAAC,yBAAyB,CAAC;;4DACM;AAGlD;IADP,MAAM,CAAC,iBAAiB,CAAC,yBAAyB,CAAC;;4DACM;AAGlD;IADP,MAAM,CAAC,iBAAiB,CAAC,mCAAmC,CAAC;;oEACY;AAcnE;IADN,aAAa,EAAE;;;;yCAGf;AA1CU,WAAW;IADvB,WAAW,CAAC,iBAAiB,CAAC,YAAY,CAAC;GAC/B,WAAW,CAqSvB"}

package/dist/lib/server/AsenaServerFactory.d.ts

@@ -0,0 +1,26 @@
+import type { AsenaServer } from './AsenaServer';
+import type { AsenaAdapter } from '../adapter';
+import type { ServerLogger } from '../logger';
+import type { Class } from './types';
+/**
+ * @description Configuration options for AsenaServer creation
+ */
+export interface AsenaServerOptions<A extends AsenaAdapter<any, any>> {
+    adapter: A;
+    logger: ServerLogger;
+    port?: number;
+    components?: Class[];
+    gc?: boolean;
+}
+/**
+ * @description Factory for creating AsenaServer instances
+ * Handles IoC bootstrap and dependency injection
+ */
+export declare class AsenaServerFactory {
+    /**
+     * @description Create and configure AsenaServer instance
+     * @param {AsenaServerOptions<A>} options - Server configuration options
+     * @returns {Promise<AsenaServer<A>>} Fully configured AsenaServer instance
+     */
+    static create<A extends AsenaAdapter<any, any>>(options: AsenaServerOptions<A>): Promise<AsenaServer<A>>;
+}

package/dist/lib/server/AsenaServerFactory.js

@@ -0,0 +1,66 @@
+import { CoreBootstrapPhase, CoreContainer, ICoreServiceNames } from '../ioc';
+import { readConfigFile } from '../ioc/helper/fileHelper';
+import { ComponentConstants } from '../ioc/constants';
+import { getTypedMetadata } from '../utils/typedMetadata';
+/**
+ * @description Factory for creating AsenaServer instances
+ * Handles IoC bootstrap and dependency injection
+ */
+export class AsenaServerFactory {
+    /**
+     * @description Create and configure AsenaServer instance
+     * @param {AsenaServerOptions<A>} options - Server configuration options
+     * @returns {Promise<AsenaServer<A>>} Fully configured AsenaServer instance
+     */
+    static async create(options) {
+        const { adapter, logger, port, components, gc } = options;
+        logger.info(`
+    ___    _____  ______ _   __ ___ 
+   /   |  / ___/ / ____// | / //   |
+  / /| |  \\__ \\ / __/  /  |/ // /| |
+ / ___ | ___/ // /___ / /|  // ___ |
+/_/  |_|/____//_____//_/ |_//_/  |_|  
+------------------------------------------------------------
+    `);
+        // Read config file
+        const config = await readConfigFile();
+        if (!config) {
+            logger.warn('asena-config file not found');
+        }
+        // Create CoreContainer
+        const coreContainer = new CoreContainer();
+        // Phase 1-5: Bootstrap core services
+        await coreContainer.bootstrap(adapter, logger);
+        // Register CoreContainer itself for AsenaServer injection
+        await coreContainer.container.registerInstance(ICoreServiceNames.CORE_CONTAINER, coreContainer);
+        // Phase 6: Register user components
+        const iocEngine = await coreContainer.resolve(ICoreServiceNames.IOC_ENGINE);
+        iocEngine.setConfig(config);
+        if (components?.length) {
+            const injectableComponents = components.map((comp) => {
+                const face = getTypedMetadata(ComponentConstants.InterfaceKey, comp);
+                return {
+                    Class: comp,
+                    interface: face,
+                };
+            });
+            await iocEngine.searchAndRegister(injectableComponents);
+        }
+        else if (config) {
+            await iocEngine.searchAndRegister();
+        }
+        coreContainer.setPhase(CoreBootstrapPhase.USER_COMPONENTS_INIT);
+        // Register AsenaServer as core service
+        const { AsenaServer } = await import('./AsenaServer');
+        await coreContainer.container.register(ICoreServiceNames.ASENA_SERVER, AsenaServer, true);
+        // Resolve AsenaServer (with all dependencies injected)
+        const server = await coreContainer.resolve(ICoreServiceNames.ASENA_SERVER);
+        // Configure server
+        if (port)
+            server.port(port);
+        if (gc !== undefined)
+            server._gc = gc;
+        return server;
+    }
+}
+//# sourceMappingURL=AsenaServerFactory.js.map

package/dist/lib/server/AsenaServerFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AsenaServerFactory.js","sourceRoot":"","sources":["../../../lib/server/AsenaServerFactory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAK9E,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAa1D;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAE7B;;;;OAIG;IACI,MAAM,CAAC,KAAK,CAAC,MAAM,CACxB,OAA8B;QAE9B,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC;QAE1D,MAAM,CAAC,IAAI,CAAC;;;;;;;KAOX,CAAC,CAAC;QAEH,mBAAmB;QACnB,MAAM,MAAM,GAAG,MAAM,cAAc,EAAE,CAAC;QAEtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC7C,CAAC;QAED,uBAAuB;QACvB,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;QAE1C,qCAAqC;QACrC,MAAM,aAAa,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAE/C,0DAA0D;QAC1D,MAAM,aAAa,CAAC,SAAS,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;QAEhG,oCAAoC;QACpC,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,OAAO,CAAY,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAEvF,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAE5B,IAAI,UAAU,EAAE,MAAM,EAAE,CAAC;YACvB,MAAM,oBAAoB,GAA0B,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBAC1E,MAAM,IAAI,GAAW,gBAAgB,CAAS,kBAAkB,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;gBAErF,OAAO;oBACL,KAAK,EAAE,IAAI;oBACX,SAAS,EAAE,IAAI;iBAChB,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,MAAM,SAAS,CAAC,iBAAiB,CAAC,oBAAoB,CAAC,CAAC;QAC1D,CAAC;aAAM,IAAI,MAAM,EAAE,CAAC;YAClB,MAAM,SAAS,CAAC,iBAAiB,EAAE,CAAC;QACtC,CAAC;QAED,aAAa,CAAC,QAAQ,CAAC,kBAAkB,CAAC,oBAAoB,CAAC,CAAC;QAEhE,uCAAuC;QACvC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QAEtD,MAAM,aAAa,CAAC,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,YAAY,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;QAE1F,uDAAuD;QACvD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,CAAiB,iBAAiB,CAAC,YAAY,CAAC,CAAC;QAE3F,mBAAmB;QACnB,IAAI,IAAI;YAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE5B,IAAI,EAAE,KAAK,SAAS;YAAG,MAAc,CAAC,GAAG,GAAG,EAAE,CAAC;QAE/C,OAAO,MAAM,CAAC;IAChB,CAAC;CAEF"}

package/dist/lib/server/config/AsenaConfig.d.ts

@@ -1,5 +1,49 @@
 import type { AsenaContext, AsenaServeOptions } from '../../adapter';
-import type { MiddlewareClass } from "../web/middleware";
+import type { MiddlewareClass } from '../web/middleware';
+/**
+ * Route configuration for global middleware
+ */
+export interface GlobalMiddlewareRouteConfig {
+    /**
+     * Paths to include. Supports glob patterns.
+     * Default: ['*'] (all routes)
+     *
+     * @example
+     * include: ['/api/*', '/admin/*']
+     * include: ['/users/:id', '/posts/:id']
+     */
+    include?: string[];
+    /**
+     * Paths to exclude. Supports glob patterns.
+     * Exclusions take precedence over inclusions.
+     * Default: []
+     *
+     * @example
+     * exclude: ['/health', '/metrics']
+     * exclude: ['/api/public/*']
+     */
+    exclude?: string[];
+}
+/**
+ * Global middleware configuration
+ */
+export interface GlobalMiddlewareConfig {
+    /**
+     * Middleware class to apply
+     */
+    middleware: MiddlewareClass;
+    /**
+     * Route configuration for this middleware
+     * If not specified, middleware applies to all routes
+     */
+    routes?: GlobalMiddlewareRouteConfig;
+}
+/**
+ * Union type for backward compatibility
+ * - MiddlewareClass: Apply to all routes (old behavior)
+ * - GlobalMiddlewareConfig: Apply with pattern matching (new behavior)
+ */
+export type GlobalMiddlewareEntry = MiddlewareClass | GlobalMiddlewareConfig;
 /**
  * Configuration interface for Asena framework
  * @template C - Extends AsenaContext type with generic parameters
@@ -18,26 +62,55 @@ export interface AsenaConfig<C extends AsenaContext<any, any> = AsenaContext<any
      */
     serveOptions?(): AsenaServeOptions;
     /**
-     * Global middleware configuration for applying middleware across all routes.
-     * Similar to Hono's global middleware usage:
+     * Global middleware configuration for applying middleware across routes.
+     *
+     * Supports two formats:
+     * 1. Simple: MiddlewareClass (applies to all routes)
+     * 2. Advanced: GlobalMiddlewareConfig (pattern-based filtering)
+     *
      * @example
-     * // Hono usage:
-     * const app = new Hono()
-     * app.use(middleware1)
-     * app.use(middleware2)
-     *
-     * // Equivalent in Asena:
-     * class Config implements AsenaConfig {
-     *   globalMiddlewares() {
-     *     return [
-     *       MiddlewareService1,
-     *       MiddlewareService2
-     *     ]
-     *   }
+     * ```typescript
+     * // Simple format (backward compatible)
+     * globalMiddlewares() {
+     *   return [LoggerMiddleware, CorsMiddleware];
+     * }
+     *
+     * // Advanced format with pattern matching
+     * globalMiddlewares() {
+     *   return [
+     *     // Apply to all routes
+     *     LoggerMiddleware,
+     *
+     *     // Apply only to /api/* and /admin/*
+     *     {
+     *       middleware: AuthMiddleware,
+     *       routes: {
+     *         include: ['/api/*', '/admin/*']
+     *       }
+     *     },
+     *
+     *     // Apply to all routes except /health
+     *     {
+     *       middleware: RateLimitMiddleware,
+     *       routes: {
+     *         exclude: ['/health', '/metrics']
+     *       }
+     *     },
+     *
+     *     // Advanced: include + exclude
+     *     {
+     *       middleware: AuditMiddleware,
+     *       routes: {
+     *         include: ['/api/*'],
+     *         exclude: ['/api/health']
+     *       }
+     *     }
+     *   ];
      * }
+     * ```
      *
-     * @returns Array of middleware services to be applied globally
+     * @returns Array of middleware configurations
      */
-    globalMiddlewares?(): Promise<MiddlewareClass[]> | MiddlewareClass[];
+    globalMiddlewares?(): Promise<GlobalMiddlewareEntry[]> | GlobalMiddlewareEntry[];
 }
 export type AsenaConfigFunctions = 'onError' | 'serveOptions' | 'globalMiddlewares';

package/dist/lib/server/decorators/Override.js

@@ -1,4 +1,4 @@
-import { ComponentConstants } from '../../ioc/constants';
+import { ComponentConstants } from '../../ioc';
 import { defineTypedMetadata, getOwnTypedMetadata } from '../../utils/typedMetadata';
 /**
  * Decorator for marking a property as an override.

package/dist/lib/server/decorators/Override.js.map

@@ -1 +1 @@
-{"version":3,"file":"Override.js","sourceRoot":"","sources":["../../../../lib/server/decorators/Override.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAsB,EAAE;IAC9C,OAAO,CAAC,MAAc,EAAE,WAAmB,EAAE,EAAE;QAC7C,MAAM,SAAS,GAAa,mBAAmB,CAAW,kBAAkB,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QAExG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YACrC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC9B,CAAC;QAED,mBAAmB,CAAW,kBAAkB,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IACnF,CAAC,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"Override.js","sourceRoot":"","sources":["../../../../lib/server/decorators/Override.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAsB,EAAE;IAC9C,OAAO,CAAC,MAAc,EAAE,WAAmB,EAAE,EAAE;QAC7C,MAAM,SAAS,GAAa,mBAAmB,CAAW,kBAAkB,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QAExG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YACrC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC9B,CAAC;QAED,mBAAmB,CAAW,kBAAkB,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IACnF,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/dist/lib/server/decorators/components/Config.d.ts

@@ -1,4 +1,4 @@
-import { type ComponentParams } from '../../../ioc/types';
+import { type ComponentParams } from '../../../ioc';
 /**
  * Decorator that marks a class as a configuration component.
  * Used to define configuration classes that can be injected into other components.

package/dist/lib/server/decorators/components/Config.js

@@ -1,4 +1,4 @@
-import { ComponentType } from '../../../ioc/types';
+import { ComponentType } from '../../../ioc';
 import { defineComponent } from '../../../ioc/component';
 /**
  * Decorator that marks a class as a configuration component.

package/dist/lib/server/decorators/components/Config.js.map

@@ -1 +1 @@
-{"version":3,"file":"Config.js","sourceRoot":"","sources":["../../../../../lib/server/decorators/components/Config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAAiC,EAAkB,EAAE;IAC1E,OAAO,eAAe,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACvD,CAAC,CAAC"}
+{"version":3,"file":"Config.js","sourceRoot":"","sources":["../../../../../lib/server/decorators/components/Config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,aAAa,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAAiC,EAAkB,EAAE;IAC1E,OAAO,eAAe,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACvD,CAAC,CAAC"}

package/dist/lib/server/decorators/components/Controller.d.ts

@@ -1,4 +1,4 @@
-import { type ControllerParams } from '../../../ioc/types';
+import { type ControllerParams } from '../../../ioc';
 /**
  * Decorator for defining a Controller component. String is used for defining the path.
  *

package/dist/lib/server/decorators/components/Controller.js

@@ -1,6 +1,5 @@
-import { ComponentType } from '../../../ioc/types';
+import { ComponentConstants, ComponentType } from '../../../ioc';
 import { defineComponent } from '../../../ioc/component';
-import { ComponentConstants } from '../../../ioc/constants';
 import { defineMiddleware } from '../../web/helper';
 import { defineTypedMetadata } from '../../../utils/typedMetadata';
 /**