namespace ZB.MOM.WW.ScadaBridge.Commons.Messages.Management;

public record ListApiMethodsCommand;
public record GetApiMethodCommand(int ApiMethodId);
/// <param name="TraceAllCalls">Flow Debugger (design 2026-09-05 §5.2): trace every production call to this method. Additive; defaults to off.</param>
public record CreateApiMethodCommand(string Name, string Script, int TimeoutSeconds, string? ParameterDefinitions, string? ReturnDefinition, bool TraceAllCalls = false);
/// <param name="TraceAllCalls">Flow Debugger (design 2026-09-05 §5.2): <c>null</c> leaves the stored value unchanged so an older CLI never resets it.</param>
public record UpdateApiMethodCommand(int ApiMethodId, string Script, int TimeoutSeconds, string? ParameterDefinitions, string? ReturnDefinition, bool? TraceAllCalls = null);
public record DeleteApiMethodCommand(int ApiMethodId);
/// <summary>
/// Compiles the method's stored script on the receiving central node and returns the
/// diagnostics, without registering the handler or touching the known-bad cache
/// (ScadaBridge#75). Operators see the real compile error here; the data plane keeps
/// returning its generic message.
/// </summary>
/// <param name="ApiMethodId">The API method to validate.</param>
public record ValidateApiMethodCommand(int ApiMethodId);
/// <summary>
/// Re-runs <c>CompileAndRegister</c> for the method's stored script on the receiving central
/// node, replacing its cached handler or known-bad record, without re-sending the entity
/// (ScadaBridge#75). Returns the diagnostics.
/// </summary>
/// <param name="ApiMethodId">The API method to recompile.</param>
public record RecompileApiMethodCommand(int ApiMethodId);