using System.CommandLine; using System.CommandLine.Parsing; using ZB.MOM.WW.ScadaBridge.Commons.Messages.Management; namespace ZB.MOM.WW.ScadaBridge.CLI.Commands; public static class ExternalSystemCommands { /// /// Builds the external-system CLI command group with subcommands for managing external systems. /// /// Global option for the management URL. /// Global option for the output format. /// Global option for the authentication username. /// Global option for the authentication password. /// The fully configured external-system with all subcommands registered. public static Command Build(Option urlOption, Option formatOption, Option usernameOption, Option passwordOption) { var command = new Command("external-system") { Description = "Manage external systems" }; command.Add(BuildList(urlOption, formatOption, usernameOption, passwordOption)); command.Add(BuildGet(urlOption, formatOption, usernameOption, passwordOption)); command.Add(BuildCreate(urlOption, formatOption, usernameOption, passwordOption)); command.Add(BuildUpdate(urlOption, formatOption, usernameOption, passwordOption)); command.Add(BuildDelete(urlOption, formatOption, usernameOption, passwordOption)); command.Add(BuildMethodGroup(urlOption, formatOption, usernameOption, passwordOption)); return command; } private static Command BuildGet(Option urlOption, Option formatOption, Option usernameOption, Option passwordOption) { var idOption = new Option("--id") { Description = "External system ID", Required = true }; var cmd = new Command("get") { Description = "Get an external system by ID" }; cmd.Add(idOption); cmd.SetAction(async (ParseResult result) => { var id = result.GetValue(idOption); return await CommandHelpers.ExecuteCommandAsync( result, urlOption, formatOption, usernameOption, passwordOption, new GetExternalSystemCommand(id)); }); return cmd; } private static Command BuildUpdate(Option urlOption, Option formatOption, Option usernameOption, Option passwordOption) { var idOption = new Option("--id") { Description = "External system ID", Required = true }; var nameOption = new Option("--name") { Description = "System name", Required = true }; var endpointUrlOption = new Option("--endpoint-url") { Description = "Endpoint URL", Required = true }; var authTypeOption = new Option("--auth-type") { Description = "Auth type", Required = true }; var authConfigOption = new Option("--auth-config") { Description = "Auth configuration JSON" }; var timeoutOption = new Option("--timeout-seconds") { Description = "Per-system HTTP timeout in seconds (0 = use gateway default); omit to preserve" }; var maxRetriesOption = new Option("--max-retries") { Description = "Store-and-forward retry budget for cached calls (0 = use engine default); omit to preserve" }; var retryDelayOption = new Option("--retry-delay-seconds") { Description = "Fixed interval between store-and-forward retries, in seconds (0 = use engine default); omit to preserve" }; retryDelayOption.Aliases.Add("--retry-delay"); var cmd = new Command("update") { Description = "Update an external system" }; cmd.Add(idOption); cmd.Add(nameOption); cmd.Add(endpointUrlOption); cmd.Add(authTypeOption); cmd.Add(authConfigOption); cmd.Add(timeoutOption); cmd.Add(maxRetriesOption); cmd.Add(retryDelayOption); cmd.SetAction(async (ParseResult result) => { var id = result.GetValue(idOption); var name = result.GetValue(nameOption)!; var endpointUrl = result.GetValue(endpointUrlOption)!; var authType = result.GetValue(authTypeOption)!; var authConfig = result.GetValue(authConfigOption); var timeoutSeconds = result.GetValue(timeoutOption); var maxRetries = result.GetValue(maxRetriesOption); var retryDelaySeconds = result.GetValue(retryDelayOption); return await CommandHelpers.ExecuteCommandAsync( result, urlOption, formatOption, usernameOption, passwordOption, new UpdateExternalSystemCommand(id, name, endpointUrl, authType, authConfig, timeoutSeconds, maxRetries, retryDelaySeconds is { } rd ? TimeSpan.FromSeconds(rd) : null)); }); return cmd; } private static Command BuildList(Option urlOption, Option formatOption, Option usernameOption, Option passwordOption) { var cmd = new Command("list") { Description = "List all external systems" }; cmd.SetAction(async (ParseResult result) => { return await CommandHelpers.ExecuteCommandAsync( result, urlOption, formatOption, usernameOption, passwordOption, new ListExternalSystemsCommand()); }); return cmd; } private static Command BuildCreate(Option urlOption, Option formatOption, Option usernameOption, Option passwordOption) { var nameOption = new Option("--name") { Description = "System name", Required = true }; var endpointUrlOption = new Option("--endpoint-url") { Description = "Endpoint URL", Required = true }; var authTypeOption = new Option("--auth-type") { Description = "Auth type (ApiKey, BasicAuth)", Required = true }; var authConfigOption = new Option("--auth-config") { Description = "Auth configuration JSON" }; var timeoutOption = new Option("--timeout-seconds") { Description = "Per-system HTTP timeout in seconds (0 = use gateway default)" }; var maxRetriesOption = new Option("--max-retries") { Description = "Store-and-forward retry budget for cached calls (0 = use engine default)" }; var retryDelayOption = new Option("--retry-delay-seconds") { Description = "Fixed interval between store-and-forward retries, in seconds (0 = use engine default)" }; retryDelayOption.Aliases.Add("--retry-delay"); var cmd = new Command("create") { Description = "Create an external system" }; cmd.Add(nameOption); cmd.Add(endpointUrlOption); cmd.Add(authTypeOption); cmd.Add(authConfigOption); cmd.Add(timeoutOption); cmd.Add(maxRetriesOption); cmd.Add(retryDelayOption); cmd.SetAction(async (ParseResult result) => { var name = result.GetValue(nameOption)!; var endpointUrl = result.GetValue(endpointUrlOption)!; var authType = result.GetValue(authTypeOption)!; var authConfig = result.GetValue(authConfigOption); var timeoutSeconds = result.GetValue(timeoutOption); var maxRetries = result.GetValue(maxRetriesOption); var retryDelaySeconds = result.GetValue(retryDelayOption); return await CommandHelpers.ExecuteCommandAsync( result, urlOption, formatOption, usernameOption, passwordOption, new CreateExternalSystemCommand(name, endpointUrl, authType, authConfig, timeoutSeconds, maxRetries, retryDelaySeconds is { } rd ? TimeSpan.FromSeconds(rd) : null)); }); return cmd; } private static Command BuildDelete(Option urlOption, Option formatOption, Option usernameOption, Option passwordOption) { var idOption = new Option("--id") { Description = "External system ID", Required = true }; var cmd = new Command("delete") { Description = "Delete an external system" }; cmd.Add(idOption); cmd.SetAction(async (ParseResult result) => { var id = result.GetValue(idOption); return await CommandHelpers.ExecuteCommandAsync( result, urlOption, formatOption, usernameOption, passwordOption, new DeleteExternalSystemCommand(id)); }); return cmd; } // -- Method subcommands -- private static Command BuildMethodGroup(Option urlOption, Option formatOption, Option usernameOption, Option passwordOption) { var group = new Command("method") { Description = "Manage external system methods" }; group.Add(BuildMethodList(urlOption, formatOption, usernameOption, passwordOption)); group.Add(BuildMethodGet(urlOption, formatOption, usernameOption, passwordOption)); group.Add(BuildMethodCreate(urlOption, formatOption, usernameOption, passwordOption)); group.Add(BuildMethodUpdate(urlOption, formatOption, usernameOption, passwordOption)); group.Add(BuildMethodDelete(urlOption, formatOption, usernameOption, passwordOption)); return group; } private static Command BuildMethodList(Option urlOption, Option formatOption, Option usernameOption, Option passwordOption) { var sysIdOption = new Option("--external-system-id") { Description = "External system ID", Required = true }; var cmd = new Command("list") { Description = "List methods for an external system" }; cmd.Add(sysIdOption); cmd.SetAction(async (ParseResult result) => { return await CommandHelpers.ExecuteCommandAsync( result, urlOption, formatOption, usernameOption, passwordOption, new ListExternalSystemMethodsCommand(result.GetValue(sysIdOption))); }); return cmd; } private static Command BuildMethodGet(Option urlOption, Option formatOption, Option usernameOption, Option passwordOption) { var idOption = new Option("--id") { Description = "Method ID", Required = true }; var cmd = new Command("get") { Description = "Get an external system method by ID" }; cmd.Add(idOption); cmd.SetAction(async (ParseResult result) => { return await CommandHelpers.ExecuteCommandAsync( result, urlOption, formatOption, usernameOption, passwordOption, new GetExternalSystemMethodCommand(result.GetValue(idOption))); }); return cmd; } private static Command BuildMethodCreate(Option urlOption, Option formatOption, Option usernameOption, Option passwordOption) { var sysIdOption = new Option("--external-system-id") { Description = "External system ID", Required = true }; var nameOption = new Option("--name") { Description = "Method name", Required = true }; var httpMethodOption = new Option("--http-method") { Description = "HTTP method (GET, POST, PUT, DELETE)", Required = true }; var pathOption = new Option("--path") { Description = "URL path (e.g. /api/Add)", Required = true }; var paramsOption = new Option("--params") { Description = "Parameter definitions JSON" }; var returnOption = new Option("--return") { Description = "Return definition JSON" }; var cmd = new Command("create") { Description = "Create an external system method" }; cmd.Add(sysIdOption); cmd.Add(nameOption); cmd.Add(httpMethodOption); cmd.Add(pathOption); cmd.Add(paramsOption); cmd.Add(returnOption); cmd.SetAction(async (ParseResult result) => { return await CommandHelpers.ExecuteCommandAsync( result, urlOption, formatOption, usernameOption, passwordOption, new CreateExternalSystemMethodCommand( result.GetValue(sysIdOption), result.GetValue(nameOption)!, result.GetValue(httpMethodOption)!, result.GetValue(pathOption)!, result.GetValue(paramsOption), result.GetValue(returnOption))); }); return cmd; } private static Command BuildMethodUpdate(Option urlOption, Option formatOption, Option usernameOption, Option passwordOption) { var idOption = new Option("--id") { Description = "Method ID", Required = true }; var nameOption = new Option("--name") { Description = "Method name" }; var httpMethodOption = new Option("--http-method") { Description = "HTTP method" }; var pathOption = new Option("--path") { Description = "URL path" }; var paramsOption = new Option("--params") { Description = "Parameter definitions JSON" }; var returnOption = new Option("--return") { Description = "Return definition JSON" }; var cmd = new Command("update") { Description = "Update an external system method" }; cmd.Add(idOption); cmd.Add(nameOption); cmd.Add(httpMethodOption); cmd.Add(pathOption); cmd.Add(paramsOption); cmd.Add(returnOption); cmd.SetAction(async (ParseResult result) => { return await CommandHelpers.ExecuteCommandAsync( result, urlOption, formatOption, usernameOption, passwordOption, new UpdateExternalSystemMethodCommand( result.GetValue(idOption), result.GetValue(nameOption), result.GetValue(httpMethodOption), result.GetValue(pathOption), result.GetValue(paramsOption), result.GetValue(returnOption))); }); return cmd; } private static Command BuildMethodDelete(Option urlOption, Option formatOption, Option usernameOption, Option passwordOption) { var idOption = new Option("--id") { Description = "Method ID", Required = true }; var cmd = new Command("delete") { Description = "Delete an external system method" }; cmd.Add(idOption); cmd.SetAction(async (ParseResult result) => { return await CommandHelpers.ExecuteCommandAsync( result, urlOption, formatOption, usernameOption, passwordOption, new DeleteExternalSystemMethodCommand(result.GetValue(idOption))); }); return cmd; } }