// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
 
namespace Microsoft.AspNetCore.Components.Forms.Mapping;
 
/// <summary>
/// A context that tracks information about mapping a single value from form data.
/// </summary>
public sealed class FormValueMappingContext
{
    private bool _resultSet;
 
    internal FormValueMappingContext(string acceptMappingScopeName, string? acceptFormName, Type valueType, string parameterName)
    {
        ArgumentNullException.ThrowIfNull(acceptMappingScopeName, nameof(acceptMappingScopeName));
        ArgumentNullException.ThrowIfNull(valueType, nameof(valueType));
        ArgumentNullException.ThrowIfNull(parameterName, nameof(parameterName));
 
        AcceptMappingScopeName = acceptMappingScopeName;
        AcceptFormName = acceptFormName;
        ParameterName = parameterName;
        ValueType = valueType;
    }
 
    /// <summary>
    /// Gets the name of <see cref="FormMappingScope"/> that is allowed to supply data in this context.
    /// </summary>
    public string AcceptMappingScopeName { get; }
 
    /// <summary>
    /// If set, indicates that the mapping should only receive values if the incoming form matches this name. If null, the mapping should receive data from any form in the mapping scope.
    /// </summary>
    public string? AcceptFormName { get; }
 
    /// <summary>
    /// Gets the name of the parameter to map data to.
    /// </summary>
    public string ParameterName { get; }
 
    /// <summary>
    /// Gets the <see cref="Type"/> of the value to map.
    /// </summary>
    public Type ValueType { get; }
 
    /// <summary>
    /// Gets the callback to invoke when an error occurs.
    /// </summary>
    public Action<string, FormattableString, string?>? OnError { get; set; }
 
    /// <summary>
    /// Maps a set of errors to a concrete containing instance.
    /// </summary>
    /// <remarks>
    /// For example, maps errors for a given property in a class to the class instance.
    /// This is required so that validation can work without the need of the full identifier.
    /// </remarks>
    public Action<string, object>? MapErrorToContainer { get; set; }
 
    /// <summary>
    /// Gets the result of the mapping operation.
    /// </summary>
    public object? Result { get; private set; }
 
    /// <summary>
    /// Sets the result of the mapping operation.
    /// </summary>
    /// <param name="result">The result of the mapping operation.</param>
    /// <exception cref="InvalidOperationException">Thrown if the result has already been set.</exception>
    public void SetResult(object? result)
    {
        if (_resultSet)
        {
            throw new InvalidOperationException($"The result has already been set to '{Result}'.");
        }
 
        _resultSet = true;
        Result = result;
    }
}