Enum PushCondition

#[non_exhaustive]
pub enum PushCondition {
    EventMatch {
        key: String,
        pattern: String,
    },
    ContainsDisplayName,
    RoomMemberCount {
        is: RoomMemberCountIs,
    },
    SenderNotificationPermission {
        key: NotificationPowerLevelsKey,
    },
    RoomVersionSupports {
        feature: RoomVersionFeature,
    },
    EventPropertyIs {
        key: String,
        value: ScalarJsonValue,
    },
    EventPropertyContains {
        key: String,
        value: ScalarJsonValue,
    },
    ThreadSubscription {
        subscribed: bool,
    },
}

A condition that must apply for an associated push rule’s action to be taken.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

EventMatch

A glob pattern match on a field of the event.

Fields

key: String

The dot-separated path of the property of the event to match.

pattern: String

The glob-style pattern to match against.

Patterns with no special glob characters should be treated as having asterisks prepended and appended when testing the condition.

ContainsDisplayName

Matches unencrypted messages where content.body contains the owner’s display name in that room.

RoomMemberCount

Matches the current number of members in the room.

Fields

is: RoomMemberCountIs

The condition on the current number of members in the room.

SenderNotificationPermission

Takes into account the current power levels in the room, ensuring the sender of the event has high enough power to trigger the notification.

Fields

key: NotificationPowerLevelsKey

The field in the power level event the user needs a minimum power level for.

Fields must be specified under the notifications property in the power level event’s content.

RoomVersionSupports

Apply the rule only to rooms that support a given feature.

Fields

feature: RoomVersionFeature

The feature the room must support for the push rule to apply.

EventPropertyIs

Exact value match on a property of the event.

Fields

key: String

The dot-separated path of the property of the event to match.

value: ScalarJsonValue

The value to match against.

EventPropertyContains

Exact value match on a value in an array property of the event.

Fields

key: String

The dot-separated path of the property of the event to match.

value: ScalarJsonValue

The value to match against.

ThreadSubscription

Matches a thread event based on the user’s thread subscription status, as defined by MSC4306.

Fields

subscribed: bool

Whether the user must be subscribed (true) or unsubscribed (false) to the thread for the condition to match.

Implementations

impl PushCondition

pub async fn applies( &self, event: &FlattenedJson, context: &PushConditionRoomCtx, ) -> bool

Available on crate feature events only.

Check if this condition applies to the event.

Arguments

• event - The flattened JSON representation of a room message event.
• context - The context of the room at the time of the event. If the power levels context is missing from it, conditions that depend on it will never apply.

Trait Implementations

impl Clone for PushCondition

fn clone(&self) -> PushCondition

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PushCondition

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PushCondition

fn deserialize<D>( deserializer: D, ) -> Result<PushCondition, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<PushConditionSerDeHelper> for PushCondition

fn from(value: PushConditionSerDeHelper) -> PushCondition

Converts to this type from the input type.

impl Serialize for PushCondition

fn serialize<S>( &self, serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.