Code/SboxSuperuser/Api/AdminCommandRequest.cs
A small input contract for admin commands triggered from an admin view. Validates the command key through ContractGuard and bounds the argument list to 16 printable values of up to 256 characters, then converts to a CommandRequest with a request id.
using SboxSuperuser.Core.Contracts;
namespace SboxSuperuser;
/// <summary>A registered command run from an admin view; the host authorizes, audits and executes it like console input.</summary>
public sealed class AdminCommandRequest
{
private const int MaximumArguments = 16;
private const int MaximumArgumentLength = 256;
/// <summary>Gets the exact command key, such as "warn" or "group.permission.allow".</summary>
public string Command { get; }
/// <summary>Gets the ordered argument values, matching the command's argument descriptors.</summary>
public IReadOnlyList<string> Arguments { get; }
/// <summary>Creates bounded input; parsing, permission and target checks stay on the host.</summary>
public AdminCommandRequest( string command, IEnumerable<string> arguments = null )
{
Command = ContractGuard.Key( command, nameof( command ) );
var values = (arguments ?? Array.Empty<string>()).ToArray();
if ( values.Length > MaximumArguments
|| values.Any( value => value is null || value.Length > MaximumArgumentLength || value.Any( char.IsControl ) ) )
{
throw new ArgumentException( $"At most {MaximumArguments} printable arguments of up to {MaximumArgumentLength} characters.", nameof( arguments ) );
}
Arguments = Array.AsReadOnly( values );
}
internal CommandRequest ToCommand( Guid requestId ) => new( Command, Arguments, requestId );
}