using GB5Shared.DTO.Framework.Login;

namespace ECPBLL.Shared.Interfaces;

/// <summary>
/// The "Attach from DMS Library" picker in the Correspondence wizard's outward-compose step
/// (state.dmsLibrary in the ECP preview) — a flat list of standard, reusable files tagged by
/// owning module.
///
/// BLOCKED — two DMS entities checked, neither fits:
///   - DMSBLL.ESSDocument.IESSDocumentBLL: a personal "My Documents" concept scoped by
///     category/year/month (payroll/HR-style periodic documents), not a flat shared library.
///   - DMSBLL.Folder.IFolderBLL / DMSDAL.DTO.Folder.FolderDTO: manages folder *containers*
///     (SpaceFolderId/Name/Description/Permission) only — no method or table found for listing
///     the actual files inside a folder.
/// Needs either a real shared-document/file-library entity (if one exists elsewhere in DMS this
/// session didn't find) or a product decision on what "standard file from the library" should
/// mean in GB5.
/// </summary>
public interface IDMSLibraryBLL
{
    Task<string> GetSelectListDMSLibraryAsync(string? module, LoginDTO login, CancellationToken ct);
}