using Distribution.Models;

namespace Distribution.Features.Stock;

public interface IStockRepository
{
    // Balance
    Task<StockBalance?> GetBalanceAsync(Guid itemId, Guid locationId);
    Task<StockBalance?> GetBalanceAsync(Guid itemId, Guid locationId, Guid? itemBatchId, Guid? itemSerialNumberId);
    /// <summary>Positive balances for the item at the location in pick order: batches by earliest expiry, serials oldest first, untracked last.</summary>
    Task<List<StockBalance>> GetAllocatableBalancesAsync(Guid itemId, Guid locationId);
    Task<List<StockBalance>> GetBalancesByLocationAsync(Guid locationId, LocationType locationType);
    Task<List<StockBalance>> GetBalancesAsync(Guid? locationId, LocationType? locationType, Guid? itemId, int page, int pageSize);
    Task<int> GetBalancesCountAsync(Guid? locationId, LocationType? locationType, Guid? itemId);
    Task<List<StockBalance>> GetBalancesByItemAsync(Guid itemId);
    Task<List<StockBalance>> GetLowStockAsync(Guid? locationId);
    Task AddBalanceAsync(StockBalance balance);
    void UpdateBalance(StockBalance balance);

    // Movements
    Task AddMovementAsync(StockMovement movement);
    Task<StockMovement?> GetMovementByIdAsync(Guid id);
    void UpdateMovement(StockMovement movement);
    Task<List<StockMovement>> GetMovementsAsync(MovementFilter filter, int page, int pageSize);
    Task<int> GetMovementsCountAsync(MovementFilter filter);
    /// <summary>Opening balance, quantity in/out within [from, toExclusive), closing balance, and the live balance to reconcile against.</summary>
    Task<MovementSummary> GetMovementSummaryAsync(Guid itemId, Guid locationId, DateTime from, DateTime toExclusive);

    Task<List<StockMovement>> GetMovementsByReferenceAsync(Guid referenceId, Guid itemId, MovementType type);
    /// <summary>The warehouse the item most recently arrived at <paramref name="vehicleId"/> from, or null if it never did.</summary>
    Task<Guid?> GetLastWarehouseSourceAsync(Guid vehicleId, Guid itemId);

    // Batches — a null batchNumber always creates a fresh expiry-only lot (no dedup possible on null).
    Task<ItemBatch?> FindBatchAsync(Guid itemId, string batchNumber);
    Task AddItemBatchAsync(ItemBatch batch);

    // Serial numbers
    Task<ItemSerialNumber?> GetSerialAsync(Guid serialId);
    Task<bool> SerialNumberExistsAsync(Guid itemId, string serialNumber);
    /// <summary>One past the highest numeric suffix among the item's existing serials that start with <paramref name="prefix"/> (1 if none).</summary>
    Task<int> GetNextSerialSequenceAsync(Guid itemId, string prefix);
    Task AddItemSerialNumberAsync(ItemSerialNumber serial);
}