@navios/commander 1.6.0 → 1.7.0

package/.turbo/turbo-build.log

@@ -5,44 +5,44 @@
 ℹ tsconfig: tsconfig.json
 ℹ Build start
 ℹ Cleaning 37 files
-ℹ [CJS] lib/index.d.cts.map                          29.83 kB │ gzip: 8.44 kB
+ℹ [CJS] lib/index.d.cts.map                          31.72 kB │ gzip: 8.97 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/index.d.cts                              22.67 kB │ gzip: 5.93 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] 6 files, total: 73.94 kB
+ℹ [CJS] lib/index.cjs                              53.22 kB │ gzip:  8.90 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/index.cjs.map                          52.71 kB │ gzip: 13.63 kB
+ℹ [CJS] lib/help-command.token-mlwEyWij.cjs        15.17 kB │ gzip:  4.09 kB
+ℹ [CJS] lib/help-command.token-mlwEyWij.cjs.map    11.99 kB │ gzip:  3.80 kB
+ℹ [CJS] lib/help.command-knivRhJz.cjs              10.48 kB │ gzip:  2.87 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/help.command-knivRhJz.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
+ℹ [CJS] 12 files, total: 173.07 kB
 ✔ Build complete in 481ms
-ℹ [ESM] lib/index.mjs                                47.63 kB │ gzip:  7.94 kB
+ℹ [ESM] lib/index.mjs                                51.79 kB │ gzip:  8.71 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/index.mjs.map                            52.75 kB │ gzip: 13.62 kB
+ℹ [ESM] lib/index.d.mts.map                          22.97 kB │ gzip:  7.04 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/help-command.token-ChAUjOyV.mjs          14.94 kB │ gzip:  4.06 kB
+ℹ [ESM] lib/help-command.token-ChAUjOyV.mjs.map      11.99 kB │ gzip:  3.79 kB
+ℹ [ESM] lib/help.command-CzQymUFY.mjs                10.34 kB │ gzip:  2.85 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/help.command-CzQymUFY.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/index.d.mts                              16.97 kB │ gzip:  4.91 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
+ℹ [ESM] 18 files, total: 244.54 kB
+✔ Build complete in 487ms

package/.turbo/turbo-lint.log

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

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

@@ -3,7 +3,7 @@ Breaking changes might not follow SemVer, please pin Vitest's version when using
 
  RUN  v4.0.17 /Volumes/Dev/Projects/navios/commander/packages/commander
 
- ✓ src/services/__tests__/cli-parser.service.spec.mts (40 tests) 6ms
+ ✓ src/services/__tests__/cli-parser.service.spec.mts (57 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
@@ -99,11 +99,11 @@ Breaking changes might not follow SemVer, please pin Vitest's version when using
    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
+ ✓ src/__tests__/commander.factory.e2e.spec.mts (40 tests) 20ms
 
  Test Files  2 passed (2)
-      Tests  80 passed (80)
+      Tests  97 passed (97)
 Type Errors  no errors
-   Start at  09:14:33
-   Duration  197ms (transform 102ms, setup 0ms, import 189ms, tests 28ms, environment 0ms)
+   Start at  01:50:44
+   Duration  199ms (transform 105ms, setup 0ms, import 187ms, tests 27ms, environment 0ms)
 

package/CHANGELOG.md

@@ -5,6 +5,15 @@ 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.7.0] - 2026-01-29
+
+### Added
+
+- **Object Notation Support for CLI Parameters** - CLI parameters can now use object notation syntax
+  - Supports nested object syntax like `--config.host=localhost --config.port=3000`
+  - Automatically parses dot-separated keys into nested objects
+  - Works seamlessly with existing zod schema validation
+
 ## [1.6.0] - 2026-01-27
 
 ### Added

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

@@ -13,6 +13,7 @@ export interface ParsedCliArgs {
   /**
    * Parsed options as key-value pairs.
    * Keys are converted from kebab-case to camelCase.
+   * Supports object notation (e.g., --obj.field=value creates { obj: { field: value } }).
    */
   options: Record<string, any>
   /**
@@ -29,6 +30,8 @@ export interface ParsedCliArgs {
  * - Boolean flags
  * - Array options
  * - Positional arguments
+ * - Object notation: `--obj.field=value` or `--obj.nested.field value`
+ *   Creates nested objects automatically (e.g., { obj: { field: value } })
  *
  * @public
  */
@@ -71,5 +74,44 @@ export declare class CliParserService {
    * Unwraps zod/v4Optional and zod/v4Default using zod/v4 v4 API
    */
   private isSchemaArray
+  /**
+   * Sets a nested property on an object using dot notation path.
+   * Creates intermediate objects as needed.
+   *
+   * @example
+   * setNestedProperty({}, 'a.b.c', 'value') // { a: { b: { c: 'value' } } }
+   */
+  private setNestedProperty
+  /**
+   * Gets a nested property from an object using dot notation path.
+   * Returns undefined if path doesn't exist.
+   */
+  private getNestedProperty
+  /**
+   * Checks if an option key contains dot notation (object notation).
+   * Returns true for keys like "obj.field" or "deep.nested.value".
+   */
+  private isObjectNotation
+  /**
+   * Processes an option key that may contain object notation.
+   * Converts each segment from kebab-case to camelCase.
+   *
+   * @example
+   * processObjectNotationKey('my-obj.field-name') // 'myObj.fieldName'
+   */
+  private processObjectNotationKey
+  /**
+   * Gets the nested schema for a given dot-notation path.
+   * Returns undefined if the path doesn't lead to a valid schema.
+   */
+  private getNestedSchema
+  /**
+   * Checks if a nested path represents a boolean field in the schema.
+   */
+  private isNestedBoolean
+  /**
+   * Checks if a nested path represents an array field in the schema.
+   */
+  private isNestedArray
 }
 //# sourceMappingURL=cli-parser.service.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"cli-parser.service.d.mts","sourceRoot":"","sources":["../../../src/services/cli-parser.service.mts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE/B;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC5B;;OAEG;IACH,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB;AAED;;;;;;;;;;;GAWG;AACH,qBACa,gBAAgB;IAC3B;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC,SAAS,GAAG,aAAa,CAiIhE;IAED;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,UAAU;IAkClB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IA0B5B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAwB1B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAiBvB;;;OAGG;IACH,OAAO,CAAC,aAAa;CAgBtB"}
+{"version":3,"file":"cli-parser.service.d.mts","sourceRoot":"","sources":["../../../src/services/cli-parser.service.mts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE/B;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC5B;;OAEG;IACH,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB;AAED;;;;;;;;;;;;;GAaG;AACH,qBACa,gBAAgB;IAC3B;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC,SAAS,GAAG,aAAa,CAoLhE;IAED;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,UAAU;IAkClB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IA0B5B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAwB1B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAiBvB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAiBrB;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAezB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAczB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;;;;;OAMG;IACH,OAAO,CAAC,wBAAwB;IAOhC;;;OAGG;IACH,OAAO,CAAC,eAAe;IA6BvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,OAAO,CAAC,aAAa;CAItB"}

package/dist/src/services/command-registry.service.d.mts

@@ -72,6 +72,11 @@ export declare class CommandRegistryService {
    * @returns Formatted string with command help
    */
   formatCommandHelp(commandPath: string): string
+  /**
+   * Recursively formats nested object options for help display.
+   * Shows nested fields with dot notation (e.g., --config.port)
+   */
+  private formatNestedObjectOptions
   /**
    * Gets a human-readable type name from a zod/v4 schema.
    */

package/dist/src/services/command-registry.service.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"command-registry.service.d.mts","sourceRoot":"","sources":["../../../src/services/command-registry.service.mts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAE7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAE5D;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,KAAK,EAAE,SAAS,CAAA;IAChB;;OAEG;IACH,QAAQ,EAAE,eAAe,CAAA;IACzB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;;;GAKG;AACH,qBACa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAuC;IAEvD;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAKvD;IAED;;;;;OAKG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAErD;IAED;;;;OAIG;IACH,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAEvC;IAED;;;;;OAKG;IACH,aAAa,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,CAAA;KAAE,CAAC,CAMzD;IAED;;;;OAIG;IACH,iBAAiB,IAAI,MAAM,CAW1B;IAED;;;;;OAKG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAoC7C;IAED;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuCzB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IACH,KAAK,IAAI,IAAI,CAEZ;CACF"}
+{"version":3,"file":"command-registry.service.d.mts","sourceRoot":"","sources":["../../../src/services/command-registry.service.mts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAE7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAE5D;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,KAAK,EAAE,SAAS,CAAA;IAChB;;OAEG;IACH,QAAQ,EAAE,eAAe,CAAA;IACzB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;;;GAKG;AACH,qBACa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAuC;IAEvD;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAKvD;IAED;;;;;OAKG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAErD;IAED;;;;OAIG;IACH,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAEvC;IAED;;;;;OAKG;IACH,aAAa,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,CAAA;KAAE,CAAC,CAMzD;IAED;;;;OAIG;IACH,iBAAiB,IAAI,MAAM,CAW1B;IAED;;;;;OAKG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAuC7C;IAED;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IA4CjC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuCzB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IACH,KAAK,IAAI,IAAI,CAEZ;CACF"}