shoc-backend/SeaHaven.DataServices/Interfaces/IVendorDataService.cs

using Data.SeaHavenIndustries;
using SeaHaven.DataServices.Models;

namespace SeaHaven.DataServices.Interfaces
{
    public interface IVendorDataService
    {
        Task<Vendor?> GetByIdAsync(int id);
        Task<Vendor?> GetByIdWithDetailsAsync(int id);

        // Batched lookup: one query for the distinct requested ids, preserving input order
        // and skipping any ids that are not present (no rows returned for missing ids).
        Task<IReadOnlyList<Vendor>> GetByIdsOrderedAsync(IReadOnlyCollection<int> ids, CancellationToken cancellationToken);
        Task<IEnumerable<Vendor>> GetAllAsync();
        Task<IReadOnlyList<Vendor>> GetActiveVendorsAsync(CancellationToken cancellationToken);

        // SH-249: canonical trade vocabulary (server-owned reference data) for
        // vendor facets. Active trades ordered by SortOrder then Name; independent
        // of technician Vendor.TradeSpecialties free text.
        Task<IReadOnlyList<Trade>> GetActiveTradesAsync(CancellationToken cancellationToken);

        // SH-278: active (non-archived) Area catalogue rows for vendor facets and for
        // resolving areas[n] filter ids. Archived Areas are excluded.
        Task<IReadOnlyList<Area>> GetActiveAreasAsync(CancellationToken cancellationToken);

        // SH-198 facet fix: company-owned facet profiles sourced from VendorCompanies,
        // with status semantics aligned to BuildDirectoryUnionQuery. Null returns all
        // companies; active includes companies with zero non-deleted technicians or at
        // least one active non-deleted technician; inactive includes companies with at
        // least one inactive non-deleted technician.
        Task<IReadOnlyList<VendorCompany>> GetCompaniesForFacetsAsync(bool? isActive, CancellationToken cancellationToken);
        Task<(IEnumerable<Vendor> Items, int TotalCount)> GetPagedAsync(
            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);

        // Compatibility path for existing per-technician consumers (GetVendorList)
        // and behavior tests. GetVendorDirectoryList uses the company-grouped path
        // below.
        Task<(IReadOnlyList<VendorDirectoryRow> Items, int TotalCount)> GetDirectoryPagedAsync(
            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: linked vendors group by real CompanyId; unlinked
        // legacy vendors group by trimmed case-insensitive CompanyName (missing names
        // isolated by vendor identity); company-only groups remain. Facet filters
        // select a group when any status-eligible row matches; job buckets apply to
        // the summed per-technician TotalJobs. Bounded group keys are selected and
        // paginated in SQL, then the full status-eligible roster is fetched only for
        // those keys (search/trade/location are not reapplied). TotalCount counts
        // company groups.
        Task<(IReadOnlyList<VendorCompanyGroup> Items, int TotalCount)> GetCompanyDirectoryPagedAsync(
            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,
            VendorAreaFilter? areaFilter = null,
            CancellationToken cancellationToken = default);
        Task<Vendor> AddAsync(Vendor vendor);
        Task UpdateAsync(Vendor vendor);
        Task DeleteAsync(int id);
        Task<bool> ExistsAsync(int id);
        Task<VendorAccessToken?> GetActiveTokenForVendorAsync(int vendorId, CancellationToken cancellationToken);
        Task<VendorAccessToken?> GetTokenWithVendorAsync(string token, CancellationToken cancellationToken);
        Task<VendorAccessToken> AddTokenAsync(VendorAccessToken token, CancellationToken cancellationToken);
        Task<IReadOnlyList<VendorAccessToken>> GetRevocableTokensAsync(int vendorId, CancellationToken cancellationToken);
        Task SaveChangesAsync(CancellationToken cancellationToken);
        Task<int> CountAsync();

        Task<VendorCompany?> GetCompanyByIdAsync(int id);
        Task<VendorCompany?> GetCompanyByNormalizedNameAsync(string normalizedName);
        Task<VendorCompany> AddCompanyAsync(VendorCompany company);
        Task UpdateCompanyAsync(VendorCompany company);
        Task<List<LinkedWorkOrderInfo>> GetLinkedWorkOrdersAsync(int vendorId);
        Task<bool> IsVendorAssignedToWorkOrderAsync(int vendorId, int workOrderId);
        Task UpdateWithAuditLogsAsync(Vendor vendor, IReadOnlyCollection<VendorAuditLog> auditLogs);
    }
}