using Microsoft.AspNetCore.Http;

namespace Fitness_core_BE.Interfaces.Services
{
    public interface IBookingService
    {
        /// <summary>Logged-in member books a session against their own plan's allowance.</summary>
        Task<object> CreateMemberBooking(object payload, HttpContext httpContext);

        /// <summary>No membership at all -- pay-per-session, identity proof is the returned OTP.</summary>
        Task<object> CreateGuestBooking(object payload, HttpContext httpContext);

        /// <summary>Member books an AdHoc-mode facility directly for an arbitrary time window, no
        /// pre-created session.</summary>
        Task<object> CreateMemberAdhocBooking(object payload, HttpContext httpContext);

        /// <summary>Guest/staff walk-in books an AdHoc-mode facility directly.</summary>
        Task<object> CreateGuestAdhocBooking(object payload, HttpContext httpContext);

        /// <summary>Renders the public, unauthenticated confirmation page a booking's ShareUrl
        /// points to -- the "copy the link and share it" receipt. Returns null if not found, so
        /// the controller can render a 404 page instead of a JSON error for a browser hit.</summary>
        Task<object?> GetBookingView(object payload);

        /// <summary>Staff records a guest booking's payment (cash/bank/at-venue) after the fact.</summary>
        Task<object> MarkGuestBookingPaid(object payload, HttpContext httpContext);

        /// <summary>Staff/door check-in: verifies the OTP, optionally assigns an RFID tag, marks
        /// the booking checked in. Also lazily sweeps this client's overdue bookings first (see
        /// BookingService.SweepOverdueBookingsAsync) instead of a background job.</summary>
        Task<object> CheckInBooking(object payload, HttpContext httpContext);

        Task<object> CancelBooking(object payload, HttpContext httpContext);

        /// <summary>Staff hands a Confirmed guest booking to a different person (name/phone) --
        /// no cancel/recreate needed. Guest bookings only.</summary>
        Task<object> ReassignBooking(object payload, HttpContext httpContext);

        /// <summary>Staff moves a Confirmed booking to a different time (AdHoc) or session
        /// (Scheduled), only onto a slot with room.</summary>
        Task<object> RescheduleBooking(object payload, HttpContext httpContext);

        /// <summary>Staff manually flags a Confirmed, never-arrived booking.</summary>
        Task<object> MarkNoShow(object payload, HttpContext httpContext);

        /// <summary>Staff manually ends a CheckedIn booking early (before the lazy sweep would
        /// catch it), releasing its RFID tag if any.</summary>
        Task<object> CompleteBooking(object payload, HttpContext httpContext);

        Task<object> GetMyBookings(object payload, HttpContext httpContext);
        Task<object> GetSessionBookings(object payload, HttpContext httpContext);

        /// <summary>Unified roster covering both booking modes.</summary>
        Task<object> GetBookings(object payload, HttpContext httpContext);
    }
}