shoc-backend/SeaHaven.Services/Interfaces/IVendorService.cs

using SeaHaven.Services.DTOs;

namespace SeaHaven.Services.Interfaces
{
    public interface IVendorService
    {
        Task<VendorDTO?> GetVendorByIdAsync(int id);
        Task<VendorDTO?> GetVendorByIdWithDetailsAsync(int id);
        Task<IEnumerable<VendorDTO>> GetAllVendorsAsync();
        Task<PagedResult<VendorDTO>> GetVendorsPagedAsync(
            int page,
            int pageSize,
            string? search = null,
            bool? isActive = true,
            IReadOnlyCollection<string>? companies = null,
            IReadOnlyCollection<string>? trades = null,
            IReadOnlyCollection<string>? locations = null,
            IReadOnlyCollection<string>? jobBuckets = null);

        // SH-198 legacy vendor directory contract backing GetVendorList: one row per
        // technician (per-technician rows UNION company-only rows), raw pagination.
        Task<PagedResult<VendorDirectoryItemDTO>> GetVendorTechnicianDirectoryPagedAsync(
            int page,
            int pageSize,
            string? search = null,
            bool? isActive = true,
            IReadOnlyCollection<string>? companies = null,
            IReadOnlyCollection<string>? trades = null,
            IReadOnlyCollection<string>? locations = null,
            IReadOnlyCollection<string>? jobBuckets = null,
            CancellationToken cancellationToken = default);

        // SH-281 company directory backing GetVendorDirectoryList: company-grouped
        // rows with nested technicians and bounded page sizes.
        Task<PagedResult<VendorDirectoryItemDTO>> GetVendorCompanyDirectoryPagedAsync(
            int page,
            int pageSize,
            string? search = null,
            bool? isActive = true,
            IReadOnlyCollection<string>? companies = null,
            IReadOnlyCollection<string>? trades = null,
            IReadOnlyCollection<string>? locations = null,
            IReadOnlyCollection<string>? jobBuckets = null,
            CancellationToken cancellationToken = default);
        Task<VendorDTO> CreateVendorAsync(CreateVendorDTO dto, string userId);
        Task<VendorDTO> UpdateVendorAsync(int id, UpdateVendorDTO dto, string userId);
        Task DeleteVendorAsync(int id, string userId, bool confirmOpenWorkOrders);
        Task<bool> VendorExistsAsync(int id);
        Task<int> GetTotalVendorCountAsync();
        Task<VendorDeactivationImpactDTO> GetDeactivationImpactAsync(int vendorId);
        Task<VendorDTO> UpdateVendorFromWorkOrderAsync(int vendorId, WorkOrderVendorUpdateDTO dto, string userId);
        Task<IEnumerable<VendorDropdownItemDTO>> GetDropdownAsync(string? trade, string? siteZip, CancellationToken cancellationToken);
        Task<VendorFacetsDTO> GetFacetsAsync(bool? isActive, CancellationToken cancellationToken);
        Task<VendorPortalTokenDTO?> GetPortalTokenAsync(int vendorId, CancellationToken cancellationToken);
        Task<VendorPortalTokenDTO?> RotatePortalTokenAsync(int vendorId, CancellationToken cancellationToken);
        Task<bool> RevokePortalTokenAsync(int vendorId, CancellationToken cancellationToken);
    }
}