Skip to main content

kafka_client_engine/consumer/assigned_host/event/
error.rs

1//! Stable failures for immediate assigned-consumer event observation.
2
3use super::super::{result::AssignedConsumerPortError, shard::AssignedConsumerShardLockError};
4use crate::consumer::assigned_owner_model::AssignedConsumerOwnerError;
5
6/// Stable reason an immediate event observation could not complete.
7#[derive(Clone, Copy, Debug, Eq, PartialEq)]
8pub enum AssignedConsumerTryTakeEventErrorKind {
9    /// Another owner or caller currently holds the assigned-consumer shard.
10    Contended,
11    /// The synchronized engine host can no longer expose retained events.
12    HostUnavailable,
13    /// A non-semantic engine mechanism violated its ownership contract.
14    InternalInvariant,
15}
16
17/// Immediate observation failure before a retained event transferred.
18#[derive(Clone, Copy, Debug, Eq, PartialEq)]
19pub struct AssignedConsumerTryTakeEventError {
20    kind: AssignedConsumerTryTakeEventErrorKind,
21}
22
23impl AssignedConsumerTryTakeEventError {
24    pub(in crate::consumer::assigned_host) const fn from_port(
25        error: &AssignedConsumerPortError,
26    ) -> Self {
27        Self {
28            kind: match error {
29                AssignedConsumerPortError::Lock(AssignedConsumerShardLockError::Contended) => {
30                    AssignedConsumerTryTakeEventErrorKind::Contended
31                }
32                AssignedConsumerPortError::Lock(
33                    AssignedConsumerShardLockError::Poisoned
34                    | AssignedConsumerShardLockError::OwnerMissing,
35                )
36                | AssignedConsumerPortError::Owner {
37                    error: AssignedConsumerOwnerError::Faulted,
38                    ..
39                } => AssignedConsumerTryTakeEventErrorKind::HostUnavailable,
40                AssignedConsumerPortError::Clock(_)
41                | AssignedConsumerPortError::Closed
42                | AssignedConsumerPortError::Owner { .. } => {
43                    AssignedConsumerTryTakeEventErrorKind::InternalInvariant
44                }
45            },
46        }
47    }
48
49    /// Returns the stable observation-failure category.
50    pub const fn kind(&self) -> AssignedConsumerTryTakeEventErrorKind {
51        self.kind
52    }
53}
54
55impl std::fmt::Display for AssignedConsumerTryTakeEventError {
56    fn fmt(&self, formatter: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
57        write!(
58            formatter,
59            "assigned-consumer event observation failed: {:?}",
60            self.kind
61        )
62    }
63}
64
65impl std::error::Error for AssignedConsumerTryTakeEventError {}