using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using Jellyfin.Plugin.WatchedTogether.Configuration;

namespace Jellyfin.Plugin.WatchedTogether.Services;

/// <summary>
/// Creates, updates and removes shared accounts and their groups.
/// </summary>
public interface IProvisioningService
{
    /// <summary>
    /// Creates a shared account for the given members and records the group.
    /// </summary>
    /// <remarks>
    /// The account is granted exactly the libraries every member can already reach, so it can never
    /// be used to see more than any one member could alone.
    /// </remarks>
    /// <param name="memberIds">The members whose passwords will unlock the account. At least two.</param>
    /// <param name="name">An explicit account name, or <c>null</c> to generate one from the member names.</param>
    /// <returns>The created group.</returns>
    Task<SharedGroup> CreateGroupAsync(IReadOnlyList<Guid> memberIds, string? name);

    /// <summary>
    /// Replaces the membership and options of an existing group.
    /// </summary>
    /// <param name="sharedUserId">The shared account identifying the group.</param>
    /// <param name="memberIds">The new member list. At least two.</param>
    /// <param name="syncUnwatched">Whether unwatched state propagates too.</param>
    /// <param name="syncPlayCount">Whether play counts are raised on watch.</param>
    /// <param name="isDisabled">Whether the group is suspended.</param>
    /// <returns>The updated group.</returns>
    Task<SharedGroup> UpdateGroupAsync(
        Guid sharedUserId,
        IReadOnlyList<Guid> memberIds,
        bool syncUnwatched,
        bool syncPlayCount,
        bool isDisabled);

    /// <summary>
    /// Removes a group, optionally deleting its shared account.
    /// </summary>
    /// <param name="sharedUserId">The shared account identifying the group.</param>
    /// <param name="deleteSharedUser">Whether to delete the shared Jellyfin account as well.</param>
    /// <returns>A task representing the removal.</returns>
    Task DeleteGroupAsync(Guid sharedUserId, bool deleteSharedUser);
}