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

using Data.SeaHavenIndustries;

namespace SeaHaven.DataServices.Interfaces
{
    public record SiteOptionRow(int Id, string? Code, string? City, string? State);

    public interface ILocationDataService
    {
        Task<Locations?> GetByIdAsync(int id);
        Task<Locations?> GetByIdWithDetailsAsync(int id);
        Task<IEnumerable<Locations>> GetAllAsync();
        Task<IEnumerable<Locations>> GetByAccountIdAsync(int accountId);

        // Paged results returning DTOs
        Task<(IEnumerable<Locations> Items, int TotalCount)> GetPagedAsync(int page, int pageSize, string? search = null);

        // For addressbook endpoint - returns simplified DTO
        Task<(IEnumerable<object> Items, int TotalCount)> GetAddressbookPagedAsync(int page, int pageSize, string? search = null);

        Task<IReadOnlyList<SiteOptionRow>> GetSiteOptionsAsync(
            string? search = null,
            CancellationToken cancellationToken = default);

        /// <summary>
        /// Exists is false when the row is missing. AccountId is null when the site has no account.
        /// </summary>
        Task<(bool Exists, int? AccountId)> GetAccountScopeAsync(
            int locationId,
            CancellationToken cancellationToken = default);

        Task<Locations> AddAsync(Locations location);
        Task UpdateAsync(Locations location);
        Task DeleteAsync(int id);
        Task<bool> ExistsAsync(int id);
        Task<int> CountAsync();

        /// <summary>
        /// Sort keys are validated upstream; unknown or null keys fall back to the legacy code order.
        /// Sort options trail the token so existing call sites stay source-compatible.
        /// </summary>
        Task<(List<Locations> Items, int TotalCount)> GetListPagedAsync(int page, int pageSize, string? search, IReadOnlyCollection<string>? states, CancellationToken cancellationToken, string? sortBy = null, string? sortDirection = null);
        Task<Locations?> GetDetailByIdAsync(int id, CancellationToken cancellationToken);
        Task<Locations?> GetByIdForUpdateAsync(int id, CancellationToken cancellationToken);

        /// <summary>
        /// SH-138: single bounded read of active site contacts for a page of locations,
        /// ordered by SiteContactOrder then Id. Deleted contacts are excluded.
        /// </summary>
        Task<IReadOnlyList<Contacts>> GetSiteContactsByLocationIdsAsync(
            IReadOnlyCollection<int> locationIds,
            CancellationToken cancellationToken);

        Task<Locations> AddAsync(Locations location, CancellationToken cancellationToken);
        Task UpdateAsync(Locations location, CancellationToken cancellationToken);

        /// <summary>
        /// True when a live (not deleted) site of the same account already uses
        /// <paramref name="siteCode"/>, compared trimmed and case-insensitively.
        /// A null account matches only other sites without an account.
        /// </summary>
        Task<bool> SiteCodeExistsAsync(
            string siteCode,
            int? accountId,
            int? excludeLocationId,
            CancellationToken cancellationToken);

        /// <summary>
        /// Open (not Completed or Canceled, legacy status aware) and not deleted work
        /// orders that reference the site by id, or by site code when they carry no
        /// location id and no other account. <paramref name="callerAccountId"/>
        /// narrows to one account. Returns the full count and at most
        /// <paramref name="maxIds"/> ids, ascending.
        /// </summary>
        Task<(int Count, IReadOnlyList<int> Ids)> GetOpenWorkOrderIdsAsync(
            int locationId,
            string? siteCode,
            int? siteAccountId,
            int? callerAccountId,
            int maxIds,
            CancellationToken cancellationToken);
    }
}