@navios/core 0.9.3 → 1.0.0-alpha.2

package/lib/{src-Baabu2R8.mjs → src-K2k0riYJ.mjs}

@@ -1,7 +1,7 @@
-import { C as extractModuleMetadata, M as getEndpointMetadata, O as getControllerMetadata, T as hasModuleMetadata, _ as EndpointAdapterToken, b as getManagedMetadata, c as XmlStreamAdapterToken, d as Reply, f as NaviosOptionsToken, k as hasControllerMetadata, l as StreamAdapterToken, m as HttpAdapterToken, p as MultipartAdapterToken, u as Request, w as getModuleMetadata, x as hasManagedMetadata } from "./use-guards.decorator-ChJVzYLW.mjs";
+import { C as extractModuleMetadata, M as getEndpointMetadata, O as getControllerMetadata, T as hasModuleMetadata, _ as EndpointAdapterToken, b as getManagedMetadata, c as XmlStreamAdapterToken, d as Reply, f as NaviosOptionsToken, k as hasControllerMetadata, l as StreamAdapterToken, m as HttpAdapterToken, p as MultipartAdapterToken, u as Request, w as getModuleMetadata, x as hasManagedMetadata } from "./use-guards.decorator-Be_QUx6b.mjs";
 import { Container, Factory, Injectable, InjectableScope, InjectionToken, getInjectableToken, inject } from "@navios/di";
 import { env } from "node:process";
-import z, { z as z$1 } from "zod/v4";
+import z, { ZodError, treeifyError, z as z$1 } from "zod/v4";
 import { NaviosError } from "@navios/builder";
 import { inspect } from "util";
 import { AsyncLocalStorage } from "node:async_hooks";
@@ -201,7 +201,7 @@ function getRequestIdStore() {
 
 //#endregion
 //#region src/logger/console-logger.service.mts
-function applyDecs2203RFactory$14() {
+function applyDecs2203RFactory$19() {
 	function createAddInitializerMethod(initializers, decoratorFinishedRef) {
 		return function addInitializer(initializer) {
 			assertNotFinished(decoratorFinishedRef, "addInitializer");
@@ -475,10 +475,10 @@ 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$19(targetClass, memberDecs, classDecs, parentClass) {
+	return (_apply_decs_2203_r$19 = applyDecs2203RFactory$19())(targetClass, memberDecs, classDecs, parentClass);
 }
-var _dec$14, _initClass$14;
+var _dec$19, _initClass$19;
 const DEFAULT_DEPTH = 5;
 const DEFAULT_LOG_LEVELS = [
 	"log",
@@ -497,10 +497,10 @@ const dateTimeFormatter = new Intl.DateTimeFormat(void 0, {
 	month: "2-digit"
 });
 let _ConsoleLogger;
-_dec$14 = Injectable({ token: LoggerOutput });
+_dec$19 = Injectable({ token: LoggerOutput });
 var ConsoleLogger = class {
 	static {
-		({c: [_ConsoleLogger, _initClass$14]} = _apply_decs_2203_r$14(this, [], [_dec$14]));
+		({c: [_ConsoleLogger, _initClass$19]} = _apply_decs_2203_r$19(this, [], [_dec$19]));
 	}
 	/**
 	* The options of the logger.
@@ -749,13 +749,13 @@ var ConsoleLogger = class {
 		}
 	}
 	static {
-		_initClass$14();
+		_initClass$19();
 	}
 };
 
 //#endregion
 //#region src/logger/logger.service.mts
-function applyDecs2203RFactory$13() {
+function applyDecs2203RFactory$18() {
 	function createAddInitializerMethod(initializers, decoratorFinishedRef) {
 		return function addInitializer(initializer) {
 			assertNotFinished(decoratorFinishedRef, "addInitializer");
@@ -1029,15 +1029,15 @@ 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$18(targetClass, memberDecs, classDecs, parentClass) {
+	return (_apply_decs_2203_r$18 = applyDecs2203RFactory$18())(targetClass, memberDecs, classDecs, parentClass);
 }
-var _dec$13, _initClass$13;
+var _dec$18, _initClass$18;
 let _LoggerInstance;
-_dec$13 = Injectable({ token: Logger });
+_dec$18 = Injectable({ token: Logger });
 var LoggerInstance = class {
 	static {
-		({c: [_LoggerInstance, _initClass$13]} = _apply_decs_2203_r$13(this, [], [_dec$13]));
+		({c: [_LoggerInstance, _initClass$18]} = _apply_decs_2203_r$18(this, [], [_dec$18]));
 	}
 	constructor(config = {}) {
 		this.context = config.context;
@@ -1069,13 +1069,13 @@ var LoggerInstance = class {
 		this.localInstance?.fatal?.(message, ...optionalParams);
 	}
 	static {
-		_initClass$13();
+		_initClass$18();
 	}
 };
 
 //#endregion
 //#region src/config/config.service.mts
-function applyDecs2203RFactory$12() {
+function applyDecs2203RFactory$17() {
 	function createAddInitializerMethod(initializers, decoratorFinishedRef) {
 		return function addInitializer(initializer) {
 			assertNotFinished(decoratorFinishedRef, "addInitializer");
@@ -1349,10 +1349,10 @@ 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$17(targetClass, memberDecs, classDecs, parentClass) {
+	return (_apply_decs_2203_r$17 = applyDecs2203RFactory$17())(targetClass, memberDecs, classDecs, parentClass);
 }
-var _dec$12, _initClass$12;
+var _dec$17, _initClass$17;
 /**
 * Schema for validating configuration service options.
 */ const ConfigServiceOptionsSchema = z$1.record(z$1.string(), z$1.unknown());
@@ -1360,11 +1360,11 @@ var _dec$12, _initClass$12;
 * Injection token for ConfigService.
 */ const ConfigServiceToken = InjectionToken.create(Symbol.for("ConfigService"), ConfigServiceOptionsSchema);
 let _ConfigService;
-_dec$12 = Injectable({ token: ConfigServiceToken });
+_dec$17 = Injectable({ token: ConfigServiceToken });
 var ConfigService = class {
 	config;
 	static {
-		({c: [_ConfigService, _initClass$12]} = _apply_decs_2203_r$12(this, [], [_dec$12]));
+		({c: [_ConfigService, _initClass$17]} = _apply_decs_2203_r$17(this, [], [_dec$17]));
 	}
 	/**
 	* Creates a new ConfigService instance.
@@ -1446,7 +1446,7 @@ var ConfigService = class {
 		return value;
 	}
 	static {
-		_initClass$12();
+		_initClass$17();
 	}
 };
 
@@ -1707,8 +1707,114 @@ var ConfigService = class {
 };
 
 //#endregion
-//#region src/services/instance-resolver.service.mts
-function applyDecs2203RFactory$11() {
+//#region src/responders/enums/framework-error.enum.mts
+/**
+* Enumeration of framework-level error types.
+* Used to explicitly specify which error responder should handle an error.
+*
+* @example
+* ```typescript
+* // In adapter error handling
+* if (error instanceof ZodError) {
+*   return errorProducer.respond(FrameworkError.ValidationError, error)
+* }
+* return errorProducer.handleUnknown(error)
+* ```
+*/ var FrameworkError = /* @__PURE__ */ function(FrameworkError$1) {
+	/**
+	* Resource not found (HTTP 404).
+	* Use when a requested resource does not exist.
+	*/ FrameworkError$1["NotFound"] = "NotFound";
+	/**
+	* Forbidden (HTTP 403).
+	* Use when access to a resource is denied (e.g., guard rejection).
+	*/ FrameworkError$1["Forbidden"] = "Forbidden";
+	/**
+	* Internal server error (HTTP 500).
+	* Use for unexpected errors that don't fit other categories.
+	*/ FrameworkError$1["InternalServerError"] = "InternalServerError";
+	/**
+	* Validation error (HTTP 400).
+	* Use when request data fails validation (e.g., Zod errors).
+	*/ FrameworkError$1["ValidationError"] = "ValidationError";
+	return FrameworkError$1;
+}({});
+
+//#endregion
+//#region src/responders/tokens/responder.tokens.mts
+/**
+* Injection token for the Internal Server Error responder.
+* Default implementation returns HTTP 500 with RFC 7807 Problem Details.
+*
+* @example Override with custom implementation:
+* ```typescript
+* @Injectable({
+*   token: InternalServerErrorResponderToken,
+*   priority: 0, // Higher than default -10
+* })
+* export class CustomInternalErrorResponder implements ErrorResponder {
+*   getResponse(error: unknown, description?: string): ErrorResponse {
+*     // Custom implementation
+*   }
+* }
+* ```
+*/ const InternalServerErrorResponderToken = InjectionToken.create("InternalServerErrorResponder");
+/**
+* Injection token for the Not Found responder.
+* Default implementation returns HTTP 404 with RFC 7807 Problem Details.
+*
+* @example Override with custom implementation:
+* ```typescript
+* @Injectable({
+*   token: NotFoundResponderToken,
+*   priority: 0, // Higher than default -10
+* })
+* export class CustomNotFoundResponder implements ErrorResponder {
+*   getResponse(error: unknown, description?: string): ErrorResponse {
+*     // Custom implementation
+*   }
+* }
+* ```
+*/ const NotFoundResponderToken = InjectionToken.create("NotFoundResponder");
+/**
+* Injection token for the Validation Error responder.
+* Default implementation returns HTTP 400 with RFC 7807 Problem Details
+* and includes validation errors from ZodError.
+*
+* @example Override with custom implementation:
+* ```typescript
+* @Injectable({
+*   token: ValidationErrorResponderToken,
+*   priority: 0, // Higher than default -10
+* })
+* export class CustomValidationResponder implements ErrorResponder {
+*   getResponse(error: unknown, description?: string): ErrorResponse {
+*     // Custom implementation
+*   }
+* }
+* ```
+*/ const ValidationErrorResponderToken = InjectionToken.create("ValidationErrorResponder");
+/**
+* Injection token for the Forbidden responder.
+* Default implementation returns HTTP 403 with RFC 7807 Problem Details.
+*
+* @example Override with custom implementation:
+* ```typescript
+* @Injectable({
+*   token: ForbiddenResponderToken,
+*   priority: 0, // Higher than default -10
+* })
+* export class CustomForbiddenResponder implements ErrorResponder {
+*   getResponse(error: unknown, description?: string): ErrorResponse {
+*     // Custom implementation
+*   }
+* }
+* ```
+*/ const ForbiddenResponderToken = InjectionToken.create("ForbiddenResponder");
+
+//#endregion
+//#region src/responders/services/error-response-producer.service.mts
+function applyDecs2203RFactory$16() {
 	function createAddInitializerMethod(initializers, decoratorFinishedRef) {
 		return function addInitializer(initializer) {
 			assertNotFinished(decoratorFinishedRef, "addInitializer");
@@ -1982,87 +2088,91 @@ 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$16(targetClass, memberDecs, classDecs, parentClass) {
+	return (_apply_decs_2203_r$16 = applyDecs2203RFactory$16())(targetClass, memberDecs, classDecs, parentClass);
 }
-var _dec$11, _initClass$11;
-let _InstanceResolverService;
-_dec$11 = Injectable();
-var InstanceResolverService = class {
+var _dec$16, _initClass$16;
+let _ErrorResponseProducerService;
+_dec$16 = Injectable();
+var ErrorResponseProducerService = class {
 	static {
-		({c: [_InstanceResolverService, _initClass$11]} = _apply_decs_2203_r$11(this, [], [_dec$11]));
+		({c: [_ErrorResponseProducerService, _initClass$16]} = _apply_decs_2203_r$16(this, [], [_dec$16]));
 	}
-	container = inject(Container);
+	forbiddenResponder = inject(ForbiddenResponderToken);
+	internalServerErrorResponder = inject(InternalServerErrorResponderToken);
+	notFoundResponder = inject(NotFoundResponderToken);
+	validationErrorResponder = inject(ValidationErrorResponderToken);
 	/**
-	* Attempts to resolve a class instance, automatically detecting if it needs
-	* request scope based on its dependencies.
+	* Produces an error response for a specific framework error type.
 	*
-	* @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 = getInjectableToken(classType);
-			this.container.getRegistry().updateScope(token, InjectableScope.Request);
+	* @param type - The type of framework error (from FrameworkError enum)
+	* @param error - The original error that was thrown
+	* @param description - Optional custom description to include in the response
+	* @returns ErrorResponse with status code, RFC 7807 payload, and headers
+	*/ respond(type, error, description) {
+		switch (type) {
+			case FrameworkError.NotFound: return this.notFoundResponder.getResponse(error, description);
+			case FrameworkError.Forbidden: return this.forbiddenResponder.getResponse(error, description);
+			case FrameworkError.InternalServerError: return this.internalServerErrorResponder.getResponse(error, description);
+			case FrameworkError.ValidationError: return this.validationErrorResponder.getResponse(error, description);
 		}
-		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.
+	* Handles unknown errors by producing an Internal Server Error response.
 	*
-	* Returns `cached: true` only if ALL classes can be resolved as singletons.
-	* If any class has request-scoped dependencies, returns `cached: false`.
+	* Use this as a fallback when the error type is not known or doesn't
+	* match any specific framework error type.
 	*
-	* @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 = getInjectableToken(classType);
-				this.container.getRegistry().updateScope(token, 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)))
-		};
+	* @param error - The original error that was thrown
+	* @param description - Optional custom description to include in the response
+	* @returns ErrorResponse with 500 status code
+	*/ handleUnknown(error, description) {
+		return this.internalServerErrorResponder.getResponse(error, description);
+	}
+	/**
+	* Convenience method to produce a Not Found error response.
+	*
+	* @param error - The original error that was thrown
+	* @param description - Optional custom description
+	* @returns ErrorResponse with 404 status code
+	*/ notFound(error, description) {
+		return this.notFoundResponder.getResponse(error, description);
+	}
+	/**
+	* Convenience method to produce a Validation Error response.
+	*
+	* @param error - The original error (typically a ZodError)
+	* @param description - Optional custom description
+	* @returns ErrorResponse with 400 status code
+	*/ validationError(error, description) {
+		return this.validationErrorResponder.getResponse(error, description);
+	}
+	/**
+	* Convenience method to produce an Internal Server Error response.
+	*
+	* @param error - The original error
+	* @param description - Optional custom description
+	* @returns ErrorResponse with 500 status code
+	*/ internalServerError(error, description) {
+		return this.internalServerErrorResponder.getResponse(error, description);
+	}
+	/**
+	* Convenience method to produce a Forbidden error response.
+	*
+	* @param error - The original error
+	* @param description - Optional custom description
+	* @returns ErrorResponse with 403 status code
+	*/ forbidden(error, description) {
+		return this.forbiddenResponder.getResponse(error, description);
 	}
 	static {
-		_initClass$11();
+		_initClass$16();
 	}
 };
-/**
-* @deprecated Use InstanceResolverService instead
-*/ const ControllerResolverService = _InstanceResolverService;
 
 //#endregion
-//#region src/services/guard-runner.service.mts
-function applyDecs2203RFactory$10() {
+//#region src/responders/services/forbidden-responder.service.mts
+function applyDecs2203RFactory$15() {
 	function createAddInitializerMethod(initializers, decoratorFinishedRef) {
 		return function addInitializer(initializer) {
 			assertNotFinished(decoratorFinishedRef, "addInitializer");
@@ -2336,77 +2446,46 @@ function applyDecs2203RFactory$10() {
 		};
 	};
 }
-function _apply_decs_2203_r$10(targetClass, memberDecs, classDecs, parentClass) {
-	return (_apply_decs_2203_r$10 = applyDecs2203RFactory$10())(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$10, _initClass$10;
-let _GuardRunnerService;
-_dec$10 = Injectable();
-var GuardRunnerService = class {
+var _dec$15, _initClass$15;
+let _ForbiddenResponderService;
+_dec$15 = Injectable({
+	token: ForbiddenResponderToken,
+	priority: -10
+});
+var ForbiddenResponderService = class {
 	static {
-		({c: [_GuardRunnerService, _initClass$10]} = _apply_decs_2203_r$10(this, [], [_dec$10]));
-	}
-	logger = 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()`);
-			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);
+		({c: [_ForbiddenResponderService, _initClass$15]} = _apply_decs_2203_r$15(this, [], [_dec$15]));
 	}
-	/**
-	* 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) {
-			executionContext.getReply().status(403).send({ message: "Forbidden" });
-			return false;
+	getResponse(error, description) {
+		if (description) return this.createResponse(description);
+		if (error && typeof error === "object" && "response" in error && error.response) {
+			if (typeof error.response === "string") return this.createResponse(error.response);
 		}
-		return canActivate;
+		return this.createResponse("Access to this resource is forbidden");
 	}
-	makeContext(moduleMetadata, controllerMetadata, endpoint) {
-		const guards = /* @__PURE__ */ new Set();
-		const endpointGuards = endpoint.guards;
-		const controllerGuards = controllerMetadata.guards;
-		const moduleGuards = moduleMetadata.guards;
-		if (endpointGuards.size > 0) for (const guard of endpointGuards) guards.add(guard);
-		if (controllerGuards.size > 0) for (const guard of controllerGuards) guards.add(guard);
-		if (moduleGuards.size > 0) for (const guard of moduleGuards) guards.add(guard);
-		return guards;
+	createResponse(detail) {
+		return {
+			statusCode: 403,
+			payload: {
+				type: "about:blank",
+				title: "Forbidden",
+				status: 403,
+				detail
+			},
+			headers: { "Content-Type": "application/problem+json" }
+		};
 	}
 	static {
-		_initClass$10();
+		_initClass$15();
 	}
 };
 
 //#endregion
-//#region src/services/module-loader.service.mts
-function applyDecs2203RFactory$9() {
+//#region src/responders/services/internal-server-error-responder.service.mts
+function applyDecs2203RFactory$14() {
 	function createAddInitializerMethod(initializers, decoratorFinishedRef) {
 		return function addInitializer(initializer) {
 			assertNotFinished(decoratorFinishedRef, "addInitializer");
@@ -2680,63 +2759,1702 @@ function applyDecs2203RFactory$9() {
 		};
 	};
 }
-function _apply_decs_2203_r$9(targetClass, memberDecs, classDecs, parentClass) {
-	return (_apply_decs_2203_r$9 = applyDecs2203RFactory$9())(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$9, _initClass$9;
-let _ModuleLoaderService;
-_dec$9 = Injectable();
-var ModuleLoaderService = class {
+var _dec$14, _initClass$14;
+let _InternalServerErrorResponderService;
+_dec$14 = Injectable({
+	token: InternalServerErrorResponderToken,
+	priority: -10
+});
+var InternalServerErrorResponderService = class {
 	static {
-		({c: [_ModuleLoaderService, _initClass$9]} = _apply_decs_2203_r$9(this, [], [_dec$9]));
+		({c: [_InternalServerErrorResponderService, _initClass$14]} = _apply_decs_2203_r$14(this, [], [_dec$14]));
 	}
-	logger = inject(Logger, { context: _ModuleLoaderService.name });
-	container = inject(Container);
-	modulesMetadata = /* @__PURE__ */ new Map();
-	loadedModules = /* @__PURE__ */ new Map();
-	initialized = false;
-	async loadModules(appModule) {
-		if (this.initialized) return;
-		await this.traverseModules(appModule);
-		this.initialized = true;
+	getResponse(error, description) {
+		const message = error instanceof Error ? error.message : "Internal Server Error";
+		return {
+			statusCode: 500,
+			payload: {
+				type: "about:blank",
+				title: "Internal Server Error",
+				status: 500,
+				detail: description ?? message
+			},
+			headers: { "Content-Type": "application/problem+json" }
+		};
 	}
-	/**
-	* 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");
+	static {
+		_initClass$14();
 	}
-	/**
-	* 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),
+};
+
+//#endregion
+//#region src/responders/services/not-found-responder.service.mts
+function applyDecs2203RFactory$13() {
+	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$13(targetClass, memberDecs, classDecs, parentClass) {
+	return (_apply_decs_2203_r$13 = applyDecs2203RFactory$13())(targetClass, memberDecs, classDecs, parentClass);
+}
+var _dec$13, _initClass$13;
+let _NotFoundResponderService;
+_dec$13 = Injectable({
+	token: NotFoundResponderToken,
+	priority: -10
+});
+var NotFoundResponderService = class {
+	static {
+		({c: [_NotFoundResponderService, _initClass$13]} = _apply_decs_2203_r$13(this, [], [_dec$13]));
+	}
+	getResponse(error, description) {
+		if (description) return this.createResponse(description);
+		if (error && typeof error === "object" && "response" in error && error.response) {
+			if (typeof error.response === "string") return this.createResponse(error.response);
+		}
+		return this.createResponse("The requested resource was not found");
+	}
+	createResponse(detail) {
+		return {
+			statusCode: 404,
+			payload: {
+				type: "about:blank",
+				title: "Not Found",
+				status: 404,
+				detail
+			},
+			headers: { "Content-Type": "application/problem+json" }
+		};
+	}
+	static {
+		_initClass$13();
+	}
+};
+
+//#endregion
+//#region src/responders/services/validation-error-responder.service.mts
+function applyDecs2203RFactory$12() {
+	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$12(targetClass, memberDecs, classDecs, parentClass) {
+	return (_apply_decs_2203_r$12 = applyDecs2203RFactory$12())(targetClass, memberDecs, classDecs, parentClass);
+}
+var _dec$12, _initClass$12;
+let _ValidationErrorResponderService;
+_dec$12 = Injectable({
+	token: ValidationErrorResponderToken,
+	priority: -10
+});
+var ValidationErrorResponderService = class {
+	static {
+		({c: [_ValidationErrorResponderService, _initClass$12]} = _apply_decs_2203_r$12(this, [], [_dec$12]));
+	}
+	getResponse(error, description) {
+		if (error instanceof ZodError) return {
+			statusCode: 400,
+			payload: {
+				type: "about:blank",
+				title: "Validation Error",
+				status: 400,
+				detail: description ?? "Request validation failed",
+				errors: treeifyError(error)
+			},
+			headers: { "Content-Type": "application/problem+json" }
+		};
+		return {
+			statusCode: 400,
+			payload: {
+				type: "about:blank",
+				title: "Validation Error",
+				status: 400,
+				detail: description ?? (error instanceof Error ? error.message : "Validation failed")
+			},
+			headers: { "Content-Type": "application/problem+json" }
+		};
+	}
+	static {
+		_initClass$12();
+	}
+};
+
+//#endregion
+//#region src/services/instance-resolver.service.mts
+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 = Injectable();
+var InstanceResolverService = class {
+	static {
+		({c: [_InstanceResolverService, _initClass$11]} = _apply_decs_2203_r$11(this, [], [_dec$11]));
+	}
+	container = inject(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 = getInjectableToken(classType);
+			this.container.getRegistry().updateScope(token, 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 = getInjectableToken(classType);
+				this.container.getRegistry().updateScope(token, 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;
+
+//#endregion
+//#region src/services/guard-runner.service.mts
+function applyDecs2203RFactory$10() {
+	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$10(targetClass, memberDecs, classDecs, parentClass) {
+	return (_apply_decs_2203_r$10 = applyDecs2203RFactory$10())(targetClass, memberDecs, classDecs, parentClass);
+}
+var _dec$10, _initClass$10;
+let _GuardRunnerService;
+_dec$10 = Injectable();
+var GuardRunnerService = class {
+	static {
+		({c: [_GuardRunnerService, _initClass$10]} = _apply_decs_2203_r$10(this, [], [_dec$10]));
+	}
+	errorProducer = inject(_ErrorResponseProducerService);
+	logger = 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()`);
+			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);
+				const errorResponse = this.errorProducer.respond(FrameworkError.InternalServerError, error);
+				executionContext.getReply().status(errorResponse.statusCode).send(errorResponse.payload);
+				return false;
+			}
+		}
+		if (!canActivate) {
+			const errorResponse = this.errorProducer.respond(FrameworkError.Forbidden, null);
+			executionContext.getReply().status(errorResponse.statusCode).send(errorResponse.payload);
+			return false;
+		}
+		return canActivate;
+	}
+	makeContext(moduleMetadata, controllerMetadata, endpoint) {
+		const guards = /* @__PURE__ */ new Set();
+		const endpointGuards = endpoint.guards;
+		const controllerGuards = controllerMetadata.guards;
+		const moduleGuards = moduleMetadata.guards;
+		if (endpointGuards.size > 0) for (const guard of endpointGuards) guards.add(guard);
+		if (controllerGuards.size > 0) for (const guard of controllerGuards) guards.add(guard);
+		if (moduleGuards.size > 0) for (const guard of moduleGuards) guards.add(guard);
+		return guards;
+	}
+	static {
+		_initClass$10();
+	}
+};
+
+//#endregion
+//#region src/services/module-loader.service.mts
+function applyDecs2203RFactory$9() {
+	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$9(targetClass, memberDecs, classDecs, parentClass) {
+	return (_apply_decs_2203_r$9 = applyDecs2203RFactory$9())(targetClass, memberDecs, classDecs, parentClass);
+}
+var _dec$9, _initClass$9;
+let _ModuleLoaderService;
+_dec$9 = Injectable();
+var ModuleLoaderService = class {
+	static {
+		({c: [_ModuleLoaderService, _initClass$9]} = _apply_decs_2203_r$9(this, [], [_dec$9]));
+	}
+	logger = inject(Logger, { context: _ModuleLoaderService.name });
+	container = inject(Container);
+	modulesMetadata = /* @__PURE__ */ new Map();
+	loadedModules = /* @__PURE__ */ new Map();
+	initialized = false;
+	async loadModules(appModule) {
+		if (this.initialized) return;
+		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(),
+				overrides: /* @__PURE__ */ new Set(),
 				customAttributes: /* @__PURE__ */ new Map()
 			};
 			this.modulesMetadata.set(moduleName, metadata);
@@ -2753,6 +4471,7 @@ var ModuleLoaderService = class {
 			const imports = metadata.imports ?? /* @__PURE__ */ new Set();
 			const loadingPromises = Array.from(imports).map(async (importedModule) => this.traverseModules(importedModule, metadata));
 			await Promise.all(loadingPromises);
+			this.validateOverrides(metadata, moduleName);
 			const instance = await this.container.get(module);
 			if (instance.onModuleInit) await instance.onModuleInit();
 			this.logger.debug(`Module ${moduleName} loaded`);
@@ -2762,6 +4481,26 @@ var ModuleLoaderService = class {
 			throw error;
 		}
 	}
+	validateOverrides(metadata, moduleName) {
+		if (!metadata.overrides || metadata.overrides.size === 0) return;
+		const registry = this.container.getRegistry();
+		for (const overrideClass of metadata.overrides) try {
+			const overrideToken = getInjectableToken(overrideClass);
+			const allRegistrations = registry.getAll(overrideToken);
+			if (allRegistrations.length === 0) {
+				this.logger.warn(`[Navios] Override ${overrideClass.name} in module ${moduleName} is not registered. Make sure it has @Injectable decorator.`);
+				continue;
+			}
+			const highestPriorityRegistration = allRegistrations[0];
+			if (highestPriorityRegistration.target !== overrideClass) {
+				const overrideRegistration = allRegistrations.find((r) => r.target === overrideClass);
+				if (!overrideRegistration) this.logger.warn(`[Navios] Override ${overrideClass.name} in module ${moduleName} is registered but not found in registry for token ${overrideToken.toString()}.`);
+				else this.logger.warn(`[Navios] Override ${overrideClass.name} in module ${moduleName} is not active. Current active service: ${highestPriorityRegistration.target.name} (priority: ${highestPriorityRegistration.priority}). Override priority: ${overrideRegistration.priority}. Override needs higher priority to take effect.`);
+			} else this.logger.debug(`[Navios] Override ${overrideClass.name} in module ${moduleName} is active (priority: ${highestPriorityRegistration.priority})`);
+		} catch (error) {
+			this.logger.warn(`[Navios] Failed to validate override ${overrideClass.name} in module ${moduleName}: ${error}`);
+		}
+	}
 	mergeMetadata(metadata, parentMetadata) {
 		if (parentMetadata.guards) for (const guard of parentMetadata.guards) metadata.guards.add(guard);
 		if (parentMetadata.customAttributes) for (const [key, value] of parentMetadata.customAttributes) {
@@ -5844,5 +7583,5 @@ var NaviosApplication = class {
 };
 
 //#endregion
-export { LOG_LEVELS as $, Logger as A, isFunction as B, EnvConfigProvider as C, _ConfigService as D, ConfigServiceToken as E, runWithRequestId as F, isString as G, isNumber as H, setRequestIdEnabled as I, normalizePath as J, isSymbol as K, addLeadingSlash as L, loggerOptionsSchema as M, generateRequestId as N, _LoggerInstance as O, getRequestId as P, isLogLevel as Q, isConstructor as R, ConfigProviderOptions as S, ConfigServiceOptionsSchema as T, isObject as U, isNil as V, isPlainObject as W, isLogLevelEnabled as X, stripEndSlash as Y, filterLogLevels as Z, NotFoundException as _, _ReplyFactory as a, BadRequestException as b, _HttpAdapterFactory as c, _ModuleLoaderService as d, clc as et, _GuardRunnerService as f, UnauthorizedException as g, ConflictException as h, _StreamAdapterFactory as i, LoggerOutput as j, _ConsoleLogger as k, _EndpointAdapterFactory as l, _InstanceResolverService as m, _NaviosApplication as n, envInt as nt, _RequestFactory as o, ControllerResolverService as p, isUndefined as q, _XmlStreamAdapterFactory as r, envString as rt, _MultipartAdapterFactory as s, NaviosFactory as t, yellow as tt, AttributeFactory as u, InternalServerErrorException as v, provideConfig as w, HttpException as x, ForbiddenException as y, isEmpty as z };
-//# sourceMappingURL=src-Baabu2R8.mjs.map
+export { isObject as $, BadRequestException as A, Logger as B, ValidationErrorResponderToken as C, NotFoundException as D, UnauthorizedException as E, ConfigServiceOptionsSchema as F, runWithRequestId as G, loggerOptionsSchema as H, ConfigServiceToken as I, isConstructor as J, setRequestIdEnabled as K, _ConfigService as L, ConfigProviderOptions as M, EnvConfigProvider as N, InternalServerErrorException as O, provideConfig as P, isNumber as Q, _LoggerInstance as R, NotFoundResponderToken as S, ConflictException as T, generateRequestId as U, LoggerOutput as V, getRequestId as W, isFunction as X, isEmpty as Y, isNil as Z, _InternalServerErrorResponderService as _, _ReplyFactory as a, stripEndSlash as at, ForbiddenResponderToken as b, _HttpAdapterFactory as c, isLogLevel as ct, _ModuleLoaderService as d, yellow as dt, isPlainObject as et, _GuardRunnerService as f, envInt as ft, _NotFoundResponderService as g, _ValidationErrorResponderService as h, _StreamAdapterFactory as i, normalizePath as it, HttpException as j, ForbiddenException as k, _EndpointAdapterFactory as l, LOG_LEVELS as lt, _InstanceResolverService as m, _NaviosApplication as n, isSymbol as nt, _RequestFactory as o, isLogLevelEnabled as ot, ControllerResolverService as p, envString as pt, addLeadingSlash as q, _XmlStreamAdapterFactory as r, isUndefined as rt, _MultipartAdapterFactory as s, filterLogLevels as st, NaviosFactory as t, isString as tt, AttributeFactory as u, clc as ut, _ForbiddenResponderService as v, FrameworkError as w, InternalServerErrorResponderToken as x, _ErrorResponseProducerService as y, _ConsoleLogger as z };
+//# sourceMappingURL=src-K2k0riYJ.mjs.map