using GB5Shared.DTO.Framework.Criteria;
using GB5Shared.DTO.Framework.Login;
using SwDAL.DTO.UpgradePackage;

namespace SwBLL.UpgradePackage;

public interface IUpgradePackageBLL
{
    Task<UpgradePackageDTO?>                 GetById(int packageId, LoginDTO loginDTO, CancellationToken ct);
    Task<IEnumerable<UpgradePackageDdlDTO>>  GetDdlLines(int packageId, LoginDTO loginDTO, CancellationToken ct);
    Task<IEnumerable<UpgradePackageMetaDTO>> GetMetaLines(int packageId, LoginDTO loginDTO, CancellationToken ct);
    Task<string>                             GetList(CriteriaDTO criteria, string? searchText, int pageOffset, int pageSize,
                                                     LoginDTO loginDTO, CancellationToken ct = default);
    Task<string>                             GetSelectListUpgradePackage(int firstNumber, int maxResult,
                                                                         CriteriaDTO criteriaDTO, LoginDTO loginDTO);

    /// <summary>Resolves one DbModel's real provisioning chain — every Released Universal
    /// package plus any Released overlay package matching the given scope filter, always
    /// collapsed to the latest (non-superseded) version per chain, ordered by ScopeType then
    /// SequenceInChain. `scope` may be null (or any/all of its fields null) — only Universal
    /// packages resolve in that case.</summary>
    Task<IEnumerable<PackageChainItemDTO>> GetProvisioningChain(
        int dbModelId, PackageScopeFilterDTO? scope, LoginDTO loginDTO, CancellationToken ct);

    /// <summary>Whole-DbModel package lineage (PackageId/PackageCode/ReleaseVersion/
    /// SupersedesPackageId), unfiltered by STATUS/PKGSTATUS/scope — used by
    /// ProvisioningBLL.GetCurrentVersion to walk SupersedesPackageId back to the nearest
    /// package carrying a ReleaseVersion.</summary>
    Task<IEnumerable<LineageNodeDTO>> GetLineage(int dbModelId, LoginDTO loginDTO, CancellationToken ct);

    Task<string> Save(UpgradePackageDTO dto, LoginDTO loginDTO, CancellationToken ct);
    Task<string> Delete(int packageId, LoginDTO loginDTO, CancellationToken ct);

    // Attach/detach a single DdlScript — the only previously-missing wiring;
    // ReplaceDdlLines/GetDdlLines themselves already existed at the DAL layer.
    Task<string> AttachDdlScript(AttachDdlScriptRequestDTO req, LoginDTO loginDTO, CancellationToken ct);
    Task<string> DetachDdlScript(DetachDdlScriptRequestDTO req, LoginDTO loginDTO, CancellationToken ct);
}