namespace AIRuntime.Runtime.Capabilities.Permissions
{
    /// <summary>
    /// Represents the result of a capability approval request.
    /// </summary>
    public sealed class CapabilityApprovalResult
    {
        /// <summary>
        /// Returns true when the capability may execute.
        /// </summary>
        public bool Approved
        {
            get;
        }


        /// <summary>
        /// Optional explanation for the approval decision.
        /// </summary>
        public string Reason
        {
            get;
        }


        private CapabilityApprovalResult(
            bool approved,
            string reason)
        {
            Approved =
                approved;


            Reason =
                reason ??
                string.Empty;
        }


        /// <summary>
        /// Creates an approved result.
        /// </summary>
        public static CapabilityApprovalResult Approve(
            string reason = null)
        {
            return new CapabilityApprovalResult(
                true,
                reason);
        }


        /// <summary>
        /// Creates a rejected result.
        /// </summary>
        public static CapabilityApprovalResult Reject(
            string reason = null)
        {
            return new CapabilityApprovalResult(
                false,
                reason);
        }
    }
}