@asenajs/asena 0.3.3 → 0.4.0

package/dist/lib/ioc/constants/ComponentConstants.js.map

@@ -1 +1 @@
-{"version":3,"file":"ComponentConstants.js","sourceRoot":"","sources":["../../../../lib/ioc/constants/ComponentConstants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,kBAiBX;AAjBD,WAAY,kBAAkB;IAC5B,4CAAsB,CAAA;IACtB,sDAAgC,CAAA;IAChC,8DAAwC,CAAA;IACxC,0DAAoC,CAAA;IACpC,0CAAoB,CAAA;IACpB,wCAAkB,CAAA;IAClB,gDAA0B,CAAA;IAC1B,iDAA2B,CAAA;IAC3B,wCAAkB,CAAA;IAClB,sDAAgC,CAAA;IAChC,wCAAkB,CAAA;IAClB,kDAA4B,CAAA;IAC5B,gDAA0B,CAAA;IAC1B,oDAA8B,CAAA;IAC9B,kDAA4B,CAAA;IAC5B,8DAAwC,CAAA;AAC1C,CAAC,EAjBW,kBAAkB,KAAlB,kBAAkB,QAiB7B"}
+{"version":3,"file":"ComponentConstants.js","sourceRoot":"","sources":["../../../../lib/ioc/constants/ComponentConstants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAE7B,wDAAwD;IACjD,MAAM,CAAU,OAAO,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAEnD,MAAM,CAAU,OAAO,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAEnD,MAAM,CAAU,QAAQ,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAErD,MAAM,CAAU,OAAO,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAEnD,MAAM,CAAU,YAAY,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAE7D,MAAM,CAAU,aAAa,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;IAE/D,MAAM,CAAU,iBAAiB,GAAG,MAAM,CAAC,0BAA0B,CAAC,CAAC;IAEvE,MAAM,CAAU,WAAW,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAE3D,MAAM,CAAU,aAAa,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;IAE/D,MAAM,CAAU,gBAAgB,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC;IAErE,MAAM,CAAU,WAAW,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAE3D,MAAM,CAAU,YAAY,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAE7D,MAAM,CAAU,OAAO,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAE1D,sBAAsB;IACf,MAAM,CAAU,mBAAmB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAElE,MAAM,CAAU,QAAQ,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAE7D,sBAAsB;IACf,MAAM,CAAU,cAAc,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC;IAElE,MAAM,CAAU,YAAY,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;IAErE,iBAAiB;IACV,MAAM,CAAU,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;IAEnD,MAAM,CAAU,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;IAEpD,MAAM,CAAU,mBAAmB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAElE,MAAM,CAAU,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAErE,qBAAqB;IACd,MAAM,CAAU,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAE5D,MAAM,CAAU,uBAAuB,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAC;IAEjF,wBAAwB;IACjB,MAAM,CAAU,kBAAkB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC"}

package/dist/lib/ioc/decorators/CoreService.d.ts

@@ -0,0 +1,8 @@
+export declare const CORE_SERVICE: unique symbol;
+/**
+ * @description Decorator for marking core framework services
+ * Core services are always singletons and managed by CoreContainer
+ * @param {string} name - Optional service name (defaults to class name)
+ * @returns {Function} Class decorator
+ */
+export declare function CoreService(name?: string): (target: any) => void;

package/dist/lib/ioc/decorators/CoreService.js

@@ -0,0 +1,27 @@
+import { defineTypedMetadata, getOwnTypedMetadata } from '../../utils/typedMetadata';
+import { ComponentConstants } from '../constants';
+import { Scope } from '../component';
+export const CORE_SERVICE = Symbol('CORE_SERVICE');
+/**
+ * @description Decorator for marking core framework services
+ * Core services are always singletons and managed by CoreContainer
+ * @param {string} name - Optional service name (defaults to class name)
+ * @returns {Function} Class decorator
+ */
+export function CoreService(name) {
+    return function (target) {
+        defineTypedMetadata(CORE_SERVICE, true, target);
+        const serviceName = name || target.name;
+        defineTypedMetadata(ComponentConstants.NameKey, serviceName, target);
+        defineTypedMetadata(ComponentConstants.ScopeKey, Scope.SINGLETON, target);
+        // Initialize dependency metadata for injection to work
+        if (getOwnTypedMetadata(ComponentConstants.DependencyKey, target) === undefined) {
+            defineTypedMetadata(ComponentConstants.DependencyKey, {}, target);
+        }
+        // Initialize strategy metadata for injection to work
+        if (getOwnTypedMetadata(ComponentConstants.StrategyKey, target) === undefined) {
+            defineTypedMetadata(ComponentConstants.StrategyKey, {}, target);
+        }
+    };
+}
+//# sourceMappingURL=CoreService.js.map

package/dist/lib/ioc/decorators/CoreService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreService.js","sourceRoot":"","sources":["../../../../lib/ioc/decorators/CoreService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAGrC,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,IAAa;IACvC,OAAO,UAAU,MAAW;QAC1B,mBAAmB,CAAC,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,WAAW,GAAG,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC;QAExC,mBAAmB,CAAC,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;QACrE,mBAAmB,CAAC,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAE1E,uDAAuD;QACvD,IAAI,mBAAmB,CAAe,kBAAkB,CAAC,aAAa,EAAE,MAAM,CAAC,KAAK,SAAS,EAAE,CAAC;YAC9F,mBAAmB,CAAe,kBAAkB,CAAC,aAAa,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;QAClF,CAAC;QAED,qDAAqD;QACrD,IAAI,mBAAmB,CAAa,kBAAkB,CAAC,WAAW,EAAE,MAAM,CAAC,KAAK,SAAS,EAAE,CAAC;YAC1F,mBAAmB,CAAa,kBAAkB,CAAC,WAAW,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/lib/ioc/decorators/index.d.ts

@@ -0,0 +1 @@
+export * from './CoreService';

package/dist/lib/ioc/decorators/index.js

@@ -0,0 +1,2 @@
+export * from './CoreService';
+//# sourceMappingURL=index.js.map

package/dist/lib/ioc/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/ioc/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/lib/ioc/index.d.ts

@@ -1,2 +1,7 @@
 export * from './IocEngine';
 export * from './Container';
+export * from './CoreContainer';
+export * from './CircularDependencyDetector';
+export * from './decorators';
+export * from './types';
+export * from './constants';

package/dist/lib/ioc/index.js

@@ -1,3 +1,8 @@
 export * from './IocEngine';
 export * from './Container';
+export * from './CoreContainer';
+export * from './CircularDependencyDetector';
+export * from './decorators';
+export * from './types';
+export * from './constants';
 //# sourceMappingURL=index.js.map

package/dist/lib/ioc/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/ioc/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/ioc/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}

package/dist/lib/ioc/types/CoreBootstrapPhase.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @description Enum representing the bootstrap phases of the CoreContainer
+ * These phases define the order in which core services are initialized
+ */
+export declare enum CoreBootstrapPhase {
+    CONTAINER_INIT = "CONTAINER_INIT",
+    LOGGER_INIT = "LOGGER_INIT",
+    IOC_ENGINE_INIT = "IOC_ENGINE_INIT",
+    HTTP_ADAPTER_INIT = "HTTP_ADAPTER_INIT",
+    PREPARE_SERVICES_INIT = "PREPARE_SERVICES_INIT",
+    USER_COMPONENTS_SCAN = "USER_COMPONENTS_SCAN",
+    USER_COMPONENTS_INIT = "USER_COMPONENTS_INIT",
+    APPLICATION_SETUP = "APPLICATION_SETUP",
+    SERVER_READY = "SERVER_READY"
+}

package/dist/lib/ioc/types/CoreBootstrapPhase.js

@@ -0,0 +1,17 @@
+/**
+ * @description Enum representing the bootstrap phases of the CoreContainer
+ * These phases define the order in which core services are initialized
+ */
+export var CoreBootstrapPhase;
+(function (CoreBootstrapPhase) {
+    CoreBootstrapPhase["CONTAINER_INIT"] = "CONTAINER_INIT";
+    CoreBootstrapPhase["LOGGER_INIT"] = "LOGGER_INIT";
+    CoreBootstrapPhase["IOC_ENGINE_INIT"] = "IOC_ENGINE_INIT";
+    CoreBootstrapPhase["HTTP_ADAPTER_INIT"] = "HTTP_ADAPTER_INIT";
+    CoreBootstrapPhase["PREPARE_SERVICES_INIT"] = "PREPARE_SERVICES_INIT";
+    CoreBootstrapPhase["USER_COMPONENTS_SCAN"] = "USER_COMPONENTS_SCAN";
+    CoreBootstrapPhase["USER_COMPONENTS_INIT"] = "USER_COMPONENTS_INIT";
+    CoreBootstrapPhase["APPLICATION_SETUP"] = "APPLICATION_SETUP";
+    CoreBootstrapPhase["SERVER_READY"] = "SERVER_READY";
+})(CoreBootstrapPhase || (CoreBootstrapPhase = {}));
+//# sourceMappingURL=CoreBootstrapPhase.js.map

package/dist/lib/ioc/types/CoreBootstrapPhase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreBootstrapPhase.js","sourceRoot":"","sources":["../../../../lib/ioc/types/CoreBootstrapPhase.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAN,IAAY,kBAUX;AAVD,WAAY,kBAAkB;IAC5B,uDAAiC,CAAA;IACjC,iDAA2B,CAAA;IAC3B,yDAAmC,CAAA;IACnC,6DAAuC,CAAA;IACvC,qEAA+C,CAAA;IAC/C,mEAA6C,CAAA;IAC7C,mEAA6C,CAAA;IAC7C,6DAAuC,CAAA;IACvC,mDAA6B,CAAA;AAC/B,CAAC,EAVW,kBAAkB,KAAlB,kBAAkB,QAU7B"}

package/dist/lib/ioc/types/ICoreService.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @description Interface for core framework services
+ * Provides lifecycle hooks for initialization and cleanup
+ */
+export interface ICoreService {
+    readonly serviceName: string;
+    onInit?(): Promise<void> | void;
+    onDestroy?(): Promise<void> | void;
+}

package/dist/lib/ioc/types/ICoreService.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ICoreService.js.map

package/dist/lib/ioc/types/ICoreService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICoreService.js","sourceRoot":"","sources":["../../../../lib/ioc/types/ICoreService.ts"],"names":[],"mappings":""}

package/dist/lib/ioc/types/ICoreServiceNamesType.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @description Object containing all core service names
+ * Used for type-safe service resolution and plugin system access
+ * All core services are managed by CoreContainer and AsenaServerFactory
+ */
+export declare enum ICoreServiceNames {
+    CONTAINER = "Container",
+    SERVER_LOGGER = "ServerLogger",
+    IOC_ENGINE = "IocEngine",
+    ASENA_ADAPTER = "AsenaAdapter",
+    PREPARE_MIDDLEWARE_SERVICE = "PrepareMiddlewareService",
+    PREPARE_CONFIG_SERVICE = "PrepareConfigService",
+    PREPARE_WEBSOCKET_SERVICE = "PrepareWebsocketService",
+    PREPARE_VALIDATOR_SERVICE = "PrepareValidatorService",
+    PREPARE_STATIC_SERVE_CONFIG_SERVICE = "PrepareStaticServeConfigService",
+    CORE_CONTAINER = "CoreContainer",
+    ASENA_SERVER = "AsenaServer"
+}

package/dist/lib/ioc/types/ICoreServiceNamesType.js

@@ -0,0 +1,23 @@
+/**
+ * @description Object containing all core service names
+ * Used for type-safe service resolution and plugin system access
+ * All core services are managed by CoreContainer and AsenaServerFactory
+ */
+export var ICoreServiceNames;
+(function (ICoreServiceNames) {
+    // Core Infrastructure Services (Phase 1-4)
+    ICoreServiceNames["CONTAINER"] = "Container";
+    ICoreServiceNames["SERVER_LOGGER"] = "ServerLogger";
+    ICoreServiceNames["IOC_ENGINE"] = "IocEngine";
+    ICoreServiceNames["ASENA_ADAPTER"] = "AsenaAdapter";
+    // Prepare Services (Phase 5)
+    ICoreServiceNames["PREPARE_MIDDLEWARE_SERVICE"] = "PrepareMiddlewareService";
+    ICoreServiceNames["PREPARE_CONFIG_SERVICE"] = "PrepareConfigService";
+    ICoreServiceNames["PREPARE_WEBSOCKET_SERVICE"] = "PrepareWebsocketService";
+    ICoreServiceNames["PREPARE_VALIDATOR_SERVICE"] = "PrepareValidatorService";
+    ICoreServiceNames["PREPARE_STATIC_SERVE_CONFIG_SERVICE"] = "PrepareStaticServeConfigService";
+    // Factory Services (Phase 6+)
+    ICoreServiceNames["CORE_CONTAINER"] = "CoreContainer";
+    ICoreServiceNames["ASENA_SERVER"] = "AsenaServer";
+})(ICoreServiceNames || (ICoreServiceNames = {}));
+//# sourceMappingURL=ICoreServiceNamesType.js.map

package/dist/lib/ioc/types/ICoreServiceNamesType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICoreServiceNamesType.js","sourceRoot":"","sources":["../../../../lib/ioc/types/ICoreServiceNamesType.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAN,IAAY,iBAiBX;AAjBD,WAAY,iBAAiB;IAC3B,2CAA2C;IAC3C,4CAAuB,CAAA;IACvB,mDAA8B,CAAA;IAC9B,6CAAwB,CAAA;IACxB,mDAA8B,CAAA;IAE9B,6BAA6B;IAC7B,4EAAuD,CAAA;IACvD,oEAA+C,CAAA;IAC/C,0EAAqD,CAAA;IACrD,0EAAqD,CAAA;IACrD,4FAAuE,CAAA;IAEvE,8BAA8B;IAC9B,qDAAgC,CAAA;IAChC,iDAA4B,CAAA;AAC9B,CAAC,EAjBW,iBAAiB,KAAjB,iBAAiB,QAiB5B"}

package/dist/lib/ioc/types/decorators/ControllerParams.d.ts

@@ -1,6 +1,6 @@
 import type { ComponentParams } from './ComponentParams';
 import type { AsenaContext } from '../../../adapter';
-import type { MiddlewareClass } from "../../../server/web/middleware";
+import type { MiddlewareClass } from '../../../server/web/middleware';
 export interface ControllerParams<C extends AsenaContext<any, any> = AsenaContext<any, any>> extends ComponentParams {
     path: string;
     middlewares?: MiddlewareClass<C>[];

package/dist/lib/ioc/types/index.d.ts

@@ -6,3 +6,6 @@ export * from './decorators/ScheduleParams';
 export * from './IocConfig';
 export * from './InjectableComponent';
 export * from './ContainerService';
+export * from './ICoreService';
+export * from './CoreBootstrapPhase';
+export { ICoreServiceNames } from './ICoreServiceNamesType';

package/dist/lib/ioc/types/index.js

@@ -6,4 +6,7 @@ export * from './decorators/ScheduleParams';
 export * from './IocConfig';
 export * from './InjectableComponent';
 export * from './ContainerService';
+export * from './ICoreService';
+export * from './CoreBootstrapPhase';
+export { ICoreServiceNames } from './ICoreServiceNamesType';
 //# sourceMappingURL=index.js.map

package/dist/lib/ioc/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/ioc/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/ioc/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}

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

@@ -1,32 +1,103 @@
-import type { Class } from './types';
-import type { Container } from '../ioc';
+import { type CoreContainer, type ICoreService } from '../ioc';
 import type { AsenaAdapter } from '../adapter';
-import { type ServerLogger } from '../logger';
-export declare class AsenaServer<A extends AsenaAdapter<any, any>> {
-    private _port;
-    private controllers;
-    private _components;
-    private _ioc;
+/**
+ * @description AsenaServer - Main server class for Asena framework
+ * Now a core service managed by IoC container with field injection
+ */
+export declare class AsenaServer<A extends AsenaAdapter<any, any>> implements ICoreService {
+    serviceName: string;
+    private _coreContainer;
+    private _adapter;
     private _logger;
-    private readonly _adapter;
     private prepareMiddleware;
     private prepareConfigService;
     private prepareWebsocketService;
     private prepareValidatorService;
     private prepareStaticServeConfigService;
-    constructor(adapter: A, logger: ServerLogger);
-    initialize(): Promise<Container>;
-    start(gc?: boolean): Promise<void>;
-    components(components: Class[]): this;
+    private _port;
+    private _gc;
+    private controllers;
+    /**
+     * @description Lifecycle hook - called after dependencies are injected
+     * @returns {void}
+     */
+    onInit(): void;
+    /**
+     * @description Start the server
+     * Main entry point after factory creation
+     * @returns {Promise<void>}
+     */
+    start(): Promise<void>;
+    /**
+     * @description Configure server port
+     * Builder pattern for API compatibility
+     * @param {number} port - Port number
+     * @returns {this}
+     */
     port(port: number): this;
-    logger(value: ServerLogger): this;
+    /**
+     * @description Get current CoreContainer instance
+     * @returns {CoreContainer}
+     */
+    get coreContainer(): CoreContainer;
+    /**
+     * @description Initialize and register all controllers
+     * @returns {Promise<void>}
+     */
     private initializeControllers;
+    /**
+     * @description Validate and set controllers from container
+     * @returns {Promise<void>}
+     */
     private validateAndSetControllers;
+    /**
+     * @description Prepare static serve configuration
+     * @param {StaticServeClass} staticServeClass - Static serve class
+     * @returns {Promise<BaseStaticServeParams>}
+     */
     private prepareStaticServeConfig;
+    /**
+     * @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[]>}
+     */
     private prepareTopMiddlewares;
+    /**
+     * @description Prepare validator instance
+     * @param {ValidatorClass<any>} Validator - Validator class
+     * @returns {Promise<BaseValidator>}
+     */
     private prepareValidator;
+    /**
+     * @description Prepare route-level middlewares
+     * @param {ApiParams} middlewareParams - Middleware parameters
+     * @returns {Promise<BaseMiddleware[]>}
+     */
     private prepareRouteMiddleware;
+    /**
+     * @description Prepare middlewares from classes
+     * @param {MiddlewareClass[]} middlewares - Middleware classes
+     * @returns {Promise<BaseMiddleware[]>}
+     */
     private prepareMiddlewares;
+    /**
+     * @description Prepare and register WebSocket routes
+     * @returns {Promise<void>}
+     */
     private prepareWebSocket;
+    /**
+     * @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
+     */
+    private normalizeMiddlewareEntry;
+    /**
+     * @description Prepare and apply configuration
+     * Updated to support pattern-based global middlewares
+     * @returns {Promise<void>}
+     */
     private prepareConfigs;
 }