Struct UserRegistry 

pub struct UserRegistry { /* private fields */ }

Daemon-level user registry with persistent storage.

Manages user lifecycle, token auth, room membership, and global status. All mutations auto-save to {data_dir}/users.json.

Implementations

impl UserRegistry

pub fn new(data_dir: PathBuf) -> Self

Create a new empty registry backed by the given directory.

Does not load from disk — use UserRegistry::load for that.

pub fn load(data_dir: PathBuf) -> Result<Self, String>

Load an existing registry from {data_dir}/users.json.

Returns a fresh empty registry if the file does not exist. Returns an error only if the file exists but cannot be parsed.

pub fn save(&self) -> Result<(), String>

Persist the registry to {data_dir}/users.json.

pub fn register_user(&mut self, username: &str) -> Result<&User, String>

Register a new user. Fails if the username is already taken.

pub fn remove_user(&mut self, username: &str) -> Result<bool, String>

Remove a user and all their tokens.

Returns true if the user existed.

pub fn get_user(&self, username: &str) -> Option<&User>

Look up a user by username.

pub fn list_users(&self) -> Vec<&User>

List all registered users.

pub fn issue_token(&mut self, username: &str) -> Result<String, String>

Issue a new token for a registered user.

The user must already be registered via [register_user].

pub fn validate_token(&self, token: &str) -> Option<&str>

Validate a token, returning the associated username.

pub fn revoke_token(&mut self, token: &str) -> Result<bool, String>

Revoke a specific token. Returns true if it existed.

pub fn revoke_user_tokens(&mut self, username: &str) -> Result<usize, String>

Revoke all tokens for a user. Returns the number revoked.

pub fn join_room(&mut self, username: &str, room_id: &str) -> Result<(), String>

Record that a user has joined a room.

pub fn leave_room( &mut self, username: &str, room_id: &str, ) -> Result<bool, String>

Record that a user has left a room.

pub fn set_status( &mut self, username: &str, status: Option<String>, ) -> Result<(), String>

Set or clear a user’s global status.

Pass None to clear. Status applies across all rooms the user is in.

pub fn data_path(&self) -> PathBuf

Return the path to the backing JSON file.

pub fn has_token_for_user(&self, username: &str) -> bool

Return true if any token is currently associated with username.

Used by daemon auth to detect username collisions without scanning the entire token map externally.

pub fn register_user_idempotent(&mut self, username: &str) -> Result<(), String>

Register a user if not already registered; no-op if already present.

Unlike [register_user], this is idempotent — calling it for an existing user does not return an error. Used by daemon auth so that users from a previous session (loaded from users.json) can rejoin without triggering a registration error.

pub fn token_snapshot(&self) -> HashMap<String, String>

Return a snapshot of all current token → username mappings.

Used at daemon startup to seed the in-memory TokenMap from persisted registry data so existing tokens remain valid without a fresh join.

pub fn import_token( &mut self, username: &str, token: &str, ) -> Result<(), String>

Insert a pre-existing token UUID for a registered user.

Unlike [issue_token], which generates a fresh UUID, this method preserves the caller-supplied token string. It is intended for migration paths that read legacy token files (e.g. /tmp/room-*-*.token) and want existing clients to remain valid without a forced re-join.

Returns Ok(()) immediately if the token is already present in the registry (idempotent). Returns an error if username is not registered.

Trait Implementations

impl Debug for UserRegistry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.