using GB5Shared.DTO.Framework.Login;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace CostingDAL.CustomCode.VnoGeneration
{
    /// <summary>
    /// GB5 VNO (Voucher Number) Generation Service Interface.
    /// Migrated from GB4 IVnoGenerationDLL.
    /// 
    /// Three operations:
    ///   GetNextVno        — single VNO, auto-commits if no transaction passed.
    ///   GetNextVnoInTx    — single VNO, always within an existing transaction (GB4: GetNextVnoWithSameSession).
    ///   GetMultiVno       — N VNOs in one DB round-trip, always within a transaction.
    /// </summary>
    public interface IVnoGenerationService
    {
        /// <summary>
        /// Generate the next VNO for the given BizTransactionType and document date.
        /// Must be called inside an existing open transaction (same as GB4 GetNextVnoWithSameSession).
        /// </summary>
        Task<string> GetNextVnoAsync(
            int bizTransactionTypeId,
            DateTime vdate,
            LoginDTO login,
            System.Data.Common.DbTransaction tx,
            CancellationToken ct = default);

        /// <summary>
        /// Generate N sequential VNOs in one DB round-trip.
        /// Returns formatted strings in ascending order.
        /// Must be called inside an existing open transaction.
        /// </summary>
        Task<List<string>> GetMultiVnoAsync(
            int count,
            int bizTransactionTypeId,
            DateTime vdate,
            LoginDTO login,
            System.Data.Common.DbTransaction tx,
            CancellationToken ct = default);
    }
}