@navios/commander 1.4.0 → 1.5.1

package/.turbo/turbo-build.log

@@ -0,0 +1,49 @@
+
+ℹ tsdown v0.19.0 powered by rolldown v1.0.0-beta.59
+ℹ config file: /Volumes/Dev/Projects/navios/commander/packages/commander/tsdown.config.mts 
+ℹ entry: src/index.mts, src/legacy-compat/index.mts
+ℹ target: es2022
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ Cleaning 37 files
+ℹ [CJS] lib/index.d.cts.map                          29.35 kB │ gzip: 8.31 kB
+ℹ [CJS] lib/cli-module.decorator-BzsOEMPH.d.cts.map   8.31 kB │ gzip: 2.71 kB
+ℹ [CJS] lib/legacy-compat/index.d.cts.map             2.42 kB │ gzip: 0.82 kB
+ℹ [CJS] lib/index.d.cts                              20.64 kB │ gzip: 5.38 kB
+ℹ [CJS] lib/legacy-compat/index.d.cts                 1.94 kB │ gzip: 0.70 kB
+ℹ [CJS] lib/cli-module.decorator-BzsOEMPH.d.cts       6.28 kB │ gzip: 1.96 kB
+ℹ [CJS] 6 files, total: 68.94 kB
+ℹ [CJS] lib/index.cjs                              48.62 kB │ gzip:  7.97 kB
+ℹ [CJS] lib/legacy-compat/index.cjs                 2.53 kB │ gzip:  0.90 kB
+ℹ [CJS] lib/index.cjs.map                          43.31 kB │ gzip: 11.63 kB
+ℹ [CJS] lib/help-command.token-DamE31Aw.cjs        14.04 kB │ gzip:  3.87 kB
+ℹ [CJS] lib/help.command-DvKmMpB7.cjs              10.48 kB │ gzip:  2.87 kB
+ℹ [CJS] lib/help-command.token-DamE31Aw.cjs.map     9.64 kB │ gzip:  3.30 kB
+ℹ [CJS] lib/command.decorator-HziankUv.cjs.map      9.07 kB │ gzip:  2.85 kB
+ℹ [CJS] lib/command.decorator-HziankUv.cjs          5.12 kB │ gzip:  1.57 kB
+ℹ [CJS] lib/cli-module.decorator-CXt38aqF.cjs.map   4.77 kB │ gzip:  1.78 kB
+ℹ [CJS] lib/legacy-compat/index.cjs.map             3.39 kB │ gzip:  1.04 kB
+ℹ [CJS] lib/help.command-DvKmMpB7.cjs.map           2.50 kB │ gzip:  0.98 kB
+ℹ [CJS] lib/cli-module.decorator-CXt38aqF.cjs       2.12 kB │ gzip:  0.96 kB
+ℹ [CJS] 12 files, total: 155.59 kB
+✔ Build complete in 524ms
+ℹ [ESM] lib/index.mjs                                47.19 kB │ gzip:  7.82 kB
+ℹ [ESM] lib/legacy-compat/index.mjs                   2.13 kB │ gzip:  0.75 kB
+ℹ [ESM] lib/index.mjs.map                            43.35 kB │ gzip: 11.61 kB
+ℹ [ESM] lib/index.d.mts.map                          21.06 kB │ gzip:  6.49 kB
+ℹ [ESM] lib/cli-module.decorator-CCV_elPP.d.mts.map  16.74 kB │ gzip:  4.96 kB
+ℹ [ESM] lib/help-command.token-XHx3WkoD.mjs          13.81 kB │ gzip:  3.83 kB
+ℹ [ESM] lib/help.command-Bynoll_7.mjs                10.34 kB │ gzip:  2.85 kB
+ℹ [ESM] lib/help-command.token-XHx3WkoD.mjs.map       9.64 kB │ gzip:  3.29 kB
+ℹ [ESM] lib/command.decorator-QiRU7ny3.mjs.map        9.08 kB │ gzip:  2.85 kB
+ℹ [ESM] lib/cli-module.decorator-DAjf_r_W.mjs.map     4.79 kB │ gzip:  1.78 kB
+ℹ [ESM] lib/command.decorator-QiRU7ny3.mjs            4.36 kB │ gzip:  1.49 kB
+ℹ [ESM] lib/legacy-compat/index.mjs.map               3.40 kB │ gzip:  1.05 kB
+ℹ [ESM] lib/help.command-Bynoll_7.mjs.map             2.51 kB │ gzip:  0.97 kB
+ℹ [ESM] lib/legacy-compat/index.d.mts.map             2.42 kB │ gzip:  0.82 kB
+ℹ [ESM] lib/cli-module.decorator-DAjf_r_W.mjs         1.98 kB │ gzip:  0.89 kB
+ℹ [ESM] lib/index.d.mts                              15.31 kB │ gzip:  4.45 kB
+ℹ [ESM] lib/legacy-compat/index.d.mts                 1.94 kB │ gzip:  0.70 kB
+ℹ [ESM] lib/cli-module.decorator-CCV_elPP.d.mts      12.09 kB │ gzip:  3.35 kB
+ℹ [ESM] 18 files, total: 222.13 kB
+✔ Build complete in 533ms

package/.turbo/turbo-check.log

@@ -0,0 +1,2 @@
+
+

package/.turbo/turbo-lint.log

@@ -0,0 +1,3 @@
+
+Found 0 warnings and 0 errors.
+Finished in 26ms on 34 files with 90 rules using 16 threads.

package/.turbo/turbo-test$colon$ci.log

@@ -0,0 +1,117 @@
+
+[?25lTesting types with tsc and vue-tsc is an experimental feature.
+Breaking changes might not follow SemVer, please pin Vitest's version when using it.
+
+ RUN  v4.0.17 /Volumes/Dev/Projects/navios/commander/packages/commander
+
+[?2026h
+ ❯ src/services/__tests__/cli-parser.service.spec.mts [queued]
+
+ Test Files 0 passed (2)
+      Tests 0 passed (0)
+   Start at 03:26:05
+   Duration 0ms
+[?2026l[?2026h ✓ src/services/__tests__/cli-parser.service.spec.mts (40 tests) 6ms
+
+ ❯ src/__tests__/commander.factory.e2e.spec.mts 0/36
+
+ Test Files 1 passed (2)
+      Tests 40 passed (76)
+   Start at 03:26:05
+   Duration 100ms
+[?2026l   DEBUG [ModuleLoaderService]  Module TestModule_dy4bqj loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+stdout | src/__tests__/commander.factory.e2e.spec.mts > CommanderApplication E2E - run() with different argv > simple command without options > should execute command with minimal argv
+Hello, World!
+
+   DEBUG [ModuleLoaderService]  Module TestModule_dy4bqj loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+stdout | src/__tests__/commander.factory.e2e.spec.mts > CommanderApplication E2E - run() with different argv > simple command without options > should execute command with absolute path in argv
+Hello, World!
+
+   DEBUG [ModuleLoaderService]  Module TestModule_dy4bqj loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module TestModule_dy4bqj loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module DeployModule_clcbp1 loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module BuildModule_fdlhzv loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module TestModule_dy4bqj loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module TestModule_dy4bqj loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module TestModule_dy4bqj loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module TestModule_dy4bqj loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module TestModule_dy4bqj loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module TestModule_dy4bqj loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module TestModule_dy4bqj loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module TestModule_dy4bqj loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module TestModule_dy4bqj loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module TestModule_dy4bqj loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module TestModule_dy4bqj loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module RollbackModule_bva5p1 loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module TestModule_dy4bqj loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   ERROR [Commander]  Error: [Navios Commander] Command not found: invalid
+     LOG [Commander]  
+     LOG [Commander]  Available commands:
+
+  help                 Show available commands or help for a specific command
+  valid
+   DEBUG [ModuleLoaderService]  Module TestModule_dy4bqj loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   ERROR [Commander]  Error: [Navios Commander] No command provided
+   DEBUG [ModuleLoaderService]  Module TestModule_dy4bqj loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module TestModule_dy4bqj loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module TestModule_dy4bqj loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module TestModule_dy4bqj loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module TestModule_dy4bqj loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module TestModule_dy4bqj loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module TestModule_dy4bqj loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module JsonModule_5wfcr9 loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module TestModule_dy4bqj loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module TestModule_dy4bqj loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module TestModule_dy4bqj loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module TestModule_dy4bqj loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module UserModule_sf0k39 loaded
+   DEBUG [ModuleLoaderService]  Module AdminModule_v7hlb7 loaded
+   DEBUG [ModuleLoaderService]  Module AppModule_fuvatb loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module AppModule_fuvatb loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module AppModule_fuvatb loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module AppModule_fuvatb loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+ ✓ src/__tests__/commander.factory.e2e.spec.mts (36 tests) 21ms
+
+ Test Files  2 passed (2)
+      Tests  76 passed (76)
+Type Errors  no errors
+   Start at  03:26:05
+   Duration  199ms (transform 98ms, setup 0ms, import 190ms, tests 28ms, environment 0ms)
+
+[?25h

package/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.5.0] - 2026-01-16
+
+### Changed
+
+- **Commander Factory** - Minor improvements to adapter loading
+
 ## [1.4.0] - 2026-01-15
 
 ### Added
@@ -71,7 +77,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - **Stable Release**: First stable release of @navios/commander
   - Production-ready CLI command framework for Navios
-  - Type-safe command definitions with Zod validation
+  - Type-safe command definitions with zod/v4 validation
   - Seamless integration with Navios dependency injection
 
 ## [1.0.0-alpha.4] - 2026-01-09
@@ -88,8 +94,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Descriptions displayed in `--help` output
 - **Built-in Help Command**: Automatic `help` command with `--help` flag support
   - Shows all available commands with descriptions
-  - Per-command help with option details from Zod schema metadata
-  - Supports `.meta({ description: '...' })` on Zod fields for option descriptions
+  - Per-command help with option details from zod/v4 schema metadata
+  - Supports `.meta({ description: '...' })` on zod/v4 fields for option descriptions
 - **Command Registry Service**: New `CommandRegistryService` for managing registered commands
   - Replaces module-level command tracking
   - Provides `register()`, `getByPath()`, `getAllAsArray()`, and `clear()` methods

package/README.md

@@ -5,16 +5,16 @@ A CLI command framework built on `@navios/core` that provides a decorator-based
 ## Installation
 
 ```bash
-npm install @navios/commander zod
+npm install @navios/commander zod/v4
 ```
 
 ## Features
 
 - **Decorator-based**: Use `@Command` and `@CliModule` decorators to define commands and modules
 - **Dependency Injection**: Full DI support via `@navios/core` with request-scoped command execution
-- **Schema Validation**: Built-in support for Zod schemas to validate command options
+- **Schema Validation**: Built-in support for zod/v4 schemas to validate command options
 - **Modular Architecture**: Organize commands into modules with imports support
-- **Built-in Help**: Automatic `help` command and `--help` flag support with Zod meta descriptions
+- **Built-in Help**: Automatic `help` command and `--help` flag support with zod/v4 meta descriptions
 
 ## Usage
 
@@ -25,7 +25,7 @@ Commands are defined using the `@Command` decorator. Each command must implement
 ```typescript
 import { Command, CommandHandler } from '@navios/commander'
 
-import { z } from 'zod'
+import { z } from 'zod/v4'
 
 const greetOptionsSchema = z.object({
   name: z.string().meta({ description: 'Name of the person to greet' }),
@@ -95,15 +95,9 @@ node dist/cli.js greet --name World --greeting Hi
 ### Advanced Example with Dependency Injection
 
 ```typescript
-import {
-  CliModule,
-  Command,
-  CommandHandler,
-  inject,
-  Injectable,
-} from '@navios/commander'
+import { CliModule, Command, CommandHandler, inject, Injectable } from '@navios/commander'
 
-import { z } from 'zod'
+import { z } from 'zod/v4'
 
 // Service
 @Injectable()
@@ -122,9 +116,7 @@ const userOptionsSchema = z.object({
   path: 'user:show',
   optionsSchema: userOptionsSchema,
 })
-export class ShowUserCommand implements CommandHandler<
-  z.infer<typeof userOptionsSchema>
-> {
+export class ShowUserCommand implements CommandHandler<z.infer<typeof userOptionsSchema>> {
   private userService = inject(UserService)
 
   async execute(options: { userId: string }) {
@@ -247,7 +239,7 @@ Defines a CLI command.
 
 - `path: string` - The command path (e.g., 'user:create', 'db:migrate')
 - `description?: string` - Optional description for help text
-- `optionsSchema?: ZodSchema` - Optional Zod schema for validating command options
+- `optionsSchema?: zod/v4Schema` - Optional zod/v4 schema for validating command options
 
 #### `@CliModule(options)`
 

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

@@ -1,5 +1,6 @@
-import type { ClassTypeWithInstance, LogLevel, NaviosApplication, NaviosModule } from '@navios/core';
-import type { CliEnvironment } from './interfaces/environment.interface.mjs';
+import type { ClassTypeWithInstance, LogLevel, NaviosApplication, NaviosModule } from '@navios/core'
+
+import type { CliEnvironment } from './interfaces/environment.interface.mjs'
 /**
  * Logger display options for CLI applications.
  * All options default to false for cleaner CLI output.
@@ -7,41 +8,41 @@ import type { CliEnvironment } from './interfaces/environment.interface.mjs';
  * @public
  */
 export interface CommanderLoggerOptions {
-    /**
-     * Enabled log levels.
-     * @default ['log', 'error', 'warn', 'debug', 'verbose', 'fatal']
-     */
-    logLevels?: LogLevel[];
-    /**
-     * If true, will print the process ID in the log message.
-     * @default false
-     */
-    showPid?: boolean;
-    /**
-     * If true, will print the log level in the log message.
-     * @default true
-     */
-    showLogLevel?: boolean;
-    /**
-     * If true, will print the prefix/app name in the log message.
-     * @default false
-     */
-    showPrefix?: boolean;
-    /**
-     * If true, will print the context in the log message.
-     * @default true
-     */
-    showContext?: boolean;
-    /**
-     * If true, will print the absolute timestamp in the log message.
-     * @default false
-     */
-    showTimestamp?: boolean;
-    /**
-     * If enabled, will print timestamp difference between current and previous log message.
-     * @default false
-     */
-    showTimeDiff?: boolean;
+  /**
+   * Enabled log levels.
+   * @default ['log', 'error', 'warn', 'debug', 'verbose', 'fatal']
+   */
+  logLevels?: LogLevel[]
+  /**
+   * If true, will print the process ID in the log message.
+   * @default false
+   */
+  showPid?: boolean
+  /**
+   * If true, will print the log level in the log message.
+   * @default true
+   */
+  showLogLevel?: boolean
+  /**
+   * If true, will print the prefix/app name in the log message.
+   * @default false
+   */
+  showPrefix?: boolean
+  /**
+   * If true, will print the context in the log message.
+   * @default true
+   */
+  showContext?: boolean
+  /**
+   * If true, will print the absolute timestamp in the log message.
+   * @default false
+   */
+  showTimestamp?: boolean
+  /**
+   * If enabled, will print timestamp difference between current and previous log message.
+   * @default false
+   */
+  showTimeDiff?: boolean
 }
 /**
  * TUI-specific options for terminal UI mode.
@@ -50,54 +51,54 @@ export interface CommanderLoggerOptions {
  * @public
  */
 export interface CommanderTuiOptions {
-    /**
-     * Exit on Ctrl+C.
-     * @default true
-     */
-    exitOnCtrlC?: boolean;
-    /**
-     * Adapter to use for the TUI.
-     * @default 'none'
-     */
-    adapter?: 'react' | 'solid' | 'ink' | 'none';
-    /**
-     * Sidebar width in columns.
-     */
-    sidebarWidth?: number;
-    /**
-     * Sidebar position.
-     */
-    sidebarPosition?: 'left' | 'right';
-    /**
-     * Sidebar header title.
-     */
-    sidebarTitle?: string;
-    /**
-     * Auto close after all screens complete successfully.
-     * Set to true for default delay (5000ms), or specify delay in milliseconds.
-     */
-    autoClose?: boolean | number;
-    /**
-     * Theme preset name ('dark', 'light', 'high-contrast') or custom theme object.
-     */
-    theme?: string | Record<string, unknown>;
-    /**
-     * Enable mouse support.
-     * @default false
-     */
-    useMouse?: boolean;
-    /**
-     * Hide the default console logger screen from the sidebar.
-     * @default false
-     */
-    hideDefaultScreen?: boolean;
-    /**
-     * Use OpenTUI for terminal rendering.
-     * When true: Full TUI with sidebar, scrolling, interactive prompts.
-     * When false: Stdout mode - static screens print immediately, others on completion.
-     * @default true for Node.js, false for Bun (OpenTUI not supported)
-     */
-    useOpenTUI?: boolean;
+  /**
+   * Exit on Ctrl+C.
+   * @default true
+   */
+  exitOnCtrlC?: boolean
+  /**
+   * Adapter to use for the TUI.
+   * @default 'none'
+   */
+  adapter?: 'react' | 'solid' | 'ink' | 'none'
+  /**
+   * Sidebar width in columns.
+   */
+  sidebarWidth?: number
+  /**
+   * Sidebar position.
+   */
+  sidebarPosition?: 'left' | 'right'
+  /**
+   * Sidebar header title.
+   */
+  sidebarTitle?: string
+  /**
+   * Auto close after all screens complete successfully.
+   * Set to true for default delay (5000ms), or specify delay in milliseconds.
+   */
+  autoClose?: boolean | number
+  /**
+   * Theme preset name ('dark', 'light', 'high-contrast') or custom theme object.
+   */
+  theme?: string | Record<string, unknown>
+  /**
+   * Enable mouse support.
+   * @default false
+   */
+  useMouse?: boolean
+  /**
+   * Hide the default console logger screen from the sidebar.
+   * @default false
+   */
+  hideDefaultScreen?: boolean
+  /**
+   * Use OpenTUI for terminal rendering.
+   * When true: Full TUI with sidebar, scrolling, interactive prompts.
+   * When false: Stdout mode - static screens print immediately, others on completion.
+   * @default true for Node.js, false for Bun (OpenTUI not supported)
+   */
+  useOpenTUI?: boolean
 }
 /**
  * Configuration options for CommanderFactory.
@@ -105,25 +106,25 @@ export interface CommanderTuiOptions {
  * @public
  */
 export interface CommanderFactoryOptions {
-    /**
-     * Enabled log levels.
-     * @default ['log', 'error', 'warn', 'debug', 'verbose', 'fatal']
-     */
-    logLevels?: LogLevel[];
-    /**
-     * Logger display options. These override the default CLI-friendly logger settings.
-     * Ignored when enableTUI is true.
-     */
-    logger?: CommanderLoggerOptions;
-    /**
-     * Enable TUI mode with @navios/commander-tui.
-     * Requires @navios/commander-tui to be installed.
-     */
-    enableTUI?: boolean;
-    /**
-     * TUI-specific options. Only used when enableTUI is true.
-     */
-    tuiOptions?: CommanderTuiOptions;
+  /**
+   * Enabled log levels.
+   * @default ['log', 'error', 'warn', 'debug', 'verbose', 'fatal']
+   */
+  logLevels?: LogLevel[]
+  /**
+   * Logger display options. These override the default CLI-friendly logger settings.
+   * Ignored when enableTUI is true.
+   */
+  logger?: CommanderLoggerOptions
+  /**
+   * Enable TUI mode with @navios/commander-tui.
+   * Requires @navios/commander-tui to be installed.
+   */
+  enableTUI?: boolean
+  /**
+   * TUI-specific options. Only used when enableTUI is true.
+   */
+  tuiOptions?: CommanderTuiOptions
 }
 /**
  * Factory class for creating CLI applications.
@@ -160,22 +161,25 @@ export interface CommanderFactoryOptions {
  * ```
  */
 export declare class CommanderFactory {
-    /**
-     * Creates a new CLI application instance configured with the provided module.
-     *
-     * @param appModule - The root CLI module class decorated with `@CliModule`
-     * @param options - Optional configuration options for the CLI application
-     * @returns A promise that resolves to a configured NaviosApplication instance
-     *
-     * @example
-     * ```typescript
-     * const app = await CommanderFactory.create(AppModule)
-     * await app.init()
-     *
-     * const adapter = app.getAdapter()
-     * await adapter.run(process.argv)
-     * ```
-     */
-    static create<TModule extends NaviosModule = NaviosModule>(appModule: ClassTypeWithInstance<TModule>, options?: CommanderFactoryOptions): Promise<NaviosApplication<CliEnvironment>>;
+  /**
+   * Creates a new CLI application instance configured with the provided module.
+   *
+   * @param appModule - The root CLI module class decorated with `@CliModule`
+   * @param options - Optional configuration options for the CLI application
+   * @returns A promise that resolves to a configured NaviosApplication instance
+   *
+   * @example
+   * ```typescript
+   * const app = await CommanderFactory.create(AppModule)
+   * await app.init()
+   *
+   * const adapter = app.getAdapter()
+   * await adapter.run(process.argv)
+   * ```
+   */
+  static create<TModule extends NaviosModule = NaviosModule>(
+    appModule: ClassTypeWithInstance<TModule>,
+    options?: CommanderFactoryOptions,
+  ): Promise<NaviosApplication<CliEnvironment>>
 }
-//# sourceMappingURL=commander.factory.d.mts.map
+//# sourceMappingURL=commander.factory.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"commander.factory.d.mts","sourceRoot":"","sources":["../../src/commander.factory.mts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAKpG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAA;AAE5E;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAA;IACtB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAA;IAC5C;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IAClC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IAC5B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAA;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,sBAAsB,CAAA;IAC/B;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;OAEG;IACH,UAAU,CAAC,EAAE,mBAAmB,CAAA;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,gBAAgB;IAC3B;;;;;;;;;;;;;;;OAeG;WACU,MAAM,CAAC,OAAO,SAAS,YAAY,GAAG,YAAY,EAC7D,SAAS,EAAE,qBAAqB,CAAC,OAAO,CAAC,EACzC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;CA8E9C"}
+{"version":3,"file":"commander.factory.d.mts","sourceRoot":"","sources":["../../src/commander.factory.mts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAKpG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAA;AAE5E;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAA;IACtB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAA;IAC5C;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IAClC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IAC5B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAA;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,sBAAsB,CAAA;IAC/B;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;OAEG;IACH,UAAU,CAAC,EAAE,mBAAmB,CAAA;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,gBAAgB;IAC3B;;;;;;;;;;;;;;;OAeG;IACH,OAAa,MAAM,CAAC,OAAO,SAAS,YAAY,GAAG,YAAY,EAC7D,SAAS,EAAE,qBAAqB,CAAC,OAAO,CAAC,EACzC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC,CA+E5C;CACF"}

package/dist/src/commands/help.command.d.mts

@@ -1,18 +1,22 @@
-import { z } from 'zod';
-import type { CommandHandler } from '../interfaces/command-handler.interface.mjs';
-declare const helpOptionsSchema: z.ZodObject<{
-    command: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-type HelpOptions = z.infer<typeof helpOptionsSchema>;
+import { z } from 'zod/v4'
+
+import type { CommandHandler } from '../interfaces/command-handler.interface.mjs'
+declare const helpOptionsSchema: z.ZodObject<
+  {
+    command: z.ZodOptional<z.ZodString>
+  },
+  z.core.$strip
+>
+type HelpOptions = z.infer<typeof helpOptionsSchema>
 /**
  * Built-in help command that lists all available commands or shows help for a specific command.
  *
  * @public
  */
 export declare class HelpCommand implements CommandHandler<HelpOptions> {
-    private logger;
-    private commandRegistry;
-    execute(options: HelpOptions): Promise<void>;
+  private logger
+  private commandRegistry
+  execute(options: HelpOptions): Promise<void>
 }
-export {};
-//# sourceMappingURL=help.command.d.mts.map
+export {}
+//# sourceMappingURL=help.command.d.mts.map

package/dist/src/commands/help.command.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"help.command.d.mts","sourceRoot":"","sources":["../../../src/commands/help.command.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAA;AAEjF,QAAA,MAAM,iBAAiB;;iBAErB,CAAA;AAEF,KAAK,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAEpD;;;;GAIG;AACH,qBAMa,WAAY,YAAW,cAAc,CAAC,WAAW,CAAC;IAC7D,OAAO,CAAC,MAAM,CAA2C;IACzD,OAAO,CAAC,eAAe,CAAiC;IAElD,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAOnD"}
+{"version":3,"file":"help.command.d.mts","sourceRoot":"","sources":["../../../src/commands/help.command.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAM1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAA;AAEjF,QAAA,MAAM,iBAAiB;;iBAErB,CAAA;AAEF,KAAK,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAEpD;;;;GAIG;AACH,qBAMa,WAAY,YAAW,cAAc,CAAC,WAAW,CAAC;IAC7D,OAAO,CAAC,MAAM,CAA2C;IACzD,OAAO,CAAC,eAAe,CAAiC;IAElD,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAMjD;CACF"}

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

@@ -1,2 +1,2 @@
-export * from './help.command.mjs';
-//# sourceMappingURL=index.d.mts.map
+export * from './help.command.mjs'
+//# sourceMappingURL=index.d.mts.map