@navios/commander 0.7.0 → 0.8.0

package/lib/index.cjs

@@ -32,27 +32,21 @@ var __copyProps = (to, from, except, desc) => {
 	}
 	return to;
 };
-var __reExport = (target, mod, secondTarget, symbols) => {
-	if (symbols) {
-		__defProp(target, Symbol.toStringTag, { value: "Module" });
-		secondTarget && __defProp(secondTarget, Symbol.toStringTag, { value: "Module" });
-	}
-	__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default");
-};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
 	value: mod,
 	enumerable: true
 }) : target, mod));
 
 //#endregion
-let __navios_di = require("@navios/di");
+let _navios_di = require("@navios/di");
 let node_process = require("node:process");
 let zod_v4 = require("zod/v4");
 zod_v4 = __toESM(zod_v4);
 let util = require("util");
 let node_async_hooks = require("node:async_hooks");
 
-//#region ../core/lib/use-guards.decorator-kZ3lNK8v.mjs
+//#region ../core/lib/use-guards.decorator-CUww54Nt.mjs
 const EndpointMetadataKey = Symbol("EndpointMetadataKey");
 function getAllEndpointMetadata(context) {
 	if (context.metadata) {
@@ -145,13 +139,13 @@ function hasModuleMetadata(target) {
 }
 /**
 * Decorator that marks a class as a Navios controller.
-* 
+*
 * Controllers handle HTTP requests and define endpoints.
 * They are request-scoped by default, meaning a new instance is created for each request.
-* 
+*
 * @param options - Controller configuration options
 * @returns A class decorator
-* 
+*
 * @example
 * ```typescript
 * @Controller({ guards: [AuthGuard] })
@@ -162,59 +156,31 @@ function hasModuleMetadata(target) {
 *   }
 * }
 * ```
-*/ function Controller({ guards } = {}) {
+*/ function Controller({ guards, registry } = {}) {
 	return function(target, context) {
 		if (context.kind !== "class") throw new Error("[Navios] @Controller decorator can only be used on classes.");
-		const token = __navios_di.InjectionToken.create(target);
+		const token = _navios_di.InjectionToken.create(target);
 		if (context.metadata) {
 			const controllerMetadata = getControllerMetadata(target, context);
 			if (guards) for (const guard of Array.from(guards).reverse()) controllerMetadata.guards.add(guard);
 		}
-		return (0, __navios_di.Injectable)({
+		return (0, _navios_di.Injectable)({
 			token,
-			scope: __navios_di.InjectableScope.Request
+			registry
 		})(target, context);
 	};
 }
-const EndpointAdapterToken = __navios_di.InjectionToken.create("EndpointAdapterToken");
+const EndpointAdapterToken = _navios_di.InjectionToken.create("EndpointAdapterToken");
 const ExecutionContextInjectionToken = "ExecutionContextInjectionToken";
-const ExecutionContext = __navios_di.InjectionToken.create(ExecutionContextInjectionToken);
-const HttpAdapterToken = __navios_di.InjectionToken.create("HttpAdapterToken");
-const MultipartAdapterToken = __navios_di.InjectionToken.create("MultipartAdapterToken");
-const Reply = __navios_di.InjectionToken.create("ReplyToken");
-const Request = __navios_di.InjectionToken.create("RequestToken");
-const StreamAdapterToken = __navios_di.InjectionToken.create("StreamAdapterToken");
-const XmlStreamAdapterToken = __navios_di.InjectionToken.create("XmlStreamAdapterToken");
-/**
-* Decorator that marks a method as an HTTP endpoint.
-*
-* The endpoint must be defined using @navios/builder's `declareEndpoint` method.
-* This ensures type safety and consistency between client and server.
-*
-* @param endpoint - The endpoint declaration from @navios/builder
-* @returns A method decorator
-*
-* @example
-* ```typescript
-* import { builder } from '@navios/builder'
-*
-* const api = builder()
-* const getUserEndpoint = api.declareEndpoint({
-*   method: 'get',
-*   url: '/users/$userId',
-*   responseSchema: z.object({ id: z.string(), name: z.string() }),
-* })
-*
-* @Controller()
-* export class UserController {
-*   @Endpoint(getUserEndpoint)
-*   async getUser(request: EndpointParams<typeof getUserEndpoint>) {
-*     const { userId } = request.urlParams
-*     return { id: userId, name: 'John' }
-*   }
-* }
-* ```
-*/ function Endpoint(endpoint) {
+const ExecutionContext = _navios_di.InjectionToken.create(ExecutionContextInjectionToken);
+const HttpAdapterToken = _navios_di.InjectionToken.create("HttpAdapterToken");
+const MultipartAdapterToken = _navios_di.InjectionToken.create("MultipartAdapterToken");
+const NaviosOptionsToken = _navios_di.InjectionToken.create("NaviosOptionsToken");
+const Reply = _navios_di.InjectionToken.create("ReplyToken");
+const Request = _navios_di.InjectionToken.create("RequestToken");
+const StreamAdapterToken = _navios_di.InjectionToken.create("StreamAdapterToken");
+const XmlStreamAdapterToken = _navios_di.InjectionToken.create("XmlStreamAdapterToken");
+function Endpoint(endpoint) {
 	return (target, context) => {
 		if (context.kind !== "method") throw new Error("[Navios] Endpoint decorator can only be used on methods.");
 		const config = endpoint.config;
@@ -308,48 +274,19 @@ const XmlStreamAdapterToken = __navios_di.InjectionToken.create("XmlStreamAdapte
 }) {
 	return (target, context) => {
 		if (context.kind !== "class") throw new Error("[Navios] @Module decorator can only be used on classes.");
-		const token = __navios_di.InjectionToken.create(target);
+		const token = _navios_di.InjectionToken.create(target);
 		const moduleMetadata = getModuleMetadata(target, context);
 		for (const controller of controllers) moduleMetadata.controllers.add(controller);
 		for (const importedModule of imports) moduleMetadata.imports.add(importedModule);
 		for (const guard of Array.from(guards).reverse()) moduleMetadata.guards.add(guard);
-		return (0, __navios_di.Injectable)({
+		return (0, _navios_di.Injectable)({
 			token,
-			scope: __navios_di.InjectableScope.Singleton
+			scope: _navios_di.InjectableScope.Singleton
 		})(target, context);
 	};
 }
-/**
-* Decorator that marks a method as a multipart/form-data endpoint.
-* 
-* Use this decorator for endpoints that handle file uploads or form data.
-* The endpoint must be defined using @navios/builder's `declareMultipart` method.
-* 
-* @param endpoint - The multipart endpoint declaration from @navios/builder
-* @returns A method decorator
-* 
-* @example
-* ```typescript
-* const uploadFileEndpoint = api.declareMultipart({
-*   method: 'post',
-*   url: '/upload',
-*   requestSchema: z.object({ file: z.instanceof(File) }),
-*   responseSchema: z.object({ url: z.string() }),
-* })
-* 
-* @Controller()
-* export class FileController {
-*   @Multipart(uploadFileEndpoint)
-*   async uploadFile(request: MultipartParams<typeof uploadFileEndpoint>) {
-*     const { file } = request.data
-*     // Handle file upload
-*     return { url: 'https://example.com/file.jpg' }
-*   }
-* }
-* ```
-*/ function Multipart(endpoint) {
+function Multipart(endpoint) {
 	return (target, context) => {
-		if (typeof target !== "function") throw new Error("[Navios] Endpoint decorator can only be used on functions.");
 		if (context.kind !== "method") throw new Error("[Navios] Endpoint decorator can only be used on methods.");
 		const config = endpoint.config;
 		if (context.metadata) {
@@ -364,34 +301,8 @@ const XmlStreamAdapterToken = __navios_di.InjectionToken.create("XmlStreamAdapte
 		return target;
 	};
 }
-/**
-* Decorator that marks a method as a streaming endpoint.
-* 
-* Use this decorator for endpoints that stream data (e.g., file downloads, SSE).
-* The endpoint must be defined using @navios/builder's `declareStream` method.
-* 
-* @param endpoint - The stream endpoint declaration from @navios/builder
-* @returns A method decorator
-* 
-* @example
-* ```typescript
-* const downloadFileEndpoint = api.declareStream({
-*   method: 'get',
-*   url: '/files/$fileId',
-* })
-* 
-* @Controller()
-* export class FileController {
-*   @Stream(downloadFileEndpoint)
-*   async downloadFile(request: StreamParams<typeof downloadFileEndpoint>, reply: any) {
-*     const { fileId } = request.urlParams
-*     // Stream file data to reply
-*   }
-* }
-* ```
-*/ function Stream(endpoint) {
+function Stream(endpoint) {
 	return (target, context) => {
-		if (typeof target !== "function") throw new Error("[Navios] Endpoint decorator can only be used on functions.");
 		if (context.kind !== "method") throw new Error("[Navios] Endpoint decorator can only be used on methods.");
 		const config = endpoint.config;
 		if (context.metadata) {
@@ -474,7 +385,7 @@ const XmlStreamAdapterToken = __navios_di.InjectionToken.create("XmlStreamAdapte
 };
 
 //#endregion
-//#region ../core/lib/src-DzPY5s6d.mjs
+//#region ../core/lib/src-gBAChVRL.mjs
 function envInt(key, defaultValue) {
 	const envKey = node_process.env[key] || process.env[key];
 	return envKey ? parseInt(envKey, 10) : defaultValue;
@@ -557,6 +468,15 @@ const isConstructor = (val) => val === "constructor";
 const isNil = (val) => isUndefined(val) || val === null;
 const isEmpty = (array) => !(array && array.length > 0);
 const isSymbol = (val) => typeof val === "symbol";
+let requestCounter = 0;
+/**
+* Generates a simple incremental request ID.
+* Much faster than crypto.randomUUID() and sufficient for request tracking.
+*
+* @returns A unique request ID string (e.g., "req-1", "req-2", ...)
+*/ function generateRequestId() {
+	return `req-${++requestCounter}`;
+}
 /**
 * AsyncLocalStorage store for the current request ID.
 *
@@ -576,29 +496,49 @@ const isSymbol = (val) => typeof val === "symbol";
 * // Get current request ID (returns undefined if not in a request context)
 * const currentId = getRequestId()
 * ```
-*/ const requestIdStore = new node_async_hooks.AsyncLocalStorage();
+*/ let requestIdStore = null;
+function getRequestIdStore() {
+	if (!requestIdStore) requestIdStore = new node_async_hooks.AsyncLocalStorage();
+	return requestIdStore;
+}
+/**
+* Whether request ID propagation is enabled.
+* When disabled, runWithRequestId is a pass-through for better performance.
+*/ let requestIdEnabled = false;
+/**
+* Enables or disables request ID propagation.
+* Called by NaviosFactory based on the enableRequestId option.
+*
+* @param enabled - Whether to enable request ID propagation
+*/ function setRequestIdEnabled(enabled) {
+	requestIdEnabled = enabled;
+}
 /**
 * Runs a function with a request ID in the async local storage context.
+* If request ID propagation is disabled, the function is called directly
+* without AsyncLocalStorage overhead.
 *
 * @param requestId - The request ID to set for this context
 * @param fn - The function to run within this context
 * @returns The return value of the function
 */ function runWithRequestId(requestId, fn) {
-	return requestIdStore.run(requestId, fn);
+	if (!requestIdEnabled) return fn();
+	return getRequestIdStore().run(requestId, fn);
 }
 /**
 * Gets the current request ID from the async local storage context.
 *
 * @returns The current request ID, or undefined if not in a request context
 */ function getRequestId() {
-	return requestIdStore.getStore();
+	if (!requestIdEnabled) return;
+	return getRequestIdStore().getStore();
 }
 /**
 * Injection token for the logger output service.
 * 
 * This token is used to provide a custom logger implementation.
 * By default, it's bound to ConsoleLogger.
-*/ const LoggerOutput = __navios_di.InjectionToken.create("LoggerOutput");
+*/ const LoggerOutput = _navios_di.InjectionToken.create("LoggerOutput");
 /**
 * Schema for logger options.
 */ const loggerOptionsSchema = zod_v4.default.object({ context: zod_v4.default.string().optional() }).optional();
@@ -612,8 +552,8 @@ const isSymbol = (val) => typeof val === "symbol";
 * const logger = inject(Logger, { context: 'MyService' })
 * logger.log('Hello world') // Logs with context: [MyService]
 * ```
-*/ const Logger = __navios_di.InjectionToken.create("Logger", loggerOptionsSchema);
-function applyDecs2203RFactory$13() {
+*/ const Logger = _navios_di.InjectionToken.create("Logger", loggerOptionsSchema);
+function applyDecs2203RFactory$14() {
 	function createAddInitializerMethod(initializers, decoratorFinishedRef) {
 		return function addInitializer(initializer) {
 			assertNotFinished(decoratorFinishedRef, "addInitializer");
@@ -887,10 +827,10 @@ function applyDecs2203RFactory$13() {
 		};
 	};
 }
-function _apply_decs_2203_r$13(targetClass, memberDecs, classDecs, parentClass) {
-	return (_apply_decs_2203_r$13 = applyDecs2203RFactory$13())(targetClass, memberDecs, classDecs, parentClass);
+function _apply_decs_2203_r$14(targetClass, memberDecs, classDecs, parentClass) {
+	return (_apply_decs_2203_r$14 = applyDecs2203RFactory$14())(targetClass, memberDecs, classDecs, parentClass);
 }
-var _dec$13, _initClass$13;
+var _dec$14, _initClass$14;
 const DEFAULT_DEPTH = 5;
 const DEFAULT_LOG_LEVELS = [
 	"log",
@@ -909,10 +849,10 @@ const dateTimeFormatter = new Intl.DateTimeFormat(void 0, {
 	month: "2-digit"
 });
 let _ConsoleLogger;
-_dec$13 = (0, __navios_di.Injectable)({ token: LoggerOutput });
+_dec$14 = (0, _navios_di.Injectable)({ token: LoggerOutput });
 (class {
 	static {
-		({c: [_ConsoleLogger, _initClass$13]} = _apply_decs_2203_r$13(this, [], [_dec$13]));
+		({c: [_ConsoleLogger, _initClass$14]} = _apply_decs_2203_r$14(this, [], [_dec$14]));
 	}
 	/**
 	* The options of the logger.
@@ -1161,10 +1101,10 @@ _dec$13 = (0, __navios_di.Injectable)({ token: LoggerOutput });
 		}
 	}
 	static {
-		_initClass$13();
+		_initClass$14();
 	}
 });
-function applyDecs2203RFactory$12() {
+function applyDecs2203RFactory$13() {
 	function createAddInitializerMethod(initializers, decoratorFinishedRef) {
 		return function addInitializer(initializer) {
 			assertNotFinished(decoratorFinishedRef, "addInitializer");
@@ -1438,20 +1378,20 @@ function applyDecs2203RFactory$12() {
 		};
 	};
 }
-function _apply_decs_2203_r$12(targetClass, memberDecs, classDecs, parentClass) {
-	return (_apply_decs_2203_r$12 = applyDecs2203RFactory$12())(targetClass, memberDecs, classDecs, parentClass);
+function _apply_decs_2203_r$13(targetClass, memberDecs, classDecs, parentClass) {
+	return (_apply_decs_2203_r$13 = applyDecs2203RFactory$13())(targetClass, memberDecs, classDecs, parentClass);
 }
-var _dec$12, _initClass$12;
+var _dec$13, _initClass$13;
 let _LoggerInstance;
-_dec$12 = (0, __navios_di.Injectable)({ token: Logger });
+_dec$13 = (0, _navios_di.Injectable)({ token: Logger });
 (class {
 	static {
-		({c: [_LoggerInstance, _initClass$12]} = _apply_decs_2203_r$12(this, [], [_dec$12]));
+		({c: [_LoggerInstance, _initClass$13]} = _apply_decs_2203_r$13(this, [], [_dec$13]));
 	}
 	constructor(config = {}) {
 		this.context = config.context;
 	}
-	localInstance = (0, __navios_di.inject)(LoggerOutput);
+	localInstance = (0, _navios_di.inject)(LoggerOutput);
 	context;
 	error(message, ...optionalParams) {
 		optionalParams = this.context ? (optionalParams.length ? optionalParams : [void 0]).concat(this.context) : optionalParams;
@@ -1478,10 +1418,10 @@ _dec$12 = (0, __navios_di.Injectable)({ token: Logger });
 		this.localInstance?.fatal?.(message, ...optionalParams);
 	}
 	static {
-		_initClass$12();
+		_initClass$13();
 	}
 });
-function applyDecs2203RFactory$11() {
+function applyDecs2203RFactory$12() {
 	function createAddInitializerMethod(initializers, decoratorFinishedRef) {
 		return function addInitializer(initializer) {
 			assertNotFinished(decoratorFinishedRef, "addInitializer");
@@ -1755,22 +1695,22 @@ function applyDecs2203RFactory$11() {
 		};
 	};
 }
-function _apply_decs_2203_r$11(targetClass, memberDecs, classDecs, parentClass) {
-	return (_apply_decs_2203_r$11 = applyDecs2203RFactory$11())(targetClass, memberDecs, classDecs, parentClass);
+function _apply_decs_2203_r$12(targetClass, memberDecs, classDecs, parentClass) {
+	return (_apply_decs_2203_r$12 = applyDecs2203RFactory$12())(targetClass, memberDecs, classDecs, parentClass);
 }
-var _dec$11, _initClass$11;
+var _dec$12, _initClass$12;
 /**
 * Schema for validating configuration service options.
 */ const ConfigServiceOptionsSchema = zod_v4.z.record(zod_v4.z.string(), zod_v4.z.unknown());
 /**
 * Injection token for ConfigService.
-*/ const ConfigServiceToken = __navios_di.InjectionToken.create(Symbol.for("ConfigService"), ConfigServiceOptionsSchema);
+*/ const ConfigServiceToken = _navios_di.InjectionToken.create(Symbol.for("ConfigService"), ConfigServiceOptionsSchema);
 let _ConfigService;
-_dec$11 = (0, __navios_di.Injectable)({ token: ConfigServiceToken });
+_dec$12 = (0, _navios_di.Injectable)({ token: ConfigServiceToken });
 (class {
 	config;
 	static {
-		({c: [_ConfigService, _initClass$11]} = _apply_decs_2203_r$11(this, [], [_dec$11]));
+		({c: [_ConfigService, _initClass$12]} = _apply_decs_2203_r$12(this, [], [_dec$12]));
 	}
 	/**
 	* Creates a new ConfigService instance.
@@ -1779,7 +1719,7 @@ _dec$11 = (0, __navios_di.Injectable)({ token: ConfigServiceToken });
 	*/ constructor(config = {}) {
 		this.config = config;
 	}
-	logger = (0, __navios_di.inject)(Logger, { context: _ConfigService.name });
+	logger = (0, _navios_di.inject)(Logger, { context: _ConfigService.name });
 	/**
 	* Gets the entire configuration object.
 	*
@@ -1852,7 +1792,7 @@ _dec$11 = (0, __navios_di.Injectable)({ token: ConfigServiceToken });
 		return value;
 	}
 	static {
-		_initClass$11();
+		_initClass$12();
 	}
 });
 /**
@@ -1880,7 +1820,7 @@ _dec$11 = (0, __navios_di.Injectable)({ token: ConfigServiceToken });
 * container.bind(ConfigServiceToken).toFactory(configProvider)
 * ```
 */ function provideConfig(options) {
-	return __navios_di.InjectionToken.factory(ConfigServiceToken, async () => options.load());
+	return _navios_di.InjectionToken.factory(ConfigServiceToken, async () => options.load());
 }
 /**
 * Pre-configured ConfigService provider that uses environment variables.
@@ -1892,7 +1832,7 @@ _dec$11 = (0, __navios_di.Injectable)({ token: ConfigServiceToken });
 * // Use environment variables as configuration
 * container.bind(ConfigServiceToken).toValue(EnvConfigProvider)
 * ```
-*/ const EnvConfigProvider = __navios_di.InjectionToken.bound(ConfigServiceToken, { ...node_process.env });
+*/ const EnvConfigProvider = _navios_di.InjectionToken.bound(ConfigServiceToken, { ...node_process.env });
 /**
 * Base exception class for all HTTP exceptions in Navios.
 * 
@@ -2087,6 +2027,357 @@ _dec$11 = (0, __navios_di.Injectable)({ token: ConfigServiceToken });
 		super(409, message, error);
 	}
 };
+function applyDecs2203RFactory$11() {
+	function createAddInitializerMethod(initializers, decoratorFinishedRef) {
+		return function addInitializer(initializer) {
+			assertNotFinished(decoratorFinishedRef, "addInitializer");
+			assertCallable(initializer, "An initializer");
+			initializers.push(initializer);
+		};
+	}
+	function memberDec(dec, name, desc, initializers, kind, isStatic, isPrivate, metadata, value) {
+		var kindStr;
+		switch (kind) {
+			case 1:
+				kindStr = "accessor";
+				break;
+			case 2:
+				kindStr = "method";
+				break;
+			case 3:
+				kindStr = "getter";
+				break;
+			case 4:
+				kindStr = "setter";
+				break;
+			default: kindStr = "field";
+		}
+		var ctx = {
+			kind: kindStr,
+			name: isPrivate ? "#" + name : name,
+			static: isStatic,
+			private: isPrivate,
+			metadata
+		};
+		var decoratorFinishedRef = { v: false };
+		ctx.addInitializer = createAddInitializerMethod(initializers, decoratorFinishedRef);
+		var get, set;
+		if (kind === 0) if (isPrivate) {
+			get = desc.get;
+			set = desc.set;
+		} else {
+			get = function() {
+				return this[name];
+			};
+			set = function(v) {
+				this[name] = v;
+			};
+		}
+		else if (kind === 2) get = function() {
+			return desc.value;
+		};
+		else {
+			if (kind === 1 || kind === 3) get = function() {
+				return desc.get.call(this);
+			};
+			if (kind === 1 || kind === 4) set = function(v) {
+				desc.set.call(this, v);
+			};
+		}
+		ctx.access = get && set ? {
+			get,
+			set
+		} : get ? { get } : { set };
+		try {
+			return dec(value, ctx);
+		} finally {
+			decoratorFinishedRef.v = true;
+		}
+	}
+	function assertNotFinished(decoratorFinishedRef, fnName) {
+		if (decoratorFinishedRef.v) throw new Error("attempted to call " + fnName + " after decoration was finished");
+	}
+	function assertCallable(fn, hint) {
+		if (typeof fn !== "function") throw new TypeError(hint + " must be a function");
+	}
+	function assertValidReturnValue(kind, value) {
+		var type = typeof value;
+		if (kind === 1) {
+			if (type !== "object" || value === null) throw new TypeError("accessor decorators must return an object with get, set, or init properties or void 0");
+			if (value.get !== void 0) assertCallable(value.get, "accessor.get");
+			if (value.set !== void 0) assertCallable(value.set, "accessor.set");
+			if (value.init !== void 0) assertCallable(value.init, "accessor.init");
+		} else if (type !== "function") {
+			var hint;
+			if (kind === 0) hint = "field";
+			else if (kind === 10) hint = "class";
+			else hint = "method";
+			throw new TypeError(hint + " decorators must return a function or void 0");
+		}
+	}
+	function applyMemberDec(ret, base, decInfo, name, kind, isStatic, isPrivate, initializers, metadata) {
+		var decs = decInfo[0];
+		var desc, init, value;
+		if (isPrivate) if (kind === 0 || kind === 1) desc = {
+			get: decInfo[3],
+			set: decInfo[4]
+		};
+		else if (kind === 3) desc = { get: decInfo[3] };
+		else if (kind === 4) desc = { set: decInfo[3] };
+		else desc = { value: decInfo[3] };
+		else if (kind !== 0) desc = Object.getOwnPropertyDescriptor(base, name);
+		if (kind === 1) value = {
+			get: desc.get,
+			set: desc.set
+		};
+		else if (kind === 2) value = desc.value;
+		else if (kind === 3) value = desc.get;
+		else if (kind === 4) value = desc.set;
+		var newValue, get, set;
+		if (typeof decs === "function") {
+			newValue = memberDec(decs, name, desc, initializers, kind, isStatic, isPrivate, metadata, value);
+			if (newValue !== void 0) {
+				assertValidReturnValue(kind, newValue);
+				if (kind === 0) init = newValue;
+				else if (kind === 1) {
+					init = newValue.init;
+					get = newValue.get || value.get;
+					set = newValue.set || value.set;
+					value = {
+						get,
+						set
+					};
+				} else value = newValue;
+			}
+		} else for (var i = decs.length - 1; i >= 0; i--) {
+			var dec = decs[i];
+			newValue = memberDec(dec, name, desc, initializers, kind, isStatic, isPrivate, metadata, value);
+			if (newValue !== void 0) {
+				assertValidReturnValue(kind, newValue);
+				var newInit;
+				if (kind === 0) newInit = newValue;
+				else if (kind === 1) {
+					newInit = newValue.init;
+					get = newValue.get || value.get;
+					set = newValue.set || value.set;
+					value = {
+						get,
+						set
+					};
+				} else value = newValue;
+				if (newInit !== void 0) if (init === void 0) init = newInit;
+				else if (typeof init === "function") init = [init, newInit];
+				else init.push(newInit);
+			}
+		}
+		if (kind === 0 || kind === 1) {
+			if (init === void 0) init = function(instance, init$1) {
+				return init$1;
+			};
+			else if (typeof init !== "function") {
+				var ownInitializers = init;
+				init = function(instance, init$1) {
+					var value$1 = init$1;
+					for (var i$1 = 0; i$1 < ownInitializers.length; i$1++) value$1 = ownInitializers[i$1].call(instance, value$1);
+					return value$1;
+				};
+			} else {
+				var originalInitializer = init;
+				init = function(instance, init$1) {
+					return originalInitializer.call(instance, init$1);
+				};
+			}
+			ret.push(init);
+		}
+		if (kind !== 0) {
+			if (kind === 1) {
+				desc.get = value.get;
+				desc.set = value.set;
+			} else if (kind === 2) desc.value = value;
+			else if (kind === 3) desc.get = value;
+			else if (kind === 4) desc.set = value;
+			if (isPrivate) if (kind === 1) {
+				ret.push(function(instance, args) {
+					return value.get.call(instance, args);
+				});
+				ret.push(function(instance, args) {
+					return value.set.call(instance, args);
+				});
+			} else if (kind === 2) ret.push(value);
+			else ret.push(function(instance, args) {
+				return value.call(instance, args);
+			});
+			else Object.defineProperty(base, name, desc);
+		}
+	}
+	function applyMemberDecs(Class, decInfos, metadata) {
+		var ret = [];
+		var protoInitializers;
+		var staticInitializers;
+		var existingProtoNonFields = /* @__PURE__ */ new Map();
+		var existingStaticNonFields = /* @__PURE__ */ new Map();
+		for (var i = 0; i < decInfos.length; i++) {
+			var decInfo = decInfos[i];
+			if (!Array.isArray(decInfo)) continue;
+			var kind = decInfo[1];
+			var name = decInfo[2];
+			var isPrivate = decInfo.length > 3;
+			var isStatic = kind >= 5;
+			var base;
+			var initializers;
+			if (isStatic) {
+				base = Class;
+				kind = kind - 5;
+				staticInitializers = staticInitializers || [];
+				initializers = staticInitializers;
+			} else {
+				base = Class.prototype;
+				protoInitializers = protoInitializers || [];
+				initializers = protoInitializers;
+			}
+			if (kind !== 0 && !isPrivate) {
+				var existingNonFields = isStatic ? existingStaticNonFields : existingProtoNonFields;
+				var existingKind = existingNonFields.get(name) || 0;
+				if (existingKind === true || existingKind === 3 && kind !== 4 || existingKind === 4 && kind !== 3) throw new Error("Attempted to decorate a public method/accessor that has the same name as a previously decorated public method/accessor. This is not currently supported by the decorators plugin. Property name was: " + name);
+				else if (!existingKind && kind > 2) existingNonFields.set(name, kind);
+				else existingNonFields.set(name, true);
+			}
+			applyMemberDec(ret, base, decInfo, name, kind, isStatic, isPrivate, initializers, metadata);
+		}
+		pushInitializers(ret, protoInitializers);
+		pushInitializers(ret, staticInitializers);
+		return ret;
+	}
+	function pushInitializers(ret, initializers) {
+		if (initializers) ret.push(function(instance) {
+			for (var i = 0; i < initializers.length; i++) initializers[i].call(instance);
+			return instance;
+		});
+	}
+	function applyClassDecs(targetClass, classDecs, metadata) {
+		if (classDecs.length > 0) {
+			var initializers = [];
+			var newClass = targetClass;
+			var name = targetClass.name;
+			for (var i = classDecs.length - 1; i >= 0; i--) {
+				var decoratorFinishedRef = { v: false };
+				try {
+					var nextNewClass = classDecs[i](newClass, {
+						kind: "class",
+						name,
+						addInitializer: createAddInitializerMethod(initializers, decoratorFinishedRef),
+						metadata
+					});
+				} finally {
+					decoratorFinishedRef.v = true;
+				}
+				if (nextNewClass !== void 0) {
+					assertValidReturnValue(10, nextNewClass);
+					newClass = nextNewClass;
+				}
+			}
+			return [defineMetadata(newClass, metadata), function() {
+				for (var i$1 = 0; i$1 < initializers.length; i$1++) initializers[i$1].call(newClass);
+			}];
+		}
+	}
+	function defineMetadata(Class, metadata) {
+		return Object.defineProperty(Class, Symbol.metadata || Symbol.for("Symbol.metadata"), {
+			configurable: true,
+			enumerable: true,
+			value: metadata
+		});
+	}
+	return function applyDecs2203R(targetClass, memberDecs, classDecs, parentClass) {
+		if (parentClass !== void 0) var parentMetadata = parentClass[Symbol.metadata || Symbol.for("Symbol.metadata")];
+		var metadata = Object.create(parentMetadata === void 0 ? null : parentMetadata);
+		var e = applyMemberDecs(targetClass, memberDecs, metadata);
+		if (!classDecs.length) defineMetadata(targetClass, metadata);
+		return {
+			e,
+			get c() {
+				return applyClassDecs(targetClass, classDecs, metadata);
+			}
+		};
+	};
+}
+function _apply_decs_2203_r$11(targetClass, memberDecs, classDecs, parentClass) {
+	return (_apply_decs_2203_r$11 = applyDecs2203RFactory$11())(targetClass, memberDecs, classDecs, parentClass);
+}
+var _dec$11, _initClass$11;
+let _InstanceResolverService;
+_dec$11 = (0, _navios_di.Injectable)();
+(class {
+	static {
+		({c: [_InstanceResolverService, _initClass$11]} = _apply_decs_2203_r$11(this, [], [_dec$11]));
+	}
+	container = (0, _navios_di.inject)(_navios_di.Container);
+	/**
+	* Attempts to resolve a class instance, automatically detecting if it needs
+	* request scope based on its dependencies.
+	*
+	* @param classType - The class to resolve
+	* @returns A resolution result containing either a cached instance or resolver function
+	*/ async resolve(classType) {
+		let cachedInstance = null;
+		try {
+			cachedInstance = await this.container.get(classType);
+		} catch {
+			const token = (0, _navios_di.getInjectableToken)(classType);
+			this.container.getRegistry().updateScope(token, _navios_di.InjectableScope.Request);
+		}
+		return {
+			cached: cachedInstance !== null,
+			instance: cachedInstance,
+			resolve: (scoped) => scoped.get(classType)
+		};
+	}
+	/**
+	* Attempts to resolve multiple class instances, automatically detecting if any need
+	* request scope based on their dependencies.
+	*
+	* Returns `cached: true` only if ALL classes can be resolved as singletons.
+	* If any class has request-scoped dependencies, returns `cached: false`.
+	*
+	* @param classTypes - The classes to resolve
+	* @returns A resolution result containing either all cached instances or resolver function
+	*/ async resolveMany(classTypes) {
+		if (classTypes.length === 0) return {
+			cached: true,
+			instances: [],
+			classTypes: [],
+			resolve: async () => []
+		};
+		const results = await Promise.all(classTypes.map(async (classType) => {
+			try {
+				return {
+					success: true,
+					instance: await this.container.get(classType)
+				};
+			} catch {
+				const token = (0, _navios_di.getInjectableToken)(classType);
+				this.container.getRegistry().updateScope(token, _navios_di.InjectableScope.Request);
+				return {
+					success: false,
+					instance: null
+				};
+			}
+		}));
+		const allCached = results.every((r) => r.success);
+		return {
+			cached: allCached,
+			instances: allCached ? results.map((r) => r.instance) : null,
+			classTypes,
+			resolve: (scoped) => Promise.all(classTypes.map((classType) => scoped.get(classType)))
+		};
+	}
+	static {
+		_initClass$11();
+	}
+});
+/**
+* @deprecated Use InstanceResolverService instead
+*/ const ControllerResolverService = _InstanceResolverService;
 function applyDecs2203RFactory$10() {
 	function createAddInitializerMethod(initializers, decoratorFinishedRef) {
 		return function addInitializer(initializer) {
@@ -2366,29 +2657,46 @@ function _apply_decs_2203_r$10(targetClass, memberDecs, classDecs, parentClass)
 }
 var _dec$10, _initClass$10;
 let _GuardRunnerService;
-_dec$10 = (0, __navios_di.Injectable)();
+_dec$10 = (0, _navios_di.Injectable)();
 (class {
 	static {
 		({c: [_GuardRunnerService, _initClass$10]} = _apply_decs_2203_r$10(this, [], [_dec$10]));
 	}
-	logger = (0, __navios_di.inject)(Logger, { context: _GuardRunnerService.name });
-	async runGuards(allGuards, executionContext, context) {
-		let canActivate = true;
-		for (const guard of Array.from(allGuards).reverse()) {
+	logger = (0, _navios_di.inject)(Logger, { context: _GuardRunnerService.name });
+	/**
+	* Runs guards that need to be resolved from a scoped container.
+	* Use this when guards have request-scoped dependencies.
+	*/ async runGuards(allGuards, executionContext, context) {
+		const guardsArray = Array.from(allGuards).reverse();
+		const guardInstances = await Promise.all(guardsArray.map(async (guard) => {
 			const guardInstance = await context.get(guard);
 			if (!guardInstance.canActivate) throw new Error(`[Navios] Guard ${guard.name} does not implement canActivate()`);
-			try {
-				canActivate = await guardInstance.canActivate(executionContext);
-				if (!canActivate) break;
-			} catch (error) {
-				if (error instanceof HttpException) {
-					executionContext.getReply().status(error.statusCode).send(error.response);
-					return false;
-				} else {
-					this.logger.error("Error running guard", error);
-					executionContext.getReply().status(500).send({ message: "Internal server error" });
-					return false;
-				}
+			return guardInstance;
+		}));
+		return this.executeGuards(guardInstances, executionContext);
+	}
+	/**
+	* Runs pre-resolved guard instances.
+	* Use this when all guards are singletons and have been pre-resolved at startup.
+	*/ async runGuardsStatic(guardInstances, executionContext) {
+		return this.executeGuards(guardInstances, executionContext);
+	}
+	/**
+	* Shared guard execution logic.
+	* Iterates through guard instances and calls canActivate on each.
+	*/ async executeGuards(guardInstances, executionContext) {
+		let canActivate = true;
+		for (const guardInstance of guardInstances) try {
+			canActivate = await guardInstance.canActivate(executionContext);
+			if (!canActivate) break;
+		} catch (error) {
+			if (error instanceof HttpException) {
+				executionContext.getReply().status(error.statusCode).send(error.response);
+				return false;
+			} else {
+				this.logger.error("Error running guard", error);
+				executionContext.getReply().status(500).send({ message: "Internal server error" });
+				return false;
 			}
 		}
 		if (!canActivate) {
@@ -2690,13 +2998,13 @@ function _apply_decs_2203_r$9(targetClass, memberDecs, classDecs, parentClass) {
 }
 var _dec$9, _initClass$9;
 let _ModuleLoaderService;
-_dec$9 = (0, __navios_di.Injectable)();
+_dec$9 = (0, _navios_di.Injectable)();
 (class {
 	static {
 		({c: [_ModuleLoaderService, _initClass$9]} = _apply_decs_2203_r$9(this, [], [_dec$9]));
 	}
-	logger = (0, __navios_di.inject)(Logger, { context: _ModuleLoaderService.name });
-	container = (0, __navios_di.inject)(__navios_di.Container);
+	logger = (0, _navios_di.inject)(Logger, { context: _ModuleLoaderService.name });
+	container = (0, _navios_di.inject)(_navios_di.Container);
 	modulesMetadata = /* @__PURE__ */ new Map();
 	loadedModules = /* @__PURE__ */ new Map();
 	initialized = false;
@@ -2705,6 +3013,49 @@ _dec$9 = (0, __navios_di.Injectable)();
 		await this.traverseModules(appModule);
 		this.initialized = true;
 	}
+	/**
+	* Extends the module tree with additional modules or controllers.
+	*
+	* This method is designed to be called by plugins during registration,
+	* which happens after initial module loading but before route registration.
+	*
+	* @param extensions - Array of module extensions to add
+	* @throws Error if not initialized (loadModules must be called first)
+	*
+	* @example
+	* ```typescript
+	* // In plugin registration
+	* const moduleLoader = await context.container.get(ModuleLoaderService)
+	* await moduleLoader.extendModules([{
+	*   controllers: [OpenApiJsonController, OpenApiYamlController],
+	*   moduleName: 'OpenApiBunModule',
+	* }])
+	* ```
+	*/ async extendModules(extensions) {
+		if (!this.initialized) throw new Error("ModuleLoaderService must be initialized before extending. Call loadModules() first.");
+		for (const extension of extensions) if (extension.module) await this.traverseModules(extension.module);
+		else if (extension.controllers && extension.moduleName) await this.registerControllers(extension.controllers, extension.moduleName);
+		else if (extension.controllers) throw new Error("moduleName is required when providing controllers without a module");
+	}
+	/**
+	* Registers controllers under a synthetic module.
+	* Used when plugins want to add controllers without a full module class.
+	*/ async registerControllers(controllers, moduleName) {
+		if (this.modulesMetadata.has(moduleName)) {
+			const existing = this.modulesMetadata.get(moduleName);
+			for (const controller of controllers) existing.controllers.add(controller);
+			this.logger.debug(`Extended module ${moduleName} with ${controllers.length} controllers`);
+		} else {
+			const metadata = {
+				controllers: new Set(controllers),
+				imports: /* @__PURE__ */ new Set(),
+				guards: /* @__PURE__ */ new Set(),
+				customAttributes: /* @__PURE__ */ new Map()
+			};
+			this.modulesMetadata.set(moduleName, metadata);
+			this.logger.debug(`Created module ${moduleName} with ${controllers.length} controllers`);
+		}
+	}
 	async traverseModules(module$1, parentMetadata) {
 		const metadata = extractModuleMetadata(module$1);
 		if (parentMetadata) this.mergeMetadata(metadata, parentMetadata);
@@ -3098,7 +3449,7 @@ function _apply_decs_2203_r$8(targetClass, memberDecs, classDecs, parentClass) {
 }
 var _dec$8, _initClass$8;
 let _NaviosEnvironment;
-_dec$8 = (0, __navios_di.Injectable)();
+_dec$8 = (0, _navios_di.Injectable)();
 (class {
 	static {
 		({c: [_NaviosEnvironment, _initClass$8]} = _apply_decs_2203_r$8(this, [], [_dec$8]));
@@ -3396,12 +3747,12 @@ function _apply_decs_2203_r$7(targetClass, memberDecs, classDecs, parentClass) {
 }
 var _dec$7, _initClass$7;
 let _EndpointAdapterFactory;
-_dec$7 = (0, __navios_di.Factory)({ token: EndpointAdapterToken });
+_dec$7 = (0, _navios_di.Factory)({ token: EndpointAdapterToken });
 (class {
 	static {
 		({c: [_EndpointAdapterFactory, _initClass$7]} = _apply_decs_2203_r$7(this, [], [_dec$7]));
 	}
-	environment = (0, __navios_di.inject)(_NaviosEnvironment);
+	environment = (0, _navios_di.inject)(_NaviosEnvironment);
 	create(ctx) {
 		const service = this.environment.getHttpToken(EndpointAdapterToken);
 		if (!service) throw new Error("EndpointAdapterToken service not found in environment");
@@ -3690,12 +4041,12 @@ function _apply_decs_2203_r$6(targetClass, memberDecs, classDecs, parentClass) {
 }
 var _dec$6, _initClass$6;
 let _HttpAdapterFactory;
-_dec$6 = (0, __navios_di.Factory)({ token: HttpAdapterToken });
+_dec$6 = (0, _navios_di.Factory)({ token: HttpAdapterToken });
 (class {
 	static {
 		({c: [_HttpAdapterFactory, _initClass$6]} = _apply_decs_2203_r$6(this, [], [_dec$6]));
 	}
-	environment = (0, __navios_di.inject)(_NaviosEnvironment);
+	environment = (0, _navios_di.inject)(_NaviosEnvironment);
 	create(ctx) {
 		const service = this.environment.getHttpToken(HttpAdapterToken);
 		if (!service) throw new Error("HttpAdapterToken service not found in environment");
@@ -3984,12 +4335,12 @@ function _apply_decs_2203_r$5(targetClass, memberDecs, classDecs, parentClass) {
 }
 var _dec$5, _initClass$5;
 let _MultipartAdapterFactory;
-_dec$5 = (0, __navios_di.Factory)({ token: MultipartAdapterToken });
+_dec$5 = (0, _navios_di.Factory)({ token: MultipartAdapterToken });
 (class {
 	static {
 		({c: [_MultipartAdapterFactory, _initClass$5]} = _apply_decs_2203_r$5(this, [], [_dec$5]));
 	}
-	environment = (0, __navios_di.inject)(_NaviosEnvironment);
+	environment = (0, _navios_di.inject)(_NaviosEnvironment);
 	create(ctx) {
 		const service = this.environment.getHttpToken(MultipartAdapterToken);
 		if (!service) throw new Error("MultipartAdapterToken service not found in environment");
@@ -4278,15 +4629,15 @@ function _apply_decs_2203_r$4(targetClass, memberDecs, classDecs, parentClass) {
 }
 var _dec$4, _initClass$4;
 let _RequestFactory;
-_dec$4 = (0, __navios_di.Factory)({
+_dec$4 = (0, _navios_di.Factory)({
 	token: Request,
-	scope: __navios_di.InjectableScope.Request
+	scope: _navios_di.InjectableScope.Request
 });
 (class {
 	static {
 		({c: [_RequestFactory, _initClass$4]} = _apply_decs_2203_r$4(this, [], [_dec$4]));
 	}
-	environment = (0, __navios_di.inject)(_NaviosEnvironment);
+	environment = (0, _navios_di.inject)(_NaviosEnvironment);
 	create(ctx) {
 		const service = this.environment.getHttpToken(Request);
 		if (!service) throw new Error("RequestToken service not found in environment");
@@ -4575,15 +4926,15 @@ function _apply_decs_2203_r$3(targetClass, memberDecs, classDecs, parentClass) {
 }
 var _dec$3, _initClass$3;
 let _ReplyFactory;
-_dec$3 = (0, __navios_di.Factory)({
+_dec$3 = (0, _navios_di.Factory)({
 	token: Reply,
-	scope: __navios_di.InjectableScope.Request
+	scope: _navios_di.InjectableScope.Request
 });
 (class {
 	static {
 		({c: [_ReplyFactory, _initClass$3]} = _apply_decs_2203_r$3(this, [], [_dec$3]));
 	}
-	environment = (0, __navios_di.inject)(_NaviosEnvironment);
+	environment = (0, _navios_di.inject)(_NaviosEnvironment);
 	create(ctx) {
 		const service = this.environment.getHttpToken(Reply);
 		if (!service) throw new Error("ReplyToken service not found in environment");
@@ -4872,12 +5223,12 @@ function _apply_decs_2203_r$2$1(targetClass, memberDecs, classDecs, parentClass)
 }
 var _dec$2$1, _initClass$2$1;
 let _StreamAdapterFactory;
-_dec$2$1 = (0, __navios_di.Factory)({ token: StreamAdapterToken });
+_dec$2$1 = (0, _navios_di.Factory)({ token: StreamAdapterToken });
 (class {
 	static {
 		({c: [_StreamAdapterFactory, _initClass$2$1]} = _apply_decs_2203_r$2$1(this, [], [_dec$2$1]));
 	}
-	environment = (0, __navios_di.inject)(_NaviosEnvironment);
+	environment = (0, _navios_di.inject)(_NaviosEnvironment);
 	create(ctx) {
 		const service = this.environment.getHttpToken(StreamAdapterToken);
 		if (!service) throw new Error("StreamAdapterToken service not found in environment");
@@ -5166,12 +5517,12 @@ function _apply_decs_2203_r$1$1(targetClass, memberDecs, classDecs, parentClass)
 }
 var _dec$1$1, _initClass$1$1;
 let _XmlStreamAdapterFactory;
-_dec$1$1 = (0, __navios_di.Factory)({ token: XmlStreamAdapterToken });
+_dec$1$1 = (0, _navios_di.Factory)({ token: XmlStreamAdapterToken });
 (class {
 	static {
 		({c: [_XmlStreamAdapterFactory, _initClass$1$1]} = _apply_decs_2203_r$1$1(this, [], [_dec$1$1]));
 	}
-	environment = (0, __navios_di.inject)(_NaviosEnvironment);
+	environment = (0, _navios_di.inject)(_NaviosEnvironment);
 	create(ctx) {
 		const service = this.environment.getHttpToken(XmlStreamAdapterToken);
 		if (!service) throw new Error("XmlStreamAdapterToken service not found in environment");
@@ -5181,7 +5532,7 @@ _dec$1$1 = (0, __navios_di.Factory)({ token: XmlStreamAdapterToken });
 		_initClass$1$1();
 	}
 });
-function applyDecs2203RFactory$14() {
+function applyDecs2203RFactory$15() {
 	function createAddInitializerMethod(initializers, decoratorFinishedRef) {
 		return function addInitializer(initializer) {
 			assertNotFinished(decoratorFinishedRef, "addInitializer");
@@ -5455,23 +5806,24 @@ function applyDecs2203RFactory$14() {
 		};
 	};
 }
-function _apply_decs_2203_r$14(targetClass, memberDecs, classDecs, parentClass) {
-	return (_apply_decs_2203_r$14 = applyDecs2203RFactory$14())(targetClass, memberDecs, classDecs, parentClass);
+function _apply_decs_2203_r$15(targetClass, memberDecs, classDecs, parentClass) {
+	return (_apply_decs_2203_r$15 = applyDecs2203RFactory$15())(targetClass, memberDecs, classDecs, parentClass);
 }
-var _dec$14, _initClass$14;
+var _dec$15, _initClass$15;
 let _NaviosApplication;
-_dec$14 = (0, __navios_di.Injectable)();
+_dec$15 = (0, _navios_di.Injectable)();
 (class {
 	static {
-		({c: [_NaviosApplication, _initClass$14]} = _apply_decs_2203_r$14(this, [], [_dec$14]));
+		({c: [_NaviosApplication, _initClass$15]} = _apply_decs_2203_r$15(this, [], [_dec$15]));
 	}
-	environment = (0, __navios_di.inject)(_NaviosEnvironment);
-	moduleLoader = (0, __navios_di.inject)(_ModuleLoaderService);
+	environment = (0, _navios_di.inject)(_NaviosEnvironment);
+	moduleLoader = (0, _navios_di.inject)(_ModuleLoaderService);
 	httpApplication = null;
-	logger = (0, __navios_di.inject)(Logger, { context: _NaviosApplication.name });
-	container = (0, __navios_di.inject)(__navios_di.Container);
+	logger = (0, _navios_di.inject)(Logger, { context: _NaviosApplication.name });
+	container = (0, _navios_di.inject)(_navios_di.Container);
 	appModule = null;
 	options = { adapter: [] };
+	plugins = [];
 	/**
 	* Indicates whether the application has been initialized.
 	* Set to `true` after `init()` completes successfully.
@@ -5479,7 +5831,7 @@ _dec$14 = (0, __navios_di.Injectable)();
 	/**
 	* Sets up the application with the provided module and options.
 	* This is called automatically by NaviosFactory.create().
-	* 
+	*
 	* @param appModule - The root application module
 	* @param options - Application configuration options
 	* @internal
@@ -5490,24 +5842,46 @@ _dec$14 = (0, __navios_di.Injectable)();
 	}
 	/**
 	* Gets the dependency injection container used by this application.
-	* 
+	*
 	* @returns The Container instance
 	*/ getContainer() {
 		return this.container;
 	}
 	/**
+	* Registers a plugin to be initialized after modules are loaded.
+	*
+	* Plugins are initialized in the order they are registered,
+	* after all modules are loaded but before the server starts listening.
+	*
+	* @param definition - Plugin definition with options
+	* @returns this for method chaining
+	*
+	* @example
+	* ```typescript
+	* import { defineOpenApiPlugin } from '@navios/openapi-fastify'
+	*
+	* app.usePlugin(defineOpenApiPlugin({
+	*   info: { title: 'My API', version: '1.0.0' },
+	* }))
+	* ```
+	*/ usePlugin(definition) {
+		this.plugins.push(definition);
+		return this;
+	}
+	/**
 	* Initializes the application.
-	* 
+	*
 	* This method:
 	* - Loads all modules and their dependencies
 	* - Sets up the HTTP server if an adapter is configured
 	* - Calls onModuleInit hooks on all modules
+	* - Initializes registered plugins
 	* - Marks the application as initialized
-	* 
+	*
 	* Must be called before `listen()`.
-	* 
+	*
 	* @throws Error if app module is not set
-	* 
+	*
 	* @example
 	* ```typescript
 	* const app = await NaviosFactory.create(AppModule, {
@@ -5520,6 +5894,7 @@ _dec$14 = (0, __navios_di.Injectable)();
 		if (!this.appModule) throw new Error("App module is not set. Call setAppModule() first.");
 		await this.moduleLoader.loadModules(this.appModule);
 		if (this.environment.hasHttpSetup()) await this.httpApplication?.setupHttpServer(this.options);
+		await this.initPlugins();
 		await this.initModules();
 		if (this.environment.hasHttpSetup()) await this.httpApplication?.ready();
 		this.isInitialized = true;
@@ -5529,12 +5904,30 @@ _dec$14 = (0, __navios_di.Injectable)();
 		const modules = this.moduleLoader.getAllModules();
 		await this.httpApplication?.onModulesInit(modules);
 	}
+	async initPlugins() {
+		if (this.plugins.length === 0) return;
+		let server = null;
+		try {
+			server = this.httpApplication?.getServer() ?? null;
+		} catch {}
+		const context = {
+			modules: this.moduleLoader.getAllModules(),
+			server,
+			container: this.container,
+			globalPrefix: this.httpApplication?.getGlobalPrefix() ?? "",
+			moduleLoader: this.moduleLoader
+		};
+		for (const { plugin, options } of this.plugins) {
+			this.logger.debug(`Initializing plugin: ${plugin.name}`);
+			await plugin.register(context, options);
+		}
+	}
 	/**
 	* Enables CORS (Cross-Origin Resource Sharing) for the application.
-	* 
+	*
 	* @param options - CORS configuration options (adapter-specific)
 	* @throws Error if HTTP application is not set
-	* 
+	*
 	* @example
 	* ```typescript
 	* app.enableCors({
@@ -5549,10 +5942,10 @@ _dec$14 = (0, __navios_di.Injectable)();
 	}
 	/**
 	* Enables multipart/form-data support for file uploads.
-	* 
+	*
 	* @param options - Multipart configuration options (adapter-specific)
 	* @throws Error if HTTP application is not set
-	* 
+	*
 	* @example
 	* ```typescript
 	* app.enableMultipart({
@@ -5567,10 +5960,10 @@ _dec$14 = (0, __navios_di.Injectable)();
 	}
 	/**
 	* Sets a global prefix for all routes.
-	* 
+	*
 	* @param prefix - The prefix to prepend to all route URLs (e.g., '/api')
 	* @throws Error if HTTP application is not set
-	* 
+	*
 	* @example
 	* ```typescript
 	* app.setGlobalPrefix('/api/v1')
@@ -5582,14 +5975,14 @@ _dec$14 = (0, __navios_di.Injectable)();
 	}
 	/**
 	* Gets the underlying HTTP server instance.
-	* 
+	*
 	* The type of the returned server depends on the adapter used:
 	* - Fastify adapter: Returns FastifyInstance
 	* - Bun adapter: Returns Bun.Server
-	* 
+	*
 	* @returns The HTTP server instance
 	* @throws Error if HTTP application is not set
-	* 
+	*
 	* @example
 	* ```typescript
 	* const server = app.getServer()
@@ -5601,10 +5994,10 @@ _dec$14 = (0, __navios_di.Injectable)();
 	}
 	/**
 	* Starts the HTTP server and begins listening for requests.
-	* 
+	*
 	* @param options - Listen options (port, host, etc.)
 	* @throws Error if HTTP application is not set
-	* 
+	*
 	* @example
 	* ```typescript
 	* await app.listen({ port: 3000, host: '0.0.0.0' })
@@ -5615,7 +6008,7 @@ _dec$14 = (0, __navios_di.Injectable)();
 	}
 	/**
 	* Disposes of application resources.
-	* 
+	*
 	* Cleans up the HTTP server and module loader.
 	* This method is called automatically by `close()`.
 	*/ async dispose() {
@@ -5624,9 +6017,9 @@ _dec$14 = (0, __navios_di.Injectable)();
 	}
 	/**
 	* Closes the application and cleans up all resources.
-	* 
+	*
 	* This is an alias for `dispose()`.
-	* 
+	*
 	* @example
 	* ```typescript
 	* // Graceful shutdown
@@ -5639,36 +6032,36 @@ _dec$14 = (0, __navios_di.Injectable)();
 		await this.dispose();
 	}
 	static {
-		_initClass$14();
+		_initClass$15();
 	}
 });
 /**
 * Factory class for creating and configuring Navios applications.
-* 
+*
 * This is the main entry point for bootstrapping a Navios application.
 * It handles dependency injection container setup, adapter registration,
 * and logger configuration.
-* 
+*
 * @example
 * ```typescript
 * import { NaviosFactory } from '@navios/core'
 * import { defineFastifyEnvironment } from '@navios/adapter-fastify'
-* 
+*
 * const app = await NaviosFactory.create(AppModule, {
 *   adapter: defineFastifyEnvironment(),
 *   logger: ['log', 'error', 'warn'],
 * })
-* 
+*
 * await app.init()
 * await app.listen({ port: 3000 })
 * ```
 */ var NaviosFactory = class {
 	/**
 	* Creates a new Navios application instance.
-	* 
+	*
 	* This method sets up the dependency injection container, registers the HTTP adapter,
 	* configures logging, and initializes the application with the provided module.
-	* 
+	*
 	* @param appModule - The root application module class decorated with @Module()
 	* @param options - Configuration options for the application
 	* @param options.adapter - HTTP adapter environment (required for HTTP server functionality)
@@ -5678,20 +6071,20 @@ _dec$14 = (0, __navios_di.Injectable)();
 	*   - `false` to disable logging
 	* @param options.container - Optional custom dependency injection container (useful for testing)
 	* @returns A configured NaviosApplication instance ready to be initialized
-	* 
+	*
 	* @example
 	* ```typescript
 	* // Basic setup with Fastify adapter
 	* const app = await NaviosFactory.create(AppModule, {
 	*   adapter: defineFastifyEnvironment(),
 	* })
-	* 
+	*
 	* // With custom logger configuration
 	* const app = await NaviosFactory.create(AppModule, {
 	*   adapter: defineFastifyEnvironment(),
 	*   logger: ['error', 'warn', 'log'],
 	* })
-	* 
+	*
 	* // With custom container for testing
 	* const container = new Container()
 	* const app = await NaviosFactory.create(AppModule, {
@@ -5700,7 +6093,9 @@ _dec$14 = (0, __navios_di.Injectable)();
 	* })
 	* ```
 	*/ static async create(appModule, options = { adapter: [] }) {
-		const container = options.container ?? new __navios_di.Container();
+		const container = options.container ?? new _navios_di.Container();
+		if (options.enableRequestId === true) setRequestIdEnabled(true);
+		container.getServiceLocator().getManager().storeCreatedHolder(NaviosOptionsToken.toString(), options, _navios_di.InjectableType.Class, _navios_di.InjectableScope.Singleton);
 		await this.registerLoggerConfiguration(container, options);
 		const adapters = Array.isArray(options.adapter) ? options.adapter : [options.adapter];
 		for (const adapter of adapters) await this.registerEnvironment(container, adapter);
@@ -5715,8 +6110,11 @@ _dec$14 = (0, __navios_di.Injectable)();
 	}
 	static async registerLoggerConfiguration(container, options) {
 		const { logger } = options;
-		if (Array.isArray(logger) || isNil(logger)) (await container.get(LoggerOutput))?.setup({ logLevels: logger });
-		if (logger !== true && !isNil(logger)) container.getServiceLocator().getManager().storeCreatedHolder(LoggerOutput.toString(), logger, __navios_di.InjectableType.Class, __navios_di.InjectableScope.Singleton);
+		if (Array.isArray(logger) || isNil(logger)) {
+			(await container.get(LoggerOutput))?.setup({ logLevels: logger });
+			return;
+		}
+		if (logger !== true && !isNil(logger)) container.getServiceLocator().getManager().storeCreatedHolder(LoggerOutput.toString(), logger, _navios_di.InjectableType.Class, _navios_di.InjectableScope.Singleton);
 	}
 };
 
@@ -5733,6 +6131,7 @@ var lib_exports = /* @__PURE__ */ __export({
 	ConsoleLogger: () => _ConsoleLogger,
 	Controller: () => Controller,
 	ControllerMetadataKey: () => ControllerMetadataKey,
+	ControllerResolverService: () => ControllerResolverService,
 	Endpoint: () => Endpoint,
 	EndpointAdapterFactory: () => _EndpointAdapterFactory,
 	EndpointAdapterToken: () => EndpointAdapterToken,
@@ -5747,6 +6146,7 @@ var lib_exports = /* @__PURE__ */ __export({
 	HttpAdapterToken: () => HttpAdapterToken,
 	HttpCode: () => HttpCode,
 	HttpException: () => HttpException,
+	InstanceResolverService: () => _InstanceResolverService,
 	InternalServerErrorException: () => InternalServerErrorException,
 	LOG_LEVELS: () => LOG_LEVELS,
 	Logger: () => Logger,
@@ -5760,6 +6160,7 @@ var lib_exports = /* @__PURE__ */ __export({
 	MultipartAdapterToken: () => MultipartAdapterToken,
 	NaviosApplication: () => _NaviosApplication,
 	NaviosFactory: () => NaviosFactory,
+	NaviosOptionsToken: () => NaviosOptionsToken,
 	NotFoundException: () => NotFoundException,
 	Reply: () => Reply,
 	ReplyFactory: () => _ReplyFactory,
@@ -5779,6 +6180,7 @@ var lib_exports = /* @__PURE__ */ __export({
 	extractControllerMetadata: () => extractControllerMetadata,
 	extractModuleMetadata: () => extractModuleMetadata,
 	filterLogLevels: () => filterLogLevels,
+	generateRequestId: () => generateRequestId,
 	getAllEndpointMetadata: () => getAllEndpointMetadata,
 	getControllerMetadata: () => getControllerMetadata,
 	getEndpointMetadata: () => getEndpointMetadata,
@@ -5801,8 +6203,8 @@ var lib_exports = /* @__PURE__ */ __export({
 	loggerOptionsSchema: () => loggerOptionsSchema,
 	normalizePath: () => normalizePath,
 	provideConfig: () => provideConfig,
-	requestIdStore: () => requestIdStore,
 	runWithRequestId: () => runWithRequestId,
+	setRequestIdEnabled: () => setRequestIdEnabled,
 	stripEndSlash: () => stripEndSlash,
 	yellow: () => yellow
 });
@@ -7451,6 +7853,7 @@ var src_exports = /* @__PURE__ */ __export({
 	ConsoleLogger: () => _ConsoleLogger,
 	Controller: () => Controller,
 	ControllerMetadataKey: () => ControllerMetadataKey,
+	ControllerResolverService: () => ControllerResolverService,
 	Endpoint: () => Endpoint,
 	EndpointAdapterFactory: () => _EndpointAdapterFactory,
 	EndpointAdapterToken: () => EndpointAdapterToken,
@@ -7465,6 +7868,7 @@ var src_exports = /* @__PURE__ */ __export({
 	HttpAdapterToken: () => HttpAdapterToken,
 	HttpCode: () => HttpCode,
 	HttpException: () => HttpException,
+	InstanceResolverService: () => _InstanceResolverService,
 	InternalServerErrorException: () => InternalServerErrorException,
 	LOG_LEVELS: () => LOG_LEVELS,
 	Logger: () => Logger,
@@ -7478,6 +7882,7 @@ var src_exports = /* @__PURE__ */ __export({
 	MultipartAdapterToken: () => MultipartAdapterToken,
 	NaviosApplication: () => _NaviosApplication,
 	NaviosFactory: () => NaviosFactory,
+	NaviosOptionsToken: () => NaviosOptionsToken,
 	NotFoundException: () => NotFoundException,
 	Reply: () => Reply,
 	ReplyFactory: () => _ReplyFactory,
@@ -7499,6 +7904,7 @@ var src_exports = /* @__PURE__ */ __export({
 	extractControllerMetadata: () => extractControllerMetadata,
 	extractModuleMetadata: () => extractModuleMetadata,
 	filterLogLevels: () => filterLogLevels,
+	generateRequestId: () => generateRequestId,
 	getAllEndpointMetadata: () => getAllEndpointMetadata,
 	getCliModuleMetadata: () => getCliModuleMetadata,
 	getCommandMetadata: () => getCommandMetadata,
@@ -7525,8 +7931,8 @@ var src_exports = /* @__PURE__ */ __export({
 	loggerOptionsSchema: () => loggerOptionsSchema,
 	normalizePath: () => normalizePath,
 	provideConfig: () => provideConfig,
-	requestIdStore: () => requestIdStore,
 	runWithRequestId: () => runWithRequestId,
+	setRequestIdEnabled: () => setRequestIdEnabled,
 	stripEndSlash: () => stripEndSlash,
 	yellow: () => yellow
 });
@@ -7578,6 +7984,7 @@ Object.defineProperty(exports, 'ConsoleLogger', {
 });
 exports.Controller = Controller;
 exports.ControllerMetadataKey = ControllerMetadataKey;
+exports.ControllerResolverService = ControllerResolverService;
 exports.Endpoint = Endpoint;
 Object.defineProperty(exports, 'EndpointAdapterFactory', {
   enumerable: true,
@@ -7607,6 +8014,12 @@ Object.defineProperty(exports, 'HttpAdapterFactory', {
 exports.HttpAdapterToken = HttpAdapterToken;
 exports.HttpCode = HttpCode;
 exports.HttpException = HttpException;
+Object.defineProperty(exports, 'InstanceResolverService', {
+  enumerable: true,
+  get: function () {
+    return _InstanceResolverService;
+  }
+});
 exports.InternalServerErrorException = InternalServerErrorException;
 exports.LOG_LEVELS = LOG_LEVELS;
 exports.Logger = Logger;
@@ -7640,6 +8053,7 @@ Object.defineProperty(exports, 'NaviosApplication', {
   }
 });
 exports.NaviosFactory = NaviosFactory;
+exports.NaviosOptionsToken = NaviosOptionsToken;
 exports.NotFoundException = NotFoundException;
 exports.Reply = Reply;
 Object.defineProperty(exports, 'ReplyFactory', {
@@ -7681,6 +8095,7 @@ exports.extractCommandMetadata = extractCommandMetadata;
 exports.extractControllerMetadata = extractControllerMetadata;
 exports.extractModuleMetadata = extractModuleMetadata;
 exports.filterLogLevels = filterLogLevels;
+exports.generateRequestId = generateRequestId;
 exports.getAllEndpointMetadata = getAllEndpointMetadata;
 exports.getCliModuleMetadata = getCliModuleMetadata;
 exports.getCommandMetadata = getCommandMetadata;
@@ -7707,14 +8122,14 @@ exports.isUndefined = isUndefined;
 exports.loggerOptionsSchema = loggerOptionsSchema;
 exports.normalizePath = normalizePath;
 exports.provideConfig = provideConfig;
-exports.requestIdStore = requestIdStore;
 exports.runWithRequestId = runWithRequestId;
+exports.setRequestIdEnabled = setRequestIdEnabled;
 exports.stripEndSlash = stripEndSlash;
 exports.yellow = yellow;
-Object.keys(__navios_di).forEach(function (k) {
+Object.keys(_navios_di).forEach(function (k) {
   if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
     enumerable: true,
-    get: function () { return __navios_di[k]; }
+    get: function () { return _navios_di[k]; }
   });
 });