using System.Threading;
using System.Threading.Tasks;
using GB5Shared.DTO.Framework.Login;
using GB5Shared.QueryExecutor;

namespace GB5Shared.ScanIdentifier
{
    /// <summary>
    /// The one generic engine behind the Generate/Print/List facilities — pure logic over
    /// IQueryExecutor + AutoNumber + IScanTargetResolverDispatcher, with no entity-specific
    /// code of its own. Registered per-host the same way AutoNumber/IQueryExecutor already are;
    /// every host gets its own instance, all reading/writing the one shared MSCANIDENTIFIER table.
    /// </summary>
    public interface IScanIdentifierEngine
    {
        Task<GenerateScanIdentifierResultDTO> GenerateAsync(GenerateScanIdentifierRequestDTO request, LoginDTO login, CancellationToken ct);

        /// <summary>Effective MSCANTARGETCONFIG for an EntityType (tenant-aware, with sane defaults if unconfigured) — backs the Generate facility's Quantity-field enablement.</summary>
        Task<ScanTargetConfigDTO> GetEffectiveConfigAsync(string entityType, LoginDTO login, CancellationToken ct);

        Task<GeneratedScanIdentifierDTO?> GetByValueAsync(string identifierValue, LoginDTO login, CancellationToken ct);

        Task<PagedResult<GeneratedScanIdentifierDTO>> GetListPagedAsync(
            string entityType, int statusFilter, string searchTerm, System.DateTime generatedFrom,
            int page, int pageSize, LoginDTO login, CancellationToken ct);

        Task RetireAsync(int scanIdentifierId, LoginDTO login, CancellationToken ct);

        Task ReactivateAsync(int scanIdentifierId, LoginDTO login, CancellationToken ct);

        Task MarkPrintedAsync(int scanIdentifierId, LoginDTO login, CancellationToken ct);

        Task<IEnumerable<GcmPicklistDTO>> GetPrinterTypesAsync(LoginDTO login, CancellationToken ct);

        Task<IEnumerable<GcmPicklistDTO>> GetLabelTypesAsync(LoginDTO login, CancellationToken ct);

        /// <summary>Renders one PDF page per row (sized to the chosen label's real dimensions) and marks each row printed.</summary>
        Task<byte[]> PrintBatchAsync(PrintBatchRequestDTO request, LoginDTO login, CancellationToken ct);
    }
}