oxinat_core 0.14.1

use std::{fmt::Debug, path::PathBuf, sync::Arc};

use oxinat_derive::uri_builder_alias;

use crate::{UriBuildError, UriBuilder, Version};

uri_builder_alias!(UserAdminUriBuilder);
ImplUserAdminUriBuilder! {
    (String),
}

macro_rules! username_is_some {
    () => {
        |this: &Self| this.parent.as_ref().is_some_and(|p| p.username.is_some())
    };
}

macro_rules! username_is_none {
    () => {
        |this: &Self| this.parent.as_ref().is_some_and(|p| p.username.is_none())
    };
}

/// Represents all URI endpoints for an admin to
/// manage XNAT users.
#[derive(Clone, Debug, Default, UriBuilder)]
#[match_path(path = "{parent}/users")]
#[match_path(path = "{parent}/users/{username}")]
pub struct UserUriBuilder<Parent>
where
    Parent: UserAdminUriBuilder,
{
    #[param]
    username: Option<String>,
    #[parent]
    parent: Option<Arc<Parent>>
}

/// Represents URI endpoints for an XNAT admin to
/// manage active users and their sessions.
#[derive(Clone, Debug, Default, UriBuilder)]
#[match_path(path = "{parent}/active", requires = "username_is_none!()")]
#[match_path(path = "{parent}/active/{username}", requires = "username_is_none!()")]
pub struct ActiveUriBuilder<'a> {
    #[param]
    username: Option<String>,
    #[parent]
    parent: Option<&'a UserUriBuilder<String>>
}

#[derive(Clone, Debug, Default, UriBuilder)]
#[match_path(path = "{parent}/access", requires = "username_is_none!()")]
#[match_path(path = "{parent}/access/{username}", requires = "username_is_none!()")]
pub struct AccessUriBuilder<'a> {
    #[param]
    username: Option<String>,
    #[parent]
    parent: Option<&'a UserUriBuilder<String>>
}

/// Represents URI endpoints for an XNAT admin to
/// manage user cached data.
#[derive(Clone, Debug, Default, UriBuilder)]
#[match_path(path = "{parent}/cache", requires = "username_is_none!()")]
pub struct CacheUriBuilder<'a> {
    #[parent]
    parent: Option<&'a AccessUriBuilder<'a>>
}

/// Represents the URI path to allow an admin to
/// invalidate user cached data.
#[derive(Clone, Debug, Default, UriBuilder)]
#[match_path(path = "{parent}/flush")]
#[match_path(path = "{parent}/flush/{username}")]
pub struct CacheFlushUriBuilder<'a> {
    #[param]
    username: Option<String>,
    #[parent]
    parent: Option<&'a CacheUriBuilder<'a>>
}

#[derive(Clone, Debug, Default, UriBuilder)]
#[match_path(path = "parent/status")]
pub struct CacheStatusUriBuilder<'a> {
    #[parent]
    parent: Option<&'a CacheUriBuilder<'a>>
}

impl CacheUriBuilder<'_> {
    /// Continue the builder into a
    /// `CacheFlushUriBuilder`.
    pub fn flush(&self) -> CacheFlushUriBuilder {
        CacheFlushUriBuilder::from_parent(self)
    }

    /// Continue the builder into a
    /// `CacheStatusUriBuilder`.
    pub fn status(&self) -> CacheStatusUriBuilder {
        CacheStatusUriBuilder::from_parent(self)
    }
}

#[derive(Clone, Debug, Default, UriBuilder)]
#[match_path(path = "{parent}/displays")]
#[match_path(path = "{parent}/displays/{display}")]
pub struct DisplaysUriBuilder<'a> {
    #[param]
    display: Option<String>,
    #[parent]
    parent: Option<&'a AccessUriBuilder<'a>>
}

impl DisplaysUriBuilder<'_> {
    /// Produces the URI displays/modified
    /// endpoint.
    pub fn modified(&self) -> crate::BuildResult {
        if self.display.is_none() {
            self.build_join("modified")
        } else {
            Err(UriBuildError::Validation.into())
        }
    }
}

#[derive(Clone, Debug, Default, UriBuilder)]
#[match_path(path = "{parent}/permissions", requires = "username_is_none!()")]
pub struct PermissionsUriBuilder<'a> {
    #[parent]
    parent: Option<&'a AccessUriBuilder<'a>>
}

#[derive(Clone, Debug, Default, UriBuilder)]
#[match_path(path = "{parent}/group")]
#[match_path(path = "{parent}/group/{project_id}")]
pub struct GroupPermissionsUriBuilder<'a> {
    #[param]
    project_id: Option<String>,
    #[parent]
    parent: Option<&'a PermissionsUriBuilder<'a>>
}

#[derive(Clone, Debug, UriBuilder)]
pub enum IrregularPermission {
    Find,
    Fix
}

#[derive(Clone, Debug, Default, UriBuilder)]
#[match_path(path = "{parent}/irregular/{irregular_permission}")]
pub struct IrregularPermissionsUriBuilder<'a> {
    #[param]
    irregular_permission: Option<IrregularPermission>,
    #[parent]
    parent: Option<&'a PermissionsUriBuilder<'a>>
}

impl PermissionsUriBuilder<'_> {
    /// Continue the builder into a
    /// `GroupPermissionsUriBuilder`.
    pub fn group(&self) -> GroupPermissionsUriBuilder {
        GroupPermissionsUriBuilder::from_parent(self)
    }

    /// Continue the builder into a
    /// `IrregularPermissionsUriBuilder`.
    pub fn irregular(&self) -> IrregularPermissionsUriBuilder {
        IrregularPermissionsUriBuilder::from_parent(self)
    }
}

impl AccessUriBuilder<'_> {
    /// Produce the URI path access/projects or
    /// access/{username}/projects
    pub fn build_projects(&self) -> crate::BuildResult {
        self.build_join("projects")
    }

    /// Continue the builder into a
    /// `CacheStatusUriBuilder`.
    pub fn cache(&self) -> CacheUriBuilder {
        CacheUriBuilder::from_parent(self)
    }

    /// Continue the builder into a
    /// `DisplaysUriBuilder`.
    pub fn displays(&self) -> DisplaysUriBuilder {
        DisplaysUriBuilder::from_parent(self)
    }

    /// Continue the builder into a
    /// `PermissionsUriBuilder`.
    pub fn permissions(&self) -> PermissionsUriBuilder {
        PermissionsUriBuilder::from_parent(self)
    }
}

/// Represents URI endpoints for an XNAT admin to
/// manage whether a user is enabled or not.
#[derive(Clone, Debug, Default, UriBuilder)]
#[match_path(path = "{parent}/enabled", requires = "username_is_some!()")]
#[match_path(path = "{parent}/enabled/{flag}", requires = "username_is_some!()")]
pub struct EnabledUriBuilder<'a> {
    #[param]
    flag: Option<bool>,
    #[parent]
    parent: Option<&'a UserUriBuilder<String>>
}

/// Represents URI enpoints for an XNAT admin to
/// manage user groups.
#[derive(Clone, Debug, Default, UriBuilder)]
#[match_path(path = "{parent}/groups", requires = "username_is_some!()")]
#[match_path(path = "{parent}/groups/{group}", requires = "username_is_some!()")]
pub struct GroupsUriBuilder<'a>
{
    #[param]
    group: Option<String>,
    #[parent]
    parent: Option<&'a UserUriBuilder<String>>
}

/// Represents the URI endpoints for an XNAT admin
/// to access user profile metadata.
#[derive(Clone, Debug, Default, UriBuilder)]
#[match_path(path = "{parent}/profiles", requires = "username_is_none!()")]
#[match_path(path = "{parent}/profile/{username}", requires = "username_is_none!()")]
pub struct ProfilesUriBuilder<'a> {
    #[param]
    username: Option<String>,
    #[parent]
    parent: Option<&'a UserUriBuilder<String>>
}

/// Represents the URI endpoints for an XNAT admin
/// manage user roles.
#[derive(Clone, Debug, Default, UriBuilder)]
#[match_path(path = "{parent}/roles", requires = "username_is_some!()")]
#[match_path(path = "{parent}/roles/{role}", requires = "username_is_some!()")]
pub struct RolesUriBuilder<'a> {
    #[param]
    role: Option<String>,
    #[parent]
    parent: Option<&'a UserUriBuilder<String>>
}

/// Represents the URI endpoints for an XNAT admin
/// manage user roles.
#[derive(Clone, Debug, Default, UriBuilder)]
#[match_path(path = "{parent}/verified", requires = "username_is_some!()")]
#[match_path(path = "{parent}/verified/{flag}", requires = "username_is_some!()")]
pub struct VerifiedUriBuilder<'a> {
    #[param]
    flag: Option<bool>,
    #[parent]
    parent: Option<&'a UserUriBuilder<String>>
}

impl UserUriBuilder<String>
{
    /// Continue the builder into an
    /// `AccessUriBuilder`
    pub fn access(&self) -> AccessUriBuilder {
        AccessUriBuilder::from_parent(&Arc::new(self))
    }

    /// Continue the builder into a
    /// `ActiveUriBuilder`.
    pub fn active(&self) -> ActiveUriBuilder {
        ActiveUriBuilder::from_parent(&Arc::new(self))
    }

    /// Produces the users/current URI endpoint.
    pub fn build_current(&self) -> crate::BuildResult {
        self.build_join("current")
    }

    /// Produces the users/projects URI endpoint.
    pub fn build_projects(&self) -> crate::BuildResult {
        if self.username.is_none() {
            self.build_join("projects")
        } else {
            Err(UriBuildError::Validation.into())
        }
    }

    /// Produces the users/username URI endpoint.
    pub fn build_username(&self) -> crate::BuildResult {
        if self.username.is_none() {
            self.build_join("username")
        } else {
            Err(UriBuildError::Validation.into())
        }
    }

    /// Continue the builder into an
    /// `EnabledUriBuilder`.
    pub fn enabled(&self) -> EnabledUriBuilder {
        EnabledUriBuilder::from_parent(&Arc::new(self))
    }

    /// Continue the builder into a
    /// `GroupsUriBuilder`.
    pub fn groups(&self) -> GroupsUriBuilder {
        GroupsUriBuilder::from_parent(&Arc::new(self))
    }

    /// Continue the builder into a
    /// `ProfilesUriBuilder`.
    pub fn profiles(&self) -> ProfilesUriBuilder {
        ProfilesUriBuilder::from_parent(&Arc::new(self))
    }

    /// Continue the builder into a
    /// `RolesUriBuilder`.
    pub fn roles(&self) -> RolesUriBuilder {
        RolesUriBuilder::from_parent(&Arc::new(self))
    }

    /// Continue the builder into a
    /// `VerifiedUriBuilder`.
    pub fn verified(&self) -> VerifiedUriBuilder {
        VerifiedUriBuilder::from_parent(&Arc::new(self))
    }
}

/// Represents the legacy URI endpoint paths
/// available for a XNAT admin to manage users.
#[derive(Clone, Debug, Default, UriBuilder)]
#[match_path(path = "{parent}/users")]
#[match_path(path = "{parent}/user/{username}")]
pub struct UsersUriLegacyBuilder<Parent>
where
    Parent: UserAdminUriBuilder,
{
    #[param]
    username: Option<String>,
    #[parent]
    parent: Option<Arc<Parent>>
}

/// Represents the legacy URI endpoint paths
/// available for access to user caches.
#[derive(Clone, Debug, Default, UriBuilder)]
#[match_path(path = "{parent}/cache", requires = "username_is_none!()")]
pub struct CacheUriLegacyBuilder<'a> {
    #[parent]
    parent: Option<&'a UsersUriLegacyBuilder<String>>
}

/// Represents the legacy URI endpoint paths
/// available for access to user cached resources.
#[derive(Clone, Debug, Default, UriBuilder)]
#[match_path(path = "{parent}/resources")]
#[match_path(path = "{parent}/resources/{folder}")]
#[match_path(path = "{parent}/resources/{folder}/files/{file}")]
pub struct ResourcesUriBuilder<'a> {
    #[param(map_from = "|pb: &PathBuf| pb.to_str().unwrap().to_string()")]
    file: Option<PathBuf>,
    #[param]
    folder: Option<String>,
    #[parent]
    parent: Option<&'a CacheUriLegacyBuilder<'a>>
}

impl ResourcesUriBuilder<'_> {
    /// Produce the resources/{folder}/files URI
    /// endpoint to access read to all files.
    pub fn build_files(&self) -> crate::BuildResult {
        if self.file.is_none() && self.folder.is_some() {
            self.build_join("projects")
        } else {
            Err(UriBuildError::Validation.into())
        }
    }
}

impl CacheUriLegacyBuilder<'_> {
    /// Continue the builder into a
    /// `ResourcesUriBuilder`
    pub fn resources(&self) -> ResourcesUriBuilder {
        ResourcesUriBuilder::from_parent(&Arc::new(self))
    }
}

/// Represents the URI endpoints available to
/// manage user favorites.
#[derive(Clone, Debug, Default, UriBuilder)]
#[match_path(path = "{parent}/favorites/Project/{project_id}", requires = "username_is_none!()")]
pub struct FavoritesUriBuilder<'a> {
    #[param]
    project_id: Option<String>,
    #[parent]
    parent: Option<&'a UsersUriLegacyBuilder<String>>
}

/// Represents the URI endpoints available to
/// manage users associated with a project.
#[derive(Clone, Debug, Default, UriBuilder)]
#[match_path(path = "{parent}/projects/{project_id}/users", requires = "username_is_none!()")]
#[match_path(path = "{parent}/projects/{project_id}/users/{group_display_name}/{username}", requires = "username_is_none!()")]
pub struct ProjectsUriBuilder<'a> {
    #[param]
    project_id: Option<String>,
    #[param]
    group_display_name: Option<String>,
    #[param]
    username: Option<String>,
    #[parent]
    parent: Option<&'a UsersUriLegacyBuilder<String>>,
}

/// Represents the URI endpoints for user PARs
/// requests (Project Access Request)
#[derive(Clone, Debug, Default, UriBuilder)]
#[match_path(path = "{parent}/pars")]
#[match_path(path = "{parent}/pars/{pars_id}")]
#[match_path(path = "{parent}/projects/{project_id}/pars")]
pub struct ProjectAccessUriBuilder<'a> {
    #[param]
    pars_id: Option<String>,
    #[param]
    project_id: Option<String>,
    #[parent]
    parent: Option<&'a ProjectsUriBuilder<'a>>
}

impl ProjectsUriBuilder<'_> {
    /// Continue the builder into a
    /// `ProjectAccessUriBuilder`.
    pub fn pars(&self) -> ProjectAccessUriBuilder {
        ProjectAccessUriBuilder::from_parent(&Arc::new(self))
    }
}

impl UsersUriLegacyBuilder<String> {
    /// Continue the builder into a
    /// `CacheUriBuilder`.
    pub fn cache(&self) -> CacheUriLegacyBuilder {
        CacheUriLegacyBuilder::from_parent(&Arc::new(self))
    }

    /// Continue the builder into a
    /// `FavoritesUriBuilder`.
    pub fn favorites(&self) -> FavoritesUriBuilder {
        FavoritesUriBuilder::from_parent(&Arc::new(self))
    }

    /// Continue the builder into a
    /// `ProjectsUriBuilder`.
    pub fn projects(&self) -> ProjectsUriBuilder {
        ProjectsUriBuilder::from_parent(&Arc::new(self))
    }
}

/// Represents the URI paths available for
/// endpoints meant for managing users.
pub trait UsersUri: Version {
    /// URI endpoints to access user
    /// administration.
    #[inline]
    fn users(&self) -> UserUriBuilder<String> {
        UserUriBuilder::from_parent(self.root_uri().into())
    }
}

/// Represents the URI paths available for
/// endpoints meant for managing users via the
/// legacy API.
pub trait UsersUriLegacy: Version {
    /// URI legacy endpoints to access user
    /// administration.
    #[inline]
    fn users_legacy(&self) -> UsersUriLegacyBuilder<String> {
        UsersUriLegacyBuilder::from_parent(self.data_uri().into())
    }
}