@navios/commander 0.7.0 → 0.7.1

package/lib/index.cjs

@@ -32,20 +32,14 @@ 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);
@@ -165,26 +159,26 @@ function hasModuleMetadata(target) {
 */ function Controller({ guards } = {}) {
 	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
+			scope: _navios_di.InjectableScope.Request
 		})(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");
+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.
 *
@@ -308,14 +302,14 @@ 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);
 	};
 }
@@ -474,7 +468,7 @@ const XmlStreamAdapterToken = __navios_di.InjectionToken.create("XmlStreamAdapte
 };
 
 //#endregion
-//#region ../core/lib/src-DzPY5s6d.mjs
+//#region ../core/lib/src-DpPBxmjz.mjs
 function envInt(key, defaultValue) {
 	const envKey = node_process.env[key] || process.env[key];
 	return envKey ? parseInt(envKey, 10) : defaultValue;
@@ -598,7 +592,7 @@ const isSymbol = (val) => typeof val === "symbol";
 * 
 * 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,7 +606,7 @@ 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);
+*/ const Logger = _navios_di.InjectionToken.create("Logger", loggerOptionsSchema);
 function applyDecs2203RFactory$13() {
 	function createAddInitializerMethod(initializers, decoratorFinishedRef) {
 		return function addInitializer(initializer) {
@@ -909,7 +903,7 @@ const dateTimeFormatter = new Intl.DateTimeFormat(void 0, {
 	month: "2-digit"
 });
 let _ConsoleLogger;
-_dec$13 = (0, __navios_di.Injectable)({ token: LoggerOutput });
+_dec$13 = (0, _navios_di.Injectable)({ token: LoggerOutput });
 (class {
 	static {
 		({c: [_ConsoleLogger, _initClass$13]} = _apply_decs_2203_r$13(this, [], [_dec$13]));
@@ -1443,7 +1437,7 @@ function _apply_decs_2203_r$12(targetClass, memberDecs, classDecs, parentClass)
 }
 var _dec$12, _initClass$12;
 let _LoggerInstance;
-_dec$12 = (0, __navios_di.Injectable)({ token: Logger });
+_dec$12 = (0, _navios_di.Injectable)({ token: Logger });
 (class {
 	static {
 		({c: [_LoggerInstance, _initClass$12]} = _apply_decs_2203_r$12(this, [], [_dec$12]));
@@ -1451,7 +1445,7 @@ _dec$12 = (0, __navios_di.Injectable)({ token: Logger });
 	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;
@@ -1764,9 +1758,9 @@ var _dec$11, _initClass$11;
 */ 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$11 = (0, _navios_di.Injectable)({ token: ConfigServiceToken });
 (class {
 	config;
 	static {
@@ -1779,7 +1773,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.
 	*
@@ -1880,7 +1874,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 +1886,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.
 * 
@@ -2366,12 +2360,12 @@ 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 });
+	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()) {
@@ -2690,13 +2684,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;
@@ -3098,7 +3092,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 +3390,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 +3684,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 +3978,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 +4272,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 +4569,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 +4866,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 +5160,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");
@@ -5460,18 +5454,19 @@ function _apply_decs_2203_r$14(targetClass, memberDecs, classDecs, parentClass)
 }
 var _dec$14, _initClass$14;
 let _NaviosApplication;
-_dec$14 = (0, __navios_di.Injectable)();
+_dec$14 = (0, _navios_di.Injectable)();
 (class {
 	static {
 		({c: [_NaviosApplication, _initClass$14]} = _apply_decs_2203_r$14(this, [], [_dec$14]));
 	}
-	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.
@@ -5496,18 +5491,40 @@ _dec$14 = (0, __navios_di.Injectable)();
 		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, {
@@ -5521,6 +5538,7 @@ _dec$14 = (0, __navios_di.Injectable)();
 		await this.moduleLoader.loadModules(this.appModule);
 		if (this.environment.hasHttpSetup()) await this.httpApplication?.setupHttpServer(this.options);
 		await this.initModules();
+		await this.initPlugins();
 		if (this.environment.hasHttpSetup()) await this.httpApplication?.ready();
 		this.isInitialized = true;
 		this.logger.debug("Navios application initialized");
@@ -5529,6 +5547,19 @@ _dec$14 = (0, __navios_di.Injectable)();
 		const modules = this.moduleLoader.getAllModules();
 		await this.httpApplication?.onModulesInit(modules);
 	}
+	async initPlugins() {
+		if (this.plugins.length === 0) return;
+		const context = {
+			modules: this.moduleLoader.getAllModules(),
+			server: this.httpApplication?.getServer() ?? null,
+			container: this.container,
+			globalPrefix: this.httpApplication?.getGlobalPrefix() ?? ""
+		};
+		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.
 	* 
@@ -5700,7 +5731,7 @@ _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();
 		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);
@@ -5716,7 +5747,7 @@ _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 (logger !== true && !isNil(logger)) container.getServiceLocator().getManager().storeCreatedHolder(LoggerOutput.toString(), logger, _navios_di.InjectableType.Class, _navios_di.InjectableScope.Singleton);
 	}
 };
 
@@ -7711,10 +7742,10 @@ exports.requestIdStore = requestIdStore;
 exports.runWithRequestId = runWithRequestId;
 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]; }
   });
 });