@navios/commander 1.5.0 → 1.6.0

package/.turbo/turbo-build.log

@@ -0,0 +1,48 @@
+ℹ 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.83 kB │ gzip: 8.44 kB
+ℹ [CJS] lib/cli-module.decorator-BV3vVKlR.d.cts.map   8.66 kB │ gzip: 2.82 kB
+ℹ [CJS] lib/legacy-compat/index.d.cts.map             2.42 kB │ gzip: 0.82 kB
+ℹ [CJS] lib/index.d.cts                              21.03 kB │ gzip: 5.49 kB
+ℹ [CJS] lib/legacy-compat/index.d.cts                 1.94 kB │ gzip: 0.71 kB
+ℹ [CJS] lib/cli-module.decorator-BV3vVKlR.d.cts       6.54 kB │ gzip: 2.05 kB
+ℹ [CJS] 6 files, total: 70.41 kB
+ℹ [CJS] lib/index.cjs                              49.06 kB │ gzip:  8.10 kB
+ℹ [CJS] lib/legacy-compat/index.cjs                 2.53 kB │ gzip:  0.90 kB
+ℹ [CJS] lib/index.cjs.map                          44.00 kB │ gzip: 11.79 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: 156.73 kB
+✔ Build complete in 481ms
+ℹ [ESM] lib/index.mjs                                47.63 kB │ gzip:  7.94 kB
+ℹ [ESM] lib/legacy-compat/index.mjs                   2.13 kB │ gzip:  0.75 kB
+ℹ [ESM] lib/index.mjs.map                            44.04 kB │ gzip: 11.77 kB
+ℹ [ESM] lib/index.d.mts.map                          21.17 kB │ gzip:  6.52 kB
+ℹ [ESM] lib/cli-module.decorator-DDlgpTgI.d.mts.map  17.48 kB │ gzip:  5.18 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.33 kB │ gzip:  4.45 kB
+ℹ [ESM] lib/legacy-compat/index.d.mts                 1.94 kB │ gzip:  0.70 kB
+ℹ [ESM] lib/cli-module.decorator-DDlgpTgI.d.mts      12.71 kB │ gzip:  3.52 kB
+ℹ [ESM] 18 files, total: 224.77 kB
+✔ Build complete in 491ms

package/.turbo/turbo-lint.log

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

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

@@ -0,0 +1,109 @@
+Testing 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
+
+ ✓ src/services/__tests__/cli-parser.service.spec.mts (40 tests) 6ms
+   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 ContextTestModule_vtcz5t loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module ContextTestModule_vtcz5t 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 (40 tests) 22ms
+
+ Test Files  2 passed (2)
+      Tests  80 passed (80)
+Type Errors  no errors
+   Start at  09:14:33
+   Duration  197ms (transform 102ms, setup 0ms, import 189ms, tests 28ms, environment 0ms)
+

package/.turbo/turbo-test.log

@@ -0,0 +1,107 @@
+Testing 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
+
+ ✓ src/services/__tests__/cli-parser.service.spec.mts (40 tests) 7ms
+   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 ContextTestModule_vtcz5t loaded
+   DEBUG [NaviosApplication]  Navios application initialized
+   DEBUG [ModuleLoaderService]  Module ContextTestModule_vtcz5t 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 (39 tests) 28ms
+
+ Test Files  2 passed (2)
+      Tests  79 passed (79)
+Type Errors  no errors
+   Start at  09:11:07
+   Duration  431ms (transform 229ms, setup 0ms, import 375ms, tests 35ms, environment 0ms)
+

package/CHANGELOG.md

@@ -5,6 +5,18 @@ 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.6.0] - 2026-01-27
+
+### Added
+
+- **Positional Arguments Support** - Commands can now receive positional arguments as a second parameter
+  - `CommandHandler.execute()` now accepts optional `positionals?: string[]` parameter
+  - Example: `copy --force source.txt dest.txt` passes `['source.txt', 'dest.txt']` as positionals
+  - Fully backward compatible - existing commands without positionals parameter continue to work
+- **Positionals via Execution Context** - Access positionals through dependency injection
+  - New `getPositionals(): string[]` method on `CommanderExecutionContext`
+  - Inject via `CommandExecutionContext` token for flexible access in services
+
 ## [1.5.0] - 2026-01-16
 
 ### Changed
@@ -77,7 +89,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
@@ -94,8 +106,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)`