@navios/commander 0.5.2 → 0.7.0

package/lib/index.js

@@ -1,642 +0,0 @@
-'use strict';
-
-var di = require('@navios/di');
-
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : Symbol.for("Symbol." + name);
-var __typeError = (msg) => {
-  throw TypeError(msg);
-};
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-var __decoratorStart = (base) => [, , , __create(null)];
-var __decoratorStrings = ["class", "method", "getter", "setter", "accessor", "field", "value", "get", "set"];
-var __expectFn = (fn) => fn !== void 0 && typeof fn !== "function" ? __typeError("Function expected") : fn;
-var __decoratorContext = (kind, name, done, metadata, fns) => ({ kind: __decoratorStrings[kind], name, metadata, addInitializer: (fn) => done._ ? __typeError("Already initialized") : fns.push(__expectFn(fn || null)) });
-var __decoratorMetadata = (array, target) => __defNormalProp(target, __knownSymbol("metadata"), array[3]);
-var __runInitializers = (array, flags, self, value) => {
-  for (var i = 0, fns = array[flags >> 1], n = fns && fns.length; i < n; i++) fns[i].call(self) ;
-  return value;
-};
-var __decorateElement = (array, flags, name, decorators, target, extra) => {
-  var it, done, ctx, k = flags & 7, p = false;
-  var j = 0;
-  var extraInitializers = array[j] || (array[j] = []);
-  var desc = k && ((target = target.prototype), k < 5 && (k > 3 || !p) && __getOwnPropDesc(target , name));
-  __name(target, name);
-  for (var i = decorators.length - 1; i >= 0; i--) {
-    ctx = __decoratorContext(k, name, done = {}, array[3], extraInitializers);
-    it = (0, decorators[i])(target, ctx), done._ = 1;
-    __expectFn(it) && (target = it);
-  }
-  return __decoratorMetadata(array, target), desc && __defProp(target, name, desc), p ? k ^ 4 ? extra : desc : target;
-};
-
-// src/interfaces/commander-execution-context.interface.mts
-var CommanderExecutionContext = class {
-  constructor(command, commandPath, options) {
-    this.command = command;
-    this.commandPath = commandPath;
-    this.options = options;
-  }
-  getCommand() {
-    return this.command;
-  }
-  getCommandPath() {
-    return this.commandPath;
-  }
-  getOptions() {
-    return this.options;
-  }
-};
-
-// src/metadata/command.metadata.mts
-var CommandMetadataKey = Symbol("CommandMetadataKey");
-function getCommandMetadata(target, context, path, optionsSchema) {
-  if (context.metadata) {
-    const metadata = context.metadata[CommandMetadataKey];
-    if (metadata) {
-      return metadata;
-    } else {
-      const newMetadata = {
-        path,
-        optionsSchema,
-        customAttributes: /* @__PURE__ */ new Map()
-      };
-      context.metadata[CommandMetadataKey] = newMetadata;
-      target[CommandMetadataKey] = newMetadata;
-      return newMetadata;
-    }
-  }
-  throw new Error("[Navios Commander] Wrong environment.");
-}
-function extractCommandMetadata(target) {
-  const metadata = target[CommandMetadataKey];
-  if (!metadata) {
-    throw new Error(
-      "[Navios Commander] Command metadata not found. Make sure to use @Command decorator."
-    );
-  }
-  return metadata;
-}
-function hasCommandMetadata(target) {
-  const metadata = target[CommandMetadataKey];
-  return !!metadata;
-}
-
-// src/metadata/cli-module.metadata.mts
-var CliModuleMetadataKey = Symbol("CliModuleMetadataKey");
-function getCliModuleMetadata(target, context) {
-  if (context.metadata) {
-    const metadata = context.metadata[CliModuleMetadataKey];
-    if (metadata) {
-      return metadata;
-    } else {
-      const newMetadata = {
-        commands: /* @__PURE__ */ new Set(),
-        imports: /* @__PURE__ */ new Set(),
-        customAttributes: /* @__PURE__ */ new Map()
-      };
-      context.metadata[CliModuleMetadataKey] = newMetadata;
-      target[CliModuleMetadataKey] = newMetadata;
-      return newMetadata;
-    }
-  }
-  throw new Error("[Navios Commander] Wrong environment.");
-}
-function extractCliModuleMetadata(target) {
-  const metadata = target[CliModuleMetadataKey];
-  if (!metadata) {
-    throw new Error(
-      `[Navios Commander] Module metadata not found for ${target.name}. Make sure to use @CliModule decorator.`
-    );
-  }
-  return metadata;
-}
-function hasCliModuleMetadata(target) {
-  return !!target[CliModuleMetadataKey];
-}
-
-// src/services/module-loader.service.mts
-var _ModuleLoaderService_decorators, _init;
-_ModuleLoaderService_decorators = [di.Injectable()];
-exports.ModuleLoaderService = class ModuleLoaderService {
-  container = di.inject(di.Container);
-  modulesMetadata = /* @__PURE__ */ new Map();
-  loadedModules = /* @__PURE__ */ new Map();
-  commandsMetadata = /* @__PURE__ */ new Map();
-  initialized = false;
-  async loadModules(appModule) {
-    if (this.initialized) {
-      return;
-    }
-    await this.traverseModules(appModule);
-    this.initialized = true;
-  }
-  async traverseModules(module, parentMetadata) {
-    const metadata = extractCliModuleMetadata(module);
-    if (parentMetadata) {
-      this.mergeMetadata(metadata, parentMetadata);
-    }
-    const moduleName = module.name;
-    if (this.modulesMetadata.has(moduleName)) {
-      return;
-    }
-    this.modulesMetadata.set(moduleName, metadata);
-    for (const command of metadata.commands) {
-      const commandMetadata = extractCommandMetadata(command);
-      this.commandsMetadata.set(commandMetadata.path, {
-        class: command,
-        metadata: commandMetadata
-      });
-    }
-    const imports = metadata.imports ?? /* @__PURE__ */ new Set();
-    const loadingPromises = Array.from(imports).map(
-      async (importedModule) => this.traverseModules(importedModule, metadata)
-    );
-    await Promise.all(loadingPromises);
-    const instance = await this.container.get(module);
-    if (instance.onModuleInit) {
-      await instance.onModuleInit();
-    }
-    this.loadedModules.set(moduleName, instance);
-  }
-  mergeMetadata(metadata, parentMetadata) {
-    if (parentMetadata.customAttributes) {
-      for (const [key, value] of parentMetadata.customAttributes) {
-        if (metadata.customAttributes.has(key)) {
-          continue;
-        }
-        metadata.customAttributes.set(key, value);
-      }
-    }
-  }
-  getAllModules() {
-    return this.modulesMetadata;
-  }
-  getAllCommands() {
-    const commands = /* @__PURE__ */ new Map();
-    for (const metadata of this.modulesMetadata.values()) {
-      for (const command of metadata.commands) {
-        commands.set(command.name, command);
-      }
-    }
-    return commands;
-  }
-  /**
-   * Get all commands with their metadata, indexed by command path.
-   * This is populated during loadModules, so path information is available
-   * before parsing CLI argv.
-   */
-  getAllCommandsWithMetadata() {
-    return this.commandsMetadata;
-  }
-  /**
-   * Get a command by its path, with metadata already extracted.
-   * Returns undefined if command is not found.
-   */
-  getCommandByPath(path) {
-    return this.commandsMetadata.get(path);
-  }
-  dispose() {
-    this.modulesMetadata.clear();
-    this.loadedModules.clear();
-    this.commandsMetadata.clear();
-    this.initialized = false;
-  }
-};
-_init = __decoratorStart();
-exports.ModuleLoaderService = __decorateElement(_init, 0, "ModuleLoaderService", _ModuleLoaderService_decorators, exports.ModuleLoaderService);
-__runInitializers(_init, 1, exports.ModuleLoaderService);
-var _CliParserService_decorators, _init2;
-_CliParserService_decorators = [di.Injectable()];
-exports.CliParserService = class CliParserService {
-  /**
-   * Parses command-line arguments from process.argv
-   * Commands can be multi-word (e.g., 'db migrate', 'cache clear')
-   * Expected format: node script.js command [subcommand...] --flag value --boolean-flag positional1 positional2
-   *
-   * @param argv - Array of command-line arguments (typically process.argv)
-   * @param optionsSchema - Optional Zod schema to determine boolean flags and option types
-   * @returns Parsed command (space-separated if multi-word), options, and positional arguments
-   */
-  parse(argv, optionsSchema) {
-    const args = argv.slice(2);
-    if (args.length === 0) {
-      throw new Error("[Navios Commander] No command provided");
-    }
-    const booleanFields = optionsSchema ? this.extractBooleanFields(optionsSchema) : /* @__PURE__ */ new Set();
-    const arrayFields = optionsSchema ? this.extractArrayFields(optionsSchema) : /* @__PURE__ */ new Set();
-    const commandParts = [];
-    let i = 0;
-    while (i < args.length && !args[i].startsWith("-")) {
-      commandParts.push(args[i]);
-      i++;
-    }
-    if (commandParts.length === 0) {
-      throw new Error("[Navios Commander] No command provided");
-    }
-    const command = commandParts.join(" ");
-    const options = {};
-    const positionals = [];
-    while (i < args.length) {
-      const arg = args[i];
-      if (arg.startsWith("--")) {
-        const key = arg.slice(2);
-        const equalIndex = key.indexOf("=");
-        if (equalIndex !== -1) {
-          const optionName = key.slice(0, equalIndex);
-          const optionValue = key.slice(equalIndex + 1);
-          const camelCaseKey = this.camelCase(optionName);
-          const isArray = arrayFields.has(camelCaseKey) || arrayFields.has(optionName);
-          if (isArray) {
-            if (!options[camelCaseKey]) {
-              options[camelCaseKey] = [];
-            }
-            options[camelCaseKey].push(this.parseValue(optionValue));
-          } else {
-            options[camelCaseKey] = this.parseValue(optionValue);
-          }
-          i++;
-        } else {
-          const camelCaseKey = this.camelCase(key);
-          const isBoolean = booleanFields.has(camelCaseKey) || booleanFields.has(key);
-          const isArray = arrayFields.has(camelCaseKey) || arrayFields.has(key);
-          const nextArg = args[i + 1];
-          if (isBoolean) {
-            options[camelCaseKey] = true;
-            i++;
-          } else if (isArray && nextArg && !nextArg.startsWith("-")) {
-            if (!options[camelCaseKey]) {
-              options[camelCaseKey] = [];
-            }
-            options[camelCaseKey].push(this.parseValue(nextArg));
-            i += 2;
-          } else if (nextArg && !nextArg.startsWith("-")) {
-            options[camelCaseKey] = this.parseValue(nextArg);
-            i += 2;
-          } else {
-            options[camelCaseKey] = true;
-            i++;
-          }
-        }
-      } else if (arg.startsWith("-") && arg.length > 1 && arg !== "-") {
-        const flags = arg.slice(1);
-        if (flags.length === 1) {
-          const isBoolean = booleanFields.has(flags);
-          const isArray = arrayFields.has(flags);
-          const nextArg = args[i + 1];
-          if (isBoolean) {
-            options[flags] = true;
-            i++;
-          } else if (isArray && nextArg && !nextArg.startsWith("-")) {
-            if (!options[flags]) {
-              options[flags] = [];
-            }
-            options[flags].push(this.parseValue(nextArg));
-            i += 2;
-          } else if (nextArg && !nextArg.startsWith("-")) {
-            options[flags] = this.parseValue(nextArg);
-            i += 2;
-          } else {
-            options[flags] = true;
-            i++;
-          }
-        } else {
-          for (const flag of flags) {
-            options[flag] = true;
-          }
-          i++;
-        }
-      } else {
-        positionals.push(arg);
-        i++;
-      }
-    }
-    return {
-      command,
-      options,
-      positionals
-    };
-  }
-  /**
-   * Converts kebab-case to camelCase
-   */
-  camelCase(str) {
-    return str.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
-  }
-  /**
-   * Attempts to parse string values into appropriate types
-   */
-  parseValue(value) {
-    if (value === "true") return true;
-    if (value === "false") return false;
-    if (value === "null") return null;
-    if (value === "undefined") return void 0;
-    if (/^-?\d+$/.test(value)) {
-      return parseInt(value, 10);
-    }
-    if (/^-?\d+\.\d+$/.test(value)) {
-      return parseFloat(value);
-    }
-    if (value.startsWith("{") && value.endsWith("}") || value.startsWith("[") && value.endsWith("]")) {
-      try {
-        return JSON.parse(value);
-      } catch {
-        return value;
-      }
-    }
-    return value;
-  }
-  /**
-   * Extracts boolean field names from a Zod schema
-   * Handles ZodObject, ZodOptional, and ZodDefault wrappers
-   */
-  extractBooleanFields(schema) {
-    const booleanFields = /* @__PURE__ */ new Set();
-    try {
-      const typeName = schema.def.type;
-      if (typeName === "object") {
-        const shape = schema.def.shape;
-        if (shape && typeof shape === "object") {
-          for (const [key, fieldSchema] of Object.entries(shape)) {
-            if (this.isSchemaBoolean(fieldSchema)) {
-              booleanFields.add(key);
-            }
-          }
-        }
-      }
-    } catch {
-    }
-    return booleanFields;
-  }
-  /**
-   * Extracts array field names from a Zod schema
-   * Handles ZodObject, ZodOptional, and ZodDefault wrappers
-   */
-  extractArrayFields(schema) {
-    const arrayFields = /* @__PURE__ */ new Set();
-    try {
-      const typeName = schema.def.type;
-      if (typeName === "object") {
-        const shape = schema.def.shape;
-        if (shape && typeof shape === "object") {
-          for (const [key, fieldSchema] of Object.entries(shape)) {
-            if (this.isSchemaArray(fieldSchema)) {
-              arrayFields.add(key);
-            }
-          }
-        }
-      }
-    } catch {
-    }
-    return arrayFields;
-  }
-  /**
-   * Checks if a Zod schema represents a boolean type
-   * Unwraps ZodOptional and ZodDefault
-   */
-  isSchemaBoolean(schema) {
-    try {
-      let currentSchema = schema;
-      const typeName = currentSchema.def.type;
-      if (typeName === "optional" || typeName === "default") {
-        currentSchema = currentSchema?._def?.innerType || currentSchema;
-      }
-      const innerTypeName = currentSchema.def.type;
-      return innerTypeName === "boolean";
-    } catch {
-      return false;
-    }
-  }
-  /**
-   * Checks if a Zod schema represents an array type
-   * Unwraps ZodOptional and ZodDefault
-   */
-  isSchemaArray(schema) {
-    try {
-      let currentSchema = schema;
-      const typeName = currentSchema.def.type;
-      if (typeName === "optional" || typeName === "default") {
-        currentSchema = currentSchema?._def?.innerType || currentSchema;
-      }
-      const innerTypeName = currentSchema.def.type;
-      return innerTypeName === "array";
-    } catch {
-      return false;
-    }
-  }
-  /**
-   * Formats help text for available commands
-   */
-  formatCommandList(commands) {
-    const lines = ["Available commands:", ""];
-    for (const { path } of commands) {
-      lines.push(`  ${path}`);
-    }
-    return lines.join("\n");
-  }
-};
-_init2 = __decoratorStart();
-exports.CliParserService = __decorateElement(_init2, 0, "CliParserService", _CliParserService_decorators, exports.CliParserService);
-__runInitializers(_init2, 1, exports.CliParserService);
-var ExecutionContextInjectionToken = "CommanderExecutionContextInjectionToken";
-var ExecutionContext = di.InjectionToken.create(
-  ExecutionContextInjectionToken
-);
-
-// src/commander.application.mts
-var _CommanderApplication_decorators, _init3;
-_CommanderApplication_decorators = [di.Injectable()];
-exports.CommanderApplication = class CommanderApplication {
-  moduleLoader = di.inject(exports.ModuleLoaderService);
-  cliParser = di.inject(exports.CliParserService);
-  container = di.inject(di.Container);
-  appModule = null;
-  options = {};
-  isInitialized = false;
-  async setup(appModule, options = {}) {
-    this.appModule = appModule;
-    this.options = options;
-  }
-  getContainer() {
-    return this.container;
-  }
-  async init() {
-    if (!this.appModule) {
-      throw new Error(
-        "[Navios Commander] App module is not set. Call setup() first."
-      );
-    }
-    await this.moduleLoader.loadModules(this.appModule);
-    this.isInitialized = true;
-  }
-  async executeCommand(commandPath, options = {}) {
-    if (!this.isInitialized) {
-      throw new Error(
-        "[Navios Commander] Application is not initialized. Call init() first."
-      );
-    }
-    const commandWithMetadata = this.moduleLoader.getCommandByPath(commandPath);
-    if (!commandWithMetadata) {
-      throw new Error(`[Navios Commander] Command not found: ${commandPath}`);
-    }
-    const { class: commandClass, metadata } = commandWithMetadata;
-    let validatedOptions = options;
-    if (metadata.optionsSchema) {
-      validatedOptions = metadata.optionsSchema.parse(options);
-    }
-    const executionContext = new CommanderExecutionContext(
-      metadata,
-      commandPath,
-      validatedOptions
-    );
-    const requestId = `cmd-${Date.now()}-${Math.random().toString(36).substring(7)}`;
-    const requestContext = this.container.beginRequest(requestId);
-    requestContext.addInstance(ExecutionContext, executionContext);
-    try {
-      this.container.setCurrentRequestContext(requestId);
-      const commandInstance = await this.container.get(
-        commandClass
-      );
-      if (!commandInstance.execute) {
-        throw new Error(
-          `[Navios Commander] Command ${commandPath} does not implement execute method`
-        );
-      }
-      await commandInstance.execute(validatedOptions);
-    } finally {
-      await this.container.endRequest(requestId);
-    }
-  }
-  getAllCommands() {
-    const commandsMap = this.moduleLoader.getAllCommandsWithMetadata();
-    const commandsWithMetadata = [];
-    for (const [, { class: cmd, metadata }] of commandsMap) {
-      commandsWithMetadata.push({
-        path: metadata.path,
-        class: cmd
-      });
-    }
-    return commandsWithMetadata;
-  }
-  /**
-   * Runs the CLI application by parsing process.argv and executing the command
-   * @param argv - Command-line arguments (defaults to process.argv)
-   */
-  async run(argv = process.argv) {
-    if (!this.isInitialized) {
-      throw new Error(
-        "[Navios Commander] Application is not initialized. Call init() first."
-      );
-    }
-    try {
-      const preliminaryParse = this.cliParser.parse(argv);
-      const commandWithMetadata = this.moduleLoader.getCommandByPath(
-        preliminaryParse.command
-      );
-      const parsed = commandWithMetadata?.metadata.optionsSchema ? this.cliParser.parse(argv, commandWithMetadata.metadata.optionsSchema) : preliminaryParse;
-      if (parsed.command === "help" || parsed.options.help || parsed.options.h) {
-        const commands = this.getAllCommands();
-        console.log(this.cliParser.formatCommandList(commands));
-        return;
-      }
-      await this.executeCommand(parsed.command, parsed.options);
-    } catch (error) {
-      if (error instanceof Error) {
-        console.error(`Error: ${error.message}`);
-        if (error.message.includes("Command not found")) {
-          console.log(
-            "\n" + this.cliParser.formatCommandList(this.getAllCommands())
-          );
-        }
-      }
-      throw error;
-    }
-  }
-  async dispose() {
-    if (this.moduleLoader) {
-      this.moduleLoader.dispose();
-    }
-  }
-  async close() {
-    await this.dispose();
-  }
-};
-_init3 = __decoratorStart();
-exports.CommanderApplication = __decorateElement(_init3, 0, "CommanderApplication", _CommanderApplication_decorators, exports.CommanderApplication);
-__runInitializers(_init3, 1, exports.CommanderApplication);
-var CommanderFactory = class {
-  static async create(appModule, options = {}) {
-    const container = new di.Container();
-    const app = await container.get(exports.CommanderApplication);
-    await app.setup(appModule, options);
-    return app;
-  }
-};
-function Command({ path, optionsSchema }) {
-  return function(target, context) {
-    if (context.kind !== "class") {
-      throw new Error(
-        "[Navios Commander] @Command decorator can only be used on classes."
-      );
-    }
-    const token = di.InjectionToken.create(target);
-    if (context.metadata) {
-      getCommandMetadata(target, context, path, optionsSchema);
-    }
-    return di.Injectable({
-      token,
-      scope: di.InjectableScope.Singleton
-    })(target, context);
-  };
-}
-function CliModule({ commands = [], imports = [] } = {
-  commands: [],
-  imports: []
-}) {
-  return (target, context) => {
-    if (context.kind !== "class") {
-      throw new Error(
-        "[Navios Commander] @CliModule decorator can only be used on classes."
-      );
-    }
-    const token = di.InjectionToken.create(target);
-    const moduleMetadata = getCliModuleMetadata(target, context);
-    for (const command of commands) {
-      moduleMetadata.commands.add(command);
-    }
-    for (const importedModule of imports) {
-      moduleMetadata.imports.add(importedModule);
-    }
-    return di.Injectable({
-      token,
-      scope: di.InjectableScope.Singleton
-    })(target, context);
-  };
-}
-
-exports.CliModule = CliModule;
-exports.CliModuleMetadataKey = CliModuleMetadataKey;
-exports.Command = Command;
-exports.CommandMetadataKey = CommandMetadataKey;
-exports.CommanderExecutionContext = CommanderExecutionContext;
-exports.CommanderFactory = CommanderFactory;
-exports.ExecutionContext = ExecutionContext;
-exports.ExecutionContextInjectionToken = ExecutionContextInjectionToken;
-exports.extractCliModuleMetadata = extractCliModuleMetadata;
-exports.extractCommandMetadata = extractCommandMetadata;
-exports.getCliModuleMetadata = getCliModuleMetadata;
-exports.getCommandMetadata = getCommandMetadata;
-exports.hasCliModuleMetadata = hasCliModuleMetadata;
-exports.hasCommandMetadata = hasCommandMetadata;
-Object.keys(di).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return di[k]; }
-  });
-});
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map