Struct EventFilter 

pub struct EventFilter {

    pub ids: Vec<Uuid>,
    pub target_id: Option<Uuid>,
    pub kinds: Vec<EventKind>,
    pub verbs: Vec<String>,
    pub substrates: Vec<SubstrateKind>,
    pub actors: Vec<String>,
    pub after: Option<i64>,
    pub before: Option<i64>,
    pub session_id: Option<Uuid>,
    pub observed: Vec<Uuid>,
    pub selected: Vec<Uuid>,
    pub payload_proposal_id: Option<Uuid>,
    pub outcome: Option<EventOutcome>,
    pub payload_equalities: Vec<(String, SqlValue)>,
}

Filter for querying events. Namespace is implicit in the scoped EventStore.

New fields deserialize to defaults for older serialized filters. Complete external Rust struct literals must specify them or use ..Default::default().

Fields

ids: Vec<Uuid>

target_id: Option<Uuid>

Exact event subject, independent of the graph observation projection.

kinds: Vec<EventKind>

verbs: Vec<String>

substrates: Vec<SubstrateKind>

actors: Vec<String>

after: Option<i64>

before: Option<i64>

session_id: Option<Uuid>

observed: Vec<Uuid>

selected: Vec<Uuid>

payload_proposal_id: Option<Uuid>

outcome: Option<EventOutcome>

Exact outcome; no restriction when absent.

payload_equalities: Vec<(String, SqlValue)>

ANDed SQL JSON equalities; see EventFilter::payload_eq.

Implementations

impl EventFilter

pub fn outcome(self, outcome: EventOutcome) -> Self

Match one outcome, replacing any previous outcome selection.

pub fn payload_eq(self, path: impl Into<String>, value: SqlValue) -> Self

Require SQL json_extract(payload, path) = value equality.

Paths must be $.field[.subfield] with nonempty ASCII alphanumeric or underscore segments; queries reject other paths. Calls are ANDed. SQL NULL matches neither a missing field nor explicit JSON null. JSON booleans compare as 0/1, including numeric coercion. JSON objects and arrays compare their serialized SQL text, not structural JSON equality.

Trait Implementations

impl Clone for EventFilter

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EventFilter

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

Formats the value using the given formatter.

impl Default for EventFilter

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for EventFilter

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for EventFilter

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.