@navios/commander 1.0.0 → 1.2.0

package/lib/index.mjs

@@ -1,558 +1,11 @@
-import { AdapterToken, ConsoleLogger, Container, Injectable, InjectableScope, InjectionToken, Logger, Module, NaviosFactory, extractModuleMetadata, getModuleCustomEntry, getModuleMetadata, inject } from "@navios/core";
+import { a as extractCommandMetadata, i as CommandMetadataKey, n as CommandEntryKey, o as getCommandMetadata, r as extractModuleCommands, s as hasCommandMetadata, t as Command } from "./command.decorator-DVLSAqYZ.mjs";
+import { n as _CommandRegistryService, t as HelpCommandToken } from "./help-command.token-C0Kgj60o.mjs";
+import { t as CliModule } from "./cli-module.decorator-UGbtkRYc.mjs";
+import { AdapterToken, ConsoleLogger, Container, Injectable, InjectionToken, Logger, NaviosFactory, inject } from "@navios/core";
 import { z } from "zod";
 
 export * from "@navios/core"
 
-//#region src/metadata/command.metadata.mts
-/**
-* @internal
-* Symbol key used to store command metadata on classes.
-*/ const CommandMetadataKey = Symbol("CommandMetadataKey");
-/**
-* Gets or creates command metadata for a class.
-*
-* @internal
-* @param target - The command class
-* @param context - The decorator context
-* @param path - The command path
-* @param description - Optional description for help text
-* @param optionsSchema - Optional Zod schema
-* @returns The command metadata
-*/ function getCommandMetadata(target, context, path, description, optionsSchema) {
-	if (context.metadata) {
-		const metadata = context.metadata[CommandMetadataKey];
-		if (metadata) return metadata;
-		else {
-			const newMetadata = {
-				path,
-				description,
-				optionsSchema,
-				customAttributes: /* @__PURE__ */ new Map()
-			};
-			context.metadata[CommandMetadataKey] = newMetadata;
-			target[CommandMetadataKey] = newMetadata;
-			return newMetadata;
-		}
-	}
-	throw new Error("[Navios Commander] Wrong environment.");
-}
-/**
-* Extracts command metadata from a class.
-*
-* @param target - The command class
-* @returns The command metadata
-* @throws {Error} If the class is not decorated with @Command
-*
-* @example
-* ```typescript
-* const metadata = extractCommandMetadata(GreetCommand)
-* console.log(metadata.path) // 'greet'
-* ```
-*/ function extractCommandMetadata(target) {
-	const metadata = target[CommandMetadataKey];
-	if (!metadata) throw new Error("[Navios Commander] Command metadata not found. Make sure to use @Command decorator.");
-	return metadata;
-}
-/**
-* Checks if a class has command metadata.
-*
-* @param target - The class to check
-* @returns `true` if the class is decorated with @Command, `false` otherwise
-*/ function hasCommandMetadata(target) {
-	return !!target[CommandMetadataKey];
-}
-
-//#endregion
-//#region src/metadata/command-entry.metadata.mts
-/**
-* Symbol key for storing commands in ModuleMetadata.customEntries.
-* Used by @CliModule to store command classes.
-*
-* @public
-*/ const CommandEntryKey = Symbol("CommandEntryKey");
-/**
-* Extracts commands from a module's metadata.
-* Returns empty set if no commands are defined.
-*
-* @param moduleClass - The module class decorated with @CliModule or @Module
-* @returns Set of command classes registered in the module
-*
-* @example
-* ```typescript
-* const commands = extractModuleCommands(AppModule)
-* for (const command of commands) {
-*   console.log(command.name)
-* }
-* ```
-*/ function extractModuleCommands(moduleClass) {
-	return extractModuleMetadata(moduleClass).customEntries.get(CommandEntryKey) ?? /* @__PURE__ */ new Set();
-}
-
-//#endregion
-//#region src/decorators/command.decorator.mts
-/**
-* Decorator that marks a class as a CLI command.
-*
-* The decorated class must implement the `CommandHandler` interface with an `execute` method.
-* The command will be automatically registered when its module is loaded.
-*
-* @param options - Configuration options for the command
-* @returns A class decorator function
-*
-* @example
-* ```typescript
-* import { Command, CommandHandler } from '@navios/commander'
-* import { z } from 'zod'
-*
-* const optionsSchema = z.object({
-*   name: z.string(),
-*   greeting: z.string().optional().default('Hello')
-* })
-*
-* @Command({
-*   path: 'greet',
-*   optionsSchema: optionsSchema
-* })
-* export class GreetCommand implements CommandHandler<z.infer<typeof optionsSchema>> {
-*   async execute(options) {
-*     console.log(`${options.greeting}, ${options.name}!`)
-*   }
-* }
-* ```
-*/ function Command({ path, description, optionsSchema, priority, registry }) {
-	return function(target, context) {
-		if (context.kind !== "class") throw new Error("[Navios Commander] @Command decorator can only be used on classes.");
-		const token = InjectionToken.create(target);
-		if (context.metadata) getCommandMetadata(target, context, path, description, optionsSchema);
-		return Injectable({
-			token,
-			scope: InjectableScope.Singleton,
-			priority,
-			registry
-		})(target, context);
-	};
-}
-
-//#endregion
-//#region src/services/command-registry.service.mts
-function applyDecs2203RFactory$3() {
-	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$3(targetClass, memberDecs, classDecs, parentClass) {
-	return (_apply_decs_2203_r$3 = applyDecs2203RFactory$3())(targetClass, memberDecs, classDecs, parentClass);
-}
-var _dec$3, _initClass$3;
-let _CommandRegistryService;
-_dec$3 = Injectable();
-var CommandRegistryService = class {
-	static {
-		({c: [_CommandRegistryService, _initClass$3]} = _apply_decs_2203_r$3(this, [], [_dec$3]));
-	}
-	commands = /* @__PURE__ */ new Map();
-	/**
-	* Register a command with its metadata.
-	*
-	* @param path - The command path (e.g., 'greet', 'user:create')
-	* @param command - The registered command data
-	* @throws Error if a command with the same path is already registered
-	*/ register(path, command) {
-		if (this.commands.has(path)) throw new Error(`[Navios Commander] Duplicate command path: ${path}`);
-		this.commands.set(path, command);
-	}
-	/**
-	* Get a command by its path.
-	*
-	* @param path - The command path
-	* @returns The registered command or undefined if not found
-	*/ getByPath(path) {
-		return this.commands.get(path);
-	}
-	/**
-	* Get all registered commands.
-	*
-	* @returns Map of path to registered command
-	*/ getAll() {
-		return new Map(this.commands);
-	}
-	/**
-	* Get all registered commands as an array of path and class pairs.
-	* Useful for listing available commands.
-	*
-	* @returns Array of objects containing path and class
-	*/ getAllAsArray() {
-		const result = [];
-		for (const [path, { class: cls }] of this.commands) result.push({
-			path,
-			class: cls
-		});
-		return result;
-	}
-	/**
-	* Formats help text listing all available commands with descriptions.
-	*
-	* @returns Formatted string listing all commands
-	*/ formatCommandList() {
-		const lines = ["Available commands:", ""];
-		for (const [path, { metadata }] of this.commands) {
-			const description = metadata.description;
-			if (description) lines.push(`  ${path.padEnd(20)} ${description}`);
-			else lines.push(`  ${path}`);
-		}
-		return lines.join("\n");
-	}
-	/**
-	* Formats help text for a specific command.
-	*
-	* @param commandPath - The command path to show help for
-	* @returns Formatted string with command help
-	*/ formatCommandHelp(commandPath) {
-		const command = this.commands.get(commandPath);
-		if (!command) return `Unknown command: ${commandPath}\n\n${this.formatCommandList()}`;
-		const { metadata } = command;
-		const lines = [];
-		lines.push(`Usage: ${metadata.path} [options]`);
-		lines.push("");
-		if (metadata.description) {
-			lines.push(metadata.description);
-			lines.push("");
-		}
-		if (metadata.optionsSchema) {
-			lines.push("Options:");
-			try {
-				const shape = metadata.optionsSchema.def.shape;
-				if (shape && typeof shape === "object") for (const [key, fieldSchema] of Object.entries(shape)) {
-					const optionFlag = `--${key.replace(/([A-Z])/g, "-$1").toLowerCase()}`;
-					const fieldType = this.getSchemaTypeName(fieldSchema);
-					lines.push(`  ${optionFlag.padEnd(20)} ${fieldType}`);
-				}
-			} catch {}
-		}
-		return lines.join("\n");
-	}
-	/**
-	* Gets a human-readable type name from a Zod schema.
-	*/ getSchemaTypeName(schema) {
-		try {
-			let currentSchema = schema;
-			let typeName = currentSchema?.def?.type;
-			let isOptional = false;
-			let defaultValue;
-			while (typeName === "optional" || typeName === "default") {
-				if (typeName === "optional") isOptional = true;
-				if (typeName === "default") {
-					isOptional = true;
-					defaultValue = currentSchema?.def?.defaultValue?.();
-				}
-				currentSchema = currentSchema?.def?.innerType;
-				typeName = currentSchema?.def?.type;
-			}
-			let result = `<${typeName || "unknown"}>`;
-			if (defaultValue !== void 0) result += ` (default: ${JSON.stringify(defaultValue)})`;
-			else if (isOptional) result += " (optional)";
-			const description = this.getSchemaMeta(schema)?.description;
-			if (description) result += ` - ${description}`;
-			return result;
-		} catch {
-			return "<unknown>";
-		}
-	}
-	/**
-	* Gets metadata from a Zod schema, traversing innerType if needed.
-	* Zod v4 stores meta at the outermost layer when .meta() is called last,
-	* or in innerType when .meta() is called before .optional()/.default().
-	*/ getSchemaMeta(schema) {
-		try {
-			const directMeta = schema.meta?.();
-			if (directMeta) return directMeta;
-			const innerType = schema.def?.innerType;
-			if (innerType) return this.getSchemaMeta(innerType);
-			return;
-		} catch {
-			return;
-		}
-	}
-	/**
-	* Clear all registered commands.
-	*/ clear() {
-		this.commands.clear();
-	}
-	static {
-		_initClass$3();
-	}
-};
-
-//#endregion
 //#region src/commands/help.command.mts
 function applyDecs2203RFactory$2() {
 	function createAddInitializerMethod(initializers, decoratorFinishedRef) {
@@ -835,6 +288,7 @@ var _dec$2, _initClass$2;
 const helpOptionsSchema = z.object({ command: z.string().optional() });
 let _HelpCommand;
 _dec$2 = Command({
+	token: HelpCommandToken,
 	path: "help",
 	description: "Show available commands or help for a specific command",
 	optionsSchema: helpOptionsSchema
@@ -1883,6 +1337,31 @@ var CommanderAdapterService = class {
 	* await adapter.run(process.argv)
 	* ```
 	*/ static async create(appModule, options = {}) {
+		if (options.enableTUI) {
+			let tuiModule;
+			try {
+				tuiModule = await import("@navios/commander-tui");
+			} catch {
+				throw new Error("TUI mode requires @navios/commander-tui package. Install it with: npm install @navios/commander-tui");
+			}
+			const { overrideConsoleLogger, ScreenManager } = tuiModule;
+			overrideConsoleLogger(options.tuiOptions?.hideDefaultScreen ?? false);
+			if (options.tuiOptions?.hideDefaultScreen) await import("./help.command-dtZbhq0w.mjs");
+			const app = await NaviosFactory.create(appModule, {
+				adapter: defineCliEnvironment(),
+				logger: options.logLevels
+			});
+			await (await app.get(ScreenManager)).bind({
+				exitOnCtrlC: options.tuiOptions?.exitOnCtrlC,
+				sidebarWidth: options.tuiOptions?.sidebarWidth,
+				sidebarPosition: options.tuiOptions?.sidebarPosition,
+				sidebarTitle: options.tuiOptions?.sidebarTitle,
+				autoClose: options.tuiOptions?.autoClose,
+				theme: options.tuiOptions?.theme,
+				useMouse: options.tuiOptions?.useMouse
+			});
+			return app;
+		}
 		return await NaviosFactory.create(appModule, {
 			adapter: defineCliEnvironment(),
 			logger: ConsoleLogger.create({
@@ -1898,67 +1377,6 @@ var CommanderAdapterService = class {
 	}
 };
 
-//#endregion
-//#region src/decorators/cli-module.decorator.mts
-/**
-* Decorator that marks a class as a CLI module.
-*
-* This decorator extends the standard @Module decorator, adding support for
-* CLI commands while maintaining full compatibility with HTTP controllers.
-* Modules organize commands and can import other modules to compose larger
-* CLI applications.
-*
-* The module can optionally implement `NaviosModule` interface for lifecycle hooks.
-*
-* @param options - Configuration options for the module
-* @returns A class decorator function
-*
-* @example
-* ```typescript
-* import { CliModule } from '@navios/commander'
-* import { GreetCommand } from './greet.command'
-* import { UserModule } from './user.module'
-*
-* @CliModule({
-*   commands: [GreetCommand],
-*   imports: [UserModule]
-* })
-* export class AppModule {}
-* ```
-*
-* @example
-* ```typescript
-* // Mixed HTTP and CLI module
-* @CliModule({
-*   controllers: [HealthController],
-*   commands: [MigrateCommand],
-*   imports: [DatabaseModule],
-* })
-* export class AppModule {}
-* ```
-*/ function CliModule({ commands = [], controllers = [], imports = [], guards = [], overrides = [], priority, registry } = {
-	commands: [],
-	controllers: [],
-	imports: [],
-	guards: [],
-	overrides: []
-}) {
-	return (target, context) => {
-		if (context.kind !== "class") throw new Error("[Navios Commander] @CliModule decorator can only be used on classes.");
-		const result = Module({
-			controllers,
-			imports,
-			guards,
-			overrides,
-			priority,
-			registry
-		})(target, context);
-		const commandSet = getModuleCustomEntry(getModuleMetadata(target, context), CommandEntryKey, () => /* @__PURE__ */ new Set());
-		for (const command of commands) commandSet.add(command);
-		return result;
-	};
-}
-
 //#endregion
 export { CliModule, _CliParserService as CliParserService, Command, CommandEntryKey, CommandExecutionContext, CommandMetadataKey, _CommandRegistryService as CommandRegistryService, _CommanderAdapterService as CommanderAdapterService, CommanderExecutionContext, CommanderFactory, _HelpCommand as HelpCommand, defineCliEnvironment, extractCommandMetadata, extractModuleCommands, getCommandMetadata, hasCommandMetadata };
 //# sourceMappingURL=index.mjs.map