@navios/commander 1.5.0 → 1.6.0

package/dist/tsdown.config.d.mts

@@ -1,3 +1,3 @@
-declare const _default: import("tsdown").UserConfig;
-export default _default;
-//# sourceMappingURL=tsdown.config.d.mts.map
+declare const _default: import('tsdown').UserConfig
+export default _default
+//# sourceMappingURL=tsdown.config.d.mts.map

package/dist/vitest.config.d.mts

@@ -1,3 +1,3 @@
-declare const _default: import("vitest/config").UserWorkspaceConfig;
-export default _default;
-//# sourceMappingURL=vitest.config.d.mts.map
+declare const _default: import('vitest/config').UserWorkspaceConfig
+export default _default
+//# sourceMappingURL=vitest.config.d.mts.map

package/lib/{cli-module.decorator-CRaNGvgl.d.cts → cli-module.decorator-BV3vVKlR.d.cts}

@@ -1,7 +1,8 @@
 import { ClassType, ClassTypeWithInstance, InjectionToken, Registry } from "@navios/core";
-import { ZodObject } from "zod";
+import { z } from "zod/v4";
 
 //#region src/interfaces/command-handler.interface.d.mts
+
 /**
  * Interface that all command classes must implement.
  *
@@ -13,7 +14,7 @@ import { ZodObject } from "zod";
  * @example
  * ```typescript
  * import { Command, CommandHandler } from '@navios/commander'
- * import { z } from 'zod'
+ * import { z } from 'zod/v4'
  *
  * const optionsSchema = z.object({
  *   name: z.string()
@@ -23,20 +24,24 @@ import { ZodObject } from "zod";
  *
  * @Command({ path: 'greet', optionsSchema })
  * export class GreetCommand implements CommandHandler<Options> {
- *   async execute(options: Options) {
+ *   async execute(options: Options, positionals?: string[]) {
  *     console.log(`Hello, ${options.name}!`)
+ *     if (positionals?.length) {
+ *       console.log(`Files: ${positionals.join(', ')}`)
+ *     }
  *   }
  * }
  * ```
  */
 interface CommandHandler<TOptions = any> {
   /**
-       * Executes the command with the provided options.
-       *
-       * @param options - The validated command options (validated against the command's schema if provided)
-       * @returns A promise or void
-       */
-  execute(options: TOptions): void | Promise<void>;
+   * Executes the command with the provided options and positional arguments.
+   *
+   * @param options - The validated command options (validated against the command's schema if provided)
+   * @param positionals - Positional arguments that don't match any option flags
+   * @returns A promise or void
+   */
+  execute(options: TOptions, positionals?: string[]): void | Promise<void>;
 }
 //#endregion
 //#region src/decorators/command.decorator.d.mts
@@ -47,34 +52,34 @@ interface CommandHandler<TOptions = any> {
  */
 interface CommandOptions {
   /**
-       * The token to use for the command.
-       * If provided, the command will be registered with this token.
-       */
+   * The token to use for the command.
+   * If provided, the command will be registered with this token.
+   */
   token?: InjectionToken<ClassTypeWithInstance<CommandHandler<any>>>;
   /**
-       * The command path that users will invoke from the CLI.
-       * Can be a single word (e.g., 'greet') or multi-word with colons (e.g., 'user:create', 'db:migrate').
-       */
+   * The command path that users will invoke from the CLI.
+   * Can be a single word (e.g., 'greet') or multi-word with colons (e.g., 'user:create', 'db:migrate').
+   */
   path: string;
   /**
-       * Optional description of the command for help text.
-       * Displayed when users run `help` or `--help`.
-       */
+   * Optional description of the command for help text.
+   * Displayed when users run `help` or `--help`.
+   */
   description?: string;
   /**
-       * Optional Zod schema for validating command options.
-       * If provided, options will be validated and parsed according to this schema.
-       */
-  optionsSchema?: ZodObject;
+   * Optional zod/v4 schema for validating command options.
+   * If provided, options will be validated and parsed according to this schema.
+   */
+  optionsSchema?: z.ZodObject;
   /**
-       * Priority level for the command.
-       * Higher priority commands will be loaded first.
-       */
+   * Priority level for the command.
+   * Higher priority commands will be loaded first.
+   */
   priority?: number;
   /**
-       * Registry to use for the command.
-       * Registry is used to store the command and its options schema.
-       */
+   * Registry to use for the command.
+   * Registry is used to store the command and its options schema.
+   */
   registry?: Registry;
 }
 /**
@@ -89,7 +94,7 @@ interface CommandOptions {
  * @example
  * ```typescript
  * import { Command, CommandHandler } from '@navios/commander'
- * import { z } from 'zod'
+ * import { z } from 'zod/v4'
  *
  * const optionsSchema = z.object({
  *   name: z.string(),
@@ -114,7 +119,7 @@ declare function Command({
   optionsSchema,
   priority,
   registry
-}: CommandOptions): (target: ClassType, context: ClassDecoratorContext) => any;
+}: CommandOptions): (target: ClassType, context: ClassDecoratorContext<abstract new (...args: any) => any>) => any;
 //#endregion
 //#region src/decorators/cli-module.decorator.d.mts
 /**
@@ -124,41 +129,41 @@ declare function Command({
  */
 interface CliModuleOptions {
   /**
-       * Array or Set of command classes to register in this module.
-       * Commands must be decorated with `@Command`.
-       */
+   * Array or Set of command classes to register in this module.
+   * Commands must be decorated with `@Command`.
+   */
   commands?: ClassType[] | Set<ClassType>;
   /**
-       * Array or Set of controller classes for HTTP endpoints.
-       * Allows mixing HTTP and CLI functionality in the same module.
-       */
+   * Array or Set of controller classes for HTTP endpoints.
+   * Allows mixing HTTP and CLI functionality in the same module.
+   */
   controllers?: ClassType[] | Set<ClassType>;
   /**
-       * Array or Set of other modules to import.
-       * Imported modules' commands and controllers will be available.
-       */
+   * Array or Set of other modules to import.
+   * Imported modules' commands and controllers will be available.
+   */
   imports?: ClassType[] | Set<ClassType>;
   /**
-       * Guards to apply to all controllers in this module.
-       * Guards are executed in reverse order (last guard first).
-       */
+   * Guards to apply to all controllers in this module.
+   * Guards are executed in reverse order (last guard first).
+   */
   guards?: ClassType[] | Set<ClassType>;
   /**
-       * Service override classes to import for side effects.
-       * These classes are imported to ensure their @Injectable decorators execute,
-       * allowing them to register with the DI system. Overrides should use the same
-       * InjectionToken as the original service with a higher priority.
-       */
+   * Service override classes to import for side effects.
+   * These classes are imported to ensure their @Injectable decorators execute,
+   * allowing them to register with the DI system. Overrides should use the same
+   * InjectionToken as the original service with a higher priority.
+   */
   overrides?: ClassType[] | Set<ClassType>;
   /**
-       * Priority level for the module.
-       * Higher priority modules will be loaded first.
-       */
+   * Priority level for the module.
+   * Higher priority modules will be loaded first.
+   */
   priority?: number;
   /**
-       * Registry to use for the module.
-       * Registry is used to store the module and its commands.
-       */
+   * Registry to use for the module.
+   * Registry is used to store the module and its commands.
+   */
   registry?: Registry;
 }
 /**
@@ -206,7 +211,7 @@ declare function CliModule({
   overrides,
   priority,
   registry
-}?: CliModuleOptions): (target: ClassType, context: ClassDecoratorContext) => ClassType;
+}?: CliModuleOptions): (target: ClassType, context: ClassDecoratorContext<abstract new (...args: any) => any>) => ClassType;
 //#endregion
 export { CommandHandler as a, CommandOptions as i, CliModuleOptions as n, Command as r, CliModule as t };
-//# sourceMappingURL=cli-module.decorator-CRaNGvgl.d.cts.map
+//# sourceMappingURL=cli-module.decorator-BV3vVKlR.d.cts.map

package/lib/cli-module.decorator-BV3vVKlR.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-module.decorator-BV3vVKlR.d.cts","names":["CommandHandler","TOptions","Promise","InjectionToken","ClassType","ClassTypeWithInstance","Registry","z","CommandHandler","CommandOptions","ZodObject","Command","path","description","token","optionsSchema","priority","registry","ClassDecoratorContext","ClassType","Registry","CliModuleOptions","Set","CliModule","commands","controllers","imports","guards","overrides","priority","registry","ClassDecoratorContext"],"sources":["../src/interfaces/command-handler.interface.d.mts","../src/decorators/command.decorator.d.mts","../src/decorators/cli-module.decorator.d.mts"],"sourcesContent":["/**\n * Interface that all command classes must implement.\n *\n * Commands decorated with `@Command` must implement this interface.\n * The `execute` method is called when the command is invoked.\n *\n * @template TOptions - The type of options that the command accepts\n *\n * @example\n * ```typescript\n * import { Command, CommandHandler } from '@navios/commander'\n * import { z } from 'zod/v4'\n *\n * const optionsSchema = z.object({\n *   name: z.string()\n * })\n *\n * type Options = z.infer<typeof optionsSchema>\n *\n * @Command({ path: 'greet', optionsSchema })\n * export class GreetCommand implements CommandHandler<Options> {\n *   async execute(options: Options, positionals?: string[]) {\n *     console.log(`Hello, ${options.name}!`)\n *     if (positionals?.length) {\n *       console.log(`Files: ${positionals.join(', ')}`)\n *     }\n *   }\n * }\n * ```\n */\nexport interface CommandHandler<TOptions = any> {\n  /**\n   * Executes the command with the provided options and positional arguments.\n   *\n   * @param options - The validated command options (validated against the command's schema if provided)\n   * @param positionals - Positional arguments that don't match any option flags\n   * @returns A promise or void\n   */\n  execute(options: TOptions, positionals?: string[]): void | Promise<void>\n}\n//# sourceMappingURL=command-handler.interface.d.mts.map\n","import { InjectionToken } from '@navios/core'\n\nimport type { ClassType, ClassTypeWithInstance, Registry } from '@navios/core'\nimport type { z } from 'zod/v4'\n\nimport type { CommandHandler } from '../interfaces/index.mjs'\n/**\n * Options for the `@Command` decorator.\n *\n * @public\n */\nexport interface CommandOptions {\n  /**\n   * The token to use for the command.\n   * If provided, the command will be registered with this token.\n   */\n  token?: InjectionToken<ClassTypeWithInstance<CommandHandler<any>>>\n  /**\n   * The command path that users will invoke from the CLI.\n   * Can be a single word (e.g., 'greet') or multi-word with colons (e.g., 'user:create', 'db:migrate').\n   */\n  path: string\n  /**\n   * Optional description of the command for help text.\n   * Displayed when users run `help` or `--help`.\n   */\n  description?: string\n  /**\n   * Optional zod/v4 schema for validating command options.\n   * If provided, options will be validated and parsed according to this schema.\n   */\n  optionsSchema?: z.ZodObject\n  /**\n   * Priority level for the command.\n   * Higher priority commands will be loaded first.\n   */\n  priority?: number\n  /**\n   * Registry to use for the command.\n   * Registry is used to store the command and its options schema.\n   */\n  registry?: Registry\n}\n/**\n * Decorator that marks a class as a CLI command.\n *\n * The decorated class must implement the `CommandHandler` interface with an `execute` method.\n * The command will be automatically registered when its module is loaded.\n *\n * @param options - Configuration options for the command\n * @returns A class decorator function\n *\n * @example\n * ```typescript\n * import { Command, CommandHandler } from '@navios/commander'\n * import { z } from 'zod/v4'\n *\n * const optionsSchema = z.object({\n *   name: z.string(),\n *   greeting: z.string().optional().default('Hello')\n * })\n *\n * @Command({\n *   path: 'greet',\n *   optionsSchema: optionsSchema\n * })\n * export class GreetCommand implements CommandHandler<z.infer<typeof optionsSchema>> {\n *   async execute(options) {\n *     console.log(`${options.greeting}, ${options.name}!`)\n *   }\n * }\n * ```\n */\nexport declare function Command({\n  path,\n  description,\n  token,\n  optionsSchema,\n  priority,\n  registry,\n}: CommandOptions): (\n  target: ClassType,\n  context: ClassDecoratorContext<abstract new (...args: any) => any>,\n) => any\n//# sourceMappingURL=command.decorator.d.mts.map\n","import type { ClassType, Registry } from '@navios/core'\n/**\n * Options for the `@CliModule` decorator.\n *\n * @public\n */\nexport interface CliModuleOptions {\n  /**\n   * Array or Set of command classes to register in this module.\n   * Commands must be decorated with `@Command`.\n   */\n  commands?: ClassType[] | Set<ClassType>\n  /**\n   * Array or Set of controller classes for HTTP endpoints.\n   * Allows mixing HTTP and CLI functionality in the same module.\n   */\n  controllers?: ClassType[] | Set<ClassType>\n  /**\n   * Array or Set of other modules to import.\n   * Imported modules' commands and controllers will be available.\n   */\n  imports?: ClassType[] | Set<ClassType>\n  /**\n   * Guards to apply to all controllers in this module.\n   * Guards are executed in reverse order (last guard first).\n   */\n  guards?: ClassType[] | Set<ClassType>\n  /**\n   * Service override classes to import for side effects.\n   * These classes are imported to ensure their @Injectable decorators execute,\n   * allowing them to register with the DI system. Overrides should use the same\n   * InjectionToken as the original service with a higher priority.\n   */\n  overrides?: ClassType[] | Set<ClassType>\n  /**\n   * Priority level for the module.\n   * Higher priority modules will be loaded first.\n   */\n  priority?: number\n  /**\n   * Registry to use for the module.\n   * Registry is used to store the module and its commands.\n   */\n  registry?: Registry\n}\n/**\n * Decorator that marks a class as a CLI module.\n *\n * This decorator extends the standard @Module decorator, adding support for\n * CLI commands while maintaining full compatibility with HTTP controllers.\n * Modules organize commands and can import other modules to compose larger\n * CLI applications.\n *\n * The module can optionally implement `NaviosModule` interface for lifecycle hooks.\n *\n * @param options - Configuration options for the module\n * @returns A class decorator function\n *\n * @example\n * ```typescript\n * import { CliModule } from '@navios/commander'\n * import { GreetCommand } from './greet.command'\n * import { UserModule } from './user.module'\n *\n * @CliModule({\n *   commands: [GreetCommand],\n *   imports: [UserModule]\n * })\n * export class AppModule {}\n * ```\n *\n * @example\n * ```typescript\n * // Mixed HTTP and CLI module\n * @CliModule({\n *   controllers: [HealthController],\n *   commands: [MigrateCommand],\n *   imports: [DatabaseModule],\n * })\n * export class AppModule {}\n * ```\n */\nexport declare function CliModule({\n  commands,\n  controllers,\n  imports,\n  guards,\n  overrides,\n  priority,\n  registry,\n}?: CliModuleOptions): (\n  target: ClassType,\n  context: ClassDecoratorContext<abstract new (...args: any) => any>,\n) => ClassType\n//# sourceMappingURL=cli-module.decorator.d.mts.map\n"],"mappings":";;;;;;;;;AA8BA;;;;ACnBA;;;;;;;AA8DA;;;;;;;;;;;;;;ACnEA;AAKamB,UFmBInB,cEnBJmB,CAAAA,WAAAA,GAAAA,CAAAA,CAAAA;EAAkBA;;;;;;;EAULG,OAAAA,CAAAA,OAAAA,EFiBPrB,QEjBOqB,EAAAA,WAAAA,CAAAA,EAAAA,MAAAA,EAAAA,CAAAA,EAAAA,IAAAA,GFiBmCpB,OEjBnCoB,CAAAA,IAAAA,CAAAA;;;;;;ADV1B;;;AAKUnB,UALOM,cAAAA,CAKPN;EAeQI;;;AA0ClB;EACEK,KAAAA,CAAAA,EA1DQT,cA0DRS,CA1DuBP,qBA0DvBO,CA1D6CJ,cA0D7CI,CAAAA,GAAAA,CAAAA,CAAAA,CAAAA;EACAC;;;;EAIAI,IAAAA,EAAAA,MAAAA;EACCR;;;;;;;AC1EH;;EAK+BU,aAAAA,CAAAA,EDoBbZ,CAAAA,CAAEG,SCpBWS;EAAJG;;;;EAUfH,QAAAA,CAAAA,EAAAA,MAAAA;EAAkBA;;;;EAKLG,QAAAA,CAAAA,EDeZhB,QCfYgB;;;;;;AAwDzB;;;;;;;;;;;;;;;;;;;;;;;;;;iBDTwBX,OAAAA;;;;;;;GAOrBF,0BACOL,oBACCc;;;;;;ADpDX;;UExBiBG,gBAAAA;;ADKjB;;;EAKUlB,QAAAA,CAAAA,ECLGgB,SDKHhB,EAAAA,GCLiBmB,GDKjBnB,CCLqBgB,SDKrBhB,CAAAA;EAeQI;;;AA0ClB;EACEK,WAAAA,CAAAA,EC1DcO,SD0DdP,EAAAA,GC1D4BU,GD0D5BV,CC1DgCO,SD0DhCP,CAAAA;EACAC;;;;EAIAI,OAAAA,CAAAA,EC1DUE,SD0DVF,EAAAA,GC1DwBK,GD0DxBL,CC1D4BE,SD0D5BF,CAAAA;EACCR;;;;WCtDQU,cAAcG,IAAIH;;;AApB7B;;;;EAUgBA,SAAAA,CAAAA,EAiBFA,SAjBEA,EAAAA,GAiBYG,GAjBZH,CAiBgBA,SAjBhBA,CAAAA;EAAkBA;;;;EAKRG,QAAAA,CAAAA,EAAAA,MAAAA;EAKfH;;;;EAOqBA,QAAAA,CAAAA,EAUnBC,QAVmBD;;;;AAiDhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAwBI,SAAAA;;;;;;;;IAQpBF,4BACMF,oBACCY,8DACNZ"}

package/lib/{cli-module.decorator-CkP22084.cjs → cli-module.decorator-CXt38aqF.cjs}

@@ -1,4 +1,4 @@
-const require_command_decorator = require('./command.decorator-UrNJmQN0.cjs');
+const require_command_decorator = require('./command.decorator-HziankUv.cjs');
 let _navios_core = require("@navios/core");
 
 //#region src/decorators/cli-module.decorator.mts
@@ -68,4 +68,4 @@ Object.defineProperty(exports, 'CliModule', {
     return CliModule;
   }
 });
-//# sourceMappingURL=cli-module.decorator-CkP22084.cjs.map
+//# sourceMappingURL=cli-module.decorator-CXt38aqF.cjs.map

package/lib/cli-module.decorator-CXt38aqF.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-module.decorator-CXt38aqF.cjs","names":["Module","getModuleMetadata","getModuleCustomEntry","CommandEntryKey","CliModule","commands","controllers","imports","guards","overrides","priority","registry","target","context","kind","Error","result","metadata","commandSet","Set","command","add"],"sources":["../src/decorators/cli-module.decorator.mts"],"sourcesContent":["import { Module, getModuleMetadata, getModuleCustomEntry } from '@navios/core'\n\nimport type { ClassType, Registry } from '@navios/core'\n\nimport { CommandEntryKey, type CommandEntryValue } from '../metadata/command-entry.metadata.mjs'\n\n/**\n * Options for the `@CliModule` decorator.\n *\n * @public\n */\nexport interface CliModuleOptions {\n  /**\n   * Array or Set of command classes to register in this module.\n   * Commands must be decorated with `@Command`.\n   */\n  commands?: ClassType[] | Set<ClassType>\n  /**\n   * Array or Set of controller classes for HTTP endpoints.\n   * Allows mixing HTTP and CLI functionality in the same module.\n   */\n  controllers?: ClassType[] | Set<ClassType>\n  /**\n   * Array or Set of other modules to import.\n   * Imported modules' commands and controllers will be available.\n   */\n  imports?: ClassType[] | Set<ClassType>\n  /**\n   * Guards to apply to all controllers in this module.\n   * Guards are executed in reverse order (last guard first).\n   */\n  guards?: ClassType[] | Set<ClassType>\n  /**\n   * Service override classes to import for side effects.\n   * These classes are imported to ensure their @Injectable decorators execute,\n   * allowing them to register with the DI system. Overrides should use the same\n   * InjectionToken as the original service with a higher priority.\n   */\n  overrides?: ClassType[] | Set<ClassType>\n  /**\n   * Priority level for the module.\n   * Higher priority modules will be loaded first.\n   */\n  priority?: number\n  /**\n   * Registry to use for the module.\n   * Registry is used to store the module and its commands.\n   */\n  registry?: Registry\n}\n\n/**\n * Decorator that marks a class as a CLI module.\n *\n * This decorator extends the standard @Module decorator, adding support for\n * CLI commands while maintaining full compatibility with HTTP controllers.\n * Modules organize commands and can import other modules to compose larger\n * CLI applications.\n *\n * The module can optionally implement `NaviosModule` interface for lifecycle hooks.\n *\n * @param options - Configuration options for the module\n * @returns A class decorator function\n *\n * @example\n * ```typescript\n * import { CliModule } from '@navios/commander'\n * import { GreetCommand } from './greet.command'\n * import { UserModule } from './user.module'\n *\n * @CliModule({\n *   commands: [GreetCommand],\n *   imports: [UserModule]\n * })\n * export class AppModule {}\n * ```\n *\n * @example\n * ```typescript\n * // Mixed HTTP and CLI module\n * @CliModule({\n *   controllers: [HealthController],\n *   commands: [MigrateCommand],\n *   imports: [DatabaseModule],\n * })\n * export class AppModule {}\n * ```\n */\nexport function CliModule(\n  {\n    commands = [],\n    controllers = [],\n    imports = [],\n    guards = [],\n    overrides = [],\n    priority,\n    registry,\n  }: CliModuleOptions = {\n    commands: [],\n    controllers: [],\n    imports: [],\n    guards: [],\n    overrides: [],\n  },\n) {\n  return (target: ClassType, context: ClassDecoratorContext) => {\n    if (context.kind !== 'class') {\n      throw new Error('[Navios Commander] @CliModule decorator can only be used on classes.')\n    }\n\n    // Apply standard @Module decorator first\n    const result = Module({\n      controllers,\n      imports,\n      guards,\n      overrides,\n      priority,\n      registry,\n    })(target, context)\n\n    // Get the module metadata that @Module just created\n    const metadata = getModuleMetadata(target, context)\n\n    // Store commands in customEntries\n    const commandSet = getModuleCustomEntry<CommandEntryValue>(\n      metadata,\n      CommandEntryKey,\n      () => new Set(),\n    )\n    for (const command of commands) {\n      commandSet.add(command)\n    }\n\n    return result\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwFA,SAAgBI,UACd,EACEC,WAAW,EAAE,EACbC,cAAc,EAAE,EAChBC,UAAU,EAAE,EACZC,SAAS,EAAE,EACXC,YAAY,EAAE,EACdC,UACAC,aACoB;CACpBN,UAAU,EAAE;CACZC,aAAa,EAAE;CACfC,SAAS,EAAE;CACXC,QAAQ,EAAE;CACVC,WAAW,EAAE;CACd,EAAA;AAED,SAAQG,QAAmBC,YAAAA;AACzB,MAAIA,QAAQC,SAAS,QACnB,OAAM,IAAIC,MAAM,uEAAA;EAIlB,MAAMC,kCAAgB;GACpBV;GACAC;GACAC;GACAC;GACAC;GACAC;GACF,CAAA,CAAGC,QAAQC,QAAAA;EAMX,MAAMK,wFAH6BN,QAAQC,QAAAA,EAKzCV,iEACM,IAAIgB,KAAAA,CAAAA;AAEZ,OAAK,MAAMC,WAAWf,SACpBa,YAAWG,IAAID,QAAAA;AAGjB,SAAOJ"}

package/lib/{cli-module.decorator-UGbtkRYc.mjs → cli-module.decorator-DAjf_r_W.mjs}

@@ -1,4 +1,4 @@
-import { n as CommandEntryKey } from "./command.decorator-DVLSAqYZ.mjs";
+import { n as CommandEntryKey } from "./command.decorator-QiRU7ny3.mjs";
 import { Module, getModuleCustomEntry, getModuleMetadata } from "@navios/core";
 
 //#region src/decorators/cli-module.decorator.mts
@@ -63,4 +63,4 @@ import { Module, getModuleCustomEntry, getModuleMetadata } from "@navios/core";
 
 //#endregion
 export { CliModule as t };
-//# sourceMappingURL=cli-module.decorator-UGbtkRYc.mjs.map
+//# sourceMappingURL=cli-module.decorator-DAjf_r_W.mjs.map

package/lib/cli-module.decorator-DAjf_r_W.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-module.decorator-DAjf_r_W.mjs","names":["Module","getModuleMetadata","getModuleCustomEntry","CommandEntryKey","CliModule","commands","controllers","imports","guards","overrides","priority","registry","target","context","kind","Error","result","metadata","commandSet","Set","command","add"],"sources":["../src/decorators/cli-module.decorator.mts"],"sourcesContent":["import { Module, getModuleMetadata, getModuleCustomEntry } from '@navios/core'\n\nimport type { ClassType, Registry } from '@navios/core'\n\nimport { CommandEntryKey, type CommandEntryValue } from '../metadata/command-entry.metadata.mjs'\n\n/**\n * Options for the `@CliModule` decorator.\n *\n * @public\n */\nexport interface CliModuleOptions {\n  /**\n   * Array or Set of command classes to register in this module.\n   * Commands must be decorated with `@Command`.\n   */\n  commands?: ClassType[] | Set<ClassType>\n  /**\n   * Array or Set of controller classes for HTTP endpoints.\n   * Allows mixing HTTP and CLI functionality in the same module.\n   */\n  controllers?: ClassType[] | Set<ClassType>\n  /**\n   * Array or Set of other modules to import.\n   * Imported modules' commands and controllers will be available.\n   */\n  imports?: ClassType[] | Set<ClassType>\n  /**\n   * Guards to apply to all controllers in this module.\n   * Guards are executed in reverse order (last guard first).\n   */\n  guards?: ClassType[] | Set<ClassType>\n  /**\n   * Service override classes to import for side effects.\n   * These classes are imported to ensure their @Injectable decorators execute,\n   * allowing them to register with the DI system. Overrides should use the same\n   * InjectionToken as the original service with a higher priority.\n   */\n  overrides?: ClassType[] | Set<ClassType>\n  /**\n   * Priority level for the module.\n   * Higher priority modules will be loaded first.\n   */\n  priority?: number\n  /**\n   * Registry to use for the module.\n   * Registry is used to store the module and its commands.\n   */\n  registry?: Registry\n}\n\n/**\n * Decorator that marks a class as a CLI module.\n *\n * This decorator extends the standard @Module decorator, adding support for\n * CLI commands while maintaining full compatibility with HTTP controllers.\n * Modules organize commands and can import other modules to compose larger\n * CLI applications.\n *\n * The module can optionally implement `NaviosModule` interface for lifecycle hooks.\n *\n * @param options - Configuration options for the module\n * @returns A class decorator function\n *\n * @example\n * ```typescript\n * import { CliModule } from '@navios/commander'\n * import { GreetCommand } from './greet.command'\n * import { UserModule } from './user.module'\n *\n * @CliModule({\n *   commands: [GreetCommand],\n *   imports: [UserModule]\n * })\n * export class AppModule {}\n * ```\n *\n * @example\n * ```typescript\n * // Mixed HTTP and CLI module\n * @CliModule({\n *   controllers: [HealthController],\n *   commands: [MigrateCommand],\n *   imports: [DatabaseModule],\n * })\n * export class AppModule {}\n * ```\n */\nexport function CliModule(\n  {\n    commands = [],\n    controllers = [],\n    imports = [],\n    guards = [],\n    overrides = [],\n    priority,\n    registry,\n  }: CliModuleOptions = {\n    commands: [],\n    controllers: [],\n    imports: [],\n    guards: [],\n    overrides: [],\n  },\n) {\n  return (target: ClassType, context: ClassDecoratorContext) => {\n    if (context.kind !== 'class') {\n      throw new Error('[Navios Commander] @CliModule decorator can only be used on classes.')\n    }\n\n    // Apply standard @Module decorator first\n    const result = Module({\n      controllers,\n      imports,\n      guards,\n      overrides,\n      priority,\n      registry,\n    })(target, context)\n\n    // Get the module metadata that @Module just created\n    const metadata = getModuleMetadata(target, context)\n\n    // Store commands in customEntries\n    const commandSet = getModuleCustomEntry<CommandEntryValue>(\n      metadata,\n      CommandEntryKey,\n      () => new Set(),\n    )\n    for (const command of commands) {\n      commandSet.add(command)\n    }\n\n    return result\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwFA,SAAgBI,UACd,EACEC,WAAW,EAAE,EACbC,cAAc,EAAE,EAChBC,UAAU,EAAE,EACZC,SAAS,EAAE,EACXC,YAAY,EAAE,EACdC,UACAC,aACoB;CACpBN,UAAU,EAAE;CACZC,aAAa,EAAE;CACfC,SAAS,EAAE;CACXC,QAAQ,EAAE;CACVC,WAAW,EAAE;CACd,EAAA;AAED,SAAQG,QAAmBC,YAAAA;AACzB,MAAIA,QAAQC,SAAS,QACnB,OAAM,IAAIC,MAAM,uEAAA;EAIlB,MAAMC,SAAShB,OAAO;GACpBM;GACAC;GACAC;GACAC;GACAC;GACAC;GACF,CAAA,CAAGC,QAAQC,QAAAA;EAMX,MAAMK,aAAahB,qBAHFD,kBAAkBW,QAAQC,QAAAA,EAKzCV,uCACM,IAAIgB,KAAAA,CAAAA;AAEZ,OAAK,MAAMC,WAAWf,SACpBa,YAAWG,IAAID,QAAAA;AAGjB,SAAOJ"}