@navios/commander 0.5.0 → 0.5.2

package/README.md

@@ -129,6 +129,43 @@ export class UserModule {}
 export class AppModule {}
 ```
 
+### Accessing ExecutionContext
+
+The `ExecutionContext` provides access to the current command execution information, including the module metadata, command metadata, command path, and options. This is useful for middleware, guards, or any service that needs context about the current command execution.
+
+```typescript
+import { Command, CommandHandler, ExecutionContext } from '@navios/commander'
+import { Injectable, inject } from '@navios/di'
+
+@Injectable()
+class CommandLogger {
+  private executionContext = inject(ExecutionContext)
+
+  logCommandInfo() {
+    const ctx = this.executionContext
+    console.log('Command Path:', ctx.getCommandPath())
+    console.log('Command Options:', ctx.getOptions())
+    console.log('Module:', ctx.getModule())
+  }
+}
+
+@Command({ path: 'example' })
+export class ExampleCommand implements CommandHandler {
+  private logger = inject(CommandLogger)
+
+  async execute(options: any) {
+    this.logger.logCommandInfo()
+    // Your command logic here
+  }
+}
+```
+
+The `ExecutionContext` provides the following methods:
+- `getModule()` - Returns the CLI module metadata
+- `getCommand()` - Returns the command metadata
+- `getCommandPath()` - Returns the command path (e.g., 'user:create')
+- `getOptions()` - Returns the validated command options
+
 ### Listing All Commands
 
 ```typescript

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

@@ -1 +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"}
+{"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;AAMpE,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;IA0D3D,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/index.d.mts

@@ -5,4 +5,5 @@ export * from './decorators/index.mjs';
 export * from './interfaces/index.mjs';
 export * from './metadata/index.mjs';
 export * from './services/index.mjs';
+export * from './tokens/index.mjs';
 //# sourceMappingURL=index.d.mts.map

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

@@ -1 +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"}
+{"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;AACpC,cAAc,oBAAoB,CAAA"}

package/dist/src/interfaces/commander-execution-context.interface.d.mts

@@ -0,0 +1,11 @@
+import type { CommandMetadata } from '../metadata/command.metadata.mjs';
+export declare class CommanderExecutionContext {
+    private readonly command;
+    private readonly commandPath;
+    private readonly options;
+    constructor(command: CommandMetadata, commandPath: string, options: any);
+    getCommand(): CommandMetadata;
+    getCommandPath(): string;
+    getOptions(): any;
+}
+//# sourceMappingURL=commander-execution-context.interface.d.mts.map

package/dist/src/interfaces/commander-execution-context.interface.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commander-execution-context.interface.d.mts","sourceRoot":"","sources":["../../../src/interfaces/commander-execution-context.interface.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAA;AAEvE,qBAAa,yBAAyB;IAElC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAFP,OAAO,EAAE,eAAe,EACxB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,GAAG;IAG/B,UAAU,IAAI,eAAe;IAI7B,cAAc,IAAI,MAAM;IAIxB,UAAU,IAAI,GAAG;CAGlB"}

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

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

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

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

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

@@ -28,11 +28,21 @@ export declare class CliParserService {
      * Handles ZodObject, ZodOptional, and ZodDefault wrappers
      */
     private extractBooleanFields;
+    /**
+     * Extracts array field names from a Zod schema
+     * Handles ZodObject, ZodOptional, and ZodDefault wrappers
+     */
+    private extractArrayFields;
     /**
      * Checks if a Zod schema represents a boolean type
      * Unwraps ZodOptional and ZodDefault
      */
     private isSchemaBoolean;
+    /**
+     * Checks if a Zod schema represents an array type
+     * Unwraps ZodOptional and ZodDefault
+     */
+    private isSchemaArray;
     /**
      * Formats help text for available commands
      */

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":"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"}
+{"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;IAsI/D;;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;;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/tokens/execution-context.token.d.mts

@@ -0,0 +1,5 @@
+import { InjectionToken } from '@navios/di';
+import type { CommanderExecutionContext } from '../interfaces/index.mjs';
+export declare const ExecutionContextInjectionToken = "CommanderExecutionContextInjectionToken";
+export declare const ExecutionContext: InjectionToken<CommanderExecutionContext, undefined, false>;
+//# sourceMappingURL=execution-context.token.d.mts.map

package/dist/src/tokens/execution-context.token.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context.token.d.mts","sourceRoot":"","sources":["../../../src/tokens/execution-context.token.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE3C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAA;AAExE,eAAO,MAAM,8BAA8B,4CACA,CAAA;AAE3C,eAAO,MAAM,gBAAgB,6DAE5B,CAAA"}

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

@@ -0,0 +1,2 @@
+export * from './execution-context.token.mjs';
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/tokens/index.mts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAA"}