using Core.Entities;
using WebApp.Models;

namespace WebApp.Services;

/// <summary>
/// Service for calendar-related operations.
/// </summary>
public interface ICalendarService
{
    /// <summary>
    /// Gets all calendar items (events and meetings) for display in the calendar.
    /// Includes student names for events.
    /// </summary>
    /// <returns>A list of CalendarItemWrapper objects ready for display.</returns>
    Task<List<CalendarItemWrapper>> GetAllCalendarItemsAsync();

    /// <summary>
    /// Gets the next N upcoming calendar items (events and meetings) starting from today.
    /// Returns CalendarItemWrapper objects ready for display.
    /// </summary>
    /// <param name="count">The maximum number of items to return. Default is 3.</param>
    /// <returns>A list of CalendarItemWrapper objects ready for display.</returns>
    Task<List<CalendarItemWrapper>> GetUpcomingCalendarItemsAsync(int count = 3);
}