ic-backup 0.52.0

//! Ordered passive update-response identity; reservation and decoding stay with callers.

use crate::model::{
    artifacts::ArtifactChecksumRecord, ic_update_response::IcUpdateResponseInput,
    operation_plan::PlanContextRecord,
};

pub(super) struct ResponseIdentity<'a> {
    pub authority: &'a ArtifactChecksumRecord,
    pub mutation_attempt: u32,
    pub context: &'a PlanContextRecord,
    pub target: &'a str,
}

impl<'a> From<&'a IcUpdateResponseInput> for ResponseIdentity<'a> {
    fn from(input: &'a IcUpdateResponseInput) -> Self {
        Self {
            authority: &input.authority,
            mutation_attempt: input.mutation_attempt,
            context: &input.context,
            target: &input.target,
        }
    }
}

impl ResponseIdentity<'_> {
    pub fn compare(&self, expected: &Self) -> Result<(), ResponseIdentityMismatch> {
        if self.authority != expected.authority {
            return Err(ResponseIdentityMismatch::Authority);
        }
        if self.mutation_attempt != expected.mutation_attempt {
            return Err(ResponseIdentityMismatch::Attempt);
        }
        if self.context != expected.context {
            return Err(ResponseIdentityMismatch::Context);
        }
        if self.target != expected.target {
            return Err(ResponseIdentityMismatch::Target);
        }
        Ok(())
    }
}

/// Passive response claims differ from the original reserved update identity.
#[derive(Debug, thiserror::Error, Eq, PartialEq)]
pub enum ResponseIdentityMismatch {
    /// Full original operation authority differs.
    #[error("response authority differs")]
    Authority,
    /// The already reserved mutation attempt differs.
    #[error("response attempt differs")]
    Attempt,
    /// Claimed network, caller or release differs.
    #[error("response context differs")]
    Context,
    /// Claimed canonical routing target differs.
    #[error("response target differs")]
    Target,
}