use std::collections::{BTreeMap, HashMap, HashSet, VecDeque}; use std::time::{SystemTime, UNIX_EPOCH}; // The read-only network view a module sees; re-exported so the engine keeps // naming it locally. pub use echo_api::{HelpEntry, IncidentView, NetView, SeenView}; // The most recent moderation/action incidents kept for LOGSEARCH. const INCIDENT_CAP: usize = 10_000; // Live network view, rebuilt from the uplink's burst each connect (ephemeral — // unlike the account store, which persists). #[derive(Default)] pub struct Network { pub users: HashMap, // keyed by UID channels: HashMap, // keyed by lowercase name accounts: HashMap, // UID -> logged-in account, until logout/quit seen: HashMap, // lowercase nick -> last activity // Our own service bots (lowercase nick -> live uid). Kept separate from // `users` so a reconnect can clear them wholesale without disturbing the // uplink-sourced user map. bots: HashMap, // Shared, namespaced stat counters any service contributes to (ephemeral, // ordered for a stable snapshot). Read by StatServ and the gRPC Stats API. stats: BTreeMap, // Live session count per connecting IP, for OperServ session limiting. sessions: HashMap, // Recent moderation/action incidents (bounded ring), for OperServ LOGSEARCH. incidents: VecDeque, incident_seq: u64, // ChanFix op-time scores: channel (lowercase) -> identity (account or host) -> // score. Sampled from live op state; ephemeral (node-local, rebuilt over time). chanfix: HashMap>, // Network-wide help index (service nick, blurb, per-command topics), built by // the engine at startup from every service so HelpServ can front it. pub help_catalog: Vec<(String, &'static str, &'static [HelpEntry])>, } // ChanFix scoring caps and rates. const CHANFIX_MAX: u32 = 5000; const CHANFIX_BUMP: u32 = 2; // per sample while opped (net +1 after the -1 decay) // One recorded action: a short id (also stamped into the action's reason), the // unix time it happened, and a human summary. struct Incident { id: String, ts: u64, summary: String, } // A short uppercase base-36 incident code from a monotonic counter. fn incident_code(seq: u64) -> String { const C: &[u8] = b"0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ"; if seq == 0 { return "0".to_string(); } let mut n = seq; let mut out = Vec::new(); while n > 0 { out.push(C[(n % 36) as usize]); n /= 36; } out.reverse(); String::from_utf8(out).unwrap() } pub struct User { pub uid: String, pub nick: String, pub host: String, pub ip: String, } // A channel's live membership, ops, and current key (+k), tracked from the burst. #[derive(Default)] pub struct Channel { pub members: HashSet, // uids pub ops: HashSet, // uids holding channel-operator status pub voices: HashSet, // uids holding +v pub key: Option, // BOTSTATS: lines seen this session, and per-nick counts (top-talkers). Bounded. pub lines: u64, pub talkers: HashMap, } // The last time a nick was seen, and doing what. pub struct Seen { pub nick: String, pub ts: u64, pub what: String, } fn now() -> u64 { SystemTime::now().duration_since(UNIX_EPOCH).map(|d| d.as_secs()).unwrap_or(0) } fn lc(s: &str) -> String { s.to_ascii_lowercase() } impl Network { pub fn user_connect(&mut self, uid: String, nick: String, host: String, ip: String) { if !ip.is_empty() { *self.sessions.entry(ip.clone()).or_insert(0) += 1; } self.users.insert(uid.clone(), User { uid, nick, host, ip }); } // Live sessions from `ip`. pub fn session_count(&self, ip: &str) -> u32 { self.sessions.get(ip).copied().unwrap_or(0) } // IPs with at least `min` live sessions, most sessions first. pub fn sessions_over(&self, min: u32) -> Vec<(String, u32)> { let mut v: Vec<(String, u32)> = self.sessions.iter().filter(|(_, &n)| n >= min).map(|(ip, &n)| (ip.clone(), n)).collect(); v.sort_by_key(|&(_, n)| std::cmp::Reverse(n)); v } // Record an action in the incident log and return its short id (to stamp into // the action's reason). The ring is bounded, dropping the oldest. pub fn record_incident(&mut self, summary: String, now: u64) -> String { let id = incident_code(self.incident_seq); self.incident_seq += 1; self.incidents.push_back(Incident { id: id.clone(), ts: now, summary }); while self.incidents.len() > INCIDENT_CAP { self.incidents.pop_front(); } id } // Incidents matching `pattern` (id-exact or summary-substring, case- // insensitive; empty = all), newest first, capped at `limit`. pub fn search_incidents(&self, pattern: &str, limit: usize) -> Vec { let p = pattern.to_ascii_lowercase(); self.incidents .iter() .rev() .filter(|i| p.is_empty() || i.id.eq_ignore_ascii_case(&p) || i.summary.to_ascii_lowercase().contains(&p)) .take(limit) .map(|i| IncidentView { id: i.id.clone(), ts: i.ts, summary: i.summary.clone() }) .collect() } // Resolve a nick to its uid (case-insensitive). Checks real users first, // then our own service bots. pub fn uid_by_nick(&self, nick: &str) -> Option<&str> { self.users .values() .find(|u| u.nick.eq_ignore_ascii_case(nick)) .map(|u| u.uid.as_str()) .or_else(|| self.bots.get(&nick.to_ascii_lowercase()).map(String::as_str)) } // Track / forget one of our service bots by lowercase nick. pub fn bot_connect(&mut self, nick: &str, uid: &str) { self.bots.insert(nick.to_ascii_lowercase(), uid.to_string()); } pub fn bot_forget(&mut self, nick_lc: &str) { self.bots.remove(nick_lc); } pub fn clear_bots(&mut self) { self.bots.clear(); } pub fn host_of(&self, uid: &str) -> Option<&str> { self.users.get(uid).map(|u| u.host.as_str()) } pub fn user_nick_change(&mut self, uid: &str, nick: String) { if let Some(user) = self.users.get_mut(uid) { self.seen.insert(lc(&nick), Seen { nick: nick.clone(), ts: now(), what: format!("changing nick from {}", user.nick) }); user.nick = nick; } } pub fn user_quit(&mut self, uid: &str) { if let Some(u) = self.users.get(uid) { self.seen.insert(lc(&u.nick), Seen { nick: u.nick.clone(), ts: now(), what: "quitting".to_string() }); // Release the user's session slot. if let Some(n) = self.sessions.get_mut(&u.ip) { *n -= 1; if *n == 0 { self.sessions.remove(&u.ip); } } } self.users.remove(uid); self.accounts.remove(uid); for c in self.channels.values_mut() { c.members.remove(uid); c.ops.remove(uid); c.voices.remove(uid); } } pub fn nick_of(&self, uid: &str) -> Option<&str> { self.users.get(uid).map(|u| u.nick.as_str()) } // A user's currently identified account, if any. Kept in step with the // accountname metadata the engine emits (login sets it, logout clears it). pub fn account_of(&self, uid: &str) -> Option<&str> { self.accounts.get(uid).map(String::as_str) } // Uids of every live session currently identified to `account`. pub fn uids_logged_into(&self, account: &str) -> Vec { self.accounts .iter() .filter(|(_, a)| a.eq_ignore_ascii_case(account)) .map(|(uid, _)| uid.clone()) .collect() } pub fn set_account(&mut self, uid: &str, account: &str) { self.accounts.insert(uid.to_string(), account.to_string()); } pub fn clear_account(&mut self, uid: &str) { self.accounts.remove(uid); } // A user joined a channel: record membership (and op status) and last-seen. pub fn channel_join(&mut self, channel: &str, uid: &str, op: bool) { let c = self.channels.entry(lc(channel)).or_default(); c.members.insert(uid.to_string()); if op { c.ops.insert(uid.to_string()); } if let Some(nick) = self.nick_of(uid) { self.seen.insert(lc(nick), Seen { nick: nick.to_string(), ts: now(), what: format!("joining {channel}") }); } } // A user left a channel (part/kick): drop membership and record last-seen. pub fn channel_part(&mut self, channel: &str, uid: &str) { if let Some(c) = self.channels.get_mut(&lc(channel)) { c.members.remove(uid); c.ops.remove(uid); c.voices.remove(uid); } if let Some(nick) = self.nick_of(uid) { self.seen.insert(lc(nick), Seen { nick: nick.to_string(), ts: now(), what: format!("leaving {channel}") }); } } // Set or clear a user's channel-operator status (FMODE +o/-o). pub fn set_op(&mut self, channel: &str, uid: &str, op: bool) { let c = self.channels.entry(lc(channel)).or_default(); if op { c.ops.insert(uid.to_string()); } else { c.ops.remove(uid); } } // Whether `uid` currently holds operator status in `channel`. pub fn is_op(&self, channel: &str, uid: &str) -> bool { self.channels.get(&lc(channel)).is_some_and(|c| c.ops.contains(uid)) } // Set or clear a user's voice status (+v). pub fn set_voice(&mut self, channel: &str, uid: &str, voice: bool) { let c = self.channels.entry(lc(channel)).or_default(); if voice { c.voices.insert(uid.to_string()); } else { c.voices.remove(uid); } } // Whether `uid` currently holds voice in `channel`. pub fn is_voiced(&self, channel: &str, uid: &str) -> bool { self.channels.get(&lc(channel)).is_some_and(|c| c.voices.contains(uid)) } // Record a line spoken in `channel` by `nick`, for BOTSTATS. The per-nick map // is capped so a busy channel can't grow it without bound. pub fn record_line(&mut self, channel: &str, nick: &str) { const TALKER_CAP: usize = 512; let c = self.channels.entry(lc(channel)).or_default(); c.lines = c.lines.saturating_add(1); if c.talkers.len() < TALKER_CAP || c.talkers.contains_key(nick) { *c.talkers.entry(nick.to_string()).or_insert(0) += 1; } } // Increment a shared stat counter. pub fn bump(&mut self, key: &str) { *self.stats.entry(key.to_string()).or_insert(0) += 1; } // The raw shared counters (sorted). Gauges are merged in by the reader. pub fn stat_counters(&self) -> &BTreeMap { &self.stats } // BOTSTATS view: (total lines, top talkers by count, descending). pub fn channel_activity(&self, channel: &str) -> Option<(u64, Vec<(String, u64)>)> { let c = self.channels.get(&lc(channel))?; let mut top: Vec<(String, u64)> = c.talkers.iter().map(|(n, v)| (n.clone(), *v)).collect(); top.sort_by(|a, b| b.1.cmp(&a.1).then_with(|| a.0.cmp(&b.0))); top.truncate(10); Some((c.lines, top)) } // Uids currently in `channel`. pub fn channel_members(&self, channel: &str) -> impl Iterator { self.channels.get(&lc(channel)).into_iter().flat_map(|c| c.members.iter().map(String::as_str)) } // How many uids currently hold op in `channel`. pub fn op_count(&self, channel: &str) -> usize { self.channels.get(&lc(channel)).map_or(0, |c| c.ops.len()) } // One ChanFix sampling pass: every tracked score decays by 1; every currently- // opped user's identity (its account, else its host) gains CHANFIX_BUMP — a net // +1 while opped, -1 while idle, so trusted regulars rise and stale ops fade. pub fn chanfix_sample(&mut self) { for scores in self.chanfix.values_mut() { for v in scores.values_mut() { *v = v.saturating_sub(1); } } let mut samples: Vec<(String, String)> = Vec::new(); for (chan, c) in &self.channels { for uid in &c.ops { if let Some(id) = self.accounts.get(uid).cloned().or_else(|| self.users.get(uid).map(|u| u.host.clone())) { samples.push((chan.clone(), id)); } } } for (chan, id) in samples { let s = self.chanfix.entry(chan).or_default().entry(id).or_insert(0); *s = (*s + CHANFIX_BUMP).min(CHANFIX_MAX); } for scores in self.chanfix.values_mut() { scores.retain(|_, v| *v > 0); } self.chanfix.retain(|_, m| !m.is_empty()); } // A channel's ChanFix scores (identity -> score), highest first. pub fn chanfix_scores(&self, channel: &str) -> Vec<(String, u32)> { let mut v: Vec<(String, u32)> = self.chanfix.get(&lc(channel)).into_iter().flat_map(|m| m.iter().map(|(k, &s)| (k.clone(), s))).collect(); v.sort_by(|a, b| b.1.cmp(&a.1).then_with(|| a.0.cmp(&b.0))); v } pub fn set_channel_key(&mut self, channel: &str, key: Option) { self.channels.entry(lc(channel)).or_default().key = key; } pub fn channel_key(&self, channel: &str) -> Option<&str> { self.channels.get(&lc(channel)).and_then(|c| c.key.as_deref()) } pub fn last_seen(&self, nick: &str) -> Option<&Seen> { self.seen.get(&lc(nick)) } } // The module-facing network view. Reads forward to Network's own accessors, // with the seen record projected into a plain view. impl NetView for Network { fn uid_by_nick(&self, nick: &str) -> Option<&str> { Network::uid_by_nick(self, nick) } fn nick_of(&self, uid: &str) -> Option<&str> { Network::nick_of(self, uid) } fn host_of(&self, uid: &str) -> Option<&str> { Network::host_of(self, uid) } fn account_of(&self, uid: &str) -> Option<&str> { Network::account_of(self, uid) } fn uids_logged_into(&self, account: &str) -> Vec { Network::uids_logged_into(self, account) } fn is_op(&self, channel: &str, uid: &str) -> bool { Network::is_op(self, channel, uid) } fn channel_members(&self, channel: &str) -> Vec { Network::channel_members(self, channel).map(str::to_string).collect() } fn channel_key(&self, channel: &str) -> Option<&str> { Network::channel_key(self, channel) } fn last_seen(&self, nick: &str) -> Option { Network::last_seen(self, nick).map(|s| SeenView { nick: s.nick.clone(), ts: s.ts, what: s.what.clone(), }) } fn channel_activity(&self, channel: &str) -> Option<(u64, Vec<(String, u64)>)> { Network::channel_activity(self, channel) } fn stat_counters(&self) -> Vec<(String, u64)> { Network::stat_counters(self).iter().map(|(k, v)| (k.clone(), *v)).collect() } fn session_count(&self, ip: &str) -> u32 { Network::session_count(self, ip) } fn sessions_over(&self, min: u32) -> Vec<(String, u32)> { Network::sessions_over(self, min) } fn search_incidents(&self, pattern: &str, limit: usize) -> Vec { Network::search_incidents(self, pattern, limit) } fn chanfix_scores(&self, channel: &str) -> Vec<(String, u32)> { Network::chanfix_scores(self, channel) } fn op_count(&self, channel: &str) -> usize { Network::op_count(self, channel) } fn help_services(&self) -> Vec { self.help_catalog.iter().map(|(n, _, _)| n.clone()).collect() } fn service_help(&self, service: &str) -> Option<(&'static str, &'static [HelpEntry])> { self.help_catalog .iter() .find(|(n, _, _)| n.eq_ignore_ascii_case(service)) .map(|(_, b, t)| (*b, *t)) } }