tawasuyu/arje

1//! Mediación de capabilities: emisión, renovación, revocación de tokens.
2//!
3//! Los grants tienen TTL (`DEFAULT_GRANT_TTL`). El cliente debe renovarlos
4//! periódicamente con `renew_grant(token)`; en caso contrario, el background
5//! task `purge_expired_grants` los revoca al vencimiento.
6
7use super::{quota_for_capability, ttl_for_capability, EnteGraph, GrantedCapability};
8use crate::events::CapabilityGrant;
9use ente_card::Capability;
10use std::time::Instant;
11use tokio::sync::oneshot;
12use tracing::debug;
13use ulid::Ulid;
14
15impl EnteGraph {
16    pub async fn mediate_capability(
17        &mut self,
18        from: Ulid,
19        cap: Capability,
20        reply: oneshot::Sender<CapabilityGrant>,
21    ) {
22        let grant = match self.providers.get(&cap).and_then(|s| s.iter().next().copied()) {
23            None => CapabilityGrant::NoProvider,
24            Some(provider) => {
25                // Quota: contar tokens vivos para (from, cap). Si excede,
26                // rechazar antes de emitir uno nuevo.
27                let limit = quota_for_capability(&cap);
28                let active = self.active_tokens_for(from, &cap);
29                if active >= limit {
30                    CapabilityGrant::QuotaExceeded { active, limit }
31                } else {
32                    let token = self.next_token;
33                    self.next_token += 1;
34                    let ttl = ttl_for_capability(&cap);
35                    let expires_at = Instant::now() + ttl;
36                    self.grants.insert(token, GrantedCapability {
37                        cap: cap.clone(),
38                        provider,
39                        holder: from,
40                        expires_at,
41                    });
42                    CapabilityGrant::Granted { token }
43                }
44            }
45        };
46        let _ = reply.send(grant);
47    }
48
49    /// Cuenta tokens vivos (no expirados) emitidos a un holder para una cap.
50    pub fn active_tokens_for(&self, holder: Ulid, cap: &Capability) -> u32 {
51        let now = Instant::now();
52        self.grants.values()
53            .filter(|g| g.holder == holder && &g.cap == cap && g.expires_at > now)
54            .count() as u32
55    }
56
57    /// Extiende un grant existente. Devuelve `true` si renovó. Si el token
58    /// no existe o ya expiró, `false` (el cliente debe re-acquire).
59    /// Usa el TTL específico de la cap del grant.
60    pub fn renew_grant(&mut self, token: u64) -> bool {
61        let now = Instant::now();
62        if let Some(g) = self.grants.get_mut(&token) {
63            if g.expires_at > now {
64                g.expires_at = now + ttl_for_capability(&g.cap);
65                return true;
66            }
67            // Expired — purgamos aquí mismo.
68            self.grants.remove(&token);
69        }
70        false
71    }
72
73    /// GC: elimina grants vencidos. Devuelve cuántos fueron purgados.
74    pub fn purge_expired_grants(&mut self) -> usize {
75        let now = Instant::now();
76        let expired: Vec<u64> = self.grants.iter()
77            .filter(|(_, g)| g.expires_at <= now)
78            .map(|(t, _)| *t)
79            .collect();
80        for t in &expired {
81            self.grants.remove(t);
82        }
83        if !expired.is_empty() {
84            debug!(count = expired.len(), "grants expirados purgados");
85        }
86        expired.len()
87    }
88
89    /// Cuenta de grants vivos (no expirados). Usado por métricas.
90    pub fn active_grants_count(&self) -> usize {
91        let now = Instant::now();
92        self.grants.values().filter(|g| g.expires_at > now).count()
93    }
94}
95