carbonfr-core 0.11.1

Domain, use cases and ports for carbon-fr's carbon-intensity core — pure, IO-free Rust (hexagonal architecture).
Documentation
//! Cas d'usage : ingérer la dernière mesure d'une région (cœur du poller
//! avant la 0.9.5, qui l'a remplacé par `IngestRecent`).

use crate::domain::{Methodology, Region, derive_acv_ademe};
use crate::ports::{Eco2mixSource, IntensityRepository};

use super::ApplicationError;

/// Récupère la dernière mesure depuis la source et la persiste via l'upsert
/// conditionnel au millésime (ADR-0003, ADR-0006).
///
/// Quand la mesure porte un mix de production, on **dérive et stocke aussi** la
/// mesure `acv-ademe` (cycle de vie, ADR-0008) au même horodatage.
///
/// ⚠️ Conservé pour compatibilité (SemVer, ADR-0030) mais **plus utilisé par le
/// poller** depuis l'addendum ADR-0003 du 2026-09-25 : ne lisant que le tout
/// dernier point, un retard de publication d'ODRÉ le faisait manquer
/// définitivement (jamais rattrapé). Le poller ingère désormais une fenêtre
/// glissante via [`IngestRecent`](super::IngestRecent), qui couvre aussi ce cas
/// (fenêtre à un seul point de large ≈ ce cas d'usage). Préférer `IngestRecent`
/// pour toute nouvelle intégration.
pub struct IngestLatest<S: Eco2mixSource, R: IntensityRepository> {
    source: S,
    repository: R,
}

impl<S: Eco2mixSource, R: IntensityRepository> IngestLatest<S, R> {
    pub fn new(source: S, repository: R) -> Self {
        Self { source, repository }
    }

    /// Retourne le nombre de mesures écrites (0 si la donnée déjà stockée
    /// était d'un millésime supérieur). Compte la mesure source et, le cas
    /// échéant, sa dérivée `acv-ademe`.
    pub async fn execute(&self, region: Region) -> Result<usize, ApplicationError> {
        let measurement = self.source.latest(region).await?;
        let mut batch = vec![measurement];
        // Dérive `acv-ademe` sauf si la mesure l'est déjà (cas régional, où la
        // source ne fournit que l'intensité dérivée).
        if batch[0].methodology != Methodology::acv_ademe()
            && let Some(acv) = derive_acv_ademe(&batch[0])
        {
            batch.push(acv);
        }
        let written = self.repository.upsert_many(&batch).await?;
        Ok(written)
    }
}