using GB5Shared.DTO.Framework.Criteria;
using GB5Shared.DTO.Framework.Login;
using MMDAL.DTO.TransactionType;
using System.Threading.Tasks;

namespace MMBLL.TransactionType
{
    /// <summary>
    /// Business Logic Layer interface for managing TransactionType operations.
    /// Provides methods to retrieve, insert/update, list, and delete transaction types with business rules applied.
    /// </summary>
    public interface ITransactionTypeBLL
    {
        /// <summary>
        /// Retrieves the details of a single transaction type by its unique identifier.
        /// </summary>
        /// <param name="TransactionTypeId">The unique identifier of the transaction type.</param>
        /// <param name="LoginDTO">The current user's login details.</param>
        /// <returns>A JSON string representing the transaction type details.</returns>
        Task<string> GetTransactionType(int TransactionTypeId, LoginDTO LoginDTO);

        /// <summary>
        /// Inserts a new transaction type or updates an existing one.
        /// Automatically applies any business rules, such as setting Created/Modified fields.
        /// </summary>
        /// <param name="TransactionTypeDTO">The transaction type data to save or update.</param>
        /// <param name="LoginDTO">The current user's login details.</param>
        /// <returns>A JSON string indicating the success of the operation, optionally with the TransactionTypeId.</returns>
        Task<string> SaveTransactionType(TransactionTypeDTO TransactionTypeDTO, LoginDTO LoginDTO);

        /// <summary>
        /// Retrieves a list of transaction types based on specified criteria.
        /// Typically used to populate dropdowns or selection lists in the UI.
        /// </summary>
        /// <param name="CriteriaDTO">Filter criteria for selecting transaction types.</param>
        /// <param name="LoginDTO">The current user's login details.</param>
        /// <returns>A JSON string representing a list of transaction types.</returns>
        Task<string> GetSelectListTransactionType(CriteriaDTO CriteriaDTO, LoginDTO LoginDTO);

        /// <summary>
        /// Deletes a transaction type by its unique identifier.
        /// </summary>
        /// <param name="TransactionTypeId">The unique identifier of the transaction type to delete.</param>
        /// <param name="LoginDTO">The current user's login details.</param>
        /// <returns>A JSON string indicating success or failure of the delete operation.</returns>
        Task<string> DeleteTransactionType(int TransactionTypeId, LoginDTO LoginDTO);
    }
}