using ECPDAL.Collaboration.DTOs;
using GB5Shared.DTO.Framework.Login;

namespace ECPBLL.Collaboration.Interfaces;

public interface ICollaborationSpaceBLL
{
    Task<string> GetCollaborationSpaceAsync(int collaborationSpaceId, LoginDTO login, CancellationToken ct);

    /// <summary>Dropdown picker — spaces the current user owns or is a member of, per the
    /// "Also link to Team Space(s)" and "Add Member" pickers in the ECP preview.</summary>
    Task<string> GetSelectListCollaborationSpaceAsync(LoginDTO login, CancellationToken ct);

    /// <summary>Every space the current user owns or is a member of (union, de-duplicated),
    /// per the plan's "GetCollaborationSpaceList (by owner/member)" endpoint.</summary>
    Task<string> GetCollaborationSpaceListAsync(LoginDTO login, CancellationToken ct);

    /// <summary>Creates (CollaborationSpaceId == 0) or updates (CollaborationSpaceId > 0) a space.
    /// On create, the caller becomes the space's owner and its first
    /// TCOLLABORATIONSPACEMEMBER row (Role=Owner).</summary>
    Task<string> SaveCollaborationSpaceAsync(SaveCollaborationSpaceDTO dto, LoginDTO login, CancellationToken ct);

    /// <summary>Archives (soft-closes) a space — only the owner may do this.</summary>
    Task<string> DeleteCollaborationSpaceAsync(int collaborationSpaceId, LoginDTO login, CancellationToken ct);

    /// <summary>Adds a member — only the owner may do this. Throws if the user is already a
    /// member (checked explicitly, not left to the DB unique-constraint violation).</summary>
    Task<string> AddCollaborationSpaceMemberAsync(AddCollaborationSpaceMemberDTO dto, LoginDTO login, CancellationToken ct);

    /// <summary>Removes a member — the owner may remove anyone; a member may remove themselves.
    /// The owner cannot be removed (must archive the space instead).</summary>
    Task<string> RemoveCollaborationSpaceMemberAsync(int collaborationSpaceId, int userId, LoginDTO login, CancellationToken ct);

    /// <summary>A single membership row — the Members tab's own Get, separate from the
    /// space-detail view's embedded Members list.</summary>
    Task<string> GetCollaborationSpaceMemberAsync(int collaborationSpaceId, int userId, LoginDTO login, CancellationToken ct);

    /// <summary>All active members of a space — same rows as GetCollaborationSpace.Members, as
    /// its own standalone list endpoint per the Members tab's folder.</summary>
    Task<string> GetCollaborationSpaceMemberListAsync(int collaborationSpaceId, LoginDTO login, CancellationToken ct);

    /// <summary>"Add Member" picker — active users not already a member of the space.</summary>
    Task<string> GetSelectListCollaborationSpaceMemberAsync(int collaborationSpaceId, LoginDTO login, CancellationToken ct);

    /// <summary>Correspondence tab — correspondence sent or logged elsewhere in the platform
    /// whose ObjectTypeId/ObjectId identify this space, per Correspondence's own polymorphic
    /// ObjectTypeId+ObjectId shape (no separate "space link" join table — a space IS a
    /// first-class correspondence object, same as any business record).</summary>
    Task<string> GetCollaborationSpaceCorrespondenceListAsync(int collaborationSpaceId, LoginDTO login, CancellationToken ct);
}