@navios/commander 0.8.0 → 0.9.0

package/lib/index.d.cts

@@ -1,4 +1,4 @@
-import { ClassType, ClassTypeWithInstance, Container, InjectionToken, NaviosModule } from "@navios/core";
+import { ClassType, ClassTypeWithInstance, Container, InjectionToken, NaviosModule, Registry } from "@navios/core";
 import { ZodObject } from "zod";
 export * from "@navios/core";
 
@@ -199,6 +199,16 @@ interface CommandOptions {
    * If provided, options will be validated and parsed according to this schema.
    */
   optionsSchema?: ZodObject;
+  /**
+   * Priority level for the command.
+   * Higher priority commands will be loaded first.
+   */
+  priority?: number;
+  /**
+   * Registry to use for the command.
+   * Registry is used to store the command and its options schema.
+   */
+  registry?: Registry;
 }
 /**
  * Decorator that marks a class as a CLI command.
@@ -232,7 +242,9 @@ interface CommandOptions {
  */
 declare function Command({
   path,
-  optionsSchema
+  optionsSchema,
+  priority,
+  registry
 }: CommandOptions): (target: ClassType, context: ClassDecoratorContext) => ClassType;
 //#endregion
 //#region src/decorators/cli-module.decorator.d.mts
@@ -252,6 +264,16 @@ interface CliModuleOptions {
    * Imported modules' commands will be available in this module.
    */
   imports?: ClassType[] | Set<ClassType>;
+  /**
+   * Priority level for the module.
+   * Higher priority modules will be loaded first.
+   */
+  priority?: number;
+  /**
+   * Registry to use for the module.
+   * Registry is used to store the module and its commands.
+   */
+  registry?: Registry;
 }
 /**
  * Decorator that marks a class as a CLI module.
@@ -277,7 +299,9 @@ interface CliModuleOptions {
  */
 declare function CliModule({
   commands,
-  imports
+  imports,
+  priority,
+  registry
 }?: CliModuleOptions): (target: ClassType, context: ClassDecoratorContext) => ClassType;
 //#endregion
 //#region src/interfaces/command-handler.interface.d.mts

package/lib/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":["ClassTypeWithInstance","NaviosModule","Container","CommanderApplicationOptions","CommanderApplication","Promise","ClassTypeWithInstance","NaviosModule","CommanderApplicationOptions","CommanderApplication","CommanderFactory","Promise","ClassType","ZodObject","CommandOptions","Command","path","optionsSchema","ClassDecoratorContext","ClassType","CliModuleOptions","Set","CliModule","commands","imports","ClassDecoratorContext","CommandHandler","TOptions","Promise","ClassType","ZodObject","CommandMetadataKey","CommandMetadata","Map","getCommandMetadata","ClassDecoratorContext","extractCommandMetadata","hasCommandMetadata","CommandMetadata","CommanderExecutionContext","ClassType","CliModuleMetadataKey","CliModuleMetadata","Set","Map","getCliModuleMetadata","ClassDecoratorContext","extractCliModuleMetadata","hasCliModuleMetadata","ClassTypeWithInstance","NaviosModule","Container","CommandHandler","CliModuleMetadata","CommandMetadata","CommandWithMetadata","CliModuleLoaderService","Promise","Map","ZodObject","ParsedCliArgs","Record","CliParserService","Array","InjectionToken","CommanderExecutionContext","CommandExecutionContext"],"sources":["../src/commander.application.d.mts","../src/commander.factory.d.mts","../src/decorators/command.decorator.d.mts","../src/decorators/cli-module.decorator.d.mts","../src/interfaces/command-handler.interface.d.mts","../src/metadata/command.metadata.d.mts","../src/interfaces/commander-execution-context.interface.d.mts","../src/metadata/cli-module.metadata.d.mts","../src/services/module-loader.service.d.mts","../src/services/cli-parser.service.d.mts","../src/tokens/execution-context.token.d.mts"],"sourcesContent":["import type { ClassTypeWithInstance, NaviosModule } from '@navios/core';\nimport { Container } from '@navios/core';\n/**\n * Configuration options for CommanderApplication.\n *\n * @public\n */\nexport interface CommanderApplicationOptions {\n}\n/**\n * Main application class for managing CLI command execution.\n *\n * This class handles module loading, command registration, and command execution.\n * It provides both programmatic and CLI-based command execution capabilities.\n *\n * @example\n * ```typescript\n * const app = await CommanderFactory.create(AppModule)\n * await app.init()\n * await app.run(process.argv)\n * ```\n */\nexport declare class CommanderApplication {\n    private moduleLoader;\n    private cliParser;\n    protected container: Container;\n    private appModule;\n    private options;\n    /**\n     * Indicates whether the application has been initialized.\n     * Set to `true` after `init()` is called successfully.\n     */\n    isInitialized: boolean;\n    /**\n     * @internal\n     * Sets up the application with the provided module and options.\n     * This is called automatically by CommanderFactory.create().\n     */\n    setup(appModule: ClassTypeWithInstance<NaviosModule>, options?: CommanderApplicationOptions): Promise<void>;\n    /**\n     * Gets the dependency injection container used by this application.\n     *\n     * @returns The Container instance\n     *\n     * @example\n     * ```typescript\n     * const container = app.getContainer()\n     * const service = await container.get(MyService)\n     * ```\n     */\n    getContainer(): Container;\n    /**\n     * Initializes the application by loading all modules and registering commands.\n     *\n     * This method must be called before executing commands or running the CLI.\n     * It traverses the module tree, loads all imported modules, and collects command metadata.\n     *\n     * @throws {Error} If the app module is not set (setup() was not called)\n     *\n     * @example\n     * ```typescript\n     * const app = await CommanderFactory.create(AppModule)\n     * await app.init() // Must be called before run() or executeCommand()\n     * ```\n     */\n    init(): Promise<void>;\n    /**\n     * Executes a command programmatically with the provided options.\n     *\n     * This method is useful for testing, automation, or programmatic workflows.\n     * The options will be validated against the command's Zod schema if one is provided.\n     *\n     * @param commandPath - The command path (e.g., 'greet', 'user:create')\n     * @param options - The command options object (will be validated if schema exists)\n     * @throws {Error} If the application is not initialized\n     * @throws {Error} If the command is not found\n     * @throws {Error} If the command does not implement the execute method\n     * @throws {ZodError} If options validation fails\n     *\n     * @example\n     * ```typescript\n     * await app.executeCommand('greet', {\n     *   name: 'World',\n     *   greeting: 'Hi'\n     * })\n     * ```\n     */\n    executeCommand(commandPath: string, options?: any): Promise<void>;\n    /**\n     * Gets all registered commands with their paths and class references.\n     *\n     * @returns An array of objects containing the command path and class\n     *\n     * @example\n     * ```typescript\n     * const commands = app.getAllCommands()\n     * commands.forEach(({ path }) => {\n     *   console.log(`Available: ${path}`)\n     * })\n     * ```\n     */\n    getAllCommands(): {\n        path: string;\n        class: ClassTypeWithInstance<any>;\n    }[];\n    /**\n     * Runs the CLI application by parsing command-line arguments and executing the appropriate command.\n     *\n     * This is the main entry point for CLI usage. It parses `argv`, validates options,\n     * and executes the matching command. Supports help command (`help`, `--help`, `-h`)\n     * which displays all available commands.\n     *\n     * @param argv - Command-line arguments array (defaults to `process.argv`)\n     * @throws {Error} If the application is not initialized\n     * @throws {Error} If no command is provided\n     * @throws {Error} If the command is not found\n     * @throws {ZodError} If options validation fails\n     *\n     * @example\n     * ```typescript\n     * // Parse and execute from process.argv\n     * await app.run()\n     *\n     * // Or provide custom arguments\n     * await app.run(['node', 'cli.js', 'greet', '--name', 'World'])\n     * ```\n     */\n    run(argv?: string[]): Promise<void>;\n    /**\n     * @internal\n     * Disposes of resources used by the application.\n     */\n    dispose(): Promise<void>;\n    /**\n     * Closes the application and cleans up resources.\n     *\n     * This should be called when the application is no longer needed to free up resources.\n     *\n     * @example\n     * ```typescript\n     * await app.run(process.argv)\n     * await app.close()\n     * ```\n     */\n    close(): Promise<void>;\n}\n//# sourceMappingURL=commander.application.d.mts.map","import type { ClassTypeWithInstance, NaviosModule } from '@navios/core';\nimport type { CommanderApplicationOptions } from './commander.application.mjs';\nimport { CommanderApplication } from './commander.application.mjs';\n/**\n * Factory class for creating and configuring CLI applications.\n *\n * @example\n * ```typescript\n * import { CommanderFactory } from '@navios/commander'\n * import { AppModule } from './app.module'\n *\n * async function bootstrap() {\n *   const app = await CommanderFactory.create(AppModule)\n *   await app.init()\n *   await app.run(process.argv)\n *   await app.close()\n * }\n * ```\n */\nexport declare class CommanderFactory {\n    /**\n     * Creates a new CommanderApplication instance and configures it with the provided module.\n     *\n     * @param appModule - The root CLI module class that contains commands and/or imports other modules\n     * @param options - Optional configuration options for the application\n     * @returns A promise that resolves to a configured CommanderApplication instance\n     *\n     * @example\n     * ```typescript\n     * const app = await CommanderFactory.create(AppModule)\n     * await app.init()\n     * ```\n     */\n    static create(appModule: ClassTypeWithInstance<NaviosModule>, options?: CommanderApplicationOptions): Promise<CommanderApplication>;\n}\n//# sourceMappingURL=commander.factory.d.mts.map","import type { ClassType } from '@navios/core';\nimport type { ZodObject } from 'zod';\n/**\n * Options for the `@Command` decorator.\n *\n * @public\n */\nexport interface CommandOptions {\n    /**\n     * The command path that users will invoke from the CLI.\n     * Can be a single word (e.g., 'greet') or multi-word with colons (e.g., 'user:create', 'db:migrate').\n     */\n    path: string;\n    /**\n     * Optional Zod schema for validating command options.\n     * If provided, options will be validated and parsed according to this schema.\n     */\n    optionsSchema?: ZodObject;\n}\n/**\n * Decorator that marks a class as a CLI command.\n *\n * The decorated class must implement the `CommandHandler` interface with an `execute` method.\n * The command will be automatically registered when its module is loaded.\n *\n * @param options - Configuration options for the command\n * @returns A class decorator function\n *\n * @example\n * ```typescript\n * import { Command, CommandHandler } from '@navios/commander'\n * import { z } from 'zod'\n *\n * const optionsSchema = z.object({\n *   name: z.string(),\n *   greeting: z.string().optional().default('Hello')\n * })\n *\n * @Command({\n *   path: 'greet',\n *   optionsSchema: optionsSchema\n * })\n * export class GreetCommand implements CommandHandler<z.infer<typeof optionsSchema>> {\n *   async execute(options) {\n *     console.log(`${options.greeting}, ${options.name}!`)\n *   }\n * }\n * ```\n */\nexport declare function Command({ path, optionsSchema }: CommandOptions): (target: ClassType, context: ClassDecoratorContext) => ClassType;\n//# sourceMappingURL=command.decorator.d.mts.map","import type { ClassType } from '@navios/core';\n/**\n * Options for the `@CliModule` decorator.\n *\n * @public\n */\nexport interface CliModuleOptions {\n    /**\n     * Array or Set of command classes to register in this module.\n     * Commands must be decorated with `@Command`.\n     */\n    commands?: ClassType[] | Set<ClassType>;\n    /**\n     * Array or Set of other CLI modules to import.\n     * Imported modules' commands will be available in this module.\n     */\n    imports?: ClassType[] | Set<ClassType>;\n}\n/**\n * Decorator that marks a class as a CLI module.\n *\n * Modules organize commands and can import other modules to compose larger CLI applications.\n * The module can optionally implement `NaviosModule` interface for lifecycle hooks.\n *\n * @param options - Configuration options for the module\n * @returns A class decorator function\n *\n * @example\n * ```typescript\n * import { CliModule } from '@navios/commander'\n * import { GreetCommand } from './greet.command'\n * import { UserModule } from './user.module'\n *\n * @CliModule({\n *   commands: [GreetCommand],\n *   imports: [UserModule]\n * })\n * export class AppModule {}\n * ```\n */\nexport declare function CliModule({ commands, imports }?: CliModuleOptions): (target: ClassType, context: ClassDecoratorContext) => ClassType;\n//# sourceMappingURL=cli-module.decorator.d.mts.map","/**\n * Interface that all command classes must implement.\n *\n * Commands decorated with `@Command` must implement this interface.\n * The `execute` method is called when the command is invoked.\n *\n * @template TOptions - The type of options that the command accepts\n *\n * @example\n * ```typescript\n * import { Command, CommandHandler } from '@navios/commander'\n * import { z } from 'zod'\n *\n * const optionsSchema = z.object({\n *   name: z.string()\n * })\n *\n * type Options = z.infer<typeof optionsSchema>\n *\n * @Command({ path: 'greet', optionsSchema })\n * export class GreetCommand implements CommandHandler<Options> {\n *   async execute(options: Options) {\n *     console.log(`Hello, ${options.name}!`)\n *   }\n * }\n * ```\n */\nexport interface CommandHandler<TOptions = any> {\n    /**\n     * Executes the command with the provided options.\n     *\n     * @param options - The validated command options (validated against the command's schema if provided)\n     * @returns A promise or void\n     */\n    execute(options: TOptions): void | Promise<void>;\n}\n//# sourceMappingURL=command-handler.interface.d.mts.map","import type { ClassType } from '@navios/core';\nimport type { ZodObject } from 'zod';\n/**\n * @internal\n * Symbol key used to store command metadata on classes.\n */\nexport declare const CommandMetadataKey: unique symbol;\n/**\n * Metadata associated with a command.\n *\n * @public\n */\nexport interface CommandMetadata {\n    /**\n     * The command path (e.g., 'greet', 'user:create').\n     */\n    path: string;\n    /**\n     * Optional Zod schema for validating command options.\n     */\n    optionsSchema?: ZodObject;\n    /**\n     * Map of custom attributes that can be attached to the command.\n     */\n    customAttributes: Map<string | symbol, any>;\n}\n/**\n * Gets or creates command metadata for a class.\n *\n * @internal\n * @param target - The command class\n * @param context - The decorator context\n * @param path - The command path\n * @param optionsSchema - Optional Zod schema\n * @returns The command metadata\n */\nexport declare function getCommandMetadata(target: ClassType, context: ClassDecoratorContext, path: string, optionsSchema?: ZodObject): CommandMetadata;\n/**\n * Extracts command metadata from a class.\n *\n * @param target - The command class\n * @returns The command metadata\n * @throws {Error} If the class is not decorated with @Command\n *\n * @example\n * ```typescript\n * const metadata = extractCommandMetadata(GreetCommand)\n * console.log(metadata.path) // 'greet'\n * ```\n */\nexport declare function extractCommandMetadata(target: ClassType): CommandMetadata;\n/**\n * Checks if a class has command metadata.\n *\n * @param target - The class to check\n * @returns `true` if the class is decorated with @Command, `false` otherwise\n */\nexport declare function hasCommandMetadata(target: ClassType): boolean;\n//# sourceMappingURL=command.metadata.d.mts.map","import type { CommandMetadata } from '../metadata/command.metadata.mjs';\n/**\n * Execution context for a command execution.\n *\n * Provides access to command metadata, path, and validated options during command execution.\n * This context is automatically injected and available via the `CommandExecutionContext` token.\n *\n * @example\n * ```typescript\n * import { inject, Injectable } from '@navios/di'\n * import { CommandExecutionContext } from '@navios/commander'\n *\n * @Injectable()\n * class CommandLogger {\n *   private ctx = inject(CommandExecutionContext)\n *\n *   log() {\n *     console.log('Command:', this.ctx.getCommandPath())\n *     console.log('Options:', this.ctx.getOptions())\n *   }\n * }\n * ```\n */\nexport declare class CommanderExecutionContext {\n    private readonly command;\n    private readonly commandPath;\n    private readonly options;\n    /**\n     * @internal\n     * Creates a new execution context.\n     */\n    constructor(command: CommandMetadata, commandPath: string, options: any);\n    /**\n     * Gets the command metadata.\n     *\n     * @returns The command metadata including path and options schema\n     */\n    getCommand(): CommandMetadata;\n    /**\n     * Gets the command path that was invoked.\n     *\n     * @returns The command path (e.g., 'greet', 'user:create')\n     */\n    getCommandPath(): string;\n    /**\n     * Gets the validated command options.\n     *\n     * Options are validated against the command's Zod schema if one was provided.\n     *\n     * @returns The validated options object\n     */\n    getOptions(): any;\n}\n//# sourceMappingURL=commander-execution-context.interface.d.mts.map","import type { ClassType } from '@navios/core';\n/**\n * @internal\n * Symbol key used to store CLI module metadata on classes.\n */\nexport declare const CliModuleMetadataKey: unique symbol;\n/**\n * Metadata associated with a CLI module.\n *\n * @public\n */\nexport interface CliModuleMetadata {\n    /**\n     * Set of command classes registered in this module.\n     */\n    commands: Set<ClassType>;\n    /**\n     * Set of other modules imported by this module.\n     */\n    imports: Set<ClassType>;\n    /**\n     * Map of custom attributes that can be attached to the module.\n     */\n    customAttributes: Map<string | symbol, any>;\n}\n/**\n * Gets or creates CLI module metadata for a class.\n *\n * @internal\n * @param target - The module class\n * @param context - The decorator context\n * @returns The module metadata\n */\nexport declare function getCliModuleMetadata(target: ClassType, context: ClassDecoratorContext): CliModuleMetadata;\n/**\n * Extracts CLI module metadata from a class.\n *\n * @param target - The module class\n * @returns The module metadata\n * @throws {Error} If the class is not decorated with @CliModule\n *\n * @example\n * ```typescript\n * const metadata = extractCliModuleMetadata(AppModule)\n * console.log(metadata.commands.size) // Number of commands\n * ```\n */\nexport declare function extractCliModuleMetadata(target: ClassType): CliModuleMetadata;\n/**\n * Checks if a class has CLI module metadata.\n *\n * @param target - The class to check\n * @returns `true` if the class is decorated with @CliModule, `false` otherwise\n */\nexport declare function hasCliModuleMetadata(target: ClassType): boolean;\n//# sourceMappingURL=cli-module.metadata.d.mts.map","import type { ClassTypeWithInstance, NaviosModule } from '@navios/core';\nimport { Container } from '@navios/core';\nimport type { CommandHandler } from '../interfaces/index.mjs';\nimport type { CliModuleMetadata, CommandMetadata } from '../metadata/index.mjs';\n/**\n * Command class with its associated metadata.\n *\n * @public\n */\nexport interface CommandWithMetadata {\n    /**\n     * The command class constructor.\n     */\n    class: ClassTypeWithInstance<CommandHandler>;\n    /**\n     * The command metadata including path and options schema.\n     */\n    metadata: CommandMetadata;\n}\n/**\n * Service for loading and managing CLI modules and commands.\n *\n * Handles module traversal, command registration, and metadata collection.\n * This service is used internally by CommanderApplication.\n *\n * @public\n */\nexport declare class CliModuleLoaderService {\n    protected container: Container;\n    private modulesMetadata;\n    private loadedModules;\n    private commandsMetadata;\n    private initialized;\n    /**\n     * Loads all modules starting from the root app module.\n     *\n     * Traverses the module tree, loads imported modules, and collects command metadata.\n     *\n     * @param appModule - The root CLI module\n     */\n    loadModules(appModule: ClassTypeWithInstance<NaviosModule>): Promise<void>;\n    private traverseModules;\n    private mergeMetadata;\n    /**\n     * Gets all loaded module metadata.\n     *\n     * @returns Map of module names to their metadata\n     */\n    getAllModules(): Map<string, CliModuleMetadata>;\n    /**\n     * Gets all command classes indexed by command class name.\n     *\n     * @returns Map of command class names to command classes\n     */\n    getAllCommands(): Map<string, ClassTypeWithInstance<any>>;\n    /**\n     * Get all commands with their metadata, indexed by command path.\n     * This is populated during loadModules, so path information is available\n     * before parsing CLI argv.\n     */\n    getAllCommandsWithMetadata(): Map<string, CommandWithMetadata>;\n    /**\n     * Get a command by its path, with metadata already extracted.\n     * Returns undefined if command is not found.\n     */\n    getCommandByPath(path: string): CommandWithMetadata | undefined;\n    /**\n     * Disposes of all loaded modules and commands, clearing internal state.\n     */\n    dispose(): void;\n}\n//# sourceMappingURL=module-loader.service.d.mts.map","import type { ZodObject } from 'zod';\n/**\n * Result of parsing command-line arguments.\n *\n * @public\n */\nexport interface ParsedCliArgs {\n    /**\n     * The command path (e.g., 'greet', 'user:create').\n     * Multi-word commands are joined with spaces.\n     */\n    command: string;\n    /**\n     * Parsed options as key-value pairs.\n     * Keys are converted from kebab-case to camelCase.\n     */\n    options: Record<string, any>;\n    /**\n     * Positional arguments that don't match any option flags.\n     */\n    positionals: string[];\n}\n/**\n * Service for parsing command-line arguments.\n *\n * Handles parsing of various CLI argument formats including:\n * - Long options: `--key value` or `--key=value`\n * - Short options: `-k value` or `-abc` (multiple flags)\n * - Boolean flags\n * - Array options\n * - Positional arguments\n *\n * @public\n */\nexport declare class CliParserService {\n    /**\n     * Parses command-line arguments from process.argv\n     * Commands can be multi-word (e.g., 'db migrate', 'cache clear')\n     * Expected format: node script.js command [subcommand...] --flag value --boolean-flag positional1 positional2\n     *\n     * @param argv - Array of command-line arguments (typically process.argv)\n     * @param optionsSchema - Optional Zod schema to determine boolean flags and option types\n     * @returns Parsed command (space-separated if multi-word), options, and positional arguments\n     */\n    parse(argv: string[], optionsSchema?: ZodObject): ParsedCliArgs;\n    /**\n     * Converts kebab-case to camelCase\n     */\n    private camelCase;\n    /**\n     * Attempts to parse string values into appropriate types\n     */\n    private parseValue;\n    /**\n     * Extracts boolean field names from a Zod schema\n     * Handles ZodObject, ZodOptional, and ZodDefault wrappers\n     */\n    private extractBooleanFields;\n    /**\n     * Extracts array field names from a Zod schema\n     * Handles ZodObject, ZodOptional, and ZodDefault wrappers\n     */\n    private extractArrayFields;\n    /**\n     * Checks if a Zod schema represents a boolean type\n     * Unwraps ZodOptional and ZodDefault\n     */\n    private isSchemaBoolean;\n    /**\n     * Checks if a Zod schema represents an array type\n     * Unwraps ZodOptional and ZodDefault\n     */\n    private isSchemaArray;\n    /**\n     * Formats help text listing all available commands.\n     *\n     * @param commands - Array of command objects with path and class\n     * @returns Formatted string listing all commands\n     */\n    formatCommandList(commands: Array<{\n        path: string;\n        class: any;\n    }>): string;\n}\n//# sourceMappingURL=cli-parser.service.d.mts.map","import { InjectionToken } from '@navios/core';\nimport type { CommanderExecutionContext } from '../interfaces/index.mjs';\n/**\n * Injection token for accessing the current command execution context.\n *\n * Use this token with `inject()` to access the `CommanderExecutionContext` in services\n * that need information about the currently executing command.\n *\n * @example\n * ```typescript\n * import { inject, Injectable } from '@navios/di'\n * import { CommandExecutionContext } from '@navios/commander'\n *\n * @Injectable()\n * class MyService {\n *   private ctx = inject(CommandExecutionContext)\n *\n *   doSomething() {\n *     const commandPath = this.ctx.getCommandPath()\n *     const options = this.ctx.getOptions()\n *     // Use context information...\n *   }\n * }\n * ```\n */\nexport declare const CommandExecutionContext: InjectionToken<CommanderExecutionContext, undefined, false>;\n//# sourceMappingURL=execution-context.token.d.mts.map"],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":["ClassTypeWithInstance","NaviosModule","Container","CommanderApplicationOptions","CommanderApplication","Promise","ClassTypeWithInstance","NaviosModule","CommanderApplicationOptions","CommanderApplication","CommanderFactory","Promise","ClassType","Registry","ZodObject","CommandOptions","Command","path","optionsSchema","priority","registry","ClassDecoratorContext","ClassType","Registry","CliModuleOptions","Set","CliModule","commands","imports","priority","registry","ClassDecoratorContext","CommandHandler","TOptions","Promise","ClassType","ZodObject","CommandMetadataKey","CommandMetadata","Map","getCommandMetadata","ClassDecoratorContext","extractCommandMetadata","hasCommandMetadata","CommandMetadata","CommanderExecutionContext","ClassType","CliModuleMetadataKey","CliModuleMetadata","Set","Map","getCliModuleMetadata","ClassDecoratorContext","extractCliModuleMetadata","hasCliModuleMetadata","ClassTypeWithInstance","NaviosModule","Container","CommandHandler","CliModuleMetadata","CommandMetadata","CommandWithMetadata","CliModuleLoaderService","Promise","Map","ZodObject","ParsedCliArgs","Record","CliParserService","Array","InjectionToken","CommanderExecutionContext","CommandExecutionContext"],"sources":["../src/commander.application.d.mts","../src/commander.factory.d.mts","../src/decorators/command.decorator.d.mts","../src/decorators/cli-module.decorator.d.mts","../src/interfaces/command-handler.interface.d.mts","../src/metadata/command.metadata.d.mts","../src/interfaces/commander-execution-context.interface.d.mts","../src/metadata/cli-module.metadata.d.mts","../src/services/module-loader.service.d.mts","../src/services/cli-parser.service.d.mts","../src/tokens/execution-context.token.d.mts"],"sourcesContent":["import type { ClassTypeWithInstance, NaviosModule } from '@navios/core';\nimport { Container } from '@navios/core';\n/**\n * Configuration options for CommanderApplication.\n *\n * @public\n */\nexport interface CommanderApplicationOptions {\n}\n/**\n * Main application class for managing CLI command execution.\n *\n * This class handles module loading, command registration, and command execution.\n * It provides both programmatic and CLI-based command execution capabilities.\n *\n * @example\n * ```typescript\n * const app = await CommanderFactory.create(AppModule)\n * await app.init()\n * await app.run(process.argv)\n * ```\n */\nexport declare class CommanderApplication {\n    private moduleLoader;\n    private cliParser;\n    protected container: Container;\n    private appModule;\n    private options;\n    /**\n     * Indicates whether the application has been initialized.\n     * Set to `true` after `init()` is called successfully.\n     */\n    isInitialized: boolean;\n    /**\n     * @internal\n     * Sets up the application with the provided module and options.\n     * This is called automatically by CommanderFactory.create().\n     */\n    setup(appModule: ClassTypeWithInstance<NaviosModule>, options?: CommanderApplicationOptions): Promise<void>;\n    /**\n     * Gets the dependency injection container used by this application.\n     *\n     * @returns The Container instance\n     *\n     * @example\n     * ```typescript\n     * const container = app.getContainer()\n     * const service = await container.get(MyService)\n     * ```\n     */\n    getContainer(): Container;\n    /**\n     * Initializes the application by loading all modules and registering commands.\n     *\n     * This method must be called before executing commands or running the CLI.\n     * It traverses the module tree, loads all imported modules, and collects command metadata.\n     *\n     * @throws {Error} If the app module is not set (setup() was not called)\n     *\n     * @example\n     * ```typescript\n     * const app = await CommanderFactory.create(AppModule)\n     * await app.init() // Must be called before run() or executeCommand()\n     * ```\n     */\n    init(): Promise<void>;\n    /**\n     * Executes a command programmatically with the provided options.\n     *\n     * This method is useful for testing, automation, or programmatic workflows.\n     * The options will be validated against the command's Zod schema if one is provided.\n     *\n     * @param commandPath - The command path (e.g., 'greet', 'user:create')\n     * @param options - The command options object (will be validated if schema exists)\n     * @throws {Error} If the application is not initialized\n     * @throws {Error} If the command is not found\n     * @throws {Error} If the command does not implement the execute method\n     * @throws {ZodError} If options validation fails\n     *\n     * @example\n     * ```typescript\n     * await app.executeCommand('greet', {\n     *   name: 'World',\n     *   greeting: 'Hi'\n     * })\n     * ```\n     */\n    executeCommand(commandPath: string, options?: any): Promise<void>;\n    /**\n     * Gets all registered commands with their paths and class references.\n     *\n     * @returns An array of objects containing the command path and class\n     *\n     * @example\n     * ```typescript\n     * const commands = app.getAllCommands()\n     * commands.forEach(({ path }) => {\n     *   console.log(`Available: ${path}`)\n     * })\n     * ```\n     */\n    getAllCommands(): {\n        path: string;\n        class: ClassTypeWithInstance<any>;\n    }[];\n    /**\n     * Runs the CLI application by parsing command-line arguments and executing the appropriate command.\n     *\n     * This is the main entry point for CLI usage. It parses `argv`, validates options,\n     * and executes the matching command. Supports help command (`help`, `--help`, `-h`)\n     * which displays all available commands.\n     *\n     * @param argv - Command-line arguments array (defaults to `process.argv`)\n     * @throws {Error} If the application is not initialized\n     * @throws {Error} If no command is provided\n     * @throws {Error} If the command is not found\n     * @throws {ZodError} If options validation fails\n     *\n     * @example\n     * ```typescript\n     * // Parse and execute from process.argv\n     * await app.run()\n     *\n     * // Or provide custom arguments\n     * await app.run(['node', 'cli.js', 'greet', '--name', 'World'])\n     * ```\n     */\n    run(argv?: string[]): Promise<void>;\n    /**\n     * @internal\n     * Disposes of resources used by the application.\n     */\n    dispose(): Promise<void>;\n    /**\n     * Closes the application and cleans up resources.\n     *\n     * This should be called when the application is no longer needed to free up resources.\n     *\n     * @example\n     * ```typescript\n     * await app.run(process.argv)\n     * await app.close()\n     * ```\n     */\n    close(): Promise<void>;\n}\n//# sourceMappingURL=commander.application.d.mts.map","import type { ClassTypeWithInstance, NaviosModule } from '@navios/core';\nimport type { CommanderApplicationOptions } from './commander.application.mjs';\nimport { CommanderApplication } from './commander.application.mjs';\n/**\n * Factory class for creating and configuring CLI applications.\n *\n * @example\n * ```typescript\n * import { CommanderFactory } from '@navios/commander'\n * import { AppModule } from './app.module'\n *\n * async function bootstrap() {\n *   const app = await CommanderFactory.create(AppModule)\n *   await app.init()\n *   await app.run(process.argv)\n *   await app.close()\n * }\n * ```\n */\nexport declare class CommanderFactory {\n    /**\n     * Creates a new CommanderApplication instance and configures it with the provided module.\n     *\n     * @param appModule - The root CLI module class that contains commands and/or imports other modules\n     * @param options - Optional configuration options for the application\n     * @returns A promise that resolves to a configured CommanderApplication instance\n     *\n     * @example\n     * ```typescript\n     * const app = await CommanderFactory.create(AppModule)\n     * await app.init()\n     * ```\n     */\n    static create(appModule: ClassTypeWithInstance<NaviosModule>, options?: CommanderApplicationOptions): Promise<CommanderApplication>;\n}\n//# sourceMappingURL=commander.factory.d.mts.map","import type { ClassType, Registry } from '@navios/core';\nimport type { ZodObject } from 'zod';\n/**\n * Options for the `@Command` decorator.\n *\n * @public\n */\nexport interface CommandOptions {\n    /**\n     * The command path that users will invoke from the CLI.\n     * Can be a single word (e.g., 'greet') or multi-word with colons (e.g., 'user:create', 'db:migrate').\n     */\n    path: string;\n    /**\n     * Optional Zod schema for validating command options.\n     * If provided, options will be validated and parsed according to this schema.\n     */\n    optionsSchema?: ZodObject;\n    /**\n     * Priority level for the command.\n     * Higher priority commands will be loaded first.\n     */\n    priority?: number;\n    /**\n     * Registry to use for the command.\n     * Registry is used to store the command and its options schema.\n     */\n    registry?: Registry;\n}\n/**\n * Decorator that marks a class as a CLI command.\n *\n * The decorated class must implement the `CommandHandler` interface with an `execute` method.\n * The command will be automatically registered when its module is loaded.\n *\n * @param options - Configuration options for the command\n * @returns A class decorator function\n *\n * @example\n * ```typescript\n * import { Command, CommandHandler } from '@navios/commander'\n * import { z } from 'zod'\n *\n * const optionsSchema = z.object({\n *   name: z.string(),\n *   greeting: z.string().optional().default('Hello')\n * })\n *\n * @Command({\n *   path: 'greet',\n *   optionsSchema: optionsSchema\n * })\n * export class GreetCommand implements CommandHandler<z.infer<typeof optionsSchema>> {\n *   async execute(options) {\n *     console.log(`${options.greeting}, ${options.name}!`)\n *   }\n * }\n * ```\n */\nexport declare function Command({ path, optionsSchema, priority, registry, }: CommandOptions): (target: ClassType, context: ClassDecoratorContext) => ClassType;\n//# sourceMappingURL=command.decorator.d.mts.map","import type { ClassType, Registry } from '@navios/core';\n/**\n * Options for the `@CliModule` decorator.\n *\n * @public\n */\nexport interface CliModuleOptions {\n    /**\n     * Array or Set of command classes to register in this module.\n     * Commands must be decorated with `@Command`.\n     */\n    commands?: ClassType[] | Set<ClassType>;\n    /**\n     * Array or Set of other CLI modules to import.\n     * Imported modules' commands will be available in this module.\n     */\n    imports?: ClassType[] | Set<ClassType>;\n    /**\n     * Priority level for the module.\n     * Higher priority modules will be loaded first.\n     */\n    priority?: number;\n    /**\n     * Registry to use for the module.\n     * Registry is used to store the module and its commands.\n     */\n    registry?: Registry;\n}\n/**\n * Decorator that marks a class as a CLI module.\n *\n * Modules organize commands and can import other modules to compose larger CLI applications.\n * The module can optionally implement `NaviosModule` interface for lifecycle hooks.\n *\n * @param options - Configuration options for the module\n * @returns A class decorator function\n *\n * @example\n * ```typescript\n * import { CliModule } from '@navios/commander'\n * import { GreetCommand } from './greet.command'\n * import { UserModule } from './user.module'\n *\n * @CliModule({\n *   commands: [GreetCommand],\n *   imports: [UserModule]\n * })\n * export class AppModule {}\n * ```\n */\nexport declare function CliModule({ commands, imports, priority, registry }?: CliModuleOptions): (target: ClassType, context: ClassDecoratorContext) => ClassType;\n//# sourceMappingURL=cli-module.decorator.d.mts.map","/**\n * Interface that all command classes must implement.\n *\n * Commands decorated with `@Command` must implement this interface.\n * The `execute` method is called when the command is invoked.\n *\n * @template TOptions - The type of options that the command accepts\n *\n * @example\n * ```typescript\n * import { Command, CommandHandler } from '@navios/commander'\n * import { z } from 'zod'\n *\n * const optionsSchema = z.object({\n *   name: z.string()\n * })\n *\n * type Options = z.infer<typeof optionsSchema>\n *\n * @Command({ path: 'greet', optionsSchema })\n * export class GreetCommand implements CommandHandler<Options> {\n *   async execute(options: Options) {\n *     console.log(`Hello, ${options.name}!`)\n *   }\n * }\n * ```\n */\nexport interface CommandHandler<TOptions = any> {\n    /**\n     * Executes the command with the provided options.\n     *\n     * @param options - The validated command options (validated against the command's schema if provided)\n     * @returns A promise or void\n     */\n    execute(options: TOptions): void | Promise<void>;\n}\n//# sourceMappingURL=command-handler.interface.d.mts.map","import type { ClassType } from '@navios/core';\nimport type { ZodObject } from 'zod';\n/**\n * @internal\n * Symbol key used to store command metadata on classes.\n */\nexport declare const CommandMetadataKey: unique symbol;\n/**\n * Metadata associated with a command.\n *\n * @public\n */\nexport interface CommandMetadata {\n    /**\n     * The command path (e.g., 'greet', 'user:create').\n     */\n    path: string;\n    /**\n     * Optional Zod schema for validating command options.\n     */\n    optionsSchema?: ZodObject;\n    /**\n     * Map of custom attributes that can be attached to the command.\n     */\n    customAttributes: Map<string | symbol, any>;\n}\n/**\n * Gets or creates command metadata for a class.\n *\n * @internal\n * @param target - The command class\n * @param context - The decorator context\n * @param path - The command path\n * @param optionsSchema - Optional Zod schema\n * @returns The command metadata\n */\nexport declare function getCommandMetadata(target: ClassType, context: ClassDecoratorContext, path: string, optionsSchema?: ZodObject): CommandMetadata;\n/**\n * Extracts command metadata from a class.\n *\n * @param target - The command class\n * @returns The command metadata\n * @throws {Error} If the class is not decorated with @Command\n *\n * @example\n * ```typescript\n * const metadata = extractCommandMetadata(GreetCommand)\n * console.log(metadata.path) // 'greet'\n * ```\n */\nexport declare function extractCommandMetadata(target: ClassType): CommandMetadata;\n/**\n * Checks if a class has command metadata.\n *\n * @param target - The class to check\n * @returns `true` if the class is decorated with @Command, `false` otherwise\n */\nexport declare function hasCommandMetadata(target: ClassType): boolean;\n//# sourceMappingURL=command.metadata.d.mts.map","import type { CommandMetadata } from '../metadata/command.metadata.mjs';\n/**\n * Execution context for a command execution.\n *\n * Provides access to command metadata, path, and validated options during command execution.\n * This context is automatically injected and available via the `CommandExecutionContext` token.\n *\n * @example\n * ```typescript\n * import { inject, Injectable } from '@navios/di'\n * import { CommandExecutionContext } from '@navios/commander'\n *\n * @Injectable()\n * class CommandLogger {\n *   private ctx = inject(CommandExecutionContext)\n *\n *   log() {\n *     console.log('Command:', this.ctx.getCommandPath())\n *     console.log('Options:', this.ctx.getOptions())\n *   }\n * }\n * ```\n */\nexport declare class CommanderExecutionContext {\n    private readonly command;\n    private readonly commandPath;\n    private readonly options;\n    /**\n     * @internal\n     * Creates a new execution context.\n     */\n    constructor(command: CommandMetadata, commandPath: string, options: any);\n    /**\n     * Gets the command metadata.\n     *\n     * @returns The command metadata including path and options schema\n     */\n    getCommand(): CommandMetadata;\n    /**\n     * Gets the command path that was invoked.\n     *\n     * @returns The command path (e.g., 'greet', 'user:create')\n     */\n    getCommandPath(): string;\n    /**\n     * Gets the validated command options.\n     *\n     * Options are validated against the command's Zod schema if one was provided.\n     *\n     * @returns The validated options object\n     */\n    getOptions(): any;\n}\n//# sourceMappingURL=commander-execution-context.interface.d.mts.map","import type { ClassType } from '@navios/core';\n/**\n * @internal\n * Symbol key used to store CLI module metadata on classes.\n */\nexport declare const CliModuleMetadataKey: unique symbol;\n/**\n * Metadata associated with a CLI module.\n *\n * @public\n */\nexport interface CliModuleMetadata {\n    /**\n     * Set of command classes registered in this module.\n     */\n    commands: Set<ClassType>;\n    /**\n     * Set of other modules imported by this module.\n     */\n    imports: Set<ClassType>;\n    /**\n     * Map of custom attributes that can be attached to the module.\n     */\n    customAttributes: Map<string | symbol, any>;\n}\n/**\n * Gets or creates CLI module metadata for a class.\n *\n * @internal\n * @param target - The module class\n * @param context - The decorator context\n * @returns The module metadata\n */\nexport declare function getCliModuleMetadata(target: ClassType, context: ClassDecoratorContext): CliModuleMetadata;\n/**\n * Extracts CLI module metadata from a class.\n *\n * @param target - The module class\n * @returns The module metadata\n * @throws {Error} If the class is not decorated with @CliModule\n *\n * @example\n * ```typescript\n * const metadata = extractCliModuleMetadata(AppModule)\n * console.log(metadata.commands.size) // Number of commands\n * ```\n */\nexport declare function extractCliModuleMetadata(target: ClassType): CliModuleMetadata;\n/**\n * Checks if a class has CLI module metadata.\n *\n * @param target - The class to check\n * @returns `true` if the class is decorated with @CliModule, `false` otherwise\n */\nexport declare function hasCliModuleMetadata(target: ClassType): boolean;\n//# sourceMappingURL=cli-module.metadata.d.mts.map","import type { ClassTypeWithInstance, NaviosModule } from '@navios/core';\nimport { Container } from '@navios/core';\nimport type { CommandHandler } from '../interfaces/index.mjs';\nimport type { CliModuleMetadata, CommandMetadata } from '../metadata/index.mjs';\n/**\n * Command class with its associated metadata.\n *\n * @public\n */\nexport interface CommandWithMetadata {\n    /**\n     * The command class constructor.\n     */\n    class: ClassTypeWithInstance<CommandHandler>;\n    /**\n     * The command metadata including path and options schema.\n     */\n    metadata: CommandMetadata;\n}\n/**\n * Service for loading and managing CLI modules and commands.\n *\n * Handles module traversal, command registration, and metadata collection.\n * This service is used internally by CommanderApplication.\n *\n * @public\n */\nexport declare class CliModuleLoaderService {\n    protected container: Container;\n    private modulesMetadata;\n    private loadedModules;\n    private commandsMetadata;\n    private initialized;\n    /**\n     * Loads all modules starting from the root app module.\n     *\n     * Traverses the module tree, loads imported modules, and collects command metadata.\n     *\n     * @param appModule - The root CLI module\n     */\n    loadModules(appModule: ClassTypeWithInstance<NaviosModule>): Promise<void>;\n    private traverseModules;\n    private mergeMetadata;\n    /**\n     * Gets all loaded module metadata.\n     *\n     * @returns Map of module names to their metadata\n     */\n    getAllModules(): Map<string, CliModuleMetadata>;\n    /**\n     * Gets all command classes indexed by command class name.\n     *\n     * @returns Map of command class names to command classes\n     */\n    getAllCommands(): Map<string, ClassTypeWithInstance<any>>;\n    /**\n     * Get all commands with their metadata, indexed by command path.\n     * This is populated during loadModules, so path information is available\n     * before parsing CLI argv.\n     */\n    getAllCommandsWithMetadata(): Map<string, CommandWithMetadata>;\n    /**\n     * Get a command by its path, with metadata already extracted.\n     * Returns undefined if command is not found.\n     */\n    getCommandByPath(path: string): CommandWithMetadata | undefined;\n    /**\n     * Disposes of all loaded modules and commands, clearing internal state.\n     */\n    dispose(): void;\n}\n//# sourceMappingURL=module-loader.service.d.mts.map","import type { ZodObject } from 'zod';\n/**\n * Result of parsing command-line arguments.\n *\n * @public\n */\nexport interface ParsedCliArgs {\n    /**\n     * The command path (e.g., 'greet', 'user:create').\n     * Multi-word commands are joined with spaces.\n     */\n    command: string;\n    /**\n     * Parsed options as key-value pairs.\n     * Keys are converted from kebab-case to camelCase.\n     */\n    options: Record<string, any>;\n    /**\n     * Positional arguments that don't match any option flags.\n     */\n    positionals: string[];\n}\n/**\n * Service for parsing command-line arguments.\n *\n * Handles parsing of various CLI argument formats including:\n * - Long options: `--key value` or `--key=value`\n * - Short options: `-k value` or `-abc` (multiple flags)\n * - Boolean flags\n * - Array options\n * - Positional arguments\n *\n * @public\n */\nexport declare class CliParserService {\n    /**\n     * Parses command-line arguments from process.argv\n     * Commands can be multi-word (e.g., 'db migrate', 'cache clear')\n     * Expected format: node script.js command [subcommand...] --flag value --boolean-flag positional1 positional2\n     *\n     * @param argv - Array of command-line arguments (typically process.argv)\n     * @param optionsSchema - Optional Zod schema to determine boolean flags and option types\n     * @returns Parsed command (space-separated if multi-word), options, and positional arguments\n     */\n    parse(argv: string[], optionsSchema?: ZodObject): ParsedCliArgs;\n    /**\n     * Converts kebab-case to camelCase\n     */\n    private camelCase;\n    /**\n     * Attempts to parse string values into appropriate types\n     */\n    private parseValue;\n    /**\n     * Extracts boolean field names from a Zod schema\n     * Handles ZodObject, ZodOptional, and ZodDefault wrappers\n     */\n    private extractBooleanFields;\n    /**\n     * Extracts array field names from a Zod schema\n     * Handles ZodObject, ZodOptional, and ZodDefault wrappers\n     */\n    private extractArrayFields;\n    /**\n     * Checks if a Zod schema represents a boolean type\n     * Unwraps ZodOptional and ZodDefault\n     */\n    private isSchemaBoolean;\n    /**\n     * Checks if a Zod schema represents an array type\n     * Unwraps ZodOptional and ZodDefault\n     */\n    private isSchemaArray;\n    /**\n     * Formats help text listing all available commands.\n     *\n     * @param commands - Array of command objects with path and class\n     * @returns Formatted string listing all commands\n     */\n    formatCommandList(commands: Array<{\n        path: string;\n        class: any;\n    }>): string;\n}\n//# sourceMappingURL=cli-parser.service.d.mts.map","import { InjectionToken } from '@navios/core';\nimport type { CommanderExecutionContext } from '../interfaces/index.mjs';\n/**\n * Injection token for accessing the current command execution context.\n *\n * Use this token with `inject()` to access the `CommanderExecutionContext` in services\n * that need information about the currently executing command.\n *\n * @example\n * ```typescript\n * import { inject, Injectable } from '@navios/di'\n * import { CommandExecutionContext } from '@navios/commander'\n *\n * @Injectable()\n * class MyService {\n *   private ctx = inject(CommandExecutionContext)\n *\n *   doSomething() {\n *     const commandPath = this.ctx.getCommandPath()\n *     const options = this.ctx.getOptions()\n *     // Use context information...\n *   }\n * }\n * ```\n */\nexport declare const CommandExecutionContext: InjectionToken<CommanderExecutionContext, undefined, false>;\n//# sourceMappingURL=execution-context.token.d.mts.map"],"mappings":"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"}

package/lib/index.d.mts

@@ -1,4 +1,4 @@
-import { ClassType, ClassTypeWithInstance, Container, InjectionToken, NaviosModule } from "@navios/core";
+import { ClassType, ClassTypeWithInstance, Container, InjectionToken, NaviosModule, Registry } from "@navios/core";
 import { ZodObject } from "zod";
 export * from "@navios/core";
 
@@ -199,6 +199,16 @@ interface CommandOptions {
    * If provided, options will be validated and parsed according to this schema.
    */
   optionsSchema?: ZodObject;
+  /**
+   * Priority level for the command.
+   * Higher priority commands will be loaded first.
+   */
+  priority?: number;
+  /**
+   * Registry to use for the command.
+   * Registry is used to store the command and its options schema.
+   */
+  registry?: Registry;
 }
 /**
  * Decorator that marks a class as a CLI command.
@@ -232,7 +242,9 @@ interface CommandOptions {
  */
 declare function Command({
   path,
-  optionsSchema
+  optionsSchema,
+  priority,
+  registry
 }: CommandOptions): (target: ClassType, context: ClassDecoratorContext) => ClassType;
 //#endregion
 //#region src/decorators/cli-module.decorator.d.mts
@@ -252,6 +264,16 @@ interface CliModuleOptions {
    * Imported modules' commands will be available in this module.
    */
   imports?: ClassType[] | Set<ClassType>;
+  /**
+   * Priority level for the module.
+   * Higher priority modules will be loaded first.
+   */
+  priority?: number;
+  /**
+   * Registry to use for the module.
+   * Registry is used to store the module and its commands.
+   */
+  registry?: Registry;
 }
 /**
  * Decorator that marks a class as a CLI module.
@@ -277,7 +299,9 @@ interface CliModuleOptions {
  */
 declare function CliModule({
   commands,
-  imports
+  imports,
+  priority,
+  registry
 }?: CliModuleOptions): (target: ClassType, context: ClassDecoratorContext) => ClassType;
 //#endregion
 //#region src/interfaces/command-handler.interface.d.mts

package/lib/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":["ClassTypeWithInstance","NaviosModule","Container","CommanderApplicationOptions","CommanderApplication","Promise","ClassTypeWithInstance","NaviosModule","CommanderApplicationOptions","CommanderApplication","CommanderFactory","Promise","ClassType","ZodObject","CommandOptions","Command","path","optionsSchema","ClassDecoratorContext","ClassType","CliModuleOptions","Set","CliModule","commands","imports","ClassDecoratorContext","CommandHandler","TOptions","Promise","ClassType","ZodObject","CommandMetadataKey","CommandMetadata","Map","getCommandMetadata","ClassDecoratorContext","extractCommandMetadata","hasCommandMetadata","CommandMetadata","CommanderExecutionContext","ClassType","CliModuleMetadataKey","CliModuleMetadata","Set","Map","getCliModuleMetadata","ClassDecoratorContext","extractCliModuleMetadata","hasCliModuleMetadata","ClassTypeWithInstance","NaviosModule","Container","CommandHandler","CliModuleMetadata","CommandMetadata","CommandWithMetadata","CliModuleLoaderService","Promise","Map","ZodObject","ParsedCliArgs","Record","CliParserService","Array","InjectionToken","CommanderExecutionContext","CommandExecutionContext"],"sources":["../src/commander.application.d.mts","../src/commander.factory.d.mts","../src/decorators/command.decorator.d.mts","../src/decorators/cli-module.decorator.d.mts","../src/interfaces/command-handler.interface.d.mts","../src/metadata/command.metadata.d.mts","../src/interfaces/commander-execution-context.interface.d.mts","../src/metadata/cli-module.metadata.d.mts","../src/services/module-loader.service.d.mts","../src/services/cli-parser.service.d.mts","../src/tokens/execution-context.token.d.mts"],"sourcesContent":["import type { ClassTypeWithInstance, NaviosModule } from '@navios/core';\nimport { Container } from '@navios/core';\n/**\n * Configuration options for CommanderApplication.\n *\n * @public\n */\nexport interface CommanderApplicationOptions {\n}\n/**\n * Main application class for managing CLI command execution.\n *\n * This class handles module loading, command registration, and command execution.\n * It provides both programmatic and CLI-based command execution capabilities.\n *\n * @example\n * ```typescript\n * const app = await CommanderFactory.create(AppModule)\n * await app.init()\n * await app.run(process.argv)\n * ```\n */\nexport declare class CommanderApplication {\n    private moduleLoader;\n    private cliParser;\n    protected container: Container;\n    private appModule;\n    private options;\n    /**\n     * Indicates whether the application has been initialized.\n     * Set to `true` after `init()` is called successfully.\n     */\n    isInitialized: boolean;\n    /**\n     * @internal\n     * Sets up the application with the provided module and options.\n     * This is called automatically by CommanderFactory.create().\n     */\n    setup(appModule: ClassTypeWithInstance<NaviosModule>, options?: CommanderApplicationOptions): Promise<void>;\n    /**\n     * Gets the dependency injection container used by this application.\n     *\n     * @returns The Container instance\n     *\n     * @example\n     * ```typescript\n     * const container = app.getContainer()\n     * const service = await container.get(MyService)\n     * ```\n     */\n    getContainer(): Container;\n    /**\n     * Initializes the application by loading all modules and registering commands.\n     *\n     * This method must be called before executing commands or running the CLI.\n     * It traverses the module tree, loads all imported modules, and collects command metadata.\n     *\n     * @throws {Error} If the app module is not set (setup() was not called)\n     *\n     * @example\n     * ```typescript\n     * const app = await CommanderFactory.create(AppModule)\n     * await app.init() // Must be called before run() or executeCommand()\n     * ```\n     */\n    init(): Promise<void>;\n    /**\n     * Executes a command programmatically with the provided options.\n     *\n     * This method is useful for testing, automation, or programmatic workflows.\n     * The options will be validated against the command's Zod schema if one is provided.\n     *\n     * @param commandPath - The command path (e.g., 'greet', 'user:create')\n     * @param options - The command options object (will be validated if schema exists)\n     * @throws {Error} If the application is not initialized\n     * @throws {Error} If the command is not found\n     * @throws {Error} If the command does not implement the execute method\n     * @throws {ZodError} If options validation fails\n     *\n     * @example\n     * ```typescript\n     * await app.executeCommand('greet', {\n     *   name: 'World',\n     *   greeting: 'Hi'\n     * })\n     * ```\n     */\n    executeCommand(commandPath: string, options?: any): Promise<void>;\n    /**\n     * Gets all registered commands with their paths and class references.\n     *\n     * @returns An array of objects containing the command path and class\n     *\n     * @example\n     * ```typescript\n     * const commands = app.getAllCommands()\n     * commands.forEach(({ path }) => {\n     *   console.log(`Available: ${path}`)\n     * })\n     * ```\n     */\n    getAllCommands(): {\n        path: string;\n        class: ClassTypeWithInstance<any>;\n    }[];\n    /**\n     * Runs the CLI application by parsing command-line arguments and executing the appropriate command.\n     *\n     * This is the main entry point for CLI usage. It parses `argv`, validates options,\n     * and executes the matching command. Supports help command (`help`, `--help`, `-h`)\n     * which displays all available commands.\n     *\n     * @param argv - Command-line arguments array (defaults to `process.argv`)\n     * @throws {Error} If the application is not initialized\n     * @throws {Error} If no command is provided\n     * @throws {Error} If the command is not found\n     * @throws {ZodError} If options validation fails\n     *\n     * @example\n     * ```typescript\n     * // Parse and execute from process.argv\n     * await app.run()\n     *\n     * // Or provide custom arguments\n     * await app.run(['node', 'cli.js', 'greet', '--name', 'World'])\n     * ```\n     */\n    run(argv?: string[]): Promise<void>;\n    /**\n     * @internal\n     * Disposes of resources used by the application.\n     */\n    dispose(): Promise<void>;\n    /**\n     * Closes the application and cleans up resources.\n     *\n     * This should be called when the application is no longer needed to free up resources.\n     *\n     * @example\n     * ```typescript\n     * await app.run(process.argv)\n     * await app.close()\n     * ```\n     */\n    close(): Promise<void>;\n}\n//# sourceMappingURL=commander.application.d.mts.map","import type { ClassTypeWithInstance, NaviosModule } from '@navios/core';\nimport type { CommanderApplicationOptions } from './commander.application.mjs';\nimport { CommanderApplication } from './commander.application.mjs';\n/**\n * Factory class for creating and configuring CLI applications.\n *\n * @example\n * ```typescript\n * import { CommanderFactory } from '@navios/commander'\n * import { AppModule } from './app.module'\n *\n * async function bootstrap() {\n *   const app = await CommanderFactory.create(AppModule)\n *   await app.init()\n *   await app.run(process.argv)\n *   await app.close()\n * }\n * ```\n */\nexport declare class CommanderFactory {\n    /**\n     * Creates a new CommanderApplication instance and configures it with the provided module.\n     *\n     * @param appModule - The root CLI module class that contains commands and/or imports other modules\n     * @param options - Optional configuration options for the application\n     * @returns A promise that resolves to a configured CommanderApplication instance\n     *\n     * @example\n     * ```typescript\n     * const app = await CommanderFactory.create(AppModule)\n     * await app.init()\n     * ```\n     */\n    static create(appModule: ClassTypeWithInstance<NaviosModule>, options?: CommanderApplicationOptions): Promise<CommanderApplication>;\n}\n//# sourceMappingURL=commander.factory.d.mts.map","import type { ClassType } from '@navios/core';\nimport type { ZodObject } from 'zod';\n/**\n * Options for the `@Command` decorator.\n *\n * @public\n */\nexport interface CommandOptions {\n    /**\n     * The command path that users will invoke from the CLI.\n     * Can be a single word (e.g., 'greet') or multi-word with colons (e.g., 'user:create', 'db:migrate').\n     */\n    path: string;\n    /**\n     * Optional Zod schema for validating command options.\n     * If provided, options will be validated and parsed according to this schema.\n     */\n    optionsSchema?: ZodObject;\n}\n/**\n * Decorator that marks a class as a CLI command.\n *\n * The decorated class must implement the `CommandHandler` interface with an `execute` method.\n * The command will be automatically registered when its module is loaded.\n *\n * @param options - Configuration options for the command\n * @returns A class decorator function\n *\n * @example\n * ```typescript\n * import { Command, CommandHandler } from '@navios/commander'\n * import { z } from 'zod'\n *\n * const optionsSchema = z.object({\n *   name: z.string(),\n *   greeting: z.string().optional().default('Hello')\n * })\n *\n * @Command({\n *   path: 'greet',\n *   optionsSchema: optionsSchema\n * })\n * export class GreetCommand implements CommandHandler<z.infer<typeof optionsSchema>> {\n *   async execute(options) {\n *     console.log(`${options.greeting}, ${options.name}!`)\n *   }\n * }\n * ```\n */\nexport declare function Command({ path, optionsSchema }: CommandOptions): (target: ClassType, context: ClassDecoratorContext) => ClassType;\n//# sourceMappingURL=command.decorator.d.mts.map","import type { ClassType } from '@navios/core';\n/**\n * Options for the `@CliModule` decorator.\n *\n * @public\n */\nexport interface CliModuleOptions {\n    /**\n     * Array or Set of command classes to register in this module.\n     * Commands must be decorated with `@Command`.\n     */\n    commands?: ClassType[] | Set<ClassType>;\n    /**\n     * Array or Set of other CLI modules to import.\n     * Imported modules' commands will be available in this module.\n     */\n    imports?: ClassType[] | Set<ClassType>;\n}\n/**\n * Decorator that marks a class as a CLI module.\n *\n * Modules organize commands and can import other modules to compose larger CLI applications.\n * The module can optionally implement `NaviosModule` interface for lifecycle hooks.\n *\n * @param options - Configuration options for the module\n * @returns A class decorator function\n *\n * @example\n * ```typescript\n * import { CliModule } from '@navios/commander'\n * import { GreetCommand } from './greet.command'\n * import { UserModule } from './user.module'\n *\n * @CliModule({\n *   commands: [GreetCommand],\n *   imports: [UserModule]\n * })\n * export class AppModule {}\n * ```\n */\nexport declare function CliModule({ commands, imports }?: CliModuleOptions): (target: ClassType, context: ClassDecoratorContext) => ClassType;\n//# sourceMappingURL=cli-module.decorator.d.mts.map","/**\n * Interface that all command classes must implement.\n *\n * Commands decorated with `@Command` must implement this interface.\n * The `execute` method is called when the command is invoked.\n *\n * @template TOptions - The type of options that the command accepts\n *\n * @example\n * ```typescript\n * import { Command, CommandHandler } from '@navios/commander'\n * import { z } from 'zod'\n *\n * const optionsSchema = z.object({\n *   name: z.string()\n * })\n *\n * type Options = z.infer<typeof optionsSchema>\n *\n * @Command({ path: 'greet', optionsSchema })\n * export class GreetCommand implements CommandHandler<Options> {\n *   async execute(options: Options) {\n *     console.log(`Hello, ${options.name}!`)\n *   }\n * }\n * ```\n */\nexport interface CommandHandler<TOptions = any> {\n    /**\n     * Executes the command with the provided options.\n     *\n     * @param options - The validated command options (validated against the command's schema if provided)\n     * @returns A promise or void\n     */\n    execute(options: TOptions): void | Promise<void>;\n}\n//# sourceMappingURL=command-handler.interface.d.mts.map","import type { ClassType } from '@navios/core';\nimport type { ZodObject } from 'zod';\n/**\n * @internal\n * Symbol key used to store command metadata on classes.\n */\nexport declare const CommandMetadataKey: unique symbol;\n/**\n * Metadata associated with a command.\n *\n * @public\n */\nexport interface CommandMetadata {\n    /**\n     * The command path (e.g., 'greet', 'user:create').\n     */\n    path: string;\n    /**\n     * Optional Zod schema for validating command options.\n     */\n    optionsSchema?: ZodObject;\n    /**\n     * Map of custom attributes that can be attached to the command.\n     */\n    customAttributes: Map<string | symbol, any>;\n}\n/**\n * Gets or creates command metadata for a class.\n *\n * @internal\n * @param target - The command class\n * @param context - The decorator context\n * @param path - The command path\n * @param optionsSchema - Optional Zod schema\n * @returns The command metadata\n */\nexport declare function getCommandMetadata(target: ClassType, context: ClassDecoratorContext, path: string, optionsSchema?: ZodObject): CommandMetadata;\n/**\n * Extracts command metadata from a class.\n *\n * @param target - The command class\n * @returns The command metadata\n * @throws {Error} If the class is not decorated with @Command\n *\n * @example\n * ```typescript\n * const metadata = extractCommandMetadata(GreetCommand)\n * console.log(metadata.path) // 'greet'\n * ```\n */\nexport declare function extractCommandMetadata(target: ClassType): CommandMetadata;\n/**\n * Checks if a class has command metadata.\n *\n * @param target - The class to check\n * @returns `true` if the class is decorated with @Command, `false` otherwise\n */\nexport declare function hasCommandMetadata(target: ClassType): boolean;\n//# sourceMappingURL=command.metadata.d.mts.map","import type { CommandMetadata } from '../metadata/command.metadata.mjs';\n/**\n * Execution context for a command execution.\n *\n * Provides access to command metadata, path, and validated options during command execution.\n * This context is automatically injected and available via the `CommandExecutionContext` token.\n *\n * @example\n * ```typescript\n * import { inject, Injectable } from '@navios/di'\n * import { CommandExecutionContext } from '@navios/commander'\n *\n * @Injectable()\n * class CommandLogger {\n *   private ctx = inject(CommandExecutionContext)\n *\n *   log() {\n *     console.log('Command:', this.ctx.getCommandPath())\n *     console.log('Options:', this.ctx.getOptions())\n *   }\n * }\n * ```\n */\nexport declare class CommanderExecutionContext {\n    private readonly command;\n    private readonly commandPath;\n    private readonly options;\n    /**\n     * @internal\n     * Creates a new execution context.\n     */\n    constructor(command: CommandMetadata, commandPath: string, options: any);\n    /**\n     * Gets the command metadata.\n     *\n     * @returns The command metadata including path and options schema\n     */\n    getCommand(): CommandMetadata;\n    /**\n     * Gets the command path that was invoked.\n     *\n     * @returns The command path (e.g., 'greet', 'user:create')\n     */\n    getCommandPath(): string;\n    /**\n     * Gets the validated command options.\n     *\n     * Options are validated against the command's Zod schema if one was provided.\n     *\n     * @returns The validated options object\n     */\n    getOptions(): any;\n}\n//# sourceMappingURL=commander-execution-context.interface.d.mts.map","import type { ClassType } from '@navios/core';\n/**\n * @internal\n * Symbol key used to store CLI module metadata on classes.\n */\nexport declare const CliModuleMetadataKey: unique symbol;\n/**\n * Metadata associated with a CLI module.\n *\n * @public\n */\nexport interface CliModuleMetadata {\n    /**\n     * Set of command classes registered in this module.\n     */\n    commands: Set<ClassType>;\n    /**\n     * Set of other modules imported by this module.\n     */\n    imports: Set<ClassType>;\n    /**\n     * Map of custom attributes that can be attached to the module.\n     */\n    customAttributes: Map<string | symbol, any>;\n}\n/**\n * Gets or creates CLI module metadata for a class.\n *\n * @internal\n * @param target - The module class\n * @param context - The decorator context\n * @returns The module metadata\n */\nexport declare function getCliModuleMetadata(target: ClassType, context: ClassDecoratorContext): CliModuleMetadata;\n/**\n * Extracts CLI module metadata from a class.\n *\n * @param target - The module class\n * @returns The module metadata\n * @throws {Error} If the class is not decorated with @CliModule\n *\n * @example\n * ```typescript\n * const metadata = extractCliModuleMetadata(AppModule)\n * console.log(metadata.commands.size) // Number of commands\n * ```\n */\nexport declare function extractCliModuleMetadata(target: ClassType): CliModuleMetadata;\n/**\n * Checks if a class has CLI module metadata.\n *\n * @param target - The class to check\n * @returns `true` if the class is decorated with @CliModule, `false` otherwise\n */\nexport declare function hasCliModuleMetadata(target: ClassType): boolean;\n//# sourceMappingURL=cli-module.metadata.d.mts.map","import type { ClassTypeWithInstance, NaviosModule } from '@navios/core';\nimport { Container } from '@navios/core';\nimport type { CommandHandler } from '../interfaces/index.mjs';\nimport type { CliModuleMetadata, CommandMetadata } from '../metadata/index.mjs';\n/**\n * Command class with its associated metadata.\n *\n * @public\n */\nexport interface CommandWithMetadata {\n    /**\n     * The command class constructor.\n     */\n    class: ClassTypeWithInstance<CommandHandler>;\n    /**\n     * The command metadata including path and options schema.\n     */\n    metadata: CommandMetadata;\n}\n/**\n * Service for loading and managing CLI modules and commands.\n *\n * Handles module traversal, command registration, and metadata collection.\n * This service is used internally by CommanderApplication.\n *\n * @public\n */\nexport declare class CliModuleLoaderService {\n    protected container: Container;\n    private modulesMetadata;\n    private loadedModules;\n    private commandsMetadata;\n    private initialized;\n    /**\n     * Loads all modules starting from the root app module.\n     *\n     * Traverses the module tree, loads imported modules, and collects command metadata.\n     *\n     * @param appModule - The root CLI module\n     */\n    loadModules(appModule: ClassTypeWithInstance<NaviosModule>): Promise<void>;\n    private traverseModules;\n    private mergeMetadata;\n    /**\n     * Gets all loaded module metadata.\n     *\n     * @returns Map of module names to their metadata\n     */\n    getAllModules(): Map<string, CliModuleMetadata>;\n    /**\n     * Gets all command classes indexed by command class name.\n     *\n     * @returns Map of command class names to command classes\n     */\n    getAllCommands(): Map<string, ClassTypeWithInstance<any>>;\n    /**\n     * Get all commands with their metadata, indexed by command path.\n     * This is populated during loadModules, so path information is available\n     * before parsing CLI argv.\n     */\n    getAllCommandsWithMetadata(): Map<string, CommandWithMetadata>;\n    /**\n     * Get a command by its path, with metadata already extracted.\n     * Returns undefined if command is not found.\n     */\n    getCommandByPath(path: string): CommandWithMetadata | undefined;\n    /**\n     * Disposes of all loaded modules and commands, clearing internal state.\n     */\n    dispose(): void;\n}\n//# sourceMappingURL=module-loader.service.d.mts.map","import type { ZodObject } from 'zod';\n/**\n * Result of parsing command-line arguments.\n *\n * @public\n */\nexport interface ParsedCliArgs {\n    /**\n     * The command path (e.g., 'greet', 'user:create').\n     * Multi-word commands are joined with spaces.\n     */\n    command: string;\n    /**\n     * Parsed options as key-value pairs.\n     * Keys are converted from kebab-case to camelCase.\n     */\n    options: Record<string, any>;\n    /**\n     * Positional arguments that don't match any option flags.\n     */\n    positionals: string[];\n}\n/**\n * Service for parsing command-line arguments.\n *\n * Handles parsing of various CLI argument formats including:\n * - Long options: `--key value` or `--key=value`\n * - Short options: `-k value` or `-abc` (multiple flags)\n * - Boolean flags\n * - Array options\n * - Positional arguments\n *\n * @public\n */\nexport declare class CliParserService {\n    /**\n     * Parses command-line arguments from process.argv\n     * Commands can be multi-word (e.g., 'db migrate', 'cache clear')\n     * Expected format: node script.js command [subcommand...] --flag value --boolean-flag positional1 positional2\n     *\n     * @param argv - Array of command-line arguments (typically process.argv)\n     * @param optionsSchema - Optional Zod schema to determine boolean flags and option types\n     * @returns Parsed command (space-separated if multi-word), options, and positional arguments\n     */\n    parse(argv: string[], optionsSchema?: ZodObject): ParsedCliArgs;\n    /**\n     * Converts kebab-case to camelCase\n     */\n    private camelCase;\n    /**\n     * Attempts to parse string values into appropriate types\n     */\n    private parseValue;\n    /**\n     * Extracts boolean field names from a Zod schema\n     * Handles ZodObject, ZodOptional, and ZodDefault wrappers\n     */\n    private extractBooleanFields;\n    /**\n     * Extracts array field names from a Zod schema\n     * Handles ZodObject, ZodOptional, and ZodDefault wrappers\n     */\n    private extractArrayFields;\n    /**\n     * Checks if a Zod schema represents a boolean type\n     * Unwraps ZodOptional and ZodDefault\n     */\n    private isSchemaBoolean;\n    /**\n     * Checks if a Zod schema represents an array type\n     * Unwraps ZodOptional and ZodDefault\n     */\n    private isSchemaArray;\n    /**\n     * Formats help text listing all available commands.\n     *\n     * @param commands - Array of command objects with path and class\n     * @returns Formatted string listing all commands\n     */\n    formatCommandList(commands: Array<{\n        path: string;\n        class: any;\n    }>): string;\n}\n//# sourceMappingURL=cli-parser.service.d.mts.map","import { InjectionToken } from '@navios/core';\nimport type { CommanderExecutionContext } from '../interfaces/index.mjs';\n/**\n * Injection token for accessing the current command execution context.\n *\n * Use this token with `inject()` to access the `CommanderExecutionContext` in services\n * that need information about the currently executing command.\n *\n * @example\n * ```typescript\n * import { inject, Injectable } from '@navios/di'\n * import { CommandExecutionContext } from '@navios/commander'\n *\n * @Injectable()\n * class MyService {\n *   private ctx = inject(CommandExecutionContext)\n *\n *   doSomething() {\n *     const commandPath = this.ctx.getCommandPath()\n *     const options = this.ctx.getOptions()\n *     // Use context information...\n *   }\n * }\n * ```\n */\nexport declare const CommandExecutionContext: InjectionToken<CommanderExecutionContext, undefined, false>;\n//# sourceMappingURL=execution-context.token.d.mts.map"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":["ClassTypeWithInstance","NaviosModule","Container","CommanderApplicationOptions","CommanderApplication","Promise","ClassTypeWithInstance","NaviosModule","CommanderApplicationOptions","CommanderApplication","CommanderFactory","Promise","ClassType","Registry","ZodObject","CommandOptions","Command","path","optionsSchema","priority","registry","ClassDecoratorContext","ClassType","Registry","CliModuleOptions","Set","CliModule","commands","imports","priority","registry","ClassDecoratorContext","CommandHandler","TOptions","Promise","ClassType","ZodObject","CommandMetadataKey","CommandMetadata","Map","getCommandMetadata","ClassDecoratorContext","extractCommandMetadata","hasCommandMetadata","CommandMetadata","CommanderExecutionContext","ClassType","CliModuleMetadataKey","CliModuleMetadata","Set","Map","getCliModuleMetadata","ClassDecoratorContext","extractCliModuleMetadata","hasCliModuleMetadata","ClassTypeWithInstance","NaviosModule","Container","CommandHandler","CliModuleMetadata","CommandMetadata","CommandWithMetadata","CliModuleLoaderService","Promise","Map","ZodObject","ParsedCliArgs","Record","CliParserService","Array","InjectionToken","CommanderExecutionContext","CommandExecutionContext"],"sources":["../src/commander.application.d.mts","../src/commander.factory.d.mts","../src/decorators/command.decorator.d.mts","../src/decorators/cli-module.decorator.d.mts","../src/interfaces/command-handler.interface.d.mts","../src/metadata/command.metadata.d.mts","../src/interfaces/commander-execution-context.interface.d.mts","../src/metadata/cli-module.metadata.d.mts","../src/services/module-loader.service.d.mts","../src/services/cli-parser.service.d.mts","../src/tokens/execution-context.token.d.mts"],"sourcesContent":["import type { ClassTypeWithInstance, NaviosModule } from '@navios/core';\nimport { Container } from '@navios/core';\n/**\n * Configuration options for CommanderApplication.\n *\n * @public\n */\nexport interface CommanderApplicationOptions {\n}\n/**\n * Main application class for managing CLI command execution.\n *\n * This class handles module loading, command registration, and command execution.\n * It provides both programmatic and CLI-based command execution capabilities.\n *\n * @example\n * ```typescript\n * const app = await CommanderFactory.create(AppModule)\n * await app.init()\n * await app.run(process.argv)\n * ```\n */\nexport declare class CommanderApplication {\n    private moduleLoader;\n    private cliParser;\n    protected container: Container;\n    private appModule;\n    private options;\n    /**\n     * Indicates whether the application has been initialized.\n     * Set to `true` after `init()` is called successfully.\n     */\n    isInitialized: boolean;\n    /**\n     * @internal\n     * Sets up the application with the provided module and options.\n     * This is called automatically by CommanderFactory.create().\n     */\n    setup(appModule: ClassTypeWithInstance<NaviosModule>, options?: CommanderApplicationOptions): Promise<void>;\n    /**\n     * Gets the dependency injection container used by this application.\n     *\n     * @returns The Container instance\n     *\n     * @example\n     * ```typescript\n     * const container = app.getContainer()\n     * const service = await container.get(MyService)\n     * ```\n     */\n    getContainer(): Container;\n    /**\n     * Initializes the application by loading all modules and registering commands.\n     *\n     * This method must be called before executing commands or running the CLI.\n     * It traverses the module tree, loads all imported modules, and collects command metadata.\n     *\n     * @throws {Error} If the app module is not set (setup() was not called)\n     *\n     * @example\n     * ```typescript\n     * const app = await CommanderFactory.create(AppModule)\n     * await app.init() // Must be called before run() or executeCommand()\n     * ```\n     */\n    init(): Promise<void>;\n    /**\n     * Executes a command programmatically with the provided options.\n     *\n     * This method is useful for testing, automation, or programmatic workflows.\n     * The options will be validated against the command's Zod schema if one is provided.\n     *\n     * @param commandPath - The command path (e.g., 'greet', 'user:create')\n     * @param options - The command options object (will be validated if schema exists)\n     * @throws {Error} If the application is not initialized\n     * @throws {Error} If the command is not found\n     * @throws {Error} If the command does not implement the execute method\n     * @throws {ZodError} If options validation fails\n     *\n     * @example\n     * ```typescript\n     * await app.executeCommand('greet', {\n     *   name: 'World',\n     *   greeting: 'Hi'\n     * })\n     * ```\n     */\n    executeCommand(commandPath: string, options?: any): Promise<void>;\n    /**\n     * Gets all registered commands with their paths and class references.\n     *\n     * @returns An array of objects containing the command path and class\n     *\n     * @example\n     * ```typescript\n     * const commands = app.getAllCommands()\n     * commands.forEach(({ path }) => {\n     *   console.log(`Available: ${path}`)\n     * })\n     * ```\n     */\n    getAllCommands(): {\n        path: string;\n        class: ClassTypeWithInstance<any>;\n    }[];\n    /**\n     * Runs the CLI application by parsing command-line arguments and executing the appropriate command.\n     *\n     * This is the main entry point for CLI usage. It parses `argv`, validates options,\n     * and executes the matching command. Supports help command (`help`, `--help`, `-h`)\n     * which displays all available commands.\n     *\n     * @param argv - Command-line arguments array (defaults to `process.argv`)\n     * @throws {Error} If the application is not initialized\n     * @throws {Error} If no command is provided\n     * @throws {Error} If the command is not found\n     * @throws {ZodError} If options validation fails\n     *\n     * @example\n     * ```typescript\n     * // Parse and execute from process.argv\n     * await app.run()\n     *\n     * // Or provide custom arguments\n     * await app.run(['node', 'cli.js', 'greet', '--name', 'World'])\n     * ```\n     */\n    run(argv?: string[]): Promise<void>;\n    /**\n     * @internal\n     * Disposes of resources used by the application.\n     */\n    dispose(): Promise<void>;\n    /**\n     * Closes the application and cleans up resources.\n     *\n     * This should be called when the application is no longer needed to free up resources.\n     *\n     * @example\n     * ```typescript\n     * await app.run(process.argv)\n     * await app.close()\n     * ```\n     */\n    close(): Promise<void>;\n}\n//# sourceMappingURL=commander.application.d.mts.map","import type { ClassTypeWithInstance, NaviosModule } from '@navios/core';\nimport type { CommanderApplicationOptions } from './commander.application.mjs';\nimport { CommanderApplication } from './commander.application.mjs';\n/**\n * Factory class for creating and configuring CLI applications.\n *\n * @example\n * ```typescript\n * import { CommanderFactory } from '@navios/commander'\n * import { AppModule } from './app.module'\n *\n * async function bootstrap() {\n *   const app = await CommanderFactory.create(AppModule)\n *   await app.init()\n *   await app.run(process.argv)\n *   await app.close()\n * }\n * ```\n */\nexport declare class CommanderFactory {\n    /**\n     * Creates a new CommanderApplication instance and configures it with the provided module.\n     *\n     * @param appModule - The root CLI module class that contains commands and/or imports other modules\n     * @param options - Optional configuration options for the application\n     * @returns A promise that resolves to a configured CommanderApplication instance\n     *\n     * @example\n     * ```typescript\n     * const app = await CommanderFactory.create(AppModule)\n     * await app.init()\n     * ```\n     */\n    static create(appModule: ClassTypeWithInstance<NaviosModule>, options?: CommanderApplicationOptions): Promise<CommanderApplication>;\n}\n//# sourceMappingURL=commander.factory.d.mts.map","import type { ClassType, Registry } from '@navios/core';\nimport type { ZodObject } from 'zod';\n/**\n * Options for the `@Command` decorator.\n *\n * @public\n */\nexport interface CommandOptions {\n    /**\n     * The command path that users will invoke from the CLI.\n     * Can be a single word (e.g., 'greet') or multi-word with colons (e.g., 'user:create', 'db:migrate').\n     */\n    path: string;\n    /**\n     * Optional Zod schema for validating command options.\n     * If provided, options will be validated and parsed according to this schema.\n     */\n    optionsSchema?: ZodObject;\n    /**\n     * Priority level for the command.\n     * Higher priority commands will be loaded first.\n     */\n    priority?: number;\n    /**\n     * Registry to use for the command.\n     * Registry is used to store the command and its options schema.\n     */\n    registry?: Registry;\n}\n/**\n * Decorator that marks a class as a CLI command.\n *\n * The decorated class must implement the `CommandHandler` interface with an `execute` method.\n * The command will be automatically registered when its module is loaded.\n *\n * @param options - Configuration options for the command\n * @returns A class decorator function\n *\n * @example\n * ```typescript\n * import { Command, CommandHandler } from '@navios/commander'\n * import { z } from 'zod'\n *\n * const optionsSchema = z.object({\n *   name: z.string(),\n *   greeting: z.string().optional().default('Hello')\n * })\n *\n * @Command({\n *   path: 'greet',\n *   optionsSchema: optionsSchema\n * })\n * export class GreetCommand implements CommandHandler<z.infer<typeof optionsSchema>> {\n *   async execute(options) {\n *     console.log(`${options.greeting}, ${options.name}!`)\n *   }\n * }\n * ```\n */\nexport declare function Command({ path, optionsSchema, priority, registry, }: CommandOptions): (target: ClassType, context: ClassDecoratorContext) => ClassType;\n//# sourceMappingURL=command.decorator.d.mts.map","import type { ClassType, Registry } from '@navios/core';\n/**\n * Options for the `@CliModule` decorator.\n *\n * @public\n */\nexport interface CliModuleOptions {\n    /**\n     * Array or Set of command classes to register in this module.\n     * Commands must be decorated with `@Command`.\n     */\n    commands?: ClassType[] | Set<ClassType>;\n    /**\n     * Array or Set of other CLI modules to import.\n     * Imported modules' commands will be available in this module.\n     */\n    imports?: ClassType[] | Set<ClassType>;\n    /**\n     * Priority level for the module.\n     * Higher priority modules will be loaded first.\n     */\n    priority?: number;\n    /**\n     * Registry to use for the module.\n     * Registry is used to store the module and its commands.\n     */\n    registry?: Registry;\n}\n/**\n * Decorator that marks a class as a CLI module.\n *\n * Modules organize commands and can import other modules to compose larger CLI applications.\n * The module can optionally implement `NaviosModule` interface for lifecycle hooks.\n *\n * @param options - Configuration options for the module\n * @returns A class decorator function\n *\n * @example\n * ```typescript\n * import { CliModule } from '@navios/commander'\n * import { GreetCommand } from './greet.command'\n * import { UserModule } from './user.module'\n *\n * @CliModule({\n *   commands: [GreetCommand],\n *   imports: [UserModule]\n * })\n * export class AppModule {}\n * ```\n */\nexport declare function CliModule({ commands, imports, priority, registry }?: CliModuleOptions): (target: ClassType, context: ClassDecoratorContext) => ClassType;\n//# sourceMappingURL=cli-module.decorator.d.mts.map","/**\n * Interface that all command classes must implement.\n *\n * Commands decorated with `@Command` must implement this interface.\n * The `execute` method is called when the command is invoked.\n *\n * @template TOptions - The type of options that the command accepts\n *\n * @example\n * ```typescript\n * import { Command, CommandHandler } from '@navios/commander'\n * import { z } from 'zod'\n *\n * const optionsSchema = z.object({\n *   name: z.string()\n * })\n *\n * type Options = z.infer<typeof optionsSchema>\n *\n * @Command({ path: 'greet', optionsSchema })\n * export class GreetCommand implements CommandHandler<Options> {\n *   async execute(options: Options) {\n *     console.log(`Hello, ${options.name}!`)\n *   }\n * }\n * ```\n */\nexport interface CommandHandler<TOptions = any> {\n    /**\n     * Executes the command with the provided options.\n     *\n     * @param options - The validated command options (validated against the command's schema if provided)\n     * @returns A promise or void\n     */\n    execute(options: TOptions): void | Promise<void>;\n}\n//# sourceMappingURL=command-handler.interface.d.mts.map","import type { ClassType } from '@navios/core';\nimport type { ZodObject } from 'zod';\n/**\n * @internal\n * Symbol key used to store command metadata on classes.\n */\nexport declare const CommandMetadataKey: unique symbol;\n/**\n * Metadata associated with a command.\n *\n * @public\n */\nexport interface CommandMetadata {\n    /**\n     * The command path (e.g., 'greet', 'user:create').\n     */\n    path: string;\n    /**\n     * Optional Zod schema for validating command options.\n     */\n    optionsSchema?: ZodObject;\n    /**\n     * Map of custom attributes that can be attached to the command.\n     */\n    customAttributes: Map<string | symbol, any>;\n}\n/**\n * Gets or creates command metadata for a class.\n *\n * @internal\n * @param target - The command class\n * @param context - The decorator context\n * @param path - The command path\n * @param optionsSchema - Optional Zod schema\n * @returns The command metadata\n */\nexport declare function getCommandMetadata(target: ClassType, context: ClassDecoratorContext, path: string, optionsSchema?: ZodObject): CommandMetadata;\n/**\n * Extracts command metadata from a class.\n *\n * @param target - The command class\n * @returns The command metadata\n * @throws {Error} If the class is not decorated with @Command\n *\n * @example\n * ```typescript\n * const metadata = extractCommandMetadata(GreetCommand)\n * console.log(metadata.path) // 'greet'\n * ```\n */\nexport declare function extractCommandMetadata(target: ClassType): CommandMetadata;\n/**\n * Checks if a class has command metadata.\n *\n * @param target - The class to check\n * @returns `true` if the class is decorated with @Command, `false` otherwise\n */\nexport declare function hasCommandMetadata(target: ClassType): boolean;\n//# sourceMappingURL=command.metadata.d.mts.map","import type { CommandMetadata } from '../metadata/command.metadata.mjs';\n/**\n * Execution context for a command execution.\n *\n * Provides access to command metadata, path, and validated options during command execution.\n * This context is automatically injected and available via the `CommandExecutionContext` token.\n *\n * @example\n * ```typescript\n * import { inject, Injectable } from '@navios/di'\n * import { CommandExecutionContext } from '@navios/commander'\n *\n * @Injectable()\n * class CommandLogger {\n *   private ctx = inject(CommandExecutionContext)\n *\n *   log() {\n *     console.log('Command:', this.ctx.getCommandPath())\n *     console.log('Options:', this.ctx.getOptions())\n *   }\n * }\n * ```\n */\nexport declare class CommanderExecutionContext {\n    private readonly command;\n    private readonly commandPath;\n    private readonly options;\n    /**\n     * @internal\n     * Creates a new execution context.\n     */\n    constructor(command: CommandMetadata, commandPath: string, options: any);\n    /**\n     * Gets the command metadata.\n     *\n     * @returns The command metadata including path and options schema\n     */\n    getCommand(): CommandMetadata;\n    /**\n     * Gets the command path that was invoked.\n     *\n     * @returns The command path (e.g., 'greet', 'user:create')\n     */\n    getCommandPath(): string;\n    /**\n     * Gets the validated command options.\n     *\n     * Options are validated against the command's Zod schema if one was provided.\n     *\n     * @returns The validated options object\n     */\n    getOptions(): any;\n}\n//# sourceMappingURL=commander-execution-context.interface.d.mts.map","import type { ClassType } from '@navios/core';\n/**\n * @internal\n * Symbol key used to store CLI module metadata on classes.\n */\nexport declare const CliModuleMetadataKey: unique symbol;\n/**\n * Metadata associated with a CLI module.\n *\n * @public\n */\nexport interface CliModuleMetadata {\n    /**\n     * Set of command classes registered in this module.\n     */\n    commands: Set<ClassType>;\n    /**\n     * Set of other modules imported by this module.\n     */\n    imports: Set<ClassType>;\n    /**\n     * Map of custom attributes that can be attached to the module.\n     */\n    customAttributes: Map<string | symbol, any>;\n}\n/**\n * Gets or creates CLI module metadata for a class.\n *\n * @internal\n * @param target - The module class\n * @param context - The decorator context\n * @returns The module metadata\n */\nexport declare function getCliModuleMetadata(target: ClassType, context: ClassDecoratorContext): CliModuleMetadata;\n/**\n * Extracts CLI module metadata from a class.\n *\n * @param target - The module class\n * @returns The module metadata\n * @throws {Error} If the class is not decorated with @CliModule\n *\n * @example\n * ```typescript\n * const metadata = extractCliModuleMetadata(AppModule)\n * console.log(metadata.commands.size) // Number of commands\n * ```\n */\nexport declare function extractCliModuleMetadata(target: ClassType): CliModuleMetadata;\n/**\n * Checks if a class has CLI module metadata.\n *\n * @param target - The class to check\n * @returns `true` if the class is decorated with @CliModule, `false` otherwise\n */\nexport declare function hasCliModuleMetadata(target: ClassType): boolean;\n//# sourceMappingURL=cli-module.metadata.d.mts.map","import type { ClassTypeWithInstance, NaviosModule } from '@navios/core';\nimport { Container } from '@navios/core';\nimport type { CommandHandler } from '../interfaces/index.mjs';\nimport type { CliModuleMetadata, CommandMetadata } from '../metadata/index.mjs';\n/**\n * Command class with its associated metadata.\n *\n * @public\n */\nexport interface CommandWithMetadata {\n    /**\n     * The command class constructor.\n     */\n    class: ClassTypeWithInstance<CommandHandler>;\n    /**\n     * The command metadata including path and options schema.\n     */\n    metadata: CommandMetadata;\n}\n/**\n * Service for loading and managing CLI modules and commands.\n *\n * Handles module traversal, command registration, and metadata collection.\n * This service is used internally by CommanderApplication.\n *\n * @public\n */\nexport declare class CliModuleLoaderService {\n    protected container: Container;\n    private modulesMetadata;\n    private loadedModules;\n    private commandsMetadata;\n    private initialized;\n    /**\n     * Loads all modules starting from the root app module.\n     *\n     * Traverses the module tree, loads imported modules, and collects command metadata.\n     *\n     * @param appModule - The root CLI module\n     */\n    loadModules(appModule: ClassTypeWithInstance<NaviosModule>): Promise<void>;\n    private traverseModules;\n    private mergeMetadata;\n    /**\n     * Gets all loaded module metadata.\n     *\n     * @returns Map of module names to their metadata\n     */\n    getAllModules(): Map<string, CliModuleMetadata>;\n    /**\n     * Gets all command classes indexed by command class name.\n     *\n     * @returns Map of command class names to command classes\n     */\n    getAllCommands(): Map<string, ClassTypeWithInstance<any>>;\n    /**\n     * Get all commands with their metadata, indexed by command path.\n     * This is populated during loadModules, so path information is available\n     * before parsing CLI argv.\n     */\n    getAllCommandsWithMetadata(): Map<string, CommandWithMetadata>;\n    /**\n     * Get a command by its path, with metadata already extracted.\n     * Returns undefined if command is not found.\n     */\n    getCommandByPath(path: string): CommandWithMetadata | undefined;\n    /**\n     * Disposes of all loaded modules and commands, clearing internal state.\n     */\n    dispose(): void;\n}\n//# sourceMappingURL=module-loader.service.d.mts.map","import type { ZodObject } from 'zod';\n/**\n * Result of parsing command-line arguments.\n *\n * @public\n */\nexport interface ParsedCliArgs {\n    /**\n     * The command path (e.g., 'greet', 'user:create').\n     * Multi-word commands are joined with spaces.\n     */\n    command: string;\n    /**\n     * Parsed options as key-value pairs.\n     * Keys are converted from kebab-case to camelCase.\n     */\n    options: Record<string, any>;\n    /**\n     * Positional arguments that don't match any option flags.\n     */\n    positionals: string[];\n}\n/**\n * Service for parsing command-line arguments.\n *\n * Handles parsing of various CLI argument formats including:\n * - Long options: `--key value` or `--key=value`\n * - Short options: `-k value` or `-abc` (multiple flags)\n * - Boolean flags\n * - Array options\n * - Positional arguments\n *\n * @public\n */\nexport declare class CliParserService {\n    /**\n     * Parses command-line arguments from process.argv\n     * Commands can be multi-word (e.g., 'db migrate', 'cache clear')\n     * Expected format: node script.js command [subcommand...] --flag value --boolean-flag positional1 positional2\n     *\n     * @param argv - Array of command-line arguments (typically process.argv)\n     * @param optionsSchema - Optional Zod schema to determine boolean flags and option types\n     * @returns Parsed command (space-separated if multi-word), options, and positional arguments\n     */\n    parse(argv: string[], optionsSchema?: ZodObject): ParsedCliArgs;\n    /**\n     * Converts kebab-case to camelCase\n     */\n    private camelCase;\n    /**\n     * Attempts to parse string values into appropriate types\n     */\n    private parseValue;\n    /**\n     * Extracts boolean field names from a Zod schema\n     * Handles ZodObject, ZodOptional, and ZodDefault wrappers\n     */\n    private extractBooleanFields;\n    /**\n     * Extracts array field names from a Zod schema\n     * Handles ZodObject, ZodOptional, and ZodDefault wrappers\n     */\n    private extractArrayFields;\n    /**\n     * Checks if a Zod schema represents a boolean type\n     * Unwraps ZodOptional and ZodDefault\n     */\n    private isSchemaBoolean;\n    /**\n     * Checks if a Zod schema represents an array type\n     * Unwraps ZodOptional and ZodDefault\n     */\n    private isSchemaArray;\n    /**\n     * Formats help text listing all available commands.\n     *\n     * @param commands - Array of command objects with path and class\n     * @returns Formatted string listing all commands\n     */\n    formatCommandList(commands: Array<{\n        path: string;\n        class: any;\n    }>): string;\n}\n//# sourceMappingURL=cli-parser.service.d.mts.map","import { InjectionToken } from '@navios/core';\nimport type { CommanderExecutionContext } from '../interfaces/index.mjs';\n/**\n * Injection token for accessing the current command execution context.\n *\n * Use this token with `inject()` to access the `CommanderExecutionContext` in services\n * that need information about the currently executing command.\n *\n * @example\n * ```typescript\n * import { inject, Injectable } from '@navios/di'\n * import { CommandExecutionContext } from '@navios/commander'\n *\n * @Injectable()\n * class MyService {\n *   private ctx = inject(CommandExecutionContext)\n *\n *   doSomething() {\n *     const commandPath = this.ctx.getCommandPath()\n *     const options = this.ctx.getOptions()\n *     // Use context information...\n *   }\n * }\n * ```\n */\nexport declare const CommandExecutionContext: InjectionToken<CommanderExecutionContext, undefined, false>;\n//# sourceMappingURL=execution-context.token.d.mts.map"],"mappings":"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"}

package/lib/index.mjs

@@ -1,4 +1,4 @@
-import { Container, Factory, Injectable, InjectableScope, InjectableType, InjectionToken, getInjectableToken, inject } from "@navios/di";
+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 { inspect } from "util";
@@ -41,7 +41,7 @@ var __copyProps = (to, from, except, desc) => {
 var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
 
 //#endregion
-//#region ../core/lib/use-guards.decorator-CUww54Nt.mjs
+//#region ../core/lib/use-guards.decorator-CzVXuLkz.mjs
 const EndpointMetadataKey = Symbol("EndpointMetadataKey");
 function getAllEndpointMetadata(context) {
 	if (context.metadata) {
@@ -151,7 +151,7 @@ function hasModuleMetadata(target) {
 *   }
 * }
 * ```
-*/ function Controller({ guards, registry } = {}) {
+*/ function Controller({ guards, registry, priority, scope } = {}) {
 	return function(target, context) {
 		if (context.kind !== "class") throw new Error("[Navios] @Controller decorator can only be used on classes.");
 		const token = InjectionToken.create(target);
@@ -161,7 +161,9 @@ function hasModuleMetadata(target) {
 		}
 		return Injectable({
 			token,
-			registry
+			registry,
+			priority,
+			scope
 		})(target, context);
 	};
 }
@@ -246,13 +248,13 @@ function Endpoint(endpoint) {
 }
 /**
 * Decorator that marks a class as a Navios module.
-* 
+*
 * Modules are the basic building blocks of a Navios application.
 * They organize controllers, services, and other modules into logical units.
-* 
+*
 * @param options - Module configuration options
 * @returns A class decorator
-* 
+*
 * @example
 * ```typescript
 * @Module({
@@ -262,7 +264,7 @@ function Endpoint(endpoint) {
 * })
 * export class AppModule {}
 * ```
-*/ function Module({ controllers = [], imports = [], guards = [] } = {
+*/ function Module({ controllers = [], imports = [], guards = [], priority, registry } = {
 	controllers: [],
 	imports: [],
 	guards: []
@@ -276,7 +278,9 @@ function Endpoint(endpoint) {
 		for (const guard of Array.from(guards).reverse()) moduleMetadata.guards.add(guard);
 		return Injectable({
 			token,
-			scope: InjectableScope.Singleton
+			scope: InjectableScope.Singleton,
+			priority,
+			registry
 		})(target, context);
 	};
 }
@@ -380,7 +384,7 @@ function Stream(endpoint) {
 };
 
 //#endregion
-//#region ../core/lib/src-gBAChVRL.mjs
+//#region ../core/lib/src-Bo23RIo-.mjs
 function envInt(key, defaultValue) {
 	const envKey = env[key] || process.env[key];
 	return envKey ? parseInt(envKey, 10) : defaultValue;
@@ -3054,7 +3058,7 @@ _dec$9 = Injectable();
 	async traverseModules(module, parentMetadata) {
 		const metadata = extractModuleMetadata(module);
 		if (parentMetadata) this.mergeMetadata(metadata, parentMetadata);
-		const moduleName = module.name;
+		const moduleName = getInjectableToken(module).id;
 		if (this.modulesMetadata.has(moduleName)) return;
 		try {
 			this.modulesMetadata.set(moduleName, metadata);
@@ -3451,7 +3455,7 @@ _dec$8 = Injectable();
 	}
 	httpTokens = /* @__PURE__ */ new Map();
 	setupHttpEnvironment(tokens) {
-		this.httpTokens = tokens;
+		for (const [token, value] of tokens) this.httpTokens.set(token, value);
 	}
 	getHttpToken(token) {
 		return this.httpTokens.get(token);
@@ -6088,9 +6092,9 @@ _dec$15 = Injectable();
 	* })
 	* ```
 	*/ static async create(appModule, options = { adapter: [] }) {
-		const container = options.container ?? new Container();
+		const container = options.container ?? new Container(options.registry);
 		if (options.enableRequestId === true) setRequestIdEnabled(true);
-		container.getServiceLocator().getManager().storeCreatedHolder(NaviosOptionsToken.toString(), options, InjectableType.Class, InjectableScope.Singleton);
+		container.addInstance(NaviosOptionsToken, options);
 		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);
@@ -6105,11 +6109,14 @@ _dec$15 = Injectable();
 	}
 	static async registerLoggerConfiguration(container, options) {
 		const { logger } = options;
-		if (Array.isArray(logger) || isNil(logger)) {
-			(await container.get(LoggerOutput))?.setup({ logLevels: logger });
+		if (Array.isArray(logger) || isNil(logger) || options.enableRequestId) {
+			(await container.get(LoggerOutput))?.setup({
+				logLevels: Array.isArray(logger) ? logger : void 0,
+				requestId: options.enableRequestId ?? false
+			});
 			return;
 		}
-		if (logger !== true && !isNil(logger)) container.getServiceLocator().getManager().storeCreatedHolder(LoggerOutput.toString(), logger, InjectableType.Class, InjectableScope.Singleton);
+		if (logger !== true && !isNil(logger)) container.addInstance(LoggerOutput, logger);
 	}
 };
 
@@ -6685,7 +6692,7 @@ var CliModuleLoaderService = class {
 	async traverseModules(module, parentMetadata) {
 		const metadata = extractCliModuleMetadata(module);
 		if (parentMetadata) this.mergeMetadata(metadata, parentMetadata);
-		const moduleName = module.name;
+		const moduleName = (0, lib_exports.getInjectableToken)(module).id;
 		if (this.modulesMetadata.has(moduleName)) return;
 		this.modulesMetadata.set(moduleName, metadata);
 		for (const command of metadata.commands) {
@@ -7774,14 +7781,16 @@ var CommanderApplication = class {
 *   }
 * }
 * ```
-*/ function Command({ path, optionsSchema }) {
+*/ function Command({ path, 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 = lib_exports.InjectionToken.create(target);
 		if (context.metadata) getCommandMetadata(target, context, path, optionsSchema);
 		return (0, lib_exports.Injectable)({
 			token,
-			scope: lib_exports.InjectableScope.Singleton
+			scope: lib_exports.InjectableScope.Singleton,
+			priority,
+			registry
 		})(target, context);
 	};
 }
@@ -7809,7 +7818,7 @@ var CommanderApplication = class {
 * })
 * export class AppModule {}
 * ```
-*/ function CliModule({ commands = [], imports = [] } = {
+*/ function CliModule({ commands = [], imports = [], priority, registry } = {
 	commands: [],
 	imports: []
 }) {
@@ -7821,7 +7830,9 @@ var CommanderApplication = class {
 		for (const importedModule of imports) moduleMetadata.imports.add(importedModule);
 		return (0, lib_exports.Injectable)({
 			token,
-			scope: lib_exports.InjectableScope.Singleton
+			scope: lib_exports.InjectableScope.Singleton,
+			priority,
+			registry
 		})(target, context);
 	};
 }