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-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);

        // SH-198 vendor directory: per-technician rows UNION company-only rows
        // (companies with zero non-deleted technicians). Company-only rows carry a
        // null VendorId and a populated CompanyId. Notes come from VendorCompany.Notes.
        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);
        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);
    }
}