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::{ChanSeenView, 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, // Downstream server tree: SID -> the SID that introduced it. Lets a hub's // SQUIT cascade to every server (and user) behind it. Rebuilt each link. servers: HashMap, // SID -> server name, for the `server` extban. Rebuilt each link. server_names: HashMap, // Shared, namespaced stat counters any service contributes to (persisted via // StatsSet). Read by StatServ and the gRPC Stats API. stats: BTreeMap, // Per-channel BOTSTATS activity (lines + top talkers), name-keyed and // persisted alongside `stats` so it survives a restart. chan_activity: HashMap, // Per-channel per-nick last message + time, for the channel-scoped SEEN. // Ephemeral (built from activity since services started), bounded per channel. chan_seen: HashMap>, // 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])>, // Account names of the declarative config operators, mirrored from the engine // so services can enumerate staff (MemoServ STAFF). Runtime OPER grants live // in the store; a caller unions the two. config_opers: Vec, } // 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 ident: String, // user@ — from the UID (was discarded); empty until UserAttrs pub host: String, // the displayed host pub realhost: String, // the real host, for host bans against it pub ip: String, pub gecos: String, // real name, for realname / realmask extbans pub fingerprint: String, // TLS cert fingerprint (ssl_cert metadata); empty = none } // 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, } // Per-channel BOTSTATS activity: total lines and per-nick counts (top talkers). // Held name-keyed (not on the live Channel, which is rebuilt from each burst) and // persisted, so a channel's history survives a services restart. #[derive(Default, Clone)] pub struct ChanActivity { 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, } // A nick's last message in a channel, for the channel-scoped SEEN. pub struct ChanSeen { pub nick: String, pub ts: u64, pub msg: 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, ident: String::new(), host, realhost: String::new(), ip, gecos: String::new(), fingerprint: String::new() }); } // Fill in the rest of a user's identity (ident, real host, real name), which // the UID carries but UserConnect doesn't — needed for extban matching. pub fn set_user_attrs(&mut self, uid: &str, ident: String, realhost: String, gecos: String) { if let Some(u) = self.users.get_mut(uid) { u.ident = ident; u.realhost = realhost; u.gecos = gecos; } } // Record a user's TLS fingerprint (ssl_cert metadata), for the `fingerprint` extban. pub fn set_user_cert(&mut self, uid: &str, fp: String) { if let Some(u) = self.users.get_mut(uid) { u.fingerprint = fp; } } // Record a server's name for its SID, so the `server` extban can resolve which // server a user is on (their uid's SID prefix). pub fn set_server_name(&mut self, sid: &str, name: String) { self.server_names.insert(sid.to_string(), name); } // Mirror the engine's declarative config operators, so services can enumerate // staff. Called whenever the config oper set changes. pub fn set_config_opers(&mut self, accounts: Vec) { self.config_opers = accounts; } // 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()) } // A user's identity for extban / ban matching (nick, ident, hosts, ip, gecos, // account). `None` if we don't know the uid. pub fn ban_target<'a>(&'a self, uid: &str) -> Option> { let u = self.users.get(uid)?; Some(echo_api::BanTarget { nick: &u.nick, ident: &u.ident, host: &u.host, realhost: &u.realhost, ip: &u.ip, gecos: &u.gecos, account: self.accounts.get(uid).map(String::as_str), // A uid's first 3 chars are its server's SID; resolve that to the name. server: uid.get(..3).and_then(|sid| self.server_names.get(sid)).map_or("", String::as_str), fingerprint: (!u.fingerprint.is_empty()).then_some(u.fingerprint.as_str()), channels: self.channels_of(uid), }) } /// The channels `uid` is currently in (for the `channel` extban). pub fn channels_of(&self, uid: &str) -> Vec { self.channels.iter().filter(|(_, c)| c.members.contains(uid)).map(|(k, _)| k.clone()).collect() } // Every known user whose uid carries `sid` as its prefix — i.e. those behind // a server, used to forget them all when it splits (SQUIT). pub fn uids_on_server(&self, sid: &str) -> Vec { self.users.keys().filter(|u| u.starts_with(sid)).cloned().collect() } // Record a downstream server and the SID that introduced it (its parent). pub fn server_link(&mut self, sid: &str, parent: &str) { self.servers.insert(sid.to_string(), parent.to_string()); } // Forget the server subtree behind (and including) `sid` — its own SID plus // every server introduced beneath it — and return the whole set so their users // can be forgotten too. A hub's SQUIT arrives once but takes its children with it. pub fn server_split(&mut self, sid: &str) -> Vec { let mut subtree = vec![sid.to_string()]; let mut i = 0; while i < subtree.len() { let parent = subtree[i].clone(); for (child, up) in &self.servers { if up == &parent && !subtree.contains(child) { subtree.push(child.clone()); } } i += 1; } for s in &subtree { self.servers.remove(s); self.server_names.remove(s); } subtree } // Drop the whole server tree (on a fresh link, before the burst rebuilds it). pub fn clear_servers(&mut self) { self.servers.clear(); self.server_names.clear(); } 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, msg: &str) { const TALKER_CAP: usize = 512; let a = self.chan_activity.entry(lc(channel)).or_default(); a.lines = a.lines.saturating_add(1); if a.talkers.len() < TALKER_CAP || a.talkers.contains_key(nick) { *a.talkers.entry(nick.to_string()).or_insert(0) += 1; } // Channel-scoped last message (bounded, truncated) for SEEN. let seen = self.chan_seen.entry(lc(channel)).or_default(); if seen.len() < TALKER_CAP || seen.contains_key(&lc(nick)) { seen.insert(lc(nick), ChanSeen { nick: nick.to_string(), ts: now(), msg: msg.chars().take(300).collect() }); } } pub fn channel_seen(&self, channel: &str, nick: &str) -> Option<&ChanSeen> { self.chan_seen.get(&lc(channel))?.get(&lc(nick)) } // 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 } // Seed the counters from persisted state at startup, so they survive restarts. pub fn seed_stats(&mut self, stats: BTreeMap) { self.stats = stats; } // BOTSTATS view: (total lines, top talkers by count, descending). pub fn channel_activity(&self, channel: &str) -> Option<(u64, Vec<(String, u64)>)> { let a = self.chan_activity.get(&lc(channel))?; let mut top: Vec<(String, u64)> = a.talkers.iter().map(|(n, v)| (n.clone(), *v)).collect(); top.sort_by(|x, y| y.1.cmp(&x.1).then_with(|| x.0.cmp(&y.0))); top.truncate(10); Some((a.lines, top)) } // Seed per-channel activity from persisted state at startup. pub fn seed_chan_activity(&mut self, data: crate::engine::db::ChanStats) { self.chan_activity = data .into_iter() .map(|(c, lines, talkers)| (c, ChanActivity { lines, talkers: talkers.into_iter().collect() })) .collect(); } // Snapshot per-channel activity for persistence: each active channel's line // count and its top talkers (capped, so a busy channel bounds the event). pub fn chan_activity_snapshot(&self) -> crate::engine::db::ChanStats { self.chan_activity .iter() .filter(|(_, a)| a.lines > 0) .map(|(c, a)| { let mut talkers: Vec<(String, u64)> = a.talkers.iter().map(|(n, v)| (n.clone(), *v)).collect(); talkers.sort_by(|x, y| y.1.cmp(&x.1).then_with(|| x.0.cmp(&y.0))); talkers.truncate(50); (c.clone(), a.lines, talkers) }) .collect() } // 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 oper_accounts(&self) -> Vec { self.config_opers.clone() } 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 ban_target(&self, uid: &str) -> Option> { Network::ban_target(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_seen(&self, channel: &str, nick: &str) -> Option { Network::channel_seen(self, channel, nick).map(|s| ChanSeenView { nick: s.nick.clone(), ts: s.ts, msg: s.msg.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)) } }