@navios/commander 1.2.0 → 1.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +9 -0
- package/README.md +50 -0
- package/dist/src/commander.factory.d.mts +5 -0
- package/dist/src/commander.factory.d.mts.map +1 -1
- package/dist/tsconfig.lib.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/lib/index.cjs +2 -0
- package/lib/index.cjs.map +1 -1
- package/lib/index.d.cts +5 -0
- package/lib/index.d.cts.map +1 -1
- package/lib/index.d.mts +5 -0
- package/lib/index.d.mts.map +1 -1
- package/lib/index.mjs +2 -0
- package/lib/index.mjs.map +1 -1
- package/package.json +1 -1
- package/src/commander.factory.mts +10 -0
package/lib/index.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.mjs","names":["inject","Logger","z","Command","CommandRegistryService","HelpCommandToken","helpOptionsSchema","object","command","string","optional","token","path","description","optionsSchema","HelpCommand","logger","context","commandRegistry","execute","options","log","formatCommandHelp","formatCommandList","CommanderExecutionContext","command","commandPath","options","getCommand","getCommandPath","getOptions","InjectionToken","CommandExecutionContextInjectionToken","CommandExecutionContext","create","Injectable","CliParserService","parse","argv","optionsSchema","args","slice","length","Error","booleanFields","extractBooleanFields","Set","arrayFields","extractArrayFields","commandParts","i","startsWith","push","command","join","options","positionals","arg","key","equalIndex","indexOf","optionName","optionValue","camelCaseKey","camelCase","isArray","has","parseValue","isBoolean","nextArg","flags","flag","str","replace","_","letter","toUpperCase","value","undefined","test","parseInt","parseFloat","endsWith","JSON","schema","typeName","def","type","shape","fieldSchema","Object","entries","isSchemaBoolean","add","isSchemaArray","currentSchema","innerType","Container","inject","Injectable","Logger","HelpCommand","CommanderExecutionContext","CommandEntryKey","extractCommandMetadata","hasCommandMetadata","CommandExecutionContext","CliParserService","CommandRegistryService","CommanderAdapterService","container","commandRegistry","cliParser","logger","context","options","isReady","setupAdapter","onModulesInit","modules","registerBuiltInCommands","moduleName","metadata","commands","customEntries","get","commandClass","warn","name","commandMetadata","register","path","class","helpMetadata","ready","dispose","clear","run","argv","process","Error","preliminaryParse","parse","help","h","command","executeCommand","getByPath","parsed","optionsSchema","error","message","includes","log","validatedOptions","executionContext","requestId","Date","now","Math","random","toString","substring","scopeContainer","beginRequest","addInstance","commandInstance","execute","endRequest","getAllCommands","getAllAsArray","AdapterToken","CommanderAdapterService","CommandRegistryService","CliParserService","defineCliEnvironment","tokens","Map","ConsoleLogger","NaviosFactory","defineCliEnvironment","CommanderFactory","create","appModule","options","enableTUI","tuiModule","Error","overrideConsoleLogger","ScreenManager","tuiOptions","hideDefaultScreen","app","adapter","logger","logLevels","screenManager","get","bind","exitOnCtrlC","sidebarWidth","sidebarPosition","sidebarTitle","autoClose","theme","useMouse","showTimeDiff","showPid","showLogLevel","showPrefix","showContext","showTimestamp"],"sources":["../src/commands/help.command.mts","../src/interfaces/commander-execution-context.interface.mts","../src/tokens/execution-context.token.mts","../src/services/cli-parser.service.mts","../src/services/commander-adapter.service.mts","../src/define-environment.mts","../src/commander.factory.mts"],"sourcesContent":["import { inject, Logger } from '@navios/core'\nimport { z } from 'zod'\n\nimport { Command } from '../decorators/command.decorator.mjs'\nimport { CommandRegistryService } from '../services/command-registry.service.mjs'\nimport { HelpCommandToken } from '../tokens/help-command.token.mjs'\n\nimport type { CommandHandler } from '../interfaces/command-handler.interface.mjs'\n\nconst helpOptionsSchema = z.object({\n command: z.string().optional(),\n})\n\ntype HelpOptions = z.infer<typeof helpOptionsSchema>\n\n/**\n * Built-in help command that lists all available commands or shows help for a specific command.\n *\n * @public\n */\n@Command({\n token: HelpCommandToken,\n path: 'help',\n description: 'Show available commands or help for a specific command',\n optionsSchema: helpOptionsSchema,\n})\nexport class HelpCommand implements CommandHandler<HelpOptions> {\n private logger = inject(Logger, { context: 'Commander' })\n private commandRegistry = inject(CommandRegistryService)\n\n async execute(options: HelpOptions): Promise<void> {\n if (options.command) {\n this.logger.log(this.commandRegistry.formatCommandHelp(options.command))\n } else {\n this.logger.log(this.commandRegistry.formatCommandList())\n }\n }\n}\n","import type { CommandMetadata } from '../metadata/command.metadata.mjs'\n\n/**\n * Execution context for a command execution.\n *\n * Provides access to command metadata, path, and validated options during command execution.\n * This context is automatically injected and available via the `CommandExecutionContext` token.\n *\n * @example\n * ```typescript\n * import { inject, Injectable } from '@navios/core'\n * import { CommandExecutionContext } from '@navios/commander'\n *\n * @Injectable()\n * class CommandLogger {\n * private ctx = inject(CommandExecutionContext)\n *\n * log() {\n * console.log('Command:', this.ctx.getCommandPath())\n * console.log('Options:', this.ctx.getOptions())\n * }\n * }\n * ```\n */\nexport class CommanderExecutionContext {\n /**\n * @internal\n * Creates a new execution context.\n */\n constructor(\n private readonly command: CommandMetadata,\n private readonly commandPath: string,\n private readonly options: any,\n ) {}\n\n /**\n * Gets the command metadata.\n *\n * @returns The command metadata including path and options schema\n */\n getCommand(): CommandMetadata {\n return this.command\n }\n\n /**\n * Gets the command path that was invoked.\n *\n * @returns The command path (e.g., 'greet', 'user:create')\n */\n getCommandPath(): string {\n return this.commandPath\n }\n\n /**\n * Gets the validated command options.\n *\n * Options are validated against the command's Zod schema if one was provided.\n *\n * @returns The validated options object\n */\n getOptions(): any {\n return this.options\n }\n}\n","import { InjectionToken } from '@navios/core'\n\nimport type { CommanderExecutionContext } from '../interfaces/index.mjs'\n\nconst CommandExecutionContextInjectionToken =\n 'CommanderExecutionContextInjectionToken'\n\n/**\n * Injection token for accessing the current command execution context.\n *\n * Use this token with `inject()` to access the `CommanderExecutionContext` in services\n * that need information about the currently executing command.\n *\n * @example\n * ```typescript\n * import { inject, Injectable } from '@navios/core'\n * import { CommandExecutionContext } from '@navios/commander'\n *\n * @Injectable()\n * class MyService {\n * private ctx = inject(CommandExecutionContext)\n *\n * doSomething() {\n * const commandPath = this.ctx.getCommandPath()\n * const options = this.ctx.getOptions()\n * // Use context information...\n * }\n * }\n * ```\n */\nexport const CommandExecutionContext =\n InjectionToken.create<CommanderExecutionContext>(\n CommandExecutionContextInjectionToken,\n )\n","import type { ZodObject, ZodType } from 'zod'\n\nimport { Injectable } from '@navios/core'\n\n/**\n * Result of parsing command-line arguments.\n *\n * @public\n */\nexport interface ParsedCliArgs {\n /**\n * The command path (e.g., 'greet', 'user:create').\n * Multi-word commands are joined with spaces.\n */\n command: string\n /**\n * Parsed options as key-value pairs.\n * Keys are converted from kebab-case to camelCase.\n */\n options: Record<string, any>\n /**\n * Positional arguments that don't match any option flags.\n */\n positionals: string[]\n}\n\n/**\n * Service for parsing command-line arguments.\n *\n * Handles parsing of various CLI argument formats including:\n * - Long options: `--key value` or `--key=value`\n * - Short options: `-k value` or `-abc` (multiple flags)\n * - Boolean flags\n * - Array options\n * - Positional arguments\n *\n * @public\n */\n@Injectable()\nexport class CliParserService {\n /**\n * Parses command-line arguments from process.argv\n * Commands can be multi-word (e.g., 'db migrate', 'cache clear')\n * Expected format: node script.js command [subcommand...] --flag value --boolean-flag positional1 positional2\n *\n * @param argv - Array of command-line arguments (typically process.argv)\n * @param optionsSchema - Optional Zod schema to determine boolean flags and option types\n * @returns Parsed command (space-separated if multi-word), options, and positional arguments\n */\n parse(argv: string[], optionsSchema?: ZodObject): ParsedCliArgs {\n // Skip first two args (node and script path)\n const args = argv.slice(2)\n\n if (args.length === 0) {\n throw new Error('[Navios Commander] No command provided')\n }\n\n // Extract boolean and array field names from schema for accurate parsing\n const booleanFields = optionsSchema\n ? this.extractBooleanFields(optionsSchema)\n : new Set<string>()\n const arrayFields = optionsSchema\n ? this.extractArrayFields(optionsSchema)\n : new Set<string>()\n\n // Collect command words until we hit an argument that starts with '-' or '--'\n const commandParts: string[] = []\n let i = 0\n while (i < args.length && !args[i].startsWith('-')) {\n commandParts.push(args[i])\n i++\n }\n\n if (commandParts.length === 0) {\n throw new Error('[Navios Commander] No command provided')\n }\n\n const command = commandParts.join(' ')\n const options: Record<string, any> = {}\n const positionals: string[] = []\n while (i < args.length) {\n const arg = args[i]\n\n if (arg.startsWith('--')) {\n // Long option format: --key=value or --key value\n const key = arg.slice(2)\n const equalIndex = key.indexOf('=')\n\n if (equalIndex !== -1) {\n // Format: --key=value\n const optionName = key.slice(0, equalIndex)\n const optionValue = key.slice(equalIndex + 1)\n const camelCaseKey = this.camelCase(optionName)\n const isArray =\n arrayFields.has(camelCaseKey) || arrayFields.has(optionName)\n\n if (isArray) {\n // For array fields, accumulate values\n if (!options[camelCaseKey]) {\n options[camelCaseKey] = []\n }\n options[camelCaseKey].push(this.parseValue(optionValue))\n } else {\n options[camelCaseKey] = this.parseValue(optionValue)\n }\n i++\n } else {\n // Format: --key value or --boolean-flag\n const camelCaseKey = this.camelCase(key)\n const isBoolean =\n booleanFields.has(camelCaseKey) || booleanFields.has(key)\n const isArray = arrayFields.has(camelCaseKey) || arrayFields.has(key)\n const nextArg = args[i + 1]\n\n if (isBoolean) {\n // Known boolean flag from schema\n options[camelCaseKey] = true\n i++\n } else if (isArray && nextArg && !nextArg.startsWith('-')) {\n // Known array field from schema - accumulate values\n if (!options[camelCaseKey]) {\n options[camelCaseKey] = []\n }\n options[camelCaseKey].push(this.parseValue(nextArg))\n i += 2\n } else if (nextArg && !nextArg.startsWith('-')) {\n // Has a value\n options[camelCaseKey] = this.parseValue(nextArg)\n i += 2\n } else {\n // Assume boolean flag\n options[camelCaseKey] = true\n i++\n }\n }\n } else if (arg.startsWith('-') && arg.length > 1 && arg !== '-') {\n // Short option format: -k value or -abc (multiple flags)\n const flags = arg.slice(1)\n\n if (flags.length === 1) {\n // Single short flag: -k value or -k\n const isBoolean = booleanFields.has(flags)\n const isArray = arrayFields.has(flags)\n const nextArg = args[i + 1]\n\n if (isBoolean) {\n // Known boolean flag from schema\n options[flags] = true\n i++\n } else if (isArray && nextArg && !nextArg.startsWith('-')) {\n // Known array field from schema - accumulate values\n if (!options[flags]) {\n options[flags] = []\n }\n options[flags].push(this.parseValue(nextArg))\n i += 2\n } else if (nextArg && !nextArg.startsWith('-')) {\n options[flags] = this.parseValue(nextArg)\n i += 2\n } else {\n options[flags] = true\n i++\n }\n } else {\n // Multiple short flags: -abc -> {a: true, b: true, c: true}\n for (const flag of flags) {\n options[flag] = true\n }\n i++\n }\n } else {\n // Positional argument\n positionals.push(arg)\n i++\n }\n }\n\n return {\n command,\n options,\n positionals,\n }\n }\n\n /**\n * Converts kebab-case to camelCase\n */\n private camelCase(str: string): string {\n return str.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase())\n }\n\n /**\n * Attempts to parse string values into appropriate types\n */\n private parseValue(value: string): any {\n // Check for boolean\n if (value === 'true') return true\n if (value === 'false') return false\n\n // Check for null/undefined\n if (value === 'null') return null\n if (value === 'undefined') return undefined\n\n // Check for number\n if (/^-?\\d+$/.test(value)) {\n return parseInt(value, 10)\n }\n if (/^-?\\d+\\.\\d+$/.test(value)) {\n return parseFloat(value)\n }\n\n // Check for JSON\n if (\n (value.startsWith('{') && value.endsWith('}')) ||\n (value.startsWith('[') && value.endsWith(']'))\n ) {\n try {\n return JSON.parse(value)\n } catch {\n // If parsing fails, return as string\n return value\n }\n }\n\n // Return as string\n return value\n }\n\n /**\n * Extracts boolean field names from a Zod schema\n * Handles ZodObject, ZodOptional, and ZodDefault wrappers\n */\n private extractBooleanFields(schema: ZodObject): Set<string> {\n const booleanFields = new Set<string>()\n\n try {\n // Check if schema has _def.typeName (Zod schema structure)\n const typeName = schema.def.type\n\n if (typeName === 'object') {\n // Extract shape from ZodObject\n const shape = schema.def.shape\n\n if (shape && typeof shape === 'object') {\n for (const [key, fieldSchema] of Object.entries(shape)) {\n if (this.isSchemaBoolean(fieldSchema as any)) {\n booleanFields.add(key)\n }\n }\n }\n }\n } catch {\n // Silently fail if schema introspection fails\n }\n\n return booleanFields\n }\n\n /**\n * Extracts array field names from a Zod schema\n * Handles ZodObject, ZodOptional, and ZodDefault wrappers\n */\n private extractArrayFields(schema: ZodObject): Set<string> {\n const arrayFields = new Set<string>()\n\n try {\n const typeName = schema.def.type\n\n if (typeName === 'object') {\n const shape = schema.def.shape\n\n if (shape && typeof shape === 'object') {\n for (const [key, fieldSchema] of Object.entries(shape)) {\n if (this.isSchemaArray(fieldSchema as any)) {\n arrayFields.add(key)\n }\n }\n }\n }\n } catch {\n // Silently fail if schema introspection fails\n }\n\n return arrayFields\n }\n\n /**\n * Checks if a Zod schema represents a boolean type\n * Unwraps ZodOptional and ZodDefault using Zod v4 API\n */\n private isSchemaBoolean(schema: ZodType): boolean {\n try {\n let currentSchema = schema\n let typeName = currentSchema.def.type\n\n // Unwrap ZodOptional and ZodDefault using Zod v4's def.innerType\n while (typeName === 'optional' || typeName === 'default') {\n currentSchema = (currentSchema as any)?.def?.innerType || currentSchema\n typeName = currentSchema.def.type\n }\n\n return typeName === 'boolean'\n } catch {\n return false\n }\n }\n\n /**\n * Checks if a Zod schema represents an array type\n * Unwraps ZodOptional and ZodDefault using Zod v4 API\n */\n private isSchemaArray(schema: ZodType): boolean {\n try {\n let currentSchema = schema\n let typeName = currentSchema.def.type\n\n // Unwrap ZodOptional and ZodDefault using Zod v4's def.innerType\n while (typeName === 'optional' || typeName === 'default') {\n currentSchema = (currentSchema as any)?.def?.innerType || currentSchema\n typeName = currentSchema.def.type\n }\n\n return typeName === 'array'\n } catch {\n return false\n }\n }\n}\n","import type { ClassType, ModuleMetadata } from '@navios/core'\n\nimport {\n Container,\n inject,\n Injectable,\n InjectionToken,\n Logger,\n} from '@navios/core'\n\nimport type { AbstractCliAdapterInterface } from '../interfaces/abstract-cli-adapter.interface.mjs'\nimport type { CommandHandler } from '../interfaces/command-handler.interface.mjs'\nimport type { CliAdapterOptions } from '../interfaces/environment.interface.mjs'\nimport type { CommandEntryValue } from '../metadata/command-entry.metadata.mjs'\n\nimport { HelpCommand } from '../commands/help.command.mjs'\nimport { CommanderExecutionContext } from '../interfaces/commander-execution-context.interface.mjs'\nimport { CommandEntryKey } from '../metadata/command-entry.metadata.mjs'\nimport {\n extractCommandMetadata,\n hasCommandMetadata,\n} from '../metadata/index.mjs'\nimport { CommandExecutionContext } from '../tokens/index.mjs'\nimport { CliParserService } from './cli-parser.service.mjs'\nimport { CommandRegistryService } from './command-registry.service.mjs'\n\n/**\n * CLI adapter service that implements the AbstractCliAdapterInterface.\n * Handles command discovery, registration, parsing, and execution.\n *\n * @public\n */\n@Injectable()\nexport class CommanderAdapterService implements AbstractCliAdapterInterface {\n private container = inject(Container)\n private commandRegistry = inject(CommandRegistryService)\n private cliParser = inject(CliParserService)\n private logger = inject(Logger, { context: 'Commander' })\n\n private options: CliAdapterOptions = {}\n private isReady = false\n\n /**\n * Sets up the adapter with the provided options.\n * Called during application initialization.\n */\n async setupAdapter(options: CliAdapterOptions): Promise<void> {\n this.options = options ?? {}\n }\n\n /**\n * Called after all modules are loaded.\n * Iterates through modules and extracts commands from customEntries.\n */\n async onModulesInit(modules: Map<string, ModuleMetadata>): Promise<void> {\n // Register built-in help command\n this.registerBuiltInCommands()\n\n for (const [moduleName, metadata] of modules) {\n const commands = metadata.customEntries.get(CommandEntryKey) as\n | CommandEntryValue\n | undefined\n if (!commands) continue\n\n for (const commandClass of commands) {\n if (!hasCommandMetadata(commandClass)) {\n this.logger.warn(\n `Class ${commandClass.name} in module ${moduleName} ` +\n `is listed in commands but has no @Command decorator. Skipping.`,\n )\n continue\n }\n\n const commandMetadata = extractCommandMetadata(commandClass)\n this.commandRegistry.register(commandMetadata.path, {\n class: commandClass,\n metadata: commandMetadata,\n moduleName,\n })\n }\n }\n }\n\n /**\n * Registers built-in commands like help.\n */\n private registerBuiltInCommands(): void {\n const helpMetadata = extractCommandMetadata(HelpCommand)\n this.commandRegistry.register(helpMetadata.path, {\n class: HelpCommand,\n metadata: helpMetadata,\n moduleName: '@navios/commander',\n })\n }\n\n /**\n * Signals that the adapter is ready to handle commands.\n */\n async ready(): Promise<void> {\n this.isReady = true\n }\n\n /**\n * Disposes of the adapter and cleans up resources.\n */\n async dispose(): Promise<void> {\n this.commandRegistry.clear()\n this.isReady = false\n }\n\n /**\n * Run the CLI application with the given arguments.\n * Parses arguments and executes the matching command.\n */\n async run(argv: string[] = process.argv): Promise<void> {\n if (!this.isReady) {\n throw new Error('Adapter not ready. Call app.init() first.')\n }\n\n try {\n // Preliminary parse to find command\n const preliminaryParse = this.cliParser.parse(argv)\n\n // Handle --help or -h flags by showing help for the specific command\n if (preliminaryParse.options.help || preliminaryParse.options.h) {\n // If command is 'help', show general help\n // Otherwise show help for the specific command\n if (preliminaryParse.command === 'help') {\n await this.executeCommand('help', {})\n } else {\n await this.executeCommand('help', { command: preliminaryParse.command })\n }\n return\n }\n\n const command = this.commandRegistry.getByPath(preliminaryParse.command)\n\n // Re-parse with schema if available\n const parsed = command?.metadata.optionsSchema\n ? this.cliParser.parse(argv, command.metadata.optionsSchema)\n : preliminaryParse\n\n await this.executeCommand(parsed.command, parsed.options)\n } catch (error) {\n if (error instanceof Error) {\n this.logger.error(`Error: ${error.message}`)\n if (error.message.includes('Command not found')) {\n this.logger.log('')\n await this.executeCommand('help', {})\n }\n }\n throw error\n }\n }\n\n /**\n * Execute a command programmatically with the provided options.\n */\n async executeCommand(\n path: string,\n options: Record<string, unknown> = {},\n ): Promise<void> {\n const command = this.commandRegistry.getByPath(path)\n if (!command) {\n throw new Error(`[Navios Commander] Command not found: ${path}`)\n }\n\n const { class: commandClass, metadata } = command\n\n // Validate options\n let validatedOptions = options\n if (metadata.optionsSchema) {\n validatedOptions = metadata.optionsSchema.parse(options)\n }\n\n // Create execution context\n const executionContext = new CommanderExecutionContext(\n metadata,\n path,\n validatedOptions,\n )\n\n // Begin request scope\n const requestId = `cmd-${Date.now()}-${Math.random().toString(36).substring(7)}`\n const scopeContainer = this.container.beginRequest(requestId)\n scopeContainer.addInstance(CommandExecutionContext, executionContext)\n\n try {\n const commandInstance = await scopeContainer.get<CommandHandler>(\n commandClass as unknown as InjectionToken<CommandHandler>,\n )\n\n if (!commandInstance.execute) {\n throw new Error(`Command ${path} does not implement execute method`)\n }\n\n await commandInstance.execute(validatedOptions)\n } finally {\n await scopeContainer.endRequest()\n }\n }\n\n /**\n * Get all registered command paths and their class references.\n */\n getAllCommands(): Array<{ path: string; class: ClassType }> {\n return this.commandRegistry.getAllAsArray()\n }\n}\n","import type { AnyInjectableType, InjectionToken } from '@navios/core'\n\nimport { AdapterToken } from '@navios/core'\n\nimport { CommanderAdapterService } from './services/commander-adapter.service.mjs'\nimport { CommandRegistryService } from './services/command-registry.service.mjs'\nimport { CliParserService } from './services/cli-parser.service.mjs'\n\n/**\n * Defines the CLI environment configuration for use with NaviosFactory.\n *\n * This function returns the token mappings needed to configure a CLI application.\n * Use it with `NaviosFactory.create()` to create a CLI application.\n *\n * @returns Environment configuration with token mappings\n *\n * @example\n * ```typescript\n * import { NaviosFactory } from '@navios/core'\n * import { defineCliEnvironment, type CliEnvironment } from '@navios/commander'\n *\n * const app = await NaviosFactory.create<CliEnvironment>(AppModule, {\n * adapter: defineCliEnvironment(),\n * })\n * await app.init()\n *\n * const adapter = app.getAdapter() as AbstractCliAdapterInterface\n * await adapter.run(process.argv)\n * ```\n */\nexport function defineCliEnvironment() {\n const tokens = new Map<InjectionToken<any, undefined>, AnyInjectableType>([\n [AdapterToken, CommanderAdapterService],\n ])\n return { tokens }\n}\n\n// Re-export services for direct access if needed\nexport { CommanderAdapterService, CommandRegistryService, CliParserService }\n","import { ConsoleLogger, NaviosFactory } from '@navios/core'\n\nimport type { ClassTypeWithInstance, LogLevel, NaviosApplication, NaviosModule } from '@navios/core'\n\nimport { defineCliEnvironment } from './define-environment.mjs'\n\nimport type { CliEnvironment } from './interfaces/environment.interface.mjs'\n\n/**\n * Logger display options for CLI applications.\n * All options default to false for cleaner CLI output.\n *\n * @public\n */\nexport interface CommanderLoggerOptions {\n /**\n * Enabled log levels.\n * @default ['log', 'error', 'warn', 'debug', 'verbose', 'fatal']\n */\n logLevels?: LogLevel[]\n /**\n * If true, will print the process ID in the log message.\n * @default false\n */\n showPid?: boolean\n /**\n * If true, will print the log level in the log message.\n * @default true\n */\n showLogLevel?: boolean\n /**\n * If true, will print the prefix/app name in the log message.\n * @default false\n */\n showPrefix?: boolean\n /**\n * If true, will print the context in the log message.\n * @default true\n */\n showContext?: boolean\n /**\n * If true, will print the absolute timestamp in the log message.\n * @default false\n */\n showTimestamp?: boolean\n /**\n * If enabled, will print timestamp difference between current and previous log message.\n * @default false\n */\n showTimeDiff?: boolean\n}\n\n/**\n * TUI-specific options for terminal UI mode.\n * Only used when enableTUI is true.\n *\n * @public\n */\nexport interface CommanderTuiOptions {\n /**\n * Exit on Ctrl+C.\n * @default true\n */\n exitOnCtrlC?: boolean\n /**\n * Sidebar width in columns.\n */\n sidebarWidth?: number\n /**\n * Sidebar position.\n */\n sidebarPosition?: 'left' | 'right'\n /**\n * Sidebar header title.\n */\n sidebarTitle?: string\n /**\n * Auto close after all screens complete successfully.\n * Set to true for default delay (5000ms), or specify delay in milliseconds.\n */\n autoClose?: boolean | number\n /**\n * Theme preset name ('dark', 'light', 'high-contrast') or custom theme object.\n */\n theme?: string | Record<string, unknown>\n /**\n * Enable mouse support.\n * @default false\n */\n useMouse?: boolean\n /**\n * Hide the default console logger screen from the sidebar.\n * @default false\n */\n hideDefaultScreen?: boolean\n}\n\n/**\n * Configuration options for CommanderFactory.\n *\n * @public\n */\nexport interface CommanderFactoryOptions {\n /**\n * Enabled log levels.\n * @default ['log', 'error', 'warn', 'debug', 'verbose', 'fatal']\n */\n logLevels?: LogLevel[]\n /**\n * Logger display options. These override the default CLI-friendly logger settings.\n * Ignored when enableTUI is true.\n */\n logger?: CommanderLoggerOptions\n /**\n * Enable TUI mode with @navios/commander-tui.\n * Requires @navios/commander-tui to be installed.\n */\n enableTUI?: boolean\n /**\n * TUI-specific options. Only used when enableTUI is true.\n */\n tuiOptions?: CommanderTuiOptions\n}\n\n/**\n * Factory class for creating CLI applications.\n *\n * This is a convenience wrapper around `NaviosFactory.create()` that\n * configures everything needed for CLI usage. It sets up the CLI adapter\n * and returns a typed `NaviosApplication<CliEnvironment>`.\n *\n * @example\n * ```typescript\n * import { CommanderFactory } from '@navios/commander'\n * import { AppModule } from './app.module'\n *\n * async function bootstrap() {\n * const app = await CommanderFactory.create(AppModule)\n * await app.init()\n *\n * const adapter = app.getAdapter()\n * await adapter.run(process.argv)\n *\n * await app.close()\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Alternative: use NaviosFactory directly\n * import { NaviosFactory } from '@navios/core'\n * import { defineCliEnvironment, type CliEnvironment } from '@navios/commander'\n *\n * const app = await NaviosFactory.create<CliEnvironment>(AppModule, {\n * adapter: defineCliEnvironment(),\n * })\n * ```\n */\nexport class CommanderFactory {\n /**\n * Creates a new CLI application instance configured with the provided module.\n *\n * @param appModule - The root CLI module class decorated with `@CliModule`\n * @param options - Optional configuration options for the CLI application\n * @returns A promise that resolves to a configured NaviosApplication instance\n *\n * @example\n * ```typescript\n * const app = await CommanderFactory.create(AppModule)\n * await app.init()\n *\n * const adapter = app.getAdapter()\n * await adapter.run(process.argv)\n * ```\n */\n static async create<TModule extends NaviosModule = NaviosModule>(\n appModule: ClassTypeWithInstance<TModule>,\n options: CommanderFactoryOptions = {},\n ): Promise<NaviosApplication<CliEnvironment>> {\n if (options.enableTUI) {\n // Dynamic import to keep commander-tui as optional peer dependency\n let tuiModule: typeof import('@navios/commander-tui')\n try {\n tuiModule = await import('@navios/commander-tui')\n } catch {\n throw new Error(\n 'TUI mode requires @navios/commander-tui package. ' +\n 'Install it with: npm install @navios/commander-tui',\n )\n }\n\n const { overrideConsoleLogger, ScreenManager } = tuiModule\n\n // Override the ConsoleLogger service to use the ScreenLogger service instead of the default ConsoleLogger service.\n overrideConsoleLogger(options.tuiOptions?.hideDefaultScreen ?? false)\n\n if (options.tuiOptions?.hideDefaultScreen) {\n // Import the help command override to ensure it is registered\n await import('./overrides/help.command.mjs')\n }\n // Create app without custom logger - TUI override handles it\n const app = await NaviosFactory.create<CliEnvironment>(appModule, {\n adapter: defineCliEnvironment(),\n logger: options.logLevels,\n })\n\n // Get screen manager and bind TUI before returning\n const screenManager = await app.get(ScreenManager)\n await screenManager.bind({\n exitOnCtrlC: options.tuiOptions?.exitOnCtrlC,\n sidebarWidth: options.tuiOptions?.sidebarWidth,\n sidebarPosition: options.tuiOptions?.sidebarPosition,\n sidebarTitle: options.tuiOptions?.sidebarTitle,\n autoClose: options.tuiOptions?.autoClose,\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n theme: options.tuiOptions?.theme as any,\n useMouse: options.tuiOptions?.useMouse,\n })\n\n return app\n }\n\n // Standard (non-TUI) mode - existing behavior unchanged\n const app = await NaviosFactory.create<CliEnvironment>(appModule, {\n adapter: defineCliEnvironment(),\n logger: ConsoleLogger.create({\n logLevels: options.logger?.logLevels,\n showTimeDiff: options.logger?.showTimeDiff ?? false,\n showPid: options.logger?.showPid ?? false,\n showLogLevel: options.logger?.showLogLevel ?? true,\n showPrefix: options.logger?.showPrefix ?? false,\n showContext: options.logger?.showContext ?? true,\n showTimestamp: options.logger?.showTimestamp ?? false,\n }),\n })\n\n return app\n }\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.mjs","names":["inject","Logger","z","Command","CommandRegistryService","HelpCommandToken","helpOptionsSchema","object","command","string","optional","token","path","description","optionsSchema","HelpCommand","logger","context","commandRegistry","execute","options","log","formatCommandHelp","formatCommandList","CommanderExecutionContext","command","commandPath","options","getCommand","getCommandPath","getOptions","InjectionToken","CommandExecutionContextInjectionToken","CommandExecutionContext","create","Injectable","CliParserService","parse","argv","optionsSchema","args","slice","length","Error","booleanFields","extractBooleanFields","Set","arrayFields","extractArrayFields","commandParts","i","startsWith","push","command","join","options","positionals","arg","key","equalIndex","indexOf","optionName","optionValue","camelCaseKey","camelCase","isArray","has","parseValue","isBoolean","nextArg","flags","flag","str","replace","_","letter","toUpperCase","value","undefined","test","parseInt","parseFloat","endsWith","JSON","schema","typeName","def","type","shape","fieldSchema","Object","entries","isSchemaBoolean","add","isSchemaArray","currentSchema","innerType","Container","inject","Injectable","Logger","HelpCommand","CommanderExecutionContext","CommandEntryKey","extractCommandMetadata","hasCommandMetadata","CommandExecutionContext","CliParserService","CommandRegistryService","CommanderAdapterService","container","commandRegistry","cliParser","logger","context","options","isReady","setupAdapter","onModulesInit","modules","registerBuiltInCommands","moduleName","metadata","commands","customEntries","get","commandClass","warn","name","commandMetadata","register","path","class","helpMetadata","ready","dispose","clear","run","argv","process","Error","preliminaryParse","parse","help","h","command","executeCommand","getByPath","parsed","optionsSchema","error","message","includes","log","validatedOptions","executionContext","requestId","Date","now","Math","random","toString","substring","scopeContainer","beginRequest","addInstance","commandInstance","execute","endRequest","getAllCommands","getAllAsArray","AdapterToken","CommanderAdapterService","CommandRegistryService","CliParserService","defineCliEnvironment","tokens","Map","ConsoleLogger","NaviosFactory","defineCliEnvironment","CommanderFactory","create","appModule","options","enableTUI","tuiOptions","adapter","tuiModule","Error","overrideConsoleLogger","ScreenManager","hideDefaultScreen","app","logger","logLevels","screenManager","get","bind","exitOnCtrlC","sidebarWidth","sidebarPosition","sidebarTitle","autoClose","theme","useMouse","showTimeDiff","showPid","showLogLevel","showPrefix","showContext","showTimestamp"],"sources":["../src/commands/help.command.mts","../src/interfaces/commander-execution-context.interface.mts","../src/tokens/execution-context.token.mts","../src/services/cli-parser.service.mts","../src/services/commander-adapter.service.mts","../src/define-environment.mts","../src/commander.factory.mts"],"sourcesContent":["import { inject, Logger } from '@navios/core'\nimport { z } from 'zod'\n\nimport { Command } from '../decorators/command.decorator.mjs'\nimport { CommandRegistryService } from '../services/command-registry.service.mjs'\nimport { HelpCommandToken } from '../tokens/help-command.token.mjs'\n\nimport type { CommandHandler } from '../interfaces/command-handler.interface.mjs'\n\nconst helpOptionsSchema = z.object({\n command: z.string().optional(),\n})\n\ntype HelpOptions = z.infer<typeof helpOptionsSchema>\n\n/**\n * Built-in help command that lists all available commands or shows help for a specific command.\n *\n * @public\n */\n@Command({\n token: HelpCommandToken,\n path: 'help',\n description: 'Show available commands or help for a specific command',\n optionsSchema: helpOptionsSchema,\n})\nexport class HelpCommand implements CommandHandler<HelpOptions> {\n private logger = inject(Logger, { context: 'Commander' })\n private commandRegistry = inject(CommandRegistryService)\n\n async execute(options: HelpOptions): Promise<void> {\n if (options.command) {\n this.logger.log(this.commandRegistry.formatCommandHelp(options.command))\n } else {\n this.logger.log(this.commandRegistry.formatCommandList())\n }\n }\n}\n","import type { CommandMetadata } from '../metadata/command.metadata.mjs'\n\n/**\n * Execution context for a command execution.\n *\n * Provides access to command metadata, path, and validated options during command execution.\n * This context is automatically injected and available via the `CommandExecutionContext` token.\n *\n * @example\n * ```typescript\n * import { inject, Injectable } from '@navios/core'\n * import { CommandExecutionContext } from '@navios/commander'\n *\n * @Injectable()\n * class CommandLogger {\n * private ctx = inject(CommandExecutionContext)\n *\n * log() {\n * console.log('Command:', this.ctx.getCommandPath())\n * console.log('Options:', this.ctx.getOptions())\n * }\n * }\n * ```\n */\nexport class CommanderExecutionContext {\n /**\n * @internal\n * Creates a new execution context.\n */\n constructor(\n private readonly command: CommandMetadata,\n private readonly commandPath: string,\n private readonly options: any,\n ) {}\n\n /**\n * Gets the command metadata.\n *\n * @returns The command metadata including path and options schema\n */\n getCommand(): CommandMetadata {\n return this.command\n }\n\n /**\n * Gets the command path that was invoked.\n *\n * @returns The command path (e.g., 'greet', 'user:create')\n */\n getCommandPath(): string {\n return this.commandPath\n }\n\n /**\n * Gets the validated command options.\n *\n * Options are validated against the command's Zod schema if one was provided.\n *\n * @returns The validated options object\n */\n getOptions(): any {\n return this.options\n }\n}\n","import { InjectionToken } from '@navios/core'\n\nimport type { CommanderExecutionContext } from '../interfaces/index.mjs'\n\nconst CommandExecutionContextInjectionToken =\n 'CommanderExecutionContextInjectionToken'\n\n/**\n * Injection token for accessing the current command execution context.\n *\n * Use this token with `inject()` to access the `CommanderExecutionContext` in services\n * that need information about the currently executing command.\n *\n * @example\n * ```typescript\n * import { inject, Injectable } from '@navios/core'\n * import { CommandExecutionContext } from '@navios/commander'\n *\n * @Injectable()\n * class MyService {\n * private ctx = inject(CommandExecutionContext)\n *\n * doSomething() {\n * const commandPath = this.ctx.getCommandPath()\n * const options = this.ctx.getOptions()\n * // Use context information...\n * }\n * }\n * ```\n */\nexport const CommandExecutionContext =\n InjectionToken.create<CommanderExecutionContext>(\n CommandExecutionContextInjectionToken,\n )\n","import type { ZodObject, ZodType } from 'zod'\n\nimport { Injectable } from '@navios/core'\n\n/**\n * Result of parsing command-line arguments.\n *\n * @public\n */\nexport interface ParsedCliArgs {\n /**\n * The command path (e.g., 'greet', 'user:create').\n * Multi-word commands are joined with spaces.\n */\n command: string\n /**\n * Parsed options as key-value pairs.\n * Keys are converted from kebab-case to camelCase.\n */\n options: Record<string, any>\n /**\n * Positional arguments that don't match any option flags.\n */\n positionals: string[]\n}\n\n/**\n * Service for parsing command-line arguments.\n *\n * Handles parsing of various CLI argument formats including:\n * - Long options: `--key value` or `--key=value`\n * - Short options: `-k value` or `-abc` (multiple flags)\n * - Boolean flags\n * - Array options\n * - Positional arguments\n *\n * @public\n */\n@Injectable()\nexport class CliParserService {\n /**\n * Parses command-line arguments from process.argv\n * Commands can be multi-word (e.g., 'db migrate', 'cache clear')\n * Expected format: node script.js command [subcommand...] --flag value --boolean-flag positional1 positional2\n *\n * @param argv - Array of command-line arguments (typically process.argv)\n * @param optionsSchema - Optional Zod schema to determine boolean flags and option types\n * @returns Parsed command (space-separated if multi-word), options, and positional arguments\n */\n parse(argv: string[], optionsSchema?: ZodObject): ParsedCliArgs {\n // Skip first two args (node and script path)\n const args = argv.slice(2)\n\n if (args.length === 0) {\n throw new Error('[Navios Commander] No command provided')\n }\n\n // Extract boolean and array field names from schema for accurate parsing\n const booleanFields = optionsSchema\n ? this.extractBooleanFields(optionsSchema)\n : new Set<string>()\n const arrayFields = optionsSchema\n ? this.extractArrayFields(optionsSchema)\n : new Set<string>()\n\n // Collect command words until we hit an argument that starts with '-' or '--'\n const commandParts: string[] = []\n let i = 0\n while (i < args.length && !args[i].startsWith('-')) {\n commandParts.push(args[i])\n i++\n }\n\n if (commandParts.length === 0) {\n throw new Error('[Navios Commander] No command provided')\n }\n\n const command = commandParts.join(' ')\n const options: Record<string, any> = {}\n const positionals: string[] = []\n while (i < args.length) {\n const arg = args[i]\n\n if (arg.startsWith('--')) {\n // Long option format: --key=value or --key value\n const key = arg.slice(2)\n const equalIndex = key.indexOf('=')\n\n if (equalIndex !== -1) {\n // Format: --key=value\n const optionName = key.slice(0, equalIndex)\n const optionValue = key.slice(equalIndex + 1)\n const camelCaseKey = this.camelCase(optionName)\n const isArray =\n arrayFields.has(camelCaseKey) || arrayFields.has(optionName)\n\n if (isArray) {\n // For array fields, accumulate values\n if (!options[camelCaseKey]) {\n options[camelCaseKey] = []\n }\n options[camelCaseKey].push(this.parseValue(optionValue))\n } else {\n options[camelCaseKey] = this.parseValue(optionValue)\n }\n i++\n } else {\n // Format: --key value or --boolean-flag\n const camelCaseKey = this.camelCase(key)\n const isBoolean =\n booleanFields.has(camelCaseKey) || booleanFields.has(key)\n const isArray = arrayFields.has(camelCaseKey) || arrayFields.has(key)\n const nextArg = args[i + 1]\n\n if (isBoolean) {\n // Known boolean flag from schema\n options[camelCaseKey] = true\n i++\n } else if (isArray && nextArg && !nextArg.startsWith('-')) {\n // Known array field from schema - accumulate values\n if (!options[camelCaseKey]) {\n options[camelCaseKey] = []\n }\n options[camelCaseKey].push(this.parseValue(nextArg))\n i += 2\n } else if (nextArg && !nextArg.startsWith('-')) {\n // Has a value\n options[camelCaseKey] = this.parseValue(nextArg)\n i += 2\n } else {\n // Assume boolean flag\n options[camelCaseKey] = true\n i++\n }\n }\n } else if (arg.startsWith('-') && arg.length > 1 && arg !== '-') {\n // Short option format: -k value or -abc (multiple flags)\n const flags = arg.slice(1)\n\n if (flags.length === 1) {\n // Single short flag: -k value or -k\n const isBoolean = booleanFields.has(flags)\n const isArray = arrayFields.has(flags)\n const nextArg = args[i + 1]\n\n if (isBoolean) {\n // Known boolean flag from schema\n options[flags] = true\n i++\n } else if (isArray && nextArg && !nextArg.startsWith('-')) {\n // Known array field from schema - accumulate values\n if (!options[flags]) {\n options[flags] = []\n }\n options[flags].push(this.parseValue(nextArg))\n i += 2\n } else if (nextArg && !nextArg.startsWith('-')) {\n options[flags] = this.parseValue(nextArg)\n i += 2\n } else {\n options[flags] = true\n i++\n }\n } else {\n // Multiple short flags: -abc -> {a: true, b: true, c: true}\n for (const flag of flags) {\n options[flag] = true\n }\n i++\n }\n } else {\n // Positional argument\n positionals.push(arg)\n i++\n }\n }\n\n return {\n command,\n options,\n positionals,\n }\n }\n\n /**\n * Converts kebab-case to camelCase\n */\n private camelCase(str: string): string {\n return str.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase())\n }\n\n /**\n * Attempts to parse string values into appropriate types\n */\n private parseValue(value: string): any {\n // Check for boolean\n if (value === 'true') return true\n if (value === 'false') return false\n\n // Check for null/undefined\n if (value === 'null') return null\n if (value === 'undefined') return undefined\n\n // Check for number\n if (/^-?\\d+$/.test(value)) {\n return parseInt(value, 10)\n }\n if (/^-?\\d+\\.\\d+$/.test(value)) {\n return parseFloat(value)\n }\n\n // Check for JSON\n if (\n (value.startsWith('{') && value.endsWith('}')) ||\n (value.startsWith('[') && value.endsWith(']'))\n ) {\n try {\n return JSON.parse(value)\n } catch {\n // If parsing fails, return as string\n return value\n }\n }\n\n // Return as string\n return value\n }\n\n /**\n * Extracts boolean field names from a Zod schema\n * Handles ZodObject, ZodOptional, and ZodDefault wrappers\n */\n private extractBooleanFields(schema: ZodObject): Set<string> {\n const booleanFields = new Set<string>()\n\n try {\n // Check if schema has _def.typeName (Zod schema structure)\n const typeName = schema.def.type\n\n if (typeName === 'object') {\n // Extract shape from ZodObject\n const shape = schema.def.shape\n\n if (shape && typeof shape === 'object') {\n for (const [key, fieldSchema] of Object.entries(shape)) {\n if (this.isSchemaBoolean(fieldSchema as any)) {\n booleanFields.add(key)\n }\n }\n }\n }\n } catch {\n // Silently fail if schema introspection fails\n }\n\n return booleanFields\n }\n\n /**\n * Extracts array field names from a Zod schema\n * Handles ZodObject, ZodOptional, and ZodDefault wrappers\n */\n private extractArrayFields(schema: ZodObject): Set<string> {\n const arrayFields = new Set<string>()\n\n try {\n const typeName = schema.def.type\n\n if (typeName === 'object') {\n const shape = schema.def.shape\n\n if (shape && typeof shape === 'object') {\n for (const [key, fieldSchema] of Object.entries(shape)) {\n if (this.isSchemaArray(fieldSchema as any)) {\n arrayFields.add(key)\n }\n }\n }\n }\n } catch {\n // Silently fail if schema introspection fails\n }\n\n return arrayFields\n }\n\n /**\n * Checks if a Zod schema represents a boolean type\n * Unwraps ZodOptional and ZodDefault using Zod v4 API\n */\n private isSchemaBoolean(schema: ZodType): boolean {\n try {\n let currentSchema = schema\n let typeName = currentSchema.def.type\n\n // Unwrap ZodOptional and ZodDefault using Zod v4's def.innerType\n while (typeName === 'optional' || typeName === 'default') {\n currentSchema = (currentSchema as any)?.def?.innerType || currentSchema\n typeName = currentSchema.def.type\n }\n\n return typeName === 'boolean'\n } catch {\n return false\n }\n }\n\n /**\n * Checks if a Zod schema represents an array type\n * Unwraps ZodOptional and ZodDefault using Zod v4 API\n */\n private isSchemaArray(schema: ZodType): boolean {\n try {\n let currentSchema = schema\n let typeName = currentSchema.def.type\n\n // Unwrap ZodOptional and ZodDefault using Zod v4's def.innerType\n while (typeName === 'optional' || typeName === 'default') {\n currentSchema = (currentSchema as any)?.def?.innerType || currentSchema\n typeName = currentSchema.def.type\n }\n\n return typeName === 'array'\n } catch {\n return false\n }\n }\n}\n","import type { ClassType, ModuleMetadata } from '@navios/core'\n\nimport {\n Container,\n inject,\n Injectable,\n InjectionToken,\n Logger,\n} from '@navios/core'\n\nimport type { AbstractCliAdapterInterface } from '../interfaces/abstract-cli-adapter.interface.mjs'\nimport type { CommandHandler } from '../interfaces/command-handler.interface.mjs'\nimport type { CliAdapterOptions } from '../interfaces/environment.interface.mjs'\nimport type { CommandEntryValue } from '../metadata/command-entry.metadata.mjs'\n\nimport { HelpCommand } from '../commands/help.command.mjs'\nimport { CommanderExecutionContext } from '../interfaces/commander-execution-context.interface.mjs'\nimport { CommandEntryKey } from '../metadata/command-entry.metadata.mjs'\nimport {\n extractCommandMetadata,\n hasCommandMetadata,\n} from '../metadata/index.mjs'\nimport { CommandExecutionContext } from '../tokens/index.mjs'\nimport { CliParserService } from './cli-parser.service.mjs'\nimport { CommandRegistryService } from './command-registry.service.mjs'\n\n/**\n * CLI adapter service that implements the AbstractCliAdapterInterface.\n * Handles command discovery, registration, parsing, and execution.\n *\n * @public\n */\n@Injectable()\nexport class CommanderAdapterService implements AbstractCliAdapterInterface {\n private container = inject(Container)\n private commandRegistry = inject(CommandRegistryService)\n private cliParser = inject(CliParserService)\n private logger = inject(Logger, { context: 'Commander' })\n\n private options: CliAdapterOptions = {}\n private isReady = false\n\n /**\n * Sets up the adapter with the provided options.\n * Called during application initialization.\n */\n async setupAdapter(options: CliAdapterOptions): Promise<void> {\n this.options = options ?? {}\n }\n\n /**\n * Called after all modules are loaded.\n * Iterates through modules and extracts commands from customEntries.\n */\n async onModulesInit(modules: Map<string, ModuleMetadata>): Promise<void> {\n // Register built-in help command\n this.registerBuiltInCommands()\n\n for (const [moduleName, metadata] of modules) {\n const commands = metadata.customEntries.get(CommandEntryKey) as\n | CommandEntryValue\n | undefined\n if (!commands) continue\n\n for (const commandClass of commands) {\n if (!hasCommandMetadata(commandClass)) {\n this.logger.warn(\n `Class ${commandClass.name} in module ${moduleName} ` +\n `is listed in commands but has no @Command decorator. Skipping.`,\n )\n continue\n }\n\n const commandMetadata = extractCommandMetadata(commandClass)\n this.commandRegistry.register(commandMetadata.path, {\n class: commandClass,\n metadata: commandMetadata,\n moduleName,\n })\n }\n }\n }\n\n /**\n * Registers built-in commands like help.\n */\n private registerBuiltInCommands(): void {\n const helpMetadata = extractCommandMetadata(HelpCommand)\n this.commandRegistry.register(helpMetadata.path, {\n class: HelpCommand,\n metadata: helpMetadata,\n moduleName: '@navios/commander',\n })\n }\n\n /**\n * Signals that the adapter is ready to handle commands.\n */\n async ready(): Promise<void> {\n this.isReady = true\n }\n\n /**\n * Disposes of the adapter and cleans up resources.\n */\n async dispose(): Promise<void> {\n this.commandRegistry.clear()\n this.isReady = false\n }\n\n /**\n * Run the CLI application with the given arguments.\n * Parses arguments and executes the matching command.\n */\n async run(argv: string[] = process.argv): Promise<void> {\n if (!this.isReady) {\n throw new Error('Adapter not ready. Call app.init() first.')\n }\n\n try {\n // Preliminary parse to find command\n const preliminaryParse = this.cliParser.parse(argv)\n\n // Handle --help or -h flags by showing help for the specific command\n if (preliminaryParse.options.help || preliminaryParse.options.h) {\n // If command is 'help', show general help\n // Otherwise show help for the specific command\n if (preliminaryParse.command === 'help') {\n await this.executeCommand('help', {})\n } else {\n await this.executeCommand('help', { command: preliminaryParse.command })\n }\n return\n }\n\n const command = this.commandRegistry.getByPath(preliminaryParse.command)\n\n // Re-parse with schema if available\n const parsed = command?.metadata.optionsSchema\n ? this.cliParser.parse(argv, command.metadata.optionsSchema)\n : preliminaryParse\n\n await this.executeCommand(parsed.command, parsed.options)\n } catch (error) {\n if (error instanceof Error) {\n this.logger.error(`Error: ${error.message}`)\n if (error.message.includes('Command not found')) {\n this.logger.log('')\n await this.executeCommand('help', {})\n }\n }\n throw error\n }\n }\n\n /**\n * Execute a command programmatically with the provided options.\n */\n async executeCommand(\n path: string,\n options: Record<string, unknown> = {},\n ): Promise<void> {\n const command = this.commandRegistry.getByPath(path)\n if (!command) {\n throw new Error(`[Navios Commander] Command not found: ${path}`)\n }\n\n const { class: commandClass, metadata } = command\n\n // Validate options\n let validatedOptions = options\n if (metadata.optionsSchema) {\n validatedOptions = metadata.optionsSchema.parse(options)\n }\n\n // Create execution context\n const executionContext = new CommanderExecutionContext(\n metadata,\n path,\n validatedOptions,\n )\n\n // Begin request scope\n const requestId = `cmd-${Date.now()}-${Math.random().toString(36).substring(7)}`\n const scopeContainer = this.container.beginRequest(requestId)\n scopeContainer.addInstance(CommandExecutionContext, executionContext)\n\n try {\n const commandInstance = await scopeContainer.get<CommandHandler>(\n commandClass as unknown as InjectionToken<CommandHandler>,\n )\n\n if (!commandInstance.execute) {\n throw new Error(`Command ${path} does not implement execute method`)\n }\n\n await commandInstance.execute(validatedOptions)\n } finally {\n await scopeContainer.endRequest()\n }\n }\n\n /**\n * Get all registered command paths and their class references.\n */\n getAllCommands(): Array<{ path: string; class: ClassType }> {\n return this.commandRegistry.getAllAsArray()\n }\n}\n","import type { AnyInjectableType, InjectionToken } from '@navios/core'\n\nimport { AdapterToken } from '@navios/core'\n\nimport { CommanderAdapterService } from './services/commander-adapter.service.mjs'\nimport { CommandRegistryService } from './services/command-registry.service.mjs'\nimport { CliParserService } from './services/cli-parser.service.mjs'\n\n/**\n * Defines the CLI environment configuration for use with NaviosFactory.\n *\n * This function returns the token mappings needed to configure a CLI application.\n * Use it with `NaviosFactory.create()` to create a CLI application.\n *\n * @returns Environment configuration with token mappings\n *\n * @example\n * ```typescript\n * import { NaviosFactory } from '@navios/core'\n * import { defineCliEnvironment, type CliEnvironment } from '@navios/commander'\n *\n * const app = await NaviosFactory.create<CliEnvironment>(AppModule, {\n * adapter: defineCliEnvironment(),\n * })\n * await app.init()\n *\n * const adapter = app.getAdapter() as AbstractCliAdapterInterface\n * await adapter.run(process.argv)\n * ```\n */\nexport function defineCliEnvironment() {\n const tokens = new Map<InjectionToken<any, undefined>, AnyInjectableType>([\n [AdapterToken, CommanderAdapterService],\n ])\n return { tokens }\n}\n\n// Re-export services for direct access if needed\nexport { CommanderAdapterService, CommandRegistryService, CliParserService }\n","import { ConsoleLogger, NaviosFactory } from '@navios/core'\n\nimport type { ClassTypeWithInstance, LogLevel, NaviosApplication, NaviosModule } from '@navios/core'\n\nimport { defineCliEnvironment } from './define-environment.mjs'\n\nimport type { CliEnvironment } from './interfaces/environment.interface.mjs'\n\n/**\n * Logger display options for CLI applications.\n * All options default to false for cleaner CLI output.\n *\n * @public\n */\nexport interface CommanderLoggerOptions {\n /**\n * Enabled log levels.\n * @default ['log', 'error', 'warn', 'debug', 'verbose', 'fatal']\n */\n logLevels?: LogLevel[]\n /**\n * If true, will print the process ID in the log message.\n * @default false\n */\n showPid?: boolean\n /**\n * If true, will print the log level in the log message.\n * @default true\n */\n showLogLevel?: boolean\n /**\n * If true, will print the prefix/app name in the log message.\n * @default false\n */\n showPrefix?: boolean\n /**\n * If true, will print the context in the log message.\n * @default true\n */\n showContext?: boolean\n /**\n * If true, will print the absolute timestamp in the log message.\n * @default false\n */\n showTimestamp?: boolean\n /**\n * If enabled, will print timestamp difference between current and previous log message.\n * @default false\n */\n showTimeDiff?: boolean\n}\n\n/**\n * TUI-specific options for terminal UI mode.\n * Only used when enableTUI is true.\n *\n * @public\n */\nexport interface CommanderTuiOptions {\n /**\n * Exit on Ctrl+C.\n * @default true\n */\n exitOnCtrlC?: boolean\n /**\n * Adapter to use for the TUI.\n * @default 'react'\n */\n adapter?: 'react' | 'solid'\n /**\n * Sidebar width in columns.\n */\n sidebarWidth?: number\n /**\n * Sidebar position.\n */\n sidebarPosition?: 'left' | 'right'\n /**\n * Sidebar header title.\n */\n sidebarTitle?: string\n /**\n * Auto close after all screens complete successfully.\n * Set to true for default delay (5000ms), or specify delay in milliseconds.\n */\n autoClose?: boolean | number\n /**\n * Theme preset name ('dark', 'light', 'high-contrast') or custom theme object.\n */\n theme?: string | Record<string, unknown>\n /**\n * Enable mouse support.\n * @default false\n */\n useMouse?: boolean\n /**\n * Hide the default console logger screen from the sidebar.\n * @default false\n */\n hideDefaultScreen?: boolean\n}\n\n/**\n * Configuration options for CommanderFactory.\n *\n * @public\n */\nexport interface CommanderFactoryOptions {\n /**\n * Enabled log levels.\n * @default ['log', 'error', 'warn', 'debug', 'verbose', 'fatal']\n */\n logLevels?: LogLevel[]\n /**\n * Logger display options. These override the default CLI-friendly logger settings.\n * Ignored when enableTUI is true.\n */\n logger?: CommanderLoggerOptions\n /**\n * Enable TUI mode with @navios/commander-tui.\n * Requires @navios/commander-tui to be installed.\n */\n enableTUI?: boolean\n /**\n * TUI-specific options. Only used when enableTUI is true.\n */\n tuiOptions?: CommanderTuiOptions\n}\n\n/**\n * Factory class for creating CLI applications.\n *\n * This is a convenience wrapper around `NaviosFactory.create()` that\n * configures everything needed for CLI usage. It sets up the CLI adapter\n * and returns a typed `NaviosApplication<CliEnvironment>`.\n *\n * @example\n * ```typescript\n * import { CommanderFactory } from '@navios/commander'\n * import { AppModule } from './app.module'\n *\n * async function bootstrap() {\n * const app = await CommanderFactory.create(AppModule)\n * await app.init()\n *\n * const adapter = app.getAdapter()\n * await adapter.run(process.argv)\n *\n * await app.close()\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Alternative: use NaviosFactory directly\n * import { NaviosFactory } from '@navios/core'\n * import { defineCliEnvironment, type CliEnvironment } from '@navios/commander'\n *\n * const app = await NaviosFactory.create<CliEnvironment>(AppModule, {\n * adapter: defineCliEnvironment(),\n * })\n * ```\n */\nexport class CommanderFactory {\n /**\n * Creates a new CLI application instance configured with the provided module.\n *\n * @param appModule - The root CLI module class decorated with `@CliModule`\n * @param options - Optional configuration options for the CLI application\n * @returns A promise that resolves to a configured NaviosApplication instance\n *\n * @example\n * ```typescript\n * const app = await CommanderFactory.create(AppModule)\n * await app.init()\n *\n * const adapter = app.getAdapter()\n * await adapter.run(process.argv)\n * ```\n */\n static async create<TModule extends NaviosModule = NaviosModule>(\n appModule: ClassTypeWithInstance<TModule>,\n options: CommanderFactoryOptions = {},\n ): Promise<NaviosApplication<CliEnvironment>> {\n if (options.enableTUI) {\n if (options.tuiOptions?.adapter === 'solid') {\n await import('@navios/commander-tui/adapters/solid')\n } else {\n await import('@navios/commander-tui/adapters/react')\n }\n // Dynamic import to keep commander-tui as optional peer dependency\n let tuiModule: typeof import('@navios/commander-tui')\n try {\n tuiModule = await import('@navios/commander-tui')\n } catch {\n throw new Error(\n 'TUI mode requires @navios/commander-tui package. ' +\n 'Install it with: npm install @navios/commander-tui',\n )\n }\n\n const { overrideConsoleLogger, ScreenManager } = tuiModule\n\n // Override the ConsoleLogger service to use the ScreenLogger service instead of the default ConsoleLogger service.\n overrideConsoleLogger(options.tuiOptions?.hideDefaultScreen ?? false)\n\n if (options.tuiOptions?.hideDefaultScreen) {\n // Import the help command override to ensure it is registered\n await import('./overrides/help.command.mjs')\n }\n // Create app without custom logger - TUI override handles it\n const app = await NaviosFactory.create<CliEnvironment>(appModule, {\n adapter: defineCliEnvironment(),\n logger: options.logLevels,\n })\n\n // Get screen manager and bind TUI before returning\n const screenManager = await app.get(ScreenManager)\n await screenManager.bind({\n exitOnCtrlC: options.tuiOptions?.exitOnCtrlC,\n sidebarWidth: options.tuiOptions?.sidebarWidth,\n sidebarPosition: options.tuiOptions?.sidebarPosition,\n sidebarTitle: options.tuiOptions?.sidebarTitle,\n autoClose: options.tuiOptions?.autoClose,\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n theme: options.tuiOptions?.theme as any,\n useMouse: options.tuiOptions?.useMouse,\n })\n\n return app\n }\n\n // Standard (non-TUI) mode - existing behavior unchanged\n const app = await NaviosFactory.create<CliEnvironment>(appModule, {\n adapter: defineCliEnvironment(),\n logger: ConsoleLogger.create({\n logLevels: options.logger?.logLevels,\n showTimeDiff: options.logger?.showTimeDiff ?? false,\n showPid: options.logger?.showPid ?? false,\n showLogLevel: options.logger?.showLogLevel ?? true,\n showPrefix: options.logger?.showPrefix ?? false,\n showContext: options.logger?.showContext ?? true,\n showTimestamp: options.logger?.showTimestamp ?? false,\n }),\n })\n\n return app\n }\n}\n"],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -62,6 +62,11 @@ export interface CommanderTuiOptions {
|
|
|
62
62
|
* @default true
|
|
63
63
|
*/
|
|
64
64
|
exitOnCtrlC?: boolean
|
|
65
|
+
/**
|
|
66
|
+
* Adapter to use for the TUI.
|
|
67
|
+
* @default 'react'
|
|
68
|
+
*/
|
|
69
|
+
adapter?: 'react' | 'solid'
|
|
65
70
|
/**
|
|
66
71
|
* Sidebar width in columns.
|
|
67
72
|
*/
|
|
@@ -178,6 +183,11 @@ export class CommanderFactory {
|
|
|
178
183
|
options: CommanderFactoryOptions = {},
|
|
179
184
|
): Promise<NaviosApplication<CliEnvironment>> {
|
|
180
185
|
if (options.enableTUI) {
|
|
186
|
+
if (options.tuiOptions?.adapter === 'solid') {
|
|
187
|
+
await import('@navios/commander-tui/adapters/solid')
|
|
188
|
+
} else {
|
|
189
|
+
await import('@navios/commander-tui/adapters/react')
|
|
190
|
+
}
|
|
181
191
|
// Dynamic import to keep commander-tui as optional peer dependency
|
|
182
192
|
let tuiModule: typeof import('@navios/commander-tui')
|
|
183
193
|
try {
|