citadel_user 0.14.0 

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151

//! # Network Account Management
//!
//! This module provides core functionality for network account operations and user identification
//! in the Citadel Protocol. It defines the extension trait for user identifiers and handles
//! account searching and peer relationships.
//!
//! ## Features
//!
//! * **User Identification**
//!   - CID-based identification
//!   - Username-based lookup
//!   - Flexible identifier conversion
//!
//! * **Account Search**
//!   - Account lookup by CID
//!   - Account lookup by username
//!   - Peer relationship search
//!
//! * **Peer Management**
//!   - Mutual peer relationship tracking
//!   - Network peer lookup
//!   - Peer information retrieval
//!
//! ## Usage Example
//!
//! ```rust
//! use citadel_user::prelude::*;
//! use citadel_user::account_manager::AccountManager;
//! use citadel_crypt::ratchets::stacked::StackedRatchet;
//! use citadel_user::backend::BackendType;
//! use citadel_types::user::UserIdentifier;
//!
//! async fn example() -> Result<(), Box<dyn std::error::Error>> {
//!     // Create account manager
//!     let manager = AccountManager::<StackedRatchet, StackedRatchet>::new(
//!         BackendType::InMemory,
//!         None,
//!         None,
//!         None
//!     ).await?;
//!
//!     // Search by CID
//!     let user_by_id = UserIdentifier::ID(1234);
//!     if let Some(account) = user_by_id.search(&manager).await? {
//!         println!("Found account by CID");
//!     }
//!
//!     // Search by username
//!     let user_by_name = UserIdentifier::Username("alice".to_string());
//!     if let Some(account) = user_by_name.search(&manager).await? {
//!         println!("Found account by username");
//!     }
//!
//!     // Search for peer relationship
//!     if let Some(peer) = user_by_id.search_peer(5678, &manager).await? {
//!         println!("Found peer relationship");
//!     }
//!
//!     Ok(())
//! }
//! ```
//!
//! ## Important Notes
//!
//! * CIDs are unique identifiers for network accounts
//! * Username lookups are case-insensitive
//! * Peer relationships are bidirectional
//! * Search operations are async and fallible
//!
//! ## Related Components
//!
//! * `AccountManager`: Core account management
//! * `UserIdentifier`: User identification types
//! * `ClientNetworkAccount`: Client account type
//! * `MutualPeer`: Peer relationship type
//!

use crate::account_manager::AccountManager;
use crate::misc::AccountError;
use crate::prelude::ClientNetworkAccount;
use async_trait::async_trait;
use citadel_crypt::ratchets::Ratchet;
use citadel_types::user::MutualPeer;
use citadel_types::user::UserIdentifier;

/// The file extension for CNACs only
pub const CNAC_SERIALIZED_EXTENSION: &str = "hca";

#[async_trait]
pub trait UserIdentifierExt {
    type Error;
    async fn search<R: Ratchet, Fcm: Ratchet>(
        &self,
        account_manager: &AccountManager<R, Fcm>,
    ) -> Result<Option<ClientNetworkAccount<R, Fcm>>, Self::Error>;

    /// Performs a search for the current peer given the `session_cid`
    async fn search_peer<R: Ratchet, Fcm: Ratchet>(
        &self,
        session_cid: u64,
        account_manager: &AccountManager<R, Fcm>,
    ) -> Result<Option<MutualPeer>, Self::Error>;

    fn get_cid(&self) -> u64;
}

#[async_trait]
impl UserIdentifierExt for UserIdentifier {
    type Error = AccountError;

    /// Searches for the account
    async fn search<R: Ratchet, Fcm: Ratchet>(
        &self,
        account_manager: &AccountManager<R, Fcm>,
    ) -> Result<Option<ClientNetworkAccount<R, Fcm>>, AccountError> {
        match self {
            Self::ID(cid) => account_manager.get_client_by_cid(*cid).await,
            Self::Username(uname) => account_manager.get_client_by_username(uname).await,
        }
    }

    /// Performs a search for the current peer given the `session_cid`
    async fn search_peer<R: Ratchet, Fcm: Ratchet>(
        &self,
        session_cid: u64,
        account_manager: &AccountManager<R, Fcm>,
    ) -> Result<Option<MutualPeer>, AccountError> {
        match self {
            UserIdentifier::ID(cid) => {
                account_manager
                    .get_persistence_handler()
                    .get_hyperlan_peer_by_cid(session_cid, *cid)
                    .await
            }
            UserIdentifier::Username(name) => {
                account_manager
                    .get_persistence_handler()
                    .get_hyperlan_peer_by_username(session_cid, name.as_str())
                    .await
            }
        }
    }

    /// Gets the CID of this target
    fn get_cid(&self) -> u64 {
        match self {
            UserIdentifier::ID(cid) => *cid,
            UserIdentifier::Username(uname) => citadel_types::user::username_to_cid(uname),
        }
    }
}