Struct RawEvent 

pub struct RawEvent {
    pub event: Option<String>,
    pub transaction_id: Option<String>,
    pub identifier: Option<String>,
    pub guid: Option<String>,
    pub data: Option<Value>,
    pub error: Option<String>,
    pub process: Option<String>,
    pub extra: HashMap<String, Value>,
}

A raw event received from the helper dylib over TCP.

Fields

event: Option<String>

Event type (e.g., “ping”, “started-typing”, “facetime-call-status-changed”)

transaction_id: Option<String>

Transaction ID (present if this is a response to an outgoing action)

identifier: Option<String>

Message/entity identifier returned in transaction responses

guid: Option<String>

Chat GUID (for typing events, etc.)

data: Option<Value>

Event data payload

error: Option<String>

Error message (for failed transactions)

process: Option<String>

Process bundle identifier (for ping events)

extra: HashMap<String, Value>

Extra fields not covered above (e.g. “url”, “silenced”, “available”). The dylib often puts response data as top-level keys rather than inside a “data” wrapper. This captures those fields so we can merge them into the transaction result.

Implementations

impl RawEvent

pub fn is_transaction_response(&self) -> bool

Check if this is a transaction response (has transactionId).

pub fn is_event(&self) -> bool

Check if this is an event (has event field).

pub fn extract_data(&self) -> Option<Value>

Extract the response data.

The dylib puts data in one of two shapes:

1. {"transactionId": "…", "data": { … }} — explicit data wrapper
2. {"transactionId": "…", "url": "…"} — top-level fields

If an explicit data field exists, use it. Otherwise collect all extra fields (those not consumed by named struct fields) into a JSON object.

Trait Implementations

impl Clone for RawEvent

fn clone(&self) -> RawEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RawEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RawEvent

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.