using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;
using GB5Shared.DTO.Framework.Criteria;
using GB5Shared.DTO.Framework.Login;
using GB5Shared.DTO.GOP;

namespace FrameworkBLL.GOP
{
    public interface IMappingBLL
    {
        // ── Definition ────────────────────────────────────────────────────────────

        Task<string> SaveMappingDefinition(MappingDefinitionDTO dto, LoginDTO loginDTO, CancellationToken ct = default);
        Task<MappingDefinitionDTO?> GetMappingDefinitionById(int mappingDefinitionId, LoginDTO loginDTO, CancellationToken ct = default);
        Task<IReadOnlyList<MappingDefinitionDTO>> GetMappingDefinitionList(LoginDTO loginDTO, CancellationToken ct = default);
        Task<IReadOnlyList<MappingDefinitionDTO>> GetSelectListMapping(CriteriaDTO criteriaDTO, LoginDTO loginDTO, CancellationToken ct = default);
        Task<string> DeleteMappingDefinition(int mappingDefinitionId, LoginDTO loginDTO, CancellationToken ct = default);

        // ── Version ───────────────────────────────────────────────────────────────

        Task<string> SaveMappingVersion(MappingVersionDTO dto, LoginDTO loginDTO, CancellationToken ct = default);
        Task<string> ActivateMappingVersion(int mappingVersionId, int mappingDefinitionId, LoginDTO loginDTO, CancellationToken ct = default);
        Task<MappingVersionDTO?> GetActiveVersionByDefinition(int mappingDefinitionId, LoginDTO loginDTO, CancellationToken ct = default);
        Task<IReadOnlyList<MappingVersionDTO>> GetVersionsByDefinition(int mappingDefinitionId, LoginDTO loginDTO, CancellationToken ct = default);
        Task<string> DeleteMappingVersion(int mappingVersionId, LoginDTO loginDTO, CancellationToken ct = default);

        // ── Node ──────────────────────────────────────────────────────────────────

        Task<string> SaveMappingNode(MappingNodeDTO dto, LoginDTO loginDTO, CancellationToken ct = default);
        Task<IReadOnlyList<MappingNodeDTO>> GetNodesByVersion(int mappingVersionId, LoginDTO loginDTO, CancellationToken ct = default);
        Task<string> DeleteMappingNode(int mappingNodeId, LoginDTO loginDTO, CancellationToken ct = default);

        // ── Test transform (Mapping Wizard, Step 4) ─────────────────────────────────
        // Thin passthrough to IMappingEngineBLL.TransformAsync's code-based overload —
        // lets the wizard preview a mapper's before/after JSON ad hoc, without a real
        // GOP Flow execution. No FactBag: [FactBag] source paths resolve to empty string
        // (matches TransformAsync's own documented behavior for that case).
        Task<string> TestMappingTransform(string mapperCode, string samplePayloadJson, LoginDTO loginDTO, CancellationToken ct = default);
    }
}