@navios/commander 0.5.0

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2025 Oleksandr Hanzha
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,242 @@
+# @navios/commander
+
+A CLI command framework built on `@navios/di` that provides a decorator-based approach to building command-line applications, similar to how `@navios/core` works for HTTP applications.
+
+## Installation
+
+```bash
+npm install @navios/commander @navios/di zod
+```
+
+## Features
+
+- **Decorator-based**: Use `@Command` and `@CliModule` decorators to define commands and modules
+- **Dependency Injection**: Full integration with `@navios/di`
+- **Schema Validation**: Built-in support for Zod schemas to validate command options
+- **Modular Architecture**: Organize commands into modules with imports support
+
+## Usage
+
+### Creating a Command
+
+Commands are defined using the `@Command` decorator. Each command must implement the `CommandHandler` interface with an `execute` method.
+
+```typescript
+import { Command, CommandHandler } from '@navios/commander'
+import { z } from 'zod'
+
+const greetOptionsSchema = z.object({
+  name: z.string(),
+  greeting: z.string().optional().default('Hello'),
+})
+
+type GreetOptions = z.infer<typeof greetOptionsSchema>
+
+@Command({
+  path: 'greet',
+  optionsSchema: greetOptionsSchema,
+})
+export class GreetCommand implements CommandHandler<GreetOptions> {
+  async execute(options: GreetOptions) {
+    console.log(`${options.greeting}, ${options.name}!`)
+  }
+}
+```
+
+### Creating a CLI Module
+
+Modules organize commands and can import other modules:
+
+```typescript
+import { CliModule } from '@navios/commander'
+import { GreetCommand } from './greet.command'
+
+@CliModule({
+  commands: [GreetCommand],
+})
+export class AppModule {}
+```
+
+### Bootstrapping the Application
+
+Use `CommanderFactory` to create and run your CLI application:
+
+```typescript
+import { CommanderFactory } from '@navios/commander'
+import { AppModule } from './app.module'
+
+async function bootstrap() {
+  const app = await CommanderFactory.create(AppModule)
+  await app.init()
+
+  // Run with command-line arguments
+  await app.run(process.argv)
+
+  await app.close()
+}
+
+bootstrap()
+```
+
+Then run your CLI:
+
+```bash
+node dist/cli.js greet --name World --greeting Hi
+```
+
+### Advanced Example with Dependency Injection
+
+```typescript
+import { Command, CommandHandler, CliModule } from '@navios/commander'
+import { Injectable, inject } from '@navios/di'
+import { z } from 'zod'
+
+// Service
+@Injectable()
+class UserService {
+  async getUser(id: string) {
+    return { id, name: 'John Doe' }
+  }
+}
+
+// Command with injected service
+const userOptionsSchema = z.object({
+  userId: z.string(),
+})
+
+@Command({
+  path: 'user:show',
+  optionsSchema: userOptionsSchema,
+})
+export class ShowUserCommand implements CommandHandler<z.infer<typeof userOptionsSchema>> {
+  private userService = inject(UserService)
+
+  async execute(options: { userId: string }) {
+    const user = await this.userService.getUser(options.userId)
+    console.log(`User: ${user.name} (ID: ${user.id})`)
+  }
+}
+
+// Module
+@CliModule({
+  commands: [ShowUserCommand],
+})
+export class UserModule {}
+
+@CliModule({
+  imports: [UserModule],
+})
+export class AppModule {}
+```
+
+### Listing All Commands
+
+```typescript
+const app = await CommanderFactory.create(AppModule)
+await app.init()
+
+const commands = app.getAllCommands()
+console.log('Available commands:')
+commands.forEach(({ path }) => {
+  console.log(`  - ${path}`)
+})
+```
+
+## Advanced Usage
+
+### Programmatic Command Execution
+
+For advanced use cases where you need to execute commands programmatically (e.g., in tests or programmatic workflows), you can use `executeCommand`:
+
+```typescript
+import { CommanderFactory } from '@navios/commander'
+import { AppModule } from './app.module'
+
+async function bootstrap() {
+  const app = await CommanderFactory.create(AppModule)
+  await app.init()
+
+  // Execute a command programmatically
+  await app.executeCommand('greet', {
+    name: 'World',
+    greeting: 'Hi',
+  })
+
+  await app.close()
+}
+
+bootstrap()
+```
+
+This is useful for:
+- Unit and integration testing
+- Building CLI tools that wrap other CLI tools
+- Programmatic automation workflows
+
+## API Reference
+
+### Decorators
+
+#### `@Command(options)`
+
+Defines a CLI command.
+
+**Options:**
+- `path: string` - The command path (e.g., 'user:create', 'db:migrate')
+- `optionsSchema?: ZodSchema` - Optional Zod schema for validating command options
+
+#### `@CliModule(options)`
+
+Defines a CLI module.
+
+**Options:**
+- `commands?: ClassType[]` - Array of command classes
+- `imports?: ClassType[]` - Array of other modules to import
+
+### Interfaces
+
+#### `CommandHandler<TOptions>`
+
+Interface that command classes must implement.
+
+```typescript
+interface CommandHandler<TOptions = any> {
+  execute(options: TOptions): void | Promise<void>
+}
+```
+
+#### `CliModule`
+
+Optional lifecycle hooks for modules.
+
+```typescript
+interface CliModule {
+  onModuleInit?(): void | Promise<void>
+  onModuleDestroy?(): void | Promise<void>
+}
+```
+
+### Classes
+
+#### `CommanderFactory`
+
+Factory class for creating CLI applications.
+
+**Methods:**
+- `static async create(appModule, options?)` - Creates a new CommanderApplication
+
+#### `CommanderApplication`
+
+Main application class.
+
+**Methods:**
+- `async init()` - Initializes the application
+- `async run(argv)` - Parses command-line arguments and executes the appropriate command (default usage)
+- `async executeCommand(path, options?)` - Executes a command programmatically with options (advanced usage)
+- `getAllCommands()` - Returns all registered commands
+- `getContainer()` - Returns the DI container
+- `async close()` - Closes the application
+
+## License
+
+MIT

package/dist/src/commander.application.d.mts

@@ -0,0 +1,29 @@
+import type { ClassTypeWithInstance } from '@navios/di';
+import { Container } from '@navios/di';
+import type { Module } from './interfaces/index.mjs';
+export interface CommanderApplicationOptions {
+}
+export declare class CommanderApplication {
+    private moduleLoader;
+    private cliParser;
+    protected container: Container;
+    private appModule;
+    private options;
+    isInitialized: boolean;
+    setup(appModule: ClassTypeWithInstance<Module>, options?: CommanderApplicationOptions): Promise<void>;
+    getContainer(): Container;
+    init(): Promise<void>;
+    executeCommand(commandPath: string, options?: any): Promise<void>;
+    getAllCommands(): {
+        path: string;
+        class: ClassTypeWithInstance<any>;
+    }[];
+    /**
+     * Runs the CLI application by parsing process.argv and executing the command
+     * @param argv - Command-line arguments (defaults to process.argv)
+     */
+    run(argv?: string[]): Promise<void>;
+    dispose(): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=commander.application.d.mts.map

package/dist/src/commander.application.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commander.application.d.mts","sourceRoot":"","sources":["../../src/commander.application.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAkB,MAAM,YAAY,CAAA;AAEvE,OAAO,EAAE,SAAS,EAAsB,MAAM,YAAY,CAAA;AAE1D,OAAO,KAAK,EAAkB,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAIpE,MAAM,WAAW,2BAA2B;CAAG;AAE/C,qBACa,oBAAoB;IAC/B,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,SAAS,CAA2B;IAC5C,SAAS,CAAC,SAAS,YAAoB;IAEvC,OAAO,CAAC,SAAS,CAA6C;IAC9D,OAAO,CAAC,OAAO,CAAkC;IAEjD,aAAa,UAAQ;IAEf,KAAK,CACT,SAAS,EAAE,qBAAqB,CAAC,MAAM,CAAC,EACxC,OAAO,GAAE,2BAAgC;IAM3C,YAAY;IAIN,IAAI;IAUJ,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,GAAQ;IAoC3D,cAAc;cAIJ,MAAM;eACL,qBAAqB,CAAC,GAAG,CAAC;;IAarC;;;OAGG;IACG,GAAG,CAAC,IAAI,GAAE,MAAM,EAAiB;IAgDjC,OAAO;IAMP,KAAK;CAGZ"}

package/dist/src/commander.factory.d.mts

@@ -0,0 +1,8 @@
+import type { ClassTypeWithInstance } from '@navios/di';
+import type { CommanderApplicationOptions } from './commander.application.mjs';
+import type { Module } from './interfaces/index.mjs';
+import { CommanderApplication } from './commander.application.mjs';
+export declare class CommanderFactory {
+    static create(appModule: ClassTypeWithInstance<Module>, options?: CommanderApplicationOptions): Promise<CommanderApplication>;
+}
+//# sourceMappingURL=commander.factory.d.mts.map

package/dist/src/commander.factory.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commander.factory.d.mts","sourceRoot":"","sources":["../../src/commander.factory.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAIvD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAA;AAC9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAEpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAElE,qBAAa,gBAAgB;WACd,MAAM,CACjB,SAAS,EAAE,qBAAqB,CAAC,MAAM,CAAC,EACxC,OAAO,GAAE,2BAAgC;CAO5C"}

package/dist/src/decorators/cli-module.decorator.d.mts

@@ -0,0 +1,7 @@
+import type { ClassType } from '@navios/di';
+export interface CliModuleOptions {
+    commands?: ClassType[] | Set<ClassType>;
+    imports?: ClassType[] | Set<ClassType>;
+}
+export declare function CliModule({ commands, imports }?: CliModuleOptions): (target: ClassType, context: ClassDecoratorContext) => ClassType;
+//# sourceMappingURL=cli-module.decorator.d.mts.map

package/dist/src/decorators/cli-module.decorator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-module.decorator.d.mts","sourceRoot":"","sources":["../../../src/decorators/cli-module.decorator.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAM3C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC,SAAS,CAAC,CAAA;IACvC,OAAO,CAAC,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC,SAAS,CAAC,CAAA;CACvC;AAED,wBAAgB,SAAS,CACvB,EAAE,QAAa,EAAE,OAAY,EAAE,GAAE,gBAGhC,IAEO,QAAQ,SAAS,EAAE,SAAS,qBAAqB,eAqB1D"}

package/dist/src/decorators/command.decorator.d.mts

@@ -0,0 +1,8 @@
+import type { ClassType } from '@navios/di';
+import type { ZodObject } from 'zod';
+export interface CommandOptions {
+    path: string;
+    optionsSchema?: ZodObject;
+}
+export declare function Command({ path, optionsSchema }: CommandOptions): (target: ClassType, context: ClassDecoratorContext) => ClassType;
+//# sourceMappingURL=command.decorator.d.mts.map

package/dist/src/decorators/command.decorator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.decorator.d.mts","sourceRoot":"","sources":["../../../src/decorators/command.decorator.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAMpC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,CAAC,EAAE,SAAS,CAAA;CAC1B;AAED,wBAAgB,OAAO,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,cAAc,IAC5C,QAAQ,SAAS,EAAE,SAAS,qBAAqB,eAenE"}

package/dist/src/decorators/index.d.mts

@@ -0,0 +1,3 @@
+export * from './command.decorator.mjs';
+export * from './cli-module.decorator.mjs';
+//# sourceMappingURL=index.d.mts.map

package/dist/src/decorators/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/decorators/index.mts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAA;AACvC,cAAc,4BAA4B,CAAA"}

package/dist/src/index.d.mts

@@ -0,0 +1,8 @@
+export * from '@navios/di';
+export * from './commander.application.mjs';
+export * from './commander.factory.mjs';
+export * from './decorators/index.mjs';
+export * from './interfaces/index.mjs';
+export * from './metadata/index.mjs';
+export * from './services/index.mjs';
+//# sourceMappingURL=index.d.mts.map

package/dist/src/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/index.mts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,6BAA6B,CAAA;AAC3C,cAAc,yBAAyB,CAAA;AACvC,cAAc,wBAAwB,CAAA;AACtC,cAAc,wBAAwB,CAAA;AACtC,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA"}

package/dist/src/interfaces/cli-module.interface.d.mts

@@ -0,0 +1,5 @@
+export interface CliModule {
+    onModuleInit?(): void | Promise<void>;
+    onModuleDestroy?(): void | Promise<void>;
+}
+//# sourceMappingURL=cli-module.interface.d.mts.map

package/dist/src/interfaces/cli-module.interface.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-module.interface.d.mts","sourceRoot":"","sources":["../../../src/interfaces/cli-module.interface.mts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,YAAY,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,eAAe,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACzC"}

package/dist/src/interfaces/command-handler.interface.d.mts

@@ -0,0 +1,4 @@
+export interface CommandHandler<TOptions = any> {
+    execute(options: TOptions): void | Promise<void>;
+}
+//# sourceMappingURL=command-handler.interface.d.mts.map

package/dist/src/interfaces/command-handler.interface.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-handler.interface.d.mts","sourceRoot":"","sources":["../../../src/interfaces/command-handler.interface.mts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc,CAAC,QAAQ,GAAG,GAAG;IAC5C,OAAO,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACjD"}

package/dist/src/interfaces/index.d.mts

@@ -0,0 +1,3 @@
+export * from './module.interface.mjs';
+export * from './command-handler.interface.mjs';
+//# sourceMappingURL=index.d.mts.map

package/dist/src/interfaces/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/interfaces/index.mts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA;AACtC,cAAc,iCAAiC,CAAA"}

package/dist/src/interfaces/module.interface.d.mts

@@ -0,0 +1,5 @@
+export interface Module {
+    onModuleInit?(): void | Promise<void>;
+    onModuleDestroy?(): void | Promise<void>;
+}
+//# sourceMappingURL=module.interface.d.mts.map

package/dist/src/interfaces/module.interface.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.interface.d.mts","sourceRoot":"","sources":["../../../src/interfaces/module.interface.mts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM;IACrB,YAAY,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,eAAe,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACzC"}

package/dist/src/metadata/cli-module.metadata.d.mts

@@ -0,0 +1,11 @@
+import type { ClassType } from '@navios/di';
+export declare const CliModuleMetadataKey: unique symbol;
+export interface CliModuleMetadata {
+    commands: Set<ClassType>;
+    imports: Set<ClassType>;
+    customAttributes: Map<string | symbol, any>;
+}
+export declare function getCliModuleMetadata(target: ClassType, context: ClassDecoratorContext): CliModuleMetadata;
+export declare function extractCliModuleMetadata(target: ClassType): CliModuleMetadata;
+export declare function hasCliModuleMetadata(target: ClassType): boolean;
+//# sourceMappingURL=cli-module.metadata.d.mts.map

package/dist/src/metadata/cli-module.metadata.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-module.metadata.d.mts","sourceRoot":"","sources":["../../../src/metadata/cli-module.metadata.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C,eAAO,MAAM,oBAAoB,eAAiC,CAAA;AAElE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,GAAG,CAAC,SAAS,CAAC,CAAA;IACxB,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,CAAA;IACvB,gBAAgB,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,CAAA;CAC5C;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,qBAAqB,GAC7B,iBAAiB,CAoBnB;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,GAChB,iBAAiB,CAWnB;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAG/D"}

package/dist/src/metadata/command.metadata.d.mts

@@ -0,0 +1,12 @@
+import type { ClassType } from '@navios/di';
+import type { ZodObject } from 'zod';
+export declare const CommandMetadataKey: unique symbol;
+export interface CommandMetadata {
+    path: string;
+    optionsSchema?: ZodObject;
+    customAttributes: Map<string | symbol, any>;
+}
+export declare function getCommandMetadata(target: ClassType, context: ClassDecoratorContext, path: string, optionsSchema?: ZodObject): CommandMetadata;
+export declare function extractCommandMetadata(target: ClassType): CommandMetadata;
+export declare function hasCommandMetadata(target: ClassType): boolean;
+//# sourceMappingURL=command.metadata.d.mts.map

package/dist/src/metadata/command.metadata.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.metadata.d.mts","sourceRoot":"","sources":["../../../src/metadata/command.metadata.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAEpC,eAAO,MAAM,kBAAkB,eAA+B,CAAA;AAE9D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,CAAC,EAAE,SAAS,CAAA;IACzB,gBAAgB,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,CAAA;CAC5C;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,qBAAqB,EAC9B,IAAI,EAAE,MAAM,EACZ,aAAa,CAAC,EAAE,SAAS,GACxB,eAAe,CAoBjB;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,eAAe,CASzE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAI7D"}

package/dist/src/metadata/index.d.mts

@@ -0,0 +1,3 @@
+export * from './command.metadata.mjs';
+export * from './cli-module.metadata.mjs';
+//# sourceMappingURL=index.d.mts.map

package/dist/src/metadata/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/metadata/index.mts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA;AACtC,cAAc,2BAA2B,CAAA"}

package/dist/src/services/cli-parser.service.d.mts

@@ -0,0 +1,44 @@
+import type { ZodObject } from 'zod';
+export interface ParsedCliArgs {
+    command: string;
+    options: Record<string, any>;
+    positionals: string[];
+}
+export declare class CliParserService {
+    /**
+     * Parses command-line arguments from process.argv
+     * Commands can be multi-word (e.g., 'db migrate', 'cache clear')
+     * Expected format: node script.js command [subcommand...] --flag value --boolean-flag positional1 positional2
+     *
+     * @param argv - Array of command-line arguments (typically process.argv)
+     * @param optionsSchema - Optional Zod schema to determine boolean flags and option types
+     * @returns Parsed command (space-separated if multi-word), options, and positional arguments
+     */
+    parse(argv: string[], optionsSchema?: ZodObject): ParsedCliArgs;
+    /**
+     * Converts kebab-case to camelCase
+     */
+    private camelCase;
+    /**
+     * Attempts to parse string values into appropriate types
+     */
+    private parseValue;
+    /**
+     * Extracts boolean field names from a Zod schema
+     * Handles ZodObject, ZodOptional, and ZodDefault wrappers
+     */
+    private extractBooleanFields;
+    /**
+     * Checks if a Zod schema represents a boolean type
+     * Unwraps ZodOptional and ZodDefault
+     */
+    private isSchemaBoolean;
+    /**
+     * Formats help text for available commands
+     */
+    formatCommandList(commands: Array<{
+        path: string;
+        class: any;
+    }>): string;
+}
+//# sourceMappingURL=cli-parser.service.d.mts.map

package/dist/src/services/cli-parser.service.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-parser.service.d.mts","sourceRoot":"","sources":["../../../src/services/cli-parser.service.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAW,MAAM,KAAK,CAAA;AAI7C,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC5B,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB;AAED,qBACa,gBAAgB;IAC3B;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,aAAa,CAAC,EAAE,SAAS,GAAG,aAAa;IAwG/D;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,UAAU;IAkClB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IA0B5B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,GAAG,CAAA;KAAE,CAAC,GAAG,MAAM;CAOzE"}

package/dist/src/services/index.d.mts

@@ -0,0 +1,3 @@
+export * from './module-loader.service.mjs';
+export * from './cli-parser.service.mjs';
+//# sourceMappingURL=index.d.mts.map

package/dist/src/services/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/services/index.mts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAA;AAC3C,cAAc,0BAA0B,CAAA"}

package/dist/src/services/module-loader.service.d.mts

@@ -0,0 +1,33 @@
+import type { ClassTypeWithInstance } from '@navios/di';
+import { Container } from '@navios/di';
+import type { CommandHandler, Module } from '../interfaces/index.mjs';
+import type { CliModuleMetadata, CommandMetadata } from '../metadata/index.mjs';
+export interface CommandWithMetadata {
+    class: ClassTypeWithInstance<CommandHandler>;
+    metadata: CommandMetadata;
+}
+export declare class ModuleLoaderService {
+    protected container: Container;
+    private modulesMetadata;
+    private loadedModules;
+    private commandsMetadata;
+    private initialized;
+    loadModules(appModule: ClassTypeWithInstance<Module>): Promise<void>;
+    private traverseModules;
+    private mergeMetadata;
+    getAllModules(): Map<string, CliModuleMetadata>;
+    getAllCommands(): Map<string, ClassTypeWithInstance<any>>;
+    /**
+     * Get all commands with their metadata, indexed by command path.
+     * This is populated during loadModules, so path information is available
+     * before parsing CLI argv.
+     */
+    getAllCommandsWithMetadata(): Map<string, CommandWithMetadata>;
+    /**
+     * Get a command by its path, with metadata already extracted.
+     * Returns undefined if command is not found.
+     */
+    getCommandByPath(path: string): CommandWithMetadata | undefined;
+    dispose(): void;
+}
+//# sourceMappingURL=module-loader.service.d.mts.map

package/dist/src/services/module-loader.service.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-loader.service.d.mts","sourceRoot":"","sources":["../../../src/services/module-loader.service.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAEvD,OAAO,EAAE,SAAS,EAAsB,MAAM,YAAY,CAAA;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAO/E,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,qBAAqB,CAAC,cAAc,CAAC,CAAA;IAC5C,QAAQ,EAAE,eAAe,CAAA;CAC1B;AAED,qBACa,mBAAmB;IAC9B,SAAS,CAAC,SAAS,YAAoB;IACvC,OAAO,CAAC,eAAe,CAA4C;IACnE,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,gBAAgB,CAA8C;IACtE,OAAO,CAAC,WAAW,CAAQ;IAErB,WAAW,CAAC,SAAS,EAAE,qBAAqB,CAAC,MAAM,CAAC;YAQ5C,eAAe;IAmC7B,OAAO,CAAC,aAAa;IAcrB,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAI/C,cAAc,IAAI,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAUzD;;;;OAIG;IACH,0BAA0B,IAAI,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAI9D;;;OAGG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAI/D,OAAO;CAMR"}