slipnote / backend / src / domain / entitlements.rs

use chrono::Utc;

/// Aggregated usage for a feature within a billing period.
#[derive(Debug, Clone)]
pub struct UsageSummary {
    pub limit_seconds: Option<f64>,
    pub used_seconds: f64,
    #[allow(dead_code)]
    pub period: UsagePeriod,
}

/// Decision for whether the user may consume more of a feature.
#[derive(Debug, Clone)]
pub enum UsageDecision {
    Allowed,
    Exceeded { limit_seconds: f64, used_seconds: f64 },
}

impl UsageSummary {
    /// Evaluates the usage against the limit, if any.
    pub fn decision(&self) -> UsageDecision {
        match self.limit_seconds {
            Some(limit) if self.used_seconds >= limit => UsageDecision::Exceeded {
                limit_seconds: limit,
                used_seconds: self.used_seconds,
            },
            _ => UsageDecision::Allowed,
        }
    }
}

/// Billing period boundaries for usage aggregation.
#[derive(Debug, Clone)]
pub struct UsagePeriod {
    pub start: chrono::DateTime<Utc>,
    pub end: chrono::DateTime<Utc>,
}

impl UsagePeriod {
    /// Returns the label used in API responses.
    pub fn label(&self) -> &'static str {
        "month"
    }
}